@carbonenginejs/runtime-resource 0.9.2 → 0.11.0

package/dist/resource/shader/Tr2MaterialRes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Tr2MaterialRes.js","sources":["../../../../src/resource/shader/Tr2MaterialRes.js"],"sourcesContent":["// Source: trinity/trinity/Resources/Tr2MaterialRes.h\r\n// Schema: format-carbon resources/Tr2MaterialRes.json; maintained by runtime-resource.\r\nimport { CjsSchema, io, type } from \"@carbonenginejs/runtime-utils/schema\";\r\nimport { CjsModel } from \"@carbonenginejs/runtime-utils/model\";\r\n\r\n/**\r\n * Root persisted material record containing its authored name and material\r\n * mesh dictionary.\r\n *\r\n * It owns the serializable material description, not device shaders,\r\n * descriptor bindings, or pipelines.\r\n */\r\nexport class Tr2MaterialRes extends CjsModel\r\n{\r\n\r\n  /** Persisted dictionary of material meshes. */\r\n  meshes = null;\r\n\r\n  /** Authored material name. */\r\n  name = \"\";\r\n\r\n}\r\n\r\n// Declared imperatively rather than with decorators, so this module stays\r\n// plain ESM that loads from source without a transform. The decorator\r\n// expressions are reused verbatim, so the registered metadata is identical.\r\n// Statics belong in `methods`: decorateMethod targets the prototype and\r\n// would register a static as an instance field.\r\nCjsSchema.define(Tr2MaterialRes, {\r\n  className: \"Tr2MaterialRes\",\r\n  family: \"resources\"\r\n});\r\nCjsSchema.decorateField(Tr2MaterialRes, \"meshes\", io.persist, type.objectRef(\"Tr2MaterialMeshDict\"));\r\nCjsSchema.decorateField(Tr2MaterialRes, \"name\", io.persist, type.string);\r\n"],"names":["Tr2MaterialRes","CjsModel","meshes","name","CjsSchema","define","className","family","decorateField","io","persist","type","objectRef","string"],"mappings":";;;AAAA;AACA;;AAIA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,MAAMA,cAAc,SAASC,QAAQ,CAC5C;AAEE;AACAC,EAAAA,MAAM,GAAG,IAAI;;AAEb;AACAC,EAAAA,IAAI,GAAG,EAAE;AAEX;;AAEA;AACA;AACA;AACA;AACA;AACAC,SAAS,CAACC,MAAM,CAACL,cAAc,EAAE;AAC/BM,EAAAA,SAAS,EAAE,gBAAgB;AAC3BC,EAAAA,MAAM,EAAE;AACV,CAAC,CAAC;AACFH,SAAS,CAACI,aAAa,CAACR,cAAc,EAAE,QAAQ,EAAES,EAAE,CAACC,OAAO,EAAEC,IAAI,CAACC,SAAS,CAAC,qBAAqB,CAAC,CAAC;AACpGR,SAAS,CAACI,aAAa,CAACR,cAAc,EAAE,MAAM,EAAES,EAAE,CAACC,OAAO,EAAEC,IAAI,CAACE,MAAM,CAAC;;;;"}

package/dist/resource/shader/Tr2Shader.js

