@forgeax/engine-app 0.0.0-dev.8d955ade1c79

package/dist/input-map-plugin.d.ts

@@ -0,0 +1,5 @@
+import { type ActionConfig } from '@forgeax/engine-input';
+import type { Plugin } from '@forgeax/engine-plugin';
+/** Install the canvas-form action map as an App-owned World contribution. */
+export declare function inputMapPlugin(configs: readonly ActionConfig[]): Plugin;
+//# sourceMappingURL=input-map-plugin.d.ts.map

package/dist/input-map-plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"input-map-plugin.d.ts","sourceRoot":"","sources":["../src/input-map-plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,YAAY,EAAiB,MAAM,uBAAuB,CAAC;AACzE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAErD,6EAA6E;AAC7E,wBAAgB,cAAc,CAAC,OAAO,EAAE,SAAS,YAAY,EAAE,GAAG,MAAM,CAgBvE"}

package/dist/input-plugin.d.ts

@@ -0,0 +1,4 @@
+import type { Plugin } from '@forgeax/engine-plugin';
+/** Project one Host-owned input provider into reversible World contributions. */
+export declare function inputPlugin(): Plugin;
+//# sourceMappingURL=input-plugin.d.ts.map

package/dist/input-plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"input-plugin.d.ts","sourceRoot":"","sources":["../src/input-plugin.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAErD,iFAAiF;AACjF,wBAAgB,WAAW,IAAI,MAAM,CAoBpC"}

package/dist/internal/assembled-engine-profile.d.ts

@@ -0,0 +1,5 @@
+import type { Plugin } from '@forgeax/engine-plugin';
+import type { EngineProfileBase } from './engine-profile-common';
+/** Assemble-form roots plus explicitly selected host capabilities. */
+export declare function assembledEngineProfile(options: EngineProfileBase): Plugin[];
+//# sourceMappingURL=assembled-engine-profile.d.ts.map

package/dist/internal/assembled-engine-profile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assembled-engine-profile.d.ts","sourceRoot":"","sources":["../../src/internal/assembled-engine-profile.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAGrD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAEjE,sEAAsE;AACtE,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,iBAAiB,GAAG,MAAM,EAAE,CAO3E"}

package/dist/internal/assets-world-plugin.d.ts

@@ -0,0 +1,7 @@
+import type { AssetRegistry } from '@forgeax/engine-assets-runtime';
+import type { Plugin } from '@forgeax/engine-plugin';
+/** Project the Renderer-owned AssetRegistry as a declared dependent service. */
+export declare function rendererAssetsPlugin(assets: AssetRegistry | undefined): Plugin;
+/** Project the realm AssetRegistry into legacy World resource lookup reversibly. */
+export declare function assetsWorldPlugin(): Plugin;
+//# sourceMappingURL=assets-world-plugin.d.ts.map

package/dist/internal/assets-world-plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assets-world-plugin.d.ts","sourceRoot":"","sources":["../../src/internal/assets-world-plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AACpE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAIrD,gFAAgF;AAChF,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,aAAa,GAAG,SAAS,GAAG,MAAM,CAS9E;AAED,oFAAoF;AACpF,wBAAgB,iBAAiB,IAAI,MAAM,CAc1C"}

package/dist/internal/browser-remote-bridge.d.ts

@@ -0,0 +1,24 @@
+import { type World } from '@forgeax/engine-ecs';
+export interface BrowserRemoteBridgeDeps {
+    readonly world: World;
+    readonly renderer: unknown;
+    readonly assets: unknown;
+    /** The host's already-loaded runtime namespace; preserves component-token identity. */
+    readonly runtimeModule: unknown;
+    readonly rhiCapture?: unknown;
+    /** The host's explicit CPU profiler capability, when opted in. */
+    readonly profiler?: unknown;
+    readonly execution?: unknown;
+    /** Relay port. */
+    readonly port: string;
+}
+/**
+ * Install the DEV-only browser remote bridge. Idempotent per call site; the
+ * caller gates on import.meta.env.DEV so this never runs in production.
+ *
+ * Returns a teardown function that stops reconnection and closes the socket —
+ * the caller wires it to import.meta.hot.dispose so a vite HMR of the host app
+ * does not stack duplicate bridges.
+ */
+export declare function installBrowserRemoteBridge(deps: BrowserRemoteBridgeDeps): Promise<() => void>;
+//# sourceMappingURL=browser-remote-bridge.d.ts.map

package/dist/internal/browser-remote-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-remote-bridge.d.ts","sourceRoot":"","sources":["../../src/internal/browser-remote-bridge.ts"],"names":[],"mappings":"AAyBA,OAAO,EAAU,KAAK,KAAK,EAAE,MAAM,qBAAqB,CAAC;AA8CzD,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,uFAAuF;IACvF,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;IAC9B,kEAAkE;IAClE,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAC7B,kBAAkB;IAClB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AA0BD;;;;;;;GAOG;AACH,wBAAsB,0BAA0B,CAC9C,IAAI,EAAE,uBAAuB,GAC5B,OAAO,CAAC,MAAM,IAAI,CAAC,CAqJrB"}

package/dist/internal/browser-rhi-debug-runtime.d.ts

