@flighthq/tilemap 0.3.0-next.1021.f5f1ee0

package/dist/contract.d.ts

@@ -0,0 +1,2 @@
+export * from './tilemap';
+//# sourceMappingURL=contract.d.ts.map

package/dist/contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC"}

package/dist/contract.js

@@ -0,0 +1,2 @@
+export * from './tilemap';
+//# sourceMappingURL=contract.js.map

package/dist/contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.js","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export { clearTilemap, cloneTilemap, computeTilemapLocalBoundsRectangle, createTilemap, enableTilemapSignals, fillTilemapTiles, getTilemapColumnAtX, getTilemapColumnRowAtPoint, getTilemapRowAtY, getTilemapSignals, getTilemapTile, getTilemapTileAtPoint, getTilemapTileAtPointXY, getTilemapTileRect, resizeTilemap, setTilemapTile, setTilemapTileTint, setTilemapTiles, } from './contract';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,kCAAkC,EAClC,aAAa,EACb,oBAAoB,EACpB,gBAAgB,EAChB,mBAAmB,EACnB,0BAA0B,EAC1B,gBAAgB,EAChB,iBAAiB,EACjB,cAAc,EACd,qBAAqB,EACrB,uBAAuB,EACvB,kBAAkB,EAClB,aAAa,EACb,cAAc,EACd,kBAAkB,EAClB,eAAe,GAChB,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export { clearTilemap, cloneTilemap, computeTilemapLocalBoundsRectangle, createTilemap, enableTilemapSignals, fillTilemapTiles, getTilemapColumnAtX, getTilemapColumnRowAtPoint, getTilemapRowAtY, getTilemapSignals, getTilemapTile, getTilemapTileAtPoint, getTilemapTileAtPointXY, getTilemapTileRect, resizeTilemap, setTilemapTile, setTilemapTileTint, setTilemapTiles, } from './contract';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,kCAAkC,EAClC,aAAa,EACb,oBAAoB,EACpB,gBAAgB,EAChB,mBAAmB,EACnB,0BAA0B,EAC1B,gBAAgB,EAChB,iBAAiB,EACjB,cAAc,EACd,qBAAqB,EACrB,uBAAuB,EACvB,kBAAkB,EAClB,aAAa,EACb,cAAc,EACd,kBAAkB,EAClB,eAAe,GAChB,MAAM,YAAY,CAAC"}

package/dist/tilemap.d.ts

@@ -0,0 +1,68 @@
+import type { Node, PartialNode, Rectangle, Tilemap, TilemapData, TilemapRuntime, TilemapSignals, Vector2Like } from '@flighthq/types/contract';
+/** Fills all cells with -1 (empty). Equivalent to `fillTilemapTiles(tilemap, -1)`. Fires `onCleared` when signals are enabled. */
+export declare function clearTilemap(tilemap: Tilemap): void;
+/**
+ * Deep-copies `source` into a new `Tilemap` with an independent `Int16Array` tiles buffer and a
+ * fresh runtime. The new tilemap has the same atlas, cell layout, grid, and `materialData`
+ * (shallow copy of the materialData array), but its `tiles` are a cloned typed array.
+ */
+export declare function cloneTilemap(source: Readonly<Tilemap>): Tilemap;
+export declare function computeTilemapLocalBoundsRectangle(out: Rectangle, source: Readonly<Node>): void;
+export declare function createTilemap(obj?: Readonly<PartialNode<Tilemap>>): Tilemap;
+export declare function createTilemapData(data?: Readonly<Partial<TilemapData>>): TilemapData;
+export declare function createTilemapRuntime(): TilemapRuntime;
+export declare function createTilemapSignals(): TilemapSignals;
+/**
+ * Opt-in signals for a `Tilemap` node. Returns the {@link TilemapSignals} group attached to
+ * `target`, creating it on the first call. Zero cost until enabled — honors the `enable*` convention.
+ * Use `getTilemapSignals` to read without creating.
+ */
+export declare function enableTilemapSignals(target: Tilemap): TilemapSignals;
+export declare function fillTilemapTiles(tilemap: Tilemap, id: number): void;
+/**
+ * Returns the column index for a local-space x coordinate, or -1 when the atlas is null or
+ * `x` is outside the tilemap bounds. The result is a floored column index.
+ */
+export declare function getTilemapColumnAtX(source: Readonly<Tilemap>, x: number): number;
+/**
+ * Writes the column and row for a local-space point `(x, y)` into `out.x`/`out.y`.
+ * Returns false when the atlas is null or the point is outside the tilemap bounds.
+ * On a false return, `out` is not modified.
+ */
+export declare function getTilemapColumnRowAtPoint(out: Vector2Like, source: Readonly<Tilemap>, x: number, y: number): boolean;
+/**
+ * Returns the row index for a local-space y coordinate, or -1 when the atlas is null or
+ * `y` is outside the tilemap bounds. The result is a floored row index.
+ */
+export declare function getTilemapRowAtY(source: Readonly<Tilemap>, y: number): number;
+export declare function getTilemapRuntime(source: Readonly<Tilemap>): Readonly<TilemapRuntime>;
+/** Returns the {@link TilemapSignals} attached to `source`, or `null` if not yet enabled. */
+export declare function getTilemapSignals(source: Readonly<Tilemap>): TilemapSignals | null;
+export declare function getTilemapTile(tilemap: Readonly<Tilemap>, column: number, row: number): number;
+/**
+ * Returns the cell value at local-space point `(x, y)`, or -1 when the atlas is null, the
+ * point is outside the tilemap, or the cell is empty. Delegates to `getTilemapColumnAtX`,
+ * `getTilemapRowAtY`, and `getTilemapTile`.
+ */
+export declare function getTilemapTileAtPoint(source: Readonly<Tilemap>, point: Readonly<Vector2Like>): number;
+/**
+ * XY variant of `getTilemapTileAtPoint`. Returns the cell value or -1.
+ */
+export declare function getTilemapTileAtPointXY(source: Readonly<Tilemap>, x: number, y: number): number;
+/**
+ * Writes the local-space rectangle for the cell at `(column, row)` into `out`.
+ * Returns false and does not modify `out` when the atlas is null or the column/row is out of bounds.
+ */
+export declare function getTilemapTileRect(out: Rectangle, source: Readonly<Tilemap>, column: number, row: number): boolean;
+export declare function resizeTilemap(tilemap: Tilemap, columns: number, rows: number): void;
+/** Sets the tile at `(column, row)`. Fires `onTileChanged` when signals are enabled. */
+export declare function setTilemapTile(tilemap: Tilemap, column: number, row: number, id: number): void;
+/**
+ * Blits a sub-grid of tile ids from `ids` into `tilemap` starting at (`offsetColumn`, `offsetRow`),
+ * reading `width × height` tiles from `ids` in row-major order. Clips the write to the tilemap bounds —
+ * out-of-range cells in the target are silently skipped. The `ids` array is read in row-major order:
+ * row `r` starts at `r * width`. Fires `onTilesChanged` when signals are enabled.
+ */
+export declare function setTilemapTiles(tilemap: Tilemap, ids: ArrayLike<number>, offsetColumn: number, offsetRow: number, width: number, height: number): void;
+export declare function setTilemapTileTint(tilemap: Tilemap, column: number, row: number, rgba: number): void;
+//# sourceMappingURL=tilemap.d.ts.map

