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

package/dist/load-game-errors.d.ts

@@ -0,0 +1,131 @@
+/**
+ * Closed LoadGameErrorCode union (3 members).
+ *
+ * | code | trigger |
+ * |:--|:--|
+ * | `'module-not-found'` | resolver throws an error distinguishable as module-not-found (e.g. "Cannot find module"). Detail carries `slug` so AI users can surface which game path failed. |
+ * | `'invalid-format'` | resolver returns a module without a valid native Cordis default export. Detail carries `exportKeys` so AI users can inspect the module shape. |
+ * | `'import-failed'` | resolver throws a generic Error (network error, build error, etc.) not distinguishable as module-not-found. Detail carries the original `cause` Error so AI users can chain narrow. |
+ *
+ * Plan-strategy D-3 locks the count at 3.
+ */
+export type LoadGameErrorCode = keyof typeof loadGameErrorPolicy;
+/**
+ * Detail variant for the `'module-not-found'` arm.
+ *
+ * `slug` carries the game identifier that the resolver failed to locate
+ * so AI users can surface exactly which game could not be loaded.
+ */
+export interface LoadGameDetailModuleNotFound {
+    readonly slug: string;
+}
+/**
+ * Detail variant for the `'invalid-format'` arm.
+ *
+ * `exportKeys` carries the keys of the module object returned by the
+ * resolver. AI users inspect these to understand why the native default
+ * plugin export was rejected.
+ */
+export interface LoadGameDetailInvalidFormat {
+    readonly exportKeys: string[];
+}
+/**
+ * Detail variant for the `'import-failed'` arm.
+ *
+ * `cause` carries the original thrown value verbatim so AI users can
+ * chain narrow (e.g. `cause instanceof TypeError` for network errors)
+ * without losing structure.
+ */
+export interface LoadGameDetailImportFailed {
+    readonly cause: unknown;
+}
+/**
+ * Conditional resolver from `LoadGameErrorCode` to its detail payload type.
+ */
+export type LoadGameErrorDetailFor<C extends LoadGameErrorCode> = C extends 'module-not-found' ? LoadGameDetailModuleNotFound : C extends 'invalid-format' ? LoadGameDetailInvalidFormat : LoadGameDetailImportFailed;
+/**
+ * Tagged union of `.detail` payloads carried by structured LoadGameError.
+ */
+export type LoadGameErrorDetail = LoadGameErrorDetailFor<LoadGameErrorCode>;
+declare class LoadGameErrorClass extends Error {
+    readonly code: LoadGameErrorCode;
+    readonly expected: string;
+    readonly hint: string;
+    readonly detail: LoadGameErrorDetail;
+    constructor(args: {
+        code: LoadGameErrorCode;
+        expected: string;
+        hint: string;
+        detail: LoadGameErrorDetail;
+    });
+}
+/**
+ * Variant intersection: a `LoadGameErrorClass` instance whose `code` literal
+ * narrows to `C` and whose `detail` narrows to `LoadGameErrorDetailFor<C>`.
+ */
+type LoadGameErrorVariant<C extends LoadGameErrorCode> = LoadGameErrorClass & {
+    readonly code: C;
+    readonly detail: LoadGameErrorDetailFor<C>;
+};
+/**
+ * Public LoadGameError type -- discriminated union of the 3 variants.
+ *
+ * AI-user form (charter P3 explicit failure):
+ *
+ * ```ts
+ * function recover(err: LoadGameError): string {
+ *   switch (err.code) {
+ *     case 'module-not-found': return `game not found: ${err.detail.slug}`;
+ *     case 'invalid-format':   return `bad shape, exports: ${err.detail.exportKeys.join(', ')}`;
+ *     case 'import-failed':    return err.detail.cause instanceof Error ? err.detail.cause.message : 'unknown';
+ *   }
+ * }
+ * ```
+ */
+export type LoadGameError = {
+    [C in LoadGameErrorCode]: LoadGameErrorVariant<C>;
+}[LoadGameErrorCode];
+interface LoadGameErrorConstructor {
+    new <C extends LoadGameErrorCode>(args: {
+        code: C;
+        expected: string;
+        hint: string;
+        detail: LoadGameErrorDetailFor<C>;
+    }): LoadGameErrorVariant<C>;
+    readonly prototype: LoadGameErrorClass;
+}
+/**
+ * LoadGameError constructor -- `new LoadGameError({ code, expected, hint, detail })`.
+ */
+export declare const LoadGameError: LoadGameErrorConstructor;
+declare const loadGameErrorPolicy: {
+    'module-not-found': {
+        expected: string;
+        hint: string;
+    };
+    'invalid-format': {
+        expected: string;
+        hint: string;
+    };
+    'import-failed': {
+        expected: string;
+        hint: string;
+    };
+};
+export declare const LOAD_GAME_EXPECTED: Readonly<Record<LoadGameErrorCode, string>>;
+/**
+ * `hint` table -- actionable recovery guidance per code (charter P3).
+ *
+ * 3 keys; the policy-owner proof locks the exact count, order, and values.
+ */
+export declare const LOAD_GAME_ERROR_HINTS: Readonly<Record<LoadGameErrorCode, string>>;
+/**
+ * Type guard for narrowing unknown errors to LoadGameError.
+ *
+ * AI users who catch mixed error types can call `if (isLoadGameError(e))`
+ * before walking `.code`. Uses instanceof against the internal class
+ * (the public constructor delegates to LoadGameErrorClass).
+ */
+export declare function isLoadGameError(err: unknown): err is LoadGameError;
+export {};
+//# sourceMappingURL=load-game-errors.d.ts.map

