@carbonenginejs/runtime-trinity 0.6.0 → 0.8.0

package/dist/controllers/Tr2ActionAnimateCurveSet.js

@@ -5,6 +5,11 @@ import { CjsControllerExpressionProgram } from './CjsControllerExpressionProgram
 import { ITr2ControllerAction } from './ITr2ControllerAction.js';
 
 let _initProto, _initClass, _init_curveSet, _init_extra_curveSet, _init_value, _init_extra_value;
+
+/**
+ * Controller action that registers for per-frame updates and drives a curve
+ * set's playhead from an expression, by default the elapsed state time.
+ */
 let _Tr2ActionAnimateCurv;
 class Tr2ActionAnimateCurveSet extends CjsModel {
   static {
@@ -124,6 +129,11 @@ class Tr2ActionAnimateCurveSet extends CjsModel {
       action: this
     }))) || 0;
   }
+
+  /**
+   * Compiles the authored time expression, reusing the cached program while the
+   * expression text is unchanged.
+   */
   CompileExpression() {
     return CjsControllerExpressionProgram.compileCached(this.#runtime, this.value, 0);
   }

package/dist/controllers/Tr2ActionAnimateCurveSet.js.map

@@ -1 +1 @@
-{"version":3,"file":"Tr2ActionAnimateCurveSet.js","sources":["../../../src/controllers/Tr2ActionAnimateCurveSet.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\Controllers\\Actions\\Tr2ActionAnimateCurveSet.h\r\n// Source: E:\\carbonengine\\trinity\\trinity\\Controllers\\Actions\\Tr2ActionAnimateCurveSet.cpp\r\nimport { CjsModel } from \"@carbonenginejs/runtime-utils/model\";\r\nimport { carbon, impl, io, type } from \"@carbonenginejs/runtime-utils/schema\";\r\nimport { CjsControllerExpressionProgram } from \"./CjsControllerExpressionProgram.js\";\r\nimport { ITr2ControllerAction } from \"./ITr2ControllerAction.js\";\r\n\r\n\r\n@type.define({\r\n  className: \"Tr2ActionAnimateCurveSet\",\r\n  family: \"controllers\"\r\n})\r\nexport class Tr2ActionAnimateCurveSet extends CjsModel\r\n{\r\n  @io.persist\r\n  @type.objectRef(\"TriCurveSet\")\r\n  curveSet = null;\r\n\r\n  @io.notify\r\n  @io.persist\r\n  @type.string\r\n  value = \"StateTime()\";\r\n\r\n  #runtime = CjsControllerExpressionProgram.createRuntimeState();\r\n\r\n  /**\r\n   * Links this action to a controller.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  Link(controller)\r\n  {\r\n    this.#runtime.controller = controller;\r\n    this.CompileExpression();\r\n  }\r\n\r\n  /**\r\n   * Clears runtime expression state.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  Unlink()\r\n  {\r\n    this.#runtime = CjsControllerExpressionProgram.createRuntimeState();\r\n  }\r\n\r\n  /**\r\n   * Starts timeline updates for this action.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  Start(controller = this.#runtime.controller)\r\n  {\r\n    if (!controller || !this.curveSet)\r\n    {\r\n      return;\r\n    }\r\n    this.#runtime.controller = controller;\r\n    this.#runtime.startTime = ITr2ControllerAction.getTime(controller);\r\n    this.#runtime.lastTime = this.#runtime.startTime;\r\n    controller.RegisterUpdateable?.(this);\r\n  }\r\n\r\n  /**\r\n   * Stops timeline updates for this action.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  Stop(controller = this.#runtime.controller)\r\n  {\r\n    controller?.UnRegisterUpdateable?.(this);\r\n  }\r\n\r\n  /**\r\n   * Rebases stored simulation time.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  RebaseSimTime(diff)\r\n  {\r\n    this.#runtime.startTime += diff;\r\n    this.#runtime.lastTime += diff;\r\n  }\r\n\r\n  /**\r\n   * Applies the evaluated time to the curve set.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  Update(_realTime, simTime)\r\n  {\r\n    const controller = this.#runtime.controller;\r\n    if (!controller || !this.curveSet)\r\n    {\r\n      return;\r\n    }\r\n    this.#runtime.lastTime = simTime;\r\n    const program = this.CompileExpression();\r\n    if (!program.IsValid())\r\n    {\r\n      return;\r\n    }\r\n    const value = Number(program.Evaluate(CjsControllerExpressionProgram.makeActionContext(controller, ITr2ControllerAction.getOwner(controller), this.#runtime, {\r\n      action: this\r\n    }))) || 0;\r\n    this.curveSet.ApplyTime?.(value);\r\n  }\r\n\r\n  /**\r\n   * Recompiles when the expression changes.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  OnModified(_options = {})\r\n  {\r\n    this.#runtime.program = null;\r\n    return true;\r\n  }\r\n\r\n  /**\r\n   * Checks whether the value expression compiles.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  IsExpressionValid()\r\n  {\r\n    return this.CompileExpression().IsValid();\r\n  }\r\n\r\n  /**\r\n   * Gets expression term metadata.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  GetExpressionTermInfo()\r\n  {\r\n    const result = [];\r\n    CjsControllerExpressionProgram.addControllerTermInfo(result);\r\n    this.#runtime.controller?.GetExpressionTermInfo?.(result);\r\n    return result;\r\n  }\r\n\r\n  /**\r\n   * Evaluates an arbitrary expression.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  EvaluateExpression(expression)\r\n  {\r\n    const state = {\r\n      program: null,\r\n      source: \"\"\r\n    };\r\n    const program = CjsControllerExpressionProgram.compileCached(state, expression, 0);\r\n    if (!program.IsValid())\r\n    {\r\n      return 0;\r\n    }\r\n    const controller = this.#runtime.controller;\r\n    return Number(program.Evaluate(CjsControllerExpressionProgram.makeActionContext(controller, ITr2ControllerAction.getOwner(controller), this.#runtime, {\r\n      action: this\r\n    }))) || 0;\r\n  }\r\n  CompileExpression()\r\n  {\r\n    return CjsControllerExpressionProgram.compileCached(this.#runtime, this.value, 0);\r\n  }\r\n}\r\n"],"names":["_Tr2ActionAnimateCurv","Tr2ActionAnimateCurveSet","CjsModel","e","_init_curveSet","_init_extra_curveSet","_init_value","_init_extra_value","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","persist","objectRef","notify","string","carbon","method","impl","adapted","implemented","curveSet","value","CjsControllerExpressionProgram","createRuntimeState","Link","controller","CompileExpression","Unlink","Start","startTime","ITr2ControllerAction","getTime","lastTime","RegisterUpdateable","Stop","UnRegisterUpdateable","RebaseSimTime","diff","Update","_realTime","simTime","program","IsValid","Number","Evaluate","makeActionContext","getOwner","action","ApplyTime","OnModified","_options","IsExpressionValid","GetExpressionTermInfo","result","addControllerTermInfo","EvaluateExpression","expression","state","source","compileCached"],"mappings":"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"}
+{"version":3,"file":"Tr2ActionAnimateCurveSet.js","sources":["../../../src/controllers/Tr2ActionAnimateCurveSet.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\Controllers\\Actions\\Tr2ActionAnimateCurveSet.h\r\n// Source: E:\\carbonengine\\trinity\\trinity\\Controllers\\Actions\\Tr2ActionAnimateCurveSet.cpp\r\nimport { CjsModel } from \"@carbonenginejs/runtime-utils/model\";\r\nimport { carbon, impl, io, type } from \"@carbonenginejs/runtime-utils/schema\";\r\nimport { CjsControllerExpressionProgram } from \"./CjsControllerExpressionProgram.js\";\r\nimport { ITr2ControllerAction } from \"./ITr2ControllerAction.js\";\r\n\r\n\r\n/**\r\n * Controller action that registers for per-frame updates and drives a curve\r\n * set's playhead from an expression, by default the elapsed state time.\r\n */\r\n@type.define({\r\n  className: \"Tr2ActionAnimateCurveSet\",\r\n  family: \"controllers\"\r\n})\r\nexport class Tr2ActionAnimateCurveSet extends CjsModel\r\n{\r\n  @io.persist\r\n  @type.objectRef(\"TriCurveSet\")\r\n  curveSet = null;\r\n\r\n  @io.notify\r\n  @io.persist\r\n  @type.string\r\n  value = \"StateTime()\";\r\n\r\n  #runtime = CjsControllerExpressionProgram.createRuntimeState();\r\n\r\n  /**\r\n   * Links this action to a controller.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  Link(controller)\r\n  {\r\n    this.#runtime.controller = controller;\r\n    this.CompileExpression();\r\n  }\r\n\r\n  /**\r\n   * Clears runtime expression state.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  Unlink()\r\n  {\r\n    this.#runtime = CjsControllerExpressionProgram.createRuntimeState();\r\n  }\r\n\r\n  /**\r\n   * Starts timeline updates for this action.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  Start(controller = this.#runtime.controller)\r\n  {\r\n    if (!controller || !this.curveSet)\r\n    {\r\n      return;\r\n    }\r\n    this.#runtime.controller = controller;\r\n    this.#runtime.startTime = ITr2ControllerAction.getTime(controller);\r\n    this.#runtime.lastTime = this.#runtime.startTime;\r\n    controller.RegisterUpdateable?.(this);\r\n  }\r\n\r\n  /**\r\n   * Stops timeline updates for this action.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  Stop(controller = this.#runtime.controller)\r\n  {\r\n    controller?.UnRegisterUpdateable?.(this);\r\n  }\r\n\r\n  /**\r\n   * Rebases stored simulation time.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  RebaseSimTime(diff)\r\n  {\r\n    this.#runtime.startTime += diff;\r\n    this.#runtime.lastTime += diff;\r\n  }\r\n\r\n  /**\r\n   * Applies the evaluated time to the curve set.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  Update(_realTime, simTime)\r\n  {\r\n    const controller = this.#runtime.controller;\r\n    if (!controller || !this.curveSet)\r\n    {\r\n      return;\r\n    }\r\n    this.#runtime.lastTime = simTime;\r\n    const program = this.CompileExpression();\r\n    if (!program.IsValid())\r\n    {\r\n      return;\r\n    }\r\n    const value = Number(program.Evaluate(CjsControllerExpressionProgram.makeActionContext(controller, ITr2ControllerAction.getOwner(controller), this.#runtime, {\r\n      action: this\r\n    }))) || 0;\r\n    this.curveSet.ApplyTime?.(value);\r\n  }\r\n\r\n  /**\r\n   * Recompiles when the expression changes.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  OnModified(_options = {})\r\n  {\r\n    this.#runtime.program = null;\r\n    return true;\r\n  }\r\n\r\n  /**\r\n   * Checks whether the value expression compiles.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  IsExpressionValid()\r\n  {\r\n    return this.CompileExpression().IsValid();\r\n  }\r\n\r\n  /**\r\n   * Gets expression term metadata.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  GetExpressionTermInfo()\r\n  {\r\n    const result = [];\r\n    CjsControllerExpressionProgram.addControllerTermInfo(result);\r\n    this.#runtime.controller?.GetExpressionTermInfo?.(result);\r\n    return result;\r\n  }\r\n\r\n  /**\r\n   * Evaluates an arbitrary expression.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  EvaluateExpression(expression)\r\n  {\r\n    const state = {\r\n      program: null,\r\n      source: \"\"\r\n    };\r\n    const program = CjsControllerExpressionProgram.compileCached(state, expression, 0);\r\n    if (!program.IsValid())\r\n    {\r\n      return 0;\r\n    }\r\n    const controller = this.#runtime.controller;\r\n    return Number(program.Evaluate(CjsControllerExpressionProgram.makeActionContext(controller, ITr2ControllerAction.getOwner(controller), this.#runtime, {\r\n      action: this\r\n    }))) || 0;\r\n  }\r\n\r\n  /**\r\n   * Compiles the authored time expression, reusing the cached program while the\r\n   * expression text is unchanged.\r\n   */\r\n  CompileExpression()\r\n  {\r\n    return CjsControllerExpressionProgram.compileCached(this.#runtime, this.value, 0);\r\n  }\r\n}\r\n"],"names":["_Tr2ActionAnimateCurv","Tr2ActionAnimateCurveSet","CjsModel","e","_init_curveSet","_init_extra_curveSet","_init_value","_init_extra_value","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","persist","objectRef","notify","string","carbon","method","impl","adapted","implemented","curveSet","value","CjsControllerExpressionProgram","createRuntimeState","Link","controller","CompileExpression","Unlink","Start","startTime","ITr2ControllerAction","getTime","lastTime","RegisterUpdateable","Stop","UnRegisterUpdateable","RebaseSimTime","diff","Update","_realTime","simTime","program","IsValid","Number","Evaluate","makeActionContext","getOwner","action","ApplyTime","OnModified","_options","IsExpressionValid","GetExpressionTermInfo","result","addControllerTermInfo","EvaluateExpression","expression","state","source","compileCached"],"mappings":"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"}

package/dist/controllers/Tr2ActionAnimateValue.js

@@ -6,6 +6,12 @@ import { ITr2ControllerAction } from './ITr2ControllerAction.js';
 import { Tr2BindingPoint as _Tr2BindingPoint } from './Tr2BindingPoint.js';
 
 let _initProto, _initClass, _init_curve, _init_extra_curve, _init_attribute, _init_extra_attribute, _init_destination, _init_extra_destination, _init_delayBinding, _init_extra_delayBinding, _init_path, _init_extra_path, _init_value, _init_extra_value;
+
+/**
+ * Controller action that registers for per-frame updates and continuously writes
+ * an expression-driven value, by default the action's curve sampled at state
+ * time, into a bound destination property.
+ */
 let _Tr2ActionAnimateValu;
 class Tr2ActionAnimateValue extends CjsModel {
   static {
@@ -168,11 +174,21 @@ class Tr2ActionAnimateValue extends CjsModel {
       action: this
     }))) || 0;
   }
