@carbonenginejs/runtime-trinity 0.6.0 → 0.8.0

package/dist/shader/parameter/Tr2Vector2Parameter.js

@@ -5,6 +5,11 @@ 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;
+
+/**
+ * Two-component float value for a named shader constant, with sRGB gamma
+ * handling and optional rerouting into an external destination.
+ */
 let _Tr2Vector2Parameter;
 class Tr2Vector2Parameter extends CjsVectorParameter {
   static {
@@ -34,6 +39,11 @@ class Tr2Vector2Parameter extends CjsVectorParameter {
     this.GetValue();
     return this.value[0];
   }
+
+  /**
+   * Writes component 0 and marks the parameter dirty, so the next apply carries
+   * the new value.
+   */
   set x(component) {
     this.#setComponent(0, component);
   }
@@ -43,21 +53,36 @@ class Tr2Vector2Parameter extends CjsVectorParameter {
     this.GetValue();
     return this.value[1];
   }
+
+  /**
+   * Writes component 1 and marks the parameter dirty, so the next apply carries
+   * the new value.
+   */
   set y(component) {
     this.#setComponent(1, component);
   }
+
+  /** Blue MAP_PROPERTY alias reading `x`. */
   get v1() {
     return this.x;
   }
+
+  /** Blue MAP_PROPERTY alias writing `x`. */
   set v1(component) {
     this.x = component;
   }
+
+  /** Blue MAP_PROPERTY alias reading `y`. */
   get v2() {
     return this.y;
   }
+
+  /** Blue MAP_PROPERTY alias writing `y`. */
   set v2(component) {
     this.y = component;
   }
+
+  /** The shader constant name this value binds to; empty until authored. */
   GetParameterName() {
     return this.name;
   }
@@ -66,12 +91,22 @@ class Tr2Vector2Parameter 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 two components out.
+   * @param out defaults to the parameter's own value array, so a caller passing nothing gets a live reference rather than a copy
+   */
   GetValue(out = this.value) {
     if (this.#reroutedValue) {
       CjsVectorParameter.readVectorDestination(this.#reroutedValue, this.value, 2);
     }
     return CjsVectorParameter.copyNumberArray(out, this.value, 2);
   }
+
+  /**
+   * Copies two components in, refreshes the linear mirror and writes through to
+   * the reroute destination when one is set.
+   */
   SetValue(value) {
     CjsVectorParameter.copyNumberArray(this.value, value, 2);
     this.#updateLinearValue();
@@ -79,9 +114,20 @@ class Tr2Vector2Parameter extends CjsVectorParameter {
       CjsVectorParameter.writeVectorDestination(this.#reroutedValue, this.value, 2);
     }
   }
+
+  /**
+   * Whether reads and writes go through an external destination; an sRGB
+   * constant is never rerouted, because its value must be gamma-converted before
+   * upload.
+   */
   IsRerouted() {
     return !this.isSrgb && this.#reroutedValue !== null;
   }
+
+  /**
+   * Points the parameter at an external destination and seeds it with the current value; a target smaller than 8 bytes, not writable as two components, or belonging to an sRGB constant clears the reroute instead. Registered bindings are notified of the effective destination either way.
+   * @param size destination capacity in bytes, not components
+   */
   SetDestination(dest, size = 8) {
     if (size >= 8 && !this.isSrgb && CjsVectorParameter.isVectorDestination(dest, 2)) {
       this.#reroutedValue = dest;
@@ -92,18 +138,37 @@ class Tr2Vector2Parameter 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 value - paired with its 8-byte size. The array is borrowed,
+   * not copied.
+   */
   GetDestination() {
     return {
       dest: this.#reroutedValue ?? this.value,
       size: 8
     };
   }
+
+  /**
+   * 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);
   }
+
+  /**
+   * Re-resolves usage and the sRGB flag from the shader's reflected constant,
+   * dropping the reroute when the shader is gone or the constant turns out to be
+   * sRGB. Reads reflection metadata only; no GPU handle is bound.
+   */
   RebuildEffectHandles(effectRes) {
     this.isSrgb = false;
     if (!effectRes && this.#reroutedValue) {
@@ -119,6 +184,11 @@ class Tr2Vector2Parameter extends CjsVectorParameter {
     }
     this.#updateLinearValue();
   }
+
+  /**
+   * Seeds an existing reroute destination with the current value and refreshes
+   * the linear mirror; always returns true.
+   */
   Initialize() {
     if (this.#reroutedValue) {
       CjsVectorParameter.writeVectorDestination(this.#reroutedValue, this.value, 2);
@@ -126,6 +196,12 @@ class Tr2Vector2Parameter extends CjsVectorParameter {
     this.#updateLinearValue();
     return true;
   }
+
+  /**
+   * Writes the two components an upload should use into the caller's
+   * destination: the authored value while rerouted, otherwise the
+   * gamma-converted linear mirror for an sRGB constant.
+   */
   CopyValueToEffect(_inputType, out) {
     if (this.#reroutedValue) {
       CjsVectorParameter.writeVectorDestination(out, this.value, 2);
@@ -133,6 +209,11 @@ class Tr2Vector2Parameter extends CjsVectorParameter {
     }
     CjsVectorParameter.writeVectorDestination(out, this.isSrgb ? this.linearValue : this.value, 2);
   }
+
+  /**
+   * Refreshes the linear mirror: a plain copy when not sRGB, otherwise
+   * gamma-to-linear on both components.
+   */
   #updateLinearValue() {
     if (!this.isSrgb) {
       CjsVectorParameter.copyNumberArray(this.linearValue, this.value, 2);
@@ -141,6 +222,11 @@ class Tr2Vector2Parameter extends CjsVectorParameter {
     this.linearValue[0] = num.gammaToLinear(this.value[0]);
     this.linearValue[1] = num.gammaToLinear(this.value[1]);
   }
+
+  /**
+   * Assigns one component in place and re-runs SetValue so the linear mirror and
+   * any reroute stay in sync.
+   */
   #setComponent(index, component) {
     this.value[index] = Number(component);
     this.SetValue(this.value);

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

@@ -1 +1 @@
-{"version":3,"file":"Tr2Vector2Parameter.js","sources":["../../../../src/shader/parameter/Tr2Vector2Parameter.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\Shader\\Parameter\\Tr2Vector2Parameter.h\n// Source: E:\\carbonengine\\trinity\\trinity\\Shader\\Parameter\\Tr2Vector2Parameter.cpp\nimport { num } from \"@carbonenginejs/runtime-utils/num\";\nimport { vec2 } from \"@carbonenginejs/runtime-utils/vec2\";\nimport { carbon, impl, io, type } from \"@carbonenginejs/runtime-utils/schema\";\nimport { CjsVectorParameter } from \"./CjsVectorParameter.js\";\n\n\n@type.define({\n  className: \"Tr2Vector2Parameter\",\n  family: \"shader\"\n})\nexport class Tr2Vector2Parameter extends CjsVectorParameter\n{\n  @io.persistOnly\n  @type.vec2\n  value = vec2.fromValues(1, 1);\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  /** m_isSrgb - shader-annotation driven; not Blue-exposed on vec2 in Carbon. */\n  isSrgb = false;\n\n  /** m_linearValue - gamma-to-linear mirror uploaded when isSrgb. */\n  linearValue = vec2.fromValues(1, 1);\n\n  #bindings = [];\n\n  #reroutedValue = null;\n\n  /** Blue MAP_PROPERTY \"x\"/\"v1\" - refreshes from the rerouted value on read. */\n  get x()\n  {\n    this.GetValue();\n    return this.value[0];\n  }\n\n  set x(component)\n  {\n    this.#setComponent(0, component);\n  }\n\n  /** Blue MAP_PROPERTY \"y\"/\"v2\". */\n  get y()\n  {\n    this.GetValue();\n    return this.value[1];\n  }\n\n  set y(component)\n  {\n    this.#setComponent(1, component);\n  }\n\n  get v1()\n  {\n    return this.x;\n  }\n\n  set v1(component)\n  {\n    this.x = component;\n  }\n\n  get v2()\n  {\n    return this.y;\n  }\n\n  set v2(component)\n  {\n    this.y = component;\n  }\n\n  @carbon.method\n  @impl.implemented\n  GetParameterName()\n  {\n    return this.name;\n  }\n\n  /** Content hash: authored value 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 = this.value)\n  {\n    if (this.#reroutedValue)\n    {\n      CjsVectorParameter.readVectorDestination(this.#reroutedValue, this.value, 2);\n    }\n    return CjsVectorParameter.copyNumberArray(out, this.value, 2);\n  }\n\n  @carbon.method\n  @impl.implemented\n  SetValue(value)\n  {\n    CjsVectorParameter.copyNumberArray(this.value, value, 2);\n    this.#updateLinearValue();\n    if (this.#reroutedValue)\n    {\n      CjsVectorParameter.writeVectorDestination(this.#reroutedValue, this.value, 2);\n    }\n  }\n\n  @carbon.method\n  @impl.implemented\n  IsRerouted()\n  {\n    return !this.isSrgb && this.#reroutedValue !== null;\n  }\n\n  @carbon.method\n  @impl.adapted\n  SetDestination(dest, size = 8)\n  {\n    if (size >= 8 && !this.isSrgb && CjsVectorParameter.isVectorDestination(dest, 2))\n    {\n      this.#reroutedValue = dest;\n      CjsVectorParameter.writeVectorDestination(dest, this.value, 2);\n    }\n    else\n    {\n      this.#reroutedValue = null;\n      this.#updateLinearValue();\n    }\n    CjsVectorParameter.notifyBindings(this.#bindings, this.GetDestination().dest);\n  }\n\n  @carbon.method\n  @impl.adapted\n  GetDestination()\n  {\n    return {\n      dest: this.#reroutedValue ?? this.value,\n      size: 8\n    };\n  }\n\n  @carbon.method\n  @impl.adapted\n  RegisterBinding(binding)\n  {\n    CjsVectorParameter.registerBinding(this.#bindings, binding);\n  }\n\n  @carbon.method\n  @impl.adapted\n  UnregisterBinding(binding)\n  {\n    CjsVectorParameter.unregisterBinding(this.#bindings, binding);\n  }\n\n  @carbon.method\n  @impl.adapted\n  RebuildEffectHandles(effectRes)\n  {\n    this.isSrgb = false;\n    if (!effectRes && this.#reroutedValue)\n    {\n      this.SetDestination(null, 0);\n    }\n    const constant = this.name ? CjsVectorParameter.getEffectConstant(effectRes, this.name) : null;\n    const used = !!constant;\n    this.usedByCurrentEffect = used;\n    this.usedByCurrentTechnique = used;\n    this.isSrgb = CjsVectorParameter.getConstantIsSrgb(constant);\n    if (this.isSrgb)\n    {\n      this.SetDestination(null, 0);\n    }\n    this.#updateLinearValue();\n  }\n\n  @carbon.method\n  @impl.implemented\n  Initialize()\n  {\n    if (this.#reroutedValue)\n    {\n      CjsVectorParameter.writeVectorDestination(this.#reroutedValue, this.value, 2);\n    }\n    this.#updateLinearValue();\n    return true;\n  }\n\n  @carbon.method\n  @impl.adapted\n  CopyValueToEffect(_inputType, out)\n  {\n    if (this.#reroutedValue)\n    {\n      CjsVectorParameter.writeVectorDestination(out, this.value, 2);\n      return;\n    }\n    CjsVectorParameter.writeVectorDestination(out, this.isSrgb ? this.linearValue : this.value, 2);\n  }\n\n  #updateLinearValue()\n  {\n    if (!this.isSrgb)\n    {\n      CjsVectorParameter.copyNumberArray(this.linearValue, this.value, 2);\n      return;\n    }\n    this.linearValue[0] = num.gammaToLinear(this.value[0]);\n    this.linearValue[1] = num.gammaToLinear(this.value[1]);\n  }\n\n  #setComponent(index, component)\n  {\n    this.value[index] = Number(component);\n    this.SetValue(this.value);\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, 2);\n  }\n\n}\n"],"names":["_Tr2Vector2Parameter","Tr2Vector2Parameter","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","vec2","read","boolean","notify","persist","string","carbon","method","impl","implemented","adapted","value","fromValues","usedByCurrentTechnique","usedByCurrentEffect","name","isSrgb","linearValue","x","GetValue","component","y","v1","v2","GetParameterName","GetHashValue","startingHash","FNV1_INITIAL","hashFnv1String","hashFnv1Floats","out","readVectorDestination","copyNumberArray","SetValue","writeVectorDestination","IsRerouted","SetDestination","dest","size","isVectorDestination","notifyBindings","GetDestination","RegisterBinding","binding","registerBinding","UnregisterBinding","unregisterBinding","RebuildEffectHandles","effectRes","constant","getEffectConstant","used","getConstantIsSrgb","Initialize","CopyValueToEffect","_inputType","#updateLinearValue","num","gammaToLinear","#setComponent","index","Number","isValue","isNumberArrayValue"],"mappings":"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"}
+{"version":3,"file":"Tr2Vector2Parameter.js","sources":["../../../../src/shader/parameter/Tr2Vector2Parameter.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\Shader\\Parameter\\Tr2Vector2Parameter.h\n// Source: E:\\carbonengine\\trinity\\trinity\\Shader\\Parameter\\Tr2Vector2Parameter.cpp\nimport { num } from \"@carbonenginejs/runtime-utils/num\";\nimport { vec2 } from \"@carbonenginejs/runtime-utils/vec2\";\nimport { carbon, impl, io, type } from \"@carbonenginejs/runtime-utils/schema\";\nimport { CjsVectorParameter } from \"./CjsVectorParameter.js\";\n\n\n/**\n * Two-component float value for a named shader constant, with sRGB gamma\n * handling and optional rerouting into an external destination.\n */\n@type.define({\n  className: \"Tr2Vector2Parameter\",\n  family: \"shader\"\n})\nexport class Tr2Vector2Parameter extends CjsVectorParameter\n{\n  @io.persistOnly\n  @type.vec2\n  value = vec2.fromValues(1, 1);\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  /** m_isSrgb - shader-annotation driven; not Blue-exposed on vec2 in Carbon. */\n  isSrgb = false;\n\n  /** m_linearValue - gamma-to-linear mirror uploaded when isSrgb. */\n  linearValue = vec2.fromValues(1, 1);\n\n  #bindings = [];\n\n  #reroutedValue = null;\n\n  /** Blue MAP_PROPERTY \"x\"/\"v1\" - refreshes from the rerouted value on read. */\n  get x()\n  {\n    this.GetValue();\n    return this.value[0];\n  }\n\n  /**\n   * Writes component 0 and marks the parameter dirty, so the next apply carries\n   * the new value.\n   */\n  set x(component)\n  {\n    this.#setComponent(0, component);\n  }\n\n  /** Blue MAP_PROPERTY \"y\"/\"v2\". */\n  get y()\n  {\n    this.GetValue();\n    return this.value[1];\n  }\n\n  /**\n   * Writes component 1 and marks the parameter dirty, so the next apply carries\n   * the new value.\n   */\n  set y(component)\n  {\n    this.#setComponent(1, component);\n  }\n\n  /** Blue MAP_PROPERTY alias reading `x`. */\n  get v1()\n  {\n    return this.x;\n  }\n\n  /** Blue MAP_PROPERTY alias writing `x`. */\n  set v1(component)\n  {\n    this.x = component;\n  }\n\n  /** Blue MAP_PROPERTY alias reading `y`. */\n  get v2()\n  {\n    return this.y;\n  }\n\n  /** Blue MAP_PROPERTY alias writing `y`. */\n  set v2(component)\n  {\n    this.y = component;\n  }\n\n  /** The shader constant name this value binds to; empty until authored. */\n  @carbon.method\n  @impl.implemented\n  GetParameterName()\n  {\n    return this.name;\n  }\n\n  /** Content hash: authored value 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 two components out.\n   * @param out defaults to the parameter's own value array, so a caller passing nothing gets a live reference rather than a copy\n   */\n  @carbon.method\n  @impl.implemented\n  GetValue(out = this.value)\n  {\n    if (this.#reroutedValue)\n    {\n      CjsVectorParameter.readVectorDestination(this.#reroutedValue, this.value, 2);\n    }\n    return CjsVectorParameter.copyNumberArray(out, this.value, 2);\n  }\n\n  /**\n   * Copies two components in, refreshes the linear mirror and writes through to\n   * the reroute destination when one is set.\n   */\n  @carbon.method\n  @impl.implemented\n  SetValue(value)\n  {\n    CjsVectorParameter.copyNumberArray(this.value, value, 2);\n    this.#updateLinearValue();\n    if (this.#reroutedValue)\n    {\n      CjsVectorParameter.writeVectorDestination(this.#reroutedValue, this.value, 2);\n    }\n  }\n\n  /**\n   * Whether reads and writes go through an external destination; an sRGB\n   * constant is never rerouted, because its value must be gamma-converted before\n   * upload.\n   */\n  @carbon.method\n  @impl.implemented\n  IsRerouted()\n  {\n    return !this.isSrgb && this.#reroutedValue !== null;\n  }\n\n  /**\n   * Points the parameter at an external destination and seeds it with the current value; a target smaller than 8 bytes, not writable as two components, or belonging to an sRGB constant clears the reroute instead. Registered 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 = 8)\n  {\n    if (size >= 8 && !this.isSrgb && CjsVectorParameter.isVectorDestination(dest, 2))\n    {\n      this.#reroutedValue = dest;\n      CjsVectorParameter.writeVectorDestination(dest, this.value, 2);\n    }\n    else\n    {\n      this.#reroutedValue = null;\n      this.#updateLinearValue();\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 value - paired with its 8-byte size. The array is borrowed,\n   * not copied.\n   */\n  @carbon.method\n  @impl.adapted\n  GetDestination()\n  {\n    return {\n      dest: this.#reroutedValue ?? this.value,\n      size: 8\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   * Re-resolves usage and the sRGB flag from the shader's reflected constant,\n   * dropping the reroute when the shader is gone or the constant turns out to be\n   * sRGB. Reads reflection metadata only; no GPU handle is bound.\n   */\n  @carbon.method\n  @impl.adapted\n  RebuildEffectHandles(effectRes)\n  {\n    this.isSrgb = false;\n    if (!effectRes && this.#reroutedValue)\n    {\n      this.SetDestination(null, 0);\n    }\n    const constant = this.name ? CjsVectorParameter.getEffectConstant(effectRes, this.name) : null;\n    const used = !!constant;\n    this.usedByCurrentEffect = used;\n    this.usedByCurrentTechnique = used;\n    this.isSrgb = CjsVectorParameter.getConstantIsSrgb(constant);\n    if (this.isSrgb)\n    {\n      this.SetDestination(null, 0);\n    }\n    this.#updateLinearValue();\n  }\n\n  /**\n   * Seeds an existing reroute destination with the current value and refreshes\n   * the linear mirror; always returns true.\n   */\n  @carbon.method\n  @impl.implemented\n  Initialize()\n  {\n    if (this.#reroutedValue)\n    {\n      CjsVectorParameter.writeVectorDestination(this.#reroutedValue, this.value, 2);\n    }\n    this.#updateLinearValue();\n    return true;\n  }\n\n  /**\n   * Writes the two components an upload should use into the caller's\n   * destination: the authored value while rerouted, otherwise the\n   * gamma-converted linear mirror for an sRGB constant.\n   */\n  @carbon.method\n  @impl.adapted\n  CopyValueToEffect(_inputType, out)\n  {\n    if (this.#reroutedValue)\n    {\n      CjsVectorParameter.writeVectorDestination(out, this.value, 2);\n      return;\n    }\n    CjsVectorParameter.writeVectorDestination(out, this.isSrgb ? this.linearValue : this.value, 2);\n  }\n\n  /**\n   * Refreshes the linear mirror: a plain copy when not sRGB, otherwise\n   * gamma-to-linear on both components.\n   */\n  #updateLinearValue()\n  {\n    if (!this.isSrgb)\n    {\n      CjsVectorParameter.copyNumberArray(this.linearValue, this.value, 2);\n      return;\n    }\n    this.linearValue[0] = num.gammaToLinear(this.value[0]);\n    this.linearValue[1] = num.gammaToLinear(this.value[1]);\n  }\n\n  /**\n   * Assigns one component in place and re-runs SetValue so the linear mirror and\n   * any reroute stay in sync.\n   */\n  #setComponent(index, component)\n  {\n    this.value[index] = Number(component);\n    this.SetValue(this.value);\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, 2);\n  }\n\n}\n"],"names":["_Tr2Vector2Parameter","Tr2Vector2Parameter","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","vec2","read","boolean","notify","persist","string","carbon","method","impl","implemented","adapted","value","fromValues","usedByCurrentTechnique","usedByCurrentEffect","name","isSrgb","linearValue","x","GetValue","component","y","v1","v2","GetParameterName","GetHashValue","startingHash","FNV1_INITIAL","hashFnv1String","hashFnv1Floats","out","readVectorDestination","copyNumberArray","SetValue","writeVectorDestination","IsRerouted","SetDestination","dest","size","isVectorDestination","notifyBindings","GetDestination","RegisterBinding","binding","registerBinding","UnregisterBinding","unregisterBinding","RebuildEffectHandles","effectRes","constant","getEffectConstant","used","getConstantIsSrgb","Initialize","CopyValueToEffect","_inputType","#updateLinearValue","num","gammaToLinear","#setComponent","index","Number","isValue","isNumberArrayValue"],"mappings":";;;;;;;;AAQA;AACA;AACA;AACA;AAHA,IAAAA;AAIA,MAAAC,mBAAA,SAIyCC,kBAAkB,CAC3D;AAAA,EAAA;AAAA,IAAA,CAAA;AAAAC,MAAAA,CAAA,GAAAC,WAAA,EAAAC,iBAAA,EAAAC,4BAAA,EAAAC,kCAAA,EAAAC,yBAAA,EAAAC,+BAAA,EAAAC,UAAA,EAAAC,gBAAA,EAAAC,UAAA,CAAA;MAAAC,CAAA,EAAA,CAAAb,oBAAA,EAAAc,UAAA;AAAA,KAAA,GAAAC,cAAA,CAAA,IAAA,EAAA,CALCC,IAAI,CAACC,MAAM,CAAC;AACXC,MAAAA,SAAS,EAAE,qBAAqB;AAChCC,MAAAA,MAAM,EAAE;KACT,CAAC,MAGCC,EAAE,EAAFA,EAAE,CAACC,WAAW,EACdL,IAAI,EAAJA,IAAI,CAACM,IAAI,mBAGTF,EAAE,EAAFA,EAAE,CAACG,IAAI,EACPP,IAAI,EAAJA,IAAI,CAACQ,OAAO,CAAA,EAAA,EAAA,EAAA,wBAAA,CAAA,EAAA,CAAA,CAGZJ,EAAE,EAAFA,EAAE,CAACG,IAAI,EACPP,IAAI,EAAJA,IAAI,CAACQ,OAAO,CAAA,EAAA,EAAA,EAAA,qBAAA,CAAA,EAAA,CAAA,CAGZJ,EAAE,EAAFA,EAAE,CAACK,MAAM,EACTL,EAAE,EAAFA,EAAE,CAACM,OAAO,EACVV,IAAI,EAAJA,IAAI,CAACW,MAAM,kBAsEXC,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACC,WAAW,8BAOhBH,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACE,OAAO,CAAA,EAAA,EAAA,EAAA,cAAA,CAAA,EAAA,CAAA,CAUZJ,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACC,WAAW,CAAA,EAAA,EAAA,EAAA,UAAA,CAAA,EAAA,CAAA,CAchBH,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACC,WAAW,sBAgBhBH,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACC,WAAW,wBAUhBH,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACE,OAAO,CAAA,EAAA,EAAA,EAAA,gBAAA,CAAA,EAAA,CAAA,CAqBZJ,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACE,OAAO,CAAA,EAAA,EAAA,EAAA,gBAAA,CAAA,EAAA,CAAA,CAaZJ,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,CAAA,EAAA,EAAA,EAAA,sBAAA,CAAA,EAAA,CAAA,CAwBZJ,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACC,WAAW,CAAA,EAAA,EAAA,EAAA,YAAA,CAAA,EAAA,CAAA,CAgBhBH,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACE,OAAO,CAAA,EAAA,EAAA,EAAA,mBAAA,CAAA,CAAA,EAAA,CAAA,EAAA,MAAA,EAvP0B9B,kBAAkB,CAAA;AAAA;AAIzD+B,EAAAA,KAAK,IAAArB,UAAA,CAAA,IAAA,CAAA,EAAAR,WAAA,CAAA,IAAA,EAAGkB,IAAI,CAACY,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;AAI7BC,EAAAA,sBAAsB,IAAA9B,iBAAA,CAAA,IAAA,CAAA,EAAAC,4BAAA,OAAG,KAAK,CAAA;AAI9B8B,EAAAA,mBAAmB,IAAA7B,kCAAA,CAAA,IAAA,CAAA,EAAAC,yBAAA,OAAG,KAAK,CAAA;AAK3B6B,EAAAA,IAAI,IAAA5B,+BAAA,CAAA,IAAA,CAAA,EAAAC,UAAA,OAAG,EAAE,CAAA;;AAET;EACA4B,MAAM,IAAA3B,gBAAA,CAAA,IAAA,CAAA,EAAG,KAAK;;AAEd;EACA4B,WAAW,GAAGjB,IAAI,CAACY,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC;EAEnC,SAAS,GAAG,EAAE;EAEd,cAAc,GAAG,IAAI;;AAErB;EACA,IAAIM,CAACA,GACL;IACE,IAAI,CAACC,QAAQ,EAAE;AACf,IAAA,OAAO,IAAI,CAACR,KAAK,CAAC,CAAC,CAAC;AACtB,EAAA;;AAEA;AACF;AACA;AACA;EACE,IAAIO,CAACA,CAACE,SAAS,EACf;AACE,IAAA,IAAI,CAAC,aAAa,CAAC,CAAC,EAAEA,SAAS,CAAC;AAClC,EAAA;;AAEA;EACA,IAAIC,CAACA,GACL;IACE,IAAI,CAACF,QAAQ,EAAE;AACf,IAAA,OAAO,IAAI,CAACR,KAAK,CAAC,CAAC,CAAC;AACtB,EAAA;;AAEA;AACF;AACA;AACA;EACE,IAAIU,CAACA,CAACD,SAAS,EACf;AACE,IAAA,IAAI,CAAC,aAAa,CAAC,CAAC,EAAEA,SAAS,CAAC;AAClC,EAAA;;AAEA;EACA,IAAIE,EAAEA,GACN;IACE,OAAO,IAAI,CAACJ,CAAC;AACf,EAAA;;AAEA;EACA,IAAII,EAAEA,CAACF,SAAS,EAChB;IACE,IAAI,CAACF,CAAC,GAAGE,SAAS;AACpB,EAAA;;AAEA;EACA,IAAIG,EAAEA,GACN;IACE,OAAO,IAAI,CAACF,CAAC;AACf,EAAA;;AAEA;EACA,IAAIE,EAAEA,CAACH,SAAS,EAChB;IACE,IAAI,CAACC,CAAC,GAAGD,SAAS;AACpB,EAAA;;AAEA;AAGAI,EAAAA,gBAAgBA,GAChB;IACE,OAAO,IAAI,CAACT,IAAI;AAClB,EAAA;;AAEA;AAGAU,EAAAA,YAAYA,CAACC,YAAY,GAAG9C,kBAAkB,CAAC+C,YAAY,EAC3D;AACE,IAAA,OAAO/C,kBAAkB,CAACgD,cAAc,CAAC,IAAI,CAACb,IAAI,EAAEnC,kBAAkB,CAACiD,cAAc,CAAC,IAAI,CAAClB,KAAK,EAAEe,YAAY,CAAC,CAAC;AAClH,EAAA;;AAEA;AACF;AACA;AACA;AAGEP,EAAAA,QAAQA,CAACW,GAAG,GAAG,IAAI,CAACnB,KAAK,EACzB;AACE,IAAA,IAAI,IAAI,CAAC,cAAc,EACvB;AACE/B,MAAAA,kBAAkB,CAACmD,qBAAqB,CAAC,IAAI,CAAC,cAAc,EAAE,IAAI,CAACpB,KAAK,EAAE,CAAC,CAAC;AAC9E,IAAA;IACA,OAAO/B,kBAAkB,CAACoD,eAAe,CAACF,GAAG,EAAE,IAAI,CAACnB,KAAK,EAAE,CAAC,CAAC;AAC/D,EAAA;;AAEA;AACF;AACA;AACA;EAGEsB,QAAQA,CAACtB,KAAK,EACd;IACE/B,kBAAkB,CAACoD,eAAe,CAAC,IAAI,CAACrB,KAAK,EAAEA,KAAK,EAAE,CAAC,CAAC;AACxD,IAAA,IAAI,CAAC,kBAAkB,EAAE;AACzB,IAAA,IAAI,IAAI,CAAC,cAAc,EACvB;AACE/B,MAAAA,kBAAkB,CAACsD,sBAAsB,CAAC,IAAI,CAAC,cAAc,EAAE,IAAI,CAACvB,KAAK,EAAE,CAAC,CAAC;AAC/E,IAAA;AACF,EAAA;;AAEA;AACF;AACA;AACA;AACA;AAGEwB,EAAAA,UAAUA,GACV;IACE,OAAO,CAAC,IAAI,CAACnB,MAAM,IAAI,IAAI,CAAC,cAAc,KAAK,IAAI;AACrD,EAAA;;AAEA;AACF;AACA;AACA;AAGEoB,EAAAA,cAAcA,CAACC,IAAI,EAAEC,IAAI,GAAG,CAAC,EAC7B;AACE,IAAA,IAAIA,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,CAACtB,MAAM,IAAIpC,kBAAkB,CAAC2D,mBAAmB,CAACF,IAAI,EAAE,CAAC,CAAC,EAChF;AACE,MAAA,IAAI,CAAC,cAAc,GAAGA,IAAI;MAC1BzD,kBAAkB,CAACsD,sBAAsB,CAACG,IAAI,EAAE,IAAI,CAAC1B,KAAK,EAAE,CAAC,CAAC;AAChE,IAAA,CAAC,MAED;AACE,MAAA,IAAI,CAAC,cAAc,GAAG,IAAI;AAC1B,MAAA,IAAI,CAAC,kBAAkB,EAAE;AAC3B,IAAA;AACA/B,IAAAA,kBAAkB,CAAC4D,cAAc,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAACC,cAAc,EAAE,CAACJ,IAAI,CAAC;AAC/E,EAAA;;AAEA;AACF;AACA;AACA;AACA;AAGEI,EAAAA,cAAcA,GACd;IACE,OAAO;MACLJ,IAAI,EAAE,IAAI,CAAC,cAAc,IAAI,IAAI,CAAC1B,KAAK;AACvC2B,MAAAA,IAAI,EAAE;KACP;AACH,EAAA;;AAEA;AACF;AACA;AACA;EAGEI,eAAeA,CAACC,OAAO,EACvB;IACE/D,kBAAkB,CAACgE,eAAe,CAAC,IAAI,CAAC,SAAS,EAAED,OAAO,CAAC;AAC7D,EAAA;;AAEA;EAGAE,iBAAiBA,CAACF,OAAO,EACzB;IACE/D,kBAAkB,CAACkE,iBAAiB,CAAC,IAAI,CAAC,SAAS,EAAEH,OAAO,CAAC;AAC/D,EAAA;;AAEA;AACF;AACA;AACA;AACA;EAGEI,oBAAoBA,CAACC,SAAS,EAC9B;IACE,IAAI,CAAChC,MAAM,GAAG,KAAK;AACnB,IAAA,IAAI,CAACgC,SAAS,IAAI,IAAI,CAAC,cAAc,EACrC;AACE,MAAA,IAAI,CAACZ,cAAc,CAAC,IAAI,EAAE,CAAC,CAAC;AAC9B,IAAA;AACA,IAAA,MAAMa,QAAQ,GAAG,IAAI,CAAClC,IAAI,GAAGnC,kBAAkB,CAACsE,iBAAiB,CAACF,SAAS,EAAE,IAAI,CAACjC,IAAI,CAAC,GAAG,IAAI;AAC9F,IAAA,MAAMoC,IAAI,GAAG,CAAC,CAACF,QAAQ;IACvB,IAAI,CAACnC,mBAAmB,GAAGqC,IAAI;IAC/B,IAAI,CAACtC,sBAAsB,GAAGsC,IAAI;IAClC,IAAI,CAACnC,MAAM,GAAGpC,kBAAkB,CAACwE,iBAAiB,CAACH,QAAQ,CAAC;IAC5D,IAAI,IAAI,CAACjC,MAAM,EACf;AACE,MAAA,IAAI,CAACoB,cAAc,CAAC,IAAI,EAAE,CAAC,CAAC;AAC9B,IAAA;AACA,IAAA,IAAI,CAAC,kBAAkB,EAAE;AAC3B,EAAA;;AAEA;AACF;AACA;AACA;AAGEiB,EAAAA,UAAUA,GACV;AACE,IAAA,IAAI,IAAI,CAAC,cAAc,EACvB;AACEzE,MAAAA,kBAAkB,CAACsD,sBAAsB,CAAC,IAAI,CAAC,cAAc,EAAE,IAAI,CAACvB,KAAK,EAAE,CAAC,CAAC;AAC/E,IAAA;AACA,IAAA,IAAI,CAAC,kBAAkB,EAAE;AACzB,IAAA,OAAO,IAAI;AACb,EAAA;;AAEA;AACF;AACA;AACA;AACA;AAGE2C,EAAAA,iBAAiBA,CAACC,UAAU,EAAEzB,GAAG,EACjC;AACE,IAAA,IAAI,IAAI,CAAC,cAAc,EACvB;MACElD,kBAAkB,CAACsD,sBAAsB,CAACJ,GAAG,EAAE,IAAI,CAACnB,KAAK,EAAE,CAAC,CAAC;AAC7D,MAAA;AACF,IAAA;AACA/B,IAAAA,kBAAkB,CAACsD,sBAAsB,CAACJ,GAAG,EAAE,IAAI,CAACd,MAAM,GAAG,IAAI,CAACC,WAAW,GAAG,IAAI,CAACN,KAAK,EAAE,CAAC,CAAC;AAChG,EAAA;;AAEA;AACF;AACA;AACA;EACE,kBAAkB6C,GAClB;AACE,IAAA,IAAI,CAAC,IAAI,CAACxC,MAAM,EAChB;AACEpC,MAAAA,kBAAkB,CAACoD,eAAe,CAAC,IAAI,CAACf,WAAW,EAAE,IAAI,CAACN,KAAK,EAAE,CAAC,CAAC;AACnE,MAAA;AACF,IAAA;AACA,IAAA,IAAI,CAACM,WAAW,CAAC,CAAC,CAAC,GAAGwC,GAAG,CAACC,aAAa,CAAC,IAAI,CAAC/C,KAAK,CAAC,CAAC,CAAC,CAAC;AACtD,IAAA,IAAI,CAACM,WAAW,CAAC,CAAC,CAAC,GAAGwC,GAAG,CAACC,aAAa,CAAC,IAAI,CAAC/C,KAAK,CAAC,CAAC,CAAC,CAAC;AACxD,EAAA;;AAEA;AACF;AACA;AACA;AACE,EAAA,aAAagD,CAACC,KAAK,EAAExC,SAAS,EAC9B;IACE,IAAI,CAACT,KAAK,CAACiD,KAAK,CAAC,GAAGC,MAAM,CAACzC,SAAS,CAAC;AACrC,IAAA,IAAI,CAACa,QAAQ,CAAC,IAAI,CAACtB,KAAK,CAAC;AAC3B,EAAA;;AAEA;EACA,OAAOmD,OAAOA,CAACnD,KAAK,EACpB;AACE,IAAA,OAAO/B,kBAAkB,CAACmF,kBAAkB,CAACpD,KAAK,EAAE,CAAC,CAAC;AACxD,EAAA;AAAC,EAAA;IAAAnB,UAAA,EAAA;AAAA;AAEH;;;;"}

package/dist/shader/parameter/Tr2Vector3Parameter.js

@@ -5,6 +5,11 @@ 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;
+
+/**
+ * Three-component float value for a named shader constant, with sRGB gamma
+ * handling and optional rerouting into an external destination.
+ */
 let _Tr2Vector3Parameter;
 class Tr2Vector3Parameter extends CjsVectorParameter {
   static {
@@ -34,6 +39,11 @@ class Tr2Vector3Parameter extends CjsVectorParameter {
     this.GetValue();
     return this.value[0];
   }
+
+  /**
+   * Writes component 0 and marks the parameter dirty, so the next apply carries
+   * the new value.
+   */
   set x(component) {
     this.#setComponent(0, component);
   }
@@ -43,6 +53,11 @@ class Tr2Vector3Parameter extends CjsVectorParameter {
     this.GetValue();
     return this.value[1];
   }
+
+  /**
+   * Writes component 1 and marks the parameter dirty, so the next apply carries
+   * the new value.
+   */
   set y(component) {
     this.#setComponent(1, component);
   }
@@ -52,27 +67,46 @@ class Tr2Vector3Parameter extends CjsVectorParameter {
     this.GetValue();
     return this.value[2];
   }
+
+  /**
+   * Writes component 2 and marks the parameter dirty, so the next apply carries
+   * the new value.
+   */
   set z(component) {
     this.#setComponent(2, component);
   }
+
+  /** Blue MAP_PROPERTY alias reading `x`. */
   get v1() {
     return this.x;
   }
+
+  /** Blue MAP_PROPERTY alias writing `x`. */
   set v1(component) {
     this.x = component;
   }
+
+  /** Blue MAP_PROPERTY alias reading `y`. */
   get v2() {
     return this.y;
   }
+
+  /** Blue MAP_PROPERTY alias writing `y`. */
   set v2(component) {
     this.y = component;
   }
+
+  /** Blue MAP_PROPERTY alias reading `z`. */
   get v3() {
     return this.z;
   }
+
+  /** Blue MAP_PROPERTY alias writing `z`. */
   set v3(component) {
     this.z = component;
   }
+
+  /** The shader constant name this value binds to; empty until authored. */
   GetParameterName() {
     return this.name;
   }
@@ -81,12 +115,22 @@ class Tr2Vector3Parameter 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 three components out.
+   * @param out defaults to the parameter's own value array, so a caller passing nothing gets a live reference rather than a copy
+   */
   GetValue(out = this.value) {
     if (this.#reroutedValue) {
       CjsVectorParameter.readVectorDestination(this.#reroutedValue, this.value, 3);
     }
     return CjsVectorParameter.copyNumberArray(out, this.value, 3);
   }
+
+  /**
+   * Copies three components in, refreshes the linear mirror and writes through
+   * to the reroute destination when one is set.
+   */
   SetValue(value) {
     CjsVectorParameter.copyNumberArray(this.value, value, 3);
     this.#updateLinearValue();
@@ -94,9 +138,20 @@ class Tr2Vector3Parameter extends CjsVectorParameter {
       CjsVectorParameter.writeVectorDestination(this.#reroutedValue, this.value, 3);
     }
   }
+
+  /**
+   * Whether reads and writes go through an external destination; an sRGB
+   * constant is never rerouted, because its value must be gamma-converted before
+   * upload.
+   */
   IsRerouted() {
     return !this.isSrgb && this.#reroutedValue !== null;
   }
+
+  /**
+   * Points the parameter at an external destination and seeds it with the current value; a target smaller than 12 bytes, not writable as three components, or belonging to an sRGB constant clears the reroute instead. Registered bindings are notified of the effective destination either way.
+   * @param size destination capacity in bytes, not components
+   */
   SetDestination(dest, size = 12) {
     if (size >= 12 && !this.isSrgb && CjsVectorParameter.isVectorDestination(dest, 3)) {
       this.#reroutedValue = dest;
@@ -107,18 +162,37 @@ class Tr2Vector3Parameter 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 value - paired with its 12-byte size. The array is borrowed,
+   * not copied.
+   */
   GetDestination() {
     return {
       dest: this.#reroutedValue ?? this.value,
       size: 12
     };
   }
+
+  /**
+   * 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);
   }
+
+  /**
+   * Re-resolves usage and the sRGB flag from the shader's reflected constant,
+   * dropping the reroute when the shader is gone or the constant turns out to be
+   * sRGB. Reads reflection metadata only; no GPU handle is bound.
+   */
   RebuildEffectHandles(effectRes) {
     this.isSrgb = false;
     if (!effectRes && this.#reroutedValue) {
@@ -134,6 +208,11 @@ class Tr2Vector3Parameter extends CjsVectorParameter {
     }
     this.#updateLinearValue();
   }
+
+  /**
+   * Seeds an existing reroute destination with the current value and refreshes
+   * the linear mirror; always returns true.
+   */
   Initialize() {
     if (this.#reroutedValue) {
       CjsVectorParameter.writeVectorDestination(this.#reroutedValue, this.value, 3);
@@ -141,6 +220,12 @@ class Tr2Vector3Parameter extends CjsVectorParameter {
     this.#updateLinearValue();
     return true;
   }
+
+  /**
+   * Writes the three components an upload should use into the caller's
+   * destination: the authored value while rerouted, otherwise the
+   * gamma-converted linear mirror for an sRGB constant.
+   */
   CopyValueToEffect(_inputType, out) {
     if (this.#reroutedValue) {
       CjsVectorParameter.writeVectorDestination(out, this.value, 3);
@@ -148,6 +233,11 @@ class Tr2Vector3Parameter extends CjsVectorParameter {
     }
     CjsVectorParameter.writeVectorDestination(out, this.isSrgb ? this.linearValue : this.value, 3);
   }
+
+  /**
+   * Refreshes the linear mirror: a plain copy when not sRGB, otherwise
+   * gamma-to-linear on all three components.
+   */
   #updateLinearValue() {
     if (!this.isSrgb) {
       CjsVectorParameter.copyNumberArray(this.linearValue, this.value, 3);
@@ -157,6 +247,11 @@ class Tr2Vector3Parameter extends CjsVectorParameter {
     this.linearValue[1] = num.gammaToLinear(this.value[1]);
     this.linearValue[2] = num.gammaToLinear(this.value[2]);
   }
+
+  /**
+   * Assigns one component in place and re-runs SetValue so the linear mirror and
+   * any reroute stay in sync.
+   */
   #setComponent(index, component) {
     this.value[index] = Number(component);
     this.SetValue(this.value);

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

@@ -1 +1 @@
-{"version":3,"file":"Tr2Vector3Parameter.js","sources":["../../../../src/shader/parameter/Tr2Vector3Parameter.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\Shader\\Parameter\\Tr2Vector3Parameter.h\n// Source: E:\\carbonengine\\trinity\\trinity\\Shader\\Parameter\\Tr2Vector3Parameter.cpp\nimport { num } from \"@carbonenginejs/runtime-utils/num\";\nimport { vec3 } from \"@carbonenginejs/runtime-utils/vec3\";\nimport { carbon, impl, io, type } from \"@carbonenginejs/runtime-utils/schema\";\nimport { CjsVectorParameter } from \"./CjsVectorParameter.js\";\n\n\n@type.define({\n  className: \"Tr2Vector3Parameter\",\n  family: \"shader\"\n})\nexport class Tr2Vector3Parameter extends CjsVectorParameter\n{\n\n  @io.persistOnly\n  @type.vec3\n  value = vec3.fromValues(1, 1, 1);\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  /** m_isSrgb - shader-annotation driven; not Blue-exposed on vec3 in Carbon. */\n  isSrgb = false;\n\n  /** m_linearValue - gamma-to-linear mirror uploaded when isSrgb. */\n  linearValue = vec3.fromValues(1, 1, 1);\n\n  #bindings = [];\n\n  #reroutedValue = null;\n\n  /** Blue MAP_PROPERTY \"x\"/\"v1\" - refreshes from the rerouted value on read. */\n  get x()\n  {\n    this.GetValue();\n    return this.value[0];\n  }\n\n  set x(component)\n  {\n    this.#setComponent(0, component);\n  }\n\n  /** Blue MAP_PROPERTY \"y\"/\"v2\". */\n  get y()\n  {\n    this.GetValue();\n    return this.value[1];\n  }\n\n  set y(component)\n  {\n    this.#setComponent(1, component);\n  }\n\n  /** Blue MAP_PROPERTY \"z\"/\"v3\". */\n  get z()\n  {\n    this.GetValue();\n    return this.value[2];\n  }\n\n  set z(component)\n  {\n    this.#setComponent(2, component);\n  }\n\n  get v1()\n  {\n    return this.x;\n  }\n\n  set v1(component)\n  {\n    this.x = component;\n  }\n\n  get v2()\n  {\n    return this.y;\n  }\n\n  set v2(component)\n  {\n    this.y = component;\n  }\n\n  get v3()\n  {\n    return this.z;\n  }\n\n  set v3(component)\n  {\n    this.z = component;\n  }\n\n  @carbon.method\n  @impl.implemented\n  GetParameterName()\n  {\n    return this.name;\n  }\n\n  /** Content hash: authored value 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 = this.value)\n  {\n    if (this.#reroutedValue)\n    {\n      CjsVectorParameter.readVectorDestination(this.#reroutedValue, this.value, 3);\n    }\n    return CjsVectorParameter.copyNumberArray(out, this.value, 3);\n  }\n\n  @carbon.method\n  @impl.implemented\n  SetValue(value)\n  {\n    CjsVectorParameter.copyNumberArray(this.value, value, 3);\n    this.#updateLinearValue();\n    if (this.#reroutedValue)\n    {\n      CjsVectorParameter.writeVectorDestination(this.#reroutedValue, this.value, 3);\n    }\n  }\n\n  @carbon.method\n  @impl.implemented\n  IsRerouted()\n  {\n    return !this.isSrgb && this.#reroutedValue !== null;\n  }\n\n  @carbon.method\n  @impl.adapted\n  SetDestination(dest, size = 12)\n  {\n    if (size >= 12 && !this.isSrgb && CjsVectorParameter.isVectorDestination(dest, 3))\n    {\n      this.#reroutedValue = dest;\n      CjsVectorParameter.writeVectorDestination(dest, this.value, 3);\n    }\n    else\n    {\n      this.#reroutedValue = null;\n      this.#updateLinearValue();\n    }\n    CjsVectorParameter.notifyBindings(this.#bindings, this.GetDestination().dest);\n  }\n\n  @carbon.method\n  @impl.adapted\n  GetDestination()\n  {\n    return {\n      dest: this.#reroutedValue ?? this.value,\n      size: 12\n    };\n  }\n\n  @carbon.method\n  @impl.adapted\n  RegisterBinding(binding)\n  {\n    CjsVectorParameter.registerBinding(this.#bindings, binding);\n  }\n\n  @carbon.method\n  @impl.adapted\n  UnregisterBinding(binding)\n  {\n    CjsVectorParameter.unregisterBinding(this.#bindings, binding);\n  }\n\n  @carbon.method\n  @impl.adapted\n  RebuildEffectHandles(effectRes)\n  {\n    this.isSrgb = false;\n    if (!effectRes && this.#reroutedValue)\n    {\n      this.SetDestination(null, 0);\n    }\n    const constant = this.name ? CjsVectorParameter.getEffectConstant(effectRes, this.name) : null;\n    const used = !!constant;\n    this.usedByCurrentEffect = used;\n    this.usedByCurrentTechnique = used;\n    this.isSrgb = CjsVectorParameter.getConstantIsSrgb(constant);\n    if (this.isSrgb)\n    {\n      this.SetDestination(null, 0);\n    }\n    this.#updateLinearValue();\n  }\n\n  @carbon.method\n  @impl.implemented\n  Initialize()\n  {\n    if (this.#reroutedValue)\n    {\n      CjsVectorParameter.writeVectorDestination(this.#reroutedValue, this.value, 3);\n    }\n    this.#updateLinearValue();\n    return true;\n  }\n\n  @carbon.method\n  @impl.adapted\n  CopyValueToEffect(_inputType, out)\n  {\n    if (this.#reroutedValue)\n    {\n      CjsVectorParameter.writeVectorDestination(out, this.value, 3);\n      return;\n    }\n    CjsVectorParameter.writeVectorDestination(out, this.isSrgb ? this.linearValue : this.value, 3);\n  }\n\n  #updateLinearValue()\n  {\n    if (!this.isSrgb)\n    {\n      CjsVectorParameter.copyNumberArray(this.linearValue, this.value, 3);\n      return;\n    }\n    this.linearValue[0] = num.gammaToLinear(this.value[0]);\n    this.linearValue[1] = num.gammaToLinear(this.value[1]);\n    this.linearValue[2] = num.gammaToLinear(this.value[2]);\n  }\n\n  #setComponent(index, component)\n  {\n    this.value[index] = Number(component);\n    this.SetValue(this.value);\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, 3);\n  }\n\n}\n"],"names":["_Tr2Vector3Parameter","Tr2Vector3Parameter","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","vec3","read","boolean","notify","persist","string","carbon","method","impl","implemented","adapted","value","fromValues","usedByCurrentTechnique","usedByCurrentEffect","name","isSrgb","linearValue","x","GetValue","component","y","z","v1","v2","v3","GetParameterName","GetHashValue","startingHash","FNV1_INITIAL","hashFnv1String","hashFnv1Floats","out","readVectorDestination","copyNumberArray","SetValue","writeVectorDestination","IsRerouted","SetDestination","dest","size","isVectorDestination","notifyBindings","GetDestination","RegisterBinding","binding","registerBinding","UnregisterBinding","unregisterBinding","RebuildEffectHandles","effectRes","constant","getEffectConstant","used","getConstantIsSrgb","Initialize","CopyValueToEffect","_inputType","#updateLinearValue","num","gammaToLinear","#setComponent","index","Number","isValue","isNumberArrayValue"],"mappings":"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"}
+{"version":3,"file":"Tr2Vector3Parameter.js","sources":["../../../../src/shader/parameter/Tr2Vector3Parameter.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\Shader\\Parameter\\Tr2Vector3Parameter.h\n// Source: E:\\carbonengine\\trinity\\trinity\\Shader\\Parameter\\Tr2Vector3Parameter.cpp\nimport { num } from \"@carbonenginejs/runtime-utils/num\";\nimport { vec3 } from \"@carbonenginejs/runtime-utils/vec3\";\nimport { carbon, impl, io, type } from \"@carbonenginejs/runtime-utils/schema\";\nimport { CjsVectorParameter } from \"./CjsVectorParameter.js\";\n\n\n/**\n * Three-component float value for a named shader constant, with sRGB gamma\n * handling and optional rerouting into an external destination.\n */\n@type.define({\n  className: \"Tr2Vector3Parameter\",\n  family: \"shader\"\n})\nexport class Tr2Vector3Parameter extends CjsVectorParameter\n{\n\n  @io.persistOnly\n  @type.vec3\n  value = vec3.fromValues(1, 1, 1);\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  /** m_isSrgb - shader-annotation driven; not Blue-exposed on vec3 in Carbon. */\n  isSrgb = false;\n\n  /** m_linearValue - gamma-to-linear mirror uploaded when isSrgb. */\n  linearValue = vec3.fromValues(1, 1, 1);\n\n  #bindings = [];\n\n  #reroutedValue = null;\n\n  /** Blue MAP_PROPERTY \"x\"/\"v1\" - refreshes from the rerouted value on read. */\n  get x()\n  {\n    this.GetValue();\n    return this.value[0];\n  }\n\n  /**\n   * Writes component 0 and marks the parameter dirty, so the next apply carries\n   * the new value.\n   */\n  set x(component)\n  {\n    this.#setComponent(0, component);\n  }\n\n  /** Blue MAP_PROPERTY \"y\"/\"v2\". */\n  get y()\n  {\n    this.GetValue();\n    return this.value[1];\n  }\n\n  /**\n   * Writes component 1 and marks the parameter dirty, so the next apply carries\n   * the new value.\n   */\n  set y(component)\n  {\n    this.#setComponent(1, component);\n  }\n\n  /** Blue MAP_PROPERTY \"z\"/\"v3\". */\n  get z()\n  {\n    this.GetValue();\n    return this.value[2];\n  }\n\n  /**\n   * Writes component 2 and marks the parameter dirty, so the next apply carries\n   * the new value.\n   */\n  set z(component)\n  {\n    this.#setComponent(2, component);\n  }\n\n  /** Blue MAP_PROPERTY alias reading `x`. */\n  get v1()\n  {\n    return this.x;\n  }\n\n  /** Blue MAP_PROPERTY alias writing `x`. */\n  set v1(component)\n  {\n    this.x = component;\n  }\n\n  /** Blue MAP_PROPERTY alias reading `y`. */\n  get v2()\n  {\n    return this.y;\n  }\n\n  /** Blue MAP_PROPERTY alias writing `y`. */\n  set v2(component)\n  {\n    this.y = component;\n  }\n\n  /** Blue MAP_PROPERTY alias reading `z`. */\n  get v3()\n  {\n    return this.z;\n  }\n\n  /** Blue MAP_PROPERTY alias writing `z`. */\n  set v3(component)\n  {\n    this.z = component;\n  }\n\n  /** The shader constant name this value binds to; empty until authored. */\n  @carbon.method\n  @impl.implemented\n  GetParameterName()\n  {\n    return this.name;\n  }\n\n  /** Content hash: authored value 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 three components out.\n   * @param out defaults to the parameter's own value array, so a caller passing nothing gets a live reference rather than a copy\n   */\n  @carbon.method\n  @impl.implemented\n  GetValue(out = this.value)\n  {\n    if (this.#reroutedValue)\n    {\n      CjsVectorParameter.readVectorDestination(this.#reroutedValue, this.value, 3);\n    }\n    return CjsVectorParameter.copyNumberArray(out, this.value, 3);\n  }\n\n  /**\n   * Copies three components in, refreshes the linear mirror and writes through\n   * to the reroute destination when one is set.\n   */\n  @carbon.method\n  @impl.implemented\n  SetValue(value)\n  {\n    CjsVectorParameter.copyNumberArray(this.value, value, 3);\n    this.#updateLinearValue();\n    if (this.#reroutedValue)\n    {\n      CjsVectorParameter.writeVectorDestination(this.#reroutedValue, this.value, 3);\n    }\n  }\n\n  /**\n   * Whether reads and writes go through an external destination; an sRGB\n   * constant is never rerouted, because its value must be gamma-converted before\n   * upload.\n   */\n  @carbon.method\n  @impl.implemented\n  IsRerouted()\n  {\n    return !this.isSrgb && this.#reroutedValue !== null;\n  }\n\n  /**\n   * Points the parameter at an external destination and seeds it with the current value; a target smaller than 12 bytes, not writable as three components, or belonging to an sRGB constant clears the reroute instead. Registered 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 = 12)\n  {\n    if (size >= 12 && !this.isSrgb && CjsVectorParameter.isVectorDestination(dest, 3))\n    {\n      this.#reroutedValue = dest;\n      CjsVectorParameter.writeVectorDestination(dest, this.value, 3);\n    }\n    else\n    {\n      this.#reroutedValue = null;\n      this.#updateLinearValue();\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 value - paired with its 12-byte size. The array is borrowed,\n   * not copied.\n   */\n  @carbon.method\n  @impl.adapted\n  GetDestination()\n  {\n    return {\n      dest: this.#reroutedValue ?? this.value,\n      size: 12\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   * Re-resolves usage and the sRGB flag from the shader's reflected constant,\n   * dropping the reroute when the shader is gone or the constant turns out to be\n   * sRGB. Reads reflection metadata only; no GPU handle is bound.\n   */\n  @carbon.method\n  @impl.adapted\n  RebuildEffectHandles(effectRes)\n  {\n    this.isSrgb = false;\n    if (!effectRes && this.#reroutedValue)\n    {\n      this.SetDestination(null, 0);\n    }\n    const constant = this.name ? CjsVectorParameter.getEffectConstant(effectRes, this.name) : null;\n    const used = !!constant;\n    this.usedByCurrentEffect = used;\n    this.usedByCurrentTechnique = used;\n    this.isSrgb = CjsVectorParameter.getConstantIsSrgb(constant);\n    if (this.isSrgb)\n    {\n      this.SetDestination(null, 0);\n    }\n    this.#updateLinearValue();\n  }\n\n  /**\n   * Seeds an existing reroute destination with the current value and refreshes\n   * the linear mirror; always returns true.\n   */\n  @carbon.method\n  @impl.implemented\n  Initialize()\n  {\n    if (this.#reroutedValue)\n    {\n      CjsVectorParameter.writeVectorDestination(this.#reroutedValue, this.value, 3);\n    }\n    this.#updateLinearValue();\n    return true;\n  }\n\n  /**\n   * Writes the three components an upload should use into the caller's\n   * destination: the authored value while rerouted, otherwise the\n   * gamma-converted linear mirror for an sRGB constant.\n   */\n  @carbon.method\n  @impl.adapted\n  CopyValueToEffect(_inputType, out)\n  {\n    if (this.#reroutedValue)\n    {\n      CjsVectorParameter.writeVectorDestination(out, this.value, 3);\n      return;\n    }\n    CjsVectorParameter.writeVectorDestination(out, this.isSrgb ? this.linearValue : this.value, 3);\n  }\n\n  /**\n   * Refreshes the linear mirror: a plain copy when not sRGB, otherwise\n   * gamma-to-linear on all three components.\n   */\n  #updateLinearValue()\n  {\n    if (!this.isSrgb)\n    {\n      CjsVectorParameter.copyNumberArray(this.linearValue, this.value, 3);\n      return;\n    }\n    this.linearValue[0] = num.gammaToLinear(this.value[0]);\n    this.linearValue[1] = num.gammaToLinear(this.value[1]);\n    this.linearValue[2] = num.gammaToLinear(this.value[2]);\n  }\n\n  /**\n   * Assigns one component in place and re-runs SetValue so the linear mirror and\n   * any reroute stay in sync.\n   */\n  #setComponent(index, component)\n  {\n    this.value[index] = Number(component);\n    this.SetValue(this.value);\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, 3);\n  }\n\n}\n"],"names":["_Tr2Vector3Parameter","Tr2Vector3Parameter","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","vec3","read","boolean","notify","persist","string","carbon","method","impl","implemented","adapted","value","fromValues","usedByCurrentTechnique","usedByCurrentEffect","name","isSrgb","linearValue","x","GetValue","component","y","z","v1","v2","v3","GetParameterName","GetHashValue","startingHash","FNV1_INITIAL","hashFnv1String","hashFnv1Floats","out","readVectorDestination","copyNumberArray","SetValue","writeVectorDestination","IsRerouted","SetDestination","dest","size","isVectorDestination","notifyBindings","GetDestination","RegisterBinding","binding","registerBinding","UnregisterBinding","unregisterBinding","RebuildEffectHandles","effectRes","constant","getEffectConstant","used","getConstantIsSrgb","Initialize","CopyValueToEffect","_inputType","#updateLinearValue","num","gammaToLinear","#setComponent","index","Number","isValue","isNumberArrayValue"],"mappings":"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"}