rn-gamekit 0.1.0 → 0.2.0

package/lib/module/storage/types.js

@@ -0,0 +1,16 @@
+"use strict";
+
+/**
+ * V1 storage contracts — game-owned projections, engine envelope, adapter.
+ */
+
+export const STORAGE_LIMITS = {
+  MAX_SERIALIZED_BYTES: 262_144,
+  // 256 KiB per slot
+  MAX_DEPTH: 16,
+  MAX_NODES: 4096,
+  MAX_ARRAY_LENGTH: 1024,
+  MAX_OBJECT_FIELDS: 1024,
+  MAX_STRING_LENGTH: 16_384
+};
+//# sourceMappingURL=types.js.map

package/lib/module/storage/types.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["STORAGE_LIMITS","MAX_SERIALIZED_BYTES","MAX_DEPTH","MAX_NODES","MAX_ARRAY_LENGTH","MAX_OBJECT_FIELDS","MAX_STRING_LENGTH"],"sourceRoot":"../../../src","sources":["storage/types.ts"],"mappings":";;AAAA;AACA;AACA;;AAkEA,OAAO,MAAMA,cAAc,GAAG;EAC5BC,oBAAoB,EAAE,OAAO;EAAE;EAC/BC,SAAS,EAAE,EAAE;EACbC,SAAS,EAAE,IAAI;EACfC,gBAAgB,EAAE,IAAI;EACtBC,iBAAiB,EAAE,IAAI;EACvBC,iBAAiB,EAAE;AACrB,CAAU","ignoreList":[]}

package/lib/module/storage/validation.js

@@ -0,0 +1,111 @@
+"use strict";
+
+import { GameStorageError, storageError } from "./errors.js";
+const SCHEMA_ID_RE = /^[a-z0-9]+(?:[._-][a-z0-9]+)*$/i;
+const NAMESPACE_RE = /^[a-zA-Z0-9._-]+$/;
+const SLOT_RE = /^[a-zA-Z0-9._-]+$/;
+export function validateSchemaId(id) {
+  if (typeof id !== 'string' || id.length === 0 || id.length > 128 || id.includes('\0')) {
+    throw storageError(`schema id must be a non-empty string 1..128 without null bytes`, 'INVALID_SCHEMA_ID', {
+      schemaId: String(id)
+    });
+  }
+  if (!SCHEMA_ID_RE.test(id)) {
+    throw storageError(`schema id "${id}" must be namespaced (e.g. com.example.game.save)`, 'INVALID_SCHEMA_ID', {
+      schemaId: id
+    });
+  }
+  if (id.startsWith('.') || id.endsWith('.') || id.includes('..')) {
+    throw storageError(`schema id "${id}" has invalid dot placement`, 'INVALID_SCHEMA_ID', {
+      schemaId: id
+    });
+  }
+}
+export function validateVersion(version) {
+  if (!Number.isSafeInteger(version) || version < 1) {
+    throw storageError(`schema version must be a positive safe integer`, 'INVALID_SCHEMA_VERSION', {
+      schemaVersion: version
+    });
+  }
+}
+export function validateNamespace(namespace) {
+  if (typeof namespace !== 'string' || namespace.length === 0 || namespace.length > 64 || namespace.includes('\0')) {
+    throw storageError(`namespace must be a non-empty string 1..64`, 'INVALID_NAMESPACE', {
+      namespace
+    });
+  }
+  if (!NAMESPACE_RE.test(namespace)) {
+    throw storageError(`namespace "${namespace}" contains invalid characters`, 'INVALID_NAMESPACE', {
+      namespace
+    });
+  }
+}
+export function validateSlot(slot) {
+  if (typeof slot !== 'string' || slot.length === 0 || slot.length > 64 || slot.includes('\0')) {
+    throw storageError(`slot must be a non-empty string 1..64`, 'INVALID_SLOT', {
+      slot
+    });
+  }
+  if (!SLOT_RE.test(slot)) {
+    throw storageError(`slot "${slot}" contains invalid characters`, 'INVALID_SLOT', {
+      slot
+    });
+  }
+}
+export function validateMigrations(migrations, currentVersion) {
+  if (migrations === null || typeof migrations !== 'object' || Array.isArray(migrations)) {
+    throw new GameStorageError('migrations must be a plain record', {
+      code: 'INVALID_MIGRATION'
+    });
+  }
+  const proto = Object.getPrototypeOf(migrations);
+  if (proto !== Object.prototype && proto !== null) {
+    throw new GameStorageError('migrations must be a plain record', {
+      code: 'INVALID_MIGRATION'
+    });
+  }
+  for (const [rawKey, fn] of Object.entries(migrations)) {
+    const n = Number(rawKey);
+    // GS-STORAGE-03: keys must be canonical — '01' and '1e0' normalize to
+    // 1 but would never be found by the numeric lookup, and two spellings
+    // of one version must not both be accepted (the canonicality check
+    // rejects every non-canonical spelling, so each version appears once).
+    if (!Number.isSafeInteger(n) || n < 1 || n >= currentVersion || String(n) !== rawKey) {
+      throw storageError(`migration key "${rawKey}" must be a canonical integer 1..${currentVersion - 1}`, 'INVALID_MIGRATION', {
+        path: `migrations.${rawKey}`
+      });
+    }
+    if (typeof fn !== 'function') {
+      throw storageError(`migration ${n} must be a function`, 'INVALID_MIGRATION', {
+        path: `migrations.${n}`
+      });
+    }
+  }
+}
+export function storageKey(namespace, slot) {
+  // GS-STORAGE-01: length-prefixed tuple — dots, slashes, and colons
+  // inside names can never collide across pairs. Format-versioned so
+  // future schemes route without guessing.
+  return `rn-gamekit.storage/v2/${namespace.length}:${namespace}/${slot.length}:${slot}`;
+}
+
+/**
+ * Recovery/compatibility policy (GS-STORAGE-01, preview release):
+ *
+ * - Writes go to v2 keys only. Reads try v2, then fall back to the legacy
+ *   dotted key, so pre-upgrade records load without any rewrite.
+ * - The first v2 save for a slot lazily migrates it; no blanket rewrite
+ *   ever runs, and legacy records are never deleted after an ambiguous
+ *   read (a legacy key cannot identify which pair wrote it).
+ * - `remove` deletes both the v2 and legacy keys. Under v1, colliding
+ *   pairs already shared one record (shared fate on delete); v2 converges
+ *   to independence as each pair saves. A pair that never saves under v2
+ *   keeps reading its legacy record until it does.
+ * - A legacy collision (`('game.a','b')` vs `('game','a.b')`) cannot be
+ *   disambiguated from the key alone: both pairs read the same heritage
+ *   record, exactly as v1 behaved. New writes never collide.
+ */
+export function legacyStorageKey(namespace, slot) {
+  return `rn-gamekit.storage.${namespace}.${slot}`;
+}
+//# sourceMappingURL=validation.js.map

