@vgai/engine 0.5.4 → 0.5.6

package/dist/adapter/authoring.d.ts.map

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

package/dist/adapter/authoring.js

@@ -0,0 +1,22 @@
+/**
+ * AuthoringAdapter — the editor's authoring contract. The editor talks to THIS,
+ * keyed by opaque string node ids, instead of to a concrete document format.
+ *
+ * `.vscn` / `SceneEntity` is the private model of ONE implementer
+ * (`VgaiSceneAuthoringAdapter`); an ingested game's adapter implements the same
+ * providers directly over its live `Object3D` tree. The editor sees only the
+ * interface and the advertised `capabilities` — it never branches on which
+ * implementer it is talking to.
+ *
+ * The interface lives in the engine (not the editor) so `MountedThreeRoot.authoring`
+ * can reference it without the engine depending on the editor; implementers live
+ * in `packages/editor/src/authoring/`.
+ *
+ * **Reserved inspector paths convention:** the property paths `name`, `visible`,
+ * and `locked` are reserved — an adapter that supports them exposes them through
+ * the ordinary `InspectorProvider.get`/`set` (no separate provider). The shell
+ * renders the hierarchy panel's rename field, eye (visibility) toggle, and lock
+ * toggle against these three paths, generically, for any adapter that reports
+ * them via `InspectorProvider.properties`.
+ */
+export {};

package/dist/adapter/colyseus-networking-adapter.d.ts

@@ -0,0 +1,77 @@
+/**
+ * ColyseusNetworkingAdapter — the first-party `NetworkingAdapter`. This is an
+ * INTROSPECTION / coordination boundary, NOT a transport: it lets the editor ask
+ * "is this object replicated, who owns it, may I edit it" — and, for the network
+ * inspector panel, "am I connected, to which room, how much replication activity
+ * is happening" — without owning Colyseus.
+ *
+ * It is parameterized by accessors over the room state (rather than a fixed schema)
+ * so any Colyseus room can supply one: map an `Object3D` to its network id + owner,
+ * report the local session and peers, and report connection/room/stats for the
+ * inspector. The editor uses `authority`/`editable` to keep remote/server-
+ * authoritative objects inspect-only (editing a replicated transform locally is
+ * meaningless — the server overwrites it next snapshot).
+ */
+import type * as THREE from 'three';
+import type { ConnectionState, NetConditioning, NetMessageEvent, NetPeer, NetPlayerIdentity, NetRates, NetworkingAdapter, ReplicationStats, RoomInfo, Unsubscribe } from './system-adapter';
+export interface ColyseusNetworkingConfig {
+    /** The local peer's session id (objects it owns are editable). */
+    localSessionId(): string | null;
+    /** Peers currently in the room. */
+    peers(): NetPeer[];
+    /**
+     * The game's own `id → Object3D` map (P-4). The SEAM
+     * (`NetworkingAdapter`) is keyed by node id so a non-three world can
+     * implement it at all; the accessors below stay `Object3D`-keyed because a
+     * three game already thinks in objects. This one member is the bridge, and
+     * it is the game's to declare — the engine never guesses an identity
+     * convention on a game's behalf. Returning `null` means "no such node here",
+     * and every accessor degrades exactly as it does for an unreplicated object.
+     */
+    resolve(nodeId: string): THREE.Object3D | null;
+    /** Network id for an object, or null if it is not replicated (→ local authored). */
+    networkId(o: THREE.Object3D): string | null;
+    /** Owning peer/session id for a replicated object (null = server-owned). */
+    ownerId(o: THREE.Object3D): string | null;
+    /** True if the server is authoritative over this object (→ inspect-only). */
+    serverAuthoritative?(o: THREE.Object3D): boolean;
+    /** Current connection lifecycle state, for the network inspector panel.
+     *  Optional — defaults to `'disconnected'` for implementers that only need
+     *  object authority/editability (the pre-inspector config shape). */
+    connectionState?(): ConnectionState;
+    /** The active room's identity, or `null` when not connected to a room.
+     *  Optional — defaults to `null`. */
+    roomInfo?(): RoomInfo | null;
+    /** Replication activity snapshot (entity count + msg rates), for the inspector.
+     *  Optional — defaults to all-zero stats. */
+    replicationStats?(): ReplicationStats;
+    /** Subscribe to changes in connection state / room / replication stats.
+     *  Optional — defaults to a no-op subscription. */
+    subscribe?(cb: () => void): Unsubscribe;
+    /** Optional CAPABILITY: plain-data replicated-state snapshot (Colyseus
+     *  `state.toJSON()`), for the inspector's state tree (W3b). Unlike the
+     *  defaulted accessors above, this and the remaining optional accessors
+     *  propagate their ABSENCE to the built adapter — a config that omits one
+     *  yields an adapter without that method, so the inspector marks the
+     *  section absent instead of rendering fabricated empties. */
+    stateSnapshot?(): unknown;
+    /** Optional capability: message-log events with `seq > sinceSeq`. */
+    messageEvents?(sinceSeq?: number): NetMessageEvent[];
+    /** Optional capability: msg + byte rates for the inspector sparklines. */
+    rates?(): NetRates;
+    /** Optional capability pair: link conditioning at the adapter seam. Both
+     *  must be supplied together for the inspector to show the controls. */
+    getConditioning?(): NetConditioning;
+    setConditioning?(c: NetConditioning): void;
+    /** Optional capability: read the local player's identity off the game's own
+     *  room state (→ adapter `getPlayerIdentity`, a seat label). Independent of
+     *  the setter below — a game can expose a read-only identity. */
+    playerIdentity?(): NetPlayerIdentity | undefined;
+    /** Optional capability: set the local player's identity through the game's own
+     *  mechanism (→ adapter `setPlayerIdentity`, an editable name field). Present
+     *  only when the game supports a settable name; drives the game's real path
+     *  (a join option the server honours, a rename message, …). */
+    setPlayerIdentity?(identity: NetPlayerIdentity): void | Promise<void>;
+}
+export declare function createColyseusNetworkingAdapter(cfg: ColyseusNetworkingConfig): NetworkingAdapter;
+//# sourceMappingURL=colyseus-networking-adapter.d.ts.map

