@carbonenginejs/runtime-trinity 0.6.0 → 0.8.0

package/dist/eve/smartLights/attributeModifiers/enums.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"enums.js","sources":["../../../../../src/eve/smartLights/attributeModifiers/enums.js"],"sourcesContent":["// Generated by format-carbon carbon-class --emit-enums from schema enums.json.\r\n\r\nexport const LifeTimeFormulas = Object.freeze({\r\n  PER_INSTANCE_LIFETIME: 0,\r\n  PER_MODIFIER_PLAYTIME: 1,\r\n  STATIC: 2,\r\n});\r\n"],"names":["LifeTimeFormulas","Object","freeze","PER_INSTANCE_LIFETIME","PER_MODIFIER_PLAYTIME","STATIC"],"mappings":"AAAA;;MAEaA,gBAAgB,GAAGC,MAAM,CAACC,MAAM,CAAC;AAC5CC,EAAAA,qBAAqB,EAAE,CAAC;AACxBC,EAAAA,qBAAqB,EAAE,CAAC;AACxBC,EAAAA,MAAM,EAAE;AACV,CAAC;;;;"}

package/dist/{generated/eve → eve}/socket/EveSocketParameterBindingBase.js

@@ -1,4 +1,4 @@
-import { applyDecs2311 as _applyDecs2311 } from '../../../_virtual/_rollupPluginBabelHelpers.js';
+import { applyDecs2311 as _applyDecs2311 } from '../../_virtual/_rollupPluginBabelHelpers.js';
 import { type, carbon, impl } from '@carbonenginejs/runtime-utils/schema';
 import { CjsModel } from '@carbonenginejs/runtime-utils/model';
 
