@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.
Files changed (88) hide show
  1. package/README.md +22 -0
  2. package/dist/{agx-tone-mapping-Cgt844j6.js → agx-tone-mapping-CCdGk_ly.js} +2 -2
  3. package/dist/agx-tone-mapping-CCdGk_ly.js.map +1 -0
  4. package/dist/auto-exposure-uzPn0beO.js.map +1 -1
  5. package/dist/{bloom-hdr-CLtQj-oY.js → bloom-hdr-xPwkIdHG.js} +5 -6
  6. package/dist/bloom-hdr-xPwkIdHG.js.map +1 -0
  7. package/dist/contact-shadows-T523EXaP.js.map +1 -1
  8. package/dist/effect-task-CMbuO6Kb.js.map +1 -1
  9. package/dist/{environment-Bf4aphSb.js → environment-7fJbN402.js} +2 -2
  10. package/dist/{environment-Bf4aphSb.js.map → environment-7fJbN402.js.map} +1 -1
  11. package/dist/{gtao-Bpu5-0Ne.js → gtao-BmdrXXJz.js} +10 -11
  12. package/dist/gtao-BmdrXXJz.js.map +1 -0
  13. package/dist/{hdr-output-DBQwMphy.js → hdr-output-_2TU-jWy.js} +8 -8
  14. package/dist/hdr-output-_2TU-jWy.js.map +1 -0
  15. package/dist/index.d.ts +40 -42
  16. package/dist/index.d.ts.map +1 -1
  17. package/dist/index.js +104 -108
  18. package/dist/index.js.map +1 -1
  19. package/dist/{instanced-mesh-instance-B-fXKSrY.js → instanced-mesh-instance-BLdAJTj8.js} +3 -3
  20. package/dist/instanced-mesh-instance-BLdAJTj8.js.map +1 -0
  21. package/dist/{light-probe-asset-BqfSrJe9.js → light-probe-asset-DGNIwKNb.js} +2 -2
  22. package/dist/light-probe-asset-DGNIwKNb.js.map +1 -0
  23. package/dist/{light-probes-DDojYajw.js → light-probes-C8jharz9.js} +6 -6
  24. package/dist/light-probes-C8jharz9.js.map +1 -0
  25. package/dist/lightmaps-BUUIIkt9.js.map +1 -1
  26. package/dist/material-myMbl9mW.js.map +1 -1
  27. package/dist/{material-plugin-DapJNj04.js → material-plugin-BBxIy6eo.js} +4 -4
  28. package/dist/material-plugin-BBxIy6eo.js.map +1 -0
  29. package/dist/{overlay-CjVgsfrm.js → overlay-DokHzP6_.js} +2 -3
  30. package/dist/overlay-DokHzP6_.js.map +1 -0
  31. package/dist/{post-effect-Cu3Enpz7.js → post-effect-DEZD-r0I.js} +3 -3
  32. package/dist/post-effect-DEZD-r0I.js.map +1 -0
  33. package/dist/{post-effect-compiler-cCq9lcHt.js → post-effect-compiler-unDD3hod.js} +4 -4
  34. package/dist/post-effect-compiler-unDD3hod.js.map +1 -0
  35. package/dist/{prefab-overrides-C2GsgOQc.js → prefab-overrides-Bb7jVm7A.js} +3 -3
  36. package/dist/prefab-overrides-Bb7jVm7A.js.map +1 -0
  37. package/dist/{prefab-overrides-htDc_5Po.d.ts → prefab-overrides-DwrPDVVt.d.ts} +61 -63
  38. package/dist/{prefab-overrides-htDc_5Po.d.ts.map → prefab-overrides-DwrPDVVt.d.ts.map} +1 -1
  39. package/dist/prefab.d.ts +1 -1
  40. package/dist/prefab.js +1 -1
  41. package/dist/{reflection-probe-QkD1Fo_d.js → reflection-probe-C2jcreI1.js} +5 -5
  42. package/dist/reflection-probe-C2jcreI1.js.map +1 -0
  43. package/dist/{reflection-probes-CAzSuqf8.js → reflection-probes-BMVQfbhm.js} +10 -10
  44. package/dist/reflection-probes-BMVQfbhm.js.map +1 -0
  45. package/dist/{render-path-D11i_7X8.js → render-path-CWXHrRa2.js} +2 -2
  46. package/dist/render-path-CWXHrRa2.js.map +1 -0
  47. package/dist/{scene-color-passes-B93qTOka.js → scene-color-passes-DgXJ45Ql.js} +2 -2
  48. package/dist/scene-color-passes-DgXJ45Ql.js.map +1 -0
  49. package/dist/{scene-inputs-BxGOsnIZ.js → scene-inputs-_0j2Hi6L.js} +9 -8
  50. package/dist/scene-inputs-_0j2Hi6L.js.map +1 -0
  51. package/dist/{shader-declaration-5q__jycG.js → shader-declaration-BGprFBLq.js} +4 -4
  52. package/dist/shader-declaration-BGprFBLq.js.map +1 -0
  53. package/dist/{shader-material-TM4f8eKA.js → shader-material-C9sYMGWw.js} +8 -9
  54. package/dist/shader-material-C9sYMGWw.js.map +1 -0
  55. package/dist/{shader-material-CJIDFvSb.js → shader-material-vmkJ25II.js} +3 -3
  56. package/dist/shader-material-vmkJ25II.js.map +1 -0
  57. package/dist/{shader-pragma-ljmAbVc2.js → shader-pragma-D0MjCOIg.js} +3 -3
  58. package/dist/shader-pragma-D0MjCOIg.js.map +1 -0
  59. package/dist/ssgi-DSnhqotl.js.map +1 -1
  60. package/dist/{surface-shader-rpPpeosD.js → surface-shader-BfADq9Wx.js} +6 -6
  61. package/dist/surface-shader-BfADq9Wx.js.map +1 -0
  62. package/dist/{taa-BwBZLy11.js → taa-nxVA78Ur.js} +5 -6
  63. package/dist/taa-nxVA78Ur.js.map +1 -0
  64. package/dist/vec3-2C3LBZnt.js.map +1 -1
  65. package/package.json +1 -1
  66. package/dist/agx-tone-mapping-Cgt844j6.js.map +0 -1
  67. package/dist/bloom-hdr-CLtQj-oY.js.map +0 -1
  68. package/dist/gtao-Bpu5-0Ne.js.map +0 -1
  69. package/dist/hdr-output-DBQwMphy.js.map +0 -1
  70. package/dist/instanced-mesh-instance-B-fXKSrY.js.map +0 -1
  71. package/dist/light-probe-asset-BqfSrJe9.js.map +0 -1
  72. package/dist/light-probes-DDojYajw.js.map +0 -1
  73. package/dist/material-plugin-DapJNj04.js.map +0 -1
  74. package/dist/overlay-CjVgsfrm.js.map +0 -1
  75. package/dist/post-effect-Cu3Enpz7.js.map +0 -1
  76. package/dist/post-effect-compiler-cCq9lcHt.js.map +0 -1
  77. package/dist/prefab-overrides-C2GsgOQc.js.map +0 -1
  78. package/dist/reflection-probe-QkD1Fo_d.js.map +0 -1
  79. package/dist/reflection-probes-CAzSuqf8.js.map +0 -1
  80. package/dist/render-path-D11i_7X8.js.map +0 -1
  81. package/dist/scene-color-passes-B93qTOka.js.map +0 -1
  82. package/dist/scene-inputs-BxGOsnIZ.js.map +0 -1
  83. package/dist/shader-declaration-5q__jycG.js.map +0 -1
  84. package/dist/shader-material-CJIDFvSb.js.map +0 -1
  85. package/dist/shader-material-TM4f8eKA.js.map +0 -1
  86. package/dist/shader-pragma-ljmAbVc2.js.map +0 -1
  87. package/dist/surface-shader-rpPpeosD.js.map +0 -1
  88. package/dist/taa-BwBZLy11.js.map +0 -1
