rn-gamekit 0.1.0 → 0.2.1

package/lib/typescript/src/storage/types.d.ts

@@ -0,0 +1,69 @@
+/**
+ * V1 storage contracts — game-owned projections, engine envelope, adapter.
+ */
+export interface GameSaveSchema<TData> {
+    readonly id: string;
+    readonly version: number;
+    readonly createDefault: () => TData;
+    readonly validate: (value: unknown) => TData;
+    readonly migrations: Readonly<Record<number, (value: unknown) => unknown>>;
+}
+export interface GameStorageAdapter {
+    read(key: string): Promise<string | undefined>;
+    write(key: string, value: string): Promise<void>;
+    remove(key: string): Promise<void>;
+}
+export interface StoredGameEnvelope {
+    readonly format: 'rn-gamekit.save';
+    readonly schemaId: string;
+    readonly schemaVersion: number;
+    readonly savedAtMs: number;
+    readonly payload: unknown;
+}
+export type GameSaveLoadStatus = 'default' | 'stored' | 'migrated';
+export interface GameSaveLoadResult<TData> {
+    readonly status: GameSaveLoadStatus;
+    readonly data: TData;
+    /** Present only when status === 'migrated' */
+    readonly fromVersion?: number;
+    /** Present only when status === 'migrated' */
+    readonly toVersion?: number;
+}
+export interface CreateGameSaveStoreOptions<TData> {
+    readonly schema: GameSaveSchema<TData>;
+    readonly adapter: GameStorageAdapter;
+    readonly namespace: string;
+}
+export interface GameSaveStore<TData> {
+    load(slot: string): Promise<GameSaveLoadResult<TData>>;
+    save(slot: string, data: TData): Promise<void>;
+    /**
+     * Delete a slot's record (GS-STORAGE-04): `remove` is the canonical
+     * verb; `delete` is a same-behavior alias kept for preview
+     * compatibility. Removes the versioned record and its legacy heritage.
+     */
+    remove(slot: string): Promise<void>;
+    /** Alias for remove — both names are accepted. */
+    delete(slot: string): Promise<void>;
+    /**
+     * Drain operations accepted before the call (GS-STORAGE-04): snapshots
+     * the in-flight set, waits for every snapshot member to settle —
+     * including failures — and never waits for later work. Always resolves
+     * (never rejects): each operation's own returned promise carries its
+     * success or failure. Per-slot ordering is per store instance, not a
+     * global cross-store lock; disposal rejects new work while accepted
+     * work still settles normally.
+     */
+    flush(): Promise<void>;
+    dispose(): void;
+    readonly disposed: boolean;
+}
+export declare const STORAGE_LIMITS: {
+    readonly MAX_SERIALIZED_BYTES: 262144;
+    readonly MAX_DEPTH: 16;
+    readonly MAX_NODES: 4096;
+    readonly MAX_ARRAY_LENGTH: 1024;
+    readonly MAX_OBJECT_FIELDS: 1024;
+    readonly MAX_STRING_LENGTH: 16384;
+};
+//# sourceMappingURL=types.d.ts.map

package/lib/typescript/src/storage/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/storage/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,cAAc,CAAC,KAAK;IACnC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,aAAa,EAAE,MAAM,KAAK,CAAC;IACpC,QAAQ,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,KAAK,CAAC;IAC7C,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC,CAAC,CAAC;CAC5E;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IAC/C,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjD,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;IACnC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG,QAAQ,GAAG,UAAU,CAAC;AAEnE,MAAM,WAAW,kBAAkB,CAAC,KAAK;IACvC,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC;IACpC,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IACrB,8CAA8C;IAC9C,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,8CAA8C;IAC9C,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,0BAA0B,CAAC,KAAK;IAC/C,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC,KAAK,CAAC,CAAC;IACvC,QAAQ,CAAC,OAAO,EAAE,kBAAkB,CAAC;IACrC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,aAAa,CAAC,KAAK;IAClC,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC,CAAC;IACvD,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/C;;;;OAIG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpC,kDAAkD;IAClD,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpC;;;;;;;;OAQG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,OAAO,IAAI,IAAI,CAAC;IAChB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B;AAED,eAAO,MAAM,cAAc;;;;;;;CAOjB,CAAC"}

package/lib/typescript/src/storage/validation.d.ts

