@carbonenginejs/runtime-resource 0.9.1 → 0.10.0

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

@@ -0,0 +1,100 @@
+import { identity as _identity, applyDecs2311 as _applyDecs2311 } from '../../../_virtual/_rollupPluginBabelHelpers.js';
+import { type, impl, schema } from '@carbonenginejs/runtime-utils/schema';
+import { CjsModel } from '@carbonenginejs/runtime-utils/model';
+import { isPlainObject, isUint32 } from '@carbonenginejs/runtime-utils/is';
+
+let _initStatic, _initClass, _init_name, _init_extra_name, _init_offset, _init_extra_offset, _init_size, _init_extra_size, _init_type, _init_extra_type, _init_dimension, _init_extra_dimension, _init_elements, _init_extra_elements, _init_isSRGB, _init_extra_isSRGB, _init_isAutoregister, _init_extra_isAutoregister;
+
+/** Reflected shader constant metadata. */
+let _Tr2EffectConstant;
+new class extends _identity {
+  static [class Tr2EffectConstant extends CjsModel {
+    static {
+      ({
+        e: [_init_name, _init_extra_name, _init_offset, _init_extra_offset, _init_size, _init_extra_size, _init_type, _init_extra_type, _init_dimension, _init_extra_dimension, _init_elements, _init_extra_elements, _init_isSRGB, _init_extra_isSRGB, _init_isAutoregister, _init_extra_isAutoregister, _initStatic],
+        c: [_Tr2EffectConstant, _initClass]
+      } = _applyDecs2311(this, [type.define({
+        className: "Tr2EffectConstant",
+        family: "shader"
+      })], [[[type, type.string], 16, "name"], [[type, type.uint32], 16, "offset"], [[type, type.uint32], 16, "size"], [[type, type.int32, void 0, schema.enum("Type")], 16, "type"], [[type, type.uint32], 16, "dimension"], [[type, type.uint32], 16, "elements"], [[type, type.boolean], 16, "isSRGB"], [[type, type.boolean], 16, "isAutoregister"], [[impl, impl.custom, void 0, impl.reason("Carbon reads compiled effect bytes directly; CarbonEngineJS hydrates the browser-safe portable-reflection contract after format parsing.")], 26, "fromPortable"]], 0, void 0, CjsModel));
+      _initStatic(this);
+    }
+    constructor(...args) {
+      super(...args);
+      _init_extra_isAutoregister(this);
+    }
+    /** name (BlueSharedString) */
+    name = _init_name(this, "");
+
+    /** offset (unsigned) */
+    offset = (_init_extra_name(this), _init_offset(this, 0));
+
+    /** size (unsigned) */
+    size = (_init_extra_offset(this), _init_size(this, 0));
+
+    /** type (Type - enum Type) */
+    type = (_init_extra_size(this), _init_type(this, 0));
+
+    /** dimension (unsigned) */
+    dimension = (_init_extra_type(this), _init_dimension(this, 0));
+
+    /** elements (unsigned) */
+    elements = (_init_extra_dimension(this), _init_elements(this, 0));
+
+    /** isSRGB (bool) */
+    isSRGB = (_init_extra_elements(this), _init_isSRGB(this, false));
+
+    /** isAutoregister (bool) */
+    isAutoregister = (_init_extra_isSRGB(this), _init_isAutoregister(this, false));
+
+    /**
+     * Build one constant from its portable JSON reflection record.
+     *
+     * @param {object} value Portable constant record.
+     * @returns {Tr2EffectConstant} Reflected constant.
+     */
+    static fromPortable(value) {
+      if (!isPlainObject(value)) {
+        throw new TypeError("Portable effect constant must be an object");
+      }
+      if (!isUint32(value.offset)) {
+        throw new RangeError("Portable constant offset must fit uint32");
+      }
+      if (!isUint32(value.size)) {
+        throw new RangeError("Portable constant size must fit uint32");
+      }
+      if (!isUint32(value.type)) {
+        throw new RangeError("Portable constant type must fit uint32");
+      }
+      if (!isUint32(value.dimension)) {
+        throw new RangeError("Portable constant dimension must fit uint32");
+      }
+      if (!isUint32(value.elements)) {
+        throw new RangeError("Portable constant element count must fit uint32");
+      }
+      const constant = new this();
+      constant.name = String(value.name ?? "");
+      constant.offset = value.offset;
+      constant.size = value.size;
+      constant.type = value.type;
+      constant.dimension = value.dimension;
+      constant.elements = value.elements;
+      constant.isSRGB = !!value.isSRGB;
+      constant.isAutoregister = !!value.isAutoregister;
+      return constant;
+    }
+  }];
+  Type = Object.freeze({
+    FLOAT: 0,
+    INT: 1,
+    UINT: 2,
+    BOOL: 3,
+    OTHER: 4
+  });
+  constructor() {
+    super(_Tr2EffectConstant), _initClass();
+  }
+}();
+
+export { _Tr2EffectConstant as Tr2EffectConstant };
+//# sourceMappingURL=Tr2EffectConstant.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Tr2EffectConstant.js","sources":["../../../../../src/resource/shader/reflection/Tr2EffectConstant.js"],"sourcesContent":["// Source: trinity/trinity/Shader/Tr2EffectDescription.h\nimport { impl, schema, type } from \"@carbonenginejs/runtime-utils/schema\";\nimport { CjsModel } from \"@carbonenginejs/runtime-utils/model\";\nimport {\n  isPlainObject,\n  isUint32\n} from \"@carbonenginejs/runtime-utils/is\";\n\n/** Reflected shader constant metadata. */\n@type.define({ className: \"Tr2EffectConstant\", family: \"shader\" })\nexport class Tr2EffectConstant extends CjsModel\n{\n\n  /** name (BlueSharedString) */\n  @type.string\n  name = \"\";\n\n  /** offset (unsigned) */\n  @type.uint32\n  offset = 0;\n\n  /** size (unsigned) */\n  @type.uint32\n  size = 0;\n\n  /** type (Type - enum Type) */\n  @type.int32\n  @schema.enum(\"Type\")\n  type = 0;\n\n  /** dimension (unsigned) */\n  @type.uint32\n  dimension = 0;\n\n  /** elements (unsigned) */\n  @type.uint32\n  elements = 0;\n\n  /** isSRGB (bool) */\n  @type.boolean\n  isSRGB = false;\n\n  /** isAutoregister (bool) */\n  @type.boolean\n  isAutoregister = false;\n\n  /**\n   * Build one constant from its portable JSON reflection record.\n   *\n   * @param {object} value Portable constant record.\n   * @returns {Tr2EffectConstant} Reflected constant.\n   */\n  @impl.custom\n  @impl.reason(\"Carbon reads compiled effect bytes directly; CarbonEngineJS hydrates the browser-safe portable-reflection contract after format parsing.\")\n  static fromPortable(value)\n  {\n    if (!isPlainObject(value))\n    {\n      throw new TypeError(\"Portable effect constant must be an object\");\n    }\n    if (!isUint32(value.offset))\n    {\n      throw new RangeError(\"Portable constant offset must fit uint32\");\n    }\n    if (!isUint32(value.size))\n    {\n      throw new RangeError(\"Portable constant size must fit uint32\");\n    }\n    if (!isUint32(value.type))\n    {\n      throw new RangeError(\"Portable constant type must fit uint32\");\n    }\n    if (!isUint32(value.dimension))\n    {\n      throw new RangeError(\"Portable constant dimension must fit uint32\");\n    }\n    if (!isUint32(value.elements))\n    {\n      throw new RangeError(\n        \"Portable constant element count must fit uint32\"\n      );\n    }\n\n    const constant = new this();\n    constant.name = String(value.name ?? \"\");\n    constant.offset = value.offset;\n    constant.size = value.size;\n    constant.type = value.type;\n    constant.dimension = value.dimension;\n    constant.elements = value.elements;\n    constant.isSRGB = !!value.isSRGB;\n    constant.isAutoregister = !!value.isAutoregister;\n    return constant;\n  }\n\n  static Type = Object.freeze({\n    FLOAT: 0,\n    INT: 1,\n    UINT: 2,\n    BOOL: 3,\n    OTHER: 4\n  });\n\n}\n"],"names":["_Tr2EffectConstant","_identity","Tr2EffectConstant","CjsModel","e","_init_name","_init_extra_name","_init_offset","_init_extra_offset","_init_size","_init_extra_size","_init_type","_init_extra_type","_init_dimension","_init_extra_dimension","_init_elements","_init_extra_elements","_init_isSRGB","_init_extra_isSRGB","_init_isAutoregister","_init_extra_isAutoregister","_initStatic","c","_initClass","_applyDecs","type","define","className","family","string","uint32","int32","schema","enum","boolean","impl","custom","reason","constructor","args","name","offset","size","dimension","elements","isSRGB","isAutoregister","fromPortable","value","isPlainObject","TypeError","isUint32","RangeError","constant","String","Type","Object","freeze","FLOAT","INT","UINT","BOOL","OTHER"],"mappings":"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"}

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