package/dist/index.js CHANGED
@@ -1,18 +1,18 @@
1
1
  import { a as CORE_ERROR_MESSAGES, c as THIRD_PARTY_ERROR_PREFIX, i as isIgnifxError, l as isValidErrorCode, n as assertNever, o as CoreErrorCode, r as formatErrorMessage, s as ErrorRange, t as IgnifxError } from "./ignifx-error-DwIZKxA2.js";
2
- import { $ as Signal, A as str, B as readPickedIdentity, C as f64, D as optional, E as map, F as FieldKind, G as componentInternals, H as readPickedTag, I as createPickRay, J as toEntityHandle, K as INVALID_HANDLE, L as raycastScene, M as vec2, N as vec3, O as quat, P as vec4, Q as defineSchema, R as raycastSceneWhere, S as f32, T as layerMask, U as setPickRay, V as readPickedMeshName, W as Component, X as assertNoInheritedFieldNames, Y as applyInit, Z as createDefaults, _ as componentRef, b as entityRef, c as RENDER_TEXTURE_MAX_SIZE, d as bindFrameCameras, f as renderTextureUnusableError, g as color, h as bool, j as u32, k as record, l as RenderTextureImpl, m as asset, n as ReflectionProbe, p as array, q as toComponentHandle, s as EDITOR_ONLY_METADATA_KEY, t as REFLECTION_PROBE_REFRESH_MODES, u as assertRenderTextureSize, v as curve, w as i32, x as enumOf, y as custom, z as readOwnerTag } from "./reflection-probe-QkD1Fo_d.js";
3
- import { A as childPath, C as canonicalizeNumber, D as encodeValue, E as encodeProps, F as asJsonObject, G as splitFragment, H as joinRoot, I as setOwnJsonProperty, L as SchemaIssueCode, M as isArray, N as isPlainObject, O as COLOR_CHANNELS, P as asJsonArray, R as issue, S as toJsonSchema, T as decodeValue, U as matchExtension, V as isAbsoluteAddress, W as normalizeExtension, _ as describeSceneFileFormat, a as applyOverrides, b as stringifySceneFile, c as remapInstancePath, d as createSceneAsset, f as findSceneDependency, g as SCENE_FORMAT_VERSION, h as SCENE_FILE_FORMAT, i as resolveInstancePath, j as indexPath, k as VECTOR_COMPONENTS, l as SceneAssetToken, m as SCENE_FILE_EXTENSIONS, n as revertOverrides, o as parseOverridePath, p as SCENE_ASSET_TYPE, r as enumerateInstanceTargets, s as instancePathResolver, t as applyOverridesToAsset, u as computeSceneHash, v as isSceneFileHeader, w as decodeProps, x as describeSchema, y as sceneFileJsonSchema } from "./prefab-overrides-C2GsgOQc.js";
2
+ import { $ as Signal, A as str, B as readPickedIdentity, C as f64, D as optional, E as map, F as FieldKind, G as componentInternals, H as readPickedTag, I as createPickRay, J as toEntityHandle, K as INVALID_HANDLE, L as raycastScene, M as vec2, N as vec3, O as quat, P as vec4, Q as defineSchema, R as raycastSceneWhere, S as f32, T as layerMask, U as setPickRay, V as readPickedMeshName, W as Component, X as assertNoInheritedFieldNames, Y as applyInit, Z as createDefaults, _ as componentRef, b as entityRef, c as RENDER_TEXTURE_MAX_SIZE, d as bindFrameCameras, f as renderTextureUnusableError, g as color, h as bool, j as u32, k as record, l as RenderTextureImpl, m as asset, n as ReflectionProbe, p as array, q as toComponentHandle, s as EDITOR_ONLY_METADATA_KEY, t as REFLECTION_PROBE_REFRESH_MODES, u as assertRenderTextureSize, v as curve, w as i32, x as enumOf, y as custom, z as readOwnerTag } from "./reflection-probe-C2jcreI1.js";
3
+ import { A as childPath, C as canonicalizeNumber, D as encodeValue, E as encodeProps, F as asJsonObject, G as splitFragment, H as joinRoot, I as setOwnJsonProperty, L as SchemaIssueCode, M as isArray, N as isPlainObject, O as COLOR_CHANNELS, P as asJsonArray, R as issue, S as toJsonSchema, T as decodeValue, U as matchExtension, V as isAbsoluteAddress, W as normalizeExtension, _ as describeSceneFileFormat, a as applyOverrides, b as stringifySceneFile, c as remapInstancePath, d as createSceneAsset, f as findSceneDependency, g as SCENE_FORMAT_VERSION, h as SCENE_FILE_FORMAT, i as resolveInstancePath, j as indexPath, k as VECTOR_COMPONENTS, l as SceneAssetToken, m as SCENE_FILE_EXTENSIONS, n as revertOverrides, o as parseOverridePath, p as SCENE_ASSET_TYPE, r as enumerateInstanceTargets, s as instancePathResolver, t as applyOverridesToAsset, u as computeSceneHash, v as isSceneFileHeader, w as decodeProps, x as describeSchema, y as sceneFileJsonSchema } from "./prefab-overrides-Bb7jVm7A.js";
4
4
  import { _ as smoothStep, a as clamp, c as deltaAngleDegrees, d as lerpAngleDegrees, f as moveTowards, g as sign, h as repeat, i as approximately, l as inverseLerp, m as radToDeg, n as EPSILON, o as clamp01, p as pingPong, r as RAD_TO_DEG, s as degToRad, t as DEG_TO_RAD, u as lerp, v as wrapAngleDegrees } from "./math-utils-BcDnL-gi.js";
5
5
  import { n as Mat4, r as basisToQuatToRef, t as MAT4_IDENTITY } from "./mat4-D6exvAuO.js";
6
6
  import { a as localRotation, d as setNodeName, f as setNodeSelfVisible, i as localPosition, l as readWorldMatrix, m as worldMatrixVersion, n as disposeNode, o as localScale, p as tagNode, r as linkParent, s as parentNode, t as createNode, u as reparentKeepingWorld } from "./node-DznSvwap.js";
7
7
  import { t as Color } from "./color-DrR6GFTd.js";
8
- import { a as readSceneImageProcessing, c as setSceneEnvironmentRotation, i as readSceneEnvironment, l as setSceneFog, n as installSceneEnvironment, o as setSceneClearColor, r as loadSceneEnvironment, s as setSceneEnvironmentBlur, t as TONE_MAPPING_NAMES, u as setSceneImageProcessingOptions } from "./environment-Bf4aphSb.js";
8
+ import { a as readSceneImageProcessing, c as setSceneEnvironmentRotation, i as readSceneEnvironment, l as setSceneFog, n as installSceneEnvironment, o as setSceneClearColor, r as loadSceneEnvironment, s as setSceneEnvironmentBlur, t as TONE_MAPPING_NAMES, u as setSceneImageProcessingOptions } from "./environment-7fJbN402.js";
9
9
  import { a as markMaterialDirty, c as setPbrBaseColor, i as createStandardMaterialFromProps, l as setPbrMetallicRoughness, n as createDefaultMaterial, r as createPbrMaterialFromProps, s as setMaterialAlpha, t as MATERIAL_ALPHA_MODES } from "./material-myMbl9mW.js";
