@carbonenginejs/runtime-trinity 0.6.0 → 0.8.0

package/dist/controllers/Tr2ControllerReference.js.map

@@ -1 +1 @@
-{"version":3,"file":"Tr2ControllerReference.js","sources":["../../../src/controllers/Tr2ControllerReference.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\Controllers\\Tr2ControllerReference.h\r\n// Source: E:\\carbonengine\\trinity\\trinity\\Controllers\\Tr2ControllerReference.cpp\r\nimport { CjsModel } from \"@carbonenginejs/runtime-utils/model\";\r\nimport { carbon, impl, io, type } from \"@carbonenginejs/runtime-utils/schema\";\r\nimport { UnlinkReason } from \"./enums.js\";\r\n\r\n\r\n@type.define({\r\n  className: \"Tr2ControllerReference\",\r\n  family: \"controllers\"\r\n})\r\nexport class Tr2ControllerReference extends CjsModel\r\n{\r\n  static #resourceResolver = null;\r\n\r\n  /** Registers the runtime-owned controller resource resolver. */\r\n  static registerResourceResolver(resolver)\r\n  {\r\n    const previous = this.#resourceResolver;\r\n    this.#resourceResolver = resolver;\r\n    return previous;\r\n  }\r\n\r\n  /** Clears the runtime-owned controller resource resolver. */\r\n  static clearResourceResolver()\r\n  {\r\n    this.#resourceResolver = null;\r\n  }\r\n\r\n  /** Resolves a controller resource without owning its lifecycle. */\r\n  static resolveResource(path, owner = null)\r\n  {\r\n    if (!path || !this.#resourceResolver)\r\n    {\r\n      return null;\r\n    }\r\n    const resolved = this.#resourceResolver(path, owner);\r\n    return resolved && typeof resolved === \"object\" ? resolved : null;\r\n  }\r\n\r\n  @io.read\r\n  @type.objectRef(\"ITr2Controller\")\r\n  controller = null;\r\n\r\n  @io.notify\r\n  @io.persist\r\n  @type.path\r\n  path = \"\";\r\n\r\n  #owner = null;\r\n\r\n  #resolvedPath = \"\";\r\n\r\n  /**\r\n   * Initializes the referenced controller when it is already assigned.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  Initialize()\r\n  {\r\n    this.ResolveController();\r\n    return true;\r\n  }\r\n\r\n  /**\r\n   * Handles path changes. Broad-safe: compares the authored path with the\r\n   * path the current controller was resolved from, so unrelated settles keep\r\n   * a resolved or directly attached controller.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  OnModified(_options = {})\r\n  {\r\n    if (this.path !== this.#resolvedPath)\r\n    {\r\n      this.controller = null;\r\n      this.ResolveController();\r\n    }\r\n    if (this.controller && this.#owner)\r\n    {\r\n      this.controller.Link?.(this.#owner);\r\n    }\r\n    return true;\r\n  }\r\n\r\n  /**\r\n   * Links the referenced controller to the same owner.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  Link(owner)\r\n  {\r\n    this.#owner = owner;\r\n    this.controller?.Link?.(owner);\r\n  }\r\n\r\n  /**\r\n   * Unlinks the referenced controller.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  Unlink(reason = UnlinkReason.UNLINKING)\r\n  {\r\n    this.controller?.Unlink?.(reason);\r\n    this.#owner = null;\r\n  }\r\n\r\n  /**\r\n   * Checks whether this reference is linked to an owner.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  IsLinked()\r\n  {\r\n    return this.#owner !== null;\r\n  }\r\n\r\n  /**\r\n   * Starts the referenced controller.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  Start()\r\n  {\r\n    this.controller?.Start?.();\r\n  }\r\n\r\n  /**\r\n   * Stops the referenced controller.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  Stop()\r\n  {\r\n    this.controller?.Stop?.();\r\n  }\r\n\r\n  /**\r\n   * Updates the referenced controller.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  Update(normalizedUpdateFrequency = 0)\r\n  {\r\n    this.controller?.Update?.(normalizedUpdateFrequency);\r\n  }\r\n\r\n  /**\r\n   * Sets a variable on the referenced controller.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  SetVariable(name, value)\r\n  {\r\n    this.controller?.SetVariable?.(name, value);\r\n  }\r\n\r\n  /**\r\n   * Handles an event on the referenced controller.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  HandleEvent(eventName)\r\n  {\r\n    this.controller?.HandleEvent?.(eventName);\r\n  }\r\n\r\n  /**\r\n   * Gets the linked owner.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  GetOwner()\r\n  {\r\n    return this.#owner;\r\n  }\r\n  ResolveController()\r\n  {\r\n    this.#resolvedPath = this.path;\r\n    if (!this.path)\r\n    {\r\n      this.controller = null;\r\n      return;\r\n    }\r\n    this.controller = Tr2ControllerReference.resolveResource(this.path, this.#owner);\r\n  }\r\n}\r\n"],"names":["_Tr2ControllerReferen","_identity","Tr2ControllerReference","CjsModel","e","_init_controller","_init_extra_controller","_init_path","_init_extra_path","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","read","objectRef","notify","persist","path","carbon","method","impl","adapted","implemented","registerResourceResolver","resolver","previous","clearResourceResolver","resolveResource","owner","resolved","controller","Initialize","ResolveController","OnModified","_options","Link","Unlink","reason","UnlinkReason","UNLINKING","IsLinked","Start","Stop","Update","normalizedUpdateFrequency","SetVariable","name","value","HandleEvent","eventName","GetOwner","constructor"],"mappings":"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"}
+{"version":3,"file":"Tr2ControllerReference.js","sources":["../../../src/controllers/Tr2ControllerReference.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\Controllers\\Tr2ControllerReference.h\r\n// Source: E:\\carbonengine\\trinity\\trinity\\Controllers\\Tr2ControllerReference.cpp\r\nimport { CjsModel } from \"@carbonenginejs/runtime-utils/model\";\r\nimport { carbon, impl, io, type } from \"@carbonenginejs/runtime-utils/schema\";\r\nimport { UnlinkReason } from \"./enums.js\";\r\n\r\n\r\n/**\r\n * Stands in for a controller loaded from a resource path, forwarding the full\r\n * controller lifecycle to whichever controller the path resolves to.\r\n */\r\n@type.define({\r\n  className: \"Tr2ControllerReference\",\r\n  family: \"controllers\"\r\n})\r\nexport class Tr2ControllerReference extends CjsModel\r\n{\r\n  static #resourceResolver = null;\r\n\r\n  /** Registers the runtime-owned controller resource resolver. */\r\n  static registerResourceResolver(resolver)\r\n  {\r\n    const previous = this.#resourceResolver;\r\n    this.#resourceResolver = resolver;\r\n    return previous;\r\n  }\r\n\r\n  /** Clears the runtime-owned controller resource resolver. */\r\n  static clearResourceResolver()\r\n  {\r\n    this.#resourceResolver = null;\r\n  }\r\n\r\n  /** Resolves a controller resource without owning its lifecycle. */\r\n  static resolveResource(path, owner = null)\r\n  {\r\n    if (!path || !this.#resourceResolver)\r\n    {\r\n      return null;\r\n    }\r\n    const resolved = this.#resourceResolver(path, owner);\r\n    return resolved && typeof resolved === \"object\" ? resolved : null;\r\n  }\r\n\r\n  @io.read\r\n  @type.objectRef(\"ITr2Controller\")\r\n  controller = null;\r\n\r\n  @io.notify\r\n  @io.persist\r\n  @type.path\r\n  path = \"\";\r\n\r\n  #owner = null;\r\n\r\n  #resolvedPath = \"\";\r\n\r\n  /**\r\n   * Initializes the referenced controller when it is already assigned.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  Initialize()\r\n  {\r\n    this.ResolveController();\r\n    return true;\r\n  }\r\n\r\n  /**\r\n   * Handles path changes. Broad-safe: compares the authored path with the\r\n   * path the current controller was resolved from, so unrelated settles keep\r\n   * a resolved or directly attached controller.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  OnModified(_options = {})\r\n  {\r\n    if (this.path !== this.#resolvedPath)\r\n    {\r\n      this.controller = null;\r\n      this.ResolveController();\r\n    }\r\n    if (this.controller && this.#owner)\r\n    {\r\n      this.controller.Link?.(this.#owner);\r\n    }\r\n    return true;\r\n  }\r\n\r\n  /**\r\n   * Links the referenced controller to the same owner.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  Link(owner)\r\n  {\r\n    this.#owner = owner;\r\n    this.controller?.Link?.(owner);\r\n  }\r\n\r\n  /**\r\n   * Unlinks the referenced controller.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  Unlink(reason = UnlinkReason.UNLINKING)\r\n  {\r\n    this.controller?.Unlink?.(reason);\r\n    this.#owner = null;\r\n  }\r\n\r\n  /**\r\n   * Checks whether this reference is linked to an owner.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  IsLinked()\r\n  {\r\n    return this.#owner !== null;\r\n  }\r\n\r\n  /**\r\n   * Starts the referenced controller.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  Start()\r\n  {\r\n    this.controller?.Start?.();\r\n  }\r\n\r\n  /**\r\n   * Stops the referenced controller.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  Stop()\r\n  {\r\n    this.controller?.Stop?.();\r\n  }\r\n\r\n  /**\r\n   * Updates the referenced controller.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  Update(normalizedUpdateFrequency = 0)\r\n  {\r\n    this.controller?.Update?.(normalizedUpdateFrequency);\r\n  }\r\n\r\n  /**\r\n   * Sets a variable on the referenced controller.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  SetVariable(name, value)\r\n  {\r\n    this.controller?.SetVariable?.(name, value);\r\n  }\r\n\r\n  /**\r\n   * Handles an event on the referenced controller.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  HandleEvent(eventName)\r\n  {\r\n    this.controller?.HandleEvent?.(eventName);\r\n  }\r\n\r\n  /**\r\n   * Gets the linked owner.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  GetOwner()\r\n  {\r\n    return this.#owner;\r\n  }\r\n\r\n  /**\r\n   * Resolves `controller` from the authored path through the registered resource\r\n   * resolver, recording the path it resolved from so OnModified can tell a real\r\n   * path change from an unrelated settle.\r\n   */\r\n  ResolveController()\r\n  {\r\n    this.#resolvedPath = this.path;\r\n    if (!this.path)\r\n    {\r\n      this.controller = null;\r\n      return;\r\n    }\r\n    this.controller = Tr2ControllerReference.resolveResource(this.path, this.#owner);\r\n  }\r\n}\r\n"],"names":["_Tr2ControllerReferen","_identity","Tr2ControllerReference","CjsModel","e","_init_controller","_init_extra_controller","_init_path","_init_extra_path","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","read","objectRef","notify","persist","path","carbon","method","impl","adapted","implemented","registerResourceResolver","resolver","previous","clearResourceResolver","resolveResource","owner","resolved","controller","Initialize","ResolveController","OnModified","_options","Link","Unlink","reason","UnlinkReason","UNLINKING","IsLinked","Start","Stop","Update","normalizedUpdateFrequency","SetVariable","name","value","HandleEvent","eventName","GetOwner","constructor"],"mappings":"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"}

package/dist/controllers/Tr2StateMachine.js

