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

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/animation-asset-lookup.ts","../src/canvas-policy.ts","../src/input-plugin.ts","../src/renderer-plugin.ts","../src/internal/assets-world-plugin.ts","../src/internal/worker-engine-profile.ts","../src/execution/attached-world-swap.ts","../src/errors.ts","../src/execution/bootstrap-entry.ts","../src/execution/kernel-pool.ts","../src/execution/engine-worker-runtime.ts"],"names":["renderer","assets","status"],"mappings":"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","file":"engine-worker-runtime.mjs","sourcesContent":["import type { AnimationPayloadLookup } from '@forgeax/engine-animation';\nimport type { AnimationClip } from '@forgeax/engine-types';\n\nexport interface AnimationPayloadSource {\n  lookup<T = unknown>(guid: string): T | undefined;\n}\n\n/** Bridge the renderer-owned GUID catalogue into the animation plugin. */\nexport function createAnimationPayloadLookup(\n  source: AnimationPayloadSource | undefined,\n): AnimationPayloadLookup {\n  return (guid) => source?.lookup<AnimationClip>(guid);\n}\n","import type { World } from '@forgeax/engine-ecs';\nimport { CAMERA_PROJECTION_PERSPECTIVE, Camera } from '@forgeax/engine-render';\n\n/** Keep host-owned perspective camera aspect policy in one execution-tier seam. */\nexport function syncCameraAspect(world: World, canvasW: number, canvasH: number): void {\n  if (canvasW <= 0 || canvasH <= 0) return;\n  const aspect = canvasW / canvasH;\n  const query = world.query({ with: [Camera] }).unwrap();\n  for (const row of query) {\n    const camera = world.get(row.entity, Camera);\n    if (!camera.ok) continue;\n    if (camera.value.autoAspect !== true) continue;\n    if (camera.value.projection !== CAMERA_PROJECTION_PERSPECTIVE) continue;\n    world.set(row.entity, Camera, { aspect });\n  }\n}\n","import { Update } from '@forgeax/engine-ecs';\nimport { INPUT_BACKEND_KEY, InputFrameStartScan, InputSet } from '@forgeax/engine-input';\nimport type { Plugin } from '@forgeax/engine-plugin';\n\n/** Project one Host-owned input provider into reversible World contributions. */\nexport function inputPlugin(): Plugin {\n  return {\n    name: 'input',\n    inject: ['world', 'input'],\n    apply(ctx) {\n      const world = ctx.world;\n      const input = ctx.input;\n      if (input === undefined) throw new Error('Cordis activated input without its provider');\n      ctx.effect(() => {\n        world.insertResource(INPUT_BACKEND_KEY, input);\n        return () => {\n          world.removeResource(INPUT_BACKEND_KEY);\n        };\n      }, 'input/resource');\n      ctx.effect(() => {\n        world.addSystems(Update, InputSet, [InputFrameStartScan]).unwrap();\n        return () => world.removeSystem(Update, InputFrameStartScan.name);\n      }, 'input/frame-start-scan');\n    },\n  };\n}\n","import type { Plugin } from '@forgeax/engine-plugin';\nimport type { RenderError, Renderer, RenderFeature, RenderResult } from '@forgeax/engine-render';\nimport type { RendererFeatureAssemblyHost } from '@forgeax/engine-render/internal/construct-renderer';\n\nexport interface RenderFeatureHost {\n  installFeature(\n    feature: RenderFeature<unknown>,\n  ): Promise<RenderResult<RenderFeatureLease, RenderError>>;\n}\n\nexport interface RenderFeatureLease {\n  release(): Promise<RenderResult<void, RenderError>>;\n}\n\nexport function createRenderFeatureHost(host: RendererFeatureAssemblyHost): RenderFeatureHost {\n  return {\n    async installFeature(feature) {\n      const installed = await host.installRenderFeature(feature);\n      if (!installed.ok) return installed;\n      let released = false;\n      return {\n        ok: true,\n        value: {\n          release: async () => {\n            if (released) return { ok: true, value: undefined };\n            released = true;\n            return host.uninstallRenderFeature(feature);\n          },\n        },\n      };\n    },\n  };\n}\n\ndeclare module '@forgeax/engine-plugin' {\n  interface EngineContextServices {\n    renderer?: Renderer;\n    renderFeatureHost?: RenderFeatureHost;\n  }\n}\n\n/** Provide the renderer without transferring its host-owned lifetime. */\nexport function rendererPlugin(renderer: Renderer): Plugin {\n  return {\n    name: 'renderer',\n    provide: 'renderer',\n    apply(ctx) {\n      ctx.provide('renderer', renderer);\n    },\n  };\n}\n\n/** Provide an App/Worker-owned Renderer and release it after dependent Fibers. */\nexport function ownedRendererPlugin(renderer: Renderer): Plugin {\n  return {\n    name: 'renderer',\n    provide: 'renderer',\n    apply(ctx) {\n      ctx.provide('renderer', renderer);\n      ctx.effect(() => () => renderer.dispose(), 'render/renderer');\n    },\n  };\n}\n\n/** Provide the App-owned late RenderFeature assembly capability. */\nexport function renderFeatureHostPlugin(host: RenderFeatureHost): Plugin {\n  return {\n    name: 'render-feature-host',\n    provide: 'renderFeatureHost',\n    apply(ctx) {\n      ctx.provide('renderFeatureHost', host);\n    },\n  };\n}\n\n/** Install a producer feature under the same Cordis Fiber that owns the caller. */\nexport function renderFeaturePlugin(feature: RenderFeature<unknown>): Plugin {\n  return {\n    name: `render-feature:${feature.identity}`,\n    inject: ['renderFeatureHost'],\n    async apply(ctx) {\n      if (ctx.renderFeatureHost === undefined) {\n        throw new Error('render-feature host capability is unavailable in this App realm');\n      }\n      const installed = await ctx.renderFeatureHost.installFeature(feature);\n      if (!installed.ok) throw installed.error;\n      ctx.effect(\n        () => async () => {\n          const removed = await installed.value.release();\n          if (!removed.ok) throw removed.error;\n        },\n        `render-feature/${feature.identity}`,\n      );\n    },\n  };\n}\n","import type { AssetRegistry } from '@forgeax/engine-assets-runtime';\nimport type { Plugin } from '@forgeax/engine-plugin';\n\nconst ASSET_REGISTRY_RESOURCE_KEY = 'AssetRegistry' as const;\n\n/** Project the Renderer-owned AssetRegistry as a declared dependent service. */\nexport function rendererAssetsPlugin(assets: AssetRegistry | undefined): Plugin {\n  return {\n    name: 'renderer-assets',\n    inject: ['renderer'],\n    provide: 'assets',\n    apply(ctx) {\n      if (assets !== undefined) ctx.provide('assets', assets);\n    },\n  };\n}\n\n/** Project the realm AssetRegistry into legacy World resource lookup reversibly. */\nexport function assetsWorldPlugin(): Plugin {\n  return {\n    name: 'assets-world',\n    inject: ['world', 'assets'],\n    apply(ctx) {\n      if (ctx.assets === undefined) return;\n      ctx.effect(() => {\n        ctx.world.insertResource(ASSET_REGISTRY_RESOURCE_KEY, ctx.assets);\n        return () => {\n          ctx.world.removeResource(ASSET_REGISTRY_RESOURCE_KEY);\n        };\n      }, 'assets/world-resource');\n    },\n  };\n}\n","import {\n  type AnimationPayloadLookup,\n  animationPayloadsPlugin,\n  animationRuntimePlugin,\n} from '@forgeax/engine-animation';\nimport { type AudioBackend, audioBackendPlugin } from '@forgeax/engine-audio';\nimport { type InputBackend, inputBackendPlugin } from '@forgeax/engine-input';\nimport type { Plugin } from '@forgeax/engine-plugin';\nimport { renderComponentsPlugin } from '@forgeax/engine-render';\nimport { scenePlugin } from '@forgeax/engine-scene';\nimport { statePlugin } from '@forgeax/engine-state';\nimport { inputPlugin } from '../input-plugin';\nimport {\n  ownedRendererPlugin,\n  type RenderFeatureHost,\n  renderFeatureHostPlugin,\n} from '../renderer-plugin';\nimport { assetsWorldPlugin, rendererAssetsPlugin } from './assets-world-plugin';\nimport type { EngineProfileBase } from './engine-profile-common';\n\nexport interface WorkerEngineProfileOptions extends EngineProfileBase {\n  readonly animationPayloads: AnimationPayloadLookup;\n  readonly input: InputBackend;\n  readonly audio: AudioBackend;\n  readonly rendererFeatureHost?: RenderFeatureHost;\n}\n\n/** Static Engine Worker selection; Host-only acquisition stays outside this realm. */\nexport function workerEngineProfile(options: WorkerEngineProfileOptions): Plugin[] {\n  return [\n    ownedRendererPlugin(options.renderer),\n    renderComponentsPlugin(),\n    ...(options.rendererFeatureHost === undefined\n      ? []\n      : [renderFeatureHostPlugin(options.rendererFeatureHost)]),\n    rendererAssetsPlugin(options.assets),\n    assetsWorldPlugin(),\n    inputBackendPlugin(options.input),\n    audioBackendPlugin(options.audio),\n    scenePlugin(),\n    animationPayloadsPlugin(options.animationPayloads),\n    animationRuntimePlugin(),\n    statePlugin(),\n    inputPlugin(),\n    ...(options.extensions ?? []),\n  ];\n}\n","import type { World } from '@forgeax/engine-ecs';\nimport type { Renderer } from '@forgeax/engine-render';\n\n/** Serialize realm rebuilds so candidate Worlds never overlap ownership. */\nexport class SerializedRebuildQueue {\n  private tail: Promise<void> = Promise.resolve();\n\n  enqueue(action: () => Promise<void>): Promise<void> {\n    const current = this.tail.then(action, action);\n    this.tail = current.catch(() => undefined);\n    return current;\n  }\n}\n\n/** Transactionally replace one Renderer-attached World. */\nexport async function commitAttachedWorld(\n  renderer: Pick<Renderer, 'attach'>,\n  nextWorld: World,\n  initializeCandidate: () => Promise<boolean>,\n): Promise<boolean> {\n  const attached = renderer.attach(nextWorld);\n  if (!attached.ok) throw attached.error;\n  try {\n    if (!(await initializeCandidate())) {\n      attached.value.dispose();\n      return false;\n    }\n  } catch (cause) {\n    attached.value.dispose();\n    throw cause;\n  }\n  return true;\n}\n","// @forgeax/engine-app -- AppError + closed AppErrorCode union (12 members) +\n// APP_ERROR_HINTS / APP_EXPECTED + discriminated AppErrorDetail per code.\n//\n// Shape:\n//   - AppErrorCode = closed union 12 members (charter P4 closed-union\n//     exhaustive switch needs no default fallback; tsc strict mode guards\n//     completeness; AGENTS.md \"Errors are structured\" + AC-07).\n//     Members:\n//       - 'app-not-started'\n//       - 'app-already-running'\n//       - 'app-canvas-detached'\n//       - 'app-system-update-failed'\n//       - 'app-pointer-lock-failed'\n//     Plan-strategy D-3 lock: device-lost stays on RhiErrorCode (18-member\n//     union); the AppError surface does NOT add a seventh 'app-device-lost'\n//     member. Host onError listener receives RhiError({code:'device-lost'})\n//     verbatim through the fan-out.\n//\n//   - AppError class = 4-field surface (.code / .expected / .hint /\n//     .detail) byte-for-byte parallel to RhiError (packages/rhi/src/errors.ts).\n//     The class extends Error so debug surfaces (stack, name) work in host\n//     environments; AI users walk .code / .detail by property access (charter\n//     P3 explicit failure: never parse the message string).\n//\n//   - AppError is exposed as a discriminated union (variant per code) so AI\n//     users get .detail narrowing for free after `if (err.code === '...')`:\n//\n//       if (err.code === 'app-canvas-detached') {\n//         console.warn('reattach canvas', err.detail.canvasId);\n//       }\n//\n//     Constructor accepts a generic args object and infers the variant from\n//     the literal `code` argument; `detail` must satisfy the per-code\n//     payload (`AppErrorDetailFor<C>`). Callers therefore cannot supply\n//     non-canonical fields like `{ state: 'running' }` on the\n//     'app-already-running' arm.\n//\n//   - APP_ERROR_HINTS / APP_EXPECTED are 12-key Records keyed by AppErrorCode;\n//     one private policy owner supplies both projections. The focused policy-owner\n//     proof asserts that every code has the exact expected and hint strings.\n//\n// Related: requirements AC-07 / AC-04 / AC-09; plan-strategy section 2 D-3\n// (6-member lock) + D-4 ('app-system-update-failed' detail = { cause,\n// systemName? }) + D-6 (dual-layer instanceof + switch consumption form);\n// research section 2.7 (AppErrorCode lands in AGENTS.md Error model table\n// alongside RhiErrorCode et al.); charter P3 (explicit failure) + P4\n// (closed-union exhaustive switch).\n\nimport type { RhiError } from '@forgeax/engine-rhi/errors';\nimport type { ExecutionCapabilityName, ExecutionTier } from './execution/types';\n\n/**\n * Closed AppErrorCode union (12 members).\n *\n * | code | trigger |\n * |:--|:--|\n * | `'app-not-started'` | `stop()` / `pause()` / `resume()` invoked while the rAF loop is in the terminal `'idle'` or `'stopped'` state (post-device-lost terminal sink). The handle has no live frame to interrupt; AI users either call `start()` first or accept that this handle is dead and rebuild via `createApp({...})`. |\n * | `'app-already-running'` | second `start()` invocation against an already-running handle; the call is a no-op state-machine-wise (state preserved). |\n * | `'app-canvas-detached'` | `createApp(canvas)` thin wrapper found `canvas.isConnected === false` at entry. Detail carries optional `canvasId` so the host can surface the offending canvas in a multi-canvas page (D-2 minor). |\n * | `'app-system-update-failed'` | World update, renderer draw, or a frame-loop callback failed; the original failure value is forwarded on `detail.cause`. `detail.systemName` is optional when the call site can name the failing owner. |\n * | `'app-pointer-lock-failed'` | `attachInputAuto`'s `onLockError` callback received a lock failure from the input backend. `detail.path` carries `'w3c'` (W3C `requestPointerLock` rejection) or `'provider'` (host-injected `lockProvider.requestLock` throw/reject). `detail.cause` carries the original rejection value verbatim. The host recovers by remaining in unlocked state; the next trusted click will retry the lock request. |\n *\n * Plan-strategy D-4 locked the count at 6; device-lost rides RhiErrorCode.\n */\nexport type AppErrorCode = keyof typeof appErrorPolicy;\n\n/**\n * Detail variant for the `'app-canvas-detached'` arm.\n *\n * `canvasId` carries an optional identifier the host can surface to AI\n * users when multiple canvases live on the page (e.g. preview vs live\n * canvas). `undefined` when the host did not assign an id.\n */\nexport interface AppDetailCanvasDetached {\n  readonly canvasId?: string | undefined;\n}\n\n/**\n * Detail variant for the `'app-system-update-failed'` arm (plan-strategy D-4).\n *\n * `cause` carries the original thrown value verbatim so AI users can\n * `cause instanceof EcsError` / `cause instanceof RhiError` narrow without\n * losing structure. `systemName` is populated when the call site can name\n * the offending system (input-attach cleanup path forwards\n * `FRAME_START_SCAN_SYSTEM_NAME`).\n */\nexport interface AppDetailSystemUpdateFailed {\n  readonly cause: unknown;\n  readonly systemName?: string | undefined;\n}\n\n/**\n * Detail variant for the `'app-pointer-lock-failed'` arm (plan-strategy D-4).\n *\n * `path` discriminates between W3C `requestPointerLock` rejections (`'w3c'`)\n * and host-injected `lockProvider.requestLock` throw/reject (`'provider'`).\n * `cause` carries the original rejection value verbatim so AI users can\n * narrow further (e.g. `cause instanceof DOMException` for W3C timeout\n * rejections).\n */\nexport interface AppDetailPointerLockFailed {\n  readonly path: 'w3c' | 'provider';\n  readonly cause: unknown;\n}\n\n/** Why a host-requested deterministic frame could not run. */\nexport interface AppDetailFrameStepInvalid {\n  readonly state: 'idle' | 'running' | 'paused' | 'stopped';\n  readonly deltaSeconds: number;\n  readonly reason: 'state' | 'delta';\n}\n\nexport interface AppDetailExecutionTierUnavailable {\n  readonly requestedTier: ExecutionTier;\n  readonly missingCapabilities: readonly ExecutionCapabilityName[];\n  readonly sharedEvidencePassed: boolean;\n}\n\nexport interface AppDetailExecutionBootstrapFailed {\n  readonly phase: 'import' | 'export' | 'prepare' | 'bootstrap' | 'data';\n  readonly moduleUrl: string;\n  readonly cause: unknown;\n}\n\n/** Original startup failure thrown by a Cordis plugin fiber. */\nexport interface AppDetailPluginActivationFailed {\n  readonly cause: unknown;\n}\n\nexport interface AppDetailExecutionDeadlineExceeded {\n  readonly phase: 'startup' | 'handshake' | 'frame';\n  readonly timeoutMs: number;\n}\n\nexport interface AppDetailExecutionKernelFailed {\n  readonly kernelName: string;\n  readonly worldIdentity: string;\n  readonly cause: unknown;\n  readonly partialWrite: true;\n  readonly retryable: false;\n}\n\nexport interface AppDetailExecutionStaleWorld {\n  readonly expectedIdentity: string;\n  readonly receivedIdentity: string;\n  readonly messageKind: string;\n}\n\nexport interface AppDetailExecutionRebuildFailed {\n  readonly worldIdentity: string | null;\n  readonly cause: unknown;\n}\n\n/**\n * Empty-detail shape for the 2 codes that carry no payload\n * (`'app-not-started'`, `'app-already-running'`).\n *\n * Modelled as `Readonly<Record<string, never>>` so literal builders use\n * `{}` while still narrowing under tsc strict (no extra property allowed).\n */\nexport type AppDetailEmpty = Readonly<Record<string, never>>;\n\n/**\n * Conditional resolver from `AppErrorCode` to its detail payload type.\n *\n * Used by the constructor signature so `new AppError({ code: 'X', ... })`\n * narrows the `detail` parameter to the variant payload at compile time.\n */\nexport type AppErrorDetailFor<C extends AppErrorCode> = C extends 'app-canvas-detached'\n  ? AppDetailCanvasDetached\n  : C extends 'app-frame-step-invalid'\n    ? AppDetailFrameStepInvalid\n    : C extends 'app-system-update-failed'\n      ? AppDetailSystemUpdateFailed\n      : C extends 'app-pointer-lock-failed'\n        ? AppDetailPointerLockFailed\n        : C extends 'app-plugin-activation-failed'\n          ? AppDetailPluginActivationFailed\n          : C extends 'app-execution-tier-unavailable'\n            ? AppDetailExecutionTierUnavailable\n            : C extends 'app-execution-bootstrap-failed'\n              ? AppDetailExecutionBootstrapFailed\n              : C extends 'app-execution-deadline-exceeded'\n                ? AppDetailExecutionDeadlineExceeded\n                : C extends 'app-execution-kernel-failed'\n                  ? AppDetailExecutionKernelFailed\n                  : C extends 'app-execution-stale-world'\n                    ? AppDetailExecutionStaleWorld\n                    : C extends 'app-execution-rebuild-failed'\n                      ? AppDetailExecutionRebuildFailed\n                      : AppDetailEmpty;\n\n/**\n * Tagged union of `.detail` payloads carried by structured AppError.\n *\n * Each variant maps to its `AppErrorCode` arm via `AppErrorDetailFor<C>`;\n * the variants are unique by structural fields (`AppDetailCanvasDetached`\n * has `canvasId`, `AppDetailSystemUpdateFailed` has `cause`, the empty\n * shape has neither).\n */\nexport type AppErrorDetail = AppErrorDetailFor<AppErrorCode>;\n\n/**\n * Render a one-line summary of `detail.cause` for embedding in\n * `AppError.message`. `cause` is structurally typed (`unknown`) because\n * upstream may throw any value; callers downstream still get the verbatim\n * value via `err.detail.cause` — this helper exists so tools that only see\n * `err.message` (`console.error(err)`, raw stringification) still surface\n * the root cause without consumers manually expanding `detail`.\n *\n * Closed precedence:\n *   1. Structured engine errors (RhiError / EcsError / RenderGraphError /\n *      AssetError / ShaderError / ...) carry `.code` + `.message`; render\n *      `<Name> <code>: <message>`.\n *   2. Plain `Error`: render `<name>: <message>`.\n *   3. Anything else: `String(cause)` (covers thrown strings, numbers, null).\n *\n * Newlines are replaced with `' / '` so the final AppError message stays a\n * single line (callers already split on `\\n` in stack traces, so a multiline\n * message would corrupt their parsing).\n */\nfunction summarizeCause(cause: unknown): string {\n  if (cause === null || cause === undefined) return String(cause);\n  if (typeof cause !== 'object') return String(cause);\n  const r = cause as { name?: unknown; message?: unknown; code?: unknown };\n  const name = typeof r.name === 'string' && r.name.length > 0 ? r.name : 'Error';\n  const code = typeof r.code === 'string' && r.code.length > 0 ? r.code : '';\n  const message = typeof r.message === 'string' ? r.message : '';\n  const head = code !== '' ? `${name} ${code}` : name;\n  const body = message !== '' ? `: ${message}` : '';\n  return `${head}${body}`.replace(/\\s*\\n+\\s*/g, ' / ');\n}\n\nclass AppErrorClass extends Error {\n  readonly code: AppErrorCode;\n  readonly expected: string;\n  readonly hint: string;\n  readonly detail: AppErrorDetail;\n\n  constructor(args: {\n    code: AppErrorCode;\n    expected: string;\n    hint: string;\n    detail: AppErrorDetail;\n  }) {\n    // Surface `detail.cause` directly inside `.message` for the\n    // `'app-system-update-failed'` arm. Without this, a generic\n    // `console.error(err)` shows only the wrapper expected/hint and\n    // hides the actual EcsError / RhiError / host-system Error that\n    // tripped the frame loop. The verbatim `cause` value remains on\n    // `err.detail.cause` for two-level-narrow consumers (charter P3).\n    let causeSuffix = '';\n    if (args.code === 'app-system-update-failed') {\n      const d = args.detail as AppDetailSystemUpdateFailed;\n      const sys =\n        typeof d.systemName === 'string' && d.systemName.length > 0\n          ? ` (system=${d.systemName})`\n          : '';\n      causeSuffix = `; cause: ${summarizeCause(d.cause)}${sys}`;\n    } else if (args.code === 'app-pointer-lock-failed') {\n      const d = args.detail as AppDetailPointerLockFailed;\n      causeSuffix = `; path: ${d.path}; cause: ${summarizeCause(d.cause)}`;\n    } else if (args.code === 'app-plugin-activation-failed') {\n      const d = args.detail as AppDetailPluginActivationFailed;\n      causeSuffix = `; cause: ${summarizeCause(d.cause)}`;\n    } else if (args.code === 'app-execution-bootstrap-failed') {\n      const d = args.detail as AppDetailExecutionBootstrapFailed;\n      causeSuffix = `; phase: ${d.phase}; cause: ${summarizeCause(d.cause)}`;\n    } else if (args.code === 'app-execution-kernel-failed') {\n      const d = args.detail as AppDetailExecutionKernelFailed;\n      causeSuffix = `; kernel: ${d.kernelName}; cause: ${summarizeCause(d.cause)}`;\n    } else if (args.code === 'app-execution-rebuild-failed') {\n      const d = args.detail as AppDetailExecutionRebuildFailed;\n      causeSuffix = `; cause: ${summarizeCause(d.cause)}`;\n    }\n    super(`[AppError ${args.code}] expected: ${args.expected}; hint: ${args.hint}${causeSuffix}`);\n    this.name = 'AppError';\n    this.code = args.code;\n    this.expected = args.expected;\n    this.hint = args.hint;\n    this.detail = args.detail;\n  }\n}\n\n/**\n * Variant intersection: an `AppErrorClass` instance whose `code` literal\n * narrows to `C` and whose `detail` narrows to `AppErrorDetailFor<C>`. The\n * shape lets `if (err.code === 'X')` simultaneously narrow `err.detail` to\n * the per-code payload (charter P3 + AC-07 discriminated union).\n */\ntype AppErrorVariant<C extends AppErrorCode> = AppErrorClass & {\n  readonly code: C;\n  readonly detail: AppErrorDetailFor<C>;\n};\n\n/**\n * Public AppError type — discriminated union of the policy variants.\n *\n * AI-user form (charter P3 explicit failure):\n *\n * ```ts\n * function recover(err: AppError): string {\n *   switch (err.code) {\n *     case 'app-not-started':         return 'call start() first';\n *     case 'app-already-running':     return 'state preserved; ignore';\n *     case 'app-canvas-detached':     return `reattach ${err.detail.canvasId ?? 'canvas'}`;\n *     case 'app-system-update-failed':\n *       return err.detail.cause instanceof Error ? err.detail.cause.message : 'unknown';\n *     case 'app-pointer-lock-failed':\n *       return `lock failed (${err.detail.path}): ${err.detail.cause}`;\n *   }\n * }\n * ```\n */\nexport type AppError = {\n  [C in AppErrorCode]: AppErrorVariant<C>;\n}[AppErrorCode];\n\ninterface AppErrorConstructor {\n  new <C extends AppErrorCode>(args: {\n    code: C;\n    expected: string;\n    hint: string;\n    detail: AppErrorDetailFor<C>;\n  }): AppErrorVariant<C>;\n  readonly prototype: AppErrorClass;\n}\n\n/**\n * AppError constructor — `new AppError({ code, expected, hint, detail })`.\n *\n * The generic `C` is inferred from the literal `code` argument, which\n * narrows `detail` to the per-code payload (`AppErrorDetailFor<C>`) and\n * narrows the return type to the corresponding `AppErrorVariant<C>` so the\n * call site walks the discriminated union without manual cast.\n *\n * The constructor delegates to the `AppErrorClass` runtime; the typed-cast\n * here is the ergonomic affordance for AI users (TS class declarations\n * cannot directly express `<C> ... AppErrorVariant<C>` polymorphism).\n */\nexport const AppError: AppErrorConstructor = AppErrorClass as unknown as AppErrorConstructor;\n\n/**\n * `expected` table — the engine-side invariant that was violated when each\n * code surfaces. AI users read this as the L2 detail (charter F2 priority\n * text); `.hint` carries the recovery action.\n *\n * 12 keys; the focused policy-owner proof locks the exact key set and values.\n * locks the count and non-emptiness of every entry.\n */\ntype AppErrorPolicy = { readonly expected: string; readonly hint: string };\n\nconst appErrorPolicy = {\n  'app-not-started': {\n    expected:\n      'state must be \"running\" or \"paused\" to accept stop/pause/resume; \"idle\" / \"stopped\" terminal sinks reject',\n    hint: 'check getState() before calling stop/pause/resume; rebuild the handle via createApp({...}) when the previous one terminated on device-lost',\n  },\n  'app-already-running': {\n    expected:\n      'state must be \"idle\" or \"paused\" to start; \"running\" handles ignore subsequent start() calls',\n    hint: 'call stop() first or audit start() call sites; the second start() is a no-op so state is preserved',\n  },\n  'app-canvas-detached': {\n    expected: 'canvas.isConnected === true at createApp(canvas) entry',\n    hint: 'append the canvas to the document tree before calling createApp(canvas), or use the assemble entry createApp({ renderer, world }) when the host already manages canvas lifetime',\n  },\n  'app-frame-step-invalid': {\n    expected:\n      'stepFrame(deltaSeconds) runs only while the App is paused and deltaSeconds is finite and non-negative',\n    hint: 'pause the App before deterministic stepping and pass an explicit finite delta; resume after the bounded step sequence completes',\n  },\n  'app-system-update-failed': {\n    expected:\n      'world.update(world), renderer.draw(world), and frame-loop callbacks complete without failure',\n    hint: 'inspect detail.cause for the original thrown value (EcsError / RhiError / host system bug); detail.systemName names the offending system when the call site can supply it',\n  },\n  'app-pointer-lock-failed': {\n    expected:\n      'pointer-lock request (W3C requestPointerLock or host lockProvider.requestLock) to succeed; failure signals the browser rejected the lock or the host provider threw',\n    hint: 'remain in unlocked state; the next trusted click will automatically retry the lock request. inspect detail.path (\"w3c\" or \"provider\") and detail.cause to determine the root cause',\n  },\n  'app-plugin-activation-failed': {\n    expected: 'every requested Cordis plugin fiber reaches a stable active or pending state',\n    hint: 'inspect detail.cause and the plugin fiber effects; repair the failing activation before creating the App again',\n  },\n  'app-execution-tier-unavailable': {\n    expected:\n      'the explicitly requested execution tier has every required observed capability and the shipped shared evidence gate',\n    hint: 'inspect detail.missingCapabilities and detail.sharedEvidencePassed; use tier=\"auto\" only when an observed fallback is acceptable',\n  },\n  'app-execution-bootstrap-failed': {\n    expected:\n      'the bootstrap URL imports a module whose default export completes as an ExecutionBootstrapEntry in the selected Engine Realm',\n    hint: 'inspect detail.phase, moduleUrl and cause; export one default ExecutionBootstrapEntry that creates only realm-local engine state',\n  },\n  'app-execution-deadline-exceeded': {\n    expected:\n      'the execution startup, handshake or frame completes within its configured bounded deadline',\n    hint: 'inspect detail.phase and timeoutMs; the timed-out Worker has been terminated, so fix startup or frame work before creating a new App',\n  },\n  'app-execution-kernel-failed': {\n    expected:\n      'a shared kernel completes every dispatched shard without leaving a possibly partial World write',\n    hint: 'do not retry or draw the poisoned World; inspect detail.kernelName and cause, then call app.execution.rebuild()',\n  },\n  'app-execution-stale-world': {\n    expected:\n      'every execution message targets the currently active World identity before it can write',\n    hint: 'discard the late message and keep the current World; inspect expectedIdentity, receivedIdentity and messageKind',\n  },\n  'app-execution-rebuild-failed': {\n    expected:\n      'explicit rebuild disposes the poisoned World and bootstraps a fresh World identity in the surviving Engine Realm',\n    hint: 'inspect detail.cause; this App remains stopped, so fix the bootstrap failure or create a new App explicitly',\n  },\n} satisfies Record<string, AppErrorPolicy>;\n\nexport const APP_EXPECTED: Readonly<Record<AppErrorCode, string>> = Object.fromEntries(\n  Object.entries(appErrorPolicy).map(([code, policy]) => [code, policy.expected]),\n) as Readonly<Record<AppErrorCode, string>>;\n\nexport const APP_ERROR_HINTS: Readonly<Record<AppErrorCode, string>> = Object.fromEntries(\n  Object.entries(appErrorPolicy).map(([code, policy]) => [code, policy.hint]),\n) as Readonly<Record<AppErrorCode, string>>;\n\n/**\n * Type guard for narrowing `CanvasAppError`-compatible mixed signals to AppError.\n *\n * The fan-out signature is `(err: CanvasAppError) => void`; AI users\n * who want to handle only the AppError leg call `if (isAppError(err)) ...`\n * before walking `.code`. Reverse-compatible with `instanceof AppError`\n * (the class is exposed); the function form is provided as the\n * canonical idiom in JSDoc / README so AI users do not need to reason\n * about cross-realm `instanceof` quirks.\n *\n * The parameter accepts the complete App/RHI boundary union so callers can\n * narrow the error without casts.\n */\nexport function isAppError(err: AppError | RhiError): err is AppError {\n  return err instanceof AppErrorClass;\n}\n","import type { Plugin } from '@forgeax/engine-plugin';\nimport type { RenderFeature } from '@forgeax/engine-render';\nimport { err, ok, type Result } from '@forgeax/engine-types';\nimport { APP_ERROR_HINTS, APP_EXPECTED, AppError, type AppError as AppErrorType } from '../errors';\nimport type { ExecutionBootstrapValue } from './types';\n\n/** Realm-local engine assembly returned by an execution bootstrap module. */\nexport interface PreparedExecutionBootstrap {\n  /** Render features constructed in the realm that will own the Renderer. */\n  readonly features?: readonly RenderFeature<unknown>[];\n  /** Plugins constructed in the realm that will own the World. */\n  readonly plugins?: readonly Plugin[];\n}\n\n/** Realm-local Host bridge available to execution bootstrap plugins. */\nexport interface ExecutionBootstrapHost {\n  readonly port?: MessagePort;\n  setPointerLockAllowed(allowed: boolean): void;\n}\n\ndeclare module '@forgeax/engine-plugin' {\n  interface EngineContextServices {\n    executionBootstrapHost: ExecutionBootstrapHost;\n  }\n}\n\n/** Bind the optional Host transport to the same Fiber that owns bootstrap plugins. */\nexport function executionBootstrapHostPlugin(host: ExecutionBootstrapHost): Plugin {\n  return {\n    name: 'execution-bootstrap-host',\n    provide: 'executionBootstrapHost',\n    apply(ctx) {\n      ctx.provide('executionBootstrapHost', host);\n      if (host.port !== undefined) {\n        ctx.effect(() => () => host.port?.close(), 'execution/bootstrap-port');\n      }\n    },\n  };\n}\n\n/** Default export contract for `ExecutionOptions.bootstrap`. */\nexport type ExecutionBootstrapEntry = (\n  data: ExecutionBootstrapValue | undefined,\n) => PreparedExecutionBootstrap | Promise<PreparedExecutionBootstrap>;\n\nfunction bootstrapError(\n  phase: 'import' | 'export' | 'prepare' | 'bootstrap' | 'data',\n  moduleUrl: string,\n  cause: unknown,\n): AppErrorType {\n  return new AppError({\n    code: 'app-execution-bootstrap-failed',\n    expected: APP_EXPECTED['app-execution-bootstrap-failed'],\n    hint: APP_ERROR_HINTS['app-execution-bootstrap-failed'],\n    detail: { phase, moduleUrl, cause },\n  });\n}\n\nexport function validateExecutionBootstrapData(\n  data: ExecutionBootstrapValue | undefined,\n  moduleUrl: string,\n): Result<void, AppErrorType> {\n  if (data === undefined) return ok(undefined);\n  try {\n    structuredClone(data);\n    return ok(undefined);\n  } catch (cause) {\n    return err(bootstrapError('data', moduleUrl, cause));\n  }\n}\n\nexport async function loadBootstrapEntry(\n  moduleUrl: string,\n): Promise<Result<ExecutionBootstrapEntry, AppErrorType>> {\n  let loaded: unknown;\n  try {\n    loaded = await import(/* @vite-ignore */ moduleUrl);\n  } catch (cause) {\n    return err(bootstrapError('import', moduleUrl, cause));\n  }\n  const entry = (loaded as { default?: unknown }).default;\n  if (typeof entry !== 'function') {\n    return err(\n      bootstrapError(\n        'export',\n        moduleUrl,\n        new TypeError('default export is not an ExecutionBootstrapEntry function'),\n      ),\n    );\n  }\n  return ok(entry as ExecutionBootstrapEntry);\n}\n\nexport async function prepareBootstrapEntry(\n  moduleUrl: string,\n  data: ExecutionBootstrapValue | undefined,\n): Promise<Result<PreparedExecutionBootstrap, AppErrorType>> {\n  const valid = validateExecutionBootstrapData(data, moduleUrl);\n  if (!valid.ok) return valid;\n  const loaded = await loadBootstrapEntry(moduleUrl);\n  if (!loaded.ok) return loaded;\n  try {\n    const prepared = await loaded.value(data);\n    if (\n      typeof prepared !== 'object' ||\n      prepared === null ||\n      (prepared.features !== undefined && !Array.isArray(prepared.features)) ||\n      (prepared.plugins !== undefined && !Array.isArray(prepared.plugins))\n    ) {\n      return err(\n        bootstrapError(\n          'prepare',\n          moduleUrl,\n          new TypeError('execution bootstrap must return an object with feature and plugin arrays'),\n        ),\n      );\n    }\n    return ok(prepared);\n  } catch (cause) {\n    return err(bootstrapError('prepare', moduleUrl, cause));\n  }\n}\n","import type {\n  KernelDispatchFailure,\n  KernelDispatchResult,\n  KernelDispatchSpan,\n  SharedKernelDispatch,\n  SharedKernelExecutor,\n  SharedSpanBinding,\n} from '@forgeax/engine-ecs/shared';\nimport { bindSharedSpan, isSharedSpan, splitSharedSpan } from '@forgeax/engine-ecs/shared';\n\nexport interface KernelPool extends SharedKernelExecutor {\n  readonly laneCount: number;\n  ready(): Promise<void>;\n  takeLastDispatch(): KernelDispatchResult | null;\n  dispose(): void;\n}\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 KernelPreflight {\n  readonly control: Int32Array;\n  readonly status: Int32Array;\n}\n\nexport interface KernelPoolOptions {\n  readonly lanes?: number;\n  readonly timeoutMs?: number;\n  readonly workerFactory?: () => Worker;\n}\n\nexport function createKernelPool(options: KernelPoolOptions = {}): KernelPool {\n  const hardware = globalThis.navigator?.hardwareConcurrency ?? 2;\n  const laneCount = Math.max(1, Math.min(options.lanes ?? hardware - 1, 8));\n  const timeoutMs = options.timeoutMs ?? 5_000;\n  const workers = Array.from(\n    { length: laneCount },\n    () =>\n      options.workerFactory?.() ??\n      new Worker(new URL('./kernel-worker-runtime.mjs', import.meta.url), {\n        type: 'module',\n        name: 'forgeax-kernel',\n      }),\n  );\n  let latest: KernelDispatchResult | null = null;\n  let ready = false;\n  const preflights = new Map<string, KernelPreflight>();\n  const readyControl = new Int32Array(new SharedArrayBuffer(Int32Array.BYTES_PER_ELEMENT));\n  const initMessage: KernelInitMessage = { kind: 'kernel-init', ready: readyControl };\n  for (const worker of workers) worker.postMessage(initMessage);\n  const waitFor = (control: Int32Array, expected: number, label: string): Promise<void> =>\n    new Promise<void>((resolve, reject) => {\n      const started = performance.now();\n      const poll = (): void => {\n        if (Atomics.load(control, 0) === expected) {\n          resolve();\n          return;\n        }\n        if (performance.now() - started >= timeoutMs) {\n          for (const worker of workers) worker.terminate();\n          reject(new Error(`${label} did not complete within ${timeoutMs}ms.`));\n          return;\n        }\n        setTimeout(poll, 1);\n      };\n      poll();\n    });\n\n  const readyPromise = waitFor(\n    readyControl,\n    workers.length,\n    'SharedKernel worker initialization',\n  ).then(async () => {\n    for (const [moduleUrl, preflight] of preflights) {\n      await waitFor(\n        preflight.control,\n        workers.length,\n        `SharedKernel module preflight for ${moduleUrl}`,\n      );\n      if (preflight.status.some((status) => status !== 1)) {\n        throw new Error(`SharedKernel module preflight failed for ${moduleUrl}.`);\n      }\n    }\n    ready = true;\n  });\n\n  return {\n    laneCount,\n    ready: () => readyPromise,\n    warmup(kernel): void {\n      if (preflights.has(kernel.moduleUrl)) return;\n      const control = new Int32Array(new SharedArrayBuffer(Int32Array.BYTES_PER_ELEMENT));\n      const status = new Int32Array(\n        new SharedArrayBuffer(Int32Array.BYTES_PER_ELEMENT * workers.length),\n      );\n      preflights.set(kernel.moduleUrl, { control, status });\n      for (const [jobIndex, worker] of workers.entries()) {\n        const message: KernelPreloadMessage = {\n          kind: 'kernel-preload',\n          moduleUrl: kernel.moduleUrl,\n          control,\n          status,\n          jobIndex,\n        };\n        worker.postMessage(message);\n      }\n    },\n    takeLastDispatch: () => {\n      const dispatch = latest;\n      latest = null;\n      return dispatch;\n    },\n    execute(\n      kernel: SharedKernelDispatch,\n      spans: readonly KernelDispatchSpan[],\n    ): KernelDispatchResult | KernelDispatchFailure {\n      const preflight = preflights.get(kernel.moduleUrl);\n      if (preflight === undefined) {\n        this.warmup?.(kernel);\n        latest = { mode: 'forced-inline', dispatched: 0, completed: 0, waitMs: 0 };\n        return {\n          cause: new Error('SharedKernel module was not preflighted before frame dispatch.'),\n          dispatched: 0,\n          completed: 0,\n          partialWrite: false,\n        };\n      }\n      if (\n        Atomics.load(preflight.control, 0) !== workers.length ||\n        preflight.status.some((status) => status !== 1)\n      ) {\n        latest = { mode: 'forced-inline', dispatched: 0, completed: 0, waitMs: 0 };\n        return {\n          cause: new Error('SharedKernel module preflight is incomplete or failed.'),\n          dispatched: 0,\n          completed: 0,\n          partialWrite: false,\n        };\n      }\n      if (!ready && Atomics.load(readyControl, 0) === workers.length) ready = true;\n      if (!ready) {\n        latest = { mode: 'forced-inline', dispatched: 0, completed: 0, waitMs: 0 };\n        return {\n          cause: new Error('SharedKernel workers were not warmed before frame dispatch.'),\n          dispatched: 0,\n          completed: 0,\n          partialWrite: false,\n        };\n      }\n      const bindings = spans.flatMap(({ queryIndex, span }) =>\n        splitSharedSpan(bindSharedSpan(kernel, span, queryIndex), laneCount),\n      );\n      if (bindings.length === 0) {\n        latest = { mode: 'forced-inline', dispatched: 0, completed: 0, waitMs: 0 };\n        return latest;\n      }\n      if (!bindings.every(isSharedSpan)) {\n        latest = { mode: 'forced-inline', dispatched: 0, completed: 0, waitMs: 0 };\n        return {\n          cause: new Error('SharedKernel received a non-SAB QuerySpan.'),\n          dispatched: 0,\n          completed: 0,\n          partialWrite: false,\n        };\n      }\n      const control = new Int32Array(new SharedArrayBuffer(Int32Array.BYTES_PER_ELEMENT));\n      const status = new Int32Array(\n        new SharedArrayBuffer(Int32Array.BYTES_PER_ELEMENT * bindings.length),\n      );\n      const started = performance.now();\n      for (const [index, binding] of bindings.entries()) {\n        const message: KernelJobMessage = {\n          kind: 'kernel-job',\n          moduleUrl: kernel.moduleUrl,\n          binding,\n          control,\n          status,\n          jobIndex: index,\n        };\n        workers[index % workers.length]?.postMessage(message);\n      }\n      while (Atomics.load(control, 0) < bindings.length) {\n        const observed = Atomics.load(control, 0);\n        const wait = Atomics.wait(control, 0, observed, timeoutMs);\n        if (wait === 'timed-out') {\n          for (const worker of workers) worker.terminate();\n          return {\n            cause: new Error(`SharedKernel deadline exceeded after ${timeoutMs}ms.`),\n            dispatched: bindings.length,\n            completed: observed,\n            partialWrite: bindings.length > 0,\n          };\n        }\n      }\n      const completed = status.reduce((count, value) => count + (value === 1 ? 1 : 0), 0);\n      const failed = status.some((value) => value === -1);\n      if (failed) {\n        return {\n          cause: new Error('SharedKernel worker failed.'),\n          dispatched: bindings.length,\n          completed,\n          partialWrite: bindings.length > 0,\n        };\n      }\n      latest = {\n        mode: 'shared',\n        dispatched: bindings.length,\n        completed,\n        waitMs: performance.now() - started,\n      };\n      return latest;\n    },\n    dispose(): void {\n      for (const worker of workers) worker.terminate();\n    },\n  };\n}\n","import { type AudioIntent, createAudioIntentBackend } from '@forgeax/engine-audio';\nimport { createWorldContext, World } from '@forgeax/engine-ecs';\nimport type { SharedKernelExecutor } from '@forgeax/engine-ecs/shared';\nimport type { InputBackend, InputBackendSample } from '@forgeax/engine-input';\nimport type { Context, Plugin } from '@forgeax/engine-plugin';\nimport type { Renderer } from '@forgeax/engine-render';\nimport { constructRuntimeRendererHost } from '@forgeax/engine-runtime/internal/renderer-host';\nimport { createAnimationPayloadLookup } from '../animation-asset-lookup';\nimport { syncCameraAspect } from '../canvas-policy';\nimport { workerEngineProfile } from '../internal/worker-engine-profile';\nimport { createRenderFeatureHost } from '../renderer-plugin';\nimport { commitAttachedWorld, SerializedRebuildQueue } from './attached-world-swap';\nimport {\n  executionBootstrapHostPlugin,\n  type PreparedExecutionBootstrap,\n  prepareBootstrapEntry,\n} from './bootstrap-entry';\nimport { createKernelPool, type KernelPool } from './kernel-pool';\nimport type {\n  EngineToHostMessage,\n  ExecutionFrameMessage,\n  ExecutionInitMessage,\n  ExecutionRebuildMessage,\n  HostToEngineMessage,\n} from './protocol';\n\nconst scope = globalThis as unknown as {\n  postMessage(message: EngineToHostMessage): void;\n  onmessage: ((event: MessageEvent<HostToEngineMessage>) => void) | null;\n  close(): void;\n};\n\nlet renderer: Renderer | undefined;\nlet assets: import('@forgeax/engine-assets-runtime').AssetRegistry | undefined;\nlet currentSample: InputBackendSample = {\n  downKeys: new Set(),\n  upKeys: new Set(),\n  buttons: [false, false, false],\n  movementX: 0,\n  movementY: 0,\n  wheelDelta: 0,\n  focused: true,\n  pointerLocked: false,\n};\nlet lastFrameId = 0;\nlet engineCanvas: OffscreenCanvas | undefined;\ninterface WorkerRealm {\n  readonly world: World;\n  readonly init: ExecutionInitMessage;\n  pendingAudioIntents: AudioIntent[];\n  kernelPool: KernelPool | undefined;\n  pluginContext: Context | undefined;\n}\n\nlet realm: WorkerRealm | undefined;\nconst rebuildQueue = new SerializedRebuildQueue();\n\nconst inputBackend: InputBackend = {\n  sample: () => currentSample,\n  detach: () => {},\n};\n\nfunction sharedKernelPlugin(target: WorkerRealm): Plugin {\n  return {\n    name: 'shared-kernel-executor',\n    inject: ['world'],\n    apply(ctx) {\n      const executor: SharedKernelExecutor = {\n        warmup(kernel) {\n          target.kernelPool ??= createKernelPool();\n          target.kernelPool.warmup?.(kernel);\n        },\n        execute(kernel, spans) {\n          target.kernelPool ??= createKernelPool();\n          return target.kernelPool.execute(kernel, spans);\n        },\n      };\n      ctx.effect(() => {\n        ctx.world.insertResource('SharedKernelExecutor', executor);\n        return () => {\n          ctx.world.removeResource('SharedKernelExecutor');\n          target.kernelPool?.dispose();\n          target.kernelPool = undefined;\n        };\n      }, 'execution/shared-kernel');\n    },\n  };\n}\n\nfunction serializableCause(cause: unknown): { readonly name: string; readonly message: string } {\n  return cause instanceof Error\n    ? { name: cause.name, message: cause.message }\n    : { name: 'Error', message: String(cause) };\n}\n\nfunction serializableDetail(cause: unknown): unknown {\n  if (cause instanceof Error) return serializableCause(cause);\n  if (Array.isArray(cause)) return cause.map(serializableDetail);\n  if (typeof cause === 'object' && cause !== null) {\n    return Object.fromEntries(\n      Object.entries(cause).map(([key, value]) => [key, serializableDetail(value)]),\n    );\n  }\n  return cause;\n}\n\nfunction postFault(\n  source: 'bootstrap' | 'runtime' | 'world' | 'rebuild',\n  code: string,\n  expected: string,\n  hint: string,\n  cause: unknown,\n  partialWrite = false,\n): void {\n  scope.postMessage({\n    kind: 'fault',\n    worldIdentity: realm?.world.identity ?? null,\n    source,\n    code,\n    expected,\n    hint,\n    detail: serializableDetail(cause),\n    partialWrite,\n    retryable: false,\n  });\n}\n\nasync function disposeRealm(target: WorkerRealm): Promise<void> {\n  await target.pluginContext?.fiber.dispose();\n  target.pluginContext = undefined;\n  target.pendingAudioIntents = [];\n}\n\nfunction postBootstrapFault(error: {\n  readonly code: string;\n  readonly expected: string;\n  readonly hint: string;\n  readonly detail: unknown;\n}): void {\n  postFault('bootstrap', error.code, error.expected, error.hint, error.detail);\n}\n\nasync function createRealm(init: ExecutionInitMessage): Promise<boolean> {\n  const preparedResult = await prepareBootstrapEntry(init.bootstrapUrl, init.bootstrapData);\n  if (!preparedResult.ok) {\n    postBootstrapFault(preparedResult.error);\n    return false;\n  }\n  const prepared: PreparedExecutionBootstrap = preparedResult.value;\n  const nextWorld = new World({\n    ...(init.time !== undefined ? { time: init.time } : {}),\n    storage: init.tier === 'shared' ? 'shared' : 'local',\n  });\n  const candidate: WorkerRealm = {\n    world: nextWorld,\n    init,\n    pendingAudioIntents: [],\n    kernelPool: undefined,\n    pluginContext: undefined,\n  };\n  const audioBackend = createAudioIntentBackend({\n    emit: (intent) => candidate.pendingAudioIntents.push(intent),\n  });\n  let candidateRenderer: Renderer | undefined;\n  let rendererLifecycleTransferred = false;\n  const previousRenderer = renderer;\n  let previousSurfaceReleased = false;\n  try {\n    if (previousRenderer !== undefined) {\n      const released = previousRenderer.releaseSurface();\n      if (!released.ok) throw released.error;\n      previousSurfaceReleased = true;\n    }\n    const constructed = await constructRuntimeRendererHost(\n      init.canvas,\n      prepared.features === undefined ? {} : { features: prepared.features },\n      init.shaderManifestUrl === undefined\n        ? undefined\n        : { shaderManifestUrl: init.shaderManifestUrl },\n    );\n    if (!constructed.ok) throw constructed.error;\n    candidateRenderer = constructed.value.renderer;\n    assets = constructed.value.assets;\n    rendererLifecycleTransferred = true;\n    const pluginContext = await createWorldContext(\n      nextWorld,\n      workerEngineProfile({\n        renderer: candidateRenderer,\n        rendererFeatureHost: createRenderFeatureHost(constructed.value.featureHost),\n        assets,\n        input: inputBackend,\n        audio: audioBackend,\n        animationPayloads: createAnimationPayloadLookup(assets),\n        extensions: [\n          ...(init.tier === 'shared' ? [sharedKernelPlugin(candidate)] : []),\n          executionBootstrapHostPlugin({\n            ...(init.bootstrapPort === undefined ? {} : { port: init.bootstrapPort }),\n            setPointerLockAllowed(allowed): void {\n              scope.postMessage({\n                kind: 'host-control',\n                command: 'set-pointer-lock-allowed',\n                allowed,\n              });\n            },\n          }),\n          ...(prepared.plugins ?? []),\n        ],\n      }),\n    );\n    candidate.pluginContext = pluginContext;\n    const activeRenderer = candidateRenderer;\n    const previousRealm = realm;\n    const committed = await commitAttachedWorld(candidateRenderer, nextWorld, async () => {\n      await candidate.kernelPool?.ready();\n      return true;\n    });\n    if (!committed) {\n      await disposeRealm(candidate);\n      if (previousSurfaceReleased) previousRenderer?.restoreSurface();\n      return false;\n    }\n    realm = candidate;\n    renderer = activeRenderer;\n    lastFrameId = 0;\n    if (previousRealm !== undefined) await disposeRealm(previousRealm);\n    return true;\n  } catch (cause) {\n    await disposeRealm(candidate);\n    if (!rendererLifecycleTransferred) candidateRenderer?.dispose();\n    if (previousSurfaceReleased) previousRenderer?.restoreSurface();\n    throw cause;\n  }\n}\n\nasync function initialize(message: ExecutionInitMessage): Promise<void> {\n  try {\n    engineCanvas = message.canvas;\n    if (!(await createRealm(message))) return;\n    scope.postMessage({\n      kind: 'ready',\n      worldIdentity: realm?.world.identity ?? '',\n      realm: 'worker',\n      workerWebGpu: typeof navigator === 'object' && navigator.gpu !== undefined,\n    });\n  } catch (cause) {\n    postFault(\n      'bootstrap',\n      'app-execution-bootstrap-failed',\n      'Engine Worker creates a realm-local World, Renderer and GPU owner',\n      'inspect the worker bootstrap cause and module URL',\n      cause,\n    );\n  }\n}\n\nfunction runFrame(message: ExecutionFrameMessage): void {\n  const activeRealm = realm;\n  if (activeRealm === undefined || renderer === undefined) return;\n  const { world } = activeRealm;\n  if (message.worldIdentity !== world.identity || message.frameId <= lastFrameId) return;\n  currentSample = message.inputSample;\n  const canvasWidth =\n    Number.isFinite(message.canvasWidth) && message.canvasWidth > 0\n      ? Math.max(1, Math.floor(message.canvasWidth))\n      : undefined;\n  const canvasHeight =\n    Number.isFinite(message.canvasHeight) && message.canvasHeight > 0\n      ? Math.max(1, Math.floor(message.canvasHeight))\n      : undefined;\n  if (canvasWidth !== undefined && canvasHeight !== undefined) {\n    if (engineCanvas !== undefined) {\n      if (engineCanvas.width !== canvasWidth) engineCanvas.width = canvasWidth;\n      if (engineCanvas.height !== canvasHeight) engineCanvas.height = canvasHeight;\n    }\n    syncCameraAspect(world, canvasWidth, canvasHeight);\n  }\n  const started = performance.now();\n  try {\n    const update = world.update(message.deltaSeconds);\n    if (!update.ok) throw update.error;\n    if (world.execution.health === 'poisoned') {\n      const fault = world.execution.fault;\n      postFault(\n        'world',\n        fault?.code ?? 'world-poisoned',\n        'World remains healthy through update',\n        'rebuild the poisoned World explicitly',\n        fault,\n        fault?.partialWrite ?? true,\n      );\n      return;\n    }\n    const updateFinished = performance.now();\n    const attached = renderer.attach(world);\n    if (!attached.ok) throw attached.error;\n    const draw = renderer.draw({\n      leases: [attached.value],\n      camera: { lease: attached.value },\n      environment: { lease: attached.value },\n    });\n    if (!draw.ok) throw draw.error;\n    lastFrameId = message.frameId;\n    const kernelDispatch = activeRealm.kernelPool?.takeLastDispatch() ?? null;\n    const audioIntents = activeRealm.pendingAudioIntents;\n    activeRealm.pendingAudioIntents = [];\n    scope.postMessage({\n      kind: 'frame-complete',\n      worldIdentity: world.identity,\n      frameId: message.frameId,\n      engineUpdateMs: updateFinished - started,\n      kernelWaitMs: kernelDispatch?.waitMs ?? 0,\n      ...(audioIntents.length > 0 ? { audioIntents } : {}),\n      ...(kernelDispatch !== null\n        ? {\n            kernelDispatch: {\n              eligible: true,\n              usedShared: kernelDispatch.mode === 'shared',\n              reason:\n                kernelDispatch.mode === 'shared' ? ('shared' as const) : ('forced-inline' as const),\n              dispatched: kernelDispatch.dispatched,\n              completed: kernelDispatch.completed,\n            },\n          }\n        : {}),\n    });\n  } catch (cause) {\n    const fault = world.execution.fault;\n    postFault(\n      fault === null ? 'runtime' : 'world',\n      fault?.code ?? 'app-system-update-failed',\n      'World update completes before Renderer draw',\n      fault === null ? 'inspect the runtime cause' : 'rebuild the poisoned World explicitly',\n      cause,\n      fault?.partialWrite ?? false,\n    );\n  }\n}\n\nasync function rebuild(message: ExecutionRebuildMessage): Promise<void> {\n  const activeRealm = realm;\n  if (\n    activeRealm === undefined ||\n    renderer === undefined ||\n    message.worldIdentity !== activeRealm.world.identity\n  )\n    return;\n  const previousWorldIdentity = activeRealm.world.identity;\n  try {\n    if (engineCanvas === undefined) return;\n    const init: ExecutionInitMessage = { ...activeRealm.init, canvas: engineCanvas };\n    if (!(await createRealm(init))) return;\n    scope.postMessage({\n      kind: 'rebuilt',\n      previousWorldIdentity,\n      worldIdentity: realm?.world.identity ?? '',\n    });\n  } catch (cause) {\n    postFault(\n      'rebuild',\n      'app-execution-rebuild-failed',\n      'bootstrap creates a fresh World identity',\n      'inspect the bootstrap cause or create a new App',\n      cause,\n    );\n  }\n}\n\nscope.onmessage = (event): void => {\n  const message = event.data;\n  if (message.kind === 'init') void initialize(message);\n  else if (message.kind === 'frame') runFrame(message);\n  else if (message.kind === 'rebuild') {\n    void rebuildQueue.enqueue(() => rebuild(message));\n  } else if (message.kind === 'dispose') {\n    void (async () => {\n      if (realm !== undefined) {\n        await disposeRealm(realm);\n        realm = undefined;\n      }\n      scope.close();\n    })();\n  }\n};\n"]}

