@codexo/exojs-tilemap 0.15.2 → 0.16.0

package/dist/esm/tilemapExtension.d.ts

@@ -4,7 +4,7 @@ import type { Extension } from '@codexo/exojs/extensions';
  *
  * 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
+ * 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.
  *
@@ -12,8 +12,9 @@ import type { Extension } from '@codexo/exojs/extensions';
  * (`extensions: [tilemapExtension]` plus a `TileMap` built via the runtime), or
  * receive it transitively through a format adapter's `dependencies`.
  *
- * Use with `ApplicationOptions.extensions` or call
- * `import '@codexo/exojs-tilemap/register'` for global auto-registration.
+ * Pass it to the application that should have it via
+ * `ApplicationOptions.extensions`.
  * @advanced
  */
 export declare const tilemapExtension: Extension;
+//# sourceMappingURL=tilemapExtension.d.ts.map

package/dist/esm/tilemapExtension.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tilemapExtension.d.ts","sourceRoot":"","sources":["../../src/tilemapExtension.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAmB,MAAM,0BAA0B,CAAC;AAoC3E;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,gBAAgB,EAAE,SAI7B,CAAC"}

package/dist/esm/tilemapExtension.js

@@ -1,56 +1,56 @@
-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';
+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";
+import { RenderBackendType } from "@codexo/exojs/renderer-sdk";
 
+//#region src/tilemapExtension.ts
 /** Per-tile instance batch size for the WebGL2 tile chunk renderer. */
 const tileRendererBatchSize = 4096;
 /**
- * Build the renderer binding that wires the per-backend
- * {@link import('./TileChunkNode').TileChunkNode} renderers. The binding targets
- * the internal chunk drawable; applications never construct it directly — they
- * build {@link import('./TileMapNode').TileMapNode} /
- * {@link import('./TileLayerNode').TileLayerNode}, whose chunk children resolve
- * to this renderer through the registry prototype walk.
- */
-function buildTileChunkRendererBinding(batchSize) {
-    return {
-        targets: [TileChunkNode],
-        create(backend) {
-            if (backend.backendType === RenderBackendType.WebGl2) {
-                return new WebGl2TileChunkRenderer(batchSize);
-            }
-            if (backend.backendType === RenderBackendType.WebGpu) {
-                return new WebGpuTileChunkRenderer();
-            }
-            throw new Error(`Unsupported render backend: ${String(backend.backendType)}`);
-        },
-    };
-}
+* Build the renderer binding that wires the per-backend
+* {@link import('./TileChunkNode').TileChunkNode} renderers. The binding targets
+* the internal chunk drawable; applications never construct it directly - they
+* build {@link import('./TileMapNode').TileMapNode} /
+* {@link import('./TileLayerNode').TileLayerNode}, whose chunk children resolve
+* to this renderer through the registry prototype walk.
+*/
+const buildTileChunkRendererBinding = (batchSize) => ({
+	targets: [TileChunkNode],
+	create(backend) {
+		if (backend.backendType === RenderBackendType.WebGl2) return new WebGl2TileChunkRenderer(batchSize);
+		if (backend.backendType === RenderBackendType.WebGpu) return new WebGpuTileChunkRenderer();
+		throw new Error(`Unsupported render backend: ${String(backend.backendType)}`);
+	}
+});
 /**
- * Default immutable tilemap extension descriptor.
- *
- * 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
- * (`extensions: [tilemapExtension]` plus a `TileMap` built via the runtime), or
- * receive it transitively through a format adapter's `dependencies`.
- *
- * Use with `ApplicationOptions.extensions` or call
- * `import '@codexo/exojs-tilemap/register'` for global auto-registration.
- * @advanced
- */
+* Default immutable tilemap extension descriptor.
+*
+* 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
+* (`extensions: [tilemapExtension]` plus a `TileMap` built via the runtime), or
+* receive it transitively through a format adapter's `dependencies`.
+*
+* Pass it to the application that should have it via
+* `ApplicationOptions.extensions`.
+* @advanced
+*/
 const tilemapExtension = Object.freeze({
-    id: '@codexo/exojs-tilemap',
-    renderers: [buildTileChunkRendererBinding(tileRendererBatchSize)],
-    serializers: [{ typeName: 'TileMapNode', target: TileMapNode, serializer: tileMapNodeSerializer }],
+	id: "@codexo/exojs-tilemap",
+	renderers: [buildTileChunkRendererBinding(tileRendererBatchSize)],
+	serializers: [{
+		typeName: "TileMapNode",
+		target: TileMapNode,
+		serializer: tileMapNodeSerializer
+	}]
 });
 
