rn-gamekit 0.1.0 → 0.2.0

package/lib/module/tilemap/tiledAdapter.js

@@ -0,0 +1,141 @@
+"use strict";
+
+import { tileError } from "./errors.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.
+ */
+
+function reject(cond, path, message) {
+  if (cond) throw tileError(path, message);
+}
+function assertPlainObject(value, path) {
+  if (value === null || typeof value !== 'object' || Array.isArray(value)) {
+    throw tileError(path, `expected an object; got ${value === null ? 'null' : Array.isArray(value) ? 'array' : typeof value}`);
+  }
+}
+export function parseTiledMap2D(json, tileset, options) {
+  // Validate inputs BEFORE any property access (T16-F6).
+  assertPlainObject(json, 'root');
+  assertPlainObject(options, 'options');
+  const gidMap = options.gidToTileName;
+  if (gidMap === null || typeof gidMap !== 'object' || Array.isArray(gidMap)) {
+    throw tileError('options.gidToTileName', 'must be an object mapping gids to tile names');
+  }
+  if (options.layerIds !== undefined) {
+    if (!Array.isArray(options.layerIds)) throw tileError('options.layerIds', 'must be an array of layer names');
+    for (let i = 0; i < options.layerIds.length; i++) {
+      if (typeof options.layerIds[i] !== 'string') {
+        throw tileError(`options.layerIds[${i}]`, 'must be a string');
+      }
+    }
+  }
+  if (options.collidableLayers !== undefined) {
+    if (!Array.isArray(options.collidableLayers)) throw tileError('options.collidableLayers', 'must be an array of layer names');
+    for (let i = 0; i < options.collidableLayers.length; i++) {
+      if (typeof options.collidableLayers[i] !== 'string') {
+        throw tileError(`options.collidableLayers[${i}]`, 'must be a string');
+      }
+    }
+  }
+  if (tileset === undefined || tileset.idOfName === undefined) {
+    throw tileError('tileset', 'must be a value produced by defineTileSet2D');
+  }
+  const root = json;
+  reject(root.orientation !== 'orthogonal', 'root.orientation', `only "orthogonal" is supported; got ${JSON.stringify(root.orientation)}`);
+  reject(root.infinite === true, 'root.infinite', 'infinite maps are not supported in v1');
+  const width = root.width;
+  const height = root.height;
+  reject(typeof width !== 'number' || !Number.isSafeInteger(width) || width <= 0, 'root.width', 'must be a positive integer');
+  reject(typeof height !== 'number' || !Number.isSafeInteger(height) || height <= 0, 'root.height', 'must be a positive integer');
+  const tw = root.tilewidth;
+  const th = root.tileheight;
+  reject(typeof tw !== 'number' || !Number.isFinite(tw) || tw <= 0, 'root.tilewidth', 'must be finite and > 0');
+  reject(typeof th !== 'number' || !Number.isFinite(th) || th <= 0, 'root.tileheight', 'must be finite and > 0');
+  reject(!Array.isArray(root.layers), 'root.layers', 'must be an array of layer objects');
+  const layersRaw = root.layers;
+  const wanted = options.layerIds;
+  const collidableLayers = options.collidableLayers;
+  const layers = [];
+  layersRaw.forEach((rawLayerUnknown, index) => {
+    assertPlainObject(rawLayerUnknown, `layers[${index}]`);
+    const layer = rawLayerUnknown;
+    const rawType = layer.type;
+    reject(typeof rawType !== 'string', `layers[${index}].type`, `must be a string layer type; got ${JSON.stringify(rawType)}`);
+    // T16-F6: tilelayer is the ONLY accepted type — every other layer type
+    // (objectgroup, group, imagelayer, unknown future types) is rejected
+    // with its exact source path instead of being silently skipped.
+    reject(rawType !== 'tilelayer', `layers[${index}](${JSON.stringify(String(layer.name ?? ''))}).type`, `"${String(rawType)}" layers are not supported in v1`);
+    const name = typeof layer.name === 'string' && layer.name.length > 0 ? layer.name : `layer${index}`;
+    if (wanted !== undefined && !wanted.includes(name)) return;
+    const p = `layers[${index}](${JSON.stringify(name)})`;
+    // T16-F6: nonzero layer offsets change cell placement — rejected, not ignored.
+    reject(layer.offsetx !== undefined && layer.offsetx !== 0, `${p}.offsetx`, `nonzero layer offsets are not supported in v1; got ${JSON.stringify(layer.offsetx)}`);
+    reject(layer.offsety !== undefined && layer.offsety !== 0, `${p}.offsety`, `nonzero layer offsets are not supported in v1; got ${JSON.stringify(layer.offsety)}`);
+    reject(layer.encoding !== undefined && layer.encoding !== 'csv', `${p}.encoding`, `only inline CSV-free numeric arrays are supported; got ${JSON.stringify(layer.encoding)}`);
+    reject(layer.compression !== undefined, `${p}.compression`, 'compressed layers are not supported in v1');
+    reject(layer.chunks !== undefined, `${p}.chunks`, 'chunked (infinite) layers are not supported in v1');
+    reject(!Array.isArray(layer.data), `${p}.data`, 'must be an inline array of gids');
+    const layerWidth = layer.width;
+    const layerHeight = layer.height;
+    reject(layerWidth !== width, `${p}.width`, `must equal map width ${String(width)}`);
+    reject(layerHeight !== height, `${p}.height`, `must equal map height ${String(height)}`);
+    const gidData = layer.data;
+    reject(gidData.length !== width * height, `${p}.data`, `length must equal width*height (${String(width)}*${String(height)})`);
+
+    // Convert gids -> Gamekit ids. Flip bits unsupported.
+    const out = new Array(gidData.length);
+    for (let i = 0; i < gidData.length; i++) {
+      const rawUnknown = gidData[i];
+      const raw = typeof rawUnknown === 'number' ? rawUnknown : -1;
+      reject(!Number.isSafeInteger(raw) || raw < 0, `${p}.data[${i}]`, `must be a non-negative safe integer; got ${JSON.stringify(rawUnknown)}`);
+      if (raw === 0) {
+        out[i] = 0;
+        continue;
+      }
+      const FLIP_BITS = 0x80000000 | 0x40000000 | 0x20000000;
+      reject((raw & FLIP_BITS) !== 0, `${p}.data[${i}]`, 'per-tile flip/rotation flags are not supported in v1');
+      const mapped = gidMap[raw];
+      reject(mapped === undefined, `${p}.data[${i}]`, `gid ${raw} has no mapping in gidToTileName`);
+      const gamekitId = tileset.idOfName[mapped] ?? -1;
+      reject(gamekitId === -1, `${p}.data[${i}]`, `mapped tile name ${JSON.stringify(mapped)} is missing from the bound tileset`);
+      out[i] = gamekitId;
+    }
+    layers.push({
+      id: name,
+      width: width,
+      height: height,
+      data: out,
+      collidable: collidableLayers ? collidableLayers.includes(name) : true
+    });
+  });
+  reject(layers.length === 0, 'layers', 'no tilelayers matched; at least one is required');
+  return {
+    cellSize: {
+      width: tw,
+      height: th
+    },
+    tileset,
+    layers,
+    origin: {
+      x: 0,
+      y: 0
+    }
+  };
+}
+//# sourceMappingURL=tiledAdapter.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["tileError","reject","cond","path","message","assertPlainObject","value","Array","isArray","parseTiledMap2D","json","tileset","options","gidMap","gidToTileName","layerIds","undefined","i","length","collidableLayers","idOfName","root","orientation","JSON","stringify","infinite","width","height","Number","isSafeInteger","tw","tilewidth","th","tileheight","isFinite","layers","layersRaw","wanted","forEach","rawLayerUnknown","index","layer","rawType","type","String","name","includes","p","offsetx","offsety","encoding","compression","chunks","data","layerWidth","layerHeight","gidData","out","rawUnknown","raw","FLIP_BITS","mapped","gamekitId","push","id","collidable","cellSize","origin","x","y"],"sourceRoot":"../../../src","sources":["tilemap/tiledAdapter.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/tilemap/types.js

