@carbonenginejs/runtime-resource 0.13.0 → 0.14.0

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

@@ -1,168 +1,168 @@
-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
+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

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

@@ -1,125 +1,125 @@
-import { CjsSchema, type, impl, schema } from '@carbonenginejs/runtime-utils/schema';
-import { CjsModel } from '@carbonenginejs/runtime-utils/model';
-import { dwordToFloat } from '@carbonenginejs/runtime-utils/math/num';
-import { isPlainObject } from '@carbonenginejs/runtime-utils/is';
-import { recordText, recordRawValue, toRecordText, toRecordRawValue } from './carbonRecordFields.js';
-
-// Source: trinity/trinity/Shader/Tr2EffectDescription.h
-
-/** Typed annotation attached to a reflected effect parameter. */
-class Tr2EffectParameterAnnotation extends CjsModel {
-  /** name (const char*) */
-  name = "";
-
-  /** type (Type - enum Type) */
-  type = 0;
-
-  /** boolValue (bool) */
-  boolValue = false;
-
-  /** Exact serialized BOOL, INT, or FLOAT payload bits. */
-  rawValue = 0;
-
-  /** intValue (int) */
-  intValue = 0;
-
-  /** floatValue (float) */
-  floatValue = 0;
-
-  /** 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.
-   */
-  static fromCarbonBinary(record) {
-    if (!isPlainObject(record)) {
-      throw new TypeError("Carbon effect annotation record must be an object");
-    }
-    const annotation = new this();
-    annotation.name = recordText(record.name);
-    annotation.type = record.type;
-    switch (annotation.type) {
-      case this.Type.BOOL:
-        annotation.rawValue = recordRawValue(record.rawValue);
-        annotation.boolValue = annotation.rawValue !== 0;
-        break;
-      case this.Type.INT:
-        annotation.rawValue = recordRawValue(record.rawValue);
-        annotation.intValue = annotation.rawValue | 0;
-        break;
-      case this.Type.FLOAT:
-        annotation.rawValue = recordRawValue(record.rawValue);
-        annotation.floatValue = dwordToFloat(annotation.rawValue);
-        break;
-      case this.Type.STRING:
-        annotation.stringValue = recordText(record.stringValue);
-        break;
-      default:
-        throw new Error(`Carbon effect annotation type ${annotation.type} is unsupported`);
-    }
-    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.
-   */
-  toCarbonBinary() {
-    if (this.type === Tr2EffectParameterAnnotation.Type.STRING) {
-      return {
-        name: toRecordText(this.name),
-        type: this.type,
-        stringValue: toRecordText(this.stringValue),
-        rawValue: null
-      };
-    }
-    return {
-      name: toRecordText(this.name),
-      type: this.type,
-      stringValue: null,
-      rawValue: toRecordRawValue(this.rawValue)
-    };
-  }
-  static Type = Object.freeze({
-    BOOL: 0,
-    INT: 1,
-    FLOAT: 2,
-    STRING: 3
-  });
-}
-
-// 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(Tr2EffectParameterAnnotation, {
-  className: "Tr2EffectParameterAnnotation",
-  family: "shader",
-  fields: {
-    name: type.string,
-    type: [type.int32, schema.enum("Type")],
-    boolValue: type.boolean,
-    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],
-    intValue: type.int32,
-    floatValue: type.float32,
-    stringValue: type.string
-  }
-});
-
-export { Tr2EffectParameterAnnotation };
-//# sourceMappingURL=Tr2EffectParameterAnnotation.js.map
+import { CjsSchema, type, impl, schema } from '@carbonenginejs/runtime-utils/schema';
+import { CjsModel } from '@carbonenginejs/runtime-utils/model';
+import { dwordToFloat } from '@carbonenginejs/runtime-utils/math/num';
+import { isPlainObject } from '@carbonenginejs/runtime-utils/is';
+import { recordText, recordRawValue, toRecordText, toRecordRawValue } from './carbonRecordFields.js';
+
+// Source: trinity/trinity/Shader/Tr2EffectDescription.h
+
+/** Typed annotation attached to a reflected effect parameter. */
+class Tr2EffectParameterAnnotation extends CjsModel {
+  /** name (const char*) */
+  name = "";
+
+  /** type (Type - enum Type) */
+  type = 0;
+
+  /** boolValue (bool) */
+  boolValue = false;
+
+  /** Exact serialized BOOL, INT, or FLOAT payload bits. */
+  rawValue = 0;
+
+  /** intValue (int) */
+  intValue = 0;
+
+  /** floatValue (float) */
+  floatValue = 0;
+
+  /** 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.
+   */
+  static fromCarbonBinary(record) {
+    if (!isPlainObject(record)) {
+      throw new TypeError("Carbon effect annotation record must be an object");
+    }
+    const annotation = new this();
+    annotation.name = recordText(record.name);
+    annotation.type = record.type;
+    switch (annotation.type) {
+      case this.Type.BOOL:
+        annotation.rawValue = recordRawValue(record.rawValue);
+        annotation.boolValue = annotation.rawValue !== 0;
+        break;
+      case this.Type.INT:
+        annotation.rawValue = recordRawValue(record.rawValue);
+        annotation.intValue = annotation.rawValue | 0;
+        break;
+      case this.Type.FLOAT:
+        annotation.rawValue = recordRawValue(record.rawValue);
+        annotation.floatValue = dwordToFloat(annotation.rawValue);
+        break;
+      case this.Type.STRING:
+        annotation.stringValue = recordText(record.stringValue);
+        break;
+      default:
+        throw new Error(`Carbon effect annotation type ${annotation.type} is unsupported`);
+    }
+    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.
+   */
+  toCarbonBinary() {
+    if (this.type === Tr2EffectParameterAnnotation.Type.STRING) {
+      return {
+        name: toRecordText(this.name),
+        type: this.type,
+        stringValue: toRecordText(this.stringValue),
+        rawValue: null
+      };
+    }
+    return {
+      name: toRecordText(this.name),
+      type: this.type,
+      stringValue: null,
+      rawValue: toRecordRawValue(this.rawValue)
+    };
+  }
+  static Type = Object.freeze({
+    BOOL: 0,
+    INT: 1,
+    FLOAT: 2,
+    STRING: 3
+  });
+}
+
+// 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(Tr2EffectParameterAnnotation, {
+  className: "Tr2EffectParameterAnnotation",
+  family: "shader",
+  fields: {
+    name: type.string,
+    type: [type.int32, schema.enum("Type")],
+    boolValue: type.boolean,
+    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],
+    intValue: type.int32,
+    floatValue: type.float32,
+    stringValue: type.string
+  }
+});
+
+export { Tr2EffectParameterAnnotation };
+//# sourceMappingURL=Tr2EffectParameterAnnotation.js.map