@vgai/engine 0.3.0 → 0.4.0-canary.20260715.0

package/dist/world2d/schema/sprite.js

@@ -1,63 +0,0 @@
-import { z } from 'zod';
-import { Vec2Schema } from './tuples2d';
-/**
- * `sprite` authored section — engine-owned 2D sprite data, NOT a `PIXI.Sprite`.
- *
- * Per ARCHITECTURE.md §Render Surfaces: authored data says `sprite`, and a runtime
- * adapter instantiates it onto the appropriate backend (here, a `PIXI.Sprite` on
- * the world2d surface). A 1x1 white texture is used when `texture` is omitted, so a
- * tinted rectangle sprite needs no asset.
- */
-export const SpriteSchema = z
-    .object({
-    texture: z
-        .string()
-        .optional()
-        .describe('Texture asset URL (loaded via PIXI.Assets). Omit for a tintable 1x1 white texture'),
-    frame: z
-        .string()
-        .optional()
-        .describe('Spritesheet frame/sub-texture name when `texture` is a spritesheet atlas'),
-    anchor: Vec2Schema.optional().describe('Normalized anchor [x, y] (0..1). Default [0.5, 0.5]'),
-    tint: z
-        .string()
-        .optional()
-        .describe("Tint color as hex string (e.g. '#ff8800'). Default white"),
-    alpha: z.number().min(0).max(1).optional().describe('Opacity 0..1. Default 1'),
-    width: z
-        .number()
-        .optional()
-        .describe('Explicit display width in pixels (overrides texture size)'),
-    height: z
-        .number()
-        .optional()
-        .describe('Explicit display height in pixels (overrides texture size)'),
-    blendMode: z
-        .enum(['normal', 'add', 'multiply', 'screen'])
-        .optional()
-        .describe('PixiJS blend mode. Default normal'),
-    interactive: z
-        .boolean()
-        .optional()
-        .describe('Enable federated pointer events (eventMode=static) so this sprite can be picked'),
-    filter: z
-        .enum(['none', 'blur', 'desaturate'])
-        .optional()
-        .describe('Apply a PixiJS filter (BlurFilter / ColorMatrix desaturate). Default none'),
-    animationFrames: z
-        .number()
-        .int()
-        .optional()
-        .describe('If set, build an AnimatedSprite cycling N generated tinted frames'),
-    fps: z.number().optional().describe('AnimatedSprite playback speed in frames/sec. Default 8'),
-})
-    .describe('2D sprite appearance (world2d). Instantiated as a PIXI.Sprite or AnimatedSprite');
-/** `text` authored section — a world-space PIXI.Text label (world-space UI). */
-export const Text2DSchema = z
-    .object({
-    text: z.string().describe('The string to display'),
-    fontSize: z.number().optional().describe('Font size in pixels. Default 24'),
-    fill: z.string().optional().describe("Text color as hex string. Default '#ffffff'"),
-    anchor: Vec2Schema.optional().describe('Normalized anchor [x, y] (0..1). Default [0.5, 0.5]'),
-})
-    .describe('2D world-space text label (world2d). Instantiated as a PIXI.Text');

package/dist/world2d/schema/tilemap.d.ts

@@ -1,15 +0,0 @@
-import { z } from 'zod';
-/**
- * `tilemap` authored section — engine-owned 2D tilemap data (NOT a CompositeTilemap),
- * instantiated to a `@pixi/tilemap` CompositeTilemap by the 2D spawn path. Asset-light:
- * a `palette` of hex colors generates one tile texture each, and `tiles` is a row-major
- * grid of palette indices. A real tileset texture/Tiled `.tmj` import is the natural
- * extension (per the spec's optional Tiled note).
- */
-export declare const TilemapSchema: z.ZodObject<{
-    tileSize: z.ZodNumber;
-    palette: z.ZodArray<z.ZodString>;
-    tiles: z.ZodArray<z.ZodArray<z.ZodNumber>>;
-}, z.core.$strip>;
-export type SceneTilemap = z.infer<typeof TilemapSchema>;
-//# sourceMappingURL=tilemap.d.ts.map