@@ -25,15 +25,30 @@ class EveSocketParameterBindingBase extends CjsModel {
 
   /** m_bindings (PITr2ValueBindingVector) */
   bindings = (_init_extra_name(this), _init_bindings(this, []));
+
+  /** Returns the name an external parameter has to match before it can bind here. */
   GetName() {
     return this.name;
   }
+
+  /**
+   * Sets the name external parameters must match to bind, coercing null to an
+   * empty string.
+   */
   SetName(name) {
     this.name = String(name ?? "");
   }
+
+  /** Drops every value binding, leaving the current value in place. */
   ClearBindings() {
     this.bindings.length = 0;
   }
+
+  /**
+   * Creates a binding that reads this parameter's `value` field and writes it to the external parameter, keeping it only when the names match, the binding initializes and a default could be captured.
+   *
+   * @returns {boolean} True when the binding was created and stored.
+   */
   BindToExternalParameter(externalParameter) {
     if (!externalParameter?.IsValid?.() || externalParameter.GetName?.() !== this.name) return false;
     const binding = externalParameter.CreateBinding?.();
@@ -44,12 +59,22 @@ class EveSocketParameterBindingBase extends CjsModel {
     this.bindings.push(binding);
     return true;
   }
+
+  /**
+   * Hook where a typed subclass records the external parameter's current value
+   * as a restore default; the base captures nothing and refuses the bind by
+   * returning false.
+   */
   ExtractDefault(_externalParameter) {
     return false;
   }
+
+  /** Reports whether anything is bound to this parameter. */
   Used() {
     return this.bindings.length !== 0;
   }
+
+  /** Pushes the current value out through every binding. */
   Propagate() {
     for (const binding of this.bindings) binding?.CopyValue?.();
   }

package/dist/eve/socket/EveSocketParameterBindingBase.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EveSocketParameterBindingBase.js","sources":["../../../../src/eve/socket/EveSocketParameterBindingBase.js"],"sourcesContent":["// Ported from CarbonEngine (MIT, (c) 2026 CCP Games) - https://github.com/carbonengine/trinity\r\n//   trinity/trinity/Eve/SpaceObject/Children/SocketParameters/EveSocketParameter.h\r\n// Generated by format-carbon carbon-class --emit. Verify against eve/socket/EveSocketParameterBindingBase.json.\r\nimport { carbon, impl, type } from \"@carbonenginejs/runtime-utils/schema\";\r\nimport { CjsModel } from \"@carbonenginejs/runtime-utils/model\";\r\n\r\n/** EveSocketParameterBindingBase (eve/socket) - generated from schema shapeHash d75356dd.... */\r\n@type.define({ className: \"EveSocketParameterBindingBase\", family: \"eve/socket\" })\r\nexport class EveSocketParameterBindingBase extends CjsModel\r\n{\r\n\r\n  /** name (m_name =) */\r\n  @type.string\r\n  name = \"\";\r\n\r\n  /** m_bindings (PITr2ValueBindingVector) */\r\n  @type.list(\"ITr2ValueBinding\")\r\n  bindings = [];\r\n\r\n  /** Returns the name an external parameter has to match before it can bind here. */\r\n  GetName()\r\n  {\r\n    return this.name;\r\n  }\r\n\r\n  /**\r\n   * Sets the name external parameters must match to bind, coercing null to an\r\n   * empty string.\r\n   */\r\n  SetName(name)\r\n  {\r\n    this.name = String(name ?? \"\");\r\n  }\r\n\r\n  /** Drops every value binding, leaving the current value in place. */\r\n  @carbon.method\r\n  @impl.implemented\r\n  ClearBindings()\r\n  {\r\n    this.bindings.length = 0;\r\n  }\r\n\r\n  /**\r\n   * Creates a binding that reads this parameter's `value` field and writes it to the external parameter, keeping it only when the names match, the binding initializes and a default could be captured.\r\n   *\r\n   * @returns {boolean} True when the binding was created and stored.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  BindToExternalParameter(externalParameter)\r\n  {\r\n    if (!externalParameter?.IsValid?.() || externalParameter.GetName?.() !== this.name) return false;\r\n    const binding = externalParameter.CreateBinding?.();\r\n    if (!binding) return false;\r\n    binding.SetSource?.(\"value\", this);\r\n    binding.Initialize?.();\r\n    if (!binding.IsValid?.() || !this.ExtractDefault(externalParameter)) return false;\r\n    this.bindings.push(binding);\r\n    return true;\r\n  }\r\n\r\n  /**\r\n   * Hook where a typed subclass records the external parameter's current value\r\n   * as a restore default; the base captures nothing and refuses the bind by\r\n   * returning false.\r\n   */\r\n  ExtractDefault(_externalParameter)\r\n  {\r\n    return false;\r\n  }\r\n\r\n  /** Reports whether anything is bound to this parameter. */\r\n  @carbon.method\r\n  @impl.implemented\r\n  Used()\r\n  {\r\n    return this.bindings.length !== 0;\r\n  }\r\n\r\n  /** Pushes the current value out through every binding. */\r\n  @carbon.method\r\n  @impl.implemented\r\n  Propagate()\r\n  {\r\n    for (const binding of this.bindings) binding?.CopyValue?.();\r\n  }\r\n\r\n}\r\n"],"names":["_EveSocketParameterBi","EveSocketParameterBindingBase","CjsModel","e","_init_name","_init_extra_name","_init_bindings","_init_extra_bindings","_initProto","c","_initClass","_applyDecs","type","define","className","family","string","list","carbon","method","impl","implemented","adapted","constructor","args","name","bindings","GetName","SetName","String","ClearBindings","length","BindToExternalParameter","externalParameter","IsValid","binding","CreateBinding","SetSource","Initialize","ExtractDefault","push","_externalParameter","Used","Propagate","CopyValue"],"mappings":"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"}

package/dist/{generated/eve → eve}/socket/EveSocketParameterBool.js

@@ -1,4 +1,4 @@
-import { applyDecs2311 as _applyDecs2311 } from '../../../_virtual/_rollupPluginBabelHelpers.js';
+import { applyDecs2311 as _applyDecs2311 } from '../../_virtual/_rollupPluginBabelHelpers.js';
 import { io, type, carbon, impl } from '@carbonenginejs/runtime-utils/schema';
 import { EveSocketParameterBindingBase as _EveSocketParameterBi } from './EveSocketParameterBindingBase.js';
 
@@ -21,6 +21,11 @@ class EveSocketParameterBool extends _EveSocketParameterBi {
 
   /** m_defaults - one default captured per bound external parameter. */
   #defaults = (_init_extra_value(this), []);
+
+  /**
+   * Discards the captured defaults along with the bindings, so nothing can be
+   * restored afterwards.
+   */
   ClearBindings() {
     this.#defaults.length = 0;
     super.ClearBindings();
@@ -34,6 +39,12 @@ class EveSocketParameterBool extends _EveSocketParameterBi {
     }
     this.ClearBindings();
   }
+
+  /**
+   * Captures the external parameter's current value as a boolean default, using
+   * false when the read throws; always succeeds, so a bind is never refused on
+   * its account.
+   */
   ExtractDefault(externalParameter) {
     let value = false;
     try {
@@ -44,6 +55,11 @@ class EveSocketParameterBool extends _EveSocketParameterBi {
     this.#defaults.push(value);
     return true;
   }
+
+  /**
+   * Restores the first captured default, falling back to false when nothing was
+   * captured.
+   */
   SetValueToDefault() {
     this.value = this.#defaults.length ? this.#defaults[0] : false;
   }

package/dist/eve/socket/EveSocketParameterBool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EveSocketParameterBool.js","sources":["../../../../src/eve/socket/EveSocketParameterBool.js"],"sourcesContent":["// Ported from CarbonEngine (MIT, (c) 2026 CCP Games) - https://github.com/carbonengine/trinity\r\n//   trinity/trinity/Eve/SpaceObject/Children/SocketParameters/EveSocketParameter.h\r\n// Hand-authored following the eve/socket generated pattern (SOCKET_PARAM_DECLARE macro family).\r\nimport { carbon, impl, io, type } from \"@carbonenginejs/runtime-utils/schema\";\r\nimport { EveSocketParameterBindingBase } from \"./EveSocketParameterBindingBase.js\";\r\n\r\n/** EveSocketParameterBool (eve/socket) - SOCKET_PARAMETER_DEFINE(bool, false). */\r\n@type.define({ className: \"EveSocketParameterBool\", family: \"eve/socket\" })\r\nexport class EveSocketParameterBool extends EveSocketParameterBindingBase\r\n{\r\n\r\n  /** m_value (bool) */\r\n  @io.persist\r\n  @type.boolean\r\n  value = false;\r\n\r\n  /** m_defaults - one default captured per bound external parameter. */\r\n  #defaults = [];\r\n\r\n  /**\r\n   * Discards the captured defaults along with the bindings, so nothing can be\r\n   * restored afterwards.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  ClearBindings()\r\n  {\r\n    this.#defaults.length = 0;\r\n    super.ClearBindings();\r\n  }\r\n\r\n  /** Restores every binding's default and copies it out, then clears. */\r\n  @carbon.method\r\n  @impl.implemented\r\n  Reset()\r\n  {\r\n    for (let index = 0; index < this.bindings.length; index++)\r\n    {\r\n      this.value = this.#defaults[index];\r\n      this.bindings[index]?.CopyValue?.();\r\n    }\r\n    this.ClearBindings();\r\n  }\r\n\r\n  /**\r\n   * Captures the external parameter's current value as a boolean default, using\r\n   * false when the read throws; always succeeds, so a bind is never refused on\r\n   * its account.\r\n   */\r\n  ExtractDefault(externalParameter)\r\n  {\r\n    let value = false;\r\n    try\r\n    {\r\n      value = !!externalParameter.GetValue();\r\n    }\r\n    catch\r\n    {\r\n      value = false;\r\n    }\r\n    this.#defaults.push(value);\r\n    return true;\r\n  }\r\n\r\n  /**\r\n   * Restores the first captured default, falling back to false when nothing was\r\n   * captured.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  SetValueToDefault()\r\n  {\r\n    this.value = this.#defaults.length ? this.#defaults[0] : false;\r\n  }\r\n\r\n}\r\n"],"names":["_EveSocketParameterBo","EveSocketParameterBool","EveSocketParameterBindingBase","e","_init_value","_init_extra_value","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","persist","boolean","carbon","method","impl","implemented","value","ClearBindings","length","Reset","index","bindings","CopyValue","ExtractDefault","externalParameter","GetValue","push","SetValueToDefault"],"mappings":";;;;;;AAMA;AAAA,IAAAA;AACA,MAAAC,sBAAA,SAC4CC,qBAA6B,CACzE;AAAA,EAAA;AAAA,IAAA,CAAA;AAAAC,MAAAA,CAAA,EAAA,CAAAC,WAAA,EAAAC,iBAAA,EAAAC,UAAA,CAAA;MAAAC,CAAA,EAAA,CAAAP,qBAAA,EAAAQ,UAAA;AAAA,KAAA,GAAAC,cAAA,CAAA,IAAA,EAAA,CAFCC,IAAI,CAACC,MAAM,CAAC;AAAEC,MAAAA,SAAS,EAAE,wBAAwB;AAAEC,MAAAA,MAAM,EAAE;KAAc,CAAC,MAKxEC,EAAE,EAAFA,EAAE,CAACC,OAAO,EACVL,IAAI,EAAJA,IAAI,CAACM,OAAO,CAAA,EAAA,EAAA,EAAA,OAAA,CAAA,EAAA,CAAA,CAUZC,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACC,WAAW,2BAQhBH,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACC,WAAW,CAAA,EAAA,EAAA,EAAA,OAAA,CAAA,EAAA,CAAA,CAmChBH,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACC,WAAW,CAAA,EAAA,EAAA,EAAA,mBAAA,CAAA,CAAA,EAAA,CAAA,EAAA,MAAA,EA7DyBlB,qBAA6B,CAAA;AAAA;AAGvE;AAGAmB,EAAAA,KAAK,IAAAf,UAAA,CAAA,IAAA,CAAA,EAAAF,WAAA,OAAG,KAAK,CAAA;;AAEb;AACA,EAAA,SAAS,IAAAC,iBAAA,CAAA,IAAA,CAAA,EAAG,EAAE;;AAEd;AACF;AACA;AACA;AAGEiB,EAAAA,aAAaA,GACb;AACE,IAAA,IAAI,CAAC,SAAS,CAACC,MAAM,GAAG,CAAC;IACzB,KAAK,CAACD,aAAa,EAAE;AACvB,EAAA;;AAEA;AAGAE,EAAAA,KAAKA,GACL;AACE,IAAA,KAAK,IAAIC,KAAK,GAAG,CAAC,EAAEA,KAAK,GAAG,IAAI,CAACC,QAAQ,CAACH,MAAM,EAAEE,KAAK,EAAE,EACzD;MACE,IAAI,CAACJ,KAAK,GAAG,IAAI,CAAC,SAAS,CAACI,KAAK,CAAC;MAClC,IAAI,CAACC,QAAQ,CAACD,KAAK,CAAC,EAAEE,SAAS,IAAI;AACrC,IAAA;IACA,IAAI,CAACL,aAAa,EAAE;AACtB,EAAA;;AAEA;AACF;AACA;AACA;AACA;EACEM,cAAcA,CAACC,iBAAiB,EAChC;IACE,IAAIR,KAAK,GAAG,KAAK;IACjB,IACA;AACEA,MAAAA,KAAK,GAAG,CAAC,CAACQ,iBAAiB,CAACC,QAAQ,EAAE;AACxC,IAAA,CAAC,CACD,MACA;AACET,MAAAA,KAAK,GAAG,KAAK;AACf,IAAA;AACA,IAAA,IAAI,CAAC,SAAS,CAACU,IAAI,CAACV,KAAK,CAAC;AAC1B,IAAA,OAAO,IAAI;AACb,EAAA;;AAEA;AACF;AACA;AACA;AAGEW,EAAAA,iBAAiBA,GACjB;AACE,IAAA,IAAI,CAACX,KAAK,GAAG,IAAI,CAAC,SAAS,CAACE,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,KAAK;AAChE,EAAA;AAAC,EAAA;IAAAf,UAAA,EAAA;AAAA;AAEH;;;;"}

package/dist/{generated/eve → eve}/socket/EveSocketParameterColor.js

@@ -1,14 +1,14 @@
-import { applyDecs2311 as _applyDecs2311 } from '../../../_virtual/_rollupPluginBabelHelpers.js';
+import { applyDecs2311 as _applyDecs2311 } from '../../_virtual/_rollupPluginBabelHelpers.js';
 import { vec4 } from '@carbonenginejs/runtime-utils/vec4';
 import { io, type, carbon, impl } from '@carbonenginejs/runtime-utils/schema';
 import { EveSocketParameterBindingBase as _EveSocketParameterBi } from './EveSocketParameterBindingBase.js';
 
 let _initProto, _initClass, _init_value, _init_extra_value;
 
-/**
- * EveSocketParameterColor (eve/socket) - SOCKET_PARAMETER_DEFINE(Color,
- * (0, 0, 0, 0)). Carbon's Color is four floats; the JS port carries it as a
- * vec4 like the org's other color values.
+/**
+ * EveSocketParameterColor (eve/socket) - SOCKET_PARAMETER_DEFINE(Color,
+ * (0, 0, 0, 0)). Carbon's Color is four floats; the JS port carries it as a
+ * vec4 like the org's other color values.
  */
 let _EveSocketParameterCo;
 class EveSocketParameterColor extends _EveSocketParameterBi {
@@ -26,6 +26,11 @@ class EveSocketParameterColor extends _EveSocketParameterBi {
 
   /** m_defaults - one default captured per bound external parameter. */
   #defaults = (_init_extra_value(this), []);
+
+  /**
+   * Discards the captured defaults along with the bindings, so nothing can be
+   * restored afterwards.
+   */
   ClearBindings() {
     this.#defaults.length = 0;
     super.ClearBindings();
@@ -39,6 +44,12 @@ class EveSocketParameterColor extends _EveSocketParameterBi {
     }
     this.ClearBindings();
   }
+
+  /**
+   * Captures a copy of the external parameter's current value as a default,
+   * keeping it at zero unless the source is a four-component value; always
+   * succeeds, so a bind is never refused on its account.
+   */
   ExtractDefault(externalParameter) {
     const value = vec4.create();
     try {
@@ -52,6 +63,11 @@ class EveSocketParameterColor extends _EveSocketParameterBi {
     this.#defaults.push(value);
     return true;
   }
+
+  /**
+   * Restores the first captured default into the existing value vector, or
+   * zeroes it when nothing was captured.
+   */
   SetValueToDefault() {
     if (this.#defaults.length) {
       vec4.copy(this.value, this.#defaults[0]);

package/dist/eve/socket/EveSocketParameterColor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EveSocketParameterColor.js","sources":["../../../../src/eve/socket/EveSocketParameterColor.js"],"sourcesContent":["// Ported from CarbonEngine (MIT, (c) 2026 CCP Games) - https://github.com/carbonengine/trinity\r\n//   trinity/trinity/Eve/SpaceObject/Children/SocketParameters/EveSocketParameter.h\r\n// Hand-authored following the eve/socket generated pattern (SOCKET_PARAM_DECLARE macro family).\r\nimport { vec4 } from \"@carbonenginejs/runtime-utils/vec4\";\r\nimport { carbon, impl, io, type } from \"@carbonenginejs/runtime-utils/schema\";\r\nimport { EveSocketParameterBindingBase } from \"./EveSocketParameterBindingBase.js\";\r\n\r\n/**\r\n * EveSocketParameterColor (eve/socket) - SOCKET_PARAMETER_DEFINE(Color,\r\n * (0, 0, 0, 0)). Carbon's Color is four floats; the JS port carries it as a\r\n * vec4 like the org's other color values.\r\n */\r\n@type.define({ className: \"EveSocketParameterColor\", family: \"eve/socket\" })\r\nexport class EveSocketParameterColor extends EveSocketParameterBindingBase\r\n{\r\n\r\n  /** m_value (Color) */\r\n  @io.persist\r\n  @type.vec4\r\n  value = vec4.create();\r\n\r\n  /** m_defaults - one default captured per bound external parameter. */\r\n  #defaults = [];\r\n\r\n  /**\r\n   * Discards the captured defaults along with the bindings, so nothing can be\r\n   * restored afterwards.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  ClearBindings()\r\n  {\r\n    this.#defaults.length = 0;\r\n    super.ClearBindings();\r\n  }\r\n\r\n  /** Restores every binding's default and copies it out, then clears. */\r\n  @carbon.method\r\n  @impl.implemented\r\n  Reset()\r\n  {\r\n    for (let index = 0; index < this.bindings.length; index++)\r\n    {\r\n      vec4.copy(this.value, this.#defaults[index]);\r\n      this.bindings[index]?.CopyValue?.();\r\n    }\r\n    this.ClearBindings();\r\n  }\r\n\r\n  /**\r\n   * Captures a copy of the external parameter's current value as a default,\r\n   * keeping it at zero unless the source is a four-component value; always\r\n   * succeeds, so a bind is never refused on its account.\r\n   */\r\n  ExtractDefault(externalParameter)\r\n  {\r\n    const value = vec4.create();\r\n    try\r\n    {\r\n      const source = externalParameter.GetValue();\r\n      if (source && typeof source.length === \"number\" && source.length >= 4)\r\n      {\r\n        vec4.copy(value, source);\r\n      }\r\n    }\r\n    catch\r\n    {\r\n      vec4.set(value, 0, 0, 0, 0);\r\n    }\r\n    this.#defaults.push(value);\r\n    return true;\r\n  }\r\n\r\n  /**\r\n   * Restores the first captured default into the existing value vector, or\r\n   * zeroes it when nothing was captured.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  SetValueToDefault()\r\n  {\r\n    if (this.#defaults.length)\r\n    {\r\n      vec4.copy(this.value, this.#defaults[0]);\r\n    }\r\n    else\r\n    {\r\n      vec4.set(this.value, 0, 0, 0, 0);\r\n    }\r\n  }\r\n\r\n}\r\n"],"names":["_EveSocketParameterCo","EveSocketParameterColor","EveSocketParameterBindingBase","e","_init_value","_init_extra_value","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","persist","vec4","carbon","method","impl","implemented","value","create","ClearBindings","length","Reset","index","bindings","copy","CopyValue","ExtractDefault","externalParameter","source","GetValue","set","push","SetValueToDefault"],"mappings":";;;;;;;AAOA;AACA;AACA;AACA;AACA;AAJA,IAAAA;AAKA,MAAAC,uBAAA,SAC6CC,qBAA6B,CAC1E;AAAA,EAAA;AAAA,IAAA,CAAA;AAAAC,MAAAA,CAAA,EAAA,CAAAC,WAAA,EAAAC,iBAAA,EAAAC,UAAA,CAAA;MAAAC,CAAA,EAAA,CAAAP,qBAAA,EAAAQ,UAAA;AAAA,KAAA,GAAAC,cAAA,CAAA,IAAA,EAAA,CAFCC,IAAI,CAACC,MAAM,CAAC;AAAEC,MAAAA,SAAS,EAAE,yBAAyB;AAAEC,MAAAA,MAAM,EAAE;KAAc,CAAC,MAKzEC,EAAE,EAAFA,EAAE,CAACC,OAAO,EACVL,IAAI,EAAJA,IAAI,CAACM,IAAI,CAAA,EAAA,EAAA,EAAA,OAAA,CAAA,EAAA,CAAA,CAUTC,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACC,WAAW,2BAQhBH,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACC,WAAW,CAAA,EAAA,EAAA,EAAA,OAAA,CAAA,EAAA,CAAA,CAuChBH,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACC,WAAW,CAAA,EAAA,EAAA,EAAA,mBAAA,CAAA,CAAA,EAAA,CAAA,EAAA,MAAA,EAjE0BlB,qBAA6B,CAAA;AAAA;AAGxE;EAGAmB,KAAK,IAAAf,UAAA,CAAA,IAAA,CAAA,EAAAF,WAAA,OAAGY,IAAI,CAACM,MAAM,EAAE,CAAA;;AAErB;AACA,EAAA,SAAS,IAAAjB,iBAAA,CAAA,IAAA,CAAA,EAAG,EAAE;;AAEd;AACF;AACA;AACA;AAGEkB,EAAAA,aAAaA,GACb;AACE,IAAA,IAAI,CAAC,SAAS,CAACC,MAAM,GAAG,CAAC;IACzB,KAAK,CAACD,aAAa,EAAE;AACvB,EAAA;;AAEA;AAGAE,EAAAA,KAAKA,GACL;AACE,IAAA,KAAK,IAAIC,KAAK,GAAG,CAAC,EAAEA,KAAK,GAAG,IAAI,CAACC,QAAQ,CAACH,MAAM,EAAEE,KAAK,EAAE,EACzD;AACEV,MAAAA,IAAI,CAACY,IAAI,CAAC,IAAI,CAACP,KAAK,EAAE,IAAI,CAAC,SAAS,CAACK,KAAK,CAAC,CAAC;MAC5C,IAAI,CAACC,QAAQ,CAACD,KAAK,CAAC,EAAEG,SAAS,IAAI;AACrC,IAAA;IACA,IAAI,CAACN,aAAa,EAAE;AACtB,EAAA;;AAEA;AACF;AACA;AACA;AACA;EACEO,cAAcA,CAACC,iBAAiB,EAChC;AACE,IAAA,MAAMV,KAAK,GAAGL,IAAI,CAACM,MAAM,EAAE;IAC3B,IACA;AACE,MAAA,MAAMU,MAAM,GAAGD,iBAAiB,CAACE,QAAQ,EAAE;AAC3C,MAAA,IAAID,MAAM,IAAI,OAAOA,MAAM,CAACR,MAAM,KAAK,QAAQ,IAAIQ,MAAM,CAACR,MAAM,IAAI,CAAC,EACrE;AACER,QAAAA,IAAI,CAACY,IAAI,CAACP,KAAK,EAAEW,MAAM,CAAC;AAC1B,MAAA;AACF,IAAA,CAAC,CACD,MACA;AACEhB,MAAAA,IAAI,CAACkB,GAAG,CAACb,KAAK,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;AAC7B,IAAA;AACA,IAAA,IAAI,CAAC,SAAS,CAACc,IAAI,CAACd,KAAK,CAAC;AAC1B,IAAA,OAAO,IAAI;AACb,EAAA;;AAEA;AACF;AACA;AACA;AAGEe,EAAAA,iBAAiBA,GACjB;AACE,IAAA,IAAI,IAAI,CAAC,SAAS,CAACZ,MAAM,EACzB;AACER,MAAAA,IAAI,CAACY,IAAI,CAAC,IAAI,CAACP,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;AAC1C,IAAA,CAAC,MAED;AACEL,MAAAA,IAAI,CAACkB,GAAG,CAAC,IAAI,CAACb,KAAK,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;AAClC,IAAA;AACF,EAAA;AAAC,EAAA;IAAAb,UAAA,EAAA;AAAA;AAEH;;;;"}

package/dist/eve/socket/EveSocketParameterFilePath.js

@@ -1,13 +1,13 @@
 import { applyDecs2311 as _applyDecs2311 } from '../../_virtual/_rollupPluginBabelHelpers.js';
 import { type } from '@carbonenginejs/runtime-utils/schema';
-import { EveSocketParameterString as _EveSocketParameterSt } from '../../generated/eve/socket/EveSocketParameterString.js';
+import { EveSocketParameterString as _EveSocketParameterSt } from './EveSocketParameterString.js';
 
 let _initClass;
 
-/**
- * EveSocketParameterFilePath (eve/socket) - Carbon derives it from
- * EveSocketParameterString with no members of its own (only the editor
- * widget differs).
+/**
+ * EveSocketParameterFilePath (eve/socket) - Carbon derives it from
+ * EveSocketParameterString with no members of its own (only the editor
+ * widget differs).
  */
 let _EveSocketParameterFi;
 class EveSocketParameterFilePath extends _EveSocketParameterSt {

package/dist/eve/socket/EveSocketParameterFilePath.js.map

@@ -1 +1 @@
-{"version":3,"file":"EveSocketParameterFilePath.js","sources":["../../../../src/eve/socket/EveSocketParameterFilePath.js"],"sourcesContent":["// Ported from CarbonEngine (MIT, (c) 2026 CCP Games) - https://github.com/carbonengine/trinity\n//   trinity/trinity/Eve/SpaceObject/Children/SocketParameters/EveSocketParameter.h\n// Hand-authored following the eve/socket generated pattern.\nimport { type } from \"@carbonenginejs/runtime-utils/schema\";\nimport { EveSocketParameterString } from \"../../generated/eve/socket/EveSocketParameterString.js\";\n\n/**\n * EveSocketParameterFilePath (eve/socket) - Carbon derives it from\n * EveSocketParameterString with no members of its own (only the editor\n * widget differs).\n */\n@type.define({ className: \"EveSocketParameterFilePath\", family: \"eve/socket\" })\nexport class EveSocketParameterFilePath extends EveSocketParameterString\n{\n}\n"],"names":["_EveSocketParameterFi","EveSocketParameterFilePath","EveSocketParameterString","_initClass","_applyDecs","type","define","className","family","c"],"mappings":";;;;;;AAMA;AACA;AACA;AACA;AACA;AAJA,IAAAA;AAKA,MAAAC,0BAAA,SACgDC,qBAAwB,CACxE;AAAA,EAAA;IAAA,CAAAF,qBAAA,EAAAG,UAAA,CAAA,GAAAC,cAAA,CAAA,IAAA,EAAA,CAFCC,IAAI,CAACC,MAAM,CAAC;AAAEC,MAAAA,SAAS,EAAE,4BAA4B;AAAEC,MAAAA,MAAM,EAAE;AAAa,KAAC,CAAC,CAAA,EAAA,EAAA,EAAA,CAAA,EAAA,MAAA,EAC/BN,qBAAwB,CAAA,CAAAO,CAAA;AAAA;AAAA,EAAA;IAAAN,UAAA,EAAA;AAAA;AAExE;;;;"}
+{"version":3,"file":"EveSocketParameterFilePath.js","sources":["../../../../src/eve/socket/EveSocketParameterFilePath.js"],"sourcesContent":["// Ported from CarbonEngine (MIT, (c) 2026 CCP Games) - https://github.com/carbonengine/trinity\r\n//   trinity/trinity/Eve/SpaceObject/Children/SocketParameters/EveSocketParameter.h\r\n// Hand-authored following the eve/socket generated pattern.\r\nimport { type } from \"@carbonenginejs/runtime-utils/schema\";\r\nimport { EveSocketParameterString } from \"./EveSocketParameterString.js\";\r\n\r\n/**\r\n * EveSocketParameterFilePath (eve/socket) - Carbon derives it from\r\n * EveSocketParameterString with no members of its own (only the editor\r\n * widget differs).\r\n */\r\n@type.define({ className: \"EveSocketParameterFilePath\", family: \"eve/socket\" })\r\nexport class EveSocketParameterFilePath extends EveSocketParameterString\r\n{\r\n}\r\n"],"names":["_EveSocketParameterFi","EveSocketParameterFilePath","EveSocketParameterString","_initClass","_applyDecs","type","define","className","family","c"],"mappings":";;;;;;AAMA;AACA;AACA;AACA;AACA;AAJA,IAAAA;AAKA,MAAAC,0BAAA,SACgDC,qBAAwB,CACxE;AAAA,EAAA;IAAA,CAAAF,qBAAA,EAAAG,UAAA,CAAA,GAAAC,cAAA,CAAA,IAAA,EAAA,CAFCC,IAAI,CAACC,MAAM,CAAC;AAAEC,MAAAA,SAAS,EAAE,4BAA4B;AAAEC,MAAAA,MAAM,EAAE;AAAa,KAAC,CAAC,CAAA,EAAA,EAAA,EAAA,CAAA,EAAA,MAAA,EAC/BN,qBAAwB,CAAA,CAAAO,CAAA;AAAA;AAAA,EAAA;IAAAN,UAAA,EAAA;AAAA;AAExE;;;;"}

package/dist/{generated/eve → eve}/socket/EveSocketParameterFloat.js

@@ -1,4 +1,4 @@
-import { applyDecs2311 as _applyDecs2311 } from '../../../_virtual/_rollupPluginBabelHelpers.js';
+import { applyDecs2311 as _applyDecs2311 } from '../../_virtual/_rollupPluginBabelHelpers.js';
 import { io, type, carbon, impl } from '@carbonenginejs/runtime-utils/schema';
 import { EveSocketParameterBindingBase as _EveSocketParameterBi } from './EveSocketParameterBindingBase.js';
 
@@ -21,6 +21,11 @@ class EveSocketParameterFloat extends _EveSocketParameterBi {
 
   /** m_defaults - one default captured per bound external parameter. */
   #defaults = (_init_extra_value(this), []);
+
+  /**
+   * Discards the captured defaults along with the bindings, so nothing can be
+   * restored afterwards.
+   */
   ClearBindings() {
     this.#defaults.length = 0;
     super.ClearBindings();
@@ -34,6 +39,12 @@ class EveSocketParameterFloat extends _EveSocketParameterBi {
     }
     this.ClearBindings();
   }
+
+  /**
+   * Captures the external parameter's current value as a numeric default,
+   * substituting 0 when the read throws or is not finite; always succeeds, so a
+   * bind is never refused on its account.
+   */
   ExtractDefault(externalParameter) {
     let value = 0;
     try {
@@ -44,6 +55,11 @@ class EveSocketParameterFloat extends _EveSocketParameterBi {
     this.#defaults.push(Number.isFinite(value) ? value : 0);
     return true;
   }
+
+  /**
+   * Restores the first captured default, falling back to 0 when nothing was
+   * captured.
+   */
   SetValueToDefault() {
     this.value = this.#defaults.length ? this.#defaults[0] : 0;
   }

package/dist/eve/socket/EveSocketParameterFloat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EveSocketParameterFloat.js","sources":["../../../../src/eve/socket/EveSocketParameterFloat.js"],"sourcesContent":["// Ported from CarbonEngine (MIT, (c) 2026 CCP Games) - https://github.com/carbonengine/trinity\r\n//   trinity/trinity/Eve/SpaceObject/Children/SocketParameters/EveSocketParameter.h\r\n// Hand-authored following the eve/socket generated pattern (SOCKET_PARAM_DECLARE macro family).\r\nimport { carbon, impl, io, type } from \"@carbonenginejs/runtime-utils/schema\";\r\nimport { EveSocketParameterBindingBase } from \"./EveSocketParameterBindingBase.js\";\r\n\r\n/** EveSocketParameterFloat (eve/socket) - SOCKET_PARAMETER_DEFINE(float, 0.0f). */\r\n@type.define({ className: \"EveSocketParameterFloat\", family: \"eve/socket\" })\r\nexport class EveSocketParameterFloat extends EveSocketParameterBindingBase\r\n{\r\n\r\n  /** m_value (float) */\r\n  @io.persist\r\n  @type.float32\r\n  value = 0;\r\n\r\n  /** m_defaults - one default captured per bound external parameter. */\r\n  #defaults = [];\r\n\r\n  /**\r\n   * Discards the captured defaults along with the bindings, so nothing can be\r\n   * restored afterwards.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  ClearBindings()\r\n  {\r\n    this.#defaults.length = 0;\r\n    super.ClearBindings();\r\n  }\r\n\r\n  /** Restores every binding's default and copies it out, then clears. */\r\n  @carbon.method\r\n  @impl.implemented\r\n  Reset()\r\n  {\r\n    for (let index = 0; index < this.bindings.length; index++)\r\n    {\r\n      this.value = this.#defaults[index];\r\n      this.bindings[index]?.CopyValue?.();\r\n    }\r\n    this.ClearBindings();\r\n  }\r\n\r\n  /**\r\n   * Captures the external parameter's current value as a numeric default,\r\n   * substituting 0 when the read throws or is not finite; always succeeds, so a\r\n   * bind is never refused on its account.\r\n   */\r\n  ExtractDefault(externalParameter)\r\n  {\r\n    let value = 0;\r\n    try\r\n    {\r\n      value = Number(externalParameter.GetValue());\r\n    }\r\n    catch\r\n    {\r\n      value = 0;\r\n    }\r\n    this.#defaults.push(Number.isFinite(value) ? value : 0);\r\n    return true;\r\n  }\r\n\r\n  /**\r\n   * Restores the first captured default, falling back to 0 when nothing was\r\n   * captured.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  SetValueToDefault()\r\n  {\r\n    this.value = this.#defaults.length ? this.#defaults[0] : 0;\r\n  }\r\n\r\n}\r\n"],"names":["_EveSocketParameterFl","EveSocketParameterFloat","EveSocketParameterBindingBase","e","_init_value","_init_extra_value","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","persist","float32","carbon","method","impl","implemented","value","ClearBindings","length","Reset","index","bindings","CopyValue","ExtractDefault","externalParameter","Number","GetValue","push","isFinite","SetValueToDefault"],"mappings":";;;;;;AAMA;AAAA,IAAAA;AACA,MAAAC,uBAAA,SAC6CC,qBAA6B,CAC1E;AAAA,EAAA;AAAA,IAAA,CAAA;AAAAC,MAAAA,CAAA,EAAA,CAAAC,WAAA,EAAAC,iBAAA,EAAAC,UAAA,CAAA;MAAAC,CAAA,EAAA,CAAAP,qBAAA,EAAAQ,UAAA;AAAA,KAAA,GAAAC,cAAA,CAAA,IAAA,EAAA,CAFCC,IAAI,CAACC,MAAM,CAAC;AAAEC,MAAAA,SAAS,EAAE,yBAAyB;AAAEC,MAAAA,MAAM,EAAE;KAAc,CAAC,MAKzEC,EAAE,EAAFA,EAAE,CAACC,OAAO,EACVL,IAAI,EAAJA,IAAI,CAACM,OAAO,CAAA,EAAA,EAAA,EAAA,OAAA,CAAA,EAAA,CAAA,CAUZC,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACC,WAAW,2BAQhBH,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACC,WAAW,CAAA,EAAA,EAAA,EAAA,OAAA,CAAA,EAAA,CAAA,CAmChBH,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACC,WAAW,CAAA,EAAA,EAAA,EAAA,mBAAA,CAAA,CAAA,EAAA,CAAA,EAAA,MAAA,EA7D0BlB,qBAA6B,CAAA;AAAA;AAGxE;AAGAmB,EAAAA,KAAK,IAAAf,UAAA,CAAA,IAAA,CAAA,EAAAF,WAAA,OAAG,CAAC,CAAA;;AAET;AACA,EAAA,SAAS,IAAAC,iBAAA,CAAA,IAAA,CAAA,EAAG,EAAE;;AAEd;AACF;AACA;AACA;AAGEiB,EAAAA,aAAaA,GACb;AACE,IAAA,IAAI,CAAC,SAAS,CAACC,MAAM,GAAG,CAAC;IACzB,KAAK,CAACD,aAAa,EAAE;AACvB,EAAA;;AAEA;AAGAE,EAAAA,KAAKA,GACL;AACE,IAAA,KAAK,IAAIC,KAAK,GAAG,CAAC,EAAEA,KAAK,GAAG,IAAI,CAACC,QAAQ,CAACH,MAAM,EAAEE,KAAK,EAAE,EACzD;MACE,IAAI,CAACJ,KAAK,GAAG,IAAI,CAAC,SAAS,CAACI,KAAK,CAAC;MAClC,IAAI,CAACC,QAAQ,CAACD,KAAK,CAAC,EAAEE,SAAS,IAAI;AACrC,IAAA;IACA,IAAI,CAACL,aAAa,EAAE;AACtB,EAAA;;AAEA;AACF;AACA;AACA;AACA;EACEM,cAAcA,CAACC,iBAAiB,EAChC;IACE,IAAIR,KAAK,GAAG,CAAC;IACb,IACA;MACEA,KAAK,GAAGS,MAAM,CAACD,iBAAiB,CAACE,QAAQ,EAAE,CAAC;AAC9C,IAAA,CAAC,CACD,MACA;AACEV,MAAAA,KAAK,GAAG,CAAC;AACX,IAAA;AACA,IAAA,IAAI,CAAC,SAAS,CAACW,IAAI,CAACF,MAAM,CAACG,QAAQ,CAACZ,KAAK,CAAC,GAAGA,KAAK,GAAG,CAAC,CAAC;AACvD,IAAA,OAAO,IAAI;AACb,EAAA;;AAEA;AACF;AACA;AACA;AAGEa,EAAAA,iBAAiBA,GACjB;AACE,IAAA,IAAI,CAACb,KAAK,GAAG,IAAI,CAAC,SAAS,CAACE,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC;AAC5D,EAAA;AAAC,EAAA;IAAAf,UAAA,EAAA;AAAA;AAEH;;;;"}

package/dist/{generated/eve → eve}/socket/EveSocketParameterInt.js

@@ -1,4 +1,4 @@
-import { applyDecs2311 as _applyDecs2311 } from '../../../_virtual/_rollupPluginBabelHelpers.js';
+import { applyDecs2311 as _applyDecs2311 } from '../../_virtual/_rollupPluginBabelHelpers.js';
 import { io, type, carbon, impl } from '@carbonenginejs/runtime-utils/schema';
 import { EveSocketParameterBindingBase as _EveSocketParameterBi } from './EveSocketParameterBindingBase.js';
 
@@ -21,6 +21,11 @@ class EveSocketParameterInt extends _EveSocketParameterBi {
 
   /** m_defaults - one default captured per bound external parameter. */
   #defaults = (_init_extra_value(this), []);
+
+  /**
+   * Discards the captured defaults along with the bindings, so nothing can be
+   * restored afterwards.
+   */
   ClearBindings() {
     this.#defaults.length = 0;
     super.ClearBindings();
@@ -34,6 +39,12 @@ class EveSocketParameterInt extends _EveSocketParameterBi {
     }
     this.ClearBindings();
   }
+
+  /**
+   * Captures the external parameter's current value as an integer default,
+   * truncating to 32 bits and substituting 0 when the read throws; always
+   * succeeds, so a bind is never refused on its account.
+   */
   ExtractDefault(externalParameter) {
     let value = 0;
     try {
@@ -44,6 +55,11 @@ class EveSocketParameterInt extends _EveSocketParameterBi {
     this.#defaults.push(Number.isFinite(value) ? value : 0);
     return true;
   }
+
+  /**
+   * Restores the first captured default, falling back to 0 when nothing was
+   * captured.
+   */
   SetValueToDefault() {
     this.value = this.#defaults.length ? this.#defaults[0] : 0;
   }

package/dist/eve/socket/EveSocketParameterInt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EveSocketParameterInt.js","sources":["../../../../src/eve/socket/EveSocketParameterInt.js"],"sourcesContent":["// Ported from CarbonEngine (MIT, (c) 2026 CCP Games) - https://github.com/carbonengine/trinity\r\n//   trinity/trinity/Eve/SpaceObject/Children/SocketParameters/EveSocketParameter.h\r\n// Hand-authored following the eve/socket generated pattern (SOCKET_PARAM_DECLARE macro family).\r\nimport { carbon, impl, io, type } from \"@carbonenginejs/runtime-utils/schema\";\r\nimport { EveSocketParameterBindingBase } from \"./EveSocketParameterBindingBase.js\";\r\n\r\n/** EveSocketParameterInt (eve/socket) - SOCKET_PARAMETER_DEFINE(int, 0). */\r\n@type.define({ className: \"EveSocketParameterInt\", family: \"eve/socket\" })\r\nexport class EveSocketParameterInt extends EveSocketParameterBindingBase\r\n{\r\n\r\n  /** m_value (int32_t) */\r\n  @io.persist\r\n  @type.int32\r\n  value = 0;\r\n\r\n  /** m_defaults - one default captured per bound external parameter. */\r\n  #defaults = [];\r\n\r\n  /**\r\n   * Discards the captured defaults along with the bindings, so nothing can be\r\n   * restored afterwards.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  ClearBindings()\r\n  {\r\n    this.#defaults.length = 0;\r\n    super.ClearBindings();\r\n  }\r\n\r\n  /** Restores every binding's default and copies it out, then clears. */\r\n  @carbon.method\r\n  @impl.implemented\r\n  Reset()\r\n  {\r\n    for (let index = 0; index < this.bindings.length; index++)\r\n    {\r\n      this.value = this.#defaults[index];\r\n      this.bindings[index]?.CopyValue?.();\r\n    }\r\n    this.ClearBindings();\r\n  }\r\n\r\n  /**\r\n   * Captures the external parameter's current value as an integer default,\r\n   * truncating to 32 bits and substituting 0 when the read throws; always\r\n   * succeeds, so a bind is never refused on its account.\r\n   */\r\n  ExtractDefault(externalParameter)\r\n  {\r\n    let value = 0;\r\n    try\r\n    {\r\n      value = Number(externalParameter.GetValue()) | 0;\r\n    }\r\n    catch\r\n    {\r\n      value = 0;\r\n    }\r\n    this.#defaults.push(Number.isFinite(value) ? value : 0);\r\n    return true;\r\n  }\r\n\r\n  /**\r\n   * Restores the first captured default, falling back to 0 when nothing was\r\n   * captured.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  SetValueToDefault()\r\n  {\r\n    this.value = this.#defaults.length ? this.#defaults[0] : 0;\r\n  }\r\n\r\n}\r\n"],"names":["_EveSocketParameterIn","EveSocketParameterInt","EveSocketParameterBindingBase","e","_init_value","_init_extra_value","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","persist","int32","carbon","method","impl","implemented","value","ClearBindings","length","Reset","index","bindings","CopyValue","ExtractDefault","externalParameter","Number","GetValue","push","isFinite","SetValueToDefault"],"mappings":";;;;;;AAMA;AAAA,IAAAA;AACA,MAAAC,qBAAA,SAC2CC,qBAA6B,CACxE;AAAA,EAAA;AAAA,IAAA,CAAA;AAAAC,MAAAA,CAAA,EAAA,CAAAC,WAAA,EAAAC,iBAAA,EAAAC,UAAA,CAAA;MAAAC,CAAA,EAAA,CAAAP,qBAAA,EAAAQ,UAAA;AAAA,KAAA,GAAAC,cAAA,CAAA,IAAA,EAAA,CAFCC,IAAI,CAACC,MAAM,CAAC;AAAEC,MAAAA,SAAS,EAAE,uBAAuB;AAAEC,MAAAA,MAAM,EAAE;KAAc,CAAC,MAKvEC,EAAE,EAAFA,EAAE,CAACC,OAAO,EACVL,IAAI,EAAJA,IAAI,CAACM,KAAK,CAAA,EAAA,EAAA,EAAA,OAAA,CAAA,EAAA,CAAA,CAUVC,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACC,WAAW,2BAQhBH,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACC,WAAW,CAAA,EAAA,EAAA,EAAA,OAAA,CAAA,EAAA,CAAA,CAmChBH,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACC,WAAW,CAAA,EAAA,EAAA,EAAA,mBAAA,CAAA,CAAA,EAAA,CAAA,EAAA,MAAA,EA7DwBlB,qBAA6B,CAAA;AAAA;AAGtE;AAGAmB,EAAAA,KAAK,IAAAf,UAAA,CAAA,IAAA,CAAA,EAAAF,WAAA,OAAG,CAAC,CAAA;;AAET;AACA,EAAA,SAAS,IAAAC,iBAAA,CAAA,IAAA,CAAA,EAAG,EAAE;;AAEd;AACF;AACA;AACA;AAGEiB,EAAAA,aAAaA,GACb;AACE,IAAA,IAAI,CAAC,SAAS,CAACC,MAAM,GAAG,CAAC;IACzB,KAAK,CAACD,aAAa,EAAE;AACvB,EAAA;;AAEA;AAGAE,EAAAA,KAAKA,GACL;AACE,IAAA,KAAK,IAAIC,KAAK,GAAG,CAAC,EAAEA,KAAK,GAAG,IAAI,CAACC,QAAQ,CAACH,MAAM,EAAEE,KAAK,EAAE,EACzD;MACE,IAAI,CAACJ,KAAK,GAAG,IAAI,CAAC,SAAS,CAACI,KAAK,CAAC;MAClC,IAAI,CAACC,QAAQ,CAACD,KAAK,CAAC,EAAEE,SAAS,IAAI;AACrC,IAAA;IACA,IAAI,CAACL,aAAa,EAAE;AACtB,EAAA;;AAEA;AACF;AACA;AACA;AACA;EACEM,cAAcA,CAACC,iBAAiB,EAChC;IACE,IAAIR,KAAK,GAAG,CAAC;IACb,IACA;MACEA,KAAK,GAAGS,MAAM,CAACD,iBAAiB,CAACE,QAAQ,EAAE,CAAC,GAAG,CAAC;AAClD,IAAA,CAAC,CACD,MACA;AACEV,MAAAA,KAAK,GAAG,CAAC;AACX,IAAA;AACA,IAAA,IAAI,CAAC,SAAS,CAACW,IAAI,CAACF,MAAM,CAACG,QAAQ,CAACZ,KAAK,CAAC,GAAGA,KAAK,GAAG,CAAC,CAAC;AACvD,IAAA,OAAO,IAAI;AACb,EAAA;;AAEA;AACF;AACA;AACA;AAGEa,EAAAA,iBAAiBA,GACjB;AACE,IAAA,IAAI,CAACb,KAAK,GAAG,IAAI,CAAC,SAAS,CAACE,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC;AAC5D,EAAA;AAAC,EAAA;IAAAf,UAAA,EAAA;AAAA;AAEH;;;;"}

package/dist/{generated/eve → eve}/socket/EveSocketParameterString.js

@@ -1,7 +1,7 @@
-import { applyDecs2311 as _applyDecs2311 } from '../../../_virtual/_rollupPluginBabelHelpers.js';
+import { applyDecs2311 as _applyDecs2311 } from '../../_virtual/_rollupPluginBabelHelpers.js';
 import { io, type, carbon, impl } from '@carbonenginejs/runtime-utils/schema';
 import { CjsModel } from '@carbonenginejs/runtime-utils/model';
-import { Tr2ExternalParameter as _Tr2ExternalParameter } from '../../trinityCore/Tr2ExternalParameter.js';
+import { Tr2ExternalParameter as _Tr2ExternalParameter } from '../../trinityCore/binding/Tr2ExternalParameter.js';
 
 let _initProto, _initClass, _init_name, _init_extra_name, _init_value, _init_extra_value, _init_valueExposure, _init_extra_valueExposure, _init_externalParameters, _init_extra_externalParameters, _init_defaults, _init_extra_defaults;
 
@@ -35,12 +35,24 @@ class EveSocketParameterString extends CjsModel {
 
   /** m_defaults (std::vector<std::string>) */
   defaults = (_init_extra_externalParameters(this), _init_defaults(this, []));
+
+  /** Returns the name an external parameter has to match before it can bind here. */
   GetName() {
     return this.name;
   }
+
+  /**
+   * Sets the name external parameters must match to bind, coercing null to an
+   * empty string.
+   */
   SetName(name) {
     this.name = String(name ?? "");
   }
+
+  /**
+   * Creates the `valueExposure` external parameter pointing at this object's
+   * `value` attribute on first call; later calls leave the existing one alone.
+   */
   Initialize() {
     if (!this.valueExposure) {
       this.valueExposure = new _Tr2ExternalParameter();
@@ -51,9 +63,20 @@ class EveSocketParameterString extends CjsModel {
     }
     return true;
   }
+
+  /**
+   * Drops the bound external parameters; unlike the typed socket parameters, the
+   * captured defaults are kept.
+   */
   ClearBindings() {
     this.externalParameters.length = 0;
   }
+
+  /**
+   * Records a matching external parameter after capturing its current value as a default; strings are held directly instead of through a value binding, and propagation writes to them.
+   *
+   * @returns {boolean} True when the external parameter was valid, name-matched and stored.
+   */
   BindToExternalParameter(externalParameter) {
     this.Initialize();
     if (!externalParameter?.IsValid?.() || externalParameter.GetName?.() !== this.name) return false;
@@ -61,6 +84,11 @@ class EveSocketParameterString extends CjsModel {
     this.externalParameters.push(externalParameter);
     return true;
   }
+
+  /**
+   * Captures the external parameter's current value as a string default,
+   * substituting an empty string when the read throws; always succeeds.
+   */
   ExtractDefault(externalParameter) {
     let value = "";
     try {
@@ -71,12 +99,24 @@ class EveSocketParameterString extends CjsModel {
     this.defaults.push(value);
     return true;
   }
+
+  /**
+   * Restores the default captured for the first bound external parameter,
+   * leaving the value untouched when none was captured.
+   */
   SetValueToDefault() {
     if (this.defaults.length) this.value = this.defaults[0];
   }
+
+  /** Reports whether any external parameter is bound to this one. */
   Used() {
     return this.externalParameters.length !== 0;
   }
+
+  /**
+   * Reads the current value through `valueExposure` and writes it into every
+   * bound external parameter.
+   */
   Propagate() {
     this.Initialize();
     if (!this.valueExposure.IsValid()) return;

package/dist/eve/socket/EveSocketParameterString.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EveSocketParameterString.js","sources":["../../../../src/eve/socket/EveSocketParameterString.js"],"sourcesContent":["// Ported from CarbonEngine (MIT, (c) 2026 CCP Games) - https://github.com/carbonengine/trinity\r\n//   trinity/trinity/Eve/SpaceObject/Children/SocketParameters/EveSocketParameter.h\r\n// Generated by format-carbon carbon-class --emit. Verify against eve/socket/EveSocketParameterString.json.\r\nimport { carbon, impl, io, type } from \"@carbonenginejs/runtime-utils/schema\";\r\nimport { CjsModel } from \"@carbonenginejs/runtime-utils/model\";\r\nimport { Tr2ExternalParameter } from \"../../trinityCore/binding/Tr2ExternalParameter.js\";\r\n\r\n/** EveSocketParameterString (eve/socket) - generated from schema shapeHash d055ced5.... */\r\n@type.define({ className: \"EveSocketParameterString\", family: \"eve/socket\" })\r\nexport class EveSocketParameterString extends CjsModel\r\n{\r\n\r\n  /** m_name (std::string) */\r\n  @io.persist\r\n  @type.string\r\n  name = \"\";\r\n\r\n  /** m_value (std::string) */\r\n  @io.persist\r\n  @type.string\r\n  value = \"\";\r\n\r\n  /** m_valueExposure (Tr2ExternalParameterPtr) */\r\n  @type.objectRef(\"Tr2ExternalParameter\")\r\n  valueExposure = null;\r\n\r\n  /** m_externalParameters (PTr2ExternalParameterVector) */\r\n  @type.list(\"Tr2ExternalParameter\")\r\n  externalParameters = [];\r\n\r\n  /** m_defaults (std::vector<std::string>) */\r\n  @type.list(\"std::string\")\r\n  defaults = [];\r\n\r\n  /** Returns the name an external parameter has to match before it can bind here. */\r\n  GetName()\r\n  {\r\n    return this.name;\r\n  }\r\n\r\n  /**\r\n   * Sets the name external parameters must match to bind, coercing null to an\r\n   * empty string.\r\n   */\r\n  SetName(name)\r\n  {\r\n    this.name = String(name ?? \"\");\r\n  }\r\n\r\n  /**\r\n   * Creates the `valueExposure` external parameter pointing at this object's\r\n   * `value` attribute on first call; later calls leave the existing one alone.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  Initialize()\r\n  {\r\n    if (!this.valueExposure)\r\n    {\r\n      this.valueExposure = new Tr2ExternalParameter();\r\n      this.valueExposure.SetName(\"valueExposure\");\r\n      this.valueExposure.SetDestinationObject(this);\r\n      this.valueExposure.SetDestinationAttribute(\"value\");\r\n      this.valueExposure.Initialize();\r\n    }\r\n    return true;\r\n  }\r\n\r\n  /**\r\n   * Drops the bound external parameters; unlike the typed socket parameters, the\r\n   * captured defaults are kept.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  ClearBindings()\r\n  {\r\n    this.externalParameters.length = 0;\r\n  }\r\n\r\n  /**\r\n   * Records a matching external parameter after capturing its current value as a default; strings are held directly instead of through a value binding, and propagation writes to them.\r\n   *\r\n   * @returns {boolean} True when the external parameter was valid, name-matched and stored.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  BindToExternalParameter(externalParameter)\r\n  {\r\n    this.Initialize();\r\n    if (!externalParameter?.IsValid?.() || externalParameter.GetName?.() !== this.name) return false;\r\n    if (!this.ExtractDefault(externalParameter)) return false;\r\n    this.externalParameters.push(externalParameter);\r\n    return true;\r\n  }\r\n\r\n  /**\r\n   * Captures the external parameter's current value as a string default,\r\n   * substituting an empty string when the read throws; always succeeds.\r\n   */\r\n  ExtractDefault(externalParameter)\r\n  {\r\n    let value = \"\";\r\n    try\r\n    {\r\n      value = String(externalParameter.GetValue());\r\n    }\r\n    catch\r\n    {\r\n      value = \"\";\r\n    }\r\n    this.defaults.push(value);\r\n    return true;\r\n  }\r\n\r\n  /**\r\n   * Restores the default captured for the first bound external parameter,\r\n   * leaving the value untouched when none was captured.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  SetValueToDefault()\r\n  {\r\n    if (this.defaults.length) this.value = this.defaults[0];\r\n  }\r\n\r\n  /** Reports whether any external parameter is bound to this one. */\r\n  @carbon.method\r\n  @impl.implemented\r\n  Used()\r\n  {\r\n    return this.externalParameters.length !== 0;\r\n  }\r\n\r\n  /**\r\n   * Reads the current value through `valueExposure` and writes it into every\r\n   * bound external parameter.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  Propagate()\r\n  {\r\n    this.Initialize();\r\n    if (!this.valueExposure.IsValid()) return;\r\n    const value = this.valueExposure.GetValue();\r\n    for (const externalParameter of this.externalParameters) externalParameter?.SetValue?.(value);\r\n  }\r\n\r\n}\r\n"],"names":["_EveSocketParameterSt","EveSocketParameterString","CjsModel","e","_init_name","_init_extra_name","_init_value","_init_extra_value","_init_valueExposure","_init_extra_valueExposure","_init_externalParameters","_init_extra_externalParameters","_init_defaults","_init_extra_defaults","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","persist","string","objectRef","list","carbon","method","impl","adapted","implemented","constructor","args","name","value","valueExposure","externalParameters","defaults","GetName","SetName","String","Initialize","Tr2ExternalParameter","SetDestinationObject","SetDestinationAttribute","ClearBindings","length","BindToExternalParameter","externalParameter","IsValid","ExtractDefault","push","GetValue","SetValueToDefault","Used","Propagate","SetValue"],"mappings":";;;;;;;AAOA;AAAA,IAAAA;AACA,MAAAC,wBAAA,SAC8CC,QAAQ,CACtD;AAAA,EAAA;AAAA,IAAA,CAAA;MAAAC,CAAA,EAAA,CAAAC,UAAA,EAAAC,gBAAA,EAAAC,WAAA,EAAAC,iBAAA,EAAAC,mBAAA,EAAAC,yBAAA,EAAAC,wBAAA,EAAAC,8BAAA,EAAAC,cAAA,EAAAC,oBAAA,EAAAC,UAAA,CAAA;MAAAC,CAAA,EAAA,CAAAf,qBAAA,EAAAgB,UAAA;AAAA,KAAA,GAAAC,cAAA,CAAA,IAAA,EAAA,CAFCC,IAAI,CAACC,MAAM,CAAC;AAAEC,MAAAA,SAAS,EAAE,0BAA0B;AAAEC,MAAAA,MAAM,EAAE;KAAc,CAAC,CAAA,EAAA,CAAA,CAAA,CAK1EC,EAAE,EAAFA,EAAE,CAACC,OAAO,EACVL,IAAI,EAAJA,IAAI,CAACM,MAAM,kBAIXF,EAAE,EAAFA,EAAE,CAACC,OAAO,EACVL,IAAI,EAAJA,IAAI,CAACM,MAAM,CAAA,EAAA,EAAA,EAAA,OAAA,CAAA,EAAA,CAIXN,IAAI,CAACO,SAAS,CAAC,sBAAsB,CAAC,EAAA,CAAA,EAAA,eAAA,CAAA,EAAA,CAItCP,IAAI,CAACQ,IAAI,CAAC,sBAAsB,CAAC,EAAA,CAAA,EAAA,oBAAA,CAAA,EAAA,CAIjCR,IAAI,CAACQ,IAAI,CAAC,aAAa,CAAC,EAAA,CAAA,EAAA,UAAA,CAAA,EAAA,CAAA,CAsBxBC,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACC,OAAO,CAAA,EAAA,EAAA,EAAA,YAAA,CAAA,EAAA,CAAA,CAkBZH,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACE,WAAW,CAAA,EAAA,EAAA,EAAA,eAAA,CAAA,EAAA,CAAA,CAWhBJ,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACC,OAAO,CAAA,EAAA,EAAA,EAAA,yBAAA,CAAA,EAAA,CAAA,CAiCZH,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACE,WAAW,CAAA,EAAA,EAAA,EAAA,mBAAA,CAAA,EAAA,CAAA,CAOhBJ,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACE,WAAW,CAAA,EAAA,EAAA,EAAA,MAAA,CAAA,EAAA,CAAA,CAUhBJ,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACC,OAAO,CAAA,EAAA,EAAA,EAAA,WAAA,CAAA,CAAA,EAAA,CAAA,EAAA,MAAA,EAjI+B5B,QAAQ,CAAA;AAAA;AAAA8B,EAAAA,WAAAA,CAAA,GAAAC,IAAA,EAAA;AAAA,IAAA,KAAA,CAAA,GAAAA,IAAA,CAAA;IAAApB,oBAAA,CAAA,IAAA,CAAA;AAAA,EAAA;AAGpD;AAGAqB,EAAAA,IAAI,IAAApB,UAAA,CAAA,IAAA,CAAA,EAAAV,UAAA,OAAG,EAAE,CAAA;;AAET;AAGA+B,EAAAA,KAAK,IAAA9B,gBAAA,CAAA,IAAA,CAAA,EAAAC,WAAA,OAAG,EAAE,CAAA;;AAEV;AAEA8B,EAAAA,aAAa,IAAA7B,iBAAA,CAAA,IAAA,CAAA,EAAAC,mBAAA,OAAG,IAAI,CAAA;;AAEpB;AAEA6B,EAAAA,kBAAkB,IAAA5B,yBAAA,CAAA,IAAA,CAAA,EAAAC,wBAAA,OAAG,EAAE,CAAA;;AAEvB;AAEA4B,EAAAA,QAAQ,IAAA3B,8BAAA,CAAA,IAAA,CAAA,EAAAC,cAAA,OAAG,EAAE,CAAA;;AAEb;AACA2B,EAAAA,OAAOA,GACP;IACE,OAAO,IAAI,CAACL,IAAI;AAClB,EAAA;;AAEA;AACF;AACA;AACA;EACEM,OAAOA,CAACN,IAAI,EACZ;IACE,IAAI,CAACA,IAAI,GAAGO,MAAM,CAACP,IAAI,IAAI,EAAE,CAAC;AAChC,EAAA;;AAEA;AACF;AACA;AACA;AAGEQ,EAAAA,UAAUA,GACV;AACE,IAAA,IAAI,CAAC,IAAI,CAACN,aAAa,EACvB;AACE,MAAA,IAAI,CAACA,aAAa,GAAG,IAAIO,qBAAoB,EAAE;AAC/C,MAAA,IAAI,CAACP,aAAa,CAACI,OAAO,CAAC,eAAe,CAAC;AAC3C,MAAA,IAAI,CAACJ,aAAa,CAACQ,oBAAoB,CAAC,IAAI,CAAC;AAC7C,MAAA,IAAI,CAACR,aAAa,CAACS,uBAAuB,CAAC,OAAO,CAAC;AACnD,MAAA,IAAI,CAACT,aAAa,CAACM,UAAU,EAAE;AACjC,IAAA;AACA,IAAA,OAAO,IAAI;AACb,EAAA;;AAEA;AACF;AACA;AACA;AAGEI,EAAAA,aAAaA,GACb;AACE,IAAA,IAAI,CAACT,kBAAkB,CAACU,MAAM,GAAG,CAAC;AACpC,EAAA;;AAEA;AACF;AACA;AACA;AACA;EAGEC,uBAAuBA,CAACC,iBAAiB,EACzC;IACE,IAAI,CAACP,UAAU,EAAE;AACjB,IAAA,IAAI,CAACO,iBAAiB,EAAEC,OAAO,IAAI,IAAID,iBAAiB,CAACV,OAAO,IAAI,KAAK,IAAI,CAACL,IAAI,EAAE,OAAO,KAAK;IAChG,IAAI,CAAC,IAAI,CAACiB,cAAc,CAACF,iBAAiB,CAAC,EAAE,OAAO,KAAK;AACzD,IAAA,IAAI,CAACZ,kBAAkB,CAACe,IAAI,CAACH,iBAAiB,CAAC;AAC/C,IAAA,OAAO,IAAI;AACb,EAAA;;AAEA;AACF;AACA;AACA;EACEE,cAAcA,CAACF,iBAAiB,EAChC;IACE,IAAId,KAAK,GAAG,EAAE;IACd,IACA;MACEA,KAAK,GAAGM,MAAM,CAACQ,iBAAiB,CAACI,QAAQ,EAAE,CAAC;AAC9C,IAAA,CAAC,CACD,MACA;AACElB,MAAAA,KAAK,GAAG,EAAE;AACZ,IAAA;AACA,IAAA,IAAI,CAACG,QAAQ,CAACc,IAAI,CAACjB,KAAK,CAAC;AACzB,IAAA,OAAO,IAAI;AACb,EAAA;;AAEA;AACF;AACA;AACA;AAGEmB,EAAAA,iBAAiBA,GACjB;AACE,IAAA,IAAI,IAAI,CAAChB,QAAQ,CAACS,MAAM,EAAE,IAAI,CAACZ,KAAK,GAAG,IAAI,CAACG,QAAQ,CAAC,CAAC,CAAC;AACzD,EAAA;;AAEA;AAGAiB,EAAAA,IAAIA,GACJ;AACE,IAAA,OAAO,IAAI,CAAClB,kBAAkB,CAACU,MAAM,KAAK,CAAC;AAC7C,EAAA;;AAEA;AACF;AACA;AACA;AAGES,EAAAA,SAASA,GACT;IACE,IAAI,CAACd,UAAU,EAAE;IACjB,IAAI,CAAC,IAAI,CAACN,aAAa,CAACc,OAAO,EAAE,EAAE;IACnC,MAAMf,KAAK,GAAG,IAAI,CAACC,aAAa,CAACiB,QAAQ,EAAE;AAC3C,IAAA,KAAK,MAAMJ,iBAAiB,IAAI,IAAI,CAACZ,kBAAkB,EAAEY,iBAAiB,EAAEQ,QAAQ,GAAGtB,KAAK,CAAC;AAC/F,EAAA;AAAC,EAAA;IAAAnB,UAAA,EAAA;AAAA;AAEH;;;;"}

package/dist/{generated/eve → eve}/socket/EveSocketParameterVector2.js

@@ -1,4 +1,4 @@
-import { applyDecs2311 as _applyDecs2311 } from '../../../_virtual/_rollupPluginBabelHelpers.js';
+import { applyDecs2311 as _applyDecs2311 } from '../../_virtual/_rollupPluginBabelHelpers.js';
 import { vec2 } from '@carbonenginejs/runtime-utils/vec2';
 import { io, type, carbon, impl } from '@carbonenginejs/runtime-utils/schema';
 import { EveSocketParameterBindingBase as _EveSocketParameterBi } from './EveSocketParameterBindingBase.js';
@@ -22,6 +22,11 @@ class EveSocketParameterVector2 extends _EveSocketParameterBi {
 
   /** m_defaults - one default captured per bound external parameter. */
   #defaults = (_init_extra_value(this), []);
+
+  /**
+   * Discards the captured defaults along with the bindings, so nothing can be
+   * restored afterwards.
+   */
   ClearBindings() {
     this.#defaults.length = 0;
     super.ClearBindings();
@@ -35,6 +40,12 @@ class EveSocketParameterVector2 extends _EveSocketParameterBi {
     }
     this.ClearBindings();
   }
+
+  /**
+   * Captures a copy of the external parameter's current value as a default,
+   * keeping it at zero unless the source has at least two components; always
+   * succeeds, so a bind is never refused on its account.
+   */
   ExtractDefault(externalParameter) {
     const value = vec2.create();
     try {
@@ -48,6 +59,11 @@ class EveSocketParameterVector2 extends _EveSocketParameterBi {
     this.#defaults.push(value);
     return true;
   }
+
+  /**
+   * Restores the first captured default into the existing value vector, or
+   * zeroes it when nothing was captured.
+   */
   SetValueToDefault() {
     if (this.#defaults.length) {
       vec2.copy(this.value, this.#defaults[0]);

package/dist/eve/socket/EveSocketParameterVector2.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EveSocketParameterVector2.js","sources":["../../../../src/eve/socket/EveSocketParameterVector2.js"],"sourcesContent":["// Ported from CarbonEngine (MIT, (c) 2026 CCP Games) - https://github.com/carbonengine/trinity\r\n//   trinity/trinity/Eve/SpaceObject/Children/SocketParameters/EveSocketParameter.h\r\n// Hand-authored following the eve/socket generated pattern (SOCKET_PARAM_DECLARE macro family).\r\nimport { vec2 } from \"@carbonenginejs/runtime-utils/vec2\";\r\nimport { carbon, impl, io, type } from \"@carbonenginejs/runtime-utils/schema\";\r\nimport { EveSocketParameterBindingBase } from \"./EveSocketParameterBindingBase.js\";\r\n\r\n/** EveSocketParameterVector2 (eve/socket) - SOCKET_PARAMETER_DEFINE(Vector2, (0, 0)). */\r\n@type.define({ className: \"EveSocketParameterVector2\", family: \"eve/socket\" })\r\nexport class EveSocketParameterVector2 extends EveSocketParameterBindingBase\r\n{\r\n\r\n  /** m_value (Vector2) */\r\n  @io.persist\r\n  @type.vec2\r\n  value = vec2.create();\r\n\r\n  /** m_defaults - one default captured per bound external parameter. */\r\n  #defaults = [];\r\n\r\n  /**\r\n   * Discards the captured defaults along with the bindings, so nothing can be\r\n   * restored afterwards.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  ClearBindings()\r\n  {\r\n    this.#defaults.length = 0;\r\n    super.ClearBindings();\r\n  }\r\n\r\n  /** Restores every binding's default and copies it out, then clears. */\r\n  @carbon.method\r\n  @impl.implemented\r\n  Reset()\r\n  {\r\n    for (let index = 0; index < this.bindings.length; index++)\r\n    {\r\n      vec2.copy(this.value, this.#defaults[index]);\r\n      this.bindings[index]?.CopyValue?.();\r\n    }\r\n    this.ClearBindings();\r\n  }\r\n\r\n  /**\r\n   * Captures a copy of the external parameter's current value as a default,\r\n   * keeping it at zero unless the source has at least two components; always\r\n   * succeeds, so a bind is never refused on its account.\r\n   */\r\n  ExtractDefault(externalParameter)\r\n  {\r\n    const value = vec2.create();\r\n    try\r\n    {\r\n      const source = externalParameter.GetValue();\r\n      if (source && typeof source.length === \"number\" && source.length >= 2)\r\n      {\r\n        vec2.copy(value, source);\r\n      }\r\n    }\r\n    catch\r\n    {\r\n      vec2.set(value, 0, 0);\r\n    }\r\n    this.#defaults.push(value);\r\n    return true;\r\n  }\r\n\r\n  /**\r\n   * Restores the first captured default into the existing value vector, or\r\n   * zeroes it when nothing was captured.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  SetValueToDefault()\r\n  {\r\n    if (this.#defaults.length)\r\n    {\r\n      vec2.copy(this.value, this.#defaults[0]);\r\n    }\r\n    else\r\n    {\r\n      vec2.set(this.value, 0, 0);\r\n    }\r\n  }\r\n\r\n}\r\n"],"names":["_EveSocketParameterVe","EveSocketParameterVector2","EveSocketParameterBindingBase","e","_init_value","_init_extra_value","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","persist","vec2","carbon","method","impl","implemented","value","create","ClearBindings","length","Reset","index","bindings","copy","CopyValue","ExtractDefault","externalParameter","source","GetValue","set","push","SetValueToDefault"],"mappings":"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"}

package/dist/{generated/eve → eve}/socket/EveSocketParameterVector3.js

@@ -1,4 +1,4 @@
-import { applyDecs2311 as _applyDecs2311 } from '../../../_virtual/_rollupPluginBabelHelpers.js';
+import { applyDecs2311 as _applyDecs2311 } from '../../_virtual/_rollupPluginBabelHelpers.js';
 import { vec3 } from '@carbonenginejs/runtime-utils/vec3';
 import { io, type, carbon, impl } from '@carbonenginejs/runtime-utils/schema';
 import { EveSocketParameterBindingBase as _EveSocketParameterBi } from './EveSocketParameterBindingBase.js';
@@ -22,6 +22,11 @@ class EveSocketParameterVector3 extends _EveSocketParameterBi {
 
   /** m_defaults - one default captured per bound external parameter. */
   #defaults = (_init_extra_value(this), []);
+
+  /**
+   * Discards the captured defaults along with the bindings, so nothing can be
+   * restored afterwards.
+   */
   ClearBindings() {
     this.#defaults.length = 0;
     super.ClearBindings();
@@ -35,6 +40,12 @@ class EveSocketParameterVector3 extends _EveSocketParameterBi {
     }
     this.ClearBindings();
   }
+
+  /**
+   * Captures a copy of the external parameter's current value as a default,
+   * keeping it at zero unless the source has at least three components; always
+   * succeeds, so a bind is never refused on its account.
+   */
   ExtractDefault(externalParameter) {
     const value = vec3.create();
     try {
@@ -48,6 +59,11 @@ class EveSocketParameterVector3 extends _EveSocketParameterBi {
     this.#defaults.push(value);
     return true;
   }
+
+  /**
+   * Restores the first captured default into the existing value vector, or
+   * zeroes it when nothing was captured.
+   */
   SetValueToDefault() {
     if (this.#defaults.length) {
       vec3.copy(this.value, this.#defaults[0]);

package/dist/eve/socket/EveSocketParameterVector3.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EveSocketParameterVector3.js","sources":["../../../../src/eve/socket/EveSocketParameterVector3.js"],"sourcesContent":["// Ported from CarbonEngine (MIT, (c) 2026 CCP Games) - https://github.com/carbonengine/trinity\r\n//   trinity/trinity/Eve/SpaceObject/Children/SocketParameters/EveSocketParameter.h\r\n// Hand-authored following the eve/socket generated pattern (SOCKET_PARAM_DECLARE macro family).\r\nimport { vec3 } from \"@carbonenginejs/runtime-utils/vec3\";\r\nimport { carbon, impl, io, type } from \"@carbonenginejs/runtime-utils/schema\";\r\nimport { EveSocketParameterBindingBase } from \"./EveSocketParameterBindingBase.js\";\r\n\r\n/** EveSocketParameterVector3 (eve/socket) - SOCKET_PARAMETER_DEFINE(Vector3, (0, 0, 0)). */\r\n@type.define({ className: \"EveSocketParameterVector3\", family: \"eve/socket\" })\r\nexport class EveSocketParameterVector3 extends EveSocketParameterBindingBase\r\n{\r\n\r\n  /** m_value (Vector3) */\r\n  @io.persist\r\n  @type.vec3\r\n  value = vec3.create();\r\n\r\n  /** m_defaults - one default captured per bound external parameter. */\r\n  #defaults = [];\r\n\r\n  /**\r\n   * Discards the captured defaults along with the bindings, so nothing can be\r\n   * restored afterwards.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  ClearBindings()\r\n  {\r\n    this.#defaults.length = 0;\r\n    super.ClearBindings();\r\n  }\r\n\r\n  /** Restores every binding's default and copies it out, then clears. */\r\n  @carbon.method\r\n  @impl.implemented\r\n  Reset()\r\n  {\r\n    for (let index = 0; index < this.bindings.length; index++)\r\n    {\r\n      vec3.copy(this.value, this.#defaults[index]);\r\n      this.bindings[index]?.CopyValue?.();\r\n    }\r\n    this.ClearBindings();\r\n  }\r\n\r\n  /**\r\n   * Captures a copy of the external parameter's current value as a default,\r\n   * keeping it at zero unless the source has at least three components; always\r\n   * succeeds, so a bind is never refused on its account.\r\n   */\r\n  ExtractDefault(externalParameter)\r\n  {\r\n    const value = vec3.create();\r\n    try\r\n    {\r\n      const source = externalParameter.GetValue();\r\n      if (source && typeof source.length === \"number\" && source.length >= 3)\r\n      {\r\n        vec3.copy(value, source);\r\n      }\r\n    }\r\n    catch\r\n    {\r\n      vec3.set(value, 0, 0, 0);\r\n    }\r\n    this.#defaults.push(value);\r\n    return true;\r\n  }\r\n\r\n  /**\r\n   * Restores the first captured default into the existing value vector, or\r\n   * zeroes it when nothing was captured.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  SetValueToDefault()\r\n  {\r\n    if (this.#defaults.length)\r\n    {\r\n      vec3.copy(this.value, this.#defaults[0]);\r\n    }\r\n    else\r\n    {\r\n      vec3.set(this.value, 0, 0, 0);\r\n    }\r\n  }\r\n\r\n}\r\n"],"names":["_EveSocketParameterVe","EveSocketParameterVector3","EveSocketParameterBindingBase","e","_init_value","_init_extra_value","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","persist","vec3","carbon","method","impl","implemented","value","create","ClearBindings","length","Reset","index","bindings","copy","CopyValue","ExtractDefault","externalParameter","source","GetValue","set","push","SetValueToDefault"],"mappings":"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"}

package/dist/{generated/eve → eve}/socket/EveSocketParameterVector4.js

@@ -1,4 +1,4 @@
-import { applyDecs2311 as _applyDecs2311 } from '../../../_virtual/_rollupPluginBabelHelpers.js';
+import { applyDecs2311 as _applyDecs2311 } from '../../_virtual/_rollupPluginBabelHelpers.js';
 import { vec4 } from '@carbonenginejs/runtime-utils/vec4';
 import { io, type, carbon, impl } from '@carbonenginejs/runtime-utils/schema';
 import { EveSocketParameterBindingBase as _EveSocketParameterBi } from './EveSocketParameterBindingBase.js';
@@ -22,6 +22,11 @@ class EveSocketParameterVector4 extends _EveSocketParameterBi {
 
   /** m_defaults - one default captured per bound external parameter. */
   #defaults = (_init_extra_value(this), []);
+
+  /**
+   * Discards the captured defaults along with the bindings, so nothing can be
+   * restored afterwards.
+   */
   ClearBindings() {
     this.#defaults.length = 0;
     super.ClearBindings();
@@ -35,6 +40,12 @@ class EveSocketParameterVector4 extends _EveSocketParameterBi {
     }
     this.ClearBindings();
   }
+
+  /**
+   * Captures a copy of the external parameter's current value as a default,
+   * keeping it at zero unless the source has at least four components; always
+   * succeeds, so a bind is never refused on its account.
+   */
   ExtractDefault(externalParameter) {
     const value = vec4.create();
     try {
@@ -48,6 +59,11 @@ class EveSocketParameterVector4 extends _EveSocketParameterBi {
     this.#defaults.push(value);
     return true;
   }
+
+  /**
+   * Restores the first captured default into the existing value vector, or
+   * zeroes it when nothing was captured.
+   */
   SetValueToDefault() {
     if (this.#defaults.length) {
       vec4.copy(this.value, this.#defaults[0]);