@carbonenginejs/runtime-trinity 0.6.0 → 0.7.0

package/dist/eve/volume/EveSphereVolume.js.map

@@ -1 +1 @@
-{"version":3,"file":"EveSphereVolume.js","sources":["../../../../src/eve/volume/EveSphereVolume.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\Eve\\Volume\\EveSphereVolume.h\r\n// Source: E:\\carbonengine\\trinity\\trinity\\Eve\\Volume\\EveSphereVolume.cpp\r\n// Source: E:\\carbonengine\\trinity\\trinity\\Eve\\Volume\\EveSphereVolume_Blue.cpp\r\nimport { vec3 } from \"@carbonenginejs/runtime-utils/vec3\";\r\nimport { CjsModel } from \"@carbonenginejs/runtime-utils/model\";\r\nimport { carbon, impl, io, type } from \"@carbonenginejs/runtime-utils/schema\";\r\n\r\n\r\n@type.define({\r\n  className: \"EveSphereVolume\",\r\n  family: \"eve/volume\"\r\n})\r\nexport class EveSphereVolume extends CjsModel\r\n{\r\n  @io.notify\r\n  @io.persist\r\n  @type.vec3\r\n  position = vec3.create();\r\n\r\n  @io.flag(\"radius\")\r\n  @io.notify\r\n  @io.persist\r\n  @type.float32\r\n  radius = 1;\r\n\r\n  @io.flag(\"innerRadius\")\r\n  @io.notify\r\n  @io.persist\r\n  @type.float32\r\n  innerRadius = 1;\r\n\r\n  @io.persist\r\n  @type.string\r\n  name = \"\";\r\n\r\n  #callbacks = new Map();\r\n\r\n  #nextCallbackId = 1;\r\n\r\n  @carbon.method\r\n  @impl.adapted\r\n  GetBoundingSphere()\r\n  {\r\n    return {\r\n      center: vec3.clone(this.position),\r\n      radius: this.radius\r\n    };\r\n  }\r\n\r\n  @carbon.method\r\n  @impl.implemented\r\n  GetIntensity(position)\r\n  {\r\n    const distanceSq = vec3.squaredDistance(position, this.position);\r\n    const outerRadiusSq = this.radius * this.radius;\r\n    if (distanceSq > outerRadiusSq)\r\n    {\r\n      return 0;\r\n    }\r\n    const innerRadiusSq = this.innerRadius * this.innerRadius;\r\n    if (distanceSq <= innerRadiusSq)\r\n    {\r\n      return 1;\r\n    }\r\n    const interpolationDistance = outerRadiusSq - innerRadiusSq;\r\n    return interpolationDistance > 0 ? 1 - (distanceSq - innerRadiusSq) / interpolationDistance : 0;\r\n  }\r\n\r\n  @carbon.method\n  @impl.adapted\n  GeneratePointsInVolume(points, howManyToAdd, excludeInnerVolume, fallOffFactor)\n  {\n    const count = Math.max(0, Math.trunc(howManyToAdd));\n    const radiusRange = this.radius - this.innerRadius;\n    let innerSelectionChance = 0;\n    if (!excludeInnerVolume)\n    {\n      const adjustedOuterRadius = this.innerRadius + 0.5 * radiusRange;\n      innerSelectionChance = this.innerRadius ** 2 / adjustedOuterRadius ** 2;\n    }\n\n    for (let i = 0; i < count; i++)\n    {\n      let distance;\n      if (excludeInnerVolume)\n      {\n        distance = this.innerRadius + radiusRange * Math.pow(Math.random(), 1 / 3);\n      }\n      else if (Math.random() < innerSelectionChance)\n      {\n        distance = this.innerRadius * Math.pow(Math.random(), 1 / 3);\n      }\n      else\n      {\n        distance = this.innerRadius + radiusRange * Math.pow(Math.random(), fallOffFactor);\n      }\n\n      const angle = Math.PI * 2 * Math.random();\n      const z = Math.random() * 2 - 1;\n      const radial = Math.sqrt(1 - z * z);\n      points.push(vec3.fromValues(\n        radial * Math.cos(angle) * distance,\n        radial * Math.sin(angle) * distance,\n        z * distance\n      ));\n    }\n  }\n\n  @carbon.method\n  @impl.adapted\n  RegisterForChanges(callback)\n  {\r\n    const id = this.#nextCallbackId++;\r\n    this.#callbacks.set(id, callback);\r\n    return id;\r\n  }\r\n\r\n  @carbon.method\r\n  @impl.implemented\r\n  UnregisterForChanges(callbackId)\r\n  {\r\n    this.#callbacks.delete(callbackId);\r\n  }\r\n\r\n  @carbon.method\r\n  @impl.adapted\r\n  OnModified(_options = {})\r\n  {\r\n    const flags = this.__state.flags;\r\n    if (flags.delete(\"innerRadius\") && this.innerRadius > this.radius)\r\n    {\r\n      this.radius = this.innerRadius;\r\n    }\r\n    if (flags.delete(\"radius\"))\r\n    {\r\n      this.radius = Math.max(0, this.radius);\r\n      if (this.innerRadius > this.radius)\r\n      {\r\n        this.innerRadius = this.radius;\r\n      }\r\n    }\r\n    for (const callback of this.#callbacks.values())\r\n    {\r\n      callback?.();\r\n    }\r\n    return true;\r\n  }\r\n\r\n  @carbon.method\r\n  @impl.noop\r\n  RenderDebugInfo()\r\n  {\r\n  }\r\n}\r\n"],"names":["_EveSphereVolume","EveSphereVolume","CjsModel","e","_init_position","_init_extra_position","_init_radius","_init_extra_radius","_init_innerRadius","_init_extra_innerRadius","_init_name","_init_extra_name","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","notify","persist","vec3","flag","float32","string","carbon","method","impl","adapted","implemented","noop","position","create","radius","innerRadius","name","Map","GetBoundingSphere","center","clone","GetIntensity","distanceSq","squaredDistance","outerRadiusSq","innerRadiusSq","interpolationDistance","GeneratePointsInVolume","points","howManyToAdd","excludeInnerVolume","fallOffFactor","count","Math","max","trunc","radiusRange","innerSelectionChance","adjustedOuterRadius","i","distance","pow","random","angle","PI","z","radial","sqrt","push","fromValues","cos","sin","RegisterForChanges","callback","id","set","UnregisterForChanges","callbackId","delete","OnModified","_options","flags","__state","values","RenderDebugInfo"],"mappings":"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"}
+{"version":3,"file":"EveSphereVolume.js","sources":["../../../../src/eve/volume/EveSphereVolume.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\Eve\\Volume\\EveSphereVolume.h\r\n// Source: E:\\carbonengine\\trinity\\trinity\\Eve\\Volume\\EveSphereVolume.cpp\r\n// Source: E:\\carbonengine\\trinity\\trinity\\Eve\\Volume\\EveSphereVolume_Blue.cpp\r\nimport { vec3 } from \"@carbonenginejs/runtime-utils/vec3\";\r\nimport { CjsModel } from \"@carbonenginejs/runtime-utils/model\";\r\nimport { carbon, impl, io, type } from \"@carbonenginejs/runtime-utils/schema\";\r\n\r\n\r\n/**\r\n * Sphere of influence with a solid inner radius and a falloff out to the outer\r\n * radius, weighting points and seeding random ones inside it.\r\n */\r\n@type.define({\r\n  className: \"EveSphereVolume\",\r\n  family: \"eve/volume\"\r\n})\r\nexport class EveSphereVolume extends CjsModel\r\n{\r\n  @io.notify\r\n  @io.persist\r\n  @type.vec3\r\n  position = vec3.create();\r\n\r\n  @io.flag(\"radius\")\r\n  @io.notify\r\n  @io.persist\r\n  @type.float32\r\n  radius = 1;\r\n\r\n  @io.flag(\"innerRadius\")\r\n  @io.notify\r\n  @io.persist\r\n  @type.float32\r\n  innerRadius = 1;\r\n\r\n  @io.persist\r\n  @type.string\r\n  name = \"\";\r\n\r\n  #callbacks = new Map();\r\n\r\n  #nextCallbackId = 1;\r\n\r\n  /** Returns a fresh sphere centred on the volume position with its outer radius. */\r\n  @carbon.method\r\n  @impl.adapted\r\n  GetBoundingSphere()\r\n  {\r\n    return {\r\n      center: vec3.clone(this.position),\r\n      radius: this.radius\r\n    };\r\n  }\r\n\r\n  /**\r\n   * Returns the falloff weight for a point given in the volume's own space: 1\r\n   * within the inner radius, 0 past the outer radius, and a ramp that is linear\r\n   * in squared distance between them.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  GetIntensity(position)\r\n  {\r\n    const distanceSq = vec3.squaredDistance(position, this.position);\r\n    const outerRadiusSq = this.radius * this.radius;\r\n    if (distanceSq > outerRadiusSq)\r\n    {\r\n      return 0;\r\n    }\r\n    const innerRadiusSq = this.innerRadius * this.innerRadius;\r\n    if (distanceSq <= innerRadiusSq)\r\n    {\r\n      return 1;\r\n    }\r\n    const interpolationDistance = outerRadiusSq - innerRadiusSq;\r\n    return interpolationDistance > 0 ? 1 - (distanceSq - innerRadiusSq) / interpolationDistance : 0;\r\n  }\r\n\r\n  /**\r\n   * Appends random points expressed relative to the sphere centre rather than offset by its position, spread in direction uniformly over the sphere and in distance between the inner and outer radius as shaped by fallOffFactor.\r\n   *\r\n   * @param points Caller-owned array the new points are pushed onto.\r\n   * @param excludeInnerVolume Keeps every point outside the inner radius.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  GeneratePointsInVolume(points, howManyToAdd, excludeInnerVolume, fallOffFactor)\r\n  {\r\n    const count = Math.max(0, Math.trunc(howManyToAdd));\r\n    const radiusRange = this.radius - this.innerRadius;\r\n    let innerSelectionChance = 0;\r\n    if (!excludeInnerVolume)\r\n    {\r\n      const adjustedOuterRadius = this.innerRadius + 0.5 * radiusRange;\r\n      innerSelectionChance = this.innerRadius ** 2 / adjustedOuterRadius ** 2;\r\n    }\r\n\r\n    for (let i = 0; i < count; i++)\r\n    {\r\n      let distance;\r\n      if (excludeInnerVolume)\r\n      {\r\n        distance = this.innerRadius + radiusRange * Math.pow(Math.random(), 1 / 3);\r\n      }\r\n      else if (Math.random() < innerSelectionChance)\r\n      {\r\n        distance = this.innerRadius * Math.pow(Math.random(), 1 / 3);\r\n      }\r\n      else\r\n      {\r\n        distance = this.innerRadius + radiusRange * Math.pow(Math.random(), fallOffFactor);\r\n      }\r\n\r\n      const angle = Math.PI * 2 * Math.random();\r\n      const z = Math.random() * 2 - 1;\r\n      const radial = Math.sqrt(1 - z * z);\r\n      points.push(vec3.fromValues(\r\n        radial * Math.cos(angle) * distance,\r\n        radial * Math.sin(angle) * distance,\r\n        z * distance\r\n      ));\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Registers a callback fired whenever the volume changes, returning the id\r\n   * needed to unregister it again.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  RegisterForChanges(callback)\r\n  {\r\n    const id = this.#nextCallbackId++;\r\n    this.#callbacks.set(id, callback);\r\n    return id;\r\n  }\r\n\r\n  /** Drops a change callback by the id RegisterForChanges returned. */\r\n  @carbon.method\r\n  @impl.implemented\r\n  UnregisterForChanges(callbackId)\r\n  {\r\n    this.#callbacks.delete(callbackId);\r\n  }\r\n\r\n  /**\r\n   * Clamps the radii so the outer radius stays non-negative and never smaller\r\n   * than the inner one, then notifies every registered listener.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  OnModified(_options = {})\r\n  {\r\n    const flags = this.__state.flags;\r\n    if (flags.delete(\"innerRadius\") && this.innerRadius > this.radius)\r\n    {\r\n      this.radius = this.innerRadius;\r\n    }\r\n    if (flags.delete(\"radius\"))\r\n    {\r\n      this.radius = Math.max(0, this.radius);\r\n      if (this.innerRadius > this.radius)\r\n      {\r\n        this.innerRadius = this.radius;\r\n      }\r\n    }\r\n    for (const callback of this.#callbacks.values())\r\n    {\r\n      callback?.();\r\n    }\r\n    return true;\r\n  }\r\n\r\n  /** No debug drawing in this port. */\r\n  @carbon.method\r\n  @impl.noop\r\n  RenderDebugInfo()\r\n  {\r\n  }\r\n}\r\n"],"names":["_EveSphereVolume","EveSphereVolume","CjsModel","e","_init_position","_init_extra_position","_init_radius","_init_extra_radius","_init_innerRadius","_init_extra_innerRadius","_init_name","_init_extra_name","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","notify","persist","vec3","flag","float32","string","carbon","method","impl","adapted","implemented","noop","position","create","radius","innerRadius","name","Map","GetBoundingSphere","center","clone","GetIntensity","distanceSq","squaredDistance","outerRadiusSq","innerRadiusSq","interpolationDistance","GeneratePointsInVolume","points","howManyToAdd","excludeInnerVolume","fallOffFactor","count","Math","max","trunc","radiusRange","innerSelectionChance","adjustedOuterRadius","i","distance","pow","random","angle","PI","z","radial","sqrt","push","fromValues","cos","sin","RegisterForChanges","callback","id","set","UnregisterForChanges","callbackId","delete","OnModified","_options","flags","__state","values","RenderDebugInfo"],"mappings":"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"}

