@zephyr3d/scene 0.9.25 → 0.9.27

package/dist/render/rendergraph/frame_resource_requirements.js

@@ -4,6 +4,7 @@
     }
     target.motionVector = !!target.motionVector || !!source.motionVector;
     target.hiZ = !!target.hiZ || !!source.hiZ;
+    target.hiZNearest = !!target.hiZNearest || !!source.hiZNearest;
     target.sceneNormal = !!target.sceneNormal || !!source.sceneNormal;
     target.sceneRoughness = !!target.sceneRoughness || !!source.sceneRoughness;
     target.shadowMask = !!target.shadowMask || !!source.shadowMask;

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

@@ -1 +1 @@
-{"version":3,"file":"frame_resource_requirements.js","sources":["../../../src/render/rendergraph/frame_resource_requirements.ts"],"sourcesContent":["/** Frame resources requested before Forward+ module setup. @public */\r\nexport interface FrameResourceRequirements {\r\n  motionVector?: boolean;\r\n  hiZ?: boolean;\r\n  sceneNormal?: boolean;\r\n  sceneRoughness?: boolean;\r\n  shadowMask?: boolean;\r\n}\r\n\r\n/** Merge frame-resource requirements using monotonic OR semantics. @public */\r\nexport function mergeFrameResourceRequirements(\r\n  target: FrameResourceRequirements,\r\n  source: FrameResourceRequirements | null | undefined\r\n): FrameResourceRequirements {\r\n  if (!source) {\r\n    return target;\r\n  }\r\n  target.motionVector = !!target.motionVector || !!source.motionVector;\r\n  target.hiZ = !!target.hiZ || !!source.hiZ;\r\n  target.sceneNormal = !!target.sceneNormal || !!source.sceneNormal;\r\n  target.sceneRoughness = !!target.sceneRoughness || !!source.sceneRoughness;\r\n  target.shadowMask = !!target.shadowMask || !!source.shadowMask;\r\n  return target;\r\n}\r\n"],"names":["mergeFrameResourceRequirements","target","source","motionVector","hiZ","sceneNormal","sceneRoughness","shadowMask"],"mappings":"AAAA,sJAUO,SAASA,8BACdC,CAAAA,MAAiC,EACjCC,MAAoD,EAAA;AAEpD,IAAA,IAAI,CAACA,MAAQ,EAAA;QACX,OAAOD,MAAAA;AACT;IACAA,MAAOE,CAAAA,YAAY,GAAG,CAAC,CAACF,MAAAA,CAAOE,YAAY,IAAI,CAAC,CAACD,MAAAA,CAAOC,YAAY;IACpEF,MAAOG,CAAAA,GAAG,GAAG,CAAC,CAACH,MAAAA,CAAOG,GAAG,IAAI,CAAC,CAACF,MAAAA,CAAOE,GAAG;IACzCH,MAAOI,CAAAA,WAAW,GAAG,CAAC,CAACJ,MAAAA,CAAOI,WAAW,IAAI,CAAC,CAACH,MAAAA,CAAOG,WAAW;IACjEJ,MAAOK,CAAAA,cAAc,GAAG,CAAC,CAACL,MAAAA,CAAOK,cAAc,IAAI,CAAC,CAACJ,MAAAA,CAAOI,cAAc;IAC1EL,MAAOM,CAAAA,UAAU,GAAG,CAAC,CAACN,MAAAA,CAAOM,UAAU,IAAI,CAAC,CAACL,MAAAA,CAAOK,UAAU;IAC9D,OAAON,MAAAA;AACT;;;;"}
+{"version":3,"file":"frame_resource_requirements.js","sources":["../../../src/render/rendergraph/frame_resource_requirements.ts"],"sourcesContent":["/** Frame resources requested before Forward+ module setup. @public */\r\nexport interface FrameResourceRequirements {\r\n  motionVector?: boolean;\r\n  hiZ?: boolean;\r\n  /**\r\n   * The Hi-Z pyramid's nearest-depth channel, for proximity queries.\r\n   *\r\n   * Implies {@link FrameResourceRequirements.hiZ} - it is a second channel of\r\n   * the same pyramid, not a separate resource - and costs that pyramid's\r\n   * bandwidth twice over, so it is requested separately from it.\r\n   */\r\n  hiZNearest?: boolean;\r\n  sceneNormal?: boolean;\r\n  sceneRoughness?: boolean;\r\n  shadowMask?: boolean;\r\n}\r\n\r\n/** Merge frame-resource requirements using monotonic OR semantics. @public */\r\nexport function mergeFrameResourceRequirements(\r\n  target: FrameResourceRequirements,\r\n  source: FrameResourceRequirements | null | undefined\r\n): FrameResourceRequirements {\r\n  if (!source) {\r\n    return target;\r\n  }\r\n  target.motionVector = !!target.motionVector || !!source.motionVector;\r\n  target.hiZ = !!target.hiZ || !!source.hiZ;\r\n  target.hiZNearest = !!target.hiZNearest || !!source.hiZNearest;\r\n  target.sceneNormal = !!target.sceneNormal || !!source.sceneNormal;\r\n  target.sceneRoughness = !!target.sceneRoughness || !!source.sceneRoughness;\r\n  target.shadowMask = !!target.shadowMask || !!source.shadowMask;\r\n  return target;\r\n}\r\n"],"names":["mergeFrameResourceRequirements","target","source","motionVector","hiZ","hiZNearest","sceneNormal","sceneRoughness","shadowMask"],"mappings":"AAAA,sJAkBO,SAASA,8BACdC,CAAAA,MAAiC,EACjCC,MAAoD,EAAA;AAEpD,IAAA,IAAI,CAACA,MAAQ,EAAA;QACX,OAAOD,MAAAA;AACT;IACAA,MAAOE,CAAAA,YAAY,GAAG,CAAC,CAACF,MAAAA,CAAOE,YAAY,IAAI,CAAC,CAACD,MAAAA,CAAOC,YAAY;IACpEF,MAAOG,CAAAA,GAAG,GAAG,CAAC,CAACH,MAAAA,CAAOG,GAAG,IAAI,CAAC,CAACF,MAAAA,CAAOE,GAAG;IACzCH,MAAOI,CAAAA,UAAU,GAAG,CAAC,CAACJ,MAAAA,CAAOI,UAAU,IAAI,CAAC,CAACH,MAAAA,CAAOG,UAAU;IAC9DJ,MAAOK,CAAAA,WAAW,GAAG,CAAC,CAACL,MAAAA,CAAOK,WAAW,IAAI,CAAC,CAACJ,MAAAA,CAAOI,WAAW;IACjEL,MAAOM,CAAAA,cAAc,GAAG,CAAC,CAACN,MAAAA,CAAOM,cAAc,IAAI,CAAC,CAACL,MAAAA,CAAOK,cAAc;IAC1EN,MAAOO,CAAAA,UAAU,GAAG,CAAC,CAACP,MAAAA,CAAOO,UAAU,IAAI,CAAC,CAACN,MAAAA,CAAOM,UAAU;IAC9D,OAAOP,MAAAA;AACT;;;;"}

package/dist/render/rendergraph/history_resources.js

@@ -7,7 +7,14 @@
     /** Denoised diffuse irradiance reprojected into the next frame's lighting pass. */ SSGI_IRRADIANCE: 'ssgiIrradiance',
     /** Depth/normal surface data used to validate SSGI reprojection. */ SSGI_SURFACE: 'ssgiSurface',
     /** First and second luminance moments used by the SSGI temporal filter. */ SSGI_MOMENTS: 'ssgiMoments',
-    /** Temporally accumulated screen space ambient occlusion traced alongside SSGI. */ SSGI_AO: 'ssgiAO'
+    /** Temporally accumulated screen space ambient occlusion traced alongside SSGI. */ SSGI_AO: 'ssgiAO',
+    /**
+   * Previous frame's resolved water caustic map.
+   *
+   * Reprojected in light space rather than screen space: the map is an
+   * orthographic slice perpendicular to the sun, so it needs no motion vectors
+   * and survives the camera turning on the spot.
+   */ WATER_CAUSTICS: 'waterCaustics'
 };
 
 export { RGHistoryResources };

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

@@ -1 +1 @@
-{"version":3,"file":"history_resources.js","sources":["../../../src/render/rendergraph/history_resources.ts"],"sourcesContent":["/** Render graph history resource names. @public */\r\nexport const RGHistoryResources = {\r\n  TAA_COLOR: 'taaColor',\r\n  TAA_MOTION_VECTOR: 'taaMotionVector',\r\n  SSR_REFLECT: 'ssrReflect',\r\n  SSR_MOTION_VECTOR: 'ssrMotionVector',\r\n  /** Opaque linear-HDR scene color sampled by SSGI rays on the next frame. */\r\n  SSGI_SCENE_COLOR: 'ssgiSceneColor',\r\n  /** Denoised diffuse irradiance reprojected into the next frame's lighting pass. */\r\n  SSGI_IRRADIANCE: 'ssgiIrradiance',\r\n  /** Depth/normal surface data used to validate SSGI reprojection. */\r\n  SSGI_SURFACE: 'ssgiSurface',\r\n  /** First and second luminance moments used by the SSGI temporal filter. */\r\n  SSGI_MOMENTS: 'ssgiMoments',\r\n  /** Temporally accumulated screen space ambient occlusion traced alongside SSGI. */\r\n  SSGI_AO: 'ssgiAO'\r\n} as const;\r\n"],"names":["RGHistoryResources","TAA_COLOR","TAA_MOTION_VECTOR","SSR_REFLECT","SSR_MOTION_VECTOR","SSGI_SCENE_COLOR","SSGI_IRRADIANCE","SSGI_SURFACE","SSGI_MOMENTS","SSGI_AO"],"mappings":"AAAA,oDACO,MAAMA,kBAAqB,GAAA;IAChCC,SAAW,EAAA,UAAA;IACXC,iBAAmB,EAAA,iBAAA;IACnBC,WAAa,EAAA,YAAA;IACbC,iBAAmB,EAAA,iBAAA;AACnB,iFACAC,gBAAkB,EAAA,gBAAA;AAClB,wFACAC,eAAiB,EAAA,gBAAA;AACjB,yEACAC,YAAc,EAAA,aAAA;AACd,gFACAC,YAAc,EAAA,aAAA;AACd,wFACAC,OAAS,EAAA;AACX;;;;"}
+{"version":3,"file":"history_resources.js","sources":["../../../src/render/rendergraph/history_resources.ts"],"sourcesContent":["/** Render graph history resource names. @public */\r\nexport const RGHistoryResources = {\r\n  TAA_COLOR: 'taaColor',\r\n  TAA_MOTION_VECTOR: 'taaMotionVector',\r\n  SSR_REFLECT: 'ssrReflect',\r\n  SSR_MOTION_VECTOR: 'ssrMotionVector',\r\n  /** Opaque linear-HDR scene color sampled by SSGI rays on the next frame. */\r\n  SSGI_SCENE_COLOR: 'ssgiSceneColor',\r\n  /** Denoised diffuse irradiance reprojected into the next frame's lighting pass. */\r\n  SSGI_IRRADIANCE: 'ssgiIrradiance',\r\n  /** Depth/normal surface data used to validate SSGI reprojection. */\r\n  SSGI_SURFACE: 'ssgiSurface',\r\n  /** First and second luminance moments used by the SSGI temporal filter. */\r\n  SSGI_MOMENTS: 'ssgiMoments',\r\n  /** Temporally accumulated screen space ambient occlusion traced alongside SSGI. */\r\n  SSGI_AO: 'ssgiAO',\r\n  /**\r\n   * Previous frame's resolved water caustic map.\r\n   *\r\n   * Reprojected in light space rather than screen space: the map is an\r\n   * orthographic slice perpendicular to the sun, so it needs no motion vectors\r\n   * and survives the camera turning on the spot.\r\n   */\r\n  WATER_CAUSTICS: 'waterCaustics'\r\n} as const;\r\n"],"names":["RGHistoryResources","TAA_COLOR","TAA_MOTION_VECTOR","SSR_REFLECT","SSR_MOTION_VECTOR","SSGI_SCENE_COLOR","SSGI_IRRADIANCE","SSGI_SURFACE","SSGI_MOMENTS","SSGI_AO","WATER_CAUSTICS"],"mappings":"AAAA,oDACO,MAAMA,kBAAqB,GAAA;IAChCC,SAAW,EAAA,UAAA;IACXC,iBAAmB,EAAA,iBAAA;IACnBC,WAAa,EAAA,YAAA;IACbC,iBAAmB,EAAA,iBAAA;AACnB,iFACAC,gBAAkB,EAAA,gBAAA;AAClB,wFACAC,eAAiB,EAAA,gBAAA;AACjB,yEACAC,YAAc,EAAA,aAAA;AACd,gFACAC,YAAc,EAAA,aAAA;AACd,wFACAC,OAAS,EAAA,QAAA;AACT;;;;;;AAMC,MACDC,cAAgB,EAAA;AAClB;;;;"}

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

