@vgai/engine 0.5.10 → 0.5.12

package/dist/ecs/user-data.js

@@ -76,12 +76,39 @@
  *                           implementation parts without adding wrappers.
  * - `authoringLabel`      — authored literal name (or component tag fallback)
  *                           for that source-backed component instance.
+ * - `authoringComponent`  — exact source component identity for portable-CSF
+ *                           association; unlike the label, never user-facing copy.
+ * - `authoringDocument`   — generic reference to the project-tool document
+ *                           that owns this scene instance's authored asset.
  * - `editorHelper`        — `true` for editor-only helper objects (gizmos, wireframes).
+ *
+ * Hierarchy-presentation convention (written by GAME code, read by the editor —
+ * see `../adapter/hierarchy-marks.ts`, which is the ONLY place these two are
+ * read/written from; the `vgai` prefix marks them as the HOST's namespace on a
+ * node a game owns, unlike every other key above, which the engine/editor also
+ * write):
+ * - `vgaiComponentRoot`   — display name of the component instance this subtree
+ *                           IS. The node renders as one collapsed, expandable
+ *                           row named for it.
+ * - `vgaiBuiltInternal`   — `true` on the ROOT of a subtree runtime code
+ *                           CONSTRUCTED rather than authored (skeleton bones,
+ *                           particle renderers). Subtree-scoped: everything
+ *                           below a marked node is built-internal too.
+ * - `vgaiBodyOwner`       — the rigid body that OWNS this node's pose, written
+ *                           by the code that attaches the body (see
+ *                           `../adapter/body-marks.ts`, the only reader/writer).
+ *                           A transform edit on such a node must be applied to
+ *                           the BODY, or the next physics step writes the node
+ *                           straight back.
  * - `editorHelperType`    — which kind of helper (lights/particles/pivot/navmesh/...).
  * - `editorIcon`          — `true` for editor billboard icon sprites.
  * - `skeletonVisible`     — per-entity editor preference for its bone overlay.
  * - `skeletonEnabled`     — resolved visibility preference on a skeleton helper.
  * - `envObject`           — `true` for environment objects (ambient light, etc.).
+ * - `reflectionProbe`     — live project-owned reflection probe projected from
+ *                           JSX props for renderer/editor integration.
+ * - `constraints`         — live project-owned spatial constraints projected
+ *                           into the shared Inspector and viewport.
  * - `splineControlPoint`  — index of a spline control-point drag handle.
  * - `vcDirIdx`            — view-cube face direction index (0=+X,1=-X,2=+Y,...).
  */
@@ -115,12 +142,19 @@ export const UserDataKeys = {
     authoringRoot: 'authoringRoot',
     authoringInstance: 'authoringInstance',
     authoringLabel: 'authoringLabel',
+    vgaiComponentRoot: 'vgaiComponentRoot',
+    vgaiBuiltInternal: 'vgaiBuiltInternal',
+    vgaiBodyOwner: 'vgaiBodyOwner',
+    authoringComponent: 'authoringComponent',
+    authoringDocument: 'authoringDocument',
     editorHelper: 'editorHelper',
     editorHelperType: 'editorHelperType',
     editorIcon: 'editorIcon',
     skeletonVisible: 'skeletonVisible',
     skeletonEnabled: 'skeletonEnabled',
     envObject: 'envObject',
+    constraints: 'constraints',
+    reflectionProbe: 'reflectionProbe',
     vcDirIdx: 'vcDirIdx',
     navPathPoints: 'navPathPoints',
 };

package/dist/index.d.ts

@@ -20,14 +20,13 @@
  *   - game setup contract: `GameContext`/`GameCleanup`/`GameSetupFn`, `fromSetup`
  *   - surface vocabulary: `AdapterSurface`
  *   - manifest-driven mount: `mountManifestRoots` + its option/result types
- *   - asset-format entry points: `parseMaterialFile` (.mat.json), `parseInstancesFile`
  *   - game manifest (vgai.project.json) entry point: `loadGameManifest`
  */
 export type { AdapterSurface } from './adapter/adapter-surface';
 export { fromSetup } from './adapter/setup-three-root-adapter';