@@ -0,0 +1,18 @@
+import type { Renderer } from '@forgeax/engine-render';
+import type { RhiDevice, RhiInstance } from '@forgeax/engine-rhi';
+import type { CreateShaderModuleFn, RecorderAttachment } from '@forgeax/engine-rhi-debug';
+export interface BrowserRhiDebugRuntime {
+    readonly rhi: RhiInstance;
+    readonly attachment: RecorderAttachment;
+    readonly createReplayDevice: () => Promise<import('@forgeax/engine-types').Result<RhiDevice, unknown>>;
+    readonly createShaderModule: CreateShaderModuleFn;
+    readonly rhiInstrumentation: import('@forgeax/engine-render/internal/construct-renderer').RhiBackendInstrumentation;
+    attachRenderer(renderer: Renderer): () => void;
+}
+/**
+ * Assemble the browser preview's recorder at the Runtime seam. The preview
+ * host owns the attachment and consumes only the encoded tape; it does not
+ * reach into recorder state or reintroduce the removed DebugRhi facade.
+ */
+export declare function createBrowserRhiDebugRuntime(): Promise<BrowserRhiDebugRuntime>;
+//# sourceMappingURL=browser-rhi-debug-runtime.d.ts.map

package/dist/internal/browser-rhi-debug-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-rhi-debug-runtime.d.ts","sourceRoot":"","sources":["../../src/internal/browser-rhi-debug-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClE,OAAO,KAAK,EACV,oBAAoB,EAEpB,kBAAkB,EACnB,MAAM,2BAA2B,CAAC;AAInC,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,GAAG,EAAE,WAAW,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,kBAAkB,CAAC;IACxC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,OAAO,CACxC,OAAO,uBAAuB,EAAE,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,CAC3D,CAAC;IACF,QAAQ,CAAC,kBAAkB,EAAE,oBAAoB,CAAC;IAClD,QAAQ,CAAC,kBAAkB,EAAE,OAAO,oDAAoD,EAAE,yBAAyB,CAAC;IACpH,cAAc,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,IAAI,CAAC;CAChD;AAmBD;;;;GAIG;AACH,wBAAsB,4BAA4B,IAAI,OAAO,CAAC,sBAAsB,CAAC,CAuBpF"}

package/dist/internal/component-introspection.d.ts

@@ -0,0 +1,24 @@
+import { type Component } from '@forgeax/engine-ecs';
+export type JsonValue = null | boolean | number | string | readonly JsonValue[] | {
+    readonly [key: string]: JsonValue;
+};
+export interface ComponentIntrospectionField {
+    readonly type: string;
+    readonly default?: JsonValue;
+    readonly shape?: string;
+    readonly transient?: boolean;
+    readonly arrayMeta?: {
+        readonly elementType: string;
+        readonly length?: number;
+    };
+    readonly labels?: Readonly<Record<string, number>>;
+}
+export interface ComponentIntrospectionDescriptor {
+    readonly name: string;
+    readonly schema: Readonly<Record<string, string>>;
+    readonly fields: Readonly<Record<string, ComponentIntrospectionField>>;
+    readonly meta: Readonly<Record<string, JsonValue>>;
+}
+/** Project one World-local component catalog into transport-safe data. */
+export declare function projectComponentIntrospection(components: ReadonlyMap<string, Component>): readonly ComponentIntrospectionDescriptor[];
+//# sourceMappingURL=component-introspection.d.ts.map

package/dist/internal/component-introspection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-introspection.d.ts","sourceRoot":"","sources":["../../src/internal/component-introspection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAA6C,MAAM,qBAAqB,CAAC;AAGhG,MAAM,MAAM,SAAS,GACjB,IAAI,GACJ,OAAO,GACP,MAAM,GACN,MAAM,GACN,SAAS,SAAS,EAAE,GACpB;IAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC;AAE1C,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,CAAC;IAC7B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,SAAS,CAAC,EAAE;QACnB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;QAC7B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;KAC1B,CAAC;IACF,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACpD;AAED,MAAM,WAAW,gCAAgC;IAC/C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAClD,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,2BAA2B,CAAC,CAAC,CAAC;IACvE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC;CACpD;AA8ED,0EAA0E;AAC1E,wBAAgB,6BAA6B,CAC3C,UAAU,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,CAAC,GACzC,SAAS,gCAAgC,EAAE,CAM7C"}

package/dist/internal/debug-draw.d.ts

@@ -0,0 +1,9 @@
+import type { DebugDraw } from '@forgeax/engine-debug-draw';
+import type { RendererHostAssembly } from '@forgeax/engine-render/internal/construct-renderer';
+import type { TextureFormat } from '@forgeax/engine-rhi';
+export type RendererDebugDrawHost = Pick<RendererHostAssembly['debugDrawHost'], 'initialization' | 'device' | '_internal_createShaderModule' | '_internal_setRenderOverlay'>;
+/** Create the App-owned debug overlay after the renderer has initialized. */
+export declare function createDebugDrawOnReady(context: RendererDebugDrawHost, format?: TextureFormat): Promise<DebugDraw>;
+/** Release the App-owned debug overlay and clear its Render capability. */
+export declare function releaseDebugDraw(context: RendererDebugDrawHost, debugDraw: DebugDraw): void;
+//# sourceMappingURL=debug-draw.d.ts.map