package/dist/adapter/colyseus-networking-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"colyseus-networking-adapter.d.ts","sourceRoot":"","sources":["../../src/adapter/colyseus-networking-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,KAAK,KAAK,MAAM,OAAO,CAAC;AACpC,OAAO,KAAK,EACV,eAAe,EACf,eAAe,EACf,eAAe,EACf,OAAO,EACP,iBAAiB,EACjB,QAAQ,EACR,iBAAiB,EACjB,gBAAgB,EAChB,QAAQ,EACR,WAAW,EACZ,MAAM,kBAAkB,CAAC;AAE1B,MAAM,WAAW,wBAAwB;IACvC,kEAAkE;IAClE,cAAc,IAAI,MAAM,GAAG,IAAI,CAAC;IAChC,mCAAmC;IACnC,KAAK,IAAI,OAAO,EAAE,CAAC;IACnB;;;;;;;;OAQG;IACH,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,KAAK,CAAC,QAAQ,GAAG,IAAI,CAAC;IAC/C,oFAAoF;IACpF,SAAS,CAAC,CAAC,EAAE,KAAK,CAAC,QAAQ,GAAG,MAAM,GAAG,IAAI,CAAC;IAC5C,4EAA4E;IAC5E,OAAO,CAAC,CAAC,EAAE,KAAK,CAAC,QAAQ,GAAG,MAAM,GAAG,IAAI,CAAC;IAC1C,6EAA6E;IAC7E,mBAAmB,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,QAAQ,GAAG,OAAO,CAAC;IACjD;;yEAEqE;IACrE,eAAe,CAAC,IAAI,eAAe,CAAC;IACpC;yCACqC;IACrC,QAAQ,CAAC,IAAI,QAAQ,GAAG,IAAI,CAAC;IAC7B;iDAC6C;IAC7C,gBAAgB,CAAC,IAAI,gBAAgB,CAAC;IACtC;uDACmD;IACnD,SAAS,CAAC,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,WAAW,CAAC;IACxC;;;;;kEAK8D;IAC9D,aAAa,CAAC,IAAI,OAAO,CAAC;IAC1B,qEAAqE;IACrE,aAAa,CAAC,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,eAAe,EAAE,CAAC;IACrD,0EAA0E;IAC1E,KAAK,CAAC,IAAI,QAAQ,CAAC;IACnB;4EACwE;IACxE,eAAe,CAAC,IAAI,eAAe,CAAC;IACpC,eAAe,CAAC,CAAC,CAAC,EAAE,eAAe,GAAG,IAAI,CAAC;IAC3C;;qEAEiE;IACjE,cAAc,CAAC,IAAI,iBAAiB,GAAG,SAAS,CAAC;IACjD;;;mEAG+D;IAC/D,iBAAiB,CAAC,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACvE;AAED,wBAAgB,+BAA+B,CAAC,GAAG,EAAE,wBAAwB,GAAG,iBAAiB,CAuDhG"}