-export { AssetParseError, parseInstancesFile, parseMaterialFile } from './asset-formats/parse';
+export { AssetParseError } from './asset-parse-error';
 export type { AdapterRoot, GameManifest, ResolvedAdapter, ResolvedAdapterRoot, ResolvedGameManifest, RootAdapter, } from './manifest';
-export { CAPABILITY_CEILINGS, DEFAULT_SERVER_MODULE, loadGameManifest } from './manifest';
+export { DEFAULT_SERVER_MODULE, loadGameManifest } from './manifest';
 export type { GameSession } from './runtime/create-runtime';
 export type { MountEntry, MountedManifestSession, MountManifestOptions, } from './runtime/mount-manifest';
 export { mountManifestRoots } from './runtime/mount-manifest';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,YAAY,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAE,SAAS,EAAE,MAAM,oCAAoC,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC/F,YAAY,EACV,WAAW,EACX,YAAY,EACZ,eAAe,EACf,mBAAmB,EACnB,oBAAoB,EACpB,WAAW,GACZ,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC1F,YAAY,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,YAAY,EACV,UAAU,EACV,sBAAsB,EACtB,oBAAoB,GACrB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,YAAY,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAE,SAAS,EAAE,MAAM,oCAAoC,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,YAAY,EACV,WAAW,EACX,YAAY,EACZ,eAAe,EACf,mBAAmB,EACnB,oBAAoB,EACpB,WAAW,GACZ,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACrE,YAAY,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,YAAY,EACV,UAAU,EACV,sBAAsB,EACtB,oBAAoB,GACrB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -20,10 +20,9 @@
  *   - game setup contract: `GameContext`/`GameCleanup`/`GameSetupFn`, `fromSetup`
  *   - surface vocabulary: `AdapterSurface`
  *   - manifest-driven mount: `mountManifestRoots` + its option/result types
- *   - asset-format entry points: `parseMaterialFile` (.mat.json), `parseInstancesFile`
  *   - game manifest (vgai.project.json) entry point: `loadGameManifest`
  */
 export { fromSetup } from './adapter/setup-three-root-adapter';
-export { AssetParseError, parseInstancesFile, parseMaterialFile } from './asset-formats/parse';
-export { CAPABILITY_CEILINGS, DEFAULT_SERVER_MODULE, loadGameManifest } from './manifest';
+export { AssetParseError } from './asset-parse-error';
+export { DEFAULT_SERVER_MODULE, loadGameManifest } from './manifest';
 export { mountManifestRoots } from './runtime/mount-manifest';

package/dist/manifest/index.d.ts

@@ -1,6 +1,6 @@
 export { isManifestFilename, MANIFEST_FILENAME, REMOVED_MANIFEST_FILENAME, removedManifestFilenameMessage, } from './filename';
 export type { ResolvedAdapter, ResolvedAdapterRoot, ResolvedGameManifest } from './load';
-export { CAPABILITY_CEILINGS, DEFAULT_SERVER_MODULE, loadGameManifest } from './load';
-export type { AdapterRoot, GameManifest, IngestStrategy, RootAdapter, Tier, } from './schema';
-export { AdapterRootSchema, GameManifestSchema, IngestStrategySchema, RootAdapterSchema, TierSchema, } from './schema';
+export { DEFAULT_SERVER_MODULE, loadGameManifest } from './load';
+export type { AdapterRoot, GameManifest, RootAdapter } from './schema';
+export { AdapterRootSchema, GameManifestSchema, RootAdapterSchema } from './schema';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/manifest/index.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,yBAAyB,EACzB,8BAA8B,GAC/B,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,eAAe,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,QAAQ,CAAC;AACzF,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,QAAQ,CAAC;AACtF,YAAY,EACV,WAAW,EACX,YAAY,EACZ,cAAc,EACd,WAAW,EACX,IAAI,GACL,MAAM,UAAU,CAAC;AAClB,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,EACpB,iBAAiB,EACjB,UAAU,GACX,MAAM,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/manifest/index.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,yBAAyB,EACzB,8BAA8B,GAC/B,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,eAAe,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,QAAQ,CAAC;AACzF,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,QAAQ,CAAC;AACjE,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACvE,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC"}

