@ignifx/core 0.16.0 → 0.18.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (58) hide show
  1. package/dist/{environment-DPi0_0SP.js → environment-DZ6WUHbm.js} +2 -2
  2. package/dist/{environment-DPi0_0SP.js.map → environment-DZ6WUHbm.js.map} +1 -1
  3. package/dist/{hdr-output-BrUvpAsE.js → hdr-output-Dbv0lhFl.js} +4 -3
  4. package/dist/{hdr-output-BrUvpAsE.js.map → hdr-output-Dbv0lhFl.js.map} +1 -1
  5. package/dist/{ignifx-error-oYdVnT1S.js → ignifx-error-B8ByiSfJ.js} +16 -1
  6. package/dist/ignifx-error-B8ByiSfJ.js.map +1 -0
  7. package/dist/index.d.ts +128 -14654
  8. package/dist/index.d.ts.map +1 -1
  9. package/dist/index.js +1501 -4037
  10. package/dist/index.js.map +1 -1
  11. package/dist/{instanced-mesh-instance-NnODkvqK.js → instanced-mesh-instance-BMhREEfx.js} +3 -2
  12. package/dist/{instanced-mesh-instance-NnODkvqK.js.map → instanced-mesh-instance-BMhREEfx.js.map} +1 -1
  13. package/dist/light-probe-asset-B60_X-yN.js +331 -0
  14. package/dist/light-probe-asset-B60_X-yN.js.map +1 -0
  15. package/dist/light-probes-DkYN89Qw.js +284 -0
  16. package/dist/light-probes-DkYN89Qw.js.map +1 -0
  17. package/dist/{material-plugin-BUlqLsap.js → material-plugin-CiAmriQ_.js} +2 -2
  18. package/dist/{material-plugin-BUlqLsap.js.map → material-plugin-CiAmriQ_.js.map} +1 -1
  19. package/dist/node-DznSvwap.js +301 -0
  20. package/dist/node-DznSvwap.js.map +1 -0
  21. package/dist/{post-effect-BHl7U56q.js → post-effect-CQnlX1RH.js} +3 -30
  22. package/dist/post-effect-CQnlX1RH.js.map +1 -0
  23. package/dist/{post-effect-compiler-CRek8VxQ.js → post-effect-compiler-C_7HTHZy.js} +3 -3
  24. package/dist/{post-effect-compiler-CRek8VxQ.js.map → post-effect-compiler-C_7HTHZy.js.map} +1 -1
  25. package/dist/prefab-overrides-BLQn5yHS.d.ts +15149 -0
  26. package/dist/prefab-overrides-BLQn5yHS.d.ts.map +1 -0
  27. package/dist/prefab-overrides-DT-wHHAJ.js +2396 -0
  28. package/dist/prefab-overrides-DT-wHHAJ.js.map +1 -0
  29. package/dist/prefab.d.ts +2 -0
  30. package/dist/prefab.js +2 -0
  31. package/dist/reflection-probe-DlVsl3zJ.js +1883 -0
  32. package/dist/reflection-probe-DlVsl3zJ.js.map +1 -0
  33. package/dist/reflection-probes-B8S9WnVX.js +551 -0
  34. package/dist/reflection-probes-B8S9WnVX.js.map +1 -0
  35. package/dist/{render-path-Be7WgN7r.js → render-path-D11i_7X8.js} +3 -2
  36. package/dist/{render-path-Be7WgN7r.js.map → render-path-D11i_7X8.js.map} +1 -1
  37. package/dist/{render-texture-C_TnaSz2.js → render-texture-UqRHRLQy.js} +15 -2
  38. package/dist/{render-texture-C_TnaSz2.js.map → render-texture-UqRHRLQy.js.map} +1 -1
  39. package/dist/rolldown-runtime-D7D4PA-g.js +13 -0
  40. package/dist/{scene-color-passes-DlNr-qyZ.js → scene-color-passes-B93qTOka.js} +35 -12
  41. package/dist/scene-color-passes-B93qTOka.js.map +1 -0
  42. package/dist/{shader-material-B6p66wB8.js → shader-material-C2_UCYdO.js} +6 -17
  43. package/dist/{shader-material-B6p66wB8.js.map → shader-material-C2_UCYdO.js.map} +1 -1
  44. package/dist/{shader-material-C0TAUr4t.js → shader-material-CaAkv5nT.js} +2 -2
  45. package/dist/{shader-material-C0TAUr4t.js.map → shader-material-CaAkv5nT.js.map} +1 -1
  46. package/dist/{shader-pragma-BKCoZTTA.js → shader-pragma-DmZpxGUo.js} +2 -2
  47. package/dist/{shader-pragma-BKCoZTTA.js.map → shader-pragma-DmZpxGUo.js.map} +1 -1
  48. package/dist/{surface-shader-BaK0kvBB.js → surface-shader-BeDRofOV.js} +4 -4
  49. package/dist/{surface-shader-BaK0kvBB.js.map → surface-shader-BeDRofOV.js.map} +1 -1
  50. package/dist/{vec3-D-0Y2mzE.js → vec3-Cc19wl4r.js} +3 -300
  51. package/dist/vec3-Cc19wl4r.js.map +1 -0
  52. package/package.json +8 -4
  53. package/dist/ignifx-error-oYdVnT1S.js.map +0 -1
  54. package/dist/json-CzZZ6K4x.js +0 -24
  55. package/dist/json-CzZZ6K4x.js.map +0 -1
  56. package/dist/post-effect-BHl7U56q.js.map +0 -1
  57. package/dist/scene-color-passes-DlNr-qyZ.js.map +0 -1
  58. package/dist/vec3-D-0Y2mzE.js.map +0 -1