package/dist/load-game-errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-game-errors.d.ts","sourceRoot":"","sources":["../src/load-game-errors.ts"],"names":[],"mappings":"AAqCA;;;;;;;;;;GAUG;AACH,MAAM,MAAM,iBAAiB,GAAG,MAAM,OAAO,mBAAmB,CAAC;AAEjE;;;;;GAKG;AACH,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,CAAC;CAC/B;AAED;;;;;;GAMG;AACH,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,MAAM,sBAAsB,CAAC,CAAC,SAAS,iBAAiB,IAAI,CAAC,SAAS,kBAAkB,GAC1F,4BAA4B,GAC5B,CAAC,SAAS,gBAAgB,GACxB,2BAA2B,GAC3B,0BAA0B,CAAC;AAEjC;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,sBAAsB,CAAC,iBAAiB,CAAC,CAAC;AAE5E,cAAM,kBAAmB,SAAQ,KAAK;IACpC,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;IACjC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAC;gBAEzB,IAAI,EAAE;QAChB,IAAI,EAAE,iBAAiB,CAAC;QACxB,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,mBAAmB,CAAC;KAC7B;CAQF;AAED;;;GAGG;AACH,KAAK,oBAAoB,CAAC,CAAC,SAAS,iBAAiB,IAAI,kBAAkB,GAAG;IAC5E,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;IACjB,QAAQ,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAC,CAAC,CAAC;CAC5C,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,aAAa,GAAG;KACzB,CAAC,IAAI,iBAAiB,GAAG,oBAAoB,CAAC,CAAC,CAAC;CAClD,CAAC,iBAAiB,CAAC,CAAC;AAErB,UAAU,wBAAwB;IAChC,KAAK,CAAC,SAAS,iBAAiB,EAAE,IAAI,EAAE;QACtC,IAAI,EAAE,CAAC,CAAC;QACR,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,sBAAsB,CAAC,CAAC,CAAC,CAAC;KACnC,GAAG,oBAAoB,CAAC,CAAC,CAAC,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,kBAAkB,CAAC;CACxC;AAED;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,wBAC+B,CAAC;AAW5D,QAAA,MAAM,mBAAmB;;;;;;;;;;;;;CAesB,CAAC;AAEhD,eAAO,MAAM,kBAAkB,EAAE,QAAQ,CAAC,MAAM,CAAC,iBAAiB,EAAE,MAAM,CAAC,CAE3B,CAAC;AAEjD;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,EAAE,QAAQ,CAAC,MAAM,CAAC,iBAAiB,EAAE,MAAM,CAAC,CAG5B,CAAC;AAEnD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,aAAa,CAElE"}

package/dist/load-game.d.ts