package/dist/world2d/schema/tilemap.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"tilemap.d.ts","sourceRoot":"","sources":["../../../src/world2d/schema/tilemap.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;GAMG;AACH,eAAO,MAAM,aAAa;;;;iBAU2D,CAAC;AAEtF,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC"}

package/dist/world2d/schema/tilemap.js

@@ -1,19 +0,0 @@
-import { z } from 'zod';
-/**
- * `tilemap` authored section — engine-owned 2D tilemap data (NOT a CompositeTilemap),
- * instantiated to a `@pixi/tilemap` CompositeTilemap by the 2D spawn path. Asset-light:
- * a `palette` of hex colors generates one tile texture each, and `tiles` is a row-major
- * grid of palette indices. A real tileset texture/Tiled `.tmj` import is the natural
- * extension (per the spec's optional Tiled note).
- */
-export const TilemapSchema = z
-    .object({
-    tileSize: z.number().describe('Tile width/height in pixels'),
-    palette: z
-        .array(z.string())
-        .describe('Hex colors; one generated tile texture per entry (index → color)'),
-    tiles: z
-        .array(z.array(z.number().int()))
-        .describe('Row-major grid of palette indices (each row is an array of tile indices)'),
-})
-    .describe('2D tilemap (world2d). Instantiated as a @pixi/tilemap CompositeTilemap');

package/dist/world2d/schema/tuples2d.d.ts

@@ -1,20 +0,0 @@
-import { z } from 'zod';
-/** 2D vector as [x, y]. The world2d analog of the 3D Vec3. */
-export declare const Vec2Schema: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
-export type Vec2 = z.infer<typeof Vec2Schema>;
-/**
- * 2D local transform — the world2d analog of the 3D TransformSchema.
- *
- * Orientation is a single scalar `rotation` (radians, about the screen Z axis),
- * NOT a quaternion: PixiJS display objects rotate in the plane. The runtime/editor
- * neutral `Transform` tuple (position[3]/quaternion[4]/scale[3]) maps onto this as
- * z = 0 and rotation about Z (see PIXI-WORLD2D-MAXIMAL-SPEC model-transform2d-section).
- */
-export declare const Transform2DSchema: z.ZodObject<{
-    position: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>;
-    rotation: z.ZodOptional<z.ZodNumber>;
-    scale: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>;
-    pivot: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>;
-}, z.core.$strip>;
-export type SceneTransform2D = z.infer<typeof Transform2DSchema>;
-//# sourceMappingURL=tuples2d.d.ts.map

package/dist/world2d/schema/tuples2d.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"tuples2d.d.ts","sourceRoot":"","sources":["../../../src/world2d/schema/tuples2d.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,8DAA8D;AAC9D,eAAO,MAAM,UAAU,8CAAoE,CAAC;AAE5F,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAE9C;;;;;;;GAOG;AACH,eAAO,MAAM,iBAAiB;;;;;iBAOwC,CAAC;AAEvE,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC"}

package/dist/world2d/schema/tuples2d.js

@@ -1,19 +0,0 @@
-import { z } from 'zod';
-/** 2D vector as [x, y]. The world2d analog of the 3D Vec3. */
-export const Vec2Schema = z.tuple([z.number(), z.number()]).describe('2D vector as [x, y]');
-/**
- * 2D local transform — the world2d analog of the 3D TransformSchema.
- *
- * Orientation is a single scalar `rotation` (radians, about the screen Z axis),
- * NOT a quaternion: PixiJS display objects rotate in the plane. The runtime/editor
- * neutral `Transform` tuple (position[3]/quaternion[4]/scale[3]) maps onto this as
- * z = 0 and rotation about Z (see PIXI-WORLD2D-MAXIMAL-SPEC model-transform2d-section).
- */
-export const Transform2DSchema = z
-    .object({
-    position: Vec2Schema.optional().describe('Local position [x, y] in world2d pixels'),
-    rotation: z.number().optional().describe('Rotation in radians about the Z axis. Default 0'),
-    scale: Vec2Schema.optional().describe('Scale per axis [x, y]. Default [1, 1]'),
-    pivot: Vec2Schema.optional().describe('Local pivot point [x, y] (center of rotation/scale)'),
-})
-    .describe('2D local transform relative to parent (world2d surface)');

