@carbonenginejs/runtime-resource 0.12.1 → 0.13.0

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

@@ -1,109 +1,114 @@
-import { CjsSchema, type } from '@carbonenginejs/runtime-utils/schema';
-import { CjsModel } from '@carbonenginejs/runtime-utils/model';
-import { isPlainObject, isArray } from '@carbonenginejs/runtime-utils/is';
-import { Tr2EffectParameterAnnotation } from './Tr2EffectParameterAnnotation.js';
-import { Tr2EffectTechnique } from './Tr2EffectTechnique.js';
-
-// Source: trinity/trinity/Shader/Tr2EffectDescription.h
-// Source: trinity/trinity/Shader/Tr2EffectDescription.cpp
-
-/** Complete device-free effect description for one selected shader body. */
-class Tr2EffectDescription extends CjsModel {
-  /** techniques (TrackableStdVector<Tr2EffectTechnique>) */
-  techniques = [];
-
-  /** annotations (Tr2EffectAnnotationMap) */
-  annotations = new Map();
-
-  /**
-   * Construct a canonical effect description from JS/JSON model values.
-   *
-   * @param {object} values Canonical model values.
-   * @param {object} options CjsModel import options.
-   * @returns {Tr2EffectDescription} Hydrated description.
-   */
-  static from(values = {}, options = {}) {
-    let normalized = values;
-    let annotations = null;
-    if (values && Object.hasOwn(values, "annotations")) {
-      const entries = values.annotations instanceof Map ? values.annotations : Object.entries(values.annotations ?? {});
-      annotations = new Map();
-      for (const [parameterName, records] of entries) {
-        if (!Array.isArray(records)) {
-          throw new TypeError(`Effect annotations for "${parameterName}" must be an array`);
-        }
-        annotations.set(String(parameterName), records.map(record => record instanceof Tr2EffectParameterAnnotation ? record : Tr2EffectParameterAnnotation.from(record, options)));
-      }
-      normalized = {
-        ...values,
-        annotations
-      };
-    }
-    const effect = super.from(normalized, options);
-    if (annotations) {
-      effect.annotations = annotations;
-    }
-    return effect;
-  }
-
-  /**
-   * Build one complete effect description from its portable JSON record.
-   *
-   * @param {object} value Portable effect-description record.
-   * @returns {Tr2EffectDescription} Reflected description.
-   */
-  static fromPortable(value) {
-    if (!isPlainObject(value)) {
-      throw new TypeError("Portable effect description must be an object");
-    }
-    if (!isArray(value.annotations)) {
-      throw new TypeError("Portable effect annotation groups must be an array");
-    }
-    if (!isArray(value.techniques)) {
-      throw new TypeError("Portable effect techniques must be an array");
-    }
-    if (value.annotationGroupCount !== value.annotations.length || value.techniqueCount !== value.techniques.length) {
-      throw new Error("Portable effect description counts disagree with its collections");
-    }
-    const effect = new this();
-    effect.annotations = this.readPortableAnnotationGroups(value.annotations);
-    effect.techniques = value.techniques.map(entry => Tr2EffectTechnique.fromPortable(entry));
-    return effect;
-  }
-
-  /** Build parameter-name-indexed annotation groups. */
-  static readPortableAnnotationGroups(values) {
-    const result = new Map();
-    for (const value of values) {
-      if (!isPlainObject(value)) {
-        throw new TypeError("Portable effect annotation group must be an object");
-      }
-      const parameterName = String(value.parameterName ?? "");
-      if (!isArray(value.annotations)) {
-        throw new TypeError(`Portable annotations for parameter "${parameterName}" must be an array`);
-      }
-      if (result.has(parameterName)) {
-        throw new Error(`Portable effect annotation group "${parameterName}" is duplicated`);
-      }
-      result.set(parameterName, value.annotations.map(entry => Tr2EffectParameterAnnotation.fromPortable(entry)));
-    }
-    return result;
-  }
-}
-
-// Declared imperatively rather than with decorators, so this module stays
-// plain ESM that loads from source without a transform. The decorator
-// expressions are reused verbatim, so the registered metadata is identical.
-// Statics belong in `methods`: decorateMethod targets the prototype and
-// would register a static as an instance field.
-CjsSchema.define(Tr2EffectDescription, {
-  className: "Tr2EffectDescription",
-  family: "shader",
-  fields: {
-    techniques: type.list("Tr2EffectTechnique"),
-    annotations: type.map("Tr2EffectParameterAnnotationMap")
-  }
-});
-
-export { Tr2EffectDescription };
-//# sourceMappingURL=Tr2EffectDescription.js.map
+import { CjsSchema, type } from '@carbonenginejs/runtime-utils/schema';
+import { CjsModel } from '@carbonenginejs/runtime-utils/model';
+import { isPlainObject } from '@carbonenginejs/runtime-utils/is';
+import { Tr2EffectParameterAnnotation } from './Tr2EffectParameterAnnotation.js';
+import { Tr2EffectTechnique } from './Tr2EffectTechnique.js';
+import { recordText, toRecordText } from './carbonRecordFields.js';
+import { compareUtf8 } from '../../../format/compareUtf8.js';
+
+// Source: trinity/trinity/Shader/Tr2EffectDescription.h
+// Source: trinity/trinity/Shader/Tr2EffectDescription.cpp
+
+/** Complete device-free effect description for one selected shader body. */
+class Tr2EffectDescription extends CjsModel {
+  /** techniques (TrackableStdVector<Tr2EffectTechnique>) */
+  techniques = [];
+
+  /** annotations (Tr2EffectAnnotationMap) */
+  annotations = new Map();
+
+  /**
+   * Construct a canonical effect description from JS/JSON model values.
+   *
+   * @param {object} values Canonical model values.
+   * @param {object} options CjsModel import options.
+   * @returns {Tr2EffectDescription} Hydrated description.
+   */
+  static from(values = {}, options = {}) {
+    let normalized = values;
+    let annotations = null;
+    if (values && Object.hasOwn(values, "annotations")) {
+      const entries = values.annotations instanceof Map ? values.annotations : Object.entries(values.annotations ?? {});
+      annotations = new Map();
+      for (const [parameterName, records] of entries) {
+        if (!Array.isArray(records)) {
+          throw new TypeError(`Effect annotations for "${parameterName}" must be an array`);
+        }
+        annotations.set(String(parameterName), records.map(record => record instanceof Tr2EffectParameterAnnotation ? record : Tr2EffectParameterAnnotation.from(record, options)));
+      }
+      normalized = {
+        ...values,
+        annotations
+      };
+    }
+    const effect = super.from(normalized, options);
+    if (annotations) {
+      effect.annotations = annotations;
+    }
+    return effect;
+  }
+
+  /**
+   * Build one complete effect description from its Carbon v15 record tree.
+   *
+   * This is the whole body: every technique, and the effect-level annotation
+   * groups keyed by the parameter they annotate. Carbon sorts those keys by
+   * `strcmp` on the way out, and the map preserves whatever order the file used,
+   * so nothing here depends on the ordering being meaningful.
+   *
+   * @param {object} record Carbon effect description record.
+   * @returns {Tr2EffectDescription} Reflected description.
+   */
+  static fromCarbonBinary(record) {
+    if (!isPlainObject(record)) {
+      throw new TypeError("Carbon effect description record must be an object");
+    }
+    const effect = new this();
+    effect.annotations = new Map();
+    for (const group of record.annotations) {
+      const parameterName = recordText(group.name);
+      if (effect.annotations.has(parameterName)) {
+        throw new Error(`Carbon effect annotation group "${parameterName}" is duplicated`);
+      }
+      effect.annotations.set(parameterName, group.annotations.map(entry => Tr2EffectParameterAnnotation.fromCarbonBinary(entry)));
+    }
+    effect.techniques = record.techniques.map(entry => Tr2EffectTechnique.fromCarbonBinary(entry));
+    return effect;
+  }
+
+  /**
+   * Emit this description as a Carbon v15 record tree.
+   *
+   * Effect-level annotation groups are sorted by parameter name, and each
+   * group's annotations by their own name, because Carbon sorts both by `strcmp`
+   * before writing.
+   *
+   * @returns {object} Carbon effect description record.
+   */
+  toCarbonBinary() {
+    return {
+      techniques: this.techniques.map(technique => technique.toCarbonBinary()),
+      annotations: Array.from(this.annotations, ([name, annotations]) => ({
+        name: toRecordText(name),
+        annotations: annotations.map(entry => entry.toCarbonBinary()).sort((left, right) => compareUtf8(left.name.value, right.name.value))
+      })).sort((left, right) => compareUtf8(left.name.value, right.name.value))
+    };
+  }
+}
+
+// Declared imperatively rather than with decorators, so this module stays
+// plain ESM that loads from source without a transform. The decorator
+// expressions are reused verbatim, so the registered metadata is identical.
+// Statics belong in `methods`: decorateMethod targets the prototype and
+// would register a static as an instance field.
+CjsSchema.define(Tr2EffectDescription, {
+  className: "Tr2EffectDescription",
+  family: "shader",
+  fields: {
+    techniques: type.list("Tr2EffectTechnique"),
+    annotations: type.map("Tr2EffectParameterAnnotationMap")
+  }
+});
+
+export { Tr2EffectDescription };
+//# sourceMappingURL=Tr2EffectDescription.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"Tr2EffectDescription.js","sources":["../../../../../src/resource/shader/reflection/Tr2EffectDescription.js"],"sourcesContent":["// Source: trinity/trinity/Shader/Tr2EffectDescription.h\n// Source: trinity/trinity/Shader/Tr2EffectDescription.cpp\nimport { CjsSchema, impl, type } from \"@carbonenginejs/runtime-utils/schema\";\nimport { CjsModel } from \"@carbonenginejs/runtime-utils/model\";\nimport {\n  isArray,\n  isPlainObject\n} from \"@carbonenginejs/runtime-utils/is\";\nimport { Tr2EffectParameterAnnotation } from \"./Tr2EffectParameterAnnotation.js\";\nimport { Tr2EffectTechnique } from \"./Tr2EffectTechnique.js\";\n\n/** Complete device-free effect description for one selected shader body. */\nexport class Tr2EffectDescription extends CjsModel\n{\n\n  /** techniques (TrackableStdVector<Tr2EffectTechnique>) */\n  techniques = [];\n\n  /** annotations (Tr2EffectAnnotationMap) */\n  annotations = new Map();\n\n  /**\n   * Construct a canonical effect description from JS/JSON model values.\n   *\n   * @param {object} values Canonical model values.\n   * @param {object} options CjsModel import options.\n   * @returns {Tr2EffectDescription} Hydrated description.\n   */\n  static from(values = {}, options = {})\n  {\n    let normalized = values;\n    let annotations = null;\n    if (values && Object.hasOwn(values, \"annotations\"))\n    {\n      const entries = values.annotations instanceof Map\n        ? values.annotations\n        : Object.entries(values.annotations ?? {});\n      annotations = new Map();\n      for (const [ parameterName, records ] of entries)\n      {\n        if (!Array.isArray(records))\n        {\n          throw new TypeError(\n            `Effect annotations for \"${parameterName}\" must be an array`\n          );\n        }\n        annotations.set(\n          String(parameterName),\n          records.map(record => record instanceof Tr2EffectParameterAnnotation\n            ? record\n            : Tr2EffectParameterAnnotation.from(record, options))\n        );\n      }\n      normalized = { ...values, annotations };\n    }\n    const effect = super.from(normalized, options);\n    if (annotations)\n    {\n      effect.annotations = annotations;\n    }\n    return effect;\n  }\n\n  /**\n   * Build one complete effect description from its portable JSON record.\n   *\n   * @param {object} value Portable effect-description record.\n   * @returns {Tr2EffectDescription} Reflected description.\n   */\n  static fromPortable(value)\n  {\n    if (!isPlainObject(value))\n    {\n      throw new TypeError(\"Portable effect description must be an object\");\n    }\n    if (!isArray(value.annotations))\n    {\n      throw new TypeError(\n        \"Portable effect annotation groups must be an array\"\n      );\n    }\n    if (!isArray(value.techniques))\n    {\n      throw new TypeError(\"Portable effect techniques must be an array\");\n    }\n    if (value.annotationGroupCount !== value.annotations.length\n      || value.techniqueCount !== value.techniques.length)\n    {\n      throw new Error(\n        \"Portable effect description counts disagree with its collections\"\n      );\n    }\n\n    const effect = new this();\n    effect.annotations = this.readPortableAnnotationGroups(\n      value.annotations\n    );\n    effect.techniques = value.techniques.map(\n      entry => Tr2EffectTechnique.fromPortable(entry)\n    );\n    return effect;\n  }\n\n  /** Build parameter-name-indexed annotation groups. */\n  static readPortableAnnotationGroups(values)\n  {\n    const result = new Map();\n    for (const value of values)\n    {\n      if (!isPlainObject(value))\n      {\n        throw new TypeError(\n          \"Portable effect annotation group must be an object\"\n        );\n      }\n      const parameterName = String(value.parameterName ?? \"\");\n      if (!isArray(value.annotations))\n      {\n        throw new TypeError(\n          `Portable annotations for parameter \"${parameterName}\" must be an array`\n        );\n      }\n      if (result.has(parameterName))\n      {\n        throw new Error(\n          `Portable effect annotation group \"${parameterName}\" is duplicated`\n        );\n      }\n      result.set(\n        parameterName,\n        value.annotations.map(\n          entry => Tr2EffectParameterAnnotation.fromPortable(entry)\n        )\n      );\n    }\n    return result;\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(Tr2EffectDescription, {\n  className: \"Tr2EffectDescription\",\n  family: \"shader\",\n  fields: {\n    techniques: type.list(\"Tr2EffectTechnique\"),\n    annotations: type.map(\"Tr2EffectParameterAnnotationMap\")\n  }\n});\n"],"names":["Tr2EffectDescription","CjsModel","techniques","annotations","Map","from","values","options","normalized","Object","hasOwn","entries","parameterName","records","Array","isArray","TypeError","set","String","map","record","Tr2EffectParameterAnnotation","effect","fromPortable","value","isPlainObject","annotationGroupCount","length","techniqueCount","Error","readPortableAnnotationGroups","entry","Tr2EffectTechnique","result","has","CjsSchema","define","className","family","fields","type","list"],"mappings":"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"}
+{"version":3,"file":"Tr2EffectDescription.js","sources":["../../../../../src/resource/shader/reflection/Tr2EffectDescription.js"],"sourcesContent":["// Source: trinity/trinity/Shader/Tr2EffectDescription.h\n// Source: trinity/trinity/Shader/Tr2EffectDescription.cpp\nimport { CjsSchema, impl, type } from \"@carbonenginejs/runtime-utils/schema\";\nimport { CjsModel } from \"@carbonenginejs/runtime-utils/model\";\nimport { isPlainObject } from \"@carbonenginejs/runtime-utils/is\";\nimport { Tr2EffectParameterAnnotation } from \"./Tr2EffectParameterAnnotation.js\";\nimport { Tr2EffectTechnique } from \"./Tr2EffectTechnique.js\";\nimport { recordText, toRecordText } from \"./carbonRecordFields.js\";\nimport { compareUtf8 } from \"../../../format/compareUtf8.js\";\n\n/** Complete device-free effect description for one selected shader body. */\nexport class Tr2EffectDescription extends CjsModel\n{\n\n  /** techniques (TrackableStdVector<Tr2EffectTechnique>) */\n  techniques = [];\n\n  /** annotations (Tr2EffectAnnotationMap) */\n  annotations = new Map();\n\n  /**\n   * Construct a canonical effect description from JS/JSON model values.\n   *\n   * @param {object} values Canonical model values.\n   * @param {object} options CjsModel import options.\n   * @returns {Tr2EffectDescription} Hydrated description.\n   */\n  static from(values = {}, options = {})\n  {\n    let normalized = values;\n    let annotations = null;\n    if (values && Object.hasOwn(values, \"annotations\"))\n    {\n      const entries = values.annotations instanceof Map\n        ? values.annotations\n        : Object.entries(values.annotations ?? {});\n      annotations = new Map();\n      for (const [ parameterName, records ] of entries)\n      {\n        if (!Array.isArray(records))\n        {\n          throw new TypeError(\n            `Effect annotations for \"${parameterName}\" must be an array`\n          );\n        }\n        annotations.set(\n          String(parameterName),\n          records.map(record => record instanceof Tr2EffectParameterAnnotation\n            ? record\n            : Tr2EffectParameterAnnotation.from(record, options))\n        );\n      }\n      normalized = { ...values, annotations };\n    }\n    const effect = super.from(normalized, options);\n    if (annotations)\n    {\n      effect.annotations = annotations;\n    }\n    return effect;\n  }\n\n  /**\n   * Build one complete effect description from its Carbon v15 record tree.\n   *\n   * This is the whole body: every technique, and the effect-level annotation\n   * groups keyed by the parameter they annotate. Carbon sorts those keys by\n   * `strcmp` on the way out, and the map preserves whatever order the file used,\n   * so nothing here depends on the ordering being meaningful.\n   *\n   * @param {object} record Carbon effect description record.\n   * @returns {Tr2EffectDescription} Reflected description.\n   */\n  static fromCarbonBinary(record)\n  {\n    if (!isPlainObject(record))\n    {\n      throw new TypeError(\"Carbon effect description record must be an object\");\n    }\n\n    const effect = new this();\n    effect.annotations = new Map();\n    for (const group of record.annotations)\n    {\n      const parameterName = recordText(group.name);\n      if (effect.annotations.has(parameterName))\n      {\n        throw new Error(\n          `Carbon effect annotation group \"${parameterName}\" is duplicated`\n        );\n      }\n      effect.annotations.set(\n        parameterName,\n        group.annotations.map(\n          entry => Tr2EffectParameterAnnotation.fromCarbonBinary(entry)\n        )\n      );\n    }\n    effect.techniques = record.techniques.map(\n      entry => Tr2EffectTechnique.fromCarbonBinary(entry)\n    );\n    return effect;\n  }\n\n\n  /**\n   * Emit this description as a Carbon v15 record tree.\n   *\n   * Effect-level annotation groups are sorted by parameter name, and each\n   * group's annotations by their own name, because Carbon sorts both by `strcmp`\n   * before writing.\n   *\n   * @returns {object} Carbon effect description record.\n   */\n  toCarbonBinary()\n  {\n    return {\n      techniques: this.techniques.map(technique => technique.toCarbonBinary()),\n      annotations: Array.from(this.annotations, ([ name, annotations ]) => ({\n        name: toRecordText(name),\n        annotations: annotations\n          .map(entry => entry.toCarbonBinary())\n          .sort((left, right) => compareUtf8(left.name.value, right.name.value))\n      })).sort((left, right) => compareUtf8(left.name.value, right.name.value))\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(Tr2EffectDescription, {\n  className: \"Tr2EffectDescription\",\n  family: \"shader\",\n  fields: {\n    techniques: type.list(\"Tr2EffectTechnique\"),\n    annotations: type.map(\"Tr2EffectParameterAnnotationMap\")\n  }\n});\n"],"names":["Tr2EffectDescription","CjsModel","techniques","annotations","Map","from","values","options","normalized","Object","hasOwn","entries","parameterName","records","Array","isArray","TypeError","set","String","map","record","Tr2EffectParameterAnnotation","effect","fromCarbonBinary","isPlainObject","group","recordText","name","has","Error","entry","Tr2EffectTechnique","toCarbonBinary","technique","toRecordText","sort","left","right","compareUtf8","value","CjsSchema","define","className","family","fields","type","list"],"mappings":"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"}

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

