@vgai/engine 0.3.0 → 0.4.0-canary.20260715.0

package/dist/world2d/ingest-iframe-2d.js

@@ -1,166 +0,0 @@
-/**
- * world2d iframe ingest tiers — the PixiJS analogs of the 3D ingest-iframe adapters.
- *
- *  - OPAQUE EMBED (tier 0-1): a prebuilt/self-contained bundle runs in a sandboxed
- *    iframe; hosted + sized + disposed, NOT introspectable.
- *  - IFRAME-REACHABLE (tier 2-3): a bundle runs in its own iframe realm, but its
- *    `import 'pixi.js'` is wired (via an importmap) to a blob module re-exporting the
- *    HOST's pixi instance, so every Application/Sprite it creates is a HOST-realm
- *    object → the host `Application.prototype.render` trap fires and capture works.
- */
-import { installSceneCapture2D, } from './scene-capture-2d';
-/** OPAQUE EMBED: sandboxed iframe, no scene introspection (tier 0-1). */
-export function mountIngestGame2DEmbed(html, container) {
-    const iframe = document.createElement('iframe');
-    iframe.setAttribute('sandbox', 'allow-scripts');
-    iframe.style.border = '0';
-    iframe.style.width = '100%';
-    iframe.style.height = '100%';
-    iframe.srcdoc = html;
-    container.appendChild(iframe);
-    return { iframe, dispose: () => iframe.remove() };
-}
-const HOST_PIXI_KEY = '__vgaiHostPixi';
-/** Build a blob module that re-exports the host's pixi namespace (for the importmap). */
-function makeHostPixiReexportUrl(pixiNamespace) {
-    window[HOST_PIXI_KEY] = pixiNamespace;
-    const ident = /^[A-Za-z_$][A-Za-z0-9_$]*$/;
-    const keys = Object.keys(pixiNamespace).filter((k) => k !== 'default' && ident.test(k));
-    const body = `const T = window.parent[${JSON.stringify(HOST_PIXI_KEY)}];\n` +
-        `export default T;\n` +
-        keys.map((k) => `export const ${k} = T[${JSON.stringify(k)}];`).join('\n');
-    return URL.createObjectURL(new Blob([body], { type: 'text/javascript' }));
-}
-let _reexportKeySeq = 0;
-/**
- * Generalized host-namespace re-export (the multi-dep analog of {@link makeHostPixiReexportUrl}).
- * Stashes `ns` (an ES module namespace object, e.g. `import * as ns from 'gsap'`) on a unique
- * window key and builds a blob module re-exporting it, so the iframe's importmap can map a bare
- * specifier (pixi.js, @pixi/sound, @pixi/ui, gsap, …) to the HOST's single instance. Default-export
- * handling: `export default T.default ?? T` so `import gsap from 'gsap'` gets gsap, while a
- * default-less namespace (pixi.js) re-exports the namespace itself for `import * as`.
- */
-function makeHostNamespaceReexportUrl(ns) {
-    const key = `__vgaiHostNs_${_reexportKeySeq++}`;
-    window[key] = ns;
-    const ident = /^[A-Za-z_$][A-Za-z0-9_$]*$/;
-    const keys = Object.keys(ns).filter((k) => k !== 'default' && ident.test(k));
-    const body = `const T = window.parent[${JSON.stringify(key)}];\n` +
-        `export default (T && T.default !== undefined ? T.default : T);\n` +
-        keys.map((k) => `export const ${k} = T[${JSON.stringify(k)}];`).join('\n');
-    return URL.createObjectURL(new Blob([body], { type: 'text/javascript' }));
-}
-/**
- * IFRAME-REACHABLE for REAL MULTI-FILE GAMES (cov2d-bundled-dedupe): run a built game bundle
- * (its OWN unaltered source, externalized against pixi at build time) in its own iframe realm
- * whose importmap maps EVERY shared bare dep — pixi.js + @pixi/sound/@pixi/ui/gsap/… — to the
- * HOST instances, and (optionally) a <base href> so its AssetPack/manifest URLs resolve. The
- * host `Application.prototype.render` trap then captures the live stage IN-REALM. The game's
- * source is never touched; all of this is host-side wiring.
- */
-export async function mountIngestGame2DIframeReachableMulti(pixiNamespace, container, opts) {
-    const capture = installSceneCapture2D(pixiNamespace);
-    const created = [];
-    const mkUrl = (ns) => {
-        const u = makeHostNamespaceReexportUrl(ns);
-        created.push(u);
-        return u;
-    };
-    const imports = {
-        'pixi.js': mkUrl(pixiNamespace),
-    };
-    for (const [spec, ns] of Object.entries(opts.extraDeps ?? {}))
-        imports[spec] = mkUrl(ns);
-    // D-Z3 fallback: verbatim URL entries, no blob wrapping, merged in beside
-    // the host-namespace ones — decision-free (see `extraDepUrls`'s doc comment).
-    for (const [spec, url] of Object.entries(opts.extraDepUrls ?? {}))
-        imports[spec] = url;
-    // Host-side asset URL remap (asset adapter): force the game's Assets.init basePath to an
-    // absolute URL so its assets resolve to the served bundle dir, not the parent page path.
-    let restoreInit;
-    if (opts.assetBaseUrl) {
-        const assetsApi = pixiNamespace.Assets;
-        if (assetsApi?.init) {
-            const orig = assetsApi.init.bind(assetsApi);
-            assetsApi.init = (o = {}) => orig({ ...o, basePath: opts.assetBaseUrl });
-            restoreInit = () => {
-                assetsApi.init = orig;
-            };
-        }
-    }
-    const iframe = document.createElement('iframe');
-    iframe.style.border = '0';
-    iframe.style.width = '100%';
-    iframe.style.height = '100%';
-    container.appendChild(iframe);
-    // Split the closing script token so this module's own bundling never sees a literal
-    // </script> (defensive; matches the single-dep mount's convention).
-    const close = `</${'scr'}ipt>`;
-    const baseTag = opts.baseHref ? `<base href="${opts.baseHref}">` : '';
-    const scriptTag = opts.bundleUrl
-        ? `<script type="module" src="${opts.bundleUrl}">${close}`
-        : `<script type="module">${opts.inlineSrc ?? ''}${close}`;
-    const importmapTag = `<script type="importmap">${JSON.stringify({ imports })}${close}`;
-    const bodyHtml = opts.bodyHtml ?? '';
-    const doc = iframe.contentDocument;
-    doc.open();
-    doc.write(`<!doctype html><html><head><meta charset="utf-8">${baseTag}${importmapTag}</head><body>${bodyHtml}${scriptTag}</body></html>`);
-    doc.close();
-    let captured = null;
-    try {
-        captured = await capture.waitForCapture(opts.captureTimeoutMs ?? 12_000);
-    }
-    catch {
-        captured = null;
-    }
-    return {
-        iframe,
-        capture,
-        captured,
-        dispose: () => {
-            capture.uninstall();
-            restoreInit?.();
-            for (const u of created)
-                URL.revokeObjectURL(u);
-            iframe.remove();
-        },
-    };
-}
-/**
- * IFRAME-REACHABLE (tier 2-3): run `gameModuleSrc` in an iframe whose importmap maps
- * `pixi.js` to a host-pixi re-export blob, and trap the host `Application.prototype`
- * so the bundle's render is captured in-realm.
- */
-export async function mountIngestGame2DIframeReachable(pixiNamespace, gameModuleSrc, container, opts = {}) {
-    const capture = installSceneCapture2D(pixiNamespace);
-    const reexportUrl = makeHostPixiReexportUrl(pixiNamespace);
-    const iframe = document.createElement('iframe');
-    iframe.style.border = '0';
-    iframe.style.width = '100%';
-    iframe.style.height = '100%';
-    container.appendChild(iframe);
-    const doc = iframe.contentDocument;
-    doc.open();
-    doc.write(`<!doctype html><html><head><meta charset="utf-8">` +
-        `<script type="importmap">${JSON.stringify({ imports: { 'pixi.js': reexportUrl } })}</scr` +
-        `ipt></head><body><script type="module">${gameModuleSrc}</scr` +
-        `ipt></body></html>`);
-    doc.close();
-    let captured = null;
-    try {
-        captured = await capture.waitForCapture(opts.captureTimeoutMs ?? 8000);
-    }
-    catch {
-        captured = null;
-    }
-    return {
-        iframe,
-        capture,
-        captured,
-        dispose: () => {
-            capture.uninstall();
-            URL.revokeObjectURL(reexportUrl);
-            iframe.remove();
-        },
-    };
-}