package/lib/module/storage/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["GameStorageError","storageError","SCHEMA_ID_RE","NAMESPACE_RE","SLOT_RE","validateSchemaId","id","length","includes","schemaId","String","test","startsWith","endsWith","validateVersion","version","Number","isSafeInteger","schemaVersion","validateNamespace","namespace","validateSlot","slot","validateMigrations","migrations","currentVersion","Array","isArray","code","proto","Object","getPrototypeOf","prototype","rawKey","fn","entries","n","path","storageKey","legacyStorageKey"],"sourceRoot":"../../../src","sources":["storage/validation.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/storage.js

@@ -0,0 +1,4 @@
+"use strict";
+
+export * from "./storage/index.js";
+//# sourceMappingURL=storage.js.map

package/lib/module/storage.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sourceRoot":"../../src","sources":["storage.ts"],"mappings":";;AAAA,cAAc,oBAAiB","ignoreList":[]}

package/lib/module/testing.js

@@ -54,4 +54,8 @@ export class ManualFrameDriver {
     callback(timestampMs);
   }
 }
+
+// Test-only tilemap chunk-read instrumentation (T16-RF4): intentionally NOT
+// re-exported from rn-gamekit/tilemap.
+export { __resetChunkReadStats, __chunkReadCount } from "./tilemap/chunkStats.js";
 //# sourceMappingURL=testing.js.map

package/lib/module/testing.js.map

