@forgeax/engine-app 0.1.2

package/dist/execution/host-controller.d.ts

@@ -0,0 +1,16 @@
+import { type Result } from '@forgeax/engine-types';
+import { type AppError as AppErrorType } from '../errors';
+import type { BundlerOptions, CanvasDrawingBufferSize } from '../types';
+import { type CreateAppOptions, type ExecutionApp } from '../types';
+import type { ExecutionCapabilities, ExecutionSelection } from './types';
+export interface CreateWorkerExecutionAppOptions {
+    readonly canvas: HTMLCanvasElement;
+    readonly appOptions: CreateAppOptions;
+    /** Host-owned resize policy applied before each frame sent to the worker. */
+    readonly syncCanvas?: () => CanvasDrawingBufferSize;
+    readonly bundler?: BundlerOptions;
+    readonly capabilities: ExecutionCapabilities;
+    readonly selection: ExecutionSelection;
+}
+export declare function createWorkerExecutionApp(options: CreateWorkerExecutionAppOptions): Promise<Result<ExecutionApp, AppErrorType>>;
+//# sourceMappingURL=host-controller.d.ts.map

package/dist/execution/host-controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-controller.d.ts","sourceRoot":"","sources":["../../src/execution/host-controller.ts"],"names":[],"mappings":"AAEA,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAA2C,KAAK,QAAQ,IAAI,YAAY,EAAE,MAAM,WAAW,CAAC;AAEnG,OAAO,KAAK,EAAE,cAAc,EAAE,uBAAuB,EAAE,MAAM,UAAU,CAAC;AACxE,OAAO,EAGL,KAAK,gBAAgB,EACrB,KAAK,YAAY,EAClB,MAAM,UAAU,CAAC;AAUlB,OAAO,KAAK,EACV,qBAAqB,EAGrB,kBAAkB,EACnB,MAAM,SAAS,CAAC;AAEjB,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;IACnC,QAAQ,CAAC,UAAU,EAAE,gBAAgB,CAAC;IACtC,6EAA6E;IAC7E,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,uBAAuB,CAAC;IACpD,QAAQ,CAAC,OAAO,CAAC,EAAE,cAAc,CAAC;IAClC,QAAQ,CAAC,YAAY,EAAE,qBAAqB,CAAC;IAC7C,QAAQ,CAAC,SAAS,EAAE,kBAAkB,CAAC;CACxC;AAkCD,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,+BAA+B,GACvC,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,YAAY,CAAC,CAAC,CA6X7C"}

package/dist/execution/index.d.ts

@@ -0,0 +1,10 @@
+export type { ExecutionBootstrapEntry, ExecutionBootstrapHost, PreparedExecutionBootstrap, } from './bootstrap-entry';
+export { executionBootstrapHostPlugin, loadBootstrapEntry, prepareBootstrapEntry, validateExecutionBootstrapData, } from './bootstrap-entry';
+export { missingExecutionCapabilities, probeExecutionCapabilities, unavailableExecutionCapabilities, } from './capabilities';
+export { cloneExecutionReport } from './control';
+export { createExecutionReport } from './report';
+export { EXECUTION_REPORT_SCHEMA_VERSION, isExecutionReport } from './schema';
+export { type ExecutionSelectionInput, selectExecutionTier } from './selector';
+export type { ExecutionBootstrapValue, ExecutionCapabilities, ExecutionCapabilityFact, ExecutionCapabilityName, ExecutionControl, ExecutionEngineHealth, ExecutionFault, ExecutionMeasurement, ExecutionOptions, ExecutionReport, ExecutionRequestedTier, ExecutionSelection, ExecutionSelectionReason, ExecutionTier, ExecutionWorldHealth, KernelDispatchReason, } from './types';
+export { EXECUTION_CAPABILITY_NAMES, EXECUTION_REQUESTED_TIERS, EXECUTION_TIERS, } from './types';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/execution/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,uBAAuB,EACvB,sBAAsB,EACtB,0BAA0B,GAC3B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,4BAA4B,EAC5B,kBAAkB,EAClB,qBAAqB,EACrB,8BAA8B,GAC/B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,4BAA4B,EAC5B,0BAA0B,EAC1B,gCAAgC,GACjC,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AACjD,OAAO,EAAE,+BAA+B,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAC9E,OAAO,EAAE,KAAK,uBAAuB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAC/E,YAAY,EACV,uBAAuB,EACvB,qBAAqB,EACrB,uBAAuB,EACvB,uBAAuB,EACvB,gBAAgB,EAChB,qBAAqB,EACrB,cAAc,EACd,oBAAoB,EACpB,gBAAgB,EAChB,eAAe,EACf,sBAAsB,EACtB,kBAAkB,EAClB,wBAAwB,EACxB,aAAa,EACb,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,SAAS,CAAC;AACjB,OAAO,EACL,0BAA0B,EAC1B,yBAAyB,EACzB,eAAe,GAChB,MAAM,SAAS,CAAC"}