package/dist/world2d/system-adapters-2d.d.ts

@@ -1,16 +0,0 @@
-import type { Container } from 'pixi.js';
-import type { Physics2DRegistry } from './physics2d-registry';
-/**
- * PhysicsAdapter2D — the world2d analog of the 3D PhysicsAdapter (rapier-physics-adapter).
- * Lets the editor coordinate editing of a Rapier-2D-driven entity WITHOUT owning the
- * simulation: report transform ownership, then freeze → commit → unfreeze so a drag
- * sticks instead of being stomped by the next physics step.
- */
-export interface PhysicsAdapter2D {
-    ownerOf(display: Container): 'physics' | 'none';
-    freeze(display: Container): void;
-    commit(display: Container, position: [number, number], rotation: number): void;
-    unfreeze(display: Container): void;
-}
-export declare function createPhysicsAdapter2D(physics: Physics2DRegistry): PhysicsAdapter2D;
-//# sourceMappingURL=system-adapters-2d.d.ts.map

package/dist/world2d/system-adapters-2d.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"system-adapters-2d.d.ts","sourceRoot":"","sources":["../../src/world2d/system-adapters-2d.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAE9D;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CAAC,OAAO,EAAE,SAAS,GAAG,SAAS,GAAG,MAAM,CAAC;IAChD,MAAM,CAAC,OAAO,EAAE,SAAS,GAAG,IAAI,CAAC;IACjC,MAAM,CAAC,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/E,QAAQ,CAAC,OAAO,EAAE,SAAS,GAAG,IAAI,CAAC;CACpC;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,iBAAiB,GAAG,gBAAgB,CAgCnF"}

package/dist/world2d/system-adapters-2d.js

@@ -1,37 +0,0 @@
-export function createPhysicsAdapter2D(physics) {
-    // Remember each frozen body's prior type so unfreeze restores it.
-    const frozen = new WeakMap();
-    return {
-        ownerOf(display) {
-            const refs = physics.get(display);
-            if (!refs)
-                return 'none';
-            return refs.body.isDynamic() || refs.body.isKinematic() ? 'physics' : 'none';
-        },
-        freeze(display) {
-            const refs = physics.get(display);
-            if (!refs)
-                return;
-            frozen.set(display, refs.body.bodyType());
-            // Kinematic-position bodies hold a pose without being driven by forces.
-            refs.body.setBodyType(2 /* KinematicPositionBased */, true);
-        },
-        commit(display, position, rotation) {
-            const refs = physics.get(display);
-            if (!refs)
-                return;
-            refs.body.setTranslation({ x: position[0], y: position[1] }, true);
-            refs.body.setRotation(rotation, true);
-        },
-        unfreeze(display) {
-            const refs = physics.get(display);
-            if (!refs)
-                return;
-            const prior = frozen.get(display);
-            if (prior !== undefined) {
-                refs.body.setBodyType(prior, true);
-                frozen.delete(display);
-            }
-        },
-    };
-}

package/dist/world2d/transform-writer-2d.d.ts