+//#endregion
 export { tilemapExtension };
-//# sourceMappingURL=tilemapExtension.js.map
+//# sourceMappingURL=tilemapExtension.js.map

package/dist/esm/tilemapExtension.js.map

@@ -1 +1 @@
-{"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;;;;"}
+{"version":3,"file":"tilemapExtension.js","names":[],"sources":["../../src/tilemapExtension.ts"],"sourcesContent":["import type { Extension, RendererBinding } from '@codexo/exojs/extensions';\nimport type { RenderBackend } from '@codexo/exojs/renderer-sdk';\nimport { RenderBackendType } from '@codexo/exojs/renderer-sdk';\n\nimport { TileChunkNode } from './TileChunkNode';\nimport { TileMapNode } from './TileMapNode';\nimport { tileMapNodeSerializer } from './tilemapSerializers';\nimport { WebGl2TileChunkRenderer } from './webgl2/WebGl2TileChunkRenderer';\nimport { WebGpuTileChunkRenderer } from './webgpu/WebGpuTileChunkRenderer';\n\n/** Per-tile instance batch size for the WebGL2 tile chunk renderer. */\nconst tileRendererBatchSize = 4096;\n\n/**\n * Build the renderer binding that wires the per-backend\n * {@link import('./TileChunkNode').TileChunkNode} renderers. The binding targets\n * the internal chunk drawable; applications never construct it directly - they\n * build {@link import('./TileMapNode').TileMapNode} /\n * {@link import('./TileLayerNode').TileLayerNode}, whose chunk children resolve\n * to this renderer through the registry prototype walk.\n */\nconst buildTileChunkRendererBinding = (batchSize: number): RendererBinding => ({\n  targets: [TileChunkNode],\n  create(backend: RenderBackend) {\n    if (backend.backendType === RenderBackendType.WebGl2) {\n      return new WebGl2TileChunkRenderer(batchSize);\n    }\n\n    if (backend.backendType === RenderBackendType.WebGpu) {\n      return new WebGpuTileChunkRenderer();\n    }\n\n    throw new Error(`Unsupported render backend: ${String(backend.backendType satisfies never)}`);\n  },\n});\n\n/**\n * Default immutable tilemap extension descriptor.\n *\n * Registers the WebGL2/WebGPU tile chunk renderers (`renderers`) and the\n * {@link TileMapNode} scene serializer (`serializers`); it carries no asset\n * bindings - there is no generic on-disk tilemap format in this slice, so format\n * adapters (e.g. `@codexo/exojs-tiled`) own loading and depend on this\n * descriptor to pull in rendering.\n *\n * Install + register directly for procedural / hand-built maps\n * (`extensions: [tilemapExtension]` plus a `TileMap` built via the runtime), or\n * receive it transitively through a format adapter's `dependencies`.\n *\n * Pass it to the application that should have it via\n * `ApplicationOptions.extensions`.\n * @advanced\n */\nexport const tilemapExtension: Extension = Object.freeze({\n  id: '@codexo/exojs-tilemap',\n  renderers: [buildTileChunkRendererBinding(tileRendererBatchSize)],\n  serializers: [{ typeName: 'TileMapNode', target: TileMapNode, serializer: tileMapNodeSerializer }],\n});\n"],"mappings":";;;;;;;;;AAWA,MAAM,wBAAwB;;;;;;;;;AAU9B,MAAM,iCAAiC,eAAwC;CAC7E,SAAS,CAAC,aAAa;CACvB,OAAO,SAAwB;EAC7B,IAAI,QAAQ,gBAAgB,kBAAkB,QAC5C,OAAO,IAAI,wBAAwB,SAAS;EAG9C,IAAI,QAAQ,gBAAgB,kBAAkB,QAC5C,OAAO,IAAI,wBAAwB;EAGrC,MAAM,IAAI,MAAM,+BAA+B,OAAO,QAAQ,WAA2B,GAAG;CAC9F;AACF;;;;;;;;;;;;;;;;;;AAmBA,MAAa,mBAA8B,OAAO,OAAO;CACvD,IAAI;CACJ,WAAW,CAAC,8BAA8B,qBAAqB,CAAC;CAChE,aAAa,CAAC;EAAE,UAAU;EAAe,QAAQ;EAAa,YAAY;CAAsB,CAAC;AACnG,CAAC"}

package/dist/esm/tilemapSerializers.d.ts