package/dist/errors.d.ts

@@ -0,0 +1,254 @@
+import type { RhiError } from '@forgeax/engine-rhi/errors';
+import type { ExecutionCapabilityName, ExecutionTier } from './execution/types';
+/**
+ * Closed AppErrorCode union (12 members).
+ *
+ * | code | trigger |
+ * |:--|:--|
+ * | `'app-not-started'` | `stop()` / `pause()` / `resume()` invoked while the rAF loop is in the terminal `'idle'` or `'stopped'` state (post-device-lost terminal sink). The handle has no live frame to interrupt; AI users either call `start()` first or accept that this handle is dead and rebuild via `createApp({...})`. |
+ * | `'app-already-running'` | second `start()` invocation against an already-running handle; the call is a no-op state-machine-wise (state preserved). |
+ * | `'app-canvas-detached'` | `createApp(canvas)` thin wrapper found `canvas.isConnected === false` at entry. Detail carries optional `canvasId` so the host can surface the offending canvas in a multi-canvas page (D-2 minor). |
+ * | `'app-system-update-failed'` | World update, renderer draw, or a frame-loop callback failed; the original failure value is forwarded on `detail.cause`. `detail.systemName` is optional when the call site can name the failing owner. |
+ * | `'app-pointer-lock-failed'` | `attachInputAuto`'s `onLockError` callback received a lock failure from the input backend. `detail.path` carries `'w3c'` (W3C `requestPointerLock` rejection) or `'provider'` (host-injected `lockProvider.requestLock` throw/reject). `detail.cause` carries the original rejection value verbatim. The host recovers by remaining in unlocked state; the next trusted click will retry the lock request. |
+ *
+ * Plan-strategy D-4 locked the count at 6; device-lost rides RhiErrorCode.
+ */
+export type AppErrorCode = keyof typeof appErrorPolicy;
+/**
+ * Detail variant for the `'app-canvas-detached'` arm.
+ *
+ * `canvasId` carries an optional identifier the host can surface to AI
+ * users when multiple canvases live on the page (e.g. preview vs live
+ * canvas). `undefined` when the host did not assign an id.
+ */
+export interface AppDetailCanvasDetached {
+    readonly canvasId?: string | undefined;
+}
+/**
+ * Detail variant for the `'app-system-update-failed'` arm (plan-strategy D-4).
+ *
+ * `cause` carries the original thrown value verbatim so AI users can
+ * `cause instanceof EcsError` / `cause instanceof RhiError` narrow without
+ * losing structure. `systemName` is populated when the call site can name
+ * the offending system (input-attach cleanup path forwards
+ * `FRAME_START_SCAN_SYSTEM_NAME`).
+ */
+export interface AppDetailSystemUpdateFailed {
+    readonly cause: unknown;
+    readonly systemName?: string | undefined;
+}
+/**
+ * Detail variant for the `'app-pointer-lock-failed'` arm (plan-strategy D-4).
+ *
+ * `path` discriminates between W3C `requestPointerLock` rejections (`'w3c'`)
+ * and host-injected `lockProvider.requestLock` throw/reject (`'provider'`).
+ * `cause` carries the original rejection value verbatim so AI users can
+ * narrow further (e.g. `cause instanceof DOMException` for W3C timeout
+ * rejections).
+ */
+export interface AppDetailPointerLockFailed {
+    readonly path: 'w3c' | 'provider';
+    readonly cause: unknown;
+}
+/** Why a host-requested deterministic frame could not run. */
+export interface AppDetailFrameStepInvalid {
+    readonly state: 'idle' | 'running' | 'paused' | 'stopped';
+    readonly deltaSeconds: number;
+    readonly reason: 'state' | 'delta';
+}
+export interface AppDetailExecutionTierUnavailable {
+    readonly requestedTier: ExecutionTier;
+    readonly missingCapabilities: readonly ExecutionCapabilityName[];
+    readonly sharedEvidencePassed: boolean;
+}
+export interface AppDetailExecutionBootstrapFailed {
+    readonly phase: 'import' | 'export' | 'prepare' | 'bootstrap' | 'data';
+    readonly moduleUrl: string;
+    readonly cause: unknown;
+}
+/** Original startup failure thrown by a Cordis plugin fiber. */
+export interface AppDetailPluginActivationFailed {
+    readonly cause: unknown;
+}
+export interface AppDetailExecutionDeadlineExceeded {
+    readonly phase: 'startup' | 'handshake' | 'frame';
+    readonly timeoutMs: number;
+}
+export interface AppDetailExecutionKernelFailed {
+    readonly kernelName: string;
+    readonly worldIdentity: string;
+    readonly cause: unknown;
+    readonly partialWrite: true;
+    readonly retryable: false;
+}
+export interface AppDetailExecutionStaleWorld {
+    readonly expectedIdentity: string;
+    readonly receivedIdentity: string;
+    readonly messageKind: string;
+}
+export interface AppDetailExecutionRebuildFailed {
+    readonly worldIdentity: string | null;
+    readonly cause: unknown;
+}
+/**
+ * Empty-detail shape for the 2 codes that carry no payload
+ * (`'app-not-started'`, `'app-already-running'`).
+ *
+ * Modelled as `Readonly<Record<string, never>>` so literal builders use
+ * `{}` while still narrowing under tsc strict (no extra property allowed).
+ */
+export type AppDetailEmpty = Readonly<Record<string, never>>;
+/**
+ * Conditional resolver from `AppErrorCode` to its detail payload type.
+ *
+ * Used by the constructor signature so `new AppError({ code: 'X', ... })`
+ * narrows the `detail` parameter to the variant payload at compile time.
+ */
+export type AppErrorDetailFor<C extends AppErrorCode> = C extends 'app-canvas-detached' ? AppDetailCanvasDetached : C extends 'app-frame-step-invalid' ? AppDetailFrameStepInvalid : C extends 'app-system-update-failed' ? AppDetailSystemUpdateFailed : C extends 'app-pointer-lock-failed' ? AppDetailPointerLockFailed : C extends 'app-plugin-activation-failed' ? AppDetailPluginActivationFailed : C extends 'app-execution-tier-unavailable' ? AppDetailExecutionTierUnavailable : C extends 'app-execution-bootstrap-failed' ? AppDetailExecutionBootstrapFailed : C extends 'app-execution-deadline-exceeded' ? AppDetailExecutionDeadlineExceeded : C extends 'app-execution-kernel-failed' ? AppDetailExecutionKernelFailed : C extends 'app-execution-stale-world' ? AppDetailExecutionStaleWorld : C extends 'app-execution-rebuild-failed' ? AppDetailExecutionRebuildFailed : AppDetailEmpty;
+/**
+ * Tagged union of `.detail` payloads carried by structured AppError.
+ *
+ * Each variant maps to its `AppErrorCode` arm via `AppErrorDetailFor<C>`;
+ * the variants are unique by structural fields (`AppDetailCanvasDetached`
+ * has `canvasId`, `AppDetailSystemUpdateFailed` has `cause`, the empty
+ * shape has neither).
+ */
+export type AppErrorDetail = AppErrorDetailFor<AppErrorCode>;
+declare class AppErrorClass extends Error {
+    readonly code: AppErrorCode;
+    readonly expected: string;
+    readonly hint: string;
+    readonly detail: AppErrorDetail;
+    constructor(args: {
+        code: AppErrorCode;
+        expected: string;
+        hint: string;
+        detail: AppErrorDetail;
+    });
+}
+/**
+ * Variant intersection: an `AppErrorClass` instance whose `code` literal
+ * narrows to `C` and whose `detail` narrows to `AppErrorDetailFor<C>`. The
+ * shape lets `if (err.code === 'X')` simultaneously narrow `err.detail` to
+ * the per-code payload (charter P3 + AC-07 discriminated union).
+ */
+type AppErrorVariant<C extends AppErrorCode> = AppErrorClass & {
+    readonly code: C;
+    readonly detail: AppErrorDetailFor<C>;
+};
+/**
+ * Public AppError type — discriminated union of the policy variants.
+ *
+ * AI-user form (charter P3 explicit failure):
+ *
+ * ```ts
+ * function recover(err: AppError): string {
+ *   switch (err.code) {
+ *     case 'app-not-started':         return 'call start() first';
+ *     case 'app-already-running':     return 'state preserved; ignore';
+ *     case 'app-canvas-detached':     return `reattach ${err.detail.canvasId ?? 'canvas'}`;
+ *     case 'app-system-update-failed':
+ *       return err.detail.cause instanceof Error ? err.detail.cause.message : 'unknown';
+ *     case 'app-pointer-lock-failed':
+ *       return `lock failed (${err.detail.path}): ${err.detail.cause}`;
+ *   }
+ * }
+ * ```
+ */
+export type AppError = {
+    [C in AppErrorCode]: AppErrorVariant<C>;
+}[AppErrorCode];
+interface AppErrorConstructor {
+    new <C extends AppErrorCode>(args: {
+        code: C;
+        expected: string;
+        hint: string;
+        detail: AppErrorDetailFor<C>;
+    }): AppErrorVariant<C>;
+    readonly prototype: AppErrorClass;
+}
+/**
+ * AppError constructor — `new AppError({ code, expected, hint, detail })`.
+ *
+ * The generic `C` is inferred from the literal `code` argument, which
+ * narrows `detail` to the per-code payload (`AppErrorDetailFor<C>`) and
+ * narrows the return type to the corresponding `AppErrorVariant<C>` so the
+ * call site walks the discriminated union without manual cast.
+ *
+ * The constructor delegates to the `AppErrorClass` runtime; the typed-cast
+ * here is the ergonomic affordance for AI users (TS class declarations
+ * cannot directly express `<C> ... AppErrorVariant<C>` polymorphism).
+ */
+export declare const AppError: AppErrorConstructor;
+declare const appErrorPolicy: {
+    'app-not-started': {
+        expected: string;
+        hint: string;
+    };
+    'app-already-running': {
+        expected: string;
+        hint: string;
+    };
+    'app-canvas-detached': {
+        expected: string;
+        hint: string;
+    };
+    'app-frame-step-invalid': {
+        expected: string;
+        hint: string;
+    };
+    'app-system-update-failed': {
+        expected: string;
+        hint: string;
+    };
+    'app-pointer-lock-failed': {
+        expected: string;
+        hint: string;
+    };
+    'app-plugin-activation-failed': {
+        expected: string;
+        hint: string;
+    };
+    'app-execution-tier-unavailable': {
+        expected: string;
+        hint: string;
+    };
+    'app-execution-bootstrap-failed': {
+        expected: string;
+        hint: string;
+    };
+    'app-execution-deadline-exceeded': {
+        expected: string;
+        hint: string;
+    };
+    'app-execution-kernel-failed': {
+        expected: string;
+        hint: string;
+    };
+    'app-execution-stale-world': {
+        expected: string;
+        hint: string;
+    };
+    'app-execution-rebuild-failed': {
+        expected: string;
+        hint: string;
+    };
+};
+export declare const APP_EXPECTED: Readonly<Record<AppErrorCode, string>>;
+export declare const APP_ERROR_HINTS: Readonly<Record<AppErrorCode, string>>;
+/**
+ * Type guard for narrowing `CanvasAppError`-compatible mixed signals to AppError.
+ *
+ * The fan-out signature is `(err: CanvasAppError) => void`; AI users
+ * who want to handle only the AppError leg call `if (isAppError(err)) ...`
+ * before walking `.code`. Reverse-compatible with `instanceof AppError`
+ * (the class is exposed); the function form is provided as the
+ * canonical idiom in JSDoc / README so AI users do not need to reason
+ * about cross-realm `instanceof` quirks.
+ *
+ * The parameter accepts the complete App/RHI boundary union so callers can
+ * narrow the error without casts.
+ */
+export declare function isAppError(err: AppError | RhiError): err is AppError;
+export {};
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

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

