feat(ltk_inibin): implement inibin crate with public api

.specify/memory/constitution.md

@@ -86,6 +86,24 @@
 - Dependency additions MUST be justified — avoid pulling in large
   dependency trees for trivial functionality.
 
+### VI. Code Style & Formatting
+
+- Separate distinct code contexts (imports, struct definitions, impl blocks,
+  helper functions, tests) with a single blank line.
+- Within a function, use blank lines to separate logical steps (setup,
+  processing, result). Do not insert blank lines between tightly coupled
+  sequential statements.
+- Group `use` statements by origin: std first, then external crates, then
+  internal crate modules, each group separated by a blank line.
+- Comments MUST only be added for code with complex or non-obvious behavior.
+  Do not document self-explanatory code, simple accessors, or trivial logic.
+- Section banners (e.g., `// ── Reading ──`) are allowed to visually separate
+  major logical regions within a file. Keep them consistent in style.
+- Prefer short, focused functions over long ones. If a function exceeds ~50
+  lines, consider whether it can be decomposed.
+- `rustfmt` is authoritative for all brace/indent/whitespace decisions —
+  do not fight the formatter.
+
 ## Error Handling & Safety
 
 - Each crate MUST define its own error type via `thiserror` and a
@@ -125,4 +143,4 @@
 - Runtime development guidance lives in `CLAUDE.md` at the repository
   root.
 
-**Version**: 2.0.0 | **Ratified**: 2026-03-07 | **Last Amended**: 2026-03-25
+**Version**: 2.1.0 | **Ratified**: 2026-03-07 | **Last Amended**: 2026-03-26

CLAUDE.md

