@carbonenginejs/runtime-trinity 0.6.0 → 0.8.0

package/dist/controllers/Tr2ActionSetAttenuationScaling.js.map

@@ -1 +1 @@
-{"version":3,"file":"Tr2ActionSetAttenuationScaling.js","sources":["../../../src/controllers/Tr2ActionSetAttenuationScaling.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\Controllers\\Actions\\Tr2ActionSetAttenuationScaling.h\n// Source: E:\\carbonengine\\trinity\\trinity\\Controllers\\Actions\\Tr2ActionSetAttenuationScaling.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: \"Tr2ActionSetAttenuationScaling\",\n  family: \"controllers\"\n})\nexport class Tr2ActionSetAttenuationScaling extends CjsModel\n{\n  @io.persist\n  @type.string\n  emitter = \"\";\n\n  @io.persist\n  @type.string\n  controllerVariable = \"\";\n\n  @io.persist\n  @type.float32\n  scalingFactor = 1;\n\n  /**\n   * Links this action to a controller for scaling-factor lookup.\n   */\n  @carbon.method\n  @impl.adapted\n  Link(controller)\n  {\n    this.#controller = controller;\n  }\n\n  /**\n   * Clears the linked controller.\n   */\n  @carbon.method\n  @impl.implemented\n  Unlink()\n  {\n    this.#controller = null;\n  }\n  #controller = null;\n\n  /**\n   * Applies attenuation scaling to a named emitter.\n   */\n  @carbon.method\n  @impl.adapted\n  Start(controller = this.#controller)\n  {\n    const emitter = ITr2ControllerAction.findSoundEmitter(ITr2ControllerAction.getOwner(controller), this.emitter);\n    const value = this.GetScalingFactor(controller);\n    if (ITr2ControllerAction.hasFunction(emitter, \"SetAttenuationScalingFactor\"))\n    {\n      emitter.SetAttenuationScalingFactor(value);\n    }\n  }\n\n  /**\n   * Starts manually with an explicit controller.\n   */\n  @carbon.method\n  @impl.implemented\n  StartWithController(controller)\n  {\n    this.Start(ITr2ControllerAction.requireController(controller, \"StartWithController\"));\n  }\n\n  /**\n   * Gets final scaling factor, including controller variable multiplier.\n   */\n  @carbon.method\n  @impl.adapted\n  GetScalingFactor(controller = this.#controller)\n  {\n    if (!this.controllerVariable)\n    {\n      return this.scalingFactor;\n    }\n    const controllerVariableValue = ITr2ControllerAction.toNumber(controller?.GetFloatVariableByName?.(this.controllerVariable), 0);\n    return controllerVariableValue !== 0 ? this.scalingFactor * controllerVariableValue : this.scalingFactor;\n  }\n}\n"],"names":["_Tr2ActionSetAttenuat","Tr2ActionSetAttenuationScaling","CjsModel","e","_init_emitter","_init_extra_emitter","_init_controllerVariable","_init_extra_controllerVariable","_init_scalingFactor","_init_extra_scalingFactor","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","persist","string","float32","carbon","method","impl","adapted","implemented","emitter","controllerVariable","scalingFactor","Link","controller","Unlink","Start","ITr2ControllerAction","findSoundEmitter","getOwner","value","GetScalingFactor","hasFunction","SetAttenuationScalingFactor","StartWithController","requireController","controllerVariableValue","toNumber","GetFloatVariableByName"],"mappings":"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"}
+{"version":3,"file":"Tr2ActionSetAttenuationScaling.js","sources":["../../../src/controllers/Tr2ActionSetAttenuationScaling.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\Controllers\\Actions\\Tr2ActionSetAttenuationScaling.h\n// Source: E:\\carbonengine\\trinity\\trinity\\Controllers\\Actions\\Tr2ActionSetAttenuationScaling.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 sets an audio emitter's distance-attenuation scaling\n * factor on start, optionally multiplied by a named controller variable.\n */\n@type.define({\n  className: \"Tr2ActionSetAttenuationScaling\",\n  family: \"controllers\"\n})\nexport class Tr2ActionSetAttenuationScaling extends CjsModel\n{\n  @io.persist\n  @type.string\n  emitter = \"\";\n\n  @io.persist\n  @type.string\n  controllerVariable = \"\";\n\n  @io.persist\n  @type.float32\n  scalingFactor = 1;\n\n  /**\n   * Links this action to a controller for scaling-factor lookup.\n   */\n  @carbon.method\n  @impl.adapted\n  Link(controller)\n  {\n    this.#controller = controller;\n  }\n\n  /**\n   * Clears the linked controller.\n   */\n  @carbon.method\n  @impl.implemented\n  Unlink()\n  {\n    this.#controller = null;\n  }\n  #controller = null;\n\n  /**\n   * Applies attenuation scaling to a named emitter.\n   */\n  @carbon.method\n  @impl.adapted\n  Start(controller = this.#controller)\n  {\n    const emitter = ITr2ControllerAction.findSoundEmitter(ITr2ControllerAction.getOwner(controller), this.emitter);\n    const value = this.GetScalingFactor(controller);\n    if (ITr2ControllerAction.hasFunction(emitter, \"SetAttenuationScalingFactor\"))\n    {\n      emitter.SetAttenuationScalingFactor(value);\n    }\n  }\n\n  /**\n   * Starts manually with an explicit controller.\n   */\n  @carbon.method\n  @impl.implemented\n  StartWithController(controller)\n  {\n    this.Start(ITr2ControllerAction.requireController(controller, \"StartWithController\"));\n  }\n\n  /**\n   * Gets final scaling factor, including controller variable multiplier.\n   */\n  @carbon.method\n  @impl.adapted\n  GetScalingFactor(controller = this.#controller)\n  {\n    if (!this.controllerVariable)\n    {\n      return this.scalingFactor;\n    }\n    const controllerVariableValue = ITr2ControllerAction.toNumber(controller?.GetFloatVariableByName?.(this.controllerVariable), 0);\n    return controllerVariableValue !== 0 ? this.scalingFactor * controllerVariableValue : this.scalingFactor;\n  }\n}\n"],"names":["_Tr2ActionSetAttenuat","Tr2ActionSetAttenuationScaling","CjsModel","e","_init_emitter","_init_extra_emitter","_init_controllerVariable","_init_extra_controllerVariable","_init_scalingFactor","_init_extra_scalingFactor","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","persist","string","float32","carbon","method","impl","adapted","implemented","emitter","controllerVariable","scalingFactor","Link","controller","Unlink","Start","ITr2ControllerAction","findSoundEmitter","getOwner","value","GetScalingFactor","hasFunction","SetAttenuationScalingFactor","StartWithController","requireController","controllerVariableValue","toNumber","GetFloatVariableByName"],"mappings":"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"}

package/dist/controllers/Tr2ActionSetAudioEmitterPrefix.js

@@ -4,6 +4,11 @@ import { io, type, carbon, impl } from '@carbonenginejs/runtime-utils/schema';
 import { ITr2ControllerAction } from './ITr2ControllerAction.js';
 
 let _initProto, _initClass, _init_emitter, _init_extra_emitter, _init_prefix, _init_extra_prefix;