package/dist/internal/debug-draw.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug-draw.d.ts","sourceRoot":"","sources":["../../src/internal/debug-draw.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAE5D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oDAAoD,CAAC;AAC/F,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGzD,MAAM,MAAM,qBAAqB,GAAG,IAAI,CACtC,oBAAoB,CAAC,eAAe,CAAC,EACrC,gBAAgB,GAAG,QAAQ,GAAG,8BAA8B,GAAG,4BAA4B,CAC5F,CAAC;AAEF,6EAA6E;AAC7E,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,qBAAqB,EAC9B,MAAM,CAAC,EAAE,aAAa,GACrB,OAAO,CAAC,SAAS,CAAC,CAgBpB;AAED,2EAA2E;AAC3E,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,qBAAqB,EAAE,SAAS,EAAE,SAAS,GAAG,IAAI,CAG3F"}

package/dist/internal/ecs-import.d.ts

@@ -0,0 +1,6 @@
+export declare const ECS_PUBLIC_SYMBOLS: readonly ["World", "Entity", "Update", "FixedUpdate", "Time", "FixedTime"];
+export type EcsPublicSymbol = (typeof ECS_PUBLIC_SYMBOLS)[number];
+export type EcsPublicModule = Readonly<Partial<Record<EcsPublicSymbol, unknown>>>;
+export declare function projectEcsPublicModule(value: unknown): EcsPublicModule;
+export declare function createEcsImportModule(importModule: (specifier: string) => Promise<unknown>): (specifier: string) => Promise<unknown>;
+//# sourceMappingURL=ecs-import.d.ts.map

package/dist/internal/ecs-import.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ecs-import.d.ts","sourceRoot":"","sources":["../../src/internal/ecs-import.ts"],"names":[],"mappings":"AAQA,eAAO,MAAM,kBAAkB,4EAOpB,CAAC;AAEZ,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC;AAClE,MAAM,MAAM,eAAe,GAAG,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;AAMlF,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,CAOtE;AAED,wBAAgB,qBAAqB,CACnC,YAAY,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,GACpD,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAKzC"}

package/dist/internal/engine-profile-common.d.ts

@@ -0,0 +1,9 @@
+import type { AssetRegistry } from '@forgeax/engine-assets-runtime';
+import type { Plugin } from '@forgeax/engine-plugin';
+import type { Renderer } from '@forgeax/engine-render';
+export interface EngineProfileBase {
+    readonly renderer: Renderer;
+    readonly assets?: AssetRegistry;
+    readonly extensions?: readonly Plugin[];
+}
+//# sourceMappingURL=engine-profile-common.d.ts.map

package/dist/internal/engine-profile-common.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine-profile-common.d.ts","sourceRoot":"","sources":["../../src/internal/engine-profile-common.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AACpE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAEvD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,aAAa,CAAC;IAChC,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACzC"}

package/dist/internal/error-fanout.d.ts

@@ -0,0 +1,66 @@
+import type { AppDispatchError } from '../types';
+/**
+ * Listener callback for app-shell error fan-out.
+ *
+ * The narrow union (`AppDispatchError` = AppError | RhiError | RuntimeError)
+ * deliberately excludes raw `Error` (charter P3 explicit failure: AI users
+ * walk `.code` not message strings). `RuntimeError` is included so a
+ * runtime-layer error fanned out by `Renderer.onError` (e.g.
+ * `'equirect-projection-failed'`) reaches host App listeners verbatim
+ * (feat-20260531-skybox-env-background F-1). `EngineEnvironmentError` does not
+ * appear here because construction-time failure flows through
+ * `Promise<Result<App, ...>>` of `createApp(canvas)` before the App handle
+ * exists; once an App handle is alive, only frame-time errors (this union)
+ * reach onError.
+ */
+export type ErrorFanoutListener = (err: AppDispatchError) => void;
+/**
+ * Constructor options for ErrorFanoutRegistry. Mirrors the
+ * `silenceUnhandledErrors` field on CreateAppOptions / AppAssembleArgs;
+ * createApp threads the field down into the registry verbatim.
+ */
+export interface ErrorFanoutOptions {
+    readonly silenceUnhandledErrors?: boolean;
+}
+/**
+ * ErrorFanoutRegistry shares its shape with the LostListenerRegistry
+ * implementation in `packages/runtime/src/createRenderer.ts:532-566` per
+ * plan-strategy D-9 -- listener set + fan-out fire + idempotent unsubscribe.
+ * The two divergences from the runtime registry are intentional:
+ *
+ *   1. Late-attach replay is NOT implemented -- rAF errors are a frame-time
+ *      stream (each tick produces fresh state) so replay semantics are
+ *      meaningless and would mislead newly registered listeners.
+ *   2. `console.error(err)` fallback fires when the listener set is empty
+ *      and `silenceUnhandledErrors !== true` -- a charter P3 tribute that
+ *      makes "unhandled" errors loud rather than silent.
+ */
+export declare class ErrorFanoutRegistry {
+    private readonly listeners;
+    private readonly silenceUnhandledErrors;
+    constructor(opts?: ErrorFanoutOptions);
+    /**
+     * Register a listener. Returns an unsubscribe function. Calling
+     * unsubscribe more than once is a safe no-op (Set.delete returns
+     * false on the second call but does not throw). Re-registering the
+     * same listener function is a no-op (Set semantics).
+     */
+    add(cb: ErrorFanoutListener): () => void;
+    /**
+     * Iterate over a snapshot of the listener set so a listener that
+     * mutates the set mid-fire does not perturb the iteration. When the
+     * set is empty AND silenceUnhandledErrors !== true, call
+     * console.error(err) so the unhandled error is visible in devtools
+     * (charter P3 explicit failure: silent drop is a footgun).
+     */
+    fire(err: AppDispatchError): void;
+    /**
+     * Number of currently registered listeners. Reserved for diagnostics +
+     * test fixtures (e.g. asserting cleanup paths reach the registry); not
+     * part of the public app-shell surface.
+     *
+     * @internal
+     */
+    _size(): number;
+}
+//# sourceMappingURL=error-fanout.d.ts.map

