@zephyr3d/scene 0.7.1 → 0.8.1

package/dist/render/rendergraph/rendergraph.js

@@ -0,0 +1,306 @@
+import { RGHandle, RGPass, RGResource } from './types.js';
+
+/**
+ * Render Graph — declarative, configurable render pipeline.
+ *
+ * Usage:
+ * ```ts
+ * const graph = new RenderGraph();
+ * const backbuffer = graph.importTexture('backbuffer');
+ *
+ * let linearDepth: RGHandle;
+ * graph.addPass('DepthPrepass', (builder) => {
+ *   linearDepth = builder.createTexture({ format: 'r32f', label: 'linearDepth' });
+ *   builder.setExecute(() => { ... });
+ * });
+ *
+ * graph.addPass('LightPass', (builder) => {
+ *   builder.read(linearDepth);
+ *   builder.write(backbuffer);
+ *   builder.setExecute(() => { ... });
+ * });
+ *
+ * const compiled = graph.compile([backbuffer]);
+ * graph.execute(compiled);
+ * graph.reset();
+ * ```
+ *
+ * @public
+ */ class RenderGraph {
+    /** @internal */ _nextResourceId = 0;
+    /** @internal */ _resources = new Map();
+    /** @internal */ _passes = [];
+    /** @internal */ _compiled = null;
+    // ─── Graph Building ─────────────────────────────────────────────────
+    /**
+   * Import an external (persistent) texture into the graph.
+   *
+   * Imported resources are not allocated or released by the graph.
+   * Typically used for the backbuffer or any texture that outlives a single frame.
+   *
+   * @param name - Debug label for the imported resource.
+   * @returns A handle referencing the imported resource.
+   */ importTexture(name) {
+        const id = this._nextResourceId++;
+        const resource = new RGResource(id, name, 'imported', null);
+        this._resources.set(id, resource);
+        this._compiled = null;
+        return new RGHandle(id, name);
+    }
+    /**
+   * Add a render pass to the graph.
+   *
+   * The setup callback receives a {@link RGPassBuilder} to declare resource
+   * dependencies. Call `builder.setExecute(fn)` inside setup to provide the
+   * execution callback.
+   *
+   * @param name - Debug label for the pass.
+   * @param setup - Setup callback that declares resources and sets the execute function.
+   */ addPass(name, setup) {
+        const pass = new RGPass(this._passes.length, name);
+        const builder = this._createBuilder(pass);
+        const data = setup(builder);
+        pass.data = data;
+        this._passes.push(pass);
+        this._compiled = null;
+        return data;
+    }
+    // ─── Compilation ────────────────────────────────────────────────────
+    /**
+   * Compile the render graph.
+   *
+   * Performs dead-pass culling, topological sorting, and resource lifetime analysis.
+   *
+   * @param outputs - Handles of resources that must be produced (graph sinks).
+   *   Passes that do not contribute to these outputs (directly or transitively)
+   *   are culled, unless marked as side-effect passes.
+   * @returns The compiled graph ready for execution.
+   */ compile(outputs) {
+        if (this._compiled) {
+            return this._compiled;
+        }
+        // 1. Mark alive passes via backward traversal from outputs + side-effect passes
+        this._cullDeadPasses(outputs);
+        // 2. Topological sort of alive passes
+        const ordered = this._topologicalSort();
+        // 3. Resource lifetime analysis
+        const lifetimes = this._analyzeLifetimes(ordered);
+        this._compiled = {
+            orderedPasses: ordered,
+            lifetimes
+        };
+        return this._compiled;
+    }
+    /**
+   * Execute a compiled render graph (simple mode, no resource management).
+   *
+   * For automatic resource allocation/release, use {@link RenderGraphExecutor} instead.
+   *
+   * @param compiled - The compiled graph from {@link compile}.
+   */ execute(compiled) {
+        const noopCtx = {
+            getTexture () {
+                throw new Error('RenderGraph.execute(): resource resolution not available. Use RenderGraphExecutor for managed execution.');
+            }
+        };
+        for (const pass of compiled.orderedPasses){
+            if (pass.executeFn) {
+                pass.executeFn(noopCtx, pass.data);
+            }
+        }
+    }
+    /**
+   * Reset the graph for the next frame.
+   *
+   * Clears all passes, transient resources, and compiled state.
+   * Imported resources are also cleared — re-import them each frame.
+   */ reset() {
+        this._passes.length = 0;
+        this._resources.clear();
+        this._nextResourceId = 0;
+        this._compiled = null;
+    }
+    // ─── Accessors (for testing / debugging) ────────────────────────────
+    /** @internal */ getResource(handle) {
+        return this._resources.get(handle._id);
+    }
+    /** @internal */ get passes() {
+        return this._passes;
+    }
+    /** @internal */ get resources() {
+        return this._resources;
+    }
+    // ─── Private: Builder ───────────────────────────────────────────────
+    /** @internal */ _createBuilder(pass) {
+        const graph = this;
+        return {
+            read (handle) {
+                const res = graph._resources.get(handle._id);
+                if (!res) {
+                    throw new Error(`RenderGraph: unknown resource "${handle.name}" (id=${handle._id})`);
+                }
+                pass.reads.push(res);
+                res.consumers.push(pass);
+            },
+            write (handle) {
+                const res = graph._resources.get(handle._id);
+                if (!res) {
+                    throw new Error(`RenderGraph: unknown resource "${handle.name}" (id=${handle._id})`);
+                }
+                if (res.producer && res.producer !== pass) {
+                    throw new Error(`RenderGraph: resource "${res.name}" already produced by pass "${res.producer.name}", ` + `cannot be written by pass "${pass.name}"`);
+                }
+                res.producer = pass;
+                pass.writes.push(res);
+            },
+            createTexture (desc) {
+                const id = graph._nextResourceId++;
+                const name = desc.label ?? `_tex_${id}`;
+                const res = new RGResource(id, name, 'transient', desc);
+                res.producer = pass;
+                graph._resources.set(id, res);
+                pass.writes.push(res);
+                return new RGHandle(id, name);
+            },
+            sideEffect () {
+                pass.hasSideEffect = true;
+            },
+            setExecute (fn) {
+                pass.executeFn = fn;
+            }
+        };
+    }
+    // ─── Private: Dead Pass Culling ─────────────────────────────────────
+    /** @internal */ _cullDeadPasses(outputs) {
+        // Start with all passes marked dead
+        for (const pass of this._passes){
+            pass.alive = false;
+        }
+        // Seed: resources that are requested outputs
+        const neededResources = new Set();
+        const stack = [];
+        for (const handle of outputs){
+            const res = this._resources.get(handle._id);
+            if (res) {
+                neededResources.add(res.id);
+                stack.push(res);
+            }
+        }
+        // Seed: side-effect passes (always alive) — push their read dependencies
+        for (const pass of this._passes){
+            if (pass.hasSideEffect) {
+                pass.alive = true;
+                for (const res of pass.reads){
+                    if (!neededResources.has(res.id)) {
+                        neededResources.add(res.id);
+                        stack.push(res);
+                    }
+                }
+            }
+        }
+        // Backward traversal: for each needed resource, mark its producer alive
+        // and recursively mark the producer's read dependencies as needed
+        while(stack.length > 0){
+            const res = stack.pop();
+            const producer = res.producer;
+            if (producer && !producer.alive) {
+                producer.alive = true;
+                for (const dep of producer.reads){
+                    if (!neededResources.has(dep.id)) {
+                        neededResources.add(dep.id);
+                        stack.push(dep);
+                    }
+                }
+            }
+        }
+    }
+    // ─── Private: Topological Sort (Kahn's Algorithm) ───────────────────
+    /** @internal */ _topologicalSort() {
+        const alivePasses = this._passes.filter((p)=>p.alive);
+        if (alivePasses.length === 0) {
+            return [];
+        }
+        // Build adjacency: producer -> consumers (only among alive passes)
+        const aliveSet = new Set(alivePasses);
+        const inDegree = new Map();
+        const adjacency = new Map();
+        for (const pass of alivePasses){
+            inDegree.set(pass, 0);
+            adjacency.set(pass, []);
+        }
+        // For each resource, its producer has an edge to each of its consumers
+        for (const res of this._resources.values()){
+            if (!res.producer || !aliveSet.has(res.producer)) {
+                continue;
+            }
+            for (const consumer of res.consumers){
+                if (!aliveSet.has(consumer)) {
+                    continue;
+                }
+                adjacency.get(res.producer).push(consumer);
+                inDegree.set(consumer, inDegree.get(consumer) + 1);
+            }
+        }
+        // Kahn's algorithm
+        const queue = [];
+        for (const pass of alivePasses){
+            if (inDegree.get(pass) === 0) {
+                queue.push(pass);
+            }
+        }
+        const result = [];
+        while(queue.length > 0){
+            const pass = queue.shift();
+            result.push(pass);
+            for (const neighbor of adjacency.get(pass)){
+                const deg = inDegree.get(neighbor) - 1;
+                inDegree.set(neighbor, deg);
+                if (deg === 0) {
+                    queue.push(neighbor);
+                }
+            }
+        }
+        if (result.length !== alivePasses.length) {
+            throw new Error(`RenderGraph: circular dependency detected. ` + `Sorted ${result.length} of ${alivePasses.length} alive passes.`);
+        }
+        return result;
+    }
+    // ─── Private: Resource Lifetime Analysis ────────────────────────────
+    /** @internal */ _analyzeLifetimes(orderedPasses) {
+        const lifetimes = new Map();
+        // Build pass -> order index map
+        const orderMap = new Map();
+        for(let i = 0; i < orderedPasses.length; i++){
+            orderMap.set(orderedPasses[i], i);
+        }
+        for (const res of this._resources.values()){
+            let first = Infinity;
+            let last = -Infinity;
+            // Producer
+            if (res.producer && orderMap.has(res.producer)) {
+                const idx = orderMap.get(res.producer);
+                first = Math.min(first, idx);
+                last = Math.max(last, idx);
+            }
+            // Consumers
+            for (const consumer of res.consumers){
+                if (orderMap.has(consumer)) {
+                    const idx = orderMap.get(consumer);
+                    first = Math.min(first, idx);
+                    last = Math.max(last, idx);
+                }
+            }
+            if (first !== Infinity) {
+                lifetimes.set(res.id, {
+                    resource: res,
+                    firstUse: first,
+                    lastUse: last
+                });
+            }
+        }
+        return lifetimes;
+    }
+}
+
+export { RenderGraph };
+//# sourceMappingURL=rendergraph.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rendergraph.js","sources":["../../../src/render/rendergraph/rendergraph.ts"],"sourcesContent":["import {\r\n  RGHandle,\r\n  RGResource,\r\n  RGPass,\r\n  type RGTextureDesc,\r\n  type RGPassBuilder,\r\n  type RGExecuteFn,\r\n  type RGExecuteContext,\r\n  type CompiledRenderGraph,\r\n  type RGResourceLifetime\r\n} from './types';\r\n\r\n/**\r\n * Render Graph — declarative, configurable render pipeline.\r\n *\r\n * Usage:\r\n * ```ts\r\n * const graph = new RenderGraph();\r\n * const backbuffer = graph.importTexture('backbuffer');\r\n *\r\n * let linearDepth: RGHandle;\r\n * graph.addPass('DepthPrepass', (builder) => {\r\n *   linearDepth = builder.createTexture({ format: 'r32f', label: 'linearDepth' });\r\n *   builder.setExecute(() => { ... });\r\n * });\r\n *\r\n * graph.addPass('LightPass', (builder) => {\r\n *   builder.read(linearDepth);\r\n *   builder.write(backbuffer);\r\n *   builder.setExecute(() => { ... });\r\n * });\r\n *\r\n * const compiled = graph.compile([backbuffer]);\r\n * graph.execute(compiled);\r\n * graph.reset();\r\n * ```\r\n *\r\n * @public\r\n */\r\nexport class RenderGraph {\r\n  /** @internal */\r\n  private _nextResourceId = 0;\r\n  /** @internal */\r\n  private _resources: Map<number, RGResource> = new Map();\r\n  /** @internal */\r\n  private _passes: RGPass[] = [];\r\n  /** @internal */\r\n  private _compiled: CompiledRenderGraph | null = null;\r\n\r\n  // ─── Graph Building ─────────────────────────────────────────────────\r\n\r\n  /**\r\n   * Import an external (persistent) texture into the graph.\r\n   *\r\n   * Imported resources are not allocated or released by the graph.\r\n   * Typically used for the backbuffer or any texture that outlives a single frame.\r\n   *\r\n   * @param name - Debug label for the imported resource.\r\n   * @returns A handle referencing the imported resource.\r\n   */\r\n  importTexture(name: string): RGHandle {\r\n    const id = this._nextResourceId++;\r\n    const resource = new RGResource(id, name, 'imported', null);\r\n    this._resources.set(id, resource);\r\n    this._compiled = null;\r\n    return new RGHandle(id, name);\r\n  }\r\n\r\n  /**\r\n   * Add a render pass to the graph.\r\n   *\r\n   * The setup callback receives a {@link RGPassBuilder} to declare resource\r\n   * dependencies. Call `builder.setExecute(fn)` inside setup to provide the\r\n   * execution callback.\r\n   *\r\n   * @param name - Debug label for the pass.\r\n   * @param setup - Setup callback that declares resources and sets the execute function.\r\n   */\r\n  addPass<T = void>(name: string, setup: (builder: RGPassBuilder) => T): T {\r\n    const pass = new RGPass(this._passes.length, name);\r\n    const builder = this._createBuilder(pass);\r\n    const data = setup(builder);\r\n    pass.data = data;\r\n    this._passes.push(pass);\r\n    this._compiled = null;\r\n    return data;\r\n  }\r\n\r\n  // ─── Compilation ────────────────────────────────────────────────────\r\n\r\n  /**\r\n   * Compile the render graph.\r\n   *\r\n   * Performs dead-pass culling, topological sorting, and resource lifetime analysis.\r\n   *\r\n   * @param outputs - Handles of resources that must be produced (graph sinks).\r\n   *   Passes that do not contribute to these outputs (directly or transitively)\r\n   *   are culled, unless marked as side-effect passes.\r\n   * @returns The compiled graph ready for execution.\r\n   */\r\n  compile(outputs: RGHandle[]): CompiledRenderGraph {\r\n    if (this._compiled) {\r\n      return this._compiled;\r\n    }\r\n    // 1. Mark alive passes via backward traversal from outputs + side-effect passes\r\n    this._cullDeadPasses(outputs);\r\n    // 2. Topological sort of alive passes\r\n    const ordered = this._topologicalSort();\r\n    // 3. Resource lifetime analysis\r\n    const lifetimes = this._analyzeLifetimes(ordered);\r\n\r\n    this._compiled = { orderedPasses: ordered, lifetimes };\r\n    return this._compiled;\r\n  }\r\n\r\n  /**\r\n   * Execute a compiled render graph (simple mode, no resource management).\r\n   *\r\n   * For automatic resource allocation/release, use {@link RenderGraphExecutor} instead.\r\n   *\r\n   * @param compiled - The compiled graph from {@link compile}.\r\n   */\r\n  execute(compiled: CompiledRenderGraph): void {\r\n    const noopCtx: RGExecuteContext = {\r\n      getTexture() {\r\n        throw new Error(\r\n          'RenderGraph.execute(): resource resolution not available. Use RenderGraphExecutor for managed execution.'\r\n        );\r\n      }\r\n    };\r\n    for (const pass of compiled.orderedPasses) {\r\n      if (pass.executeFn) {\r\n        (pass.executeFn as RGExecuteFn<unknown>)(noopCtx, pass.data);\r\n      }\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Reset the graph for the next frame.\r\n   *\r\n   * Clears all passes, transient resources, and compiled state.\r\n   * Imported resources are also cleared — re-import them each frame.\r\n   */\r\n  reset(): void {\r\n    this._passes.length = 0;\r\n    this._resources.clear();\r\n    this._nextResourceId = 0;\r\n    this._compiled = null;\r\n  }\r\n\r\n  // ─── Accessors (for testing / debugging) ────────────────────────────\r\n\r\n  /** @internal */\r\n  getResource(handle: RGHandle): RGResource | undefined {\r\n    return this._resources.get(handle._id);\r\n  }\r\n\r\n  /** @internal */\r\n  get passes(): ReadonlyArray<RGPass> {\r\n    return this._passes;\r\n  }\r\n\r\n  /** @internal */\r\n  get resources(): ReadonlyMap<number, RGResource> {\r\n    return this._resources;\r\n  }\r\n\r\n  // ─── Private: Builder ───────────────────────────────────────────────\r\n\r\n  /** @internal */\r\n  private _createBuilder(pass: RGPass): RGPassBuilder {\r\n    const graph = this;\r\n    return {\r\n      read(handle: RGHandle): void {\r\n        const res = graph._resources.get(handle._id);\r\n        if (!res) {\r\n          throw new Error(`RenderGraph: unknown resource \"${handle.name}\" (id=${handle._id})`);\r\n        }\r\n        pass.reads.push(res);\r\n        res.consumers.push(pass);\r\n      },\r\n      write(handle: RGHandle): void {\r\n        const res = graph._resources.get(handle._id);\r\n        if (!res) {\r\n          throw new Error(`RenderGraph: unknown resource \"${handle.name}\" (id=${handle._id})`);\r\n        }\r\n        if (res.producer && res.producer !== pass) {\r\n          throw new Error(\r\n            `RenderGraph: resource \"${res.name}\" already produced by pass \"${res.producer.name}\", ` +\r\n              `cannot be written by pass \"${pass.name}\"`\r\n          );\r\n        }\r\n        res.producer = pass;\r\n        pass.writes.push(res);\r\n      },\r\n      createTexture(desc: RGTextureDesc): RGHandle {\r\n        const id = graph._nextResourceId++;\r\n        const name = desc.label ?? `_tex_${id}`;\r\n        const res = new RGResource(id, name, 'transient', desc);\r\n        res.producer = pass;\r\n        graph._resources.set(id, res);\r\n        pass.writes.push(res);\r\n        return new RGHandle(id, name);\r\n      },\r\n      sideEffect(): void {\r\n        pass.hasSideEffect = true;\r\n      },\r\n      setExecute<D>(fn: RGExecuteFn<D>): void {\r\n        pass.executeFn = fn as RGExecuteFn<unknown>;\r\n      }\r\n    };\r\n  }\r\n\r\n  // ─── Private: Dead Pass Culling ─────────────────────────────────────\r\n\r\n  /** @internal */\r\n  private _cullDeadPasses(outputs: RGHandle[]): void {\r\n    // Start with all passes marked dead\r\n    for (const pass of this._passes) {\r\n      pass.alive = false;\r\n    }\r\n\r\n    // Seed: resources that are requested outputs\r\n    const neededResources = new Set<number>();\r\n    const stack: RGResource[] = [];\r\n\r\n    for (const handle of outputs) {\r\n      const res = this._resources.get(handle._id);\r\n      if (res) {\r\n        neededResources.add(res.id);\r\n        stack.push(res);\r\n      }\r\n    }\r\n\r\n    // Seed: side-effect passes (always alive) — push their read dependencies\r\n    for (const pass of this._passes) {\r\n      if (pass.hasSideEffect) {\r\n        pass.alive = true;\r\n        for (const res of pass.reads) {\r\n          if (!neededResources.has(res.id)) {\r\n            neededResources.add(res.id);\r\n            stack.push(res);\r\n          }\r\n        }\r\n      }\r\n    }\r\n\r\n    // Backward traversal: for each needed resource, mark its producer alive\r\n    // and recursively mark the producer's read dependencies as needed\r\n    while (stack.length > 0) {\r\n      const res = stack.pop()!;\r\n      const producer = res.producer;\r\n      if (producer && !producer.alive) {\r\n        producer.alive = true;\r\n        for (const dep of producer.reads) {\r\n          if (!neededResources.has(dep.id)) {\r\n            neededResources.add(dep.id);\r\n            stack.push(dep);\r\n          }\r\n        }\r\n      }\r\n    }\r\n  }\r\n\r\n  // ─── Private: Topological Sort (Kahn's Algorithm) ───────────────────\r\n\r\n  /** @internal */\r\n  private _topologicalSort(): RGPass[] {\r\n    const alivePasses = this._passes.filter((p) => p.alive);\r\n    if (alivePasses.length === 0) {\r\n      return [];\r\n    }\r\n\r\n    // Build adjacency: producer -> consumers (only among alive passes)\r\n    const aliveSet = new Set(alivePasses);\r\n    const inDegree = new Map<RGPass, number>();\r\n    const adjacency = new Map<RGPass, RGPass[]>();\r\n\r\n    for (const pass of alivePasses) {\r\n      inDegree.set(pass, 0);\r\n      adjacency.set(pass, []);\r\n    }\r\n\r\n    // For each resource, its producer has an edge to each of its consumers\r\n    for (const res of this._resources.values()) {\r\n      if (!res.producer || !aliveSet.has(res.producer)) {\r\n        continue;\r\n      }\r\n      for (const consumer of res.consumers) {\r\n        if (!aliveSet.has(consumer)) {\r\n          continue;\r\n        }\r\n        adjacency.get(res.producer)!.push(consumer);\r\n        inDegree.set(consumer, inDegree.get(consumer)! + 1);\r\n      }\r\n    }\r\n\r\n    // Kahn's algorithm\r\n    const queue: RGPass[] = [];\r\n    for (const pass of alivePasses) {\r\n      if (inDegree.get(pass) === 0) {\r\n        queue.push(pass);\r\n      }\r\n    }\r\n\r\n    const result: RGPass[] = [];\r\n    while (queue.length > 0) {\r\n      const pass = queue.shift()!;\r\n      result.push(pass);\r\n      for (const neighbor of adjacency.get(pass)!) {\r\n        const deg = inDegree.get(neighbor)! - 1;\r\n        inDegree.set(neighbor, deg);\r\n        if (deg === 0) {\r\n          queue.push(neighbor);\r\n        }\r\n      }\r\n    }\r\n\r\n    if (result.length !== alivePasses.length) {\r\n      throw new Error(\r\n        `RenderGraph: circular dependency detected. ` +\r\n          `Sorted ${result.length} of ${alivePasses.length} alive passes.`\r\n      );\r\n    }\r\n\r\n    return result;\r\n  }\r\n\r\n  // ─── Private: Resource Lifetime Analysis ────────────────────────────\r\n\r\n  /** @internal */\r\n  private _analyzeLifetimes(orderedPasses: RGPass[]): Map<number, RGResourceLifetime> {\r\n    const lifetimes = new Map<number, RGResourceLifetime>();\r\n\r\n    // Build pass -> order index map\r\n    const orderMap = new Map<RGPass, number>();\r\n    for (let i = 0; i < orderedPasses.length; i++) {\r\n      orderMap.set(orderedPasses[i], i);\r\n    }\r\n\r\n    for (const res of this._resources.values()) {\r\n      let first = Infinity;\r\n      let last = -Infinity;\r\n\r\n      // Producer\r\n      if (res.producer && orderMap.has(res.producer)) {\r\n        const idx = orderMap.get(res.producer)!;\r\n        first = Math.min(first, idx);\r\n        last = Math.max(last, idx);\r\n      }\r\n\r\n      // Consumers\r\n      for (const consumer of res.consumers) {\r\n        if (orderMap.has(consumer)) {\r\n          const idx = orderMap.get(consumer)!;\r\n          first = Math.min(first, idx);\r\n          last = Math.max(last, idx);\r\n        }\r\n      }\r\n\r\n      if (first !== Infinity) {\r\n        lifetimes.set(res.id, { resource: res, firstUse: first, lastUse: last });\r\n      }\r\n    }\r\n\r\n    return lifetimes;\r\n  }\r\n}\r\n"],"names":["RenderGraph","_nextResourceId","_resources","Map","_passes","_compiled","importTexture","name","id","resource","RGResource","set","RGHandle","addPass","setup","pass","RGPass","length","builder","_createBuilder","data","push","compile","outputs","_cullDeadPasses","ordered","_topologicalSort","lifetimes","_analyzeLifetimes","orderedPasses","execute","compiled","noopCtx","getTexture","Error","executeFn","reset","clear","getResource","handle","get","_id","passes","resources","graph","read","res","reads","consumers","write","producer","writes","createTexture","desc","label","sideEffect","hasSideEffect","setExecute","fn","alive","neededResources","Set","stack","add","has","pop","dep","alivePasses","filter","p","aliveSet","inDegree","adjacency","values","consumer","queue","result","shift","neighbor","deg","orderMap","i","first","Infinity","last","idx","Math","min","max","firstUse","lastUse"],"mappings":";;AAYA;;;;;;;;;;;;;;;;;;;;;;;;;;AA0BC,IACM,MAAMA,WAAAA,CAAAA;qBAEX,eAAQC,GAAkB,CAAE;AAC5B,qBACQC,UAAsC,GAAA,IAAIC,GAAM,EAAA;AACxD,qBACQC,OAAoB,GAAA,EAAE;qBAE9B,SAAQC,GAAwC,IAAK;;AAIrD;;;;;;;;MASAC,aAAAA,CAAcC,IAAY,EAAY;QACpC,MAAMC,EAAAA,GAAK,IAAI,CAACP,eAAe,EAAA;AAC/B,QAAA,MAAMQ,QAAW,GAAA,IAAIC,UAAWF,CAAAA,EAAAA,EAAID,MAAM,UAAY,EAAA,IAAA,CAAA;AACtD,QAAA,IAAI,CAACL,UAAU,CAACS,GAAG,CAACH,EAAIC,EAAAA,QAAAA,CAAAA;QACxB,IAAI,CAACJ,SAAS,GAAG,IAAA;QACjB,OAAO,IAAIO,SAASJ,EAAID,EAAAA,IAAAA,CAAAA;AAC1B;AAEA;;;;;;;;;AASC,MACDM,OAAkBN,CAAAA,IAAY,EAAEO,KAAoC,EAAK;QACvE,MAAMC,IAAAA,GAAO,IAAIC,MAAO,CAAA,IAAI,CAACZ,OAAO,CAACa,MAAM,EAAEV,IAAAA,CAAAA;AAC7C,QAAA,MAAMW,OAAU,GAAA,IAAI,CAACC,cAAc,CAACJ,IAAAA,CAAAA;AACpC,QAAA,MAAMK,OAAON,KAAMI,CAAAA,OAAAA,CAAAA;AACnBH,QAAAA,IAAAA,CAAKK,IAAI,GAAGA,IAAAA;AACZ,QAAA,IAAI,CAAChB,OAAO,CAACiB,IAAI,CAACN,IAAAA,CAAAA;QAClB,IAAI,CAACV,SAAS,GAAG,IAAA;QACjB,OAAOe,IAAAA;AACT;;AAIA;;;;;;;;;MAUAE,OAAAA,CAAQC,OAAmB,EAAuB;QAChD,IAAI,IAAI,CAAClB,SAAS,EAAE;YAClB,OAAO,IAAI,CAACA,SAAS;AACvB;;QAEA,IAAI,CAACmB,eAAe,CAACD,OAAAA,CAAAA;;QAErB,MAAME,OAAAA,GAAU,IAAI,CAACC,gBAAgB,EAAA;;AAErC,QAAA,MAAMC,SAAY,GAAA,IAAI,CAACC,iBAAiB,CAACH,OAAAA,CAAAA;QAEzC,IAAI,CAACpB,SAAS,GAAG;YAAEwB,aAAeJ,EAAAA,OAAAA;AAASE,YAAAA;AAAU,SAAA;QACrD,OAAO,IAAI,CAACtB,SAAS;AACvB;AAEA;;;;;;MAOAyB,OAAAA,CAAQC,QAA6B,EAAQ;AAC3C,QAAA,MAAMC,OAA4B,GAAA;AAChCC,YAAAA,UAAAA,CAAAA,GAAAA;AACE,gBAAA,MAAM,IAAIC,KACR,CAAA,0GAAA,CAAA;AAEJ;AACF,SAAA;AACA,QAAA,KAAK,MAAMnB,IAAAA,IAAQgB,QAASF,CAAAA,aAAa,CAAE;YACzC,IAAId,IAAAA,CAAKoB,SAAS,EAAE;AACjBpB,gBAAAA,IAAAA,CAAKoB,SAAS,CAA0BH,OAASjB,EAAAA,IAAAA,CAAKK,IAAI,CAAA;AAC7D;AACF;AACF;AAEA;;;;;AAKC,MACDgB,KAAc,GAAA;AACZ,QAAA,IAAI,CAAChC,OAAO,CAACa,MAAM,GAAG,CAAA;QACtB,IAAI,CAACf,UAAU,CAACmC,KAAK,EAAA;QACrB,IAAI,CAACpC,eAAe,GAAG,CAAA;QACvB,IAAI,CAACI,SAAS,GAAG,IAAA;AACnB;;qBAKAiC,WAAYC,CAAAA,MAAgB,EAA0B;AACpD,QAAA,OAAO,IAAI,CAACrC,UAAU,CAACsC,GAAG,CAACD,OAAOE,GAAG,CAAA;AACvC;qBAGA,IAAIC,MAAgC,GAAA;QAClC,OAAO,IAAI,CAACtC,OAAO;AACrB;qBAGA,IAAIuC,SAA6C,GAAA;QAC/C,OAAO,IAAI,CAACzC,UAAU;AACxB;;AAIA,qBACQiB,cAAeJ,CAAAA,IAAY,EAAiB;AAClD,QAAA,MAAM6B,QAAQ,IAAI;QAClB,OAAO;AACLC,YAAAA,IAAAA,CAAAA,CAAKN,MAAgB,EAAA;AACnB,gBAAA,MAAMO,MAAMF,KAAM1C,CAAAA,UAAU,CAACsC,GAAG,CAACD,OAAOE,GAAG,CAAA;AAC3C,gBAAA,IAAI,CAACK,GAAK,EAAA;AACR,oBAAA,MAAM,IAAIZ,KAAAA,CAAM,CAAC,+BAA+B,EAAEK,MAAOhC,CAAAA,IAAI,CAAC,MAAM,EAAEgC,MAAAA,CAAOE,GAAG,CAAC,CAAC,CAAC,CAAA;AACrF;gBACA1B,IAAKgC,CAAAA,KAAK,CAAC1B,IAAI,CAACyB,GAAAA,CAAAA;gBAChBA,GAAIE,CAAAA,SAAS,CAAC3B,IAAI,CAACN,IAAAA,CAAAA;AACrB,aAAA;AACAkC,YAAAA,KAAAA,CAAAA,CAAMV,MAAgB,EAAA;AACpB,gBAAA,MAAMO,MAAMF,KAAM1C,CAAAA,UAAU,CAACsC,GAAG,CAACD,OAAOE,GAAG,CAAA;AAC3C,gBAAA,IAAI,CAACK,GAAK,EAAA;AACR,oBAAA,MAAM,IAAIZ,KAAAA,CAAM,CAAC,+BAA+B,EAAEK,MAAOhC,CAAAA,IAAI,CAAC,MAAM,EAAEgC,MAAAA,CAAOE,GAAG,CAAC,CAAC,CAAC,CAAA;AACrF;AACA,gBAAA,IAAIK,IAAII,QAAQ,IAAIJ,GAAII,CAAAA,QAAQ,KAAKnC,IAAM,EAAA;oBACzC,MAAM,IAAImB,KACR,CAAA,CAAC,uBAAuB,EAAEY,IAAIvC,IAAI,CAAC,4BAA4B,EAAEuC,GAAII,CAAAA,QAAQ,CAAC3C,IAAI,CAAC,GAAG,CAAC,GACrF,CAAC,2BAA2B,EAAEQ,IAAKR,CAAAA,IAAI,CAAC,CAAC,CAAC,CAAA;AAEhD;AACAuC,gBAAAA,GAAAA,CAAII,QAAQ,GAAGnC,IAAAA;gBACfA,IAAKoC,CAAAA,MAAM,CAAC9B,IAAI,CAACyB,GAAAA,CAAAA;AACnB,aAAA;AACAM,YAAAA,aAAAA,CAAAA,CAAcC,IAAmB,EAAA;gBAC/B,MAAM7C,EAAAA,GAAKoC,MAAM3C,eAAe,EAAA;AAChC,gBAAA,MAAMM,OAAO8C,IAAKC,CAAAA,KAAK,IAAI,CAAC,KAAK,EAAE9C,EAAI,CAAA,CAAA;AACvC,gBAAA,MAAMsC,GAAM,GAAA,IAAIpC,UAAWF,CAAAA,EAAAA,EAAID,MAAM,WAAa8C,EAAAA,IAAAA,CAAAA;AAClDP,gBAAAA,GAAAA,CAAII,QAAQ,GAAGnC,IAAAA;AACf6B,gBAAAA,KAAAA,CAAM1C,UAAU,CAACS,GAAG,CAACH,EAAIsC,EAAAA,GAAAA,CAAAA;gBACzB/B,IAAKoC,CAAAA,MAAM,CAAC9B,IAAI,CAACyB,GAAAA,CAAAA;gBACjB,OAAO,IAAIlC,SAASJ,EAAID,EAAAA,IAAAA,CAAAA;AAC1B,aAAA;AACAgD,YAAAA,UAAAA,CAAAA,GAAAA;AACExC,gBAAAA,IAAAA,CAAKyC,aAAa,GAAG,IAAA;AACvB,aAAA;AACAC,YAAAA,UAAAA,CAAAA,CAAcC,EAAkB,EAAA;AAC9B3C,gBAAAA,IAAAA,CAAKoB,SAAS,GAAGuB,EAAAA;AACnB;AACF,SAAA;AACF;;AAIA,qBACQlC,eAAgBD,CAAAA,OAAmB,EAAQ;;AAEjD,QAAA,KAAK,MAAMR,IAAAA,IAAQ,IAAI,CAACX,OAAO,CAAE;AAC/BW,YAAAA,IAAAA,CAAK4C,KAAK,GAAG,KAAA;AACf;;AAGA,QAAA,MAAMC,kBAAkB,IAAIC,GAAAA,EAAAA;AAC5B,QAAA,MAAMC,QAAsB,EAAE;QAE9B,KAAK,MAAMvB,UAAUhB,OAAS,CAAA;YAC5B,MAAMuB,GAAAA,GAAM,IAAI,CAAC5C,UAAU,CAACsC,GAAG,CAACD,OAAOE,GAAG,CAAA;AAC1C,YAAA,IAAIK,GAAK,EAAA;gBACPc,eAAgBG,CAAAA,GAAG,CAACjB,GAAAA,CAAItC,EAAE,CAAA;AAC1BsD,gBAAAA,KAAAA,CAAMzC,IAAI,CAACyB,GAAAA,CAAAA;AACb;AACF;;AAGA,QAAA,KAAK,MAAM/B,IAAAA,IAAQ,IAAI,CAACX,OAAO,CAAE;YAC/B,IAAIW,IAAAA,CAAKyC,aAAa,EAAE;AACtBzC,gBAAAA,IAAAA,CAAK4C,KAAK,GAAG,IAAA;AACb,gBAAA,KAAK,MAAMb,GAAAA,IAAO/B,IAAKgC,CAAAA,KAAK,CAAE;AAC5B,oBAAA,IAAI,CAACa,eAAgBI,CAAAA,GAAG,CAAClB,GAAAA,CAAItC,EAAE,CAAG,EAAA;wBAChCoD,eAAgBG,CAAAA,GAAG,CAACjB,GAAAA,CAAItC,EAAE,CAAA;AAC1BsD,wBAAAA,KAAAA,CAAMzC,IAAI,CAACyB,GAAAA,CAAAA;AACb;AACF;AACF;AACF;;;QAIA,MAAOgB,KAAAA,CAAM7C,MAAM,GAAG,CAAG,CAAA;YACvB,MAAM6B,GAAAA,GAAMgB,MAAMG,GAAG,EAAA;YACrB,MAAMf,QAAAA,GAAWJ,IAAII,QAAQ;AAC7B,YAAA,IAAIA,QAAY,IAAA,CAACA,QAASS,CAAAA,KAAK,EAAE;AAC/BT,gBAAAA,QAAAA,CAASS,KAAK,GAAG,IAAA;AACjB,gBAAA,KAAK,MAAMO,GAAAA,IAAOhB,QAASH,CAAAA,KAAK,CAAE;AAChC,oBAAA,IAAI,CAACa,eAAgBI,CAAAA,GAAG,CAACE,GAAAA,CAAI1D,EAAE,CAAG,EAAA;wBAChCoD,eAAgBG,CAAAA,GAAG,CAACG,GAAAA,CAAI1D,EAAE,CAAA;AAC1BsD,wBAAAA,KAAAA,CAAMzC,IAAI,CAAC6C,GAAAA,CAAAA;AACb;AACF;AACF;AACF;AACF;;qBAKA,gBAAqC,GAAA;QACnC,MAAMC,WAAAA,GAAc,IAAI,CAAC/D,OAAO,CAACgE,MAAM,CAAC,CAACC,CAAMA,GAAAA,CAAAA,CAAEV,KAAK,CAAA;QACtD,IAAIQ,WAAAA,CAAYlD,MAAM,KAAK,CAAG,EAAA;AAC5B,YAAA,OAAO,EAAE;AACX;;QAGA,MAAMqD,QAAAA,GAAW,IAAIT,GAAIM,CAAAA,WAAAA,CAAAA;AACzB,QAAA,MAAMI,WAAW,IAAIpE,GAAAA,EAAAA;AACrB,QAAA,MAAMqE,YAAY,IAAIrE,GAAAA,EAAAA;QAEtB,KAAK,MAAMY,QAAQoD,WAAa,CAAA;YAC9BI,QAAS5D,CAAAA,GAAG,CAACI,IAAM,EAAA,CAAA,CAAA;YACnByD,SAAU7D,CAAAA,GAAG,CAACI,IAAAA,EAAM,EAAE,CAAA;AACxB;;AAGA,QAAA,KAAK,MAAM+B,GAAO,IAAA,IAAI,CAAC5C,UAAU,CAACuE,MAAM,EAAI,CAAA;YAC1C,IAAI,CAAC3B,GAAII,CAAAA,QAAQ,IAAI,CAACoB,SAASN,GAAG,CAAClB,GAAII,CAAAA,QAAQ,CAAG,EAAA;AAChD,gBAAA;AACF;AACA,YAAA,KAAK,MAAMwB,QAAAA,IAAY5B,GAAIE,CAAAA,SAAS,CAAE;AACpC,gBAAA,IAAI,CAACsB,QAAAA,CAASN,GAAG,CAACU,QAAW,CAAA,EAAA;AAC3B,oBAAA;AACF;AACAF,gBAAAA,SAAAA,CAAUhC,GAAG,CAACM,GAAAA,CAAII,QAAQ,CAAA,CAAG7B,IAAI,CAACqD,QAAAA,CAAAA;AAClCH,gBAAAA,QAAAA,CAAS5D,GAAG,CAAC+D,QAAAA,EAAUH,QAAS/B,CAAAA,GAAG,CAACkC,QAAa,CAAA,GAAA,CAAA,CAAA;AACnD;AACF;;AAGA,QAAA,MAAMC,QAAkB,EAAE;QAC1B,KAAK,MAAM5D,QAAQoD,WAAa,CAAA;AAC9B,YAAA,IAAII,QAAS/B,CAAAA,GAAG,CAACzB,IAAAA,CAAAA,KAAU,CAAG,EAAA;AAC5B4D,gBAAAA,KAAAA,CAAMtD,IAAI,CAACN,IAAAA,CAAAA;AACb;AACF;AAEA,QAAA,MAAM6D,SAAmB,EAAE;QAC3B,MAAOD,KAAAA,CAAM1D,MAAM,GAAG,CAAG,CAAA;YACvB,MAAMF,IAAAA,GAAO4D,MAAME,KAAK,EAAA;AACxBD,YAAAA,MAAAA,CAAOvD,IAAI,CAACN,IAAAA,CAAAA;AACZ,YAAA,KAAK,MAAM+D,QAAAA,IAAYN,SAAUhC,CAAAA,GAAG,CAACzB,IAAQ,CAAA,CAAA;AAC3C,gBAAA,MAAMgE,GAAMR,GAAAA,QAAAA,CAAS/B,GAAG,CAACsC,QAAa,CAAA,GAAA,CAAA;gBACtCP,QAAS5D,CAAAA,GAAG,CAACmE,QAAUC,EAAAA,GAAAA,CAAAA;AACvB,gBAAA,IAAIA,QAAQ,CAAG,EAAA;AACbJ,oBAAAA,KAAAA,CAAMtD,IAAI,CAACyD,QAAAA,CAAAA;AACb;AACF;AACF;AAEA,QAAA,IAAIF,MAAO3D,CAAAA,MAAM,KAAKkD,WAAAA,CAAYlD,MAAM,EAAE;AACxC,YAAA,MAAM,IAAIiB,KACR,CAAA,CAAC,2CAA2C,CAAC,GAC3C,CAAC,OAAO,EAAE0C,MAAO3D,CAAAA,MAAM,CAAC,IAAI,EAAEkD,YAAYlD,MAAM,CAAC,cAAc,CAAC,CAAA;AAEtE;QAEA,OAAO2D,MAAAA;AACT;;AAIA,qBACQhD,iBAAkBC,CAAAA,aAAuB,EAAmC;AAClF,QAAA,MAAMF,YAAY,IAAIxB,GAAAA,EAAAA;;AAGtB,QAAA,MAAM6E,WAAW,IAAI7E,GAAAA,EAAAA;AACrB,QAAA,IAAK,IAAI8E,CAAI,GAAA,CAAA,EAAGA,IAAIpD,aAAcZ,CAAAA,MAAM,EAAEgE,CAAK,EAAA,CAAA;AAC7CD,YAAAA,QAAAA,CAASrE,GAAG,CAACkB,aAAa,CAACoD,EAAE,EAAEA,CAAAA,CAAAA;AACjC;AAEA,QAAA,KAAK,MAAMnC,GAAO,IAAA,IAAI,CAAC5C,UAAU,CAACuE,MAAM,EAAI,CAAA;AAC1C,YAAA,IAAIS,KAAQC,GAAAA,QAAAA;AACZ,YAAA,IAAIC,OAAO,CAACD,QAAAA;;YAGZ,IAAIrC,GAAAA,CAAII,QAAQ,IAAI8B,QAAAA,CAAShB,GAAG,CAAClB,GAAAA,CAAII,QAAQ,CAAG,EAAA;AAC9C,gBAAA,MAAMmC,GAAML,GAAAA,QAAAA,CAASxC,GAAG,CAACM,IAAII,QAAQ,CAAA;gBACrCgC,KAAQI,GAAAA,IAAAA,CAAKC,GAAG,CAACL,KAAOG,EAAAA,GAAAA,CAAAA;gBACxBD,IAAOE,GAAAA,IAAAA,CAAKE,GAAG,CAACJ,IAAMC,EAAAA,GAAAA,CAAAA;AACxB;;AAGA,YAAA,KAAK,MAAMX,QAAAA,IAAY5B,GAAIE,CAAAA,SAAS,CAAE;gBACpC,IAAIgC,QAAAA,CAAShB,GAAG,CAACU,QAAW,CAAA,EAAA;oBAC1B,MAAMW,GAAAA,GAAML,QAASxC,CAAAA,GAAG,CAACkC,QAAAA,CAAAA;oBACzBQ,KAAQI,GAAAA,IAAAA,CAAKC,GAAG,CAACL,KAAOG,EAAAA,GAAAA,CAAAA;oBACxBD,IAAOE,GAAAA,IAAAA,CAAKE,GAAG,CAACJ,IAAMC,EAAAA,GAAAA,CAAAA;AACxB;AACF;AAEA,YAAA,IAAIH,UAAUC,QAAU,EAAA;AACtBxD,gBAAAA,SAAAA,CAAUhB,GAAG,CAACmC,GAAItC,CAAAA,EAAE,EAAE;oBAAEC,QAAUqC,EAAAA,GAAAA;oBAAK2C,QAAUP,EAAAA,KAAAA;oBAAOQ,OAASN,EAAAA;AAAK,iBAAA,CAAA;AACxE;AACF;QAEA,OAAOzD,SAAAA;AACT;AACF;;;;"}

