@vgai/engine 0.5.0 → 0.5.2

package/dist/input/schema.js

@@ -1,228 +0,0 @@
-// T4.6 — the `.inputmap.json` schema.
-//
-// Was TS-types-only (`input-types.ts`) until T4.6 authored this Zod schema —
-// see docs/BACKBONE-TASKS.md T4.6. `InputManager.loadMap` (input-manager.ts)
-// is this schema's runtime reader: it parses via this schema, then copies
-// each action's `bindings` array (and its declared `valueType`, F1) straight
-// into `this.actions`/`this.actionValueTypes`.
-//
-// Every field has a `.describe()` (repo policy — powers
-// `scripts/generate-schema.ts` and the T4.1/T4.6 schema-walk coverage test).
-// No runtime dependency beyond `zod`, matching the `scene/schema/` and
-// `manifest/schema.ts` precedent.
-//
-// T4.1 history (now closed by F2): `mouse_move` and `gamepad_axis_pair` were
-// authored-but-unhandled binding kinds — REJECTED at parse via a `.superRefine`
-// that threw naming the field, mirroring the `scene/schema/ui.ts` dead-field
-// mechanism. F2 (spec §12 "Complete Device Backends") un-rejects both: real
-// `InputManager` readers now exist for them (`collectPointerDeltaContributions`/
-// `collectVector2Contributions` — `mouse_move` feeds pointerDelta/vector2 from
-// the existing mouseDelta accumulator; `gamepad_axis_pair` feeds vector2 from
-// the coupled `xAxis`/`yAxis` gamepad reading). F2 also adds two new LIVE
-// binding kinds, `touch_button`/`touch_stick` (the touch/virtual-control
-// backend — see `InputManager.setTouchButton`/`setTouchStick`).
-//
-// F1 (spec §12 "Define Typed Action Values") adds:
-//  - `InputAction.valueType` — an action now DECLARES its value shape
-//    (`digital`/`scalar`/`vector2`/`pointerDelta`/`pointerPosition`),
-//    defaulted to `digital` so every pre-F1 action stays valid unchanged.
-//  - four new, LIVE (not dead-rejected) binding kinds — `test_axis`,
-//    `test_vector2`, `test_pointer_delta`, `test_pointer_position` — the
-//    "injected test input" backend F2's acceptance criteria names as a
-//    peer of keyboard/mouse/gamepad/touch. They read back a caller-injected
-//    raw value (InputManager.injectAxis/injectVector2/injectPointerDelta/
-//    injectPointerPosition) through the SAME deadzone/normalize/combine path
-//    real device bindings use.
-import { z } from 'zod';
-const KeyBindingSchema = z.object({
-    type: z.literal('key').describe('Binding kind: a keyboard key (KeyboardEvent.code)'),
-    code: z.string().describe('KeyboardEvent.code value, e.g. "KeyW", "Space", "ArrowUp"'),
-});
-const MouseButtonBindingSchema = z.object({
-    type: z.literal('mouse_button').describe('Binding kind: a mouse button'),
-    button: z.number().describe('MouseEvent.button index (0 = left, 1 = middle, 2 = right)'),
-});
-const MouseMoveBindingSchema = z.object({
-    type: z
-        .literal('mouse_move')
-        .describe('Binding kind: raw mouse movement (F2, spec §12 "Complete Device Backends"). Feeds a ' +
-        "'pointerDelta'-valueType action with the raw accumulated mouse delta (no deadzone), and " +
-        "can also feed a 'vector2'-valueType action (the same delta, radial-deadzoned + unit-" +
-        'circle-clamped via `deadzone`).'),
-    deadzone: z
-        .number()
-        .optional()
-        .describe("Radial deadzone magnitude applied only when this binding feeds a 'vector2'-valueType " +
-        "action (default 0 — no deadzone; ignored for 'pointerDelta' reads, which are never " +
-        'deadzoned).'),
-});
-const GamepadButtonBindingSchema = z.object({
-    type: z.literal('gamepad_button').describe('Binding kind: a gamepad face/shoulder button'),
-    button: z.number().describe('Standard Gamepad API button index'),
-});
-const GamepadAxisBindingSchema = z.object({
-    type: z.literal('gamepad_axis').describe('Binding kind: a single thresholded gamepad axis'),
-    axis: z.number().describe('Standard Gamepad API axis index'),
-    direction: z
-        .enum(['positive', 'negative'])
-        .describe('Which side of the deadzone counts as "pressed"'),
-    deadzone: z.number().optional().describe('Deadzone magnitude (default 0.15 if omitted)'),
-});
-const GamepadAxisPairBindingSchema = z.object({
-    type: z
-        .literal('gamepad_axis_pair')
-        .describe('Binding kind: a coupled (x, y) gamepad axis pair, e.g. a stick used as a 2D vector ' +
-        '(look/aim/movement) (F2, spec §12 "Complete Device Backends"). Feeds a ' +
-        "'vector2'-valueType action: (xAxis, yAxis) read together, radial-deadzoned + unit-" +
-        'circle-clamped the same way a real analog stick is.'),
-    xAxis: z.number().describe('Standard Gamepad API axis index for the X component'),
-    yAxis: z.number().describe('Standard Gamepad API axis index for the Y component'),
-    deadzone: z.number().optional().describe('Deadzone magnitude (default 0.15 if omitted)'),
-});
-// ---------------------------------------------------------------------------
-// F1 (spec §12) — injected test input bindings. LIVE (real runtime readers in
-// InputManager's getScalar/getVector2/getPointerDelta/getPointerPosition),
-// unlike the two dead stubs above. Foreshadows F2's "injected test input"
-// backend: real device kinds F2 adds later feed the same typed-value
-// aggregation path these exercise today.
-// ---------------------------------------------------------------------------
-const TestAxisBindingSchema = z.object({
-    type: z
-        .literal('test_axis')
-        .describe("Binding kind: an injected synthetic scalar value for a 'scalar'-valueType action " +
-        '(InputManager.injectAxis/getScalar) — the "injected test input" backend named in F2, ' +
-        "built in F1 as the typed scalar value model's testable source."),
-    sourceId: z
-        .string()
-        .describe('Names the injected test source this binding reads (InputManager.injectAxis).'),
-    deadzone: z
-        .number()
-        .optional()
-        .describe('1D deadzone magnitude applied to the injected raw value before combine (default 0 — no ' +
-        'deadzone). Values below it read as 0; values at/above it rescale from 0 (at the ' +
-        'deadzone edge) to ±1 (at |raw| = 1), sign preserved.'),
-});
-const TestVector2BindingSchema = z.object({
-    type: z
-        .literal('test_vector2')
-        .describe("Binding kind: an injected synthetic {x,y} value for a 'vector2'-valueType action " +
-        '(InputManager.injectVector2/getVector2) — the "injected test input" backend named in ' +
-        "F2, built in F1 as the typed Vector2 value model's testable source."),
-    sourceId: z
-        .string()
-        .describe('Names the injected test source this binding reads (InputManager.injectVector2).'),
-    deadzone: z
-        .number()
-        .optional()
-        .describe('Radial deadzone magnitude applied to the injected raw {x,y} before combine (default 0 ' +
-        '— no deadzone). Vectors whose magnitude is below it read as {0,0}; at/above it, ' +
-        'direction is preserved and magnitude rescales the same way the scalar deadzone does, ' +
-        'then the result is clamped to the unit circle (magnitude <= 1).'),
-});
-const TestPointerDeltaBindingSchema = z.object({
-    type: z
-        .literal('test_pointer_delta')
-        .describe("Binding kind: an injected synthetic per-frame {x,y} delta for a 'pointerDelta'-" +
-        'valueType action (InputManager.injectPointerDelta/getPointerDelta) — the "injected ' +
-        'test input" backend named in F2. No deadzone (deltas are not deadzoned).'),
-    sourceId: z
-        .string()
-        .describe('Names the injected test source this binding reads (InputManager.injectPointerDelta).'),
-});
-const TestPointerPositionBindingSchema = z.object({
-    type: z
-        .literal('test_pointer_position')
-        .describe("Binding kind: an injected synthetic absolute {x,y} position for a 'pointerPosition'-" +
-        'valueType action (InputManager.injectPointerPosition/getPointerPosition) — the ' +
-        '"injected test input" backend named in F2.'),
-    sourceId: z
-        .string()
-        .describe('Names the injected test source this binding reads (InputManager.injectPointerPosition).'),
-});
-// ---------------------------------------------------------------------------
-// F2 (spec §12 "Complete Device Backends") — touch/virtual-control bindings.
-// LIVE (real runtime readers in InputManager's isPressed/isJustPressed/
-// isJustReleased/getDigitalSource and getVector2), driven by
-// InputManager.setTouchButton/setTouchStick — the headless-testable
-// injectable entry points a real on-screen touch-control UI's own
-// touchstart/touchmove/touchend handlers would call (that DOM wiring is a
-// thin adapter at the edge, out of scope here — see input-manager.ts).
-// ---------------------------------------------------------------------------
-const TouchButtonBindingSchema = z.object({
-    type: z
-        .literal('touch_button')
-        .describe("Binding kind: a virtual on-screen button for a 'digital' action " +
-        '(InputManager.setTouchButton/isPressed) — edge-tracked (isJustPressed/isJustReleased) ' +
-        'the same way a real mouse/keyboard button is.'),
-    sourceId: z
-        .string()
-        .describe('Names the virtual control zone this binding reads (InputManager.setTouchButton) — a ' +
-        'touch-UI-chosen id, not a real device index.'),
-});
-const TouchStickBindingSchema = z.object({
-    type: z
-        .literal('touch_stick')
-        .describe("Binding kind: a virtual on-screen analog stick for a 'vector2' action " +
-        '(InputManager.setTouchStick/getVector2) — radial-deadzoned + unit-circle-clamped the ' +
-        'same way a real gamepad stick is.'),
-    sourceId: z
-        .string()
-        .describe('Names the virtual control zone this binding reads (InputManager.setTouchStick) — a ' +
-        'touch-UI-chosen id, not a real device index.'),
-    deadzone: z
-        .number()
-        .optional()
-        .describe('Radial deadzone magnitude applied to the raw {x,y} before combine (default 0 — no ' +
-        'deadzone).'),
-});
-/** A single input binding. Every kind listed here is LIVE — F2 (spec §12) closed the last two
- *  dead stubs (`mouse_move`/`gamepad_axis_pair`) by giving both real `InputManager` readers. */
-export const InputBindingSchema = z.discriminatedUnion('type', [
-    KeyBindingSchema,
-    MouseButtonBindingSchema,
-    MouseMoveBindingSchema,
-    GamepadButtonBindingSchema,
-    GamepadAxisBindingSchema,
-    GamepadAxisPairBindingSchema,
-    TestAxisBindingSchema,
-    TestVector2BindingSchema,
-    TestPointerDeltaBindingSchema,
-    TestPointerPositionBindingSchema,
-    TouchButtonBindingSchema,
-    TouchStickBindingSchema,
-]);
-/** An action has a name (the record key) and one or more bindings. */
-export const InputActionSchema = z.object({
-    valueType: z
-        .enum(['digital', 'scalar', 'vector2', 'pointerDelta', 'pointerPosition'])
-        .default('digital')
-        .describe("This action's declared value shape (F1, spec §12). 'digital' (boolean, with " +
-        'pressed/justPressed/justReleased edges) is the default when omitted, matching every ' +
-        "action authored before F1. 'scalar' is a single deadzone-rescaled float axis. " +
-        "'vector2' is a radial-deadzoned, unit-circle-normalized {x,y}. 'pointerDelta' is a " +
-        "per-frame {x,y} movement delta, summed across sources. 'pointerPosition' is an " +
-        'absolute {x,y}, last-write-wins across sources. InputManager enforces this at read ' +
-        'time: reading an action through the wrong typed getter (e.g. getScalar on a ' +
-        "'digital' action) throws."),
-    bindings: z
-        .array(InputBindingSchema)
-        .describe('Bindings that all trigger/feed this action. Digital actions combine via OR (any one ' +
-        'binding satisfied is enough). Scalar actions combine via max-magnitude across ' +
-        'contributing bindings (ties keep the first-listed binding). Vector2 actions combine ' +
-        'by summing contributing {x,y} values then clamping to the unit circle. PointerDelta ' +
-        'actions sum contributing deltas. PointerPosition actions use the most-recently-' +
-        'written contributing source (last-write-wins).'),
-});
-/**
- * The `.inputmap.json` file format (`InputManager.loadMap`).
- *
- * `version` is RESERVED (no range-check reader exists yet for this format —
- * same convention `2d.version`/`Scene2DSchema` used before T2.3 gave the 3D
- * scene version axis a real reader; see `schema-consumption-map.ts`).
- */
-export const InputMapFileSchema = z.object({
-    version: z.number().describe('Input map file format version (RESERVED — no range check yet)'),
-    actions: z
-        .record(z.string(), InputActionSchema)
-        .describe('Named actions, each with a list of bindings (InputManager.loadMap)'),
-});