package/dist/world2d/ingest2d.d.ts

@@ -1,97 +0,0 @@
-import { type SceneCapture2DHandle } from './scene-capture-2d';
-/**
- * D-Z3 (docs/WAVE3-ADAPTER-PLUMBING-DESIGN.md) — a manifest's `extraDeps`
- * resolve to TWO kinds of importmap entry: `namespaces` are today's
- * registry-known bare specifiers (host-namespace-registry.ts), re-exported
- * via a blob module (`ingest-iframe-2d.ts`'s `makeHostNamespaceReexportUrl`);
- * `urls` are the D-Z3 fallback — a specifier that isn't registered but IS
- * present in the open project's own `node_modules`, mapped DIRECTLY to its
- * `/project-game-static/node_modules/<spec>/<esm entry>` URL (no host-side
- * import, no blob — the dep executes in the iframe realm and its own
- * transitive `import 'pixi.js'` resolves through the same importmap back to
- * the host pixi trap). All probing/decision logic (which kind a specifier
- * resolves to, exports-map parsing, anti-shim throws) lives editor-side
- * (`host-namespace-registry.ts`) — this engine module only carries the
- * ALREADY-DECIDED shape; `ingest-iframe-2d.ts` stays decision-free and just
- * merges both maps into the iframe importmap.
- */
-export interface ExtraDepsResolution2D {
-    namespaces: Record<string, Record<string, unknown>>;
-    urls: Record<string, string>;
-}
-/** A registered unmodified PixiJS game (the world2d analog of `IngestGame`). */
-export interface IngestGame2D {
-    id: string;
-    name: string;
-    description: string;
-    /** Shared-pixi path: import + run the unmodified game module. */
-    load?: () => Promise<unknown>;
-    /** Tier ceiling: how reachable the game's pixi instance is. */
-    tier?: 'shared' | 'iframe-reachable' | 'opaque-embed';
-    captureTimeoutMs?: number;
-    /**
-     * IFRAME-REACHABLE-MULTI fields (Track P, docs/PIXI-INGEST-LANDING-DESIGN.md
-     * §2): an externalized built bundle mounted via
-     * `mountIngestGame2DIframeReachableMulti` (`./ingest-iframe-2d.ts`) instead
-     * of `load()` — populated only when `tier` is `'iframe-reachable'` AND
-     * `load` is absent. Mirror `IframeReachableMultiOpts`'s fields, EXCEPT
-     * `extraDeps`/`pixiNamespace` are THUNKS here, not resolved values — the
-     * same "lazy, only invoked at mount time" shape `load` already uses, so
-     * building this descriptor (`resolveIngest2DDescriptor` / `discovery2d.ts`,
-     * editor-side) never has to be async just to wire up which specifiers/
-     * version-skew URL a game needs; only actually MOUNTING it (the ingest-mode
-     * mount bridge) pays for the dynamic import of `@pixi/sound`/`gsap`/spine/
-     * a standalone pixi build.
-     */
-    bundleUrl?: string;
-    /** <base href> for the iframe (see `IframeReachableMultiOpts.baseHref`). */
-    baseHref?: string;
-    /** Host-side Assets.init basePath remap (see `IframeReachableMultiOpts.assetBaseUrl`). */
-    assetBaseUrl?: string;
-    /**
-     * Lazily resolve this game's bare-specifier -> extraDeps resolution via the
-     * editor's host-namespace registry. Absent (or omitted) means no extra deps
-     * beyond pixi.js.
-     */
-    extraDeps?: () => Promise<ExtraDepsResolution2D>;
-    /**
-     * Lazily resolve the trapped-pixi namespace for version-skewed games (a
-     * dynamic `import()` of the manifest's `pixiModuleUrl`) — absent means
-     * "mount against the host's own `pixi.js`" (no skew).
-     */
-    pixiNamespace?: () => Promise<unknown>;
-    /** DOM the game expects before boot (see `IframeReachableMultiOpts.bodyHtml`). */
-    bodyHtml?: string;
-    /**
-     * Lazily read an OPAQUE prebuilt bundle's self-contained HTML (D-W2,
-     * docs/WAVE4-FTUE-HARDENING-DESIGN.md) — the pixi twin of `IngestGame.embedHtml`.
-     * Always a lazy thunk here (no in-tree world2d opaque-embed fixture exists
-     * yet to need a plain-string form, unlike the three side):
-     * `resolveIngest2DDescriptor` (adapter-resolver.ts) builds one that reads
-     * the declared `entryHtml` file's bytes through the `/project-game-static/`
-     * route, only when the game is actually mounted. The host runs the
-     * resolved HTML in a sandboxed iframe at the embed-only floor (Tier 0-1),
-     * `mountIngestGame2DEmbed` (`./ingest-iframe-2d.ts`).
-     */
-    embedHtml?: () => Promise<string>;
-}
-export interface IngestMount2D {
-    /** The captured live stage Container (null if capture failed/degraded). */
-    stage: unknown | null;
-    capture: SceneCapture2DHandle;
-    embedOnly: boolean;
-    setPaused(paused: boolean): void;
-    dispose(): void;
-}
-/**
- * Mount an UNMODIFIED PixiJS game via the shared-instance capture path — the 2D
- * analog of `mountIngestGame`. Installs the render trap on the host's pixi
- * instance, runs the game's `load()`, waits for the game to render its first
- * frame (capturing its live stage), and exposes loop gating + cleanup. If capture
- * times out (pixi unreachable / bundled / mismatched), degrades to embed-only —
- * never a silent failure.
- */
-export declare function mountIngestGame2D(pixiNamespace: unknown, game: IngestGame2D, opts?: {
-    captureTimeoutMs?: number;
-}): Promise<IngestMount2D>;
-//# sourceMappingURL=ingest2d.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"ingest2d.d.ts","sourceRoot":"","sources":["../../src/world2d/ingest2d.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyB,KAAK,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAEtF;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACpD,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B;AAED,gFAAgF;AAChF,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,iEAAiE;IACjE,IAAI,CAAC,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IAC9B,+DAA+D;IAC/D,IAAI,CAAC,EAAE,QAAQ,GAAG,kBAAkB,GAAG,cAAc,CAAC;IACtD,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;;;;;;;;;;;;OAaG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4EAA4E;IAC5E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0FAA0F;IAC1F,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,OAAO,CAAC,qBAAqB,CAAC,CAAC;IACjD;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IACvC,kFAAkF;IAClF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;;;;;;;OAUG;IACH,SAAS,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,aAAa;IAC5B,2EAA2E;IAC3E,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;IACtB,OAAO,EAAE,oBAAoB,CAAC;IAC9B,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC;IACjC,OAAO,IAAI,IAAI,CAAC;CACjB;AAED;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CACrC,aAAa,EAAE,OAAO,EACtB,IAAI,EAAE,YAAY,EAClB,IAAI,GAAE;IAAE,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAAO,GACvC,OAAO,CAAC,aAAa,CAAC,CA6BxB"}