package/dist/adapter/colyseus-networking-adapter.js

@@ -0,0 +1,76 @@
+/**
+ * ColyseusNetworkingAdapter — the first-party `NetworkingAdapter`. This is an
+ * INTROSPECTION / coordination boundary, NOT a transport: it lets the editor ask
+ * "is this object replicated, who owns it, may I edit it" — and, for the network
+ * inspector panel, "am I connected, to which room, how much replication activity
+ * is happening" — without owning Colyseus.
+ *
+ * It is parameterized by accessors over the room state (rather than a fixed schema)
+ * so any Colyseus room can supply one: map an `Object3D` to its network id + owner,
+ * report the local session and peers, and report connection/room/stats for the
+ * inspector. The editor uses `authority`/`editable` to keep remote/server-
+ * authoritative objects inspect-only (editing a replicated transform locally is
+ * meaningless — the server overwrites it next snapshot).
+ */
+export function createColyseusNetworkingAdapter(cfg) {
+    const adapter = {
+        peers: () => cfg.peers(),
+        // The seam speaks node ids; `cfg.resolve` is the one crossing into Three's
+        // vocabulary. An unresolvable id behaves exactly like an unreplicated
+        // object — local authority, editable — rather than throwing or fabricating.
+        networkId: (nodeId) => {
+            const o = cfg.resolve(nodeId);
+            return o ? cfg.networkId(o) : null;
+        },
+        authority: (nodeId) => {
+            const o = cfg.resolve(nodeId);
+            if (!o || cfg.networkId(o) == null)
+                return 'local'; // not replicated → local authored
+            if (cfg.serverAuthoritative?.(o))
+                return 'server';
+            return cfg.ownerId(o) === cfg.localSessionId() ? 'local' : 'remote';
+        },
+        editable: (nodeId) => {
+            const o = cfg.resolve(nodeId);
+            if (!o || cfg.networkId(o) == null)
+                return true; // local authored object
+            if (cfg.serverAuthoritative?.(o))
+                return false; // server owns it → inspect-only
+            return cfg.ownerId(o) === cfg.localSessionId(); // only your own peer's objects
+        },
+        getConnectionState: () => cfg.connectionState?.() ?? 'disconnected',
+        getRoomInfo: () => cfg.roomInfo?.() ?? null,
+        getReplicationStats: () => cfg.replicationStats?.() ?? { entities: 0, msgsInPerSec: 0, msgsOutPerSec: 0 },
+        subscribe: (cb) => cfg.subscribe?.(cb) ?? (() => { }),
+    };
+    // The W3b inspector capabilities attach ONLY when supplied: their absence
+    // is the editor's degradation signal (`getStateSnapshot` in adapter ⇒ tree,
+    // missing ⇒ "not provided by this adapter" — never a fabricated empty).
+    const stateSnapshot = cfg.stateSnapshot?.bind(cfg);
+    if (stateSnapshot)
+        adapter.getStateSnapshot = () => stateSnapshot();
+    const messageEvents = cfg.messageEvents?.bind(cfg);
+    if (messageEvents)
+        adapter.messageEvents = (sinceSeq) => messageEvents(sinceSeq);
+    const rates = cfg.rates?.bind(cfg);
+    if (rates)
+        adapter.getRates = () => rates();
+    const getConditioning = cfg.getConditioning?.bind(cfg);
+    const setConditioning = cfg.setConditioning?.bind(cfg);
+    if (getConditioning && setConditioning) {
+        adapter.getConditioning = () => getConditioning();
+        adapter.setConditioning = (c) => setConditioning(c);
+    }
+    // Identity read and write are INDEPENDENTLY optional: a game may expose a
+    // read-only seat label (identity, no setter) or a settable name (both). The
+    // editor shows an editable field only when `setPlayerIdentity` is present.
+    const playerIdentity = cfg.playerIdentity?.bind(cfg);
+    if (playerIdentity) {
+        adapter.getPlayerIdentity = () => playerIdentity() ?? {};
+    }
+    const setPlayerIdentity = cfg.setPlayerIdentity?.bind(cfg);
+    if (setPlayerIdentity) {
+        adapter.setPlayerIdentity = (id) => setPlayerIdentity(id);
+    }
+    return adapter;
+}

package/dist/adapter/first-party-systems.d.ts

