@forgeax/engine-render 0.1.33 → 0.1.35

package/dist/instance-buffer-cache.d.ts

@@ -7,15 +7,15 @@ import type { GpuBuffer } from './gpu-resource';
  * and routes dispose through the RHI shim's destroy bookkeeping SSOT. The
  * two `uploaded*` fields are the cache invalidation fingerprint -- when the
  * archetype version bumps or the byte length changes, the record stage
- * allocates a fresh GpuBuffer and replaces the entry. Explicit collection
- * entries are keyed by renderer-owned collection id at the outer map; the
- * legacy entity key remains only for sprite/fold snapshots.
+ * allocates a fresh GpuBuffer and replaces the entry. World-authored Instances
+ * use renderer-private projection identity; sprite/fold snapshots use entity
+ * identity. Neither cache key is an authoring handle.
  */
 export interface InstanceBufferCacheEntry {
     readonly buffer: GpuBuffer;
     readonly uploadedByteLength: number;
     readonly uploadedArchVersion: number;
-    /** Renderer-owned collection revision uploaded into this buffer. */
+    /** Accepted instance-projection revision uploaded into this buffer. */
     readonly uploadedRevision?: number;
 }
 /**

package/dist/instance-buffer-cache.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"instance-buffer-cache.d.ts","sourceRoot":"","sources":["../src/instance-buffer-cache.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,oEAAoE;IACpE,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;CACpC;AAaD;;;GAGG;AACH,MAAM,WAAW,4BAA4B;IAC3C,IAAI,CAAC,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CACjC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,GAAG,CAAC,MAAM,EAAE,wBAAwB,CAAC,EAC1C,aAAa,CAAC,EAAE,4BAA4B,GAC3C,IAAI,CAGN;AAED,iFAAiF;AACjF,wBAAgB,2BAA2B,CACzC,GAAG,EAAE,GAAG,CAAC,MAAM,EAAE,wBAAwB,CAAC,EAC1C,aAAa,CAAC,EAAE,4BAA4B,GAC3C,IAAI,CAGN;AAED,kFAAkF;AAClF,wBAAgB,+BAA+B,CAC7C,OAAO,EAAE,wBAAwB,EAAE,EACnC,aAAa,CAAC,EAAE,4BAA4B,GAC3C,IAAI,CAGN"}
+{"version":3,"file":"instance-buffer-cache.d.ts","sourceRoot":"","sources":["../src/instance-buffer-cache.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,uEAAuE;IACvE,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;CACpC;AAaD;;;GAGG;AACH,MAAM,WAAW,4BAA4B;IAC3C,IAAI,CAAC,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CACjC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,GAAG,CAAC,MAAM,EAAE,wBAAwB,CAAC,EAC1C,aAAa,CAAC,EAAE,4BAA4B,GAC3C,IAAI,CAGN;AAED,iFAAiF;AACjF,wBAAgB,2BAA2B,CACzC,GAAG,EAAE,GAAG,CAAC,MAAM,EAAE,wBAAwB,CAAC,EAC1C,aAAa,CAAC,EAAE,4BAA4B,GAC3C,IAAI,CAGN;AAED,kFAAkF;AAClF,wBAAgB,+BAA+B,CAC7C,OAAO,EAAE,wBAAwB,EAAE,EACnC,aAAa,CAAC,EAAE,4BAA4B,GAC3C,IAAI,CAGN"}

package/dist/instances.d.ts

@@ -1,42 +1,25 @@
+import { InstanceTransformsStrideMismatchError } from '@forgeax/engine-ecs/projection';
 import type { RhiErrorCode } from '@forgeax/engine-rhi';
-import { type Result } from '@forgeax/engine-types';
+/** Renderer projection identity; never stored in a World or SceneAsset. */
 export type InstanceCollectionId = number & {
     readonly __forgeaxInstanceCollectionId: unique symbol;
 };
