@forgeax/engine-render 0.1.21 → 0.1.24

package/dist/assembly/mesh-ssbo-grow.d.ts

@@ -0,0 +1,88 @@
+import { MeshSsboCapacityExceededError, MeshSsboCeilingReachedError } from '@forgeax/engine-assets-runtime';
+import type { Buffer } from '@forgeax/engine-rhi';
+export declare const INITIAL_MESH_SSBO_SLOT_COUNT = 1024;
+/**
+ * Derive a usable storage-buffer ceiling from device limits.
+ *
+ * Mirrors the `SKIN_PALETTE_MAX_BINDING_BYTES` 0/undefined floor pattern
+ * (createRenderer.ts:4070-4073): when `maxStorageBufferBindingSize` is 0 or
+ * undefined (WebKit `downlevel_webgl2_defaults`), climb the fallback chain —
+ * `maxBufferSize` → `maxUniformBufferBindingSize` → WebGPU spec floor
+ * 134217728 (128 MiB).
+ *
+ * Pure helper — no device dependency, directly testable in node.
+ */
+export declare function deriveStorageBufferCeiling(limits: Readonly<{
+    maxStorageBufferBindingSize?: number;
+    maxBufferSize?: number;
+    maxUniformBufferBindingSize?: number;
+}>): number;
+/**
+ * Mesh + material buffer wrapper carrying the inner `Buffer` handle plus
+ * the byte-size at the time of allocation. The wrapper-object identity is
+ * stable across grow events — only `.buffer` and `.sizeInBytes` are mutated
+ * in place — so `PipelineState.meshStorageBuffer` / `materialUniformBuffer`
+ * fields capture the wrapper once and survive grow events without a re-bind
+ * cycle through the public Renderer surface (research §F8 R1).
+ */
+export interface MeshSsboBufferWrapper {
+    buffer: Buffer | null;
+    sizeInBytes: number;
+}
+export declare function requireMeshSsboBuffer(wrapper: MeshSsboBufferWrapper): asserts wrapper is MeshSsboBufferWrapper & {
+    buffer: Buffer;
+};
+/** Closure-local grow state surfaced for spy assertions in unit tests. */
+export interface MeshSsboState {
+    slotCount: number;
+    mesh: MeshSsboBufferWrapper;
+    material: MeshSsboBufferWrapper;
+}
+/** `growMeshSsbo` return shape (D-5: Result-like, never throws). */
+export type MeshSsboGrowResult = {
+    readonly ok: true;
+} | {
+    readonly ok: false;
+    readonly code: 'mesh-ssbo-ceiling-reached' | 'mesh-ssbo-capacity-exceeded';
+    /** Pre-grow slotCount — the caller can render up to this many slots (degraded subset). */
+    readonly degradedToSlotCount: number;
+};
+/** Minimal device surface the grow controller needs (mocked in unit tests). */
+export interface MeshSsboGrowDevice {
+    readonly limits: {
+        readonly maxStorageBufferBindingSize: number;
+    };
+    readonly createBuffer: (descriptor: {
+        readonly label?: string;
+        readonly size: number;
+        readonly usage: number;
+        readonly mappedAtCreation?: boolean;
+    }) => Buffer;
+}
+/** Minimal error-registry surface (just `fire` — `RhiErrorListenerRegistry` matches). */
+export interface MeshSsboGrowErrorRegistry {
+    fire: (e: MeshSsboCeilingReachedError | MeshSsboCapacityExceededError) => void;
+}
+export interface MeshSsboGrowControllerInit {
+    readonly device: MeshSsboGrowDevice;
+    readonly errorRegistry: MeshSsboGrowErrorRegistry;
+    readonly initialSlotCount: number;
+    readonly perEntityStride: number;
+    readonly meshUsage: number;
+    readonly materialUsage: number;
+}
+export interface MeshSsboGrowController {
+    readonly state: MeshSsboState;
+    /** Allocate the initial mesh + material buffer pair at `initialSlotCount`. */
+    readonly initialBuild: () => void;
+    /** Grow to satisfy `neededSlots`; idempotent + ceiling-aware. */
+    readonly growMeshSsbo: (neededSlots: number) => MeshSsboGrowResult;
+}
+/**
+ * Build a closure-scoped mesh-SSBO grow controller. Module-scope so unit
+ * tests (`__tests__/mesh-ssbo-grow.test.ts`) can construct it with a fake
+ * device + spy errorRegistry without spinning up the full WebGPU renderer
+ * (charter F2 minimal surface — the controller is the testable seam).
+ */
+export declare function createMeshSsboGrowController(init: MeshSsboGrowControllerInit): MeshSsboGrowController;
+//# sourceMappingURL=mesh-ssbo-grow.d.ts.map

package/dist/assembly/mesh-ssbo-grow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mesh-ssbo-grow.d.ts","sourceRoot":"","sources":["../../src/assembly/mesh-ssbo-grow.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,6BAA6B,EAC7B,2BAA2B,EAC5B,MAAM,gCAAgC,CAAC;AACxC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAUlD,eAAO,MAAM,4BAA4B,OAAO,CAAC;AA8CjD;;;;;;;;;;GAUG;AACH,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,QAAQ,CAAC;IACf,2BAA2B,CAAC,EAAE,MAAM,CAAC;IACrC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,2BAA2B,CAAC,EAAE,MAAM,CAAC;CACtC,CAAC,GACD,MAAM,CAsBR;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,OAAO,IAAI,qBAAqB,GAAG;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,CAE/D;AAED,0EAA0E;AAC1E,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,qBAAqB,CAAC;IAC5B,QAAQ,EAAE,qBAAqB,CAAC;CACjC;AAED,oEAAoE;AACpE,MAAM,MAAM,kBAAkB,GAC1B;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAA;CAAE,GACrB;IACE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IACnB,QAAQ,CAAC,IAAI,EAAE,2BAA2B,GAAG,6BAA6B,CAAC;IAC3E,0FAA0F;IAC1F,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;CACtC,CAAC;AAEN,+EAA+E;AAC/E,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,MAAM,EAAE;QAAE,QAAQ,CAAC,2BAA2B,EAAE,MAAM,CAAA;KAAE,CAAC;IAClE,QAAQ,CAAC,YAAY,EAAE,CAAC,UAAU,EAAE;QAClC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,gBAAgB,CAAC,EAAE,OAAO,CAAC;KACrC,KAAK,MAAM,CAAC;CACd;AAED,yFAAyF;AACzF,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,CAAC,CAAC,EAAE,2BAA2B,GAAG,6BAA6B,KAAK,IAAI,CAAC;CAChF;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC;IACpC,QAAQ,CAAC,aAAa,EAAE,yBAAyB,CAAC;IAClD,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B,8EAA8E;IAC9E,QAAQ,CAAC,YAAY,EAAE,MAAM,IAAI,CAAC;IAClC,iEAAiE;IACjE,QAAQ,CAAC,YAAY,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,kBAAkB,CAAC;CACpE;AAED;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,0BAA0B,GAC/B,sBAAsB,CAuFxB"}

