@codexo/exojs-tilemap 0.13.0 → 0.15.0

package/dist/esm/autoTile.d.ts

@@ -0,0 +1,83 @@
+import type { TileLayer } from './TileLayer';
+import type { WangSet } from './WangSet';
+/**
+ * Options for {@link autoTile} and {@link refreshCell}.
+ */
+export interface AutoTileOptions {
+    /**
+     * When provided, only cells for which `matchFn` returns `true` are treated
+     * as part of the Wang group. The function receives the cell's `localTileId`,
+     * `tilesetIndex`, and tile coordinates `(x, y)`.
+     *
+     * If omitted, group membership defaults to {@link WangSet.isMember} on the
+     * cell's `localTileId` (and a matching `tilesetIndex`). That default is
+     * *variant-stable* — every autotiled variant counts as a member — which is
+     * what makes {@link refreshCell} correct. If you supply a `matchFn` for use
+     * with `refreshCell`, it MUST likewise be variant-stable (independent of the
+     * currently-rendered variant), e.g. keyed on a separate logical-terrain grid
+     * or a tile property.
+     */
+    matchFn?: (localTileId: number, tilesetIndex: number, x: number, y: number) => boolean;
+    /**
+     * When `true` (default), out-of-bounds neighbors are treated as though
+     * they belong to the Wang group, so border tiles fill correctly to the
+     * layer edge. Set to `false` to leave border tiles visually open.
+     */
+    wrapBorder?: boolean;
+}
+/**
+ * Apply Wang autotiling to `layer` using `wangSet`.
+ *
+ * Iterates every cell in the layer. For each cell that belongs to the Wang
+ * group, computes a neighbor bitmask and looks up the correct local tile ID
+ * from {@link WangSet.blobMap}. The layer is mutated in place; cells whose
+ * computed bitmask has no mapping in the blobMap are left unchanged.
+ *
+ * The function performs two passes (snapshot then write) so neighbor tests
+ * always reflect the pre-call state regardless of processing order.
+ *
+ * **Group membership.** With no `matchFn`, a cell belongs to the group when its
+ * `tilesetIndex` matches {@link WangSet.tilesetIndex} and its `localTileId` is a
+ * {@link WangSet.isMember member} of the set. Membership covers every variant
+ * the set can produce, so re-running `autoTile` (or {@link refreshCell}) on
+ * already-autotiled data is stable. Paint with a tile ID that is a member (a
+ * blobMap value, or one listed in {@link WangSetOptions.members}).
+ *
+ * **Blob mode bitmask (bit positions):**
+ * ```
+ * 1  | 2  | 4
+ * 8  | -- | 16
+ * 32 | 64 | 128
+ * ```
+ * Diagonal bits (1, 4, 32, 128) are only set when both adjacent cardinals
+ * are also set (the "corner dependency" rule that reduces 256 raw
+ * combinations to 47 valid blob states).
+ *
+ * **Edge mode bitmask (bit positions):** Top=1, Right=2, Bottom=4, Left=8.
+ */
+export declare function autoTile(layer: TileLayer, wangSet: WangSet, options?: AutoTileOptions): void;
+/**
+ * Incrementally re-autotile a single cell and its eight neighbours after an
+ * edit, instead of re-running {@link autoTile} over the whole layer.
+ *
+ * A cell's blob/edge mask depends only on its immediate neighbours, so painting
+ * or erasing cell `(x, y)` can change the variant of that cell and of the (up
+ * to) eight cells that have it as a neighbour — but nothing further out. This
+ * recomputes exactly that 3×3 neighbourhood, touching only the 1–4 chunks it
+ * spans (and rebuilding geometry only for chunks whose tiles actually change).
+ * For a paint operation this is O(1) work versus `autoTile`'s O(width·height).
+ *
+ * Membership is read live from the layer, so the membership test MUST be
+ * variant-stable: the default ({@link WangSet.isMember}) is, and any custom
+ * `matchFn` you pass must be too (see {@link AutoTileOptions.matchFn}).
+ *
+ * Typical editor use: write the painted tile with `layer.setTileAt(...)` using
+ * a member tile ID, then call `refreshCell(layer, x, y, wangSet)`.
+ *
+ * @param layer   The layer to update in place.
+ * @param x       Tile X of the edited cell.
+ * @param y       Tile Y of the edited cell.
+ * @param wangSet The Wang set to resolve variants from.
+ * @param options Membership / border options (shared with {@link autoTile}).
+ */
+export declare function refreshCell(layer: TileLayer, x: number, y: number, wangSet: WangSet, options?: AutoTileOptions): void;