@@ -5,6 +5,12 @@ import { UnlinkReason } from './enums.js';
 import { BELIST_EVENTMASK, BELIST_REMOVED, GetControllerTimeSeconds, BELIST_INSERTED, TR2_DIRTY_ALL } from './contracts.js';
 
 let _initProto, _initClass, _init_states, _init_extra_states, _init_currentState, _init_extra_currentState, _init_startState, _init_extra_startState, _init_name, _init_extra_name;
+
+/**
+ * Runs one state at a time from an authored state list, entering at the
+ * configured start state and following transitions as controller variables
+ * change.
+ */
 let _Tr2StateMachine;
 new class extends _identity {
   static [class Tr2StateMachine extends CjsModel {
@@ -189,6 +195,12 @@ new class extends _identity {
     GetStateTime() {
       return this.GetStateRunTime();
     }
+
+    /**
+     * Advances through as many immediately-satisfied transitions as the current
+     * state chain produces, resetting the state start time on each hop; after 10
+     * hops it counts revisits and bails out at 20 to break a transition cycle.
+     */
     #followTransitions(dirtyVariables) {
       let next = this.currentState?.Update?.(dirtyVariables) ?? null;
       if (!next) {
@@ -209,6 +221,11 @@ new class extends _identity {
         next = this.currentState.Update?.(TR2_DIRTY_ALL) ?? null;
       }
     }
+
+    /**
+     * Narrows a list payload to an object reference before it is treated as a
+     * state.
+     */
   }];
   #asState(value) {
     return value && typeof value === "object" ? value : null;

package/dist/controllers/Tr2StateMachine.js.map

@@ -1 +1 @@
-{"version":3,"file":"Tr2StateMachine.js","sources":["../../../src/controllers/Tr2StateMachine.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\Controllers\\Tr2StateMachine.h\r\n// Source: E:\\carbonengine\\trinity\\trinity\\Controllers\\Tr2StateMachine.cpp\r\nimport { CjsModel } from \"@carbonenginejs/runtime-utils/model\";\r\nimport { carbon, impl, io, type } from \"@carbonenginejs/runtime-utils/schema\";\r\nimport { UnlinkReason } from \"./enums.js\";\r\nimport { BELIST_EVENTMASK, BELIST_INSERTED, BELIST_REMOVED, GetControllerTimeSeconds, TR2_DIRTY_ALL } from \"./contracts.js\";\r\n\r\n\r\n@type.define({\r\n  className: \"Tr2StateMachine\",\r\n  family: \"controllers\"\r\n})\r\nexport class Tr2StateMachine extends CjsModel\r\n{\r\n  @io.persist\r\n  @type.list(\"Tr2StateMachineState\")\r\n  states = [];\r\n\r\n  @io.read\r\n  @type.objectRef(\"Tr2StateMachineState\")\r\n  currentState = null;\r\n\r\n  @io.notify\r\n  @io.persist\r\n  @type.objectRef(\"Tr2StateMachineState\")\r\n  startState = null;\r\n\r\n  @io.persist\r\n  @type.string\r\n  name = \"\";\r\n\r\n  #controller = null;\r\n\r\n  #machineStartTime = 0;\r\n\r\n  #stateStartTime = 0;\r\n\r\n  /**\r\n   * Handles Carbon list notifications for the state list.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  OnListModified(event, _key = 0, _key2 = 0, value = null, list = this.states)\r\n  {\r\n    if (list !== this.states)\r\n    {\r\n      return;\r\n    }\r\n    const state = Tr2StateMachine.#asState(value);\r\n    switch (event & BELIST_EVENTMASK)\r\n    {\r\n      case BELIST_INSERTED:\r\n        if (this.#controller && state)\r\n        {\r\n          state.Link?.(this);\r\n        }\r\n        break;\r\n      case BELIST_REMOVED:\r\n        if (state)\r\n        {\r\n          if (state === this.currentState)\r\n          {\r\n            state.Stop?.();\r\n          }\r\n          this.currentState = this.startState;\r\n          this.#stateStartTime = GetControllerTimeSeconds();\r\n          this.currentState?.Start?.(this.#controller);\r\n          state.Unlink?.();\r\n        }\r\n        break;\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Relinks the start state after it is modified.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  OnModified(_options = {})\r\n  {\r\n    if (this.startState && this.#controller)\r\n    {\r\n      this.startState.Link?.(this);\r\n    }\r\n    return true;\r\n  }\r\n\r\n  /**\r\n   * Rebases runtime timestamps and action simulation time.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  OnSimClockRebase(oldTime, newTime)\r\n  {\r\n    const diff = newTime - oldTime;\r\n    this.#machineStartTime += diff;\r\n    this.#stateStartTime += diff;\r\n    for (const state of this.states)\r\n    {\r\n      state.RebaseSimTime?.(diff);\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Links all states to a controller.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  Link(controller)\r\n  {\r\n    this.Unlink();\r\n    this.#controller = controller;\r\n    for (const state of this.states)\r\n    {\r\n      state.Link?.(this);\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Unlinks all states from the current controller.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  Unlink(reason = UnlinkReason.UNLINKING)\r\n  {\r\n    if (!this.#controller)\r\n    {\r\n      return;\r\n    }\r\n    if (reason !== UnlinkReason.DELETING)\r\n    {\r\n      this.Stop();\r\n    }\r\n    for (const state of this.states)\r\n    {\r\n      state.Unlink?.(reason);\r\n    }\r\n    this.#controller = null;\r\n  }\r\n\r\n  /**\r\n   * Starts at the configured start state and follows immediate transitions.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  Start()\r\n  {\r\n    if (this.currentState || !this.#controller)\r\n    {\r\n      return;\r\n    }\r\n    this.currentState = this.startState;\r\n    const now = GetControllerTimeSeconds();\r\n    this.#machineStartTime = now;\r\n    this.#stateStartTime = now;\r\n    if (!this.currentState)\r\n    {\r\n      return;\r\n    }\r\n    this.currentState.Start?.(this.#controller);\r\n    this.#followTransitions(TR2_DIRTY_ALL);\r\n  }\r\n\r\n  /**\r\n   * Stops the current state.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  Stop()\r\n  {\r\n    if (this.currentState)\r\n    {\r\n      this.currentState.Stop?.(this.#controller);\r\n      this.currentState = null;\r\n    }\r\n    this.#machineStartTime = 0;\r\n    this.#stateStartTime = 0;\r\n  }\r\n\r\n  /**\r\n   * Updates the current state.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  Update(dirtyVariables = 0n)\r\n  {\r\n    if (this.currentState)\r\n    {\r\n      this.#followTransitions(dirtyVariables);\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Gets the linked controller.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  GetController()\r\n  {\r\n    return this.#controller;\r\n  }\r\n\r\n  /**\r\n   * Gets the active state.\r\n   */\r\n  GetCurrentState()\r\n  {\r\n    return this.currentState;\r\n  }\r\n\r\n  /**\r\n   * Gets a state by index.\r\n   */\r\n  GetState(index)\r\n  {\r\n    return this.states[index] ?? null;\r\n  }\r\n\r\n  /**\r\n   * Gets a state by authored name.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  GetStateByName(name)\r\n  {\r\n    return this.states.find(state => state.GetName?.() === name) ?? null;\r\n  }\r\n\r\n  /**\r\n   * Gets seconds since this state machine started.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  GetMachineRunTime()\r\n  {\r\n    return this.#machineStartTime ? GetControllerTimeSeconds() - this.#machineStartTime : 0;\r\n  }\r\n\r\n  /**\r\n   * Gets seconds since the current state started.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  GetStateRunTime()\r\n  {\r\n    return this.#stateStartTime ? GetControllerTimeSeconds() - this.#stateStartTime : 0;\r\n  }\r\n\r\n  /**\r\n   * Gets seconds since the current state started.\r\n   */\r\n  GetStateTime()\r\n  {\r\n    return this.GetStateRunTime();\r\n  }\r\n  #followTransitions(dirtyVariables)\r\n  {\r\n    let next = this.currentState?.Update?.(dirtyVariables) ?? null;\r\n    if (!next)\r\n    {\r\n      return;\r\n    }\r\n    const seen = new Map();\r\n    for (let iteration = 0; next; iteration++)\r\n    {\r\n      if (iteration > 10)\r\n      {\r\n        const count = (seen.get(next) ?? 0) + 1;\r\n        if (count > 20)\r\n        {\r\n          return;\r\n        }\r\n        seen.set(next, count);\r\n      }\r\n      this.currentState = next;\r\n      this.currentState.Start?.(this.#controller);\r\n      this.#stateStartTime = GetControllerTimeSeconds();\r\n      next = this.currentState.Update?.(TR2_DIRTY_ALL) ?? null;\r\n    }\r\n  }\r\n\r\n  static #asState(value)\r\n  {\r\n    return value && typeof value === \"object\" ? value : null;\r\n  }\r\n}\r\n"],"names":["_Tr2StateMachine","_identity","Tr2StateMachine","CjsModel","e","_init_states","_init_extra_states","_init_currentState","_init_extra_currentState","_init_startState","_init_extra_startState","_init_name","_init_extra_name","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","persist","list","read","objectRef","notify","string","carbon","method","impl","implemented","adapted","states","currentState","startState","name","OnListModified","event","_key","_key2","value","state","BELIST_EVENTMASK","BELIST_INSERTED","Link","BELIST_REMOVED","Stop","GetControllerTimeSeconds","Start","Unlink","OnModified","_options","OnSimClockRebase","oldTime","newTime","diff","RebaseSimTime","controller","reason","UnlinkReason","UNLINKING","DELETING","now","TR2_DIRTY_ALL","Update","dirtyVariables","GetController","GetCurrentState","GetState","index","GetStateByName","find","GetName","GetMachineRunTime","GetStateRunTime","GetStateTime","#followTransitions","next","seen","Map","iteration","count","get","set","#asState","constructor"],"mappings":"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"}
+{"version":3,"file":"Tr2StateMachine.js","sources":["../../../src/controllers/Tr2StateMachine.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\Controllers\\Tr2StateMachine.h\r\n// Source: E:\\carbonengine\\trinity\\trinity\\Controllers\\Tr2StateMachine.cpp\r\nimport { CjsModel } from \"@carbonenginejs/runtime-utils/model\";\r\nimport { carbon, impl, io, type } from \"@carbonenginejs/runtime-utils/schema\";\r\nimport { UnlinkReason } from \"./enums.js\";\r\nimport { BELIST_EVENTMASK, BELIST_INSERTED, BELIST_REMOVED, GetControllerTimeSeconds, TR2_DIRTY_ALL } from \"./contracts.js\";\r\n\r\n\r\n/**\r\n * Runs one state at a time from an authored state list, entering at the\r\n * configured start state and following transitions as controller variables\r\n * change.\r\n */\r\n@type.define({\r\n  className: \"Tr2StateMachine\",\r\n  family: \"controllers\"\r\n})\r\nexport class Tr2StateMachine extends CjsModel\r\n{\r\n  @io.persist\r\n  @type.list(\"Tr2StateMachineState\")\r\n  states = [];\r\n\r\n  @io.read\r\n  @type.objectRef(\"Tr2StateMachineState\")\r\n  currentState = null;\r\n\r\n  @io.notify\r\n  @io.persist\r\n  @type.objectRef(\"Tr2StateMachineState\")\r\n  startState = null;\r\n\r\n  @io.persist\r\n  @type.string\r\n  name = \"\";\r\n\r\n  #controller = null;\r\n\r\n  #machineStartTime = 0;\r\n\r\n  #stateStartTime = 0;\r\n\r\n  /**\r\n   * Handles Carbon list notifications for the state list.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  OnListModified(event, _key = 0, _key2 = 0, value = null, list = this.states)\r\n  {\r\n    if (list !== this.states)\r\n    {\r\n      return;\r\n    }\r\n    const state = Tr2StateMachine.#asState(value);\r\n    switch (event & BELIST_EVENTMASK)\r\n    {\r\n      case BELIST_INSERTED:\r\n        if (this.#controller && state)\r\n        {\r\n          state.Link?.(this);\r\n        }\r\n        break;\r\n      case BELIST_REMOVED:\r\n        if (state)\r\n        {\r\n          if (state === this.currentState)\r\n          {\r\n            state.Stop?.();\r\n          }\r\n          this.currentState = this.startState;\r\n          this.#stateStartTime = GetControllerTimeSeconds();\r\n          this.currentState?.Start?.(this.#controller);\r\n          state.Unlink?.();\r\n        }\r\n        break;\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Relinks the start state after it is modified.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  OnModified(_options = {})\r\n  {\r\n    if (this.startState && this.#controller)\r\n    {\r\n      this.startState.Link?.(this);\r\n    }\r\n    return true;\r\n  }\r\n\r\n  /**\r\n   * Rebases runtime timestamps and action simulation time.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  OnSimClockRebase(oldTime, newTime)\r\n  {\r\n    const diff = newTime - oldTime;\r\n    this.#machineStartTime += diff;\r\n    this.#stateStartTime += diff;\r\n    for (const state of this.states)\r\n    {\r\n      state.RebaseSimTime?.(diff);\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Links all states to a controller.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  Link(controller)\r\n  {\r\n    this.Unlink();\r\n    this.#controller = controller;\r\n    for (const state of this.states)\r\n    {\r\n      state.Link?.(this);\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Unlinks all states from the current controller.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  Unlink(reason = UnlinkReason.UNLINKING)\r\n  {\r\n    if (!this.#controller)\r\n    {\r\n      return;\r\n    }\r\n    if (reason !== UnlinkReason.DELETING)\r\n    {\r\n      this.Stop();\r\n    }\r\n    for (const state of this.states)\r\n    {\r\n      state.Unlink?.(reason);\r\n    }\r\n    this.#controller = null;\r\n  }\r\n\r\n  /**\r\n   * Starts at the configured start state and follows immediate transitions.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  Start()\r\n  {\r\n    if (this.currentState || !this.#controller)\r\n    {\r\n      return;\r\n    }\r\n    this.currentState = this.startState;\r\n    const now = GetControllerTimeSeconds();\r\n    this.#machineStartTime = now;\r\n    this.#stateStartTime = now;\r\n    if (!this.currentState)\r\n    {\r\n      return;\r\n    }\r\n    this.currentState.Start?.(this.#controller);\r\n    this.#followTransitions(TR2_DIRTY_ALL);\r\n  }\r\n\r\n  /**\r\n   * Stops the current state.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  Stop()\r\n  {\r\n    if (this.currentState)\r\n    {\r\n      this.currentState.Stop?.(this.#controller);\r\n      this.currentState = null;\r\n    }\r\n    this.#machineStartTime = 0;\r\n    this.#stateStartTime = 0;\r\n  }\r\n\r\n  /**\r\n   * Updates the current state.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  Update(dirtyVariables = 0n)\r\n  {\r\n    if (this.currentState)\r\n    {\r\n      this.#followTransitions(dirtyVariables);\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Gets the linked controller.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  GetController()\r\n  {\r\n    return this.#controller;\r\n  }\r\n\r\n  /**\r\n   * Gets the active state.\r\n   */\r\n  GetCurrentState()\r\n  {\r\n    return this.currentState;\r\n  }\r\n\r\n  /**\r\n   * Gets a state by index.\r\n   */\r\n  GetState(index)\r\n  {\r\n    return this.states[index] ?? null;\r\n  }\r\n\r\n  /**\r\n   * Gets a state by authored name.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  GetStateByName(name)\r\n  {\r\n    return this.states.find(state => state.GetName?.() === name) ?? null;\r\n  }\r\n\r\n  /**\r\n   * Gets seconds since this state machine started.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  GetMachineRunTime()\r\n  {\r\n    return this.#machineStartTime ? GetControllerTimeSeconds() - this.#machineStartTime : 0;\r\n  }\r\n\r\n  /**\r\n   * Gets seconds since the current state started.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  GetStateRunTime()\r\n  {\r\n    return this.#stateStartTime ? GetControllerTimeSeconds() - this.#stateStartTime : 0;\r\n  }\r\n\r\n  /**\r\n   * Gets seconds since the current state started.\r\n   */\r\n  GetStateTime()\r\n  {\r\n    return this.GetStateRunTime();\r\n  }\r\n\r\n  /**\r\n   * Advances through as many immediately-satisfied transitions as the current\r\n   * state chain produces, resetting the state start time on each hop; after 10\r\n   * hops it counts revisits and bails out at 20 to break a transition cycle.\r\n   */\r\n  #followTransitions(dirtyVariables)\r\n  {\r\n    let next = this.currentState?.Update?.(dirtyVariables) ?? null;\r\n    if (!next)\r\n    {\r\n      return;\r\n    }\r\n    const seen = new Map();\r\n    for (let iteration = 0; next; iteration++)\r\n    {\r\n      if (iteration > 10)\r\n      {\r\n        const count = (seen.get(next) ?? 0) + 1;\r\n        if (count > 20)\r\n        {\r\n          return;\r\n        }\r\n        seen.set(next, count);\r\n      }\r\n      this.currentState = next;\r\n      this.currentState.Start?.(this.#controller);\r\n      this.#stateStartTime = GetControllerTimeSeconds();\r\n      next = this.currentState.Update?.(TR2_DIRTY_ALL) ?? null;\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Narrows a list payload to an object reference before it is treated as a\r\n   * state.\r\n   */\r\n  static #asState(value)\r\n  {\r\n    return value && typeof value === \"object\" ? value : null;\r\n  }\r\n}\r\n"],"names":["_Tr2StateMachine","_identity","Tr2StateMachine","CjsModel","e","_init_states","_init_extra_states","_init_currentState","_init_extra_currentState","_init_startState","_init_extra_startState","_init_name","_init_extra_name","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","persist","list","read","objectRef","notify","string","carbon","method","impl","implemented","adapted","states","currentState","startState","name","OnListModified","event","_key","_key2","value","state","BELIST_EVENTMASK","BELIST_INSERTED","Link","BELIST_REMOVED","Stop","GetControllerTimeSeconds","Start","Unlink","OnModified","_options","OnSimClockRebase","oldTime","newTime","diff","RebaseSimTime","controller","reason","UnlinkReason","UNLINKING","DELETING","now","TR2_DIRTY_ALL","Update","dirtyVariables","GetController","GetCurrentState","GetState","index","GetStateByName","find","GetName","GetMachineRunTime","GetStateRunTime","GetStateTime","#followTransitions","next","seen","Map","iteration","count","get","set","#asState","constructor"],"mappings":"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"}

package/dist/controllers/Tr2StateMachineState.js

@@ -5,6 +5,12 @@ import { UnlinkReason } from './enums.js';
 import { TR2_DIRTY_ALL, BELIST_EVENTMASK, BELIST_REMOVED, BELIST_INSERTED } from './contracts.js';
 
 let _initProto, _initClass, _init_actions, _init_extra_actions, _init_transitions, _init_extra_transitions, _init_finalizer, _init_extra_finalizer, _init_name, _init_extra_name;
+
+/**
+ * One state of a Tr2StateMachine: starts and stops its action list on entry and
+ * exit, and evaluates its outgoing transitions each update to decide the next
+ * state.
+ */
 let _Tr2StateMachineState;
 new class extends _identity {
   static [class Tr2StateMachineState extends CjsModel {
@@ -228,6 +234,11 @@ new class extends _identity {
       }
       return !this.finalizer || !controller || this.finalizer.CanTransition(controller);
     }
+
+    /**
+     * Finds the destination of the first transition that activates against a fully
+     * dirty variable mask, used to resolve where to go once finalizing completes.
+     */
     #getNextState() {
       for (const transition of this.transitions) {
         const destination = transition.GetDestination?.() ?? null;
@@ -237,9 +248,19 @@ new class extends _identity {
       }
       return null;
     }
+
+    /**
+     * Gets the controller through the linked state machine, or null when this
+     * state is unlinked.
+     */
     #getController() {
       return this.#stateMachine?.GetController?.() ?? null;
     }
+
+    /**
+     * Links and starts an inserted action when the state is already active, or
+     * stops and unlinks a removed one.
+     */
     #onActionListModified(event, value) {
       const action = _Tr2StateMachineState.#asAction(value);
       const controller = this.#getController();
@@ -262,6 +283,12 @@ new class extends _identity {
           break;
       }
     }
+
+    /**
+     * Links or unlinks a transition as the list changes and recomputes the
+     * combined variable mask, which gates whether Update evaluates transitions at
+     * all.
+     */
     #onTransitionListModified(event, value) {
       const transition = _Tr2StateMachineState.#asTransition(value);
       switch (event & BELIST_EVENTMASK) {
@@ -279,6 +306,26 @@ new class extends _identity {
           break;
       }
     }
+
+    /**
+     * Narrows a list payload to an object reference before it is treated as an
+     * action.
+     */
+
+    /**
+     * Narrows a list payload to an object reference before it is treated as a
+     * transition.
+     */
+
+    /**
+     * Coerces a variable mask to BigInt so masks from different sources can be
+     * combined exactly.
+     */
+
+    /**
+     * Checks whether any variable this state's transitions depend on is marked
+     * dirty this frame.
+     */
   }];
   #asAction(value) {
     return value && typeof value === "object" ? value : null;

