@carbonenginejs/runtime-trinity 0.5.0 → 0.7.0

package/dist/eve/virtualCamera/EveVirtualCameraSystem.js

@@ -1,11 +1,16 @@
 import { applyDecs2311 as _applyDecs2311 } from '../../_virtual/_rollupPluginBabelHelpers.js';
-import { CjsModel } from '@carbonenginejs/core-types/model';
-import { io, carbon, impl, type } from '@carbonenginejs/core-types/schema';
+import { CjsModel } from '@carbonenginejs/runtime-utils/model';
+import { io, carbon, impl, type } from '@carbonenginejs/runtime-utils/schema';
 import { EveVirtualCamera as _EveVirtualCamera } from './EveVirtualCamera.js';
 import { EveVirtualCameraTransitionCut as _EveVirtualCameraTran } from './transition/EveVirtualCameraTransitionCut.js';
 import { EveVirtualCameraTransitionLerp as _EveVirtualCameraTran$1 } from './transition/EveVirtualCameraTransitionLerp.js';
 
 let _initProto, _initClass, _init_externalCamera, _init_extra_externalCamera, _init_cameras, _init_extra_cameras, _init_mainCamera, _init_extra_mainCamera, _init_transition, _init_extra_transition;
+
+/**
+ * Owns the registered virtual cameras plus the externally driven camera, and
+ * runs the transition that hands control from one to another.
+ */
 let _EveVirtualCameraSyst;
 class EveVirtualCameraSystem extends CjsModel {
   static {
@@ -22,6 +27,11 @@ class EveVirtualCameraSystem extends CjsModel {
   mainCamera = (_init_extra_cameras(this), _init_mainCamera(this, null));
   transition = (_init_extra_mainCamera(this), _init_transition(this, null));
   #lastUpdate = (_init_extra_transition(this), 0);
+
+  /**
+   * Creates the external camera, names it "externalCamera", gives it a
+   * zero-length timeline and makes it the initial main camera.
+   */
   constructor() {
     super();
     this.externalCamera = new _EveVirtualCamera();
@@ -29,12 +39,27 @@ class EveVirtualCameraSystem extends CjsModel {
     this.externalCamera.SetAnimationTimelineLength(0);
     this.mainCamera = this.externalCamera;
   }
+
+  /**
+   * Reports the system ready; the port has no device state to acquire, so this
+   * always succeeds.
+   */
   Initialize() {
     return true;
   }
+
+  /**
+   * Returns the camera the scene should render from: the transition's camera
+   * while a transition is running, otherwise the main camera.
+   */
   GetCurrentCamera() {
     return this.transition ? this.transition.GetCamera() : this.GetMainCamera();
   }
+
+  /**
+   * Registers a camera for updating and name lookup, refusing the external
+   * camera and duplicates; returns whether it was added.
+   */
   AddCamera(camera) {
     if (camera === this.externalCamera || this.cameras.includes(camera)) {
       return false;
@@ -42,20 +67,40 @@ class EveVirtualCameraSystem extends CjsModel {
     this.cameras.push(camera);
     return true;
   }
+
+  /**
+   * Returns the camera control has been handed to, ignoring any transition
+   * currently blending towards it.
+   */
   GetMainCamera() {
     return this.mainCamera;
   }
+
+  /**
+   * Finds a registered camera by name, also matching the external camera, and
+   * returns null when nothing matches.
+   */
   GetCameraByName(name) {
     if (name === this.externalCamera?.GetName()) {
       return this.externalCamera;
     }
     return this.cameras.find(camera => camera?.GetName?.() === name) ?? null;
   }
+
+  /**
+   * Hands control to a camera immediately through a cut transition; does nothing
+   * when the camera is null or already the main camera.
+   */
   CutToCamera(camera) {
     if (camera && camera !== this.GetMainCamera()) {
       this.#setMainCameraWithTransition(camera, new _EveVirtualCameraTran());
     }
   }
+
+  /**
+   * Hands control to a camera through a lerp transition lasting transitionTime
+   * seconds; does nothing when the camera is null or already the main camera.
+   */
   LerpToCamera(camera, transitionTime = 1) {
     if (camera && camera !== this.GetMainCamera()) {
       const transition = new _EveVirtualCameraTran$1();
@@ -63,9 +108,19 @@ class EveVirtualCameraSystem extends CjsModel {
       this.#setMainCameraWithTransition(camera, transition);
     }
   }
+
+  /**
+   * Reports whether the currently rendering camera is the external one, meaning
+   * the host application is driving the view rather than an authored camera.
+   */
   IsExternallyControlled() {
     return this.GetCurrentCamera() === this.externalCamera;
   }
+
+  /**
+   * Advances every registered camera, the external camera and any running transition, clearing the transition once it completes.
+   * @param {Number} simTime Absolute simulation time; the delta is derived from the previous call, and the first call produces a zero delta
+   */
   Update(simTime) {
     const time = Number(simTime) || 0;
     if (this.#lastUpdate === 0) {
@@ -84,11 +139,21 @@ class EveVirtualCameraSystem extends CjsModel {
       }
     }
   }
+
+  /**
+   * Drops any running transition, makes the camera the main one and registers it
+   * if it was not already known.
+   */
   #setMainCamera(camera) {
     this.transition = null;
     this.mainCamera = camera;
     this.AddCamera(camera);
   }
+
+  /**
+   * Switches the main camera and starts the supplied transition from the
+   * previous main camera to the new one.
+   */
   #setMainCameraWithTransition(camera, transition) {
     const current = this.GetMainCamera();
     this.#setMainCamera(camera);

package/dist/eve/virtualCamera/EveVirtualCameraSystem.js.map

@@ -1 +1 @@
-{"version":3,"file":"EveVirtualCameraSystem.js","sources":["../../../../src/eve/virtualCamera/EveVirtualCameraSystem.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\Eve\\VirtualCamera\\EveVirtualCameraSystem.h\n// Source: E:\\carbonengine\\trinity\\trinity\\Eve\\VirtualCamera\\EveVirtualCameraSystem.cpp\nimport { CjsModel } from \"@carbonenginejs/core-types/model\";\nimport { carbon, impl, io, type } from \"@carbonenginejs/core-types/schema\";\nimport { EveVirtualCamera } from \"./EveVirtualCamera.js\";\nimport { EveVirtualCameraTransitionCut } from \"./transition/EveVirtualCameraTransitionCut.js\";\nimport { EveVirtualCameraTransitionLerp } from \"./transition/EveVirtualCameraTransitionLerp.js\";\n\n\n@type.define({\n  className: \"EveVirtualCameraSystem\",\n  family: \"eve/virtualCamera\"\n})\nexport class EveVirtualCameraSystem extends CjsModel\n{\n  @io.persist\n  @type.objectRef(\"EveVirtualCamera\")\n  externalCamera = null;\n\n  @io.persist\n  @type.list(\"EveVirtualCamera\")\n  cameras = [];\n\n  @io.persist\n  @type.objectRef(\"EveVirtualCamera\")\n  mainCamera = null;\n\n  @io.read\n  @type.objectRef(\"EveVirtualCameraTransitionBase\")\n  transition = null;\n\n  #lastUpdate = 0;\n\n  constructor()\n  {\n    super();\n    this.externalCamera = new EveVirtualCamera();\n    this.externalCamera.SetName(\"externalCamera\");\n    this.externalCamera.SetAnimationTimelineLength(0);\n    this.mainCamera = this.externalCamera;\n  }\n\n  @carbon.method\n  @impl.implemented\n  Initialize()\n  {\n    return true;\n  }\n\n  @carbon.method\n  @impl.implemented\n  GetCurrentCamera()\n  {\n    return this.transition ? this.transition.GetCamera() : this.GetMainCamera();\n  }\n\n  @carbon.method\n  @impl.implemented\n  AddCamera(camera)\n  {\n    if (camera === this.externalCamera || this.cameras.includes(camera))\n    {\n      return false;\n    }\n    this.cameras.push(camera);\n    return true;\n  }\n\n  @carbon.method\n  @impl.implemented\n  GetMainCamera()\n  {\n    return this.mainCamera;\n  }\n\n  @carbon.method\n  @impl.implemented\n  GetCameraByName(name)\n  {\n    if (name === this.externalCamera?.GetName())\n    {\n      return this.externalCamera;\n    }\n    return this.cameras.find(camera => camera?.GetName?.() === name) ?? null;\n  }\n\n  @carbon.method\n  @impl.implemented\n  CutToCamera(camera)\n  {\n    if (camera && camera !== this.GetMainCamera())\n    {\n      this.#setMainCameraWithTransition(camera, new EveVirtualCameraTransitionCut());\n    }\n  }\n\n  @carbon.method\n  @impl.implemented\n  LerpToCamera(camera, transitionTime = 1)\n  {\n    if (camera && camera !== this.GetMainCamera())\n    {\n      const transition = new EveVirtualCameraTransitionLerp();\n      transition.SetTransitionTime(transitionTime);\n      this.#setMainCameraWithTransition(camera, transition);\n    }\n  }\n\n  @carbon.method\n  @impl.implemented\n  IsExternallyControlled()\n  {\n    return this.GetCurrentCamera() === this.externalCamera;\n  }\n\n  @carbon.method\n  @impl.adapted\n  Update(simTime)\n  {\n    const time = Number(simTime) || 0;\n    if (this.#lastUpdate === 0)\n    {\n      this.#lastUpdate = time;\n    }\n    const deltaTime = time - this.#lastUpdate;\n    this.#lastUpdate = time;\n    for (const camera of this.cameras)\n    {\n      camera?.Update?.(deltaTime);\n    }\n    this.externalCamera?.Update?.(deltaTime);\n    if (this.transition)\n    {\n      this.transition.Update(deltaTime);\n      if (this.transition.IsComplete())\n      {\n        this.transition = null;\n      }\n    }\n  }\n\n  #setMainCamera(camera)\n  {\n    this.transition = null;\n    this.mainCamera = camera;\n    this.AddCamera(camera);\n  }\n\n  #setMainCameraWithTransition(camera, transition)\n  {\n    const current = this.GetMainCamera();\n    this.#setMainCamera(camera);\n    transition.SetSource(current);\n    transition.SetTarget(this.GetMainCamera());\n    transition.Play();\n    this.transition = transition;\n  }\n}\n"],"names":["_EveVirtualCameraSyst","EveVirtualCameraSystem","CjsModel","e","_init_externalCamera","_init_extra_externalCamera","_init_cameras","_init_extra_cameras","_init_mainCamera","_init_extra_mainCamera","_init_transition","_init_extra_transition","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","persist","objectRef","list","read","carbon","method","impl","implemented","adapted","externalCamera","cameras","mainCamera","transition","constructor","EveVirtualCamera","SetName","SetAnimationTimelineLength","Initialize","GetCurrentCamera","GetCamera","GetMainCamera","AddCamera","camera","includes","push","GetCameraByName","name","GetName","find","CutToCamera","EveVirtualCameraTransitionCut","LerpToCamera","transitionTime","EveVirtualCameraTransitionLerp","SetTransitionTime","IsExternallyControlled","Update","simTime","time","Number","deltaTime","IsComplete","#setMainCamera","#setMainCameraWithTransition","current","SetSource","SetTarget","Play"],"mappings":"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"}
+{"version":3,"file":"EveVirtualCameraSystem.js","sources":["../../../../src/eve/virtualCamera/EveVirtualCameraSystem.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\Eve\\VirtualCamera\\EveVirtualCameraSystem.h\n// Source: E:\\carbonengine\\trinity\\trinity\\Eve\\VirtualCamera\\EveVirtualCameraSystem.cpp\nimport { CjsModel } from \"@carbonenginejs/runtime-utils/model\";\nimport { carbon, impl, io, type } from \"@carbonenginejs/runtime-utils/schema\";\nimport { EveVirtualCamera } from \"./EveVirtualCamera.js\";\nimport { EveVirtualCameraTransitionCut } from \"./transition/EveVirtualCameraTransitionCut.js\";\nimport { EveVirtualCameraTransitionLerp } from \"./transition/EveVirtualCameraTransitionLerp.js\";\n\n\n/**\n * Owns the registered virtual cameras plus the externally driven camera, and\n * runs the transition that hands control from one to another.\n */\n@type.define({\n  className: \"EveVirtualCameraSystem\",\n  family: \"eve/virtualCamera\"\n})\nexport class EveVirtualCameraSystem extends CjsModel\n{\n  @io.persist\n  @type.objectRef(\"EveVirtualCamera\")\n  externalCamera = null;\n\n  @io.persist\n  @type.list(\"EveVirtualCamera\")\n  cameras = [];\n\n  @io.persist\n  @type.objectRef(\"EveVirtualCamera\")\n  mainCamera = null;\n\n  @io.read\n  @type.objectRef(\"EveVirtualCameraTransitionBase\")\n  transition = null;\n\n  #lastUpdate = 0;\n\n  /**\n   * Creates the external camera, names it \"externalCamera\", gives it a\n   * zero-length timeline and makes it the initial main camera.\n   */\n  constructor()\n  {\n    super();\n    this.externalCamera = new EveVirtualCamera();\n    this.externalCamera.SetName(\"externalCamera\");\n    this.externalCamera.SetAnimationTimelineLength(0);\n    this.mainCamera = this.externalCamera;\n  }\n\n  /**\n   * Reports the system ready; the port has no device state to acquire, so this\n   * always succeeds.\n   */\n  @carbon.method\n  @impl.implemented\n  Initialize()\n  {\n    return true;\n  }\n\n  /**\n   * Returns the camera the scene should render from: the transition's camera\n   * while a transition is running, otherwise the main camera.\n   */\n  @carbon.method\n  @impl.implemented\n  GetCurrentCamera()\n  {\n    return this.transition ? this.transition.GetCamera() : this.GetMainCamera();\n  }\n\n  /**\n   * Registers a camera for updating and name lookup, refusing the external\n   * camera and duplicates; returns whether it was added.\n   */\n  @carbon.method\n  @impl.implemented\n  AddCamera(camera)\n  {\n    if (camera === this.externalCamera || this.cameras.includes(camera))\n    {\n      return false;\n    }\n    this.cameras.push(camera);\n    return true;\n  }\n\n  /**\n   * Returns the camera control has been handed to, ignoring any transition\n   * currently blending towards it.\n   */\n  @carbon.method\n  @impl.implemented\n  GetMainCamera()\n  {\n    return this.mainCamera;\n  }\n\n  /**\n   * Finds a registered camera by name, also matching the external camera, and\n   * returns null when nothing matches.\n   */\n  @carbon.method\n  @impl.implemented\n  GetCameraByName(name)\n  {\n    if (name === this.externalCamera?.GetName())\n    {\n      return this.externalCamera;\n    }\n    return this.cameras.find(camera => camera?.GetName?.() === name) ?? null;\n  }\n\n  /**\n   * Hands control to a camera immediately through a cut transition; does nothing\n   * when the camera is null or already the main camera.\n   */\n  @carbon.method\n  @impl.implemented\n  CutToCamera(camera)\n  {\n    if (camera && camera !== this.GetMainCamera())\n    {\n      this.#setMainCameraWithTransition(camera, new EveVirtualCameraTransitionCut());\n    }\n  }\n\n  /**\n   * Hands control to a camera through a lerp transition lasting transitionTime\n   * seconds; does nothing when the camera is null or already the main camera.\n   */\n  @carbon.method\n  @impl.implemented\n  LerpToCamera(camera, transitionTime = 1)\n  {\n    if (camera && camera !== this.GetMainCamera())\n    {\n      const transition = new EveVirtualCameraTransitionLerp();\n      transition.SetTransitionTime(transitionTime);\n      this.#setMainCameraWithTransition(camera, transition);\n    }\n  }\n\n  /**\n   * Reports whether the currently rendering camera is the external one, meaning\n   * the host application is driving the view rather than an authored camera.\n   */\n  @carbon.method\n  @impl.implemented\n  IsExternallyControlled()\n  {\n    return this.GetCurrentCamera() === this.externalCamera;\n  }\n\n  /**\n   * Advances every registered camera, the external camera and any running transition, clearing the transition once it completes.\n   * @param {Number} simTime Absolute simulation time; the delta is derived from the previous call, and the first call produces a zero delta\n   */\n  @carbon.method\n  @impl.adapted\n  Update(simTime)\n  {\n    const time = Number(simTime) || 0;\n    if (this.#lastUpdate === 0)\n    {\n      this.#lastUpdate = time;\n    }\n    const deltaTime = time - this.#lastUpdate;\n    this.#lastUpdate = time;\n    for (const camera of this.cameras)\n    {\n      camera?.Update?.(deltaTime);\n    }\n    this.externalCamera?.Update?.(deltaTime);\n    if (this.transition)\n    {\n      this.transition.Update(deltaTime);\n      if (this.transition.IsComplete())\n      {\n        this.transition = null;\n      }\n    }\n  }\n\n  /**\n   * Drops any running transition, makes the camera the main one and registers it\n   * if it was not already known.\n   */\n  #setMainCamera(camera)\n  {\n    this.transition = null;\n    this.mainCamera = camera;\n    this.AddCamera(camera);\n  }\n\n  /**\n   * Switches the main camera and starts the supplied transition from the\n   * previous main camera to the new one.\n   */\n  #setMainCameraWithTransition(camera, transition)\n  {\n    const current = this.GetMainCamera();\n    this.#setMainCamera(camera);\n    transition.SetSource(current);\n    transition.SetTarget(this.GetMainCamera());\n    transition.Play();\n    this.transition = transition;\n  }\n}\n"],"names":["_EveVirtualCameraSyst","EveVirtualCameraSystem","CjsModel","e","_init_externalCamera","_init_extra_externalCamera","_init_cameras","_init_extra_cameras","_init_mainCamera","_init_extra_mainCamera","_init_transition","_init_extra_transition","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","persist","objectRef","list","read","carbon","method","impl","implemented","adapted","externalCamera","cameras","mainCamera","transition","constructor","EveVirtualCamera","SetName","SetAnimationTimelineLength","Initialize","GetCurrentCamera","GetCamera","GetMainCamera","AddCamera","camera","includes","push","GetCameraByName","name","GetName","find","CutToCamera","EveVirtualCameraTransitionCut","LerpToCamera","transitionTime","EveVirtualCameraTransitionLerp","SetTransitionTime","IsExternallyControlled","Update","simTime","time","Number","deltaTime","IsComplete","#setMainCamera","#setMainCameraWithTransition","current","SetSource","SetTarget","Play"],"mappings":"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"}

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

@@ -1,8 +1,13 @@
 import { applyDecs2311 as _applyDecs2311 } from '../../../_virtual/_rollupPluginBabelHelpers.js';
-import { io, type, carbon, impl } from '@carbonenginejs/core-types/schema';
+import { io, type, carbon, impl } from '@carbonenginejs/runtime-utils/schema';
 import { EveVirtualCameraBehaviourFloatBase as _EveVirtualCameraBeha$1 } from './EveVirtualCameraBehaviourFloatBase.js';
 
 let _initProto, _initClass, _init_scaleCurve, _init_extra_scaleCurve, _init_value, _init_extra_value;
+
+/**
+ * Float behaviour that adds an authored constant, optionally shaped across the
+ * timeline by a scale curve.
+ */
 let _EveVirtualCameraBeha;
 class EveVirtualCameraBehaviourFloatAdd extends _EveVirtualCameraBeha$1 {
   static {
@@ -16,14 +21,26 @@ class EveVirtualCameraBehaviourFloatAdd extends _EveVirtualCameraBeha$1 {
   }
   scaleCurve = (_initProto(this), _init_scaleCurve(this, null));
   value = (_init_extra_scaleCurve(this), _init_value(this, 0));
+
+  /**
+   * Names the behaviour "Add"; no scale curve is created, so the constant is
+   * unshaped until one is authored.
+   */
   constructor() {
     super(), _init_extra_value(this);
     this.name = "Add";
   }
+
+  /** Sets the behaviour name and renames the owned scale curve to match. */
   SetName(name) {
     super.SetName(name);
     this.scaleCurve?.SetName?.(`${this.name} - Scale Curve`);
   }
+
+  /**
+   * Returns the authored value, scaled by the scale curve at normalized timeline
+   * time when one is set, and returned as-is when it is not.
+   */
   Update(camera, _current, _deltaTime, localElapsedTime) {
     if (!this.scaleCurve) {
       return this.value;

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

@@ -1 +1 @@
-{"version":3,"file":"EveVirtualCameraBehaviourFloatAdd.js","sources":["../../../../../src/eve/virtualCamera/behaviour/EveVirtualCameraBehaviourFloatAdd.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\Eve\\VirtualCamera\\EveVirtualCameraBehaviour.h\n// Source: E:\\carbonengine\\trinity\\trinity\\Eve\\VirtualCamera\\EveVirtualCameraBehaviour.cpp\nimport { carbon, impl, io, type } from \"@carbonenginejs/core-types/schema\";\nimport { EveVirtualCameraBehaviourFloatBase } from \"./EveVirtualCameraBehaviourFloatBase.js\";\n\n\n@type.define({\n  className: \"EveVirtualCameraBehaviourFloatAdd\",\n  family: \"eve/virtualCamera/behaviour\"\n})\nexport class EveVirtualCameraBehaviourFloatAdd extends EveVirtualCameraBehaviourFloatBase\n{\n  @io.persist\n  @type.objectRef(\"Tr2CurveScalar\")\n  scaleCurve = null;\n\n  @io.persist\n  @type.float32\n  value = 0;\n\n  constructor()\n  {\n    super();\n    this.name = \"Add\";\n  }\n\n  @carbon.method\n  @impl.implemented\n  SetName(name)\n  {\n    super.SetName(name);\n    this.scaleCurve?.SetName?.(`${this.name} - Scale Curve`);\n  }\n\n  @carbon.method\n  @impl.adapted\n  Update(camera, _current, _deltaTime, localElapsedTime)\n  {\n    if (!this.scaleCurve)\n    {\n      return this.value;\n    }\n    const duration = Number(camera?.GetAnimationTimelineLength?.() ?? 0);\n    const time = duration !== 0 ? localElapsedTime / duration : 0;\n    return this.value * Number(this.scaleCurve.GetValue?.(time) ?? 1);\n  }\n}\n"],"names":["_EveVirtualCameraBeha","EveVirtualCameraBehaviourFloatAdd","EveVirtualCameraBehaviourFloatBase","e","_init_scaleCurve","_init_extra_scaleCurve","_init_value","_init_extra_value","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","persist","objectRef","float32","carbon","method","impl","implemented","adapted","scaleCurve","value","constructor","name","SetName","Update","camera","_current","_deltaTime","localElapsedTime","duration","Number","GetAnimationTimelineLength","time","GetValue"],"mappings":";;;;;AAG6F,IAAAA;AAG7F,MAAAC,iCAAA,SAIuDC,uBAAkC,CACzF;AAAA,EAAA;AAAA,IAAA,CAAA;MAAAC,CAAA,EAAA,CAAAC,gBAAA,EAAAC,sBAAA,EAAAC,WAAA,EAAAC,iBAAA,EAAAC,UAAA,CAAA;MAAAC,CAAA,EAAA,CAAAT,qBAAA,EAAAU,UAAA;AAAA,KAAA,GAAAC,cAAA,CAAA,IAAA,EAAA,CALCC,IAAI,CAACC,MAAM,CAAC;AACXC,MAAAA,SAAS,EAAE,mCAAmC;AAC9CC,MAAAA,MAAM,EAAE;KACT,CAAC,MAGCC,EAAE,EAAFA,EAAE,CAACC,OAAO,EAAA,MAAA,EACVL,IAAI,CAACM,SAAS,CAAC,gBAAgB,CAAC,CAAA,EAAA,EAAA,EAAA,YAAA,CAAA,EAAA,CAAA,CAGhCF,EAAE,EAAFA,EAAE,CAACC,OAAO,EACVL,IAAI,EAAJA,IAAI,CAACO,OAAO,CAAA,EAAA,EAAA,EAAA,OAAA,CAAA,EAAA,CAAA,CASZC,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACC,WAAW,CAAA,EAAA,EAAA,EAAA,SAAA,CAAA,EAAA,CAAA,CAOhBH,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACE,OAAO,CAAA,EAAA,EAAA,EAAA,QAAA,CAAA,CAAA,EAAA,CAAA,EAAA,MAAA,EAzBwCtB,uBAAkC,CAAA;AAAA;AAIvFuB,EAAAA,UAAU,IAAAjB,UAAA,CAAA,IAAA,CAAA,EAAAJ,gBAAA,OAAG,IAAI,CAAA;AAIjBsB,EAAAA,KAAK,IAAArB,sBAAA,CAAA,IAAA,CAAA,EAAAC,WAAA,OAAG,CAAC,CAAA;AAETqB,EAAAA,WAAWA,GACX;IACE,KAAK,EAAE,EAAApB,iBAAA,CAAA,IAAA,CAAA;IACP,IAAI,CAACqB,IAAI,GAAG,KAAK;AACnB,EAAA;EAIAC,OAAOA,CAACD,IAAI,EACZ;AACE,IAAA,KAAK,CAACC,OAAO,CAACD,IAAI,CAAC;IACnB,IAAI,CAACH,UAAU,EAAEI,OAAO,GAAG,GAAG,IAAI,CAACD,IAAI,CAAA,cAAA,CAAgB,CAAC;AAC1D,EAAA;EAIAE,MAAMA,CAACC,MAAM,EAAEC,QAAQ,EAAEC,UAAU,EAAEC,gBAAgB,EACrD;AACE,IAAA,IAAI,CAAC,IAAI,CAACT,UAAU,EACpB;MACE,OAAO,IAAI,CAACC,KAAK;AACnB,IAAA;IACA,MAAMS,QAAQ,GAAGC,MAAM,CAACL,MAAM,EAAEM,0BAA0B,IAAI,IAAI,CAAC,CAAC;IACpE,MAAMC,IAAI,GAAGH,QAAQ,KAAK,CAAC,GAAGD,gBAAgB,GAAGC,QAAQ,GAAG,CAAC;AAC7D,IAAA,OAAO,IAAI,CAACT,KAAK,GAAGU,MAAM,CAAC,IAAI,CAACX,UAAU,CAACc,QAAQ,GAAGD,IAAI,CAAC,IAAI,CAAC,CAAC;AACnE,EAAA;AAAC,EAAA;IAAA5B,UAAA,EAAA;AAAA;AACH;;;;"}
+{"version":3,"file":"EveVirtualCameraBehaviourFloatAdd.js","sources":["../../../../../src/eve/virtualCamera/behaviour/EveVirtualCameraBehaviourFloatAdd.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\Eve\\VirtualCamera\\EveVirtualCameraBehaviour.h\n// Source: E:\\carbonengine\\trinity\\trinity\\Eve\\VirtualCamera\\EveVirtualCameraBehaviour.cpp\nimport { carbon, impl, io, type } from \"@carbonenginejs/runtime-utils/schema\";\nimport { EveVirtualCameraBehaviourFloatBase } from \"./EveVirtualCameraBehaviourFloatBase.js\";\n\n\n/**\n * Float behaviour that adds an authored constant, optionally shaped across the\n * timeline by a scale curve.\n */\n@type.define({\n  className: \"EveVirtualCameraBehaviourFloatAdd\",\n  family: \"eve/virtualCamera/behaviour\"\n})\nexport class EveVirtualCameraBehaviourFloatAdd extends EveVirtualCameraBehaviourFloatBase\n{\n  @io.persist\n  @type.objectRef(\"Tr2CurveScalar\")\n  scaleCurve = null;\n\n  @io.persist\n  @type.float32\n  value = 0;\n\n  /**\n   * Names the behaviour \"Add\"; no scale curve is created, so the constant is\n   * unshaped until one is authored.\n   */\n  constructor()\n  {\n    super();\n    this.name = \"Add\";\n  }\n\n  /** Sets the behaviour name and renames the owned scale curve to match. */\n  @carbon.method\n  @impl.implemented\n  SetName(name)\n  {\n    super.SetName(name);\n    this.scaleCurve?.SetName?.(`${this.name} - Scale Curve`);\n  }\n\n  /**\n   * Returns the authored value, scaled by the scale curve at normalized timeline\n   * time when one is set, and returned as-is when it is not.\n   */\n  @carbon.method\n  @impl.adapted\n  Update(camera, _current, _deltaTime, localElapsedTime)\n  {\n    if (!this.scaleCurve)\n    {\n      return this.value;\n    }\n    const duration = Number(camera?.GetAnimationTimelineLength?.() ?? 0);\n    const time = duration !== 0 ? localElapsedTime / duration : 0;\n    return this.value * Number(this.scaleCurve.GetValue?.(time) ?? 1);\n  }\n}\n"],"names":["_EveVirtualCameraBeha","EveVirtualCameraBehaviourFloatAdd","EveVirtualCameraBehaviourFloatBase","e","_init_scaleCurve","_init_extra_scaleCurve","_init_value","_init_extra_value","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","persist","objectRef","float32","carbon","method","impl","implemented","adapted","scaleCurve","value","constructor","name","SetName","Update","camera","_current","_deltaTime","localElapsedTime","duration","Number","GetAnimationTimelineLength","time","GetValue"],"mappings":";;;;;;AAMA;AACA;AACA;AACA;AAHA,IAAAA;AAIA,MAAAC,iCAAA,SAIuDC,uBAAkC,CACzF;AAAA,EAAA;AAAA,IAAA,CAAA;MAAAC,CAAA,EAAA,CAAAC,gBAAA,EAAAC,sBAAA,EAAAC,WAAA,EAAAC,iBAAA,EAAAC,UAAA,CAAA;MAAAC,CAAA,EAAA,CAAAT,qBAAA,EAAAU,UAAA;AAAA,KAAA,GAAAC,cAAA,CAAA,IAAA,EAAA,CALCC,IAAI,CAACC,MAAM,CAAC;AACXC,MAAAA,SAAS,EAAE,mCAAmC;AAC9CC,MAAAA,MAAM,EAAE;KACT,CAAC,MAGCC,EAAE,EAAFA,EAAE,CAACC,OAAO,EAAA,MAAA,EACVL,IAAI,CAACM,SAAS,CAAC,gBAAgB,CAAC,CAAA,EAAA,EAAA,EAAA,YAAA,CAAA,EAAA,CAAA,CAGhCF,EAAE,EAAFA,EAAE,CAACC,OAAO,EACVL,IAAI,EAAJA,IAAI,CAACO,OAAO,CAAA,EAAA,EAAA,EAAA,OAAA,CAAA,EAAA,CAAA,CAcZC,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACC,WAAW,CAAA,EAAA,EAAA,EAAA,SAAA,CAAA,EAAA,CAAA,CAWhBH,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACE,OAAO,CAAA,EAAA,EAAA,EAAA,QAAA,CAAA,CAAA,EAAA,CAAA,EAAA,MAAA,EAlCwCtB,uBAAkC,CAAA;AAAA;AAIvFuB,EAAAA,UAAU,IAAAjB,UAAA,CAAA,IAAA,CAAA,EAAAJ,gBAAA,OAAG,IAAI,CAAA;AAIjBsB,EAAAA,KAAK,IAAArB,sBAAA,CAAA,IAAA,CAAA,EAAAC,WAAA,OAAG,CAAC,CAAA;;AAET;AACF;AACA;AACA;AACEqB,EAAAA,WAAWA,GACX;IACE,KAAK,EAAE,EAAApB,iBAAA,CAAA,IAAA,CAAA;IACP,IAAI,CAACqB,IAAI,GAAG,KAAK;AACnB,EAAA;;AAEA;EAGAC,OAAOA,CAACD,IAAI,EACZ;AACE,IAAA,KAAK,CAACC,OAAO,CAACD,IAAI,CAAC;IACnB,IAAI,CAACH,UAAU,EAAEI,OAAO,GAAG,GAAG,IAAI,CAACD,IAAI,CAAA,cAAA,CAAgB,CAAC;AAC1D,EAAA;;AAEA;AACF;AACA;AACA;EAGEE,MAAMA,CAACC,MAAM,EAAEC,QAAQ,EAAEC,UAAU,EAAEC,gBAAgB,EACrD;AACE,IAAA,IAAI,CAAC,IAAI,CAACT,UAAU,EACpB;MACE,OAAO,IAAI,CAACC,KAAK;AACnB,IAAA;IACA,MAAMS,QAAQ,GAAGC,MAAM,CAACL,MAAM,EAAEM,0BAA0B,IAAI,IAAI,CAAC,CAAC;IACpE,MAAMC,IAAI,GAAGH,QAAQ,KAAK,CAAC,GAAGD,gBAAgB,GAAGC,QAAQ,GAAG,CAAC;AAC7D,IAAA,OAAO,IAAI,CAACT,KAAK,GAAGU,MAAM,CAAC,IAAI,CAACX,UAAU,CAACc,QAAQ,GAAGD,IAAI,CAAC,IAAI,CAAC,CAAC;AACnE,EAAA;AAAC,EAAA;IAAA5B,UAAA,EAAA;AAAA;AACH;;;;"}

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

@@ -1,8 +1,13 @@
 import { applyDecs2311 as _applyDecs2311 } from '../../../_virtual/_rollupPluginBabelHelpers.js';
-import { CjsModel } from '@carbonenginejs/core-types/model';
-import { io, type, carbon, impl } from '@carbonenginejs/core-types/schema';
+import { CjsModel } from '@carbonenginejs/runtime-utils/model';
+import { io, type, carbon, impl } from '@carbonenginejs/runtime-utils/schema';
 
 let _initProto, _initClass, _init_active, _init_extra_active, _init_name, _init_extra_name;
+
+/**
+ * Base for the virtual camera behaviours that contribute a scalar delta to a
+ * camera's field of view or roll each update.
+ */
 let _EveVirtualCameraBeha;
 class EveVirtualCameraBehaviourFloatBase extends CjsModel {
   static {
@@ -20,16 +25,30 @@ class EveVirtualCameraBehaviourFloatBase extends CjsModel {
   }
   active = (_initProto(this), _init_active(this, true));
   name = (_init_extra_active(this), _init_name(this, ""));
+
+  /** Returns the authored behaviour name shown in tooling. */
   GetName() {
     return this.name;
   }
+
+  /**
+   * Sets the behaviour name, coercing to a string; subclasses override this to
+   * rename the curves they own alongside it.
+   */
   SetName(name) {
     this.name = String(name);
   }
+
+  /**
+   * Re-applies the current name after a field change, which propagates it to any
+   * owned curves through the subclass SetName override.
+   */
   OnModified(_options = {}) {
     this.SetName(this.name);
     return true;
   }
+
+  /** Reports whether the camera should evaluate this behaviour this update. */
   IsActive() {
     return this.active;
   }

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

@@ -1 +1 @@
-{"version":3,"file":"EveVirtualCameraBehaviourFloatBase.js","sources":["../../../../../src/eve/virtualCamera/behaviour/EveVirtualCameraBehaviourFloatBase.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\Eve\\VirtualCamera\\EveVirtualCameraBehaviour.h\r\n// Source: E:\\carbonengine\\trinity\\trinity\\Eve\\VirtualCamera\\EveVirtualCameraBehaviour.cpp\r\nimport { CjsModel } from \"@carbonenginejs/core-types/model\";\r\nimport { carbon, impl, io, type } from \"@carbonenginejs/core-types/schema\";\r\n\r\n\r\n@type.define({\r\n  className: \"EveVirtualCameraBehaviourFloatBase\",\r\n  family: \"eve/virtualCamera/behaviour\"\r\n})\r\nexport class EveVirtualCameraBehaviourFloatBase extends CjsModel\r\n{\r\n  @io.persist\r\n  @type.boolean\r\n  active = true;\r\n\r\n  @io.notify\r\n  @io.persist\r\n  @type.string\r\n  name = \"\";\r\n\r\n  @carbon.method\r\n  @impl.implemented\r\n  GetName()\r\n  {\r\n    return this.name;\r\n  }\r\n\r\n  @carbon.method\r\n  @impl.implemented\r\n  SetName(name)\r\n  {\r\n    this.name = String(name);\r\n  }\r\n\r\n  @carbon.method\r\n  @impl.adapted\r\n  OnModified(_options = {})\r\n  {\r\n    this.SetName(this.name);\r\n    return true;\r\n  }\r\n\r\n  @carbon.method\r\n  @impl.implemented\r\n  IsActive()\r\n  {\r\n    return this.active;\r\n  }\r\n}\r\n"],"names":["_EveVirtualCameraBeha","EveVirtualCameraBehaviourFloatBase","CjsModel","e","_init_active","_init_extra_active","_init_name","_init_extra_name","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","persist","boolean","notify","string","carbon","method","impl","implemented","adapted","constructor","args","active","name","GetName","SetName","String","OnModified","_options","IsActive"],"mappings":";;;;;AAG2E,IAAAA;AAG3E,MAAAC,kCAAA,SAIwDC,QAAQ,CAChE;AAAA,EAAA;AAAA,IAAA,CAAA;MAAAC,CAAA,EAAA,CAAAC,YAAA,EAAAC,kBAAA,EAAAC,UAAA,EAAAC,gBAAA,EAAAC,UAAA,CAAA;MAAAC,CAAA,EAAA,CAAAT,qBAAA,EAAAU,UAAA;AAAA,KAAA,GAAAC,cAAA,CAAA,IAAA,EAAA,CALCC,IAAI,CAACC,MAAM,CAAC;AACXC,MAAAA,SAAS,EAAE,oCAAoC;AAC/CC,MAAAA,MAAM,EAAE;AACV,KAAC,CAAC,CAAA,EAAA,CAAA,CAAA,CAGCC,EAAE,EAAFA,EAAE,CAACC,OAAO,EACVL,IAAI,EAAJA,IAAI,CAACM,OAAO,oBAGZF,EAAE,EAAFA,EAAE,CAACG,MAAM,EACTH,EAAE,EAAFA,EAAE,CAACC,OAAO,EACVL,IAAI,EAAJA,IAAI,CAACQ,MAAM,kBAGXC,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACC,WAAW,CAAA,EAAA,EAAA,EAAA,SAAA,CAAA,EAAA,CAAA,CAMhBH,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACC,WAAW,qBAMhBH,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACE,OAAO,CAAA,EAAA,EAAA,EAAA,YAAA,CAAA,EAAA,CAAA,CAOZJ,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACC,WAAW,gCAlCqCtB,QAAQ,CAAA;AAAA;AAAAwB,EAAAA,WAAAA,CAAA,GAAAC,IAAA,EAAA;AAAA,IAAA,KAAA,CAAA,GAAAA,IAAA,CAAA;IAAApB,gBAAA,CAAA,IAAA,CAAA;AAAA,EAAA;AAI9DqB,EAAAA,MAAM,IAAApB,UAAA,CAAA,IAAA,CAAA,EAAAJ,YAAA,OAAG,IAAI,CAAA;AAKbyB,EAAAA,IAAI,IAAAxB,kBAAA,CAAA,IAAA,CAAA,EAAAC,UAAA,OAAG,EAAE,CAAA;AAITwB,EAAAA,OAAOA,GACP;IACE,OAAO,IAAI,CAACD,IAAI;AAClB,EAAA;EAIAE,OAAOA,CAACF,IAAI,EACZ;AACE,IAAA,IAAI,CAACA,IAAI,GAAGG,MAAM,CAACH,IAAI,CAAC;AAC1B,EAAA;AAIAI,EAAAA,UAAUA,CAACC,QAAQ,GAAG,EAAE,EACxB;AACE,IAAA,IAAI,CAACH,OAAO,CAAC,IAAI,CAACF,IAAI,CAAC;AACvB,IAAA,OAAO,IAAI;AACb,EAAA;AAIAM,EAAAA,QAAQA,GACR;IACE,OAAO,IAAI,CAACP,MAAM;AACpB,EAAA;AAAC,EAAA;IAAAlB,UAAA,EAAA;AAAA;AACH;;;;"}
+{"version":3,"file":"EveVirtualCameraBehaviourFloatBase.js","sources":["../../../../../src/eve/virtualCamera/behaviour/EveVirtualCameraBehaviourFloatBase.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\Eve\\VirtualCamera\\EveVirtualCameraBehaviour.h\r\n// Source: E:\\carbonengine\\trinity\\trinity\\Eve\\VirtualCamera\\EveVirtualCameraBehaviour.cpp\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 * Base for the virtual camera behaviours that contribute a scalar delta to a\r\n * camera's field of view or roll each update.\r\n */\r\n@type.define({\r\n  className: \"EveVirtualCameraBehaviourFloatBase\",\r\n  family: \"eve/virtualCamera/behaviour\"\r\n})\r\nexport class EveVirtualCameraBehaviourFloatBase extends CjsModel\r\n{\r\n  @io.persist\r\n  @type.boolean\r\n  active = true;\r\n\r\n  @io.notify\r\n  @io.persist\r\n  @type.string\r\n  name = \"\";\r\n\r\n  /** Returns the authored behaviour name shown in tooling. */\r\n  @carbon.method\r\n  @impl.implemented\r\n  GetName()\r\n  {\r\n    return this.name;\r\n  }\r\n\r\n  /**\r\n   * Sets the behaviour name, coercing to a string; subclasses override this to\r\n   * rename the curves they own alongside it.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  SetName(name)\r\n  {\r\n    this.name = String(name);\r\n  }\r\n\r\n  /**\r\n   * Re-applies the current name after a field change, which propagates it to any\r\n   * owned curves through the subclass SetName override.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  OnModified(_options = {})\r\n  {\r\n    this.SetName(this.name);\r\n    return true;\r\n  }\r\n\r\n  /** Reports whether the camera should evaluate this behaviour this update. */\r\n  @carbon.method\r\n  @impl.implemented\r\n  IsActive()\r\n  {\r\n    return this.active;\r\n  }\r\n}\r\n"],"names":["_EveVirtualCameraBeha","EveVirtualCameraBehaviourFloatBase","CjsModel","e","_init_active","_init_extra_active","_init_name","_init_extra_name","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","persist","boolean","notify","string","carbon","method","impl","implemented","adapted","constructor","args","active","name","GetName","SetName","String","OnModified","_options","IsActive"],"mappings":";;;;;;AAMA;AACA;AACA;AACA;AAHA,IAAAA;AAIA,MAAAC,kCAAA,SAIwDC,QAAQ,CAChE;AAAA,EAAA;AAAA,IAAA,CAAA;MAAAC,CAAA,EAAA,CAAAC,YAAA,EAAAC,kBAAA,EAAAC,UAAA,EAAAC,gBAAA,EAAAC,UAAA,CAAA;MAAAC,CAAA,EAAA,CAAAT,qBAAA,EAAAU,UAAA;AAAA,KAAA,GAAAC,cAAA,CAAA,IAAA,EAAA,CALCC,IAAI,CAACC,MAAM,CAAC;AACXC,MAAAA,SAAS,EAAE,oCAAoC;AAC/CC,MAAAA,MAAM,EAAE;AACV,KAAC,CAAC,CAAA,EAAA,CAAA,CAAA,CAGCC,EAAE,EAAFA,EAAE,CAACC,OAAO,EACVL,IAAI,EAAJA,IAAI,CAACM,OAAO,oBAGZF,EAAE,EAAFA,EAAE,CAACG,MAAM,EACTH,EAAE,EAAFA,EAAE,CAACC,OAAO,EACVL,IAAI,EAAJA,IAAI,CAACQ,MAAM,kBAIXC,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACC,WAAW,CAAA,EAAA,EAAA,EAAA,SAAA,CAAA,EAAA,CAAA,CAUhBH,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACC,WAAW,qBAUhBH,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACE,OAAO,CAAA,EAAA,EAAA,EAAA,YAAA,CAAA,EAAA,CAAA,CAQZJ,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACC,WAAW,gCA5CqCtB,QAAQ,CAAA;AAAA;AAAAwB,EAAAA,WAAAA,CAAA,GAAAC,IAAA,EAAA;AAAA,IAAA,KAAA,CAAA,GAAAA,IAAA,CAAA;IAAApB,gBAAA,CAAA,IAAA,CAAA;AAAA,EAAA;AAI9DqB,EAAAA,MAAM,IAAApB,UAAA,CAAA,IAAA,CAAA,EAAAJ,YAAA,OAAG,IAAI,CAAA;AAKbyB,EAAAA,IAAI,IAAAxB,kBAAA,CAAA,IAAA,CAAA,EAAAC,UAAA,OAAG,EAAE,CAAA;;AAET;AAGAwB,EAAAA,OAAOA,GACP;IACE,OAAO,IAAI,CAACD,IAAI;AAClB,EAAA;;AAEA;AACF;AACA;AACA;EAGEE,OAAOA,CAACF,IAAI,EACZ;AACE,IAAA,IAAI,CAACA,IAAI,GAAGG,MAAM,CAACH,IAAI,CAAC;AAC1B,EAAA;;AAEA;AACF;AACA;AACA;AAGEI,EAAAA,UAAUA,CAACC,QAAQ,GAAG,EAAE,EACxB;AACE,IAAA,IAAI,CAACH,OAAO,CAAC,IAAI,CAACF,IAAI,CAAC;AACvB,IAAA,OAAO,IAAI;AACb,EAAA;;AAEA;AAGAM,EAAAA,QAAQA,GACR;IACE,OAAO,IAAI,CAACP,MAAM;AACpB,EAAA;AAAC,EAAA;IAAAlB,UAAA,EAAA;AAAA;AACH;;;;"}

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

@@ -1,8 +1,13 @@
 import { applyDecs2311 as _applyDecs2311 } from '../../../_virtual/_rollupPluginBabelHelpers.js';
-import { io, type, carbon, impl } from '@carbonenginejs/core-types/schema';
+import { io, type, carbon, impl } from '@carbonenginejs/runtime-utils/schema';
 import { EveVirtualCameraBehaviourFloatBase as _EveVirtualCameraBeha$1 } from './EveVirtualCameraBehaviourFloatBase.js';
 
 let _initProto, _initClass, _init_dampingFactor, _init_extra_dampingFactor;
+
+/**
+ * Float behaviour that lags a scalar camera value behind the value the other
+ * behaviours produced, smoothing sudden changes.
+ */
 let _EveVirtualCameraBeha;
 class EveVirtualCameraBehaviourFloatDamping extends _EveVirtualCameraBeha$1 {
   static {
@@ -16,10 +21,22 @@ class EveVirtualCameraBehaviourFloatDamping extends _EveVirtualCameraBeha$1 {
   }
   dampingFactor = (_initProto(this), _init_dampingFactor(this, 1));
   #lastValue = (_init_extra_dampingFactor(this), 0);
+
+  /**
+   * Names the behaviour "Damping"; the default damping factor of 1 follows the
+   * input exactly.
+   */
   constructor() {
     super();
     this.name = "Damping";
   }
+
+  /**
+   * Moves the retained value a dampingFactor fraction of the way towards the
+   * incoming value and returns the difference, so the accumulated result lands
+   * on the smoothed value; the first update (local time at or below zero) only
+   * seeds the retained value and contributes nothing.
+   */
   Update(_camera, current, _deltaTime, localElapsedTime) {
     if (localElapsedTime <= 0) {
       this.#lastValue = current;

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

@@ -1 +1 @@
-{"version":3,"file":"EveVirtualCameraBehaviourFloatDamping.js","sources":["../../../../../src/eve/virtualCamera/behaviour/EveVirtualCameraBehaviourFloatDamping.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\Eve\\VirtualCamera\\EveVirtualCameraBehaviour.h\n// Source: E:\\carbonengine\\trinity\\trinity\\Eve\\VirtualCamera\\EveVirtualCameraBehaviour.cpp\nimport { carbon, impl, io, type } from \"@carbonenginejs/core-types/schema\";\nimport { EveVirtualCameraBehaviourFloatBase } from \"./EveVirtualCameraBehaviourFloatBase.js\";\n\n\n@type.define({\n  className: \"EveVirtualCameraBehaviourFloatDamping\",\n  family: \"eve/virtualCamera/behaviour\"\n})\nexport class EveVirtualCameraBehaviourFloatDamping extends EveVirtualCameraBehaviourFloatBase\n{\n  @io.persist\n  @type.float32\n  dampingFactor = 1;\n\n  #lastValue = 0;\n\n  constructor()\n  {\n    super();\n    this.name = \"Damping\";\n  }\n\n  @carbon.method\n  @impl.implemented\n  Update(_camera, current, _deltaTime, localElapsedTime)\n  {\n    if (localElapsedTime <= 0)\n    {\n      this.#lastValue = current;\n      return 0;\n    }\n    this.#lastValue += (current - this.#lastValue) * this.dampingFactor;\n    return this.#lastValue - current;\n  }\n}\n"],"names":["_EveVirtualCameraBeha","EveVirtualCameraBehaviourFloatDamping","EveVirtualCameraBehaviourFloatBase","e","_init_dampingFactor","_init_extra_dampingFactor","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","persist","float32","carbon","method","impl","implemented","dampingFactor","constructor","name","Update","_camera","current","_deltaTime","localElapsedTime"],"mappings":";;;;;AAG6F,IAAAA;AAG7F,MAAAC,qCAAA,SAI2DC,uBAAkC,CAC7F;AAAA,EAAA;AAAA,IAAA,CAAA;AAAAC,MAAAA,CAAA,EAAA,CAAAC,mBAAA,EAAAC,yBAAA,EAAAC,UAAA,CAAA;MAAAC,CAAA,EAAA,CAAAP,qBAAA,EAAAQ,UAAA;AAAA,KAAA,GAAAC,cAAA,CAAA,IAAA,EAAA,CALCC,IAAI,CAACC,MAAM,CAAC;AACXC,MAAAA,SAAS,EAAE,uCAAuC;AAClDC,MAAAA,MAAM,EAAE;KACT,CAAC,CAAA,EAAA,CAAA,CAAA,CAGCC,EAAE,EAAFA,EAAE,CAACC,OAAO,EACVL,IAAI,EAAJA,IAAI,CAACM,OAAO,2BAWZC,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACC,WAAW,CAAA,EAAA,EAAA,EAAA,QAAA,CAAA,CAAA,EAAA,CAAA,EAAA,MAAA,EAfwClB,uBAAkC,CAAA;AAAA;AAI3FmB,EAAAA,aAAa,IAAAf,UAAA,CAAA,IAAA,CAAA,EAAAF,mBAAA,OAAG,CAAC,CAAA;AAEjB,EAAA,UAAU,IAAAC,yBAAA,CAAA,IAAA,CAAA,EAAG,CAAC;AAEdiB,EAAAA,WAAWA,GACX;AACE,IAAA,KAAK,EAAE;IACP,IAAI,CAACC,IAAI,GAAG,SAAS;AACvB,EAAA;EAIAC,MAAMA,CAACC,OAAO,EAAEC,OAAO,EAAEC,UAAU,EAAEC,gBAAgB,EACrD;IACE,IAAIA,gBAAgB,IAAI,CAAC,EACzB;AACE,MAAA,IAAI,CAAC,UAAU,GAAGF,OAAO;AACzB,MAAA,OAAO,CAAC;AACV,IAAA;AACA,IAAA,IAAI,CAAC,UAAU,IAAI,CAACA,OAAO,GAAG,IAAI,CAAC,UAAU,IAAI,IAAI,CAACL,aAAa;AACnE,IAAA,OAAO,IAAI,CAAC,UAAU,GAAGK,OAAO;AAClC,EAAA;AAAC,EAAA;IAAAlB,UAAA,EAAA;AAAA;AACH;;;;"}
+{"version":3,"file":"EveVirtualCameraBehaviourFloatDamping.js","sources":["../../../../../src/eve/virtualCamera/behaviour/EveVirtualCameraBehaviourFloatDamping.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\Eve\\VirtualCamera\\EveVirtualCameraBehaviour.h\n// Source: E:\\carbonengine\\trinity\\trinity\\Eve\\VirtualCamera\\EveVirtualCameraBehaviour.cpp\nimport { carbon, impl, io, type } from \"@carbonenginejs/runtime-utils/schema\";\nimport { EveVirtualCameraBehaviourFloatBase } from \"./EveVirtualCameraBehaviourFloatBase.js\";\n\n\n/**\n * Float behaviour that lags a scalar camera value behind the value the other\n * behaviours produced, smoothing sudden changes.\n */\n@type.define({\n  className: \"EveVirtualCameraBehaviourFloatDamping\",\n  family: \"eve/virtualCamera/behaviour\"\n})\nexport class EveVirtualCameraBehaviourFloatDamping extends EveVirtualCameraBehaviourFloatBase\n{\n  @io.persist\n  @type.float32\n  dampingFactor = 1;\n\n  #lastValue = 0;\n\n  /**\n   * Names the behaviour \"Damping\"; the default damping factor of 1 follows the\n   * input exactly.\n   */\n  constructor()\n  {\n    super();\n    this.name = \"Damping\";\n  }\n\n  /**\n   * Moves the retained value a dampingFactor fraction of the way towards the\n   * incoming value and returns the difference, so the accumulated result lands\n   * on the smoothed value; the first update (local time at or below zero) only\n   * seeds the retained value and contributes nothing.\n   */\n  @carbon.method\n  @impl.implemented\n  Update(_camera, current, _deltaTime, localElapsedTime)\n  {\n    if (localElapsedTime <= 0)\n    {\n      this.#lastValue = current;\n      return 0;\n    }\n    this.#lastValue += (current - this.#lastValue) * this.dampingFactor;\n    return this.#lastValue - current;\n  }\n}\n"],"names":["_EveVirtualCameraBeha","EveVirtualCameraBehaviourFloatDamping","EveVirtualCameraBehaviourFloatBase","e","_init_dampingFactor","_init_extra_dampingFactor","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","persist","float32","carbon","method","impl","implemented","dampingFactor","constructor","name","Update","_camera","current","_deltaTime","localElapsedTime"],"mappings":";;;;;;AAMA;AACA;AACA;AACA;AAHA,IAAAA;AAIA,MAAAC,qCAAA,SAI2DC,uBAAkC,CAC7F;AAAA,EAAA;AAAA,IAAA,CAAA;AAAAC,MAAAA,CAAA,EAAA,CAAAC,mBAAA,EAAAC,yBAAA,EAAAC,UAAA,CAAA;MAAAC,CAAA,EAAA,CAAAP,qBAAA,EAAAQ,UAAA;AAAA,KAAA,GAAAC,cAAA,CAAA,IAAA,EAAA,CALCC,IAAI,CAACC,MAAM,CAAC;AACXC,MAAAA,SAAS,EAAE,uCAAuC;AAClDC,MAAAA,MAAM,EAAE;KACT,CAAC,CAAA,EAAA,CAAA,CAAA,CAGCC,EAAE,EAAFA,EAAE,CAACC,OAAO,EACVL,IAAI,EAAJA,IAAI,CAACM,OAAO,2BAqBZC,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACC,WAAW,CAAA,EAAA,EAAA,EAAA,QAAA,CAAA,CAAA,EAAA,CAAA,EAAA,MAAA,EAzBwClB,uBAAkC,CAAA;AAAA;AAI3FmB,EAAAA,aAAa,IAAAf,UAAA,CAAA,IAAA,CAAA,EAAAF,mBAAA,OAAG,CAAC,CAAA;AAEjB,EAAA,UAAU,IAAAC,yBAAA,CAAA,IAAA,CAAA,EAAG,CAAC;;AAEd;AACF;AACA;AACA;AACEiB,EAAAA,WAAWA,GACX;AACE,IAAA,KAAK,EAAE;IACP,IAAI,CAACC,IAAI,GAAG,SAAS;AACvB,EAAA;;AAEA;AACF;AACA;AACA;AACA;AACA;EAGEC,MAAMA,CAACC,OAAO,EAAEC,OAAO,EAAEC,UAAU,EAAEC,gBAAgB,EACrD;IACE,IAAIA,gBAAgB,IAAI,CAAC,EACzB;AACE,MAAA,IAAI,CAAC,UAAU,GAAGF,OAAO;AACzB,MAAA,OAAO,CAAC;AACV,IAAA;AACA,IAAA,IAAI,CAAC,UAAU,IAAI,CAACA,OAAO,GAAG,IAAI,CAAC,UAAU,IAAI,IAAI,CAACL,aAAa;AACnE,IAAA,OAAO,IAAI,CAAC,UAAU,GAAGK,OAAO;AAClC,EAAA;AAAC,EAAA;IAAAlB,UAAA,EAAA;AAAA;AACH;;;;"}

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

@@ -1,11 +1,16 @@
 import { identity as _identity, applyDecs2311 as _applyDecs2311 } from '../../../_virtual/_rollupPluginBabelHelpers.js';
-import { io, type, carbon, impl } from '@carbonenginejs/core-types/schema';
+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 { EveVirtualCameraBehaviourFloatBase as _EveVirtualCameraBeha$1 } from './EveVirtualCameraBehaviourFloatBase.js';
 
 let _initProto, _initClass, _init_octaves, _init_extra_octaves, _init_magnitudeCurve, _init_extra_magnitudeCurve, _init_magnitude, _init_extra_magnitude, _init_perlineScale, _init_extra_perlineScale;
+
+/**
+ * Float behaviour that adds a Perlin-noise wobble to a scalar camera value such
+ * as field of view or roll.
+ */
 let _EveVirtualCameraBeha;
 new class extends _identity {
   static [class EveVirtualCameraBehaviourFloatNoise extends _EveVirtualCameraBeha$1 {
@@ -23,15 +28,28 @@ new class extends _identity {
     magnitude = (_init_extra_magnitudeCurve(this), _init_magnitude(this, 1));
     perlineScale = (_init_extra_magnitude(this), _init_perlineScale(this, 1));
     #phase = (_init_extra_perlineScale(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 authored magnitude scaled by a 1D Perlin sample of the
+     * phase-offset local time (rate set by perlineScale, detail by octaves) and by
+     * the magnitude envelope at normalized timeline time.
+     */
     Update(camera, _current, _deltaTime, localElapsedTime) {
       let offset = this.magnitude * _TriPerlinCurve.PerlinNoise1D((localElapsedTime + this.#phase) * this.perlineScale, 2, 2, this.octaves);
       if (this.magnitudeCurve) {
@@ -41,6 +59,17 @@ new class extends _identity {
       }
       return offset;
     }
+
+    /**
+     * Builds the default envelope over normalized time: a near-instant ramp 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, keeping simultaneous noise behaviours from moving in lockstep.
+     */
   }];
   #nextPhase = 0;
   #createMagnitudeCurve() {

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

@@ -1 +1 @@
-{"version":3,"file":"EveVirtualCameraBehaviourFloatNoise.js","sources":["../../../../../src/eve/virtualCamera/behaviour/EveVirtualCameraBehaviourFloatNoise.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\Eve\\VirtualCamera\\EveVirtualCameraBehaviour.h\n// Source: E:\\carbonengine\\trinity\\trinity\\Eve\\VirtualCamera\\EveVirtualCameraBehaviour.cpp\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 { EveVirtualCameraBehaviourFloatBase } from \"./EveVirtualCameraBehaviourFloatBase.js\";\n\n\n@type.define({\n  className: \"EveVirtualCameraBehaviourFloatNoise\",\n  family: \"eve/virtualCamera/behaviour\"\n})\nexport class EveVirtualCameraBehaviourFloatNoise extends EveVirtualCameraBehaviourFloatBase\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.float32\n  magnitude = 1;\n\n  @io.persist\n  @type.float32\n  perlineScale = 1;\n\n  #phase = EveVirtualCameraBehaviourFloatNoise.#allocatePhase();\n\n  constructor()\n  {\n    super();\n    this.magnitudeCurve = EveVirtualCameraBehaviourFloatNoise.#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)\n  {\n    let offset = this.magnitude * TriPerlinCurve.PerlinNoise1D(\n      (localElapsedTime + this.#phase) * this.perlineScale,\n      2,\n      2,\n      this.octaves\n    );\n    if (this.magnitudeCurve)\n    {\n      const duration = Number(camera?.GetAnimationTimelineLength?.() ?? 0);\n      const time = duration !== 0 ? localElapsedTime / duration : 0;\n      offset *= Number(this.magnitudeCurve.GetValue?.(time) ?? 1);\n    }\n    return offset;\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 = EveVirtualCameraBehaviourFloatNoise.#nextPhase & 0xfff;\n    EveVirtualCameraBehaviourFloatNoise.#nextPhase++;\n    return phase;\n  }\n}\n"],"names":["_EveVirtualCameraBeha","_identity","EveVirtualCameraBehaviourFloatNoise","EveVirtualCameraBehaviourFloatBase","e","_init_octaves","_init_extra_octaves","_init_magnitudeCurve","_init_extra_magnitudeCurve","_init_magnitude","_init_extra_magnitude","_init_perlineScale","_init_extra_perlineScale","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","persist","int32","objectRef","float32","carbon","method","impl","implemented","adapted","octaves","magnitudeCurve","magnitude","perlineScale","constructor","SetName","name","Update","camera","_current","_deltaTime","localElapsedTime","offset","TriPerlinCurve","PerlinNoise1D","duration","Number","GetAnimationTimelineLength","time","GetValue","#createMagnitudeCurve","curve","Tr2CurveScalar","SetExtrapolation","Tr2CurveExtrapolation","LINEAR","AddKey","#allocatePhase","phase"],"mappings":"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"}
+{"version":3,"file":"EveVirtualCameraBehaviourFloatNoise.js","sources":["../../../../../src/eve/virtualCamera/behaviour/EveVirtualCameraBehaviourFloatNoise.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\Eve\\VirtualCamera\\EveVirtualCameraBehaviour.h\n// Source: E:\\carbonengine\\trinity\\trinity\\Eve\\VirtualCamera\\EveVirtualCameraBehaviour.cpp\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 { EveVirtualCameraBehaviourFloatBase } from \"./EveVirtualCameraBehaviourFloatBase.js\";\n\n\n/**\n * Float behaviour that adds a Perlin-noise wobble to a scalar camera value such\n * as field of view or roll.\n */\n@type.define({\n  className: \"EveVirtualCameraBehaviourFloatNoise\",\n  family: \"eve/virtualCamera/behaviour\"\n})\nexport class EveVirtualCameraBehaviourFloatNoise extends EveVirtualCameraBehaviourFloatBase\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.float32\n  magnitude = 1;\n\n  @io.persist\n  @type.float32\n  perlineScale = 1;\n\n  #phase = EveVirtualCameraBehaviourFloatNoise.#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 = EveVirtualCameraBehaviourFloatNoise.#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 authored magnitude scaled by a 1D Perlin sample of the\n   * phase-offset local time (rate set by perlineScale, detail by octaves) and by\n   * the magnitude envelope at normalized timeline time.\n   */\n  @carbon.method\n  @impl.adapted\n  Update(camera, _current, _deltaTime, localElapsedTime)\n  {\n    let offset = this.magnitude * TriPerlinCurve.PerlinNoise1D(\n      (localElapsedTime + this.#phase) * this.perlineScale,\n      2,\n      2,\n      this.octaves\n    );\n    if (this.magnitudeCurve)\n    {\n      const duration = Number(camera?.GetAnimationTimelineLength?.() ?? 0);\n      const time = duration !== 0 ? localElapsedTime / duration : 0;\n      offset *= Number(this.magnitudeCurve.GetValue?.(time) ?? 1);\n    }\n    return offset;\n  }\n\n  /**\n   * Builds the default envelope over normalized time: a near-instant ramp to\n   * 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, keeping simultaneous noise behaviours from moving in lockstep.\n   */\n  static #allocatePhase()\n  {\n    const phase = EveVirtualCameraBehaviourFloatNoise.#nextPhase & 0xfff;\n    EveVirtualCameraBehaviourFloatNoise.#nextPhase++;\n    return phase;\n  }\n}\n"],"names":["_EveVirtualCameraBeha","_identity","EveVirtualCameraBehaviourFloatNoise","EveVirtualCameraBehaviourFloatBase","e","_init_octaves","_init_extra_octaves","_init_magnitudeCurve","_init_extra_magnitudeCurve","_init_magnitude","_init_extra_magnitude","_init_perlineScale","_init_extra_perlineScale","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","persist","int32","objectRef","float32","carbon","method","impl","implemented","adapted","octaves","magnitudeCurve","magnitude","perlineScale","constructor","SetName","name","Update","camera","_current","_deltaTime","localElapsedTime","offset","TriPerlinCurve","PerlinNoise1D","duration","Number","GetAnimationTimelineLength","time","GetValue","#createMagnitudeCurve","curve","Tr2CurveScalar","SetExtrapolation","Tr2CurveExtrapolation","LINEAR","AddKey","#allocatePhase","phase"],"mappings":"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"}

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

@@ -1,8 +1,13 @@
 import { applyDecs2311 as _applyDecs2311 } from '../../../_virtual/_rollupPluginBabelHelpers.js';
-import { io, type, carbon, impl } from '@carbonenginejs/core-types/schema';
+import { io, type, carbon, impl } from '@carbonenginejs/runtime-utils/schema';
 import { EveVirtualCameraBehaviourFloatBase as _EveVirtualCameraBeha$1 } from './EveVirtualCameraBehaviourFloatBase.js';
 
 let _initProto, _initClass, _init_value, _init_extra_value;
+
+/**
+ * Float behaviour that overrides whatever the earlier behaviours accumulated
+ * with an authored constant.
+ */
 let _EveVirtualCameraBeha;
 class EveVirtualCameraBehaviourFloatSet extends _EveVirtualCameraBeha$1 {
   static {
@@ -15,10 +20,20 @@ class EveVirtualCameraBehaviourFloatSet extends _EveVirtualCameraBeha$1 {
     })], [[[io, io.persist, type, type.float32], 16, "value"], [[carbon, carbon.method, impl, impl.implemented], 18, "Update"]], 0, void 0, _EveVirtualCameraBeha$1));
   }
   value = (_initProto(this), _init_value(this, 0));
+
+  /**
+   * Stamps the authored behaviour name that identifies this entry in a camera
+   * behaviour list.
+   */
   constructor() {
     super(), _init_extra_value(this);
     this.name = "Set";
   }
+
+  /**
+   * Returns the delta that replaces the incoming value with the authored one,
+   * since the camera accumulates behaviour results additively.
+   */
   Update(_camera, current) {
     return this.value - current;
   }

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

@@ -1 +1 @@
-{"version":3,"file":"EveVirtualCameraBehaviourFloatSet.js","sources":["../../../../../src/eve/virtualCamera/behaviour/EveVirtualCameraBehaviourFloatSet.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\Eve\\VirtualCamera\\EveVirtualCameraBehaviour.h\n// Source: E:\\carbonengine\\trinity\\trinity\\Eve\\VirtualCamera\\EveVirtualCameraBehaviour.cpp\nimport { carbon, impl, io, type } from \"@carbonenginejs/core-types/schema\";\nimport { EveVirtualCameraBehaviourFloatBase } from \"./EveVirtualCameraBehaviourFloatBase.js\";\n\n\n@type.define({\n  className: \"EveVirtualCameraBehaviourFloatSet\",\n  family: \"eve/virtualCamera/behaviour\"\n})\nexport class EveVirtualCameraBehaviourFloatSet extends EveVirtualCameraBehaviourFloatBase\n{\n  @io.persist\n  @type.float32\n  value = 0;\n\n  constructor()\n  {\n    super();\n    this.name = \"Set\";\n  }\n\n  @carbon.method\n  @impl.implemented\n  Update(_camera, current)\n  {\n    return this.value - current;\n  }\n}\n"],"names":["_EveVirtualCameraBeha","EveVirtualCameraBehaviourFloatSet","EveVirtualCameraBehaviourFloatBase","e","_init_value","_init_extra_value","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","persist","float32","carbon","method","impl","implemented","value","constructor","name","Update","_camera","current"],"mappings":";;;;;AAG6F,IAAAA;AAG7F,MAAAC,iCAAA,SAIuDC,uBAAkC,CACzF;AAAA,EAAA;AAAA,IAAA,CAAA;AAAAC,MAAAA,CAAA,EAAA,CAAAC,WAAA,EAAAC,iBAAA,EAAAC,UAAA,CAAA;MAAAC,CAAA,EAAA,CAAAP,qBAAA,EAAAQ,UAAA;AAAA,KAAA,GAAAC,cAAA,CAAA,IAAA,EAAA,CALCC,IAAI,CAACC,MAAM,CAAC;AACXC,MAAAA,SAAS,EAAE,mCAAmC;AAC9CC,MAAAA,MAAM,EAAE;KACT,CAAC,CAAA,EAAA,CAAA,CAAA,CAGCC,EAAE,EAAFA,EAAE,CAACC,OAAO,EACVL,IAAI,EAAJA,IAAI,CAACM,OAAO,mBASZC,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACC,WAAW,CAAA,EAAA,EAAA,EAAA,QAAA,CAAA,CAAA,EAAA,CAAA,EAAA,MAAA,EAboClB,uBAAkC,CAAA;AAAA;AAIvFmB,EAAAA,KAAK,IAAAf,UAAA,CAAA,IAAA,CAAA,EAAAF,WAAA,OAAG,CAAC,CAAA;AAETkB,EAAAA,WAAWA,GACX;IACE,KAAK,EAAE,EAAAjB,iBAAA,CAAA,IAAA,CAAA;IACP,IAAI,CAACkB,IAAI,GAAG,KAAK;AACnB,EAAA;AAIAC,EAAAA,MAAMA,CAACC,OAAO,EAAEC,OAAO,EACvB;AACE,IAAA,OAAO,IAAI,CAACL,KAAK,GAAGK,OAAO;AAC7B,EAAA;AAAC,EAAA;IAAAlB,UAAA,EAAA;AAAA;AACH;;;;"}
+{"version":3,"file":"EveVirtualCameraBehaviourFloatSet.js","sources":["../../../../../src/eve/virtualCamera/behaviour/EveVirtualCameraBehaviourFloatSet.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\Eve\\VirtualCamera\\EveVirtualCameraBehaviour.h\n// Source: E:\\carbonengine\\trinity\\trinity\\Eve\\VirtualCamera\\EveVirtualCameraBehaviour.cpp\nimport { carbon, impl, io, type } from \"@carbonenginejs/runtime-utils/schema\";\nimport { EveVirtualCameraBehaviourFloatBase } from \"./EveVirtualCameraBehaviourFloatBase.js\";\n\n\n/**\n * Float behaviour that overrides whatever the earlier behaviours accumulated\n * with an authored constant.\n */\n@type.define({\n  className: \"EveVirtualCameraBehaviourFloatSet\",\n  family: \"eve/virtualCamera/behaviour\"\n})\nexport class EveVirtualCameraBehaviourFloatSet extends EveVirtualCameraBehaviourFloatBase\n{\n  @io.persist\n  @type.float32\n  value = 0;\n\n  /**\n   * Stamps the authored behaviour name that identifies this entry in a camera\n   * behaviour list.\n   */\n  constructor()\n  {\n    super();\n    this.name = \"Set\";\n  }\n\n  /**\n   * Returns the delta that replaces the incoming value with the authored one,\n   * since the camera accumulates behaviour results additively.\n   */\n  @carbon.method\n  @impl.implemented\n  Update(_camera, current)\n  {\n    return this.value - current;\n  }\n}\n"],"names":["_EveVirtualCameraBeha","EveVirtualCameraBehaviourFloatSet","EveVirtualCameraBehaviourFloatBase","e","_init_value","_init_extra_value","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","persist","float32","carbon","method","impl","implemented","value","constructor","name","Update","_camera","current"],"mappings":";;;;;;AAMA;AACA;AACA;AACA;AAHA,IAAAA;AAIA,MAAAC,iCAAA,SAIuDC,uBAAkC,CACzF;AAAA,EAAA;AAAA,IAAA,CAAA;AAAAC,MAAAA,CAAA,EAAA,CAAAC,WAAA,EAAAC,iBAAA,EAAAC,UAAA,CAAA;MAAAC,CAAA,EAAA,CAAAP,qBAAA,EAAAQ,UAAA;AAAA,KAAA,GAAAC,cAAA,CAAA,IAAA,EAAA,CALCC,IAAI,CAACC,MAAM,CAAC;AACXC,MAAAA,SAAS,EAAE,mCAAmC;AAC9CC,MAAAA,MAAM,EAAE;KACT,CAAC,CAAA,EAAA,CAAA,CAAA,CAGCC,EAAE,EAAFA,EAAE,CAACC,OAAO,EACVL,IAAI,EAAJA,IAAI,CAACM,OAAO,mBAiBZC,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACC,WAAW,CAAA,EAAA,EAAA,EAAA,QAAA,CAAA,CAAA,EAAA,CAAA,EAAA,MAAA,EArBoClB,uBAAkC,CAAA;AAAA;AAIvFmB,EAAAA,KAAK,IAAAf,UAAA,CAAA,IAAA,CAAA,EAAAF,WAAA,OAAG,CAAC,CAAA;;AAET;AACF;AACA;AACA;AACEkB,EAAAA,WAAWA,GACX;IACE,KAAK,EAAE,EAAAjB,iBAAA,CAAA,IAAA,CAAA;IACP,IAAI,CAACkB,IAAI,GAAG,KAAK;AACnB,EAAA;;AAEA;AACF;AACA;AACA;AAGEC,EAAAA,MAAMA,CAACC,OAAO,EAAEC,OAAO,EACvB;AACE,IAAA,OAAO,IAAI,CAACL,KAAK,GAAGK,OAAO;AAC7B,EAAA;AAAC,EAAA;IAAAlB,UAAA,EAAA;AAAA;AACH;;;;"}

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

@@ -1,12 +1,17 @@
 import { 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';
 import { Tr2CurveScalar as _Tr2CurveScalar } from '../../../curves/Tr2CurveScalar.js';
 import { Tr2CurveExtrapolation } from '../../../curves/enums.js';
 
 let _initProto, _initClass, _init_active, _init_extra_active, _init_name, _init_extra_name;
+
+/**
+ * Base for the virtual camera behaviours that contribute a world-space vector3
+ * offset to a camera's position or point of interest each update.
+ */
 let _EveVirtualCameraBeha;
 class EveVirtualCameraBehaviourVector3Base extends CjsModel {
   static {
@@ -24,19 +29,39 @@ class EveVirtualCameraBehaviourVector3Base extends CjsModel {
   }
   active = (_initProto(this), _init_active(this, true));
   name = (_init_extra_active(this), _init_name(this, ""));
+
+  /** Returns the authored behaviour name shown in tooling. */
   GetName() {
     return this.name;
   }
+
+  /**
+   * Sets the behaviour name, coercing to a string; subclasses override this to
+   * rename the curves they own alongside it.
+   */
   SetName(name) {
     this.name = String(name);
   }
+
+  /**
+   * Re-applies the current name after a field change, which propagates it to any
+   * owned curves through the subclass SetName override.
+   */
   OnModified(_options = {}) {
     this.SetName(this.name);
     return true;
   }
+
+  /** Reports whether the camera should evaluate this behaviour this update. */
   IsActive() {
     return this.active;
   }
+
+  /**
+   * Builds the default scalar curve that holds a single value across normalized
+   * time 0 to 1, used where a subclass wants an unshaped multiplier the author
+   * can later edit.
+   */
   static createConstantCurve(value = 1) {
     const curve = new _Tr2CurveScalar();
     curve.SetExtrapolation(Tr2CurveExtrapolation.LINEAR);
@@ -44,6 +69,12 @@ class EveVirtualCameraBehaviourVector3Base extends CjsModel {
     curve.AddKey(1, value);
     return curve;
   }
+
+  /**
+   * Builds the default scalar curve ramping linearly from 0 to 1 across
+   * normalized time, used as the starting interpolation shape for behaviours
+   * that sweep between two values.
+   */
   static createEaseCurve() {
     const curve = new _Tr2CurveScalar();
     curve.SetExtrapolation(Tr2CurveExtrapolation.LINEAR);
@@ -51,6 +82,13 @@ class EveVirtualCameraBehaviourVector3Base extends CjsModel {
     curve.AddKey(1, 1);
     return curve;
   }
+
+  /**
+   * Rotates a vector about world up by the yaw of the anchor's forward
+   * direction, turning an anchor-relative offset into a world-space one that
+   * follows the anchored object's heading; the vector is returned unchanged when
+   * the forward direction has no horizontal component.
+   */
   static rotateVectorWithAnchor(out, value, anchorForwardDirection) {
     const horizontal = vec3.fromValues(anchorForwardDirection[0], 0, anchorForwardDirection[2]);
     if (vec3.squaredLength(horizontal) === 0) {