@@ -0,0 +1,34 @@
+import { applyDecs2311 as _applyDecs2311 } from '../../../_virtual/_rollupPluginBabelHelpers.js';
+import { type } from '@carbonenginejs/runtime-utils/schema';
+import { CjsModel } from '@carbonenginejs/runtime-utils/model';
+
+let _initClass, _init_name, _init_extra_name, _init_value, _init_extra_value;
+
+/** Effect compile define retained as source metadata. */
+let _Tr2EffectDefine;
+class Tr2EffectDefine extends CjsModel {
+  static {
+    ({
+      e: [_init_name, _init_extra_name, _init_value, _init_extra_value],
+      c: [_Tr2EffectDefine, _initClass]
+    } = _applyDecs2311(this, [type.define({
+      className: "Tr2EffectDefine",
+      family: "shader"
+    })], [[[type, type.string], 16, "name"], [[type, type.string], 16, "value"]], 0, void 0, CjsModel));
+  }
+  constructor(...args) {
+    super(...args);
+    _init_extra_value(this);
+  }
+  /** name (const char*) */
+  name = _init_name(this, "");
+
+  /** value (const char*) */
+  value = (_init_extra_name(this), _init_value(this, ""));
+  static {
+    _initClass();
+  }
+}
+
+export { _Tr2EffectDefine as Tr2EffectDefine };
+//# sourceMappingURL=Tr2EffectDefine.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Tr2EffectDefine.js","sources":["../../../../../src/resource/shader/reflection/Tr2EffectDefine.js"],"sourcesContent":["// Source: trinity/trinity/Shader/Tr2EffectDescription.h\nimport { type } from \"@carbonenginejs/runtime-utils/schema\";\nimport { CjsModel } from \"@carbonenginejs/runtime-utils/model\";\n\n/** Effect compile define retained as source metadata. */\n@type.define({ className: \"Tr2EffectDefine\", family: \"shader\" })\nexport class Tr2EffectDefine extends CjsModel\n{\n\n  /** name (const char*) */\n  @type.string\n  name = \"\";\n\n  /** value (const char*) */\n  @type.string\n  value = \"\";\n\n}\n"],"names":["_Tr2EffectDefine","Tr2EffectDefine","CjsModel","e","_init_name","_init_extra_name","_init_value","_init_extra_value","c","_initClass","_applyDecs","type","define","className","family","string","constructor","args","name","value"],"mappings":";;;;;;AAIA;AAAA,IAAAA;AACA,MAAAC,eAAA,SACqCC,QAAQ,CAC7C;AAAA,EAAA;AAAA,IAAA,CAAA;AAAAC,MAAAA,CAAA,GAAAC,UAAA,EAAAC,gBAAA,EAAAC,WAAA,EAAAC,iBAAA,CAAA;MAAAC,CAAA,EAAA,CAAAR,gBAAA,EAAAS,UAAA;AAAA,KAAA,GAAAC,cAAA,CAAA,IAAA,EAAA,CAFCC,IAAI,CAACC,MAAM,CAAC;AAAEC,MAAAA,SAAS,EAAE,iBAAiB;AAAEC,MAAAA,MAAM,EAAE;AAAS,KAAC,CAAC,CAAA,EAAA,CAAA,CAAA,CAK7DH,IAAI,EAAJA,IAAI,CAACI,MAAM,CAAA,EAAA,EAAA,EAAA,MAAA,CAAA,EAAA,CAAA,CAIXJ,IAAI,EAAJA,IAAI,CAACI,MAAM,6BARuBb,QAAQ,CAAA;AAAA;AAAAc,EAAAA,WAAAA,CAAA,GAAAC,IAAA,EAAA;AAAA,IAAA,KAAA,CAAA,GAAAA,IAAA,CAAA;IAAAV,iBAAA,CAAA,IAAA,CAAA;AAAA,EAAA;AAG3C;EAEAW,IAAI,GAAAd,UAAA,CAAA,IAAA,EAAG,EAAE,CAAA;;AAET;AAEAe,EAAAA,KAAK,IAAAd,gBAAA,CAAA,IAAA,CAAA,EAAAC,WAAA,OAAG,EAAE,CAAA;AAAC,EAAA;IAAAG,UAAA,EAAA;AAAA;AAEb;;;;"}

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