@@ -1,19 +1,20 @@
 import type { NodeSerializer } from '@codexo/exojs';
 import { TileMapNode } from './TileMapNode';
 /**
- * Scene serializer for {@link TileMapNode} — the convenience node that renders a
+ * 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
+ * must be pre-loaded into the target Loader (e.g. `loader.load(Asset.type('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.
+ * @internal - registered via {@link tilemapExtension}'s `serializers` binding.
  */
 export declare const tileMapNodeSerializer: NodeSerializer<TileMapNode>;
+//# sourceMappingURL=tilemapSerializers.d.ts.map

package/dist/esm/tilemapSerializers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tilemapSerializers.d.ts","sourceRoot":"","sources":["../../src/tilemapSerializers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAIpD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAgB5C;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,qBAAqB,EAAE,cAAc,CAAC,WAAW,CAkC7D,CAAC"}

package/dist/esm/tilemapSerializers.js

@@ -1,47 +1,54 @@
-import { TileMap } from './TileMap.js';
-import { TileMapNode } from './TileMapNode.js';
+import { TileMapNode } from "./TileMapNode.js";
+import { TileMap } from "./TileMap.js";
+import { PixelSnapMode } from "@codexo/exojs/renderer-sdk";
 
+//#region src/tilemapSerializers.ts
+const pixelSnapModeNames = {
+	[PixelSnapMode.None]: "none",
+	[PixelSnapMode.Position]: "position",
+	[PixelSnapMode.Geometry]: "geometry"
+};
+const pixelSnapModeFromName = {
+	none: PixelSnapMode.None,
+	position: PixelSnapMode.Position,
+	geometry: PixelSnapMode.Geometry
+};
 /**
- * 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.
- */
+* 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(Asset.type('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;
-    },
+	write(node, ctx) {
+		const out = {};
+		const source = ctx.keyFor(node.map);
+		if (source !== null) out.map = source;
+		if (node.pixelSnapMode !== PixelSnapMode.None) out.pixelSnapMode = pixelSnapModeNames[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);
+		if (typeof data.pixelSnapMode === "string") {
+			const mode = pixelSnapModeFromName[data.pixelSnapMode];
+			if (mode !== void 0) node.pixelSnapMode = mode;
+		}
+		return node;
+	}
 };
 
+//#endregion
 export { tileMapNodeSerializer };
-//# sourceMappingURL=tilemapSerializers.js.map
+//# sourceMappingURL=tilemapSerializers.js.map

package/dist/esm/tilemapSerializers.js.map