-export interface InstanceCollectionData {
+export interface InstanceCollectionInfo {
     readonly collectionId: InstanceCollectionId;
-}
-export interface InstanceCollectionInfo extends InstanceCollectionData {
     readonly count: number;
-    readonly capacity: number;
     readonly revision: number;
 }
 export interface InstanceDirtyRange {
     start: number;
     end: number;
 }
-/**
- * Choose the ranges that initialize one resident GPU allocation.
- *
- * A cache miss is not a delta upload: recovery, reassociation, and any other
- * new resident has uninitialized device memory. The canonical collection must
- * therefore be copied in full even when the current authoring revision only
- * records a partial dirty range. Existing residents keep the narrower ranges.
- */
-export declare function instanceUploadRangesForResident(activeIsNew: boolean, dirtyRanges: readonly InstanceDirtyRange[], fullRange: InstanceDirtyRange): readonly InstanceDirtyRange[];
 export interface InstanceCollectionSnapshot extends InstanceCollectionInfo {
     readonly transforms: Float32Array;
-    /** Unique identity generations that travel with an instance through reorder. */
     readonly generations: Uint32Array;
-    readonly dirtyRanges: readonly InstanceDirtyRange[];
 }
-/** The renderer-owned submission lane selected for one collection. */
 export type InstanceSubmissionLane = 'unresident' | 'direct-storage' | 'chunked-storage' | 'direct-uniform' | 'chunked-uniform' | 'unavailable';
-/** Backend identity carried by collection residency and failure facts. */
 export type InstanceBackendKind = 'webgpu' | 'wgpu-native' | 'wgpu-webgl2' | 'null' | 'unknown';
-/** Closed record-stage failure vocabulary for collection residency. */
 export type InstanceCollectionFailureCode = RhiErrorCode | 'queue-write-buffer-failed';
-/** Typed producer facts retained when a collection cannot be admitted. */
 export interface InstanceCollectionFailureFacts {
     readonly requestedBytes: number;
     readonly supportedBytes: number | undefined;
@@ -45,11 +28,9 @@ export interface InstanceCollectionFailureFacts {
     readonly cause: string;
     readonly recovery: string;
 }
-/** Detached, bounded collection evidence exposed by Renderer.inspect(). */
 export interface InstanceCollectionInspection extends InstanceCollectionInfo {
     readonly residentGeneration: number | undefined;
     readonly lane: InstanceSubmissionLane;
-    readonly dirtyRanges: readonly InstanceDirtyRange[];
     readonly uploadRanges: readonly InstanceDirtyRange[];
     readonly uploadedBytes: number;
     readonly requestedBytes: number;
@@ -63,74 +44,56 @@ export interface InstanceCollectionInspection extends InstanceCollectionInfo {
         readonly detail: InstanceCollectionFailureFacts;
     } | undefined;
 }
-export interface InstanceCollectionCreateInput {
-    readonly transforms: Float32Array;
-}
-export interface InstanceCollectionUpdateInput {
-    /** Matrix ordinal of the first matrix to replace. */
-    readonly start: number;
-    readonly transforms: Float32Array;
-}
-export interface InstanceCollectionInvalidDetail {
-    readonly collectionId?: number;
-    readonly operation: 'create' | 'replace' | 'update' | 'inspect' | 'release';
-    readonly expected: string;
-    readonly actual: number | string;
+export declare class InstanceTransformsError extends Error {
+    readonly detail: {
+        readonly actualLength: number;
+        readonly nonFiniteIndex?: number;
+    };
+    readonly code: "instance-transforms-invalid";
+    readonly expected = "finite column-major mat4 values, with transforms.length a multiple of 16";
+    readonly hint = "repair Instances.transforms in the World or source SceneAsset and retry";
+    constructor(detail: {
+        readonly actualLength: number;
+        readonly nonFiniteIndex?: number;
+    });
 }
-export type InstanceCollectionErrorCode = 'instance-collection-invalid' | 'instance-collection-not-found' | 'instance-collection-released';
-export declare class InstanceCollectionError extends Error {
-    readonly code: InstanceCollectionErrorCode;
-    readonly expected: string;
-    readonly hint: string;
-    readonly detail: InstanceCollectionInvalidDetail | undefined;
-    readonly owner: "renderer.instances";
-    readonly recovery: string;
-    readonly facts: InstanceCollectionFailureFacts;
-    constructor(code: InstanceCollectionErrorCode, expected: string, hint: string, detail?: InstanceCollectionInvalidDetail, facts?: InstanceCollectionFailureFacts);
+export declare function validateInstanceTransforms(transforms: ArrayLike<number>): InstanceTransformsError | InstanceTransformsStrideMismatchError | undefined;
+/** A new allocation must receive the complete payload, including after recovery. */
+export declare function instanceUploadRangesForResident(activeIsNew: boolean, dirtyRanges: readonly InstanceDirtyRange[], fullRange: InstanceDirtyRange): readonly InstanceDirtyRange[];
+interface Residency {
+    readonly frameNumber: number;
+    readonly residentGeneration: number | undefined;
+    readonly lane: InstanceSubmissionLane;
+    readonly uploadRanges: readonly InstanceDirtyRange[];
+    readonly uploadedBytes: number;
+    readonly requestedBytes: number;
+    readonly supportedBytes: number | undefined;
+    readonly backend: InstanceBackendKind;
+    readonly error: InstanceCollectionInspection['error'];
 }
-export type InstanceCollectionResult<T> = Result<T, InstanceCollectionError>;
-/**
- * Renderer-owned canonical storage for explicit instance transforms.
- *
- * ECS carries only `Instances.collectionId`; this owner keeps the copied
- * matrices, revision and dirty intervals independent of archetype capacity.
- * Snapshots are detached before they cross into extraction, so callers cannot
- * mutate the canonical source behind the revision protocol.
- */
-export declare class InstanceCollectionStore {
+/** Rebuildable renderer projection. All authoring and entity lifetime belong to World. */
+export declare class InstanceProjectionStore {
     private nextId;
-    private nextInstanceGeneration;
-    private epochValue;
-    private disposed;
+    private nextGeneration;
+    private identities;
     private readonly records;
     private readonly residency;
-    get epoch(): number;
-    create(input: InstanceCollectionCreateInput): InstanceCollectionResult<InstanceCollectionInfo>;
-    replace(id: InstanceCollectionId, transforms: Float32Array, 
-    /** Prior identity generations in the replacement order; omitted rows are new. */
-    generations?: Uint32Array): InstanceCollectionResult<InstanceCollectionInfo>;
-    update(id: InstanceCollectionId, input: InstanceCollectionUpdateInput): InstanceCollectionResult<InstanceCollectionInfo>;
-    inspect(id: InstanceCollectionId): InstanceCollectionResult<InstanceCollectionInfo>;
-    /**
-     * Return detached residency facts for every live collection.
-     *
-     * @internal Record-stage evidence is reported through the two methods below;
-     * callers only receive immutable PODs and never GPU handles.
-     */
-    _inspections(): readonly InstanceCollectionInspection[];
-    /** @internal Renderer record owner reports the accepted collection lane. */
-    _reportResidency(input: {
+    project(world: object, entity: number, transforms: ArrayLike<number>): InstanceCollectionSnapshot;
+    /** Called only after the owning RenderScene accepts its prepared changes. */
+    accept(world: object, entity: number, snapshot: {
+        readonly collectionId?: InstanceCollectionId;
+        readonly revision?: number;
+        readonly transforms: Float32Array;
+        readonly generations?: Uint32Array;
+    }): void;
+    release(world: object, entity: number): void;
+    retain(ids: ReadonlySet<InstanceCollectionId>): void;
+    dispose(): void;
+    _resetResidency(): void;
+    _reportResidency(input: Omit<Residency, 'error' | 'lane'> & {
         readonly collectionId: InstanceCollectionId;
-        readonly frameNumber: number;
-        readonly residentGeneration: number;
         readonly lane: Exclude<InstanceSubmissionLane, 'unresident' | 'unavailable'>;
-        readonly uploadRanges: readonly InstanceDirtyRange[];
-        readonly uploadedBytes: number;
-        readonly requestedBytes: number;
-        readonly supportedBytes: number | undefined;
-        readonly backend: InstanceBackendKind;
     }): void;
-    /** @internal Renderer record owner reports a typed admission failure. */
     _reportFailure(input: {
         readonly collectionId: InstanceCollectionId;
         readonly code: InstanceCollectionFailureCode;
@@ -138,23 +101,7 @@ export declare class InstanceCollectionStore {
         readonly hint: string;
         readonly facts: InstanceCollectionFailureFacts;
     }): void;
-    /** @internal A lost device invalidates every renderer-owned GPU resident. */
-    _resetResidency(): void;
-    snapshot(id: InstanceCollectionId): InstanceCollectionResult<InstanceCollectionSnapshot>;
-    /**
-     * Read a detached matrix view without advancing the render-consumption
-     * cursor. Inspection and picking may call this between authoring updates;
-     * the next renderer snapshot must still receive the complete dirty union.
-     */
-    peek(id: InstanceCollectionId): InstanceCollectionResult<InstanceCollectionSnapshot>;
-    release(id: InstanceCollectionId): InstanceCollectionResult<void>;
-    /** Drop all canonical matrices during Renderer disposal. */
-    dispose(): void;
-    private live;
-    private detachedSnapshot;
-    private info;
-    private allocateGenerations;
-    private validateReplacementGenerations;
-    private projectInspection;
+    _inspections(frameNumber: number): readonly InstanceCollectionInspection[];
 }
+export {};
 //# sourceMappingURL=instances.d.ts.map

package/dist/instances.d.ts.map

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

package/dist/internal.mjs

@@ -1,11 +1,10 @@
-export { PROBE_MAX_CONTRIBUTORS, SSR_HISTORY_FORMAT, SsrHistoryOwner, admitProbeContributors, blendLightProbes, buildRectAreaWorldFrame, createExtendedLightingState, createSsrHistoryOwner, estimateSsrSpatialMemory, projectExtendedLightingInspection, promoteExtendedLightingCandidate, recordExtendedLightingFailure, rectAreaFacesPoint, scaledProbeWeight, setOcclusionRuntimeTestHooks } from './chunk-OO3DRYK7.mjs';
-import './chunk-ILQ5MEZF.mjs';
-import './chunk-PLAXOOX5.mjs';
-import './chunk-PA5DRJNI.mjs';
-export { TemporalFrameCoordinator } from './chunk-ZDQWGQW7.mjs';
-import { EXTENDED_LIGHTING_TOPOLOGY } from './chunk-3RTCJTH4.mjs';
-export { DeviceScope, EXTENDED_LIGHTING_REQUIRED_SAMPLED_TEXTURES, deriveExtendedLightingCapability, extendedLightingSampledTextureCapacityAvailable, validateGraphTargetCaptureReadback } from './chunk-3RTCJTH4.mjs';
-export { createLightResourceUnavailable, createVisibilityBudget } from './chunk-NB2S7ZRX.mjs';
+export { PROBE_MAX_CONTRIBUTORS, SSR_HISTORY_FORMAT, SsrHistoryOwner, admitProbeContributors, blendLightProbes, createExtendedLightingState, createSsrHistoryOwner, estimateSsrSpatialMemory, projectExtendedLightingInspection, promoteExtendedLightingCandidate, recordExtendedLightingFailure, scaledProbeWeight, setOcclusionRuntimeTestHooks } from './chunk-3XUBWRY2.mjs';
+export { buildRectAreaWorldFrame, rectAreaFacesPoint } from './chunk-G6HDNGY7.mjs';
+import './chunk-X2KA6WHM.mjs';
+export { TemporalFrameCoordinator } from './chunk-LM5IE7GF.mjs';
+import './chunk-RIPAEGI6.mjs';
+import { EXTENDED_LIGHTING_TOPOLOGY } from './chunk-MXTWKZO4.mjs';
+export { DeviceScope, EXTENDED_LIGHTING_REQUIRED_SAMPLED_TEXTURES, createLightResourceUnavailable, createVisibilityBudget, deriveExtendedLightingCapability, extendedLightingSampledTextureCapacityAvailable, validateGraphTargetCaptureReadback } from './chunk-MXTWKZO4.mjs';
 export { resolveTilesetRuntime } from '@forgeax/engine-assets-runtime';
 import '@forgeax/engine-shader';
 import { ok, err } from '@forgeax/engine-types';

package/dist/internal.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/prepare/extended-lighting/ltc-resources.ts","../src/ssr/temporal.ts"],"names":["ok","err"],"mappings":";;;;;;;;;;;;AAoCO,SAAS,sBAAsB,KAAA,EAA8C;AAClF,EAAA,MAAM,WAAW,KAAA,CAAM,YAAA;AACvB,EAAA,OAAO;AAAA,IACL,QAAA,EAAU,0BAAA;AAAA,IACV,UAAA,EAAY,MAAM,KAAA,CAAM,UAAA;AAAA,IACxB,aAAA,EAAe,WAAW,UAAA,GAAa,SAAA;AAAA,IACvC,UAAA,EAAY,WAAW,CAAA,GAAI,CAAA;AAAA,IAC3B,aAAa,QAAA,IAAY,KAAA,CAAM,uBAAuB,KAAA,CAAM,KAAA,CAAM,aAAa,CAAA,GAAI;AAAA,GACrF;AACF;ACPA,SAAS,eAAe,KAAA,EAAoC;AAC1D,EAAA,IAAI,OAAO,KAAA,KAAU,QAAA,IAAY,KAAA,KAAU,IAAA,IAAQ,WAAW,KAAA,EAAO;AACnE,IAAA,MAAM,QAAS,KAAA,CAAuC,KAAA;AACtD,IAAA,IAAI,UAAU,OAAA,IAAW,KAAA,KAAU,YAAY,KAAA,KAAU,QAAA,IAAY,UAAU,QAAA,EAAU;AACvF,MAAA,OAAO,KAAA;AAAA,IACT;AAAA,EACF;AACA,EAAA,OAAO,QAAA;AACT;AACA,SAAS,iBAAoB,KAAA,EAA+D;AAC1F,EAAA,MAAM,WAAA,GAAc,KAAA,CAAM,WAAA,EAAa,QAAA,CAAS,KAAK,CAAA,GACjD,KAAA,CAAM,WAAA,GACN,CAAC,GAAI,KAAA,CAAM,WAAA,IAAe,IAAK,KAAc,CAAA;AACjD,EAAA,OAAO,EAAE,GAAG,KAAA,EAAO,cAAA,EAAgB,MAAM,WAAA,EAAY;AACvD;AACA,SAAS,gBAAA,CACP,aACA,MAAA,EACM;AACN,EAAA,QAAQ,MAAA;AAAQ,IACd,KAAK,cAAA;AAAA,IACL,KAAK,SAAA;AACH,MAAA;AAAA,IACF,KAAK,QAAA;AACH,MAAA,WAAA,CAAY,MAAM,QAAQ,CAAA;AAC1B,MAAA;AAAA,IACF,KAAK,YAAA;AACH,MAAA,WAAA,CAAY,MAAM,KAAK,CAAA;AACvB,MAAA;AAAA,IACF,KAAK,iBAAA;AACH,MAAA,WAAA,CAAY,MAAM,eAAe,CAAA;AACjC,MAAA;AAAA,IACF,KAAK,eAAA;AACH,MAAA,WAAA,CAAY,MAAM,QAAQ,CAAA;AAC1B,MAAA;AAAA,IACF,KAAK,uBAAA;AAAA,IACL,KAAK,iBAAA;AACH,MAAA,WAAA,CAAY,MAAM,mBAAmB,CAAA;AACrC,MAAA;AAAA;AAEN;AAGO,IAAM,sBAAN,MAAuC;AAAA,EAC5C,WAAA,CACmB,aACR,OAAA,EACT;AAFiB,IAAA,IAAA,CAAA,WAAA,GAAA,WAAA;AACR,IAAA,IAAA,CAAA,OAAA,GAAA,OAAA;AAAA,EACR;AAAA,EAFgB,WAAA;AAAA,EACR,OAAA;AAAA,EAEX,MACE,KAAA,EACuE;AACvE,IAAA,MAAM,OAAA,GAAU,IAAA,CAAK,OAAA,CAAQ,UAAA,EAAW;AACxC,IAAA,IAAI,CAAC,OAAA,CAAQ,EAAA,EAAI,OAAO,OAAA;AACxB,IAAA,MAAM,WAAW,IAAA,CAAK,WAAA,CAAY,KAAA,CAAM,gBAAA,CAAiB,KAAK,CAAC,CAAA;AAC/D,IAAA,IAAI,CAAC,SAAS,EAAA,EAAI;AAChB,MAAA,IAAA,CAAK,OAAA,CAAQ,UAAA,CAAW,OAAA,CAAQ,KAAA,EAAO,OAAO,CAAA;AAC9C,MAAA,OAAO,QAAA;AAAA,IACT;AACA,IAAA,OAAOA,EAAAA,CAAG,EAAE,QAAA,EAAU,QAAA,CAAS,OAAO,OAAA,EAAS,OAAA,CAAQ,OAAO,CAAA;AAAA,EAChE;AAAA,EACA,OACE,SAAA,EACuE;AACvE,IAAA,MAAM,SAAA,GAAY,IAAA,CAAK,WAAA,CAAY,MAAA,CAAO,UAAU,QAAQ,CAAA;AAC5D,IAAA,IAAI,CAAC,UAAU,EAAA,EAAI;AACjB,MAAA,IAAA,CAAK,OAAA,CAAQ,UAAA,CAAW,SAAA,CAAU,OAAA,EAAS,QAAQ,CAAA;AACnD,MAAA,OAAO,SAAA;AAAA,IACT;AACA,IAAA,MAAM,OAAA,GAAU,IAAA,CAAK,OAAA,CAAQ,WAAA,CAAY,UAAU,OAAO,CAAA;AAC1D,IAAA,IAAI,CAAC,OAAA,CAAQ,EAAA,EAAI,OAAO,OAAA;AACxB,IAAA,OAAO,SAAA;AAAA,EACT;AAAA,EACA,KAAA,CAAM,WAAoC,KAAA,EAAqC;AAC7E,IAAA,IAAA,CAAK,OAAA,CAAQ,UAAA,CAAW,SAAA,CAAU,OAAA,EAAS,KAAK,CAAA;AAChD,IAAA,IAAA,CAAK,WAAA,CAAY,KAAA,CAAM,SAAA,CAAU,QAAA,EAAU,KAAK,CAAA;AAAA,EAClD;AAAA,EACA,GAAA,CACE,OACA,MAAA,EACmD;AACnD,IAAA,MAAM,OAAA,GAAU,IAAA,CAAK,KAAA,CAAM,KAAK,CAAA;AAChC,IAAA,IAAI,CAAC,OAAA,CAAQ,EAAA,EAAI,OAAO,OAAA;AACxB,IAAA,MAAM,YAAY,OAAA,CAAQ,KAAA;AAC1B,IAAA,IAAI;AACF,MAAA,MAAM,KAAA,GAAQ,OAAO,KAAA,EAAM;AAC3B,MAAA,MAAA,CAAO,OAAO,KAAK,CAAA;AACnB,MAAA,MAAA,CAAO,MAAA,EAAO;AACd,MAAA,MAAA,CAAO,MAAA,EAAO;AAAA,IAChB,SAAS,KAAA,EAAO;AACd,MAAA,MAAM,KAAA,GAAQ,eAAe,KAAK,CAAA;AAClC,MAAA,IAAA,CAAK,KAAA,CAAM,WAAW,KAAK,CAAA;AAC3B,MAAA,OAAOC,GAAAA,CAAI;AAAA,QACT,IAAA,EAAM,2BAAA;AAAA,QACN,QAAA,EAAU,gBAAgB,KAAK,CAAA,uBAAA,CAAA;AAAA,QAC/B,IAAA,EAAM,2EAAA;AAAA,QACN,MAAA,EAAQ,EAAE,KAAA,EAAO,KAAA;AAAM,OACxB,CAAA;AAAA,IACH;AACA,IAAA,OAAO,IAAA,CAAK,OAAO,SAAS,CAAA;AAAA,EAC9B;AAAA,EACA,MAAM,MAAA,EAAqC;AACzC,IAAA,IAAA,CAAK,OAAA,CAAQ,MAAM,MAAM,CAAA;AACzB,IAAA,gBAAA,CAAiB,IAAA,CAAK,aAAa,MAAM,CAAA;AAAA,EAC3C;AAAA,EACA,gBAAA,CACE,OACA,SAAA,EACM;AACN,IAAA,IAAA,CAAK,OAAA,CAAQ,gBAAA,CAAiB,KAAA,EAAO,SAAS,CAAA;AAAA,EAChD;AAAA,EACA,OAAA,GAAiC;AAC/B,IAAA,MAAM,QAAA,GAAW,IAAA,CAAK,WAAA,CAAY,OAAA,EAAQ;AAC1C,IAAA,OAAO,OAAO,MAAA,CAAO;AAAA,MACnB,aAAa,QAAA,CAAS,KAAA;AAAA,MACtB,aAAa,QAAA,CAAS,WAAA;AAAA,MACtB,oBAAoB,QAAA,CAAS,OAAA;AAAA,MAC7B,OAAA,EAAS,IAAA,CAAK,OAAA,CAAQ,OAAA;AAAQ,KAC/B,CAAA;AAAA,EACH;AACF;AACO,SAAS,yBAAA,CACd,aACA,OAAA,EACwB;AACxB,EAAA,OAAO,IAAI,mBAAA,CAAoB,WAAA,EAAa,OAAO,CAAA;AACrD","file":"internal.mjs","sourcesContent":["// @forgeax/engine-render - DeviceScope-owned RectArea LTC resources.\n\nimport type { Result, RhiDevice, RhiError, Texture } from '@forgeax/engine-rhi';\nimport { LTC_TABLE_HEIGHT, LTC_TABLE_WIDTH, LTC_TABLES } from '@forgeax/engine-shader';\nimport { err, ok } from '@forgeax/engine-types';\nimport { type DeviceScope, LifecycleTransaction } from '../../device/device-scope';\nimport {\n  GPU_TEXTURE_USAGE_COPY_DST,\n  GPU_TEXTURE_USAGE_TEXTURE_BINDING,\n} from '../../gpu-texture-usage';\nimport { deriveExtendedLightingCapability, EXTENDED_LIGHTING_TOPOLOGY } from './resources';\n\nexport interface LtcResourcePlanInput {\n  readonly scope: DeviceScope;\n  readonly ltcAvailable: boolean;\n  readonly residentGeneration?: number;\n}\n\nexport interface LtcResourcePlan {\n  readonly topology: typeof EXTENDED_LIGHTING_TOPOLOGY;\n  readonly generation: number;\n  readonly rectAdmission: 'admitted' | 'omitted';\n  readonly tableCount: number;\n  readonly uploadCount: number;\n}\n\nexport interface LtcResourceCandidate {\n  readonly topology: typeof EXTENDED_LIGHTING_TOPOLOGY;\n  readonly generation: number;\n  readonly scope: DeviceScope;\n  readonly lambertTexture: Texture;\n  readonly ggxTexture: Texture;\n  readonly tableCount: 2;\n  readonly uploadCount: 2;\n}\n\nexport function deriveLtcResourcePlan(input: LtcResourcePlanInput): LtcResourcePlan {\n  const admitted = input.ltcAvailable;\n  return {\n    topology: EXTENDED_LIGHTING_TOPOLOGY,\n    generation: input.scope.generation,\n    rectAdmission: admitted ? 'admitted' : 'omitted',\n    tableCount: admitted ? 2 : 0,\n    uploadCount: admitted && input.residentGeneration !== input.scope.generation ? 2 : 0,\n  };\n}\n\nfunction failure(expected: string, actual: string): Result<never, RhiError> {\n  return err({\n    code: 'webgpu-runtime-error',\n    expected,\n    hint: 'inspect device capabilities and retry the extendedLighting candidate',\n    detail: { error: { code: 'ltc-resource', message: actual } },\n  } as RhiError);\n}\n\nfunction textureBytes(table: Uint16Array): Uint8Array {\n  return new Uint8Array(table.buffer, table.byteOffset, table.byteLength);\n}\n\n/** Create both tracked tables atomically; unavailable LTC only omits Rect. */\nexport async function createLtcResourceCandidate(input: {\n  readonly device: RhiDevice | undefined;\n  readonly scope: DeviceScope;\n}): Promise<Result<LtcResourceCandidate | undefined, RhiError>> {\n  if (input.device === undefined) return ok(undefined);\n  if (!deriveExtendedLightingCapability(input.device).admitted) return ok(undefined);\n  const device = input.device;\n\n  const transaction = new LifecycleTransaction(input.scope);\n  let lambertTexture: Texture | undefined;\n  let ggxTexture: Texture | undefined;\n  const createTable = (label: string, table: Uint16Array): Texture => {\n    const texture = device.createTexture({\n      label,\n      size: { width: LTC_TABLE_WIDTH, height: LTC_TABLE_HEIGHT, depthOrArrayLayers: 1 },\n      mipLevelCount: 1,\n      sampleCount: 1,\n      dimension: '2d',\n      format: 'rgba16float',\n      usage: GPU_TEXTURE_USAGE_COPY_DST | GPU_TEXTURE_USAGE_TEXTURE_BINDING,\n      viewFormats: [],\n      textureBindingViewDimension: undefined,\n    });\n    if (texture === undefined || !texture.ok) {\n      throw texture?.error ?? new Error('LTC texture creation returned no result');\n    }\n    const write = device.queue.writeTexture(\n      { texture: texture.value, mipLevel: 0, origin: { x: 0, y: 0, z: 0 } },\n      textureBytes(table),\n      { offset: 0, bytesPerRow: LTC_TABLE_WIDTH * 8, rowsPerImage: LTC_TABLE_HEIGHT },\n      { width: LTC_TABLE_WIDTH, height: LTC_TABLE_HEIGHT, depthOrArrayLayers: 1 },\n    );\n    if (!write.ok) throw write.error;\n    return texture.value;\n  };\n\n  transaction.add({\n    kind: 'texture',\n    create: () => {\n      lambertTexture = createTable('extended-lighting-ltc-lambert', LTC_TABLES.lambert);\n      return lambertTexture;\n    },\n    cleanup: (value) => {\n      const destroyed = input.device?.destroyTexture(value);\n      if (destroyed !== undefined && !destroyed.ok) throw destroyed.error;\n    },\n  });\n  transaction.add({\n    kind: 'texture',\n    create: () => {\n      ggxTexture = createTable('extended-lighting-ltc-ggx', LTC_TABLES.ggx);\n      return ggxTexture;\n    },\n    cleanup: (value) => {\n      const destroyed = input.device?.destroyTexture(value);\n      if (destroyed !== undefined && !destroyed.ok) throw destroyed.error;\n    },\n  });\n\n  const committed = await transaction.commit();\n  if (!committed.ok)\n    return failure(committed.error.primary.expected, committed.error.primary.message);\n  if (lambertTexture === undefined || ggxTexture === undefined) {\n    return failure('two LTC textures', 'the transaction committed without both tables');\n  }\n  return ok({\n    topology: EXTENDED_LIGHTING_TOPOLOGY,\n    generation: input.scope.generation,\n    scope: input.scope,\n    lambertTexture,\n    ggxTexture,\n    tableCount: 2,\n    uploadCount: 2,\n  });\n}\n","import { err, ok, type Result } from '@forgeax/engine-types';\nimport type {\n  TemporalFrameBeginInput,\n  TemporalFrameCandidate,\n  TemporalFrameConsumerId,\n  TemporalFrameCoordinator,\n  TemporalFrameError,\n  TemporalFramePhases,\n  TemporalFrameReceipt,\n  TemporalFrameStage,\n} from '../temporal/frame-coordinator';\nimport type {\n  SsrHistoryCandidate,\n  SsrHistoryError,\n  SsrHistoryFailureStage,\n  SsrHistoryInspection,\n  SsrHistoryOwner,\n  SsrHistoryResetReason,\n} from './history';\n\nexport interface SsrTemporalCandidate<T> {\n  readonly temporal: TemporalFrameCandidate<T>;\n  readonly history: SsrHistoryCandidate;\n}\nexport interface SsrTemporalExecutionError {\n  readonly code: 'ssr-temporal-stage-failed';\n  readonly expected: string;\n  readonly hint: string;\n  readonly detail: Readonly<{ readonly stage: TemporalFrameStage; readonly cause: unknown }>;\n}\nexport interface SsrTemporalInspection {\n  readonly sharedEpoch: number;\n  readonly consumerIds: readonly TemporalFrameConsumerId[];\n  readonly coordinatorAttempt: 'none' | 'active' | 'committed' | 'aborted';\n  readonly history: SsrHistoryInspection;\n}\nexport type SsrTemporalError = TemporalFrameError | SsrHistoryError | SsrTemporalExecutionError;\n\nfunction stageFromError(cause: unknown): TemporalFrameStage {\n  if (typeof cause === 'object' && cause !== null && 'stage' in cause) {\n    const stage = (cause as { readonly stage?: unknown }).stage;\n    if (stage === 'build' || stage === 'encode' || stage === 'finish' || stage === 'submit') {\n      return stage;\n    }\n  }\n  return 'submit';\n}\nfunction coordinatorInput<T>(input: TemporalFrameBeginInput<T>): TemporalFrameBeginInput<T> {\n  const consumerIds = input.consumerIds?.includes('ssr')\n    ? input.consumerIds\n    : [...(input.consumerIds ?? []), 'ssr' as const];\n  return { ...input, temporalDemand: true, consumerIds };\n}\nfunction resetCoordinator<T>(\n  coordinator: TemporalFrameCoordinator<T>,\n  reason: SsrHistoryResetReason,\n): void {\n  switch (reason) {\n    case 'first-enable':\n    case 'disable':\n      return;\n    case 'resize':\n      coordinator.reset('resize');\n      return;\n    case 'camera-cut':\n      coordinator.reset('cut');\n      return;\n    case 'history-version':\n      coordinator.reset('camera-switch');\n      return;\n    case 'coverage-loss':\n      coordinator.reset('detach');\n      return;\n    case 'reflection-generation':\n    case 'device-recovery':\n      coordinator.reset('device-generation');\n      return;\n  }\n}\n\n/** Stages SSR history beside the shared renderer transaction without owning submit or epochs. */\nexport class SsrTemporalConsumer<T = unknown> {\n  constructor(\n    private readonly coordinator: TemporalFrameCoordinator<T>,\n    readonly history: SsrHistoryOwner,\n  ) {}\n  begin(\n    input: TemporalFrameBeginInput<T>,\n  ): Result<SsrTemporalCandidate<T>, TemporalFrameError | SsrHistoryError> {\n    const history = this.history.beginFrame();\n    if (!history.ok) return history;\n    const temporal = this.coordinator.begin(coordinatorInput(input));\n    if (!temporal.ok) {\n      this.history.abortFrame(history.value, 'build');\n      return temporal;\n    }\n    return ok({ temporal: temporal.value, history: history.value });\n  }\n  commit(\n    candidate: SsrTemporalCandidate<T>,\n  ): Result<TemporalFrameReceipt<T>, TemporalFrameError | SsrHistoryError> {\n    const committed = this.coordinator.commit(candidate.temporal);\n    if (!committed.ok) {\n      this.history.abortFrame(candidate.history, 'submit');\n      return committed;\n    }\n    const history = this.history.commitFrame(candidate.history);\n    if (!history.ok) return history;\n    return committed;\n  }\n  abort(candidate: SsrTemporalCandidate<T>, stage: SsrHistoryFailureStage): void {\n    this.history.abortFrame(candidate.history, stage);\n    this.coordinator.abort(candidate.temporal, stage);\n  }\n  run(\n    input: TemporalFrameBeginInput<T>,\n    phases: TemporalFramePhases<T>,\n  ): Result<TemporalFrameReceipt<T>, SsrTemporalError> {\n    const started = this.begin(input);\n    if (!started.ok) return started;\n    const candidate = started.value;\n    try {\n      const built = phases.build();\n      phases.encode(built);\n      phases.finish();\n      phases.submit();\n    } catch (cause) {\n      const stage = stageFromError(cause);\n      this.abort(candidate, stage);\n      return err({\n        code: 'ssr-temporal-stage-failed',\n        expected: `SSR temporal ${stage} succeeds before commit`,\n        hint: 'inspect the owned stage failure and retry without promoting the candidate',\n        detail: { stage, cause },\n      });\n    }\n    return this.commit(candidate);\n  }\n  reset(reason: SsrHistoryResetReason): void {\n    this.history.reset(reason);\n    resetCoordinator(this.coordinator, reason);\n  }\n  retireAfterFence(\n    queue: Parameters<SsrHistoryOwner['retireAfterFence']>[0],\n    onFailure: Parameters<SsrHistoryOwner['retireAfterFence']>[1],\n  ): void {\n    this.history.retireAfterFence(queue, onFailure);\n  }\n  inspect(): SsrTemporalInspection {\n    const temporal = this.coordinator.inspect();\n    return Object.freeze({\n      sharedEpoch: temporal.epoch,\n      consumerIds: temporal.consumerIds,\n      coordinatorAttempt: temporal.attempt,\n      history: this.history.inspect(),\n    });\n  }\n}\nexport function createSsrTemporalConsumer<T>(\n  coordinator: TemporalFrameCoordinator<T>,\n  history: SsrHistoryOwner,\n): SsrTemporalConsumer<T> {\n  return new SsrTemporalConsumer(coordinator, history);\n}\n"]}
+{"version":3,"sources":["../src/prepare/extended-lighting/ltc-resources.ts","../src/ssr/temporal.ts"],"names":["ok","err"],"mappings":"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","file":"internal.mjs","sourcesContent":["// @forgeax/engine-render - DeviceScope-owned RectArea LTC resources.\n\nimport type { Result, RhiDevice, RhiError, Texture } from '@forgeax/engine-rhi';\nimport { LTC_TABLE_HEIGHT, LTC_TABLE_WIDTH, LTC_TABLES } from '@forgeax/engine-shader';\nimport { err, ok } from '@forgeax/engine-types';\nimport { type DeviceScope, LifecycleTransaction } from '../../device/device-scope';\nimport {\n  GPU_TEXTURE_USAGE_COPY_DST,\n  GPU_TEXTURE_USAGE_TEXTURE_BINDING,\n} from '../../gpu-texture-usage';\nimport { deriveExtendedLightingCapability, EXTENDED_LIGHTING_TOPOLOGY } from './resources';\n\nexport interface LtcResourcePlanInput {\n  readonly scope: DeviceScope;\n  readonly ltcAvailable: boolean;\n  readonly residentGeneration?: number;\n}\n\nexport interface LtcResourcePlan {\n  readonly topology: typeof EXTENDED_LIGHTING_TOPOLOGY;\n  readonly generation: number;\n  readonly rectAdmission: 'admitted' | 'omitted';\n  readonly tableCount: number;\n  readonly uploadCount: number;\n}\n\nexport interface LtcResourceCandidate {\n  readonly topology: typeof EXTENDED_LIGHTING_TOPOLOGY;\n  readonly generation: number;\n  readonly scope: DeviceScope;\n  readonly lambertTexture: Texture;\n  readonly ggxTexture: Texture;\n  readonly tableCount: 2;\n  readonly uploadCount: 2;\n}\n\nexport function deriveLtcResourcePlan(input: LtcResourcePlanInput): LtcResourcePlan {\n  const admitted = input.ltcAvailable;\n  return {\n    topology: EXTENDED_LIGHTING_TOPOLOGY,\n    generation: input.scope.generation,\n    rectAdmission: admitted ? 'admitted' : 'omitted',\n    tableCount: admitted ? 2 : 0,\n    uploadCount: admitted && input.residentGeneration !== input.scope.generation ? 2 : 0,\n  };\n}\n\nfunction failure(expected: string, actual: string): Result<never, RhiError> {\n  return err({\n    code: 'webgpu-runtime-error',\n    expected,\n    hint: 'inspect device capabilities and retry the extendedLighting candidate',\n    detail: { error: { code: 'ltc-resource', message: actual } },\n  } as RhiError);\n}\n\nfunction textureBytes(table: Uint16Array): Uint8Array {\n  return new Uint8Array(table.buffer, table.byteOffset, table.byteLength);\n}\n\n/** Create both tracked tables atomically; unavailable LTC only omits Rect. */\nexport async function createLtcResourceCandidate(input: {\n  readonly device: RhiDevice | undefined;\n  readonly scope: DeviceScope;\n}): Promise<Result<LtcResourceCandidate | undefined, RhiError>> {\n  if (input.device === undefined) return ok(undefined);\n  if (!deriveExtendedLightingCapability(input.device).admitted) return ok(undefined);\n  const device = input.device;\n\n  const transaction = new LifecycleTransaction(input.scope);\n  let lambertTexture: Texture | undefined;\n  let ggxTexture: Texture | undefined;\n  const createTable = (label: string, table: Uint16Array): Texture => {\n    const texture = device.createTexture({\n      label,\n      size: { width: LTC_TABLE_WIDTH, height: LTC_TABLE_HEIGHT, depthOrArrayLayers: 1 },\n      mipLevelCount: 1,\n      sampleCount: 1,\n      dimension: '2d',\n      format: 'rgba16float',\n      usage: GPU_TEXTURE_USAGE_COPY_DST | GPU_TEXTURE_USAGE_TEXTURE_BINDING,\n      viewFormats: [],\n      textureBindingViewDimension: undefined,\n    });\n    if (texture === undefined || !texture.ok) {\n      throw texture?.error ?? new Error('LTC texture creation returned no result');\n    }\n    const write = device.queue.writeTexture(\n      { texture: texture.value, mipLevel: 0, origin: { x: 0, y: 0, z: 0 } },\n      textureBytes(table),\n      { offset: 0, bytesPerRow: LTC_TABLE_WIDTH * 8, rowsPerImage: LTC_TABLE_HEIGHT },\n      { width: LTC_TABLE_WIDTH, height: LTC_TABLE_HEIGHT, depthOrArrayLayers: 1 },\n    );\n    if (!write.ok) throw write.error;\n    return texture.value;\n  };\n\n  transaction.add({\n    kind: 'texture',\n    create: () => {\n      lambertTexture = createTable('extended-lighting-ltc-lambert', LTC_TABLES.lambert);\n      return lambertTexture;\n    },\n    cleanup: (value) => {\n      const destroyed = input.device?.destroyTexture(value);\n      if (destroyed !== undefined && !destroyed.ok) throw destroyed.error;\n    },\n  });\n  transaction.add({\n    kind: 'texture',\n    create: () => {\n      ggxTexture = createTable('extended-lighting-ltc-ggx', LTC_TABLES.ggx);\n      return ggxTexture;\n    },\n    cleanup: (value) => {\n      const destroyed = input.device?.destroyTexture(value);\n      if (destroyed !== undefined && !destroyed.ok) throw destroyed.error;\n    },\n  });\n\n  const committed = await transaction.commit();\n  if (!committed.ok)\n    return failure(committed.error.primary.expected, committed.error.primary.message);\n  if (lambertTexture === undefined || ggxTexture === undefined) {\n    return failure('two LTC textures', 'the transaction committed without both tables');\n  }\n  return ok({\n    topology: EXTENDED_LIGHTING_TOPOLOGY,\n    generation: input.scope.generation,\n    scope: input.scope,\n    lambertTexture,\n    ggxTexture,\n    tableCount: 2,\n    uploadCount: 2,\n  });\n}\n","import { err, ok, type Result } from '@forgeax/engine-types';\nimport type {\n  TemporalFrameBeginInput,\n  TemporalFrameCandidate,\n  TemporalFrameConsumerId,\n  TemporalFrameCoordinator,\n  TemporalFrameError,\n  TemporalFramePhases,\n  TemporalFrameReceipt,\n  TemporalFrameStage,\n} from '../temporal/frame-coordinator';\nimport type {\n  SsrHistoryCandidate,\n  SsrHistoryError,\n  SsrHistoryFailureStage,\n  SsrHistoryInspection,\n  SsrHistoryOwner,\n  SsrHistoryResetReason,\n} from './history';\n\nexport interface SsrTemporalCandidate<T> {\n  readonly temporal: TemporalFrameCandidate<T>;\n  readonly history: SsrHistoryCandidate;\n}\nexport interface SsrTemporalExecutionError {\n  readonly code: 'ssr-temporal-stage-failed';\n  readonly expected: string;\n  readonly hint: string;\n  readonly detail: Readonly<{ readonly stage: TemporalFrameStage; readonly cause: unknown }>;\n}\nexport interface SsrTemporalInspection {\n  readonly sharedEpoch: number;\n  readonly consumerIds: readonly TemporalFrameConsumerId[];\n  readonly coordinatorAttempt: 'none' | 'active' | 'committed' | 'aborted';\n  readonly history: SsrHistoryInspection;\n}\nexport type SsrTemporalError = TemporalFrameError | SsrHistoryError | SsrTemporalExecutionError;\n\nfunction stageFromError(cause: unknown): TemporalFrameStage {\n  if (typeof cause === 'object' && cause !== null && 'stage' in cause) {\n    const stage = (cause as { readonly stage?: unknown }).stage;\n    if (stage === 'build' || stage === 'encode' || stage === 'finish' || stage === 'submit') {\n      return stage;\n    }\n  }\n  return 'submit';\n}\nfunction coordinatorInput<T>(input: TemporalFrameBeginInput<T>): TemporalFrameBeginInput<T> {\n  const consumerIds = input.consumerIds?.includes('ssr')\n    ? input.consumerIds\n    : [...(input.consumerIds ?? []), 'ssr' as const];\n  return { ...input, temporalDemand: true, consumerIds };\n}\nfunction resetCoordinator<T>(\n  coordinator: TemporalFrameCoordinator<T>,\n  reason: SsrHistoryResetReason,\n): void {\n  switch (reason) {\n    case 'first-enable':\n    case 'disable':\n      return;\n    case 'resize':\n      coordinator.reset('resize');\n      return;\n    case 'camera-cut':\n      coordinator.reset('cut');\n      return;\n    case 'history-version':\n      coordinator.reset('camera-switch');\n      return;\n    case 'coverage-loss':\n      coordinator.reset('detach');\n      return;\n    case 'reflection-generation':\n    case 'device-recovery':\n      coordinator.reset('device-generation');\n      return;\n  }\n}\n\n/** Stages SSR history beside the shared renderer transaction without owning submit or epochs. */\nexport class SsrTemporalConsumer<T = unknown> {\n  constructor(\n    private readonly coordinator: TemporalFrameCoordinator<T>,\n    readonly history: SsrHistoryOwner,\n  ) {}\n  begin(\n    input: TemporalFrameBeginInput<T>,\n  ): Result<SsrTemporalCandidate<T>, TemporalFrameError | SsrHistoryError> {\n    const history = this.history.beginFrame();\n    if (!history.ok) return history;\n    const temporal = this.coordinator.begin(coordinatorInput(input));\n    if (!temporal.ok) {\n      this.history.abortFrame(history.value, 'build');\n      return temporal;\n    }\n    return ok({ temporal: temporal.value, history: history.value });\n  }\n  commit(\n    candidate: SsrTemporalCandidate<T>,\n  ): Result<TemporalFrameReceipt<T>, TemporalFrameError | SsrHistoryError> {\n    const committed = this.coordinator.commit(candidate.temporal);\n    if (!committed.ok) {\n      this.history.abortFrame(candidate.history, 'submit');\n      return committed;\n    }\n    const history = this.history.commitFrame(candidate.history);\n    if (!history.ok) return history;\n    return committed;\n  }\n  abort(candidate: SsrTemporalCandidate<T>, stage: SsrHistoryFailureStage): void {\n    this.history.abortFrame(candidate.history, stage);\n    this.coordinator.abort(candidate.temporal, stage);\n  }\n  run(\n    input: TemporalFrameBeginInput<T>,\n    phases: TemporalFramePhases<T>,\n  ): Result<TemporalFrameReceipt<T>, SsrTemporalError> {\n    const started = this.begin(input);\n    if (!started.ok) return started;\n    const candidate = started.value;\n    try {\n      const built = phases.build();\n      phases.encode(built);\n      phases.finish();\n      phases.submit();\n    } catch (cause) {\n      const stage = stageFromError(cause);\n      this.abort(candidate, stage);\n      return err({\n        code: 'ssr-temporal-stage-failed',\n        expected: `SSR temporal ${stage} succeeds before commit`,\n        hint: 'inspect the owned stage failure and retry without promoting the candidate',\n        detail: { stage, cause },\n      });\n    }\n    return this.commit(candidate);\n  }\n  reset(reason: SsrHistoryResetReason): void {\n    this.history.reset(reason);\n    resetCoordinator(this.coordinator, reason);\n  }\n  retireAfterFence(\n    queue: Parameters<SsrHistoryOwner['retireAfterFence']>[0],\n    onFailure: Parameters<SsrHistoryOwner['retireAfterFence']>[1],\n  ): void {\n    this.history.retireAfterFence(queue, onFailure);\n  }\n  inspect(): SsrTemporalInspection {\n    const temporal = this.coordinator.inspect();\n    return Object.freeze({\n      sharedEpoch: temporal.epoch,\n      consumerIds: temporal.consumerIds,\n      coordinatorAttempt: temporal.attempt,\n      history: this.history.inspect(),\n    });\n  }\n}\nexport function createSsrTemporalConsumer<T>(\n  coordinator: TemporalFrameCoordinator<T>,\n  history: SsrHistoryOwner,\n): SsrTemporalConsumer<T> {\n  return new SsrTemporalConsumer(coordinator, history);\n}\n"]}

package/dist/pbr-pipeline.d.ts

@@ -90,6 +90,14 @@ export type InjectionKind = keyof typeof INJECTION_KIND_LENGTHS;
  * ```
  */
 export declare function appendInjection(bgl: readonly GPUBindGroupLayoutEntry[], kind: InjectionKind): GPUBindGroupLayoutEntry[];
+/**
+ * Append the renderer-owned inputs required by the Engine single-layer
+ * medium template. They intentionally live after the normal IBL and
+ * transmission injections so authored parameter schemas remain the only
+ * source of the prefix. The raw-depth texture is an r32float producer
+ * resource and therefore uses the unfilterable-float/non-filtering pair.
+ */
+export declare function appendSingleLayerMediumInjection(bgl: readonly GPUBindGroupLayoutEntry[]): GPUBindGroupLayoutEntry[];
 export declare const INJECTION_KIND_LENGTHS: {
     shadow: number;
     ibl: number;
@@ -236,6 +244,16 @@ export declare function buildPbrSkinLayouts(device: PbrPipelineDevice, caps: Pbr
  * and prevents a direct draw from having to bind a dummy visible stream.
  */
 export declare function buildGpuDrivenPbrInstancesBindGroupLayout(device: PbrPipelineDevice, caps: PbrCaps): BindGroupLayout;
+/**
+ * Build the slot-3 layout used by direct single-layer-medium draws.
+ *
+ * Direct Surface draws retain their ordinary instance transforms at binding
+ * zero, but consume the same producer-owned ProbeBlend, dynamic page, frame
+ * rows, and shared time resources as the scene-index lane. Binding six is the
+ * per-draw frame-row base; it keeps a local instance index independent from
+ * the renderer's compact scene-index address.
+ */
+export declare function buildSurfaceDirectInstancesBindGroupLayout(device: PbrPipelineDevice, caps: PbrCaps): BindGroupLayout;
 /** Build the four-slot rigid scene-index pipeline layout. */
 export declare function buildGpuDrivenPbrPipelineLayout(device: PbrPipelineDevice, pbr: PbrPipelineLayoutBundle, gpuDrivenInstancesBgl: BindGroupLayout): PipelineLayout;
 /** Build the four-slot skinned scene-index pipeline layout. */
@@ -246,13 +264,13 @@ export declare function createPbrSkinMeshBindGroupEntries(meshBuffer: Buffer, me
 export declare function pbrSkinMeshDynamicOffsets(meshOffset: number, paletteOffset: number): readonly [number, number, number];
 /**
  * Build a stand-alone 7-entry unlit material BGL. Round-4 D-5 keeps unlit
- * material BG isolated from Skylight binding 7..13 -- unlit demos do not
+ * material BG isolated from Skylight binding 7..12 -- unlit demos do not
  * pay for IBL state. The unlit pipeline still binds material at slot 1,
  * just with a 7-entry layout.
  *
  * Note: at the moment the runtime still routes both unlit + standard
  * through a single 14-entry pipeline layout; the unlit material BG
- * carries fallback identity resources at binding 7..13. This factory is
+ * carries fallback identity resources at binding 7..12. This factory is
  * exported as a future-proof seam for the moment when unlit demos own
  * their own pipeline layout (t57 (e) test pins the contract today so the
  * eventual split has a green target).
@@ -309,7 +327,7 @@ export declare const SPRITE_PASS_PER_INSTANCE_REGION_VARIANT_SET = "";
  *
  * Three groups by derivation source:
  * 1. Shader-derived (paramSchema reflection + injection chain):
- *    - `'pbr-material-merged'` — derived user region + Skylight 7 + transmission 2
+ *    - `'pbr-material-merged'` — derived user region + Skylight 6 + transmission 2
  *    - `'unlit-material'` — 7 entries: base PBR material only (no inject)
  *    - `'hdrp-7-slot'` — 7 entries (binding 0 + 3..8): HDRP cluster + SSAO group(2) BGL
  * 2. Caps-driven literal shapes (no shader):
@@ -336,7 +354,7 @@ export declare const SPRITE_PASS_PER_INSTANCE_REGION_VARIANT_SET = "";
  *    - `'fullscreen-post-with-scene-depth-msaa'` — the depth-read layout with
  *      `texture.multisampled=true`, selected for a 4-sample scene depth target.
  */
-export type BglKind = 'pbr-view' | 'pbr-material-merged' | 'pbr-mesh-array' | 'pbr-instances' | 'pbr-gpu-driven-instances' | 'pbr-skin-mesh-array' | 'unlit-material' | 'hdrp-7-slot' | 'fullscreen-post' | 'fullscreen-post-with-params' | 'fullscreen-post-with-scene-depth' | 'fullscreen-post-with-scene-depth-msaa';
+export type BglKind = 'pbr-view' | 'pbr-material-merged' | 'pbr-mesh-array' | 'pbr-instances' | 'pbr-gpu-driven-instances' | 'pbr-surface-direct-instances' | 'pbr-skin-mesh-array' | 'unlit-material' | 'hdrp-7-slot' | 'fullscreen-post' | 'fullscreen-post-with-params' | 'fullscreen-post-with-scene-depth' | 'fullscreen-post-with-scene-depth-msaa' | 'fullscreen-post-with-paired-msaa';
 /**
  * Output shape of {@link buildBindGroupLayoutDescriptor}: matches the RHI
  * `BindGroupLayoutDescriptor` (label + entries with `ExplicitUndefined`) so

package/dist/pbr-pipeline.d.ts.map

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

package/dist/pipeline/single-layer-medium-passes.d.ts

@@ -0,0 +1,73 @@
+import { type GraphAccess, type GraphTextureDescriptor, type RenderGraphBuilder, RenderGraphError } from '@forgeax/engine-render-graph';
+import { type Result } from '@forgeax/engine-types';
+import type { RenderPipelineFrame, RenderPipelineGpuDrivenProjection, RenderPipelineSurfaceMediumPair, RenderPipelineTarget } from '../render-pipeline';
+/** Stable renderer-owned post-process identity for the independent depth copy. */
+export declare const SINGLE_LAYER_MEDIUM_RAW_DEPTH_POST_PROCESS_ID: "forgeax.single-layer-medium-raw-depth";
+export declare const SINGLE_LAYER_MEDIUM_MSAA_PAIRED_COLOR_POST_PROCESS_ID: "forgeax.single-layer-medium-msaa-paired-color";
+export declare const SINGLE_LAYER_MEDIUM_MSAA_RAW_DEPTH_POST_PROCESS_ID: "forgeax.single-layer-medium-msaa-raw-depth";
+export interface SingleLayerMediumMsaaPair {
+    readonly color: RenderPipelineTarget;
+    readonly depth: RenderPipelineTarget;
+}
+export interface SingleLayerMediumRawDepthProducerInput {
+    readonly graph: RenderGraphBuilder<RenderPipelineFrame>;
+    /** Resource/pass prefix; defaults to the opaque scene producer identity. */
+    readonly label?: string | undefined;
+    /** The already-resolved opaque color keeps the fullscreen primitive's input ABI complete. */
+    readonly sourceColor: RenderPipelineTarget;
+    /** The opaque depth pass output. It is sampled only by the copy producer. */
+    readonly sourceDepth: RenderPipelineTarget;
+    /** Must match the Standard scene depth extent (surface or internal resolution). */
+    readonly size: GraphTextureDescriptor['size'];
+}
+/**
+ * Produce an independent, single-sample raw-depth texture for Surface media.
+ *
+ * The graph source is the completed opaque depth pass and the destination is
+ * an r32float color target. This intermediate is the only place that samples
+ * the hardware depth view; medium materials bind the independent result while
+ * writing the scene depth attachment. MSAA is rejected at the producer seam
+ * until the backend has an explicit depth resolve policy.
+ */
+export declare function addSingleLayerMediumRawDepthProducer(input: SingleLayerMediumRawDepthProducerInput): Result<RenderPipelineTarget, RenderGraphError>;
+/**
+ * Resolve a four-sample color/depth pair by selecting the nearest depth sample
+ * and the color at that exact sample index. This is deliberately separate
+ * from WebGPU's averaging color resolve, which cannot preserve the opaque or
+ * nearest-water sample associated with the selected depth.
+ */
+export declare function addSingleLayerMediumMsaaPairProducer(input: {
+    readonly graph: RenderGraphBuilder<RenderPipelineFrame>;
+    readonly label: string;
+    readonly sourceColor: RenderPipelineTarget;
+    readonly sourceDepth: RenderPipelineTarget;
+    readonly size: GraphTextureDescriptor['size'];
+}): Result<SingleLayerMediumMsaaPair, RenderGraphError>;
+/** Inputs shared by the two graph passes owned by the Surface model. */
+export interface SingleLayerMediumPassInput {
+    readonly graph: RenderGraphBuilder<RenderPipelineFrame>;
+    readonly size: GraphTextureDescriptor['size'];
+    readonly nearestLayer: RenderPipelineTarget;
+    readonly nearestDepth: RenderPipelineTarget;
+    readonly color: RenderPipelineTarget;
+    readonly colorResolve?: RenderPipelineTarget | undefined;
+    readonly depth: RenderPipelineTarget;
+    readonly sampled?: readonly RenderPipelineTarget[] | undefined;
+    readonly directionalShadow?: RenderPipelineTarget | undefined;
+    readonly spotShadow?: RenderPipelineTarget | undefined;
+    /** Optional producer-owned cloud shadow bound through the Standard frame group. */
+    readonly cloudShadow?: RenderPipelineTarget | undefined;
+    readonly ssao?: RenderPipelineTarget | undefined;
+    readonly extraAccesses?: readonly GraphAccess[] | undefined;
+    /** Producer-owned pair of opaque color and sampled raw-depth facts. */
+    readonly surfacePair: RenderPipelineSurfaceMediumPair;
+    readonly gpuDriven?: RenderPipelineGpuDrivenProjection | undefined;
+}
+/**
+ * Admit the nearest-layer and color Surface submissions to the existing
+ * Standard graph only when the producer supplied a paired sampled raw depth.
+ * The pair is deliberately an input: this helper does not invent a backdrop,
+ * copy depth, or turn an unavailable fact into a graph resource.
+ */
+export declare function addSingleLayerMediumPasses(input: SingleLayerMediumPassInput): Result<void, RenderGraphError>;
+//# sourceMappingURL=single-layer-medium-passes.d.ts.map

package/dist/pipeline/single-layer-medium-passes.d.ts.map

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

package/dist/pipeline/standard-forward-lane.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"standard-forward-lane.d.ts","sourceRoot":"","sources":["../../src/pipeline/standard-forward-lane.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EACV,cAAc,EAEd,sBAAsB,EACvB,MAAM,oBAAoB,CAAC;AA4B5B,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,0BAA0B,CAAC;AAM7E,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AAW/E,iBAAS,QAAQ,CACf,OAAO,EAAE,4BAA4B,EACrC,QAAQ,EAAE,sBAAsB,EAChC,QAAQ,EAAE,0BAA0B,GACnC,UAAU,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAuWrC;AAED,eAAO,MAAM,wBAAwB,iBAAW,CAAC"}
+{"version":3,"file":"standard-forward-lane.d.ts","sourceRoot":"","sources":["../../src/pipeline/standard-forward-lane.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EACV,cAAc,EAGd,sBAAsB,EACvB,MAAM,oBAAoB,CAAC;AAkC5B,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,0BAA0B,CAAC;AAM7E,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AAW/E,iBAAS,QAAQ,CACf,OAAO,EAAE,4BAA4B,EACrC,QAAQ,EAAE,sBAAsB,EAChC,QAAQ,EAAE,0BAA0B,GACnC,UAAU,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAimBrC;AAED,eAAO,MAAM,wBAAwB,iBAAW,CAAC"}

package/dist/pipeline/standard-output/graph.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"graph.d.ts","sourceRoot":"","sources":["../../../src/pipeline/standard-output/graph.ts"],"names":[],"mappings":"AAAA,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAE7D,OAAO,KAAK,EAGV,kBAAkB,EAClB,qBAAqB,EACtB,MAAM,SAAS,CAAC;AAEjB,qBAAa,uBAAwB,SAAQ,KAAK;IAChD,QAAQ,CAAC,IAAI,EAAG,8BAA8B,CAAU;IACxD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;gBAEzD,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;CAO5D;AAwCD,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,qBAAqB,GAAG,kBAAkB,CAyBzF;AAUD,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,kBAAkB,GACvB,MAAM,CAAC,kBAAkB,EAAE,uBAAuB,CAAC,CA0CrD"}
+{"version":3,"file":"graph.d.ts","sourceRoot":"","sources":["../../../src/pipeline/standard-output/graph.ts"],"names":[],"mappings":"AAAA,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAE7D,OAAO,KAAK,EAGV,kBAAkB,EAClB,qBAAqB,EACtB,MAAM,SAAS,CAAC;AAEjB,qBAAa,uBAAwB,SAAQ,KAAK;IAChD,QAAQ,CAAC,IAAI,EAAG,8BAA8B,CAAU;IACxD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;gBAEzD,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;CAO5D;AA0CD,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,qBAAqB,GAAG,kBAAkB,CA6BzF;AAUD,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,kBAAkB,GACvB,MAAM,CAAC,kBAAkB,EAAE,uBAAuB,CAAC,CA0CrD"}

package/dist/pipeline/standard-output/lut-gpu.d.ts

@@ -1,9 +1,9 @@
 import type { AssetRegistry } from '@forgeax/engine-assets-runtime';
-import type { World } from '@forgeax/engine-ecs';
 import type { RenderGraphBuilder, RenderGraphError } from '@forgeax/engine-render-graph';
 import type { BindGroup, BindGroupLayout, RhiDevice, Sampler, Texture, TextureView } from '@forgeax/engine-rhi';
 import { type Handle, type Result } from '@forgeax/engine-types';
 import type { GpuResidencyCache } from '../../device/gpu-residency';
+import type { RenderResourceScope } from '../../publication/resource-scope';
 import type { RenderPipelineFrame, RenderPipelineTarget } from '../../render-pipeline';
 import { type StandardLutAdmissionError, type StandardLutAdmissionErrorCode } from './lut-admission';
 export interface StandardLutGpuResources {
@@ -24,7 +24,7 @@ export interface StandardLutGraphProjection {
     readonly bindGroup: BindGroup;
 }
 export interface StandardLutGpuPreparationInput {
-    readonly world: World;
+    readonly world: RenderResourceScope;
     readonly handle: Handle<'TextureAsset', 'shared'>;
     readonly strength: number;
     readonly assets: AssetRegistry;

package/dist/pipeline/standard-output/lut-gpu.d.ts.map

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

package/dist/pipeline/standard-output/resources.d.ts

@@ -1,10 +1,10 @@
-import type { World } from '@forgeax/engine-ecs';
 import { type Result, RhiError } from '@forgeax/engine-rhi';
+import type { RenderResourceScope } from '../../publication/resource-scope';
 import type { RenderFrameState } from '../../record/frame-snapshot';
 import type { RenderSystemInternals } from '../../record/render-context';
 import type { CameraSnapshot } from '../../render-contract';
 /** Ordinary frames and detached recovery graphs prepare the same output resources. */
-export declare function prepareStandardOutputResources(state: RenderFrameState, internals: RenderSystemInternals, camera: CameraSnapshot | undefined, world: World): Result<void, RhiError>;
+export declare function prepareStandardOutputResources(state: RenderFrameState, internals: RenderSystemInternals, camera: CameraSnapshot | undefined, world: RenderResourceScope): Result<void, RhiError>;
 /** Drop lost-device handles without destroying them; retain only reset CPU/LKG facts. */
 export declare function resetStandardOutputForDeviceLoss(state: RenderFrameState, deviceEpoch: number): void;
 //# sourceMappingURL=resources.d.ts.map

package/dist/pipeline/standard-output/resources.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resources.d.ts","sourceRoot":"","sources":["../../../src/pipeline/standard-output/resources.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAW,KAAK,MAAM,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAErE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AACzE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAS5D,sFAAsF;AACtF,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,gBAAgB,EACvB,SAAS,EAAE,qBAAqB,EAChC,MAAM,EAAE,cAAc,GAAG,SAAS,EAClC,KAAK,EAAE,KAAK,GACX,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,CA6ExB;AAED,yFAAyF;AACzF,wBAAgB,gCAAgC,CAC9C,KAAK,EAAE,gBAAgB,EACvB,WAAW,EAAE,MAAM,GAClB,IAAI,CAiBN"}
+{"version":3,"file":"resources.d.ts","sourceRoot":"","sources":["../../../src/pipeline/standard-output/resources.ts"],"names":[],"mappings":"AAAA,OAAO,EAAW,KAAK,MAAM,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAErE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAC5E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AACzE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAS5D,sFAAsF;AACtF,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,gBAAgB,EACvB,SAAS,EAAE,qBAAqB,EAChC,MAAM,EAAE,cAAc,GAAG,SAAS,EAClC,KAAK,EAAE,mBAAmB,GACzB,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,CA6ExB;AAED,yFAAyF;AACzF,wBAAgB,gCAAgC,CAC9C,KAAK,EAAE,gBAAgB,EACvB,WAAW,EAAE,MAAM,GAClB,IAAI,CAiBN"}