@@ -1 +1 @@
-{"version":3,"names":["createGameSessionWithDriver","createAnimationFrameDriver","ManualFrameDriver","callbacks","Map","allCallbacks","nextHandle","pendingCount","size","requestFrame","callback","handle","set","cancelFrame","delete","fireNext","timestampMs","next","entries","done","Error","value","fireCancelled","get"],"sourceRoot":"../../src","sources":["testing.ts"],"mappings":";;AAAA,SAASA,2BAA2B,QAAQ,qCAAkC;AAC9E,SAASC,0BAA0B,QAAQ,uBAAoB;AAI/D,SAASA,0BAA0B,EAAED,2BAA2B;AAGhE;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAME,iBAAiB,CAAwB;EAC3C,CAACC,SAAS,GAAG,IAAIC,GAAG,CAAwC,CAAC;EAC7D,CAACC,YAAY,GAAG,IAAID,GAAG,CAAwC,CAAC;EACzE,CAACE,UAAU,GAAG,CAAC;;EAEf;EACA,IAAIC,YAAYA,CAAA,EAAW;IACzB,OAAO,IAAI,CAAC,CAACJ,SAAS,CAACK,IAAI;EAC7B;EAEAC,YAAYA,CAACC,QAAuC,EAAe;IACjE,MAAMC,MAAM,GAAG,IAAI,CAAC,CAACL,UAAU;IAC/B,IAAI,CAAC,CAACA,UAAU,IAAI,CAAC;IACrB,IAAI,CAAC,CAACH,SAAS,CAACS,GAAG,CAACD,MAAM,EAAED,QAAQ,CAAC;IACrC,IAAI,CAAC,CAACL,YAAY,CAACO,GAAG,CAACD,MAAM,EAAED,QAAQ,CAAC;IACxC,OAAOC,MAAM;EACf;EAEAE,WAAWA,CAACF,MAAmB,EAAQ;IACrC,IAAI,CAAC,CAACR,SAAS,CAACW,MAAM,CAACH,MAAM,CAAC;EAChC;;EAEA;EACAI,QAAQA,CAACC,WAAmB,EAAe;IACzC,MAAMC,IAAI,GAAG,IAAI,CAAC,CAACd,SAAS,CAACe,OAAO,CAAC,CAAC,CAACD,IAAI,CAAC,CAAC;IAC7C,IAAIA,IAAI,CAACE,IAAI,EAAE;MACb,MAAM,IAAIC,KAAK,CAAC,qBAAqB,CAAC;IACxC;IACA,MAAM,CAACT,MAAM,EAAED,QAAQ,CAAC,GAAGO,IAAI,CAACI,KAAK;IACrC,IAAI,CAAC,CAAClB,SAAS,CAACW,MAAM,CAACH,MAAM,CAAC;IAC9BD,QAAQ,CAACM,WAAW,CAAC;IACrB,OAAOL,MAAM;EACf;;EAEA;AACF;AACA;AACA;EACEW,aAAaA,CAACX,MAAmB,EAAEK,WAAmB,EAAQ;IAC5D,MAAMN,QAAQ,GAAG,IAAI,CAAC,CAACL,YAAY,CAACkB,GAAG,CAACZ,MAAM,CAAC;IAC/C,IAAI,CAACD,QAAQ,EAAE;MACb,MAAM,IAAIU,KAAK,CAAC,yBAAyBT,MAAM,EAAE,CAAC;IACpD;IACAD,QAAQ,CAACM,WAAW,CAAC;EACvB;AACF","ignoreList":[]}
+{"version":3,"names":["createGameSessionWithDriver","createAnimationFrameDriver","ManualFrameDriver","callbacks","Map","allCallbacks","nextHandle","pendingCount","size","requestFrame","callback","handle","set","cancelFrame","delete","fireNext","timestampMs","next","entries","done","Error","value","fireCancelled","get","__resetChunkReadStats","__chunkReadCount"],"sourceRoot":"../../src","sources":["testing.ts"],"mappings":";;AAAA,SAASA,2BAA2B,QAAQ,qCAAkC;AAC9E,SAASC,0BAA0B,QAAQ,uBAAoB;AAI/D,SAASA,0BAA0B,EAAED,2BAA2B;AAGhE;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAME,iBAAiB,CAAwB;EAC3C,CAACC,SAAS,GAAG,IAAIC,GAAG,CAAwC,CAAC;EAC7D,CAACC,YAAY,GAAG,IAAID,GAAG,CAAwC,CAAC;EACzE,CAACE,UAAU,GAAG,CAAC;;EAEf;EACA,IAAIC,YAAYA,CAAA,EAAW;IACzB,OAAO,IAAI,CAAC,CAACJ,SAAS,CAACK,IAAI;EAC7B;EAEAC,YAAYA,CAACC,QAAuC,EAAe;IACjE,MAAMC,MAAM,GAAG,IAAI,CAAC,CAACL,UAAU;IAC/B,IAAI,CAAC,CAACA,UAAU,IAAI,CAAC;IACrB,IAAI,CAAC,CAACH,SAAS,CAACS,GAAG,CAACD,MAAM,EAAED,QAAQ,CAAC;IACrC,IAAI,CAAC,CAACL,YAAY,CAACO,GAAG,CAACD,MAAM,EAAED,QAAQ,CAAC;IACxC,OAAOC,MAAM;EACf;EAEAE,WAAWA,CAACF,MAAmB,EAAQ;IACrC,IAAI,CAAC,CAACR,SAAS,CAACW,MAAM,CAACH,MAAM,CAAC;EAChC;;EAEA;EACAI,QAAQA,CAACC,WAAmB,EAAe;IACzC,MAAMC,IAAI,GAAG,IAAI,CAAC,CAACd,SAAS,CAACe,OAAO,CAAC,CAAC,CAACD,IAAI,CAAC,CAAC;IAC7C,IAAIA,IAAI,CAACE,IAAI,EAAE;MACb,MAAM,IAAIC,KAAK,CAAC,qBAAqB,CAAC;IACxC;IACA,MAAM,CAACT,MAAM,EAAED,QAAQ,CAAC,GAAGO,IAAI,CAACI,KAAK;IACrC,IAAI,CAAC,CAAClB,SAAS,CAACW,MAAM,CAACH,MAAM,CAAC;IAC9BD,QAAQ,CAACM,WAAW,CAAC;IACrB,OAAOL,MAAM;EACf;;EAEA;AACF;AACA;AACA;EACEW,aAAaA,CAACX,MAAmB,EAAEK,WAAmB,EAAQ;IAC5D,MAAMN,QAAQ,GAAG,IAAI,CAAC,CAACL,YAAY,CAACkB,GAAG,CAACZ,MAAM,CAAC;IAC/C,IAAI,CAACD,QAAQ,EAAE;MACb,MAAM,IAAIU,KAAK,CAAC,yBAAyBT,MAAM,EAAE,CAAC;IACpD;IACAD,QAAQ,CAACM,WAAW,CAAC;EACvB;AACF;;AAEA;AACA;AACA,SAASQ,qBAAqB,EAAEC,gBAAgB,QAAQ,yBAAsB","ignoreList":[]}