package/dist/execution/attached-world-swap.d.ts

@@ -0,0 +1,10 @@
+import type { World } from '@forgeax/engine-ecs';
+import type { Renderer } from '@forgeax/engine-render';
+/** Serialize realm rebuilds so candidate Worlds never overlap ownership. */
+export declare class SerializedRebuildQueue {
+    private tail;
+    enqueue(action: () => Promise<void>): Promise<void>;
+}
+/** Transactionally replace one Renderer-attached World. */
+export declare function commitAttachedWorld(renderer: Pick<Renderer, 'attach'>, nextWorld: World, initializeCandidate: () => Promise<boolean>): Promise<boolean>;
+//# sourceMappingURL=attached-world-swap.d.ts.map

package/dist/execution/attached-world-swap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attached-world-swap.d.ts","sourceRoot":"","sources":["../../src/execution/attached-world-swap.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAEvD,4EAA4E;AAC5E,qBAAa,sBAAsB;IACjC,OAAO,CAAC,IAAI,CAAoC;IAEhD,OAAO,CAAC,MAAM,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;CAKpD;AAED,2DAA2D;AAC3D,wBAAsB,mBAAmB,CACvC,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,EAClC,SAAS,EAAE,KAAK,EAChB,mBAAmB,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,GAC1C,OAAO,CAAC,OAAO,CAAC,CAalB"}

