@ignifx/core 0.20.0 → 0.21.1
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.
- package/README.md +22 -0
- package/dist/{agx-tone-mapping-Cgt844j6.js → agx-tone-mapping-CCdGk_ly.js} +2 -2
- package/dist/agx-tone-mapping-CCdGk_ly.js.map +1 -0
- package/dist/auto-exposure-uzPn0beO.js.map +1 -1
- package/dist/{bloom-hdr-CLtQj-oY.js → bloom-hdr-xPwkIdHG.js} +5 -6
- package/dist/bloom-hdr-xPwkIdHG.js.map +1 -0
- package/dist/contact-shadows-T523EXaP.js.map +1 -1
- package/dist/effect-task-CMbuO6Kb.js.map +1 -1
- package/dist/{environment-Bf4aphSb.js → environment-7fJbN402.js} +2 -2
- package/dist/{environment-Bf4aphSb.js.map → environment-7fJbN402.js.map} +1 -1
- package/dist/{gtao-Bpu5-0Ne.js → gtao-BmdrXXJz.js} +10 -11
- package/dist/gtao-BmdrXXJz.js.map +1 -0
- package/dist/{hdr-output-DBQwMphy.js → hdr-output-_2TU-jWy.js} +8 -8
- package/dist/hdr-output-_2TU-jWy.js.map +1 -0
- package/dist/index.d.ts +40 -42
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +104 -108
- package/dist/index.js.map +1 -1
- package/dist/{instanced-mesh-instance-B-fXKSrY.js → instanced-mesh-instance-BLdAJTj8.js} +3 -3
- package/dist/instanced-mesh-instance-BLdAJTj8.js.map +1 -0
- package/dist/{light-probe-asset-BqfSrJe9.js → light-probe-asset-DGNIwKNb.js} +2 -2
- package/dist/light-probe-asset-DGNIwKNb.js.map +1 -0
- package/dist/{light-probes-DDojYajw.js → light-probes-C8jharz9.js} +6 -6
- package/dist/light-probes-C8jharz9.js.map +1 -0
- package/dist/lightmaps-BUUIIkt9.js.map +1 -1
- package/dist/material-myMbl9mW.js.map +1 -1
- package/dist/{material-plugin-DapJNj04.js → material-plugin-BBxIy6eo.js} +4 -4
- package/dist/material-plugin-BBxIy6eo.js.map +1 -0
- package/dist/{overlay-CjVgsfrm.js → overlay-DokHzP6_.js} +2 -3
- package/dist/overlay-DokHzP6_.js.map +1 -0
- package/dist/{post-effect-Cu3Enpz7.js → post-effect-DEZD-r0I.js} +3 -3
- package/dist/post-effect-DEZD-r0I.js.map +1 -0
- package/dist/{post-effect-compiler-cCq9lcHt.js → post-effect-compiler-unDD3hod.js} +4 -4
- package/dist/post-effect-compiler-unDD3hod.js.map +1 -0
- package/dist/{prefab-overrides-C2GsgOQc.js → prefab-overrides-Bb7jVm7A.js} +3 -3
- package/dist/prefab-overrides-Bb7jVm7A.js.map +1 -0
- package/dist/{prefab-overrides-htDc_5Po.d.ts → prefab-overrides-DwrPDVVt.d.ts} +61 -63
- package/dist/{prefab-overrides-htDc_5Po.d.ts.map → prefab-overrides-DwrPDVVt.d.ts.map} +1 -1
- package/dist/prefab.d.ts +1 -1
- package/dist/prefab.js +1 -1
- package/dist/{reflection-probe-QkD1Fo_d.js → reflection-probe-C2jcreI1.js} +5 -5
- package/dist/reflection-probe-C2jcreI1.js.map +1 -0
- package/dist/{reflection-probes-CAzSuqf8.js → reflection-probes-BMVQfbhm.js} +10 -10
- package/dist/reflection-probes-BMVQfbhm.js.map +1 -0
- package/dist/{render-path-D11i_7X8.js → render-path-CWXHrRa2.js} +2 -2
- package/dist/render-path-CWXHrRa2.js.map +1 -0
- package/dist/{scene-color-passes-B93qTOka.js → scene-color-passes-DgXJ45Ql.js} +2 -2
- package/dist/scene-color-passes-DgXJ45Ql.js.map +1 -0
- package/dist/{scene-inputs-BxGOsnIZ.js → scene-inputs-_0j2Hi6L.js} +9 -8
- package/dist/scene-inputs-_0j2Hi6L.js.map +1 -0
- package/dist/{shader-declaration-5q__jycG.js → shader-declaration-BGprFBLq.js} +4 -4
- package/dist/shader-declaration-BGprFBLq.js.map +1 -0
- package/dist/{shader-material-TM4f8eKA.js → shader-material-C9sYMGWw.js} +8 -9
- package/dist/shader-material-C9sYMGWw.js.map +1 -0
- package/dist/{shader-material-CJIDFvSb.js → shader-material-vmkJ25II.js} +3 -3
- package/dist/shader-material-vmkJ25II.js.map +1 -0
- package/dist/{shader-pragma-ljmAbVc2.js → shader-pragma-D0MjCOIg.js} +3 -3
- package/dist/shader-pragma-D0MjCOIg.js.map +1 -0
- package/dist/ssgi-DSnhqotl.js.map +1 -1
- package/dist/{surface-shader-rpPpeosD.js → surface-shader-BfADq9Wx.js} +6 -6
- package/dist/surface-shader-BfADq9Wx.js.map +1 -0
- package/dist/{taa-BwBZLy11.js → taa-nxVA78Ur.js} +5 -6
- package/dist/taa-nxVA78Ur.js.map +1 -0
- package/dist/vec3-2C3LBZnt.js.map +1 -1
- package/package.json +1 -1
- package/dist/agx-tone-mapping-Cgt844j6.js.map +0 -1
- package/dist/bloom-hdr-CLtQj-oY.js.map +0 -1
- package/dist/gtao-Bpu5-0Ne.js.map +0 -1
- package/dist/hdr-output-DBQwMphy.js.map +0 -1
- package/dist/instanced-mesh-instance-B-fXKSrY.js.map +0 -1
- package/dist/light-probe-asset-BqfSrJe9.js.map +0 -1
- package/dist/light-probes-DDojYajw.js.map +0 -1
- package/dist/material-plugin-DapJNj04.js.map +0 -1
- package/dist/overlay-CjVgsfrm.js.map +0 -1
- package/dist/post-effect-Cu3Enpz7.js.map +0 -1
- package/dist/post-effect-compiler-cCq9lcHt.js.map +0 -1
- package/dist/prefab-overrides-C2GsgOQc.js.map +0 -1
- package/dist/reflection-probe-QkD1Fo_d.js.map +0 -1
- package/dist/reflection-probes-CAzSuqf8.js.map +0 -1
- package/dist/render-path-D11i_7X8.js.map +0 -1
- package/dist/scene-color-passes-B93qTOka.js.map +0 -1
- package/dist/scene-inputs-BxGOsnIZ.js.map +0 -1
- package/dist/shader-declaration-5q__jycG.js.map +0 -1
- package/dist/shader-material-CJIDFvSb.js.map +0 -1
- package/dist/shader-material-TM4f8eKA.js.map +0 -1
- package/dist/shader-pragma-ljmAbVc2.js.map +0 -1
- package/dist/surface-shader-rpPpeosD.js.map +0 -1
- package/dist/taa-BwBZLy11.js.map +0 -1
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"scene-color-passes-DgXJ45Ql.js","names":[],"sources":["../src/lite/gpu/scene-color-passes.ts"],"sourcesContent":["import {\n addTaskAfter,\n buildFrameGraphTask,\n createCopyToTextureTask,\n createRenderTarget,\n disposeRenderTarget,\n getFrameGraph,\n} from \"@babylonjs/lite\";\nimport { frameGraphTasks } from \"./scene-inputs.js\";\nimport type { ScenePresenter } from \"./render-path.js\";\nimport type { EngineContext, RenderTarget, SceneContext, Task } from \"@babylonjs/lite\";\n\n/**\n * Scene-colour passes (`docs/architecture/07-rendering.md` §2.7): Lite screen-space effects that\n * read the lit scene colour and the shared scene-input depth, and whose result replaces the scene\n * colour before anything else reads it. Its own chunk, loaded with the first such effect\n * (`CONSTITUTION.md` §2.5).\n *\n * ```text\n * scene ─→ S ─ pass 1 ─→ scratch ─ pass 2 ─→ S ─ … [─ copy ─→ S] ─→ present / output pass / chain\n * ```\n *\n * `S` is the presenter's {@link ScenePresenter.scenePass} target: `sceneColor` on the plain path,\n * the linear `rgba16float` target under `rendering.hdr`, so the passes see linear colour ahead of\n * the output pass there. Lite's composite cannot write its own source, so under HDR the passes\n * ping-pong between `S` and one scratch target of the same format, and a copy brings an odd count\n * back into `S`. On the plain path no pass may write `S` (`ScenePass.isTargetWritable` in `./render-path.ts`): the\n * passes ping-pong between two scratch targets and the copy always runs. Every task sits right after\n * the scene task, ahead of the present blit, the HDR output pass and a `PostProcessStack` chain\n * alike, which therefore need no change.\n */\n\n/**\n * One scene-colour effect, as the installer sees it.\n *\n * @internal\n */\nexport interface SceneColorPass {\n /**\n * Creates the effect's task.\n *\n * @param source - The colour it reads.\n * @param target - The colour it writes; never `source`.\n * @returns The task.\n */\n create(source: RenderTarget, target: RenderTarget): Task;\n}\n\n/**\n * The installed passes.\n *\n * @internal\n */\nexport interface InstalledSceneColorPasses {\n /** How many tasks were added, copy included. */\n readonly taskCount: number;\n /** Removes and disposes every task and the scratch target. Idempotent. */\n dispose(): void;\n}\n\n/**\n * Inserts the passes after the scene task, in order.\n *\n * @param engine - The engine; also the surface the scratch target is sized by.\n * @param scene - The scene.\n * @param presenter - The offscreen render path.\n * @param passes - The effects, first to last.\n * @param isFrameGraphBuilt - Whether the scene is registered, so each task is recorded now.\n * @returns The handle that takes them out again.\n *\n * @internal\n */\nexport function installSceneColorPasses(\n engine: EngineContext,\n scene: SceneContext,\n presenter: ScenePresenter,\n passes: readonly SceneColorPass[],\n isFrameGraphBuilt: boolean,\n): InstalledSceneColorPasses {\n const { task: sceneTask, target: sceneTarget, format, isTargetWritable } = presenter.scenePass;\n const scratches: RenderTarget[] = [];\n const tasks: Task[] = [];\n let source = sceneTarget;\n for (const pass of passes) {\n const target = sceneColorPassTarget(source, sceneTarget, isTargetWritable, scratches, (index) =>\n createRenderTarget({\n lbl: index === 0 ? \"ignifx:scene-color-scratch\" : \"ignifx:scene-color-scratch-2\",\n format,\n samples: 1,\n size: engine,\n }),\n );\n tasks.push(pass.create(source, target));\n source = target;\n }\n if (source !== sceneTarget) {\n tasks.push(\n createCopyToTextureTask(\n { name: \"ignifx:scene-color-copy\", sourceTexture: source, targetTexture: sceneTarget },\n engine,\n scene,\n ),\n );\n }\n let after = sceneTask;\n for (const task of tasks) {\n addTaskAfter(scene, task, after);\n after = task;\n }\n if (isFrameGraphBuilt) {\n const graph = getFrameGraph(scene);\n for (const task of tasks) {\n buildFrameGraphTask(graph, task);\n }\n }\n let isDisposed = false;\n return {\n taskCount: tasks.length,\n dispose(): void {\n if (isDisposed) {\n return;\n }\n isDisposed = true;\n const list = frameGraphTasks(scene);\n for (const task of tasks) {\n // Disable first: a disposed task that still executes is a use-after-free.\n task.executionEnabled = false;\n const index = list?.indexOf(task) ?? -1;\n if (list !== null && index >= 0) {\n list.splice(index, 1);\n }\n task.dispose();\n }\n for (const scratch of scratches) {\n disposeRenderTarget(scratch);\n }\n },\n };\n}\n\n/**\n * Picks where the next scene-colour pass writes: back into the scene target when that is allowed\n * and the pass does not read it, otherwise the scratch target the pass does not read.\n *\n * @param source - What the pass reads.\n * @param sceneTarget - The scene's colour target.\n * @param isTargetWritable - Whether a pass may write `sceneTarget` (`ScenePass.isTargetWritable` in `./render-path.ts`).\n * @param scratches - The scratch targets made so far; a new one is appended when needed.\n * @param createScratch - Makes the scratch target at an index, 0 or 1.\n * @returns The target, never `source`.\n *\n * @internal\n */\nexport function sceneColorPassTarget<T>(\n source: T,\n sceneTarget: T,\n isTargetWritable: boolean,\n scratches: T[],\n createScratch: (index: number) => T,\n): T {\n if (source !== sceneTarget && isTargetWritable) {\n return sceneTarget;\n }\n const index = source === scratches[0] ? 1 : 0;\n let scratch = scratches[index];\n if (scratch === undefined) {\n scratch = createScratch(index);\n scratches[index] = scratch;\n }\n return scratch;\n}\n"],"mappings":";;;;;;;;;;;;;;;AAwEA,SAAgB,wBACd,QACA,OACA,WACA,QACA,mBAC2B;CAC3B,MAAM,EAAE,MAAM,WAAW,QAAQ,aAAa,QAAQ,qBAAqB,UAAU;CACrF,MAAM,YAA4B,CAAC;CACnC,MAAM,QAAgB,CAAC;CACvB,IAAI,SAAS;CACb,KAAK,MAAM,QAAQ,QAAQ;EACzB,MAAM,SAAS,qBAAqB,QAAQ,aAAa,kBAAkB,YAAY,UACrF,mBAAmB;GACjB,KAAK,UAAU,IAAI,+BAA+B;GAClD;GACA,SAAS;GACT,MAAM;EACR,CAAC,CACH;EACA,MAAM,KAAK,KAAK,OAAO,QAAQ,MAAM,CAAC;EACtC,SAAS;CACX;CACA,IAAI,WAAW,aACb,MAAM,KACJ,wBACE;EAAE,MAAM;EAA2B,eAAe;EAAQ,eAAe;CAAY,GACrF,QACA,KACF,CACF;CAEF,IAAI,QAAQ;CACZ,KAAK,MAAM,QAAQ,OAAO;EACxB,aAAa,OAAO,MAAM,KAAK;EAC/B,QAAQ;CACV;CACA,IAAI,mBAAmB;EACrB,MAAM,QAAQ,cAAc,KAAK;EACjC,KAAK,MAAM,QAAQ,OACjB,oBAAoB,OAAO,IAAI;CAEnC;CACA,IAAI,aAAa;CACjB,OAAO;EACL,WAAW,MAAM;EACjB,UAAgB;GACd,IAAI,YACF;GAEF,aAAa;GACb,MAAM,OAAO,gBAAgB,KAAK;GAClC,KAAK,MAAM,QAAQ,OAAO;IAExB,KAAK,mBAAmB;IACxB,MAAM,QAAQ,MAAM,QAAQ,IAAI,KAAK;IACrC,IAAI,SAAS,QAAQ,SAAS,GAC5B,KAAK,OAAO,OAAO,CAAC;IAEtB,KAAK,QAAQ;GACf;GACA,KAAK,MAAM,WAAW,WACpB,oBAAoB,OAAO;EAE/B;CACF;AACF;;;;;;;;;;;;;;AAeA,SAAgB,qBACd,QACA,aACA,kBACA,WACA,eACG;CACH,IAAI,WAAW,eAAe,kBAC5B,OAAO;CAET,MAAM,QAAQ,WAAW,UAAU,KAAK,IAAI;CAC5C,IAAI,UAAU,UAAU;CACxB,IAAI,YAAY,KAAA,GAAW;EACzB,UAAU,cAAc,KAAK;EAC7B,UAAU,SAAS;CACrB;CACA,OAAO;AACT"}
|
|
@@ -1,11 +1,11 @@
|
|
|
1
1
|
import { GeometryTextureType, addTaskAfter, addTaskAtStart, buildFrameGraphTask, createCopyToTextureTask, createDepthPyramid, createDepthPyramidTask, createGeometryRendererTask, createSurfaceRenderTargetTexture, disposeRenderTargetTexture, getFrameGraph, onRenderTargetTextureResize, withSampledDepthTexture } from "@babylonjs/lite";
|
|
2
2
|
//#region src/lite/gpu/scene-inputs.ts
|
|
3
3
|
/**
|
|
4
|
-
* Shared scene inputs (`docs/
|
|
5
|
-
*
|
|
6
|
-
*
|
|
7
|
-
*
|
|
8
|
-
*
|
|
4
|
+
* Shared scene inputs (`docs/architecture/07-rendering.md` §2.12): one geometry pass that
|
|
5
|
+
* screen-space effects (TAA, GTAO, contact shadows, SSGI) read instead of each drawing the scene
|
|
6
|
+
* again. Its own chunk: the renderer imports it only when an effect asks for it, so a project with
|
|
7
|
+
* no such effect loads none of it and its frame graph has none of these tasks (`CONSTITUTION.md`
|
|
8
|
+
* §2.5).
|
|
9
9
|
*
|
|
10
10
|
* ```text
|
|
11
11
|
* [shadow] → geometry ─→ normals copy ─→ velocity copy ─→ depth pyramid → scene → …
|
|
@@ -15,11 +15,12 @@ import { GeometryTextureType, addTaskAfter, addTaskAtStart, buildFrameGraphTask,
|
|
|
15
15
|
* ```
|
|
16
16
|
*
|
|
17
17
|
* - **Depth** is a surface-sized `depth32float` target with a sampled facade
|
|
18
|
-
* (`withSampledDepthTexture`) handed to the geometry task as its depth
|
|
18
|
+
* (`withSampledDepthTexture`) handed to the geometry task as its depth. Reverse-Z: 0 is
|
|
19
19
|
* the far plane. `depth24plus-stencil8`, the main pass's format, cannot be bound in compute.
|
|
20
20
|
* - **Normals and velocity** are geometry attachments, which Lite exposes only as task-owned
|
|
21
21
|
* `RenderTarget`s; compute and effect bindings take a `Texture2D`, so each is copied into a target
|
|
22
|
-
* that has one (
|
|
22
|
+
* that has one (`docs/architecture/07-rendering.md` §8, upstream ask "geometry attachments as
|
|
23
|
+
* `Texture2D`").
|
|
23
24
|
* - **The depth pyramid** is Lite's `createDepthPyramid`: an `r32float` mip chain where each level
|
|
24
25
|
* keeps the `max` (in reverse-Z, the nearest surface) of its four children.
|
|
25
26
|
* - **Ref-counted.** {@link SceneInputsHost.acquire} adds the tasks for the first user;
|
|
@@ -315,4 +316,4 @@ function requireAttachment(target, what) {
|
|
|
315
316
|
//#endregion
|
|
316
317
|
export { SCENE_INPUT_TASK_NAMES, createSceneInputsHost, frameGraphTasks };
|
|
317
318
|
|
|
318
|
-
//# sourceMappingURL=scene-inputs-
|
|
319
|
+
//# sourceMappingURL=scene-inputs-_0j2Hi6L.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"scene-inputs-_0j2Hi6L.js","names":[],"sources":["../src/lite/gpu/scene-inputs.ts"],"sourcesContent":["import {\n addTaskAfter,\n addTaskAtStart,\n buildFrameGraphTask,\n createCopyToTextureTask,\n createDepthPyramid,\n createDepthPyramidTask,\n createGeometryRendererTask,\n createSurfaceRenderTargetTexture,\n disposeRenderTargetTexture,\n GeometryTextureType,\n getFrameGraph,\n onRenderTargetTextureResize,\n withSampledDepthTexture,\n} from \"@babylonjs/lite\";\nimport type {\n DepthPyramid,\n EngineContext,\n RenderTarget,\n RenderTargetTextureResult,\n SceneContext,\n Task,\n Texture2D,\n} from \"@babylonjs/lite\";\n\n/**\n * Shared scene inputs (`docs/architecture/07-rendering.md` §2.12): one geometry pass that\n * screen-space effects (TAA, GTAO, contact shadows, SSGI) read instead of each drawing the scene\n * again. Its own chunk: the renderer imports it only when an effect asks for it, so a project with\n * no such effect loads none of it and its frame graph has none of these tasks (`CONSTITUTION.md`\n * §2.5).\n *\n * ```text\n * [shadow] → geometry ─→ normals copy ─→ velocity copy ─→ depth pyramid → scene → …\n * ├ depth (depth32float, sampled)\n * ├ world normal ─(copy)─→ normals\n * └ velocity ─(copy)─→ velocity\n * ```\n *\n * - **Depth** is a surface-sized `depth32float` target with a sampled facade\n * (`withSampledDepthTexture`) handed to the geometry task as its depth. Reverse-Z: 0 is\n * the far plane. `depth24plus-stencil8`, the main pass's format, cannot be bound in compute.\n * - **Normals and velocity** are geometry attachments, which Lite exposes only as task-owned\n * `RenderTarget`s; compute and effect bindings take a `Texture2D`, so each is copied into a target\n * that has one (`docs/architecture/07-rendering.md` §8, upstream ask \"geometry attachments as\n * `Texture2D`\").\n * - **The depth pyramid** is Lite's `createDepthPyramid`: an `r32float` mip chain where each level\n * keeps the `max` (in reverse-Z, the nearest surface) of its four children.\n * - **Ref-counted.** {@link SceneInputsHost.acquire} adds the tasks for the first user;\n * {@link SceneInputs.release} by the last one removes and disposes them.\n * - **Resize and device loss.** The targets are sized by the surface, so `frameGraph.build()`\n * reallocates them, on a resize and on a recovered device alike. The depth target's resize\n * callback rebuilds the pyramid (its pipelines belong to one device) and tells every user through\n * {@link SceneInputs.onChange}, so they can rebind.\n */\n\n/**\n * The frame-graph task names, in the order they run.\n *\n * @internal\n */\nexport const SCENE_INPUT_TASK_NAMES = {\n geometry: \"ignifx:scene-inputs\",\n normals: \"ignifx:scene-inputs-normals\",\n velocity: \"ignifx:scene-inputs-velocity\",\n depthPyramid: \"ignifx:scene-inputs-depth-pyramid\",\n} as const;\n\n/**\n * The texture format of each input.\n *\n * @internal\n */\nexport const SCENE_INPUT_FORMATS: {\n readonly depth: \"depth32float\";\n readonly normals: \"rgba16float\";\n readonly velocity: \"rgba16float\";\n readonly depthPyramid: \"r32float\";\n} = { depth: \"depth32float\", normals: \"rgba16float\", velocity: \"rgba16float\", depthPyramid: \"r32float\" };\n\n/**\n * One user's lease on the shared scene inputs.\n *\n * @remarks\n * Every texture is sized like the surface (backing-store pixels) and holds this frame's values for\n * any task that runs after the inputs' tasks, which sit at the start of the frame graph. A resize or\n * a recovered device swaps the GPU textures behind the same objects; bind groups that captured a\n * view must be rebuilt in {@link SceneInputs.onChange}.\n *\n * @internal\n */\nexport interface SceneInputs {\n /** Scene depth, `depth32float`, reverse-Z (1 near, 0 far). Bind with `sampleType: \"depth\"`. */\n readonly depth: Texture2D;\n /**\n * The same depth as the single-sample `RenderTarget` it lives in, for Lite tasks that take a\n * `depthTexture` target (contact shadows, SSGI).\n */\n readonly depthTarget: RenderTarget;\n /** World-space normals, `rgba16float`, stored as `n * 0.5 + 0.5`; 0 where nothing was drawn. */\n readonly normals: Texture2D;\n /**\n * Screen-space motion, `rgba16float`: `xy = 0.5 * (previousNdc - currentNdc)`, so UV units with Y\n * up, pointing from where a pixel is now to where it was last frame; 0 where nothing was drawn.\n * Camera motion always counts. Object motion counts for Standard materials only: Lite 1.34's PBR\n * geometry view reprojects the current world position (`pbr-geometry-output-shader.js` line 41),\n * so a moving PBR mesh under a still camera reads 0.\n */\n readonly velocity: Texture2D;\n /**\n * The depth pyramid, `r32float`, every mip level; level `n` is the `max` of its four children in\n * level `n - 1`. Read with `textureLoad(tex, coord, mip)`. A resize or recovered device replaces\n * this object, so read it again after {@link SceneInputs.onChange}.\n */\n readonly depthPyramid: Texture2D;\n /** How many mip levels {@link SceneInputs.depthPyramid} has. */\n readonly depthPyramidMipCount: number;\n /** `true` once {@link SceneInputs.release} ran. */\n readonly isReleased: boolean;\n /**\n * Registers a callback for when the textures were reallocated (resize, recovered device).\n *\n * @param callback - Runs during the frame graph rebuild, before the next frame is recorded.\n * @returns A function that unregisters it.\n */\n onChange(callback: () => void): () => void;\n /** Ends this lease. The last release removes and disposes the tasks and targets. Idempotent. */\n release(): void;\n}\n\n/**\n * The per-scene owner of the shared inputs: one per renderer.\n *\n * @internal\n */\nexport interface SceneInputsHost {\n /**\n * Leases the inputs, creating the geometry pass for the first user.\n *\n * @param isFrameGraphBuilt - Whether the scene is registered, so new tasks must be recorded now;\n * before registration `registerScene` records them.\n * @returns A lease; call its `release()` when done. `null` once the host is disposed.\n */\n acquire(isFrameGraphBuilt: boolean): SceneInputs | null;\n /** How many leases are live. */\n readonly userCount: number;\n /** Ends every lease and frees everything. Idempotent. */\n dispose(): void;\n}\n\n/** What the first acquire builds and the last release frees. */\ninterface SharedInputs {\n readonly depth: RenderTargetTextureResult;\n readonly normals: RenderTargetTextureResult;\n readonly velocity: RenderTargetTextureResult;\n readonly tasks: readonly Task[];\n readonly pyramid: { current: DepthPyramid };\n readonly listeners: Set<() => void>;\n readonly stopResizeWatch: () => void;\n}\n\n/**\n * Creates the scene-inputs owner for one scene. It adds nothing to the frame graph until the first\n * {@link SceneInputsHost.acquire}.\n *\n * @param engine - The engine, which is also the primary surface.\n * @param scene - The render scene.\n * @returns The host.\n *\n * @internal\n */\nexport function createSceneInputsHost(engine: EngineContext, scene: SceneContext): SceneInputsHost {\n let shared: SharedInputs | null = null;\n const leases = new Set<SceneInputs>();\n let isDisposed = false;\n\n const releaseLease = (lease: SceneInputs): void => {\n if (!leases.delete(lease) || leases.size > 0 || shared === null) {\n return;\n }\n teardown(scene, shared);\n shared = null;\n };\n\n return {\n acquire(isFrameGraphBuilt: boolean): SceneInputs | null {\n if (isDisposed) {\n return null;\n }\n shared ??= buildSharedInputs(engine, scene, isFrameGraphBuilt);\n const inputs = shared;\n let isReleased = false;\n const own = new Set<() => void>();\n const lease: SceneInputs = {\n depth: requireDepthFacade(inputs.depth),\n depthTarget: inputs.depth.rt,\n normals: inputs.normals.texture,\n velocity: inputs.velocity.texture,\n get depthPyramid(): Texture2D {\n return inputs.pyramid.current.texture;\n },\n get depthPyramidMipCount(): number {\n return inputs.pyramid.current.mipCount;\n },\n get isReleased(): boolean {\n return isReleased;\n },\n onChange(callback: () => void): () => void {\n inputs.listeners.add(callback);\n own.add(callback);\n return (): void => {\n inputs.listeners.delete(callback);\n own.delete(callback);\n };\n },\n release(): void {\n if (isReleased) {\n return;\n }\n isReleased = true;\n for (const callback of own) {\n inputs.listeners.delete(callback);\n }\n own.clear();\n releaseLease(lease);\n },\n };\n leases.add(lease);\n return lease;\n },\n get userCount(): number {\n return leases.size;\n },\n dispose(): void {\n if (isDisposed) {\n return;\n }\n isDisposed = true;\n for (const lease of leases) {\n lease.release();\n }\n },\n };\n}\n\n/**\n * Builds the targets and tasks, and splices the tasks into the frame graph ahead of the scene pass.\n *\n * @param engine - The engine.\n * @param scene - The scene.\n * @param isFrameGraphBuilt - Whether each task must be recorded now.\n * @returns The shared state.\n */\nfunction buildSharedInputs(engine: EngineContext, scene: SceneContext, isFrameGraphBuilt: boolean): SharedInputs {\n const depth = createSurfaceRenderTargetTexture(\n engine,\n { lbl: \"ignifx:scene-inputs-depth\", dFormat: SCENE_INPUT_FORMATS.depth, samples: 1, size: engine },\n withSampledDepthTexture,\n );\n const normals = createSurfaceRenderTargetTexture(engine, {\n lbl: \"ignifx:scene-inputs-normals\",\n format: SCENE_INPUT_FORMATS.normals,\n samples: 1,\n size: engine,\n });\n const velocity = createSurfaceRenderTargetTexture(engine, {\n lbl: \"ignifx:scene-inputs-velocity\",\n format: SCENE_INPUT_FORMATS.velocity,\n samples: 1,\n size: engine,\n });\n const geometry = createGeometryRendererTask(\n {\n name: SCENE_INPUT_TASK_NAMES.geometry,\n size: engine,\n depthTexture: depth.rt,\n textureDescriptions: [\n { type: GeometryTextureType.WORLD_NORMAL, format: SCENE_INPUT_FORMATS.normals },\n { type: GeometryTextureType.LINEAR_VELOCITY, format: SCENE_INPUT_FORMATS.velocity },\n ],\n },\n engine,\n scene,\n );\n const copyNormals = createCopyToTextureTask(\n {\n name: SCENE_INPUT_TASK_NAMES.normals,\n sourceTexture: requireAttachment(geometry.geometryWorldNormalTexture, \"world normal\"),\n targetTexture: normals.rt,\n },\n engine,\n scene,\n );\n const copyVelocity = createCopyToTextureTask(\n {\n name: SCENE_INPUT_TASK_NAMES.velocity,\n sourceTexture: requireAttachment(geometry.geometryLinearVelocityTexture, \"linear velocity\"),\n targetTexture: velocity.rt,\n },\n engine,\n scene,\n );\n const depthFacade = requireDepthFacade(depth);\n const pyramid = { current: newPyramid(engine, depthFacade) };\n // The pyramid task adopts what it is given and disposes it with the graph; a forwarding object\n // lets the inner pyramid be replaced after a resize or a recovered device.\n const forward: DepthPyramid = {\n get texture(): Texture2D {\n return pyramid.current.texture;\n },\n get mipCount(): number {\n return pyramid.current.mipCount;\n },\n build(source: Texture2D, encoder?: GPUCommandEncoder): void {\n pyramid.current.build(source, encoder);\n },\n resize(width: number, height: number): void {\n pyramid.current.resize(width, height);\n },\n dispose(): void {\n pyramid.current.dispose();\n },\n };\n const buildPyramid = createDepthPyramidTask(engine, scene, { pyramid: forward, source: () => depthFacade });\n Reflect.set(buildPyramid, \"name\", SCENE_INPUT_TASK_NAMES.depthPyramid);\n\n const tasks: readonly Task[] = [geometry, copyNormals, copyVelocity, buildPyramid];\n addTaskAtStart(scene, geometry);\n addTaskAfter(scene, copyNormals, geometry);\n addTaskAfter(scene, copyVelocity, copyNormals);\n addTaskAfter(scene, buildPyramid, copyVelocity);\n if (isFrameGraphBuilt) {\n const graph = getFrameGraph(scene);\n for (const task of tasks) {\n buildFrameGraphTask(graph, task);\n }\n }\n\n const listeners = new Set<() => void>();\n const stopResizeWatch = onRenderTargetTextureResize(depth, () => {\n pyramid.current.dispose();\n pyramid.current = newPyramid(engine, depthFacade);\n for (const listener of listeners) {\n listener();\n }\n });\n return { depth, normals, velocity, tasks, pyramid, listeners, stopResizeWatch };\n}\n\n/**\n * Removes the tasks from the frame graph and frees every task and target.\n *\n * @param scene - The scene.\n * @param shared - What {@link buildSharedInputs} built.\n */\nfunction teardown(scene: SceneContext, shared: SharedInputs): void {\n shared.stopResizeWatch();\n shared.listeners.clear();\n for (const task of shared.tasks) {\n // Disable first: a disposed task that still executes is a use-after-free.\n task.executionEnabled = false;\n removeFrameGraphTask(scene, task);\n task.dispose();\n }\n disposeRenderTargetTexture(shared.depth);\n disposeRenderTargetTexture(shared.normals);\n disposeRenderTargetTexture(shared.velocity);\n}\n\n/**\n * Takes a task out of the scene's frame graph.\n *\n * @remarks\n * Lite 1.34 has no public remove (`index.d.ts` 206–217 add only), and a disposed task left in the\n * graph is recorded again by the next `frameGraph.build()` against freed targets. The task list is\n * the private `_tasks` array every `addTask*` splices (`lib/frame-graph/frame-graph-actions.js`).\n * If a later Lite renames it, the task stays in, disabled.\n *\n * @param scene - The scene.\n * @param task - The task to remove.\n */\nfunction removeFrameGraphTask(scene: SceneContext, task: Task): void {\n const tasks = frameGraphTasks(scene);\n const index = tasks?.indexOf(task) ?? -1;\n if (tasks !== null && index >= 0) {\n tasks.splice(index, 1);\n }\n}\n\n/**\n * The scene's frame-graph task list, or `null` when Lite no longer exposes it.\n *\n * @param scene - The scene.\n * @returns The live array (Lite's own), or `null`.\n *\n * @internal\n */\nexport function frameGraphTasks(scene: SceneContext): Task[] | null {\n const tasks: unknown = Reflect.get(getFrameGraph(scene), \"_tasks\");\n return isTaskList(tasks) ? tasks : null;\n}\n\n/**\n * Whether a value is Lite's task array.\n *\n * @param value - The value read from the frame graph.\n * @returns `true` for an array.\n */\nfunction isTaskList(value: unknown): value is Task[] {\n return Array.isArray(value);\n}\n\n/**\n * Creates a depth pyramid the size of the depth facade's current texture.\n *\n * @param engine - The engine, whose current device owns the pipelines.\n * @param depth - The depth facade.\n * @returns The pyramid.\n */\nfunction newPyramid(engine: EngineContext, depth: Texture2D): DepthPyramid {\n return createDepthPyramid(engine, { width: depth.width, height: depth.height, reduce: \"max\" });\n}\n\n/**\n * The sampled depth facade of the depth target.\n *\n * @param depth - The depth target, created with `withSampledDepthTexture`.\n * @returns The facade.\n */\nfunction requireDepthFacade(depth: RenderTargetTextureResult): Texture2D {\n if (depth.depthTexture === null) {\n throw new Error(\"Lite built the scene-inputs depth target without a sampled depth facade.\");\n }\n return depth.depthTexture;\n}\n\n/**\n * A geometry attachment the task was asked for.\n *\n * @param target - The accessor's value.\n * @param what - The attachment, for the error.\n * @returns The attachment.\n */\nfunction requireAttachment(target: RenderTarget | null, what: string): RenderTarget {\n if (target === null) {\n throw new Error(`Lite's geometry task built no ${what} attachment.`);\n }\n return target;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6DA,MAAa,yBAAyB;CACpC,UAAU;CACV,SAAS;CACT,UAAU;CACV,cAAc;AAChB;;;;;;AAOA,MAAa,sBAKT;CAAE,OAAO;CAAgB,SAAS;CAAe,UAAU;CAAe,cAAc;AAAW;;;;;;;;;;;AA6FvG,SAAgB,sBAAsB,QAAuB,OAAsC;CACjG,IAAI,SAA8B;CAClC,MAAM,yBAAS,IAAI,IAAiB;CACpC,IAAI,aAAa;CAEjB,MAAM,gBAAgB,UAA6B;EACjD,IAAI,CAAC,OAAO,OAAO,KAAK,KAAK,OAAO,OAAO,KAAK,WAAW,MACzD;EAEF,SAAS,OAAO,MAAM;EACtB,SAAS;CACX;CAEA,OAAO;EACL,QAAQ,mBAAgD;GACtD,IAAI,YACF,OAAO;GAET,WAAW,kBAAkB,QAAQ,OAAO,iBAAiB;GAC7D,MAAM,SAAS;GACf,IAAI,aAAa;GACjB,MAAM,sBAAM,IAAI,IAAgB;GAChC,MAAM,QAAqB;IACzB,OAAO,mBAAmB,OAAO,KAAK;IACtC,aAAa,OAAO,MAAM;IAC1B,SAAS,OAAO,QAAQ;IACxB,UAAU,OAAO,SAAS;IAC1B,IAAI,eAA0B;KAC5B,OAAO,OAAO,QAAQ,QAAQ;IAChC;IACA,IAAI,uBAA+B;KACjC,OAAO,OAAO,QAAQ,QAAQ;IAChC;IACA,IAAI,aAAsB;KACxB,OAAO;IACT;IACA,SAAS,UAAkC;KACzC,OAAO,UAAU,IAAI,QAAQ;KAC7B,IAAI,IAAI,QAAQ;KAChB,aAAmB;MACjB,OAAO,UAAU,OAAO,QAAQ;MAChC,IAAI,OAAO,QAAQ;KACrB;IACF;IACA,UAAgB;KACd,IAAI,YACF;KAEF,aAAa;KACb,KAAK,MAAM,YAAY,KACrB,OAAO,UAAU,OAAO,QAAQ;KAElC,IAAI,MAAM;KACV,aAAa,KAAK;IACpB;GACF;GACA,OAAO,IAAI,KAAK;GAChB,OAAO;EACT;EACA,IAAI,YAAoB;GACtB,OAAO,OAAO;EAChB;EACA,UAAgB;GACd,IAAI,YACF;GAEF,aAAa;GACb,KAAK,MAAM,SAAS,QAClB,MAAM,QAAQ;EAElB;CACF;AACF;;;;;;;;;AAUA,SAAS,kBAAkB,QAAuB,OAAqB,mBAA0C;CAC/G,MAAM,QAAQ,iCACZ,QACA;EAAE,KAAK;EAA6B,SAAS,oBAAoB;EAAO,SAAS;EAAG,MAAM;CAAO,GACjG,uBACF;CACA,MAAM,UAAU,iCAAiC,QAAQ;EACvD,KAAK;EACL,QAAQ,oBAAoB;EAC5B,SAAS;EACT,MAAM;CACR,CAAC;CACD,MAAM,WAAW,iCAAiC,QAAQ;EACxD,KAAK;EACL,QAAQ,oBAAoB;EAC5B,SAAS;EACT,MAAM;CACR,CAAC;CACD,MAAM,WAAW,2BACf;EACE,MAAM,uBAAuB;EAC7B,MAAM;EACN,cAAc,MAAM;EACpB,qBAAqB,CACnB;GAAE,MAAM,oBAAoB;GAAc,QAAQ,oBAAoB;EAAQ,GAC9E;GAAE,MAAM,oBAAoB;GAAiB,QAAQ,oBAAoB;EAAS,CACpF;CACF,GACA,QACA,KACF;CACA,MAAM,cAAc,wBAClB;EACE,MAAM,uBAAuB;EAC7B,eAAe,kBAAkB,SAAS,4BAA4B,cAAc;EACpF,eAAe,QAAQ;CACzB,GACA,QACA,KACF;CACA,MAAM,eAAe,wBACnB;EACE,MAAM,uBAAuB;EAC7B,eAAe,kBAAkB,SAAS,+BAA+B,iBAAiB;EAC1F,eAAe,SAAS;CAC1B,GACA,QACA,KACF;CACA,MAAM,cAAc,mBAAmB,KAAK;CAC5C,MAAM,UAAU,EAAE,SAAS,WAAW,QAAQ,WAAW,EAAE;CAoB3D,MAAM,eAAe,uBAAuB,QAAQ,OAAO;EAAE,SAAS;GAhBpE,IAAI,UAAqB;IACvB,OAAO,QAAQ,QAAQ;GACzB;GACA,IAAI,WAAmB;IACrB,OAAO,QAAQ,QAAQ;GACzB;GACA,MAAM,QAAmB,SAAmC;IAC1D,QAAQ,QAAQ,MAAM,QAAQ,OAAO;GACvC;GACA,OAAO,OAAe,QAAsB;IAC1C,QAAQ,QAAQ,OAAO,OAAO,MAAM;GACtC;GACA,UAAgB;IACd,QAAQ,QAAQ,QAAQ;GAC1B;EAE0E;EAAG,cAAc;CAAY,CAAC;CAC1G,QAAQ,IAAI,cAAc,QAAQ,uBAAuB,YAAY;CAErE,MAAM,QAAyB;EAAC;EAAU;EAAa;EAAc;CAAY;CACjF,eAAe,OAAO,QAAQ;CAC9B,aAAa,OAAO,aAAa,QAAQ;CACzC,aAAa,OAAO,cAAc,WAAW;CAC7C,aAAa,OAAO,cAAc,YAAY;CAC9C,IAAI,mBAAmB;EACrB,MAAM,QAAQ,cAAc,KAAK;EACjC,KAAK,MAAM,QAAQ,OACjB,oBAAoB,OAAO,IAAI;CAEnC;CAEA,MAAM,4BAAY,IAAI,IAAgB;CAQtC,OAAO;EAAE;EAAO;EAAS;EAAU;EAAO;EAAS;EAAW,iBAPtC,4BAA4B,aAAa;GAC/D,QAAQ,QAAQ,QAAQ;GACxB,QAAQ,UAAU,WAAW,QAAQ,WAAW;GAChD,KAAK,MAAM,YAAY,WACrB,SAAS;EAEb,CAC4E;CAAE;AAChF;;;;;;;AAQA,SAAS,SAAS,OAAqB,QAA4B;CACjE,OAAO,gBAAgB;CACvB,OAAO,UAAU,MAAM;CACvB,KAAK,MAAM,QAAQ,OAAO,OAAO;EAE/B,KAAK,mBAAmB;EACxB,qBAAqB,OAAO,IAAI;EAChC,KAAK,QAAQ;CACf;CACA,2BAA2B,OAAO,KAAK;CACvC,2BAA2B,OAAO,OAAO;CACzC,2BAA2B,OAAO,QAAQ;AAC5C;;;;;;;;;;;;;AAcA,SAAS,qBAAqB,OAAqB,MAAkB;CACnE,MAAM,QAAQ,gBAAgB,KAAK;CACnC,MAAM,QAAQ,OAAO,QAAQ,IAAI,KAAK;CACtC,IAAI,UAAU,QAAQ,SAAS,GAC7B,MAAM,OAAO,OAAO,CAAC;AAEzB;;;;;;;;;AAUA,SAAgB,gBAAgB,OAAoC;CAClE,MAAM,QAAiB,QAAQ,IAAI,cAAc,KAAK,GAAG,QAAQ;CACjE,OAAO,WAAW,KAAK,IAAI,QAAQ;AACrC;;;;;;;AAQA,SAAS,WAAW,OAAiC;CACnD,OAAO,MAAM,QAAQ,KAAK;AAC5B;;;;;;;;AASA,SAAS,WAAW,QAAuB,OAAgC;CACzE,OAAO,mBAAmB,QAAQ;EAAE,OAAO,MAAM;EAAO,QAAQ,MAAM;EAAQ,QAAQ;CAAM,CAAC;AAC/F;;;;;;;AAQA,SAAS,mBAAmB,OAA6C;CACvE,IAAI,MAAM,iBAAiB,MACzB,MAAM,IAAI,MAAM,0EAA0E;CAE5F,OAAO,MAAM;AACf;;;;;;;;AASA,SAAS,kBAAkB,QAA6B,MAA4B;CAClF,IAAI,WAAW,MACb,MAAM,IAAI,MAAM,iCAAiC,KAAK,aAAa;CAErE,OAAO;AACT"}
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
/**
|
|
3
3
|
* The vocabulary a `// @ignifx` pragma declares: the three authoring forms, the WGSL types and
|
|
4
4
|
* attribute names Babylon Lite accepts, the uniforms ignifx supplies, and the parsed declaration
|
|
5
|
-
* itself (
|
|
5
|
+
* itself (ADR-0024).
|
|
6
6
|
*
|
|
7
7
|
* Split from `./shader-pragma.ts` so these few hundred bytes can stay in the barrel while the parser
|
|
8
8
|
* lives in a chunk only the `.wgsl` loader fetches (`./shader-support.ts`).
|
|
@@ -74,8 +74,8 @@ const LITE_SYSTEM_UNIFORM_NAMES = [
|
|
|
74
74
|
];
|
|
75
75
|
/**
|
|
76
76
|
* The uniforms **ignifx** fills in every frame, read in WGSL as `shaderUniforms.<name>`
|
|
77
|
-
* (
|
|
78
|
-
*
|
|
77
|
+
* (ADR-0024). Babylon Lite has no clock and no light bindings for a shader material, so these are
|
|
78
|
+
* the engine's own addition.
|
|
79
79
|
*
|
|
80
80
|
* @public
|
|
81
81
|
*/
|
|
@@ -162,4 +162,4 @@ const SURFACE_UNIFORM_BLOCK = "surfaceUniforms";
|
|
|
162
162
|
//#endregion
|
|
163
163
|
export { SHADER_BLEND_MODES as a, SHADER_KINDS as c, SURFACE_HOOK_NAMES as d, SURFACE_UNIFORM_BLOCK as f, SHADER_ATTRIBUTE_NAMES as i, SHADER_TEXTURE_FALLBACKS as l, IGNIFX_UNIFORM_TYPES as n, SHADER_CULL_MODES as o, LITE_SYSTEM_UNIFORM_NAMES as r, SHADER_INSTANCING_MODES as s, IGNIFX_UNIFORM_NAMES as t, SHADER_UNIFORM_TYPES as u };
|
|
164
164
|
|
|
165
|
-
//# sourceMappingURL=shader-declaration-
|
|
165
|
+
//# sourceMappingURL=shader-declaration-BGprFBLq.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"shader-declaration-BGprFBLq.js","names":[],"sources":["../src/render/shader-declaration.ts"],"sourcesContent":["/**\n * The vocabulary a `// @ignifx` pragma declares: the three authoring forms, the WGSL types and\n * attribute names Babylon Lite accepts, the uniforms ignifx supplies, and the parsed declaration\n * itself (ADR-0024).\n *\n * Split from `./shader-pragma.ts` so these few hundred bytes can stay in the barrel while the parser\n * lives in a chunk only the `.wgsl` loader fetches (`./shader-support.ts`).\n */\n\n/**\n * The three authoring forms the form directive names, in the order the documentation lists them.\n *\n * @public\n */\nexport const SHADER_KINDS = [\"shader\", \"surface\", \"post\"] as const;\n\n/**\n * Which of the three authoring forms a `.wgsl` file is: a full custom material, a surface shader\n * that hooks into the engine's lit materials, or a full-screen post effect.\n *\n * @public\n */\nexport type ShaderKind = (typeof SHADER_KINDS)[number];\n\n/**\n * The WGSL types a declared uniform may have — Babylon Lite's set (`index.d.ts` 11445).\n *\n * @public\n */\nexport const SHADER_UNIFORM_TYPES = [\n \"f32\",\n \"u32\",\n \"i32\",\n \"vec2<f32>\",\n \"vec3<f32>\",\n \"vec4<f32>\",\n \"mat4x4<f32>\",\n] as const;\n\n/**\n * The union of the uniform types a declaration may name.\n *\n * @public\n */\nexport type ShaderUniformType = (typeof SHADER_UNIFORM_TYPES)[number];\n\n/**\n * The vertex attributes a shader material can bind — Babylon Lite's fixed set\n * (`index.d.ts` 11295). A name outside this list is reported with its line.\n *\n * @public\n */\nexport const SHADER_ATTRIBUTE_NAMES = [\n \"position\",\n \"normal\",\n \"uv\",\n \"uv2\",\n \"tangent\",\n \"color\",\n \"joints\",\n \"weights\",\n \"joints1\",\n \"weights1\",\n] as const;\n\n/**\n * The union of the attribute names a declaration may name.\n *\n * @public\n */\nexport type ShaderAttributeName = (typeof SHADER_ATTRIBUTE_NAMES)[number];\n\n/**\n * The uniforms Babylon Lite fills in itself every frame, read in WGSL as `shaderSystem.<name>`\n * (`index.d.ts` 11432).\n *\n * @remarks\n * Two of them lie under `rendering.useFloatingOrigin`: `cameraPosition` reads `(0, 0, 0)` and the\n * world matrices are camera-relative. With instancing on, `world`, `worldView`, and\n * `worldViewProjection` are **not** instance-aware — the shader composes\n * `shaderSystem.world * mat4x4(input.world0, input.world1, input.world2, input.world3)`.\n *\n * @public\n */\nexport const LITE_SYSTEM_UNIFORM_NAMES = [\n \"world\",\n \"view\",\n \"projection\",\n \"viewProjection\",\n \"worldView\",\n \"worldViewProjection\",\n \"cameraPosition\",\n \"screenSize\",\n \"alphaCutoff\",\n] as const;\n\n/**\n * The union of the Babylon Lite system uniform names.\n *\n * @public\n */\nexport type LiteSystemUniformName = (typeof LITE_SYSTEM_UNIFORM_NAMES)[number];\n\n/**\n * The uniforms **ignifx** fills in every frame, read in WGSL as `shaderUniforms.<name>`\n * (ADR-0024). Babylon Lite has no clock and no light bindings for a shader material, so these are\n * the engine's own addition.\n *\n * @public\n */\nexport const IGNIFX_UNIFORM_NAMES = [\n \"time\",\n \"unscaledTime\",\n \"deltaTime\",\n \"mainLightDirection\",\n \"mainLightColor\",\n \"ambientColor\",\n] as const;\n\n/**\n * The union of the ignifx-provided uniform names.\n *\n * @public\n */\nexport type IgnifxUniformName = (typeof IGNIFX_UNIFORM_NAMES)[number];\n\n/**\n * The WGSL type of each ignifx-provided uniform, which is what the custom uniform block is laid out\n * from.\n *\n * @internal\n */\nexport const IGNIFX_UNIFORM_TYPES: Readonly<Record<IgnifxUniformName, ShaderUniformType>> = Object.freeze({\n time: \"f32\",\n unscaledTime: \"f32\",\n deltaTime: \"f32\",\n mainLightDirection: \"vec3<f32>\",\n mainLightColor: \"vec3<f32>\",\n ambientColor: \"vec3<f32>\",\n});\n\n/**\n * The 1x1 fallback textures a declaration can bind when nothing else is.\n *\n * @public\n */\nexport const SHADER_TEXTURE_FALLBACKS = [\"white\", \"black\", \"transparent\"] as const;\n\n/**\n * Which 1x1 texture is bound to a declared sampler that nothing has filled in\n * (Godot's `hint_default_*`).\n *\n * @public\n */\nexport type ShaderTextureFallback = (typeof SHADER_TEXTURE_FALLBACKS)[number];\n\n/**\n * How a shader material composites its fragments.\n *\n * @public\n */\nexport const SHADER_BLEND_MODES = [\"opaque\", \"alpha\", \"additive\", \"premultiplied\"] as const;\n\n/**\n * The blend modes a declaration may ask for.\n *\n * @public\n */\nexport type ShaderBlendMode = (typeof SHADER_BLEND_MODES)[number];\n\n/**\n * Which faces are drawn. `\"front\"` is accepted by the grammar and refused by the parser, because\n * Babylon Lite 1.27.0 exposes only `backFaceCulling`.\n *\n * @public\n */\nexport const SHADER_CULL_MODES = [\"back\", \"front\", \"none\"] as const;\n\n/**\n * The face-culling modes a declaration may ask for. `\"front\"` is refused: Babylon Lite 1.27.0\n * exposes only `backFaceCulling`.\n *\n * @public\n */\nexport type ShaderCullMode = (typeof SHADER_CULL_MODES)[number];\n\n/**\n * Which instance streams the vertex stage reads.\n *\n * @public\n */\nexport const SHADER_INSTANCING_MODES = [\"none\", \"matrices\", \"matrices-colors\"] as const;\n\n/**\n * How a declaration expects to be drawn: one mesh at a time, or thin-instanced with a matrix slab\n * and optionally a per-instance colour.\n *\n * @public\n */\nexport type ShaderInstancingMode = (typeof SHADER_INSTANCING_MODES)[number];\n\n/**\n * One `// @ignifx uniform …` line: a value a material sets and the vertex or fragment stage reads\n * as `shaderUniforms.<name>`.\n *\n * @public\n */\nexport interface ShaderUniformDeclaration {\n /** The WGSL identifier. */\n readonly name: string;\n /** The WGSL type. */\n readonly type: ShaderUniformType;\n /**\n * The value a material starts with. A colour default is the **sRGB** value the file wrote; the\n * material layer decodes it to linear on the way to the GPU.\n */\n readonly defaultValue: number | readonly number[];\n /** Whether the value is a colour, declared with `color(…)` or the bare `color` modifier. */\n readonly color: boolean;\n /** The inclusive slider bounds an inspector should offer, or `null`. */\n readonly range: readonly [number, number] | null;\n /** The slider increment an inspector should use, or `null`. */\n readonly step: number | null;\n /** One sentence describing the uniform, or `null`. */\n readonly tooltip: string | null;\n}\n\n/**\n * One `// @ignifx texture …` line: a `texture_2d<f32>` (or `texture_2d_array<f32>`) plus the\n * `<name>Sampler` Babylon Lite generates beside it.\n *\n * @public\n */\nexport interface ShaderTextureDeclaration {\n /** The WGSL identifier; the sampler is `<name>Sampler`. */\n readonly name: string;\n /** Whether the texture holds sRGB-encoded colour, which the texture import needs to know. */\n readonly srgb: boolean;\n /** Whether the texture is a tangent-space normal map. */\n readonly normal: boolean;\n /**\n * Which 1x1 texture is bound when a material binds nothing, or `null` for the implicit `\"white\"`.\n *\n * @remarks\n * A declared sampler that nothing fills in cannot be left unbound: Babylon Lite refuses to build\n * a bind group for it (error 309), so *something* is always bound.\n */\n readonly fallback: ShaderTextureFallback | null;\n /** Whether the binding is a `texture_2d_array<f32>` rather than a `texture_2d<f32>`. */\n readonly array: boolean;\n}\n\n/**\n * One `// @ignifx storage …` line: a read-only storage buffer the shader indexes.\n *\n * @public\n */\nexport interface ShaderStorageDeclaration {\n /** The WGSL identifier. */\n readonly name: string;\n /** The WGSL variable type, verbatim, for example `array<Particle>`. */\n readonly type: string;\n}\n\n/**\n * One `// @ignifx define …` line: a WGSL `const` a material may override.\n *\n * @public\n */\nexport interface ShaderDefineDeclaration {\n /** The WGSL identifier. */\n readonly name: string;\n /** The value; a boolean compiles to `bool`, a number to `f32`. */\n readonly value: boolean | number;\n}\n\n/**\n * The three hooks a `.surface.wgsl` file may provide.\n *\n * @public\n */\nexport const SURFACE_HOOK_NAMES = [\"displace\", \"surface\", \"composite\"] as const;\n\n/**\n * One of the three surface-shader hooks.\n *\n * @public\n */\nexport type SurfaceHookName = (typeof SURFACE_HOOK_NAMES)[number];\n\n/**\n * The uniform block name a surface shader reads its declared uniforms from.\n *\n * @public\n */\nexport const SURFACE_UNIFORM_BLOCK = \"surfaceUniforms\";\n\n/**\n * The pipeline state a `// @ignifx blend …` line declares.\n *\n * @public\n */\nexport interface ShaderPipelineState {\n /** How fragments are composited. */\n readonly blend: ShaderBlendMode;\n /** Which faces are drawn. */\n readonly cull: ShaderCullMode;\n /**\n * Whether the draw writes depth. Defaults to `true` for an opaque surface and `false` for a\n * blended one — Babylon Lite's own rule — unless the file says `depthWrite on` explicitly.\n */\n readonly depthWrite: boolean;\n /** Whether the draw depth-tests at all; `false` compiles `depthCompare: \"always\"`. */\n readonly depthTest: boolean;\n /** Whether the surface samples the opaque scene colour behind it. Requires a blended surface. */\n readonly transmissive: boolean;\n /** Which instance streams the vertex stage reads. */\n readonly instancing: ShaderInstancingMode;\n}\n\n/**\n * Everything a `.wgsl` file declares about itself — the parsed pragmas, with defaults filled in.\n *\n * @public\n */\nexport interface ShaderDeclaration {\n /** Which of the three authoring forms the file is. */\n readonly kind: ShaderKind;\n /** The vertex attributes the vertex stage reads. A `\"shader\"` file always includes `position`. */\n readonly attributes: readonly ShaderAttributeName[];\n /** The Babylon Lite system uniforms, read as `shaderSystem.<name>`. */\n readonly system: readonly LiteSystemUniformName[];\n /** The ignifx-provided uniforms, read as `shaderUniforms.<name>` and written every frame. */\n readonly ignifx: readonly IgnifxUniformName[];\n /** The custom uniforms, read as `shaderUniforms.<name>`. */\n readonly uniforms: readonly ShaderUniformDeclaration[];\n /** The samplers, each generating `<name>` and `<name>Sampler`. */\n readonly textures: readonly ShaderTextureDeclaration[];\n /** The read-only storage buffers. */\n readonly storage: readonly ShaderStorageDeclaration[];\n /** The WGSL `const` declarations a material may override. */\n readonly defines: readonly ShaderDefineDeclaration[];\n /** The pipeline state. */\n readonly pipeline: ShaderPipelineState;\n /**\n * The furthest, in world metres, the vertex stage moves a vertex from where the mesh puts it: the\n * `// @ignifx displace <metres>` line, or `0` when the file has none. Every mesh drawn with the\n * material gets bounds this much larger, so a directional shadow map and GPU instance culling\n * still cover the moved shape.\n */\n readonly displace: number;\n}\n"],"mappings":";;;;;;;;;;;;;;AAcA,MAAa,eAAe;CAAC;CAAU;CAAW;AAAM;;;;;;AAexD,MAAa,uBAAuB;CAClC;CACA;CACA;CACA;CACA;CACA;CACA;AACF;;;;;;;AAeA,MAAa,yBAAyB;CACpC;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF;;;;;;;;;;;;;AAqBA,MAAa,4BAA4B;CACvC;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF;;;;;;;;AAgBA,MAAa,uBAAuB;CAClC;CACA;CACA;CACA;CACA;CACA;AACF;;;;;;;AAeA,MAAa,uBAA+E,OAAO,OAAO;CACxG,MAAM;CACN,cAAc;CACd,WAAW;CACX,oBAAoB;CACpB,gBAAgB;CAChB,cAAc;AAChB,CAAC;;;;;;AAOD,MAAa,2BAA2B;CAAC;CAAS;CAAS;AAAa;;;;;;AAexE,MAAa,qBAAqB;CAAC;CAAU;CAAS;CAAY;AAAe;;;;;;;AAejF,MAAa,oBAAoB;CAAC;CAAQ;CAAS;AAAM;;;;;;AAezD,MAAa,0BAA0B;CAAC;CAAQ;CAAY;AAAiB;;;;;;AA0F7E,MAAa,qBAAqB;CAAC;CAAY;CAAW;AAAW;;;;;;AAcrE,MAAa,wBAAwB"}
|
|
@@ -1,9 +1,9 @@
|
|
|
1
1
|
import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
|
|
2
2
|
import { o as CoreErrorCode, t as IgnifxError } from "./ignifx-error-DwIZKxA2.js";
|
|
3
|
-
import { I as setOwnJsonProperty } from "./prefab-overrides-
|
|
3
|
+
import { I as setOwnJsonProperty } from "./prefab-overrides-Bb7jVm7A.js";
|
|
4
4
|
import { t as Color } from "./color-DrR6GFTd.js";
|
|
5
|
-
import { r as isHdrScene } from "./render-path-
|
|
6
|
-
import { n as IGNIFX_UNIFORM_TYPES, r as LITE_SYSTEM_UNIFORM_NAMES, t as IGNIFX_UNIFORM_NAMES } from "./shader-declaration-
|
|
5
|
+
import { r as isHdrScene } from "./render-path-CWXHrRa2.js";
|
|
6
|
+
import { n as IGNIFX_UNIFORM_TYPES, r as LITE_SYSTEM_UNIFORM_NAMES, t as IGNIFX_UNIFORM_NAMES } from "./shader-declaration-BGprFBLq.js";
|
|
7
7
|
//#region src/render/shader-material.ts
|
|
8
8
|
var shader_material_exports = /* @__PURE__ */ __exportAll({
|
|
9
9
|
ShaderMaterialRegistry: () => ShaderMaterialRegistry,
|
|
@@ -15,8 +15,7 @@ var shader_material_exports = /* @__PURE__ */ __exportAll({
|
|
|
15
15
|
toShaderMaterialOptions: () => toShaderMaterialOptions
|
|
16
16
|
});
|
|
17
17
|
/**
|
|
18
|
-
* The `"shader"` material family (
|
|
19
|
-
* `ShaderAsset` plus the values a material sets on it.
|
|
18
|
+
* The `"shader"` material family (ADR-0024): a `ShaderAsset` plus the values a material sets on it.
|
|
20
19
|
*
|
|
21
20
|
* Nothing here imports Babylon Lite: {@link toShaderMaterialOptions} is the whole mapping onto the
|
|
22
21
|
* shape `createShaderMaterial` takes, as plain data, and the adapter itself arrives through
|
|
@@ -163,7 +162,7 @@ let adapter = null;
|
|
|
163
162
|
*/
|
|
164
163
|
async function loadShaderMaterialAdapter() {
|
|
165
164
|
if (adapter !== null) return;
|
|
166
|
-
const loaded = await import("./shader-material-
|
|
165
|
+
const loaded = await import("./shader-material-vmkJ25II.js");
|
|
167
166
|
loaded.enableShaderUniformCaching();
|
|
168
167
|
adapter = loaded;
|
|
169
168
|
}
|
|
@@ -888,8 +887,8 @@ function buildShaderMaterialState(app, shader, definition, textures) {
|
|
|
888
887
|
* Builds the Babylon Lite material a declaration describes, through the dynamically loaded adapter.
|
|
889
888
|
*
|
|
890
889
|
* @remarks
|
|
891
|
-
* Under `rendering.hdr` the fragment is wrapped to write linear colour
|
|
892
|
-
*
|
|
890
|
+
* Under `rendering.hdr` the fragment is wrapped to write linear colour, so the output pass does not
|
|
891
|
+
* encode it a second time.
|
|
893
892
|
*
|
|
894
893
|
* @param app - The app, whose scene says whether it renders through `rendering.hdr`.
|
|
895
894
|
* @param name - The material's name.
|
|
@@ -1010,4 +1009,4 @@ function shapeMismatch(declaration, material, expected, actual) {
|
|
|
1010
1009
|
//#endregion
|
|
1011
1010
|
export { shader_material_exports as n, shaderMaterialsOf as t };
|
|
1012
1011
|
|
|
1013
|
-
//# sourceMappingURL=shader-material-
|
|
1012
|
+
//# sourceMappingURL=shader-material-C9sYMGWw.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"shader-material-C9sYMGWw.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 (ADR-0024): a `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, so the output pass does not\n * 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,4 +1,4 @@
|
|
|
1
|
-
import { i as readSceneEnvironment } from "./environment-
|
|
1
|
+
import { i as readSceneEnvironment } from "./environment-7fJbN402.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. */
|
|
@@ -60,7 +60,7 @@ function createShaderMaterialFromOptions(options) {
|
|
|
60
60
|
const WRAPPED_FRAGMENT = "ignifxDisplayFragment";
|
|
61
61
|
/**
|
|
62
62
|
* Wraps a custom shader's `mainFragment` so that, under `rendering.hdr`, it writes linear colour
|
|
63
|
-
* (`docs/
|
|
63
|
+
* (`docs/architecture/07-rendering.md` §2.7).
|
|
64
64
|
*
|
|
65
65
|
* @remarks
|
|
66
66
|
* A custom shader writes the colour that is displayed: with HDR off it lands on the swapchain as
|
|
@@ -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-
|
|
305
|
+
//# sourceMappingURL=shader-material-vmkJ25II.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"shader-material-vmkJ25II.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 * (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/architecture/07-rendering.md` §2.7).\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":";;;;AAsDA,MAAM,kBAAuF,OAAO,OAAO;CACzG,OAAO;EAAC;EAAK;EAAK;EAAK;CAAG;CAC1B,OAAO;EAAC;EAAG;EAAG;EAAG;CAAG;CACpB,aAAa;EAAC;EAAG;EAAG;EAAG;CAAC;AAC1B,CAAC;;;;;;;;;;;;;;AAyGD,SAAgB,gCAAgC,SAAqD;CACnG,MAAM,gBAAgB,QAAQ,OAAO,MAAM,cAAc;CACzD,OAAO,qBAAqB;EAC1B,MAAM,QAAQ;EACd,cAAc,QAAQ;EACtB,gBACE,QAAQ,iBAAiB,OAAO,qBAAqB,QAAQ,QAAQ,aAAa,IAAI,QAAQ;EAChG,YAAY,QAAQ;EACpB,UAAU,QAAQ;EAClB,UAAU,QAAQ;EAClB,gBAAgB,QAAQ;EACxB,SAAS,QAAQ;EACjB,uBAAuB,QAAQ;EAC/B,mBAAmB,QAAQ;EAC3B,WAAW,QAAQ;EACnB,GAAI,QAAQ,UAAU,OAAO,CAAC,IAAI,EAAE,OAAO,QAAQ,MAAM;EACzD,cAAc,QAAQ;EACtB,iBAAiB,QAAQ;EACzB,YAAY,QAAQ;EACpB,GAAI,QAAQ,iBAAiB,OAAO,CAAC,IAAI,EAAE,cAAc,QAAQ,aAAa;CAChF,CAAC;AACH;;AAGA,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;AAqBzB,SAAgB,qBAAqB,QAAgB,eAAgC;CACnF,MAAM,QAAQ,sCAAsC,KAAK,MAAM;CAC/D,IAAI,UAAU,MACZ,OAAO;CAET,MAAM,OAAO,MAAM,QAAQ,MAAM,EAAE,CAAC,SAAS;CAC7C,MAAM,QAAQ,cAAc,QAAQ,IAAI;CACxC,IAAI,QAAQ,GACV,OAAO;CAET,MAAM,QAAQ,OAAO,MAAM,QAAQ,CAAC;CACpC,MAAM,SAAS,2DAA2D,KAAK,KAAK;CACpF,IAAI,WAAW,MACb,OAAO;CAET,MAAM,aAAa,OAAO,MAAM,OAAO,GAAG,KAAK;CAC/C,MAAM,QAAQ,eAAe,UAAU;CACvC,MAAM,SAAS,gBACX,wHACA;CACJ,OAAO;EAEL,GAAG,OAAO,MAAM,GAAG,MAAM,KAAK,EAAE,KAAK,iBAAiB,GAAG,gBAAgB,UAAU,EAAE,eAAe,MAAM,MAAM,OAAO,EAAE,CAAC,MAAM;EAChI,6BAA6B,WAAW;EACxC,SAAS,iBAAiB,GAAG,MAAM,KAAK,GAAG,EAAE;EAC7C,oBAAoB,OAAO;EAC3B;CACF,CAAC,CAAC,KAAK,IAAI;AACb;;;;;;;;AASA,SAAS,cAAc,MAAc,MAAsB;CACzD,IAAI,QAAQ;CACZ,KAAK,IAAI,QAAQ,MAAM,QAAQ,KAAK,QAAQ,SAAS,GAAG;EACtD,MAAM,OAAO,KAAK;EAClB,IAAI,SAAS,KACX,SAAS;OACJ,IAAI,SAAS,KAAK;GACvB,SAAS;GACT,IAAI,UAAU,GACZ,OAAO;EAEX;CACF;CACA,OAAO;AACT;;;;;;;;AASA,SAAS,gBAAgB,YAA4B;CACnD,OAAO,WAAW,WAAW,4BAA4B,EAAE;AAC7D;;;;;;;AAQA,SAAS,eAAe,YAA8B;CACpD,MAAM,QAAkB,CAAC;CACzB,IAAI,QAAQ;CACZ,IAAI,QAAQ;CACZ,MAAM,QAAQ,QAAsB;EAClC,MAAM,QAAQ,gBAAgB,WAAW,MAAM,OAAO,GAAG,CAAC,CAAC,CAAC,KAAK;EACjE,MAAM,QAAQ,MAAM,QAAQ,GAAG;EAC/B,IAAI,QAAQ,GACV,MAAM,KAAK,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,KAAK,CAAC;CAE3C;CACA,KAAK,IAAI,QAAQ,GAAG,QAAQ,WAAW,QAAQ,SAAS,GAAG;EACzD,MAAM,OAAO,WAAW;EACxB,IAAI,SAAS,OAAO,SAAS,KAC3B,SAAS;OACJ,IAAI,SAAS,OAAO,SAAS,KAClC,SAAS;OACJ,IAAI,SAAS,OAAO,UAAU,GAAG;GACtC,KAAK,KAAK;GACV,QAAQ,QAAQ;EAClB;CACF;CACA,KAAK,WAAW,MAAM;CACtB,OAAO;AACT;;;;;;;;;;;;;;;;AAiBA,SAAgB,mBACd,UACA,MACA,OACM;CACN,iBAAiB,UAAU,MAAM,KAAK;AACxC;;;;;;;;;;AAWA,SAAgB,kBAAkB,UAA0B,MAAc,OAA2B;CACnG,gBAAgB,UAAU,MAAM,KAAK;AACvC;;;;;;;;;;;AAYA,SAAgB,mBAAmB,UAA0B,MAAc,SAAiC;CAC1G,iBAAiB,UAAU,MAAM,OAAO;AAC1C;;;;;;;;;;AAWA,SAAgB,yBAAyB,UAA0B,MAAc,QAAoC;CACnH,uBAAuB,UAAU,MAAM,MAAM;AAC/C;;;;;;;;;;;;;AAcA,SAAgB,uBACd,QACA,OACA,UACA,OACW;CACX,MAAM,OAAO,YAAY;CACzB,MAAM,MAAM,QAAQ,GAAG,KAAK,UAAU;CACtC,MAAM,SAAS,MAAM,IAAI,GAAG;CAC5B,IAAI,WAAW,KAAA,GACb,OAAO;CAET,MAAM,UAAU,sBAAsB,QAAQ,MAAM,KAAK;CACzD,MAAM,IAAI,KAAK,OAAO;CACtB,OAAO;AACT;;;;;;;;;;;;;;;;;;AAmBA,SAAgB,sBAAsB,QAAuB,UAAkB,OAA2B;CACxG,MAAM,OAAO,gBAAgB,aAAa,gBAAgB;CAC1D,MAAM,SAAS,WAAW,KAAK,QAAQ;EAAC;EAAK;EAAK;EAAK;CAAG,CAAC;CAC3D,OAAO,QACH,+BAA+B,QAAQ,QAAQ,GAAG,GAAG,GAAG,EAAE,SAAS,MAAM,CAAC,IAC1E,0BAA0B,QAAQ,QAAQ,GAAG,GAAG,CAAC,CAAC;AACxD;;;;;;;;;;;;;AAcA,SAAgB,6BAAmC;CACjD,mCAAmC;AACrC;;;;;;;;;;;;;;;;;;;;;AAsBA,SAAgB,iBAAiB,OAAqB,KAA4B;CAChF,MAAM,YAAY,qBAAqB,KAAK,CAAC,EAAE;CAC/C,IAAI,cAAc,KAAA,KAAa,UAAU,SAAS,GAChD,OAAO;CAET,IAAI,KAAK,UAAU,MAAM;CACzB,IAAI,KAAK,UAAU,MAAM;CACzB,IAAI,KAAK,UAAU,MAAM;CACzB,OAAO;AACT"}
|
|
@@ -1,9 +1,9 @@
|
|
|
1
1
|
import { o as CoreErrorCode, t as IgnifxError } from "./ignifx-error-DwIZKxA2.js";
|
|
2
|
-
import { a as SHADER_BLEND_MODES, i as SHADER_ATTRIBUTE_NAMES, l as SHADER_TEXTURE_FALLBACKS, o as SHADER_CULL_MODES, r as LITE_SYSTEM_UNIFORM_NAMES, s as SHADER_INSTANCING_MODES, t as IGNIFX_UNIFORM_NAMES, u as SHADER_UNIFORM_TYPES } from "./shader-declaration-
|
|
2
|
+
import { a as SHADER_BLEND_MODES, i as SHADER_ATTRIBUTE_NAMES, l as SHADER_TEXTURE_FALLBACKS, o as SHADER_CULL_MODES, r as LITE_SYSTEM_UNIFORM_NAMES, s as SHADER_INSTANCING_MODES, t as IGNIFX_UNIFORM_NAMES, u as SHADER_UNIFORM_TYPES } from "./shader-declaration-BGprFBLq.js";
|
|
3
3
|
//#region src/render/shader-pragma.ts
|
|
4
4
|
/**
|
|
5
5
|
* Reads the `// @ignifx …` comment pragmas of a `.wgsl` file into a {@link ShaderDeclaration}
|
|
6
|
-
* (grammar: `docs/
|
|
6
|
+
* (grammar: `docs/architecture/07-rendering.md` §2.8; rationale: ADR-0024).
|
|
7
7
|
*
|
|
8
8
|
* Pure string work with no Babylon Lite import, so the build-time validator and the runtime loader
|
|
9
9
|
* can share it. Four rules the grammar itself does not show:
|
|
@@ -703,4 +703,4 @@ function pragmaError(address, line, message) {
|
|
|
703
703
|
//#endregion
|
|
704
704
|
export { parseShaderDeclaration };
|
|
705
705
|
|
|
706
|
-
//# sourceMappingURL=shader-pragma-
|
|
706
|
+
//# sourceMappingURL=shader-pragma-D0MjCOIg.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"shader-pragma-D0MjCOIg.js","names":[],"sources":["../src/render/shader-pragma.ts"],"sourcesContent":["import { CoreErrorCode } from \"../errors/error-codes.js\";\nimport { IgnifxError } from \"../errors/ignifx-error.js\";\nimport {\n IGNIFX_UNIFORM_NAMES,\n LITE_SYSTEM_UNIFORM_NAMES,\n SHADER_ATTRIBUTE_NAMES,\n SHADER_BLEND_MODES,\n SHADER_CULL_MODES,\n SHADER_INSTANCING_MODES,\n SHADER_TEXTURE_FALLBACKS,\n SHADER_UNIFORM_TYPES,\n} from \"./shader-declaration.js\";\nimport type {\n IgnifxUniformName,\n LiteSystemUniformName,\n ShaderAttributeName,\n ShaderBlendMode,\n ShaderCullMode,\n ShaderDeclaration,\n ShaderDefineDeclaration,\n ShaderInstancingMode,\n ShaderKind,\n ShaderStorageDeclaration,\n ShaderTextureDeclaration,\n ShaderTextureFallback,\n ShaderUniformDeclaration,\n ShaderUniformType,\n} from \"./shader-declaration.js\";\n\n/**\n * Reads the `// @ignifx …` comment pragmas of a `.wgsl` file into a {@link ShaderDeclaration}\n * (grammar: `docs/architecture/07-rendering.md` §2.8; rationale: ADR-0024).\n *\n * Pure string work with no Babylon Lite import, so the build-time validator and the runtime loader\n * can share it. Four rules the grammar itself does not show:\n *\n * - `@ignifx system` mixes Lite's names with ignifx's, and the WGSL reads them from different\n * structs, so they are split into `declaration.system` and `declaration.ignifx`.\n * - An omitted `attributes` directive means `position`; Lite refuses a shader material without it\n * (`lib/material/shader/shader-material.js`, error 293).\n * - A `color(…)` default keeps the authored sRGB numbers; `./shader-material.ts` converts.\n * - `cull front` and `transmissive` on an opaque surface are refused here, with a line number,\n * because Lite has no front-face culling and throws on the second combination (error 295).\n */\n\n/** Matches an `// @ignifx …` line and captures the directive text after it. */\nconst PRAGMA_LINE = /^\\s*\\/\\/\\s*@ignifx\\b(.*)$/;\n\n/** Matches a WGSL identifier. */\nconst IDENTIFIER = /^[A-Za-z_][A-Za-z0-9_]*$/;\n\n/** Splits `name: type` at the colon, capturing the identifier and the rest of the line. */\nconst NAME_AND_TYPE = /^([A-Za-z_][A-Za-z0-9_]*)\\s*:\\s*(.*)$/;\n\n/** Matches a leading `tooltip(\"…\")` modifier, capturing the quoted text. */\nconst TOOLTIP_MODIFIER = /^tooltip\\(\\s*\"((?:[^\"\\\\]|\\\\.)*)\"\\s*\\)\\s*/;\n\n/** Matches a leading `range(…)`, `step(…)`, or `color(…)`/`color` modifier. */\nconst CALL_MODIFIER = /^(range|step|color)\\s*(?:\\(([^)]*)\\))?\\s*/;\n\n/** Matches a leading `color(…)` default value, capturing the arguments. */\nconst COLOR_DEFAULT = /^color\\s*\\(([^)]*)\\)\\s*/;\n\n/** Matches a leading parenthesised numeric list, capturing the arguments. */\nconst TUPLE_DEFAULT = /^\\(([^)]*)\\)\\s*/;\n\n/** Matches a leading decimal number, with optional sign and exponent. */\nconst NUMBER_DEFAULT = /^([+-]?(?:\\d+\\.?\\d*|\\.\\d+)(?:[eE][+-]?\\d+)?)\\s*/;\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/** The identity matrix a `mat4x4<f32>` uniform starts at when the file declares no default. */\nconst IDENTITY_MATRIX: readonly number[] = Object.freeze([1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1]);\n\n/** The mutable declaration the parser fills in, line by line. */\ninterface DeclarationDraft {\n kind: ShaderKind | null;\n attributes: ShaderAttributeName[] | null;\n readonly system: LiteSystemUniformName[];\n readonly ignifx: IgnifxUniformName[];\n readonly uniforms: ShaderUniformDeclaration[];\n readonly textures: ShaderTextureDeclaration[];\n readonly storage: ShaderStorageDeclaration[];\n readonly defines: ShaderDefineDeclaration[];\n readonly names: Set<string>;\n blend: ShaderBlendMode | null;\n cull: ShaderCullMode | null;\n depthWrite: boolean | null;\n depthTest: boolean | null;\n transmissive: boolean;\n instancing: ShaderInstancingMode | null;\n displace: number | null;\n}\n\n/**\n * Reads a `.wgsl` file's `// @ignifx` pragmas into the declaration the loader, the material\n * builder, and the inspector all read.\n *\n * @param source - The whole file, as text.\n * @param address - The asset address, so a failure names the file.\n * @returns The declaration, with every default filled in.\n * @throws IgnifxError with code `IGX-0719`, carrying the offending `line`, for an unknown directive,\n * a malformed one, a duplicate binding name, an attribute or uniform type Babylon Lite does not\n * have, or a combination it cannot express.\n *\n * @example\n * ```ts\n * const declaration = parseShaderDeclaration(\"// @ignifx shader\\n\", \"shaders/flat.wgsl\");\n * declaration.attributes; // [\"position\"]\n * ```\n *\n * @public\n */\nexport function parseShaderDeclaration(source: string, address: string): ShaderDeclaration {\n const draft: DeclarationDraft = {\n kind: null,\n attributes: null,\n system: [],\n ignifx: [],\n uniforms: [],\n textures: [],\n storage: [],\n defines: [],\n names: new Set<string>(),\n blend: null,\n cull: null,\n depthWrite: null,\n depthTest: null,\n transmissive: false,\n instancing: null,\n displace: null,\n };\n const lines = source.split(\"\\n\");\n for (let index = 0; index < lines.length; index += 1) {\n const matched = PRAGMA_LINE.exec(lines[index] ?? \"\");\n if (matched === null) {\n continue;\n }\n readDirective(draft, (matched[1] ?? \"\").trim(), address, index + 1);\n }\n return finish(draft, address);\n}\n\n/**\n * Applies one `// @ignifx …` line to the draft.\n *\n * @param draft - The declaration being built.\n * @param text - The directive text, already trimmed.\n * @param address - The asset address, for diagnostics.\n * @param line - The 1-based line number, for diagnostics.\n */\nfunction readDirective(draft: DeclarationDraft, text: string, address: string, line: number): void {\n if (text.length === 0) {\n throw pragmaError(address, line, \"an @ignifx comment declares no directive\");\n }\n const separator = text.search(/\\s/);\n const directive = separator < 0 ? text : text.slice(0, separator);\n const rest = separator < 0 ? \"\" : text.slice(separator + 1).trim();\n switch (directive) {\n case \"shader\":\n case \"surface\":\n case \"post\":\n readKind(draft, directive, rest, address, line);\n return;\n case \"attributes\":\n readAttributes(draft, rest, address, line);\n return;\n case \"system\":\n readSystem(draft, rest, address, line);\n return;\n case \"uniform\":\n draft.uniforms.push(readUniform(draft, rest, address, line));\n return;\n case \"texture\":\n draft.textures.push(readTexture(draft, rest, address, line));\n return;\n case \"storage\":\n draft.storage.push(readStorage(draft, rest, address, line));\n return;\n case \"define\":\n draft.defines.push(readDefine(draft, rest, address, line));\n return;\n case \"blend\":\n case \"cull\":\n case \"depthWrite\":\n case \"depthTest\":\n case \"transmissive\":\n case \"instancing\":\n readPipeline(draft, text, address, line);\n return;\n case \"displace\":\n readDisplace(draft, rest, address, line);\n return;\n default:\n throw pragmaError(address, line, `${JSON.stringify(directive)} is not an @ignifx directive`);\n }\n}\n\n/**\n * Records the file's form, refusing a second one.\n *\n * @param draft - The declaration being built.\n * @param kind - The declared form.\n * @param rest - Whatever followed it, which must be nothing.\n * @param address - The asset address, for diagnostics.\n * @param line - The 1-based line number, for diagnostics.\n */\nfunction readKind(draft: DeclarationDraft, kind: ShaderKind, rest: string, address: string, line: number): void {\n if (rest.length > 0) {\n throw pragmaError(address, line, `@ignifx ${kind} takes no arguments, but found ${JSON.stringify(rest)}`);\n }\n if (draft.kind !== null) {\n throw pragmaError(address, line, `the file already declared @ignifx ${draft.kind}`);\n }\n draft.kind = kind;\n}\n\n/**\n * Records the vertex attributes the vertex stage reads.\n *\n * @param draft - The declaration being built.\n * @param rest - The comma-separated attribute names.\n * @param address - The asset address, for diagnostics.\n * @param line - The 1-based line number, for diagnostics.\n */\nfunction readAttributes(draft: DeclarationDraft, rest: string, address: string, line: number): void {\n if (draft.attributes !== null) {\n throw pragmaError(address, line, \"the file already declared @ignifx attributes\");\n }\n const names = splitList(rest, address, line, \"attributes\");\n const attributes: ShaderAttributeName[] = [];\n for (const name of names) {\n const attribute = matchLiteral(SHADER_ATTRIBUTE_NAMES, name);\n if (attribute === null) {\n throw pragmaError(\n address,\n line,\n `${JSON.stringify(name)} is not a vertex attribute; Babylon Lite has ${SHADER_ATTRIBUTE_NAMES.join(\", \")}`,\n );\n }\n if (attributes.includes(attribute)) {\n throw pragmaError(address, line, `the attribute ${attribute} is declared twice`);\n }\n attributes.push(attribute);\n }\n draft.attributes = attributes;\n}\n\n/**\n * Records the system uniforms, splitting Babylon Lite's names from ignifx's own.\n *\n * @param draft - The declaration being built.\n * @param rest - The comma-separated uniform names.\n * @param address - The asset address, for diagnostics.\n * @param line - The 1-based line number, for diagnostics.\n */\nfunction readSystem(draft: DeclarationDraft, rest: string, address: string, line: number): void {\n const names = splitList(rest, address, line, \"system\");\n for (const name of names) {\n const lite = matchLiteral(LITE_SYSTEM_UNIFORM_NAMES, name);\n if (lite !== null) {\n claimName(draft, lite, address, line, \"system uniform\");\n draft.system.push(lite);\n continue;\n }\n const ignifx = matchLiteral(IGNIFX_UNIFORM_NAMES, name);\n if (ignifx !== null) {\n claimName(draft, ignifx, address, line, \"system uniform\");\n draft.ignifx.push(ignifx);\n continue;\n }\n throw pragmaError(\n address,\n line,\n `${JSON.stringify(name)} is not a system uniform; Babylon Lite has ${LITE_SYSTEM_UNIFORM_NAMES.join(\", \")} and ignifx adds ${IGNIFX_UNIFORM_NAMES.join(\", \")}`,\n );\n }\n}\n\n/**\n * Reads one `// @ignifx uniform name: type [= default] [modifiers]` line.\n *\n * @param draft - The declaration being built, for the name namespace.\n * @param rest - The directive body.\n * @param address - The asset address, for diagnostics.\n * @param line - The 1-based line number, for diagnostics.\n * @returns The declaration.\n */\nfunction readUniform(draft: DeclarationDraft, rest: string, address: string, line: number): ShaderUniformDeclaration {\n const split = NAME_AND_TYPE.exec(rest);\n if (split === null) {\n throw pragmaError(address, line, `@ignifx uniform expects \"name: type\", but found ${JSON.stringify(rest)}`);\n }\n const name = split[1] ?? \"\";\n let tail = (split[2] ?? \"\").trim();\n const typeSeparator = tail.search(/[\\s=]/);\n const typeName = typeSeparator < 0 ? tail : tail.slice(0, typeSeparator);\n tail = (typeSeparator < 0 ? \"\" : tail.slice(typeName.length)).trim();\n const type = matchLiteral(SHADER_UNIFORM_TYPES, typeName);\n if (type === null) {\n throw pragmaError(\n address,\n line,\n `${JSON.stringify(typeName)} is not a uniform type; Babylon Lite has ${SHADER_UNIFORM_TYPES.join(\", \")}`,\n );\n }\n claimName(draft, name, address, line, \"uniform\");\n let defaultValue: number | readonly number[] | null = null;\n let isColor = false;\n if (tail.startsWith(\"=\")) {\n tail = tail.slice(1).trim();\n const parsed = readDefaultValue(tail, type, name, address, line);\n defaultValue = parsed.value;\n isColor = parsed.color;\n tail = parsed.tail;\n }\n const modifiers = readModifiers(tail, name, type, address, line);\n return {\n name,\n type,\n defaultValue: defaultValue ?? implicitDefault(type),\n color: isColor || modifiers.color,\n range: modifiers.range,\n step: modifiers.step,\n tooltip: modifiers.tooltip,\n };\n}\n\n/** A parsed `= …` default value and whatever followed it. */\ninterface ParsedDefault {\n /** The numbers the file wrote. */\n readonly value: number | readonly number[];\n /** Whether the value was written as `color(…)`. */\n readonly color: boolean;\n /** The rest of the line. */\n readonly tail: string;\n}\n\n/**\n * Reads the `= …` half of a uniform declaration.\n *\n * @param text - The text after the `=`.\n * @param type - The declared type, which fixes the element count.\n * @param name - The uniform's name, for diagnostics.\n * @param address - The asset address, for diagnostics.\n * @param line - The 1-based line number, for diagnostics.\n * @returns The value, whether it was a colour, and the rest of the line.\n */\nfunction readDefaultValue(\n text: string,\n type: ShaderUniformType,\n name: string,\n address: string,\n line: number,\n): ParsedDefault {\n const expected = ELEMENT_COUNTS[type];\n const colorMatch = COLOR_DEFAULT.exec(text);\n if (colorMatch !== null) {\n const numbers = readNumbers(colorMatch[1] ?? \"\", name, address, line);\n if (type !== \"vec3<f32>\" && type !== \"vec4<f32>\") {\n throw pragmaError(address, line, `${name} is a ${type}, so color(…) does not apply to it`);\n }\n assertArity(numbers.length, expected, name, type, address, line);\n return { value: numbers, color: true, tail: text.slice(colorMatch[0].length).trim() };\n }\n const tupleMatch = TUPLE_DEFAULT.exec(text);\n if (tupleMatch !== null) {\n const numbers = readNumbers(tupleMatch[1] ?? \"\", name, address, line);\n assertArity(numbers.length, expected, name, type, address, line);\n return { value: numbers, color: false, tail: text.slice(tupleMatch[0].length).trim() };\n }\n const numberMatch = NUMBER_DEFAULT.exec(text);\n if (numberMatch !== null) {\n assertArity(1, expected, name, type, address, line);\n return { value: Number(numberMatch[1]), color: false, tail: text.slice(numberMatch[0].length).trim() };\n }\n throw pragmaError(address, line, `${name} declares no readable default value after \"=\"`);\n}\n\n/** The optional hints an inspector renders a uniform with. */\ninterface ParsedModifiers {\n /** Whether the bare `color` modifier was present. */\n readonly color: boolean;\n /** The `range(a, b)` bounds, or `null`. */\n readonly range: readonly [number, number] | null;\n /** The `step(s)` increment, or `null`. */\n readonly step: number | null;\n /** The `tooltip(\"…\")` text, or `null`. */\n readonly tooltip: string | null;\n}\n\n/**\n * Reads the `range(…)`, `step(…)`, `color`, and `tooltip(\"…\")` modifiers that close a uniform line.\n *\n * @param text - What is left of the line.\n * @param name - The uniform's name, for diagnostics.\n * @param type - The declared type, which decides whether `color` applies.\n * @param address - The asset address, for diagnostics.\n * @param line - The 1-based line number, for diagnostics.\n * @returns The hints.\n */\nfunction readModifiers(\n text: string,\n name: string,\n type: ShaderUniformType,\n address: string,\n line: number,\n): ParsedModifiers {\n let rest = text;\n let color = false;\n let range: readonly [number, number] | null = null;\n let step: number | null = null;\n let tooltip: string | null = null;\n while (rest.length > 0) {\n const tooltipMatch = TOOLTIP_MODIFIER.exec(rest);\n if (tooltipMatch !== null) {\n if (tooltip !== null) {\n throw pragmaError(address, line, `${name} declares tooltip twice`);\n }\n tooltip = (tooltipMatch[1] ?? \"\").replaceAll('\\\\\"', '\"');\n rest = rest.slice(tooltipMatch[0].length);\n continue;\n }\n const callMatch = CALL_MODIFIER.exec(rest);\n if (callMatch === null) {\n throw pragmaError(address, line, `${name} declares ${JSON.stringify(rest)}, which is not a uniform modifier`);\n }\n const modifier = callMatch[1] ?? \"\";\n const argumentText = callMatch[2];\n if (modifier === \"color\") {\n if (argumentText !== undefined) {\n throw pragmaError(address, line, `${name} declares color(…) after its default value`);\n }\n if (type !== \"vec3<f32>\" && type !== \"vec4<f32>\") {\n throw pragmaError(address, line, `${name} is a ${type}, so color does not apply to it`);\n }\n color = true;\n } else if (modifier === \"range\") {\n if (range !== null) {\n throw pragmaError(address, line, `${name} declares range twice`);\n }\n const bounds = readNumbers(argumentText ?? \"\", name, address, line);\n const low = bounds[0];\n const high = bounds[1];\n if (bounds.length !== 2 || low === undefined || high === undefined) {\n throw pragmaError(address, line, `${name} declares range(…) with ${String(bounds.length)} bounds, not 2`);\n }\n range = [low, high];\n } else {\n if (step !== null) {\n throw pragmaError(address, line, `${name} declares step twice`);\n }\n const increments = readNumbers(argumentText ?? \"\", name, address, line);\n const increment = increments[0];\n if (increments.length !== 1 || increment === undefined) {\n throw pragmaError(address, line, `${name} declares step(…) with ${String(increments.length)} values, not 1`);\n }\n step = increment;\n }\n rest = rest.slice(callMatch[0].length);\n }\n return { color, range, step, tooltip };\n}\n\n/**\n * Reads one `// @ignifx texture name [srgb] [normal] [default white|black|transparent] [array]`\n * line.\n *\n * @param draft - The declaration being built, for the name namespace.\n * @param rest - The directive body.\n * @param address - The asset address, for diagnostics.\n * @param line - The 1-based line number, for diagnostics.\n * @returns The declaration.\n */\nfunction readTexture(draft: DeclarationDraft, rest: string, address: string, line: number): ShaderTextureDeclaration {\n const tokens = rest.split(/\\s+/).filter((token) => token.length > 0);\n const name = tokens[0];\n if (name === undefined) {\n throw pragmaError(address, line, \"@ignifx texture declares no name\");\n }\n assertIdentifier(name, address, line, \"texture\");\n claimName(draft, name, address, line, \"texture\");\n claimName(draft, `${name}Sampler`, address, line, \"texture sampler\");\n let srgb = false;\n let normal = false;\n let array = false;\n let fallback: ShaderTextureFallback | null = null;\n for (let index = 1; index < tokens.length; index += 1) {\n const token = tokens[index] ?? \"\";\n if (token === \"srgb\") {\n srgb = true;\n } else if (token === \"normal\") {\n normal = true;\n } else if (token === \"array\") {\n array = true;\n } else if (token === \"default\") {\n index += 1;\n const named = matchLiteral(SHADER_TEXTURE_FALLBACKS, tokens[index] ?? \"\");\n if (named === null) {\n throw pragmaError(\n address,\n line,\n `${name} declares default ${JSON.stringify(tokens[index] ?? \"\")}; expected ${SHADER_TEXTURE_FALLBACKS.join(\", \")}`,\n );\n }\n fallback = named;\n } else {\n throw pragmaError(address, line, `${JSON.stringify(token)} is not a texture modifier`);\n }\n }\n return { name, srgb, normal, fallback, array };\n}\n\n/**\n * Reads one `// @ignifx storage name: array<T>` line.\n *\n * @param draft - The declaration being built, for the name namespace.\n * @param rest - The directive body.\n * @param address - The asset address, for diagnostics.\n * @param line - The 1-based line number, for diagnostics.\n * @returns The declaration.\n */\nfunction readStorage(draft: DeclarationDraft, rest: string, address: string, line: number): ShaderStorageDeclaration {\n const split = NAME_AND_TYPE.exec(rest);\n if (split === null) {\n throw pragmaError(address, line, `@ignifx storage expects \"name: type\", but found ${JSON.stringify(rest)}`);\n }\n const name = split[1] ?? \"\";\n const type = (split[2] ?? \"\").trim();\n if (type.length === 0) {\n throw pragmaError(address, line, `${name} declares no storage buffer type`);\n }\n claimName(draft, name, address, line, \"storage buffer\");\n return { name, type };\n}\n\n/**\n * Reads one `// @ignifx define NAME = value` line.\n *\n * @param draft - The declaration being built, for the name namespace.\n * @param rest - The directive body.\n * @param address - The asset address, for diagnostics.\n * @param line - The 1-based line number, for diagnostics.\n * @returns The declaration.\n */\nfunction readDefine(draft: DeclarationDraft, rest: string, address: string, line: number): ShaderDefineDeclaration {\n const equals = rest.indexOf(\"=\");\n if (equals < 0) {\n throw pragmaError(address, line, `@ignifx define expects \"NAME = value\", but found ${JSON.stringify(rest)}`);\n }\n const name = rest.slice(0, equals).trim();\n const text = rest.slice(equals + 1).trim();\n assertIdentifier(name, address, line, \"define\");\n claimName(draft, name, address, line, \"define\");\n if (text === \"true\" || text === \"false\") {\n return { name, value: text === \"true\" };\n }\n const numberMatch = NUMBER_DEFAULT.exec(text);\n if (numberMatch === null || numberMatch[0].trim().length !== text.length) {\n throw pragmaError(address, line, `${name} declares ${JSON.stringify(text)}; a define is true, false, or a number`);\n }\n return { name, value: Number(numberMatch[1]) };\n}\n\n/**\n * Reads the `// @ignifx displace <metres>` line: how far the vertex stage may move a vertex.\n *\n * @param draft - The declaration being built.\n * @param rest - The directive body, which must be one number of zero or more.\n * @param address - The asset address, for diagnostics.\n * @param line - The 1-based line number, for diagnostics.\n */\nfunction readDisplace(draft: DeclarationDraft, rest: string, address: string, line: number): void {\n if (draft.displace !== null) {\n throw pragmaError(address, line, \"displace is declared twice\");\n }\n const numberMatch = NUMBER_DEFAULT.exec(rest);\n const value = numberMatch === null ? Number.NaN : Number(numberMatch[1]);\n if (\n numberMatch === null ||\n numberMatch[0].trim().length !== rest.length ||\n !(value >= 0) ||\n !Number.isFinite(value)\n ) {\n throw pragmaError(\n address,\n line,\n `displace ${JSON.stringify(rest)} is not a distance; write the furthest a vertex moves, in metres, such as displace 0.25`,\n );\n }\n draft.displace = value;\n}\n\n/**\n * Reads a pipeline-state line, merging it into whatever earlier lines declared.\n *\n * @param draft - The declaration being built.\n * @param text - The whole directive text, starting at its first keyword.\n * @param address - The asset address, for diagnostics.\n * @param line - The 1-based line number, for diagnostics.\n */\nfunction readPipeline(draft: DeclarationDraft, text: string, address: string, line: number): void {\n const tokens = text.split(/\\s+/).filter((token) => token.length > 0);\n for (let index = 0; index < tokens.length; index += 1) {\n const keyword = tokens[index] ?? \"\";\n if (keyword === \"transmissive\") {\n draft.transmissive = true;\n continue;\n }\n index += 1;\n const value = tokens[index] ?? \"\";\n switch (keyword) {\n case \"blend\":\n draft.blend = readPipelineValue(SHADER_BLEND_MODES, draft.blend, keyword, value, address, line);\n break;\n case \"cull\": {\n const cull = readPipelineValue(SHADER_CULL_MODES, draft.cull, keyword, value, address, line);\n if (cull === \"front\") {\n throw pragmaError(\n address,\n line,\n \"Babylon Lite 1.27.0 has no front-face culling for a shader material; declare cull back or cull none and flip the winding\",\n );\n }\n draft.cull = cull;\n break;\n }\n case \"depthWrite\":\n draft.depthWrite = readToggle(draft.depthWrite, keyword, value, address, line);\n break;\n case \"depthTest\":\n draft.depthTest = readToggle(draft.depthTest, keyword, value, address, line);\n break;\n case \"instancing\":\n draft.instancing = readPipelineValue(SHADER_INSTANCING_MODES, draft.instancing, keyword, value, address, line);\n break;\n default:\n throw pragmaError(address, line, `${JSON.stringify(keyword)} is not a pipeline keyword`);\n }\n }\n}\n\n/**\n * Reads one pipeline keyword's value out of a fixed list, refusing a second declaration of it.\n *\n * @typeParam Value - The literal union the keyword accepts.\n * @param allowed - The accepted values.\n * @param current - What an earlier line declared, or `null`.\n * @param keyword - The keyword, for diagnostics.\n * @param value - The token that followed it.\n * @param address - The asset address, for diagnostics.\n * @param line - The 1-based line number, for diagnostics.\n * @returns The value.\n */\nfunction readPipelineValue<Value extends string>(\n allowed: readonly Value[],\n current: Value | null,\n keyword: string,\n value: string,\n address: string,\n line: number,\n): Value {\n if (current !== null) {\n throw pragmaError(address, line, `${keyword} is declared twice`);\n }\n const matched = matchLiteral(allowed, value);\n if (matched === null) {\n throw pragmaError(address, line, `${keyword} ${JSON.stringify(value)} is not one of ${allowed.join(\", \")}`);\n }\n return matched;\n}\n\n/**\n * Reads an `on`/`off` toggle, refusing a second declaration of it.\n *\n * @param current - What an earlier line declared, or `null`.\n * @param keyword - The keyword, for diagnostics.\n * @param value - The token that followed it.\n * @param address - The asset address, for diagnostics.\n * @param line - The 1-based line number, for diagnostics.\n * @returns `true` for `on`, `false` for `off`.\n */\nfunction readToggle(current: boolean | null, keyword: string, value: string, address: string, line: number): boolean {\n if (current !== null) {\n throw pragmaError(address, line, `${keyword} is declared twice`);\n }\n if (value !== \"on\" && value !== \"off\") {\n throw pragmaError(address, line, `${keyword} ${JSON.stringify(value)} is not on or off`);\n }\n return value === \"on\";\n}\n\n/**\n * Fills in the defaults and checks the whole-file rules.\n *\n * @param draft - The declaration the parser built.\n * @param address - The asset address, for diagnostics.\n * @returns The finished declaration.\n */\nfunction finish(draft: DeclarationDraft, address: string): ShaderDeclaration {\n const kind = draft.kind;\n if (kind === null) {\n throw pragmaError(address, 1, \"the file declares no @ignifx shader, @ignifx surface, or @ignifx post directive\");\n }\n const declared = draft.attributes;\n if (declared !== null && kind === \"shader\" && !declared.includes(\"position\")) {\n throw pragmaError(address, 1, \"an @ignifx shader file must declare the position attribute\");\n }\n const attributes: readonly ShaderAttributeName[] = declared ?? (kind === \"shader\" ? [\"position\"] : []);\n if (kind === \"post\" && draft.displace !== null) {\n throw pragmaError(address, 1, \"an @ignifx post file draws no mesh, so it has nothing to displace\");\n }\n const blend = draft.blend ?? \"opaque\";\n if (draft.transmissive && blend === \"opaque\") {\n throw pragmaError(\n address,\n 1,\n \"transmissive needs a blended surface; declare blend alpha, additive, or premultiplied\",\n );\n }\n return {\n kind,\n attributes,\n system: draft.system,\n ignifx: draft.ignifx,\n uniforms: draft.uniforms,\n textures: draft.textures,\n storage: draft.storage,\n defines: draft.defines,\n pipeline: {\n blend,\n cull: draft.cull ?? \"back\",\n // Babylon Lite defaults a blended material to depth-read-only and lets an explicit value win\n // (`lib/material/shader/shader-material.js`), which is the rule reproduced here so the\n // declaration itself carries the effective value.\n depthWrite: draft.depthWrite ?? blend === \"opaque\",\n depthTest: draft.depthTest ?? true,\n transmissive: draft.transmissive,\n instancing: draft.instancing ?? \"none\",\n },\n displace: draft.displace ?? 0,\n };\n}\n\n/**\n * Splits a comma-separated directive body, refusing an empty entry.\n *\n * @param rest - The directive body.\n * @param address - The asset address, for diagnostics.\n * @param line - The 1-based line number, for diagnostics.\n * @param directive - The directive name, for diagnostics.\n * @returns The trimmed entries.\n */\nfunction splitList(rest: string, address: string, line: number, directive: string): readonly string[] {\n if (rest.length === 0) {\n throw pragmaError(address, line, `@ignifx ${directive} declares nothing`);\n }\n const parts = rest.split(\",\");\n const names: string[] = [];\n for (let index = 0; index < parts.length; index += 1) {\n const name = (parts[index] ?? \"\").trim();\n if (name.length === 0) {\n throw pragmaError(address, line, `@ignifx ${directive} has an empty entry`);\n }\n names.push(name);\n }\n return names;\n}\n\n/**\n * Reads a comma-separated list of numbers.\n *\n * @param text - The argument text, without the parentheses.\n * @param name - The declaration's name, for diagnostics.\n * @param address - The asset address, for diagnostics.\n * @param line - The 1-based line number, for diagnostics.\n * @returns The numbers.\n */\nfunction readNumbers(text: string, name: string, address: string, line: number): readonly number[] {\n const parts = text.split(\",\");\n const numbers: number[] = [];\n for (let index = 0; index < parts.length; index += 1) {\n const part = (parts[index] ?? \"\").trim();\n const value = Number(part);\n if (part.length === 0 || !Number.isFinite(value)) {\n throw pragmaError(address, line, `${name} declares ${JSON.stringify(part)}, which is not a number`);\n }\n numbers.push(value);\n }\n return numbers;\n}\n\n/**\n * Checks that a default value has as many numbers as its type needs.\n *\n * @param actual - How many numbers the file wrote.\n * @param expected - How many the type holds.\n * @param name - The uniform's name, for diagnostics.\n * @param type - The uniform's type, for diagnostics.\n * @param address - The asset address, for diagnostics.\n * @param line - The 1-based line number, for diagnostics.\n */\nfunction assertArity(\n actual: number,\n expected: number,\n name: string,\n type: ShaderUniformType,\n address: string,\n line: number,\n): void {\n if (actual !== expected) {\n throw pragmaError(\n address,\n line,\n `${name} is a ${type}, which takes ${String(expected)} numbers, but its default has ${String(actual)}`,\n );\n }\n}\n\n/**\n * The value a uniform starts at when the file declares no default: zeros, or the identity matrix.\n *\n * @param type - The declared type.\n * @returns The default.\n */\nfunction implicitDefault(type: ShaderUniformType): number | readonly number[] {\n if (type === \"mat4x4<f32>\") {\n return IDENTITY_MATRIX;\n }\n const count = ELEMENT_COUNTS[type];\n if (count === 1) {\n return 0;\n }\n const zeros: number[] = [];\n for (let index = 0; index < count; index += 1) {\n zeros.push(0);\n }\n return zeros;\n}\n\n/**\n * Claims one WGSL binding name, refusing a duplicate.\n *\n * @remarks\n * Babylon Lite puts uniforms, samplers, `<name>Sampler` pairs, storage buffers, and defines in one\n * namespace (`assertUniqueName`, `lib/material/shader/shader-material.js`), so the parser checks it\n * here and reports the line instead of letting Lite throw without one.\n *\n * @param draft - The declaration being built.\n * @param name - The name being claimed.\n * @param address - The asset address, for diagnostics.\n * @param line - The 1-based line number, for diagnostics.\n * @param what - What kind of binding is claiming it, for diagnostics.\n */\nfunction claimName(draft: DeclarationDraft, name: string, address: string, line: number, what: string): void {\n if (draft.names.has(name)) {\n throw pragmaError(address, line, `${name} is already declared; the ${what} name must be unique in the file`);\n }\n draft.names.add(name);\n}\n\n/**\n * Checks that a name is a WGSL identifier.\n *\n * @param name - The candidate.\n * @param address - The asset address, for diagnostics.\n * @param line - The 1-based line number, for diagnostics.\n * @param what - What kind of binding it names, for diagnostics.\n */\nfunction assertIdentifier(name: string, address: string, line: number, what: string): void {\n if (!IDENTIFIER.test(name)) {\n throw pragmaError(address, line, `${JSON.stringify(name)} is not a WGSL identifier for a ${what}`);\n }\n}\n\n/**\n * Narrows a token to one of a fixed list of literals.\n *\n * @typeParam Value - The literal union.\n * @param allowed - The accepted values.\n * @param token - The candidate.\n * @returns The matching literal, or `null`.\n */\nfunction matchLiteral<Value extends string>(allowed: readonly Value[], token: string): Value | null {\n for (let index = 0; index < allowed.length; index += 1) {\n const candidate = allowed[index];\n if (candidate !== undefined && candidate === token) {\n return candidate;\n }\n }\n return null;\n}\n\n/**\n * Builds the `IGX-0719` failure a malformed pragma produces.\n *\n * @param address - The asset address.\n * @param line - The 1-based line number.\n * @param message - What is wrong.\n * @returns The error to throw.\n */\nfunction pragmaError(address: string, line: number, message: string): IgnifxError {\n return new IgnifxError(CoreErrorCode.invalidShaderPragma, `${address} line ${String(line)}: ${message}.`, {\n context: { asset: address, line, message },\n hint: \"The @ignifx pragma grammar is in skills/ignifx/references/formats/wgsl.md.\",\n });\n}\n"],"mappings":"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"}
|