@aura3d/engine 1.5.2 → 2.0.1

package/dist/engine/agent-api/lean-game.d.ts

@@ -0,0 +1,3 @@
+/** @deprecated New applications should import `@aura3d/lean/game`. */
+export * from "../../lean/game.js";
+//# sourceMappingURL=lean-game.d.ts.map

package/dist/engine/agent-api/lean-game.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lean-game.d.ts","sourceRoot":"","sources":["../../../../../packages/engine/src/agent-api/lean-game.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,cAAc,mBAAmB,CAAC"}

package/dist/engine/agent-api/lean-game.js

@@ -0,0 +1,3 @@
+/** @deprecated New applications should import `@aura3d/lean/game`. */
+export * from "../../lean/game.js";
+//# sourceMappingURL=lean-game.js.map

package/dist/engine/agent-api/lean-game.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lean-game.js","sourceRoot":"","sources":["../../../../../packages/engine/src/agent-api/lean-game.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,cAAc,mBAAmB,CAAC"}

package/dist/engine/agent-api/lean-product.d.ts

@@ -0,0 +1,3 @@
+/** @deprecated New applications should import `@aura3d/lean/product`. */
+export * from "../../lean/product.js";
+//# sourceMappingURL=lean-product.d.ts.map

package/dist/engine/agent-api/lean-product.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lean-product.d.ts","sourceRoot":"","sources":["../../../../../packages/engine/src/agent-api/lean-product.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,cAAc,sBAAsB,CAAC"}

package/dist/engine/agent-api/lean-product.js

@@ -0,0 +1,3 @@
+/** @deprecated New applications should import `@aura3d/lean/product`. */
+export * from "../../lean/product.js";
+//# sourceMappingURL=lean-product.js.map

package/dist/engine/agent-api/lean-product.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lean-product.js","sourceRoot":"","sources":["../../../../../packages/engine/src/agent-api/lean-product.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,cAAc,sBAAsB,CAAC"}

package/dist/engine/agent-api/lean.d.ts

@@ -0,0 +1,3 @@
+/** @deprecated New applications should import `@aura3d/lean`. */
+export * from "../../lean/index.js";
+//# sourceMappingURL=lean.d.ts.map

package/dist/engine/agent-api/lean.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lean.d.ts","sourceRoot":"","sources":["../../../../../packages/engine/src/agent-api/lean.ts"],"names":[],"mappings":"AAAA,iEAAiE;AACjE,cAAc,cAAc,CAAC"}

package/dist/engine/agent-api/lean.js

@@ -0,0 +1,3 @@
+/** @deprecated New applications should import `@aura3d/lean`. */
+export * from "../../lean/index.js";
+//# sourceMappingURL=lean.js.map

package/dist/engine/agent-api/lean.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lean.js","sourceRoot":"","sources":["../../../../../packages/engine/src/agent-api/lean.ts"],"names":[],"mappings":"AAAA,iEAAiE;AACjE,cAAc,cAAc,CAAC"}

package/dist/engine/agent-api/media-node.d.ts