package/dist/assembly/recovery/device-loss-fanout.d.ts

@@ -0,0 +1,14 @@
+import type { RhiDevice } from '@forgeax/engine-rhi';
+import type { HealthListenerRegistry, LostListenerRegistry, RhiErrorListenerRegistry } from '../../lifecycle';
+import type { RhiBackendPack } from '../backend-contract';
+/** Wire one device's loss promise into the Renderer-owned observability channels. */
+export declare function attachDeviceLostFanout(device: RhiDevice, pack: RhiBackendPack, registries: {
+    lostRegistry: LostListenerRegistry;
+    errorRegistry: RhiErrorListenerRegistry;
+    healthRegistry: HealthListenerRegistry;
+    generation: number;
+    currentGeneration: () => number;
+    onStaleLoss?: () => void;
+    onDeviceLost?: (detail: string) => void;
+}): void;
+//# sourceMappingURL=device-loss-fanout.d.ts.map

package/dist/assembly/recovery/device-loss-fanout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"device-loss-fanout.d.ts","sourceRoot":"","sources":["../../../src/assembly/recovery/device-loss-fanout.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAErD,OAAO,KAAK,EACV,sBAAsB,EACtB,oBAAoB,EACpB,wBAAwB,EACzB,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D,qFAAqF;AACrF,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,SAAS,EACjB,IAAI,EAAE,cAAc,EACpB,UAAU,EAAE;IACV,YAAY,EAAE,oBAAoB,CAAC;IACnC,aAAa,EAAE,wBAAwB,CAAC;IACxC,cAAc,EAAE,sBAAsB,CAAC;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,MAAM,MAAM,CAAC;IAChC,WAAW,CAAC,EAAE,MAAM,IAAI,CAAC;IACzB,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;CACzC,GACA,IAAI,CAkEN"}

package/dist/assembly/recovery/generation.d.ts

@@ -0,0 +1,46 @@
+import { type Result } from '@forgeax/engine-types';
+import { type DeviceResourceKind, type DeviceScope, type LifecycleCleanupFailure, type LifecycleResourceSpec } from '../../device/device-scope';
+/** The private value published by one complete renderer device generation. */
+export interface GenerationAggregate<TDevice = unknown, TContext = unknown, TPipeline = unknown, TProducerBindings = unknown, TGraph = unknown> {
+    readonly generation: number;
+    readonly scope: DeviceScope;
+    readonly device: TDevice;
+    readonly context: TContext;
+    readonly pipeline: TPipeline;
+    readonly producerBindings: TProducerBindings;
+    readonly graph: TGraph | undefined;
+}
+export interface GenerationAssemblyInput<TAggregate extends GenerationAggregate = GenerationAggregate> {
+    readonly scope: TAggregate['scope'];
+    readonly device: TAggregate['device'];
+    readonly context: TAggregate['context'];
+    readonly pipeline: TAggregate['pipeline'];
+    readonly producerBindings: TAggregate['producerBindings'];
+    readonly graph?: TAggregate['graph'];
+    readonly roots: readonly LifecycleResourceSpec<unknown>[];
+}
+export interface GenerationAssemblyFailure {
+    readonly code: 'generation-assembly-failed';
+    readonly generation: number;
+    readonly resourceKind: DeviceResourceKind;
+    readonly cause: unknown;
+    readonly cleanupFailures: readonly LifecycleCleanupFailure[];
+}
+export interface GenerationPublication<TAggregate> {
+    current: TAggregate;
+}
+export interface GenerationAllocator {
+    readonly activeGeneration: number;
+    next(): number;
+}
+/**
+ * Build all device-bound roots before exposing their generation aggregate.
+ * LifecycleTransaction owns creation failure rollback; this function only
+ * projects its failure into the generation assembly boundary.
+ */
+export declare function buildGenerationAggregate<TAggregate extends GenerationAggregate = GenerationAggregate>(input: GenerationAssemblyInput<TAggregate>): Promise<Result<TAggregate, GenerationAssemblyFailure>>;
+/** Replace the owner slot only after the complete candidate has been checked. */
+export declare function publishGeneration<TAggregate>(publication: GenerationPublication<TAggregate | undefined>, candidate: TAggregate, isPublishable: (candidate: TAggregate) => boolean): void;
+/** Allocate unique candidate generations while leaving the active value unchanged. */
+export declare function createGenerationAllocator(activeGeneration: number): GenerationAllocator;
+//# sourceMappingURL=generation.d.ts.map

package/dist/assembly/recovery/generation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generation.d.ts","sourceRoot":"","sources":["../../../src/assembly/recovery/generation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EACL,KAAK,kBAAkB,EACvB,KAAK,WAAW,EAChB,KAAK,uBAAuB,EAC5B,KAAK,qBAAqB,EAE3B,MAAM,2BAA2B,CAAC;AAEnC,8EAA8E;AAC9E,MAAM,WAAW,mBAAmB,CAClC,OAAO,GAAG,OAAO,EACjB,QAAQ,GAAG,OAAO,EAClB,SAAS,GAAG,OAAO,EACnB,iBAAiB,GAAG,OAAO,EAC3B,MAAM,GAAG,OAAO;IAEhB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;IAC7B,QAAQ,CAAC,gBAAgB,EAAE,iBAAiB,CAAC;IAC7C,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;CACpC;AAED,MAAM,WAAW,uBAAuB,CACtC,UAAU,SAAS,mBAAmB,GAAG,mBAAmB;IAE5D,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC;IACpC,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC,QAAQ,CAAC,CAAC;IACtC,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC,SAAS,CAAC,CAAC;IACxC,QAAQ,CAAC,QAAQ,EAAE,UAAU,CAAC,UAAU,CAAC,CAAC;IAC1C,QAAQ,CAAC,gBAAgB,EAAE,UAAU,CAAC,kBAAkB,CAAC,CAAC;IAC1D,QAAQ,CAAC,KAAK,CAAC,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC;IACrC,QAAQ,CAAC,KAAK,EAAE,SAAS,qBAAqB,CAAC,OAAO,CAAC,EAAE,CAAC;CAC3D;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,IAAI,EAAE,4BAA4B,CAAC;IAC5C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,YAAY,EAAE,kBAAkB,CAAC;IAC1C,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,eAAe,EAAE,SAAS,uBAAuB,EAAE,CAAC;CAC9D;AAED,MAAM,WAAW,qBAAqB,CAAC,UAAU;IAC/C,OAAO,EAAE,UAAU,CAAC;CACrB;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,IAAI,IAAI,MAAM,CAAC;CAChB;AA4BD;;;;GAIG;AACH,wBAAsB,wBAAwB,CAC5C,UAAU,SAAS,mBAAmB,GAAG,mBAAmB,EAE5D,KAAK,EAAE,uBAAuB,CAAC,UAAU,CAAC,GACzC,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,yBAAyB,CAAC,CAAC,CA0BxD;AAED,iFAAiF;AACjF,wBAAgB,iBAAiB,CAAC,UAAU,EAC1C,WAAW,EAAE,qBAAqB,CAAC,UAAU,GAAG,SAAS,CAAC,EAC1D,SAAS,EAAE,UAAU,EACrB,aAAa,EAAE,CAAC,SAAS,EAAE,UAAU,KAAK,OAAO,GAChD,IAAI,CAKN;AAED,sFAAsF;AACtF,wBAAgB,yBAAyB,CAAC,gBAAgB,EAAE,MAAM,GAAG,mBAAmB,CASvF"}