@@ -0,0 +1,23 @@
+/**
+ * First-party implementations of the remaining `SystemAdapters` — audio and
+ * navigation — each a thin coordination/introspection boundary over the real
+ * engine subsystem (the original vision named these as first-class System
+ * adapters; physics + networking shipped earlier). The editor speaks only the
+ * interfaces; these wrap the engine audio bus and `NavMeshManager` so an
+ * external game could supply its own equivalents. (The former
+ * `AnimationAdapter`/`createAnimationAdapter` over the `AnimGraph` map was
+ * removed by E5 — AnimGraph no longer exists. The former
+ * `createInputManagerAdapter`/`createVgaiAssetAdapter` went with
+ * `SystemAdapters.input`/`.assets` — registered, never read by anything.)
+ */
+import type { NavMeshManager } from '../ai/navigation';
+import type { AudioContext as GameAudio } from '../setup/setup-audio';
+import type { AudioAdapter, NavigationAdapter } from './system-adapter';
+/** Release every meter tap still open on `adapter` (world stop / teardown). */
+export declare function releaseAudioMeters(adapter: AudioAdapter): void;
+export declare function createAudioSystemAdapter(audio: GameAudio): AudioAdapter;
+/** First-party `NavigationAdapter` over the engine `NavMeshManager` — the
+ *  blessed recast implementation, including the optional bake/export/crowd
+ *  capabilities the editor's Navigation panel binds through. */
+export declare function createNavigationAdapter(nav: NavMeshManager): NavigationAdapter;
+//# sourceMappingURL=first-party-systems.d.ts.map

package/dist/adapter/first-party-systems.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"first-party-systems.d.ts","sourceRoot":"","sources":["../../src/adapter/first-party-systems.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAAE,YAAY,IAAI,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACtE,OAAO,KAAK,EACV,YAAY,EAIZ,iBAAiB,EAElB,MAAM,kBAAkB,CAAC;AAmC1B,+EAA+E;AAC/E,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI,CAI9D;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,SAAS,GAAG,YAAY,CAoIvE;AAED;;gEAEgE;AAChE,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,cAAc,GAAG,iBAAiB,CAS9E"}

package/dist/adapter/first-party-systems.js