@@ -0,0 +1,256 @@
+import { CjsSchema, type, carbon, impl } from '@carbonenginejs/runtime-utils/schema';
+import { CjsModel } from '@carbonenginejs/runtime-utils/model';
+import { validateEffectBodyReflection, isEffectBodyReflection } from '../../formats/hlsl/core/portableReflection.js';
+import { Tr2EffectDescription } from './reflection/Tr2EffectDescription.js';
+
+// Source: trinity/trinity/Shader/Tr2Shader.h
+// Source: trinity/trinity/Shader/Tr2Shader.cpp
+
+/** GPU-free selected shader and its complete source reflection graph. */
+class Tr2Shader extends CjsModel {
+  /** m_sortValue (unsigned int) */
+  sortValue = 0;
+
+  /** m_effect (Tr2EffectDescription) */
+  effect = new Tr2EffectDescription();
+
+  /** m_hasVertexBufferAccessInRtShadow (bool) */
+  hasVertexBufferAccessInRtShadow = false;
+
+  /**
+   * Index of the named technique; 0 for Carbon's empty-string any-technique
+   * sentinel and -1 when the shader has no techniques or the name is unknown.
+   */
+  GetTechniqueIndex(name = "Main") {
+    const techniques = this.effect?.techniques ?? [];
+    if (!techniques.length) {
+      return -1;
+    }
+    if (name === "") {
+      return 0;
+    }
+    return techniques.findIndex(technique => technique?.name === name);
+  }
+
+  /** Number of passes in a technique; 0 for an unknown index. */
+  GetPassCount(techniqueIndex = 0) {
+    return this.effect?.techniques?.[techniqueIndex]?.passes?.length ?? 0;
+  }
+
+  /**
+   * The reflected constant of this name from any stage of any pass, or null;
+   * the description is metadata, not a bound GPU slot.
+   */
+  GetConstant(name) {
+    return Tr2Shader.findStageValue(this.effect, name, "constants");
+  }
+
+  /**
+   * The reflected resource of this name, searching stage resources before
+   * UAVs; null when neither has it.
+   */
+  GetResource(name) {
+    for (const stage of Tr2Shader.iterateStages(this.effect)) {
+      const resource = Tr2Shader.findNamedCollectionValue(stage?.resources, name);
+      if (resource) {
+        return resource;
+      }
+      const uav = Tr2Shader.findNamedCollectionValue(stage?.uavs, name);
+      if (uav) {
+        return uav;
+      }
+    }
+    return null;
+  }
+
+  /**
+   * The annotation set authored for a parameter name, or null; the shape
+   * depends on the reflection source.
+   */
+  GetParameterAnnotations(parameterName) {
+    return Tr2Shader.findAnnotationSet(this.effect?.annotations, parameterName);
+  }
+
+  /** The packed draw-sort key; 0 until ProcessEffect has run. */
+  GetSortValue() {
+    return this.sortValue;
+  }
+
+  /** The reflected effect description, by reference rather than copy. */
+  GetEffectDescription() {
+    return this.effect;
+  }
+
+  /** The same object GetEffectDescription returns. */
+  GetEffect() {
+    return this.effect;
+  }
+
+  /** The technique's bitmask of shader stages, or 0 for an unknown index. */
+  GetShaderTypeMask(techniqueIndex = 0) {
+    return Number(this.effect?.techniques?.[techniqueIndex]?.shaderTypeMask ?? 0);
+  }
+
+  /**
+   * Pack the first technique/pass's renderer handles into Carbon's sort key.
+   * A device-free source graph retains 0 while its handles remain invalid.
+   */
+  ProcessEffect() {
+    this.sortValue = 0;
+    const pass = this.effect?.techniques?.[0]?.passes?.[0];
+    if (!pass) {
+      return;
+    }
+    const stages = pass.stageInputs ?? [];
+    const pixelHandle = Number(stages[1]?.shader ?? stages[1]?.m_shader ?? 0xffffffff);
+    const vertexHandle = Number(stages[0]?.shader ?? stages[0]?.m_shader ?? 0xffffffff);
+    if (pixelHandle === 0xffffffff || vertexHandle === 0xffffffff) {
+      return;
+    }
+    const pixelShader = pixelHandle & 0x3ff;
+    const vertexShader = vertexHandle & 0x3ff;
+    const renderStates = Number(pass.renderStates ?? 0) & 0x3ff;
+    const passCount = Number(this.effect?.techniques?.[0]?.passes?.length ?? 0) & 0x3;
+    this.sortValue = (passCount << 30 | pixelShader << 20 | vertexShader << 10 | renderStates) >>> 0;
+  }
+
+  /** Whether this shader accesses vertex buffers in RT shadow mode. */
+  HasVertexBufferAccessInRtShadow() {
+    return this.hasVertexBufferAccessInRtShadow;
+  }
+
+  /**
+   * Construct a canonical shader graph from JS/JSON model values.
+   *
+   * @param {object} values Canonical model values.
+   * @param {object} options CjsModel import options.
+   * @returns {Tr2Shader} Hydrated shader graph.
+   */
+  static from(values = {}, options = {}) {
+    let normalized = values;
+    if (values?.effect && !(values.effect instanceof Tr2EffectDescription)) {
+      normalized = {
+        ...values,
+        effect: Tr2EffectDescription.from(values.effect, options)
+      };
+    }
+    const shader = super.from(normalized, options);
+    if (!Object.hasOwn(values ?? {}, "sortValue")) {
+      shader.ProcessEffect();
+    }
+    return shader;
+  }
+
+  /**
+   * Build one canonical GPU-free shader from complete portable reflection.
+   * Each child reflection class owns conversion of its own portable record.
+   *
+   * @param {object} portable Portable effect-body reflection.
+   * @returns {Tr2Shader} Canonical selected shader.
+   */
+  static fromPortable(portable) {
+    validateEffectBodyReflection(portable);
+    const shader = new this();
+    shader.effect = Tr2EffectDescription.fromPortable(portable.effect);
+    shader.ProcessEffect();
+    return shader;
+  }
+
+  /**
+   * Whether a value has the supported complete portable-reflection envelope.
+   *
+   * @param {*} value Candidate value.
+   * @returns {boolean} Whether the portable envelope is supported.
+   */
+  static isPortableReflection(value) {
+    return isEffectBodyReflection(value);
+  }
+
+  /** Find one named reflection entry across every stage. */
+  static findStageValue(effect, name, key) {
+    for (const stage of Tr2Shader.iterateStages(effect)) {
+      const found = Tr2Shader.findNamedCollectionValue(stage?.[key], name);
+      if (found) {
+        return found;
+      }
+    }
+    return null;
+  }
+
+  /** Flatten pass stage inputs in Carbon lookup order. */
+  static iterateStages(effect) {
+    const stages = [];
+    for (const technique of effect?.techniques ?? []) {
+      for (const pass of technique?.passes ?? []) {
+        stages.push(...(pass?.stageInputs ?? []));
+      }
+    }
+    return stages;
+  }
+
+  /** Find a named entry in an array, Map, or plain object collection. */
+  static findNamedCollectionValue(values, name) {
+    if (!values) {
+      return null;
+    }
+    if (Array.isArray(values)) {
+      return values.find(value => value?.name === name || value?.[1]?.name === name) ?? null;
+    }
+    if (values instanceof Map) {
+      for (const value of values.values()) {
+        if (value?.name === name) {
+          return value;
+        }
+      }
+      return null;
+    }
+    for (const value of Object.values(values)) {
+      if (value?.name === name) {
+        return value;
+      }
+    }
+    return null;
+  }
+
+  /** Resolve a parameter's annotations from a Map, array, or plain object. */
+  static findAnnotationSet(annotations, parameterName) {
+    if (!annotations) {
+      return null;
+    }
+    if (annotations instanceof Map) {
+      return annotations.get(parameterName) ?? null;
+    }
+    if (Array.isArray(annotations)) {
+      const entry = annotations.find(item => item?.name === parameterName || item?.[0] === parameterName);
+      return entry?.annotations ?? entry?.value ?? entry?.[1] ?? null;
+    }
+    return annotations[parameterName] ?? null;
+  }
+}
+
+// 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(Tr2Shader, {
+  className: "Tr2Shader",
+  family: "shader"
+});
+CjsSchema.decorateField(Tr2Shader, "sortValue", type.uint32);
+CjsSchema.decorateField(Tr2Shader, "effect", type.rawStruct("Tr2EffectDescription"));
+CjsSchema.decorateField(Tr2Shader, "hasVertexBufferAccessInRtShadow", type.boolean);
+CjsSchema.decorateMethod(Tr2Shader, "GetTechniqueIndex", carbon.method, impl.adapted, impl.reason("Carbon returns success through a bool plus output index; CarbonEngineJS returns the index directly or -1 while preserving exact name lookup."));
+CjsSchema.decorateMethod(Tr2Shader, "GetPassCount", carbon.method, impl.adapted, impl.reason("Carbon assumes an already-validated technique index; CarbonEngineJS safely returns zero for an unavailable index."));
+CjsSchema.decorateMethod(Tr2Shader, "GetConstant", carbon.method, impl.implemented);
+CjsSchema.decorateMethod(Tr2Shader, "GetResource", carbon.method, impl.implemented);
+CjsSchema.decorateMethod(Tr2Shader, "GetParameterAnnotations", carbon.method, impl.implemented);
+CjsSchema.decorateMethod(Tr2Shader, "GetSortValue", carbon.method, impl.implemented);
+CjsSchema.decorateMethod(Tr2Shader, "GetEffectDescription", carbon.method, impl.implemented);
+CjsSchema.decorateMethod(Tr2Shader, "GetEffect", carbon.method, impl.implemented);
+CjsSchema.decorateMethod(Tr2Shader, "GetShaderTypeMask", carbon.method, impl.adapted, impl.reason("Carbon assumes an already-validated technique index; CarbonEngineJS safely returns zero for an unavailable index."));
+CjsSchema.decorateMethod(Tr2Shader, "ProcessEffect", carbon.method, impl.adapted, impl.reason("Carbon packs renderer handles assigned while reading; the device-free graph leaves the sort key zero until an engine assigns valid handles."));
+CjsSchema.decorateMethod(Tr2Shader, "HasVertexBufferAccessInRtShadow", carbon.method, impl.implemented);
+
+export { Tr2Shader };
+//# sourceMappingURL=Tr2Shader.js.map

