inochi2d-parser 0.2.2

## ✦ Inochi2D Parser

Typed parser and intermediate representation (IR) of the **Inochi2D** format for **INP / INX** files, written in **Rust**.

This crate transforms Inochi2D JSON files into **safe, typed Rust structures ready for consumption**.

---

## ✦ Features

Support for the main blocks of the format:

✦ Puppet  
✦ Nodes  
✦ Parameters  
✦ Animation  
✦ Groups  
✦ Vendor Extensions  

Each section becomes **clear domain types**, avoiding direct access to raw JSON.

---

## ✦ INR: engine-facing runtime format (feature `inr`)

INX/INP are authoring formats: nested JSON, UUID cross-references, encoded
PNG/TGA textures. **INR** is the engine-facing counterpart (in the spirit of
glTF/GLB): a small JSON index plus one binary blob with mesh buffers, binding
grids and raw RGBA8 textures laid out 4-aligned for zero-copy GPU upload.
Cross-references are array indices and the node tree is flattened pre-order.

| Feature | Adds | Deps |
| ------- | ---- | ---- |
| `inr` | Container reader (`InrModel`), typed document, INR → IR import (`open_puppet`, `to_puppet`) | `serde`, `serde_json`, `bytemuck` |
| `inr-export` | IR → INR export (`export_puppet`, `export_to_file`) | `image` (PNG/TGA decode) |

Textures are exported as **straight-alpha sRGB** with edge dilation, the
convention expected by Bevy, Unity, Unreal and Godot: hardware sRGB views
decode for free, in-shader premultiply gives correct linear blending, and
dilation avoids dark fringes from bilinear filtering — no per-engine texture
fixups needed.

Full specification: [docs/INR-SPEC.md](docs/INR-SPEC.md).

```sh
# Convert INX/INP to INR
cargo run --features inr-export --example inx2inr -- puppet.inx puppet.inr
```

---

## ✦ Unimplemented Features

Currently out of scope:

✦ Automation

_(These layers are intended for a separate runtime or playback system)_

---

## ✦ Usage Example

```toml
[dependencies]
inochi2d-parser = "0.2"
# optional: INR read / write
# inochi2d-parser = { version = "0.2", features = ["inr-export"] }
```

```rust
use inochi2d_parser::Puppet;

fn main() -> std::io::Result<()> {
    let puppet = Puppet::open("path/to/file.inp")?;

    // Root node
    let root_node = &puppet.nodes;

    // First child node
    let child_node = root_node.children.get(0).unwrap();

    // First global parameter
    let root_param = puppet.params.get(0).unwrap();

    Ok(())
}
```

Reading INR (feature `inr`):

```rust
use inochi2d_parser::inr;

let puppet = inr::open_puppet("puppet.inr")?;       // INR → IR
let model = inr::InrModel::open("puppet.inr")?;     // typed doc + raw buffers
```