@zephyr3d/scene 0.9.1 → 0.9.3

package/dist/render/rendergraph/history_resource_manager.js

@@ -1,27 +1,20 @@
 /**
- * Manages cross-frame history resources with automatic ping-pong buffering.
+ * 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. The manager maintains two copies
- * of each resource and automatically swaps them at frame boundaries.
+ * 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);
- *
- * // Register a history resource (typically once at initialization)
- * historyMgr.register('taaHistory', {
- *   format: TextureFormat.RGBA16F,
- *   width: 1920,
- *   height: 1080
- * }, { width: 1920, height: 1080 });
- *
- * // In your render pass:
- * const prevFrame = historyMgr.getPrevious('taaHistory');  // Read from previous frame
- * const currentFrame = historyMgr.getCurrent('taaHistory'); // Write to current frame
- *
- * // At frame end:
- * historyMgr.swap();  // Swap current and previous
+ * 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`).
@@ -29,7 +22,9 @@
  */ class HistoryResourceManager {
     _resources = new Map();
     _allocator;
-    _frameIndex = 0;
+    _pendingImports = new Map();
+    _pendingCommits = new Map();
+    _readScopeStack = [];
     /**
    * Create a new history resource manager.
    *
@@ -38,139 +33,224 @@
         this._allocator = allocator;
     }
     /**
-   * Register a new history resource with ping-pong buffering.
+   * Get the previous-frame texture resolved by the current render graph pass.
    *
-   * Allocates two textures matching the given descriptor. If a resource
-   * with the same name already exists, this is a no-op.
+   * 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 - Unique identifier for this history resource.
-   * @param desc - Texture descriptor (format, size, etc.).
-   * @param size - Resolved pixel dimensions.
-   */ register(name, desc, size) {
-        if (!this._resources.has(name)) {
-            const tex0 = this._allocator.allocate(desc, size);
-            const tex1 = this._allocator.allocate(desc, size);
-            this._resources.set(name, [
-                tex0,
-                tex1
-            ]);
+   * @param name - Name of the history resource.
+   * @returns The graph-resolved previous-frame texture.
+   * @throws If no read scope is active for the resource.
+   */ getPrevious(name) {
+        const scoped = this._getScopedRead(name);
+        if (scoped) {
+            return scoped;
         }
+        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.`);
     }
     /**
-   * Register a new history resource with an existing texture (zero-copy).
+   * Check whether a valid history resource exists and matches the descriptor.
    *
-   * This is more efficient than register() + updateCurrent() for first-frame setup,
-   * as it avoids allocating dummy textures that are immediately replaced.
-   *
-   * @param name - Unique identifier for this history resource.
-   * @param desc - Texture descriptor (format, size, etc.).
-   * @param size - Resolved pixel dimensions.
-   * @param initialTexture - The initial texture to use as current frame.
-   */ registerWithTexture(name, desc, size, initialTexture) {
-        if (!this._resources.has(name)) {
-            // Allocate only one texture for the "previous" slot
-            const prevTexture = this._allocator.allocate(desc, size);
-            // Use the provided texture as "current"
-            this._resources.set(name, [
-                initialTexture,
-                prevTexture
-            ]);
-        }
+   * @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) {
+        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() {
+        this.discardFrame();
+        this._pendingImports.clear();
+        this._readScopeStack.length = 0;
     }
     /**
-   * Get the current frame's texture for a history resource.
+   * Import the latest committed texture for a history resource into the graph.
    *
-   * This is typically used as the write target in render passes.
+   * Returns null when the resource has no valid previous frame.
    *
-   * @param name - Name of the history resource.
-   * @returns The current frame's texture.
-   * @throws If the resource has not been registered.
-   */ getCurrent(name) {
-        const textures = this._resources.get(name);
-        if (!textures) {
-            throw new Error(`History resource '${name}' not found. Did you forget to call register()?`);
+   * @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) {
+        const resource = this._resources.get(name);
+        const texture = resource?.valid ? resource.textures[resource.currentIndex] : null;
+        if (!texture) {
+            return null;
         }
-        return textures[this._frameIndex % 2];
+        const handle = graph.importTexture(`history:${name}:previous`);
+        this._pendingImports.set(handle, texture);
+        return handle;
     }
     /**
-   * Get the previous frame's texture for a history resource.
+   * Import the latest committed texture only when it matches the expected shape.
    *
-   * This is typically used as a read input in temporal effects like TAA.
+   * 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 name - Name of the history resource.
-   * @returns The previous frame's texture.
-   * @throws If the resource has not been registered.
-   */ getPrevious(name) {
-        const textures = this._resources.get(name);
-        if (!textures) {
-            throw new Error(`History resource '${name}' not found. Did you forget to call register()?`);
-        }
-        return textures[(this._frameIndex + 1) % 2];
+   * @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.
+   */ importPreviousIfCompatible(graph, name, desc, size) {
+        return this.isCompatible(name, desc, size) ? this.importPrevious(graph, name) : null;
     }
     /**
-   * Check if a history resource exists.
+   * Bind all history imports created for this frame to the executor.
    *
-   * @param name - Name of the history resource.
-   * @returns True if the resource has been registered.
-   */ has(name) {
-        return this._resources.has(name);
+   * @param executor - Render graph executor for the current frame.
+   */ bindImportedTextures(executor) {
+        for (const [handle, texture] of this._pendingImports){
+            executor.setImportedTexture(handle, texture);
+        }
     }
     /**
-   * Unregister a history resource and release its textures.
+   * Make resolved history textures available to code executing inside a pass.
    *
-   * @param name - Name of the history resource to remove.
-   * @returns True if the resource was found and removed.
-   */ unregister(name) {
-        const textures = this._resources.get(name);
-        if (textures) {
-            textures.forEach((tex)=>this._allocator.release(tex));
-            this._resources.delete(name);
-            return true;
+   * @param bindings - History name to resolved texture bindings.
+   */ beginReadScope(bindings) {
+        const scope = new Map();
+        for (const binding of bindings){
+            scope.set(binding.name, binding.texture);
         }
-        return false;
+        this._readScopeStack.push(scope);
+    }
+    /**
+   * End the most recent history read scope.
+   */ endReadScope() {
+        this._readScopeStack.pop();
     }
     /**
-   * Swap current and previous textures for all history resources.
+   * Queue a current-frame texture to become the next previous-frame history.
    *
-   * Call this at the end of each frame to advance the ping-pong buffers.
-   * After swapping, what was "current" becomes "previous" for the next frame.
-   */ swap() {
-        this._frameIndex++;
+   * 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.
+   */ queueCommit(name, desc, size, texture, ownsTexture = true) {
+        const existing = this._pendingCommits.get(name);
+        if (existing?.ownsTexture) {
+            this._allocator.release(existing.texture);
+        }
+        this._pendingCommits.set(name, {
+            desc: {
+                ...desc
+            },
+            size: {
+                ...size
+            },
+            texture,
+            ownsTexture
+        });
+    }
+    /**
+   * Commit all current-frame 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)) {
+                this._releaseResource(resource);
+                this._resources.delete(name);
+                resource = undefined;
+            }
+            if (!resource) {
+                resource = {
+                    desc: {
+                        ...pending.desc
+                    },
+                    size: {
+                        ...pending.size
+                    },
+                    textures: [
+                        null,
+                        null
+                    ],
+                    ownsTexture: [
+                        false,
+                        false
+                    ],
+                    currentIndex: 0,
+                    valid: false
+                };
+                this._resources.set(name, resource);
+            }
+            const writeIndex = resource.valid ? 1 - resource.currentIndex : resource.currentIndex;
+            this._releaseSlot(resource, writeIndex);
+            resource.textures[writeIndex] = pending.texture;
+            resource.ownsTexture[writeIndex] = pending.ownsTexture;
+            resource.desc = {
+                ...pending.desc
+            };
+            resource.size = {
+                ...pending.size
+            };
+            resource.currentIndex = writeIndex;
+            resource.valid = true;
+        }
+        this._pendingCommits.clear();
+        this._pendingImports.clear();
+        this._readScopeStack.length = 0;
+    }
+    /**
+   * Discard all uncommitted frame history writes.
+   */ discardFrame() {
+        for (const pending of this._pendingCommits.values()){
+            if (pending.ownsTexture) {
+                this._allocator.release(pending.texture);
+            }
+        }
+        this._pendingCommits.clear();
+        this._pendingImports.clear();
+        this._readScopeStack.length = 0;
     }
     /**
    * Release all history resources and clear the manager.
    *
    * Call this when disposing the render context or when history is no longer needed.
    */ dispose() {
-        for (const textures of this._resources.values()){
-            textures.forEach((tex)=>this._allocator.release(tex));
+        this.discardFrame();
+        for (const resource of this._resources.values()){
+            this._releaseResource(resource);
         }
         this._resources.clear();
-        this._frameIndex = 0;
     }
-    /**
-   * Update the current frame's texture with an external texture (for zero-copy workflows).
-   *
-   * This is useful when you want to use the output of a render pass directly as history,
-   * without copying. The manager will release the old texture and use the new one.
-   *
-   * @param name - Name of the history resource.
-   * @param texture - The new texture to use as current frame.
-   */ updateCurrent(name, texture) {
-        const textures = this._resources.get(name);
-        if (!textures) {
-            throw new Error(`History resource '${name}' not found. Did you forget to call register()?`);
+    /** @internal */ _getScopedRead(name) {
+        for(let i = this._readScopeStack.length - 1; i >= 0; i--){
+            const texture = this._readScopeStack[i].get(name);
+            if (texture) {
+                return texture;
+            }
         }
-        // Release the old current texture
-        const oldTexture = textures[this._frameIndex % 2];
-        this._allocator.release(oldTexture);
-        // Replace with new texture
-        textures[this._frameIndex % 2] = texture;
+        return null;
     }
-    /**
-   * Get the number of registered history resources.
-   */ get size() {
-        return this._resources.size;
+    /** @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;
+    }
+    /** @internal */ _releaseResource(resource) {
+        this._releaseSlot(resource, 0);
+        this._releaseSlot(resource, 1);
+        resource.valid = false;
+    }
+    /** @internal */ _releaseSlot(resource, index) {
+        const texture = resource.textures[index];
+        if (!texture) {
+            return;
+        }
+        const otherIndex = 1 - index;
+        if (resource.ownsTexture[index] && resource.textures[otherIndex] !== texture) {
+            this._allocator.release(texture);
+        }
+        resource.textures[index] = null;
+        resource.ownsTexture[index] = false;
     }
 }
 

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 { RGTextureAllocator, RGTextureDesc, RGResolvedSize } from './types';\r\n\r\n/**\r\n * Manages cross-frame history resources with automatic ping-pong buffering.\r\n *\r\n * History resources are textures that persist across frames for temporal effects\r\n * like TAA, motion blur, or temporal upscaling. The manager maintains two copies\r\n * of each resource and automatically swaps them at frame boundaries.\r\n *\r\n * Usage:\r\n * ```ts\r\n * const historyMgr = new HistoryResourceManager(allocator);\r\n *\r\n * // Register a history resource (typically once at initialization)\r\n * historyMgr.register('taaHistory', {\r\n *   format: TextureFormat.RGBA16F,\r\n *   width: 1920,\r\n *   height: 1080\r\n * }, { width: 1920, height: 1080 });\r\n *\r\n * // In your render pass:\r\n * const prevFrame = historyMgr.getPrevious('taaHistory');  // Read from previous frame\r\n * const currentFrame = historyMgr.getCurrent('taaHistory'); // Write to current frame\r\n *\r\n * // At frame end:\r\n * historyMgr.swap();  // Swap current and previous\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, TTexture[]> = new Map();\r\n  private _allocator: RGTextureAllocator<TTexture>;\r\n  private _frameIndex = 0;\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   * Register a new history resource with ping-pong buffering.\r\n   *\r\n   * Allocates two textures matching the given descriptor. If a resource\r\n   * with the same name already exists, this is a no-op.\r\n   *\r\n   * @param name - Unique identifier for this history resource.\r\n   * @param desc - Texture descriptor (format, size, etc.).\r\n   * @param size - Resolved pixel dimensions.\r\n   */\r\n  register(name: string, desc: RGTextureDesc, size: RGResolvedSize): void {\r\n    if (!this._resources.has(name)) {\r\n      const tex0 = this._allocator.allocate(desc, size);\r\n      const tex1 = this._allocator.allocate(desc, size);\r\n      this._resources.set(name, [tex0, tex1]);\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Register a new history resource with an existing texture (zero-copy).\r\n   *\r\n   * This is more efficient than register() + updateCurrent() for first-frame setup,\r\n   * as it avoids allocating dummy textures that are immediately replaced.\r\n   *\r\n   * @param name - Unique identifier for this history resource.\r\n   * @param desc - Texture descriptor (format, size, etc.).\r\n   * @param size - Resolved pixel dimensions.\r\n   * @param initialTexture - The initial texture to use as current frame.\r\n   */\r\n  registerWithTexture(\r\n    name: string,\r\n    desc: RGTextureDesc,\r\n    size: RGResolvedSize,\r\n    initialTexture: TTexture\r\n  ): void {\r\n    if (!this._resources.has(name)) {\r\n      // Allocate only one texture for the \"previous\" slot\r\n      const prevTexture = this._allocator.allocate(desc, size);\r\n      // Use the provided texture as \"current\"\r\n      this._resources.set(name, [initialTexture, prevTexture]);\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Get the current frame's texture for a history resource.\r\n   *\r\n   * This is typically used as the write target in render passes.\r\n   *\r\n   * @param name - Name of the history resource.\r\n   * @returns The current frame's texture.\r\n   * @throws If the resource has not been registered.\r\n   */\r\n  getCurrent(name: string): TTexture {\r\n    const textures = this._resources.get(name);\r\n    if (!textures) {\r\n      throw new Error(`History resource '${name}' not found. Did you forget to call register()?`);\r\n    }\r\n    return textures[this._frameIndex % 2];\r\n  }\r\n\r\n  /**\r\n   * Get the previous frame's texture for a history resource.\r\n   *\r\n   * This is typically used as a read input in temporal effects like TAA.\r\n   *\r\n   * @param name - Name of the history resource.\r\n   * @returns The previous frame's texture.\r\n   * @throws If the resource has not been registered.\r\n   */\r\n  getPrevious(name: string): TTexture {\r\n    const textures = this._resources.get(name);\r\n    if (!textures) {\r\n      throw new Error(`History resource '${name}' not found. Did you forget to call register()?`);\r\n    }\r\n    return textures[(this._frameIndex + 1) % 2];\r\n  }\r\n\r\n  /**\r\n   * Check if a history resource exists.\r\n   *\r\n   * @param name - Name of the history resource.\r\n   * @returns True if the resource has been registered.\r\n   */\r\n  has(name: string): boolean {\r\n    return this._resources.has(name);\r\n  }\r\n\r\n  /**\r\n   * Unregister a history resource and release its textures.\r\n   *\r\n   * @param name - Name of the history resource to remove.\r\n   * @returns True if the resource was found and removed.\r\n   */\r\n  unregister(name: string): boolean {\r\n    const textures = this._resources.get(name);\r\n    if (textures) {\r\n      textures.forEach((tex) => this._allocator.release(tex));\r\n      this._resources.delete(name);\r\n      return true;\r\n    }\r\n    return false;\r\n  }\r\n\r\n  /**\r\n   * Swap current and previous textures for all history resources.\r\n   *\r\n   * Call this at the end of each frame to advance the ping-pong buffers.\r\n   * After swapping, what was \"current\" becomes \"previous\" for the next frame.\r\n   */\r\n  swap(): void {\r\n    this._frameIndex++;\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    for (const textures of this._resources.values()) {\r\n      textures.forEach((tex) => this._allocator.release(tex));\r\n    }\r\n    this._resources.clear();\r\n    this._frameIndex = 0;\r\n  }\r\n\r\n  /**\r\n   * Update the current frame's texture with an external texture (for zero-copy workflows).\r\n   *\r\n   * This is useful when you want to use the output of a render pass directly as history,\r\n   * without copying. The manager will release the old texture and use the new one.\r\n   *\r\n   * @param name - Name of the history resource.\r\n   * @param texture - The new texture to use as current frame.\r\n   */\r\n  updateCurrent(name: string, texture: TTexture): void {\r\n    const textures = this._resources.get(name);\r\n    if (!textures) {\r\n      throw new Error(`History resource '${name}' not found. Did you forget to call register()?`);\r\n    }\r\n\r\n    // Release the old current texture\r\n    const oldTexture = textures[this._frameIndex % 2];\r\n    this._allocator.release(oldTexture);\r\n\r\n    // Replace with new texture\r\n    textures[this._frameIndex % 2] = texture;\r\n  }\r\n\r\n  /**\r\n   * Get the number of registered history resources.\r\n   */\r\n  get size(): number {\r\n    return this._resources.size;\r\n  }\r\n}\r\n"],"names":["HistoryResourceManager","_resources","Map","_allocator","_frameIndex","allocator","register","name","desc","size","has","tex0","allocate","tex1","set","registerWithTexture","initialTexture","prevTexture","getCurrent","textures","get","Error","getPrevious","unregister","forEach","tex","release","delete","swap","dispose","values","clear","updateCurrent","texture","oldTexture"],"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, 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\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   * 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  }\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   * 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  }\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  }\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","allocator","getPrevious","name","scoped","_getScopedRead","Error","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","commitFrame","pending","_releaseResource","delete","undefined","writeIndex","_releaseSlot","values","dispose","i","format","mipLevels","width","height","index","otherIndex"],"mappings":"AAqBA;;;;;;;;;;;;;;;;;;;;;AAqBC,IACM,MAAMA,sBAAAA,CAAAA;AACHC,IAAAA,UAAAA,GAAqD,IAAIC,GAAM,EAAA;IAC/DC,UAAyC;AACzCC,IAAAA,eAAAA,GAA2C,IAAIF,GAAM,EAAA;AACrDG,IAAAA,eAAAA,GAA+D,IAAIH,GAAM,EAAA;AACzEI,IAAAA,eAAAA,GAAgD,EAAE;AAE1D;;;;MAKA,WAAA,CAAYC,SAAuC,CAAE;QACnD,IAAI,CAACJ,UAAU,GAAGI,SAAAA;AACpB;AAEA;;;;;;;;;;MAWAC,WAAAA,CAAYC,IAAY,EAAY;AAClC,QAAA,MAAMC,MAAS,GAAA,IAAI,CAACC,cAAc,CAACF,IAAAA,CAAAA;AACnC,QAAA,IAAIC,MAAQ,EAAA;YACV,OAAOA,MAAAA;AACT;QACA,MAAM,IAAIE,KACR,CAAA,CAAC,kBAAkB,EAAEH,IAAK,CAAA,2DAA2D,CAAC,GACpF,CAAC,sDAAsD,CAAC,CAAA;AAE9D;AAEA;;;;;;;AAOC,MACDI,aAAaJ,IAAY,EAAEK,IAAmB,EAAEC,IAAoB,EAAW;AAC7E,QAAA,MAAMC,WAAW,IAAI,CAACf,UAAU,CAACgB,GAAG,CAACR,IAAAA,CAAAA;QACrC,OAAO,CAAC,CAACO,QAAUE,EAAAA,KAAAA,IAAS,IAAI,CAACC,QAAQ,CAACH,QAAAA,EAAUF,IAAMC,EAAAA,IAAAA,CAAAA;AAC5D;AAEA;;AAEC,MACDK,UAAmB,GAAA;AACjB,QAAA,IAAI,CAACC,YAAY,EAAA;QACjB,IAAI,CAACjB,eAAe,CAACkB,KAAK,EAAA;AAC1B,QAAA,IAAI,CAAChB,eAAe,CAACiB,MAAM,GAAG,CAAA;AAChC;AAEA;;;;;;;;AAQC,MACDC,cAAeC,CAAAA,KAAkB,EAAEhB,IAAY,EAAmB;AAChE,QAAA,MAAMO,WAAW,IAAI,CAACf,UAAU,CAACgB,GAAG,CAACR,IAAAA,CAAAA;QACrC,MAAMiB,OAAAA,GAAUV,UAAUE,KAAQF,GAAAA,QAAAA,CAASW,QAAQ,CAACX,QAAAA,CAASY,YAAY,CAAC,GAAG,IAAA;AAC7E,QAAA,IAAI,CAACF,OAAS,EAAA;YACZ,OAAO,IAAA;AACT;QACA,MAAMG,MAAAA,GAASJ,MAAMK,aAAa,CAAC,CAAC,QAAQ,EAAErB,IAAK,CAAA,SAAS,CAAC,CAAA;AAC7D,QAAA,IAAI,CAACL,eAAe,CAAC2B,GAAG,CAACF,MAAQH,EAAAA,OAAAA,CAAAA;QACjC,OAAOG,MAAAA;AACT;AAEA;;;;;;;;;;;;MAaAG,0BAAAA,CACEP,KAAkB,EAClBhB,IAAY,EACZK,IAAmB,EACnBC,IAAoB,EACH;AACjB,QAAA,OAAO,IAAI,CAACF,YAAY,CAACJ,IAAMK,EAAAA,IAAAA,EAAMC,IAAQ,CAAA,GAAA,IAAI,CAACS,cAAc,CAACC,KAAAA,EAAOhB,IAAQ,CAAA,GAAA,IAAA;AAClF;AAEA;;;;MAKAwB,oBAAAA,CAAqBC,QAAmE,EAAQ;QAC9F,KAAK,MAAM,CAACL,MAAQH,EAAAA,OAAAA,CAAQ,IAAI,IAAI,CAACtB,eAAe,CAAE;YACpD8B,QAASC,CAAAA,kBAAkB,CAACN,MAAQH,EAAAA,OAAAA,CAAAA;AACtC;AACF;AAEA;;;;MAKAU,cAAAA,CAAeC,QAAoD,EAAQ;AACzE,QAAA,MAAMC,QAAQ,IAAIpC,GAAAA,EAAAA;QAClB,KAAK,MAAMqC,WAAWF,QAAU,CAAA;AAC9BC,YAAAA,KAAAA,CAAMP,GAAG,CAACQ,OAAAA,CAAQ9B,IAAI,EAAE8B,QAAQb,OAAO,CAAA;AACzC;AACA,QAAA,IAAI,CAACpB,eAAe,CAACkC,IAAI,CAACF,KAAAA,CAAAA;AAC5B;AAEA;;AAEC,MACDG,YAAqB,GAAA;QACnB,IAAI,CAACnC,eAAe,CAACoC,GAAG,EAAA;AAC1B;AAEA;;;;;;;;;;;MAYAC,WAAAA,CACElC,IAAY,EACZK,IAAmB,EACnBC,IAAoB,EACpBW,OAAiB,EACjBkB,WAAc,GAAA,IAAI,EACZ;AACN,QAAA,MAAMC,WAAW,IAAI,CAACxC,eAAe,CAACY,GAAG,CAACR,IAAAA,CAAAA;AAC1C,QAAA,IAAIoC,UAAUD,WAAa,EAAA;AACzB,YAAA,IAAI,CAACzC,UAAU,CAAC2C,OAAO,CAACD,SAASnB,OAAO,CAAA;AAC1C;AACA,QAAA,IAAI,CAACrB,eAAe,CAAC0B,GAAG,CAACtB,IAAM,EAAA;YAC7BK,IAAM,EAAA;AAAE,gBAAA,GAAGA;AAAK,aAAA;YAChBC,IAAM,EAAA;AAAE,gBAAA,GAAGA;AAAK,aAAA;AAChBW,YAAAA,OAAAA;AACAkB,YAAAA;AACF,SAAA,CAAA;AACF;AAEA;;AAEC,MACDG,WAAoB,GAAA;QAClB,KAAK,MAAM,CAACtC,IAAMuC,EAAAA,OAAAA,CAAQ,IAAI,IAAI,CAAC3C,eAAe,CAAE;AAClD,YAAA,IAAIW,WAAW,IAAI,CAACf,UAAU,CAACgB,GAAG,CAACR,IAAAA,CAAAA;AACnC,YAAA,IAAIO,QAAY,IAAA,CAAC,IAAI,CAACG,QAAQ,CAACH,QAAUgC,EAAAA,OAAAA,CAAQlC,IAAI,EAAEkC,OAAQjC,CAAAA,IAAI,CAAG,EAAA;gBACpE,IAAI,CAACkC,gBAAgB,CAACjC,QAAAA,CAAAA;AACtB,gBAAA,IAAI,CAACf,UAAU,CAACiD,MAAM,CAACzC,IAAAA,CAAAA;gBACvBO,QAAWmC,GAAAA,SAAAA;AACb;AACA,YAAA,IAAI,CAACnC,QAAU,EAAA;gBACbA,QAAW,GAAA;oBACTF,IAAM,EAAA;AAAE,wBAAA,GAAGkC,QAAQlC;AAAK,qBAAA;oBACxBC,IAAM,EAAA;AAAE,wBAAA,GAAGiC,QAAQjC;AAAK,qBAAA;oBACxBY,QAAU,EAAA;AAAC,wBAAA,IAAA;AAAM,wBAAA;AAAK,qBAAA;oBACtBiB,WAAa,EAAA;AAAC,wBAAA,KAAA;AAAO,wBAAA;AAAM,qBAAA;oBAC3BhB,YAAc,EAAA,CAAA;oBACdV,KAAO,EAAA;AACT,iBAAA;AACA,gBAAA,IAAI,CAACjB,UAAU,CAAC8B,GAAG,CAACtB,IAAMO,EAAAA,QAAAA,CAAAA;AAC5B;YAEA,MAAMoC,UAAAA,GAAapC,SAASE,KAAK,GAAG,IAAIF,QAASY,CAAAA,YAAY,GAAGZ,QAAAA,CAASY,YAAY;YACrF,IAAI,CAACyB,YAAY,CAACrC,QAAUoC,EAAAA,UAAAA,CAAAA;AAC5BpC,YAAAA,QAAAA,CAASW,QAAQ,CAACyB,UAAW,CAAA,GAAGJ,QAAQtB,OAAO;AAC/CV,YAAAA,QAAAA,CAAS4B,WAAW,CAACQ,UAAW,CAAA,GAAGJ,QAAQJ,WAAW;AACtD5B,YAAAA,QAAAA,CAASF,IAAI,GAAG;AAAE,gBAAA,GAAGkC,QAAQlC;AAAK,aAAA;AAClCE,YAAAA,QAAAA,CAASD,IAAI,GAAG;AAAE,gBAAA,GAAGiC,QAAQjC;AAAK,aAAA;AAClCC,YAAAA,QAAAA,CAASY,YAAY,GAAGwB,UAAAA;AACxBpC,YAAAA,QAAAA,CAASE,KAAK,GAAG,IAAA;AACnB;QACA,IAAI,CAACb,eAAe,CAACiB,KAAK,EAAA;QAC1B,IAAI,CAAClB,eAAe,CAACkB,KAAK,EAAA;AAC1B,QAAA,IAAI,CAAChB,eAAe,CAACiB,MAAM,GAAG,CAAA;AAChC;AAEA;;AAEC,MACDF,YAAqB,GAAA;AACnB,QAAA,KAAK,MAAM2B,OAAW,IAAA,IAAI,CAAC3C,eAAe,CAACiD,MAAM,EAAI,CAAA;YACnD,IAAIN,OAAAA,CAAQJ,WAAW,EAAE;AACvB,gBAAA,IAAI,CAACzC,UAAU,CAAC2C,OAAO,CAACE,QAAQtB,OAAO,CAAA;AACzC;AACF;QACA,IAAI,CAACrB,eAAe,CAACiB,KAAK,EAAA;QAC1B,IAAI,CAAClB,eAAe,CAACkB,KAAK,EAAA;AAC1B,QAAA,IAAI,CAAChB,eAAe,CAACiB,MAAM,GAAG,CAAA;AAChC;AAEA;;;;AAIC,MACDgC,OAAgB,GAAA;AACd,QAAA,IAAI,CAAClC,YAAY,EAAA;AACjB,QAAA,KAAK,MAAML,QAAY,IAAA,IAAI,CAACf,UAAU,CAACqD,MAAM,EAAI,CAAA;YAC/C,IAAI,CAACL,gBAAgB,CAACjC,QAAAA,CAAAA;AACxB;QACA,IAAI,CAACf,UAAU,CAACqB,KAAK,EAAA;AACvB;AAEA,qBACQX,cAAeF,CAAAA,IAAY,EAAmB;QACpD,IAAK,IAAI+C,CAAI,GAAA,IAAI,CAAClD,eAAe,CAACiB,MAAM,GAAG,CAAA,EAAGiC,CAAK,IAAA,CAAA,EAAGA,CAAK,EAAA,CAAA;YACzD,MAAM9B,OAAAA,GAAU,IAAI,CAACpB,eAAe,CAACkD,CAAE,CAAA,CAACvC,GAAG,CAACR,IAAAA,CAAAA;AAC5C,YAAA,IAAIiB,OAAS,EAAA;gBACX,OAAOA,OAAAA;AACT;AACF;QACA,OAAO,IAAA;AACT;qBAGA,QAAiBV,CAAAA,QAAmC,EAAEF,IAAmB,EAAEC,IAAoB,EAAW;AACxG,QAAA,OACEC,SAASF,IAAI,CAAC2C,MAAM,KAAK3C,KAAK2C,MAAM,IACpC,CAACzC,SAASF,IAAI,CAAC4C,SAAS,IAAI,CAAA,OAAQ5C,IAAK4C,CAAAA,SAAS,IAAI,CAAA,CAAA,IACtD1C,QAASD,CAAAA,IAAI,CAAC4C,KAAK,KAAK5C,IAAK4C,CAAAA,KAAK,IAClC3C,QAASD,CAAAA,IAAI,CAAC6C,MAAM,KAAK7C,KAAK6C,MAAM;AAExC;AAEA,qBACQX,gBAAiBjC,CAAAA,QAAmC,EAAQ;QAClE,IAAI,CAACqC,YAAY,CAACrC,QAAU,EAAA,CAAA,CAAA;QAC5B,IAAI,CAACqC,YAAY,CAACrC,QAAU,EAAA,CAAA,CAAA;AAC5BA,QAAAA,QAAAA,CAASE,KAAK,GAAG,KAAA;AACnB;AAEA,qBACA,YAAQmC,CAAarC,QAAmC,EAAE6C,KAAa,EAAQ;AAC7E,QAAA,MAAMnC,OAAUV,GAAAA,QAAAA,CAASW,QAAQ,CAACkC,KAAM,CAAA;AACxC,QAAA,IAAI,CAACnC,OAAS,EAAA;AACZ,YAAA;AACF;AACA,QAAA,MAAMoC,aAAa,CAAID,GAAAA,KAAAA;QACvB,IAAI7C,QAAAA,CAAS4B,WAAW,CAACiB,KAAM,CAAA,IAAI7C,SAASW,QAAQ,CAACmC,UAAW,CAAA,KAAKpC,OAAS,EAAA;AAC5E,YAAA,IAAI,CAACvB,UAAU,CAAC2C,OAAO,CAACpB,OAAAA,CAAAA;AAC1B;QACAV,QAASW,CAAAA,QAAQ,CAACkC,KAAAA,CAAM,GAAG,IAAA;QAC3B7C,QAAS4B,CAAAA,WAAW,CAACiB,KAAAA,CAAM,GAAG,KAAA;AAChC;AACF;;;;"}

package/dist/render/rendergraph/history_resources.js

@@ -0,0 +1,10 @@
+/**
+ * Resource names for render graph history resources.
+ * @public
+ */ const RGHistoryResources = {
+    TAA_COLOR: 'taaColor',
+    TAA_MOTION_VECTOR: 'taaMotionVector'
+};
+
+export { RGHistoryResources };
+//# sourceMappingURL=history_resources.js.map

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

@@ -0,0 +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} as const;\r\n"],"names":["RGHistoryResources","TAA_COLOR","TAA_MOTION_VECTOR"],"mappings":"AAAA;;;UAIaA,kBAAqB,GAAA;IAChCC,SAAW,EAAA,UAAA;IACXC,iBAAmB,EAAA;AACrB;;;;"}