package/dist/world2d/ingest2d.js

@@ -1,40 +0,0 @@
-import { installSceneCapture2D } from './scene-capture-2d';
-/**
- * Mount an UNMODIFIED PixiJS game via the shared-instance capture path — the 2D
- * analog of `mountIngestGame`. Installs the render trap on the host's pixi
- * instance, runs the game's `load()`, waits for the game to render its first
- * frame (capturing its live stage), and exposes loop gating + cleanup. If capture
- * times out (pixi unreachable / bundled / mismatched), degrades to embed-only —
- * never a silent failure.
- */
-export async function mountIngestGame2D(pixiNamespace, game, opts = {}) {
-    const capture = installSceneCapture2D(pixiNamespace);
-    try {
-        await game.load?.();
-    }
-    catch (err) {
-        capture.uninstall();
-        throw new Error(`world2d ingest: game "${game.id}" failed to load: ${err}`);
-    }
-    const timeout = opts.captureTimeoutMs ?? game.captureTimeoutMs ?? 8000;
-    try {
-        const rt = await capture.waitForCapture(timeout);
-        return {
-            stage: rt.stage,
-            capture,
-            embedOnly: false,
-            setPaused: (p) => capture.setPaused(p),
-            dispose: () => capture.uninstall(),
-        };
-    }
-    catch {
-        // Capture failed → pixi unreachable/mismatched → degrade to embed-only.
-        return {
-            stage: null,
-            capture,
-            embedOnly: true,
-            setPaused: () => { },
-            dispose: () => capture.uninstall(),
-        };
-    }
-}