package/dist/manifest/index.js

@@ -1,8 +1,8 @@
 // Game manifest (vgai.project.json) — schema + loader (T3.1 slice
 // 1)..
 export { isManifestFilename, MANIFEST_FILENAME, REMOVED_MANIFEST_FILENAME, removedManifestFilenameMessage, } from './filename';
-export { CAPABILITY_CEILINGS, DEFAULT_SERVER_MODULE, loadGameManifest } from './load';
-export { AdapterRootSchema, GameManifestSchema, IngestStrategySchema, RootAdapterSchema, TierSchema, } from './schema';
+export { DEFAULT_SERVER_MODULE, loadGameManifest } from './load';
+export { AdapterRootSchema, GameManifestSchema, RootAdapterSchema } from './schema';
 // `loadGameManifestFile` (Node-only, reads `path` via `node:fs`) is
 // deliberately NOT re-exported here — this barrel must stay import-safe for
 // browser bundles. Import it directly from `@engine/manifest/load-file` in

package/dist/manifest/load.d.ts

@@ -1,4 +1,4 @@
-import { type IngestStrategy, type LearnMetadata, type Tier } from './schema';
+import { type LearnMetadata } from './schema';
 /** D6's resolved adapter identities. */
 export type ResolvedAdapter = {
     readonly type: 'builtin';
@@ -13,18 +13,24 @@ export type ResolvedAdapter = {
     readonly type: 'ingest';
     readonly identity: 'ingest-three' | 'ingest-pixi' | 'ingest-react';
     readonly surface: 'three' | 'canvas' | 'dom';
-    readonly strategy: IngestStrategy;
-    readonly entryHtml: string | undefined;
+    /**
+     * Project-relative ES module declaring `window.vgaiGame` beside a
+     * pristine copy. OPTIONAL rather than required-and-possibly-undefined
+     * (the shape its siblings above use) because most ingested games have
+     * nothing to say about it, and requiring the key would only make every
+     * construction site say `undefined`.
+     */
+    readonly contractShim?: string | undefined;
+    /**
+     * Project-relative ES module that writes this game'''s own DATA file back
+     * (see the field'''s schema description). Same OPTIONAL shape and same
+     * reason as {@link contractShim}: a game whose truth is entirely source
+     * declares nothing here.
+     */
+    readonly dataWriter?: string | undefined;
     readonly assets: Record<string, string> | undefined;
     readonly domStubs: string[] | undefined;
     readonly captureTimeoutMs: number | undefined;
-    /** Iframe-reachable-multi mount fields. */
-    readonly bundleUrl: string | undefined;
-    readonly baseHref: string | undefined;
-    readonly assetBaseUrl: string | undefined;
-    readonly extraDeps: string[] | undefined;
-    readonly pixiModuleUrl: string | undefined;
-    readonly bodyHtml: string | undefined;
 };
 export interface ResolvedAdapterRoot {
     readonly id: string;
@@ -38,11 +44,6 @@ export interface ResolvedAdapterRoot {
      *  `manifest/schema.ts`'s `dev` field for the four readers. */
     readonly dev: boolean;
     readonly loop: 'gated' | 'self-driven';
-    /** Every optional resolved: both contexts always present (§4/§5). */
-    readonly capabilities: {
-        readonly local: Tier;
-        readonly hosted: Tier;
-    };
 }
 export interface ResolvedGameManifest {
     readonly manifestVersion: 2;
@@ -62,6 +63,10 @@ export interface ResolvedGameManifest {
         readonly width: number;
         readonly height: number;
     } | undefined;
+    /** Construction-time renderer properties no world can declare for itself — see the schema. */
+    readonly rendering: {
+        readonly antialias: boolean;
+    } | undefined;
     readonly authoring: {
         readonly hierarchy?: {
             readonly rootLabels?: Readonly<Record<string, string>> | undefined;
@@ -101,54 +106,6 @@ export interface ResolvedGameManifest {
      *  gallery/wizard/Learn-catalog registries. */
     readonly learn: LearnMetadata | undefined;
 }
-/**
- * Ceiling (maximum legal declared `Tier`) per adapter type and delivery
- * context. `default` roots are always first-party in both contexts (D6/§2 —
- * a first-party root is fully vgai-native everywhere). `ingest` roots are
- * ceilinged by their own capture `strategy`: locally the local CLI's Vite
- * pipeline gives bundler dedupe, so every strategy reaches its own natural
- * rung; hosted has no bundler (esbuild-wasm + externals only), and a
- * `deduped` root is DEFINED by being source built through our pipeline — no
- * prebuilt bundle exists to fall back to an iframe rung, and nothing
- * implements a hosted build for it, so hosted is `unsupported` (honesty over
- * optimism; if the hosted esbuild-wasm path ever proves capable, raising
- * this ceiling is a non-breaking widening). `shared`/`iframe-reachable`/
- * `opaque-embed` don't depend on a bundler either way, so they carry through
- * unchanged. `module` adapters have no derivable ceiling ("a custom
- * adapter's reach is not derivable", §4) — modeled here as `first-party`
- * (the top rank), i.e. no ceiling actually constrains a module adapter's
- * declared tier; the loader instead requires the tier to be declared
- * explicitly for module roots (see `resolveCapabilities`), since there is no
- * default to derive.
- */
-export declare const CAPABILITY_CEILINGS: {
-    readonly builtin: {
-        readonly local: "first-party";
-        readonly hosted: "first-party";
-    };
-    readonly ingest: {
-        readonly shared: {
-            readonly local: "shared";
-            readonly hosted: "shared";
-        };
-        readonly deduped: {
-            readonly local: "deduped";
-            readonly hosted: "unsupported";
-        };
-        readonly 'iframe-reachable': {
-            readonly local: "iframe-reachable";
-            readonly hosted: "iframe-reachable";
-        };
-        readonly 'opaque-embed': {
-            readonly local: "opaque-embed";
-            readonly hosted: "opaque-embed";
-        };
-    };
-    readonly module: {
-        readonly local: "first-party";
-        readonly hosted: "first-party";
-    };
-};
 /** Default relative path for `server.module` when omitted (§3) — the scaffolded Colyseus bootstrap. */
 export declare const DEFAULT_SERVER_MODULE = "server/colyseus-setup.ts";
 /**

package/dist/manifest/load.d.ts.map

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

package/dist/manifest/load.js

@@ -13,49 +13,6 @@
 // wrapper that reads a path and calls this function, so browser bundles that
 // only need `loadGameManifest` never pull in `node:fs`.
 import { GameManifestSchema, } from './schema';
-// ---------------------------------------------------------------------------
-// §4 — the per-context ceiling table (named + exported so the tier-table test
-// can pin its rows against this).
-// ---------------------------------------------------------------------------
-/**
- * Ceiling (maximum legal declared `Tier`) per adapter type and delivery
- * context. `default` roots are always first-party in both contexts (D6/§2 —
- * a first-party root is fully vgai-native everywhere). `ingest` roots are
- * ceilinged by their own capture `strategy`: locally the local CLI's Vite
- * pipeline gives bundler dedupe, so every strategy reaches its own natural
- * rung; hosted has no bundler (esbuild-wasm + externals only), and a
- * `deduped` root is DEFINED by being source built through our pipeline — no
- * prebuilt bundle exists to fall back to an iframe rung, and nothing
- * implements a hosted build for it, so hosted is `unsupported` (honesty over
- * optimism; if the hosted esbuild-wasm path ever proves capable, raising
- * this ceiling is a non-breaking widening). `shared`/`iframe-reachable`/
- * `opaque-embed` don't depend on a bundler either way, so they carry through
- * unchanged. `module` adapters have no derivable ceiling ("a custom
- * adapter's reach is not derivable", §4) — modeled here as `first-party`
- * (the top rank), i.e. no ceiling actually constrains a module adapter's
- * declared tier; the loader instead requires the tier to be declared
- * explicitly for module roots (see `resolveCapabilities`), since there is no
- * default to derive.
- */
-export const CAPABILITY_CEILINGS = {
-    builtin: { local: 'first-party', hosted: 'first-party' },
-    ingest: {
-        shared: { local: 'shared', hosted: 'shared' },
-        deduped: { local: 'deduped', hosted: 'unsupported' },
-        'iframe-reachable': { local: 'iframe-reachable', hosted: 'iframe-reachable' },
-        'opaque-embed': { local: 'opaque-embed', hosted: 'opaque-embed' },
-    },
-    module: { local: 'first-party', hosted: 'first-party' },
-};
-/** Total order over `Tier` (§4: `first-party > shared ≈ deduped > iframe-reachable > opaque-embed > unsupported`). */
-const TIER_RANK = {
-    'first-party': 5,
-    shared: 4,
-    deduped: 4,
-    'iframe-reachable': 3,
-    'opaque-embed': 2,
-    unsupported: 1,
-};
 /** Default relative path for `server.module` when omitted (§3) — the scaffolded Colyseus bootstrap. */
 export const DEFAULT_SERVER_MODULE = 'server/colyseus-setup.ts';
 const SEMVER_RE = /^\d+\.\d+\.\d+(?:-[0-9A-Za-z-.]+)?(?:\+[0-9A-Za-z-.]+)?$/;
@@ -84,16 +41,11 @@ function checkAdapterEntryRules(root) {
         throw new Error(`Game manifest: root "${root.id}" uses the '${adapter}' adapter but declares no ` +
             '`entry` — a built-in adapter root is authored as an entry module.');
     }
+    if (typeof adapter === 'object' && 'ingest' in adapter && !root.entry) {
+        throw new Error(`Game manifest: root "${root.id}" is an { ingest } root but declares no \`entry\` — the ` +
+            "game's own entry module is what the host imports.");
+    }
 }
-// Historical note (Track N, N1): this file used to reject EVERY `kind:
-// 'react'` + `{ ingest }` root outright here (`checkReactAdapterRestriction`,
-// citing "no react ingest program is un-parked"). Track N un-parks exactly
-// that program — react+ingest is now a structurally legal combination,
-// resolved to the `'ingest-react'` identity by `resolveAdapter` below like
-// any other ingest root. There is nothing left to reject at THIS layer: the
-// v1 "deduped strategy only" restriction is an editor-resolver concern (D-N3),
-// not a manifest-shape concern — see the `ResolvedAdapter` type's comment
-// above.
 // ---------------------------------------------------------------------------
 // Resolution (§5)
 // ---------------------------------------------------------------------------
@@ -111,8 +63,7 @@ function resolveAdapter(root) {
         };
     }
     // isIngestAdapter (Track N, N1: 'ingest-react' joins 'ingest-three'/
-    // 'ingest-pixi' — see the `ResolvedAdapter` type's comment above for why
-    // this stays strategy-agnostic here).
+    // 'ingest-pixi').
     const identity = adapter.surface === 'three'
         ? 'ingest-three'
         : adapter.surface === 'canvas'
@@ -123,55 +74,13 @@ function resolveAdapter(root) {
         type: 'ingest',
         identity,
         surface: adapter.surface,
-        strategy: ingest.strategy,
-        entryHtml: ingest.entryHtml,
+        contractShim: ingest.contractShim,
+        dataWriter: ingest.dataWriter,
         assets: ingest.assets,
         domStubs: ingest.domStubs,
         captureTimeoutMs: ingest.captureTimeoutMs,
-        bundleUrl: ingest.bundleUrl,
-        baseHref: ingest.baseHref,
-        assetBaseUrl: ingest.assetBaseUrl,
-        extraDeps: ingest.extraDeps,
-        pixiModuleUrl: ingest.pixiModuleUrl,
-        bodyHtml: ingest.bodyHtml,
     };
 }
-function ceilingFor(adapter, context) {
-    if (typeof adapter === 'string')
-        return CAPABILITY_CEILINGS.builtin[context];
-    if (isModuleAdapter(adapter))
-        return CAPABILITY_CEILINGS.module[context];
-    return CAPABILITY_CEILINGS.ingest[adapter.ingest.strategy][context];
-}
-function resolveCapabilities(root) {
-    const contexts = ['local', 'hosted'];
-    const result = {};
-    for (const context of contexts) {
-        const declared = root.capabilities?.[context];
-        if (declared !== undefined) {
-            const ceiling = ceilingFor(root.adapter, context);
-            if (TIER_RANK[declared] > TIER_RANK[ceiling]) {
-                throw new Error(`Game manifest: root "${root.id}": declared capabilities.${context} tier "${declared}" ` +
-                    `exceeds the "${ceiling}" ceiling for this adapter in the ${context} context (§4). ` +
-                    'Under-claiming (including `unsupported`) is legal; over-claiming is not.');
-            }
-            result[context] = declared;
-            continue;
-        }
-        // Omitted -> derive.
-        if (typeof root.adapter === 'string') {
-            result[context] = 'first-party';
-        }
-        else if (isModuleAdapter(root.adapter)) {
-            throw new Error(`Game manifest: root "${root.id}": { module } adapter requires an explicit ` +
-                `capabilities.${context} declaration — a custom adapter's reach is not derivable (§4).`);
-        }
-        else {
-            result[context] = CAPABILITY_CEILINGS.ingest[root.adapter.ingest.strategy][context];
-        }
-    }
-    return result;
-}
 function checkEngineVersionPin(version) {
     if (!SEMVER_RE.test(version)) {
         throw new Error(`Game manifest: engine.version "${version}" is not a valid exact semver string (e.g. ` +
@@ -180,17 +89,17 @@ function checkEngineVersionPin(version) {
 }
 /**
  * Resolve one already-Zod-validated root entry into its `ResolvedAdapterRoot`
- * (adapter identity, capabilities, and a pass-through of every other field).
+ * (adapter identity, and a pass-through of every other field).
  * Every `AdapterRoot` field participates here or in a check above:
  * `id` drives uniqueness; `adapter` (incl. its surface and
- * `module`/`ingest.*` sub-fields) drives identity + capability-ceiling
+ * `module`/`ingest.*` sub-fields) drives adapter identity
  * resolution; `entry` drives the entry cross-field rule and is
  * carried through; `zOrder` drives the final sort; `pausable`/`loop` are
  * carried through as-is (their consumers are the runtime/CLI, T3.2/T3.3);
  * `dev` is carried through for the four dev-layer readers (`mountManifestRoots`'s
  * ship gate, the host's topmost stacking pass, the play compositor's capture
  * exclusion, and the editor's chrome-not-content seam);
- * `capabilities.{local,hosted}` drive tier resolution; `description` (T3.3
+ * `description` (T3.3
  * slice 3) is carried through as-is — its consumer today is
  * `resolveIngestDescriptor` (packages/editor/src/adapter-resolver.ts), which
  * threads an ingest-three root's description into `IngestGame.description`.
@@ -208,7 +117,6 @@ function resolveRoot(root) {
         pausable: root.pausable,
         dev: root.dev,
         loop: root.loop,
-        capabilities: resolveCapabilities(root),
     };
 }
 // ---------------------------------------------------------------------------
@@ -233,7 +141,7 @@ export function loadGameManifest(raw) {
         // raw multi-issue dump, because each one already reads as a finished
         // sentence naming the offending ids. Every other schema violation keeps
         // propagating as the raw `ZodError` it always has (unchanged behavior,
-        // e.g. the iframe-reachable field-exclusivity / manifestVersion checks).
+        // e.g. an unrecognized key or a bad `manifestVersion`).
         const compositionIssue = parsed.error.issues.find((issue) => issue.message.startsWith('Game manifest: duplicate root id') ||
             issue.message.startsWith('Game manifest: a project has at most one'));
         if (compositionIssue)
@@ -260,6 +168,7 @@ export function loadGameManifest(raw) {
         roots,
         server,
         resolution: manifest.resolution,
+        rendering: manifest.rendering,
         authoring: manifest.authoring,
         debug: manifest.debug,
         determinism: manifest.determinism,