+
+/**
+ * Controller action that sets the event-name prefix on a named audio emitter
+ * when it starts, changing which bank events later sounds resolve to.
+ */
 let _Tr2ActionSetAudioEmi;
 class Tr2ActionSetAudioEmitterPrefix extends CjsModel {
   static {

package/dist/controllers/Tr2ActionSetAudioEmitterPrefix.js.map

@@ -1 +1 @@
-{"version":3,"file":"Tr2ActionSetAudioEmitterPrefix.js","sources":["../../../src/controllers/Tr2ActionSetAudioEmitterPrefix.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\Controllers\\Actions\\Tr2ActionSetAudioEmitterPrefix.h\n// Source: E:\\carbonengine\\trinity\\trinity\\Controllers\\Actions\\Tr2ActionSetAudioEmitterPrefix.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: \"Tr2ActionSetAudioEmitterPrefix\",\n  family: \"controllers\"\n})\nexport class Tr2ActionSetAudioEmitterPrefix extends CjsModel\n{\n  @io.persist\n  @type.string\n  emitter = \"\";\n\n  @io.persist\n  @type.string\n  prefix = \"\";\n\n  /**\n   * Sets the prefix on a named audio emitter.\n   */\n  @carbon.method\n  @impl.adapted\n  Start(controller)\n  {\n    const emitter = ITr2ControllerAction.findSoundEmitter(ITr2ControllerAction.getOwner(controller), this.emitter);\n    if (!ITr2ControllerAction.hasFunction(emitter, \"SetPrefix\"))\n    {\n      return;\n    }\n    emitter.SetPrefix(this.prefix);\n  }\n\n  /**\n   * Starts manually with an explicit controller.\n   */\n  @carbon.method\n  @impl.implemented\n  StartWithController(controller)\n  {\n    this.Start(ITr2ControllerAction.requireController(controller, \"StartWithController\"));\n  }\n}\n"],"names":["_Tr2ActionSetAudioEmi","Tr2ActionSetAudioEmitterPrefix","CjsModel","e","_init_emitter","_init_extra_emitter","_init_prefix","_init_extra_prefix","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","persist","string","carbon","method","impl","adapted","implemented","constructor","args","emitter","prefix","Start","controller","ITr2ControllerAction","findSoundEmitter","getOwner","hasFunction","SetPrefix","StartWithController","requireController"],"mappings":";;;;;;AAIiE,IAAAA;AAGjE,MAAAC,8BAAA,SAIoDC,QAAQ,CAC5D;AAAA,EAAA;AAAA,IAAA,CAAA;MAAAC,CAAA,EAAA,CAAAC,aAAA,EAAAC,mBAAA,EAAAC,YAAA,EAAAC,kBAAA,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,gCAAgC;AAC3CC,MAAAA,MAAM,EAAE;KACT,CAAC,MAGCC,EAAE,EAAFA,EAAE,CAACC,OAAO,EACVL,IAAI,EAAJA,IAAI,CAACM,MAAM,CAAA,EAAA,EAAA,EAAA,SAAA,CAAA,EAAA,CAAA,CAGXF,EAAE,EAAFA,EAAE,CAACC,OAAO,EACVL,IAAI,EAAJA,IAAI,CAACM,MAAM,oBAMXC,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACC,OAAO,CAAA,EAAA,EAAA,EAAA,OAAA,CAAA,EAAA,CAAA,CAcZH,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACE,WAAW,CAAA,EAAA,EAAA,EAAA,qBAAA,CAAA,CAAA,EAAA,CAAA,EAAA,MAAA,EA7BiCrB,QAAQ,CAAA;AAAA;AAAAsB,EAAAA,WAAAA,CAAA,GAAAC,IAAA,EAAA;AAAA,IAAA,KAAA,CAAA,GAAAA,IAAA,CAAA;IAAAlB,kBAAA,CAAA,IAAA,CAAA;AAAA,EAAA;AAI1DmB,EAAAA,OAAO,IAAAlB,UAAA,CAAA,IAAA,CAAA,EAAAJ,aAAA,OAAG,EAAE,CAAA;AAIZuB,EAAAA,MAAM,IAAAtB,mBAAA,CAAA,IAAA,CAAA,EAAAC,YAAA,OAAG,EAAE,CAAA;;AAEX;AACF;AACA;EAGEsB,KAAKA,CAACC,UAAU,EAChB;AACE,IAAA,MAAMH,OAAO,GAAGI,oBAAoB,CAACC,gBAAgB,CAACD,oBAAoB,CAACE,QAAQ,CAACH,UAAU,CAAC,EAAE,IAAI,CAACH,OAAO,CAAC;IAC9G,IAAI,CAACI,oBAAoB,CAACG,WAAW,CAACP,OAAO,EAAE,WAAW,CAAC,EAC3D;AACE,MAAA;AACF,IAAA;AACAA,IAAAA,OAAO,CAACQ,SAAS,CAAC,IAAI,CAACP,MAAM,CAAC;AAChC,EAAA;;AAEA;AACF;AACA;EAGEQ,mBAAmBA,CAACN,UAAU,EAC9B;IACE,IAAI,CAACD,KAAK,CAACE,oBAAoB,CAACM,iBAAiB,CAACP,UAAU,EAAE,qBAAqB,CAAC,CAAC;AACvF,EAAA;AAAC,EAAA;IAAAnB,UAAA,EAAA;AAAA;AACH;;;;"}
+{"version":3,"file":"Tr2ActionSetAudioEmitterPrefix.js","sources":["../../../src/controllers/Tr2ActionSetAudioEmitterPrefix.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\Controllers\\Actions\\Tr2ActionSetAudioEmitterPrefix.h\n// Source: E:\\carbonengine\\trinity\\trinity\\Controllers\\Actions\\Tr2ActionSetAudioEmitterPrefix.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 sets the event-name prefix on a named audio emitter\n * when it starts, changing which bank events later sounds resolve to.\n */\n@type.define({\n  className: \"Tr2ActionSetAudioEmitterPrefix\",\n  family: \"controllers\"\n})\nexport class Tr2ActionSetAudioEmitterPrefix extends CjsModel\n{\n  @io.persist\n  @type.string\n  emitter = \"\";\n\n  @io.persist\n  @type.string\n  prefix = \"\";\n\n  /**\n   * Sets the prefix on a named audio emitter.\n   */\n  @carbon.method\n  @impl.adapted\n  Start(controller)\n  {\n    const emitter = ITr2ControllerAction.findSoundEmitter(ITr2ControllerAction.getOwner(controller), this.emitter);\n    if (!ITr2ControllerAction.hasFunction(emitter, \"SetPrefix\"))\n    {\n      return;\n    }\n    emitter.SetPrefix(this.prefix);\n  }\n\n  /**\n   * Starts manually with an explicit controller.\n   */\n  @carbon.method\n  @impl.implemented\n  StartWithController(controller)\n  {\n    this.Start(ITr2ControllerAction.requireController(controller, \"StartWithController\"));\n  }\n}\n"],"names":["_Tr2ActionSetAudioEmi","Tr2ActionSetAudioEmitterPrefix","CjsModel","e","_init_emitter","_init_extra_emitter","_init_prefix","_init_extra_prefix","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","persist","string","carbon","method","impl","adapted","implemented","constructor","args","emitter","prefix","Start","controller","ITr2ControllerAction","findSoundEmitter","getOwner","hasFunction","SetPrefix","StartWithController","requireController"],"mappings":";;;;;;;AAOA;AACA;AACA;AACA;AAHA,IAAAA;AAIA,MAAAC,8BAAA,SAIoDC,QAAQ,CAC5D;AAAA,EAAA;AAAA,IAAA,CAAA;MAAAC,CAAA,EAAA,CAAAC,aAAA,EAAAC,mBAAA,EAAAC,YAAA,EAAAC,kBAAA,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,gCAAgC;AAC3CC,MAAAA,MAAM,EAAE;KACT,CAAC,MAGCC,EAAE,EAAFA,EAAE,CAACC,OAAO,EACVL,IAAI,EAAJA,IAAI,CAACM,MAAM,CAAA,EAAA,EAAA,EAAA,SAAA,CAAA,EAAA,CAAA,CAGXF,EAAE,EAAFA,EAAE,CAACC,OAAO,EACVL,IAAI,EAAJA,IAAI,CAACM,MAAM,oBAMXC,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACC,OAAO,CAAA,EAAA,EAAA,EAAA,OAAA,CAAA,EAAA,CAAA,CAcZH,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACE,WAAW,CAAA,EAAA,EAAA,EAAA,qBAAA,CAAA,CAAA,EAAA,CAAA,EAAA,MAAA,EA7BiCrB,QAAQ,CAAA;AAAA;AAAAsB,EAAAA,WAAAA,CAAA,GAAAC,IAAA,EAAA;AAAA,IAAA,KAAA,CAAA,GAAAA,IAAA,CAAA;IAAAlB,kBAAA,CAAA,IAAA,CAAA;AAAA,EAAA;AAI1DmB,EAAAA,OAAO,IAAAlB,UAAA,CAAA,IAAA,CAAA,EAAAJ,aAAA,OAAG,EAAE,CAAA;AAIZuB,EAAAA,MAAM,IAAAtB,mBAAA,CAAA,IAAA,CAAA,EAAAC,YAAA,OAAG,EAAE,CAAA;;AAEX;AACF;AACA;EAGEsB,KAAKA,CAACC,UAAU,EAChB;AACE,IAAA,MAAMH,OAAO,GAAGI,oBAAoB,CAACC,gBAAgB,CAACD,oBAAoB,CAACE,QAAQ,CAACH,UAAU,CAAC,EAAE,IAAI,CAACH,OAAO,CAAC;IAC9G,IAAI,CAACI,oBAAoB,CAACG,WAAW,CAACP,OAAO,EAAE,WAAW,CAAC,EAC3D;AACE,MAAA;AACF,IAAA;AACAA,IAAAA,OAAO,CAACQ,SAAS,CAAC,IAAI,CAACP,MAAM,CAAC;AAChC,EAAA;;AAEA;AACF;AACA;EAGEQ,mBAAmBA,CAACN,UAAU,EAC9B;IACE,IAAI,CAACD,KAAK,CAACE,oBAAoB,CAACM,iBAAiB,CAACP,UAAU,EAAE,qBAAqB,CAAC,CAAC;AACvF,EAAA;AAAC,EAAA;IAAAnB,UAAA,EAAA;AAAA;AACH;;;;"}

package/dist/controllers/Tr2ActionSetAudioSwitch.js

@@ -4,6 +4,11 @@ import { io, type, carbon, impl } from '@carbonenginejs/runtime-utils/schema';
 import { ITr2ControllerAction } from './ITr2ControllerAction.js';
 
 let _initProto, _initClass, _init_emitter, _init_extra_emitter, _init_switchGroup, _init_extra_switchGroup, _init_switchState, _init_extra_switchState;
+
+/**
+ * Controller action that sets a Wwise switch group to a given state on a named
+ * audio emitter when it starts.
+ */
 let _Tr2ActionSetAudioSwi;
 class Tr2ActionSetAudioSwitch extends CjsModel {
   static {

package/dist/controllers/Tr2ActionSetAudioSwitch.js.map

@@ -1 +1 @@
-{"version":3,"file":"Tr2ActionSetAudioSwitch.js","sources":["../../../src/controllers/Tr2ActionSetAudioSwitch.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\Controllers\\Actions\\Tr2ActionSetAudioSwitch.h\n// Source: E:\\carbonengine\\trinity\\trinity\\Controllers\\Actions\\Tr2ActionSetAudioSwitch.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: \"Tr2ActionSetAudioSwitch\",\n  family: \"controllers\"\n})\nexport class Tr2ActionSetAudioSwitch extends CjsModel\n{\n  @io.persist\n  @type.string\n  emitter = \"\";\n\n  @io.persist\n  @type.string\n  switchGroup = \"\";\n\n  @io.persist\n  @type.string\n  switchState = \"\";\n\n  /**\n   * Sets a Wwise-style switch on a named emitter.\n   */\n  @carbon.method\n  @impl.adapted\n  Start(controller)\n  {\n    const emitter = ITr2ControllerAction.findSoundEmitter(ITr2ControllerAction.getOwner(controller), this.emitter);\n    if (!ITr2ControllerAction.hasFunction(emitter, \"SetSwitch\"))\n    {\n      return;\n    }\n    emitter.SetSwitch(this.switchGroup, this.switchState);\n  }\n\n  /**\n   * Starts manually with an explicit controller.\n   */\n  @carbon.method\n  @impl.implemented\n  StartWithController(controller)\n  {\n    this.Start(ITr2ControllerAction.requireController(controller, \"StartWithController\"));\n  }\n}\n"],"names":["_Tr2ActionSetAudioSwi","Tr2ActionSetAudioSwitch","CjsModel","e","_init_emitter","_init_extra_emitter","_init_switchGroup","_init_extra_switchGroup","_init_switchState","_init_extra_switchState","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","persist","string","carbon","method","impl","adapted","implemented","constructor","args","emitter","switchGroup","switchState","Start","controller","ITr2ControllerAction","findSoundEmitter","getOwner","hasFunction","SetSwitch","StartWithController","requireController"],"mappings":";;;;;;AAIiE,IAAAA;AAGjE,MAAAC,uBAAA,SAI6CC,QAAQ,CACrD;AAAA,EAAA;AAAA,IAAA,CAAA;AAAAC,MAAAA,CAAA,EAAA,CAAAC,aAAA,EAAAC,mBAAA,EAAAC,iBAAA,EAAAC,uBAAA,EAAAC,iBAAA,EAAAC,uBAAA,EAAAC,UAAA,CAAA;MAAAC,CAAA,EAAA,CAAAX,qBAAA,EAAAY,UAAA;AAAA,KAAA,GAAAC,cAAA,CAAA,IAAA,EAAA,CALCC,IAAI,CAACC,MAAM,CAAC;AACXC,MAAAA,SAAS,EAAE,yBAAyB;AACpCC,MAAAA,MAAM,EAAE;AACV,KAAC,CAAC,CAAA,EAAA,CAAA,CAAA,CAGCC,EAAE,EAAFA,EAAE,CAACC,OAAO,EACVL,IAAI,EAAJA,IAAI,CAACM,MAAM,CAAA,EAAA,EAAA,EAAA,SAAA,CAAA,EAAA,CAAA,CAGXF,EAAE,EAAFA,EAAE,CAACC,OAAO,EACVL,IAAI,EAAJA,IAAI,CAACM,MAAM,CAAA,EAAA,EAAA,EAAA,aAAA,CAAA,EAAA,CAAA,CAGXF,EAAE,EAAFA,EAAE,CAACC,OAAO,EACVL,IAAI,EAAJA,IAAI,CAACM,MAAM,CAAA,EAAA,EAAA,EAAA,aAAA,CAAA,EAAA,CAAA,CAMXC,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACC,OAAO,CAAA,EAAA,EAAA,EAAA,OAAA,CAAA,EAAA,CAAA,CAcZH,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACE,WAAW,2CAjC0BvB,QAAQ,CAAA;AAAA;AAAAwB,EAAAA,WAAAA,CAAA,GAAAC,IAAA,EAAA;AAAA,IAAA,KAAA,CAAA,GAAAA,IAAA,CAAA;IAAAlB,uBAAA,CAAA,IAAA,CAAA;AAAA,EAAA;AAInDmB,EAAAA,OAAO,IAAAlB,UAAA,CAAA,IAAA,CAAA,EAAAN,aAAA,OAAG,EAAE,CAAA;AAIZyB,EAAAA,WAAW,IAAAxB,mBAAA,CAAA,IAAA,CAAA,EAAAC,iBAAA,OAAG,EAAE,CAAA;AAIhBwB,EAAAA,WAAW,IAAAvB,uBAAA,CAAA,IAAA,CAAA,EAAAC,iBAAA,OAAG,EAAE,CAAA;;AAEhB;AACF;AACA;EAGEuB,KAAKA,CAACC,UAAU,EAChB;AACE,IAAA,MAAMJ,OAAO,GAAGK,oBAAoB,CAACC,gBAAgB,CAACD,oBAAoB,CAACE,QAAQ,CAACH,UAAU,CAAC,EAAE,IAAI,CAACJ,OAAO,CAAC;IAC9G,IAAI,CAACK,oBAAoB,CAACG,WAAW,CAACR,OAAO,EAAE,WAAW,CAAC,EAC3D;AACE,MAAA;AACF,IAAA;IACAA,OAAO,CAACS,SAAS,CAAC,IAAI,CAACR,WAAW,EAAE,IAAI,CAACC,WAAW,CAAC;AACvD,EAAA;;AAEA;AACF;AACA;EAGEQ,mBAAmBA,CAACN,UAAU,EAC9B;IACE,IAAI,CAACD,KAAK,CAACE,oBAAoB,CAACM,iBAAiB,CAACP,UAAU,EAAE,qBAAqB,CAAC,CAAC;AACvF,EAAA;AAAC,EAAA;IAAApB,UAAA,EAAA;AAAA;AACH;;;;"}
+{"version":3,"file":"Tr2ActionSetAudioSwitch.js","sources":["../../../src/controllers/Tr2ActionSetAudioSwitch.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\Controllers\\Actions\\Tr2ActionSetAudioSwitch.h\n// Source: E:\\carbonengine\\trinity\\trinity\\Controllers\\Actions\\Tr2ActionSetAudioSwitch.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 sets a Wwise switch group to a given state on a named\n * audio emitter when it starts.\n */\n@type.define({\n  className: \"Tr2ActionSetAudioSwitch\",\n  family: \"controllers\"\n})\nexport class Tr2ActionSetAudioSwitch extends CjsModel\n{\n  @io.persist\n  @type.string\n  emitter = \"\";\n\n  @io.persist\n  @type.string\n  switchGroup = \"\";\n\n  @io.persist\n  @type.string\n  switchState = \"\";\n\n  /**\n   * Sets a Wwise-style switch on a named emitter.\n   */\n  @carbon.method\n  @impl.adapted\n  Start(controller)\n  {\n    const emitter = ITr2ControllerAction.findSoundEmitter(ITr2ControllerAction.getOwner(controller), this.emitter);\n    if (!ITr2ControllerAction.hasFunction(emitter, \"SetSwitch\"))\n    {\n      return;\n    }\n    emitter.SetSwitch(this.switchGroup, this.switchState);\n  }\n\n  /**\n   * Starts manually with an explicit controller.\n   */\n  @carbon.method\n  @impl.implemented\n  StartWithController(controller)\n  {\n    this.Start(ITr2ControllerAction.requireController(controller, \"StartWithController\"));\n  }\n}\n"],"names":["_Tr2ActionSetAudioSwi","Tr2ActionSetAudioSwitch","CjsModel","e","_init_emitter","_init_extra_emitter","_init_switchGroup","_init_extra_switchGroup","_init_switchState","_init_extra_switchState","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","persist","string","carbon","method","impl","adapted","implemented","constructor","args","emitter","switchGroup","switchState","Start","controller","ITr2ControllerAction","findSoundEmitter","getOwner","hasFunction","SetSwitch","StartWithController","requireController"],"mappings":";;;;;;;AAOA;AACA;AACA;AACA;AAHA,IAAAA;AAIA,MAAAC,uBAAA,SAI6CC,QAAQ,CACrD;AAAA,EAAA;AAAA,IAAA,CAAA;AAAAC,MAAAA,CAAA,EAAA,CAAAC,aAAA,EAAAC,mBAAA,EAAAC,iBAAA,EAAAC,uBAAA,EAAAC,iBAAA,EAAAC,uBAAA,EAAAC,UAAA,CAAA;MAAAC,CAAA,EAAA,CAAAX,qBAAA,EAAAY,UAAA;AAAA,KAAA,GAAAC,cAAA,CAAA,IAAA,EAAA,CALCC,IAAI,CAACC,MAAM,CAAC;AACXC,MAAAA,SAAS,EAAE,yBAAyB;AACpCC,MAAAA,MAAM,EAAE;AACV,KAAC,CAAC,CAAA,EAAA,CAAA,CAAA,CAGCC,EAAE,EAAFA,EAAE,CAACC,OAAO,EACVL,IAAI,EAAJA,IAAI,CAACM,MAAM,CAAA,EAAA,EAAA,EAAA,SAAA,CAAA,EAAA,CAAA,CAGXF,EAAE,EAAFA,EAAE,CAACC,OAAO,EACVL,IAAI,EAAJA,IAAI,CAACM,MAAM,CAAA,EAAA,EAAA,EAAA,aAAA,CAAA,EAAA,CAAA,CAGXF,EAAE,EAAFA,EAAE,CAACC,OAAO,EACVL,IAAI,EAAJA,IAAI,CAACM,MAAM,CAAA,EAAA,EAAA,EAAA,aAAA,CAAA,EAAA,CAAA,CAMXC,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACC,OAAO,CAAA,EAAA,EAAA,EAAA,OAAA,CAAA,EAAA,CAAA,CAcZH,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACE,WAAW,2CAjC0BvB,QAAQ,CAAA;AAAA;AAAAwB,EAAAA,WAAAA,CAAA,GAAAC,IAAA,EAAA;AAAA,IAAA,KAAA,CAAA,GAAAA,IAAA,CAAA;IAAAlB,uBAAA,CAAA,IAAA,CAAA;AAAA,EAAA;AAInDmB,EAAAA,OAAO,IAAAlB,UAAA,CAAA,IAAA,CAAA,EAAAN,aAAA,OAAG,EAAE,CAAA;AAIZyB,EAAAA,WAAW,IAAAxB,mBAAA,CAAA,IAAA,CAAA,EAAAC,iBAAA,OAAG,EAAE,CAAA;AAIhBwB,EAAAA,WAAW,IAAAvB,uBAAA,CAAA,IAAA,CAAA,EAAAC,iBAAA,OAAG,EAAE,CAAA;;AAEhB;AACF;AACA;EAGEuB,KAAKA,CAACC,UAAU,EAChB;AACE,IAAA,MAAMJ,OAAO,GAAGK,oBAAoB,CAACC,gBAAgB,CAACD,oBAAoB,CAACE,QAAQ,CAACH,UAAU,CAAC,EAAE,IAAI,CAACJ,OAAO,CAAC;IAC9G,IAAI,CAACK,oBAAoB,CAACG,WAAW,CAACR,OAAO,EAAE,WAAW,CAAC,EAC3D;AACE,MAAA;AACF,IAAA;IACAA,OAAO,CAACS,SAAS,CAAC,IAAI,CAACR,WAAW,EAAE,IAAI,CAACC,WAAW,CAAC;AACvD,EAAA;;AAEA;AACF;AACA;EAGEQ,mBAAmBA,CAACN,UAAU,EAC9B;IACE,IAAI,CAACD,KAAK,CAACE,oBAAoB,CAACM,iBAAiB,CAACP,UAAU,EAAE,qBAAqB,CAAC,CAAC;AACvF,EAAA;AAAC,EAAA;IAAApB,UAAA,EAAA;AAAA;AACH;;;;"}

package/dist/controllers/Tr2ActionSetExternalControllerVariable.js

@@ -4,6 +4,12 @@ import { io, type, carbon, impl } from '@carbonenginejs/runtime-utils/schema';
 import { ITr2ControllerAction } from './ITr2ControllerAction.js';
 
 let _initProto, _initClass, _init_destination, _init_extra_destination, _init_destinationOwner, _init_extra_destinationOwner, _init_variable, _init_extra_variable, _init_value, _init_extra_value, _init_sourceVariable, _init_extra_sourceVariable, _init_startControllers, _init_extra_startControllers;
+
+/**
+ * Controller action that writes a constant or source-variable value into a
+ * controller variable on a different object, named by destinationOwner among the
+ * owner's binding roots.
+ */
 let _Tr2ActionSetExternal;
 new class extends _identity {
   static [class Tr2ActionSetExternalControllerVariable extends CjsModel {
@@ -88,6 +94,12 @@ new class extends _identity {
     IsVariableValid() {
       return !!this.variable;
     }
+
+    /**
+     * Resolves `destination` by case-insensitively matching destinationOwner
+     * against the owner's binding roots, and records the name it resolved against
+     * so OnModified can detect a real change.
+     */
     #linkToDestinationOwner() {
       this.#linkedOwner = this.destinationOwner;
       this.destination = null;
@@ -107,6 +119,17 @@ new class extends _identity {
         }
       }
     }
+
+    /**
+     * Writes the value through the destination's SetControllerVariable, returning
+     * false when the destination or variable name is missing or the method is
+     * absent.
+     */
+
+    /**
+     * Normalizes an owner's binding roots into name/value pairs, accepting an
+     * array, a Map, a `bindingRoots` property or a plain object.
+     */
   }];
   #setControllerVariable(destination, variable, value) {
     if (!destination || !variable) {

package/dist/controllers/Tr2ActionSetExternalControllerVariable.js.map

@@ -1 +1 @@
-{"version":3,"file":"Tr2ActionSetExternalControllerVariable.js","sources":["../../../src/controllers/Tr2ActionSetExternalControllerVariable.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\Controllers\\Actions\\Tr2ActionSetExternalControllerVariable.h\r\n// Source: E:\\carbonengine\\trinity\\trinity\\Controllers\\Actions\\Tr2ActionSetExternalControllerVariable.cpp\r\nimport { CjsModel } from \"@carbonenginejs/runtime-utils/model\";\r\nimport { carbon, impl, io, type } from \"@carbonenginejs/runtime-utils/schema\";\r\nimport { ITr2ControllerAction } from \"./ITr2ControllerAction.js\";\r\n\r\n\r\n@type.define({\r\n  className: \"Tr2ActionSetExternalControllerVariable\",\r\n  family: \"controllers\"\r\n})\r\nexport class Tr2ActionSetExternalControllerVariable extends CjsModel\r\n{\r\n  @io.read\n  @type.objectRef(\"IRoot\")\n  destination = null;\n\r\n  @io.notify\r\n  @io.persist\r\n  @type.string\r\n  destinationOwner = \"\";\r\n\r\n  @io.persist\r\n  @type.string\r\n  variable = \"\";\r\n\r\n  @io.persist\r\n  @type.float32\r\n  value = 0;\r\n\r\n  @io.persist\r\n  @type.string\r\n  sourceVariable = \"\";\r\n\r\n  @io.persist\r\n  @type.boolean\r\n  startControllers = false;\r\n\r\n  #controller = null;\r\n\r\n  #linkedOwner = null;\r\n\r\n  /**\r\n   * Links to the destination owner.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  Link(controller)\r\n  {\r\n    this.#controller = controller;\r\n    this.#linkToDestinationOwner();\r\n  }\r\n\r\n  /**\r\n   * Clears the destination owner.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  Unlink()\r\n  {\r\n    this.destination = null;\r\n    this.#controller = null;\r\n  }\r\n\r\n  /**\r\n   * Sets the external controller variable.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  Start(controller = this.#controller)\r\n  {\r\n    if (!controller)\r\n    {\r\n      return;\r\n    }\r\n    this.#controller = controller;\r\n    if (!this.destination)\r\n    {\r\n      this.#linkToDestinationOwner();\r\n    }\r\n    const value = this.sourceVariable ? ITr2ControllerAction.toNumber(this.#controller?.GetFloatVariableByName?.(this.sourceVariable), this.value) : this.value;\r\n    if (!this.IsDestinationValid())\r\n    {\r\n      return;\r\n    }\r\n    if (this.startControllers)\r\n    {\r\n      ITr2ControllerAction.callTarget(this.destination, \"StartControllers\");\r\n    }\r\n    Tr2ActionSetExternalControllerVariable.#setControllerVariable(this.destination, this.variable, value);\r\n  }\r\n\r\n  /**\r\n   * Relinks the destination when the authored owner name changed since the\r\n   * last link (Carbon gates on the m_destinationOwner notification;\r\n   * broad-safe here means comparing against the cached linked owner rather\r\n   * than a changed-property list).\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  OnModified(_options = {})\r\n  {\r\n    if (this.destinationOwner !== this.#linkedOwner)\r\n    {\r\n      this.#linkToDestinationOwner();\r\n    }\r\n    return true;\r\n  }\r\n\r\n  /**\r\n   * Checks whether the destination owner resolved.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  IsDestinationValid()\r\n  {\r\n    return !!this.destination;\r\n  }\r\n\r\n  /**\r\n   * Checks whether a target variable name is authored.\r\n   */\r\n  IsVariableValid()\r\n  {\r\n    return !!this.variable;\r\n  }\r\n  #linkToDestinationOwner()\r\n  {\r\n    this.#linkedOwner = this.destinationOwner;\r\n    this.destination = null;\r\n    if (!this.#controller)\r\n    {\r\n      return;\r\n    }\r\n    const owner = ITr2ControllerAction.getOwner(this.#controller);\r\n    const roots = Tr2ActionSetExternalControllerVariable.#getBindingRoots(owner);\r\n    const destinationOwner = this.destinationOwner.toLowerCase();\r\n    if (!destinationOwner)\r\n    {\r\n      return;\r\n    }\r\n    for (const [name, value] of roots)\r\n    {\r\n      if (name.toLowerCase() === destinationOwner)\r\n      {\r\n        this.destination = value;\r\n        return;\r\n      }\r\n    }\r\n  }\r\n\r\n  static #setControllerVariable(destination, variable, value)\r\n  {\r\n    if (!destination || !variable)\r\n    {\r\n      return false;\r\n    }\r\n    if (ITr2ControllerAction.hasFunction(destination, \"SetControllerVariable\"))\r\n    {\r\n      destination.SetControllerVariable(variable, value);\r\n      return true;\r\n    }\r\n    return false;\r\n  }\r\n\r\n  static #getBindingRoots(owner)\r\n  {\r\n    const roots = ITr2ControllerAction.callTarget(owner, \"GetBindingRoots\");\r\n    if (Array.isArray(roots))\r\n    {\r\n      return roots.map(entry => [String(entry[0] ?? \"\"), entry[1]]);\r\n    }\r\n    if (roots instanceof Map)\r\n    {\r\n      return Array.from(roots.entries()).map(([name, value]) => [String(name), value]);\r\n    }\r\n    if (ITr2ControllerAction.hasProperty(owner, \"bindingRoots\"))\r\n    {\r\n      return Object.entries(owner.bindingRoots);\r\n    }\r\n    if (roots && typeof roots === \"object\")\r\n    {\r\n      return Object.entries(roots);\r\n    }\r\n    return [];\r\n  }\r\n}\r\n"],"names":["_Tr2ActionSetExternal","_identity","Tr2ActionSetExternalControllerVariable","CjsModel","e","_init_destination","_init_extra_destination","_init_destinationOwner","_init_extra_destinationOwner","_init_variable","_init_extra_variable","_init_value","_init_extra_value","_init_sourceVariable","_init_extra_sourceVariable","_init_startControllers","_init_extra_startControllers","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","read","objectRef","notify","persist","string","float32","boolean","carbon","method","impl","adapted","implemented","destination","destinationOwner","variable","value","sourceVariable","startControllers","Link","controller","Unlink","Start","ITr2ControllerAction","toNumber","GetFloatVariableByName","IsDestinationValid","callTarget","OnModified","_options","IsVariableValid","#linkToDestinationOwner","owner","getOwner","roots","toLowerCase","name","#setControllerVariable","hasFunction","SetControllerVariable","#getBindingRoots","Array","isArray","map","entry","String","Map","from","entries","hasProperty","Object","bindingRoots","constructor"],"mappings":"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"}
+{"version":3,"file":"Tr2ActionSetExternalControllerVariable.js","sources":["../../../src/controllers/Tr2ActionSetExternalControllerVariable.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\Controllers\\Actions\\Tr2ActionSetExternalControllerVariable.h\r\n// Source: E:\\carbonengine\\trinity\\trinity\\Controllers\\Actions\\Tr2ActionSetExternalControllerVariable.cpp\r\nimport { CjsModel } from \"@carbonenginejs/runtime-utils/model\";\r\nimport { carbon, impl, io, type } from \"@carbonenginejs/runtime-utils/schema\";\r\nimport { ITr2ControllerAction } from \"./ITr2ControllerAction.js\";\r\n\r\n\r\n/**\r\n * Controller action that writes a constant or source-variable value into a\r\n * controller variable on a different object, named by destinationOwner among the\r\n * owner's binding roots.\r\n */\r\n@type.define({\r\n  className: \"Tr2ActionSetExternalControllerVariable\",\r\n  family: \"controllers\"\r\n})\r\nexport class Tr2ActionSetExternalControllerVariable extends CjsModel\r\n{\r\n  @io.read\r\n  @type.objectRef(\"IRoot\")\r\n  destination = null;\r\n\r\n  @io.notify\r\n  @io.persist\r\n  @type.string\r\n  destinationOwner = \"\";\r\n\r\n  @io.persist\r\n  @type.string\r\n  variable = \"\";\r\n\r\n  @io.persist\r\n  @type.float32\r\n  value = 0;\r\n\r\n  @io.persist\r\n  @type.string\r\n  sourceVariable = \"\";\r\n\r\n  @io.persist\r\n  @type.boolean\r\n  startControllers = false;\r\n\r\n  #controller = null;\r\n\r\n  #linkedOwner = null;\r\n\r\n  /**\r\n   * Links to the destination owner.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  Link(controller)\r\n  {\r\n    this.#controller = controller;\r\n    this.#linkToDestinationOwner();\r\n  }\r\n\r\n  /**\r\n   * Clears the destination owner.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  Unlink()\r\n  {\r\n    this.destination = null;\r\n    this.#controller = null;\r\n  }\r\n\r\n  /**\r\n   * Sets the external controller variable.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  Start(controller = this.#controller)\r\n  {\r\n    if (!controller)\r\n    {\r\n      return;\r\n    }\r\n    this.#controller = controller;\r\n    if (!this.destination)\r\n    {\r\n      this.#linkToDestinationOwner();\r\n    }\r\n    const value = this.sourceVariable ? ITr2ControllerAction.toNumber(this.#controller?.GetFloatVariableByName?.(this.sourceVariable), this.value) : this.value;\r\n    if (!this.IsDestinationValid())\r\n    {\r\n      return;\r\n    }\r\n    if (this.startControllers)\r\n    {\r\n      ITr2ControllerAction.callTarget(this.destination, \"StartControllers\");\r\n    }\r\n    Tr2ActionSetExternalControllerVariable.#setControllerVariable(this.destination, this.variable, value);\r\n  }\r\n\r\n  /**\r\n   * Relinks the destination when the authored owner name changed since the\r\n   * last link (Carbon gates on the m_destinationOwner notification;\r\n   * broad-safe here means comparing against the cached linked owner rather\r\n   * than a changed-property list).\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  OnModified(_options = {})\r\n  {\r\n    if (this.destinationOwner !== this.#linkedOwner)\r\n    {\r\n      this.#linkToDestinationOwner();\r\n    }\r\n    return true;\r\n  }\r\n\r\n  /**\r\n   * Checks whether the destination owner resolved.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  IsDestinationValid()\r\n  {\r\n    return !!this.destination;\r\n  }\r\n\r\n  /**\r\n   * Checks whether a target variable name is authored.\r\n   */\r\n  IsVariableValid()\r\n  {\r\n    return !!this.variable;\r\n  }\r\n\r\n  /**\r\n   * Resolves `destination` by case-insensitively matching destinationOwner\r\n   * against the owner's binding roots, and records the name it resolved against\r\n   * so OnModified can detect a real change.\r\n   */\r\n  #linkToDestinationOwner()\r\n  {\r\n    this.#linkedOwner = this.destinationOwner;\r\n    this.destination = null;\r\n    if (!this.#controller)\r\n    {\r\n      return;\r\n    }\r\n    const owner = ITr2ControllerAction.getOwner(this.#controller);\r\n    const roots = Tr2ActionSetExternalControllerVariable.#getBindingRoots(owner);\r\n    const destinationOwner = this.destinationOwner.toLowerCase();\r\n    if (!destinationOwner)\r\n    {\r\n      return;\r\n    }\r\n    for (const [name, value] of roots)\r\n    {\r\n      if (name.toLowerCase() === destinationOwner)\r\n      {\r\n        this.destination = value;\r\n        return;\r\n      }\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Writes the value through the destination's SetControllerVariable, returning\r\n   * false when the destination or variable name is missing or the method is\r\n   * absent.\r\n   */\r\n  static #setControllerVariable(destination, variable, value)\r\n  {\r\n    if (!destination || !variable)\r\n    {\r\n      return false;\r\n    }\r\n    if (ITr2ControllerAction.hasFunction(destination, \"SetControllerVariable\"))\r\n    {\r\n      destination.SetControllerVariable(variable, value);\r\n      return true;\r\n    }\r\n    return false;\r\n  }\r\n\r\n  /**\r\n   * Normalizes an owner's binding roots into name/value pairs, accepting an\r\n   * array, a Map, a `bindingRoots` property or a plain object.\r\n   */\r\n  static #getBindingRoots(owner)\r\n  {\r\n    const roots = ITr2ControllerAction.callTarget(owner, \"GetBindingRoots\");\r\n    if (Array.isArray(roots))\r\n    {\r\n      return roots.map(entry => [String(entry[0] ?? \"\"), entry[1]]);\r\n    }\r\n    if (roots instanceof Map)\r\n    {\r\n      return Array.from(roots.entries()).map(([name, value]) => [String(name), value]);\r\n    }\r\n    if (ITr2ControllerAction.hasProperty(owner, \"bindingRoots\"))\r\n    {\r\n      return Object.entries(owner.bindingRoots);\r\n    }\r\n    if (roots && typeof roots === \"object\")\r\n    {\r\n      return Object.entries(roots);\r\n    }\r\n    return [];\r\n  }\r\n}\r\n"],"names":["_Tr2ActionSetExternal","_identity","Tr2ActionSetExternalControllerVariable","CjsModel","e","_init_destination","_init_extra_destination","_init_destinationOwner","_init_extra_destinationOwner","_init_variable","_init_extra_variable","_init_value","_init_extra_value","_init_sourceVariable","_init_extra_sourceVariable","_init_startControllers","_init_extra_startControllers","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","read","objectRef","notify","persist","string","float32","boolean","carbon","method","impl","adapted","implemented","destination","destinationOwner","variable","value","sourceVariable","startControllers","Link","controller","Unlink","Start","ITr2ControllerAction","toNumber","GetFloatVariableByName","IsDestinationValid","callTarget","OnModified","_options","IsVariableValid","#linkToDestinationOwner","owner","getOwner","roots","toLowerCase","name","#setControllerVariable","hasFunction","SetControllerVariable","#getBindingRoots","Array","isArray","map","entry","String","Map","from","entries","hasProperty","Object","bindingRoots","constructor"],"mappings":"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"}

package/dist/controllers/Tr2ActionSetShaderOption.js

@@ -4,6 +4,11 @@ import { io, type, carbon, impl } from '@carbonenginejs/runtime-utils/schema';
 import { ITr2ControllerAction } from './ITr2ControllerAction.js';
 
 let _initProto, _initClass, _init_key, _init_extra_key, _init_value, _init_extra_value;
+
+/**
+ * Controller action that sets a named shader option on its owner when it starts,
+ * changing which shader permutation the owner renders with.
+ */
 let _Tr2ActionSetShaderOp;
 class Tr2ActionSetShaderOption extends CjsModel {
   static {

package/dist/controllers/Tr2ActionSetShaderOption.js.map

@@ -1 +1 @@
-{"version":3,"file":"Tr2ActionSetShaderOption.js","sources":["../../../src/controllers/Tr2ActionSetShaderOption.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\Controllers\\Actions\\Tr2ActionSetShaderOption.h\n// Source: E:\\carbonengine\\trinity\\trinity\\Controllers\\Actions\\Tr2ActionSetShaderOption.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: \"Tr2ActionSetShaderOption\",\n  family: \"controllers\"\n})\nexport class Tr2ActionSetShaderOption extends CjsModel\n{\n  @io.persist\n  @type.string\n  key = \"\";\n\n  @io.persist\n  @type.string\n  value = \"\";\n\n  /**\n   * Sets a shader option on the controller owner when supported.\n   */\n  @carbon.method\n  @impl.adapted\n  Start(controller)\n  {\n    const owner = ITr2ControllerAction.getOwner(controller);\n    if (!ITr2ControllerAction.hasFunction(owner, \"SetShaderOption\"))\n    {\n      return;\n    }\n    owner.SetShaderOption(this.key, this.value);\n  }\n}\n"],"names":["_Tr2ActionSetShaderOp","Tr2ActionSetShaderOption","CjsModel","e","_init_key","_init_extra_key","_init_value","_init_extra_value","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","persist","string","carbon","method","impl","adapted","constructor","args","key","value","Start","controller","owner","ITr2ControllerAction","getOwner","hasFunction","SetShaderOption"],"mappings":";;;;;;AAIiE,IAAAA;AAGjE,MAAAC,wBAAA,SAI8CC,QAAQ,CACtD;AAAA,EAAA;AAAA,IAAA,CAAA;MAAAC,CAAA,EAAA,CAAAC,SAAA,EAAAC,eAAA,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,0BAA0B;AACrCC,MAAAA,MAAM,EAAE;AACV,KAAC,CAAC,CAAA,EAAA,CAAA,CAAA,CAGCC,EAAE,EAAFA,EAAE,CAACC,OAAO,EACVL,IAAI,EAAJA,IAAI,CAACM,MAAM,iBAGXF,EAAE,EAAFA,EAAE,CAACC,OAAO,EACVL,IAAI,EAAJA,IAAI,CAACM,MAAM,CAAA,EAAA,EAAA,EAAA,OAAA,CAAA,EAAA,CAAA,CAMXC,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACC,OAAO,6BAd+BpB,QAAQ,CAAA;AAAA;AAAAqB,EAAAA,WAAAA,CAAA,GAAAC,IAAA,EAAA;AAAA,IAAA,KAAA,CAAA,GAAAA,IAAA,CAAA;IAAAjB,iBAAA,CAAA,IAAA,CAAA;AAAA,EAAA;AAIpDkB,EAAAA,GAAG,IAAAjB,UAAA,CAAA,IAAA,CAAA,EAAAJ,SAAA,OAAG,EAAE,CAAA;AAIRsB,EAAAA,KAAK,IAAArB,eAAA,CAAA,IAAA,CAAA,EAAAC,WAAA,OAAG,EAAE,CAAA;;AAEV;AACF;AACA;EAGEqB,KAAKA,CAACC,UAAU,EAChB;AACE,IAAA,MAAMC,KAAK,GAAGC,oBAAoB,CAACC,QAAQ,CAACH,UAAU,CAAC;IACvD,IAAI,CAACE,oBAAoB,CAACE,WAAW,CAACH,KAAK,EAAE,iBAAiB,CAAC,EAC/D;AACE,MAAA;AACF,IAAA;IACAA,KAAK,CAACI,eAAe,CAAC,IAAI,CAACR,GAAG,EAAE,IAAI,CAACC,KAAK,CAAC;AAC7C,EAAA;AAAC,EAAA;IAAAhB,UAAA,EAAA;AAAA;AACH;;;;"}
+{"version":3,"file":"Tr2ActionSetShaderOption.js","sources":["../../../src/controllers/Tr2ActionSetShaderOption.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\Controllers\\Actions\\Tr2ActionSetShaderOption.h\n// Source: E:\\carbonengine\\trinity\\trinity\\Controllers\\Actions\\Tr2ActionSetShaderOption.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 sets a named shader option on its owner when it starts,\n * changing which shader permutation the owner renders with.\n */\n@type.define({\n  className: \"Tr2ActionSetShaderOption\",\n  family: \"controllers\"\n})\nexport class Tr2ActionSetShaderOption extends CjsModel\n{\n  @io.persist\n  @type.string\n  key = \"\";\n\n  @io.persist\n  @type.string\n  value = \"\";\n\n  /**\n   * Sets a shader option on the controller owner when supported.\n   */\n  @carbon.method\n  @impl.adapted\n  Start(controller)\n  {\n    const owner = ITr2ControllerAction.getOwner(controller);\n    if (!ITr2ControllerAction.hasFunction(owner, \"SetShaderOption\"))\n    {\n      return;\n    }\n    owner.SetShaderOption(this.key, this.value);\n  }\n}\n"],"names":["_Tr2ActionSetShaderOp","Tr2ActionSetShaderOption","CjsModel","e","_init_key","_init_extra_key","_init_value","_init_extra_value","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","persist","string","carbon","method","impl","adapted","constructor","args","key","value","Start","controller","owner","ITr2ControllerAction","getOwner","hasFunction","SetShaderOption"],"mappings":";;;;;;;AAOA;AACA;AACA;AACA;AAHA,IAAAA;AAIA,MAAAC,wBAAA,SAI8CC,QAAQ,CACtD;AAAA,EAAA;AAAA,IAAA,CAAA;MAAAC,CAAA,EAAA,CAAAC,SAAA,EAAAC,eAAA,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,0BAA0B;AACrCC,MAAAA,MAAM,EAAE;AACV,KAAC,CAAC,CAAA,EAAA,CAAA,CAAA,CAGCC,EAAE,EAAFA,EAAE,CAACC,OAAO,EACVL,IAAI,EAAJA,IAAI,CAACM,MAAM,iBAGXF,EAAE,EAAFA,EAAE,CAACC,OAAO,EACVL,IAAI,EAAJA,IAAI,CAACM,MAAM,CAAA,EAAA,EAAA,EAAA,OAAA,CAAA,EAAA,CAAA,CAMXC,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACC,OAAO,6BAd+BpB,QAAQ,CAAA;AAAA;AAAAqB,EAAAA,WAAAA,CAAA,GAAAC,IAAA,EAAA;AAAA,IAAA,KAAA,CAAA,GAAAA,IAAA,CAAA;IAAAjB,iBAAA,CAAA,IAAA,CAAA;AAAA,EAAA;AAIpDkB,EAAAA,GAAG,IAAAjB,UAAA,CAAA,IAAA,CAAA,EAAAJ,SAAA,OAAG,EAAE,CAAA;AAIRsB,EAAAA,KAAK,IAAArB,eAAA,CAAA,IAAA,CAAA,EAAAC,WAAA,OAAG,EAAE,CAAA;;AAEV;AACF;AACA;EAGEqB,KAAKA,CAACC,UAAU,EAChB;AACE,IAAA,MAAMC,KAAK,GAAGC,oBAAoB,CAACC,QAAQ,CAACH,UAAU,CAAC;IACvD,IAAI,CAACE,oBAAoB,CAACE,WAAW,CAACH,KAAK,EAAE,iBAAiB,CAAC,EAC/D;AACE,MAAA;AACF,IAAA;IACAA,KAAK,CAACI,eAAe,CAAC,IAAI,CAACR,GAAG,EAAE,IAAI,CAACC,KAAK,CAAC;AAC7C,EAAA;AAAC,EAAA;IAAAhB,UAAA,EAAA;AAAA;AACH;;;;"}

package/dist/controllers/Tr2ActionSetValue.js

@@ -6,6 +6,11 @@ import { ITr2ControllerAction } from './ITr2ControllerAction.js';
 import { Tr2BindingPoint as _Tr2BindingPoint } from './Tr2BindingPoint.js';
 
 let _initProto, _initClass, _init_value, _init_extra_value, _init_attribute, _init_extra_attribute, _init_destination, _init_extra_destination, _init_delayBinding, _init_extra_delayBinding, _init_path, _init_extra_path;
+
+/**
+ * Controller action that evaluates a value expression once on start and writes
+ * the result into a bound destination property.
+ */
 let _Tr2ActionSetValue;
 class Tr2ActionSetValue extends CjsModel {
   static {
@@ -139,12 +144,27 @@ class Tr2ActionSetValue extends CjsModel {
       action: this
     })) || 0;
   }
+
+  /**
+   * Compiles the authored value expression, reusing the cached program while the
+   * expression text is unchanged.
+   */
   CompileExpression() {
     return CjsControllerExpressionProgram.compileCached(this.#expression, this.value, 0);
   }
+
+  /**
+   * Evaluates the value expression against the controller context, returning 0
+   * when it does not compile or does not produce a finite number.
+   */
   GetValue(controller = this.#controller, owner = ITr2ControllerAction.getOwner(controller)) {
     return this.#evaluateValue(controller, owner) ?? 0;
   }
+
+  /**
+   * Evaluates the value expression, returning null rather than 0 when it fails
+   * to compile or yields a non-finite number so the caller can skip the write.
+   */
   #evaluateValue(controller, owner) {
     const program = this.CompileExpression();
     if (!program.IsValid()) {
@@ -160,6 +180,11 @@ class Tr2ActionSetValue extends CjsModel {
     }));
     return Number.isFinite(value) ? value : null;
   }
+
+  /**
+   * 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();
@@ -169,9 +194,19 @@ class Tr2ActionSetValue 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.#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/Tr2ActionSetValue.js.map

@@ -1 +1 @@
-{"version":3,"file":"Tr2ActionSetValue.js","sources":["../../../src/controllers/Tr2ActionSetValue.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\Controllers\\Actions\\Tr2ActionSetValue.h\r\n// Source: E:\\carbonengine\\trinity\\trinity\\Controllers\\Actions\\Tr2ActionSetValue.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: \"Tr2ActionSetValue\",\r\n  family: \"controllers\"\r\n})\r\nexport class Tr2ActionSetValue extends CjsModel\r\n{\r\n  @io.notify\r\n  @io.persist\r\n  @type.string\r\n  value = \"\";\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  #bindingPoint = null;\r\n\r\n  #expression = {\r\n    program: null,\r\n    source: \"\"\r\n  };\r\n  #controller = null;\r\n\r\n  /**\r\n   * Links the destination when this action does not use delayed binding.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  Link(controller)\r\n  {\r\n    this.#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 binding.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  Unlink()\r\n  {\r\n    this.#bindingPoint?.Unlink();\r\n    this.#expression = {\r\n      program: null,\r\n      source: \"\"\r\n    };\r\n    this.#controller = null;\r\n  }\r\n\r\n  /**\r\n   * Evaluates the value expression and writes it to the destination binding.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  Start(controller = this.#controller)\r\n  {\r\n    if (!controller)\r\n    {\r\n      return;\r\n    }\r\n    const owner = ITr2ControllerAction.getOwner(controller);\r\n    this.#controller = controller;\r\n    if (this.HasDelayedBinding())\r\n    {\r\n      this.LinkDestination(controller, owner);\r\n    }\r\n    if (!this.IsBindingValid())\r\n    {\r\n      return;\r\n    }\r\n    const value = this.#evaluateValue(controller, owner);\r\n    if (value === null)\r\n    {\r\n      return;\r\n    }\r\n    this.GetBindingPoint().SetValue(value, controller, owner);\r\n  }\r\n\r\n  /**\r\n   * Relinks or recompiles when authored fields change.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  OnModified(_options = {})\r\n  {\r\n    this.#expression.program = null;\r\n    if (this.#controller && !this.HasDelayedBinding())\r\n    {\r\n      this.LinkDestination(this.#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 the bound destination object.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  GetDestination(controller = this.#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 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    this.#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    if (!program.IsValid())\r\n    {\r\n      return 0;\r\n    }\r\n    const controller = this.#controller;\r\n    const owner = ITr2ControllerAction.getOwner(controller);\r\n    const runtime = controller;\r\n    return Number(program.Evaluate(runtime?.GetExpressionContext?.(owner, null, {\r\n      action: this\r\n    }) ?? {\r\n      controller: controller ?? undefined,\r\n      owner,\r\n      action: this\r\n    })) || 0;\r\n  }\r\n  CompileExpression()\r\n  {\r\n    return CjsControllerExpressionProgram.compileCached(this.#expression, this.value, 0);\r\n  }\r\n  GetValue(controller = this.#controller, owner = ITr2ControllerAction.getOwner(controller))\r\n  {\r\n    return this.#evaluateValue(controller, owner) ?? 0;\r\n  }\r\n  #evaluateValue(controller, owner)\r\n  {\r\n    const program = this.CompileExpression();\r\n    if (!program.IsValid())\r\n    {\r\n      return null;\r\n    }\r\n    const runtime = controller;\r\n    const value = Number(program.Evaluate(runtime?.GetExpressionContext?.(owner, null, {\r\n      action: this\r\n    }) ?? {\r\n      controller: controller ?? undefined,\r\n      owner,\r\n      action: this\r\n    }));\r\n    return Number.isFinite(value) ? value : null;\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.#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":["_Tr2ActionSetValue","Tr2ActionSetValue","CjsModel","e","_init_value","_init_extra_value","_init_attribute","_init_extra_attribute","_init_destination","_init_extra_destination","_init_delayBinding","_init_extra_delayBinding","_init_path","_init_extra_path","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","notify","persist","string","objectRef","boolean","carbon","method","impl","adapted","implemented","value","attribute","destination","delayBinding","path","program","source","Link","controller","HasDelayedBinding","LinkDestination","CompileExpression","Unlink","Start","owner","ITr2ControllerAction","getOwner","IsBindingValid","GetBindingPoint","SetValue","OnModified","_options","IsValid","IsExpressionValid","GetDestination","GetBoundObject","GetExpressionTermInfo","result","CjsControllerExpressionProgram","addControllerTermInfo","EvaluateExpression","expression","state","compileCached","runtime","Number","Evaluate","GetExpressionContext","action","undefined","GetValue","#evaluateValue","isFinite","Tr2BindingPoint","object"],"mappings":";;;;;;;;AAMuD,IAAAA;AAGvD,MAAAC,iBAAA,SAIuCC,QAAQ,CAC/C;AAAA,EAAA;AAAA,IAAA,CAAA;MAAAC,CAAA,EAAA,CAAAC,WAAA,EAAAC,iBAAA,EAAAC,eAAA,EAAAC,qBAAA,EAAAC,iBAAA,EAAAC,uBAAA,EAAAC,kBAAA,EAAAC,wBAAA,EAAAC,UAAA,EAAAC,gBAAA,EAAAC,UAAA,CAAA;MAAAC,CAAA,EAAA,CAAAf,kBAAA,EAAAgB,UAAA;AAAA,KAAA,GAAAC,cAAA,CAAA,IAAA,EAAA,CALCC,IAAI,CAACC,MAAM,CAAC;AACXC,MAAAA,SAAS,EAAE,mBAAmB;AAC9BC,MAAAA,MAAM,EAAE;KACT,CAAC,MAGCC,EAAE,EAAFA,EAAE,CAACC,MAAM,EACTD,EAAE,EAAFA,EAAE,CAACE,OAAO,EACVN,IAAI,EAAJA,IAAI,CAACO,MAAM,CAAA,EAAA,EAAA,EAAA,OAAA,CAAA,EAAA,CAAA,CAGXH,EAAE,EAAFA,EAAE,CAACC,MAAM,EACTD,EAAE,EAAFA,EAAE,CAACE,OAAO,EACVN,IAAI,EAAJA,IAAI,CAACO,MAAM,CAAA,EAAA,EAAA,EAAA,WAAA,CAAA,EAAA,CAAA,CAGXH,EAAE,EAAFA,EAAE,CAACC,MAAM,EACTD,EAAE,EAAFA,EAAE,CAACE,OAAO,UACVN,IAAI,CAACQ,SAAS,CAAC,OAAO,CAAC,CAAA,EAAA,EAAA,EAAA,aAAA,CAAA,EAAA,CAAA,CAGvBJ,EAAE,EAAFA,EAAE,CAACC,MAAM,EACTD,EAAE,EAAFA,EAAE,CAACE,OAAO,EACVN,IAAI,EAAJA,IAAI,CAACS,OAAO,0BAGZL,EAAE,EAAFA,EAAE,CAACC,MAAM,EACTD,EAAE,EAAFA,EAAE,CAACE,OAAO,EACVN,IAAI,EAAJA,IAAI,CAACO,MAAM,CAAA,EAAA,EAAA,EAAA,MAAA,CAAA,EAAA,CAAA,CAcXG,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACC,OAAO,CAAA,EAAA,EAAA,EAAA,MAAA,CAAA,EAAA,CAAA,CAcZH,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACE,WAAW,CAAA,EAAA,EAAA,EAAA,QAAA,CAAA,EAAA,CAAA,CAchBJ,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACC,OAAO,mBA4BZH,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACC,OAAO,CAAA,EAAA,EAAA,EAAA,YAAA,CAAA,EAAA,CAAA,CAcZH,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACE,WAAW,CAAA,EAAA,EAAA,EAAA,gBAAA,CAAA,EAAA,CAAA,CAShBJ,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACE,WAAW,+BAShBJ,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACE,WAAW,CAAA,EAAA,EAAA,EAAA,gBAAA,CAAA,EAAA,CAAA,CAShBJ,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACC,OAAO,CAAA,EAAA,EAAA,EAAA,uBAAA,CAAA,EAAA,CAAA,CAYZH,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACC,OAAO,CAAA,EAAA,EAAA,EAAA,oBAAA,CAAA,CAAA,EAAA,CAAA,EAAA,MAAA,EA5JwB7B,QAAQ,CAAA;AAAA;AAK7C+B,EAAAA,KAAK,IAAAnB,UAAA,CAAA,IAAA,CAAA,EAAAV,WAAA,OAAG,EAAE,CAAA;AAKV8B,EAAAA,SAAS,IAAA7B,iBAAA,CAAA,IAAA,CAAA,EAAAC,eAAA,OAAG,EAAE,CAAA;AAKd6B,EAAAA,WAAW,IAAA5B,qBAAA,CAAA,IAAA,CAAA,EAAAC,iBAAA,OAAG,IAAI,CAAA;AAKlB4B,EAAAA,YAAY,IAAA3B,uBAAA,CAAA,IAAA,CAAA,EAAAC,kBAAA,OAAG,KAAK,CAAA;AAKpB2B,EAAAA,IAAI,IAAA1B,wBAAA,CAAA,IAAA,CAAA,EAAAC,UAAA,OAAG,EAAE,CAAA;AAET,EAAA,aAAa,IAAAC,gBAAA,CAAA,IAAA,CAAA,EAAG,IAAI;AAEpB,EAAA,WAAW,GAAG;AACZyB,IAAAA,OAAO,EAAE,IAAI;AACbC,IAAAA,MAAM,EAAE;GACT;EACD,WAAW,GAAG,IAAI;;AAElB;AACF;AACA;EAGEC,IAAIA,CAACC,UAAU,EACf;AACE,IAAA,IAAI,CAAC,WAAW,GAAGA,UAAU;AAC7B,IAAA,IAAI,CAAC,IAAI,CAACC,iBAAiB,EAAE,EAC7B;AACE,MAAA,IAAI,CAACC,eAAe,CAACF,UAAU,CAAC;AAClC,IAAA;IACA,IAAI,CAACG,iBAAiB,EAAE;AAC1B,EAAA;;AAEA;AACF;AACA;AAGEC,EAAAA,MAAMA,GACN;AACE,IAAA,IAAI,CAAC,aAAa,EAAEA,MAAM,EAAE;IAC5B,IAAI,CAAC,WAAW,GAAG;AACjBP,MAAAA,OAAO,EAAE,IAAI;AACbC,MAAAA,MAAM,EAAE;KACT;AACD,IAAA,IAAI,CAAC,WAAW,GAAG,IAAI;AACzB,EAAA;;AAEA;AACF;AACA;AAGEO,EAAAA,KAAKA,CAACL,UAAU,GAAG,IAAI,CAAC,WAAW,EACnC;IACE,IAAI,CAACA,UAAU,EACf;AACE,MAAA;AACF,IAAA;AACA,IAAA,MAAMM,KAAK,GAAGC,oBAAoB,CAACC,QAAQ,CAACR,UAAU,CAAC;AACvD,IAAA,IAAI,CAAC,WAAW,GAAGA,UAAU;AAC7B,IAAA,IAAI,IAAI,CAACC,iBAAiB,EAAE,EAC5B;AACE,MAAA,IAAI,CAACC,eAAe,CAACF,UAAU,EAAEM,KAAK,CAAC;AACzC,IAAA;AACA,IAAA,IAAI,CAAC,IAAI,CAACG,cAAc,EAAE,EAC1B;AACE,MAAA;AACF,IAAA;IACA,MAAMjB,KAAK,GAAG,IAAI,CAAC,cAAc,CAACQ,UAAU,EAAEM,KAAK,CAAC;IACpD,IAAId,KAAK,KAAK,IAAI,EAClB;AACE,MAAA;AACF,IAAA;AACA,IAAA,IAAI,CAACkB,eAAe,EAAE,CAACC,QAAQ,CAACnB,KAAK,EAAEQ,UAAU,EAAEM,KAAK,CAAC;AAC3D,EAAA;;AAEA;AACF;AACA;AAGEM,EAAAA,UAAUA,CAACC,QAAQ,GAAG,EAAE,EACxB;AACE,IAAA,IAAI,CAAC,WAAW,CAAChB,OAAO,GAAG,IAAI;IAC/B,IAAI,IAAI,CAAC,WAAW,IAAI,CAAC,IAAI,CAACI,iBAAiB,EAAE,EACjD;AACE,MAAA,IAAI,CAACC,eAAe,CAAC,IAAI,CAAC,WAAW,CAAC;AACxC,IAAA;AACA,IAAA,OAAO,IAAI;AACb,EAAA;;AAEA;AACF;AACA;AAGEO,EAAAA,cAAcA,GACd;IACE,OAAO,CAAC,CAAC,IAAI,CAAC,aAAa,EAAEK,OAAO,EAAE;AACxC,EAAA;;AAEA;AACF;AACA;AAGEC,EAAAA,iBAAiBA,GACjB;IACE,OAAO,IAAI,CAACZ,iBAAiB,EAAE,CAACW,OAAO,EAAE;AAC3C,EAAA;;AAEA;AACF;AACA;AAGEE,EAAAA,cAAcA,CAAChB,UAAU,GAAG,IAAI,CAAC,WAAW,EAAEM,KAAK,GAAGC,oBAAoB,CAACC,QAAQ,CAACR,UAAU,CAAC,EAC/F;IACE,OAAO,IAAI,CAACU,eAAe,EAAE,CAACO,cAAc,CAACjB,UAAU,EAAEM,KAAK,CAAC;AACjE,EAAA;;AAEA;AACF;AACA;AAGEY,EAAAA,qBAAqBA,GACrB;IACE,MAAMC,MAAM,GAAG,EAAE;AACjBC,IAAAA,8BAA8B,CAACC,qBAAqB,CAACF,MAAM,CAAC;AAC5D,IAAA,IAAI,CAAC,WAAW,EAAED,qBAAqB,GAAGC,MAAM,CAAC;AACjD,IAAA,OAAOA,MAAM;AACf,EAAA;;AAEA;AACF;AACA;EAGEG,kBAAkBA,CAACC,UAAU,EAC7B;AACE,IAAA,MAAMC,KAAK,GAAG;AACZ3B,MAAAA,OAAO,EAAE,IAAI;AACbC,MAAAA,MAAM,EAAE;KACT;IACD,MAAMD,OAAO,GAAGuB,8BAA8B,CAACK,aAAa,CAACD,KAAK,EAAED,UAAU,EAAE,CAAC,CAAC;AAClF,IAAA,IAAI,CAAC1B,OAAO,CAACiB,OAAO,EAAE,EACtB;AACE,MAAA,OAAO,CAAC;AACV,IAAA;AACA,IAAA,MAAMd,UAAU,GAAG,IAAI,CAAC,WAAW;AACnC,IAAA,MAAMM,KAAK,GAAGC,oBAAoB,CAACC,QAAQ,CAACR,UAAU,CAAC;IACvD,MAAM0B,OAAO,GAAG1B,UAAU;AAC1B,IAAA,OAAO2B,MAAM,CAAC9B,OAAO,CAAC+B,QAAQ,CAACF,OAAO,EAAEG,oBAAoB,GAAGvB,KAAK,EAAE,IAAI,EAAE;AAC1EwB,MAAAA,MAAM,EAAE;AACV,KAAC,CAAC,IAAI;MACJ9B,UAAU,EAAEA,UAAU,IAAI+B,SAAS;MACnCzB,KAAK;AACLwB,MAAAA,MAAM,EAAE;KACT,CAAC,CAAC,IAAI,CAAC;AACV,EAAA;AACA3B,EAAAA,iBAAiBA,GACjB;AACE,IAAA,OAAOiB,8BAA8B,CAACK,aAAa,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAACjC,KAAK,EAAE,CAAC,CAAC;AACtF,EAAA;AACAwC,EAAAA,QAAQA,CAAChC,UAAU,GAAG,IAAI,CAAC,WAAW,EAAEM,KAAK,GAAGC,oBAAoB,CAACC,QAAQ,CAACR,UAAU,CAAC,EACzF;IACE,OAAO,IAAI,CAAC,cAAc,CAACA,UAAU,EAAEM,KAAK,CAAC,IAAI,CAAC;AACpD,EAAA;AACA,EAAA,cAAc2B,CAACjC,UAAU,EAAEM,KAAK,EAChC;AACE,IAAA,MAAMT,OAAO,GAAG,IAAI,CAACM,iBAAiB,EAAE;AACxC,IAAA,IAAI,CAACN,OAAO,CAACiB,OAAO,EAAE,EACtB;AACE,MAAA,OAAO,IAAI;AACb,IAAA;IACA,MAAMY,OAAO,GAAG1B,UAAU;AAC1B,IAAA,MAAMR,KAAK,GAAGmC,MAAM,CAAC9B,OAAO,CAAC+B,QAAQ,CAACF,OAAO,EAAEG,oBAAoB,GAAGvB,KAAK,EAAE,IAAI,EAAE;AACjFwB,MAAAA,MAAM,EAAE;AACV,KAAC,CAAC,IAAI;MACJ9B,UAAU,EAAEA,UAAU,IAAI+B,SAAS;MACnCzB,KAAK;AACLwB,MAAAA,MAAM,EAAE;AACV,KAAC,CAAC,CAAC;IACH,OAAOH,MAAM,CAACO,QAAQ,CAAC1C,KAAK,CAAC,GAAGA,KAAK,GAAG,IAAI;AAC9C,EAAA;AACAkB,EAAAA,eAAeA,GACf;AACE,IAAA,IAAI,CAAC,IAAI,CAAC,aAAa,EACvB;AACE,MAAA,IAAI,CAAC,aAAa,GAAG,IAAIyB,gBAAe,EAAE;AAC5C,IAAA;IACA,IAAI,CAAC,aAAa,CAACvC,IAAI,GAAG,IAAI,CAACA,IAAI;IACnC,IAAI,CAAC,aAAa,CAACwC,MAAM,GAAG,IAAI,CAAC1C,WAAW;IAC5C,IAAI,CAAC,aAAa,CAACD,SAAS,GAAG,IAAI,CAACA,SAAS;IAC7C,OAAO,IAAI,CAAC,aAAa;AAC3B,EAAA;AACAS,EAAAA,eAAeA,CAACF,UAAU,GAAG,IAAI,CAAC,WAAW,EAAEM,KAAK,GAAGC,oBAAoB,CAACC,QAAQ,CAACR,UAAU,CAAC,EAChG;IACE,OAAO,IAAI,CAACU,eAAe,EAAE,CAACX,IAAI,CAACC,UAAU,EAAEM,KAAK,CAAC;AACvD,EAAA;AACAL,EAAAA,iBAAiBA,GACjB;IACE,OAAO,IAAI,CAACN,YAAY,IAAI,CAAC,CAAC,IAAI,CAACC,IAAI;AACzC,EAAA;AAAC,EAAA;IAAArB,UAAA,EAAA;AAAA;AACH;;;;"}
+{"version":3,"file":"Tr2ActionSetValue.js","sources":["../../../src/controllers/Tr2ActionSetValue.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\Controllers\\Actions\\Tr2ActionSetValue.h\r\n// Source: E:\\carbonengine\\trinity\\trinity\\Controllers\\Actions\\Tr2ActionSetValue.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 evaluates a value expression once on start and writes\r\n * the result into a bound destination property.\r\n */\r\n@type.define({\r\n  className: \"Tr2ActionSetValue\",\r\n  family: \"controllers\"\r\n})\r\nexport class Tr2ActionSetValue extends CjsModel\r\n{\r\n  @io.notify\r\n  @io.persist\r\n  @type.string\r\n  value = \"\";\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  #bindingPoint = null;\r\n\r\n  #expression = {\r\n    program: null,\r\n    source: \"\"\r\n  };\r\n  #controller = null;\r\n\r\n  /**\r\n   * Links the destination when this action does not use delayed binding.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  Link(controller)\r\n  {\r\n    this.#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 binding.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  Unlink()\r\n  {\r\n    this.#bindingPoint?.Unlink();\r\n    this.#expression = {\r\n      program: null,\r\n      source: \"\"\r\n    };\r\n    this.#controller = null;\r\n  }\r\n\r\n  /**\r\n   * Evaluates the value expression and writes it to the destination binding.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  Start(controller = this.#controller)\r\n  {\r\n    if (!controller)\r\n    {\r\n      return;\r\n    }\r\n    const owner = ITr2ControllerAction.getOwner(controller);\r\n    this.#controller = controller;\r\n    if (this.HasDelayedBinding())\r\n    {\r\n      this.LinkDestination(controller, owner);\r\n    }\r\n    if (!this.IsBindingValid())\r\n    {\r\n      return;\r\n    }\r\n    const value = this.#evaluateValue(controller, owner);\r\n    if (value === null)\r\n    {\r\n      return;\r\n    }\r\n    this.GetBindingPoint().SetValue(value, controller, owner);\r\n  }\r\n\r\n  /**\r\n   * Relinks or recompiles when authored fields change.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  OnModified(_options = {})\r\n  {\r\n    this.#expression.program = null;\r\n    if (this.#controller && !this.HasDelayedBinding())\r\n    {\r\n      this.LinkDestination(this.#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 the bound destination object.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  GetDestination(controller = this.#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 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    this.#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    if (!program.IsValid())\r\n    {\r\n      return 0;\r\n    }\r\n    const controller = this.#controller;\r\n    const owner = ITr2ControllerAction.getOwner(controller);\r\n    const runtime = controller;\r\n    return Number(program.Evaluate(runtime?.GetExpressionContext?.(owner, null, {\r\n      action: this\r\n    }) ?? {\r\n      controller: controller ?? undefined,\r\n      owner,\r\n      action: this\r\n    })) || 0;\r\n  }\r\n\r\n  /**\r\n   * Compiles the authored value 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.#expression, this.value, 0);\r\n  }\r\n\r\n  /**\r\n   * Evaluates the value expression against the controller context, returning 0\r\n   * when it does not compile or does not produce a finite number.\r\n   */\r\n  GetValue(controller = this.#controller, owner = ITr2ControllerAction.getOwner(controller))\r\n  {\r\n    return this.#evaluateValue(controller, owner) ?? 0;\r\n  }\r\n\r\n  /**\r\n   * Evaluates the value expression, returning null rather than 0 when it fails\r\n   * to compile or yields a non-finite number so the caller can skip the write.\r\n   */\r\n  #evaluateValue(controller, owner)\r\n  {\r\n    const program = this.CompileExpression();\r\n    if (!program.IsValid())\r\n    {\r\n      return null;\r\n    }\r\n    const runtime = controller;\r\n    const value = Number(program.Evaluate(runtime?.GetExpressionContext?.(owner, null, {\r\n      action: this\r\n    }) ?? {\r\n      controller: controller ?? undefined,\r\n      owner,\r\n      action: this\r\n    }));\r\n    return Number.isFinite(value) ? value : null;\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.#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":["_Tr2ActionSetValue","Tr2ActionSetValue","CjsModel","e","_init_value","_init_extra_value","_init_attribute","_init_extra_attribute","_init_destination","_init_extra_destination","_init_delayBinding","_init_extra_delayBinding","_init_path","_init_extra_path","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","notify","persist","string","objectRef","boolean","carbon","method","impl","adapted","implemented","value","attribute","destination","delayBinding","path","program","source","Link","controller","HasDelayedBinding","LinkDestination","CompileExpression","Unlink","Start","owner","ITr2ControllerAction","getOwner","IsBindingValid","GetBindingPoint","SetValue","OnModified","_options","IsValid","IsExpressionValid","GetDestination","GetBoundObject","GetExpressionTermInfo","result","CjsControllerExpressionProgram","addControllerTermInfo","EvaluateExpression","expression","state","compileCached","runtime","Number","Evaluate","GetExpressionContext","action","undefined","GetValue","#evaluateValue","isFinite","Tr2BindingPoint","object"],"mappings":"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"}

package/dist/controllers/Tr2ActionSpawnParticles.js

@@ -5,6 +5,11 @@ import { ITr2GenericEmitter as _ITr2GenericEmitter } from '../generated/particle
 import { ITr2ControllerAction } from './ITr2ControllerAction.js';
 
 let _initProto, _initClass, _init_emitter, _init_extra_emitter, _init_rate, _init_extra_rate;
+
+/**
+ * Controller action that emits a one-shot burst of particles from a dynamic
+ * emitter when it starts.
+ */
 let _Tr2ActionSpawnPartic;
 new class extends _identity {
   static [class Tr2ActionSpawnParticles extends CjsModel {
@@ -33,6 +38,11 @@ new class extends _identity {
       }
       this.emitter.SpawnParticles(_Tr2ActionSpawnPartic.#createEmitterUpdateArguments(), null, null, this.rate);
     }
+
+    /**
+     * Builds the emitter update arguments used for a manual spawn, with an emit
+     * count factor of 1 so the authored rate is applied unscaled.
+     */
   }];
   #createEmitterUpdateArguments() {
     const args = new _ITr2GenericEmitter();

package/dist/controllers/Tr2ActionSpawnParticles.js.map

@@ -1 +1 @@
-{"version":3,"file":"Tr2ActionSpawnParticles.js","sources":["../../../src/controllers/Tr2ActionSpawnParticles.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\Controllers\\Actions\\Tr2ActionSpawnParticles.h\n// Source: E:\\carbonengine\\trinity\\trinity\\Controllers\\Actions\\Tr2ActionSpawnParticles.cpp\nimport { CjsModel } from \"@carbonenginejs/runtime-utils/model\";\nimport { carbon, impl, io, type } from \"@carbonenginejs/runtime-utils/schema\";\nimport { ITr2GenericEmitter as Tr2GenericEmitterUpdateArguments } from \"../generated/particle/ITr2GenericEmitter.js\";\nimport { ITr2ControllerAction } from \"./ITr2ControllerAction.js\";\n\n\n@type.define({\n  className: \"Tr2ActionSpawnParticles\",\n  family: \"controllers\"\n})\nexport class Tr2ActionSpawnParticles extends CjsModel\n{\n  @io.persist\n  @type.objectRef(\"Tr2DynamicEmitter\")\n  emitter = null;\n\n  @io.persist\n  @type.float32\n  rate = 1;\n\n  /**\n   * Spawns particles on the configured emitter.\n   */\n  @carbon.method\n  @impl.adapted\n  Start(_controller)\n  {\n    if (!ITr2ControllerAction.hasFunction(this.emitter, \"SpawnParticles\"))\n    {\n      return;\n    }\n    this.emitter.SpawnParticles(Tr2ActionSpawnParticles.#createEmitterUpdateArguments(), null, null, this.rate);\n  }\n\n  static #createEmitterUpdateArguments()\n  {\n    const args = new Tr2GenericEmitterUpdateArguments();\n    args.emitCountFactor = 1;\n    return args;\n  }\n}\n"],"names":["_Tr2ActionSpawnPartic","_identity","Tr2ActionSpawnParticles","CjsModel","e","_init_emitter","_init_extra_emitter","_init_rate","_init_extra_rate","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","persist","objectRef","float32","carbon","method","impl","adapted","constructor","args","emitter","rate","Start","_controller","ITr2ControllerAction","hasFunction","SpawnParticles","#createEmitterUpdateArguments","Tr2GenericEmitterUpdateArguments","emitCountFactor"],"mappings":";;;;;;;AAKiE,IAAAA;AAAA,IAAA,cAAAC,SAAA,CAAA;AAAA,EAAA,QAGjE,MAAAC,uBAAA,SAI6CC,QAAQ,CACrD;AAAA,IAAA;AAAA,MAAA,CAAA;QAAAC,CAAA,EAAA,CAAAC,aAAA,EAAAC,mBAAA,EAAAC,UAAA,EAAAC,gBAAA,EAAAC,UAAA,CAAA;QAAAC,CAAA,EAAA,CAAAV,qBAAA,EAAAW,UAAA;AAAA,OAAA,GAAAC,cAAA,CAAA,IAAA,EAAA,CALCC,IAAI,CAACC,MAAM,CAAC;AACXC,QAAAA,SAAS,EAAE,yBAAyB;AACpCC,QAAAA,MAAM,EAAE;AACV,OAAC,CAAC,CAAA,EAAA,CAAA,CAAA,CAGCC,EAAE,EAAFA,EAAE,CAACC,OAAO,EAAA,MAAA,EACVL,IAAI,CAACM,SAAS,CAAC,mBAAmB,CAAC,CAAA,EAAA,EAAA,EAAA,SAAA,CAAA,EAAA,CAAA,CAGnCF,EAAE,EAAFA,EAAE,CAACC,OAAO,EACVL,IAAI,EAAJA,IAAI,CAACO,OAAO,CAAA,EAAA,EAAA,EAAA,MAAA,CAAA,EAAA,CAAA,CAMZC,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACC,OAAO,6BAd8BrB,QAAQ,CAAA;AAAA;AAAAsB,IAAAA,WAAAA,CAAA,GAAAC,IAAA,EAAA;AAAA,MAAA,KAAA,CAAA,GAAAA,IAAA,CAAA;MAAAlB,gBAAA,CAAA,IAAA,CAAA;AAAA,IAAA;AAInDmB,IAAAA,OAAO,IAAAlB,UAAA,CAAA,IAAA,CAAA,EAAAJ,aAAA,OAAG,IAAI,CAAA;AAIduB,IAAAA,IAAI,IAAAtB,mBAAA,CAAA,IAAA,CAAA,EAAAC,UAAA,OAAG,CAAC,CAAA;;AAER;AACF;AACA;IAGEsB,KAAKA,CAACC,WAAW,EACjB;MACE,IAAI,CAACC,oBAAoB,CAACC,WAAW,CAAC,IAAI,CAACL,OAAO,EAAE,gBAAgB,CAAC,EACrE;AACE,QAAA;AACF,MAAA;AACA,MAAA,IAAI,CAACA,OAAO,CAACM,cAAc,CAAC/B,qBAAuB,CAAC,6BAA6B,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC0B,IAAI,CAAC;AAC7G,IAAA;GAQD;EANQ,6BAA6BM,GACpC;AACE,IAAA,MAAMR,IAAI,GAAG,IAAIS,mBAAgC,EAAE;IACnDT,IAAI,CAACU,eAAe,GAAG,CAAC;AACxB,IAAA,OAAOV,IAAI;AACb,EAAA;EAACD,WAAAA,GAAA;IAAA,KAAA,CAAAzB,qBAAA,GAAAW,UAAA,EAAA;AAAA,EAAA;AAAA,CAAA,EAAA;;;;"}
+{"version":3,"file":"Tr2ActionSpawnParticles.js","sources":["../../../src/controllers/Tr2ActionSpawnParticles.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\Controllers\\Actions\\Tr2ActionSpawnParticles.h\n// Source: E:\\carbonengine\\trinity\\trinity\\Controllers\\Actions\\Tr2ActionSpawnParticles.cpp\nimport { CjsModel } from \"@carbonenginejs/runtime-utils/model\";\nimport { carbon, impl, io, type } from \"@carbonenginejs/runtime-utils/schema\";\nimport { ITr2GenericEmitter as Tr2GenericEmitterUpdateArguments } from \"../generated/particle/ITr2GenericEmitter.js\";\nimport { ITr2ControllerAction } from \"./ITr2ControllerAction.js\";\n\n\n/**\n * Controller action that emits a one-shot burst of particles from a dynamic\n * emitter when it starts.\n */\n@type.define({\n  className: \"Tr2ActionSpawnParticles\",\n  family: \"controllers\"\n})\nexport class Tr2ActionSpawnParticles extends CjsModel\n{\n  @io.persist\n  @type.objectRef(\"Tr2DynamicEmitter\")\n  emitter = null;\n\n  @io.persist\n  @type.float32\n  rate = 1;\n\n  /**\n   * Spawns particles on the configured emitter.\n   */\n  @carbon.method\n  @impl.adapted\n  Start(_controller)\n  {\n    if (!ITr2ControllerAction.hasFunction(this.emitter, \"SpawnParticles\"))\n    {\n      return;\n    }\n    this.emitter.SpawnParticles(Tr2ActionSpawnParticles.#createEmitterUpdateArguments(), null, null, this.rate);\n  }\n\n  /**\n   * Builds the emitter update arguments used for a manual spawn, with an emit\n   * count factor of 1 so the authored rate is applied unscaled.\n   */\n  static #createEmitterUpdateArguments()\n  {\n    const args = new Tr2GenericEmitterUpdateArguments();\n    args.emitCountFactor = 1;\n    return args;\n  }\n}\n"],"names":["_Tr2ActionSpawnPartic","_identity","Tr2ActionSpawnParticles","CjsModel","e","_init_emitter","_init_extra_emitter","_init_rate","_init_extra_rate","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","persist","objectRef","float32","carbon","method","impl","adapted","constructor","args","emitter","rate","Start","_controller","ITr2ControllerAction","hasFunction","SpawnParticles","#createEmitterUpdateArguments","Tr2GenericEmitterUpdateArguments","emitCountFactor"],"mappings":";;;;;;;;AAQA;AACA;AACA;AACA;AAHA,IAAAA;AAAA,IAAA,cAAAC,SAAA,CAAA;AAAA,EAAA,QAIA,MAAAC,uBAAA,SAI6CC,QAAQ,CACrD;AAAA,IAAA;AAAA,MAAA,CAAA;QAAAC,CAAA,EAAA,CAAAC,aAAA,EAAAC,mBAAA,EAAAC,UAAA,EAAAC,gBAAA,EAAAC,UAAA,CAAA;QAAAC,CAAA,EAAA,CAAAV,qBAAA,EAAAW,UAAA;AAAA,OAAA,GAAAC,cAAA,CAAA,IAAA,EAAA,CALCC,IAAI,CAACC,MAAM,CAAC;AACXC,QAAAA,SAAS,EAAE,yBAAyB;AACpCC,QAAAA,MAAM,EAAE;AACV,OAAC,CAAC,CAAA,EAAA,CAAA,CAAA,CAGCC,EAAE,EAAFA,EAAE,CAACC,OAAO,EAAA,MAAA,EACVL,IAAI,CAACM,SAAS,CAAC,mBAAmB,CAAC,CAAA,EAAA,EAAA,EAAA,SAAA,CAAA,EAAA,CAAA,CAGnCF,EAAE,EAAFA,EAAE,CAACC,OAAO,EACVL,IAAI,EAAJA,IAAI,CAACO,OAAO,CAAA,EAAA,EAAA,EAAA,MAAA,CAAA,EAAA,CAAA,CAMZC,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACC,OAAO,6BAd8BrB,QAAQ,CAAA;AAAA;AAAAsB,IAAAA,WAAAA,CAAA,GAAAC,IAAA,EAAA;AAAA,MAAA,KAAA,CAAA,GAAAA,IAAA,CAAA;MAAAlB,gBAAA,CAAA,IAAA,CAAA;AAAA,IAAA;AAInDmB,IAAAA,OAAO,IAAAlB,UAAA,CAAA,IAAA,CAAA,EAAAJ,aAAA,OAAG,IAAI,CAAA;AAIduB,IAAAA,IAAI,IAAAtB,mBAAA,CAAA,IAAA,CAAA,EAAAC,UAAA,OAAG,CAAC,CAAA;;AAER;AACF;AACA;IAGEsB,KAAKA,CAACC,WAAW,EACjB;MACE,IAAI,CAACC,oBAAoB,CAACC,WAAW,CAAC,IAAI,CAACL,OAAO,EAAE,gBAAgB,CAAC,EACrE;AACE,QAAA;AACF,MAAA;AACA,MAAA,IAAI,CAACA,OAAO,CAACM,cAAc,CAAC/B,qBAAuB,CAAC,6BAA6B,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC0B,IAAI,CAAC;AAC7G,IAAA;;AAEA;AACF;AACA;AACA;GAOC;EANQ,6BAA6BM,GACpC;AACE,IAAA,MAAMR,IAAI,GAAG,IAAIS,mBAAgC,EAAE;IACnDT,IAAI,CAACU,eAAe,GAAG,CAAC;AACxB,IAAA,OAAOV,IAAI;AACb,EAAA;EAACD,WAAAA,GAAA;IAAA,KAAA,CAAAzB,qBAAA,GAAAW,UAAA,EAAA;AAAA,EAAA;AAAA,CAAA,EAAA;;;;"}

package/dist/controllers/Tr2BindingPoint.js

@@ -15,6 +15,12 @@ const SWIZZLE_OFFSETS = {
   w: 3,
   a: 3
 };
+
+/**
+ * Resolves an authored `path`/`attribute` pair against named root objects into a
+ * concrete property, optionally a single swizzled component of a vector, and
+ * reads or writes it.
+ */
 let _Tr2BindingPoint;
 new class extends _identity {
   static [class Tr2BindingPoint extends CjsModel {
@@ -172,6 +178,12 @@ new class extends _identity {
       this.#attributeName = parsed.name;
       return true;
     }
+
+    /**
+     * Walks a binding path of the form `Root.child[0].other["name"]` against the
+     * supplied name/value root pairs, returning the addressed object or null if
+     * any step fails.
+     */
     static ResolvePath(path, roots) {
       if (!path) {
         return null;
@@ -207,6 +219,61 @@ new class extends _identity {
       }
       return _Tr2BindingPoint.#isObjectRecord(object) ? object : null;
     }
+
+    /**
+     * Normalizes the `roots` argument into name/value pairs, accepting an array of
+     * pairs, a plain object map, or a controller whose owner is exposed as `Owner`
+     * alongside its own binding path roots.
+     */
+
+    /**
+     * Splits `field.x` into a property name and a component offset; returns an
+     * offset of -1 for a whole-field binding and null when the suffix is not a
+     * single valid xyzw/rgba swizzle.
+     */
+
+    /**
+     * Reads a C-style identifier starting at an index, returning its text and the
+     * index just past it.
+     */
+
+    /**
+     * Reads a bracketed selector, which is either a possibly negative integer
+     * index or a double-quoted name.
+     */
+
+    /**
+     * Selects an element from a list by integer index, counting from the end for
+     * negative values, or by matching the element's `name`.
+     */
+
+    /**
+     * Finds the array a bracketed selector should index into, checking `items`,
+     * `children`, `curveSets`, `controllers` and `actions` in that order.
+     */
+
+    /**
+     * Tells the target its property changed through the first of UpdateValues,
+     * OnValueChanged or OnModified that it implements, and otherwise marks the
+     * field in a `_dirty` record.
+     */
+
+    /**
+     * Compares two array-likes element-wise with Object.is, used to decide whether
+     * a vector write actually changed anything.
+     */
+
+    /**
+     * Distinguishes a plain name-to-object root map from a controller, by checking
+     * that it exposes neither GetOwner nor GetBindingPathRoots.
+     */
+
+    /**
+     * Checks that a value is a non-null object and so can be indexed by a path
+     * step.
+     */
+
+    /** Checks that a value is an object whose named key is callable. */
   }];
   #getLinkRoots(roots, owner) {
     if (Array.isArray(roots)) {