package/dist/world2d/physics2d-registry.d.ts

@@ -1,24 +0,0 @@
-import type RAPIER from '@dimforge/rapier2d-compat';
-import type { Container } from 'pixi.js';
-/** The Rapier 2D handles owned by a single display-object entity. */
-export interface Physics2DRefs {
-    body: RAPIER.RigidBody;
-    collider: RAPIER.Collider;
-}
-/**
- * Maps PixiJS display objects to their Rapier 2D bodies/colliders and back —
- * the world2d analog of `PhysicsRegistry`. Two indexes:
- *  - `Container → {body, collider}` for the postPhysics transform writer.
- *  - `colliderHandle → Container` reverse index for collision/trigger dispatch.
- */
-export declare function createPhysics2DRegistry(): {
-    add(display: Container, body: RAPIER.RigidBody, collider: RAPIER.Collider): void;
-    get(display: Container): Physics2DRefs | undefined;
-    getByColliderHandle(handle: number): Container | undefined;
-    remove(display: Container): void;
-    entries(): IterableIterator<[Container, Physics2DRefs]>;
-    readonly size: number;
-    clear(): void;
-};
-export type Physics2DRegistry = ReturnType<typeof createPhysics2DRegistry>;
-//# sourceMappingURL=physics2d-registry.d.ts.map

