@zephyr3d/scene 0.9.2 → 0.9.4

package/dist/render/rendergraph/history_resource_manager.js

@@ -1,47 +1,47 @@
-/**
- * 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
+/**
+ * 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 {
     _resources = new Map();
     _allocator;
     _pendingImports = new Map();
     _pendingCommits = new Map();
     _readScopeStack = [];
-    /**
-   * Create a new history resource manager.
-   *
-   * @param allocator - Texture allocator for creating history textures.
+    /**
+   * Create a new history resource manager.
+   *
+   * @param allocator - Texture allocator for creating history textures.
    */ 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.
+    /**
+   * 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.
    */ getPrevious(name) {
         const scoped = this._getScopedRead(name);
         if (scoped) {
@@ -49,32 +49,32 @@
         }
         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.`);
     }
-    /**
-   * 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.
+    /**
+   * 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) {
         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.
+    /**
+   * Start collecting graph imports and deferred commits for a new frame.
    */ beginFrame() {
         this.discardFrame();
         this._pendingImports.clear();
         this._readScopeStack.length = 0;
     }
-    /**
-   * 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.
+    /**
+   * 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) {
         const resource = this._resources.get(name);
         const texture = resource?.valid ? resource.textures[resource.currentIndex] : null;
@@ -85,34 +85,34 @@
         this._pendingImports.set(handle, texture);
         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 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.
    */ 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.
+    /**
+   * Bind all history imports created for this frame to the executor.
+   *
+   * @param executor - Render graph executor for the current frame.
    */ 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.
+    /**
+   * Make resolved history textures available to code executing inside a pass.
+   *
+   * @param bindings - History name to resolved texture bindings.
    */ beginReadScope(bindings) {
         const scope = new Map();
         for (const binding of bindings){
@@ -120,22 +120,22 @@
         }
         this._readScopeStack.push(scope);
     }
-    /**
-   * End the most recent history read scope.
+    /**
+   * End the most recent 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 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.
    */ queueCommit(name, desc, size, texture, ownsTexture = true) {
         const existing = this._pendingCommits.get(name);
         if (existing?.ownsTexture) {
@@ -152,8 +152,8 @@
             ownsTexture
         });
     }
-    /**
-   * Commit all current-frame history writes.
+    /**
+   * Commit all current-frame history writes.
    */ commitFrame() {
         for (const [name, pending] of this._pendingCommits){
             let resource = this._resources.get(name);
@@ -200,8 +200,8 @@
         this._pendingImports.clear();
         this._readScopeStack.length = 0;
     }
-    /**
-   * Discard all uncommitted frame history writes.
+    /**
+   * Discard all uncommitted frame history writes.
    */ discardFrame() {
         for (const pending of this._pendingCommits.values()){
             if (pending.ownsTexture) {
@@ -212,10 +212,10 @@
         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.
+    /**
+   * Release all history resources and clear the manager.
+   *
+   * Call this when disposing the render context or when history is no longer needed.
    */ dispose() {
         this.discardFrame();
         for (const resource of this._resources.values()){

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';\nimport type { RenderGraph } from './rendergraph';\nimport type { RenderGraphExecutor } from './executor';\nimport type { RGHandle, RGTextureAllocator, RGTextureDesc, RGResolvedSize } from './types';\n\ninterface HistoryResource<TTexture> {\n  desc: RGTextureDesc;\n  size: RGResolvedSize;\n  textures: [TTexture | null, TTexture | null];\n  ownsTexture: [boolean, boolean];\n  currentIndex: number;\n  valid: boolean;\n}\n\ninterface PendingHistoryCommit<TTexture> {\n  desc: RGTextureDesc;\n  size: RGResolvedSize;\n  texture: TTexture;\n  ownsTexture: boolean;\n}\n\n/**\n * Manages cross-frame history resources that can be imported into a render graph.\n *\n * History resources are textures that persist across frames for temporal effects\n * like TAA, motion blur, or temporal upscaling. Previous-frame textures can be\n * imported into a {@link RenderGraph}, and current-frame textures are committed\n * only after graph execution succeeds.\n *\n * Usage:\n * ```ts\n * const historyMgr = new HistoryResourceManager(allocator);\n * historyMgr.beginFrame();\n * const prev = historyMgr.importPrevious(graph, 'taaColor');\n * // declare builder.read(prev) if non-null\n * historyMgr.bindImportedTextures(executor);\n * // after successful execution:\n * historyMgr.commitFrame();\n * ```\n *\n * @typeParam TTexture - The concrete texture type (e.g. `Texture2D`).\n * @public\n */\nexport class HistoryResourceManager<TTexture = Texture2D> {\n  private _resources: Map<string, HistoryResource<TTexture>> = new Map();\n  private _allocator: RGTextureAllocator<TTexture>;\n  private _pendingImports: Map<RGHandle, TTexture> = new Map();\n  private _pendingCommits: Map<string, PendingHistoryCommit<TTexture>> = new Map();\n  private _readScopeStack: Array<Map<string, TTexture>> = [];\n\n  /**\n   * Create a new history resource manager.\n   *\n   * @param allocator - Texture allocator for creating history textures.\n   */\n  constructor(allocator: RGTextureAllocator<TTexture>) {\n    this._allocator = allocator;\n  }\n\n  /**\n   * Get the previous-frame texture resolved by the current render graph pass.\n   *\n   * The resource must have been imported with {@link HistoryResourceManager.importPrevious} or\n   * {@link HistoryResourceManager.importPreviousIfCompatible}, declared as a pass read, and bound with\n   * {@link HistoryResourceManager.beginReadScope} before this method is called.\n   *\n   * @param name - Name of the history resource.\n   * @returns The graph-resolved previous-frame texture.\n   * @throws If no read scope is active for the resource.\n   */\n  getPrevious(name: string): TTexture {\n    const scoped = this._getScopedRead(name);\n    if (scoped) {\n      return scoped;\n    }\n    throw new Error(\n      `History resource '${name}' is not available in the current render graph read scope. ` +\n        `Import it and declare a pass read before accessing it.`\n    );\n  }\n\n  /**\n   * Check whether a valid history resource exists and matches the descriptor.\n   *\n   * @param name - Name of the history resource.\n   * @param desc - Expected texture descriptor.\n   * @param size - Expected resolved size.\n   * @returns True if the resource exists, is valid, and matches.\n   */\n  isCompatible(name: string, desc: RGTextureDesc, size: RGResolvedSize): boolean {\n    const resource = this._resources.get(name);\n    return !!resource?.valid && this._matches(resource, desc, size);\n  }\n\n  /**\n   * Start collecting graph imports and deferred commits for a new frame.\n   */\n  beginFrame(): void {\n    this.discardFrame();\n    this._pendingImports.clear();\n    this._readScopeStack.length = 0;\n  }\n\n  /**\n   * Import the latest committed texture for a history resource into the graph.\n   *\n   * Returns null when the resource has no valid previous frame.\n   *\n   * @param graph - Render graph to import into.\n   * @param name - History resource name.\n   * @returns Imported graph handle, or null when no valid previous texture exists.\n   */\n  importPrevious(graph: RenderGraph, name: string): RGHandle | null {\n    const resource = this._resources.get(name);\n    const texture = resource?.valid ? resource.textures[resource.currentIndex] : null;\n    if (!texture) {\n      return null;\n    }\n    const handle = graph.importTexture(`history:${name}:previous`);\n    this._pendingImports.set(handle, texture);\n    return handle;\n  }\n\n  /**\n   * Import the latest committed texture only when it matches the expected shape.\n   *\n   * This is the preferred API for effects that can declare their history reads\n   * while building the graph: incompatible history is treated as absent, so the\n   * pass does not declare stale reads after resize or format changes.\n   *\n   * @param graph - Render graph to import into.\n   * @param name - History resource name.\n   * @param desc - Expected texture descriptor.\n   * @param size - Expected resolved size.\n   * @returns Imported graph handle, or null when no compatible history exists.\n   */\n  importPreviousIfCompatible(\n    graph: RenderGraph,\n    name: string,\n    desc: RGTextureDesc,\n    size: RGResolvedSize\n  ): RGHandle | null {\n    return this.isCompatible(name, desc, size) ? this.importPrevious(graph, name) : null;\n  }\n\n  /**\n   * Bind all history imports created for this frame to the executor.\n   *\n   * @param executor - Render graph executor for the current frame.\n   */\n  bindImportedTextures(executor: Pick<RenderGraphExecutor<TTexture>, 'setImportedTexture'>): void {\n    for (const [handle, texture] of this._pendingImports) {\n      executor.setImportedTexture(handle, texture);\n    }\n  }\n\n  /**\n   * Make resolved history textures available to code executing inside a pass.\n   *\n   * @param bindings - History name to resolved texture bindings.\n   */\n  beginReadScope(bindings: Array<{ name: string; texture: TTexture }>): void {\n    const scope = new Map<string, TTexture>();\n    for (const binding of bindings) {\n      scope.set(binding.name, binding.texture);\n    }\n    this._readScopeStack.push(scope);\n  }\n\n  /**\n   * End the most recent history read scope.\n   */\n  endReadScope(): void {\n    this._readScopeStack.pop();\n  }\n\n  /**\n   * Queue a current-frame texture to become the next previous-frame history.\n   *\n   * The texture is committed only when {@link HistoryResourceManager.commitFrame} is called. If the\n   * frame fails, {@link HistoryResourceManager.discardFrame} releases owned pending textures instead.\n   *\n   * @param name - History resource name.\n   * @param desc - Texture descriptor.\n   * @param size - Resolved texture size.\n   * @param texture - Texture produced by the current frame.\n   * @param ownsTexture - Whether this manager should release the texture later.\n   */\n  queueCommit(\n    name: string,\n    desc: RGTextureDesc,\n    size: RGResolvedSize,\n    texture: TTexture,\n    ownsTexture = true\n  ): void {\n    const existing = this._pendingCommits.get(name);\n    if (existing?.ownsTexture) {\n      this._allocator.release(existing.texture);\n    }\n    this._pendingCommits.set(name, {\n      desc: { ...desc },\n      size: { ...size },\n      texture,\n      ownsTexture\n    });\n  }\n\n  /**\n   * Commit all current-frame history writes.\n   */\n  commitFrame(): void {\n    for (const [name, pending] of this._pendingCommits) {\n      let resource = this._resources.get(name);\n      if (resource && !this._matches(resource, pending.desc, pending.size)) {\n        this._releaseResource(resource);\n        this._resources.delete(name);\n        resource = undefined;\n      }\n      if (!resource) {\n        resource = {\n          desc: { ...pending.desc },\n          size: { ...pending.size },\n          textures: [null, null],\n          ownsTexture: [false, false],\n          currentIndex: 0,\n          valid: false\n        };\n        this._resources.set(name, resource);\n      }\n\n      const writeIndex = resource.valid ? 1 - resource.currentIndex : resource.currentIndex;\n      this._releaseSlot(resource, writeIndex);\n      resource.textures[writeIndex] = pending.texture;\n      resource.ownsTexture[writeIndex] = pending.ownsTexture;\n      resource.desc = { ...pending.desc };\n      resource.size = { ...pending.size };\n      resource.currentIndex = writeIndex;\n      resource.valid = true;\n    }\n    this._pendingCommits.clear();\n    this._pendingImports.clear();\n    this._readScopeStack.length = 0;\n  }\n\n  /**\n   * Discard all uncommitted frame history writes.\n   */\n  discardFrame(): void {\n    for (const pending of this._pendingCommits.values()) {\n      if (pending.ownsTexture) {\n        this._allocator.release(pending.texture);\n      }\n    }\n    this._pendingCommits.clear();\n    this._pendingImports.clear();\n    this._readScopeStack.length = 0;\n  }\n\n  /**\n   * Release all history resources and clear the manager.\n   *\n   * Call this when disposing the render context or when history is no longer needed.\n   */\n  dispose(): void {\n    this.discardFrame();\n    for (const resource of this._resources.values()) {\n      this._releaseResource(resource);\n    }\n    this._resources.clear();\n  }\n\n  /** @internal */\n  private _getScopedRead(name: string): TTexture | null {\n    for (let i = this._readScopeStack.length - 1; i >= 0; i--) {\n      const texture = this._readScopeStack[i].get(name);\n      if (texture) {\n        return texture;\n      }\n    }\n    return null;\n  }\n\n  /** @internal */\n  private _matches(resource: HistoryResource<TTexture>, desc: RGTextureDesc, size: RGResolvedSize): boolean {\n    return (\n      resource.desc.format === desc.format &&\n      (resource.desc.mipLevels ?? 1) === (desc.mipLevels ?? 1) &&\n      resource.size.width === size.width &&\n      resource.size.height === size.height\n    );\n  }\n\n  /** @internal */\n  private _releaseResource(resource: HistoryResource<TTexture>): void {\n    this._releaseSlot(resource, 0);\n    this._releaseSlot(resource, 1);\n    resource.valid = false;\n  }\n\n  /** @internal */\n  private _releaseSlot(resource: HistoryResource<TTexture>, index: number): void {\n    const texture = resource.textures[index];\n    if (!texture) {\n      return;\n    }\n    const otherIndex = 1 - index;\n    if (resource.ownsTexture[index] && resource.textures[otherIndex] !== texture) {\n      this._allocator.release(texture);\n    }\n    resource.textures[index] = null;\n    resource.ownsTexture[index] = false;\n  }\n}\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":"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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":"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"}

package/dist/render/rendergraph/history_resources.js

@@ -1,6 +1,6 @@
-/**
- * Resource names for render graph history resources.
- * @public
+/**
+ * Resource names for render graph history resources.
+ * @public
  */ const RGHistoryResources = {
     TAA_COLOR: 'taaColor',
     TAA_MOTION_VECTOR: 'taaMotionVector'

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

@@ -1 +1 @@
-{"version":3,"file":"history_resources.js","sources":["../../../src/render/rendergraph/history_resources.ts"],"sourcesContent":["/**\n * Resource names for render graph history resources.\n * @public\n */\nexport const RGHistoryResources = {\n  TAA_COLOR: 'taaColor',\n  TAA_MOTION_VECTOR: 'taaMotionVector'\n} as const;\n"],"names":["RGHistoryResources","TAA_COLOR","TAA_MOTION_VECTOR"],"mappings":"AAAA;;;UAIaA,kBAAqB,GAAA;IAChCC,SAAW,EAAA,UAAA;IACXC,iBAAmB,EAAA;AACrB;;;;"}
+{"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;;;;"}

package/dist/render/rendergraph/types.js

@@ -1,12 +1,12 @@
 // ─── Handles ────────────────────────────────────────────────────────────
-/**
- * Opaque handle referencing a resource within the render graph.
- *
- * Handles are obtained from {@link RGPassBuilder.createTexture}, {@link RGPassBuilder.createFramebuffer},
- * {@link RenderGraph.importTexture}, or {@link RGPassBuilder.write}. They are lightweight identifiers
- * used to declare dependencies between passes.
- *
- * @public
+/**
+ * Opaque handle referencing a resource within the render graph.
+ *
+ * Handles are obtained from {@link RGPassBuilder.createTexture}, {@link RGPassBuilder.createFramebuffer},
+ * {@link RenderGraph.importTexture}, or {@link RGPassBuilder.write}. They are lightweight identifiers
+ * used to declare dependencies between passes.
+ *
+ * @public
  */ class RGHandle {
     /** @internal */ _id;
     /** @internal */ _name;
@@ -18,9 +18,9 @@
         return this._name;
     }
 }
-/**
- * Internal bookkeeping for a resource within the render graph.
- * @public
+/**
+ * Internal bookkeeping for a resource within the render graph.
+ * @public
  */ class RGResource {
     id;
     name;
@@ -37,14 +37,14 @@
         this.physicalId = physicalId;
     }
 }