package/dist/render/rendergraph/types.js

@@ -0,0 +1,57 @@
+// ─── Handles ────────────────────────────────────────────────────────────
+/**
+ * Opaque handle referencing a resource within the render graph.
+ *
+ * Handles are obtained from {@link RGPassBuilder.createTexture}, {@link RenderGraph.importTexture},
+ * or {@link RGPassBuilder.write}. They are lightweight identifiers used to declare
+ * dependencies between passes.
+ *
+ * @public
+ */ class RGHandle {
+    /** @internal */ _id;
+    /** @internal */ _name;
+    /** @internal */ constructor(id, name){
+        this._id = id;
+        this._name = name;
+    }
+    /** Debug-friendly name of the referenced resource. */ get name() {
+        return this._name;
+    }
+}
+/**
+ * Internal bookkeeping for a resource within the render graph.
+ * @internal
+ */ class RGResource {
+    id;
+    name;
+    kind;
+    desc;
+    /** The pass that creates / writes this resource (null for imported until written). */ producer = null;
+    /** Passes that read this resource. */ consumers = [];
+    constructor(id, name, kind, desc){
+        this.id = id;
+        this.name = name;
+        this.kind = kind;
+        this.desc = desc;
+    }
+}
+/**
+ * Internal bookkeeping for a pass within the render graph.
+ * @internal
+ */ class RGPass {
+    index;
+    name;
+    /** Resources this pass reads (dependencies). */ reads = [];
+    /** Resources this pass creates or writes. */ writes = [];
+    /** Whether this pass has side effects and must not be culled. */ hasSideEffect = false;
+    /** User data returned from the setup function. */ data = null;
+    /** Execute callback. */ executeFn = null;
+    /** Set during compilation: true if this pass is needed. */ alive = true;
+    constructor(index, name){
+        this.index = index;
+        this.name = name;
+    }
+}
+
+export { RGHandle, RGPass, RGResource };
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"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 RenderGraph.importTexture},\r\n * or {@link RGPassBuilder.write}. They are lightweight identifiers used to declare\r\n * 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/** @internal */\r\nexport type RGResourceKind = 'transient' | 'imported';\r\n\r\n/**\r\n * Internal bookkeeping for a resource within the render graph.\r\n * @internal\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 | null;\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(id: number, name: string, kind: RGResourceKind, desc: RGTextureDesc | null) {\r\n    this.id = id;\r\n    this.name = name;\r\n    this.kind = kind;\r\n    this.desc = desc;\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}.\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/**\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 * Internal bookkeeping for a pass within the render graph.\r\n * @internal\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  /** 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  /** 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 to an existing resource (typically an imported resource).\r\n   *\r\n   * @param handle - Handle of the resource to write to.\r\n   */\r\n  write(handle: RGHandle): void;\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   * 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   * Set the execution callback for this pass.\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 * 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 {@link allocate} before a resource's first use and\r\n * {@link 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> {\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"],"names":["RGHandle","id","name","_id","_name","RGResource","kind","desc","producer","consumers","RGPass","index","reads","writes","hasSideEffect","data","executeFn","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,IAA2B;2FAEpCC,WAA0B,IAAK;AAC/B,2CACSC,SAAsB,GAAA,EAAE;AAEjC,IAAA,WAAA,CAAYR,EAAU,EAAEC,IAAY,EAAEI,IAAoB,EAAEC,IAA0B,CAAE;QACtF,IAAI,CAACN,EAAE,GAAGA,EAAAA;QACV,IAAI,CAACC,IAAI,GAAGA,IAAAA;QACZ,IAAI,CAACI,IAAI,GAAGA,IAAAA;QACZ,IAAI,CAACC,IAAI,GAAGA,IAAAA;AACd;AACF;AAqCA;;;AAGC,IACM,MAAMG,MAAAA,CAAAA;IACFC,KAAc;IACdT,IAAa;AACtB,qDACSU,KAAsB,GAAA,EAAE;AACjC,kDACSC,MAAuB,GAAA,EAAE;sEAElCC,gBAAgB,KAAM;uDAEtBC,OAAiB,IAAK;6BAEtBC,YAAmC,IAAK;gEAExCC,QAAQ,IAAK;IAEb,WAAYN,CAAAA,KAAa,EAAET,IAAY,CAAE;QACvC,IAAI,CAACS,KAAK,GAAGA,KAAAA;QACb,IAAI,CAACT,IAAI,GAAGA,IAAAA;AACd;AACF;;;;"}