package/dist/tilemap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tilemap.d.ts","sourceRoot":"","sources":["../src/tilemap.ts"],"names":[],"mappings":"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"}

package/dist/tilemap.js

@@ -0,0 +1,222 @@
+import { createNode2D, createNode2DRuntime, getNode2DRuntime } from '@flighthq/scene2d/contract';
+import { createSignal } from '@flighthq/signals/contract';
+import { TilemapKind } from '@flighthq/types/contract';
+/** Fills all cells with -1 (empty). Equivalent to `fillTilemapTiles(tilemap, -1)`. Fires `onCleared` when signals are enabled. */
+export function clearTilemap(tilemap) {
+    tilemap.data.tiles.fill(-1);
+    const signals = getTilemapSignals(tilemap);
+    if (signals !== null)
+        signals.onCleared.emit();
+}
+/**
+ * Deep-copies `source` into a new `Tilemap` with an independent `Int16Array` tiles buffer and a
+ * fresh runtime. The new tilemap has the same atlas, cell layout, grid, and `materialData`
+ * (shallow copy of the materialData array), but its `tiles` are a cloned typed array.
+ */
+export function cloneTilemap(source) {
+    const src = source.data;
+    return createTilemap({
+        data: {
+            atlas: src.atlas,
+            columns: src.columns,
+            materialData: src.materialData !== null ? src.materialData.slice() : null,
+            rows: src.rows,
+            tileHeight: src.tileHeight,
+            tileWidth: src.tileWidth,
+            tiles: src.tiles.slice(),
+        },
+    });
+}
+export function computeTilemapLocalBoundsRectangle(out, source) {
+    const tilemap = source;
+    const { atlas, columns, rows, tileHeight, tileWidth } = tilemap.data;
+    out.x = 0;
+    out.y = 0;
+    out.width = atlas !== null ? columns * tileWidth : 0;
+    out.height = atlas !== null ? rows * tileHeight : 0;
+}
+export function createTilemap(obj) {
+    return createNode2D(TilemapKind, obj, createTilemapData, createTilemapRuntime);
+}
+export function createTilemapData(data) {
+    const columns = data?.columns ?? 0;
+    const rows = data?.rows ?? 0;
+    return {
+        atlas: data?.atlas ?? null,
+        columns,
+        materialData: data?.materialData ?? null,
+        rows,
+        tileHeight: data?.tileHeight ?? 0,
+        tileWidth: data?.tileWidth ?? 0,
+        tiles: data?.tiles ?? new Int16Array(columns * rows).fill(-1),
+    };
+}
+export function createTilemapRuntime() {
+    return createNode2DRuntime(defaultMethods);
+}
+export function createTilemapSignals() {
+    return {
+        onCleared: createSignal(),
+        onTileChanged: createSignal(),
+        onTilesChanged: createSignal(),
+    };
+}
+/**
+ * Opt-in signals for a `Tilemap` node. Returns the {@link TilemapSignals} group attached to
+ * `target`, creating it on the first call. Zero cost until enabled — honors the `enable*` convention.
+ * Use `getTilemapSignals` to read without creating.
+ */
+export function enableTilemapSignals(target) {
+    const s = target;
+    return (s[tilemapSignalsSlot] ??= createTilemapSignals());
+}
+export function fillTilemapTiles(tilemap, id) {
+    tilemap.data.tiles.fill(id);
+}
+/**
+ * Returns the column index for a local-space x coordinate, or -1 when the atlas is null or
+ * `x` is outside the tilemap bounds. The result is a floored column index.
+ */
+export function getTilemapColumnAtX(source, x) {
+    const { atlas, columns, tileWidth } = source.data;
+    if (atlas === null || tileWidth <= 0)
+        return -1;
+    const col = Math.floor(x / tileWidth);
+    if (col < 0 || col >= columns)
+        return -1;
+    return col;
+}
+/**
+ * Writes the column and row for a local-space point `(x, y)` into `out.x`/`out.y`.
+ * Returns false when the atlas is null or the point is outside the tilemap bounds.
+ * On a false return, `out` is not modified.
+ */
+export function getTilemapColumnRowAtPoint(out, source, x, y) {
+    const col = getTilemapColumnAtX(source, x);
+    const row = getTilemapRowAtY(source, y);
+    if (col < 0 || row < 0)
+        return false;
+    out.x = col;
+    out.y = row;
+    return true;
+}
+/**
+ * Returns the row index for a local-space y coordinate, or -1 when the atlas is null or
+ * `y` is outside the tilemap bounds. The result is a floored row index.
+ */
+export function getTilemapRowAtY(source, y) {
+    const { atlas, rows, tileHeight } = source.data;
+    if (atlas === null || tileHeight <= 0)
+        return -1;
+    const row = Math.floor(y / tileHeight);
+    if (row < 0 || row >= rows)
+        return -1;
+    return row;
+}
+export function getTilemapRuntime(source) {
+    return getNode2DRuntime(source);
+}
+/** Returns the {@link TilemapSignals} attached to `source`, or `null` if not yet enabled. */
+export function getTilemapSignals(source) {
+    return source[tilemapSignalsSlot] ?? null;
+}
+export function getTilemapTile(tilemap, column, row) {
+    const { columns, rows, tiles } = tilemap.data;
+    if (column < 0 || column >= columns || row < 0 || row >= rows)
+        return -1;
+    return tiles[row * columns + column];
+}
+/**
+ * Returns the cell value at local-space point `(x, y)`, or -1 when the atlas is null, the
+ * point is outside the tilemap, or the cell is empty. Delegates to `getTilemapColumnAtX`,
+ * `getTilemapRowAtY`, and `getTilemapTile`.
+ */
+export function getTilemapTileAtPoint(source, point) {
+    return getTilemapTileAtPointXY(source, point.x, point.y);
+}
+/**
+ * XY variant of `getTilemapTileAtPoint`. Returns the cell value or -1.
+ */
+export function getTilemapTileAtPointXY(source, x, y) {
+    const col = getTilemapColumnAtX(source, x);
+    const row = getTilemapRowAtY(source, y);
+    if (col < 0 || row < 0)
+        return -1;
+    return getTilemapTile(source, col, row);
+}
+/**
+ * Writes the local-space rectangle for the cell at `(column, row)` into `out`.
+ * Returns false and does not modify `out` when the atlas is null or the column/row is out of bounds.
+ */
+export function getTilemapTileRect(out, source, column, row) {
+    const { atlas, columns, rows, tileHeight, tileWidth } = source.data;
+    if (atlas === null || column < 0 || column >= columns || row < 0 || row >= rows)
+        return false;
+    out.x = column * tileWidth;
+    out.y = row * tileHeight;
+    out.width = tileWidth;
+    out.height = tileHeight;
+    return true;
+}
+export function resizeTilemap(tilemap, columns, rows) {
+    const data = tilemap.data;
+    const newTiles = new Int16Array(columns * rows).fill(-1);
+    const copyColumns = Math.min(columns, data.columns);
+    const copyRows = Math.min(rows, data.rows);
+    for (let r = 0; r < copyRows; r++) {
+        for (let c = 0; c < copyColumns; c++) {
+            newTiles[r * columns + c] = data.tiles[r * data.columns + c];
+        }
+    }
+    data.columns = columns;
+    data.rows = rows;
+    data.tiles = newTiles;
+}
+/** Sets the tile at `(column, row)`. Fires `onTileChanged` when signals are enabled. */
+export function setTilemapTile(tilemap, column, row, id) {
+    const { columns, rows, tiles } = tilemap.data;
+    if (column < 0 || column >= columns || row < 0 || row >= rows)
+        return;
+    tiles[row * columns + column] = id;
+    const signals = getTilemapSignals(tilemap);
+    if (signals !== null)
+        signals.onTileChanged.emit(column, row, id);
+}
+/**
+ * Blits a sub-grid of tile ids from `ids` into `tilemap` starting at (`offsetColumn`, `offsetRow`),
+ * reading `width × height` tiles from `ids` in row-major order. Clips the write to the tilemap bounds —
+ * out-of-range cells in the target are silently skipped. The `ids` array is read in row-major order:
+ * row `r` starts at `r * width`. Fires `onTilesChanged` when signals are enabled.
+ */
+export function setTilemapTiles(tilemap, ids, offsetColumn, offsetRow, width, height) {
+    const { columns, rows, tiles } = tilemap.data;
+    for (let r = 0; r < height; r++) {
+        const targetRow = offsetRow + r;
+        if (targetRow < 0 || targetRow >= rows)
+            continue;
+        for (let c = 0; c < width; c++) {
+            const targetCol = offsetColumn + c;
+            if (targetCol < 0 || targetCol >= columns)
+                continue;
+            tiles[targetRow * columns + targetCol] = ids[r * width + c];
+        }
+    }
+    const signals = getTilemapSignals(tilemap);
+    if (signals !== null)
+        signals.onTilesChanged.emit(offsetColumn, offsetRow, width, height);
+}
+// Sets one tile's compact multiply-only tint. The material-data array is allocated on first use, so
+// an untinted tilemap remains allocation-free. Invalid coordinates are ignored.
+export function setTilemapTileTint(tilemap, column, row, rgba) {
+    const data = tilemap.data;
+    if (column < 0 || column >= data.columns || row < 0 || row >= data.rows)
+        return;
+    if (data.materialData === null)
+        data.materialData = new Array(data.columns * data.rows).fill(null);
+    data.materialData[row * data.columns + column] = { tint: rgba >>> 0 };
+}
+const defaultMethods = {
+    computeLocalBoundsRectangle: computeTilemapLocalBoundsRectangle,
+};
+const tilemapSignalsSlot = Symbol('tilemapSignals');
+//# sourceMappingURL=tilemap.js.map