@@ -0,0 +1,34 @@
+import type { Plugin } from '@forgeax/engine-plugin';
+import { type Result } from '@forgeax/engine-types';
+import { LoadGameError } from './load-game-errors';
+/**
+ * The shape of a module that the resolver returns.
+ */
+interface GameEntryModule {
+    readonly default?: unknown;
+    readonly [key: string]: unknown;
+}
+/**
+ * Resolver function signature: receives a slug (the game identifier),
+ * returns a Promise that resolves to a module object.
+ *
+ * The host (apps/preview/) injects this as a dynamic import proxy,
+ * e.g. `(slug) => import(\`../../templates/\${slug}/src/main.ts\`)`.
+ * loadGame does not hardcode any import path.
+ */
+export type GamePluginResolver = (slug: string) => Promise<GameEntryModule>;
+/**
+ * Load and validate a game template module.
+ *
+ * Returns `Result.ok<Plugin>` when the resolver returns a module
+ * whose default export is a native Cordis plugin. Returns `Result.err<LoadGameError>`
+ * with one of 3 error codes on failure.
+ *
+ * @param slug - The game identifier (e.g. 'game-default'). Passed
+ *   through to the resolver and carried in the 'module-not-found' detail.
+ * @param resolver - Async function that imports/fetches the game module.
+ *   The host owns all path resolution logic.
+ */
+export declare function loadGame(slug: string, resolver: GamePluginResolver): Promise<Result<Plugin, LoadGameError>>;
+export {};
+//# sourceMappingURL=load-game.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"load-game.d.ts","sourceRoot":"","sources":["../src/load-game.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAE7D,OAAO,EAA6C,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAE9F;;GAEG;AACH,UAAU,eAAe;IACvB,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACjC;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,eAAe,CAAC,CAAC;AAY5E;;;;;;;;;;;GAWG;AACH,wBAAsB,QAAQ,CAC5B,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,kBAAkB,GAC3B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,CA4CxC"}

package/dist/plugin-factories.d.ts

@@ -0,0 +1,3 @@
+export { inputMapPlugin } from './input-map-plugin';
+export { inputPlugin } from './input-plugin';
+//# sourceMappingURL=plugin-factories.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-factories.d.ts","sourceRoot":"","sources":["../src/plugin-factories.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/renderer-plugin.d.ts

@@ -0,0 +1,25 @@
+import type { Plugin } from '@forgeax/engine-plugin';
+import type { RenderError, Renderer, RenderFeature, RenderResult } from '@forgeax/engine-render';
+import type { RendererFeatureAssemblyHost } from '@forgeax/engine-render/internal/construct-renderer';
+export interface RenderFeatureHost {
+    installFeature(feature: RenderFeature<unknown>): Promise<RenderResult<RenderFeatureLease, RenderError>>;
+}
+export interface RenderFeatureLease {
+    release(): Promise<RenderResult<void, RenderError>>;
+}
+export declare function createRenderFeatureHost(host: RendererFeatureAssemblyHost): RenderFeatureHost;
+declare module '@forgeax/engine-plugin' {
+    interface EngineContextServices {
+        renderer?: Renderer;
+        renderFeatureHost?: RenderFeatureHost;
+    }
+}
+/** Provide the renderer without transferring its host-owned lifetime. */
+export declare function rendererPlugin(renderer: Renderer): Plugin;
+/** Provide an App/Worker-owned Renderer and release it after dependent Fibers. */
+export declare function ownedRendererPlugin(renderer: Renderer): Plugin;
+/** Provide the App-owned late RenderFeature assembly capability. */
+export declare function renderFeatureHostPlugin(host: RenderFeatureHost): Plugin;
+/** Install a producer feature under the same Cordis Fiber that owns the caller. */
+export declare function renderFeaturePlugin(feature: RenderFeature<unknown>): Plugin;
+//# sourceMappingURL=renderer-plugin.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"renderer-plugin.d.ts","sourceRoot":"","sources":["../src/renderer-plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACjG,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,oDAAoD,CAAC;AAEtG,MAAM,WAAW,iBAAiB;IAChC,cAAc,CACZ,OAAO,EAAE,aAAa,CAAC,OAAO,CAAC,GAC9B,OAAO,CAAC,YAAY,CAAC,kBAAkB,EAAE,WAAW,CAAC,CAAC,CAAC;CAC3D;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,IAAI,OAAO,CAAC,YAAY,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC;CACrD;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,2BAA2B,GAAG,iBAAiB,CAkB5F;AAED,OAAO,QAAQ,wBAAwB,CAAC;IACtC,UAAU,qBAAqB;QAC7B,QAAQ,CAAC,EAAE,QAAQ,CAAC;QACpB,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;KACvC;CACF;AAED,yEAAyE;AACzE,wBAAgB,cAAc,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAQzD;AAED,kFAAkF;AAClF,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAS9D;AAED,oEAAoE;AACpE,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,iBAAiB,GAAG,MAAM,CAQvE;AAED,mFAAmF;AACnF,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,aAAa,CAAC,OAAO,CAAC,GAAG,MAAM,CAmB3E"}

package/dist/tool-preview/bootstrap.d.ts