@@ -0,0 +1,196 @@
+/**
+ * First-party implementations of the remaining `SystemAdapters` — audio and
+ * navigation — each a thin coordination/introspection boundary over the real
+ * engine subsystem (the original vision named these as first-class System
+ * adapters; physics + networking shipped earlier). The editor speaks only the
+ * interfaces; these wrap the engine audio bus and `NavMeshManager` so an
+ * external game could supply its own equivalents. (The former
+ * `AnimationAdapter`/`createAnimationAdapter` over the `AnimGraph` map was
+ * removed by E5 — AnimGraph no longer exists. The former
+ * `createInputManagerAdapter`/`createVgaiAssetAdapter` went with
+ * `SystemAdapters.input`/`.assets` — registered, never read by anything.)
+ */
+/**
+ * First-party `AudioAdapter` over the engine's master-gain bus
+ * (`setup-audio.ts`'s `AudioContext.masterGain`) — the seam `Game.play.pause()`
+ * (D10, T7.6) calls to silence a first-party world's audio. Restoring after a
+ * mute puts the gain back at whatever value it held right before muting (not
+ * a hardcoded `1`) — this composes correctly with an independent manual mute
+ * (the editor's `MuteButton`, `PlayBar.tsx`): pausing while already
+ * user-muted resumes muted, exactly as a user would expect.
+ */
+function audioNodeTypeName(value) {
+    const name = value.constructor?.name;
+    return name && name !== 'Object' ? name : 'AudioNode';
+}
+/** This world's real native context, when it has one (headless worlds do not). */
+function nativeAudioContext(audio) {
+    const context = audio.listener?.context;
+    return context && typeof context.state === 'string'
+        ? context
+        : null;
+}
+/**
+ * Live meter handles per adapter, so a world teardown can release analyser
+ * taps a consumer forgot to dispose.
+ *
+ * This registry follows `acquireMeters` out of `audio-introspection.ts`: the
+ * safety net has to live wherever the taps are created, and they are created
+ * here now. Keyed weakly so an adapter that is simply dropped takes its entry
+ * with it.
+ */
+const meterHandlesByAdapter = new WeakMap();
+/** Release every meter tap still open on `adapter` (world stop / teardown). */
+export function releaseAudioMeters(adapter) {
+    const handles = meterHandlesByAdapter.get(adapter);
+    if (!handles)
+        return;
+    for (const handle of [...handles])
+        handle.dispose();
+}
+export function createAudioSystemAdapter(audio) {
+    let muted = false;
+    let priorGain = audio.masterGain.gain.value;
+    const liveMeterHandles = new Set();
+    const adapter = {
+        resume: () => audio.resume(),
+        setMuted(next) {
+            if (next === muted)
+                return;
+            muted = next;
+            if (next) {
+                priorGain = audio.masterGain.gain.value;
+                audio.masterGain.gain.value = 0;
+            }
+            else {
+                audio.masterGain.gain.value = priorGain;
+            }
+        },
+        isMuted: () => muted,
+        /**
+         * The engine's own bus hierarchy.
+         *
+         * This lived in `audio-introspection.ts` — the Tone-backed module — which
+         * meant the editor could only ever show an audio graph for a game that had
+         * loaded Tone. Nothing here needs Tone: it is the destination, the master
+         * gain, the three engine buses and the THREE listener. The Tone half (nodes
+         * a game routed through `connectToneBusToMasterGain`) is APPENDED by that
+         * module when it attaches, which is the honest split — Tone routes are
+         * Tone's to report.
+         */
+        graphSnapshot() {
+            const contextState = nativeAudioContext(audio)?.state;
+            const destination = {
+                id: 'destination',
+                type: 'AudioDestinationNode',
+                label: 'Output',
+                outputs: [],
+            };
+            if (contextState !== undefined)
+                destination.state = contextState;
+            const nodes = [
+                destination,
+                {
+                    id: 'master',
+                    type: audioNodeTypeName(audio.masterGain),
+                    label: 'Master',
+                    outputs: ['destination'],
+                },
+                {
+                    id: 'bus-music',
+                    type: audioNodeTypeName(audio.buses.music),
+                    label: 'Music bus',
+                    outputs: ['master'],
+                },
+                {
+                    id: 'bus-sfx',
+                    type: audioNodeTypeName(audio.buses.sfx),
+                    label: 'SFX bus',
+                    outputs: ['master'],
+                },
+                {
+                    id: 'bus-voice',
+                    type: audioNodeTypeName(audio.buses.voice),
+                    label: 'Voice bus',
+                    outputs: ['master'],
+                },
+            ];
+            if (audio.listener) {
+                nodes.push({
+                    id: 'listener',
+                    type: audioNodeTypeName(audio.listener),
+                    label: '3D listener (THREE)',
+                    outputs: ['master'],
+                });
+            }
+            return nodes;
+        },
+        /**
+         * Per-bus linear-RMS levels, via native `AnalyserNode` taps.
+         *
+         * Zero Tone — analysers work identically whether or not Tone is bridged,
+         * and disposal is a plain disconnect. It was in the Tone module purely by
+         * where it was written, so a game that never touches Tone had no meters.
+         */
+        acquireMeters() {
+            const meterContext = nativeAudioContext(audio);
+            if (!meterContext || typeof meterContext.createAnalyser !== 'function') {
+                return null; // headless world — metering is impossible, and says so
+            }
+            const taps = [
+                ['master', 'Master', audio.masterGain],
+                ['bus-music', 'Music', audio.buses.music],
+                ['bus-sfx', 'SFX', audio.buses.sfx],
+                ['bus-voice', 'Voice', audio.buses.voice],
+            ].map(([id, label, gain]) => {
+                const analyser = meterContext.createAnalyser();
+                analyser.fftSize = 1024;
+                gain.connect(analyser); // a TAP (analyser is a sink), not an insert
+                return { id, label, gain, analyser, buffer: new Float32Array(analyser.fftSize) };
+            });
+            let disposed = false;
+            const handle = {
+                read: () => taps.map(({ id, label, analyser, buffer }) => {
+                    analyser.getFloatTimeDomainData(buffer);
+                    let sum = 0;
+                    for (let i = 0; i < buffer.length; i++) {
+                        const sample = buffer[i];
+                        sum += sample * sample;
+                    }
+                    return { id, label, level: Math.sqrt(sum / buffer.length) };
+                }),
+                dispose: () => {
+                    if (disposed)
+                        return;
+                    disposed = true;
+                    for (const tap of taps) {
+                        try {
+                            tap.gain.disconnect(tap.analyser);
+                        }
+                        catch {
+                            // already torn down with the context — nothing to release
+                        }
+                    }
+                    liveMeterHandles.delete(handle);
+                },
+            };
+            liveMeterHandles.add(handle);
+            return handle;
+        },
+    };
+    meterHandlesByAdapter.set(adapter, liveMeterHandles);
+    return adapter;
+}
+/** First-party `NavigationAdapter` over the engine `NavMeshManager` — the
+ *  blessed recast implementation, including the optional bake/export/crowd
+ *  capabilities the editor's Navigation panel binds through. */
+export function createNavigationAdapter(nav) {
+    return {
+        hasNavMesh: () => nav.hasNavMesh(),
+        findPath: (start, end) => nav.findPath(start, end),
+        debugMesh: (scene) => nav.getDebugMesh(scene),
+        bake: (meshes, params) => nav.buildFromMeshes(meshes, params),
+        exportData: () => nav.exportData(),
+        crowdAgents: () => nav.getCrowdAgents(),
+    };
+}