package/dist/loader.d.ts

@@ -1,43 +0,0 @@
-/**
- * Shared asset loading infrastructure.
- *
- * Provides a single LoadingManager (for Three.js loaders) and resolveUrl()
- * (for raw fetch calls) so that all engine asset requests go through one
- * configurable URL prefix. Call setAssetPrefix() once at runtime startup.
- *
- * Three.js loaders constructed with `loadingManager` automatically rewrite
- * URLs via setURLModifier(). For raw fetch() calls, wrap the URL with
- * resolveUrl() to apply the same prefix.
- */
-import * as THREE from 'three';
-import { DRACOLoader } from 'three/addons/loaders/DRACOLoader.js';
-import { GLTFLoader } from 'three/addons/loaders/GLTFLoader.js';
-/** Shared Three.js LoadingManager — all engine loaders should use this. */
-export declare const loadingManager: THREE.LoadingManager;
-/** Pre-configured TextureLoader using the shared manager. */
-export declare const textureLoader: THREE.TextureLoader;
-/**
- * Shared DRACOLoader for decoding DRACO-compressed GLTF/GLB meshes.
- *
- * The decoder wasm/js is vendored under
- * packages/editor/template/public/jsm/libs/draco/gltf/ and served at the
- * absolute runtime path '/jsm/libs/draco/gltf/' (DRACOLoader appends
- * draco_wasm_wrapper.js / draco_decoder.wasm to this path). This is an
- * absolute path, so it deliberately does NOT go through the asset prefix —
- * the decoder is engine infrastructure, not a scene asset.
- */
-export declare const dracoLoader: DRACOLoader;
-/** Pre-configured GLTFLoader using the shared manager, with DRACO decoding wired in. */
-export declare const gltfLoader: GLTFLoader;
-/**
- * Set the URL prefix prepended to relative asset paths.
- * Called once by createGameRuntime(). Defaults to '/'.
- */
-export declare function setAssetPrefix(prefix: string): void;
-/**
- * Resolve a relative asset URL using the current prefix.
- * Use this for raw fetch() calls — Three.js loaders using
- * `loadingManager` handle this automatically.
- */
-export declare function resolveUrl(url: string): string;
-//# sourceMappingURL=loader.d.ts.map