@@ -1,147 +1,168 @@
-import { CjsSchema, impl, type } from '@carbonenginejs/runtime-utils/schema';
-import { CjsModel } from '@carbonenginejs/runtime-utils/model';
-import { isPlainObject, isArray, isUint32 } from '@carbonenginejs/runtime-utils/is';
-import { clonePortableSourceProgram } from '../portable.js';
-import { Tr2EffectStageInput } from './Tr2EffectStageInput.js';
-
-// Source: trinity/trinity/Shader/Tr2EffectDescription.h
-
-/** Reflected shader-library metadata. */
-class Tr2EffectLibrary extends CjsModel {
-  /** payloadSize (uint32_t) */
-  payloadSize = 0;
-
-  /** libraryHandle (uint32_t) */
-  libraryHandle = 0;
-
-  /** rayGenName (BlueSharedStringW) */
-  rayGenName = "";
-
-  /** missName (BlueSharedStringW) */
-  missName = "";
-
-  /** closestHitName (BlueSharedStringW) */
-  closestHitName = "";
-
-  /** anyHitName (BlueSharedStringW) */
-  anyHitName = "";
-
-  /** intersectionName (BlueSharedStringW) */
-  intersectionName = "";
-
-  /** hitGroupName (BlueSharedStringW) */
-  hitGroupName = "";
-
-  /** globalInput (Tr2EffectStageInput) */
-  globalInput = null;
-
-  /** localInput (Tr2EffectStageInput) */
-  localInput = null;
-
-  /** globalResourceSetDesc (Tr2ResourceSetDescriptionAL) */
-  globalResourceSetDesc = null;
-
-  /** Exact source library program metadata and owned bytes. */
-  sourceProgram = null;
-
-  /** 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.
-   */
-  static from(values = {}, options = {}) {
-    let normalized = values;
-    const inputs = new Map();
-    for (const field of ["globalInput", "localInput"]) {
-      if (values?.[field] && !(values[field] instanceof Tr2EffectStageInput)) {
-        normalized = normalized === values ? {
-          ...values
-        } : normalized;
-        normalized[field] = Tr2EffectStageInput.from(values[field], options);
-        inputs.set(field, normalized[field]);
-      }
-    }
-    const library = super.from(normalized, options);
-    for (const [field, value] of inputs) {
-      library[field] = value;
-    }
-    return library;
-  }
-
-  /**
-   * Build one shader library from its portable JSON reflection record.
-   *
-   * @param {object} value Portable library record.
-   * @returns {Tr2EffectLibrary} Reflected library.
-   */
-  static fromPortable(value) {
-    if (!isPlainObject(value)) {
-      throw new TypeError("Portable effect library must be an object");
-    }
-    if (!isArray(value.exports)) {
-      throw new TypeError("Portable effect library exports must be an array");
-    }
-    if (value.exportCount !== value.exports.length) {
-      throw new Error("Portable effect library export count disagrees with its collection");
-    }
-    const library = new this();
-    if (!isUint32(value.payloadSize)) {
-      throw new RangeError("Portable effect library payload size must fit uint32");
-    }
-    library.payloadSize = value.payloadSize;
-    library.hitGroupName = String(value.hitGroupName ?? "");
-    library.exports = value.exports.map(entry => {
-      if (!isUint32(entry?.type)) {
-        throw new RangeError("Portable effect library export type must fit uint32");
-      }
-      return {
-        type: entry.type,
-        name: String(entry?.name ?? "")
-      };
-    });
-    for (const entry of library.exports) {
-      if (entry.type === 0) library.rayGenName = entry.name;
-      if (entry.type === 1) library.missName = entry.name;
-      if (entry.type === 2) library.closestHitName = entry.name;
-      if (entry.type === 3) library.anyHitName = entry.name;
-      if (entry.type === 4) library.intersectionName = entry.name;
-    }
-    library.sourceProgram = clonePortableSourceProgram(value.sourceProgram, "library");
-    library.globalInput = Tr2EffectStageInput.fromPortableInput(value.globalInput);
-    library.localInput = Tr2EffectStageInput.fromPortableInput(value.localInput);
-    return library;
-  }
-}
-
-// Declared imperatively rather than with decorators, so this module stays
-// plain ESM that loads from source without a transform. The decorator
-// expressions are reused verbatim, so the registered metadata is identical.
-// Statics belong in `methods`: decorateMethod targets the prototype and
-// would register a static as an instance field.
-CjsSchema.define(Tr2EffectLibrary, {
-  className: "Tr2EffectLibrary",
-  family: "shader",
-  fields: {
-    payloadSize: type.uint32,
-    libraryHandle: type.uint32,
-    rayGenName: type.string,
-    missName: type.string,
-    closestHitName: type.string,
-    anyHitName: type.string,
-    intersectionName: type.string,
-    hitGroupName: type.string,
-    globalInput: type.rawStruct("Tr2EffectStageInput"),
-    localInput: type.rawStruct("Tr2EffectStageInput"),
-    globalResourceSetDesc: type.rawStruct("Tr2ResourceSetDescriptionAL"),
-    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")],
-    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")]
-  }
-});
-
-export { Tr2EffectLibrary };
-//# sourceMappingURL=Tr2EffectLibrary.js.map
+import { CjsSchema, impl, type } from '@carbonenginejs/runtime-utils/schema';
+import { CjsModel } from '@carbonenginejs/runtime-utils/model';
+import { isPlainObject } from '@carbonenginejs/runtime-utils/is';
+import { copyBytes } from '@carbonenginejs/runtime-utils/bytes';
+import { Tr2EffectStageInput } from './Tr2EffectStageInput.js';
+import { recordText, recordBytes, toRecordText, toRecordBlob } from './carbonRecordFields.js';
+
+// Source: trinity/trinity/Shader/Tr2EffectDescription.h
+
+/** Reflected shader-library metadata. */
+class Tr2EffectLibrary extends CjsModel {
+  /** payloadSize (uint32_t) */
+  payloadSize = 0;
+
+  /** libraryHandle (uint32_t) */
+  libraryHandle = 0;
+
+  /** rayGenName (BlueSharedStringW) */
+  rayGenName = "";
+
+  /** missName (BlueSharedStringW) */
+  missName = "";
+
+  /** closestHitName (BlueSharedStringW) */
+  closestHitName = "";
+
+  /** anyHitName (BlueSharedStringW) */
+  anyHitName = "";
+
+  /** intersectionName (BlueSharedStringW) */
+  intersectionName = "";
+
+  /** hitGroupName (BlueSharedStringW) */
+  hitGroupName = "";
+
+  /** globalInput (Tr2EffectStageInput) */
+  globalInput = null;
+
+  /** localInput (Tr2EffectStageInput) */
+  localInput = null;
+
+  /** globalResourceSetDesc (Tr2ResourceSetDescriptionAL) */
+  globalResourceSetDesc = null;
+
+  /** Exact source library program metadata and owned bytes. */
+  sourceProgram = null;
+
+  /** 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.
+   */
+  static from(values = {}, options = {}) {
+    let normalized = values;
+    const inputs = new Map();
+    for (const field of ["globalInput", "localInput"]) {
+      if (values?.[field] && !(values[field] instanceof Tr2EffectStageInput)) {
+        normalized = normalized === values ? {
+          ...values
+        } : normalized;
+        normalized[field] = Tr2EffectStageInput.from(values[field], options);
+        inputs.set(field, normalized[field]);
+      }
+    }
+    const library = super.from(normalized, options);
+    for (const [field, value] of inputs) {
+      library[field] = value;
+    }
+    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.
+   */
+  static fromCarbonBinary(record) {
+    if (!isPlainObject(record)) {
+      throw new TypeError("Carbon effect library record must be an object");
+    }
+    const library = new this();
+    library.payloadSize = record.payloadSize;
+    library.hitGroupName = recordText(record.hitGroupName);
+    library.exports = record.exports.map(entry => ({
+      type: entry.type,
+      name: recordText(entry.name)
+    }));
+    // The export type is the only thing that names an entry point; the record
+    // stores a flat list and the named fields are a view onto it.
+    for (const entry of library.exports) {
+      if (entry.type === 0) library.rayGenName = entry.name;
+      if (entry.type === 1) library.missName = entry.name;
+      if (entry.type === 2) library.closestHitName = entry.name;
+      if (entry.type === 3) library.anyHitName = entry.name;
+      if (entry.type === 4) library.intersectionName = entry.name;
+    }
+    library.sourceProgram = {
+      kind: "library",
+      bytes: copyBytes(recordBytes(record.shaderData)),
+      shaderSize: record.shaderData.size,
+      // See Tr2EffectStageInput: only a zero-size blob's word is portable.
+      unsetOffset: record.shaderData.size === 0 ? record.shaderData.offset : 0xffffffff
+    };
+    library.globalInput = Tr2EffectStageInput.fromCarbonBinaryInput(record.globalInputs);
+    library.localInput = Tr2EffectStageInput.fromCarbonBinaryInput(record.localInputs);
+    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.
+   */
+  toCarbonBinary() {
+    const program = this.sourceProgram ?? {};
+    return {
+      payloadSize: this.payloadSize >>> 0,
+      shaderData: toRecordBlob(program.bytes, program.shaderSize, program.unsetOffset),
+      exports: this.exports.map(entry => ({
+        type: entry.type,
+        name: toRecordText(entry.name)
+      })),
+      hitGroupName: toRecordText(this.hitGroupName),
+      globalInputs: this.globalInput.toCarbonBinaryInput(),
+      localInputs: this.localInput.toCarbonBinaryInput()
+    };
+  }
+}
+
+// Declared imperatively rather than with decorators, so this module stays
+// plain ESM that loads from source without a transform. The decorator
+// expressions are reused verbatim, so the registered metadata is identical.
+// Statics belong in `methods`: decorateMethod targets the prototype and
+// would register a static as an instance field.
+CjsSchema.define(Tr2EffectLibrary, {
+  className: "Tr2EffectLibrary",
+  family: "shader",
+  fields: {
+    payloadSize: type.uint32,
+    libraryHandle: type.uint32,
+    rayGenName: type.string,
+    missName: type.string,
+    closestHitName: type.string,
+    anyHitName: type.string,
+    intersectionName: type.string,
+    hitGroupName: type.string,
+    globalInput: type.rawStruct("Tr2EffectStageInput"),
+    localInput: type.rawStruct("Tr2EffectStageInput"),
+    globalResourceSetDesc: type.rawStruct("Tr2ResourceSetDescriptionAL"),
+    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")],
+    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")]
+  }
+});
+
+export { Tr2EffectLibrary };
+//# sourceMappingURL=Tr2EffectLibrary.js.map