@carbonenginejs/runtime-trinity 0.6.0 → 0.7.0

package/dist/controllers/Tr2ActionOverlay.js.map

@@ -1 +1 @@
-{"version":3,"file":"Tr2ActionOverlay.js","sources":["../../../src/controllers/Tr2ActionOverlay.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\Controllers\\Actions\\Tr2ActionOverlay.h\n// Source: E:\\carbonengine\\trinity\\trinity\\Controllers\\Actions\\Tr2ActionOverlay.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: \"Tr2ActionOverlay\",\n  family: \"controllers\"\n})\nexport class Tr2ActionOverlay extends CjsModel\n{\n  @io.persist\n  @type.path\n  path = \"\";\n\n  @io.persist\n  @type.string\n  overlayName = \"\";\n\n  @io.persist\n  @type.string\n  targetAnotherOwner = \"\";\n\n  @io.persist\n  @type.boolean\n  addOnStart = true;\n\n  @io.persist\n  @type.boolean\n  removeOnStop = true;\n\n  #overlay = null;\n\n  /**\n   * Loads and starts the target overlay when Carbon would add it.\n   */\n  @carbon.method\n  @impl.adapted\n  Start(controller)\n  {\n    const controllerOwner = ITr2ControllerAction.getOwner(controller);\n    const resolved = this.#resolveOwner(controllerOwner);\n    if (!resolved.owner)\n    {\n      return;\n    }\n    this.#loadOverlay(resolved.owner);\n    if (resolved.rebind)\n    {\n      ITr2ControllerAction.callTarget(controllerOwner, \"Rebind\", true);\n    }\n  }\n\n  /**\n   * Stops or removes the target overlay.\n   */\n  @carbon.method\n  @impl.adapted\n  Stop(controller)\n  {\n    const overlay = this.#overlay;\n    if (!overlay)\n    {\n      return;\n    }\n    if (this.removeOnStop)\n    {\n      const owner = this.#resolveOwner(ITr2ControllerAction.getOwner(controller)).owner;\n      if (owner)\n      {\n        Tr2ActionOverlay.#removeOverlay(owner, overlay);\n      }\n    }\n    this.#overlay = null;\n  }\n  #loadOverlay(owner)\n  {\n    this.#overlay = this.overlayName ? ITr2ControllerAction.callTarget(owner, \"GetOverlayEffectByName\", this.overlayName) ?? Tr2ActionOverlay.#findNamed(owner, \"overlays\", this.overlayName) : null;\n    if (!this.#overlay && this.addOnStart && this.path)\n    {\n      const loaded = Tr2ActionOverlay.#loadOverlayResource(owner, this.#normalizePath(owner));\n      this.#overlay = loaded.overlay;\n      if (this.#overlay)\n      {\n        Tr2ActionOverlay.#setName(this.#overlay, this.overlayName);\n        if (!loaded.added)\n        {\n          Tr2ActionOverlay.#addOverlay(owner, this.#overlay);\n        }\n        ITr2ControllerAction.callTarget(this.#overlay, \"StartControllers\");\n      }\n    }\n  }\n  #normalizePath(owner)\n  {\n    let path = this.path.toLowerCase();\n    const animated = !!ITr2ControllerAction.callTarget(owner, \"IsAnimated\");\n    if (animated && !path.includes(\"_skinned\"))\n    {\n      path = path.replace(/\\.red$/, \"_skinned.red\");\n    }\n    else if (!animated && path.includes(\"_skinned\"))\n    {\n      path = path.replace(\"_skinned\", \"\");\n    }\n    return path;\n  }\n  #resolveOwner(owner)\n  {\n    if (!owner)\n    {\n      return {\n        owner: null,\n        rebind: false\n      };\n    }\n    if (Tr2ActionOverlay.#isOverlayOwner(owner))\n    {\n      return {\n        owner,\n        rebind: false\n      };\n    }\n    if (!this.targetAnotherOwner)\n    {\n      return {\n        owner: null,\n        rebind: false\n      };\n    }\n    const parameterOwner = ITr2ControllerAction.getParameterOwner(owner, this.targetAnotherOwner);\n    if (parameterOwner && Tr2ActionOverlay.#isOverlayOwner(parameterOwner))\n    {\n      return {\n        owner: parameterOwner,\n        rebind: true\n      };\n    }\n    const stretchOwner = Tr2ActionOverlay.#getStretchOwner(owner, this.targetAnotherOwner);\n    if (stretchOwner && Tr2ActionOverlay.#isOverlayOwner(stretchOwner))\n    {\n      return {\n        owner: stretchOwner,\n        rebind: true\n      };\n    }\n    return {\n      owner: null,\n      rebind: false\n    };\n  }\n\n  static #addOverlay(owner, overlay)\n  {\n    if (ITr2ControllerAction.hasFunction(owner, \"AddOverlayEffect\"))\n    {\n      owner.AddOverlayEffect(overlay);\n      return;\n    }\n    this.#addToArray(owner, \"overlays\", overlay);\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 #findNamed(owner, listName, name)\n  {\n    if (ITr2ControllerAction.hasProperty(owner, listName) && Array.isArray(owner[listName]))\n    {\n      return owner[listName].find(item => ITr2ControllerAction.callTarget(item, \"GetName\") === name || ITr2ControllerAction.hasProperty(item, \"name\") && item.name === name) ?? null;\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 #isOverlayOwner(owner)\n  {\n    return !!owner && typeof owner === \"object\" && (ITr2ControllerAction.hasFunction(owner, \"GetOverlayEffectByName\") || ITr2ControllerAction.hasFunction(owner, \"AddOverlayEffect\") || ITr2ControllerAction.hasFunction(owner, \"RemoveOverlayEffect\") || ITr2ControllerAction.hasProperty(owner, \"overlays\"));\n  }\n\n  static #loadOverlayResource(owner, path)\n  {\n    const loaded = ITr2ControllerAction.callTarget(owner, \"LoadOverlayEffectFromPath\", path) ?? ITr2ControllerAction.callTarget(owner, \"LoadOverlayEffect\", path);\n    if (loaded)\n    {\n      return { overlay: loaded, added: false };\n    }\n    const added = ITr2ControllerAction.callTarget(owner, \"AddOverlayEffectFromPath\", path);\n    return { overlay: added, added: !!added };\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  static #removeOverlay(owner, overlay)\n  {\n    if (ITr2ControllerAction.hasFunction(owner, \"RemoveOverlayEffect\"))\n    {\n      owner.RemoveOverlayEffect(overlay);\n      return;\n    }\n    this.#removeFromArray(owner, \"overlays\", overlay);\n  }\n\n  static #setName(target, name)\n  {\n    if (!name || !target || typeof target !== \"object\")\n    {\n      return;\n    }\n    if (ITr2ControllerAction.hasFunction(target, \"SetName\"))\n    {\n      target.SetName(name);\n      return;\n    }\n    target.name = name;\n  }\n}\n"],"names":["_Tr2ActionOverlay","_identity","Tr2ActionOverlay","CjsModel","e","_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","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","persist","path","string","boolean","carbon","method","impl","adapted","overlayName","targetAnotherOwner","addOnStart","removeOnStop","Start","controller","controllerOwner","ITr2ControllerAction","getOwner","resolved","owner","rebind","callTarget","Stop","overlay","#loadOverlay","loaded","added","#normalizePath","toLowerCase","animated","includes","replace","#resolveOwner","parameterOwner","getParameterOwner","stretchOwner","#addOverlay","hasFunction","AddOverlayEffect","#addToArray","listName","value","hasProperty","Array","isArray","push","#findNamed","name","find","item","#getStretchOwner","asObject","getProperty","#isOverlayOwner","#loadOverlayResource","#removeFromArray","index","indexOf","splice","#removeOverlay","RemoveOverlayEffect","#setName","target","SetName","constructor"],"mappings":"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"}
+{"version":3,"file":"Tr2ActionOverlay.js","sources":["../../../src/controllers/Tr2ActionOverlay.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\Controllers\\Actions\\Tr2ActionOverlay.h\n// Source: E:\\carbonengine\\trinity\\trinity\\Controllers\\Actions\\Tr2ActionOverlay.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 adds a named overlay effect to its owner when the\n * action starts and removes it again when the action stops.\n */\n@type.define({\n  className: \"Tr2ActionOverlay\",\n  family: \"controllers\"\n})\nexport class Tr2ActionOverlay extends CjsModel\n{\n  @io.persist\n  @type.path\n  path = \"\";\n\n  @io.persist\n  @type.string\n  overlayName = \"\";\n\n  @io.persist\n  @type.string\n  targetAnotherOwner = \"\";\n\n  @io.persist\n  @type.boolean\n  addOnStart = true;\n\n  @io.persist\n  @type.boolean\n  removeOnStop = true;\n\n  #overlay = null;\n\n  /**\n   * Loads and starts the target overlay when Carbon would add it.\n   */\n  @carbon.method\n  @impl.adapted\n  Start(controller)\n  {\n    const controllerOwner = ITr2ControllerAction.getOwner(controller);\n    const resolved = this.#resolveOwner(controllerOwner);\n    if (!resolved.owner)\n    {\n      return;\n    }\n    this.#loadOverlay(resolved.owner);\n    if (resolved.rebind)\n    {\n      ITr2ControllerAction.callTarget(controllerOwner, \"Rebind\", true);\n    }\n  }\n\n  /**\n   * Stops or removes the target overlay.\n   */\n  @carbon.method\n  @impl.adapted\n  Stop(controller)\n  {\n    const overlay = this.#overlay;\n    if (!overlay)\n    {\n      return;\n    }\n    if (this.removeOnStop)\n    {\n      const owner = this.#resolveOwner(ITr2ControllerAction.getOwner(controller)).owner;\n      if (owner)\n      {\n        Tr2ActionOverlay.#removeOverlay(owner, overlay);\n      }\n    }\n    this.#overlay = null;\n  }\n\n  /**\n   * Finds the overlay already present on the owner by name, and only when it is\n   * absent and addOnStart is set loads it from the authored path, names it,\n   * attaches it, and starts its controllers.\n   */\n  #loadOverlay(owner)\n  {\n    this.#overlay = this.overlayName ? ITr2ControllerAction.callTarget(owner, \"GetOverlayEffectByName\", this.overlayName) ?? Tr2ActionOverlay.#findNamed(owner, \"overlays\", this.overlayName) : null;\n    if (!this.#overlay && this.addOnStart && this.path)\n    {\n      const loaded = Tr2ActionOverlay.#loadOverlayResource(owner, this.#normalizePath(owner));\n      this.#overlay = loaded.overlay;\n      if (this.#overlay)\n      {\n        Tr2ActionOverlay.#setName(this.#overlay, this.overlayName);\n        if (!loaded.added)\n        {\n          Tr2ActionOverlay.#addOverlay(owner, this.#overlay);\n        }\n        ITr2ControllerAction.callTarget(this.#overlay, \"StartControllers\");\n      }\n    }\n  }\n\n  /**\n   * Lower-cases the authored path and switches the `_skinned` suffix on or off\n   * to match whether the owner is animated.\n   */\n  #normalizePath(owner)\n  {\n    let path = this.path.toLowerCase();\n    const animated = !!ITr2ControllerAction.callTarget(owner, \"IsAnimated\");\n    if (animated && !path.includes(\"_skinned\"))\n    {\n      path = path.replace(/\\.red$/, \"_skinned.red\");\n    }\n    else if (!animated && path.includes(\"_skinned\"))\n    {\n      path = path.replace(\"_skinned\", \"\");\n    }\n    return path;\n  }\n\n  /**\n   * Picks the object the overlay is attached to, preferring the controller owner\n   * itself and otherwise following targetAnotherOwner through a named parameter\n   * or a stretch endpoint; `rebind` is set when the redirect requires the\n   * controller owner to rebind.\n   */\n  #resolveOwner(owner)\n  {\n    if (!owner)\n    {\n      return {\n        owner: null,\n        rebind: false\n      };\n    }\n    if (Tr2ActionOverlay.#isOverlayOwner(owner))\n    {\n      return {\n        owner,\n        rebind: false\n      };\n    }\n    if (!this.targetAnotherOwner)\n    {\n      return {\n        owner: null,\n        rebind: false\n      };\n    }\n    const parameterOwner = ITr2ControllerAction.getParameterOwner(owner, this.targetAnotherOwner);\n    if (parameterOwner && Tr2ActionOverlay.#isOverlayOwner(parameterOwner))\n    {\n      return {\n        owner: parameterOwner,\n        rebind: true\n      };\n    }\n    const stretchOwner = Tr2ActionOverlay.#getStretchOwner(owner, this.targetAnotherOwner);\n    if (stretchOwner && Tr2ActionOverlay.#isOverlayOwner(stretchOwner))\n    {\n      return {\n        owner: stretchOwner,\n        rebind: true\n      };\n    }\n    return {\n      owner: null,\n      rebind: false\n    };\n  }\n\n  /**\n   * Attaches an overlay through the owner's AddOverlayEffect, falling back to\n   * pushing onto a plain `overlays` array.\n   */\n  static #addOverlay(owner, overlay)\n  {\n    if (ITr2ControllerAction.hasFunction(owner, \"AddOverlayEffect\"))\n    {\n      owner.AddOverlayEffect(overlay);\n      return;\n    }\n    this.#addToArray(owner, \"overlays\", overlay);\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   * Finds an entry in a named array property whose GetName() or `name` matches,\n   * or null.\n   */\n  static #findNamed(owner, listName, name)\n  {\n    if (ITr2ControllerAction.hasProperty(owner, listName) && Array.isArray(owner[listName]))\n    {\n      return owner[listName].find(item => ITr2ControllerAction.callTarget(item, \"GetName\") === name || ITr2ControllerAction.hasProperty(item, \"name\") && item.name === name) ?? null;\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   * Checks whether an object can hold overlays, by exposing any of the overlay\n   * accessor methods or a plain `overlays` array.\n   */\n  static #isOverlayOwner(owner)\n  {\n    return !!owner && typeof owner === \"object\" && (ITr2ControllerAction.hasFunction(owner, \"GetOverlayEffectByName\") || ITr2ControllerAction.hasFunction(owner, \"AddOverlayEffect\") || ITr2ControllerAction.hasFunction(owner, \"RemoveOverlayEffect\") || ITr2ControllerAction.hasProperty(owner, \"overlays\"));\n  }\n\n  /**\n   * Loads an overlay from a path through whichever owner loader exists,\n   * reporting in `added` whether that loader already attached it to the owner.\n   */\n  static #loadOverlayResource(owner, path)\n  {\n    const loaded = ITr2ControllerAction.callTarget(owner, \"LoadOverlayEffectFromPath\", path) ?? ITr2ControllerAction.callTarget(owner, \"LoadOverlayEffect\", path);\n    if (loaded)\n    {\n      return { overlay: loaded, added: false };\n    }\n    const added = ITr2ControllerAction.callTarget(owner, \"AddOverlayEffectFromPath\", path);\n    return { overlay: added, added: !!added };\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  /**\n   * Detaches an overlay through the owner's RemoveOverlayEffect, falling back to\n   * splicing it out of a plain `overlays` array.\n   */\n  static #removeOverlay(owner, overlay)\n  {\n    if (ITr2ControllerAction.hasFunction(owner, \"RemoveOverlayEffect\"))\n    {\n      owner.RemoveOverlayEffect(overlay);\n      return;\n    }\n    this.#removeFromArray(owner, \"overlays\", overlay);\n  }\n\n  /**\n   * Names a loaded overlay through SetName when available, otherwise by\n   * assigning the `name` property; an empty name is ignored.\n   */\n  static #setName(target, name)\n  {\n    if (!name || !target || typeof target !== \"object\")\n    {\n      return;\n    }\n    if (ITr2ControllerAction.hasFunction(target, \"SetName\"))\n    {\n      target.SetName(name);\n      return;\n    }\n    target.name = name;\n  }\n}\n"],"names":["_Tr2ActionOverlay","_identity","Tr2ActionOverlay","CjsModel","e","_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","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","persist","path","string","boolean","carbon","method","impl","adapted","overlayName","targetAnotherOwner","addOnStart","removeOnStop","Start","controller","controllerOwner","ITr2ControllerAction","getOwner","resolved","owner","rebind","callTarget","Stop","overlay","#loadOverlay","loaded","added","#normalizePath","toLowerCase","animated","includes","replace","#resolveOwner","parameterOwner","getParameterOwner","stretchOwner","#addOverlay","hasFunction","AddOverlayEffect","#addToArray","listName","value","hasProperty","Array","isArray","push","#findNamed","name","find","item","#getStretchOwner","asObject","getProperty","#isOverlayOwner","#loadOverlayResource","#removeFromArray","index","indexOf","splice","#removeOverlay","RemoveOverlayEffect","#setName","target","SetName","constructor"],"mappings":"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"}