package/dist/esm/autoTile.js

@@ -0,0 +1,214 @@
+import { unpackTile, TILE_TRANSFORM_IDENTITY } from './types.js';
+
+// ── Module-level mask helpers ─────────────────────────────────────────────
+/**
+ * Compute a 4-bit edge bitmask for the cell at `(tx, ty)`.
+ * Top=1, Right=2, Bottom=4, Left=8.
+ */
+function computeEdgeMask(tx, ty, inGroup) {
+    let mask = 0;
+    if (inGroup(tx, ty - 1))
+        mask |= 1;
+    if (inGroup(tx + 1, ty))
+        mask |= 2;
+    if (inGroup(tx, ty + 1))
+        mask |= 4;
+    if (inGroup(tx - 1, ty))
+        mask |= 8;
+    return mask;
+}
+/**
+ * Compute an 8-bit blob bitmask for the cell at `(tx, ty)` using the
+ * corner-dependency rule: diagonal bits are only set when both adjacent
+ * cardinal directions are also set.
+ *
+ * Bit layout:
+ * ```
+ * 1  | 2  | 4
+ * 8  | -- | 16
+ * 32 | 64 | 128
+ * ```
+ */
+function computeBlobMask(tx, ty, inGroup) {
+    const top = inGroup(tx, ty - 1);
+    const right = inGroup(tx + 1, ty);
+    const bottom = inGroup(tx, ty + 1);
+    const left = inGroup(tx - 1, ty);
+    let mask = 0;
+    if (top)
+        mask |= 2;
+    if (right)
+        mask |= 16;
+    if (bottom)
+        mask |= 64;
+    if (left)
+        mask |= 8;
+    // Corner bits: only when BOTH adjacent cardinals are set.
+    if (top && left && inGroup(tx - 1, ty - 1))
+        mask |= 1;
+    if (top && right && inGroup(tx + 1, ty - 1))
+        mask |= 4;
+    if (bottom && left && inGroup(tx - 1, ty + 1))
+        mask |= 32;
+    if (bottom && right && inGroup(tx + 1, ty + 1))
+        mask |= 128;
+    return mask;
+}
+/** Compute the mask for a cell given the Wang mode and a membership predicate. */
+function computeMask(wangSet, tx, ty, inGroup) {
+    return wangSet.type === 'edge'
+        ? computeEdgeMask(tx, ty, inGroup)
+        : computeBlobMask(tx, ty, inGroup);
+}
+/**
+ * Apply the variant computed for cell `(tx, ty)` to `layer`, preserving the
+ * cell's current orientation transform. No-op if the mask has no mapping or
+ * the target tileset is missing.
+ */
+function applyVariant(layer, wangSet, tx, ty, inGroup) {
+    const newLocalTileId = wangSet.getTileId(computeMask(wangSet, tx, ty, inGroup));
+    if (newLocalTileId === undefined)
+        return;
+    const tileset = layer.tilesets[wangSet.tilesetIndex];
+    if (!tileset)
+        return;
+    // Preserve the existing orientation transform if the cell already holds one.
+    const existing = layer.getTileAt(tx, ty);
+    layer.setTileAt(tx, ty, {
+        localTileId: newLocalTileId,
+        tileset,
+        transform: existing ? existing.transform : TILE_TRANSFORM_IDENTITY,
+    });
+}
+// ── Public API ────────────────────────────────────────────────────────────
+/**
+ * Apply Wang autotiling to `layer` using `wangSet`.
+ *
+ * Iterates every cell in the layer. For each cell that belongs to the Wang
+ * group, computes a neighbor bitmask and looks up the correct local tile ID
+ * from {@link WangSet.blobMap}. The layer is mutated in place; cells whose
+ * computed bitmask has no mapping in the blobMap are left unchanged.
+ *
+ * The function performs two passes (snapshot then write) so neighbor tests
+ * always reflect the pre-call state regardless of processing order.
+ *
+ * **Group membership.** With no `matchFn`, a cell belongs to the group when its
+ * `tilesetIndex` matches {@link WangSet.tilesetIndex} and its `localTileId` is a
+ * {@link WangSet.isMember member} of the set. Membership covers every variant
+ * the set can produce, so re-running `autoTile` (or {@link refreshCell}) on
+ * already-autotiled data is stable. Paint with a tile ID that is a member (a
+ * blobMap value, or one listed in {@link WangSetOptions.members}).
+ *
+ * **Blob mode bitmask (bit positions):**
+ * ```
+ * 1  | 2  | 4
+ * 8  | -- | 16
+ * 32 | 64 | 128
+ * ```
+ * Diagonal bits (1, 4, 32, 128) are only set when both adjacent cardinals
+ * are also set (the "corner dependency" rule that reduces 256 raw
+ * combinations to 47 valid blob states).
+ *
+ * **Edge mode bitmask (bit positions):** Top=1, Right=2, Bottom=4, Left=8.
+ */
+function autoTile(layer, wangSet, options) {
+    const matchFn = options?.matchFn;
+    const wrapBorder = options?.wrapBorder ?? true;
+    const w = layer.width;
+    const h = layer.height;
+    const snapshot = new Map();
+    for (let ty = 0; ty < h; ty++) {
+        for (let tx = 0; tx < w; tx++) {
+            const packed = layer.getRawTileAt(tx, ty);
+            if (packed === 0)
+                continue;
+            const decoded = unpackTile(packed);
+            if (!decoded)
+                continue;
+            snapshot.set(ty * w + tx, decoded);
+        }
+    }
+    // ── Membership test (reads the snapshot) ─────────────────────────────
+    const isInGroup = (nx, ny) => {
+        if (nx < 0 || nx >= w || ny < 0 || ny >= h)
+            return wrapBorder;
+        const cell = snapshot.get(ny * w + nx);
+        if (!cell)
+            return false;
+        if (matchFn)
+            return matchFn(cell.localTileId, cell.tilesetIndex, nx, ny);
+        return cell.tilesetIndex === wangSet.tilesetIndex && wangSet.isMember(cell.localTileId);
+    };
+    // ── Pass 2: compute masks and write ──────────────────────────────────
+    for (let ty = 0; ty < h; ty++) {
+        for (let tx = 0; tx < w; tx++) {
+            const cellInfo = snapshot.get(ty * w + tx);
+            if (!cellInfo)
+                continue;
+            // Skip cells that are not part of the group.
+            const isMember = matchFn
+                ? matchFn(cellInfo.localTileId, cellInfo.tilesetIndex, tx, ty)
+                : cellInfo.tilesetIndex === wangSet.tilesetIndex && wangSet.isMember(cellInfo.localTileId);
+            if (!isMember)
+                continue;
+            applyVariant(layer, wangSet, tx, ty, isInGroup);
+        }
+    }
+}
+/**
+ * Incrementally re-autotile a single cell and its eight neighbours after an
+ * edit, instead of re-running {@link autoTile} over the whole layer.
+ *
+ * A cell's blob/edge mask depends only on its immediate neighbours, so painting
+ * or erasing cell `(x, y)` can change the variant of that cell and of the (up
+ * to) eight cells that have it as a neighbour — but nothing further out. This
+ * recomputes exactly that 3×3 neighbourhood, touching only the 1–4 chunks it
+ * spans (and rebuilding geometry only for chunks whose tiles actually change).
+ * For a paint operation this is O(1) work versus `autoTile`'s O(width·height).
+ *
+ * Membership is read live from the layer, so the membership test MUST be
+ * variant-stable: the default ({@link WangSet.isMember}) is, and any custom
+ * `matchFn` you pass must be too (see {@link AutoTileOptions.matchFn}).
+ *
+ * Typical editor use: write the painted tile with `layer.setTileAt(...)` using
+ * a member tile ID, then call `refreshCell(layer, x, y, wangSet)`.
+ *
+ * @param layer   The layer to update in place.
+ * @param x       Tile X of the edited cell.
+ * @param y       Tile Y of the edited cell.
+ * @param wangSet The Wang set to resolve variants from.
+ * @param options Membership / border options (shared with {@link autoTile}).
+ */
+function refreshCell(layer, x, y, wangSet, options) {
+    const matchFn = options?.matchFn;
+    const wrapBorder = options?.wrapBorder ?? true;
+    const w = layer.width;
+    const h = layer.height;
+    // Live membership test (reads the current layer; variant-stable by default).
+    const isInGroup = (nx, ny) => {
+        if (nx < 0 || nx >= w || ny < 0 || ny >= h)
+            return wrapBorder;
+        const tile = layer.getTileAt(nx, ny);
+        if (!tile)
+            return false;
+        const tsi = layer.tilesets.indexOf(tile.tileset);
+        if (matchFn)
+            return matchFn(tile.localTileId, tsi, nx, ny);
+        return tsi === wangSet.tilesetIndex && wangSet.isMember(tile.localTileId);
+    };
+    // Recompute the edited cell and its eight neighbours.
+    for (let dy = -1; dy <= 1; dy++) {
+        for (let dx = -1; dx <= 1; dx++) {
+            const tx = x + dx;
+            const ty = y + dy;
+            if (!layer.inBounds(tx, ty))
+                continue;
+            if (!isInGroup(tx, ty))
+                continue;
+            applyVariant(layer, wangSet, tx, ty, isInGroup);
+        }
+    }
+}
+
+export { autoTile, refreshCell };
+//# sourceMappingURL=autoTile.js.map