package/dist/tilemap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tilemap.js","sourceRoot":"","sources":["../src/tilemap.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AACjG,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAY1D,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAEvD,kIAAkI;AAClI,MAAM,UAAU,YAAY,CAAC,OAAgB;IAC3C,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5B,MAAM,OAAO,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAC;IAC3C,IAAI,OAAO,KAAK,IAAI;QAAE,OAAO,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;AACjD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,MAAyB;IACpD,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC;IACxB,OAAO,aAAa,CAAC;QACnB,IAAI,EAAE;YACJ,KAAK,EAAE,GAAG,CAAC,KAAK;YAChB,OAAO,EAAE,GAAG,CAAC,OAAO;YACpB,YAAY,EAAE,GAAG,CAAC,YAAY,KAAK,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,YAAY,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI;YACzE,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,UAAU,EAAE,GAAG,CAAC,UAAU;YAC1B,SAAS,EAAE,GAAG,CAAC,SAAS;YACxB,KAAK,EAAE,GAAG,CAAC,KAAK,CAAC,KAAK,EAAE;SACzB;KACF,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,kCAAkC,CAAC,GAAc,EAAE,MAAsB;IACvF,MAAM,OAAO,GAAG,MAAiB,CAAC;IAClC,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IACrE,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;IACV,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;IACV,GAAG,CAAC,KAAK,GAAG,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,OAAO,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;IACrD,GAAG,CAAC,MAAM,GAAG,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;AACtD,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,GAAoC;IAChE,OAAO,YAAY,CAAC,WAAW,EAAE,GAAG,EAAE,iBAAiB,EAAE,oBAAoB,CAAY,CAAC;AAC5F,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,IAAqC;IACrE,MAAM,OAAO,GAAG,IAAI,EAAE,OAAO,IAAI,CAAC,CAAC;IACnC,MAAM,IAAI,GAAG,IAAI,EAAE,IAAI,IAAI,CAAC,CAAC;IAC7B,OAAO;QACL,KAAK,EAAE,IAAI,EAAE,KAAK,IAAI,IAAI;QAC1B,OAAO;QACP,YAAY,EAAE,IAAI,EAAE,YAAY,IAAI,IAAI;QACxC,IAAI;QACJ,UAAU,EAAE,IAAI,EAAE,UAAU,IAAI,CAAC;QACjC,SAAS,EAAE,IAAI,EAAE,SAAS,IAAI,CAAC;QAC/B,KAAK,EAAE,IAAI,EAAE,KAAK,IAAI,IAAI,UAAU,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;KAC9D,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,oBAAoB;IAClC,OAAO,mBAAmB,CAAC,cAAc,CAAmB,CAAC;AAC/D,CAAC;AAED,MAAM,UAAU,oBAAoB;IAClC,OAAO;QACL,SAAS,EAAE,YAAY,EAAE;QACzB,aAAa,EAAE,YAAY,EAAE;QAC7B,cAAc,EAAE,YAAY,EAAE;KAC/B,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAAe;IAClD,MAAM,CAAC,GAAG,MAA4B,CAAC;IACvC,OAAO,CAAC,CAAC,CAAC,kBAAkB,CAAC,KAAK,oBAAoB,EAAE,CAAC,CAAC;AAC5D,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,OAAgB,EAAE,EAAU;IAC3D,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AAC9B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAyB,EAAE,CAAS;IACtE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC;IAClD,IAAI,KAAK,KAAK,IAAI,IAAI,SAAS,IAAI,CAAC;QAAE,OAAO,CAAC,CAAC,CAAC;IAChD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC;IACtC,IAAI,GAAG,GAAG,CAAC,IAAI,GAAG,IAAI,OAAO;QAAE,OAAO,CAAC,CAAC,CAAC;IACzC,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,0BAA0B,CAAC,GAAgB,EAAE,MAAyB,EAAE,CAAS,EAAE,CAAS;IAC1G,MAAM,GAAG,GAAG,mBAAmB,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAC3C,MAAM,GAAG,GAAG,gBAAgB,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IACxC,IAAI,GAAG,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IACrC,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC;IACZ,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC;IACZ,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAyB,EAAE,CAAS;IACnE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC;IAChD,IAAI,KAAK,KAAK,IAAI,IAAI,UAAU,IAAI,CAAC;QAAE,OAAO,CAAC,CAAC,CAAC;IACjD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC;IACvC,IAAI,GAAG,GAAG,CAAC,IAAI,GAAG,IAAI,IAAI;QAAE,OAAO,CAAC,CAAC,CAAC;IACtC,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,MAAyB;IACzD,OAAO,gBAAgB,CAAC,MAAM,CAAmB,CAAC;AACpD,CAAC;AAED,6FAA6F;AAC7F,MAAM,UAAU,iBAAiB,CAAC,MAAyB;IACzD,OAAQ,MAA6B,CAAC,kBAAkB,CAAC,IAAI,IAAI,CAAC;AACpE,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,OAA0B,EAAE,MAAc,EAAE,GAAW;IACpF,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAC9C,IAAI,MAAM,GAAG,CAAC,IAAI,MAAM,IAAI,OAAO,IAAI,GAAG,GAAG,CAAC,IAAI,GAAG,IAAI,IAAI;QAAE,OAAO,CAAC,CAAC,CAAC;IACzE,OAAO,KAAK,CAAC,GAAG,GAAG,OAAO,GAAG,MAAM,CAAC,CAAC;AACvC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CAAC,MAAyB,EAAE,KAA4B;IAC3F,OAAO,uBAAuB,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;AAC3D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,uBAAuB,CAAC,MAAyB,EAAE,CAAS,EAAE,CAAS;IACrF,MAAM,GAAG,GAAG,mBAAmB,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAC3C,MAAM,GAAG,GAAG,gBAAgB,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IACxC,IAAI,GAAG,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC;QAAE,OAAO,CAAC,CAAC,CAAC;IAClC,OAAO,cAAc,CAAC,MAAM,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;AAC1C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,GAAc,EAAE,MAAyB,EAAE,MAAc,EAAE,GAAW;IACvG,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC;IACpE,IAAI,KAAK,KAAK,IAAI,IAAI,MAAM,GAAG,CAAC,IAAI,MAAM,IAAI,OAAO,IAAI,GAAG,GAAG,CAAC,IAAI,GAAG,IAAI,IAAI;QAAE,OAAO,KAAK,CAAC;IAC9F,GAAG,CAAC,CAAC,GAAG,MAAM,GAAG,SAAS,CAAC;IAC3B,GAAG,CAAC,CAAC,GAAG,GAAG,GAAG,UAAU,CAAC;IACzB,GAAG,CAAC,KAAK,GAAG,SAAS,CAAC;IACtB,GAAG,CAAC,MAAM,GAAG,UAAU,CAAC;IACxB,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,OAAgB,EAAE,OAAe,EAAE,IAAY;IAC3E,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAC1B,MAAM,QAAQ,GAAG,IAAI,UAAU,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IACzD,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IACpD,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IAC3C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,EAAE,CAAC,EAAE,EAAE,CAAC;QAClC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,WAAW,EAAE,CAAC,EAAE,EAAE,CAAC;YACrC,QAAQ,CAAC,CAAC,GAAG,OAAO,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC;QAC/D,CAAC;IACH,CAAC;IACD,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACvB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACjB,IAAI,CAAC,KAAK,GAAG,QAAQ,CAAC;AACxB,CAAC;AAED,wFAAwF;AACxF,MAAM,UAAU,cAAc,CAAC,OAAgB,EAAE,MAAc,EAAE,GAAW,EAAE,EAAU;IACtF,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAC9C,IAAI,MAAM,GAAG,CAAC,IAAI,MAAM,IAAI,OAAO,IAAI,GAAG,GAAG,CAAC,IAAI,GAAG,IAAI,IAAI;QAAE,OAAO;IACtE,KAAK,CAAC,GAAG,GAAG,OAAO,GAAG,MAAM,CAAC,GAAG,EAAE,CAAC;IACnC,MAAM,OAAO,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAC;IAC3C,IAAI,OAAO,KAAK,IAAI;QAAE,OAAO,CAAC,aAAa,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC;AACpE,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAC7B,OAAgB,EAChB,GAAsB,EACtB,YAAoB,EACpB,SAAiB,EACjB,KAAa,EACb,MAAc;IAEd,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAC9C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAChC,MAAM,SAAS,GAAG,SAAS,GAAG,CAAC,CAAC;QAChC,IAAI,SAAS,GAAG,CAAC,IAAI,SAAS,IAAI,IAAI;YAAE,SAAS;QACjD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC;YAC/B,MAAM,SAAS,GAAG,YAAY,GAAG,CAAC,CAAC;YACnC,IAAI,SAAS,GAAG,CAAC,IAAI,SAAS,IAAI,OAAO;gBAAE,SAAS;YACpD,KAAK,CAAC,SAAS,GAAG,OAAO,GAAG,SAAS,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC;QAC9D,CAAC;IACH,CAAC;IACD,MAAM,OAAO,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAC;IAC3C,IAAI,OAAO,KAAK,IAAI;QAAE,OAAO,CAAC,cAAc,CAAC,IAAI,CAAC,YAAY,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;AAC5F,CAAC;AAED,oGAAoG;AACpG,gFAAgF;AAChF,MAAM,UAAU,kBAAkB,CAAC,OAAgB,EAAE,MAAc,EAAE,GAAW,EAAE,IAAY;IAC5F,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAC1B,IAAI,MAAM,GAAG,CAAC,IAAI,MAAM,IAAI,IAAI,CAAC,OAAO,IAAI,GAAG,GAAG,CAAC,IAAI,GAAG,IAAI,IAAI,CAAC,IAAI;QAAE,OAAO;IAChF,IAAI,IAAI,CAAC,YAAY,KAAK,IAAI;QAAE,IAAI,CAAC,YAAY,GAAG,IAAI,KAAK,CAAC,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACnG,IAAI,CAAC,YAAY,CAAC,GAAG,GAAG,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,KAAK,CAAC,EAAE,CAAC;AACxE,CAAC;AAED,MAAM,cAAc,GAAuC;IACzD,2BAA2B,EAAE,kCAAkC;CAChE,CAAC;AAEF,MAAM,kBAAkB,GAAG,MAAM,CAAC,gBAAgB,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@flighthq/tilemap",
+  "version": "0.3.0-next.1021.f5f1ee0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/flighthq/flight.git",
+    "directory": "packages/tilemap"
+  },
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./contract": {
+      "types": "./dist/contract.d.ts",
+      "default": "./dist/contract.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src/**/*.test.ts",
+    "!dist/**/*.test.js",
+    "!dist/**/*.test.d.ts",
+    "!dist/**/*.test.js.map",
+    "!dist/**/*.test.d.ts.map"
+  ],
+  "scripts": {
+    "build": "tsc -b",
+    "clean": "tsc -b --clean",
+    "test": "vitest run --config vitest.config.ts",
+    "test:watch": "vitest --watch --config vitest.config.ts",
+    "prepack": "npm run clean && npm run clean:dist && npm run build",
+    "clean:dist": "tsx ../../scripts/clean-package-dist.ts"
+  },
+  "dependencies": {
+    "@flighthq/geometry": "0.3.0-next.1021.f5f1ee0",
+    "@flighthq/node": "0.3.0-next.1021.f5f1ee0",
+    "@flighthq/quadbatch": "0.3.0-next.1021.f5f1ee0",
+    "@flighthq/scene2d": "0.3.0-next.1021.f5f1ee0",
+    "@flighthq/signals": "0.3.0-next.1021.f5f1ee0",
+    "@flighthq/types": "0.3.0-next.1021.f5f1ee0"
+  },
+  "devDependencies": {
+    "typescript": "^5.3.0"
+  },
+  "description": "Atlas-backed tilemap scene node and grid operations",
+  "sideEffects": false
+}

