@ignifx/core 0.18.0 → 0.20.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 (57) hide show
  1. package/dist/{environment-DZ6WUHbm.js → environment-Bf4aphSb.js} +2 -2
  2. package/dist/{environment-DZ6WUHbm.js.map → environment-Bf4aphSb.js.map} +1 -1
  3. package/dist/{gtao-_nr0b6-E.js → gtao-Bpu5-0Ne.js} +2 -2
  4. package/dist/{gtao-_nr0b6-E.js.map → gtao-Bpu5-0Ne.js.map} +1 -1
  5. package/dist/{hdr-output-Dbv0lhFl.js → hdr-output-DBQwMphy.js} +2 -2
  6. package/dist/{hdr-output-Dbv0lhFl.js.map → hdr-output-DBQwMphy.js.map} +1 -1
  7. package/dist/{ignifx-error-B8ByiSfJ.js → ignifx-error-DwIZKxA2.js} +4 -1
  8. package/dist/ignifx-error-DwIZKxA2.js.map +1 -0
  9. package/dist/index.d.ts +218 -696
  10. package/dist/index.d.ts.map +1 -1
  11. package/dist/index.js +2904 -970
  12. package/dist/index.js.map +1 -1
  13. package/dist/{instanced-mesh-instance-BMhREEfx.js → instanced-mesh-instance-B-fXKSrY.js} +2 -2
  14. package/dist/{instanced-mesh-instance-BMhREEfx.js.map → instanced-mesh-instance-B-fXKSrY.js.map} +1 -1
  15. package/dist/{light-probe-asset-B60_X-yN.js → light-probe-asset-BqfSrJe9.js} +2 -2
  16. package/dist/{light-probe-asset-B60_X-yN.js.map → light-probe-asset-BqfSrJe9.js.map} +1 -1
  17. package/dist/{light-probes-DkYN89Qw.js → light-probes-DDojYajw.js} +4 -4
  18. package/dist/{light-probes-DkYN89Qw.js.map → light-probes-DDojYajw.js.map} +1 -1
  19. package/dist/lightmaps-BUUIIkt9.js +230 -0
  20. package/dist/lightmaps-BUUIIkt9.js.map +1 -0
  21. package/dist/{material-CGk5mAah.js → material-myMbl9mW.js} +37 -2
  22. package/dist/{material-CGk5mAah.js.map → material-myMbl9mW.js.map} +1 -1
  23. package/dist/{material-plugin-CiAmriQ_.js → material-plugin-DapJNj04.js} +2 -2
  24. package/dist/{material-plugin-CiAmriQ_.js.map → material-plugin-DapJNj04.js.map} +1 -1
  25. package/dist/{post-effect-CQnlX1RH.js → post-effect-Cu3Enpz7.js} +2 -2
  26. package/dist/{post-effect-CQnlX1RH.js.map → post-effect-Cu3Enpz7.js.map} +1 -1
  27. package/dist/{post-effect-compiler-C_7HTHZy.js → post-effect-compiler-cCq9lcHt.js} +3 -3
  28. package/dist/{post-effect-compiler-C_7HTHZy.js.map → post-effect-compiler-cCq9lcHt.js.map} +1 -1
  29. package/dist/{prefab-overrides-DT-wHHAJ.js → prefab-overrides-C2GsgOQc.js} +467 -30
  30. package/dist/prefab-overrides-C2GsgOQc.js.map +1 -0
  31. package/dist/{prefab-overrides-BLQn5yHS.d.ts → prefab-overrides-htDc_5Po.d.ts} +1370 -246
  32. package/dist/prefab-overrides-htDc_5Po.d.ts.map +1 -0
  33. package/dist/prefab.d.ts +2 -2
  34. package/dist/prefab.js +2 -2
  35. package/dist/{reflection-probe-DlVsl3zJ.js → reflection-probe-QkD1Fo_d.js} +106 -12
  36. package/dist/{reflection-probe-DlVsl3zJ.js.map → reflection-probe-QkD1Fo_d.js.map} +1 -1
  37. package/dist/reflection-probes-CAzSuqf8.js +921 -0
  38. package/dist/reflection-probes-CAzSuqf8.js.map +1 -0
  39. package/dist/{shader-material-CaAkv5nT.js → shader-material-CJIDFvSb.js} +2 -2
  40. package/dist/{shader-material-CaAkv5nT.js.map → shader-material-CJIDFvSb.js.map} +1 -1
  41. package/dist/{shader-material-C2_UCYdO.js → shader-material-TM4f8eKA.js} +4 -4
  42. package/dist/{shader-material-C2_UCYdO.js.map → shader-material-TM4f8eKA.js.map} +1 -1
  43. package/dist/{shader-pragma-DmZpxGUo.js → shader-pragma-ljmAbVc2.js} +2 -2
  44. package/dist/{shader-pragma-DmZpxGUo.js.map → shader-pragma-ljmAbVc2.js.map} +1 -1
  45. package/dist/{ssgi-Dm-maZrc.js → ssgi-DSnhqotl.js} +2 -2
  46. package/dist/{ssgi-Dm-maZrc.js.map → ssgi-DSnhqotl.js.map} +1 -1
  47. package/dist/{surface-shader-BeDRofOV.js → surface-shader-rpPpeosD.js} +6 -6
  48. package/dist/{surface-shader-BeDRofOV.js.map → surface-shader-rpPpeosD.js.map} +1 -1
  49. package/dist/{vec3-Cc19wl4r.js → vec3-2C3LBZnt.js} +55 -3
  50. package/dist/vec3-2C3LBZnt.js.map +1 -0
  51. package/package.json +1 -1
  52. package/dist/ignifx-error-B8ByiSfJ.js.map +0 -1
  53. package/dist/prefab-overrides-BLQn5yHS.d.ts.map +0 -1
  54. package/dist/prefab-overrides-DT-wHHAJ.js.map +0 -1
  55. package/dist/reflection-probes-B8S9WnVX.js +0 -551
  56. package/dist/reflection-probes-B8S9WnVX.js.map +0 -1
  57. package/dist/vec3-Cc19wl4r.js.map +0 -1