@@ -0,0 +1,42 @@
+/**
+ * WS-2.3 — the Node-only media surface, as its own entry point.
+ *
+ * ## The measured problem
+ *
+ * `FfmpegFrameEncoder.ts` is the **only** file in the 37-file media/video surface that reaches
+ * `node:` builtins: `node:child_process` to spawn ffmpeg, and `node:fs/promises` / `node:os` /
+ * `node:path` to stage frames. Everything else is browser or pure.
+ *
+ * It was re-exported from `agent-api/index.ts`, so every browser bundle of the public entry point
+ * reached a module importing Node builtins. That is why `tools/bundle-size` carries a standing comment
+ * marking four `node:` specifiers external "for every browser bundle measurement" — a workaround for a
+ * dependency that should not have been in the browser graph at all. esbuild resolves `await import()`
+ * at build time regardless of whether the branch can ever run.
+ *
+ * ## Why a subpath and not a package
+ *
+ * Measured with `tools/_probe/deps.mjs`: the media files import **back** into the rest of `agent-api` —
+ * `PromptAnimationContract` (31 edges), `AnimationRenderQueue` (10), `ShotTimeline` (5),
+ * `AnimationPerformance` (4), `VisemeController` (3) — while `AnimationDirector`, `ShotTimeline`,
+ * `AssetLibraryBrowser` and `PromptAnimationEvidence` import media files in return. A separate package
+ * would be a dependency cycle. The PRD anticipates this and permits the alternative it requires:
+ * *"one package with environment-safe export conditions"*.
+ *
+ * ## The binding requirement
+ *
+ * No `node:` import reachable from any browser entry. `agent-api/index.ts` no longer re-exports this
+ * module; a Node consumer imports `@aura3d/engine/media-node` instead. Enforced by
+ * `tools/browser-entry-purity`, which fails the build if a `node:` specifier reappears in the browser
+ * graph — a comment would not have held.
+ */
+export { buildFfmpegArgs, createFfmpegFrameEncoderAdapter, probeFfmpeg } from "./FfmpegFrameEncoder.js";
+export type { CreateFfmpegFrameEncoderAdapterOptions, FfmpegCapability, FfmpegFileSystem, FfmpegFrameInputFormat, FfmpegRunResult, RunFfmpeg } from "./FfmpegFrameEncoder.js";
+export * from "./PngSequenceEncoder.js";
+export * from "./AudioMuxer.js";
+export * from "./VideoExportPipeline.js";
+export * from "./CaptionExporter.js";
+export * from "./YouTubeMetadataGenerator.js";
+export * from "./YouTubeUploadAdapter.js";
+export * from "./PublishingPipeline.js";
+export * from "./CloudRenderAdapter.js";
+//# sourceMappingURL=media-node.d.ts.map

package/dist/engine/agent-api/media-node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-node.d.ts","sourceRoot":"","sources":["../../../../../packages/engine/src/agent-api/media-node.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,OAAO,EACL,eAAe,EACf,+BAA+B,EAC/B,WAAW,EACZ,MAAM,yBAAyB,CAAC;AACjC,YAAY,EACV,sCAAsC,EACtC,gBAAgB,EAChB,gBAAgB,EAChB,sBAAsB,EACtB,eAAe,EACf,SAAS,EACV,MAAM,yBAAyB,CAAC;AAKjC,cAAc,yBAAyB,CAAC;AACxC,cAAc,iBAAiB,CAAC;AAChC,cAAc,0BAA0B,CAAC;AACzC,cAAc,sBAAsB,CAAC;AACrC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC"}

package/dist/engine/agent-api/media-node.js

@@ -0,0 +1,44 @@
+/**
+ * WS-2.3 — the Node-only media surface, as its own entry point.
+ *
+ * ## The measured problem
+ *
+ * `FfmpegFrameEncoder.ts` is the **only** file in the 37-file media/video surface that reaches
+ * `node:` builtins: `node:child_process` to spawn ffmpeg, and `node:fs/promises` / `node:os` /
+ * `node:path` to stage frames. Everything else is browser or pure.
+ *
+ * It was re-exported from `agent-api/index.ts`, so every browser bundle of the public entry point
+ * reached a module importing Node builtins. That is why `tools/bundle-size` carries a standing comment
+ * marking four `node:` specifiers external "for every browser bundle measurement" — a workaround for a
+ * dependency that should not have been in the browser graph at all. esbuild resolves `await import()`
+ * at build time regardless of whether the branch can ever run.
+ *
+ * ## Why a subpath and not a package
+ *
+ * Measured with `tools/_probe/deps.mjs`: the media files import **back** into the rest of `agent-api` —
+ * `PromptAnimationContract` (31 edges), `AnimationRenderQueue` (10), `ShotTimeline` (5),
+ * `AnimationPerformance` (4), `VisemeController` (3) — while `AnimationDirector`, `ShotTimeline`,
+ * `AssetLibraryBrowser` and `PromptAnimationEvidence` import media files in return. A separate package
+ * would be a dependency cycle. The PRD anticipates this and permits the alternative it requires:
+ * *"one package with environment-safe export conditions"*.
+ *
+ * ## The binding requirement
+ *
+ * No `node:` import reachable from any browser entry. `agent-api/index.ts` no longer re-exports this
+ * module; a Node consumer imports `@aura3d/engine/media-node` instead. Enforced by
+ * `tools/browser-entry-purity`, which fails the build if a `node:` specifier reappears in the browser
+ * graph — a comment would not have held.
+ */
+export { buildFfmpegArgs, createFfmpegFrameEncoderAdapter, probeFfmpeg } from "./FfmpegFrameEncoder.js";
+// Offline encoding, filesystem-shaped artifacts, cloud rendering, and publishing
+// integrations share this explicit non-browser entry. Browser capture/encoding stays
+// on the root API through MediaRecorder and WebCodecs adapters.
+export * from "./PngSequenceEncoder.js";
+export * from "./AudioMuxer.js";
+export * from "./VideoExportPipeline.js";
+export * from "./CaptionExporter.js";
+export * from "./YouTubeMetadataGenerator.js";
+export * from "./YouTubeUploadAdapter.js";
+export * from "./PublishingPipeline.js";
+export * from "./CloudRenderAdapter.js";
+//# sourceMappingURL=media-node.js.map

