@aura3d/engine 3.0.0 → 4.0.0

package/dist/game/art/snapshot.d.ts

@@ -0,0 +1,63 @@
+/**
+ * C-35 — ArtDirectionSnapshot and `snapshotForAudit`.
+ *
+ * Builds the audit snapshot from the authored scene (`AuraSceneSnapshot`), the
+ * asset manifest, and `diagnostics().drawCalls`. It reads authored intent and
+ * measured draw counts only, never stub-reported GPU features, so it works on
+ * PR 0a stubs.
+ */
+import type { AuraApp } from "../../engine/index.js";
+/** One material observed on a mounted node (additive to the C-35 snapshot
+ * shape: `emissive-fill` cannot be judged without it). `practical` /
+ * `lightSource` mark materials the art direction counts as light sources. */
+export interface ArtDirectionSnapshotMaterial {
+    readonly name?: string;
+    readonly node?: string;
+    readonly emissiveIntensity?: number;
+    readonly practical?: boolean;
+    readonly lightSource?: boolean;
+}
+export interface ArtDirectionSnapshot {
+    readonly lights: readonly {
+        readonly type: string;
+        readonly shadow: boolean;
+        readonly intensity: number;
+    }[];
+    readonly hasAmbient: boolean;
+    readonly environment: {
+        readonly kind: "none" | "hdri" | "preset" | "procedural";
+        readonly background: boolean;
+    };
+    readonly models: readonly {
+        readonly assetKey: string;
+        readonly triangles: number;
+        readonly textures: number;
+        readonly unlit: boolean;
+        readonly overridesTextures: boolean;
+    }[];
+    readonly materials?: readonly ArtDirectionSnapshotMaterial[];
+    readonly drawCalls: number;
+}
+export interface AuraAssetManifestEntryLike {
+    readonly triangles?: number;
+    readonly textures?: number;
+    readonly unlit?: boolean;
+    readonly role?: string;
+    /** Additive (beyond the C-35 record shape): set when the route re-tags a
+     *  model's textures at mount time — audits as `asset-texture-override`. */
+    readonly overridesTextures?: boolean;
+}
+/** C-35 manifest record shape: asset key → metadata. */
+export interface AuraAssetManifestLike {
+    readonly assets: Readonly<Record<string, AuraAssetManifestEntryLike>>;
+}
+/**
+ * Converts the real `aura.assets.json` (whose `assets` is an array of entries
+ * keyed by `id`) into the C-35 record shape `snapshotForAudit` consumes.
+ * `textures` arrays are counted; `unlit` is taken from the entry or any of its
+ * `materialMetadata` rows.
+ */
+export declare function assetManifestLike(manifest: unknown): AuraAssetManifestLike;
+/** Builds the audit snapshot for a mounted (or authored, pre-mount) app. */
+export declare function snapshotForAudit(app: AuraApp, assets: AuraAssetManifestLike): ArtDirectionSnapshot;
+//# sourceMappingURL=snapshot.d.ts.map

package/dist/game/art/snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../../../../../packages/game/src/art/snapshot.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAiB,MAAM,wBAAwB,CAAC;AAErE;;6EAE6E;AAC7E,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;CAChC;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,MAAM,EAAE,SAAS;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC5G,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,YAAY,CAAC;QAAC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAA;KAAE,CAAC;IACjH,QAAQ,CAAC,MAAM,EAAE,SAAS;QACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;QAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAC1B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;QACxB,QAAQ,CAAC,iBAAiB,EAAE,OAAO,CAAC;KACrC,EAAE,CAAC;IACJ,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,4BAA4B,EAAE,CAAC;IAC7D,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB;+EAC2E;IAC3E,QAAQ,CAAC,iBAAiB,CAAC,EAAE,OAAO,CAAC;CACtC;AAED,wDAAwD;AACxD,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,0BAA0B,CAAC,CAAC,CAAC;CACvE;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,OAAO,GAAG,qBAAqB,CA4B1E;AASD,4EAA4E;AAC5E,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,qBAAqB,GAAG,oBAAoB,CAiElG"}

package/dist/game/art/snapshot.js

