@carbonenginejs/runtime-trinity 0.5.0 → 0.7.0

package/dist/eve/virtualCamera/behaviour/EveVirtualCameraBehaviourVector3Shake.js

@@ -1,12 +1,17 @@
 import { identity as _identity, applyDecs2311 as _applyDecs2311 } from '../../../_virtual/_rollupPluginBabelHelpers.js';
-import { vec3 } from '@carbonenginejs/core-math/vec3';
-import { io, type, carbon, impl } from '@carbonenginejs/core-types/schema';
+import { vec3 } from '@carbonenginejs/runtime-utils/vec3';
+import { io, type, carbon, impl } from '@carbonenginejs/runtime-utils/schema';
 import { Tr2CurveScalar as _Tr2CurveScalar } from '../../../curves/Tr2CurveScalar.js';
 import { Tr2CurveExtrapolation } from '../../../curves/enums.js';
 import { TriPerlinCurve as _TriPerlinCurve } from '../../../curves/TriPerlinCurve.js';
 import { EveVirtualCameraBehaviourVector3Base as _EveVirtualCameraBeha$1 } from './EveVirtualCameraBehaviourVector3Base.js';
 
 let _initProto, _initClass, _init_octaves, _init_extra_octaves, _init_magnitudeCurve, _init_extra_magnitudeCurve, _init_magnitude, _init_extra_magnitude, _init_perlineScale, _init_extra_perlineScale, _init_scaleByView, _init_extra_scaleByView;