@@ -1,16 +0,0 @@
-import type { Physics2DRegistry } from './physics2d-registry';
-/**
- * Build the single postPhysics transform writer for world2d — the ~5-line 2D
- * analog of `createTransformWriter`.
- *
- * Rapier 2D reports `translation()` as `{x, y}` and `rotation()` as a SCALAR angle
- * (radians), so the writeback is simply `display.position.set(x, y)` +
- * `display.rotation = angle`. Scale is left untouched (Rapier carries no scale).
- *
- * Bodies are simulated in world2d pixel space directly (the surface uses a
- * y-down, pixel-unit world), so no unit conversion is needed; parented entities
- * are kept flat under the world container by the loader, mirroring the 3D writer's
- * scene-root fast path.
- */
-export declare function createTransformWriter2D(physics: Physics2DRegistry): () => void;
-//# sourceMappingURL=transform-writer-2d.d.ts.map

package/dist/world2d/transform-writer-2d.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"transform-writer-2d.d.ts","sourceRoot":"","sources":["../../src/world2d/transform-writer-2d.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAE9D;;;;;;;;;;;;GAYG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,iBAAiB,SAC3B,IAAI,CAO1C"}

package/dist/world2d/transform-writer-2d.js

@@ -1,22 +0,0 @@
-/**
- * Build the single postPhysics transform writer for world2d — the ~5-line 2D
- * analog of `createTransformWriter`.
- *
- * Rapier 2D reports `translation()` as `{x, y}` and `rotation()` as a SCALAR angle
- * (radians), so the writeback is simply `display.position.set(x, y)` +
- * `display.rotation = angle`. Scale is left untouched (Rapier carries no scale).
- *
- * Bodies are simulated in world2d pixel space directly (the surface uses a
- * y-down, pixel-unit world), so no unit conversion is needed; parented entities
- * are kept flat under the world container by the loader, mirroring the 3D writer's
- * scene-root fast path.
- */
-export function createTransformWriter2D(physics) {
-    return function writeTransforms2D() {
-        for (const [display, { body }] of physics.entries()) {
-            const t = body.translation();
-            display.position.set(t.x, t.y);
-            display.rotation = body.rotation();
-        }
-    };
-}

package/dist/world2d/types.d.ts

@@ -1,53 +0,0 @@
-import type RAPIER from '@dimforge/rapier2d-compat';
-import type { Application, Container } from 'pixi.js';
-import type { z } from 'zod';
-import type { createSystemRunner } from '../core/system-runner';
-import type { SystemPhaseName } from '../core/types';
-import type { ComponentManager } from '../ecs/component-manager';
-import type { GameComponent } from '../ecs/game-component';
-import type { Collision2DSystem } from './collision-2d';
-import type { Physics2DRegistry } from './physics2d-registry';
-/**
- * All world2d subsystems, passed to every world2d `setup(ctx)` and to each
- * `GameComponent<'pixijs'>` lifecycle method — the 2D analog of `GameContext`.
- *
- * Raw libraries (call directly, no wrappers): `app` / `stage` (PixiJS),
- * `rapier2dWorld` / `rapier2d` (Rapier 2D). Engine handles bridge them into the
- * SAME phase-ordered loop the 3D path uses (`systems` is the very same
- * `createSystemRunner`, and `PHASE_ORDER` is shared).
- */
-export interface World2DContext {
-    /** The PixiJS application. Its renderer draws `stage`; auto-ticker is disabled. */
-    app: Application;
-    /** The world2d scene-graph root (the camera/world container under app.stage). */
-    stage: Container;
-    /** The Rapier 2D physics `World`. One shared world per world2d scene. */
-    rapier2dWorld: RAPIER.World;
-    /** The Rapier 2D module namespace (RigidBodyDesc, ColliderDesc, Vector2, …). */
-    rapier2d: typeof RAPIER;
-    /** `Container ↔ Rapier2D body/collider` registry (+ collider→entity reverse index). */
-    physics2d: Physics2DRegistry;
-    /** Rapier 2D collision/trigger event dispatcher; drained each postPhysics. */
-    collisions2d: Collision2DSystem;
-    /** Manager for all live GameComponent instances in this pixi world — the
-     *  unified `ComponentManager` (`ecs/component-manager.ts`, constructed with
-     *  `{ kind: 'pixijs' }`). The world2d-silo-only manager this replaced
-     *  (T7.3) is deleted; every 2D component attaches here, exactly like a
-     *  threejs component attaches onto its world's manager. */
-    components: ComponentManager;
-    /** The phase-ordered system runner (shared with the 3D path). */
-    systems: ReturnType<typeof createSystemRunner>;
-    /** DOM overlay for screen-space React/HUD UI (pointer-events:none by default). */
-    uiContainer: HTMLDivElement;
-}
-/** Constructor type for `GameComponent<'pixijs'>` subclasses used in a world2d
- *  registry (carries static phase/schema) — the 2D-registry analog of
- *  `GameComponentClass` (`ecs/game-component.ts`), narrowed to the pixijs kind
- *  so `new Cls()` returns a properly-typed `GameComponent<'pixijs'>` without a cast. */
-export type Pixi2DComponentClass = (new () => GameComponent<'pixijs'>) & {
-    phase?: SystemPhaseName;
-    schema?: z.ZodObject<z.ZodRawShape>;
-};
-/** Component registry for world2d — a plain name→class map (the 2D analog). */
-export type Component2DRegistry = Record<string, Pixi2DComponentClass>;
-//# sourceMappingURL=types.d.ts.map