@@ -1 +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;;;;;"}
+{"version":3,"file":"tilemapSerializers.js","names":[],"sources":["../../src/tilemapSerializers.ts"],"sourcesContent":["import type { NodeSerializer } from '@codexo/exojs';\nimport { PixelSnapMode } from '@codexo/exojs/renderer-sdk';\n\nimport { TileMap } from './TileMap';\nimport { TileMapNode } from './TileMapNode';\n\n// On-disk format: the mode is persisted as its NAME (readable JSON, robust\n// against enum renumbering), mapped to/from the numeric enum here.\nconst pixelSnapModeNames: Record<PixelSnapMode, string> = {\n  [PixelSnapMode.None]: 'none',\n  [PixelSnapMode.Position]: 'position',\n  [PixelSnapMode.Geometry]: 'geometry',\n};\n\nconst pixelSnapModeFromName: Record<string, PixelSnapMode> = {\n  none: PixelSnapMode.None,\n  position: PixelSnapMode.Position,\n  geometry: PixelSnapMode.Geometry,\n};\n\n/**\n * Scene serializer for {@link TileMapNode} - the convenience node that renders a\n * whole {@link TileMap}.\n *\n * Captures the **map reference** (its Loader source key) plus the render-only\n * `pixelSnapMode`; the per-layer / per-chunk nodes are derived from the map and\n * rebuilt on construction, so they are never written. The referenced `TileMap`\n * must be pre-loaded into the target Loader (e.g. `loader.load(Asset.type('tileMap', 'world.tmj'))`)\n * before deserialize - procedurally-built maps have no source key and cannot be\n * referenced.\n *\n * Standalone `TileLayerNode` / `TileMapBand` placement (the actor-interleaving\n * cases) is not yet covered.\n *\n * @internal - registered via {@link tilemapExtension}'s `serializers` binding.\n */\nexport const tileMapNodeSerializer: NodeSerializer<TileMapNode> = {\n  write(node, ctx) {\n    const out: Record<string, unknown> = {};\n    const source = ctx.keyFor(node.map);\n\n    if (source !== null) {\n      out.map = source;\n    }\n\n    if (node.pixelSnapMode !== PixelSnapMode.None) {\n      out.pixelSnapMode = pixelSnapModeNames[node.pixelSnapMode];\n    }\n\n    return out;\n  },\n  read(data, ctx) {\n    const map = ctx.resolveAsset(typeof data.map === 'string' ? data.map : null, TileMap);\n\n    if (map === null) {\n      throw new Error('TileMapNode deserialize requires its TileMap to be pre-loaded into the Loader (procedural maps have no source key).');\n    }\n\n    const node = new TileMapNode(map);\n\n    if (typeof data.pixelSnapMode === 'string') {\n      const mode = pixelSnapModeFromName[data.pixelSnapMode];\n\n      if (mode !== undefined) {\n        node.pixelSnapMode = mode;\n      }\n    }\n\n    return node;\n  },\n};\n"],"mappings":";;;;;AAQA,MAAM,qBAAoD;EACvD,cAAc,OAAO;EACrB,cAAc,WAAW;EACzB,cAAc,WAAW;AAC5B;AAEA,MAAM,wBAAuD;CAC3D,MAAM,cAAc;CACpB,UAAU,cAAc;CACxB,UAAU,cAAc;AAC1B;;;;;;;;;;;;;;;;;AAkBA,MAAa,wBAAqD;CAChE,MAAM,MAAM,KAAK;EACf,MAAM,MAA+B,CAAC;EACtC,MAAM,SAAS,IAAI,OAAO,KAAK,GAAG;EAElC,IAAI,WAAW,MACb,IAAI,MAAM;EAGZ,IAAI,KAAK,kBAAkB,cAAc,MACvC,IAAI,gBAAgB,mBAAmB,KAAK;EAG9C,OAAO;CACT;CACA,KAAK,MAAM,KAAK;EACd,MAAM,MAAM,IAAI,aAAa,OAAO,KAAK,QAAQ,WAAW,KAAK,MAAM,MAAM,OAAO;EAEpF,IAAI,QAAQ,MACV,MAAM,IAAI,MAAM,qHAAqH;EAGvI,MAAM,OAAO,IAAI,YAAY,GAAG;EAEhC,IAAI,OAAO,KAAK,kBAAkB,UAAU;GAC1C,MAAM,OAAO,sBAAsB,KAAK;GAExC,IAAI,SAAS,QACX,KAAK,gBAAgB;EAEzB;EAEA,OAAO;CACT;AACF"}

package/dist/esm/types.d.ts

@@ -26,7 +26,7 @@ export interface TilePropertyPoint {
 }
 /**
  * A reference to another object/entity. `id` is the referenced object's
- * identity — Tiled's numeric object id, or LDtk's `entityIid`. The extra
+ * identity - Tiled's numeric object id, or LDtk's `entityIid`. The extra
  * fields are LDtk-only navigation context (`undefined` for Tiled-sourced
  * refs) that lets a consumer resolve the reference without searching the
  * whole level tree.
@@ -49,7 +49,7 @@ export interface TilePropertyTileRef {
 }
 /**
  * Union of legal tile-property value types in the generic runtime.
- * Format-neutral; adapters map their native property systems into this set —
+ * Format-neutral; adapters map their native property systems into this set -
  * including the structured {@link TilePropertyPoint}, {@link TilePropertyObjectRef},
  * and {@link TilePropertyTileRef} variants, arrays of any of the above, and
  * nested property bags (e.g. Tiled `class`-typed properties).
@@ -62,8 +62,8 @@ export type TilePropertyValue = null | boolean | number | string | TilePropertyP
  * a caller-owned mutable object.
  *
  * Declared as an interface (not a `Record<...>` type alias) so it can
- * mutually recurse with {@link TilePropertyValue} — a nested-bag member of
- * that union — without TypeScript's "circularly references itself" alias
+ * mutually recurse with {@link TilePropertyValue} - a nested-bag member of
+ * that union - without TypeScript's "circularly references itself" alias
  * restriction; structurally it behaves exactly like
  * `Readonly<Record<string, TilePropertyValue>>`.
  * @advanced
@@ -95,16 +95,16 @@ export declare const TILE_TRANSFORM_IDENTITY: Readonly<TileTransform>;
  * Returns one of the eight deterministic names, e.g. `"flipX"` or `"diag+flipX+flipY"`.
  * @internal
  */