package/dist/controllers/Tr2StateMachineState.js.map

@@ -1 +1 @@
-{"version":3,"file":"Tr2StateMachineState.js","sources":["../../../src/controllers/Tr2StateMachineState.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\Controllers\\Tr2StateMachineState.h\r\n// Source: E:\\carbonengine\\trinity\\trinity\\Controllers\\Tr2StateMachineState.cpp\r\nimport { CjsModel } from \"@carbonenginejs/runtime-utils/model\";\r\nimport { carbon, impl, io, type } from \"@carbonenginejs/runtime-utils/schema\";\r\nimport { UnlinkReason } from \"./enums.js\";\r\nimport { BELIST_EVENTMASK, BELIST_INSERTED, BELIST_REMOVED, TR2_DIRTY_ALL } from \"./contracts.js\";\r\n\r\n\r\n@type.define({\r\n  className: \"Tr2StateMachineState\",\r\n  family: \"controllers\"\r\n})\r\nexport class Tr2StateMachineState extends CjsModel\r\n{\r\n  @io.persist\r\n  @type.list(\"ITr2ControllerAction\")\r\n  actions = [];\r\n\r\n  @io.persist\r\n  @type.list(\"Tr2StateMachineTransition\")\r\n  transitions = [];\r\n\r\n  @io.notify\r\n  @io.persist\r\n  @type.objectRef(\"ITr2StateMachineStateFinalizer\")\r\n  finalizer = null;\r\n\r\n  @io.persist\r\n  @type.string\r\n  name = \"\";\r\n\r\n  #stateMachine = null;\r\n\r\n  #isActive = false;\r\n\r\n  #isFinalizing = false;\r\n\r\n  #hasBeenVetoed = false;\r\n\r\n  #transitionVariableMask = 0n;\r\n\r\n  /**\r\n   * Relinks the finalizer after it is modified.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  OnModified(_options = {})\r\n  {\r\n    const controller = this.#stateMachine?.GetController?.() ?? null;\r\n    if (this.finalizer && controller)\r\n    {\r\n      this.finalizer.Link?.(controller);\r\n    }\r\n    return true;\r\n  }\r\n\r\n  /**\r\n   * Handles Carbon list notifications for action and transition lists.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  OnListModified(event, _key = 0, _key2 = 0, value = null, list = null)\r\n  {\r\n    if (list === this.actions)\r\n    {\r\n      this.#onActionListModified(event, value);\r\n    }\r\n    else if (list === this.transitions)\r\n    {\r\n      this.#onTransitionListModified(event, value);\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Links transitions, actions, and the finalizer to a state machine.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  Link(stateMachine)\r\n  {\r\n    this.Unlink();\r\n    this.#stateMachine = stateMachine;\r\n    this.UpdateVariableMask();\r\n    for (const transition of this.transitions)\r\n    {\r\n      transition.Link?.(this);\r\n    }\r\n    this.UpdateVariableMask();\r\n    const controller = this.#getController();\r\n    if (controller)\r\n    {\r\n      for (const action of this.actions)\r\n      {\r\n        action.Link?.(controller);\r\n      }\r\n      this.finalizer?.Link?.(controller);\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Recomputes the combined transition variable mask.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  UpdateVariableMask()\r\n  {\r\n    this.#transitionVariableMask = 0n;\r\n    let hasMask = true;\r\n    for (const transition of this.transitions)\r\n    {\r\n      const mask = Tr2StateMachineState.#toBigIntMask(transition.GetVariableMask?.() ?? 0n);\r\n      if (mask === 0n)\r\n      {\r\n        hasMask = false;\r\n      }\r\n      else\r\n      {\r\n        this.#transitionVariableMask |= mask;\r\n      }\r\n    }\r\n    if (!hasMask)\r\n    {\r\n      this.#transitionVariableMask = 0n;\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Unlinks transitions, actions, and the finalizer.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  Unlink(reason = UnlinkReason.UNLINKING)\r\n  {\r\n    if (!this.#stateMachine)\r\n    {\r\n      return;\r\n    }\r\n    if (reason !== UnlinkReason.DELETING)\r\n    {\r\n      this.Stop();\r\n    }\r\n    this.#stateMachine = null;\r\n    for (const transition of this.transitions)\r\n    {\r\n      transition.Unlink?.();\r\n    }\r\n    for (const action of this.actions)\r\n    {\r\n      action.Unlink?.();\r\n    }\r\n    this.finalizer?.Unlink?.();\r\n  }\r\n\r\n  /**\r\n   * Starts all actions.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  Start(controller = this.#getController())\r\n  {\r\n    if (this.#isActive)\r\n    {\r\n      return;\r\n    }\r\n    if (!controller)\r\n    {\r\n      return;\r\n    }\r\n    for (const action of this.actions)\r\n    {\r\n      action.Start?.(controller);\r\n    }\r\n    this.#isActive = true;\r\n    this.#isFinalizing = false;\r\n    this.#hasBeenVetoed = false;\r\n  }\r\n\r\n  /**\r\n   * Stops all actions.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  Stop(controller = this.#getController())\r\n  {\r\n    if (!this.#isActive || this.#isFinalizing)\r\n    {\r\n      return;\r\n    }\r\n    if (controller)\r\n    {\r\n      for (const action of this.actions)\r\n      {\r\n        action.Stop?.(controller);\r\n      }\r\n    }\r\n    if (this.finalizer && controller && !this.finalizer.CanTransition(controller))\r\n    {\r\n      this.#isFinalizing = true;\r\n      return;\r\n    }\r\n    this.#isActive = false;\r\n  }\r\n\r\n  /**\r\n   * Updates transitions and returns the next state when one activates.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  Update(dirtyVariables = 0n)\r\n  {\r\n    if (!this.#isActive)\r\n    {\r\n      return null;\r\n    }\r\n    const controller = this.#getController();\r\n    if (!controller)\r\n    {\r\n      return null;\r\n    }\r\n    if (this.#isFinalizing)\r\n    {\r\n      const next = this.#getNextState();\r\n      if (!next)\r\n      {\r\n        this.#isActive = false;\r\n        this.Start(controller);\r\n      }\r\n      if (!this.finalizer || this.finalizer.CanTransition(controller))\r\n      {\r\n        return next;\r\n      }\r\n      return null;\r\n    }\r\n    if (this.#hasBeenVetoed)\r\n    {\r\n      dirtyVariables = TR2_DIRTY_ALL;\r\n    }\r\n    if (this.#transitionVariableMask !== 0n && !Tr2StateMachineState.#dirtyMaskMatches(this.#transitionVariableMask, dirtyVariables))\r\n    {\r\n      return null;\r\n    }\r\n    for (const transition of this.transitions)\r\n    {\r\n      const destination = transition.GetDestination?.() ?? null;\r\n      const canTransition = transition.CanActivate?.(dirtyVariables) ?? false;\r\n      if (canTransition && destination)\r\n      {\r\n        for (const action of this.actions)\r\n        {\r\n          if (action.CanTransition && !action.CanTransition())\r\n          {\r\n            this.#hasBeenVetoed = true;\r\n            return null;\r\n          }\r\n        }\r\n        this.Stop(controller);\r\n        if (this.#isFinalizing)\r\n        {\r\n          return null;\r\n        }\r\n        return destination;\r\n      }\r\n    }\r\n    return null;\r\n  }\r\n\r\n  /**\r\n   * Rebases action simulation time.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  RebaseSimTime(diff)\r\n  {\r\n    for (const action of this.actions)\r\n    {\r\n      action.RebaseSimTime?.(diff);\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Gets the linked state machine.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  GetStateMachine()\r\n  {\r\n    return this.#stateMachine;\r\n  }\r\n\r\n  /**\r\n   * Gets the authored state name.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  GetName()\r\n  {\r\n    return this.name;\r\n  }\r\n\r\n  /**\r\n   * Checks whether actions and the finalizer allow transition.\r\n   */\r\n  CanTransition(controller = this.#getController())\r\n  {\r\n    for (const action of this.actions)\r\n    {\r\n      if (action.CanTransition && !action.CanTransition())\r\n      {\r\n        this.#hasBeenVetoed = true;\r\n        return false;\r\n      }\r\n    }\r\n    return !this.finalizer || !controller || this.finalizer.CanTransition(controller);\r\n  }\r\n  #getNextState()\r\n  {\r\n    for (const transition of this.transitions)\r\n    {\r\n      const destination = transition.GetDestination?.() ?? null;\r\n      if (transition.CanActivate?.(TR2_DIRTY_ALL) && destination)\r\n      {\r\n        return destination;\r\n      }\r\n    }\r\n    return null;\r\n  }\r\n  #getController()\r\n  {\r\n    return this.#stateMachine?.GetController?.() ?? null;\r\n  }\r\n  #onActionListModified(event, value)\r\n  {\r\n    const action = Tr2StateMachineState.#asAction(value);\r\n    const controller = this.#getController();\r\n    switch (event & BELIST_EVENTMASK)\r\n    {\r\n      case BELIST_INSERTED:\r\n        if (controller && action)\r\n        {\r\n          action.Link?.(controller);\r\n          if (this.#isActive)\r\n          {\r\n            action.Start?.(controller);\r\n          }\r\n        }\r\n        break;\r\n      case BELIST_REMOVED:\r\n        if (action)\r\n        {\r\n          if (controller && this.#isActive)\r\n          {\r\n            action.Stop?.(controller);\r\n          }\r\n          action.Unlink?.();\r\n        }\r\n        break;\r\n    }\r\n  }\r\n  #onTransitionListModified(event, value)\r\n  {\r\n    const transition = Tr2StateMachineState.#asTransition(value);\r\n    switch (event & BELIST_EVENTMASK)\r\n    {\r\n      case BELIST_INSERTED:\r\n        if (this.#stateMachine && transition)\r\n        {\r\n          transition.Link?.(this);\r\n          this.UpdateVariableMask();\r\n        }\r\n        break;\r\n      case BELIST_REMOVED:\r\n        if (transition)\r\n        {\r\n          transition.Unlink?.();\r\n          this.UpdateVariableMask();\r\n        }\r\n        break;\r\n    }\r\n  }\r\n\r\n  static #asAction(value)\r\n  {\r\n    return value && typeof value === \"object\" ? value : null;\r\n  }\r\n\r\n  static #asTransition(value)\r\n  {\r\n    return value && typeof value === \"object\" ? value : null;\r\n  }\r\n\r\n  static #toBigIntMask(value)\r\n  {\r\n    return typeof value === \"bigint\" ? value : BigInt(value);\r\n  }\r\n\r\n  static #dirtyMaskMatches(mask, dirtyVariables)\r\n  {\r\n    return (mask & Tr2StateMachineState.#toBigIntMask(dirtyVariables)) !== 0n;\r\n  }\r\n}\r\n"],"names":["_Tr2StateMachineState","_identity","Tr2StateMachineState","CjsModel","e","_init_actions","_init_extra_actions","_init_transitions","_init_extra_transitions","_init_finalizer","_init_extra_finalizer","_init_name","_init_extra_name","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","persist","list","notify","objectRef","string","carbon","method","impl","implemented","adapted","actions","transitions","finalizer","name","OnModified","_options","controller","GetController","Link","OnListModified","event","_key","_key2","value","stateMachine","Unlink","UpdateVariableMask","transition","action","hasMask","mask","GetVariableMask","reason","UnlinkReason","UNLINKING","DELETING","Stop","Start","CanTransition","Update","dirtyVariables","next","TR2_DIRTY_ALL","destination","GetDestination","canTransition","CanActivate","RebaseSimTime","diff","GetStateMachine","GetName","#getNextState","#getController","#onActionListModified","BELIST_EVENTMASK","BELIST_INSERTED","BELIST_REMOVED","#onTransitionListModified","#asAction","#asTransition","#toBigIntMask","BigInt","#dirtyMaskMatches","constructor"],"mappings":"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"}
+{"version":3,"file":"Tr2StateMachineState.js","sources":["../../../src/controllers/Tr2StateMachineState.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\Controllers\\Tr2StateMachineState.h\r\n// Source: E:\\carbonengine\\trinity\\trinity\\Controllers\\Tr2StateMachineState.cpp\r\nimport { CjsModel } from \"@carbonenginejs/runtime-utils/model\";\r\nimport { carbon, impl, io, type } from \"@carbonenginejs/runtime-utils/schema\";\r\nimport { UnlinkReason } from \"./enums.js\";\r\nimport { BELIST_EVENTMASK, BELIST_INSERTED, BELIST_REMOVED, TR2_DIRTY_ALL } from \"./contracts.js\";\r\n\r\n\r\n/**\r\n * One state of a Tr2StateMachine: starts and stops its action list on entry and\r\n * exit, and evaluates its outgoing transitions each update to decide the next\r\n * state.\r\n */\r\n@type.define({\r\n  className: \"Tr2StateMachineState\",\r\n  family: \"controllers\"\r\n})\r\nexport class Tr2StateMachineState extends CjsModel\r\n{\r\n  @io.persist\r\n  @type.list(\"ITr2ControllerAction\")\r\n  actions = [];\r\n\r\n  @io.persist\r\n  @type.list(\"Tr2StateMachineTransition\")\r\n  transitions = [];\r\n\r\n  @io.notify\r\n  @io.persist\r\n  @type.objectRef(\"ITr2StateMachineStateFinalizer\")\r\n  finalizer = null;\r\n\r\n  @io.persist\r\n  @type.string\r\n  name = \"\";\r\n\r\n  #stateMachine = null;\r\n\r\n  #isActive = false;\r\n\r\n  #isFinalizing = false;\r\n\r\n  #hasBeenVetoed = false;\r\n\r\n  #transitionVariableMask = 0n;\r\n\r\n  /**\r\n   * Relinks the finalizer after it is modified.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  OnModified(_options = {})\r\n  {\r\n    const controller = this.#stateMachine?.GetController?.() ?? null;\r\n    if (this.finalizer && controller)\r\n    {\r\n      this.finalizer.Link?.(controller);\r\n    }\r\n    return true;\r\n  }\r\n\r\n  /**\r\n   * Handles Carbon list notifications for action and transition lists.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  OnListModified(event, _key = 0, _key2 = 0, value = null, list = null)\r\n  {\r\n    if (list === this.actions)\r\n    {\r\n      this.#onActionListModified(event, value);\r\n    }\r\n    else if (list === this.transitions)\r\n    {\r\n      this.#onTransitionListModified(event, value);\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Links transitions, actions, and the finalizer to a state machine.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  Link(stateMachine)\r\n  {\r\n    this.Unlink();\r\n    this.#stateMachine = stateMachine;\r\n    this.UpdateVariableMask();\r\n    for (const transition of this.transitions)\r\n    {\r\n      transition.Link?.(this);\r\n    }\r\n    this.UpdateVariableMask();\r\n    const controller = this.#getController();\r\n    if (controller)\r\n    {\r\n      for (const action of this.actions)\r\n      {\r\n        action.Link?.(controller);\r\n      }\r\n      this.finalizer?.Link?.(controller);\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Recomputes the combined transition variable mask.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  UpdateVariableMask()\r\n  {\r\n    this.#transitionVariableMask = 0n;\r\n    let hasMask = true;\r\n    for (const transition of this.transitions)\r\n    {\r\n      const mask = Tr2StateMachineState.#toBigIntMask(transition.GetVariableMask?.() ?? 0n);\r\n      if (mask === 0n)\r\n      {\r\n        hasMask = false;\r\n      }\r\n      else\r\n      {\r\n        this.#transitionVariableMask |= mask;\r\n      }\r\n    }\r\n    if (!hasMask)\r\n    {\r\n      this.#transitionVariableMask = 0n;\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Unlinks transitions, actions, and the finalizer.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  Unlink(reason = UnlinkReason.UNLINKING)\r\n  {\r\n    if (!this.#stateMachine)\r\n    {\r\n      return;\r\n    }\r\n    if (reason !== UnlinkReason.DELETING)\r\n    {\r\n      this.Stop();\r\n    }\r\n    this.#stateMachine = null;\r\n    for (const transition of this.transitions)\r\n    {\r\n      transition.Unlink?.();\r\n    }\r\n    for (const action of this.actions)\r\n    {\r\n      action.Unlink?.();\r\n    }\r\n    this.finalizer?.Unlink?.();\r\n  }\r\n\r\n  /**\r\n   * Starts all actions.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  Start(controller = this.#getController())\r\n  {\r\n    if (this.#isActive)\r\n    {\r\n      return;\r\n    }\r\n    if (!controller)\r\n    {\r\n      return;\r\n    }\r\n    for (const action of this.actions)\r\n    {\r\n      action.Start?.(controller);\r\n    }\r\n    this.#isActive = true;\r\n    this.#isFinalizing = false;\r\n    this.#hasBeenVetoed = false;\r\n  }\r\n\r\n  /**\r\n   * Stops all actions.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  Stop(controller = this.#getController())\r\n  {\r\n    if (!this.#isActive || this.#isFinalizing)\r\n    {\r\n      return;\r\n    }\r\n    if (controller)\r\n    {\r\n      for (const action of this.actions)\r\n      {\r\n        action.Stop?.(controller);\r\n      }\r\n    }\r\n    if (this.finalizer && controller && !this.finalizer.CanTransition(controller))\r\n    {\r\n      this.#isFinalizing = true;\r\n      return;\r\n    }\r\n    this.#isActive = false;\r\n  }\r\n\r\n  /**\r\n   * Updates transitions and returns the next state when one activates.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  Update(dirtyVariables = 0n)\r\n  {\r\n    if (!this.#isActive)\r\n    {\r\n      return null;\r\n    }\r\n    const controller = this.#getController();\r\n    if (!controller)\r\n    {\r\n      return null;\r\n    }\r\n    if (this.#isFinalizing)\r\n    {\r\n      const next = this.#getNextState();\r\n      if (!next)\r\n      {\r\n        this.#isActive = false;\r\n        this.Start(controller);\r\n      }\r\n      if (!this.finalizer || this.finalizer.CanTransition(controller))\r\n      {\r\n        return next;\r\n      }\r\n      return null;\r\n    }\r\n    if (this.#hasBeenVetoed)\r\n    {\r\n      dirtyVariables = TR2_DIRTY_ALL;\r\n    }\r\n    if (this.#transitionVariableMask !== 0n && !Tr2StateMachineState.#dirtyMaskMatches(this.#transitionVariableMask, dirtyVariables))\r\n    {\r\n      return null;\r\n    }\r\n    for (const transition of this.transitions)\r\n    {\r\n      const destination = transition.GetDestination?.() ?? null;\r\n      const canTransition = transition.CanActivate?.(dirtyVariables) ?? false;\r\n      if (canTransition && destination)\r\n      {\r\n        for (const action of this.actions)\r\n        {\r\n          if (action.CanTransition && !action.CanTransition())\r\n          {\r\n            this.#hasBeenVetoed = true;\r\n            return null;\r\n          }\r\n        }\r\n        this.Stop(controller);\r\n        if (this.#isFinalizing)\r\n        {\r\n          return null;\r\n        }\r\n        return destination;\r\n      }\r\n    }\r\n    return null;\r\n  }\r\n\r\n  /**\r\n   * Rebases action simulation time.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  RebaseSimTime(diff)\r\n  {\r\n    for (const action of this.actions)\r\n    {\r\n      action.RebaseSimTime?.(diff);\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Gets the linked state machine.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  GetStateMachine()\r\n  {\r\n    return this.#stateMachine;\r\n  }\r\n\r\n  /**\r\n   * Gets the authored state name.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  GetName()\r\n  {\r\n    return this.name;\r\n  }\r\n\r\n  /**\r\n   * Checks whether actions and the finalizer allow transition.\r\n   */\r\n  CanTransition(controller = this.#getController())\r\n  {\r\n    for (const action of this.actions)\r\n    {\r\n      if (action.CanTransition && !action.CanTransition())\r\n      {\r\n        this.#hasBeenVetoed = true;\r\n        return false;\r\n      }\r\n    }\r\n    return !this.finalizer || !controller || this.finalizer.CanTransition(controller);\r\n  }\r\n\r\n  /**\r\n   * Finds the destination of the first transition that activates against a fully\r\n   * dirty variable mask, used to resolve where to go once finalizing completes.\r\n   */\r\n  #getNextState()\r\n  {\r\n    for (const transition of this.transitions)\r\n    {\r\n      const destination = transition.GetDestination?.() ?? null;\r\n      if (transition.CanActivate?.(TR2_DIRTY_ALL) && destination)\r\n      {\r\n        return destination;\r\n      }\r\n    }\r\n    return null;\r\n  }\r\n\r\n  /**\r\n   * Gets the controller through the linked state machine, or null when this\r\n   * state is unlinked.\r\n   */\r\n  #getController()\r\n  {\r\n    return this.#stateMachine?.GetController?.() ?? null;\r\n  }\r\n\r\n  /**\r\n   * Links and starts an inserted action when the state is already active, or\r\n   * stops and unlinks a removed one.\r\n   */\r\n  #onActionListModified(event, value)\r\n  {\r\n    const action = Tr2StateMachineState.#asAction(value);\r\n    const controller = this.#getController();\r\n    switch (event & BELIST_EVENTMASK)\r\n    {\r\n      case BELIST_INSERTED:\r\n        if (controller && action)\r\n        {\r\n          action.Link?.(controller);\r\n          if (this.#isActive)\r\n          {\r\n            action.Start?.(controller);\r\n          }\r\n        }\r\n        break;\r\n      case BELIST_REMOVED:\r\n        if (action)\r\n        {\r\n          if (controller && this.#isActive)\r\n          {\r\n            action.Stop?.(controller);\r\n          }\r\n          action.Unlink?.();\r\n        }\r\n        break;\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Links or unlinks a transition as the list changes and recomputes the\r\n   * combined variable mask, which gates whether Update evaluates transitions at\r\n   * all.\r\n   */\r\n  #onTransitionListModified(event, value)\r\n  {\r\n    const transition = Tr2StateMachineState.#asTransition(value);\r\n    switch (event & BELIST_EVENTMASK)\r\n    {\r\n      case BELIST_INSERTED:\r\n        if (this.#stateMachine && transition)\r\n        {\r\n          transition.Link?.(this);\r\n          this.UpdateVariableMask();\r\n        }\r\n        break;\r\n      case BELIST_REMOVED:\r\n        if (transition)\r\n        {\r\n          transition.Unlink?.();\r\n          this.UpdateVariableMask();\r\n        }\r\n        break;\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Narrows a list payload to an object reference before it is treated as an\r\n   * action.\r\n   */\r\n  static #asAction(value)\r\n  {\r\n    return value && typeof value === \"object\" ? value : null;\r\n  }\r\n\r\n  /**\r\n   * Narrows a list payload to an object reference before it is treated as a\r\n   * transition.\r\n   */\r\n  static #asTransition(value)\r\n  {\r\n    return value && typeof value === \"object\" ? value : null;\r\n  }\r\n\r\n  /**\r\n   * Coerces a variable mask to BigInt so masks from different sources can be\r\n   * combined exactly.\r\n   */\r\n  static #toBigIntMask(value)\r\n  {\r\n    return typeof value === \"bigint\" ? value : BigInt(value);\r\n  }\r\n\r\n  /**\r\n   * Checks whether any variable this state's transitions depend on is marked\r\n   * dirty this frame.\r\n   */\r\n  static #dirtyMaskMatches(mask, dirtyVariables)\r\n  {\r\n    return (mask & Tr2StateMachineState.#toBigIntMask(dirtyVariables)) !== 0n;\r\n  }\r\n}\r\n"],"names":["_Tr2StateMachineState","_identity","Tr2StateMachineState","CjsModel","e","_init_actions","_init_extra_actions","_init_transitions","_init_extra_transitions","_init_finalizer","_init_extra_finalizer","_init_name","_init_extra_name","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","persist","list","notify","objectRef","string","carbon","method","impl","implemented","adapted","actions","transitions","finalizer","name","OnModified","_options","controller","GetController","Link","OnListModified","event","_key","_key2","value","stateMachine","Unlink","UpdateVariableMask","transition","action","hasMask","mask","GetVariableMask","reason","UnlinkReason","UNLINKING","DELETING","Stop","Start","CanTransition","Update","dirtyVariables","next","TR2_DIRTY_ALL","destination","GetDestination","canTransition","CanActivate","RebaseSimTime","diff","GetStateMachine","GetName","#getNextState","#getController","#onActionListModified","BELIST_EVENTMASK","BELIST_INSERTED","BELIST_REMOVED","#onTransitionListModified","#asAction","#asTransition","#toBigIntMask","BigInt","#dirtyMaskMatches","constructor"],"mappings":"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"}