package/dist/internal/error-fanout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-fanout.d.ts","sourceRoot":"","sources":["../../src/internal/error-fanout.ts"],"names":[],"mappings":"AAoCA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAEjD;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,GAAG,EAAE,gBAAgB,KAAK,IAAI,CAAC;AAElE;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,sBAAsB,CAAC,EAAE,OAAO,CAAC;CAC3C;AAED;;;;;;;;;;;;GAYG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAuC;IACjE,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAAU;gBAErC,IAAI,GAAE,kBAAuB;IAIzC;;;;;OAKG;IACH,GAAG,CAAC,EAAE,EAAE,mBAAmB,GAAG,MAAM,IAAI;IAOxC;;;;;;OAMG;IACH,IAAI,CAAC,GAAG,EAAE,gBAAgB,GAAG,IAAI;IAcjC;;;;;;OAMG;IACH,KAAK,IAAI,MAAM;CAGhB"}

package/dist/internal/frame-loop.d.ts

@@ -0,0 +1,38 @@
+import type { World } from '@forgeax/engine-ecs';
+import type { Profiler } from '@forgeax/engine-profiler';
+import type { RenderError, Renderer } from '@forgeax/engine-render';
+import { type Result } from '@forgeax/engine-types';
+import { AppError } from '../errors';
+export type FrameState = 'idle' | 'running' | 'paused' | 'stopped';
+export interface FrameLoopOptions {
+    readonly world: World;
+    readonly renderer: Renderer;
+    readonly onError?: (e: AppError | RenderError) => void;
+    /** Optional dev-only RHI recorder hook; called once after each frame draw. */
+    readonly debugRhi?: {
+        onFrameEnd(): void;
+    };
+    readonly now?: () => number;
+    readonly raf?: (cb: (t: number) => void) => number;
+    readonly caf?: (id: number) => void;
+    readonly profiler?: Profiler;
+    readonly drawSource?: () => {
+        worlds: readonly World[];
+        cameraOwner: number;
+        resourceOwner: number;
+    } | undefined;
+}
+export interface FrameLoopHandle {
+    start(): Result<void, AppError>;
+    stop(): Result<void, AppError>;
+    pause(): Result<void, AppError>;
+    resume(): Result<void, AppError>;
+    /** Run one complete update/draw frame through this loop while paused. */
+    stepFrame(deltaSeconds: number): Result<void, AppError | RenderError>;
+    /** Replace the per-frame world routing pull without replacing the loop. */
+    setDrawSource(drawSource: FrameLoopOptions['drawSource']): void;
+    getState(): FrameState;
+    setStopped(): void;
+}
+export declare function createFrameLoop(opts: FrameLoopOptions): FrameLoopHandle;
+//# sourceMappingURL=frame-loop.d.ts.map

package/dist/internal/frame-loop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frame-loop.d.ts","sourceRoot":"","sources":["../../src/internal/frame-loop.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,KAAK,EAAqB,QAAQ,EAAmB,MAAM,0BAA0B,CAAC;AAC7F,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAoB,MAAM,wBAAwB,CAAC;AACtF,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAG7D,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAGrC,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEnE,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,EAAE,QAAQ,GAAG,WAAW,KAAK,IAAI,CAAC;IACvD,8EAA8E;IAC9E,QAAQ,CAAC,QAAQ,CAAC,EAAE;QAAE,UAAU,IAAI,IAAI,CAAA;KAAE,CAAC;IAC3C,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IAC5B,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,KAAK,MAAM,CAAC;IACnD,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC;IAC7B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAClB;QAAE,MAAM,EAAE,SAAS,KAAK,EAAE,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE,GACxE,SAAS,CAAC;CACf;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,IAAI,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAChC,IAAI,IAAI,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAC/B,KAAK,IAAI,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAChC,MAAM,IAAI,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IACjC,yEAAyE;IACzE,SAAS,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAAC,IAAI,EAAE,QAAQ,GAAG,WAAW,CAAC,CAAC;IACtE,2EAA2E;IAC3E,aAAa,CAAC,UAAU,EAAE,gBAAgB,CAAC,YAAY,CAAC,GAAG,IAAI,CAAC;IAChE,QAAQ,IAAI,UAAU,CAAC;IACvB,UAAU,IAAI,IAAI,CAAC;CACpB;AA+HD,wBAAgB,eAAe,CAAC,IAAI,EAAE,gBAAgB,GAAG,eAAe,CAsXvE"}

