@carbonenginejs/runtime-trinity 0.5.0 → 0.7.0

package/dist/shader/parameter/Tr2ConstantEffectParameter.js.map

@@ -1 +1 @@
-{"version":3,"file":"Tr2ConstantEffectParameter.js","sources":["../../../../src/shader/parameter/Tr2ConstantEffectParameter.js"],"sourcesContent":["// Ported from CarbonEngine (MIT, (c) 2026 CCP Games) - https://github.com/carbonengine/trinity\r\n//   trinity/trinity/Shader/Tr2Effect.h\r\n// Generated by format-carbon carbon-class --emit. Verify against shader/Tr2ConstantEffectParameter.json.\r\nimport { io, type } from \"@carbonenginejs/core-types/schema\";\r\nimport { vec4 } from \"@carbonenginejs/core-math/vec4\";\r\nimport { CjsParameter } from \"./CjsParameter.js\";\r\n\r\n/** Tr2ConstantEffectParameter (shader) - generated from schema shapeHash b4e14ee0.... */\r\n@type.define({ className: \"Tr2ConstantEffectParameter\", family: \"shader\" })\r\nexport class Tr2ConstantEffectParameter extends CjsParameter\r\n{\r\n\r\n  /** name (BlueSharedString) - persisted via the constParameters structure list. */\r\n  @io.rebuild(\"bindings\")\r\n  @io.persist\r\n  @type.string\r\n  name = \"\";\r\n\r\n  /** value (Vector4) - persisted via the constParameters structure list. */\r\n  @io.rebuild(\"bindings\")\r\n  @io.persist\r\n  @type.vec4\r\n  value = vec4.create();\r\n\r\n}\r\n"],"names":["_Tr2ConstantEffectPar","Tr2ConstantEffectParameter","CjsParameter","e","_init_name","_init_extra_name","_init_value","_init_extra_value","c","_initClass","_applyDecs","type","define","className","family","io","rebuild","persist","string","vec4","constructor","args","name","value","create"],"mappings":";;;;;;;AAOA;AAAA,IAAAA;AACA,MAAAC,0BAAA,SACgDC,YAAY,CAC5D;AAAA,EAAA;AAAA,IAAA,CAAA;AAAAC,MAAAA,CAAA,GAAAC,UAAA,EAAAC,gBAAA,EAAAC,WAAA,EAAAC,iBAAA,CAAA;MAAAC,CAAA,EAAA,CAAAR,qBAAA,EAAAS,UAAA;AAAA,KAAA,GAAAC,cAAA,CAAA,IAAA,EAAA,CAFCC,IAAI,CAACC,MAAM,CAAC;AAAEC,MAAAA,SAAS,EAAE,4BAA4B;AAAEC,MAAAA,MAAM,EAAE;AAAS,KAAC,CAAC,CAAA,EAAA,CAAA,CAAA,CAAA,MAAA,EAKxEC,EAAE,CAACC,OAAO,CAAC,UAAU,CAAC,EACtBD,EAAE,EAAFA,EAAE,CAACE,OAAO,EACVN,IAAI,EAAJA,IAAI,CAACO,MAAM,CAAA,EAAA,EAAA,EAAA,MAAA,CAAA,EAAA,CAAA,CAAA,MAAA,EAIXH,EAAE,CAACC,OAAO,CAAC,UAAU,CAAC,EACtBD,EAAE,EAAFA,EAAE,CAACE,OAAO,EACVN,IAAI,EAAJA,IAAI,CAACQ,IAAI,6BAZoCjB,YAAY,CAAA;AAAA;AAAAkB,EAAAA,WAAAA,CAAA,GAAAC,IAAA,EAAA;AAAA,IAAA,KAAA,CAAA,GAAAA,IAAA,CAAA;IAAAd,iBAAA,CAAA,IAAA,CAAA;AAAA,EAAA;AAG1D;EAIAe,IAAI,GAAAlB,UAAA,CAAA,IAAA,EAAG,EAAE,CAAA;;AAET;EAIAmB,KAAK,IAAAlB,gBAAA,CAAA,IAAA,CAAA,EAAAC,WAAA,OAAGa,IAAI,CAACK,MAAM,EAAE,CAAA;AAAC,EAAA;IAAAf,UAAA,EAAA;AAAA;AAExB;;;;"}
+{"version":3,"file":"Tr2ConstantEffectParameter.js","sources":["../../../../src/shader/parameter/Tr2ConstantEffectParameter.js"],"sourcesContent":["// Ported from CarbonEngine (MIT, (c) 2026 CCP Games) - https://github.com/carbonengine/trinity\r\n//   trinity/trinity/Shader/Tr2Effect.h\r\n// Generated by format-carbon carbon-class --emit. Verify against shader/Tr2ConstantEffectParameter.json.\r\nimport { io, type } from \"@carbonenginejs/runtime-utils/schema\";\r\nimport { vec4 } from \"@carbonenginejs/runtime-utils/vec4\";\r\nimport { CjsParameter } from \"./CjsParameter.js\";\r\n\r\n/** Tr2ConstantEffectParameter (shader) - generated from schema shapeHash b4e14ee0.... */\r\n@type.define({ className: \"Tr2ConstantEffectParameter\", family: \"shader\" })\r\nexport class Tr2ConstantEffectParameter extends CjsParameter\r\n{\r\n\r\n  /** name (BlueSharedString) - persisted via the constParameters structure list. */\r\n  @io.rebuild(\"bindings\")\r\n  @io.persist\r\n  @type.string\r\n  name = \"\";\r\n\r\n  /** value (Vector4) - persisted via the constParameters structure list. */\r\n  @io.rebuild(\"bindings\")\r\n  @io.persist\r\n  @type.vec4\r\n  value = vec4.create();\r\n\r\n}\r\n"],"names":["_Tr2ConstantEffectPar","Tr2ConstantEffectParameter","CjsParameter","e","_init_name","_init_extra_name","_init_value","_init_extra_value","c","_initClass","_applyDecs","type","define","className","family","io","rebuild","persist","string","vec4","constructor","args","name","value","create"],"mappings":";;;;;;;AAOA;AAAA,IAAAA;AACA,MAAAC,0BAAA,SACgDC,YAAY,CAC5D;AAAA,EAAA;AAAA,IAAA,CAAA;AAAAC,MAAAA,CAAA,GAAAC,UAAA,EAAAC,gBAAA,EAAAC,WAAA,EAAAC,iBAAA,CAAA;MAAAC,CAAA,EAAA,CAAAR,qBAAA,EAAAS,UAAA;AAAA,KAAA,GAAAC,cAAA,CAAA,IAAA,EAAA,CAFCC,IAAI,CAACC,MAAM,CAAC;AAAEC,MAAAA,SAAS,EAAE,4BAA4B;AAAEC,MAAAA,MAAM,EAAE;AAAS,KAAC,CAAC,CAAA,EAAA,CAAA,CAAA,CAAA,MAAA,EAKxEC,EAAE,CAACC,OAAO,CAAC,UAAU,CAAC,EACtBD,EAAE,EAAFA,EAAE,CAACE,OAAO,EACVN,IAAI,EAAJA,IAAI,CAACO,MAAM,CAAA,EAAA,EAAA,EAAA,MAAA,CAAA,EAAA,CAAA,CAAA,MAAA,EAIXH,EAAE,CAACC,OAAO,CAAC,UAAU,CAAC,EACtBD,EAAE,EAAFA,EAAE,CAACE,OAAO,EACVN,IAAI,EAAJA,IAAI,CAACQ,IAAI,6BAZoCjB,YAAY,CAAA;AAAA;AAAAkB,EAAAA,WAAAA,CAAA,GAAAC,IAAA,EAAA;AAAA,IAAA,KAAA,CAAA,GAAAA,IAAA,CAAA;IAAAd,iBAAA,CAAA,IAAA,CAAA;AAAA,EAAA;AAG1D;EAIAe,IAAI,GAAAlB,UAAA,CAAA,IAAA,EAAG,EAAE,CAAA;;AAET;EAIAmB,KAAK,IAAAlB,gBAAA,CAAA,IAAA,CAAA,EAAAC,WAAA,OAAGa,IAAI,CAACK,MAAM,EAAE,CAAA;AAAC,EAAA;IAAAf,UAAA,EAAA;AAAA;AAExB;;;;"}

package/dist/shader/parameter/Tr2FloatParameter.js

@@ -1,8 +1,13 @@
 import { applyDecs2311 as _applyDecs2311 } from '../../_virtual/_rollupPluginBabelHelpers.js';
-import { io, type, carbon, impl } from '@carbonenginejs/core-types/schema';
+import { io, type, carbon, impl } from '@carbonenginejs/runtime-utils/schema';
 import { CjsParameter } from './CjsParameter.js';
 
 let _initProto, _initClass, _init_value, _init_extra_value, _init_name, _init_extra_name, _init_usedByCurrentEffect, _init_extra_usedByCurrentEffect;