package/dist/loader.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../src/loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,WAAW,EAAE,MAAM,qCAAqC,CAAC;AAClE,OAAO,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAC;AAgBhE,2EAA2E;AAC3E,eAAO,MAAM,cAAc,sBAA6B,CAAC;AAGzD,6DAA6D;AAC7D,eAAO,MAAM,aAAa,qBAA0C,CAAC;AAErE;;;;;;;;;GASG;AACH,eAAO,MAAM,WAAW,aAAkC,CAAC;AAG3D,wFAAwF;AACxF,eAAO,MAAM,UAAU,YAAiC,CAAC;AAGzD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAEnD;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE9C"}

package/dist/loader.js

@@ -1,59 +0,0 @@
-/**
- * Shared asset loading infrastructure.
- *
- * Provides a single LoadingManager (for Three.js loaders) and resolveUrl()
- * (for raw fetch calls) so that all engine asset requests go through one
- * configurable URL prefix. Call setAssetPrefix() once at runtime startup.
- *
- * Three.js loaders constructed with `loadingManager` automatically rewrite
- * URLs via setURLModifier(). For raw fetch() calls, wrap the URL with
- * resolveUrl() to apply the same prefix.
- */
-import * as THREE from 'three';
-import { DRACOLoader } from 'three/addons/loaders/DRACOLoader.js';
-import { GLTFLoader } from 'three/addons/loaders/GLTFLoader.js';
-let _prefix = '/';
-function rewriteUrl(url) {
-    if (url.startsWith('/') ||
-        url.startsWith('http') ||
-        url.startsWith('data:') ||
-        url.startsWith('blob:')) {
-        return url;
-    }
-    return _prefix + url;
-}
-/** Shared Three.js LoadingManager — all engine loaders should use this. */
-export const loadingManager = new THREE.LoadingManager();
-loadingManager.setURLModifier(rewriteUrl);
-/** Pre-configured TextureLoader using the shared manager. */
-export const textureLoader = new THREE.TextureLoader(loadingManager);
-/**
- * Shared DRACOLoader for decoding DRACO-compressed GLTF/GLB meshes.
- *
- * The decoder wasm/js is vendored under
- * packages/editor/template/public/jsm/libs/draco/gltf/ and served at the
- * absolute runtime path '/jsm/libs/draco/gltf/' (DRACOLoader appends
- * draco_wasm_wrapper.js / draco_decoder.wasm to this path). This is an
- * absolute path, so it deliberately does NOT go through the asset prefix —
- * the decoder is engine infrastructure, not a scene asset.
- */
-export const dracoLoader = new DRACOLoader(loadingManager);
-dracoLoader.setDecoderPath('/jsm/libs/draco/gltf/');
-/** Pre-configured GLTFLoader using the shared manager, with DRACO decoding wired in. */
-export const gltfLoader = new GLTFLoader(loadingManager);
-gltfLoader.setDRACOLoader(dracoLoader);
-/**
- * Set the URL prefix prepended to relative asset paths.
- * Called once by createGameRuntime(). Defaults to '/'.
- */
-export function setAssetPrefix(prefix) {
-    _prefix = prefix.endsWith('/') ? prefix : prefix ? `${prefix}/` : '/';
-}
-/**
- * Resolve a relative asset URL using the current prefix.
- * Use this for raw fetch() calls — Three.js loaders using
- * `loadingManager` handle this automatically.
- */
-export function resolveUrl(url) {
-    return rewriteUrl(url);
-}

