@carbonenginejs/runtime-resource 0.13.0 → 0.14.0

package/dist/formats/hlsl/core/tr2/shader/HlslShader.js

@@ -1,220 +1,220 @@
-import { HlslRenderContextEnum } from '../HlslRenderContextEnum.js';
-import { HlslEffectDescription, ANY_TECHNIQUE } from './HlslEffectDescription.js';
-
-/**
- * Trinity shader wrapper around a decoded `HlslEffectDescription`.
- */
-class HlslShader {
-  /**
-  * Creates an empty shader wrapper.
-  */
-  constructor() {
-    this.m_sortValue = 0;
-    this.m_effect = new HlslEffectDescription();
-    this.m_hasVertexBufferAccessInRtShadow = false;
-  }
-
-  /**
-  * Finds a technique index by name, or returns the first technique for `ANY_TECHNIQUE`.
-  *
-  * @param {string} [name] Technique name to locate.
-  * @returns {number} Technique index, or -1 when missing.
-  */
-  GetTechniqueIndex(name = ANY_TECHNIQUE) {
-    if (!this.m_effect.techniques.length) {
-      return -1;
-    }
-    if (name === ANY_TECHNIQUE || name === null || name === undefined) {
-      return 0;
-    }
-    return this.m_effect.techniques.findIndex(technique => technique.name === name);
-  }
-
-  /**
-  * Returns the number of passes in a decoded technique.
-  *
-  * @param {number} techniqueIndex Technique index.
-  * @returns {number} Pass count.
-  */
-  GetPassCount(techniqueIndex) {
-    const technique = this.m_effect.techniques[techniqueIndex];
-    return technique ? technique.passes.length : 0;
-  }
-
-  /**
-  * Applies shader program and render-state handles for one pass to a render context.
-  *
-  * @param {number} techniqueIndex Technique index.
-  * @param {number} passIndex Pass index.
-  * @param {object} renderContext Render context with an `m_esm` state manager.
-  * @returns {boolean} True when the pass existed.
-  */
-  ApplyAllStateForPass(techniqueIndex, passIndex, renderContext) {
-    const pass = this.m_effect.techniques[techniqueIndex]?.passes?.[passIndex];
-    if (!pass) return false;
-    renderContext?.m_esm?.ApplyShaderProgram?.(pass.shaderProgram);
-    renderContext?.m_esm?.ApplyRenderStates?.(pass.renderStates);
-    return true;
-  }
-
-  /**
-  * Applies only render-state handles for one pass to a render context.
-  *
-  * @param {number} techniqueIndex Technique index.
-  * @param {number} passIndex Pass index.
-  * @param {object} renderContext Render context with an `m_esm` state manager.
-  * @returns {boolean} True when the pass existed.
-  */
-  ApplyRenderStates(techniqueIndex, passIndex, renderContext) {
-    const pass = this.m_effect.techniques[techniqueIndex]?.passes?.[passIndex];
-    if (!pass) return false;
-    renderContext?.m_esm?.ApplyRenderStates?.(pass.renderStates);
-    return true;
-  }
-
-  /**
-  * Registers and applies a shader program override for a pass.
-  *
-  * @param {number} techniqueIndex Base technique index.
-  * @param {number} passIndex Base pass index.
-  * @param {HlslShader} overrideShader Shader providing the override program.
-  * @param {number} overridePassIndex Override pass index.
-  * @param {object} renderContext Render context with an `m_esm` state manager.
-  * @returns {number} Override program handle, or 0 when unavailable.
-  */
-  ApplyShaderOverride(techniqueIndex, passIndex, overrideShader, overridePassIndex, renderContext) {
-    const program = this.m_effect.techniques[techniqueIndex]?.passes?.[passIndex]?.shaderProgram;
-    const overrideProgram = overrideShader?.m_effect?.techniques?.[0]?.passes?.[overridePassIndex]?.shaderProgram;
-    if (!program || !overrideProgram) return 0;
-    const combined = renderContext?.m_esm?.RegisterShaderProgramOverride?.(program, overrideProgram) || 0;
-    renderContext?.m_esm?.ApplyShaderProgram?.(combined);
-    return combined;
-  }
-
-  /**
-  * Returns the shader-stage bit mask for a technique.
-  *
-  * @param {number} techniqueIndex Technique index.
-  * @returns {number} Shader-stage bit mask.
-  */
-  GetShaderTypeMask(techniqueIndex) {
-    return this.m_effect.techniques[techniqueIndex]?.shaderTypeMask || 0;
-  }
-
-  /**
-  * Finds the first constant metadata record with the supplied name.
-  *
-  * @param {string} name Constant name.
-  * @returns {object|null} Constant metadata or null.
-  */
-  GetConstant(name) {
-    for (const technique of this.m_effect.techniques) {
-      for (const pass of technique.passes) {
-        for (const stage of pass.stageInputs) {
-          const found = stage.constants.find(constant => constant.name === name);
-          if (found) return found;
-        }
-      }
-    }
-    return null;
-  }
-
-  /**
-  * Finds the first SRV or UAV resource metadata record with the supplied name.
-  *
-  * @param {string} name Resource name.
-  * @returns {object|null} Resource metadata or null.
-  */
-  GetResource(name) {
-    for (const technique of this.m_effect.techniques) {
-      for (const pass of technique.passes) {
-        for (const stage of pass.stageInputs) {
-          for (const resource of stage.resources.values()) {
-            if (resource.name === name) return resource;
-          }
-          for (const resource of stage.uavs.values()) {
-            if (resource.name === name) return resource;
-          }
-        }
-      }
-    }
-    return null;
-  }
-
-  /**
-  * Looks up annotations attached to a parameter name.
-  *
-  * @param {string} parameterName Parameter name.
-  * @returns {object[]|null} Annotation records or null.
-  */
-  GetParameterAnnotations(parameterName) {
-    return this.m_effect.annotations.get(parameterName) || null;
-  }
-
-  /**
-  * Returns Carbon's compact pass sort value.
-  *
-  * @returns {number} Sort value.
-  */
-  GetSortValue() {
-    return this.m_sortValue;
-  }
-
-  /**
-  * Returns the decoded effect description.
-  *
-  * @returns {HlslEffectDescription} Effect description.
-  */
-  GetEffectDescription() {
-    return this.m_effect;
-  }
-
-  /**
-  * Returns the decoded effect description.
-  *
-  * @returns {HlslEffectDescription} Effect description.
-  */
-  GetEffect() {
-    return this.m_effect;
-  }
-
-  /**
-  * Recomputes Carbon's sort value from the first technique/pass handles.
-  */
-  ProcessEffect() {
-    this.m_sortValue = 0;
-    const technique = this.m_effect.techniques[0];
-    const pass = technique?.passes?.[0];
-    if (!pass) return;
-    const ps = pass.stageInputs[HlslRenderContextEnum.PIXEL_SHADER]?.m_shader & 0x3ff;
-    const vs = pass.stageInputs[HlslRenderContextEnum.VERTEX_SHADER]?.m_shader & 0x3ff;
-    const states = pass.renderStates & 0x3ff;
-    const numPasses = technique.passes.length & 0x3;
-    this.m_sortValue = numPasses << 30 | ps << 20 | vs << 10 | states;
-  }
-
-  /**
-  * Reports whether this shader uses vertex-buffer access in RT shadow mode.
-  *
-  * @returns {boolean} True when RT shadow vertex-buffer access is flagged.
-  */
-  HasVertexBufferAccessInRtShadow() {
-    return this.m_hasVertexBufferAccessInRtShadow;
-  }
-
-  /**
-  * Returns a JSON-safe shader wrapper summary.
-  *
-  * @returns {object} Serializable shader summary.
-  */
-  toJSON() {
-    return {
-      m_sortValue: this.m_sortValue,
-      m_hasVertexBufferAccessInRtShadow: this.m_hasVertexBufferAccessInRtShadow,
-      effect: this.m_effect.toJSON()
-    };
-  }
-}
-
-export { HlslShader };
-//# sourceMappingURL=HlslShader.js.map
+import { HlslRenderContextEnum } from '../HlslRenderContextEnum.js';
+import { HlslEffectDescription, ANY_TECHNIQUE } from './HlslEffectDescription.js';
+
+/**
+ * Trinity shader wrapper around a decoded `HlslEffectDescription`.
+ */
+class HlslShader {
+  /**
+  * Creates an empty shader wrapper.
+  */
+  constructor() {
+    this.m_sortValue = 0;
+    this.m_effect = new HlslEffectDescription();
+    this.m_hasVertexBufferAccessInRtShadow = false;
+  }
+
+  /**
+  * Finds a technique index by name, or returns the first technique for `ANY_TECHNIQUE`.
+  *
+  * @param {string} [name] Technique name to locate.
+  * @returns {number} Technique index, or -1 when missing.
+  */
+  GetTechniqueIndex(name = ANY_TECHNIQUE) {
+    if (!this.m_effect.techniques.length) {
+      return -1;
+    }
+    if (name === ANY_TECHNIQUE || name === null || name === undefined) {
+      return 0;
+    }
+    return this.m_effect.techniques.findIndex(technique => technique.name === name);
+  }
+
+  /**
+  * Returns the number of passes in a decoded technique.
+  *
+  * @param {number} techniqueIndex Technique index.
+  * @returns {number} Pass count.
+  */
+  GetPassCount(techniqueIndex) {
+    const technique = this.m_effect.techniques[techniqueIndex];
+    return technique ? technique.passes.length : 0;
+  }
+
+  /**
+  * Applies shader program and render-state handles for one pass to a render context.
+  *
+  * @param {number} techniqueIndex Technique index.
+  * @param {number} passIndex Pass index.
+  * @param {object} renderContext Render context with an `m_esm` state manager.
+  * @returns {boolean} True when the pass existed.
+  */
+  ApplyAllStateForPass(techniqueIndex, passIndex, renderContext) {
+    const pass = this.m_effect.techniques[techniqueIndex]?.passes?.[passIndex];
+    if (!pass) return false;
+    renderContext?.m_esm?.ApplyShaderProgram?.(pass.shaderProgram);
+    renderContext?.m_esm?.ApplyRenderStates?.(pass.renderStates);
+    return true;
+  }
+
+  /**
+  * Applies only render-state handles for one pass to a render context.
+  *
+  * @param {number} techniqueIndex Technique index.
+  * @param {number} passIndex Pass index.
+  * @param {object} renderContext Render context with an `m_esm` state manager.
+  * @returns {boolean} True when the pass existed.
+  */
+  ApplyRenderStates(techniqueIndex, passIndex, renderContext) {
+    const pass = this.m_effect.techniques[techniqueIndex]?.passes?.[passIndex];
+    if (!pass) return false;
+    renderContext?.m_esm?.ApplyRenderStates?.(pass.renderStates);
+    return true;
+  }
+
+  /**
+  * Registers and applies a shader program override for a pass.
+  *
+  * @param {number} techniqueIndex Base technique index.
+  * @param {number} passIndex Base pass index.
+  * @param {HlslShader} overrideShader Shader providing the override program.
+  * @param {number} overridePassIndex Override pass index.
+  * @param {object} renderContext Render context with an `m_esm` state manager.
+  * @returns {number} Override program handle, or 0 when unavailable.
+  */
+  ApplyShaderOverride(techniqueIndex, passIndex, overrideShader, overridePassIndex, renderContext) {
+    const program = this.m_effect.techniques[techniqueIndex]?.passes?.[passIndex]?.shaderProgram;
+    const overrideProgram = overrideShader?.m_effect?.techniques?.[0]?.passes?.[overridePassIndex]?.shaderProgram;
+    if (!program || !overrideProgram) return 0;
+    const combined = renderContext?.m_esm?.RegisterShaderProgramOverride?.(program, overrideProgram) || 0;
+    renderContext?.m_esm?.ApplyShaderProgram?.(combined);
+    return combined;
+  }
+
+  /**
+  * Returns the shader-stage bit mask for a technique.
+  *
+  * @param {number} techniqueIndex Technique index.
+  * @returns {number} Shader-stage bit mask.
+  */
+  GetShaderTypeMask(techniqueIndex) {
+    return this.m_effect.techniques[techniqueIndex]?.shaderTypeMask || 0;
+  }
+
+  /**
+  * Finds the first constant metadata record with the supplied name.
+  *
+  * @param {string} name Constant name.
+  * @returns {object|null} Constant metadata or null.
+  */
+  GetConstant(name) {
+    for (const technique of this.m_effect.techniques) {
+      for (const pass of technique.passes) {
+        for (const stage of pass.stageInputs) {
+          const found = stage.constants.find(constant => constant.name === name);
+          if (found) return found;
+        }
+      }
+    }
+    return null;
+  }
+
+  /**
+  * Finds the first SRV or UAV resource metadata record with the supplied name.
+  *
+  * @param {string} name Resource name.
+  * @returns {object|null} Resource metadata or null.
+  */
+  GetResource(name) {
+    for (const technique of this.m_effect.techniques) {
+      for (const pass of technique.passes) {
+        for (const stage of pass.stageInputs) {
+          for (const resource of stage.resources.values()) {
+            if (resource.name === name) return resource;
+          }
+          for (const resource of stage.uavs.values()) {
+            if (resource.name === name) return resource;
+          }
+        }
+      }
+    }
+    return null;
+  }
+
+  /**
+  * Looks up annotations attached to a parameter name.
+  *
+  * @param {string} parameterName Parameter name.
+  * @returns {object[]|null} Annotation records or null.
+  */
+  GetParameterAnnotations(parameterName) {
+    return this.m_effect.annotations.get(parameterName) || null;
+  }
+
+  /**
+  * Returns Carbon's compact pass sort value.
+  *
+  * @returns {number} Sort value.
+  */
+  GetSortValue() {
+    return this.m_sortValue;
+  }
+
+  /**
+  * Returns the decoded effect description.
+  *
+  * @returns {HlslEffectDescription} Effect description.
+  */
+  GetEffectDescription() {
+    return this.m_effect;
+  }
+
+  /**
+  * Returns the decoded effect description.
+  *
+  * @returns {HlslEffectDescription} Effect description.
+  */
+  GetEffect() {
+    return this.m_effect;
+  }
+
+  /**
+  * Recomputes Carbon's sort value from the first technique/pass handles.
+  */
+  ProcessEffect() {
+    this.m_sortValue = 0;
+    const technique = this.m_effect.techniques[0];
+    const pass = technique?.passes?.[0];
+    if (!pass) return;
+    const ps = pass.stageInputs[HlslRenderContextEnum.PIXEL_SHADER]?.m_shader & 0x3ff;
+    const vs = pass.stageInputs[HlslRenderContextEnum.VERTEX_SHADER]?.m_shader & 0x3ff;
+    const states = pass.renderStates & 0x3ff;
+    const numPasses = technique.passes.length & 0x3;
+    this.m_sortValue = numPasses << 30 | ps << 20 | vs << 10 | states;
+  }
+
+  /**
+  * Reports whether this shader uses vertex-buffer access in RT shadow mode.
+  *
+  * @returns {boolean} True when RT shadow vertex-buffer access is flagged.
+  */
+  HasVertexBufferAccessInRtShadow() {
+    return this.m_hasVertexBufferAccessInRtShadow;
+  }
+
+  /**
+  * Returns a JSON-safe shader wrapper summary.
+  *
+  * @returns {object} Serializable shader summary.
+  */
+  toJSON() {
+    return {
+      m_sortValue: this.m_sortValue,
+      m_hasVertexBufferAccessInRtShadow: this.m_hasVertexBufferAccessInRtShadow,
+      effect: this.m_effect.toJSON()
+    };
+  }
+}
+
+export { HlslShader };
+//# sourceMappingURL=HlslShader.js.map