package/dist/resource/shader/Tr2Shader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Tr2Shader.js","sources":["../../../../src/resource/shader/Tr2Shader.js"],"sourcesContent":["// Source: trinity/trinity/Shader/Tr2Shader.h\n// Source: trinity/trinity/Shader/Tr2Shader.cpp\nimport { CjsSchema, carbon, impl, type } from \"@carbonenginejs/runtime-utils/schema\";\nimport { CjsModel } from \"@carbonenginejs/runtime-utils/model\";\nimport {\n  isEffectBodyReflection,\n  validateEffectBodyReflection\n} from \"../../formats/hlsl/portable.js\";\nimport { Tr2EffectDescription } from \"./reflection/Tr2EffectDescription.js\";\n\n/** GPU-free selected shader and its complete source reflection graph. */\nexport class Tr2Shader extends CjsModel\n{\n\n  /** m_sortValue (unsigned int) */\n  sortValue = 0;\n\n  /** m_effect (Tr2EffectDescription) */\n  effect = new Tr2EffectDescription();\n\n  /** m_hasVertexBufferAccessInRtShadow (bool) */\n  hasVertexBufferAccessInRtShadow = false;\n\n  /**\n   * Index of the named technique; 0 for Carbon's empty-string any-technique\n   * sentinel and -1 when the shader has no techniques or the name is unknown.\n   */\n  GetTechniqueIndex(name = \"Main\")\n  {\n    const techniques = this.effect?.techniques ?? [];\n    if (!techniques.length)\n    {\n      return -1;\n    }\n    if (name === \"\")\n    {\n      return 0;\n    }\n    return techniques.findIndex(technique => technique?.name === name);\n  }\n\n  /** Number of passes in a technique; 0 for an unknown index. */\n  GetPassCount(techniqueIndex = 0)\n  {\n    return this.effect?.techniques?.[techniqueIndex]?.passes?.length ?? 0;\n  }\n\n  /**\n   * The reflected constant of this name from any stage of any pass, or null;\n   * the description is metadata, not a bound GPU slot.\n   */\n  GetConstant(name)\n  {\n    return Tr2Shader.findStageValue(this.effect, name, \"constants\");\n  }\n\n  /**\n   * The reflected resource of this name, searching stage resources before\n   * UAVs; null when neither has it.\n   */\n  GetResource(name)\n  {\n    for (const stage of Tr2Shader.iterateStages(this.effect))\n    {\n      const resource = Tr2Shader.findNamedCollectionValue(\n        stage?.resources,\n        name\n      );\n      if (resource)\n      {\n        return resource;\n      }\n      const uav = Tr2Shader.findNamedCollectionValue(stage?.uavs, name);\n      if (uav)\n      {\n        return uav;\n      }\n    }\n    return null;\n  }\n\n  /**\n   * The annotation set authored for a parameter name, or null; the shape\n   * depends on the reflection source.\n   */\n  GetParameterAnnotations(parameterName)\n  {\n    return Tr2Shader.findAnnotationSet(\n      this.effect?.annotations,\n      parameterName\n    );\n  }\n\n  /** The packed draw-sort key; 0 until ProcessEffect has run. */\n  GetSortValue()\n  {\n    return this.sortValue;\n  }\n\n  /** The reflected effect description, by reference rather than copy. */\n  GetEffectDescription()\n  {\n    return this.effect;\n  }\n\n  /** The same object GetEffectDescription returns. */\n  GetEffect()\n  {\n    return this.effect;\n  }\n\n  /** The technique's bitmask of shader stages, or 0 for an unknown index. */\n  GetShaderTypeMask(techniqueIndex = 0)\n  {\n    return Number(\n      this.effect?.techniques?.[techniqueIndex]?.shaderTypeMask ?? 0\n    );\n  }\n\n  /**\n   * Pack the first technique/pass's renderer handles into Carbon's sort key.\n   * A device-free source graph retains 0 while its handles remain invalid.\n   */\n  ProcessEffect()\n  {\n    this.sortValue = 0;\n    const pass = this.effect?.techniques?.[0]?.passes?.[0];\n    if (!pass)\n    {\n      return;\n    }\n    const stages = pass.stageInputs ?? [];\n    const pixelHandle = Number(\n      stages[1]?.shader ?? stages[1]?.m_shader ?? 0xffffffff\n    );\n    const vertexHandle = Number(\n      stages[0]?.shader ?? stages[0]?.m_shader ?? 0xffffffff\n    );\n    if (pixelHandle === 0xffffffff || vertexHandle === 0xffffffff)\n    {\n      return;\n    }\n    const pixelShader = pixelHandle & 0x3ff;\n    const vertexShader = vertexHandle & 0x3ff;\n    const renderStates = Number(pass.renderStates ?? 0) & 0x3ff;\n    const passCount = Number(\n      this.effect?.techniques?.[0]?.passes?.length ?? 0\n    ) & 0x3;\n    this.sortValue = (\n      (passCount << 30)\n      | (pixelShader << 20)\n      | (vertexShader << 10)\n      | renderStates\n    ) >>> 0;\n  }\n\n  /** Whether this shader accesses vertex buffers in RT shadow mode. */\n  HasVertexBufferAccessInRtShadow()\n  {\n    return this.hasVertexBufferAccessInRtShadow;\n  }\n\n  /**\n   * Construct a canonical shader graph from JS/JSON model values.\n   *\n   * @param {object} values Canonical model values.\n   * @param {object} options CjsModel import options.\n   * @returns {Tr2Shader} Hydrated shader graph.\n   */\n  static from(values = {}, options = {})\n  {\n    let normalized = values;\n    if (values?.effect\n      && !(values.effect instanceof Tr2EffectDescription))\n    {\n      normalized = {\n        ...values,\n        effect: Tr2EffectDescription.from(values.effect, options)\n      };\n    }\n    const shader = super.from(normalized, options);\n    if (!Object.hasOwn(values ?? {}, \"sortValue\"))\n    {\n      shader.ProcessEffect();\n    }\n    return shader;\n  }\n\n  /**\n   * Build one canonical GPU-free shader from complete portable reflection.\n   * Each child reflection class owns conversion of its own portable record.\n   *\n   * @param {object} portable Portable effect-body reflection.\n   * @returns {Tr2Shader} Canonical selected shader.\n   */\n  static fromPortable(portable)\n  {\n    validateEffectBodyReflection(portable);\n\n    const shader = new this();\n    shader.effect = Tr2EffectDescription.fromPortable(portable.effect);\n    shader.ProcessEffect();\n    return shader;\n  }\n\n  /**\n   * Whether a value has the supported complete portable-reflection envelope.\n   *\n   * @param {*} value Candidate value.\n   * @returns {boolean} Whether the portable envelope is supported.\n   */\n  static isPortableReflection(value)\n  {\n    return isEffectBodyReflection(value);\n  }\n\n  /** Find one named reflection entry across every stage. */\n  static findStageValue(effect, name, key)\n  {\n    for (const stage of Tr2Shader.iterateStages(effect))\n    {\n      const found = Tr2Shader.findNamedCollectionValue(stage?.[key], name);\n      if (found)\n      {\n        return found;\n      }\n    }\n    return null;\n  }\n\n  /** Flatten pass stage inputs in Carbon lookup order. */\n  static iterateStages(effect)\n  {\n    const stages = [];\n    for (const technique of effect?.techniques ?? [])\n    {\n      for (const pass of technique?.passes ?? [])\n      {\n        stages.push(...pass?.stageInputs ?? []);\n      }\n    }\n    return stages;\n  }\n\n  /** Find a named entry in an array, Map, or plain object collection. */\n  static findNamedCollectionValue(values, name)\n  {\n    if (!values)\n    {\n      return null;\n    }\n    if (Array.isArray(values))\n    {\n      return values.find(\n        value => value?.name === name || value?.[1]?.name === name\n      ) ?? null;\n    }\n    if (values instanceof Map)\n    {\n      for (const value of values.values())\n      {\n        if (value?.name === name)\n        {\n          return value;\n        }\n      }\n      return null;\n    }\n    for (const value of Object.values(values))\n    {\n      if (value?.name === name)\n      {\n        return value;\n      }\n    }\n    return null;\n  }\n\n  /** Resolve a parameter's annotations from a Map, array, or plain object. */\n  static findAnnotationSet(annotations, parameterName)\n  {\n    if (!annotations)\n    {\n      return null;\n    }\n    if (annotations instanceof Map)\n    {\n      return annotations.get(parameterName) ?? null;\n    }\n    if (Array.isArray(annotations))\n    {\n      const entry = annotations.find(\n        item => item?.name === parameterName\n          || item?.[0] === parameterName\n      );\n      return entry?.annotations ?? entry?.value ?? entry?.[1] ?? null;\n    }\n    return annotations[parameterName] ?? null;\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(Tr2Shader, {\n  className: \"Tr2Shader\",\n  family: \"shader\"\n});\nCjsSchema.decorateField(Tr2Shader, \"sortValue\", type.uint32);\nCjsSchema.decorateField(Tr2Shader, \"effect\", type.rawStruct(\"Tr2EffectDescription\"));\nCjsSchema.decorateField(Tr2Shader, \"hasVertexBufferAccessInRtShadow\", type.boolean);\nCjsSchema.decorateMethod(Tr2Shader, \"GetTechniqueIndex\", carbon.method, impl.adapted, impl.reason(\"Carbon returns success through a bool plus output index; CarbonEngineJS returns the index directly or -1 while preserving exact name lookup.\"));\nCjsSchema.decorateMethod(Tr2Shader, \"GetPassCount\", carbon.method, impl.adapted, impl.reason(\"Carbon assumes an already-validated technique index; CarbonEngineJS safely returns zero for an unavailable index.\"));\nCjsSchema.decorateMethod(Tr2Shader, \"GetConstant\", carbon.method, impl.implemented);\nCjsSchema.decorateMethod(Tr2Shader, \"GetResource\", carbon.method, impl.implemented);\nCjsSchema.decorateMethod(Tr2Shader, \"GetParameterAnnotations\", carbon.method, impl.implemented);\nCjsSchema.decorateMethod(Tr2Shader, \"GetSortValue\", carbon.method, impl.implemented);\nCjsSchema.decorateMethod(Tr2Shader, \"GetEffectDescription\", carbon.method, impl.implemented);\nCjsSchema.decorateMethod(Tr2Shader, \"GetEffect\", carbon.method, impl.implemented);\nCjsSchema.decorateMethod(Tr2Shader, \"GetShaderTypeMask\", carbon.method, impl.adapted, impl.reason(\"Carbon assumes an already-validated technique index; CarbonEngineJS safely returns zero for an unavailable index.\"));\nCjsSchema.decorateMethod(Tr2Shader, \"ProcessEffect\", carbon.method, impl.adapted, impl.reason(\"Carbon packs renderer handles assigned while reading; the device-free graph leaves the sort key zero until an engine assigns valid handles.\"));\nCjsSchema.decorateMethod(Tr2Shader, \"HasVertexBufferAccessInRtShadow\", carbon.method, impl.implemented);\n"],"names":["Tr2Shader","CjsModel","sortValue","effect","Tr2EffectDescription","hasVertexBufferAccessInRtShadow","GetTechniqueIndex","name","techniques","length","findIndex","technique","GetPassCount","techniqueIndex","passes","GetConstant","findStageValue","GetResource","stage","iterateStages","resource","findNamedCollectionValue","resources","uav","uavs","GetParameterAnnotations","parameterName","findAnnotationSet","annotations","GetSortValue","GetEffectDescription","GetEffect","GetShaderTypeMask","Number","shaderTypeMask","ProcessEffect","pass","stages","stageInputs","pixelHandle","shader","m_shader","vertexHandle","pixelShader","vertexShader","renderStates","passCount","HasVertexBufferAccessInRtShadow","from","values","options","normalized","Object","hasOwn","fromPortable","portable","validateEffectBodyReflection","isPortableReflection","value","isEffectBodyReflection","key","found","push","Array","isArray","find","Map","get","entry","item","CjsSchema","define","className","family","decorateField","type","uint32","rawStruct","boolean","decorateMethod","carbon","method","impl","adapted","reason","implemented"],"mappings":"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"}