@@ -0,0 +1,113 @@
+import { type ArtifactRef, type PreviewArtifactManifest, type SnapshotRef, type ToolTiming } from '@forgeax/engine-tool-runtime';
+import { type Result } from '@forgeax/engine-types';
+import type { App, BundlerOptions, CreateAppOptions } from '../types';
+import { type ToolPreviewAction, type ToolPreviewRecipe, type ToolPreviewTrace } from './recipe';
+export type ToolPreviewResourceKind = 'material' | 'mesh' | 'texture' | 'vfx';
+export interface ToolPreviewResourceRequest {
+    readonly kind: ToolPreviewResourceKind;
+    readonly guid: string;
+    readonly size?: number;
+}
+export interface ToolPreviewResourceFacts {
+    readonly kind: ToolPreviewResourceKind;
+    readonly guid: string;
+    readonly asset: unknown;
+    readonly digest?: string;
+    readonly ownerFacts?: Readonly<Record<string, string | number | boolean>>;
+    readonly observation?: Readonly<Record<string, string | number | boolean | readonly number[]>>;
+}
+export interface ToolPreviewHostOptions {
+    readonly runId?: string;
+    readonly recipe: ToolPreviewRecipe;
+    readonly snapshot: SnapshotRef;
+    readonly canvas?: HTMLCanvasElement;
+    readonly root?: Document | HTMLElement;
+    readonly app?: Omit<CreateAppOptions, 'rhi'>;
+    readonly bundler?: BundlerOptions;
+    readonly resource?: ToolPreviewResourceRequest;
+    readonly prepare?: (app: App) => void | ToolPreviewResourceFacts | Promise<void | ToolPreviewResourceFacts>;
+    /** Refresh producer-owned resource facts after the bounded real frame run. */
+    readonly collectResourceFacts?: (app: App, current: ToolPreviewResourceFacts | undefined) => void | ToolPreviewResourceFacts | Promise<void | ToolPreviewResourceFacts>;
+    /** Dispose producer-owned preview attachments before the App. */
+    readonly onDispose?: (app: App) => void | Promise<void>;
+    readonly executeAction?: (action: ToolPreviewAction, app: App) => boolean | Promise<boolean>;
+}
+export interface ToolPreviewHostError {
+    readonly code: 'tool-preview-capability-unavailable' | 'tool-preview-bootstrap-failed';
+    readonly expected: string;
+    readonly hint: string;
+    readonly detail: {
+        readonly phase: string;
+        readonly cause?: unknown;
+    };
+}
+export interface ToolPreviewHost {
+    readonly app: App;
+    readonly recipe: ToolPreviewRecipe;
+    readonly trace: ToolPreviewTrace;
+    capture(): Promise<Result<ToolPreviewCaptureResult, ToolPreviewHostError>>;
+    run(): Promise<Result<ToolPreviewRunResult, ToolPreviewHostError>>;
+    dispose(): Promise<Result<void, ToolPreviewHostError>>;
+}
+export interface ToolPreviewCaptureResult {
+    readonly recipe: ToolPreviewRecipe;
+    readonly snapshot: SnapshotRef;
+    readonly trace: ToolPreviewTrace;
+    readonly captureId: string;
+    readonly actionTrace: readonly ToolPreviewAction[];
+    readonly tape: {
+        readonly runId: string;
+        readonly jsonUri: string;
+        readonly blobUri: string;
+        readonly byteLength: number;
+    };
+    readonly profile: {
+        readonly captureId: string;
+        readonly uri: string;
+    };
+    readonly capturePng: {
+        readonly uri: string;
+        readonly width: number;
+        readonly height: number;
+    };
+    readonly executeDurationMs: number;
+    readonly captureDurationMs: number;
+    readonly browserJsHeapBytes?: number;
+    readonly appErrors: readonly unknown[];
+    readonly resource?: ToolPreviewResourceFacts;
+}
+export interface ToolPreviewRunResult {
+    readonly trace: ToolPreviewTrace;
+    readonly captureId: string;
+    readonly drawCalls: number;
+    readonly committedDrawIndex: number;
+    readonly nonBlackPixels: number;
+    readonly actionTrace: readonly ToolPreviewAction[];
+    readonly tape: {
+        readonly runId: string;
+        readonly jsonUri: string;
+        readonly blobUri: string;
+        readonly byteLength: number;
+    };
+    readonly profile: {
+        readonly captureId: string;
+        readonly uri: string;
+    };
+    readonly capturePng: {
+        readonly uri: string;
+        readonly width: number;
+        readonly height: number;
+    };
+    readonly png: {
+        readonly uri: string;
+        readonly width: number;
+        readonly height: number;
+    };
+    readonly manifest: PreviewArtifactManifest;
+    readonly artifacts: readonly ArtifactRef[];
+    readonly operationTiming: ToolTiming;
+    readonly resource?: ToolPreviewResourceFacts;
+}
+export declare function replayToolPreviewCapture(capture: ToolPreviewCaptureResult): Promise<Result<ToolPreviewRunResult, ToolPreviewHostError>>;
+export declare function createToolPreviewHost(options: ToolPreviewHostOptions): Promise<Result<ToolPreviewHost, ToolPreviewHostError>>;
+//# sourceMappingURL=bootstrap.d.ts.map