package/dist/formats/hlsl/core/tr2/shader/HlslShaderOption.js

@@ -1,30 +1,30 @@
-/**
- * Name/value shader permutation option used during effect lookup.
- */
-class HlslShaderOption {
-  /**
-  * Creates a shader option selection.
-  *
-  * @param {string} [name] Permutation axis name.
-  * @param {string} [value] Selected option value.
-  */
-  constructor(name = "", value = "") {
-    this.name = name;
-    this.value = value;
-  }
-
-  /**
-  * Returns a JSON-safe option selection.
-  *
-  * @returns {object} Serializable option selection.
-  */
-  toJSON() {
-    return {
-      name: this.name,
-      value: this.value
-    };
-  }
-}
-
-export { HlslShaderOption };
-//# sourceMappingURL=HlslShaderOption.js.map
+/**
+ * Name/value shader permutation option used during effect lookup.
+ */
+class HlslShaderOption {
+  /**
+  * Creates a shader option selection.
+  *
+  * @param {string} [name] Permutation axis name.
+  * @param {string} [value] Selected option value.
+  */
+  constructor(name = "", value = "") {
+    this.name = name;
+    this.value = value;
+  }
+
+  /**
+  * Returns a JSON-safe option selection.
+  *
+  * @returns {object} Serializable option selection.
+  */
+  toJSON() {
+    return {
+      name: this.name,
+      value: this.value
+    };
+  }
+}
+
+export { HlslShaderOption };
+//# sourceMappingURL=HlslShaderOption.js.map