package/dist/assembly/recovery/recovery-attempt.d.ts

@@ -0,0 +1,63 @@
+import { type RhiAdapter, type RhiCanvasContext, type RhiDevice, RhiError, type Texture, type TextureView } from '@forgeax/engine-rhi';
+import { type Result } from '@forgeax/engine-types';
+import type { RhiBackendPack } from '../backend-contract';
+import { type RecoveryContinuation, type RecoveryDeadline, type RecoveryPhase } from '../renderer-lifecycle';
+export declare const STANDARD_PBR_REQUIRED_SAMPLED_TEXTURES = 17;
+type ProbeFormat = 'rgba16float' | 'rgba8unorm';
+/**
+ * Prove that a freshly acquired candidate device can execute and expose one
+ * render attachment before recovery publishes it. Device creation and a
+ * successful queue.submit are not sufficient evidence: a replacement device
+ * can accept those operations while its first observable frame remains
+ * empty. This probe intentionally has no shader, asset, graph, or surface
+ * dependency, so its result cleanly separates backend readiness from renderer
+ * graph publication.
+ *
+ * The null backend is structural-only and deliberately has no CPU readback
+ * implementation; its contract is already exercised by command-shape tests.
+ */
+export declare function probeCandidateDeviceExecution(device: RhiDevice): Promise<import('@forgeax/engine-types').Result<void, RhiError>>;
+/**
+ * Exercise the actual RenderGraphBuilder/CompiledRenderGraph execution path
+ * against the candidate graph's physical color target. The graph is tiny and
+ * imported-target-only: it isolates pass resolution/encoding from the full
+ * renderer topology while preserving the exact candidate texture and view.
+ */
+export declare function probeCandidateGraphExecution(device: RhiDevice, target: {
+    readonly texture: Texture;
+    readonly view: TextureView;
+    readonly format: ProbeFormat;
+}): Promise<import('@forgeax/engine-types').Result<void, RhiError>>;
+export declare function deviceOptionsForAdapter(adapter: Pick<RhiAdapter, 'features' | 'limits'>): {
+    requiredFeatures?: GPUFeatureName[];
+    requiredLimits?: GPUDeviceDescriptor['requiredLimits'];
+} | undefined;
+export interface AcquiredDeviceGeneration {
+    readonly adapter: RhiAdapter;
+    readonly device: RhiDevice;
+    readonly context: RhiCanvasContext;
+}
+export interface DeviceGenerationAcquisitionFailure {
+    readonly stage: 'adapter' | 'device' | 'context';
+    readonly error: RhiError;
+}
+export interface RecoveryStepTimeout {
+    readonly phase: RecoveryPhase;
+    readonly elapsedMs: number;
+    readonly cause: RhiError;
+}
+export type RecoveryStepOutcome<T, E> = {
+    readonly kind: 'value';
+    readonly value: T;
+} | {
+    readonly kind: 'error';
+    readonly error: E;
+} | {
+    readonly kind: 'timeout';
+    readonly timeout: RecoveryStepTimeout;
+};
+export declare function runRecoveryStep<T, E>(operation: (continuation?: RecoveryContinuation) => Promise<Result<T, E>>, phase: RecoveryPhase, deadline: RecoveryDeadline | undefined, now?: () => number, continuation?: RecoveryContinuation): Promise<RecoveryStepOutcome<T, E>>;
+/** Acquire the same backend generation inputs for boot and recovery. */
+export declare function acquireDeviceGeneration(pack: RhiBackendPack, canvas: HTMLCanvasElement | OffscreenCanvas, deadline?: RecoveryDeadline, continuation?: RecoveryContinuation, onPhase?: (phase: RecoveryPhase) => void): Promise<Result<AcquiredDeviceGeneration, DeviceGenerationAcquisitionFailure>>;
+export {};
+//# sourceMappingURL=recovery-attempt.d.ts.map

package/dist/assembly/recovery/recovery-attempt.d.ts.map

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

package/dist/assembly/recovery/renderer-recover.d.ts