@@ -0,0 +1,24 @@
+export declare function validateSchemaId(id: string): void;
+export declare function validateVersion(version: number): void;
+export declare function validateNamespace(namespace: string): void;
+export declare function validateSlot(slot: string): void;
+export declare function validateMigrations(migrations: Readonly<Record<number, (value: unknown) => unknown>>, currentVersion: number): void;
+export declare function storageKey(namespace: string, slot: string): string;
+/**
+ * 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 declare function legacyStorageKey(namespace: string, slot: string): string;
+//# sourceMappingURL=validation.d.ts.map

package/lib/typescript/src/storage/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../../src/storage/validation.ts"],"names":[],"mappings":"AAMA,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAcjD;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAMrD;AAED,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAOzD;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAO/C;AAED,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC,CAAC,EACjE,cAAc,EAAE,MAAM,GACrB,IAAI,CAuBN;AAED,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAKlE;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAExE"}

package/lib/typescript/src/storage.d.ts

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

package/lib/typescript/src/storage.d.ts.map

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

package/lib/typescript/src/testing.d.ts

@@ -25,4 +25,5 @@ export declare class ManualFrameDriver implements FrameDriver {
      */
     fireCancelled(handle: FrameHandle, timestampMs: number): void;
 }
+export { __resetChunkReadStats, __chunkReadCount } from './tilemap/chunkStats.js';
 //# sourceMappingURL=testing.d.ts.map