package/dist/resource/shader/Tr2ShaderPermutation.js

@@ -0,0 +1,47 @@
+import { CjsSchema, type } from '@carbonenginejs/runtime-utils/schema';
+import { CjsModel } from '@carbonenginejs/runtime-utils/model';
+
+// Source: trinity/trinity/Resources/Tr2EffectRes.h
+// Schema: format-carbon resources/Tr2ShaderPermutation.json; maintained by runtime-resource.
+
+/**
+ * Describes one authored effect permutation and the option values a shader
+ * resolver may select.
+ *
+ * This is resource metadata only. Backend shader compilation and pipeline
+ * realization remain engine responsibilities.
+ */
+class Tr2ShaderPermutation extends CjsModel {
+  /** Authored permutation name. */
+  name = "";
+
+  /** Ordered option names accepted by the permutation. */
+  options = [];
+
+  /** Index of the option selected when a caller supplies no override. */
+  defaultOption = 0;
+
+  /** Human-readable description retained from the effect resource. */
+  description = "";
+
+  /** Carbon permutation category value. */
+  type = 0;
+}
+
+// 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(Tr2ShaderPermutation, {
+  className: "Tr2ShaderPermutation",
+  family: "resources"
+});
+CjsSchema.decorateField(Tr2ShaderPermutation, "name", type.string);
+CjsSchema.decorateField(Tr2ShaderPermutation, "options", type.list("BlueSharedString"));
+CjsSchema.decorateField(Tr2ShaderPermutation, "defaultOption", type.uint64);
+CjsSchema.decorateField(Tr2ShaderPermutation, "description", type.string);
+CjsSchema.decorateField(Tr2ShaderPermutation, "type", type.uint8);
+
+export { Tr2ShaderPermutation };
+//# sourceMappingURL=Tr2ShaderPermutation.js.map

