@vgai/engine 0.3.0 → 0.4.0-canary.20260715.0

package/dist/adapter/transform.d.ts

@@ -1,18 +0,0 @@
-/**
- * The neutral transform value used across adapter interfaces. Position + scale
- * are xyz; rotation is a quaternion (xyzw) — matching `Object3D.quaternion`, so
- * adapters never have to agree on an Euler convention.
- */
-export interface Transform {
-    position: [number, number, number];
-    rotation: [number, number, number, number];
-    scale: [number, number, number];
-}
-/**
- * Who currently owns an object's transform — i.e. what writes it each frame.
- * The editor uses this to decide whether a gizmo edit is durable (`editor`),
- * needs simulation coordination (`physics`), or is best-effort/inspect-only
- * (`script`/`network`/`external`).
- */
-export type TransformOwner = 'editor' | 'physics' | 'animation' | 'script' | 'network' | 'external';
-//# sourceMappingURL=transform.d.ts.map

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

@@ -1 +0,0 @@
-{"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"}

package/dist/adapter/transform.js

@@ -1 +0,0 @@
-export {};

package/dist/adapter/vgai-scene-game-adapter.d.ts

@@ -1,116 +0,0 @@
-/**
- * VgaiSceneGameAdapter — the FIRST-PARTY implementer of {@link GameAdapter}.
- *
- * This is where `.vscn` + `GameComponent` + Rapier live now: the host no longer
- * knows about any of them. `mount(host)` builds the full first-party runtime
- * (the body that used to live inline in `create-runtime.ts`) from a neutral
- * {@link HostContext}, runs the game's `setup`/scene load, and returns a
- * {@link MountedGame}. First-party content is now just one implementer of the
- * same interface an unmodified external game implements (Phase B).
- *
- * `GameSetupFn` / `GameContext` are imported ONLY here (and in the example
- * `fromSetup` wrappers) — never by the host. That confinement is the inversion.
- */
-import type { EffectComposer } from 'postprocessing';
-import * as THREE from 'three';
-import type { WorldFrameHooks } from '../runtime/game';
-import type { EditorPreview, GameContext, GameSetupFn } from '../runtime/types';
-import type { ComponentRegistry } from '../scene/component-registry';
-import { type SceneInstance } from '../scene/scene-loader';
-import type { SceneFile } from '../scene/scene-types';
-import type { GameAdapter, MountedGame } from './game-adapter';
-import type { HostContext } from './host-context';
-/** How a {@link VgaiSceneGameAdapter} builds its game (the former RuntimeConfig). */
-export interface VgaiSceneConfig {
-    /** Game setup function — registers systems and loads scenes. */
-    setup?: GameSetupFn | undefined;
-    /** Editor context — passed to setup() when launched from the editor. */
-    editorPreview?: EditorPreview | undefined;
-    /** Path to a .vscn.json scene file. Loaded if no setup is provided. */
-    scenePath?: string | undefined;
-    /** In-memory scene data. Loaded if no setup and no scenePath is provided. */
-    sceneData?: SceneFile | undefined;
-    /**
-     * Component name -> GameComponent class map, threaded into the scene
-     * loader's `SceneLoadContext.componentRegistry` for both the `scenePath`
-     * and `sceneData` branches (never for `setup` — a custom setup already
-     * owns its own registry, e.g. `template/src/scripts/main.ts`'s generic
-     * fallback). Without this, a scene's `components:` entries throw
-     * ("Component ... not found in registry") or, pre-T7.2-closure, were
-     * simply unreachable through these two config options at all (the T7.2
-     * finding `docs/CLI-ON-FOLDER-DESIGN.md` §1D calls out — see
-     * `packages/editor/src/adapter-resolver.ts`, the only production caller
-     * that sets this today).
-     */
-    componentRegistry?: ComponentRegistry | undefined;
-    /**
-     * The project's scene-UI registry (design/24-scene-ui.md D9/D11) —
-     * `components`/`transforms`/`strings` only, opaque records engine-side (the
-     * engine never imports `@vgai/scene-ui`'s real `ProjectUIRegistry` type;
-     * they're React things it never inspects). Threaded per-mount into the
-     * services `renderSceneUI` receives, mirroring `componentRegistry` above:
-     * the editor's default-three adapter resolver passes its cached project
-     * registry here for the editor-play path (D11); a standalone host that
-     * already registered a static registry via `registerSceneUIRenderer`
-     * typically omits this (registration-time registry is enough there).
-     */
-    uiRegistry?: {
-        components?: Record<string, unknown>;
-        transforms?: Record<string, unknown>;
-        strings?: Record<string, Record<string, string>>;
-    } | undefined;
-    /** Input map JSON path. Defaults to 'inputmaps/default.inputmap.json'. */
-    inputMapPath?: string | undefined;
-    /** URL prefix for relative asset paths. Defaults to '/'. */
-    assetPrefix?: string | undefined;
-    /** Stable adapter id (for registry/conformance). Defaults to 'vgai-scene'. */
-    id?: string | undefined;
-}
-/**
- * The first-party `MountedGame`, with concrete extras the editor host uses for
- * first-party features (HMR, physics sync) that are NOT part of the neutral
- * interface. The generic host only touches the `MountedGame` surface.
- */
-export interface VgaiMountedGame extends MountedGame {
-    /**
-     * First-party brand (checklist item 1 / T7.3 lookahead): a plain `'ctx' in
-     * mounted` structural check misfires once world2d's `MountedGame2D`
-     * (`world2d/pixi-game-adapter.ts`) also has a `ctx` key — its `ctx` is a
-     * `World2DContext`, not a `GameContext`, and has none of
-     * `queryByComponent`/`physics`/`collisions`/`camera`. This literal-`true`
-     * property is what `isFirstPartyMounted` (`runtime/game.ts`) actually
-     * checks; `game.ts` reads it via a structural `{ firstParty?: unknown }`
-     * probe so it never needs a value import of this module (the existing
-     * import is type-only and must stay that way).
-     */
-    readonly firstParty: true;
-    readonly ctx: GameContext;
-    readonly composer: EffectComposer | null;
-    /** Warm-restart: dispose the current game, re-run a new setup on the same ctx. */
-    hotReload(newSetup: GameSetupFn, editorPreview?: EditorPreview): Promise<void>;
-    /**
-     * Phase-partitioned frame entry point (T7.1 slice 2,
-     * `docs/GAME-ROOT-DESIGN.md` §4) — wired onto this world's `WorldInstance`
-     * by `registerDefaultThreeWorld` (`create-runtime.ts`). `Game.runFrame` is
-     * the CANONICAL driver going forward: it calls `frame.runPhase` once per
-     * (phase, substep) for every world, then `frame.endFrame` once per
-     * substep after all worlds finish all phases. `update` (below) remains
-     * the legacy/direct entry point to the exact same `SystemRunner` — direct
-     * callers (editor HMR, adapter conformance tests) keep using it unchanged.
-     */
-    readonly frame: WorldFrameHooks;
-}
-/**
- * Wrap a first-party `setup` function as a {@link GameAdapter}. This is how every
- * first-party example becomes an implementer of the same interface an external
- * game implements — with no change to the setup's body.
- */
-export declare function fromSetup(id: string, setup: GameSetupFn): GameAdapter;
-export declare class VgaiSceneGameAdapter implements GameAdapter {
-    private readonly config;
-    readonly id: string;
-    constructor(config?: VgaiSceneConfig);
-    mount(host: HostContext): Promise<VgaiMountedGame>;
-}
-export declare function adoptSceneCamera(sceneInstance: SceneInstance, runtimeCamera: THREE.PerspectiveCamera): boolean;
-//# sourceMappingURL=vgai-scene-game-adapter.d.ts.map