@@ -0,0 +1,115 @@
+/**
+ * C-35 — ArtDirectionSnapshot and `snapshotForAudit`.
+ *
+ * Builds the audit snapshot from the authored scene (`AuraSceneSnapshot`), the
+ * asset manifest, and `diagnostics().drawCalls`. It reads authored intent and
+ * measured draw counts only, never stub-reported GPU features, so it works on
+ * PR 0a stubs.
+ */
+/**
+ * Converts the real `aura.assets.json` (whose `assets` is an array of entries
+ * keyed by `id`) into the C-35 record shape `snapshotForAudit` consumes.
+ * `textures` arrays are counted; `unlit` is taken from the entry or any of its
+ * `materialMetadata` rows.
+ */
+export function assetManifestLike(manifest) {
+    const out = {};
+    const assets = manifest?.assets;
+    const assign = (id, entry) => {
+        const materialMetadata = Array.isArray(entry.materialMetadata) ? entry.materialMetadata : [];
+        const unlitInMaterials = materialMetadata.some((m) => typeof m === "object" && m !== null && m.unlit === true);
+        out[id] = {
+            triangles: typeof entry.triangles === "number" ? entry.triangles : undefined,
+            textures: Array.isArray(entry.textures) ? entry.textures.length : (typeof entry.textures === "number" ? entry.textures : undefined),
+            unlit: typeof entry.unlit === "boolean" ? entry.unlit : unlitInMaterials || undefined,
+            role: typeof entry.role === "string" ? entry.role : undefined,
+            overridesTextures: entry.overridesTextures === true
+        };
+    };
+    if (Array.isArray(assets)) {
+        for (const entry of assets) {
+            if (typeof entry === "object" && entry !== null && typeof entry.id === "string") {
+                assign(entry.id, entry);
+            }
+        }
+    }
+    else if (typeof assets === "object" && assets !== null) {
+        for (const [id, entry] of Object.entries(assets)) {
+            if (typeof entry === "object" && entry !== null)
+                assign(id, entry);
+        }
+    }
+    return { assets: out };
+}
+function walk(nodes, visit) {
+    for (const node of nodes) {
+        visit(node);
+        if (node.kind === "group")
+            walk(node.children, visit);
+    }
+}
+/** Builds the audit snapshot for a mounted (or authored, pre-mount) app. */
+export function snapshotForAudit(app, assets) {
+    const manifest = assetManifestLike(assets).assets;
+    const lights = [];
+    const models = [];
+    const materials = [];
+    let environment = { kind: "none", background: false };
+    walk(app.scene.nodes, (node) => {
+        if (node.kind === "light") {
+            lights.push({ type: node.light, shadow: node.shadow === true || (typeof node.shadow === "object" && node.shadow !== null), intensity: node.intensity });
+            return;
+        }
+        if (node.kind === "environment") {
+            environment = {
+                kind: node.environment === "hdri" ? "hdri" : "preset",
+                background: true
+            };
+            return;
+        }
+        if (environment.kind === "none" &&
+            (node.kind === "look" ||
+                (node.kind === "group" && typeof node.name === "string" && node.name.startsWith("aura-look:")))) {
+            environment = { kind: "preset", background: true };
+        }
+        if (node.kind === "model" || node.kind === "primitive") {
+            if (typeof node.name === "string" && node.name.startsWith("a3g-fx-"))
+                return;
+            const spec = node.material;
+            if (spec !== undefined) {
+                materials.push({
+                    name: spec.name,
+                    node: node.name,
+                    emissiveIntensity: spec.emissiveIntensity,
+                    practical: spec.practical === true
+                });
+            }
+        }
+        if (node.kind === "model") {
+            const key = node.asset?.id ?? "";
+            const entry = key.length > 0 ? manifest[key] : undefined;
+            models.push({
+                assetKey: key,
+                triangles: entry?.triangles ?? 0,
+                textures: entry?.textures ?? 0,
+                unlit: entry?.unlit ?? (node.material?.unlit === true),
+                overridesTextures: entry?.overridesTextures === true || node.material?.texture !== undefined
+            });
+        }
+    });
+    let drawCalls = 0;
+    if (typeof app.diagnostics === "function") {
+        const diag = app.diagnostics();
+        if (typeof diag.drawCalls === "number")
+            drawCalls = diag.drawCalls;
+    }
+    return {
+        lights,
+        hasAmbient: lights.some((light) => light.type === "ambient"),
+        environment,
+        models,
+        materials,
+        drawCalls
+    };
+}
+//# sourceMappingURL=snapshot.js.map

