mesh-data-tile 0.1.1

# mesh-data-tile-rs (reference)

Minimal Rust reference implementation for Mesh Tile Format v1 (`MTI1`).

Scope:
- Encode tile bytes from metadata + uncompressed payload bytes.
- Decode tile bytes into metadata + uncompressed payload bytes.
- Validate fixed header fields, CRC32 checksums, and payload length.
- Support `compression=none` and `compression=deflate-raw`.
- Provide typed payload helpers (`f64` values <-> payload bytes) for all dtypes.

Out of scope:
- GeoJSON/vector conversion.
- Map rendering integrations.

JIS root-tile recommendation:
- For `mesh_kind=JisX0410`, `tile_id=0` is a recommended convention for a root tile
  representing the full JIS mesh scope (`west=122`, `south=20`, `east=154`, `north=46`).
- This crate treats `tile_id` as metadata for JIS tiles and accepts `0` as a valid value.

## Run tests

From repository root:

```bash
cargo test -p mesh-data-tile-rs
```

From `references/rust`:

```bash
cargo test
```

## Release flow (crates.io with cargo-release)

Pre-requisites:
- A crates.io token with publish permission.
- `cargo-release` installed (`cargo install cargo-release --locked`).

One-time auth:

```bash
cargo login <CRATES_IO_TOKEN>
```

Preflight checks (from repository root):

```bash
cargo test -p mesh-data-tile-rs
cargo package -p mesh-data-tile-rs
```

Dry-run a release (from `references/rust`):

```bash
cargo release patch --dry-run
```

Publish a release (from `references/rust`):

```bash
cargo release patch --execute
```

Use `minor` or `major` instead of `patch` when needed:

```bash
cargo release minor --dry-run
cargo release major --dry-run
```

Current release config in `Cargo.toml`:
- Releases are allowed only from `main`.
- Tag format is `mesh-data-tile-rs-v<version>`.
- Release commit message format is `chore(release): mesh-data-tile-rs v<version>`.

## Example

```rust
use mesh_data_tile::{
    decode_payload_values, decode_tile_minimal, encode_payload_values, encode_tile,
    CompressionMode, DType, Endianness, MeshKind, TileDimensions, TileEncodeInput,
};

let dims = TileDimensions { rows: 2, cols: 2, bands: 1 };
let payload = encode_payload_values(DType::Uint16, Endianness::Little, &[10.0, 20.0, 30.0, 40.0])?;

let encoded = encode_tile(TileEncodeInput {
    tile_id: 42,
    mesh_kind: MeshKind::JisX0410,
    dtype: DType::Uint16,
    endianness: Endianness::Little,
    compression: CompressionMode::None,
    dimensions: dims,
    no_data: None,
    payload: &payload,
})?;

let decoded = decode_tile_minimal(&encoded.bytes)?;
let values = decode_payload_values(
    decoded.header.dtype,
    decoded.header.endianness,
    &decoded.payload,
    decoded.header.no_data,
)?;
assert_eq!(
    values,
    vec![Some(10.0), Some(20.0), Some(30.0), Some(40.0)]
);
# Ok::<(), mesh_data_tile::TileError>(())
```