+
+  /**
+   * Compiles the authored value expression with the `Curve` function bound to
+   * this action's curve, reusing the cached program while the text is unchanged.
+   */
   CompileExpression() {
     return CjsControllerExpressionProgram.compileCached(this.#runtime, this.value, 0, {
       Curve: (_ctx, time) => this.GetCurveValue(Number(time))
     });
   }
+
+  /**
+   * Gets the lazily created binding point, refreshing it from the currently
+   * authored path, destination object and attribute on every call.
+   */
   GetBindingPoint() {
     if (!this.#bindingPoint) {
       this.#bindingPoint = new _Tr2BindingPoint();
@@ -182,9 +198,19 @@ class Tr2ActionAnimateValue extends CjsModel {
     this.#bindingPoint.attribute = this.attribute;
     return this.#bindingPoint;
   }
+
+  /**
+   * Resolves the binding point against the controller's binding roots and its
+   * owner.
+   */
   LinkDestination(controller = this.#runtime.controller, owner = ITr2ControllerAction.getOwner(controller)) {
     return this.GetBindingPoint().Link(controller, owner);
   }
+
+  /**
+   * Checks whether binding is deferred to Start, which requires both the
+   * delayBinding flag and an authored path.
+   */
   HasDelayedBinding() {
     return this.delayBinding && !!this.path;
   }

package/dist/controllers/Tr2ActionAnimateValue.js.map

@@ -1 +1 @@
-{"version":3,"file":"Tr2ActionAnimateValue.js","sources":["../../../src/controllers/Tr2ActionAnimateValue.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\Controllers\\Actions\\Tr2ActionAnimateValue.h\r\n// Source: E:\\carbonengine\\trinity\\trinity\\Controllers\\Actions\\Tr2ActionAnimateValue.cpp\r\nimport { CjsModel } from \"@carbonenginejs/runtime-utils/model\";\r\nimport { carbon, impl, io, type } from \"@carbonenginejs/runtime-utils/schema\";\r\nimport { CjsControllerExpressionProgram } from \"./CjsControllerExpressionProgram.js\";\r\nimport { ITr2ControllerAction } from \"./ITr2ControllerAction.js\";\r\nimport { Tr2BindingPoint } from \"./Tr2BindingPoint.js\";\r\n\r\n\r\n@type.define({\r\n  className: \"Tr2ActionAnimateValue\",\r\n  family: \"controllers\"\r\n})\r\nexport class Tr2ActionAnimateValue extends CjsModel\r\n{\r\n  @io.persist\r\n  @type.objectRef(\"ITriScalarFunction\")\r\n  curve = null;\r\n\r\n  @io.notify\r\n  @io.persist\r\n  @type.string\r\n  attribute = \"\";\r\n\r\n  @io.notify\r\n  @io.persist\r\n  @type.objectRef(\"IRoot\")\r\n  destination = null;\r\n\r\n  @io.notify\r\n  @io.persist\r\n  @type.boolean\r\n  delayBinding = false;\r\n\r\n  @io.notify\r\n  @io.persist\r\n  @type.string\r\n  path = \"\";\r\n\r\n  @io.notify\r\n  @io.persist\r\n  @type.string\r\n  value = \"Curve(StateTime())\";\r\n\r\n  #bindingPoint = null;\r\n\r\n  #runtime = CjsControllerExpressionProgram.createRuntimeState();\r\n\r\n  /**\r\n   * Links the destination and compiles the value expression.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  Link(controller)\r\n  {\r\n    this.#runtime.controller = controller;\r\n    if (!this.HasDelayedBinding())\r\n    {\r\n      this.LinkDestination(controller);\r\n    }\r\n    this.CompileExpression();\r\n  }\r\n\r\n  /**\r\n   * Unlinks the destination and update registration.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  Unlink()\r\n  {\r\n    this.#bindingPoint?.Unlink();\r\n    this.#runtime = CjsControllerExpressionProgram.createRuntimeState();\r\n  }\r\n\r\n  /**\r\n   * Starts updating the destination value.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  Start(controller = this.#runtime.controller)\r\n  {\r\n    if (!controller)\r\n    {\r\n      return;\r\n    }\r\n    const owner = ITr2ControllerAction.getOwner(controller);\r\n    this.#runtime.controller = controller;\r\n    if (this.HasDelayedBinding() || !this.IsBindingValid())\r\n    {\r\n      this.LinkDestination(controller, owner);\r\n    }\r\n    if (!this.IsBindingValid())\r\n    {\r\n      return;\r\n    }\r\n    this.#runtime.startTime = ITr2ControllerAction.getTime(controller);\r\n    this.#runtime.lastTime = this.#runtime.startTime;\r\n    controller.RegisterUpdateable?.(this);\r\n  }\r\n\r\n  /**\r\n   * Stops updating the destination value.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  Stop(controller = this.#runtime.controller)\r\n  {\r\n    controller?.UnRegisterUpdateable?.(this);\r\n  }\r\n\r\n  /**\r\n   * Rebases stored simulation time.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  RebaseSimTime(diff)\r\n  {\r\n    this.#runtime.startTime += diff;\r\n    this.#runtime.lastTime += diff;\r\n  }\r\n\r\n  /**\r\n   * Evaluates and writes the animated value.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  Update(_realTime, simTime)\r\n  {\r\n    const controller = this.#runtime.controller;\r\n    if (!controller)\r\n    {\r\n      return;\r\n    }\r\n    this.#runtime.lastTime = simTime;\r\n    const program = this.CompileExpression();\r\n    if (!program.IsValid() || !this.IsBindingValid())\r\n    {\r\n      return;\r\n    }\r\n    this.GetBindingPoint().SetValue(program.Evaluate(CjsControllerExpressionProgram.makeActionContext(controller, ITr2ControllerAction.getOwner(controller), this.#runtime, {\r\n      action: this\r\n    })), controller, ITr2ControllerAction.getOwner(controller));\r\n  }\r\n\r\n  /**\r\n   * Handles authored field changes.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  OnModified(_options = {})\r\n  {\r\n    this.#runtime.program = null;\r\n    if (this.#runtime.controller && !this.HasDelayedBinding())\r\n    {\r\n      this.LinkDestination(this.#runtime.controller);\r\n    }\r\n    return true;\r\n  }\r\n\r\n  /**\r\n   * Checks whether the binding currently resolves.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  IsBindingValid()\r\n  {\r\n    return !!this.#bindingPoint?.IsValid();\r\n  }\r\n\r\n  /**\r\n   * Checks whether the value expression compiles.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  IsExpressionValid()\r\n  {\r\n    return this.CompileExpression().IsValid();\r\n  }\r\n\r\n  /**\r\n   * Gets a curve value for the expression helper.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  GetCurveValue(time)\r\n  {\r\n    return CjsControllerExpressionProgram.getCurveValue(this.curve, time);\r\n  }\r\n\r\n  /**\r\n   * Gets the bound destination object.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  GetDestination(controller = this.#runtime.controller, owner = ITr2ControllerAction.getOwner(controller))\r\n  {\r\n    return this.GetBindingPoint().GetBoundObject(controller, owner);\r\n  }\r\n\r\n  /**\r\n   * Gets expression term metadata.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  GetExpressionTermInfo()\r\n  {\r\n    const result = [];\r\n    CjsControllerExpressionProgram.addControllerTermInfo(result, {\r\n      curve: true\r\n    });\r\n    this.#runtime.controller?.GetExpressionTermInfo?.(result);\r\n    return result;\r\n  }\r\n\r\n  /**\r\n   * Evaluates an arbitrary expression.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  EvaluateExpression(expression)\r\n  {\r\n    const state = {\r\n      program: null,\r\n      source: \"\"\r\n    };\r\n    const program = CjsControllerExpressionProgram.compileCached(state, expression, 0, {\r\n      Curve: (_ctx, time) => this.GetCurveValue(Number(time))\r\n    });\r\n    if (!program.IsValid())\r\n    {\r\n      return 0;\r\n    }\r\n    const controller = this.#runtime.controller;\r\n    return Number(program.Evaluate(CjsControllerExpressionProgram.makeActionContext(controller, ITr2ControllerAction.getOwner(controller), this.#runtime, {\r\n      action: this\r\n    }))) || 0;\r\n  }\r\n  CompileExpression()\r\n  {\r\n    return CjsControllerExpressionProgram.compileCached(this.#runtime, this.value, 0, {\r\n      Curve: (_ctx, time) => this.GetCurveValue(Number(time))\r\n    });\r\n  }\r\n  GetBindingPoint()\r\n  {\r\n    if (!this.#bindingPoint)\r\n    {\r\n      this.#bindingPoint = new Tr2BindingPoint();\r\n    }\r\n    this.#bindingPoint.path = this.path;\r\n    this.#bindingPoint.object = this.destination;\r\n    this.#bindingPoint.attribute = this.attribute;\r\n    return this.#bindingPoint;\r\n  }\r\n  LinkDestination(controller = this.#runtime.controller, owner = ITr2ControllerAction.getOwner(controller))\r\n  {\r\n    return this.GetBindingPoint().Link(controller, owner);\r\n  }\r\n  HasDelayedBinding()\r\n  {\r\n    return this.delayBinding && !!this.path;\r\n  }\r\n}\r\n"],"names":["_Tr2ActionAnimateValu","Tr2ActionAnimateValue","CjsModel","e","_init_curve","_init_extra_curve","_init_attribute","_init_extra_attribute","_init_destination","_init_extra_destination","_init_delayBinding","_init_extra_delayBinding","_init_path","_init_extra_path","_init_value","_init_extra_value","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","persist","objectRef","notify","string","boolean","carbon","method","impl","adapted","implemented","curve","attribute","destination","delayBinding","path","value","CjsControllerExpressionProgram","createRuntimeState","Link","controller","HasDelayedBinding","LinkDestination","CompileExpression","Unlink","Start","owner","ITr2ControllerAction","getOwner","IsBindingValid","startTime","getTime","lastTime","RegisterUpdateable","Stop","UnRegisterUpdateable","RebaseSimTime","diff","Update","_realTime","simTime","program","IsValid","GetBindingPoint","SetValue","Evaluate","makeActionContext","action","OnModified","_options","IsExpressionValid","GetCurveValue","time","getCurveValue","GetDestination","GetBoundObject","GetExpressionTermInfo","result","addControllerTermInfo","EvaluateExpression","expression","state","source","compileCached","Curve","_ctx","Number","Tr2BindingPoint","object"],"mappings":"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"}
+{"version":3,"file":"Tr2ActionAnimateValue.js","sources":["../../../src/controllers/Tr2ActionAnimateValue.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\Controllers\\Actions\\Tr2ActionAnimateValue.h\r\n// Source: E:\\carbonengine\\trinity\\trinity\\Controllers\\Actions\\Tr2ActionAnimateValue.cpp\r\nimport { CjsModel } from \"@carbonenginejs/runtime-utils/model\";\r\nimport { carbon, impl, io, type } from \"@carbonenginejs/runtime-utils/schema\";\r\nimport { CjsControllerExpressionProgram } from \"./CjsControllerExpressionProgram.js\";\r\nimport { ITr2ControllerAction } from \"./ITr2ControllerAction.js\";\r\nimport { Tr2BindingPoint } from \"./Tr2BindingPoint.js\";\r\n\r\n\r\n/**\r\n * Controller action that registers for per-frame updates and continuously writes\r\n * an expression-driven value, by default the action's curve sampled at state\r\n * time, into a bound destination property.\r\n */\r\n@type.define({\r\n  className: \"Tr2ActionAnimateValue\",\r\n  family: \"controllers\"\r\n})\r\nexport class Tr2ActionAnimateValue extends CjsModel\r\n{\r\n  @io.persist\r\n  @type.objectRef(\"ITriScalarFunction\")\r\n  curve = null;\r\n\r\n  @io.notify\r\n  @io.persist\r\n  @type.string\r\n  attribute = \"\";\r\n\r\n  @io.notify\r\n  @io.persist\r\n  @type.objectRef(\"IRoot\")\r\n  destination = null;\r\n\r\n  @io.notify\r\n  @io.persist\r\n  @type.boolean\r\n  delayBinding = false;\r\n\r\n  @io.notify\r\n  @io.persist\r\n  @type.string\r\n  path = \"\";\r\n\r\n  @io.notify\r\n  @io.persist\r\n  @type.string\r\n  value = \"Curve(StateTime())\";\r\n\r\n  #bindingPoint = null;\r\n\r\n  #runtime = CjsControllerExpressionProgram.createRuntimeState();\r\n\r\n  /**\r\n   * Links the destination and compiles the value expression.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  Link(controller)\r\n  {\r\n    this.#runtime.controller = controller;\r\n    if (!this.HasDelayedBinding())\r\n    {\r\n      this.LinkDestination(controller);\r\n    }\r\n    this.CompileExpression();\r\n  }\r\n\r\n  /**\r\n   * Unlinks the destination and update registration.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  Unlink()\r\n  {\r\n    this.#bindingPoint?.Unlink();\r\n    this.#runtime = CjsControllerExpressionProgram.createRuntimeState();\r\n  }\r\n\r\n  /**\r\n   * Starts updating the destination value.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  Start(controller = this.#runtime.controller)\r\n  {\r\n    if (!controller)\r\n    {\r\n      return;\r\n    }\r\n    const owner = ITr2ControllerAction.getOwner(controller);\r\n    this.#runtime.controller = controller;\r\n    if (this.HasDelayedBinding() || !this.IsBindingValid())\r\n    {\r\n      this.LinkDestination(controller, owner);\r\n    }\r\n    if (!this.IsBindingValid())\r\n    {\r\n      return;\r\n    }\r\n    this.#runtime.startTime = ITr2ControllerAction.getTime(controller);\r\n    this.#runtime.lastTime = this.#runtime.startTime;\r\n    controller.RegisterUpdateable?.(this);\r\n  }\r\n\r\n  /**\r\n   * Stops updating the destination value.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  Stop(controller = this.#runtime.controller)\r\n  {\r\n    controller?.UnRegisterUpdateable?.(this);\r\n  }\r\n\r\n  /**\r\n   * Rebases stored simulation time.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  RebaseSimTime(diff)\r\n  {\r\n    this.#runtime.startTime += diff;\r\n    this.#runtime.lastTime += diff;\r\n  }\r\n\r\n  /**\r\n   * Evaluates and writes the animated value.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  Update(_realTime, simTime)\r\n  {\r\n    const controller = this.#runtime.controller;\r\n    if (!controller)\r\n    {\r\n      return;\r\n    }\r\n    this.#runtime.lastTime = simTime;\r\n    const program = this.CompileExpression();\r\n    if (!program.IsValid() || !this.IsBindingValid())\r\n    {\r\n      return;\r\n    }\r\n    this.GetBindingPoint().SetValue(program.Evaluate(CjsControllerExpressionProgram.makeActionContext(controller, ITr2ControllerAction.getOwner(controller), this.#runtime, {\r\n      action: this\r\n    })), controller, ITr2ControllerAction.getOwner(controller));\r\n  }\r\n\r\n  /**\r\n   * Handles authored field changes.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  OnModified(_options = {})\r\n  {\r\n    this.#runtime.program = null;\r\n    if (this.#runtime.controller && !this.HasDelayedBinding())\r\n    {\r\n      this.LinkDestination(this.#runtime.controller);\r\n    }\r\n    return true;\r\n  }\r\n\r\n  /**\r\n   * Checks whether the binding currently resolves.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  IsBindingValid()\r\n  {\r\n    return !!this.#bindingPoint?.IsValid();\r\n  }\r\n\r\n  /**\r\n   * Checks whether the value expression compiles.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  IsExpressionValid()\r\n  {\r\n    return this.CompileExpression().IsValid();\r\n  }\r\n\r\n  /**\r\n   * Gets a curve value for the expression helper.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  GetCurveValue(time)\r\n  {\r\n    return CjsControllerExpressionProgram.getCurveValue(this.curve, time);\r\n  }\r\n\r\n  /**\r\n   * Gets the bound destination object.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  GetDestination(controller = this.#runtime.controller, owner = ITr2ControllerAction.getOwner(controller))\r\n  {\r\n    return this.GetBindingPoint().GetBoundObject(controller, owner);\r\n  }\r\n\r\n  /**\r\n   * Gets expression term metadata.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  GetExpressionTermInfo()\r\n  {\r\n    const result = [];\r\n    CjsControllerExpressionProgram.addControllerTermInfo(result, {\r\n      curve: true\r\n    });\r\n    this.#runtime.controller?.GetExpressionTermInfo?.(result);\r\n    return result;\r\n  }\r\n\r\n  /**\r\n   * Evaluates an arbitrary expression.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  EvaluateExpression(expression)\r\n  {\r\n    const state = {\r\n      program: null,\r\n      source: \"\"\r\n    };\r\n    const program = CjsControllerExpressionProgram.compileCached(state, expression, 0, {\r\n      Curve: (_ctx, time) => this.GetCurveValue(Number(time))\r\n    });\r\n    if (!program.IsValid())\r\n    {\r\n      return 0;\r\n    }\r\n    const controller = this.#runtime.controller;\r\n    return Number(program.Evaluate(CjsControllerExpressionProgram.makeActionContext(controller, ITr2ControllerAction.getOwner(controller), this.#runtime, {\r\n      action: this\r\n    }))) || 0;\r\n  }\r\n\r\n  /**\r\n   * Compiles the authored value expression with the `Curve` function bound to\r\n   * this action's curve, reusing the cached program while the text is unchanged.\r\n   */\r\n  CompileExpression()\r\n  {\r\n    return CjsControllerExpressionProgram.compileCached(this.#runtime, this.value, 0, {\r\n      Curve: (_ctx, time) => this.GetCurveValue(Number(time))\r\n    });\r\n  }\r\n\r\n  /**\r\n   * Gets the lazily created binding point, refreshing it from the currently\r\n   * authored path, destination object and attribute on every call.\r\n   */\r\n  GetBindingPoint()\r\n  {\r\n    if (!this.#bindingPoint)\r\n    {\r\n      this.#bindingPoint = new Tr2BindingPoint();\r\n    }\r\n    this.#bindingPoint.path = this.path;\r\n    this.#bindingPoint.object = this.destination;\r\n    this.#bindingPoint.attribute = this.attribute;\r\n    return this.#bindingPoint;\r\n  }\r\n\r\n  /**\r\n   * Resolves the binding point against the controller's binding roots and its\r\n   * owner.\r\n   */\r\n  LinkDestination(controller = this.#runtime.controller, owner = ITr2ControllerAction.getOwner(controller))\r\n  {\r\n    return this.GetBindingPoint().Link(controller, owner);\r\n  }\r\n\r\n  /**\r\n   * Checks whether binding is deferred to Start, which requires both the\r\n   * delayBinding flag and an authored path.\r\n   */\r\n  HasDelayedBinding()\r\n  {\r\n    return this.delayBinding && !!this.path;\r\n  }\r\n}\r\n"],"names":["_Tr2ActionAnimateValu","Tr2ActionAnimateValue","CjsModel","e","_init_curve","_init_extra_curve","_init_attribute","_init_extra_attribute","_init_destination","_init_extra_destination","_init_delayBinding","_init_extra_delayBinding","_init_path","_init_extra_path","_init_value","_init_extra_value","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","persist","objectRef","notify","string","boolean","carbon","method","impl","adapted","implemented","curve","attribute","destination","delayBinding","path","value","CjsControllerExpressionProgram","createRuntimeState","Link","controller","HasDelayedBinding","LinkDestination","CompileExpression","Unlink","Start","owner","ITr2ControllerAction","getOwner","IsBindingValid","startTime","getTime","lastTime","RegisterUpdateable","Stop","UnRegisterUpdateable","RebaseSimTime","diff","Update","_realTime","simTime","program","IsValid","GetBindingPoint","SetValue","Evaluate","makeActionContext","action","OnModified","_options","IsExpressionValid","GetCurveValue","time","getCurveValue","GetDestination","GetBoundObject","GetExpressionTermInfo","result","addControllerTermInfo","EvaluateExpression","expression","state","source","compileCached","Curve","_ctx","Number","Tr2BindingPoint","object"],"mappings":"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"}

package/dist/controllers/Tr2ActionBindRTPC.js

@@ -5,6 +5,12 @@ import { CjsControllerExpressionProgram } from './CjsControllerExpressionProgram
 import { ITr2ControllerAction } from './ITr2ControllerAction.js';
 
 let _initProto, _initClass, _init_value, _init_extra_value, _init_emitter, _init_extra_emitter, _init_rtpcName, _init_extra_rtpcName, _init_curve, _init_extra_curve;
+
+/**
+ * Controller action that registers for per-frame updates and pushes an
+ * expression-driven value into a named Wwise real-time parameter on a sound
+ * emitter.
+ */
 let _Tr2ActionBindRTPC;
 class Tr2ActionBindRTPC extends CjsModel {
   static {
@@ -147,6 +153,11 @@ class Tr2ActionBindRTPC extends CjsModel {
       action: this
     }))) || 0;
   }