package/dist/internal/input-attach.d.ts

@@ -0,0 +1,44 @@
+import { type InputBackend, type PointerLockProvider, type VirtualJoystickConfig } from '@forgeax/engine-input';
+import { AppError } from '../errors';
+/**
+ * Handle returned by attachInputAuto. Captures the backend (exposed via
+ * App.input), the detach callable, and a cleanup() funnel that the
+ * frame-loop / app-stop / device-lost paths share (R-4).
+ */
+export interface InputAttachHandle {
+    readonly backend: InputBackend;
+    cleanup(): void;
+    /**
+     * M2: install the error dispatch callback for onLockError events.
+     * Must be called by createApp after the ErrorFanoutRegistry is created
+     * (the dispatch function is created after attachInputAuto returns).
+     * Idempotent — subsequent calls replace the previous callback.
+     */
+    setOnErrorDispatch(fn: (err: AppError) => void): void;
+}
+/**
+ * Acquire a browser input backend. This Host helper owns only DOM listeners;
+ * the Cordis input plugin owns every World resource and system contribution.
+ */
+/**
+ * Options forwarded to attachBrowserInputBackend at attach time. Currently only
+ * the neutral PointerLock gate (host decides whether a canvas click captures the
+ * cursor); the backend stays host-opaque. Optional so existing call sites are
+ * unchanged.
+ */
+export interface InputAttachOptions {
+    /** Host-owned UI root used to route Shadow DOM events away from gameplay. */
+    readonly uiRoot?: Node;
+    readonly pointerLockAllowed?: () => boolean;
+    /** M3: virtual joystick configurations passed through to browser backend. */
+    readonly virtualJoysticks?: readonly VirtualJoystickConfig[];
+    /**
+     * M2: pointer-lock provider injected by the host (e.g. editor play-runtime).
+     * Forwarded to BrowserInputBackendOptions.lockProvider. When absent, the
+     * backend falls back to the W3C requestPointerLock() path.
+     * Type SSOT is @forgeax/engine-input's PointerLockProvider.
+     */
+    readonly lockProvider?: PointerLockProvider;
+}
+export declare function attachInputAuto(canvas: HTMLCanvasElement, options?: InputAttachOptions): InputAttachHandle;
+//# sourceMappingURL=input-attach.d.ts.map

package/dist/internal/input-attach.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"input-attach.d.ts","sourceRoot":"","sources":["../../src/internal/input-attach.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,YAAY,EACjB,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,EAC3B,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAiC,QAAQ,EAAE,MAAM,WAAW,CAAC;AAEpE;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;IAC/B,OAAO,IAAI,IAAI,CAAC;IAChB;;;;;OAKG;IACH,kBAAkB,CAAC,EAAE,EAAE,CAAC,GAAG,EAAE,QAAQ,KAAK,IAAI,GAAG,IAAI,CAAC;CACvD;AAED;;;GAGG;AACH;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC,6EAA6E;IAC7E,QAAQ,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC;IACvB,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,OAAO,CAAC;IAC5C,6EAA6E;IAC7E,QAAQ,CAAC,gBAAgB,CAAC,EAAE,SAAS,qBAAqB,EAAE,CAAC;IAC7D;;;;;OAKG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,mBAAmB,CAAC;CAC7C;AAED,wBAAgB,eAAe,CAC7B,MAAM,EAAE,iBAAiB,EACzB,OAAO,GAAE,kBAAuB,GAC/B,iBAAiB,CAgDnB"}

package/dist/internal/main-engine-profile.d.ts

@@ -0,0 +1,19 @@
+import { type AnimationPayloadLookup } from '@forgeax/engine-animation';
+import type { DebugDraw } from '@forgeax/engine-debug-draw';
+import { type ActionConfig, type InputBackend } from '@forgeax/engine-input';
+import type { Plugin } from '@forgeax/engine-plugin';
+import { type RenderFeatureHost } from '../renderer-plugin';
+import { type RendererDebugDrawHost } from './debug-draw';
+import type { EngineProfileBase } from './engine-profile-common';
+export interface MainEngineProfileOptions extends EngineProfileBase {
+    readonly rendererDebugDrawHost?: RendererDebugDrawHost;
+    readonly rendererFeatureHost?: RenderFeatureHost;
+    readonly animationPayloads: AnimationPayloadLookup;
+    readonly onDebugDrawReady?: (debugDraw: DebugDraw) => void;
+    readonly input?: InputBackend;
+    readonly inputDispose?: () => void;
+    readonly inputMap?: readonly ActionConfig[];
+}
+/** Static browser-main selection; dependency order remains owned by inject/provide. */
+export declare function mainEngineProfile(options: MainEngineProfileOptions): Plugin[];
+//# sourceMappingURL=main-engine-profile.d.ts.map