package/dist/resource/shader/Tr2ShaderPermutation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Tr2ShaderPermutation.js","sources":["../../../../src/resource/shader/Tr2ShaderPermutation.js"],"sourcesContent":["// Source: trinity/trinity/Resources/Tr2EffectRes.h\r\n// Schema: format-carbon resources/Tr2ShaderPermutation.json; maintained by runtime-resource.\r\nimport { CjsSchema, type } from \"@carbonenginejs/runtime-utils/schema\";\r\nimport { CjsModel } from \"@carbonenginejs/runtime-utils/model\";\r\n\r\n/**\r\n * Describes one authored effect permutation and the option values a shader\r\n * resolver may select.\r\n *\r\n * This is resource metadata only. Backend shader compilation and pipeline\r\n * realization remain engine responsibilities.\r\n */\r\nexport class Tr2ShaderPermutation extends CjsModel\r\n{\r\n\r\n  /** Authored permutation name. */\r\n  name = \"\";\r\n\r\n  /** Ordered option names accepted by the permutation. */\r\n  options = [];\r\n\r\n  /** Index of the option selected when a caller supplies no override. */\r\n  defaultOption = 0;\r\n\r\n  /** Human-readable description retained from the effect resource. */\r\n  description = \"\";\r\n\r\n  /** Carbon permutation category value. */\r\n  type = 0;\r\n\r\n}\r\n\r\n// Declared imperatively rather than with decorators, so this module stays\r\n// plain ESM that loads from source without a transform. The decorator\r\n// expressions are reused verbatim, so the registered metadata is identical.\r\n// Statics belong in `methods`: decorateMethod targets the prototype and\r\n// would register a static as an instance field.\r\nCjsSchema.define(Tr2ShaderPermutation, {\r\n  className: \"Tr2ShaderPermutation\",\r\n  family: \"resources\"\r\n});\r\nCjsSchema.decorateField(Tr2ShaderPermutation, \"name\", type.string);\r\nCjsSchema.decorateField(Tr2ShaderPermutation, \"options\", type.list(\"BlueSharedString\"));\r\nCjsSchema.decorateField(Tr2ShaderPermutation, \"defaultOption\", type.uint64);\r\nCjsSchema.decorateField(Tr2ShaderPermutation, \"description\", type.string);\r\nCjsSchema.decorateField(Tr2ShaderPermutation, \"type\", type.uint8);\r\n"],"names":["Tr2ShaderPermutation","CjsModel","name","options","defaultOption","description","type","CjsSchema","define","className","family","decorateField","string","list","uint64","uint8"],"mappings":";;;AAAA;AACA;;AAIA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,MAAMA,oBAAoB,SAASC,QAAQ,CAClD;AAEE;AACAC,EAAAA,IAAI,GAAG,EAAE;;AAET;AACAC,EAAAA,OAAO,GAAG,EAAE;;AAEZ;AACAC,EAAAA,aAAa,GAAG,CAAC;;AAEjB;AACAC,EAAAA,WAAW,GAAG,EAAE;;AAEhB;AACAC,EAAAA,IAAI,GAAG,CAAC;AAEV;;AAEA;AACA;AACA;AACA;AACA;AACAC,SAAS,CAACC,MAAM,CAACR,oBAAoB,EAAE;AACrCS,EAAAA,SAAS,EAAE,sBAAsB;AACjCC,EAAAA,MAAM,EAAE;AACV,CAAC,CAAC;AACFH,SAAS,CAACI,aAAa,CAACX,oBAAoB,EAAE,MAAM,EAAEM,IAAI,CAACM,MAAM,CAAC;AAClEL,SAAS,CAACI,aAAa,CAACX,oBAAoB,EAAE,SAAS,EAAEM,IAAI,CAACO,IAAI,CAAC,kBAAkB,CAAC,CAAC;AACvFN,SAAS,CAACI,aAAa,CAACX,oBAAoB,EAAE,eAAe,EAAEM,IAAI,CAACQ,MAAM,CAAC;AAC3EP,SAAS,CAACI,aAAa,CAACX,oBAAoB,EAAE,aAAa,EAAEM,IAAI,CAACM,MAAM,CAAC;AACzEL,SAAS,CAACI,aAAa,CAACX,oBAAoB,EAAE,MAAM,EAAEM,IAAI,CAACS,KAAK,CAAC;;;;"}