+
+  /**
+   * Compiles the authored value expression with the `Curve` function bound to
+   * this action's curve, reusing the cached program while the text is unchanged.
+   */
   CompileExpression() {
     return CjsControllerExpressionProgram.compileCached(this.#runtime, this.value, 0, {
       Curve: (_ctx, time) => this.GetCurveValue(Number(time))

package/dist/controllers/Tr2ActionBindRTPC.js.map

@@ -1 +1 @@
-{"version":3,"file":"Tr2ActionBindRTPC.js","sources":["../../../src/controllers/Tr2ActionBindRTPC.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\Controllers\\Actions\\Tr2ActionBindRTPC.h\r\n// Source: E:\\carbonengine\\trinity\\trinity\\Controllers\\Actions\\Tr2ActionBindRTPC.cpp\r\nimport { CjsModel } from \"@carbonenginejs/runtime-utils/model\";\r\nimport { carbon, impl, io, type } from \"@carbonenginejs/runtime-utils/schema\";\r\nimport { CjsControllerExpressionProgram } from \"./CjsControllerExpressionProgram.js\";\r\nimport { ITr2ControllerAction } from \"./ITr2ControllerAction.js\";\r\n\r\n\r\n@type.define({\r\n  className: \"Tr2ActionBindRTPC\",\r\n  family: \"controllers\"\r\n})\r\nexport class Tr2ActionBindRTPC extends CjsModel\r\n{\r\n  @io.notify\r\n  @io.persist\r\n  @type.string\r\n  value = \"\";\r\n\r\n  @io.persist\r\n  @type.string\r\n  emitter = \"\";\r\n\r\n  @io.persist\r\n  @type.string\r\n  rtpcName = \"\";\r\n\r\n  @io.persist\r\n  @type.objectRef(\"ITriScalarFunction\")\r\n  curve = null;\r\n\r\n  #runtime = CjsControllerExpressionProgram.createRuntimeState();\r\n\r\n  #emitter = null;\r\n\r\n  /**\r\n   * Links and compiles the RTPC value expression.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  Link(controller)\r\n  {\r\n    this.#runtime.controller = controller;\r\n    this.CompileExpression();\r\n  }\r\n\r\n  /**\r\n   * Clears runtime expression state.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  Unlink()\r\n  {\r\n    this.#runtime = CjsControllerExpressionProgram.createRuntimeState();\r\n  }\r\n\r\n  /**\r\n   * Starts RTPC updates.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  Start(controller = this.#runtime.controller)\r\n  {\r\n    if (!controller)\r\n    {\r\n      return;\r\n    }\r\n    this.#runtime.controller = controller;\r\n    this.#runtime.startTime = ITr2ControllerAction.getTime(controller);\r\n    this.#runtime.lastTime = this.#runtime.startTime;\r\n    this.#emitter = ITr2ControllerAction.findSoundEmitter(ITr2ControllerAction.getOwner(controller), this.emitter);\r\n    controller.RegisterUpdateable?.(this);\r\n  }\r\n\r\n  /**\r\n   * Starts manually with an explicit controller.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  StartWithController(controller)\r\n  {\r\n    this.Start(ITr2ControllerAction.requireController(controller, \"StartWithController\"));\r\n  }\r\n\r\n  /**\r\n   * Stops RTPC updates.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  Stop(controller = this.#runtime.controller)\r\n  {\r\n    controller?.UnRegisterUpdateable?.(this);\r\n  }\r\n\r\n  /**\r\n   * Stops manually with an explicit controller.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  StopWithController(controller)\r\n  {\r\n    this.Stop(ITr2ControllerAction.requireController(controller, \"StopWithController\"));\r\n  }\r\n\r\n  /**\r\n   * Updates the target RTPC value.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  Update(_realTime, simTime)\r\n  {\r\n    const controller = this.#runtime.controller;\r\n    if (!controller)\r\n    {\r\n      return;\r\n    }\r\n    this.#runtime.lastTime = simTime;\r\n    const program = this.CompileExpression();\r\n    if (!program.IsValid())\r\n    {\r\n      return;\r\n    }\r\n    const value = Number(program.Evaluate(CjsControllerExpressionProgram.makeActionContext(controller, ITr2ControllerAction.getOwner(controller), this.#runtime, {\r\n      action: this\r\n    }))) || 0;\r\n    if (ITr2ControllerAction.hasFunction(this.#emitter, \"SetRTPC\"))\r\n    {\r\n      this.#emitter.SetRTPC(this.rtpcName, value);\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Recompiles when authored fields change.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  OnModified(_options = {})\r\n  {\r\n    this.#runtime.program = null;\r\n    return true;\r\n  }\r\n\r\n  /**\r\n   * Checks whether the expression compiles.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  IsExpressionValid()\r\n  {\r\n    return this.CompileExpression().IsValid();\r\n  }\r\n\r\n  /**\r\n   * Gets a curve value for expression helpers.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  GetCurveValue(time)\r\n  {\r\n    return CjsControllerExpressionProgram.getCurveValue(this.curve, time);\r\n  }\r\n\r\n  /**\r\n   * Gets expression term metadata from the linked controller.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  GetExpressionTermInfo()\r\n  {\r\n    const result = [];\r\n    CjsControllerExpressionProgram.addControllerTermInfo(result, {\r\n      curve: true\r\n    });\r\n    this.#runtime.controller?.GetExpressionTermInfo?.(result);\r\n    return result;\r\n  }\r\n\r\n  /**\r\n   * Evaluates an expression against this action's controller context.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  EvaluateExpression(expression)\r\n  {\r\n    const state = {\r\n      program: null,\r\n      source: \"\"\r\n    };\r\n    const program = CjsControllerExpressionProgram.compileCached(state, expression, 0, {\r\n      Curve: (_ctx, time) => this.GetCurveValue(Number(time))\r\n    });\r\n    if (!program.IsValid())\r\n    {\r\n      return 0;\r\n    }\r\n    const controller = this.#runtime.controller;\r\n    return Number(program.Evaluate(CjsControllerExpressionProgram.makeActionContext(controller, ITr2ControllerAction.getOwner(controller), this.#runtime, {\r\n      action: this\r\n    }))) || 0;\r\n  }\r\n  CompileExpression()\r\n  {\r\n    return CjsControllerExpressionProgram.compileCached(this.#runtime, this.value, 0, {\r\n      Curve: (_ctx, time) => this.GetCurveValue(Number(time))\r\n    });\r\n  }\r\n}\r\n"],"names":["_Tr2ActionBindRTPC","Tr2ActionBindRTPC","CjsModel","e","_init_value","_init_extra_value","_init_emitter","_init_extra_emitter","_init_rtpcName","_init_extra_rtpcName","_init_curve","_init_extra_curve","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","notify","persist","string","objectRef","carbon","method","impl","adapted","implemented","value","emitter","rtpcName","curve","CjsControllerExpressionProgram","createRuntimeState","Link","controller","CompileExpression","Unlink","Start","startTime","ITr2ControllerAction","getTime","lastTime","findSoundEmitter","getOwner","RegisterUpdateable","StartWithController","requireController","Stop","UnRegisterUpdateable","StopWithController","Update","_realTime","simTime","program","IsValid","Number","Evaluate","makeActionContext","action","hasFunction","SetRTPC","OnModified","_options","IsExpressionValid","GetCurveValue","time","getCurveValue","GetExpressionTermInfo","result","addControllerTermInfo","EvaluateExpression","expression","state","source","compileCached","Curve","_ctx"],"mappings":"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"}
+{"version":3,"file":"Tr2ActionBindRTPC.js","sources":["../../../src/controllers/Tr2ActionBindRTPC.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\Controllers\\Actions\\Tr2ActionBindRTPC.h\r\n// Source: E:\\carbonengine\\trinity\\trinity\\Controllers\\Actions\\Tr2ActionBindRTPC.cpp\r\nimport { CjsModel } from \"@carbonenginejs/runtime-utils/model\";\r\nimport { carbon, impl, io, type } from \"@carbonenginejs/runtime-utils/schema\";\r\nimport { CjsControllerExpressionProgram } from \"./CjsControllerExpressionProgram.js\";\r\nimport { ITr2ControllerAction } from \"./ITr2ControllerAction.js\";\r\n\r\n\r\n/**\r\n * Controller action that registers for per-frame updates and pushes an\r\n * expression-driven value into a named Wwise real-time parameter on a sound\r\n * emitter.\r\n */\r\n@type.define({\r\n  className: \"Tr2ActionBindRTPC\",\r\n  family: \"controllers\"\r\n})\r\nexport class Tr2ActionBindRTPC extends CjsModel\r\n{\r\n  @io.notify\r\n  @io.persist\r\n  @type.string\r\n  value = \"\";\r\n\r\n  @io.persist\r\n  @type.string\r\n  emitter = \"\";\r\n\r\n  @io.persist\r\n  @type.string\r\n  rtpcName = \"\";\r\n\r\n  @io.persist\r\n  @type.objectRef(\"ITriScalarFunction\")\r\n  curve = null;\r\n\r\n  #runtime = CjsControllerExpressionProgram.createRuntimeState();\r\n\r\n  #emitter = null;\r\n\r\n  /**\r\n   * Links and compiles the RTPC value expression.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  Link(controller)\r\n  {\r\n    this.#runtime.controller = controller;\r\n    this.CompileExpression();\r\n  }\r\n\r\n  /**\r\n   * Clears runtime expression state.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  Unlink()\r\n  {\r\n    this.#runtime = CjsControllerExpressionProgram.createRuntimeState();\r\n  }\r\n\r\n  /**\r\n   * Starts RTPC updates.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  Start(controller = this.#runtime.controller)\r\n  {\r\n    if (!controller)\r\n    {\r\n      return;\r\n    }\r\n    this.#runtime.controller = controller;\r\n    this.#runtime.startTime = ITr2ControllerAction.getTime(controller);\r\n    this.#runtime.lastTime = this.#runtime.startTime;\r\n    this.#emitter = ITr2ControllerAction.findSoundEmitter(ITr2ControllerAction.getOwner(controller), this.emitter);\r\n    controller.RegisterUpdateable?.(this);\r\n  }\r\n\r\n  /**\r\n   * Starts manually with an explicit controller.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  StartWithController(controller)\r\n  {\r\n    this.Start(ITr2ControllerAction.requireController(controller, \"StartWithController\"));\r\n  }\r\n\r\n  /**\r\n   * Stops RTPC updates.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  Stop(controller = this.#runtime.controller)\r\n  {\r\n    controller?.UnRegisterUpdateable?.(this);\r\n  }\r\n\r\n  /**\r\n   * Stops manually with an explicit controller.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  StopWithController(controller)\r\n  {\r\n    this.Stop(ITr2ControllerAction.requireController(controller, \"StopWithController\"));\r\n  }\r\n\r\n  /**\r\n   * Updates the target RTPC value.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  Update(_realTime, simTime)\r\n  {\r\n    const controller = this.#runtime.controller;\r\n    if (!controller)\r\n    {\r\n      return;\r\n    }\r\n    this.#runtime.lastTime = simTime;\r\n    const program = this.CompileExpression();\r\n    if (!program.IsValid())\r\n    {\r\n      return;\r\n    }\r\n    const value = Number(program.Evaluate(CjsControllerExpressionProgram.makeActionContext(controller, ITr2ControllerAction.getOwner(controller), this.#runtime, {\r\n      action: this\r\n    }))) || 0;\r\n    if (ITr2ControllerAction.hasFunction(this.#emitter, \"SetRTPC\"))\r\n    {\r\n      this.#emitter.SetRTPC(this.rtpcName, value);\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Recompiles when authored fields change.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  OnModified(_options = {})\r\n  {\r\n    this.#runtime.program = null;\r\n    return true;\r\n  }\r\n\r\n  /**\r\n   * Checks whether the expression compiles.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  IsExpressionValid()\r\n  {\r\n    return this.CompileExpression().IsValid();\r\n  }\r\n\r\n  /**\r\n   * Gets a curve value for expression helpers.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  GetCurveValue(time)\r\n  {\r\n    return CjsControllerExpressionProgram.getCurveValue(this.curve, time);\r\n  }\r\n\r\n  /**\r\n   * Gets expression term metadata from the linked controller.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  GetExpressionTermInfo()\r\n  {\r\n    const result = [];\r\n    CjsControllerExpressionProgram.addControllerTermInfo(result, {\r\n      curve: true\r\n    });\r\n    this.#runtime.controller?.GetExpressionTermInfo?.(result);\r\n    return result;\r\n  }\r\n\r\n  /**\r\n   * Evaluates an expression against this action's controller context.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  EvaluateExpression(expression)\r\n  {\r\n    const state = {\r\n      program: null,\r\n      source: \"\"\r\n    };\r\n    const program = CjsControllerExpressionProgram.compileCached(state, expression, 0, {\r\n      Curve: (_ctx, time) => this.GetCurveValue(Number(time))\r\n    });\r\n    if (!program.IsValid())\r\n    {\r\n      return 0;\r\n    }\r\n    const controller = this.#runtime.controller;\r\n    return Number(program.Evaluate(CjsControllerExpressionProgram.makeActionContext(controller, ITr2ControllerAction.getOwner(controller), this.#runtime, {\r\n      action: this\r\n    }))) || 0;\r\n  }\r\n\r\n  /**\r\n   * Compiles the authored value expression with the `Curve` function bound to\r\n   * this action's curve, reusing the cached program while the text is unchanged.\r\n   */\r\n  CompileExpression()\r\n  {\r\n    return CjsControllerExpressionProgram.compileCached(this.#runtime, this.value, 0, {\r\n      Curve: (_ctx, time) => this.GetCurveValue(Number(time))\r\n    });\r\n  }\r\n}\r\n"],"names":["_Tr2ActionBindRTPC","Tr2ActionBindRTPC","CjsModel","e","_init_value","_init_extra_value","_init_emitter","_init_extra_emitter","_init_rtpcName","_init_extra_rtpcName","_init_curve","_init_extra_curve","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","notify","persist","string","objectRef","carbon","method","impl","adapted","implemented","value","emitter","rtpcName","curve","CjsControllerExpressionProgram","createRuntimeState","Link","controller","CompileExpression","Unlink","Start","startTime","ITr2ControllerAction","getTime","lastTime","findSoundEmitter","getOwner","RegisterUpdateable","StartWithController","requireController","Stop","UnRegisterUpdateable","StopWithController","Update","_realTime","simTime","program","IsValid","Number","Evaluate","makeActionContext","action","hasFunction","SetRTPC","OnModified","_options","IsExpressionValid","GetCurveValue","time","getCurveValue","GetExpressionTermInfo","result","addControllerTermInfo","EvaluateExpression","expression","state","source","compileCached","Curve","_ctx"],"mappings":"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"}

package/dist/controllers/Tr2ActionCallback.js

@@ -3,6 +3,11 @@ import { CjsModel } from '@carbonenginejs/runtime-utils/model';
 import { io, type, carbon, impl } from '@carbonenginejs/runtime-utils/schema';
 
 let _initProto, _initClass, _init_callbackName, _init_extra_callbackName;
+
+/**
+ * Controller action that fires a named callback on its controller when the
+ * action starts, letting host code hook a point in a state machine or timeline.
+ */
 let _Tr2ActionCallback;
 class Tr2ActionCallback extends CjsModel {
   static {

package/dist/controllers/Tr2ActionCallback.js.map

@@ -1 +1 @@
-{"version":3,"file":"Tr2ActionCallback.js","sources":["../../../src/controllers/Tr2ActionCallback.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\Controllers\\Actions\\Tr2ActionCallback.h\n// Source: E:\\carbonengine\\trinity\\trinity\\Controllers\\Actions\\Tr2ActionCallback.cpp\nimport { CjsModel } from \"@carbonenginejs/runtime-utils/model\";\nimport { carbon, impl, io, type } from \"@carbonenginejs/runtime-utils/schema\";\n\n\n@type.define({\n  className: \"Tr2ActionCallback\",\n  family: \"controllers\"\n})\nexport class Tr2ActionCallback extends CjsModel\n{\n  @io.persist\n  @type.string\n  callbackName = \"\";\n\n  /**\n   * Notifies the linked controller callback registry.\n   */\n  @carbon.method\n  @impl.implemented\n  Start(controller)\n  {\n    if (this.callbackName)\n    {\n      controller.Callback?.(this.callbackName);\n    }\n  }\n}\n"],"names":["_Tr2ActionCallback","Tr2ActionCallback","CjsModel","e","_init_callbackName","_init_extra_callbackName","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","persist","string","carbon","method","impl","implemented","constructor","args","callbackName","Start","controller","Callback"],"mappings":";;;;;AAG8E,IAAAA;AAG9E,MAAAC,iBAAA,SAIuCC,QAAQ,CAC/C;AAAA,EAAA;AAAA,IAAA,CAAA;AAAAC,MAAAA,CAAA,EAAA,CAAAC,kBAAA,EAAAC,wBAAA,EAAAC,UAAA,CAAA;MAAAC,CAAA,EAAA,CAAAP,kBAAA,EAAAQ,UAAA;AAAA,KAAA,GAAAC,cAAA,CAAA,IAAA,EAAA,CALCC,IAAI,CAACC,MAAM,CAAC;AACXC,MAAAA,SAAS,EAAE,mBAAmB;AAC9BC,MAAAA,MAAM,EAAE;KACT,CAAC,CAAA,EAAA,CAAA,CAAA,CAGCC,EAAE,EAAFA,EAAE,CAACC,OAAO,EACVL,IAAI,EAAJA,IAAI,CAACM,MAAM,0BAMXC,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACC,WAAW,CAAA,EAAA,EAAA,EAAA,OAAA,CAAA,CAAA,EAAA,CAAA,EAAA,MAAA,EAVoBlB,QAAQ,CAAA;AAAA;AAAAmB,EAAAA,WAAAA,CAAA,GAAAC,IAAA,EAAA;AAAA,IAAA,KAAA,CAAA,GAAAA,IAAA,CAAA;IAAAjB,wBAAA,CAAA,IAAA,CAAA;AAAA,EAAA;AAI7CkB,EAAAA,YAAY,IAAAjB,UAAA,CAAA,IAAA,CAAA,EAAAF,kBAAA,OAAG,EAAE,CAAA;;AAEjB;AACF;AACA;EAGEoB,KAAKA,CAACC,UAAU,EAChB;IACE,IAAI,IAAI,CAACF,YAAY,EACrB;AACEE,MAAAA,UAAU,CAACC,QAAQ,GAAG,IAAI,CAACH,YAAY,CAAC;AAC1C,IAAA;AACF,EAAA;AAAC,EAAA;IAAAf,UAAA,EAAA;AAAA;AACH;;;;"}
+{"version":3,"file":"Tr2ActionCallback.js","sources":["../../../src/controllers/Tr2ActionCallback.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\Controllers\\Actions\\Tr2ActionCallback.h\n// Source: E:\\carbonengine\\trinity\\trinity\\Controllers\\Actions\\Tr2ActionCallback.cpp\nimport { CjsModel } from \"@carbonenginejs/runtime-utils/model\";\nimport { carbon, impl, io, type } from \"@carbonenginejs/runtime-utils/schema\";\n\n\n/**\n * Controller action that fires a named callback on its controller when the\n * action starts, letting host code hook a point in a state machine or timeline.\n */\n@type.define({\n  className: \"Tr2ActionCallback\",\n  family: \"controllers\"\n})\nexport class Tr2ActionCallback extends CjsModel\n{\n  @io.persist\n  @type.string\n  callbackName = \"\";\n\n  /**\n   * Notifies the linked controller callback registry.\n   */\n  @carbon.method\n  @impl.implemented\n  Start(controller)\n  {\n    if (this.callbackName)\n    {\n      controller.Callback?.(this.callbackName);\n    }\n  }\n}\n"],"names":["_Tr2ActionCallback","Tr2ActionCallback","CjsModel","e","_init_callbackName","_init_extra_callbackName","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","persist","string","carbon","method","impl","implemented","constructor","args","callbackName","Start","controller","Callback"],"mappings":";;;;;;AAMA;AACA;AACA;AACA;AAHA,IAAAA;AAIA,MAAAC,iBAAA,SAIuCC,QAAQ,CAC/C;AAAA,EAAA;AAAA,IAAA,CAAA;AAAAC,MAAAA,CAAA,EAAA,CAAAC,kBAAA,EAAAC,wBAAA,EAAAC,UAAA,CAAA;MAAAC,CAAA,EAAA,CAAAP,kBAAA,EAAAQ,UAAA;AAAA,KAAA,GAAAC,cAAA,CAAA,IAAA,EAAA,CALCC,IAAI,CAACC,MAAM,CAAC;AACXC,MAAAA,SAAS,EAAE,mBAAmB;AAC9BC,MAAAA,MAAM,EAAE;KACT,CAAC,CAAA,EAAA,CAAA,CAAA,CAGCC,EAAE,EAAFA,EAAE,CAACC,OAAO,EACVL,IAAI,EAAJA,IAAI,CAACM,MAAM,0BAMXC,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACC,WAAW,CAAA,EAAA,EAAA,EAAA,OAAA,CAAA,CAAA,EAAA,CAAA,EAAA,MAAA,EAVoBlB,QAAQ,CAAA;AAAA;AAAAmB,EAAAA,WAAAA,CAAA,GAAAC,IAAA,EAAA;AAAA,IAAA,KAAA,CAAA,GAAAA,IAAA,CAAA;IAAAjB,wBAAA,CAAA,IAAA,CAAA;AAAA,EAAA;AAI7CkB,EAAAA,YAAY,IAAAjB,UAAA,CAAA,IAAA,CAAA,EAAAF,kBAAA,OAAG,EAAE,CAAA;;AAEjB;AACF;AACA;EAGEoB,KAAKA,CAACC,UAAU,EAChB;IACE,IAAI,IAAI,CAACF,YAAY,EACrB;AACEE,MAAAA,UAAU,CAACC,QAAQ,GAAG,IAAI,CAACH,YAAY,CAAC;AAC1C,IAAA;AACF,EAAA;AAAC,EAAA;IAAAf,UAAA,EAAA;AAAA;AACH;;;;"}

package/dist/controllers/Tr2ActionChildEffect.js

@@ -4,6 +4,11 @@ import { io, type, carbon, impl } from '@carbonenginejs/runtime-utils/schema';
 import { ITr2ControllerAction } from './ITr2ControllerAction.js';
 
 let _initProto, _initClass, _init_addOnStart, _init_extra_addOnStart, _init_targetAnotherOwner, _init_extra_targetAnotherOwner, _init_childName, _init_extra_childName, _init_path, _init_extra_path, _init_removeOnStop, _init_extra_removeOnStop;
+
+/**
+ * Controller action that attaches a child effect loaded from a resource path to
+ * its owner on start and detaches it on stop.
+ */
 let _Tr2ActionChildEffect;
 new class extends _identity {
   static [class Tr2ActionChildEffect extends CjsModel {
@@ -89,12 +94,28 @@ new class extends _identity {
       }
       this.#child = null;
     }
+
+    /**
+     * Resolves the object the child effect is attached to, following
+     * targetAnotherOwner when set.
+     */
     ResolveOwner(owner) {
       return this.#resolveOwner(owner).owner;
     }
+
+    /**
+     * Looks up an already-present child by childName on the owner, returning null
+     * when childName is empty or no match exists.
+     */
     FindChild(owner) {
       return (this.childName ? ITr2ControllerAction.callTarget(owner, "GetEffectChildByName", this.childName) ?? _Tr2ActionChildEffect.#findNamed(owner, this.childName) : null) ?? null;
     }
+
+    /**
+     * Creates the child through the owner's AddChildFromPath, and when the owner
+     * has no loader falls back to attaching a plain `{ name, path }` placeholder
+     * record so the binding still resolves.
+     */
     CreateChild(owner) {
       const childFromOwner = ITr2ControllerAction.callTarget(owner, "AddChildFromPath", this.path, this.childName);
       if (childFromOwner) {
@@ -109,6 +130,12 @@ new class extends _identity {
       _Tr2ActionChildEffect.#addChildToOwner(owner, child);
       return child;
     }
+
+    /**
+     * Redirects the action to another owner named by targetAnotherOwner, trying a
+     * named effect child, then a named parameter, then a stretch endpoint;
+     * `rebind` is set when the redirect requires the controller owner to rebind.
+     */
     #resolveOwner(owner) {
       if (!owner || !this.targetAnotherOwner) {
         return {
@@ -136,6 +163,42 @@ new class extends _identity {
         rebind: !!stretchOwner
       };
     }
+
+    /**
+     * Attaches a child through AddToEffectChildrenList or AddChild, falling back
+     * to pushing onto plain `effectChildren` and `children` arrays.
+     */
+
+    /**
+     * Searches the owner's `effectChildren`, `children` and `items` arrays for an
+     * entry whose GetName() or `name` matches.
+     */
+
+    /**
+     * Resolves the `SourceSpaceObject` and `DestSpaceObject` endpoints of a
+     * stretch owner, returning null for any other name.
+     */
+
+    /**
+     * Detaches a child through RemoveFromEffectChildrenList or RemoveChild,
+     * falling back to splicing it out of plain `effectChildren` and `children`
+     * arrays.
+     */
+
+    /**
+     * Names a created child through SetName when available, otherwise by assigning
+     * the `name` property; an empty name is ignored.
+     */
+
+    /**
+     * Appends a value to a named array property on the owner if it is not already
+     * present.
+     */
+
+    /**
+     * Removes the first occurrence of a value from a named array property on the
+     * owner.
+     */
   }];
   #resourcePrefetcher = null;
   #addChildToOwner(owner, child) {

package/dist/controllers/Tr2ActionChildEffect.js.map

@@ -1 +1 @@
-{"version":3,"file":"Tr2ActionChildEffect.js","sources":["../../../src/controllers/Tr2ActionChildEffect.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\Controllers\\Actions\\Tr2ActionChildEffect.h\n// Source: E:\\carbonengine\\trinity\\trinity\\Controllers\\Actions\\Tr2ActionChildEffect.cpp\nimport { CjsModel } from \"@carbonenginejs/runtime-utils/model\";\nimport { carbon, impl, io, type } from \"@carbonenginejs/runtime-utils/schema\";\nimport { ITr2ControllerAction } from \"./ITr2ControllerAction.js\";\n\n\n@type.define({\n  className: \"Tr2ActionChildEffect\",\n  family: \"controllers\"\n})\nexport class Tr2ActionChildEffect extends CjsModel\n{\n  static #resourcePrefetcher = null;\n\n  /** Registers the runtime-owned child-effect prefetch callback. */\n  static registerResourcePrefetcher(prefetcher)\n  {\n    const previous = this.#resourcePrefetcher;\n    this.#resourcePrefetcher = prefetcher;\n    return previous;\n  }\n\n  /** Clears the runtime-owned child-effect prefetch callback. */\n  static clearResourcePrefetcher()\n  {\n    this.#resourcePrefetcher = null;\n  }\n\n  /** Requests prefetch without taking ownership of the resource lifecycle. */\n  static prefetchResource(path, owner = null)\n  {\n    if (path && this.#resourcePrefetcher)\n    {\n      this.#resourcePrefetcher(path, owner);\n    }\n  }\n\n  @io.persist\n  @type.boolean\n  addOnStart = true;\n\n  @io.persist\n  @type.string\n  targetAnotherOwner = \"\";\n\n  @io.persist\n  @type.string\n  childName = \"\";\n\n  @io.persist\n  @type.path\n  path = \"\";\n\n  @io.persist\n  @type.boolean\n  removeOnStop = true;\n\n  #child = null;\n\n  /**\n   * Carbon prefetches the resource here; JS keeps this as an explicit no-op.\n   */\n  @carbon.method\n  @impl.noop\n  Link(controller)\n  {\n    const owner = ITr2ControllerAction.getOwner(controller);\n    Tr2ActionChildEffect.prefetchResource(this.path, owner);\n  }\n\n  /**\n   * Adds the target child effect when Carbon would load it on action start.\n   */\n  @carbon.method\n  @impl.adapted\n  Start(controller)\n  {\n    const controllerOwner = ITr2ControllerAction.getOwner(controller);\n    const resolved = this.#resolveOwner(controllerOwner);\n    const owner = resolved.owner;\n    if (!owner)\n    {\n      return;\n    }\n    this.#child = this.FindChild(owner);\n    if (this.#child || !this.addOnStart || !this.path)\n    {\n      return;\n    }\n    this.#child = this.CreateChild(owner);\n    if (!this.#child)\n    {\n      return;\n    }\n    ITr2ControllerAction.callTarget(this.#child, \"StartControllers\");\n    if (resolved.rebind)\n    {\n      ITr2ControllerAction.callTarget(controllerOwner, \"Rebind\", true);\n    }\n  }\n\n  /**\n   * Stops or removes the target child effect.\n   */\n  @carbon.method\n  @impl.adapted\n  Stop(controller)\n  {\n    const child = this.#child;\n    if (!child)\n    {\n      return;\n    }\n    if (this.removeOnStop)\n    {\n      const owner = this.#resolveOwner(ITr2ControllerAction.getOwner(controller)).owner;\n      if (owner)\n      {\n        Tr2ActionChildEffect.#removeChildFromOwner(owner, child);\n      }\n    }\n    this.#child = null;\n  }\n  ResolveOwner(owner)\n  {\n    return this.#resolveOwner(owner).owner;\n  }\n  FindChild(owner)\n  {\n    return (this.childName ? ITr2ControllerAction.callTarget(owner, \"GetEffectChildByName\", this.childName) ?? Tr2ActionChildEffect.#findNamed(owner, this.childName) : null) ?? null;\n  }\n  CreateChild(owner)\n  {\n    const childFromOwner = ITr2ControllerAction.callTarget(owner, \"AddChildFromPath\", this.path, this.childName);\n    if (childFromOwner)\n    {\n      Tr2ActionChildEffect.#setChildName(childFromOwner, this.childName);\n      return childFromOwner;\n    }\n    const child = {\n      name: this.childName,\n      path: this.path\n    };\n    Tr2ActionChildEffect.#setChildName(child, this.childName);\n    Tr2ActionChildEffect.#addChildToOwner(owner, child);\n    return child;\n  }\n  #resolveOwner(owner)\n  {\n    if (!owner || !this.targetAnotherOwner)\n    {\n      return {\n        owner,\n        rebind: false\n      };\n    }\n    const childOwner = ITr2ControllerAction.asObject(ITr2ControllerAction.callTarget(owner, \"GetEffectChildByName\", this.targetAnotherOwner) ?? Tr2ActionChildEffect.#findNamed(owner, this.targetAnotherOwner));\n    if (childOwner)\n    {\n      return {\n        owner: childOwner,\n        rebind: false\n      };\n    }\n    const parameterOwner = ITr2ControllerAction.getParameterOwner(owner, this.targetAnotherOwner);\n    if (parameterOwner)\n    {\n      return {\n        owner: parameterOwner,\n        rebind: true\n      };\n    }\n    const stretchOwner = Tr2ActionChildEffect.#getStretchOwner(owner, this.targetAnotherOwner);\n    return {\n      owner: stretchOwner,\n      rebind: !!stretchOwner\n    };\n  }\n\n  static #addChildToOwner(owner, child)\n  {\n    if (ITr2ControllerAction.hasFunction(owner, \"AddToEffectChildrenList\"))\n    {\n      owner.AddToEffectChildrenList(child);\n      return;\n    }\n    if (ITr2ControllerAction.hasFunction(owner, \"AddChild\"))\n    {\n      owner.AddChild(child);\n      return;\n    }\n    this.#addToArray(owner, \"effectChildren\", child);\n    this.#addToArray(owner, \"children\", child);\n  }\n\n  static #findNamed(owner, name)\n  {\n    for (const listName of [\"effectChildren\", \"children\", \"items\"])\n    {\n      if (ITr2ControllerAction.hasProperty(owner, listName) && Array.isArray(owner[listName]))\n      {\n        const found = owner[listName].find(item => ITr2ControllerAction.callTarget(item, \"GetName\") === name || ITr2ControllerAction.hasProperty(item, \"name\") && item.name === name);\n        if (found)\n        {\n          return found;\n        }\n      }\n    }\n    return null;\n  }\n\n  static #getStretchOwner(owner, name)\n  {\n    if (name === \"SourceSpaceObject\")\n    {\n      return ITr2ControllerAction.asObject(ITr2ControllerAction.callTarget(owner, \"GetSourceSpaceObject\") ?? ITr2ControllerAction.getProperty(owner, \"sourceSpaceObject\"));\n    }\n    if (name === \"DestSpaceObject\")\n    {\n      return ITr2ControllerAction.asObject(ITr2ControllerAction.callTarget(owner, \"GetDestSpaceObject\") ?? ITr2ControllerAction.getProperty(owner, \"destSpaceObject\"));\n    }\n    return null;\n  }\n\n  static #removeChildFromOwner(owner, child)\n  {\n    if (ITr2ControllerAction.hasFunction(owner, \"RemoveFromEffectChildrenList\"))\n    {\n      owner.RemoveFromEffectChildrenList(child);\n      return;\n    }\n    if (ITr2ControllerAction.hasFunction(owner, \"RemoveChild\"))\n    {\n      owner.RemoveChild(child);\n      return;\n    }\n    this.#removeFromArray(owner, \"effectChildren\", child);\n    this.#removeFromArray(owner, \"children\", child);\n  }\n\n  static #setChildName(child, name)\n  {\n    if (!name || !child || typeof child !== \"object\")\n    {\n      return;\n    }\n    if (ITr2ControllerAction.hasFunction(child, \"SetName\"))\n    {\n      child.SetName(name);\n      return;\n    }\n    child.name = name;\n  }\n\n  static #addToArray(owner, listName, value)\n  {\n    if (ITr2ControllerAction.hasProperty(owner, listName) && Array.isArray(owner[listName]) && !owner[listName].includes(value))\n    {\n      owner[listName].push(value);\n    }\n  }\n\n  static #removeFromArray(owner, listName, value)\n  {\n    if (ITr2ControllerAction.hasProperty(owner, listName) && Array.isArray(owner[listName]))\n    {\n      const index = owner[listName].indexOf(value);\n      if (index !== -1)\n      {\n        owner[listName].splice(index, 1);\n      }\n    }\n  }\n}\n"],"names":["_Tr2ActionChildEffect","_identity","Tr2ActionChildEffect","CjsModel","e","_init_addOnStart","_init_extra_addOnStart","_init_targetAnotherOwner","_init_extra_targetAnotherOwner","_init_childName","_init_extra_childName","_init_path","_init_extra_path","_init_removeOnStop","_init_extra_removeOnStop","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","persist","boolean","string","path","carbon","method","impl","noop","adapted","registerResourcePrefetcher","prefetcher","previous","clearResourcePrefetcher","prefetchResource","owner","addOnStart","targetAnotherOwner","childName","removeOnStop","Link","controller","ITr2ControllerAction","getOwner","Start","controllerOwner","resolved","FindChild","CreateChild","callTarget","rebind","Stop","child","ResolveOwner","childFromOwner","name","#resolveOwner","childOwner","asObject","parameterOwner","getParameterOwner","stretchOwner","#addChildToOwner","hasFunction","AddToEffectChildrenList","AddChild","#findNamed","listName","hasProperty","Array","isArray","found","find","item","#getStretchOwner","getProperty","#removeChildFromOwner","RemoveFromEffectChildrenList","RemoveChild","#setChildName","SetName","#addToArray","value","includes","push","#removeFromArray","index","indexOf","splice","constructor"],"mappings":"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"}
+{"version":3,"file":"Tr2ActionChildEffect.js","sources":["../../../src/controllers/Tr2ActionChildEffect.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\Controllers\\Actions\\Tr2ActionChildEffect.h\n// Source: E:\\carbonengine\\trinity\\trinity\\Controllers\\Actions\\Tr2ActionChildEffect.cpp\nimport { CjsModel } from \"@carbonenginejs/runtime-utils/model\";\nimport { carbon, impl, io, type } from \"@carbonenginejs/runtime-utils/schema\";\nimport { ITr2ControllerAction } from \"./ITr2ControllerAction.js\";\n\n\n/**\n * Controller action that attaches a child effect loaded from a resource path to\n * its owner on start and detaches it on stop.\n */\n@type.define({\n  className: \"Tr2ActionChildEffect\",\n  family: \"controllers\"\n})\nexport class Tr2ActionChildEffect extends CjsModel\n{\n  static #resourcePrefetcher = null;\n\n  /** Registers the runtime-owned child-effect prefetch callback. */\n  static registerResourcePrefetcher(prefetcher)\n  {\n    const previous = this.#resourcePrefetcher;\n    this.#resourcePrefetcher = prefetcher;\n    return previous;\n  }\n\n  /** Clears the runtime-owned child-effect prefetch callback. */\n  static clearResourcePrefetcher()\n  {\n    this.#resourcePrefetcher = null;\n  }\n\n  /** Requests prefetch without taking ownership of the resource lifecycle. */\n  static prefetchResource(path, owner = null)\n  {\n    if (path && this.#resourcePrefetcher)\n    {\n      this.#resourcePrefetcher(path, owner);\n    }\n  }\n\n  @io.persist\n  @type.boolean\n  addOnStart = true;\n\n  @io.persist\n  @type.string\n  targetAnotherOwner = \"\";\n\n  @io.persist\n  @type.string\n  childName = \"\";\n\n  @io.persist\n  @type.path\n  path = \"\";\n\n  @io.persist\n  @type.boolean\n  removeOnStop = true;\n\n  #child = null;\n\n  /**\n   * Carbon prefetches the resource here; JS keeps this as an explicit no-op.\n   */\n  @carbon.method\n  @impl.noop\n  Link(controller)\n  {\n    const owner = ITr2ControllerAction.getOwner(controller);\n    Tr2ActionChildEffect.prefetchResource(this.path, owner);\n  }\n\n  /**\n   * Adds the target child effect when Carbon would load it on action start.\n   */\n  @carbon.method\n  @impl.adapted\n  Start(controller)\n  {\n    const controllerOwner = ITr2ControllerAction.getOwner(controller);\n    const resolved = this.#resolveOwner(controllerOwner);\n    const owner = resolved.owner;\n    if (!owner)\n    {\n      return;\n    }\n    this.#child = this.FindChild(owner);\n    if (this.#child || !this.addOnStart || !this.path)\n    {\n      return;\n    }\n    this.#child = this.CreateChild(owner);\n    if (!this.#child)\n    {\n      return;\n    }\n    ITr2ControllerAction.callTarget(this.#child, \"StartControllers\");\n    if (resolved.rebind)\n    {\n      ITr2ControllerAction.callTarget(controllerOwner, \"Rebind\", true);\n    }\n  }\n\n  /**\n   * Stops or removes the target child effect.\n   */\n  @carbon.method\n  @impl.adapted\n  Stop(controller)\n  {\n    const child = this.#child;\n    if (!child)\n    {\n      return;\n    }\n    if (this.removeOnStop)\n    {\n      const owner = this.#resolveOwner(ITr2ControllerAction.getOwner(controller)).owner;\n      if (owner)\n      {\n        Tr2ActionChildEffect.#removeChildFromOwner(owner, child);\n      }\n    }\n    this.#child = null;\n  }\n\n  /**\n   * Resolves the object the child effect is attached to, following\n   * targetAnotherOwner when set.\n   */\n  ResolveOwner(owner)\n  {\n    return this.#resolveOwner(owner).owner;\n  }\n\n  /**\n   * Looks up an already-present child by childName on the owner, returning null\n   * when childName is empty or no match exists.\n   */\n  FindChild(owner)\n  {\n    return (this.childName ? ITr2ControllerAction.callTarget(owner, \"GetEffectChildByName\", this.childName) ?? Tr2ActionChildEffect.#findNamed(owner, this.childName) : null) ?? null;\n  }\n\n  /**\n   * Creates the child through the owner's AddChildFromPath, and when the owner\n   * has no loader falls back to attaching a plain `{ name, path }` placeholder\n   * record so the binding still resolves.\n   */\n  CreateChild(owner)\n  {\n    const childFromOwner = ITr2ControllerAction.callTarget(owner, \"AddChildFromPath\", this.path, this.childName);\n    if (childFromOwner)\n    {\n      Tr2ActionChildEffect.#setChildName(childFromOwner, this.childName);\n      return childFromOwner;\n    }\n    const child = {\n      name: this.childName,\n      path: this.path\n    };\n    Tr2ActionChildEffect.#setChildName(child, this.childName);\n    Tr2ActionChildEffect.#addChildToOwner(owner, child);\n    return child;\n  }\n\n  /**\n   * Redirects the action to another owner named by targetAnotherOwner, trying a\n   * named effect child, then a named parameter, then a stretch endpoint;\n   * `rebind` is set when the redirect requires the controller owner to rebind.\n   */\n  #resolveOwner(owner)\n  {\n    if (!owner || !this.targetAnotherOwner)\n    {\n      return {\n        owner,\n        rebind: false\n      };\n    }\n    const childOwner = ITr2ControllerAction.asObject(ITr2ControllerAction.callTarget(owner, \"GetEffectChildByName\", this.targetAnotherOwner) ?? Tr2ActionChildEffect.#findNamed(owner, this.targetAnotherOwner));\n    if (childOwner)\n    {\n      return {\n        owner: childOwner,\n        rebind: false\n      };\n    }\n    const parameterOwner = ITr2ControllerAction.getParameterOwner(owner, this.targetAnotherOwner);\n    if (parameterOwner)\n    {\n      return {\n        owner: parameterOwner,\n        rebind: true\n      };\n    }\n    const stretchOwner = Tr2ActionChildEffect.#getStretchOwner(owner, this.targetAnotherOwner);\n    return {\n      owner: stretchOwner,\n      rebind: !!stretchOwner\n    };\n  }\n\n  /**\n   * Attaches a child through AddToEffectChildrenList or AddChild, falling back\n   * to pushing onto plain `effectChildren` and `children` arrays.\n   */\n  static #addChildToOwner(owner, child)\n  {\n    if (ITr2ControllerAction.hasFunction(owner, \"AddToEffectChildrenList\"))\n    {\n      owner.AddToEffectChildrenList(child);\n      return;\n    }\n    if (ITr2ControllerAction.hasFunction(owner, \"AddChild\"))\n    {\n      owner.AddChild(child);\n      return;\n    }\n    this.#addToArray(owner, \"effectChildren\", child);\n    this.#addToArray(owner, \"children\", child);\n  }\n\n  /**\n   * Searches the owner's `effectChildren`, `children` and `items` arrays for an\n   * entry whose GetName() or `name` matches.\n   */\n  static #findNamed(owner, name)\n  {\n    for (const listName of [\"effectChildren\", \"children\", \"items\"])\n    {\n      if (ITr2ControllerAction.hasProperty(owner, listName) && Array.isArray(owner[listName]))\n      {\n        const found = owner[listName].find(item => ITr2ControllerAction.callTarget(item, \"GetName\") === name || ITr2ControllerAction.hasProperty(item, \"name\") && item.name === name);\n        if (found)\n        {\n          return found;\n        }\n      }\n    }\n    return null;\n  }\n\n  /**\n   * Resolves the `SourceSpaceObject` and `DestSpaceObject` endpoints of a\n   * stretch owner, returning null for any other name.\n   */\n  static #getStretchOwner(owner, name)\n  {\n    if (name === \"SourceSpaceObject\")\n    {\n      return ITr2ControllerAction.asObject(ITr2ControllerAction.callTarget(owner, \"GetSourceSpaceObject\") ?? ITr2ControllerAction.getProperty(owner, \"sourceSpaceObject\"));\n    }\n    if (name === \"DestSpaceObject\")\n    {\n      return ITr2ControllerAction.asObject(ITr2ControllerAction.callTarget(owner, \"GetDestSpaceObject\") ?? ITr2ControllerAction.getProperty(owner, \"destSpaceObject\"));\n    }\n    return null;\n  }\n\n  /**\n   * Detaches a child through RemoveFromEffectChildrenList or RemoveChild,\n   * falling back to splicing it out of plain `effectChildren` and `children`\n   * arrays.\n   */\n  static #removeChildFromOwner(owner, child)\n  {\n    if (ITr2ControllerAction.hasFunction(owner, \"RemoveFromEffectChildrenList\"))\n    {\n      owner.RemoveFromEffectChildrenList(child);\n      return;\n    }\n    if (ITr2ControllerAction.hasFunction(owner, \"RemoveChild\"))\n    {\n      owner.RemoveChild(child);\n      return;\n    }\n    this.#removeFromArray(owner, \"effectChildren\", child);\n    this.#removeFromArray(owner, \"children\", child);\n  }\n\n  /**\n   * Names a created child through SetName when available, otherwise by assigning\n   * the `name` property; an empty name is ignored.\n   */\n  static #setChildName(child, name)\n  {\n    if (!name || !child || typeof child !== \"object\")\n    {\n      return;\n    }\n    if (ITr2ControllerAction.hasFunction(child, \"SetName\"))\n    {\n      child.SetName(name);\n      return;\n    }\n    child.name = name;\n  }\n\n  /**\n   * Appends a value to a named array property on the owner if it is not already\n   * present.\n   */\n  static #addToArray(owner, listName, value)\n  {\n    if (ITr2ControllerAction.hasProperty(owner, listName) && Array.isArray(owner[listName]) && !owner[listName].includes(value))\n    {\n      owner[listName].push(value);\n    }\n  }\n\n  /**\n   * Removes the first occurrence of a value from a named array property on the\n   * owner.\n   */\n  static #removeFromArray(owner, listName, value)\n  {\n    if (ITr2ControllerAction.hasProperty(owner, listName) && Array.isArray(owner[listName]))\n    {\n      const index = owner[listName].indexOf(value);\n      if (index !== -1)\n      {\n        owner[listName].splice(index, 1);\n      }\n    }\n  }\n}\n"],"names":["_Tr2ActionChildEffect","_identity","Tr2ActionChildEffect","CjsModel","e","_init_addOnStart","_init_extra_addOnStart","_init_targetAnotherOwner","_init_extra_targetAnotherOwner","_init_childName","_init_extra_childName","_init_path","_init_extra_path","_init_removeOnStop","_init_extra_removeOnStop","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","persist","boolean","string","path","carbon","method","impl","noop","adapted","registerResourcePrefetcher","prefetcher","previous","clearResourcePrefetcher","prefetchResource","owner","addOnStart","targetAnotherOwner","childName","removeOnStop","Link","controller","ITr2ControllerAction","getOwner","Start","controllerOwner","resolved","FindChild","CreateChild","callTarget","rebind","Stop","child","ResolveOwner","childFromOwner","name","#resolveOwner","childOwner","asObject","parameterOwner","getParameterOwner","stretchOwner","#addChildToOwner","hasFunction","AddToEffectChildrenList","AddChild","#findNamed","listName","hasProperty","Array","isArray","found","find","item","#getStretchOwner","getProperty","#removeChildFromOwner","RemoveFromEffectChildrenList","RemoveChild","#setChildName","SetName","#addToArray","value","includes","push","#removeFromArray","index","indexOf","splice","constructor"],"mappings":"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"}

package/dist/controllers/Tr2ActionOverlay.js

@@ -4,6 +4,11 @@ import { io, type, carbon, impl } from '@carbonenginejs/runtime-utils/schema';
 import { ITr2ControllerAction } from './ITr2ControllerAction.js';
 
 let _initProto, _initClass, _init_path, _init_extra_path, _init_overlayName, _init_extra_overlayName, _init_targetAnotherOwner, _init_extra_targetAnotherOwner, _init_addOnStart, _init_extra_addOnStart, _init_removeOnStop, _init_extra_removeOnStop;
+
+/**
+ * Controller action that adds a named overlay effect to its owner when the
+ * action starts and removes it again when the action stops.
+ */
 let _Tr2ActionOverlay;
 new class extends _identity {
   static [class Tr2ActionOverlay extends CjsModel {
@@ -54,6 +59,12 @@ new class extends _identity {
       }
       this.#overlay = null;
     }
+
+    /**
+     * Finds the overlay already present on the owner by name, and only when it is
+     * absent and addOnStart is set loads it from the authored path, names it,
+     * attaches it, and starts its controllers.
+     */
     #loadOverlay(owner) {
       this.#overlay = this.overlayName ? ITr2ControllerAction.callTarget(owner, "GetOverlayEffectByName", this.overlayName) ?? _Tr2ActionOverlay.#findNamed(owner, "overlays", this.overlayName) : null;
       if (!this.#overlay && this.addOnStart && this.path) {
@@ -68,6 +79,11 @@ new class extends _identity {
         }
       }
     }
+
+    /**
+     * Lower-cases the authored path and switches the `_skinned` suffix on or off
+     * to match whether the owner is animated.
+     */
     #normalizePath(owner) {
       let path = this.path.toLowerCase();
       const animated = !!ITr2ControllerAction.callTarget(owner, "IsAnimated");
@@ -78,6 +94,13 @@ new class extends _identity {
       }
       return path;
     }
+
+    /**
+     * Picks the object the overlay is attached to, preferring the controller owner
+     * itself and otherwise following targetAnotherOwner through a named parameter
+     * or a stretch endpoint; `rebind` is set when the redirect requires the
+     * controller owner to rebind.
+     */
     #resolveOwner(owner) {
       if (!owner) {
         return {
@@ -116,6 +139,51 @@ new class extends _identity {
         rebind: false
       };
     }
+
+    /**
+     * Attaches an overlay through the owner's AddOverlayEffect, falling back to
+     * pushing onto a plain `overlays` array.
+     */
+
+    /**
+     * Appends a value to a named array property on the owner if it is not already
+     * present.
+     */
+
+    /**
+     * Finds an entry in a named array property whose GetName() or `name` matches,
+     * or null.
+     */
+
+    /**
+     * Resolves the `SourceSpaceObject` and `DestSpaceObject` endpoints of a
+     * stretch owner, returning null for any other name.
+     */
+
+    /**
+     * Checks whether an object can hold overlays, by exposing any of the overlay
+     * accessor methods or a plain `overlays` array.
+     */
+
+    /**
+     * Loads an overlay from a path through whichever owner loader exists,
+     * reporting in `added` whether that loader already attached it to the owner.
+     */
+
+    /**
+     * Removes the first occurrence of a value from a named array property on the
+     * owner.
+     */
+
+    /**
+     * Detaches an overlay through the owner's RemoveOverlayEffect, falling back to
+     * splicing it out of a plain `overlays` array.
+     */
+
+    /**
+     * Names a loaded overlay through SetName when available, otherwise by
+     * assigning the `name` property; an empty name is ignored.
+     */
   }];
   #addOverlay(owner, overlay) {
     if (ITr2ControllerAction.hasFunction(owner, "AddOverlayEffect")) {