package/dist/render/sky_motion_vector.js

@@ -0,0 +1,85 @@
+import { AbstractPostEffect } from '../posteffect/posteffect.js';
+import '@zephyr3d/base';
+import './primitive.js';
+import { BoxShape } from '../shapes/box.js';
+import '../shapes/cylinder.js';
+import '../shapes/torus.js';
+import '../shapes/plane.js';
+import '../shapes/sphere.js';
+import '../shapes/tetrahedron.js';
+
+let _skyMotionVectorProgram = null;
+let _skyMotionVectorBindGroup = null;
+let _box = null;
+function getSkyMotionVectorProgram(ctx) {
+    if (!_skyMotionVectorProgram) {
+        _skyMotionVectorProgram = ctx.device.buildRenderProgram({
+            vertex (pb) {
+                this.$inputs.pos = pb.vec3().attrib('position');
+                this.VPMatrix = pb.mat4().uniform(0);
+                this.prevVPMatrix = pb.mat4().uniform(0);
+                this.cameraPos = pb.vec3().uniform(0);
+                this.prevCameraPos = pb.vec3().uniform(0);
+                pb.main(function() {
+                    this.$l.worldPos = pb.add(this.$inputs.pos, this.cameraPos);
+                    this.$l.prevWorldPos = pb.add(this.$inputs.pos, this.prevCameraPos);
+                    this.$l.clipPos = pb.mul(this.VPMatrix, pb.vec4(this.worldPos, 1));
+                    this.$l.prevClipPos = pb.mul(this.prevVPMatrix, pb.vec4(this.prevWorldPos, 1));
+                    this.clipPos.z = this.clipPos.w;
+                    this.$builtins.position = this.clipPos;
+                    this.$outputs.currentPos = this.clipPos;
+                    this.$outputs.prevPos = this.prevClipPos;
+                });
+            },
+            fragment (pb) {
+                this.$outputs.color = pb.vec4();
+                pb.main(function() {
+                    this.$l.motionVector = pb.mul(pb.sub(pb.div(this.$inputs.currentPos.xy, this.$inputs.currentPos.w), pb.div(this.$inputs.prevPos.xy, this.$inputs.prevPos.w)), 0.5);
+                    this.$outputs.color = pb.vec4(this.motionVector, 0, 1);
+                });
+            }
+        });
+        _skyMotionVectorProgram.name = '@TAA_SkyMotionVector';
+    }
+    return _skyMotionVectorProgram;
+}
+function getBox() {
+    if (!_box) {
+        _box = new BoxShape({
+            size: 2,
+            needNormal: false,
+            needUV: false
+        });
+    }
+    return _box;
+}
+/**
+ * Renders sky motion vectors into ctx.motionVectorTexture.
+ * Must be called after opaque pass with ctx.motionVectorTexture set.
+ * @internal
+ */ function renderSkyMotionVectors(ctx) {
+    if (!ctx.motionVectorTexture) {
+        return;
+    }
+    const fb = ctx.device.pool.fetchTemporalFramebuffer(false, 0, 0, ctx.motionVectorTexture, ctx.depthTexture);
+    const program = getSkyMotionVectorProgram(ctx);
+    if (!_skyMotionVectorBindGroup) {
+        _skyMotionVectorBindGroup = ctx.device.createBindGroup(program.bindGroupLayouts[0]);
+    }
+    const box = getBox();
+    _skyMotionVectorBindGroup.setValue('VPMatrix', ctx.camera.viewProjectionMatrix);
+    _skyMotionVectorBindGroup.setValue('prevVPMatrix', ctx.camera.prevVPMatrix);
+    _skyMotionVectorBindGroup.setValue('cameraPos', ctx.camera.getWorldPosition());
+    _skyMotionVectorBindGroup.setValue('prevCameraPos', ctx.camera.prevPosition);
+    ctx.device.pushDeviceStates();
+    ctx.device.setProgram(program);
+    ctx.device.setBindGroup(0, _skyMotionVectorBindGroup);
+    ctx.device.setRenderStates(AbstractPostEffect.getDefaultRenderState(ctx, 'le'));
+    ctx.device.setFramebuffer(fb);
+    box.draw();
+    ctx.device.popDeviceStates();
+    ctx.device.pool.releaseFrameBuffer(fb);
+}
+
+export { renderSkyMotionVectors };
+//# sourceMappingURL=sky_motion_vector.js.map