@@ -0,0 +1,115 @@
+import type { AssetRegistry, MipmapShaderModuleFactory } from '@forgeax/engine-assets-runtime';
+import { DynamicTextureStore } from '@forgeax/engine-assets-runtime';
+import type { BindGroupLayout, PipelineLayout, RenderPipeline, RhiCanvasContext, RhiDevice } from '@forgeax/engine-rhi';
+import { type Result } from '@forgeax/engine-rhi';
+import type { MaterialShaderManifestEntry, ShaderCatalog } from '@forgeax/engine-shader';
+import type { ParamSchemaEntry } from '@forgeax/engine-types';
+import { DeviceScope } from '../../device/device-scope';
+import { GpuResidencyCache } from '../../device/gpu-residency';
+import { type RecoverFailure } from '../../errors/recover';
+import type { PipelineState, RecoveryColdWorkGuard, RenderSystemInternals } from '../../record/render-context';
+import type { RecoveryGraphCandidate, RecoveryPostProcessResources, RecoveryRootBundle, RenderSystem } from '../../render-system';
+import type { RhiBackendPack } from '../backend-contract';
+import { type LayoutKind, type MaterialShaderBindingContract, type ShaderDeviceAdapterInternal } from '../material-shader-policy';
+import type { MeshSsboGrowResult, MeshSsboState } from '../mesh-ssbo-grow';
+import type { RecoveryContinuation, RecoveryDeadline, RecoveryPhase } from '../renderer-lifecycle';
+import type { RecoveryFailureLocation, WebGPURendererInternals } from '../webgpu-renderer';
+import { type GenerationAggregate } from './generation';
+type RendererShaderState = {
+    readonly device: RhiDevice;
+    shaderInstance: ShaderCatalog | null;
+    sharedShaderModuleAdapter: ShaderDeviceAdapterInternal | null;
+    sharedImmediateShaderModuleAdapter: ShaderDeviceAdapterInternal | null;
+};
+type PerShaderMaterialLayoutCacheEntry = {
+    readonly source: string;
+    readonly paramSchema: readonly ParamSchemaEntry[];
+    readonly layoutKind: LayoutKind;
+    readonly layout: {
+        materialBgl: BindGroupLayout;
+        pipelineLayout: PipelineLayout;
+    } | null;
+};
+type RendererPipelineCacheState = {
+    materialShaderPipelineCache: Map<string, RenderPipeline>;
+    materialShaderManifestEntryCache: Map<string, MaterialShaderManifestEntry>;
+    materialShaderVariantResolutionCache: WeakMap<object, Map<string, string | undefined>>;
+    group0MaterialLayout: {
+        materialBgl: BindGroupLayout;
+        pipelineLayout: PipelineLayout;
+    } | null;
+    viewOnlyMaterialPipelineLayout: PipelineLayout | null;
+    viewAndSceneDepthMaterialPipelineLayout: PipelineLayout | null;
+    group0ResourceLayouts: Map<string, {
+        materialBgl: BindGroupLayout;
+        pipelineLayout: PipelineLayout;
+    }>;
+    preparedMaterialPipelineLayoutCache: Map<string, PipelineLayout>;
+    perShaderMaterialLayoutCache: Map<string, PerShaderMaterialLayoutCacheEntry>;
+    materialShaderBindingContractCache: Map<string, {
+        source: string;
+        contract: MaterialShaderBindingContract;
+    }>;
+};
+type RendererCandidateState = {
+    readonly device: RhiDevice;
+    readonly context: RhiCanvasContext;
+    readonly scope: DeviceScope;
+    readonly gpuStore: GpuResidencyCache;
+    readonly dynamicTextureStore: DynamicTextureStore;
+    readonly shaderState: RendererShaderState;
+    readonly pipelineCacheState: RendererPipelineCacheState;
+    readonly materialShaderUvSetCounts: Map<string, number>;
+    pipelineState: PipelineState | null;
+    emptyPostProcessBgl: BindGroupLayout | null;
+    growMeshSsbo: ((neededSlots: number) => MeshSsboGrowResult) | undefined;
+    meshSsboState: MeshSsboState | undefined;
+};
+type RendererGenerationBindings = {
+    readonly gpuStore: GpuResidencyCache;
+    readonly dynamicTextureStore: DynamicTextureStore;
+    readonly shaderState: RendererShaderState;
+    readonly pipelineCacheState: RendererPipelineCacheState;
+    readonly materialShaderUvSetCounts: Map<string, number>;
+    readonly emptyPostProcessBgl: BindGroupLayout | null;
+    readonly growMeshSsbo: ((neededSlots: number) => MeshSsboGrowResult) | undefined;
+    readonly meshSsboState: MeshSsboState | undefined;
+};
+type RendererGeneration = GenerationAggregate<RhiDevice, RhiCanvasContext, PipelineState, RendererGenerationBindings, undefined>;
+export interface RendererRecoveryDependencies {
+    readonly isDisposed: () => boolean;
+    readonly internals: WebGPURendererInternals;
+    readonly getActiveDeviceScope: () => DeviceScope;
+    readonly getActiveShaderState: () => RendererShaderState;
+    readonly getMaterialShaderUvSetCounts: () => Map<string, number>;
+    readonly createRendererPipelineCacheState: () => RendererPipelineCacheState;
+    readonly getCandidateBuildState: () => RendererCandidateState | undefined;
+    readonly setCandidateBuildState: (state: RendererCandidateState | undefined) => void;
+    readonly getCandidateShaderState: () => RendererShaderState | undefined;
+    readonly setCandidateShaderState: (state: RendererShaderState | undefined) => void;
+    readonly getCandidatePipelineCacheState: () => RendererPipelineCacheState | undefined;
+    readonly setCandidatePipelineCacheState: (state: RendererPipelineCacheState | undefined) => void;
+    readonly getCandidateMaterialShaderUvSetCounts: () => Map<string, number> | undefined;
+    readonly setCandidateMaterialShaderUvSetCounts: (state: Map<string, number> | undefined) => void;
+    readonly setCandidateEmptyPostProcessBgl: (layout: BindGroupLayout | null | undefined) => void;
+    readonly getShader: () => ShaderCatalog;
+    readonly assets: AssetRegistry;
+    readonly adaptMipmapShaderModuleFactory: (factory: RhiBackendPack['createShaderModule']) => MipmapShaderModuleFactory | undefined;
+    readonly buildPipeline: (scope?: DeviceScope, device?: RhiDevice, residencyStore?: GpuResidencyCache) => Promise<PipelineState>;
+    readonly getMaterialShaderPipeline: NonNullable<RenderSystemInternals['getMaterialShaderPipeline']>;
+    readonly getMaterialShaderPipelineEntry: NonNullable<RenderSystemInternals['getMaterialShaderPipelineEntry']>;
+    readonly getCachedMaterialShaderBindingContract: NonNullable<RenderSystemInternals['getMaterialShaderBindingContract']>;
+    readonly getParamSchema: NonNullable<RenderSystemInternals['getParamSchema']>;
+    readonly getMaterialBindGroupLayout: NonNullable<RenderSystemInternals['getMaterialBindGroupLayout']>;
+    readonly metrics: RenderSystemInternals['metrics'];
+    readonly buildPostProcessPipeline: NonNullable<RenderSystemInternals['buildPostProcessPipeline']>;
+    readonly renderSystem: RenderSystem;
+    readonly createRecoveryFailureLocation: (phase: RecoveryPhase, cause: unknown, overrides?: Partial<Omit<RecoveryFailureLocation, 'phase' | 'cause'>>) => RecoveryFailureLocation;
+    readonly publishAndRetireRendererGeneration: (candidate: RendererGeneration, candidatePostProcessResources: RecoveryPostProcessResources, recoveryRootBundle: RecoveryRootBundle, recoveryGraphCandidate: RecoveryGraphCandidate | undefined, recoveryColdWorkGuard: RecoveryColdWorkGuard) => void;
+}
+export interface RendererRecovery {
+    recoverOnce(deadline: RecoveryDeadline, deadlineExpired: (phase: RecoveryPhase) => boolean, setCandidateCleanup: (cleanup: () => void) => void, continuation: RecoveryContinuation, setRecoveryPhase: (phase: RecoveryPhase) => void, onRootsCommitted: (count: number) => void, onFailure: (failure: RecoveryFailureLocation) => void): Promise<Result<void, RecoverFailure>>;
+}
+export declare function createRendererRecovery(deps: RendererRecoveryDependencies): RendererRecovery;
+export {};
+//# sourceMappingURL=renderer-recover.d.ts.map

package/dist/assembly/recovery/renderer-recover.d.ts.map

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

package/dist/assembly/renderer-facade.d.ts

@@ -0,0 +1,10 @@
+import { type RendererOperationCause } from '../errors/render';
+import type { Renderer, RenderProfile } from '../render-contract';
+import type { RendererHostImplementation } from './host-contract';
+/** Narrow the concrete host to the lease/receipt-only public contract. */
+export declare function exposeRenderer(renderer: RendererHostImplementation): Renderer;
+export declare function toError(value: unknown): Error;
+export declare function structuredRendererCause(cause: unknown, operation: string): RendererOperationCause;
+export declare function validateRenderProfile(profile: RenderProfile): string | undefined;
+export declare function freezeRenderProfile(profile: RenderProfile): RenderProfile;
+//# sourceMappingURL=renderer-facade.d.ts.map