package/dist/tool-preview/bootstrap.d.ts.map

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

package/dist/tool-preview/evidence.d.ts

@@ -0,0 +1,20 @@
+import { type ArtifactRef, type PreviewArtifactManifest, type PreviewArtifactRole, type SnapshotRef, type ToolRuntimeError } from '@forgeax/engine-tool-runtime';
+import { type Result } from '@forgeax/engine-types';
+import type { ToolPreviewTrace } from './recipe';
+export interface ToolPreviewEvidence {
+    readonly trace: ToolPreviewTrace;
+    readonly artifacts: readonly ArtifactRef[];
+    readonly manifest?: PreviewArtifactManifest;
+}
+export declare function joinToolPreviewEvidence(input: {
+    readonly trace: ToolPreviewTrace;
+    readonly manifest: PreviewArtifactManifest;
+    readonly required: readonly PreviewArtifactRole[];
+}): Result<ToolPreviewEvidence, ToolRuntimeError>;
+export declare function createToolPreviewEvidence(trace: ToolPreviewTrace, artifacts: readonly ArtifactRef[]): ToolPreviewEvidence;
+export declare function joinResourcePreviewEvidence(input: {
+    readonly snapshot: SnapshotRef;
+    readonly manifest: PreviewArtifactManifest;
+    readonly requiredRoles: readonly PreviewArtifactRole[];
+}): Result<PreviewArtifactManifest, ToolRuntimeError>;
+//# sourceMappingURL=evidence.d.ts.map

package/dist/tool-preview/evidence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evidence.d.ts","sourceRoot":"","sources":["../../src/tool-preview/evidence.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,WAAW,EAEhB,KAAK,uBAAuB,EAC5B,KAAK,mBAAmB,EACxB,KAAK,WAAW,EAEhB,KAAK,gBAAgB,EAEtB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAEjD,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,KAAK,EAAE,gBAAgB,CAAC;IACjC,QAAQ,CAAC,SAAS,EAAE,SAAS,WAAW,EAAE,CAAC;IAC3C,QAAQ,CAAC,QAAQ,CAAC,EAAE,uBAAuB,CAAC;CAC7C;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE;IAC7C,QAAQ,CAAC,KAAK,EAAE,gBAAgB,CAAC;IACjC,QAAQ,CAAC,QAAQ,EAAE,uBAAuB,CAAC;IAC3C,QAAQ,CAAC,QAAQ,EAAE,SAAS,mBAAmB,EAAE,CAAC;CACnD,GAAG,MAAM,CAAC,mBAAmB,EAAE,gBAAgB,CAAC,CAgBhD;AAED,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,gBAAgB,EACvB,SAAS,EAAE,SAAS,WAAW,EAAE,GAChC,mBAAmB,CAErB;AAED,wBAAgB,2BAA2B,CAAC,KAAK,EAAE;IACjD,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;IAC/B,QAAQ,CAAC,QAAQ,EAAE,uBAAuB,CAAC;IAC3C,QAAQ,CAAC,aAAa,EAAE,SAAS,mBAAmB,EAAE,CAAC;CACxD,GAAG,MAAM,CAAC,uBAAuB,EAAE,gBAAgB,CAAC,CAMpD"}

package/dist/tool-preview/framing.d.ts

@@ -0,0 +1,13 @@
+export interface ToolPreviewCameraFrame {
+    readonly center: readonly [number, number, number];
+    readonly radius: number;
+    readonly distance: number;
+    readonly near: number;
+    readonly far: number;
+}
+export declare function fitToolPreviewCameraToAabb(aabb: readonly [number, number, number, number, number, number], options: {
+    readonly aspect: number;
+    readonly fov: number;
+    readonly padding?: number;
+}): ToolPreviewCameraFrame;
+//# sourceMappingURL=framing.d.ts.map