-/**
- * Ordered execution step inside a render graph pass.
- *
- * Subpasses share the parent pass's resource declarations, lifetime, culling,
- * and access validation. They are intended to make multi-step pass bodies
- * explicit without splitting graph-level resource dependencies.
- *
- * @public
+/**
+ * Ordered execution step inside a render graph pass.
+ *
+ * Subpasses share the parent pass's resource declarations, lifetime, culling,
+ * and access validation. They are intended to make multi-step pass bodies
+ * explicit without splitting graph-level resource dependencies.
+ *
+ * @public
  */ class RGSubpass {
     name;
     executeFn;
@@ -53,9 +53,9 @@
         this.executeFn = executeFn;
     }
 }
-/**
- * Internal bookkeeping for a pass within the render graph.
- * @public
+/**
+ * Internal bookkeeping for a pass within the render graph.
+ * @public
  */ class RGPass {
     index;
     name;

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

@@ -1 +1 @@
-{"version":3,"file":"types.js","sources":["../../../src/render/rendergraph/types.ts"],"sourcesContent":["import type { TextureFormat } from '@zephyr3d/device';\n\n// ─── Resource Descriptors ───────────────────────────────────────────────\n\n/**\n * Sizing mode for render graph textures.\n *\n * - 'absolute': fixed pixel dimensions\n * - 'backbuffer-relative': scaled relative to the backbuffer size\n *\n * @public\n */\nexport type RGSizeMode = 'absolute' | 'backbuffer-relative';\n\n/**\n * Descriptor for a transient texture resource within the render graph.\n *\n * Transient textures are allocated and released automatically by the graph compiler.\n *\n * @public\n */\nexport interface RGTextureDesc {\n  /** Debug label for this resource. */\n  label?: string;\n  /** Texture format (e.g. 'rgba8unorm', 'r32f', 'rgba16f'). */\n  format: TextureFormat;\n  /** Sizing mode. Default 'backbuffer-relative'. */\n  sizeMode?: RGSizeMode;\n  /** Width in pixels (absolute) or scale factor (backbuffer-relative, default 1.0). */\n  width?: number;\n  /** Height in pixels (absolute) or scale factor (backbuffer-relative, default 1.0). */\n  height?: number;\n  /** Number of mip levels. Default 1. */\n  mipLevels?: number;\n}\n\n// ─── Handles ────────────────────────────────────────────────────────────\n\n/**\n * Opaque handle referencing a resource within the render graph.\n *\n * Handles are obtained from {@link RGPassBuilder.createTexture}, {@link RGPassBuilder.createFramebuffer},\n * {@link RenderGraph.importTexture}, or {@link RGPassBuilder.write}. They are lightweight identifiers\n * used to declare dependencies between passes.\n *\n * @public\n */\nexport class RGHandle {\n  /** @internal */\n  readonly _id: number;\n  /** @internal */\n  readonly _name: string;\n\n  /** @internal */\n  constructor(id: number, name: string) {\n    this._id = id;\n    this._name = name;\n  }\n\n  /** Debug-friendly name of the referenced resource. */\n  get name(): string {\n    return this._name;\n  }\n}\n\n// ─── Internal Resource Tracking ─────────────────────────────────────────\n\n/** @public */\nexport type RGResourceKind = 'transient' | 'imported' | 'token' | 'framebuffer';\n\n/**\n * Internal bookkeeping for a resource within the render graph.\n * @public\n */\nexport class RGResource {\n  readonly id: number;\n  readonly name: string;\n  readonly kind: RGResourceKind;\n  readonly desc: RGTextureDesc | RGFramebufferDesc | null;\n  /** Resource ID of the physical backing resource used by imported versions. */\n  readonly physicalId: number;\n  /** The pass that creates / writes this resource (null for imported until written). */\n  producer: RGPass | null = null;\n  /** Passes that read this resource. */\n  readonly consumers: RGPass[] = [];\n\n  constructor(\n    id: number,\n    name: string,\n    kind: RGResourceKind,\n    desc: RGTextureDesc | RGFramebufferDesc | null,\n    physicalId = id\n  ) {\n    this.id = id;\n    this.name = name;\n    this.kind = kind;\n    this.desc = desc;\n    this.physicalId = physicalId;\n  }\n}\n\n// ─── Internal Pass Tracking ─────────────────────────────────────────────\n\n// ─── Execution Context ──────────────────────────────────────────────\n\n/**\n * Context passed to pass execute callbacks during graph execution.\n *\n * Provides access to resolved GPU resources by their handles.\n *\n * @public\n */\nexport interface RGExecuteContext {\n  /**\n   * Resolve a handle to the actual GPU texture object.\n   *\n   * For transient resources, this returns the texture allocated by the executor.\n   * For imported resources, this returns the texture registered via\n   * {@link RenderGraphExecutor.setImportedTexture}. The handle must be declared\n   * by the current pass with {@link RGPassBuilder.read} or {@link RGPassBuilder.write}.\n   *\n   * @param handle - Handle of the resource to resolve.\n   * @returns The resolved texture object (type depends on the allocator).\n   */\n  getTexture<TTexture = unknown>(handle: RGHandle): TTexture;\n\n  /**\n   * Resolve a framebuffer handle to the actual backend framebuffer object.\n   *\n   * The handle must be declared by the current pass with {@link RGPassBuilder.read}\n   * or created by the same pass with {@link RGPassBuilder.createFramebuffer}.\n   *\n   * @param handle - Handle returned from {@link RGPassBuilder.createFramebuffer}.\n   * @returns The resolved framebuffer object (type depends on the allocator).\n   */\n  getFramebuffer<TFramebuffer = unknown>(handle: RGHandle): TFramebuffer;\n\n  /**\n   * Create a temporary framebuffer managed by the graph executor.\n   *\n   * The framebuffer is released automatically when graph execution finishes or\n   * aborts. Attachments may be actual backend resources or texture formats,\n   * depending on the allocator implementation. If an attachment is an\n   * {@link RGHandle}, the current pass must declare it with\n   * {@link RGPassBuilder.read} or {@link RGPassBuilder.write}.\n   *\n   * @param desc - Framebuffer descriptor.\n   * @returns The allocated framebuffer object (type depends on the allocator).\n   */\n  createFramebuffer<TFramebuffer = unknown>(desc: RGFramebufferDesc): TFramebuffer;\n\n  /**\n   * Register a cleanup callback to run when graph execution finishes or aborts.\n   *\n   * Callbacks run in reverse registration order. Use this for temporary objects\n   * created inside pass execution that are not graph resources, such as pooled\n   * framebuffers wrapping graph-managed textures. If pass execution throws, the\n   * executor still runs cleanup callbacks and preserves the original pass error\n   * ahead of cleanup errors.\n   *\n   * @param callback - Cleanup function to invoke after execution.\n   */\n  deferCleanup(callback: () => void): void;\n}\n\n/**\n * Execute callback signature.\n *\n * The callback receives a context for resolving handles to GPU resources,\n * plus the user data returned from the setup function.\n *\n * @public\n */\nexport type RGExecuteFn<T = void> = (ctx: RGExecuteContext, data: T) => void;\n\n/**\n * Ordered execution step inside a render graph pass.\n *\n * Subpasses share the parent pass's resource declarations, lifetime, culling,\n * and access validation. They are intended to make multi-step pass bodies\n * explicit without splitting graph-level resource dependencies.\n *\n * @public\n */\nexport class RGSubpass<T = unknown> {\n  readonly name: string;\n  readonly executeFn: RGExecuteFn<T>;\n\n  constructor(name: string, executeFn: RGExecuteFn<T>) {\n    this.name = name;\n    this.executeFn = executeFn;\n  }\n}\n\n/**\n * Internal bookkeeping for a pass within the render graph.\n * @public\n */\nexport class RGPass<T = unknown> {\n  readonly index: number;\n  readonly name: string;\n  /** Resources this pass reads (dependencies). */\n  readonly reads: RGResource[] = [];\n  /** Resources this pass creates or writes. */\n  readonly writes: RGResource[] = [];\n  /** Passes that must complete before this pass due to non-resource hazards. */\n  readonly dependencies: RGPass[] = [];\n  /** Whether this pass has side effects and must not be culled. */\n  hasSideEffect = false;\n  /** User data returned from the setup function. */\n  data: T | null = null;\n  /** Execute callback. */\n  executeFn: RGExecuteFn<T> | null = null;\n  /** Ordered subpasses for passes with multiple logical execution steps. */\n  readonly subpasses: RGSubpass<T>[] = [];\n  /** Set during compilation: true if this pass is needed. */\n  alive = true;\n\n  constructor(index: number, name: string) {\n    this.index = index;\n    this.name = name;\n  }\n}\n\n// ─── Pass Builder ───────────────────────────────────────────────────────\n\n/**\n * Builder interface used within the setup callback of {@link RenderGraph.addPass}\n * to declare a pass's resource requirements.\n *\n * @public\n */\nexport interface RGPassBuilder {\n  /**\n   * Declare a read dependency on an existing resource.\n   *\n   * The resource must have been created by a prior pass or imported into the graph.\n   *\n   * @param handle - Handle of the resource to read.\n   */\n  read(handle: RGHandle): void;\n\n  /**\n   * Declare that this pass writes a new version of an existing resource.\n   *\n   * The returned handle represents the post-write version. Use it for subsequent\n   * reads and as the graph output passed to {@link RenderGraph.compile}. Passing\n   * an older version of the same resource to `compile()` is rejected because it\n   * usually means the caller ignored the handle returned by `write()`. If the pass\n   * needs the previous contents, call {@link RGPassBuilder.read} on the input handle explicitly\n   * before writing.\n   *\n   * @param handle - Handle of the resource to write to.\n   * @returns A handle referencing the newly written version.\n   */\n  write(handle: RGHandle): RGHandle;\n\n  /**\n   * Create a new transient texture resource that this pass will produce.\n   *\n   * @param desc - Texture descriptor.\n   * @returns A handle referencing the newly created resource.\n   */\n  createTexture(desc: RGTextureDesc): RGHandle;\n\n  /**\n   * Create a logical dependency token produced by this pass.\n   *\n   * Tokens do not resolve to GPU resources and are not allocated by the executor.\n   * They are useful for ordering passes whose dependencies are side effects rather\n   * than texture reads/writes.\n   *\n   * @param name - Debug label for this token.\n   * @returns A handle referencing the newly created token.\n   */\n  createToken(name?: string): RGHandle;\n\n  /**\n   * Create a graph-managed framebuffer view.\n   *\n   * The graph compiler infers dependencies from any attachment handles in the\n   * descriptor. The executor creates and releases the framebuffer automatically.\n   *\n   * @param desc - Framebuffer descriptor.\n   * @returns A handle referencing the framebuffer view.\n   */\n  createFramebuffer(desc: RGFramebufferDesc): RGHandle;\n\n  /**\n   * Mark this pass as having side effects.\n   *\n   * Side-effect passes are never culled by the graph compiler, regardless of\n   * whether their outputs are consumed. Use this for GPU readback, picking,\n   * debug overlays, etc.\n   */\n  sideEffect(): void;\n\n  /**\n   * Add an ordered logical subpass to this pass.\n   *\n   * Subpasses execute in registration order and share the parent pass's declared\n   * reads, writes, framebuffer views, and user data. A pass may use either\n   * subpasses or {@link RGPassBuilder.setExecute}, but not both.\n   *\n   * @param name - Debug label for the subpass.\n   * @param fn - Callback invoked when this subpass executes.\n   */\n  addSubpass<D>(name: string, fn: RGExecuteFn<D>): void;\n\n  /**\n   * Set the execution callback for this pass.\n   *\n   * A pass may use either this method or {@link RGPassBuilder.addSubpass}, but not both.\n   *\n   * @param fn - Callback invoked during graph execution.\n   */\n  setExecute<D>(fn: RGExecuteFn<D>): void;\n}\n\n// ─── Compiled Graph ─────────────────────────────────────────────────────\n\n/**\n * Lifetime information for a resource within the compiled graph.\n *\n * @public\n */\nexport interface RGResourceLifetime {\n  /** The resource. */\n  readonly resource: RGResource;\n  /** Index of the first pass that uses (produces or reads) this resource. */\n  readonly firstUse: number;\n  /** Index of the last pass that uses this resource. */\n  readonly lastUse: number;\n}\n\n/**\n * Result of compiling a render graph.\n *\n * Contains the ordered list of passes to execute and lifetime information\n * for automatic resource management.\n *\n * @public\n */\nexport interface CompiledRenderGraph {\n  /** Topologically sorted passes (only non-culled passes). */\n  readonly orderedPasses: ReadonlyArray<RGPass>;\n  /** Resource lifetime information keyed by resource ID. */\n  readonly lifetimes: ReadonlyMap<number, RGResourceLifetime>;\n}\n\n// ─── Texture Allocator ──────────────────────────────────────────────\n\n/**\n * Resolved dimensions for a texture allocation.\n * @public\n */\nexport interface RGResolvedSize {\n  width: number;\n  height: number;\n}\n\n/**\n * Descriptor for a framebuffer view managed by the graph or created temporarily during pass execution.\n *\n * This is intentionally backend-agnostic: graph-managed descriptors may use\n * {@link RGHandle} attachments, and executor-created descriptors use resolved\n * resources or texture formats understood by the allocator.\n *\n * @public\n */\nexport interface RGFramebufferDesc {\n  /** Debug label for this framebuffer. */\n  label?: string;\n  /** Framebuffer width. Required when attachments are formats. */\n  width?: number;\n  /** Framebuffer height. Required when attachments are formats. */\n  height?: number;\n  /** Color attachments or formats. */\n  colorAttachments: unknown | unknown[] | null;\n  /** Depth/stencil attachment or format. */\n  depthAttachment?: unknown | null;\n  /** Whether color attachments created from formats should support mipmapping. */\n  mipmapping?: boolean;\n  /** Framebuffer sample count. */\n  sampleCount?: number;\n  /** Whether to ignore depth/stencil during MSAA resolve. */\n  ignoreDepthStencil?: boolean;\n  /** Attachment mip level. */\n  attachmentMipLevel?: number;\n  /** Attachment cubemap face. */\n  attachmentCubeface?: number;\n  /** Attachment array layer. */\n  attachmentLayer?: number;\n}\n\n/**\n * Interface for allocating and releasing transient textures.\n *\n * Implement this to bridge the render graph with your GPU device's resource pool.\n * The executor calls `allocate()` before a resource's first use and\n * `release()` after its last use.\n *\n * @typeParam TTexture - The concrete texture type (e.g. `Texture2D`).\n * @public\n */\nexport interface RGTextureAllocator<TTexture = unknown, TFramebuffer = unknown> {\n  /**\n   * Allocate a transient texture matching the given descriptor and resolved size.\n   *\n   * @param desc - The texture descriptor from the pass builder.\n   * @param size - The resolved pixel dimensions.\n   * @returns The allocated texture object.\n   */\n  allocate(desc: RGTextureDesc, size: RGResolvedSize): TTexture;\n\n  /**\n   * Release a previously allocated transient texture back to the pool.\n   *\n   * @param texture - The texture to release.\n   */\n  release(texture: TTexture): void;\n\n  /**\n   * Allocate a temporary framebuffer matching the given descriptor.\n   *\n   * Implementations should not auto-release this framebuffer; the graph executor\n   * calls {@link RGTextureAllocator.releaseFramebuffer} when execution completes or aborts.\n   *\n   * @param desc - Framebuffer descriptor.\n   * @returns The allocated framebuffer object.\n   */\n  allocateFramebuffer?(desc: RGFramebufferDesc): TFramebuffer;\n\n  /**\n   * Release a previously allocated temporary framebuffer.\n   *\n   * @param framebuffer - The framebuffer to release.\n   */\n  releaseFramebuffer?(framebuffer: TFramebuffer): void;\n}\n"],"names":["RGHandle","id","name","_id","_name","RGResource","kind","desc","producer","consumers","physicalId","RGSubpass","executeFn","RGPass","index","reads","writes","dependencies","hasSideEffect","data","subpasses","alive"],"mappings":"AAoCA;AAEA;;;;;;;;AAQC,IACM,MAAMA,QAAAA,CAAAA;qBAEX,GAAqB;qBAErB,KAAuB;AAEvB,qBACA,WAAA,CAAYC,EAAU,EAAEC,IAAY,CAAE;QACpC,IAAI,CAACC,GAAG,GAAGF,EAAAA;QACX,IAAI,CAACG,KAAK,GAAGF,IAAAA;AACf;2DAGA,IAAIA,IAAe,GAAA;QACjB,OAAO,IAAI,CAACE,KAAK;AACnB;AACF;AAOA;;;AAGC,IACM,MAAMC,UAAAA,CAAAA;IACFJ,EAAW;IACXC,IAAa;IACbI,IAAqB;IACrBC,IAA+C;mFAExD,UAA4B;2FAE5BC,WAA0B,IAAK;AAC/B,2CACSC,SAAsB,GAAA,EAAE;IAEjC,WACER,CAAAA,EAAU,EACVC,IAAY,EACZI,IAAoB,EACpBC,IAA8C,EAC9CG,UAAaT,GAAAA,EAAE,CACf;QACA,IAAI,CAACA,EAAE,GAAGA,EAAAA;QACV,IAAI,CAACC,IAAI,GAAGA,IAAAA;QACZ,IAAI,CAACI,IAAI,GAAGA,IAAAA;QACZ,IAAI,CAACC,IAAI,GAAGA,IAAAA;QACZ,IAAI,CAACG,UAAU,GAAGA,UAAAA;AACpB;AACF;AA4EA;;;;;;;;AAQC,IACM,MAAMC,SAAAA,CAAAA;IACFT,IAAa;IACbU,SAA0B;IAEnC,WAAYV,CAAAA,IAAY,EAAEU,SAAyB,CAAE;QACnD,IAAI,CAACV,IAAI,GAAGA,IAAAA;QACZ,IAAI,CAACU,SAAS,GAAGA,SAAAA;AACnB;AACF;AAEA;;;AAGC,IACM,MAAMC,MAAAA,CAAAA;IACFC,KAAc;IACdZ,IAAa;AACtB,qDACSa,KAAsB,GAAA,EAAE;AACjC,kDACSC,MAAuB,GAAA,EAAE;AAClC,mFACSC,YAAyB,GAAA,EAAE;sEAEpCC,gBAAgB,KAAM;uDAEtBC,OAAiB,IAAK;6BAEtBP,YAAmC,IAAK;AACxC,+EACSQ,SAA4B,GAAA,EAAE;gEAEvCC,QAAQ,IAAK;IAEb,WAAYP,CAAAA,KAAa,EAAEZ,IAAY,CAAE;QACvC,IAAI,CAACY,KAAK,GAAGA,KAAAA;QACb,IAAI,CAACZ,IAAI,GAAGA,IAAAA;AACd;AACF;;;;"}
+{"version":3,"file":"types.js","sources":["../../../src/render/rendergraph/types.ts"],"sourcesContent":["import type { TextureFormat } from '@zephyr3d/device';\r\n\r\n// ─── Resource Descriptors ───────────────────────────────────────────────\r\n\r\n/**\r\n * Sizing mode for render graph textures.\r\n *\r\n * - 'absolute': fixed pixel dimensions\r\n * - 'backbuffer-relative': scaled relative to the backbuffer size\r\n *\r\n * @public\r\n */\r\nexport type RGSizeMode = 'absolute' | 'backbuffer-relative';\r\n\r\n/**\r\n * Descriptor for a transient texture resource within the render graph.\r\n *\r\n * Transient textures are allocated and released automatically by the graph compiler.\r\n *\r\n * @public\r\n */\r\nexport interface RGTextureDesc {\r\n  /** Debug label for this resource. */\r\n  label?: string;\r\n  /** Texture format (e.g. 'rgba8unorm', 'r32f', 'rgba16f'). */\r\n  format: TextureFormat;\r\n  /** Sizing mode. Default 'backbuffer-relative'. */\r\n  sizeMode?: RGSizeMode;\r\n  /** Width in pixels (absolute) or scale factor (backbuffer-relative, default 1.0). */\r\n  width?: number;\r\n  /** Height in pixels (absolute) or scale factor (backbuffer-relative, default 1.0). */\r\n  height?: number;\r\n  /** Number of mip levels. Default 1. */\r\n  mipLevels?: number;\r\n}\r\n\r\n// ─── Handles ────────────────────────────────────────────────────────────\r\n\r\n/**\r\n * Opaque handle referencing a resource within the render graph.\r\n *\r\n * Handles are obtained from {@link RGPassBuilder.createTexture}, {@link RGPassBuilder.createFramebuffer},\r\n * {@link RenderGraph.importTexture}, or {@link RGPassBuilder.write}. They are lightweight identifiers\r\n * used to declare dependencies between passes.\r\n *\r\n * @public\r\n */\r\nexport class RGHandle {\r\n  /** @internal */\r\n  readonly _id: number;\r\n  /** @internal */\r\n  readonly _name: string;\r\n\r\n  /** @internal */\r\n  constructor(id: number, name: string) {\r\n    this._id = id;\r\n    this._name = name;\r\n  }\r\n\r\n  /** Debug-friendly name of the referenced resource. */\r\n  get name(): string {\r\n    return this._name;\r\n  }\r\n}\r\n\r\n// ─── Internal Resource Tracking ─────────────────────────────────────────\r\n\r\n/** @public */\r\nexport type RGResourceKind = 'transient' | 'imported' | 'token' | 'framebuffer';\r\n\r\n/**\r\n * Internal bookkeeping for a resource within the render graph.\r\n * @public\r\n */\r\nexport class RGResource {\r\n  readonly id: number;\r\n  readonly name: string;\r\n  readonly kind: RGResourceKind;\r\n  readonly desc: RGTextureDesc | RGFramebufferDesc | null;\r\n  /** Resource ID of the physical backing resource used by imported versions. */\r\n  readonly physicalId: number;\r\n  /** The pass that creates / writes this resource (null for imported until written). */\r\n  producer: RGPass | null = null;\r\n  /** Passes that read this resource. */\r\n  readonly consumers: RGPass[] = [];\r\n\r\n  constructor(\r\n    id: number,\r\n    name: string,\r\n    kind: RGResourceKind,\r\n    desc: RGTextureDesc | RGFramebufferDesc | null,\r\n    physicalId = id\r\n  ) {\r\n    this.id = id;\r\n    this.name = name;\r\n    this.kind = kind;\r\n    this.desc = desc;\r\n    this.physicalId = physicalId;\r\n  }\r\n}\r\n\r\n// ─── Internal Pass Tracking ─────────────────────────────────────────────\r\n\r\n// ─── Execution Context ──────────────────────────────────────────────\r\n\r\n/**\r\n * Context passed to pass execute callbacks during graph execution.\r\n *\r\n * Provides access to resolved GPU resources by their handles.\r\n *\r\n * @public\r\n */\r\nexport interface RGExecuteContext {\r\n  /**\r\n   * Resolve a handle to the actual GPU texture object.\r\n   *\r\n   * For transient resources, this returns the texture allocated by the executor.\r\n   * For imported resources, this returns the texture registered via\r\n   * {@link RenderGraphExecutor.setImportedTexture}. The handle must be declared\r\n   * by the current pass with {@link RGPassBuilder.read} or {@link RGPassBuilder.write}.\r\n   *\r\n   * @param handle - Handle of the resource to resolve.\r\n   * @returns The resolved texture object (type depends on the allocator).\r\n   */\r\n  getTexture<TTexture = unknown>(handle: RGHandle): TTexture;\r\n\r\n  /**\r\n   * Resolve a framebuffer handle to the actual backend framebuffer object.\r\n   *\r\n   * The handle must be declared by the current pass with {@link RGPassBuilder.read}\r\n   * or created by the same pass with {@link RGPassBuilder.createFramebuffer}.\r\n   *\r\n   * @param handle - Handle returned from {@link RGPassBuilder.createFramebuffer}.\r\n   * @returns The resolved framebuffer object (type depends on the allocator).\r\n   */\r\n  getFramebuffer<TFramebuffer = unknown>(handle: RGHandle): TFramebuffer;\r\n\r\n  /**\r\n   * Create a temporary framebuffer managed by the graph executor.\r\n   *\r\n   * The framebuffer is released automatically when graph execution finishes or\r\n   * aborts. Attachments may be actual backend resources or texture formats,\r\n   * depending on the allocator implementation. If an attachment is an\r\n   * {@link RGHandle}, the current pass must declare it with\r\n   * {@link RGPassBuilder.read} or {@link RGPassBuilder.write}.\r\n   *\r\n   * @param desc - Framebuffer descriptor.\r\n   * @returns The allocated framebuffer object (type depends on the allocator).\r\n   */\r\n  createFramebuffer<TFramebuffer = unknown>(desc: RGFramebufferDesc): TFramebuffer;\r\n\r\n  /**\r\n   * Register a cleanup callback to run when graph execution finishes or aborts.\r\n   *\r\n   * Callbacks run in reverse registration order. Use this for temporary objects\r\n   * created inside pass execution that are not graph resources, such as pooled\r\n   * framebuffers wrapping graph-managed textures. If pass execution throws, the\r\n   * executor still runs cleanup callbacks and preserves the original pass error\r\n   * ahead of cleanup errors.\r\n   *\r\n   * @param callback - Cleanup function to invoke after execution.\r\n   */\r\n  deferCleanup(callback: () => void): void;\r\n}\r\n\r\n/**\r\n * Execute callback signature.\r\n *\r\n * The callback receives a context for resolving handles to GPU resources,\r\n * plus the user data returned from the setup function.\r\n *\r\n * @public\r\n */\r\nexport type RGExecuteFn<T = void> = (ctx: RGExecuteContext, data: T) => void;\r\n\r\n/**\r\n * Ordered execution step inside a render graph pass.\r\n *\r\n * Subpasses share the parent pass's resource declarations, lifetime, culling,\r\n * and access validation. They are intended to make multi-step pass bodies\r\n * explicit without splitting graph-level resource dependencies.\r\n *\r\n * @public\r\n */\r\nexport class RGSubpass<T = unknown> {\r\n  readonly name: string;\r\n  readonly executeFn: RGExecuteFn<T>;\r\n\r\n  constructor(name: string, executeFn: RGExecuteFn<T>) {\r\n    this.name = name;\r\n    this.executeFn = executeFn;\r\n  }\r\n}\r\n\r\n/**\r\n * Internal bookkeeping for a pass within the render graph.\r\n * @public\r\n */\r\nexport class RGPass<T = unknown> {\r\n  readonly index: number;\r\n  readonly name: string;\r\n  /** Resources this pass reads (dependencies). */\r\n  readonly reads: RGResource[] = [];\r\n  /** Resources this pass creates or writes. */\r\n  readonly writes: RGResource[] = [];\r\n  /** Passes that must complete before this pass due to non-resource hazards. */\r\n  readonly dependencies: RGPass[] = [];\r\n  /** Whether this pass has side effects and must not be culled. */\r\n  hasSideEffect = false;\r\n  /** User data returned from the setup function. */\r\n  data: T | null = null;\r\n  /** Execute callback. */\r\n  executeFn: RGExecuteFn<T> | null = null;\r\n  /** Ordered subpasses for passes with multiple logical execution steps. */\r\n  readonly subpasses: RGSubpass<T>[] = [];\r\n  /** Set during compilation: true if this pass is needed. */\r\n  alive = true;\r\n\r\n  constructor(index: number, name: string) {\r\n    this.index = index;\r\n    this.name = name;\r\n  }\r\n}\r\n\r\n// ─── Pass Builder ───────────────────────────────────────────────────────\r\n\r\n/**\r\n * Builder interface used within the setup callback of {@link RenderGraph.addPass}\r\n * to declare a pass's resource requirements.\r\n *\r\n * @public\r\n */\r\nexport interface RGPassBuilder {\r\n  /**\r\n   * Declare a read dependency on an existing resource.\r\n   *\r\n   * The resource must have been created by a prior pass or imported into the graph.\r\n   *\r\n   * @param handle - Handle of the resource to read.\r\n   */\r\n  read(handle: RGHandle): void;\r\n\r\n  /**\r\n   * Declare that this pass writes a new version of an existing resource.\r\n   *\r\n   * The returned handle represents the post-write version. Use it for subsequent\r\n   * reads and as the graph output passed to {@link RenderGraph.compile}. Passing\r\n   * an older version of the same resource to `compile()` is rejected because it\r\n   * usually means the caller ignored the handle returned by `write()`. If the pass\r\n   * needs the previous contents, call {@link RGPassBuilder.read} on the input handle explicitly\r\n   * before writing.\r\n   *\r\n   * @param handle - Handle of the resource to write to.\r\n   * @returns A handle referencing the newly written version.\r\n   */\r\n  write(handle: RGHandle): RGHandle;\r\n\r\n  /**\r\n   * Create a new transient texture resource that this pass will produce.\r\n   *\r\n   * @param desc - Texture descriptor.\r\n   * @returns A handle referencing the newly created resource.\r\n   */\r\n  createTexture(desc: RGTextureDesc): RGHandle;\r\n\r\n  /**\r\n   * Create a logical dependency token produced by this pass.\r\n   *\r\n   * Tokens do not resolve to GPU resources and are not allocated by the executor.\r\n   * They are useful for ordering passes whose dependencies are side effects rather\r\n   * than texture reads/writes.\r\n   *\r\n   * @param name - Debug label for this token.\r\n   * @returns A handle referencing the newly created token.\r\n   */\r\n  createToken(name?: string): RGHandle;\r\n\r\n  /**\r\n   * Create a graph-managed framebuffer view.\r\n   *\r\n   * The graph compiler infers dependencies from any attachment handles in the\r\n   * descriptor. The executor creates and releases the framebuffer automatically.\r\n   *\r\n   * @param desc - Framebuffer descriptor.\r\n   * @returns A handle referencing the framebuffer view.\r\n   */\r\n  createFramebuffer(desc: RGFramebufferDesc): RGHandle;\r\n\r\n  /**\r\n   * Mark this pass as having side effects.\r\n   *\r\n   * Side-effect passes are never culled by the graph compiler, regardless of\r\n   * whether their outputs are consumed. Use this for GPU readback, picking,\r\n   * debug overlays, etc.\r\n   */\r\n  sideEffect(): void;\r\n\r\n  /**\r\n   * Add an ordered logical subpass to this pass.\r\n   *\r\n   * Subpasses execute in registration order and share the parent pass's declared\r\n   * reads, writes, framebuffer views, and user data. A pass may use either\r\n   * subpasses or {@link RGPassBuilder.setExecute}, but not both.\r\n   *\r\n   * @param name - Debug label for the subpass.\r\n   * @param fn - Callback invoked when this subpass executes.\r\n   */\r\n  addSubpass<D>(name: string, fn: RGExecuteFn<D>): void;\r\n\r\n  /**\r\n   * Set the execution callback for this pass.\r\n   *\r\n   * A pass may use either this method or {@link RGPassBuilder.addSubpass}, but not both.\r\n   *\r\n   * @param fn - Callback invoked during graph execution.\r\n   */\r\n  setExecute<D>(fn: RGExecuteFn<D>): void;\r\n}\r\n\r\n// ─── Compiled Graph ─────────────────────────────────────────────────────\r\n\r\n/**\r\n * Lifetime information for a resource within the compiled graph.\r\n *\r\n * @public\r\n */\r\nexport interface RGResourceLifetime {\r\n  /** The resource. */\r\n  readonly resource: RGResource;\r\n  /** Index of the first pass that uses (produces or reads) this resource. */\r\n  readonly firstUse: number;\r\n  /** Index of the last pass that uses this resource. */\r\n  readonly lastUse: number;\r\n}\r\n\r\n/**\r\n * Result of compiling a render graph.\r\n *\r\n * Contains the ordered list of passes to execute and lifetime information\r\n * for automatic resource management.\r\n *\r\n * @public\r\n */\r\nexport interface CompiledRenderGraph {\r\n  /** Topologically sorted passes (only non-culled passes). */\r\n  readonly orderedPasses: ReadonlyArray<RGPass>;\r\n  /** Resource lifetime information keyed by resource ID. */\r\n  readonly lifetimes: ReadonlyMap<number, RGResourceLifetime>;\r\n}\r\n\r\n// ─── Texture Allocator ──────────────────────────────────────────────\r\n\r\n/**\r\n * Resolved dimensions for a texture allocation.\r\n * @public\r\n */\r\nexport interface RGResolvedSize {\r\n  width: number;\r\n  height: number;\r\n}\r\n\r\n/**\r\n * Descriptor for a framebuffer view managed by the graph or created temporarily during pass execution.\r\n *\r\n * This is intentionally backend-agnostic: graph-managed descriptors may use\r\n * {@link RGHandle} attachments, and executor-created descriptors use resolved\r\n * resources or texture formats understood by the allocator.\r\n *\r\n * @public\r\n */\r\nexport interface RGFramebufferDesc {\r\n  /** Debug label for this framebuffer. */\r\n  label?: string;\r\n  /** Framebuffer width. Required when attachments are formats. */\r\n  width?: number;\r\n  /** Framebuffer height. Required when attachments are formats. */\r\n  height?: number;\r\n  /** Color attachments or formats. */\r\n  colorAttachments: unknown | unknown[] | null;\r\n  /** Depth/stencil attachment or format. */\r\n  depthAttachment?: unknown | null;\r\n  /** Whether color attachments created from formats should support mipmapping. */\r\n  mipmapping?: boolean;\r\n  /** Framebuffer sample count. */\r\n  sampleCount?: number;\r\n  /** Whether to ignore depth/stencil during MSAA resolve. */\r\n  ignoreDepthStencil?: boolean;\r\n  /** Attachment mip level. */\r\n  attachmentMipLevel?: number;\r\n  /** Attachment cubemap face. */\r\n  attachmentCubeface?: number;\r\n  /** Attachment array layer. */\r\n  attachmentLayer?: number;\r\n}\r\n\r\n/**\r\n * Interface for allocating and releasing transient textures.\r\n *\r\n * Implement this to bridge the render graph with your GPU device's resource pool.\r\n * The executor calls `allocate()` before a resource's first use and\r\n * `release()` after its last use.\r\n *\r\n * @typeParam TTexture - The concrete texture type (e.g. `Texture2D`).\r\n * @public\r\n */\r\nexport interface RGTextureAllocator<TTexture = unknown, TFramebuffer = unknown> {\r\n  /**\r\n   * Allocate a transient texture matching the given descriptor and resolved size.\r\n   *\r\n   * @param desc - The texture descriptor from the pass builder.\r\n   * @param size - The resolved pixel dimensions.\r\n   * @returns The allocated texture object.\r\n   */\r\n  allocate(desc: RGTextureDesc, size: RGResolvedSize): TTexture;\r\n\r\n  /**\r\n   * Release a previously allocated transient texture back to the pool.\r\n   *\r\n   * @param texture - The texture to release.\r\n   */\r\n  release(texture: TTexture): void;\r\n\r\n  /**\r\n   * Allocate a temporary framebuffer matching the given descriptor.\r\n   *\r\n   * Implementations should not auto-release this framebuffer; the graph executor\r\n   * calls {@link RGTextureAllocator.releaseFramebuffer} when execution completes or aborts.\r\n   *\r\n   * @param desc - Framebuffer descriptor.\r\n   * @returns The allocated framebuffer object.\r\n   */\r\n  allocateFramebuffer?(desc: RGFramebufferDesc): TFramebuffer;\r\n\r\n  /**\r\n   * Release a previously allocated temporary framebuffer.\r\n   *\r\n   * @param framebuffer - The framebuffer to release.\r\n   */\r\n  releaseFramebuffer?(framebuffer: TFramebuffer): void;\r\n}\r\n"],"names":["RGHandle","id","name","_id","_name","RGResource","kind","desc","producer","consumers","physicalId","RGSubpass","executeFn","RGPass","index","reads","writes","dependencies","hasSideEffect","data","subpasses","alive"],"mappings":"AAoCA;AAEA;;;;;;;;AAQC,IACM,MAAMA,QAAAA,CAAAA;qBAEX,GAAqB;qBAErB,KAAuB;AAEvB,qBACA,WAAA,CAAYC,EAAU,EAAEC,IAAY,CAAE;QACpC,IAAI,CAACC,GAAG,GAAGF,EAAAA;QACX,IAAI,CAACG,KAAK,GAAGF,IAAAA;AACf;2DAGA,IAAIA,IAAe,GAAA;QACjB,OAAO,IAAI,CAACE,KAAK;AACnB;AACF;AAOA;;;AAGC,IACM,MAAMC,UAAAA,CAAAA;IACFJ,EAAW;IACXC,IAAa;IACbI,IAAqB;IACrBC,IAA+C;mFAExD,UAA4B;2FAE5BC,WAA0B,IAAK;AAC/B,2CACSC,SAAsB,GAAA,EAAE;IAEjC,WACER,CAAAA,EAAU,EACVC,IAAY,EACZI,IAAoB,EACpBC,IAA8C,EAC9CG,UAAaT,GAAAA,EAAE,CACf;QACA,IAAI,CAACA,EAAE,GAAGA,EAAAA;QACV,IAAI,CAACC,IAAI,GAAGA,IAAAA;QACZ,IAAI,CAACI,IAAI,GAAGA,IAAAA;QACZ,IAAI,CAACC,IAAI,GAAGA,IAAAA;QACZ,IAAI,CAACG,UAAU,GAAGA,UAAAA;AACpB;AACF;AA4EA;;;;;;;;AAQC,IACM,MAAMC,SAAAA,CAAAA;IACFT,IAAa;IACbU,SAA0B;IAEnC,WAAYV,CAAAA,IAAY,EAAEU,SAAyB,CAAE;QACnD,IAAI,CAACV,IAAI,GAAGA,IAAAA;QACZ,IAAI,CAACU,SAAS,GAAGA,SAAAA;AACnB;AACF;AAEA;;;AAGC,IACM,MAAMC,MAAAA,CAAAA;IACFC,KAAc;IACdZ,IAAa;AACtB,qDACSa,KAAsB,GAAA,EAAE;AACjC,kDACSC,MAAuB,GAAA,EAAE;AAClC,mFACSC,YAAyB,GAAA,EAAE;sEAEpCC,gBAAgB,KAAM;uDAEtBC,OAAiB,IAAK;6BAEtBP,YAAmC,IAAK;AACxC,+EACSQ,SAA4B,GAAA,EAAE;gEAEvCC,QAAQ,IAAK;IAEb,WAAYP,CAAAA,KAAa,EAAEZ,IAAY,CAAE;QACvC,IAAI,CAACY,KAAK,GAAGA,KAAAA;QACb,IAAI,CAACZ,IAAI,GAAGA,IAAAA;AACd;AACF;;;;"}

package/dist/scene/basesprite.js

@@ -19,6 +19,7 @@ import '../material/pbrsg.js';
 import '../material/pbrblueprint.js';
 import { SpriteMaterial } from '../material/sprite.js';
 import '../material/sprite_std.js';
+import '../material/msdf_text.js';
 import '../utility/blueprint/material/texture.js';
 import '../render/rendergraph/forward_plus_builder.js';
 import '../render/sky.js';
@@ -59,11 +60,6 @@ import { mixinDrawable } from '../render/drawable_mixin.js';
         this._materialChangeTag = null;
     }
     /**
-   * {@inheritDoc Drawable.getName}
-   */ getName() {
-        return this._name;
-    }
-    /**
    * Returns the batch instance ID for the current render pass.
    */ getInstanceId(_renderPass) {
         return `${this._instanceHash}:${this.worldMatrixDet >= 0}`;