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

package/dist/trinity/core/variable/TriVariable.js

@@ -7,9 +7,9 @@ import { TriVariableContentType } from '../../generated/trinityCore/enums.js';
 
 let _initProto, _initClass, _init_name, _init_extra_name, _init_contentType, _init_extra_contentType;
 
-/**
- * One named shader-binding variable: the content type fixed when it was
- * registered, plus the value payload standing in for Carbon's typed union.
+/**
+ * One named shader-binding variable: the content type fixed when it was
+ * registered, plus the value payload standing in for Carbon's typed union.
  */
 let _TriVariable;
 new class extends _identity {
@@ -41,19 +41,19 @@ new class extends _identity {
       return this.contentType;
     }
 
-    /**
-     * Assigns the value payload. The content type stays as registered; Carbon
-     * fixes it at registration time and SetValue only stores.
+    /**
+     * Assigns the value payload. The content type stays as registered; Carbon
+     * fixes it at registration time and SetValue only stores.
      */
     SetValue(value) {
       this.value = value;
       return true;
     }
 
-    /**
-     * Reads the payload; when out is array-like and so is the payload, the
-     * overlapping components are copied into out and out is returned, otherwise
-     * the stored payload itself is returned and is not a copy.
+    /**
+     * Reads the payload; when out is array-like and so is the payload, the
+     * overlapping components are copied into out and out is returned, otherwise
+     * the stored payload itself is returned and is not a copy.
      */
     GetValue(out = undefined) {
       const value = this.value;
@@ -67,19 +67,19 @@ new class extends _identity {
       return value;
     }
 
-    /**
-     * Clears the payload and returns the variable to the reserved INVALID
-     * type, releasing texture/buffer references as Carbon's Clear does.
+    /**
+     * Clears the payload and returns the variable to the reserved INVALID
+     * type, releasing texture/buffer references as Carbon's Clear does.
      */
     Invalidate() {
       this.value = null;
       this.contentType = TriVariableContentType.TRIVARIABLE_INVALID;
     }
 
-    /**
-     * Clears the value but leaves the type alone, so a new SetValue will
-     * still work. Carbon zeroes the union slot and drops texture/buffer
-     * references; the JS payload slot zero-fills arrays and nulls references.
+    /**
+     * Clears the value but leaves the type alone, so a new SetValue will
+     * still work. Carbon zeroes the union slot and drops texture/buffer
+     * references; the JS payload slot zero-fills arrays and nulls references.
      */
     Clear() {
       const value = this.value;
@@ -92,23 +92,23 @@ new class extends _identity {
       }
     }
 
-    /**
-     * Binds this variable's resource into a resource-set description.
-     *
-     * Carbon `TriVariable::CopyToResourceSet` (`TriVariable.cpp:25-67`), which
-     * switches on the content type and answers false for everything that is not
-     * a resource — a float or a matrix is a CONSTANT and reaches a shader
-     * through `CopyValueToEffect`, not through a resource set.
-     *
-     * A PROVIDER THAT HAS NOT RESOLVED STILL BINDS, as an empty slot rather than
-     * a skipped one. That is Carbon's, and it matters: leaving the register
-     * untouched would let a draw read whatever the previous one bound there.
-     *
-     * @param {object} resourceDesc A `Tr2ResourceSetDescriptionAL`.
-     * @param {number} stage A `ShaderType`.
-     * @param {number} registerIndex The register.
-     * @param {number} [flags] A `ResourceFlags` word; bit 0 is sRGB.
-     * @returns {boolean} Whether the slot took the binding.
+    /**
+     * Binds this variable's resource into a resource-set description.
+     *
+     * Carbon `TriVariable::CopyToResourceSet` (`TriVariable.cpp:25-67`), which
+     * switches on the content type and answers false for everything that is not
+     * a resource — a float or a matrix is a CONSTANT and reaches a shader
+     * through `CopyValueToEffect`, not through a resource set.
+     *
+     * A PROVIDER THAT HAS NOT RESOLVED STILL BINDS, as an empty slot rather than
+     * a skipped one. That is Carbon's, and it matters: leaving the register
+     * untouched would let a draw read whatever the previous one bound there.
+     *
+     * @param {object} resourceDesc A `Tr2ResourceSetDescriptionAL`.
+     * @param {number} stage A `ShaderType`.
+     * @param {number} registerIndex The register.
+     * @param {number} [flags] A `ResourceFlags` word; bit 0 is sRGB.
+     * @returns {boolean} Whether the slot took the binding.
      */
     CopyToResourceSet(resourceDesc, stage, registerIndex, flags = 0) {
       if (this.contentType === TriVariableContentType.TRIVARIABLE_TEXTURE_RES) {
@@ -116,28 +116,28 @@ new class extends _identity {
         return resourceDesc.SetSrv(stage, registerIndex, this.#Texture(), colorSpace);
       }
       if (this.contentType === TriVariableContentType.TRIVARIABLE_GPUBUFFER) {
-        return resourceDesc.SetSrv(stage, registerIndex, this.#GpuBuffer());
+        return resourceDesc.SetSrv(stage, registerIndex, this.#GpuBuffer(), 0, 1);
       }
       return false;
     }
 
-    /**
-     * Binds this variable's resource as an unordered-access view.
-     *
-     * Carbon `TriVariable::ApplyUav` (`TriVariable.cpp:69+`). Same switch, no
-     * colour space — a UAV is written rather than sampled.
-     *
-     * @param {object} resourceDesc A `Tr2ResourceSetDescriptionAL`.
-     * @param {number} stage A `ShaderType`.
-     * @param {number} registerIndex The register.
-     * @returns {boolean} Whether the slot took the binding.
+    /**
+     * Binds this variable's resource as an unordered-access view.
+     *
+     * Carbon `TriVariable::ApplyUav` (`TriVariable.cpp:69+`). Same switch, no
+     * colour space — a UAV is written rather than sampled.
+     *
+     * @param {object} resourceDesc A `Tr2ResourceSetDescriptionAL`.
+     * @param {number} stage A `ShaderType`.
+     * @param {number} registerIndex The register.
+     * @returns {boolean} Whether the slot took the binding.
      */
     ApplyUav(resourceDesc, stage, registerIndex) {
       if (this.contentType === TriVariableContentType.TRIVARIABLE_TEXTURE_RES) {
         return resourceDesc.SetUav(stage, registerIndex, this.#Texture());
       }
       if (this.contentType === TriVariableContentType.TRIVARIABLE_GPUBUFFER) {
-        return resourceDesc.SetUav(stage, registerIndex, this.#GpuBuffer());
+        return resourceDesc.SetUav(stage, registerIndex, this.#GpuBuffer(), 0, 1);
       }
       return false;
     }
@@ -154,29 +154,29 @@ new class extends _identity {
       return typeof provider?.GetGpuBuffer === "function" ? provider.GetGpuBuffer(0) : null;
     }
 
-    /**
-     * Carbon's display name for a content type, defaulting to this variable's own
-     * type.
+    /**
+     * Carbon's display name for a content type, defaulting to this variable's own
+     * type.
      */
     GetTypeName(contentType = this.contentType) {
       return _TriVariable.GetTypeName(contentType);
     }
 
-    /**
-     * Constant-buffer byte size of a content type, defaulting to this variable's
-     * own type.
+    /**
+     * Constant-buffer byte size of a content type, defaulting to this variable's
+     * own type.
      */
     GetTypeSize(contentType = this.contentType) {
       return _TriVariable.GetTypeSize(contentType);
     }
 
-    /**
-     * Maps a script value onto a Carbon content type the way the Python
-     * bridge does: integers and booleans register as INT (Python bools are
-     * ints), other numbers as FLOAT, arrays by length, texture-provider
-     * shapes as TEXTURE_RES. Unknown values map to INVALID, which
-     * RegisterVariable treats as unsupported (GPU-buffer duck detection has
-     * no reliable JS shape yet and is left to the realization layer).
+    /**
+     * Maps a script value onto a Carbon content type the way the Python
+     * bridge does: integers and booleans register as INT (Python bools are
+     * ints), other numbers as FLOAT, arrays by length, texture-provider
+     * shapes as TEXTURE_RES. Unknown values map to INVALID, which
+     * RegisterVariable treats as unsupported (GPU-buffer duck detection has
+     * no reliable JS shape yet and is left to the realization layer).
      */
     static getVariableType(value) {
       if (typeof value === "boolean") {
@@ -206,21 +206,21 @@ new class extends _identity {
       return TriVariableContentType.TRIVARIABLE_INVALID;
     }
 
-    /**
-     * Copies the value into an effect constant destination.
-     *
-     * Clamped to the destination length, the source length, and `size` BYTES at
-     * four bytes per float - `size` is a byte budget, not a component count. A
-     * scalar writes one component.
-     *
-     * Lives here because an effect binds a VARIABLE and then copies from it, so
-     * the variable has to be able to answer. It used to live only on a parallel
-     * store's own variable class, which is why binding could not use Carbon's.
-     *
-     * @param {*} _inputType Accepted and ignored, matching the parameter shape.
-     * @param {ArrayLike} destination Constant destination.
-     * @param {number} [size] Byte budget in the destination.
-     * @returns {boolean} Whether anything was written.
+    /**
+     * Copies the value into an effect constant destination.
+     *
+     * Clamped to the destination length, the source length, and `size` BYTES at
+     * four bytes per float - `size` is a byte budget, not a component count. A
+     * scalar writes one component.
+     *
+     * Lives here because an effect binds a VARIABLE and then copies from it, so
+     * the variable has to be able to answer. It used to live only on a parallel
+     * store's own variable class, which is why binding could not use Carbon's.
+     *
+     * @param {*} _inputType Accepted and ignored, matching the parameter shape.
+     * @param {ArrayLike} destination Constant destination.
+     * @param {number} [size] Byte budget in the destination.
+     * @returns {boolean} Whether anything was written.
      */
     CopyValueToEffect(_inputType, destination, size = Number.POSITIVE_INFINITY) {
       if (!destination || typeof destination.length !== "number") return false;
@@ -236,20 +236,20 @@ new class extends _identity {
       return count > 0;
     }
 
-    /**
-     * Carbon's display name for a content type; an unrecognised type falls back to
-     * the INVALID label.
+    /**
+     * Carbon's display name for a content type; an unrecognised type falls back to
+     * the INVALID label.
      */
     static GetTypeName(contentType) {
       return _TriVariable.#typeNames[contentType] ?? _TriVariable.#typeNames[0];
     }
 
-    /**
-     * Byte size a variable of the given content type occupies in a constant
-     * buffer. INVALID and UNKNOWN_FLOAT may be converted to another type, so
-     * they must register as the largest type. Texture and GPU-buffer slots are
-     * pointer-sized in Carbon; the JS reference slot keeps the same 8 bytes so
-     * shared-buffer offset math stays aligned with Carbon's.
+    /**
+     * Byte size a variable of the given content type occupies in a constant
+     * buffer. INVALID and UNKNOWN_FLOAT may be converted to another type, so
+     * they must register as the largest type. Texture and GPU-buffer slots are
+     * pointer-sized in Carbon; the JS reference slot keeps the same 8 bytes so
+     * shared-buffer offset math stays aligned with Carbon's.
      */
     static GetTypeSize(contentType) {
       return _TriVariable.#typeSizes[contentType] ?? 0;

package/dist/trinity/core/variable/TriVariable.js.map

@@ -1 +1 @@
-{"version":3,"file":"TriVariable.js","sources":["../../../../../src/trinity/core/variable/TriVariable.js"],"sourcesContent":["// Source: trinity/trinity/TriVariable.h\n// Source: trinity/trinity/TriVariable.cpp\nimport { carbon, impl, io, type } from \"#schema\";\nimport { CjsModel } from \"#model\";\nimport { Tr2ColorSpace } from \"#consts/render-context\";\nimport { ResourceFlags } from \"../../shader/parameter/ITr2EffectValue.js\";\nimport { TriVariableContentType } from \"../../generated/trinityCore/enums.js\";\n\n\n/**\n * One named shader-binding variable: the content type fixed when it was\n * registered, plus the value payload standing in for Carbon's typed union.\n */\n@type.define({\n  className: \"TriVariable\",\n  family: \"trinityCore\"\n})\nexport class TriVariable extends CjsModel\n{\n  @io.read\n  @type.string\n  name = \"\";\n\n  /** m_type (TriVariableContentType). */\n  @io.read\n  @type.int32\n  contentType = TriVariableContentType.TRIVARIABLE_INVALID;\n\n  /** Runtime value payload; the typed C++ union collapses to one slot. */\n  value = null;\n\n  /** The registered variable name, which the store also uses as its key. */\n  @carbon.method\n  @impl.implemented\n  GetName()\n  {\n    return this.name;\n  }\n\n  /** The TriVariableContentType fixed at registration; SetValue never changes it. */\n  @carbon.method\n  @impl.implemented\n  GetType()\n  {\n    return this.contentType;\n  }\n\n  /**\n   * Assigns the value payload. The content type stays as registered; Carbon\n   * fixes it at registration time and SetValue only stores.\n   */\n  @carbon.method\n  @impl.adapted\n  SetValue(value)\n  {\n    this.value = value;\n    return true;\n  }\n\n  /**\n   * Reads the payload; when out is array-like and so is the payload, the\n   * overlapping components are copied into out and out is returned, otherwise\n   * the stored payload itself is returned and is not a copy.\n   */\n  @carbon.method\n  @impl.adapted\n  GetValue(out = undefined)\n  {\n    const value = this.value;\n    if (out && value && typeof value.length === \"number\" && typeof out.length === \"number\")\n    {\n      const count = Math.min(out.length, value.length);\n      for (let index = 0; index < count; index++)\n      {\n        out[index] = value[index];\n      }\n      return out;\n    }\n    return value;\n  }\n\n  /**\n   * Clears the payload and returns the variable to the reserved INVALID\n   * type, releasing texture/buffer references as Carbon's Clear does.\n   */\n  @carbon.method\n  @impl.implemented\n  Invalidate()\n  {\n    this.value = null;\n    this.contentType = TriVariableContentType.TRIVARIABLE_INVALID;\n  }\n\n  /**\n   * Clears the value but leaves the type alone, so a new SetValue will\n   * still work. Carbon zeroes the union slot and drops texture/buffer\n   * references; the JS payload slot zero-fills arrays and nulls references.\n   */\n  @carbon.method\n  @impl.adapted\n  Clear()\n  {\n    const value = this.value;\n    if (value && typeof value.length === \"number\" && typeof value.fill === \"function\")\n    {\n      value.fill(0);\n    }\n    else if (typeof value === \"number\")\n    {\n      this.value = 0;\n    }\n    else\n    {\n      this.value = null;\n    }\n  }\n\n  /**\n   * Binds this variable's resource into a resource-set description.\n   *\n   * Carbon `TriVariable::CopyToResourceSet` (`TriVariable.cpp:25-67`), which\n   * switches on the content type and answers false for everything that is not\n   * a resource — a float or a matrix is a CONSTANT and reaches a shader\n   * through `CopyValueToEffect`, not through a resource set.\n   *\n   * A PROVIDER THAT HAS NOT RESOLVED STILL BINDS, as an empty slot rather than\n   * a skipped one. That is Carbon's, and it matters: leaving the register\n   * untouched would let a draw read whatever the previous one bound there.\n   *\n   * @param {object} resourceDesc A `Tr2ResourceSetDescriptionAL`.\n   * @param {number} stage A `ShaderType`.\n   * @param {number} registerIndex The register.\n   * @param {number} [flags] A `ResourceFlags` word; bit 0 is sRGB.\n   * @returns {boolean} Whether the slot took the binding.\n   */\n  @carbon.method\n  @impl.implemented\n  CopyToResourceSet(resourceDesc, stage, registerIndex, flags = 0)\n  {\n    if (this.contentType === TriVariableContentType.TRIVARIABLE_TEXTURE_RES)\n    {\n      const colorSpace = (flags & ResourceFlags.RESOURCE_FLAG_SRGB)\n        ? Tr2ColorSpace.COLOR_SPACE_SRGB\n        : Tr2ColorSpace.COLOR_SPACE_LINEAR;\n\n      return resourceDesc.SetSrv(stage, registerIndex, this.#Texture(), colorSpace);\n    }\n\n    if (this.contentType === TriVariableContentType.TRIVARIABLE_GPUBUFFER)\n    {\n      return resourceDesc.SetSrv(stage, registerIndex, this.#GpuBuffer());\n    }\n\n    return false;\n  }\n\n  /**\n   * Binds this variable's resource as an unordered-access view.\n   *\n   * Carbon `TriVariable::ApplyUav` (`TriVariable.cpp:69+`). Same switch, no\n   * colour space — a UAV is written rather than sampled.\n   *\n   * @param {object} resourceDesc A `Tr2ResourceSetDescriptionAL`.\n   * @param {number} stage A `ShaderType`.\n   * @param {number} registerIndex The register.\n   * @returns {boolean} Whether the slot took the binding.\n   */\n  @carbon.method\n  @impl.implemented\n  ApplyUav(resourceDesc, stage, registerIndex)\n  {\n    if (this.contentType === TriVariableContentType.TRIVARIABLE_TEXTURE_RES)\n    {\n      return resourceDesc.SetUav(stage, registerIndex, this.#Texture());\n    }\n\n    if (this.contentType === TriVariableContentType.TRIVARIABLE_GPUBUFFER)\n    {\n      return resourceDesc.SetUav(stage, registerIndex, this.#GpuBuffer());\n    }\n\n    return false;\n  }\n\n  /** The provider's texture, or null when it has not resolved one. */\n  #Texture()\n  {\n    const provider = this.value;\n\n    return typeof provider?.GetTexture === \"function\" ? provider.GetTexture() : null;\n  }\n\n  /** The provider's first buffer, which is the index Carbon passes. */\n  #GpuBuffer()\n  {\n    const provider = this.value;\n\n    return typeof provider?.GetGpuBuffer === \"function\" ? provider.GetGpuBuffer(0) : null;\n  }\n\n  /**\n   * Carbon's display name for a content type, defaulting to this variable's own\n   * type.\n   */\n  @carbon.method\n  @impl.implemented\n  GetTypeName(contentType = this.contentType)\n  {\n    return TriVariable.GetTypeName(contentType);\n  }\n\n  /**\n   * Constant-buffer byte size of a content type, defaulting to this variable's\n   * own type.\n   */\n  @carbon.method\n  @impl.implemented\n  GetTypeSize(contentType = this.contentType)\n  {\n    return TriVariable.GetTypeSize(contentType);\n  }\n\n  /**\n   * Maps a script value onto a Carbon content type the way the Python\n   * bridge does: integers and booleans register as INT (Python bools are\n   * ints), other numbers as FLOAT, arrays by length, texture-provider\n   * shapes as TEXTURE_RES. Unknown values map to INVALID, which\n   * RegisterVariable treats as unsupported (GPU-buffer duck detection has\n   * no reliable JS shape yet and is left to the realization layer).\n   */\n  static getVariableType(value)\n  {\n    if (typeof value === \"boolean\")\n    {\n      return TriVariableContentType.TRIVARIABLE_INT;\n    }\n    if (typeof value === \"number\")\n    {\n      return Number.isInteger(value)\n        ? TriVariableContentType.TRIVARIABLE_INT\n        : TriVariableContentType.TRIVARIABLE_FLOAT;\n    }\n    if (value && typeof value.length === \"number\")\n    {\n      switch (value.length)\n      {\n        case 2: return TriVariableContentType.TRIVARIABLE_FLOAT2;\n        case 3: return TriVariableContentType.TRIVARIABLE_FLOAT3;\n        case 4: return TriVariableContentType.TRIVARIABLE_FLOAT4;\n        case 16: return TriVariableContentType.TRIVARIABLE_FLOAT4X4;\n      }\n      return TriVariableContentType.TRIVARIABLE_INVALID;\n    }\n    if (value && typeof value === \"object\")\n    {\n      if (typeof value.GetTexture === \"function\" || typeof value.RequestResolution === \"function\")\n      {\n        return TriVariableContentType.TRIVARIABLE_TEXTURE_RES;\n      }\n    }\n    return TriVariableContentType.TRIVARIABLE_INVALID;\n  }\n\n  /**\n   * Copies the value into an effect constant destination.\n   *\n   * Clamped to the destination length, the source length, and `size` BYTES at\n   * four bytes per float - `size` is a byte budget, not a component count. A\n   * scalar writes one component.\n   *\n   * Lives here because an effect binds a VARIABLE and then copies from it, so\n   * the variable has to be able to answer. It used to live only on a parallel\n   * store's own variable class, which is why binding could not use Carbon's.\n   *\n   * @param {*} _inputType Accepted and ignored, matching the parameter shape.\n   * @param {ArrayLike} destination Constant destination.\n   * @param {number} [size] Byte budget in the destination.\n   * @returns {boolean} Whether anything was written.\n   */\n  CopyValueToEffect(_inputType, destination, size = Number.POSITIVE_INFINITY)\n  {\n    if (!destination || typeof destination.length !== \"number\") return false;\n\n    const source = this.GetValue();\n\n    if (typeof source === \"number\")\n    {\n      destination[0] = source;\n      return true;\n    }\n\n    if (!source || typeof source.length !== \"number\") return false;\n\n    const byteLimit = Number.isFinite(size) ? Math.max(0, size) : Infinity;\n    const count = Math.min(destination.length, source.length, Math.floor(byteLimit / 4));\n\n    for (let i = 0; i < count; i++) destination[i] = source[i];\n\n    return count > 0;\n  }\n\n  /**\n   * Carbon's display name for a content type; an unrecognised type falls back to\n   * the INVALID label.\n   */\n  static GetTypeName(contentType)\n  {\n    return TriVariable.#typeNames[contentType] ?? TriVariable.#typeNames[0];\n  }\n\n  /**\n   * Byte size a variable of the given content type occupies in a constant\n   * buffer. INVALID and UNKNOWN_FLOAT may be converted to another type, so\n   * they must register as the largest type. Texture and GPU-buffer slots are\n   * pointer-sized in Carbon; the JS reference slot keeps the same 8 bytes so\n   * shared-buffer offset math stays aligned with Carbon's.\n   */\n  static GetTypeSize(contentType)\n  {\n    return TriVariable.#typeSizes[contentType] ?? 0;\n  }\n\n  static #typeNames = Object.freeze([\n    \"INVALID TYPE!\",\n    \"TRIVARIABLE_UNKNOWN_FLOAT\",\n    \"TRIVARIABLE_TEXTURE_RES\",\n    \"TRIVARIABLE_INT\",\n    \"TRIVARIABLE_FLOAT\",\n    \"TRIVARIABLE_FLOAT2\",\n    \"TRIVARIABLE_FLOAT3\",\n    \"TRIVARIABLE_FLOAT4\",\n    \"TRIVARIABLE_FLOAT4X4\",\n    \"TRIVARIABLE_COLOR\",\n    \"TRIVARIABLE_GPUBUFFER\"\n  ]);\n\n  static #typeSizes = Object.freeze([\n    4 * 16,\n    4 * 16,\n    8,\n    4,\n    4,\n    4 * 2,\n    4 * 3,\n    4 * 4,\n    4 * 16,\n    4 * 4,\n    8\n  ]);\n\n  static ContentType = TriVariableContentType;\n}\n"],"names":["_TriVariable","_identity","TriVariable","CjsModel","e","_init_name","_init_extra_name","_init_contentType","_init_extra_contentType","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","read","string","int32","carbon","method","impl","implemented","adapted","name","contentType","TriVariableContentType","TRIVARIABLE_INVALID","value","GetName","GetType","SetValue","GetValue","out","undefined","length","count","Math","min","index","Invalidate","Clear","fill","CopyToResourceSet","resourceDesc","stage","registerIndex","flags","TRIVARIABLE_TEXTURE_RES","colorSpace","ResourceFlags","RESOURCE_FLAG_SRGB","Tr2ColorSpace","COLOR_SPACE_SRGB","COLOR_SPACE_LINEAR","SetSrv","TRIVARIABLE_GPUBUFFER","ApplyUav","SetUav","#Texture","provider","GetTexture","#GpuBuffer","GetGpuBuffer","GetTypeName","GetTypeSize","getVariableType","TRIVARIABLE_INT","Number","isInteger","TRIVARIABLE_FLOAT","TRIVARIABLE_FLOAT2","TRIVARIABLE_FLOAT3","TRIVARIABLE_FLOAT4","TRIVARIABLE_FLOAT4X4","RequestResolution","CopyValueToEffect","_inputType","destination","size","POSITIVE_INFINITY","source","byteLimit","isFinite","max","Infinity","floor","i","Object","freeze","ContentType","constructor"],"mappings":"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"}
+{"version":3,"file":"TriVariable.js","sources":["../../../../../src/trinity/core/variable/TriVariable.js"],"sourcesContent":["// Source: trinity/trinity/TriVariable.h\r\n// Source: trinity/trinity/TriVariable.cpp\r\nimport { carbon, impl, io, type } from \"#schema\";\r\nimport { CjsModel } from \"#model\";\r\nimport { Tr2ColorSpace } from \"#consts/render-context\";\r\nimport { ResourceFlags } from \"../../shader/parameter/ITr2EffectValue.js\";\r\nimport { TriVariableContentType } from \"../../generated/trinityCore/enums.js\";\r\n\r\n\r\n/**\r\n * One named shader-binding variable: the content type fixed when it was\r\n * registered, plus the value payload standing in for Carbon's typed union.\r\n */\r\n@type.define({\r\n  className: \"TriVariable\",\r\n  family: \"trinityCore\"\r\n})\r\nexport class TriVariable extends CjsModel\r\n{\r\n  @io.read\r\n  @type.string\r\n  name = \"\";\r\n\r\n  /** m_type (TriVariableContentType). */\r\n  @io.read\r\n  @type.int32\r\n  contentType = TriVariableContentType.TRIVARIABLE_INVALID;\r\n\r\n  /** Runtime value payload; the typed C++ union collapses to one slot. */\r\n  value = null;\r\n\r\n  /** The registered variable name, which the store also uses as its key. */\r\n  @carbon.method\r\n  @impl.implemented\r\n  GetName()\r\n  {\r\n    return this.name;\r\n  }\r\n\r\n  /** The TriVariableContentType fixed at registration; SetValue never changes it. */\r\n  @carbon.method\r\n  @impl.implemented\r\n  GetType()\r\n  {\r\n    return this.contentType;\r\n  }\r\n\r\n  /**\r\n   * Assigns the value payload. The content type stays as registered; Carbon\r\n   * fixes it at registration time and SetValue only stores.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  SetValue(value)\r\n  {\r\n    this.value = value;\r\n    return true;\r\n  }\r\n\r\n  /**\r\n   * Reads the payload; when out is array-like and so is the payload, the\r\n   * overlapping components are copied into out and out is returned, otherwise\r\n   * the stored payload itself is returned and is not a copy.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  GetValue(out = undefined)\r\n  {\r\n    const value = this.value;\r\n    if (out && value && typeof value.length === \"number\" && typeof out.length === \"number\")\r\n    {\r\n      const count = Math.min(out.length, value.length);\r\n      for (let index = 0; index < count; index++)\r\n      {\r\n        out[index] = value[index];\r\n      }\r\n      return out;\r\n    }\r\n    return value;\r\n  }\r\n\r\n  /**\r\n   * Clears the payload and returns the variable to the reserved INVALID\r\n   * type, releasing texture/buffer references as Carbon's Clear does.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  Invalidate()\r\n  {\r\n    this.value = null;\r\n    this.contentType = TriVariableContentType.TRIVARIABLE_INVALID;\r\n  }\r\n\r\n  /**\r\n   * Clears the value but leaves the type alone, so a new SetValue will\r\n   * still work. Carbon zeroes the union slot and drops texture/buffer\r\n   * references; the JS payload slot zero-fills arrays and nulls references.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  Clear()\r\n  {\r\n    const value = this.value;\r\n    if (value && typeof value.length === \"number\" && typeof value.fill === \"function\")\r\n    {\r\n      value.fill(0);\r\n    }\r\n    else if (typeof value === \"number\")\r\n    {\r\n      this.value = 0;\r\n    }\r\n    else\r\n    {\r\n      this.value = null;\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Binds this variable's resource into a resource-set description.\r\n   *\r\n   * Carbon `TriVariable::CopyToResourceSet` (`TriVariable.cpp:25-67`), which\r\n   * switches on the content type and answers false for everything that is not\r\n   * a resource — a float or a matrix is a CONSTANT and reaches a shader\r\n   * through `CopyValueToEffect`, not through a resource set.\r\n   *\r\n   * A PROVIDER THAT HAS NOT RESOLVED STILL BINDS, as an empty slot rather than\r\n   * a skipped one. That is Carbon's, and it matters: leaving the register\r\n   * untouched would let a draw read whatever the previous one bound there.\r\n   *\r\n   * @param {object} resourceDesc A `Tr2ResourceSetDescriptionAL`.\r\n   * @param {number} stage A `ShaderType`.\r\n   * @param {number} registerIndex The register.\r\n   * @param {number} [flags] A `ResourceFlags` word; bit 0 is sRGB.\r\n   * @returns {boolean} Whether the slot took the binding.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  CopyToResourceSet(resourceDesc, stage, registerIndex, flags = 0)\r\n  {\r\n    if (this.contentType === TriVariableContentType.TRIVARIABLE_TEXTURE_RES)\r\n    {\r\n      const colorSpace = (flags & ResourceFlags.RESOURCE_FLAG_SRGB)\r\n        ? Tr2ColorSpace.COLOR_SPACE_SRGB\r\n        : Tr2ColorSpace.COLOR_SPACE_LINEAR;\r\n\r\n      return resourceDesc.SetSrv(stage, registerIndex, this.#Texture(), colorSpace);\r\n    }\r\n\r\n    if (this.contentType === TriVariableContentType.TRIVARIABLE_GPUBUFFER)\r\n    {\r\n      return resourceDesc.SetSrv(stage, registerIndex, this.#GpuBuffer(), 0, 1);\r\n    }\r\n\r\n    return false;\r\n  }\r\n\r\n  /**\r\n   * Binds this variable's resource as an unordered-access view.\r\n   *\r\n   * Carbon `TriVariable::ApplyUav` (`TriVariable.cpp:69+`). Same switch, no\r\n   * colour space — a UAV is written rather than sampled.\r\n   *\r\n   * @param {object} resourceDesc A `Tr2ResourceSetDescriptionAL`.\r\n   * @param {number} stage A `ShaderType`.\r\n   * @param {number} registerIndex The register.\r\n   * @returns {boolean} Whether the slot took the binding.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  ApplyUav(resourceDesc, stage, registerIndex)\r\n  {\r\n    if (this.contentType === TriVariableContentType.TRIVARIABLE_TEXTURE_RES)\r\n    {\r\n      return resourceDesc.SetUav(stage, registerIndex, this.#Texture());\r\n    }\r\n\r\n    if (this.contentType === TriVariableContentType.TRIVARIABLE_GPUBUFFER)\r\n    {\r\n      return resourceDesc.SetUav(stage, registerIndex, this.#GpuBuffer(), 0, 1);\r\n    }\r\n\r\n    return false;\r\n  }\r\n\r\n  /** The provider's texture, or null when it has not resolved one. */\r\n  #Texture()\r\n  {\r\n    const provider = this.value;\r\n\r\n    return typeof provider?.GetTexture === \"function\" ? provider.GetTexture() : null;\r\n  }\r\n\r\n  /** The provider's first buffer, which is the index Carbon passes. */\r\n  #GpuBuffer()\r\n  {\r\n    const provider = this.value;\r\n\r\n    return typeof provider?.GetGpuBuffer === \"function\" ? provider.GetGpuBuffer(0) : null;\r\n  }\r\n\r\n  /**\r\n   * Carbon's display name for a content type, defaulting to this variable's own\r\n   * type.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  GetTypeName(contentType = this.contentType)\r\n  {\r\n    return TriVariable.GetTypeName(contentType);\r\n  }\r\n\r\n  /**\r\n   * Constant-buffer byte size of a content type, defaulting to this variable's\r\n   * own type.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  GetTypeSize(contentType = this.contentType)\r\n  {\r\n    return TriVariable.GetTypeSize(contentType);\r\n  }\r\n\r\n  /**\r\n   * Maps a script value onto a Carbon content type the way the Python\r\n   * bridge does: integers and booleans register as INT (Python bools are\r\n   * ints), other numbers as FLOAT, arrays by length, texture-provider\r\n   * shapes as TEXTURE_RES. Unknown values map to INVALID, which\r\n   * RegisterVariable treats as unsupported (GPU-buffer duck detection has\r\n   * no reliable JS shape yet and is left to the realization layer).\r\n   */\r\n  static getVariableType(value)\r\n  {\r\n    if (typeof value === \"boolean\")\r\n    {\r\n      return TriVariableContentType.TRIVARIABLE_INT;\r\n    }\r\n    if (typeof value === \"number\")\r\n    {\r\n      return Number.isInteger(value)\r\n        ? TriVariableContentType.TRIVARIABLE_INT\r\n        : TriVariableContentType.TRIVARIABLE_FLOAT;\r\n    }\r\n    if (value && typeof value.length === \"number\")\r\n    {\r\n      switch (value.length)\r\n      {\r\n        case 2: return TriVariableContentType.TRIVARIABLE_FLOAT2;\r\n        case 3: return TriVariableContentType.TRIVARIABLE_FLOAT3;\r\n        case 4: return TriVariableContentType.TRIVARIABLE_FLOAT4;\r\n        case 16: return TriVariableContentType.TRIVARIABLE_FLOAT4X4;\r\n      }\r\n      return TriVariableContentType.TRIVARIABLE_INVALID;\r\n    }\r\n    if (value && typeof value === \"object\")\r\n    {\r\n      if (typeof value.GetTexture === \"function\" || typeof value.RequestResolution === \"function\")\r\n      {\r\n        return TriVariableContentType.TRIVARIABLE_TEXTURE_RES;\r\n      }\r\n    }\r\n    return TriVariableContentType.TRIVARIABLE_INVALID;\r\n  }\r\n\r\n  /**\r\n   * Copies the value into an effect constant destination.\r\n   *\r\n   * Clamped to the destination length, the source length, and `size` BYTES at\r\n   * four bytes per float - `size` is a byte budget, not a component count. A\r\n   * scalar writes one component.\r\n   *\r\n   * Lives here because an effect binds a VARIABLE and then copies from it, so\r\n   * the variable has to be able to answer. It used to live only on a parallel\r\n   * store's own variable class, which is why binding could not use Carbon's.\r\n   *\r\n   * @param {*} _inputType Accepted and ignored, matching the parameter shape.\r\n   * @param {ArrayLike} destination Constant destination.\r\n   * @param {number} [size] Byte budget in the destination.\r\n   * @returns {boolean} Whether anything was written.\r\n   */\r\n  CopyValueToEffect(_inputType, destination, size = Number.POSITIVE_INFINITY)\r\n  {\r\n    if (!destination || typeof destination.length !== \"number\") return false;\r\n\r\n    const source = this.GetValue();\r\n\r\n    if (typeof source === \"number\")\r\n    {\r\n      destination[0] = source;\r\n      return true;\r\n    }\r\n\r\n    if (!source || typeof source.length !== \"number\") return false;\r\n\r\n    const byteLimit = Number.isFinite(size) ? Math.max(0, size) : Infinity;\r\n    const count = Math.min(destination.length, source.length, Math.floor(byteLimit / 4));\r\n\r\n    for (let i = 0; i < count; i++) destination[i] = source[i];\r\n\r\n    return count > 0;\r\n  }\r\n\r\n  /**\r\n   * Carbon's display name for a content type; an unrecognised type falls back to\r\n   * the INVALID label.\r\n   */\r\n  static GetTypeName(contentType)\r\n  {\r\n    return TriVariable.#typeNames[contentType] ?? TriVariable.#typeNames[0];\r\n  }\r\n\r\n  /**\r\n   * Byte size a variable of the given content type occupies in a constant\r\n   * buffer. INVALID and UNKNOWN_FLOAT may be converted to another type, so\r\n   * they must register as the largest type. Texture and GPU-buffer slots are\r\n   * pointer-sized in Carbon; the JS reference slot keeps the same 8 bytes so\r\n   * shared-buffer offset math stays aligned with Carbon's.\r\n   */\r\n  static GetTypeSize(contentType)\r\n  {\r\n    return TriVariable.#typeSizes[contentType] ?? 0;\r\n  }\r\n\r\n  static #typeNames = Object.freeze([\r\n    \"INVALID TYPE!\",\r\n    \"TRIVARIABLE_UNKNOWN_FLOAT\",\r\n    \"TRIVARIABLE_TEXTURE_RES\",\r\n    \"TRIVARIABLE_INT\",\r\n    \"TRIVARIABLE_FLOAT\",\r\n    \"TRIVARIABLE_FLOAT2\",\r\n    \"TRIVARIABLE_FLOAT3\",\r\n    \"TRIVARIABLE_FLOAT4\",\r\n    \"TRIVARIABLE_FLOAT4X4\",\r\n    \"TRIVARIABLE_COLOR\",\r\n    \"TRIVARIABLE_GPUBUFFER\"\r\n  ]);\r\n\r\n  static #typeSizes = Object.freeze([\r\n    4 * 16,\r\n    4 * 16,\r\n    8,\r\n    4,\r\n    4,\r\n    4 * 2,\r\n    4 * 3,\r\n    4 * 4,\r\n    4 * 16,\r\n    4 * 4,\r\n    8\r\n  ]);\r\n\r\n  static ContentType = TriVariableContentType;\r\n}\r\n"],"names":["_TriVariable","_identity","TriVariable","CjsModel","e","_init_name","_init_extra_name","_init_contentType","_init_extra_contentType","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","read","string","int32","carbon","method","impl","implemented","adapted","name","contentType","TriVariableContentType","TRIVARIABLE_INVALID","value","GetName","GetType","SetValue","GetValue","out","undefined","length","count","Math","min","index","Invalidate","Clear","fill","CopyToResourceSet","resourceDesc","stage","registerIndex","flags","TRIVARIABLE_TEXTURE_RES","colorSpace","ResourceFlags","RESOURCE_FLAG_SRGB","Tr2ColorSpace","COLOR_SPACE_SRGB","COLOR_SPACE_LINEAR","SetSrv","TRIVARIABLE_GPUBUFFER","ApplyUav","SetUav","#Texture","provider","GetTexture","#GpuBuffer","GetGpuBuffer","GetTypeName","GetTypeSize","getVariableType","TRIVARIABLE_INT","Number","isInteger","TRIVARIABLE_FLOAT","TRIVARIABLE_FLOAT2","TRIVARIABLE_FLOAT3","TRIVARIABLE_FLOAT4","TRIVARIABLE_FLOAT4X4","RequestResolution","CopyValueToEffect","_inputType","destination","size","POSITIVE_INFINITY","source","byteLimit","isFinite","max","Infinity","floor","i","Object","freeze","ContentType","constructor"],"mappings":"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"}

package/dist/trinity/core/vertex/{Tr2VertexDefinition.js → Tr2VertexDefinition/Tr2VertexDefinition.js}

@@ -1,4 +1,5 @@
-import { Tr2VertexUsageCode } from './usageCode.js';
+import { Tr2VertexDefinitionItem } from './Tr2VertexDefinitionItem.js';
+import { Tr2VertexUsageCode } from '../usageCode.js';
 
 // Source: trinity/trinityal/Tr2VertexDefinition.h:14-207 (the definition and its items)
 //   trinity/trinityal/Tr2VertexDefinition.cpp:25-42 (item and definition equality)
@@ -10,22 +11,7 @@ import { Tr2VertexUsageCode } from './usageCode.js';
 // parked under this class's name until 2026-09-06, before it had its real
 // Carbon surface.
 
-/**
- * One vertex element (Carbon Tr2VertexDefinition::Item, h:123-141).
- *
- * Carbon's usage and data type are bit-coded enums; the runtime's element
- * vocabulary is the string names throughout (payload readers, the quad
- * renderer, the AL's binding-plan matcher), so the item carries the names
- * and the byte arithmetic derives from them.
- */
-class Tr2VertexDefinitionItem {
-  usage = "POSITION";
-  usageIndex = 0;
-  type = "FLOAT32_1";
-  offset = 0;
-  stream = 0;
-  instanceStepRate = 0;
-}
+/** A mesh's vertex element list (Carbon trinityal/Tr2VertexDefinition.h). */
 const USAGE_NAMES = Object.keys(Tr2VertexUsageCode);
 const DATA_TYPE_BASE_BYTES = {
   BYTE: 1,
@@ -39,8 +25,6 @@ const DATA_TYPE_BASE_BYTES = {
   FLOAT32: 4,
   UFLOAT32: 4
 };
-
-/** A mesh's vertex element list (Carbon trinityal/Tr2VertexDefinition.h). */
 class Tr2VertexDefinition {
   /** Carbon m_items. */
   items = [];
@@ -155,5 +139,5 @@ class Tr2VertexDefinition {
   }
 }
 
-export { Tr2VertexDefinition, Tr2VertexDefinitionItem };
+export { Tr2VertexDefinition };
 //# sourceMappingURL=Tr2VertexDefinition.js.map

package/dist/trinity/core/vertex/Tr2VertexDefinition/Tr2VertexDefinition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Tr2VertexDefinition.js","sources":["../../../../../../src/trinity/core/vertex/Tr2VertexDefinition/Tr2VertexDefinition.js"],"sourcesContent":["// Source: trinity/trinityal/Tr2VertexDefinition.h:14-207 (the definition and its items)\n//   trinity/trinityal/Tr2VertexDefinition.cpp:25-42 (item and definition equality)\n//\n// This class is the definition and NOTHING ELSE: items, the per-stream offset\n// ledger, Add/Find/empty, and its own equality. The intern table lives on\n// Tr2EffectStateManager (Carbon s_vertexLayoutMap) and the shader-input match\n// lives in the vertex-layout AL (trinityal/vertexLayoutMatch.js) - both were\n// parked under this class's name until 2026-09-06, before it had its real\n// Carbon surface.\nimport { Tr2VertexDefinitionItem } from \"./Tr2VertexDefinitionItem.js\";\nimport { Tr2VertexUsageCode } from \"../usageCode.js\";\n\n\n/** A mesh's vertex element list (Carbon trinityal/Tr2VertexDefinition.h). */\nconst USAGE_NAMES = Object.keys(Tr2VertexUsageCode);\n\nconst DATA_TYPE_BASE_BYTES = {\n    BYTE: 1, UBYTE: 1,\n    SHORT: 2, USHORT: 2,\n    INT32: 4, UINT32: 4,\n    FLOAT16: 2, UFLOAT16: 2,\n    FLOAT32: 4, UFLOAT32: 4\n};\n\n\nexport class Tr2VertexDefinition\n{\n  /** Carbon m_items. */\n  items = [];\n\n  /** Carbon m_nextOffset[OFFSET_COUNT] (h:153-159): per-stream offset ledger. */\n  nextOffset = [ 0, 0, 0, 0 ];\n\n  /** Carbon empty() (h:145-148). */\n  empty()\n  {\n    return this.items.length === 0;\n  }\n\n  /**\n   * Carbon Add (h:174-181): append an item at the stream's current offset\n   * and advance the ledger by the type's byte size. `stepRate` is \"almost\n   * always a bool that indicates if the added item is coming from instanced\n   * data\" - Carbon's own words.\n   *\n   * @param {string} type Data type name, e.g. \"FLOAT32_3\", \"UBYTE_4_NORM\".\n   * @param {string|number} usage Usage name or Tr2VertexUsageCode ordinal.\n   * @param {number} [usageIndex]\n   * @param {number} [stream]\n   * @param {number} [stepRate]\n   * @returns {Tr2VertexDefinitionItem} The item just added.\n   */\n  Add(type, usage, usageIndex = 0, stream = 0, stepRate = 0)\n  {\n    const item = new Tr2VertexDefinitionItem();\n    item.usage = typeof usage === \"number\" ? USAGE_NAMES[usage] : String(usage);\n    item.usageIndex = usageIndex;\n    item.type = String(type);\n    item.offset = this.nextOffset[stream] ?? 0;\n    item.stream = stream;\n    item.instanceStepRate = stepRate;\n    this.nextOffset[stream] = item.offset + Tr2VertexDefinition.getDataTypeSizeInBytes(item.type);\n    this.items.push(item);\n    return item;\n  }\n\n  /**\n   * Carbon Find (h:169-172): the first item with the usage, and optionally\n   * the usage index; null when absent.\n   */\n  Find(usage, usageIndex = null)\n  {\n    const name = typeof usage === \"number\" ? USAGE_NAMES[usage] : String(usage);\n    for (const item of this.items)\n    {\n      if (item.usage === name && (usageIndex === null || item.usageIndex === usageIndex))\n      {\n        return item;\n      }\n    }\n    return null;\n  }\n\n  /** Carbon GetDataTypeSizeInMembers (h:183-186), from the type NAME. */\n  static getDataTypeSizeInMembers(type)\n  {\n    const match = /_([1-4])(?:_NORM)?$/.exec(String(type));\n    return match ? Number(match[1]) : 0;\n  }\n\n  /** Carbon GetDataTypeSizeInBytes (h:188-205), from the type NAME. */\n  static getDataTypeSizeInBytes(type)\n  {\n    const base = DATA_TYPE_BASE_BYTES[String(type).split(\"_\")[0]];\n    return base ? base * Tr2VertexDefinition.getDataTypeSizeInMembers(type) : 0;\n  }\n\n  // Carbon Tr2VertexDefinition::UsageCode (Tr2VertexDefinition.h:17-30). Note\n  // BLENDINDICES=6 before BLENDWEIGHTS=7; ccpwgl's GLES-v8 lineage has them\n  // transposed and translates at its reader boundary.\n\n  /** Carbon's vertex-usage vocabulary, in its declared order. */\n  static UsageCode = Tr2VertexUsageCode;\n\n  /** Carbon's nested Item class (h:123-141), reachable as Carbon spells it:\n   *  Tr2VertexDefinition::Item. JS cannot nest the declaration, so the class\n   *  is declared at module scope and aliased here. */\n  static Item = Tr2VertexDefinitionItem;\n\n  // Carbon's definition equality is the definition's OWN operator==\n  // (Tr2VertexDefinition.cpp:35-42): all four ledger slots AND every item,\n  // item equality being all six fields (cpp:25-33). Two meshes sharing\n  // semantics but differing in offset or stream need different input layouts,\n  // so this is deliberately stricter than the AL's shader-input match, which\n  // compares usage and usageIndex only.\n\n  /**\n   * Whether two definitions are the same declaration, field for field.\n   *\n   * Accepts a Tr2VertexDefinition or a plain element array on either side;\n   * the ledger participates only when both sides carry one, because a plain\n   * payload element list has no ledger to compare (Carbon always has both,\n   * so comparing what exists is the faithful subset).\n   */\n  static isSameDefinition(firstDefinition, secondDefinition)\n  {\n    const first = firstDefinition?.items ?? firstDefinition;\n    const second = secondDefinition?.items ?? secondDefinition;\n    if (first === second && firstDefinition === secondDefinition) return true;\n    if (!first || !second || first.length !== second.length) return false;\n\n    const firstLedger = firstDefinition?.nextOffset;\n    const secondLedger = secondDefinition?.nextOffset;\n    if (firstLedger && secondLedger)\n    {\n      for (let stream = 0; stream < 4; stream++)\n      {\n        if (firstLedger[stream] !== secondLedger[stream]) return false;\n      }\n    }\n\n    for (let index = 0; index < first.length; index++)\n    {\n      const a = first[index];\n      const b = second[index];\n\n      if (a.usage !== b.usage\n        || a.usageIndex !== b.usageIndex\n        || a.type !== b.type\n        || a.offset !== b.offset\n        || (a.stream ?? 0) !== (b.stream ?? 0)\n        || (a.instanceStepRate ?? 0) !== (b.instanceStepRate ?? 0))\n      {\n        return false;\n      }\n    }\n\n    return true;\n  }\n}\n"],"names":["USAGE_NAMES","Object","keys","Tr2VertexUsageCode","DATA_TYPE_BASE_BYTES","BYTE","UBYTE","SHORT","USHORT","INT32","UINT32","FLOAT16","UFLOAT16","FLOAT32","UFLOAT32","Tr2VertexDefinition","items","nextOffset","empty","length","Add","type","usage","usageIndex","stream","stepRate","item","Tr2VertexDefinitionItem","String","offset","instanceStepRate","getDataTypeSizeInBytes","push","Find","name","getDataTypeSizeInMembers","match","exec","Number","base","split","UsageCode","Item","isSameDefinition","firstDefinition","secondDefinition","first","second","firstLedger","secondLedger","index","a","b"],"mappings":"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"}

package/dist/trinity/core/vertex/Tr2VertexDefinition/Tr2VertexDefinitionItem.js

@@ -0,0 +1,29 @@
+// Source: trinity/trinityal/Tr2VertexDefinition.h:14-207 (the definition and its items)
+//   trinity/trinityal/Tr2VertexDefinition.cpp:25-42 (item and definition equality)
+//
+// This class is the definition and NOTHING ELSE: items, the per-stream offset
+// ledger, Add/Find/empty, and its own equality. The intern table lives on
+// Tr2EffectStateManager (Carbon s_vertexLayoutMap) and the shader-input match
+// lives in the vertex-layout AL (trinityal/vertexLayoutMatch.js) - both were
+// parked under this class's name until 2026-09-06, before it had its real
+// Carbon surface.
+
+/**
+ * One vertex element (Carbon Tr2VertexDefinition::Item, h:123-141).
+ *
+ * Carbon's usage and data type are bit-coded enums; the runtime's element
+ * vocabulary is the string names throughout (payload readers, the quad
+ * renderer, the AL's binding-plan matcher), so the item carries the names
+ * and the byte arithmetic derives from them.
+ */
+class Tr2VertexDefinitionItem {
+  usage = "POSITION";
+  usageIndex = 0;
+  type = "FLOAT32_1";
+  offset = 0;
+  stream = 0;
+  instanceStepRate = 0;
+}
+
+export { Tr2VertexDefinitionItem };
+//# sourceMappingURL=Tr2VertexDefinitionItem.js.map

package/dist/trinity/core/vertex/Tr2VertexDefinition/Tr2VertexDefinitionItem.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Tr2VertexDefinitionItem.js","sources":["../../../../../../src/trinity/core/vertex/Tr2VertexDefinition/Tr2VertexDefinitionItem.js"],"sourcesContent":["// Source: trinity/trinityal/Tr2VertexDefinition.h:14-207 (the definition and its items)\n//   trinity/trinityal/Tr2VertexDefinition.cpp:25-42 (item and definition equality)\n//\n// This class is the definition and NOTHING ELSE: items, the per-stream offset\n// ledger, Add/Find/empty, and its own equality. The intern table lives on\n// Tr2EffectStateManager (Carbon s_vertexLayoutMap) and the shader-input match\n// lives in the vertex-layout AL (trinityal/vertexLayoutMatch.js) - both were\n// parked under this class's name until 2026-09-06, before it had its real\n// Carbon surface.\n\n\n/**\n * One vertex element (Carbon Tr2VertexDefinition::Item, h:123-141).\n *\n * Carbon's usage and data type are bit-coded enums; the runtime's element\n * vocabulary is the string names throughout (payload readers, the quad\n * renderer, the AL's binding-plan matcher), so the item carries the names\n * and the byte arithmetic derives from them.\n */\nexport class Tr2VertexDefinitionItem\n{\n    usage = \"POSITION\";\n\n    usageIndex = 0;\n\n    type = \"FLOAT32_1\";\n\n    offset = 0;\n\n    stream = 0;\n\n    instanceStepRate = 0;\n}\n\n\n"],"names":["Tr2VertexDefinitionItem","usage","usageIndex","type","offset","stream","instanceStepRate"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAGA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,MAAMA,uBAAuB,CACpC;AACIC,EAAAA,KAAK,GAAG,UAAU;AAElBC,EAAAA,UAAU,GAAG,CAAC;AAEdC,EAAAA,IAAI,GAAG,WAAW;AAElBC,EAAAA,MAAM,GAAG,CAAC;AAEVC,EAAAA,MAAM,GAAG,CAAC;AAEVC,EAAAA,gBAAgB,GAAG,CAAC;AACxB;;;;"}