package/dist/tool-preview/framing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"framing.d.ts","sourceRoot":"","sources":["../../src/tool-preview/framing.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACnD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAC/D,OAAO,EAAE;IAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GACpF,sBAAsB,CAwCxB"}

package/dist/tool-preview/recipe.d.ts

@@ -0,0 +1,54 @@
+import { type JsonValue } from '@forgeax/engine-tool-runtime';
+export type ToolPreviewPresentation = 'hidden' | 'visible';
+export interface ToolPreviewAction {
+    readonly frame: number;
+    readonly name: string;
+    readonly value?: JsonValue;
+}
+export interface ToolPreviewRecipe {
+    readonly backend: 'webgpu';
+    readonly presentation: ToolPreviewPresentation;
+    readonly viewport: {
+        readonly width: number;
+        readonly height: number;
+    };
+    readonly actions: readonly ToolPreviewAction[];
+    readonly deltaSeconds: number;
+    readonly frames: number;
+}
+export interface ToolPreviewRecipeOptions {
+    readonly backend?: 'webgpu' | 'rhi-null' | string;
+    readonly presentation?: ToolPreviewPresentation;
+    readonly viewport?: {
+        readonly width: number;
+        readonly height: number;
+    };
+    readonly actions?: readonly ToolPreviewAction[];
+    readonly deltaSeconds?: number;
+    readonly frames?: number;
+}
+export type ToolPreviewTraceEvent = 'canvas-created' | 'rhi-debug-armed' | 'renderer-created' | 'world-updated' | 'draw-submitted' | 'validation-complete';
+export interface ToolPreviewTrace {
+    readonly events: readonly ToolPreviewTraceEvent[];
+    readonly backend: 'webgpu' | string;
+    readonly adapter: string;
+    readonly presentation: ToolPreviewPresentation;
+}
+export type ToolPreviewTraceValidation = {
+    readonly ok: true;
+    readonly value: ToolPreviewTrace;
+} | {
+    readonly ok: false;
+    readonly error: {
+        readonly code: 'tool-preview-invalid-trace';
+        readonly expected: string;
+        readonly hint: string;
+        readonly detail: {
+            readonly missing: string;
+            readonly index: number;
+        };
+    };
+};
+export declare function createToolPreviewRecipe(options: ToolPreviewRecipeOptions): ToolPreviewRecipe;
+export declare function validateToolPreviewTrace(trace: ToolPreviewTrace): ToolPreviewTraceValidation;
+//# sourceMappingURL=recipe.d.ts.map

package/dist/tool-preview/recipe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recipe.d.ts","sourceRoot":"","sources":["../../src/tool-preview/recipe.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,KAAK,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAEnF,MAAM,MAAM,uBAAuB,GAAG,QAAQ,GAAG,SAAS,CAAC;AAE3D,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,CAAC;CAC5B;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC;IAC3B,QAAQ,CAAC,YAAY,EAAE,uBAAuB,CAAC;IAC/C,QAAQ,CAAC,QAAQ,EAAE;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IACvE,QAAQ,CAAC,OAAO,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAC/C,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,GAAG,UAAU,GAAG,MAAM,CAAC;IAClD,QAAQ,CAAC,YAAY,CAAC,EAAE,uBAAuB,CAAC;IAChD,QAAQ,CAAC,QAAQ,CAAC,EAAE;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IACxE,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAChD,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,MAAM,qBAAqB,GAC7B,gBAAgB,GAChB,iBAAiB,GACjB,kBAAkB,GAClB,eAAe,GACf,gBAAgB,GAChB,qBAAqB,CAAC;AAE1B,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,MAAM,EAAE,SAAS,qBAAqB,EAAE,CAAC;IAClD,QAAQ,CAAC,OAAO,EAAE,QAAQ,GAAG,MAAM,CAAC;IACpC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,YAAY,EAAE,uBAAuB,CAAC;CAChD;AAED,MAAM,MAAM,0BAA0B,GAClC;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,gBAAgB,CAAA;CAAE,GACvD;IACE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IACnB,QAAQ,CAAC,KAAK,EAAE;QACd,QAAQ,CAAC,IAAI,EAAE,4BAA4B,CAAC;QAC5C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,MAAM,EAAE;YAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;YAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;SAAE,CAAC;KACvE,CAAC;CACH,CAAC;AAEN,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,wBAAwB,GAAG,iBAAiB,CAyC5F;AAWD,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,gBAAgB,GAAG,0BAA0B,CA6B5F"}