package/dist/manifest/index.d.ts

@@ -1,5 +0,0 @@
-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';
-//# sourceMappingURL=index.d.ts.map

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

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

package/dist/manifest/index.js

@@ -1,8 +0,0 @@
-// Game manifest (vgai.game.json) — schema + loader (T3.1 slice 1).
-// See docs/GAME-MANIFEST-DESIGN.md.
-export { CAPABILITY_CEILINGS, DEFAULT_SERVER_MODULE, loadGameManifest } from './load';
-export { AdapterRootSchema, GameManifestSchema, IngestStrategySchema, RootAdapterSchema, TierSchema, } 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
-// Node-only contexts (CLI, tests).

package/dist/manifest/load-file.d.ts

@@ -1,4 +0,0 @@
-import { type ResolvedGameManifest } from './load';
-/** Read + JSON.parse `path`, then resolve it via `loadGameManifest`. Node-only. */
-export declare function loadGameManifestFile(path: string): ResolvedGameManifest;
-//# sourceMappingURL=load-file.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"load-file.d.ts","sourceRoot":"","sources":["../../src/manifest/load-file.ts"],"names":[],"mappings":"AASA,OAAO,EAAoB,KAAK,oBAAoB,EAAE,MAAM,QAAQ,CAAC;AAErE,mFAAmF;AACnF,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,oBAAoB,CAGvE"}

