@forgeax/engine-render 0.1.23 → 0.1.24

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

@@ -0,0 +1,168 @@
+import type { AssetRegistry } from '@forgeax/engine-assets-runtime';
+import type { PipelineLayout, Result, RhiDevice, ShaderModule } from '@forgeax/engine-rhi';
+import { RhiError } from '@forgeax/engine-rhi';
+import { type MaterialShaderManifestEntry, type ShaderCatalog, type ShaderCatalogDevice } from '@forgeax/engine-shader';
+import type { ParamSchemaEntry } from '@forgeax/engine-types';
+import type { RenderFeatureMaterialShaderBindingContract } from '../features/plan';
+import type { RhiErrorListenerRegistry } from '../lifecycle';
+/**
+ * Sync-shaped `ShaderCatalogDevice` adapter wrapping the backend pack's
+ * async `createShaderModule(rhiDevice, desc)`.
+ *
+ * Shape: fire-and-forget pre-bake — the first call for hash X returns
+ * `Result.err(RhiError)` (a pending signal) while kicking off the async
+ * createShaderModule + cache write; subsequent calls for the same hash hit
+ * the cache and return `Result.ok(ShaderModule)` (charter proposition 9
+ * graceful degradation).
+ *
+ * @placeholder M3 scope limit: the full async pre-bake wiring is delivered
+ * by the ECS-driven render pipeline (later closure). The current shape is
+ * already enough to support MVP-2.2 instance-per-engine + AI consumer
+ * onboarding (charter proposition 1 progressive disclosure / proposition 4
+ * explicit failure with retry guidance in the error hint).
+ */
+/**
+ * Extended ShaderCatalogDevice contract for engine internals: adds a
+ * `seedModule(label, module)` to populate the lazy adapter cache from an
+ * already-compiled module, so eager-built modules (PBR / unlit / shadow
+ * caster) and the lazy MaterialShader pipeline cache share one cache and
+ * the lazy path is hit-on-first-call (no 1-frame warmup) for engine-shipped
+ * shaders. Externally still typed as ShaderCatalogDevice (see callers in
+ * ShaderCatalog).
+ */
+export interface ShaderDeviceAdapterInternal extends ShaderCatalogDevice {
+    /**
+     * feat-20260609 R3-fixup: seed the adapter's moduleCache with an
+     * already-compiled ShaderModule under `label`. Used by the eager
+     * shadow_caster pre-bake so the lazy PSO build hit on
+     * `module-forgeax::default-shadow-caster` returns OK on frame 1.
+     */
+    seedModule(label: string, module: ShaderModule): void;
+    invalidateModule(label: string): void;
+}
+type ShaderModuleAdapterMode = 'validated' | 'immediate';
+export declare function makeShaderDeviceAdapter(rhiDevice: RhiDevice, _errorRegistry: RhiErrorListenerRegistry, asyncCreateShaderModule: ((device: RhiDevice, desc: {
+    code: string;
+    label?: string | undefined;
+}) => Promise<Result<ShaderModule, RhiError>>) | undefined, immediateCreateShaderModule: ((device: RhiDevice, desc: {
+    code: string;
+    label?: string | undefined;
+}) => Result<ShaderModule, RhiError>) | undefined, mode?: ShaderModuleAdapterMode): ShaderDeviceAdapterInternal;
+/**
+ * Fallback path for the M3 D-P4 auto-select facade when the backend pack
+ * does not supply a top-level async `createShaderModule` (e.g. the rhi-wgpu
+ * path which routes through the synchronous `device.createShaderModule`
+ * entry, or an explicit escape-hatch instance that omits the async
+ * factory). The forgeax `RhiDevice` interface intentionally does not expose
+ * a sync `createShaderModule` (fix-f3; see packages/rhi/src/index.ts line
+ * 1164), so this helper performs a structural probe + returns a structured
+ * error when neither the async factory nor a structural sync entry exists
+ * (charter proposition 4 explicit failure baseline).
+ */
+export declare function invokeDeviceCreateShaderModule(rhiDevice: RhiDevice, desc: {
+    code: string;
+    label?: string | undefined;
+}): Promise<Result<ShaderModule, RhiError>>;
+/**
+ * bug-20260601-hello-tonemap-material-register M1: prepare engine-shipped
+ * material shaders (cap gate + manifest load + registration) before the
+ * renderer is returned so that `register<MaterialAsset>` referencing an
+ * engine shader (e.g. `forgeax::default-standard-pbr`) succeeds without
+ * waiting for `renderer.initialization` (plan-strategy D-1/D-2/D-5).
+ *
+ * Failures (cap-gate insufficient, manifest-malformed, shader-not-found)
+ * throw structured `RhiError` / `ShaderError` which propagate through
+ * `createRenderer`'s synchronous reject path (D-2 structured reject).
+ */
+export declare function prepareMaterialShaders(rhiDevice: RhiDevice, getShader: () => ShaderCatalog, assets: AssetRegistry, materialShaderUvSetCounts: Map<string, number>): Promise<void>;
+/**
+ * Per-variant PipelineLayout selector (M4.5 / D-10 option A).
+ *
+ * The HDRP variant (`CLUSTER_FORWARD_AVAILABLE=true` or canonical `''`
+ * all-true when the shader declares the cluster axis) needs the 7-slot
+ * group(2) BGL chain (`hdrpPbrPipelineLayout`); URP variants
+ * (`CLUSTER_FORWARD_AVAILABLE=false` / undefined / no axis) keep the
+ * 1-slot mesh-array BGL chain (`pbrPipelineLayout`).
+ *
+ * Returns `null` only when the URP fallback layout itself is null
+ * (Camera-only / empty-manifest path). When the HDRP layout is null but
+ * URP exists, the HDRP variant gracefully falls back to URP — the WGSL
+ * resolved upstream by `findVariantByKey` is the URP variant in that
+ * case (manifest entry with all-true definesKey === '' was registered
+ * with isHdrpActive=false at boot when storage-buffer caps are absent).
+ *
+ * Pure function — exported for unit-test access (M4.5 / w35).
+ */
+/**
+ * Closed enum of pipeline-layout kinds the selector can dispatch to.
+ *
+ * `pbr` — standard PBR (1-entry mesh-array BGL).
+ * `pbr-skin` — bug-20260611-skin-pipeline-layout: 2-entry mesh-array BGL
+ *   (binding 0 meshes + binding 1 palette) for the `forgeax::pbr-skin`
+ *   material shader.
+ * `hdrp-pbr` — feat-20260609 HDRP cluster-forward variant (7-slot group(2)
+ *   BGL substituted at slot 2).
+ * `sprite-urp` — bug-20260708 M2 (c): sprite / sprite-lit shaders reuse
+ *   the URP 1-slot mesh-array BGL (they don't declare
+ *   CLUSTER_FORWARD_AVAILABLE) but their canonical all-true variant key
+ *   `''` (`SPRITE_PASS_PER_INSTANCE_REGION_VARIANT_SET`) MUST NOT trigger
+ *   the `variantSet===''` → HDRP branch of the selector. Callers
+ *   (`buildPipelineContext`) resolve `sprite-urp` from the sprite
+ *   `materialShaderId` and pass it through; the selector short-circuits
+ *   to `pbrPipelineLayout` before the HDRP check.
+ *
+ * AC-09 grep gate: the selector body (`selectPipelineLayoutForVariant`)
+ * **MUST NOT** contain literal `'forgeax::pbr-skin'` (or another
+ * shader-id literal). The caller resolves `LayoutKind` upstream and passes
+ * the structured value through (charter P4 consistent abstraction). New
+ * material-shader layouts add a `LayoutKind` member + a PipelineState slot
+ * + a switch arm here in one cut (charter P3 extensibility).
+ */
+export type LayoutKind = 'pbr' | 'pbr-skin' | 'hdrp-pbr' | 'hdrp-skin' | 'sprite-urp' | 'unlit-urp';
+export declare function isSharedMaterialUserRegionCompatible(paramSchema: readonly ParamSchemaEntry[]): boolean;
+/**
+ * Select the PBR variant that matches a fallback mesh with no COLOR_0 input.
+ * Unknown/custom material IDs may still use the legacy PBR fallback, so that
+ * path must obey the same geometry-owned vertex-color axis as registered PBR.
+ */
+export declare function selectNoColorPbrVariant(manifestEntry: MaterialShaderManifestEntry | undefined, storageBufferCapable: boolean, variantSet: string | undefined, extendedLightingShaderAvailable?: boolean, directionalPcssAvailable?: boolean, projectorAvailable?: boolean): MaterialShaderManifestEntry['variants'][number] | undefined;
+export type MaterialShaderBindingContract = RenderFeatureMaterialShaderBindingContract;
+export type MaterialShaderVertexInputContract = 'none' | 'render-material';
+export declare function resolveMaterialShaderBindingContract(source: string): MaterialShaderBindingContract;
+export declare function resolveMaterialShaderVertexInputContract(source: string): MaterialShaderVertexInputContract;
+export declare function allowsUnlitPreparedFallback(depthFormatOverride: GPUTextureFormat | null | undefined, vertexLayout: string | undefined, materialShaderId?: string): boolean;
+/**
+ * Prepared VFX draws own their vertex inputs and bind groups. A missing
+ * authored material shader is therefore retryable, but it is never safe to
+ * substitute the built-in PBR module: PBR declares mesh/instance groups that
+ * the VFX draw does not bind. Returning true keeps the feature on its
+ * structured next-frame recovery path instead of creating an invalid PSO.
+ */
+export declare function shouldDeferMissingPreparedMaterialShader(vertexLayout: string | undefined): boolean;
+export declare function selectPipelineLayoutForVariant(state: {
+    readonly pbrPipelineLayout: PipelineLayout | null;
+    readonly pbrProbePipelineLayout?: PipelineLayout | null;
+    readonly hdrpPbrPipelineLayout: PipelineLayout | null;
+    readonly hdrpProbePbrPipelineLayout?: PipelineLayout | null;
+    readonly pbrSkinPipelineLayout: PipelineLayout | null;
+    readonly pbrSkinProbePipelineLayout?: PipelineLayout | null;
+    readonly hdrpSkinPipelineLayout?: PipelineLayout | null;
+} | null, variantSet: string | undefined, layoutKind?: LayoutKind): PipelineLayout | null;
+/**
+ * Resolve a requested material variant against the actual backend capabilities.
+ * Record callers use the native-capability request; the backend-owned axes
+ * must be rewritten before the request reaches shader lookup and PSO layout
+ * selection.
+ */
+export declare function resolveMaterialShaderVariantSet(requestedVariantSet: string | undefined, variants: ReadonlyArray<{
+    readonly defines: Readonly<Record<string, boolean>>;
+}>, backendKind: RhiDevice['caps']['backendKind'], storageBuffer: boolean, maxSampledTexturesPerShaderStageOrProjectorAvailable?: number | boolean): string | undefined;
+/**
+ * Keep a single-source material on its canonical module identity. A manifest
+ * entry with no variants cannot consume a synthesized capability or geometry
+ * axis, so carrying one into the pipeline cache only creates an uncached lazy
+ * compile beside the prewarmed source module.
+ */
+export declare function normalizeMaterialShaderVariantSet(requestedVariantSet: string | undefined, manifestEntry: MaterialShaderManifestEntry | undefined): string | undefined;
+export {};
+//# sourceMappingURL=material-shader-policy.d.ts.map

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

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

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