@@ -0,0 +1,4 @@
+"use strict";
+
+export {};
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":[],"sourceRoot":"../../../src","sources":["tilemap/types.ts"],"mappings":"","ignoreList":[]}

package/lib/module/tilemap.js

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

package/lib/module/tilemap.js.map

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

package/lib/typescript/src/assets/defineAssets.d.ts

@@ -6,7 +6,7 @@ export declare function image(source: number): ImageDescriptor;
  * clips. Frame and clip names are preserved as string literals; clip frame
  * references are restricted to the declared frames.
  */
-export declare function spriteSheet<TFrames extends Record<string, SpriteFrameRect>, TClips extends Record<string, SpriteClip<Extract<keyof TFrames, string>>>>(source: number, spec: {
+export declare function spriteSheet<const TFrames extends Record<string, SpriteFrameRect>, const TClips extends Record<string, SpriteClip<Extract<keyof TFrames, string>>>>(source: number, spec: {
     readonly frames: TFrames;
     readonly animations: TClips;
 }): SpriteSheetDescriptor<TFrames, TClips>;

package/lib/typescript/src/assets/defineAssets.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"defineAssets.d.ts","sourceRoot":"","sources":["../../../../src/assets/defineAssets.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EACV,aAAa,EACb,iBAAiB,EACjB,eAAe,EACf,UAAU,EACV,eAAe,EACf,qBAAqB,EACtB,MAAM,YAAS,CAAC;AAEjB,qEAAqE;AACrE,wBAAgB,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,eAAe,CAGrD;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CACzB,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,EAC/C,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,OAAO,CAAC,MAAM,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,EAEzE,MAAM,EAAE,MAAM,EACd,IAAI,EAAE;IACJ,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B,GACA,qBAAqB,CAAC,OAAO,EAAE,MAAM,CAAC,CASxC;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,OAAO,SAAS,aAAa,EACxD,MAAM,EAAE,OAAO,GACd,iBAAiB,CAAC,OAAO,CAAC,CAI5B"}
+{"version":3,"file":"defineAssets.d.ts","sourceRoot":"","sources":["../../../../src/assets/defineAssets.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EACV,aAAa,EACb,iBAAiB,EACjB,eAAe,EACf,UAAU,EACV,eAAe,EACf,qBAAqB,EACtB,MAAM,YAAS,CAAC;AAEjB,qEAAqE;AACrE,wBAAgB,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,eAAe,CAGrD;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CACzB,KAAK,CAAC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,EACrD,KAAK,CAAC,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,OAAO,CAAC,MAAM,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,EAE/E,MAAM,EAAE,MAAM,EACd,IAAI,EAAE;IACJ,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B,GACA,qBAAqB,CAAC,OAAO,EAAE,MAAM,CAAC,CAqBxC;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,OAAO,SAAS,aAAa,EACxD,MAAM,EAAE,OAAO,GACd,iBAAiB,CAAC,OAAO,CAAC,CAU5B"}

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

@@ -0,0 +1,11 @@
+/**
+ * Subpath entry for `rn-gamekit/assets`.
+ *
+ * Asset manifest definitions and public descriptor types — no React hooks,
+ * Skia decoding, or Expo Asset acquisition.
+ */
+export { defineAssets, image, spriteSheet } from './assets/defineAssets.js';
+export { GameAssetError } from './assets/errors.js';
+export type { GameAssetErrorCode } from './assets/errors.js';
+export type { AssetDescriptor, AssetGroup, AssetGroupMap, AssetSourceHandle, BrandedAssetDescriptor, GameAssetLease, GameAssetManifest, ImageDescriptor, LoadedAssets, LoadedImage, LoadedSpriteSheet, ManifestOf, SpriteAnimationMode, SpriteClip, SpriteFrameRect, SpriteSheetDescriptor, } from './assets/types.js';
+//# sourceMappingURL=assets.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"assets.d.ts","sourceRoot":"","sources":["../../../src/assets.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,0BAAuB,CAAC;AACzE,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAiB,CAAC;AACjD,YAAY,EAAE,kBAAkB,EAAE,MAAM,oBAAiB,CAAC;AAC1D,YAAY,EACV,eAAe,EACf,UAAU,EACV,aAAa,EACb,iBAAiB,EACjB,sBAAsB,EACtB,cAAc,EACd,iBAAiB,EACjB,eAAe,EACf,YAAY,EACZ,WAAW,EACX,iBAAiB,EACjB,UAAU,EACV,mBAAmB,EACnB,UAAU,EACV,eAAe,EACf,qBAAqB,GACtB,MAAM,mBAAgB,CAAC"}

package/lib/typescript/src/audio/createGameAudio.d.ts

@@ -0,0 +1,5 @@
+import type { AudioSoundRecord, CreateGameAudioOptions, GameAudio } from './types.js';
+export declare function __setAssetInputLoader(fn: ((assetId: number) => Promise<number | string | ArrayBuffer>) | null): void;
+export declare function __getAssetInputLoader(): ((assetId: number) => Promise<number | string | ArrayBuffer>) | null;
+export declare function createGameAudio<T extends AudioSoundRecord>(options: CreateGameAudioOptions<T>): Promise<GameAudio<T>>;
+//# sourceMappingURL=createGameAudio.d.ts.map

package/lib/typescript/src/audio/createGameAudio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createGameAudio.d.ts","sourceRoot":"","sources":["../../../../src/audio/createGameAudio.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAiB,gBAAgB,EAAE,sBAAsB,EAAE,SAAS,EAAwB,MAAM,YAAS,CAAC;AA4BxH,wBAAgB,qBAAqB,CACnC,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,MAAM,GAAG,WAAW,CAAC,CAAC,GAAG,IAAI,GACvE,IAAI,CAEN;AAED,wBAAgB,qBAAqB,IAAI,CAAC,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,MAAM,GAAG,WAAW,CAAC,CAAC,GAAG,IAAI,CAE5G;AAED,wBAAsB,eAAe,CAAC,CAAC,SAAS,gBAAgB,EAC9D,OAAO,EAAE,sBAAsB,CAAC,CAAC,CAAC,GACjC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAksBvB"}

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

@@ -0,0 +1,6 @@
+export declare class GameAudioError extends Error {
+    name: string;
+    constructor(message: string);
+}
+export declare function createAudioInstallationError(): GameAudioError;
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../../src/audio/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,cAAe,SAAQ,KAAK;IAC9B,IAAI,SAAoB;gBACrB,OAAO,EAAE,MAAM;CAG5B;AAED,wBAAgB,4BAA4B,IAAI,cAAc,CAI7D"}

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

@@ -0,0 +1,4 @@
+export { createGameAudio } from './createGameAudio.js';
+export { GameAudioError } from './errors.js';
+export type { AudioCategory, AudioSoundRecord, CreateGameAudioOptions, GameAudio, GameAudioPlayOptions, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/audio/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAmB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,aAAU,CAAC;AAC1C,YAAY,EACV,aAAa,EACb,gBAAgB,EAChB,sBAAsB,EACtB,SAAS,EACT,oBAAoB,GACrB,MAAM,YAAS,CAAC"}

package/lib/typescript/src/audio/resolver.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Injectable resolver for the optional `react-native-audio-api` peer.
+ *
+ * Production code calls `loadAudioApi()` which does a dynamic `import()`.
+ * Tests inject a fake via `__setAudioApiLoader` to simulate a missing peer
+ * without relying on a production fallback object.
+ */
+export type LoadedAudioApi = {
+    AudioContext: new (options?: {
+        sampleRate?: number;
+    }) => {
+        readonly state: 'running' | 'suspended' | 'closed';
+        readonly currentTime: number;
+        readonly destination: unknown;
+        readonly sampleRate: number;
+        decodeAudioData(input: number | string | ArrayBuffer): Promise<{
+            length: number;
+            duration: number;
+        } & Record<string, unknown>>;
+        createBufferSource(): {
+            buffer: unknown | null;
+            loop: boolean;
+            connect(destination: unknown): void;
+            start(when?: number, offset?: number, duration?: number): void;
+            stop(when?: number): void;
+            addEventListener?(type: string, cb: () => void): void;
+        };
+        createGain(): unknown;
+        suspend(): Promise<void>;
+        resume(): Promise<void>;
+        close(): Promise<void>;
+    };
+    AudioManager: {
+        getDevicePreferredSampleRate(): number;
+        addSystemEventListener(name: 'interruption' | 'volumeChange' | 'duck' | 'routeChange', cb: (event: unknown) => void): {
+            remove(): void;
+            subscriptionId?: string;
+        };
+        observeAudioInterruptions(param: unknown): void;
+    } | undefined;
+};
+export declare function __setAudioApiLoader(fn: (() => Promise<LoadedAudioApi>) | null): void;
+export declare function loadAudioApi(): Promise<LoadedAudioApi>;
+//# sourceMappingURL=resolver.d.ts.map

package/lib/typescript/src/audio/resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.d.ts","sourceRoot":"","sources":["../../../../src/audio/resolver.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,YAAY,EAAE,KAAK,OAAO,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK;QACvD,QAAQ,CAAC,KAAK,EAAE,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAC;QACnD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;QAC7B,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;QAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;QAC5B,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,WAAW,GAAG,OAAO,CAAC;YAAE,MAAM,EAAE,MAAM,CAAC;YAAC,QAAQ,EAAE,MAAM,CAAA;SAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;QAC/H,kBAAkB,IAAI;YACpB,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC;YACvB,IAAI,EAAE,OAAO,CAAC;YACd,OAAO,CAAC,WAAW,EAAE,OAAO,GAAG,IAAI,CAAC;YACpC,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;YAC/D,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;YAC1B,gBAAgB,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;SACvD,CAAC;QACF,UAAU,IAAI,OAAO,CAAC;QACtB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;QACzB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;QACxB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;KACxB,CAAC;IACF,YAAY,EAAE;QACZ,4BAA4B,IAAI,MAAM,CAAC;QACvC,sBAAsB,CACpB,IAAI,EAAE,cAAc,GAAG,cAAc,GAAG,MAAM,GAAG,aAAa,EAC9D,EAAE,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,GAC3B;YAAE,MAAM,IAAI,IAAI,CAAC;YAAC,cAAc,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;QAC/C,yBAAyB,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;KACjD,GAAG,SAAS,CAAC;CACf,CAAC;AAIF,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,CAAC,MAAM,OAAO,CAAC,cAAc,CAAC,CAAC,GAAG,IAAI,GAAG,IAAI,CAEpF;AAED,wBAAsB,YAAY,IAAI,OAAO,CAAC,cAAc,CAAC,CA8B5D"}

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

@@ -0,0 +1,42 @@
+export type AudioCategory = 'master' | 'music' | 'sfx' | 'ui';
+import type { GameLifecycleSource } from '../core/session/types.js';
+export type AudioSoundRecord = Record<string, number>;
+export interface CreateGameAudioOptions<T extends AudioSoundRecord> {
+    readonly sounds: T;
+}
+export interface GameAudioPlayOptions {
+    readonly category?: AudioCategory;
+    readonly volume?: number;
+    readonly loop?: boolean;
+    readonly concurrency?: {
+        readonly key?: string;
+        readonly limit?: number;
+        readonly overflow?: 'drop-new' | 'stop-oldest';
+    };
+}
+export interface GameAudio<T extends AudioSoundRecord = AudioSoundRecord> {
+    play<K extends keyof T & string>(id: K, options?: GameAudioPlayOptions): void;
+    playMusic<K extends keyof T & string>(id: K): Promise<void>;
+    stopMusic(): void;
+    pause(): void;
+    resume(): void;
+    setVolume(category: AudioCategory, volume: number): void;
+    getVolume(category: AudioCategory): number;
+    setMuted(muted: boolean): void;
+    isMuted(): boolean;
+    /**
+     * Session-driven pause (GS-AUDIO-04): follows the bound session status,
+     * independent of the manual pause()/resume() hold, app backgrounding,
+     * interruption, and mute — any reason suspends.
+     */
+    setPaused(paused: boolean): void;
+    /**
+     * Bind one session lifecycle source (GS-AUDIO-04, mirrors haptics):
+     * applies the current status immediately, follows transitions, and
+     * detaches any previously bound source. Returns an idempotent detach.
+     * All subscriptions disappear on disposal.
+     */
+    bindLifecycle(source: GameLifecycleSource): () => void;
+    dispose(): void;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/audio/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,OAAO,GAAG,KAAK,GAAG,IAAI,CAAC;AAG9D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAAuB,CAAC;AAEjE,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAEtD,MAAM,WAAW,sBAAsB,CAAC,CAAC,SAAS,gBAAgB;IAChE,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;CACpB;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,QAAQ,CAAC,EAAE,aAAa,CAAC;IAClC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,WAAW,CAAC,EAAE;QACrB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QACxB,QAAQ,CAAC,QAAQ,CAAC,EAAE,UAAU,GAAG,aAAa,CAAC;KAChD,CAAC;CACH;AAED,MAAM,WAAW,SAAS,CAAC,CAAC,SAAS,gBAAgB,GAAG,gBAAgB;IACtE,IAAI,CAAC,CAAC,SAAS,MAAM,CAAC,GAAG,MAAM,EAAE,EAAE,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,oBAAoB,GAAG,IAAI,CAAC;IAC9E,SAAS,CAAC,CAAC,SAAS,MAAM,CAAC,GAAG,MAAM,EAAE,EAAE,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5D,SAAS,IAAI,IAAI,CAAC;IAClB,KAAK,IAAI,IAAI,CAAC;IACd,MAAM,IAAI,IAAI,CAAC;IACf,SAAS,CAAC,QAAQ,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACzD,SAAS,CAAC,QAAQ,EAAE,aAAa,GAAG,MAAM,CAAC;IAC3C,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;IAC/B,OAAO,IAAI,OAAO,CAAC;IACnB;;;;OAIG;IACH,SAAS,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC;IACjC;;;;;OAKG;IACH,aAAa,CAAC,MAAM,EAAE,mBAAmB,GAAG,MAAM,IAAI,CAAC;IACvD,OAAO,IAAI,IAAI,CAAC;CACjB"}

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

@@ -0,0 +1,8 @@
+/**
+ * Subpath entry for `rn-gamekit/audio`.
+ * Importing `rn-gamekit` or `rn-gamekit/react` must not load this module.
+ */
+export { createGameAudio } from './audio/createGameAudio.js';
+export { GameAudioError } from './audio/errors.js';
+export type { AudioCategory, AudioSoundRecord, CreateGameAudioOptions, GameAudio, GameAudioPlayOptions, } from './audio/types.js';
+//# sourceMappingURL=audio.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"audio.d.ts","sourceRoot":"","sources":["../../../src/audio.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,4BAAyB,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAgB,CAAC;AAChD,YAAY,EACV,aAAa,EACb,gBAAgB,EAChB,sBAAsB,EACtB,SAAS,EACT,oBAAoB,GACrB,MAAM,kBAAe,CAAC"}

package/lib/typescript/src/camera2d/bounds.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Camera2D world-bounds clamping (T12.2).
+ *
+ * Keeps the visible camera region inside an authored world bound at the
+ * current zoom, using conservative enclosing-AABB containment for rotated
+ * views (frozen in T12.0): stable near boundaries, never jittering, and
+ * centering axes where the world is smaller than the view.
+ */
+import type { Aabb2D } from '../geometry/types.js';
+import type { Camera2D } from './types.js';
+/** Half-extents of the rotated visible rect, in world units. */
+export declare function cameraHalfExtents2D(camera: Camera2D, logicalView: Aabb2D): {
+    x: number;
+    y: number;
+};
+/**
+ * Clamp a camera so its visible region stays inside `worldBounds`.
+ *
+ * Conservative for rotated views: the enclosing AABB of the rotated
+ * visible rect is contained, so no part of the view leaves the world. An
+ * axis whose world is smaller than the view is centered rather than
+ * oscillating between impossible edges.
+ */
+export declare function clampCameraBounds2D(camera: Camera2D, worldBounds: Aabb2D, logicalView: Aabb2D): Camera2D;
+//# sourceMappingURL=bounds.d.ts.map

package/lib/typescript/src/camera2d/bounds.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bounds.d.ts","sourceRoot":"","sources":["../../../../src/camera2d/bounds.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAmB,CAAC;AAEhD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAS,CAAC;AAIxC,gEAAgE;AAChE,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAEnG;AAWD;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,QAAQ,EAChB,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,GAClB,QAAQ,CA4BV"}

package/lib/typescript/src/camera2d/extents.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Shared rotated half-extent arithmetic (GS-CAMERA-03).
+ *
+ * The conservative enclosing half-extents of a rotated visible rect:
+ * `ex = |hx·cosθ| + |hy·sinθ|`, `ey = |hx·sinθ| + |hy·cosθ|`.
+ *
+ * Trusted scalars only: no validation, no errors, worklet-safe. Callers
+ * validate at their own boundary (headless paths with the camera
+ * validators) or consume already-validated values (UI paths that must
+ * never construct errors per frame). Padding, parallax, and centering
+ * stay per-system and explicit.
+ */
+export declare function rotatedHalfExtents2D(halfWidth: number, halfHeight: number, rotationRadians: number): {
+    readonly x: number;
+    readonly y: number;
+};
+//# sourceMappingURL=extents.d.ts.map

package/lib/typescript/src/camera2d/extents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extents.d.ts","sourceRoot":"","sources":["../../../../src/camera2d/extents.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,eAAe,EAAE,MAAM,GACtB;IAAE,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAQ5C"}

package/lib/typescript/src/camera2d/follow.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Camera2D follow behavior (T12.2).
+ *
+ * Deterministic, headless follow helpers for game update code. They never
+ * read a React ref, device clock, frame callback, or global singleton;
+ * games call them inside the scene update and store the returned camera in
+ * scene state.
+ */
+import type { Point2D } from '../geometry/types.js';
+import type { Camera2D, FollowCamera2DOptions2D } from './types.js';
+/**
+ * Compute the next camera for a follow target.
+ *
+ * - Without options: direct follow — the camera center becomes the target.
+ * - With a dead zone: the camera moves only when the target crosses the
+ *   zone edge, by exactly the amount needed to bring the target back to
+ *   the edge.
+ * - `perAxis` disables following on either axis.
+ * - `dampingHalfLifeSeconds` blends toward the desired center with a
+ *   half-life model; equivalent fixed-step schedules produce equivalent
+ *   results.
+ */
+export declare function followCamera2D(camera: Camera2D, target: Point2D, options?: FollowCamera2DOptions2D, deltaSeconds?: number): Camera2D;
+//# sourceMappingURL=follow.d.ts.map

package/lib/typescript/src/camera2d/follow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"follow.d.ts","sourceRoot":"","sources":["../../../../src/camera2d/follow.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAU,OAAO,EAAE,MAAM,sBAAmB,CAAC;AAEzD,OAAO,KAAK,EAAE,QAAQ,EAAE,uBAAuB,EAAE,MAAM,YAAS,CAAC;AAuCjE;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,QAAQ,EAChB,MAAM,EAAE,OAAO,EACf,OAAO,CAAC,EAAE,uBAAuB,EACjC,YAAY,CAAC,EAAE,MAAM,GACpB,QAAQ,CAkGV"}

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

@@ -0,0 +1,19 @@
+/**
+ * Camera2D — the opt-in 2D camera system (Task 12).
+ *
+ * Pure, headless, native-free camera math shared by rendering and pointer
+ * input: immutable camera values, forward and inverse transforms, follow,
+ * bounds clamping, deterministic shake, presentation interpolation, and
+ * conservative visibility culling. The React integration
+ * (`defineGameCamera2D`, `GameView`, `GameWorld2D`, `GameLayer2D`) lives in
+ * `src/react/`.
+ */
+export { createCamera2D, getCameraVisibleBounds2D, logicalToWorld2D, worldToLogical2D, worldToSurface2D, surfaceToWorld2D } from './transform.js';
+export { interpolateCamera2D, interpolateCameraScalar2D, shortestRotationDelta2D } from './interpolation.js';
+export { followCamera2D } from './follow.js';
+export { clampCameraBounds2D, cameraHalfExtents2D } from './bounds.js';
+export { rotatedHalfExtents2D } from './extents.js';
+export { sampleCameraShake2D } from './shake.js';
+export { filterCameraVisible2D, intersectsCameraView2D, paddedCameraBounds2D, type CameraViewShape2D, } from './visibility.js';
+export type { Camera2D, CameraCut2D, CameraFollowAxisOptions2D, CameraShakeOptions2D, FollowCamera2DOptions2D, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/camera2d/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,cAAc,EAAE,wBAAwB,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,gBAAa,CAAC;AAC/I,OAAO,EAAE,mBAAmB,EAAE,yBAAyB,EAAE,uBAAuB,EAAE,MAAM,oBAAiB,CAAC;AAC1G,OAAO,EAAE,cAAc,EAAE,MAAM,aAAU,CAAC;AAC1C,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,aAAU,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAW,CAAC;AACjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAS,CAAC;AAC9C,OAAO,EACL,qBAAqB,EACrB,sBAAsB,EACtB,oBAAoB,EACpB,KAAK,iBAAiB,GACvB,MAAM,iBAAc,CAAC;AACtB,YAAY,EACV,QAAQ,EACR,WAAW,EACX,yBAAyB,EACzB,oBAAoB,EACpB,uBAAuB,GACxB,MAAM,YAAS,CAAC"}

package/lib/typescript/src/camera2d/interpolation.d.ts

@@ -0,0 +1,17 @@
+import type { Camera2D, CameraCut2D } from './types.js';
+/**
+ * Trusted scalar projector (worklet-safe): interpolates center and zoom
+ * linearly and rotation across the shortest angular arc. A changed `cutId`
+ * (or an absent previous cut) snaps to the current camera. No validation,
+ * no allocation of structured errors.
+ */
+export declare function interpolateCameraScalar2D(previous: CameraCut2D | undefined, current: CameraCut2D, alpha: number): Camera2D;
+/** The shortest signed angular difference from `from` to `to`. */
+export declare function shortestRotationDelta2D(from: number, to: number): number;
+/**
+ * Public interpolated camera: validates every input, clamps the alpha
+ * policy (reject outside `[0, 1]`), and returns a frozen value. Delegates
+ * to the trusted scalar projector.
+ */
+export declare function interpolateCamera2D(previous: CameraCut2D | undefined, current: CameraCut2D, alpha: number): Camera2D;
+//# sourceMappingURL=interpolation.d.ts.map

package/lib/typescript/src/camera2d/interpolation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interpolation.d.ts","sourceRoot":"","sources":["../../../../src/camera2d/interpolation.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,YAAS,CAAC;AA4BrD;;;;;GAKG;AACH,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,WAAW,GAAG,SAAS,EACjC,OAAO,EAAE,WAAW,EACpB,KAAK,EAAE,MAAM,GACZ,QAAQ,CAqBV;AAED,kEAAkE;AAClE,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAQxE;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,WAAW,GAAG,SAAS,EACjC,OAAO,EAAE,WAAW,EACpB,KAAK,EAAE,MAAM,GACZ,QAAQ,CAmBV"}

package/lib/typescript/src/camera2d/shake.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Camera2D deterministic shake (T12.2).
+ *
+ * Shake is reproducible from explicit state: a seed, elapsed simulation
+ * time, duration, and amplitude. No `Math.random()` anywhere. The sampler
+ * returns the unmodified base camera at and after the duration, and never
+ * mutates its input. Presentation applies the offset to the presented
+ * camera, so pointer inversion (which uses the same presented camera)
+ * keeps visible targets touchable.
+ */
+import type { Camera2D, CameraShakeOptions2D } from './types.js';
+/**
+ * Sample the presented camera offset for a shake.
+ *
+ * The offset decays linearly to zero over `durationSeconds`; at and after
+ * the duration the base camera is returned unchanged. Equal options
+ * produce equal results.
+ */
+export declare function sampleCameraShake2D(base: Camera2D, options: CameraShakeOptions2D): Camera2D;
+//# sourceMappingURL=shake.d.ts.map

package/lib/typescript/src/camera2d/shake.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shake.d.ts","sourceRoot":"","sources":["../../../../src/camera2d/shake.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,oBAAoB,EAAE,MAAM,YAAS,CAAC;AA0C9D;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,QAAQ,EACd,OAAO,EAAE,oBAAoB,GAC5B,QAAQ,CA2BV"}

package/lib/typescript/src/camera2d/transform.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Camera2D transforms (T12.1).
+ *
+ * The frozen transform model (T12.0):
+ *
+ *     world point -> camera transform -> logical view point -> viewport -> surface
+ *     logical = L + rotate(P - C, -R) * Z
+ *     world   = C + rotate((logical - L) / Z, R)
+ *
+ * where C is the camera center, Z the zoom, R the rotation, and L the
+ * center of the authored logical view rect. Rotation follows the Skia
+ * convention (positive radians in the y-down screen plane); zoom is
+ * uniform and greater than zero. The convenience surface functions derive
+ * the logical view from the resolved viewport's visible bounds, so
+ * rendering and pointer input share one composition.
+ */
+import type { Aabb2D, Point2D } from '../geometry/types.js';
+import type { ResolvedViewport2D } from '../viewport2d/types.js';
+import type { Camera2D } from './types.js';
+/** Rotate a point by an angle (Skia y-down convention). */
+export declare function rotatePoint2D(point: Point2D, radians: number): Point2D;
+/** The center of the camera's authored logical view. */
+export declare function logicalViewCenter2D(logicalView: Aabb2D): Point2D;
+/**
+ * Create a camera from optional partial values; missing fields default to
+ * the identity camera (`center` origin, `zoom` 1, no rotation).
+ */
+export declare function createCamera2D(value?: Partial<Camera2D>): Camera2D;
+/** World -> logical view: `L + rotate(P - C, -R) * Z`. */
+export declare function worldToLogical2D(point: Point2D, camera: Camera2D, logicalView: Aabb2D): Point2D;
+/** Logical view -> world: `C + rotate((logical - L) / Z, R)`. */
+export declare function logicalToWorld2D(point: Point2D, camera: Camera2D, logicalView: Aabb2D): Point2D;
+/** The conservative world-space AABB visible through the camera. */
+export declare function getCameraVisibleBounds2D(camera: Camera2D, logicalView: Aabb2D): Aabb2D;
+/**
+ * World -> surface through the camera and the resolved viewport.
+ *
+ * The camera's logical view is the viewport's visible logical bounds, so
+ * this composes exactly the transform the renderer draws with.
+ */
+export declare function worldToSurface2D(point: Point2D, viewport: ResolvedViewport2D, camera: Camera2D): Point2D;
+/** Surface -> world through the viewport and the presented camera. */
+export declare function surfaceToWorld2D(point: Point2D, viewport: ResolvedViewport2D, camera: Camera2D): Point2D;
+//# sourceMappingURL=transform.d.ts.map

package/lib/typescript/src/camera2d/transform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transform.d.ts","sourceRoot":"","sources":["../../../../src/camera2d/transform.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,sBAAmB,CAAC;AAEzD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAqB,CAAC;AAE9D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAS,CAAC;AAIxC,2DAA2D;AAC3D,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAOtE;AAED,wDAAwD;AACxD,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAKhE;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,GAAG,QAAQ,CAmBlE;AAED,0DAA0D;AAC1D,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAe/F;AAED,iEAAiE;AACjE,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAe/F;AAED,oEAAoE;AACpE,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CActF;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,kBAAkB,EAC5B,MAAM,EAAE,QAAQ,GACf,OAAO,CAKT;AAED,sEAAsE;AACtE,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,kBAAkB,EAC5B,MAAM,EAAE,QAAQ,GACf,OAAO,CAKT"}