package/dist/render/sky_motion_vector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sky_motion_vector.js","sources":["../../src/render/sky_motion_vector.ts"],"sourcesContent":["import type { BindGroup, GPUProgram } from '@zephyr3d/device';\nimport type { Nullable } from '@zephyr3d/base';\nimport { AbstractPostEffect } from '../posteffect/posteffect';\nimport { BoxShape } from '../shapes';\nimport type { DrawContext } from './drawable';\nimport type { Primitive } from '.';\n\nlet _skyMotionVectorProgram: Nullable<GPUProgram> = null;\nlet _skyMotionVectorBindGroup: Nullable<BindGroup> = null;\nlet _box: Nullable<Primitive> = null;\n\nfunction getSkyMotionVectorProgram(ctx: DrawContext): GPUProgram {\n  if (!_skyMotionVectorProgram) {\n    _skyMotionVectorProgram = ctx.device.buildRenderProgram({\n      vertex(pb) {\n        this.$inputs.pos = pb.vec3().attrib('position');\n        this.VPMatrix = pb.mat4().uniform(0);\n        this.prevVPMatrix = pb.mat4().uniform(0);\n        this.cameraPos = pb.vec3().uniform(0);\n        this.prevCameraPos = pb.vec3().uniform(0);\n        pb.main(function () {\n          this.$l.worldPos = pb.add(this.$inputs.pos, this.cameraPos);\n          this.$l.prevWorldPos = pb.add(this.$inputs.pos, this.prevCameraPos);\n          this.$l.clipPos = pb.mul(this.VPMatrix, pb.vec4(this.worldPos, 1));\n          this.$l.prevClipPos = pb.mul(this.prevVPMatrix, pb.vec4(this.prevWorldPos, 1));\n          this.clipPos.z = this.clipPos.w;\n          this.$builtins.position = this.clipPos;\n          this.$outputs.currentPos = this.clipPos;\n          this.$outputs.prevPos = this.prevClipPos;\n        });\n      },\n      fragment(pb) {\n        this.$outputs.color = pb.vec4();\n        pb.main(function () {\n          this.$l.motionVector = pb.mul(\n            pb.sub(\n              pb.div(this.$inputs.currentPos.xy, this.$inputs.currentPos.w),\n              pb.div(this.$inputs.prevPos.xy, this.$inputs.prevPos.w)\n            ),\n            0.5\n          );\n          this.$outputs.color = pb.vec4(this.motionVector, 0, 1);\n        });\n      }\n    })!;\n    _skyMotionVectorProgram.name = '@TAA_SkyMotionVector';\n  }\n  return _skyMotionVectorProgram;\n}\n\nfunction getBox(): Primitive {\n  if (!_box) {\n    _box = new BoxShape({ size: 2, needNormal: false, needUV: false });\n  }\n  return _box;\n}\n\n/**\n * Renders sky motion vectors into ctx.motionVectorTexture.\n * Must be called after opaque pass with ctx.motionVectorTexture set.\n * @internal\n */\nexport function renderSkyMotionVectors(ctx: DrawContext): void {\n  if (!ctx.motionVectorTexture) {\n    return;\n  }\n  const fb = ctx.device.pool.fetchTemporalFramebuffer(false, 0, 0, ctx.motionVectorTexture, ctx.depthTexture);\n  const program = getSkyMotionVectorProgram(ctx);\n  if (!_skyMotionVectorBindGroup) {\n    _skyMotionVectorBindGroup = ctx.device.createBindGroup(program.bindGroupLayouts[0]);\n  }\n  const box = getBox();\n  _skyMotionVectorBindGroup.setValue('VPMatrix', ctx.camera.viewProjectionMatrix);\n  _skyMotionVectorBindGroup.setValue('prevVPMatrix', ctx.camera.prevVPMatrix!);\n  _skyMotionVectorBindGroup.setValue('cameraPos', ctx.camera.getWorldPosition());\n  _skyMotionVectorBindGroup.setValue('prevCameraPos', ctx.camera.prevPosition!);\n  ctx.device.pushDeviceStates();\n  ctx.device.setProgram(program);\n  ctx.device.setBindGroup(0, _skyMotionVectorBindGroup);\n  ctx.device.setRenderStates(AbstractPostEffect.getDefaultRenderState(ctx, 'le'));\n  ctx.device.setFramebuffer(fb);\n  box.draw();\n  ctx.device.popDeviceStates();\n  ctx.device.pool.releaseFrameBuffer(fb);\n}\n"],"names":["_skyMotionVectorProgram","_skyMotionVectorBindGroup","_box","getSkyMotionVectorProgram","ctx","device","buildRenderProgram","vertex","pb","$inputs","pos","vec3","attrib","VPMatrix","mat4","uniform","prevVPMatrix","cameraPos","prevCameraPos","main","$l","worldPos","add","prevWorldPos","clipPos","mul","vec4","prevClipPos","z","w","$builtins","position","$outputs","currentPos","prevPos","fragment","color","motionVector","sub","div","xy","name","getBox","BoxShape","size","needNormal","needUV","renderSkyMotionVectors","motionVectorTexture","fb","pool","fetchTemporalFramebuffer","depthTexture","program","createBindGroup","bindGroupLayouts","box","setValue","camera","viewProjectionMatrix","getWorldPosition","prevPosition","pushDeviceStates","setProgram","setBindGroup","setRenderStates","AbstractPostEffect","getDefaultRenderState","setFramebuffer","draw","popDeviceStates","releaseFrameBuffer"],"mappings":"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"}