package/dist/game/art/snapshot.js.map

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

package/dist/game/capture/captureFromUrl.d.ts

@@ -0,0 +1,13 @@
+/**
+ * capture/captureFromUrl.ts — PRD-09 day-0.
+ *
+ * Parses the C-24 scenario params (`scenario`, `seed`, `freezeAt`,
+ * `cameraPose`). The legacy `?capture=review|overview` lens is gone: it is
+ * never read, so it has no effect and the route renders its shipped (play)
+ * view. Not reading it matters — the capture harness's forbidden-param probe
+ * (PRD-12 §6.6 / T5.2) fails any game that reads `capture`, `review`,
+ * `overview` or the debug params (T0-29 crash table, #979).
+ */
+import type { CaptureContext } from "../../engine/contracts/index.js";
+export declare function captureFromUrl(url?: URL): CaptureContext;
+//# sourceMappingURL=captureFromUrl.d.ts.map

package/dist/game/capture/captureFromUrl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"captureFromUrl.d.ts","sourceRoot":"","sources":["../../../../../packages/game/src/capture/captureFromUrl.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE/D,wBAAgB,cAAc,CAAC,GAAG,CAAC,EAAE,GAAG,GAAG,cAAc,CAiBxD"}

package/dist/game/capture/captureFromUrl.js

@@ -0,0 +1,30 @@
+/**
+ * capture/captureFromUrl.ts — PRD-09 day-0.
+ *
+ * Parses the C-24 scenario params (`scenario`, `seed`, `freezeAt`,
+ * `cameraPose`). The legacy `?capture=review|overview` lens is gone: it is
+ * never read, so it has no effect and the route renders its shipped (play)
+ * view. Not reading it matters — the capture harness's forbidden-param probe
+ * (PRD-12 §6.6 / T5.2) fails any game that reads `capture`, `review`,
+ * `overview` or the debug params (T0-29 crash table, #979).
+ */
+export function captureFromUrl(url) {
+    if (url === undefined || typeof URL === "undefined")
+        return { mode: "play" };
+    const params = url.searchParams;
+    const scenario = params.get("scenario") ?? undefined;
+    const seedRaw = params.get("seed");
+    const freezeAtRaw = params.get("freezeAt");
+    const cameraPose = params.get("cameraPose") ?? undefined;
+    if (scenario === undefined && seedRaw === null && freezeAtRaw === null && cameraPose === undefined) {
+        return { mode: "play" };
+    }
+    return {
+        mode: "scenario",
+        scenario,
+        seed: seedRaw !== null ? Number(seedRaw) : undefined,
+        freezeAt: freezeAtRaw !== null ? Number(freezeAtRaw) : undefined,
+        cameraPose
+    };
+}
+//# sourceMappingURL=captureFromUrl.js.map

package/dist/game/capture/captureFromUrl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"captureFromUrl.js","sourceRoot":"","sources":["../../../../../packages/game/src/capture/captureFromUrl.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,MAAM,UAAU,cAAc,CAAC,GAAS;IACtC,IAAI,GAAG,KAAK,SAAS,IAAI,OAAO,GAAG,KAAK,WAAW;QAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IAC7E,MAAM,MAAM,GAAG,GAAG,CAAC,YAAY,CAAC;IAChC,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,SAAS,CAAC;IACrD,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACnC,MAAM,WAAW,GAAG,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IAC3C,MAAM,UAAU,GAAG,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC,IAAI,SAAS,CAAC;IACzD,IAAI,QAAQ,KAAK,SAAS,IAAI,OAAO,KAAK,IAAI,IAAI,WAAW,KAAK,IAAI,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;QACnG,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IAC1B,CAAC;IACD,OAAO;QACL,IAAI,EAAE,UAAU;QAChB,QAAQ;QACR,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS;QACpD,QAAQ,EAAE,WAAW,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,SAAS;QAChE,UAAU;KACX,CAAC;AACJ,CAAC"}

