@vgai/engine 0.5.15 → 0.5.16

package/dist/adapter/entrypoint-selection-source.js

@@ -0,0 +1,151 @@
+/**
+ * Serve-time rewrite of an entrypoint's swap-slot key.
+ *
+ * The scenes finder (`adapter/finders/scenes-from-entrypoint-selection.ts`)
+ * READS the same facts this module WRITES: a module-level `const <selection>
+ * = { … }` table, indexed by one identifier whose own module-level `const`
+ * is a string literal (`const activeScene = 'main'`). This is not an
+ * extraction of that finder — the finder stays the adapter-selected discovery
+ * algorithm, import-banned everywhere except the adapter loader. The rewrite
+ * is a host-owned mount parameter: play remounts the same entrypoint with a
+ * different declared key, without a new adapter slot and without mutating
+ * the file on disk.
+ *
+ * `typescript` is the same parser the finder already uses. This module is
+ * host-side only — a game's `vgai.adapter.ts` must not import it.
+ */
+import ts from 'typescript';
+function parse(path, source) {
+    return ts.createSourceFile(path, source, ts.ScriptTarget.Latest, true, ts.ScriptKind.TSX);
+}
+function selectionTable(sf, name) {
+    for (const statement of sf.statements) {
+        if (!ts.isVariableStatement(statement))
+            continue;
+        for (const declaration of statement.declarationList.declarations) {
+            if (!ts.isIdentifier(declaration.name) || declaration.name.text !== name)
+                continue;
+            const initializer = declaration.initializer;
+            if (initializer && ts.isObjectLiteralExpression(initializer))
+                return initializer;
+        }
+    }
+    return undefined;
+}
+function propertyKey(property) {
+    const name = property.name;
+    if (!name)
+        return undefined;
+    if (ts.isIdentifier(name) || ts.isStringLiteral(name))
+        return name.text;
+    return undefined;
+}
+function tableKeys(table) {
+    const keys = [];
+    for (const property of table.properties) {
+        const key = propertyKey(property);
+        if (key !== undefined)
+            keys.push(key);
+    }
+    return keys;
+}
+/** The identifier in `scenes[activeScene]`, or a failure to read one. */
+function indexingIdentifier(sf, selection) {
+    const names = new Set();
+    let unreadable = false;
+    const visit = (node) => {
+        if (ts.isElementAccessExpression(node) &&
+            ts.isIdentifier(node.expression) &&
+            node.expression.text === selection) {
+            if (ts.isIdentifier(node.argumentExpression))
+                names.add(node.argumentExpression.text);
+            else
+                unreadable = true;
+        }
+        ts.forEachChild(node, visit);
+    };
+    ts.forEachChild(sf, visit);
+    if (names.size === 0 && !unreadable)
+        return undefined;
+    if (names.size !== 1 || unreadable)
+        return null;
+    return [...names][0];
+}
+function moduleLevelStringLiteral(sf, name) {
+    for (const statement of sf.statements) {
+        if (!ts.isVariableStatement(statement))
+            continue;
+        if ((statement.declarationList.flags & ts.NodeFlags.Const) === 0)
+            continue;
+        for (const declaration of statement.declarationList.declarations) {
+            if (!ts.isIdentifier(declaration.name) || declaration.name.text !== name)
+                continue;
+            const initializer = declaration.initializer;
+            if (initializer && ts.isStringLiteral(initializer))
+                return initializer;
+            return undefined;
+        }
+    }
+    return undefined;
+}
+/**
+ * Rewrite the entrypoint so its swap slot mounts `key` instead of the
+ * source-declared occupant.
+ *
+ * Fails (never guesses) when the source is not the template's shape: no
+ * table, a key the table does not declare, or an index that is not a
+ * module-level `const` string. A no-op rewrite (`key` already at the slot)
+ * is still `ok` — remounting the same key is a real restart.
+ */
+export function rewriteEntrypointSelectionKey(source, path, selection, key) {
+    const sf = parse(path, source);
+    const table = selectionTable(sf, selection);
+    if (!table) {
+        return {
+            ok: false,
+            reason: `${path} declares no module-level \`const ${selection} = { … }\` selection table, ` +
+                'so the host cannot remount it at another key.',
+        };
+    }
+    const keys = tableKeys(table);
+    if (!keys.includes(key)) {
+        return {
+            ok: false,
+            reason: `"${key}" is not a key of ${path}'s \`${selection}\` table ` +
+                `(known: ${keys.length > 0 ? keys.join(', ') : 'none'}).`,
+        };
+    }
+    const identifier = indexingIdentifier(sf, selection);
+    if (identifier === undefined) {
+        return {
+            ok: false,
+            reason: `${path} never indexes \`${selection}\`, so there is no slot key to rewrite.`,
+        };
+    }
+    if (identifier === null) {
+        return {
+            ok: false,
+            reason: `${path} indexes \`${selection}\` with something other than one single identifier, ` +
+                'so the host cannot rewrite the key it mounts.',
+        };
+    }
+    const literal = moduleLevelStringLiteral(sf, identifier);
+    if (!literal) {
+        return {
+            ok: false,
+            reason: `${path} indexes \`${selection}\` with \`${identifier}\`, which is not a ` +
+                'module-level `const` bound to a string literal — the running game cannot be ' +
+                'sent to another key by rewriting the slot.',
+        };
+    }
+    if (literal.text === key)
+        return { ok: true, source, changed: false };
+    const start = literal.getStart(sf);
+    const end = literal.getEnd();
+    const quote = source[start] ?? "'";
+    return {
+        ok: true,
+        source: `${source.slice(0, start)}${quote}${key}${quote}${source.slice(end)}`,
+        changed: true,
+    };
+}