package/dist/resource/shader/index.js

@@ -0,0 +1,17 @@
+export { GetGlobalEffectOptions, ModifyGlobalEffectOptions, Tr2EffectRes } from './Tr2EffectRes.js';
+export { Tr2MaterialArea } from './Tr2MaterialArea.js';
+export { Tr2MaterialMesh } from './Tr2MaterialMesh.js';
+export { Tr2MaterialRes } from './Tr2MaterialRes.js';
+export { Tr2Shader } from './Tr2Shader.js';
+export { Tr2ShaderPermutation } from './Tr2ShaderPermutation.js';
+export { Tr2EffectConstant } from './reflection/Tr2EffectConstant.js';
+export { Tr2EffectDefine } from './reflection/Tr2EffectDefine.js';
+export { Tr2EffectDescription } from './reflection/Tr2EffectDescription.js';
+export { Tr2EffectLibrary } from './reflection/Tr2EffectLibrary.js';
+export { Tr2EffectParameterAnnotation } from './reflection/Tr2EffectParameterAnnotation.js';
+export { Tr2EffectResource } from './reflection/Tr2EffectResource.js';
+export { Tr2EffectStageInput } from './reflection/Tr2EffectStageInput.js';
+export { Tr2EffectTechnique } from './reflection/Tr2EffectTechnique.js';
+export { Tr2Pass } from './reflection/Tr2Pass.js';
+export { Tr2SamplerSetup } from './sampler/Tr2SamplerSetup.js';
+//# sourceMappingURL=index.js.map

package/dist/resource/shader/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;"}

package/dist/resource/shader/portable.js

@@ -0,0 +1,33 @@
+import { copyBytes } from '@carbonenginejs/runtime-utils/bytes';
+import { isUint32, isPlainObject } from '@carbonenginejs/runtime-utils/is';
+import { cloneCarbonValue } from '@carbonenginejs/runtime-utils/types';
+
+/** Require one of Carbon's six authored shader-stage indices. */
+function requirePortableStageType(value) {
+  if (!isUint32(value)) {
+    throw new RangeError("Portable shader stage type must fit uint32");
+  }
+  if (value >= 6) {
+    throw new RangeError("Portable shader stage type must be in [0, 5]");
+  }
+  return value;
+}
+
+/** Clone and validate one owned source-program payload. */
+function clonePortableSourceProgram(value, expectedKind) {
+  if (!isPlainObject(value)) {
+    throw new TypeError(`Portable ${expectedKind} source program must be an object`);
+  }
+  if (value.kind !== expectedKind) {
+    throw new Error(`Portable source program kind "${value.kind}" is not "${expectedKind}"`);
+  }
+  if (!(value.bytes instanceof Uint8Array)) {
+    throw new TypeError(`Portable ${expectedKind} source program must be Uint8Array bytes`);
+  }
+  const result = cloneCarbonValue(value);
+  result.bytes = copyBytes(value.bytes);
+  return result;
+}
+
+export { clonePortableSourceProgram, requirePortableStageType };
+//# sourceMappingURL=portable.js.map