+
+/**
+ * Vector3 behaviour that shakes the camera with independent per-axis Perlin
+ * noise applied along the camera's own right, up and forward axes.
+ */
 let _EveVirtualCameraBeha;
 new class extends _identity {
   static [class EveVirtualCameraBehaviourVector3Shake extends _EveVirtualCameraBeha$1 {
@@ -25,15 +30,30 @@ new class extends _identity {
     perlineScale = (_init_extra_magnitude(this), _init_perlineScale(this, 1));
     scaleByView = (_init_extra_perlineScale(this), _init_scaleByView(this, true));
     #phase = (_init_extra_scaleByView(this), _EveVirtualCameraBeha.#allocatePhase());
+
+    /**
+     * Creates the default magnitude envelope curve and names the behaviour
+     * "Shake".
+     */
     constructor() {
       super();
       this.magnitudeCurve = _EveVirtualCameraBeha.#createMagnitudeCurve();
       this.SetName("Shake");
     }
+
+    /** Sets the behaviour name and renames the owned magnitude curve to match. */
     SetName(name) {
       super.SetName(name);
       this.magnitudeCurve?.SetName?.(`${this.name} - Magnitude Curve`);
     }
+
+    /**
+     * Returns the shake offset for this frame: the authored per-axis magnitude
+     * scaled by three decorrelated Perlin samples and by the magnitude envelope at
+     * normalized timeline time, optionally compressed through atan and scaled by
+     * the camera-to-interest distance when scaleByView is set, then mapped onto
+     * the camera's right, up and forward axes.
+     */
     Update(camera, _current, _deltaTime, localElapsedTime, _anchorPosition, _anchorRadius, _anchorForwardDirection, out = vec3.create()) {
       const offset = vec3.clone(this.magnitude);
       offset[0] *= _EveVirtualCameraBeha.#clampedNoise(localElapsedTime + this.#phase + 1.1, this.perlineScale, this.octaves);
@@ -54,6 +74,22 @@ new class extends _identity {
       vec3.scaleAndAdd(out, out, camera.GetUpDirection(vec3.create()), offset[1]);
       return vec3.scaleAndAdd(out, out, camera.GetForwardDirection(vec3.create()), offset[2]);
     }
+
+    /**
+     * Samples one axis of 1D Perlin noise at the given time offset scaled by
+     * frequency, summing the configured number of octaves.
+     */
+
+    /**
+     * Builds the default shake envelope over normalized time: an almost immediate
+     * rise to full magnitude by 0.1, then a linear fade to zero at the end of the
+     * timeline.
+     */
+
+    /**
+     * Hands each new instance a distinct noise phase from a rolling 12-bit
+     * counter, so shakes created together do not sample identical noise.
+     */
   }];
   #nextPhase = 0;
   #clampedNoise(offset, frequency, octaves) {

package/dist/eve/virtualCamera/behaviour/EveVirtualCameraBehaviourVector3Shake.js.map

@@ -1 +1 @@
-{"version":3,"file":"EveVirtualCameraBehaviourVector3Shake.js","sources":["../../../../../src/eve/virtualCamera/behaviour/EveVirtualCameraBehaviourVector3Shake.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\Eve\\VirtualCamera\\EveVirtualCameraBehaviour.h\n// Source: E:\\carbonengine\\trinity\\trinity\\Eve\\VirtualCamera\\EveVirtualCameraBehaviour.cpp\nimport { vec3 } from \"@carbonenginejs/core-math/vec3\";\nimport { carbon, impl, io, type } from \"@carbonenginejs/core-types/schema\";\nimport { Tr2CurveScalar } from \"../../../curves/Tr2CurveScalar.js\";\nimport { Tr2CurveExtrapolation } from \"../../../curves/enums.js\";\nimport { TriPerlinCurve } from \"../../../curves/TriPerlinCurve.js\";\nimport { EveVirtualCameraBehaviourVector3Base } from \"./EveVirtualCameraBehaviourVector3Base.js\";\n\n\n@type.define({\n  className: \"EveVirtualCameraBehaviourVector3Shake\",\n  family: \"eve/virtualCamera/behaviour\"\n})\nexport class EveVirtualCameraBehaviourVector3Shake extends EveVirtualCameraBehaviourVector3Base\n{\n  static #nextPhase = 0;\n\n  @io.persist\n  @type.int32\n  octaves = 8;\n\n  @io.persist\n  @type.objectRef(\"Tr2CurveScalar\")\n  magnitudeCurve = null;\n\n  @io.persist\n  @type.vec3\n  magnitude = vec3.fromValues(1, 0.6, 0.2);\n\n  @io.persist\n  @type.float32\n  perlineScale = 1;\n\n  @io.persist\n  @type.boolean\n  scaleByView = true;\n\n  #phase = EveVirtualCameraBehaviourVector3Shake.#allocatePhase();\n\n  constructor()\n  {\n    super();\n    this.magnitudeCurve = EveVirtualCameraBehaviourVector3Shake.#createMagnitudeCurve();\n    this.SetName(\"Shake\");\n  }\n\n  @carbon.method\n  @impl.implemented\n  SetName(name)\n  {\n    super.SetName(name);\n    this.magnitudeCurve?.SetName?.(`${this.name} - Magnitude Curve`);\n  }\n\n  @carbon.method\n  @impl.adapted\n  Update(camera, _current, _deltaTime, localElapsedTime, _anchorPosition, _anchorRadius, _anchorForwardDirection, out = vec3.create())\n  {\n    const offset = vec3.clone(this.magnitude);\n    offset[0] *= EveVirtualCameraBehaviourVector3Shake.#clampedNoise(localElapsedTime + this.#phase + 1.1, this.perlineScale, this.octaves);\n    offset[1] *= EveVirtualCameraBehaviourVector3Shake.#clampedNoise(localElapsedTime + this.#phase + 10.1, this.perlineScale, this.octaves);\n    offset[2] *= EveVirtualCameraBehaviourVector3Shake.#clampedNoise(localElapsedTime + this.#phase + 18.3, this.perlineScale, this.octaves);\n\n    if (this.magnitudeCurve)\n    {\n      const duration = Number(camera?.GetAnimationTimelineLength?.() ?? 0);\n      const time = duration !== 0 ? localElapsedTime / duration : 0;\n      vec3.scale(offset, offset, Number(this.magnitudeCurve.GetValue?.(time) ?? 1));\n    }\n    if (this.scaleByView)\n    {\n      const distance = vec3.distance(camera.GetPointOfInterest(vec3.create()), camera.GetPosition(vec3.create()));\n      offset[0] = Math.atan(offset[0]) * distance;\n      offset[1] = Math.atan(offset[1]) * distance;\n      offset[2] = Math.atan(offset[2]) * distance;\n    }\n\n    vec3.scale(out, camera.GetRightDirection(vec3.create()), offset[0]);\n    vec3.scaleAndAdd(out, out, camera.GetUpDirection(vec3.create()), offset[1]);\n    return vec3.scaleAndAdd(out, out, camera.GetForwardDirection(vec3.create()), offset[2]);\n  }\n\n  static #clampedNoise(offset, frequency, octaves)\n  {\n    return TriPerlinCurve.PerlinNoise1D(offset * frequency, 2, 2, octaves);\n  }\n\n  static #createMagnitudeCurve()\n  {\n    const curve = new Tr2CurveScalar();\n    curve.SetExtrapolation(Tr2CurveExtrapolation.LINEAR);\n    curve.AddKey(0, 0);\n    curve.AddKey(0.001, 0.8);\n    curve.AddKey(0.1, 1);\n    curve.AddKey(1, 0);\n    return curve;\n  }\n\n  static #allocatePhase()\n  {\n    const phase = EveVirtualCameraBehaviourVector3Shake.#nextPhase & 0xfff;\n    EveVirtualCameraBehaviourVector3Shake.#nextPhase++;\n    return phase;\n  }\n}\n"],"names":["_EveVirtualCameraBeha","_identity","EveVirtualCameraBehaviourVector3Shake","EveVirtualCameraBehaviourVector3Base","e","_init_octaves","_init_extra_octaves","_init_magnitudeCurve","_init_extra_magnitudeCurve","_init_magnitude","_init_extra_magnitude","_init_perlineScale","_init_extra_perlineScale","_init_scaleByView","_init_extra_scaleByView","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","persist","int32","objectRef","vec3","float32","boolean","carbon","method","impl","implemented","adapted","octaves","magnitudeCurve","magnitude","fromValues","perlineScale","scaleByView","constructor","SetName","name","Update","camera","_current","_deltaTime","localElapsedTime","_anchorPosition","_anchorRadius","_anchorForwardDirection","out","create","offset","clone","duration","Number","GetAnimationTimelineLength","time","scale","GetValue","distance","GetPointOfInterest","GetPosition","Math","atan","GetRightDirection","scaleAndAdd","GetUpDirection","GetForwardDirection","#clampedNoise","frequency","TriPerlinCurve","PerlinNoise1D","#createMagnitudeCurve","curve","Tr2CurveScalar","SetExtrapolation","Tr2CurveExtrapolation","LINEAR","AddKey","#allocatePhase","phase"],"mappings":"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"}
+{"version":3,"file":"EveVirtualCameraBehaviourVector3Shake.js","sources":["../../../../../src/eve/virtualCamera/behaviour/EveVirtualCameraBehaviourVector3Shake.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\Eve\\VirtualCamera\\EveVirtualCameraBehaviour.h\n// Source: E:\\carbonengine\\trinity\\trinity\\Eve\\VirtualCamera\\EveVirtualCameraBehaviour.cpp\nimport { vec3 } from \"@carbonenginejs/runtime-utils/vec3\";\nimport { carbon, impl, io, type } from \"@carbonenginejs/runtime-utils/schema\";\nimport { Tr2CurveScalar } from \"../../../curves/Tr2CurveScalar.js\";\nimport { Tr2CurveExtrapolation } from \"../../../curves/enums.js\";\nimport { TriPerlinCurve } from \"../../../curves/TriPerlinCurve.js\";\nimport { EveVirtualCameraBehaviourVector3Base } from \"./EveVirtualCameraBehaviourVector3Base.js\";\n\n\n/**\n * Vector3 behaviour that shakes the camera with independent per-axis Perlin\n * noise applied along the camera's own right, up and forward axes.\n */\n@type.define({\n  className: \"EveVirtualCameraBehaviourVector3Shake\",\n  family: \"eve/virtualCamera/behaviour\"\n})\nexport class EveVirtualCameraBehaviourVector3Shake extends EveVirtualCameraBehaviourVector3Base\n{\n  static #nextPhase = 0;\n\n  @io.persist\n  @type.int32\n  octaves = 8;\n\n  @io.persist\n  @type.objectRef(\"Tr2CurveScalar\")\n  magnitudeCurve = null;\n\n  @io.persist\n  @type.vec3\n  magnitude = vec3.fromValues(1, 0.6, 0.2);\n\n  @io.persist\n  @type.float32\n  perlineScale = 1;\n\n  @io.persist\n  @type.boolean\n  scaleByView = true;\n\n  #phase = EveVirtualCameraBehaviourVector3Shake.#allocatePhase();\n\n  /**\n   * Creates the default magnitude envelope curve and names the behaviour\n   * \"Shake\".\n   */\n  constructor()\n  {\n    super();\n    this.magnitudeCurve = EveVirtualCameraBehaviourVector3Shake.#createMagnitudeCurve();\n    this.SetName(\"Shake\");\n  }\n\n  /** Sets the behaviour name and renames the owned magnitude curve to match. */\n  @carbon.method\n  @impl.implemented\n  SetName(name)\n  {\n    super.SetName(name);\n    this.magnitudeCurve?.SetName?.(`${this.name} - Magnitude Curve`);\n  }\n\n  /**\n   * Returns the shake offset for this frame: the authored per-axis magnitude\n   * scaled by three decorrelated Perlin samples and by the magnitude envelope at\n   * normalized timeline time, optionally compressed through atan and scaled by\n   * the camera-to-interest distance when scaleByView is set, then mapped onto\n   * the camera's right, up and forward axes.\n   */\n  @carbon.method\n  @impl.adapted\n  Update(camera, _current, _deltaTime, localElapsedTime, _anchorPosition, _anchorRadius, _anchorForwardDirection, out = vec3.create())\n  {\n    const offset = vec3.clone(this.magnitude);\n    offset[0] *= EveVirtualCameraBehaviourVector3Shake.#clampedNoise(localElapsedTime + this.#phase + 1.1, this.perlineScale, this.octaves);\n    offset[1] *= EveVirtualCameraBehaviourVector3Shake.#clampedNoise(localElapsedTime + this.#phase + 10.1, this.perlineScale, this.octaves);\n    offset[2] *= EveVirtualCameraBehaviourVector3Shake.#clampedNoise(localElapsedTime + this.#phase + 18.3, this.perlineScale, this.octaves);\n\n    if (this.magnitudeCurve)\n    {\n      const duration = Number(camera?.GetAnimationTimelineLength?.() ?? 0);\n      const time = duration !== 0 ? localElapsedTime / duration : 0;\n      vec3.scale(offset, offset, Number(this.magnitudeCurve.GetValue?.(time) ?? 1));\n    }\n    if (this.scaleByView)\n    {\n      const distance = vec3.distance(camera.GetPointOfInterest(vec3.create()), camera.GetPosition(vec3.create()));\n      offset[0] = Math.atan(offset[0]) * distance;\n      offset[1] = Math.atan(offset[1]) * distance;\n      offset[2] = Math.atan(offset[2]) * distance;\n    }\n\n    vec3.scale(out, camera.GetRightDirection(vec3.create()), offset[0]);\n    vec3.scaleAndAdd(out, out, camera.GetUpDirection(vec3.create()), offset[1]);\n    return vec3.scaleAndAdd(out, out, camera.GetForwardDirection(vec3.create()), offset[2]);\n  }\n\n  /**\n   * Samples one axis of 1D Perlin noise at the given time offset scaled by\n   * frequency, summing the configured number of octaves.\n   */\n  static #clampedNoise(offset, frequency, octaves)\n  {\n    return TriPerlinCurve.PerlinNoise1D(offset * frequency, 2, 2, octaves);\n  }\n\n  /**\n   * Builds the default shake envelope over normalized time: an almost immediate\n   * rise to full magnitude by 0.1, then a linear fade to zero at the end of the\n   * timeline.\n   */\n  static #createMagnitudeCurve()\n  {\n    const curve = new Tr2CurveScalar();\n    curve.SetExtrapolation(Tr2CurveExtrapolation.LINEAR);\n    curve.AddKey(0, 0);\n    curve.AddKey(0.001, 0.8);\n    curve.AddKey(0.1, 1);\n    curve.AddKey(1, 0);\n    return curve;\n  }\n\n  /**\n   * Hands each new instance a distinct noise phase from a rolling 12-bit\n   * counter, so shakes created together do not sample identical noise.\n   */\n  static #allocatePhase()\n  {\n    const phase = EveVirtualCameraBehaviourVector3Shake.#nextPhase & 0xfff;\n    EveVirtualCameraBehaviourVector3Shake.#nextPhase++;\n    return phase;\n  }\n}\n"],"names":["_EveVirtualCameraBeha","_identity","EveVirtualCameraBehaviourVector3Shake","EveVirtualCameraBehaviourVector3Base","e","_init_octaves","_init_extra_octaves","_init_magnitudeCurve","_init_extra_magnitudeCurve","_init_magnitude","_init_extra_magnitude","_init_perlineScale","_init_extra_perlineScale","_init_scaleByView","_init_extra_scaleByView","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","persist","int32","objectRef","vec3","float32","boolean","carbon","method","impl","implemented","adapted","octaves","magnitudeCurve","magnitude","fromValues","perlineScale","scaleByView","constructor","SetName","name","Update","camera","_current","_deltaTime","localElapsedTime","_anchorPosition","_anchorRadius","_anchorForwardDirection","out","create","offset","clone","duration","Number","GetAnimationTimelineLength","time","scale","GetValue","distance","GetPointOfInterest","GetPosition","Math","atan","GetRightDirection","scaleAndAdd","GetUpDirection","GetForwardDirection","#clampedNoise","frequency","TriPerlinCurve","PerlinNoise1D","#createMagnitudeCurve","curve","Tr2CurveScalar","SetExtrapolation","Tr2CurveExtrapolation","LINEAR","AddKey","#allocatePhase","phase"],"mappings":"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"}

package/dist/eve/virtualCamera/transition/EveVirtualCameraTransitionBase.js

@@ -1,9 +1,14 @@
 import { applyDecs2311 as _applyDecs2311 } from '../../../_virtual/_rollupPluginBabelHelpers.js';
-import { CjsModel } from '@carbonenginejs/core-types/model';
-import { carbon, impl, type } from '@carbonenginejs/core-types/schema';
+import { CjsModel } from '@carbonenginejs/runtime-utils/model';
+import { carbon, impl, type } from '@carbonenginejs/runtime-utils/schema';
 import { EveVirtualCamera as _EveVirtualCamera } from '../EveVirtualCamera.js';
 
 let _initProto, _initClass, _init_sourceCamera, _init_extra_sourceCamera, _init_targetCamera, _init_extra_targetCamera, _init_transitionCamera, _init_extra_transitionCamera;
+
+/**
+ * Base for camera hand-overs, owning the source and target cameras plus the
+ * temporary camera that is rendered while the hand-over runs.
+ */
 let _EveVirtualCameraTran;
 class EveVirtualCameraTransitionBase extends CjsModel {
   static {
@@ -22,15 +27,36 @@ class EveVirtualCameraTransitionBase extends CjsModel {
   sourceCamera = (_initProto(this), _init_sourceCamera(this, null));
   targetCamera = (_init_extra_sourceCamera(this), _init_targetCamera(this, null));
   transitionCamera = (_init_extra_targetCamera(this), _init_transitionCamera(this, null));
+
+  /**
+   * Returns the camera to render from: the target once the transition has
+   * completed, otherwise the temporary transition camera.
+   */
   GetCamera() {
     return this.IsComplete() ? this.targetCamera : this.transitionCamera;
   }
+
+  /**
+   * Sets the camera the transition starts from; it is paused when the transition
+   * stops.
+   */
   SetSource(camera) {
     this.sourceCamera = camera;
   }
+
+  /**
+   * Sets the camera the transition hands control to; its timeline is reset on
+   * Play and it is resumed on Stop.
+   */
   SetTarget(camera) {
     this.targetCamera = camera;
   }
+
+  /**
+   * Starts the transition: creates the temporary transition camera seeded with
+   * the source camera's transform, rewinds the target camera's timeline, and
+   * starts the transition camera running.
+   */
   Play() {
     this.transitionCamera = new _EveVirtualCamera();
     this.transitionCamera.SetName("transitionCamera");
@@ -40,11 +66,21 @@ class EveVirtualCameraTransitionBase extends CjsModel {
     this.targetCamera?.Reset();
     this.transitionCamera.Play();
   }
+
+  /**
+   * Ends the transition by resuming the target camera and pausing the source and
+   * transition cameras.
+   */
   Stop() {
     this.targetCamera?.Play();
     this.sourceCamera?.Pause();
     this.transitionCamera?.Pause();
   }
+
+  /**
+   * Advances the transition camera and stops the transition as soon as the
+   * subclass reports it complete.
+   */
   Update(deltaTime) {
     this.transitionCamera?.Update(deltaTime);
     if (this.IsComplete()) {

package/dist/eve/virtualCamera/transition/EveVirtualCameraTransitionBase.js.map

@@ -1 +1 @@
-{"version":3,"file":"EveVirtualCameraTransitionBase.js","sources":["../../../../../src/eve/virtualCamera/transition/EveVirtualCameraTransitionBase.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\Eve\\VirtualCamera\\EveVirtualCameraTransition.h\n// Source: E:\\carbonengine\\trinity\\trinity\\Eve\\VirtualCamera\\EveVirtualCameraTransition.cpp\nimport { CjsModel } from \"@carbonenginejs/core-types/model\";\nimport { carbon, impl, type } from \"@carbonenginejs/core-types/schema\";\nimport { EveVirtualCamera } from \"../EveVirtualCamera.js\";\n\n\n@type.define({\n  className: \"EveVirtualCameraTransitionBase\",\n  family: \"eve/virtualCamera/transition\"\n})\nexport class EveVirtualCameraTransitionBase extends CjsModel\n{\n  @type.objectRef(\"EveVirtualCamera\")\n  sourceCamera = null;\n\n  @type.objectRef(\"EveVirtualCamera\")\n  targetCamera = null;\n\n  @type.objectRef(\"EveVirtualCamera\")\n  transitionCamera = null;\n\n  @carbon.method\n  @impl.implemented\n  GetCamera()\n  {\n    return this.IsComplete() ? this.targetCamera : this.transitionCamera;\n  }\n\n  @carbon.method\n  @impl.implemented\n  SetSource(camera)\n  {\n    this.sourceCamera = camera;\n  }\n\n  @carbon.method\n  @impl.implemented\n  SetTarget(camera)\n  {\n    this.targetCamera = camera;\n  }\n\n  @carbon.method\n  @impl.implemented\n  Play()\n  {\n    this.transitionCamera = new EveVirtualCamera();\n    this.transitionCamera.SetName(\"transitionCamera\");\n    if (this.sourceCamera)\n    {\n      this.transitionCamera.CopyTransform(this.sourceCamera);\n    }\n    this.targetCamera?.Reset();\n    this.transitionCamera.Play();\n  }\n\n  @carbon.method\n  @impl.implemented\n  Stop()\n  {\n    this.targetCamera?.Play();\n    this.sourceCamera?.Pause();\n    this.transitionCamera?.Pause();\n  }\n\n  @carbon.method\n  @impl.implemented\n  Update(deltaTime)\n  {\n    this.transitionCamera?.Update(deltaTime);\n    if (this.IsComplete())\n    {\n      this.Stop();\n    }\n  }\n}\n"],"names":["_EveVirtualCameraTran","EveVirtualCameraTransitionBase","CjsModel","e","_init_sourceCamera","_init_extra_sourceCamera","_init_targetCamera","_init_extra_targetCamera","_init_transitionCamera","_init_extra_transitionCamera","_initProto","c","_initClass","_applyDecs","type","define","className","family","objectRef","carbon","method","impl","implemented","constructor","args","sourceCamera","targetCamera","transitionCamera","GetCamera","IsComplete","SetSource","camera","SetTarget","Play","EveVirtualCamera","SetName","CopyTransform","Reset","Stop","Pause","Update","deltaTime"],"mappings":"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"}
+{"version":3,"file":"EveVirtualCameraTransitionBase.js","sources":["../../../../../src/eve/virtualCamera/transition/EveVirtualCameraTransitionBase.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\Eve\\VirtualCamera\\EveVirtualCameraTransition.h\n// Source: E:\\carbonengine\\trinity\\trinity\\Eve\\VirtualCamera\\EveVirtualCameraTransition.cpp\nimport { CjsModel } from \"@carbonenginejs/runtime-utils/model\";\nimport { carbon, impl, type } from \"@carbonenginejs/runtime-utils/schema\";\nimport { EveVirtualCamera } from \"../EveVirtualCamera.js\";\n\n\n/**\n * Base for camera hand-overs, owning the source and target cameras plus the\n * temporary camera that is rendered while the hand-over runs.\n */\n@type.define({\n  className: \"EveVirtualCameraTransitionBase\",\n  family: \"eve/virtualCamera/transition\"\n})\nexport class EveVirtualCameraTransitionBase extends CjsModel\n{\n  @type.objectRef(\"EveVirtualCamera\")\n  sourceCamera = null;\n\n  @type.objectRef(\"EveVirtualCamera\")\n  targetCamera = null;\n\n  @type.objectRef(\"EveVirtualCamera\")\n  transitionCamera = null;\n\n  /**\n   * Returns the camera to render from: the target once the transition has\n   * completed, otherwise the temporary transition camera.\n   */\n  @carbon.method\n  @impl.implemented\n  GetCamera()\n  {\n    return this.IsComplete() ? this.targetCamera : this.transitionCamera;\n  }\n\n  /**\n   * Sets the camera the transition starts from; it is paused when the transition\n   * stops.\n   */\n  @carbon.method\n  @impl.implemented\n  SetSource(camera)\n  {\n    this.sourceCamera = camera;\n  }\n\n  /**\n   * Sets the camera the transition hands control to; its timeline is reset on\n   * Play and it is resumed on Stop.\n   */\n  @carbon.method\n  @impl.implemented\n  SetTarget(camera)\n  {\n    this.targetCamera = camera;\n  }\n\n  /**\n   * Starts the transition: creates the temporary transition camera seeded with\n   * the source camera's transform, rewinds the target camera's timeline, and\n   * starts the transition camera running.\n   */\n  @carbon.method\n  @impl.implemented\n  Play()\n  {\n    this.transitionCamera = new EveVirtualCamera();\n    this.transitionCamera.SetName(\"transitionCamera\");\n    if (this.sourceCamera)\n    {\n      this.transitionCamera.CopyTransform(this.sourceCamera);\n    }\n    this.targetCamera?.Reset();\n    this.transitionCamera.Play();\n  }\n\n  /**\n   * Ends the transition by resuming the target camera and pausing the source and\n   * transition cameras.\n   */\n  @carbon.method\n  @impl.implemented\n  Stop()\n  {\n    this.targetCamera?.Play();\n    this.sourceCamera?.Pause();\n    this.transitionCamera?.Pause();\n  }\n\n  /**\n   * Advances the transition camera and stops the transition as soon as the\n   * subclass reports it complete.\n   */\n  @carbon.method\n  @impl.implemented\n  Update(deltaTime)\n  {\n    this.transitionCamera?.Update(deltaTime);\n    if (this.IsComplete())\n    {\n      this.Stop();\n    }\n  }\n}\n"],"names":["_EveVirtualCameraTran","EveVirtualCameraTransitionBase","CjsModel","e","_init_sourceCamera","_init_extra_sourceCamera","_init_targetCamera","_init_extra_targetCamera","_init_transitionCamera","_init_extra_transitionCamera","_initProto","c","_initClass","_applyDecs","type","define","className","family","objectRef","carbon","method","impl","implemented","constructor","args","sourceCamera","targetCamera","transitionCamera","GetCamera","IsComplete","SetSource","camera","SetTarget","Play","EveVirtualCamera","SetName","CopyTransform","Reset","Stop","Pause","Update","deltaTime"],"mappings":"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"}

package/dist/eve/virtualCamera/transition/EveVirtualCameraTransitionCut.js

@@ -1,8 +1,13 @@
 import { applyDecs2311 as _applyDecs2311 } from '../../../_virtual/_rollupPluginBabelHelpers.js';
-import { carbon, impl, type } from '@carbonenginejs/core-types/schema';
+import { carbon, impl, type } from '@carbonenginejs/runtime-utils/schema';
 import { EveVirtualCameraTransitionBase as _EveVirtualCameraTran$1 } from './EveVirtualCameraTransitionBase.js';
 
 let _initProto, _initClass;
+
+/**
+ * Transition that hands control to the target camera on the frame it starts,
+ * with no blend.
+ */
 let _EveVirtualCameraTran;
 class EveVirtualCameraTransitionCut extends _EveVirtualCameraTran$1 {
   static {
@@ -18,9 +23,15 @@ class EveVirtualCameraTransitionCut extends _EveVirtualCameraTran$1 {
     super(...args);
     _initProto(this);
   }
+  /** Always reports complete, which is what makes the hand-over a cut. */
   IsComplete() {
     return true;
   }
+
+  /**
+   * Defers to the base update, which immediately stops the transition because a
+   * cut is already complete.
+   */
   Update(deltaTime) {
     super.Update(deltaTime);
   }

package/dist/eve/virtualCamera/transition/EveVirtualCameraTransitionCut.js.map

@@ -1 +1 @@
-{"version":3,"file":"EveVirtualCameraTransitionCut.js","sources":["../../../../../src/eve/virtualCamera/transition/EveVirtualCameraTransitionCut.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\Eve\\VirtualCamera\\EveVirtualCameraTransition.h\n// Source: E:\\carbonengine\\trinity\\trinity\\Eve\\VirtualCamera\\EveVirtualCameraTransition.cpp\nimport { carbon, impl, type } from \"@carbonenginejs/core-types/schema\";\nimport { EveVirtualCameraTransitionBase } from \"./EveVirtualCameraTransitionBase.js\";\n\n\n@type.define({\n  className: \"EveVirtualCameraTransitionCut\",\n  family: \"eve/virtualCamera/transition\"\n})\nexport class EveVirtualCameraTransitionCut extends EveVirtualCameraTransitionBase\n{\n  @carbon.method\n  @impl.implemented\n  IsComplete()\n  {\n    return true;\n  }\n\n  @carbon.method\n  @impl.implemented\n  Update(deltaTime)\n  {\n    super.Update(deltaTime);\n  }\n}\n"],"names":["_EveVirtualCameraTran","EveVirtualCameraTransitionCut","EveVirtualCameraTransitionBase","e","_initProto","c","_initClass","_applyDecs","type","define","className","family","carbon","method","impl","implemented","constructor","args","IsComplete","Update","deltaTime"],"mappings":";;;;;AAGqF,IAAAA;AAGrF,MAAAC,6BAAA,SAImDC,uBAA8B,CACjF;AAAA,EAAA;AAAA,IAAA,CAAA;AAAAC,MAAAA,CAAA,GAAAC,UAAA,CAAA;MAAAC,CAAA,EAAA,CAAAL,qBAAA,EAAAM,UAAA;AAAA,KAAA,GAAAC,cAAA,CAAA,IAAA,EAAA,CALCC,IAAI,CAACC,MAAM,CAAC;AACXC,MAAAA,SAAS,EAAE,+BAA+B;AAC1CC,MAAAA,MAAM,EAAE;KACT,CAAC,CAAA,EAAA,CAAA,CAAA,CAGCC,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACC,WAAW,wBAMhBH,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACC,WAAW,CAAA,EAAA,EAAA,EAAA,QAAA,CAAA,CAAA,EAAA,CAAA,EAAA,MAAA,EAVgCb,uBAA8B,CAAA;AAAA;AAAAc,EAAAA,WAAAA,CAAA,GAAAC,IAAA,EAAA;AAAA,IAAA,KAAA,CAAA,GAAAA,IAAA,CAAA;IAAAb,UAAA,CAAA,IAAA,CAAA;AAAA,EAAA;AAI/Ec,EAAAA,UAAUA,GACV;AACE,IAAA,OAAO,IAAI;AACb,EAAA;EAIAC,MAAMA,CAACC,SAAS,EAChB;AACE,IAAA,KAAK,CAACD,MAAM,CAACC,SAAS,CAAC;AACzB,EAAA;AAAC,EAAA;IAAAd,UAAA,EAAA;AAAA;AACH;;;;"}
+{"version":3,"file":"EveVirtualCameraTransitionCut.js","sources":["../../../../../src/eve/virtualCamera/transition/EveVirtualCameraTransitionCut.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\Eve\\VirtualCamera\\EveVirtualCameraTransition.h\n// Source: E:\\carbonengine\\trinity\\trinity\\Eve\\VirtualCamera\\EveVirtualCameraTransition.cpp\nimport { carbon, impl, type } from \"@carbonenginejs/runtime-utils/schema\";\nimport { EveVirtualCameraTransitionBase } from \"./EveVirtualCameraTransitionBase.js\";\n\n\n/**\n * Transition that hands control to the target camera on the frame it starts,\n * with no blend.\n */\n@type.define({\n  className: \"EveVirtualCameraTransitionCut\",\n  family: \"eve/virtualCamera/transition\"\n})\nexport class EveVirtualCameraTransitionCut extends EveVirtualCameraTransitionBase\n{\n  /** Always reports complete, which is what makes the hand-over a cut. */\n  @carbon.method\n  @impl.implemented\n  IsComplete()\n  {\n    return true;\n  }\n\n  /**\n   * Defers to the base update, which immediately stops the transition because a\n   * cut is already complete.\n   */\n  @carbon.method\n  @impl.implemented\n  Update(deltaTime)\n  {\n    super.Update(deltaTime);\n  }\n}\n"],"names":["_EveVirtualCameraTran","EveVirtualCameraTransitionCut","EveVirtualCameraTransitionBase","e","_initProto","c","_initClass","_applyDecs","type","define","className","family","carbon","method","impl","implemented","constructor","args","IsComplete","Update","deltaTime"],"mappings":";;;;;;AAMA;AACA;AACA;AACA;AAHA,IAAAA;AAIA,MAAAC,6BAAA,SAImDC,uBAA8B,CACjF;AAAA,EAAA;AAAA,IAAA,CAAA;AAAAC,MAAAA,CAAA,GAAAC,UAAA,CAAA;MAAAC,CAAA,EAAA,CAAAL,qBAAA,EAAAM,UAAA;AAAA,KAAA,GAAAC,cAAA,CAAA,IAAA,EAAA,CALCC,IAAI,CAACC,MAAM,CAAC;AACXC,MAAAA,SAAS,EAAE,+BAA+B;AAC1CC,MAAAA,MAAM,EAAE;KACT,CAAC,CAAA,EAAA,CAAA,CAAA,CAICC,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACC,WAAW,wBAUhBH,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACC,WAAW,CAAA,EAAA,EAAA,EAAA,QAAA,CAAA,CAAA,EAAA,CAAA,EAAA,MAAA,EAfgCb,uBAA8B,CAAA;AAAA;AAAAc,EAAAA,WAAAA,CAAA,GAAAC,IAAA,EAAA;AAAA,IAAA,KAAA,CAAA,GAAAA,IAAA,CAAA;IAAAb,UAAA,CAAA,IAAA,CAAA;AAAA,EAAA;AAE/E;AAGAc,EAAAA,UAAUA,GACV;AACE,IAAA,OAAO,IAAI;AACb,EAAA;;AAEA;AACF;AACA;AACA;EAGEC,MAAMA,CAACC,SAAS,EAChB;AACE,IAAA,KAAK,CAACD,MAAM,CAACC,SAAS,CAAC;AACzB,EAAA;AAAC,EAAA;IAAAd,UAAA,EAAA;AAAA;AACH;;;;"}

package/dist/eve/virtualCamera/transition/EveVirtualCameraTransitionLerp.js

@@ -1,10 +1,15 @@
 import { applyDecs2311 as _applyDecs2311 } from '../../../_virtual/_rollupPluginBabelHelpers.js';
-import { vec3 } from '@carbonenginejs/core-math/vec3';
-import { io, type, carbon, impl } from '@carbonenginejs/core-types/schema';
+import { vec3 } from '@carbonenginejs/runtime-utils/vec3';
+import { io, type, carbon, impl } from '@carbonenginejs/runtime-utils/schema';
 import { Tr2CurveScalar as _Tr2CurveScalar } from '../../../curves/Tr2CurveScalar.js';
 import { EveVirtualCameraTransitionBase as _EveVirtualCameraTran$1 } from './EveVirtualCameraTransitionBase.js';
 
 let _initProto, _initClass, _init_tansitionTime, _init_extra_tansitionTime;
+
+/**
+ * Transition that blends position, point of interest, field of view and roll
+ * from the source camera to the target camera over a fixed duration.
+ */
 let _EveVirtualCameraTran;
 class EveVirtualCameraTransitionLerp extends _EveVirtualCameraTran$1 {
   static {
@@ -19,14 +24,30 @@ class EveVirtualCameraTransitionLerp extends _EveVirtualCameraTran$1 {
   tansitionTime = (_initProto(this), _init_tansitionTime(this, 1));
   #localTime = (_init_extra_tansitionTime(this), 0);
   #transitionCurve = new _Tr2CurveScalar();
+
+  /**
+   * Builds the private linear 0-to-1 curve that maps normalized transition time
+   * to blend amount.
+   */
   constructor() {
     super();
     this.#transitionCurve.AddKey(0, 0);
     this.#transitionCurve.AddKey(1, 1);
   }
+
+  /**
+   * Reports whether the elapsed blend time has passed the configured transition
+   * time.
+   */
   IsComplete() {
     return this.#localTime > this.tansitionTime;
   }
+
+  /**
+   * Starts the blend from zero and scrubs the target camera back to minus the
+   * transition time, so its own timeline reaches zero exactly as the blend
+   * finishes.
+   */
   Play() {
     this.#localTime = 0;
     super.Play();
@@ -35,6 +56,12 @@ class EveVirtualCameraTransitionLerp extends _EveVirtualCameraTran$1 {
       this.targetCamera.Play();
     }
   }
+
+  /**
+   * Advances the blend clock and drives the transition camera externally with
+   * the source and target transforms interpolated by the transition curve,
+   * clamped to 0..1; a zero transition time jumps straight to the target.
+   */
   Update(deltaTime) {
     this.#localTime += deltaTime;
     if (this.transitionCamera && this.sourceCamera && this.targetCamera) {
@@ -46,9 +73,19 @@ class EveVirtualCameraTransitionLerp extends _EveVirtualCameraTran$1 {
     }
     super.Update(deltaTime);
   }
+
+  /**
+   * Returns the blend duration in seconds; the backing field keeps Carbon's
+   * misspelled attribute name "tansitionTime" so persisted data round-trips.
+   */
   GetTransitionTime() {
     return this.tansitionTime;
   }
+
+  /**
+   * Sets the blend duration in seconds; the camera system calls this before
+   * playing the transition.
+   */
   SetTransitionTime(value) {
     this.tansitionTime = value;
   }

package/dist/eve/virtualCamera/transition/EveVirtualCameraTransitionLerp.js.map

@@ -1 +1 @@
-{"version":3,"file":"EveVirtualCameraTransitionLerp.js","sources":["../../../../../src/eve/virtualCamera/transition/EveVirtualCameraTransitionLerp.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\Eve\\VirtualCamera\\EveVirtualCameraTransition.h\n// Source: E:\\carbonengine\\trinity\\trinity\\Eve\\VirtualCamera\\EveVirtualCameraTransition.cpp\nimport { vec3 } from \"@carbonenginejs/core-math/vec3\";\nimport { carbon, impl, io, type } from \"@carbonenginejs/core-types/schema\";\nimport { Tr2CurveScalar } from \"../../../curves/Tr2CurveScalar.js\";\nimport { EveVirtualCameraTransitionBase } from \"./EveVirtualCameraTransitionBase.js\";\n\n\n@type.define({\n  className: \"EveVirtualCameraTransitionLerp\",\n  family: \"eve/virtualCamera/transition\"\n})\nexport class EveVirtualCameraTransitionLerp extends EveVirtualCameraTransitionBase\n{\n  @io.persist\n  @type.float32\n  tansitionTime = 1;\n\n  #localTime = 0;\n\n  #transitionCurve = new Tr2CurveScalar();\n\n  constructor()\n  {\n    super();\n    this.#transitionCurve.AddKey(0, 0);\n    this.#transitionCurve.AddKey(1, 1);\n  }\n\n  @carbon.method\n  @impl.implemented\n  IsComplete()\n  {\n    return this.#localTime > this.tansitionTime;\n  }\n\n  @carbon.method\n  @impl.implemented\n  Play()\n  {\n    this.#localTime = 0;\n    super.Play();\n    if (this.targetCamera)\n    {\n      this.targetCamera.UpdateToLocalTime(-this.tansitionTime);\n      this.targetCamera.Play();\n    }\n  }\n\n  @carbon.method\n  @impl.adapted\n  Update(deltaTime)\n  {\n    this.#localTime += deltaTime;\n    if (this.transitionCamera && this.sourceCamera && this.targetCamera)\n    {\n      let amount = 1;\n      if (this.tansitionTime > 0)\n      {\n        amount = Math.max(0, Math.min(1, this.#transitionCurve.GetValue(this.#localTime / this.tansitionTime)));\n      }\n      this.transitionCamera.UpdateExternal(\n        vec3.lerp(vec3.create(), this.sourceCamera.GetPosition(), this.targetCamera.GetPosition(), amount),\n        vec3.lerp(vec3.create(), this.sourceCamera.GetPointOfInterest(), this.targetCamera.GetPointOfInterest(), amount),\n        this.sourceCamera.GetFov() + (this.targetCamera.GetFov() - this.sourceCamera.GetFov()) * amount,\n        this.sourceCamera.GetRoll() + (this.targetCamera.GetRoll() - this.sourceCamera.GetRoll()) * amount\n      );\n    }\n    super.Update(deltaTime);\n  }\n\n  @carbon.method\n  @impl.implemented\n  GetTransitionTime()\n  {\n    return this.tansitionTime;\n  }\n\n  @carbon.method\n  @impl.implemented\n  SetTransitionTime(value)\n  {\n    this.tansitionTime = value;\n  }\n}\n"],"names":["_EveVirtualCameraTran","EveVirtualCameraTransitionLerp","EveVirtualCameraTransitionBase","e","_init_tansitionTime","_init_extra_tansitionTime","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","persist","float32","carbon","method","impl","implemented","adapted","tansitionTime","Tr2CurveScalar","constructor","AddKey","IsComplete","Play","targetCamera","UpdateToLocalTime","Update","deltaTime","transitionCamera","sourceCamera","amount","Math","max","min","GetValue","UpdateExternal","vec3","lerp","create","GetPosition","GetPointOfInterest","GetFov","GetRoll","GetTransitionTime","SetTransitionTime","value"],"mappings":"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"}
+{"version":3,"file":"EveVirtualCameraTransitionLerp.js","sources":["../../../../../src/eve/virtualCamera/transition/EveVirtualCameraTransitionLerp.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\Eve\\VirtualCamera\\EveVirtualCameraTransition.h\n// Source: E:\\carbonengine\\trinity\\trinity\\Eve\\VirtualCamera\\EveVirtualCameraTransition.cpp\nimport { vec3 } from \"@carbonenginejs/runtime-utils/vec3\";\nimport { carbon, impl, io, type } from \"@carbonenginejs/runtime-utils/schema\";\nimport { Tr2CurveScalar } from \"../../../curves/Tr2CurveScalar.js\";\nimport { EveVirtualCameraTransitionBase } from \"./EveVirtualCameraTransitionBase.js\";\n\n\n/**\n * Transition that blends position, point of interest, field of view and roll\n * from the source camera to the target camera over a fixed duration.\n */\n@type.define({\n  className: \"EveVirtualCameraTransitionLerp\",\n  family: \"eve/virtualCamera/transition\"\n})\nexport class EveVirtualCameraTransitionLerp extends EveVirtualCameraTransitionBase\n{\n  @io.persist\n  @type.float32\n  tansitionTime = 1;\n\n  #localTime = 0;\n\n  #transitionCurve = new Tr2CurveScalar();\n\n  /**\n   * Builds the private linear 0-to-1 curve that maps normalized transition time\n   * to blend amount.\n   */\n  constructor()\n  {\n    super();\n    this.#transitionCurve.AddKey(0, 0);\n    this.#transitionCurve.AddKey(1, 1);\n  }\n\n  /**\n   * Reports whether the elapsed blend time has passed the configured transition\n   * time.\n   */\n  @carbon.method\n  @impl.implemented\n  IsComplete()\n  {\n    return this.#localTime > this.tansitionTime;\n  }\n\n  /**\n   * Starts the blend from zero and scrubs the target camera back to minus the\n   * transition time, so its own timeline reaches zero exactly as the blend\n   * finishes.\n   */\n  @carbon.method\n  @impl.implemented\n  Play()\n  {\n    this.#localTime = 0;\n    super.Play();\n    if (this.targetCamera)\n    {\n      this.targetCamera.UpdateToLocalTime(-this.tansitionTime);\n      this.targetCamera.Play();\n    }\n  }\n\n  /**\n   * Advances the blend clock and drives the transition camera externally with\n   * the source and target transforms interpolated by the transition curve,\n   * clamped to 0..1; a zero transition time jumps straight to the target.\n   */\n  @carbon.method\n  @impl.adapted\n  Update(deltaTime)\n  {\n    this.#localTime += deltaTime;\n    if (this.transitionCamera && this.sourceCamera && this.targetCamera)\n    {\n      let amount = 1;\n      if (this.tansitionTime > 0)\n      {\n        amount = Math.max(0, Math.min(1, this.#transitionCurve.GetValue(this.#localTime / this.tansitionTime)));\n      }\n      this.transitionCamera.UpdateExternal(\n        vec3.lerp(vec3.create(), this.sourceCamera.GetPosition(), this.targetCamera.GetPosition(), amount),\n        vec3.lerp(vec3.create(), this.sourceCamera.GetPointOfInterest(), this.targetCamera.GetPointOfInterest(), amount),\n        this.sourceCamera.GetFov() + (this.targetCamera.GetFov() - this.sourceCamera.GetFov()) * amount,\n        this.sourceCamera.GetRoll() + (this.targetCamera.GetRoll() - this.sourceCamera.GetRoll()) * amount\n      );\n    }\n    super.Update(deltaTime);\n  }\n\n  /**\n   * Returns the blend duration in seconds; the backing field keeps Carbon's\n   * misspelled attribute name \"tansitionTime\" so persisted data round-trips.\n   */\n  @carbon.method\n  @impl.implemented\n  GetTransitionTime()\n  {\n    return this.tansitionTime;\n  }\n\n  /**\n   * Sets the blend duration in seconds; the camera system calls this before\n   * playing the transition.\n   */\n  @carbon.method\n  @impl.implemented\n  SetTransitionTime(value)\n  {\n    this.tansitionTime = value;\n  }\n}\n"],"names":["_EveVirtualCameraTran","EveVirtualCameraTransitionLerp","EveVirtualCameraTransitionBase","e","_init_tansitionTime","_init_extra_tansitionTime","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","persist","float32","carbon","method","impl","implemented","adapted","tansitionTime","Tr2CurveScalar","constructor","AddKey","IsComplete","Play","targetCamera","UpdateToLocalTime","Update","deltaTime","transitionCamera","sourceCamera","amount","Math","max","min","GetValue","UpdateExternal","vec3","lerp","create","GetPosition","GetPointOfInterest","GetFov","GetRoll","GetTransitionTime","SetTransitionTime","value"],"mappings":"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"}

package/dist/eve/volume/EveBoxVolume.js

@@ -1,10 +1,15 @@
 import { identity as _identity, applyDecs2311 as _applyDecs2311 } from '../../_virtual/_rollupPluginBabelHelpers.js';
-import { quat } from '@carbonenginejs/core-math/quat';
-import { vec3 } from '@carbonenginejs/core-math/vec3';
-import { CjsModel } from '@carbonenginejs/core-types/model';
-import { io, type, carbon, impl } from '@carbonenginejs/core-types/schema';
+import { quat } from '@carbonenginejs/runtime-utils/quat';
+import { vec3 } from '@carbonenginejs/runtime-utils/vec3';
+import { CjsModel } from '@carbonenginejs/runtime-utils/model';
+import { io, type, carbon, impl } from '@carbonenginejs/runtime-utils/schema';
 
 let _initProto, _initClass, _init_position, _init_extra_position, _init_scaling, _init_extra_scaling, _init_innerScaling, _init_extra_innerScaling, _init_rotation, _init_extra_rotation, _init_name, _init_extra_name, _init_debugShowIntersection, _init_extra_debugShowIntersection;
+
+/**
+ * Oriented box of influence with a hollow inner box, weighting points by falloff
+ * and seeding random points across its shell.
+ */
 let _EveBoxVolume;
 new class extends _identity {
   static [class EveBoxVolume extends CjsModel {
@@ -26,16 +31,33 @@ new class extends _identity {
     #callbacks = (_init_extra_debugShowIntersection(this), new Map());
     #nextCallbackId = 1;
     #inverseRotation = quat.create();
+
+    /**
+     * Clamps the authored scalings and caches the inverse rotation the intensity
+     * test needs.
+     */
     Initialize() {
       this.#setup();
       return true;
     }
+
+    /**
+     * Returns a fresh sphere centred on the box position whose radius is half the
+     * length of the scaling vector.
+     */
     GetBoundingSphere() {
       return {
         center: vec3.clone(this.position),
         radius: vec3.length(this.scaling) * 0.5
       };
     }
+
+    /**
+     * Returns the falloff weight for a point given in the volume's own space: the
+     * point is moved into box-local space with the cached inverse rotation, then
+     * compared radially against the inner and outer boxes - 1 inside the inner
+     * box, 0 outside the outer one, and a squared ramp between them.
+     */
     GetIntensity(position) {
       const local = _EveBoxVolume.#toLocal(position, this.position, this.#inverseRotation);
       const outer = _EveBoxVolume.#radialBoxDistance(local, this.scaling);
@@ -51,6 +73,13 @@ new class extends _identity {
       const ratio = span > 0 ? (outer - distance) / span : 0;
       return ratio * ratio;
     }
+
+    /**
+     * Appends random points expressed in box-local space, centred on the box rather than offset by its position, choosing between the inner box and the six shell zones in proportion to their volumes and biasing shell samples outward by fallOffFactor. Generates nothing when any scaling axis is zero.
+     *
+     * @param points Caller-owned array the new points are pushed onto.
+     * @param excludeInnerVolume Drops the inner box from the choice, keeping every point in the shell.
+     */
     GeneratePointsInVolume(points, howManyToAdd, excludeInnerVolume, fallOffFactor) {
       if (this.scaling[0] === 0 || this.scaling[1] === 0 || this.scaling[2] === 0) {
         return;
@@ -97,14 +126,26 @@ new class extends _identity {
         points.push(position);
       }
     }
+
+    /**
+     * Registers a callback fired whenever the volume changes, returning the id
+     * needed to unregister it again.
+     */
     RegisterForChanges(callback) {
       const id = this.#nextCallbackId++;
       this.#callbacks.set(id, callback);
       return id;
     }
+
+    /** Drops a change callback by the id RegisterForChanges returned. */
     UnregisterForChanges(callbackId) {
       this.#callbacks.delete(callbackId);
     }
+
+    /**
+     * Re-clamps the scalings and the cached inverse rotation after an authored
+     * change, then notifies every registered listener.
+     */
     OnModified() {
       this.#setup();
       for (const callback of this.#callbacks.values()) {
@@ -112,7 +153,14 @@ new class extends _identity {
       }
       return true;
     }
+
+    /** No debug drawing in this port. */
     RenderDebugInfo() {}
+
+    /**
+     * Clamps the scaling to non-negative values, keeps the inner scaling inside
+     * it, and caches the inverse of the box rotation.
+     */
     #setup() {
       for (let i = 0; i < 3; i++) {
         this.scaling[i] = Math.max(0, this.scaling[i]);
@@ -120,6 +168,17 @@ new class extends _identity {
       }
       quat.invert(this.#inverseRotation, this.rotation);
     }
+
+    /**
+     * Moves a point into box-local space by subtracting the box centre and
+     * applying the inverse rotation.
+     */
+
+    /**
+     * Returns how far the box surface lies from the centre along the direction of
+     * the given local point, falling back to half the smallest extent when the
+     * point sits at the centre.
+     */
   }];
   #toLocal(position, center, inverseRotation) {
     const local = vec3.subtract(vec3.create(), position, center);

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

@@ -1 +1 @@
-{"version":3,"file":"EveBoxVolume.js","sources":["../../../../src/eve/volume/EveBoxVolume.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\Eve\\Volume\\EveBoxVolume.h\n// Source: E:\\carbonengine\\trinity\\trinity\\Eve\\Volume\\EveBoxVolume.cpp\n// Source: E:\\carbonengine\\trinity\\trinity\\Eve\\Volume\\EveBoxVolume_Blue.cpp\nimport { quat } from \"@carbonenginejs/core-math/quat\";\nimport { vec3 } from \"@carbonenginejs/core-math/vec3\";\nimport { CjsModel } from \"@carbonenginejs/core-types/model\";\nimport { carbon, impl, io, type } from \"@carbonenginejs/core-types/schema\";\n\n\n@type.define({\n  className: \"EveBoxVolume\",\n  family: \"eve/volume\"\n})\nexport class EveBoxVolume extends CjsModel\n{\n  @io.notify\n  @io.persist\n  @type.vec3\n  position = vec3.create();\n\n  @io.notify\n  @io.persist\n  @type.vec3\n  scaling = vec3.create();\n\n  @io.notify\n  @io.persist\n  @type.vec3\n  innerScaling = vec3.create();\n\n  @io.notify\n  @io.persist\n  @type.quat\n  rotation = quat.create();\n\n  @io.persist\n  @type.string\n  name = \"\";\n\n  @io.readwrite\n  @type.boolean\n  debugShowIntersection = false;\n\n  #callbacks = new Map();\n\n  #nextCallbackId = 1;\n\n  #inverseRotation = quat.create();\n\n  @carbon.method\n  @impl.implemented\n  Initialize()\n  {\n    this.#setup();\n    return true;\n  }\n\n  @carbon.method\n  @impl.adapted\n  GetBoundingSphere()\n  {\n    return {\n      center: vec3.clone(this.position),\n      radius: vec3.length(this.scaling) * 0.5\n    };\n  }\n\n  @carbon.method\n  @impl.adapted\n  GetIntensity(position)\n  {\n    const local = EveBoxVolume.#toLocal(position, this.position, this.#inverseRotation);\n    const outer = EveBoxVolume.#radialBoxDistance(local, this.scaling);\n    const distance = vec3.length(local);\n    if (!(outer > 0) || distance > outer)\n    {\n      return 0;\n    }\n    const inner = EveBoxVolume.#radialBoxDistance(local, this.innerScaling);\n    if (inner > 0 && distance <= inner)\n    {\n      return 1;\n    }\n    const span = outer - inner;\n    const ratio = span > 0 ? (outer - distance) / span : 0;\n    return ratio * ratio;\n  }\n\n  @carbon.method\n  @impl.adapted\n  GeneratePointsInVolume(points, howManyToAdd, excludeInnerVolume, fallOffFactor)\n  {\n    if (this.scaling[0] === 0 || this.scaling[1] === 0 || this.scaling[2] === 0)\n    {\n      return;\n    }\n\n    const leftRightSideSize = (this.scaling[0] - this.innerScaling[0])\n      * this.scaling[1] * this.scaling[2];\n    const topBottomSize = this.innerScaling[0]\n      * (this.scaling[1] - this.innerScaling[1]) * this.scaling[2];\n    const frontBackLidSize = this.innerScaling[0] * this.innerScaling[1]\n      * (this.scaling[2] - this.innerScaling[2]);\n    const outerSidesSize = 2 * (leftRightSideSize + topBottomSize + frontBackLidSize);\n    let innerToOuterSizeRatio = 0;\n\n    if (!excludeInnerVolume)\n    {\n      const rangeX = this.scaling[0] - this.innerScaling[0];\n      const rangeY = this.scaling[1] - this.innerScaling[1];\n      const rangeZ = this.scaling[2] - this.innerScaling[2];\n      const adjustedOuterCubeSize = (this.innerScaling[0] + 0.5 * rangeX)\n        * (this.innerScaling[1] + 0.5 * rangeY)\n        * (this.innerScaling[2] + 0.5 * rangeZ);\n      innerToOuterSizeRatio = this.innerScaling[0] * this.innerScaling[1]\n        * this.innerScaling[2] / adjustedOuterCubeSize;\n      innerToOuterSizeRatio = 1 - Math.pow(\n        1 - innerToOuterSizeRatio,\n        0.8 + 0.2 * fallOffFactor\n      );\n    }\n\n    const count = Math.max(0, Math.trunc(howManyToAdd));\n    for (let i = 0; i < count; i++)\n    {\n      let zonePicker = Math.random();\n      if (zonePicker < innerToOuterSizeRatio)\n      {\n        points.push(vec3.fromValues(\n          this.innerScaling[0] * Math.random() - 0.5 * this.innerScaling[0],\n          this.innerScaling[1] * Math.random() - 0.5 * this.innerScaling[1],\n          this.innerScaling[2] * Math.random() - 0.5 * this.innerScaling[2]\n        ));\n        continue;\n      }\n\n      zonePicker *= outerSidesSize;\n      const position = vec3.create();\n      if (zonePicker < 2 * leftRightSideSize)\n      {\n        const distance = 0.5 * this.innerScaling[0]\n          + Math.pow(Math.random(), fallOffFactor)\n          * (this.scaling[0] - this.innerScaling[0]) * 0.5;\n        position[0] = zonePicker < leftRightSideSize ? distance : -distance;\n        position[1] = Math.random() * this.scaling[1] - 0.5 * this.scaling[1];\n        position[2] = Math.random() * this.scaling[2] - 0.5 * this.scaling[2];\n      }\n      else if (zonePicker < 2 * (leftRightSideSize + topBottomSize))\n      {\n        const distance = 0.5 * this.innerScaling[1]\n          + Math.pow(Math.random(), fallOffFactor)\n          * (this.scaling[1] - this.innerScaling[1]) * 0.5;\n        position[0] = Math.random() * this.innerScaling[0] - 0.5 * this.innerScaling[0];\n        position[1] = zonePicker < 2 * leftRightSideSize + topBottomSize ? distance : -distance;\n        position[2] = Math.random() * this.scaling[2] - 0.5 * this.scaling[2];\n      }\n      else\n      {\n        // Carbon uses the Y dimensions for the front/back distance here.\n        const distance = 0.5 * this.innerScaling[1]\n          + Math.pow(Math.random(), fallOffFactor)\n          * (this.scaling[1] - this.innerScaling[1]) * 0.5;\n        position[0] = Math.random() * this.innerScaling[0] - 0.5 * this.innerScaling[0];\n        position[1] = Math.random() * this.innerScaling[1] - 0.5 * this.innerScaling[1];\n        position[2] = zonePicker < outerSidesSize - frontBackLidSize ? distance : -distance;\n      }\n      points.push(position);\n    }\n  }\n\n  @carbon.method\n  @impl.adapted\n  RegisterForChanges(callback)\n  {\n    const id = this.#nextCallbackId++;\n    this.#callbacks.set(id, callback);\n    return id;\n  }\n\n  @carbon.method\n  @impl.implemented\n  UnregisterForChanges(callbackId)\n  {\n    this.#callbacks.delete(callbackId);\n  }\n\n  @carbon.method\n  @impl.adapted\n  OnModified()\n  {\n    this.#setup();\n    for (const callback of this.#callbacks.values())\n    {\n      callback?.();\n    }\n    return true;\n  }\n\n  @carbon.method\n  @impl.noop\n  RenderDebugInfo()\n  {\n  }\n\n  #setup()\n  {\n    for (let i = 0; i < 3; i++)\n    {\n      this.scaling[i] = Math.max(0, this.scaling[i]);\n      this.innerScaling[i] = Math.min(Math.max(0, this.innerScaling[i]), this.scaling[i]);\n    }\n    quat.invert(this.#inverseRotation, this.rotation);\n  }\n\n  static #toLocal(position, center, inverseRotation)\n  {\n    const local = vec3.subtract(vec3.create(), position, center);\n    return vec3.transformQuat(local, local, inverseRotation);\n  }\n\n  static #radialBoxDistance(position, scaling)\n  {\n    const length = vec3.length(position);\n    if (length === 0)\n    {\n      return Math.min(scaling[0], scaling[1], scaling[2]) * 0.5;\n    }\n    let distance = Number.POSITIVE_INFINITY;\n    for (let i = 0; i < 3; i++)\n    {\n      const direction = Math.abs(position[i] / length);\n      if (direction > 0)\n      {\n        distance = Math.min(distance, scaling[i] * 0.5 / direction);\n      }\n    }\n    return Number.isFinite(distance) ? distance : 0;\n  }\n}\n"],"names":["_EveBoxVolume","_identity","EveBoxVolume","CjsModel","e","_init_position","_init_extra_position","_init_scaling","_init_extra_scaling","_init_innerScaling","_init_extra_innerScaling","_init_rotation","_init_extra_rotation","_init_name","_init_extra_name","_init_debugShowIntersection","_init_extra_debugShowIntersection","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","notify","persist","vec3","quat","string","readwrite","boolean","carbon","method","impl","implemented","adapted","noop","position","create","scaling","innerScaling","rotation","name","debugShowIntersection","Map","Initialize","GetBoundingSphere","center","clone","radius","length","GetIntensity","local","outer","distance","inner","span","ratio","GeneratePointsInVolume","points","howManyToAdd","excludeInnerVolume","fallOffFactor","leftRightSideSize","topBottomSize","frontBackLidSize","outerSidesSize","innerToOuterSizeRatio","rangeX","rangeY","rangeZ","adjustedOuterCubeSize","Math","pow","count","max","trunc","i","zonePicker","random","push","fromValues","RegisterForChanges","callback","id","set","UnregisterForChanges","callbackId","delete","OnModified","values","RenderDebugInfo","#setup","min","invert","#toLocal","inverseRotation","subtract","transformQuat","#radialBoxDistance","Number","POSITIVE_INFINITY","direction","abs","isFinite","constructor"],"mappings":";;;;;;;AAM2E,IAAAA;AAAA,IAAA,cAAAC,SAAA,CAAA;AAAA,EAAA,QAG3E,MAAAC,YAAA,SAIkCC,QAAQ,CAC1C;AAAA,IAAA;AAAA,MAAA,CAAA;QAAAC,CAAA,EAAA,CAAAC,cAAA,EAAAC,oBAAA,EAAAC,aAAA,EAAAC,mBAAA,EAAAC,kBAAA,EAAAC,wBAAA,EAAAC,cAAA,EAAAC,oBAAA,EAAAC,UAAA,EAAAC,gBAAA,EAAAC,2BAAA,EAAAC,iCAAA,EAAAC,UAAA,CAAA;QAAAC,CAAA,EAAA,CAAAlB,aAAA,EAAAmB,UAAA;AAAA,OAAA,GAAAC,cAAA,CAAA,IAAA,EAAA,CALCC,IAAI,CAACC,MAAM,CAAC;AACXC,QAAAA,SAAS,EAAE,cAAc;AACzBC,QAAAA,MAAM,EAAE;OACT,CAAC,MAGCC,EAAE,EAAFA,EAAE,CAACC,MAAM,EACTD,EAAE,EAAFA,EAAE,CAACE,OAAO,EACVN,IAAI,EAAJA,IAAI,CAACO,IAAI,sBAGTH,EAAE,EAAFA,EAAE,CAACC,MAAM,EACTD,EAAE,EAAFA,EAAE,CAACE,OAAO,EACVN,IAAI,EAAJA,IAAI,CAACO,IAAI,qBAGTH,EAAE,EAAFA,EAAE,CAACC,MAAM,EACTD,EAAE,EAAFA,EAAE,CAACE,OAAO,EACVN,IAAI,EAAJA,IAAI,CAACO,IAAI,CAAA,EAAA,EAAA,EAAA,cAAA,CAAA,EAAA,CAAA,CAGTH,EAAE,EAAFA,EAAE,CAACC,MAAM,EACTD,EAAE,EAAFA,EAAE,CAACE,OAAO,EACVN,IAAI,EAAJA,IAAI,CAACQ,IAAI,CAAA,EAAA,EAAA,EAAA,UAAA,CAAA,EAAA,CAAA,CAGTJ,EAAE,EAAFA,EAAE,CAACE,OAAO,EACVN,IAAI,EAAJA,IAAI,CAACS,MAAM,CAAA,EAAA,EAAA,EAAA,MAAA,CAAA,EAAA,CAAA,CAGXL,EAAE,EAAFA,EAAE,CAACM,SAAS,EACZV,IAAI,EAAJA,IAAI,CAACW,OAAO,mCASZC,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACC,WAAW,wBAOhBH,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACE,OAAO,+BASZJ,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACE,OAAO,0BAoBZJ,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACE,OAAO,CAAA,EAAA,EAAA,EAAA,wBAAA,CAAA,EAAA,CAAA,CAiFZJ,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACE,OAAO,CAAA,EAAA,EAAA,EAAA,oBAAA,CAAA,EAAA,CAAA,CAQZJ,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACC,WAAW,CAAA,EAAA,EAAA,EAAA,sBAAA,CAAA,EAAA,CAAA,CAMhBH,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACE,OAAO,CAAA,EAAA,EAAA,EAAA,YAAA,CAAA,EAAA,CAAA,CAWZJ,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACG,IAAI,CAAA,EAAA,EAAA,EAAA,iBAAA,CAAA,CAAA,EAAA,CAAA,EAAA,MAAA,EA1LsBnC,QAAQ,CAAA;AAAA;IAKxCoC,QAAQ,IAAAtB,UAAA,CAAA,IAAA,CAAA,EAAAZ,cAAA,OAAGuB,IAAI,CAACY,MAAM,EAAE,CAAA;IAKxBC,OAAO,IAAAnC,oBAAA,CAAA,IAAA,CAAA,EAAAC,aAAA,OAAGqB,IAAI,CAACY,MAAM,EAAE,CAAA;IAKvBE,YAAY,IAAAlC,mBAAA,CAAA,IAAA,CAAA,EAAAC,kBAAA,OAAGmB,IAAI,CAACY,MAAM,EAAE,CAAA;IAK5BG,QAAQ,IAAAjC,wBAAA,CAAA,IAAA,CAAA,EAAAC,cAAA,OAAGkB,IAAI,CAACW,MAAM,EAAE,CAAA;AAIxBI,IAAAA,IAAI,IAAAhC,oBAAA,CAAA,IAAA,CAAA,EAAAC,UAAA,OAAG,EAAE,CAAA;AAITgC,IAAAA,qBAAqB,IAAA/B,gBAAA,CAAA,IAAA,CAAA,EAAAC,2BAAA,OAAG,KAAK,CAAA;AAE7B,IAAA,UAAU,IAAAC,iCAAA,QAAG,IAAI8B,GAAG,EAAE;IAEtB,eAAe,GAAG,CAAC;AAEnB,IAAA,gBAAgB,GAAGjB,IAAI,CAACW,MAAM,EAAE;AAIhCO,IAAAA,UAAUA,GACV;AACE,MAAA,IAAI,CAAC,MAAM,EAAE;AACb,MAAA,OAAO,IAAI;AACb,IAAA;AAIAC,IAAAA,iBAAiBA,GACjB;MACE,OAAO;QACLC,MAAM,EAAErB,IAAI,CAACsB,KAAK,CAAC,IAAI,CAACX,QAAQ,CAAC;QACjCY,MAAM,EAAEvB,IAAI,CAACwB,MAAM,CAAC,IAAI,CAACX,OAAO,CAAC,GAAG;OACrC;AACH,IAAA;IAIAY,YAAYA,CAACd,QAAQ,EACrB;AACE,MAAA,MAAMe,KAAK,GAAGpD,aAAY,CAAC,QAAQ,CAACqC,QAAQ,EAAE,IAAI,CAACA,QAAQ,EAAE,IAAI,CAAC,gBAAgB,CAAC;AACnF,MAAA,MAAMgB,KAAK,GAAGrD,aAAY,CAAC,kBAAkB,CAACoD,KAAK,EAAE,IAAI,CAACb,OAAO,CAAC;AAClE,MAAA,MAAMe,QAAQ,GAAG5B,IAAI,CAACwB,MAAM,CAACE,KAAK,CAAC;MACnC,IAAI,EAAEC,KAAK,GAAG,CAAC,CAAC,IAAIC,QAAQ,GAAGD,KAAK,EACpC;AACE,QAAA,OAAO,CAAC;AACV,MAAA;AACA,MAAA,MAAME,KAAK,GAAGvD,aAAY,CAAC,kBAAkB,CAACoD,KAAK,EAAE,IAAI,CAACZ,YAAY,CAAC;AACvE,MAAA,IAAIe,KAAK,GAAG,CAAC,IAAID,QAAQ,IAAIC,KAAK,EAClC;AACE,QAAA,OAAO,CAAC;AACV,MAAA;AACA,MAAA,MAAMC,IAAI,GAAGH,KAAK,GAAGE,KAAK;AAC1B,MAAA,MAAME,KAAK,GAAGD,IAAI,GAAG,CAAC,GAAG,CAACH,KAAK,GAAGC,QAAQ,IAAIE,IAAI,GAAG,CAAC;MACtD,OAAOC,KAAK,GAAGA,KAAK;AACtB,IAAA;IAIAC,sBAAsBA,CAACC,MAAM,EAAEC,YAAY,EAAEC,kBAAkB,EAAEC,aAAa,EAC9E;MACE,IAAI,IAAI,CAACvB,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,IAAI,CAACA,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,IAAI,CAACA,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,EAC3E;AACE,QAAA;AACF,MAAA;AAEA,MAAA,MAAMwB,iBAAiB,GAAG,CAAC,IAAI,CAACxB,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,CAACC,YAAY,CAAC,CAAC,CAAC,IAC7D,IAAI,CAACD,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,CAACA,OAAO,CAAC,CAAC,CAAC;AACrC,MAAA,MAAMyB,aAAa,GAAG,IAAI,CAACxB,YAAY,CAAC,CAAC,CAAC,IACrC,IAAI,CAACD,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,CAACC,YAAY,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAACD,OAAO,CAAC,CAAC,CAAC;AAC9D,MAAA,MAAM0B,gBAAgB,GAAG,IAAI,CAACzB,YAAY,CAAC,CAAC,CAAC,GAAG,IAAI,CAACA,YAAY,CAAC,CAAC,CAAC,IAC/D,IAAI,CAACD,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,CAACC,YAAY,CAAC,CAAC,CAAC,CAAC;MAC5C,MAAM0B,cAAc,GAAG,CAAC,IAAIH,iBAAiB,GAAGC,aAAa,GAAGC,gBAAgB,CAAC;MACjF,IAAIE,qBAAqB,GAAG,CAAC;MAE7B,IAAI,CAACN,kBAAkB,EACvB;AACE,QAAA,MAAMO,MAAM,GAAG,IAAI,CAAC7B,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,CAACC,YAAY,CAAC,CAAC,CAAC;AACrD,QAAA,MAAM6B,MAAM,GAAG,IAAI,CAAC9B,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,CAACC,YAAY,CAAC,CAAC,CAAC;AACrD,QAAA,MAAM8B,MAAM,GAAG,IAAI,CAAC/B,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,CAACC,YAAY,CAAC,CAAC,CAAC;AACrD,QAAA,MAAM+B,qBAAqB,GAAG,CAAC,IAAI,CAAC/B,YAAY,CAAC,CAAC,CAAC,GAAG,GAAG,GAAG4B,MAAM,KAC7D,IAAI,CAAC5B,YAAY,CAAC,CAAC,CAAC,GAAG,GAAG,GAAG6B,MAAM,CAAC,IACpC,IAAI,CAAC7B,YAAY,CAAC,CAAC,CAAC,GAAG,GAAG,GAAG8B,MAAM,CAAC;QACzCH,qBAAqB,GAAG,IAAI,CAAC3B,YAAY,CAAC,CAAC,CAAC,GAAG,IAAI,CAACA,YAAY,CAAC,CAAC,CAAC,GAC/D,IAAI,CAACA,YAAY,CAAC,CAAC,CAAC,GAAG+B,qBAAqB;AAChDJ,QAAAA,qBAAqB,GAAG,CAAC,GAAGK,IAAI,CAACC,GAAG,CAClC,CAAC,GAAGN,qBAAqB,EACzB,GAAG,GAAG,GAAG,GAAGL,aACd,CAAC;AACH,MAAA;AAEA,MAAA,MAAMY,KAAK,GAAGF,IAAI,CAACG,GAAG,CAAC,CAAC,EAAEH,IAAI,CAACI,KAAK,CAAChB,YAAY,CAAC,CAAC;MACnD,KAAK,IAAIiB,CAAC,GAAG,CAAC,EAAEA,CAAC,GAAGH,KAAK,EAAEG,CAAC,EAAE,EAC9B;AACE,QAAA,IAAIC,UAAU,GAAGN,IAAI,CAACO,MAAM,EAAE;QAC9B,IAAID,UAAU,GAAGX,qBAAqB,EACtC;AACER,UAAAA,MAAM,CAACqB,IAAI,CAACtD,IAAI,CAACuD,UAAU,CACzB,IAAI,CAACzC,YAAY,CAAC,CAAC,CAAC,GAAGgC,IAAI,CAACO,MAAM,EAAE,GAAG,GAAG,GAAG,IAAI,CAACvC,YAAY,CAAC,CAAC,CAAC,EACjE,IAAI,CAACA,YAAY,CAAC,CAAC,CAAC,GAAGgC,IAAI,CAACO,MAAM,EAAE,GAAG,GAAG,GAAG,IAAI,CAACvC,YAAY,CAAC,CAAC,CAAC,EACjE,IAAI,CAACA,YAAY,CAAC,CAAC,CAAC,GAAGgC,IAAI,CAACO,MAAM,EAAE,GAAG,GAAG,GAAG,IAAI,CAACvC,YAAY,CAAC,CAAC,CAClE,CAAC,CAAC;AACF,UAAA;AACF,QAAA;AAEAsC,QAAAA,UAAU,IAAIZ,cAAc;AAC5B,QAAA,MAAM7B,QAAQ,GAAGX,IAAI,CAACY,MAAM,EAAE;AAC9B,QAAA,IAAIwC,UAAU,GAAG,CAAC,GAAGf,iBAAiB,EACtC;AACE,UAAA,MAAMT,QAAQ,GAAG,GAAG,GAAG,IAAI,CAACd,YAAY,CAAC,CAAC,CAAC,GACvCgC,IAAI,CAACC,GAAG,CAACD,IAAI,CAACO,MAAM,EAAE,EAAEjB,aAAa,CAAC,IACrC,IAAI,CAACvB,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,CAACC,YAAY,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG;UAClDH,QAAQ,CAAC,CAAC,CAAC,GAAGyC,UAAU,GAAGf,iBAAiB,GAAGT,QAAQ,GAAG,CAACA,QAAQ;UACnEjB,QAAQ,CAAC,CAAC,CAAC,GAAGmC,IAAI,CAACO,MAAM,EAAE,GAAG,IAAI,CAACxC,OAAO,CAAC,CAAC,CAAC,GAAG,GAAG,GAAG,IAAI,CAACA,OAAO,CAAC,CAAC,CAAC;UACrEF,QAAQ,CAAC,CAAC,CAAC,GAAGmC,IAAI,CAACO,MAAM,EAAE,GAAG,IAAI,CAACxC,OAAO,CAAC,CAAC,CAAC,GAAG,GAAG,GAAG,IAAI,CAACA,OAAO,CAAC,CAAC,CAAC;QACvE,CAAC,MACI,IAAIuC,UAAU,GAAG,CAAC,IAAIf,iBAAiB,GAAGC,aAAa,CAAC,EAC7D;AACE,UAAA,MAAMV,QAAQ,GAAG,GAAG,GAAG,IAAI,CAACd,YAAY,CAAC,CAAC,CAAC,GACvCgC,IAAI,CAACC,GAAG,CAACD,IAAI,CAACO,MAAM,EAAE,EAAEjB,aAAa,CAAC,IACrC,IAAI,CAACvB,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,CAACC,YAAY,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG;UAClDH,QAAQ,CAAC,CAAC,CAAC,GAAGmC,IAAI,CAACO,MAAM,EAAE,GAAG,IAAI,CAACvC,YAAY,CAAC,CAAC,CAAC,GAAG,GAAG,GAAG,IAAI,CAACA,YAAY,CAAC,CAAC,CAAC;AAC/EH,UAAAA,QAAQ,CAAC,CAAC,CAAC,GAAGyC,UAAU,GAAG,CAAC,GAAGf,iBAAiB,GAAGC,aAAa,GAAGV,QAAQ,GAAG,CAACA,QAAQ;UACvFjB,QAAQ,CAAC,CAAC,CAAC,GAAGmC,IAAI,CAACO,MAAM,EAAE,GAAG,IAAI,CAACxC,OAAO,CAAC,CAAC,CAAC,GAAG,GAAG,GAAG,IAAI,CAACA,OAAO,CAAC,CAAC,CAAC;AACvE,QAAA,CAAC,MAED;AACE;AACA,UAAA,MAAMe,QAAQ,GAAG,GAAG,GAAG,IAAI,CAACd,YAAY,CAAC,CAAC,CAAC,GACvCgC,IAAI,CAACC,GAAG,CAACD,IAAI,CAACO,MAAM,EAAE,EAAEjB,aAAa,CAAC,IACrC,IAAI,CAACvB,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,CAACC,YAAY,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG;UAClDH,QAAQ,CAAC,CAAC,CAAC,GAAGmC,IAAI,CAACO,MAAM,EAAE,GAAG,IAAI,CAACvC,YAAY,CAAC,CAAC,CAAC,GAAG,GAAG,GAAG,IAAI,CAACA,YAAY,CAAC,CAAC,CAAC;UAC/EH,QAAQ,CAAC,CAAC,CAAC,GAAGmC,IAAI,CAACO,MAAM,EAAE,GAAG,IAAI,CAACvC,YAAY,CAAC,CAAC,CAAC,GAAG,GAAG,GAAG,IAAI,CAACA,YAAY,CAAC,CAAC,CAAC;AAC/EH,UAAAA,QAAQ,CAAC,CAAC,CAAC,GAAGyC,UAAU,GAAGZ,cAAc,GAAGD,gBAAgB,GAAGX,QAAQ,GAAG,CAACA,QAAQ;AACrF,QAAA;AACAK,QAAAA,MAAM,CAACqB,IAAI,CAAC3C,QAAQ,CAAC;AACvB,MAAA;AACF,IAAA;IAIA6C,kBAAkBA,CAACC,QAAQ,EAC3B;AACE,MAAA,MAAMC,EAAE,GAAG,IAAI,CAAC,eAAe,EAAE;MACjC,IAAI,CAAC,UAAU,CAACC,GAAG,CAACD,EAAE,EAAED,QAAQ,CAAC;AACjC,MAAA,OAAOC,EAAE;AACX,IAAA;IAIAE,oBAAoBA,CAACC,UAAU,EAC/B;AACE,MAAA,IAAI,CAAC,UAAU,CAACC,MAAM,CAACD,UAAU,CAAC;AACpC,IAAA;AAIAE,IAAAA,UAAUA,GACV;AACE,MAAA,IAAI,CAAC,MAAM,EAAE;MACb,KAAK,MAAMN,QAAQ,IAAI,IAAI,CAAC,UAAU,CAACO,MAAM,EAAE,EAC/C;AACEP,QAAAA,QAAQ,IAAI;AACd,MAAA;AACA,MAAA,OAAO,IAAI;AACb,IAAA;IAIAQ,eAAeA,GACf,CACA;IAEA,MAAMC,GACN;MACE,KAAK,IAAIf,CAAC,GAAG,CAAC,EAAEA,CAAC,GAAG,CAAC,EAAEA,CAAC,EAAE,EAC1B;AACE,QAAA,IAAI,CAACtC,OAAO,CAACsC,CAAC,CAAC,GAAGL,IAAI,CAACG,GAAG,CAAC,CAAC,EAAE,IAAI,CAACpC,OAAO,CAACsC,CAAC,CAAC,CAAC;AAC9C,QAAA,IAAI,CAACrC,YAAY,CAACqC,CAAC,CAAC,GAAGL,IAAI,CAACqB,GAAG,CAACrB,IAAI,CAACG,GAAG,CAAC,CAAC,EAAE,IAAI,CAACnC,YAAY,CAACqC,CAAC,CAAC,CAAC,EAAE,IAAI,CAACtC,OAAO,CAACsC,CAAC,CAAC,CAAC;AACrF,MAAA;MACAlD,IAAI,CAACmE,MAAM,CAAC,IAAI,CAAC,gBAAgB,EAAE,IAAI,CAACrD,QAAQ,CAAC;AACnD,IAAA;GA0BD;AAxBQ,EAAA,QAAQsD,CAAC1D,QAAQ,EAAEU,MAAM,EAAEiD,eAAe,EACjD;AACE,IAAA,MAAM5C,KAAK,GAAG1B,IAAI,CAACuE,QAAQ,CAACvE,IAAI,CAACY,MAAM,EAAE,EAAED,QAAQ,EAAEU,MAAM,CAAC;IAC5D,OAAOrB,IAAI,CAACwE,aAAa,CAAC9C,KAAK,EAAEA,KAAK,EAAE4C,eAAe,CAAC;AAC1D,EAAA;AAEO,EAAA,kBAAkBG,CAAC9D,QAAQ,EAAEE,OAAO,EAC3C;AACE,IAAA,MAAMW,MAAM,GAAGxB,IAAI,CAACwB,MAAM,CAACb,QAAQ,CAAC;IACpC,IAAIa,MAAM,KAAK,CAAC,EAChB;MACE,OAAOsB,IAAI,CAACqB,GAAG,CAACtD,OAAO,CAAC,CAAC,CAAC,EAAEA,OAAO,CAAC,CAAC,CAAC,EAAEA,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG;AAC3D,IAAA;AACA,IAAA,IAAIe,QAAQ,GAAG8C,MAAM,CAACC,iBAAiB;IACvC,KAAK,IAAIxB,CAAC,GAAG,CAAC,EAAEA,CAAC,GAAG,CAAC,EAAEA,CAAC,EAAE,EAC1B;AACE,MAAA,MAAMyB,SAAS,GAAG9B,IAAI,CAAC+B,GAAG,CAAClE,QAAQ,CAACwC,CAAC,CAAC,GAAG3B,MAAM,CAAC;MAChD,IAAIoD,SAAS,GAAG,CAAC,EACjB;AACEhD,QAAAA,QAAQ,GAAGkB,IAAI,CAACqB,GAAG,CAACvC,QAAQ,EAAEf,OAAO,CAACsC,CAAC,CAAC,GAAG,GAAG,GAAGyB,SAAS,CAAC;AAC7D,MAAA;AACF,IAAA;IACA,OAAOF,MAAM,CAACI,QAAQ,CAAClD,QAAQ,CAAC,GAAGA,QAAQ,GAAG,CAAC;AACjD,EAAA;EAACmD,WAAAA,GAAA;IAAA,KAAA,CAAA3G,aAAA,GAAAmB,UAAA,EAAA;AAAA,EAAA;AAAA,CAAA,EAAA;;;;"}
+{"version":3,"file":"EveBoxVolume.js","sources":["../../../../src/eve/volume/EveBoxVolume.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\Eve\\Volume\\EveBoxVolume.h\n// Source: E:\\carbonengine\\trinity\\trinity\\Eve\\Volume\\EveBoxVolume.cpp\n// Source: E:\\carbonengine\\trinity\\trinity\\Eve\\Volume\\EveBoxVolume_Blue.cpp\nimport { quat } from \"@carbonenginejs/runtime-utils/quat\";\nimport { vec3 } from \"@carbonenginejs/runtime-utils/vec3\";\nimport { CjsModel } from \"@carbonenginejs/runtime-utils/model\";\nimport { carbon, impl, io, type } from \"@carbonenginejs/runtime-utils/schema\";\n\n\n/**\n * Oriented box of influence with a hollow inner box, weighting points by falloff\n * and seeding random points across its shell.\n */\n@type.define({\n  className: \"EveBoxVolume\",\n  family: \"eve/volume\"\n})\nexport class EveBoxVolume extends CjsModel\n{\n  @io.notify\n  @io.persist\n  @type.vec3\n  position = vec3.create();\n\n  @io.notify\n  @io.persist\n  @type.vec3\n  scaling = vec3.create();\n\n  @io.notify\n  @io.persist\n  @type.vec3\n  innerScaling = vec3.create();\n\n  @io.notify\n  @io.persist\n  @type.quat\n  rotation = quat.create();\n\n  @io.persist\n  @type.string\n  name = \"\";\n\n  @io.readwrite\n  @type.boolean\n  debugShowIntersection = false;\n\n  #callbacks = new Map();\n\n  #nextCallbackId = 1;\n\n  #inverseRotation = quat.create();\n\n  /**\n   * Clamps the authored scalings and caches the inverse rotation the intensity\n   * test needs.\n   */\n  @carbon.method\n  @impl.implemented\n  Initialize()\n  {\n    this.#setup();\n    return true;\n  }\n\n  /**\n   * Returns a fresh sphere centred on the box position whose radius is half the\n   * length of the scaling vector.\n   */\n  @carbon.method\n  @impl.adapted\n  GetBoundingSphere()\n  {\n    return {\n      center: vec3.clone(this.position),\n      radius: vec3.length(this.scaling) * 0.5\n    };\n  }\n\n  /**\n   * Returns the falloff weight for a point given in the volume's own space: the\n   * point is moved into box-local space with the cached inverse rotation, then\n   * compared radially against the inner and outer boxes - 1 inside the inner\n   * box, 0 outside the outer one, and a squared ramp between them.\n   */\n  @carbon.method\n  @impl.adapted\n  GetIntensity(position)\n  {\n    const local = EveBoxVolume.#toLocal(position, this.position, this.#inverseRotation);\n    const outer = EveBoxVolume.#radialBoxDistance(local, this.scaling);\n    const distance = vec3.length(local);\n    if (!(outer > 0) || distance > outer)\n    {\n      return 0;\n    }\n    const inner = EveBoxVolume.#radialBoxDistance(local, this.innerScaling);\n    if (inner > 0 && distance <= inner)\n    {\n      return 1;\n    }\n    const span = outer - inner;\n    const ratio = span > 0 ? (outer - distance) / span : 0;\n    return ratio * ratio;\n  }\n\n  /**\n   * Appends random points expressed in box-local space, centred on the box rather than offset by its position, choosing between the inner box and the six shell zones in proportion to their volumes and biasing shell samples outward by fallOffFactor. Generates nothing when any scaling axis is zero.\n   *\n   * @param points Caller-owned array the new points are pushed onto.\n   * @param excludeInnerVolume Drops the inner box from the choice, keeping every point in the shell.\n   */\n  @carbon.method\n  @impl.adapted\n  GeneratePointsInVolume(points, howManyToAdd, excludeInnerVolume, fallOffFactor)\n  {\n    if (this.scaling[0] === 0 || this.scaling[1] === 0 || this.scaling[2] === 0)\n    {\n      return;\n    }\n\n    const leftRightSideSize = (this.scaling[0] - this.innerScaling[0])\n      * this.scaling[1] * this.scaling[2];\n    const topBottomSize = this.innerScaling[0]\n      * (this.scaling[1] - this.innerScaling[1]) * this.scaling[2];\n    const frontBackLidSize = this.innerScaling[0] * this.innerScaling[1]\n      * (this.scaling[2] - this.innerScaling[2]);\n    const outerSidesSize = 2 * (leftRightSideSize + topBottomSize + frontBackLidSize);\n    let innerToOuterSizeRatio = 0;\n\n    if (!excludeInnerVolume)\n    {\n      const rangeX = this.scaling[0] - this.innerScaling[0];\n      const rangeY = this.scaling[1] - this.innerScaling[1];\n      const rangeZ = this.scaling[2] - this.innerScaling[2];\n      const adjustedOuterCubeSize = (this.innerScaling[0] + 0.5 * rangeX)\n        * (this.innerScaling[1] + 0.5 * rangeY)\n        * (this.innerScaling[2] + 0.5 * rangeZ);\n      innerToOuterSizeRatio = this.innerScaling[0] * this.innerScaling[1]\n        * this.innerScaling[2] / adjustedOuterCubeSize;\n      innerToOuterSizeRatio = 1 - Math.pow(\n        1 - innerToOuterSizeRatio,\n        0.8 + 0.2 * fallOffFactor\n      );\n    }\n\n    const count = Math.max(0, Math.trunc(howManyToAdd));\n    for (let i = 0; i < count; i++)\n    {\n      let zonePicker = Math.random();\n      if (zonePicker < innerToOuterSizeRatio)\n      {\n        points.push(vec3.fromValues(\n          this.innerScaling[0] * Math.random() - 0.5 * this.innerScaling[0],\n          this.innerScaling[1] * Math.random() - 0.5 * this.innerScaling[1],\n          this.innerScaling[2] * Math.random() - 0.5 * this.innerScaling[2]\n        ));\n        continue;\n      }\n\n      zonePicker *= outerSidesSize;\n      const position = vec3.create();\n      if (zonePicker < 2 * leftRightSideSize)\n      {\n        const distance = 0.5 * this.innerScaling[0]\n          + Math.pow(Math.random(), fallOffFactor)\n          * (this.scaling[0] - this.innerScaling[0]) * 0.5;\n        position[0] = zonePicker < leftRightSideSize ? distance : -distance;\n        position[1] = Math.random() * this.scaling[1] - 0.5 * this.scaling[1];\n        position[2] = Math.random() * this.scaling[2] - 0.5 * this.scaling[2];\n      }\n      else if (zonePicker < 2 * (leftRightSideSize + topBottomSize))\n      {\n        const distance = 0.5 * this.innerScaling[1]\n          + Math.pow(Math.random(), fallOffFactor)\n          * (this.scaling[1] - this.innerScaling[1]) * 0.5;\n        position[0] = Math.random() * this.innerScaling[0] - 0.5 * this.innerScaling[0];\n        position[1] = zonePicker < 2 * leftRightSideSize + topBottomSize ? distance : -distance;\n        position[2] = Math.random() * this.scaling[2] - 0.5 * this.scaling[2];\n      }\n      else\n      {\n        // Carbon uses the Y dimensions for the front/back distance here.\n        const distance = 0.5 * this.innerScaling[1]\n          + Math.pow(Math.random(), fallOffFactor)\n          * (this.scaling[1] - this.innerScaling[1]) * 0.5;\n        position[0] = Math.random() * this.innerScaling[0] - 0.5 * this.innerScaling[0];\n        position[1] = Math.random() * this.innerScaling[1] - 0.5 * this.innerScaling[1];\n        position[2] = zonePicker < outerSidesSize - frontBackLidSize ? distance : -distance;\n      }\n      points.push(position);\n    }\n  }\n\n  /**\n   * Registers a callback fired whenever the volume changes, returning the id\n   * needed to unregister it again.\n   */\n  @carbon.method\n  @impl.adapted\n  RegisterForChanges(callback)\n  {\n    const id = this.#nextCallbackId++;\n    this.#callbacks.set(id, callback);\n    return id;\n  }\n\n  /** Drops a change callback by the id RegisterForChanges returned. */\n  @carbon.method\n  @impl.implemented\n  UnregisterForChanges(callbackId)\n  {\n    this.#callbacks.delete(callbackId);\n  }\n\n  /**\n   * Re-clamps the scalings and the cached inverse rotation after an authored\n   * change, then notifies every registered listener.\n   */\n  @carbon.method\n  @impl.adapted\n  OnModified()\n  {\n    this.#setup();\n    for (const callback of this.#callbacks.values())\n    {\n      callback?.();\n    }\n    return true;\n  }\n\n  /** No debug drawing in this port. */\n  @carbon.method\n  @impl.noop\n  RenderDebugInfo()\n  {\n  }\n\n  /**\n   * Clamps the scaling to non-negative values, keeps the inner scaling inside\n   * it, and caches the inverse of the box rotation.\n   */\n  #setup()\n  {\n    for (let i = 0; i < 3; i++)\n    {\n      this.scaling[i] = Math.max(0, this.scaling[i]);\n      this.innerScaling[i] = Math.min(Math.max(0, this.innerScaling[i]), this.scaling[i]);\n    }\n    quat.invert(this.#inverseRotation, this.rotation);\n  }\n\n  /**\n   * Moves a point into box-local space by subtracting the box centre and\n   * applying the inverse rotation.\n   */\n  static #toLocal(position, center, inverseRotation)\n  {\n    const local = vec3.subtract(vec3.create(), position, center);\n    return vec3.transformQuat(local, local, inverseRotation);\n  }\n\n  /**\n   * Returns how far the box surface lies from the centre along the direction of\n   * the given local point, falling back to half the smallest extent when the\n   * point sits at the centre.\n   */\n  static #radialBoxDistance(position, scaling)\n  {\n    const length = vec3.length(position);\n    if (length === 0)\n    {\n      return Math.min(scaling[0], scaling[1], scaling[2]) * 0.5;\n    }\n    let distance = Number.POSITIVE_INFINITY;\n    for (let i = 0; i < 3; i++)\n    {\n      const direction = Math.abs(position[i] / length);\n      if (direction > 0)\n      {\n        distance = Math.min(distance, scaling[i] * 0.5 / direction);\n      }\n    }\n    return Number.isFinite(distance) ? distance : 0;\n  }\n}\n"],"names":["_EveBoxVolume","_identity","EveBoxVolume","CjsModel","e","_init_position","_init_extra_position","_init_scaling","_init_extra_scaling","_init_innerScaling","_init_extra_innerScaling","_init_rotation","_init_extra_rotation","_init_name","_init_extra_name","_init_debugShowIntersection","_init_extra_debugShowIntersection","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","notify","persist","vec3","quat","string","readwrite","boolean","carbon","method","impl","implemented","adapted","noop","position","create","scaling","innerScaling","rotation","name","debugShowIntersection","Map","Initialize","GetBoundingSphere","center","clone","radius","length","GetIntensity","local","outer","distance","inner","span","ratio","GeneratePointsInVolume","points","howManyToAdd","excludeInnerVolume","fallOffFactor","leftRightSideSize","topBottomSize","frontBackLidSize","outerSidesSize","innerToOuterSizeRatio","rangeX","rangeY","rangeZ","adjustedOuterCubeSize","Math","pow","count","max","trunc","i","zonePicker","random","push","fromValues","RegisterForChanges","callback","id","set","UnregisterForChanges","callbackId","delete","OnModified","values","RenderDebugInfo","#setup","min","invert","#toLocal","inverseRotation","subtract","transformQuat","#radialBoxDistance","Number","POSITIVE_INFINITY","direction","abs","isFinite","constructor"],"mappings":"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"}