package/dist/execution/kernel-pool.d.ts

@@ -0,0 +1,14 @@
+import type { KernelDispatchResult, SharedKernelExecutor } from '@forgeax/engine-ecs/shared';
+export interface KernelPool extends SharedKernelExecutor {
+    readonly laneCount: number;
+    ready(): Promise<void>;
+    takeLastDispatch(): KernelDispatchResult | null;
+    dispose(): void;
+}
+export interface KernelPoolOptions {
+    readonly lanes?: number;
+    readonly timeoutMs?: number;
+    readonly workerFactory?: () => Worker;
+}
+export declare function createKernelPool(options?: KernelPoolOptions): KernelPool;
+//# sourceMappingURL=kernel-pool.d.ts.map

package/dist/execution/kernel-pool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kernel-pool.d.ts","sourceRoot":"","sources":["../../src/execution/kernel-pool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,oBAAoB,EAGpB,oBAAoB,EAErB,MAAM,4BAA4B,CAAC;AAGpC,MAAM,WAAW,UAAW,SAAQ,oBAAoB;IACtD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,gBAAgB,IAAI,oBAAoB,GAAG,IAAI,CAAC;IAChD,OAAO,IAAI,IAAI,CAAC;CACjB;AA6BD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,MAAM,CAAC;CACvC;AAED,wBAAgB,gBAAgB,CAAC,OAAO,GAAE,iBAAsB,GAAG,UAAU,CAyL5E"}

package/dist/execution/kernel-worker-runtime.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=kernel-worker-runtime.d.ts.map

package/dist/execution/kernel-worker-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kernel-worker-runtime.d.ts","sourceRoot":"","sources":["../../src/execution/kernel-worker-runtime.ts"],"names":[],"mappings":""}

package/dist/execution/measurement.d.ts

@@ -0,0 +1,7 @@
+import type { ExecutionMeasurement } from './types';
+export interface MeasurementSeries {
+    add(value: number): ExecutionMeasurement;
+    clear(): void;
+}
+export declare function createMeasurementSeries(capacity?: number): MeasurementSeries;
+//# sourceMappingURL=measurement.d.ts.map

package/dist/execution/measurement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"measurement.d.ts","sourceRoot":"","sources":["../../src/execution/measurement.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAOpD,MAAM,WAAW,iBAAiB;IAChC,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,oBAAoB,CAAC;IACzC,KAAK,IAAI,IAAI,CAAC;CACf;AAED,wBAAgB,uBAAuB,CAAC,QAAQ,SAAM,GAAG,iBAAiB,CA0BzE"}

package/dist/execution/protocol.d.ts

