rn-gamekit 0.1.0

package/lib/module/react/alphaClock.js

@@ -0,0 +1,42 @@
+"use strict";
+
+/**
+ * UI-owned alpha clock (T5).
+ *
+ * Pure, worklet-safe presentation clock: `alpha` advances from UI frame
+ * deltas against the simulation step duration and resets to zero whenever a
+ * newer commit arrives. It never extrapolates past the current snapshot
+ * (clamped at 1, then held) and ignores stale or duplicate commits so a
+ * delayed write cannot reset presentation backward.
+ *
+ * The `epoch` guards session replacement: a new GameView binding carries a
+ * fresh epoch, so a replacement session whose revision restarts at zero is
+ * still accepted, while a delayed write from an old epoch is ignored.
+ */
+
+/** Advance the clock by one UI frame; returns the next alpha state. */
+export function advanceAlpha(previous, commit, frameDeltaMs) {
+  'worklet';
+
+  if (commit.epoch > previous.epoch || commit.epoch === previous.epoch && commit.revision > previous.revision) {
+    return {
+      epoch: commit.epoch,
+      revision: commit.revision,
+      alpha: 0
+    };
+  }
+  if (commit.epoch < previous.epoch || commit.epoch === previous.epoch && commit.revision < previous.revision) {
+    return previous; // A stale write is ignored entirely, alpha preserved.
+  }
+  if (previous.alpha >= 1) {
+    return previous; // Clamp at 1: hold, never extrapolate.
+  }
+  const delta = Math.max(0, frameDeltaMs) / commit.stepMs;
+  const next = previous.alpha + delta;
+  return {
+    epoch: previous.epoch,
+    revision: previous.revision,
+    alpha: next >= 1 ? 1 : next
+  };
+}
+//# sourceMappingURL=alphaClock.js.map

package/lib/module/react/alphaClock.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["advanceAlpha","previous","commit","frameDeltaMs","epoch","revision","alpha","delta","Math","max","stepMs","next"],"sourceRoot":"../../../src","sources":["react/alphaClock.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAiBA;AACA,OAAO,SAASA,YAAYA,CAC1BC,QAAyB,EACzBC,MAAwB,EACxBC,YAAoB,EACH;EACjB,SAAS;;EACT,IACED,MAAM,CAACE,KAAK,GAAGH,QAAQ,CAACG,KAAK,IAC5BF,MAAM,CAACE,KAAK,KAAKH,QAAQ,CAACG,KAAK,IAAIF,MAAM,CAACG,QAAQ,GAAGJ,QAAQ,CAACI,QAAS,EACxE;IACA,OAAO;MAAED,KAAK,EAAEF,MAAM,CAACE,KAAK;MAAEC,QAAQ,EAAEH,MAAM,CAACG,QAAQ;MAAEC,KAAK,EAAE;IAAE,CAAC;EACrE;EACA,IACEJ,MAAM,CAACE,KAAK,GAAGH,QAAQ,CAACG,KAAK,IAC5BF,MAAM,CAACE,KAAK,KAAKH,QAAQ,CAACG,KAAK,IAAIF,MAAM,CAACG,QAAQ,GAAGJ,QAAQ,CAACI,QAAS,EACxE;IACA,OAAOJ,QAAQ,CAAC,CAAC;EACnB;EACA,IAAIA,QAAQ,CAACK,KAAK,IAAI,CAAC,EAAE;IACvB,OAAOL,QAAQ,CAAC,CAAC;EACnB;EACA,MAAMM,KAAK,GAAGC,IAAI,CAACC,GAAG,CAAC,CAAC,EAAEN,YAAY,CAAC,GAAGD,MAAM,CAACQ,MAAM;EACvD,MAAMC,IAAI,GAAGV,QAAQ,CAACK,KAAK,GAAGC,KAAK;EACnC,OAAO;IACLH,KAAK,EAAEH,QAAQ,CAACG,KAAK;IACrBC,QAAQ,EAAEJ,QAAQ,CAACI,QAAQ;IAC3BC,KAAK,EAAEK,IAAI,IAAI,CAAC,GAAG,CAAC,GAAGA;EACzB,CAAC;AACH","ignoreList":[]}

package/lib/module/react/assets/createGameAssetStore.js