-export declare function tileTransformLabel(t: TileTransform): string;
+export declare const tileTransformLabel: (t: TileTransform) => string;
 /**
  * Opaque packed tile data stored in a {@link TileChunk}'s compact array.
  * 0 means "empty cell". Any non-zero value encodes localTileId, tilesetIndex,
  * and flip bits according to the bit-layout constants below.
  *
- * A `PackedTile` is **not** a source-format GID — it is a fully resolved
+ * A `PackedTile` is **not** a source-format GID - it is a fully resolved
  * internal compact representation. Use {@link packTile} / {@link unpackTile}
- * (package-internal) to convert between packed form and a {@link ResolvedTile}
- * if writing adapters.
+ * to convert between packed form and a {@link ResolvedTile} if writing
+ * adapters.
  *
  * In public APIs, prefer {@link ResolvedTile} or null for queries.
  * `PackedTile` is exposed as `@advanced` so `ReadonlyTileChunk.getRawAt()`
@@ -133,15 +133,19 @@ export declare const MAX_LOCAL_TILE_ID: number;
  * cleanly represents an empty cell, while tile 0 from tileset 0 with identity
  * transform is stored as 1 (non-zero).
  * Returns 0 for an empty cell.
- * @internal
+ *
+ * Public so chunk-provider authors (e.g. a format adapter or procedural
+ * generator) can build a {@link ChunkPayload}'s `tiles` array without
+ * duplicating this encoding.
+ * @advanced
  */
-export declare function packTile(tilesetIndex: number, localTileId: number, transform: TileTransform): PackedTile;
+export declare const packTile: (tilesetIndex: number, localTileId: number, transform: TileTransform) => PackedTile;
 /**
  * Decode a packed word into its components.
  * Returns null for an empty cell (packed === 0).
- * @internal
+ * @advanced
  */
-export declare function unpackTile(packed: PackedTile): {
+export declare const unpackTile: (packed: PackedTile) => {
     tilesetIndex: number;
     localTileId: number;
     transform: TileTransform;
@@ -172,7 +176,7 @@ export interface TileAnimationFrame {
     readonly duration: number;
 }
 /**
- * Optional per-tile metadata in a {@link TileSet}. Sparse — only defined
+ * Optional per-tile metadata in a {@link TileSet}. Sparse - only defined
  * tiles carry a definition.
  * @advanced
  */
@@ -200,9 +204,9 @@ export interface ChunkCoord {
     readonly cy: number;
 }
 /** Convert tile coordinates to chunk coordinates given a chunk size. */
-export declare function tileToChunkCoord(tx: number, ty: number, chunkW: number, chunkH: number): ChunkCoord;
+export declare const tileToChunkCoord: (tx: number, ty: number, chunkW: number, chunkH: number) => ChunkCoord;
 /** Convert tile coordinates to local-in-chunk coordinates. */
-export declare function tileToLocalInChunk(tx: number, ty: number, chunkW: number, chunkH: number): {
+export declare const tileToLocalInChunk: (tx: number, ty: number, chunkW: number, chunkH: number) => {
     lx: number;
     ly: number;
 };
@@ -210,12 +214,24 @@ export declare function tileToLocalInChunk(tx: number, ty: number, chunkW: numbe
  * Validate that a value is a finite, safe, positive integer.
  * Used for dimensions, tile counts, chunk sizes.
  */
-export declare function validatePositiveInteger(value: number, label: string): void;
+export declare const validatePositiveInteger: (value: number, label: string) => void;
 /**
  * Validate a non-negative finite integer.
  */
-export declare function validateNonNegativeInteger(value: number, label: string): void;
+export declare const validateNonNegativeInteger: (value: number, label: string) => void;
 /**
  * Validate that a value is a finite integer (may be negative).
  */
-export declare function validateInteger(value: number, label: string): void;
+export declare const validateInteger: (value: number, label: string) => void;
+/**
+ * Validate a `width`/`height` pair that must be provided together (bounded)
+ * or omitted together (unbounded) - shared by {@link import('./TileLayer').TileLayer}
+ * and {@link import('./TileMap').TileMap}. When both are provided, each is
+ * validated as a positive integer via {@link validatePositiveInteger}.
+ *
+ * @param entityName Used in the paired-presence error message (e.g. `"TileLayer"`).
+ * @param fieldPrefix Used as the field-name prefix passed to {@link validatePositiveInteger} (e.g. `"layer"` for `"layer.width"`).
+ * @throws If exactly one of `width`/`height` is provided, or either is not a positive integer.
+ */
+export declare const validatePairedDimensions: (width: number | undefined, height: number | undefined, entityName: string, fieldPrefix: string) => void;
+//# sourceMappingURL=types.d.ts.map

package/dist/esm/types.d.ts.map

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