@@ -82,3 +82,11 @@ Shared dependency versions are declared in the root `Cargo.toml` under `[workspa
 ## Additional Context
 
 The `docs/LTK_GUIDE.md` file contains detailed crate-by-crate API documentation with usage examples, file format references, and hash algorithm details. Consult it for format-specific questions.
+
+## Active Technologies
+- Rust (workspace edition, same as other `ltk_*` crates) + `thiserror` (errors), `byteorder` (binary I/O), `ltk_io_ext` (reader/writer extensions), `ltk_hash` (SDBM hashing), `glam` (Vec2/Vec3/Vec4 for vector set types), `bitflags` (InibinFlags) (001-inibin-crate)
+- N/A (in-memory data structures, binary file I/O) (001-inibin-crate)
+- Rust (workspace edition, same as other `ltk_*` crates) + `thiserror` (errors), `byteorder` (binary I/O), `ltk_io_ext` (reader/writer extensions), `ltk_hash` (SDBM hashing), `glam` (Vec2/Vec3/Vec4 for vector set types), `bitflags` (InibinFlags), `phf`/`phf_codegen` (compile-time hash map for ltk_inibin_names) (001-inibin-crate)
+
+## Recent Changes
+- 001-inibin-crate: Added Rust (workspace edition, same as other `ltk_*` crates) + `thiserror` (errors), `byteorder` (binary I/O), `ltk_io_ext` (reader/writer extensions), `ltk_hash` (SDBM hashing), `glam` (Vec2/Vec3/Vec4 for vector set types), `bitflags` (InibinFlags)

crates/league-toolkit/Cargo.toml

@@ -13,6 +13,7 @@ readme = "../../README.md"
 default = [
     "anim",
     "file",
+    "inibin",
     "mesh",
     "meta",
     "primitives",
@@ -25,6 +26,7 @@ serde = ["ltk_wad/serde", "ltk_file/serde", "ltk_meta/serde"]
 
 anim = ["dep:ltk_anim"]
 file = ["dep:ltk_file"]
+inibin = ["dep:ltk_inibin"]
 mesh = ["dep:ltk_mesh"]
 meta = ["dep:ltk_meta"]
 primitives = ["dep:ltk_primitives"]
@@ -35,6 +37,7 @@ hash = ["dep:ltk_hash"]
 [dependencies]
 ltk_anim = { version = "0.3.2", path = "../ltk_anim", optional = true }
 ltk_file = { version = "0.2.8", path = "../ltk_file", optional = true }
+ltk_inibin = { version = "0.1.0", path = "../ltk_inibin", optional = true }
 ltk_mesh = { version = "0.4.1", path = "../ltk_mesh", optional = true }
 ltk_meta = { version = "0.4.0", path = "../ltk_meta", optional = true }
 ltk_primitives = { version = "0.3.2", path = "../ltk_primitives", optional = true }

crates/league-toolkit/src/lib.rs

@@ -21,3 +21,6 @@ pub use ltk_wad as wad;
 
 #[cfg(feature = "hash")]
 pub use ltk_hash as hash;
+
+#[cfg(feature = "inibin")]
+pub use ltk_inibin as inibin;

crates/ltk_hash/src/lib.rs

@@ -1,3 +1,4 @@
 //! Other utilities (hashing, etc)
 pub mod elf;
 pub mod fnv1a;
+pub mod sdbm;

crates/ltk_hash/src/sdbm.rs

@@ -0,0 +1,73 @@
+/// Compute SDBM hash of a lowercased string.
+pub fn hash_lower(input: &str) -> u32 {
+    let mut hash: u32 = 0;
+    for c in input.chars().flat_map(|c| c.to_lowercase()) {
+        let mut buf = [0u8; 4];
+        let encoded = c.encode_utf8(&mut buf);
+        for &byte in encoded.as_bytes() {
+            hash = (byte as u32)
+                .wrapping_add(hash.wrapping_shl(6))
+                .wrapping_add(hash.wrapping_shl(16))
+                .wrapping_sub(hash);
+        }
+    }
+    hash
+}
+
+/// Compute SDBM hash of two strings joined by a delimiter, all lowercased.
+///
+/// Used for inibin keys: `hash_lower_with_delimiter(section, property, '*')`
+pub fn hash_lower_with_delimiter(a: &str, b: &str, delimiter: char) -> u32 {
+    let mut hash: u32 = 0;
+
+    let chars = a
+        .chars()
+        .chain(std::iter::once(delimiter))
+        .chain(b.chars())
+        .flat_map(|c| c.to_lowercase());
+
+    for c in chars {
+        let mut buf = [0u8; 4];
+        let encoded = c.encode_utf8(&mut buf);
+        for &byte in encoded.as_bytes() {
+            hash = (byte as u32)
+                .wrapping_add(hash.wrapping_shl(6))
+                .wrapping_add(hash.wrapping_shl(16))
+                .wrapping_sub(hash);
+        }
+    }
+    hash
+}
+
+#[cfg(test)]
+mod tests {
+    use super::*;
+
+    #[test]
+    fn test_hash_lower_basic() {
+        // SDBM hash of "test" (all lowercase)
+        let h = hash_lower("test");
+        // Verify case-insensitivity
+        assert_eq!(h, hash_lower("TEST"));
+        assert_eq!(h, hash_lower("TeSt"));
+    }
+
+    #[test]
+    fn test_hash_lower_empty() {
+        assert_eq!(hash_lower(""), 0);
+    }
+
+    #[test]
+    fn test_hash_lower_with_delimiter() {
+        let h1 = hash_lower_with_delimiter("DATA", "AttackRange", '*');
+        let h2 = hash_lower("data*attackrange");
+        assert_eq!(h1, h2);
+    }
+
+    #[test]
+    fn test_hash_lower_with_delimiter_case_insensitive() {
+        let h1 = hash_lower_with_delimiter("DATA", "AttackRange", '*');
+        let h2 = hash_lower_with_delimiter("data", "attackrange", '*');
+        assert_eq!(h1, h2);
+    }
+}

crates/ltk_inibin/Cargo.toml

@@ -0,0 +1,19 @@
+[package]
+name = "ltk_inibin"
+version = "0.1.0"
+edition = "2021"
+description = "Inibin/Troybin parser for League Toolkit"
+license = "MIT OR Apache-2.0"
+readme = "README.md"
+
+[dependencies]
+thiserror = { workspace = true }
+byteorder = { workspace = true }
+bitflags = { workspace = true }
+glam = { workspace = true }
+indexmap = { workspace = true }
+ltk_io_ext = { version = "0.4.1", path = "../ltk_io_ext" }
+ltk_hash = { version = "0.2.5", path = "../ltk_hash/" }
+
+[dev-dependencies]
+approx = { workspace = true }