package/dist/controllers/Tr2StateMachineTransition.js

@@ -4,6 +4,11 @@ import { io, type, carbon, impl } from '@carbonenginejs/runtime-utils/schema';
 import { CjsControllerExpressionProgram } from './CjsControllerExpressionProgram.js';
 
 let _initProto, _initClass, _init_condition, _init_extra_condition, _init_name, _init_extra_name;
+
+/**
+ * One outgoing edge of a state machine state: evaluates a boolean condition
+ * expression and, when it passes, names the destination state to switch to.
+ */
 let _Tr2StateMachineTrans;
 new class extends _identity {
   static [class Tr2StateMachineTransition extends CjsModel {
@@ -114,6 +119,13 @@ new class extends _identity {
     GetState() {
       return this.GetSource();
     }
+
+    /**
+     * Gets the bitmask of controller variables this condition reads, so the owning
+     * state can skip evaluation when none of them changed; returns 0 (never skip)
+     * when the condition calls an impure function or references a variable that is
+     * missing or beyond the 64-bit mask.
+     */
     GetVariableMask() {
       const program = this.Compile();
       if (program.HasNonPureFunctions()) {
@@ -192,6 +204,12 @@ new class extends _identity {
       this.Compile();
       return this.#functionNames.slice();
     }
+
+    /**
+     * Builds the condition evaluation context, delegating to the controller's own
+     * GetExpressionContext when it has one and otherwise assembling controller,
+     * owner and state machine directly.
+     */
     #getExpressionContext(controller, owner, stateMachine) {
       const runtime = controller;
       if (runtime?.GetExpressionContext) {
@@ -203,6 +221,12 @@ new class extends _identity {
         stateMachine: stateMachine
       };
     }
+
+    /**
+     * Looks up the destination state by this transition's `name` on the source
+     * state's machine; the authored name is the destination state name, not a
+     * label for the edge.
+     */
     #resolveDestination() {
       const stateMachine = this.#source?.GetStateMachine?.() ?? null;
       if (!stateMachine || !this.name) {
@@ -210,6 +234,11 @@ new class extends _identity {
       }
       return stateMachine.GetStateByName?.(this.name) ?? null;
     }
+
+    /**
+     * Checks whether any variable this condition reads is dirty; an empty variable
+     * mask means the condition must always be evaluated.
+     */
   }];
   #dirtyMaskMatches(variableMask, dirtyVariables) {
     if (variableMask === 0n) {

package/dist/controllers/Tr2StateMachineTransition.js.map

@@ -1 +1 @@
-{"version":3,"file":"Tr2StateMachineTransition.js","sources":["../../../src/controllers/Tr2StateMachineTransition.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\Controllers\\Tr2StateMachineTransition.h\r\n// Source: E:\\carbonengine\\trinity\\trinity\\Controllers\\Tr2StateMachineTransition.cpp\r\nimport { CjsModel } from \"@carbonenginejs/runtime-utils/model\";\r\nimport { carbon, impl, io, type } from \"@carbonenginejs/runtime-utils/schema\";\r\nimport { CjsControllerExpressionProgram } from \"./CjsControllerExpressionProgram.js\";\r\n\r\n\r\n@type.define({\r\n  className: \"Tr2StateMachineTransition\",\r\n  family: \"controllers\"\r\n})\r\nexport class Tr2StateMachineTransition extends CjsModel\r\n{\r\n  @io.notify\r\n  @io.persist\r\n  @type.string\r\n  condition = \"\";\r\n\r\n  @io.notify\r\n  @io.persist\r\n  @type.string\r\n  name = \"\";\r\n\r\n  #source = null;\r\n\r\n  #destination = null;\r\n\r\n  #program = null;\r\n\r\n  #programSource = null;\r\n\r\n  #variableNames = [];\r\n\r\n  #functionNames = [];\r\n\r\n  #isConditionValid = false;\r\n\r\n  /**\r\n   * Links this transition to its source state.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  Link(state)\r\n  {\r\n    this.Unlink();\r\n    this.#source = state;\r\n    this.#destination = this.#resolveDestination();\r\n  }\r\n\r\n  /**\r\n   * Unlinks this transition from its source state.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  Unlink()\r\n  {\r\n    this.#source = null;\r\n    this.#destination = null;\r\n    this.#program = null;\r\n    this.#programSource = null;\r\n    this.#variableNames = [];\r\n    this.#functionNames = [];\r\n  }\r\n\r\n  /**\r\n   * Refreshes cached destination/expression state after modification.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  OnModified(_options = {})\r\n  {\r\n    this.#destination = this.#resolveDestination();\r\n    this.#program = null;\r\n    this.#programSource = null;\r\n    this.#variableNames = [];\r\n    this.#functionNames = [];\r\n    this.#source?.UpdateVariableMask?.();\r\n    return true;\r\n  }\r\n\r\n  /**\r\n   * Compiles and caches the transition condition.\r\n   */\r\n  Compile()\r\n  {\r\n    if (!this.#program || this.#programSource !== this.condition)\r\n    {\r\n      this.#program = CjsControllerExpressionProgram.Compile(this.condition, {\r\n        emptyValue: 1\r\n      });\r\n      this.#programSource = this.condition;\r\n      this.#variableNames = this.#program.GetVariableNames();\r\n      this.#functionNames = this.#program.GetFunctionNames();\r\n      this.#isConditionValid = this.#program.IsValid();\r\n    }\r\n    return this.#program;\r\n  }\r\n\r\n  /**\r\n   * Carbon-compatible alias for transition activation.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  CanActivate(variableDirtyMask = 0)\r\n  {\r\n    const stateMachine = this.#source?.GetStateMachine?.() ?? null;\r\n    const controller = stateMachine?.GetController?.() ?? null;\r\n    const owner = controller?.GetOwner?.() ?? null;\r\n    const program = this.Compile();\r\n    if (!program.IsValid())\r\n    {\r\n      return false;\r\n    }\r\n    if (!Tr2StateMachineTransition.#dirtyMaskMatches(this.GetVariableMask(), variableDirtyMask))\r\n    {\r\n      return false;\r\n    }\r\n    const context = this.#getExpressionContext(controller, owner, stateMachine);\r\n    return program.EvaluateBoolean(context);\r\n  }\r\n\r\n  /**\r\n   * Gets this transition's destination state by name.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  GetDestination()\r\n  {\r\n    return this.#destination ?? this.#resolveDestination();\r\n  }\r\n\r\n  /**\r\n   * Gets the source state.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  GetSource()\r\n  {\r\n    return this.#source;\r\n  }\r\n\r\n  /**\r\n   * Gets the source state.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  GetState()\r\n  {\r\n    return this.GetSource();\r\n  }\r\n  @carbon.method\r\n  @impl.adapted\r\n  GetVariableMask()\r\n  {\r\n    const program = this.Compile();\r\n    if (program.HasNonPureFunctions())\r\n    {\r\n      return 0n;\r\n    }\r\n    const stateMachine = this.#source?.GetStateMachine?.() ?? null;\r\n    const controller = stateMachine?.GetController?.() ?? null;\r\n    const variableView = controller?.GetVariableView?.();\r\n    if (!Array.isArray(variableView))\r\n    {\r\n      return 0n;\r\n    }\r\n    let mask = 0n;\r\n    for (const name of this.#variableNames)\r\n    {\r\n      const index = variableView.find(variable => variable && typeof variable === \"object\" && \"name\" in variable && String(variable.name) === name)?.index;\r\n      if (typeof index !== \"number\" || index < 0 || index >= 64)\r\n      {\r\n        return 0n;\r\n      }\r\n      mask |= 1n << BigInt(index);\r\n    }\r\n    return mask;\r\n  }\r\n\r\n  /**\r\n   * Checks whether the condition is valid.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  IsConditionValid()\r\n  {\r\n    return this.Compile().IsValid();\r\n  }\r\n\r\n  /**\r\n   * Checks whether the condition expression is valid.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  IsExpressionValid()\r\n  {\r\n    return this.IsConditionValid();\r\n  }\r\n\r\n  /**\r\n   * Evaluates an arbitrary expression against this transition's current context.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  EvaluateExpression(expression)\r\n  {\r\n    const stateMachine = this.#source?.GetStateMachine?.() ?? null;\r\n    const controller = stateMachine?.GetController?.() ?? null;\r\n    const owner = controller?.GetOwner?.() ?? null;\r\n    const program = CjsControllerExpressionProgram.Compile(expression, {\r\n      emptyValue: 0\r\n    });\r\n    if (!program.IsValid())\r\n    {\r\n      return 0;\r\n    }\r\n    return Number(program.Evaluate(this.#getExpressionContext(controller, owner, stateMachine)));\r\n  }\r\n\r\n  /**\r\n   * Gets expression term metadata known by the linked controller.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  GetExpressionTermInfo()\r\n  {\r\n    const result = [];\r\n    CjsControllerExpressionProgram.addControllerTermInfo(result);\r\n    const controller = this.#source?.GetStateMachine?.()?.GetController?.();\r\n    controller?.GetExpressionTermInfo?.(result);\r\n    return result;\r\n  }\r\n\r\n  /**\r\n   * Gets variable names referenced by the compiled condition.\r\n   */\r\n  GetVariableNames()\r\n  {\r\n    this.Compile();\r\n    return this.#variableNames.slice();\r\n  }\r\n\r\n  /**\r\n   * Gets function names referenced by the compiled condition.\r\n   */\r\n  GetFunctionNames()\r\n  {\r\n    this.Compile();\r\n    return this.#functionNames.slice();\r\n  }\r\n  #getExpressionContext(controller, owner, stateMachine)\r\n  {\r\n    const runtime = controller;\r\n    if (runtime?.GetExpressionContext)\r\n    {\r\n      return runtime.GetExpressionContext(owner, stateMachine);\r\n    }\r\n    return {\r\n      controller: runtime ?? undefined,\r\n      owner: owner ?? undefined,\r\n      stateMachine: stateMachine\r\n    };\r\n  }\r\n  #resolveDestination()\r\n  {\r\n    const stateMachine = this.#source?.GetStateMachine?.() ?? null;\r\n    if (!stateMachine || !this.name)\r\n    {\r\n      return null;\r\n    }\r\n    return stateMachine.GetStateByName?.(this.name) ?? null;\r\n  }\r\n\r\n  static #dirtyMaskMatches(variableMask, dirtyVariables)\r\n  {\r\n    if (variableMask === 0n)\r\n    {\r\n      return true;\r\n    }\r\n    const dirtyMask = typeof dirtyVariables === \"bigint\" ? dirtyVariables : BigInt(dirtyVariables);\r\n    return (variableMask & dirtyMask) !== 0n;\r\n  }\r\n}\r\n"],"names":["_Tr2StateMachineTrans","_identity","Tr2StateMachineTransition","CjsModel","e","_init_condition","_init_extra_condition","_init_name","_init_extra_name","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","notify","persist","string","carbon","method","impl","adapted","condition","name","Link","state","Unlink","OnModified","_options","UpdateVariableMask","Compile","CjsControllerExpressionProgram","emptyValue","GetVariableNames","GetFunctionNames","IsValid","CanActivate","variableDirtyMask","stateMachine","GetStateMachine","controller","GetController","owner","GetOwner","program","GetVariableMask","context","EvaluateBoolean","GetDestination","GetSource","GetState","HasNonPureFunctions","variableView","GetVariableView","Array","isArray","mask","index","find","variable","String","BigInt","IsConditionValid","IsExpressionValid","EvaluateExpression","expression","Number","Evaluate","GetExpressionTermInfo","result","addControllerTermInfo","slice","#getExpressionContext","runtime","GetExpressionContext","undefined","#resolveDestination","GetStateByName","#dirtyMaskMatches","variableMask","dirtyVariables","dirtyMask","constructor"],"mappings":"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"}
+{"version":3,"file":"Tr2StateMachineTransition.js","sources":["../../../src/controllers/Tr2StateMachineTransition.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\Controllers\\Tr2StateMachineTransition.h\r\n// Source: E:\\carbonengine\\trinity\\trinity\\Controllers\\Tr2StateMachineTransition.cpp\r\nimport { CjsModel } from \"@carbonenginejs/runtime-utils/model\";\r\nimport { carbon, impl, io, type } from \"@carbonenginejs/runtime-utils/schema\";\r\nimport { CjsControllerExpressionProgram } from \"./CjsControllerExpressionProgram.js\";\r\n\r\n\r\n/**\r\n * One outgoing edge of a state machine state: evaluates a boolean condition\r\n * expression and, when it passes, names the destination state to switch to.\r\n */\r\n@type.define({\r\n  className: \"Tr2StateMachineTransition\",\r\n  family: \"controllers\"\r\n})\r\nexport class Tr2StateMachineTransition extends CjsModel\r\n{\r\n  @io.notify\r\n  @io.persist\r\n  @type.string\r\n  condition = \"\";\r\n\r\n  @io.notify\r\n  @io.persist\r\n  @type.string\r\n  name = \"\";\r\n\r\n  #source = null;\r\n\r\n  #destination = null;\r\n\r\n  #program = null;\r\n\r\n  #programSource = null;\r\n\r\n  #variableNames = [];\r\n\r\n  #functionNames = [];\r\n\r\n  #isConditionValid = false;\r\n\r\n  /**\r\n   * Links this transition to its source state.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  Link(state)\r\n  {\r\n    this.Unlink();\r\n    this.#source = state;\r\n    this.#destination = this.#resolveDestination();\r\n  }\r\n\r\n  /**\r\n   * Unlinks this transition from its source state.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  Unlink()\r\n  {\r\n    this.#source = null;\r\n    this.#destination = null;\r\n    this.#program = null;\r\n    this.#programSource = null;\r\n    this.#variableNames = [];\r\n    this.#functionNames = [];\r\n  }\r\n\r\n  /**\r\n   * Refreshes cached destination/expression state after modification.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  OnModified(_options = {})\r\n  {\r\n    this.#destination = this.#resolveDestination();\r\n    this.#program = null;\r\n    this.#programSource = null;\r\n    this.#variableNames = [];\r\n    this.#functionNames = [];\r\n    this.#source?.UpdateVariableMask?.();\r\n    return true;\r\n  }\r\n\r\n  /**\r\n   * Compiles and caches the transition condition.\r\n   */\r\n  Compile()\r\n  {\r\n    if (!this.#program || this.#programSource !== this.condition)\r\n    {\r\n      this.#program = CjsControllerExpressionProgram.Compile(this.condition, {\r\n        emptyValue: 1\r\n      });\r\n      this.#programSource = this.condition;\r\n      this.#variableNames = this.#program.GetVariableNames();\r\n      this.#functionNames = this.#program.GetFunctionNames();\r\n      this.#isConditionValid = this.#program.IsValid();\r\n    }\r\n    return this.#program;\r\n  }\r\n\r\n  /**\r\n   * Carbon-compatible alias for transition activation.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  CanActivate(variableDirtyMask = 0)\r\n  {\r\n    const stateMachine = this.#source?.GetStateMachine?.() ?? null;\r\n    const controller = stateMachine?.GetController?.() ?? null;\r\n    const owner = controller?.GetOwner?.() ?? null;\r\n    const program = this.Compile();\r\n    if (!program.IsValid())\r\n    {\r\n      return false;\r\n    }\r\n    if (!Tr2StateMachineTransition.#dirtyMaskMatches(this.GetVariableMask(), variableDirtyMask))\r\n    {\r\n      return false;\r\n    }\r\n    const context = this.#getExpressionContext(controller, owner, stateMachine);\r\n    return program.EvaluateBoolean(context);\r\n  }\r\n\r\n  /**\r\n   * Gets this transition's destination state by name.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  GetDestination()\r\n  {\r\n    return this.#destination ?? this.#resolveDestination();\r\n  }\r\n\r\n  /**\r\n   * Gets the source state.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  GetSource()\r\n  {\r\n    return this.#source;\r\n  }\r\n\r\n  /**\r\n   * Gets the source state.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  GetState()\r\n  {\r\n    return this.GetSource();\r\n  }\r\n\r\n  /**\r\n   * Gets the bitmask of controller variables this condition reads, so the owning\r\n   * state can skip evaluation when none of them changed; returns 0 (never skip)\r\n   * when the condition calls an impure function or references a variable that is\r\n   * missing or beyond the 64-bit mask.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  GetVariableMask()\r\n  {\r\n    const program = this.Compile();\r\n    if (program.HasNonPureFunctions())\r\n    {\r\n      return 0n;\r\n    }\r\n    const stateMachine = this.#source?.GetStateMachine?.() ?? null;\r\n    const controller = stateMachine?.GetController?.() ?? null;\r\n    const variableView = controller?.GetVariableView?.();\r\n    if (!Array.isArray(variableView))\r\n    {\r\n      return 0n;\r\n    }\r\n    let mask = 0n;\r\n    for (const name of this.#variableNames)\r\n    {\r\n      const index = variableView.find(variable => variable && typeof variable === \"object\" && \"name\" in variable && String(variable.name) === name)?.index;\r\n      if (typeof index !== \"number\" || index < 0 || index >= 64)\r\n      {\r\n        return 0n;\r\n      }\r\n      mask |= 1n << BigInt(index);\r\n    }\r\n    return mask;\r\n  }\r\n\r\n  /**\r\n   * Checks whether the condition is valid.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  IsConditionValid()\r\n  {\r\n    return this.Compile().IsValid();\r\n  }\r\n\r\n  /**\r\n   * Checks whether the condition expression is valid.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  IsExpressionValid()\r\n  {\r\n    return this.IsConditionValid();\r\n  }\r\n\r\n  /**\r\n   * Evaluates an arbitrary expression against this transition's current context.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  EvaluateExpression(expression)\r\n  {\r\n    const stateMachine = this.#source?.GetStateMachine?.() ?? null;\r\n    const controller = stateMachine?.GetController?.() ?? null;\r\n    const owner = controller?.GetOwner?.() ?? null;\r\n    const program = CjsControllerExpressionProgram.Compile(expression, {\r\n      emptyValue: 0\r\n    });\r\n    if (!program.IsValid())\r\n    {\r\n      return 0;\r\n    }\r\n    return Number(program.Evaluate(this.#getExpressionContext(controller, owner, stateMachine)));\r\n  }\r\n\r\n  /**\r\n   * Gets expression term metadata known by the linked controller.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  GetExpressionTermInfo()\r\n  {\r\n    const result = [];\r\n    CjsControllerExpressionProgram.addControllerTermInfo(result);\r\n    const controller = this.#source?.GetStateMachine?.()?.GetController?.();\r\n    controller?.GetExpressionTermInfo?.(result);\r\n    return result;\r\n  }\r\n\r\n  /**\r\n   * Gets variable names referenced by the compiled condition.\r\n   */\r\n  GetVariableNames()\r\n  {\r\n    this.Compile();\r\n    return this.#variableNames.slice();\r\n  }\r\n\r\n  /**\r\n   * Gets function names referenced by the compiled condition.\r\n   */\r\n  GetFunctionNames()\r\n  {\r\n    this.Compile();\r\n    return this.#functionNames.slice();\r\n  }\r\n\r\n  /**\r\n   * Builds the condition evaluation context, delegating to the controller's own\r\n   * GetExpressionContext when it has one and otherwise assembling controller,\r\n   * owner and state machine directly.\r\n   */\r\n  #getExpressionContext(controller, owner, stateMachine)\r\n  {\r\n    const runtime = controller;\r\n    if (runtime?.GetExpressionContext)\r\n    {\r\n      return runtime.GetExpressionContext(owner, stateMachine);\r\n    }\r\n    return {\r\n      controller: runtime ?? undefined,\r\n      owner: owner ?? undefined,\r\n      stateMachine: stateMachine\r\n    };\r\n  }\r\n\r\n  /**\r\n   * Looks up the destination state by this transition's `name` on the source\r\n   * state's machine; the authored name is the destination state name, not a\r\n   * label for the edge.\r\n   */\r\n  #resolveDestination()\r\n  {\r\n    const stateMachine = this.#source?.GetStateMachine?.() ?? null;\r\n    if (!stateMachine || !this.name)\r\n    {\r\n      return null;\r\n    }\r\n    return stateMachine.GetStateByName?.(this.name) ?? null;\r\n  }\r\n\r\n  /**\r\n   * Checks whether any variable this condition reads is dirty; an empty variable\r\n   * mask means the condition must always be evaluated.\r\n   */\r\n  static #dirtyMaskMatches(variableMask, dirtyVariables)\r\n  {\r\n    if (variableMask === 0n)\r\n    {\r\n      return true;\r\n    }\r\n    const dirtyMask = typeof dirtyVariables === \"bigint\" ? dirtyVariables : BigInt(dirtyVariables);\r\n    return (variableMask & dirtyMask) !== 0n;\r\n  }\r\n}\r\n"],"names":["_Tr2StateMachineTrans","_identity","Tr2StateMachineTransition","CjsModel","e","_init_condition","_init_extra_condition","_init_name","_init_extra_name","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","notify","persist","string","carbon","method","impl","adapted","condition","name","Link","state","Unlink","OnModified","_options","UpdateVariableMask","Compile","CjsControllerExpressionProgram","emptyValue","GetVariableNames","GetFunctionNames","IsValid","CanActivate","variableDirtyMask","stateMachine","GetStateMachine","controller","GetController","owner","GetOwner","program","GetVariableMask","context","EvaluateBoolean","GetDestination","GetSource","GetState","HasNonPureFunctions","variableView","GetVariableView","Array","isArray","mask","index","find","variable","String","BigInt","IsConditionValid","IsExpressionValid","EvaluateExpression","expression","Number","Evaluate","GetExpressionTermInfo","result","addControllerTermInfo","slice","#getExpressionContext","runtime","GetExpressionContext","undefined","#resolveDestination","GetStateByName","#dirtyMaskMatches","variableMask","dirtyVariables","dirtyMask","constructor"],"mappings":"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"}

package/dist/controllers/Tr2SyncToAnimation.js

@@ -4,6 +4,11 @@ import { io, type, carbon, impl } from '@carbonenginejs/runtime-utils/schema';
 import { ITr2ControllerAction } from './ITr2ControllerAction.js';
 
 let _initProto, _initClass, _init_mask, _init_extra_mask;
+
+/**
+ * State finalizer that holds a state machine in its current state until the
+ * animation layer named by `mask` has finished playing.
+ */
 let _Tr2SyncToAnimation;
 class Tr2SyncToAnimation extends CjsModel {
   static {

package/dist/controllers/Tr2SyncToAnimation.js.map

@@ -1 +1 @@
-{"version":3,"file":"Tr2SyncToAnimation.js","sources":["../../../src/controllers/Tr2SyncToAnimation.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\Controllers\\Finalizers\\Tr2SyncToAnimation.h\n// Source: E:\\carbonengine\\trinity\\trinity\\Controllers\\Finalizers\\Tr2SyncToAnimation.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: \"Tr2SyncToAnimation\",\n  family: \"controllers\"\n})\nexport class Tr2SyncToAnimation extends CjsModel\n{\n  @io.persist\n  @type.string\n  mask = \"\";\n\n  /**\n   * Carbon allows transition once the matching animation layer has finished.\n   */\n  @carbon.method\n  @impl.adapted\n  CanTransition(controller)\n  {\n    const owner = controller.GetOwner?.();\n    const animationController = ITr2ControllerAction.getAnimationController(owner);\n    if (!animationController)\n    {\n      return true;\n    }\n    const layer = ITr2ControllerAction.callTarget(animationController, \"GetAnimationLayer\", this.mask || null);\n    if (!layer)\n    {\n      return true;\n    }\n    const remaining = Number(ITr2ControllerAction.callTarget(layer, \"GetAnimationRemainingTime\") ?? 0);\n    return !Number.isFinite(remaining) || remaining <= 0;\n  }\n}\n"],"names":["_Tr2SyncToAnimation","Tr2SyncToAnimation","CjsModel","e","_init_mask","_init_extra_mask","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","persist","string","carbon","method","impl","adapted","constructor","args","mask","CanTransition","controller","owner","GetOwner","animationController","ITr2ControllerAction","getAnimationController","layer","callTarget","remaining","Number","isFinite"],"mappings":";;;;;;AAIiE,IAAAA;AAGjE,MAAAC,kBAAA,SAIwCC,QAAQ,CAChD;AAAA,EAAA;AAAA,IAAA,CAAA;AAAAC,MAAAA,CAAA,EAAA,CAAAC,UAAA,EAAAC,gBAAA,EAAAC,UAAA,CAAA;MAAAC,CAAA,EAAA,CAAAP,mBAAA,EAAAQ,UAAA;AAAA,KAAA,GAAAC,cAAA,CAAA,IAAA,EAAA,CALCC,IAAI,CAACC,MAAM,CAAC;AACXC,MAAAA,SAAS,EAAE,oBAAoB;AAC/BC,MAAAA,MAAM,EAAE;KACT,CAAC,CAAA,EAAA,CAAA,CAAA,CAGCC,EAAE,EAAFA,EAAE,CAACC,OAAO,EACVL,IAAI,EAAJA,IAAI,CAACM,MAAM,kBAMXC,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACC,OAAO,CAAA,EAAA,EAAA,EAAA,eAAA,CAAA,CAAA,EAAA,CAAA,EAAA,MAAA,EAVyBlB,QAAQ,CAAA;AAAA;AAAAmB,EAAAA,WAAAA,CAAA,GAAAC,IAAA,EAAA;AAAA,IAAA,KAAA,CAAA,GAAAA,IAAA,CAAA;IAAAjB,gBAAA,CAAA,IAAA,CAAA;AAAA,EAAA;AAI9CkB,EAAAA,IAAI,IAAAjB,UAAA,CAAA,IAAA,CAAA,EAAAF,UAAA,OAAG,EAAE,CAAA;;AAET;AACF;AACA;EAGEoB,aAAaA,CAACC,UAAU,EACxB;AACE,IAAA,MAAMC,KAAK,GAAGD,UAAU,CAACE,QAAQ,IAAI;AACrC,IAAA,MAAMC,mBAAmB,GAAGC,oBAAoB,CAACC,sBAAsB,CAACJ,KAAK,CAAC;IAC9E,IAAI,CAACE,mBAAmB,EACxB;AACE,MAAA,OAAO,IAAI;AACb,IAAA;AACA,IAAA,MAAMG,KAAK,GAAGF,oBAAoB,CAACG,UAAU,CAACJ,mBAAmB,EAAE,mBAAmB,EAAE,IAAI,CAACL,IAAI,IAAI,IAAI,CAAC;IAC1G,IAAI,CAACQ,KAAK,EACV;AACE,MAAA,OAAO,IAAI;AACb,IAAA;AACA,IAAA,MAAME,SAAS,GAAGC,MAAM,CAACL,oBAAoB,CAACG,UAAU,CAACD,KAAK,EAAE,2BAA2B,CAAC,IAAI,CAAC,CAAC;IAClG,OAAO,CAACG,MAAM,CAACC,QAAQ,CAACF,SAAS,CAAC,IAAIA,SAAS,IAAI,CAAC;AACtD,EAAA;AAAC,EAAA;IAAAzB,UAAA,EAAA;AAAA;AACH;;;;"}
+{"version":3,"file":"Tr2SyncToAnimation.js","sources":["../../../src/controllers/Tr2SyncToAnimation.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\Controllers\\Finalizers\\Tr2SyncToAnimation.h\n// Source: E:\\carbonengine\\trinity\\trinity\\Controllers\\Finalizers\\Tr2SyncToAnimation.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 * State finalizer that holds a state machine in its current state until the\n * animation layer named by `mask` has finished playing.\n */\n@type.define({\n  className: \"Tr2SyncToAnimation\",\n  family: \"controllers\"\n})\nexport class Tr2SyncToAnimation extends CjsModel\n{\n  @io.persist\n  @type.string\n  mask = \"\";\n\n  /**\n   * Carbon allows transition once the matching animation layer has finished.\n   */\n  @carbon.method\n  @impl.adapted\n  CanTransition(controller)\n  {\n    const owner = controller.GetOwner?.();\n    const animationController = ITr2ControllerAction.getAnimationController(owner);\n    if (!animationController)\n    {\n      return true;\n    }\n    const layer = ITr2ControllerAction.callTarget(animationController, \"GetAnimationLayer\", this.mask || null);\n    if (!layer)\n    {\n      return true;\n    }\n    const remaining = Number(ITr2ControllerAction.callTarget(layer, \"GetAnimationRemainingTime\") ?? 0);\n    return !Number.isFinite(remaining) || remaining <= 0;\n  }\n}\n"],"names":["_Tr2SyncToAnimation","Tr2SyncToAnimation","CjsModel","e","_init_mask","_init_extra_mask","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","persist","string","carbon","method","impl","adapted","constructor","args","mask","CanTransition","controller","owner","GetOwner","animationController","ITr2ControllerAction","getAnimationController","layer","callTarget","remaining","Number","isFinite"],"mappings":";;;;;;;AAOA;AACA;AACA;AACA;AAHA,IAAAA;AAIA,MAAAC,kBAAA,SAIwCC,QAAQ,CAChD;AAAA,EAAA;AAAA,IAAA,CAAA;AAAAC,MAAAA,CAAA,EAAA,CAAAC,UAAA,EAAAC,gBAAA,EAAAC,UAAA,CAAA;MAAAC,CAAA,EAAA,CAAAP,mBAAA,EAAAQ,UAAA;AAAA,KAAA,GAAAC,cAAA,CAAA,IAAA,EAAA,CALCC,IAAI,CAACC,MAAM,CAAC;AACXC,MAAAA,SAAS,EAAE,oBAAoB;AAC/BC,MAAAA,MAAM,EAAE;KACT,CAAC,CAAA,EAAA,CAAA,CAAA,CAGCC,EAAE,EAAFA,EAAE,CAACC,OAAO,EACVL,IAAI,EAAJA,IAAI,CAACM,MAAM,kBAMXC,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACC,OAAO,CAAA,EAAA,EAAA,EAAA,eAAA,CAAA,CAAA,EAAA,CAAA,EAAA,MAAA,EAVyBlB,QAAQ,CAAA;AAAA;AAAAmB,EAAAA,WAAAA,CAAA,GAAAC,IAAA,EAAA;AAAA,IAAA,KAAA,CAAA,GAAAA,IAAA,CAAA;IAAAjB,gBAAA,CAAA,IAAA,CAAA;AAAA,EAAA;AAI9CkB,EAAAA,IAAI,IAAAjB,UAAA,CAAA,IAAA,CAAA,EAAAF,UAAA,OAAG,EAAE,CAAA;;AAET;AACF;AACA;EAGEoB,aAAaA,CAACC,UAAU,EACxB;AACE,IAAA,MAAMC,KAAK,GAAGD,UAAU,CAACE,QAAQ,IAAI;AACrC,IAAA,MAAMC,mBAAmB,GAAGC,oBAAoB,CAACC,sBAAsB,CAACJ,KAAK,CAAC;IAC9E,IAAI,CAACE,mBAAmB,EACxB;AACE,MAAA,OAAO,IAAI;AACb,IAAA;AACA,IAAA,MAAMG,KAAK,GAAGF,oBAAoB,CAACG,UAAU,CAACJ,mBAAmB,EAAE,mBAAmB,EAAE,IAAI,CAACL,IAAI,IAAI,IAAI,CAAC;IAC1G,IAAI,CAACQ,KAAK,EACV;AACE,MAAA,OAAO,IAAI;AACb,IAAA;AACA,IAAA,MAAME,SAAS,GAAGC,MAAM,CAACL,oBAAoB,CAACG,UAAU,CAACD,KAAK,EAAE,2BAA2B,CAAC,IAAI,CAAC,CAAC;IAClG,OAAO,CAACG,MAAM,CAACC,QAAQ,CAACF,SAAS,CAAC,IAAIA,SAAS,IAAI,CAAC;AACtD,EAAA;AAAC,EAAA;IAAAzB,UAAA,EAAA;AAAA;AACH;;;;"}