package/dist/manifest/load-file.js

@@ -1,14 +0,0 @@
-// T3.1 slice 1 — Node-only path wrapper around `loadGameManifest` (§5).
-//
-// Kept in its own module (rather than folded into `load.ts`) so that
-// `loadGameManifest` itself stays free of `node:fs` — anything that only
-// needs the pure parse/resolve function (e.g. a future browser/hosted-editor
-// caller) can import `./load` without pulling a Node-only module into its
-// bundle.
-import { readFileSync } from 'node:fs';
-import { loadGameManifest } from './load';
-/** Read + JSON.parse `path`, then resolve it via `loadGameManifest`. Node-only. */
-export function loadGameManifestFile(path) {
-    const raw = JSON.parse(readFileSync(path, 'utf-8'));
-    return loadGameManifest(raw);
-}

package/dist/manifest/load.d.ts

@@ -1,144 +0,0 @@
-import { type IngestStrategy, type Tier } from './schema';
-/** D6's resolved adapter identities. */
-export type ResolvedAdapter = {
-    readonly type: 'builtin';
-    readonly identity: 'threejs' | 'pixijs' | 'react';
-    readonly surface: 'threejs' | 'pixijs' | 'react';
-} | {
-    readonly type: 'module';
-    readonly identity: 'module';
-    readonly module: string;
-    readonly surface: 'threejs' | 'pixijs' | 'react';
-} | {
-    readonly type: 'ingest';
-    readonly identity: 'ingest-three' | 'ingest-pixi' | 'ingest-react';
-    readonly surface: 'threejs' | 'pixijs' | 'react';
-    readonly strategy: IngestStrategy;
-    readonly entryHtml: string | undefined;
-    readonly assets: Record<string, string> | undefined;
-    readonly domStubs: string[] | undefined;
-    readonly captureTimeoutMs: number | undefined;
-    /** Track P (docs/PIXI-INGEST-LANDING-DESIGN.md §2) — 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;
-    readonly surface: ResolvedAdapter['surface'];
-    readonly description: string | undefined;
-    readonly adapter: ResolvedAdapter;
-    readonly scene: string | undefined;
-    readonly entry: string | undefined;
-    readonly zOrder: number;
-    readonly pausable: 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;
-    readonly name: string;
-    readonly appId: string | undefined;
-    readonly editorPort: number | undefined;
-    readonly version: string;
-    readonly engine: {
-        readonly version: string;
-    };
-    /** Sorted by zOrder; ties broken by original array order (§3). */
-    readonly roots: readonly ResolvedAdapterRoot[];
-    readonly server: {
-        readonly room: string;
-        readonly module: string;
-    } | undefined;
-    readonly resolution: {
-        readonly width: number;
-        readonly height: number;
-    } | undefined;
-    readonly authoring: {
-        readonly hierarchy?: {
-            readonly rootLabels?: Readonly<Record<string, string>> | undefined;
-            readonly groups?: readonly {
-                readonly id: string;
-                readonly label: string;
-                readonly roots: readonly string[];
-            }[] | undefined;
-        } | undefined;
-    } | undefined;
-    /** D18 — read by the debug-bridge installer to gate `?vgai-debug=1` in production builds. */
-    readonly debug: {
-        readonly allowInProduction: boolean;
-    } | undefined;
-    /** D15 — read by `mount-manifest.ts`'s boot-time seeding reader (gates
-     *  whether `ctx.random` is seeded from `defaultSeed`/`?vgai-seed=`), the
-     *  gameplay-rng-ban burn-down scan, and the dev-mode Math.random phase
-     *  trap. See `docs/D15-DETERMINISM-DESIGN.md`. */
-    readonly determinism: {
-        readonly seededRandom: boolean;
-        readonly defaultSeed?: number | undefined;
-    } | 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";
-/**
- * Parse + validate + resolve a raw manifest value into a `ResolvedGameManifest`.
- * Pure data-in/data-out (no `fs`) — see `load-file.ts` for the Node path-based
- * wrapper. Throws a descriptive `Error` (naming the offending root/field) on
- * any Zod validation failure or cross-field rule violation.
- */
-export declare function loadGameManifest(raw: unknown): ResolvedGameManifest;
-//# sourceMappingURL=load.d.ts.map

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

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