package/dist/adapter/host-context.d.ts

@@ -0,0 +1,194 @@
+/**
+ * Host contexts — what the host hands a root when it mounts it, PER SURFACE.
+ *
+ * This generalizes the old `GameContext`, which baked in first-party system
+ * choices (a Rapier world, the postprocessing composer, the InputManager, …).
+ * The host never assumes Rapier/Colyseus; those live behind `SystemAdapters`
+ * owned by the first-party implementer.
+ *
+ * ## Why this file is a family, not one interface (P-8)
+ *
+ * There used to be a single "neutral" `HostContext` interface handed to EVERY
+ * root, with a NON-OPTIONAL `three: typeof THREE` and `renderer:
+ * THREE.WebGLRenderer` on it. That made the neutral layer three-LOCKED rather
+ * than merely three-named: a Pixi or React root would have been handed a WebGL
+ * renderer it cannot use. In practice nobody did hand it one — the production
+ * Pixi and React hosts have always built their own canvas/dom-shaped contexts
+ * instead — so the "one context for every surface"
+ * claim was already false in the tree; it just wasn't expressed in the types,
+ * which is why `RootAdapter<K>` could only parameterize its RETURN type and
+ * the Pixi/React adapters lived outside `RootAdapter` entirely.
+ *
+ * The split (ratified, docs/ARCHITECTURE-CORE.md "Seam"):
+ *
+ *   {@link HostContextBase}   what EVERY surface genuinely gets
+ *     ├─ {@link ThreeHostContext}   + `three` · `renderer` · `surface` · `assets`
+ *     ├─ {@link CanvasHostContext}  + `canvas`/`width`/`height` (+ dpr/compositing hints)
+ *     └─ {@link DomHostContext}     + `container`
+ *
+ * and {@link HostContextFor} maps an `AdapterSurface` to its context, so
+ * `RootAdapter<K>.mount`'s PARAMETER is K-typed too — the surface tag now
+ * picks the context type, which is the whole point of the tag.
+ *
+ * ### Where the line was drawn, and why
+ *
+ * The base holds exactly the members all three surfaces ALREADY carry today —
+ * nothing was invented to make the base look richer:
+ *
+ *  - `game` — the root handle. Every surface has one (three: `ThreeHostContext.game`,
+ *    canvas: `CanvasHostContext.game`, dom: `DomHostContext.game`), and it is the one
+ *    genuinely surface-independent thing a host can hand any root.
+ *  - `headless` — a property of the ENVIRONMENT (no GPU/DOM/audio), not of the
+ *    render surface.
+ *
+ * Deliberately NOT in the base:
+ *
+ *  - `renderer`/`three` — three's own objects; the defect this split exists to
+ *    fix.
+ *  - the render surface — its SHAPE is surface-specific and there is no honest
+ *    common denominator: three nests `{canvas,width,height}` under `surface`,
+ *    canvas passes those three flat (plus its own compositing hints), and a DOM
+ *    root gets an `HTMLElement` container and no canvas at all. A shared
+ *    `surface` field would have to be a union nobody can consume without
+ *    re-branching on kind — i.e. the same three-shaped promise, one level down.
+ *  - `assets` — `AssetCache`'s SIGNATURE reads neutral (`load<T>(url)`), but its
+ *    one implementation is a GLTF/texture loader (`assets.ts` branches on
+ *    `.glb`/`.gltf` and resolves THREE objects), and neither the canvas nor the
+ *    dom host has ever been handed one: a canvas adapter builds its own
+ *    cache inside `mount`. Promoting it to the base would be the anti-shim rule
+ *    in miniature — a host promise nothing keeps. It stays on
+ *    {@link ThreeHostContext} until a second surface genuinely receives one.
+ *
+ * These three names are the ONLY names for these shapes. The transitional
+ * aliases that carried the pre-split spellings were deleted; every implementer
+ * and call site names the surface it actually mounts on.
+ *
+ * It also used to carry `requestSystem<T extends keyof SystemRegistry>()` — an
+ * "ask the host for a first-party subsystem" hook — over an EMPTY
+ * `SystemRegistry`. That made `keyof SystemRegistry` = `never`, so no argument
+ * could legally be passed and the method was uncallable by construction. In
+ * practice it existed as 28 copies of `requestSystem: () => null` in tests and
+ * hosts, with no caller anywhere, and its only real effect would have been to
+ * re-open the door this interface exists to close: the host handing a game a
+ * subsystem it did not build. Deleted rather than kept as a promise.
+ *
+ * Migration note: `SetupThreeRootAdapter.mount` builds today's `GameContext`
+ * (Rapier world, composer, …) internally from a `ThreeHostContext`. New code
+ * targets these contexts; `GameContext` is now a first-party implementation
+ * detail.
+ */
+import type * as THREE from 'three';
+import type { AssetCache } from '../assets';
+import type { Game, GameInternal } from '../runtime/game';
+import type { AdapterSurface } from './adapter-surface';
+/** The canvas/container the game renders into, plus its size. */
+export interface HostSurface {
+    readonly canvas: HTMLCanvasElement;
+    readonly width: number;
+    readonly height: number;
+}
+/**
+ * The surface-INDEPENDENT half of every host context — see this file's header
+ * for why only these two members earned a place here. Generic host code (a
+ * harness, a tier report, anything that must not care what it is mounting) can
+ * type against this; a real adapter always receives one of the per-surface
+ * contexts below.
+ */
+export interface HostContextBase {
+    /**
+     * The Game root (T7.1 slice 1 — D6). The host
+     * constructs the Game shell BEFORE mounting an adapter and hands it down
+     * here so an adapter can expose `ctx.game`/`ctx.roots` to the game it
+     * mounts. Absent in headless harnesses and foreign hosts that predate the
+     * Game root — everything must keep working when this is undefined (the
+     * zero-break guarantee for this slice). Typed as the PUBLIC `Game` shell
+     * here because that is the weakest promise any surface makes (a react
+     * root's host has always carried a plain `Game`); the three and canvas
+     * contexts narrow it to `GameInternal`, which is what their hosts really
+     * pass.
+     */
+    readonly game?: Game | undefined;
+    /**
+     * No GPU/DOM/audio available (Node conformance tests). A first-party adapter
+     * skips postprocessing/render/audio/input-map loading but still builds the
+     * scene + Rapier + components, so its scene/authoring/physics can be exercised
+     * headlessly. Browser hosts leave this false/undefined → full behavior.
+     */
+    readonly headless?: boolean;
+}
+/**
+ * What a `three`-surface root is handed. This is the ONLY context carrying
+ * three's own objects — the split's entire point (see the header): a Pixi or
+ * React root is never handed a `WebGLRenderer` it cannot use.
+ */
+export interface ThreeHostContext extends HostContextBase {
+    /** The ONE shared three instance — identity matters for capture (see ingest). */
+    readonly three: typeof THREE;
+    /** Canvas/container + size; a self-driven game may take the surface over. */
+    readonly surface: HostSurface;
+    /** Host renderer — host-driven games render through it. */
+    readonly renderer: THREE.WebGLRenderer;
+    /** Shared GLTF/texture cache — three-flavored today; see the header. */
+    readonly assets: AssetCache;
+    readonly game?: GameInternal | undefined;
+}
+/**
+ * What a `canvas`-surface root is handed: a raw canvas + its
+ * logical size, plus the
+ * compositing hints the multi-root host computes once for every stacked
+ * surface. No `three`, no `renderer`, no `assets` — a Pixi root builds its own
+ * `PIXI.Application` and its own asset cache from this.
+ */
+export interface CanvasHostContext extends HostContextBase {
+    readonly canvas: HTMLCanvasElement;
+    readonly width: number;
+    readonly height: number;
+    /** Shared Game root when mounted by the universal multi-root host. */
+    readonly game?: GameInternal | undefined;
+    /** DPR override (T6.1 slice 1, D5 §3 — "one DPR
+     *  everywhere"): the roots-path host computes ONE dpr for every stacked
+     *  surface and passes it here; omitted -> the canvas adapter's own
+     *  default (`window.devicePixelRatio`, uncapped). */
+    readonly dpr?: number;
+    /** This root is stacked ABOVE another root (D5 §1): clear with alpha 0
+     *  instead of an opaque background so the layer below shows through. */
+    readonly transparent?: boolean;
+    /** Capture tier cost (D5 §4) — the renderer's `preserveDrawingBuffer`. */
+    readonly preserveDrawingBuffer?: boolean;
+}
+/**
+ * What a `dom`-surface root is handed (the shape `runtime/create-runtime.ts`
+ * used to spell `ReactRootHost`).
+ *
+ * `container` is the absolutely-positioned, z-ordered DOM-root layer `<div>`
+ * the host already created and stacked (same box/z-order rules as a canvas per
+ * D5 §1) — the adapter's `mount` renders its react tree INTO
+ * this exact element via `createRoot`; it must never create its own root
+ * element (the DOM analog of three's "the root's runtime renders into the
+ * surface it is handed" rule).
+ *
+ * `game` (inherited, and deliberately still optional): a
+ * `default-react` sibling mounted BESIDE an ingest root (`packages/editor/src/
+ * ingest-siblings.ts`) has no native `Game` to hand it — there is no
+ * first-party `GameContext`/loop for the sibling to join, only the ingested
+ * root's own foreign runtime — so its host carries no `game` at all rather than
+ * fabricating an empty one (anti-shim rule); the sibling mounts its entry
+ * component bare, with no `<WorldProvider>` wrap. `mountOneReactRoot`
+ * (`runtime/create-runtime.ts`, the NATIVE multi-root runtime path) still
+ * ALWAYS supplies a real `game` — this optionality is reached only by the
+ * composite sibling's own hand-built host, never by weakening the native path's
+ * guarantee.
+ */
+export interface DomHostContext extends HostContextBase {
+    readonly container: HTMLElement;
+}
+/**
+ * Map an {@link AdapterSurface} to the host context that surface's roots are
+ * handed — the mirror image of `MountedRootFor<K>` (`root-adapter.ts`), and
+ * what makes `RootAdapter<K>.mount`'s PARAMETER K-typed. A hypothetical 4th
+ * surface resolves to `never` here, so it cannot be mounted until it declares
+ * its own context (the same fail-to-compile discipline `assertNever` gives the
+ * dispatch sites).
+ */
+export type HostContextFor<K extends AdapterSurface> = K extends 'three' ? ThreeHostContext : K extends 'canvas' ? CanvasHostContext : K extends 'dom' ? DomHostContext : never;
+//# sourceMappingURL=host-context.d.ts.map