@@ -1 +1 @@
-{"version":3,"file":"rendergraph.js","sources":["../../../src/render/rendergraph/rendergraph.ts"],"sourcesContent":["import {\r\n  RGHandle,\r\n  type RGTextureHandle,\r\n  type RGFramebufferHandle,\r\n  type RGTokenHandle,\r\n  RGResource,\r\n  RGPass,\r\n  RGSubpass,\r\n  type RGTextureDesc,\r\n  type RGFramebufferDesc,\r\n  type RGPassBuilder,\r\n  type RGExecuteFn,\r\n  type RGExecuteContext,\r\n  type CompiledRenderGraph,\r\n  type RGResourceLifetime,\r\n  type RGWriteOptions\r\n} from './types';\r\n\r\n/** Declarative render pass and resource dependency graph. @public */\r\nexport class RenderGraph {\r\n  private _nextResourceId = 0;\r\n  private _resources: Map<number, RGResource> = new Map();\r\n  private _passes: RGPass<any>[] = [];\r\n  private _compiled: CompiledRenderGraph | null = null;\r\n  private _lastWriterByPhysicalId = new Map<number, RGPass<any>>();\r\n  /** Deduplicates warnings across per-frame graph instances. */\r\n  private static _warnedCulledPasses = new Set<string>();\r\n\r\n  /** Import an external texture that the graph does not own. */\r\n  importTexture<TTexture = unknown>(name: string): RGTextureHandle<TTexture> {\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, 'texture');\r\n  }\r\n\r\n  /**\r\n   * Add a pass. The setup callback declares dependencies and execution.\r\n   */\r\n  addPass<T = void>(name: string, setup: (builder: RGPassBuilder) => T): T {\r\n    let nameOccurrence = 0;\r\n    for (const existing of this._passes) {\r\n      if (existing.name === name) {\r\n        nameOccurrence++;\r\n      }\r\n    }\r\n    const pass = new RGPass<T>(this._passes.length, name, nameOccurrence);\r\n    const builder = this._createBuilder(pass);\r\n    const initialResourceIds = new Set(this._resources.keys());\r\n    try {\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    } catch (error) {\r\n      for (const id of this._resources.keys()) {\r\n        if (!initialResourceIds.has(id)) {\r\n          this._resources.delete(id);\r\n        }\r\n      }\r\n      for (const resource of this._resources.values()) {\r\n        for (let i = resource.consumers.length - 1; i >= 0; i--) {\r\n          if (resource.consumers[i] === pass) {\r\n            resource.consumers.splice(i, 1);\r\n          }\r\n        }\r\n        if (resource.nextWriter === pass) {\r\n          resource.nextWriter = null;\r\n        }\r\n      }\r\n      // Remove WAR edges added to existing passes before setup failed.\r\n      for (const existing of this._passes) {\r\n        for (let i = existing.warDependencies.length - 1; i >= 0; i--) {\r\n          if (existing.warDependencies[i] === pass) {\r\n            existing.warDependencies.splice(i, 1);\r\n          }\r\n        }\r\n      }\r\n      this._lastWriterByPhysicalId.clear();\r\n      for (const resource of this._resources.values()) {\r\n        if (resource.producer) {\r\n          this._lastWriterByPhysicalId.set(resource.physicalId, resource.producer);\r\n        }\r\n      }\r\n      throw error;\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Cull dead passes, sort dependencies, and calculate resource lifetimes.\r\n   * Outputs must be their latest written versions.\r\n   */\r\n  compile(outputs: RGHandle[]): CompiledRenderGraph {\r\n    this._validateOutputs(outputs);\r\n    this._cullDeadPasses(outputs);\r\n    const ordered = this._topologicalSort();\r\n    const lifetimes = this._analyzeLifetimes(ordered);\r\n    this._validateAllocationKeys(lifetimes);\r\n\r\n    this._compiled = { orderedPasses: ordered, lifetimes };\r\n    return this._compiled;\r\n  }\r\n\r\n  /** @internal Test-only callback runner; resource-managed code uses RenderGraphExecutor. */\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      getFramebuffer() {\r\n        throw new Error(\r\n          'RenderGraph.execute(): framebuffer resolution not available. Use RenderGraphExecutor for managed execution.'\r\n        );\r\n      },\r\n      createFramebuffer() {\r\n        throw new Error(\r\n          'RenderGraph.execute(): framebuffer allocation not available. Use RenderGraphExecutor for managed execution.'\r\n        );\r\n      },\r\n      deferCleanup() {}\r\n    };\r\n    for (const pass of compiled.orderedPasses) {\r\n      if (pass.subpasses.length > 0) {\r\n        for (const subpass of pass.subpasses) {\r\n          (subpass.executeFn as RGExecuteFn<unknown>)(noopCtx, pass.data);\r\n        }\r\n      } else if (pass.executeFn) {\r\n        (pass.executeFn as RGExecuteFn<unknown>)(noopCtx, pass.data);\r\n      }\r\n    }\r\n  }\r\n\r\n  /** Clear all passes, resources, and compiled state. */\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    this._lastWriterByPhysicalId.clear();\r\n  }\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<any>> {\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 _createBuilder<T>(pass: RGPass<T>): RGPassBuilder<T> {\r\n    const graph = this;\r\n    const textureLabelOccurrences = new Map<string, number>();\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        graph._declareRead(pass, res);\r\n      },\r\n      write<TTexture>(\r\n        handle: RGTextureHandle<TTexture> | RGHandle,\r\n        options: RGWriteOptions | undefined\r\n      ): RGTextureHandle<TTexture> {\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.kind === 'token') {\r\n          throw new Error(\r\n            `RenderGraph: pass \"${pass.name}\" attempts to write token \"${res.name}\". ` +\r\n              `Use createToken() to produce ordering tokens.`\r\n          );\r\n        }\r\n        if (res.kind === 'framebuffer') {\r\n          throw new Error(\r\n            `RenderGraph: pass \"${pass.name}\" attempts to write framebuffer \"${res.name}\". ` +\r\n              `Create a new framebuffer view instead.`\r\n          );\r\n        }\r\n        const discard = options?.load === 'discard';\r\n        const previousWriter = graph._lastWriterByPhysicalId.get(res.physicalId);\r\n        if (previousWriter && previousWriter !== pass) {\r\n          const dependencies = discard ? pass.orderingDependencies : pass.dependencies;\r\n          if (!dependencies.includes(previousWriter)) {\r\n            dependencies.push(previousWriter);\r\n          }\r\n        }\r\n        // WAR orders live readers before the overwrite without retaining them.\r\n        for (const consumer of res.consumers) {\r\n          if (consumer !== pass && !pass.warDependencies.includes(consumer)) {\r\n            pass.warDependencies.push(consumer);\r\n          }\r\n        }\r\n        if (res.producer && res.producer !== pass) {\r\n          const dependencies = discard ? pass.orderingDependencies : pass.dependencies;\r\n          if (!dependencies.includes(res.producer)) {\r\n            dependencies.push(res.producer);\r\n          }\r\n        }\r\n        const id = graph._nextResourceId++;\r\n        const versionName = `${res.name}@${pass.name}`;\r\n        const version = new RGResource(\r\n          id,\r\n          versionName,\r\n          res.kind,\r\n          res.desc,\r\n          res.physicalId,\r\n          res.allocationKey\r\n        );\r\n        version.producer = pass;\r\n        // WAW edges make the first overwrite sufficient for stale readers.\r\n        if (!res.nextWriter) {\r\n          res.nextWriter = pass;\r\n        }\r\n        graph._resources.set(id, version);\r\n        graph._lastWriterByPhysicalId.set(res.physicalId, pass);\r\n        if (!pass.writes.includes(version)) {\r\n          pass.writes.push(version);\r\n        }\r\n        return new RGHandle(id, versionName, 'texture');\r\n      },\r\n      createTexture<TTexture = unknown>(desc: RGTextureDesc): RGTextureHandle<TTexture> {\r\n        if (desc.allocationKey !== undefined && desc.allocationKey.length === 0) {\r\n          throw new Error(`RenderGraph: pass \"${pass.name}\" specified an empty texture allocationKey.`);\r\n        }\r\n        const id = graph._nextResourceId++;\r\n        const name = desc.label ?? `_tex_${id}`;\r\n        const labelKey = desc.label ?? '<unnamed>';\r\n        const labelOccurrence = textureLabelOccurrences.get(labelKey) ?? 0;\r\n        textureLabelOccurrences.set(labelKey, labelOccurrence + 1);\r\n        const allocationKey =\r\n          desc.allocationKey ??\r\n          `rg:${JSON.stringify([pass.name, pass.nameOccurrence, desc.label ?? null, labelOccurrence])}`;\r\n        const res = new RGResource(id, name, 'transient', desc, id, allocationKey);\r\n        res.producer = pass;\r\n        graph._resources.set(id, res);\r\n        graph._lastWriterByPhysicalId.set(res.physicalId, pass);\r\n        pass.writes.push(res);\r\n        return new RGHandle(id, name, 'texture');\r\n      },\r\n      createToken(name?: string): RGTokenHandle {\r\n        const id = graph._nextResourceId++;\r\n        const tokenName = name ?? `_token_${id}`;\r\n        const res = new RGResource(id, tokenName, 'token', null);\r\n        res.producer = pass;\r\n        graph._resources.set(id, res);\r\n        pass.writes.push(res);\r\n        return new RGHandle(id, tokenName, 'token');\r\n      },\r\n      createFramebuffer<TFramebuffer = unknown>(desc: RGFramebufferDesc): RGFramebufferHandle<TFramebuffer> {\r\n        const id = graph._nextResourceId++;\r\n        const name = desc.label ?? `_fb_${id}`;\r\n        const res = new RGResource(id, name, 'framebuffer', desc);\r\n        res.producer = pass;\r\n        graph._resources.set(id, res);\r\n        graph._lastWriterByPhysicalId.set(res.physicalId, pass);\r\n        pass.writes.push(res);\r\n        graph._declareFramebufferAttachmentDeps(pass, desc);\r\n        return new RGHandle(id, name, 'framebuffer');\r\n      },\r\n      sideEffect(): void {\r\n        pass.hasSideEffect = true;\r\n      },\r\n      addSubpass<D = T>(name: string, fn: RGExecuteFn<D>): void {\r\n        if (pass.executeFn) {\r\n          throw new Error(\r\n            `RenderGraph: pass \"${pass.name}\" cannot use addSubpass() after setExecute(). ` +\r\n              `Use either subpasses or a single execute callback.`\r\n          );\r\n        }\r\n        pass.subpasses.push(new RGSubpass(name, fn as unknown as RGExecuteFn<T>));\r\n      },\r\n      setExecute<D = T>(fn: RGExecuteFn<D>): void {\r\n        if (pass.subpasses.length > 0) {\r\n          throw new Error(\r\n            `RenderGraph: pass \"${pass.name}\" cannot use setExecute() after addSubpass(). ` +\r\n              `Use either subpasses or a single execute callback.`\r\n          );\r\n        }\r\n        pass.executeFn = fn as unknown as RGExecuteFn<T>;\r\n      }\r\n    };\r\n  }\r\n\r\n  private _validateAllocationKeys(lifetimes: ReadonlyMap<number, RGResourceLifetime>): void {\r\n    const physicalByKey = new Map<string, number>();\r\n    for (const lifetime of lifetimes.values()) {\r\n      const resource = lifetime.resource;\r\n      if (resource.kind !== 'transient' || !resource.allocationKey) {\r\n        continue;\r\n      }\r\n      const existingPhysicalId = physicalByKey.get(resource.allocationKey);\r\n      if (existingPhysicalId !== undefined && existingPhysicalId !== resource.physicalId) {\r\n        throw new Error(\r\n          `RenderGraph: transient allocationKey \"${resource.allocationKey}\" is used by multiple resources. ` +\r\n            'Use a unique allocationKey for each logical texture.'\r\n        );\r\n      }\r\n      physicalByKey.set(resource.allocationKey, resource.physicalId);\r\n    }\r\n  }\r\n\r\n  private _validateOutputs(outputs: RGHandle[]): void {\r\n    const latestVersions = new Map<number, RGResource>();\r\n    for (const res of this._resources.values()) {\r\n      const current = latestVersions.get(res.physicalId);\r\n      if (!current || res.id > current.id) {\r\n        latestVersions.set(res.physicalId, res);\r\n      }\r\n    }\r\n\r\n    for (const handle of outputs) {\r\n      const res = this._resources.get(handle._id);\r\n      if (!res) {\r\n        throw new Error(`RenderGraph: unknown output resource \"${handle.name}\" (id=${handle._id})`);\r\n      }\r\n      const latest = latestVersions.get(res.physicalId);\r\n      if (latest && latest.id !== res.id) {\r\n        throw new Error(\r\n          `RenderGraph: output resource \"${res.name}\" (id=${res.id}) is not the latest version. ` +\r\n            `Use the handle returned by builder.write(); latest is \"${latest.name}\" (id=${latest.id}).`\r\n        );\r\n      }\r\n    }\r\n  }\r\n\r\n  private _cullDeadPasses(outputs: RGHandle[]): void {\r\n    for (const pass of this._passes) {\r\n      pass.alive = false;\r\n    }\r\n\r\n    const neededResources = new Set<number>();\r\n    const stack: RGResource[] = [];\r\n    const markResourceNeeded = (res: RGResource) => {\r\n      if (!neededResources.has(res.id)) {\r\n        neededResources.add(res.id);\r\n        stack.push(res);\r\n      }\r\n    };\r\n    const markPassAlive = (pass: RGPass<any>) => {\r\n      if (pass.alive) {\r\n        return;\r\n      }\r\n      pass.alive = true;\r\n      for (const dep of pass.reads) {\r\n        markResourceNeeded(dep);\r\n      }\r\n      // WAR dependencies order passes but do not propagate liveness.\r\n      for (const dependency of pass.dependencies) {\r\n        markPassAlive(dependency);\r\n      }\r\n    };\r\n\r\n    for (const handle of outputs) {\r\n      const res = this._resources.get(handle._id);\r\n      if (!res) {\r\n        throw new Error(`RenderGraph: unknown output resource \"${handle.name}\" (id=${handle._id})`);\r\n      }\r\n      markResourceNeeded(res);\r\n    }\r\n\r\n    for (const pass of this._passes) {\r\n      if (pass.hasSideEffect) {\r\n        markPassAlive(pass);\r\n      }\r\n    }\r\n\r\n    while (stack.length > 0) {\r\n      const res = stack.pop()!;\r\n      const producer = res.producer;\r\n      if (producer) {\r\n        markPassAlive(producer);\r\n      }\r\n    }\r\n\r\n    // Warn when an ordering-only pass may have omitted sideEffect or an output.\r\n    for (const pass of this._passes) {\r\n      if (\r\n        !pass.alive &&\r\n        !pass.hasSideEffect &&\r\n        pass.warDependencies.length > 0 &&\r\n        !RenderGraph._warnedCulledPasses.has(pass.name)\r\n      ) {\r\n        RenderGraph._warnedCulledPasses.add(pass.name);\r\n        console.warn(\r\n          `RenderGraph: pass \"${pass.name}\" was culled but is referenced by WAR ` +\r\n            `ordering edges. If its work must run, call sideEffect() or route its ` +\r\n            `output into a compile() sink.`\r\n        );\r\n      }\r\n    }\r\n  }\r\n\r\n  private _declareRead(pass: RGPass<any>, res: RGResource): void {\r\n    if (res.kind === 'transient' && !res.producer) {\r\n      throw new Error(\r\n        `RenderGraph: pass \"${pass.name}\" attempts to read transient resource \"${res.name}\" ` +\r\n          `which has no producer. Ensure the resource is created before being read.`\r\n      );\r\n    }\r\n    if (!pass.reads.includes(res)) {\r\n      pass.reads.push(res);\r\n    }\r\n    if (!res.consumers.includes(pass)) {\r\n      res.consumers.push(pass);\r\n    }\r\n    // A stale-version read must precede its first overwrite.\r\n    if (res.nextWriter && res.nextWriter !== pass && !res.nextWriter.warDependencies.includes(pass)) {\r\n      res.nextWriter.warDependencies.push(pass);\r\n    }\r\n  }\r\n\r\n  private _declareFramebufferAttachmentDeps(\r\n    pass: RGPass<any>,\r\n    desc: { colorAttachments: unknown | unknown[] | null; depthAttachment?: unknown | null }\r\n  ): void {\r\n    const declare = (attachment: unknown) => {\r\n      if (attachment instanceof RGHandle) {\r\n        const res = this._resources.get(attachment._id);\r\n        if (!res) {\r\n          throw new Error(\r\n            `RenderGraph: unknown framebuffer attachment \"${attachment.name}\" (id=${attachment._id})`\r\n          );\r\n        }\r\n        if (res.kind !== 'transient' && res.kind !== 'imported') {\r\n          throw new Error(\r\n            `RenderGraph: framebuffer attachment \"${res.name}\" must be a texture resource, got ${res.kind}.`\r\n          );\r\n        }\r\n        if (res.producer !== pass) {\r\n          this._declareRead(pass, res);\r\n        }\r\n      }\r\n    };\r\n    const colors = Array.isArray(desc.colorAttachments)\r\n      ? desc.colorAttachments\r\n      : desc.colorAttachments\r\n        ? [desc.colorAttachments]\r\n        : [];\r\n    for (const attachment of colors) {\r\n      declare(attachment);\r\n    }\r\n    declare(desc.depthAttachment);\r\n  }\r\n\r\n  private _topologicalSort(): RGPass<any>[] {\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    const aliveSet = new Set(alivePasses);\r\n    const inDegree = new Map<RGPass<any>, number>();\r\n    const adjacency = new Map<RGPass<any>, RGPass<any>[]>();\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    const addEdge = (from: RGPass<any>, to: RGPass<any>) => {\r\n      if (from === to || !aliveSet.has(from) || !aliveSet.has(to)) {\r\n        return;\r\n      }\r\n      const neighbors = adjacency.get(from)!;\r\n      if (!neighbors.includes(to)) {\r\n        neighbors.push(to);\r\n        inDegree.set(to, inDegree.get(to)! + 1);\r\n      }\r\n    };\r\n\r\n    for (const pass of alivePasses) {\r\n      for (const dependency of pass.dependencies) {\r\n        addEdge(dependency, pass);\r\n      }\r\n      for (const dependency of pass.orderingDependencies) {\r\n        addEdge(dependency, pass);\r\n      }\r\n      for (const dependency of pass.warDependencies) {\r\n        addEdge(dependency, pass);\r\n      }\r\n    }\r\n\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        addEdge(res.producer, consumer);\r\n      }\r\n    }\r\n\r\n    const queue: RGPass<any>[] = [];\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<any>[] = [];\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      const cycleParticipants: string[] = [];\r\n      for (const [pass, degree] of inDegree) {\r\n        if (degree > 0) {\r\n          cycleParticipants.push(pass.name);\r\n        }\r\n      }\r\n      throw new Error(\r\n        `RenderGraph: circular dependency detected. ` +\r\n          `Sorted ${result.length} of ${alivePasses.length} alive passes. ` +\r\n          `Passes in cycle: [${cycleParticipants.join(', ')}]`\r\n      );\r\n    }\r\n\r\n    return result;\r\n  }\r\n\r\n  private _analyzeLifetimes(orderedPasses: RGPass<any>[]): Map<number, RGResourceLifetime> {\r\n    const lifetimes = new Map<number, { resource: RGResource; firstUse: number; lastUse: number }>();\r\n\r\n    const orderMap = new Map<RGPass<any>, 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      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      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    // Attachment textures must outlive every framebuffer use.\r\n    for (const lifetime of lifetimes.values()) {\r\n      const res = lifetime.resource;\r\n      if (res.kind !== 'framebuffer' || !res.desc) {\r\n        continue;\r\n      }\r\n      const desc = res.desc as RGFramebufferDesc;\r\n      const extend = (attachment: unknown) => {\r\n        if (!(attachment instanceof RGHandle)) {\r\n          return;\r\n        }\r\n        const attachmentLifetime = lifetimes.get(attachment._id);\r\n        if (attachmentLifetime) {\r\n          attachmentLifetime.firstUse = Math.min(attachmentLifetime.firstUse, lifetime.firstUse);\r\n          attachmentLifetime.lastUse = Math.max(attachmentLifetime.lastUse, lifetime.lastUse);\r\n        }\r\n      };\r\n      const colors = Array.isArray(desc.colorAttachments)\r\n        ? desc.colorAttachments\r\n        : desc.colorAttachments\r\n          ? [desc.colorAttachments]\r\n          : [];\r\n      for (const attachment of colors) {\r\n        extend(attachment);\r\n      }\r\n      extend(desc.depthAttachment);\r\n    }\r\n\r\n    return lifetimes;\r\n  }\r\n}\r\n"],"names":["RenderGraph","_nextResourceId","_resources","Map","_passes","_compiled","_lastWriterByPhysicalId","_warnedCulledPasses","Set","importTexture","name","id","resource","RGResource","set","RGHandle","addPass","setup","nameOccurrence","existing","pass","RGPass","length","builder","_createBuilder","initialResourceIds","keys","data","push","error","has","delete","values","i","consumers","splice","nextWriter","warDependencies","clear","producer","physicalId","compile","outputs","_validateOutputs","_cullDeadPasses","ordered","_topologicalSort","lifetimes","_analyzeLifetimes","_validateAllocationKeys","orderedPasses","execute","compiled","noopCtx","getTexture","Error","getFramebuffer","createFramebuffer","deferCleanup","subpasses","subpass","executeFn","reset","getResource","handle","get","_id","passes","resources","graph","textureLabelOccurrences","read","res","_declareRead","write","options","kind","discard","load","previousWriter","dependencies","orderingDependencies","includes","consumer","versionName","version","desc","allocationKey","writes","createTexture","undefined","label","labelKey","labelOccurrence","JSON","stringify","createToken","tokenName","_declareFramebufferAttachmentDeps","sideEffect","hasSideEffect","addSubpass","fn","RGSubpass","setExecute","physicalByKey","lifetime","existingPhysicalId","latestVersions","current","latest","alive","neededResources","stack","markResourceNeeded","add","markPassAlive","dep","reads","dependency","pop","console","warn","declare","attachment","colors","Array","isArray","colorAttachments","depthAttachment","alivePasses","filter","p","aliveSet","inDegree","adjacency","addEdge","from","to","neighbors","queue","result","shift","neighbor","deg","cycleParticipants","degree","join","orderMap","first","Infinity","last","idx","Math","min","max","firstUse","lastUse","extend","attachmentLifetime"],"mappings":"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"}
+{"version":3,"file":"rendergraph.js","sources":["../../../src/render/rendergraph/rendergraph.ts"],"sourcesContent":["import {\r\n  RGHandle,\r\n  type RGTextureHandle,\r\n  type RGFramebufferHandle,\r\n  type RGTokenHandle,\r\n  RGResource,\r\n  RGPass,\r\n  RGSubpass,\r\n  type RGTextureDesc,\r\n  type RGFramebufferDesc,\r\n  type RGPassBuilder,\r\n  type RGExecuteFn,\r\n  type RGExecuteContext,\r\n  type CompiledRenderGraph,\r\n  type RGResourceLifetime,\r\n  type RGWriteOptions\r\n} from './types';\r\nimport type { BaseTexture } from '@zephyr3d/device';\r\n\r\n/** Declarative render pass and resource dependency graph. @public */\r\nexport class RenderGraph {\r\n  private _nextResourceId = 0;\r\n  private _resources: Map<number, RGResource> = new Map();\r\n  private _passes: RGPass<any>[] = [];\r\n  private _compiled: CompiledRenderGraph | null = null;\r\n  private _lastWriterByPhysicalId = new Map<number, RGPass<any>>();\r\n  /** Deduplicates warnings across per-frame graph instances. */\r\n  private static _warnedCulledPasses = new Set<string>();\r\n\r\n  /** Import an external texture that the graph does not own. */\r\n  importTexture<TTexture = BaseTexture>(name: string): RGTextureHandle<TTexture> {\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, 'texture');\r\n  }\r\n\r\n  /**\r\n   * Add a pass. The setup callback declares dependencies and execution.\r\n   */\r\n  addPass<T = void>(name: string, setup: (builder: RGPassBuilder) => T): T {\r\n    let nameOccurrence = 0;\r\n    for (const existing of this._passes) {\r\n      if (existing.name === name) {\r\n        nameOccurrence++;\r\n      }\r\n    }\r\n    const pass = new RGPass<T>(this._passes.length, name, nameOccurrence);\r\n    const builder = this._createBuilder(pass);\r\n    const initialResourceIds = new Set(this._resources.keys());\r\n    try {\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    } catch (error) {\r\n      for (const id of this._resources.keys()) {\r\n        if (!initialResourceIds.has(id)) {\r\n          this._resources.delete(id);\r\n        }\r\n      }\r\n      for (const resource of this._resources.values()) {\r\n        for (let i = resource.consumers.length - 1; i >= 0; i--) {\r\n          if (resource.consumers[i] === pass) {\r\n            resource.consumers.splice(i, 1);\r\n          }\r\n        }\r\n        if (resource.nextWriter === pass) {\r\n          resource.nextWriter = null;\r\n        }\r\n      }\r\n      // Remove WAR edges added to existing passes before setup failed.\r\n      for (const existing of this._passes) {\r\n        for (let i = existing.warDependencies.length - 1; i >= 0; i--) {\r\n          if (existing.warDependencies[i] === pass) {\r\n            existing.warDependencies.splice(i, 1);\r\n          }\r\n        }\r\n      }\r\n      this._lastWriterByPhysicalId.clear();\r\n      for (const resource of this._resources.values()) {\r\n        if (resource.producer) {\r\n          this._lastWriterByPhysicalId.set(resource.physicalId, resource.producer);\r\n        }\r\n      }\r\n      throw error;\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Cull dead passes, sort dependencies, and calculate resource lifetimes.\r\n   * Outputs must be their latest written versions.\r\n   */\r\n  compile(outputs: RGHandle[]): CompiledRenderGraph {\r\n    this._validateOutputs(outputs);\r\n    this._cullDeadPasses(outputs);\r\n    const ordered = this._topologicalSort();\r\n    const lifetimes = this._analyzeLifetimes(ordered);\r\n    this._validateAllocationKeys(lifetimes);\r\n\r\n    this._compiled = { orderedPasses: ordered, lifetimes };\r\n    return this._compiled;\r\n  }\r\n\r\n  /** @internal Test-only callback runner; resource-managed code uses RenderGraphExecutor. */\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      getFramebuffer() {\r\n        throw new Error(\r\n          'RenderGraph.execute(): framebuffer resolution not available. Use RenderGraphExecutor for managed execution.'\r\n        );\r\n      },\r\n      createFramebuffer() {\r\n        throw new Error(\r\n          'RenderGraph.execute(): framebuffer allocation not available. Use RenderGraphExecutor for managed execution.'\r\n        );\r\n      },\r\n      deferCleanup() {}\r\n    };\r\n    for (const pass of compiled.orderedPasses) {\r\n      if (pass.subpasses.length > 0) {\r\n        for (const subpass of pass.subpasses) {\r\n          (subpass.executeFn as RGExecuteFn<unknown>)(noopCtx, pass.data);\r\n        }\r\n      } else if (pass.executeFn) {\r\n        (pass.executeFn as RGExecuteFn<unknown>)(noopCtx, pass.data);\r\n      }\r\n    }\r\n  }\r\n\r\n  /** Clear all passes, resources, and compiled state. */\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    this._lastWriterByPhysicalId.clear();\r\n  }\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<any>> {\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 _createBuilder<T>(pass: RGPass<T>): RGPassBuilder<T> {\r\n    const graph = this;\r\n    const textureLabelOccurrences = new Map<string, number>();\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        graph._declareRead(pass, res);\r\n      },\r\n      write<TTexture>(\r\n        handle: RGTextureHandle<TTexture> | RGHandle,\r\n        options: RGWriteOptions | undefined\r\n      ): RGTextureHandle<TTexture> {\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.kind === 'token') {\r\n          throw new Error(\r\n            `RenderGraph: pass \"${pass.name}\" attempts to write token \"${res.name}\". ` +\r\n              `Use createToken() to produce ordering tokens.`\r\n          );\r\n        }\r\n        if (res.kind === 'framebuffer') {\r\n          throw new Error(\r\n            `RenderGraph: pass \"${pass.name}\" attempts to write framebuffer \"${res.name}\". ` +\r\n              `Create a new framebuffer view instead.`\r\n          );\r\n        }\r\n        const discard = options?.load === 'discard';\r\n        const previousWriter = graph._lastWriterByPhysicalId.get(res.physicalId);\r\n        if (previousWriter && previousWriter !== pass) {\r\n          const dependencies = discard ? pass.orderingDependencies : pass.dependencies;\r\n          if (!dependencies.includes(previousWriter)) {\r\n            dependencies.push(previousWriter);\r\n          }\r\n        }\r\n        // WAR orders live readers before the overwrite without retaining them.\r\n        for (const consumer of res.consumers) {\r\n          if (consumer !== pass && !pass.warDependencies.includes(consumer)) {\r\n            pass.warDependencies.push(consumer);\r\n          }\r\n        }\r\n        if (res.producer && res.producer !== pass) {\r\n          const dependencies = discard ? pass.orderingDependencies : pass.dependencies;\r\n          if (!dependencies.includes(res.producer)) {\r\n            dependencies.push(res.producer);\r\n          }\r\n        }\r\n        const id = graph._nextResourceId++;\r\n        const versionName = `${res.name}@${pass.name}`;\r\n        const version = new RGResource(\r\n          id,\r\n          versionName,\r\n          res.kind,\r\n          res.desc,\r\n          res.physicalId,\r\n          res.allocationKey\r\n        );\r\n        version.producer = pass;\r\n        // WAW edges make the first overwrite sufficient for stale readers.\r\n        if (!res.nextWriter) {\r\n          res.nextWriter = pass;\r\n        }\r\n        graph._resources.set(id, version);\r\n        graph._lastWriterByPhysicalId.set(res.physicalId, pass);\r\n        if (!pass.writes.includes(version)) {\r\n          pass.writes.push(version);\r\n        }\r\n        return new RGHandle(id, versionName, 'texture');\r\n      },\r\n      createTexture<TTexture = BaseTexture>(desc: RGTextureDesc): RGTextureHandle<TTexture> {\r\n        if (desc.allocationKey !== undefined && desc.allocationKey.length === 0) {\r\n          throw new Error(`RenderGraph: pass \"${pass.name}\" specified an empty texture allocationKey.`);\r\n        }\r\n        const id = graph._nextResourceId++;\r\n        const name = desc.label ?? `_tex_${id}`;\r\n        const labelKey = desc.label ?? '<unnamed>';\r\n        const labelOccurrence = textureLabelOccurrences.get(labelKey) ?? 0;\r\n        textureLabelOccurrences.set(labelKey, labelOccurrence + 1);\r\n        const allocationKey =\r\n          desc.allocationKey ??\r\n          `rg:${JSON.stringify([pass.name, pass.nameOccurrence, desc.label ?? null, labelOccurrence])}`;\r\n        const res = new RGResource(id, name, 'transient', desc, id, allocationKey);\r\n        res.producer = pass;\r\n        graph._resources.set(id, res);\r\n        graph._lastWriterByPhysicalId.set(res.physicalId, pass);\r\n        pass.writes.push(res);\r\n        return new RGHandle(id, name, 'texture');\r\n      },\r\n      createToken(name?: string): RGTokenHandle {\r\n        const id = graph._nextResourceId++;\r\n        const tokenName = name ?? `_token_${id}`;\r\n        const res = new RGResource(id, tokenName, 'token', null);\r\n        res.producer = pass;\r\n        graph._resources.set(id, res);\r\n        pass.writes.push(res);\r\n        return new RGHandle(id, tokenName, 'token');\r\n      },\r\n      createFramebuffer(desc: RGFramebufferDesc): RGFramebufferHandle {\r\n        const id = graph._nextResourceId++;\r\n        const name = desc.label ?? `_fb_${id}`;\r\n        const res = new RGResource(id, name, 'framebuffer', desc);\r\n        res.producer = pass;\r\n        graph._resources.set(id, res);\r\n        graph._lastWriterByPhysicalId.set(res.physicalId, pass);\r\n        pass.writes.push(res);\r\n        graph._declareFramebufferAttachmentDeps(pass, desc);\r\n        return new RGHandle(id, name, 'framebuffer');\r\n      },\r\n      sideEffect(): void {\r\n        pass.hasSideEffect = true;\r\n      },\r\n      addSubpass<D = T>(name: string, fn: RGExecuteFn<D>): void {\r\n        if (pass.executeFn) {\r\n          throw new Error(\r\n            `RenderGraph: pass \"${pass.name}\" cannot use addSubpass() after setExecute(). ` +\r\n              `Use either subpasses or a single execute callback.`\r\n          );\r\n        }\r\n        pass.subpasses.push(new RGSubpass(name, fn as unknown as RGExecuteFn<T>));\r\n      },\r\n      setExecute<D = T>(fn: RGExecuteFn<D>): void {\r\n        if (pass.subpasses.length > 0) {\r\n          throw new Error(\r\n            `RenderGraph: pass \"${pass.name}\" cannot use setExecute() after addSubpass(). ` +\r\n              `Use either subpasses or a single execute callback.`\r\n          );\r\n        }\r\n        pass.executeFn = fn as unknown as RGExecuteFn<T>;\r\n      }\r\n    };\r\n  }\r\n\r\n  private _validateAllocationKeys(lifetimes: ReadonlyMap<number, RGResourceLifetime>): void {\r\n    const physicalByKey = new Map<string, number>();\r\n    for (const lifetime of lifetimes.values()) {\r\n      const resource = lifetime.resource;\r\n      if (resource.kind !== 'transient' || !resource.allocationKey) {\r\n        continue;\r\n      }\r\n      const existingPhysicalId = physicalByKey.get(resource.allocationKey);\r\n      if (existingPhysicalId !== undefined && existingPhysicalId !== resource.physicalId) {\r\n        throw new Error(\r\n          `RenderGraph: transient allocationKey \"${resource.allocationKey}\" is used by multiple resources. ` +\r\n            'Use a unique allocationKey for each logical texture.'\r\n        );\r\n      }\r\n      physicalByKey.set(resource.allocationKey, resource.physicalId);\r\n    }\r\n  }\r\n\r\n  private _validateOutputs(outputs: RGHandle[]): void {\r\n    const latestVersions = new Map<number, RGResource>();\r\n    for (const res of this._resources.values()) {\r\n      const current = latestVersions.get(res.physicalId);\r\n      if (!current || res.id > current.id) {\r\n        latestVersions.set(res.physicalId, res);\r\n      }\r\n    }\r\n\r\n    for (const handle of outputs) {\r\n      const res = this._resources.get(handle._id);\r\n      if (!res) {\r\n        throw new Error(`RenderGraph: unknown output resource \"${handle.name}\" (id=${handle._id})`);\r\n      }\r\n      const latest = latestVersions.get(res.physicalId);\r\n      if (latest && latest.id !== res.id) {\r\n        throw new Error(\r\n          `RenderGraph: output resource \"${res.name}\" (id=${res.id}) is not the latest version. ` +\r\n            `Use the handle returned by builder.write(); latest is \"${latest.name}\" (id=${latest.id}).`\r\n        );\r\n      }\r\n    }\r\n  }\r\n\r\n  private _cullDeadPasses(outputs: RGHandle[]): void {\r\n    for (const pass of this._passes) {\r\n      pass.alive = false;\r\n    }\r\n\r\n    const neededResources = new Set<number>();\r\n    const stack: RGResource[] = [];\r\n    const markResourceNeeded = (res: RGResource) => {\r\n      if (!neededResources.has(res.id)) {\r\n        neededResources.add(res.id);\r\n        stack.push(res);\r\n      }\r\n    };\r\n    const markPassAlive = (pass: RGPass<any>) => {\r\n      if (pass.alive) {\r\n        return;\r\n      }\r\n      pass.alive = true;\r\n      for (const dep of pass.reads) {\r\n        markResourceNeeded(dep);\r\n      }\r\n      // WAR dependencies order passes but do not propagate liveness.\r\n      for (const dependency of pass.dependencies) {\r\n        markPassAlive(dependency);\r\n      }\r\n    };\r\n\r\n    for (const handle of outputs) {\r\n      const res = this._resources.get(handle._id);\r\n      if (!res) {\r\n        throw new Error(`RenderGraph: unknown output resource \"${handle.name}\" (id=${handle._id})`);\r\n      }\r\n      markResourceNeeded(res);\r\n    }\r\n\r\n    for (const pass of this._passes) {\r\n      if (pass.hasSideEffect) {\r\n        markPassAlive(pass);\r\n      }\r\n    }\r\n\r\n    while (stack.length > 0) {\r\n      const res = stack.pop()!;\r\n      const producer = res.producer;\r\n      if (producer) {\r\n        markPassAlive(producer);\r\n      }\r\n    }\r\n\r\n    // Warn when an ordering-only pass may have omitted sideEffect or an output.\r\n    for (const pass of this._passes) {\r\n      if (\r\n        !pass.alive &&\r\n        !pass.hasSideEffect &&\r\n        pass.warDependencies.length > 0 &&\r\n        !RenderGraph._warnedCulledPasses.has(pass.name)\r\n      ) {\r\n        RenderGraph._warnedCulledPasses.add(pass.name);\r\n        console.warn(\r\n          `RenderGraph: pass \"${pass.name}\" was culled but is referenced by WAR ` +\r\n            `ordering edges. If its work must run, call sideEffect() or route its ` +\r\n            `output into a compile() sink.`\r\n        );\r\n      }\r\n    }\r\n  }\r\n\r\n  private _declareRead(pass: RGPass<any>, res: RGResource): void {\r\n    if (res.kind === 'transient' && !res.producer) {\r\n      throw new Error(\r\n        `RenderGraph: pass \"${pass.name}\" attempts to read transient resource \"${res.name}\" ` +\r\n          `which has no producer. Ensure the resource is created before being read.`\r\n      );\r\n    }\r\n    if (!pass.reads.includes(res)) {\r\n      pass.reads.push(res);\r\n    }\r\n    if (!res.consumers.includes(pass)) {\r\n      res.consumers.push(pass);\r\n    }\r\n    // A stale-version read must precede its first overwrite.\r\n    if (res.nextWriter && res.nextWriter !== pass && !res.nextWriter.warDependencies.includes(pass)) {\r\n      res.nextWriter.warDependencies.push(pass);\r\n    }\r\n  }\r\n\r\n  private _declareFramebufferAttachmentDeps(\r\n    pass: RGPass<any>,\r\n    desc: { colorAttachments: unknown | unknown[] | null; depthAttachment?: unknown | null }\r\n  ): void {\r\n    const declare = (attachment: unknown) => {\r\n      if (attachment instanceof RGHandle) {\r\n        const res = this._resources.get(attachment._id);\r\n        if (!res) {\r\n          throw new Error(\r\n            `RenderGraph: unknown framebuffer attachment \"${attachment.name}\" (id=${attachment._id})`\r\n          );\r\n        }\r\n        if (res.kind !== 'transient' && res.kind !== 'imported') {\r\n          throw new Error(\r\n            `RenderGraph: framebuffer attachment \"${res.name}\" must be a texture resource, got ${res.kind}.`\r\n          );\r\n        }\r\n        if (res.producer !== pass) {\r\n          this._declareRead(pass, res);\r\n        }\r\n      }\r\n    };\r\n    const colors = Array.isArray(desc.colorAttachments)\r\n      ? desc.colorAttachments\r\n      : desc.colorAttachments\r\n        ? [desc.colorAttachments]\r\n        : [];\r\n    for (const attachment of colors) {\r\n      declare(attachment);\r\n    }\r\n    declare(desc.depthAttachment);\r\n  }\r\n\r\n  private _topologicalSort(): RGPass<any>[] {\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    const aliveSet = new Set(alivePasses);\r\n    const inDegree = new Map<RGPass<any>, number>();\r\n    const adjacency = new Map<RGPass<any>, RGPass<any>[]>();\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    const addEdge = (from: RGPass<any>, to: RGPass<any>) => {\r\n      if (from === to || !aliveSet.has(from) || !aliveSet.has(to)) {\r\n        return;\r\n      }\r\n      const neighbors = adjacency.get(from)!;\r\n      if (!neighbors.includes(to)) {\r\n        neighbors.push(to);\r\n        inDegree.set(to, inDegree.get(to)! + 1);\r\n      }\r\n    };\r\n\r\n    for (const pass of alivePasses) {\r\n      for (const dependency of pass.dependencies) {\r\n        addEdge(dependency, pass);\r\n      }\r\n      for (const dependency of pass.orderingDependencies) {\r\n        addEdge(dependency, pass);\r\n      }\r\n      for (const dependency of pass.warDependencies) {\r\n        addEdge(dependency, pass);\r\n      }\r\n    }\r\n\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        addEdge(res.producer, consumer);\r\n      }\r\n    }\r\n\r\n    const queue: RGPass<any>[] = [];\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<any>[] = [];\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      const cycleParticipants: string[] = [];\r\n      for (const [pass, degree] of inDegree) {\r\n        if (degree > 0) {\r\n          cycleParticipants.push(pass.name);\r\n        }\r\n      }\r\n      throw new Error(\r\n        `RenderGraph: circular dependency detected. ` +\r\n          `Sorted ${result.length} of ${alivePasses.length} alive passes. ` +\r\n          `Passes in cycle: [${cycleParticipants.join(', ')}]`\r\n      );\r\n    }\r\n\r\n    return result;\r\n  }\r\n\r\n  private _analyzeLifetimes(orderedPasses: RGPass<any>[]): Map<number, RGResourceLifetime> {\r\n    const lifetimes = new Map<number, { resource: RGResource; firstUse: number; lastUse: number }>();\r\n\r\n    const orderMap = new Map<RGPass<any>, 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      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      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    // Attachment textures must outlive every framebuffer use.\r\n    for (const lifetime of lifetimes.values()) {\r\n      const res = lifetime.resource;\r\n      if (res.kind !== 'framebuffer' || !res.desc) {\r\n        continue;\r\n      }\r\n      const desc = res.desc as RGFramebufferDesc;\r\n      const extend = (attachment: unknown) => {\r\n        if (!(attachment instanceof RGHandle)) {\r\n          return;\r\n        }\r\n        const attachmentLifetime = lifetimes.get(attachment._id);\r\n        if (attachmentLifetime) {\r\n          attachmentLifetime.firstUse = Math.min(attachmentLifetime.firstUse, lifetime.firstUse);\r\n          attachmentLifetime.lastUse = Math.max(attachmentLifetime.lastUse, lifetime.lastUse);\r\n        }\r\n      };\r\n      const colors = Array.isArray(desc.colorAttachments)\r\n        ? desc.colorAttachments\r\n        : desc.colorAttachments\r\n          ? [desc.colorAttachments]\r\n          : [];\r\n      for (const attachment of colors) {\r\n        extend(attachment);\r\n      }\r\n      extend(desc.depthAttachment);\r\n    }\r\n\r\n    return lifetimes;\r\n  }\r\n}\r\n"],"names":["RenderGraph","_nextResourceId","_resources","Map","_passes","_compiled","_lastWriterByPhysicalId","_warnedCulledPasses","Set","importTexture","name","id","resource","RGResource","set","RGHandle","addPass","setup","nameOccurrence","existing","pass","RGPass","length","builder","_createBuilder","initialResourceIds","keys","data","push","error","has","delete","values","i","consumers","splice","nextWriter","warDependencies","clear","producer","physicalId","compile","outputs","_validateOutputs","_cullDeadPasses","ordered","_topologicalSort","lifetimes","_analyzeLifetimes","_validateAllocationKeys","orderedPasses","execute","compiled","noopCtx","getTexture","Error","getFramebuffer","createFramebuffer","deferCleanup","subpasses","subpass","executeFn","reset","getResource","handle","get","_id","passes","resources","graph","textureLabelOccurrences","read","res","_declareRead","write","options","kind","discard","load","previousWriter","dependencies","orderingDependencies","includes","consumer","versionName","version","desc","allocationKey","writes","createTexture","undefined","label","labelKey","labelOccurrence","JSON","stringify","createToken","tokenName","_declareFramebufferAttachmentDeps","sideEffect","hasSideEffect","addSubpass","fn","RGSubpass","setExecute","physicalByKey","lifetime","existingPhysicalId","latestVersions","current","latest","alive","neededResources","stack","markResourceNeeded","add","markPassAlive","dep","reads","dependency","pop","console","warn","declare","attachment","colors","Array","isArray","colorAttachments","depthAttachment","alivePasses","filter","p","aliveSet","inDegree","adjacency","addEdge","from","to","neighbors","queue","result","shift","neighbor","deg","cycleParticipants","degree","join","orderMap","first","Infinity","last","idx","Math","min","max","firstUse","lastUse","extend","attachmentLifetime"],"mappings":"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"}