package/dist/execution/bootstrap-entry.d.ts

@@ -0,0 +1,30 @@
+import type { Plugin } from '@forgeax/engine-plugin';
+import type { RenderFeature } from '@forgeax/engine-render';
+import { type Result } from '@forgeax/engine-types';
+import { type AppError as AppErrorType } from '../errors';
+import type { ExecutionBootstrapValue } from './types';
+/** Realm-local engine assembly returned by an execution bootstrap module. */
+export interface PreparedExecutionBootstrap {
+    /** Render features constructed in the realm that will own the Renderer. */
+    readonly features?: readonly RenderFeature<unknown>[];
+    /** Plugins constructed in the realm that will own the World. */
+    readonly plugins?: readonly Plugin[];
+}
+/** Realm-local Host bridge available to execution bootstrap plugins. */
+export interface ExecutionBootstrapHost {
+    readonly port?: MessagePort;
+    setPointerLockAllowed(allowed: boolean): void;
+}
+declare module '@forgeax/engine-plugin' {
+    interface EngineContextServices {
+        executionBootstrapHost: ExecutionBootstrapHost;
+    }
+}
+/** Bind the optional Host transport to the same Fiber that owns bootstrap plugins. */
+export declare function executionBootstrapHostPlugin(host: ExecutionBootstrapHost): Plugin;
+/** Default export contract for `ExecutionOptions.bootstrap`. */
+export type ExecutionBootstrapEntry = (data: ExecutionBootstrapValue | undefined) => PreparedExecutionBootstrap | Promise<PreparedExecutionBootstrap>;
+export declare function validateExecutionBootstrapData(data: ExecutionBootstrapValue | undefined, moduleUrl: string): Result<void, AppErrorType>;
+export declare function loadBootstrapEntry(moduleUrl: string): Promise<Result<ExecutionBootstrapEntry, AppErrorType>>;
+export declare function prepareBootstrapEntry(moduleUrl: string, data: ExecutionBootstrapValue | undefined): Promise<Result<PreparedExecutionBootstrap, AppErrorType>>;
+//# sourceMappingURL=bootstrap-entry.d.ts.map