package/dist/adapter/host-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-context.d.ts","sourceRoot":"","sources":["../../src/adapter/host-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8EG;AAEH,OAAO,KAAK,KAAK,KAAK,MAAM,OAAO,CAAC;AACpC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,KAAK,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAExD,iEAAiE;AACjE,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;IACnC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,GAAG,SAAS,CAAC;IACjC;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED;;;;GAIG;AACH,MAAM,WAAW,gBAAiB,SAAQ,eAAe;IACvD,iFAAiF;IACjF,QAAQ,CAAC,KAAK,EAAE,OAAO,KAAK,CAAC;IAC7B,6EAA6E;IAC7E,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;IAC9B,2DAA2D;IAC3D,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAC,aAAa,CAAC;IACvC,wEAAwE;IACxE,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,QAAQ,CAAC,IAAI,CAAC,EAAE,YAAY,GAAG,SAAS,CAAC;CAC1C;AAED;;;;;;GAMG;AACH,MAAM,WAAW,iBAAkB,SAAQ,eAAe;IACxD,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;IACnC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,sEAAsE;IACtE,QAAQ,CAAC,IAAI,CAAC,EAAE,YAAY,GAAG,SAAS,CAAC;IACzC;;;yDAGqD;IACrD,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB;4EACwE;IACxE,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAC/B,0EAA0E;IAC1E,QAAQ,CAAC,qBAAqB,CAAC,EAAE,OAAO,CAAC;CAC1C;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,WAAW,cAAe,SAAQ,eAAe;IACrD,QAAQ,CAAC,SAAS,EAAE,WAAW,CAAC;CACjC;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,cAAc,CAAC,CAAC,SAAS,cAAc,IAAI,CAAC,SAAS,OAAO,GACpE,gBAAgB,GAChB,CAAC,SAAS,QAAQ,GAChB,iBAAiB,GACjB,CAAC,SAAS,KAAK,GACb,cAAc,GACd,KAAK,CAAC"}