package/lib/module/tilemap/chunkStats.js

@@ -0,0 +1,27 @@
+"use strict";
+
+/**
+ * Test-only chunk-read instrumentation (T16-F6/T16-RF4).
+ *
+ * Lives OUTSIDE the public `rn-gamekit/tilemap` entry: the counters are
+ * re-exported only through the `rn-gamekit/testing` subpath so published
+ * diagnostics never leak double-underscore seams into app code.
+ */
+
+let chunkReads = 0;
+
+/** Internal: record one chunk-region lookup. */
+export function recordChunkRead() {
+  chunkReads += 1;
+}
+
+/** Test-only: reset the chunk-visit counter. */
+export function __resetChunkReadStats() {
+  chunkReads = 0;
+}
+
+/** Test-only: number of chunk lookups since the last reset. */
+export function __chunkReadCount() {
+  return chunkReads;
+}
+//# sourceMappingURL=chunkStats.js.map

package/lib/module/tilemap/chunkStats.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["chunkReads","recordChunkRead","__resetChunkReadStats","__chunkReadCount"],"sourceRoot":"../../../src","sources":["tilemap/chunkStats.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,IAAIA,UAAU,GAAG,CAAC;;AAElB;AACA,OAAO,SAASC,eAAeA,CAAA,EAAS;EACtCD,UAAU,IAAI,CAAC;AACjB;;AAEA;AACA,OAAO,SAASE,qBAAqBA,CAAA,EAAS;EAC5CF,UAAU,GAAG,CAAC;AAChB;;AAEA;AACA,OAAO,SAASG,gBAAgBA,CAAA,EAAW;EACzC,OAAOH,UAAU;AACnB","ignoreList":[]}

package/lib/module/tilemap/definitions.js