package/dist/esm/autoTile.js.map

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

package/dist/esm/chunkGeometry.js

@@ -70,9 +70,10 @@ function buildChunkPages(chunk, tilesets, tileWidth, tileHeight) {
             const u1 = (sx + rect.width) / textureWidth;
             const v1 = (sy + rect.height) / textureHeight;
             // Bottom-left aligned destination (Tiled orthogonal). Uniform tiles
-            // (rect.height === tileHeight) collapse to a plain cell rect.
-            const x0 = lx * tileWidth;
-            const y0 = ly * tileHeight + tileHeight - rect.height;
+            // (rect.height === tileHeight) collapse to a plain cell rect. The
+            // tileset's visual draw offset (Tiled `tileoffset`) shifts every tile.
+            const x0 = lx * tileWidth + tileset.offsetX;
+            const y0 = ly * tileHeight + tileHeight - rect.height + tileset.offsetY;
             const x1 = x0 + rect.width;
             const y1 = y0 + rect.height;
             let bucket = buckets.get(tileset);

package/dist/esm/chunkGeometry.js.map

@@ -1 +1 @@
-{"version":3,"file":"chunkGeometry.js","sources":["../../../src/chunkGeometry.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}
+{"version":3,"file":"chunkGeometry.js","sources":["../../../src/chunkGeometry.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/dist/esm/index.js

@@ -1,4 +1,6 @@
 export { tilemapExtension } from './tilemapExtension.js';
+export { ImageLayer } from './ImageLayer.js';
+export { ObjectKind, ObjectLayer } from './ObjectLayer.js';
 export { TileLayer } from './TileLayer.js';
 export { TileMap } from './TileMap.js';
 export { TileSet } from './TileSet.js';
@@ -6,5 +8,8 @@ export { TileLayerNode } from './TileLayerNode.js';
 export { TileMapNode } from './TileMapNode.js';
 export { TileMapBand } from './TileMapBand.js';
 export { TileMapView } from './TileMapView.js';
-export { TILE_TRANSFORM_IDENTITY, tileToChunkCoord, tileToLocalInChunk } from './types.js';
+export { TILE_TRANSFORM_IDENTITY, TilePropertyKind, tileToChunkCoord, tileToLocalInChunk } from './types.js';
+export { TileAnimator } from './TileAnimator.js';
+export { autoTile, refreshCell } from './autoTile.js';
+export { WangSet } from './WangSet.js';
 //# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;"}
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;"}

package/dist/esm/pixelSnap.d.ts

@@ -1,4 +1,4 @@
-import type { PixelSnapMode } from '@codexo/exojs/rendering';
+import type { PixelSnapMode } from '@codexo/exojs/renderer-sdk';
 /**
  * Throw a deterministic error when `mode` is not a valid {@link PixelSnapMode}.
  *

package/dist/esm/public.d.ts

@@ -1,5 +1,9 @@
 export { tilemapExtension } from './tilemapExtension';
 export type { Extension } from '@codexo/exojs/extensions';
+export type { ImageLayerOptions } from './ImageLayer';
+export { ImageLayer } from './ImageLayer';
+export type { EllipseObject, ObjectLayerOptions, ObjectPoint, ObjectQuery, ObjectSchema, PointObject, PolygonObject, PolylineObject, RectangleObject, TextObject, TextStyle, TileMapObject, TileMapObjectKind, TileObject, TypedObject, } from './ObjectLayer';
+export { ObjectKind, ObjectLayer } from './ObjectLayer';
 export type { ReadonlyTileChunk } from './TileChunk';
 export type { TileLayerOptions } from './TileLayer';
 export { TileLayer } from './TileLayer';
@@ -14,5 +18,10 @@ export { TileMapNode } from './TileMapNode';
 export { TileMapBand } from './TileMapBand';
 export type { TileLayerSelector, TileMapBandDefinition, TileMapViewOptions, } from './TileMapView';
 export { TileMapView } from './TileMapView';
-export type { ChunkCoord, PackedTile, ResolvedTile, TileDefinition, TileProperties, TilePropertyValue, TileTransform, } from './types';
-export { TILE_TRANSFORM_IDENTITY, tileToChunkCoord, tileToLocalInChunk, } from './types';
+export type { ChunkCoord, PackedTile, ResolvedTile, TileAnimationFrame, TileDefinition, TileProperties, TilePropertyObjectRef, TilePropertyPoint, TilePropertyTileRef, TilePropertyValue, TileTransform, } from './types';
+export { TILE_TRANSFORM_IDENTITY, TilePropertyKind, tileToChunkCoord, tileToLocalInChunk, } from './types';
+export { TileAnimator } from './TileAnimator';
+export type { AutoTileOptions } from './autoTile';
+export { autoTile, refreshCell } from './autoTile';
+export type { WangSetOptions } from './WangSet';
+export { WangSet } from './WangSet';

package/dist/esm/register.js

@@ -1,5 +1,7 @@
 import { ExtensionRegistry } from '@codexo/exojs/extensions';
 import { tilemapExtension } from './tilemapExtension.js';
+export { ImageLayer } from './ImageLayer.js';
+export { ObjectKind, ObjectLayer } from './ObjectLayer.js';
 export { TileLayer } from './TileLayer.js';
 export { TileMap } from './TileMap.js';
 export { TileSet } from './TileSet.js';
@@ -7,7 +9,10 @@ export { TileLayerNode } from './TileLayerNode.js';
 export { TileMapNode } from './TileMapNode.js';
 export { TileMapBand } from './TileMapBand.js';
 export { TileMapView } from './TileMapView.js';
-export { TILE_TRANSFORM_IDENTITY, tileToChunkCoord, tileToLocalInChunk } from './types.js';
+export { TILE_TRANSFORM_IDENTITY, TilePropertyKind, tileToChunkCoord, tileToLocalInChunk } from './types.js';
+export { TileAnimator } from './TileAnimator.js';
+export { autoTile, refreshCell } from './autoTile.js';
+export { WangSet } from './WangSet.js';
 
 // @codexo/exojs-tilemap/register — explicit registration entry.
 // Importing this entry registers the default tilemapExtension descriptor

package/dist/esm/register.js.map

@@ -1 +1 @@
-{"version":3,"file":"register.js","sources":["../../../src/register.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;;;;;;;;AAAA;AACA;AACA;AACA;AACA;AAMA,iBAAiB,CAAC,QAAQ,CAAC,gBAAgB,CAAC;;;;"}
+{"version":3,"file":"register.js","sources":["../../../src/register.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA;AACA;AACA;AACA;AACA;AAMA,iBAAiB,CAAC,QAAQ,CAAC,gBAAgB,CAAC;;;;"}

package/dist/esm/tilemapExtension.d.ts

@@ -2,9 +2,10 @@ import type { Extension } from '@codexo/exojs/extensions';
 /**
  * Default immutable tilemap extension descriptor.
  *
- * Registers the WebGL2/WebGPU tile chunk renderers (`renderers`); it carries no
- * asset bindings — there is no generic on-disk tilemap format in this slice, so
- * format adapters (e.g. `@codexo/exojs-tiled`) own loading and depend on this
+ * Registers the WebGL2/WebGPU tile chunk renderers (`renderers`) and the
+ * {@link TileMapNode} scene serializer (`serializers`); it carries no asset
+ * bindings — there is no generic on-disk tilemap format in this slice, so format
+ * adapters (e.g. `@codexo/exojs-tiled`) own loading and depend on this
  * descriptor to pull in rendering.
  *
  * Install + register directly for procedural / hand-built maps

package/dist/esm/tilemapExtension.js

@@ -1,5 +1,7 @@
-import { RenderBackendType } from '@codexo/exojs/rendering';
+import { RenderBackendType } from '@codexo/exojs/renderer-sdk';
 import { TileChunkNode } from './TileChunkNode.js';
+import { TileMapNode } from './TileMapNode.js';
+import { tileMapNodeSerializer } from './tilemapSerializers.js';
 import { WebGl2TileChunkRenderer } from './webgl2/WebGl2TileChunkRenderer.js';
 import { WebGpuTileChunkRenderer } from './webgpu/WebGpuTileChunkRenderer.js';
 
@@ -30,9 +32,10 @@ function buildTileChunkRendererBinding(batchSize) {
 /**
  * Default immutable tilemap extension descriptor.
  *
- * Registers the WebGL2/WebGPU tile chunk renderers (`renderers`); it carries no
- * asset bindings — there is no generic on-disk tilemap format in this slice, so
- * format adapters (e.g. `@codexo/exojs-tiled`) own loading and depend on this
+ * Registers the WebGL2/WebGPU tile chunk renderers (`renderers`) and the
+ * {@link TileMapNode} scene serializer (`serializers`); it carries no asset
+ * bindings — there is no generic on-disk tilemap format in this slice, so format
+ * adapters (e.g. `@codexo/exojs-tiled`) own loading and depend on this
  * descriptor to pull in rendering.
  *
  * Install + register directly for procedural / hand-built maps
@@ -46,6 +49,7 @@ function buildTileChunkRendererBinding(batchSize) {
 const tilemapExtension = Object.freeze({
     id: '@codexo/exojs-tilemap',
     renderers: [buildTileChunkRendererBinding(tileRendererBatchSize)],
+    serializers: [{ typeName: 'TileMapNode', target: TileMapNode, serializer: tileMapNodeSerializer }],
 });
 
 export { tilemapExtension };

package/dist/esm/tilemapExtension.js.map

@@ -1 +1 @@
-{"version":3,"file":"tilemapExtension.js","sources":["../../../src/tilemapExtension.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;;AAQA;AACA,MAAM,qBAAqB,GAAG,IAAI;AAElC;;;;;;;AAOG;AACH,SAAS,6BAA6B,CAAC,SAAiB,EAAA;IACtD,OAAO;QACL,OAAO,EAAE,CAAC,aAAa,CAAC;AACxB,QAAA,MAAM,CAAC,OAAsB,EAAA;YAC3B,IAAI,OAAO,CAAC,WAAW,KAAK,iBAAiB,CAAC,MAAM,EAAE;AACpD,gBAAA,OAAO,IAAI,uBAAuB,CAAC,SAAS,CAAC;YAC/C;YAEA,IAAI,OAAO,CAAC,WAAW,KAAK,iBAAiB,CAAC,MAAM,EAAE;gBACpD,OAAO,IAAI,uBAAuB,EAAE;YACtC;AAEA,YAAA,MAAM,IAAI,KAAK,CAAC,CAAA,4BAAA,EAA+B,MAAM,CAAC,OAAO,CAAC,WAA2B,CAAC,CAAA,CAAE,CAAC;QAC/F,CAAC;KACF;AACH;AAEA;;;;;;;;;;;;;;;AAeG;AACI,MAAM,gBAAgB,GAAc,MAAM,CAAC,MAAM,CAAC;AACvD,IAAA,EAAE,EAAE,uBAAuB;AAC3B,IAAA,SAAS,EAAE,CAAC,6BAA6B,CAAC,qBAAqB,CAAC,CAAC;AAClE,CAAA;;;;"}
+{"version":3,"file":"tilemapExtension.js","sources":["../../../src/tilemapExtension.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;;;;AAUA;AACA,MAAM,qBAAqB,GAAG,IAAI;AAElC;;;;;;;AAOG;AACH,SAAS,6BAA6B,CAAC,SAAiB,EAAA;IACtD,OAAO;QACL,OAAO,EAAE,CAAC,aAAa,CAAC;AACxB,QAAA,MAAM,CAAC,OAAsB,EAAA;YAC3B,IAAI,OAAO,CAAC,WAAW,KAAK,iBAAiB,CAAC,MAAM,EAAE;AACpD,gBAAA,OAAO,IAAI,uBAAuB,CAAC,SAAS,CAAC;YAC/C;YAEA,IAAI,OAAO,CAAC,WAAW,KAAK,iBAAiB,CAAC,MAAM,EAAE;gBACpD,OAAO,IAAI,uBAAuB,EAAE;YACtC;AAEA,YAAA,MAAM,IAAI,KAAK,CAAC,CAAA,4BAAA,EAA+B,MAAM,CAAC,OAAO,CAAC,WAA2B,CAAC,CAAA,CAAE,CAAC;QAC/F,CAAC;KACF;AACH;AAEA;;;;;;;;;;;;;;;;AAgBG;AACI,MAAM,gBAAgB,GAAc,MAAM,CAAC,MAAM,CAAC;AACvD,IAAA,EAAE,EAAE,uBAAuB;AAC3B,IAAA,SAAS,EAAE,CAAC,6BAA6B,CAAC,qBAAqB,CAAC,CAAC;AACjE,IAAA,WAAW,EAAE,CAAC,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,EAAE,WAAW,EAAE,UAAU,EAAE,qBAAqB,EAAE,CAAC;AACnG,CAAA;;;;"}

package/dist/esm/tilemapSerializers.d.ts

@@ -0,0 +1,19 @@
+import type { NodeSerializer } from '@codexo/exojs';
+import { TileMapNode } from './TileMapNode';
+/**
+ * Scene serializer for {@link TileMapNode} — the convenience node that renders a
+ * whole {@link TileMap}.
+ *
+ * Captures the **map reference** (its Loader source key) plus the render-only
+ * `pixelSnapMode`; the per-layer / per-chunk nodes are derived from the map and
+ * rebuilt on construction, so they are never written. The referenced `TileMap`
+ * must be pre-loaded into the target Loader (e.g. `loader.load(TileMap, 'world.tmj')`)
+ * before deserialize — procedurally-built maps have no source key and cannot be
+ * referenced.
+ *
+ * Standalone `TileLayerNode` / `TileMapBand` placement (the actor-interleaving
+ * cases) is not yet covered.
+ *
+ * @internal — registered via {@link tilemapExtension}'s `serializers` binding.
+ */
+export declare const tileMapNodeSerializer: NodeSerializer<TileMapNode>;

package/dist/esm/tilemapSerializers.js

@@ -0,0 +1,47 @@
+import { TileMap } from './TileMap.js';
+import { TileMapNode } from './TileMapNode.js';
+
+/**
+ * Scene serializer for {@link TileMapNode} — the convenience node that renders a
+ * whole {@link TileMap}.
+ *
+ * Captures the **map reference** (its Loader source key) plus the render-only
+ * `pixelSnapMode`; the per-layer / per-chunk nodes are derived from the map and
+ * rebuilt on construction, so they are never written. The referenced `TileMap`
+ * must be pre-loaded into the target Loader (e.g. `loader.load(TileMap, 'world.tmj')`)
+ * before deserialize — procedurally-built maps have no source key and cannot be
+ * referenced.
+ *
+ * Standalone `TileLayerNode` / `TileMapBand` placement (the actor-interleaving
+ * cases) is not yet covered.
+ *
+ * @internal — registered via {@link tilemapExtension}'s `serializers` binding.
+ */
+const tileMapNodeSerializer = {
+    write(node, ctx) {
+        const out = {};
+        const source = ctx.keyFor(node.map);
+        if (source !== null) {
+            out.map = source;
+        }
+        if (node.pixelSnapMode !== 'none') {
+            out.pixelSnapMode = node.pixelSnapMode;
+        }
+        return out;
+    },
+    read(data, ctx) {
+        const map = ctx.resolveAsset(typeof data.map === 'string' ? data.map : null, TileMap);
+        if (map === null) {
+            throw new Error('TileMapNode deserialize requires its TileMap to be pre-loaded into the Loader (procedural maps have no source key).');
+        }
+        const node = new TileMapNode(map);
+        // The TileMapNode setter validates the value (throws on an invalid mode).
+        if (typeof data.pixelSnapMode === 'string') {
+            node.pixelSnapMode = data.pixelSnapMode;
+        }
+        return node;
+    },
+};
+
+export { tileMapNodeSerializer };
+//# sourceMappingURL=tilemapSerializers.js.map

package/dist/esm/tilemapSerializers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tilemapSerializers.js","sources":["../../../src/tilemapSerializers.ts"],"sourcesContent":[null],"names":[],"mappings":";;;AAMA;;;;;;;;;;;;;;;AAeG;AACI,MAAM,qBAAqB,GAAgC;IAChE,KAAK,CAAC,IAAI,EAAE,GAAG,EAAA;QACb,MAAM,GAAG,GAA4B,EAAE;QACvC,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC;AAEnC,QAAA,IAAI,MAAM,KAAK,IAAI,EAAE;AACnB,YAAA,GAAG,CAAC,GAAG,GAAG,MAAM;QAClB;AAEA,QAAA,IAAI,IAAI,CAAC,aAAa,KAAK,MAAM,EAAE;AACjC,YAAA,GAAG,CAAC,aAAa,GAAG,IAAI,CAAC,aAAa;QACxC;AAEA,QAAA,OAAO,GAAG;IACZ,CAAC;IACD,IAAI,CAAC,IAAI,EAAE,GAAG,EAAA;QACZ,MAAM,GAAG,GAAG,GAAG,CAAC,YAAY,CAAC,OAAO,IAAI,CAAC,GAAG,KAAK,QAAQ,GAAG,IAAI,CAAC,GAAG,GAAG,IAAI,EAAE,OAAO,CAAC;AAErF,QAAA,IAAI,GAAG,KAAK,IAAI,EAAE;AAChB,YAAA,MAAM,IAAI,KAAK,CAAC,qHAAqH,CAAC;QACxI;AAEA,QAAA,MAAM,IAAI,GAAG,IAAI,WAAW,CAAC,GAAG,CAAC;;AAGjC,QAAA,IAAI,OAAO,IAAI,CAAC,aAAa,KAAK,QAAQ,EAAE;AAC1C,YAAA,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,aAA8B;QAC1D;AAEA,QAAA,OAAO,IAAI;IACb,CAAC;;;;;"}