package/dist/adapter/finders/scenes-from-entrypoint-selection.d.ts

@@ -15,7 +15,13 @@
  *
  * Two answers, and the difference is declared rather than sniffed:
  *   - the adapter names a `selection` identifier ⇒ read that module-level
- *     table and answer one entry per key, each reachable through it;
+ *     table and answer one entry per key, each reachable through it — plus
+ *     WHICH key the entrypoint indexes it with right now (`scenes[activeScene]`
+ *     → `const activeScene = 'main'`), marked `reach.active`. That reference is
+ *     load-bearing for the same reason the table is: the running world renders
+ *     exactly that key's composition, which is why the host can treat the
+ *     active entry as the region's own standing document rather than a second
+ *     tab beside it;
  *   - the adapter names none ⇒ the entrypoint mounts ONE composition, and the
  *     answer is the single-scene DEGENERATE table: the region's own
  *     composition, opened by mounting the region.

package/dist/adapter/finders/scenes-from-entrypoint-selection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scenes-from-entrypoint-selection.d.ts","sourceRoot":"","sources":["../../../src/adapter/finders/scenes-from-entrypoint-selection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAGH,OAAO,KAAK,EAGV,mCAAmC,EACpC,MAAM,mBAAmB,CAAC;AAE3B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEpD,6EAA6E;AAC7E,MAAM,WAAW,gBAAgB;IAC/B,wCAAwC;IACxC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,0DAA0D;IAC1D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,8DAA8D;IAC9D,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,8EAA8E;IAC9E,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,kCAAkC;IACjD;;;OAGG;IACH,QAAQ,CAAC,WAAW,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAClD;;;;;;OAMG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC;CACjF;AA2MD;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAC3C,MAAM,EAAE,mCAAmC,EAC3C,KAAK,EAAE,kCAAkC,GACxC,YAAY,CAwBd"}
+{"version":3,"file":"scenes-from-entrypoint-selection.d.ts","sourceRoot":"","sources":["../../../src/adapter/finders/scenes-from-entrypoint-selection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAGH,OAAO,KAAK,EAGV,mCAAmC,EACpC,MAAM,mBAAmB,CAAC;AAE3B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEpD,6EAA6E;AAC7E,MAAM,WAAW,gBAAgB;IAC/B,wCAAwC;IACxC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,0DAA0D;IAC1D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,8DAA8D;IAC9D,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,8EAA8E;IAC9E,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,kCAAkC;IACjD;;;OAGG;IACH,QAAQ,CAAC,WAAW,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAClD;;;;;;OAMG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC;CACjF;AAkUD;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAC3C,MAAM,EAAE,mCAAmC,EAC3C,KAAK,EAAE,kCAAkC,GACxC,YAAY,CA8Bd"}

package/dist/adapter/finders/scenes-from-entrypoint-selection.js

@@ -15,7 +15,13 @@
  *
  * Two answers, and the difference is declared rather than sniffed:
  *   - the adapter names a `selection` identifier ⇒ read that module-level
- *     table and answer one entry per key, each reachable through it;
+ *     table and answer one entry per key, each reachable through it — plus
+ *     WHICH key the entrypoint indexes it with right now (`scenes[activeScene]`
+ *     → `const activeScene = 'main'`), marked `reach.active`. That reference is
+ *     load-bearing for the same reason the table is: the running world renders
+ *     exactly that key's composition, which is why the host can treat the
+ *     active entry as the region's own standing document rather than a second
+ *     tab beside it;
  *   - the adapter names none ⇒ the entrypoint mounts ONE composition, and the
  *     answer is the single-scene DEGENERATE table: the region's own
  *     composition, opened by mounting the region.
@@ -109,6 +115,98 @@ function propertyKey(property) {
         return name.text;
     return undefined;
 }
+/**
+ * The identifier the entrypoint INDEXES the selection table with — the
+ * `activeScene` in `scenes[activeScene]`.
+ *
+ * `undefined` when the module never indexes the table, or indexes it with
+ * anything other than one single identifier: both are honest "cannot be read",
+ * and the caller turns each into its own note.
+ */
+function indexingIdentifier(sf, selection) {
+    const names = new Set();
+    let unreadable = false;
+    const visit = (node) => {
+        if (ts.isElementAccessExpression(node) &&
+            ts.isIdentifier(node.expression) &&
+            node.expression.text === selection) {
+            if (ts.isIdentifier(node.argumentExpression))
+                names.add(node.argumentExpression.text);
+            else
+                unreadable = true;
+        }
+        ts.forEachChild(node, visit);
+    };
+    ts.forEachChild(sf, visit);
+    if (names.size === 0 && !unreadable)
+        return undefined; // never indexed at all
+    if (names.size !== 1 || unreadable)
+        return null; // indexed, but not readably
+    return [...names][0];
+}
+/**
+ * The string a module-level `const <name> = '…'` binds, or `undefined`.
+ *
+ * `const` and a STRING LITERAL are both required: a `let` can be reassigned and
+ * a computed initializer is not a fact the source states, so neither can be
+ * reported as the key the game executes. A type annotation
+ * (`const activeScene: keyof typeof scenes = 'main'`) is irrelevant here — the
+ * initializer is what runs.
+ */
+function moduleLevelString(sf, name) {
+    for (const statement of sf.statements) {
+        if (!ts.isVariableStatement(statement))
+            continue;
+        if ((statement.declarationList.flags & ts.NodeFlags.Const) === 0)
+            continue;
+        for (const declaration of statement.declarationList.declarations) {
+            if (!ts.isIdentifier(declaration.name) || declaration.name.text !== name)
+                continue;
+            const initializer = declaration.initializer;
+            if (initializer && ts.isStringLiteral(initializer))
+                return initializer.text;
+            return undefined;
+        }
+    }
+    return undefined;
+}
+/**
+ * WHICH key the entrypoint mounts at its slot right now, read off the source
+ * the game itself executes.
+ *
+ * Every failure is a NOTE and answers `undefined`: an unread active key costs
+ * a retitle, while a guessed one would open the wrong composition as the
+ * region's own document.
+ */
+function activeSelectionKey(entrypoint, sf, selection, keys, notes) {
+    const identifier = indexingIdentifier(sf, selection);
+    if (identifier === undefined) {
+        notes.push(`scenesFromEntrypointSelection: ${entrypoint.path} never indexes \`${selection}\`, so ` +
+            'which of its compositions the entrypoint mounts is not stated in the source and no ' +
+            'entry is settled as the active one.');
+        return undefined;
+    }
+    if (identifier === null) {
+        notes.push(`scenesFromEntrypointSelection: ${entrypoint.path} indexes \`${selection}\` with ` +
+            'something other than one single identifier, so the key it mounts cannot be read ' +
+            'statically.');
+        return undefined;
+    }
+    const key = moduleLevelString(sf, identifier);
+    if (key === undefined) {
+        notes.push(`scenesFromEntrypointSelection: ${entrypoint.path} indexes \`${selection}\` with ` +
+            `\`${identifier}\`, which is not a module-level \`const\` bound to a string literal, ` +
+            'so the key it mounts cannot be read statically.');
+        return undefined;
+    }
+    if (!keys.includes(key)) {
+        notes.push(`scenesFromEntrypointSelection: ${entrypoint.path} mounts \`${selection}\` under ` +
+            `"${key}", which is not a key of that table. The entrypoint and its own selection ` +
+            'table disagree.');
+        return undefined;
+    }
+    return key;
+}
 /** The identifier a selection entry's value names, if it names one at all. */
 function propertyIdentifier(property) {
     if (ts.isShorthandPropertyAssignment(property))
@@ -166,17 +264,21 @@ function degenerateEntry(entrypoint, sf) {
         finder: 'scenesFromEntrypointSelection',
     };
 }
-/** One entry per key of the entrypoint's own selection table. */
+/**
+ * One entry per key of the entrypoint's own selection table, plus WHICH of
+ * them the entrypoint currently mounts at the slot (`active`).
+ */
 function selectionEntries(entrypoint, sf, selection, resolveModule, notes) {
     const table = selectionTable(sf, selection);
     if (!table) {
         notes.push(`scenesFromEntrypointSelection: ${entrypoint.path} declares no module-level ` +
             `\`const ${selection} = { … }\` selection table. Nothing is assumed in its ` +
             'place — fix the adapter’s `selection` or the entrypoint.');
-        return [];
+        return { entries: [], active: undefined };
     }
     const bindings = importedBindings(sf);
-    const entries = [];
+    const keys = [];
+    const built = [];
     for (const property of table.properties) {
         const key = propertyKey(property);
         if (key === undefined) {
@@ -185,19 +287,30 @@ function selectionEntries(entrypoint, sf, selection, resolveModule, notes) {
             continue;
         }
         const identifier = propertyIdentifier(property);
-        const source = sourceFor(identifier ? bindings.get(identifier) : undefined, entrypoint.path, resolveModule);
-        entries.push({
-            id: key,
+        keys.push(key);
+        built.push({
+            key,
             label: identifier ?? key,
-            kind: 'scene',
-            region: entrypoint.regionId,
-            authorable: true,
-            reach: { kind: 'entrypoint-selection', selection, key },
-            ...(source ? { source } : {}),
-            finder: 'scenesFromEntrypointSelection',
+            source: sourceFor(identifier ? bindings.get(identifier) : undefined, entrypoint.path, resolveModule),
         });
     }
-    return entries;
+    const active = activeSelectionKey(entrypoint, sf, selection, keys, notes);
+    const entries = built.map(({ key, label, source }) => ({
+        id: key,
+        label,
+        kind: 'scene',
+        region: entrypoint.regionId,
+        authorable: true,
+        reach: {
+            kind: 'entrypoint-selection',
+            selection,
+            key,
+            ...(key === active ? { active: true } : {}),
+        },
+        ...(source ? { source } : {}),
+        finder: 'scenesFromEntrypointSelection',
+    }));
+    return { entries, active };
 }
 /**
  * Answer the scene table this finder's selection describes.
@@ -208,6 +321,7 @@ function selectionEntries(entrypoint, sf, selection, resolveModule, notes) {
 export function scenesFromEntrypointSelection(params, input) {
     const notes = [];
     const entries = [];
+    const active = [];
     for (const entrypoint of targetedEntrypoints(params, input.entrypoints, notes)) {
         if (entrypoint.source === null) {
             notes.push(`scenesFromEntrypointSelection: could not read ${entrypoint.path} (region ` +
@@ -215,12 +329,19 @@ export function scenesFromEntrypointSelection(params, input) {
             continue;
         }
         const sf = parse(entrypoint.path, entrypoint.source);
-        entries.push(...(params.selection === undefined
-            ? [degenerateEntry(entrypoint, sf)]
-            : selectionEntries(entrypoint, sf, params.selection, input.resolveModule, notes)));
+        if (params.selection === undefined) {
+            entries.push(degenerateEntry(entrypoint, sf));
+            continue;
+        }
+        const found = selectionEntries(entrypoint, sf, params.selection, input.resolveModule, notes);
+        entries.push(...found.entries);
+        if (found.active !== undefined)
+            active.push(found.active);
     }
-    // One candidate settles the default; two or more is a choice, and a choice
-    // belongs to the adapter author.
-    const only = entries.length === 1 ? entries[0] : undefined;
-    return only ? { entries, default: only.id, notes } : { entries, notes };
+    // The ACTIVE key settles the default outright: the entrypoint states which
+    // composition it mounts, so this is the finder READING an answer rather than
+    // choosing between candidates. Failing that, one candidate settles it; two or
+    // more is a choice, and a choice belongs to the adapter author.
+    const settled = active.length === 1 ? active[0] : entries.length === 1 ? entries[0]?.id : undefined;
+    return settled !== undefined ? { entries, default: settled, notes } : { entries, notes };
 }

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

@@ -10,14 +10,24 @@
  * `createInputManagerAdapter`/`createVgaiAssetAdapter` went with
  * `SystemAdapters.input`/`.assets` — registered, never read by anything.)
  */
+import type * as THREE from 'three';
 import type { NavMeshManager } from '../ai/navigation';
 import type { AudioContext as GameAudio } from '../setup/setup-audio';
-import type { AudioAdapter, NavigationAdapter } from './system-adapter';
+import type { AudioAdapter, NavBakeParams, 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;
+ *  capabilities the editor's Navigation panel binds through.
+ *
+ * `clear` is deliberately owner-supplied: a manager cannot know which gameplay
+ * objects retain CrowdAgent handles, so disposing it generically would leave
+ * those handles pointing at freed WASM memory. A game that grants clear owns
+ * releasing/rebinding those references in the same callback. `bake` may be
+ * overridden for the same reason when a live crowd must be rebuilt. */
+export declare function createNavigationAdapter(nav: NavMeshManager, ownerCapabilities?: {
+    readonly bake?: (meshes: THREE.Mesh[], params?: NavBakeParams) => boolean;
+    readonly clear?: (scene: THREE.Scene) => void;
+}): NavigationAdapter;
 //# sourceMappingURL=first-party-systems.d.ts.map

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

@@ -1 +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,EAKZ,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,CAiKvE;AAED;;gEAEgE;AAChE,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,cAAc,GAAG,iBAAiB,CAS9E"}
+{"version":3,"file":"first-party-systems.d.ts","sourceRoot":"","sources":["../../src/adapter/first-party-systems.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,KAAK,KAAK,MAAM,OAAO,CAAC;AACpC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAAE,YAAY,IAAI,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACtE,OAAO,KAAK,EACV,YAAY,EAKZ,aAAa,EACb,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,CAiKvE;AAED;;;;;;;;uEAQuE;AACvE,wBAAgB,uBAAuB,CACrC,GAAG,EAAE,cAAc,EACnB,iBAAiB,GAAE;IACjB,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,EAAE,EAAE,MAAM,CAAC,EAAE,aAAa,KAAK,OAAO,CAAC;IAC1E,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,KAAK,IAAI,CAAC;CAC1C,GACL,iBAAiB,CAUnB"}

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

@@ -212,14 +212,21 @@ export function createAudioSystemAdapter(audio) {
 }
 /** 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) {
+ *  capabilities the editor's Navigation panel binds through.
+ *
+ * `clear` is deliberately owner-supplied: a manager cannot know which gameplay
+ * objects retain CrowdAgent handles, so disposing it generically would leave
+ * those handles pointing at freed WASM memory. A game that grants clear owns
+ * releasing/rebinding those references in the same callback. `bake` may be
+ * overridden for the same reason when a live crowd must be rebuilt. */
+export function createNavigationAdapter(nav, ownerCapabilities = {}) {
     return {
         hasNavMesh: () => nav.hasNavMesh(),
         findPath: (start, end) => nav.findPath(start, end),
         debugMesh: (scene) => nav.getDebugMesh(scene),
-        bake: (meshes, params) => nav.buildFromMeshes(meshes, params),
+        bake: ownerCapabilities.bake ?? ((meshes, params) => nav.buildFromMeshes(meshes, params)),
         exportData: () => nav.exportData(),
+        ...(ownerCapabilities.clear ? { clear: ownerCapabilities.clear } : {}),
         crowdAgents: () => nav.getCrowdAgents(),
     };
 }

package/dist/adapter/index.d.ts

@@ -23,15 +23,20 @@
  *   `@engine/adapter/first-party-systems`       createNavigationAdapter
  */
 export type { AdapterSurface } from './adapter-surface';
-export type { AssetDropContext, AssetDropProvider, AssetSubjectProvider, AuthoringAdapter, AuthoringAssetSubject, AuthoringCapabilities, AuthoringProvenance, AuthoringProviderKey, BoxEditProvider, BoxEditReferencePoint, ColorSampleProvider, ComponentInstanceApplyResult, ComponentInstanceDescription, ComponentInstanceOverride, ComponentInstancesProvider, CreationSiteProvider, DOMRectLike, EditorNode, EditorNodeRole, HierarchyProvider, InspectorProvider, NodeCreationSite, PersistenceProvider, PickProvider, PropertyDescriptor, RectProvider, RelatedSubjectLink, RelatedSubjectsProvider, SelectionProvider, SelectionResolution, SpatialDragHandle, SpatialHandleGuide, SpatialHandleLayer, SpatialHandlesProvider, SpatialPoint3, StoriesProvider, StoryRef, StructureProvider, TextProvider, TransformChannel, TransformEditability, TransformObservation, TransformProvider, WriteAck, WriteAnchorKind, } from './authoring';
+export type { AssetDropContext, AssetDropProvider, AssetSubjectProvider, AuthoringAdapter, AuthoringAssetSubject, AuthoringCapabilities, AuthoringProvenance, AuthoringProviderKey, AuthoringTruth, BoxEditProvider, BoxEditReferencePoint, ColorSampleProvider, ComponentInstanceApplyResult, ComponentInstanceDescription, ComponentInstanceOverride, ComponentInstancesProvider, DOMRectLike, EditorNode, EditorNodeRole, HierarchyProvider, InspectorProvider, NodeCreationSite, PersistenceProvider, PickProvider, PropertyDescriptor, RectProvider, RelatedSubjectLink, RelatedSubjectsProvider, SelectionProvider, SelectionResolution, SpatialDragHandle, SpatialHandleGuide, SpatialHandleLayer, SpatialHandlesProvider, SpatialPoint3, StoriesProvider, StoryRef, StructuralClipboardOutcome, StructuralIdsWrite, StructuralIdWrite, StructuralWriteOutcome, StructureProvider, TextProvider, TransformChannel, TransformEditability, TransformObservation, TransformProvider, TransformSourceCommitProvider, TruthProvider, WriteAck, WriteAnchorKind, } from './authoring';
 export { AUTHORING_PROVIDER_KEYS, emptyWriteAnchorKindCounts, measureAuthoringProviders, WRITE_ANCHOR_KINDS, } from './authoring';
+export { AUTHORING_ADAPTER_SHAPE, AUTHORING_PROVIDER_SHAPES, HIERARCHY_PROVIDER_SHAPE, } from './authoring-seam-contract';
 export type { ColyseusNetworkingConfig } from './colyseus-networking-adapter';
 export type { CanvasHostContext, DomHostContext, HostContextBase, HostContextFor, HostSurface, ThreeHostContext, } from './host-context';
 export type { MountedPixiRoot, MountedReactRoot, MountedRoot, MountedRootBase, MountedThreeRoot, RootAdapter, RootStateObserver, SurfaceAdapter, SurfaceAdapterFor, } from './root-adapter';
+export { MOUNTED_CANVAS_SURFACE_SHAPE, MOUNTED_DOM_SURFACE_SHAPE, MOUNTED_ROOT_BASE_SHAPE, MOUNTED_THREE_SURFACE_SHAPE, ROOT_ADAPTER_SHAPE, ROOT_STATE_OBSERVER_SHAPE, } from './root-seam-contract';
+export type { SeamEvidenceOutcome, SeamEvidenceReceipt, SeamEvidenceSource, SeamEvidenceState, SeamEvidenceVerdict, SeamProofStage, SeamShape, } from './seam-evidence';
+export { defineSeamShape, gradeSeamCarrier, gradeSeamEvidence, inspectSeamShape, SEAM_PROOF_STAGES, SeamEvidenceLedger, seamStageAtLeast, } from './seam-evidence';
 export type { MountedSetupThreeRoot, SetupThreeRootConfig } from './setup-three-root-adapter';
-export type { AudioAdapter, AudioDebugEvent, AudioGraphNode, AudioMeterFrame, AudioMeterHandle, AudioRecordingHandle, AudioTransportState, CameraAdapter, CameraRuntimeCamera, CameraRuntimeSnapshot, CameraRuntimeTransition, ConnectionState, NavCrowdAgentState, NavigationAdapter, NavPoint, NetConditioning, NetMessageEvent, NetPeer, NetPlayerIdentity, NetRates, NetServerConfig, NetworkingAdapter, PhysicsAdapter, PhysicsCarrier, PhysicsColliderShape, PhysicsColliderSnapshot, PhysicsJointSnapshot, PhysicsJointType, RenderDebugAdapter, ReplicationStats, RoomInfo, SystemAdapters, Unsubscribe, } from './system-adapter';
+export type { AudioAdapter, AudioDebugEvent, AudioGraphNode, AudioMeterFrame, AudioMeterHandle, AudioRecordingHandle, AudioTransportState, CameraAdapter, CameraRuntimeCamera, CameraRuntimeSnapshot, CameraRuntimeTransition, ConnectionState, DebugAdapter, NavCrowdAgentState, NavigationAdapter, NavPoint, NetConditioning, NetMessageEvent, NetPeer, NetPlayerIdentity, NetRates, NetServerConfig, NetworkingAdapter, PhysicsAdapter, PhysicsCarrier, PhysicsColliderShape, PhysicsColliderSnapshot, PhysicsJointSnapshot, PhysicsJointType, RenderDebugAdapter, ReplicationStats, RoomInfo, SystemAdapters, Unsubscribe, } from './system-adapter';
 /** The two narrowings of the tagged `SystemAdapters['physics']` union — see
  *  `PhysicsAdapter`'s comment for why it is tagged at all. */
 export { displayKeyedPhysics, nodeKeyedPhysics } from './system-adapter';
+export { AUDIO_ADAPTER_SHAPE, CAMERA_ADAPTER_SHAPE, DEBUG_ADAPTER_SHAPE, NAVIGATION_ADAPTER_SHAPE, NETWORKING_ADAPTER_SHAPE, PHYSICS_2D_ADAPTER_SHAPE, PHYSICS_ADAPTER_SHAPE, RENDER_DEBUG_ADAPTER_SHAPE, SYSTEM_ADAPTERS_SHAPE, SYSTEM_PROVIDER_SHAPES, } from './system-seam-contract';
 export type { Transform, TransformOwner } from './transform';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/adapter/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,YAAY,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,YAAY,EACV,gBAAgB,EAChB,iBAAiB,EACjB,oBAAoB,EACpB,gBAAgB,EAChB,qBAAqB,EACrB,qBAAqB,EACrB,mBAAmB,EACnB,oBAAoB,EACpB,eAAe,EACf,qBAAqB,EACrB,mBAAmB,EACnB,4BAA4B,EAC5B,4BAA4B,EAC5B,yBAAyB,EACzB,0BAA0B,EAC1B,oBAAoB,EACpB,WAAW,EACX,UAAU,EACV,cAAc,EACd,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,mBAAmB,EACnB,YAAY,EACZ,kBAAkB,EAClB,YAAY,EACZ,kBAAkB,EAClB,uBAAuB,EACvB,iBAAiB,EACjB,mBAAmB,EACnB,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,EAClB,sBAAsB,EACtB,aAAa,EACb,eAAe,EACf,QAAQ,EACR,iBAAiB,EACjB,YAAY,EACZ,gBAAgB,EAChB,oBAAoB,EACpB,oBAAoB,EACpB,iBAAiB,EACjB,QAAQ,EACR,eAAe,GAChB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,uBAAuB,EACvB,0BAA0B,EAC1B,yBAAyB,EACzB,kBAAkB,GACnB,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAC9E,YAAY,EACV,iBAAiB,EACjB,cAAc,EACd,eAAe,EACf,cAAc,EACd,WAAW,EACX,gBAAgB,GACjB,MAAM,gBAAgB,CAAC;AACxB,YAAY,EACV,eAAe,EACf,gBAAgB,EAChB,WAAW,EACX,eAAe,EACf,gBAAgB,EAChB,WAAW,EACX,iBAAiB,EACjB,cAAc,EACd,iBAAiB,GAClB,MAAM,gBAAgB,CAAC;AACxB,YAAY,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAC9F,YAAY,EACV,YAAY,EACZ,eAAe,EACf,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,oBAAoB,EACpB,mBAAmB,EACnB,aAAa,EACb,mBAAmB,EACnB,qBAAqB,EACrB,uBAAuB,EACvB,eAAe,EACf,kBAAkB,EAClB,iBAAiB,EACjB,QAAQ,EACR,eAAe,EACf,eAAe,EACf,OAAO,EACP,iBAAiB,EACjB,QAAQ,EACR,eAAe,EACf,iBAAiB,EACjB,cAAc,EACd,cAAc,EACd,oBAAoB,EACpB,uBAAuB,EACvB,oBAAoB,EACpB,gBAAgB,EAChB,kBAAkB,EAClB,gBAAgB,EAChB,QAAQ,EACR,cAAc,EACd,WAAW,GACZ,MAAM,kBAAkB,CAAC;AAC1B;8DAC8D;AAC9D,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACzE,YAAY,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/adapter/index.ts"],"names":[],"mappings":"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"}

package/dist/adapter/index.js

@@ -23,6 +23,10 @@
  *   `@engine/adapter/first-party-systems`       createNavigationAdapter
  */
 export { AUTHORING_PROVIDER_KEYS, emptyWriteAnchorKindCounts, measureAuthoringProviders, WRITE_ANCHOR_KINDS, } from './authoring';
+export { AUTHORING_ADAPTER_SHAPE, AUTHORING_PROVIDER_SHAPES, HIERARCHY_PROVIDER_SHAPE, } from './authoring-seam-contract';
+export { MOUNTED_CANVAS_SURFACE_SHAPE, MOUNTED_DOM_SURFACE_SHAPE, MOUNTED_ROOT_BASE_SHAPE, MOUNTED_THREE_SURFACE_SHAPE, ROOT_ADAPTER_SHAPE, ROOT_STATE_OBSERVER_SHAPE, } from './root-seam-contract';
+export { defineSeamShape, gradeSeamCarrier, gradeSeamEvidence, inspectSeamShape, SEAM_PROOF_STAGES, SeamEvidenceLedger, seamStageAtLeast, } from './seam-evidence';
 /** The two narrowings of the tagged `SystemAdapters['physics']` union — see
  *  `PhysicsAdapter`'s comment for why it is tagged at all. */
 export { displayKeyedPhysics, nodeKeyedPhysics } from './system-adapter';
+export { AUDIO_ADAPTER_SHAPE, CAMERA_ADAPTER_SHAPE, DEBUG_ADAPTER_SHAPE, NAVIGATION_ADAPTER_SHAPE, NETWORKING_ADAPTER_SHAPE, PHYSICS_2D_ADAPTER_SHAPE, PHYSICS_ADAPTER_SHAPE, RENDER_DEBUG_ADAPTER_SHAPE, SYSTEM_ADAPTERS_SHAPE, SYSTEM_PROVIDER_SHAPES, } from './system-seam-contract';

package/dist/adapter/ingest/contract-system-adapters.d.ts

@@ -54,7 +54,7 @@ export type ContractSystemSlot = keyof VgaiGameSystemAdapters;
 export type ContractSurface = 'three' | 'canvas' | 'dom';
 /** Fixed slot order, so two reports of the same mount are diffable line for
  *  line (the same rule the coverage report's row order follows). */
-export declare const CONTRACT_SYSTEM_SLOTS: readonly ContractSystemSlot[];
+export declare const CONTRACT_SYSTEM_SLOTS: ContractSystemSlot[];
 /** One slot the game positively answered as having nothing behind it. */
 export interface ContractSystemEmptySlot {
     readonly slot: ContractSystemSlot;

package/dist/adapter/ingest/contract-system-adapters.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"contract-system-adapters.d.ts","sourceRoot":"","sources":["../../../src/adapter/ingest/contract-system-adapters.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,KAAK,EAAE,sBAAsB,EAAuB,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEpG;wEACwE;AACxE,MAAM,MAAM,kBAAkB,GAAG,MAAM,sBAAsB,CAAC;AA+B9D;;;;GAIG;AACH,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,QAAQ,GAAG,KAAK,CAAC;AAezD;oEACoE;AACpE,eAAO,MAAM,qBAAqB,EAAE,SAAS,kBAAkB,EAO9D,CAAC;AAEF,yEAAyE;AACzE,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC;IAClC,sDAAsD;IACtD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,iEAAiE;AACjE,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,+BAA+B;IAC9C,uEAAuE;IACvE,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,cAAc,EAAE,kBAAkB,CAAC,CAAC,CAAC;IAClE,2DAA2D;IAC3D,QAAQ,CAAC,KAAK,EAAE,SAAS,uBAAuB,EAAE,CAAC;IACnD,wEAAwE;IACxE,QAAQ,CAAC,SAAS,EAAE,SAAS,2BAA2B,EAAE,CAAC;CAC5D;AA8FD;;;;;;;;GAQG;AACH,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,eAAe,GAAG,SAAS,GAAG,IAAI,EAC3C,OAAO,CAAC,EAAE,eAAe,GAAG,SAAS,GACpC,+BAA+B,CAoBjC"}
+{"version":3,"file":"contract-system-adapters.d.ts","sourceRoot":"","sources":["../../../src/adapter/ingest/contract-system-adapters.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AASxD,OAAO,KAAK,EAAE,sBAAsB,EAAuB,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAGpG;wEACwE;AACxE,MAAM,MAAM,kBAAkB,GAAG,MAAM,sBAAsB,CAAC;AAoB9D;;;;GAIG;AACH,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,QAAQ,GAAG,KAAK,CAAC;AAezD;oEACoE;AACpE,eAAO,MAAM,qBAAqB,EAE7B,kBAAkB,EAAE,CAAC;AAE1B,yEAAyE;AACzE,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC;IAClC,sDAAsD;IACtD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,iEAAiE;AACjE,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,+BAA+B;IAC9C,uEAAuE;IACvE,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,cAAc,EAAE,kBAAkB,CAAC,CAAC,CAAC;IAClE,2DAA2D;IAC3D,QAAQ,CAAC,KAAK,EAAE,SAAS,uBAAuB,EAAE,CAAC;IACnD,wEAAwE;IACxE,QAAQ,CAAC,SAAS,EAAE,SAAS,2BAA2B,EAAE,CAAC;CAC5D;AAiGD;;;;;;;;GAQG;AACH,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,eAAe,GAAG,SAAS,GAAG,IAAI,EAC3C,OAAO,CAAC,EAAE,eAAe,GAAG,SAAS,GACpC,+BAA+B,CAoBjC"}

package/dist/adapter/ingest/contract-system-adapters.js

@@ -41,6 +41,8 @@
  *
  * Nothing here calls a declared method. Presence and shape only.
  */
+import { AUDIO_ADAPTER_SHAPE, CAMERA_ADAPTER_SHAPE, NAVIGATION_ADAPTER_SHAPE, NETWORKING_ADAPTER_SHAPE, PHYSICS_ADAPTER_SHAPE, RENDER_DEBUG_ADAPTER_SHAPE, } from '../system-seam-contract';
+import { GAME_SYSTEM_ADAPTERS_SHAPE } from './game-contract-seams';
 /**
  * The members each slot's interface makes NON-optional. A declaration missing
  * one of these cannot honour the interface, whatever else it carries.
@@ -50,22 +52,13 @@
  * is typed as keys of its own adapter), so it cannot drift into naming a member
  * that does not exist.
  */
-const REQUIRED_MEMBERS = {
-    physics: ['ownerOf', 'freeze', 'commit', 'unfreeze'],
-    networking: [
-        'peers',
-        'networkId',
-        'authority',
-        'editable',
-        'getConnectionState',
-        'getRoomInfo',
-        'getReplicationStats',
-        'subscribe',
-    ],
-    navigation: ['hasNavMesh', 'findPath', 'debugMesh'],
-    audio: ['setMuted', 'isMuted'],
-    camera: ['snapshot', 'subscribe'],
-    renderDebug: ['captureFrame'],
+const SYSTEM_SHAPES = {
+    physics: PHYSICS_ADAPTER_SHAPE,
+    networking: NETWORKING_ADAPTER_SHAPE,
+    navigation: NAVIGATION_ADAPTER_SHAPE,
+    audio: AUDIO_ADAPTER_SHAPE,
+    camera: CAMERA_ADAPTER_SHAPE,
+    renderDebug: RENDER_DEBUG_ADAPTER_SHAPE,
 };
 /**
  * THE surface→physics-vocabulary rule, stated once.
@@ -81,14 +74,7 @@ const PHYSICS_KEYING_BY_SURFACE = {
 };
 /** Fixed slot order, so two reports of the same mount are diffable line for
  *  line (the same rule the coverage report's row order follows). */
-export const CONTRACT_SYSTEM_SLOTS = [
-    'physics',
-    'networking',
-    'navigation',
-    'audio',
-    'camera',
-    'renderDebug',
-];
+export const CONTRACT_SYSTEM_SLOTS = Object.keys(GAME_SYSTEM_ADAPTERS_SHAPE);
 const EMPTY_PROJECTION = {
     bound: {},
     empty: [],
@@ -99,7 +85,9 @@ function isEmptyRecord(value) {
 }
 function missingMembers(slot, value) {
     const missing = [];
-    for (const member of REQUIRED_MEMBERS[slot]) {
+    for (const [member, spec] of Object.entries(SYSTEM_SHAPES[slot])) {
+        if (spec.optional)
+            continue;
         if (typeof value[member] !== 'function') {
             missing.push(member);
         }