@@ -0,0 +1,308 @@
+"use strict";
+
+import { tileError } from "./errors.js";
+import { recordChunkRead } from "./chunkStats.js";
+
+/** Frozen internal chunk size in cells (both axes). T16.0 contract. */
+export const TILE_CHUNK_SIZE = 16;
+
+/**
+ * Maximum cells per layer (GS-TILE-04). The per-axis bound alone permits
+ * 8192x8192 = 67M cells per layer (~0.5GB dense data plus index copies),
+ * so total authored cells are capped at 2048x2048 worth — far above real
+ * levels, far below the footgun.
+ */
+export const MAX_TILE_LAYER_CELLS = 4_194_304;
+
+/**
+ * Floor division truncating toward negative infinity — REQUIRED for
+ * negative cell coordinates (T16.0 contract).
+ */
+export function floorDiv(a, b) {
+  return Math.floor(a / b);
+}
+
+// ---------------------------------------------------------------------------
+// Private chunk index (T16-F1/F6)
+//
+// The index is stored in a module-private WeakMap keyed by the map value, so
+// consumers can neither mutate it nor depend on it through the public map.
+// Every runtime tile read flows through `tileAt`, which consults this index.
+// Visit instrumentation lives in ./chunkStats and is re-exported only via
+// rn-gamekit/testing (T16-RF4).
+//
+// Kept-read decision (GS-TILE-04, measured on desktop V8, Node 24):
+// dense spans traverse identically with or without the index (~23us for a
+// 40x24 window, ~2.1ms for a full 256x256 scan); sparse spans skip empty
+// chunks 1.5-3.9x faster (platformer-shaped window 0.8us vs 3.1us direct).
+// Absolute costs are microseconds per query, but the sparse win covers the
+// representative game shape (mostly-empty finite maps), so the index stays
+// with the total-cell cap above bounding its retained cost. See
+// bench/tileQueries.bench.ts (`pnpm bench:tilequeries`).
+// ---------------------------------------------------------------------------
+
+const chunkIndexes = new WeakMap();
+function buildChunkIndex(layers) {
+  const chunks = new Map();
+  for (const layer of layers) {
+    for (let y = 0; y < layer.height; y++) {
+      for (let x = 0; x < layer.width; x++) {
+        const v = layer.data[y * layer.width + x];
+        if (v === 0) continue;
+        const ccx = floorDiv(x, TILE_CHUNK_SIZE);
+        const ccy = floorDiv(y, TILE_CHUNK_SIZE);
+        const key = `${layer.id}|${ccx},${ccy}`;
+        let chunk = chunks.get(key);
+        if (chunk === undefined) {
+          chunk = new Int32Array(TILE_CHUNK_SIZE * TILE_CHUNK_SIZE);
+          chunks.set(key, chunk);
+        }
+        const lx = x - ccx * TILE_CHUNK_SIZE;
+        const ly = y - ccy * TILE_CHUNK_SIZE;
+        chunk[ly * TILE_CHUNK_SIZE + lx] = v;
+      }
+    }
+  }
+  return chunks;
+}
+export function defineTileSet2D(input) {
+  if (input === null || typeof input !== 'object' || input.tiles === null || typeof input.tiles !== 'object' || Array.isArray(input.tiles)) {
+    throw tileError('tiles', 'must be an object of named tile definitions');
+  }
+  const names = [];
+  const tiles = {};
+  const idOfName = {};
+  const nameOfId = {};
+  const collisionOfId = {};
+  for (const [name, defUnknown] of Object.entries(input.tiles)) {
+    if (name.length === 0) throw tileError('tiles', 'tile name must be non-empty');
+    const def = defUnknown;
+    if (def === null || typeof def !== 'object') {
+      throw tileError(`tiles.${JSON.stringify(name)}`, 'must be a tile definition object');
+    }
+    if (typeof def.frame !== 'string' || def.frame.length === 0) {
+      throw tileError(`tiles.${JSON.stringify(name)}.frame`, 'must be a non-empty frame name');
+    }
+    if (def.collision !== undefined && def.collision !== 'solid' && def.collision !== 'one-way-up') {
+      throw tileError(`tiles.${JSON.stringify(name)}.collision`, `must be "solid", "one-way-up", or omitted; got ${JSON.stringify(def.collision)}`);
+    }
+    names.push(name);
+    const id = names.length;
+    tiles[name] = Object.freeze({
+      frame: def.frame,
+      ...(def.collision !== undefined ? {
+        collision: def.collision
+      } : {})
+    });
+    idOfName[name] = id;
+    nameOfId[id] = name;
+    if (def.collision !== undefined) collisionOfId[id] = def.collision;
+  }
+  if (names.length === 0) throw tileError('tiles', 'must declare at least one tile');
+  if (names.length > 0xffff) throw tileError('tiles', 'v1 supports at most 65535 distinct tiles');
+  return Object.freeze({
+    names: Object.freeze(names.slice()),
+    tiles: Object.freeze(tiles),
+    idOfName: Object.freeze(idOfName),
+    nameOfId: Object.freeze(nameOfId),
+    collisionOfId: Object.freeze(collisionOfId)
+  });
+}
+function assertSafeInt(value, path) {
+  if (typeof value !== 'number' || !Number.isSafeInteger(value)) {
+    throw tileError(path, `must be a safe integer; got ${String(value)}`);
+  }
+}
+export function defineTileLayer2D(input, tileset) {
+  if (input === null || typeof input !== 'object' || Array.isArray(input)) {
+    throw tileError('layers[]', 'must be a layer object');
+  }
+  const p = `layers[${JSON.stringify(input?.id ?? '')}]`;
+  if (typeof input.id !== 'string' || input.id.length === 0) throw tileError(`${p}.id`, 'must be a non-empty string');
+  assertSafeInt(input.width, `${p}.width`);
+  assertSafeInt(input.height, `${p}.height`);
+  if (input.width <= 0 || input.width > 8192) throw tileError(`${p}.width`, `must be in 1..8192; got ${input.width}`);
+  if (input.height <= 0 || input.height > 8192) throw tileError(`${p}.height`, `must be in 1..8192; got ${input.height}`);
+  if (input.width * input.height > MAX_TILE_LAYER_CELLS) {
+    throw tileError(`${p}`, `width*height ${input.width * input.height} exceeds the maximum of ${MAX_TILE_LAYER_CELLS} cells per layer`);
+  }
+  if (!Array.isArray(input.data)) throw tileError(`${p}.data`, 'must be a row-major array of tile ids');
+  // T16-F1: collidable is validated at runtime, never trusted from types.
+  if (input.collidable !== undefined && typeof input.collidable !== 'boolean') {
+    throw tileError(`${p}.collidable`, `must be a boolean or omitted; got ${typeof input.collidable}`);
+  }
+  const expected = input.width * input.height;
+  if (input.data.length !== expected) {
+    throw tileError(`${p}.data`, `length ${input.data.length} must equal width*height (${expected})`);
+  }
+  const data = new Array(expected).fill(0);
+  for (let i = 0; i < expected; i++) {
+    const v = input.data[i];
+    if (v === 0) continue;
+    if (typeof v !== 'number' || !Number.isSafeInteger(v) || v < 0 || tileset.nameOfId[v] === undefined) {
+      throw tileError(`${p}.data[${i}]`, `unknown tile id ${String(v)} for the bound tileset`);
+    }
+    data[i] = v;
+  }
+  return Object.freeze({
+    id: input.id,
+    width: input.width,
+    height: input.height,
+    collidable: input.collidable ?? true,
+    // T16-F1: owned frozen copy — mutation attempts throw and never stick.
+    data: Object.freeze(data)
+  });
+}
+export function defineTileMap2D(input) {
+  if (input === null || typeof input !== 'object' || Array.isArray(input)) throw tileError('map', 'must be an object');
+  if (input.tileset === undefined || input.tileset.names === undefined) {
+    throw tileError('tileset', 'must be a value produced by defineTileSet2D');
+  }
+  const cw = input.cellSize?.width;
+  const ch = input.cellSize?.height;
+  if (typeof cw !== 'number' || !Number.isFinite(cw) || cw <= 0) throw tileError('cellSize.width', 'must be finite and > 0');
+  if (typeof ch !== 'number' || !Number.isFinite(ch) || ch <= 0) throw tileError('cellSize.height', 'must be finite and > 0');
+  if (!Array.isArray(input.layers)) throw tileError('layers', 'must be an array of layer inputs');
+  const originX = input.origin?.x ?? 0;
+  const originY = input.origin?.y ?? 0;
+  if (typeof originX !== 'number' || !Number.isFinite(originX)) throw tileError('origin.x', 'must be a finite number');
+  if (typeof originY !== 'number' || !Number.isFinite(originY)) throw tileError('origin.y', 'must be a finite number');
+  const origin = Object.freeze({
+    x: originX,
+    y: originY
+  });
+  const layers = [];
+  const layerById = {};
+  for (const layerInput of input.layers) {
+    const layer = defineTileLayer2D(layerInput, input.tileset);
+    if (layerById[layer.id] !== undefined) {
+      throw tileError('layers', `duplicate layer id ${JSON.stringify(layer.id)}`);
+    }
+    layers.push(layer);
+    layerById[layer.id] = layer;
+  }
+  if (layers.length === 0) throw tileError('layers', 'must declare at least one layer');
+
+  // World bounds cover every layer.
+  let maxX = Number.NEGATIVE_INFINITY;
+  let maxY = Number.NEGATIVE_INFINITY;
+  for (const layer of layers) {
+    maxX = Math.max(maxX, origin.x + layer.width * cw);
+    maxY = Math.max(maxY, origin.y + layer.height * ch);
+  }
+  const worldBounds = Object.freeze({
+    x: origin.x,
+    y: origin.y,
+    width: maxX - origin.x,
+    height: maxY - origin.y
+  });
+  const map = Object.freeze({
+    cellSize: Object.freeze({
+      width: cw,
+      height: ch
+    }),
+    // T16-F1: frozen public origin.
+    origin,
+    tileset: input.tileset,
+    layers: Object.freeze(layers.slice()),
+    layerById: Object.freeze(layerById),
+    worldBounds,
+    chunkSize: TILE_CHUNK_SIZE
+  });
+
+  // T16-F6: the chunk index lives OUTSIDE the public value.
+  chunkIndexes.set(map, buildChunkIndex(layers));
+  return map;
+}
+/** Internal: read one cell's tile id (0 when outside the finite map). */
+export function tileAt(map, layerId, cx, cy) {
+  const layer = map.layerById[layerId];
+  if (layer === undefined) return 0;
+  if (cx < 0 || cy < 0 || cx >= layer.width || cy >= layer.height) return 0;
+  // T16-F6: every read flows through the private chunk index.
+  const chunks = chunkIndexes.get(map);
+  if (chunks === undefined) return 0;
+  const ccx = floorDiv(cx, TILE_CHUNK_SIZE);
+  const ccy = floorDiv(cy, TILE_CHUNK_SIZE);
+  recordChunkRead();
+  const chunk = chunks.get(`${layerId}|${ccx},${ccy}`);
+  if (chunk === undefined) return 0;
+  return chunk[(cy - ccy * TILE_CHUNK_SIZE) * TILE_CHUNK_SIZE + (cx - ccx * TILE_CHUNK_SIZE)];
+}
+
+/**
+ * Internal: iterate non-empty cells inside an inclusive cell span in
+ * global row-major order, fetching each overlapped chunk region once
+ * (T16-F6). `visit` receives (layerId, cx, cy, tileId); returning false
+ * from `visit` stops iteration early.
+ */
+export function forEachCellInSpan(map, layerId, x0, y0, x1, y1, visit) {
+  const chunks = chunkIndexes.get(map);
+  if (chunks === undefined) return;
+  const bandY0 = floorDiv(y0, TILE_CHUNK_SIZE);
+  const bandY1 = floorDiv(y1, TILE_CHUNK_SIZE);
+  const bandX0 = floorDiv(x0, TILE_CHUNK_SIZE);
+  const bandX1 = floorDiv(x1, TILE_CHUNK_SIZE);
+  // T16-RF4: GLOBAL row-major order. For each chunk-Y band we fetch the
+  // intersecting chunk references ONCE (one lookup per chunk), then iterate
+  // global rows; within a row we visit the chunk-X segments left to right.
+  // This is exactly global row-major while keeping lookups bounded by the
+  // overlapped chunk regions.
+  const bandRefs = [];
+  for (let bcy = bandY0; bcy <= bandY1; bcy++) {
+    const rowStart = Math.max(y0, bcy * TILE_CHUNK_SIZE);
+    const rowEnd = Math.min(y1, (bcy + 1) * TILE_CHUNK_SIZE - 1);
+    // Fetch every intersecting chunk reference once per band.
+    bandRefs.length = 0;
+    for (let bcx = bandX0; bcx <= bandX1; bcx++) {
+      recordChunkRead();
+      bandRefs.push(chunks.get(`${layerId}|${bcx},${bcy}`));
+    }
+    for (let cy = rowStart; cy <= rowEnd; cy++) {
+      const ly = cy - bcy * TILE_CHUNK_SIZE;
+      const rowBase = ly * TILE_CHUNK_SIZE;
+      for (let bcx = bandX0; bcx <= bandX1; bcx++) {
+        const chunk = bandRefs[bcx - bandX0];
+        if (chunk === undefined) continue;
+        const lxStart = Math.max(x0, bcx * TILE_CHUNK_SIZE) - bcx * TILE_CHUNK_SIZE;
+        const lxEnd = Math.min(x1, (bcx + 1) * TILE_CHUNK_SIZE - 1) - bcx * TILE_CHUNK_SIZE;
+        for (let lx = lxStart; lx <= lxEnd; lx++) {
+          const v = chunk[rowBase + lx];
+          if (v === 0) continue;
+          const stop = visit(bcx * TILE_CHUNK_SIZE + lx, cy, v);
+          if (stop === false) return;
+        }
+      }
+    }
+  }
+}
+
+/** Convert a cell coordinate to its world AABB. */
+export function cellAabb(map, cx, cy) {
+  return Object.freeze({
+    x: map.origin.x + cx * map.cellSize.width,
+    y: map.origin.y + cy * map.cellSize.height,
+    width: map.cellSize.width,
+    height: map.cellSize.height
+  });
+}
+
+/** Frozen immutable query result builder. */
+export function makeCell(map, layerId, cx, cy, tileId) {
+  // GS-TILE-02: the single eligibility authority — a decorative
+  // (collidable: false) layer reports no collision role even for solid
+  // tiles, so queries and movement agree that decoration never blocks.
+  const collidable = map.layerById[layerId]?.collidable ?? false;
+  return Object.freeze({
+    layerId,
+    tileId,
+    tileName: map.tileset.nameOfId[tileId],
+    collision: collidable ? map.tileset.collisionOfId[tileId] : undefined,
+    cell: Object.freeze({
+      x: cx,
+      y: cy
+    }),
+    aabb: cellAabb(map, cx, cy)
+  });
+}
+//# sourceMappingURL=definitions.js.map