@@ -0,0 +1,113 @@
+import { applyDecs2311 as _applyDecs2311 } from '../../../_virtual/_rollupPluginBabelHelpers.js';
+import { impl, type } from '@carbonenginejs/runtime-utils/schema';
+import { CjsModel } from '@carbonenginejs/runtime-utils/model';
+import { isPlainObject, isArray } from '@carbonenginejs/runtime-utils/is';
+import { Tr2EffectParameterAnnotation as _Tr2EffectParameterAn } from './Tr2EffectParameterAnnotation.js';
+import { Tr2EffectTechnique as _Tr2EffectTechnique } from './Tr2EffectTechnique.js';
+
+let _initStatic, _initClass, _init_techniques, _init_extra_techniques, _init_annotations, _init_extra_annotations;
+
+/** Complete device-free effect description for one selected shader body. */
+let _Tr2EffectDescription;
+class Tr2EffectDescription extends CjsModel {
+  static {
+    ({
+      e: [_init_techniques, _init_extra_techniques, _init_annotations, _init_extra_annotations, _initStatic],
+      c: [_Tr2EffectDescription, _initClass]
+    } = _applyDecs2311(this, [type.define({
+      className: "Tr2EffectDescription",
+      family: "shader"
+    })], [[type.list("Tr2EffectTechnique"), 0, "techniques"], [type.map("Tr2EffectParameterAnnotationMap"), 0, "annotations"], [[impl, impl.custom, void 0, impl.reason("Carbon reads compiled effect bytes directly; CarbonEngineJS hydrates the browser-safe portable-reflection contract after format parsing.")], 26, "fromPortable"], [[impl, impl.custom, void 0, impl.reason("Carbon reads annotation groups from compiled bytes; CarbonEngineJS indexes the validated portable groups into canonical maps.")], 26, "readPortableAnnotationGroups"]], 0, void 0, CjsModel));
+    _initStatic(this);
+  }
+  constructor(...args) {
+    super(...args);
+    _init_extra_annotations(this);
+  }
+  /** techniques (TrackableStdVector<Tr2EffectTechnique>) */
+  techniques = _init_techniques(this, []);
+
+  /** annotations (Tr2EffectAnnotationMap) */
+  annotations = (_init_extra_techniques(this), _init_annotations(this, 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 _Tr2EffectParameterAn ? record : _Tr2EffectParameterAn.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 => _Tr2EffectParameterAn.fromPortable(entry)));
+    }
+    return result;
+  }
+  static {
+    _initClass();
+  }
+}
+
+export { _Tr2EffectDescription as Tr2EffectDescription };
+//# sourceMappingURL=Tr2EffectDescription.js.map

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