@@ -0,0 +1 @@
1
+ {"version":3,"file":"reflection-probes-CAzSuqf8.js","names":[],"sources":["../src/lite/gpu/reflection-probe.ts","../src/render/gpu/reflection-probes.ts"],"sourcesContent":["import {\n addTask,\n buildFrameGraphTask,\n clearPbrLocalEnvironment,\n createBankedFreeCamera,\n createPbrLocalEnvironmentProbeSet,\n createRenderTarget,\n createRenderTask,\n enablePbrLocalCubemap,\n getFrameGraph,\n getPbrUnlit,\n isPbrMaterial,\n isPbrSkybox,\n rebuildMaterial,\n setPbrEnvironment,\n setPbrLocalEnvironment,\n setPbrLocalEnvironmentProbeSet,\n} from \"@babylonjs/lite\";\nimport { readOwnerTag } from \"../picking.js\";\nimport { readSceneEnvironment } from \"./environment.js\";\nimport { colorTextureOf, deviceOf, removeTask } from \"./render-texture.js\";\nimport type { NodeTag } from \"../node.js\";\nimport type {\n BankedFreeCamera,\n EngineContext,\n EnvironmentTextures,\n Mesh,\n PbrLocalEnvironmentProbe,\n PbrLocalEnvironmentProbeSet,\n PbrMaterialProps,\n RenderTarget,\n RenderTask,\n SceneContext,\n} from \"@babylonjs/lite\";\n\n/**\n * Reflection probes (`docs/plan/2026-11-gi-phase-2-execution-plan.md`, step B1). Its own chunk,\n * loaded only when a world has a `ReflectionProbe` (`CONSTITUTION.md` §2.5). Every Lite claim was\n * read from `@babylonjs/lite@1.34.0`.\n *\n * - **Capture.** Lite has no cube capture, so six render tasks (`createRenderTask`, each with its own\n * `rgba16float` target and a `createBankedFreeCamera` looking down one axis, 90° field of view,\n * square target) are appended to the frame graph, switched on for the frames that capture, like\n * `./render-texture.ts`. Faces follow the cube-map convention in Lite's left-handed space: +X, −X\n * and ±Z faces use +Y as up, +Y uses −Z and −Y uses +Z.\n * - **Cube and mips.** In the next frame's `PreRender`, a small render pipeline of ignifx's own copies\n * each face into a cube texture, decoding gamma when `rendering.hdr` is off (the faces then hold\n * tone-mapped sRGB), and box-downsamples the mip chain. It is submitted before Lite's frame, so queue\n * order makes it read the frame that rendered the faces. Mips are not GGX-prefiltered.\n * - **Environment.** The cube is wrapped in an `EnvironmentTextures` (`index.d.ts` 5598) that shares\n * the scene environment's BRDF table and spherical harmonics, so diffuse light is unchanged.\n * - **Materials.** `setPbrLocalEnvironment` (box parallax) or `setPbrEnvironment` (no box) per lit PBR\n * material, then a material rebuild (`index.d.ts` 12612–12654). `enablePbrLocalCubemap` must have\n * resolved first; it is called when the chunk loads.\n * - **Culling mask.** Render tasks have no mesh filter, so each face task's `execute` hides the meshes\n * the caller rejects and shows them again, as `./render-texture.ts` does for editor-only meshes.\n * - **Blending (B1b).** `createPbrLocalEnvironmentProbeSet` (`index.d.ts` 3411) **copies** every\n * probe's cube into one cube array when it is created (`lib/material/pbr/enable-pbr-local-cubemap.js`,\n * `createProbeTexture`) and blends up to four candidates per voxel per fragment. It has no dispose:\n * its buffers and texture are destroyed only when the scene is (`scene._disposables`), so a set\n * replaced earlier is freed through its `_texture`, `_uniformBuffer` and `_gridBuffer` fields and\n * its closure is taken off `scene._disposables`, all read from the pinned source\n * ({@link releaseLiteProbeSet}). A fragment inside a probe's inner box takes\n * that probe alone; between inner and outer boxes the candidates are weighted; outside every outer\n * box the nearest probe by its normalised distance wins (`local-cubemap-fragment.js`).\n */\n\n/** The colour format of the faces and the cube. */\nconst PROBE_FORMAT: GPUTextureFormat = \"rgba16float\";\n\n/** The depth/stencil format Lite's own render tasks use. */\nconst DEPTH_STENCIL_FORMAT: GPUTextureFormat = \"depth24plus-stencil8\";\n\n/** Each face's view direction and up vector, in cube-face order +X, −X, +Y, −Y, +Z, −Z. */\nconst FACES: readonly (readonly [number, number, number, number, number, number])[] = [\n [1, 0, 0, 0, 1, 0],\n [-1, 0, 0, 0, 1, 0],\n [0, 1, 0, 0, 0, -1],\n [0, -1, 0, 0, 0, 1],\n [0, 0, 1, 0, 1, 0],\n [0, 0, -1, 0, 1, 0],\n];\n\n/** A full-screen triangle that copies, decodes, or (through a linear sampler) box-downsamples. */\nconst BLIT_WGSL = /* wgsl */ `\nstruct VsOut { @builtin(position) position: vec4<f32>, @location(0) uv: vec2<f32> };\n@vertex fn vs(@builtin(vertex_index) index: u32) -> VsOut {\n let corner = vec2<f32>(f32((index << 1u) & 2u), f32(index & 2u));\n var out: VsOut;\n out.position = vec4<f32>(corner * 2.0 - 1.0, 0.0, 1.0);\n out.uv = vec2<f32>(corner.x, 1.0 - corner.y);\n return out;\n}\n@group(0) @binding(0) var source: texture_2d<f32>;\n@group(0) @binding(1) var sourceSampler: sampler;\n@fragment fn copy(in: VsOut) -> @location(0) vec4<f32> {\n return vec4<f32>(textureSampleLevel(source, sourceSampler, in.uv, 0.0).rgb, 1.0);\n}\n@fragment fn decode(in: VsOut) -> @location(0) vec4<f32> {\n let colour = textureSampleLevel(source, sourceSampler, in.uv, 0.0).rgb;\n return vec4<f32>(pow(max(colour, vec3<f32>(0.0)), vec3<f32>(2.2)), 1.0);\n}\n`;\n\n/** The blit pipelines of one device. */\ninterface BlitPipelines {\n readonly copy: GPURenderPipeline;\n readonly decode: GPURenderPipeline;\n readonly sampler: GPUSampler;\n}\n\n/** Each device's pipelines, the map created on first use (coding standards §4). */\nlet pipelineCache: WeakMap<GPUDevice, BlitPipelines> | null = null;\n\n/**\n * One probe's capture passes and cube map.\n *\n * @internal\n */\nexport interface LiteReflectionProbe {\n /** The cube face size in pixels. */\n readonly size: number;\n /** The environment materials reflect, `null` until the first capture resolved. Stable afterwards. */\n readonly environment: EnvironmentTextures | null;\n /**\n * Renders the six faces in the coming frame.\n *\n * @param x - The world X of the capture point.\n * @param y - The world Y.\n * @param z - The world Z.\n * @param near - The near clip distance.\n * @param far - The far clip distance.\n * @returns `false`, rendering nothing, while the scene has no environment to borrow the lighting\n * tables from.\n */\n capture(x: number, y: number, z: number, near: number, far: number): boolean;\n /**\n * Turns the faces the last frame rendered into the cube map, when a capture ran.\n *\n * @param decodeGamma - Whether the faces hold gamma-encoded colour (`rendering.hdr` off).\n * @returns `true` when {@link LiteReflectionProbe.environment} was created by this call.\n */\n resolve(decodeGamma: boolean): boolean;\n /**\n * Removes the passes, frees the face targets, and destroys the cube map once `after` settled and\n * the GPU finished the work submitted by then. Idempotent.\n *\n * @param after - What must finish before the cube may go, such as the rebuilds of the materials\n * that reflected it; omitted (device lost, app closing) to wait for the queue only.\n */\n dispose(after?: PromiseLike<unknown>): void;\n}\n\n/**\n * Loads Lite's local-cubemap shader path. Resolve it before assigning any probe.\n *\n * @returns A promise that resolves once the path is registered.\n *\n * @internal\n */\nexport function enableReflectionProbes(): Promise<void> {\n return enablePbrLocalCubemap();\n}\n\n/**\n * Creates a probe's six face passes, switched off, at the end of the scene's frame graph.\n *\n * @param engine - The WebGPU engine.\n * @param scene - The registered render scene.\n * @param size - The face size in pixels, a power of two.\n * @param excludeKey - The `metadata` key that, set to `true` on a mesh, keeps it out of the faces.\n * @param accept - Whether a mesh's owner may be captured; `false` hides it during the faces.\n * @returns The probe.\n *\n * @internal\n */\nexport function createLiteReflectionProbe(\n engine: EngineContext,\n scene: SceneContext,\n size: number,\n excludeKey: string,\n accept: (tag: NodeTag | null) => boolean,\n): LiteReflectionProbe {\n const targets: RenderTarget[] = [];\n const tasks: RenderTask[] = [];\n const cameras: BankedFreeCamera[] = [];\n const hidden: Mesh[] = [];\n for (const face of FACES) {\n const target = createRenderTarget({\n lbl: \"ignifx:reflection-probe-face\",\n format: PROBE_FORMAT,\n dFormat: DEPTH_STENCIL_FORMAT,\n samples: 1,\n size: { width: size, height: size },\n });\n const camera = createBankedFreeCamera(\n { x: 0, y: 0, z: 0 },\n { x: face[0], y: face[1], z: face[2] },\n {\n x: face[3],\n y: face[4],\n z: face[5],\n },\n );\n camera.fov = Math.PI / 2;\n const task = createRenderTask({ name: \"ignifx:reflection-probe\", rt: target, cam: camera }, 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(); reflection-probe.ts needs updating for this Lite.\");\n }\n task.execute = (): number => {\n for (const mesh of scene.meshes) {\n if (mesh.visible !== false && (mesh.metadata?.[excludeKey] === true || !accept(readOwnerTag(mesh)))) {\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 targets.push(target);\n tasks.push(task);\n cameras.push(camera);\n }\n let cube: GPUTexture | null = null;\n let environment: EnvironmentTextures | null = null;\n let isCapturing = false;\n let isDisposed = false;\n return {\n size,\n get environment(): EnvironmentTextures | null {\n return environment;\n },\n capture(x: number, y: number, z: number, near: number, far: number): boolean {\n if (isDisposed || readSceneEnvironment(scene) === null) {\n return false;\n }\n for (let index = 0; index < FACES.length; index += 1) {\n const face = FACES[index];\n const camera = cameras[index];\n const task = tasks[index];\n if (face === undefined || camera === undefined || task === undefined) {\n continue;\n }\n camera.position.set(x, y, z);\n camera.target.set(x + face[0], y + face[1], z + face[2]);\n camera.nearPlane = near;\n camera.farPlane = far;\n task.executionEnabled = true;\n }\n isCapturing = true;\n return true;\n },\n resolve(decodeGamma: boolean): boolean {\n if (isDisposed || !isCapturing) {\n return false;\n }\n isCapturing = false;\n for (const task of tasks) {\n task.executionEnabled = false;\n }\n const device = deviceOf(engine);\n const base = readSceneEnvironment(scene);\n if (device === null || base === null) {\n return false;\n }\n cube ??= device.createTexture({\n label: \"ignifx:reflection-probe\",\n size: [size, size, FACES.length],\n format: PROBE_FORMAT,\n mipLevelCount: Math.log2(size) + 1,\n usage: GPUTextureUsage.TEXTURE_BINDING | GPUTextureUsage.RENDER_ATTACHMENT | GPUTextureUsage.COPY_SRC,\n });\n if (!blitFaces(device, cube, targets, decodeGamma)) {\n return false;\n }\n if (environment !== null) {\n return false;\n }\n environment = {\n specularCube: cube,\n specularCubeView: cube.createView({ dimension: \"cube\" }),\n brdfLut: base.brdfLut,\n brdfLutView: base.brdfLutView,\n cubeSampler: base.cubeSampler,\n brdfSampler: base.brdfSampler,\n irradianceSH: base.irradianceSH,\n sphericalHarmonics: base.sphericalHarmonics,\n lodGenerationScale: base.lodGenerationScale,\n lodGenerationOffset: base.lodGenerationOffset ?? 0,\n };\n return true;\n },\n dispose(after?: PromiseLike<unknown>): void {\n if (isDisposed) {\n return;\n }\n isDisposed = true;\n for (const task of tasks) {\n task.executionEnabled = false;\n removeTask(scene, task);\n // Frees the face target too (`lib/frame-graph/render-task-base.js` 97–109).\n task.dispose();\n }\n const retired = cube;\n cube = null;\n environment = null;\n if (retired !== null) {\n destroyWhenIdle(deviceOf(engine), retired, after);\n }\n },\n };\n}\n\n/**\n * Destroys a texture once nothing in flight can name it: a material rebuild finishes asynchronously\n * (`rebuildMaterial`, `index.d.ts` 11136), and until then Lite may still draw with a bind group that\n * holds the old cube, so destruction waits for `after`, then for the queue.\n *\n * @param device - The device, or `null` when it is gone (the texture is destroyed at once).\n * @param texture - The texture.\n * @param after - What must settle first, if anything.\n */\nfunction destroyWhenIdle(device: GPUDevice | null, texture: GPUTexture, after: PromiseLike<unknown> | undefined): void {\n const destroy = (): void => {\n texture.destroy();\n };\n Promise.resolve(after)\n .catch(() => undefined)\n .then(async () => device?.queue.onSubmittedWorkDone())\n .then(destroy, destroy);\n}\n\n/**\n * Copies the six face targets into the cube's first mip and box-downsamples the rest.\n *\n * @param device - The device.\n * @param cube - The cube texture, six layers.\n * @param targets - The face targets, in cube-face order.\n * @param decodeGamma - Whether to decode gamma on the copy.\n * @returns `false` when a face target has no texture yet.\n */\nfunction blitFaces(\n device: GPUDevice,\n cube: GPUTexture,\n targets: readonly RenderTarget[],\n decodeGamma: boolean,\n): boolean {\n const pipelines = blitPipelines(device);\n const encoder = device.createCommandEncoder({ label: \"ignifx:reflection-probe-mips\" });\n for (let face = 0; face < targets.length; face += 1) {\n const target = targets[face];\n const source = target === undefined ? null : colorTextureOf(target);\n if (source === null) {\n return false;\n }\n draw(\n device,\n encoder,\n decodeGamma ? pipelines.decode : pipelines.copy,\n pipelines.sampler,\n source.createView(),\n cubeFace(cube, face, 0),\n );\n for (let mip = 1; mip < cube.mipLevelCount; mip += 1) {\n draw(\n device,\n encoder,\n pipelines.copy,\n pipelines.sampler,\n cubeFace(cube, face, mip - 1),\n cubeFace(cube, face, mip),\n );\n }\n }\n device.queue.submit([encoder.finish()]);\n return true;\n}\n\n/**\n * A 2D view of one face and mip of the cube.\n *\n * @param cube - The cube texture.\n * @param face - The layer.\n * @param mip - The mip level.\n * @returns The view.\n */\nfunction cubeFace(cube: GPUTexture, face: number, mip: number): GPUTextureView {\n return cube.createView({\n dimension: \"2d\",\n baseArrayLayer: face,\n arrayLayerCount: 1,\n baseMipLevel: mip,\n mipLevelCount: 1,\n });\n}\n\n/**\n * Encodes one full-screen blit.\n *\n * @param device - The device.\n * @param encoder - The encoder.\n * @param pipeline - The pipeline.\n * @param sampler - The linear sampler.\n * @param source - The view to read.\n * @param destination - The view to write.\n */\nfunction draw(\n device: GPUDevice,\n encoder: GPUCommandEncoder,\n pipeline: GPURenderPipeline,\n sampler: GPUSampler,\n source: GPUTextureView,\n destination: GPUTextureView,\n): void {\n const bindGroup = device.createBindGroup({\n layout: pipeline.getBindGroupLayout(0),\n entries: [\n { binding: 0, resource: source },\n { binding: 1, resource: sampler },\n ],\n });\n const pass = encoder.beginRenderPass({\n colorAttachments: [\n { view: destination, loadOp: \"clear\", storeOp: \"store\", clearValue: { r: 0, g: 0, b: 0, a: 1 } },\n ],\n });\n pass.setPipeline(pipeline);\n pass.setBindGroup(0, bindGroup);\n pass.draw(3);\n pass.end();\n}\n\n/**\n * The device's blit pipelines.\n *\n * @param device - The device.\n * @returns The pipelines, created on first use.\n */\nfunction blitPipelines(device: GPUDevice): BlitPipelines {\n pipelineCache ??= new WeakMap();\n const cached = pipelineCache.get(device);\n if (cached !== undefined) {\n return cached;\n }\n const module = device.createShaderModule({ label: \"ignifx:reflection-probe-blit\", code: BLIT_WGSL });\n const pipeline = (entryPoint: string): GPURenderPipeline =>\n device.createRenderPipeline({\n label: `ignifx:reflection-probe-${entryPoint}`,\n layout: \"auto\",\n vertex: { module, entryPoint: \"vs\" },\n fragment: { module, entryPoint, targets: [{ format: PROBE_FORMAT }] },\n primitive: { topology: \"triangle-list\" },\n });\n const created: BlitPipelines = {\n copy: pipeline(\"copy\"),\n decode: pipeline(\"decode\"),\n sampler: device.createSampler({ magFilter: \"linear\", minFilter: \"linear\" }),\n };\n pipelineCache.set(device, created);\n return created;\n}\n\n/**\n * What a material reflects: a probe's environment, where it sits, and its projection box.\n *\n * @internal\n */\nexport interface LiteProbeBinding {\n /** The probe's environment. */\n readonly environment: EnvironmentTextures;\n /** The capture position. */\n readonly position: readonly [number, number, number];\n /** The full size of the projection box, or `null` for none. */\n readonly box: readonly [number, number, number] | null;\n}\n\n/**\n * One probe of a blended set, as {@link createLiteProbeSet} takes it.\n *\n * @internal\n */\nexport interface LiteProbeSetVolume {\n /** The probe's environment, copied into the set. */\n readonly environment: EnvironmentTextures;\n /** The capture position, also the centre of both boxes. */\n readonly position: readonly [number, number, number];\n /** The full size of the projection and outer influence box. */\n readonly outer: readonly [number, number, number];\n /** The full size of the inner influence box. */\n readonly inner: readonly [number, number, number];\n}\n\n/**\n * A blended probe set and its release.\n *\n * @internal\n */\nexport interface LiteProbeSet {\n /** Lite's set. */\n readonly set: PbrLocalEnvironmentProbeSet;\n /**\n * Destroys the set's GPU resources once `after` settled and the queue drained. Idempotent.\n *\n * @param after - What must finish first, such as the rebuilds of the materials that used it;\n * omitted to wait for the queue only.\n */\n dispose(after?: PromiseLike<unknown>): void;\n}\n\n/** The three GPU resources of a Lite probe set, by the field names `enable-pbr-local-cubemap.js` uses. */\nconst PROBE_SET_RESOURCE_FIELDS = [\"_texture\", \"_uniformBuffer\", \"_gridBuffer\"] as const;\n\n/**\n * Frees what a Lite probe set holds: its three GPU resources, and the cleanup closure Lite pushed\n * onto `scene._disposables`, which would otherwise keep the whole set (its 64 KiB uniform data and\n * its grid) alive until the scene is disposed.\n *\n * @remarks\n * Every field is checked before use: a Lite upgrade that renames one degrades to `warn` (a leak\n * that is logged) and never throws. Destroying twice is harmless.\n *\n * @param set - The set, as Lite returned it.\n * @param disposables - The scene's `_disposables` list, or anything else when it is not one.\n * @param cleanup - The closure Lite pushed for this set, or `undefined` when it was not found.\n * @param warn - Receives one message per missing field or list.\n *\n * @internal\n */\nexport function releaseLiteProbeSet(\n set: unknown,\n disposables: unknown,\n cleanup: unknown,\n warn: (message: string) => void,\n): void {\n // Boundary narrowing of Lite's undeclared fields (coding standards §5.2).\n // oxlint-disable-next-line typescript/no-unsafe-type-assertion\n const record = typeof set === \"object\" && set !== null ? (set as Record<string, unknown>) : {};\n for (const field of PROBE_SET_RESOURCE_FIELDS) {\n const resource = record[field];\n const destroy =\n typeof resource === \"object\" && resource !== null ? (resource as { destroy?: unknown }).destroy : undefined;\n if (typeof destroy === \"function\") {\n Reflect.apply(destroy, resource, []);\n } else {\n warn(`a Babylon Lite probe set has no ${field} to destroy, so its GPU memory stays until the scene goes`);\n }\n }\n if (!Array.isArray(disposables) || cleanup === undefined) {\n warn(\"the Babylon Lite probe set's scene cleanup could not be found, so its CPU data stays until the scene goes\");\n return;\n }\n const index = disposables.indexOf(cleanup);\n if (index >= 0) {\n disposables.splice(index, 1);\n }\n}\n\n/**\n * The scene's `_disposables` list, which Lite's set pushes its cleanup onto.\n *\n * @param scene - The scene.\n * @returns The list, or `undefined` when the scene has none (a Lite change).\n */\nfunction disposablesOf(scene: SceneContext): unknown[] | undefined {\n // Lite's scene type does not declare it; read from `lib/scene/scene-core.js` and\n // `enable-pbr-local-cubemap.js` (`scene._disposables.push`).\n // oxlint-disable-next-line typescript/no-unsafe-type-assertion, no-underscore-dangle\n const list = (scene as unknown as { _disposables?: unknown })._disposables;\n return Array.isArray(list) ? list : undefined;\n}\n\n/**\n * Builds a blended set from captured probes.\n *\n * @param engine - The engine, for the queue a disposal waits on.\n * @param scene - The registered scene.\n * @param volumes - The probes, at least two.\n * @param minimum - The voxel grid's minimum corner.\n * @param maximum - The voxel grid's maximum corner.\n * @param cellSize - The voxel edge.\n * @param warn - Where a disposal that cannot free everything reports it.\n * @returns The set.\n * @throws When Lite refuses it: more than four probes in a voxel, more probes than the uniform block\n * holds, or cubes of different formats.\n *\n * @internal\n */\nexport function createLiteProbeSet(\n engine: EngineContext,\n scene: SceneContext,\n volumes: readonly LiteProbeSetVolume[],\n minimum: readonly [number, number, number],\n maximum: readonly [number, number, number],\n cellSize: number,\n warn: (message: string) => void,\n): LiteProbeSet {\n const probes: PbrLocalEnvironmentProbe[] = volumes.map((volume) => ({\n shape: \"box\",\n environment: volume.environment,\n capturePosition: volume.position,\n projectionPosition: volume.position,\n influencePosition: volume.position,\n projectionSize: volume.outer,\n influenceInnerSize: volume.inner,\n influenceOuterSize: volume.outer,\n }));\n const disposables = disposablesOf(scene);\n const before = disposables?.length ?? 0;\n const set = createPbrLocalEnvironmentProbeSet(scene, { probes, voxelGrid: { minimum, maximum, cellSize } });\n // Lite pushes exactly one cleanup closure as the set's last step.\n const cleanup = disposables !== undefined && disposables.length === before + 1 ? disposables[before] : undefined;\n let isDisposed = false;\n return {\n set,\n dispose(after?: PromiseLike<unknown>): void {\n if (isDisposed) {\n return;\n }\n isDisposed = true;\n const release = (): void => {\n releaseLiteProbeSet(set, disposables, cleanup, warn);\n };\n const device = deviceOf(engine);\n Promise.resolve(after)\n .catch(() => undefined)\n .then(async () => device?.queue.onSubmittedWorkDone())\n .then(release, release);\n },\n };\n}\n\n/**\n * Calls `visit` for every mesh whose material is a lit, non-skybox PBR material.\n *\n * @param scene - The scene.\n * @param visit - Receives the material and the mesh's world position.\n *\n * @internal\n */\nexport function forEachReflectiveMesh(\n scene: SceneContext,\n visit: (material: PbrMaterialProps, x: number, y: number, z: number) => void,\n): void {\n const meshes = scene.meshes;\n for (let index = 0; index < meshes.length; index += 1) {\n const mesh = meshes[index];\n const material = mesh?.material;\n // Declared non-null, but Lite's mesh factories create meshes with `material: null`.\n // oxlint-disable-next-line typescript/no-unnecessary-condition\n if (mesh === undefined || material === undefined || material === null || !isPbrMaterial(material)) {\n continue;\n }\n if (getPbrUnlit(material) !== undefined || isPbrSkybox(material)) {\n continue;\n }\n const world = mesh.worldMatrix;\n visit(material, world[12] ?? 0, world[13] ?? 0, world[14] ?? 0);\n }\n}\n\n/**\n * Points a PBR material at a probe, or back at the scene environment, and rebuilds it.\n *\n * @param scene - The registered scene, or `null` to leave the rebuild to Lite (its device-loss\n * recovery rebuilds every material).\n * @param material - The material.\n * @param binding - The probe, a blended set, or `null` for the scene environment.\n * @returns The rebuild in flight, if Lite runs it asynchronously; Lite reports its failure itself.\n *\n * @internal\n */\nexport function assignReflectionProbe(\n scene: SceneContext | null,\n material: PbrMaterialProps,\n binding: LiteProbeBinding | LiteProbeSet | null,\n): Promise<void> | undefined {\n if (binding === null) {\n clearPbrLocalEnvironment(material);\n } else if (\"set\" in binding) {\n setPbrLocalEnvironmentProbeSet(material, binding.set);\n } else if (binding.box === null) {\n setPbrEnvironment(material, binding.environment);\n } else {\n setPbrLocalEnvironment(material, binding.environment, {\n shape: \"box\",\n capturePosition: binding.position,\n projectionPosition: binding.position,\n projectionSize: binding.box,\n });\n }\n if (scene === null) {\n return undefined;\n }\n // Since 1.34 a PBR rebuild in a built scene finishes asynchronously (`../material.ts`).\n const pending = rebuildMaterial(scene, material);\n return pending instanceof Promise ? pending : undefined;\n}\n","import { toEntityHandle } from \"../../handles/handle.js\";\nimport {\n assignReflectionProbe,\n createLiteProbeSet,\n createLiteReflectionProbe,\n enableReflectionProbes,\n forEachReflectiveMesh,\n} from \"../../lite/gpu/reflection-probe.js\";\nimport {\n reflectionProbeBlendLayout,\n resolveReflectionProbeRefreshMode,\n resolveReflectionProbeSize,\n selectReflectionProbe,\n} from \"../reflection-probe.js\";\nimport { EDITOR_ONLY_METADATA_KEY } from \"../render-texture.js\";\nimport type { LiteProbeBinding, LiteProbeSet, LiteReflectionProbe } from \"../../lite/gpu/reflection-probe.js\";\nimport type { NodeTag } from \"../../lite/node.js\";\nimport type { LiteEngine, LiteScene } from \"../../lite/scene.js\";\nimport type { Vec3Like } from \"../../math/types.js\";\nimport type { World } from \"../../world/world.js\";\nimport type {\n ReflectionProbe,\n ReflectionProbeBlendCandidate,\n ReflectionProbeBlendLayout,\n} from \"../reflection-probe.js\";\nimport type { RenderingQualityPreset } from \"../rendering-settings.js\";\n\n/**\n * The render layer's half of reflection probes (`docs/plan/2026-11-gi-phase-2-execution-plan.md`,\n * step B1): which probe captures when, and which probe each PBR material reflects. Loaded with\n * `../../lite/gpu/reflection-probe.ts` as one chunk, only once a world has a `ReflectionProbe`.\n *\n * Blending (B1b): when `reflectionProbeBlendLayout` says the frame's probes blend and every box probe\n * has finished capturing (none `everyFrame`), one Lite probe set built from their cubes goes on every\n * lit PBR material. The set copies the cubes, so it is rebuilt when a probe moves, recaptures,\n * resizes its box or changes `blendDistance`, and the replaced set is freed once the material\n * rebuilds that dropped it settled. While a box probe is still capturing, the last set stays (or,\n * before the first, the nearest-probe choice applies); while one is being moved or edited (its\n * binding or `blendDistance` changed within the last {@link BLEND_STILL_FRAMES} frames) the\n * nearest-probe choice applies. A material whose nearest probe has no box keeps that probe. A set Lite refuses (more than four probes\n * overlapping in a voxel, too many probes) logs once and the nearest-probe choice applies.\n */\n\n/**\n * How many consecutive frames one capture request renders. Lite compiles material pipelines\n * asynchronously, so a single frame right after start or after a scene change can miss meshes that\n * are still compiling; repeating it for a few frames catches them.\n */\nconst CAPTURE_FRAMES = 8;\n\n/**\n * How many frames a blended probe's position, box and `blendDistance` must stay unchanged before a\n * probe set is built with it (about 250 ms at 60 Hz). A set copies every cube and rebuilds every lit\n * material, so a probe being moved, dragged or scrubbed falls back to the nearest-probe choice until\n * it rests.\n */\nconst BLEND_STILL_FRAMES = 15;\n\n/** One component's GPU probe and what it last captured with. */\ninterface ProbeState {\n /** The GPU probe. */\n lite: LiteReflectionProbe;\n /** How many more frames capture before the probe rests. */\n framesToCapture: number;\n /** The binding materials use, rebuilt when the probe moves or its box changes. */\n binding: LiteProbeBinding | null;\n /** How many captures it ran, so a blended set made before a recapture is rebuilt. */\n generation: number;\n /** The `blendDistance` seen last frame. */\n blendDistance: number;\n /** How many frames its binding and `blendDistance` have not changed. */\n stillFrames: number;\n}\n\n/** A material `forEachReflectiveMesh` hands out. */\ntype ReflectiveMaterial = Parameters<typeof assignReflectionProbe>[1];\n\n/** A candidate with the binding it stands for. */\ninterface BoundCandidate extends ReflectionProbeBlendCandidate {\n /** The binding. */\n readonly binding: LiteProbeBinding;\n /** Its capture count. */\n readonly generation: number;\n /** Whether it has capture frames left, so a set made of it now would go stale. */\n readonly isCapturing: boolean;\n /** Whether it captures every frame, so any set made of it goes stale at once. */\n readonly isEveryFrame: boolean;\n /** Whether its binding or `blendDistance` changed within {@link BLEND_STILL_FRAMES}. */\n readonly isMoving: boolean;\n}\n\n/** A blended set and what it was built from, compared to decide a rebuild. */\ninterface BlendState {\n readonly lite: LiteProbeSet;\n /** Per volume: binding, generation and blend distance, flattened. */\n readonly key: readonly unknown[];\n}\n\n/**\n * Every reflection probe of a renderer.\n *\n * @internal\n */\nexport interface ReflectionProbeRuntime {\n /**\n * Captures what is due and points each lit PBR material at its probe. Called once per frame from\n * the `PreRender` system.\n *\n * @param world - The world the probes live in.\n * @param probes - Every `ReflectionProbe` in the world.\n * @param isHdr - Whether `rendering.hdr` is on.\n * @param tier - The `rendering.quality` preset, which caps the size and `everyFrame`; `null` for\n * `\"custom\"`.\n * @param hasEnvironment - Whether the scene has an environment map. Without one every probe is\n * freed and nothing else runs, not even the mesh walk.\n */\n update(\n world: World,\n probes: readonly ReflectionProbe[],\n isHdr: boolean,\n tier: RenderingQualityPreset | null,\n hasEnvironment: boolean,\n ): void;\n /**\n * Drops every GPU probe after the device was lost, before Lite's recovery rebuilds the materials,\n * so no material still names a cube of the lost device. Until {@link handleDeviceRecovered},\n * `update` does nothing; the probes capture again on the first frame after it.\n */\n handleDeviceLost(): void;\n /** Lets `update` run again once Lite rebuilt the scene on the new device. */\n handleDeviceRecovered(): void;\n /** Frees every probe and hands every material back to the scene environment. */\n dispose(): void;\n}\n\n/**\n * Creates the runtime once Lite's local-cubemap shader path is loaded.\n *\n * @param engine - The engine.\n * @param scene - The registered render scene.\n * @param warn - Where a probe's warning goes, with the entity's name already in the message.\n * @returns The runtime.\n *\n * @internal\n */\nexport async function createReflectionProbeRuntime(\n engine: LiteEngine,\n scene: LiteScene,\n warn: (message: string) => void,\n): Promise<ReflectionProbeRuntime> {\n await enableReflectionProbes();\n const states = new Map<ReflectionProbe, ProbeState>();\n const assigned = new Map<ReflectiveMaterial, LiteProbeBinding | LiteProbeSet | null>();\n /** The blended set on every lit material, or `null` for the nearest-probe choice. */\n let blend: BlendState | null = null;\n /** The key of a set Lite refused, so it is not tried again every frame. */\n let refusedKey: readonly unknown[] | null = null;\n let hasWarnedRefusal = false;\n const warnedLeaks = new Set<string>();\n const warnLeakOnce = (message: string): void => {\n if (!warnedLeaks.has(message)) {\n warnedLeaks.add(message);\n warn(`Reflection probe blending: ${message}.`);\n }\n };\n /** Sets replaced this frame, freed with the retired cubes. */\n const retiringSets: LiteProbeSet[] = [];\n const seen = new Set<object>();\n const candidates: BoundCandidate[] = [];\n /** The cubes released this frame, freed once the materials that reflected them are rebuilt. */\n const retiring: { lite: LiteReflectionProbe; environment: LiteProbeBinding[\"environment\"] | null }[] = [];\n /**\n * Material rebuilds still in flight, whichever frame started them: a rebuild started a frame ago\n * may still draw with a cube retired now, so a retired cube waits for all of them.\n */\n const rebuilds = new Set<Promise<void>>();\n /**\n * Probes whose capture was freed while they stayed (resized, environment gone, device lost); they\n * capture again whatever their mode.\n */\n const recapture = new WeakSet<ReflectionProbe>();\n let hasWarnedEveryFrame = false;\n /** Between a device loss and Lite's recovery, nothing on the GPU may be touched. */\n let isDeviceLost = false;\n\n const assign = (material: ReflectiveMaterial, binding: LiteProbeBinding | LiteProbeSet | null): void => {\n const pending = assignReflectionProbe(scene, material, binding);\n if (pending !== undefined) {\n rebuilds.add(pending);\n const forget = (): void => {\n rebuilds.delete(pending);\n };\n pending.then(forget, forget);\n }\n };\n\n const release = (probe: ReflectionProbe, state: ProbeState): void => {\n // A capture still under way (an `onDemand` refresh whose frames are not done) counts as wanted.\n if (state.lite.environment !== null || state.framesToCapture > 0) {\n recapture.add(probe);\n }\n retiring.push({ lite: state.lite, environment: state.lite.environment });\n states.delete(probe);\n };\n\n /**\n * Frees the cubes released this frame. A material that reflected one and was not reassigned this\n * frame (its mesh left the scene) goes back to the scene environment first, so it never names a\n * destroyed cube; the cubes then wait for every rebuild still in flight, from any frame.\n */\n const retire = (): void => {\n if (retiring.length > 0) {\n for (const [material, binding] of assigned) {\n if (\n binding !== null &&\n !(\"set\" in binding) &&\n retiring.some((entry) => entry.environment === binding.environment)\n ) {\n assigned.set(material, null);\n assign(material, null);\n }\n }\n const settled = Promise.allSettled(rebuilds);\n for (const entry of retiring) {\n entry.lite.dispose(settled);\n }\n retiring.length = 0;\n }\n if (retiringSets.length > 0) {\n // A material still on a retired set was reassigned this frame or is gone from the scene.\n for (const [material, binding] of assigned) {\n if (binding !== null && \"set\" in binding && retiringSets.includes(binding)) {\n assigned.set(material, null);\n assign(material, null);\n }\n }\n const settled = Promise.allSettled(rebuilds);\n for (const set of retiringSets) {\n set.dispose(settled);\n }\n retiringSets.length = 0;\n }\n };\n\n /** Stops blending; the set goes once the materials that used it were rebuilt. */\n const dropBlend = (): void => {\n if (blend !== null) {\n retiringSets.push(blend.lite);\n blend = null;\n }\n };\n\n /**\n * Builds, keeps or drops the blended set for this frame's candidates.\n *\n * @param layout - The blend layout, or `null` when the probes do not blend.\n */\n const updateBlend = (layout: ReflectionProbeBlendLayout | null): void => {\n if (layout === null) {\n dropBlend();\n refusedKey = null;\n return;\n }\n let isCapturing = false;\n let hasEveryFrame = false;\n let isMoving = false;\n for (const volume of layout.volumes) {\n const candidate = candidates[volume.index];\n isCapturing ||= candidate?.isCapturing === true;\n hasEveryFrame ||= candidate?.isEveryFrame === true;\n isMoving ||= candidate?.isMoving === true;\n }\n if (hasEveryFrame || isMoving) {\n // A probe capturing every frame would leave any set stale at once; one being moved would\n // rebuild it every frame. Both take the nearest-probe choice until that stops.\n dropBlend();\n return;\n }\n if (isCapturing) {\n return;\n }\n const key: unknown[] = [];\n const volumes = layout.volumes.map((volume) => {\n const candidate = candidates[volume.index];\n if (candidate !== undefined) {\n key.push(candidate.binding, candidate.generation, candidate.blendDistance);\n }\n return {\n environment: candidate?.binding.environment ?? null,\n position: volume.position,\n outer: volume.outer,\n inner: volume.inner,\n };\n });\n if (sameKey(blend?.key ?? null, key) || sameKey(refusedKey, key)) {\n return;\n }\n const ready = volumes.filter(\n (volume): volume is typeof volume & { environment: NonNullable<typeof volume.environment> } =>\n volume.environment !== null,\n );\n try {\n const created = createLiteProbeSet(\n engine,\n scene,\n ready,\n layout.minimum,\n layout.maximum,\n layout.cellSize,\n warnLeakOnce,\n );\n dropBlend();\n blend = { lite: created, key };\n refusedKey = null;\n } catch (error) {\n dropBlend();\n refusedKey = key;\n if (!hasWarnedRefusal) {\n hasWarnedRefusal = true;\n warn(\n `The reflection probes cannot blend (${error instanceof Error ? error.message : String(error)}), ` +\n \"so each material reflects its nearest probe. Lite blends at most four overlapping probes.\",\n );\n }\n }\n };\n\n /** Hands every material back to the scene environment, without walking the scene. */\n const clearMaterials = (): void => {\n for (const [material, binding] of assigned) {\n if (binding !== null) {\n assign(material, null);\n }\n }\n assigned.clear();\n };\n\n const assignMaterials = (): void => {\n if (candidates.length === 0) {\n clearMaterials();\n return;\n }\n seen.clear();\n const blended = blend?.lite ?? null;\n forEachReflectiveMesh(scene, (material, x, y, z) => {\n if (seen.has(material)) {\n return;\n }\n seen.add(material);\n // A material whose nearest probe has no box keeps it: such probes are not in the set.\n const chosen = candidates[selectReflectionProbe(x, y, z, candidates)];\n const binding = blended !== null && chosen?.box !== null ? blended : (chosen?.binding ?? null);\n const current = assigned.get(material);\n if (current === binding || (current === undefined && binding === null)) {\n return;\n }\n assigned.set(material, binding);\n assign(material, binding);\n });\n };\n\n return {\n update(\n world: World,\n probes: readonly ReflectionProbe[],\n isHdr: boolean,\n tier: RenderingQualityPreset | null,\n hasEnvironment: boolean,\n ): void {\n if (isDeviceLost) {\n return;\n }\n candidates.length = 0;\n if (!hasEnvironment) {\n // A probe borrows the environment's lighting tables, so without one it holds no GPU memory\n // and costs no frame work; refresh requests stay on the component until it can capture.\n for (const [probe, state] of states) {\n release(probe, state);\n }\n dropBlend();\n clearMaterials();\n retire();\n return;\n }\n const maxSize = tier?.reflectionProbeMaxSize;\n const allowsEveryFrame = tier?.reflectionProbeEveryFrame ?? true;\n for (const [probe, state] of states) {\n if (!probes.includes(probe) || resolveReflectionProbeSize(probe.size, maxSize) !== state.lite.size) {\n release(probe, state);\n }\n }\n for (const probe of probes) {\n const wantsRefresh = probe.consumeRefreshRequest();\n if (!probe.isEnabledInHierarchy) {\n continue;\n }\n const mode = resolveReflectionProbeRefreshMode(probe.refreshMode, allowsEveryFrame);\n if (mode !== probe.refreshMode && !hasWarnedEveryFrame) {\n hasWarnedEveryFrame = true;\n warn(\n `${JSON.stringify(probe.entity.name)} asks its ReflectionProbe for refreshMode \"everyFrame\", ` +\n 'which only the \"high\" rendering.quality tier allows, so it captures as \"once\" (when ready ' +\n \"and on refresh()).\",\n );\n }\n let state = states.get(probe);\n if (state === undefined) {\n // Nothing is allocated until a capture is due: an `onDemand` probe waits for refresh().\n if (mode === \"onDemand\" && !wantsRefresh && !recapture.has(probe)) {\n continue;\n }\n recapture.delete(probe);\n state = {\n lite: createLiteReflectionProbe(\n engine,\n scene,\n resolveReflectionProbeSize(probe.size, maxSize),\n EDITOR_ONLY_METADATA_KEY,\n cullingFilter(world, probe),\n ),\n framesToCapture: CAPTURE_FRAMES,\n binding: null,\n generation: 0,\n blendDistance: probe.blendDistance,\n stillFrames: 0,\n };\n states.set(probe, state);\n }\n state.lite.resolve(!isHdr);\n const matrix = probe.entity.transform.worldMatrix;\n const x = matrix[12] ?? 0;\n const y = matrix[13] ?? 0;\n const z = matrix[14] ?? 0;\n if (wantsRefresh) {\n state.framesToCapture = CAPTURE_FRAMES;\n }\n const isCapturing = state.framesToCapture > 0 || mode === \"everyFrame\";\n if (isCapturing && state.lite.capture(x, y, z, probe.near, probe.far)) {\n state.framesToCapture = Math.max(0, state.framesToCapture - 1);\n state.generation += 1;\n }\n const environment = state.lite.environment;\n if (environment === null) {\n continue;\n }\n const box = probe.boxProjection;\n const binding = bindingFor(state.binding, environment, x, y, z, box);\n state.stillFrames =\n binding === state.binding && probe.blendDistance === state.blendDistance ? state.stillFrames + 1 : 0;\n state.binding = binding;\n state.blendDistance = probe.blendDistance;\n candidates.push({\n x,\n y,\n z,\n box,\n binding,\n blendDistance: probe.blendDistance,\n generation: state.generation,\n isCapturing: state.framesToCapture > 0,\n isEveryFrame: mode === \"everyFrame\",\n isMoving: state.stillFrames < BLEND_STILL_FRAMES,\n });\n }\n updateBlend(mayBlend(candidates) ? reflectionProbeBlendLayout(candidates) : null);\n assignMaterials();\n retire();\n },\n handleDeviceLost(): void {\n isDeviceLost = true;\n // The set's copies belong to the lost device; Lite would otherwise recopy from dead cubes.\n blend?.lite.dispose();\n blend = null;\n refusedKey = null;\n for (const set of retiringSets) {\n set.dispose();\n }\n retiringSets.length = 0;\n // Lite's recovery rebuilds every material against the new device, so only the bindings are\n // cleared here; the cubes belong to the lost device and go at once.\n for (const [material, binding] of assigned) {\n if (binding !== null) {\n void assignReflectionProbe(null, material, null);\n }\n }\n assigned.clear();\n for (const [probe, state] of states) {\n if (state.lite.environment !== null || state.framesToCapture > 0) {\n recapture.add(probe);\n }\n state.lite.dispose();\n }\n states.clear();\n // The retired cubes belonged to the lost device too.\n for (const entry of retiring) {\n entry.lite.dispose();\n }\n retiring.length = 0;\n rebuilds.clear();\n },\n handleDeviceRecovered(): void {\n isDeviceLost = false;\n },\n dispose(): void {\n for (const [probe, state] of states) {\n release(probe, state);\n }\n dropBlend();\n clearMaterials();\n const settled = Promise.allSettled(rebuilds);\n for (const entry of retiring) {\n entry.lite.dispose(settled);\n }\n retiring.length = 0;\n for (const set of retiringSets) {\n set.dispose(settled);\n }\n retiringSets.length = 0;\n rebuilds.clear();\n },\n };\n}\n\n/**\n * Whether a frame's probes can blend at all, checked without allocating: two box probes, one with a\n * `blendDistance`.\n *\n * @param candidates - The frame's candidates.\n * @returns `true` when {@link reflectionProbeBlendLayout} is worth calling.\n */\nfunction mayBlend(candidates: readonly BoundCandidate[]): boolean {\n let boxes = 0;\n let blends = false;\n for (const candidate of candidates) {\n if (candidate.box !== null) {\n boxes += 1;\n blends ||= candidate.blendDistance > 0;\n }\n }\n return boxes >= 2 && blends;\n}\n\n/**\n * Whether two set keys are equal, element by element.\n *\n * @param a - A key, or `null`.\n * @param b - Another key.\n * @returns `true` when both have the same elements.\n */\nfunction sameKey(a: readonly unknown[] | null, b: readonly unknown[]): boolean {\n return a !== null && a.length === b.length && a.every((value, index) => value === b[index]);\n}\n\n/**\n * Builds the mesh filter of a probe's capture: with a non-empty `cullingMask`, only meshes whose\n * entity is on one of its layers.\n *\n * @param world - The world, for the handle and layer tables.\n * @param probe - The probe; its mask is read on every call, so edits apply to the next capture.\n * @returns The filter.\n */\nfunction cullingFilter(world: World, probe: ReflectionProbe): (tag: NodeTag | null) => boolean {\n return (tag): boolean => {\n const mask = probe.cullingMask;\n if (mask.length === 0) {\n return true;\n }\n const entity = tag === null ? null : world.getEntityByHandle(toEntityHandle(tag.entity));\n if (entity === null) {\n return false;\n }\n for (const name of mask) {\n if (world.layers.indexOf(name) === entity.layer) {\n return true;\n }\n }\n return false;\n };\n}\n\n/**\n * The binding a probe's materials use: the previous one while nothing it holds changed, so a still\n * probe never rebuilds its materials.\n *\n * @param previous - The binding last used, or `null`.\n * @param environment - The probe's environment.\n * @param x - The probe's world X.\n * @param y - The probe's world Y.\n * @param z - The probe's world Z.\n * @param box - The projection box size, or `null`.\n * @returns The binding.\n */\nfunction bindingFor(\n previous: LiteProbeBinding | null,\n environment: LiteProbeBinding[\"environment\"],\n x: number,\n y: number,\n z: number,\n box: Vec3Like | null,\n): LiteProbeBinding {\n if (\n previous !== null &&\n previous.environment === environment &&\n previous.position[0] === x &&\n previous.position[1] === y &&\n previous.position[2] === z &&\n (box === null\n ? previous.box === null\n : previous.box !== null && previous.box[0] === box.x && previous.box[1] === box.y && previous.box[2] === box.z)\n ) {\n return previous;\n }\n return { environment, position: [x, y, z], box: box === null ? null : [box.x, box.y, box.z] };\n}\n"],"mappings":"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"}
@@ -1,4 +1,4 @@
1
- import { i as readSceneEnvironment } from "./environment-DZ6WUHbm.js";
1
+ import { i as readSceneEnvironment } from "./environment-Bf4aphSb.js";
2
2
  import { createShaderMaterial, createTexture2DArrayFromPixels, createTexture2DFromPixels, enableShaderMaterialUniformCaching, setShaderMatrix, setShaderStorageBuffer, setShaderTexture, setShaderUniform } from "@babylonjs/lite";