package/dist/game/capture/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @aura3d/game/capture subpath (prd09, CONTRACTS.md §3.8).
+ */
+export { captureFromUrl } from "./captureFromUrl.js";
+export { lookSignature, lookManifest, lookManifestString, type LookSource, type LookNodeEntry } from "./lookSignature.js";
+export type { CaptureContext } from "../../engine/contracts/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/game/capture/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../packages/game/src/capture/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EACL,aAAa,EACb,YAAY,EACZ,kBAAkB,EAClB,KAAK,UAAU,EACf,KAAK,aAAa,EACnB,MAAM,iBAAiB,CAAC;AACzB,YAAY,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/game/capture/index.js

@@ -0,0 +1,6 @@
+/**
+ * @aura3d/game/capture subpath (prd09, CONTRACTS.md §3.8).
+ */
+export { captureFromUrl } from "./captureFromUrl.js";
+export { lookSignature, lookManifest, lookManifestString } from "./lookSignature.js";
+//# sourceMappingURL=index.js.map

package/dist/game/capture/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../packages/game/src/capture/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EACL,aAAa,EACb,YAAY,EACZ,kBAAkB,EAGnB,MAAM,iBAAiB,CAAC"}

package/dist/game/capture/lookSignature.d.ts

@@ -0,0 +1,37 @@
+/**
+ * capture/lookSignature.ts — PRD-09 day-0.
+ *
+ * SHA-256 look signature over a canonicalized render manifest:
+ *   { lights, materials, effects, environment, background, renderer options,
+ *     nodes: { id → { asset, material, authored scale, authored visible } } }
+ * Camera pose, animation state, and runtime transforms (position/rotation)
+ * are excluded. Canonicalization recursively sorts object keys so identical
+ * scenes hash identically regardless of authoring key order. `crypto.subtle`
+ * is required — non-secure contexts reject.
+ */
+export interface LookNodeEntry {
+    readonly id: string;
+    readonly asset?: unknown;
+    readonly material?: unknown;
+    readonly scale?: unknown;
+    readonly visible?: unknown;
+}
+export interface LookSource {
+    readonly background?: unknown;
+    readonly environment?: unknown;
+    readonly lights?: unknown;
+    readonly materials?: unknown;
+    readonly effects?: unknown;
+    readonly nodes?: unknown;
+    readonly renderer?: unknown;
+    readonly rendererOptions?: unknown;
+}
+/** Build the canonical manifest for a scene snapshot + renderer options. */
+export declare function lookManifest(source: LookSource): Record<string, unknown>;
+/** Stable string for hashing: JSON.stringify over the canonical manifest. */
+export declare function lookManifestString(source: LookSource | Record<string, unknown>): string;
+/** SHA-256 of the canonical manifest, lowercase hex. */
+export declare function lookSignature(source: LookSource | Record<string, unknown> | {
+    lookSource(): LookSource;
+}): Promise<string>;
+//# sourceMappingURL=lookSignature.d.ts.map

package/dist/game/capture/lookSignature.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lookSignature.d.ts","sourceRoot":"","sources":["../../../../../packages/game/src/capture/lookSignature.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,CAAC;CACpC;AAgCD,4EAA4E;AAC5E,wBAAgB,YAAY,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA0BxE;AAED,6EAA6E;AAC7E,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAGvF;AAYD,wDAAwD;AACxD,wBAAsB,aAAa,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IAAE,UAAU,IAAI,UAAU,CAAA;CAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAShI"}

package/dist/game/capture/lookSignature.js