@@ -0,0 +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 { 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. */\n@type.define({ className: \"Tr2EffectDescription\", family: \"shader\" })\nexport class Tr2EffectDescription extends CjsModel\n{\n\n  /** techniques (TrackableStdVector<Tr2EffectTechnique>) */\n  @type.list(\"Tr2EffectTechnique\")\n  techniques = [];\n\n  /** annotations (Tr2EffectAnnotationMap) */\n  @type.map(\"Tr2EffectParameterAnnotationMap\")\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  @impl.custom\n  @impl.reason(\"Carbon reads compiled effect bytes directly; CarbonEngineJS hydrates the browser-safe portable-reflection contract after format parsing.\")\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  @impl.custom\n  @impl.reason(\"Carbon reads annotation groups from compiled bytes; CarbonEngineJS indexes the validated portable groups into canonical maps.\")\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"],"names":["_Tr2EffectDescription","Tr2EffectDescription","CjsModel","e","_init_techniques","_init_extra_techniques","_init_annotations","_init_extra_annotations","_initStatic","c","_initClass","_applyDecs","type","define","className","family","list","map","impl","custom","reason","constructor","args","techniques","annotations","Map","from","values","options","normalized","Object","hasOwn","entries","parameterName","records","Array","isArray","TypeError","set","String","record","Tr2EffectParameterAnnotation","effect","fromPortable","value","isPlainObject","annotationGroupCount","length","techniqueCount","Error","readPortableAnnotationGroups","entry","Tr2EffectTechnique","result","has"],"mappings":"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"}

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

@@ -0,0 +1,141 @@
+import { applyDecs2311 as _applyDecs2311 } from '../../../_virtual/_rollupPluginBabelHelpers.js';
+import { type, impl } 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 as _Tr2EffectStageInput } from './Tr2EffectStageInput.js';
+
+let _initStatic, _initClass, _init_payloadSize, _init_extra_payloadSize, _init_libraryHandle, _init_extra_libraryHandle, _init_rayGenName, _init_extra_rayGenName, _init_missName, _init_extra_missName, _init_closestHitName, _init_extra_closestHitName, _init_anyHitName, _init_extra_anyHitName, _init_intersectionName, _init_extra_intersectionName, _init_hitGroupName, _init_extra_hitGroupName, _init_globalInput, _init_extra_globalInput, _init_localInput, _init_extra_localInput, _init_globalResourceSetDesc, _init_extra_globalResourceSetDesc, _init_sourceProgram, _init_extra_sourceProgram, _init_exports, _init_extra_exports;
+
+/** Reflected shader-library metadata. */
+let _Tr2EffectLibrary;
+class Tr2EffectLibrary extends CjsModel {
+  static {
+    ({
+      e: [_init_payloadSize, _init_extra_payloadSize, _init_libraryHandle, _init_extra_libraryHandle, _init_rayGenName, _init_extra_rayGenName, _init_missName, _init_extra_missName, _init_closestHitName, _init_extra_closestHitName, _init_anyHitName, _init_extra_anyHitName, _init_intersectionName, _init_extra_intersectionName, _init_hitGroupName, _init_extra_hitGroupName, _init_globalInput, _init_extra_globalInput, _init_localInput, _init_extra_localInput, _init_globalResourceSetDesc, _init_extra_globalResourceSetDesc, _init_sourceProgram, _init_extra_sourceProgram, _init_exports, _init_extra_exports, _initStatic],
+      c: [_Tr2EffectLibrary, _initClass]
+    } = _applyDecs2311(this, [type.define({
+      className: "Tr2EffectLibrary",
+      family: "shader"
+    })], [[[type, type.uint32], 16, "payloadSize"], [[type, type.uint32], 16, "libraryHandle"], [[type, type.string], 16, "rayGenName"], [[type, type.string], 16, "missName"], [[type, type.string], 16, "closestHitName"], [[type, type.string], 16, "anyHitName"], [[type, type.string], 16, "intersectionName"], [[type, type.string], 16, "hitGroupName"], [type.rawStruct("Tr2EffectStageInput"), 0, "globalInput"], [type.rawStruct("Tr2EffectStageInput"), 0, "localInput"], [type.rawStruct("Tr2ResourceSetDescriptionAL"), 0, "globalResourceSetDesc"], [[impl, impl.adapted, void 0, impl.reason("Carbon registers the library with the renderer while reading; the device-free graph retains the source program for later engine realization."), void 0, type.rawStruct("CjsEffectSourceProgram")], 16, "sourceProgram"], [[impl, impl.adapted, void 0, impl.reason("Carbon resolves these exports into a renderer library handle; the device-free graph keeps the declarative export list."), void 0, type.rawStruct("CjsEffectLibraryExports")], 16, "exports"], [[impl, impl.custom, void 0, impl.reason("Carbon reads compiled effect bytes directly; CarbonEngineJS hydrates the browser-safe portable-reflection contract after format parsing.")], 26, "fromPortable"]], 0, void 0, CjsModel));
+    _initStatic(this);
+  }
+  constructor(...args) {
+    super(...args);
+    _init_extra_exports(this);
+  }
+  /** payloadSize (uint32_t) */
+  payloadSize = _init_payloadSize(this, 0);
+
+  /** libraryHandle (uint32_t) */
+  libraryHandle = (_init_extra_payloadSize(this), _init_libraryHandle(this, 0));
+
+  /** rayGenName (BlueSharedStringW) */
+  rayGenName = (_init_extra_libraryHandle(this), _init_rayGenName(this, ""));
+
+  /** missName (BlueSharedStringW) */
+  missName = (_init_extra_rayGenName(this), _init_missName(this, ""));
+
+  /** closestHitName (BlueSharedStringW) */
+  closestHitName = (_init_extra_missName(this), _init_closestHitName(this, ""));
+
+  /** anyHitName (BlueSharedStringW) */
+  anyHitName = (_init_extra_closestHitName(this), _init_anyHitName(this, ""));
+
+  /** intersectionName (BlueSharedStringW) */
+  intersectionName = (_init_extra_anyHitName(this), _init_intersectionName(this, ""));
+
+  /** hitGroupName (BlueSharedStringW) */
+  hitGroupName = (_init_extra_intersectionName(this), _init_hitGroupName(this, ""));
+
+  /** globalInput (Tr2EffectStageInput) */
+  globalInput = (_init_extra_hitGroupName(this), _init_globalInput(this, null));
+
+  /** localInput (Tr2EffectStageInput) */
+  localInput = (_init_extra_globalInput(this), _init_localInput(this, null));
+
+  /** globalResourceSetDesc (Tr2ResourceSetDescriptionAL) */
+  globalResourceSetDesc = (_init_extra_localInput(this), _init_globalResourceSetDesc(this, null));
+
+  /** Exact source library program metadata and owned bytes. */
+  sourceProgram = (_init_extra_globalResourceSetDesc(this), _init_sourceProgram(this, null));
+
+  /** Portable export records retained before backend library registration. */
+  exports = (_init_extra_sourceProgram(this), _init_exports(this, []));
+
+  /**
+   * 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;
+  }
+  static {
+    _initClass();
+  }
+}
+
+export { _Tr2EffectLibrary as Tr2EffectLibrary };
+//# sourceMappingURL=Tr2EffectLibrary.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Tr2EffectLibrary.js","sources":["../../../../../src/resource/shader/reflection/Tr2EffectLibrary.js"],"sourcesContent":["// Source: trinity/trinity/Shader/Tr2EffectDescription.h\nimport { impl, type } from \"@carbonenginejs/runtime-utils/schema\";\nimport { CjsModel } from \"@carbonenginejs/runtime-utils/model\";\nimport {\n  isArray,\n  isPlainObject,\n  isUint32\n} from \"@carbonenginejs/runtime-utils/is\";\nimport { clonePortableSourceProgram } from \"../portable.js\";\nimport { Tr2EffectStageInput } from \"./Tr2EffectStageInput.js\";\n\n/** Reflected shader-library metadata. */\n@type.define({ className: \"Tr2EffectLibrary\", family: \"shader\" })\nexport class Tr2EffectLibrary extends CjsModel\n{\n\n  /** payloadSize (uint32_t) */\n  @type.uint32\n  payloadSize = 0;\n\n  /** libraryHandle (uint32_t) */\n  @type.uint32\n  libraryHandle = 0;\n\n  /** rayGenName (BlueSharedStringW) */\n  @type.string\n  rayGenName = \"\";\n\n  /** missName (BlueSharedStringW) */\n  @type.string\n  missName = \"\";\n\n  /** closestHitName (BlueSharedStringW) */\n  @type.string\n  closestHitName = \"\";\n\n  /** anyHitName (BlueSharedStringW) */\n  @type.string\n  anyHitName = \"\";\n\n  /** intersectionName (BlueSharedStringW) */\n  @type.string\n  intersectionName = \"\";\n\n  /** hitGroupName (BlueSharedStringW) */\n  @type.string\n  hitGroupName = \"\";\n\n  /** globalInput (Tr2EffectStageInput) */\n  @type.rawStruct(\"Tr2EffectStageInput\")\n  globalInput = null;\n\n  /** localInput (Tr2EffectStageInput) */\n  @type.rawStruct(\"Tr2EffectStageInput\")\n  localInput = null;\n\n  /** globalResourceSetDesc (Tr2ResourceSetDescriptionAL) */\n  @type.rawStruct(\"Tr2ResourceSetDescriptionAL\")\n  globalResourceSetDesc = null;\n\n  /** Exact source library program metadata and owned bytes. */\n  @impl.adapted\n  @impl.reason(\"Carbon registers the library with the renderer while reading; the device-free graph retains the source program for later engine realization.\")\n  @type.rawStruct(\"CjsEffectSourceProgram\")\n  sourceProgram = null;\n\n  /** Portable export records retained before backend library registration. */\n  @impl.adapted\n  @impl.reason(\"Carbon resolves these exports into a renderer library handle; the device-free graph keeps the declarative export list.\")\n  @type.rawStruct(\"CjsEffectLibraryExports\")\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 shader library from its portable JSON reflection record.\n   *\n   * @param {object} value Portable library record.\n   * @returns {Tr2EffectLibrary} Reflected library.\n   */\n  @impl.custom\n  @impl.reason(\"Carbon reads compiled effect bytes directly; CarbonEngineJS hydrates the browser-safe portable-reflection contract after format parsing.\")\n  static fromPortable(value)\n  {\n    if (!isPlainObject(value))\n    {\n      throw new TypeError(\"Portable effect library must be an object\");\n    }\n    if (!isArray(value.exports))\n    {\n      throw new TypeError(\n        \"Portable effect library exports must be an array\"\n      );\n    }\n    if (value.exportCount !== value.exports.length)\n    {\n      throw new Error(\n        \"Portable effect library export count disagrees with its collection\"\n      );\n    }\n\n    const library = new this();\n    if (!isUint32(value.payloadSize))\n    {\n      throw new RangeError(\n        \"Portable effect library payload size must fit uint32\"\n      );\n    }\n    library.payloadSize = value.payloadSize;\n    library.hitGroupName = String(value.hitGroupName ?? \"\");\n    library.exports = value.exports.map(entry =>\n    {\n      if (!isUint32(entry?.type))\n      {\n        throw new RangeError(\n          \"Portable effect library export type must fit uint32\"\n        );\n      }\n      return {\n        type: entry.type,\n        name: String(entry?.name ?? \"\")\n      };\n    });\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 = clonePortableSourceProgram(\n      value.sourceProgram,\n      \"library\"\n    );\n    library.globalInput = Tr2EffectStageInput.fromPortableInput(\n      value.globalInput\n    );\n    library.localInput = Tr2EffectStageInput.fromPortableInput(\n      value.localInput\n    );\n    return library;\n  }\n\n}\n"],"names":["_Tr2EffectLibrary","Tr2EffectLibrary","CjsModel","e","_init_payloadSize","_init_extra_payloadSize","_init_libraryHandle","_init_extra_libraryHandle","_init_rayGenName","_init_extra_rayGenName","_init_missName","_init_extra_missName","_init_closestHitName","_init_extra_closestHitName","_init_anyHitName","_init_extra_anyHitName","_init_intersectionName","_init_extra_intersectionName","_init_hitGroupName","_init_extra_hitGroupName","_init_globalInput","_init_extra_globalInput","_init_localInput","_init_extra_localInput","_init_globalResourceSetDesc","_init_extra_globalResourceSetDesc","_init_sourceProgram","_init_extra_sourceProgram","_init_exports","_init_extra_exports","_initStatic","c","_initClass","_applyDecs","type","define","className","family","uint32","string","rawStruct","impl","adapted","reason","custom","constructor","args","payloadSize","libraryHandle","rayGenName","missName","closestHitName","anyHitName","intersectionName","hitGroupName","globalInput","localInput","globalResourceSetDesc","sourceProgram","exports","from","values","options","normalized","inputs","Map","field","Tr2EffectStageInput","set","library","value","fromPortable","isPlainObject","TypeError","isArray","exportCount","length","Error","isUint32","RangeError","String","map","entry","name","clonePortableSourceProgram","fromPortableInput"],"mappings":"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"}

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

@@ -0,0 +1,107 @@
+import { identity as _identity, applyDecs2311 as _applyDecs2311 } from '../../../_virtual/_rollupPluginBabelHelpers.js';
+import { 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, isUint32 } from '@carbonenginejs/runtime-utils/is';
+
+let _initStatic, _initClass, _init_name, _init_extra_name, _init_type, _init_extra_type, _init_boolValue, _init_extra_boolValue, _init_rawValue, _init_extra_rawValue, _init_intValue, _init_extra_intValue, _init_floatValue, _init_extra_floatValue, _init_stringValue, _init_extra_stringValue;
+
+/** Typed annotation attached to a reflected effect parameter. */
+let _Tr2EffectParameterAn;
+new class extends _identity {
+  static [class Tr2EffectParameterAnnotation extends CjsModel {
+    static {
+      ({
+        e: [_init_name, _init_extra_name, _init_type, _init_extra_type, _init_boolValue, _init_extra_boolValue, _init_rawValue, _init_extra_rawValue, _init_intValue, _init_extra_intValue, _init_floatValue, _init_extra_floatValue, _init_stringValue, _init_extra_stringValue, _initStatic],
+        c: [_Tr2EffectParameterAn, _initClass]
+      } = _applyDecs2311(this, [type.define({
+        className: "Tr2EffectParameterAnnotation",
+        family: "shader"
+      })], [[[type, type.string], 16, "name"], [[type, type.int32, void 0, schema.enum("Type")], 16, "type"], [[type, type.boolean], 16, "boolValue"], [[impl, impl.adapted, void 0, 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, type.uint32], 16, "rawValue"], [[type, type.int32], 16, "intValue"], [[type, type.float32], 16, "floatValue"], [[type, type.string], 16, "stringValue"], [[impl, impl.custom, void 0, impl.reason("Carbon reads compiled effect bytes directly; CarbonEngineJS hydrates the browser-safe portable-reflection contract while retaining exact numeric bits.")], 26, "fromPortable"]], 0, void 0, CjsModel));
+      _initStatic(this);
+    }
+    constructor(...args) {
+      super(...args);
+      _init_extra_stringValue(this);
+    }
+    /** name (const char*) */
+    name = _init_name(this, "");
+
+    /** type (Type - enum Type) */
+    type = (_init_extra_name(this), _init_type(this, 0));
+
+    /** boolValue (bool) */
+    boolValue = (_init_extra_type(this), _init_boolValue(this, false));
+
+    /** Exact serialized BOOL, INT, or FLOAT payload bits. */
+    rawValue = (_init_extra_boolValue(this), _init_rawValue(this, 0));
+
+    /** intValue (int) */
+    intValue = (_init_extra_rawValue(this), _init_intValue(this, 0));
+
+    /** floatValue (float) */
+    floatValue = (_init_extra_intValue(this), _init_floatValue(this, 0));
+
+    /** stringValue (const char*) */
+    stringValue = (_init_extra_floatValue(this), _init_stringValue(this, ""));
+
+    /**
+     * Build one typed annotation from its portable JSON reflection record.
+     *
+     * @param {object} value Portable annotation record.
+     * @returns {Tr2EffectParameterAnnotation} Reflected annotation.
+     */
+    static fromPortable(value) {
+      if (!isPlainObject(value)) {
+        throw new TypeError("Portable effect annotation must be an object");
+      }
+      if (!isUint32(value.type)) {
+        throw new RangeError("Portable annotation type must fit uint32");
+      }
+      const annotation = new this();
+      annotation.name = String(value.name ?? "");
+      annotation.type = value.type;
+      switch (annotation.type) {
+        case this.Type.BOOL:
+          if (!isUint32(value.rawValue)) {
+            throw new RangeError("Portable boolean annotation must fit uint32");
+          }
+          annotation.rawValue = value.rawValue;
+          annotation.boolValue = annotation.rawValue !== 0;
+          break;
+        case this.Type.INT:
+          if (!isUint32(value.rawValue)) {
+            throw new RangeError("Portable integer annotation must fit uint32");
+          }
+          annotation.rawValue = value.rawValue;
+          annotation.intValue = annotation.rawValue | 0;
+          break;
+        case this.Type.FLOAT:
+          if (!isUint32(value.rawValue)) {
+            throw new RangeError("Portable float annotation must fit uint32");
+          }
+          annotation.rawValue = value.rawValue;
+          annotation.floatValue = dwordToFloat(annotation.rawValue);
+          break;
+        case this.Type.STRING:
+          annotation.stringValue = String(value.stringValue ?? "");
+          break;
+        default:
+          throw new Error(`Portable annotation type ${annotation.type} is unsupported`);
+      }
+      return annotation;
+    }
+  }];
+  Type = Object.freeze({
+    BOOL: 0,
+    INT: 1,
+    FLOAT: 2,
+    STRING: 3
+  });
+  constructor() {
+    super(_Tr2EffectParameterAn), _initClass();
+  }
+}();
+
+export { _Tr2EffectParameterAn as Tr2EffectParameterAnnotation };
+//# sourceMappingURL=Tr2EffectParameterAnnotation.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Tr2EffectParameterAnnotation.js","sources":["../../../../../src/resource/shader/reflection/Tr2EffectParameterAnnotation.js"],"sourcesContent":["// Source: trinity/trinity/Shader/Tr2EffectDescription.h\nimport { impl, schema, type } from \"@carbonenginejs/runtime-utils/schema\";\nimport { CjsModel } from \"@carbonenginejs/runtime-utils/model\";\nimport { dwordToFloat } from \"@carbonenginejs/runtime-utils/math/num\";\nimport {\n  isPlainObject,\n  isUint32\n} from \"@carbonenginejs/runtime-utils/is\";\n\n/** Typed annotation attached to a reflected effect parameter. */\n@type.define({ className: \"Tr2EffectParameterAnnotation\", family: \"shader\" })\nexport class Tr2EffectParameterAnnotation extends CjsModel\n{\n\n  /** name (const char*) */\n  @type.string\n  name = \"\";\n\n  /** type (Type - enum Type) */\n  @type.int32\n  @schema.enum(\"Type\")\n  type = 0;\n\n  /** boolValue (bool) */\n  @type.boolean\n  boolValue = false;\n\n  /** Exact serialized BOOL, INT, or FLOAT payload bits. */\n  @impl.adapted\n  @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.\")\n  @type.uint32\n  rawValue = 0;\n\n  /** intValue (int) */\n  @type.int32\n  intValue = 0;\n\n  /** floatValue (float) */\n  @type.float32\n  floatValue = 0;\n\n  /** stringValue (const char*) */\n  @type.string\n  stringValue = \"\";\n\n  /**\n   * Build one typed annotation from its portable JSON reflection record.\n   *\n   * @param {object} value Portable annotation record.\n   * @returns {Tr2EffectParameterAnnotation} Reflected annotation.\n   */\n  @impl.custom\n  @impl.reason(\"Carbon reads compiled effect bytes directly; CarbonEngineJS hydrates the browser-safe portable-reflection contract while retaining exact numeric bits.\")\n  static fromPortable(value)\n  {\n    if (!isPlainObject(value))\n    {\n      throw new TypeError(\"Portable effect annotation must be an object\");\n    }\n    if (!isUint32(value.type))\n    {\n      throw new RangeError(\"Portable annotation type must fit uint32\");\n    }\n\n    const annotation = new this();\n    annotation.name = String(value.name ?? \"\");\n    annotation.type = value.type;\n\n    switch (annotation.type)\n    {\n      case this.Type.BOOL:\n        if (!isUint32(value.rawValue))\n        {\n          throw new RangeError(\n            \"Portable boolean annotation must fit uint32\"\n          );\n        }\n        annotation.rawValue = value.rawValue;\n        annotation.boolValue = annotation.rawValue !== 0;\n        break;\n\n      case this.Type.INT:\n        if (!isUint32(value.rawValue))\n        {\n          throw new RangeError(\n            \"Portable integer annotation must fit uint32\"\n          );\n        }\n        annotation.rawValue = value.rawValue;\n        annotation.intValue = annotation.rawValue | 0;\n        break;\n\n      case this.Type.FLOAT:\n        if (!isUint32(value.rawValue))\n        {\n          throw new RangeError(\n            \"Portable float annotation must fit uint32\"\n          );\n        }\n        annotation.rawValue = value.rawValue;\n        annotation.floatValue = dwordToFloat(annotation.rawValue);\n        break;\n\n      case this.Type.STRING:\n        annotation.stringValue = String(value.stringValue ?? \"\");\n        break;\n\n      default:\n        throw new Error(\n          `Portable annotation type ${annotation.type} is unsupported`\n        );\n    }\n\n    return annotation;\n  }\n\n  static Type = Object.freeze({\n    BOOL: 0,\n    INT: 1,\n    FLOAT: 2,\n    STRING: 3\n  });\n\n}\n"],"names":["_Tr2EffectParameterAn","_identity","Tr2EffectParameterAnnotation","CjsModel","e","_init_name","_init_extra_name","_init_type","_init_extra_type","_init_boolValue","_init_extra_boolValue","_init_rawValue","_init_extra_rawValue","_init_intValue","_init_extra_intValue","_init_floatValue","_init_extra_floatValue","_init_stringValue","_init_extra_stringValue","_initStatic","c","_initClass","_applyDecs","type","define","className","family","string","int32","schema","enum","boolean","impl","adapted","reason","uint32","float32","custom","constructor","args","name","boolValue","rawValue","intValue","floatValue","stringValue","fromPortable","value","isPlainObject","TypeError","isUint32","RangeError","annotation","String","Type","BOOL","INT","FLOAT","dwordToFloat","STRING","Error","Object","freeze"],"mappings":"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"}