package/dist/internal/main-engine-profile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"main-engine-profile.d.ts","sourceRoot":"","sources":["../../src/internal/main-engine-profile.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,sBAAsB,EAG5B,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,YAAY,EAGlB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAMrD,OAAO,EAEL,KAAK,iBAAiB,EAEvB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAA0B,KAAK,qBAAqB,EAAoB,MAAM,cAAc,CAAC;AACpG,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAEjE,MAAM,WAAW,wBAAyB,SAAQ,iBAAiB;IACjE,QAAQ,CAAC,qBAAqB,CAAC,EAAE,qBAAqB,CAAC;IACvD,QAAQ,CAAC,mBAAmB,CAAC,EAAE,iBAAiB,CAAC;IACjD,QAAQ,CAAC,iBAAiB,EAAE,sBAAsB,CAAC;IACnD,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC,SAAS,EAAE,SAAS,KAAK,IAAI,CAAC;IAC3D,QAAQ,CAAC,KAAK,CAAC,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;IACnC,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,YAAY,EAAE,CAAC;CAC7C;AAoBD,uFAAuF;AACvF,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,wBAAwB,GAAG,MAAM,EAAE,CA2B7E"}

package/dist/internal/remote-serve-flag.d.ts

@@ -0,0 +1,19 @@
+/** Minimal structural view of an env bag carrying the serve flag. */
+interface RemoteServeEnv {
+    readonly FORGEAX_ENGINE_REMOTE_SERVE?: string | undefined;
+}
+/**
+ * Resolve whether the remote eval server should be started.
+ *
+ * Returns `true` when:
+ *   - vite dev mode (import.meta.env.DEV === true), OR
+ *   - headless/dawn-node with FORGEAX_ENGINE_REMOTE_SERVE=1 opt-in
+ *
+ * Returns `false` in production builds and headless without explicit opt-in.
+ *
+ * @param isDev flag from import.meta.env.DEV (undefined when import.meta absent)
+ * @param processEnv globalThis.process?.env when present, else undefined
+ */
+export declare function resolveRemoteServeFlag(isDev: boolean | undefined, processEnv: RemoteServeEnv | undefined): boolean;
+export {};
+//# sourceMappingURL=remote-serve-flag.d.ts.map

package/dist/internal/remote-serve-flag.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-serve-flag.d.ts","sourceRoot":"","sources":["../../src/internal/remote-serve-flag.ts"],"names":[],"mappings":"AAgBA,qEAAqE;AACrE,UAAU,cAAc;IACtB,QAAQ,CAAC,2BAA2B,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3D;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,OAAO,GAAG,SAAS,EAC1B,UAAU,EAAE,cAAc,GAAG,SAAS,GACrC,OAAO,CAIT"}

package/dist/internal/remote-server-plugin.d.ts

@@ -0,0 +1,8 @@
+import type { Plugin } from '@forgeax/engine-plugin';
+export interface RemoteServerHandle {
+    readonly port: number;
+    close(): Promise<void>;
+}
+/** Own a Node remote server with the App Fiber while App still exposes its handle. */
+export declare function remoteServerPlugin(handle: RemoteServerHandle): Plugin;
+//# sourceMappingURL=remote-server-plugin.d.ts.map

package/dist/internal/remote-server-plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-server-plugin.d.ts","sourceRoot":"","sources":["../../src/internal/remote-server-plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAErD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,sFAAsF;AACtF,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM,CAOrE"}

package/dist/internal/rhi-capture.d.ts

@@ -0,0 +1,19 @@
+import type { RhiBackendInstrumentation } from '@forgeax/engine-render/internal/construct-renderer';
+import type { CaptureFrameOptions, RecorderAttachment, RhiDebugError } from '@forgeax/engine-rhi-debug';
+import { type Result } from '@forgeax/engine-types';
+import type { FrameLoopHandle } from './frame-loop';
+export interface RhiTapeArtifactRef {
+    readonly kind: 'rhi-tape';
+    readonly digest: string;
+    readonly bytes: Uint8Array;
+}
+export interface RhiCapture {
+    captureFrame(options?: CaptureFrameOptions): Promise<Result<RhiTapeArtifactRef, RhiDebugError>>;
+}
+type CaptureFrameDriver = Pick<FrameLoopHandle, 'getState' | 'pause' | 'resume' | 'stepFrame'>;
+export declare function createRhiCapture(attachment: RecorderAttachment): RhiCapture;
+/** Bind the App-owned frame authority to its host capture capability. */
+export declare function bindRhiCaptureFrameDriver(capture: RhiCapture, driver: CaptureFrameDriver): void;
+export declare function createRhiInstrumentation(attachment: RecorderAttachment): RhiBackendInstrumentation;
+export {};
+//# sourceMappingURL=rhi-capture.d.ts.map

package/dist/internal/rhi-capture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rhi-capture.d.ts","sourceRoot":"","sources":["../../src/internal/rhi-capture.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,oDAAoD,CAAC;AAEpG,OAAO,KAAK,EACV,mBAAmB,EAEnB,kBAAkB,EAClB,aAAa,EACd,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEpD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;CAC5B;AAED,MAAM,WAAW,UAAU;IACzB,YAAY,CAAC,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC,kBAAkB,EAAE,aAAa,CAAC,CAAC,CAAC;CACjG;AAGD,KAAK,kBAAkB,GAAG,IAAI,CAAC,eAAe,EAAE,UAAU,GAAG,OAAO,GAAG,QAAQ,GAAG,WAAW,CAAC,CAAC;AAI/F,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,kBAAkB,GAAG,UAAU,CA8B3E;AAED,yEAAyE;AACzE,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,kBAAkB,GAAG,IAAI,CAE/F;AAsHD,wBAAgB,wBAAwB,CACtC,UAAU,EAAE,kBAAkB,GAC7B,yBAAyB,CAoB3B"}

