@vgai/engine 0.5.21 → 0.5.23

package/dist/adapter/system-adapter.d.ts

@@ -25,6 +25,21 @@ export type PhysicsColliderShape = {
     readonly type: 'capsule';
     readonly halfHeight: number;
     readonly radius: number;
+}
+/**
+ * A collider this seam has no plain-data projection for — a trimesh,
+ * heightfield, convex hull, cylinder, cone, …
+ *
+ * IT IS STILL A COLLIDER, and the body still has it. Implementations used to
+ * drop these from `colliders()` entirely, so a body whose only collider was a
+ * trimesh inspected as a body with NO physics at all. `kind` is the native
+ * shape's own name, so the inspector can say WHICH shape it cannot draw
+ * rather than implying nothing is there. Nothing may synthesize dimensions
+ * for one, and `previewCollider` refuses it.
+ */
+ | {
+    readonly type: 'unsupported';
+    readonly kind: string;
 };
 /** Plain-data projection of one native 3D physics collider. The owning
  * physics implementation keeps the actual collider; editor authoring only
@@ -231,12 +246,28 @@ export interface NetworkingAdapter {
     authority(nodeId: string): 'local' | 'remote' | 'server';
     /** Remote/server-authoritative nodes → inspect-only in the editor. */
     editable(nodeId: string): boolean;
-    /** Current connection lifecycle state. */
-    getConnectionState(): ConnectionState;
-    /** The active room's identity, or `null` when not connected to a room. */
-    getRoomInfo(): RoomInfo | null;
-    /** Replication activity snapshot, for a live network inspector panel. */
-    getReplicationStats(): ReplicationStats;
+    /**
+     * Optional capability: current connection lifecycle state.
+     *
+     * OPTIONAL for the same reason every other member here is — `'disconnected'`
+     * is a POSITIVE CLAIM about the link, and an implementer that never taught
+     * this adapter to read connection state has not made it. Absent ⇒ the
+     * inspector marks the section unsupported; it does not report a game as
+     * disconnected on the strength of nobody having looked.
+     */
+    getConnectionState?(): ConnectionState;
+    /**
+     * Optional capability: the active room's identity, or `null` when connected
+     * to no room. `null` is the ANSWER "there is no room", so absence of the
+     * accessor — "nothing here can tell you" — has to be a different thing.
+     */
+    getRoomInfo?(): RoomInfo | null;
+    /**
+     * Optional capability: replication activity snapshot, for a live network
+     * inspector panel. Zeroes are a measurement, not a default; an adapter with
+     * no counters omits this rather than reporting a quiet link.
+     */
+    getReplicationStats?(): ReplicationStats;
     /** Subscribe to changes in connection state / room / replication stats. */
     subscribe(cb: () => void): Unsubscribe;
     /** Optional capability: one plain-data (JSON-safe) snapshot of the
@@ -263,7 +294,7 @@ export interface NetworkingAdapter {
      *  (e.g. read off its own room state). The editor consumes this for display —
      *  a seat label — ONLY when a real implementer provides it, falling back to a
      *  generic label otherwise. */