package/dist/assembly/renderer-facade.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderer-facade.d.ts","sourceRoot":"","sources":["../../src/assembly/renderer-facade.ts"],"names":[],"mappings":"AAMA,OAAO,EAGL,KAAK,sBAAsB,EAE5B,MAAM,kBAAkB,CAAC;AAM1B,OAAO,KAAK,EACV,QAAQ,EAKR,aAAa,EAEd,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,iBAAiB,CAAC;AAGlE,0EAA0E;AAC1E,wBAAgB,cAAc,CAAC,QAAQ,EAAE,0BAA0B,GAAG,QAAQ,CAoL7E;AAMD,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,CAG7C;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,sBAAsB,CA0BjG;AA2DD,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,GAAG,SAAS,CA4BhF;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,aAAa,GAAG,aAAa,CAKzE"}

package/dist/assembly/renderer-frame-transaction.d.ts

@@ -23,7 +23,24 @@ export interface RendererFrameTransactionSteps<T> {
     readonly submit: (candidate: T) => RendererFrameStageResult<void>;
     readonly commit: (candidate: T) => void;
     readonly abort?: (failure: RendererFrameStageFailure) => void;
+    readonly generationFence?: RendererGenerationFence;
 }
+export interface RendererGenerationFence {
+    readonly capturedGeneration: number;
+    readonly currentGeneration: () => number;
+}
+export type ContinuationKind = 'readback' | 'query' | 'mapAsync' | 'queue-completion';
+export interface ContinuationTerminationReason {
+    readonly code: 'device-lost' | 'disposed' | 'stale-generation';
+    readonly detail?: unknown;
+}
+export interface ContinuationTerminator {
+    terminate(reason: ContinuationTerminationReason): boolean;
+    promise(): Promise<ContinuationTerminationReason>;
+    isTerminated(): boolean;
+    guard(kind: ContinuationKind): boolean;
+}
+export declare function createContinuationTerminator(): ContinuationTerminator;
 /**
  * Run the four renderer stages behind one commit barrier. A stage can expose
  * only a structured failure; the candidate is never published until submit

package/dist/assembly/renderer-frame-transaction.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"renderer-frame-transaction.d.ts","sourceRoot":"","sources":["../../src/assembly/renderer-frame-transaction.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,MAAM,WAAW,wBAAwB,CAAC,CAAC;IACzC,QAAQ,CAAC,SAAS,EAAE,CAAC,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,IAAI,CAAC;CAC5B;AAED,wBAAgB,kBAAkB,CAAC,CAAC,EAClC,SAAS,EAAE,CAAC,EACZ,OAAO,GAAE,MAAM,IAAsB,GACpC,wBAAwB,CAAC,CAAC,CAAC,CAe7B;AAED,MAAM,MAAM,kBAAkB,GAAG,OAAO,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE3E,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,KAAK,EAAE,kBAAkB,CAAC;CACpC;AAED,MAAM,MAAM,wBAAwB,CAAC,CAAC,IAClC;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAA;CAAE,GACxC;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,kBAAkB,CAAA;CAAE,CAAC;AAE/D,MAAM,WAAW,6BAA6B,CAAC,CAAC;IAC9C,QAAQ,CAAC,KAAK,EAAE,MAAM,wBAAwB,CAAC,CAAC,CAAC,CAAC;IAClD,QAAQ,CAAC,OAAO,EAAE,CAAC,SAAS,EAAE,CAAC,KAAK,wBAAwB,CAAC,IAAI,CAAC,CAAC;IACnE,QAAQ,CAAC,MAAM,EAAE,CAAC,SAAS,EAAE,CAAC,KAAK,wBAAwB,CAAC,IAAI,CAAC,CAAC;IAClE,QAAQ,CAAC,MAAM,EAAE,CAAC,SAAS,EAAE,CAAC,KAAK,wBAAwB,CAAC,IAAI,CAAC,CAAC;IAClE,QAAQ,CAAC,MAAM,EAAE,CAAC,SAAS,EAAE,CAAC,KAAK,IAAI,CAAC;IACxC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,yBAAyB,KAAK,IAAI,CAAC;CAC/D;AAED;;;;GAIG;AACH,wBAAgB,+BAA+B,CAAC,CAAC,EAC/C,KAAK,EAAE,6BAA6B,CAAC,CAAC,CAAC,GAErC;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAA;CAAE,GACxC;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,yBAAyB,CAAA;CAAE,CAmBpE"}
+{"version":3,"file":"renderer-frame-transaction.d.ts","sourceRoot":"","sources":["../../src/assembly/renderer-frame-transaction.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,MAAM,WAAW,wBAAwB,CAAC,CAAC;IACzC,QAAQ,CAAC,SAAS,EAAE,CAAC,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,IAAI,CAAC;CAC5B;AAED,wBAAgB,kBAAkB,CAAC,CAAC,EAClC,SAAS,EAAE,CAAC,EACZ,OAAO,GAAE,MAAM,IAAsB,GACpC,wBAAwB,CAAC,CAAC,CAAC,CAe7B;AAED,MAAM,MAAM,kBAAkB,GAAG,OAAO,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE3E,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,KAAK,EAAE,kBAAkB,CAAC;CACpC;AAED,MAAM,MAAM,wBAAwB,CAAC,CAAC,IAClC;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAA;CAAE,GACxC;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,kBAAkB,CAAA;CAAE,CAAC;AAE/D,MAAM,WAAW,6BAA6B,CAAC,CAAC;IAC9C,QAAQ,CAAC,KAAK,EAAE,MAAM,wBAAwB,CAAC,CAAC,CAAC,CAAC;IAClD,QAAQ,CAAC,OAAO,EAAE,CAAC,SAAS,EAAE,CAAC,KAAK,wBAAwB,CAAC,IAAI,CAAC,CAAC;IACnE,QAAQ,CAAC,MAAM,EAAE,CAAC,SAAS,EAAE,CAAC,KAAK,wBAAwB,CAAC,IAAI,CAAC,CAAC;IAClE,QAAQ,CAAC,MAAM,EAAE,CAAC,SAAS,EAAE,CAAC,KAAK,wBAAwB,CAAC,IAAI,CAAC,CAAC;IAClE,QAAQ,CAAC,MAAM,EAAE,CAAC,SAAS,EAAE,CAAC,KAAK,IAAI,CAAC;IACxC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,yBAAyB,KAAK,IAAI,CAAC;IAC9D,QAAQ,CAAC,eAAe,CAAC,EAAE,uBAAuB,CAAC;CACpD;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,MAAM,CAAC;CAC1C;AAED,MAAM,MAAM,gBAAgB,GAAG,UAAU,GAAG,OAAO,GAAG,UAAU,GAAG,kBAAkB,CAAC;AAEtF,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,IAAI,EAAE,aAAa,GAAG,UAAU,GAAG,kBAAkB,CAAC;IAC/D,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,sBAAsB;IACrC,SAAS,CAAC,MAAM,EAAE,6BAA6B,GAAG,OAAO,CAAC;IAC1D,OAAO,IAAI,OAAO,CAAC,6BAA6B,CAAC,CAAC;IAClD,YAAY,IAAI,OAAO,CAAC;IACxB,KAAK,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC;CACxC;AAED,wBAAgB,4BAA4B,IAAI,sBAAsB,CAiBrE;AAED;;;;GAIG;AACH,wBAAgB,+BAA+B,CAAC,CAAC,EAC/C,KAAK,EAAE,6BAA6B,CAAC,CAAC,CAAC,GAErC;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAA;CAAE,GACxC;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,yBAAyB,CAAA;CAAE,CAyBpE"}

package/dist/assembly/renderer-helpers.d.ts

@@ -0,0 +1,19 @@
+import type { Result, RhiCanvasContext, RhiDevice } from '@forgeax/engine-rhi';
+import { RhiError } from '@forgeax/engine-rhi';
+import type { RhiErrorListenerRegistry } from '../lifecycle';
+import { type PipelineState } from '../render-system';
+/** Minimum device-bound surface contract needed by lazy context configuration. */
+export interface RendererSurfaceInternals {
+    readonly device: RhiDevice;
+    readonly context: RhiCanvasContext;
+    readonly pack: {
+        readonly instrumentation?: {
+            readonly resolveSurfaceDevice?: (device: RhiDevice) => Result<RhiDevice, RhiError>;
+        };
+    };
+}
+export declare function wrapDisposeError(cause: unknown, step: string): RhiError;
+export declare function ensureContextConfigured(internals: RendererSurfaceInternals, state: PipelineState, errorRegistry: RhiErrorListenerRegistry, context?: RhiCanvasContext, device?: RhiDevice): Result<void, RhiError>;
+export declare function runShimSyncStep<T>(fn: () => Result<T, RhiError>, fallbackCode: 'shader-compile-failed' | 'webgpu-runtime-error' | 'queue-write-buffer-out-of-bounds', expected: string, hint: string): Result<T, RhiError>;
+export declare function runShimStep<T>(fn: () => Promise<Result<T, RhiError>>, fallbackCode: 'shader-compile-failed' | 'webgpu-runtime-error', expected: string, hint: string): Promise<Result<T, RhiError>>;
+//# sourceMappingURL=renderer-helpers.d.ts.map