package/dist/internal/rhi-debug-flag.d.ts

@@ -0,0 +1,18 @@
+/** Minimal structural view of an env bag carrying the flag. */
+interface RhiDebugEnv {
+    readonly FORGEAX_ENGINE_RHI_DEBUG?: string | undefined;
+}
+/**
+ * Resolve the raw FORGEAX_ENGINE_RHI_DEBUG flag from the two sources.
+ *
+ * Precedence: `import.meta.env` wins; `globalThis.process.env` is the fallback.
+ * Returns the raw string (or undefined); the caller compares `=== '1'`.
+ *
+ * @param importMetaEnv `import.meta.env` when `import.meta` is defined,
+ *   else `undefined` (models the `typeof import.meta !== 'undefined'` prefix
+ *   short-circuiting to a falsy first operand).
+ * @param processEnv `globalThis.process?.env` when present, else `undefined`.
+ */
+export declare function resolveRhiDebugFlag(importMetaEnv: RhiDebugEnv | undefined, processEnv: RhiDebugEnv | undefined): string | undefined;
+export {};
+//# sourceMappingURL=rhi-debug-flag.d.ts.map

package/dist/internal/rhi-debug-flag.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rhi-debug-flag.d.ts","sourceRoot":"","sources":["../../src/internal/rhi-debug-flag.ts"],"names":[],"mappings":"AAkBA,+DAA+D;AAC/D,UAAU,WAAW;IACnB,QAAQ,CAAC,wBAAwB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACxD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CACjC,aAAa,EAAE,WAAW,GAAG,SAAS,EACtC,UAAU,EAAE,WAAW,GAAG,SAAS,GAClC,MAAM,GAAG,SAAS,CAEpB"}

package/dist/internal/worker-engine-profile.d.ts

@@ -0,0 +1,15 @@
+import { type AnimationPayloadLookup } from '@forgeax/engine-animation';
+import { type AudioBackend } from '@forgeax/engine-audio';
+import { type InputBackend } from '@forgeax/engine-input';
+import type { Plugin } from '@forgeax/engine-plugin';
+import { type RenderFeatureHost } from '../renderer-plugin';
+import type { EngineProfileBase } from './engine-profile-common';
+export interface WorkerEngineProfileOptions extends EngineProfileBase {
+    readonly animationPayloads: AnimationPayloadLookup;
+    readonly input: InputBackend;
+    readonly audio: AudioBackend;
+    readonly rendererFeatureHost?: RenderFeatureHost;
+}
+/** Static Engine Worker selection; Host-only acquisition stays outside this realm. */
+export declare function workerEngineProfile(options: WorkerEngineProfileOptions): Plugin[];
+//# sourceMappingURL=worker-engine-profile.d.ts.map

package/dist/internal/worker-engine-profile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-engine-profile.d.ts","sourceRoot":"","sources":["../../src/internal/worker-engine-profile.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,sBAAsB,EAG5B,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,KAAK,YAAY,EAAsB,MAAM,uBAAuB,CAAC;AAC9E,OAAO,EAAE,KAAK,YAAY,EAAsB,MAAM,uBAAuB,CAAC;AAC9E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAKrD,OAAO,EAEL,KAAK,iBAAiB,EAEvB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAEjE,MAAM,WAAW,0BAA2B,SAAQ,iBAAiB;IACnE,QAAQ,CAAC,iBAAiB,EAAE,sBAAsB,CAAC;IACnD,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,mBAAmB,CAAC,EAAE,iBAAiB,CAAC;CAClD;AAED,sFAAsF;AACtF,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,0BAA0B,GAAG,MAAM,EAAE,CAkBjF"}

package/dist/kernel-worker-runtime.mjs

