@vgai/engine 0.5.22 → 0.5.24

package/dist/animation/xstate-animation-meta.js

@@ -90,6 +90,20 @@ export const AnimationBlendTreeSchema = z.discriminatedUnion('type', [
     AnimationBlendTree2DSchema,
     AnimationBlendTreeDirectSchema,
 ]);
+/**
+ * The structural-identity claim in this file's header, made COMPILER-CHECKED.
+ *
+ * `evaluateBlendTree` takes `anim-graph-types.ts`'s `BlendTreeDef`, and the
+ * whole reason this schema mirrors that shape field-for-field is so a parsed
+ * value can be handed over with zero conversion. The binding used to spell that
+ * hand-over `as unknown as BlendTreeDef` — a double cast that would have gone on
+ * compiling if either declaration drifted, silently feeding the blend math a
+ * shape it does not describe. This identity function is the assignability
+ * assertion instead: drift here is a type error at the seam that claims it.
+ */
+export function asBlendTreeDef(tree) {
+    return tree;
+}
 // ---------------------------------------------------------------------------
 // Crossfade / blend-in-out metadata (shared by clip and blend-tree states)
 // ---------------------------------------------------------------------------

package/dist/asset-formats/index.d.ts

@@ -1,9 +1,8 @@
 /**
  * The engine's runtime descriptor schemas.
  *
- * WO-8 deleted the `.vscn.json` scene format and everything under
- * `engine/src/scene/`. What survived is here, and each module is here because a
- * real runtime reader still consumes it:
+ * Each module is here because a real runtime READER consumes it — nothing in
+ * this directory exists as documentation of a format:
  *
  * - `material.ts`   — the inline material descriptor `render/material-factory.ts` reads
  * - `mesh.ts`        — the geometry descriptor `render/material-factory.ts`'s `createGeometry` reads
@@ -16,10 +15,8 @@
  * - `tuples.ts`      — the shared Vec3/Quat/Transform tuples the above build on
  *
  * These are DESCRIPTORS, not documents: each names a slice of authored data a
- * render/physics factory reads, and none of them is a scene. They carried a
- * `Scene*` prefix until WO-9 task #6 renamed them to `*Descriptor` — the prefix
- * was a leftover of the deleted `.vscn.json` format, not a statement about what
- * they describe.
+ * render/physics factory reads, and none of them is a scene — which is why
+ * every one of them is named `*Descriptor`.
  */
 export type { CameraDescriptor } from './camera';
 export { CameraDescriptorSchema } from './camera';

package/dist/asset-formats/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/asset-formats/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,YAAY,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AACjD,OAAO,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAC;AAClD,YAAY,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AACtD,YAAY,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAChD,YAAY,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AACtD,YAAY,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAC;AAC7C,OAAO,EAAE,oBAAoB,EAAE,MAAM,QAAQ,CAAC;AAC9C,YAAY,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAC;AACxD,YAAY,EACV,wBAAwB,EACxB,iBAAiB,EACjB,qBAAqB,GACtB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,8BAA8B,EAC9B,uBAAuB,EACvB,2BAA2B,GAC5B,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/asset-formats/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,YAAY,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AACjD,OAAO,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAC;AAClD,YAAY,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AACtD,YAAY,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAChD,YAAY,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AACtD,YAAY,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAC;AAC7C,OAAO,EAAE,oBAAoB,EAAE,MAAM,QAAQ,CAAC;AAC9C,YAAY,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAC;AACxD,YAAY,EACV,wBAAwB,EACxB,iBAAiB,EACjB,qBAAqB,GACtB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,8BAA8B,EAC9B,uBAAuB,EACvB,2BAA2B,GAC5B,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC"}

package/dist/asset-formats/index.js

@@ -1,9 +1,8 @@
 /**
  * The engine's runtime descriptor schemas.
  *
- * WO-8 deleted the `.vscn.json` scene format and everything under
- * `engine/src/scene/`. What survived is here, and each module is here because a
- * real runtime reader still consumes it:
+ * Each module is here because a real runtime READER consumes it — nothing in
+ * this directory exists as documentation of a format:
  *
  * - `material.ts`   — the inline material descriptor `render/material-factory.ts` reads
  * - `mesh.ts`        — the geometry descriptor `render/material-factory.ts`'s `createGeometry` reads
@@ -16,10 +15,8 @@
  * - `tuples.ts`      — the shared Vec3/Quat/Transform tuples the above build on
  *
  * These are DESCRIPTORS, not documents: each names a slice of authored data a
- * render/physics factory reads, and none of them is a scene. They carried a
- * `Scene*` prefix until WO-9 task #6 renamed them to `*Descriptor` — the prefix
- * was a leftover of the deleted `.vscn.json` format, not a statement about what
- * they describe.
+ * render/physics factory reads, and none of them is a scene — which is why
+ * every one of them is named `*Descriptor`.
  */
 export { CameraDescriptorSchema } from './camera';
 export { ColliderDescriptorSchema } from './collider';

package/dist/asset-formats/render-env.d.ts

