@zephyr3d/scene 0.9.22 → 0.9.24

package/dist/render/rendergraph/frame_graph_context.js

@@ -7,7 +7,7 @@
  * pass can chain after the previous one and (optionally) emit its own, without
  * the builder threading a mutable `orderToken` local between blocks.
  *
- * @internal
+ * @public
  */ class OrderingScope {
     /** @internal */ _last = null;
     /**

package/dist/render/rendergraph/frame_graph_context.js.map

@@ -1 +1 @@
-{"version":3,"file":"frame_graph_context.js","sources":["../../../src/render/rendergraph/frame_graph_context.ts"],"sourcesContent":["import type { Nullable } from '@zephyr3d/base';\nimport type { RGHandle, RGPassBuilder } from './types';\nimport type { RenderGraph } from './rendergraph';\nimport type { RGBlackboard } from './blackboard';\nimport type { HistoryResourceManager } from './history_resource_manager';\nimport type { DrawContext } from '../drawable';\nimport type { RenderQueue } from '../render_queue';\nimport type { Texture2D, FrameBuffer } from '@zephyr3d/device';\nimport type { ForwardPlusOptions, FrameState, ForwardPlusBuildState } from './forward_plus_builder';\n\n/**\n * Ordering helper that encapsulates the side-effect \"order token\" chain.\n *\n * Side-effect passes (SkyUpdate, ClusterLights, ...) carry no data product, so\n * they are ordered relative to one another through logical tokens rather than\n * texture reads/writes. This scope tracks the most recently emitted token so a\n * pass can chain after the previous one and (optionally) emit its own, without\n * the builder threading a mutable `orderToken` local between blocks.\n *\n * @internal\n */\nexport class OrderingScope {\n  /** @internal */\n  private _last: Nullable<RGHandle> = null;\n\n  /**\n   * Declare a read on the most recently emitted ordering token, if any, to\n   * order the current pass after the previous side-effect pass.\n   *\n   * @param builder - The pass builder of the current pass.\n   */\n  chainInto(builder: RGPassBuilder): void {\n    if (this._last) {\n      builder.read(this._last);\n    }\n  }\n\n  /**\n   * Emit a new ordering token from the current pass and record it as the latest\n   * link in the chain.\n   *\n   * @param builder - The pass builder of the current pass.\n   * @param name - Debug label for the token.\n   * @returns The newly created token handle.\n   */\n  emit(builder: RGPassBuilder, name: string): RGHandle {\n    const token = builder.createToken(name);\n    this._last = token;\n    return token;\n  }\n\n  /** The most recently emitted ordering token, or null. */\n  get last(): Nullable<RGHandle> {\n    return this._last;\n  }\n}\n\n/**\n * Build-time context threaded through the Forward+ graph assembly.\n *\n * This aggregates everything the individual pass-build blocks previously reached\n * through enclosing function locals (`orderToken`, the mutable `depthHandle`,\n * result bundles, ...). Collecting them here is the seam that lets each pass be\n * expressed as an independent unit reading its inputs from a shared context\n * rather than from closure-captured variables.\n *\n * Handles for well-known frame resources (linear depth, scene color, ...) flow\n * through {@link FrameGraphContext.blackboard} keyed by\n * {@link ./blackboard#FrameResources}; the mutable execute-time state that is\n * not a render-graph resource stays on {@link FrameGraphContext.frame}.\n *\n * @internal\n */\nexport interface FrameGraphContext {\n  /** The render graph being populated for this frame. */\n  readonly graph: RenderGraph;\n  /** Frame draw context. */\n  readonly ctx: DrawContext;\n  /** The culled render queue for this frame. */\n  readonly renderQueue: RenderQueue;\n  /** Named registry of shared frame-resource handles. */\n  readonly blackboard: RGBlackboard;\n  /** Mutable execute-time state shared between pass callbacks. */\n  readonly frame: FrameState;\n  /** Cross-frame history resource manager, or null when unavailable. */\n  readonly history: Nullable<HistoryResourceManager<Texture2D>>;\n  /** Pipeline feature toggles derived from scene/camera state. */\n  readonly options: ForwardPlusOptions;\n  /** Ordering-token chain for side-effect passes. */\n  readonly ordering: OrderingScope;\n  /** The imported backbuffer handle (graph sink). */\n  readonly backbuffer: RGHandle;\n  /** Mutable build-state shared between modules for non-resource intermediates. */\n  readonly state: ForwardPlusBuildState;\n}\n\n/** Backend framebuffer type used by the Forward+ allocator. */\nexport type ForwardPlusFramebuffer = FrameBuffer;\n"],"names":["OrderingScope","_last","chainInto","builder","read","emit","name","token","createToken","last"],"mappings":"AAUA;;;;;;;;;;AAUC,IACM,MAAMA,aAAAA,CAAAA;qBAEX,KAAQC,GAA4B,IAAK;AAEzC;;;;;MAMAC,SAAAA,CAAUC,OAAsB,EAAQ;QACtC,IAAI,IAAI,CAACF,KAAK,EAAE;AACdE,YAAAA,OAAAA,CAAQC,IAAI,CAAC,IAAI,CAACH,KAAK,CAAA;AACzB;AACF;AAEA;;;;;;;AAOC,MACDI,IAAKF,CAAAA,OAAsB,EAAEG,IAAY,EAAY;QACnD,MAAMC,KAAAA,GAAQJ,OAAQK,CAAAA,WAAW,CAACF,IAAAA,CAAAA;QAClC,IAAI,CAACL,KAAK,GAAGM,KAAAA;QACb,OAAOA,KAAAA;AACT;8DAGA,IAAIE,IAA2B,GAAA;QAC7B,OAAO,IAAI,CAACR,KAAK;AACnB;AACF;;;;"}
+{"version":3,"file":"frame_graph_context.js","sources":["../../../src/render/rendergraph/frame_graph_context.ts"],"sourcesContent":["import type { Nullable } from '@zephyr3d/base';\nimport type { RGHandle, RGPassBuilder } from './types';\nimport type { RenderGraph } from './rendergraph';\nimport type { RGBlackboard } from './blackboard';\nimport type { HistoryResourceManager } from './history_resource_manager';\nimport type { DrawContext } from '../drawable';\nimport type { RenderQueue } from '../render_queue';\nimport type { Texture2D, FrameBuffer } from '@zephyr3d/device';\nimport type { ForwardPlusOptions, FrameState, ForwardPlusBuildState } from './forward_plus_builder';\n\n/**\n * Ordering helper that encapsulates the side-effect \"order token\" chain.\n *\n * Side-effect passes (SkyUpdate, ClusterLights, ...) carry no data product, so\n * they are ordered relative to one another through logical tokens rather than\n * texture reads/writes. This scope tracks the most recently emitted token so a\n * pass can chain after the previous one and (optionally) emit its own, without\n * the builder threading a mutable `orderToken` local between blocks.\n *\n * @public\n */\nexport class OrderingScope {\n  /** @internal */\n  private _last: Nullable<RGHandle> = null;\n\n  /**\n   * Declare a read on the most recently emitted ordering token, if any, to\n   * order the current pass after the previous side-effect pass.\n   *\n   * @param builder - The pass builder of the current pass.\n   */\n  chainInto(builder: RGPassBuilder): void {\n    if (this._last) {\n      builder.read(this._last);\n    }\n  }\n\n  /**\n   * Emit a new ordering token from the current pass and record it as the latest\n   * link in the chain.\n   *\n   * @param builder - The pass builder of the current pass.\n   * @param name - Debug label for the token.\n   * @returns The newly created token handle.\n   */\n  emit(builder: RGPassBuilder, name: string): RGHandle {\n    const token = builder.createToken(name);\n    this._last = token;\n    return token;\n  }\n\n  /** The most recently emitted ordering token, or null. */\n  get last(): Nullable<RGHandle> {\n    return this._last;\n  }\n}\n\n/**\n * Build-time context threaded through the Forward+ graph assembly.\n *\n * This aggregates everything the individual pass-build blocks previously reached\n * through enclosing function locals (`orderToken`, the mutable `depthHandle`,\n * result bundles, ...). Collecting them here is the seam that lets each pass be\n * expressed as an independent unit reading its inputs from a shared context\n * rather than from closure-captured variables.\n *\n * Handles for well-known frame resources (linear depth, scene color, ...) flow\n * through {@link RenderModuleContext.blackboard} keyed by\n * {@link ./blackboard#FrameResources}; the mutable execute-time state that is\n * not a render-graph resource stays on {@link FrameGraphContext.frame}.\n *\n * @public\n */\nexport interface RenderModuleContext {\n  /** The render graph being populated for this frame. */\n  readonly graph: RenderGraph;\n  /** Frame draw context. */\n  readonly ctx: DrawContext;\n  /** The culled render queue for this frame. */\n  readonly renderQueue: RenderQueue;\n  /** Named registry of shared frame-resource handles (see {@link ./blackboard#FrameResources}). */\n  readonly blackboard: RGBlackboard;\n  /** Cross-frame history resource manager, or null when unavailable. */\n  readonly history: Nullable<HistoryResourceManager<Texture2D>>;\n  /** Pipeline feature toggles derived from scene/camera state. */\n  readonly options: ForwardPlusOptions;\n  /** Ordering-token chain for side-effect passes. */\n  readonly ordering: OrderingScope;\n  /** The imported backbuffer handle (graph sink). */\n  readonly backbuffer: RGHandle;\n}\n\n/**\n * Full build-time context threaded through the Forward+ pipeline. Extends the\n * public {@link RenderModuleContext} with the Forward+ pipeline's internal\n * mutable state, which built-in modules read/write but custom modules should\n * not depend on.\n *\n * @internal\n */\nexport interface FrameGraphContext extends RenderModuleContext {\n  /** Mutable execute-time state shared between pass callbacks. */\n  readonly frame: FrameState;\n  /** Mutable build-state shared between modules for non-resource intermediates. */\n  readonly state: ForwardPlusBuildState;\n}\n\n/** Backend framebuffer type used by the Forward+ allocator. */\nexport type ForwardPlusFramebuffer = FrameBuffer;\n"],"names":["OrderingScope","_last","chainInto","builder","read","emit","name","token","createToken","last"],"mappings":"AAUA;;;;;;;;;;AAUC,IACM,MAAMA,aAAAA,CAAAA;qBAEX,KAAQC,GAA4B,IAAK;AAEzC;;;;;MAMAC,SAAAA,CAAUC,OAAsB,EAAQ;QACtC,IAAI,IAAI,CAACF,KAAK,EAAE;AACdE,YAAAA,OAAAA,CAAQC,IAAI,CAAC,IAAI,CAACH,KAAK,CAAA;AACzB;AACF;AAEA;;;;;;;AAOC,MACDI,IAAKF,CAAAA,OAAsB,EAAEG,IAAY,EAAY;QACnD,MAAMC,KAAAA,GAAQJ,OAAQK,CAAAA,WAAW,CAACF,IAAAA,CAAAA;QAClC,IAAI,CAACL,KAAK,GAAGM,KAAAA;QACb,OAAOA,KAAAA;AACT;8DAGA,IAAIE,IAA2B,GAAA;QAC7B,OAAO,IAAI,CAACR,KAAK;AACnB;AACF;;;;"}

package/dist/render/rendergraph/frame_resource_requirements.js

@@ -0,0 +1,14 @@
+/** Frame resources requested before Forward+ module setup. @public */ /** Merge frame-resource requirements using monotonic OR semantics. @public */ function mergeFrameResourceRequirements(target, source) {
+    if (!source) {
+        return target;
+    }
+    target.motionVector = !!target.motionVector || !!source.motionVector;
+    target.hiZ = !!target.hiZ || !!source.hiZ;
+    target.sceneNormal = !!target.sceneNormal || !!source.sceneNormal;
+    target.sceneRoughness = !!target.sceneRoughness || !!source.sceneRoughness;
+    target.shadowMask = !!target.shadowMask || !!source.shadowMask;
+    return target;
+}
+
+export { mergeFrameResourceRequirements };
+//# sourceMappingURL=frame_resource_requirements.js.map

package/dist/render/rendergraph/frame_resource_requirements.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frame_resource_requirements.js","sources":["../../../src/render/rendergraph/frame_resource_requirements.ts"],"sourcesContent":["/** Frame resources requested before Forward+ module setup. @public */\r\nexport interface FrameResourceRequirements {\r\n  motionVector?: boolean;\r\n  hiZ?: boolean;\r\n  sceneNormal?: boolean;\r\n  sceneRoughness?: boolean;\r\n  shadowMask?: boolean;\r\n}\r\n\r\n/** Merge frame-resource requirements using monotonic OR semantics. @public */\r\nexport function mergeFrameResourceRequirements(\r\n  target: FrameResourceRequirements,\r\n  source: FrameResourceRequirements | null | undefined\r\n): FrameResourceRequirements {\r\n  if (!source) {\r\n    return target;\r\n  }\r\n  target.motionVector = !!target.motionVector || !!source.motionVector;\r\n  target.hiZ = !!target.hiZ || !!source.hiZ;\r\n  target.sceneNormal = !!target.sceneNormal || !!source.sceneNormal;\r\n  target.sceneRoughness = !!target.sceneRoughness || !!source.sceneRoughness;\r\n  target.shadowMask = !!target.shadowMask || !!source.shadowMask;\r\n  return target;\r\n}\r\n"],"names":["mergeFrameResourceRequirements","target","source","motionVector","hiZ","sceneNormal","sceneRoughness","shadowMask"],"mappings":"AAAA,sJAUO,SAASA,8BACdC,CAAAA,MAAiC,EACjCC,MAAoD,EAAA;AAEpD,IAAA,IAAI,CAACA,MAAQ,EAAA;QACX,OAAOD,MAAAA;AACT;IACAA,MAAOE,CAAAA,YAAY,GAAG,CAAC,CAACF,MAAAA,CAAOE,YAAY,IAAI,CAAC,CAACD,MAAAA,CAAOC,YAAY;IACpEF,MAAOG,CAAAA,GAAG,GAAG,CAAC,CAACH,MAAAA,CAAOG,GAAG,IAAI,CAAC,CAACF,MAAAA,CAAOE,GAAG;IACzCH,MAAOI,CAAAA,WAAW,GAAG,CAAC,CAACJ,MAAAA,CAAOI,WAAW,IAAI,CAAC,CAACH,MAAAA,CAAOG,WAAW;IACjEJ,MAAOK,CAAAA,cAAc,GAAG,CAAC,CAACL,MAAAA,CAAOK,cAAc,IAAI,CAAC,CAACJ,MAAAA,CAAOI,cAAc;IAC1EL,MAAOM,CAAAA,UAAU,GAAG,CAAC,CAACN,MAAAA,CAAOM,UAAU,IAAI,CAAC,CAACL,MAAAA,CAAOK,UAAU;IAC9D,OAAON,MAAAA;AACT;;;;"}

package/dist/render/rendergraph/history_resource_manager.js

@@ -1,48 +1,18 @@
-/**
- * Manages cross-frame history resources that can be imported into a render graph.
- *
- * History resources are textures that persist across frames for temporal effects
- * like TAA, motion blur, or temporal upscaling. Previous-frame textures can be
- * imported into a {@link RenderGraph}, and current-frame textures are committed
- * only after graph execution succeeds.
- *
- * Usage:
- * ```ts
- * const historyMgr = new HistoryResourceManager(allocator);
- * historyMgr.beginFrame();
- * const prev = historyMgr.importPrevious(graph, 'taaColor');
- * // declare builder.read(prev) if non-null
- * historyMgr.bindImportedTextures(executor);
- * // after successful execution:
- * historyMgr.commitFrame();
- * ```
- *
- * @typeParam TTexture - The concrete texture type (e.g. `Texture2D`).
- * @public
- */ class HistoryResourceManager {
+/** Manages render graph textures retained across frames. @public */ class HistoryResourceManager {
     _resources = new Map();
     _allocator;
     _pendingImports = new Map();
     _pendingCommits = new Map();
     _readScopeStack = [];
     _frameActive = false;
-    /**
-   * Create a new history resource manager.
-   *
-   * @param allocator - Texture allocator for creating history textures.
-   */ constructor(allocator){
+    // Delay replaced commits until frame end to prevent pool reuse while queued.
+    _deferredReleases = [];
+    /** Create a history manager using the given allocator. */ constructor(allocator){
         this._allocator = allocator;
     }
     /**
-   * Get the previous-frame texture resolved by the current render graph pass.
-   *
-   * The resource must have been imported with {@link HistoryResourceManager.importPrevious} or
-   * {@link HistoryResourceManager.importPreviousIfCompatible}, declared as a pass read, and bound with
-   * {@link HistoryResourceManager.beginReadScope} before this method is called.
-   *
-   * @param name - Name of the history resource.
-   * @returns The graph-resolved previous-frame texture.
-   * @throws If no read scope is active for the resource.
+   * Return a previous-frame texture from the active read scope.
+   * @throws When the resource is not available in that scope.
    */ getPrevious(name) {
         const scoped = this._getScopedRead(name);
         if (scoped) {
@@ -50,49 +20,23 @@
         }
         throw new Error(`History resource '${name}' is not available in the current render graph read scope. ` + `Import it and declare a pass read before accessing it.`);
     }
-    /**
-   * Try to get a previous-frame texture from the current render graph read scope.
-   *
-   * Returns null when the resource was not imported for the current pass.
-   *
-   * @param name - Name of the history resource.
-   * @returns The scoped previous-frame texture, or null.
-   */ tryGetPrevious(name) {
+    /** Return a scoped previous-frame texture, or null. */ tryGetPrevious(name) {
         return this._getScopedRead(name);
     }
-    /**
-   * Whether this manager is currently collecting imports/commits for a graph frame.
-   */ get frameActive() {
+    /** Whether a history frame is active. */ get frameActive() {
         return this._frameActive;
     }
-    /**
-   * Check whether a valid history resource exists and matches the descriptor.
-   *
-   * @param name - Name of the history resource.
-   * @param desc - Expected texture descriptor.
-   * @param size - Expected resolved size.
-   * @returns True if the resource exists, is valid, and matches.
-   */ isCompatible(name, desc, size) {
+    /** Check for valid history matching the descriptor and size. */ isCompatible(name, desc, size) {
         const resource = this._resources.get(name);
         return !!resource?.valid && this._matches(resource, desc, size);
     }
-    /**
-   * Start collecting graph imports and deferred commits for a new frame.
-   */ beginFrame() {
+    /** Begin collecting imports and commits for a frame. */ beginFrame() {
         this.discardFrame();
         this._pendingImports.clear();
         this._readScopeStack.length = 0;
         this._frameActive = true;
     }
-    /**
-   * Import the latest committed texture for a history resource into the graph.
-   *
-   * Returns null when the resource has no valid previous frame.
-   *
-   * @param graph - Render graph to import into.
-   * @param name - History resource name.
-   * @returns Imported graph handle, or null when no valid previous texture exists.
-   */ importPrevious(graph, name) {
+    /** Import the latest history texture, or return null when unavailable. */ importPrevious(graph, name) {
         const resource = this._resources.get(name);
         const texture = resource?.valid ? resource.textures[resource.currentIndex] : null;
         if (!texture) {
@@ -103,60 +47,36 @@
         return handle;
     }
     /**
-   * Import the latest committed texture only when it matches the expected shape.
-   *
-   * This is the preferred API for effects that can declare their history reads
-   * while building the graph: incompatible history is treated as absent, so the
-   * pass does not declare stale reads after resize or format changes.
-   *
-   * @param graph - Render graph to import into.
-   * @param name - History resource name.
-   * @param desc - Expected texture descriptor.
-   * @param size - Expected resolved size.
-   * @returns Imported graph handle, or null when no compatible history exists.
+   * Import the latest history only when its descriptor and size match.
    */ importPreviousIfCompatible(graph, name, desc, size) {
         return this.isCompatible(name, desc, size) ? this.importPrevious(graph, name) : null;
     }
-    /**
-   * Bind all history imports created for this frame to the executor.
-   *
-   * @param executor - Render graph executor for the current frame.
-   */ bindImportedTextures(executor) {
+    /** Bind this frame's history imports to an executor. */ bindImportedTextures(executor) {
         for (const [handle, texture] of this._pendingImports){
             executor.setImportedTexture(handle, texture);
         }
     }
-    /**
-   * Make resolved history textures available to code executing inside a pass.
-   *
-   * @param bindings - History name to resolved texture bindings.
-   */ beginReadScope(bindings) {
+    /** Push a history read scope for pass execution. */ beginReadScope(bindings) {
         const scope = new Map();
         for (const binding of bindings){
             scope.set(binding.name, binding.texture);
         }
         this._readScopeStack.push(scope);
     }
-    /**
-   * End the most recent history read scope.
-   */ endReadScope() {
+    /** Pop the latest history read scope. */ endReadScope() {
         this._readScopeStack.pop();
     }
     /**
-   * Queue a current-frame texture to become the next previous-frame history.
-   *
-   * The texture is committed only when {@link HistoryResourceManager.commitFrame} is called. If the
-   * frame fails, {@link HistoryResourceManager.discardFrame} releases owned pending textures instead.
-   *
-   * @param name - History resource name.
-   * @param desc - Texture descriptor.
-   * @param size - Resolved texture size.
-   * @param texture - Texture produced by the current frame.
-   * @param ownsTexture - Whether this manager should release the texture later.
+   * Queue the next history texture. It becomes visible on `commitFrame`; owned
+   * textures are released on `discardFrame`.
    */ queueCommit(name, desc, size, texture, ownsTexture = true) {
+        if (!this._frameActive) {
+            throw new Error(`HistoryResourceManager: cannot queue history commit '${name}' outside an active frame. ` + `Call beginFrame() first.`);
+        }
         const existing = this._pendingCommits.get(name);
-        if (existing?.ownsTexture) {
-            this._allocator.release(existing.texture);
+        if (existing?.ownsTexture && existing.texture !== texture) {
+            // Re-queuing the same texture keeps its existing reference.
+            this._deferredReleases.push(existing.texture);
         }
         this._pendingCommits.set(name, {
             desc: {
@@ -170,44 +90,20 @@
         });
     }
     /**
-   * Queue a graph-produced texture as a current-frame history write.
-   *
-   * The allocator must retain the texture before the graph executor releases its
-   * transient reference. Use this from inside the pass that declares access to
-   * the handle being committed.
-   *
-   * @param name - History resource name.
-   * @param desc - Texture descriptor.
-   * @param size - Resolved texture size.
-   * @param ctx - Current render graph execute context.
-   * @param handle - Graph texture handle to commit.
-   * @returns The retained texture.
+   * Retain and queue a graph texture from its declaring pass.
    */ queueCommitFromGraph(name, desc, size, ctx, handle) {
         const texture = ctx.getTexture(handle);
         this.queueRetainedCommit(name, desc, size, texture);
         return texture;
     }
-    /**
-   * Queue a texture after retaining it through the allocator.
-   *
-   * Use this for textures produced by the graph allocator. The manager owns the
-   * retained reference and releases it when the history slot is overwritten,
-   * discarded, or disposed.
-   *
-   * @param name - History resource name.
-   * @param desc - Texture descriptor.
-   * @param size - Resolved texture size.
-   * @param texture - Texture to retain and commit.
-   */ queueRetainedCommit(name, desc, size, texture) {
+    /** Retain a texture through the allocator and queue it as history. */ queueRetainedCommit(name, desc, size, texture) {
         if (!this._allocator.retain) {
             throw new Error(`HistoryResourceManager: cannot retain history resource '${name}'. ` + `The allocator does not support retained graph texture handoff.`);
         }
         this._allocator.retain(texture);
         this.queueCommit(name, desc, size, texture, true);
     }
-    /**
-   * Commit all current-frame history writes.
-   */ commitFrame() {
+    /** Commit all pending history writes. */ commitFrame() {
         for (const [name, pending] of this._pendingCommits){
             let resource = this._resources.get(name);
             if (resource && !this._matches(resource, pending.desc, pending.size)) {
@@ -253,10 +149,9 @@
         this._pendingImports.clear();
         this._readScopeStack.length = 0;
         this._frameActive = false;
+        this._flushDeferredReleases();
     }
-    /**
-   * Discard all uncommitted frame history writes.
-   */ discardFrame() {
+    /** Discard all pending history writes. */ discardFrame() {
         for (const pending of this._pendingCommits.values()){
             if (pending.ownsTexture) {
                 this._allocator.release(pending.texture);
@@ -266,12 +161,50 @@
         this._pendingImports.clear();
         this._readScopeStack.length = 0;
         this._frameActive = false;
+        this._flushDeferredReleases();
     }
     /**
-   * Release all history resources and clear the manager.
-   *
-   * Call this when disposing the render context or when history is no longer needed.
-   */ dispose() {
+   * Invalidate one named history resource without disturbing unrelated
+   * temporal effects. If called during a frame, owned textures are released
+   * after that frame so already-imported graph reads remain valid.
+   */ invalidate(name) {
+        const pending = this._pendingCommits.get(name);
+        if (pending) {
+            if (pending.ownsTexture) {
+                if (this._frameActive) {
+                    this._deferredReleases.push(pending.texture);
+                } else {
+                    this._allocator.release(pending.texture);
+                }
+            }
+            this._pendingCommits.delete(name);
+        }
+        const resource = this._resources.get(name);
+        if (!resource) {
+            return;
+        }
+        if (this._frameActive) {
+            for(let i = 0; i < resource.textures.length; i++){
+                const texture = resource.textures[i];
+                if (texture && resource.ownsTexture[i]) {
+                    this._deferredReleases.push(texture);
+                }
+                resource.textures[i] = null;
+                resource.ownsTexture[i] = false;
+            }
+            resource.valid = false;
+        } else {
+            this._releaseResource(resource);
+        }
+        this._resources.delete(name);
+    }
+    /** @internal */ _flushDeferredReleases() {
+        for (const texture of this._deferredReleases){
+            this._allocator.release(texture);
+        }
+        this._deferredReleases.length = 0;
+    }
+    /** Release all history resources. */ dispose() {
         this.discardFrame();
         for (const resource of this._resources.values()){
             this._releaseResource(resource);
@@ -288,7 +221,8 @@
         return null;
     }
     /** @internal */ _matches(resource, desc, size) {
-        return resource.desc.format === desc.format && (resource.desc.mipLevels ?? 1) === (desc.mipLevels ?? 1) && resource.size.width === size.width && resource.size.height === size.height;
+        return resource.desc.format === desc.format && (resource.desc.mipLevels ?? 1) === (desc.mipLevels ?? 1) && // A 2D texture and a one-layer array are distinct types.
+        resource.desc.arrayLayers === desc.arrayLayers && resource.size.width === size.width && resource.size.height === size.height;
     }
     /** @internal */ _releaseResource(resource) {
         this._releaseSlot(resource, 0);
@@ -300,8 +234,8 @@
         if (!texture) {
             return;
         }
-        const otherIndex = 1 - index;
-        if (resource.ownsTexture[index] && resource.textures[otherIndex] !== texture) {
+        // Each owning slot represents one retained reference.
+        if (resource.ownsTexture[index]) {
             this._allocator.release(texture);
         }
         resource.textures[index] = null;

package/dist/render/rendergraph/history_resource_manager.js.map

@@ -1 +1 @@
-{"version":3,"file":"history_resource_manager.js","sources":["../../../src/render/rendergraph/history_resource_manager.ts"],"sourcesContent":["import type { Texture2D } from '@zephyr3d/device';\r\nimport type { RenderGraph } from './rendergraph';\r\nimport type { RenderGraphExecutor } from './executor';\r\nimport type { RGHandle, RGExecuteContext, RGTextureAllocator, RGTextureDesc, RGResolvedSize } from './types';\r\n\r\ninterface HistoryResource<TTexture> {\r\n  desc: RGTextureDesc;\r\n  size: RGResolvedSize;\r\n  textures: [TTexture | null, TTexture | null];\r\n  ownsTexture: [boolean, boolean];\r\n  currentIndex: number;\r\n  valid: boolean;\r\n}\r\n\r\ninterface PendingHistoryCommit<TTexture> {\r\n  desc: RGTextureDesc;\r\n  size: RGResolvedSize;\r\n  texture: TTexture;\r\n  ownsTexture: boolean;\r\n}\r\n\r\n/**\r\n * Manages cross-frame history resources that can be imported into a render graph.\r\n *\r\n * History resources are textures that persist across frames for temporal effects\r\n * like TAA, motion blur, or temporal upscaling. Previous-frame textures can be\r\n * imported into a {@link RenderGraph}, and current-frame textures are committed\r\n * only after graph execution succeeds.\r\n *\r\n * Usage:\r\n * ```ts\r\n * const historyMgr = new HistoryResourceManager(allocator);\r\n * historyMgr.beginFrame();\r\n * const prev = historyMgr.importPrevious(graph, 'taaColor');\r\n * // declare builder.read(prev) if non-null\r\n * historyMgr.bindImportedTextures(executor);\r\n * // after successful execution:\r\n * historyMgr.commitFrame();\r\n * ```\r\n *\r\n * @typeParam TTexture - The concrete texture type (e.g. `Texture2D`).\r\n * @public\r\n */\r\nexport class HistoryResourceManager<TTexture = Texture2D> {\r\n  private _resources: Map<string, HistoryResource<TTexture>> = new Map();\r\n  private _allocator: RGTextureAllocator<TTexture>;\r\n  private _pendingImports: Map<RGHandle, TTexture> = new Map();\r\n  private _pendingCommits: Map<string, PendingHistoryCommit<TTexture>> = new Map();\r\n  private _readScopeStack: Array<Map<string, TTexture>> = [];\r\n  private _frameActive = false;\r\n\r\n  /**\r\n   * Create a new history resource manager.\r\n   *\r\n   * @param allocator - Texture allocator for creating history textures.\r\n   */\r\n  constructor(allocator: RGTextureAllocator<TTexture>) {\r\n    this._allocator = allocator;\r\n  }\r\n\r\n  /**\r\n   * Get the previous-frame texture resolved by the current render graph pass.\r\n   *\r\n   * The resource must have been imported with {@link HistoryResourceManager.importPrevious} or\r\n   * {@link HistoryResourceManager.importPreviousIfCompatible}, declared as a pass read, and bound with\r\n   * {@link HistoryResourceManager.beginReadScope} before this method is called.\r\n   *\r\n   * @param name - Name of the history resource.\r\n   * @returns The graph-resolved previous-frame texture.\r\n   * @throws If no read scope is active for the resource.\r\n   */\r\n  getPrevious(name: string): TTexture {\r\n    const scoped = this._getScopedRead(name);\r\n    if (scoped) {\r\n      return scoped;\r\n    }\r\n    throw new Error(\r\n      `History resource '${name}' is not available in the current render graph read scope. ` +\r\n        `Import it and declare a pass read before accessing it.`\r\n    );\r\n  }\r\n\r\n  /**\r\n   * Try to get a previous-frame texture from the current render graph read scope.\r\n   *\r\n   * Returns null when the resource was not imported for the current pass.\r\n   *\r\n   * @param name - Name of the history resource.\r\n   * @returns The scoped previous-frame texture, or null.\r\n   */\r\n  tryGetPrevious(name: string): TTexture | null {\r\n    return this._getScopedRead(name);\r\n  }\r\n\r\n  /**\r\n   * Whether this manager is currently collecting imports/commits for a graph frame.\r\n   */\r\n  get frameActive(): boolean {\r\n    return this._frameActive;\r\n  }\r\n\r\n  /**\r\n   * Check whether a valid history resource exists and matches the descriptor.\r\n   *\r\n   * @param name - Name of the history resource.\r\n   * @param desc - Expected texture descriptor.\r\n   * @param size - Expected resolved size.\r\n   * @returns True if the resource exists, is valid, and matches.\r\n   */\r\n  isCompatible(name: string, desc: RGTextureDesc, size: RGResolvedSize): boolean {\r\n    const resource = this._resources.get(name);\r\n    return !!resource?.valid && this._matches(resource, desc, size);\r\n  }\r\n\r\n  /**\r\n   * Start collecting graph imports and deferred commits for a new frame.\r\n   */\r\n  beginFrame(): void {\r\n    this.discardFrame();\r\n    this._pendingImports.clear();\r\n    this._readScopeStack.length = 0;\r\n    this._frameActive = true;\r\n  }\r\n\r\n  /**\r\n   * Import the latest committed texture for a history resource into the graph.\r\n   *\r\n   * Returns null when the resource has no valid previous frame.\r\n   *\r\n   * @param graph - Render graph to import into.\r\n   * @param name - History resource name.\r\n   * @returns Imported graph handle, or null when no valid previous texture exists.\r\n   */\r\n  importPrevious(graph: RenderGraph, name: string): RGHandle | null {\r\n    const resource = this._resources.get(name);\r\n    const texture = resource?.valid ? resource.textures[resource.currentIndex] : null;\r\n    if (!texture) {\r\n      return null;\r\n    }\r\n    const handle = graph.importTexture(`history:${name}:previous`);\r\n    this._pendingImports.set(handle, texture);\r\n    return handle;\r\n  }\r\n\r\n  /**\r\n   * Import the latest committed texture only when it matches the expected shape.\r\n   *\r\n   * This is the preferred API for effects that can declare their history reads\r\n   * while building the graph: incompatible history is treated as absent, so the\r\n   * pass does not declare stale reads after resize or format changes.\r\n   *\r\n   * @param graph - Render graph to import into.\r\n   * @param name - History resource name.\r\n   * @param desc - Expected texture descriptor.\r\n   * @param size - Expected resolved size.\r\n   * @returns Imported graph handle, or null when no compatible history exists.\r\n   */\r\n  importPreviousIfCompatible(\r\n    graph: RenderGraph,\r\n    name: string,\r\n    desc: RGTextureDesc,\r\n    size: RGResolvedSize\r\n  ): RGHandle | null {\r\n    return this.isCompatible(name, desc, size) ? this.importPrevious(graph, name) : null;\r\n  }\r\n\r\n  /**\r\n   * Bind all history imports created for this frame to the executor.\r\n   *\r\n   * @param executor - Render graph executor for the current frame.\r\n   */\r\n  bindImportedTextures(executor: Pick<RenderGraphExecutor<TTexture>, 'setImportedTexture'>): void {\r\n    for (const [handle, texture] of this._pendingImports) {\r\n      executor.setImportedTexture(handle, texture);\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Make resolved history textures available to code executing inside a pass.\r\n   *\r\n   * @param bindings - History name to resolved texture bindings.\r\n   */\r\n  beginReadScope(bindings: Array<{ name: string; texture: TTexture }>): void {\r\n    const scope = new Map<string, TTexture>();\r\n    for (const binding of bindings) {\r\n      scope.set(binding.name, binding.texture);\r\n    }\r\n    this._readScopeStack.push(scope);\r\n  }\r\n\r\n  /**\r\n   * End the most recent history read scope.\r\n   */\r\n  endReadScope(): void {\r\n    this._readScopeStack.pop();\r\n  }\r\n\r\n  /**\r\n   * Queue a current-frame texture to become the next previous-frame history.\r\n   *\r\n   * The texture is committed only when {@link HistoryResourceManager.commitFrame} is called. If the\r\n   * frame fails, {@link HistoryResourceManager.discardFrame} releases owned pending textures instead.\r\n   *\r\n   * @param name - History resource name.\r\n   * @param desc - Texture descriptor.\r\n   * @param size - Resolved texture size.\r\n   * @param texture - Texture produced by the current frame.\r\n   * @param ownsTexture - Whether this manager should release the texture later.\r\n   */\r\n  queueCommit(\r\n    name: string,\r\n    desc: RGTextureDesc,\r\n    size: RGResolvedSize,\r\n    texture: TTexture,\r\n    ownsTexture = true\r\n  ): void {\r\n    const existing = this._pendingCommits.get(name);\r\n    if (existing?.ownsTexture) {\r\n      this._allocator.release(existing.texture);\r\n    }\r\n    this._pendingCommits.set(name, {\r\n      desc: { ...desc },\r\n      size: { ...size },\r\n      texture,\r\n      ownsTexture\r\n    });\r\n  }\r\n\r\n  /**\r\n   * Queue a graph-produced texture as a current-frame history write.\r\n   *\r\n   * The allocator must retain the texture before the graph executor releases its\r\n   * transient reference. Use this from inside the pass that declares access to\r\n   * the handle being committed.\r\n   *\r\n   * @param name - History resource name.\r\n   * @param desc - Texture descriptor.\r\n   * @param size - Resolved texture size.\r\n   * @param ctx - Current render graph execute context.\r\n   * @param handle - Graph texture handle to commit.\r\n   * @returns The retained texture.\r\n   */\r\n  queueCommitFromGraph(\r\n    name: string,\r\n    desc: RGTextureDesc,\r\n    size: RGResolvedSize,\r\n    ctx: Pick<RGExecuteContext, 'getTexture'>,\r\n    handle: RGHandle\r\n  ): TTexture {\r\n    const texture = ctx.getTexture<TTexture>(handle);\r\n    this.queueRetainedCommit(name, desc, size, texture);\r\n    return texture;\r\n  }\r\n\r\n  /**\r\n   * Queue a texture after retaining it through the allocator.\r\n   *\r\n   * Use this for textures produced by the graph allocator. The manager owns the\r\n   * retained reference and releases it when the history slot is overwritten,\r\n   * discarded, or disposed.\r\n   *\r\n   * @param name - History resource name.\r\n   * @param desc - Texture descriptor.\r\n   * @param size - Resolved texture size.\r\n   * @param texture - Texture to retain and commit.\r\n   */\r\n  queueRetainedCommit(name: string, desc: RGTextureDesc, size: RGResolvedSize, texture: TTexture): void {\r\n    if (!this._allocator.retain) {\r\n      throw new Error(\r\n        `HistoryResourceManager: cannot retain history resource '${name}'. ` +\r\n          `The allocator does not support retained graph texture handoff.`\r\n      );\r\n    }\r\n    this._allocator.retain(texture);\r\n    this.queueCommit(name, desc, size, texture, true);\r\n  }\r\n\r\n  /**\r\n   * Commit all current-frame history writes.\r\n   */\r\n  commitFrame(): void {\r\n    for (const [name, pending] of this._pendingCommits) {\r\n      let resource = this._resources.get(name);\r\n      if (resource && !this._matches(resource, pending.desc, pending.size)) {\r\n        this._releaseResource(resource);\r\n        this._resources.delete(name);\r\n        resource = undefined;\r\n      }\r\n      if (!resource) {\r\n        resource = {\r\n          desc: { ...pending.desc },\r\n          size: { ...pending.size },\r\n          textures: [null, null],\r\n          ownsTexture: [false, false],\r\n          currentIndex: 0,\r\n          valid: false\r\n        };\r\n        this._resources.set(name, resource);\r\n      }\r\n\r\n      const writeIndex = resource.valid ? 1 - resource.currentIndex : resource.currentIndex;\r\n      this._releaseSlot(resource, writeIndex);\r\n      resource.textures[writeIndex] = pending.texture;\r\n      resource.ownsTexture[writeIndex] = pending.ownsTexture;\r\n      resource.desc = { ...pending.desc };\r\n      resource.size = { ...pending.size };\r\n      resource.currentIndex = writeIndex;\r\n      resource.valid = true;\r\n    }\r\n    this._pendingCommits.clear();\r\n    this._pendingImports.clear();\r\n    this._readScopeStack.length = 0;\r\n    this._frameActive = false;\r\n  }\r\n\r\n  /**\r\n   * Discard all uncommitted frame history writes.\r\n   */\r\n  discardFrame(): void {\r\n    for (const pending of this._pendingCommits.values()) {\r\n      if (pending.ownsTexture) {\r\n        this._allocator.release(pending.texture);\r\n      }\r\n    }\r\n    this._pendingCommits.clear();\r\n    this._pendingImports.clear();\r\n    this._readScopeStack.length = 0;\r\n    this._frameActive = false;\r\n  }\r\n\r\n  /**\r\n   * Release all history resources and clear the manager.\r\n   *\r\n   * Call this when disposing the render context or when history is no longer needed.\r\n   */\r\n  dispose(): void {\r\n    this.discardFrame();\r\n    for (const resource of this._resources.values()) {\r\n      this._releaseResource(resource);\r\n    }\r\n    this._resources.clear();\r\n  }\r\n\r\n  /** @internal */\r\n  private _getScopedRead(name: string): TTexture | null {\r\n    for (let i = this._readScopeStack.length - 1; i >= 0; i--) {\r\n      const texture = this._readScopeStack[i].get(name);\r\n      if (texture) {\r\n        return texture;\r\n      }\r\n    }\r\n    return null;\r\n  }\r\n\r\n  /** @internal */\r\n  private _matches(resource: HistoryResource<TTexture>, desc: RGTextureDesc, size: RGResolvedSize): boolean {\r\n    return (\r\n      resource.desc.format === desc.format &&\r\n      (resource.desc.mipLevels ?? 1) === (desc.mipLevels ?? 1) &&\r\n      resource.size.width === size.width &&\r\n      resource.size.height === size.height\r\n    );\r\n  }\r\n\r\n  /** @internal */\r\n  private _releaseResource(resource: HistoryResource<TTexture>): void {\r\n    this._releaseSlot(resource, 0);\r\n    this._releaseSlot(resource, 1);\r\n    resource.valid = false;\r\n  }\r\n\r\n  /** @internal */\r\n  private _releaseSlot(resource: HistoryResource<TTexture>, index: number): void {\r\n    const texture = resource.textures[index];\r\n    if (!texture) {\r\n      return;\r\n    }\r\n    const otherIndex = 1 - index;\r\n    if (resource.ownsTexture[index] && resource.textures[otherIndex] !== texture) {\r\n      this._allocator.release(texture);\r\n    }\r\n    resource.textures[index] = null;\r\n    resource.ownsTexture[index] = false;\r\n  }\r\n}\r\n"],"names":["HistoryResourceManager","_resources","Map","_allocator","_pendingImports","_pendingCommits","_readScopeStack","_frameActive","allocator","getPrevious","name","scoped","_getScopedRead","Error","tryGetPrevious","frameActive","isCompatible","desc","size","resource","get","valid","_matches","beginFrame","discardFrame","clear","length","importPrevious","graph","texture","textures","currentIndex","handle","importTexture","set","importPreviousIfCompatible","bindImportedTextures","executor","setImportedTexture","beginReadScope","bindings","scope","binding","push","endReadScope","pop","queueCommit","ownsTexture","existing","release","queueCommitFromGraph","ctx","getTexture","queueRetainedCommit","retain","commitFrame","pending","_releaseResource","delete","undefined","writeIndex","_releaseSlot","values","dispose","i","format","mipLevels","width","height","index","otherIndex"],"mappings":"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"}
+{"version":3,"file":"history_resource_manager.js","sources":["../../../src/render/rendergraph/history_resource_manager.ts"],"sourcesContent":["import type { Texture2D } from '@zephyr3d/device';\r\nimport type { RenderGraph } from './rendergraph';\r\nimport type { RenderGraphExecutor } from './executor';\r\nimport type { RGHandle, RGExecuteContext, RGTextureAllocator, RGTextureDesc, RGResolvedSize } from './types';\r\n\r\ninterface HistoryResource<TTexture> {\r\n  desc: RGTextureDesc;\r\n  size: RGResolvedSize;\r\n  textures: [TTexture | null, TTexture | null];\r\n  ownsTexture: [boolean, boolean];\r\n  currentIndex: number;\r\n  valid: boolean;\r\n}\r\n\r\ninterface PendingHistoryCommit<TTexture> {\r\n  desc: RGTextureDesc;\r\n  size: RGResolvedSize;\r\n  texture: TTexture;\r\n  ownsTexture: boolean;\r\n}\r\n\r\n/** Manages render graph textures retained across frames. @public */\r\nexport class HistoryResourceManager<TTexture = Texture2D> {\r\n  private _resources: Map<string, HistoryResource<TTexture>> = new Map();\r\n  private _allocator: RGTextureAllocator<TTexture>;\r\n  private _pendingImports: Map<RGHandle, TTexture> = new Map();\r\n  private _pendingCommits: Map<string, PendingHistoryCommit<TTexture>> = new Map();\r\n  private _readScopeStack: Array<Map<string, TTexture>> = [];\r\n  private _frameActive = false;\r\n  // Delay replaced commits until frame end to prevent pool reuse while queued.\r\n  private _deferredReleases: TTexture[] = [];\r\n\r\n  /** Create a history manager using the given allocator. */\r\n  constructor(allocator: RGTextureAllocator<TTexture>) {\r\n    this._allocator = allocator;\r\n  }\r\n\r\n  /**\r\n   * Return a previous-frame texture from the active read scope.\r\n   * @throws When the resource is not available in that scope.\r\n   */\r\n  getPrevious(name: string): TTexture {\r\n    const scoped = this._getScopedRead(name);\r\n    if (scoped) {\r\n      return scoped;\r\n    }\r\n    throw new Error(\r\n      `History resource '${name}' is not available in the current render graph read scope. ` +\r\n        `Import it and declare a pass read before accessing it.`\r\n    );\r\n  }\r\n\r\n  /** Return a scoped previous-frame texture, or null. */\r\n  tryGetPrevious(name: string): TTexture | null {\r\n    return this._getScopedRead(name);\r\n  }\r\n\r\n  /** Whether a history frame is active. */\r\n  get frameActive(): boolean {\r\n    return this._frameActive;\r\n  }\r\n\r\n  /** Check for valid history matching the descriptor and size. */\r\n  isCompatible(name: string, desc: RGTextureDesc, size: RGResolvedSize): boolean {\r\n    const resource = this._resources.get(name);\r\n    return !!resource?.valid && this._matches(resource, desc, size);\r\n  }\r\n\r\n  /** Begin collecting imports and commits for a frame. */\r\n  beginFrame(): void {\r\n    this.discardFrame();\r\n    this._pendingImports.clear();\r\n    this._readScopeStack.length = 0;\r\n    this._frameActive = true;\r\n  }\r\n\r\n  /** Import the latest history texture, or return null when unavailable. */\r\n  importPrevious(graph: RenderGraph, name: string): RGHandle | null {\r\n    const resource = this._resources.get(name);\r\n    const texture = resource?.valid ? resource.textures[resource.currentIndex] : null;\r\n    if (!texture) {\r\n      return null;\r\n    }\r\n    const handle = graph.importTexture(`history:${name}:previous`);\r\n    this._pendingImports.set(handle, texture);\r\n    return handle;\r\n  }\r\n\r\n  /**\r\n   * Import the latest history only when its descriptor and size match.\r\n   */\r\n  importPreviousIfCompatible(\r\n    graph: RenderGraph,\r\n    name: string,\r\n    desc: RGTextureDesc,\r\n    size: RGResolvedSize\r\n  ): RGHandle | null {\r\n    return this.isCompatible(name, desc, size) ? this.importPrevious(graph, name) : null;\r\n  }\r\n\r\n  /** Bind this frame's history imports to an executor. */\r\n  bindImportedTextures(executor: Pick<RenderGraphExecutor<TTexture>, 'setImportedTexture'>): void {\r\n    for (const [handle, texture] of this._pendingImports) {\r\n      executor.setImportedTexture(handle, texture);\r\n    }\r\n  }\r\n\r\n  /** Push a history read scope for pass execution. */\r\n  beginReadScope(bindings: Array<{ name: string; texture: TTexture }>): void {\r\n    const scope = new Map<string, TTexture>();\r\n    for (const binding of bindings) {\r\n      scope.set(binding.name, binding.texture);\r\n    }\r\n    this._readScopeStack.push(scope);\r\n  }\r\n\r\n  /** Pop the latest history read scope. */\r\n  endReadScope(): void {\r\n    this._readScopeStack.pop();\r\n  }\r\n\r\n  /**\r\n   * Queue the next history texture. It becomes visible on `commitFrame`; owned\r\n   * textures are released on `discardFrame`.\r\n   */\r\n  queueCommit(\r\n    name: string,\r\n    desc: RGTextureDesc,\r\n    size: RGResolvedSize,\r\n    texture: TTexture,\r\n    ownsTexture = true\r\n  ): void {\r\n    if (!this._frameActive) {\r\n      throw new Error(\r\n        `HistoryResourceManager: cannot queue history commit '${name}' outside an active frame. ` +\r\n          `Call beginFrame() first.`\r\n      );\r\n    }\r\n    const existing = this._pendingCommits.get(name);\r\n    if (existing?.ownsTexture && existing.texture !== texture) {\r\n      // Re-queuing the same texture keeps its existing reference.\r\n      this._deferredReleases.push(existing.texture);\r\n    }\r\n    this._pendingCommits.set(name, {\r\n      desc: { ...desc },\r\n      size: { ...size },\r\n      texture,\r\n      ownsTexture\r\n    });\r\n  }\r\n\r\n  /**\r\n   * Retain and queue a graph texture from its declaring pass.\r\n   */\r\n  queueCommitFromGraph(\r\n    name: string,\r\n    desc: RGTextureDesc,\r\n    size: RGResolvedSize,\r\n    ctx: Pick<RGExecuteContext, 'getTexture'>,\r\n    handle: RGHandle\r\n  ): TTexture {\r\n    const texture = ctx.getTexture<TTexture>(handle);\r\n    this.queueRetainedCommit(name, desc, size, texture);\r\n    return texture;\r\n  }\r\n\r\n  /** Retain a texture through the allocator and queue it as history. */\r\n  queueRetainedCommit(name: string, desc: RGTextureDesc, size: RGResolvedSize, texture: TTexture): void {\r\n    if (!this._allocator.retain) {\r\n      throw new Error(\r\n        `HistoryResourceManager: cannot retain history resource '${name}'. ` +\r\n          `The allocator does not support retained graph texture handoff.`\r\n      );\r\n    }\r\n    this._allocator.retain(texture);\r\n    this.queueCommit(name, desc, size, texture, true);\r\n  }\r\n\r\n  /** Commit all pending history writes. */\r\n  commitFrame(): void {\r\n    for (const [name, pending] of this._pendingCommits) {\r\n      let resource = this._resources.get(name);\r\n      if (resource && !this._matches(resource, pending.desc, pending.size)) {\r\n        this._releaseResource(resource);\r\n        this._resources.delete(name);\r\n        resource = undefined;\r\n      }\r\n      if (!resource) {\r\n        resource = {\r\n          desc: { ...pending.desc },\r\n          size: { ...pending.size },\r\n          textures: [null, null],\r\n          ownsTexture: [false, false],\r\n          currentIndex: 0,\r\n          valid: false\r\n        };\r\n        this._resources.set(name, resource);\r\n      }\r\n\r\n      const writeIndex = resource.valid ? 1 - resource.currentIndex : resource.currentIndex;\r\n      this._releaseSlot(resource, writeIndex);\r\n      resource.textures[writeIndex] = pending.texture;\r\n      resource.ownsTexture[writeIndex] = pending.ownsTexture;\r\n      resource.desc = { ...pending.desc };\r\n      resource.size = { ...pending.size };\r\n      resource.currentIndex = writeIndex;\r\n      resource.valid = true;\r\n    }\r\n    this._pendingCommits.clear();\r\n    this._pendingImports.clear();\r\n    this._readScopeStack.length = 0;\r\n    this._frameActive = false;\r\n    this._flushDeferredReleases();\r\n  }\r\n\r\n  /** Discard all pending history writes. */\r\n  discardFrame(): void {\r\n    for (const pending of this._pendingCommits.values()) {\r\n      if (pending.ownsTexture) {\r\n        this._allocator.release(pending.texture);\r\n      }\r\n    }\r\n    this._pendingCommits.clear();\r\n    this._pendingImports.clear();\r\n    this._readScopeStack.length = 0;\r\n    this._frameActive = false;\r\n    this._flushDeferredReleases();\r\n  }\r\n\r\n  /**\r\n   * Invalidate one named history resource without disturbing unrelated\r\n   * temporal effects. If called during a frame, owned textures are released\r\n   * after that frame so already-imported graph reads remain valid.\r\n   */\r\n  invalidate(name: string): void {\r\n    const pending = this._pendingCommits.get(name);\r\n    if (pending) {\r\n      if (pending.ownsTexture) {\r\n        if (this._frameActive) {\r\n          this._deferredReleases.push(pending.texture);\r\n        } else {\r\n          this._allocator.release(pending.texture);\r\n        }\r\n      }\r\n      this._pendingCommits.delete(name);\r\n    }\r\n    const resource = this._resources.get(name);\r\n    if (!resource) {\r\n      return;\r\n    }\r\n    if (this._frameActive) {\r\n      for (let i = 0; i < resource.textures.length; i++) {\r\n        const texture = resource.textures[i];\r\n        if (texture && resource.ownsTexture[i]) {\r\n          this._deferredReleases.push(texture);\r\n        }\r\n        resource.textures[i] = null;\r\n        resource.ownsTexture[i] = false;\r\n      }\r\n      resource.valid = false;\r\n    } else {\r\n      this._releaseResource(resource);\r\n    }\r\n    this._resources.delete(name);\r\n  }\r\n\r\n  /** @internal */\r\n  private _flushDeferredReleases(): void {\r\n    for (const texture of this._deferredReleases) {\r\n      this._allocator.release(texture);\r\n    }\r\n    this._deferredReleases.length = 0;\r\n  }\r\n\r\n  /** Release all history resources. */\r\n  dispose(): void {\r\n    this.discardFrame();\r\n    for (const resource of this._resources.values()) {\r\n      this._releaseResource(resource);\r\n    }\r\n    this._resources.clear();\r\n  }\r\n\r\n  /** @internal */\r\n  private _getScopedRead(name: string): TTexture | null {\r\n    for (let i = this._readScopeStack.length - 1; i >= 0; i--) {\r\n      const texture = this._readScopeStack[i].get(name);\r\n      if (texture) {\r\n        return texture;\r\n      }\r\n    }\r\n    return null;\r\n  }\r\n\r\n  /** @internal */\r\n  private _matches(resource: HistoryResource<TTexture>, desc: RGTextureDesc, size: RGResolvedSize): boolean {\r\n    return (\r\n      resource.desc.format === desc.format &&\r\n      (resource.desc.mipLevels ?? 1) === (desc.mipLevels ?? 1) &&\r\n      // A 2D texture and a one-layer array are distinct types.\r\n      resource.desc.arrayLayers === desc.arrayLayers &&\r\n      resource.size.width === size.width &&\r\n      resource.size.height === size.height\r\n    );\r\n  }\r\n\r\n  /** @internal */\r\n  private _releaseResource(resource: HistoryResource<TTexture>): void {\r\n    this._releaseSlot(resource, 0);\r\n    this._releaseSlot(resource, 1);\r\n    resource.valid = false;\r\n  }\r\n\r\n  /** @internal */\r\n  private _releaseSlot(resource: HistoryResource<TTexture>, index: number): void {\r\n    const texture = resource.textures[index];\r\n    if (!texture) {\r\n      return;\r\n    }\r\n    // Each owning slot represents one retained reference.\r\n    if (resource.ownsTexture[index]) {\r\n      this._allocator.release(texture);\r\n    }\r\n    resource.textures[index] = null;\r\n    resource.ownsTexture[index] = false;\r\n  }\r\n}\r\n"],"names":["HistoryResourceManager","_resources","Map","_allocator","_pendingImports","_pendingCommits","_readScopeStack","_frameActive","_deferredReleases","allocator","getPrevious","name","scoped","_getScopedRead","Error","tryGetPrevious","frameActive","isCompatible","desc","size","resource","get","valid","_matches","beginFrame","discardFrame","clear","length","importPrevious","graph","texture","textures","currentIndex","handle","importTexture","set","importPreviousIfCompatible","bindImportedTextures","executor","setImportedTexture","beginReadScope","bindings","scope","binding","push","endReadScope","pop","queueCommit","ownsTexture","existing","queueCommitFromGraph","ctx","getTexture","queueRetainedCommit","retain","commitFrame","pending","_releaseResource","delete","undefined","writeIndex","_releaseSlot","_flushDeferredReleases","values","release","invalidate","i","dispose","format","mipLevels","arrayLayers","width","height","index"],"mappings":"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"}

package/dist/render/rendergraph/history_resources.js

@@ -1,11 +1,13 @@
-/**
- * Resource names for render graph history resources.
- * @public
- */ const RGHistoryResources = {
+/** Render graph history resource names. @public */ const RGHistoryResources = {
     TAA_COLOR: 'taaColor',
     TAA_MOTION_VECTOR: 'taaMotionVector',
     SSR_REFLECT: 'ssrReflect',
-    SSR_MOTION_VECTOR: 'ssrMotionVector'
+    SSR_MOTION_VECTOR: 'ssrMotionVector',
+    /** Opaque linear-HDR scene color sampled by SSGI rays on the next frame. */ SSGI_SCENE_COLOR: 'ssgiSceneColor',
+    /** Denoised diffuse irradiance reprojected into the next frame's lighting pass. */ SSGI_IRRADIANCE: 'ssgiIrradiance',
+    /** Depth/normal surface data used to validate SSGI reprojection. */ SSGI_SURFACE: 'ssgiSurface',
+    /** First and second luminance moments used by the SSGI temporal filter. */ SSGI_MOMENTS: 'ssgiMoments',
+    /** Temporally accumulated screen space ambient occlusion traced alongside SSGI. */ SSGI_AO: 'ssgiAO'
 };
 
 export { RGHistoryResources };

package/dist/render/rendergraph/history_resources.js.map

@@ -1 +1 @@
-{"version":3,"file":"history_resources.js","sources":["../../../src/render/rendergraph/history_resources.ts"],"sourcesContent":["/**\r\n * Resource names for render graph history resources.\r\n * @public\r\n */\r\nexport const RGHistoryResources = {\r\n  TAA_COLOR: 'taaColor',\r\n  TAA_MOTION_VECTOR: 'taaMotionVector',\r\n  SSR_REFLECT: 'ssrReflect',\r\n  SSR_MOTION_VECTOR: 'ssrMotionVector'\r\n} as const;\r\n"],"names":["RGHistoryResources","TAA_COLOR","TAA_MOTION_VECTOR","SSR_REFLECT","SSR_MOTION_VECTOR"],"mappings":"AAAA;;;UAIaA,kBAAqB,GAAA;IAChCC,SAAW,EAAA,UAAA;IACXC,iBAAmB,EAAA,iBAAA;IACnBC,WAAa,EAAA,YAAA;IACbC,iBAAmB,EAAA;AACrB;;;;"}
+{"version":3,"file":"history_resources.js","sources":["../../../src/render/rendergraph/history_resources.ts"],"sourcesContent":["/** Render graph history resource names. @public */\r\nexport const RGHistoryResources = {\r\n  TAA_COLOR: 'taaColor',\r\n  TAA_MOTION_VECTOR: 'taaMotionVector',\r\n  SSR_REFLECT: 'ssrReflect',\r\n  SSR_MOTION_VECTOR: 'ssrMotionVector',\r\n  /** Opaque linear-HDR scene color sampled by SSGI rays on the next frame. */\r\n  SSGI_SCENE_COLOR: 'ssgiSceneColor',\r\n  /** Denoised diffuse irradiance reprojected into the next frame's lighting pass. */\r\n  SSGI_IRRADIANCE: 'ssgiIrradiance',\r\n  /** Depth/normal surface data used to validate SSGI reprojection. */\r\n  SSGI_SURFACE: 'ssgiSurface',\r\n  /** First and second luminance moments used by the SSGI temporal filter. */\r\n  SSGI_MOMENTS: 'ssgiMoments',\r\n  /** Temporally accumulated screen space ambient occlusion traced alongside SSGI. */\r\n  SSGI_AO: 'ssgiAO'\r\n} as const;\r\n"],"names":["RGHistoryResources","TAA_COLOR","TAA_MOTION_VECTOR","SSR_REFLECT","SSR_MOTION_VECTOR","SSGI_SCENE_COLOR","SSGI_IRRADIANCE","SSGI_SURFACE","SSGI_MOMENTS","SSGI_AO"],"mappings":"AAAA,oDACO,MAAMA,kBAAqB,GAAA;IAChCC,SAAW,EAAA,UAAA;IACXC,iBAAmB,EAAA,iBAAA;IACnBC,WAAa,EAAA,YAAA;IACbC,iBAAmB,EAAA,iBAAA;AACnB,iFACAC,gBAAkB,EAAA,gBAAA;AAClB,wFACAC,eAAiB,EAAA,gBAAA;AACjB,yEACAC,YAAc,EAAA,aAAA;AACd,gFACAC,YAAc,EAAA,aAAA;AACd,wFACAC,OAAS,EAAA;AACX;;;;"}

package/dist/render/rendergraph/render_context.js

@@ -0,0 +1,19 @@
+/** Orders side-effect passes through logical tokens. @public */ class OrderingScope {
+    /** @internal */ _last = null;
+    /** Order the current pass after the latest token, if any. */ chainInto(builder) {
+        if (this._last) {
+            builder.read(this._last);
+        }
+    }
+    /** Emit and record a new ordering token. */ emit(builder, name) {
+        const token = builder.createToken(name);
+        this._last = token;
+        return token;
+    }
+    /** The most recently emitted ordering token, or null. */ get last() {
+        return this._last;
+    }
+}
+
+export { OrderingScope };
+//# sourceMappingURL=render_context.js.map

package/dist/render/rendergraph/render_context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render_context.js","sources":["../../../src/render/rendergraph/render_context.ts"],"sourcesContent":["import type { Nullable } from '@zephyr3d/base';\r\nimport type { FrameBuffer, Texture2D } from '@zephyr3d/device';\r\nimport type { RGHandle, RGPassBuilder } from './types';\r\nimport type { RenderGraph } from './rendergraph';\r\nimport type { RGBlackboard } from './blackboard';\r\nimport type { HistoryResourceManager } from './history_resource_manager';\r\nimport type { RenderQueue } from '../render_queue';\r\n\r\n/** Orders side-effect passes through logical tokens. @public */\r\nexport class OrderingScope {\r\n  /** @internal */\r\n  private _last: Nullable<RGHandle> = null;\r\n\r\n  /** Order the current pass after the latest token, if any. */\r\n  chainInto(builder: RGPassBuilder): void {\r\n    if (this._last) {\r\n      builder.read(this._last);\r\n    }\r\n  }\r\n\r\n  /** Emit and record a new ordering token. */\r\n  emit(builder: RGPassBuilder, name: string): RGHandle {\r\n    const token = builder.createToken(name);\r\n    this._last = token;\r\n    return token;\r\n  }\r\n\r\n  /** The most recently emitted ordering token, or null. */\r\n  get last(): Nullable<RGHandle> {\r\n    return this._last;\r\n  }\r\n}\r\n\r\n/** Pipeline-independent context used while building graph modules. @public */\r\nexport interface RenderContext {\r\n  /** The external framebuffer presented by this frame, or null for the screen. */\r\n  readonly finalFramebuffer: FrameBuffer | null;\r\n  /** The render graph being populated for this frame. */\r\n  readonly graph: RenderGraph;\r\n  /** The culled render queue for this frame. */\r\n  readonly renderQueue: RenderQueue;\r\n  /** Named registry of shared frame-resource handles (see {@link ./blackboard#FrameResources}). */\r\n  readonly blackboard: RGBlackboard;\r\n  /** Cross-frame history resource manager, or null when unavailable. */\r\n  readonly history: Nullable<HistoryResourceManager<Texture2D>>;\r\n  /** Ordering-token chain for side-effect passes. */\r\n  readonly ordering: OrderingScope;\r\n  /** The imported backbuffer handle (graph sink). */\r\n  readonly backbuffer: RGHandle;\r\n}\r\n"],"names":["OrderingScope","_last","chainInto","builder","read","emit","name","token","createToken","last"],"mappings":"AAQA,iEACO,MAAMA,aAAAA,CAAAA;qBAEX,KAAQC,GAA4B,IAAK;kEAGzCC,SAAUC,CAAAA,OAAsB,EAAQ;QACtC,IAAI,IAAI,CAACF,KAAK,EAAE;AACdE,YAAAA,OAAAA,CAAQC,IAAI,CAAC,IAAI,CAACH,KAAK,CAAA;AACzB;AACF;AAEA,iDACAI,IAAAA,CAAKF,OAAsB,EAAEG,IAAY,EAAY;QACnD,MAAMC,KAAAA,GAAQJ,OAAQK,CAAAA,WAAW,CAACF,IAAAA,CAAAA;QAClC,IAAI,CAACL,KAAK,GAAGM,KAAAA;QACb,OAAOA,KAAAA;AACT;8DAGA,IAAIE,IAA2B,GAAA;QAC7B,OAAO,IAAI,CAACR,KAAK;AACnB;AACF;;;;"}