package/dist/scene/mesh.js

@@ -308,10 +308,12 @@ import { mixinDrawable } from '../render/drawable_mixin.js';
    * @param weight - The weight of the morph target
    */ setMorphWeight(name, weight) {
         const index = this._morphInfo?.names?.[name];
-        if (index !== undefined && index >= 0 && index < this._morphInfo.data[3] && this._morphInfo.data[4 + index] !== weight) {
-            this._morphInfo.data[4 + index] = weight;
-            this._morphDirty = true;
-            this.scene.queueUpdateNode(this);
+        if (index !== undefined && index >= 0 && index < this._morphInfo.data[3]) {
+            if (this._morphInfo.data[4 + index] !== weight) {
+                this._morphInfo.data[4 + index] = weight;
+                this._morphDirty = true;
+                this.scene.queueUpdateNode(this);
+            }
         } else {
             console.warn(`Morph target ${name} not found`);
         }
@@ -371,34 +373,24 @@ import { mixinDrawable } from '../render/drawable_mixin.js';
     }
     /** @internal */ updateMorphState() {
         if (this._morphInfo && this._morphDirty) {
+            console.log(`jawOpen: ${this._morphInfo.data[20]}`);
             this._morphInfo.buffer.get().bufferSubData(4 * 4, this._morphInfo.data, 4, this._morphInfo.data[3]);
             this._morphDirty = false;
         }
     }
     /** @internal */ updateSkeletonState() {
-        if (this._skeletonName) {
-            const skeleton = this.findSkeletonById(this._skeletonName);
-            if (skeleton?.playing) {
-                this.setBoneMatrices(skeleton.jointTexture);
-                skeleton.computeBoundingBox(this._skinnedBoundingInfo, this.invWorldMatrix);
-                this.setAnimatedBoundingBox(this._skinnedBoundingInfo.boundingBox);
-            } else if (skeleton) {
-                const prefab = this.getPrefabNode();
-                if (prefab) {
-                    skeleton.computeBindPose(prefab);
-                    this.setBoneMatrices(skeleton.jointTexture);
-                    skeleton.computeBoundingBox(this._skinnedBoundingInfo, this.invWorldMatrix);
-                    this.setAnimatedBoundingBox(this._skinnedBoundingInfo.boundingBox);
-                }
-            } else {
-                this.setBoneMatrices(null);
-                this.setAnimatedBoundingBox(null);
-            }
-            this.scene.queueUpdateNode(this);
+        const skeleton = this._skeletonName && this.findSkeletonById(this._skeletonName);
+        if (skeleton) {
+            this.setBoneMatrices(skeleton.jointTexture);
+            skeleton.computeBoundingBox(this._skinnedBoundingInfo, this.invWorldMatrix);
+            this.setAnimatedBoundingBox(this._skinnedBoundingInfo.boundingBox);
         } else {
             this.setBoneMatrices(null);
             this.setAnimatedBoundingBox(null);
         }
+        if (this._skeletonName) {
+            this.scene.queueUpdateNode(this);
+        }
     }
     /**
    * {@inheritDoc Drawable.draw}