@@ -0,0 +1,84 @@
+import type { AudioIntent } from '@forgeax/engine-audio';
+import type { InputBackendSample } from '@forgeax/engine-input';
+import type { CanvasDrawingBufferSize } from '../types';
+export interface ExecutionFrameMessage {
+    readonly kind: 'frame';
+    readonly worldIdentity: string;
+    readonly frameId: number;
+    readonly deltaSeconds: number;
+    readonly inputSample: InputBackendSample;
+    readonly canvasWidth: number;
+    readonly canvasHeight: number;
+}
+export interface ExecutionFrameCompletion {
+    readonly kind: 'frame-complete';
+    readonly worldIdentity: string;
+    readonly frameId: number;
+    readonly engineUpdateMs: number;
+    readonly kernelWaitMs: number;
+    readonly audioIntents?: readonly AudioIntent[];
+    readonly kernelDispatch?: {
+        readonly eligible: boolean;
+        readonly usedShared: boolean;
+        readonly reason: import('./types').KernelDispatchReason;
+        readonly dispatched: number;
+        readonly completed: number;
+    };
+}
+export type FrameCompletionDisposition = 'accepted' | 'duplicate' | 'stale-world' | 'late';
+export declare class FrameCreditLedger {
+    readonly worldIdentity: string;
+    private nextFrameId;
+    private inFlight;
+    private completed;
+    constructor(worldIdentity: string);
+    issue(deltaSeconds: number, sampleInput: () => InputBackendSample, canvasSize: CanvasDrawingBufferSize): ExecutionFrameMessage | undefined;
+    complete(message: ExecutionFrameCompletion): FrameCompletionDisposition;
+    get hasCreditInFlight(): boolean;
+}
+export interface ExecutionInitMessage {
+    readonly kind: 'init';
+    readonly canvas: OffscreenCanvas;
+    readonly bootstrapUrl: string;
+    readonly bootstrapData?: import('./types').ExecutionBootstrapValue;
+    readonly bootstrapPort?: MessagePort;
+    readonly shaderManifestUrl?: string;
+    readonly time?: import('@forgeax/engine-ecs').TimePolicy;
+    readonly tier: import('./types').ExecutionTier;
+}
+export interface ExecutionHostControlMessage {
+    readonly kind: 'host-control';
+    readonly command: 'set-pointer-lock-allowed';
+    readonly allowed: boolean;
+}
+export interface ExecutionReadyMessage {
+    readonly kind: 'ready';
+    readonly worldIdentity: string;
+    readonly realm: 'worker';
+    readonly workerWebGpu: boolean;
+}
+export interface ExecutionFaultMessage {
+    readonly kind: 'fault';
+    readonly worldIdentity: string | null;
+    readonly source: 'bootstrap' | 'handshake' | 'runtime' | 'kernel' | 'world' | 'rebuild';
+    readonly code: string;
+    readonly expected: string;
+    readonly hint: string;
+    readonly detail: unknown;
+    readonly partialWrite: boolean;
+    readonly retryable: boolean;
+}
+export interface ExecutionRebuildMessage {
+    readonly kind: 'rebuild';
+    readonly worldIdentity: string;
+}
+export interface ExecutionRebuiltMessage {
+    readonly kind: 'rebuilt';
+    readonly previousWorldIdentity: string;
+    readonly worldIdentity: string;
+}
+export type HostToEngineMessage = ExecutionInitMessage | ExecutionFrameMessage | ExecutionRebuildMessage | {
+    readonly kind: 'dispose';
+};
+export type EngineToHostMessage = ExecutionReadyMessage | ExecutionFrameCompletion | ExecutionFaultMessage | ExecutionRebuiltMessage | ExecutionHostControlMessage;
+//# sourceMappingURL=protocol.d.ts.map

package/dist/execution/protocol.d.ts.map

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

package/dist/execution/report.d.ts

@@ -0,0 +1,5 @@
+import type { AudioState } from '@forgeax/engine-audio';
+import type { ExecutionCapabilities, ExecutionReport, ExecutionRequestedTier, ExecutionSelection } from './types';
+export declare function executionAudioReport(state?: AudioState): ExecutionReport['audio'];
+export declare function createExecutionReport(requestedTier: ExecutionRequestedTier, capabilities: ExecutionCapabilities, selection?: ExecutionSelection): ExecutionReport;
+//# sourceMappingURL=report.d.ts.map

package/dist/execution/report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.d.ts","sourceRoot":"","sources":["../../src/execution/report.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAExD,OAAO,KAAK,EACV,qBAAqB,EACrB,eAAe,EACf,sBAAsB,EACtB,kBAAkB,EACnB,MAAM,SAAS,CAAC;AAEjB,wBAAgB,oBAAoB,CAAC,KAAK,CAAC,EAAE,UAAU,GAAG,eAAe,CAAC,OAAO,CAAC,CAgBjF;AAED,wBAAgB,qBAAqB,CACnC,aAAa,EAAE,sBAAsB,EACrC,YAAY,EAAE,qBAAqB,EACnC,SAAS,CAAC,EAAE,kBAAkB,GAC7B,eAAe,CAkCjB"}

package/dist/execution/schema.d.ts