package/dist/adapter/vgai-scene-game-adapter.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"vgai-scene-game-adapter.d.ts","sourceRoot":"","sources":["../../src/adapter/vgai-scene-game-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAY/B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAQvD,OAAO,KAAK,EAAE,aAAa,EAAe,WAAW,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC7F,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAErE,OAAO,EAIL,KAAK,aAAa,EAEnB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAgBtD,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC/D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAIlD,qFAAqF;AACrF,MAAM,WAAW,eAAe;IAC9B,gEAAgE;IAChE,KAAK,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;IAChC,wEAAwE;IACxE,aAAa,CAAC,EAAE,aAAa,GAAG,SAAS,CAAC;IAC1C,uEAAuE;IACvE,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,6EAA6E;IAC7E,SAAS,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;IAClC;;;;;;;;;;;OAWG;IACH,iBAAiB,CAAC,EAAE,iBAAiB,GAAG,SAAS,CAAC;IAClD;;;;;;;;;;OAUG;IACH,UAAU,CAAC,EACP;QACE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACrC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACrC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;KAClD,GACD,SAAS,CAAC;IACd,0EAA0E;IAC1E,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,4DAA4D;IAC5D,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,8EAA8E;IAC9E,EAAE,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACzB;AAED;;;;GAIG;AACH,MAAM,WAAW,eAAgB,SAAQ,WAAW;IAClD;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,UAAU,EAAE,IAAI,CAAC;IAC1B,QAAQ,CAAC,GAAG,EAAE,WAAW,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI,CAAC;IACzC,kFAAkF;IAClF,SAAS,CAAC,QAAQ,EAAE,WAAW,EAAE,aAAa,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/E;;;;;;;;;OASG;IACH,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC;CACjC;AAeD;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,GAAG,WAAW,CAErE;AAED,qBAAa,oBAAqB,YAAW,WAAW;IAE1C,OAAO,CAAC,QAAQ,CAAC,MAAM;IADnC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;gBACS,MAAM,GAAE,eAAoB;IAKnD,KAAK,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,eAAe,CAAC;CAioBzD;AAcD,wBAAgB,gBAAgB,CAC9B,aAAa,EAAE,aAAa,EAC5B,aAAa,EAAE,KAAK,CAAC,iBAAiB,GACrC,OAAO,CAgBT"}