@carbonenginejs/runtime 0.1.0-alpha.0 → 0.1.0-alpha.1

package/dist/trinity/controllers/Tr2ControllerReference.js

@@ -2,7 +2,8 @@ import { identity as _identity, applyDecs2311 as _applyDecs2311 } from '../../_v
 import { CjsModel } from '#model';
 import { io, type, carbon, impl } from '#schema';
 import { UnlinkReason } from './enums.js';
-import { withITr2Controller } from './ITr2Controller.js';
+import { withITr2Controller } from './ITr2Controller/ITr2Controller.js';
+import './ITr2Controller/ITr2ActionController.js';
 
 var _withITr2Controller;
 let _initProto, _initClass, _init_controller, _init_extra_controller, _init_path, _init_extra_path;

package/dist/trinity/controllers/Tr2ControllerReference.js.map

@@ -1 +1 @@
-{"version":3,"file":"Tr2ControllerReference.js","sources":["../../../../src/trinity/controllers/Tr2ControllerReference.js"],"sourcesContent":["// Source: trinity/trinity/Controllers/Tr2ControllerReference.h\r\n// Source: trinity/trinity/Controllers/Tr2ControllerReference.cpp\r\nimport { CjsModel } from \"#model\";\r\nimport { carbon, impl, io, type } from \"#schema\";\r\nimport { UnlinkReason } from \"./enums.js\";\nimport { withITr2Controller } from \"./ITr2Controller.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 withITr2Controller(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","_withITr2Controller","withITr2Controller","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/trinity/controllers/Tr2ControllerReference.js"],"sourcesContent":["// Source: trinity/trinity/Controllers/Tr2ControllerReference.h\r\n// Source: trinity/trinity/Controllers/Tr2ControllerReference.cpp\r\nimport { CjsModel } from \"#model\";\r\nimport { carbon, impl, io, type } from \"#schema\";\r\nimport { UnlinkReason } from \"./enums.js\";\nimport { withITr2Controller } from \"./ITr2Controller/index.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 withITr2Controller(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","_withITr2Controller","withITr2Controller","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/trinity/controllers/action/ITr2ControllerAction.js

@@ -1,5 +1,6 @@
 import { CjsSchema, impl } from '#schema';
-import { Brand, Adopt } from '../ITr2Controller.js';
+import { Brand, Adopt } from '../ITr2Controller/ITr2Controller.js';
+import '../ITr2Controller/ITr2ActionController.js';
 
 // Source: trinity/trinity/Controllers/Actions/ITr2ControllerAction.h
 //

package/dist/trinity/controllers/action/ITr2ControllerAction.js.map

@@ -1 +1 @@
-{"version":3,"file":"ITr2ControllerAction.js","sources":["../../../../../src/trinity/controllers/action/ITr2ControllerAction.js"],"sourcesContent":["// Source: trinity/trinity/Controllers/Actions/ITr2ControllerAction.h\r\n//\r\n// The contract a controller ACTION answers to - the other half of the pair\r\n// whose controller side is ITr2Controller.js. Carbon gives every lifecycle\r\n// verb here an EMPTY BODY: an action that does not care about Link, Unlink,\r\n// Start, Stop or RebaseSimTime inherits a harmless nothing, and only\r\n// CanTransition has an opinionated default (true). Before this contract was\r\n// ported, 10 of our 18 concrete actions lacked Stop, 10 lacked Unlink and 8\r\n// lacked Link, so every owner of an `actions` list hedged each call with\r\n// `action.Stop?.()` - emulating the empty body one call site at a time.\r\n//\r\n// The statics below predate the contract: they are shared JavaScript adapters\r\n// the concrete actions use to duck-type their OWNERS (which have no common\r\n// contract yet). They are unrelated to the instance surface.\r\n\r\nimport { CjsSchema, impl } from \"#schema\";\r\nimport { Adopt, Brand } from \"../ITr2Controller.js\";\r\n\r\n\r\nconst ITR2_CONTROLLER_ACTION = Symbol.for(\"carbonenginejs.contract.ITr2ControllerAction\");\r\n\r\nconst ACTION_NOOPS = [ \"Link\", \"Unlink\", \"Start\", \"Stop\", \"RebaseSimTime\" ];\r\nconst ACTION_DEFAULTS = [ \"CanTransition\" ];\r\n\r\n\r\n/** Contract for an action a controller drives between Start and Stop. */\r\nexport class ITr2ControllerAction\r\n{\r\n  static [Symbol.hasInstance](value)\r\n  {\r\n    return value !== null && value !== undefined && value[ITR2_CONTROLLER_ACTION] === true;\r\n  }\r\n\r\n  /**\r\n   * Attaches this action to the controller that will drive it.\r\n   *\r\n   * @param {object} _controller The driving action controller.\r\n   */\r\n  Link(_controller)\r\n  {\r\n  }\r\n\r\n  /** Detaches this action, dropping every reference to the controller. */\r\n  Unlink()\r\n  {\r\n  }\r\n\r\n  /**\r\n   * Begins the action.\r\n   *\r\n   * @param {object} _controller The driving action controller.\r\n   */\r\n  Start(_controller)\r\n  {\r\n  }\r\n\r\n  /**\r\n   * Stops the action.\r\n   *\r\n   * @param {object} _controller The driving action controller.\r\n   */\r\n  Stop(_controller)\r\n  {\r\n  }\r\n\r\n  /**\r\n   * Shifts any absolute sim-clock times this action holds.\r\n   *\r\n   * @param {number} _diff Seconds added to the sim clock.\r\n   */\r\n  RebaseSimTime(_diff)\r\n  {\r\n  }\r\n\r\n  /**\r\n   * Whether the owning state may transition away while this action runs.\r\n   *\r\n   * THE ONE METHOD CARBON GIVES A CONCRETE DEFAULT: an action does not hold\r\n   * its state hostage unless it says so.\r\n   *\r\n   * @returns {boolean} True unless the action needs to finish first.\r\n   */\r\n  CanTransition()\r\n  {\r\n    return true;\r\n  }\r\n\r\n  /**\r\n   * Resolves the object an action operates on, preferring an explicitly supplied\r\n   * owner over the controller's own owner.\r\n   */\r\n  static getOwner(controller, owner = null)\r\n  {\r\n    return owner ?? controller?.GetOwner() ?? null;\r\n  }\r\n\r\n  /**\r\n   * Throws a TypeError naming the calling method when an action is invoked\r\n   * without a controller.\r\n   */\r\n  static requireController(controller, methodName)\r\n  {\r\n    if (!controller)\r\n    {\r\n      throw new TypeError(`${methodName} expects a Tr2Controller as a parameter.`);\r\n    }\r\n    return controller;\r\n  }\r\n\r\n  /**\r\n   * Gets the controller's current frame time in seconds, preferring the JS-only\r\n   * CjsGetCurrentFrameTime hook and falling back to GetTime, then to the\r\n   * supplied fallback.\r\n   */\r\n  static getTime(controller, fallback = 0)\r\n  {\r\n    if (controller?.CjsGetCurrentFrameTime)\r\n    {\r\n      return this.toNumber(controller.CjsGetCurrentFrameTime(), fallback);\r\n    }\r\n    return this.toNumber(controller?.GetTime?.(), fallback);\r\n  }\r\n\r\n  /**\r\n   * Calls a method on a duck-typed target if it exists, returning undefined\r\n   * rather than throwing when the target does not implement it.\r\n   */\r\n  static callTarget(target, methodName, ...args)\r\n  {\r\n    return this.hasFunction(target, methodName) ? target[methodName](...args) : undefined;\r\n  }\r\n\r\n  /**\r\n   * Converts a value to a finite number, substituting the fallback for NaN and\r\n   * infinities.\r\n   */\r\n  static toNumber(value, fallback = 0)\r\n  {\r\n    const number = Number(value);\r\n    return Number.isFinite(number) ? number : fallback;\r\n  }\r\n\r\n  /**\r\n   * Checks whether a value is an object carrying the named key, including\r\n   * inherited keys.\r\n   */\r\n  static hasProperty(value, key)\r\n  {\r\n    return !!value && typeof value === \"object\" && key in value;\r\n  }\r\n\r\n  /** Checks whether a value is an object whose named key is callable. */\r\n  static hasFunction(value, key)\r\n  {\r\n    return this.hasProperty(value, key) && typeof value[key] === \"function\";\r\n  }\r\n\r\n  /**\r\n   * Narrows a value to an object reference, returning null for primitives and\r\n   * nullish values.\r\n   */\r\n  static asObject(value)\r\n  {\r\n    return value && typeof value === \"object\" ? value : null;\r\n  }\r\n\r\n  /**\r\n   * Reads a property from a duck-typed target, returning undefined when the\r\n   * target is not an object or lacks the key.\r\n   */\r\n  static getProperty(target, propertyName)\r\n  {\r\n    return this.hasProperty(target, propertyName) ? target[propertyName] : undefined;\r\n  }\r\n\r\n  /**\r\n   * Resolves the object held by an owner's named parameter, accepting\r\n   * GetParameterObject, parameterObject or object as the payload accessor.\r\n   */\r\n  static getParameterOwner(owner, name)\r\n  {\r\n    const parameter = this.callTarget(owner, \"GetParameterByName\", name);\r\n    if (!parameter)\r\n    {\r\n      return null;\r\n    }\r\n    return this.asObject(this.callTarget(parameter, \"GetParameterObject\") ?? this.getProperty(parameter, \"parameterObject\") ?? this.getProperty(parameter, \"object\"));\r\n  }\r\n\r\n  /**\r\n   * Finds a named sound emitter on the owner, or null when the owner exposes no\r\n   * emitter lookup.\r\n   */\r\n  static findSoundEmitter(owner, name)\r\n  {\r\n    return this.callTarget(owner, \"FindSoundEmitter\", name) ?? null;\r\n  }\r\n\r\n  /**\r\n   * Resolves an owner's animation controller from either the\r\n   * GetAnimationController method or the animationController property.\r\n   */\r\n  static getAnimationController(owner)\r\n  {\r\n    return this.callTarget(owner, \"GetAnimationController\") ?? this.getProperty(owner, \"animationController\") ?? null;\r\n  }\r\n}\r\n\r\n\r\nBrand(ITr2ControllerAction, ITR2_CONTROLLER_ACTION, ACTION_NOOPS, []);\r\nfor (const name of ACTION_DEFAULTS) CjsSchema.decorateMethod(ITr2ControllerAction, name, impl.implemented);\r\nCjsSchema.define(ITr2ControllerAction, { className: \"ITr2ControllerAction\" });\r\n\r\n\r\n/**\r\n * Adds the ITr2ControllerAction contract without replacing an existing model\r\n * base.\r\n *\r\n * Every concrete action extends CjsModel, so the contract arrives as a mixin:\r\n * the action overrides the verbs it cares about and inherits Carbon's empty\r\n * body for the rest, and the owner of an `actions` list no longer has to ask.\r\n *\r\n * @param {Function} Base The class to extend.\r\n * @returns {Function} A subclass carrying the contract.\r\n */\r\nexport function withITr2ControllerAction(Base)\r\n{\r\n  const Action = Adopt(Base, ITr2ControllerAction, [ ...ACTION_NOOPS, ...ACTION_DEFAULTS ]);\r\n\r\n  Brand(Action, ITR2_CONTROLLER_ACTION, ACTION_NOOPS, []);\r\n  for (const name of ACTION_DEFAULTS) CjsSchema.decorateMethod(Action, name, impl.implemented);\r\n\r\n  return Action;\r\n}\r\n"],"names":["ITR2_CONTROLLER_ACTION","Symbol","for","ACTION_NOOPS","ACTION_DEFAULTS","ITr2ControllerAction","hasInstance","value","undefined","Link","_controller","Unlink","Start","Stop","RebaseSimTime","_diff","CanTransition","getOwner","controller","owner","GetOwner","requireController","methodName","TypeError","getTime","fallback","CjsGetCurrentFrameTime","toNumber","GetTime","callTarget","target","args","hasFunction","number","Number","isFinite","hasProperty","key","asObject","getProperty","propertyName","getParameterOwner","name","parameter","findSoundEmitter","getAnimationController","Brand","CjsSchema","decorateMethod","impl","implemented","define","className","withITr2ControllerAction","Base","Action","Adopt"],"mappings":"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"}
+{"version":3,"file":"ITr2ControllerAction.js","sources":["../../../../../src/trinity/controllers/action/ITr2ControllerAction.js"],"sourcesContent":["// Source: trinity/trinity/Controllers/Actions/ITr2ControllerAction.h\r\n//\r\n// The contract a controller ACTION answers to - the other half of the pair\r\n// whose controller side is ITr2Controller.js. Carbon gives every lifecycle\r\n// verb here an EMPTY BODY: an action that does not care about Link, Unlink,\r\n// Start, Stop or RebaseSimTime inherits a harmless nothing, and only\r\n// CanTransition has an opinionated default (true). Before this contract was\r\n// ported, 10 of our 18 concrete actions lacked Stop, 10 lacked Unlink and 8\r\n// lacked Link, so every owner of an `actions` list hedged each call with\r\n// `action.Stop?.()` - emulating the empty body one call site at a time.\r\n//\r\n// The statics below predate the contract: they are shared JavaScript adapters\r\n// the concrete actions use to duck-type their OWNERS (which have no common\r\n// contract yet). They are unrelated to the instance surface.\r\n\r\nimport { CjsSchema, impl } from \"#schema\";\r\nimport { Adopt, Brand } from \"../ITr2Controller/index.js\";\r\n\r\n\r\nconst ITR2_CONTROLLER_ACTION = Symbol.for(\"carbonenginejs.contract.ITr2ControllerAction\");\r\n\r\nconst ACTION_NOOPS = [ \"Link\", \"Unlink\", \"Start\", \"Stop\", \"RebaseSimTime\" ];\r\nconst ACTION_DEFAULTS = [ \"CanTransition\" ];\r\n\r\n\r\n/** Contract for an action a controller drives between Start and Stop. */\r\nexport class ITr2ControllerAction\r\n{\r\n  static [Symbol.hasInstance](value)\r\n  {\r\n    return value !== null && value !== undefined && value[ITR2_CONTROLLER_ACTION] === true;\r\n  }\r\n\r\n  /**\r\n   * Attaches this action to the controller that will drive it.\r\n   *\r\n   * @param {object} _controller The driving action controller.\r\n   */\r\n  Link(_controller)\r\n  {\r\n  }\r\n\r\n  /** Detaches this action, dropping every reference to the controller. */\r\n  Unlink()\r\n  {\r\n  }\r\n\r\n  /**\r\n   * Begins the action.\r\n   *\r\n   * @param {object} _controller The driving action controller.\r\n   */\r\n  Start(_controller)\r\n  {\r\n  }\r\n\r\n  /**\r\n   * Stops the action.\r\n   *\r\n   * @param {object} _controller The driving action controller.\r\n   */\r\n  Stop(_controller)\r\n  {\r\n  }\r\n\r\n  /**\r\n   * Shifts any absolute sim-clock times this action holds.\r\n   *\r\n   * @param {number} _diff Seconds added to the sim clock.\r\n   */\r\n  RebaseSimTime(_diff)\r\n  {\r\n  }\r\n\r\n  /**\r\n   * Whether the owning state may transition away while this action runs.\r\n   *\r\n   * THE ONE METHOD CARBON GIVES A CONCRETE DEFAULT: an action does not hold\r\n   * its state hostage unless it says so.\r\n   *\r\n   * @returns {boolean} True unless the action needs to finish first.\r\n   */\r\n  CanTransition()\r\n  {\r\n    return true;\r\n  }\r\n\r\n  /**\r\n   * Resolves the object an action operates on, preferring an explicitly supplied\r\n   * owner over the controller's own owner.\r\n   */\r\n  static getOwner(controller, owner = null)\r\n  {\r\n    return owner ?? controller?.GetOwner() ?? null;\r\n  }\r\n\r\n  /**\r\n   * Throws a TypeError naming the calling method when an action is invoked\r\n   * without a controller.\r\n   */\r\n  static requireController(controller, methodName)\r\n  {\r\n    if (!controller)\r\n    {\r\n      throw new TypeError(`${methodName} expects a Tr2Controller as a parameter.`);\r\n    }\r\n    return controller;\r\n  }\r\n\r\n  /**\r\n   * Gets the controller's current frame time in seconds, preferring the JS-only\r\n   * CjsGetCurrentFrameTime hook and falling back to GetTime, then to the\r\n   * supplied fallback.\r\n   */\r\n  static getTime(controller, fallback = 0)\r\n  {\r\n    if (controller?.CjsGetCurrentFrameTime)\r\n    {\r\n      return this.toNumber(controller.CjsGetCurrentFrameTime(), fallback);\r\n    }\r\n    return this.toNumber(controller?.GetTime?.(), fallback);\r\n  }\r\n\r\n  /**\r\n   * Calls a method on a duck-typed target if it exists, returning undefined\r\n   * rather than throwing when the target does not implement it.\r\n   */\r\n  static callTarget(target, methodName, ...args)\r\n  {\r\n    return this.hasFunction(target, methodName) ? target[methodName](...args) : undefined;\r\n  }\r\n\r\n  /**\r\n   * Converts a value to a finite number, substituting the fallback for NaN and\r\n   * infinities.\r\n   */\r\n  static toNumber(value, fallback = 0)\r\n  {\r\n    const number = Number(value);\r\n    return Number.isFinite(number) ? number : fallback;\r\n  }\r\n\r\n  /**\r\n   * Checks whether a value is an object carrying the named key, including\r\n   * inherited keys.\r\n   */\r\n  static hasProperty(value, key)\r\n  {\r\n    return !!value && typeof value === \"object\" && key in value;\r\n  }\r\n\r\n  /** Checks whether a value is an object whose named key is callable. */\r\n  static hasFunction(value, key)\r\n  {\r\n    return this.hasProperty(value, key) && typeof value[key] === \"function\";\r\n  }\r\n\r\n  /**\r\n   * Narrows a value to an object reference, returning null for primitives and\r\n   * nullish values.\r\n   */\r\n  static asObject(value)\r\n  {\r\n    return value && typeof value === \"object\" ? value : null;\r\n  }\r\n\r\n  /**\r\n   * Reads a property from a duck-typed target, returning undefined when the\r\n   * target is not an object or lacks the key.\r\n   */\r\n  static getProperty(target, propertyName)\r\n  {\r\n    return this.hasProperty(target, propertyName) ? target[propertyName] : undefined;\r\n  }\r\n\r\n  /**\r\n   * Resolves the object held by an owner's named parameter, accepting\r\n   * GetParameterObject, parameterObject or object as the payload accessor.\r\n   */\r\n  static getParameterOwner(owner, name)\r\n  {\r\n    const parameter = this.callTarget(owner, \"GetParameterByName\", name);\r\n    if (!parameter)\r\n    {\r\n      return null;\r\n    }\r\n    return this.asObject(this.callTarget(parameter, \"GetParameterObject\") ?? this.getProperty(parameter, \"parameterObject\") ?? this.getProperty(parameter, \"object\"));\r\n  }\r\n\r\n  /**\r\n   * Finds a named sound emitter on the owner, or null when the owner exposes no\r\n   * emitter lookup.\r\n   */\r\n  static findSoundEmitter(owner, name)\r\n  {\r\n    return this.callTarget(owner, \"FindSoundEmitter\", name) ?? null;\r\n  }\r\n\r\n  /**\r\n   * Resolves an owner's animation controller from either the\r\n   * GetAnimationController method or the animationController property.\r\n   */\r\n  static getAnimationController(owner)\r\n  {\r\n    return this.callTarget(owner, \"GetAnimationController\") ?? this.getProperty(owner, \"animationController\") ?? null;\r\n  }\r\n}\r\n\r\n\r\nBrand(ITr2ControllerAction, ITR2_CONTROLLER_ACTION, ACTION_NOOPS, []);\r\nfor (const name of ACTION_DEFAULTS) CjsSchema.decorateMethod(ITr2ControllerAction, name, impl.implemented);\r\nCjsSchema.define(ITr2ControllerAction, { className: \"ITr2ControllerAction\" });\r\n\r\n\r\n/**\r\n * Adds the ITr2ControllerAction contract without replacing an existing model\r\n * base.\r\n *\r\n * Every concrete action extends CjsModel, so the contract arrives as a mixin:\r\n * the action overrides the verbs it cares about and inherits Carbon's empty\r\n * body for the rest, and the owner of an `actions` list no longer has to ask.\r\n *\r\n * @param {Function} Base The class to extend.\r\n * @returns {Function} A subclass carrying the contract.\r\n */\r\nexport function withITr2ControllerAction(Base)\r\n{\r\n  const Action = Adopt(Base, ITr2ControllerAction, [ ...ACTION_NOOPS, ...ACTION_DEFAULTS ]);\r\n\r\n  Brand(Action, ITR2_CONTROLLER_ACTION, ACTION_NOOPS, []);\r\n  for (const name of ACTION_DEFAULTS) CjsSchema.decorateMethod(Action, name, impl.implemented);\r\n\r\n  return Action;\r\n}\r\n"],"names":["ITR2_CONTROLLER_ACTION","Symbol","for","ACTION_NOOPS","ACTION_DEFAULTS","ITr2ControllerAction","hasInstance","value","undefined","Link","_controller","Unlink","Start","Stop","RebaseSimTime","_diff","CanTransition","getOwner","controller","owner","GetOwner","requireController","methodName","TypeError","getTime","fallback","CjsGetCurrentFrameTime","toNumber","GetTime","callTarget","target","args","hasFunction","number","Number","isFinite","hasProperty","key","asObject","getProperty","propertyName","getParameterOwner","name","parameter","findSoundEmitter","getAnimationController","Brand","CjsSchema","decorateMethod","impl","implemented","define","className","withITr2ControllerAction","Base","Action","Adopt"],"mappings":"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"}

package/dist/trinity/controllers/action/Tr2ActionSpawnParticles.js

@@ -2,14 +2,15 @@ import { identity as _identity, applyDecs2311 as _applyDecs2311 } from '../../..
 import { CjsModel } from '#model';
 import { withITr2ControllerAction } from './ITr2ControllerAction.js';
 import { io, type, carbon, impl } from '#schema';
-import { ITr2GenericEmitterUpdateArguments as _ITr2GenericEmitterUp } from '../../particle/ITr2GenericEmitter.js';
+import { ITr2GenericEmitterUpdateArguments as _ITr2GenericEmitterUp } from '../../particle/ITr2GenericEmitter/ITr2GenericEmitterUpdateArguments.js';
+import '../../particle/ITr2GenericEmitter/ITr2GenericEmitter.js';
 
 var _withITr2ControllerAc;
 let _initProto, _initClass, _init_emitter, _init_extra_emitter, _init_rate, _init_extra_rate;
 
-/**
- * Controller action that emits a one-shot burst of particles from a dynamic
- * emitter when it starts.
+/**
+ * Controller action that emits a one-shot burst of particles from a dynamic
+ * emitter when it starts.
  */
 let _Tr2ActionSpawnPartic;
 new class extends _identity {
@@ -30,8 +31,8 @@ new class extends _identity {
     emitter = (_initProto(this), _init_emitter(this, null));
     rate = (_init_extra_emitter(this), _init_rate(this, 1));
 
-    /**
-     * Spawns particles on the configured emitter.
+    /**
+     * Spawns particles on the configured emitter.
      */
     Start(_controller) {
       if (!this.emitter) {
@@ -40,9 +41,9 @@ new class extends _identity {
       this.emitter.SpawnParticles(_Tr2ActionSpawnPartic.#createEmitterUpdateArguments(), null, null, this.rate);
     }
 
-    /**
-     * Builds the emitter update arguments used for a manual spawn, with an emit
-     * count factor of 1 so the authored rate is applied unscaled.
+    /**
+     * Builds the emitter update arguments used for a manual spawn, with an emit
+     * count factor of 1 so the authored rate is applied unscaled.
      */
   }];
   #createEmitterUpdateArguments() {

package/dist/trinity/controllers/action/Tr2ActionSpawnParticles.js.map

@@ -1 +1 @@
-{"version":3,"file":"Tr2ActionSpawnParticles.js","sources":["../../../../../src/trinity/controllers/action/Tr2ActionSpawnParticles.js"],"sourcesContent":["// Source: trinity/trinity/Controllers/Actions/Tr2ActionSpawnParticles.h\r\n// Source: trinity/trinity/Controllers/Actions/Tr2ActionSpawnParticles.cpp\r\nimport { CjsModel } from \"#model\";\nimport { withITr2ControllerAction } from \"./ITr2ControllerAction.js\";\r\nimport { carbon, impl, io, type } from \"#schema\";\r\nimport { ITr2GenericEmitterUpdateArguments } from \"../../particle/ITr2GenericEmitter.js\";\n\r\n\r\n/**\r\n * Controller action that emits a one-shot burst of particles from a dynamic\r\n * emitter when it starts.\r\n */\r\n@type.define({\r\n  className: \"Tr2ActionSpawnParticles\",\r\n  family: \"controllers\"\r\n})\r\nexport class Tr2ActionSpawnParticles extends withITr2ControllerAction(CjsModel)\r\n{\r\n  @io.persist\r\n  @type.objectRef(\"Tr2DynamicEmitter\")\r\n  emitter = null;\r\n\r\n  @io.persist\r\n  @type.float32\r\n  rate = 1;\r\n\r\n  /**\r\n   * Spawns particles on the configured emitter.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  Start(_controller)\r\n  {\r\n    if (!this.emitter)\n    {\n      return;\n    }\r\n    this.emitter.SpawnParticles(Tr2ActionSpawnParticles.#createEmitterUpdateArguments(), null, null, this.rate);\r\n  }\r\n\r\n  /**\r\n   * Builds the emitter update arguments used for a manual spawn, with an emit\r\n   * count factor of 1 so the authored rate is applied unscaled.\r\n   */\r\n  static #createEmitterUpdateArguments()\r\n  {\r\n    const args = new ITr2GenericEmitterUpdateArguments();\n    args.emitCountFactor = 1;\r\n    return args;\r\n  }\r\n}\r\n"],"names":["_Tr2ActionSpawnPartic","_identity","Tr2ActionSpawnParticles","_withITr2ControllerAc","withITr2ControllerAction","CjsModel","e","_init_emitter","_init_extra_emitter","_init_rate","_init_extra_rate","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","persist","objectRef","float32","carbon","method","impl","adapted","constructor","args","emitter","rate","Start","_controller","SpawnParticles","#createEmitterUpdateArguments","ITr2GenericEmitterUpdateArguments","emitCountFactor"],"mappings":";;;;;;;;;AAQA;AACA;AACA;AACA;AAHA,IAAAA;AAAA,IAAA,cAAAC,SAAA,CAAA;EAAA,QAIA,MAAAC,uBAAA,UAAAC,qBAAA,GAI6CC,wBAAwB,CAACC,QAAQ,CAAC,EAC/E;AAAA,IAAA;AAAA,MAAA,CAAA;QAAAC,CAAA,EAAA,CAAAC,aAAA,EAAAC,mBAAA,EAAAC,UAAA,EAAAC,gBAAA,EAAAC,UAAA,CAAA;QAAAC,CAAA,EAAA,CAAAZ,qBAAA,EAAAa,UAAA;AAAA,OAAA,GAAAC,cAAA,CAAA,IAAA,EAAA,CALCC,IAAI,CAACC,MAAM,CAAC;AACXC,QAAAA,SAAS,EAAE,yBAAyB;AACpCC,QAAAA,MAAM,EAAE;AACV,OAAC,CAAC,CAAA,EAAA,CAAA,CAAA,CAGCC,EAAE,EAAFA,EAAE,CAACC,OAAO,EAAA,MAAA,EACVL,IAAI,CAACM,SAAS,CAAC,mBAAmB,CAAC,CAAA,EAAA,EAAA,EAAA,SAAA,CAAA,EAAA,CAAA,CAGnCF,EAAE,EAAFA,EAAE,CAACC,OAAO,EACVL,IAAI,EAAJA,IAAI,CAACO,OAAO,CAAA,EAAA,EAAA,EAAA,MAAA,CAAA,EAAA,CAAA,CAMZC,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACC,OAAO,6BAAAvB,qBAAA,CAAA;AAAA;AAAAwB,IAAAA,WAAAA,CAAA,GAAAC,IAAA,EAAA;AAAA,MAAA,KAAA,CAAA,GAAAA,IAAA,CAAA;MAAAlB,gBAAA,CAAA,IAAA,CAAA;AAAA,IAAA;AAVbmB,IAAAA,OAAO,IAAAlB,UAAA,CAAA,IAAA,CAAA,EAAAJ,aAAA,OAAG,IAAI,CAAA;AAIduB,IAAAA,IAAI,IAAAtB,mBAAA,CAAA,IAAA,CAAA,EAAAC,UAAA,OAAG,CAAC,CAAA;;AAER;AACF;AACA;IAGEsB,KAAKA,CAACC,WAAW,EACjB;AACE,MAAA,IAAI,CAAC,IAAI,CAACH,OAAO,EACjB;AACE,QAAA;AACF,MAAA;AACA,MAAA,IAAI,CAACA,OAAO,CAACI,cAAc,CAAC/B,qBAAuB,CAAC,6BAA6B,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC4B,IAAI,CAAC;AAC7G,IAAA;;AAEA;AACF;AACA;AACA;GAOC;EANQ,6BAA6BI,GACpC;AACE,IAAA,MAAMN,IAAI,GAAG,IAAIO,qBAAiC,EAAE;IACpDP,IAAI,CAACQ,eAAe,GAAG,CAAC;AACxB,IAAA,OAAOR,IAAI;AACb,EAAA;EAACD,WAAAA,GAAA;IAAA,KAAA,CAAA3B,qBAAA,GAAAa,UAAA,EAAA;AAAA,EAAA;AAAA,CAAA,EAAA;;;;"}
+{"version":3,"file":"Tr2ActionSpawnParticles.js","sources":["../../../../../src/trinity/controllers/action/Tr2ActionSpawnParticles.js"],"sourcesContent":["// Source: trinity/trinity/Controllers/Actions/Tr2ActionSpawnParticles.h\n// Source: trinity/trinity/Controllers/Actions/Tr2ActionSpawnParticles.cpp\nimport { CjsModel } from \"#model\";\nimport { withITr2ControllerAction } from \"./ITr2ControllerAction.js\";\nimport { carbon, impl, io, type } from \"#schema\";\nimport { ITr2GenericEmitterUpdateArguments } from \"../../particle/ITr2GenericEmitter/index.js\";\n\n\n/**\n * Controller action that emits a one-shot burst of particles from a dynamic\n * emitter when it starts.\n */\n@type.define({\n  className: \"Tr2ActionSpawnParticles\",\n  family: \"controllers\"\n})\nexport class Tr2ActionSpawnParticles extends withITr2ControllerAction(CjsModel)\n{\n  @io.persist\n  @type.objectRef(\"Tr2DynamicEmitter\")\n  emitter = null;\n\n  @io.persist\n  @type.float32\n  rate = 1;\n\n  /**\n   * Spawns particles on the configured emitter.\n   */\n  @carbon.method\n  @impl.adapted\n  Start(_controller)\n  {\n    if (!this.emitter)\n    {\n      return;\n    }\n    this.emitter.SpawnParticles(Tr2ActionSpawnParticles.#createEmitterUpdateArguments(), null, null, this.rate);\n  }\n\n  /**\n   * Builds the emitter update arguments used for a manual spawn, with an emit\n   * count factor of 1 so the authored rate is applied unscaled.\n   */\n  static #createEmitterUpdateArguments()\n  {\n    const args = new ITr2GenericEmitterUpdateArguments();\n    args.emitCountFactor = 1;\n    return args;\n  }\n}\n"],"names":["_Tr2ActionSpawnPartic","_identity","Tr2ActionSpawnParticles","_withITr2ControllerAc","withITr2ControllerAction","CjsModel","e","_init_emitter","_init_extra_emitter","_init_rate","_init_extra_rate","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","persist","objectRef","float32","carbon","method","impl","adapted","constructor","args","emitter","rate","Start","_controller","SpawnParticles","#createEmitterUpdateArguments","ITr2GenericEmitterUpdateArguments","emitCountFactor"],"mappings":";;;;;;;;;;AAQA;AACA;AACA;AACA;AAHA,IAAAA;AAAA,IAAA,cAAAC,SAAA,CAAA;EAAA,QAIA,MAAAC,uBAAA,UAAAC,qBAAA,GAI6CC,wBAAwB,CAACC,QAAQ,CAAC,EAC/E;AAAA,IAAA;AAAA,MAAA,CAAA;QAAAC,CAAA,EAAA,CAAAC,aAAA,EAAAC,mBAAA,EAAAC,UAAA,EAAAC,gBAAA,EAAAC,UAAA,CAAA;QAAAC,CAAA,EAAA,CAAAZ,qBAAA,EAAAa,UAAA;AAAA,OAAA,GAAAC,cAAA,CAAA,IAAA,EAAA,CALCC,IAAI,CAACC,MAAM,CAAC;AACXC,QAAAA,SAAS,EAAE,yBAAyB;AACpCC,QAAAA,MAAM,EAAE;AACV,OAAC,CAAC,CAAA,EAAA,CAAA,CAAA,CAGCC,EAAE,EAAFA,EAAE,CAACC,OAAO,EAAA,MAAA,EACVL,IAAI,CAACM,SAAS,CAAC,mBAAmB,CAAC,CAAA,EAAA,EAAA,EAAA,SAAA,CAAA,EAAA,CAAA,CAGnCF,EAAE,EAAFA,EAAE,CAACC,OAAO,EACVL,IAAI,EAAJA,IAAI,CAACO,OAAO,CAAA,EAAA,EAAA,EAAA,MAAA,CAAA,EAAA,CAAA,CAMZC,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACC,OAAO,6BAAAvB,qBAAA,CAAA;AAAA;AAAAwB,IAAAA,WAAAA,CAAA,GAAAC,IAAA,EAAA;AAAA,MAAA,KAAA,CAAA,GAAAA,IAAA,CAAA;MAAAlB,gBAAA,CAAA,IAAA,CAAA;AAAA,IAAA;AAVbmB,IAAAA,OAAO,IAAAlB,UAAA,CAAA,IAAA,CAAA,EAAAJ,aAAA,OAAG,IAAI,CAAA;AAIduB,IAAAA,IAAI,IAAAtB,mBAAA,CAAA,IAAA,CAAA,EAAAC,UAAA,OAAG,CAAC,CAAA;;AAER;AACF;AACA;IAGEsB,KAAKA,CAACC,WAAW,EACjB;AACE,MAAA,IAAI,CAAC,IAAI,CAACH,OAAO,EACjB;AACE,QAAA;AACF,MAAA;AACA,MAAA,IAAI,CAACA,OAAO,CAACI,cAAc,CAAC/B,qBAAuB,CAAC,6BAA6B,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC4B,IAAI,CAAC;AAC7G,IAAA;;AAEA;AACF;AACA;AACA;GAOC;EANQ,6BAA6BI,GACpC;AACE,IAAA,MAAMN,IAAI,GAAG,IAAIO,qBAAiC,EAAE;IACpDP,IAAI,CAACQ,eAAe,GAAG,CAAC;AACxB,IAAA,OAAOR,IAAI;AACb,EAAA;EAACD,WAAAA,GAAA;IAAA,KAAA,CAAA3B,qBAAA,GAAAa,UAAA,EAAA;AAAA,EAAA;AAAA,CAAA,EAAA;;;;"}

package/dist/trinity/controllers/expression/CjsControllerExpressionCompileError.js

@@ -0,0 +1,26 @@
+// Source: parser/include/ccpparser.h (CcpParser::Parse)
+
+/**
+ * Error raised while tokenizing or parsing an expression, carrying the source
+ * text, the reason, and the character position at which parsing failed.
+ */
+class CjsControllerExpressionCompileError extends Error {
+  expression;
+  reason;
+  position;
+
+  /**
+   * Formats the message as the position, reason and full expression so a failed
+   * compile is diagnosable from the message alone.
+   */
+  constructor(data) {
+    super(`Error compiling expression at ${data.position}: ${data.reason} (${data.expression})`);
+    this.name = "CjsControllerExpressionCompileError";
+    this.expression = data.expression;
+    this.reason = data.reason;
+    this.position = data.position;
+  }
+}
+
+export { CjsControllerExpressionCompileError };
+//# sourceMappingURL=CjsControllerExpressionCompileError.js.map

package/dist/trinity/controllers/expression/CjsControllerExpressionCompileError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CjsControllerExpressionCompileError.js","sources":["../../../../../src/trinity/controllers/expression/CjsControllerExpressionCompileError.js"],"sourcesContent":["// Source: parser/include/ccpparser.h (CcpParser::Parse)\r\n\r\n/**\r\n * Error raised while tokenizing or parsing an expression, carrying the source\r\n * text, the reason, and the character position at which parsing failed.\r\n */\r\nexport class CjsControllerExpressionCompileError extends Error\r\n{\r\n  expression;\r\n  reason;\r\n  position;\r\n\r\n  /**\r\n   * Formats the message as the position, reason and full expression so a failed\r\n   * compile is diagnosable from the message alone.\r\n   */\r\n  constructor(data)\r\n  {\r\n    super(`Error compiling expression at ${data.position}: ${data.reason} (${data.expression})`);\r\n    this.name = \"CjsControllerExpressionCompileError\";\r\n    this.expression = data.expression;\r\n    this.reason = data.reason;\r\n    this.position = data.position;\r\n  }\r\n}\r\n"],"names":["CjsControllerExpressionCompileError","Error","expression","reason","position","constructor","data","name"],"mappings":"AAAA;;AAEA;AACA;AACA;AACA;AACO,MAAMA,mCAAmC,SAASC,KAAK,CAC9D;EACEC,UAAU;EACVC,MAAM;EACNC,QAAQ;;AAER;AACF;AACA;AACA;EACEC,WAAWA,CAACC,IAAI,EAChB;AACE,IAAA,KAAK,CAAC,CAAA,8BAAA,EAAiCA,IAAI,CAACF,QAAQ,CAAA,EAAA,EAAKE,IAAI,CAACH,MAAM,CAAA,EAAA,EAAKG,IAAI,CAACJ,UAAU,GAAG,CAAC;IAC5F,IAAI,CAACK,IAAI,GAAG,qCAAqC;AACjD,IAAA,IAAI,CAACL,UAAU,GAAGI,IAAI,CAACJ,UAAU;AACjC,IAAA,IAAI,CAACC,MAAM,GAAGG,IAAI,CAACH,MAAM;AACzB,IAAA,IAAI,CAACC,QAAQ,GAAGE,IAAI,CAACF,QAAQ;AAC/B,EAAA;AACF;;;;"}

package/dist/trinity/controllers/expression/CjsControllerExpressionEvaluateError.js

@@ -0,0 +1,24 @@
+// Source: parser/include/ccpparser.h (CcpParser::Program)
+
+/**
+ * Error raised while evaluating a compiled expression, carrying the source text
+ * and the reason.
+ */
+class CjsControllerExpressionEvaluateError extends Error {
+  expression;
+  reason;
+
+  /**
+   * Formats the message as the reason and the full expression; unlike compile
+   * errors there is no meaningful source position at evaluation time.
+   */
+  constructor(data) {
+    super(`Error evaluating expression: ${data.reason} (${data.expression})`);
+    this.name = "CjsControllerExpressionEvaluateError";
+    this.expression = data.expression;
+    this.reason = data.reason;
+  }
+}
+
+export { CjsControllerExpressionEvaluateError };
+//# sourceMappingURL=CjsControllerExpressionEvaluateError.js.map

package/dist/trinity/controllers/expression/CjsControllerExpressionEvaluateError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CjsControllerExpressionEvaluateError.js","sources":["../../../../../src/trinity/controllers/expression/CjsControllerExpressionEvaluateError.js"],"sourcesContent":["// Source: parser/include/ccpparser.h (CcpParser::Program)\r\n\r\n/**\r\n * Error raised while evaluating a compiled expression, carrying the source text\r\n * and the reason.\r\n */\r\nexport class CjsControllerExpressionEvaluateError extends Error\r\n{\r\n  expression;\r\n  reason;\r\n\r\n  /**\r\n   * Formats the message as the reason and the full expression; unlike compile\r\n   * errors there is no meaningful source position at evaluation time.\r\n   */\r\n  constructor(data)\r\n  {\r\n    super(`Error evaluating expression: ${data.reason} (${data.expression})`);\r\n    this.name = \"CjsControllerExpressionEvaluateError\";\r\n    this.expression = data.expression;\r\n    this.reason = data.reason;\r\n  }\r\n}\r\n"],"names":["CjsControllerExpressionEvaluateError","Error","expression","reason","constructor","data","name"],"mappings":"AAAA;;AAEA;AACA;AACA;AACA;AACO,MAAMA,oCAAoC,SAASC,KAAK,CAC/D;EACEC,UAAU;EACVC,MAAM;;AAEN;AACF;AACA;AACA;EACEC,WAAWA,CAACC,IAAI,EAChB;IACE,KAAK,CAAC,CAAA,6BAAA,EAAgCA,IAAI,CAACF,MAAM,KAAKE,IAAI,CAACH,UAAU,CAAA,CAAA,CAAG,CAAC;IACzE,IAAI,CAACI,IAAI,GAAG,sCAAsC;AAClD,IAAA,IAAI,CAACJ,UAAU,GAAGG,IAAI,CAACH,UAAU;AACjC,IAAA,IAAI,CAACC,MAAM,GAAGE,IAAI,CAACF,MAAM;AAC3B,EAAA;AACF;;;;"}

package/dist/trinity/controllers/expression/CjsControllerExpressionParser.js

@@ -0,0 +1,387 @@
+import { CjsControllerExpressionCompileError } from './CjsControllerExpressionCompileError.js';
+import { Tokenize, CONSTANTS, GetFunction, BLOCKED_IDENTIFIERS } from './expressionRuntime.js';
+
+// Source: parser/include/ccpparser.h (CcpParser::Parse)
+/**
+ * Recursive-descent parser turning expression source into the AST evaluated by
+ * CjsControllerExpressionProgram, collecting referenced variable and function
+ * names and rejecting identifiers that could reach the JavaScript prototype
+ * chain.
+ */
+class CjsControllerExpressionParser {
+  source;
+  options;
+  tokens;
+  index = 0;
+  variableNames = new Set();
+  functionNames = new Set();
+
+  /**
+   * Tokenizes the source up front; a malformed character or unterminated string
+   * throws a CjsControllerExpressionCompileError here rather than during Parse.
+   */
+  constructor(source, options) {
+    this.source = source;
+    this.options = options || {};
+    this.tokens = Tokenize(source);
+  }
+
+  /**
+   * Parses the whole source as a single expression and requires that all input
+   * is consumed.
+   */
+  Parse() {
+    const expression = this.ParseConditional();
+    this.Expect("eof");
+    return expression;
+  }
+
+  /**
+   * Parses the ternary `cond ? a : b` level, which is right-associative and the
+   * lowest-precedence form.
+   */
+  ParseConditional() {
+    const condition = this.ParseLogicalOr();
+    if (this.Match("operator", "?")) {
+      const consequent = this.ParseConditional();
+      this.Expect("operator", ":");
+      const alternate = this.ParseConditional();
+      return {
+        type: "conditional",
+        condition,
+        consequent,
+        alternate
+      };
+    }
+    return condition;
+  }
+
+  /** Parses left-associative `||` chains. */
+  ParseLogicalOr() {
+    let node = this.ParseLogicalAnd();
+    while (this.Match("operator", "||")) {
+      node = {
+        type: "binary",
+        operator: "||",
+        left: node,
+        right: this.ParseLogicalAnd()
+      };
+    }
+    return node;
+  }
+
+  /** Parses left-associative `&&` chains, which bind tighter than `||`. */
+  ParseLogicalAnd() {
+    let node = this.ParseEquality();
+    while (this.Match("operator", "&&")) {
+      node = {
+        type: "binary",
+        operator: "&&",
+        left: node,
+        right: this.ParseEquality()
+      };
+    }
+    return node;
+  }
+
+  /** Parses left-associative `==` and `!=` chains. */
+  ParseEquality() {
+    let node = this.ParseComparison();
+    while (true) {
+      if (this.Match("operator", "==")) {
+        node = {
+          type: "binary",
+          operator: "==",
+          left: node,
+          right: this.ParseComparison()
+        };
+      } else if (this.Match("operator", "!=")) {
+        node = {
+          type: "binary",
+          operator: "!=",
+          left: node,
+          right: this.ParseComparison()
+        };
+      } else {
+        return node;
+      }
+    }
+  }
+
+  /**
+   * Parses left-associative `<`, `<=`, `>` and `>=` chains, which bind tighter
+   * than equality.
+   */
+  ParseComparison() {
+    let node = this.ParseTerm();
+    while (true) {
+      if (this.Match("operator", "<")) {
+        node = {
+          type: "binary",
+          operator: "<",
+          left: node,
+          right: this.ParseTerm()
+        };
+      } else if (this.Match("operator", "<=")) {
+        node = {
+          type: "binary",
+          operator: "<=",
+          left: node,
+          right: this.ParseTerm()
+        };
+      } else if (this.Match("operator", ">")) {
+        node = {
+          type: "binary",
+          operator: ">",
+          left: node,
+          right: this.ParseTerm()
+        };
+      } else if (this.Match("operator", ">=")) {
+        node = {
+          type: "binary",
+          operator: ">=",
+          left: node,
+          right: this.ParseTerm()
+        };
+      } else {
+        return node;
+      }
+    }
+  }
+
+  /** Parses left-associative `+` and `-` chains. */
+  ParseTerm() {
+    let node = this.ParseFactor();
+    while (true) {
+      if (this.Match("operator", "+")) {
+        node = {
+          type: "binary",
+          operator: "+",
+          left: node,
+          right: this.ParseFactor()
+        };
+      } else if (this.Match("operator", "-")) {
+        node = {
+          type: "binary",
+          operator: "-",
+          left: node,
+          right: this.ParseFactor()
+        };
+      } else {
+        return node;
+      }
+    }
+  }
+
+  /**
+   * Parses left-associative `*`, `/` and `%` chains, which bind tighter than
+   * addition.
+   */
+  ParseFactor() {
+    let node = this.ParseExponent();
+    while (true) {
+      if (this.Match("operator", "*")) {
+        node = {
+          type: "binary",
+          operator: "*",
+          left: node,
+          right: this.ParseExponent()
+        };
+      } else if (this.Match("operator", "/")) {
+        node = {
+          type: "binary",
+          operator: "/",
+          left: node,
+          right: this.ParseExponent()
+        };
+      } else if (this.Match("operator", "%")) {
+        node = {
+          type: "binary",
+          operator: "%",
+          left: node,
+          right: this.ParseExponent()
+        };
+      } else {
+        return node;
+      }
+    }
+  }
+
+  /**
+   * Parses `^` power chains; unlike most languages this level is
+   * left-associative here.
+   */
+  ParseExponent() {
+    let node = this.ParseUnary();
+    while (this.Match("operator", "^")) {
+      node = {
+        type: "binary",
+        operator: "^",
+        left: node,
+        right: this.ParseUnary()
+      };
+    }
+    return node;
+  }
+
+  /**
+   * Parses right-nested prefix `!`, `-` and `+` operators, falling through to a
+   * primary when none is present.
+   */
+  ParseUnary() {
+    if (this.Match("operator", "!")) {
+      return {
+        type: "unary",
+        operator: "!",
+        argument: this.ParseUnary()
+      };
+    }
+    if (this.Match("operator", "-")) {
+      return {
+        type: "unary",
+        operator: "-",
+        argument: this.ParseUnary()
+      };
+    }
+    if (this.Match("operator", "+")) {
+      return {
+        type: "unary",
+        operator: "+",
+        argument: this.ParseUnary()
+      };
+    }
+    return this.ParsePrimary();
+  }
+
+  /**
+   * Parses a number, string, parenthesized expression, function call, built-in
+   * constant, or a variable identifier, recording bare identifiers in
+   * `variableNames`.
+   */
+  ParsePrimary() {
+    const token = this.Peek();
+    if (this.Match("number")) {
+      return {
+        type: "literal",
+        value: token.value
+      };
+    }
+    if (this.Match("string")) {
+      return {
+        type: "literal",
+        value: token.value
+      };
+    }
+    if (this.Match("identifier")) {
+      const name = String(token.value);
+      this.AssertSafeIdentifier(name);
+      if (this.Match("operator", "(")) {
+        return this.ParseCall(name);
+      }
+      if (name in CONSTANTS) {
+        return {
+          type: "literal",
+          value: CONSTANTS[name]
+        };
+      }
+      this.variableNames.add(name);
+      return {
+        type: "identifier",
+        name
+      };
+    }
+    if (this.Match("operator", "(")) {
+      const node = this.ParseConditional();
+      this.Expect("operator", ")");
+      return node;
+    }
+    throw this.Error(`Unexpected token '${String(token.value)}'`);
+  }
+
+  /**
+   * Parses a call argument list after the opening parenthesis and fails
+   * compilation when the name resolves to no built-in or caller-supplied
+   * function, so unknown functions cannot reach evaluation.
+   */
+  ParseCall(name) {
+    this.AssertSafeIdentifier(name);
+    if (!GetFunction(name, this.options)) {
+      throw this.Error(`Unknown function '${name}'`);
+    }
+    const args = [];
+    if (!this.Match("operator", ")")) {
+      do {
+        args.push(this.ParseConditional());
+      } while (this.Match("operator", ","));
+      this.Expect("operator", ")");
+    }
+    this.functionNames.add(name);
+    return {
+      type: "call",
+      name,
+      args
+    };
+  }
+
+  /**
+   * Rejects identifiers such as `__proto__`, `constructor` and `globalThis` that
+   * could be used to escape the sandboxed evaluator.
+   */
+  AssertSafeIdentifier(name) {
+    if (BLOCKED_IDENTIFIERS.has(name)) {
+      throw this.Error(`Unsafe identifier '${name}'`);
+    }
+  }
+
+  /**
+   * Returns the token at the cursor without consuming it; the stream always ends
+   * with an `eof` token.
+   */
+  Peek() {
+    return this.tokens[this.index];
+  }
+
+  /**
+   * Consumes the next token and returns true when it has the given type and, if
+   * supplied, the given value; otherwise leaves the cursor untouched.
+   */
+  Match(type, value) {
+    const token = this.Peek();
+    if (!token || token.type !== type) {
+      return false;
+    }
+    if (value !== undefined && token.value !== value) {
+      return false;
+    }
+    this.index++;
+    return true;
+  }
+
+  /**
+   * Consumes and returns the next token, throwing a compile error naming the
+   * expected form when it does not match.
+   */
+  Expect(type, value) {
+    const token = this.Peek();
+    if (this.Match(type, value)) {
+      return token;
+    }
+    throw this.Error(`Expected ${value || type}, got '${token ? String(token.value) : "end of input"}'`);
+  }
+
+  /**
+   * Builds a compile error carrying the source text and the character position
+   * of the current token.
+   */
+  Error(message) {
+    const token = this.Peek();
+    return new CjsControllerExpressionCompileError({
+      expression: this.source,
+      reason: message,
+      position: token ? token.position : this.source.length
+    });
+  }
+}
+
+export { CjsControllerExpressionParser };
+//# sourceMappingURL=CjsControllerExpressionParser.js.map