package/dist/engine/agent-api/media-node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-node.js","sourceRoot":"","sources":["../../../../../packages/engine/src/agent-api/media-node.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,OAAO,EACL,eAAe,EACf,+BAA+B,EAC/B,WAAW,EACZ,MAAM,yBAAyB,CAAC;AAUjC,iFAAiF;AACjF,qFAAqF;AACrF,gEAAgE;AAChE,cAAc,yBAAyB,CAAC;AACxC,cAAc,iBAAiB,CAAC;AAChC,cAAc,0BAA0B,CAAC;AACzC,cAAc,sBAAsB,CAAC;AACrC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC"}

package/dist/engine/agent-api/product-viewer-runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"product-viewer-runtime.d.ts","sourceRoot":"","sources":["../../../../../packages/engine/src/agent-api/product-viewer-runtime.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,OAAO,EACP,aAAa,EACb,mBAAmB,EACnB,YAAY,EACZ,YAAY,EACZ,oBAAoB,EACpB,qBAAqB,EACrB,gBAAgB,EAChB,YAAY,EACb,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,aAAa,EACb,gBAAgB,EACjB,MAAM,YAAY,CAAC;AAEpB,YAAY,EACV,OAAO,EACP,aAAa,EACb,mBAAmB,EACnB,YAAY,EACZ,YAAY,EACZ,oBAAoB,EACrB,CAAC;AAEF,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,UAAU,CAAC,EAAE,qBAAqB,CAAC;CAC7C;AAED,MAAM,MAAM,kBAAkB,GAAG,gBAAgB,CAAC;AAClD,MAAM,MAAM,qBAAqB,GAAG,YAAY,CAAC;AACjD,MAAM,MAAM,wBAAwB,GAAG,UAAU,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC;AAE1E,eAAO,MAAM,OAAO;;;sBAWymmY,CAAC;;;;;;CAX5lmY,CAAC;AAEnC,eAAO,MAAM,SAAS;oCACC,YAAY,CAAC,OAAO,CAAC,YAAW,oBAAoB,KAAQ,qBAAqB;CAG9F,CAAC;AAEX,wBAAgB,aAAa,CAAC,KAAK,EAAE,YAAY,CAAC,OAAO,CAAC,EAAE,OAAO,GAAE,oBAAyB,GAAG,qBAAqB,CAErH"}
+{"version":3,"file":"product-viewer-runtime.d.ts","sourceRoot":"","sources":["../../../../../packages/engine/src/agent-api/product-viewer-runtime.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,OAAO,EACP,aAAa,EACb,mBAAmB,EACnB,YAAY,EACZ,YAAY,EACZ,oBAAoB,EACpB,qBAAqB,EACrB,gBAAgB,EAChB,YAAY,EACb,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,aAAa,EACb,gBAAgB,EACjB,MAAM,YAAY,CAAC;AAEpB,YAAY,EACV,OAAO,EACP,aAAa,EACb,mBAAmB,EACnB,YAAY,EACZ,YAAY,EACZ,oBAAoB,EACrB,CAAC;AAEF,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,UAAU,CAAC,EAAE,qBAAqB,CAAC;CAC7C;AAED,MAAM,MAAM,kBAAkB,GAAG,gBAAgB,CAAC;AAClD,MAAM,MAAM,qBAAqB,GAAG,YAAY,CAAC;AACjD,MAAM,MAAM,wBAAwB,GAAG,UAAU,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC;AAE1E,eAAO,MAAM,OAAO;;;sBAWg8zY,CAAC;;;;;;CAXn7zY,CAAC;AAEnC,eAAO,MAAM,SAAS;oCACC,YAAY,CAAC,OAAO,CAAC,YAAW,oBAAoB,KAAQ,qBAAqB;CAG9F,CAAC;AAEX,wBAAgB,aAAa,CAAC,KAAK,EAAE,YAAY,CAAC,OAAO,CAAC,EAAE,OAAO,GAAE,oBAAyB,GAAG,qBAAqB,CAErH"}

package/dist/engine/animation-studio/animation-episode-validator.d.ts

@@ -10,7 +10,7 @@
  * *well-directed or watchable*. "Good" needs the human-review rubric — automation can
  * only keep a scene from being broken, not make it good.
  */
-import { type EpisodeDocument } from "./episode-document";
+import { type EpisodeDocument } from "./episode-document.js";
 export interface EpisodeDocumentValidation {
     readonly ok: boolean;
     readonly errors: readonly string[];

package/dist/engine/animation-studio/director-heuristics.d.ts

@@ -15,7 +15,7 @@
  * are the LLM director's job (and remain unproven). The output is always a *valid*
  * document; "valid" is not "well-directed" — that needs the human rubric (the watchability gate).
  */
-import type { CharacterBlocking, PropPlacement, ShotSpec, Vec3 } from "./episode-document";
+import type { CharacterBlocking, PropPlacement, ShotSpec, Vec3 } from "./episode-document.js";
 export interface DirectorCharacter {
     readonly id: string;
     /** Where the character starts the scene (drives a walk-in on the opening shot). */

package/dist/engine/animation-studio/episode-document.d.ts

@@ -13,7 +13,7 @@
  * rebuild). The design doc promotes these contracts into
  * `packages/engine/src/animation-studio/*` once stable.
  */
-import type { CameraPresetId } from "../agent-api/CameraPresetLibrary";
+import type { CameraPresetId } from "../agent-api/CameraPresetLibrary.js";
 export type Vec3 = readonly [number, number, number];
 export type Vec4 = readonly [number, number, number, number];
 /** Provenance for a catalog-resolved asset (CC-BY attribution + source + hash). */

package/dist/engine/animation-studio/index.d.ts

@@ -13,8 +13,8 @@
  * include the browser renderer (scene-player) or the headless capture scripts — those
  * stay in the template/run surface.
  */
-export * from "./episode-document";
-export * from "./animation-episode-validator";
-export * from "./director-heuristics";
-export * from "./scene-tools";
+export * from "./episode-document.js";
+export * from "./animation-episode-validator.js";
+export * from "./director-heuristics.js";
+export * from "./scene-tools.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/engine/animation-studio/scene-tools.d.ts

@@ -4,8 +4,8 @@
  * Each function returns a NEW document; the store validates + commits (or rejects). The
  * agent never edits raw code — only these typed, validated edits.
  */
-import type { CameraPresetId } from "../agent-api/CameraPresetLibrary";
-import type { BlockingWaypoint, DialogueLine, EpisodeDocument, PropPlacement, Vec3 } from "./episode-document";
+import type { CameraPresetId } from "../agent-api/CameraPresetLibrary.js";
+import type { BlockingWaypoint, DialogueLine, EpisodeDocument, PropPlacement, Vec3 } from "./episode-document.js";
 /** Append a shot (given a duration); the timeline re-contiguizes. */
 export declare function addShot(doc: EpisodeDocument, shotId: string, presetId: CameraPresetId, duration: number, cameraSubject: Vec3): EpisodeDocument;
 /** Remove a shot; the timeline closes up. */

package/dist/engine/ecs/ECSRenderSource.d.ts

@@ -1,5 +1,5 @@
-import { type Entity, type World } from "@aura3d/ecs";
-import type { Geometry, MorphTargetDelta, RenderMaterial, RenderSource } from "@aura3d/rendering";
+import { type Entity, type World } from "../../ecs/index.js";
+import type { Geometry, MorphTargetDelta, RenderMaterial, RenderSource } from "../../rendering/index.js";
 export interface ECSRenderLibraries {
     geometry: Map<string, Geometry>;
     material: Map<string, RenderMaterial>;

package/dist/engine/game/GameAudio.d.ts

@@ -1,3 +1,4 @@
+import { type AudioFileInput } from "../../audio/index.js";
 export type GameAudioBusId = "master" | string;
 export interface GameAudioContextLike {
     readonly state: string;
@@ -19,6 +20,8 @@ export interface GameAudioCueDefinition<TCue extends string = string> {
     readonly volume?: number;
     readonly frequency?: number;
     readonly duration?: number;
+    readonly asset?: AudioFileInput;
+    readonly loop?: boolean;
     play?(context: GameAudioContextLike, destination: AudioNode, cue: GameAudioCueDefinition<TCue>): void | Promise<void>;
 }
 export interface GameAudioCueEvent<TCue extends string = string> {
@@ -49,6 +52,8 @@ export interface GameAudioEvidence<TCue extends string = string> {
 export interface GameAudioOptions<TCue extends string = string> {
     readonly context?: GameAudioContextLike | null;
     readonly createContext?: () => GameAudioContextLike | null;
+    /** Ask the shared AudioContextManager to create and own the browser context. */
+    readonly browserContext?: boolean;
     readonly buses?: readonly GameAudioBusDefinition[];
     readonly cues: Readonly<Record<TCue, GameAudioCueDefinition<TCue>>>;
 }

package/dist/engine/game/GameAudio.d.ts.map

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

package/dist/engine/game/GameAudio.js

@@ -1,7 +1,12 @@
+import { AudioBus, AudioContextManager, AudioFileManager, AudioSource } from "../../audio/index.js";
 export function createGameAudio(options) {
     const cueDefinitions = options.cues;
     const cueIds = Object.keys(cueDefinitions);
     let context = options.context;
+    if (options.browserContext && (options.context !== undefined || options.createContext !== undefined)) {
+        throw new Error("Game audio browserContext cannot be combined with context or createContext; choose one context owner.");
+    }
+    const contextManager = options.browserContext ? new AudioContextManager() : undefined;
     let muted = false;
     let unlocked = false;
     let disposed = false;
@@ -11,9 +16,18 @@ export function createGameAudio(options) {
     const errors = [];
     const listeners = new Set();
     const buses = new Map();
+    /*
+     * Volume for buses created while no audio context exists. `AudioBus` needs a real `createGain`, so
+     * headless route-health runs have no `node` to hold the value — but `setBusVolume` must still be
+     * observable in evidence there, which is what the harnesses assert on. One map, only ever read when
+     * `node` is absent, so there is no second source of truth for a live bus.
+     */
+    const contextlessBusVolumes = new Map();
+    let fileManager;
+    const activeSources = new Set();
     const getContext = () => {
         if (context === undefined)
-            context = options.createContext?.() ?? null;
+            context = contextManager ? contextManager.context : options.createContext?.() ?? null;
         return context ?? null;
     };
     const getBus = (id) => {
@@ -21,22 +35,34 @@ export function createGameAudio(options) {
         if (existing)
             return existing;
         const audioContext = getContext();
-        const gain = audioContext?.createGain();
-        if (gain && audioContext) {
-            gain.gain.value = 1;
-            gain.connect(audioContext.destination);
-        }
-        const bus = { id, gain, volume: 1, muted: false };
+        // `GameAudioContextLike` structurally satisfies `AudioBusContextLike` (destination + createGain).
+        const node = audioContext ? new AudioBus(String(id), audioContext) : undefined;
+        const bus = { id, node };
         buses.set(id, bus);
         return bus;
     };
+    const playAssetCue = async (audioContext, destination, definition) => {
+        if (!definition.asset)
+            return;
+        if (!("decodeAudioData" in audioContext) || !("createBufferSource" in audioContext)) {
+            throw new Error(`Game audio cue "${definition.id}" uses an asset but its context cannot decode or play audio buffers.`);
+        }
+        const decodeContext = audioContext;
+        fileManager ??= new AudioFileManager({ context: decodeContext });
+        const clip = await fileManager.load(definition.asset);
+        const source = new AudioSource({ context: decodeContext, destination, clip, loop: definition.loop, volume: definition.volume });
+        activeSources.add(source);
+        source.play();
+    };
     getBus("master");
     for (const bus of options.buses ?? []) {
         const state = getBus(bus.id);
-        if (bus.volume !== undefined)
-            state.volume = bus.volume;
-        if (state.gain)
-            state.gain.gain.value = bus.volume ?? state.volume;
+        if (bus.volume === undefined)
+            continue;
+        if (state.node)
+            state.node.setVolume(bus.volume);
+        else
+            contextlessBusVolumes.set(bus.id, bus.volume);
     }
     const snapshot = () => {
         const audioContext = getContext();
@@ -54,8 +80,8 @@ export function createGameAudio(options) {
             errors,
             buses: [...buses.values()].map((bus) => ({
                 id: bus.id,
-                volume: bus.volume,
-                muted: bus.muted
+                volume: bus.node?.volume ?? contextlessBusVolumes.get(bus.id) ?? 1,
+                muted: bus.node?.isMuted ?? false
             }))
         };
     };
@@ -67,7 +93,10 @@ export function createGameAudio(options) {
             const audioContext = getContext();
             if (!audioContext)
                 return snapshot();
-            await audioContext.resume();
+            if (contextManager)
+                await contextManager.unlock();
+            else
+                await audioContext.resume();
             unlocked = true;
             return snapshot();
         },
@@ -78,16 +107,17 @@ export function createGameAudio(options) {
             const bus = getBus(definition.bus ?? "master");
             const audioContext = getContext();
             lastCue = cue;
+            const busMuted = bus.node?.isMuted ?? false;
             const event = {
                 cue,
                 bus: bus.id,
-                muted: muted || bus.muted,
+                muted: muted || busMuted,
                 unlocked,
                 time: audioContext?.currentTime ?? 0
             };
             for (const listener of [...listeners])
                 listener(event);
-            if (!audioContext || disposed || muted || bus.muted) {
+            if (!audioContext || disposed || muted || busMuted) {
                 suppressedCueCount += 1;
                 return event;
             }
@@ -95,10 +125,13 @@ export function createGameAudio(options) {
                 if (!unlocked)
                     await audio.unlock();
                 if (definition.play) {
-                    await definition.play(audioContext, bus.gain ?? audioContext.destination, definition);
+                    await definition.play(audioContext, bus.node?.input ?? audioContext.destination, definition);
+                }
+                else if (definition.asset) {
+                    await playAssetCue(audioContext, bus.node?.input ?? audioContext.destination, definition);
                 }
                 else {
-                    playDefaultCue(audioContext, bus.gain ?? audioContext.destination, definition);
+                    playDefaultCue(audioContext, bus.node?.input ?? audioContext.destination, definition);
                 }
                 playedCueCount += 1;
             }
@@ -116,9 +149,12 @@ export function createGameAudio(options) {
             if (!Number.isFinite(volume) || volume < 0)
                 throw new Error("Game audio bus volume must be a non-negative finite number.");
             const bus = getBus(busId);
-            bus.volume = volume;
-            if (bus.gain && !bus.muted)
-                bus.gain.gain.value = volume;
+            // Validated again inside AudioBus.setVolume; the local check is kept so the error message stays
+            // the game-facing one that existing routes and tests assert on.
+            if (bus.node)
+                bus.node.setVolume(volume);
+            else
+                contextlessBusVolumes.set(bus.id, volume);
             return snapshot();
         },
         onCue(callback) {
@@ -128,8 +164,14 @@ export function createGameAudio(options) {
         async dispose() {
             disposed = true;
             for (const bus of buses.values())
-                bus.gain?.disconnect();
-            if (context?.close)
+                bus.node?.dispose();
+            for (const source of activeSources)
+                source.dispose();
+            activeSources.clear();
+            fileManager?.clear();
+            if (contextManager)
+                await contextManager.dispose();
+            else if (context?.close)
                 await context.close();
             return snapshot();
         }

package/dist/engine/game/GameAudio.js.map

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

package/dist/engine/index.d.ts

@@ -1,11 +1,11 @@
-export { A3D_APP_WORKFLOW_PRESETS, createA3DApp, resolveA3DAppQualityPreset } from "@aura3d/apps";
-export type { A3DApp, A3DAppDiagnostics, A3DAppOptions, A3DAppQualityPreset, A3DAppQualitySettings, A3DAppWorkflowPreset } from "@aura3d/apps";
-export { Engine } from "@aura3d/core";
-export { Renderer, analyzeRgbaFrameMotionRegions, createAnimationMaterialStyle, createAnimationRenderPreset, createAnimationVisualQualityReport, createExternalParityEnvironmentPipeline, listExternalParityEnvironmentTargets } from "@aura3d/rendering";
-export type { AnimationFrameVisualInput, AnimationFrameVisualQuality, AnimationMaterialStyle, AnimationMaterialStyleOptions, FrameMotionRegion, FrameMotionRegionMetrics, AnimationRenderPresetEvidence, AnimationRenderPresetOptions, AnimationVisualQualityOptions, AnimationVisualQualityReport } from "@aura3d/rendering";
-export { GLTFLoader, createAssetCompatibilityReport, inspectGLTFAsset, loadRenderableAsset, summarizeExternalParityGLTFCorpus } from "@aura3d/assets";
-export { loadProductAsset } from "@aura3d/product-studio";
-export { createAnimationLabWorkflow, createAssetViewerWorkflow, createComparisonWorkflow, createInteractiveSceneWorkflow, createMaterialStudioWorkflow, createProductConfiguratorWorkflow, createSceneShowcaseWorkflow } from "@aura3d/workflows";
+export { A3D_APP_WORKFLOW_PRESETS, createA3DApp, resolveA3DAppQualityPreset } from "../apps/index.js";
+export type { A3DApp, A3DAppDiagnostics, A3DAppOptions, A3DAppQualityPreset, A3DAppQualitySettings, A3DAppWorkflowPreset } from "../apps/index.js";
+export { Engine } from "../core/index.js";
+export { Renderer, analyzeRgbaFrameMotionRegions, createAnimationMaterialStyle, createAnimationRenderPreset, createAnimationVisualQualityReport, createExternalParityEnvironmentPipeline, listExternalParityEnvironmentTargets } from "../rendering/index.js";
+export type { AnimationFrameVisualInput, AnimationFrameVisualQuality, AnimationMaterialStyle, AnimationMaterialStyleOptions, FrameMotionRegion, FrameMotionRegionMetrics, AnimationRenderPresetEvidence, AnimationRenderPresetOptions, AnimationVisualQualityOptions, AnimationVisualQualityReport } from "../rendering/index.js";
+export { GLTFLoader, createAssetCompatibilityReport, inspectGLTFAsset, loadRenderableAsset, summarizeExternalParityGLTFCorpus } from "../assets/index.js";
+export { loadProductAsset } from "../product-studio/index.js";
+export { createAnimationLabWorkflow, createAssetViewerWorkflow, createComparisonWorkflow, createInteractiveSceneWorkflow, createMaterialStudioWorkflow, createProductConfiguratorWorkflow, createSceneShowcaseWorkflow } from "../workflows/index.js";
 export { A3DRenderer, A3DScene, A3DAppLifecycle } from "./advanced-runtime/index.js";
 export * from "./agent-api/index.js";
 export * from "./runtime/index.js";
@@ -17,12 +17,12 @@ export * from "./devtools/AuraPerformancePanel.js";
 export * from "./testing/screenshot.js";
 export * from "./testing/routeHealth.js";
 export type { A3DAppLifecycleSnapshot, A3DDisposable, A3DRendererOptions, A3DSceneMeshOptions, A3DSceneRenderSourceOptions } from "./advanced-runtime/index.js";
-import type { A3DApp } from "@aura3d/apps";
-import type { PostProcessComposer, PostProcessComposerOptions } from "@aura3d/rendering";
-import type { ProductAsset, ProductAssetLoadOptions } from "@aura3d/product-studio";
-import { createAnimationLabWorkflow, createAssetViewerWorkflow, createComparisonWorkflow, createInteractiveSceneWorkflow, createMaterialStudioWorkflow, createProductConfiguratorWorkflow, createSceneShowcaseWorkflow } from "@aura3d/workflows";
-import { type ExternalParityEnvironmentPipeline, type ExternalParityEnvironmentPipelineOptions, type RenderDeviceDiagnostics } from "@aura3d/rendering";
-import { type AssetCompatibilityReport, type GLTFAsset, type GLTFAssetInspectionReport, type GLTFCorpusManifest, type GLTFRenderResources, type LoadRenderableAssetOptions, type RenderableAsset } from "@aura3d/assets";
+import type { A3DApp } from "../apps/index.js";
+import type { PostProcessComposer, PostProcessComposerOptions } from "../rendering/index.js";
+import type { ProductAsset, ProductAssetLoadOptions } from "../product-studio/index.js";
+import { createAnimationLabWorkflow, createAssetViewerWorkflow, createComparisonWorkflow, createInteractiveSceneWorkflow, createMaterialStudioWorkflow, createProductConfiguratorWorkflow, createSceneShowcaseWorkflow } from "../workflows/index.js";
+import { type ExternalParityEnvironmentPipeline, type ExternalParityEnvironmentPipelineOptions, type RenderDeviceDiagnostics } from "../rendering/index.js";
+import { type AssetCompatibilityReport, type GLTFAsset, type GLTFAssetInspectionReport, type GLTFCorpusManifest, type GLTFRenderResources, type LoadRenderableAssetOptions, type RenderableAsset } from "../assets/index.js";
 export declare const workflows: {
     readonly assetViewer: typeof createAssetViewerWorkflow;
     readonly productConfigurator: typeof createProductConfiguratorWorkflow;

package/dist/engine/production-runtime/GameRenderPreset.d.ts

@@ -1,4 +1,4 @@
-import type { EnvironmentLightingOptions, PerspectiveCameraFrameOptions, RenderSource, RendererPostProcessOptions, RendererShadowOptions } from "@aura3d/rendering";
+import type { EnvironmentLightingOptions, PerspectiveCameraFrameOptions, RenderSource, RendererPostProcessOptions, RendererShadowOptions } from "../../rendering/index.js";
 export interface SideViewGameRenderPreset {
     readonly kind: "aura-side-view-game-render-preset";
     readonly cameraPolicy: RenderSource["cameraPolicy"];

package/dist/engine/production-runtime/TypedGLBActor.d.ts

@@ -1,6 +1,6 @@
-import { type GLTFSceneAnimationApplyResult, type GLTFSceneAnimationRuntime, type GLTFSceneAnimationRuntimeSnapshot, type GLTFScenePose, type ProductionGLTFRenderPipeline } from "@aura3d/assets/browser";
-import { type RenderItem } from "@aura3d/rendering";
-import { type Mat4 } from "@aura3d/scene";
+import { type GLTFSceneAnimationApplyResult, type GLTFSceneAnimationRuntime, type GLTFSceneAnimationRuntimeSnapshot, type GLTFScenePose, type ProductionGLTFRenderPipeline } from "../../assets/gltf-runtime.js";
+import { type RenderItem } from "../../rendering/index.js";
+import { type Mat4 } from "../../scene/index.js";
 export interface TypedGLBActorAsset {
     readonly url: string;
     readonly type?: string;
@@ -24,11 +24,19 @@ export interface TypedGLBActorOptions {
      * leave off for actors whose materials are individually tinted at runtime.
      */
     readonly deduplicateIdenticalMaterials?: boolean;
+    /** Exact imported glTF node names that should not contribute renderables. */
+    readonly hiddenNodeNames?: readonly string[];
 }
 export interface TypedGLBActorTintOptions {
     readonly baseColor: readonly [number, number, number, number];
     readonly emissiveColor?: readonly [number, number, number];
     readonly emissiveStrength?: number;
+    readonly roughness?: number;
+    readonly metallic?: number;
+    readonly clearcoat?: number;
+    readonly clearcoatRoughness?: number;
+    /** Replace authored color/surface textures when a public material override is requested. */
+    readonly replaceSurfaceTextures?: boolean;
 }
 export interface TypedGLBActorTransformOptions {
     readonly modelMatrix?: Mat4 | readonly number[];

package/dist/engine/production-runtime/TypedGLBActor.d.ts.map

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