@@ -0,0 +1,100 @@
+/**
+ * capture/lookSignature.ts — PRD-09 day-0.
+ *
+ * SHA-256 look signature over a canonicalized render manifest:
+ *   { lights, materials, effects, environment, background, renderer options,
+ *     nodes: { id → { asset, material, authored scale, authored visible } } }
+ * Camera pose, animation state, and runtime transforms (position/rotation)
+ * are excluded. Canonicalization recursively sorts object keys so identical
+ * scenes hash identically regardless of authoring key order. `crypto.subtle`
+ * is required — non-secure contexts reject.
+ */
+const isPlainObject = (v) => typeof v === "object" && v !== null && !Array.isArray(v);
+/** Recursively sort plain-object keys; arrays keep authored order. */
+function canonicalize(value) {
+    if (Array.isArray(value))
+        return value.map(canonicalize);
+    if (isPlainObject(value)) {
+        const out = {};
+        for (const key of Object.keys(value).sort()) {
+            const v = value[key];
+            if (v !== undefined && typeof v !== "function")
+                out[key] = canonicalize(v);
+        }
+        return out;
+    }
+    if (typeof value === "number" && !Number.isFinite(value))
+        return null;
+    return value;
+}
+/** Extract the look-defining fields of one authored node entry. */
+function nodeEntry(entry) {
+    const out = {};
+    const asset = entry.asset ?? entry.source ?? entry.gltf ?? entry.model;
+    if (asset !== undefined)
+        out.asset = canonicalize(asset);
+    const material = entry.material ?? entry.materials;
+    if (material !== undefined)
+        out.material = canonicalize(material);
+    if (entry.scale !== undefined)
+        out.scale = canonicalize(entry.scale);
+    if (entry.visible !== undefined)
+        out.visible = canonicalize(entry.visible);
+    return out;
+}
+/** Build the canonical manifest for a scene snapshot + renderer options. */
+export function lookManifest(source) {
+    const nodes = {};
+    const rawNodes = source.nodes;
+    if (Array.isArray(rawNodes)) {
+        for (const entry of rawNodes) {
+            if (!isPlainObject(entry))
+                continue;
+            const id = typeof entry.id === "string" ? entry.id : typeof entry.name === "string" ? entry.name : null;
+            if (id === null)
+                continue;
+            nodes[id] = nodeEntry(entry);
+        }
+    }
+    else if (isPlainObject(rawNodes)) {
+        for (const [id, entry] of Object.entries(rawNodes)) {
+            if (isPlainObject(entry))
+                nodes[id] = nodeEntry(entry);
+        }
+    }
+    const manifest = {
+        version: 1,
+        background: source.background ?? null,
+        environment: source.environment ?? null,
+        lights: source.lights ?? null,
+        materials: source.materials ?? null,
+        effects: source.effects ?? null,
+        renderer: source.renderer ?? source.rendererOptions ?? null,
+        nodes
+    };
+    return canonicalize(manifest);
+}
+/** Stable string for hashing: JSON.stringify over the canonical manifest. */
+export function lookManifestString(source) {
+    const manifest = "version" in source ? canonicalize(source) : lookManifest(source);
+    return JSON.stringify(manifest);
+}
+function assertSecureContext() {
+    const subtle = typeof crypto !== "undefined" ? crypto.subtle : undefined;
+    const insecureWindow = typeof window !== "undefined" &&
+        window.isSecureContext === false;
+    if (subtle === undefined || insecureWindow) {
+        throw new Error("AURA_LOOK_SIGNATURE_INSECURE: lookSignature requires a secure context (crypto.subtle).");
+    }
+}
+/** SHA-256 of the canonical manifest, lowercase hex. */
+export async function lookSignature(source) {
+    assertSecureContext();
+    const resolved = typeof source.lookSource === "function"
+        ? source.lookSource()
+        : source;
+    const encoded = new TextEncoder().encode(lookManifestString(resolved));
+    const digest = await crypto.subtle.digest("SHA-256", encoded);
+    return [...new Uint8Array(digest)].map((b) => b.toString(16).padStart(2, "0")).join("");
+}
+//# sourceMappingURL=lookSignature.js.map

package/dist/game/capture/lookSignature.js.map

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

package/dist/game/components.d.ts