@@ -0,0 +1,69 @@
+// src/execution/kernel-worker-runtime.ts
+var scope = globalThis;
+var loadedKernels = /* @__PURE__ */ new Map();
+async function loadKernel(moduleUrl) {
+  const module = await import(
+    /* @vite-ignore */
+    moduleUrl
+  );
+  const candidate = module.default ?? module;
+  if (typeof candidate.run !== "function") {
+    throw new TypeError("SharedKernel module default export has no run function.");
+  }
+  return candidate;
+}
+function spanFromBinding(binding) {
+  return {
+    entities: binding.entities,
+    length: binding.length,
+    get(component) {
+      const fields = binding.read[component.name];
+      if (fields === void 0)
+        throw new Error(`Kernel read access is not declared for ${component.name}.`);
+      return fields;
+    },
+    mut(component) {
+      const fields = binding.write[component.name];
+      if (fields === void 0)
+        throw new Error(`Kernel write access is not declared for ${component.name}.`);
+      return fields;
+    }
+  };
+}
+scope.onmessage = (event) => {
+  const job = event.data;
+  if (job.kind === "kernel-init") {
+    Atomics.add(job.ready, 0, 1);
+    Atomics.notify(job.ready, 0);
+    return;
+  }
+  if (job.kind === "kernel-preload") {
+    void loadKernel(job.moduleUrl).then((kernel) => {
+      loadedKernels.set(job.moduleUrl, kernel);
+      Atomics.store(job.status, job.jobIndex, 1);
+    }).catch(() => {
+      Atomics.store(job.status, job.jobIndex, -1);
+    }).finally(() => {
+      Atomics.add(job.control, 0, 1);
+      Atomics.notify(job.control, 0);
+    });
+    return;
+  }
+  if (job.kind !== "kernel-job") return;
+  try {
+    const kernel = loadedKernels.get(job.moduleUrl);
+    if (kernel === void 0) {
+      throw new Error(`SharedKernel module was not preloaded: ${job.moduleUrl}`);
+    }
+    const returned = kernel.run([spanFromBinding(job.binding)]);
+    if (returned instanceof Promise) throw new TypeError("SharedKernel run must be synchronous.");
+    Atomics.store(job.status, job.jobIndex, 1);
+  } catch {
+    Atomics.store(job.status, job.jobIndex, -1);
+  } finally {
+    Atomics.add(job.control, 0, 1);
+    Atomics.notify(job.control, 0);
+  }
+};
+//# sourceMappingURL=kernel-worker-runtime.mjs.map
+//# sourceMappingURL=kernel-worker-runtime.mjs.map

package/dist/kernel-worker-runtime.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/execution/kernel-worker-runtime.ts"],"names":[],"mappings":"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","file":"kernel-worker-runtime.mjs","sourcesContent":["import type { QuerySpan } from '@forgeax/engine-ecs';\nimport type { SharedSpanBinding } from '@forgeax/engine-ecs/shared';\n\ninterface KernelJobMessage {\n  readonly kind: 'kernel-job';\n  readonly moduleUrl: string;\n  readonly binding: SharedSpanBinding;\n  readonly control: Int32Array;\n  readonly status: Int32Array;\n  readonly jobIndex: number;\n}\n\ninterface KernelInitMessage {\n  readonly kind: 'kernel-init';\n  readonly ready: Int32Array;\n}\n\ninterface KernelPreloadMessage {\n  readonly kind: 'kernel-preload';\n  readonly moduleUrl: string;\n  readonly control: Int32Array;\n  readonly status: Int32Array;\n  readonly jobIndex: number;\n}\n\ninterface LoadedKernel {\n  readonly run: (spans: readonly QuerySpan[]) => unknown;\n}\n\nconst scope = globalThis as unknown as {\n  onmessage:\n    | ((event: MessageEvent<KernelJobMessage | KernelInitMessage | KernelPreloadMessage>) => void)\n    | null;\n};\n\nconst loadedKernels = new Map<string, LoadedKernel>();\n\nasync function loadKernel(moduleUrl: string): Promise<LoadedKernel> {\n  const module = await import(/* @vite-ignore */ moduleUrl);\n  const candidate = (module.default ?? module) as { run?: unknown };\n  if (typeof candidate.run !== 'function') {\n    throw new TypeError('SharedKernel module default export has no run function.');\n  }\n  return candidate as LoadedKernel;\n}\n\nfunction spanFromBinding(binding: SharedSpanBinding): QuerySpan {\n  return {\n    entities: binding.entities,\n    length: binding.length,\n    get(component) {\n      const fields = binding.read[component.name];\n      if (fields === undefined)\n        throw new Error(`Kernel read access is not declared for ${component.name}.`);\n      return fields as never;\n    },\n    mut(component) {\n      const fields = binding.write[component.name];\n      if (fields === undefined)\n        throw new Error(`Kernel write access is not declared for ${component.name}.`);\n      return fields as never;\n    },\n  };\n}\n\nscope.onmessage = (event): void => {\n  const job = event.data;\n  if (job.kind === 'kernel-init') {\n    Atomics.add(job.ready, 0, 1);\n    Atomics.notify(job.ready, 0);\n    return;\n  }\n  if (job.kind === 'kernel-preload') {\n    void loadKernel(job.moduleUrl)\n      .then((kernel) => {\n        loadedKernels.set(job.moduleUrl, kernel);\n        Atomics.store(job.status, job.jobIndex, 1);\n      })\n      .catch(() => {\n        Atomics.store(job.status, job.jobIndex, -1);\n      })\n      .finally(() => {\n        Atomics.add(job.control, 0, 1);\n        Atomics.notify(job.control, 0);\n      });\n    return;\n  }\n  if (job.kind !== 'kernel-job') return;\n  try {\n    const kernel = loadedKernels.get(job.moduleUrl);\n    if (kernel === undefined) {\n      throw new Error(`SharedKernel module was not preloaded: ${job.moduleUrl}`);\n    }\n    const returned = kernel.run([spanFromBinding(job.binding)]);\n    if (returned instanceof Promise) throw new TypeError('SharedKernel run must be synchronous.');\n    Atomics.store(job.status, job.jobIndex, 1);\n  } catch {\n    Atomics.store(job.status, job.jobIndex, -1);\n  } finally {\n    Atomics.add(job.control, 0, 1);\n    Atomics.notify(job.control, 0);\n  }\n};\n"]}