package/dist/world2d/types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/world2d/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,2BAA2B,CAAC;AACpD,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACtD,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAE9D;;;;;;;;GAQG;AACH,MAAM,WAAW,cAAc;IAC7B,mFAAmF;IACnF,GAAG,EAAE,WAAW,CAAC;IACjB,iFAAiF;IACjF,KAAK,EAAE,SAAS,CAAC;IACjB,yEAAyE;IACzE,aAAa,EAAE,MAAM,CAAC,KAAK,CAAC;IAC5B,gFAAgF;IAChF,QAAQ,EAAE,OAAO,MAAM,CAAC;IACxB,uFAAuF;IACvF,SAAS,EAAE,iBAAiB,CAAC;IAC7B,8EAA8E;IAC9E,YAAY,EAAE,iBAAiB,CAAC;IAChC;;;;+DAI2D;IAC3D,UAAU,EAAE,gBAAgB,CAAC;IAC7B,iEAAiE;IACjE,OAAO,EAAE,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAC;IAC/C,kFAAkF;IAClF,WAAW,EAAE,cAAc,CAAC;CAC7B;AAED;;;wFAGwF;AACxF,MAAM,MAAM,oBAAoB,GAAG,CAAC,UAAU,aAAa,CAAC,QAAQ,CAAC,CAAC,GAAG;IACvE,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB,MAAM,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;CACrC,CAAC;AAEF,+EAA+E;AAC/E,MAAM,MAAM,mBAAmB,GAAG,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC"}

package/dist/world2d/types.js

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

package/src/runtime/scene-ui-bridge.ts