@@ -0,0 +1,73 @@
+/**
+ * components.ts — PRD-09 day-0 interim shell/HUD/FX members.
+ *
+ * The session/shell/capture/beacon surface is real on day-0; HUD widgets,
+ * touch layouts and the FX layer deepen in the phase-2/3 PRs. These
+ * implementations satisfy the C-24 surface honestly — no panics, values are
+ * tracked and inspectable via snapshot() — and carry the same
+ * "primitive-pool" backend label the engine stub used.
+ */
+import type { GameShell, Hud, GameFxLayer, TransitionSpec } from "../engine/contracts/index.js";
+import type { AuraVec3 } from "../engine/index.js";
+import type { GameSessionImpl } from "./session/GameSession.js";
+import { type TransitionDriver } from "./shell/transition.js";
+export declare class GameShellImpl implements GameShell {
+    private readonly session;
+    private readonly transitionDriver?;
+    /**
+     * `transitionDriver` (DOM `.a3g-overlay` fade, §6.2) makes `transition()`
+     * cover the remount gap; without one (node/tests) it runs straight through.
+     */
+    constructor(session: GameSessionImpl, transitionDriver?: TransitionDriver | undefined);
+    get state(): import("../engine/index.js").GameSessionState;
+    showResults(_values: Readonly<Record<string, number>>): Promise<"retry" | "title" | "next">;
+    transition<T>(run: () => T | Promise<T>, spec?: TransitionSpec): Promise<T>;
+    openMenu(_id: "pause" | "settings" | "about"): void;
+    closeMenus(): void;
+    setLoadingProgress(_fraction: number, _label?: string): void;
+    track(_promise: Promise<unknown>, _weight: number): void;
+}
+export declare class GameHudImpl implements Hud {
+    private readonly values;
+    set(id: string, value: unknown): void;
+    banner(_text: string, _o?: {
+        holdMs?: number;
+        style?: string;
+    }): Promise<void>;
+    toast(_text: string, _o?: {
+        ms?: number;
+    }): void;
+    damageNumber(_value: number, _world: AuraVec3, _o?: {
+        color?: string;
+        crit?: boolean;
+    }): void;
+    setVisible(_v: boolean): void;
+    snapshot(): {
+        widgets: {
+            id: string;
+            value: unknown;
+            screenFraction: number;
+        }[];
+    };
+    dispose(): void;
+}
+export declare class GameFxLayerImpl implements GameFxLayer {
+    private live;
+    burst(_kind: string, _position: AuraVec3, _o?: {
+        count?: number;
+        speed?: number;
+        color?: string;
+        normal?: AuraVec3;
+        seed?: number;
+    }): void;
+    trail(_target: string, _o: {
+        width: number;
+        life: number;
+        color?: string;
+    }): {
+        stop(): void;
+    };
+    get liveCount(): number;
+    get backend(): "primitive-pool" | "particle-pass";
+}
+//# sourceMappingURL=components.d.ts.map

package/dist/game/components.d.ts.map

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

package/dist/game/components.js

@@ -0,0 +1,86 @@
+/**
+ * components.ts — PRD-09 day-0 interim shell/HUD/FX members.
+ *
+ * The session/shell/capture/beacon surface is real on day-0; HUD widgets,
+ * touch layouts and the FX layer deepen in the phase-2/3 PRs. These
+ * implementations satisfy the C-24 surface honestly — no panics, values are
+ * tracked and inspectable via snapshot() — and carry the same
+ * "primitive-pool" backend label the engine stub used.
+ */
+import { runTransition } from "./shell/transition.js";
+export class GameShellImpl {
+    session;
+    transitionDriver;
+    /**
+     * `transitionDriver` (DOM `.a3g-overlay` fade, §6.2) makes `transition()`
+     * cover the remount gap; without one (node/tests) it runs straight through.
+     */
+    constructor(session, transitionDriver) {
+        this.session = session;
+        this.transitionDriver = transitionDriver;
+    }
+    get state() {
+        return this.session.state;
+    }
+    async showResults(_values) {
+        this.session.transition("results");
+        return "retry";
+    }
+    async transition(run, spec) {
+        const from = this.session.state;
+        this.session.transition("transitioning");
+        try {
+            return this.transitionDriver ? await runTransition(this.transitionDriver, run, spec) : await run();
+        }
+        finally {
+            this.session.transition(from === "transitioning" ? "playing" : from);
+        }
+    }
+    openMenu(_id) {
+        this.session.pause("menu");
+    }
+    closeMenus() {
+        this.session.releasePause("menu");
+    }
+    setLoadingProgress(_fraction, _label) {
+        /* DOM shell lands in the shell PR — progress is accepted silently here. */
+    }
+    track(_promise, _weight) {
+        /* loading progress aggregation lands with the shell PR. */
+    }
+}
+export class GameHudImpl {
+    values = new Map();
+    set(id, value) {
+        this.values.set(id, value);
+    }
+    async banner(_text, _o) { }
+    toast(_text, _o) { }
+    damageNumber(_value, _world, _o) { }
+    setVisible(_v) { }
+    snapshot() {
+        return {
+            widgets: [...this.values.entries()].map(([id, value]) => ({ id, value, screenFraction: 0 }))
+        };
+    }
+    dispose() {
+        this.values.clear();
+    }
+}
+export class GameFxLayerImpl {
+    live = 0;
+    burst(_kind, _position, _o) {
+        this.live += 1;
+    }
+    trail(_target, _o) {
+        this.live += 1;
+        return { stop: () => { this.live = Math.max(0, this.live - 1); } };
+    }
+    get liveCount() {
+        return this.live;
+    }
+    get backend() {
+        return "primitive-pool";
+    }
+}
+//# sourceMappingURL=components.js.map