@@ -0,0 +1,21 @@
+import type { Result, RhiDevice, ShaderModule } from '@forgeax/engine-rhi';
+import { RhiError } from '@forgeax/engine-rhi';
+import type { ShaderCatalog } from '@forgeax/engine-shader';
+type AsyncCreateShaderModule = (device: RhiDevice, desc: {
+    code: string;
+    label?: string | undefined;
+}) => Promise<Result<ShaderModule, RhiError>>;
+/**
+ * Prewarm producer-declared material shaders and all published capability
+ * variants before the first prepared frame. Variant labels mirror the lazy
+ * material pipeline adapter's module lookup contract.
+ */
+export declare function prewarmRequiredMaterialShaders({ rhiDevice, registry, asyncCreateShaderModule, requiredMaterialShaders, seedShaderModule, }: {
+    readonly rhiDevice: RhiDevice;
+    readonly registry: ShaderCatalog;
+    readonly asyncCreateShaderModule: AsyncCreateShaderModule | undefined;
+    readonly requiredMaterialShaders: readonly string[];
+    readonly seedShaderModule: (label: string, module: ShaderModule) => void;
+}): Promise<void>;
+export {};
+//# sourceMappingURL=material-shader-prewarm.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"material-shader-prewarm.d.ts","sourceRoot":"","sources":["../../src/assembly/material-shader-prewarm.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAC3E,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAK5D,KAAK,uBAAuB,GAAG,CAC7B,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;AAE7C;;;;GAIG;AACH,wBAAsB,8BAA8B,CAAC,EACnD,SAAS,EACT,QAAQ,EACR,uBAAuB,EACvB,uBAAuB,EACvB,gBAAgB,GACjB,EAAE;IACD,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;IACjC,QAAQ,CAAC,uBAAuB,EAAE,uBAAuB,GAAG,SAAS,CAAC;IACtE,QAAQ,CAAC,uBAAuB,EAAE,SAAS,MAAM,EAAE,CAAC;IACpD,QAAQ,CAAC,gBAAgB,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,KAAK,IAAI,CAAC;CAC1E,GAAG,OAAO,CAAC,IAAI,CAAC,CA0DhB"}

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"}