package/dist/world2d/physics2d-registry.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"physics2d-registry.d.ts","sourceRoot":"","sources":["../../src/world2d/physics2d-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,2BAA2B,CAAC;AACpD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEzC,qEAAqE;AACrE,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC,SAAS,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC;CAC3B;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB;iBAKtB,SAAS,QAAQ,MAAM,CAAC,SAAS,YAAY,MAAM,CAAC,QAAQ,GAAG,IAAI;iBAInE,SAAS,GAAG,aAAa,GAAG,SAAS;gCAGtB,MAAM,GAAG,SAAS,GAAG,SAAS;oBAG1C,SAAS,GAAG,IAAI;eAKrB,gBAAgB,CAAC,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;mBAG3C,MAAM;aAGT,IAAI;EAKhB;AAED,MAAM,MAAM,iBAAiB,GAAG,UAAU,CAAC,OAAO,uBAAuB,CAAC,CAAC"}

package/dist/world2d/physics2d-registry.js

@@ -1,38 +0,0 @@
-/**
- * Maps PixiJS display objects to their Rapier 2D bodies/colliders and back —
- * the world2d analog of `PhysicsRegistry`. Two indexes:
- *  - `Container → {body, collider}` for the postPhysics transform writer.
- *  - `colliderHandle → Container` reverse index for collision/trigger dispatch.
- */
-export function createPhysics2DRegistry() {
-    const byObject = new Map();
-    const byColliderHandle = new Map();
-    return {
-        add(display, body, collider) {
-            byObject.set(display, { body, collider });
-            byColliderHandle.set(collider.handle, display);
-        },
-        get(display) {
-            return byObject.get(display);
-        },
-        getByColliderHandle(handle) {
-            return byColliderHandle.get(handle);
-        },
-        remove(display) {
-            const refs = byObject.get(display);
-            if (refs)
-                byColliderHandle.delete(refs.collider.handle);
-            byObject.delete(display);
-        },
-        entries() {
-            return byObject.entries();
-        },
-        get size() {
-            return byObject.size;
-        },
-        clear() {
-            byObject.clear();
-            byColliderHandle.clear();
-        },
-    };
-}

package/dist/world2d/pixi-game-adapter.d.ts