package/dist/assembly/renderer-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderer-helpers.d.ts","sourceRoot":"","sources":["../../src/assembly/renderer-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAC/E,OAAO,EAAW,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AAC7D,OAAO,EAAoB,KAAK,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAExE,kFAAkF;AAClF,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,gBAAgB,CAAC;IACnC,QAAQ,CAAC,IAAI,EAAE;QACb,QAAQ,CAAC,eAAe,CAAC,EAAE;YACzB,QAAQ,CAAC,oBAAoB,CAAC,EAAE,CAAC,MAAM,EAAE,SAAS,KAAK,MAAM,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;SACpF,CAAC;KACH,CAAC;CACH;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,QAAQ,CAQvE;AAED,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,wBAAwB,EACnC,KAAK,EAAE,aAAa,EACpB,aAAa,EAAE,wBAAwB,EACvC,OAAO,GAAE,gBAAoC,EAC7C,MAAM,GAAE,SAA4B,GACnC,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,CAqBxB;AAED,wBAAgB,eAAe,CAAC,CAAC,EAC/B,EAAE,EAAE,MAAM,MAAM,CAAC,CAAC,EAAE,QAAQ,CAAC,EAC7B,YAAY,EACR,uBAAuB,GACvB,sBAAsB,GACtB,kCAAkC,EACtC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,GACX,MAAM,CAAC,CAAC,EAAE,QAAQ,CAAC,CAcrB;AAED,wBAAsB,WAAW,CAAC,CAAC,EACjC,EAAE,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,EACtC,YAAY,EAAE,uBAAuB,GAAG,sBAAsB,EAC9D,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAc9B"}

package/dist/assembly/renderer-lifecycle.d.ts

@@ -1,4 +1,38 @@
 import type { RendererState } from '../render-contract';
 /** Lifecycle states that may accept a new frame operation. */
 export declare function isRendererStateOperational(state: RendererState): boolean;
+export declare const RECOVERY_TOTAL_DEADLINE_MS = 20000;
+export declare const RECOVERY_ADAPTER_DEADLINE_MS = 10000;
+export declare const RECOVERY_DEVICE_DEADLINE_MS = 10000;
+export declare const RECOVERY_PHASES: readonly ["quiesce", "acquire-adapter", "acquire-device", "rehydrate", "compile-graph", "publish", "cleanup"];
+export type RecoveryPhase = (typeof RECOVERY_PHASES)[number];
+export type RecoveryGuidance = 'retry' | 'repair-owner' | 'rebuild-renderer';
+export interface RendererLifecycle {
+    state(): RendererState;
+    transition(next: RendererState): boolean;
+    states(): readonly RendererState[];
+}
+export declare function createRendererLifecycle(initial?: RendererState): RendererLifecycle;
+export interface RecoveryDeadline {
+    readonly startedAt: number;
+    readonly totalDeadlineMs: number;
+    readonly adapterDeadlineMs: number;
+    readonly deviceDeadlineMs: number;
+    readonly deadlineAt: number;
+    beginDeviceAcquisition(now: number): void;
+    isValid(phase: RecoveryPhase, now: number): boolean;
+    elapsed(now: number): number;
+}
+export declare function createRecoveryDeadline(startedAt: number): RecoveryDeadline;
+export interface RecoveryContinuation {
+    isValid(phase: RecoveryPhase, now: number): boolean;
+    abandon(now: number): void;
+    cleanupOnce(): void;
+}
+export declare function createRecoveryContinuation(deadline: RecoveryDeadline, cleanup: () => void): RecoveryContinuation;
+export interface SingleFlight<T> {
+    run(): Promise<T>;
+    inFlight(): Promise<T> | undefined;
+}
+export declare function createSingleFlight<T>(factory: () => Promise<T>): SingleFlight<T>;
 //# sourceMappingURL=renderer-lifecycle.d.ts.map