3
3
  //#region src/lite/gpu/shader-material.ts
4
4
  /** The RGBA bytes of each 1x1 fallback texture. */
@@ -302,4 +302,4 @@ function readSceneAmbient(scene, out) {
302
302
  //#endregion
303
303
  export { createFallbackTexture, createShaderMaterialFromOptions, enableShaderUniformCaching, linearOutputFragment, readSceneAmbient, resolveFallbackTexture, writeShaderMatrix, writeShaderStorageBuffer, writeShaderTexture, writeShaderUniform };
304
304
 
305
- //# sourceMappingURL=shader-material-CaAkv5nT.js.map
305
+ //# sourceMappingURL=shader-material-CJIDFvSb.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"shader-material-CaAkv5nT.js","names":[],"sources":["../src/lite/gpu/shader-material.ts"],"sourcesContent":["import {\n createShaderMaterial,\n createTexture2DArrayFromPixels,\n createTexture2DFromPixels,\n enableShaderMaterialUniformCaching,\n setShaderMatrix,\n setShaderStorageBuffer,\n setShaderTexture,\n setShaderUniform,\n} from \"@babylonjs/lite\";\nimport { readSceneEnvironment } from \"./environment.js\";\nimport type {\n EngineContext,\n SceneContext,\n ShaderAttributeName,\n ShaderMaterial,\n ShaderSystemUniformName,\n ShaderUniformType,\n StorageBuffer,\n Texture2D,\n} from \"@babylonjs/lite\";\n\n/**\n * The custom-WGSL half of the Babylon Lite adapter: `createShaderMaterial`, the `setShader*`\n * setters, and the 1x1 fallback textures a declared sampler falls back to\n * (`docs/plan/2026-09-terrain-particles-shaders.md` §3.1, ADR-0024). Everything here is `@internal`.\n *\n * Lite exports one barrel, so a static import of `createShaderMaterial` anywhere in the reachable\n * graph pulls `lib/material/shader/**` into every entry chunk. This module is therefore reached with\n * `await import(...)` from `../../render/shader-support.ts`, and only loading a `.wgsl` triggers the\n * fetch. `./storage-buffer.ts` is a separate file for the same reason: `StorageBufferAsset`\n * allocates synchronously, so it cannot wait for this chunk.\n *\n * Two Lite facts it is written around:\n *\n * - Nothing may be left unbound: `createShaderBindGroup` throws (errors 309 and 310) when a declared\n * sampler has no texture or a declared storage buffer has no buffer, which is what\n * {@link createFallbackTexture} exists for.\n * - There is no front-face culling; `ShaderMaterialOptions` carries only `backFaceCulling`\n * (`lib/material/shader/shader-pipeline.js`), so the pragma parser refuses `cull front`.\n */\n\n/**\n * A Babylon Lite custom WGSL material, re-exported under an ignifx name\n * (`CONSTITUTION.md` §3.4, coding standards §4).\n *\n * @remarks\n * Unstable; excluded from the stability guarantees of `CONSTITUTION.md` Article IV.\n *\n * @public\n */\nexport type LiteShaderMaterial = ShaderMaterial;\n\n/** The RGBA bytes of each 1x1 fallback texture. */\nconst FALLBACK_PIXELS: Readonly<Record<string, readonly [number, number, number, number]>> = Object.freeze({\n white: [255, 255, 255, 255],\n black: [0, 0, 0, 255],\n transparent: [0, 0, 0, 0],\n});\n\n/**\n * One declared uniform in the form Babylon Lite's factory takes: either the name of a system\n * uniform it fills in itself, or a custom declaration with its initial value.\n *\n * @internal\n */\nexport type ShaderUniformEntry =\n | ShaderSystemUniformName\n | {\n /** The WGSL identifier. */\n readonly name: string;\n /** The WGSL type. */\n readonly type: ShaderUniformType;\n /** The initial value, **linear** for a colour. */\n readonly defaultValue: number | readonly number[];\n };\n\n/**\n * One declared sampler in the form Babylon Lite's factory takes.\n *\n * @internal\n */\nexport interface ShaderSamplerEntry {\n /** The WGSL identifier; Lite generates `<name>Sampler` beside it. */\n readonly name: string;\n /** `\"2d-array\"` for a `texture_2d_array<f32>` binding. */\n readonly viewDimension: \"2d\" | \"2d-array\";\n}\n\n/**\n * One declared storage buffer in the form Babylon Lite's factory takes.\n *\n * @internal\n */\nexport interface ShaderStorageEntry {\n /** The WGSL identifier. */\n readonly name: string;\n /** The WGSL variable type, verbatim. */\n readonly type: string;\n}\n\n/**\n * Everything Babylon Lite's `createShaderMaterial` needs, in ignifx's own vocabulary so that the\n * mapping from a `ShaderDeclaration` can be built and asserted without a device or a Lite import\n * (`src/render/shader-material.ts`).\n *\n * @remarks\n * A `null` blend state or depth comparison means \"leave Babylon Lite's own default in place\", so\n * this module never restates a Lite default that could change.\n *\n * @internal\n */\nexport interface ShaderMaterialBuildOptions {\n /** The material's name, used in pipeline and shader-module labels. */\n readonly name: string;\n /** The WGSL source, handed to Lite as both the vertex and the fragment source. */\n readonly source: string;\n /**\n * Whether the scene renders through `rendering.hdr`, where the fragment's display colour is\n * decoded to linear before it is written (see {@link linearOutputFragment}). Absent means `false`.\n */\n readonly linearOutput?: boolean;\n /** The vertex attributes the vertex stage reads; `position` is mandatory. */\n readonly attributes: readonly ShaderAttributeName[];\n /** The system and custom uniforms, in binding-declaration order. */\n readonly uniforms: readonly ShaderUniformEntry[];\n /** The samplers. */\n readonly samplers: readonly ShaderSamplerEntry[];\n /** The read-only storage buffers. */\n readonly storageBuffers: readonly ShaderStorageEntry[];\n /** The WGSL `const` declarations, resolved from the file's defaults and the material's overrides. */\n readonly defines: Readonly<Record<string, boolean | number>>;\n /** Whether the thin-instance RGBA stream is bound and injected into `VertexInput`. */\n readonly useThinInstanceColors: boolean;\n /** Whether the surface is alpha-blended. */\n readonly needAlphaBlending: boolean;\n /** Which of Lite's two blend equations to use when no explicit state is given. */\n readonly blendMode: \"alpha\" | \"additive\";\n /** An explicit colour-target blend state, which replaces the derived one; `null` to derive it. */\n readonly blend: GPUBlendState | null;\n /** Whether the surface samples the opaque scene colour behind it. */\n readonly transmissive: boolean;\n /** Whether back faces are culled. */\n readonly backFaceCulling: boolean;\n /** Whether the draw writes depth. */\n readonly depthWrite: boolean;\n /** The depth comparison, or `null` for Lite's own reverse-Z default. */\n readonly depthCompare: GPUCompareFunction | null;\n}\n\n/**\n * Builds a Babylon Lite custom WGSL material.\n *\n * @remarks\n * Validation is eager and compilation is lazy, so this runs under the null engine; the pipeline is\n * compiled the first time a mesh wearing the material is drawn.\n *\n * @param options - The sources and the declared attribute, uniform, sampler, and storage layout.\n * @returns The material.\n * @throws Error from Babylon Lite when the declaration is not one it can build.\n *\n * @internal\n */\nexport function createShaderMaterialFromOptions(options: ShaderMaterialBuildOptions): ShaderMaterial {\n const premultiplied = options.blend?.color.srcFactor === \"one\";\n return createShaderMaterial({\n name: options.name,\n vertexSource: options.source,\n fragmentSource:\n options.linearOutput === true ? linearOutputFragment(options.source, premultiplied) : options.source,\n attributes: options.attributes,\n uniforms: options.uniforms,\n samplers: options.samplers,\n storageBuffers: options.storageBuffers,\n defines: options.defines,\n useThinInstanceColors: options.useThinInstanceColors,\n needAlphaBlending: options.needAlphaBlending,\n blendMode: options.blendMode,\n ...(options.blend === null ? {} : { blend: options.blend }),\n transmissive: options.transmissive,\n backFaceCulling: options.backFaceCulling,\n depthWrite: options.depthWrite,\n ...(options.depthCompare === null ? {} : { depthCompare: options.depthCompare }),\n });\n}\n\n/** The name a wrapped `mainFragment` is renamed to. */\nconst WRAPPED_FRAGMENT = \"ignifxDisplayFragment\";\n\n/**\n * Wraps a custom shader's `mainFragment` so that, under `rendering.hdr`, it writes linear colour\n * (`docs/plan/2026-11-gi-phase-1-execution-plan.md`, step G3).\n *\n * @remarks\n * A custom shader writes the colour that is displayed: with HDR off it lands on the swapchain as\n * is. With HDR on it lands in the linear scene target and the output pass encodes it, so the\n * wrapper decodes it first with the exact inverse of that encode (`pow(c, 2.2)`). The user's entry\n * point loses its `@fragment` and is renamed; a new `mainFragment` with the same parameters calls\n * it. A premultiplied colour is divided by alpha before the decode and multiplied after it, so the\n * blend still sees premultiplied colour. Only a single `@location(0) vec4<f32>` return can be\n * wrapped; anything else (a struct of outputs) is returned unchanged.\n *\n * @param source - The `.wgsl` file.\n * @param premultiplied - Whether the material blends premultiplied colour.\n * @returns The fragment source.\n *\n * @internal\n */\nexport function linearOutputFragment(source: string, premultiplied: boolean): string {\n const entry = /@fragment\\s+fn\\s+mainFragment\\s*\\(/u.exec(source);\n if (entry === null) {\n return source;\n }\n const open = entry.index + entry[0].length - 1;\n const close = matchingParen(source, open);\n if (close < 0) {\n return source;\n }\n const after = source.slice(close + 1);\n const result = /^\\s*->\\s*@location\\(\\s*0\\s*\\)\\s*vec4\\s*<\\s*f32\\s*>\\s*\\{/u.exec(after);\n if (result === null) {\n return source;\n }\n const parameters = source.slice(open + 1, close);\n const names = parameterNames(parameters);\n const decode = premultiplied\n ? \"select(pow(max(c.rgb,vec3<f32>(0.0)),vec3<f32>(2.2)),pow(max(c.rgb/c.a,vec3<f32>(0.0)),vec3<f32>(2.2))*c.a,c.a>0.0)\"\n : \"pow(max(c.rgb,vec3<f32>(0.0)),vec3<f32>(2.2))\";\n return [\n // A plain function may not carry the entry point's `@location(0)` on its return type.\n `${source.slice(0, entry.index)}fn ${WRAPPED_FRAGMENT}(${stripAttributes(parameters)})->vec4<f32>{${after.slice(result[0].length)}`,\n `@fragment fn mainFragment(${parameters})->@location(0) vec4<f32>{`,\n `let c=${WRAPPED_FRAGMENT}(${names.join(\",\")});`,\n `return vec4<f32>(${decode},c.a);`,\n \"}\",\n ].join(\"\\n\");\n}\n\n/**\n * Finds the parenthesis that closes the one at `open`.\n *\n * @param text - The source.\n * @param open - The index of a `(`.\n * @returns The index of its `)`, or `-1`.\n */\nfunction matchingParen(text: string, open: number): number {\n let depth = 0;\n for (let index = open; index < text.length; index += 1) {\n const char = text[index];\n if (char === \"(\") {\n depth += 1;\n } else if (char === \")\") {\n depth -= 1;\n if (depth === 0) {\n return index;\n }\n }\n }\n return -1;\n}\n\n/**\n * Removes WGSL attributes (`@builtin(position)`, `@location(0)`, `@interpolate(flat)`) from a\n * parameter list, which a plain function's parameters may not carry.\n *\n * @param parameters - The parameter list.\n * @returns The list without attributes.\n */\nfunction stripAttributes(parameters: string): string {\n return parameters.replaceAll(/@\\w+\\s*(\\([^)]*\\))?\\s*/gu, \"\");\n}\n\n/**\n * The parameter names of a WGSL parameter list, attributes stripped.\n *\n * @param parameters - The text between an entry point's parentheses.\n * @returns The names, in order.\n */\nfunction parameterNames(parameters: string): string[] {\n const names: string[] = [];\n let depth = 0;\n let start = 0;\n const take = (end: number): void => {\n const piece = stripAttributes(parameters.slice(start, end)).trim();\n const colon = piece.indexOf(\":\");\n if (colon > 0) {\n names.push(piece.slice(0, colon).trim());\n }\n };\n for (let index = 0; index < parameters.length; index += 1) {\n const char = parameters[index];\n if (char === \"(\" || char === \"<\") {\n depth += 1;\n } else if (char === \")\" || char === \">\") {\n depth -= 1;\n } else if (char === \",\" && depth === 0) {\n take(index);\n start = index + 1;\n }\n }\n take(parameters.length);\n return names;\n}\n\n/**\n * Writes a declared scalar, vector, or matrix uniform.\n *\n * @remarks\n * Lite compares the incoming numbers with the ones it holds and bumps the material's uniform\n * version only when one changed, so calling this every frame with an unchanged value costs a few\n * comparisons and no upload (`lib/material/shader/shader-material.js`, `setUniformValue`).\n *\n * @param material - The material to write to.\n * @param name - The declared uniform name.\n * @param value - The value; its length must match the declared type.\n * @throws Error from Babylon Lite when the name is not declared or the length is wrong.\n *\n * @internal\n */\nexport function writeShaderUniform(\n material: ShaderMaterial,\n name: string,\n value: number | readonly number[] | Float32Array,\n): void {\n setShaderUniform(material, name, value);\n}\n\n/**\n * Writes a declared `mat4x4<f32>` uniform from sixteen column-major floats.\n *\n * @param material - The material to write to.\n * @param name - The declared uniform name.\n * @param value - The matrix.\n *\n * @internal\n */\nexport function writeShaderMatrix(material: ShaderMaterial, name: string, value: Float32Array): void {\n setShaderMatrix(material, name, value);\n}\n\n/**\n * Binds or clears a declared sampler's texture.\n *\n * @param material - The material to write to.\n * @param name - The declared sampler name.\n * @param texture - The texture, or `null` to unbind. An unbound sampler makes the material\n * unbuildable, so ignifx always binds a fallback instead.\n *\n * @internal\n */\nexport function writeShaderTexture(material: ShaderMaterial, name: string, texture: Texture2D | null): void {\n setShaderTexture(material, name, texture);\n}\n\n/**\n * Binds or clears a declared storage buffer.\n *\n * @param material - The material to write to.\n * @param name - The declared storage buffer name.\n * @param buffer - The buffer, or `null` to unbind.\n *\n * @internal\n */\nexport function writeShaderStorageBuffer(material: ShaderMaterial, name: string, buffer: StorageBuffer | null): void {\n setShaderStorageBuffer(material, name, buffer);\n}\n\n/**\n * The 1x1 texture a declared-but-unbound sampler is filled with, created on first use and shared for\n * the life of the app.\n *\n * @param engine - The engine that owns the texture.\n * @param cache - The app's fallback textures, keyed by kind; a miss is created and stored.\n * @param fallback - `\"white\"`, `\"black\"`, or `\"transparent\"`; `null` means white.\n * @param array - `true` for a one-layer `texture_2d_array<f32>`.\n * @returns The texture.\n *\n * @internal\n */\nexport function resolveFallbackTexture(\n engine: EngineContext,\n cache: Map<string, Texture2D>,\n fallback: string | null,\n array: boolean,\n): Texture2D {\n const kind = fallback ?? \"white\";\n const key = array ? `${kind}:array` : kind;\n const cached = cache.get(key);\n if (cached !== undefined) {\n return cached;\n }\n const created = createFallbackTexture(engine, kind, array);\n cache.set(key, created);\n return created;\n}\n\n/**\n * Creates the 1x1 texture a declared-but-unbound sampler is filled with.\n *\n * @remarks\n * Babylon Lite refuses to build a bind group for a sampler with nothing bound (error 309), so a\n * material whose file declares `// @ignifx texture noise` and whose `.material.json` binds nothing\n * would be undrawable. One 1x1 texture per fallback kind per app is what makes it legal, which is\n * also Godot's `hint_default_white` behaviour.\n *\n * @param engine - The engine that owns the texture.\n * @param fallback - `\"white\"`, `\"black\"`, or `\"transparent\"`.\n * @param array - `true` for a one-layer `texture_2d_array<f32>`, which is what a sampler declared\n * `array` binds.\n * @returns The texture.\n *\n * @internal\n */\nexport function createFallbackTexture(engine: EngineContext, fallback: string, array: boolean): Texture2D {\n const rgba = FALLBACK_PIXELS[fallback] ?? FALLBACK_PIXELS[\"white\"];\n const pixels = Uint8Array.from(rgba ?? [255, 255, 255, 255]);\n return array\n ? createTexture2DArrayFromPixels(engine, pixels, 1, 1, 1, { mipMaps: false })\n : createTexture2DFromPixels(engine, pixels, 1, 1, {});\n}\n\n/**\n * Turns on Babylon Lite's cached uniform serialization plans for shader materials.\n *\n * @remarks\n * Process-global and idempotent: it installs two writer functions that keep a `WeakMap` of layout\n * plans per material and rewrite only the custom uniform slots whose value changed\n * (`lib/material/shader/enable-shader-material-uniform-caching.js`). That is exactly the shape of\n * ignifx's per-frame `time` upload, so the adapter enables it as it loads rather than making every\n * project remember to.\n *\n * @internal\n */\nexport function enableShaderUniformCaching(): void {\n enableShaderMaterialUniformCaching();\n}\n\n/**\n * Reads the installed environment's ambient irradiance — the `L00` band of its diffuse spherical\n * harmonics — into `out`.\n *\n * @remarks\n * `EnvironmentTextures.sphericalHarmonics` is declared: 36 floats in a stride-4 layout beginning\n * `[L00.rgb, 0, …]` (`index.d.ts`), the same block Babylon Lite writes into the scene uniform buffer\n * as `scene.vSphericalL00` and friends (`lib/scene/scene-ubo-extras.js`, `writeEnvUbo`). So the\n * value ignifx uploads as `ambientColor` is exactly what a shader could read for itself as\n * `scene.vSphericalL00.rgb`, which is the documented alternative for a shader that would rather not\n * declare the uniform. Reaching the slot goes through `./environment.ts`, which is the one place\n * ignifx touches the undeclared `scene._envTextures` field\n * (`docs/architecture/07-rendering.md` §2.5, §8).\n *\n * @param scene - The render scene.\n * @param out - Receives the three linear channels; left untouched when nothing is installed.\n * @returns `true` when an environment supplied harmonics.\n *\n * @internal\n */\nexport function readSceneAmbient(scene: SceneContext, out: Float32Array): boolean {\n const harmonics = readSceneEnvironment(scene)?.sphericalHarmonics;\n if (harmonics === undefined || harmonics.length < 3) {\n return false;\n }\n out[0] = harmonics[0] ?? 0;\n out[1] = harmonics[1] ?? 0;\n out[2] = harmonics[2] ?? 0;\n return true;\n}\n\n/**\n * The subset of this module `src/render/shader-material.ts` reaches through its dynamic `import()`,\n * named so the memo has a type that does not have to be written as `typeof import(…)` (which the\n * `consistent-type-imports` rule forbids).\n *\n * @remarks\n * Assigning the imported module namespace to this type is what checks the two against each other,\n * so a signature that drifts is a compile error rather than a runtime surprise.\n *\n * @internal\n */\nexport interface ShaderMaterialAdapter {\n /** {@link createShaderMaterialFromOptions}. */\n readonly createShaderMaterialFromOptions: (options: ShaderMaterialBuildOptions) => ShaderMaterial;\n /** {@link writeShaderUniform}. */\n readonly writeShaderUniform: (\n material: ShaderMaterial,\n name: string,\n value: number | readonly number[] | Float32Array,\n ) => void;\n /** {@link writeShaderMatrix}. */\n readonly writeShaderMatrix: (material: ShaderMaterial, name: string, value: Float32Array) => void;\n /** {@link writeShaderTexture}. */\n readonly writeShaderTexture: (material: ShaderMaterial, name: string, texture: Texture2D | null) => void;\n /** {@link writeShaderStorageBuffer}. */\n readonly writeShaderStorageBuffer: (material: ShaderMaterial, name: string, buffer: StorageBuffer | null) => void;\n /** {@link resolveFallbackTexture}. */\n readonly resolveFallbackTexture: (\n engine: EngineContext,\n cache: Map<string, Texture2D>,\n fallback: string | null,\n array: boolean,\n ) => Texture2D;\n /** {@link enableShaderUniformCaching}. */\n readonly enableShaderUniformCaching: () => void;\n /** {@link readSceneAmbient}. */\n readonly readSceneAmbient: (scene: SceneContext, out: Float32Array) => boolean;\n}\n"],"mappings":"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"}
1
+ {"version":3,"file":"shader-material-CJIDFvSb.js","names":[],"sources":["../src/lite/gpu/shader-material.ts"],"sourcesContent":["import {\n createShaderMaterial,\n createTexture2DArrayFromPixels,\n createTexture2DFromPixels,\n enableShaderMaterialUniformCaching,\n setShaderMatrix,\n setShaderStorageBuffer,\n setShaderTexture,\n setShaderUniform,\n} from \"@babylonjs/lite\";\nimport { readSceneEnvironment } from \"./environment.js\";\nimport type {\n EngineContext,\n SceneContext,\n ShaderAttributeName,\n ShaderMaterial,\n ShaderSystemUniformName,\n ShaderUniformType,\n StorageBuffer,\n Texture2D,\n} from \"@babylonjs/lite\";\n\n/**\n * The custom-WGSL half of the Babylon Lite adapter: `createShaderMaterial`, the `setShader*`\n * setters, and the 1x1 fallback textures a declared sampler falls back to\n * (`docs/plan/2026-09-terrain-particles-shaders.md` §3.1, ADR-0024). Everything here is `@internal`.\n *\n * Lite exports one barrel, so a static import of `createShaderMaterial` anywhere in the reachable\n * graph pulls `lib/material/shader/**` into every entry chunk. This module is therefore reached with\n * `await import(...)` from `../../render/shader-support.ts`, and only loading a `.wgsl` triggers the\n * fetch. `./storage-buffer.ts` is a separate file for the same reason: `StorageBufferAsset`\n * allocates synchronously, so it cannot wait for this chunk.\n *\n * Two Lite facts it is written around:\n *\n * - Nothing may be left unbound: `createShaderBindGroup` throws (errors 309 and 310) when a declared\n * sampler has no texture or a declared storage buffer has no buffer, which is what\n * {@link createFallbackTexture} exists for.\n * - There is no front-face culling; `ShaderMaterialOptions` carries only `backFaceCulling`\n * (`lib/material/shader/shader-pipeline.js`), so the pragma parser refuses `cull front`.\n */\n\n/**\n * A Babylon Lite custom WGSL material, re-exported under an ignifx name\n * (`CONSTITUTION.md` §3.4, coding standards §4).\n *\n * @remarks\n * Unstable; excluded from the stability guarantees of `CONSTITUTION.md` Article IV.\n *\n * @public\n */\nexport type LiteShaderMaterial = ShaderMaterial;\n\n/** The RGBA bytes of each 1x1 fallback texture. */\nconst FALLBACK_PIXELS: Readonly<Record<string, readonly [number, number, number, number]>> = Object.freeze({\n white: [255, 255, 255, 255],\n black: [0, 0, 0, 255],\n transparent: [0, 0, 0, 0],\n});\n\n/**\n * One declared uniform in the form Babylon Lite's factory takes: either the name of a system\n * uniform it fills in itself, or a custom declaration with its initial value.\n *\n * @internal\n */\nexport type ShaderUniformEntry =\n | ShaderSystemUniformName\n | {\n /** The WGSL identifier. */\n readonly name: string;\n /** The WGSL type. */\n readonly type: ShaderUniformType;\n /** The initial value, **linear** for a colour. */\n readonly defaultValue: number | readonly number[];\n };\n\n/**\n * One declared sampler in the form Babylon Lite's factory takes.\n *\n * @internal\n */\nexport interface ShaderSamplerEntry {\n /** The WGSL identifier; Lite generates `<name>Sampler` beside it. */\n readonly name: string;\n /** `\"2d-array\"` for a `texture_2d_array<f32>` binding. */\n readonly viewDimension: \"2d\" | \"2d-array\";\n}\n\n/**\n * One declared storage buffer in the form Babylon Lite's factory takes.\n *\n * @internal\n */\nexport interface ShaderStorageEntry {\n /** The WGSL identifier. */\n readonly name: string;\n /** The WGSL variable type, verbatim. */\n readonly type: string;\n}\n\n/**\n * Everything Babylon Lite's `createShaderMaterial` needs, in ignifx's own vocabulary so that the\n * mapping from a `ShaderDeclaration` can be built and asserted without a device or a Lite import\n * (`src/render/shader-material.ts`).\n *\n * @remarks\n * A `null` blend state or depth comparison means \"leave Babylon Lite's own default in place\", so\n * this module never restates a Lite default that could change.\n *\n * @internal\n */\nexport interface ShaderMaterialBuildOptions {\n /** The material's name, used in pipeline and shader-module labels. */\n readonly name: string;\n /** The WGSL source, handed to Lite as both the vertex and the fragment source. */\n readonly source: string;\n /**\n * Whether the scene renders through `rendering.hdr`, where the fragment's display colour is\n * decoded to linear before it is written (see {@link linearOutputFragment}). Absent means `false`.\n */\n readonly linearOutput?: boolean;\n /** The vertex attributes the vertex stage reads; `position` is mandatory. */\n readonly attributes: readonly ShaderAttributeName[];\n /** The system and custom uniforms, in binding-declaration order. */\n readonly uniforms: readonly ShaderUniformEntry[];\n /** The samplers. */\n readonly samplers: readonly ShaderSamplerEntry[];\n /** The read-only storage buffers. */\n readonly storageBuffers: readonly ShaderStorageEntry[];\n /** The WGSL `const` declarations, resolved from the file's defaults and the material's overrides. */\n readonly defines: Readonly<Record<string, boolean | number>>;\n /** Whether the thin-instance RGBA stream is bound and injected into `VertexInput`. */\n readonly useThinInstanceColors: boolean;\n /** Whether the surface is alpha-blended. */\n readonly needAlphaBlending: boolean;\n /** Which of Lite's two blend equations to use when no explicit state is given. */\n readonly blendMode: \"alpha\" | \"additive\";\n /** An explicit colour-target blend state, which replaces the derived one; `null` to derive it. */\n readonly blend: GPUBlendState | null;\n /** Whether the surface samples the opaque scene colour behind it. */\n readonly transmissive: boolean;\n /** Whether back faces are culled. */\n readonly backFaceCulling: boolean;\n /** Whether the draw writes depth. */\n readonly depthWrite: boolean;\n /** The depth comparison, or `null` for Lite's own reverse-Z default. */\n readonly depthCompare: GPUCompareFunction | null;\n}\n\n/**\n * Builds a Babylon Lite custom WGSL material.\n *\n * @remarks\n * Validation is eager and compilation is lazy, so this runs under the null engine; the pipeline is\n * compiled the first time a mesh wearing the material is drawn.\n *\n * @param options - The sources and the declared attribute, uniform, sampler, and storage layout.\n * @returns The material.\n * @throws Error from Babylon Lite when the declaration is not one it can build.\n *\n * @internal\n */\nexport function createShaderMaterialFromOptions(options: ShaderMaterialBuildOptions): ShaderMaterial {\n const premultiplied = options.blend?.color.srcFactor === \"one\";\n return createShaderMaterial({\n name: options.name,\n vertexSource: options.source,\n fragmentSource:\n options.linearOutput === true ? linearOutputFragment(options.source, premultiplied) : options.source,\n attributes: options.attributes,\n uniforms: options.uniforms,\n samplers: options.samplers,\n storageBuffers: options.storageBuffers,\n defines: options.defines,\n useThinInstanceColors: options.useThinInstanceColors,\n needAlphaBlending: options.needAlphaBlending,\n blendMode: options.blendMode,\n ...(options.blend === null ? {} : { blend: options.blend }),\n transmissive: options.transmissive,\n backFaceCulling: options.backFaceCulling,\n depthWrite: options.depthWrite,\n ...(options.depthCompare === null ? {} : { depthCompare: options.depthCompare }),\n });\n}\n\n/** The name a wrapped `mainFragment` is renamed to. */\nconst WRAPPED_FRAGMENT = \"ignifxDisplayFragment\";\n\n/**\n * Wraps a custom shader's `mainFragment` so that, under `rendering.hdr`, it writes linear colour\n * (`docs/plan/2026-11-gi-phase-1-execution-plan.md`, step G3).\n *\n * @remarks\n * A custom shader writes the colour that is displayed: with HDR off it lands on the swapchain as\n * is. With HDR on it lands in the linear scene target and the output pass encodes it, so the\n * wrapper decodes it first with the exact inverse of that encode (`pow(c, 2.2)`). The user's entry\n * point loses its `@fragment` and is renamed; a new `mainFragment` with the same parameters calls\n * it. A premultiplied colour is divided by alpha before the decode and multiplied after it, so the\n * blend still sees premultiplied colour. Only a single `@location(0) vec4<f32>` return can be\n * wrapped; anything else (a struct of outputs) is returned unchanged.\n *\n * @param source - The `.wgsl` file.\n * @param premultiplied - Whether the material blends premultiplied colour.\n * @returns The fragment source.\n *\n * @internal\n */\nexport function linearOutputFragment(source: string, premultiplied: boolean): string {\n const entry = /@fragment\\s+fn\\s+mainFragment\\s*\\(/u.exec(source);\n if (entry === null) {\n return source;\n }\n const open = entry.index + entry[0].length - 1;\n const close = matchingParen(source, open);\n if (close < 0) {\n return source;\n }\n const after = source.slice(close + 1);\n const result = /^\\s*->\\s*@location\\(\\s*0\\s*\\)\\s*vec4\\s*<\\s*f32\\s*>\\s*\\{/u.exec(after);\n if (result === null) {\n return source;\n }\n const parameters = source.slice(open + 1, close);\n const names = parameterNames(parameters);\n const decode = premultiplied\n ? \"select(pow(max(c.rgb,vec3<f32>(0.0)),vec3<f32>(2.2)),pow(max(c.rgb/c.a,vec3<f32>(0.0)),vec3<f32>(2.2))*c.a,c.a>0.0)\"\n : \"pow(max(c.rgb,vec3<f32>(0.0)),vec3<f32>(2.2))\";\n return [\n // A plain function may not carry the entry point's `@location(0)` on its return type.\n `${source.slice(0, entry.index)}fn ${WRAPPED_FRAGMENT}(${stripAttributes(parameters)})->vec4<f32>{${after.slice(result[0].length)}`,\n `@fragment fn mainFragment(${parameters})->@location(0) vec4<f32>{`,\n `let c=${WRAPPED_FRAGMENT}(${names.join(\",\")});`,\n `return vec4<f32>(${decode},c.a);`,\n \"}\",\n ].join(\"\\n\");\n}\n\n/**\n * Finds the parenthesis that closes the one at `open`.\n *\n * @param text - The source.\n * @param open - The index of a `(`.\n * @returns The index of its `)`, or `-1`.\n */\nfunction matchingParen(text: string, open: number): number {\n let depth = 0;\n for (let index = open; index < text.length; index += 1) {\n const char = text[index];\n if (char === \"(\") {\n depth += 1;\n } else if (char === \")\") {\n depth -= 1;\n if (depth === 0) {\n return index;\n }\n }\n }\n return -1;\n}\n\n/**\n * Removes WGSL attributes (`@builtin(position)`, `@location(0)`, `@interpolate(flat)`) from a\n * parameter list, which a plain function's parameters may not carry.\n *\n * @param parameters - The parameter list.\n * @returns The list without attributes.\n */\nfunction stripAttributes(parameters: string): string {\n return parameters.replaceAll(/@\\w+\\s*(\\([^)]*\\))?\\s*/gu, \"\");\n}\n\n/**\n * The parameter names of a WGSL parameter list, attributes stripped.\n *\n * @param parameters - The text between an entry point's parentheses.\n * @returns The names, in order.\n */\nfunction parameterNames(parameters: string): string[] {\n const names: string[] = [];\n let depth = 0;\n let start = 0;\n const take = (end: number): void => {\n const piece = stripAttributes(parameters.slice(start, end)).trim();\n const colon = piece.indexOf(\":\");\n if (colon > 0) {\n names.push(piece.slice(0, colon).trim());\n }\n };\n for (let index = 0; index < parameters.length; index += 1) {\n const char = parameters[index];\n if (char === \"(\" || char === \"<\") {\n depth += 1;\n } else if (char === \")\" || char === \">\") {\n depth -= 1;\n } else if (char === \",\" && depth === 0) {\n take(index);\n start = index + 1;\n }\n }\n take(parameters.length);\n return names;\n}\n\n/**\n * Writes a declared scalar, vector, or matrix uniform.\n *\n * @remarks\n * Lite compares the incoming numbers with the ones it holds and bumps the material's uniform\n * version only when one changed, so calling this every frame with an unchanged value costs a few\n * comparisons and no upload (`lib/material/shader/shader-material.js`, `setUniformValue`).\n *\n * @param material - The material to write to.\n * @param name - The declared uniform name.\n * @param value - The value; its length must match the declared type.\n * @throws Error from Babylon Lite when the name is not declared or the length is wrong.\n *\n * @internal\n */\nexport function writeShaderUniform(\n material: ShaderMaterial,\n name: string,\n value: number | readonly number[] | Float32Array,\n): void {\n setShaderUniform(material, name, value);\n}\n\n/**\n * Writes a declared `mat4x4<f32>` uniform from sixteen column-major floats.\n *\n * @param material - The material to write to.\n * @param name - The declared uniform name.\n * @param value - The matrix.\n *\n * @internal\n */\nexport function writeShaderMatrix(material: ShaderMaterial, name: string, value: Float32Array): void {\n setShaderMatrix(material, name, value);\n}\n\n/**\n * Binds or clears a declared sampler's texture.\n *\n * @param material - The material to write to.\n * @param name - The declared sampler name.\n * @param texture - The texture, or `null` to unbind. An unbound sampler makes the material\n * unbuildable, so ignifx always binds a fallback instead.\n *\n * @internal\n */\nexport function writeShaderTexture(material: ShaderMaterial, name: string, texture: Texture2D | null): void {\n setShaderTexture(material, name, texture);\n}\n\n/**\n * Binds or clears a declared storage buffer.\n *\n * @param material - The material to write to.\n * @param name - The declared storage buffer name.\n * @param buffer - The buffer, or `null` to unbind.\n *\n * @internal\n */\nexport function writeShaderStorageBuffer(material: ShaderMaterial, name: string, buffer: StorageBuffer | null): void {\n setShaderStorageBuffer(material, name, buffer);\n}\n\n/**\n * The 1x1 texture a declared-but-unbound sampler is filled with, created on first use and shared for\n * the life of the app.\n *\n * @param engine - The engine that owns the texture.\n * @param cache - The app's fallback textures, keyed by kind; a miss is created and stored.\n * @param fallback - `\"white\"`, `\"black\"`, or `\"transparent\"`; `null` means white.\n * @param array - `true` for a one-layer `texture_2d_array<f32>`.\n * @returns The texture.\n *\n * @internal\n */\nexport function resolveFallbackTexture(\n engine: EngineContext,\n cache: Map<string, Texture2D>,\n fallback: string | null,\n array: boolean,\n): Texture2D {\n const kind = fallback ?? \"white\";\n const key = array ? `${kind}:array` : kind;\n const cached = cache.get(key);\n if (cached !== undefined) {\n return cached;\n }\n const created = createFallbackTexture(engine, kind, array);\n cache.set(key, created);\n return created;\n}\n\n/**\n * Creates the 1x1 texture a declared-but-unbound sampler is filled with.\n *\n * @remarks\n * Babylon Lite refuses to build a bind group for a sampler with nothing bound (error 309), so a\n * material whose file declares `// @ignifx texture noise` and whose `.material.json` binds nothing\n * would be undrawable. One 1x1 texture per fallback kind per app is what makes it legal, which is\n * also Godot's `hint_default_white` behaviour.\n *\n * @param engine - The engine that owns the texture.\n * @param fallback - `\"white\"`, `\"black\"`, or `\"transparent\"`.\n * @param array - `true` for a one-layer `texture_2d_array<f32>`, which is what a sampler declared\n * `array` binds.\n * @returns The texture.\n *\n * @internal\n */\nexport function createFallbackTexture(engine: EngineContext, fallback: string, array: boolean): Texture2D {\n const rgba = FALLBACK_PIXELS[fallback] ?? FALLBACK_PIXELS[\"white\"];\n const pixels = Uint8Array.from(rgba ?? [255, 255, 255, 255]);\n return array\n ? createTexture2DArrayFromPixels(engine, pixels, 1, 1, 1, { mipMaps: false })\n : createTexture2DFromPixels(engine, pixels, 1, 1, {});\n}\n\n/**\n * Turns on Babylon Lite's cached uniform serialization plans for shader materials.\n *\n * @remarks\n * Process-global and idempotent: it installs two writer functions that keep a `WeakMap` of layout\n * plans per material and rewrite only the custom uniform slots whose value changed\n * (`lib/material/shader/enable-shader-material-uniform-caching.js`). That is exactly the shape of\n * ignifx's per-frame `time` upload, so the adapter enables it as it loads rather than making every\n * project remember to.\n *\n * @internal\n */\nexport function enableShaderUniformCaching(): void {\n enableShaderMaterialUniformCaching();\n}\n\n/**\n * Reads the installed environment's ambient irradiance — the `L00` band of its diffuse spherical\n * harmonics — into `out`.\n *\n * @remarks\n * `EnvironmentTextures.sphericalHarmonics` is declared: 36 floats in a stride-4 layout beginning\n * `[L00.rgb, 0, …]` (`index.d.ts`), the same block Babylon Lite writes into the scene uniform buffer\n * as `scene.vSphericalL00` and friends (`lib/scene/scene-ubo-extras.js`, `writeEnvUbo`). So the\n * value ignifx uploads as `ambientColor` is exactly what a shader could read for itself as\n * `scene.vSphericalL00.rgb`, which is the documented alternative for a shader that would rather not\n * declare the uniform. Reaching the slot goes through `./environment.ts`, which is the one place\n * ignifx touches the undeclared `scene._envTextures` field\n * (`docs/architecture/07-rendering.md` §2.5, §8).\n *\n * @param scene - The render scene.\n * @param out - Receives the three linear channels; left untouched when nothing is installed.\n * @returns `true` when an environment supplied harmonics.\n *\n * @internal\n */\nexport function readSceneAmbient(scene: SceneContext, out: Float32Array): boolean {\n const harmonics = readSceneEnvironment(scene)?.sphericalHarmonics;\n if (harmonics === undefined || harmonics.length < 3) {\n return false;\n }\n out[0] = harmonics[0] ?? 0;\n out[1] = harmonics[1] ?? 0;\n out[2] = harmonics[2] ?? 0;\n return true;\n}\n\n/**\n * The subset of this module `src/render/shader-material.ts` reaches through its dynamic `import()`,\n * named so the memo has a type that does not have to be written as `typeof import(…)` (which the\n * `consistent-type-imports` rule forbids).\n *\n * @remarks\n * Assigning the imported module namespace to this type is what checks the two against each other,\n * so a signature that drifts is a compile error rather than a runtime surprise.\n *\n * @internal\n */\nexport interface ShaderMaterialAdapter {\n /** {@link createShaderMaterialFromOptions}. */\n readonly createShaderMaterialFromOptions: (options: ShaderMaterialBuildOptions) => ShaderMaterial;\n /** {@link writeShaderUniform}. */\n readonly writeShaderUniform: (\n material: ShaderMaterial,\n name: string,\n value: number | readonly number[] | Float32Array,\n ) => void;\n /** {@link writeShaderMatrix}. */\n readonly writeShaderMatrix: (material: ShaderMaterial, name: string, value: Float32Array) => void;\n /** {@link writeShaderTexture}. */\n readonly writeShaderTexture: (material: ShaderMaterial, name: string, texture: Texture2D | null) => void;\n /** {@link writeShaderStorageBuffer}. */\n readonly writeShaderStorageBuffer: (material: ShaderMaterial, name: string, buffer: StorageBuffer | null) => void;\n /** {@link resolveFallbackTexture}. */\n readonly resolveFallbackTexture: (\n engine: EngineContext,\n cache: Map<string, Texture2D>,\n fallback: string | null,\n array: boolean,\n ) => Texture2D;\n /** {@link enableShaderUniformCaching}. */\n readonly enableShaderUniformCaching: () => void;\n /** {@link readSceneAmbient}. */\n readonly readSceneAmbient: (scene: SceneContext, out: Float32Array) => boolean;\n}\n"],"mappings":"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"}
@@ -1,6 +1,6 @@
1
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
+ import { o as CoreErrorCode, t as IgnifxError } from "./ignifx-error-DwIZKxA2.js";
3
+ import { I as setOwnJsonProperty } from "./prefab-overrides-C2GsgOQc.js";
4
4
  import { t as Color } from "./color-DrR6GFTd.js";
5
5
  import { r as isHdrScene } from "./render-path-D11i_7X8.js";
6
6
  import { n as IGNIFX_UNIFORM_TYPES, r as LITE_SYSTEM_UNIFORM_NAMES, t as IGNIFX_UNIFORM_NAMES } from "./shader-declaration-5q__jycG.js";
@@ -163,7 +163,7 @@ let adapter = null;
163
163
  */
164
164
  async function loadShaderMaterialAdapter() {
165
165
  if (adapter !== null) return;
166
- const loaded = await import("./shader-material-CaAkv5nT.js");
166
+ const loaded = await import("./shader-material-CJIDFvSb.js");
167
167
  loaded.enableShaderUniformCaching();
168
168
  adapter = loaded;
169
169
  }
@@ -1010,4 +1010,4 @@ function shapeMismatch(declaration, material, expected, actual) {
1010
1010
  //#endregion
1011
1011
  export { shader_material_exports as n, shaderMaterialsOf as t };
1012
1012
 
1013
- //# sourceMappingURL=shader-material-C2_UCYdO.js.map
1013
+ //# sourceMappingURL=shader-material-TM4f8eKA.js.map
@@ -1 +1 @@
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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"}
1
+ {"version":3,"file":"shader-material-TM4f8eKA.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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"}