package/dist/generated/eve/child/EveChildCloud2.js

@@ -1,6 +1,6 @@
 import { identity as _identity, applyDecs2311 as _applyDecs2311 } from '../../../_virtual/_rollupPluginBabelHelpers.js';
 import { io, type, impl, schema } from '@carbonenginejs/runtime-utils/schema';
-import { EveEntity as _EveEntity } from '../EveEntity.js';
+import { EveEntity as _EveEntity } from '../../../eve/EveEntity.js';
 import { mat4 } from '@carbonenginejs/runtime-utils/mat4';
 import { quat } from '@carbonenginejs/runtime-utils/quat';
 import { vec3 } from '@carbonenginejs/runtime-utils/vec3';
@@ -40,11 +40,11 @@ const LIGHT_SCRATCH = {
   color: vec3.create()
 };
 
-/** Carbon OrthoNormalBasisZ (math Matrix_inline.h:531-546): identity; row Z =
- * Normalize(z); X seeded (0,1,0) when |Z.x| > 0.99 else (1,0,0); Y =
- * Normalize(Cross(X, Z)); X = Cross(Y, Z). Carbon's basis rows land at gl flat
- * [0..2]/[4..6]/[8..10] on the shared byte layout - single-matrix build, no
- * composition, no operand swap. A zero-length z NaNs exactly as Carbon's
+/** Carbon OrthoNormalBasisZ (math Matrix_inline.h:531-546): identity; row Z =
+ * Normalize(z); X seeded (0,1,0) when |Z.x| > 0.99 else (1,0,0); Y =
+ * Normalize(Cross(X, Z)); X = Cross(Y, Z). Carbon's basis rows land at gl flat
+ * [0..2]/[4..6]/[8..10] on the shared byte layout - single-matrix build, no
+ * composition, no operand swap. A zero-length z NaNs exactly as Carbon's
  * Normalize does. */
 function OrthoNormalBasisZ(out, z) {
   mat4.identity(out);
@@ -75,9 +75,9 @@ function OrthoNormalBasisZ(out, z) {
   return out;
 }
 
-/** Carbon OrthoOffCenterMatrix (math Matrix_inline.h:749-765): D3D-style
- * z-in-[0,1] off-center orthographic projection. Deliberately NOT gl-matrix's
- * mat4.ortho (GL z-in-[-1,1], different off-center terms). Carbon m[i][j]
+/** Carbon OrthoOffCenterMatrix (math Matrix_inline.h:749-765): D3D-style
+ * z-in-[0,1] off-center orthographic projection. Deliberately NOT gl-matrix's
+ * mat4.ortho (GL z-in-[-1,1], different off-center terms). Carbon m[i][j]
  * lands at gl flat [i*4+j] on the shared byte layout. */
 function OrthoOffCenterMatrix(out, l, r, b, t, zn, zf) {
   mat4.identity(out);
@@ -90,8 +90,8 @@ function OrthoOffCenterMatrix(out, l, r, b, t, zn, zf) {
   return out;
 }
 
-/** Carbon TransformNormal(v, M) - row-vector basis-only transform (no
- * translation): out_j = sum_i v_i * M[i][j], rows at gl flat [0..2]/[4..6]/
+/** Carbon TransformNormal(v, M) - row-vector basis-only transform (no
+ * translation): out_j = sum_i v_i * M[i][j], rows at gl flat [0..2]/[4..6]/
  * [8..10]. vec3.transformMat4 would add the translation - do not use it. */
 function TransformNormal(out, v, m) {
   const x = v[0];
@@ -229,8 +229,8 @@ new class extends _identity {
     /** m_effectHash - effect identity tracked by UpdateSyncronous (cpp:625-633). */
     effectHash = 0;
 
-    /** Unscaled lightmap dimensions - Carbon discovers them from the effect's
-     * DensityMap resource (cpp:634-665, engine-owned in JS; 0 fail-closes
+    /** Unscaled lightmap dimensions - Carbon discovers them from the effect's
+     * DensityMap resource (cpp:634-665, engine-owned in JS; 0 fail-closes
      * UpdateVolumetricLightmap). */
     lightmapWidth = 0;
 
@@ -249,35 +249,35 @@ new class extends _identity {
     /** m_localSunDirection (SetSceneInformation cpp:407). */
     localSunDirection = vec3.create();
 
-    /** m_depthSlices - SceneInformation::depthSliceCount = 4
+    /** m_depthSlices - SceneInformation::depthSliceCount = 4
      * (ITr2VolumetricRenderable.h:26). */
     depthSlices = new Float32Array(4);
 
-    /** m_targetWidth - Carbon leaves it uninitialized until SetSceneInformation;
-     * JS zeroes (targetInvSize then divides by zero to Infinity, matching
+    /** m_targetWidth - Carbon leaves it uninitialized until SetSceneInformation;
+     * JS zeroes (targetInvSize then divides by zero to Infinity, matching
      * Carbon's float semantics on garbage-free zero). */
     targetWidth = 0;
 
     /** m_targetHeight - see targetWidth. */
     targetHeight = 0;
 
-    /** m_lightViewProj - Carbon: uninitialized memory until SetupShadowFrustum;
+    /** m_lightViewProj - Carbon: uninitialized memory until SetupShadowFrustum;
      * JS: identity. */
     lightViewProj = mat4.create();
 
     /** m_shadowMapSize (cpp:101). */
     shadowMapSize = 512;
 
-    /** The global "DepthShadowMap" variable handle Carbon registers in the ctor
-     * (cpp:115) - the variable store is engine-owned in JS, so the handle is an
+    /** The global "DepthShadowMap" variable handle Carbon registers in the ctor
+     * (cpp:115) - the variable store is engine-owned in JS, so the handle is an
      * engine-injected duck. */
     depthShadowMapHandle = null;
 
-    /** Carbon EveChildCloud2::RegisterComponents (EveChildCloud2.cpp:148-163):
-     * LightOwner when lights are authored; VolumetricRenderable UNCONDITIONAL;
-     * ReflectionRenderable only when ShouldReflect && display &&
-     * reflectionEffect. Note: no whole-block display gate in Carbon. No
-     * UnRegisterComponents override (base no-op; EveEntity::UnRegister already
+    /** Carbon EveChildCloud2::RegisterComponents (EveChildCloud2.cpp:148-163):
+     * LightOwner when lights are authored; VolumetricRenderable UNCONDITIONAL;
+     * ReflectionRenderable only when ShouldReflect && display &&
+     * reflectionEffect. Note: no whole-block display gate in Carbon. No
+     * UnRegisterComponents override (base no-op; EveEntity::UnRegister already
      * removes the components, EveEntity.cpp:90). */
     RegisterComponents() {
       const registry = this.GetComponentRegistry();
@@ -292,13 +292,13 @@ new class extends _identity {
       }
     }
 
-    /** Carbon EveChildCloud2::UpdateSyncronous (cpp:621-685): an effect-hash
-     * change invalidates the lightmap and zeroes its dimensions (cpp:625-633);
-     * the DensityMap-driven dimension discovery and the empty-lightmap fallback
-     * (cpp:634-674) are GPU/resource work; the texture animation advances gated
-     * on UpdateOnlyWhenRendered/renderedLastFrame (cpp:677-683) and
-     * renderedLastFrame is cleared every pass (cpp:684) - the flag is only
-     * re-stamped by the volumetric batch path (GetVolumetricBatches cpp:283),
+    /** Carbon EveChildCloud2::UpdateSyncronous (cpp:621-685): an effect-hash
+     * change invalidates the lightmap and zeroes its dimensions (cpp:625-633);
+     * the DensityMap-driven dimension discovery and the empty-lightmap fallback
+     * (cpp:634-674) are GPU/resource work; the texture animation advances gated
+     * on UpdateOnlyWhenRendered/renderedLastFrame (cpp:677-683) and
+     * renderedLastFrame is cleared every pass (cpp:684) - the flag is only
+     * re-stamped by the volumetric batch path (GetVolumetricBatches cpp:283),
      * deliberately NOT by the reflection path. */
     UpdateSyncronous(updateContext, _params) {
       if (this.effect) {
@@ -319,14 +319,14 @@ new class extends _identity {
       this.renderedLastFrame = false;
     }
 
-    /** Carbon EveChildCloud2::UpdateAsyncronous (cpp:687-708): local SRT
-     * transform (cpp:689); world = localTransform * parent - Carbon row-vector,
-     * local applies first, so the gl-matrix operands swap (cpp:693); bounding
-     * sphere = CcpMath::Sphere(unit cube, world) which transforms ONLY the min
-     * and max corners (math Sphere.cpp:10-17 - the cheap two-corner form, not an
-     * 8-corner bound; preserved); map-offset scroll from the origin-shift-
-     * corrected world movement rotated into local space (cpp:697-704 - QUIRK
-     * kept verbatim: the .z offset scrolls by mapTiling.y, cpp:703); adjusted
+    /** Carbon EveChildCloud2::UpdateAsyncronous (cpp:687-708): local SRT
+     * transform (cpp:689); world = localTransform * parent - Carbon row-vector,
+     * local applies first, so the gl-matrix operands swap (cpp:693); bounding
+     * sphere = CcpMath::Sphere(unit cube, world) which transforms ONLY the min
+     * and max corners (math Sphere.cpp:10-17 - the cheap two-corner form, not an
+     * 8-corner bound; preserved); map-offset scroll from the origin-shift-
+     * corrected world movement rotated into local space (cpp:697-704 - QUIRK
+     * kept verbatim: the .z offset scrolls by mapTiling.y, cpp:703); adjusted
      * min screen size (cpp:706); hasUpdated stamp (cpp:707). */
     UpdateAsyncronous(updateContext, params = {}) {
       // Carbon TransformationMatrix(m_scaling, m_rotation, m_translation)
@@ -375,8 +375,8 @@ new class extends _identity {
       this.hasUpdated = true;
     }
 
-    /** Carbon EveChildCloud2::GetBoundingSphere (cpp:226-230): the packed
-     * (center, radius) cloud sphere, unconditionally true. IEveSpaceObjectChild
+    /** Carbon EveChildCloud2::GetBoundingSphere (cpp:226-230): the packed
+     * (center, radius) cloud sphere, unconditionally true. IEveSpaceObjectChild
      * override - parent bounds unions consume it optional-chained. */
     GetBoundingSphere(out = new Float32Array(4), _query = 0) {
       out[0] = this.boundingSphere.center[0];
@@ -386,7 +386,7 @@ new class extends _identity {
       return true;
     }
 
-    /** Carbon EveChildCloud2::GetLocalToWorldTransform (cpp:232-235); the
+    /** Carbon EveChildCloud2::GetLocalToWorldTransform (cpp:232-235); the
      * optional out follows the EveChildContainer copy-out shape. */
     GetLocalToWorldTransform(out = null) {
       if (out) {
@@ -395,11 +395,11 @@ new class extends _identity {
       return this.worldTransform;
     }
 
-    /** Carbon EveChildCloud2::IsVisible (cpp:837-852): display + one-arg
-     * IsSphereVisible (the back-plane-ignored TriFrustum quirk applies), then
-     * the Sphere-duck GetPixelSizeAccross (Est path) against minScreenSize *
-     * the LIVE lodFactor (not the adjusted stamp). Carbon's override of the
-     * defaulted ITr2Renderable::IsVisible (h:47-50 returns true) - without it
+    /** Carbon EveChildCloud2::IsVisible (cpp:837-852): display + one-arg
+     * IsSphereVisible (the back-plane-ignored TriFrustum quirk applies), then
+     * the Sphere-duck GetPixelSizeAccross (Est path) against minScreenSize *
+     * the LIVE lodFactor (not the adjusted stamp). Carbon's override of the
+     * defaulted ITr2Renderable::IsVisible (h:47-50 returns true) - without it
      * the reflection gather would treat the cloud as always visible. */
     IsVisible(updateContext) {
       const frustum = updateContext?.GetFrustum?.();
@@ -417,7 +417,7 @@ new class extends _identity {
       return true;
     }
 
-    /** Carbon EveChildCloud2::HasValidTransform (cpp:309-317): determinant is
+    /** Carbon EveChildCloud2::HasValidTransform (cpp:309-317): determinant is
      * nonzero and finite. */
     HasValidTransform() {
       const det = mat4.determinant(this.worldTransform);
@@ -429,20 +429,20 @@ new class extends _identity {
       return this.lightmapDirty;
     }
 
-    /** Carbon EveChildCloud2::MarkLightmapDirty (cpp:753-757): also zeroes the
-     * dirty offset (contrast SetSceneInformation's scale-change path, which
+    /** Carbon EveChildCloud2::MarkLightmapDirty (cpp:753-757): also zeroes the
+     * dirty offset (contrast SetSceneInformation's scale-change path, which
      * sets the flag WITHOUT resetting the offset - cpp:398-402). */
     MarkLightmapDirty(dirty) {
       this.lightmapDirty = !!dirty;
       this.lightmapDirtyOffset = 0;
     }
 
-    /** Carbon EveChildCloud2::GetLights (cpp:732-746): display gate only (no
-     * hasUpdated gate, unlike EveChildContainer), average world-basis-row-length
-     * scaling (Carbon LengthEst; exact hypot is the accepted divergence - single
-     * matrix reads, no composition), each light submitted with the world
-     * transform through the duck-typed manager. Inside Tr2Light::AddLight
-     * Carbon composes boneTransform * transform (Tr2Light.cpp:132) - that swap
+    /** Carbon EveChildCloud2::GetLights (cpp:732-746): display gate only (no
+     * hasUpdated gate, unlike EveChildContainer), average world-basis-row-length
+     * scaling (Carbon LengthEst; exact hypot is the accepted divergence - single
+     * matrix reads, no composition), each light submitted with the world
+     * transform through the duck-typed manager. Inside Tr2Light::AddLight
+     * Carbon composes boneTransform * transform (Tr2Light.cpp:132) - that swap
      * belongs to the Tr2Light port, not here. */
     GetLights(lightManager) {
       if (!this.display) {
@@ -455,12 +455,12 @@ new class extends _identity {
       }
     }
 
-    /** Carbon's two GetSortValue overloads, dispatched on argument presence:
-     * the ITr2VolumetricRenderable frustum form (cpp:237-242) - view distance
-     * minus |authored local scaling| * sortingModifier, consumed by the
-     * volumetric renderer's DESCENDING stable sort (farthest first,
-     * Tr2VolumetricsRenderer.cpp:276-287) - and the ITr2Renderable zero-arg
-     * form (cpp:914-917) - float32 max (finite, NOT Infinity), so the
+    /** Carbon's two GetSortValue overloads, dispatched on argument presence:
+     * the ITr2VolumetricRenderable frustum form (cpp:237-242) - view distance
+     * minus |authored local scaling| * sortingModifier, consumed by the
+     * volumetric renderer's DESCENDING stable sort (farthest first,
+     * Tr2VolumetricsRenderer.cpp:276-287) - and the ITr2Renderable zero-arg
+     * form (cpp:914-917) - float32 max (finite, NOT Infinity), so the
      * transparent reflection pass sorts the cloud to draw first. */
     GetSortValue(frustum = null) {
       if (!frustum) {
@@ -474,13 +474,13 @@ new class extends _identity {
       return Math.hypot(dx, dy, dz) - vec3.length(this.scaling) * this.sortingModifier;
     }
 
-    /** Carbon EveChildCloud2::GetVolumetricBatches (cpp:244-284), exact gate
-     * order: quality (cpp:246), display+hasUpdated+frustum sphere (cpp:250),
-     * Sphere-duck pixel size vs the adjusted min screen size (cpp:256-260),
-     * HasValidTransform (cpp:262), unit-cube buffers + effect shader
-     * (cpp:267-274), then ONE transparent volumetric batch with the real
-     * screenSize per-object data and Carbon's 36-index draw (cpp:276-281).
-     * Stamps renderedLastFrame (cpp:283) - the texture-animation keep-alive.
+    /** Carbon EveChildCloud2::GetVolumetricBatches (cpp:244-284), exact gate
+     * order: quality (cpp:246), display+hasUpdated+frustum sphere (cpp:250),
+     * Sphere-duck pixel size vs the adjusted min screen size (cpp:256-260),
+     * HasValidTransform (cpp:262), unit-cube buffers + effect shader
+     * (cpp:267-274), then ONE transparent volumetric batch with the real
+     * screenSize per-object data and Carbon's 36-index draw (cpp:276-281).
+     * Stamps renderedLastFrame (cpp:283) - the texture-animation keep-alive.
      * Returns whether a batch was committed (JS addition; Carbon returns void). */
     GetVolumetricBatches(frustum, batches) {
       if (this.currentQuality < this.minVisibleQuality) {
@@ -513,15 +513,15 @@ new class extends _identity {
       return committed;
     }
 
-    /** Carbon EveChildCloud2::UpdateVolumetricLightmap (cpp:319-382): the
-     * scene-facing contract is the gates and the bool return - true means "this
-     * cloud consumed the frame's single scene-wide lightmap budget"
-     * (Tr2VolumetricsRenderer::ProcessComponentsUntil stops at the FIRST true,
-     * cpp:219-221). Slice budget: VOXELS_PER_UPDATE = 6400000 * scale^3;
-     * slices = max(VOXELS / (scaledHeight * scaledDepth), 1) (cpp:354-355).
-     * QUIRK verbatim: the dispatch group Y/Z counts use the UNSCALED dims while
-     * the slice count uses the scaled ones (cpp:359-361). Success advances
-     * lightmapDirtyOffset by slices; reaching scaledWidth completes the map
+    /** Carbon EveChildCloud2::UpdateVolumetricLightmap (cpp:319-382): the
+     * scene-facing contract is the gates and the bool return - true means "this
+     * cloud consumed the frame's single scene-wide lightmap budget"
+     * (Tr2VolumetricsRenderer::ProcessComponentsUntil stops at the FIRST true,
+     * cpp:219-221). Slice budget: VOXELS_PER_UPDATE = 6400000 * scale^3;
+     * slices = max(VOXELS / (scaledHeight * scaledDepth), 1) (cpp:354-355).
+     * QUIRK verbatim: the dispatch group Y/Z counts use the UNSCALED dims while
+     * the slice count uses the scaled ones (cpp:359-361). Success advances
+     * lightmapDirtyOffset by slices; reaching scaledWidth completes the map
      * (dirty false, offset 0); failure resets the offset and returns false. */
     UpdateVolumetricLightmap(renderContext) {
       if (this.currentQuality < this.minVisibleQuality || !this.hasUpdated) {
@@ -547,15 +547,15 @@ new class extends _identity {
       return false;
     }
 
-    /** Carbon EveChildCloud2::SetSceneInformation (cpp:384-424): quality maps to
-     * lightmapSizeScale (Low 0.1 / Medium 0.15 / default 0.25, cpp:386-397); a
-     * scale change sets lightmapDirty WITHOUT resetting the dirty offset
-     * (cpp:398-402 - asymmetric vs MarkLightmapDirty, preserved); copies the 4
-     * depth slices; localSunDirection = Normalize(TransformNormal(sunDir,
-     * Inverse(world))) (cpp:407 - single-matrix inverse + basis transform, no
-     * composition); re-dirties the lightmap when the sun moved past
-     * cos(5/180) - QUIRK verbatim: Carbon omits the degree conversion, so the
-     * threshold is ~1.59 degrees, not 5 (cpp:408); stamps target dims; flips
+    /** Carbon EveChildCloud2::SetSceneInformation (cpp:384-424): quality maps to
+     * lightmapSizeScale (Low 0.1 / Medium 0.15 / default 0.25, cpp:386-397); a
+     * scale change sets lightmapDirty WITHOUT resetting the dirty offset
+     * (cpp:398-402 - asymmetric vs MarkLightmapDirty, preserved); copies the 4
+     * depth slices; localSunDirection = Normalize(TransformNormal(sunDir,
+     * Inverse(world))) (cpp:407 - single-matrix inverse + basis transform, no
+     * composition); re-dirties the lightmap when the sun moved past
+     * cos(5/180) - QUIRK verbatim: Carbon omits the degree conversion, so the
+     * threshold is ~1.59 degrees, not 5 (cpp:408); stamps target dims; flips
      * the two cloud-shadow effect options (cpp:417-423). */
     SetSceneInformation(sceneInformation) {
       let lightmapSizeScale;
@@ -594,11 +594,11 @@ new class extends _identity {
       this.effect?.SetOption?.("CLOUD_SHADOW_ALGORITHM", receive && sceneInformation.raytracedShadows ? "CLOUD_SHADOWS_RAYTRACED" : "CLOUD_SHADOWS_CASCADED");
     }
 
-    /** Carbon EveChildCloud2::GetVolumetricShadowBatches (cpp:759-785): gated on
-     * display + effect + castShadows, then the "Shadow" technique presence
-     * (cpp:766-776); emits ONE alpha, declaration-less (NULL_DECLARATION,
-     * cpp:782), non-indexed single-triangle batch with screenSize-1 per-object
-     * data (cpp:778-784). Does NOT stamp renderedLastFrame. Returns whether the
+    /** Carbon EveChildCloud2::GetVolumetricShadowBatches (cpp:759-785): gated on
+     * display + effect + castShadows, then the "Shadow" technique presence
+     * (cpp:766-776); emits ONE alpha, declaration-less (NULL_DECLARATION,
+     * cpp:782), non-indexed single-triangle batch with screenSize-1 per-object
+     * data (cpp:778-784). Does NOT stamp renderedLastFrame. Returns whether the
      * batch was committed (JS addition). */
     GetVolumetricShadowBatches(batches) {
       if (!this.display || !this.effect || !this.castShadows) {
@@ -623,25 +623,25 @@ new class extends _identity {
       return batches?.Commit?.(batch) === true;
     }
 
-    /** Carbon EveChildCloud2::GetVolumetricShadowInfo (cpp:787-790): pure
-     * delegation to SetupShadowFrustum. The scene calls this to build the
-     * shadow-camera package before rendering casters into the cloud shadow map
+    /** Carbon EveChildCloud2::GetVolumetricShadowInfo (cpp:787-790): pure
+     * delegation to SetupShadowFrustum. The scene calls this to build the
+     * shadow-camera package before rendering casters into the cloud shadow map
      * (EveSpaceScene.cpp:2355-2371). */
     GetVolumetricShadowInfo(shadowInfo, sunDir) {
       return this.SetupShadowFrustum(shadowInfo, sunDir);
     }
 
-    /** Carbon EveChildCloud2::SetupShadowFrustum (cpp:886-907):
-     * lightView = Inverse(OrthoNormalBasisZ(-sunDir)) (cpp:889 - single-matrix
-     * build + invert); the unit-cube AABB transformed by worldTransform *
-     * lightView - COMPOSITION, world applies first, so the gl-matrix operands
-     * swap (cpp:893; all 8 corners, math AxisAlignedBox.cpp:9-33); max.z
-     * extended by the 2,500,000 sun-ray magic constant (cpp:895); lightViewProj
-     * = lightView * OrthoOffCenterMatrix(...) - COMPOSITION, lightView first,
-     * operands swap (cpp:897), with Carbon's deliberately mirrored argument
-     * order (max.x, min.x, max.y, min.y, -max.z, -min.z) and D3D z-in-[0,1]
-     * formula both preserved; DeriveFrustum(lightView, aabb.min, aabb.max)
-     * (cpp:900-901); outputs aabbMax / lightViewProj copy / shadowFrustum /
+    /** Carbon EveChildCloud2::SetupShadowFrustum (cpp:886-907):
+     * lightView = Inverse(OrthoNormalBasisZ(-sunDir)) (cpp:889 - single-matrix
+     * build + invert); the unit-cube AABB transformed by worldTransform *
+     * lightView - COMPOSITION, world applies first, so the gl-matrix operands
+     * swap (cpp:893; all 8 corners, math AxisAlignedBox.cpp:9-33); max.z
+     * extended by the 2,500,000 sun-ray magic constant (cpp:895); lightViewProj
+     * = lightView * OrthoOffCenterMatrix(...) - COMPOSITION, lightView first,
+     * operands swap (cpp:897), with Carbon's deliberately mirrored argument
+     * order (max.x, min.x, max.y, min.y, -max.z, -min.z) and D3D z-in-[0,1]
+     * formula both preserved; DeriveFrustum(lightView, aabb.min, aabb.max)
+     * (cpp:900-901); outputs aabbMax / lightViewProj copy / shadowFrustum /
      * shadowMapSize (cpp:903-906). */
     SetupShadowFrustum(shadowInfo, sunDir) {
       vec3.set(SUN_SCRATCH, -sunDir[0], -sunDir[1], -sunDir[2]);
@@ -685,10 +685,10 @@ new class extends _identity {
       return shadowInfo;
     }
 
-    /** Carbon EveChildCloud2::PrepareCloudShadowMap (cpp:792-826): the CPU
-     * contract is the receiveShadows gate (cpp:796-799) and the bool return -
-     * the scene calls SetCloudShadowMapHandle ONLY after a true return
-     * (EveSpaceScene.cpp:2365-2368), which is what makes Carbon's unguarded
+    /** Carbon EveChildCloud2::PrepareCloudShadowMap (cpp:792-826): the CPU
+     * contract is the receiveShadows gate (cpp:796-799) and the bool return -
+     * the scene calls SetCloudShadowMapHandle ONLY after a true return
+     * (EveSpaceScene.cpp:2365-2368), which is what makes Carbon's unguarded
      * m_shadowMapDS dereference there safe. */
     PrepareCloudShadowMap(renderContext) {
       if (!this.receiveShadows) {
@@ -698,10 +698,10 @@ new class extends _identity {
       return true;
     }
 
-    /** Carbon EveChildCloud2::SetCloudShadowMapHandle (cpp:829-835): publish the
-     * shadow depth-stencil into the global "DepthShadowMap" variable handle
-     * (registered in the Carbon ctor, cpp:115). QUIRK: Carbon dereferences
-     * m_shadowMapDS with no null guard - safe only via the
+    /** Carbon EveChildCloud2::SetCloudShadowMapHandle (cpp:829-835): publish the
+     * shadow depth-stencil into the global "DepthShadowMap" variable handle
+     * (registered in the Carbon ctor, cpp:115). QUIRK: Carbon dereferences
+     * m_shadowMapDS with no null guard - safe only via the
      * PrepareCloudShadowMap-first call order (see above). */
     SetCloudShadowMapHandle() {
       if (this.shadowMapDS?.IsValid?.()) {
@@ -709,13 +709,13 @@ new class extends _identity {
       }
     }
 
-    /** Carbon EveChildCloud2::GetBatches (cpp:854-884): quality gate, then ONLY
-     * the (REFLECTION, TRANSPARENT) type/reason pair produces anything
-     * (cpp:860) - every other combination is a silent no-op; HasValidTransform
-     * + unit-cube buffers + reflectionEffect gates (cpp:862-874); one alpha
-     * batch with the hardcoded 10000 screen size forcing max lodFactor
-     * (cpp:878). QUIRK: unlike GetVolumetricBatches this does NOT stamp
-     * renderedLastFrame - reflection-only rendering does not keep texture
+    /** Carbon EveChildCloud2::GetBatches (cpp:854-884): quality gate, then ONLY
+     * the (REFLECTION, TRANSPARENT) type/reason pair produces anything
+     * (cpp:860) - every other combination is a silent no-op; HasValidTransform
+     * + unit-cube buffers + reflectionEffect gates (cpp:862-874); one alpha
+     * batch with the hardcoded 10000 screen size forcing max lodFactor
+     * (cpp:878). QUIRK: unlike GetVolumetricBatches this does NOT stamp
+     * renderedLastFrame - reflection-only rendering does not keep texture
      * animations alive. Returns whether a batch was committed (JS addition). */
     GetBatches(batches, batchType, _perObjectData, reason = Tr2RenderReason.TR2RENDERREASON_NORMAL) {
       if (this.currentQuality < this.minVisibleQuality) {
@@ -738,18 +738,18 @@ new class extends _identity {
       return batches?.Commit?.(batch) === true;
     }
 
-    /** Carbon EveChildCloud2::HasTransparentBatches (cpp:909-912):
-     * unconditionally true - the reflection gather always routes the cloud
+    /** Carbon EveChildCloud2::HasTransparentBatches (cpp:909-912):
+     * unconditionally true - the reflection gather always routes the cloud
      * through the transparent leg that feeds GetBatches' type/reason filter. */
     HasTransparentBatches() {
       return true;
     }
 
-    /** Carbon's two GetPerObjectData overloads (public, screenSize 1:
-     * cpp:919-927; private, caller screenSize: cpp:534-542): allocate from the
-     * accumulator and populate. The GPU-free record carries the live object
-     * reference plus the CPU-populated field block (cloudData); view-dependent
-     * members are refreshed by the engine calling PopulatePerObjectData again
+    /** Carbon's two GetPerObjectData overloads (public, screenSize 1:
+     * cpp:919-927; private, caller screenSize: cpp:534-542): allocate from the
+     * accumulator and populate. The GPU-free record carries the live object
+     * reference plus the CPU-populated field block (cloudData); view-dependent
+     * members are refreshed by the engine calling PopulatePerObjectData again
      * with its render context at realization (screenSize is stamped for that). */
     GetPerObjectData(accumulator = null, screenSize = 1) {
       const data = typeof accumulator?.Allocate === "function" ? accumulator.Allocate(Tr2PerObjectData) : new Tr2PerObjectData();
@@ -762,16 +762,16 @@ new class extends _identity {
       return data;
     }
 
-    /** Carbon EveChildCloud2::PopulatePerObjectData (cpp:544-619) against the
-     * PerObjectData block (EveChildCloud2.h:125-145). Compositions (Carbon
-     * row-vector -> gl-matrix operands swap):
-     *   - cpp:548/567 worldTransform * viewTransform (world first) ->
-     *     mat4.multiply(WV, view, world); the cpp:567 transpose is folded into
-     *     explicit element reads: viewDirection = TransformNormal((0,0,-1),
-     *     worldViewT) = (-WV[2], -WV[6], -WV[10]); depthSliceN =
-     *     -WV[14] - slice * WV[15].
-     * Single-matrix sites (NO swap): the cpp:546/547/551 HLSL packing
-     * transposes, cpp:550 TransformCoord with the inverted world, cpp:578
+    /** Carbon EveChildCloud2::PopulatePerObjectData (cpp:544-619) against the
+     * PerObjectData block (EveChildCloud2.h:125-145). Compositions (Carbon
+     * row-vector -> gl-matrix operands swap):
+     *   - cpp:548/567 worldTransform * viewTransform (world first) ->
+     *     mat4.multiply(WV, view, world); the cpp:567 transpose is folded into
+     *     explicit element reads: viewDirection = TransformNormal((0,0,-1),
+     *     worldViewT) = (-WV[2], -WV[6], -WV[10]); depthSliceN =
+     *     -WV[14] - slice * WV[15].
+     * Single-matrix sites (NO swap): the cpp:546/547/551 HLSL packing
+     * transposes, cpp:550 TransformCoord with the inverted world, cpp:578
      * Decompose (mat4.getScaling). */
     PopulatePerObjectData(data, screenSize = 1, renderContext = null) {
       const w = this.worldTransform;