package/dist/assembly/renderer-lifecycle.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"renderer-lifecycle.d.ts","sourceRoot":"","sources":["../../src/assembly/renderer-lifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD,8DAA8D;AAC9D,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAExE"}
+{"version":3,"file":"renderer-lifecycle.d.ts","sourceRoot":"","sources":["../../src/assembly/renderer-lifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD,8DAA8D;AAC9D,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAExE;AAED,eAAO,MAAM,0BAA0B,QAAS,CAAC;AACjD,eAAO,MAAM,4BAA4B,QAAS,CAAC;AACnD,eAAO,MAAM,2BAA2B,QAAS,CAAC;AAElD,eAAO,MAAM,eAAe,+GAQlB,CAAC;AAEX,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAC7D,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,cAAc,GAAG,kBAAkB,CAAC;AAkB7E,MAAM,WAAW,iBAAiB;IAChC,KAAK,IAAI,aAAa,CAAC;IACvB,UAAU,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC;IACzC,MAAM,IAAI,SAAS,aAAa,EAAE,CAAC;CACpC;AAED,wBAAgB,uBAAuB,CAAC,OAAO,GAAE,aAAuB,GAAG,iBAAiB,CAc3F;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1C,OAAO,CAAC,KAAK,EAAE,aAAa,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IACpD,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;CAC9B;AAED,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,gBAAgB,CA4B1E;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,CAAC,KAAK,EAAE,aAAa,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IACpD,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,WAAW,IAAI,IAAI,CAAC;CACrB;AAED,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,gBAAgB,EAC1B,OAAO,EAAE,MAAM,IAAI,GAClB,oBAAoB,CAqBtB;AAED,MAAM,WAAW,YAAY,CAAC,CAAC;IAC7B,GAAG,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC;IAClB,QAAQ,IAAI,OAAO,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC;CACpC;AAED,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,CAwBhF"}

package/dist/assembly/shader-prewarm-policy.d.ts

@@ -0,0 +1,15 @@
+import type { Result, RhiError, ShaderModule } from '@forgeax/engine-rhi';
+import { type MaterialShaderManifestEntry } from '@forgeax/engine-shader';
+/** Minimum sampled-texture limit needed by Standard transmission variants. */
+export declare const STANDARD_PBR_REQUIRED_SAMPLED_TEXTURES = 17;
+/** Select HDRP variants that must be seeded during ready-state construction. */
+export declare function selectHdrpPbrPrewarmVariants(manifestEntry: MaterialShaderManifestEntry | undefined, storageBufferCapable: boolean, extendedLightingShaderAvailableOrTransmissionCapable?: boolean, transmissionCapable?: boolean, directionalPcssAvailable?: boolean, projectorAvailable?: boolean): readonly MaterialShaderManifestEntry['variants'][number][];
+/** Return every active-capability pbr-skin variant used by URP and HDRP draws. */
+export declare function selectSkinPrewarmVariants(manifestEntry: MaterialShaderManifestEntry | undefined, storageBufferCapable: boolean): readonly MaterialShaderManifestEntry['variants'][number][];
+/** Select probe-enabled material modules for recovery candidate prewarming. */
+export declare function selectProbePrewarmVariants(manifestEntry: MaterialShaderManifestEntry | undefined, storageBufferCapable: boolean, extendedLightingShaderAvailable?: boolean, transmissionCapable?: boolean, directionalPcssAvailable?: boolean, projectorAvailable?: boolean, webgl2Downlevel?: boolean): readonly MaterialShaderManifestEntry['variants'][number][];
+/** Compile and seed a selected material-shader variant set without duplicate modules. */
+export declare function prewarmMaterialShaderVariants(variants: readonly MaterialShaderManifestEntry['variants'][number][], prewarmedModules: Map<string, ShaderModule>, compile: (variant: MaterialShaderManifestEntry['variants'][number], moduleLabel: string) => Promise<Result<ShaderModule, RhiError>>, seed: (moduleLabel: string, module: ShaderModule) => void): Promise<void>;
+/** Select the declared Standard URP transmission variants for exact prewarm. */
+export declare function selectStandardPbrTransmissionPrewarmVariants(manifestEntry: MaterialShaderManifestEntry | undefined, storageBufferCapable: boolean, directionalPcssAvailable?: boolean, projectorAvailable?: boolean, extendedLightingShaderAvailable?: boolean): readonly MaterialShaderManifestEntry['variants'][number][];
+//# sourceMappingURL=shader-prewarm-policy.d.ts.map

package/dist/assembly/shader-prewarm-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shader-prewarm-policy.d.ts","sourceRoot":"","sources":["../../src/assembly/shader-prewarm-policy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAC1E,OAAO,EAAoB,KAAK,2BAA2B,EAAE,MAAM,wBAAwB,CAAC;AAE5F,8EAA8E;AAC9E,eAAO,MAAM,sCAAsC,KAAK,CAAC;AAEzD,gFAAgF;AAChF,wBAAgB,4BAA4B,CAC1C,aAAa,EAAE,2BAA2B,GAAG,SAAS,EACtD,oBAAoB,EAAE,OAAO,EAC7B,oDAAoD,UAAO,EAC3D,mBAAmB,UAAO,EAC1B,wBAAwB,UAAO,EAC/B,kBAAkB,GAAE,OAAc,GACjC,SAAS,2BAA2B,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,EAAE,CA2B5D;AAED,kFAAkF;AAClF,wBAAgB,yBAAyB,CACvC,aAAa,EAAE,2BAA2B,GAAG,SAAS,EACtD,oBAAoB,EAAE,OAAO,GAC5B,SAAS,2BAA2B,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,EAAE,CAS5D;AAED,+EAA+E;AAC/E,wBAAgB,0BAA0B,CACxC,aAAa,EAAE,2BAA2B,GAAG,SAAS,EACtD,oBAAoB,EAAE,OAAO,EAC7B,+BAA+B,UAAO,EACtC,mBAAmB,UAAO,EAC1B,wBAAwB,UAAO,EAC/B,kBAAkB,GAAE,OAAc,EAClC,eAAe,UAAQ,GACtB,SAAS,2BAA2B,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,EAAE,CAmB5D;AAED,yFAAyF;AACzF,wBAAsB,6BAA6B,CACjD,QAAQ,EAAE,SAAS,2BAA2B,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,EAAE,EACpE,gBAAgB,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,EAC3C,OAAO,EAAE,CACP,OAAO,EAAE,2BAA2B,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,EACxD,WAAW,EAAE,MAAM,KAChB,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC,EAC5C,IAAI,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,KAAK,IAAI,GACxD,OAAO,CAAC,IAAI,CAAC,CAYf;AAED,gFAAgF;AAChF,wBAAgB,4CAA4C,CAC1D,aAAa,EAAE,2BAA2B,GAAG,SAAS,EACtD,oBAAoB,EAAE,OAAO,EAC7B,wBAAwB,UAAO,EAC/B,kBAAkB,GAAE,OAAc,EAClC,+BAA+B,UAAO,GACrC,SAAS,2BAA2B,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,EAAE,CAkC5D"}

package/dist/assembly/webgpu-ready-contract.d.ts

@@ -0,0 +1,9 @@
+/** Generation-scoped buffer and attachment constants used by the ready builder. */
+export declare const VIEW_UBO_BYTES: number;
+export declare const MIPMAP_PREWARM_FORMATS: readonly GPUTextureFormat[];
+export declare const BRIGHT_PARAMS_BYTES = 16;
+export declare const BLUR_PARAMS_BYTES = 16;
+export declare const COMPOSITE_PARAMS_BYTES = 16;
+export declare const HDR_COLOR_ATTACHMENT_FORMAT: GPUTextureFormat;
+export declare const DEPTH_TEXTURE_FORMAT: GPUTextureFormat;
+//# sourceMappingURL=webgpu-ready-contract.d.ts.map

package/dist/assembly/webgpu-ready-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webgpu-ready-contract.d.ts","sourceRoot":"","sources":["../../src/assembly/webgpu-ready-contract.ts"],"names":[],"mappings":"AAEA,mFAAmF;AACnF,eAAO,MAAM,cAAc,QAA2B,CAAC;AACvD,eAAO,MAAM,sBAAsB,EAAE,SAAS,gBAAgB,EAI7D,CAAC;AACF,eAAO,MAAM,mBAAmB,KAAK,CAAC;AACtC,eAAO,MAAM,iBAAiB,KAAK,CAAC;AACpC,eAAO,MAAM,sBAAsB,KAAK,CAAC;AACzC,eAAO,MAAM,2BAA2B,EAAE,gBAAgC,CAAC;AAC3E,eAAO,MAAM,oBAAoB,EAAE,gBAAyC,CAAC"}

package/dist/assembly/webgpu-ready.d.ts

@@ -0,0 +1,55 @@
+import type { RenderPipeline, Result, RhiDevice, ShaderModule } from '@forgeax/engine-rhi';
+import { RhiError } from '@forgeax/engine-rhi';
+import { type ShaderCatalog } from '@forgeax/engine-shader';
+export type { MaterialShaderManifestEntry } from '@forgeax/engine-shader';
+import type { GpuResidencyCache } from '../device/gpu-residency';
+import type { DeviceScope, RhiErrorListenerRegistry } from '../lifecycle';
+import { type PipelineGroup2Contract } from '../pbr-pipeline';
+import { type VolumetricFogShaderSources } from '../render-contract';
+import { type PipelineState } from '../render-system';
+import { type MeshSsboGrowResult, type MeshSsboState } from './mesh-ssbo-grow';
+/**
+ * Build the `Renderer.initialization` Promise (D-S3 three-step strict-serial chain).
+ *
+ * Steps run in order; each rejection short-circuits the chain and the
+ * resulting Promise rejects with a structured `RhiError` / `ShaderError`.
+ * AI users `await renderer.initialization` once before the first `draw(world)` call;
+ * subsequent frames may skip the await (the Promise stays resolved).
+ *
+ * Step 1 (manifest load): `shader.loadManifest()` populates the runtime
+ * registry. Failure = `ShaderError 'manifest-malformed'` /
+ * `'shader-not-found'`.
+ *
+ * Step 2 (pipeline compile): synthesises the PBR pipeline (3 BindGroupLayout
+ * + 1 PipelineLayout + 1 ShaderModule + 1 RenderPipeline). Failure =
+ * `RhiError 'shader-compile-failed'` / `'feature-not-enabled'` /
+ * `'limit-exceeded'`.
+ *
+ * Step 3 (asset upload): allocates GPU buffers for the builtin cube and
+ * triangle meshes via `device.createBuffer` + `queue.writeBuffer`. Failure
+ * = `RhiError 'limit-exceeded'` / `'webgpu-runtime-error'` /
+ * `'queue-write-buffer-out-of-bounds'`.
+ */
+export declare function buildReadyWebGPU(rhiDevice: RhiDevice, rendererScope: DeviceScope, getShader: () => ShaderCatalog, gpuStore: GpuResidencyCache, asyncCreateShaderModule: ((device: RhiDevice, desc: {
+    code: string;
+    label?: string | undefined;
+}) => Promise<Result<ShaderModule, RhiError>>) | undefined, errorRegistry: RhiErrorListenerRegistry, 
+/**
+ * Material shader modules declared by producer features. These are compiled
+ * during Renderer.initialization so prepared graphics do not fail on their first
+ * frame while the shared async shader adapter is still warming up.
+ */
+requiredMaterialShaders: readonly string[], 
+/** Fullscreen feature modules compiled before the first synchronous frame. */
+requiredFullscreenPostProcesses: readonly {
+    readonly identity: string;
+    readonly source: string;
+}[], setGrowMeshSsboHook: (hook: (neededSlots: number) => MeshSsboGrowResult, state: MeshSsboState) => void, seedShaderModule: (label: string, module: ShaderModule) => void, seedMaterialShaderPipelineCache: (key: string, pso: RenderPipeline, group2Contract: PipelineGroup2Contract) => void, registerBuiltinTonemap: (source: string) => void, 
+/** Register the special FXAA pass' final-output policy params UBO. */
+registerBuiltinFxaa: (source: string) => void, registerBuiltinTemporalPostProcesses: (entries: {
+    readonly motionBlur?: string;
+    readonly taaResolve?: string;
+}) => void, 
+/** Install manifest-owned volume utility sources only after all four modules compile. */
+setVolumetricFogShaderSources: (sources: VolumetricFogShaderSources) => void): Promise<PipelineState>;
+//# sourceMappingURL=webgpu-ready.d.ts.map

package/dist/assembly/webgpu-ready.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webgpu-ready.d.ts","sourceRoot":"","sources":["../../src/assembly/webgpu-ready.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAKV,cAAc,EACd,MAAM,EACN,SAAS,EAET,YAAY,EACb,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAM,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAoB,KAAK,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAI9E,YAAY,EAAE,2BAA2B,EAAE,MAAM,wBAAwB,CAAC;AAE1E,OAAO,KAAK,EAAE,iBAAiB,EAAkB,MAAM,yBAAyB,CAAC;AAwBjF,OAAO,KAAK,EAAE,WAAW,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AAE1E,OAAO,EAIL,KAAK,sBAAsB,EAE5B,MAAM,iBAAiB,CAAC;AAmBzB,OAAO,EAEL,KAAK,0BAA0B,EAChC,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAEL,KAAK,aAAa,EAEnB,MAAM,kBAAkB,CAAC;AAQ1B,OAAO,EAIL,KAAK,kBAAkB,EACvB,KAAK,aAAa,EAEnB,MAAM,kBAAkB,CAAC;AAkB1B;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,gBAAgB,CACpC,SAAS,EAAE,SAAS,EACpB,aAAa,EAAE,WAAW,EAC1B,SAAS,EAAE,MAAM,aAAa,EAC9B,QAAQ,EAAE,iBAAiB,EAC3B,uBAAuB,EACnB,CAAC,CACC,MAAM,EAAE,SAAS,EACjB,IAAI,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,KAC/C,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC,CAAC,GAC7C,SAAS,EACb,aAAa,EAAE,wBAAwB;AACvC;;;;GAIG;AACH,uBAAuB,EAAE,SAAS,MAAM,EAAE;AAC1C,8EAA8E;AAC9E,+BAA+B,EAAE,SAAS;IACxC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB,EAAE,EAUH,mBAAmB,EAAE,CACnB,IAAI,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,kBAAkB,EACjD,KAAK,EAAE,aAAa,KACjB,IAAI,EAQT,gBAAgB,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,KAAK,IAAI,EAQ/D,+BAA+B,EAAE,CAC/B,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,cAAc,EACnB,cAAc,EAAE,sBAAsB,KACnC,IAAI,EAST,sBAAsB,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI;AAChD,sEAAsE;AACtE,mBAAmB,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,EAC7C,oCAAoC,EAAE,CAAC,OAAO,EAAE;IAC9C,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B,KAAK,IAAI;AACV,yFAAyF;AACzF,6BAA6B,EAAE,CAAC,OAAO,EAAE,0BAA0B,KAAK,IAAI,GAC3E,OAAO,CAAC,aAAa,CAAC,CAoxHxB"}