@@ -1,107 +0,0 @@
-import type { Container } from 'pixi.js';
-import type { MountedPixiWorld } from '../adapter/game-adapter';
-import { type WorldFrameHooks } from '../runtime/game';
-import type { Scene2DFile } from './schema/entity2d';
-import type { Component2DRegistry, World2DContext } from './types';
-/** Minimal host surface for world2d (the stacked-own-root model from the spec). */
-export interface World2DHost {
-    canvas: HTMLCanvasElement;
-    width: number;
-    height: number;
-    /** Screen-space React/HUD overlay container. */
-    ui?: HTMLDivElement;
-    /** DPR override (T6.1 slice 1, COMPOSITION-DESIGN.md D5 §3 — "one DPR
-     *  everywhere"): the worlds-path host computes ONE dpr for every stacked
-     *  surface and passes it here; omitted -> `createPixiSurface`'s own
-     *  default (`window.devicePixelRatio`, uncapped) — today's behavior. */
-    dpr?: number;
-    /** This world is stacked ABOVE another world (D5 §1): clear with alpha 0
-     *  instead of an opaque background so the layer below shows through. */
-    transparent?: boolean;
-    /** Capture tier cost (D5 §4) — see `PixiSurfaceOptions.preserveDrawingBuffer`. */
-    preserveDrawingBuffer?: boolean;
-}
-/** A world2d setup function — build the scene from the context, return cleanup. */
-export type World2DSetupFn = (ctx: World2DContext) => Promise<{
-    dispose: () => void;
-}> | {
-    dispose: () => void;
-};
-/**
- * MountedGame for world2d — the pixi peer of the 3D `MountedThreeWorld`,
- * satisfying `MountedPixiWorld` (`adapter/game-adapter.ts`, T7.5) via `kind`/
- * `stage` so a `WorldInstance` built from this mount needs no cast through
- * the generic `MountedWorld` union. `scene`/`camera` (both the SAME `Container`
- * as `stage`) are kept as extra fields for pre-T7.5 call sites/tests that
- * already read them — `stage` is the canonical name going forward.
- */
-export interface MountedGame2D extends MountedPixiWorld {
-    /** First-party brand (T7.3 slice 2 — closes the gap `adapter/vgai-scene-
-     *  game-adapter.ts`'s `VgaiMountedGame.firstParty` doc flagged as a "T7.3
-     *  lookahead"): `runtime/game.ts`'s `isFirstPartyMounted` brand-checks
-     *  this literal, NOT a structural `'ctx' in mounted` probe (this mount's
-     *  `ctx` is a `World2DContext`, unrelated to `GameContext`). Without this,
-     *  a pixijs `WorldInstance` is silently skipped by every first-party-only
-     *  Game feature — `Game.queryByComponent` in particular, the T7.3 AC
-     *  (`test/game-three-plus-pixi.test.ts`). */
-    readonly firstParty: true;
-    /** Pre-T7.5 field names, kept for compatibility — both alias `stage`
-     *  (pixi has no separate camera concept; `MountedGame2D.mount` always sets
-     *  `scene === camera === stage`). */
-    readonly scene: Container;
-    readonly camera: Container;
-    readonly ctx: World2DContext;
-    update?(dt: number): void;
-    resize?(width: number, height: number): void;
-    dispose(): void;
-    /** Phase-partitioned frame entry point (T7.3 slice 1) — the pixi analog of
-     *  `VgaiMountedGame.frame` (`adapter/vgai-scene-game-adapter.ts`). Delegates
-     *  to this mount's own `SystemRunner`, so a `WorldInstance` built from this
-     *  mount ticks it through `Game.runFrame` instead of a standalone loop. */
-    readonly frame?: WorldFrameHooks;
-}
-export interface PixiSceneConfig {
-    /** A world2d scene file to load (declarative path). */
-    sceneData?: Scene2DFile;
-    /** A setup function (imperative path) — mutually exclusive with sceneData. */
-    setup?: World2DSetupFn;
-    /** Component registry the scene's `components` reference. */
-    registry?: Component2DRegistry;
-    id?: string;
-}
-/**
- * The first-party implementer that mounts an authored world2d scene — the 2D
- * analog of `VgaiSceneGameAdapter`. It builds the Pixi surface + Rapier 2D world,
- * registers the engine systems into the shared phase runner, loads the scene (or
- * runs a setup), and returns a `MountedGame2D`.
- */
-export declare class PixiSceneGameAdapter {
-    private readonly config;
-    readonly id: string;
-    constructor(config?: PixiSceneConfig);
-    mount(host: World2DHost): Promise<MountedGame2D>;
-}
-/** Handle returned by {@link createWorld2DRuntime}. */
-export interface World2DSession {
-    stop(): void;
-    pause(): void;
-    resume(): void;
-    /** Advance exactly one fixed substep — the pixi analog of
-     *  `GameSession.step()` (`runtime/create-runtime.ts`), delegating to the
-     *  same `Game.play.step()` (D10, T7.6). */
-    step(): void;
-    resize(width: number, height: number): void;
-    readonly mounted: MountedGame2D;
-}
-/**
- * Host entry for world2d — the sibling of `createGameRuntime`, kept separate so the
- * proven THREE host/interfaces are untouched (the stacked-own-root option the spec's
- * surface-host-backend-neutral allows). Owns the canvas and constructs a real `Game`
- * (T7.3 slice 1) with exactly one `'pixijs'`-kind `WorldInstance`, driven each fixed
- * substep through `Game.runFrame` — the world2d analog of `createGameRuntime`'s
- * `registerDefaultThreeWorld` (`runtime/create-runtime.ts`). Before T7.3 this ran its
- * own standalone `createGameLoop` calling `mounted.update` directly; that loop is
- * retired here in favor of one shared frame executor per game root.
- */
-export declare function createWorld2DRuntime(config: PixiSceneConfig & World2DHost): Promise<World2DSession>;
-//# sourceMappingURL=pixi-game-adapter.d.ts.map