@@ -1,86 +0,0 @@
-/**
- * Scene-UI render bridge (B1, widened design/24-scene-ui.md D3) — the injection
- * seam that keeps the engine React-free.
- *
- * The engine knows the scene carries a `ui` tree (data), but it does NOT know how to
- * render React. An editor-side module registers a renderer here (a thin wrapper over
- * the React `mountSceneUI`); the first-party scene adapter calls it at game-time to
- * mount the scene's UI into `host.ui` and disposes it on teardown. Fully decoupled:
- * the engine treats `sceneUI` and the handle as opaque. The optional third `services`
- * argument carries game-sourced data/components/events/projector (D2-D7) — still
- * opaque to the engine, still zero React import here.
- */
-
-/**
- * Structural match for `@vgai/scene-ui`'s `UIDataSource` — engine stays React-free
- * (this interface is duck-typed against the real one, not imported from it).
- */
-export interface SceneUIDataSourceLike {
-  get(path: string): unknown;
-  set(path: string, value: unknown): void;
-  subscribe(listener: () => void): () => void;
-  version(): number;
-}
-
-/**
- * Game-time services fed into a scene's UI mount (D2's "dynamic" layer). Every
- * field is optional: a renderer falls back to its own registration-time registry
- * (D2 merge rule) or built-in default when a field is absent. `components`/
- * `transforms`/`strings` stay `unknown`-valued here — they're React things the
- * scene-ui renderer casts to its real `UIComponentRegistry`/`TransformRegistry`/
- * `StringTables`.
- */
-export interface SceneUIGameServices {
-  /** Reactive game state the UI binds against (D4's `gameStateDataSource`, or a
-   *  game's own bus). Absent -> the renderer falls back to an empty static store. */
-  data?: SceneUIDataSourceLike;
-  /** `kind:"component"` leaf implementations, keyed by the name authored in the scene. */
-  components?: Record<string, unknown>;
-  /** Named binding transforms (`$bind.transform`). */
-  transforms?: Record<string, unknown>;
-  /** Localized string tables, keyed by locale then textKey. */
-  strings?: Record<string, Record<string, string>>;
-  locale?: string;
-  /** Routes a `kind:"button"` (etc.) `events.onClick` handler id to the game.
-   *  Absent -> a loud console.warn per event (D6 — no magic engine event bus). */
-  onEvent?: (handlerId: string, payload?: unknown) => void;
-  /** Projects an entity id to a screen-space point for world-tracked canvases
-   *  (D5). Returns null when the entity is unknown or behind the camera. */
-  worldProjector?: (entityId: string) => { x: number; y: number } | null;
-}
-
-export interface SceneUIHandle {
-  dispose(): void;
-  /** Re-render with new services without a remount (a late `setSceneUIServices`
-   *  call after the initial mount, D7). Optional — a renderer that can't update
-   *  in place may omit it; callers dispose+remount instead. */
-  update?(services: SceneUIGameServices): void;
-}
-
-/**
- * Renderer signature — `sceneUI` is the scene's `ui` array (opaque to the engine).
- * `services` is optional so existing 2-arg renderer functions keep working
- * unchanged (back-compat, D3/D5 §5).
- */
-export type SceneUIRenderer = (
-  container: HTMLElement,
-  sceneUI: unknown,
-  services?: SceneUIGameServices,
-) => SceneUIHandle;
-
-let _renderer: SceneUIRenderer | null = null;
-
-/** Register the React renderer (called once by the editor/runtime host). */
-export function setSceneUIRenderer(renderer: SceneUIRenderer | null): void {
-  _renderer = renderer;
-}
-
-/** Render a scene's UI into `container` if a renderer is registered, else no-op. */
-export function renderSceneUI(
-  container: HTMLElement,
-  sceneUI: unknown,
-  services?: SceneUIGameServices,
-): SceneUIHandle | null {
-  if (!_renderer || sceneUI == null) return null;
-  return _renderer(container, sceneUI, services);
-}

package/src/runtime/scene-ui-data.ts