@@ -0,0 +1,4 @@
+import { type ExecutionReport } from './types';
+export declare const EXECUTION_REPORT_SCHEMA_VERSION: 1;
+export declare function isExecutionReport(value: unknown): value is ExecutionReport;
+//# sourceMappingURL=schema.d.ts.map

package/dist/execution/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/execution/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,eAAe,EACrB,MAAM,SAAS,CAAC;AAEjB,eAAO,MAAM,+BAA+B,EAAG,CAAU,CAAC;AAwB1D,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,eAAe,CAwI1E"}

package/dist/execution/selector.d.ts

@@ -0,0 +1,10 @@
+import { type Result } from '@forgeax/engine-types';
+import { type AppError as AppErrorType } from '../errors';
+import type { ExecutionCapabilities, ExecutionRequestedTier, ExecutionSelection } from './types';
+export interface ExecutionSelectionInput {
+    readonly requestedTier: ExecutionRequestedTier;
+    readonly capabilities: ExecutionCapabilities;
+    readonly sharedEvidencePassed: boolean;
+}
+export declare function selectExecutionTier(input: ExecutionSelectionInput): Result<ExecutionSelection, AppErrorType>;
+//# sourceMappingURL=selector.d.ts.map

package/dist/execution/selector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selector.d.ts","sourceRoot":"","sources":["../../src/execution/selector.ts"],"names":[],"mappings":"AAAA,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAA2C,KAAK,QAAQ,IAAI,YAAY,EAAE,MAAM,WAAW,CAAC;AAEnG,OAAO,KAAK,EACV,qBAAqB,EAErB,sBAAsB,EACtB,kBAAkB,EAEnB,MAAM,SAAS,CAAC;AAcjB,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,aAAa,EAAE,sBAAsB,CAAC;IAC/C,QAAQ,CAAC,YAAY,EAAE,qBAAqB,CAAC;IAC7C,QAAQ,CAAC,oBAAoB,EAAE,OAAO,CAAC;CACxC;AAeD,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,uBAAuB,GAC7B,MAAM,CAAC,kBAAkB,EAAE,YAAY,CAAC,CAqD1C"}

package/dist/execution/types.d.ts