package/dist/game/components.js.map

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

package/dist/game/createGame.d.ts

@@ -0,0 +1,50 @@
+/**
+ * createGame.ts — PRD-09 day-0 real C-24 implementation.
+ *
+ * - Session time delegates to `app.time` when a C-23 controller is mounted,
+ *   else a local `StubTimeController` advanced once per real frame.
+ * - Capture context comes from the URL once (captureFromUrl); scene snapshots
+ *   authored at createGame/setScene feed the look signature.
+ * - Beacon (`__AURA3D_GAME__`) and the lazy evidence channel
+ *   (`__AURA3D_GAME_EVIDENCE__[route]`) install only in DOM contexts.
+ */
+import { createGameApp, type AuraAppTarget, type AuraCreateGameAppOptions } from "../engine/index.js";
+type RuntimeInput = ReturnType<typeof createGameApp>["input"];
+type MountedRuntime = ReturnType<typeof createGameApp>;
+import type { CreateGameOptions, Game, GameScenario } from "../engine/contracts/index.js";
+import { GameSessionImpl } from "./session/GameSession.js";
+import { type LifecycleSound } from "./session/lifecycle.js";
+import { type LookSource } from "./capture/lookSignature.js";
+import { type EvidenceChannelContract } from "./evidence/channel.js";
+import { type Juice } from "./juice/Juice.js";
+import { type GameAudio } from "../engine/index.js";
+export interface Prd09Game<TCue extends string, TEvent extends string> extends Game<TCue, TEvent> {
+    /** SHA-256 look signature over the last authored snapshot. */
+    lookSignature(): Promise<string>;
+    /** The canonical look manifest input the signature hashes. */
+    lookSource(): LookSource;
+    /** The mounted session implementation (also `game.session`). */
+    readonly sessionImpl: GameSessionImpl;
+    /** The mounted app runtime (the driver `game.ready()` waits on). */
+    readonly runtime: MountedRuntime;
+    /** The mounted input controller when `options.input` was provided. */
+    readonly input: RuntimeInput;
+    /** The juice driver built from `options.juice` (juice.define event map). */
+    readonly juice: Juice<TEvent>;
+    /** The C-25 audio facade when `options.sound` was provided. */
+    readonly sound?: GameAudio<TCue>;
+}
+/** createGame options plus the PRD-09 scenario registry (§7.4) and the
+ * createGameApp fields a route already owns (input/loop/physics/diagnostics). */
+export type Prd09CreateGameOptions<TCue extends string, TEvent extends string> = Omit<CreateGameOptions<TCue, TEvent>, "target"> & Omit<AuraCreateGameAppOptions, "scene"> & {
+    /** AuraAppTarget — element, canvas, or CSS selector (unlike the narrower contract type). */
+    readonly target: AuraAppTarget;
+    readonly scenarios?: Readonly<Record<string, GameScenario>>;
+    /** Wired into the session lifecycle (suspend/dispose/unlock on tab events). */
+    readonly soundAdapter?: LifecycleSound;
+    /** Route evidence sections + legacy global aliases (C-24 §6.5). */
+    readonly evidence?: EvidenceChannelContract;
+};
+export declare function createGameImpl<TCue extends string, TEvent extends string>(options: Prd09CreateGameOptions<TCue, TEvent>): Prd09Game<TCue, TEvent>;
+export {};
+//# sourceMappingURL=createGame.d.ts.map