package/dist/world2d/pixi-game-adapter.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"pixi-game-adapter.d.ts","sourceRoot":"","sources":["../../src/world2d/pixi-game-adapter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAKhE,OAAO,EAIL,KAAK,eAAe,EACrB,MAAM,iBAAiB,CAAC;AAMzB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,OAAO,KAAK,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAEnE,mFAAmF;AACnF,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,iBAAiB,CAAC;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,gDAAgD;IAChD,EAAE,CAAC,EAAE,cAAc,CAAC;IACpB;;;4EAGwE;IACxE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;4EACwE;IACxE,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,kFAAkF;IAClF,qBAAqB,CAAC,EAAE,OAAO,CAAC;CACjC;AAED,mFAAmF;AACnF,MAAM,MAAM,cAAc,GAAG,CAC3B,GAAG,EAAE,cAAc,KAChB,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,IAAI,CAAA;CAAE,CAAC,GAAG;IAAE,OAAO,EAAE,MAAM,IAAI,CAAA;CAAE,CAAC;AAEhE;;;;;;;GAOG;AACH,MAAM,WAAW,aAAc,SAAQ,gBAAgB;IACrD;;;;;;;iDAO6C;IAC7C,QAAQ,CAAC,UAAU,EAAE,IAAI,CAAC;IAC1B;;yCAEqC;IACrC,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,QAAQ,CAAC,GAAG,EAAE,cAAc,CAAC;IAC7B,MAAM,CAAC,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,MAAM,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7C,OAAO,IAAI,IAAI,CAAC;IAChB;;;+EAG2E;IAC3E,QAAQ,CAAC,KAAK,CAAC,EAAE,eAAe,CAAC;CAClC;AAED,MAAM,WAAW,eAAe;IAC9B,uDAAuD;IACvD,SAAS,CAAC,EAAE,WAAW,CAAC;IACxB,8EAA8E;IAC9E,KAAK,CAAC,EAAE,cAAc,CAAC;IACvB,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,mBAAmB,CAAC;IAC/B,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED;;;;;GAKG;AACH,qBAAa,oBAAoB;IAEnB,OAAO,CAAC,QAAQ,CAAC,MAAM;IADnC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;gBACS,MAAM,GAAE,eAAoB;IAInD,KAAK,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,aAAa,CAAC;CAkHvD;AAED,uDAAuD;AACvD,MAAM,WAAW,cAAc;IAC7B,IAAI,IAAI,IAAI,CAAC;IACb,KAAK,IAAI,IAAI,CAAC;IACd,MAAM,IAAI,IAAI,CAAC;IACf;;+CAE2C;IAC3C,IAAI,IAAI,IAAI,CAAC;IACb,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5C,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;CACjC;AAED;;;;;;;;;GASG;AACH,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,eAAe,GAAG,WAAW,GACpC,OAAO,CAAC,cAAc,CAAC,CAiFzB"}