package/dist/formats/hlsl/index.js

@@ -1,3 +1,3 @@
-export { CjsHlslFormat, CjsHlslFormat as default } from './CjsHlslFormat.js';
-export { readEffectAnalysis } from './core/analysis.js';
-//# sourceMappingURL=index.js.map
+export { CjsHlslFormat, CjsHlslFormat as default } from './CjsHlslFormat.js';
+export { readEffectAnalysis } from './core/analysis.js';
+//# sourceMappingURL=index.js.map

package/dist/formats/index.js

@@ -1,33 +1,33 @@
-export { CjsBlackFormat } from './black/CjsBlackFormat.js';
-export { CjsBnkFormat } from './bnk/CjsBnkFormat.js';
-export { CjsCmfFormat } from './cmf/CjsCmfFormat.js';
-export { CjsDdsFormat } from './dds/CjsDdsFormat.js';
-export { CjsDxbcFormat } from './dxbc/CjsDxbcFormat.js';
-export { CjsHlslFormat } from './hlsl/CjsHlslFormat.js';
-import '@carbonenginejs/runtime-utils/bytes';
-import './hlsl/core/carbonDescriptionToRuntime.js';
-import '../format/CjsByteReader.js';
-import '../format/compareUtf8.js';
-export { CjsWebglFormat } from './webgl/CjsWebglFormat.js';
-export { CjsWebgpuFormat } from './webgpu/CjsWebgpuFormat.js';
-export { CjsFbxFormat } from './fbx/CjsFbxFormat.js';
-export { CjsFlacFormat } from './flac/CjsFlacFormat.js';
-export { CjsGifFormat } from './gif/CjsGifFormat.js';
-export { CjsGltfFormat } from './gltf/CjsGltfFormat.js';
-export { CjsGr2Format } from './gr2/CjsGr2Format.js';
-export { CjsJpegFormat } from './jpeg/CjsJpegFormat.js';
-export { CjsMp3Format } from './mp3/CjsMp3Format.js';
-export { CjsMp4Format } from './mp4/CjsMp4Format.js';
-export { CjsObjFormat } from './obj/CjsObjFormat.js';
-export { CjsOggFormat } from './ogg/CjsOggFormat.js';
-export { CjsPickleFormat } from './pickle/CjsPickleFormat.js';
-export { CjsPngFormat } from './png/CjsPngFormat.js';
-export { CjsRedFormat } from './red/CjsRedFormat.js';
-export { CjsStlFormat } from './stl/CjsStlFormat.js';
-export { CjsTgaFormat } from './tga/CjsTgaFormat.js';
-export { CjsWavFormat } from './wav/CjsWavFormat.js';
-export { CjsWebmFormat } from './webm/CjsWebmFormat.js';
-export { CjsWebpFormat } from './webp/CjsWebpFormat.js';
-export { CjsWemFormat } from './wem/CjsWemFormat.js';
-export { CjsYamlFormat } from './yaml/CjsYamlFormat.js';
-//# sourceMappingURL=index.js.map
+export { CjsBlackFormat } from './black/CjsBlackFormat.js';
+export { CjsBnkFormat } from './bnk/CjsBnkFormat.js';
+export { CjsCmfFormat } from './cmf/CjsCmfFormat.js';
+export { CjsDdsFormat } from './dds/CjsDdsFormat.js';
+export { CjsDxbcFormat } from './dxbc/CjsDxbcFormat.js';
+export { CjsHlslFormat } from './hlsl/CjsHlslFormat.js';
+import '@carbonenginejs/runtime-utils/bytes';
+import './hlsl/core/carbonDescriptionToRuntime.js';
+import '../format/CjsByteReader.js';
+import '../format/compareUtf8.js';
+export { CjsWebglFormat } from './webgl/CjsWebglFormat.js';
+export { CjsWebgpuFormat } from './webgpu/CjsWebgpuFormat.js';
+export { CjsFbxFormat } from './fbx/CjsFbxFormat.js';
+export { CjsFlacFormat } from './flac/CjsFlacFormat.js';
+export { CjsGifFormat } from './gif/CjsGifFormat.js';
+export { CjsGltfFormat } from './gltf/CjsGltfFormat.js';
+export { CjsGr2Format } from './gr2/CjsGr2Format.js';
+export { CjsJpegFormat } from './jpeg/CjsJpegFormat.js';
+export { CjsMp3Format } from './mp3/CjsMp3Format.js';
+export { CjsMp4Format } from './mp4/CjsMp4Format.js';
+export { CjsObjFormat } from './obj/CjsObjFormat.js';
+export { CjsOggFormat } from './ogg/CjsOggFormat.js';
+export { CjsPickleFormat } from './pickle/CjsPickleFormat.js';
+export { CjsPngFormat } from './png/CjsPngFormat.js';
+export { CjsRedFormat } from './red/CjsRedFormat.js';
+export { CjsStlFormat } from './stl/CjsStlFormat.js';
+export { CjsTgaFormat } from './tga/CjsTgaFormat.js';
+export { CjsWavFormat } from './wav/CjsWavFormat.js';
+export { CjsWebmFormat } from './webm/CjsWebmFormat.js';
+export { CjsWebpFormat } from './webp/CjsWebpFormat.js';
+export { CjsWemFormat } from './wem/CjsWemFormat.js';
+export { CjsYamlFormat } from './yaml/CjsYamlFormat.js';
+//# sourceMappingURL=index.js.map