package/lib/typescript/src/testing.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"testing.d.ts","sourceRoot":"","sources":["../../../src/testing.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,2BAA2B,EAAE,MAAM,qCAAkC,CAAC;AAC/E,OAAO,EAAE,0BAA0B,EAAE,MAAM,uBAAoB,CAAC;AAChE,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,uBAAoB,CAAC;AACnE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,+BAA4B,CAAC;AAErE,OAAO,EAAE,0BAA0B,EAAE,2BAA2B,EAAE,CAAC;AACnE,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,kBAAkB,EAAE,CAAC;AAE7D;;;;;;GAMG;AACH,qBAAa,iBAAkB,YAAW,WAAW;;IAKnD,+CAA+C;IAC/C,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED,YAAY,CAAC,QAAQ,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,IAAI,GAAG,WAAW;IAQlE,WAAW,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI;IAItC,+DAA+D;IAC/D,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,WAAW;IAW1C;;;OAGG;IACH,aAAa,CAAC,MAAM,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI;CAO9D"}
+{"version":3,"file":"testing.d.ts","sourceRoot":"","sources":["../../../src/testing.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,2BAA2B,EAAE,MAAM,qCAAkC,CAAC;AAC/E,OAAO,EAAE,0BAA0B,EAAE,MAAM,uBAAoB,CAAC;AAChE,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,uBAAoB,CAAC;AACnE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,+BAA4B,CAAC;AAErE,OAAO,EAAE,0BAA0B,EAAE,2BAA2B,EAAE,CAAC;AACnE,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,kBAAkB,EAAE,CAAC;AAE7D;;;;;;GAMG;AACH,qBAAa,iBAAkB,YAAW,WAAW;;IAKnD,+CAA+C;IAC/C,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED,YAAY,CAAC,QAAQ,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,IAAI,GAAG,WAAW;IAQlE,WAAW,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI;IAItC,+DAA+D;IAC/D,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,WAAW;IAW1C;;;OAGG;IACH,aAAa,CAAC,MAAM,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI;CAO9D;AAID,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,yBAAsB,CAAC"}

package/lib/typescript/src/tilemap/chunkStats.d.ts

@@ -0,0 +1,14 @@
+/**
+ * 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.
+ */
+/** Internal: record one chunk-region lookup. */
+export declare function recordChunkRead(): void;
+/** Test-only: reset the chunk-visit counter. */
+export declare function __resetChunkReadStats(): void;
+/** Test-only: number of chunk lookups since the last reset. */
+export declare function __chunkReadCount(): number;
+//# sourceMappingURL=chunkStats.d.ts.map

package/lib/typescript/src/tilemap/chunkStats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunkStats.d.ts","sourceRoot":"","sources":["../../../../src/tilemap/chunkStats.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,gDAAgD;AAChD,wBAAgB,eAAe,IAAI,IAAI,CAEtC;AAED,gDAAgD;AAChD,wBAAgB,qBAAqB,IAAI,IAAI,CAE5C;AAED,+DAA+D;AAC/D,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC"}

package/lib/typescript/src/tilemap/definitions.d.ts

@@ -0,0 +1,38 @@
+import type { TileCell2D, TileLayer2D, TileMap2D, TileSet2D, TileLayerInput2D, TileMapInput2D } from './types.js';
+import type { Aabb2D } from '../geometry/types.js';
+/** Frozen internal chunk size in cells (both axes). T16.0 contract. */
+export declare 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 declare const MAX_TILE_LAYER_CELLS = 4194304;
+/**
+ * Floor division truncating toward negative infinity — REQUIRED for
+ * negative cell coordinates (T16.0 contract).
+ */
+export declare function floorDiv(a: number, b: number): number;
+export declare function defineTileSet2D(input: {
+    readonly tiles: Readonly<Record<string, {
+        readonly frame: string;
+        readonly collision?: 'solid' | 'one-way-up';
+    }>>;
+}): TileSet2D;
+export declare function defineTileLayer2D(input: TileLayerInput2D, tileset: TileSet2D): TileLayer2D;
+export declare function defineTileMap2D(input: TileMapInput2D): TileMap2D;
+/** Internal: read one cell's tile id (0 when outside the finite map). */
+export declare function tileAt(map: TileMap2D, layerId: string, cx: number, cy: number): number;
+/**
+ * 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 declare function forEachCellInSpan(map: TileMap2D, layerId: string, x0: number, y0: number, x1: number, y1: number, visit: (cx: number, cy: number, tileId: number) => boolean | void): void;
+/** Convert a cell coordinate to its world AABB. */
+export declare function cellAabb(map: TileMap2D, cx: number, cy: number): Aabb2D;
+/** Frozen immutable query result builder. */
+export declare function makeCell(map: TileMap2D, layerId: string, cx: number, cy: number, tileId: number): TileCell2D;
+//# sourceMappingURL=definitions.d.ts.map

package/lib/typescript/src/tilemap/definitions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"definitions.d.ts","sourceRoot":"","sources":["../../../../src/tilemap/definitions.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,UAAU,EACV,WAAW,EACX,SAAS,EACT,SAAS,EACT,gBAAgB,EAChB,cAAc,EACf,MAAM,YAAS,CAAC;AACjB,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAmB,CAAC;AAGhD,uEAAuE;AACvE,eAAO,MAAM,eAAe,KAAK,CAAC;AAElC;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,UAAY,CAAC;AAE9C;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAErD;AAiDD,wBAAgB,eAAe,CAAC,KAAK,EAAE;IACrC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,GAAG,YAAY,CAAA;KAAE,CAAC,CAAC,CAAC;CACnH,GAAG,SAAS,CAqCZ;AAQD,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,gBAAgB,EACvB,OAAO,EAAE,SAAS,GACjB,WAAW,CA6Cb;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,cAAc,GAAG,SAAS,CAoDhE;AAOD,yEAAyE;AACzE,wBAAgB,MAAM,CAAC,GAAG,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAatF;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,SAAS,EACd,OAAO,EAAE,MAAM,EACf,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAC9C,KAAK,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,OAAO,GAAG,IAAI,GAChE,IAAI,CAuCN;AAED,mDAAmD;AACnD,wBAAgB,QAAQ,CAAC,GAAG,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAOvE;AAED,6CAA6C;AAC7C,wBAAgB,QAAQ,CAAC,GAAG,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,UAAU,CAa5G"}

package/lib/typescript/src/tilemap/errors.d.ts

@@ -0,0 +1,7 @@
+/** Tilemap definition/query/movement errors with exact field paths. */
+export declare class TileMapError extends Error {
+    name: string;
+    constructor(message: string);
+}
+export declare function tileError(path: string, message: string): TileMapError;
+//# sourceMappingURL=errors.d.ts.map

package/lib/typescript/src/tilemap/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../../src/tilemap/errors.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,qBAAa,YAAa,SAAQ,KAAK;IAC5B,IAAI,SAAkB;gBACnB,OAAO,EAAE,MAAM;CAG5B;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,YAAY,CAErE"}

package/lib/typescript/src/tilemap/index.d.ts

@@ -0,0 +1,8 @@
+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.d.ts.map

package/lib/typescript/src/tilemap/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/tilemap/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAS,CAAC;AACxB,cAAc,aAAU,CAAC;AACzB,cAAc,kBAAe,CAAC;AAC9B,cAAc,cAAW,CAAC;AAC1B,cAAc,eAAY,CAAC;AAC3B,cAAc,mBAAgB,CAAC;AAC/B,OAAO,EACL,eAAe,EACf,QAAQ,GACT,MAAM,kBAAe,CAAC"}

package/lib/typescript/src/tilemap/movement.d.ts

@@ -0,0 +1,52 @@
+import type { PlatformerMoveResult2D, TileMap2D } from './types.js';
+import type { Aabb2D, Vector2D } from '../geometry/types.js';
+/** Frozen v1 movement semantics (T16.0). */
+export declare const PLATFORMER_MAX_ITERATIONS = 4;
+export declare const PLATFORMER_SKIN = 0.000001;
+/** Previous-bottom must be at or above the platform top by this tolerance. */
+export declare const ONE_WAY_TOLERANCE = 0.0001;
+export interface PlatformerMoveOptions2D {
+    /** Explicit per-call drop-through intent; the helper owns no timer. */
+    readonly dropThroughOneWay?: boolean;
+    /**
+     * Snap downward onto floor tops within this many world units when the
+     * body ends the step falling or resting and no floor contact was resolved.
+     * Default 0 (disabled).
+     */
+    readonly floorSnapDistance?: number;
+}
+/**
+ * Pure fixed-step AABB platformer movement (T16.3, T16-F5).
+ *
+ * Frozen semantics:
+ * - Axis order X then Y.
+ * - Solid tiles block both axes; one-way tiles block descent only when the
+ *   previous bottom was at/above the platform top (ONE_WAY_TOLERANCE) and
+ *   `dropThroughOneWay` is not set.
+ * - Starting overlap resolves along the least-penetration face preferring UP
+ *   on ties (up = negative y in y-down space), up to PLATFORMER_MAX_ITERATIONS;
+ *   unresolved spawn overlap throws deterministically. The reported contact is
+ *   always the tile that supplied the winning face.
+ * - Each axis resolves against the NEAREST blocking plane and reports contacts
+ *   ONLY for tiles touching that winning plane — farther crossed rows/columns
+ *   are never reported.
+ * - Floor snap pulls a falling/resting body down onto tops within
+ *   `floorSnapDistance`.
+ * - Candidate order is layer order then row-major cell order; equal physical
+ *   candidates preserve that deterministic order.
+ *
+ * Displacement contract (GS-TILE-03): `displacement` reports requested-motion
+ * resolution only — starting-overlap recovery moves the body and reports its
+ * contact, but never contributes to displacement. The caller's body object is
+ * never mutated or frozen; every returned body/contact/normal is an owned
+ * frozen value.
+ */
+export declare function movePlatformerBody2D(options: {
+    readonly body: Aabb2D;
+    readonly velocity: Vector2D;
+    readonly deltaSeconds: number;
+    readonly map: TileMap2D;
+    /** Layer ids that contribute collision; others render only. */
+    readonly collisionLayers: readonly string[];
+} & PlatformerMoveOptions2D): PlatformerMoveResult2D;
+//# sourceMappingURL=movement.d.ts.map

package/lib/typescript/src/tilemap/movement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"movement.d.ts","sourceRoot":"","sources":["../../../../src/tilemap/movement.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAEV,sBAAsB,EAEtB,SAAS,EACV,MAAM,YAAS,CAAC;AAGjB,OAAO,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,sBAAmB,CAAC;AAG1D,4CAA4C;AAC5C,eAAO,MAAM,yBAAyB,IAAI,CAAC;AAC3C,eAAO,MAAM,eAAe,WAAO,CAAC;AACpC,8EAA8E;AAC9E,eAAO,MAAM,iBAAiB,SAAO,CAAC;AAEtC,MAAM,WAAW,uBAAuB;IACtC,uEAAuE;IACvE,QAAQ,CAAC,iBAAiB,CAAC,EAAE,OAAO,CAAC;IACrC;;;;OAIG;IACH,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;CACrC;AAiBD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE;IAC5C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,GAAG,EAAE,SAAS,CAAC;IACxB,+DAA+D;IAC/D,QAAQ,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;CAC7C,GAAG,uBAAuB,GAAG,sBAAsB,CA+QnD"}

package/lib/typescript/src/tilemap/queries.d.ts

@@ -0,0 +1,21 @@
+import type { Aabb2D, Point2D } from '../geometry/types.js';
+import type { TileCell2D, TileMap2D } from './types.js';
+/** All non-empty cells in the given layers overlapping the point. */
+export declare function cellsAtPoint(map: TileMap2D, point: Point2D, layerIds?: readonly string[]): readonly TileCell2D[];
+/** All non-empty cells whose AABBs intersect the query AABB. */
+export declare function cellsInAabb(map: TileMap2D, aabb: Aabb2D, layerIds?: readonly string[]): readonly TileCell2D[];
+/**
+ * Cells overlapped by the swept bounds of a body moving by `displacement`.
+ * The swept bounds are the union AABB of start and end positions — bounded,
+ * never unbounded even for very large displacements (clamped to the map).
+ */
+export declare function cellsInSweptBounds(map: TileMap2D, body: Aabb2D, displacement: {
+    x: number;
+    y: number;
+}, layerIds?: readonly string[]): readonly TileCell2D[];
+/**
+ * Non-empty cells inside the visible region (camera bounds + overscan).
+ * Same deterministic ordering as `cellsInAabb`.
+ */
+export declare function visibleCells(map: TileMap2D, visibleBounds: Aabb2D, overscanCells: number, layerIds?: readonly string[]): readonly TileCell2D[];
+//# sourceMappingURL=queries.d.ts.map

package/lib/typescript/src/tilemap/queries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queries.d.ts","sourceRoot":"","sources":["../../../../src/tilemap/queries.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,sBAAmB,CAAC;AACzD,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,YAAS,CAAC;AAmCrD,qEAAqE;AACrE,wBAAgB,YAAY,CAC1B,GAAG,EAAE,SAAS,EACd,KAAK,EAAE,OAAO,EACd,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,GAC3B,SAAS,UAAU,EAAE,CAWvB;AAED,gEAAgE;AAChE,wBAAgB,WAAW,CACzB,GAAG,EAAE,SAAS,EACd,IAAI,EAAE,MAAM,EACZ,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,GAC3B,SAAS,UAAU,EAAE,CAkBvB;AAcD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,SAAS,EACd,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,EACtC,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,GAC3B,SAAS,UAAU,EAAE,CAQvB;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,GAAG,EAAE,SAAS,EACd,aAAa,EAAE,MAAM,EACrB,aAAa,EAAE,MAAM,EACrB,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,GAC3B,SAAS,UAAU,EAAE,CAevB"}

package/lib/typescript/src/tilemap/tiledAdapter.d.ts

@@ -0,0 +1,32 @@
+import type { TileMapInput2D, TileSet2D } from './types.js';
+/**
+ * Narrow Tiled JSON adapter (T16.5, hardened per T16-F6).
+ *
+ * Accepts ONLY the finite orthogonal subset used by the reference level:
+ * - `orientation: "orthogonal"`, `infinite: false`
+ * - `layers` of `type: "tilelayer"` with inline numeric `data` (no base64,
+ *   no compression, no chunks)
+ * - EVERY other layer type (objectgroup, group, imagelayer, ...) is rejected
+ *   with its exact source path — nothing silently disappears
+ * - Nonzero `offsetx`/`offsety` are rejected (v1 has no layer offsets)
+ * - No per-tile flips (high GID bits) — rejected with a source path
+ *
+ * The root value, options object, and every layer entry are validated BEFORE
+ * any property access, so malformed input always surfaces as a structured
+ * TileMapError instead of a TypeError. Raw Tiled JSON never enters
+ * fixed-step or rendering hot paths; the output is a normalized Gamekit map
+ * input.
+ */
+export interface TiledAdapterOptions {
+    /**
+     * Map Tiled global tile ids to Gamekit tile names. The referenced names
+     * must exist on the provided tileset.
+     */
+    readonly gidToTileName: Readonly<Record<number, string>>;
+    /** Layers to convert, in order. Defaults to every tilelayer. */
+    readonly layerIds?: readonly string[];
+    /** Layers that contribute collision; unlisted layers stay decorative. */
+    readonly collidableLayers?: readonly string[];
+}
+export declare function parseTiledMap2D(json: unknown, tileset: TileSet2D, options: TiledAdapterOptions): TileMapInput2D;
+//# sourceMappingURL=tiledAdapter.d.ts.map

package/lib/typescript/src/tilemap/tiledAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tiledAdapter.d.ts","sourceRoot":"","sources":["../../../../src/tilemap/tiledAdapter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,YAAS,CAAC;AAEzD;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,QAAQ,CAAC,aAAa,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACzD,gEAAgE;IAChE,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,yEAAyE;IACzE,QAAQ,CAAC,gBAAgB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC/C;AAYD,wBAAgB,eAAe,CAC7B,IAAI,EAAE,OAAO,EACb,OAAO,EAAE,SAAS,EAClB,OAAO,EAAE,mBAAmB,GAC3B,cAAc,CAqHhB"}

package/lib/typescript/src/tilemap/types.d.ts

@@ -0,0 +1,127 @@
+import type { Aabb2D, Point2D } from '../geometry/types.js';
+/**
+ * Tilemap v1 contract (Task 16).
+ *
+ * Finite orthogonal maps, y-down world coordinates matching Gamekit
+ * geometry. All public values are immutable plain data; mutable author
+ * buffers are cloned at definition time and never exposed.
+ */
+/** Collision behavior contributed by one tile kind. */
+export type TileCollisionKind2D = 'solid' | 'one-way-up';
+/** One named tile: render frame plus optional collision role. */
+export interface TileDef2D {
+    /** Frame name inside the bound sprite sheet. */
+    readonly frame: string;
+    /** Collision role; absent means purely decorative. */
+    readonly collision?: TileCollisionKind2D;
+}
+/**
+ * Named tile registry. Numeric tile ids are assigned by declaration order
+ * starting at 1; id 0 always means EMPTY.
+ */
+export interface TileSet2D {
+    /** Insertion-ordered tile names; index i corresponds to tile id i+1. */
+    readonly names: readonly string[];
+    /** Frozen tile defs by name. */
+    readonly tiles: Readonly<Record<string, TileDef2D>>;
+    /** name -> numeric id (≥1). */
+    readonly idOfName: Readonly<Record<string, number>>;
+    /** numeric id -> name. */
+    readonly nameOfId: Readonly<Record<number, string>>;
+    /** collision kind by numeric id (absent = decorative). */
+    readonly collisionOfId: Readonly<Record<number, TileCollisionKind2D>>;
+}
+/** Author input for one layer: row-major tile ids, 0 = empty. */
+export interface TileLayerInput2D {
+    readonly id: string;
+    readonly width: number;
+    readonly height: number;
+    /** Row-major tile ids; length MUST equal width*height; 0 = empty. */
+    readonly data: readonly number[];
+    /** Purely decorative layers skip collision queries entirely. */
+    readonly collidable?: boolean;
+}
+/** Normalized immutable layer with owned storage. */
+export interface TileLayer2D {
+    readonly id: string;
+    readonly width: number;
+    readonly height: number;
+    readonly collidable: boolean;
+    /** Owned row-major copy; index = y*width + x; 0 = empty. */
+    readonly data: readonly number[];
+}
+export interface TileMapInput2D {
+    /** Finite positive cell size in world units. */
+    readonly cellSize: {
+        readonly width: number;
+        readonly height: number;
+    };
+    readonly tileset: TileSet2D;
+    /** Ordered layers; later entries render above earlier ones. */
+    readonly layers: TileLayerInput2D[];
+    /** World origin of cell (0,0)'s top-left corner. Defaults to {x:0,y:0}. */
+    readonly origin?: Point2D;
+}
+/** Normalized immutable map with precomputed bounds and chunk indexes. */
+export interface TileMap2D {
+    readonly cellSize: {
+        readonly width: number;
+        readonly height: number;
+    };
+    readonly origin: Point2D;
+    readonly tileset: TileSet2D;
+    /** Frozen ordered layer list. */
+    readonly layers: readonly TileLayer2D[];
+    /** layer id -> layer. */
+    readonly layerById: Readonly<Record<string, TileLayer2D>>;
+    /** World-space AABB covering every layer's cells. */
+    readonly worldBounds: Aabb2D;
+    /** Frozen chunk size in cells (both axes). Internal detail. */
+    readonly chunkSize: number;
+}
+/** Immutable query result for one non-empty cell. */
+export interface TileCell2D {
+    readonly layerId: string;
+    readonly tileId: number;
+    readonly tileName: string;
+    readonly collision: TileCollisionKind2D | undefined;
+    /** Cell coordinate (signed safe integers). */
+    readonly cell: Point2D;
+    /** World AABB of the cell. */
+    readonly aabb: Aabb2D;
+}
+/** Classified contact between a platformer body and one tile. */
+export interface PlatformerContact2D {
+    readonly cell: TileCell2D;
+    /** Contact normal pointing OUT of the tile toward the body. */
+    readonly normal: {
+        readonly x: number;
+        readonly y: number;
+    };
+}
+/** Result of one fixed-step platformer movement. */
+export interface PlatformerMoveResult2D {
+    readonly body: Aabb2D;
+    readonly velocity: {
+        readonly x: number;
+        readonly y: number;
+    };
+    /** Displacement actually applied. */
+    readonly displacement: {
+        readonly x: number;
+        readonly y: number;
+    };
+    /** intended − applied. */
+    readonly remainingDisplacement: {
+        readonly x: number;
+        readonly y: number;
+    };
+    readonly contacts: {
+        readonly floor: PlatformerContact2D | undefined;
+        readonly ceiling: PlatformerContact2D | undefined;
+        readonly leftWall: PlatformerContact2D | undefined;
+        readonly rightWall: PlatformerContact2D | undefined;
+        readonly all: readonly PlatformerContact2D[];
+    };
+}
+//# sourceMappingURL=types.d.ts.map

package/lib/typescript/src/tilemap/types.d.ts.map

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

package/lib/typescript/src/tilemap.d.ts

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

package/lib/typescript/src/tilemap.d.ts.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rn-gamekit",
-  "version": "0.1.0",
+  "version": "0.2.1",
   "description": "A headless-first 2D game toolkit for React Native and Expo, built for mobile and tablet.",
   "license": "MIT",
   "keywords": [
@@ -45,6 +45,72 @@
       "source": "./src/testing.ts",
       "types": "./lib/typescript/src/testing.d.ts",
       "default": "./lib/module/testing.js"
+    },
+    "./audio": {
+      "react-native": "./src/audio.ts",
+      "source": "./src/audio.ts",
+      "types": "./lib/typescript/src/audio.d.ts",
+      "default": "./lib/module/audio.js"
+    },
+    "./haptics": {
+      "react-native": "./src/haptics.ts",
+      "source": "./src/haptics.ts",
+      "types": "./lib/typescript/src/haptics.d.ts",
+      "default": "./lib/module/haptics.js"
+    },
+    "./particles": {
+      "react-native": "./src/particles.ts",
+      "source": "./src/particles.ts",
+      "types": "./lib/typescript/src/particles.d.ts",
+      "default": "./lib/module/particles.js"
+    },
+    "./tilemap": {
+      "react-native": "./src/tilemap.ts",
+      "source": "./src/tilemap.ts",
+      "types": "./lib/typescript/src/tilemap.d.ts",
+      "default": "./lib/module/tilemap.js"
+    },
+    "./geometry": {
+      "react-native": "./src/geometry.ts",
+      "source": "./src/geometry.ts",
+      "types": "./lib/typescript/src/geometry.d.ts",
+      "default": "./lib/module/geometry.js"
+    },
+    "./collision2d": {
+      "react-native": "./src/collision2d.ts",
+      "source": "./src/collision2d.ts",
+      "types": "./lib/typescript/src/collision2d.d.ts",
+      "default": "./lib/module/collision2d.js"
+    },
+    "./camera2d": {
+      "react-native": "./src/camera2d.ts",
+      "source": "./src/camera2d.ts",
+      "types": "./lib/typescript/src/camera2d.d.ts",
+      "default": "./lib/module/camera2d.js"
+    },
+    "./events": {
+      "react-native": "./src/events.ts",
+      "source": "./src/events.ts",
+      "types": "./lib/typescript/src/events.d.ts",
+      "default": "./lib/module/events.js"
+    },
+    "./assets": {
+      "react-native": "./src/assets.ts",
+      "source": "./src/assets.ts",
+      "types": "./lib/typescript/src/assets.d.ts",
+      "default": "./lib/module/assets.js"
+    },
+    "./sprites": {
+      "react-native": "./src/sprites.ts",
+      "source": "./src/sprites.ts",
+      "types": "./lib/typescript/src/sprites.d.ts",
+      "default": "./lib/module/sprites.js"
+    },
+    "./storage": {
+      "react-native": "./src/storage.ts",
+      "source": "./src/storage.ts",
+      "types": "./lib/typescript/src/storage.d.ts",
+      "default": "./lib/module/storage.js"
     }
   },
   "react-native": "./src/index.ts",