package/dist/controllers/Tr2ActionPlayCurveSet.js

@@ -5,6 +5,12 @@ import { GetControllerTimeSeconds } from './contracts.js';
 import { ITr2ControllerAction } from './ITr2ControllerAction.js';
 
 let _initProto, _initClass, _init_curveSetName, _init_extra_curveSetName, _init_rangeName, _init_extra_rangeName, _init_syncToRange, _init_extra_syncToRange;
+
+/**
+ * Controller action that plays a named curve set (optionally one named range) on
+ * its owner for the duration of the action, and can hold off state transitions
+ * until a synced range iteration has completed.
+ */
 let _Tr2ActionPlayCurveSe;
 class Tr2ActionPlayCurveSet extends CjsModel {
   static {
@@ -86,6 +92,11 @@ class Tr2ActionPlayCurveSet extends CjsModel {
   Update(_realTime, simTime) {
     this.#prevTime = simTime;
   }
+
+  /**
+   * Starts the curve set on the owner, returning false when the owner exposes no
+   * PlayCurveSet.
+   */
   #play(owner) {
     if (ITr2ControllerAction.hasFunction(owner, "PlayCurveSet")) {
       owner.PlayCurveSet(this.curveSetName, this.rangeName);
@@ -93,6 +104,11 @@ class Tr2ActionPlayCurveSet extends CjsModel {
     }
     return false;
   }
+
+  /**
+   * Gets the authored range duration in seconds from the owner, or 0 when the
+   * owner cannot report one.
+   */
   #getRangeDuration(owner) {
     const ownerDuration = ITr2ControllerAction.callTarget(owner, "GetRangeDuration", this.curveSetName, this.rangeName);
     if (ownerDuration !== undefined) {

package/dist/controllers/Tr2ActionPlayCurveSet.js.map

@@ -1 +1 @@
-{"version":3,"file":"Tr2ActionPlayCurveSet.js","sources":["../../../src/controllers/Tr2ActionPlayCurveSet.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\Controllers\\Actions\\Tr2ActionPlayCurveSet.h\n// Source: E:\\carbonengine\\trinity\\trinity\\Controllers\\Actions\\Tr2ActionPlayCurveSet.cpp\nimport { CjsModel } from \"@carbonenginejs/runtime-utils/model\";\nimport { carbon, impl, io, type } from \"@carbonenginejs/runtime-utils/schema\";\nimport { GetControllerTimeSeconds } from \"./contracts.js\";\nimport { ITr2ControllerAction } from \"./ITr2ControllerAction.js\";\n\n\n@type.define({\n  className: \"Tr2ActionPlayCurveSet\",\n  family: \"controllers\"\n})\nexport class Tr2ActionPlayCurveSet extends CjsModel\n{\n  @io.persist\n  @type.string\n  curveSetName = \"\";\n\n  @io.persist\n  @type.string\n  rangeName = \"\";\n\n  @io.persist\n  @type.boolean\n  syncToRange = false;\n\n  #controller = null;\n\n  #startTime = 0;\n\n  #prevTime = 0;\n\n  #duration = 0;\n\n  /**\n   * Plays the configured curve set.\n   */\n  @carbon.method\n  @impl.adapted\n  Start(controller)\n  {\n    const owner = ITr2ControllerAction.getOwner(controller);\n    this.#controller = controller;\n    this.#duration = 0;\n    if (!this.#play(owner))\n    {\n      return;\n    }\n    if (this.syncToRange && this.rangeName)\n    {\n      this.#duration = this.#getRangeDuration(owner);\n      this.#startTime = ITr2ControllerAction.getTime(controller, GetControllerTimeSeconds());\n      this.#prevTime = this.#startTime;\n      controller.RegisterUpdateable?.(this);\n    }\n  }\n\n  /**\n   * Stops the configured curve set.\n   */\n  @carbon.method\n  @impl.adapted\n  Stop(controller)\n  {\n    const owner = ITr2ControllerAction.getOwner(controller);\n    controller.UnRegisterUpdateable?.(this);\n    if (this.#controller === controller)\n    {\n      this.#controller = null;\n    }\n    if (ITr2ControllerAction.hasFunction(owner, \"StopCurveSet\"))\n    {\n      owner.StopCurveSet(this.curveSetName);\n    }\n  }\n\n  /**\n   * Rebases the sync-to-range time cursor.\n   */\n  @carbon.method\n  @impl.implemented\n  RebaseSimTime(diff)\n  {\n    this.#startTime += diff;\n    this.#prevTime += diff;\n  }\n\n  /**\n   * Prevents transition until a synced range iteration has completed.\n   */\n  @carbon.method\n  @impl.adapted\n  CanTransition()\n  {\n    if (!this.syncToRange || this.#duration <= 0)\n    {\n      return true;\n    }\n    const now = GetControllerTimeSeconds();\n    if (now === this.#startTime)\n    {\n      return true;\n    }\n    const previous = Math.floor((this.#prevTime - this.#startTime) / this.#duration);\n    const current = Math.floor((now - this.#startTime) / this.#duration);\n    return previous !== current;\n  }\n\n  /**\n   * Stores the last update time for synced transitions.\n   */\n  @carbon.method\n  @impl.implemented\n  Update(_realTime, simTime)\n  {\n    this.#prevTime = simTime;\n  }\n  #play(owner)\n  {\n    if (ITr2ControllerAction.hasFunction(owner, \"PlayCurveSet\"))\n    {\n      owner.PlayCurveSet(this.curveSetName, this.rangeName);\n      return true;\n    }\n    return false;\n  }\n  #getRangeDuration(owner)\n  {\n    const ownerDuration = ITr2ControllerAction.callTarget(owner, \"GetRangeDuration\", this.curveSetName, this.rangeName);\n    if (ownerDuration !== undefined)\n    {\n      return ITr2ControllerAction.toNumber(ownerDuration);\n    }\n    return 0;\n  }\n}\n"],"names":["_Tr2ActionPlayCurveSe","Tr2ActionPlayCurveSet","CjsModel","e","_init_curveSetName","_init_extra_curveSetName","_init_rangeName","_init_extra_rangeName","_init_syncToRange","_init_extra_syncToRange","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","persist","string","boolean","carbon","method","impl","adapted","implemented","curveSetName","rangeName","syncToRange","Start","controller","owner","ITr2ControllerAction","getOwner","getTime","GetControllerTimeSeconds","RegisterUpdateable","Stop","UnRegisterUpdateable","hasFunction","StopCurveSet","RebaseSimTime","diff","CanTransition","now","previous","Math","floor","current","Update","_realTime","simTime","#play","PlayCurveSet","#getRangeDuration","ownerDuration","callTarget","undefined","toNumber"],"mappings":"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"}
+{"version":3,"file":"Tr2ActionPlayCurveSet.js","sources":["../../../src/controllers/Tr2ActionPlayCurveSet.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\Controllers\\Actions\\Tr2ActionPlayCurveSet.h\n// Source: E:\\carbonengine\\trinity\\trinity\\Controllers\\Actions\\Tr2ActionPlayCurveSet.cpp\nimport { CjsModel } from \"@carbonenginejs/runtime-utils/model\";\nimport { carbon, impl, io, type } from \"@carbonenginejs/runtime-utils/schema\";\nimport { GetControllerTimeSeconds } from \"./contracts.js\";\nimport { ITr2ControllerAction } from \"./ITr2ControllerAction.js\";\n\n\n/**\n * Controller action that plays a named curve set (optionally one named range) on\n * its owner for the duration of the action, and can hold off state transitions\n * until a synced range iteration has completed.\n */\n@type.define({\n  className: \"Tr2ActionPlayCurveSet\",\n  family: \"controllers\"\n})\nexport class Tr2ActionPlayCurveSet extends CjsModel\n{\n  @io.persist\n  @type.string\n  curveSetName = \"\";\n\n  @io.persist\n  @type.string\n  rangeName = \"\";\n\n  @io.persist\n  @type.boolean\n  syncToRange = false;\n\n  #controller = null;\n\n  #startTime = 0;\n\n  #prevTime = 0;\n\n  #duration = 0;\n\n  /**\n   * Plays the configured curve set.\n   */\n  @carbon.method\n  @impl.adapted\n  Start(controller)\n  {\n    const owner = ITr2ControllerAction.getOwner(controller);\n    this.#controller = controller;\n    this.#duration = 0;\n    if (!this.#play(owner))\n    {\n      return;\n    }\n    if (this.syncToRange && this.rangeName)\n    {\n      this.#duration = this.#getRangeDuration(owner);\n      this.#startTime = ITr2ControllerAction.getTime(controller, GetControllerTimeSeconds());\n      this.#prevTime = this.#startTime;\n      controller.RegisterUpdateable?.(this);\n    }\n  }\n\n  /**\n   * Stops the configured curve set.\n   */\n  @carbon.method\n  @impl.adapted\n  Stop(controller)\n  {\n    const owner = ITr2ControllerAction.getOwner(controller);\n    controller.UnRegisterUpdateable?.(this);\n    if (this.#controller === controller)\n    {\n      this.#controller = null;\n    }\n    if (ITr2ControllerAction.hasFunction(owner, \"StopCurveSet\"))\n    {\n      owner.StopCurveSet(this.curveSetName);\n    }\n  }\n\n  /**\n   * Rebases the sync-to-range time cursor.\n   */\n  @carbon.method\n  @impl.implemented\n  RebaseSimTime(diff)\n  {\n    this.#startTime += diff;\n    this.#prevTime += diff;\n  }\n\n  /**\n   * Prevents transition until a synced range iteration has completed.\n   */\n  @carbon.method\n  @impl.adapted\n  CanTransition()\n  {\n    if (!this.syncToRange || this.#duration <= 0)\n    {\n      return true;\n    }\n    const now = GetControllerTimeSeconds();\n    if (now === this.#startTime)\n    {\n      return true;\n    }\n    const previous = Math.floor((this.#prevTime - this.#startTime) / this.#duration);\n    const current = Math.floor((now - this.#startTime) / this.#duration);\n    return previous !== current;\n  }\n\n  /**\n   * Stores the last update time for synced transitions.\n   */\n  @carbon.method\n  @impl.implemented\n  Update(_realTime, simTime)\n  {\n    this.#prevTime = simTime;\n  }\n\n  /**\n   * Starts the curve set on the owner, returning false when the owner exposes no\n   * PlayCurveSet.\n   */\n  #play(owner)\n  {\n    if (ITr2ControllerAction.hasFunction(owner, \"PlayCurveSet\"))\n    {\n      owner.PlayCurveSet(this.curveSetName, this.rangeName);\n      return true;\n    }\n    return false;\n  }\n\n  /**\n   * Gets the authored range duration in seconds from the owner, or 0 when the\n   * owner cannot report one.\n   */\n  #getRangeDuration(owner)\n  {\n    const ownerDuration = ITr2ControllerAction.callTarget(owner, \"GetRangeDuration\", this.curveSetName, this.rangeName);\n    if (ownerDuration !== undefined)\n    {\n      return ITr2ControllerAction.toNumber(ownerDuration);\n    }\n    return 0;\n  }\n}\n"],"names":["_Tr2ActionPlayCurveSe","Tr2ActionPlayCurveSet","CjsModel","e","_init_curveSetName","_init_extra_curveSetName","_init_rangeName","_init_extra_rangeName","_init_syncToRange","_init_extra_syncToRange","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","persist","string","boolean","carbon","method","impl","adapted","implemented","curveSetName","rangeName","syncToRange","Start","controller","owner","ITr2ControllerAction","getOwner","getTime","GetControllerTimeSeconds","RegisterUpdateable","Stop","UnRegisterUpdateable","hasFunction","StopCurveSet","RebaseSimTime","diff","CanTransition","now","previous","Math","floor","current","Update","_realTime","simTime","#play","PlayCurveSet","#getRangeDuration","ownerDuration","callTarget","undefined","toNumber"],"mappings":"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"}

package/dist/controllers/Tr2ActionPlayMeshAnimation.js

@@ -6,6 +6,12 @@ import { ITr2ControllerAction } from './ITr2ControllerAction.js';
 import { Tr2BindingPoint as _Tr2BindingPoint } from './Tr2BindingPoint.js';
 
 let _initProto, _initClass, _init_destinationType, _init_extra_destinationType, _init_playAction, _init_extra_playAction, _init_stopAction, _init_extra_stopAction, _init_mask, _init_extra_mask, _init_animation, _init_extra_animation, _init_speed, _init_extra_speed, _init_delay, _init_extra_delay, _init_destination, _init_extra_destination, _init_delayBinding, _init_extra_delayBinding, _init_loops, _init_extra_loops, _init_path, _init_extra_path;
+
+/**
+ * Controller action that plays or enqueues a named geometry animation on a
+ * destination object's animation controller when it starts, and stops or
+ * enqueues a stop when it ends.
+ */
 let _Tr2ActionPlayMeshAni;
 new class extends _identity {
   static [class Tr2ActionPlayMeshAnimation extends CjsModel {
@@ -124,10 +130,18 @@ new class extends _identity {
       }
       return true;
     }
+
+    /** Resolves and caches the destination object, returning it. */
     LinkDestination(controller = this.#controller) {
       this.#resolvedDestination = this.ResolveDestination(controller);
       return this.#resolvedDestination;
     }
+
+    /**
+     * Gets the object whose animation controller is driven: the controller owner
+     * for destinationType OWNER, otherwise the cached resolved destination,
+     * re-resolved when it is missing or binding is delayed.
+     */
     GetDestination(controller = this.#controller) {
       if (this.destinationType === DestinationType.OWNER) {
         return ITr2ControllerAction.getOwner(controller);
@@ -137,15 +151,30 @@ new class extends _identity {
       }
       return this.#resolvedDestination;
     }
+
+    /**
+     * Checks whether a destination is reachable; destinationType OWNER is always
+     * considered valid.
+     */
     IsBindingValid() {
       if (this.destinationType === DestinationType.OWNER) {
         return true;
       }
       return !!this.GetDestination();
     }
+
+    /**
+     * Alias for IsBindingValid, kept for callers using Carbon's destination
+     * wording.
+     */
     IsDestinationValid() {
       return this.IsBindingValid();
     }
+
+    /**
+     * Resolves the destination from the directly assigned object, otherwise by
+     * walking the authored path against the controller's binding roots.
+     */
     ResolveDestination(controller) {
       if (this.destination) {
         return this.destination;

package/dist/controllers/Tr2ActionPlayMeshAnimation.js.map

@@ -1 +1 @@
-{"version":3,"file":"Tr2ActionPlayMeshAnimation.js","sources":["../../../src/controllers/Tr2ActionPlayMeshAnimation.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\Controllers\\Actions\\Tr2ActionPlayMeshAnimation.h\r\n// Source: E:\\carbonengine\\trinity\\trinity\\Controllers\\Actions\\Tr2ActionPlayMeshAnimation.cpp\r\nimport { CjsModel } from \"@carbonenginejs/runtime-utils/model\";\r\nimport { carbon, impl, io, schema, type } from \"@carbonenginejs/runtime-utils/schema\";\r\nimport { DestinationType, PlayAction, StopAction } from \"./enums.js\";\r\nimport { ITr2ControllerAction } from \"./ITr2ControllerAction.js\";\r\nimport { Tr2BindingPoint } from \"./Tr2BindingPoint.js\";\r\n\r\n\r\n@type.define({\r\n  className: \"Tr2ActionPlayMeshAnimation\",\r\n  family: \"controllers\"\r\n})\r\nexport class Tr2ActionPlayMeshAnimation extends CjsModel\r\n{\r\n  @io.notify\r\n  @io.persist\r\n  @type.int32\r\n  @schema.enum(\"DestinationType\")\r\n  destinationType = DestinationType.OWNER;\r\n\r\n  @io.persist\r\n  @type.int32\r\n  @schema.enum(\"PlayAction\")\r\n  playAction = PlayAction.ENQUEUE_PLAY;\r\n\r\n  @io.persist\r\n  @type.int32\r\n  @schema.enum(\"StopAction\")\r\n  stopAction = StopAction.ENQUEUE_STOP;\r\n\r\n  @io.persist\r\n  @type.string\r\n  mask = \"\";\r\n\r\n  @io.persist\r\n  @type.string\r\n  animation = \"\";\r\n\r\n  @io.persist\r\n  @type.float32\r\n  speed = 1;\r\n\r\n  @io.persist\r\n  @type.float32\r\n  delay = 0;\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.persist\r\n  @type.int32\r\n  loops = -1;\r\n\r\n  @io.notify\r\n  @io.persist\r\n  @type.string\r\n  path = \"\";\r\n\r\n  #controller = null;\r\n\r\n  #resolvedDestination = 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.delayBinding)\r\n    {\r\n      this.LinkDestination(controller);\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Clears the resolved destination.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  Unlink()\r\n  {\r\n    this.#resolvedDestination = null;\r\n    this.#controller = null;\r\n  }\r\n\r\n  /**\r\n   * Starts or queues a mesh animation.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  Start(controller = this.#controller)\r\n  {\r\n    const destination = this.GetDestination(controller);\r\n    const animationController = ITr2ControllerAction.getAnimationController(destination);\r\n    if (!animationController || !this.animation)\r\n    {\r\n      return;\r\n    }\r\n    const layerName = this.mask || null;\r\n    if (this.mask && ITr2ControllerAction.hasFunction(animationController, \"AddAnimationLayerWithTrackMask\"))\r\n    {\r\n      animationController.AddAnimationLayerWithTrackMask(this.mask, this.mask);\r\n    }\r\n    if (ITr2ControllerAction.hasFunction(animationController, \"PlayLayerAnimationByName\"))\r\n    {\r\n      animationController.PlayLayerAnimationByName(layerName, this.animation, this.playAction === PlayAction.PLAY, Math.max(this.loops, 0), this.delay, this.speed, false);\r\n      return;\r\n    }\r\n    const methodName = this.playAction === PlayAction.ENQUEUE_PLAY ? \"EnqueueAnimation\" : \"PlayAnimation\";\r\n    if (ITr2ControllerAction.hasFunction(animationController, methodName))\r\n    {\r\n      animationController[methodName](this.animation, layerName, this.speed, this.delay, this.loops);\r\n      return;\r\n    }\r\n    if (ITr2ControllerAction.hasFunction(animationController, \"Play\"))\r\n    {\r\n      animationController.Play(this.animation);\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Stops or queues a stop for the mesh animation.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  Stop(controller = this.#controller)\r\n  {\r\n    if (this.stopAction === StopAction.NONE)\r\n    {\r\n      return;\r\n    }\r\n    const destination = this.GetDestination(controller);\r\n    const animationController = ITr2ControllerAction.getAnimationController(destination);\r\n    if (!animationController || !this.animation)\r\n    {\r\n      return;\r\n    }\r\n    const layerName = this.mask || null;\r\n    if (ITr2ControllerAction.hasFunction(animationController, \"GetAnimationLayer\"))\r\n    {\r\n      const layer = animationController.GetAnimationLayer(layerName);\r\n      if (!layer)\r\n      {\r\n        return;\r\n      }\r\n      if (this.stopAction === StopAction.STOP && ITr2ControllerAction.hasFunction(layer, \"ClearAnimations\"))\r\n      {\r\n        layer.ClearAnimations();\r\n        return;\r\n      }\r\n      if (this.stopAction === StopAction.ENQUEUE_STOP && ITr2ControllerAction.hasFunction(layer, \"EndAnimation\"))\r\n      {\r\n        layer.EndAnimation();\r\n        return;\r\n      }\r\n      return;\r\n    }\r\n    const methodName = this.stopAction === StopAction.ENQUEUE_STOP ? \"EnqueueStopAnimation\" : \"StopAnimation\";\r\n    if (ITr2ControllerAction.hasFunction(animationController, methodName))\r\n    {\r\n      animationController[methodName](this.animation, layerName);\r\n      return;\r\n    }\r\n    if (ITr2ControllerAction.hasFunction(animationController, \"Stop\"))\r\n    {\r\n      animationController.Stop(this.animation);\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Relinks after authored destination changes.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  OnModified(_options = {})\r\n  {\r\n    if (this.#controller && !this.delayBinding)\r\n    {\r\n      this.LinkDestination(this.#controller);\r\n    }\r\n    return true;\r\n  }\r\n  LinkDestination(controller = this.#controller)\r\n  {\r\n    this.#resolvedDestination = this.ResolveDestination(controller);\r\n    return this.#resolvedDestination;\r\n  }\r\n  @carbon.method\r\n  @impl.adapted\r\n  GetDestination(controller = this.#controller)\r\n  {\r\n    if (this.destinationType === DestinationType.OWNER)\r\n    {\r\n      return ITr2ControllerAction.getOwner(controller);\r\n    }\r\n    if (!this.#resolvedDestination || this.delayBinding)\r\n    {\r\n      return this.LinkDestination(controller);\r\n    }\r\n    return this.#resolvedDestination;\r\n  }\r\n  @carbon.method\r\n  @impl.adapted\r\n  IsBindingValid()\r\n  {\r\n    if (this.destinationType === DestinationType.OWNER)\r\n    {\r\n      return true;\r\n    }\r\n    return !!this.GetDestination();\r\n  }\r\n  IsDestinationValid()\r\n  {\r\n    return this.IsBindingValid();\r\n  }\r\n  ResolveDestination(controller)\r\n  {\r\n    if (this.destination)\r\n    {\r\n      return this.destination;\r\n    }\r\n    if (this.path && controller)\r\n    {\r\n      return Tr2BindingPoint.ResolvePath(this.path, controller.GetBindingPathRoots?.() ?? []);\r\n    }\r\n    return null;\r\n  }\r\n\r\n  static DestinationType = DestinationType;\r\n\r\n  static PlayAction = PlayAction;\r\n\r\n  static StopAction = StopAction;\r\n\r\n}\r\n"],"names":["_Tr2ActionPlayMeshAni","_identity","Tr2ActionPlayMeshAnimation","CjsModel","e","_init_destinationType","_init_extra_destinationType","_init_playAction","_init_extra_playAction","_init_stopAction","_init_extra_stopAction","_init_mask","_init_extra_mask","_init_animation","_init_extra_animation","_init_speed","_init_extra_speed","_init_delay","_init_extra_delay","_init_destination","_init_extra_destination","_init_delayBinding","_init_extra_delayBinding","_init_loops","_init_extra_loops","_init_path","_init_extra_path","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","notify","persist","int32","schema","enum","string","float32","objectRef","boolean","carbon","method","impl","adapted","implemented","destinationType","DestinationType","OWNER","playAction","PlayAction","ENQUEUE_PLAY","stopAction","StopAction","ENQUEUE_STOP","mask","animation","speed","delay","destination","delayBinding","loops","path","Link","controller","LinkDestination","Unlink","Start","GetDestination","animationController","ITr2ControllerAction","getAnimationController","layerName","hasFunction","AddAnimationLayerWithTrackMask","PlayLayerAnimationByName","PLAY","Math","max","methodName","Play","Stop","NONE","layer","GetAnimationLayer","STOP","ClearAnimations","EndAnimation","OnModified","_options","ResolveDestination","getOwner","IsBindingValid","IsDestinationValid","Tr2BindingPoint","ResolvePath","GetBindingPathRoots","constructor"],"mappings":"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"}
+{"version":3,"file":"Tr2ActionPlayMeshAnimation.js","sources":["../../../src/controllers/Tr2ActionPlayMeshAnimation.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\Controllers\\Actions\\Tr2ActionPlayMeshAnimation.h\r\n// Source: E:\\carbonengine\\trinity\\trinity\\Controllers\\Actions\\Tr2ActionPlayMeshAnimation.cpp\r\nimport { CjsModel } from \"@carbonenginejs/runtime-utils/model\";\r\nimport { carbon, impl, io, schema, type } from \"@carbonenginejs/runtime-utils/schema\";\r\nimport { DestinationType, PlayAction, StopAction } from \"./enums.js\";\r\nimport { ITr2ControllerAction } from \"./ITr2ControllerAction.js\";\r\nimport { Tr2BindingPoint } from \"./Tr2BindingPoint.js\";\r\n\r\n\r\n/**\r\n * Controller action that plays or enqueues a named geometry animation on a\r\n * destination object's animation controller when it starts, and stops or\r\n * enqueues a stop when it ends.\r\n */\r\n@type.define({\r\n  className: \"Tr2ActionPlayMeshAnimation\",\r\n  family: \"controllers\"\r\n})\r\nexport class Tr2ActionPlayMeshAnimation extends CjsModel\r\n{\r\n  @io.notify\r\n  @io.persist\r\n  @type.int32\r\n  @schema.enum(\"DestinationType\")\r\n  destinationType = DestinationType.OWNER;\r\n\r\n  @io.persist\r\n  @type.int32\r\n  @schema.enum(\"PlayAction\")\r\n  playAction = PlayAction.ENQUEUE_PLAY;\r\n\r\n  @io.persist\r\n  @type.int32\r\n  @schema.enum(\"StopAction\")\r\n  stopAction = StopAction.ENQUEUE_STOP;\r\n\r\n  @io.persist\r\n  @type.string\r\n  mask = \"\";\r\n\r\n  @io.persist\r\n  @type.string\r\n  animation = \"\";\r\n\r\n  @io.persist\r\n  @type.float32\r\n  speed = 1;\r\n\r\n  @io.persist\r\n  @type.float32\r\n  delay = 0;\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.persist\r\n  @type.int32\r\n  loops = -1;\r\n\r\n  @io.notify\r\n  @io.persist\r\n  @type.string\r\n  path = \"\";\r\n\r\n  #controller = null;\r\n\r\n  #resolvedDestination = 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.delayBinding)\r\n    {\r\n      this.LinkDestination(controller);\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Clears the resolved destination.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  Unlink()\r\n  {\r\n    this.#resolvedDestination = null;\r\n    this.#controller = null;\r\n  }\r\n\r\n  /**\r\n   * Starts or queues a mesh animation.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  Start(controller = this.#controller)\r\n  {\r\n    const destination = this.GetDestination(controller);\r\n    const animationController = ITr2ControllerAction.getAnimationController(destination);\r\n    if (!animationController || !this.animation)\r\n    {\r\n      return;\r\n    }\r\n    const layerName = this.mask || null;\r\n    if (this.mask && ITr2ControllerAction.hasFunction(animationController, \"AddAnimationLayerWithTrackMask\"))\r\n    {\r\n      animationController.AddAnimationLayerWithTrackMask(this.mask, this.mask);\r\n    }\r\n    if (ITr2ControllerAction.hasFunction(animationController, \"PlayLayerAnimationByName\"))\r\n    {\r\n      animationController.PlayLayerAnimationByName(layerName, this.animation, this.playAction === PlayAction.PLAY, Math.max(this.loops, 0), this.delay, this.speed, false);\r\n      return;\r\n    }\r\n    const methodName = this.playAction === PlayAction.ENQUEUE_PLAY ? \"EnqueueAnimation\" : \"PlayAnimation\";\r\n    if (ITr2ControllerAction.hasFunction(animationController, methodName))\r\n    {\r\n      animationController[methodName](this.animation, layerName, this.speed, this.delay, this.loops);\r\n      return;\r\n    }\r\n    if (ITr2ControllerAction.hasFunction(animationController, \"Play\"))\r\n    {\r\n      animationController.Play(this.animation);\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Stops or queues a stop for the mesh animation.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  Stop(controller = this.#controller)\r\n  {\r\n    if (this.stopAction === StopAction.NONE)\r\n    {\r\n      return;\r\n    }\r\n    const destination = this.GetDestination(controller);\r\n    const animationController = ITr2ControllerAction.getAnimationController(destination);\r\n    if (!animationController || !this.animation)\r\n    {\r\n      return;\r\n    }\r\n    const layerName = this.mask || null;\r\n    if (ITr2ControllerAction.hasFunction(animationController, \"GetAnimationLayer\"))\r\n    {\r\n      const layer = animationController.GetAnimationLayer(layerName);\r\n      if (!layer)\r\n      {\r\n        return;\r\n      }\r\n      if (this.stopAction === StopAction.STOP && ITr2ControllerAction.hasFunction(layer, \"ClearAnimations\"))\r\n      {\r\n        layer.ClearAnimations();\r\n        return;\r\n      }\r\n      if (this.stopAction === StopAction.ENQUEUE_STOP && ITr2ControllerAction.hasFunction(layer, \"EndAnimation\"))\r\n      {\r\n        layer.EndAnimation();\r\n        return;\r\n      }\r\n      return;\r\n    }\r\n    const methodName = this.stopAction === StopAction.ENQUEUE_STOP ? \"EnqueueStopAnimation\" : \"StopAnimation\";\r\n    if (ITr2ControllerAction.hasFunction(animationController, methodName))\r\n    {\r\n      animationController[methodName](this.animation, layerName);\r\n      return;\r\n    }\r\n    if (ITr2ControllerAction.hasFunction(animationController, \"Stop\"))\r\n    {\r\n      animationController.Stop(this.animation);\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Relinks after authored destination changes.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  OnModified(_options = {})\r\n  {\r\n    if (this.#controller && !this.delayBinding)\r\n    {\r\n      this.LinkDestination(this.#controller);\r\n    }\r\n    return true;\r\n  }\r\n\r\n  /** Resolves and caches the destination object, returning it. */\r\n  LinkDestination(controller = this.#controller)\r\n  {\r\n    this.#resolvedDestination = this.ResolveDestination(controller);\r\n    return this.#resolvedDestination;\r\n  }\r\n\r\n  /**\r\n   * Gets the object whose animation controller is driven: the controller owner\r\n   * for destinationType OWNER, otherwise the cached resolved destination,\r\n   * re-resolved when it is missing or binding is delayed.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  GetDestination(controller = this.#controller)\r\n  {\r\n    if (this.destinationType === DestinationType.OWNER)\r\n    {\r\n      return ITr2ControllerAction.getOwner(controller);\r\n    }\r\n    if (!this.#resolvedDestination || this.delayBinding)\r\n    {\r\n      return this.LinkDestination(controller);\r\n    }\r\n    return this.#resolvedDestination;\r\n  }\r\n\r\n  /**\r\n   * Checks whether a destination is reachable; destinationType OWNER is always\r\n   * considered valid.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  IsBindingValid()\r\n  {\r\n    if (this.destinationType === DestinationType.OWNER)\r\n    {\r\n      return true;\r\n    }\r\n    return !!this.GetDestination();\r\n  }\r\n\r\n  /**\r\n   * Alias for IsBindingValid, kept for callers using Carbon's destination\r\n   * wording.\r\n   */\r\n  IsDestinationValid()\r\n  {\r\n    return this.IsBindingValid();\r\n  }\r\n\r\n  /**\r\n   * Resolves the destination from the directly assigned object, otherwise by\r\n   * walking the authored path against the controller's binding roots.\r\n   */\r\n  ResolveDestination(controller)\r\n  {\r\n    if (this.destination)\r\n    {\r\n      return this.destination;\r\n    }\r\n    if (this.path && controller)\r\n    {\r\n      return Tr2BindingPoint.ResolvePath(this.path, controller.GetBindingPathRoots?.() ?? []);\r\n    }\r\n    return null;\r\n  }\r\n\r\n  static DestinationType = DestinationType;\r\n\r\n  static PlayAction = PlayAction;\r\n\r\n  static StopAction = StopAction;\r\n\r\n}\r\n"],"names":["_Tr2ActionPlayMeshAni","_identity","Tr2ActionPlayMeshAnimation","CjsModel","e","_init_destinationType","_init_extra_destinationType","_init_playAction","_init_extra_playAction","_init_stopAction","_init_extra_stopAction","_init_mask","_init_extra_mask","_init_animation","_init_extra_animation","_init_speed","_init_extra_speed","_init_delay","_init_extra_delay","_init_destination","_init_extra_destination","_init_delayBinding","_init_extra_delayBinding","_init_loops","_init_extra_loops","_init_path","_init_extra_path","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","notify","persist","int32","schema","enum","string","float32","objectRef","boolean","carbon","method","impl","adapted","implemented","destinationType","DestinationType","OWNER","playAction","PlayAction","ENQUEUE_PLAY","stopAction","StopAction","ENQUEUE_STOP","mask","animation","speed","delay","destination","delayBinding","loops","path","Link","controller","LinkDestination","Unlink","Start","GetDestination","animationController","ITr2ControllerAction","getAnimationController","layerName","hasFunction","AddAnimationLayerWithTrackMask","PlayLayerAnimationByName","PLAY","Math","max","methodName","Play","Stop","NONE","layer","GetAnimationLayer","STOP","ClearAnimations","EndAnimation","OnModified","_options","ResolveDestination","getOwner","IsBindingValid","IsDestinationValid","Tr2BindingPoint","ResolvePath","GetBindingPathRoots","constructor"],"mappings":"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"}

package/dist/controllers/Tr2ActionPlaySound.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_event, _init_extra_event, _init_target, _init_extra_target, _init_bypassPrefix, _init_extra_bypassPrefix;
+
+/**
+ * Controller action that fires a one-shot audio event on a named emitter when
+ * the action starts; it has no stop behaviour.
+ */
 let _Tr2ActionPlaySound;
 new class extends _identity {
   static [class Tr2ActionPlaySound extends CjsModel {
@@ -43,6 +48,12 @@ new class extends _identity {
     StartWithController(controller) {
       this.Start(ITr2ControllerAction.requireController(controller, "StartWithController"));
     }
+
+    /**
+     * Redirects to the object named by `target`, preferring a named parameter
+     * owner and otherwise a named effect child; an empty target keeps the
+     * controller owner.
+     */
   }];
   #resolveOwner(owner, target) {
     if (!owner || !target) {

package/dist/controllers/Tr2ActionPlaySound.js.map

@@ -1 +1 @@
-{"version":3,"file":"Tr2ActionPlaySound.js","sources":["../../../src/controllers/Tr2ActionPlaySound.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\Controllers\\Actions\\Tr2ActionPlaySound.h\n// Source: E:\\carbonengine\\trinity\\trinity\\Controllers\\Actions\\Tr2ActionPlaySound.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: \"Tr2ActionPlaySound\",\n  family: \"controllers\"\n})\nexport class Tr2ActionPlaySound extends CjsModel\n{\n  @io.persist\n  @type.string\n  emitter = \"\";\n\n  @io.persist\n  @type.string\n  event = \"\";\n\n  @io.persist\n  @type.string\n  target = \"\";\n\n  @io.persist\n  @type.boolean\n  bypassPrefix = false;\n\n  /**\n   * Plays a sound event on the resolved audio emitter.\n   */\n  @carbon.method\n  @impl.adapted\n  Start(controller)\n  {\n    const owner = Tr2ActionPlaySound.#resolveOwner(ITr2ControllerAction.getOwner(controller), this.target);\n    const emitter = ITr2ControllerAction.findSoundEmitter(owner, this.emitter);\n    if (!ITr2ControllerAction.hasFunction(emitter, \"SendEvent\"))\n    {\n      return;\n    }\n    emitter.SendEvent(this.event, this.bypassPrefix);\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  static #resolveOwner(owner, target)\n  {\n    if (!owner || !target)\n    {\n      return owner;\n    }\n    if (ITr2ControllerAction.hasFunction(owner, \"GetParameterByName\"))\n    {\n      return ITr2ControllerAction.getParameterOwner(owner, target);\n    }\n    if (ITr2ControllerAction.hasFunction(owner, \"GetEffectChildByName\"))\n    {\n      return ITr2ControllerAction.asObject(owner.GetEffectChildByName(target));\n    }\n    return owner;\n  }\n}\n"],"names":["_Tr2ActionPlaySound","_identity","Tr2ActionPlaySound","CjsModel","e","_init_emitter","_init_extra_emitter","_init_event","_init_extra_event","_init_target","_init_extra_target","_init_bypassPrefix","_init_extra_bypassPrefix","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","persist","string","boolean","carbon","method","impl","adapted","implemented","constructor","args","emitter","event","target","bypassPrefix","Start","controller","owner","ITr2ControllerAction","getOwner","findSoundEmitter","hasFunction","SendEvent","StartWithController","requireController","#resolveOwner","getParameterOwner","asObject","GetEffectChildByName"],"mappings":"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"}
+{"version":3,"file":"Tr2ActionPlaySound.js","sources":["../../../src/controllers/Tr2ActionPlaySound.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\Controllers\\Actions\\Tr2ActionPlaySound.h\n// Source: E:\\carbonengine\\trinity\\trinity\\Controllers\\Actions\\Tr2ActionPlaySound.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 fires a one-shot audio event on a named emitter when\n * the action starts; it has no stop behaviour.\n */\n@type.define({\n  className: \"Tr2ActionPlaySound\",\n  family: \"controllers\"\n})\nexport class Tr2ActionPlaySound extends CjsModel\n{\n  @io.persist\n  @type.string\n  emitter = \"\";\n\n  @io.persist\n  @type.string\n  event = \"\";\n\n  @io.persist\n  @type.string\n  target = \"\";\n\n  @io.persist\n  @type.boolean\n  bypassPrefix = false;\n\n  /**\n   * Plays a sound event on the resolved audio emitter.\n   */\n  @carbon.method\n  @impl.adapted\n  Start(controller)\n  {\n    const owner = Tr2ActionPlaySound.#resolveOwner(ITr2ControllerAction.getOwner(controller), this.target);\n    const emitter = ITr2ControllerAction.findSoundEmitter(owner, this.emitter);\n    if (!ITr2ControllerAction.hasFunction(emitter, \"SendEvent\"))\n    {\n      return;\n    }\n    emitter.SendEvent(this.event, this.bypassPrefix);\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   * Redirects to the object named by `target`, preferring a named parameter\n   * owner and otherwise a named effect child; an empty target keeps the\n   * controller owner.\n   */\n  static #resolveOwner(owner, target)\n  {\n    if (!owner || !target)\n    {\n      return owner;\n    }\n    if (ITr2ControllerAction.hasFunction(owner, \"GetParameterByName\"))\n    {\n      return ITr2ControllerAction.getParameterOwner(owner, target);\n    }\n    if (ITr2ControllerAction.hasFunction(owner, \"GetEffectChildByName\"))\n    {\n      return ITr2ControllerAction.asObject(owner.GetEffectChildByName(target));\n    }\n    return owner;\n  }\n}\n"],"names":["_Tr2ActionPlaySound","_identity","Tr2ActionPlaySound","CjsModel","e","_init_emitter","_init_extra_emitter","_init_event","_init_extra_event","_init_target","_init_extra_target","_init_bypassPrefix","_init_extra_bypassPrefix","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","persist","string","boolean","carbon","method","impl","adapted","implemented","constructor","args","emitter","event","target","bypassPrefix","Start","controller","owner","ITr2ControllerAction","getOwner","findSoundEmitter","hasFunction","SendEvent","StartWithController","requireController","#resolveOwner","getParameterOwner","asObject","GetEffectChildByName"],"mappings":"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"}

package/dist/controllers/Tr2ActionPython.js

@@ -4,6 +4,12 @@ import { io, type, carbon, impl } from '@carbonenginejs/runtime-utils/schema';
 import { GetControllerActualTimeSeconds, GetControllerFrameTimeSeconds } from './contracts.js';
 
 let _initProto, _initClass, _init_module, _init_extra_module, _init_className, _init_extra_className, _init_state, _init_extra_state;
+
+/**
+ * Controller action that delegates to a host-provided scripted action instance,
+ * forwarding link, start, stop and update callbacks and persisting the
+ * instance's own opaque state bytes.
+ */
 let _Tr2ActionPython;
 new class extends _identity {
   static [class Tr2ActionPython extends CjsModel {
@@ -200,6 +206,11 @@ new class extends _identity {
       this.#loadedState = null;
       this.#ensureInstance();
     }
+
+    /**
+     * Creates the host instance on first use and replays persisted state into it
+     * through OnLoad, guarding against loading the same state buffer twice.
+     */
     #ensureInstance() {
       if (!this.#instance) {
         this.#instance = _Tr2ActionPython.createInstance(this.module, this.className, this);

package/dist/controllers/Tr2ActionPython.js.map

@@ -1 +1 @@
-{"version":3,"file":"Tr2ActionPython.js","sources":["../../../src/controllers/Tr2ActionPython.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\Controllers\\Actions\\Tr2ActionPython.h\r\n// Source: E:\\carbonengine\\trinity\\trinity\\Controllers\\Actions\\Tr2ActionPython.cpp\r\nimport { CjsModel } from \"@carbonenginejs/runtime-utils/model\";\r\nimport { carbon, impl, io, type } from \"@carbonenginejs/runtime-utils/schema\";\r\nimport { GetControllerActualTimeSeconds, GetControllerFrameTimeSeconds } from \"./contracts.js\";\r\n\r\n\r\n@type.define({\r\n  className: \"Tr2ActionPython\",\r\n  family: \"controllers\"\r\n})\r\nexport class Tr2ActionPython extends CjsModel\r\n{\r\n  static #factory = null;\r\n\r\n  /** Registers the JavaScript factory used to adapt Carbon Python actions. */\r\n  static registerFactory(factory)\r\n  {\r\n    const previous = this.#factory;\r\n    this.#factory = factory;\r\n    return previous;\r\n  }\r\n\r\n  /** Clears the registered JavaScript action factory. */\r\n  static clearFactory()\r\n  {\r\n    this.#factory = null;\r\n  }\r\n\r\n  /** Creates a host action instance for a configured Carbon module and class. */\r\n  static createInstance(moduleName, className, action)\r\n  {\r\n    if (!moduleName || !className || !this.#factory)\r\n    {\r\n      return null;\r\n    }\r\n    return this.#factory(moduleName, className, action) ?? null;\r\n  }\r\n\r\n  /** Copies host persistence output into an owned byte buffer. */\r\n  static stateToBytes(value)\r\n  {\r\n    if (value == null)\r\n    {\r\n      return null;\r\n    }\r\n    if (typeof value === \"string\")\r\n    {\r\n      return new TextEncoder().encode(value);\r\n    }\r\n    if (Array.isArray(value))\r\n    {\r\n      return Uint8Array.from(value);\r\n    }\r\n    if (value instanceof ArrayBuffer)\r\n    {\r\n      return new Uint8Array(value.slice(0));\r\n    }\r\n    if (ArrayBuffer.isView(value))\r\n    {\r\n      const out = new Uint8Array(value.byteLength);\r\n      out.set(new Uint8Array(value.buffer, value.byteOffset, value.byteLength));\r\n      return out;\r\n    }\r\n    return null;\r\n  }\r\n\r\n  @io.notify\r\n  @io.persist\r\n  @type.string\r\n  module = \"\";\r\n\r\n  @io.notify\r\n  @io.persist\r\n  @type.string\r\n  className = \"\";\r\n\r\n  @io.persistOnly\r\n  @type.typedArray(\"Uint8Array\")\r\n  state = null;\r\n\r\n  #controller = null;\r\n\r\n  #instance = null;\r\n\r\n  #loadedState = null;\r\n\r\n  #isPlaying = false;\r\n\r\n  #prevRealTime = 0;\r\n\r\n  #prevSimTime = 0;\r\n\r\n  /**\r\n   * Initializes the host-provided action instance.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  Initialize()\r\n  {\r\n    this.#ensureInstance();\r\n    return true;\r\n  }\r\n\r\n  /**\r\n   * Recreates the action instance when authoring fields change.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  OnModified(_options = {})\r\n  {\r\n    const controller = this.#controller;\r\n    const wasPlaying = this.#isPlaying;\r\n    if (controller)\r\n    {\r\n      if (wasPlaying)\r\n      {\r\n        this.Stop(controller);\r\n      }\r\n      this.Unlink();\r\n    }\r\n    this.#instance = null;\r\n    this.#loadedState = null;\r\n    this.#ensureInstance();\r\n    if (controller)\r\n    {\r\n      this.Link(controller);\r\n      if (wasPlaying)\r\n      {\r\n        this.Start(controller);\r\n      }\r\n    }\r\n    return true;\r\n  }\r\n\r\n  /**\r\n   * Links this action to a controller and notifies the host instance.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  Link(controller)\r\n  {\r\n    this.#controller = controller;\r\n    const instance = this.#ensureInstance();\r\n    instance?.OnLink?.(controller.GetOwner?.() ?? null, controller);\r\n  }\r\n\r\n  /**\r\n   * Unlinks this action and notifies the host instance.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  Unlink()\r\n  {\r\n    this.#controller = null;\r\n    this.#instance?.OnUnlink?.();\r\n  }\r\n\r\n  /**\r\n   * Starts the action and registers for updates when the host instance supports them.\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    this.#isPlaying = true;\r\n    const instance = this.#ensureInstance();\r\n    if (instance?.OnUpdate)\r\n    {\r\n      controller.RegisterUpdateable?.(this);\r\n    }\r\n    instance?.OnStart?.(controller.GetOwner?.() ?? null, controller);\r\n    this.#prevRealTime = GetControllerActualTimeSeconds();\r\n    this.#prevSimTime = GetControllerFrameTimeSeconds();\r\n  }\r\n\r\n  /**\r\n   * Stops the action and unregisters updates.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  Stop(controller = this.#controller)\r\n  {\r\n    if (!controller)\r\n    {\r\n      return;\r\n    }\r\n    this.#isPlaying = false;\r\n    controller.UnRegisterUpdateable?.(this);\r\n    this.#instance?.OnStop?.(controller.GetOwner?.() ?? null, controller);\r\n  }\r\n\r\n  /**\r\n   * Updates the host instance with Carbon-style real and simulation deltas.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  Update(realTime, simTime)\r\n  {\r\n    const controller = this.#controller;\r\n    const instance = this.#instance;\r\n    if (!controller || !instance?.OnUpdate)\r\n    {\r\n      return;\r\n    }\r\n    const realDt = realTime - this.#prevRealTime;\r\n    const simDt = simTime - this.#prevSimTime;\r\n    instance.OnUpdate(controller.GetOwner?.() ?? null, controller, realDt, simDt);\r\n    this.#prevRealTime = realTime;\r\n    this.#prevSimTime = simTime;\r\n  }\r\n\r\n  /**\r\n   * Gets the cached JS-side host instance.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  GetInstance()\r\n  {\r\n    return this.#instance;\r\n  }\r\n\r\n  /**\r\n   * Gets custom persisted host state.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  GetWriteBufferAndSize(_memberName = \"state\")\r\n  {\r\n    const bytes = Tr2ActionPython.stateToBytes(this.#instance?.OnSave?.());\r\n    if (bytes)\r\n    {\r\n      this.state = bytes;\r\n    }\r\n    return bytes;\r\n  }\r\n\r\n  /**\r\n   * Releases a custom persistence buffer.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  ReleaseWriteBuffer(_buffer)\r\n  {\r\n  }\r\n\r\n  /**\r\n   * Allocates a custom persistence read buffer.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  AllocateReadBuffer(_memberName, bufferSize)\r\n  {\r\n    return new Uint8Array(bufferSize);\r\n  }\r\n\r\n  /**\r\n   * Applies custom persisted host state.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  SetBufferAndSize(_memberName, buffer, bufferSize = buffer.byteLength)\r\n  {\r\n    this.state = buffer.slice(0, bufferSize);\r\n    this.#loadedState = null;\r\n    this.#ensureInstance();\r\n  }\r\n  #ensureInstance()\r\n  {\r\n    if (!this.#instance)\r\n    {\r\n      this.#instance = Tr2ActionPython.createInstance(this.module, this.className, this);\r\n    }\r\n    if (this.#instance && this.state && this.state !== this.#loadedState)\r\n    {\r\n      this.#instance.OnLoad?.(this.state);\r\n      this.#loadedState = this.state;\r\n    }\r\n    return this.#instance;\r\n  }\r\n}\r\n"],"names":["_Tr2ActionPython","_identity","Tr2ActionPython","CjsModel","e","_init_module","_init_extra_module","_init_className","_init_extra_className","_init_state","_init_extra_state","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","notify","persist","string","persistOnly","typedArray","carbon","method","impl","adapted","registerFactory","factory","previous","clearFactory","createInstance","moduleName","action","stateToBytes","value","TextEncoder","encode","Array","isArray","Uint8Array","from","ArrayBuffer","slice","isView","out","byteLength","set","buffer","byteOffset","module","state","Initialize","OnModified","_options","controller","wasPlaying","Stop","Unlink","Link","Start","instance","OnLink","GetOwner","OnUnlink","OnUpdate","RegisterUpdateable","OnStart","GetControllerActualTimeSeconds","GetControllerFrameTimeSeconds","UnRegisterUpdateable","OnStop","Update","realTime","simTime","realDt","simDt","GetInstance","GetWriteBufferAndSize","_memberName","bytes","OnSave","ReleaseWriteBuffer","_buffer","AllocateReadBuffer","bufferSize","SetBufferAndSize","#ensureInstance","OnLoad","constructor"],"mappings":"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"}
+{"version":3,"file":"Tr2ActionPython.js","sources":["../../../src/controllers/Tr2ActionPython.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\Controllers\\Actions\\Tr2ActionPython.h\r\n// Source: E:\\carbonengine\\trinity\\trinity\\Controllers\\Actions\\Tr2ActionPython.cpp\r\nimport { CjsModel } from \"@carbonenginejs/runtime-utils/model\";\r\nimport { carbon, impl, io, type } from \"@carbonenginejs/runtime-utils/schema\";\r\nimport { GetControllerActualTimeSeconds, GetControllerFrameTimeSeconds } from \"./contracts.js\";\r\n\r\n\r\n/**\r\n * Controller action that delegates to a host-provided scripted action instance,\r\n * forwarding link, start, stop and update callbacks and persisting the\r\n * instance's own opaque state bytes.\r\n */\r\n@type.define({\r\n  className: \"Tr2ActionPython\",\r\n  family: \"controllers\"\r\n})\r\nexport class Tr2ActionPython extends CjsModel\r\n{\r\n  static #factory = null;\r\n\r\n  /** Registers the JavaScript factory used to adapt Carbon Python actions. */\r\n  static registerFactory(factory)\r\n  {\r\n    const previous = this.#factory;\r\n    this.#factory = factory;\r\n    return previous;\r\n  }\r\n\r\n  /** Clears the registered JavaScript action factory. */\r\n  static clearFactory()\r\n  {\r\n    this.#factory = null;\r\n  }\r\n\r\n  /** Creates a host action instance for a configured Carbon module and class. */\r\n  static createInstance(moduleName, className, action)\r\n  {\r\n    if (!moduleName || !className || !this.#factory)\r\n    {\r\n      return null;\r\n    }\r\n    return this.#factory(moduleName, className, action) ?? null;\r\n  }\r\n\r\n  /** Copies host persistence output into an owned byte buffer. */\r\n  static stateToBytes(value)\r\n  {\r\n    if (value == null)\r\n    {\r\n      return null;\r\n    }\r\n    if (typeof value === \"string\")\r\n    {\r\n      return new TextEncoder().encode(value);\r\n    }\r\n    if (Array.isArray(value))\r\n    {\r\n      return Uint8Array.from(value);\r\n    }\r\n    if (value instanceof ArrayBuffer)\r\n    {\r\n      return new Uint8Array(value.slice(0));\r\n    }\r\n    if (ArrayBuffer.isView(value))\r\n    {\r\n      const out = new Uint8Array(value.byteLength);\r\n      out.set(new Uint8Array(value.buffer, value.byteOffset, value.byteLength));\r\n      return out;\r\n    }\r\n    return null;\r\n  }\r\n\r\n  @io.notify\r\n  @io.persist\r\n  @type.string\r\n  module = \"\";\r\n\r\n  @io.notify\r\n  @io.persist\r\n  @type.string\r\n  className = \"\";\r\n\r\n  @io.persistOnly\r\n  @type.typedArray(\"Uint8Array\")\r\n  state = null;\r\n\r\n  #controller = null;\r\n\r\n  #instance = null;\r\n\r\n  #loadedState = null;\r\n\r\n  #isPlaying = false;\r\n\r\n  #prevRealTime = 0;\r\n\r\n  #prevSimTime = 0;\r\n\r\n  /**\r\n   * Initializes the host-provided action instance.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  Initialize()\r\n  {\r\n    this.#ensureInstance();\r\n    return true;\r\n  }\r\n\r\n  /**\r\n   * Recreates the action instance when authoring fields change.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  OnModified(_options = {})\r\n  {\r\n    const controller = this.#controller;\r\n    const wasPlaying = this.#isPlaying;\r\n    if (controller)\r\n    {\r\n      if (wasPlaying)\r\n      {\r\n        this.Stop(controller);\r\n      }\r\n      this.Unlink();\r\n    }\r\n    this.#instance = null;\r\n    this.#loadedState = null;\r\n    this.#ensureInstance();\r\n    if (controller)\r\n    {\r\n      this.Link(controller);\r\n      if (wasPlaying)\r\n      {\r\n        this.Start(controller);\r\n      }\r\n    }\r\n    return true;\r\n  }\r\n\r\n  /**\r\n   * Links this action to a controller and notifies the host instance.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  Link(controller)\r\n  {\r\n    this.#controller = controller;\r\n    const instance = this.#ensureInstance();\r\n    instance?.OnLink?.(controller.GetOwner?.() ?? null, controller);\r\n  }\r\n\r\n  /**\r\n   * Unlinks this action and notifies the host instance.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  Unlink()\r\n  {\r\n    this.#controller = null;\r\n    this.#instance?.OnUnlink?.();\r\n  }\r\n\r\n  /**\r\n   * Starts the action and registers for updates when the host instance supports them.\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    this.#isPlaying = true;\r\n    const instance = this.#ensureInstance();\r\n    if (instance?.OnUpdate)\r\n    {\r\n      controller.RegisterUpdateable?.(this);\r\n    }\r\n    instance?.OnStart?.(controller.GetOwner?.() ?? null, controller);\r\n    this.#prevRealTime = GetControllerActualTimeSeconds();\r\n    this.#prevSimTime = GetControllerFrameTimeSeconds();\r\n  }\r\n\r\n  /**\r\n   * Stops the action and unregisters updates.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  Stop(controller = this.#controller)\r\n  {\r\n    if (!controller)\r\n    {\r\n      return;\r\n    }\r\n    this.#isPlaying = false;\r\n    controller.UnRegisterUpdateable?.(this);\r\n    this.#instance?.OnStop?.(controller.GetOwner?.() ?? null, controller);\r\n  }\r\n\r\n  /**\r\n   * Updates the host instance with Carbon-style real and simulation deltas.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  Update(realTime, simTime)\r\n  {\r\n    const controller = this.#controller;\r\n    const instance = this.#instance;\r\n    if (!controller || !instance?.OnUpdate)\r\n    {\r\n      return;\r\n    }\r\n    const realDt = realTime - this.#prevRealTime;\r\n    const simDt = simTime - this.#prevSimTime;\r\n    instance.OnUpdate(controller.GetOwner?.() ?? null, controller, realDt, simDt);\r\n    this.#prevRealTime = realTime;\r\n    this.#prevSimTime = simTime;\r\n  }\r\n\r\n  /**\r\n   * Gets the cached JS-side host instance.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  GetInstance()\r\n  {\r\n    return this.#instance;\r\n  }\r\n\r\n  /**\r\n   * Gets custom persisted host state.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  GetWriteBufferAndSize(_memberName = \"state\")\r\n  {\r\n    const bytes = Tr2ActionPython.stateToBytes(this.#instance?.OnSave?.());\r\n    if (bytes)\r\n    {\r\n      this.state = bytes;\r\n    }\r\n    return bytes;\r\n  }\r\n\r\n  /**\r\n   * Releases a custom persistence buffer.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  ReleaseWriteBuffer(_buffer)\r\n  {\r\n  }\r\n\r\n  /**\r\n   * Allocates a custom persistence read buffer.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  AllocateReadBuffer(_memberName, bufferSize)\r\n  {\r\n    return new Uint8Array(bufferSize);\r\n  }\r\n\r\n  /**\r\n   * Applies custom persisted host state.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  SetBufferAndSize(_memberName, buffer, bufferSize = buffer.byteLength)\r\n  {\r\n    this.state = buffer.slice(0, bufferSize);\r\n    this.#loadedState = null;\r\n    this.#ensureInstance();\r\n  }\r\n\r\n  /**\r\n   * Creates the host instance on first use and replays persisted state into it\r\n   * through OnLoad, guarding against loading the same state buffer twice.\r\n   */\r\n  #ensureInstance()\r\n  {\r\n    if (!this.#instance)\r\n    {\r\n      this.#instance = Tr2ActionPython.createInstance(this.module, this.className, this);\r\n    }\r\n    if (this.#instance && this.state && this.state !== this.#loadedState)\r\n    {\r\n      this.#instance.OnLoad?.(this.state);\r\n      this.#loadedState = this.state;\r\n    }\r\n    return this.#instance;\r\n  }\r\n}\r\n"],"names":["_Tr2ActionPython","_identity","Tr2ActionPython","CjsModel","e","_init_module","_init_extra_module","_init_className","_init_extra_className","_init_state","_init_extra_state","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","notify","persist","string","persistOnly","typedArray","carbon","method","impl","adapted","registerFactory","factory","previous","clearFactory","createInstance","moduleName","action","stateToBytes","value","TextEncoder","encode","Array","isArray","Uint8Array","from","ArrayBuffer","slice","isView","out","byteLength","set","buffer","byteOffset","module","state","Initialize","OnModified","_options","controller","wasPlaying","Stop","Unlink","Link","Start","instance","OnLink","GetOwner","OnUnlink","OnUpdate","RegisterUpdateable","OnStart","GetControllerActualTimeSeconds","GetControllerFrameTimeSeconds","UnRegisterUpdateable","OnStop","Update","realTime","simTime","realDt","simDt","GetInstance","GetWriteBufferAndSize","_memberName","bytes","OnSave","ReleaseWriteBuffer","_buffer","AllocateReadBuffer","bufferSize","SetBufferAndSize","#ensureInstance","OnLoad","constructor"],"mappings":";;;;;;;AAOA;AACA;AACA;AACA;AACA;AAJA,IAAAA;AAAA,IAAA,cAAAC,SAAA,CAAA;AAAA,EAAA,QAKA,MAAAC,eAAA,SAIqCC,QAAQ,CAC7C;AAAA,IAAA;AAAA,MAAA,CAAA;AAAAC,QAAAA,CAAA,EAAA,CAAAC,YAAA,EAAAC,kBAAA,EAAAC,eAAA,EAAAC,qBAAA,EAAAC,WAAA,EAAAC,iBAAA,EAAAC,UAAA,CAAA;QAAAC,CAAA,EAAA,CAAAZ,gBAAA,EAAAa,UAAA;AAAA,OAAA,GAAAC,cAAA,CAAA,IAAA,EAAA,CALCC,IAAI,CAACC,MAAM,CAAC;AACXC,QAAAA,SAAS,EAAE,iBAAiB;AAC5BC,QAAAA,MAAM,EAAE;OACT,CAAC,MAyDCC,EAAE,EAAFA,EAAE,CAACC,MAAM,EACTD,EAAE,EAAFA,EAAE,CAACE,OAAO,EACVN,IAAI,EAAJA,IAAI,CAACO,MAAM,oBAGXH,EAAE,EAAFA,EAAE,CAACC,MAAM,EACTD,EAAE,EAAFA,EAAE,CAACE,OAAO,EACVN,IAAI,EAAJA,IAAI,CAACO,MAAM,uBAGXH,EAAE,EAAFA,EAAE,CAACI,WAAW,EAAA,MAAA,EACdR,IAAI,CAACS,UAAU,CAAC,YAAY,CAAC,mBAkB7BC,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACC,OAAO,wBAUZH,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACC,OAAO,CAAA,EAAA,EAAA,EAAA,YAAA,CAAA,EAAA,CAAA,CA8BZH,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACC,OAAO,CAAA,EAAA,EAAA,EAAA,MAAA,CAAA,EAAA,CAAA,CAWZH,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACC,OAAO,CAAA,EAAA,EAAA,EAAA,QAAA,CAAA,EAAA,CAAA,CAUZH,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACC,OAAO,CAAA,EAAA,EAAA,EAAA,OAAA,CAAA,EAAA,CAAA,CAsBZH,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACC,OAAO,kBAeZH,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACC,OAAO,oBAmBZH,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACC,OAAO,CAAA,EAAA,EAAA,EAAA,aAAA,CAAA,EAAA,CAAA,CASZH,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACC,OAAO,CAAA,EAAA,EAAA,EAAA,uBAAA,CAAA,EAAA,CAAA,CAcZH,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACC,OAAO,CAAA,EAAA,EAAA,EAAA,oBAAA,CAAA,EAAA,CAAA,CAQZH,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACC,OAAO,CAAA,EAAA,EAAA,EAAA,oBAAA,CAAA,EAAA,CAAA,CASZH,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACC,OAAO,CAAA,EAAA,EAAA,EAAA,kBAAA,CAAA,CAAA,EAAA,CAAA,EAAA,MAAA,EA9PsBzB,QAAQ,CAAA;AAAA;AAI3C;IACA,OAAO0B,eAAeA,CAACC,OAAO,EAC9B;AACE,MAAA,MAAMC,QAAQ,GAAG,IAAI,CAAC,QAAQ;AAC9B,MAAA,IAAI,CAAC,QAAQ,GAAGD,OAAO;AACvB,MAAA,OAAOC,QAAQ;AACjB,IAAA;;AAEA;IACA,OAAOC,YAAYA,GACnB;AACE,MAAA,IAAI,CAAC,QAAQ,GAAG,IAAI;AACtB,IAAA;;AAEA;AACA,IAAA,OAAOC,cAAcA,CAACC,UAAU,EAAEjB,SAAS,EAAEkB,MAAM,EACnD;MACE,IAAI,CAACD,UAAU,IAAI,CAACjB,SAAS,IAAI,CAAC,IAAI,CAAC,QAAQ,EAC/C;AACE,QAAA,OAAO,IAAI;AACb,MAAA;AACA,MAAA,OAAO,IAAI,CAAC,QAAQ,CAACiB,UAAU,EAAEjB,SAAS,EAAEkB,MAAM,CAAC,IAAI,IAAI;AAC7D,IAAA;;AAEA;IACA,OAAOC,YAAYA,CAACC,KAAK,EACzB;MACE,IAAIA,KAAK,IAAI,IAAI,EACjB;AACE,QAAA,OAAO,IAAI;AACb,MAAA;AACA,MAAA,IAAI,OAAOA,KAAK,KAAK,QAAQ,EAC7B;QACE,OAAO,IAAIC,WAAW,EAAE,CAACC,MAAM,CAACF,KAAK,CAAC;AACxC,MAAA;AACA,MAAA,IAAIG,KAAK,CAACC,OAAO,CAACJ,KAAK,CAAC,EACxB;AACE,QAAA,OAAOK,UAAU,CAACC,IAAI,CAACN,KAAK,CAAC;AAC/B,MAAA;MACA,IAAIA,KAAK,YAAYO,WAAW,EAChC;QACE,OAAO,IAAIF,UAAU,CAACL,KAAK,CAACQ,KAAK,CAAC,CAAC,CAAC,CAAC;AACvC,MAAA;AACA,MAAA,IAAID,WAAW,CAACE,MAAM,CAACT,KAAK,CAAC,EAC7B;QACE,MAAMU,GAAG,GAAG,IAAIL,UAAU,CAACL,KAAK,CAACW,UAAU,CAAC;AAC5CD,QAAAA,GAAG,CAACE,GAAG,CAAC,IAAIP,UAAU,CAACL,KAAK,CAACa,MAAM,EAAEb,KAAK,CAACc,UAAU,EAAEd,KAAK,CAACW,UAAU,CAAC,CAAC;AACzE,QAAA,OAAOD,GAAG;AACZ,MAAA;AACA,MAAA,OAAO,IAAI;AACb,IAAA;AAKAK,IAAAA,MAAM,IAAAzC,UAAA,CAAA,IAAA,CAAA,EAAAN,YAAA,OAAG,EAAE,CAAA;AAKXY,IAAAA,SAAS,IAAAX,kBAAA,CAAA,IAAA,CAAA,EAAAC,eAAA,OAAG,EAAE,CAAA;AAId8C,IAAAA,KAAK,IAAA7C,qBAAA,CAAA,IAAA,CAAA,EAAAC,WAAA,OAAG,IAAI,CAAA;AAEZ,IAAA,WAAW,IAAAC,iBAAA,CAAA,IAAA,CAAA,EAAG,IAAI;IAElB,SAAS,GAAG,IAAI;IAEhB,YAAY,GAAG,IAAI;IAEnB,UAAU,GAAG,KAAK;IAElB,aAAa,GAAG,CAAC;IAEjB,YAAY,GAAG,CAAC;;AAEhB;AACF;AACA;AAGE4C,IAAAA,UAAUA,GACV;AACE,MAAA,IAAI,CAAC,eAAe,EAAE;AACtB,MAAA,OAAO,IAAI;AACb,IAAA;;AAEA;AACF;AACA;AAGEC,IAAAA,UAAUA,CAACC,QAAQ,GAAG,EAAE,EACxB;AACE,MAAA,MAAMC,UAAU,GAAG,IAAI,CAAC,WAAW;AACnC,MAAA,MAAMC,UAAU,GAAG,IAAI,CAAC,UAAU;AAClC,MAAA,IAAID,UAAU,EACd;AACE,QAAA,IAAIC,UAAU,EACd;AACE,UAAA,IAAI,CAACC,IAAI,CAACF,UAAU,CAAC;AACvB,QAAA;QACA,IAAI,CAACG,MAAM,EAAE;AACf,MAAA;AACA,MAAA,IAAI,CAAC,SAAS,GAAG,IAAI;AACrB,MAAA,IAAI,CAAC,YAAY,GAAG,IAAI;AACxB,MAAA,IAAI,CAAC,eAAe,EAAE;AACtB,MAAA,IAAIH,UAAU,EACd;AACE,QAAA,IAAI,CAACI,IAAI,CAACJ,UAAU,CAAC;AACrB,QAAA,IAAIC,UAAU,EACd;AACE,UAAA,IAAI,CAACI,KAAK,CAACL,UAAU,CAAC;AACxB,QAAA;AACF,MAAA;AACA,MAAA,OAAO,IAAI;AACb,IAAA;;AAEA;AACF;AACA;IAGEI,IAAIA,CAACJ,UAAU,EACf;AACE,MAAA,IAAI,CAAC,WAAW,GAAGA,UAAU;AAC7B,MAAA,MAAMM,QAAQ,GAAG,IAAI,CAAC,eAAe,EAAE;AACvCA,MAAAA,QAAQ,EAAEC,MAAM,GAAGP,UAAU,CAACQ,QAAQ,IAAI,IAAI,IAAI,EAAER,UAAU,CAAC;AACjE,IAAA;;AAEA;AACF;AACA;AAGEG,IAAAA,MAAMA,GACN;AACE,MAAA,IAAI,CAAC,WAAW,GAAG,IAAI;AACvB,MAAA,IAAI,CAAC,SAAS,EAAEM,QAAQ,IAAI;AAC9B,IAAA;;AAEA;AACF;AACA;AAGEJ,IAAAA,KAAKA,CAACL,UAAU,GAAG,IAAI,CAAC,WAAW,EACnC;MACE,IAAI,CAACA,UAAU,EACf;AACE,QAAA;AACF,MAAA;AACA,MAAA,IAAI,CAAC,WAAW,GAAGA,UAAU;AAC7B,MAAA,IAAI,CAAC,UAAU,GAAG,IAAI;AACtB,MAAA,MAAMM,QAAQ,GAAG,IAAI,CAAC,eAAe,EAAE;MACvC,IAAIA,QAAQ,EAAEI,QAAQ,EACtB;AACEV,QAAAA,UAAU,CAACW,kBAAkB,GAAG,IAAI,CAAC;AACvC,MAAA;AACAL,MAAAA,QAAQ,EAAEM,OAAO,GAAGZ,UAAU,CAACQ,QAAQ,IAAI,IAAI,IAAI,EAAER,UAAU,CAAC;AAChE,MAAA,IAAI,CAAC,aAAa,GAAGa,8BAA8B,EAAE;AACrD,MAAA,IAAI,CAAC,YAAY,GAAGC,6BAA6B,EAAE;AACrD,IAAA;;AAEA;AACF;AACA;AAGEZ,IAAAA,IAAIA,CAACF,UAAU,GAAG,IAAI,CAAC,WAAW,EAClC;MACE,IAAI,CAACA,UAAU,EACf;AACE,QAAA;AACF,MAAA;AACA,MAAA,IAAI,CAAC,UAAU,GAAG,KAAK;AACvBA,MAAAA,UAAU,CAACe,oBAAoB,GAAG,IAAI,CAAC;AACvC,MAAA,IAAI,CAAC,SAAS,EAAEC,MAAM,GAAGhB,UAAU,CAACQ,QAAQ,IAAI,IAAI,IAAI,EAAER,UAAU,CAAC;AACvE,IAAA;;AAEA;AACF;AACA;AAGEiB,IAAAA,MAAMA,CAACC,QAAQ,EAAEC,OAAO,EACxB;AACE,MAAA,MAAMnB,UAAU,GAAG,IAAI,CAAC,WAAW;AACnC,MAAA,MAAMM,QAAQ,GAAG,IAAI,CAAC,SAAS;AAC/B,MAAA,IAAI,CAACN,UAAU,IAAI,CAACM,QAAQ,EAAEI,QAAQ,EACtC;AACE,QAAA;AACF,MAAA;AACA,MAAA,MAAMU,MAAM,GAAGF,QAAQ,GAAG,IAAI,CAAC,aAAa;AAC5C,MAAA,MAAMG,KAAK,GAAGF,OAAO,GAAG,IAAI,CAAC,YAAY;AACzCb,MAAAA,QAAQ,CAACI,QAAQ,CAACV,UAAU,CAACQ,QAAQ,IAAI,IAAI,IAAI,EAAER,UAAU,EAAEoB,MAAM,EAAEC,KAAK,CAAC;AAC7E,MAAA,IAAI,CAAC,aAAa,GAAGH,QAAQ;AAC7B,MAAA,IAAI,CAAC,YAAY,GAAGC,OAAO;AAC7B,IAAA;;AAEA;AACF;AACA;AAGEG,IAAAA,WAAWA,GACX;MACE,OAAO,IAAI,CAAC,SAAS;AACvB,IAAA;;AAEA;AACF;AACA;AAGEC,IAAAA,qBAAqBA,CAACC,WAAW,GAAG,OAAO,EAC3C;AACE,MAAA,MAAMC,KAAK,GAAGhF,gBAAe,CAACkC,YAAY,CAAC,IAAI,CAAC,SAAS,EAAE+C,MAAM,IAAI,CAAC;AACtE,MAAA,IAAID,KAAK,EACT;QACE,IAAI,CAAC7B,KAAK,GAAG6B,KAAK;AACpB,MAAA;AACA,MAAA,OAAOA,KAAK;AACd,IAAA;;AAEA;AACF;AACA;IAGEE,kBAAkBA,CAACC,OAAO,EAC1B,CACA;;AAEA;AACF;AACA;AAGEC,IAAAA,kBAAkBA,CAACL,WAAW,EAAEM,UAAU,EAC1C;AACE,MAAA,OAAO,IAAI7C,UAAU,CAAC6C,UAAU,CAAC;AACnC,IAAA;;AAEA;AACF;AACA;IAGEC,gBAAgBA,CAACP,WAAW,EAAE/B,MAAM,EAAEqC,UAAU,GAAGrC,MAAM,CAACF,UAAU,EACpE;MACE,IAAI,CAACK,KAAK,GAAGH,MAAM,CAACL,KAAK,CAAC,CAAC,EAAE0C,UAAU,CAAC;AACxC,MAAA,IAAI,CAAC,YAAY,GAAG,IAAI;AACxB,MAAA,IAAI,CAAC,eAAe,EAAE;AACxB,IAAA;;AAEA;AACF;AACA;AACA;IACE,eAAeE,GACf;AACE,MAAA,IAAI,CAAC,IAAI,CAAC,SAAS,EACnB;AACE,QAAA,IAAI,CAAC,SAAS,GAAGvF,gBAAe,CAAC+B,cAAc,CAAC,IAAI,CAACmB,MAAM,EAAE,IAAI,CAACnC,SAAS,EAAE,IAAI,CAAC;AACpF,MAAA;AACA,MAAA,IAAI,IAAI,CAAC,SAAS,IAAI,IAAI,CAACoC,KAAK,IAAI,IAAI,CAACA,KAAK,KAAK,IAAI,CAAC,YAAY,EACpE;QACE,IAAI,CAAC,SAAS,CAACqC,MAAM,GAAG,IAAI,CAACrC,KAAK,CAAC;AACnC,QAAA,IAAI,CAAC,YAAY,GAAG,IAAI,CAACA,KAAK;AAChC,MAAA;MACA,OAAO,IAAI,CAAC,SAAS;AACvB,IAAA;GACD;EArRQ,QAAQ,GAAG,IAAI;EAACsC,WAAAA,GAAA;IAAA,KAAA,CAAA3F,gBAAA,GAAAa,UAAA,EAAA;AAAA,EAAA;AAAA,CAAA,EAAA;;;;"}

package/dist/controllers/Tr2ActionResetClipSphereCenter.js

@@ -7,6 +7,12 @@ import { ResetBehavior } from './enums.js';
 import { ITr2ControllerAction } from './ITr2ControllerAction.js';
 
 let _initProto, _initClass, _init_resetBehavior, _init_extra_resetBehavior, _init_locatorIndex, _init_extra_locatorIndex, _init_locatorSetName, _init_extra_locatorSetName;
+
+/**
+ * Controller action that moves its owner's clip-sphere center on start, either
+ * back to the object center or onto a locator chosen from a named set or from
+ * the last damage-locator hit.
+ */
 let _Tr2ActionResetClipSp;
 new class extends _identity {
   static [class Tr2ActionResetClipSphereCenter extends CjsModel {
@@ -62,6 +68,17 @@ new class extends _identity {
         owner.ResetClipSphereCenter(center);
       }
     }
+
+    /**
+     * Gets a position from a named locator set, picking a uniformly random locator
+     * when the index is negative, and accepting either a bare 3-component locator
+     * or one carrying a `position`.
+     */
+
+    /**
+     * Truncates a value to a 32-bit integer locator index, substituting the
+     * fallback when it is not finite.
+     */
   }];
   #resolveLocatorPosition(owner, setName, index) {
     const locators = ITr2ControllerAction.callTarget(owner, "GetLocatorsForSet", setName) ?? (ITr2ControllerAction.hasProperty(owner, "locatorSets") && Array.isArray(owner.locatorSets) ? owner.locatorSets.find(set => ITr2ControllerAction.hasProperty(set, "name") && set.name === setName)?.locators : null);

package/dist/controllers/Tr2ActionResetClipSphereCenter.js.map

@@ -1 +1 @@
-{"version":3,"file":"Tr2ActionResetClipSphereCenter.js","sources":["../../../src/controllers/Tr2ActionResetClipSphereCenter.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\Controllers\\Actions\\Tr2ActionResetClipSphereCenter.h\n// Source: E:\\carbonengine\\trinity\\trinity\\Controllers\\Actions\\Tr2ActionResetClipSphereCenter.cpp\nimport { CjsModel } from \"@carbonenginejs/runtime-utils/model\";\nimport { isArrayLike } from \"@carbonenginejs/runtime-utils/is\";\nimport { carbon, impl, io, schema, type } from \"@carbonenginejs/runtime-utils/schema\";\nimport { vec3 } from \"@carbonenginejs/runtime-utils/vec3\";\nimport { ResetBehavior } from \"./enums.js\";\nimport { ITr2ControllerAction } from \"./ITr2ControllerAction.js\";\n\n\n@type.define({\n  className: \"Tr2ActionResetClipSphereCenter\",\n  family: \"controllers\"\n})\nexport class Tr2ActionResetClipSphereCenter extends CjsModel\n{\n  @io.persist\n  @type.int32\n  @schema.enum(\"ResetBehavior\")\n  resetBehavior = ResetBehavior.OBJECT_CENTER;\n\n  @io.persist\n  @type.int32\n  locatorIndex = -1;\n\n  @io.persist\n  @type.string\n  locatorSetName = \"\";\n\n  /**\n   * Resets the owner clip-sphere center from object or locator data.\n   */\n  @carbon.method\n  @impl.adapted\n  Start(controller)\n  {\n    const owner = ITr2ControllerAction.getOwner(controller);\n    if (this.resetBehavior === ResetBehavior.OBJECT_CENTER)\n    {\n      if (ITr2ControllerAction.hasFunction(owner, \"ResetClipSphereCenter\"))\n      {\n        owner.ResetClipSphereCenter();\n        return;\n      }\n      const value = ITr2ControllerAction.callTarget(owner, \"GetBoundingSphereCenter\") ?? (ITr2ControllerAction.hasProperty(owner, \"boundingSphereCenter\") ? owner.boundingSphereCenter : null);\n      if (isArrayLike(value, 3) && ITr2ControllerAction.hasProperty(owner, \"clipSphereCenter\") && isArrayLike(owner.clipSphereCenter, 3))\n      {\n        vec3.copy(owner.clipSphereCenter, value);\n        return;\n      }\n      return;\n    }\n    const locatorSetName = this.resetBehavior === ResetBehavior.LAST_DAMAGELOCATOR_HIT ? \"damage\" : this.locatorSetName;\n    const locatorIndex = this.resetBehavior === ResetBehavior.LAST_DAMAGELOCATOR_HIT ? Tr2ActionResetClipSphereCenter.#toIndex(ITr2ControllerAction.callTarget(owner, \"GetLastDamageLocatorHit\"), -1) : this.locatorIndex;\n    const center = Tr2ActionResetClipSphereCenter.#resolveLocatorPosition(owner, locatorSetName, locatorIndex);\n    if (!center)\n    {\n      return;\n    }\n    if (ITr2ControllerAction.hasFunction(owner, \"ResetClipSphereCenterToPos\"))\n    {\n      owner.ResetClipSphereCenterToPos(center);\n      return;\n    }\n    if (ITr2ControllerAction.hasProperty(owner, \"clipSphereCenter\") && isArrayLike(owner.clipSphereCenter, 3))\n    {\n      vec3.copy(owner.clipSphereCenter, center);\n      return;\n    }\n    if (ITr2ControllerAction.hasFunction(owner, \"ResetClipSphereCenter\"))\n    {\n      owner.ResetClipSphereCenter(center);\n    }\n  }\n\n  static #resolveLocatorPosition(owner, setName, index)\n  {\n    const locators = ITr2ControllerAction.callTarget(owner, \"GetLocatorsForSet\", setName) ?? (ITr2ControllerAction.hasProperty(owner, \"locatorSets\") && Array.isArray(owner.locatorSets) ? owner.locatorSets.find(set => ITr2ControllerAction.hasProperty(set, \"name\") && set.name === setName)?.locators : null);\n    if (!Array.isArray(locators) || !locators.length)\n    {\n      return null;\n    }\n    const resolvedIndex = index < 0 ? Math.floor(Math.random() * locators.length) : index;\n    const locator = locators[resolvedIndex] ?? null;\n    if (isArrayLike(locator, 3))\n    {\n      return locator;\n    }\n    if (ITr2ControllerAction.hasProperty(locator, \"position\") && isArrayLike(locator.position, 3))\n    {\n      return locator.position;\n    }\n    return null;\n  }\n\n  static #toIndex(value, fallback)\n  {\n    const number = Number(value);\n    return Number.isFinite(number) ? number | 0 : fallback;\n  }\n\n  static ResetBehavior = ResetBehavior;\n\n}\n"],"names":["_Tr2ActionResetClipSp","_identity","Tr2ActionResetClipSphereCenter","CjsModel","e","_init_resetBehavior","_init_extra_resetBehavior","_init_locatorIndex","_init_extra_locatorIndex","_init_locatorSetName","_init_extra_locatorSetName","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","persist","int32","schema","enum","string","carbon","method","impl","adapted","constructor","args","resetBehavior","ResetBehavior","OBJECT_CENTER","locatorIndex","locatorSetName","Start","controller","owner","ITr2ControllerAction","getOwner","hasFunction","ResetClipSphereCenter","value","callTarget","hasProperty","boundingSphereCenter","isArrayLike","clipSphereCenter","vec3","copy","LAST_DAMAGELOCATOR_HIT","center","ResetClipSphereCenterToPos","#resolveLocatorPosition","setName","index","locators","Array","isArray","locatorSets","find","set","name","length","resolvedIndex","Math","floor","random","locator","position","#toIndex","fallback","number","Number","isFinite"],"mappings":"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"}
+{"version":3,"file":"Tr2ActionResetClipSphereCenter.js","sources":["../../../src/controllers/Tr2ActionResetClipSphereCenter.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\Controllers\\Actions\\Tr2ActionResetClipSphereCenter.h\n// Source: E:\\carbonengine\\trinity\\trinity\\Controllers\\Actions\\Tr2ActionResetClipSphereCenter.cpp\nimport { CjsModel } from \"@carbonenginejs/runtime-utils/model\";\nimport { isArrayLike } from \"@carbonenginejs/runtime-utils/is\";\nimport { carbon, impl, io, schema, type } from \"@carbonenginejs/runtime-utils/schema\";\nimport { vec3 } from \"@carbonenginejs/runtime-utils/vec3\";\nimport { ResetBehavior } from \"./enums.js\";\nimport { ITr2ControllerAction } from \"./ITr2ControllerAction.js\";\n\n\n/**\n * Controller action that moves its owner's clip-sphere center on start, either\n * back to the object center or onto a locator chosen from a named set or from\n * the last damage-locator hit.\n */\n@type.define({\n  className: \"Tr2ActionResetClipSphereCenter\",\n  family: \"controllers\"\n})\nexport class Tr2ActionResetClipSphereCenter extends CjsModel\n{\n  @io.persist\n  @type.int32\n  @schema.enum(\"ResetBehavior\")\n  resetBehavior = ResetBehavior.OBJECT_CENTER;\n\n  @io.persist\n  @type.int32\n  locatorIndex = -1;\n\n  @io.persist\n  @type.string\n  locatorSetName = \"\";\n\n  /**\n   * Resets the owner clip-sphere center from object or locator data.\n   */\n  @carbon.method\n  @impl.adapted\n  Start(controller)\n  {\n    const owner = ITr2ControllerAction.getOwner(controller);\n    if (this.resetBehavior === ResetBehavior.OBJECT_CENTER)\n    {\n      if (ITr2ControllerAction.hasFunction(owner, \"ResetClipSphereCenter\"))\n      {\n        owner.ResetClipSphereCenter();\n        return;\n      }\n      const value = ITr2ControllerAction.callTarget(owner, \"GetBoundingSphereCenter\") ?? (ITr2ControllerAction.hasProperty(owner, \"boundingSphereCenter\") ? owner.boundingSphereCenter : null);\n      if (isArrayLike(value, 3) && ITr2ControllerAction.hasProperty(owner, \"clipSphereCenter\") && isArrayLike(owner.clipSphereCenter, 3))\n      {\n        vec3.copy(owner.clipSphereCenter, value);\n        return;\n      }\n      return;\n    }\n    const locatorSetName = this.resetBehavior === ResetBehavior.LAST_DAMAGELOCATOR_HIT ? \"damage\" : this.locatorSetName;\n    const locatorIndex = this.resetBehavior === ResetBehavior.LAST_DAMAGELOCATOR_HIT ? Tr2ActionResetClipSphereCenter.#toIndex(ITr2ControllerAction.callTarget(owner, \"GetLastDamageLocatorHit\"), -1) : this.locatorIndex;\n    const center = Tr2ActionResetClipSphereCenter.#resolveLocatorPosition(owner, locatorSetName, locatorIndex);\n    if (!center)\n    {\n      return;\n    }\n    if (ITr2ControllerAction.hasFunction(owner, \"ResetClipSphereCenterToPos\"))\n    {\n      owner.ResetClipSphereCenterToPos(center);\n      return;\n    }\n    if (ITr2ControllerAction.hasProperty(owner, \"clipSphereCenter\") && isArrayLike(owner.clipSphereCenter, 3))\n    {\n      vec3.copy(owner.clipSphereCenter, center);\n      return;\n    }\n    if (ITr2ControllerAction.hasFunction(owner, \"ResetClipSphereCenter\"))\n    {\n      owner.ResetClipSphereCenter(center);\n    }\n  }\n\n  /**\n   * Gets a position from a named locator set, picking a uniformly random locator\n   * when the index is negative, and accepting either a bare 3-component locator\n   * or one carrying a `position`.\n   */\n  static #resolveLocatorPosition(owner, setName, index)\n  {\n    const locators = ITr2ControllerAction.callTarget(owner, \"GetLocatorsForSet\", setName) ?? (ITr2ControllerAction.hasProperty(owner, \"locatorSets\") && Array.isArray(owner.locatorSets) ? owner.locatorSets.find(set => ITr2ControllerAction.hasProperty(set, \"name\") && set.name === setName)?.locators : null);\n    if (!Array.isArray(locators) || !locators.length)\n    {\n      return null;\n    }\n    const resolvedIndex = index < 0 ? Math.floor(Math.random() * locators.length) : index;\n    const locator = locators[resolvedIndex] ?? null;\n    if (isArrayLike(locator, 3))\n    {\n      return locator;\n    }\n    if (ITr2ControllerAction.hasProperty(locator, \"position\") && isArrayLike(locator.position, 3))\n    {\n      return locator.position;\n    }\n    return null;\n  }\n\n  /**\n   * Truncates a value to a 32-bit integer locator index, substituting the\n   * fallback when it is not finite.\n   */\n  static #toIndex(value, fallback)\n  {\n    const number = Number(value);\n    return Number.isFinite(number) ? number | 0 : fallback;\n  }\n\n  static ResetBehavior = ResetBehavior;\n\n}\n"],"names":["_Tr2ActionResetClipSp","_identity","Tr2ActionResetClipSphereCenter","CjsModel","e","_init_resetBehavior","_init_extra_resetBehavior","_init_locatorIndex","_init_extra_locatorIndex","_init_locatorSetName","_init_extra_locatorSetName","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","persist","int32","schema","enum","string","carbon","method","impl","adapted","constructor","args","resetBehavior","ResetBehavior","OBJECT_CENTER","locatorIndex","locatorSetName","Start","controller","owner","ITr2ControllerAction","getOwner","hasFunction","ResetClipSphereCenter","value","callTarget","hasProperty","boundingSphereCenter","isArrayLike","clipSphereCenter","vec3","copy","LAST_DAMAGELOCATOR_HIT","center","ResetClipSphereCenterToPos","#resolveLocatorPosition","setName","index","locators","Array","isArray","locatorSets","find","set","name","length","resolvedIndex","Math","floor","random","locator","position","#toIndex","fallback","number","Number","isFinite"],"mappings":"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"}

package/dist/controllers/Tr2ActionSetAttenuationScaling.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_controllerVariable, _init_extra_controllerVariable, _init_scalingFactor, _init_extra_scalingFactor;
+
+/**
+ * Controller action that sets an audio emitter's distance-attenuation scaling
+ * factor on start, optionally multiplied by a named controller variable.
+ */
 let _Tr2ActionSetAttenuat;
 class Tr2ActionSetAttenuationScaling extends CjsModel {
   static {