10
10
  import { A as setMeshPickable, C as overrideSubtreeMaterials, D as setMeshBounds, E as removeMeshFromScene, F as updateMeshNormals$1, I as updateMeshPositions$1, L as updateMeshUvs$1, M as setMeshRenderOrder, N as setMeshSubtreeVisible, O as setMeshId, P as updateMeshColors$1, S as disposeMeshTemplate, T as recomputeMeshBounds, _ as createMeshFromGeometry, a as VEC3_ONE, b as createTorusMesh, c as VEC3_ZERO, d as cloneMeshUnderNode, f as collectSubtreeMeshes, g as createGroundMesh, h as createCylinderMesh, i as VEC3_LEFT, j as setMeshReceiveShadows, k as setMeshMaterial, l as Vec3, m as createCapsuleMesh, n as VEC3_DOWN, o as VEC3_RIGHT, p as createBoxMesh, r as VEC3_FORWARD, s as VEC3_UP, t as VEC3_BACKWARD, u as addMeshToScene, v as createPlaneMesh, w as readMeshBakeSurface, x as detachMeshBounds, y as createSphereMesh } from "./vec3-2C3LBZnt.js";
11
- import { a as LightProbeAsset, c as readLightProbeFile, d as writeLightProbeFile, i as LIGHT_PROBE_FORMAT_VERSION, l as readLightProbeGrid, n as LIGHT_PROBE_FILE_EXTENSIONS, o as createLightProbeAsset, r as LIGHT_PROBE_FILE_FORMAT, t as LIGHT_PROBE_ASSET_TYPE, u as sampleLightProbes } from "./light-probe-asset-BqfSrJe9.js";
12
- import { a as postEffectValuesCodec, i as declaredTextureBinding, n as POST_EFFECT_FUNCTION, r as customEffect, t as POST_EFFECT_BUILTIN_UNIFORMS } from "./post-effect-Cu3Enpz7.js";
13
- import { n as installOffscreenRenderPath } from "./render-path-D11i_7X8.js";
14
- import { a as SHADER_BLEND_MODES, c as SHADER_KINDS, d as SURFACE_HOOK_NAMES, f as SURFACE_UNIFORM_BLOCK, 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-5q__jycG.js";
15
- import { a as defineMaterialPlugin, i as MATERIAL_PLUGIN_SAMPLER_BUDGET, n as MATERIAL_PLUGIN_DEFAULT_PRIORITY, o as isLiteMaterialPluginPoint, r as MATERIAL_PLUGIN_RESERVED_NAMES, t as LITE_MATERIAL_PLUGIN_POINTS } from "./material-plugin-DapJNj04.js";
11
+ import { a as LightProbeAsset, c as readLightProbeFile, d as writeLightProbeFile, i as LIGHT_PROBE_FORMAT_VERSION, l as readLightProbeGrid, n as LIGHT_PROBE_FILE_EXTENSIONS, o as createLightProbeAsset, r as LIGHT_PROBE_FILE_FORMAT, t as LIGHT_PROBE_ASSET_TYPE, u as sampleLightProbes } from "./light-probe-asset-DGNIwKNb.js";
12
+ import { a as postEffectValuesCodec, i as declaredTextureBinding, n as POST_EFFECT_FUNCTION, r as customEffect, t as POST_EFFECT_BUILTIN_UNIFORMS } from "./post-effect-DEZD-r0I.js";
13
+ import { n as installOffscreenRenderPath } from "./render-path-CWXHrRa2.js";
14
+ import { a as SHADER_BLEND_MODES, c as SHADER_KINDS, d as SURFACE_HOOK_NAMES, f as SURFACE_UNIFORM_BLOCK, 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";
15
+ import { a as defineMaterialPlugin, i as MATERIAL_PLUGIN_SAMPLER_BUDGET, n as MATERIAL_PLUGIN_DEFAULT_PRIORITY, o as isLiteMaterialPluginPoint, r as MATERIAL_PLUGIN_RESERVED_NAMES, t as LITE_MATERIAL_PLUGIN_POINTS } from "./material-plugin-BBxIy6eo.js";
16
16
  import { acquireTexture, addTask, addToScene, buildFrameGraphTask, captureScreenshot, cloneTransformNode, createBloomPostProcessTask, createCsmDirectionalShadowGenerator, createDirectionalLight, createEngine, createEsmDirectionalShadowGenerator, createFontFromBuffer, createFreeCamera, createGpuPicker, createHemisphericLight, createImageProcessingTask, createMeshFromData, createNullEngine, createPcfDirectionalShadowGenerator, createPcfSpotlightShadowGenerator, createPointLight, createRenderTarget, createSceneContext, createSmaaPostProcessTask, createSpotLight, createStorageBuffer, createTexture2DFromPixels, disableOrthographicCamera, disposeEngine, disposePicker, disposeScene, disposeStorageBuffer, enableBoneControl, enableDeviceLostSceneRecovery, enableMaterialPlugins, enableMaterialStencil, enableOrthographicCamera, enablePbrLightmap, enableSkeletonShadows, enableStandardSkeleton, forceWebGpuDeviceLossForTesting, getEffectiveAspectRatio, getFrameGraph, getProjectionMatrix, getRenderTaskGpuTimings, getViewMatrix, getViewProjectionMatrix, isPbrMaterial, isShaderMaterial, loadTexture2D, onBeforeRender, pickAsync, rebuildSceneRenderables, registerScene, registerSceneWithShadowSupport, releaseTexture, removeFromScene, renderFrame, resizeEngine, resolveCameraViewport, setGpuTimingEnabled, setRenderTaskGpuTimingEnabled, setShadowTaskCasterMeshes, setSubtreeVisible, setSurfaceSize, startEngine, stopEngine, updateStorageBuffer, updateTexture2DFromPixels } from "@babylonjs/lite";
17
17
  //#region src/assets/types.ts
18
18
  /**
@@ -3903,7 +3903,7 @@ function createServiceKey(name) {
3903
3903
  *
3904
3904
  * @public
3905
3905
  */
3906
- const VERSION = "0.20.0";
3906
+ const VERSION = "0.21.1";
3907
3907
  //#endregion
3908
3908
  //#region src/assets/delivery-system.ts
3909
3909
  /**
@@ -4407,17 +4407,17 @@ function copyMatrix(source, out) {
4407
4407
  * entity moves the view, with no per-frame copy. Cinemachine-style rigs are scripts in `@ignifx/3d`
4408
4408
  * that drive that transform.
4409
4409
  *
4410
- * ## Decisions the documents left open
4410
+ * ## Decisions
4411
4411
  *
4412
- * - **`clearColor` is optional, not "default from scene settings".** §2.1's table says the default
4413
- * comes from the scene settings, which a plain colour field cannot express: every colour has a
4414
- * value. The field is `optional(color())` instead, so `null` means "leave the scene's clear
4415
- * colour alone" — whatever the `rendering.clearColor` setting or an `Environment` last put there
4416
- * — and a value means "this camera owns it while it is the main camera". The main camera is
4417
- * written every frame, so it is the strongest of the three (`RendererImpl.applyClearColor`).
4418
- * - **`cullingMask` is not declared at all.** §2.1 marks it post-1.0 (Lite has no per-camera mesh
4419
- * list yet) and §8 repeats it. A field that serialises but does nothing is worse than no field:
4420
- * it would round-trip through save files and quietly stop mattering when the feature lands.
4412
+ * - **`clearColor` is optional (§2.1).** A plain colour field cannot express "default from the
4413
+ * scene settings": every colour has a value. The field is `optional(color())`, so `null` means
4414
+ * "leave the scene's clear colour alone" — whatever the `rendering.clearColor` setting or an
4415
+ * `Environment` last put there — and a value means "this camera owns it while it is the main
4416
+ * camera". The main camera is written every frame, so it is the strongest of the three
4417
+ * (`RendererImpl.applyClearColor`).
4418
+ * - **`cullingMask` is not declared at all.** Lite has no per-camera mesh list. A field that
4419
+ * serialises but does nothing is worse than no field: it would round-trip through save files and
4420
+ * quietly stop mattering when the feature lands.
4421
4421
  *
4422
4422
  * ## Headless
4423
4423
  *
@@ -5090,11 +5090,11 @@ function installLoadedEnvironment(scene, textures) {
5090
5090
  *
5091
5091
  * ## `ambientColor` does not exist
5092
5092
  *
5093
- * §2.5 lists an `ambientColor` field. Babylon Lite 1.27.0 has no scene-level ambient term:
5094
- * `ambientColor` appears once in `index.d.ts`, on `StandardMaterialProps`, and `SceneContext`
5095
- * declares nothing of the kind. A field that mapped onto nothing would serialise into save files
5096
- * and quietly start mattering when the mapping appeared, so the component does not declare one. The
5097
- * flat term a project wants from it is a hemispheric `Light`, which Lite does have.
5093
+ * Babylon Lite 1.27.0 has no scene-level ambient term: `ambientColor` appears once in `index.d.ts`,
5094
+ * on `StandardMaterialProps`, and `SceneContext` declares nothing of the kind. A field that mapped
5095
+ * onto nothing would serialise into save files and quietly start mattering when the mapping
5096
+ * appeared, so the component does not declare one. The flat term a project wants from it is a
5097
+ * hemispheric `Light`, which Lite does have.
5098
5098
  *
5099
5099
  * ## Headless
5100
5100
  *
@@ -5466,7 +5466,7 @@ let layer$1 = null;
5466
5466
  * @internal
5467
5467
  */
5468
5468
  async function loadInstancedMeshSupport() {
5469
- const loaded = layer$1 ?? await import("./instanced-mesh-instance-B-fXKSrY.js");
5469
+ const loaded = layer$1 ?? await import("./instanced-mesh-instance-BLdAJTj8.js");
5470
5470
  layer$1 = loaded;
5471
5471
  return loaded;
5472
5472
  }
@@ -5494,7 +5494,7 @@ let surfaceLayer = null;
5494
5494
  * @internal
5495
5495
  */
5496
5496
  async function loadShaderSupport() {
5497
- const loaded = shaderLayer ?? await import("./shader-material-TM4f8eKA.js").then((n) => n.n);
5497
+ const loaded = shaderLayer ?? await import("./shader-material-C9sYMGWw.js").then((n) => n.n);
5498
5498
  shaderLayer = loaded;
5499
5499
  await loaded.loadShaderMaterialAdapter();
5500
5500
  return loaded;
@@ -5517,7 +5517,7 @@ function shaderSupport() {
5517
5517
  * @internal
5518
5518
  */
5519
5519
  async function loadSurfaceShaderSupport() {
5520
- const loaded = surfaceLayer ?? await import("./surface-shader-rpPpeosD.js");
5520
+ const loaded = surfaceLayer ?? await import("./surface-shader-BfADq9Wx.js");
5521
5521
  surfaceLayer = loaded;
5522
5522
  return loaded;
5523
5523
  }
@@ -5550,7 +5550,7 @@ function surfaceShaderSupport() {
5550
5550
  * - **`"type": "shader"` is values applied to a `ShaderAsset`.** §2.6 lists the family, and the
5551
5551
  * WGSL attribute, uniform, sampler, storage, define, and pipeline layout is declared by the
5552
5552
  * `.wgsl` file's own `// @ignifx` pragmas rather than by the material file
5553
- * (`src/render/shader-pragma.ts`, `docs/plan/2026-09-terrain-particles-shaders.md` §3.1). So a
5553
+ * (`src/render/shader-pragma.ts`, ADR-0024). So a
5554
5554
  * shader `.material.json` names the shader, the values, the textures, and the defines, and
5555
5555
  * nothing about Babylon Lite's `ShaderMaterialOptions` reaches the public API
5556
5556
  * (`CONSTITUTION.md` §3.4). `IGX-0708` is still what an unknown `type` string produces.
@@ -5729,7 +5729,7 @@ var MaterialAsset = class {
5729
5729
  }
5730
5730
  /**
5731
5731
  * The surface shaders layered onto this material, in the order they were attached
5732
- * (`docs/plan/2026-09-terrain-particles-shaders.md` §3.2).
5732
+ * (ADR-0024).
5733
5733
  *
5734
5734
  * @returns The bindings, or an empty array.
5735
5735
  */
@@ -7302,7 +7302,7 @@ function disposeScenePicker(picker) {
7302
7302
  *
7303
7303
  * - `isGpuTimingSupported` and `getRenderTaskGpuTimings` both check
7304
7304
  * `engine._device.features.has("timestamp-query")` (`lib/engine/gpu-task-timing.js`). Chromium's
7305
- * SwiftShader now offers that feature too (GI spike S4, 2026-11-02), but its timings measure a
7305
+ * SwiftShader now offers that feature too (2026-11-02), but its timings measure a
7306
7306
  * software rasteriser, so coding standards §10 still skips GPU-timing assertions there; real
7307
7307
  * numbers come from the host-GPU `gpu-budget` project (§7).
7308
7308
  * - `setSurfaceSize` writes `canvas.width`/`canvas.height` (`lib/engine/surface.js`), and a null
@@ -7482,8 +7482,8 @@ function captureFrame(surface) {
7482
7482
  //#endregion
7483
7483
  //#region src/lite/gpu/warm-up.ts
7484
7484
  /**
7485
- * Material warm-up (`docs/architecture/07-rendering.md` §1.1, ADR-0014). Spike S2.2 measured what
7486
- * "warming up" has to mean in Babylon Lite; this module is the answer.
7485
+ * Material warm-up (`docs/architecture/07-rendering.md` §1.1, ADR-0014). ADR-0002 Validation
7486
+ * records what "warming up" has to mean in Babylon Lite; this module is the answer.
7487
7487
  *
7488
7488
  * Everything here is `@internal`, and it needs a device.
7489
7489
  *
@@ -8554,7 +8554,7 @@ function toSpotConfig(settings) {
8554
8554
  //#endregion
8555
8555
  //#region src/render/gpu/light-probe-host.ts
8556
8556
  /**
8557
- * The renderer's handle on light probes (GI B2): it loads the light-probe chunk (`./light-probes.ts`)
8557
+ * The renderer's handle on light probes: it loads the light-probe chunk (`./light-probes.ts`)
8558
8558
  * the first frame a world has a `LightProbeVolume` and forwards every frame to it. Device-only, like
8559
8559
  * the rest of `src/render/gpu/`: a headless renderer never creates one.
8560
8560
  *
@@ -8599,7 +8599,7 @@ var LightProbeHost = class {
8599
8599
  }
8600
8600
  if (volumes.length === 0 || this.#isLoading || this.#isDisposed) return;
8601
8601
  this.#isLoading = true;
8602
- import("./light-probes-DDojYajw.js").then((module) => module.createLightProbeRuntime(this.#engine, this.#scene)).then((created) => {
8602
+ import("./light-probes-C8jharz9.js").then((module) => module.createLightProbeRuntime(this.#engine, this.#scene)).then((created) => {
8603
8603
  if (this.#isDisposed) {
8604
8604
  created.dispose();
8605
8605
  return;
@@ -8617,7 +8617,7 @@ var LightProbeHost = class {
8617
8617
  //#endregion
8618
8618
  //#region src/render/lightmap-asset.ts
8619
8619
  /**
8620
- * Lightmaps (`docs/plan/2026-11-gi-phase-2-execution-plan.md`, step B3): a baked texture that static
8620
+ * Lightmaps (`docs/architecture/07-rendering.md` §2.15): a baked texture that static
8621
8621
  * `MeshRenderer`s sample through their second UV set, and the per-entity placement of each renderer
8622
8622
  * in it. Everything here is plain data and runs in Node; the GPU half is `./gpu/lightmaps.ts`.
8623
8623
  */
@@ -8871,7 +8871,7 @@ function invalid(address, problem) {
8871
8871
  //#endregion
8872
8872
  //#region src/render/gpu/lightmap-host.ts
8873
8873
  /**
8874
- * The renderer's handle on lightmaps (GI B3): it decides whether a `MeshRenderer` samples its
8874
+ * The renderer's handle on lightmaps: it decides whether a `MeshRenderer` samples its
8875
8875
  * lightmap, loads the lightmap chunk (`./lightmaps.ts`) the first time one does, and hands the
8876
8876
  * renderer its lightmapped material. Device-only, like the rest of `src/render/gpu/`: only a
8877
8877
  * renderer with a clone in the scene asks.
@@ -9018,7 +9018,7 @@ function hasSecondUvSet(owner) {
9018
9018
  //#endregion
9019
9019
  //#region src/render/gpu/reflection-probe-host.ts
9020
9020
  /**
9021
- * The renderer's handle on reflection probes (GI B1): it loads the probe chunk
9021
+ * The renderer's handle on reflection probes: it loads the probe chunk
9022
9022
  * (`./reflection-probes.ts`) the first frame a world has a probe and forwards every frame to it.
9023
9023
  * Device-only, like the rest of `src/render/gpu/`: a headless renderer never creates one.
9024
9024
  *
@@ -9074,7 +9074,7 @@ var ReflectionProbeHost = class {
9074
9074
  }
9075
9075
  if (probes.length === 0 || !hasEnvironment || this.#isLoading || this.#isDisposed) return;
9076
9076
  this.#isLoading = true;
9077
- import("./reflection-probes-CAzSuqf8.js").then(async (module) => module.createReflectionProbeRuntime(this.#engine, this.#scene, this.#warn)).then((created) => {
9077
+ import("./reflection-probes-BMVQfbhm.js").then(async (module) => module.createReflectionProbeRuntime(this.#engine, this.#scene, this.#warn)).then((created) => {
9078
9078
  if (this.#isDisposed) {
9079
9079
  created.dispose();
9080
9080
  return;
@@ -9136,7 +9136,7 @@ function createPicker(scene) {
9136
9136
  * @internal
9137
9137
  */
9138
9138
  async function loadOverlayOpener() {
9139
- return (await import("./overlay-CjVgsfrm.js")).openOverlayScene;
9139
+ return (await import("./overlay-DokHzP6_.js")).openOverlayScene;
9140
9140
  }
9141
9141
  /**
9142
9142
  * Picks the object under one backing-store pixel, optionally restricted to the meshes a predicate
@@ -9500,16 +9500,16 @@ function saturate(value) {
9500
9500
  * `07-rendering.md` §1 and §1.1): the engine options the swapchain is created with, and the feature
9501
9501
  * opt-ins that have to be applied before the scene is registered.
9502
9502
  *
9503
- * Three decisions the documents left open, and one place they are wrong:
9503
+ * Four decisions this section makes:
9504
9504
  *
9505
- * - **There is no `powerPreference`.** `07-rendering.md` §1 lists it among "engine options exposed
9506
- * by `createApp`". Babylon Lite 1.27.0 has no such option — `lib/engine/engine.js` hard-codes
9505
+ * - **There is no `powerPreference`** (`07-rendering.md` §1). Babylon Lite 1.27.0 has no such
9506
+ * option — `lib/engine/engine.js` hard-codes
9507
9507
  * `requestAdapter({ powerPreference: "high-performance" })` and neither `EngineOptions`
9508
9508
  * (`index.d.ts` 4709) nor `SurfaceOptions` (12622) declares it — so ignifx does not expose one.
9509
- * The correction is recorded in `src/lite/render-diagnostics.ts` as well.
9510
- * - **`maxDevicePixelRatio` defaults to `0`, not `Infinity`.** §1 says the default is "`Infinity`,
9511
- * i.e. native DPR", and that is the behaviour; but a settings section is validated JSON, and
9512
- * `Infinity` is not a JSON number (`06-serialization-and-scene-format.md` §3 rejects non-finite
9509
+ * `src/lite/render-diagnostics.ts` records it as well.
9510
+ * - **`maxDevicePixelRatio` defaults to `0`, not `Infinity`** (§1). The default behaviour is native
9511
+ * DPR; but a settings section is validated JSON, and `Infinity` is not a JSON number
9512
+ * (`06-serialization-and-scene-format.md` §3 rejects non-finite
9513
9513
  * values with `IGX-0601`). `0` is the spelling of "do not clamp", and it is what the section
9514
9514
  * documents.
9515
9515
  * - **`brdfLut` lives here.** Lite's `loadEnvironment` takes a **required** `brdfUrl`
@@ -10166,13 +10166,13 @@ var RendererImpl = class {
10166
10166
  #sceneInputsHost = null;
10167
10167
  /** The GTAO pass (`../lite/gpu/gtao.ts`), when `rendering.ambientOcclusion` is on. */
10168
10168
  #ambientOcclusion = null;
10169
- /** The reflection probes' host, created on the first frame of a canvas-backed app (GI B1). */
10169
+ /** The reflection probes' host, created on the first frame of a canvas-backed app. */
10170
10170
  #reflectionProbes = null;
10171
10171
  /** Detaches the reflection probes' `onDeviceLost` and `onDeviceRecovered` handlers. */
10172
10172
  #disconnectProbeDeviceLoss = null;
10173
- /** The light probes' host, created with the reflection probes' one (GI B2). */
10173
+ /** The light probes' host, created with the reflection probes' one. */
10174
10174
  #lightProbes = null;
10175
- /** The lightmaps' host, created when the first renderer with a clone asks for its material (GI B3). */
10175
+ /** The lightmaps' host, created when the first renderer with a clone asks for its material. */
10176
10176
  #lightmaps = null;
10177
10177
  /** The TAA passes (`../lite/gpu/taa.ts`), when `rendering.taa` installed them. */
10178
10178
  #taa = null;
@@ -10319,7 +10319,7 @@ var RendererImpl = class {
10319
10319
  async acquireSceneInputs() {
10320
10320
  if (this.isHeadless || this.#isDisposed) return null;
10321
10321
  const { engine, scene } = this;
10322
- this.#sceneInputs ??= import("./scene-inputs-BxGOsnIZ.js").then((module) => {
10322
+ this.#sceneInputs ??= import("./scene-inputs-_0j2Hi6L.js").then((module) => {
10323
10323
  const host = module.createSceneInputsHost(engine, scene);
10324
10324
  this.#sceneInputsHost = host;
10325
10325
  if (this.#isDisposed) host.dispose();
@@ -10328,7 +10328,7 @@ var RendererImpl = class {
10328
10328
  return (await this.#sceneInputs).acquire(this.#isSceneRegistered);
10329
10329
  }
10330
10330
  /**
10331
- * Installs temporal anti-aliasing when `rendering.taa.enabled` is on (GI plan steps G5–G6).
10331
+ * Installs temporal anti-aliasing when `rendering.taa.enabled` is on.
10332
10332
  *
10333
10333
  * @remarks
10334
10334
  * Loads the `taa` chunk and leases the scene inputs only then. TAA needs the HDR render path;
@@ -10347,7 +10347,7 @@ var RendererImpl = class {
10347
10347
  this.#app.log.warn("rendering.taa needs rendering.hdr; temporal anti-aliasing stays off.");
10348
10348
  return;
10349
10349
  }
10350
- const module = await import("./taa-BwBZLy11.js");
10350
+ const module = await import("./taa-nxVA78Ur.js");
10351
10351
  const inputs = await this.acquireSceneInputs();
10352
10352
  if (inputs === null) return;
10353
10353
  this.#taa = module.installTemporalAntiAliasing(this.engine, this.scene, hdr, inputs, options, this.#isSceneRegistered);
@@ -10966,7 +10966,7 @@ var RendererImpl = class {
10966
10966
  */
10967
10967
  async #installAmbientOcclusion() {
10968
10968
  const settings = resolveAmbientOcclusion(this.settings.ambientOcclusion);
10969
- const [module, inputs] = await Promise.all([import("./gtao-Bpu5-0Ne.js"), this.acquireSceneInputs()]);
10969
+ const [module, inputs] = await Promise.all([import("./gtao-BmdrXXJz.js"), this.acquireSceneInputs()]);
10970
10970
  if (inputs === null) return;
10971
10971
  if (this.#isDisposed) {
10972
10972
  inputs.release();
@@ -11003,12 +11003,11 @@ var RendererImpl = class {
11003
11003
  this.#ambientOcclusion?.update(this.#isSceneRegistered);
11004
11004
  }
11005
11005
  /**
11006
- * The baked-lighting components' per-frame work (GI Phase 2): `ReflectionProbe` (B1) captures
11007
- * what is due and points each lit PBR material at its probe; `LightProbeVolume` (B2) keeps the
11008
- * winning grid on every lit PBR material; lightmaps (B3) rebuild the material copies the
11009
- * `MeshRenderer`s took this frame. Each loads its own chunk the first time a world has one
11010
- * of its components. The `PreRender` system calls it every frame; it does nothing on a headless
11011
- * app.
11006
+ * The baked-lighting components' per-frame work: `ReflectionProbe` captures what is due and
11007
+ * points each lit PBR material at its probe; `LightProbeVolume` keeps the winning grid on every
11008
+ * lit PBR material; lightmaps rebuild the material copies the `MeshRenderer`s took this frame.
11009
+ * Each loads its own chunk the first time a world has one of its components. The `PreRender`
11010
+ * system calls it every frame; it does nothing on a headless app.
11012
11011
  *
11013
11012
  * @param world - The world being reconciled.
11014
11013
  * @param probes - Every `ReflectionProbe` in it.
@@ -11060,7 +11059,7 @@ var RendererImpl = class {
11060
11059
  }
11061
11060
  /**
11062
11061
  * The material a `MeshRenderer` draws with this frame: its own lightmapped copy of `base` when it
11063
- * samples a lightmap (GI B3), else `base`'s. Only a renderer with a clone in the scene asks, so
11062
+ * samples a lightmap, else `base`'s. Only a renderer with a clone in the scene asks, so
11064
11063
  * never a headless one.
11065
11064
  *
11066
11065
  * @param owner - The renderer.
@@ -11463,7 +11462,7 @@ function overlayAfterDisposeError() {
11463
11462
  //#region src/render/instanced-mesh-renderer.ts
11464
11463
  /**
11465
11464
  * One mesh, one draw call, thousands of world matrices
11466
- * (`docs/plan/2026-09-terrain-particles-shaders.md` §3.5).
11465
+ * (`docs/architecture/07-rendering.md` §2.9).
11467
11466
  *
11468
11467
  * The matrix slab stays the caller's: Babylon Lite keeps the reference and never copies
11469
11468
  * (`lib/mesh/thin-instance.js`), so it has to stay alive and at least `count * 16` floats long, and
@@ -11509,8 +11508,8 @@ function noMatrices() {
11509
11508
  return emptySlab;
11510
11509
  }
11511
11510
  /**
11512
- * Draws one mesh many times from a caller-owned matrix slab, in a single draw call (the plan's
11513
- * §3.5).
11511
+ * Draws one mesh many times from a caller-owned matrix slab, in a single draw call
11512
+ * (`docs/architecture/07-rendering.md` §2.9).
11514
11513
  *
11515
11514
  * @example
11516
11515
  * ```ts
@@ -11936,7 +11935,7 @@ function instancedMeshRendererSchema() {
11936
11935
  //#region src/render/light-probe-volume.ts
11937
11936
  /**
11938
11937
  * Lights PBR materials with a baked light-probe grid instead of the scene environment's diffuse
11939
- * light (`docs/plan/2026-11-gi-phase-2-execution-plan.md`, step B2).
11938
+ * light (`docs/architecture/07-rendering.md` §2.15).
11940
11939
  *
11941
11940
  * @remarks
11942
11941
  * Every lit PBR material samples the grid per pixel, blending the eight probes around it, so moving
@@ -13429,8 +13428,8 @@ function createFontLoader() {
13429
13428
  //#endregion
13430
13429
  //#region src/render/loaders/light-probe-loader.ts
13431
13430
  /**
13432
- * Builds the loader for `.probes.json` light-probe grids (GI Phase 2, step B2). It needs no device,
13433
- * so a grid loads in Node too.
13431
+ * Builds the loader for `.probes.json` light-probe grids. It needs no device, so a grid loads in
13432
+ * Node too.
13434
13433
  *
13435
13434
  * @returns The loader to register with `ctx.registerAssetLoader`.
13436
13435
  *
@@ -14044,9 +14043,8 @@ function readString$2(block, key, fallback) {
14044
14043
  //#endregion
14045
14044
  //#region src/render/loaders/lightmap-loader.ts
14046
14045
  /**
14047
- * Builds the loader for `.lightmap.json` lightmaps (GI Phase 2, step B3). The texture the file names
14048
- * loads as a dependency, so it is released with the lightmap; a texture that fails to load fails
14049
- * the lightmap.
14046
+ * Builds the loader for `.lightmap.json` lightmaps. The texture the file names loads as a
14047
+ * dependency, so it is released with the lightmap; a texture that fails to load fails the lightmap.
14050
14048
  *
14051
14049
  * @returns The loader to register with `ctx.registerAssetLoader`.
14052
14050
  *
@@ -14140,8 +14138,8 @@ const SURFACE_PRIORITY = 500;
14140
14138
  * `// @ignifx` declarations, and an undeclared name (`IGX-0712`) or a value of the wrong shape
14141
14139
  * (`IGX-0713`) fails the load. A PBR property that does not exist is a typo with an obvious
14142
14140
  * fallback — the default; a uniform that does not exist has none, and a shader that silently
14143
- * ignores half its material is the failure mode custom shaders are hardest to debug from
14144
- * (`docs/plan/2026-09-terrain-particles-shaders.md` §3.1). The same file is checked at build time
14141
+ * ignores half its material is the failure mode custom shaders are hardest to debug from.
14142
+ * The same file is checked at build time
14145
14143
  * by `@ignifx/vite-plugin`, so this is the last line rather than the first.
14146
14144
  *
14147
14145
  * ```jsonc
@@ -16133,7 +16131,7 @@ let effectLayer = null;
16133
16131
  * @internal
16134
16132
  */
16135
16133
  async function loadPostEffectSupport() {
16136
- const [compiler, effects] = await Promise.all([compilerLayer ?? import("./post-effect-compiler-cCq9lcHt.js"), effectLayer ?? import("./effect-task-CMbuO6Kb.js")]);
16134
+ const [compiler, effects] = await Promise.all([compilerLayer ?? import("./post-effect-compiler-unDD3hod.js"), effectLayer ?? import("./effect-task-CMbuO6Kb.js")]);
16137
16135
  compilerLayer = compiler;
16138
16136
  effectLayer = effects;
16139
16137
  }
@@ -16161,7 +16159,7 @@ function effectTaskSupport() {
16161
16159
  //#region src/render/shader-asset.ts
16162
16160
  /**
16163
16161
  * One `.wgsl` file: its text and the declaration its `// @ignifx` pragmas carry
16164
- * (`docs/plan/2026-09-terrain-particles-shaders.md` §3.1, ADR-0024).
16162
+ * (ADR-0024).
16165
16163
  *
16166
16164
  * The asset is the program plus the schema of what a material may set on it, never the values. It
16167
16165
  * needs no device, so a `.wgsl` loads completely in Node. Two facts an author has to know:
@@ -16190,7 +16188,7 @@ const SHADER_ASSET_TYPE = "shader";
16190
16188
  const SHADER_FILE_EXTENSIONS = Object.freeze([".wgsl"]);
16191
16189
  /**
16192
16190
  * A loaded `.wgsl` file: its source and what its pragmas declare
16193
- * (`docs/plan/2026-09-terrain-particles-shaders.md` §3.1).
16191
+ * (ADR-0024).
16194
16192
  *
16195
16193
  * @remarks
16196
16194
  * Shaders are shared: many materials reference one shader asset, and each material holds its own
@@ -16241,7 +16239,7 @@ var ShaderAsset = class {
16241
16239
  //#region src/render/loaders/shader-loader.ts
16242
16240
  /**
16243
16241
  * The `shader` asset loader: `.wgsl` to `ShaderAsset`
16244
- * (`docs/plan/2026-09-terrain-particles-shaders.md` §3.1).
16242
+ * (ADR-0024).
16245
16243
  *
16246
16244
  * One loader covers all three forms, because `.surface.wgsl` and `.post.wgsl` both end in `.wgsl`;
16247
16245
  * the `@ignifx shader|surface|post` pragma is what says which form a file is.
@@ -16271,7 +16269,7 @@ function createShaderLoader() {
16271
16269
  type: SHADER_ASSET_TYPE,
16272
16270
  extensions: SHADER_FILE_EXTENSIONS,
16273
16271
  async load(ctx) {
16274
- const [source, pragma] = await Promise.all([ctx.fetchText(), import("./shader-pragma-ljmAbVc2.js")]);
16272
+ const [source, pragma] = await Promise.all([ctx.fetchText(), import("./shader-pragma-D0MjCOIg.js")]);
16275
16273
  const declaration = pragma.parseShaderDeclaration(source, ctx.address);
16276
16274
  await loadShaderSupport();
16277
16275
  if (declaration.kind === "surface") await loadSurfaceShaderSupport();
@@ -16417,8 +16415,8 @@ function loadByContainer(container, address, engine, url, options) {
16417
16415
  *
16418
16416
  * Every line here needs a WebGPU device: a clone only exists when the template does, and a template
16419
16417
  * only exists when the engine uploaded its buffers. That is why the module lives under
16420
- * `src/render/gpu/`, the render layer's half of the rule R1 established for `src/lite/gpu/`: the
16421
- * root Vitest coverage config excludes both, and the browser project is what measures them.
16418
+ * `src/render/gpu/`, the render layer's counterpart of `src/lite/gpu/`: the root Vitest coverage
16419
+ * config excludes both, and the browser project is what measures them.
16422
16420
  *
16423
16421
  * The per-field "did it change" cache lives here rather than on the component for the same reason.
16424
16422
  * It is only consulted when there is something to write to, so leaving it on the component would
@@ -17053,17 +17051,16 @@ var ModelInstance = class {
17053
17051
  * case that actually needs an entity inside the model — a weapon in a hand — by parenting an
17054
17052
  * entity's node under a glTF node, which makes it follow that bone with no per-frame copy.
17055
17053
  *
17056
- * ## Decisions the documents left open
17054
+ * ## Decisions
17057
17055
  *
17058
- * - **glTF cameras and lights are ignored, and there is no way to ask otherwise.** §2.4 says
17059
- * they are imported only when `importLights`/`importCameras` are set in the asset's
17060
- * `.meta.json`. Lite gates cameras behind a process-global `enableGltfCameras()` that must run
17061
- * before the **first** load (`src/lite/render-features.ts`), so a per-asset sidecar flag cannot
17062
- * decide it: whichever asset loads first would fix the answer for every later one. Rather than
17063
- * ship a flag that silently means "whatever the first model wanted", ignifx imports neither and
17064
- * the adapter keeps `enableGltfCameraImport` ready for a project-level setting that no delivered
17065
- * phase has added. Lights inside a container are shallow-copied by Lite's own clone and are not added to
17066
- * the scene by ignifx, so they never light anything.
17056
+ * - **glTF cameras and lights are ignored, and there is no way to ask otherwise (§2.4).** Lite
17057
+ * gates cameras behind a process-global `enableGltfCameras()` that must run before the **first**
17058
+ * load (`src/lite/render-features.ts`), so a per-asset sidecar flag cannot decide it: whichever
17059
+ * asset loads first would fix the answer for every later one. Rather than ship a flag that
17060
+ * silently means "whatever the first model wanted", ignifx imports neither and the adapter keeps
17061
+ * `enableGltfCameraImport` ready for a project-level setting that does not exist yet. Lights
17062
+ * inside a container are shallow-copied by Lite's own clone and are not added to the scene by
17063
+ * ignifx, so they never light anything.
17067
17064
  * - **`materialOverrides` matches on the glTF material *name*.** §2.4 says "by material name",
17068
17065
  * which is the only stable identifier a glTF gives a material. The component records the map and
17069
17066
  * applies it to the nodes whose material carries that name; a name nothing matches is ignored.
@@ -17839,7 +17836,7 @@ var PostProcessChain = class {
17839
17836
  }
17840
17837
  /**
17841
17838
  * Under `rendering.hdr`, records the custom effects ordered before any built-in one ahead of the
17842
- * output pass, where they read and write linear `rgba16float` colour (GI plan step G3).
17839
+ * output pass, where they read and write linear `rgba16float` colour.
17843
17840
  *
17844
17841
  * @remarks
17845
17842
  * The first reads the scene's HDR texture directly, which is already a sampled `Texture2D`, so no
@@ -18087,7 +18084,7 @@ let loading = null;
18087
18084
  * @internal
18088
18085
  */
18089
18086
  async function loadHdrBloomSupport() {
18090
- loading ??= import("./bloom-hdr-CLtQj-oY.js").then((module) => {
18087
+ loading ??= import("./bloom-hdr-xPwkIdHG.js").then((module) => {
18091
18088
  layer = module;
18092
18089
  return module;
18093
18090
  });
@@ -18197,7 +18194,7 @@ var ScreenSpaceEffects = class {
18197
18194
  async #build(renderer, contact, ssgi, generation) {
18198
18195
  const [inputs, wiring, contactModule, ssgiModule] = await Promise.all([
18199
18196
  renderer.acquireSceneInputs(),
18200
- import("./scene-color-passes-B93qTOka.js"),
18197
+ import("./scene-color-passes-DgXJ45Ql.js"),
18201
18198
  contact === null ? null : import("./contact-shadows-T523EXaP.js"),
18202
18199
  ssgi === null ? null : import("./ssgi-DSnhqotl.js")
18203
18200
  ]);
@@ -19208,7 +19205,7 @@ var RenderSyncSystem = class {
19208
19205
  //#region src/render/shader-uniform-system.ts
19209
19206
  /**
19210
19207
  * The `PreRender` system that writes the ignifx-provided uniforms of every live shader material
19211
- * (`docs/plan/2026-09-terrain-particles-shaders.md` §3.1).
19208
+ * (ADR-0024).
19212
19209
  *
19213
19210
  * Lite's shader materials get transforms, the camera position, the screen size and the alpha cutoff
19214
19211
  * for free and nothing else — no clock, no lights, no shadows (`index.d.ts` 11432) — so a file that
@@ -19301,9 +19298,8 @@ var ShaderUniformSystem = class {
19301
19298
  * @remarks
19302
19299
  * The direction is the entity's world forward axis, read out of the world matrix's third column —
19303
19300
  * the same axis `Light` itself writes onto the Lite light
19304
- * (`docs/architecture/07-rendering.md` §2.2) — and normalised, which the plan's §3.1 promises and
19305
- * a scaled light entity would otherwise break. Lite's own PBR normalises in WGSL, so the two
19306
- * agree.
19301
+ * (`docs/architecture/07-rendering.md` §2.2) — and normalised, which a scaled light entity would
19302
+ * otherwise break. Lite's own PBR normalises in WGSL, so the two agree.
19307
19303
  *
19308
19304
  * @param world - The world being rendered.
19309
19305
  * @returns `true` when a light supplied the values; `false` after zeroing them.
@@ -19454,7 +19450,7 @@ function freeStorageBuffer(buffer) {
19454
19450
  //#endregion
19455
19451
  //#region src/render/storage-buffer-asset.ts
19456
19452
  /**
19457
- * `StorageBufferAsset` (`docs/plan/2026-09-terrain-particles-shaders.md` §2.2): a read-only GPU
19453
+ * `StorageBufferAsset` (`docs/architecture/07-rendering.md` §2.9): a read-only GPU
19458
19454
  * buffer a custom WGSL shader indexes, addressed and reference-counted like any other asset.
19459
19455
  *
19460
19456
  * Babylon Lite 1.27.0 binds storage buffers as `var<storage,read>` and exposes no compute dispatch,
@@ -19477,7 +19473,7 @@ const STORAGE_BUFFER_ASSET_TYPE = "storagebuffer";
19477
19473
  const WORD_BYTES = 4;
19478
19474
  /**
19479
19475
  * A read-only GPU buffer a custom shader indexes
19480
- * (`docs/plan/2026-09-terrain-particles-shaders.md` §2.2).
19476
+ * (`docs/architecture/07-rendering.md` §2.9).
19481
19477
  *
19482
19478
  * @remarks
19483
19479
  * Bind it to a material with `MaterialAsset.setStorageBuffer(name, handle)`, where `name` is a
@@ -23383,7 +23379,7 @@ function registerCore(ctx) {
23383
23379
  }
23384
23380
  /**
23385
23381
  * Registers the rendering layer: the `rendering` settings section, the service behind
23386
- * `app.renderer`, the five components `docs/architecture/04-extensions.md` §7 lists, the GPU asset
23382
+ * `app.renderer`, the components `docs/architecture/04-extensions.md` §7 lists, the GPU asset
23387
23383
  * loaders, and the `PreRender` system that reconciles them with the Lite scene.
23388
23384
  *
23389
23385
  * @remarks
@@ -25595,7 +25591,7 @@ async function createRenderEngine(canvas, options, features) {
25595
25591
  if (hdr) {
25596
25592
  const knobs = features.autoExposure ?? null;
25597
25593
  const exposure = knobs === null ? null : await import("./auto-exposure-uzPn0beO.js");
25598
- presenter = (await import("./hdr-output-DBQwMphy.js")).installHdrRenderPath(engine, scene, exposure === null || knobs === null ? void 0 : (hdrTexture) => exposure.installAutoExposure(engine, scene, hdrTexture, knobs));
25594
+ presenter = (await import("./hdr-output-_2TU-jWy.js")).installHdrRenderPath(engine, scene, exposure === null || knobs === null ? void 0 : (hdrTexture) => exposure.installAutoExposure(engine, scene, hdrTexture, knobs));
25599
25595
  } else if (offscreen) presenter = installOffscreenRenderPath(engine, scene);
25600
25596
  return {
25601
25597
  engine,
@@ -27209,8 +27205,8 @@ function createFileSystemBackend(fs, directory) {
27209
27205
  *
27210
27206
  * @remarks
27211
27207
  * Node only: the factory loads `node:fs/promises` and rejects on a host that has none. It is what
27212
- * `createApp({ storage: { directory } })` calls, and it is exported so that tooling — `ignifx bake`,
27213
- * a future authoritative server — can build one without an app.
27208
+ * `createApp({ storage: { directory } })` calls, and it is exported so that tooling can build one
27209
+ * without an app.
27214
27210
  *
27215
27211
  * @param options - The root directory.
27216
27212
  * @returns The backend.
@@ -34497,8 +34493,8 @@ function gridIndices(rows, columns) {
34497
34493
  //#endregion
34498
34494
  //#region src/render/light-probe-bake.ts
34499
34495
  /**
34500
- * The CPU light-probe bake (`docs/plan/2026-11-gi-phase-2-execution-plan.md`, step B4): one bounce
34501
- * of diffuse light, needing no device, so it runs headless, in a tool, or in a test.
34496
+ * The CPU light-probe bake (`docs/architecture/07-rendering.md` §2.15): one bounce of diffuse
34497
+ * light, needing no device, so it runs headless, in a tool, or in a test.
34502
34498
  *
34503
34499
  * - **Geometry.** Triangles of every enabled `MeshRenderer` (a `MeshAsset.fromData` mesh's own
34504
34500
  * arrays, or a primitive rebuilt on the CPU by `light-probe-bake-primitives.ts`) and every enabled
@@ -35405,9 +35401,9 @@ function transformSchema() {
35405
35401
  * their `format`. A *file* format is not a component and has no type id, so the file formats
35406
35402
  * below are keyed `ignifx/scene-file`, `ignifx/material-file`, `ignifx/environment-file`, and
35407
35403
  * `ignifx/mesh-file` while declaring `format: "ignifx.scene"`, `"ignifx.material"`,
35408
- * `"ignifx.environment"`, and `"ignifx.mesh"`. The wave-1
35409
- * hand-off asked for the key `"ignifx.scene"`; that key fails the namespacing check, and the
35410
- * grouping — which is what actually decides the page — comes from `format` either way.
35404
+ * `"ignifx.environment"`, and `"ignifx.mesh"`. A key of `"ignifx.scene"` would fail the namespacing
35405
+ * check, and the grouping — which is what actually decides the page — comes from `format` either
35406
+ * way.
35411
35407
  *
35412
35408
  * ## The transform
35413
35409
  *
@@ -35756,7 +35752,7 @@ function describeMeshFileFormat() {
35756
35752
  };
35757
35753
  }
35758
35754
  /**
35759
- * Describes the `.probes.json` light-probe grid format (GI Phase 2, step B2).
35755
+ * Describes the `.probes.json` light-probe grid format.
35760
35756
  *
35761
35757
  * @returns The description of the top-level file fields.
35762
35758
  *
@@ -35814,7 +35810,7 @@ function describeLightProbeFileFormat() {
35814
35810
  };
35815
35811
  }
35816
35812
  /**
35817
- * Describes the `.lightmap.json` lightmap format (GI Phase 2, step B3).
35813
+ * Describes the `.lightmap.json` lightmap format.
35818
35814
  *
35819
35815
  * @returns The description of the top-level file fields.
35820
35816
  *