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

package/dist/resource/shader/reflection/Tr2EffectLibrary.js

@@ -1,6 +1,7 @@
+import { assertCarbonRecord } from '../../format/carbonRecordGuard.js';
 import { CjsSchema, impl, type } from '#schema';
 import { CjsModel } from '#model';
-import { isPlainObject } from '#utils/is';
+import '#utils/is';
 import { copyBytes } from '#utils/bytes';
 import { Tr2EffectStageInput } from './Tr2EffectStageInput.js';
 import { recordText, recordBytes, toRecordText, toRecordBlob } from './carbonRecordFields.js';
@@ -48,12 +49,12 @@ class Tr2EffectLibrary extends CjsModel {
   /** Portable export records retained before backend library registration. */
   exports = [];
 
-  /**
-   * Construct one canonical library from JS/JSON model values.
-   *
-   * @param {object} values Canonical model values.
-   * @param {object} options CjsModel import options.
-   * @returns {Tr2EffectLibrary} Hydrated library.
+  /**
+   * Construct one canonical library from JS/JSON model values.
+   *
+   * @param {object} values Canonical model values.
+   * @param {object} options CjsModel import options.
+   * @returns {Tr2EffectLibrary} Hydrated library.
    */
   static from(values = {}, options = {}) {
     let normalized = values;
@@ -74,19 +75,17 @@ class Tr2EffectLibrary extends CjsModel {
     return library;
   }
 
-  /**
-   * Build one raytracing library from its Carbon v15 description record.
-   *
-   * A library carries two `StageData` blocks of its own — a global and a local
-   * input — which are the same block a stage carries, minus the stage wrapper.
-   *
-   * @param {object} record Carbon library record.
-   * @returns {Tr2EffectLibrary} Reflected library.
+  /**
+   * Build one raytracing library from its Carbon v15 description record.
+   *
+   * A library carries two `StageData` blocks of its own — a global and a local
+   * input — which are the same block a stage carries, minus the stage wrapper.
+   *
+   * @param {object} record Carbon library record.
+   * @returns {Tr2EffectLibrary} Reflected library.
    */
   static fromCarbonBinary(record) {
-    if (!isPlainObject(record)) {
-      throw new TypeError("Carbon effect library record must be an object");
-    }
+    assertCarbonRecord(record, "library");
     const library = new this();
     library.payloadSize = record.payloadSize;
     library.hitGroupName = recordText(record.hitGroupName);
@@ -115,13 +114,13 @@ class Tr2EffectLibrary extends CjsModel {
     return library;
   }
 
-  /**
-   * Emit this library as a Carbon v15 record.
-   *
-   * `exports` is authoritative; the named entry-point fields are a view onto it
-   * and are not written separately.
-   *
-   * @returns {object} Carbon library record.
+  /**
+   * Emit this library as a Carbon v15 record.
+   *
+   * `exports` is authoritative; the named entry-point fields are a view onto it
+   * and are not written separately.
+   *
+   * @returns {object} Carbon library record.
    */
   toCarbonBinary() {
     const program = this.sourceProgram ?? {};

package/dist/resource/shader/reflection/Tr2EffectLibrary.js.map

@@ -1 +1 @@
-{"version":3,"file":"Tr2EffectLibrary.js","sources":["../../../../../src/resource/shader/reflection/Tr2EffectLibrary.js"],"sourcesContent":["// Source: trinity/trinity/Shader/Tr2EffectDescription.h\r\nimport { CjsSchema, impl, type } from \"#schema\";\r\nimport { CjsModel } from \"#model\";\r\nimport {\r\n  isPlainObject\r\n} from \"#utils/is\";\r\nimport { copyBytes } from \"#utils/bytes\";\r\nimport { Tr2EffectStageInput } from \"./Tr2EffectStageInput.js\";\r\nimport {\r\n  recordBytes,\r\n  recordText,\r\n  toRecordBlob,\r\n  toRecordText\r\n} from \"./carbonRecordFields.js\";\r\n\r\n/** Reflected shader-library metadata. */\r\nexport class Tr2EffectLibrary extends CjsModel\r\n{\r\n\r\n  /** payloadSize (uint32_t) */\r\n  payloadSize = 0;\r\n\r\n  /** libraryHandle (uint32_t) */\r\n  libraryHandle = 0;\r\n\r\n  /** rayGenName (BlueSharedStringW) */\r\n  rayGenName = \"\";\r\n\r\n  /** missName (BlueSharedStringW) */\r\n  missName = \"\";\r\n\r\n  /** closestHitName (BlueSharedStringW) */\r\n  closestHitName = \"\";\r\n\r\n  /** anyHitName (BlueSharedStringW) */\r\n  anyHitName = \"\";\r\n\r\n  /** intersectionName (BlueSharedStringW) */\r\n  intersectionName = \"\";\r\n\r\n  /** hitGroupName (BlueSharedStringW) */\r\n  hitGroupName = \"\";\r\n\r\n  /** globalInput (Tr2EffectStageInput) */\r\n  globalInput = null;\r\n\r\n  /** localInput (Tr2EffectStageInput) */\r\n  localInput = null;\r\n\r\n  /** globalResourceSetDesc (Tr2ResourceSetDescriptionAL) */\r\n  globalResourceSetDesc = null;\r\n\r\n  /** Exact source library program metadata and owned bytes. */\r\n  sourceProgram = null;\r\n\r\n  /** Portable export records retained before backend library registration. */\r\n  exports = [];\r\n\r\n  /**\r\n   * Construct one canonical library from JS/JSON model values.\r\n   *\r\n   * @param {object} values Canonical model values.\r\n   * @param {object} options CjsModel import options.\r\n   * @returns {Tr2EffectLibrary} Hydrated library.\r\n   */\r\n  static from(values = {}, options = {})\r\n  {\r\n    let normalized = values;\r\n    const inputs = new Map();\r\n    for (const field of [ \"globalInput\", \"localInput\" ])\r\n    {\r\n      if (values?.[field]\r\n        && !(values[field] instanceof Tr2EffectStageInput))\r\n      {\r\n        normalized = normalized === values ? { ...values } : normalized;\r\n        normalized[field] = Tr2EffectStageInput.from(\r\n          values[field],\r\n          options\r\n        );\r\n        inputs.set(field, normalized[field]);\r\n      }\r\n    }\r\n    const library = super.from(normalized, options);\r\n    for (const [ field, value ] of inputs)\r\n    {\r\n      library[field] = value;\r\n    }\r\n    return library;\r\n  }\r\n\r\n  /**\r\n   * Build one raytracing library from its Carbon v15 description record.\r\n   *\r\n   * A library carries two `StageData` blocks of its own — a global and a local\r\n   * input — which are the same block a stage carries, minus the stage wrapper.\r\n   *\r\n   * @param {object} record Carbon library record.\r\n   * @returns {Tr2EffectLibrary} Reflected library.\r\n   */\r\n  static fromCarbonBinary(record)\r\n  {\r\n    if (!isPlainObject(record))\r\n    {\r\n      throw new TypeError(\"Carbon effect library record must be an object\");\r\n    }\r\n\r\n    const library = new this();\r\n    library.payloadSize = record.payloadSize;\r\n    library.hitGroupName = recordText(record.hitGroupName);\r\n    library.exports = record.exports.map(entry => ({\r\n      type: entry.type,\r\n      name: recordText(entry.name)\r\n    }));\r\n    // The export type is the only thing that names an entry point; the record\r\n    // stores a flat list and the named fields are a view onto it.\r\n    for (const entry of library.exports)\r\n    {\r\n      if (entry.type === 0) library.rayGenName = entry.name;\r\n      if (entry.type === 1) library.missName = entry.name;\r\n      if (entry.type === 2) library.closestHitName = entry.name;\r\n      if (entry.type === 3) library.anyHitName = entry.name;\r\n      if (entry.type === 4) library.intersectionName = entry.name;\r\n    }\r\n    library.sourceProgram = {\r\n      kind: \"library\",\r\n      bytes: copyBytes(recordBytes(record.shaderData)),\r\n      shaderSize: record.shaderData.size,\r\n      // See Tr2EffectStageInput: only a zero-size blob's word is portable.\r\n      unsetOffset: record.shaderData.size === 0\r\n        ? record.shaderData.offset\r\n        : 0xffffffff\r\n    };\r\n    library.globalInput = Tr2EffectStageInput.fromCarbonBinaryInput(\r\n      record.globalInputs\r\n    );\r\n    library.localInput = Tr2EffectStageInput.fromCarbonBinaryInput(\r\n      record.localInputs\r\n    );\r\n    return library;\r\n  }\r\n\r\n\r\n  /**\r\n   * Emit this library as a Carbon v15 record.\r\n   *\r\n   * `exports` is authoritative; the named entry-point fields are a view onto it\r\n   * and are not written separately.\r\n   *\r\n   * @returns {object} Carbon library record.\r\n   */\r\n  toCarbonBinary()\r\n  {\r\n    const program = this.sourceProgram ?? {};\r\n    return {\r\n      payloadSize: this.payloadSize >>> 0,\r\n      shaderData: toRecordBlob(\r\n        program.bytes,\r\n        program.shaderSize,\r\n        program.unsetOffset\r\n      ),\r\n      exports: this.exports.map(entry => ({\r\n        type: entry.type,\r\n        name: toRecordText(entry.name)\r\n      })),\r\n      hitGroupName: toRecordText(this.hitGroupName),\r\n      globalInputs: this.globalInput.toCarbonBinaryInput(),\r\n      localInputs: this.localInput.toCarbonBinaryInput()\r\n    };\r\n  }\r\n}\r\n\r\n// Declared imperatively rather than with decorators, so this module stays\r\n// plain ESM that loads from source without a transform. The decorator\r\n// expressions are reused verbatim, so the registered metadata is identical.\r\n// Statics belong in `methods`: decorateMethod targets the prototype and\r\n// would register a static as an instance field.\r\nCjsSchema.define(Tr2EffectLibrary, {\r\n  className: \"Tr2EffectLibrary\",\r\n  family: \"shader\",\r\n  fields: {\r\n    payloadSize: type.uint32,\r\n    libraryHandle: type.uint32,\r\n    rayGenName: type.string,\r\n    missName: type.string,\r\n    closestHitName: type.string,\r\n    anyHitName: type.string,\r\n    intersectionName: type.string,\r\n    hitGroupName: type.string,\r\n    globalInput: type.rawStruct(\"Tr2EffectStageInput\"),\r\n    localInput: type.rawStruct(\"Tr2EffectStageInput\"),\r\n    globalResourceSetDesc: type.rawStruct(\"Tr2ResourceSetDescriptionAL\"),\r\n    sourceProgram: [ impl.adapted, impl.reason(\"Carbon registers the library with the renderer while reading; the device-free graph retains the source program for later engine realization.\"), type.rawStruct(\"CjsEffectSourceProgram\") ],\r\n    exports: [ impl.adapted, impl.reason(\"Carbon resolves these exports into a renderer library handle; the device-free graph keeps the declarative export list.\"), type.rawStruct(\"CjsEffectLibraryExports\") ]\r\n  }\r\n});\r\n"],"names":["Tr2EffectLibrary","CjsModel","payloadSize","libraryHandle","rayGenName","missName","closestHitName","anyHitName","intersectionName","hitGroupName","globalInput","localInput","globalResourceSetDesc","sourceProgram","exports","from","values","options","normalized","inputs","Map","field","Tr2EffectStageInput","set","library","value","fromCarbonBinary","record","isPlainObject","TypeError","recordText","map","entry","type","name","kind","bytes","copyBytes","recordBytes","shaderData","shaderSize","size","unsetOffset","offset","fromCarbonBinaryInput","globalInputs","localInputs","toCarbonBinary","program","toRecordBlob","toRecordText","toCarbonBinaryInput","CjsSchema","define","className","family","fields","uint32","string","rawStruct","impl","adapted","reason"],"mappings":"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"}
+{"version":3,"file":"Tr2EffectLibrary.js","sources":["../../../../../src/resource/shader/reflection/Tr2EffectLibrary.js"],"sourcesContent":["// Source: trinity/trinity/Shader/Tr2EffectDescription.h\nimport { assertCarbonRecord } from \"../../format/carbonRecordGuard.js\";\nimport { CjsSchema, impl, type } from \"#schema\";\nimport { CjsModel } from \"#model\";\nimport {\n} from \"#utils/is\";\nimport { copyBytes } from \"#utils/bytes\";\nimport { Tr2EffectStageInput } from \"./Tr2EffectStageInput.js\";\nimport {\n  recordBytes,\n  recordText,\n  toRecordBlob,\n  toRecordText\n} from \"./carbonRecordFields.js\";\n\n/** Reflected shader-library metadata. */\nexport class Tr2EffectLibrary extends CjsModel\n{\n\n  /** payloadSize (uint32_t) */\n  payloadSize = 0;\n\n  /** libraryHandle (uint32_t) */\n  libraryHandle = 0;\n\n  /** rayGenName (BlueSharedStringW) */\n  rayGenName = \"\";\n\n  /** missName (BlueSharedStringW) */\n  missName = \"\";\n\n  /** closestHitName (BlueSharedStringW) */\n  closestHitName = \"\";\n\n  /** anyHitName (BlueSharedStringW) */\n  anyHitName = \"\";\n\n  /** intersectionName (BlueSharedStringW) */\n  intersectionName = \"\";\n\n  /** hitGroupName (BlueSharedStringW) */\n  hitGroupName = \"\";\n\n  /** globalInput (Tr2EffectStageInput) */\n  globalInput = null;\n\n  /** localInput (Tr2EffectStageInput) */\n  localInput = null;\n\n  /** globalResourceSetDesc (Tr2ResourceSetDescriptionAL) */\n  globalResourceSetDesc = null;\n\n  /** Exact source library program metadata and owned bytes. */\n  sourceProgram = null;\n\n  /** Portable export records retained before backend library registration. */\n  exports = [];\n\n  /**\n   * Construct one canonical library from JS/JSON model values.\n   *\n   * @param {object} values Canonical model values.\n   * @param {object} options CjsModel import options.\n   * @returns {Tr2EffectLibrary} Hydrated library.\n   */\n  static from(values = {}, options = {})\n  {\n    let normalized = values;\n    const inputs = new Map();\n    for (const field of [ \"globalInput\", \"localInput\" ])\n    {\n      if (values?.[field]\n        && !(values[field] instanceof Tr2EffectStageInput))\n      {\n        normalized = normalized === values ? { ...values } : normalized;\n        normalized[field] = Tr2EffectStageInput.from(\n          values[field],\n          options\n        );\n        inputs.set(field, normalized[field]);\n      }\n    }\n    const library = super.from(normalized, options);\n    for (const [ field, value ] of inputs)\n    {\n      library[field] = value;\n    }\n    return library;\n  }\n\n  /**\n   * Build one raytracing library from its Carbon v15 description record.\n   *\n   * A library carries two `StageData` blocks of its own — a global and a local\n   * input — which are the same block a stage carries, minus the stage wrapper.\n   *\n   * @param {object} record Carbon library record.\n   * @returns {Tr2EffectLibrary} Reflected library.\n   */\n  static fromCarbonBinary(record)\n  {\n    assertCarbonRecord(record, \"library\");\n\n    const library = new this();\n    library.payloadSize = record.payloadSize;\n    library.hitGroupName = recordText(record.hitGroupName);\n    library.exports = record.exports.map(entry => ({\n      type: entry.type,\n      name: recordText(entry.name)\n    }));\n    // The export type is the only thing that names an entry point; the record\n    // stores a flat list and the named fields are a view onto it.\n    for (const entry of library.exports)\n    {\n      if (entry.type === 0) library.rayGenName = entry.name;\n      if (entry.type === 1) library.missName = entry.name;\n      if (entry.type === 2) library.closestHitName = entry.name;\n      if (entry.type === 3) library.anyHitName = entry.name;\n      if (entry.type === 4) library.intersectionName = entry.name;\n    }\n    library.sourceProgram = {\n      kind: \"library\",\n      bytes: copyBytes(recordBytes(record.shaderData)),\n      shaderSize: record.shaderData.size,\n      // See Tr2EffectStageInput: only a zero-size blob's word is portable.\n      unsetOffset: record.shaderData.size === 0\n        ? record.shaderData.offset\n        : 0xffffffff\n    };\n    library.globalInput = Tr2EffectStageInput.fromCarbonBinaryInput(\n      record.globalInputs\n    );\n    library.localInput = Tr2EffectStageInput.fromCarbonBinaryInput(\n      record.localInputs\n    );\n    return library;\n  }\n\n\n  /**\n   * Emit this library as a Carbon v15 record.\n   *\n   * `exports` is authoritative; the named entry-point fields are a view onto it\n   * and are not written separately.\n   *\n   * @returns {object} Carbon library record.\n   */\n  toCarbonBinary()\n  {\n    const program = this.sourceProgram ?? {};\n    return {\n      payloadSize: this.payloadSize >>> 0,\n      shaderData: toRecordBlob(\n        program.bytes,\n        program.shaderSize,\n        program.unsetOffset\n      ),\n      exports: this.exports.map(entry => ({\n        type: entry.type,\n        name: toRecordText(entry.name)\n      })),\n      hitGroupName: toRecordText(this.hitGroupName),\n      globalInputs: this.globalInput.toCarbonBinaryInput(),\n      localInputs: this.localInput.toCarbonBinaryInput()\n    };\n  }\n}\n\n// Declared imperatively rather than with decorators, so this module stays\n// plain ESM that loads from source without a transform. The decorator\n// expressions are reused verbatim, so the registered metadata is identical.\n// Statics belong in `methods`: decorateMethod targets the prototype and\n// would register a static as an instance field.\nCjsSchema.define(Tr2EffectLibrary, {\n  className: \"Tr2EffectLibrary\",\n  family: \"shader\",\n  fields: {\n    payloadSize: type.uint32,\n    libraryHandle: type.uint32,\n    rayGenName: type.string,\n    missName: type.string,\n    closestHitName: type.string,\n    anyHitName: type.string,\n    intersectionName: type.string,\n    hitGroupName: type.string,\n    globalInput: type.rawStruct(\"Tr2EffectStageInput\"),\n    localInput: type.rawStruct(\"Tr2EffectStageInput\"),\n    globalResourceSetDesc: type.rawStruct(\"Tr2ResourceSetDescriptionAL\"),\n    sourceProgram: [ impl.adapted, impl.reason(\"Carbon registers the library with the renderer while reading; the device-free graph retains the source program for later engine realization.\"), type.rawStruct(\"CjsEffectSourceProgram\") ],\n    exports: [ impl.adapted, impl.reason(\"Carbon resolves these exports into a renderer library handle; the device-free graph keeps the declarative export list.\"), type.rawStruct(\"CjsEffectLibraryExports\") ]\n  }\n});\n"],"names":["Tr2EffectLibrary","CjsModel","payloadSize","libraryHandle","rayGenName","missName","closestHitName","anyHitName","intersectionName","hitGroupName","globalInput","localInput","globalResourceSetDesc","sourceProgram","exports","from","values","options","normalized","inputs","Map","field","Tr2EffectStageInput","set","library","value","fromCarbonBinary","record","assertCarbonRecord","recordText","map","entry","type","name","kind","bytes","copyBytes","recordBytes","shaderData","shaderSize","size","unsetOffset","offset","fromCarbonBinaryInput","globalInputs","localInputs","toCarbonBinary","program","toRecordBlob","toRecordText","toCarbonBinaryInput","CjsSchema","define","className","family","fields","uint32","string","rawStruct","impl","adapted","reason"],"mappings":"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"}

package/dist/resource/shader/reflection/Tr2EffectParameterAnnotation.js

@@ -1,7 +1,8 @@
+import { assertCarbonRecord } from '../../format/carbonRecordGuard.js';
 import { CjsSchema, type, impl } from '#schema';
 import { CjsModel } from '#model';
 import { dwordToFloat } from '#math/num';
-import { isPlainObject } from '#utils/is';
+import '#utils/is';
 import { recordText, recordRawValue, toRecordText, toRecordRawValue } from './carbonRecordFields.js';
 
 // Source: trinity/trinity/Shader/Tr2EffectDescription.h
@@ -29,22 +30,20 @@ class Tr2EffectParameterAnnotation extends CjsModel {
   /** stringValue (const char*) */
   stringValue = "";
 
-  /**
-   * Build one typed annotation from its Carbon v15 description record.
-   *
-   * The type byte decides which member is meaningful, and every non-string type
-   * arrives as four untyped bytes rather than a number — Carbon writes the value
-   * through one member of a `{float,int32_t}` union and reads it back through
-   * another, so the bit pattern is the only faithful carrier. `rawValue` keeps
-   * those bits and the typed accessor is derived from them, never the reverse.
-   *
-   * @param {object} record Carbon annotation record.
-   * @returns {Tr2EffectParameterAnnotation} Reflected annotation.
+  /**
+   * Build one typed annotation from its Carbon v15 description record.
+   *
+   * The type byte decides which member is meaningful, and every non-string type
+   * arrives as four untyped bytes rather than a number — Carbon writes the value
+   * through one member of a `{float,int32_t}` union and reads it back through
+   * another, so the bit pattern is the only faithful carrier. `rawValue` keeps
+   * those bits and the typed accessor is derived from them, never the reverse.
+   *
+   * @param {object} record Carbon annotation record.
+   * @returns {Tr2EffectParameterAnnotation} Reflected annotation.
    */
   static fromCarbonBinary(record) {
-    if (!isPlainObject(record)) {
-      throw new TypeError("Carbon effect annotation record must be an object");
-    }
+    assertCarbonRecord(record, "annotation");
     const annotation = new this();
     annotation.name = recordText(record.name);
     annotation.type = record.type;
@@ -70,13 +69,13 @@ class Tr2EffectParameterAnnotation extends CjsModel {
     return annotation;
   }
 
-  /**
-   * Emit this annotation as a Carbon v15 record.
-   *
-   * The type byte decides which branch the writer takes, and every non-string
-   * type travels as the raw bits rather than the typed member.
-   *
-   * @returns {object} Carbon annotation record.
+  /**
+   * Emit this annotation as a Carbon v15 record.
+   *
+   * The type byte decides which branch the writer takes, and every non-string
+   * type travels as the raw bits rather than the typed member.
+   *
+   * @returns {object} Carbon annotation record.
    */
   toCarbonBinary() {
     if (this.type === Tr2EffectParameterAnnotation.Type.STRING) {

package/dist/resource/shader/reflection/Tr2EffectParameterAnnotation.js.map

@@ -1 +1 @@
-{"version":3,"file":"Tr2EffectParameterAnnotation.js","sources":["../../../../../src/resource/shader/reflection/Tr2EffectParameterAnnotation.js"],"sourcesContent":["// Source: trinity/trinity/Shader/Tr2EffectDescription.h\r\nimport { CjsSchema, impl, type } from \"#schema\";\r\nimport { CjsModel } from \"#model\";\r\nimport { dwordToFloat } from \"#math/num\";\r\nimport {\r\n  isPlainObject\r\n} from \"#utils/is\";\r\nimport { recordRawValue, recordText, toRecordRawValue, toRecordText } from \"./carbonRecordFields.js\";\r\n\r\n/** Typed annotation attached to a reflected effect parameter. */\r\nexport class Tr2EffectParameterAnnotation extends CjsModel\r\n{\r\n\r\n  /** name (const char*) */\r\n  name = \"\";\r\n\r\n  /** type (Type - enum Type) */\r\n  type = 0;\r\n\r\n  /** boolValue (bool) */\r\n  boolValue = false;\r\n\r\n  /** Exact serialized BOOL, INT, or FLOAT payload bits. */\r\n  rawValue = 0;\r\n\r\n  /** intValue (int) */\r\n  intValue = 0;\r\n\r\n  /** floatValue (float) */\r\n  floatValue = 0;\r\n\r\n  /** stringValue (const char*) */\r\n  stringValue = \"\";\r\n\r\n  /**\r\n   * Build one typed annotation from its Carbon v15 description record.\r\n   *\r\n   * The type byte decides which member is meaningful, and every non-string type\r\n   * arrives as four untyped bytes rather than a number — Carbon writes the value\r\n   * through one member of a `{float,int32_t}` union and reads it back through\r\n   * another, so the bit pattern is the only faithful carrier. `rawValue` keeps\r\n   * those bits and the typed accessor is derived from them, never the reverse.\r\n   *\r\n   * @param {object} record Carbon annotation record.\r\n   * @returns {Tr2EffectParameterAnnotation} Reflected annotation.\r\n   */\r\n  static fromCarbonBinary(record)\r\n  {\r\n    if (!isPlainObject(record))\r\n    {\r\n      throw new TypeError(\"Carbon effect annotation record must be an object\");\r\n    }\r\n\r\n    const annotation = new this();\r\n    annotation.name = recordText(record.name);\r\n    annotation.type = record.type;\r\n\r\n    switch (annotation.type)\r\n    {\r\n      case this.Type.BOOL:\r\n        annotation.rawValue = recordRawValue(record.rawValue);\r\n        annotation.boolValue = annotation.rawValue !== 0;\r\n        break;\r\n\r\n      case this.Type.INT:\r\n        annotation.rawValue = recordRawValue(record.rawValue);\r\n        annotation.intValue = annotation.rawValue | 0;\r\n        break;\r\n\r\n      case this.Type.FLOAT:\r\n        annotation.rawValue = recordRawValue(record.rawValue);\r\n        annotation.floatValue = dwordToFloat(annotation.rawValue);\r\n        break;\r\n\r\n      case this.Type.STRING:\r\n        annotation.stringValue = recordText(record.stringValue);\r\n        break;\r\n\r\n      default:\r\n        throw new Error(\r\n          `Carbon effect annotation type ${annotation.type} is unsupported`\r\n        );\r\n    }\r\n\r\n    return annotation;\r\n  }\r\n\r\n  /**\r\n   * Emit this annotation as a Carbon v15 record.\r\n   *\r\n   * The type byte decides which branch the writer takes, and every non-string\r\n   * type travels as the raw bits rather than the typed member.\r\n   *\r\n   * @returns {object} Carbon annotation record.\r\n   */\r\n  toCarbonBinary()\r\n  {\r\n    if (this.type === Tr2EffectParameterAnnotation.Type.STRING)\r\n    {\r\n      return {\r\n        name: toRecordText(this.name),\r\n        type: this.type,\r\n        stringValue: toRecordText(this.stringValue),\r\n        rawValue: null\r\n      };\r\n    }\r\n    return {\r\n      name: toRecordText(this.name),\r\n      type: this.type,\r\n      stringValue: null,\r\n      rawValue: toRecordRawValue(this.rawValue)\r\n    };\r\n  }\r\n\r\n  static Type = Object.freeze({\r\n    BOOL: 0,\r\n    INT: 1,\r\n    FLOAT: 2,\r\n    STRING: 3\r\n  });\r\n\r\n}\r\n\r\n// Declared imperatively rather than with decorators, so this module stays\r\n// plain ESM that loads from source without a transform. The decorator\r\n// expressions are reused verbatim, so the registered metadata is identical.\r\n// Statics belong in `methods`: decorateMethod targets the prototype and\r\n// would register a static as an instance field.\r\nCjsSchema.define(Tr2EffectParameterAnnotation, {\r\n  className: \"Tr2EffectParameterAnnotation\",\r\n  family: \"shader\",\r\n  fields: {\r\n    name: type.string,\r\n    type: [ type.int32, type.enum(\"Type\") ],\r\n    boolValue: type.boolean,\r\n    rawValue: [ impl.adapted, impl.reason(\"Carbon reads numeric annotations into typed values; the portable source contract retains the exact uint32 payload so NaN, negative zero, and integer bit patterns round-trip losslessly.\"), type.uint32 ],\r\n    intValue: type.int32,\r\n    floatValue: type.float32,\r\n    stringValue: type.string\r\n  }\r\n});\r\n"],"names":["Tr2EffectParameterAnnotation","CjsModel","name","type","boolValue","rawValue","intValue","floatValue","stringValue","fromCarbonBinary","record","isPlainObject","TypeError","annotation","recordText","Type","BOOL","recordRawValue","INT","FLOAT","dwordToFloat","STRING","Error","toCarbonBinary","toRecordText","toRecordRawValue","Object","freeze","CjsSchema","define","className","family","fields","string","int32","enum","boolean","impl","adapted","reason","uint32","float32"],"mappings":"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"}
+{"version":3,"file":"Tr2EffectParameterAnnotation.js","sources":["../../../../../src/resource/shader/reflection/Tr2EffectParameterAnnotation.js"],"sourcesContent":["// Source: trinity/trinity/Shader/Tr2EffectDescription.h\nimport { assertCarbonRecord } from \"../../format/carbonRecordGuard.js\";\nimport { CjsSchema, impl, type } from \"#schema\";\nimport { CjsModel } from \"#model\";\nimport { dwordToFloat } from \"#math/num\";\nimport {\n} from \"#utils/is\";\nimport { recordRawValue, recordText, toRecordRawValue, toRecordText } from \"./carbonRecordFields.js\";\n\n/** Typed annotation attached to a reflected effect parameter. */\nexport class Tr2EffectParameterAnnotation extends CjsModel\n{\n\n  /** name (const char*) */\n  name = \"\";\n\n  /** type (Type - enum Type) */\n  type = 0;\n\n  /** boolValue (bool) */\n  boolValue = false;\n\n  /** Exact serialized BOOL, INT, or FLOAT payload bits. */\n  rawValue = 0;\n\n  /** intValue (int) */\n  intValue = 0;\n\n  /** floatValue (float) */\n  floatValue = 0;\n\n  /** stringValue (const char*) */\n  stringValue = \"\";\n\n  /**\n   * Build one typed annotation from its Carbon v15 description record.\n   *\n   * The type byte decides which member is meaningful, and every non-string type\n   * arrives as four untyped bytes rather than a number — Carbon writes the value\n   * through one member of a `{float,int32_t}` union and reads it back through\n   * another, so the bit pattern is the only faithful carrier. `rawValue` keeps\n   * those bits and the typed accessor is derived from them, never the reverse.\n   *\n   * @param {object} record Carbon annotation record.\n   * @returns {Tr2EffectParameterAnnotation} Reflected annotation.\n   */\n  static fromCarbonBinary(record)\n  {\n    assertCarbonRecord(record, \"annotation\");\n\n    const annotation = new this();\n    annotation.name = recordText(record.name);\n    annotation.type = record.type;\n\n    switch (annotation.type)\n    {\n      case this.Type.BOOL:\n        annotation.rawValue = recordRawValue(record.rawValue);\n        annotation.boolValue = annotation.rawValue !== 0;\n        break;\n\n      case this.Type.INT:\n        annotation.rawValue = recordRawValue(record.rawValue);\n        annotation.intValue = annotation.rawValue | 0;\n        break;\n\n      case this.Type.FLOAT:\n        annotation.rawValue = recordRawValue(record.rawValue);\n        annotation.floatValue = dwordToFloat(annotation.rawValue);\n        break;\n\n      case this.Type.STRING:\n        annotation.stringValue = recordText(record.stringValue);\n        break;\n\n      default:\n        throw new Error(\n          `Carbon effect annotation type ${annotation.type} is unsupported`\n        );\n    }\n\n    return annotation;\n  }\n\n  /**\n   * Emit this annotation as a Carbon v15 record.\n   *\n   * The type byte decides which branch the writer takes, and every non-string\n   * type travels as the raw bits rather than the typed member.\n   *\n   * @returns {object} Carbon annotation record.\n   */\n  toCarbonBinary()\n  {\n    if (this.type === Tr2EffectParameterAnnotation.Type.STRING)\n    {\n      return {\n        name: toRecordText(this.name),\n        type: this.type,\n        stringValue: toRecordText(this.stringValue),\n        rawValue: null\n      };\n    }\n    return {\n      name: toRecordText(this.name),\n      type: this.type,\n      stringValue: null,\n      rawValue: toRecordRawValue(this.rawValue)\n    };\n  }\n\n  static Type = Object.freeze({\n    BOOL: 0,\n    INT: 1,\n    FLOAT: 2,\n    STRING: 3\n  });\n\n}\n\n// Declared imperatively rather than with decorators, so this module stays\n// plain ESM that loads from source without a transform. The decorator\n// expressions are reused verbatim, so the registered metadata is identical.\n// Statics belong in `methods`: decorateMethod targets the prototype and\n// would register a static as an instance field.\nCjsSchema.define(Tr2EffectParameterAnnotation, {\n  className: \"Tr2EffectParameterAnnotation\",\n  family: \"shader\",\n  fields: {\n    name: type.string,\n    type: [ type.int32, type.enum(\"Type\") ],\n    boolValue: type.boolean,\n    rawValue: [ impl.adapted, impl.reason(\"Carbon reads numeric annotations into typed values; the portable source contract retains the exact uint32 payload so NaN, negative zero, and integer bit patterns round-trip losslessly.\"), type.uint32 ],\n    intValue: type.int32,\n    floatValue: type.float32,\n    stringValue: type.string\n  }\n});\n"],"names":["Tr2EffectParameterAnnotation","CjsModel","name","type","boolValue","rawValue","intValue","floatValue","stringValue","fromCarbonBinary","record","assertCarbonRecord","annotation","recordText","Type","BOOL","recordRawValue","INT","FLOAT","dwordToFloat","STRING","Error","toCarbonBinary","toRecordText","toRecordRawValue","Object","freeze","CjsSchema","define","className","family","fields","string","int32","enum","boolean","impl","adapted","reason","uint32","float32"],"mappings":";;;;;;;AAAA;;AASA;AACO,MAAMA,4BAA4B,SAASC,QAAQ,CAC1D;AAEE;AACAC,EAAAA,IAAI,GAAG,EAAE;;AAET;AACAC,EAAAA,IAAI,GAAG,CAAC;;AAER;AACAC,EAAAA,SAAS,GAAG,KAAK;;AAEjB;AACAC,EAAAA,QAAQ,GAAG,CAAC;;AAEZ;AACAC,EAAAA,QAAQ,GAAG,CAAC;;AAEZ;AACAC,EAAAA,UAAU,GAAG,CAAC;;AAEd;AACAC,EAAAA,WAAW,GAAG,EAAE;;AAEhB;AACF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;EACE,OAAOC,gBAAgBA,CAACC,MAAM,EAC9B;AACEC,IAAAA,kBAAkB,CAACD,MAAM,EAAE,YAAY,CAAC;AAExC,IAAA,MAAME,UAAU,GAAG,IAAI,IAAI,EAAE;IAC7BA,UAAU,CAACV,IAAI,GAAGW,UAAU,CAACH,MAAM,CAACR,IAAI,CAAC;AACzCU,IAAAA,UAAU,CAACT,IAAI,GAAGO,MAAM,CAACP,IAAI;IAE7B,QAAQS,UAAU,CAACT,IAAI;AAErB,MAAA,KAAK,IAAI,CAACW,IAAI,CAACC,IAAI;QACjBH,UAAU,CAACP,QAAQ,GAAGW,cAAc,CAACN,MAAM,CAACL,QAAQ,CAAC;AACrDO,QAAAA,UAAU,CAACR,SAAS,GAAGQ,UAAU,CAACP,QAAQ,KAAK,CAAC;AAChD,QAAA;AAEF,MAAA,KAAK,IAAI,CAACS,IAAI,CAACG,GAAG;QAChBL,UAAU,CAACP,QAAQ,GAAGW,cAAc,CAACN,MAAM,CAACL,QAAQ,CAAC;AACrDO,QAAAA,UAAU,CAACN,QAAQ,GAAGM,UAAU,CAACP,QAAQ,GAAG,CAAC;AAC7C,QAAA;AAEF,MAAA,KAAK,IAAI,CAACS,IAAI,CAACI,KAAK;QAClBN,UAAU,CAACP,QAAQ,GAAGW,cAAc,CAACN,MAAM,CAACL,QAAQ,CAAC;QACrDO,UAAU,CAACL,UAAU,GAAGY,YAAY,CAACP,UAAU,CAACP,QAAQ,CAAC;AACzD,QAAA;AAEF,MAAA,KAAK,IAAI,CAACS,IAAI,CAACM,MAAM;QACnBR,UAAU,CAACJ,WAAW,GAAGK,UAAU,CAACH,MAAM,CAACF,WAAW,CAAC;AACvD,QAAA;AAEF,MAAA;QACE,MAAM,IAAIa,KAAK,CACb,CAAA,8BAAA,EAAiCT,UAAU,CAACT,IAAI,iBAClD,CAAC;AACL;AAEA,IAAA,OAAOS,UAAU;AACnB,EAAA;;AAEA;AACF;AACA;AACA;AACA;AACA;AACA;AACA;AACEU,EAAAA,cAAcA,GACd;IACE,IAAI,IAAI,CAACnB,IAAI,KAAKH,4BAA4B,CAACc,IAAI,CAACM,MAAM,EAC1D;MACE,OAAO;AACLlB,QAAAA,IAAI,EAAEqB,YAAY,CAAC,IAAI,CAACrB,IAAI,CAAC;QAC7BC,IAAI,EAAE,IAAI,CAACA,IAAI;AACfK,QAAAA,WAAW,EAAEe,YAAY,CAAC,IAAI,CAACf,WAAW,CAAC;AAC3CH,QAAAA,QAAQ,EAAE;OACX;AACH,IAAA;IACA,OAAO;AACLH,MAAAA,IAAI,EAAEqB,YAAY,CAAC,IAAI,CAACrB,IAAI,CAAC;MAC7BC,IAAI,EAAE,IAAI,CAACA,IAAI;AACfK,MAAAA,WAAW,EAAE,IAAI;AACjBH,MAAAA,QAAQ,EAAEmB,gBAAgB,CAAC,IAAI,CAACnB,QAAQ;KACzC;AACH,EAAA;AAEA,EAAA,OAAOS,IAAI,GAAGW,MAAM,CAACC,MAAM,CAAC;AAC1BX,IAAAA,IAAI,EAAE,CAAC;AACPE,IAAAA,GAAG,EAAE,CAAC;AACNC,IAAAA,KAAK,EAAE,CAAC;AACRE,IAAAA,MAAM,EAAE;AACV,GAAC,CAAC;AAEJ;;AAEA;AACA;AACA;AACA;AACA;AACAO,SAAS,CAACC,MAAM,CAAC5B,4BAA4B,EAAE;AAC7C6B,EAAAA,SAAS,EAAE,8BAA8B;AACzCC,EAAAA,MAAM,EAAE,QAAQ;AAChBC,EAAAA,MAAM,EAAE;IACN7B,IAAI,EAAEC,IAAI,CAAC6B,MAAM;AACjB7B,IAAAA,IAAI,EAAE,CAAEA,IAAI,CAAC8B,KAAK,EAAE9B,IAAI,CAAC+B,IAAI,CAAC,MAAM,CAAC,CAAE;IACvC9B,SAAS,EAAED,IAAI,CAACgC,OAAO;AACvB9B,IAAAA,QAAQ,EAAE,CAAE+B,IAAI,CAACC,OAAO,EAAED,IAAI,CAACE,MAAM,CAAC,0LAA0L,CAAC,EAAEnC,IAAI,CAACoC,MAAM,CAAE;IAChPjC,QAAQ,EAAEH,IAAI,CAAC8B,KAAK;IACpB1B,UAAU,EAAEJ,IAAI,CAACqC,OAAO;IACxBhC,WAAW,EAAEL,IAAI,CAAC6B;AACpB;AACF,CAAC,CAAC;;;;"}

package/dist/resource/shader/reflection/Tr2EffectResource.js

@@ -1,6 +1,7 @@
+import { assertCarbonRecord } from '../../format/carbonRecordGuard.js';
 import { CjsSchema, type } from '#schema';
 import { CjsModel } from '#model';
-import { isPlainObject } from '#utils/is';
+import '#utils/is';
 import { recordText, toRecordText } from './carbonRecordFields.js';
 
 // Source: trinity/trinity/Shader/Tr2EffectDescription.h
@@ -22,23 +23,21 @@ class Tr2EffectResource extends CjsModel {
   /** arrayElements (uint32_t) */
   arrayElements = 0;
 
-  /**
-   * Build one SRV or UAV from its Carbon v15 description record.
-   *
-   * Both a texture record and a UAV record land here, and they are not the same
-   * shape: a UAV record carries no `isSRGB` at all. Carbon's reader hardcodes
-   * `isSRGB = false` for UAVs rather than reading a byte, and `Uav::Save` omits
-   * it, so the field being absent is correct rather than missing — reading
-   * `undefined` through `!!` reproduces Carbon exactly. The array size is spelled
-   * `count` in the record and `arrayElements` on the class.
-   *
-   * @param {object} record Carbon texture or UAV record.
-   * @returns {Tr2EffectResource} Reflected resource.
+  /**
+   * Build one SRV or UAV from its Carbon v15 description record.
+   *
+   * Both a texture record and a UAV record land here, and they are not the same
+   * shape: a UAV record carries no `isSRGB` at all. Carbon's reader hardcodes
+   * `isSRGB = false` for UAVs rather than reading a byte, and `Uav::Save` omits
+   * it, so the field being absent is correct rather than missing — reading
+   * `undefined` through `!!` reproduces Carbon exactly. The array size is spelled
+   * `count` in the record and `arrayElements` on the class.
+   *
+   * @param {object} record Carbon texture or UAV record.
+   * @returns {Tr2EffectResource} Reflected resource.
    */
   static fromCarbonBinary(record) {
-    if (!isPlainObject(record)) {
-      throw new TypeError("Carbon effect resource record must be an object");
-    }
+    assertCarbonRecord(record, "resource");
     const resource = new this();
     resource.name = recordText(record.name);
     resource.type = record.type;
@@ -48,16 +47,16 @@ class Tr2EffectResource extends CjsModel {
     return resource;
   }
 
-  /**
-   * Emit this resource as a Carbon v15 texture or UAV record.
-   *
-   * A UAV record is one byte shorter: it carries no `isSRGB`, because Carbon's
-   * reader hardcodes it false and `Uav::Save` omits it. Emitting the field
-   * anyway would desynchronise every following field in the stage.
-   *
-   * @param {number} registerIndex Register this resource is bound at.
-   * @param {boolean} [uav] Whether to emit the UAV shape.
-   * @returns {object} Carbon texture or UAV record.
+  /**
+   * Emit this resource as a Carbon v15 texture or UAV record.
+   *
+   * A UAV record is one byte shorter: it carries no `isSRGB`, because Carbon's
+   * reader hardcodes it false and `Uav::Save` omits it. Emitting the field
+   * anyway would desynchronise every following field in the stage.
+   *
+   * @param {number} registerIndex Register this resource is bound at.
+   * @param {boolean} [uav] Whether to emit the UAV shape.
+   * @returns {object} Carbon texture or UAV record.
    */
   toCarbonBinary(registerIndex, uav = false) {
     const record = {

package/dist/resource/shader/reflection/Tr2EffectResource.js.map

@@ -1 +1 @@
-{"version":3,"file":"Tr2EffectResource.js","sources":["../../../../../src/resource/shader/reflection/Tr2EffectResource.js"],"sourcesContent":["// Source: trinity/trinity/Shader/Tr2EffectDescription.h\r\nimport { CjsSchema, impl, type } from \"#schema\";\r\nimport { CjsModel } from \"#model\";\r\nimport {\r\n  isPlainObject\r\n} from \"#utils/is\";\r\nimport { recordText, toRecordText } from \"./carbonRecordFields.js\";\r\n\r\n/** Reflected SRV or UAV resource metadata. */\r\nexport class Tr2EffectResource extends CjsModel\r\n{\r\n\r\n  /** isSRGB (bool) */\r\n  isSRGB = false;\r\n\r\n  /** isAutoregister (bool) */\r\n  isAutoregister = false;\r\n\r\n  /** name (const char*) */\r\n  name = \"\";\r\n\r\n  /** type (Type - enum Type) */\r\n  type = 0;\r\n\r\n  /** arrayElements (uint32_t) */\r\n  arrayElements = 0;\r\n\r\n  /**\r\n   * Build one SRV or UAV from its Carbon v15 description record.\r\n   *\r\n   * Both a texture record and a UAV record land here, and they are not the same\r\n   * shape: a UAV record carries no `isSRGB` at all. Carbon's reader hardcodes\r\n   * `isSRGB = false` for UAVs rather than reading a byte, and `Uav::Save` omits\r\n   * it, so the field being absent is correct rather than missing — reading\r\n   * `undefined` through `!!` reproduces Carbon exactly. The array size is spelled\r\n   * `count` in the record and `arrayElements` on the class.\r\n   *\r\n   * @param {object} record Carbon texture or UAV record.\r\n   * @returns {Tr2EffectResource} Reflected resource.\r\n   */\r\n  static fromCarbonBinary(record)\r\n  {\r\n    if (!isPlainObject(record))\r\n    {\r\n      throw new TypeError(\"Carbon effect resource record must be an object\");\r\n    }\r\n\r\n    const resource = new this();\r\n    resource.name = recordText(record.name);\r\n    resource.type = record.type;\r\n    resource.arrayElements = record.count;\r\n    resource.isSRGB = !!record.isSRGB;\r\n    resource.isAutoregister = !!record.isAutoregister;\r\n    return resource;\r\n  }\r\n\r\n  /**\r\n   * Emit this resource as a Carbon v15 texture or UAV record.\r\n   *\r\n   * A UAV record is one byte shorter: it carries no `isSRGB`, because Carbon's\r\n   * reader hardcodes it false and `Uav::Save` omits it. Emitting the field\r\n   * anyway would desynchronise every following field in the stage.\r\n   *\r\n   * @param {number} registerIndex Register this resource is bound at.\r\n   * @param {boolean} [uav] Whether to emit the UAV shape.\r\n   * @returns {object} Carbon texture or UAV record.\r\n   */\r\n  toCarbonBinary(registerIndex, uav = false)\r\n  {\r\n    const record = {\r\n      registerIndex,\r\n      name: toRecordText(this.name),\r\n      type: this.type,\r\n      count: this.arrayElements,\r\n      isAutoregister: this.isAutoregister ? 1 : 0\r\n    };\r\n    if (uav)\r\n    {\r\n      return record;\r\n    }\r\n    return {\r\n      registerIndex,\r\n      name: record.name,\r\n      type: record.type,\r\n      count: record.count,\r\n      isSRGB: this.isSRGB ? 1 : 0,\r\n      isAutoregister: record.isAutoregister\r\n    };\r\n  }\r\n\r\n  static BINDLESS_SAMPLER = 100;\r\n\r\n  static Type = Object.freeze({\r\n    TEXTURE_1D: 1,\r\n    TEXTURE_2D: 2,\r\n    TEXTURE_3D: 3,\r\n    TEXTURE_CUBE: 4,\r\n    TEXTURE_TYPELESS: 5,\r\n    BUFFER: 6,\r\n    STRUCTURED_BUFFER: 7,\r\n    TBUFFER: 8,\r\n    BYTEADDRESS_BUFFER: 9,\r\n    UAV_RWTYPED: 10,\r\n    UAV_RWSTRUCTURED: 11,\r\n    UAV_RWBYTEADDRESS: 12,\r\n    UAV_APPEND_STRUCTURED: 13,\r\n    UAV_CONSUME_STRUCTURED: 14,\r\n    UAV_RWSTRUCTURED_WITH_COUNTER: 15\r\n  });\r\n\r\n}\r\n\r\n// Declared imperatively rather than with decorators, so this module stays\r\n// plain ESM that loads from source without a transform. The decorator\r\n// expressions are reused verbatim, so the registered metadata is identical.\r\n// Statics belong in `methods`: decorateMethod targets the prototype and\r\n// would register a static as an instance field.\r\nCjsSchema.define(Tr2EffectResource, {\r\n  className: \"Tr2EffectResource\",\r\n  family: \"shader\",\r\n  fields: {\r\n    isSRGB: type.boolean,\r\n    isAutoregister: type.boolean,\r\n    name: type.string,\r\n    type: [ type.int32, type.enum(\"Type\") ],\r\n    arrayElements: type.uint32\r\n  }\r\n});\r\n"],"names":["Tr2EffectResource","CjsModel","isSRGB","isAutoregister","name","type","arrayElements","fromCarbonBinary","record","isPlainObject","TypeError","resource","recordText","count","toCarbonBinary","registerIndex","uav","toRecordText","BINDLESS_SAMPLER","Type","Object","freeze","TEXTURE_1D","TEXTURE_2D","TEXTURE_3D","TEXTURE_CUBE","TEXTURE_TYPELESS","BUFFER","STRUCTURED_BUFFER","TBUFFER","BYTEADDRESS_BUFFER","UAV_RWTYPED","UAV_RWSTRUCTURED","UAV_RWBYTEADDRESS","UAV_APPEND_STRUCTURED","UAV_CONSUME_STRUCTURED","UAV_RWSTRUCTURED_WITH_COUNTER","CjsSchema","define","className","family","fields","boolean","string","int32","enum","uint32"],"mappings":"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"}
+{"version":3,"file":"Tr2EffectResource.js","sources":["../../../../../src/resource/shader/reflection/Tr2EffectResource.js"],"sourcesContent":["// Source: trinity/trinity/Shader/Tr2EffectDescription.h\nimport { assertCarbonRecord } from \"../../format/carbonRecordGuard.js\";\nimport { CjsSchema, impl, type } from \"#schema\";\nimport { CjsModel } from \"#model\";\nimport {\n} from \"#utils/is\";\nimport { recordText, toRecordText } from \"./carbonRecordFields.js\";\n\n/** Reflected SRV or UAV resource metadata. */\nexport class Tr2EffectResource extends CjsModel\n{\n\n  /** isSRGB (bool) */\n  isSRGB = false;\n\n  /** isAutoregister (bool) */\n  isAutoregister = false;\n\n  /** name (const char*) */\n  name = \"\";\n\n  /** type (Type - enum Type) */\n  type = 0;\n\n  /** arrayElements (uint32_t) */\n  arrayElements = 0;\n\n  /**\n   * Build one SRV or UAV from its Carbon v15 description record.\n   *\n   * Both a texture record and a UAV record land here, and they are not the same\n   * shape: a UAV record carries no `isSRGB` at all. Carbon's reader hardcodes\n   * `isSRGB = false` for UAVs rather than reading a byte, and `Uav::Save` omits\n   * it, so the field being absent is correct rather than missing — reading\n   * `undefined` through `!!` reproduces Carbon exactly. The array size is spelled\n   * `count` in the record and `arrayElements` on the class.\n   *\n   * @param {object} record Carbon texture or UAV record.\n   * @returns {Tr2EffectResource} Reflected resource.\n   */\n  static fromCarbonBinary(record)\n  {\n    assertCarbonRecord(record, \"resource\");\n\n    const resource = new this();\n    resource.name = recordText(record.name);\n    resource.type = record.type;\n    resource.arrayElements = record.count;\n    resource.isSRGB = !!record.isSRGB;\n    resource.isAutoregister = !!record.isAutoregister;\n    return resource;\n  }\n\n  /**\n   * Emit this resource as a Carbon v15 texture or UAV record.\n   *\n   * A UAV record is one byte shorter: it carries no `isSRGB`, because Carbon's\n   * reader hardcodes it false and `Uav::Save` omits it. Emitting the field\n   * anyway would desynchronise every following field in the stage.\n   *\n   * @param {number} registerIndex Register this resource is bound at.\n   * @param {boolean} [uav] Whether to emit the UAV shape.\n   * @returns {object} Carbon texture or UAV record.\n   */\n  toCarbonBinary(registerIndex, uav = false)\n  {\n    const record = {\n      registerIndex,\n      name: toRecordText(this.name),\n      type: this.type,\n      count: this.arrayElements,\n      isAutoregister: this.isAutoregister ? 1 : 0\n    };\n    if (uav)\n    {\n      return record;\n    }\n    return {\n      registerIndex,\n      name: record.name,\n      type: record.type,\n      count: record.count,\n      isSRGB: this.isSRGB ? 1 : 0,\n      isAutoregister: record.isAutoregister\n    };\n  }\n\n  static BINDLESS_SAMPLER = 100;\n\n  static Type = Object.freeze({\n    TEXTURE_1D: 1,\n    TEXTURE_2D: 2,\n    TEXTURE_3D: 3,\n    TEXTURE_CUBE: 4,\n    TEXTURE_TYPELESS: 5,\n    BUFFER: 6,\n    STRUCTURED_BUFFER: 7,\n    TBUFFER: 8,\n    BYTEADDRESS_BUFFER: 9,\n    UAV_RWTYPED: 10,\n    UAV_RWSTRUCTURED: 11,\n    UAV_RWBYTEADDRESS: 12,\n    UAV_APPEND_STRUCTURED: 13,\n    UAV_CONSUME_STRUCTURED: 14,\n    UAV_RWSTRUCTURED_WITH_COUNTER: 15\n  });\n\n}\n\n// Declared imperatively rather than with decorators, so this module stays\n// plain ESM that loads from source without a transform. The decorator\n// expressions are reused verbatim, so the registered metadata is identical.\n// Statics belong in `methods`: decorateMethod targets the prototype and\n// would register a static as an instance field.\nCjsSchema.define(Tr2EffectResource, {\n  className: \"Tr2EffectResource\",\n  family: \"shader\",\n  fields: {\n    isSRGB: type.boolean,\n    isAutoregister: type.boolean,\n    name: type.string,\n    type: [ type.int32, type.enum(\"Type\") ],\n    arrayElements: type.uint32\n  }\n});\n"],"names":["Tr2EffectResource","CjsModel","isSRGB","isAutoregister","name","type","arrayElements","fromCarbonBinary","record","assertCarbonRecord","resource","recordText","count","toCarbonBinary","registerIndex","uav","toRecordText","BINDLESS_SAMPLER","Type","Object","freeze","TEXTURE_1D","TEXTURE_2D","TEXTURE_3D","TEXTURE_CUBE","TEXTURE_TYPELESS","BUFFER","STRUCTURED_BUFFER","TBUFFER","BYTEADDRESS_BUFFER","UAV_RWTYPED","UAV_RWSTRUCTURED","UAV_RWBYTEADDRESS","UAV_APPEND_STRUCTURED","UAV_CONSUME_STRUCTURED","UAV_RWSTRUCTURED_WITH_COUNTER","CjsSchema","define","className","family","fields","boolean","string","int32","enum","uint32"],"mappings":"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"}

package/dist/resource/shader/reflection/Tr2EffectStageInput.js

@@ -1,7 +1,8 @@
+import { assertCarbonRecord } from '../../format/carbonRecordGuard.js';
 import { CjsSchema, impl, type } from '#schema';
 import { CjsModel } from '#model';
 import { copyBytes } from '#utils/bytes';
-import { isPlainObject, isUint32 } from '#utils/is';
+import { isUint32 } from '#utils/is';
 import { Tr2SamplerSetup } from '../sampler/Tr2SamplerSetup.js';
 import { Tr2EffectConstant } from './Tr2EffectConstant.js';
 import { Tr2EffectParameterAnnotation } from './Tr2EffectParameterAnnotation.js';
@@ -13,11 +14,11 @@ import { requireShaderStageType } from './shaderStage.js';
 // Source: trinity/trinity/Shader/Tr2EffectDescription.h
 // Source: trinity/trinity/Shader/Tr2EffectDescription.cpp
 
-/**
- * The offset word a zero-size blob carries, or the null sentinel.
- *
- * @param {{size:number,offset:number}} ref Blob reference.
- * @returns {number} Offset word worth retaining.
+/**
+ * The offset word a zero-size blob carries, or the null sentinel.
+ *
+ * @param {{size:number,offset:number}} ref Blob reference.
+ * @returns {number} Offset word worth retaining.
  */
 function unsetOffsetOf(ref) {
   return ref.size === 0 ? ref.offset : 0xffffffff;
@@ -89,11 +90,11 @@ class Tr2EffectStageInput extends CjsModel {
   // across ten call sites, and this would replicate the same way once a second
   // engine exists.
 
-  /**
-   * The byte size a constant buffer must have to hold every declared constant.
-   *
-   * Always at least `constantValueSize`, because the authored defaults occupy
-   * the start of the same buffer.
+  /**
+   * The byte size a constant buffer must have to hold every declared constant.
+   *
+   * Always at least `constantValueSize`, because the authored defaults occupy
+   * the start of the same buffer.
    */
   GetConstantBufferSize() {
     let size = 0;
@@ -103,12 +104,12 @@ class Tr2EffectStageInput extends CjsModel {
     return Math.max(size, this.constantValueSize);
   }
 
-  /**
-   * Construct one canonical stage input from JS/JSON model values.
-   *
-   * @param {object} values Canonical model values.
-   * @param {object} options CjsModel import options.
-   * @returns {Tr2EffectStageInput} Hydrated stage input.
+  /**
+   * Construct one canonical stage input from JS/JSON model values.
+   *
+   * @param {object} values Canonical model values.
+   * @param {object} options CjsModel import options.
+   * @returns {Tr2EffectStageInput} Hydrated stage input.
    */
   static from(values = {}, options = {}) {
     let normalized = values;
@@ -129,16 +130,14 @@ class Tr2EffectStageInput extends CjsModel {
     return stage;
   }
 
-  /**
-   * Hydrate one canonical stage input from a decoded Carbon binary record.
-   *
-   * @param {object} record Decoded Carbon stage record.
-   * @returns {Tr2EffectStageInput} Hydrated canonical stage input.
+  /**
+   * Hydrate one canonical stage input from a decoded Carbon binary record.
+   *
+   * @param {object} record Decoded Carbon stage record.
+   * @returns {Tr2EffectStageInput} Hydrated canonical stage input.
    */
   static fromCarbonBinary(record) {
-    if (!isPlainObject(record)) {
-      throw new TypeError("Carbon effect stage record must be an object");
-    }
+    assertCarbonRecord(record, "stage");
     const input = this.fromCarbonBinaryInput(record, record.type);
     input.signature.pipelineInputCount = record.pipelineInputs.length;
     input.signature.pipelineInputs = record.pipelineInputs.map(entry => ({
@@ -166,27 +165,25 @@ class Tr2EffectStageInput extends CjsModel {
     return input;
   }
 
-  /**
-   * Build one stage input from a Carbon v15 `StageData` block.
-   *
-   * A raytracing library's global and local inputs are the same block without a
-   * stage wrapper — no stage type, no pipeline inputs, no thread group, no
-   * program of their own — so this is the half both callers share and
-   * `fromCarbonBinary` is the stage-only remainder layered on top.
-   *
-   * Carbon writes textures, samplers and UAVs in ascending register order because
-   * they are `std::map`s, and they are re-keyed by register here rather than by
-   * position, so the map is authoritative and the record's order is not load
-   * bearing.
-   *
-   * @param {object} record Carbon stage-data record.
-   * @param {number} [stageType] Stage index, or -1 for a library input.
-   * @returns {Tr2EffectStageInput} Reflected stage input.
+  /**
+   * Build one stage input from a Carbon v15 `StageData` block.
+   *
+   * A raytracing library's global and local inputs are the same block without a
+   * stage wrapper — no stage type, no pipeline inputs, no thread group, no
+   * program of their own — so this is the half both callers share and
+   * `fromCarbonBinary` is the stage-only remainder layered on top.
+   *
+   * Carbon writes textures, samplers and UAVs in ascending register order because
+   * they are `std::map`s, and they are re-keyed by register here rather than by
+   * position, so the map is authoritative and the record's order is not load
+   * bearing.
+   *
+   * @param {object} record Carbon stage-data record.
+   * @param {number} [stageType] Stage index, or -1 for a library input.
+   * @returns {Tr2EffectStageInput} Reflected stage input.
    */
   static fromCarbonBinaryInput(record, stageType = -1) {
-    if (!isPlainObject(record)) {
-      throw new TypeError("Carbon effect stage-data record must be an object");
-    }
+    assertCarbonRecord(record, "stage-data");
     const constantValues = copyBytes(recordBytes(record.defaultValues));
     const input = new this();
     input.stageType = stageType;
@@ -261,10 +258,10 @@ class Tr2EffectStageInput extends CjsModel {
     return input;
   }
 
-  /**
-   * Emit this stage as a Carbon v15 stage record.
-   *
-   * @returns {object} Carbon stage record.
+  /**
+   * Emit this stage as a Carbon v15 stage record.
+   *
+   * @returns {object} Carbon stage record.
    */
   toCarbonBinary() {
     const signature = this.signature ?? {};
@@ -285,17 +282,17 @@ class Tr2EffectStageInput extends CjsModel {
     };
   }
 
-  /**
-   * Emit this input as a Carbon v15 `StageData` block.
-   *
-   * Carbon holds textures, samplers, UAVs and render states in `std::map`s and
-   * writes them in key order, and it sorts annotation names by `strcmp` before
-   * writing. Our maps are keyed but not ordered, so every collection is sorted
-   * explicitly here rather than trusting insertion order — the reader is
-   * indifferent, but the bytes are not, and a container that disagrees with
-   * Carbon's ordering is not the file Carbon would have written.
-   *
-   * @returns {object} Carbon stage-data record.
+  /**
+   * Emit this input as a Carbon v15 `StageData` block.
+   *
+   * Carbon holds textures, samplers, UAVs and render states in `std::map`s and
+   * writes them in key order, and it sorts annotation names by `strcmp` before
+   * writing. Our maps are keyed but not ordered, so every collection is sorted
+   * explicitly here rather than trusting insertion order — the reader is
+   * indifferent, but the bytes are not, and a container that disagrees with
+   * Carbon's ordering is not the file Carbon would have written.
+   *
+   * @returns {object} Carbon stage-data record.
    */
   toCarbonBinaryInput() {
     const byRegister = (left, right) => left.registerIndex - right.registerIndex;
@@ -361,11 +358,11 @@ class Tr2EffectStageInput extends CjsModel {
     return result;
   }
 
-  /**
-   * Create one explicit absent stage slot.
-   *
-   * @param {number} stageType Stage index.
-   * @returns {Tr2EffectStageInput} Empty stage input.
+  /**
+   * Create one explicit absent stage slot.
+   *
+   * @param {number} stageType Stage index.
+   * @returns {Tr2EffectStageInput} Empty stage input.
    */
   static createEmpty(stageType) {
     const stage = new this();
@@ -373,14 +370,14 @@ class Tr2EffectStageInput extends CjsModel {
     return stage;
   }
 
-  /**
-   * Normalize one register-indexed collection into its canonical typed map.
-   *
-   * @param {Map|object} values Register-indexed source values.
-   * @param {Function} Constructor Entry constructor exposing `from`.
-   * @param {object} options Hydration options passed to entry construction.
-   * @param {string} field Diagnostic field name.
-   * @returns {Map<number, *>} Canonical register map.
+  /**
+   * Normalize one register-indexed collection into its canonical typed map.
+   *
+   * @param {Map|object} values Register-indexed source values.
+   * @param {Function} Constructor Entry constructor exposing `from`.
+   * @param {object} options Hydration options passed to entry construction.
+   * @param {string} field Diagnostic field name.
+   * @returns {Map<number, *>} Canonical register map.
    */
   static readCanonicalRegisterMap(values, Constructor, options, field) {
     const entries = values instanceof Map ? values : Object.entries(values ?? {});