@@ -0,0 +1,107 @@
+import type { WorldExecutionHealth } from '@forgeax/engine-ecs/shared';
+import type { Result } from '@forgeax/engine-types';
+import type { AppError } from '../errors';
+export declare const EXECUTION_TIERS: readonly ["main-serial", "engine-worker", "shared"];
+export type ExecutionTier = (typeof EXECUTION_TIERS)[number];
+export declare const EXECUTION_REQUESTED_TIERS: readonly ["auto", "main-serial", "engine-worker", "shared"];
+export type ExecutionRequestedTier = (typeof EXECUTION_REQUESTED_TIERS)[number];
+export declare const EXECUTION_CAPABILITY_NAMES: readonly ["worker", "offscreenCanvas", "workerAnimationFrame", "workerWebGpu", "crossOriginIsolated", "sharedArrayBuffer", "atomicsWait"];
+export type ExecutionCapabilityName = (typeof EXECUTION_CAPABILITY_NAMES)[number];
+export interface ExecutionCapabilityFact {
+    readonly available: boolean;
+    readonly reason: string;
+}
+export type ExecutionCapabilities = Readonly<Record<ExecutionCapabilityName, ExecutionCapabilityFact>>;
+export type ExecutionSelectionReason = 'explicit-request' | 'auto-shared' | 'auto-engine-worker' | 'auto-main-serial';
+export interface ExecutionSelection {
+    readonly requestedTier: ExecutionRequestedTier;
+    readonly actualTier: ExecutionTier;
+    readonly selectionReason: ExecutionSelectionReason;
+    readonly missingCapabilities: readonly ExecutionCapabilityName[];
+    readonly sharedEvidencePassed: boolean;
+}
+export type ExecutionEngineHealth = 'idle' | 'starting' | 'running' | 'stopped' | 'faulted';
+export type ExecutionWorldHealth = WorldExecutionHealth;
+export type KernelDispatchReason = 'no-eligible-kernel' | 'zero-work' | 'small-span' | 'forced-inline' | 'shared' | 'poisoned';
+export interface ExecutionMeasurement {
+    readonly samples: number;
+    readonly p50: number;
+    readonly p95: number;
+    readonly p99: number;
+    readonly jitter: number;
+}
+export interface ExecutionFault {
+    readonly source: 'bootstrap' | 'handshake' | 'runtime' | 'kernel' | 'world' | 'rebuild';
+    readonly code: string;
+    readonly expected: string;
+    readonly hint: string;
+    readonly detail: unknown;
+    readonly partialWrite: boolean;
+    readonly retryable: boolean;
+}
+export interface ExecutionAudioReport {
+    readonly owner: 'host';
+    readonly contextState: 'running' | 'suspended' | 'closed';
+    readonly activeSourceCount: number;
+    readonly lastError: {
+        readonly code: string;
+        readonly expected: string;
+        readonly hint: string;
+        readonly detail: unknown;
+    } | null;
+}
+export interface ExecutionReport {
+    readonly schemaVersion: 1;
+    readonly requestedTier: ExecutionRequestedTier;
+    readonly actualTier: ExecutionTier | null;
+    readonly selectionReason: ExecutionSelectionReason | null;
+    readonly sharedEvidencePassed: boolean;
+    readonly capabilities: ExecutionCapabilities;
+    readonly engine: {
+        readonly realm: 'host' | 'worker';
+        readonly health: ExecutionEngineHealth;
+    };
+    readonly world: {
+        readonly identity: string | null;
+        readonly health: ExecutionWorldHealth;
+        readonly partialWrite: boolean;
+        readonly retryable: boolean;
+    };
+    readonly kernelDispatch: {
+        readonly eligible: boolean;
+        readonly usedShared: boolean;
+        readonly reason: KernelDispatchReason;
+        readonly dispatched: number;
+        readonly completed: number;
+    };
+    readonly performance: {
+        readonly hostFrameMs: ExecutionMeasurement | null;
+        readonly engineUpdateMs: ExecutionMeasurement | null;
+        readonly kernelWaitMs: ExecutionMeasurement | null;
+        readonly hostAudioMs: ExecutionMeasurement | null;
+    };
+    readonly audio: ExecutionAudioReport;
+    readonly fault: ExecutionFault | null;
+}
+export interface ExecutionOptions {
+    readonly tier?: ExecutionRequestedTier;
+    /** Absolute or import.meta.url-relative URL of an ExecutionBootstrapEntry module. */
+    readonly bootstrap: string | URL;
+    /** Structured-cloneable input supplied identically to main and Worker realms. */
+    readonly bootstrapData?: ExecutionBootstrapValue;
+    /**
+     * Realm side of an optional typed host/game channel. The engine transfers it
+     * to a Worker when needed and otherwise preserves the same port contract.
+     */
+    readonly bootstrapPort?: MessagePort;
+    readonly startupTimeoutMs?: number;
+    readonly frameTimeoutMs?: number;
+}
+export type ExecutionBootstrapValue = null | boolean | number | string | readonly ExecutionBootstrapValue[] | {
+    readonly [key: string]: ExecutionBootstrapValue;
+};
+export interface ExecutionControl {
+    report(): ExecutionReport;
+    rebuild(): Promise<Result<ExecutionReport, AppError>>;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/fallback-camera.d.ts

@@ -0,0 +1,8 @@
+import type { World } from '@forgeax/engine-ecs';
+/**
+ * Ensure the neutral camera used only by hosts that have no game bootstrap.
+ * An authored scene camera wins; a resolved game owns its camera policy and
+ * must not call this helper.
+ */
+export declare function ensureFallbackCamera(world: World, aspect?: number): ReturnType<World['spawn']> | undefined;
+//# sourceMappingURL=fallback-camera.d.ts.map

package/dist/fallback-camera.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fallback-camera.d.ts","sourceRoot":"","sources":["../src/fallback-camera.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAIjD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,KAAK,EACZ,MAAM,SAAI,GACT,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,GAAG,SAAS,CAOxC"}

package/dist/game-context.d.ts

@@ -0,0 +1,98 @@
+import type { AssetRegistry } from '@forgeax/engine-assets-runtime';
+import type { EntityHandle } from '@forgeax/engine-ecs';
+import type { Plugin } from '@forgeax/engine-plugin';
+import type { Renderer } from '@forgeax/engine-render';
+import type { SceneAsset } from '@forgeax/engine-types';
+import type { App } from './types';
+/** JSON-shaped data a game may intentionally project through a host bridge. */
+export type GameProjectionValue = null | boolean | number | string | GameProjectionValue[] | {
+    [key: string]: GameProjectionValue;
+};
+/** Lightweight, host-agnostic argument schema for a game-owned action. */
+export interface GameActionArgsSchema {
+    readonly type?: 'string' | 'number' | 'boolean' | 'object' | 'array';
+    readonly properties?: Record<string, GameActionArgsSchema>;
+    readonly required?: string[];
+    readonly enum?: GameProjectionValue[];
+    readonly items?: GameActionArgsSchema;
+    readonly nullable?: boolean;
+    readonly description?: string;
+}
+/**
+ * A Play-only capability owned by game code. The host may discover and invoke it,
+ * but never supplies its gameplay semantics or reaches into the game World.
+ */
+export interface GameActionDef {
+    readonly id: string;
+    readonly title: string;
+    readonly description?: string;
+    readonly argsSchema?: GameActionArgsSchema;
+    /** Return an optional JSON-shaped result for inspection clients. */
+    readonly run: (args: GameProjectionValue) => GameProjectionValue | void | Promise<GameProjectionValue | void>;
+}
+/** A named, serializable Play-only read projection owned by game code. */
+export interface GameReadDef {
+    readonly id: string;
+    readonly title: string;
+    readonly description?: string;
+    readonly read: () => GameProjectionValue | Promise<GameProjectionValue>;
+}
+/**
+ * Host-provided registration sink for one Play run. Games receive this only while
+ * bootstrapping the fresh transient world; registrations are discarded when the run is disposed.
+ */
+export interface GameProjectionRegistrar {
+    registerAction(def: GameActionDef): () => void;
+    registerRead(def: GameReadDef): () => void;
+}
+/** Realm-local Host capability injected into an asset-resident game plugin. */
+export interface GameHost {
+    /** Presentation canvas owned by this Host realm. */
+    readonly canvas: HTMLCanvasElement;
+    /** The WebGPU Renderer (optional — some hosts may not expose it). */
+    readonly renderer?: Renderer;
+    /** The AssetRegistry owned by the App realm. */
+    readonly assets: AssetRegistry;
+    /** The App handle for lifecycle introspection. */
+    readonly app: App;
+    /** Synthetic root entity of the host-instantiated defaultScene. Carries the
+     * SceneInstance component. Absent when the game has no defaultScene. */
+    readonly defaultSceneRoot?: EntityHandle;
+    /** The loaded SceneAsset payload for the defaultScene. Contains the
+     * author-side entity list with Name components. Absent when the game has
+     * no defaultScene. */
+    readonly defaultScene?: SceneAsset;
+    /**
+     * Controlled UI container for this run. Games must mount their DOM UI here
+     * (`(ctx.uiRoot ?? document.body).appendChild(el)`) instead of appending
+     * directly to `document.body`. In the embedded editor viewport the host
+     * removes this whole container when the run is disposed. Absent means game
+     * code falls back to `document.body`.
+     */
+    readonly uiRoot?: HTMLElement;
+    /**
+     * M2 D-3: command-set pointer-lock gate. The game template calls this
+     * when the view mode changes (e.g. `setPointerLockAllowed(mode === 'fps')`
+     * to allow lock in FPS, disallow in top-down). The host wires this to
+     * App.input.setPointerLockAllowed?.() which delegates to the input backend.
+     * Absent → the host does not support pointer-lock gating (e.g. a host
+     * that only runs top-down games).
+     */
+    readonly setPointerLockAllowed?: (allowed: boolean) => void;
+    /**
+     * Optional Play-only projection seam. A game registers its own action and read
+     * capabilities here; the host may only discover/invoke/read those closures. It
+     * is deliberately absent outside a host that can clear registrations on disposal.
+     */
+    readonly gameProjection?: GameProjectionRegistrar;
+}
+/**
+ * Provide the Host boundary to a native Cordis game plugin.
+ */
+export declare function gameHostPlugin(host: GameHost): Plugin;
+declare module '@forgeax/engine-plugin' {
+    interface EngineContextServices {
+        gameHost?: GameHost;
+    }
+}
+//# sourceMappingURL=game-context.d.ts.map

package/dist/game-context.d.ts.map

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

package/dist/index.d.ts

@@ -0,0 +1,24 @@
+export type { Effect, EffectMeta, Fiber, Inject, Plugin, } from '@forgeax/engine-plugin';
+export { Context } from '@forgeax/engine-plugin';
+export { type AssetRuntimeAssembly, type AssetRuntimeAssemblyError, assembleAssetRuntime, } from './assets-runtime-assembly';
+export { createApp, measureCanvasDrawingBuffer, syncCanvasDrawingBuffer } from './create-app';
+export type { AppDetailCanvasDetached, AppDetailEmpty, AppDetailExecutionBootstrapFailed, AppDetailExecutionDeadlineExceeded, AppDetailExecutionKernelFailed, AppDetailExecutionRebuildFailed, AppDetailExecutionStaleWorld, AppDetailExecutionTierUnavailable, AppDetailPluginActivationFailed, AppDetailSystemUpdateFailed, AppErrorCode, AppErrorDetail, AppErrorDetailFor, } from './errors';
+export { APP_ERROR_HINTS, APP_EXPECTED, AppError, isAppError, } from './errors';
+export type { ExecutionBootstrapEntry, ExecutionBootstrapHost, ExecutionBootstrapValue, ExecutionCapabilities, ExecutionCapabilityFact, ExecutionCapabilityName, ExecutionControl, ExecutionEngineHealth, ExecutionFault, ExecutionMeasurement, ExecutionOptions, ExecutionReport, ExecutionRequestedTier, ExecutionSelection, ExecutionSelectionReason, ExecutionTier, ExecutionWorldHealth, KernelDispatchReason, PreparedExecutionBootstrap, } from './execution';
+export { createExecutionReport, EXECUTION_CAPABILITY_NAMES, EXECUTION_REPORT_SCHEMA_VERSION, EXECUTION_REQUESTED_TIERS, EXECUTION_TIERS, executionBootstrapHostPlugin, isExecutionReport, loadBootstrapEntry, missingExecutionCapabilities, prepareBootstrapEntry, probeExecutionCapabilities, selectExecutionTier, unavailableExecutionCapabilities, validateExecutionBootstrapData, } from './execution';
+export { ensureFallbackCamera } from './fallback-camera';
+export type { GameActionArgsSchema, GameActionDef, GameHost, GameProjectionRegistrar, GameProjectionValue, GameReadDef, } from './game-context';
+export { gameHostPlugin } from './game-context';
+export { inputPlugin } from './plugin-factories';
+import { isLoadGameError, LOAD_GAME_ERROR_HINTS, LOAD_GAME_EXPECTED, LoadGameError } from './load-game-errors';
+export type { GamePluginResolver } from './load-game';
+export { loadGame } from './load-game';
+export type { LoadGameDetailImportFailed, LoadGameDetailInvalidFormat, LoadGameDetailModuleNotFound, LoadGameErrorCode, LoadGameErrorDetail, LoadGameErrorDetailFor, } from './load-game-errors';
+export { createToolPreviewHost, replayToolPreviewCapture, type ToolPreviewCaptureResult, type ToolPreviewHost, type ToolPreviewHostError, type ToolPreviewHostOptions, type ToolPreviewResourceFacts, type ToolPreviewResourceKind, type ToolPreviewResourceRequest, type ToolPreviewRunResult, } from './tool-preview/bootstrap';
+export { createToolPreviewEvidence, joinResourcePreviewEvidence, joinToolPreviewEvidence, type ToolPreviewEvidence, } from './tool-preview/evidence';
+export { fitToolPreviewCameraToAabb, type ToolPreviewCameraFrame, } from './tool-preview/framing';
+export { createToolPreviewRecipe, type ToolPreviewAction, type ToolPreviewPresentation, type ToolPreviewRecipe, type ToolPreviewRecipeOptions, type ToolPreviewTrace, type ToolPreviewTraceEvent, validateToolPreviewTrace, } from './tool-preview/recipe';
+export type { App, AppAssembleArgs, AssembleAppError, BundlerOptions, CanvasAppError, CanvasDrawingBufferSize, CreateAppOptions, DrawSource, DrawSourceResult, ExecutionApp, } from './types';
+export { APP_PHASE_CATALOG } from './types';
+export { isLoadGameError, LOAD_GAME_ERROR_HINTS, LOAD_GAME_EXPECTED, LoadGameError };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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