@@ -0,0 +1,358 @@
+"use strict";
+
+/**
+ * Asset store core (T7.4).
+ *
+ * The explicit owner of the decoded-image cache. Source resolution and
+ * image decoding are injected so the ownership logic is unit-testable with
+ * fakes and never imports native modules itself.
+ *
+ * Ownership rules:
+ * - An explicitly created store owns cache/native entries.
+ * - `acquire` resolves only with a complete usable lease.
+ * - Reference counts keep a shared source alive across leases; the native
+ *   handle is disposed exactly once when the final lease releases it.
+ * - A failed/abandoned attempt releases every handle it acquired; entries
+ *   still leased elsewhere are preserved.
+ * - Attempts carry an epoch token: stale completion after retry/unmount is
+ *   ignored and can never double-dispose.
+ * - `AbortSignal` detaches an imperative caller immediately; late results
+ *   from the underlying work are ignored.
+ * - Progress is monotonic and counts requested logical resources (a
+ *   deduplicated source still counts once per logical descriptor).
+ * - The store rejects acquisitions after disposal; disposal is idempotent.
+ */
+import { GameAssetError } from "../../assets/errors.js";
+import { validateFrameRect } from "../../assets/validation.js";
+import { GameAssetError as AssetStoreError } from "../../assets/errors.js";
+
+/** Opaque decoded-image handle (Skia's SkImage satisfies this structurally). */
+
+/** Injected source resolution and decode pipelines. */
+
+/** Acquisition options for `acquire`. */
+
+/** One idempotent ownership token: release() is safe to call repeatedly and
+ * disposes the native handle when it is the final reference (RF5). */
+
+/** One logical (group, asset) identity inside a manifest. */
+
+function logicalAssetsOf(manifest) {
+  const result = [];
+  for (const [group, assets] of Object.entries(manifest)) {
+    for (const [name, descriptor] of Object.entries(assets)) {
+      result.push({
+        key: `${group}/${name}`,
+        group,
+        name,
+        descriptor: descriptor
+      });
+    }
+  }
+  return result;
+}
+
+/** Validate a sprite sheet's frames against decoded dimensions. */
+function validateFrames(path, frames, width, height) {
+  for (const [name, rect] of Object.entries(frames)) {
+    validateFrameRect(path, name, rect);
+    if (rect.x + rect.width > width || rect.y + rect.height > height) {
+      throw new GameAssetError('ASSET_FRAME_OUT_OF_BOUNDS', [...path, name], `frame ${JSON.stringify(name)} (${rect.x},${rect.y} ${rect.width}x${rect.height}) exceeds the decoded image ${width}x${height}`);
+    }
+  }
+}
+export function createGameAssetStoreCore(manifest, pipelines) {
+  const groups = new Set(Object.keys(manifest));
+  const logical = logicalAssetsOf(manifest);
+  const byKey = new Map(logical.map(asset => [asset.key, asset]));
+  const resources = new Map();
+  let disposed = false;
+  let nextAttemptToken = 1;
+  /** Per-attempt ownership is explicit: the attempt object is passed through
+   * every resolve/decode/validate operation; no shared singleton (R4). */
+
+  function assertLive() {
+    if (disposed) {
+      throw new AssetStoreError('ASSET_STORE_DISPOSED', [], 'asset store is disposed');
+    }
+  }
+
+  /** Race a promise with the abort signal; the listener is removed on
+   * resolve, reject, and abort (RF5). */
+  function raceWithAbort(promise, signal) {
+    if (signal === undefined) {
+      return promise;
+    }
+    return new Promise((resolve, reject) => {
+      const onAbort = () => {
+        reject(new AssetStoreError('ASSET_ABORTED', [], 'asset acquisition aborted'));
+      };
+      signal.addEventListener('abort', onAbort, {
+        once: true
+      });
+      promise.then(value => {
+        signal.removeEventListener('abort', onAbort);
+        resolve(value);
+      }, error => {
+        signal.removeEventListener('abort', onAbort);
+        reject(error);
+      });
+    });
+  }
+
+  /** Drop one reference held by a caller that never recorded a logical key. */
+  function dropResourceRef(uri) {
+    const entry = resources.get(uri);
+    if (entry === undefined) {
+      return;
+    }
+    entry.refCount -= 1;
+    if (entry.refCount <= 0) {
+      if (entry.handle !== undefined) {
+        entry.handle.dispose();
+      }
+      resources.delete(uri);
+    }
+  }
+
+  /**
+   * Begin one owned reference to a resource. Every waiter — cache miss,
+   * in-flight share, or completed cache hit — goes through this single
+   * accounting path and receives an idempotent release closure (RF5). The
+   * caller must either commit the ref to the attempt or call release()
+   * exactly once; the final release disposes the native handle.
+   */
+  function beginResourceRef(uri) {
+    const existing = resources.get(uri);
+    let entry;
+    if (existing !== undefined && existing.handle !== undefined) {
+      // Completed cache hit.
+      entry = existing;
+      entry.refCount += 1;
+      const handle = existing.handle;
+      return {
+        release: () => dropResourceRef(uri),
+        ready: async () => handle
+      };
+    }
+    if (existing !== undefined && existing.inFlight !== undefined) {
+      // Shared in-flight decode.
+      entry = existing;
+      entry.refCount += 1;
+      const shared = existing.inFlight;
+      return {
+        release: () => dropResourceRef(uri),
+        ready: async () => shared
+      };
+    }
+    // Cache miss: this waiter starts the decode.
+    entry = {
+      uri,
+      handle: undefined,
+      inFlight: undefined,
+      logicalKeys: new Set(),
+      refCount: 1
+    };
+    resources.set(uri, entry);
+    const promise = (async () => {
+      const handle = await pipelines.decode(uri);
+      // A late completion must never resurrect a disposed store or an entry
+      // whose last waiter aborted while the decode was in flight.
+      if (disposed || entry.refCount <= 0) {
+        handle.dispose();
+        if (entry.refCount <= 0) {
+          resources.delete(uri);
+        }
+        throw new AssetStoreError('ASSET_ABORTED', [], 'asset acquisition aborted');
+      }
+      entry.handle = handle;
+      return handle;
+    })();
+    entry.inFlight = promise;
+    void promise.then(() => {
+      entry.inFlight = undefined;
+    }, () => {
+      entry.inFlight = undefined;
+    });
+    return {
+      release: () => dropResourceRef(uri),
+      ready: async () => promise
+    };
+  }
+  async function acquireOne(asset, attempt, signal) {
+    const uri = await raceWithAbort(pipelines.resolve(asset.descriptor.source), signal);
+    // RF5: the reference token exists before any cancellable await; abort
+    // can never leave a positive reference behind.
+    const ref = beginResourceRef(uri);
+    try {
+      const handle = await raceWithAbort(ref.ready(), signal);
+      attempt.acquired.push(ref);
+      const entry = resources.get(uri);
+      if (entry !== undefined) {
+        entry.logicalKeys.add(asset.key);
+      }
+      if (asset.descriptor.kind === 'sprite-sheet') {
+        validateFrames([asset.group, asset.name, 'frames'], asset.descriptor.frames, handle.width(), handle.height());
+      }
+    } catch (error) {
+      // Every failure, abort, and stale completion releases this waiter's
+      // reference exactly once; surviving owners keep theirs.
+      ref.release();
+      throw error;
+    }
+  }
+  const acquire = async options => {
+    assertLive();
+    const {
+      signal
+    } = options;
+    const throwIfAborted = () => {
+      if (signal?.aborted === true) {
+        throw new AssetStoreError('ASSET_ABORTED', [], 'asset acquisition aborted');
+      }
+    };
+    throwIfAborted();
+
+    // RF5: normalize groups at the public boundary (dedupe) and use the
+    // same list for the progress total and acquisition.
+    const groupsNormalized = [...new Set(options.groups)];
+    const requested = [];
+    for (const group of groupsNormalized) {
+      if (!groups.has(group)) {
+        throw new GameAssetError('ASSET_UNKNOWN_GROUP', [group], `unknown asset group ${JSON.stringify(group)}`);
+      }
+      for (const asset of logical) {
+        if (asset.group === group) {
+          requested.push(asset);
+        }
+      }
+    }
+    if (requested.length === 0) {
+      // Empty group set resolves immediately with progress 1 and no resources.
+      options.onProgress?.(1);
+      return createLease(new Map(), () => undefined);
+    }
+    const token = nextAttemptToken;
+    nextAttemptToken += 1;
+    const attempt = {
+      token,
+      acquired: []
+    };
+    const loaded = new Map();
+    try {
+      let completed = 0;
+      const total = requested.length;
+      for (const asset of requested) {
+        throwIfAborted();
+        await acquireOne(asset, attempt, signal);
+        loaded.set(asset.key, asset.key);
+        completed += 1;
+        options.onProgress?.(completed / total);
+      }
+      return createLease(loaded, () => {
+        for (const ref of attempt.acquired) {
+          ref.release();
+        }
+      });
+    } catch (error) {
+      // Release every reference this attempt acquired exactly once; entries
+      // still leased by a previous lease keep their references.
+      for (const ref of attempt.acquired) {
+        ref.release();
+      }
+      throw error;
+    }
+  };
+  function createLease(loadedKeys, onDispose) {
+    let leaseDisposed = false;
+    const loaded = new Map();
+    for (const key of loadedKeys.keys()) {
+      const asset = byKey.get(key);
+      if (asset !== undefined) {
+        loaded.set(key, asset);
+      }
+    }
+    const assets = {
+      manifest,
+      get: descriptor => {
+        assertLive();
+        if (leaseDisposed) {
+          throw new AssetStoreError('ASSET_STORE_DISPOSED', [], 'lease is disposed');
+        }
+        const entry = findLoadedFor(descriptor, loaded);
+        if (entry === undefined) {
+          // R9: v1 lookup is descriptor-reference membership — the exact
+          // descriptor object the manifest declared — not a nominal manifest
+          // identity. Identically shaped manifests share the structural type,
+          // so the type layer cannot distinguish them; the runtime reference
+          // check is the guarantee.
+          throw new GameAssetError('ASSET_UNKNOWN_ASSET', [], 'descriptor is not a reference declared by this manifest and group selection');
+        }
+        return entry;
+      }
+    };
+    return {
+      assets,
+      dispose: () => {
+        if (leaseDisposed) {
+          return;
+        }
+        leaseDisposed = true;
+        onDispose();
+      }
+    };
+  }
+  function findLoadedFor(descriptor, loaded) {
+    for (const asset of loaded.values()) {
+      if (asset.descriptor === descriptor) {
+        const entry = entryFor(asset.key);
+        const handle = entry?.handle;
+        const width = handle?.width() ?? 0;
+        const height = handle?.height() ?? 0;
+        if (asset.descriptor.kind === 'image') {
+          return {
+            descriptor: asset.descriptor,
+            width,
+            height,
+            image: handle
+          };
+        }
+        return {
+          descriptor: asset.descriptor,
+          frames: asset.descriptor.frames,
+          width,
+          height,
+          image: handle
+        };
+      }
+    }
+    return undefined;
+  }
+  function entryFor(logicalKey) {
+    for (const entry of resources.values()) {
+      if (entry.logicalKeys.has(logicalKey)) {
+        return entry;
+      }
+    }
+    return undefined;
+  }
+  return {
+    acquire,
+    dispose: () => {
+      if (disposed) {
+        return;
+      }
+      disposed = true;
+      // Drop entries with no live lease; leased entries stay until their
+      // lease releases them (their refCount keeps them alive).
+      for (const [uri, entry] of resources) {
+        if (entry.refCount <= 0 && entry.handle !== undefined) {
+          entry.handle.dispose();
+          resources.delete(uri);
+        }
+      }
+    },
+    isDisposed: () => disposed
+  };
+}
+//# sourceMappingURL=createGameAssetStore.js.map