package/dist/execution/bootstrap-entry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap-entry.d.ts","sourceRoot":"","sources":["../../src/execution/bootstrap-entry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAA2C,KAAK,QAAQ,IAAI,YAAY,EAAE,MAAM,WAAW,CAAC;AACnG,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,SAAS,CAAC;AAEvD,6EAA6E;AAC7E,MAAM,WAAW,0BAA0B;IACzC,2EAA2E;IAC3E,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,aAAa,CAAC,OAAO,CAAC,EAAE,CAAC;IACtD,gEAAgE;IAChE,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC;AAED,wEAAwE;AACxE,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,IAAI,CAAC,EAAE,WAAW,CAAC;IAC5B,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;CAC/C;AAED,OAAO,QAAQ,wBAAwB,CAAC;IACtC,UAAU,qBAAqB;QAC7B,sBAAsB,EAAE,sBAAsB,CAAC;KAChD;CACF;AAED,sFAAsF;AACtF,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,sBAAsB,GAAG,MAAM,CAWjF;AAED,gEAAgE;AAChE,MAAM,MAAM,uBAAuB,GAAG,CACpC,IAAI,EAAE,uBAAuB,GAAG,SAAS,KACtC,0BAA0B,GAAG,OAAO,CAAC,0BAA0B,CAAC,CAAC;AAetE,wBAAgB,8BAA8B,CAC5C,IAAI,EAAE,uBAAuB,GAAG,SAAS,EACzC,SAAS,EAAE,MAAM,GAChB,MAAM,CAAC,IAAI,EAAE,YAAY,CAAC,CAQ5B;AAED,wBAAsB,kBAAkB,CACtC,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,MAAM,CAAC,uBAAuB,EAAE,YAAY,CAAC,CAAC,CAkBxD;AAED,wBAAsB,qBAAqB,CACzC,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,uBAAuB,GAAG,SAAS,GACxC,OAAO,CAAC,MAAM,CAAC,0BAA0B,EAAE,YAAY,CAAC,CAAC,CAyB3D"}