@@ -1 +1 @@
1
- {"version":3,"file":"render-path-Be7WgN7r.js","names":[],"sources":["../src/lite/gpu/render-path.ts"],"sourcesContent":["import { addTask, createCopyToTextureTask, createRenderTarget, createRenderTask } from \"@babylonjs/lite\";\nimport type {\n EngineContext,\n RenderTarget,\n RenderTargetTextureResult,\n SceneContext,\n Task,\n Texture2D,\n} from \"@babylonjs/lite\";\n\n/**\n * The offscreen render path (`docs/architecture/07-rendering.md` §2.7): the frame graph a scene gets\n * when the project declares `rendering.features.postProcessing`.\n *\n * Everything here needs a device.\n *\n * ## Why the default render task is not good enough\n *\n * `createSceneContext` appends a task named `\"scene\"` that draws straight into the surface's\n * swapchain target — `surface.scRT` for a single-sample surface, or an MSAA colour target that\n * resolves into `scRT` (`lib/scene/scene-core.js` 74-79). Either way the scene's colour ends up in\n * the swapchain texture, and a post-process pass cannot read it: `createSurface` configures the\n * canvas context with no `usage` (`lib/engine/surface.js` 30), so the swapchain texture is\n * `RENDER_ATTACHMENT` only. Binding it as a sampled texture fails WebGPU validation, the whole\n * frame's command buffer is rejected, and the page presents black. That is exactly what the Phase 2\n * visual suite measured, and it is why this module exists.\n *\n * Lite offers no way to retarget the default task after the fact — `RenderTaskConfig.rt` is read\n * when the task is created, and `FrameGraph`'s public surface is only `build`/`execute`/`dispose`\n * (`index.d.ts` 5367). So the scene is created with `defaultRenderTask: false` and this module\n * builds the replacement.\n *\n * ## The graph it builds\n *\n * ```text\n * [shadow] → scene ──→ sceneColor ──→ present ──→ swapchain\n * └─ (a PostProcessStack appends its effects here, and disables present)\n * ```\n *\n * - `scene` is a normal `createRenderTask`. With MSAA it draws into a multisampled colour target\n * that owns its depth and resolves into `sceneColor` through `rst`; without MSAA it draws into\n * `sceneColor` directly with a separate depth target, which is the same split Lite's own default\n * uses (`RenderTaskConfig.depth`, `index.d.ts` 9782).\n * - `sceneColor` is an ordinary `createRenderTarget`, so `buildRenderTarget` allocates it with\n * `RENDER_ATTACHMENT | TEXTURE_BINDING | COPY_SRC | COPY_DST` (`lib/engine/render-target.js`) —\n * the `TEXTURE_BINDING` the swapchain lacks.\n * - `present` is a `createCopyToTextureTask` from `sceneColor` to the swapchain. Copying *into* the\n * swapchain is supported and takes the blit path (`lib/frame-graph/copy-to-texture-task.js`,\n * `swapAsView`); copying *out of* it is refused (Lite error 80), which is the same limit stated\n * from the other side.\n * - The swapchain is written every frame whatever else happens: with no chain, `present` does it;\n * with a chain, the chain's last effect does it and `present` is switched off\n * ({@link ScenePresenter.setPresentEnabled}).\n *\n * ## Resize\n *\n * Every target here is sized by passing the **surface** as `RenderTargetDescriptor.size`, which\n * `resolveSize` re-reads from `canvas.width`/`canvas.height` on every `buildRenderTarget`\n * (`lib/engine/render-target.js`). A surface resize calls the scene's `_resize`, which is\n * `frameGraph.build()` (`lib/scene/scene-core.js` 67-68): every target is reallocated at the new\n * size and every task re-records, which is also what refreshes the bind groups that captured the old\n * texture views. Nothing here has to observe the canvas itself, and nothing is eagerly allocated —\n * `createRenderTargetTexture` would be, and Lite rejects a surface as its size for exactly that\n * reason.\n */\n\n/**\n * The depth/stencil format Lite's own default render task uses (`lib/scene/scene-core.js` 76-77).\n *\n * @internal\n */\nexport const DEPTH_STENCIL_FORMAT: GPUTextureFormat = \"depth24plus-stencil8\";\n\n/**\n * The HDR half of a presenter, when `rendering.hdr` built one (`./hdr-output.ts`).\n *\n * @internal\n */\nexport interface HdrOutputHandle {\n /** The scene's linear `rgba16float` colour, as a sampled texture. Values may exceed 1. */\n readonly sceneTexture: Texture2D;\n /** The render target behind {@link HdrOutputHandle.sceneTexture}, for a pass that writes it back (TAA). */\n readonly sceneTarget: RenderTarget;\n /** The `\"scene\"` render task, whose scene uniforms the TAA jitter offsets. */\n readonly sceneTask: Task;\n /**\n * The auto exposure result, a 1×1 `r32float` texture holding `log2` of the multiplier the output\n * pass applies (`./auto-exposure.ts`); `null` when `rendering.autoExposure` is off.\n */\n readonly exposureTexture: Texture2D | null;\n /**\n * The same target with its sampled facade and resize hook: what HDR bloom (step G12) samples,\n * writes back into, and rebinds on resize.\n */\n readonly sceneTargetTexture: RenderTargetTextureResult;\n /**\n * The per-frame work: uploads the scene's exposure, contrast and curve when they changed, and\n * gives every new PBR material the linear-output plugin.\n *\n * @param isSceneRegistered - Whether Lite has built the scene, so a patched material needs a\n * rebuild.\n */\n update(isSceneRegistered: boolean): void;\n /**\n * Puts a task between the scene pass and the output pass, where it reads and writes linear\n * colour: a `PostProcessStack`'s custom effects ordered before any built-in one (GI plan G3).\n *\n * @param task - The task; it must write an `rgba16float` target.\n * @param isFrameGraphBuilt - Whether the scene is registered, so the task has to be recorded now.\n */\n insertLinearTask(task: Task, isFrameGraphBuilt: boolean): void;\n /**\n * Points the output pass at another linear texture, or back at the scene's.\n *\n * @param texture - The last linear effect's output, or `null` for {@link HdrOutputHandle.sceneTexture}.\n */\n setOutputSource(texture: Texture2D | null): void;\n}\n\n/** The scenes `rendering.hdr` built, created on first use so the module has no import-time work. */\nlet hdrScenes: WeakSet<SceneContext> | null = null;\n\n/**\n * Records that a scene renders through the HDR path, so code outside the HDR chunk (a custom\n * shader's build) can ask without importing it.\n *\n * @param scene - The scene `./hdr-output.ts` built a render path for.\n *\n * @internal\n */\nexport function markHdrScene(scene: SceneContext): void {\n hdrScenes ??= new WeakSet();\n hdrScenes.add(scene);\n}\n\n/**\n * Whether a scene renders through the HDR path, where every colour writer must write linear colour.\n *\n * @param scene - The scene.\n * @returns `true` once `./hdr-output.ts` has built the scene's render path.\n *\n * @internal\n */\nexport function isHdrScene(scene: SceneContext): boolean {\n return hdrScenes?.has(scene) === true;\n}\n\n/**\n * A scene's offscreen render path: the colour a `PostProcessStack` reads, and the compositing blit\n * it takes over from.\n *\n * @internal\n */\nexport interface ScenePresenter {\n /**\n * The single-sample colour target the scene ends up in — resolved when MSAA is on. It carries\n * `TEXTURE_BINDING`, so it is a legal `sourceTexture` for a post-process task.\n */\n readonly sceneColor: RenderTarget;\n /** The surface's swapchain target, where the last pass of the frame has to land. */\n readonly swapchain: RenderTarget;\n /**\n * Switches the compositing blit on or off.\n *\n * @param enabled - `false` while an effect chain writes the swapchain itself.\n */\n setPresentEnabled(enabled: boolean): void;\n /** Whether the compositing blit currently runs. */\n readonly isPresentEnabled: boolean;\n /** The HDR output pass, when `rendering.hdr` is on; `null` for the plain offscreen path. */\n readonly hdr: HdrOutputHandle | null;\n /**\n * The scene's render task and the single-sample colour target it ends in: {@link\n * ScenePresenter.sceneColor} on the plain path, the `rgba16float` target under `rendering.hdr`.\n * Scene-colour effects (contact shadows, SSGI) insert their tasks right after `task` and write their\n * result back into `target`, so everything downstream reads it.\n */\n readonly scenePass: ScenePass;\n}\n\n/**\n * The scene's render task and its resolved colour target.\n *\n * @internal\n */\nexport interface ScenePass {\n /** The task named `\"scene\"`. */\n readonly task: Task;\n /** The single-sample colour target the scene ends in; it carries `TEXTURE_BINDING` and `COPY_DST`. */\n readonly target: RenderTarget;\n /** That target's colour format. */\n readonly format: GPUTextureFormat;\n}\n\n/**\n * Builds the scene's render task into an offscreen target and the blit that composites it, and\n * appends both to the scene's frame graph.\n *\n * @remarks\n * Call it immediately after `createSceneContext(engine, { defaultRenderTask: false })` and before\n * `registerScene`: `addTask` appends, so calling it first is what puts `\"scene\"` ahead of everything\n * a feature adds later, and `registerSceneWithShadowSupport` still unshifts its own `\"shadow\"` task\n * in front of both.\n *\n * @param engine - The engine, which is also the primary surface.\n * @param scene - The scene created with no default render task.\n * @returns The presenter a `PostProcessStack` builds its chain against.\n *\n * @example\n * ```ts\n * const scene = createSceneContext(engine, { defaultRenderTask: false });\n * const presenter = installOffscreenRenderPath(engine, scene);\n * ```\n *\n * @internal\n */\nexport function installOffscreenRenderPath(engine: EngineContext, scene: SceneContext): ScenePresenter {\n const isMultisampled = engine.msaaSamples > 1;\n const sceneColor = createRenderTarget({\n lbl: \"ignifx:scene-color\",\n format: engine.format,\n samples: 1,\n size: engine,\n });\n const colorTarget = isMultisampled\n ? createRenderTarget({\n lbl: \"ignifx:scene-color-msaa\",\n format: engine.format,\n dFormat: DEPTH_STENCIL_FORMAT,\n samples: engine.msaaSamples,\n size: engine,\n })\n : sceneColor;\n const config: {\n name: string;\n rt: RenderTarget;\n rst?: RenderTarget;\n depth?: RenderTarget;\n } = { name: \"scene\", rt: colorTarget };\n if (isMultisampled) {\n config.rst = sceneColor;\n } else {\n // A colour target that carries no `dFormat` allocates no depth of its own, so the pass needs a\n // separate one — the arrangement Lite's own single-sample default task uses.\n config.depth = createRenderTarget({\n lbl: \"ignifx:scene-depth\",\n dFormat: DEPTH_STENCIL_FORMAT,\n samples: 1,\n size: engine,\n });\n }\n const sceneTask: Task = createRenderTask(config, engine, scene);\n addTask(scene, sceneTask);\n\n const present: Task = createCopyToTextureTask(\n { name: \"ignifx:present\", sourceTexture: sceneColor, targetTexture: engine.scRT },\n engine,\n scene,\n );\n addTask(scene, present);\n\n let isPresentEnabled = true;\n return {\n sceneColor,\n swapchain: engine.scRT,\n setPresentEnabled(enabled: boolean): void {\n isPresentEnabled = enabled;\n present.executionEnabled = enabled;\n },\n get isPresentEnabled(): boolean {\n return isPresentEnabled;\n },\n hdr: null,\n scenePass: { task: sceneTask, target: sceneColor, format: engine.format },\n };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAuEA,MAAa,uBAAyC;;AAiDtD,IAAI,YAA0C;;;;;;;;;AAU9C,SAAgB,aAAa,OAA2B;CACtD,8BAAc,IAAI,QAAQ;CAC1B,UAAU,IAAI,KAAK;AACrB;;;;;;;;;AAUA,SAAgB,WAAW,OAA8B;CACvD,OAAO,WAAW,IAAI,KAAK,MAAM;AACnC;;;;;;;;;;;;;;;;;;;;;;;AAuEA,SAAgB,2BAA2B,QAAuB,OAAqC;CACrG,MAAM,iBAAiB,OAAO,cAAc;CAC5C,MAAM,aAAa,mBAAmB;EACpC,KAAK;EACL,QAAQ,OAAO;EACf,SAAS;EACT,MAAM;CACR,CAAC;CAUD,MAAM,SAKF;EAAE,MAAM;EAAS,IAdD,iBAChB,mBAAmB;GACjB,KAAK;GACL,QAAQ,OAAO;GACf,SAAS;GACT,SAAS,OAAO;GAChB,MAAM;EACR,CAAC,IACD;CAMiC;CACrC,IAAI,gBACF,OAAO,MAAM;MAIb,OAAO,QAAQ,mBAAmB;EAChC,KAAK;EACL,SAAS;EACT,SAAS;EACT,MAAM;CACR,CAAC;CAEH,MAAM,YAAkB,iBAAiB,QAAQ,QAAQ,KAAK;CAC9D,QAAQ,OAAO,SAAS;CAExB,MAAM,UAAgB,wBACpB;EAAE,MAAM;EAAkB,eAAe;EAAY,eAAe,OAAO;CAAK,GAChF,QACA,KACF;CACA,QAAQ,OAAO,OAAO;CAEtB,IAAI,mBAAmB;CACvB,OAAO;EACL;EACA,WAAW,OAAO;EAClB,kBAAkB,SAAwB;GACxC,mBAAmB;GACnB,QAAQ,mBAAmB;EAC7B;EACA,IAAI,mBAA4B;GAC9B,OAAO;EACT;EACA,KAAK;EACL,WAAW;GAAE,MAAM;GAAW,QAAQ;GAAY,QAAQ,OAAO;EAAO;CAC1E;AACF"}
1
+ {"version":3,"file":"render-path-D11i_7X8.js","names":[],"sources":["../src/lite/gpu/render-path.ts"],"sourcesContent":["import { addTask, createCopyToTextureTask, createRenderTarget, createRenderTask } from \"@babylonjs/lite\";\nimport type {\n EngineContext,\n RenderTarget,\n RenderTargetTextureResult,\n SceneContext,\n Task,\n Texture2D,\n} from \"@babylonjs/lite\";\n\n/**\n * The offscreen render path (`docs/architecture/07-rendering.md` §2.7): the frame graph a scene gets\n * when the project declares `rendering.features.postProcessing`.\n *\n * Everything here needs a device.\n *\n * ## Why the default render task is not good enough\n *\n * `createSceneContext` appends a task named `\"scene\"` that draws straight into the surface's\n * swapchain target — `surface.scRT` for a single-sample surface, or an MSAA colour target that\n * resolves into `scRT` (`lib/scene/scene-core.js` 74-79). Either way the scene's colour ends up in\n * the swapchain texture, and a post-process pass cannot read it: `createSurface` configures the\n * canvas context with no `usage` (`lib/engine/surface.js` 30), so the swapchain texture is\n * `RENDER_ATTACHMENT` only. Binding it as a sampled texture fails WebGPU validation, the whole\n * frame's command buffer is rejected, and the page presents black. That is exactly what the Phase 2\n * visual suite measured, and it is why this module exists.\n *\n * Lite offers no way to retarget the default task after the fact — `RenderTaskConfig.rt` is read\n * when the task is created, and `FrameGraph`'s public surface is only `build`/`execute`/`dispose`\n * (`index.d.ts` 5367). So the scene is created with `defaultRenderTask: false` and this module\n * builds the replacement.\n *\n * ## The graph it builds\n *\n * ```text\n * [shadow] → scene ──→ sceneColor ──→ present ──→ swapchain\n * └─ (a PostProcessStack appends its effects here, and disables present)\n * ```\n *\n * - `scene` is a normal `createRenderTask`. With MSAA it draws into a multisampled colour target\n * that owns its depth and resolves into `sceneColor` through `rst`; without MSAA it draws into\n * `sceneColor` directly with a separate depth target, which is the same split Lite's own default\n * uses (`RenderTaskConfig.depth`, `index.d.ts` 9782).\n * - `sceneColor` is an ordinary `createRenderTarget`, so `buildRenderTarget` allocates it with\n * `RENDER_ATTACHMENT | TEXTURE_BINDING | COPY_SRC | COPY_DST` (`lib/engine/render-target.js`) —\n * the `TEXTURE_BINDING` the swapchain lacks.\n * - `present` is a `createCopyToTextureTask` from `sceneColor` to the swapchain. Copying *into* the\n * swapchain is supported and takes the blit path (`lib/frame-graph/copy-to-texture-task.js`,\n * `swapAsView`); copying *out of* it is refused (Lite error 80), which is the same limit stated\n * from the other side.\n * - The swapchain is written every frame whatever else happens: with no chain, `present` does it;\n * with a chain, the chain's last effect does it and `present` is switched off\n * ({@link ScenePresenter.setPresentEnabled}).\n *\n * ## Resize\n *\n * Every target here is sized by passing the **surface** as `RenderTargetDescriptor.size`, which\n * `resolveSize` re-reads from `canvas.width`/`canvas.height` on every `buildRenderTarget`\n * (`lib/engine/render-target.js`). A surface resize calls the scene's `_resize`, which is\n * `frameGraph.build()` (`lib/scene/scene-core.js` 67-68): every target is reallocated at the new\n * size and every task re-records, which is also what refreshes the bind groups that captured the old\n * texture views. Nothing here has to observe the canvas itself, and nothing is eagerly allocated —\n * `createRenderTargetTexture` would be, and Lite rejects a surface as its size for exactly that\n * reason.\n */\n\n/**\n * The depth/stencil format Lite's own default render task uses (`lib/scene/scene-core.js` 76-77).\n *\n * @internal\n */\nexport const DEPTH_STENCIL_FORMAT: GPUTextureFormat = \"depth24plus-stencil8\";\n\n/**\n * The HDR half of a presenter, when `rendering.hdr` built one (`./hdr-output.ts`).\n *\n * @internal\n */\nexport interface HdrOutputHandle {\n /** The scene's linear `rgba16float` colour, as a sampled texture. Values may exceed 1. */\n readonly sceneTexture: Texture2D;\n /** The render target behind {@link HdrOutputHandle.sceneTexture}, for a pass that writes it back (TAA). */\n readonly sceneTarget: RenderTarget;\n /** The `\"scene\"` render task, whose scene uniforms the TAA jitter offsets. */\n readonly sceneTask: Task;\n /**\n * The auto exposure result, a 1×1 `r32float` texture holding `log2` of the multiplier the output\n * pass applies (`./auto-exposure.ts`); `null` when `rendering.autoExposure` is off.\n */\n readonly exposureTexture: Texture2D | null;\n /**\n * The same target with its sampled facade and resize hook: what HDR bloom (step G12) samples,\n * writes back into, and rebinds on resize.\n */\n readonly sceneTargetTexture: RenderTargetTextureResult;\n /**\n * The per-frame work: uploads the scene's exposure, contrast and curve when they changed, and\n * gives every new PBR material the linear-output plugin.\n *\n * @param isSceneRegistered - Whether Lite has built the scene, so a patched material needs a\n * rebuild.\n */\n update(isSceneRegistered: boolean): void;\n /**\n * Puts a task between the scene pass and the output pass, where it reads and writes linear\n * colour: a `PostProcessStack`'s custom effects ordered before any built-in one (GI plan G3).\n *\n * @param task - The task; it must write an `rgba16float` target.\n * @param isFrameGraphBuilt - Whether the scene is registered, so the task has to be recorded now.\n */\n insertLinearTask(task: Task, isFrameGraphBuilt: boolean): void;\n /**\n * Points the output pass at another linear texture, or back at the scene's.\n *\n * @param texture - The last linear effect's output, or `null` for {@link HdrOutputHandle.sceneTexture}.\n */\n setOutputSource(texture: Texture2D | null): void;\n}\n\n/** The scenes `rendering.hdr` built, created on first use so the module has no import-time work. */\nlet hdrScenes: WeakSet<SceneContext> | null = null;\n\n/**\n * Records that a scene renders through the HDR path, so code outside the HDR chunk (a custom\n * shader's build) can ask without importing it.\n *\n * @param scene - The scene `./hdr-output.ts` built a render path for.\n *\n * @internal\n */\nexport function markHdrScene(scene: SceneContext): void {\n hdrScenes ??= new WeakSet();\n hdrScenes.add(scene);\n}\n\n/**\n * Whether a scene renders through the HDR path, where every colour writer must write linear colour.\n *\n * @param scene - The scene.\n * @returns `true` once `./hdr-output.ts` has built the scene's render path.\n *\n * @internal\n */\nexport function isHdrScene(scene: SceneContext): boolean {\n return hdrScenes?.has(scene) === true;\n}\n\n/**\n * A scene's offscreen render path: the colour a `PostProcessStack` reads, and the compositing blit\n * it takes over from.\n *\n * @internal\n */\nexport interface ScenePresenter {\n /**\n * The single-sample colour target the scene ends up in — resolved when MSAA is on. It carries\n * `TEXTURE_BINDING`, so it is a legal `sourceTexture` for a post-process task.\n */\n readonly sceneColor: RenderTarget;\n /** The surface's swapchain target, where the last pass of the frame has to land. */\n readonly swapchain: RenderTarget;\n /**\n * Switches the compositing blit on or off.\n *\n * @param enabled - `false` while an effect chain writes the swapchain itself.\n */\n setPresentEnabled(enabled: boolean): void;\n /** Whether the compositing blit currently runs. */\n readonly isPresentEnabled: boolean;\n /** The HDR output pass, when `rendering.hdr` is on; `null` for the plain offscreen path. */\n readonly hdr: HdrOutputHandle | null;\n /**\n * The scene's render task and the single-sample colour target it ends in: {@link\n * ScenePresenter.sceneColor} on the plain path, the `rgba16float` target under `rendering.hdr`.\n * Scene-colour effects (contact shadows, SSGI) insert their tasks right after `task` and write their\n * result back into `target`, so everything downstream reads it.\n */\n readonly scenePass: ScenePass;\n}\n\n/**\n * The scene's render task and its resolved colour target.\n *\n * @internal\n */\nexport interface ScenePass {\n /** The task named `\"scene\"`. */\n readonly task: Task;\n /** The single-sample colour target the scene ends in; it carries `TEXTURE_BINDING` and `COPY_DST`. */\n readonly target: RenderTarget;\n /** That target's colour format. */\n readonly format: GPUTextureFormat;\n /**\n * Whether a post-process task may write {@link ScenePass.target} directly. `false` on the plain\n * path: its target is allocated lazily, and a post-process task that writes it reallocates it in\n * `record()` (Lite's `buildRenderTarget`, `lib/engine/render-target.js`), destroying the texture\n * the scene task and every pass recorded before it hold, so the frame is rejected and presents\n * black. The HDR target is eager and survives that.\n */\n readonly isTargetWritable: boolean;\n}\n\n/**\n * Builds the scene's render task into an offscreen target and the blit that composites it, and\n * appends both to the scene's frame graph.\n *\n * @remarks\n * Call it immediately after `createSceneContext(engine, { defaultRenderTask: false })` and before\n * `registerScene`: `addTask` appends, so calling it first is what puts `\"scene\"` ahead of everything\n * a feature adds later, and `registerSceneWithShadowSupport` still unshifts its own `\"shadow\"` task\n * in front of both.\n *\n * @param engine - The engine, which is also the primary surface.\n * @param scene - The scene created with no default render task.\n * @returns The presenter a `PostProcessStack` builds its chain against.\n *\n * @example\n * ```ts\n * const scene = createSceneContext(engine, { defaultRenderTask: false });\n * const presenter = installOffscreenRenderPath(engine, scene);\n * ```\n *\n * @internal\n */\nexport function installOffscreenRenderPath(engine: EngineContext, scene: SceneContext): ScenePresenter {\n const isMultisampled = engine.msaaSamples > 1;\n const sceneColor = createRenderTarget({\n lbl: \"ignifx:scene-color\",\n format: engine.format,\n samples: 1,\n size: engine,\n });\n const colorTarget = isMultisampled\n ? createRenderTarget({\n lbl: \"ignifx:scene-color-msaa\",\n format: engine.format,\n dFormat: DEPTH_STENCIL_FORMAT,\n samples: engine.msaaSamples,\n size: engine,\n })\n : sceneColor;\n const config: {\n name: string;\n rt: RenderTarget;\n rst?: RenderTarget;\n depth?: RenderTarget;\n } = { name: \"scene\", rt: colorTarget };\n if (isMultisampled) {\n config.rst = sceneColor;\n } else {\n // A colour target that carries no `dFormat` allocates no depth of its own, so the pass needs a\n // separate one — the arrangement Lite's own single-sample default task uses.\n config.depth = createRenderTarget({\n lbl: \"ignifx:scene-depth\",\n dFormat: DEPTH_STENCIL_FORMAT,\n samples: 1,\n size: engine,\n });\n }\n const sceneTask: Task = createRenderTask(config, engine, scene);\n addTask(scene, sceneTask);\n\n const present: Task = createCopyToTextureTask(\n { name: \"ignifx:present\", sourceTexture: sceneColor, targetTexture: engine.scRT },\n engine,\n scene,\n );\n addTask(scene, present);\n\n let isPresentEnabled = true;\n return {\n sceneColor,\n swapchain: engine.scRT,\n setPresentEnabled(enabled: boolean): void {\n isPresentEnabled = enabled;\n present.executionEnabled = enabled;\n },\n get isPresentEnabled(): boolean {\n return isPresentEnabled;\n },\n hdr: null,\n scenePass: { task: sceneTask, target: sceneColor, format: engine.format, isTargetWritable: false },\n };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAuEA,MAAa,uBAAyC;;AAiDtD,IAAI,YAA0C;;;;;;;;;AAU9C,SAAgB,aAAa,OAA2B;CACtD,8BAAc,IAAI,QAAQ;CAC1B,UAAU,IAAI,KAAK;AACrB;;;;;;;;;AAUA,SAAgB,WAAW,OAA8B;CACvD,OAAO,WAAW,IAAI,KAAK,MAAM;AACnC;;;;;;;;;;;;;;;;;;;;;;;AA+EA,SAAgB,2BAA2B,QAAuB,OAAqC;CACrG,MAAM,iBAAiB,OAAO,cAAc;CAC5C,MAAM,aAAa,mBAAmB;EACpC,KAAK;EACL,QAAQ,OAAO;EACf,SAAS;EACT,MAAM;CACR,CAAC;CAUD,MAAM,SAKF;EAAE,MAAM;EAAS,IAdD,iBAChB,mBAAmB;GACjB,KAAK;GACL,QAAQ,OAAO;GACf,SAAS;GACT,SAAS,OAAO;GAChB,MAAM;EACR,CAAC,IACD;CAMiC;CACrC,IAAI,gBACF,OAAO,MAAM;MAIb,OAAO,QAAQ,mBAAmB;EAChC,KAAK;EACL,SAAS;EACT,SAAS;EACT,MAAM;CACR,CAAC;CAEH,MAAM,YAAkB,iBAAiB,QAAQ,QAAQ,KAAK;CAC9D,QAAQ,OAAO,SAAS;CAExB,MAAM,UAAgB,wBACpB;EAAE,MAAM;EAAkB,eAAe;EAAY,eAAe,OAAO;CAAK,GAChF,QACA,KACF;CACA,QAAQ,OAAO,OAAO;CAEtB,IAAI,mBAAmB;CACvB,OAAO;EACL;EACA,WAAW,OAAO;EAClB,kBAAkB,SAAwB;GACxC,mBAAmB;GACnB,QAAQ,mBAAmB;EAC7B;EACA,IAAI,mBAA4B;GAC9B,OAAO;EACT;EACA,KAAK;EACL,WAAW;GAAE,MAAM;GAAW,QAAQ;GAAY,QAAQ,OAAO;GAAQ,kBAAkB;EAAM;CACnG;AACF"}
@@ -1,5 +1,12 @@
1
+ import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
1
2
  import { addTask, buildFrameGraphTask, createRenderTarget, createRenderTask, getFrameGraph } from "@babylonjs/lite";
2
3
  //#region src/lite/gpu/render-texture.ts
4
+ var render_texture_exports = /* @__PURE__ */ __exportAll({
5
+ colorTextureOf: () => colorTextureOf,
6
+ createLiteRenderTexture: () => createLiteRenderTexture,
7
+ deviceOf: () => deviceOf,
8
+ removeTask: () => removeTask
9
+ });
3
10
  /**
4
11
  * Render-to-texture (`docs/architecture/07-rendering.md` §2.11): a second pass of the render scene,
5
12
  * through another camera, into an offscreen colour target that can be read back.
@@ -128,6 +135,8 @@ function createLiteRenderTexture(engine, scene, width, height, excludeKey) {
128
135
  *
129
136
  * @param target - The target.
130
137
  * @returns The texture, or `null` before the owning task has recorded.
138
+ *
139
+ * @internal
131
140
  */
132
141
  function colorTextureOf(target) {
133
142
  return target._colorTexture ?? null;
@@ -137,6 +146,8 @@ function colorTextureOf(target) {
137
146
  *
138
147
  * @param engine - The engine.
139
148
  * @returns The device, or `null` for an engine without one.
149
+ *
150
+ * @internal
140
151
  */
141
152
  function deviceOf(engine) {
142
153
  return engine._device ?? null;
@@ -146,6 +157,8 @@ function deviceOf(engine) {
146
157
  *
147
158
  * @param scene - The scene.
148
159
  * @param task - The task.
160
+ *
161
+ * @internal
149
162
  */
150
163
  function removeTask(scene, task) {
151
164
  const tasks = getFrameGraph(scene)._tasks;
@@ -195,6 +208,6 @@ async function readTexture(device, texture, width, height) {
195
208
  }
196
209
  }
197
210
  //#endregion
198
- export { createLiteRenderTexture };
211
+ export { render_texture_exports as i, deviceOf as n, removeTask as r, colorTextureOf as t };
199
212
 
200
- //# sourceMappingURL=render-texture-C_TnaSz2.js.map
213
+ //# sourceMappingURL=render-texture-UqRHRLQy.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"render-texture-C_TnaSz2.js","names":["internals"],"sources":["../src/lite/gpu/render-texture.ts"],"sourcesContent":["import { addTask, buildFrameGraphTask, createRenderTarget, createRenderTask, getFrameGraph } from \"@babylonjs/lite\";\nimport type { Camera, EngineContext, Mesh, RenderTarget, RenderTaskConfig, SceneContext, Task } from \"@babylonjs/lite\";\n\n/**\n * Render-to-texture (`docs/architecture/07-rendering.md` §2.11): a second pass of the render scene,\n * through another camera, into an offscreen colour target that can be read back.\n *\n * Everything here needs a device, and every Lite claim was read from `@babylonjs/lite@1.34.0`.\n *\n * ## The pass\n *\n * One `createRenderTask` per texture, appended to the render scene's frame graph. Its target is an\n * ordinary `createRenderTarget` of a fixed `{ width, height }`, in the surface's colour format with\n * a depth/stencil attachment of its own, single-sample. The task owns it: `record()` allocates it\n * (`buildRenderTarget`, `RENDER_ATTACHMENT | TEXTURE_BINDING | COPY_SRC | COPY_DST`,\n * `lib/engine/render-target.js` 59) and `dispose()` frees it. The task auto-mirrors the scene's\n * renderables, builds its own pipelines for its target signature, and writes a scene UBO of its own\n * (`_sceneUBO`, `lib/frame-graph/render-task-base.js` 85), so its camera never disturbs the main\n * pass.\n *\n * ## The camera\n *\n * `RenderTaskConfig.cam` is read on every execute (`task._config.cam ?? scene.camera`,\n * `render-task-base.js` 236, 279) from the config object the task keeps by reference (line 77), so\n * re-pointing the pass is one assignment. A `null` camera would fall back to the scene's main\n * camera, so the pass is switched off with `Task.executionEnabled` instead.\n *\n * ## Editor-only meshes\n *\n * A render task draws every visible mesh of its scene; `RenderTaskConfig` has no mesh filter. So\n * the task's `execute` (the frame graph calls it, `lib/frame-graph/frame-graph.js` 16) is wrapped:\n * it hides each visible mesh whose `metadata[excludeKey]` is `true`, runs, and shows them again.\n * The main pass has already drawn the frame by then (the task is appended after it), so the main\n * view never sees them hidden and does not flicker. `drawList` reads `visible` as it encodes\n * (`render-task-base.js` 354), and this task's opaque bundle is only ever encoded inside the\n * wrapper, so it never holds them either.\n *\n * ## Gaps in Lite's public surface\n *\n * - **No task removal.** `FrameGraph` exposes only `build`/`execute`/`dispose`, and a disposed\n * render task throws from `record()` on the next `frameGraph.build()` (a canvas resize). So the\n * task is spliced out of `_tasks`, the array `addTask` appends to (`lib/frame-graph/frame-graph.js`),\n * before it is disposed.\n * - **No texture readback.** Lite reads back only the swapchain (`captureScreenshot`). The read here\n * copies the target's `_colorTexture` into a mapped buffer through `engine._device`. Queue order\n * makes it read the last frame submitted before the call.\n */\n\n/** The depth/stencil format Lite's own render tasks use. */\nconst DEPTH_STENCIL_FORMAT: GPUTextureFormat = \"depth24plus-stencil8\";\n\n/** WebGPU's `bytesPerRow` alignment for a texture-to-buffer copy. */\nconst ROW_ALIGNMENT = 256;\n\n/** RGBA8 bytes per pixel. */\nconst BYTES_PER_PIXEL = 4;\n\n/** The fields of a Lite 1.34 render target that hold its live GPU texture. */\ninterface TargetInternals {\n /** The colour texture, `null` until the owning task has recorded. */\n _colorTexture?: GPUTexture | null;\n}\n\n/** The field of a Lite 1.34 engine that holds its device. */\ninterface EngineInternals {\n /** The device; replaced after a device-loss recovery, so read on every use. */\n _device?: GPUDevice;\n}\n\n/** The field of a Lite 1.34 frame graph that holds its tasks. */\ninterface FrameGraphInternals {\n /** The tasks, in execute order. */\n _tasks?: Task[];\n}\n\n/**\n * One texture's render pass.\n *\n * @internal\n */\nexport interface LiteRenderTexture {\n /**\n * Points the pass at a camera, or switches it off.\n *\n * @param camera - The camera to render through from the next frame, or `null` to stop.\n */\n setCamera(camera: Camera | null): void;\n /**\n * Reads the texture as it is after the last submitted frame.\n *\n * @returns `width * height * 4` bytes of RGBA8, top row first.\n * @throws Error when the pass has not recorded yet or the engine has no device.\n */\n read(): Promise<Uint8ClampedArray>;\n /** Removes the pass from the frame graph and frees its target. Idempotent. */\n dispose(): void;\n}\n\n/**\n * Creates a texture's render pass, switched off, at the end of the render scene's frame graph.\n *\n * @remarks\n * Call it only once the scene is registered: the task is recorded at once, which allocates its\n * target.\n *\n * @param engine - The WebGPU engine.\n * @param scene - The registered render scene.\n * @param width - The width in pixels.\n * @param height - The height in pixels.\n * @param excludeKey - The `metadata` key that, set to `true` on a mesh, keeps it out of the pass.\n * @returns The pass.\n *\n * @internal\n */\nexport function createLiteRenderTexture(\n engine: EngineContext,\n scene: SceneContext,\n width: number,\n height: number,\n excludeKey: string,\n): LiteRenderTexture {\n const target: RenderTarget = createRenderTarget({\n lbl: \"ignifx:render-texture\",\n format: engine.format,\n dFormat: DEPTH_STENCIL_FORMAT,\n samples: 1,\n size: { width, height },\n });\n const config: RenderTaskConfig = { name: \"ignifx:render-texture\", rt: target, cam: null };\n const task = createRenderTask(config, engine, scene);\n task.executionEnabled = false;\n const execute = task.execute?.bind(task);\n if (execute === undefined) {\n throw new TypeError(\"Lite's render task has no execute(); render-texture.ts needs updating for this Lite.\");\n }\n const hidden: Mesh[] = [];\n task.execute = (): number => {\n for (const mesh of scene.meshes) {\n if (mesh.visible !== false && mesh.metadata?.[excludeKey] === true) {\n mesh.visible = false;\n hidden.push(mesh);\n }\n }\n try {\n return execute();\n } finally {\n for (const mesh of hidden) {\n mesh.visible = true;\n }\n hidden.length = 0;\n }\n };\n addTask(scene, task);\n buildFrameGraphTask(getFrameGraph(scene), task);\n let isDisposed = false;\n return {\n setCamera(camera: Camera | null): void {\n if (isDisposed) {\n return;\n }\n config.cam = camera;\n task.executionEnabled = camera !== null;\n },\n async read(): Promise<Uint8ClampedArray> {\n const texture = isDisposed ? null : colorTextureOf(target);\n const device = deviceOf(engine);\n if (texture === null || device === null) {\n throw new Error(\"The render texture has no GPU texture to read.\");\n }\n return readTexture(device, texture, width, height);\n },\n dispose(): void {\n if (isDisposed) {\n return;\n }\n isDisposed = true;\n task.executionEnabled = false;\n removeTask(scene, task);\n task.dispose();\n },\n };\n}\n\n/**\n * A render target's live colour texture.\n *\n * @param target - The target.\n * @returns The texture, or `null` before the owning task has recorded.\n */\nfunction colorTextureOf(target: RenderTarget): GPUTexture | null {\n // Boundary assertion (coding standards §5.2): the field Lite 1.34 keeps, documented above.\n // oxlint-disable-next-line typescript/no-unsafe-type-assertion\n const internals = target as RenderTarget & TargetInternals;\n // oxlint-disable-next-line no-underscore-dangle\n return internals._colorTexture ?? null;\n}\n\n/**\n * An engine's current device.\n *\n * @param engine - The engine.\n * @returns The device, or `null` for an engine without one.\n */\nfunction deviceOf(engine: EngineContext): GPUDevice | null {\n // oxlint-disable-next-line typescript/no-unsafe-type-assertion\n const internals = engine as EngineContext & EngineInternals;\n // oxlint-disable-next-line no-underscore-dangle\n return internals._device ?? null;\n}\n\n/**\n * Takes a task out of a scene's frame graph, so the next rebuild does not record it.\n *\n * @param scene - The scene.\n * @param task - The task.\n */\nfunction removeTask(scene: SceneContext, task: Task): void {\n // oxlint-disable-next-line typescript/no-unsafe-type-assertion\n const graph = getFrameGraph(scene) as ReturnType<typeof getFrameGraph> & FrameGraphInternals;\n // oxlint-disable-next-line no-underscore-dangle\n const tasks = graph._tasks;\n if (!Array.isArray(tasks)) {\n // A Lite upgrade renamed the field: fail here, not on the next rebuild (07-rendering §2.11).\n throw new TypeError(\"Lite's FrameGraph has no _tasks array; render-texture.ts needs updating for this Lite.\");\n }\n const index = tasks.indexOf(task);\n if (index >= 0) {\n tasks.splice(index, 1);\n }\n}\n\n/**\n * Copies a colour texture into tightly packed RGBA8.\n *\n * @param device - The device that owns the texture.\n * @param texture - An 8-bit RGBA or BGRA texture with `COPY_SRC`.\n * @param width - The width to read.\n * @param height - The height to read.\n * @returns The pixels, top row first, red first.\n */\nasync function readTexture(\n device: GPUDevice,\n texture: GPUTexture,\n width: number,\n height: number,\n): Promise<Uint8ClampedArray> {\n const rowBytes = width * BYTES_PER_PIXEL;\n const bytesPerRow = Math.ceil(rowBytes / ROW_ALIGNMENT) * ROW_ALIGNMENT;\n const buffer = device.createBuffer({\n label: \"ignifx:render-texture-read\",\n size: bytesPerRow * height,\n usage: GPUBufferUsage.COPY_DST | GPUBufferUsage.MAP_READ,\n });\n try {\n const encoder = device.createCommandEncoder({ label: \"ignifx:render-texture-read\" });\n encoder.copyTextureToBuffer({ texture }, { buffer, bytesPerRow }, { width, height });\n device.queue.submit([encoder.finish()]);\n await buffer.mapAsync(GPUMapMode.READ);\n const mapped = new Uint8Array(buffer.getMappedRange());\n const out = new Uint8ClampedArray(rowBytes * height);\n for (let row = 0; row < height; row += 1) {\n out.set(mapped.subarray(row * bytesPerRow, row * bytesPerRow + rowBytes), row * rowBytes);\n }\n if (texture.format.startsWith(\"bgra\")) {\n for (let index = 0; index < out.length; index += BYTES_PER_PIXEL) {\n const blue = out[index] ?? 0;\n out[index] = out[index + 2] ?? 0;\n out[index + 2] = blue;\n }\n }\n return out;\n } finally {\n buffer.destroy();\n }\n}\n"],"mappings":"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"}
1
+ {"version":3,"file":"render-texture-UqRHRLQy.js","names":["internals"],"sources":["../src/lite/gpu/render-texture.ts"],"sourcesContent":["import { addTask, buildFrameGraphTask, createRenderTarget, createRenderTask, getFrameGraph } from \"@babylonjs/lite\";\nimport type { Camera, EngineContext, Mesh, RenderTarget, RenderTaskConfig, SceneContext, Task } from \"@babylonjs/lite\";\n\n/**\n * Render-to-texture (`docs/architecture/07-rendering.md` §2.11): a second pass of the render scene,\n * through another camera, into an offscreen colour target that can be read back.\n *\n * Everything here needs a device, and every Lite claim was read from `@babylonjs/lite@1.34.0`.\n *\n * ## The pass\n *\n * One `createRenderTask` per texture, appended to the render scene's frame graph. Its target is an\n * ordinary `createRenderTarget` of a fixed `{ width, height }`, in the surface's colour format with\n * a depth/stencil attachment of its own, single-sample. The task owns it: `record()` allocates it\n * (`buildRenderTarget`, `RENDER_ATTACHMENT | TEXTURE_BINDING | COPY_SRC | COPY_DST`,\n * `lib/engine/render-target.js` 59) and `dispose()` frees it. The task auto-mirrors the scene's\n * renderables, builds its own pipelines for its target signature, and writes a scene UBO of its own\n * (`_sceneUBO`, `lib/frame-graph/render-task-base.js` 85), so its camera never disturbs the main\n * pass.\n *\n * ## The camera\n *\n * `RenderTaskConfig.cam` is read on every execute (`task._config.cam ?? scene.camera`,\n * `render-task-base.js` 236, 279) from the config object the task keeps by reference (line 77), so\n * re-pointing the pass is one assignment. A `null` camera would fall back to the scene's main\n * camera, so the pass is switched off with `Task.executionEnabled` instead.\n *\n * ## Editor-only meshes\n *\n * A render task draws every visible mesh of its scene; `RenderTaskConfig` has no mesh filter. So\n * the task's `execute` (the frame graph calls it, `lib/frame-graph/frame-graph.js` 16) is wrapped:\n * it hides each visible mesh whose `metadata[excludeKey]` is `true`, runs, and shows them again.\n * The main pass has already drawn the frame by then (the task is appended after it), so the main\n * view never sees them hidden and does not flicker. `drawList` reads `visible` as it encodes\n * (`render-task-base.js` 354), and this task's opaque bundle is only ever encoded inside the\n * wrapper, so it never holds them either.\n *\n * ## Gaps in Lite's public surface\n *\n * - **No task removal.** `FrameGraph` exposes only `build`/`execute`/`dispose`, and a disposed\n * render task throws from `record()` on the next `frameGraph.build()` (a canvas resize). So the\n * task is spliced out of `_tasks`, the array `addTask` appends to (`lib/frame-graph/frame-graph.js`),\n * before it is disposed.\n * - **No texture readback.** Lite reads back only the swapchain (`captureScreenshot`). The read here\n * copies the target's `_colorTexture` into a mapped buffer through `engine._device`. Queue order\n * makes it read the last frame submitted before the call.\n */\n\n/** The depth/stencil format Lite's own render tasks use. */\nconst DEPTH_STENCIL_FORMAT: GPUTextureFormat = \"depth24plus-stencil8\";\n\n/** WebGPU's `bytesPerRow` alignment for a texture-to-buffer copy. */\nconst ROW_ALIGNMENT = 256;\n\n/** RGBA8 bytes per pixel. */\nconst BYTES_PER_PIXEL = 4;\n\n/** The fields of a Lite 1.34 render target that hold its live GPU texture. */\ninterface TargetInternals {\n /** The colour texture, `null` until the owning task has recorded. */\n _colorTexture?: GPUTexture | null;\n}\n\n/** The field of a Lite 1.34 engine that holds its device. */\ninterface EngineInternals {\n /** The device; replaced after a device-loss recovery, so read on every use. */\n _device?: GPUDevice;\n}\n\n/** The field of a Lite 1.34 frame graph that holds its tasks. */\ninterface FrameGraphInternals {\n /** The tasks, in execute order. */\n _tasks?: Task[];\n}\n\n/**\n * One texture's render pass.\n *\n * @internal\n */\nexport interface LiteRenderTexture {\n /**\n * Points the pass at a camera, or switches it off.\n *\n * @param camera - The camera to render through from the next frame, or `null` to stop.\n */\n setCamera(camera: Camera | null): void;\n /**\n * Reads the texture as it is after the last submitted frame.\n *\n * @returns `width * height * 4` bytes of RGBA8, top row first.\n * @throws Error when the pass has not recorded yet or the engine has no device.\n */\n read(): Promise<Uint8ClampedArray>;\n /** Removes the pass from the frame graph and frees its target. Idempotent. */\n dispose(): void;\n}\n\n/**\n * Creates a texture's render pass, switched off, at the end of the render scene's frame graph.\n *\n * @remarks\n * Call it only once the scene is registered: the task is recorded at once, which allocates its\n * target.\n *\n * @param engine - The WebGPU engine.\n * @param scene - The registered render scene.\n * @param width - The width in pixels.\n * @param height - The height in pixels.\n * @param excludeKey - The `metadata` key that, set to `true` on a mesh, keeps it out of the pass.\n * @returns The pass.\n *\n * @internal\n */\nexport function createLiteRenderTexture(\n engine: EngineContext,\n scene: SceneContext,\n width: number,\n height: number,\n excludeKey: string,\n): LiteRenderTexture {\n const target: RenderTarget = createRenderTarget({\n lbl: \"ignifx:render-texture\",\n format: engine.format,\n dFormat: DEPTH_STENCIL_FORMAT,\n samples: 1,\n size: { width, height },\n });\n const config: RenderTaskConfig = { name: \"ignifx:render-texture\", rt: target, cam: null };\n const task = createRenderTask(config, engine, scene);\n task.executionEnabled = false;\n const execute = task.execute?.bind(task);\n if (execute === undefined) {\n throw new TypeError(\"Lite's render task has no execute(); render-texture.ts needs updating for this Lite.\");\n }\n const hidden: Mesh[] = [];\n task.execute = (): number => {\n for (const mesh of scene.meshes) {\n if (mesh.visible !== false && mesh.metadata?.[excludeKey] === true) {\n mesh.visible = false;\n hidden.push(mesh);\n }\n }\n try {\n return execute();\n } finally {\n for (const mesh of hidden) {\n mesh.visible = true;\n }\n hidden.length = 0;\n }\n };\n addTask(scene, task);\n buildFrameGraphTask(getFrameGraph(scene), task);\n let isDisposed = false;\n return {\n setCamera(camera: Camera | null): void {\n if (isDisposed) {\n return;\n }\n config.cam = camera;\n task.executionEnabled = camera !== null;\n },\n async read(): Promise<Uint8ClampedArray> {\n const texture = isDisposed ? null : colorTextureOf(target);\n const device = deviceOf(engine);\n if (texture === null || device === null) {\n throw new Error(\"The render texture has no GPU texture to read.\");\n }\n return readTexture(device, texture, width, height);\n },\n dispose(): void {\n if (isDisposed) {\n return;\n }\n isDisposed = true;\n task.executionEnabled = false;\n removeTask(scene, task);\n task.dispose();\n },\n };\n}\n\n/**\n * A render target's live colour texture.\n *\n * @param target - The target.\n * @returns The texture, or `null` before the owning task has recorded.\n *\n * @internal\n */\nexport function colorTextureOf(target: RenderTarget): GPUTexture | null {\n // Boundary assertion (coding standards §5.2): the field Lite 1.34 keeps, documented above.\n // oxlint-disable-next-line typescript/no-unsafe-type-assertion\n const internals = target as RenderTarget & TargetInternals;\n // oxlint-disable-next-line no-underscore-dangle\n return internals._colorTexture ?? null;\n}\n\n/**\n * An engine's current device.\n *\n * @param engine - The engine.\n * @returns The device, or `null` for an engine without one.\n *\n * @internal\n */\nexport function deviceOf(engine: EngineContext): GPUDevice | null {\n // oxlint-disable-next-line typescript/no-unsafe-type-assertion\n const internals = engine as EngineContext & EngineInternals;\n // oxlint-disable-next-line no-underscore-dangle\n return internals._device ?? null;\n}\n\n/**\n * Takes a task out of a scene's frame graph, so the next rebuild does not record it.\n *\n * @param scene - The scene.\n * @param task - The task.\n *\n * @internal\n */\nexport function removeTask(scene: SceneContext, task: Task): void {\n // oxlint-disable-next-line typescript/no-unsafe-type-assertion\n const graph = getFrameGraph(scene) as ReturnType<typeof getFrameGraph> & FrameGraphInternals;\n // oxlint-disable-next-line no-underscore-dangle\n const tasks = graph._tasks;\n if (!Array.isArray(tasks)) {\n // A Lite upgrade renamed the field: fail here, not on the next rebuild (07-rendering §2.11).\n throw new TypeError(\"Lite's FrameGraph has no _tasks array; render-texture.ts needs updating for this Lite.\");\n }\n const index = tasks.indexOf(task);\n if (index >= 0) {\n tasks.splice(index, 1);\n }\n}\n\n/**\n * Copies a colour texture into tightly packed RGBA8.\n *\n * @param device - The device that owns the texture.\n * @param texture - An 8-bit RGBA or BGRA texture with `COPY_SRC`.\n * @param width - The width to read.\n * @param height - The height to read.\n * @returns The pixels, top row first, red first.\n */\nasync function readTexture(\n device: GPUDevice,\n texture: GPUTexture,\n width: number,\n height: number,\n): Promise<Uint8ClampedArray> {\n const rowBytes = width * BYTES_PER_PIXEL;\n const bytesPerRow = Math.ceil(rowBytes / ROW_ALIGNMENT) * ROW_ALIGNMENT;\n const buffer = device.createBuffer({\n label: \"ignifx:render-texture-read\",\n size: bytesPerRow * height,\n usage: GPUBufferUsage.COPY_DST | GPUBufferUsage.MAP_READ,\n });\n try {\n const encoder = device.createCommandEncoder({ label: \"ignifx:render-texture-read\" });\n encoder.copyTextureToBuffer({ texture }, { buffer, bytesPerRow }, { width, height });\n device.queue.submit([encoder.finish()]);\n await buffer.mapAsync(GPUMapMode.READ);\n const mapped = new Uint8Array(buffer.getMappedRange());\n const out = new Uint8ClampedArray(rowBytes * height);\n for (let row = 0; row < height; row += 1) {\n out.set(mapped.subarray(row * bytesPerRow, row * bytesPerRow + rowBytes), row * rowBytes);\n }\n if (texture.format.startsWith(\"bgra\")) {\n for (let index = 0; index < out.length; index += BYTES_PER_PIXEL) {\n const blue = out[index] ?? 0;\n out[index] = out[index + 2] ?? 0;\n out[index + 2] = blue;\n }\n }\n return out;\n } finally {\n buffer.destroy();\n }\n}\n"],"mappings":"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"}
@@ -0,0 +1,13 @@
1
+ //#region \0rolldown/runtime.js
2
+ var __defProp = Object.defineProperty;
3
+ var __exportAll = (all, no_symbols) => {
4
+ let target = {};
5
+ for (var name in all) __defProp(target, name, {
6
+ get: all[name],
7
+ enumerable: true
8
+ });
9
+ if (!no_symbols) __defProp(target, Symbol.toStringTag, { value: "Module" });
10
+ return target;
11
+ };
12
+ //#endregion
13
+ export { __exportAll as t };
@@ -14,23 +14,23 @@ import { addTaskAfter, buildFrameGraphTask, createCopyToTextureTask, createRende
14
14
  * @internal
15
15
  */
16
16
  function installSceneColorPasses(engine, scene, presenter, passes, isFrameGraphBuilt) {
17
- const { task: sceneTask, target: sceneTarget, format } = presenter.scenePass;
18
- const scratch = createRenderTarget({
19
- lbl: "ignifx:scene-color-scratch",
20
- format,
21
- samples: 1,
22
- size: engine
23
- });
17
+ const { task: sceneTask, target: sceneTarget, format, isTargetWritable } = presenter.scenePass;
18
+ const scratches = [];
24
19
  const tasks = [];
25
20
  let source = sceneTarget;
26
21
  for (const pass of passes) {
27
- const target = source === sceneTarget ? scratch : sceneTarget;
22
+ const target = sceneColorPassTarget(source, sceneTarget, isTargetWritable, scratches, (index) => createRenderTarget({
23
+ lbl: index === 0 ? "ignifx:scene-color-scratch" : "ignifx:scene-color-scratch-2",
24
+ format,
25
+ samples: 1,
26
+ size: engine
27
+ }));
28
28
  tasks.push(pass.create(source, target));
29
29
  source = target;
30
30
  }
31
31
  if (source !== sceneTarget) tasks.push(createCopyToTextureTask({
32
32
  name: "ignifx:scene-color-copy",
33
- sourceTexture: scratch,
33
+ sourceTexture: source,
34
34
  targetTexture: sceneTarget
35
35
  }, engine, scene));
36
36
  let after = sceneTask;
@@ -55,11 +55,34 @@ function installSceneColorPasses(engine, scene, presenter, passes, isFrameGraphB
55
55
  if (list !== null && index >= 0) list.splice(index, 1);
56
56
  task.dispose();
57
57
  }
58
- disposeRenderTarget(scratch);
58
+ for (const scratch of scratches) disposeRenderTarget(scratch);
59
59
  }
60
60
  };
61
61
  }
62
+ /**
63
+ * Picks where the next scene-colour pass writes: back into the scene target when that is allowed
64
+ * and the pass does not read it, otherwise the scratch target the pass does not read.
65
+ *
66
+ * @param source - What the pass reads.
67
+ * @param sceneTarget - The scene's colour target.
68
+ * @param isTargetWritable - Whether a pass may write `sceneTarget` (`ScenePass.isTargetWritable` in `./render-path.ts`).
69
+ * @param scratches - The scratch targets made so far; a new one is appended when needed.
70
+ * @param createScratch - Makes the scratch target at an index, 0 or 1.
71
+ * @returns The target, never `source`.
72
+ *
73
+ * @internal
74
+ */
75
+ function sceneColorPassTarget(source, sceneTarget, isTargetWritable, scratches, createScratch) {
76
+ if (source !== sceneTarget && isTargetWritable) return sceneTarget;
77
+ const index = source === scratches[0] ? 1 : 0;
78
+ let scratch = scratches[index];
79
+ if (scratch === void 0) {
80
+ scratch = createScratch(index);
81
+ scratches[index] = scratch;
82
+ }
83
+ return scratch;
84
+ }
62
85
  //#endregion
63
- export { installSceneColorPasses };
86
+ export { installSceneColorPasses, sceneColorPassTarget };
64
87
 
65
- //# sourceMappingURL=scene-color-passes-DlNr-qyZ.js.map
88
+ //# sourceMappingURL=scene-color-passes-B93qTOka.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"scene-color-passes-B93qTOka.js","names":[],"sources":["../src/lite/gpu/scene-color-passes.ts"],"sourcesContent":["import {\n addTaskAfter,\n buildFrameGraphTask,\n createCopyToTextureTask,\n createRenderTarget,\n disposeRenderTarget,\n getFrameGraph,\n} from \"@babylonjs/lite\";\nimport { frameGraphTasks } from \"./scene-inputs.js\";\nimport type { ScenePresenter } from \"./render-path.js\";\nimport type { EngineContext, RenderTarget, SceneContext, Task } from \"@babylonjs/lite\";\n\n/**\n * Scene-colour passes (`docs/architecture/07-rendering.md` §2.7, GI plan steps G10 and G11): Lite\n * screen-space effects that read the lit scene colour and the shared scene-input depth, and whose\n * result replaces the scene colour before anything else reads it. Its own chunk, loaded with the\n * first such effect (`CONSTITUTION.md` §2.5).\n *\n * ```text\n * scene ─→ S ─ pass 1 ─→ scratch ─ pass 2 ─→ S ─ … [─ copy ─→ S] ─→ present / output pass / chain\n * ```\n *\n * `S` is the presenter's {@link ScenePresenter.scenePass} target: `sceneColor` on the plain path,\n * the linear `rgba16float` target under `rendering.hdr`, so the passes see linear colour ahead of\n * the output pass there. Lite's composite cannot write its own source, so under HDR the passes\n * ping-pong between `S` and one scratch target of the same format, and a copy brings an odd count\n * back into `S`. On the plain path no pass may write `S` (`ScenePass.isTargetWritable` in `./render-path.ts`): the\n * passes ping-pong between two scratch targets and the copy always runs. Every task sits right after\n * the scene task, ahead of the present blit, the HDR output pass and a `PostProcessStack` chain\n * alike, which therefore need no change.\n */\n\n/**\n * One scene-colour effect, as the installer sees it.\n *\n * @internal\n */\nexport interface SceneColorPass {\n /**\n * Creates the effect's task.\n *\n * @param source - The colour it reads.\n * @param target - The colour it writes; never `source`.\n * @returns The task.\n */\n create(source: RenderTarget, target: RenderTarget): Task;\n}\n\n/**\n * The installed passes.\n *\n * @internal\n */\nexport interface InstalledSceneColorPasses {\n /** How many tasks were added, copy included. */\n readonly taskCount: number;\n /** Removes and disposes every task and the scratch target. Idempotent. */\n dispose(): void;\n}\n\n/**\n * Inserts the passes after the scene task, in order.\n *\n * @param engine - The engine; also the surface the scratch target is sized by.\n * @param scene - The scene.\n * @param presenter - The offscreen render path.\n * @param passes - The effects, first to last.\n * @param isFrameGraphBuilt - Whether the scene is registered, so each task is recorded now.\n * @returns The handle that takes them out again.\n *\n * @internal\n */\nexport function installSceneColorPasses(\n engine: EngineContext,\n scene: SceneContext,\n presenter: ScenePresenter,\n passes: readonly SceneColorPass[],\n isFrameGraphBuilt: boolean,\n): InstalledSceneColorPasses {\n const { task: sceneTask, target: sceneTarget, format, isTargetWritable } = presenter.scenePass;\n const scratches: RenderTarget[] = [];\n const tasks: Task[] = [];\n let source = sceneTarget;\n for (const pass of passes) {\n const target = sceneColorPassTarget(source, sceneTarget, isTargetWritable, scratches, (index) =>\n createRenderTarget({\n lbl: index === 0 ? \"ignifx:scene-color-scratch\" : \"ignifx:scene-color-scratch-2\",\n format,\n samples: 1,\n size: engine,\n }),\n );\n tasks.push(pass.create(source, target));\n source = target;\n }\n if (source !== sceneTarget) {\n tasks.push(\n createCopyToTextureTask(\n { name: \"ignifx:scene-color-copy\", sourceTexture: source, targetTexture: sceneTarget },\n engine,\n scene,\n ),\n );\n }\n let after = sceneTask;\n for (const task of tasks) {\n addTaskAfter(scene, task, after);\n after = task;\n }\n if (isFrameGraphBuilt) {\n const graph = getFrameGraph(scene);\n for (const task of tasks) {\n buildFrameGraphTask(graph, task);\n }\n }\n let isDisposed = false;\n return {\n taskCount: tasks.length,\n dispose(): void {\n if (isDisposed) {\n return;\n }\n isDisposed = true;\n const list = frameGraphTasks(scene);\n for (const task of tasks) {\n // Disable first: a disposed task that still executes is a use-after-free.\n task.executionEnabled = false;\n const index = list?.indexOf(task) ?? -1;\n if (list !== null && index >= 0) {\n list.splice(index, 1);\n }\n task.dispose();\n }\n for (const scratch of scratches) {\n disposeRenderTarget(scratch);\n }\n },\n };\n}\n\n/**\n * Picks where the next scene-colour pass writes: back into the scene target when that is allowed\n * and the pass does not read it, otherwise the scratch target the pass does not read.\n *\n * @param source - What the pass reads.\n * @param sceneTarget - The scene's colour target.\n * @param isTargetWritable - Whether a pass may write `sceneTarget` (`ScenePass.isTargetWritable` in `./render-path.ts`).\n * @param scratches - The scratch targets made so far; a new one is appended when needed.\n * @param createScratch - Makes the scratch target at an index, 0 or 1.\n * @returns The target, never `source`.\n *\n * @internal\n */\nexport function sceneColorPassTarget<T>(\n source: T,\n sceneTarget: T,\n isTargetWritable: boolean,\n scratches: T[],\n createScratch: (index: number) => T,\n): T {\n if (source !== sceneTarget && isTargetWritable) {\n return sceneTarget;\n }\n const index = source === scratches[0] ? 1 : 0;\n let scratch = scratches[index];\n if (scratch === undefined) {\n scratch = createScratch(index);\n scratches[index] = scratch;\n }\n return scratch;\n}\n"],"mappings":";;;;;;;;;;;;;;;AAwEA,SAAgB,wBACd,QACA,OACA,WACA,QACA,mBAC2B;CAC3B,MAAM,EAAE,MAAM,WAAW,QAAQ,aAAa,QAAQ,qBAAqB,UAAU;CACrF,MAAM,YAA4B,CAAC;CACnC,MAAM,QAAgB,CAAC;CACvB,IAAI,SAAS;CACb,KAAK,MAAM,QAAQ,QAAQ;EACzB,MAAM,SAAS,qBAAqB,QAAQ,aAAa,kBAAkB,YAAY,UACrF,mBAAmB;GACjB,KAAK,UAAU,IAAI,+BAA+B;GAClD;GACA,SAAS;GACT,MAAM;EACR,CAAC,CACH;EACA,MAAM,KAAK,KAAK,OAAO,QAAQ,MAAM,CAAC;EACtC,SAAS;CACX;CACA,IAAI,WAAW,aACb,MAAM,KACJ,wBACE;EAAE,MAAM;EAA2B,eAAe;EAAQ,eAAe;CAAY,GACrF,QACA,KACF,CACF;CAEF,IAAI,QAAQ;CACZ,KAAK,MAAM,QAAQ,OAAO;EACxB,aAAa,OAAO,MAAM,KAAK;EAC/B,QAAQ;CACV;CACA,IAAI,mBAAmB;EACrB,MAAM,QAAQ,cAAc,KAAK;EACjC,KAAK,MAAM,QAAQ,OACjB,oBAAoB,OAAO,IAAI;CAEnC;CACA,IAAI,aAAa;CACjB,OAAO;EACL,WAAW,MAAM;EACjB,UAAgB;GACd,IAAI,YACF;GAEF,aAAa;GACb,MAAM,OAAO,gBAAgB,KAAK;GAClC,KAAK,MAAM,QAAQ,OAAO;IAExB,KAAK,mBAAmB;IACxB,MAAM,QAAQ,MAAM,QAAQ,IAAI,KAAK;IACrC,IAAI,SAAS,QAAQ,SAAS,GAC5B,KAAK,OAAO,OAAO,CAAC;IAEtB,KAAK,QAAQ;GACf;GACA,KAAK,MAAM,WAAW,WACpB,oBAAoB,OAAO;EAE/B;CACF;AACF;;;;;;;;;;;;;;AAeA,SAAgB,qBACd,QACA,aACA,kBACA,WACA,eACG;CACH,IAAI,WAAW,eAAe,kBAC5B,OAAO;CAET,MAAM,QAAQ,WAAW,UAAU,KAAK,IAAI;CAC5C,IAAI,UAAU,UAAU;CACxB,IAAI,YAAY,KAAA,GAAW;EACzB,UAAU,cAAc,KAAK;EAC7B,UAAU,SAAS;CACrB;CACA,OAAO;AACT"}
@@ -1,20 +1,9 @@
1
- import { o as CoreErrorCode, t as IgnifxError } from "./ignifx-error-oYdVnT1S.js";
1
+ import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
2
+ import { o as CoreErrorCode, t as IgnifxError } from "./ignifx-error-B8ByiSfJ.js";
3
+ import { M as setOwnJsonProperty } from "./prefab-overrides-DT-wHHAJ.js";
2
4
  import { t as Color } from "./color-DrR6GFTd.js";
3
- import { t as setOwnJsonProperty } from "./json-CzZZ6K4x.js";
4
- import { r as isHdrScene } from "./render-path-Be7WgN7r.js";
5
+ import { r as isHdrScene } from "./render-path-D11i_7X8.js";
5
6
  import { n as IGNIFX_UNIFORM_TYPES, r as LITE_SYSTEM_UNIFORM_NAMES, t as IGNIFX_UNIFORM_NAMES } from "./shader-declaration-5q__jycG.js";
6
- //#region \0rolldown/runtime.js
7
- var __defProp = Object.defineProperty;
8
- var __exportAll = (all, no_symbols) => {
9
- let target = {};
10
- for (var name in all) __defProp(target, name, {
11
- get: all[name],
12
- enumerable: true
13
- });
14
- if (!no_symbols) __defProp(target, Symbol.toStringTag, { value: "Module" });
15
- return target;
16
- };
17
- //#endregion
18
7
  //#region src/render/shader-material.ts
19
8
  var shader_material_exports = /* @__PURE__ */ __exportAll({
20
9
  ShaderMaterialRegistry: () => ShaderMaterialRegistry,
@@ -174,7 +163,7 @@ let adapter = null;
174
163
  */
175
164
  async function loadShaderMaterialAdapter() {
176
165
  if (adapter !== null) return;
177
- const loaded = await import("./shader-material-C0TAUr4t.js");
166
+ const loaded = await import("./shader-material-CaAkv5nT.js");
178
167
  loaded.enableShaderUniformCaching();
179
168
  adapter = loaded;
180
169
  }
@@ -1021,4 +1010,4 @@ function shapeMismatch(declaration, material, expected, actual) {
1021
1010
  //#endregion
1022
1011
  export { shader_material_exports as n, shaderMaterialsOf as t };
1023
1012
 
1024
- //# sourceMappingURL=shader-material-B6p66wB8.js.map
1013
+ //# sourceMappingURL=shader-material-C2_UCYdO.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"shader-material-B6p66wB8.js","names":[],"sources":["../src/render/shader-material.ts"],"sourcesContent":["import { CoreErrorCode } from \"../errors/error-codes.js\";\nimport { IgnifxError } from \"../errors/ignifx-error.js\";\nimport { isHdrScene } from \"../lite/gpu/render-path.js\";\nimport { Color } from \"../math/color.js\";\nimport { setOwnJsonProperty } from \"../schema/json.js\";\nimport { IGNIFX_UNIFORM_TYPES, IGNIFX_UNIFORM_NAMES, LITE_SYSTEM_UNIFORM_NAMES } from \"./shader-declaration.js\";\nimport type { ShaderAsset } from \"./shader-asset.js\";\nimport type {\n IgnifxUniformName,\n ShaderDeclaration,\n ShaderTextureDeclaration,\n ShaderUniformDeclaration,\n ShaderUniformType,\n} from \"./shader-declaration.js\";\nimport type { ShaderMaterialDefinition } from \"./shader-material-definition.js\";\nimport type { StorageBufferAsset } from \"./storage-buffer-asset.js\";\nimport type { TextureAsset } from \"./texture-asset.js\";\nimport type { App } from \"../app/types.js\";\nimport type { AssetHandle } from \"../assets/types.js\";\nimport type {\n LiteShaderMaterial,\n ShaderMaterialAdapter,\n ShaderMaterialBuildOptions,\n ShaderSamplerEntry,\n ShaderStorageEntry,\n ShaderUniformEntry,\n} from \"../lite/gpu/shader-material.js\";\nimport type { LiteTexture2D } from \"../lite/gpu/texture.js\";\nimport type { ColorLike } from \"../math/types.js\";\nimport type { Disconnect } from \"../signal/signal.js\";\n\n/**\n * The `\"shader\"` material family (`docs/plan/2026-09-terrain-particles-shaders.md` §3.1): a\n * `ShaderAsset` plus the values a material sets on it.\n *\n * Nothing here imports Babylon Lite: {@link toShaderMaterialOptions} is the whole mapping onto the\n * shape `createShaderMaterial` takes, as plain data, and the adapter itself arrives through\n * {@link loadShaderMaterialAdapter} so a project that loads no `.wgsl` never fetches that chunk\n * (`./shader-support.ts`).\n *\n * Two Lite rules shape the design:\n *\n * - A declared sampler must have something bound (error 309), so an unbound declared texture gets\n * the declaration's 1x1 fallback and `setTexture(name, null)` restores it rather than unbinding.\n * - A declared storage buffer must have something bound too (error 310), and `array<T>` has no 1x1\n * equivalent, so such a material is not drawable until `setStorageBuffer` binds one.\n */\n\n/** The uniform names Babylon Lite and ignifx write themselves, which a material may not set. */\nconst ENGINE_UNIFORM_NAMES: readonly string[] = Object.freeze([...LITE_SYSTEM_UNIFORM_NAMES, ...IGNIFX_UNIFORM_NAMES]);\n\n/** How many floats the `PreRender` system's frame buffer holds: direction, colour, ambient. */\nconst FRAME_FLOATS = 9;\n\n/** Where the main light's direction starts inside the frame buffer. */\nconst DIRECTION_OFFSET = 0;\n\n/** Where the main light's colour starts inside the frame buffer. */\nconst LIGHT_COLOR_OFFSET = 3;\n\n/** Where the ambient colour starts inside the frame buffer. */\nconst AMBIENT_OFFSET = 6;\n\n/** How many elements each uniform type holds. */\nconst ELEMENT_COUNTS: Readonly<Record<ShaderUniformType, number>> = Object.freeze({\n f32: 1,\n u32: 1,\n i32: 1,\n \"vec2<f32>\": 2,\n \"vec3<f32>\": 3,\n \"vec4<f32>\": 4,\n \"mat4x4<f32>\": 16,\n});\n\n/**\n * The premultiplied-alpha blend state, which Babylon Lite's two named modes cannot express.\n *\n * @remarks\n * `blendMode: \"alpha\"` compiles `srcFactor: \"src-alpha\"` (`lib/material/shader/shader-pipeline.js`),\n * which multiplies the source colour by its alpha a second time. A premultiplied surface has\n * already done that, so it needs `srcFactor: \"one\"` — the state that lets additive and over-blended\n * particles share one draw.\n */\nconst PREMULTIPLIED_BLEND: GPUBlendState = Object.freeze({\n color: Object.freeze({ srcFactor: \"one\", dstFactor: \"one-minus-src-alpha\", operation: \"add\" }),\n alpha: Object.freeze({ srcFactor: \"one\", dstFactor: \"one-minus-src-alpha\", operation: \"add\" }),\n});\n\n/**\n * Maps a shader file's declaration and a material's `define` overrides onto the shape\n * `createShaderMaterial` takes.\n *\n * @remarks\n * Pure data in, pure data out, so every mapping rule is asserted headlessly:\n *\n * - `blend opaque` leaves blending off; `alpha` and `additive` are Lite's two named modes;\n * `premultiplied` supplies an explicit `GPUBlendState`, because Lite's `\"alpha\"` mode multiplies\n * by alpha a second time.\n * - `depthWrite` is passed explicitly, because the declaration already resolved Lite's\n * \"blended defaults to off unless stated\" rule.\n * - `depthTest off` becomes `depthCompare: \"always\"`; `depthTest on` passes `null`, which leaves\n * Lite's reverse-Z default in place.\n * - `instancing matrices` and `matrices-colors` differ only in `useThinInstanceColors`; which\n * pipeline layout a mesh draws with is Lite's decision at build time, from whether the mesh has a\n * thin-instance colour stream.\n * - A colour uniform's declared default is sRGB and is decoded here, which is the one place the\n * conversion happens for defaults.\n *\n * @param name - The material's name, for GPU debug labels.\n * @param source - The whole `.wgsl` file.\n * @param declaration - What the file's pragmas declared.\n * @param uniforms - The initial value of every custom uniform, keyed by name, already **linear**.\n * @param defines - The resolved `define` values.\n * @returns The options.\n *\n * @internal\n */\nexport function toShaderMaterialOptions(\n name: string,\n source: string,\n declaration: ShaderDeclaration,\n uniforms: ReadonlyMap<string, Float32Array>,\n defines: Readonly<Record<string, boolean | number>>,\n): ShaderMaterialBuildOptions {\n const entries: ShaderUniformEntry[] = [];\n // `for…of` rather than an indexed loop: this runs once per material build, not per frame, and the\n // iterator yields the element type rather than `T | undefined`.\n for (const system of declaration.system) {\n entries.push(system);\n }\n for (const ignifx of declaration.ignifx) {\n const type = IGNIFX_UNIFORM_TYPES[ignifx];\n entries.push({ name: ignifx, type, defaultValue: zeros(ELEMENT_COUNTS[type]) });\n }\n for (const uniform of declaration.uniforms) {\n entries.push({\n name: uniform.name,\n type: uniform.type,\n defaultValue: Array.from(uniforms.get(uniform.name) ?? uniformStore(uniform)),\n });\n }\n const samplers: ShaderSamplerEntry[] = [];\n for (const texture of declaration.textures) {\n samplers.push({ name: texture.name, viewDimension: texture.array ? \"2d-array\" : \"2d\" });\n }\n const storageBuffers: ShaderStorageEntry[] = [];\n for (const storage of declaration.storage) {\n storageBuffers.push({ name: storage.name, type: storage.type });\n }\n const pipeline = declaration.pipeline;\n const blended = pipeline.blend !== \"opaque\";\n return {\n name,\n source,\n attributes: declaration.attributes,\n uniforms: entries,\n samplers,\n storageBuffers,\n defines,\n useThinInstanceColors: pipeline.instancing === \"matrices-colors\",\n needAlphaBlending: blended,\n blendMode: pipeline.blend === \"additive\" ? \"additive\" : \"alpha\",\n blend: pipeline.blend === \"premultiplied\" ? PREMULTIPLIED_BLEND : null,\n transmissive: pipeline.transmissive,\n backFaceCulling: pipeline.cull === \"back\",\n depthWrite: pipeline.depthWrite,\n depthCompare: pipeline.depthTest ? null : \"always\",\n };\n}\n\n/** The dynamically imported Babylon Lite adapter, memoised for the process. */\nlet adapter: ShaderMaterialAdapter | null = null;\n\n/**\n * Loads the custom-WGSL half of the Babylon Lite adapter, once per process.\n *\n * @remarks\n * The shader **loader** awaits this before it hands back a `ShaderAsset`, which is what makes\n * {@link shaderMaterialAdapter} safe to call from the synchronous material builders. Loading it also\n * turns on Lite's cached uniform serialization plans, which is what makes the per-frame `time`\n * upload rewrite only the slots that changed.\n *\n * @returns A promise that resolves once the adapter is in place.\n *\n * @internal\n */\nexport async function loadShaderMaterialAdapter(): Promise<void> {\n if (adapter !== null) {\n return;\n }\n const loaded = await import(\"../lite/gpu/shader-material.js\");\n loaded.enableShaderUniformCaching();\n // The assignment is what checks `ShaderMaterialAdapter` against the module it stands for.\n adapter = loaded;\n}\n\n/**\n * The adapter, if it has been loaded.\n *\n * @returns The module, or `null` before any `.wgsl` has been loaded.\n *\n * @internal\n */\nexport function shaderMaterialAdapter(): ShaderMaterialAdapter | null {\n return adapter;\n}\n\n/**\n * The adapter, or the failure a material built before the `.wgsl` loader ran produces.\n *\n * @param shader - The shader being built, for the message.\n * @returns The adapter.\n * @throws IgnifxError with code `IGX-0715` when the chunk has not been loaded.\n */\nfunction requireShaderMaterialAdapter(shader: ShaderAsset): ShaderMaterialAdapter {\n const module = shaderMaterialAdapter();\n if (module === null) {\n throw new IgnifxError(\n CoreErrorCode.shaderCompileFailed,\n `${shader.address} cannot be built because the shader adapter has not been loaded.`,\n {\n context: { asset: shader.address, message: \"adapter not loaded\" },\n hint: \"Load the .wgsl through app.assets, which is what loads the adapter.\",\n },\n );\n }\n return module;\n}\n\n/**\n * The per-app state the shader material family needs: the 1x1 fallback textures declared samplers\n * fall back to, and the list of live materials whose per-frame ignifx uniforms have to be written.\n *\n * @remarks\n * It hangs off the app through a lazily created `WeakMap` rather than a service, so a shader\n * material works whether or not an extension registered anything, and two apps in one process keep\n * separate state (`CONSTITUTION.md` §3.6).\n *\n * @internal\n */\nexport class ShaderMaterialRegistry {\n readonly #app: App;\n\n /** Live materials that declare at least one ignifx uniform, in no particular order. */\n readonly #animated: ShaderMaterialState[] = [];\n\n readonly #fallbacks = new Map<string, LiteTexture2D>();\n\n /**\n * Creates the registry.\n *\n * @param app - The app it belongs to.\n */\n constructor(app: App) {\n this.#app = app;\n }\n\n /**\n * The materials the `PreRender` uniform system has to write this frame.\n *\n * @returns The list; the registry's own array, iterated without copying.\n */\n get animated(): readonly ShaderMaterialState[] {\n return this.#animated;\n }\n\n /**\n * Starts writing a material's ignifx uniforms every frame.\n *\n * @param state - The material.\n */\n add(state: ShaderMaterialState): void {\n if (!this.#animated.includes(state)) {\n this.#animated.push(state);\n }\n }\n\n /**\n * Stops writing a material's ignifx uniforms.\n *\n * @param state - The material.\n */\n remove(state: ShaderMaterialState): void {\n const index = this.#animated.indexOf(state);\n if (index < 0) {\n return;\n }\n const last = this.#animated.pop();\n if (last !== undefined && index < this.#animated.length) {\n this.#animated[index] = last;\n }\n }\n\n /**\n * The 1x1 texture a declared-but-unbound sampler is filled with, created on first use and shared\n * for the life of the app.\n *\n * @param declaration - The sampler declaration, for its `default` and `array` flags.\n * @returns The texture, or `null` under a headless app or before the adapter has loaded.\n */\n fallbackTexture(declaration: ShaderTextureDeclaration): LiteTexture2D | null {\n const module = shaderMaterialAdapter();\n if (module === null || this.#app.isHeadless) {\n return null;\n }\n return module.resolveFallbackTexture(\n this.#app.lite.engine,\n this.#fallbacks,\n declaration.fallback,\n declaration.array,\n );\n }\n}\n\n/** The per-app registries, created on first use so module scope allocates nothing. */\nlet registries: WeakMap<App, ShaderMaterialRegistry> | null = null;\n\n/**\n * The shader material state of one app.\n *\n * @param app - The app.\n * @returns Its registry, created on first use.\n *\n * @internal\n */\nexport function shaderMaterialsOf(app: App): ShaderMaterialRegistry {\n const map = (registries ??= new WeakMap<App, ShaderMaterialRegistry>());\n const existing = map.get(app);\n if (existing !== undefined) {\n return existing;\n }\n const created = new ShaderMaterialRegistry(app);\n map.set(app, created);\n return created;\n}\n\n/**\n * One live `\"shader\"` material: the Babylon Lite material, the CPU-side copy of every value written\n * to it, and the bindings it has to replay when the shader file or a `define` changes.\n *\n * @remarks\n * `MaterialAsset` owns one of these and forwards `setUniform`, `getUniform`, `setTexture`,\n * `setDefine`, and `setStorageBuffer` to it. It is `@internal` because the public surface is the\n * material's methods, not this object.\n *\n * @internal\n */\nexport class ShaderMaterialState {\n /** The definition the material was built from; a clone replays it. */\n readonly definition: ShaderMaterialDefinition;\n\n readonly #app: App;\n\n readonly #values = new Map<string, Float32Array>();\n\n readonly #textures = new Map<string, AssetHandle<TextureAsset> | null>();\n\n readonly #storage = new Map<string, AssetHandle<StorageBufferAsset> | null>();\n\n readonly #defines = new Map<string, boolean | number>();\n\n /** The last light values written, so an unchanged light costs no upload. */\n readonly #light = new Float32Array(FRAME_FLOATS);\n\n /** The ignifx-provided uniforms the file declares, paired with their stores. */\n readonly #engineSlots: { readonly name: IgnifxUniformName; readonly store: Float32Array }[] = [];\n\n #shader: ShaderAsset;\n\n #material: LiteShaderMaterial;\n\n /**\n * The adapter every write goes through. Captured once, because a state can only be built after\n * {@link buildLiteShaderMaterial} has proved the chunk is in memory.\n */\n readonly #adapter: ShaderMaterialAdapter;\n\n #hasLight = false;\n\n #hasWarnedAboutLight = false;\n\n #onReplaced: Disconnect | null = null;\n\n /**\n * Builds the material. Use {@link buildShaderMaterialState}.\n *\n * @param app - The app that owns the engine, the log, and the registry.\n * @param shader - The shader the material sets values on.\n * @param definition - The declaration.\n * @param material - The already-built Babylon Lite material.\n * @param liteAdapter - The custom-WGSL adapter every write goes through.\n */\n constructor(\n app: App,\n shader: ShaderAsset,\n definition: ShaderMaterialDefinition,\n material: LiteShaderMaterial,\n liteAdapter: ShaderMaterialAdapter,\n ) {\n this.#app = app;\n this.#adapter = liteAdapter;\n this.#shader = shader;\n this.definition = definition;\n this.#material = material;\n // Not zeros: a light really at the origin pointing along +Z would then never be written.\n this.#light.fill(Number.NaN);\n }\n\n /**\n * The shader the material is values for.\n *\n * @returns The shader asset, which a hot reload replaces.\n */\n get shader(): ShaderAsset {\n return this.#shader;\n }\n\n /**\n * The Babylon Lite material, which `setDefine` and a hot reload replace with a new object.\n *\n * @returns The material.\n */\n get material(): LiteShaderMaterial {\n return this.#material;\n }\n\n /**\n * Whether the shader declares any ignifx-provided uniform, and so needs a per-frame write.\n *\n * @returns `true` when the `PreRender` system has work to do for this material.\n */\n get isAnimated(): boolean {\n return this.#shader.declaration.ignifx.length > 0;\n }\n\n /**\n * Whether every declared storage buffer has a buffer bound, which is what Babylon Lite needs\n * before the material can be drawn at all.\n *\n * @returns `true` when the material is drawable.\n */\n get isDrawable(): boolean {\n const declared = this.#shader.declaration.storage;\n for (let index = 0; index < declared.length; index += 1) {\n const name = declared[index]?.name;\n if (name !== undefined && (this.#storage.get(name) ?? null) === null) {\n return false;\n }\n }\n return true;\n }\n\n /**\n * Writes a declared uniform.\n *\n * @param name - The uniform's name.\n * @param value - The value: a number, a numeric array, or — for a `color` uniform — an sRGB\n * colour, which is uploaded linear.\n * @throws IgnifxError with code `IGX-0712` when the shader declares no such uniform or the engine\n * writes it, or `IGX-0713` when the value has the wrong shape.\n */\n setUniform(name: string, value: number | readonly number[] | Float32Array | ColorLike): void {\n const declaration = this.#writableUniform(name);\n const store = this.#values.get(name) ?? uniformStore(declaration);\n this.#values.set(name, store);\n writeUniformValue(store, declaration, value, this.definition.name);\n this.#write(name, store);\n }\n\n /**\n * Reads the current CPU-side value of a declared uniform.\n *\n * @param name - The uniform's name.\n * @param out - Receives the value for a vector or matrix uniform; a fresh array is allocated when\n * it is omitted.\n * @returns The number for a scalar uniform, or the filled array.\n * @throws IgnifxError with code `IGX-0712` when the shader declares no such uniform, or\n * `IGX-0713` when `out` is too short.\n */\n getUniform(name: string, out?: Float32Array): number | Float32Array {\n const declaration = this.#uniform(name);\n const store = this.#values.get(name) ?? uniformStore(declaration);\n this.#values.set(name, store);\n if (store.length === 1 && out === undefined) {\n return store[0] ?? 0;\n }\n if (out === undefined) {\n return Float32Array.from(store);\n }\n if (out.length < store.length) {\n throw new IgnifxError(\n CoreErrorCode.shaderValueMismatch,\n `${name} on ${this.definition.name} expects ${String(store.length)} floats, not ${String(out.length)}.`,\n {\n context: { name, material: this.definition.name, expected: store.length, actual: out.length },\n hint: \"Pass an out array at least as long as the uniform's element count.\",\n },\n );\n }\n out.set(store);\n return out;\n }\n\n /**\n * Binds a texture to a declared sampler, or restores the declaration's fallback.\n *\n * @param name - The sampler's name.\n * @param texture - The texture, or `null` for the declared 1x1 fallback.\n * @throws IgnifxError with code `IGX-0712` when the shader declares no such sampler.\n */\n setTexture(name: string, texture: AssetHandle<TextureAsset> | null): void {\n const declaration = this.#texture(name);\n this.#textures.set(name, texture);\n this.#bindTexture(declaration, texture);\n }\n\n /**\n * Binds a storage buffer to a declared binding.\n *\n * @param name - The binding's name.\n * @param buffer - The buffer, or `null` to unbind. A material with an unbound declared storage\n * buffer cannot be drawn.\n * @throws IgnifxError with code `IGX-0712` when the shader declares no such storage buffer.\n */\n setStorageBuffer(name: string, buffer: AssetHandle<StorageBufferAsset> | null): void {\n const declared = this.#shader.declaration.storage;\n let found = false;\n for (let index = 0; index < declared.length; index += 1) {\n if (declared[index]?.name === name) {\n found = true;\n break;\n }\n }\n if (!found) {\n throw this.#unknownBinding(name, \"storage buffer\");\n }\n this.#storage.set(name, buffer);\n this.#bindStorage(name, buffer);\n }\n\n /**\n * Overrides a declared `define` and rebuilds the Babylon Lite material, because a define is a\n * WGSL `const` baked into the compiled pipeline.\n *\n * @remarks\n * The rebuild replaces the Lite material **object**. `MeshRenderer` re-reads\n * `MaterialAsset.lite.material` every `PreRender` and writes it onto its mesh when it changed,\n * and Lite's `mesh.material` setter enqueues a material swap that the next frame drains\n * (`lib/scene/mesh-scene-registry.js`), so the new pipeline is picked up on the following frame\n * with no explicit topology flag.\n *\n * @param name - The define's name.\n * @param value - The new value.\n * @throws IgnifxError with code `IGX-0712` when the shader declares no such define.\n */\n setDefine(name: string, value: boolean | number): void {\n const declared = this.#shader.declaration.defines;\n let fileValue: boolean | number | undefined;\n for (let index = 0; index < declared.length; index += 1) {\n const definition = declared[index];\n if (definition?.name === name) {\n fileValue = definition.value;\n break;\n }\n }\n if (fileValue === undefined) {\n throw this.#unknownBinding(name, \"define\");\n }\n // Compared against the value in force, not against the override map, so re-setting what the\n // file already declares is not a pipeline rebuild.\n if ((this.#defines.get(name) ?? fileValue) === value) {\n return;\n }\n this.#defines.set(name, value);\n this.#rebuild(this.#shader);\n }\n\n /**\n * Writes this frame's ignifx uniforms. The `PreRender` system calls it.\n *\n * @param time - Scaled seconds since `app.start()`.\n * @param unscaledTime - Unscaled seconds since `app.start()`.\n * @param deltaTime - Scaled seconds since the previous frame.\n * @param light - Nine floats: the main light's world direction, its linear colour times its\n * intensity, and the ambient colour.\n * @param hasLight - Whether an enabled directional light supplied the first six.\n */\n writeFrameUniforms(\n time: number,\n unscaledTime: number,\n deltaTime: number,\n light: Float32Array,\n hasLight: boolean,\n ): void {\n let lightChanged = this.#hasLight !== hasLight;\n this.#hasLight = hasLight;\n for (let index = 0; index < this.#light.length; index += 1) {\n if (this.#light[index] !== light[index]) {\n this.#light[index] = light[index] ?? 0;\n lightChanged = true;\n }\n }\n const slots = this.#engineSlots;\n for (let index = 0; index < slots.length; index += 1) {\n const slot = slots[index];\n if (slot === undefined) {\n continue;\n }\n switch (slot.name) {\n case \"time\":\n this.#writeScalar(slot.name, slot.store, time);\n break;\n case \"unscaledTime\":\n this.#writeScalar(slot.name, slot.store, unscaledTime);\n break;\n case \"deltaTime\":\n this.#writeScalar(slot.name, slot.store, deltaTime);\n break;\n case \"mainLightDirection\":\n if (lightChanged) {\n this.#writeTriple(slot.name, slot.store, light, DIRECTION_OFFSET);\n }\n break;\n case \"mainLightColor\":\n if (lightChanged) {\n this.#writeTriple(slot.name, slot.store, light, LIGHT_COLOR_OFFSET);\n }\n break;\n case \"ambientColor\":\n if (lightChanged) {\n this.#writeTriple(slot.name, slot.store, light, AMBIENT_OFFSET);\n }\n break;\n default:\n break;\n }\n }\n if (!hasLight && !this.#hasWarnedAboutLight && this.#needsLight()) {\n this.#hasWarnedAboutLight = true;\n const declared = this.#engineSlots.map((slot) => slot.name).join(\", \");\n this.#app.log.warnOnce(\n `${CoreErrorCode.shaderLightUniformWithoutLight}:${this.definition.name}`,\n `${CoreErrorCode.shaderLightUniformWithoutLight}: ${this.definition.name} declares ${declared}, ` +\n \"but this world has no enabled directional light; zeros are uploaded.\",\n );\n }\n }\n\n /**\n * Replays the definition's values, textures, defines, and storage bindings onto a freshly built\n * Babylon Lite material, and connects the hot-reload hook. Called once, by\n * {@link buildShaderMaterialState}.\n *\n * @param textures - The texture handles the loader resolved, in declaration order.\n */\n initialise(textures: readonly AssetHandle<TextureAsset>[]): void {\n const declaration = this.#shader.declaration;\n for (const name of Object.keys(this.definition.defines)) {\n const value = this.definition.defines[name];\n if (value !== undefined) {\n this.#defines.set(name, value);\n }\n }\n for (const name of Object.keys(this.definition.values)) {\n const value = this.definition.values[name];\n if (value !== undefined) {\n this.setUniform(name, value);\n }\n }\n const addresses = Object.keys(this.definition.textures);\n for (let index = 0; index < declaration.textures.length; index += 1) {\n const declared = declaration.textures[index];\n if (declared === undefined) {\n continue;\n }\n const slot = addresses.indexOf(declared.name);\n const handle = slot < 0 ? undefined : textures[slot];\n this.#textures.set(declared.name, handle ?? null);\n this.#bindTexture(declared, handle ?? null);\n }\n this.#refreshEngineSlots();\n if (this.isAnimated) {\n shaderMaterialsOf(this.#app).add(this);\n }\n const source = this.#app.assets.get<ShaderAsset>(this.definition.shader);\n this.#onReplaced =\n source?.onReplaced.connect((value: ShaderAsset): void => {\n this.#reload(value);\n }) ?? null;\n }\n\n /**\n * Stops the per-frame writes and the hot-reload hook. The `material` asset type's `unload` runs\n * it when the last holder releases the material.\n */\n dispose(): void {\n this.#onReplaced?.();\n this.#onReplaced = null;\n shaderMaterialsOf(this.#app).remove(this);\n }\n\n /**\n * Rebuilds the Lite material for a replaced shader file, keeping the previous one on failure.\n *\n * @param shader - The re-parsed shader asset.\n */\n #reload(shader: ShaderAsset): void {\n try {\n this.#rebuild(shader);\n this.#shader = shader;\n } catch (error: unknown) {\n this.#app.onError.emit({\n error: new IgnifxError(\n CoreErrorCode.shaderCompileFailed,\n `${shader.address} failed to rebuild; the previous material stays in use. ${String(error)}`,\n {\n context: { asset: shader.address, message: String(error) },\n cause: error,\n hint: \"Fix the shader file; the running material is the last one that built.\",\n },\n ),\n source: \"asset\",\n phase: null,\n entity: null,\n component: null,\n });\n }\n }\n\n /**\n * Builds a new Lite material from a declaration and replays every binding that still exists.\n *\n * @param shader - The shader to build from.\n */\n #rebuild(shader: ShaderAsset): void {\n const declaration = shader.declaration;\n const previous = this.#shader;\n // The Lite material is replaced halfway through, so a failure has to put the old one back or the\n // material would be left drawing a new program against the old declaration's bindings.\n const previousMaterial = this.#material;\n const previousValues = new Map(this.#values);\n this.#shader = shader;\n try {\n const values = new Map<string, Float32Array>();\n for (let index = 0; index < declaration.uniforms.length; index += 1) {\n const uniform = declaration.uniforms[index];\n if (uniform === undefined) {\n continue;\n }\n const kept = this.#values.get(uniform.name);\n values.set(\n uniform.name,\n kept !== undefined && kept.length === ELEMENT_COUNTS[uniform.type] ? kept : uniformStore(uniform),\n );\n }\n this.#material = buildLiteShaderMaterial(\n this.#app,\n this.definition.name,\n shader,\n values,\n this.#resolveDefines(shader),\n );\n this.#values.clear();\n for (const [name, store] of values) {\n this.#values.set(name, store);\n }\n this.#rebind(declaration);\n } catch (error: unknown) {\n this.#shader = previous;\n this.#material = previousMaterial;\n this.#values.clear();\n for (const [name, store] of previousValues) {\n this.#values.set(name, store);\n }\n throw error;\n }\n }\n\n /**\n * Re-applies the texture and storage bindings that the new declaration still has, dropping the\n * ones it no longer declares.\n *\n * @param declaration - The new declaration.\n */\n #rebind(declaration: ShaderDeclaration): void {\n const textures = new Map(this.#textures);\n this.#textures.clear();\n for (let index = 0; index < declaration.textures.length; index += 1) {\n const declared = declaration.textures[index];\n if (declared === undefined) {\n continue;\n }\n const handle = textures.get(declared.name) ?? null;\n this.#textures.set(declared.name, handle);\n this.#bindTexture(declared, handle);\n }\n const storage = new Map(this.#storage);\n this.#storage.clear();\n for (let index = 0; index < declaration.storage.length; index += 1) {\n const name = declaration.storage[index]?.name;\n if (name === undefined) {\n continue;\n }\n const handle = storage.get(name) ?? null;\n this.#storage.set(name, handle);\n this.#bindStorage(name, handle);\n }\n this.#refreshEngineSlots();\n const registry = shaderMaterialsOf(this.#app);\n if (this.isAnimated) {\n registry.add(this);\n } else {\n registry.remove(this);\n }\n this.#light.fill(Number.NaN);\n }\n\n /**\n * The declared `define` values with this material's overrides applied.\n *\n * @param shader - The shader whose declaration supplies the defaults.\n * @returns The resolved values.\n */\n #resolveDefines(shader: ShaderAsset): Readonly<Record<string, boolean | number>> {\n const resolved: Record<string, boolean | number> = {};\n const declared = shader.declaration.defines;\n for (let index = 0; index < declared.length; index += 1) {\n const define = declared[index];\n if (define === undefined) {\n continue;\n }\n setOwnJsonProperty(resolved, define.name, this.#defines.get(define.name) ?? define.value);\n }\n return resolved;\n }\n\n /**\n * Binds a texture, or the declaration's fallback when there is none.\n *\n * @param declaration - The sampler declaration.\n * @param handle - The texture handle, or `null`.\n */\n #bindTexture(declaration: ShaderTextureDeclaration, handle: AssetHandle<TextureAsset> | null): void {\n const loaded = handle?.state === \"loaded\" ? handle.value.lite.texture : null;\n this.#adapter.writeShaderTexture(\n this.#material,\n declaration.name,\n loaded ?? shaderMaterialsOf(this.#app).fallbackTexture(declaration),\n );\n }\n\n /**\n * Binds a storage buffer.\n *\n * @param name - The binding's name.\n * @param handle - The buffer handle, or `null`.\n */\n #bindStorage(name: string, handle: AssetHandle<StorageBufferAsset> | null): void {\n this.#adapter.writeShaderStorageBuffer(\n this.#material,\n name,\n handle?.state === \"loaded\" ? handle.value.lite.buffer : null,\n );\n }\n\n /**\n * Writes one CPU-side value through to Babylon Lite.\n *\n * @param name - The uniform's name.\n * @param store - The value.\n */\n #write(name: string, store: Float32Array): void {\n this.#adapter.writeShaderUniform(this.#material, name, store);\n }\n\n /**\n * Writes one engine-owned scalar uniform through its CPU-side store.\n *\n * @param name - The uniform's name.\n * @param store - The store, which is also what `getUniform` reads.\n * @param value - The value.\n */\n #writeScalar(name: string, store: Float32Array, value: number): void {\n store[0] = value;\n this.#adapter.writeShaderUniform(this.#material, name, store);\n }\n\n /**\n * Writes three floats of an engine-owned `vec3<f32>` uniform, without allocating.\n *\n * @param name - The uniform's name.\n * @param store - The store, which is also what `getUniform` reads.\n * @param source - The nine-float frame buffer.\n * @param offset - Where the triple starts inside it.\n */\n #writeTriple(name: string, store: Float32Array, source: Float32Array, offset: number): void {\n store.set(source.subarray(offset, offset + 3));\n this.#adapter.writeShaderUniform(this.#material, name, store);\n }\n\n /**\n * Resolves the CPU-side store of every ignifx-provided uniform the file declares, so the\n * per-frame write is an indexed loop with no name lookup (coding standards §7).\n */\n #refreshEngineSlots(): void {\n const slots = this.#engineSlots;\n slots.length = 0;\n const declared = this.#shader.declaration.ignifx;\n for (let index = 0; index < declared.length; index += 1) {\n const name = declared[index];\n if (name === undefined) {\n continue;\n }\n const count = ELEMENT_COUNTS[IGNIFX_UNIFORM_TYPES[name]];\n const store = this.#values.get(name) ?? new Float32Array(count);\n this.#values.set(name, store);\n slots.push({ name, store });\n }\n }\n\n /**\n * Whether the shader declares a uniform that needs a directional light.\n *\n * @returns `true` when `mainLightDirection` or `mainLightColor` is declared.\n */\n #needsLight(): boolean {\n const declared = this.#shader.declaration.ignifx;\n for (let index = 0; index < declared.length; index += 1) {\n const name = declared[index];\n if (name === \"mainLightDirection\" || name === \"mainLightColor\") {\n return true;\n }\n }\n return false;\n }\n\n /**\n * Looks a custom uniform declaration up.\n *\n * @param name - The uniform's name.\n * @returns The declaration.\n * @throws IgnifxError with code `IGX-0712`.\n */\n #uniform(name: string): ShaderUniformDeclaration {\n const custom = this.#customUniform(name);\n if (custom !== null) {\n return custom;\n }\n const engine = this.#engineUniform(name);\n if (engine !== null) {\n return engine;\n }\n throw this.#unknownBinding(name, \"uniform\");\n }\n\n /**\n * Looks a custom uniform declaration up, refusing the ones the engine writes.\n *\n * @param name - The uniform's name.\n * @returns The declaration.\n * @throws IgnifxError with code `IGX-0712`.\n */\n #writableUniform(name: string): ShaderUniformDeclaration {\n const custom = this.#customUniform(name);\n if (custom !== null) {\n return custom;\n }\n if (ENGINE_UNIFORM_NAMES.includes(name)) {\n throw new IgnifxError(\n CoreErrorCode.unknownShaderBinding,\n `${name} on ${this.definition.name} is written by the engine every frame and cannot be set.`,\n {\n context: { material: this.definition.name, name },\n hint: \"System uniforms come from Babylon Lite and the ignifx uniforms from the PreRender system.\",\n },\n );\n }\n throw this.#unknownBinding(name, \"uniform\");\n }\n\n /**\n * The file's own declaration of a uniform, if it declares one by that name.\n *\n * @param name - The uniform's name.\n * @returns The declaration, or `null`.\n */\n #customUniform(name: string): ShaderUniformDeclaration | null {\n const declared = this.#shader.declaration.uniforms;\n for (let index = 0; index < declared.length; index += 1) {\n const uniform = declared[index];\n if (uniform !== undefined && uniform.name === name) {\n return uniform;\n }\n }\n return null;\n }\n\n /**\n * The synthetic declaration of an ignifx-provided uniform the file declared, so `getUniform` can\n * read back what the `PreRender` system wrote.\n *\n * @param name - The uniform's name.\n * @returns The declaration, or `null` when the file declares no such engine uniform.\n */\n #engineUniform(name: string): ShaderUniformDeclaration | null {\n const declared = this.#shader.declaration.ignifx;\n for (let index = 0; index < declared.length; index += 1) {\n const ignifx = declared[index];\n if (ignifx !== undefined && ignifx === name) {\n return {\n name: ignifx,\n type: IGNIFX_UNIFORM_TYPES[ignifx],\n defaultValue: zeros(ELEMENT_COUNTS[IGNIFX_UNIFORM_TYPES[ignifx]]),\n color: false,\n range: null,\n step: null,\n tooltip: null,\n };\n }\n }\n return null;\n }\n\n /**\n * Looks a sampler declaration up.\n *\n * @param name - The sampler's name.\n * @returns The declaration.\n * @throws IgnifxError with code `IGX-0712`.\n */\n #texture(name: string): ShaderTextureDeclaration {\n const declared = this.#shader.declaration.textures;\n for (let index = 0; index < declared.length; index += 1) {\n const texture = declared[index];\n if (texture !== undefined && texture.name === name) {\n return texture;\n }\n }\n throw this.#unknownBinding(name, \"texture\");\n }\n\n /**\n * Builds the `IGX-0712` failure an undeclared binding name produces.\n *\n * @param name - The name that was asked for.\n * @param what - What kind of binding was expected.\n * @returns The error to throw.\n */\n #unknownBinding(name: string, what: string): IgnifxError {\n return new IgnifxError(\n CoreErrorCode.unknownShaderBinding,\n `${this.definition.name} declares no ${what} named ${name}.`,\n {\n context: { material: this.definition.name, name },\n hint: `Declare it in ${this.#shader.address} with an // @ignifx ${what} pragma.`,\n },\n );\n }\n}\n\n/**\n * Builds the live state of a `\"shader\"` material: the Babylon Lite material, then every value,\n * texture, and define the definition names.\n *\n * @param app - The app that owns the engine, the log, and the registry.\n * @param shader - The shader the material sets values on.\n * @param definition - The declaration.\n * @param textures - The texture handles the loader resolved, in the order the definition's\n * `textures` record names them.\n * @returns The state.\n * @throws IgnifxError with code `IGX-0715` when the adapter has not been loaded, `IGX-0712` for an\n * undeclared value or define name, or `IGX-0713` for a value of the wrong shape.\n *\n * @internal\n */\nexport function buildShaderMaterialState(\n app: App,\n shader: ShaderAsset,\n definition: ShaderMaterialDefinition,\n textures: readonly AssetHandle<TextureAsset>[],\n): ShaderMaterialState {\n const defines: Record<string, boolean | number> = {};\n const declared = shader.declaration.defines;\n for (let index = 0; index < declared.length; index += 1) {\n const define = declared[index];\n if (define !== undefined) {\n const given = Object.hasOwn(definition.defines, define.name) ? definition.defines[define.name] : undefined;\n setOwnJsonProperty(defines, define.name, given ?? define.value);\n }\n }\n for (const name of Object.keys(definition.defines)) {\n if (!Object.hasOwn(defines, name)) {\n throw new IgnifxError(\n CoreErrorCode.unknownShaderBinding,\n `${definition.name} declares no define named ${name}.`,\n {\n context: { material: definition.name, name },\n hint: `Declare it in ${shader.address} with an // @ignifx define pragma.`,\n },\n );\n }\n }\n const material = buildLiteShaderMaterial(app, definition.name, shader, new Map(), defines);\n const state = new ShaderMaterialState(app, shader, definition, material, requireShaderMaterialAdapter(shader));\n state.initialise(textures);\n return state;\n}\n\n/**\n * Builds the Babylon Lite material a declaration describes, through the dynamically loaded adapter.\n *\n * @remarks\n * Under `rendering.hdr` the fragment is wrapped to write linear colour (GI plan step G3), so the\n * output pass does not encode it a second time.\n *\n * @param app - The app, whose scene says whether it renders through `rendering.hdr`.\n * @param name - The material's name.\n * @param shader - The shader.\n * @param values - Current custom uniform values to seed the declaration's defaults with.\n * @param defines - The resolved `define` values.\n * @returns The Lite material.\n * @throws IgnifxError with code `IGX-0715` when the adapter has not been loaded yet.\n */\nfunction buildLiteShaderMaterial(\n app: App,\n name: string,\n shader: ShaderAsset,\n values: ReadonlyMap<string, Float32Array>,\n defines: Readonly<Record<string, boolean | number>>,\n): LiteShaderMaterial {\n const options = toShaderMaterialOptions(name, shader.source, shader.declaration, values, defines);\n const linearOutput = !app.isHeadless && isHdrScene(app.lite.scene);\n return requireShaderMaterialAdapter(shader).createShaderMaterialFromOptions(\n linearOutput ? { ...options, linearOutput } : options,\n );\n}\n\n/**\n * A number, or an array of that many zeros, matching what a uniform of that arity starts at.\n *\n * @param count - How many elements the uniform holds.\n * @returns The zero value.\n */\nfunction zeros(count: number): number | readonly number[] {\n if (count === 1) {\n return 0;\n }\n const values: number[] = [];\n for (let index = 0; index < count; index += 1) {\n values.push(0);\n }\n return values;\n}\n\n/**\n * A fresh CPU-side store for one uniform, filled with its declared default — **linear** for a\n * colour, because that is what the GPU reads.\n *\n * @param declaration - The uniform declaration.\n * @returns The store.\n */\nfunction uniformStore(declaration: ShaderUniformDeclaration): Float32Array {\n const count = ELEMENT_COUNTS[declaration.type];\n const store = new Float32Array(count);\n const value = declaration.defaultValue;\n if (typeof value === \"number\") {\n store[0] = value;\n } else {\n store.set(value.slice(0, count));\n }\n if (declaration.color) {\n decodeColourComponents(store);\n }\n return store;\n}\n\n/**\n * Writes a caller's value into a uniform's CPU-side store, checking its shape and decoding a\n * colour.\n *\n * @param store - The store to write into.\n * @param declaration - The uniform declaration.\n * @param value - The caller's value.\n * @param material - The material's name, for diagnostics.\n * @throws IgnifxError with code `IGX-0713` when the value's shape does not match the declared type.\n */\nfunction writeUniformValue(\n store: Float32Array,\n declaration: ShaderUniformDeclaration,\n value: number | readonly number[] | Float32Array | ColorLike,\n material: string,\n): void {\n const count = store.length;\n if (typeof value === \"number\") {\n if (count !== 1) {\n throw shapeMismatch(declaration, material, `${declaration.type} (${String(count)} floats)`, \"a single number\");\n }\n store[0] = value;\n return;\n }\n if (isColorLike(value)) {\n if (count !== 3 && count !== 4) {\n throw shapeMismatch(declaration, material, `${declaration.type} (${String(count)} floats)`, \"a colour\");\n }\n store[0] = Color.srgbToLinear(value.r);\n store[1] = Color.srgbToLinear(value.g);\n store[2] = Color.srgbToLinear(value.b);\n if (count === 4) {\n store[3] = value.a;\n }\n return;\n }\n if (value.length !== count) {\n throw shapeMismatch(\n declaration,\n material,\n `${declaration.type} (${String(count)} floats)`,\n `${String(value.length)} floats`,\n );\n }\n store.set(value instanceof Float32Array ? value : Float32Array.from(value));\n if (declaration.color) {\n decodeColourComponents(store);\n }\n}\n\n/**\n * Decodes a store's first three components from sRGB to linear, in place.\n *\n * @remarks\n * A `subarray` view and `map` rather than three indexed reads: a `Float32Array` element is typed\n * `number | undefined` under `noUncheckedIndexedAccess`, and `map` hands the callback a `number`.\n * It runs on a value write, never per frame.\n *\n * @param store - The store, at least three floats long.\n */\nfunction decodeColourComponents(store: Float32Array): void {\n const rgb = store.subarray(0, 3);\n rgb.set(rgb.map((component) => Color.srgbToLinear(component)));\n}\n\n/**\n * Whether a value is an sRGB colour rather than a numeric array.\n *\n * @param value - The candidate.\n * @returns `true` for an object carrying `r`, `g`, `b`, and `a`.\n */\nfunction isColorLike(value: readonly number[] | Float32Array | ColorLike): value is ColorLike {\n return !Array.isArray(value) && !(value instanceof Float32Array);\n}\n\n/**\n * Builds the `IGX-0713` failure a wrongly shaped value produces.\n *\n * @param declaration - The uniform declaration.\n * @param material - The material's name.\n * @param expected - What the uniform takes.\n * @param actual - What the caller passed.\n * @returns The error to throw.\n */\nfunction shapeMismatch(\n declaration: ShaderUniformDeclaration,\n material: string,\n expected: string,\n actual: string,\n): IgnifxError {\n return new IgnifxError(\n CoreErrorCode.shaderValueMismatch,\n `${declaration.name} on ${material} expects ${expected}, not ${actual}.`,\n {\n context: { name: declaration.name, material, expected, actual },\n hint: \"A colour uniform takes a ColorLike or its element count; every other uniform takes its element count.\",\n },\n );\n}\n"],"mappings":"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"}
1
+ {"version":3,"file":"shader-material-C2_UCYdO.js","names":[],"sources":["../src/render/shader-material.ts"],"sourcesContent":["import { CoreErrorCode } from \"../errors/error-codes.js\";\nimport { IgnifxError } from \"../errors/ignifx-error.js\";\nimport { isHdrScene } from \"../lite/gpu/render-path.js\";\nimport { Color } from \"../math/color.js\";\nimport { setOwnJsonProperty } from \"../schema/json.js\";\nimport { IGNIFX_UNIFORM_TYPES, IGNIFX_UNIFORM_NAMES, LITE_SYSTEM_UNIFORM_NAMES } from \"./shader-declaration.js\";\nimport type { ShaderAsset } from \"./shader-asset.js\";\nimport type {\n IgnifxUniformName,\n ShaderDeclaration,\n ShaderTextureDeclaration,\n ShaderUniformDeclaration,\n ShaderUniformType,\n} from \"./shader-declaration.js\";\nimport type { ShaderMaterialDefinition } from \"./shader-material-definition.js\";\nimport type { StorageBufferAsset } from \"./storage-buffer-asset.js\";\nimport type { TextureAsset } from \"./texture-asset.js\";\nimport type { App } from \"../app/types.js\";\nimport type { AssetHandle } from \"../assets/types.js\";\nimport type {\n LiteShaderMaterial,\n ShaderMaterialAdapter,\n ShaderMaterialBuildOptions,\n ShaderSamplerEntry,\n ShaderStorageEntry,\n ShaderUniformEntry,\n} from \"../lite/gpu/shader-material.js\";\nimport type { LiteTexture2D } from \"../lite/gpu/texture.js\";\nimport type { ColorLike } from \"../math/types.js\";\nimport type { Disconnect } from \"../signal/signal.js\";\n\n/**\n * The `\"shader\"` material family (`docs/plan/2026-09-terrain-particles-shaders.md` §3.1): a\n * `ShaderAsset` plus the values a material sets on it.\n *\n * Nothing here imports Babylon Lite: {@link toShaderMaterialOptions} is the whole mapping onto the\n * shape `createShaderMaterial` takes, as plain data, and the adapter itself arrives through\n * {@link loadShaderMaterialAdapter} so a project that loads no `.wgsl` never fetches that chunk\n * (`./shader-support.ts`).\n *\n * Two Lite rules shape the design:\n *\n * - A declared sampler must have something bound (error 309), so an unbound declared texture gets\n * the declaration's 1x1 fallback and `setTexture(name, null)` restores it rather than unbinding.\n * - A declared storage buffer must have something bound too (error 310), and `array<T>` has no 1x1\n * equivalent, so such a material is not drawable until `setStorageBuffer` binds one.\n */\n\n/** The uniform names Babylon Lite and ignifx write themselves, which a material may not set. */\nconst ENGINE_UNIFORM_NAMES: readonly string[] = Object.freeze([...LITE_SYSTEM_UNIFORM_NAMES, ...IGNIFX_UNIFORM_NAMES]);\n\n/** How many floats the `PreRender` system's frame buffer holds: direction, colour, ambient. */\nconst FRAME_FLOATS = 9;\n\n/** Where the main light's direction starts inside the frame buffer. */\nconst DIRECTION_OFFSET = 0;\n\n/** Where the main light's colour starts inside the frame buffer. */\nconst LIGHT_COLOR_OFFSET = 3;\n\n/** Where the ambient colour starts inside the frame buffer. */\nconst AMBIENT_OFFSET = 6;\n\n/** How many elements each uniform type holds. */\nconst ELEMENT_COUNTS: Readonly<Record<ShaderUniformType, number>> = Object.freeze({\n f32: 1,\n u32: 1,\n i32: 1,\n \"vec2<f32>\": 2,\n \"vec3<f32>\": 3,\n \"vec4<f32>\": 4,\n \"mat4x4<f32>\": 16,\n});\n\n/**\n * The premultiplied-alpha blend state, which Babylon Lite's two named modes cannot express.\n *\n * @remarks\n * `blendMode: \"alpha\"` compiles `srcFactor: \"src-alpha\"` (`lib/material/shader/shader-pipeline.js`),\n * which multiplies the source colour by its alpha a second time. A premultiplied surface has\n * already done that, so it needs `srcFactor: \"one\"` — the state that lets additive and over-blended\n * particles share one draw.\n */\nconst PREMULTIPLIED_BLEND: GPUBlendState = Object.freeze({\n color: Object.freeze({ srcFactor: \"one\", dstFactor: \"one-minus-src-alpha\", operation: \"add\" }),\n alpha: Object.freeze({ srcFactor: \"one\", dstFactor: \"one-minus-src-alpha\", operation: \"add\" }),\n});\n\n/**\n * Maps a shader file's declaration and a material's `define` overrides onto the shape\n * `createShaderMaterial` takes.\n *\n * @remarks\n * Pure data in, pure data out, so every mapping rule is asserted headlessly:\n *\n * - `blend opaque` leaves blending off; `alpha` and `additive` are Lite's two named modes;\n * `premultiplied` supplies an explicit `GPUBlendState`, because Lite's `\"alpha\"` mode multiplies\n * by alpha a second time.\n * - `depthWrite` is passed explicitly, because the declaration already resolved Lite's\n * \"blended defaults to off unless stated\" rule.\n * - `depthTest off` becomes `depthCompare: \"always\"`; `depthTest on` passes `null`, which leaves\n * Lite's reverse-Z default in place.\n * - `instancing matrices` and `matrices-colors` differ only in `useThinInstanceColors`; which\n * pipeline layout a mesh draws with is Lite's decision at build time, from whether the mesh has a\n * thin-instance colour stream.\n * - A colour uniform's declared default is sRGB and is decoded here, which is the one place the\n * conversion happens for defaults.\n *\n * @param name - The material's name, for GPU debug labels.\n * @param source - The whole `.wgsl` file.\n * @param declaration - What the file's pragmas declared.\n * @param uniforms - The initial value of every custom uniform, keyed by name, already **linear**.\n * @param defines - The resolved `define` values.\n * @returns The options.\n *\n * @internal\n */\nexport function toShaderMaterialOptions(\n name: string,\n source: string,\n declaration: ShaderDeclaration,\n uniforms: ReadonlyMap<string, Float32Array>,\n defines: Readonly<Record<string, boolean | number>>,\n): ShaderMaterialBuildOptions {\n const entries: ShaderUniformEntry[] = [];\n // `for…of` rather than an indexed loop: this runs once per material build, not per frame, and the\n // iterator yields the element type rather than `T | undefined`.\n for (const system of declaration.system) {\n entries.push(system);\n }\n for (const ignifx of declaration.ignifx) {\n const type = IGNIFX_UNIFORM_TYPES[ignifx];\n entries.push({ name: ignifx, type, defaultValue: zeros(ELEMENT_COUNTS[type]) });\n }\n for (const uniform of declaration.uniforms) {\n entries.push({\n name: uniform.name,\n type: uniform.type,\n defaultValue: Array.from(uniforms.get(uniform.name) ?? uniformStore(uniform)),\n });\n }\n const samplers: ShaderSamplerEntry[] = [];\n for (const texture of declaration.textures) {\n samplers.push({ name: texture.name, viewDimension: texture.array ? \"2d-array\" : \"2d\" });\n }\n const storageBuffers: ShaderStorageEntry[] = [];\n for (const storage of declaration.storage) {\n storageBuffers.push({ name: storage.name, type: storage.type });\n }\n const pipeline = declaration.pipeline;\n const blended = pipeline.blend !== \"opaque\";\n return {\n name,\n source,\n attributes: declaration.attributes,\n uniforms: entries,\n samplers,\n storageBuffers,\n defines,\n useThinInstanceColors: pipeline.instancing === \"matrices-colors\",\n needAlphaBlending: blended,\n blendMode: pipeline.blend === \"additive\" ? \"additive\" : \"alpha\",\n blend: pipeline.blend === \"premultiplied\" ? PREMULTIPLIED_BLEND : null,\n transmissive: pipeline.transmissive,\n backFaceCulling: pipeline.cull === \"back\",\n depthWrite: pipeline.depthWrite,\n depthCompare: pipeline.depthTest ? null : \"always\",\n };\n}\n\n/** The dynamically imported Babylon Lite adapter, memoised for the process. */\nlet adapter: ShaderMaterialAdapter | null = null;\n\n/**\n * Loads the custom-WGSL half of the Babylon Lite adapter, once per process.\n *\n * @remarks\n * The shader **loader** awaits this before it hands back a `ShaderAsset`, which is what makes\n * {@link shaderMaterialAdapter} safe to call from the synchronous material builders. Loading it also\n * turns on Lite's cached uniform serialization plans, which is what makes the per-frame `time`\n * upload rewrite only the slots that changed.\n *\n * @returns A promise that resolves once the adapter is in place.\n *\n * @internal\n */\nexport async function loadShaderMaterialAdapter(): Promise<void> {\n if (adapter !== null) {\n return;\n }\n const loaded = await import(\"../lite/gpu/shader-material.js\");\n loaded.enableShaderUniformCaching();\n // The assignment is what checks `ShaderMaterialAdapter` against the module it stands for.\n adapter = loaded;\n}\n\n/**\n * The adapter, if it has been loaded.\n *\n * @returns The module, or `null` before any `.wgsl` has been loaded.\n *\n * @internal\n */\nexport function shaderMaterialAdapter(): ShaderMaterialAdapter | null {\n return adapter;\n}\n\n/**\n * The adapter, or the failure a material built before the `.wgsl` loader ran produces.\n *\n * @param shader - The shader being built, for the message.\n * @returns The adapter.\n * @throws IgnifxError with code `IGX-0715` when the chunk has not been loaded.\n */\nfunction requireShaderMaterialAdapter(shader: ShaderAsset): ShaderMaterialAdapter {\n const module = shaderMaterialAdapter();\n if (module === null) {\n throw new IgnifxError(\n CoreErrorCode.shaderCompileFailed,\n `${shader.address} cannot be built because the shader adapter has not been loaded.`,\n {\n context: { asset: shader.address, message: \"adapter not loaded\" },\n hint: \"Load the .wgsl through app.assets, which is what loads the adapter.\",\n },\n );\n }\n return module;\n}\n\n/**\n * The per-app state the shader material family needs: the 1x1 fallback textures declared samplers\n * fall back to, and the list of live materials whose per-frame ignifx uniforms have to be written.\n *\n * @remarks\n * It hangs off the app through a lazily created `WeakMap` rather than a service, so a shader\n * material works whether or not an extension registered anything, and two apps in one process keep\n * separate state (`CONSTITUTION.md` §3.6).\n *\n * @internal\n */\nexport class ShaderMaterialRegistry {\n readonly #app: App;\n\n /** Live materials that declare at least one ignifx uniform, in no particular order. */\n readonly #animated: ShaderMaterialState[] = [];\n\n readonly #fallbacks = new Map<string, LiteTexture2D>();\n\n /**\n * Creates the registry.\n *\n * @param app - The app it belongs to.\n */\n constructor(app: App) {\n this.#app = app;\n }\n\n /**\n * The materials the `PreRender` uniform system has to write this frame.\n *\n * @returns The list; the registry's own array, iterated without copying.\n */\n get animated(): readonly ShaderMaterialState[] {\n return this.#animated;\n }\n\n /**\n * Starts writing a material's ignifx uniforms every frame.\n *\n * @param state - The material.\n */\n add(state: ShaderMaterialState): void {\n if (!this.#animated.includes(state)) {\n this.#animated.push(state);\n }\n }\n\n /**\n * Stops writing a material's ignifx uniforms.\n *\n * @param state - The material.\n */\n remove(state: ShaderMaterialState): void {\n const index = this.#animated.indexOf(state);\n if (index < 0) {\n return;\n }\n const last = this.#animated.pop();\n if (last !== undefined && index < this.#animated.length) {\n this.#animated[index] = last;\n }\n }\n\n /**\n * The 1x1 texture a declared-but-unbound sampler is filled with, created on first use and shared\n * for the life of the app.\n *\n * @param declaration - The sampler declaration, for its `default` and `array` flags.\n * @returns The texture, or `null` under a headless app or before the adapter has loaded.\n */\n fallbackTexture(declaration: ShaderTextureDeclaration): LiteTexture2D | null {\n const module = shaderMaterialAdapter();\n if (module === null || this.#app.isHeadless) {\n return null;\n }\n return module.resolveFallbackTexture(\n this.#app.lite.engine,\n this.#fallbacks,\n declaration.fallback,\n declaration.array,\n );\n }\n}\n\n/** The per-app registries, created on first use so module scope allocates nothing. */\nlet registries: WeakMap<App, ShaderMaterialRegistry> | null = null;\n\n/**\n * The shader material state of one app.\n *\n * @param app - The app.\n * @returns Its registry, created on first use.\n *\n * @internal\n */\nexport function shaderMaterialsOf(app: App): ShaderMaterialRegistry {\n const map = (registries ??= new WeakMap<App, ShaderMaterialRegistry>());\n const existing = map.get(app);\n if (existing !== undefined) {\n return existing;\n }\n const created = new ShaderMaterialRegistry(app);\n map.set(app, created);\n return created;\n}\n\n/**\n * One live `\"shader\"` material: the Babylon Lite material, the CPU-side copy of every value written\n * to it, and the bindings it has to replay when the shader file or a `define` changes.\n *\n * @remarks\n * `MaterialAsset` owns one of these and forwards `setUniform`, `getUniform`, `setTexture`,\n * `setDefine`, and `setStorageBuffer` to it. It is `@internal` because the public surface is the\n * material's methods, not this object.\n *\n * @internal\n */\nexport class ShaderMaterialState {\n /** The definition the material was built from; a clone replays it. */\n readonly definition: ShaderMaterialDefinition;\n\n readonly #app: App;\n\n readonly #values = new Map<string, Float32Array>();\n\n readonly #textures = new Map<string, AssetHandle<TextureAsset> | null>();\n\n readonly #storage = new Map<string, AssetHandle<StorageBufferAsset> | null>();\n\n readonly #defines = new Map<string, boolean | number>();\n\n /** The last light values written, so an unchanged light costs no upload. */\n readonly #light = new Float32Array(FRAME_FLOATS);\n\n /** The ignifx-provided uniforms the file declares, paired with their stores. */\n readonly #engineSlots: { readonly name: IgnifxUniformName; readonly store: Float32Array }[] = [];\n\n #shader: ShaderAsset;\n\n #material: LiteShaderMaterial;\n\n /**\n * The adapter every write goes through. Captured once, because a state can only be built after\n * {@link buildLiteShaderMaterial} has proved the chunk is in memory.\n */\n readonly #adapter: ShaderMaterialAdapter;\n\n #hasLight = false;\n\n #hasWarnedAboutLight = false;\n\n #onReplaced: Disconnect | null = null;\n\n /**\n * Builds the material. Use {@link buildShaderMaterialState}.\n *\n * @param app - The app that owns the engine, the log, and the registry.\n * @param shader - The shader the material sets values on.\n * @param definition - The declaration.\n * @param material - The already-built Babylon Lite material.\n * @param liteAdapter - The custom-WGSL adapter every write goes through.\n */\n constructor(\n app: App,\n shader: ShaderAsset,\n definition: ShaderMaterialDefinition,\n material: LiteShaderMaterial,\n liteAdapter: ShaderMaterialAdapter,\n ) {\n this.#app = app;\n this.#adapter = liteAdapter;\n this.#shader = shader;\n this.definition = definition;\n this.#material = material;\n // Not zeros: a light really at the origin pointing along +Z would then never be written.\n this.#light.fill(Number.NaN);\n }\n\n /**\n * The shader the material is values for.\n *\n * @returns The shader asset, which a hot reload replaces.\n */\n get shader(): ShaderAsset {\n return this.#shader;\n }\n\n /**\n * The Babylon Lite material, which `setDefine` and a hot reload replace with a new object.\n *\n * @returns The material.\n */\n get material(): LiteShaderMaterial {\n return this.#material;\n }\n\n /**\n * Whether the shader declares any ignifx-provided uniform, and so needs a per-frame write.\n *\n * @returns `true` when the `PreRender` system has work to do for this material.\n */\n get isAnimated(): boolean {\n return this.#shader.declaration.ignifx.length > 0;\n }\n\n /**\n * Whether every declared storage buffer has a buffer bound, which is what Babylon Lite needs\n * before the material can be drawn at all.\n *\n * @returns `true` when the material is drawable.\n */\n get isDrawable(): boolean {\n const declared = this.#shader.declaration.storage;\n for (let index = 0; index < declared.length; index += 1) {\n const name = declared[index]?.name;\n if (name !== undefined && (this.#storage.get(name) ?? null) === null) {\n return false;\n }\n }\n return true;\n }\n\n /**\n * Writes a declared uniform.\n *\n * @param name - The uniform's name.\n * @param value - The value: a number, a numeric array, or — for a `color` uniform — an sRGB\n * colour, which is uploaded linear.\n * @throws IgnifxError with code `IGX-0712` when the shader declares no such uniform or the engine\n * writes it, or `IGX-0713` when the value has the wrong shape.\n */\n setUniform(name: string, value: number | readonly number[] | Float32Array | ColorLike): void {\n const declaration = this.#writableUniform(name);\n const store = this.#values.get(name) ?? uniformStore(declaration);\n this.#values.set(name, store);\n writeUniformValue(store, declaration, value, this.definition.name);\n this.#write(name, store);\n }\n\n /**\n * Reads the current CPU-side value of a declared uniform.\n *\n * @param name - The uniform's name.\n * @param out - Receives the value for a vector or matrix uniform; a fresh array is allocated when\n * it is omitted.\n * @returns The number for a scalar uniform, or the filled array.\n * @throws IgnifxError with code `IGX-0712` when the shader declares no such uniform, or\n * `IGX-0713` when `out` is too short.\n */\n getUniform(name: string, out?: Float32Array): number | Float32Array {\n const declaration = this.#uniform(name);\n const store = this.#values.get(name) ?? uniformStore(declaration);\n this.#values.set(name, store);\n if (store.length === 1 && out === undefined) {\n return store[0] ?? 0;\n }\n if (out === undefined) {\n return Float32Array.from(store);\n }\n if (out.length < store.length) {\n throw new IgnifxError(\n CoreErrorCode.shaderValueMismatch,\n `${name} on ${this.definition.name} expects ${String(store.length)} floats, not ${String(out.length)}.`,\n {\n context: { name, material: this.definition.name, expected: store.length, actual: out.length },\n hint: \"Pass an out array at least as long as the uniform's element count.\",\n },\n );\n }\n out.set(store);\n return out;\n }\n\n /**\n * Binds a texture to a declared sampler, or restores the declaration's fallback.\n *\n * @param name - The sampler's name.\n * @param texture - The texture, or `null` for the declared 1x1 fallback.\n * @throws IgnifxError with code `IGX-0712` when the shader declares no such sampler.\n */\n setTexture(name: string, texture: AssetHandle<TextureAsset> | null): void {\n const declaration = this.#texture(name);\n this.#textures.set(name, texture);\n this.#bindTexture(declaration, texture);\n }\n\n /**\n * Binds a storage buffer to a declared binding.\n *\n * @param name - The binding's name.\n * @param buffer - The buffer, or `null` to unbind. A material with an unbound declared storage\n * buffer cannot be drawn.\n * @throws IgnifxError with code `IGX-0712` when the shader declares no such storage buffer.\n */\n setStorageBuffer(name: string, buffer: AssetHandle<StorageBufferAsset> | null): void {\n const declared = this.#shader.declaration.storage;\n let found = false;\n for (let index = 0; index < declared.length; index += 1) {\n if (declared[index]?.name === name) {\n found = true;\n break;\n }\n }\n if (!found) {\n throw this.#unknownBinding(name, \"storage buffer\");\n }\n this.#storage.set(name, buffer);\n this.#bindStorage(name, buffer);\n }\n\n /**\n * Overrides a declared `define` and rebuilds the Babylon Lite material, because a define is a\n * WGSL `const` baked into the compiled pipeline.\n *\n * @remarks\n * The rebuild replaces the Lite material **object**. `MeshRenderer` re-reads\n * `MaterialAsset.lite.material` every `PreRender` and writes it onto its mesh when it changed,\n * and Lite's `mesh.material` setter enqueues a material swap that the next frame drains\n * (`lib/scene/mesh-scene-registry.js`), so the new pipeline is picked up on the following frame\n * with no explicit topology flag.\n *\n * @param name - The define's name.\n * @param value - The new value.\n * @throws IgnifxError with code `IGX-0712` when the shader declares no such define.\n */\n setDefine(name: string, value: boolean | number): void {\n const declared = this.#shader.declaration.defines;\n let fileValue: boolean | number | undefined;\n for (let index = 0; index < declared.length; index += 1) {\n const definition = declared[index];\n if (definition?.name === name) {\n fileValue = definition.value;\n break;\n }\n }\n if (fileValue === undefined) {\n throw this.#unknownBinding(name, \"define\");\n }\n // Compared against the value in force, not against the override map, so re-setting what the\n // file already declares is not a pipeline rebuild.\n if ((this.#defines.get(name) ?? fileValue) === value) {\n return;\n }\n this.#defines.set(name, value);\n this.#rebuild(this.#shader);\n }\n\n /**\n * Writes this frame's ignifx uniforms. The `PreRender` system calls it.\n *\n * @param time - Scaled seconds since `app.start()`.\n * @param unscaledTime - Unscaled seconds since `app.start()`.\n * @param deltaTime - Scaled seconds since the previous frame.\n * @param light - Nine floats: the main light's world direction, its linear colour times its\n * intensity, and the ambient colour.\n * @param hasLight - Whether an enabled directional light supplied the first six.\n */\n writeFrameUniforms(\n time: number,\n unscaledTime: number,\n deltaTime: number,\n light: Float32Array,\n hasLight: boolean,\n ): void {\n let lightChanged = this.#hasLight !== hasLight;\n this.#hasLight = hasLight;\n for (let index = 0; index < this.#light.length; index += 1) {\n if (this.#light[index] !== light[index]) {\n this.#light[index] = light[index] ?? 0;\n lightChanged = true;\n }\n }\n const slots = this.#engineSlots;\n for (let index = 0; index < slots.length; index += 1) {\n const slot = slots[index];\n if (slot === undefined) {\n continue;\n }\n switch (slot.name) {\n case \"time\":\n this.#writeScalar(slot.name, slot.store, time);\n break;\n case \"unscaledTime\":\n this.#writeScalar(slot.name, slot.store, unscaledTime);\n break;\n case \"deltaTime\":\n this.#writeScalar(slot.name, slot.store, deltaTime);\n break;\n case \"mainLightDirection\":\n if (lightChanged) {\n this.#writeTriple(slot.name, slot.store, light, DIRECTION_OFFSET);\n }\n break;\n case \"mainLightColor\":\n if (lightChanged) {\n this.#writeTriple(slot.name, slot.store, light, LIGHT_COLOR_OFFSET);\n }\n break;\n case \"ambientColor\":\n if (lightChanged) {\n this.#writeTriple(slot.name, slot.store, light, AMBIENT_OFFSET);\n }\n break;\n default:\n break;\n }\n }\n if (!hasLight && !this.#hasWarnedAboutLight && this.#needsLight()) {\n this.#hasWarnedAboutLight = true;\n const declared = this.#engineSlots.map((slot) => slot.name).join(\", \");\n this.#app.log.warnOnce(\n `${CoreErrorCode.shaderLightUniformWithoutLight}:${this.definition.name}`,\n `${CoreErrorCode.shaderLightUniformWithoutLight}: ${this.definition.name} declares ${declared}, ` +\n \"but this world has no enabled directional light; zeros are uploaded.\",\n );\n }\n }\n\n /**\n * Replays the definition's values, textures, defines, and storage bindings onto a freshly built\n * Babylon Lite material, and connects the hot-reload hook. Called once, by\n * {@link buildShaderMaterialState}.\n *\n * @param textures - The texture handles the loader resolved, in declaration order.\n */\n initialise(textures: readonly AssetHandle<TextureAsset>[]): void {\n const declaration = this.#shader.declaration;\n for (const name of Object.keys(this.definition.defines)) {\n const value = this.definition.defines[name];\n if (value !== undefined) {\n this.#defines.set(name, value);\n }\n }\n for (const name of Object.keys(this.definition.values)) {\n const value = this.definition.values[name];\n if (value !== undefined) {\n this.setUniform(name, value);\n }\n }\n const addresses = Object.keys(this.definition.textures);\n for (let index = 0; index < declaration.textures.length; index += 1) {\n const declared = declaration.textures[index];\n if (declared === undefined) {\n continue;\n }\n const slot = addresses.indexOf(declared.name);\n const handle = slot < 0 ? undefined : textures[slot];\n this.#textures.set(declared.name, handle ?? null);\n this.#bindTexture(declared, handle ?? null);\n }\n this.#refreshEngineSlots();\n if (this.isAnimated) {\n shaderMaterialsOf(this.#app).add(this);\n }\n const source = this.#app.assets.get<ShaderAsset>(this.definition.shader);\n this.#onReplaced =\n source?.onReplaced.connect((value: ShaderAsset): void => {\n this.#reload(value);\n }) ?? null;\n }\n\n /**\n * Stops the per-frame writes and the hot-reload hook. The `material` asset type's `unload` runs\n * it when the last holder releases the material.\n */\n dispose(): void {\n this.#onReplaced?.();\n this.#onReplaced = null;\n shaderMaterialsOf(this.#app).remove(this);\n }\n\n /**\n * Rebuilds the Lite material for a replaced shader file, keeping the previous one on failure.\n *\n * @param shader - The re-parsed shader asset.\n */\n #reload(shader: ShaderAsset): void {\n try {\n this.#rebuild(shader);\n this.#shader = shader;\n } catch (error: unknown) {\n this.#app.onError.emit({\n error: new IgnifxError(\n CoreErrorCode.shaderCompileFailed,\n `${shader.address} failed to rebuild; the previous material stays in use. ${String(error)}`,\n {\n context: { asset: shader.address, message: String(error) },\n cause: error,\n hint: \"Fix the shader file; the running material is the last one that built.\",\n },\n ),\n source: \"asset\",\n phase: null,\n entity: null,\n component: null,\n });\n }\n }\n\n /**\n * Builds a new Lite material from a declaration and replays every binding that still exists.\n *\n * @param shader - The shader to build from.\n */\n #rebuild(shader: ShaderAsset): void {\n const declaration = shader.declaration;\n const previous = this.#shader;\n // The Lite material is replaced halfway through, so a failure has to put the old one back or the\n // material would be left drawing a new program against the old declaration's bindings.\n const previousMaterial = this.#material;\n const previousValues = new Map(this.#values);\n this.#shader = shader;\n try {\n const values = new Map<string, Float32Array>();\n for (let index = 0; index < declaration.uniforms.length; index += 1) {\n const uniform = declaration.uniforms[index];\n if (uniform === undefined) {\n continue;\n }\n const kept = this.#values.get(uniform.name);\n values.set(\n uniform.name,\n kept !== undefined && kept.length === ELEMENT_COUNTS[uniform.type] ? kept : uniformStore(uniform),\n );\n }\n this.#material = buildLiteShaderMaterial(\n this.#app,\n this.definition.name,\n shader,\n values,\n this.#resolveDefines(shader),\n );\n this.#values.clear();\n for (const [name, store] of values) {\n this.#values.set(name, store);\n }\n this.#rebind(declaration);\n } catch (error: unknown) {\n this.#shader = previous;\n this.#material = previousMaterial;\n this.#values.clear();\n for (const [name, store] of previousValues) {\n this.#values.set(name, store);\n }\n throw error;\n }\n }\n\n /**\n * Re-applies the texture and storage bindings that the new declaration still has, dropping the\n * ones it no longer declares.\n *\n * @param declaration - The new declaration.\n */\n #rebind(declaration: ShaderDeclaration): void {\n const textures = new Map(this.#textures);\n this.#textures.clear();\n for (let index = 0; index < declaration.textures.length; index += 1) {\n const declared = declaration.textures[index];\n if (declared === undefined) {\n continue;\n }\n const handle = textures.get(declared.name) ?? null;\n this.#textures.set(declared.name, handle);\n this.#bindTexture(declared, handle);\n }\n const storage = new Map(this.#storage);\n this.#storage.clear();\n for (let index = 0; index < declaration.storage.length; index += 1) {\n const name = declaration.storage[index]?.name;\n if (name === undefined) {\n continue;\n }\n const handle = storage.get(name) ?? null;\n this.#storage.set(name, handle);\n this.#bindStorage(name, handle);\n }\n this.#refreshEngineSlots();\n const registry = shaderMaterialsOf(this.#app);\n if (this.isAnimated) {\n registry.add(this);\n } else {\n registry.remove(this);\n }\n this.#light.fill(Number.NaN);\n }\n\n /**\n * The declared `define` values with this material's overrides applied.\n *\n * @param shader - The shader whose declaration supplies the defaults.\n * @returns The resolved values.\n */\n #resolveDefines(shader: ShaderAsset): Readonly<Record<string, boolean | number>> {\n const resolved: Record<string, boolean | number> = {};\n const declared = shader.declaration.defines;\n for (let index = 0; index < declared.length; index += 1) {\n const define = declared[index];\n if (define === undefined) {\n continue;\n }\n setOwnJsonProperty(resolved, define.name, this.#defines.get(define.name) ?? define.value);\n }\n return resolved;\n }\n\n /**\n * Binds a texture, or the declaration's fallback when there is none.\n *\n * @param declaration - The sampler declaration.\n * @param handle - The texture handle, or `null`.\n */\n #bindTexture(declaration: ShaderTextureDeclaration, handle: AssetHandle<TextureAsset> | null): void {\n const loaded = handle?.state === \"loaded\" ? handle.value.lite.texture : null;\n this.#adapter.writeShaderTexture(\n this.#material,\n declaration.name,\n loaded ?? shaderMaterialsOf(this.#app).fallbackTexture(declaration),\n );\n }\n\n /**\n * Binds a storage buffer.\n *\n * @param name - The binding's name.\n * @param handle - The buffer handle, or `null`.\n */\n #bindStorage(name: string, handle: AssetHandle<StorageBufferAsset> | null): void {\n this.#adapter.writeShaderStorageBuffer(\n this.#material,\n name,\n handle?.state === \"loaded\" ? handle.value.lite.buffer : null,\n );\n }\n\n /**\n * Writes one CPU-side value through to Babylon Lite.\n *\n * @param name - The uniform's name.\n * @param store - The value.\n */\n #write(name: string, store: Float32Array): void {\n this.#adapter.writeShaderUniform(this.#material, name, store);\n }\n\n /**\n * Writes one engine-owned scalar uniform through its CPU-side store.\n *\n * @param name - The uniform's name.\n * @param store - The store, which is also what `getUniform` reads.\n * @param value - The value.\n */\n #writeScalar(name: string, store: Float32Array, value: number): void {\n store[0] = value;\n this.#adapter.writeShaderUniform(this.#material, name, store);\n }\n\n /**\n * Writes three floats of an engine-owned `vec3<f32>` uniform, without allocating.\n *\n * @param name - The uniform's name.\n * @param store - The store, which is also what `getUniform` reads.\n * @param source - The nine-float frame buffer.\n * @param offset - Where the triple starts inside it.\n */\n #writeTriple(name: string, store: Float32Array, source: Float32Array, offset: number): void {\n store.set(source.subarray(offset, offset + 3));\n this.#adapter.writeShaderUniform(this.#material, name, store);\n }\n\n /**\n * Resolves the CPU-side store of every ignifx-provided uniform the file declares, so the\n * per-frame write is an indexed loop with no name lookup (coding standards §7).\n */\n #refreshEngineSlots(): void {\n const slots = this.#engineSlots;\n slots.length = 0;\n const declared = this.#shader.declaration.ignifx;\n for (let index = 0; index < declared.length; index += 1) {\n const name = declared[index];\n if (name === undefined) {\n continue;\n }\n const count = ELEMENT_COUNTS[IGNIFX_UNIFORM_TYPES[name]];\n const store = this.#values.get(name) ?? new Float32Array(count);\n this.#values.set(name, store);\n slots.push({ name, store });\n }\n }\n\n /**\n * Whether the shader declares a uniform that needs a directional light.\n *\n * @returns `true` when `mainLightDirection` or `mainLightColor` is declared.\n */\n #needsLight(): boolean {\n const declared = this.#shader.declaration.ignifx;\n for (let index = 0; index < declared.length; index += 1) {\n const name = declared[index];\n if (name === \"mainLightDirection\" || name === \"mainLightColor\") {\n return true;\n }\n }\n return false;\n }\n\n /**\n * Looks a custom uniform declaration up.\n *\n * @param name - The uniform's name.\n * @returns The declaration.\n * @throws IgnifxError with code `IGX-0712`.\n */\n #uniform(name: string): ShaderUniformDeclaration {\n const custom = this.#customUniform(name);\n if (custom !== null) {\n return custom;\n }\n const engine = this.#engineUniform(name);\n if (engine !== null) {\n return engine;\n }\n throw this.#unknownBinding(name, \"uniform\");\n }\n\n /**\n * Looks a custom uniform declaration up, refusing the ones the engine writes.\n *\n * @param name - The uniform's name.\n * @returns The declaration.\n * @throws IgnifxError with code `IGX-0712`.\n */\n #writableUniform(name: string): ShaderUniformDeclaration {\n const custom = this.#customUniform(name);\n if (custom !== null) {\n return custom;\n }\n if (ENGINE_UNIFORM_NAMES.includes(name)) {\n throw new IgnifxError(\n CoreErrorCode.unknownShaderBinding,\n `${name} on ${this.definition.name} is written by the engine every frame and cannot be set.`,\n {\n context: { material: this.definition.name, name },\n hint: \"System uniforms come from Babylon Lite and the ignifx uniforms from the PreRender system.\",\n },\n );\n }\n throw this.#unknownBinding(name, \"uniform\");\n }\n\n /**\n * The file's own declaration of a uniform, if it declares one by that name.\n *\n * @param name - The uniform's name.\n * @returns The declaration, or `null`.\n */\n #customUniform(name: string): ShaderUniformDeclaration | null {\n const declared = this.#shader.declaration.uniforms;\n for (let index = 0; index < declared.length; index += 1) {\n const uniform = declared[index];\n if (uniform !== undefined && uniform.name === name) {\n return uniform;\n }\n }\n return null;\n }\n\n /**\n * The synthetic declaration of an ignifx-provided uniform the file declared, so `getUniform` can\n * read back what the `PreRender` system wrote.\n *\n * @param name - The uniform's name.\n * @returns The declaration, or `null` when the file declares no such engine uniform.\n */\n #engineUniform(name: string): ShaderUniformDeclaration | null {\n const declared = this.#shader.declaration.ignifx;\n for (let index = 0; index < declared.length; index += 1) {\n const ignifx = declared[index];\n if (ignifx !== undefined && ignifx === name) {\n return {\n name: ignifx,\n type: IGNIFX_UNIFORM_TYPES[ignifx],\n defaultValue: zeros(ELEMENT_COUNTS[IGNIFX_UNIFORM_TYPES[ignifx]]),\n color: false,\n range: null,\n step: null,\n tooltip: null,\n };\n }\n }\n return null;\n }\n\n /**\n * Looks a sampler declaration up.\n *\n * @param name - The sampler's name.\n * @returns The declaration.\n * @throws IgnifxError with code `IGX-0712`.\n */\n #texture(name: string): ShaderTextureDeclaration {\n const declared = this.#shader.declaration.textures;\n for (let index = 0; index < declared.length; index += 1) {\n const texture = declared[index];\n if (texture !== undefined && texture.name === name) {\n return texture;\n }\n }\n throw this.#unknownBinding(name, \"texture\");\n }\n\n /**\n * Builds the `IGX-0712` failure an undeclared binding name produces.\n *\n * @param name - The name that was asked for.\n * @param what - What kind of binding was expected.\n * @returns The error to throw.\n */\n #unknownBinding(name: string, what: string): IgnifxError {\n return new IgnifxError(\n CoreErrorCode.unknownShaderBinding,\n `${this.definition.name} declares no ${what} named ${name}.`,\n {\n context: { material: this.definition.name, name },\n hint: `Declare it in ${this.#shader.address} with an // @ignifx ${what} pragma.`,\n },\n );\n }\n}\n\n/**\n * Builds the live state of a `\"shader\"` material: the Babylon Lite material, then every value,\n * texture, and define the definition names.\n *\n * @param app - The app that owns the engine, the log, and the registry.\n * @param shader - The shader the material sets values on.\n * @param definition - The declaration.\n * @param textures - The texture handles the loader resolved, in the order the definition's\n * `textures` record names them.\n * @returns The state.\n * @throws IgnifxError with code `IGX-0715` when the adapter has not been loaded, `IGX-0712` for an\n * undeclared value or define name, or `IGX-0713` for a value of the wrong shape.\n *\n * @internal\n */\nexport function buildShaderMaterialState(\n app: App,\n shader: ShaderAsset,\n definition: ShaderMaterialDefinition,\n textures: readonly AssetHandle<TextureAsset>[],\n): ShaderMaterialState {\n const defines: Record<string, boolean | number> = {};\n const declared = shader.declaration.defines;\n for (let index = 0; index < declared.length; index += 1) {\n const define = declared[index];\n if (define !== undefined) {\n const given = Object.hasOwn(definition.defines, define.name) ? definition.defines[define.name] : undefined;\n setOwnJsonProperty(defines, define.name, given ?? define.value);\n }\n }\n for (const name of Object.keys(definition.defines)) {\n if (!Object.hasOwn(defines, name)) {\n throw new IgnifxError(\n CoreErrorCode.unknownShaderBinding,\n `${definition.name} declares no define named ${name}.`,\n {\n context: { material: definition.name, name },\n hint: `Declare it in ${shader.address} with an // @ignifx define pragma.`,\n },\n );\n }\n }\n const material = buildLiteShaderMaterial(app, definition.name, shader, new Map(), defines);\n const state = new ShaderMaterialState(app, shader, definition, material, requireShaderMaterialAdapter(shader));\n state.initialise(textures);\n return state;\n}\n\n/**\n * Builds the Babylon Lite material a declaration describes, through the dynamically loaded adapter.\n *\n * @remarks\n * Under `rendering.hdr` the fragment is wrapped to write linear colour (GI plan step G3), so the\n * output pass does not encode it a second time.\n *\n * @param app - The app, whose scene says whether it renders through `rendering.hdr`.\n * @param name - The material's name.\n * @param shader - The shader.\n * @param values - Current custom uniform values to seed the declaration's defaults with.\n * @param defines - The resolved `define` values.\n * @returns The Lite material.\n * @throws IgnifxError with code `IGX-0715` when the adapter has not been loaded yet.\n */\nfunction buildLiteShaderMaterial(\n app: App,\n name: string,\n shader: ShaderAsset,\n values: ReadonlyMap<string, Float32Array>,\n defines: Readonly<Record<string, boolean | number>>,\n): LiteShaderMaterial {\n const options = toShaderMaterialOptions(name, shader.source, shader.declaration, values, defines);\n const linearOutput = !app.isHeadless && isHdrScene(app.lite.scene);\n return requireShaderMaterialAdapter(shader).createShaderMaterialFromOptions(\n linearOutput ? { ...options, linearOutput } : options,\n );\n}\n\n/**\n * A number, or an array of that many zeros, matching what a uniform of that arity starts at.\n *\n * @param count - How many elements the uniform holds.\n * @returns The zero value.\n */\nfunction zeros(count: number): number | readonly number[] {\n if (count === 1) {\n return 0;\n }\n const values: number[] = [];\n for (let index = 0; index < count; index += 1) {\n values.push(0);\n }\n return values;\n}\n\n/**\n * A fresh CPU-side store for one uniform, filled with its declared default — **linear** for a\n * colour, because that is what the GPU reads.\n *\n * @param declaration - The uniform declaration.\n * @returns The store.\n */\nfunction uniformStore(declaration: ShaderUniformDeclaration): Float32Array {\n const count = ELEMENT_COUNTS[declaration.type];\n const store = new Float32Array(count);\n const value = declaration.defaultValue;\n if (typeof value === \"number\") {\n store[0] = value;\n } else {\n store.set(value.slice(0, count));\n }\n if (declaration.color) {\n decodeColourComponents(store);\n }\n return store;\n}\n\n/**\n * Writes a caller's value into a uniform's CPU-side store, checking its shape and decoding a\n * colour.\n *\n * @param store - The store to write into.\n * @param declaration - The uniform declaration.\n * @param value - The caller's value.\n * @param material - The material's name, for diagnostics.\n * @throws IgnifxError with code `IGX-0713` when the value's shape does not match the declared type.\n */\nfunction writeUniformValue(\n store: Float32Array,\n declaration: ShaderUniformDeclaration,\n value: number | readonly number[] | Float32Array | ColorLike,\n material: string,\n): void {\n const count = store.length;\n if (typeof value === \"number\") {\n if (count !== 1) {\n throw shapeMismatch(declaration, material, `${declaration.type} (${String(count)} floats)`, \"a single number\");\n }\n store[0] = value;\n return;\n }\n if (isColorLike(value)) {\n if (count !== 3 && count !== 4) {\n throw shapeMismatch(declaration, material, `${declaration.type} (${String(count)} floats)`, \"a colour\");\n }\n store[0] = Color.srgbToLinear(value.r);\n store[1] = Color.srgbToLinear(value.g);\n store[2] = Color.srgbToLinear(value.b);\n if (count === 4) {\n store[3] = value.a;\n }\n return;\n }\n if (value.length !== count) {\n throw shapeMismatch(\n declaration,\n material,\n `${declaration.type} (${String(count)} floats)`,\n `${String(value.length)} floats`,\n );\n }\n store.set(value instanceof Float32Array ? value : Float32Array.from(value));\n if (declaration.color) {\n decodeColourComponents(store);\n }\n}\n\n/**\n * Decodes a store's first three components from sRGB to linear, in place.\n *\n * @remarks\n * A `subarray` view and `map` rather than three indexed reads: a `Float32Array` element is typed\n * `number | undefined` under `noUncheckedIndexedAccess`, and `map` hands the callback a `number`.\n * It runs on a value write, never per frame.\n *\n * @param store - The store, at least three floats long.\n */\nfunction decodeColourComponents(store: Float32Array): void {\n const rgb = store.subarray(0, 3);\n rgb.set(rgb.map((component) => Color.srgbToLinear(component)));\n}\n\n/**\n * Whether a value is an sRGB colour rather than a numeric array.\n *\n * @param value - The candidate.\n * @returns `true` for an object carrying `r`, `g`, `b`, and `a`.\n */\nfunction isColorLike(value: readonly number[] | Float32Array | ColorLike): value is ColorLike {\n return !Array.isArray(value) && !(value instanceof Float32Array);\n}\n\n/**\n * Builds the `IGX-0713` failure a wrongly shaped value produces.\n *\n * @param declaration - The uniform declaration.\n * @param material - The material's name.\n * @param expected - What the uniform takes.\n * @param actual - What the caller passed.\n * @returns The error to throw.\n */\nfunction shapeMismatch(\n declaration: ShaderUniformDeclaration,\n material: string,\n expected: string,\n actual: string,\n): IgnifxError {\n return new IgnifxError(\n CoreErrorCode.shaderValueMismatch,\n `${declaration.name} on ${material} expects ${expected}, not ${actual}.`,\n {\n context: { name: declaration.name, material, expected, actual },\n hint: \"A colour uniform takes a ColorLike or its element count; every other uniform takes its element count.\",\n },\n );\n}\n"],"mappings":"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"}