@@ -2,12 +2,9 @@
  * Render settings — the tone-mapping / post-processing / render-feature scope
  * the engine's renderer setup reads (`setup/setup-renderer.ts`).
  *
- * This used to be the `environment` block of the retired `.vscn.json` scene
- * format (WO-8). The format is gone; these three scopes stayed because
- * `setup-renderer.ts` genuinely reads every field and builds the
- * postprocessing chain from them. Everything that was `.vscn`-only (`skybox`,
- * `fog`, `ambient`, `background`, `envMapIntensity`, `navigation`, `physics`)
- * went with the format.
+ * Exactly THREE scopes, and each is here because `setup-renderer.ts` reads
+ * every one of its fields to build the postprocessing chain. A setting with
+ * no such reader does not belong in this descriptor.
  */
 import { z } from 'zod';
 export declare const ToneMappingDescriptorSchema: z.ZodObject<{
@@ -128,8 +125,8 @@ export declare const PostProcessingDescriptorSchema: z.ZodObject<{
         enabled: z.ZodOptional<z.ZodBoolean>;
         preset: z.ZodOptional<z.ZodEnum<{
             high: "high";
-            low: "low";
             medium: "medium";
+            low: "low";
             ultra: "ultra";
         }>>;
     }, z.core.$strip>>;
@@ -314,8 +311,8 @@ export declare const RenderEnvironmentSchema: z.ZodObject<{
             enabled: z.ZodOptional<z.ZodBoolean>;
             preset: z.ZodOptional<z.ZodEnum<{
                 high: "high";
-                low: "low";
                 medium: "medium";
+                low: "low";
                 ultra: "ultra";
             }>>;
         }, z.core.$strip>>;

package/dist/asset-formats/render-env.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"render-env.d.ts","sourceRoot":"","sources":["../../src/asset-formats/render-env.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,2BAA2B;;;;;;;;;;iBAQC,CAAC;AAE1C,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEhF,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAoRL,CAAC;AAEvC,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC;AAEtF,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAYkC,CAAC;AAEvE,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC"}
+{"version":3,"file":"render-env.d.ts","sourceRoot":"","sources":["../../src/asset-formats/render-env.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,2BAA2B;;;;;;;;;;iBAQC,CAAC;AAE1C,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEhF,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAoRL,CAAC;AAEvC,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC;AAEtF,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAYkC,CAAC;AAEvE,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC"}

package/dist/asset-formats/render-env.js

@@ -2,12 +2,9 @@
  * Render settings — the tone-mapping / post-processing / render-feature scope
  * the engine's renderer setup reads (`setup/setup-renderer.ts`).
  *
- * This used to be the `environment` block of the retired `.vscn.json` scene
- * format (WO-8). The format is gone; these three scopes stayed because
- * `setup-renderer.ts` genuinely reads every field and builds the
- * postprocessing chain from them. Everything that was `.vscn`-only (`skybox`,
- * `fog`, `ambient`, `background`, `envMapIntensity`, `navigation`, `physics`)
- * went with the format.
+ * Exactly THREE scopes, and each is here because `setup-renderer.ts` reads
+ * every one of its fields to build the postprocessing chain. A setting with
+ * no such reader does not belong in this descriptor.
  */
 import { z } from 'zod';
 import { buildRenderingZod } from '../render/render-features';

package/dist/asset-parse-error.d.ts

@@ -7,11 +7,8 @@
  * every caller (currently the input-map loader in `input/input-manager.ts`)
  * does not have to reach into an unrelated subsystem for it.
  *
- * It was called `SceneParseError` until WO-9 task #6. The extraction that gave
- * this file its name deliberately deferred the class rename ("extraction, not
- * redesign"); with `.vscn` gone the old name described nothing — an
- * `.inputmap.json` failure is not a scene failure — so the class and its
- * message header now say `asset`.
+ * The name says ASSET, not scene: an `.inputmap.json` failure is not a scene
+ * failure, and the class covers every structured fetched asset.
  */
 import type { ZodIssue } from 'zod';
 export declare class AssetParseError extends Error {

package/dist/asset-parse-error.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"asset-parse-error.d.ts","sourceRoot":"","sources":["../src/asset-parse-error.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,KAAK,CAAC;AAEpC,qBAAa,eAAgB,SAAQ,KAAK;IACxC,QAAQ,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAC;IAC5B,sEAAsE;IACtE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;gBAE3B,MAAM,EAAE,QAAQ,EAAE,EAAE,QAAQ,CAAC,EAAE,MAAM;CAQlD"}
+{"version":3,"file":"asset-parse-error.d.ts","sourceRoot":"","sources":["../src/asset-parse-error.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,KAAK,CAAC;AAEpC,qBAAa,eAAgB,SAAQ,KAAK;IACxC,QAAQ,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAC;IAC5B,sEAAsE;IACtE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;gBAE3B,MAAM,EAAE,QAAQ,EAAE,EAAE,QAAQ,CAAC,EAAE,MAAM;CAQlD"}

package/dist/asset-parse-error.js

@@ -7,11 +7,8 @@
  * every caller (currently the input-map loader in `input/input-manager.ts`)
  * does not have to reach into an unrelated subsystem for it.
  *
- * It was called `SceneParseError` until WO-9 task #6. The extraction that gave
- * this file its name deliberately deferred the class rename ("extraction, not
- * redesign"); with `.vscn` gone the old name described nothing — an
- * `.inputmap.json` failure is not a scene failure — so the class and its
- * message header now say `asset`.
+ * The name says ASSET, not scene: an `.inputmap.json` failure is not a scene
+ * failure, and the class covers every structured fetched asset.
  */
 export class AssetParseError extends Error {
     issues;

package/dist/audio/bus-mixer.d.ts

@@ -0,0 +1,101 @@
+/**
+ * A named-bus mixer over Web Audio: buses created on demand, routed into each
+ * other by name, and set in DECIBELS.
+ *
+ * Every mixer a game reaches for is this shape — Unity's `AudioMixerGroup`,
+ * Godot's bus layout, FMOD's VCAs, and the `music`/`sfx`/`voice` trio
+ * `setup/setup-audio.ts` hands a first-party three world. What they share is
+ * not the protocol (that part is genuinely per-ecosystem and stays with the
+ * lane that speaks it) but the machinery underneath: a `GainNode` per bus, a
+ * name → node map, a parent to route into, and the one conversion below. This
+ * file owns exactly that, and nothing that names an ecosystem.
+ *
+ * ## dB is not a gain, and the mistake is silent
+ *
+ * `GainNode.gain` is a LINEAR amplitude multiplier; every mixer's authored
+ * volume is logarithmic dB, where 0 dB is unity and −80 dB is silence. Writing
+ * the dB number straight onto `gain.value` gives you a gain of −80 (a phase
+ * inversion at 80x) where the author asked for silence, and it does not throw,
+ * warn, or look wrong in a debugger — it is just loud. {@link dbToLinear} is
+ * the one conversion, `10^(dB/20)`, which is both Godot's `db_to_linear`
+ * (`core/math/math_funcs.h`: `exp(db * 0.11512925464970228…)`, the same
+ * function written in base e) and Unity's mixer volume curve.
+ *
+ * It deliberately does NOT clamp. A mixer's RANGE is protocol — Unity's
+ * exposed parameters saturate at its slider's ends, Godot's `volume_db` does
+ * not — so the lane that knows the range applies it before calling here, and
+ * this file cannot silently mute or silently boost anyone's authored value.
+ *
+ * ## Create-on-demand, and why it is the contract rather than a convenience
+ *
+ * {@link AudioBusMixer.bus} MINTS a bus the first time it is named and returns
+ * the SAME node forever after. The identity is the contract, not the minting:
+ * a source connects to a bus long before anything sets that bus's volume, and
+ * a parent is usually named by its child before anyone asks for it directly
+ * (`bus('music', 'master')` builds `master` too, and the later `bus('master')`
+ * must be that same node). A `bus()` that minted per call would hand the
+ * volume control a SECOND node — the sources would keep feeding the first one,
+ * every later write would land on a node nothing plays through, and nothing
+ * would throw or look wrong. So the map is authoritative, and the only way a
+ * name stops resolving to its node is {@link AudioBusMixer.remove} or
+ * {@link AudioBusMixer.disconnect}.
+ *
+ * A re-ask that names a DIFFERENT parent throws by name. Routing is decided at
+ * creation (the node is already connected by then), so honouring the second
+ * parent would mean silently re-routing live audio and ignoring it would mean
+ * silently keeping the first — a loud error is the only reading that is not a
+ * lie.
+ *
+ * ## RESOURCE OWNERSHIP
+ *
+ * No module-scoped state: {@link createAudioBusMixer} is a factory and the
+ * OWNER of an instance is whoever called it (a `setupAudio` graph, one
+ * translated port's mixer store). What an instance ALLOCATES is one `GainNode`
+ * per named bus, and disconnecting those is the whole of its teardown
+ * obligation — {@link AudioBusMixer.disconnect}, called once by that same
+ * owner. The `context` and the `destination` node are NOT its own: they are
+ * passed in, shared with everything else hanging off the same graph, and this
+ * file never creates, closes, suspends or disconnects either one.
+ */
+/**
+ * The graph an {@link AudioBusMixer} hangs off, as the two members it touches.
+ *
+ * Narrow on purpose: `createGain` is all it needs from the context, so a real
+ * `AudioContext`, an `OfflineAudioContext` and a headless stand-in are all
+ * acceptable without a cast.
+ */
+export interface AudioBusMixerOptions {
+    readonly context: {
+        createGain(): GainNode;
+    };
+    /** The node every parentless bus feeds. Usually a master gain or the context's destination. */
+    readonly destination: AudioNode;
+}
+export interface AudioBusMixer {
+    /**
+     * The bus named `name`, created on the first ask and connected to `parent`
+     * (itself created on demand) or to the destination.
+     *
+     * The returned node is the real `GainNode` — set `gain.value`, schedule
+     * automation on `gain`, connect sources to it. Nothing here stands between a
+     * caller and Web Audio's own API.
+     */
+    bus(name: string, parent?: string): GainNode;
+    /** The bus named `name` if it EXISTS, else null. Never mints one. */
+    find(name: string): GainNode | null;
+    /** Set this bus's gain from decibels, creating it if absent. Clamp before calling — see the header. */
+    setDb(name: string, db: number, parent?: string): void;
+    /**
+     * Disconnect one bus and forget its name, so a later {@link bus} mints a
+     * fresh node. Buses that named it as their parent are NOT re-routed — they
+     * keep feeding the removed node, which now reaches nothing.
+     */
+    remove(name: string): void;
+    /** Disconnect every bus and forget them all. The owner's ONE teardown. */
+    disconnect(): void;
+}
+/** dB → linear amplitude: `10^(dB/20)`. 0 dB is 1, −6 dB is ~0.5, −80 dB is ~0.0001. Never clamps. */
+export declare function dbToLinear(db: number): number;
+/** Create one named-bus mixer. See the header for what owns the instance and what it allocates. */
+export declare function createAudioBusMixer(options: AudioBusMixerOptions): AudioBusMixer;
+//# sourceMappingURL=bus-mixer.d.ts.map

package/dist/audio/bus-mixer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bus-mixer.d.ts","sourceRoot":"","sources":["../../src/audio/bus-mixer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0DG;AAEH;;;;;;GAMG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,OAAO,EAAE;QAAE,UAAU,IAAI,QAAQ,CAAA;KAAE,CAAC;IAC7C,+FAA+F;IAC/F,QAAQ,CAAC,WAAW,EAAE,SAAS,CAAC;CACjC;AAED,MAAM,WAAW,aAAa;IAC5B;;;;;;;OAOG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC;IAC7C,qEAAqE;IACrE,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAAC;IACpC,uGAAuG;IACvG,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvD;;;;OAIG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,0EAA0E;IAC1E,UAAU,IAAI,IAAI,CAAC;CACpB;AAED,sGAAsG;AACtG,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAE7C;AAeD,mGAAmG;AACnG,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,oBAAoB,GAAG,aAAa,CA4ChF"}

package/dist/audio/bus-mixer.js

@@ -0,0 +1,115 @@
+/**
+ * A named-bus mixer over Web Audio: buses created on demand, routed into each
+ * other by name, and set in DECIBELS.
+ *
+ * Every mixer a game reaches for is this shape — Unity's `AudioMixerGroup`,
+ * Godot's bus layout, FMOD's VCAs, and the `music`/`sfx`/`voice` trio
+ * `setup/setup-audio.ts` hands a first-party three world. What they share is
+ * not the protocol (that part is genuinely per-ecosystem and stays with the
+ * lane that speaks it) but the machinery underneath: a `GainNode` per bus, a
+ * name → node map, a parent to route into, and the one conversion below. This
+ * file owns exactly that, and nothing that names an ecosystem.
+ *
+ * ## dB is not a gain, and the mistake is silent
+ *
+ * `GainNode.gain` is a LINEAR amplitude multiplier; every mixer's authored
+ * volume is logarithmic dB, where 0 dB is unity and −80 dB is silence. Writing
+ * the dB number straight onto `gain.value` gives you a gain of −80 (a phase
+ * inversion at 80x) where the author asked for silence, and it does not throw,
+ * warn, or look wrong in a debugger — it is just loud. {@link dbToLinear} is
+ * the one conversion, `10^(dB/20)`, which is both Godot's `db_to_linear`
+ * (`core/math/math_funcs.h`: `exp(db * 0.11512925464970228…)`, the same
+ * function written in base e) and Unity's mixer volume curve.
+ *
+ * It deliberately does NOT clamp. A mixer's RANGE is protocol — Unity's
+ * exposed parameters saturate at its slider's ends, Godot's `volume_db` does
+ * not — so the lane that knows the range applies it before calling here, and
+ * this file cannot silently mute or silently boost anyone's authored value.
+ *
+ * ## Create-on-demand, and why it is the contract rather than a convenience
+ *
+ * {@link AudioBusMixer.bus} MINTS a bus the first time it is named and returns
+ * the SAME node forever after. The identity is the contract, not the minting:
+ * a source connects to a bus long before anything sets that bus's volume, and
+ * a parent is usually named by its child before anyone asks for it directly
+ * (`bus('music', 'master')` builds `master` too, and the later `bus('master')`
+ * must be that same node). A `bus()` that minted per call would hand the
+ * volume control a SECOND node — the sources would keep feeding the first one,
+ * every later write would land on a node nothing plays through, and nothing
+ * would throw or look wrong. So the map is authoritative, and the only way a
+ * name stops resolving to its node is {@link AudioBusMixer.remove} or
+ * {@link AudioBusMixer.disconnect}.
+ *
+ * A re-ask that names a DIFFERENT parent throws by name. Routing is decided at
+ * creation (the node is already connected by then), so honouring the second
+ * parent would mean silently re-routing live audio and ignoring it would mean
+ * silently keeping the first — a loud error is the only reading that is not a
+ * lie.
+ *
+ * ## RESOURCE OWNERSHIP
+ *
+ * No module-scoped state: {@link createAudioBusMixer} is a factory and the
+ * OWNER of an instance is whoever called it (a `setupAudio` graph, one
+ * translated port's mixer store). What an instance ALLOCATES is one `GainNode`
+ * per named bus, and disconnecting those is the whole of its teardown
+ * obligation — {@link AudioBusMixer.disconnect}, called once by that same
+ * owner. The `context` and the `destination` node are NOT its own: they are
+ * passed in, shared with everything else hanging off the same graph, and this
+ * file never creates, closes, suspends or disconnects either one.
+ */
+/** dB → linear amplitude: `10^(dB/20)`. 0 dB is 1, −6 dB is ~0.5, −80 dB is ~0.0001. Never clamps. */
+export function dbToLinear(db) {
+    return 10 ** (db / 20);
+}
+function safeDisconnect(node) {
+    try {
+        node.disconnect();
+    }
+    catch {
+        // already disconnected
+    }
+}
+/** Create one named-bus mixer. See the header for what owns the instance and what it allocates. */
+export function createAudioBusMixer(options) {
+    const { context, destination } = options;
+    const buses = new Map();
+    function bus(name, parent) {
+        const existing = buses.get(name);
+        if (existing !== undefined) {
+            if (parent !== undefined && parent !== existing.parent) {
+                throw new Error(`audio bus ${JSON.stringify(name)} already routes into ` +
+                    `${existing.parent === undefined ? 'the destination' : JSON.stringify(existing.parent)}` +
+                    `; it cannot also route into ${JSON.stringify(parent)}. Routing is decided when a bus ` +
+                    'is created (see packages/engine/src/audio/bus-mixer.ts).');
+            }
+            return existing.node;
+        }
+        // The parent is resolved (and minted, recursively) before this bus is
+        // seated, so a conflicting-parent throw upstream leaves nothing half-built.
+        const into = parent === undefined ? destination : bus(parent);
+        const node = context.createGain();
+        node.gain.value = 1;
+        node.connect(into);
+        buses.set(name, { node, parent });
+        return node;
+    }
+    return {
+        bus,
+        find: (name) => buses.get(name)?.node ?? null,
+        setDb: (name, db, parent) => {
+            bus(name, parent).gain.value = dbToLinear(db);
+        },
+        remove: (name) => {
+            const record = buses.get(name);
+            if (record === undefined)
+                return;
+            buses.delete(name);
+            safeDisconnect(record.node);
+        },
+        disconnect: () => {
+            for (const record of buses.values())
+                safeDisconnect(record.node);
+            buses.clear();
+        },
+    };
+}

package/dist/core/frame-pacing.d.ts

@@ -1,6 +1,6 @@
 /**
  * Frame pacing — the accumulator/alpha arithmetic of the fixed-timestep loop,
- * extracted PURE (WO-P13, `docs/WORK.md` §2 P13).
+ * extracted PURE.
  *
  * `core/game-loop.ts` owns the browser side (rAF, `visibilitychange`,
  * `performance.now`); this module owns the arithmetic, so the interesting

package/dist/core/frame-pacing.js

@@ -1,6 +1,6 @@
 /**
  * Frame pacing — the accumulator/alpha arithmetic of the fixed-timestep loop,
- * extracted PURE (WO-P13, `docs/WORK.md` §2 P13).
+ * extracted PURE.
  *
  * `core/game-loop.ts` owns the browser side (rAF, `visibilitychange`,
  * `performance.now`); this module owns the arithmetic, so the interesting
@@ -72,7 +72,7 @@ export function paceFrame(accumulator, rawDt, timeScale, limits) {
     // Also the accumulator's hard ceiling (see the spiral-of-death clamp below).
     const maxAccumulator = fixedDt * maxSubSteps;
     // Clamp large frame gaps (a slow frame, a debugger pause) BEFORE scaling by
-    // timeScale — unchanged from the pre-WO-P13 loop.
+    // timeScale.
     const displayDt = Math.min(rawDt, maxAccumulator) * timeScale;
     let next = accumulator + displayDt;
     // Spiral-of-death guard: bound the accumulator regardless of timeScale or

package/dist/core/game-loop.d.ts

@@ -1,9 +1,7 @@
 import type { GameLoopConfig, GameLoopLiveness } from './types';
 /**
  * Fixed-timestep game loop with accumulator pattern — SIM at a fixed rate,
- * PRESENTATION at the display's rate (WO-P13, `docs/WORK.md` §2 P13, which
- * flipped the former D1 "render is fixed-rate too" decision this comment used
- * to state).
+ * PRESENTATION at the display's rate.
  *
  * Per real (rAF) frame:
  *

package/dist/core/game-loop.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"game-loop.d.ts","sourceRoot":"","sources":["../../src/core/game-loop.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAQhE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,cAAc;;;;IAuIjD;;;;;;;;;;;;OAYG;uBACa,gBAAgB;eASX,MAAM;IAe3B;;;;;;;OAOG;;EAKN"}
+{"version":3,"file":"game-loop.d.ts","sourceRoot":"","sources":["../../src/core/game-loop.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAQhE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,cAAc;;;;IAuIjD;;;;;;;;;;;;OAYG;uBACa,gBAAgB;eASX,MAAM;IAe3B;;;;;;;OAOG;;EAKN"}

package/dist/core/game-loop.js

@@ -6,9 +6,7 @@ import { clampTimeScale, paceFrame, TIME_SCALE_RANGE } from './frame-pacing';
 const LOOP_STARVATION_MS = 1_000;
 /**
  * Fixed-timestep game loop with accumulator pattern — SIM at a fixed rate,
- * PRESENTATION at the display's rate (WO-P13, `docs/WORK.md` §2 P13, which
- * flipped the former D1 "render is fixed-rate too" decision this comment used
- * to state).
+ * PRESENTATION at the display's rate.
  *
  * Per real (rAF) frame:
  *

package/dist/core/seeded-random.d.ts

@@ -36,7 +36,7 @@ export declare const GAMEPLAY_STREAM = "gameplay";
  *  `determinism.seededRandom` is declared, per T4.1's "no dead field" rule). */
 export declare const DEFAULT_SEEDED_RANDOM_SEED = 2654435769;
 /**
- * The `ctx.random` surface (`GameContext.random`, `runtime/types.ts`).
+ * A game-scoped random surface.
  * Callable (draws from the `'gameplay'` stream), plus:
  * - `stream(name)` — an independent named generator, `[0, 1)` floats, same
  *   call signature as `Math.random`/the bare `SeededRandom` call itself.

package/dist/core/sim-clock.d.ts

@@ -93,10 +93,9 @@
  * controller cancels everything a `setup()` scheduled:
  *
  * ```ts
- * export async function setup(ctx: GameContext): Promise<GameCleanup> {
- *   const ac = new AbortController();
- *   ctx.clock.after(3, () => spawnWave(), { signal: ac.signal });
- *   return { dispose: () => ac.abort() }; // cancels timers AND listeners
+ * const ac = new AbortController();
+ * clock.after(3, () => spawnWave(), { signal: ac.signal });
+ * // on dispose: ac.abort() — cancels timers AND listeners
  * }
  * ```
  *
@@ -164,7 +163,7 @@ export interface SimClock {
 /**
  * The runtime-facing half — NOT for game code. Split off the public
  * {@link SimClock} the same way `runtime/game.ts` splits `GameInternal` off
- * `Game`: `GameContext.clock` is typed as `SimClock`, so game code cannot
+ * `Game`: game code only ever sees the public `SimClock`, so it cannot
  * reach `flush`/`dispose`.
  */
 export interface SimClockInternal extends SimClock {
@@ -205,7 +204,7 @@ export declare function registerSimClock(owner: object, clock: SimClockInternal)
  *  Returns the INTERNAL view because this registry is engine-only — but a
  *  caller that RESOLVES a clock here is not its owner and must not call
  *  `dispose()` on it (module header, ownership). Game code never reaches it at
- *  all: `GameContext.clock` is typed as the public {@link SimClock}, which has
+ *  all: it only ever sees the public {@link SimClock}, which has
  *  neither `flush` nor `dispose`, the same way `Game` hides `GameInternal`. */
 export declare function getSimClock(owner: object): SimClockInternal | null;
 //# sourceMappingURL=sim-clock.d.ts.map

package/dist/core/sim-clock.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sim-clock.d.ts","sourceRoot":"","sources":["../../src/core/sim-clock.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6HG;AAEH,OAAO,KAAK,KAAK,KAAK,MAAM,OAAO,CAAC;AAGpC,sFAAsF;AACtF,MAAM,WAAW,cAAc;IAC7B,4DAA4D;IAC5D,MAAM,IAAI,IAAI,CAAC;CAChB;AAED,iDAAiD;AACjD,MAAM,WAAW,kBAAkB;IACjC,8EAA8E;IAC9E,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;CAC3C;AAED,qEAAqE;AACrE,MAAM,WAAW,QAAQ;IACvB,wEAAwE;IACxE,GAAG,IAAI,MAAM,CAAC;IACd,2EAA2E;IAC3E,OAAO,IAAI,MAAM,CAAC;IAClB;;;;;OAKG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjE;;;OAGG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,IAAI,EAAE,IAAI,CAAC,EAAE,kBAAkB,GAAG,cAAc,CAAC;IAClF;;;;;OAKG;IACH,YAAY,CAAC,GAAG,EAAE,KAAK,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,GAAG,cAAc,CAAC;CACpE;AAED;;;;;GAKG;AACH,MAAM,WAAW,gBAAiB,SAAQ,QAAQ;IAChD;;;;;OAKG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B;;;;;OAKG;IACH,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B;;;;OAIG;IACH,QAAQ,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,KAAK,CAAC,QAAQ,KAAK,IAAI,CAAC;CACjD;AAyBD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,eAAe,GAAG,gBAAgB,CAiJzE;AAWD,mFAAmF;AACnF,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,gBAAgB,GAAG,IAAI,CAE7E;AAED;;;;;;;;+EAQ+E;AAC/E,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI,CAElE"}
+{"version":3,"file":"sim-clock.d.ts","sourceRoot":"","sources":["../../src/core/sim-clock.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4HG;AAEH,OAAO,KAAK,KAAK,KAAK,MAAM,OAAO,CAAC;AAGpC,sFAAsF;AACtF,MAAM,WAAW,cAAc;IAC7B,4DAA4D;IAC5D,MAAM,IAAI,IAAI,CAAC;CAChB;AAED,iDAAiD;AACjD,MAAM,WAAW,kBAAkB;IACjC,8EAA8E;IAC9E,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;CAC3C;AAED,qEAAqE;AACrE,MAAM,WAAW,QAAQ;IACvB,wEAAwE;IACxE,GAAG,IAAI,MAAM,CAAC;IACd,2EAA2E;IAC3E,OAAO,IAAI,MAAM,CAAC;IAClB;;;;;OAKG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjE;;;OAGG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,IAAI,EAAE,IAAI,CAAC,EAAE,kBAAkB,GAAG,cAAc,CAAC;IAClF;;;;;OAKG;IACH,YAAY,CAAC,GAAG,EAAE,KAAK,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,GAAG,cAAc,CAAC;CACpE;AAED;;;;;GAKG;AACH,MAAM,WAAW,gBAAiB,SAAQ,QAAQ;IAChD;;;;;OAKG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B;;;;;OAKG;IACH,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B;;;;OAIG;IACH,QAAQ,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,KAAK,CAAC,QAAQ,KAAK,IAAI,CAAC;CACjD;AAyBD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,eAAe,GAAG,gBAAgB,CAiJzE;AAWD,mFAAmF;AACnF,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,gBAAgB,GAAG,IAAI,CAE7E;AAED;;;;;;;;+EAQ+E;AAC/E,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI,CAElE"}

package/dist/core/sim-clock.js

@@ -93,10 +93,9 @@
  * controller cancels everything a `setup()` scheduled:
  *
  * ```ts
- * export async function setup(ctx: GameContext): Promise<GameCleanup> {
- *   const ac = new AbortController();
- *   ctx.clock.after(3, () => spawnWave(), { signal: ac.signal });
- *   return { dispose: () => ac.abort() }; // cancels timers AND listeners
+ * const ac = new AbortController();
+ * clock.after(3, () => spawnWave(), { signal: ac.signal });
+ * // on dispose: ac.abort() — cancels timers AND listeners
  * }
  * ```
  *
@@ -297,7 +296,7 @@ export function registerSimClock(owner, clock) {
  *  Returns the INTERNAL view because this registry is engine-only — but a
  *  caller that RESOLVES a clock here is not its owner and must not call
  *  `dispose()` on it (module header, ownership). Game code never reaches it at
- *  all: `GameContext.clock` is typed as the public {@link SimClock}, which has
+ *  all: it only ever sees the public {@link SimClock}, which has
  *  neither `flush` nor `dispose`, the same way `Game` hides `GameInternal`. */
 export function getSimClock(owner) {
     return clockByOwner.get(owner) ?? null;

package/dist/core/types.d.ts

@@ -56,9 +56,7 @@ export interface GameLoopConfig {
      */
     update: (dt: number) => void;
     /**
-     * Called EXACTLY ONCE per real (rAF) frame — the PRESENTATION half
-     * (WO-P13, `docs/WORK.md` §2 P13; this is the callback whose absence the
-     * former D1 decision recorded).
+     * Called EXACTLY ONCE per real (rAF) frame — the PRESENTATION half.
      *
      * - `alpha` — `accumulator / fixedDt` after this frame's substeps were
      *   consumed, in `[0, 1]`: how far presentation sits past the last

package/dist/core/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,WAAW;;;;;;;;;CASd,CAAC;AAEX,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,OAAO,WAAW,CAAC,CAAC;AAE7E,+BAA+B;AAC/B,eAAO,MAAM,WAAW,EAAE,eAAe,EASxC,CAAC;AAEF,wDAAwD;AACxD,MAAM,MAAM,QAAQ,GAAG,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;AAE5C,MAAM,WAAW,aAAa;IAC5B,gEAAgE;IAChE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,iBAAiB;IAChC,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACvE,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACtE;AAED,yDAAyD;AACzD,MAAM,WAAW,SAAS;IACxB,uEAAuE;IACvE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,8CAA8C;IAC9C,KAAK,EAAE,eAAe,CAAC;IACvB,4EAA4E;IAC5E,IAAI,CAAC,IAAI,IAAI,CAAC;IACd,uBAAuB;IACvB,MAAM,EAAE,QAAQ,CAAC;IACjB,8DAA8D;IAC9D,OAAO,CAAC,IAAI,IAAI,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,gDAAgD;IAChD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,6EAA6E;IAC7E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;;;;;;;OAUG;IACH,MAAM,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B;;;;;;;;;;;;;;OAcG;IACH,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IACpD;;;;;;;;;;OAUG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,cAAc,GAAG,SAAS,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,WAAW;;;;;;;;;CASd,CAAC;AAEX,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,OAAO,WAAW,CAAC,CAAC;AAE7E,+BAA+B;AAC/B,eAAO,MAAM,WAAW,EAAE,eAAe,EASxC,CAAC;AAEF,wDAAwD;AACxD,MAAM,MAAM,QAAQ,GAAG,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;AAE5C,MAAM,WAAW,aAAa;IAC5B,gEAAgE;IAChE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,iBAAiB;IAChC,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACvE,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACtE;AAED,yDAAyD;AACzD,MAAM,WAAW,SAAS;IACxB,uEAAuE;IACvE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,8CAA8C;IAC9C,KAAK,EAAE,eAAe,CAAC;IACvB,4EAA4E;IAC5E,IAAI,CAAC,IAAI,IAAI,CAAC;IACd,uBAAuB;IACvB,MAAM,EAAE,QAAQ,CAAC;IACjB,8DAA8D;IAC9D,OAAO,CAAC,IAAI,IAAI,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,gDAAgD;IAChD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,6EAA6E;IAC7E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;;;;;;;OAUG;IACH,MAAM,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IACpD;;;;;;;;;;OAUG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,cAAc,GAAG,SAAS,CAAC"}

package/dist/defaults.d.ts

@@ -1,20 +1,12 @@
 /**
  * Single source of truth for default values the engine's factories read.
  *
- * WO-8 deleted SEVEN groups — `transform`, `entity`, `audio`, `shadow`,
- * `animation`, `fog`, `environment` — because every one of their readers was a
- * `.vscn.json` consumer (`entity-factory.ts`, `scene-loader.ts`,
- * `scene-sync.ts`, `scene-serializer.ts`, the per-section inspectors) and
- * `defaults-source-scan.test.ts` reported them with ZERO `DEFAULTS.<group>`
- * readers anywhere in engine/editor src or tests. That guard offers two remedies
- * — wire the group to the factory that reads it, or delete it if truly unused —
- * and there is no surviving factory to wire these to: `transform` restated
- * THREE's own Object3D constructor values, `entity.locked`/ `pivot` were
- * descriptor-only fields, and `fog`/`environment.envMapIntensity`/ `shadow` were
- * the `.vscn` `environment` block that `render-env.ts` explicitly did NOT carry
- * forward. Keeping them would have been exactly the dead documentation T1.13
- * created this guard to prevent.
- *
+ * A group belongs here only while a FACTORY reads it. A default with no
+ * reader is dead documentation: it looks authoritative, nothing consults it,
+ * and it drifts from the value the code actually uses. Restating a library's
+ * own constructor values (THREE's `Object3D` transform, say) is the same
+ * mistake in a different shape — the library is already the source of truth.
+ * So when a factory goes, its group goes with it.
  */
 export declare const DEFAULTS: {
     readonly material: {

package/dist/defaults.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../src/defaults.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gDAkB0B,CAAC,MAAM,EAAE,MAAM,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;kCA6BjB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6E5D,CAAC"}
+{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../src/defaults.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gDAkB0B,CAAC,MAAM,EAAE,MAAM,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;kCA6BjB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6E5D,CAAC"}

package/dist/defaults.js

@@ -1,20 +1,12 @@
 /**
  * Single source of truth for default values the engine's factories read.
  *
- * WO-8 deleted SEVEN groups — `transform`, `entity`, `audio`, `shadow`,
- * `animation`, `fog`, `environment` — because every one of their readers was a
- * `.vscn.json` consumer (`entity-factory.ts`, `scene-loader.ts`,
- * `scene-sync.ts`, `scene-serializer.ts`, the per-section inspectors) and
- * `defaults-source-scan.test.ts` reported them with ZERO `DEFAULTS.<group>`
- * readers anywhere in engine/editor src or tests. That guard offers two remedies
- * — wire the group to the factory that reads it, or delete it if truly unused —
- * and there is no surviving factory to wire these to: `transform` restated
- * THREE's own Object3D constructor values, `entity.locked`/ `pivot` were
- * descriptor-only fields, and `fog`/`environment.envMapIntensity`/ `shadow` were
- * the `.vscn` `environment` block that `render-env.ts` explicitly did NOT carry
- * forward. Keeping them would have been exactly the dead documentation T1.13
- * created this guard to prevent.
- *
+ * A group belongs here only while a FACTORY reads it. A default with no
+ * reader is dead documentation: it looks authoritative, nothing consults it,
+ * and it drifts from the value the code actually uses. Restating a library's
+ * own constructor values (THREE's `Object3D` transform, say) is the same
+ * mistake in a different shape — the library is already the source of truth.
+ * So when a factory goes, its group goes with it.
  */
 export const DEFAULTS = {
     material: {