package/dist/execution/bootstrap-url.d.ts

@@ -0,0 +1,5 @@
+import { type Result } from '@forgeax/engine-types';
+import { type AppError as AppErrorType } from '../errors';
+/** Normalize a bootstrap module before any realm probing or worker startup. */
+export declare function normalizeExecutionBootstrapUrl(bootstrap: string | URL): Result<string, AppErrorType>;
+//# sourceMappingURL=bootstrap-url.d.ts.map

package/dist/execution/bootstrap-url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap-url.d.ts","sourceRoot":"","sources":["../../src/execution/bootstrap-url.ts"],"names":[],"mappings":"AAAA,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAA2C,KAAK,QAAQ,IAAI,YAAY,EAAE,MAAM,WAAW,CAAC;AAEnG,+EAA+E;AAC/E,wBAAgB,8BAA8B,CAC5C,SAAS,EAAE,MAAM,GAAG,GAAG,GACtB,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAkB9B"}

package/dist/execution/capabilities.d.ts

@@ -0,0 +1,5 @@
+import { type ExecutionCapabilities, type ExecutionCapabilityName } from './types';
+export declare function unavailableExecutionCapabilities(reason: string): ExecutionCapabilities;
+export declare function missingExecutionCapabilities(capabilities: ExecutionCapabilities, required: readonly ExecutionCapabilityName[]): readonly ExecutionCapabilityName[];
+export declare function probeExecutionCapabilities(canvas: HTMLCanvasElement, timeoutMs?: number): Promise<ExecutionCapabilities>;
+//# sourceMappingURL=capabilities.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.d.ts","sourceRoot":"","sources":["../../src/execution/capabilities.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,qBAAqB,EAC1B,KAAK,uBAAuB,EAC7B,MAAM,SAAS,CAAC;AAEjB,wBAAgB,gCAAgC,CAAC,MAAM,EAAE,MAAM,GAAG,qBAAqB,CAItF;AAED,wBAAgB,4BAA4B,CAC1C,YAAY,EAAE,qBAAqB,EACnC,QAAQ,EAAE,SAAS,uBAAuB,EAAE,GAC3C,SAAS,uBAAuB,EAAE,CAEpC;AAiCD,wBAAsB,0BAA0B,CAC9C,MAAM,EAAE,iBAAiB,EACzB,SAAS,SAAQ,GAChB,OAAO,CAAC,qBAAqB,CAAC,CAgDhC"}