+
+/**
+ * Single float value for a named shader constant, with optional rerouting into
+ * an external scalar destination.
+ */
 let _Tr2FloatParameter;
 class Tr2FloatParameter extends CjsParameter {
   static {
@@ -22,6 +27,8 @@ class Tr2FloatParameter extends CjsParameter {
   #valueRef = {
     value: this.value
   };
+
+  /** The shader constant name this value binds to; empty until authored. */
   GetParameterName() {
     return this.name;
   }
@@ -30,6 +37,11 @@ class Tr2FloatParameter extends CjsParameter {
   GetHashValue(startingHash = CjsParameter.FNV1_INITIAL) {
     return CjsParameter.hashFnv1String(this.name, CjsParameter.hashFnv1Floats([this.value], startingHash));
   }
+
+  /**
+   * Reads back through the reroute destination when one is set, so the result
+   * reflects writes made by whoever owns that destination.
+   */
   GetValue() {
     if (this.#reroutedValue) {
       this.value = CjsParameter.readScalarDestination(this.#reroutedValue, this.value);
@@ -37,6 +49,11 @@ class Tr2FloatParameter extends CjsParameter {
     }
     return this.value;
   }
+
+  /**
+   * Coerces to a number, refreshes the boxed reference GetDestination hands out,
+   * and writes through to the reroute destination when one is set.
+   */
   SetValue(value) {
     this.value = Number(value);
     this.#valueRef.value = this.value;
@@ -44,9 +61,16 @@ class Tr2FloatParameter extends CjsParameter {
       CjsParameter.writeScalarDestination(this.#reroutedValue, this.value);
     }
   }
+
+  /** Whether reads and writes currently go through an external destination. */
   IsRerouted() {
     return this.#reroutedValue !== null;
   }
+
+  /**
+   * Points the parameter at an external scalar destination and seeds it with the current value; a target under 4 bytes or of an unusable shape clears the reroute instead. Bindings are notified of the effective destination either way.
+   * @param size destination capacity in bytes
+   */
   SetDestination(dest, size = 4) {
     if (size >= 4 && CjsParameter.isScalarDestination(dest)) {
       this.#reroutedValue = dest;
@@ -56,24 +80,48 @@ class Tr2FloatParameter extends CjsParameter {
     }
     CjsParameter.notifyBindings(this.#bindings, this.GetDestination().dest);
   }
+
+  /**
+   * The scalar an upload should read - the reroute target, or the parameter's
+   * own boxed `{ value }` holder - with its 4-byte size. The boxed holder is a
+   * stable object that survives SetValue calls.
+   */
   GetDestination() {
     return {
       dest: this.#reroutedValue ?? this.#valueRef,
       size: 4
     };
   }
+
+  /**
+   * Adds a binding to be notified whenever the destination is repointed;
+   * duplicates are ignored.
+   */
   RegisterBinding(binding) {
     CjsParameter.registerBinding(this.#bindings, binding);
   }
+
+  /** Stops notifying a binding; unknown bindings are ignored. */
   UnregisterBinding(binding) {
     CjsParameter.unregisterBinding(this.#bindings, binding);
   }
+
+  /**
+   * Records whether the shader reflects a constant of this name and drops a
+   * stale reroute when the shader is gone; reflection metadata only, no GPU
+   * handle.
+   */
   RebuildEffectHandles(effectRes) {
     if (!effectRes && this.#reroutedValue) {
       this.SetDestination(null, 0);
     }
     this.usedByCurrentEffect = !!this.name && CjsParameter.hasEffectConstant(effectRes, this.name);
   }
+
+  /**
+   * Syncs the boxed reference and any reroute destination with the current
+   * value; always returns true.
+   */
   Initialize() {
     this.#valueRef.value = this.value;
     if (this.#reroutedValue) {
@@ -81,6 +129,11 @@ class Tr2FloatParameter extends CjsParameter {
     }
     return true;
   }
+
+  /**
+   * Writes the current value - read back through the reroute first when one is
+   * active - into the caller's destination.
+   */
   CopyValueToEffect(_inputType, out) {
     CjsParameter.writeScalarDestination(out, this.GetValue());
   }

package/dist/shader/parameter/Tr2FloatParameter.js.map

@@ -1 +1 @@
-{"version":3,"file":"Tr2FloatParameter.js","sources":["../../../../src/shader/parameter/Tr2FloatParameter.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\Shader\\Parameter\\Tr2FloatParameter.h\r\n// Source: E:\\carbonengine\\trinity\\trinity\\Shader\\Parameter\\Tr2FloatParameter.cpp\r\nimport { carbon, impl, io, type } from \"@carbonenginejs/core-types/schema\";\r\nimport { CjsParameter } from \"./CjsParameter.js\";\r\n\r\n\r\n@type.define({className: \"Tr2FloatParameter\", family: \"shader\"})\r\nexport class Tr2FloatParameter extends CjsParameter\r\n{\r\n  @io.persistOnly\r\n  @type.float32\r\n  value = 1;\r\n\r\n  @io.notify\r\n  @io.persist\r\n  @type.string\r\n  name = \"\";\r\n\r\n  @io.read\r\n  @type.boolean\r\n  usedByCurrentEffect = false;\r\n\r\n  #bindings = [];\r\n  #reroutedValue = null;\r\n  #valueRef = {  value: this.value };\r\n\r\n  @carbon.method\r\n  @impl.implemented\r\n  GetParameterName()\r\n  {\r\n    return this.name;\r\n  }\r\n\r\n  /** Content hash: value bytes then name (Carbon hashes the interned name pointer). */\r\n  @carbon.method\r\n  @impl.adapted\r\n  GetHashValue(startingHash = CjsParameter.FNV1_INITIAL)\r\n  {\r\n    return CjsParameter.hashFnv1String(this.name, CjsParameter.hashFnv1Floats([this.value], startingHash));\r\n  }\r\n\r\n  @carbon.method\r\n  @impl.implemented\r\n  GetValue()\r\n  {\r\n    if (this.#reroutedValue)\r\n    {\r\n      this.value = CjsParameter.readScalarDestination(this.#reroutedValue, this.value);\r\n      this.#valueRef.value = this.value;\r\n    }\r\n    return this.value;\r\n  }\r\n\r\n  @carbon.method\r\n  @impl.implemented\r\n  SetValue(value)\r\n  {\r\n    this.value = Number(value);\r\n    this.#valueRef.value = this.value;\r\n    if (this.#reroutedValue)\r\n    {\r\n      CjsParameter.writeScalarDestination(this.#reroutedValue, this.value);\r\n    }\r\n  }\r\n\r\n  @carbon.method\r\n  @impl.implemented\r\n  IsRerouted()\r\n  {\r\n    return this.#reroutedValue !== null;\r\n  }\r\n\r\n  @carbon.method\r\n  @impl.adapted\r\n  SetDestination(dest, size = 4)\r\n  {\r\n    if (size >= 4 && CjsParameter.isScalarDestination(dest))\r\n    {\r\n      this.#reroutedValue = dest;\r\n      CjsParameter.writeScalarDestination(dest, this.value);\r\n    }\r\n    else\r\n    {\r\n      this.#reroutedValue = null;\r\n    }\r\n    CjsParameter.notifyBindings(this.#bindings, this.GetDestination().dest);\r\n  }\r\n\r\n  @carbon.method\r\n  @impl.adapted\r\n  GetDestination()\r\n  {\r\n    return {\r\n      dest: this.#reroutedValue ?? this.#valueRef,\r\n      size: 4\r\n    };\r\n  }\r\n\r\n  @carbon.method\r\n  @impl.adapted\r\n  RegisterBinding(binding)\r\n  {\r\n    CjsParameter.registerBinding(this.#bindings, binding);\r\n  }\r\n\r\n  @carbon.method\r\n  @impl.adapted\r\n  UnregisterBinding(binding)\r\n  {\r\n    CjsParameter.unregisterBinding(this.#bindings, binding);\r\n  }\r\n\r\n  @carbon.method\r\n  @impl.adapted\r\n  RebuildEffectHandles(effectRes)\r\n  {\r\n    if (!effectRes && this.#reroutedValue)\r\n    {\r\n      this.SetDestination(null, 0);\r\n    }\r\n    this.usedByCurrentEffect = !!this.name && CjsParameter.hasEffectConstant(effectRes, this.name);\r\n  }\r\n\r\n  @carbon.method\r\n  @impl.implemented\r\n  Initialize()\r\n  {\r\n    this.#valueRef.value = this.value;\r\n    if (this.#reroutedValue)\r\n    {\r\n      CjsParameter.writeScalarDestination(this.#reroutedValue, this.value);\r\n    }\r\n    return true;\r\n  }\r\n\r\n  @carbon.method\r\n  @impl.adapted\r\n  CopyValueToEffect(_inputType, out)\r\n  {\r\n    CjsParameter.writeScalarDestination(out, this.GetValue());\r\n  }\r\n\r\n  /** JS convenience: raw values this parameter class claims for map-form inference. */\r\n  static isValue(value)\r\n  {\r\n    return typeof value === \"number\";\r\n  }\r\n\r\n}\r\n"],"names":["_Tr2FloatParameter","Tr2FloatParameter","CjsParameter","e","_init_value","_init_extra_value","_init_name","_init_extra_name","_init_usedByCurrentEffect","_init_extra_usedByCurrentEffect","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","persistOnly","float32","notify","persist","string","read","boolean","carbon","method","impl","implemented","adapted","value","name","usedByCurrentEffect","GetParameterName","GetHashValue","startingHash","FNV1_INITIAL","hashFnv1String","hashFnv1Floats","GetValue","readScalarDestination","SetValue","Number","writeScalarDestination","IsRerouted","SetDestination","dest","size","isScalarDestination","notifyBindings","GetDestination","RegisterBinding","binding","registerBinding","UnregisterBinding","unregisterBinding","RebuildEffectHandles","effectRes","hasEffectConstant","Initialize","CopyValueToEffect","_inputType","out","isValue"],"mappings":"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"}
+{"version":3,"file":"Tr2FloatParameter.js","sources":["../../../../src/shader/parameter/Tr2FloatParameter.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\Shader\\Parameter\\Tr2FloatParameter.h\r\n// Source: E:\\carbonengine\\trinity\\trinity\\Shader\\Parameter\\Tr2FloatParameter.cpp\r\nimport { carbon, impl, io, type } from \"@carbonenginejs/runtime-utils/schema\";\r\nimport { CjsParameter } from \"./CjsParameter.js\";\r\n\r\n\r\n/**\r\n * Single float value for a named shader constant, with optional rerouting into\r\n * an external scalar destination.\r\n */\r\n@type.define({className: \"Tr2FloatParameter\", family: \"shader\"})\r\nexport class Tr2FloatParameter extends CjsParameter\r\n{\r\n  @io.persistOnly\r\n  @type.float32\r\n  value = 1;\r\n\r\n  @io.notify\r\n  @io.persist\r\n  @type.string\r\n  name = \"\";\r\n\r\n  @io.read\r\n  @type.boolean\r\n  usedByCurrentEffect = false;\r\n\r\n  #bindings = [];\r\n  #reroutedValue = null;\r\n  #valueRef = {  value: this.value };\r\n\r\n  /** The shader constant name this value binds to; empty until authored. */\r\n  @carbon.method\r\n  @impl.implemented\r\n  GetParameterName()\r\n  {\r\n    return this.name;\r\n  }\r\n\r\n  /** Content hash: value bytes then name (Carbon hashes the interned name pointer). */\r\n  @carbon.method\r\n  @impl.adapted\r\n  GetHashValue(startingHash = CjsParameter.FNV1_INITIAL)\r\n  {\r\n    return CjsParameter.hashFnv1String(this.name, CjsParameter.hashFnv1Floats([this.value], startingHash));\r\n  }\r\n\r\n  /**\r\n   * Reads back through the reroute destination when one is set, so the result\r\n   * reflects writes made by whoever owns that destination.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  GetValue()\r\n  {\r\n    if (this.#reroutedValue)\r\n    {\r\n      this.value = CjsParameter.readScalarDestination(this.#reroutedValue, this.value);\r\n      this.#valueRef.value = this.value;\r\n    }\r\n    return this.value;\r\n  }\r\n\r\n  /**\r\n   * Coerces to a number, refreshes the boxed reference GetDestination hands out,\r\n   * and writes through to the reroute destination when one is set.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  SetValue(value)\r\n  {\r\n    this.value = Number(value);\r\n    this.#valueRef.value = this.value;\r\n    if (this.#reroutedValue)\r\n    {\r\n      CjsParameter.writeScalarDestination(this.#reroutedValue, this.value);\r\n    }\r\n  }\r\n\r\n  /** Whether reads and writes currently go through an external destination. */\r\n  @carbon.method\r\n  @impl.implemented\r\n  IsRerouted()\r\n  {\r\n    return this.#reroutedValue !== null;\r\n  }\r\n\r\n  /**\r\n   * Points the parameter at an external scalar destination and seeds it with the current value; a target under 4 bytes or of an unusable shape clears the reroute instead. Bindings are notified of the effective destination either way.\r\n   * @param size destination capacity in bytes\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  SetDestination(dest, size = 4)\r\n  {\r\n    if (size >= 4 && CjsParameter.isScalarDestination(dest))\r\n    {\r\n      this.#reroutedValue = dest;\r\n      CjsParameter.writeScalarDestination(dest, this.value);\r\n    }\r\n    else\r\n    {\r\n      this.#reroutedValue = null;\r\n    }\r\n    CjsParameter.notifyBindings(this.#bindings, this.GetDestination().dest);\r\n  }\r\n\r\n  /**\r\n   * The scalar an upload should read - the reroute target, or the parameter's\r\n   * own boxed `{ value }` holder - with its 4-byte size. The boxed holder is a\r\n   * stable object that survives SetValue calls.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  GetDestination()\r\n  {\r\n    return {\r\n      dest: this.#reroutedValue ?? this.#valueRef,\r\n      size: 4\r\n    };\r\n  }\r\n\r\n  /**\r\n   * Adds a binding to be notified whenever the destination is repointed;\r\n   * duplicates are ignored.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  RegisterBinding(binding)\r\n  {\r\n    CjsParameter.registerBinding(this.#bindings, binding);\r\n  }\r\n\r\n  /** Stops notifying a binding; unknown bindings are ignored. */\r\n  @carbon.method\r\n  @impl.adapted\r\n  UnregisterBinding(binding)\r\n  {\r\n    CjsParameter.unregisterBinding(this.#bindings, binding);\r\n  }\r\n\r\n  /**\r\n   * Records whether the shader reflects a constant of this name and drops a\r\n   * stale reroute when the shader is gone; reflection metadata only, no GPU\r\n   * handle.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  RebuildEffectHandles(effectRes)\r\n  {\r\n    if (!effectRes && this.#reroutedValue)\r\n    {\r\n      this.SetDestination(null, 0);\r\n    }\r\n    this.usedByCurrentEffect = !!this.name && CjsParameter.hasEffectConstant(effectRes, this.name);\r\n  }\r\n\r\n  /**\r\n   * Syncs the boxed reference and any reroute destination with the current\r\n   * value; always returns true.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  Initialize()\r\n  {\r\n    this.#valueRef.value = this.value;\r\n    if (this.#reroutedValue)\r\n    {\r\n      CjsParameter.writeScalarDestination(this.#reroutedValue, this.value);\r\n    }\r\n    return true;\r\n  }\r\n\r\n  /**\r\n   * Writes the current value - read back through the reroute first when one is\r\n   * active - into the caller's destination.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  CopyValueToEffect(_inputType, out)\r\n  {\r\n    CjsParameter.writeScalarDestination(out, this.GetValue());\r\n  }\r\n\r\n  /** JS convenience: raw values this parameter class claims for map-form inference. */\r\n  static isValue(value)\r\n  {\r\n    return typeof value === \"number\";\r\n  }\r\n\r\n}\r\n"],"names":["_Tr2FloatParameter","Tr2FloatParameter","CjsParameter","e","_init_value","_init_extra_value","_init_name","_init_extra_name","_init_usedByCurrentEffect","_init_extra_usedByCurrentEffect","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","persistOnly","float32","notify","persist","string","read","boolean","carbon","method","impl","implemented","adapted","value","name","usedByCurrentEffect","GetParameterName","GetHashValue","startingHash","FNV1_INITIAL","hashFnv1String","hashFnv1Floats","GetValue","readScalarDestination","SetValue","Number","writeScalarDestination","IsRerouted","SetDestination","dest","size","isScalarDestination","notifyBindings","GetDestination","RegisterBinding","binding","registerBinding","UnregisterBinding","unregisterBinding","RebuildEffectHandles","effectRes","hasEffectConstant","Initialize","CopyValueToEffect","_inputType","out","isValue"],"mappings":";;;;;;AAMA;AACA;AACA;AACA;AAHA,IAAAA;AAIA,MAAAC,iBAAA,SACuCC,YAAY,CACnD;AAAA,EAAA;AAAA,IAAA,CAAA;AAAAC,MAAAA,CAAA,EAAA,CAAAC,WAAA,EAAAC,iBAAA,EAAAC,UAAA,EAAAC,gBAAA,EAAAC,yBAAA,EAAAC,+BAAA,EAAAC,UAAA,CAAA;MAAAC,CAAA,EAAA,CAAAX,kBAAA,EAAAY,UAAA;AAAA,KAAA,GAAAC,cAAA,CAAA,IAAA,EAAA,CAFCC,IAAI,CAACC,MAAM,CAAC;AAACC,MAAAA,SAAS,EAAE,mBAAmB;AAAEC,MAAAA,MAAM,EAAE;KAAS,CAAC,MAG7DC,EAAE,EAAFA,EAAE,CAACC,WAAW,EACdL,IAAI,EAAJA,IAAI,CAACM,OAAO,mBAGZF,EAAE,EAAFA,EAAE,CAACG,MAAM,EACTH,EAAE,EAAFA,EAAE,CAACI,OAAO,EACVR,IAAI,EAAJA,IAAI,CAACS,MAAM,kBAGXL,EAAE,EAAFA,EAAE,CAACM,IAAI,EACPV,IAAI,EAAJA,IAAI,CAACW,OAAO,iCAQZC,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACC,WAAW,8BAOhBH,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACE,OAAO,0BAUZJ,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACC,WAAW,sBAehBH,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACC,WAAW,sBAYhBH,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACC,WAAW,wBAUhBH,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACE,OAAO,4BAoBZJ,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACE,OAAO,4BAaZJ,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACE,OAAO,6BAOZJ,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACE,OAAO,+BAWZJ,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACE,OAAO,kCAcZJ,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACC,WAAW,wBAehBH,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACE,OAAO,yCAtKwB5B,YAAY,CAAA;AAAA;AAIjD6B,EAAAA,KAAK,IAAArB,UAAA,CAAA,IAAA,CAAA,EAAAN,WAAA,OAAG,CAAC,CAAA;AAKT4B,EAAAA,IAAI,IAAA3B,iBAAA,CAAA,IAAA,CAAA,EAAAC,UAAA,OAAG,EAAE,CAAA;AAIT2B,EAAAA,mBAAmB,IAAA1B,gBAAA,CAAA,IAAA,CAAA,EAAAC,yBAAA,OAAG,KAAK,CAAA;AAE3B,EAAA,SAAS,IAAAC,+BAAA,CAAA,IAAA,CAAA,EAAG,EAAE;EACd,cAAc,GAAG,IAAI;AACrB,EAAA,SAAS,GAAG;IAAGsB,KAAK,EAAE,IAAI,CAACA;GAAO;;AAElC;AAGAG,EAAAA,gBAAgBA,GAChB;IACE,OAAO,IAAI,CAACF,IAAI;AAClB,EAAA;;AAEA;AAGAG,EAAAA,YAAYA,CAACC,YAAY,GAAGlC,YAAY,CAACmC,YAAY,EACrD;IACE,OAAOnC,YAAY,CAACoC,cAAc,CAAC,IAAI,CAACN,IAAI,EAAE9B,YAAY,CAACqC,cAAc,CAAC,CAAC,IAAI,CAACR,KAAK,CAAC,EAAEK,YAAY,CAAC,CAAC;AACxG,EAAA;;AAEA;AACF;AACA;AACA;AAGEI,EAAAA,QAAQA,GACR;AACE,IAAA,IAAI,IAAI,CAAC,cAAc,EACvB;AACE,MAAA,IAAI,CAACT,KAAK,GAAG7B,YAAY,CAACuC,qBAAqB,CAAC,IAAI,CAAC,cAAc,EAAE,IAAI,CAACV,KAAK,CAAC;MAChF,IAAI,CAAC,SAAS,CAACA,KAAK,GAAG,IAAI,CAACA,KAAK;AACnC,IAAA;IACA,OAAO,IAAI,CAACA,KAAK;AACnB,EAAA;;AAEA;AACF;AACA;AACA;EAGEW,QAAQA,CAACX,KAAK,EACd;AACE,IAAA,IAAI,CAACA,KAAK,GAAGY,MAAM,CAACZ,KAAK,CAAC;IAC1B,IAAI,CAAC,SAAS,CAACA,KAAK,GAAG,IAAI,CAACA,KAAK;AACjC,IAAA,IAAI,IAAI,CAAC,cAAc,EACvB;MACE7B,YAAY,CAAC0C,sBAAsB,CAAC,IAAI,CAAC,cAAc,EAAE,IAAI,CAACb,KAAK,CAAC;AACtE,IAAA;AACF,EAAA;;AAEA;AAGAc,EAAAA,UAAUA,GACV;AACE,IAAA,OAAO,IAAI,CAAC,cAAc,KAAK,IAAI;AACrC,EAAA;;AAEA;AACF;AACA;AACA;AAGEC,EAAAA,cAAcA,CAACC,IAAI,EAAEC,IAAI,GAAG,CAAC,EAC7B;IACE,IAAIA,IAAI,IAAI,CAAC,IAAI9C,YAAY,CAAC+C,mBAAmB,CAACF,IAAI,CAAC,EACvD;AACE,MAAA,IAAI,CAAC,cAAc,GAAGA,IAAI;MAC1B7C,YAAY,CAAC0C,sBAAsB,CAACG,IAAI,EAAE,IAAI,CAAChB,KAAK,CAAC;AACvD,IAAA,CAAC,MAED;AACE,MAAA,IAAI,CAAC,cAAc,GAAG,IAAI;AAC5B,IAAA;AACA7B,IAAAA,YAAY,CAACgD,cAAc,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAACC,cAAc,EAAE,CAACJ,IAAI,CAAC;AACzE,EAAA;;AAEA;AACF;AACA;AACA;AACA;AAGEI,EAAAA,cAAcA,GACd;IACE,OAAO;MACLJ,IAAI,EAAE,IAAI,CAAC,cAAc,IAAI,IAAI,CAAC,SAAS;AAC3CC,MAAAA,IAAI,EAAE;KACP;AACH,EAAA;;AAEA;AACF;AACA;AACA;EAGEI,eAAeA,CAACC,OAAO,EACvB;IACEnD,YAAY,CAACoD,eAAe,CAAC,IAAI,CAAC,SAAS,EAAED,OAAO,CAAC;AACvD,EAAA;;AAEA;EAGAE,iBAAiBA,CAACF,OAAO,EACzB;IACEnD,YAAY,CAACsD,iBAAiB,CAAC,IAAI,CAAC,SAAS,EAAEH,OAAO,CAAC;AACzD,EAAA;;AAEA;AACF;AACA;AACA;AACA;EAGEI,oBAAoBA,CAACC,SAAS,EAC9B;AACE,IAAA,IAAI,CAACA,SAAS,IAAI,IAAI,CAAC,cAAc,EACrC;AACE,MAAA,IAAI,CAACZ,cAAc,CAAC,IAAI,EAAE,CAAC,CAAC;AAC9B,IAAA;AACA,IAAA,IAAI,CAACb,mBAAmB,GAAG,CAAC,CAAC,IAAI,CAACD,IAAI,IAAI9B,YAAY,CAACyD,iBAAiB,CAACD,SAAS,EAAE,IAAI,CAAC1B,IAAI,CAAC;AAChG,EAAA;;AAEA;AACF;AACA;AACA;AAGE4B,EAAAA,UAAUA,GACV;IACE,IAAI,CAAC,SAAS,CAAC7B,KAAK,GAAG,IAAI,CAACA,KAAK;AACjC,IAAA,IAAI,IAAI,CAAC,cAAc,EACvB;MACE7B,YAAY,CAAC0C,sBAAsB,CAAC,IAAI,CAAC,cAAc,EAAE,IAAI,CAACb,KAAK,CAAC;AACtE,IAAA;AACA,IAAA,OAAO,IAAI;AACb,EAAA;;AAEA;AACF;AACA;AACA;AAGE8B,EAAAA,iBAAiBA,CAACC,UAAU,EAAEC,GAAG,EACjC;IACE7D,YAAY,CAAC0C,sBAAsB,CAACmB,GAAG,EAAE,IAAI,CAACvB,QAAQ,EAAE,CAAC;AAC3D,EAAA;;AAEA;EACA,OAAOwB,OAAOA,CAACjC,KAAK,EACpB;IACE,OAAO,OAAOA,KAAK,KAAK,QAAQ;AAClC,EAAA;AAAC,EAAA;IAAAnB,UAAA,EAAA;AAAA;AAEH;;;;"}

package/dist/shader/parameter/Tr2GeometryBufferParameter.js

@@ -1,6 +1,6 @@
 import { applyDecs2311 as _applyDecs2311 } from '../../_virtual/_rollupPluginBabelHelpers.js';
-import { io, type, carbon, impl } from '@carbonenginejs/core-types/schema';
-import '@carbonenginejs/core-types/model';
+import { io, type, carbon, impl } from '@carbonenginejs/runtime-utils/schema';
+import '@carbonenginejs/runtime-utils/model';
 import { CjsParameter } from './CjsParameter.js';
 
 let _initProto, _initClass, _init_resourcePath, _init_extra_resourcePath, _init_gpuBuffer, _init_extra_gpuBuffer, _init_usedByCurrentEffect, _init_extra_usedByCurrentEffect, _init_meshIndex, _init_extra_meshIndex, _init_name, _init_extra_name;
@@ -32,6 +32,8 @@ class Tr2GeometryBufferParameter extends CjsParameter {
   /** m_name (BlueSharedString) [READWRITE, NOTIFY, PERSIST] */
   name = (_init_extra_meshIndex(this), _init_name(this, ""));
   cachedEffect = (_init_extra_name(this), null);
+
+  /** The shader resource name this buffer binds to. */
   GetParameterName() {
     return this.name;
   }
@@ -43,9 +45,19 @@ class Tr2GeometryBufferParameter extends CjsParameter {
     }
     return CjsParameter.hashFnv1String(this.name, startingHash);
   }
+
+  /**
+   * Nothing to do in this GPU-free package - a resource path is never resolved
+   * to a buffer here; returns true.
+   */
   Initialize() {
     return true;
   }
+
+  /**
+   * Consumes the `resource` dirty flag by re-initializing and re-resolving
+   * handles against the cached shader.
+   */
   OnModified(_options = {}) {
     if (this.__state.flags.delete("resource")) {
       this.Initialize();
@@ -53,23 +65,50 @@ class Tr2GeometryBufferParameter extends CjsParameter {
     }
     return true;
   }
+
+  /**
+   * Caches the shader and records whether it reflects a resource of this name;
+   * no GPU buffer is bound.
+   */
   RebuildEffectHandles(effectRes) {
     this.cachedEffect = effectRes;
     this.usedByCurrentEffect = !!this.name && !!CjsParameter.getEffectResource(effectRes, this.name);
   }
+
+  /**
+   * Always false - populating a resource set is device work this package does
+   * not do.
+   */
   CopyToResourceSet() {
     return false;
   }
+
+  /** Always false - UAV binding is left to the engine adapter. */
   ApplyUav() {
     return false;
   }
+
+  /**
+   * Whether a buffer object has actually been attached; an authored resourcePath
+   * alone does not make the parameter valid.
+   */
   IsValid() {
     return !!this.gpuBuffer;
   }
+
+  /**
+   * Attaches a buffer object directly and clears the authored resource path, so
+   * the path can no longer override it.
+   */
   SetGpuBuffer(buffer) {
     this.resourcePath = "";
     this.gpuBuffer = buffer;
   }
+
+  /**
+   * The attached buffer object, or null; held by reference and never created
+   * here.
+   */
   GetGpuBuffer() {
     return this.gpuBuffer;
   }

package/dist/shader/parameter/Tr2GeometryBufferParameter.js.map

@@ -1 +1 @@
-{"version":3,"file":"Tr2GeometryBufferParameter.js","sources":["../../../../src/shader/parameter/Tr2GeometryBufferParameter.js"],"sourcesContent":["// Ported from CarbonEngine (MIT, (c) 2026 CCP Games) - https://github.com/carbonengine/trinity\r\n//   trinity/trinity/Shader/Parameter/Tr2GeometryBufferParameter.h\r\n// Generated by format-carbon carbon-class --emit. Verify against shader/Tr2GeometryBufferParameter.json.\r\nimport { carbon, impl, io, type } from \"@carbonenginejs/core-types/schema\";\r\nimport { CjsModel } from \"@carbonenginejs/core-types/model\";\r\nimport { CjsParameter } from \"./CjsParameter.js\";\r\n\r\n/** Tr2GeometryBufferParameter (shader) - generated from schema shapeHash bc9ed4c6.... */\r\n@type.define({ className: \"Tr2GeometryBufferParameter\", family: \"shader\" })\r\nexport class Tr2GeometryBufferParameter extends CjsParameter\r\n{\r\n\r\n  /** m_resourcePath (std::wstring) [READWRITE, NOTIFY, PERSIST] */\r\n  @io.flag(\"resource\")\r\n  @io.notify\r\n  @io.persist\r\n  @type.string\r\n  resourcePath = \"\";\r\n\r\n  /** m_gpuBuffer (ITr2GpuBufferPtr) [READWRITE, PERSIST, NOTIFY] */\r\n  @io.notify\r\n  @io.persist\r\n  @type.objectRef(\"ITr2GpuBuffer\")\r\n  gpuBuffer = null;\r\n\r\n  /** m_isUsedByEffect (bool) [READ] */\r\n  @io.read\r\n  @type.boolean\r\n  usedByCurrentEffect = false;\r\n\r\n  /** m_meshIndex (int32_t) [READWRITE, NOTIFY, PERSIST] */\r\n  @io.notify\r\n  @io.persist\r\n  @type.int32\r\n  meshIndex = 0;\r\n\r\n  /** m_name (BlueSharedString) [READWRITE, NOTIFY, PERSIST] */\r\n  @io.notify\r\n  @io.persist\r\n  @type.string\r\n  name = \"\";\r\n\r\n  cachedEffect = null;\r\n\r\n  @carbon.method\r\n  @impl.implemented\r\n  GetParameterName()\r\n  {\r\n    return this.name;\r\n  }\r\n\r\n  /** Content hash: resource path (when set) then name. */\r\n  @carbon.method\r\n  @impl.adapted\r\n  GetHashValue(startingHash = CjsParameter.FNV1_INITIAL)\r\n  {\r\n    if (this.resourcePath)\r\n    {\r\n      startingHash = CjsParameter.hashFnv1String(this.resourcePath, startingHash);\r\n    }\r\n    return CjsParameter.hashFnv1String(this.name, startingHash);\r\n  }\r\n\r\n  @carbon.method\r\n  @impl.adapted\r\n  Initialize()\r\n  {\r\n    return true;\r\n  }\r\n\r\n  @carbon.method\r\n  @impl.adapted\r\n  OnModified(_options = {})\r\n  {\r\n    if (this.__state.flags.delete(\"resource\"))\r\n    {\r\n      this.Initialize();\r\n      this.RebuildEffectHandles(this.cachedEffect);\r\n    }\r\n    return true;\r\n  }\r\n\r\n  @carbon.method\r\n  @impl.adapted\r\n  RebuildEffectHandles(effectRes)\r\n  {\r\n    this.cachedEffect = effectRes;\r\n    this.usedByCurrentEffect = !!this.name && !!CjsParameter.getEffectResource(effectRes, this.name);\r\n  }\r\n\r\n  @carbon.method\r\n  @impl.adapted\r\n  CopyToResourceSet()\r\n  {\r\n    return false;\r\n  }\r\n\r\n  @carbon.method\r\n  @impl.adapted\r\n  ApplyUav()\r\n  {\r\n    return false;\r\n  }\r\n\r\n  @carbon.method\r\n  @impl.implemented\r\n  IsValid()\r\n  {\r\n    return !!this.gpuBuffer;\r\n  }\r\n\r\n  @carbon.method\r\n  @impl.implemented\r\n  SetGpuBuffer(buffer)\r\n  {\r\n    this.resourcePath = \"\";\r\n    this.gpuBuffer = buffer;\r\n  }\r\n\r\n  @carbon.method\r\n  @impl.implemented\r\n  GetGpuBuffer()\r\n  {\r\n    return this.gpuBuffer;\r\n  }\r\n\r\n}\r\n"],"names":["_Tr2GeometryBufferPar","Tr2GeometryBufferParameter","CjsParameter","e","_init_resourcePath","_init_extra_resourcePath","_init_gpuBuffer","_init_extra_gpuBuffer","_init_usedByCurrentEffect","_init_extra_usedByCurrentEffect","_init_meshIndex","_init_extra_meshIndex","_init_name","_init_extra_name","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","flag","notify","persist","string","objectRef","read","boolean","int32","carbon","method","impl","implemented","adapted","resourcePath","gpuBuffer","usedByCurrentEffect","meshIndex","name","cachedEffect","GetParameterName","GetHashValue","startingHash","FNV1_INITIAL","hashFnv1String","Initialize","OnModified","_options","__state","flags","delete","RebuildEffectHandles","effectRes","getEffectResource","CopyToResourceSet","ApplyUav","IsValid","SetGpuBuffer","buffer","GetGpuBuffer"],"mappings":"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"}
+{"version":3,"file":"Tr2GeometryBufferParameter.js","sources":["../../../../src/shader/parameter/Tr2GeometryBufferParameter.js"],"sourcesContent":["// Ported from CarbonEngine (MIT, (c) 2026 CCP Games) - https://github.com/carbonengine/trinity\r\n//   trinity/trinity/Shader/Parameter/Tr2GeometryBufferParameter.h\r\n// Generated by format-carbon carbon-class --emit. Verify against shader/Tr2GeometryBufferParameter.json.\r\nimport { carbon, impl, io, type } from \"@carbonenginejs/runtime-utils/schema\";\r\nimport { CjsModel } from \"@carbonenginejs/runtime-utils/model\";\r\nimport { CjsParameter } from \"./CjsParameter.js\";\r\n\r\n/** Tr2GeometryBufferParameter (shader) - generated from schema shapeHash bc9ed4c6.... */\r\n@type.define({ className: \"Tr2GeometryBufferParameter\", family: \"shader\" })\r\nexport class Tr2GeometryBufferParameter extends CjsParameter\r\n{\r\n\r\n  /** m_resourcePath (std::wstring) [READWRITE, NOTIFY, PERSIST] */\r\n  @io.flag(\"resource\")\r\n  @io.notify\r\n  @io.persist\r\n  @type.string\r\n  resourcePath = \"\";\r\n\r\n  /** m_gpuBuffer (ITr2GpuBufferPtr) [READWRITE, PERSIST, NOTIFY] */\r\n  @io.notify\r\n  @io.persist\r\n  @type.objectRef(\"ITr2GpuBuffer\")\r\n  gpuBuffer = null;\r\n\r\n  /** m_isUsedByEffect (bool) [READ] */\r\n  @io.read\r\n  @type.boolean\r\n  usedByCurrentEffect = false;\r\n\r\n  /** m_meshIndex (int32_t) [READWRITE, NOTIFY, PERSIST] */\r\n  @io.notify\r\n  @io.persist\r\n  @type.int32\r\n  meshIndex = 0;\r\n\r\n  /** m_name (BlueSharedString) [READWRITE, NOTIFY, PERSIST] */\r\n  @io.notify\r\n  @io.persist\r\n  @type.string\r\n  name = \"\";\r\n\r\n  cachedEffect = null;\r\n\r\n  /** The shader resource name this buffer binds to. */\r\n  @carbon.method\r\n  @impl.implemented\r\n  GetParameterName()\r\n  {\r\n    return this.name;\r\n  }\r\n\r\n  /** Content hash: resource path (when set) then name. */\r\n  @carbon.method\r\n  @impl.adapted\r\n  GetHashValue(startingHash = CjsParameter.FNV1_INITIAL)\r\n  {\r\n    if (this.resourcePath)\r\n    {\r\n      startingHash = CjsParameter.hashFnv1String(this.resourcePath, startingHash);\r\n    }\r\n    return CjsParameter.hashFnv1String(this.name, startingHash);\r\n  }\r\n\r\n  /**\r\n   * Nothing to do in this GPU-free package - a resource path is never resolved\r\n   * to a buffer here; returns true.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  Initialize()\r\n  {\r\n    return true;\r\n  }\r\n\r\n  /**\r\n   * Consumes the `resource` dirty flag by re-initializing and re-resolving\r\n   * handles against the cached shader.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  OnModified(_options = {})\r\n  {\r\n    if (this.__state.flags.delete(\"resource\"))\r\n    {\r\n      this.Initialize();\r\n      this.RebuildEffectHandles(this.cachedEffect);\r\n    }\r\n    return true;\r\n  }\r\n\r\n  /**\r\n   * Caches the shader and records whether it reflects a resource of this name;\r\n   * no GPU buffer is bound.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  RebuildEffectHandles(effectRes)\r\n  {\r\n    this.cachedEffect = effectRes;\r\n    this.usedByCurrentEffect = !!this.name && !!CjsParameter.getEffectResource(effectRes, this.name);\r\n  }\r\n\r\n  /**\r\n   * Always false - populating a resource set is device work this package does\r\n   * not do.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  CopyToResourceSet()\r\n  {\r\n    return false;\r\n  }\r\n\r\n  /** Always false - UAV binding is left to the engine adapter. */\r\n  @carbon.method\r\n  @impl.adapted\r\n  ApplyUav()\r\n  {\r\n    return false;\r\n  }\r\n\r\n  /**\r\n   * Whether a buffer object has actually been attached; an authored resourcePath\r\n   * alone does not make the parameter valid.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  IsValid()\r\n  {\r\n    return !!this.gpuBuffer;\r\n  }\r\n\r\n  /**\r\n   * Attaches a buffer object directly and clears the authored resource path, so\r\n   * the path can no longer override it.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  SetGpuBuffer(buffer)\r\n  {\r\n    this.resourcePath = \"\";\r\n    this.gpuBuffer = buffer;\r\n  }\r\n\r\n  /**\r\n   * The attached buffer object, or null; held by reference and never created\r\n   * here.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  GetGpuBuffer()\r\n  {\r\n    return this.gpuBuffer;\r\n  }\r\n\r\n}\r\n"],"names":["_Tr2GeometryBufferPar","Tr2GeometryBufferParameter","CjsParameter","e","_init_resourcePath","_init_extra_resourcePath","_init_gpuBuffer","_init_extra_gpuBuffer","_init_usedByCurrentEffect","_init_extra_usedByCurrentEffect","_init_meshIndex","_init_extra_meshIndex","_init_name","_init_extra_name","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","flag","notify","persist","string","objectRef","read","boolean","int32","carbon","method","impl","implemented","adapted","resourcePath","gpuBuffer","usedByCurrentEffect","meshIndex","name","cachedEffect","GetParameterName","GetHashValue","startingHash","FNV1_INITIAL","hashFnv1String","Initialize","OnModified","_options","__state","flags","delete","RebuildEffectHandles","effectRes","getEffectResource","CopyToResourceSet","ApplyUav","IsValid","SetGpuBuffer","buffer","GetGpuBuffer"],"mappings":"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"}

package/dist/shader/parameter/Tr2Matrix4Parameter.js

@@ -1,9 +1,14 @@
 import { applyDecs2311 as _applyDecs2311 } from '../../_virtual/_rollupPluginBabelHelpers.js';
-import { mat4 } from '@carbonenginejs/core-math/mat4';
-import { io, type, carbon, impl } from '@carbonenginejs/core-types/schema';
+import { mat4 } from '@carbonenginejs/runtime-utils/mat4';
+import { io, type, carbon, impl } from '@carbonenginejs/runtime-utils/schema';
 import { CjsVectorParameter } from './CjsVectorParameter.js';
 
 let _initProto, _initClass, _init_value, _init_extra_value, _init_usedByCurrentTechnique, _init_extra_usedByCurrentTechnique, _init_usedByCurrentEffect, _init_extra_usedByCurrentEffect, _init_name, _init_extra_name;
+
+/**
+ * 4x4 matrix value for a named shader constant, with optional rerouting into an
+ * external 64-byte destination.
+ */
 let _Tr2Matrix4Parameter;
 class Tr2Matrix4Parameter extends CjsVectorParameter {
   static {
@@ -21,6 +26,8 @@ class Tr2Matrix4Parameter extends CjsVectorParameter {
   name = (_init_extra_usedByCurrentEffect(this), _init_name(this, ""));
   #bindings = (_init_extra_name(this), []);
   #reroutedValue = null;
+
+  /** The shader constant name this matrix binds to; empty until authored. */
   GetParameterName() {
     return this.name;
   }
@@ -29,21 +36,38 @@ class Tr2Matrix4Parameter extends CjsVectorParameter {
   GetHashValue(startingHash = CjsVectorParameter.FNV1_INITIAL) {
     return CjsVectorParameter.hashFnv1String(this.name, CjsVectorParameter.hashFnv1Floats(this.value, startingHash));
   }
+
+  /**
+   * Refreshes from the reroute destination when one is set, then copies 16 components out.
+   * @param out defaults to a freshly allocated matrix the caller owns
+   */
   GetValue(out = mat4.create()) {
     if (this.#reroutedValue) {
       CjsVectorParameter.readVectorDestination(this.#reroutedValue, this.value, 16);
     }
     return CjsVectorParameter.copyNumberArray(out, this.value, 16);
   }
+
+  /**
+   * Copies 16 components in and writes through to the reroute destination when
+   * one is set.
+   */
   SetValue(value) {
     CjsVectorParameter.copyNumberArray(this.value, value, 16);
     if (this.#reroutedValue) {
       CjsVectorParameter.writeVectorDestination(this.#reroutedValue, this.value, 16);
     }
   }
+
+  /** Whether reads and writes currently go through an external destination. */
   IsRerouted() {
     return this.#reroutedValue !== null;
   }
+
+  /**
+   * Points the parameter at an external destination and seeds it with the current matrix; a target under 64 bytes or not writable as 16 components clears the reroute instead. Bindings are notified of the effective destination either way.
+   * @param size destination capacity in bytes, not components
+   */
   SetDestination(dest, size = 64) {
     if (size >= 64 && CjsVectorParameter.isVectorDestination(dest, 16)) {
       this.#reroutedValue = dest;
@@ -53,18 +77,37 @@ class Tr2Matrix4Parameter extends CjsVectorParameter {
     }
     CjsVectorParameter.notifyBindings(this.#bindings, this.GetDestination().dest);
   }
+
+  /**
+   * The array an upload should read - the reroute target when set, otherwise the
+   * parameter's own matrix - paired with its 64-byte size. The array is
+   * borrowed, not copied.
+   */
   GetDestination() {
     return {
       dest: this.#reroutedValue ?? this.value,
       size: 64
     };
   }
+
+  /**
+   * Adds a binding to be notified whenever the destination is repointed;
+   * duplicates are ignored.
+   */
   RegisterBinding(binding) {
     CjsVectorParameter.registerBinding(this.#bindings, binding);
   }
+
+  /** Stops notifying a binding; unknown bindings are ignored. */
   UnregisterBinding(binding) {
     CjsVectorParameter.unregisterBinding(this.#bindings, binding);
   }
+
+  /**
+   * Records whether the shader reflects a constant of this name and drops a
+   * stale reroute when the shader is gone; reflection metadata only, no GPU
+   * handle.
+   */
   RebuildEffectHandles(effectRes) {
     if (!effectRes && this.#reroutedValue) {
       this.SetDestination(null, 0);
@@ -73,12 +116,23 @@ class Tr2Matrix4Parameter extends CjsVectorParameter {
     this.usedByCurrentEffect = used;
     this.usedByCurrentTechnique = used;
   }
+
+  /**
+   * Seeds an existing reroute destination with the current matrix; always
+   * returns true.
+   */
   Initialize() {
     if (this.#reroutedValue) {
       CjsVectorParameter.writeVectorDestination(this.#reroutedValue, this.value, 16);
     }
     return true;
   }
+
+  /**
+   * Writes the 16 components an upload should use into the caller's destination,
+   * reading back through the reroute first; the stored element order is copied
+   * as-is, with no transpose.
+   */
   CopyValueToEffect(_inputType, out) {
     CjsVectorParameter.writeVectorDestination(out, this.GetValue(), 16);
   }

package/dist/shader/parameter/Tr2Matrix4Parameter.js.map

@@ -1 +1 @@
-{"version":3,"file":"Tr2Matrix4Parameter.js","sources":["../../../../src/shader/parameter/Tr2Matrix4Parameter.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\Shader\\Parameter\\Tr2Matrix4Parameter.h\n// Source: E:\\carbonengine\\trinity\\trinity\\Shader\\Parameter\\Tr2Matrix4Parameter.cpp\nimport { mat4 } from \"@carbonenginejs/core-math/mat4\";\nimport { carbon, impl, io, type } from \"@carbonenginejs/core-types/schema\";\nimport { CjsVectorParameter } from \"./CjsVectorParameter.js\";\n\n\n@type.define({\n  className: \"Tr2Matrix4Parameter\",\n  family: \"shader\"\n})\nexport class Tr2Matrix4Parameter extends CjsVectorParameter\n{\n  @io.persistOnly\n  @type.mat4\n  value = mat4.create();\n\n  @io.read\n  @type.boolean\n  usedByCurrentTechnique = false;\n\n  @io.read\n  @type.boolean\n  usedByCurrentEffect = false;\n\n  @io.notify\n  @io.persist\n  @type.string\n  name = \"\";\n\n  #bindings = [];\n\n  #reroutedValue = null;\n\n  @carbon.method\n  @impl.implemented\n  GetParameterName()\n  {\n    return this.name;\n  }\n\n  /** Content hash: matrix bytes then name. */\n  @carbon.method\n  @impl.adapted\n  GetHashValue(startingHash = CjsVectorParameter.FNV1_INITIAL)\n  {\n    return CjsVectorParameter.hashFnv1String(this.name, CjsVectorParameter.hashFnv1Floats(this.value, startingHash));\n  }\n\n  @carbon.method\n  @impl.implemented\n  GetValue(out = mat4.create())\n  {\n    if (this.#reroutedValue)\n    {\n      CjsVectorParameter.readVectorDestination(this.#reroutedValue, this.value, 16);\n    }\n    return CjsVectorParameter.copyNumberArray(out, this.value, 16);\n  }\n  @carbon.method\n  @impl.implemented\n  SetValue(value)\n  {\n    CjsVectorParameter.copyNumberArray(this.value, value, 16);\n    if (this.#reroutedValue)\n    {\n      CjsVectorParameter.writeVectorDestination(this.#reroutedValue, this.value, 16);\n    }\n  }\n  @carbon.method\n  @impl.implemented\n  IsRerouted()\n  {\n    return this.#reroutedValue !== null;\n  }\n  @carbon.method\n  @impl.adapted\n  SetDestination(dest, size = 64)\n  {\n    if (size >= 64 && CjsVectorParameter.isVectorDestination(dest, 16))\n    {\n      this.#reroutedValue = dest;\n      CjsVectorParameter.writeVectorDestination(dest, this.value, 16);\n    }\n    else\n    {\n      this.#reroutedValue = null;\n    }\n    CjsVectorParameter.notifyBindings(this.#bindings, this.GetDestination().dest);\n  }\n  @carbon.method\n  @impl.adapted\n  GetDestination()\n  {\n    return {\n      dest: this.#reroutedValue ?? this.value,\n      size: 64\n    };\n  }\n  @carbon.method\n  @impl.adapted\n  RegisterBinding(binding)\n  {\n    CjsVectorParameter.registerBinding(this.#bindings, binding);\n  }\n  @carbon.method\n  @impl.adapted\n  UnregisterBinding(binding)\n  {\n    CjsVectorParameter.unregisterBinding(this.#bindings, binding);\n  }\n  @carbon.method\n  @impl.adapted\n  RebuildEffectHandles(effectRes)\n  {\n    if (!effectRes && this.#reroutedValue)\n    {\n      this.SetDestination(null, 0);\n    }\n    const used = !!this.name && CjsVectorParameter.hasEffectConstant(effectRes, this.name);\n    this.usedByCurrentEffect = used;\n    this.usedByCurrentTechnique = used;\n  }\n  @carbon.method\n  @impl.implemented\n  Initialize()\n  {\n    if (this.#reroutedValue)\n    {\n      CjsVectorParameter.writeVectorDestination(this.#reroutedValue, this.value, 16);\n    }\n    return true;\n  }\n  @carbon.method\n  @impl.adapted\n  CopyValueToEffect(_inputType, out)\n  {\n    CjsVectorParameter.writeVectorDestination(out, this.GetValue(), 16);\n  }\n\n  /** JS convenience: raw values this parameter class claims for map-form inference. */\n  static isValue(value)\n  {\n    return CjsVectorParameter.isNumberArrayValue(value, 16);\n  }\n\n}\n"],"names":["_Tr2Matrix4Parameter","Tr2Matrix4Parameter","CjsVectorParameter","e","_init_value","_init_extra_value","_init_usedByCurrentTechnique","_init_extra_usedByCurrentTechnique","_init_usedByCurrentEffect","_init_extra_usedByCurrentEffect","_init_name","_init_extra_name","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","persistOnly","mat4","read","boolean","notify","persist","string","carbon","method","impl","implemented","adapted","value","create","usedByCurrentTechnique","usedByCurrentEffect","name","GetParameterName","GetHashValue","startingHash","FNV1_INITIAL","hashFnv1String","hashFnv1Floats","GetValue","out","readVectorDestination","copyNumberArray","SetValue","writeVectorDestination","IsRerouted","SetDestination","dest","size","isVectorDestination","notifyBindings","GetDestination","RegisterBinding","binding","registerBinding","UnregisterBinding","unregisterBinding","RebuildEffectHandles","effectRes","used","hasEffectConstant","Initialize","CopyValueToEffect","_inputType","isValue","isNumberArrayValue"],"mappings":"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"}
+{"version":3,"file":"Tr2Matrix4Parameter.js","sources":["../../../../src/shader/parameter/Tr2Matrix4Parameter.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\Shader\\Parameter\\Tr2Matrix4Parameter.h\n// Source: E:\\carbonengine\\trinity\\trinity\\Shader\\Parameter\\Tr2Matrix4Parameter.cpp\nimport { mat4 } from \"@carbonenginejs/runtime-utils/mat4\";\nimport { carbon, impl, io, type } from \"@carbonenginejs/runtime-utils/schema\";\nimport { CjsVectorParameter } from \"./CjsVectorParameter.js\";\n\n\n/**\n * 4x4 matrix value for a named shader constant, with optional rerouting into an\n * external 64-byte destination.\n */\n@type.define({\n  className: \"Tr2Matrix4Parameter\",\n  family: \"shader\"\n})\nexport class Tr2Matrix4Parameter extends CjsVectorParameter\n{\n  @io.persistOnly\n  @type.mat4\n  value = mat4.create();\n\n  @io.read\n  @type.boolean\n  usedByCurrentTechnique = false;\n\n  @io.read\n  @type.boolean\n  usedByCurrentEffect = false;\n\n  @io.notify\n  @io.persist\n  @type.string\n  name = \"\";\n\n  #bindings = [];\n\n  #reroutedValue = null;\n\n  /** The shader constant name this matrix binds to; empty until authored. */\n  @carbon.method\n  @impl.implemented\n  GetParameterName()\n  {\n    return this.name;\n  }\n\n  /** Content hash: matrix bytes then name. */\n  @carbon.method\n  @impl.adapted\n  GetHashValue(startingHash = CjsVectorParameter.FNV1_INITIAL)\n  {\n    return CjsVectorParameter.hashFnv1String(this.name, CjsVectorParameter.hashFnv1Floats(this.value, startingHash));\n  }\n\n  /**\n   * Refreshes from the reroute destination when one is set, then copies 16 components out.\n   * @param out defaults to a freshly allocated matrix the caller owns\n   */\n  @carbon.method\n  @impl.implemented\n  GetValue(out = mat4.create())\n  {\n    if (this.#reroutedValue)\n    {\n      CjsVectorParameter.readVectorDestination(this.#reroutedValue, this.value, 16);\n    }\n    return CjsVectorParameter.copyNumberArray(out, this.value, 16);\n  }\n\n  /**\n   * Copies 16 components in and writes through to the reroute destination when\n   * one is set.\n   */\n  @carbon.method\n  @impl.implemented\n  SetValue(value)\n  {\n    CjsVectorParameter.copyNumberArray(this.value, value, 16);\n    if (this.#reroutedValue)\n    {\n      CjsVectorParameter.writeVectorDestination(this.#reroutedValue, this.value, 16);\n    }\n  }\n\n  /** Whether reads and writes currently go through an external destination. */\n  @carbon.method\n  @impl.implemented\n  IsRerouted()\n  {\n    return this.#reroutedValue !== null;\n  }\n\n  /**\n   * Points the parameter at an external destination and seeds it with the current matrix; a target under 64 bytes or not writable as 16 components clears the reroute instead. Bindings are notified of the effective destination either way.\n   * @param size destination capacity in bytes, not components\n   */\n  @carbon.method\n  @impl.adapted\n  SetDestination(dest, size = 64)\n  {\n    if (size >= 64 && CjsVectorParameter.isVectorDestination(dest, 16))\n    {\n      this.#reroutedValue = dest;\n      CjsVectorParameter.writeVectorDestination(dest, this.value, 16);\n    }\n    else\n    {\n      this.#reroutedValue = null;\n    }\n    CjsVectorParameter.notifyBindings(this.#bindings, this.GetDestination().dest);\n  }\n\n  /**\n   * The array an upload should read - the reroute target when set, otherwise the\n   * parameter's own matrix - paired with its 64-byte size. The array is\n   * borrowed, not copied.\n   */\n  @carbon.method\n  @impl.adapted\n  GetDestination()\n  {\n    return {\n      dest: this.#reroutedValue ?? this.value,\n      size: 64\n    };\n  }\n\n  /**\n   * Adds a binding to be notified whenever the destination is repointed;\n   * duplicates are ignored.\n   */\n  @carbon.method\n  @impl.adapted\n  RegisterBinding(binding)\n  {\n    CjsVectorParameter.registerBinding(this.#bindings, binding);\n  }\n\n  /** Stops notifying a binding; unknown bindings are ignored. */\n  @carbon.method\n  @impl.adapted\n  UnregisterBinding(binding)\n  {\n    CjsVectorParameter.unregisterBinding(this.#bindings, binding);\n  }\n\n  /**\n   * Records whether the shader reflects a constant of this name and drops a\n   * stale reroute when the shader is gone; reflection metadata only, no GPU\n   * handle.\n   */\n  @carbon.method\n  @impl.adapted\n  RebuildEffectHandles(effectRes)\n  {\n    if (!effectRes && this.#reroutedValue)\n    {\n      this.SetDestination(null, 0);\n    }\n    const used = !!this.name && CjsVectorParameter.hasEffectConstant(effectRes, this.name);\n    this.usedByCurrentEffect = used;\n    this.usedByCurrentTechnique = used;\n  }\n\n  /**\n   * Seeds an existing reroute destination with the current matrix; always\n   * returns true.\n   */\n  @carbon.method\n  @impl.implemented\n  Initialize()\n  {\n    if (this.#reroutedValue)\n    {\n      CjsVectorParameter.writeVectorDestination(this.#reroutedValue, this.value, 16);\n    }\n    return true;\n  }\n\n  /**\n   * Writes the 16 components an upload should use into the caller's destination,\n   * reading back through the reroute first; the stored element order is copied\n   * as-is, with no transpose.\n   */\n  @carbon.method\n  @impl.adapted\n  CopyValueToEffect(_inputType, out)\n  {\n    CjsVectorParameter.writeVectorDestination(out, this.GetValue(), 16);\n  }\n\n  /** JS convenience: raw values this parameter class claims for map-form inference. */\n  static isValue(value)\n  {\n    return CjsVectorParameter.isNumberArrayValue(value, 16);\n  }\n\n}\n"],"names":["_Tr2Matrix4Parameter","Tr2Matrix4Parameter","CjsVectorParameter","e","_init_value","_init_extra_value","_init_usedByCurrentTechnique","_init_extra_usedByCurrentTechnique","_init_usedByCurrentEffect","_init_extra_usedByCurrentEffect","_init_name","_init_extra_name","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","persistOnly","mat4","read","boolean","notify","persist","string","carbon","method","impl","implemented","adapted","value","create","usedByCurrentTechnique","usedByCurrentEffect","name","GetParameterName","GetHashValue","startingHash","FNV1_INITIAL","hashFnv1String","hashFnv1Floats","GetValue","out","readVectorDestination","copyNumberArray","SetValue","writeVectorDestination","IsRerouted","SetDestination","dest","size","isVectorDestination","notifyBindings","GetDestination","RegisterBinding","binding","registerBinding","UnregisterBinding","unregisterBinding","RebuildEffectHandles","effectRes","used","hasEffectConstant","Initialize","CopyValueToEffect","_inputType","isValue","isNumberArrayValue"],"mappings":"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"}

package/dist/shader/parameter/Tr2RuntimeTextureParameter.js

@@ -1,8 +1,13 @@
 import { applyDecs2311 as _applyDecs2311 } from '../../_virtual/_rollupPluginBabelHelpers.js';
-import { io, type, carbon, impl } from '@carbonenginejs/core-types/schema';
+import { io, type, carbon, impl } from '@carbonenginejs/runtime-utils/schema';
 import { CjsParameter } from './CjsParameter.js';
 
 let _initProto, _initClass, _init_texture, _init_extra_texture, _init_name, _init_extra_name, _init_uavMipLevel, _init_extra_uavMipLevel;
+
+/**
+ * A named texture slot fed by a runtime-supplied texture provider rather than an
+ * authored res path.
+ */
 let _Tr2RuntimeTexturePar;
 class Tr2RuntimeTextureParameter extends CjsParameter {
   static {
@@ -18,9 +23,19 @@ class Tr2RuntimeTextureParameter extends CjsParameter {
   name = (_init_extra_texture(this), _init_name(this, ""));
   uavMipLevel = (_init_extra_name(this), _init_uavMipLevel(this, 0));
   #materials = (_init_extra_uavMipLevel(this), []);
+
+  /**
+   * Blue construction form: forwards the name, provider and UAV mip level to
+   * Create.
+   */
   __init__(name = "", texture = null, uavMipLevel = 0) {
     this.Create(name, texture, uavMipLevel);
   }
+
+  /**
+   * Assigns name, texture provider and UAV mip level together, notifying only
+   * when at least one of them actually changed; returns whether it did.
+   */
   Create(name, texture, uavMipLevel = 0) {
     const nextName = String(name);
     const nextMipLevel = uavMipLevel >>> 0;
@@ -37,6 +52,8 @@ class Tr2RuntimeTextureParameter extends CjsParameter {
     });
     return true;
   }
+
+  /** The shader resource name this texture binds to. */
   GetParameterName() {
     return this.name;
   }
@@ -45,15 +62,30 @@ class Tr2RuntimeTextureParameter extends CjsParameter {
   GetHashValue(startingHash = CjsParameter.FNV1_INITIAL) {
     return CjsParameter.hashFnv1Identity(this.texture, startingHash);
   }
+
+  /**
+   * Invalidates the resource sets of every material this parameter is attached
+   * to.
+   */
   OnModified(_options = {}) {
     this.#invalidateResourceSets();
     return true;
   }
+
+  /**
+   * Deliberately does nothing: Carbon caches the effect resource type here for
+   * later resource-set binding, which runtime-trinity leaves to engine adapters.
+   */
   RebuildEffectHandles(_effectRes) {
 
     // Carbon caches the effect resource type here for later resource-set
     // binding. Runtime-trinity leaves that realization to engine adapters.
   }
+
+  /**
+   * Swaps the texture provider and notifies owners; returns false when it is
+   * already the same object.
+   */
   SetTextureProvider(texture) {
     if (this.texture === texture) {
       return false;
@@ -65,23 +97,45 @@ class Tr2RuntimeTextureParameter extends CjsParameter {
     });
     return true;
   }
+
+  /**
+   * The attached provider, or null; this package holds the reference but never
+   * resolves or uploads it.
+   */
   GetTextureProvider() {
     return this.texture;
   }
+
+  /**
+   * Sets the mip level to use when this texture is bound as an unordered-access
+   * view, coerced to uint32.
+   */
   SetUavMipLevel(mipLevel) {
     this.uavMipLevel = mipLevel >>> 0;
   }
+
+  /**
+   * Registers a material to be invalidated when this parameter changes;
+   * duplicates are ignored.
+   */
   OnAddedToMaterial(material) {
     if (!this.#materials.includes(material)) {
       this.#materials.push(material);
     }
   }
+
+  /**
+   * Drops a material from the tracked list, so later texture swaps no longer
+   * invalidate its resource sets.
+   */
   OnRemovedFromMaterial(material) {
     const index = this.#materials.indexOf(material);
     if (index >= 0) {
       this.#materials.splice(index, 1);
     }
   }
+
+  /** Invalidates the resource sets of every attached material. */
   #invalidateResourceSets() {
     for (const material of this.#materials) {
       material?.InvalidateResourceSets?.();