@@ -60,39 +126,52 @@
     "clean": "del-cli lib",
     "lint": "eslint .",
     "typecheck": "tsc --noEmit",
-    "test": "node --import tsx --test test/*.test.ts",
-    "test:coverage": "node --import tsx --experimental-test-coverage --test test/*.test.ts",
+    "test": "node --expose-gc --import tsx --experimental-test-module-mocks --test \"test/*.test.ts\" \"test/*.test.tsx\"",
+    "test:coverage": "node --expose-gc --import tsx --experimental-test-module-mocks --experimental-test-coverage --test \"test/*.test.ts\" \"test/*.test.tsx\"",
     "prepack": "bob build",
     "pack:inspect": "pnpm pack --dry-run",
     "bench:deepfreeze": "node --import tsx bench/deepFreeze.bench.ts",
+    "bench:spatialhash": "node --import tsx bench/spatialHash.bench.ts",
+    "bench:tilequeries": "node --import tsx bench/tileQueries.bench.ts",
+    "bench:particles": "node --import tsx bench/particles.bench.ts",
+    "bench:storage": "node --import tsx bench/storage.bench.ts",
     "test:coverage:gate": "node scripts/coverage-gate.mjs",
-    "typecheck:assets": "tsc -p tsconfig.assets.json"
+    "typecheck:assets": "tsc -p tsconfig.assets.json",
+    "typecheck:api": "tsc -p tsconfig.assets.json"
   },
   "peerDependencies": {
+    "@react-native-async-storage/async-storage": "^2.2.0",
     "@shopify/react-native-skia": "2.11.0",
-    "expo": "~57.0.10",
-    "expo-asset": "~57.0.8",
+    "expo": "~57.0.25",
+    "expo-asset": "~57.0.18",
     "react": "^19.2.3",
-    "react-native": "~0.86.2",
+    "react-native": "~0.86.3",
+    "react-native-audio-api": "^0.13.3",
     "react-native-gesture-handler": "~3.1.0",
+    "react-native-pulsar": "^1.7.0",
     "react-native-reanimated": "4.5.3",
     "react-native-worklets": "0.10.3"
   },
   "devDependencies": {
+    "@react-native-async-storage/async-storage": "2.2.0",
     "@shopify/react-native-skia": "2.11.0",
     "@types/node": "^22.0.0",
     "@types/react": "19.2.18",
     "@types/react-test-renderer": "^19.1.0",
     "del-cli": "^7.0.0",
     "eslint": "^9.39.0",
-    "expo": "57.0.10",
-    "expo-asset": "57.0.8",
+    "expo": "57.0.25",
+    "expo-asset": "57.0.18",
+    "planck": "1.5.0",
     "react": "19.2.3",
     "react-dom": "19.2.3",
-    "react-native": "0.86.2",
+    "react-native": "0.86.3",
+    "react-native-audio-api": "0.13.3",
     "react-native-builder-bob": "^0.43.0",
     "react-native-gesture-handler": "3.1.0",
+    "react-native-pulsar": "1.7.0",
     "react-native-reanimated": "4.5.3",
+    "react-native-safe-area-context": "~5.7.0",
     "react-native-worklets": "0.10.3",
     "react-test-renderer": "19.2.3",
     "tsx": "^4.19.0",
@@ -116,5 +195,16 @@
         }
       ]
     ]
+  },
+  "peerDependenciesMeta": {
+    "react-native-audio-api": {
+      "optional": true
+    },
+    "react-native-pulsar": {
+      "optional": true
+    },
+    "@react-native-async-storage/async-storage": {
+      "optional": true
+    }
   }
 }