package/dist/execution/control.d.ts

@@ -0,0 +1,12 @@
+import type { AudioState } from '@forgeax/engine-audio';
+import type { ExecutionControl, ExecutionEngineHealth, ExecutionReport } from './types';
+export declare function cloneExecutionReport(report: ExecutionReport): ExecutionReport;
+export interface LocalExecutionControl extends ExecutionControl {
+    setEngineHealth(health: ExecutionEngineHealth): void;
+}
+export interface LocalExecutionReportProviders {
+    readonly audio?: () => AudioState;
+    readonly world?: () => ExecutionReport['world'];
+}
+export declare function createLocalExecutionControl(initial: ExecutionReport, providers?: LocalExecutionReportProviders): LocalExecutionControl;
+//# sourceMappingURL=control.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"control.d.ts","sourceRoot":"","sources":["../../src/execution/control.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAIxD,OAAO,KAAK,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAExF,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,eAAe,GAAG,eAAe,CAE7E;AAED,MAAM,WAAW,qBAAsB,SAAQ,gBAAgB;IAC7D,eAAe,CAAC,MAAM,EAAE,qBAAqB,GAAG,IAAI,CAAC;CACtD;AAED,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,UAAU,CAAC;IAClC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,eAAe,CAAC,OAAO,CAAC,CAAC;CACjD;AAED,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,eAAe,EACxB,SAAS,GAAE,6BAAkC,GAC5C,qBAAqB,CAyBvB"}

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

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

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

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