package/dist/resource/shader/portable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"portable.js","sources":["../../../../src/resource/shader/portable.js"],"sourcesContent":["import { copyBytes } from \"@carbonenginejs/runtime-utils/bytes\";\nimport {\n  isPlainObject,\n  isUint32\n} from \"@carbonenginejs/runtime-utils/is\";\nimport { cloneCarbonValue } from \"@carbonenginejs/runtime-utils/types\";\n\n/** Require one of Carbon's six authored shader-stage indices. */\nexport function requirePortableStageType(value)\n{\n  if (!isUint32(value))\n  {\n    throw new RangeError(\"Portable shader stage type must fit uint32\");\n  }\n  if (value >= 6)\n  {\n    throw new RangeError(\"Portable shader stage type must be in [0, 5]\");\n  }\n  return value;\n}\n\n/** Clone and validate one owned source-program payload. */\nexport function clonePortableSourceProgram(value, expectedKind)\n{\n  if (!isPlainObject(value))\n  {\n    throw new TypeError(\n      `Portable ${expectedKind} source program must be an object`\n    );\n  }\n  if (value.kind !== expectedKind)\n  {\n    throw new Error(\n      `Portable source program kind \"${value.kind}\" is not \"${expectedKind}\"`\n    );\n  }\n  if (!(value.bytes instanceof Uint8Array))\n  {\n    throw new TypeError(\n      `Portable ${expectedKind} source program must be Uint8Array bytes`\n    );\n  }\n\n  const result = cloneCarbonValue(value);\n  result.bytes = copyBytes(value.bytes);\n  return result;\n}\n"],"names":["requirePortableStageType","value","isUint32","RangeError","clonePortableSourceProgram","expectedKind","isPlainObject","TypeError","kind","Error","bytes","Uint8Array","result","cloneCarbonValue","copyBytes"],"mappings":";;;;AAOA;AACO,SAASA,wBAAwBA,CAACC,KAAK,EAC9C;AACE,EAAA,IAAI,CAACC,QAAQ,CAACD,KAAK,CAAC,EACpB;AACE,IAAA,MAAM,IAAIE,UAAU,CAAC,4CAA4C,CAAC;AACpE,EAAA;EACA,IAAIF,KAAK,IAAI,CAAC,EACd;AACE,IAAA,MAAM,IAAIE,UAAU,CAAC,8CAA8C,CAAC;AACtE,EAAA;AACA,EAAA,OAAOF,KAAK;AACd;;AAEA;AACO,SAASG,0BAA0BA,CAACH,KAAK,EAAEI,YAAY,EAC9D;AACE,EAAA,IAAI,CAACC,aAAa,CAACL,KAAK,CAAC,EACzB;AACE,IAAA,MAAM,IAAIM,SAAS,CACjB,CAAA,SAAA,EAAYF,YAAY,mCAC1B,CAAC;AACH,EAAA;AACA,EAAA,IAAIJ,KAAK,CAACO,IAAI,KAAKH,YAAY,EAC/B;IACE,MAAM,IAAII,KAAK,CACb,CAAA,8BAAA,EAAiCR,KAAK,CAACO,IAAI,CAAA,UAAA,EAAaH,YAAY,CAAA,CAAA,CACtE,CAAC;AACH,EAAA;AACA,EAAA,IAAI,EAAEJ,KAAK,CAACS,KAAK,YAAYC,UAAU,CAAC,EACxC;AACE,IAAA,MAAM,IAAIJ,SAAS,CACjB,CAAA,SAAA,EAAYF,YAAY,0CAC1B,CAAC;AACH,EAAA;AAEA,EAAA,MAAMO,MAAM,GAAGC,gBAAgB,CAACZ,KAAK,CAAC;EACtCW,MAAM,CAACF,KAAK,GAAGI,SAAS,CAACb,KAAK,CAACS,KAAK,CAAC;AACrC,EAAA,OAAOE,MAAM;AACf;;;;"}

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