package/dist/render/rendergraph/texture_affinity_cache.js

@@ -1,4 +1,4 @@
-/** A texture and the resolved descriptor it satisfied in the previous execution. */ /** Remembers transient texture identities across executions without owning them. @public */ class RGTextureAffinityCache {
+/** Remembers transient texture identities across executions without owning them. @public */ class RGTextureAffinityCache {
     /** @internal */ _entries = new Map();
     /** Number of logical resources remembered from the last successful execution. */ get size() {
         return this._entries.size;

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

@@ -1 +1 @@
-{"version":3,"file":"texture_affinity_cache.js","sources":["../../../src/render/rendergraph/texture_affinity_cache.ts"],"sourcesContent":["/** A texture and the resolved descriptor it satisfied in the previous execution. */\r\ninterface RGTextureAffinityEntry<TTexture> {\r\n  texture: TTexture;\r\n  descriptorSignature: string;\r\n}\r\n\r\n/** Remembers transient texture identities across executions without owning them. @public */\r\nexport class RGTextureAffinityCache<TTexture = unknown> {\r\n  /** @internal */\r\n  private _entries = new Map<string, RGTextureAffinityEntry<TTexture>>();\r\n\r\n  /** Number of logical resources remembered from the last successful execution. */\r\n  get size(): number {\r\n    return this._entries.size;\r\n  }\r\n\r\n  /** Remove all remembered allocations without releasing the referenced textures. */\r\n  clear(): void {\r\n    this._entries.clear();\r\n  }\r\n\r\n  /** @internal */\r\n  getPreferredTexture(allocationKey: string, descriptorSignature: string): TTexture | undefined {\r\n    const entry = this._entries.get(allocationKey);\r\n    return entry?.descriptorSignature === descriptorSignature ? entry.texture : undefined;\r\n  }\r\n\r\n  /** @internal */\r\n  replace(entries: ReadonlyMap<string, RGTextureAffinityEntry<TTexture>>): void {\r\n    this._entries = new Map(entries);\r\n  }\r\n}\r\n\r\n/** @internal */\r\nexport type { RGTextureAffinityEntry };\r\n"],"names":["RGTextureAffinityCache","_entries","Map","size","clear","getPreferredTexture","allocationKey","descriptorSignature","entry","get","texture","undefined","replace","entries"],"mappings":"AAAA,kLAOO,MAAMA,sBAAAA,CAAAA;AACX,qBACQC,QAAW,GAAA,IAAIC,GAAgD,EAAA;sFAGvE,IAAIC,IAAe,GAAA;AACjB,QAAA,OAAO,IAAI,CAACF,QAAQ,CAACE,IAAI;AAC3B;AAEA,wFACAC,KAAc,GAAA;QACZ,IAAI,CAACH,QAAQ,CAACG,KAAK,EAAA;AACrB;AAEA,qBACAC,mBAAAA,CAAoBC,aAAqB,EAAEC,mBAA2B,EAAwB;AAC5F,QAAA,MAAMC,QAAQ,IAAI,CAACP,QAAQ,CAACQ,GAAG,CAACH,aAAAA,CAAAA;AAChC,QAAA,OAAOE,KAAOD,EAAAA,mBAAAA,KAAwBA,mBAAsBC,GAAAA,KAAAA,CAAME,OAAO,GAAGC,SAAAA;AAC9E;qBAGAC,OAAQC,CAAAA,OAA8D,EAAQ;AAC5E,QAAA,IAAI,CAACZ,QAAQ,GAAG,IAAIC,GAAIW,CAAAA,OAAAA,CAAAA;AAC1B;AACF;;;;"}
+{"version":3,"file":"texture_affinity_cache.js","sources":["../../../src/render/rendergraph/texture_affinity_cache.ts"],"sourcesContent":["import type { BaseTexture } from '@zephyr3d/device';\r\n\r\n/** A texture and the resolved descriptor it satisfied in the previous execution. */\r\ninterface RGTextureAffinityEntry<TTexture> {\r\n  texture: TTexture;\r\n  descriptorSignature: string;\r\n}\r\n\r\n/** Remembers transient texture identities across executions without owning them. @public */\r\nexport class RGTextureAffinityCache<TTexture = BaseTexture> {\r\n  /** @internal */\r\n  private _entries = new Map<string, RGTextureAffinityEntry<TTexture>>();\r\n\r\n  /** Number of logical resources remembered from the last successful execution. */\r\n  get size(): number {\r\n    return this._entries.size;\r\n  }\r\n\r\n  /** Remove all remembered allocations without releasing the referenced textures. */\r\n  clear(): void {\r\n    this._entries.clear();\r\n  }\r\n\r\n  /** @internal */\r\n  getPreferredTexture(allocationKey: string, descriptorSignature: string): TTexture | undefined {\r\n    const entry = this._entries.get(allocationKey);\r\n    return entry?.descriptorSignature === descriptorSignature ? entry.texture : undefined;\r\n  }\r\n\r\n  /** @internal */\r\n  replace(entries: ReadonlyMap<string, RGTextureAffinityEntry<TTexture>>): void {\r\n    this._entries = new Map(entries);\r\n  }\r\n}\r\n\r\n/** @internal */\r\nexport type { RGTextureAffinityEntry };\r\n"],"names":["RGTextureAffinityCache","_entries","Map","size","clear","getPreferredTexture","allocationKey","descriptorSignature","entry","get","texture","undefined","replace","entries"],"mappings":"AAQA,6FACO,MAAMA,sBAAAA,CAAAA;AACX,qBACQC,QAAW,GAAA,IAAIC,GAAgD,EAAA;sFAGvE,IAAIC,IAAe,GAAA;AACjB,QAAA,OAAO,IAAI,CAACF,QAAQ,CAACE,IAAI;AAC3B;AAEA,wFACAC,KAAc,GAAA;QACZ,IAAI,CAACH,QAAQ,CAACG,KAAK,EAAA;AACrB;AAEA,qBACAC,mBAAAA,CAAoBC,aAAqB,EAAEC,mBAA2B,EAAwB;AAC5F,QAAA,MAAMC,QAAQ,IAAI,CAACP,QAAQ,CAACQ,GAAG,CAACH,aAAAA,CAAAA;AAChC,QAAA,OAAOE,KAAOD,EAAAA,mBAAAA,KAAwBA,mBAAsBC,GAAAA,KAAAA,CAAME,OAAO,GAAGC,SAAAA;AAC9E;qBAGAC,OAAQC,CAAAA,OAA8D,EAAQ;AAC5E,QAAA,IAAI,CAACZ,QAAQ,GAAG,IAAIC,GAAIW,CAAAA,OAAAA,CAAAA;AAC1B;AACF;;;;"}

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

@@ -1 +1 @@
-{"version":3,"file":"types.js","sources":["../../../src/render/rendergraph/types.ts"],"sourcesContent":["import type { AbstractDevice, TextureFormat, TimestampQueryStatus } from '@zephyr3d/device';\r\nimport type { RGTextureAffinityCache } from './texture_affinity_cache';\r\n\r\n/**\r\n * Texture size mode: fixed pixels or a backbuffer-relative scale. @public\r\n */\r\nexport type RGSizeMode = 'absolute' | 'backbuffer-relative';\r\n\r\n/** Descriptor for a graph-managed transient texture. @public */\r\nexport interface RGTextureDesc {\r\n  /** Debug label for this resource. */\r\n  label?: string;\r\n  /**\r\n   * Stable identity used to prefer the same pooled texture across graph executions.\r\n   * When omitted, the graph derives one from the declaring pass and resource label.\r\n   */\r\n  allocationKey?: string;\r\n  /** Texture format. */\r\n  format: TextureFormat;\r\n  /** Sizing mode. Default 'backbuffer-relative'. */\r\n  sizeMode?: RGSizeMode;\r\n  /** Pixel width or backbuffer scale. Default 1. */\r\n  width?: number;\r\n  /** Pixel height or backbuffer scale. Default 1. */\r\n  height?: number;\r\n  /** Number of mip levels. Default 1. */\r\n  mipLevels?: number;\r\n  /** Array layers. Any defined value, including 1, requests a 2D array texture. */\r\n  arrayLayers?: number;\r\n}\r\n\r\n/** Resource kinds that can be referenced by a graph handle. @public */\r\nexport type RGHandleKind = 'texture' | 'framebuffer' | 'token';\r\n\r\n/** Opaque render graph resource handle. @public */\r\nexport class RGHandle<K extends RGHandleKind = RGHandleKind, TValue = unknown> {\r\n  /** Compile-time backing resource type. */\r\n  declare readonly _value: TValue;\r\n  /** @internal */\r\n  readonly _id: number;\r\n  /** @internal */\r\n  readonly _name: string;\r\n  /** Resource kind used for compile-time and runtime validation. */\r\n  readonly kind: K;\r\n\r\n  /** @internal */\r\n  constructor(id: number, name: string, kind: K = 'texture' as K) {\r\n    this._id = id;\r\n    this._name = name;\r\n    this.kind = kind;\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/** Texture resource handle. @public */\r\nexport type RGTextureHandle<TTexture = unknown> = RGHandle<'texture', TTexture>;\r\n\r\n/** Framebuffer resource handle. @public */\r\nexport type RGFramebufferHandle<TFramebuffer = unknown> = RGHandle<'framebuffer', TFramebuffer>;\r\n\r\n/** Ordering-only resource handle. @public */\r\nexport type RGTokenHandle = RGHandle<'token', void>;\r\n\r\n/** @public */\r\nexport type RGResourceKind = 'transient' | 'imported' | 'token' | 'framebuffer';\r\n\r\n/** Render graph resource metadata. @public */\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  /** Stable identity used for cross-frame transient texture allocation affinity. */\r\n  readonly allocationKey: string | null;\r\n  /** The pass that creates / writes this resource (null for imported until written). */\r\n  producer: RGPass<any> | null = null;\r\n  /** The pass that superseded this version via write(), or null while latest. */\r\n  nextWriter: RGPass<any> | null = null;\r\n  /** Passes that read this resource. */\r\n  readonly consumers: RGPass<any>[] = [];\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    allocationKey: string | null = null\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    this.allocationKey = allocationKey;\r\n  }\r\n}\r\n\r\n/** Resolves resources during pass execution. @public */\r\nexport interface RGExecuteContext {\r\n  /**\r\n   * Resolve a declared texture handle. Imported textures must first be bound on\r\n   * the executor.\r\n   */\r\n  getTexture<TTexture>(handle: RGTextureHandle<TTexture>): TTexture;\r\n  /** Resolve a texture handle stored in a generic resource container. */\r\n  getTexture<TTexture = unknown>(handle: RGHandle<RGHandleKind, any>): TTexture;\r\n\r\n  /** Resolve a framebuffer declared or created by the current pass. */\r\n  getFramebuffer<TFramebuffer>(handle: RGFramebufferHandle<TFramebuffer>): TFramebuffer;\r\n  /** Resolve a framebuffer handle stored in a generic resource container. */\r\n  getFramebuffer<TFramebuffer = unknown>(handle: RGHandle<RGHandleKind, any>): TFramebuffer;\r\n\r\n  /**\r\n   * Create a temporary framebuffer released after execution. Handle attachments\r\n   * must be declared by the current pass.\r\n   */\r\n  createFramebuffer<TFramebuffer = unknown>(desc: RGFramebufferDesc): TFramebuffer;\r\n\r\n  /**\r\n   * Run cleanup after execution or abort. Callbacks run in reverse order.\r\n   */\r\n  deferCleanup(callback: () => void): void;\r\n}\r\n\r\n/** Render graph execute callback. @public */\r\nexport type RGExecuteFn<T = void> = (ctx: RGExecuteContext, data: T) => void;\r\n\r\n/** Ordered step sharing its parent pass's resources and lifetime. @public */\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/** Controls whether a write needs the previous resource contents. @public */\r\nexport interface RGWriteOptions {\r\n  /**\r\n   * Use `discard` for a full overwrite so old-content producers may be culled.\r\n   * Default `load`.\r\n   */\r\n  load?: 'load' | 'discard';\r\n}\r\n\r\n/** Render graph pass metadata. @public */\r\nexport class RGPass<T = void> {\r\n  readonly index: number;\r\n  readonly name: string;\r\n  /** Occurrence of this pass name within the graph, used for stable allocation keys. */\r\n  readonly nameOccurrence: number;\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  /**\r\n   * RAW/WAW predecessors that propagate liveness.\r\n   */\r\n  readonly dependencies: RGPass<any>[] = [];\r\n  /** WAW predecessors used only for ordering, including discard writes. */\r\n  readonly orderingDependencies: RGPass<any>[] = [];\r\n  /** WAR predecessors used only when both passes are alive. */\r\n  readonly warDependencies: RGPass<any>[] = [];\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, nameOccurrence = 0) {\r\n    this.index = index;\r\n    this.name = name;\r\n    this.nameOccurrence = nameOccurrence;\r\n  }\r\n}\r\n\r\n/** Declares a pass's resource access and execution callback. @public */\r\nexport interface RGPassBuilder<TData = any> {\r\n  /** Declare a read of an existing resource. */\r\n  read(handle: RGHandle): void;\r\n\r\n  /**\r\n   * Write a new resource version. Use the returned handle for later reads and\r\n   * graph outputs. `discard` permits old-content producers to be culled.\r\n   */\r\n  write<TTexture>(handle: RGTextureHandle<TTexture>, options?: RGWriteOptions): RGTextureHandle<TTexture>;\r\n\r\n  /** Generic-container fallback; runtime validation still applies. */\r\n  write(handle: RGHandle, options?: RGWriteOptions): RGTextureHandle;\r\n\r\n  /** Create a transient texture produced by this pass. */\r\n  createTexture<TTexture = unknown>(desc: RGTextureDesc): RGTextureHandle<TTexture>;\r\n\r\n  /** Create a logical token for ordering passes without resource dependencies. */\r\n  createToken(name?: string): RGTokenHandle;\r\n\r\n  /** Create a graph-managed framebuffer and infer attachment dependencies. */\r\n  createFramebuffer<TFramebuffer = unknown>(desc: RGFramebufferDesc): RGFramebufferHandle<TFramebuffer>;\r\n\r\n  /** Prevent this pass from being culled. */\r\n  sideEffect(): void;\r\n\r\n  /** Add an ordered subpass. Cannot be combined with {@link setExecute}. */\r\n  addSubpass<D = TData>(name: string, fn: RGExecuteFn<D>): void;\r\n\r\n  /** Set the pass callback. Cannot be combined with {@link addSubpass}. */\r\n  setExecute<D = TData>(fn: RGExecuteFn<D>): void;\r\n}\r\n\r\n/** Compiled resource lifetime. @public */\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/** Ordered passes and resource lifetimes from graph compilation. @public */\r\nexport interface CompiledRenderGraph {\r\n  /** Topologically sorted passes (only non-culled passes). */\r\n  readonly orderedPasses: ReadonlyArray<RGPass<any>>;\r\n  /** Resource lifetime information keyed by resource ID. */\r\n  readonly lifetimes: ReadonlyMap<number, RGResourceLifetime>;\r\n}\r\n\r\n/** Profiling scope type. @public */\r\nexport type RGProfileScopeType = 'graph' | 'pass' | 'subpass';\r\n\r\n/** GPU timestamp profiling options. @public */\r\nexport interface RGProfilingOptions {\r\n  /** Enable render graph timestamp profiling. Default true when an options object is provided. */\r\n  enabled?: boolean;\r\n  /** Measure the whole graph execution. Default true. */\r\n  graph?: boolean;\r\n  /** Measure every render graph pass. Default true. */\r\n  pass?: boolean;\r\n  /** Measure every subpass and expose it as a child scope. Default true. */\r\n  subpass?: boolean;\r\n  /** Include pending upload/copy commands at timestamp boundaries. Default true. */\r\n  includePendingUploads?: boolean;\r\n  /** Allow graph profile scopes to remain open across frame boundaries. Default false. */\r\n  allowCrossFrame?: boolean;\r\n  /** Maximum unresolved profile frames kept by the executor. Default 3. */\r\n  maxPendingFrames?: number;\r\n  /** Root graph profile label. Default 'RenderGraph'. */\r\n  label?: string;\r\n  /** Device used for timestamp queries. If omitted, the scene global getDevice() is used. */\r\n  device?: AbstractDevice;\r\n}\r\n\r\n/** Render graph executor options. @public */\r\nexport interface RenderGraphExecutorOptions<TTexture = unknown> {\r\n  /** Device used for timestamp queries. If omitted, the scene global getDevice() is used. */\r\n  device?: AbstractDevice;\r\n  /** Render graph timestamp profiling options. Default false. */\r\n  profiling?: boolean | RGProfilingOptions;\r\n  /** Cross-execution affinity state used to stabilize transient texture identities. */\r\n  textureAffinityCache?: RGTextureAffinityCache<TTexture>;\r\n}\r\n\r\n/** External resources bound for one graph execution. @public */\r\nexport interface RenderGraphExecutionBindings<TTexture = unknown> {\r\n  /** Imported graph texture handles and their physical textures. */\r\n  readonly importedTextures?: ReadonlyMap<RGTextureHandle<TTexture>, TTexture>;\r\n}\r\n\r\n/** Resolved GPU timing for one scope. @public */\r\nexport interface RGProfileScopeResult {\r\n  /** Scope label. */\r\n  name: string;\r\n  /** Scope type. */\r\n  type: RGProfileScopeType;\r\n  /** Timestamp query id used by the device, or 0 for synthetic/unsupported scopes. */\r\n  queryId: number;\r\n  /** GPU duration in milliseconds. */\r\n  durationMs: number;\r\n  /** Timestamp result status. */\r\n  status: TimestampQueryStatus;\r\n  /** Child scopes. */\r\n  children: RGProfileScopeResult[];\r\n  /** Optional diagnostic message. */\r\n  message?: string;\r\n}\r\n\r\n/** GPU timing tree for one graph execution. @public */\r\nexport interface RGProfileResult {\r\n  /** Render frame id when profiling began. */\r\n  frameId: number;\r\n  /** Aggregate profile status. */\r\n  status: TimestampQueryStatus;\r\n  /** Root graph scope. */\r\n  graph: RGProfileScopeResult;\r\n  /** Top-level pass scopes. Same objects as graph.children. */\r\n  passes: RGProfileScopeResult[];\r\n}\r\n\r\n/** Resolved texture dimensions. @public */\r\nexport interface RGResolvedSize {\r\n  width: number;\r\n  height: number;\r\n}\r\n\r\nexport type RGTextureAttachment<TTexture = unknown> = RGTextureHandle<TTexture> | TTexture | TextureFormat;\r\n\r\n/** Backend-independent framebuffer descriptor. @public */\r\nexport interface RGFramebufferDesc<TTexture = unknown> {\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: RGTextureAttachment<TTexture> | RGTextureAttachment<TTexture>[] | null;\r\n  /** Depth/stencil attachment or format. */\r\n  depthAttachment?: RGTextureAttachment<TTexture> | 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 * Framebuffers are released before their attachments at the same pass boundary.\r\n * A released framebuffer must retain its attachments until texture release.\r\n *\r\n * @public\r\n */\r\nexport interface RGTextureAllocator<TTexture = unknown, TFramebuffer = unknown> {\r\n  /** Allocate a transient texture, preferring a compatible prior allocation. */\r\n  allocate(desc: RGTextureDesc, size: RGResolvedSize, preferred?: TTexture): TTexture;\r\n\r\n  /** Release a transient texture. */\r\n  release(texture: TTexture): void;\r\n\r\n  /**\r\n   * Retain a transient texture beyond graph execution. The external owner must\r\n   * later release it.\r\n   */\r\n  retain?(texture: TTexture): void;\r\n\r\n  /** Allocate a framebuffer released by the executor. */\r\n  allocateFramebuffer?(desc: RGFramebufferDesc): TFramebuffer;\r\n\r\n  /** Release a temporary framebuffer. */\r\n  releaseFramebuffer?(framebuffer: TFramebuffer): void;\r\n}\r\n"],"names":["RGHandle","id","name","kind","_id","_name","RGResource","desc","producer","nextWriter","consumers","physicalId","allocationKey","RGSubpass","executeFn","RGPass","index","reads","writes","dependencies","orderingDependencies","warDependencies","hasSideEffect","data","subpasses","alive","nameOccurrence"],"mappings":"AAkCA,oDACO,MAAMA,QAAAA,CAAAA;qBAIX,GAAqB;qBAErB,KAAuB;uEAEvB,IAAiB;qBAGjB,YAAYC,EAAU,EAAEC,IAAY,EAAEC,IAAAA,GAAU,SAAc,CAAE;QAC9D,IAAI,CAACC,GAAG,GAAGH,EAAAA;QACX,IAAI,CAACI,KAAK,GAAGH,IAAAA;QACb,IAAI,CAACC,IAAI,GAAGA,IAAAA;AACd;2DAGA,IAAID,IAAe,GAAA;QACjB,OAAO,IAAI,CAACG,KAAK;AACnB;AACF;AAcA,+CACO,MAAMC,UAAAA,CAAAA;IACFL,EAAW;IACXC,IAAa;IACbC,IAAqB;IACrBI,IAA+C;mFAExD,UAA4B;uFAE5B,aAAsC;2FAEtCC,WAA+B,IAAK;oFAEpCC,aAAiC,IAAK;AACtC,2CACSC,SAA2B,GAAA,EAAE;AAEtC,IAAA,WAAA,CACET,EAAU,EACVC,IAAY,EACZC,IAAoB,EACpBI,IAA8C,EAC9CI,UAAaV,GAAAA,EAAE,EACfW,aAAAA,GAA+B,IAAI,CACnC;QACA,IAAI,CAACX,EAAE,GAAGA,EAAAA;QACV,IAAI,CAACC,IAAI,GAAGA,IAAAA;QACZ,IAAI,CAACC,IAAI,GAAGA,IAAAA;QACZ,IAAI,CAACI,IAAI,GAAGA,IAAAA;QACZ,IAAI,CAACI,UAAU,GAAGA,UAAAA;QAClB,IAAI,CAACC,aAAa,GAAGA,aAAAA;AACvB;AACF;AAgCA,8EACO,MAAMC,SAAAA,CAAAA;IACFX,IAAa;IACbY,SAA0B;IAEnC,WAAYZ,CAAAA,IAAY,EAAEY,SAAyB,CAAE;QACnD,IAAI,CAACZ,IAAI,GAAGA,IAAAA;QACZ,IAAI,CAACY,SAAS,GAAGA,SAAAA;AACnB;AACF;AAWA,2CACO,MAAMC,MAAAA,CAAAA;IACFC,KAAc;IACdd,IAAa;2FAEtB,cAAgC;AAChC,qDACSe,KAAsB,GAAA,EAAE;AACjC,kDACSC,MAAuB,GAAA,EAAE;AAClC;;MAGSC,YAA8B,GAAA,EAAE;AACzC,8EACSC,oBAAsC,GAAA,EAAE;AACjD,kEACSC,eAAiC,GAAA,EAAE;sEAE5CC,gBAAgB,KAAM;uDAEtBC,OAAiB,IAAK;6BAEtBT,YAAmC,IAAK;AACxC,+EACSU,SAA4B,GAAA,EAAE;gEAEvCC,QAAQ,IAAK;AAEb,IAAA,WAAA,CAAYT,KAAa,EAAEd,IAAY,EAAEwB,cAAAA,GAAiB,CAAC,CAAE;QAC3D,IAAI,CAACV,KAAK,GAAGA,KAAAA;QACb,IAAI,CAACd,IAAI,GAAGA,IAAAA;QACZ,IAAI,CAACwB,cAAc,GAAGA,cAAAA;AACxB;AACF;;;;"}
+{"version":3,"file":"types.js","sources":["../../../src/render/rendergraph/types.ts"],"sourcesContent":["import type {\r\n  AbstractDevice,\r\n  BaseTexture,\r\n  FrameBuffer,\r\n  TextureFormat,\r\n  TimestampQueryStatus\r\n} from '@zephyr3d/device';\r\nimport type { RGTextureAffinityCache } from './texture_affinity_cache';\r\n\r\n/**\r\n * Texture size mode: fixed pixels or a backbuffer-relative scale. @public\r\n */\r\nexport type RGSizeMode = 'absolute' | 'backbuffer-relative';\r\n\r\n/** Descriptor for a graph-managed transient texture. @public */\r\nexport interface RGTextureDesc {\r\n  /** Debug label for this resource. */\r\n  label?: string;\r\n  /**\r\n   * Stable identity used to prefer the same pooled texture across graph executions.\r\n   * When omitted, the graph derives one from the declaring pass and resource label.\r\n   */\r\n  allocationKey?: string;\r\n  /** Texture format. */\r\n  format: TextureFormat;\r\n  /** Sizing mode. Default 'backbuffer-relative'. */\r\n  sizeMode?: RGSizeMode;\r\n  /** Pixel width or backbuffer scale. Default 1. */\r\n  width?: number;\r\n  /** Pixel height or backbuffer scale. Default 1. */\r\n  height?: number;\r\n  /** Number of mip levels. Default 1. */\r\n  mipLevels?: number;\r\n  /** Array layers. Any defined value, including 1, requests a 2D array texture. */\r\n  arrayLayers?: number;\r\n}\r\n\r\n/** Resource kinds that can be referenced by a graph handle. @public */\r\nexport type RGHandleKind = 'texture' | 'framebuffer' | 'token';\r\n\r\n/** Opaque render graph resource handle. @public */\r\nexport class RGHandle<K extends RGHandleKind = RGHandleKind, TValue = unknown> {\r\n  /** Compile-time backing resource type. */\r\n  declare readonly _value: TValue;\r\n  /** @internal */\r\n  readonly _id: number;\r\n  /** @internal */\r\n  readonly _name: string;\r\n  /** Resource kind used for compile-time and runtime validation. */\r\n  readonly kind: K;\r\n\r\n  /** @internal */\r\n  constructor(id: number, name: string, kind: K = 'texture' as K) {\r\n    this._id = id;\r\n    this._name = name;\r\n    this.kind = kind;\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/** Texture resource handle. @public */\r\nexport type RGTextureHandle<TTexture = BaseTexture> = RGHandle<'texture', TTexture>;\r\n\r\n/** Framebuffer resource handle. @public */\r\nexport type RGFramebufferHandle = RGHandle<'framebuffer', FrameBuffer>;\r\n\r\n/** Ordering-only resource handle. @public */\r\nexport type RGTokenHandle = RGHandle<'token', void>;\r\n\r\n/** @public */\r\nexport type RGResourceKind = 'transient' | 'imported' | 'token' | 'framebuffer';\r\n\r\n/** Render graph resource metadata. @public */\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  /** Stable identity used for cross-frame transient texture allocation affinity. */\r\n  readonly allocationKey: string | null;\r\n  /** The pass that creates / writes this resource (null for imported until written). */\r\n  producer: RGPass<any> | null = null;\r\n  /** The pass that superseded this version via write(), or null while latest. */\r\n  nextWriter: RGPass<any> | null = null;\r\n  /** Passes that read this resource. */\r\n  readonly consumers: RGPass<any>[] = [];\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    allocationKey: string | null = null\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    this.allocationKey = allocationKey;\r\n  }\r\n}\r\n\r\n/** Resolves resources during pass execution. @public */\r\nexport interface RGExecuteContext {\r\n  /**\r\n   * Resolve a declared texture handle. Imported textures must first be bound on\r\n   * the executor.\r\n   */\r\n  getTexture<TTexture>(handle: RGTextureHandle<TTexture>): TTexture;\r\n  /** Resolve a texture handle stored in a generic resource container. */\r\n  getTexture<TTexture = BaseTexture>(handle: RGHandle<RGHandleKind, any>): TTexture;\r\n\r\n  /** Resolve a framebuffer declared or created by the current pass. */\r\n  getFramebuffer(handle: RGFramebufferHandle): FrameBuffer;\r\n  /** Resolve a framebuffer handle stored in a generic resource container. */\r\n  getFramebuffer(handle: RGHandle<RGHandleKind, any>): FrameBuffer;\r\n\r\n  /**\r\n   * Create a temporary framebuffer released after execution. Handle attachments\r\n   * must be declared by the current pass.\r\n   */\r\n  createFramebuffer(desc: RGFramebufferDesc): FrameBuffer;\r\n\r\n  /**\r\n   * Run cleanup after execution or abort. Callbacks run in reverse order.\r\n   */\r\n  deferCleanup(callback: () => void): void;\r\n}\r\n\r\n/** Render graph execute callback. @public */\r\nexport type RGExecuteFn<T = void> = (ctx: RGExecuteContext, data: T) => void;\r\n\r\n/** Ordered step sharing its parent pass's resources and lifetime. @public */\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/** Controls whether a write needs the previous resource contents. @public */\r\nexport interface RGWriteOptions {\r\n  /**\r\n   * Use `discard` for a full overwrite so old-content producers may be culled.\r\n   * Default `load`.\r\n   */\r\n  load?: 'load' | 'discard';\r\n}\r\n\r\n/** Render graph pass metadata. @public */\r\nexport class RGPass<T = void> {\r\n  readonly index: number;\r\n  readonly name: string;\r\n  /** Occurrence of this pass name within the graph, used for stable allocation keys. */\r\n  readonly nameOccurrence: number;\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  /**\r\n   * RAW/WAW predecessors that propagate liveness.\r\n   */\r\n  readonly dependencies: RGPass<any>[] = [];\r\n  /** WAW predecessors used only for ordering, including discard writes. */\r\n  readonly orderingDependencies: RGPass<any>[] = [];\r\n  /** WAR predecessors used only when both passes are alive. */\r\n  readonly warDependencies: RGPass<any>[] = [];\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, nameOccurrence = 0) {\r\n    this.index = index;\r\n    this.name = name;\r\n    this.nameOccurrence = nameOccurrence;\r\n  }\r\n}\r\n\r\n/** Declares a pass's resource access and execution callback. @public */\r\nexport interface RGPassBuilder<TData = any> {\r\n  /** Declare a read of an existing resource. */\r\n  read(handle: RGHandle): void;\r\n\r\n  /**\r\n   * Write a new resource version. Use the returned handle for later reads and\r\n   * graph outputs. `discard` permits old-content producers to be culled.\r\n   */\r\n  write<TTexture>(handle: RGTextureHandle<TTexture>, options?: RGWriteOptions): RGTextureHandle<TTexture>;\r\n\r\n  /** Generic-container fallback; runtime validation still applies. */\r\n  write(handle: RGHandle, options?: RGWriteOptions): RGTextureHandle;\r\n\r\n  /** Create a transient texture produced by this pass. */\r\n  createTexture<TTexture = BaseTexture>(desc: RGTextureDesc): RGTextureHandle<TTexture>;\r\n\r\n  /** Create a logical token for ordering passes without resource dependencies. */\r\n  createToken(name?: string): RGTokenHandle;\r\n\r\n  /** Create a graph-managed framebuffer and infer attachment dependencies. */\r\n  createFramebuffer(desc: RGFramebufferDesc): RGFramebufferHandle;\r\n\r\n  /** Prevent this pass from being culled. */\r\n  sideEffect(): void;\r\n\r\n  /** Add an ordered subpass. Cannot be combined with {@link setExecute}. */\r\n  addSubpass<D = TData>(name: string, fn: RGExecuteFn<D>): void;\r\n\r\n  /** Set the pass callback. Cannot be combined with {@link addSubpass}. */\r\n  setExecute<D = TData>(fn: RGExecuteFn<D>): void;\r\n}\r\n\r\n/** Compiled resource lifetime. @public */\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/** Ordered passes and resource lifetimes from graph compilation. @public */\r\nexport interface CompiledRenderGraph {\r\n  /** Topologically sorted passes (only non-culled passes). */\r\n  readonly orderedPasses: ReadonlyArray<RGPass<any>>;\r\n  /** Resource lifetime information keyed by resource ID. */\r\n  readonly lifetimes: ReadonlyMap<number, RGResourceLifetime>;\r\n}\r\n\r\n/** Profiling scope type. @public */\r\nexport type RGProfileScopeType = 'graph' | 'pass' | 'subpass';\r\n\r\n/** GPU timestamp profiling options. @public */\r\nexport interface RGProfilingOptions {\r\n  /** Enable render graph timestamp profiling. Default true when an options object is provided. */\r\n  enabled?: boolean;\r\n  /** Measure the whole graph execution. Default true. */\r\n  graph?: boolean;\r\n  /** Measure every render graph pass. Default true. */\r\n  pass?: boolean;\r\n  /** Measure every subpass and expose it as a child scope. Default true. */\r\n  subpass?: boolean;\r\n  /** Include pending upload/copy commands at timestamp boundaries. Default true. */\r\n  includePendingUploads?: boolean;\r\n  /** Allow graph profile scopes to remain open across frame boundaries. Default false. */\r\n  allowCrossFrame?: boolean;\r\n  /** Maximum unresolved profile frames kept by the executor. Default 3. */\r\n  maxPendingFrames?: number;\r\n  /** Root graph profile label. Default 'RenderGraph'. */\r\n  label?: string;\r\n  /** Device used for timestamp queries. If omitted, the scene global getDevice() is used. */\r\n  device?: AbstractDevice;\r\n}\r\n\r\n/** Render graph executor options. @public */\r\nexport interface RenderGraphExecutorOptions<TTexture = BaseTexture> {\r\n  /** Device used for timestamp queries. If omitted, the scene global getDevice() is used. */\r\n  device?: AbstractDevice;\r\n  /** Render graph timestamp profiling options. Default false. */\r\n  profiling?: boolean | RGProfilingOptions;\r\n  /** Cross-execution affinity state used to stabilize transient texture identities. */\r\n  textureAffinityCache?: RGTextureAffinityCache<TTexture>;\r\n}\r\n\r\n/** External resources bound for one graph execution. @public */\r\nexport interface RenderGraphExecutionBindings<TTexture = BaseTexture> {\r\n  /** Imported graph texture handles and their physical textures. */\r\n  readonly importedTextures?: ReadonlyMap<RGTextureHandle<TTexture>, TTexture>;\r\n}\r\n\r\n/** Resolved GPU timing for one scope. @public */\r\nexport interface RGProfileScopeResult {\r\n  /** Scope label. */\r\n  name: string;\r\n  /** Scope type. */\r\n  type: RGProfileScopeType;\r\n  /** Timestamp query id used by the device, or 0 for synthetic/unsupported scopes. */\r\n  queryId: number;\r\n  /** GPU duration in milliseconds. */\r\n  durationMs: number;\r\n  /** Timestamp result status. */\r\n  status: TimestampQueryStatus;\r\n  /** Child scopes. */\r\n  children: RGProfileScopeResult[];\r\n  /** Optional diagnostic message. */\r\n  message?: string;\r\n}\r\n\r\n/** GPU timing tree for one graph execution. @public */\r\nexport interface RGProfileResult {\r\n  /** Render frame id when profiling began. */\r\n  frameId: number;\r\n  /** Aggregate profile status. */\r\n  status: TimestampQueryStatus;\r\n  /** Root graph scope. */\r\n  graph: RGProfileScopeResult;\r\n  /** Top-level pass scopes. Same objects as graph.children. */\r\n  passes: RGProfileScopeResult[];\r\n}\r\n\r\n/** Resolved texture dimensions. @public */\r\nexport interface RGResolvedSize {\r\n  width: number;\r\n  height: number;\r\n}\r\n\r\nexport type RGTextureAttachment<TTexture = BaseTexture> =\r\n  | RGTextureHandle<TTexture>\r\n  | TTexture\r\n  | TextureFormat;\r\n\r\n/** Backend-independent framebuffer descriptor. @public */\r\nexport interface RGFramebufferDesc<TTexture = BaseTexture> {\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: RGTextureAttachment<TTexture> | RGTextureAttachment<TTexture>[] | null;\r\n  /** Depth/stencil attachment or format. */\r\n  depthAttachment?: RGTextureAttachment<TTexture> | 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 * Framebuffers are released before their attachments at the same pass boundary.\r\n * A released framebuffer must retain its attachments until texture release.\r\n *\r\n * @public\r\n */\r\nexport interface RGTextureAllocator<TTexture = BaseTexture> {\r\n  /** Allocate a transient texture, preferring a compatible prior allocation. */\r\n  allocate(desc: RGTextureDesc, size: RGResolvedSize, preferred?: TTexture): TTexture;\r\n\r\n  /** Release a transient texture. */\r\n  release(texture: TTexture): void;\r\n\r\n  /**\r\n   * Retain a transient texture beyond graph execution. The external owner must\r\n   * later release it.\r\n   */\r\n  retain?(texture: TTexture): void;\r\n\r\n  /** Allocate a framebuffer released by the executor. */\r\n  allocateFramebuffer?(desc: RGFramebufferDesc): FrameBuffer;\r\n\r\n  /** Release a temporary framebuffer. */\r\n  releaseFramebuffer?(framebuffer: FrameBuffer): void;\r\n}\r\n"],"names":["RGHandle","id","name","kind","_id","_name","RGResource","desc","producer","nextWriter","consumers","physicalId","allocationKey","RGSubpass","executeFn","RGPass","index","reads","writes","dependencies","orderingDependencies","warDependencies","hasSideEffect","data","subpasses","alive","nameOccurrence"],"mappings":"AAwCA,oDACO,MAAMA,QAAAA,CAAAA;qBAIX,GAAqB;qBAErB,KAAuB;uEAEvB,IAAiB;qBAGjB,YAAYC,EAAU,EAAEC,IAAY,EAAEC,IAAAA,GAAU,SAAc,CAAE;QAC9D,IAAI,CAACC,GAAG,GAAGH,EAAAA;QACX,IAAI,CAACI,KAAK,GAAGH,IAAAA;QACb,IAAI,CAACC,IAAI,GAAGA,IAAAA;AACd;2DAGA,IAAID,IAAe,GAAA;QACjB,OAAO,IAAI,CAACG,KAAK;AACnB;AACF;AAcA,+CACO,MAAMC,UAAAA,CAAAA;IACFL,EAAW;IACXC,IAAa;IACbC,IAAqB;IACrBI,IAA+C;mFAExD,UAA4B;uFAE5B,aAAsC;2FAEtCC,WAA+B,IAAK;oFAEpCC,aAAiC,IAAK;AACtC,2CACSC,SAA2B,GAAA,EAAE;AAEtC,IAAA,WAAA,CACET,EAAU,EACVC,IAAY,EACZC,IAAoB,EACpBI,IAA8C,EAC9CI,UAAaV,GAAAA,EAAE,EACfW,aAAAA,GAA+B,IAAI,CACnC;QACA,IAAI,CAACX,EAAE,GAAGA,EAAAA;QACV,IAAI,CAACC,IAAI,GAAGA,IAAAA;QACZ,IAAI,CAACC,IAAI,GAAGA,IAAAA;QACZ,IAAI,CAACI,IAAI,GAAGA,IAAAA;QACZ,IAAI,CAACI,UAAU,GAAGA,UAAAA;QAClB,IAAI,CAACC,aAAa,GAAGA,aAAAA;AACvB;AACF;AAgCA,8EACO,MAAMC,SAAAA,CAAAA;IACFX,IAAa;IACbY,SAA0B;IAEnC,WAAYZ,CAAAA,IAAY,EAAEY,SAAyB,CAAE;QACnD,IAAI,CAACZ,IAAI,GAAGA,IAAAA;QACZ,IAAI,CAACY,SAAS,GAAGA,SAAAA;AACnB;AACF;AAWA,2CACO,MAAMC,MAAAA,CAAAA;IACFC,KAAc;IACdd,IAAa;2FAEtB,cAAgC;AAChC,qDACSe,KAAsB,GAAA,EAAE;AACjC,kDACSC,MAAuB,GAAA,EAAE;AAClC;;MAGSC,YAA8B,GAAA,EAAE;AACzC,8EACSC,oBAAsC,GAAA,EAAE;AACjD,kEACSC,eAAiC,GAAA,EAAE;sEAE5CC,gBAAgB,KAAM;uDAEtBC,OAAiB,IAAK;6BAEtBT,YAAmC,IAAK;AACxC,+EACSU,SAA4B,GAAA,EAAE;gEAEvCC,QAAQ,IAAK;AAEb,IAAA,WAAA,CAAYT,KAAa,EAAEd,IAAY,EAAEwB,cAAAA,GAAiB,CAAC,CAAE;QAC3D,IAAI,CAACV,KAAK,GAAGA,KAAAA;QACb,IAAI,CAACd,IAAI,GAAGA,IAAAA;QACZ,IAAI,CAACwB,cAAc,GAAGA,cAAAA;AACxB;AACF;;;;"}

package/dist/render/shadow_mask_pass.js

@@ -1,7 +1,7 @@
 import { Vector2, Vector4, DEPTH_FARTHEST } from '@zephyr3d/base';
 import { ShaderHelper } from '../material/shader/helper.js';
 import { drawFullscreenQuad } from './fullscreenquad.js';
-import { MAX_SHADOW_MASK_LIGHTS } from '../values.js';
+import { MAX_SHADOW_MASK_LIGHTS, LIGHT_TYPE_DIRECTIONAL } from '../values.js';
 import { fetchSampler } from '../utility/misc.js';
 
 const UNIFORM_NAME_SHADOW_MAP = 'Z_UniformShadowMap';
@@ -33,6 +33,7 @@ const UNIFORM_NAME_SHADOW_MAP = 'Z_UniformShadowMap';
     /** Bind groups paired with each cached program. */ _bindGroups;
     /** One render state per RGBA channel (color mask selects the target channel). */ _channelStates;
     _nearFar;
+    _invRenderSize;
     _cameraPosition;
     _cameraParams;
     constructor(){
@@ -40,6 +41,7 @@ const UNIFORM_NAME_SHADOW_MAP = 'Z_UniformShadowMap';
         this._bindGroups = new Map();
         this._channelStates = null;
         this._nearFar = new Vector2();
+        this._invRenderSize = new Vector2();
         this._cameraPosition = new Vector4();
         this._cameraParams = new Vector4();
     }
@@ -168,6 +170,9 @@ const UNIFORM_NAME_SHADOW_MAP = 'Z_UniformShadowMap';
         });
         bindGroup.setValue('invViewProjMatrix', camera.invViewProjectionMatrix);
         bindGroup.setValue('cameraNearFar', this._nearFar);
+        // Neighbour tap spacing for the depth-based normal reconstruction.
+        this._invRenderSize.setXY(1 / depthTexture.width, 1 / depthTexture.height);
+        bindGroup.setValue('invRenderSize', this._invRenderSize);
         bindGroup.setValue('flip', this.needFlip(ctx.device) ? 1 : 0);
         bindGroup.setTexture('depthTex', depthTexture, fetchSampler('clamp_nearest_nomip'));
         bindGroup.setTexture(UNIFORM_NAME_SHADOW_MAP, shadowMapParams.shadowMap, shadowMapParams.shadowMapSampler);
@@ -182,6 +187,7 @@ const UNIFORM_NAME_SHADOW_MAP = 'Z_UniformShadowMap';
     createProgram(ctx, shadowMapParams) {
         const device = ctx.device;
         const numCascades = shadowMapParams.numShadowCascades;
+        const lightType = shadowMapParams.lightType;
         const shadowMap = shadowMapParams.shadowMap;
         const program = device.buildRenderProgram({
             label: 'ShadowMask',
@@ -236,13 +242,60 @@ const UNIFORM_NAME_SHADOW_MAP = 'Z_UniformShadowMap';
                 this.depthTex = pb.tex2D().sampleType('unfilterable-float').uniform(0);
                 this.invViewProjMatrix = pb.mat4().uniform(0);
                 this.cameraNearFar = pb.vec2().uniform(0);
+                this.invRenderSize = pb.vec2().uniform(0);
                 this.$outputs.color = pb.vec4();
+                /**
+         * Geometric normal recovered from the depth prepass.
+         *
+         * The opaque queue takes its shadows from this mask rather than from
+         * each material's calculateShadow, so this is the only place the normal
+         * offset can be applied on that path - and a fullscreen pass has no
+         * interpolated normal to use.
+         *
+         * Naive cross(dpdx, dpdy) spans depth discontinuities and produces a
+         * wild normal along every silhouette. Taking the nearer neighbour on
+         * each axis keeps the basis on one surface instead.
+         */ pb.func('zReconstructNormal', [
+                    pb.vec2('uv'),
+                    pb.vec4('center')
+                ], function() {
+                    this.$l.dx = pb.vec2(this.invRenderSize.x, 0);
+                    this.$l.dy = pb.vec2(0, this.invRenderSize.y);
+                    this.$l.right = ShaderHelper.samplePositionFromDepth(this, this.depthTex, pb.add(this.uv, this.dx), this.invViewProjMatrix, this.cameraNearFar);
+                    this.$l.left = ShaderHelper.samplePositionFromDepth(this, this.depthTex, pb.sub(this.uv, this.dx), this.invViewProjMatrix, this.cameraNearFar);
+                    this.$l.up = ShaderHelper.samplePositionFromDepth(this, this.depthTex, pb.add(this.uv, this.dy), this.invViewProjMatrix, this.cameraNearFar);
+                    this.$l.down = ShaderHelper.samplePositionFromDepth(this, this.depthTex, pb.sub(this.uv, this.dy), this.invViewProjMatrix, this.cameraNearFar);
+                    this.$l.edgeX = pb.sub(this.right.xyz, this.center.xyz);
+                    this.$if(pb.lessThan(pb.abs(pb.sub(this.left.w, this.center.w)), pb.abs(pb.sub(this.right.w, this.center.w))), function() {
+                        this.edgeX = pb.sub(this.center.xyz, this.left.xyz);
+                    });
+                    this.$l.edgeY = pb.sub(this.up.xyz, this.center.xyz);
+                    this.$if(pb.lessThan(pb.abs(pb.sub(this.down.w, this.center.w)), pb.abs(pb.sub(this.up.w, this.center.w))), function() {
+                        this.edgeY = pb.sub(this.center.xyz, this.down.xyz);
+                    });
+                    this.$l.n = pb.cross(this.edgeX, this.edgeY);
+                    this.$l.len = pb.length(this.n);
+                    // Degenerate footprint (flat depth, or a pixel with no geometry):
+                    // report a zero normal, which yields a zero offset downstream.
+                    this.$if(pb.lessThan(this.len, 1e-12), function() {
+                        this.$return(pb.vec3(0));
+                    });
+                    this.n = pb.div(this.n, this.len);
+                    // The cross product's sign depends on which neighbours were picked, so
+                    // orient it towards the camera rather than tracking that.
+                    this.$l.toEye = pb.sub(this.camera.position.xyz, this.center.xyz);
+                    this.$if(pb.lessThan(pb.dot(this.n, this.toEye), 0), function() {
+                        this.n = pb.neg(this.n);
+                    });
+                    this.$return(this.n);
+                });
                 // Explicit-depth cascade selection (fragCoord.z is invalid in a fullscreen
                 // pass). Mirrors posteffect/sss.ts calculateTransmissionShadow.
                 pb.func('zShadowMaskFactor', [
                     pb.vec3('worldPos'),
                     pb.float('depth01'),
-                    pb.float('NoL')
+                    pb.float('NoL'),
+                    pb.vec3('worldNormal')
                 ], function() {
                     if (numCascades > 1) {
                         this.$l.linearDepth = pb.mul(this.depth01, this.camera.params.y);
@@ -250,16 +303,17 @@ const UNIFORM_NAME_SHADOW_MAP = 'Z_UniformShadowMap';
                         this.$l.comparison = pb.vec4(pb.greaterThan(pb.vec4(this.linearDepth), this.splitDistances));
                         this.$l.cascadeFlags = pb.vec4(pb.float(pb.greaterThan(this.light.shadowCascades, 0)), pb.float(pb.greaterThan(this.light.shadowCascades, 1)), pb.float(pb.greaterThan(this.light.shadowCascades, 2)), pb.float(pb.greaterThan(this.light.shadowCascades, 3)));
                         this.$l.split = pb.int(pb.dot(this.comparison, this.cascadeFlags));
+                        this.$l.biasedPos = ShaderHelper.applyShadowNormalOffset(shadowMapParams.lightType, this, this.worldPos, this.worldNormal, this.NoL, ShaderHelper.getShadowCascadeBiasScale(this, this.split));
                         if (device.type === 'webgl') {
                             this.$l.shadowVertex = pb.vec4();
                             this.$for(pb.int('cascade'), 0, 4, function() {
                                 this.$if(pb.equal(this.cascade, this.split), function() {
-                                    this.shadowVertex = ShaderHelper.calculateShadowSpaceVertex(this, pb.vec4(this.worldPos, 1), this.cascade);
+                                    this.shadowVertex = ShaderHelper.calculateShadowSpaceVertex(this, pb.vec4(this.biasedPos, 1), this.cascade);
                                     this.$break();
                                 });
                             });
                         } else {
-                            this.$l.shadowVertex = ShaderHelper.calculateShadowSpaceVertex(this, pb.vec4(this.worldPos, 1), this.split);
+                            this.$l.shadowVertex = ShaderHelper.calculateShadowSpaceVertex(this, pb.vec4(this.biasedPos, 1), this.split);
                         }
                         this.$l.shadow = shadowMapParams.impl.computeShadowCSM(shadowMapParams, this, this.shadowVertex, this.NoL, this.split);
                         this.$l.shadowDistance = this.light.shadowCameraParams.w;
@@ -267,7 +321,8 @@ const UNIFORM_NAME_SHADOW_MAP = 'Z_UniformShadowMap';
                         this.shadow = pb.mix(1, this.shadow, this.light.shadowStrength);
                         this.$return(pb.clamp(this.shadow, 0, 1));
                     } else {
-                        this.$l.shadowVertex = ShaderHelper.calculateShadowSpaceVertex(this, pb.vec4(this.worldPos, 1));
+                        this.$l.biasedPos = ShaderHelper.applyShadowNormalOffset(shadowMapParams.lightType, this, this.worldPos, this.worldNormal, this.NoL);
+                        this.$l.shadowVertex = ShaderHelper.calculateShadowSpaceVertex(this, pb.vec4(this.biasedPos, 1));
                         this.$l.shadow = shadowMapParams.impl.computeShadow(shadowMapParams, this, this.shadowVertex, this.NoL);
                         this.$l.shadowDistance = this.light.shadowCameraParams.w;
                         this.shadow = pb.mix(this.shadow, 1, pb.smoothStep(pb.mul(this.shadowDistance, 0.8), this.shadowDistance, pb.distance(this.camera.position.xyz, this.worldPos)));
@@ -277,9 +332,19 @@ const UNIFORM_NAME_SHADOW_MAP = 'Z_UniformShadowMap';
                 });
                 pb.main(function() {
                     this.$l.pos = ShaderHelper.samplePositionFromDepth(this, this.depthTex, this.$inputs.uv, this.invViewProjMatrix, this.cameraNearFar);
-                    // NoL is unavailable in a fullscreen pass (no geometric normal); it only
-                    // feeds normal-offset bias, so a conservative 1.0 is used.
-                    this.$l.factor = this.zShadowMaskFactor(this.pos.xyz, this.pos.w, pb.float(1));
+                    // The normal is recovered from the depth prepass rather than
+                    // interpolated, because this pass is where the opaque queue's shadows
+                    // are decided and normal offset bias needs one.
+                    this.$l.normal = this.zReconstructNormal(this.$inputs.uv, this.pos);
+                    this.$l.lightDir = lightType === LIGHT_TYPE_DIRECTIONAL ? pb.neg(this.light.directionAndCutoff.xyz) : pb.normalize(pb.sub(this.light.positionAndRange.xyz, this.pos.xyz));
+                    // A zero normal (degenerate reconstruction) gives NoL 0, hence the
+                    // largest offset. Clamp to 1 there instead so those pixels fall back to
+                    // the unoffset behaviour rather than being pushed the furthest.
+                    this.$l.NoL = pb.float(1);
+                    this.$if(pb.greaterThan(pb.dot(this.normal, this.normal), 0.5), function() {
+                        this.NoL = pb.clamp(pb.dot(this.normal, this.lightDir), 0, 1);
+                    });
+                    this.$l.factor = this.zShadowMaskFactor(this.pos.xyz, this.pos.w, this.NoL, this.normal);
                     this.$outputs.color = pb.vec4(this.factor);
                 });
             }