@@ -1,119 +0,0 @@
-/**
- * gameStateDataSource (design/24-scene-ui.md D4) — the default scene-UI data
- * source: binds a scene's authored UI directly against live `GameComponent`
- * instance fields, with zero game-side wiring.
- *
- * Path grammar: `"<ComponentName>.<field.path>"` — the first segment resolves
- * through the SAME `ComponentRegistry` that resolves a scene's `components:`
- * entries (name -> class) to `game.queryByComponent(Class)[0]`, the rest walks
- * the live instance's own fields (components mutate `this` freely — the
- * state-bridge contract, `runtime/state-bridge.ts`). A text node bound to
- * `S1Session.wallet.money` just works.
- *
- * React-free, plain TS — `SceneUIDataSourceLike` is a structural (duck-typed)
- * match for `@vgai/scene-ui`'s real `UIDataSource`, so the engine never
- * imports the runtime that consumes this.
- */
-import type { GameComponent, GameComponentClass } from '../ecs/game-component';
-import type { ComponentRegistry } from '../scene/component-registry';
-import type { Game } from './game';
-import type { SceneUIDataSourceLike } from './scene-ui-bridge';
-
-function splitRoot(path: string): [root: string, rest: string] {
-  const dot = path.indexOf('.');
-  return dot === -1 ? [path, ''] : [path.slice(0, dot), path.slice(dot + 1)];
-}
-
-function readRest(obj: unknown, rest: string): unknown {
-  if (!rest) return obj;
-  let cur: unknown = obj;
-  for (const key of rest.split('.')) {
-    if (cur == null || typeof cur !== 'object') return undefined;
-    cur = (cur as Record<string, unknown>)[key];
-  }
-  return cur;
-}
-
-/**
- * Build the default `SceneUIDataSourceLike` over a game's live components.
- *
- * `subscribe`/`version` are driven by `game.state` (bumps once per completed
- * frame, after every world's phases — see `state-bridge.ts`) PLUS a local
- * bump on `set()`, so a two-way control's own write echoes immediately
- * instead of waiting for the next frame.
- */
-export function gameStateDataSource(
-  game: Game,
-  registry: ComponentRegistry,
-): SceneUIDataSourceLike {
-  let version = 0;
-  const listeners = new Set<() => void>();
-  // Warn-once-per-root-segment (D4/§9 review checklist): a scene author
-  // typo'ing a component name in a binding should be loud exactly once, not
-  // on every `get()` (a bound node re-reads its path every render).
-  const warnedRoots = new Set<string>();
-
-  const notify = (): void => {
-    for (const listener of listeners) listener();
-  };
-
-  /** Resolves a root segment to its live component instance, or undefined. */
-  const resolveInstance = (root: string): GameComponent | undefined => {
-    const Klass: GameComponentClass | undefined = registry[root];
-    if (!Klass) {
-      if (!warnedRoots.has(root)) {
-        warnedRoots.add(root);
-        console.warn(
-          `scene-ui: data binding root "${root}" is not a registered component name — ` +
-            'check the binding source against src/scripts/registry.ts.',
-        );
-      }
-      return undefined;
-    }
-    // Registered but zero live instances (e.g. not spawned yet this scene) is
-    // an ordinary, expected transient state — stays undefined, no warning.
-    return game.queryByComponent(Klass)[0];
-  };
-
-  // ONE subscription to the frame-versioned state bridge for this data
-  // source's whole lifetime, fanning out to however many external
-  // subscribers this scene-UI mount has.
-  game.state.subscribe(() => {
-    version++;
-    notify();
-  });
-
-  return {
-    get(path: string): unknown {
-      const [root, rest] = splitRoot(path);
-      const inst = resolveInstance(root);
-      return inst === undefined ? undefined : readRest(inst, rest);
-    },
-    set(path: string, value: unknown): void {
-      const [root, rest] = splitRoot(path);
-      const inst = resolveInstance(root);
-      if (inst === undefined || !rest) return;
-      const keys = rest.split('.');
-      let cur: Record<string, unknown> = inst as unknown as Record<string, unknown>;
-      for (let i = 0; i < keys.length - 1; i++) {
-        const key = keys[i] as string;
-        const next = cur[key];
-        if (next == null || typeof next !== 'object') return; // don't invent nested fields on a live instance
-        cur = next as Record<string, unknown>;
-      }
-      cur[keys[keys.length - 1] as string] = value;
-      // Two-way writes echo immediately, not on the next frame (D4).
-      version++;
-      notify();
-    },
-    subscribe(listener: () => void): () => void {
-      listeners.add(listener);
-      return () => {
-        listeners.delete(listener);
-      };
-    },
-    version(): number {
-      return version;
-    },
-  };
-}