package/lib/module/react/assets/createGameAssetStore.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["GameAssetError","validateFrameRect","AssetStoreError","logicalAssetsOf","manifest","result","group","assets","Object","entries","name","descriptor","push","key","validateFrames","path","frames","width","height","rect","x","y","JSON","stringify","createGameAssetStoreCore","pipelines","groups","Set","keys","logical","byKey","Map","map","asset","resources","disposed","nextAttemptToken","assertLive","raceWithAbort","promise","signal","undefined","Promise","resolve","reject","onAbort","addEventListener","once","then","value","removeEventListener","error","dropResourceRef","uri","entry","get","refCount","handle","dispose","delete","beginResourceRef","existing","release","ready","inFlight","shared","logicalKeys","set","decode","acquireOne","attempt","source","ref","acquired","add","kind","acquire","options","throwIfAborted","aborted","groupsNormalized","requested","has","length","onProgress","createLease","token","loaded","completed","total","loadedKeys","onDispose","leaseDisposed","findLoadedFor","values","entryFor","image","logicalKey","isDisposed"],"sourceRoot":"../../../../src","sources":["react/assets/createGameAssetStore.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/react/assets/decodeSkiaImage.js

@@ -0,0 +1,54 @@
+"use strict";
+
+/**
+ * Default Expo/Skia asset pipelines (T7.4).
+ *
+ * Exact primitives used (verified against the installed types, Skia 2.11.0
+ * and expo-asset SDK 57):
+ * - `Asset.fromModule(source)` -> `await asset.downloadAsync()` ->
+ *   `asset.localUri ?? asset.uri` (canonical local URI; static module
+ *   handles only);
+ * - `Skia.Data.fromURI(uri)` -> `SkData` (disposed as soon as the image is
+ *   created — `SkImage.MakeImageFromEncoded` copies the encoded bytes);
+ * - `Skia.Image.MakeImageFromEncoded(data)` -> `SkImage | null` (null is a
+ *   structured load failure, never a ready resource).
+ */
+import { Asset } from 'expo-asset';
+import { Skia } from '@shopify/react-native-skia';
+import { GameAssetError } from "../../assets/errors.js";
+import { createGameAssetStoreCore } from "./createGameAssetStore.js";
+const resolvePipeline = async source => {
+  const asset = Asset.fromModule(source);
+  try {
+    await asset.downloadAsync();
+  } catch (error) {
+    throw new GameAssetError('ASSET_RESOLVE_FAILED', [], `failed to resolve static asset module ${source}: ${error instanceof Error ? error.message : String(error)}`);
+  }
+  return asset.localUri ?? asset.uri;
+};
+const decodePipeline = async uri => {
+  const data = await Skia.Data.fromURI(uri);
+  try {
+    const image = Skia.Image.MakeImageFromEncoded(data);
+    if (image === null) {
+      throw new GameAssetError('ASSET_DECODE_FAILED', [], `decoding ${uri} produced no image`);
+    }
+    return image;
+  } finally {
+    data.dispose();
+  }
+};
+
+/**
+ * Create the explicit asset-store owner for a manifest using the default
+ * Expo/Skia pipelines. Callers dispose the lease then the store in
+ * `finally`.
+ */
+export function createGameAssetStore(manifest) {
+  // The return type keeps the manifest generic so leases stay typed.
+  return createGameAssetStoreCore(manifest, {
+    resolve: resolvePipeline,
+    decode: decodePipeline
+  });
+}
+//# sourceMappingURL=decodeSkiaImage.js.map

package/lib/module/react/assets/decodeSkiaImage.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["Asset","Skia","GameAssetError","createGameAssetStoreCore","resolvePipeline","source","asset","fromModule","downloadAsync","error","Error","message","String","localUri","uri","decodePipeline","data","Data","fromURI","image","Image","MakeImageFromEncoded","dispose","createGameAssetStore","manifest","resolve","decode"],"sourceRoot":"../../../../src","sources":["react/assets/decodeSkiaImage.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,SAASA,KAAK,QAAQ,YAAY;AAClC,SAASC,IAAI,QAAQ,4BAA4B;AAEjD,SAASC,cAAc,QAAQ,wBAAqB;AAEpD,SACEC,wBAAwB,QAEnB,2BAAwB;AAE/B,MAAMC,eAAe,GAAG,MAAOC,MAAc,IAAsB;EACjE,MAAMC,KAAK,GAAGN,KAAK,CAACO,UAAU,CAACF,MAAM,CAAC;EACtC,IAAI;IACF,MAAMC,KAAK,CAACE,aAAa,CAAC,CAAC;EAC7B,CAAC,CAAC,OAAOC,KAAK,EAAE;IACd,MAAM,IAAIP,cAAc,CACtB,sBAAsB,EACtB,EAAE,EACF,yCAAyCG,MAAM,KAAKI,KAAK,YAAYC,KAAK,GAAGD,KAAK,CAACE,OAAO,GAAGC,MAAM,CAACH,KAAK,CAAC,EAC5G,CAAC;EACH;EACA,OAAOH,KAAK,CAACO,QAAQ,IAAIP,KAAK,CAACQ,GAAG;AACpC,CAAC;AAED,MAAMC,cAAc,GAAG,MAAOD,GAAW,IAAiC;EACxE,MAAME,IAAI,GAAG,MAAMf,IAAI,CAACgB,IAAI,CAACC,OAAO,CAACJ,GAAG,CAAC;EACzC,IAAI;IACF,MAAMK,KAAK,GAAGlB,IAAI,CAACmB,KAAK,CAACC,oBAAoB,CAACL,IAAI,CAAC;IACnD,IAAIG,KAAK,KAAK,IAAI,EAAE;MAClB,MAAM,IAAIjB,cAAc,CAAC,qBAAqB,EAAE,EAAE,EAAE,YAAYY,GAAG,oBAAoB,CAAC;IAC1F;IACA,OAAOK,KAAK;EACd,CAAC,SAAS;IACRH,IAAI,CAACM,OAAO,CAAC,CAAC;EAChB;AACF,CAAC;;AAED;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,oBAAoBA,CAClCC,QAAmB,EACnB;EACA;EACA,OAAOrB,wBAAwB,CAACqB,QAAQ,EAAE;IACxCC,OAAO,EAAErB,eAAe;IACxBsB,MAAM,EAAEX;EACV,CAAC,CAAC;AACJ","ignoreList":[]}

package/lib/module/react/assets/errors.js

@@ -0,0 +1,10 @@
+"use strict";
+
+/**
+ * Asset store errors (T7.4).
+ *
+ * The store adds no error codes of its own: every failure is a structured
+ * `GameAssetError` with a stable code and field path.
+ */
+export { GameAssetError } from "../../assets/errors.js";
+//# sourceMappingURL=errors.js.map

package/lib/module/react/assets/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["GameAssetError"],"sourceRoot":"../../../../src","sources":["react/assets/errors.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA,SAASA,cAAc,QAAQ,wBAAqB","ignoreList":[]}

package/lib/module/react/assets/useGameAssets.js

@@ -0,0 +1,160 @@
+"use strict";
+
+/**
+ * `useGameAssets` — the React loading adapter (T7.5).
+ *
+ * The hook creates and owns one asset store and lease for the requested
+ * groups; the caller must not dispose the returned ready value manually.
+ *
+ * Contract:
+ * - `{ status: 'loading'; progress }` — progress in [0, 1], monotonic;
+ * - `{ status: 'error'; error; retry }` — structured error + stable retry;
+ * - `{ status: 'ready'; assets }` — the complete lease, typed to the
+ *   manifest.
+ *
+ * Lifecycle:
+ * - The requested group list is normalized (sorted) so a recreated
+ *   equivalent array does not reload.
+ * - Retry starts a new attempt; late completion from an older attempt can
+ *   never replace the new state.
+ * - Unmount invalidates the attempt, releases the lease, and disposes the
+ *   store — hook-owned resources are released exactly once.
+ */
+import { useCallback, useEffect, useRef, useState } from 'react';
+import { GameAssetError } from "../../assets/errors.js";
+
+/** The store surface the hook needs, kept generic over the manifest. */
+
+/**
+ * Default store factory using the Expo/Skia pipelines. The wiring module is
+ * required lazily so the hook's import graph stays headless (tests inject
+ * their own factory and never touch the native side).
+ */
+function defaultStoreFactory(manifest) {
+  // eslint-disable-next-line @typescript-eslint/no-require-imports
+  const {
+    createGameAssetStore
+  } = require('./decodeSkiaImage');
+  return createGameAssetStore(manifest);
+}
+
+/** The discriminated loading state machine. Every state carries the
+ * normalized request key (RF7) so a rendered request that differs from the
+ * state's request can never expose a stale lease. */
+
+/** Deduplicate and sort groups so equivalent reordered/duplicated arrays
+ * map to one key and one acquisition (R6). */
+export function dedupeGroups(groups) {
+  return [...new Set(groups)].sort();
+}
+
+/** Order-independent group key: equivalent arrays map to one key. */
+export function stableGroupsKey(groups) {
+  return dedupeGroups(groups).join('\u0000');
+}
+export function useGameAssets(manifest, options, storeFactory) {
+  const groupsKey = stableGroupsKey(options.groups);
+  const [attempt, setAttempt] = useState(0);
+  const [state, setState] = useState({
+    status: 'loading',
+    progress: 0,
+    retry: () => undefined,
+    requestKey: groupsKey
+  });
+  const storeRef = useRef(undefined);
+  const leaseRef = useRef(undefined);
+  const retry = useCallback(() => {
+    // R6: one user action starts exactly one new attempt; the same function
+    // identity is exposed in loading and error states.
+    setAttempt(current => current + 1);
+  }, []);
+
+  // Ref mirror of the attempt so stale-effect completions are rejected
+  // after a retry re-renders with a higher attempt.
+  const attemptRef = useRef(attempt);
+  attemptRef.current = attempt;
+
+  // RF7: if the rendered request differs from the state's request, expose
+  // loading synchronously instead of the previous ready lease — the old
+  // lease is disposed by the effect cleanup, so no consumer can observe it
+  // under the new request.
+  if (state.requestKey !== groupsKey && state.status === 'ready') {
+    return {
+      status: 'loading',
+      progress: 0,
+      retry,
+      requestKey: groupsKey
+    };
+  }
+  useEffect(() => {
+    const store = (storeFactory ?? defaultStoreFactory)(manifest);
+    storeRef.current = store;
+    let disposed = false;
+    const attemptAtStart = attempt;
+    const isCurrent = () => attemptRef.current === attemptAtStart;
+    const setIfCurrent = updater => {
+      if (!disposed && isCurrent()) {
+        setState(updater);
+      }
+    };
+
+    // R6: every attempt owns an AbortController; aborting detaches the
+    // caller and rejects late progress/ready/error from older configs.
+    const controller = new AbortController();
+    setState({
+      status: 'loading',
+      progress: 0,
+      retry: retry,
+      requestKey: groupsKey
+    });
+    store.acquire({
+      groups: dedupeGroups(options.groups),
+      signal: controller.signal,
+      onProgress: progress => {
+        setIfCurrent(previous => previous.status === 'loading' ? {
+          ...previous,
+          progress
+        } : previous);
+      }
+    }).then(lease => {
+      if (disposed || !isCurrent()) {
+        // Stale completion (retry/unmount): release immediately.
+        lease.dispose();
+        return;
+      }
+      leaseRef.current?.dispose();
+      leaseRef.current = lease;
+      setState({
+        status: 'ready',
+        assets: lease.assets,
+        requestKey: groupsKey
+      });
+    }).catch(error => {
+      if (disposed || !isCurrent()) {
+        return;
+      }
+      const structured = error instanceof GameAssetError ? error : new GameAssetError('ASSET_DECODE_FAILED', [], error instanceof Error ? error.message : String(error));
+      setState({
+        status: 'error',
+        error: structured,
+        retry,
+        requestKey: groupsKey
+      });
+    });
+    return () => {
+      disposed = true;
+      // R6: abort before releasing so no late completion can touch state or
+      // resources, then release the lease and store exactly once.
+      controller.abort();
+      leaseRef.current?.dispose();
+      leaseRef.current = undefined;
+      storeRef.current = undefined;
+      store.dispose();
+    };
+    // The groups key is order-independent, so a recreated equivalent array
+    // does not reload; the attempt state drives retries. The store factory
+    // is the internal test seam and must be stable across renders.
+  }, [attempt, groupsKey, manifest, storeFactory]);
+  return state;
+}
+//# sourceMappingURL=useGameAssets.js.map

package/lib/module/react/assets/useGameAssets.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["useCallback","useEffect","useRef","useState","GameAssetError","defaultStoreFactory","manifest","createGameAssetStore","require","dedupeGroups","groups","Set","sort","stableGroupsKey","join","useGameAssets","options","storeFactory","groupsKey","attempt","setAttempt","state","setState","status","progress","retry","undefined","requestKey","storeRef","leaseRef","current","attemptRef","store","disposed","attemptAtStart","isCurrent","setIfCurrent","updater","controller","AbortController","acquire","signal","onProgress","previous","then","lease","dispose","assets","catch","error","structured","Error","message","String","abort"],"sourceRoot":"../../../../src","sources":["react/assets/useGameAssets.ts"],"mappings":"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","ignoreList":[]}