-    getPlayerIdentity?(): NetPlayerIdentity;
+    getPlayerIdentity?(): NetPlayerIdentity | undefined;
     /** Optional capability, PAIRED with {@link getPlayerIdentity}: set the local
      *  player's identity through the game's OWN multiplayer mechanism. The editor
      *  renders an editable name field ONLY when a real implementer provides this
@@ -324,6 +355,13 @@ export interface NavCrowdAgentState {
  */
 export interface NavigationAdapter {
     hasNavMesh(): boolean;
+    /**
+     * `[]` means SEARCHED AND FOUND NO ROUTE — a fact about the level. An
+     * implementer with no navmesh to search, or whose query FAILED, THROWS
+     * instead; those are facts about the implementer, and collapsing all three
+     * into `[]` tells a caller the level is impassable when nobody looked.
+     * Gate on {@link hasNavMesh} where the first case is reachable.
+     */
     findPath(start: NavPoint, end: NavPoint): NavPoint[];
     debugMesh(scene: THREE.Scene): THREE.Object3D | null;
     /** (Re)build the navmesh from source meshes. Synchronous in the blessed

package/dist/adapter/system-adapter.d.ts.map

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

package/dist/adapter/system-seam-contract.d.ts

@@ -151,17 +151,17 @@ export declare const NETWORKING_ADAPTER_SHAPE: {
         readonly required: "operation";
     };
     readonly getConnectionState: {
-        readonly optional: false;
+        readonly optional: true;
         readonly kind: "function";
         readonly required: "operation";
     };
     readonly getRoomInfo: {
-        readonly optional: false;
+        readonly optional: true;
         readonly kind: "function";
         readonly required: "operation";
     };
     readonly getReplicationStats: {
-        readonly optional: false;
+        readonly optional: true;
         readonly kind: "function";
         readonly required: "operation";
     };

package/dist/adapter/system-seam-contract.js

@@ -37,9 +37,9 @@ export const NETWORKING_ADAPTER_SHAPE = defineSeamShape()({
     networkId: { optional: false, kind: 'function', required: 'operation' },
     authority: { optional: false, kind: 'function', required: 'operation' },
     editable: { optional: false, kind: 'function', required: 'operation' },
-    getConnectionState: { optional: false, kind: 'function', required: 'operation' },
-    getRoomInfo: { optional: false, kind: 'function', required: 'operation' },
-    getReplicationStats: { optional: false, kind: 'function', required: 'operation' },
+    getConnectionState: { optional: true, kind: 'function', required: 'operation' },
+    getRoomInfo: { optional: true, kind: 'function', required: 'operation' },
+    getReplicationStats: { optional: true, kind: 'function', required: 'operation' },
     subscribe: { optional: false, kind: 'function', required: 'effect' },
     getStateSnapshot: { optional: true, kind: 'function', required: 'operation' },
     messageEvents: { optional: true, kind: 'function', required: 'operation' },

package/dist/adapter/system-slot.d.ts

@@ -0,0 +1,168 @@
+/**
+ * `createSystemSlot` — THE implementation of the declared-slot façade, the
+ * seam between a STATIC `systems` declaration and a LIVE adapter that only
+ * exists once the world tree is mounted.
+ *
+ * WHY IT EXISTS. An entry declares its systems statically
+ * (`export const systems = { networking: networkingSystem() }`), while the
+ * thing being declared — a joined Colyseus room, a baked navmesh, a mounted
+ * `<Physics>`, a cutscene's camera ownership — is built inside the world tree,
+ * later, and may be replaced (reconnect, remount, hot restart) or go away
+ * (stop). The slot is a stable object the host installs at mount and holds
+ * forever; every call forwards to whatever is attached right now.
+ *
+ * ── THE HONESTY RULE, STATED IN ONE PLACE ───────────────────────────────────
+ * This is why the pattern is centralized: five hand-rolled copies disagreed
+ * about it, and each disagreement was found by a separate review.
+ *
+ *  - An **action** with no live target REFUSES BY NAME
+ *    (`<name>: <unattachedMessage>`). Never a silent no-op — a caller that
+ *    told the game to DO something must learn that it did not happen. An
+ *    action against a live adapter that lacks the member refuses the same
+ *    way, naming the member.
+ *  - A **read** answers its declared HONEST EMPTY — `'disconnected'`, `[]`,
+ *    `null`, `false`. That is not a fabrication: it is the truth of the
+ *    not-attached state, in the same vocabulary the editor's own edit-mode
+ *    adapters use. Reads are also the only kind safe to call from a per-frame
+ *    debug draw, which is why a throw into a rAF loop is never the answer.
+ *  - An **optional** member MIRRORS THE LIVE ADAPTER'S PRESENCE: absent while
+ *    unattached, and absent afterwards when the live adapter itself does not
+ *    provide it. Presence IS the consume-by-presence protocol's signal, so
+ *    the slot may never invent it. Each presence read CAPTURES the adapter it
+ *    saw and forwards to that same instance, so a detach between the read and
+ *    the call answers as the adapter the caller was handed rather than a
+ *    mid-flight swap.
+ *  - A **subscribe** member SURVIVES REATTACHMENT: listeners live on the
+ *    slot, never on the instance, and the slot re-binds its own single
+ *    subscription on every attach/detach. A panel that subscribed once to the
+ *    stable slot object is therefore never left holding a disposed system, and
+ *    it is notified when the live half appears or disappears.
+ *  - A member the config DOES NOT LIST does not exist on the slot at all.
+ *    That is how the anti-shim rule spells omission — e.g. `PhysicsAdapter`'s
+ *    `debugDraw`/`contactPoints` over `@react-three/rapier`, whose debug line
+ *    segments live inside the fiber tree and expose no handle. Absence is a
+ *    capability answer; a stub is a lie.
+ *
+ * ── RESOURCE OWNERSHIP ──────────────────────────────────────────────────────
+ * OWNER: whoever built the live adapter (the hook, the bridge component). The
+ * slot owns only the POINTER to it plus its own listener set and its own
+ * subscription to the live half. SHARERS: every reader of the declared
+ * system — editor inspectors, instruments. TEARDOWN: the function `attach`
+ * returns, and nothing else. It is IDENTITY-GUARDED — it clears only while
+ * the same instance is still attached, so a replace-then-teardown-the-old
+ * ordering cannot detach the new one — and detaching never disposes the
+ * adapter, because the slot did not create it.
+ *
+ * WHERE the slot module lives decides how many games share it. A slot in
+ * PROJECT-owned source (the four capability/example façades) is per Play
+ * instance, because the editor stamps mount ids onto project-owned import
+ * specifiers (`server/project-module-instance.ts`) — N instances get N module
+ * graphs and N slots. A slot in an ENGINE module is reached by bare
+ * specifier, which that stamping deliberately never touches, so it is ONE per
+ * page: every Play instance shares it, and concurrent instances' attaches
+ * contend (last attach wins; the loser's detach is dropped by the identity
+ * guard). `rapier-physics-bridge.tsx` is the one such slot today and warns
+ * loudly when contended — prefer project-owned slot modules for anything new.
+ *
+ * NOT A WRAPPER. The slot's members have the adapter interface's own exact
+ * signatures and hand back the implementation's own values; nothing stands
+ * between a caller and the live library object.
+ */
+import type { VgaiGameSystemEmpty } from './ingest/game-contract';
+/**
+ * `absent(reason)` — THE WHOLE-SLOT counterpart of the four per-member policies
+ * above, and the fifth line of the same honesty rule.
+ *
+ * The four policies answer "this slot exists but nothing is attached yet". This
+ * one answers a different question entirely: **this game will never have that
+ * subsystem, and here is what was searched.** A slot simply left out of the
+ * `systems` table cannot say that — an omitted key means "unsupported", which is
+ * the same shape as "nobody looked", and the coverage report has to file it as a
+ * work order forever. Declaring the absence turns an UNANSWERED row into a
+ * terminal one.
+ *
+ * ```ts
+ * export const systems = {
+ *   audio: sfxAudioSystem(),
+ *   physics: rapierPhysicsSystem(),
+ *   networking: absent('single-player: no Colyseus client anywhere in `src/`'),
+ * };
+ * ```
+ *
+ * ## It is a CONSTRUCTOR for the shape that already exists, not a second one
+ *
+ * The returned value IS `VgaiGameSystemEmpty` — the plain
+ * `{ present: false, evidence }` record an INGESTED game declares on
+ * `window.vgaiGame.systems.systemAdapters`, validated by the same single
+ * projection (`ingest/contract-system-adapters.ts`). There is one shape law, not
+ * two: a foreign game cannot import this helper and must stay able to write the
+ * record by hand, so nothing here may brand the runtime value. What the helper
+ * buys a FIRST-PARTY author is the reason-quality check moved to the call site —
+ * our own code failing its own contract fails fast, where an ingested game's
+ * same mistake is filed as a `malformed` verdict for its coverage report.
+ *
+ * ## It is a MARKER, never a stub adapter
+ *
+ * Do not answer an absent slot with an adapter whose methods return zeros. A
+ * `getConnectionState()` of `'disconnected'` on a game with no transport implies
+ * a connection that could exist; that is the fabrication the anti-shim rule
+ * forbids. The absence is STATED, and the host installs nothing for it.
+ *
+ * @param reason What was searched and what was found, in the game's own source
+ *   terms. "no netcode anywhere in `src/`" is a finished answer a reviewer can
+ *   re-run; "not implemented yet" is a plan, and is rejected here.
+ */
+export declare function absent(reason: string): VgaiGameSystemEmpty;
+/** Any adapter member. `never[]` args make the conditional match contravariantly. */
+type AnyFn = (...args: never[]) => unknown;
+/** The declared member's return type, used to type a `read`'s honest empty. */
+type MemberReturn<F> = NonNullable<F> extends (...args: never[]) => infer R ? R : never;
+/**
+ * The per-member policy. There are exactly four, and every member of every
+ * declared slot in the repo is one of them — see the honesty rule above.
+ */
+export type SystemSlotMemberSpec<F> = {
+    readonly kind: 'action';
+} | {
+    readonly kind: 'read';
+    readonly empty: MemberReturn<F>;
+} | {
+    readonly kind: 'subscribe';
+} | {
+    readonly kind: 'optional';
+};
+/** The keys of `T` whose values are callable (data properties are not slottable). */
+type FunctionMemberKeys<T> = {
+    [K in keyof T]-?: NonNullable<T[K]> extends AnyFn ? K : never;
+}[keyof T];
+/** Per-member policies. A member left out is left OFF the slot entirely. */
+export type SystemSlotMembers<T> = {
+    readonly [K in FunctionMemberKeys<T>]?: SystemSlotMemberSpec<T[K]>;
+};
+export interface SystemSlotConfig<T extends object> {
+    /**
+     * The slot's own name, used as the prefix of every refusal so a stack-less
+     * error still names the seam (`'networkingSystem'`, `'rapierPhysicsSystem'`).
+     */
+    readonly name: string;
+    /**
+     * The rest of an action's refusal while nothing is attached — the DOMAIN
+     * half of the message, naming what has not happened yet ("the world is not
+     * playing, or the navmesh has not finished building").
+     */
+    readonly unattachedMessage: string;
+    readonly members: SystemSlotMembers<T>;
+}
+export interface SystemSlot<T extends object> {
+    /**
+     * Publish `live` as the slot's target. Returns the ONE detach path, which
+     * is identity-guarded: it clears only while `live` is still the attached
+     * instance, and never disposes it.
+     */
+    attach(live: T): () => void;
+    /** The stable declared object. Hand THIS to the entry's `systems` map. */
+    readonly slot: T;
+}
+export declare function createSystemSlot<T extends object>(config: SystemSlotConfig<T>): SystemSlot<T>;
+export {};
+//# sourceMappingURL=system-slot.d.ts.map

package/dist/adapter/system-slot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-slot.d.ts","sourceRoot":"","sources":["../../src/adapter/system-slot.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqEG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAElE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,wBAAgB,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,mBAAmB,CAS1D;AAED,qFAAqF;AACrF,KAAK,KAAK,GAAG,CAAC,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,OAAO,CAAC;AAE3C,+EAA+E;AAC/E,KAAK,YAAY,CAAC,CAAC,IAAI,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;AAExF;;;GAGG;AACH,MAAM,MAAM,oBAAoB,CAAC,CAAC,IAC9B;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAA;CAAE,GAC3B;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC,CAAA;CAAE,GAC1D;IAAE,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAA;CAAE,GAC9B;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAA;CAAE,CAAC;AAElC,qFAAqF;AACrF,KAAK,kBAAkB,CAAC,CAAC,IAAI;KAC1B,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,KAAK,GAAG,CAAC,GAAG,KAAK;CAC9D,CAAC,MAAM,CAAC,CAAC,CAAC;AAEX,4EAA4E;AAC5E,MAAM,MAAM,iBAAiB,CAAC,CAAC,IAAI;IACjC,QAAQ,EAAE,CAAC,IAAI,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,oBAAoB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CACnE,CAAC;AAEF,MAAM,WAAW,gBAAgB,CAAC,CAAC,SAAS,MAAM;IAChD;;;OAGG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB;;;;OAIG;IACH,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,OAAO,EAAE,iBAAiB,CAAC,CAAC,CAAC,CAAC;CACxC;AAED,MAAM,WAAW,UAAU,CAAC,CAAC,SAAS,MAAM;IAC1C;;;;OAIG;IACH,MAAM,CAAC,IAAI,EAAE,CAAC,GAAG,MAAM,IAAI,CAAC;IAC5B,0EAA0E;IAC1E,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;CAClB;AAED,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,MAAM,EAAE,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CA+G7F"}

package/dist/adapter/system-slot.js

@@ -0,0 +1,229 @@
+/**
+ * `createSystemSlot` — THE implementation of the declared-slot façade, the
+ * seam between a STATIC `systems` declaration and a LIVE adapter that only
+ * exists once the world tree is mounted.
+ *
+ * WHY IT EXISTS. An entry declares its systems statically
+ * (`export const systems = { networking: networkingSystem() }`), while the
+ * thing being declared — a joined Colyseus room, a baked navmesh, a mounted
+ * `<Physics>`, a cutscene's camera ownership — is built inside the world tree,
+ * later, and may be replaced (reconnect, remount, hot restart) or go away
+ * (stop). The slot is a stable object the host installs at mount and holds
+ * forever; every call forwards to whatever is attached right now.
+ *
+ * ── THE HONESTY RULE, STATED IN ONE PLACE ───────────────────────────────────
+ * This is why the pattern is centralized: five hand-rolled copies disagreed
+ * about it, and each disagreement was found by a separate review.
+ *
+ *  - An **action** with no live target REFUSES BY NAME
+ *    (`<name>: <unattachedMessage>`). Never a silent no-op — a caller that
+ *    told the game to DO something must learn that it did not happen. An
+ *    action against a live adapter that lacks the member refuses the same
+ *    way, naming the member.
+ *  - A **read** answers its declared HONEST EMPTY — `'disconnected'`, `[]`,
+ *    `null`, `false`. That is not a fabrication: it is the truth of the
+ *    not-attached state, in the same vocabulary the editor's own edit-mode
+ *    adapters use. Reads are also the only kind safe to call from a per-frame
+ *    debug draw, which is why a throw into a rAF loop is never the answer.
+ *  - An **optional** member MIRRORS THE LIVE ADAPTER'S PRESENCE: absent while
+ *    unattached, and absent afterwards when the live adapter itself does not
+ *    provide it. Presence IS the consume-by-presence protocol's signal, so
+ *    the slot may never invent it. Each presence read CAPTURES the adapter it
+ *    saw and forwards to that same instance, so a detach between the read and
+ *    the call answers as the adapter the caller was handed rather than a
+ *    mid-flight swap.
+ *  - A **subscribe** member SURVIVES REATTACHMENT: listeners live on the
+ *    slot, never on the instance, and the slot re-binds its own single
+ *    subscription on every attach/detach. A panel that subscribed once to the
+ *    stable slot object is therefore never left holding a disposed system, and
+ *    it is notified when the live half appears or disappears.
+ *  - A member the config DOES NOT LIST does not exist on the slot at all.
+ *    That is how the anti-shim rule spells omission — e.g. `PhysicsAdapter`'s
+ *    `debugDraw`/`contactPoints` over `@react-three/rapier`, whose debug line
+ *    segments live inside the fiber tree and expose no handle. Absence is a
+ *    capability answer; a stub is a lie.
+ *
+ * ── RESOURCE OWNERSHIP ──────────────────────────────────────────────────────
+ * OWNER: whoever built the live adapter (the hook, the bridge component). The
+ * slot owns only the POINTER to it plus its own listener set and its own
+ * subscription to the live half. SHARERS: every reader of the declared
+ * system — editor inspectors, instruments. TEARDOWN: the function `attach`
+ * returns, and nothing else. It is IDENTITY-GUARDED — it clears only while
+ * the same instance is still attached, so a replace-then-teardown-the-old
+ * ordering cannot detach the new one — and detaching never disposes the
+ * adapter, because the slot did not create it.
+ *
+ * WHERE the slot module lives decides how many games share it. A slot in
+ * PROJECT-owned source (the four capability/example façades) is per Play
+ * instance, because the editor stamps mount ids onto project-owned import
+ * specifiers (`server/project-module-instance.ts`) — N instances get N module
+ * graphs and N slots. A slot in an ENGINE module is reached by bare
+ * specifier, which that stamping deliberately never touches, so it is ONE per
+ * page: every Play instance shares it, and concurrent instances' attaches
+ * contend (last attach wins; the loser's detach is dropped by the identity
+ * guard). `rapier-physics-bridge.tsx` is the one such slot today and warns
+ * loudly when contended — prefer project-owned slot modules for anything new.
+ *
+ * NOT A WRAPPER. The slot's members have the adapter interface's own exact
+ * signatures and hand back the implementation's own values; nothing stands
+ * between a caller and the live library object.
+ */
+/**
+ * `absent(reason)` — THE WHOLE-SLOT counterpart of the four per-member policies
+ * above, and the fifth line of the same honesty rule.
+ *
+ * The four policies answer "this slot exists but nothing is attached yet". This
+ * one answers a different question entirely: **this game will never have that
+ * subsystem, and here is what was searched.** A slot simply left out of the
+ * `systems` table cannot say that — an omitted key means "unsupported", which is
+ * the same shape as "nobody looked", and the coverage report has to file it as a
+ * work order forever. Declaring the absence turns an UNANSWERED row into a
+ * terminal one.
+ *
+ * ```ts
+ * export const systems = {
+ *   audio: sfxAudioSystem(),
+ *   physics: rapierPhysicsSystem(),
+ *   networking: absent('single-player: no Colyseus client anywhere in `src/`'),
+ * };
+ * ```
+ *
+ * ## It is a CONSTRUCTOR for the shape that already exists, not a second one
+ *
+ * The returned value IS `VgaiGameSystemEmpty` — the plain
+ * `{ present: false, evidence }` record an INGESTED game declares on
+ * `window.vgaiGame.systems.systemAdapters`, validated by the same single
+ * projection (`ingest/contract-system-adapters.ts`). There is one shape law, not
+ * two: a foreign game cannot import this helper and must stay able to write the
+ * record by hand, so nothing here may brand the runtime value. What the helper
+ * buys a FIRST-PARTY author is the reason-quality check moved to the call site —
+ * our own code failing its own contract fails fast, where an ingested game's
+ * same mistake is filed as a `malformed` verdict for its coverage report.
+ *
+ * ## It is a MARKER, never a stub adapter
+ *
+ * Do not answer an absent slot with an adapter whose methods return zeros. A
+ * `getConnectionState()` of `'disconnected'` on a game with no transport implies
+ * a connection that could exist; that is the fabrication the anti-shim rule
+ * forbids. The absence is STATED, and the host installs nothing for it.
+ *
+ * @param reason What was searched and what was found, in the game's own source
+ *   terms. "no netcode anywhere in `src/`" is a finished answer a reviewer can
+ *   re-run; "not implemented yet" is a plan, and is rejected here.
+ */
+export function absent(reason) {
+    if (typeof reason !== 'string' || reason.trim() === '') {
+        throw new Error('absent(): an absence needs evidence — say what was searched and what was found ' +
+            '(e.g. "no Colyseus client anywhere in `src/`"), so a reviewer can re-run it. ' +
+            'An unevidenced absence asserts something nobody can re-check.');
+    }
+    return { present: false, evidence: reason };
+}
+export function createSystemSlot(config) {
+    const { name, unattachedMessage, members } = config;
+    let live = null;
+    /** Subscribers to the stable slot object; they outlive any one live instance. */
+    const listeners = new Set();
+    /** The slot's own single subscription to whatever is attached. */
+    let liveUnsubscribe = null;
+    let subscribeMember = null;
+    const asRecord = (value) => value;
+    const liveMember = (member) => {
+        if (!live)
+            return undefined;
+        const value = asRecord(live)[member];
+        return typeof value === 'function' ? value : undefined;
+    };
+    const notify = () => {
+        for (const listener of [...listeners])
+            listener();
+    };
+    const bindLive = () => {
+        liveUnsubscribe?.();
+        liveUnsubscribe = null;
+        if (!live || subscribeMember === null || listeners.size === 0)
+            return;
+        const subscribe = liveMember(subscribeMember);
+        if (!subscribe)
+            return;
+        const result = subscribe.call(live, notify);
+        liveUnsubscribe = typeof result === 'function' ? result : null;
+    };
+    const target = {};
+    const declared = Object.entries(members);
+    for (const [member, spec] of declared) {
+        switch (spec.kind) {
+            case 'action': {
+                // Refuse by name, twice over: no live adapter at all, or a live
+                // adapter that does not carry this member (only ever a foreign
+                // replacement — the blessed implementations carry all of theirs).
+                target[member] = (...args) => {
+                    if (!live)
+                        throw new Error(`${name}: ${unattachedMessage}`);
+                    const fn = liveMember(member);
+                    if (!fn)
+                        throw new Error(`${name}: the live adapter has no ${member}().`);
+                    return fn.apply(live, args);
+                };
+                break;
+            }
+            case 'read': {
+                const { empty } = spec;
+                target[member] = (...args) => {
+                    const current = live;
+                    const fn = liveMember(member);
+                    const value = fn ? fn.apply(current, args) : undefined;
+                    return value ?? empty;
+                };
+                break;
+            }
+            case 'subscribe': {
+                if (subscribeMember !== null) {
+                    throw new Error(`${name}: a slot declares at most one 'subscribe' member (${subscribeMember} and ${member}).`);
+                }
+                subscribeMember = member;
+                target[member] = (listener) => {
+                    listeners.add(listener);
+                    bindLive();
+                    return () => {
+                        listeners.delete(listener);
+                        bindLive();
+                    };
+                };
+                break;
+            }
+            case 'optional': {
+                Object.defineProperty(target, member, {
+                    enumerable: true,
+                    configurable: true,
+                    get() {
+                        const current = live;
+                        const fn = liveMember(member);
+                        if (!fn)
+                            return undefined;
+                        return (...args) => fn.apply(current, args);
+                    },
+                });
+                break;
+            }
+        }
+    }
+    const attach = (next) => {
+        live = next;
+        bindLive();
+        notify();
+        return () => {
+            if (live !== next)
+                return;
+            live = null;
+            bindLive();
+            notify();
+        };
+    };
+    // THE ONE CAST. `exactOptionalPropertyTypes` forbids an optional member
+    // whose getter can yield `undefined`, but that is precisely the honest
+    // shape here — the getter IS how presence mirrors the live adapter — and a
+    // reflectively built object cannot be typed structurally anyway. Callers
+    // see exactly the absent/present behavior the adapter interface documents.
+    return { attach, slot: target };
+}

package/dist/adapter/transform.d.ts

@@ -14,5 +14,15 @@ export interface Transform {
  * needs simulation coordination (`physics`), or is best-effort/inspect-only
  * (`script`/`network`/`external`).
  */
-export type TransformOwner = 'editor' | 'physics' | 'animation' | 'script' | 'network' | 'external';
+/**
+ * Who drives a node's transform right now.
+ *
+ * `'unresolved'` is the answer for a node THIS ADAPTER DOES NOT KNOW, and it is
+ * a distinct answer on purpose: every other member names a driver, so returning
+ * one of them for an unknown id is a positive claim about a node the
+ * implementer has never seen. A game-scoped physics adapter is asked about
+ * every node the editor touches, including nodes belonging to another root —
+ * "not mine" has to be sayable.
+ */
+export type TransformOwner = 'editor' | 'physics' | 'animation' | 'script' | 'network' | 'external' | 'unresolved';
 //# sourceMappingURL=transform.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"transform.d.ts","sourceRoot":"","sources":["../../src/adapter/transform.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3C,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC;AAED;;;;;GAKG;AACH,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,SAAS,GAAG,UAAU,CAAC"}
+{"version":3,"file":"transform.d.ts","sourceRoot":"","sources":["../../src/adapter/transform.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3C,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC;AAED;;;;;GAKG;AACH;;;;;;;;;GASG;AACH,MAAM,MAAM,cAAc,GACtB,QAAQ,GACR,SAAS,GACT,WAAW,GACX,QAAQ,GACR,SAAS,GACT,UAAU,GACV,YAAY,CAAC"}

package/dist/ai/navigation.d.ts

@@ -55,7 +55,23 @@ export declare class NavMeshManager {
     private destroyRecast;
     /** True once a navmesh has been built (for the NavigationAdapter to gate on). */
     hasNavMesh(): boolean;
-    /** Find a straight path between two world positions. Returns [] if no path. */
+    /**
+     * Find a straight path between two world positions.
+     *
+     * THREE OUTCOMES, and only one of them is an empty array:
+     *
+     *  - **No pathfinder.** No navmesh has been built, so there is nothing to
+     *    query. THROWS, the same way {@link createCrowd} does — `[]` here would
+     *    say "I searched and there is no route between these points", which is a
+     *    claim about the level rather than about this manager's state. Callers
+     *    that can be in this position gate on {@link hasNavMesh} first.
+     *  - **The query failed.** recast answered `success: false` WITH an error
+     *    (bad half-extents, no polygon near an endpoint, a status code). THROWS,
+     *    naming recast's own error — a failed search is not a searched-and-empty
+     *    one, and the editor's probe already surfaces this separately from "no
+     *    path found".
+     *  - **Genuinely no route.** The query ran and found nothing. `[]`.
+     */
     findPath(start: Vector3Like, end: Vector3Like): Vector3Like[];
     /** Create a crowd with up to maxAgents agents. */
     createCrowd(maxAgents: number): Crowd;

package/dist/ai/navigation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"navigation.d.ts","sourceRoot":"","sources":["../../src/ai/navigation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,aAAa,EAAsB,MAAM,0BAA0B,CAAC;AAC7E,OAAO,KAAK,EAAE,UAAU,EAAW,MAAM,mBAAmB,CAAC;AAC7D,OAAO,EAAE,KAAK,EAAoD,MAAM,mBAAmB,CAAC;AAC5F,OAAO,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC;AAGzC,YAAY,EAAE,UAAU,EAAE,CAAC;AAE3B,MAAM,WAAW,WAAW;IAC1B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED;iEACiE;AACjE,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,WAAW,CAAC;IACtB,QAAQ,EAAE,WAAW,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,kBAAkB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACxC,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,sBAAsB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5C,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACtC;AAID,wBAAsB,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CAIpD;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,OAAO,CAAwB;IACvC,OAAO,CAAC,KAAK,CAA6B;IAC1C,OAAO,CAAC,KAAK,CAAsB;IACnC,OAAO,CAAC,MAAM,CAA8B;IAE5C,2EAA2E;IAC3E,eAAe,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,MAAM,CAAC,EAAE,kBAAkB,GAAG,OAAO;IA4BrE;;;;OAIG;IACH,OAAO,CAAC,aAAa;IAoBrB,iFAAiF;IACjF,UAAU,IAAI,OAAO;IAIrB,+EAA+E;IAC/E,QAAQ,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG,EAAE,WAAW,GAAG,WAAW,EAAE;IAO7D,kDAAkD;IAClD,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,KAAK;IAMrC,sDAAsD;IACtD,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAI7B;;;;OAIG;IACH,cAAc,IAAI,kBAAkB,EAAE;IActC,iGAAiG;IACjG,YAAY,CAAC,KAAK,EAAE,KAAK,GAAG,aAAa,GAAG,IAAI;IAShD,sDAAsD;IACtD,UAAU,IAAI,UAAU;IAKxB,6DAA6D;IAC7D,YAAY,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI;IAQpC,OAAO,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;CAM5B"}
+{"version":3,"file":"navigation.d.ts","sourceRoot":"","sources":["../../src/ai/navigation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,aAAa,EAAsB,MAAM,0BAA0B,CAAC;AAC7E,OAAO,KAAK,EAAE,UAAU,EAAW,MAAM,mBAAmB,CAAC;AAC7D,OAAO,EAAE,KAAK,EAAoD,MAAM,mBAAmB,CAAC;AAC5F,OAAO,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC;AAGzC,YAAY,EAAE,UAAU,EAAE,CAAC;AAE3B,MAAM,WAAW,WAAW;IAC1B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED;iEACiE;AACjE,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,WAAW,CAAC;IACtB,QAAQ,EAAE,WAAW,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,kBAAkB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACxC,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,sBAAsB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5C,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACtC;AAID,wBAAsB,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CAIpD;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,OAAO,CAAwB;IACvC,OAAO,CAAC,KAAK,CAA6B;IAC1C,OAAO,CAAC,KAAK,CAAsB;IACnC,OAAO,CAAC,MAAM,CAA8B;IAE5C,2EAA2E;IAC3E,eAAe,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,MAAM,CAAC,EAAE,kBAAkB,GAAG,OAAO;IA4BrE;;;;OAIG;IACH,OAAO,CAAC,aAAa;IAoBrB,iFAAiF;IACjF,UAAU,IAAI,OAAO;IAIrB;;;;;;;;;;;;;;;;OAgBG;IACH,QAAQ,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG,EAAE,WAAW,GAAG,WAAW,EAAE;IAkB7D,kDAAkD;IAClD,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,KAAK;IAMrC,sDAAsD;IACtD,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAI7B;;;;OAIG;IACH,cAAc,IAAI,kBAAkB,EAAE;IActC,iGAAiG;IACjG,YAAY,CAAC,KAAK,EAAE,KAAK,GAAG,aAAa,GAAG,IAAI;IAShD,sDAAsD;IACtD,UAAU,IAAI,UAAU;IAKxB,6DAA6D;IAC7D,YAAY,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI;IAQpC,OAAO,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;CAM5B"}