package/lib/module/tilemap/definitions.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["tileError","recordChunkRead","TILE_CHUNK_SIZE","MAX_TILE_LAYER_CELLS","floorDiv","a","b","Math","floor","chunkIndexes","WeakMap","buildChunkIndex","layers","chunks","Map","layer","y","height","x","width","v","data","ccx","ccy","key","id","chunk","get","undefined","Int32Array","set","lx","ly","defineTileSet2D","input","tiles","Array","isArray","names","idOfName","nameOfId","collisionOfId","name","defUnknown","Object","entries","length","def","JSON","stringify","frame","collision","push","freeze","slice","assertSafeInt","value","path","Number","isSafeInteger","String","defineTileLayer2D","tileset","p","collidable","expected","fill","i","defineTileMap2D","cw","cellSize","ch","isFinite","originX","origin","originY","layerById","layerInput","maxX","NEGATIVE_INFINITY","maxY","max","worldBounds","map","chunkSize","tileAt","layerId","cx","cy","forEachCellInSpan","x0","y0","x1","y1","visit","bandY0","bandY1","bandX0","bandX1","bandRefs","bcy","rowStart","rowEnd","min","bcx","rowBase","lxStart","lxEnd","stop","cellAabb","makeCell","tileId","tileName","cell","aabb"],"sourceRoot":"../../../src","sources":["tilemap/definitions.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/tilemap/errors.js

@@ -0,0 +1,13 @@
+"use strict";
+
+/** Tilemap definition/query/movement errors with exact field paths. */
+export class TileMapError extends Error {
+  name = 'TileMapError';
+  constructor(message) {
+    super(message);
+  }
+}
+export function tileError(path, message) {
+  return new TileMapError(`${path}: ${message}`);
+}
+//# sourceMappingURL=errors.js.map

package/lib/module/tilemap/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["TileMapError","Error","name","constructor","message","tileError","path"],"sourceRoot":"../../../src","sources":["tilemap/errors.ts"],"mappings":";;AAAA;AACA,OAAO,MAAMA,YAAY,SAASC,KAAK,CAAC;EAC7BC,IAAI,GAAG,cAAc;EAC9BC,WAAWA,CAACC,OAAe,EAAE;IAC3B,KAAK,CAACA,OAAO,CAAC;EAChB;AACF;AAEA,OAAO,SAASC,SAASA,CAACC,IAAY,EAAEF,OAAe,EAAgB;EACrE,OAAO,IAAIJ,YAAY,CAAC,GAAGM,IAAI,KAAKF,OAAO,EAAE,CAAC;AAChD","ignoreList":[]}

package/lib/module/tilemap/index.js

@@ -0,0 +1,10 @@
+"use strict";
+
+export * from "./types.js";
+export * from "./errors.js";
+export * from "./definitions.js";
+export * from "./queries.js";
+export * from "./movement.js";
+export * from "./tiledAdapter.js";
+export { TILE_CHUNK_SIZE, floorDiv } from "./definitions.js";
+//# sourceMappingURL=index.js.map

package/lib/module/tilemap/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["TILE_CHUNK_SIZE","floorDiv"],"sourceRoot":"../../../src","sources":["tilemap/index.ts"],"mappings":";;AAAA,cAAc,YAAS;AACvB,cAAc,aAAU;AACxB,cAAc,kBAAe;AAC7B,cAAc,cAAW;AACzB,cAAc,eAAY;AAC1B,cAAc,mBAAgB;AAC9B,SACEA,eAAe,EACfC,QAAQ,QACH,kBAAe","ignoreList":[]}