package/src/tilemap.test.ts

@@ -0,0 +1,497 @@
+import { createRectangle, createVector2 } from '@flighthq/geometry/contract';
+import { connectSignal } from '@flighthq/signals/contract';
+import type { Node, TextureAtlas } from '@flighthq/types/contract';
+import { TilemapKind } from '@flighthq/types/contract';
+
+import {
+  clearTilemap,
+  cloneTilemap,
+  computeTilemapLocalBoundsRectangle,
+  createTilemap,
+  createTilemapData,
+  createTilemapRuntime,
+  createTilemapSignals,
+  enableTilemapSignals,
+  fillTilemapTiles,
+  getTilemapColumnAtX,
+  getTilemapColumnRowAtPoint,
+  getTilemapRowAtY,
+  getTilemapRuntime,
+  getTilemapSignals,
+  getTilemapTile,
+  getTilemapTileAtPoint,
+  getTilemapTileAtPointXY,
+  getTilemapTileRect,
+  resizeTilemap,
+  setTilemapTile,
+  setTilemapTileTint,
+  setTilemapTiles,
+} from './tilemap';
+
+describe('clearTilemap', () => {
+  it('fills all cells with -1', () => {
+    const tilemap = createTilemap({ data: { columns: 3, rows: 2 } });
+    fillTilemapTiles(tilemap, 5);
+    clearTilemap(tilemap);
+    expect(Array.from(tilemap.data.tiles)).toEqual([-1, -1, -1, -1, -1, -1]);
+  });
+});
+
+describe('cloneTilemap', () => {
+  it('copies grid, atlas, and tiles into a new tilemap', () => {
+    const atlas = {} as TextureAtlas;
+    const source = createTilemap({ data: { atlas, columns: 3, rows: 2, tileHeight: 16, tileWidth: 32 } });
+    setTilemapTile(source, 1, 1, 9);
+    const clone = cloneTilemap(source);
+    expect(clone).not.toBe(source);
+    expect(clone.data.columns).toBe(3);
+    expect(clone.data.rows).toBe(2);
+    expect(clone.data.atlas).toBe(atlas);
+    expect(getTilemapTile(clone, 1, 1)).toBe(9);
+    expect(clone.kind).toBe(TilemapKind);
+  });
+
+  it('clones the tiles buffer so mutations do not leak back', () => {
+    const source = createTilemap({ data: { columns: 2, rows: 2 } });
+    const clone = cloneTilemap(source);
+    expect(clone.data.tiles).not.toBe(source.data.tiles);
+    setTilemapTile(clone, 0, 0, 5);
+    expect(getTilemapTile(source, 0, 0)).toBe(-1);
+  });
+});
+
+describe('computeTilemapLocalBoundsRectangle', () => {
+  it('sets out dimensions from atlas and grid size', () => {
+    const atlas = {} as TextureAtlas;
+    const tilemap = createTilemap({ data: { atlas, columns: 5, rows: 4, tileHeight: 16, tileWidth: 32 } });
+    const out = createRectangle();
+    computeTilemapLocalBoundsRectangle(out, tilemap as unknown as Node);
+    expect(out.width).toBe(160);
+    expect(out.height).toBe(64);
+  });
+
+  it('sets zero dimensions when atlas is null', () => {
+    const tilemap = createTilemap({ data: { columns: 5, rows: 4 } });
+    const out = createRectangle(0, 0, 99, 99);
+    computeTilemapLocalBoundsRectangle(out, tilemap as unknown as Node);
+    expect(out.width).toBe(0);
+    expect(out.height).toBe(0);
+  });
+});
+
+describe('createTilemap', () => {
+  it('initializes default values', () => {
+    const tilemap = createTilemap();
+    expect(tilemap.data.columns).toBe(0);
+    expect(tilemap.data.rows).toBe(0);
+    expect(tilemap.data.atlas).toBeNull();
+    expect(tilemap.data.tiles).toBeInstanceOf(Int16Array);
+    expect(tilemap.kind).toBe(TilemapKind);
+  });
+
+  it('initializes tiles to -1 (empty)', () => {
+    const tilemap = createTilemap({ data: { columns: 3, rows: 2 } });
+    expect(tilemap.data.tiles.length).toBe(6);
+    expect(Array.from(tilemap.data.tiles)).toEqual([-1, -1, -1, -1, -1, -1]);
+  });
+
+  it('allows pre-defined values', () => {
+    const base = { data: { columns: 10, rows: 5, atlas: {} as TextureAtlas, tileHeight: 16, tileWidth: 16 } };
+    const obj = createTilemap(base);
+    expect(obj.data.columns).toBe(10);
+    expect(obj.data.rows).toBe(5);
+    expect(obj.data.atlas).toBe(base.data.atlas);
+  });
+
+  it('returns a new object for better hidden-class performance', () => {
+    const base = {};
+    const obj = createTilemap(base);
+    expect(obj).not.toStrictEqual(base);
+  });
+});
+
+describe('createTilemapData', () => {
+  it('returns default values', () => {
+    const data = createTilemapData();
+    expect(data.columns).toBe(0);
+    expect(data.rows).toBe(0);
+    expect(data.atlas).toBeNull();
+    expect(data.tiles).toBeInstanceOf(Int16Array);
+  });
+
+  it('fills tiles with -1', () => {
+    const data = createTilemapData({ columns: 2, rows: 3 });
+    expect(Array.from(data.tiles)).toEqual([-1, -1, -1, -1, -1, -1]);
+  });
+});
+
+describe('createTilemapRuntime', () => {
+  it('returns a non-null runtime', () => {
+    const runtime = createTilemapRuntime();
+    expect(runtime).not.toBeNull();
+  });
+
+  it('uses computeTilemapLocalBoundsRectangle', () => {
+    const runtime = createTilemapRuntime();
+    expect(runtime.computeLocalBoundsRectangle).toStrictEqual(computeTilemapLocalBoundsRectangle);
+  });
+});
+
+describe('createTilemapSignals', () => {
+  it('creates a signals group with the three tilemap signals', () => {
+    const signals = createTilemapSignals();
+    let cleared = false;
+    let tileArgs: readonly number[] = [];
+    connectSignal(signals.onCleared, () => {
+      cleared = true;
+    });
+    connectSignal(signals.onTileChanged, (c, r, id) => {
+      tileArgs = [c, r, id];
+    });
+    signals.onCleared.emit();
+    signals.onTileChanged.emit(1, 2, 3);
+    expect(cleared).toBe(true);
+    expect(tileArgs).toEqual([1, 2, 3]);
+  });
+});
+
+describe('enableTilemapSignals', () => {
+  it('creates and attaches signals on first call', () => {
+    const tilemap = createTilemap();
+    expect(getTilemapSignals(tilemap)).toBeNull();
+    const signals = enableTilemapSignals(tilemap);
+    expect(signals).not.toBeNull();
+    expect(getTilemapSignals(tilemap)).toBe(signals);
+  });
+
+  it('returns the same group on repeated calls', () => {
+    const tilemap = createTilemap();
+    expect(enableTilemapSignals(tilemap)).toBe(enableTilemapSignals(tilemap));
+  });
+
+  it('makes setTilemapTile fire onTileChanged', () => {
+    const tilemap = createTilemap({ data: { columns: 3, rows: 3 } });
+    const signals = enableTilemapSignals(tilemap);
+    let received: readonly number[] = [];
+    connectSignal(signals.onTileChanged, (c, r, id) => {
+      received = [c, r, id];
+    });
+    setTilemapTile(tilemap, 1, 2, 4);
+    expect(received).toEqual([1, 2, 4]);
+  });
+
+  it('makes clearTilemap fire onCleared', () => {
+    const tilemap = createTilemap({ data: { columns: 2, rows: 2 } });
+    const signals = enableTilemapSignals(tilemap);
+    let cleared = false;
+    connectSignal(signals.onCleared, () => {
+      cleared = true;
+    });
+    clearTilemap(tilemap);
+    expect(cleared).toBe(true);
+  });
+});
+
+describe('fillTilemapTiles', () => {
+  it('fills all cells with the given id', () => {
+    const tilemap = createTilemap({ data: { columns: 2, rows: 2 } });
+    fillTilemapTiles(tilemap, 3);
+    expect(Array.from(tilemap.data.tiles)).toEqual([3, 3, 3, 3]);
+  });
+
+  it('clears all tiles with -1', () => {
+    const tilemap = createTilemap({ data: { columns: 2, rows: 2 } });
+    fillTilemapTiles(tilemap, 5);
+    fillTilemapTiles(tilemap, -1);
+    expect(Array.from(tilemap.data.tiles)).toEqual([-1, -1, -1, -1]);
+  });
+});
+
+describe('getTilemapColumnAtX', () => {
+  it('returns -1 when atlas is null', () => {
+    const tilemap = createTilemap({ data: { columns: 4, rows: 4 } });
+    expect(getTilemapColumnAtX(tilemap, 10)).toBe(-1);
+  });
+
+  it('returns the floored column for an in-bounds x', () => {
+    const atlas = {} as TextureAtlas;
+    const tilemap = createTilemap({ data: { atlas, columns: 4, rows: 4, tileHeight: 16, tileWidth: 16 } });
+    expect(getTilemapColumnAtX(tilemap, 0)).toBe(0);
+    expect(getTilemapColumnAtX(tilemap, 31)).toBe(1);
+    expect(getTilemapColumnAtX(tilemap, 48)).toBe(3);
+  });
+
+  it('returns -1 for x outside the grid', () => {
+    const atlas = {} as TextureAtlas;
+    const tilemap = createTilemap({ data: { atlas, columns: 4, rows: 4, tileHeight: 16, tileWidth: 16 } });
+    expect(getTilemapColumnAtX(tilemap, -1)).toBe(-1);
+    expect(getTilemapColumnAtX(tilemap, 64)).toBe(-1);
+  });
+});
+
+describe('getTilemapColumnRowAtPoint', () => {
+  it('writes column and row for an in-bounds point', () => {
+    const atlas = {} as TextureAtlas;
+    const tilemap = createTilemap({ data: { atlas, columns: 4, rows: 4, tileHeight: 16, tileWidth: 16 } });
+    const out = createVector2(99, 99);
+    expect(getTilemapColumnRowAtPoint(out, tilemap, 33, 17)).toBe(true);
+    expect(out.x).toBe(2);
+    expect(out.y).toBe(1);
+  });
+
+  it('returns false and does not modify out for an out-of-bounds point', () => {
+    const atlas = {} as TextureAtlas;
+    const tilemap = createTilemap({ data: { atlas, columns: 4, rows: 4, tileHeight: 16, tileWidth: 16 } });
+    const out = createVector2(7, 8);
+    expect(getTilemapColumnRowAtPoint(out, tilemap, -1, 0)).toBe(false);
+    expect(out.x).toBe(7);
+    expect(out.y).toBe(8);
+  });
+});
+
+describe('getTilemapRowAtY', () => {
+  it('returns -1 when atlas is null', () => {
+    const tilemap = createTilemap({ data: { columns: 4, rows: 4 } });
+    expect(getTilemapRowAtY(tilemap, 10)).toBe(-1);
+  });
+
+  it('returns the floored row for an in-bounds y', () => {
+    const atlas = {} as TextureAtlas;
+    const tilemap = createTilemap({ data: { atlas, columns: 4, rows: 4, tileHeight: 16, tileWidth: 16 } });
+    expect(getTilemapRowAtY(tilemap, 0)).toBe(0);
+    expect(getTilemapRowAtY(tilemap, 31)).toBe(1);
+  });
+
+  it('returns -1 for y outside the grid', () => {
+    const atlas = {} as TextureAtlas;
+    const tilemap = createTilemap({ data: { atlas, columns: 4, rows: 4, tileHeight: 16, tileWidth: 16 } });
+    expect(getTilemapRowAtY(tilemap, -1)).toBe(-1);
+    expect(getTilemapRowAtY(tilemap, 64)).toBe(-1);
+  });
+});
+
+describe('getTilemapRuntime', () => {
+  it('returns the runtime for a Tilemap', () => {
+    const tilemap = createTilemap();
+    const runtime = getTilemapRuntime(tilemap);
+    expect(runtime).not.toBeNull();
+  });
+});
+
+describe('getTilemapSignals', () => {
+  it('returns null before signals are enabled', () => {
+    const tilemap = createTilemap();
+    expect(getTilemapSignals(tilemap)).toBeNull();
+  });
+
+  it('returns the group after enabling', () => {
+    const tilemap = createTilemap();
+    const signals = enableTilemapSignals(tilemap);
+    expect(getTilemapSignals(tilemap)).toBe(signals);
+  });
+});
+
+describe('getTilemapTile', () => {
+  it('returns -1 for out-of-bounds coordinates', () => {
+    const tilemap = createTilemap({ data: { columns: 3, rows: 3 } });
+    expect(getTilemapTile(tilemap, -1, 0)).toBe(-1);
+    expect(getTilemapTile(tilemap, 3, 0)).toBe(-1);
+    expect(getTilemapTile(tilemap, 0, -1)).toBe(-1);
+    expect(getTilemapTile(tilemap, 0, 3)).toBe(-1);
+  });
+
+  it('returns -1 for empty cells', () => {
+    const tilemap = createTilemap({ data: { columns: 2, rows: 2 } });
+    expect(getTilemapTile(tilemap, 0, 0)).toBe(-1);
+  });
+
+  it('reads back what setTilemapTile wrote', () => {
+    const tilemap = createTilemap({ data: { columns: 4, rows: 4 } });
+    setTilemapTile(tilemap, 2, 1, 7);
+    expect(getTilemapTile(tilemap, 2, 1)).toBe(7);
+  });
+});
+
+describe('getTilemapTileAtPoint', () => {
+  it('returns the cell value at a local-space point', () => {
+    const atlas = {} as TextureAtlas;
+    const tilemap = createTilemap({ data: { atlas, columns: 4, rows: 4, tileHeight: 16, tileWidth: 16 } });
+    setTilemapTile(tilemap, 2, 1, 8);
+    expect(getTilemapTileAtPoint(tilemap, createVector2(33, 17))).toBe(8);
+  });
+
+  it('returns -1 for an out-of-bounds point', () => {
+    const atlas = {} as TextureAtlas;
+    const tilemap = createTilemap({ data: { atlas, columns: 4, rows: 4, tileHeight: 16, tileWidth: 16 } });
+    expect(getTilemapTileAtPoint(tilemap, createVector2(-5, 0))).toBe(-1);
+  });
+});
+
+describe('getTilemapTileAtPointXY', () => {
+  it('returns the cell value at (x, y)', () => {
+    const atlas = {} as TextureAtlas;
+    const tilemap = createTilemap({ data: { atlas, columns: 4, rows: 4, tileHeight: 16, tileWidth: 16 } });
+    setTilemapTile(tilemap, 0, 0, 3);
+    expect(getTilemapTileAtPointXY(tilemap, 5, 5)).toBe(3);
+  });
+
+  it('returns -1 when atlas is null', () => {
+    const tilemap = createTilemap({ data: { columns: 4, rows: 4 } });
+    expect(getTilemapTileAtPointXY(tilemap, 5, 5)).toBe(-1);
+  });
+});
+
+describe('getTilemapTileRect', () => {
+  it('writes the cell rectangle for an in-bounds cell', () => {
+    const atlas = {} as TextureAtlas;
+    const tilemap = createTilemap({ data: { atlas, columns: 4, rows: 4, tileHeight: 24, tileWidth: 16 } });
+    const out = createRectangle();
+    expect(getTilemapTileRect(out, tilemap, 2, 1)).toBe(true);
+    expect(out.x).toBe(32);
+    expect(out.y).toBe(24);
+    expect(out.width).toBe(16);
+    expect(out.height).toBe(24);
+  });
+
+  it('returns false and does not modify out for an out-of-bounds cell', () => {
+    const atlas = {} as TextureAtlas;
+    const tilemap = createTilemap({ data: { atlas, columns: 4, rows: 4, tileHeight: 16, tileWidth: 16 } });
+    const out = createRectangle(1, 2, 3, 4);
+    expect(getTilemapTileRect(out, tilemap, 5, 0)).toBe(false);
+    expect(out.x).toBe(1);
+    expect(out.y).toBe(2);
+    expect(out.width).toBe(3);
+    expect(out.height).toBe(4);
+  });
+
+  it('returns false when atlas is null', () => {
+    const tilemap = createTilemap({ data: { columns: 4, rows: 4 } });
+    const out = createRectangle();
+    expect(getTilemapTileRect(out, tilemap, 0, 0)).toBe(false);
+  });
+});
+
+describe('resizeTilemap', () => {
+  it('updates columns and rows', () => {
+    const tilemap = createTilemap({ data: { columns: 3, rows: 3 } });
+    resizeTilemap(tilemap, 5, 4);
+    expect(tilemap.data.columns).toBe(5);
+    expect(tilemap.data.rows).toBe(4);
+  });
+
+  it('copies surviving cells when shrinking', () => {
+    const tilemap = createTilemap({ data: { columns: 3, rows: 3 } });
+    setTilemapTile(tilemap, 0, 0, 1);
+    setTilemapTile(tilemap, 1, 1, 2);
+    resizeTilemap(tilemap, 2, 2);
+    expect(getTilemapTile(tilemap, 0, 0)).toBe(1);
+    expect(getTilemapTile(tilemap, 1, 1)).toBe(2);
+  });
+
+  it('fills new cells with -1 when growing', () => {
+    const tilemap = createTilemap({ data: { columns: 2, rows: 2 } });
+    setTilemapTile(tilemap, 0, 0, 5);
+    resizeTilemap(tilemap, 4, 4);
+    expect(getTilemapTile(tilemap, 0, 0)).toBe(5);
+    expect(getTilemapTile(tilemap, 3, 3)).toBe(-1);
+  });
+
+  it('correctly re-indexes tiles after resize', () => {
+    const tilemap = createTilemap({ data: { columns: 3, rows: 2 } });
+    // row 1, column 2 -> raw index = 1*3 + 2 = 5
+    setTilemapTile(tilemap, 2, 1, 9);
+    resizeTilemap(tilemap, 4, 3);
+    // after resize, row 1, column 2 -> raw index = 1*4 + 2 = 6
+    expect(getTilemapTile(tilemap, 2, 1)).toBe(9);
+  });
+});
+
+describe('setTilemapTile', () => {
+  it('stores tiles in row-major order', () => {
+    const tilemap = createTilemap({ data: { columns: 3, rows: 3 } });
+    setTilemapTile(tilemap, 1, 0, 42); // index = row(0) * cols(3) + column(1) = 1
+    expect(tilemap.data.tiles[1]).toBe(42);
+  });
+
+  it('silently ignores out-of-bounds writes', () => {
+    const tilemap = createTilemap({ data: { columns: 2, rows: 2 } });
+    setTilemapTile(tilemap, -1, 0, 5);
+    setTilemapTile(tilemap, 2, 0, 5);
+    setTilemapTile(tilemap, 0, -1, 5);
+    setTilemapTile(tilemap, 0, 2, 5);
+    expect(Array.from(tilemap.data.tiles)).toEqual([-1, -1, -1, -1]);
+  });
+
+  it('can set the empty sentinel -1', () => {
+    const tilemap = createTilemap({ data: { columns: 2, rows: 2 } });
+    setTilemapTile(tilemap, 0, 0, 3);
+    setTilemapTile(tilemap, 0, 0, -1);
+    expect(getTilemapTile(tilemap, 0, 0)).toBe(-1);
+  });
+});
+
+describe('setTilemapTiles', () => {
+  it('blits a sub-grid at offset (0, 0)', () => {
+    const tilemap = createTilemap({ data: { columns: 4, rows: 3 } });
+    const ids = new Int16Array([1, 2, 3, 4, 5, 6]);
+    setTilemapTiles(tilemap, ids, 0, 0, 3, 2);
+    expect(getTilemapTile(tilemap, 0, 0)).toBe(1);
+    expect(getTilemapTile(tilemap, 1, 0)).toBe(2);
+    expect(getTilemapTile(tilemap, 2, 0)).toBe(3);
+    expect(getTilemapTile(tilemap, 0, 1)).toBe(4);
+    expect(getTilemapTile(tilemap, 1, 1)).toBe(5);
+    expect(getTilemapTile(tilemap, 2, 1)).toBe(6);
+    // untouched cells remain -1
+    expect(getTilemapTile(tilemap, 3, 0)).toBe(-1);
+  });
+
+  it('blits at a non-zero offset', () => {
+    const tilemap = createTilemap({ data: { columns: 4, rows: 4 } });
+    const ids = [10, 11, 12, 13];
+    setTilemapTiles(tilemap, ids, 1, 2, 2, 2);
+    expect(getTilemapTile(tilemap, 1, 2)).toBe(10);
+    expect(getTilemapTile(tilemap, 2, 2)).toBe(11);
+    expect(getTilemapTile(tilemap, 1, 3)).toBe(12);
+    expect(getTilemapTile(tilemap, 2, 3)).toBe(13);
+    // untouched
+    expect(getTilemapTile(tilemap, 0, 0)).toBe(-1);
+  });
+
+  it('clips writes that extend outside the tilemap', () => {
+    const tilemap = createTilemap({ data: { columns: 2, rows: 2 } });
+    const ids = [1, 2, 3, 4, 5, 6, 7, 8, 9];
+    // 3x3 blit at offset (1, 1): only (1,1) is in-bounds
+    setTilemapTiles(tilemap, ids, 1, 1, 3, 3);
+    expect(getTilemapTile(tilemap, 1, 1)).toBe(1);
+    // All other cells remain -1
+    expect(getTilemapTile(tilemap, 0, 0)).toBe(-1);
+    expect(getTilemapTile(tilemap, 1, 0)).toBe(-1);
+  });
+
+  it('handles negative offsets by clipping', () => {
+    const tilemap = createTilemap({ data: { columns: 3, rows: 3 } });
+    const ids = [10, 20, 30, 40, 50, 60, 70, 80, 90];
+    // 3x3 blit at offset (-1, -1): only the bottom-right 2x2 of the source lands in bounds
+    setTilemapTiles(tilemap, ids, -1, -1, 3, 3);
+    // ids[1*3+1]=50 -> (0,0), ids[1*3+2]=60 -> (1,0), ids[2*3+1]=80 -> (0,1), ids[2*3+2]=90 -> (1,1)
+    expect(getTilemapTile(tilemap, 0, 0)).toBe(50);
+    expect(getTilemapTile(tilemap, 1, 0)).toBe(60);
+    expect(getTilemapTile(tilemap, 0, 1)).toBe(80);
+    expect(getTilemapTile(tilemap, 1, 1)).toBe(90);
+  });
+});
+
+describe('setTilemapTileTint', () => {
+  it('lazily allocates row-major per-tile data and stores packed RGBA', () => {
+    const tilemap = createTilemap({ data: { columns: 3, rows: 2 } });
+    expect(tilemap.data.materialData).toBeNull();
+    setTilemapTileTint(tilemap, 1, 1, 0x12345678);
+    expect(tilemap.data.materialData).toEqual([null, null, null, null, { tint: 0x12345678 }, null]);
+  });
+
+  it('ignores out-of-range coordinates without allocating', () => {
+    const tilemap = createTilemap({ data: { columns: 1, rows: 1 } });
+    setTilemapTileTint(tilemap, 1, 0, 0xffffffff);
+    expect(tilemap.data.materialData).toBeNull();
+  });
+});