@@ -0,0 +1,135 @@
+import { CjsSchema } from '@carbonenginejs/runtime-utils/schema';
+import { CjsModel } from '@carbonenginejs/runtime-utils/model';
+import { isPlainObject, isUint32 } from '@carbonenginejs/runtime-utils/is';
+
+// Source: trinity/trinity/Shader/Tr2EffectDescription.h
+
+/** Reflected shader constant metadata. */
+class Tr2EffectConstant extends CjsModel {
+  /** name (BlueSharedString) */
+  name = "";
+
+  /** offset (unsigned) */
+  offset = 0;
+
+  /** size (unsigned) */
+  size = 0;
+
+  /** type (Type - enum Type) */
+  type = 0;
+
+  /** dimension (unsigned) */
+  dimension = 0;
+
+  /** elements (unsigned) */
+  elements = 0;
+
+  /** isSRGB (bool) */
+  isSRGB = false;
+
+  /** isAutoregister (bool) */
+  isAutoregister = 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;
+  }
+  static Type = Object.freeze({
+    FLOAT: 0,
+    INT: 1,
+    UINT: 2,
+    BOOL: 3,
+    OTHER: 4
+  });
+}
+
+// Declared imperatively rather than with decorators, so this module stays plain
+// ESM that loads from source without a transform, which lets its tests import
+// source instead of build output.
+//
+// Field order matters: it drives GetValues() export order. Statics belong in
+// `methods` here rather than in a decorateMethod() call, which targets the
+// prototype and would register a static as an instance field.
+CjsSchema.define(Tr2EffectConstant, {
+  className: "Tr2EffectConstant",
+  family: "shader",
+  fields: [{
+    name: "name",
+    type: {
+      kind: "string"
+    }
+  }, {
+    name: "offset",
+    type: {
+      kind: "uint32"
+    }
+  }, {
+    name: "size",
+    type: {
+      kind: "uint32"
+    }
+  }, {
+    name: "type",
+    enum: {
+      enumType: "Type"
+    },
+    type: {
+      kind: "int32"
+    }
+  }, {
+    name: "dimension",
+    type: {
+      kind: "uint32"
+    }
+  }, {
+    name: "elements",
+    type: {
+      kind: "uint32"
+    }
+  }, {
+    name: "isSRGB",
+    type: {
+      kind: "boolean"
+    }
+  }, {
+    name: "isAutoregister",
+    type: {
+      kind: "boolean"
+    }
+  }]
+});
+
+export { 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 { CjsSchema } 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. */\nexport class Tr2EffectConstant extends CjsModel\n{\n\n  /** name (BlueSharedString) */\n  name = \"\";\n\n  /** offset (unsigned) */\n  offset = 0;\n\n  /** size (unsigned) */\n  size = 0;\n\n  /** type (Type - enum Type) */\n  type = 0;\n\n  /** dimension (unsigned) */\n  dimension = 0;\n\n  /** elements (unsigned) */\n  elements = 0;\n\n  /** isSRGB (bool) */\n  isSRGB = false;\n\n  /** isAutoregister (bool) */\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  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\n// Declared imperatively rather than with decorators, so this module stays plain\n// ESM that loads from source without a transform, which lets its tests import\n// source instead of build output.\n//\n// Field order matters: it drives GetValues() export order. Statics belong in\n// `methods` here rather than in a decorateMethod() call, which targets the\n// prototype and would register a static as an instance field.\nCjsSchema.define(Tr2EffectConstant, {\n  className: \"Tr2EffectConstant\",\n  family: \"shader\",\n  fields: [\n    { name: \"name\", type: { kind: \"string\" } },\n    { name: \"offset\", type: { kind: \"uint32\" } },\n    { name: \"size\", type: { kind: \"uint32\" } },\n    { name: \"type\", enum: { enumType: \"Type\" }, type: { kind: \"int32\" } },\n    { name: \"dimension\", type: { kind: \"uint32\" } },\n    { name: \"elements\", type: { kind: \"uint32\" } },\n    { name: \"isSRGB\", type: { kind: \"boolean\" } },\n    { name: \"isAutoregister\", type: { kind: \"boolean\" } }\n  ]\n});\n"],"names":["Tr2EffectConstant","CjsModel","name","offset","size","type","dimension","elements","isSRGB","isAutoregister","fromPortable","value","isPlainObject","TypeError","isUint32","RangeError","constant","String","Type","Object","freeze","FLOAT","INT","UINT","BOOL","OTHER","CjsSchema","define","className","family","fields","kind","enum","enumType"],"mappings":"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"}

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

@@ -0,0 +1,28 @@
+import { CjsSchema, type } from '@carbonenginejs/runtime-utils/schema';
+import { CjsModel } from '@carbonenginejs/runtime-utils/model';
+
+// Source: trinity/trinity/Shader/Tr2EffectDescription.h
+
+/** Effect compile define retained as source metadata. */
+class Tr2EffectDefine extends CjsModel {
+  /** name (const char*) */
+  name = "";
+
+  /** value (const char*) */
+  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(Tr2EffectDefine, {
+  className: "Tr2EffectDefine",
+  family: "shader"
+});
+CjsSchema.decorateField(Tr2EffectDefine, "name", type.string);
+CjsSchema.decorateField(Tr2EffectDefine, "value", type.string);
+
+export { 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 { CjsSchema, type } from \"@carbonenginejs/runtime-utils/schema\";\nimport { CjsModel } from \"@carbonenginejs/runtime-utils/model\";\n\n/** Effect compile define retained as source metadata. */\nexport class Tr2EffectDefine extends CjsModel\n{\n\n  /** name (const char*) */\n  name = \"\";\n\n  /** value (const char*) */\n  value = \"\";\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(Tr2EffectDefine, {\n  className: \"Tr2EffectDefine\",\n  family: \"shader\"\n});\nCjsSchema.decorateField(Tr2EffectDefine, \"name\", type.string);\nCjsSchema.decorateField(Tr2EffectDefine, \"value\", type.string);\n"],"names":["Tr2EffectDefine","CjsModel","name","value","CjsSchema","define","className","family","decorateField","type","string"],"mappings":";;;AAAA;;AAIA;AACO,MAAMA,eAAe,SAASC,QAAQ,CAC7C;AAEE;AACAC,EAAAA,IAAI,GAAG,EAAE;;AAET;AACAC,EAAAA,KAAK,GAAG,EAAE;AAEZ;;AAEA;AACA;AACA;AACA;AACA;AACAC,SAAS,CAACC,MAAM,CAACL,eAAe,EAAE;AAChCM,EAAAA,SAAS,EAAE,iBAAiB;AAC5BC,EAAAA,MAAM,EAAE;AACV,CAAC,CAAC;AACFH,SAAS,CAACI,aAAa,CAACR,eAAe,EAAE,MAAM,EAAES,IAAI,CAACC,MAAM,CAAC;AAC7DN,SAAS,CAACI,aAAa,CAACR,eAAe,EAAE,OAAO,EAAES,IAAI,CAACC,MAAM,CAAC;;;;"}