package/dist/execution/engine-worker.d.ts

@@ -0,0 +1,24 @@
+import { type Result } from '@forgeax/engine-types';
+import { type AppError as AppErrorType } from '../errors';
+import type { EngineToHostMessage, ExecutionReadyMessage, HostToEngineMessage } from './protocol';
+export interface EngineWorkerSession {
+    readonly worker: Worker;
+    readonly ready: ExecutionReadyMessage;
+    post(message: HostToEngineMessage, transfer?: Transferable[]): void;
+    listen(listener: (message: EngineToHostMessage) => void): () => void;
+    dispose(): void;
+}
+export interface StartEngineWorkerOptions {
+    readonly canvas: HTMLCanvasElement;
+    readonly bootstrapUrl: string;
+    readonly bootstrapData?: import('./types').ExecutionBootstrapValue;
+    readonly bootstrapPort?: MessagePort;
+    readonly assetCatalog?: import('./types').ExecutionAssetCatalog;
+    readonly shaderManifestUrl?: string;
+    readonly time?: import('@forgeax/engine-ecs').TimePolicy;
+    readonly timeoutMs: number;
+    readonly tier: import('./types').ExecutionTier;
+    readonly workerFactory?: () => Worker;
+}
+export declare function startEngineWorker(options: StartEngineWorkerOptions): Promise<Result<EngineWorkerSession, AppErrorType>>;
+//# sourceMappingURL=engine-worker.d.ts.map

package/dist/execution/engine-worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine-worker.d.ts","sourceRoot":"","sources":["../../src/execution/engine-worker.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,mBAAmB,EAGnB,qBAAqB,EACrB,mBAAmB,EACpB,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,qBAAqB,CAAC;IACtC,IAAI,CAAC,OAAO,EAAE,mBAAmB,EAAE,QAAQ,CAAC,EAAE,YAAY,EAAE,GAAG,IAAI,CAAC;IACpE,MAAM,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,mBAAmB,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IACrE,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;IACnC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,SAAS,EAAE,uBAAuB,CAAC;IACnE,QAAQ,CAAC,aAAa,CAAC,EAAE,WAAW,CAAC;IACrC,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,SAAS,EAAE,qBAAqB,CAAC;IAChE,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,qBAAqB,EAAE,UAAU,CAAC;IACzD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,OAAO,SAAS,EAAE,aAAa,CAAC;IAC/C,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,MAAM,CAAC;CACvC;AAoBD,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,MAAM,CAAC,mBAAmB,EAAE,YAAY,CAAC,CAAC,CA8GpD"}

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;AAWlB,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,CAkY7C"}