@carbonenginejs/runtime-resource 0.12.1 → 0.13.0

package/dist/formats/dxbc/core/errors.js

@@ -1,19 +1,19 @@
-/**
- * Error raised when DirectX shader bytecode cannot be decoded safely.
- */
-class DxbcReadError extends Error {
-  /**
-  * Creates a bytecode-read error with structured location details.
-  *
-  * @param {string} message Human-readable failure reason.
-  * @param {object} [details] Extra reader state such as source, offset, or size.
-  */
-  constructor(message, details = {}) {
-    super(message);
-    this.name = "DxbcReadError";
-    this.details = details;
-  }
-}
-
-export { DxbcReadError };
-//# sourceMappingURL=errors.js.map
+/**
+ * Error raised when DirectX shader bytecode cannot be decoded safely.
+ */
+class DxbcReadError extends Error {
+  /**
+  * Creates a bytecode-read error with structured location details.
+  *
+  * @param {string} message Human-readable failure reason.
+  * @param {object} [details] Extra reader state such as source, offset, or size.
+  */
+  constructor(message, details = {}) {
+    super(message);
+    this.name = "DxbcReadError";
+    this.details = details;
+  }
+}
+
+export { DxbcReadError };
+//# sourceMappingURL=errors.js.map

package/dist/formats/dxbc/core/helpers.js

@@ -1,220 +1,220 @@
-import { DxbcContainer } from './container.js';
-import { DxbcSignatureChunk } from './signature.js';
-import { DxbcShaderProgram } from './program.js';
-import { DxbcInstructionDecoder } from './decoder.js';
-
-/**
- * Internal read-pipeline glue for CjsDxbcFormat.
- *
- * Keeps the public class file small: input normalization, option
- * normalization, the shared read path used by both the instance and the
- * static one-shots, and JSON conversion live here.
- */
-
-const OUTPUT_JSON = "json";
-const OUTPUT_RAW = "raw";
-const DEFAULT_VALUES = Object.freeze({
-  emit: OUTPUT_JSON,
-  source: "memory",
-  decodeInstructions: true
-});
-const VALID_EMITS = new Set([OUTPUT_JSON, OUTPUT_RAW]);
-const INPUT_SIGNATURE_TAGS = ["ISGN", "ISG1"];
-const OUTPUT_SIGNATURE_TAGS = ["OSGN", "OSG1", "OSG5"];
-const PATCH_SIGNATURE_TAGS = ["PCSG", "PSG1"];
-
-/**
- * Merge format values over a base set and validate them.
- *
- * @param {object} base Current values.
- * @param {object} [options] Values to merge in.
- * @param {string} [readerName] Reader name used in error messages.
- * @returns {object} A validated copy of the merged values.
- */
-function normalizeValues(base, options = {}, readerName = "CjsDxbcFormat") {
-  const values = {
-    ...base,
-    ...options
-  };
-  if (!VALID_EMITS.has(values.emit)) {
-    throw new TypeError(`${readerName}: emit must be "${OUTPUT_JSON}" or "${OUTPUT_RAW}", got ${JSON.stringify(values.emit)}`);
-  }
-  if (typeof values.source !== "string" || !values.source) {
-    values.source = DEFAULT_VALUES.source;
-  }
-  values.decodeInstructions = !!values.decodeInstructions;
-  return {
-    emit: values.emit,
-    source: values.source,
-    decodeInstructions: values.decodeInstructions
-  };
-}
-
-/**
- * Normalize caller input into a Uint8Array of DXBC bytes.
- *
- * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input Candidate payload.
- * @returns {Uint8Array} The payload bytes.
- */
-function toBytes(input) {
-  if (input instanceof Uint8Array) return input;
-  if (typeof ArrayBuffer !== "undefined" && input instanceof ArrayBuffer) return new Uint8Array(input);
-  if (ArrayBuffer.isView(input)) return new Uint8Array(input.buffer, input.byteOffset, input.byteLength);
-  throw new TypeError("CjsDxbcFormat: input must be DXBC bytes (Uint8Array, Buffer, DataView or ArrayBuffer)");
-}
-
-/**
- * Read a signature chunk group from a container if present.
- *
- * @param {DxbcContainer} container Parsed container.
- * @param {string[]} tags Chunk fourCC candidates in priority order.
- * @param {string} source Source name for errors.
- * @returns {?DxbcSignatureChunk} Parsed signature or null.
- */
-function readSignature(container, tags, source) {
-  for (const tag of tags) {
-    const chunk = container.getChunk(tag);
-    if (chunk) return new DxbcSignatureChunk().Read(chunk, {
-      source
-    });
-  }
-  return null;
-}
-
-/**
- * The shared read path used by the instance Read and the static read.
- *
- * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input DXBC payload.
- * @param {object} values Normalized format values.
- * @returns {object} Raw read result (class instances).
- */
-function readRaw(input, values) {
-  const bytes = toBytes(input);
-  const source = values.source;
-  const container = new DxbcContainer().Read(bytes, {
-    source
-  });
-  const shex = container.getChunk("SHEX") || container.getChunk("SHDR");
-  const result = {
-    source,
-    container,
-    program: null,
-    decoder: null,
-    inputSignature: readSignature(container, INPUT_SIGNATURE_TAGS, source),
-    outputSignature: readSignature(container, OUTPUT_SIGNATURE_TAGS, source),
-    patchSignature: readSignature(container, PATCH_SIGNATURE_TAGS, source)
-  };
-  if (shex) {
-    result.program = new DxbcShaderProgram().Read(shex, {
-      source
-    });
-    if (values.decodeInstructions) {
-      result.decoder = new DxbcInstructionDecoder().Decode(result.program, {
-        source
-      });
-    }
-  }
-  return result;
-}
-
-/**
- * Convert a raw read result to plain JSON-compatible data.
- *
- * @param {object} raw Raw read result from readRaw.
- * @returns {object} Plain data.
- */
-function rawToJson(raw) {
-  return toJsonValue({
-    source: raw.source,
-    container: raw.container.toJSON(),
-    program: raw.program ? {
-      fourCC: raw.program.fourCC,
-      programType: raw.program.programType,
-      programTypeName: raw.program.programTypeName,
-      majorVersion: raw.program.majorVersion,
-      minorVersion: raw.program.minorVersion,
-      lengthDwords: raw.program.lengthDwords
-    } : null,
-    inputSignature: raw.inputSignature ? raw.inputSignature.elements : null,
-    outputSignature: raw.outputSignature ? raw.outputSignature.elements : null,
-    patchSignature: raw.patchSignature ? raw.patchSignature.elements : null,
-    instructions: raw.decoder ? raw.decoder.instructions : null
-  });
-}
-
-/**
- * Shared read entry honouring the emit mode.
- *
- * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input DXBC payload.
- * @param {object} values Normalized format values.
- * @returns {object} Raw result or plain JSON data per values.emit.
- */
-function readWithValues(input, values) {
-  const raw = readRaw(input, values);
-  return values.emit === OUTPUT_RAW ? raw : rawToJson(raw);
-}
-
-/**
- * Cheap inspection: container/program facts without instruction decode.
- *
- * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input DXBC payload.
- * @param {object} values Normalized format values.
- * @returns {object} Plain summary data.
- */
-function inspectWithValues(input, values) {
-  const raw = readRaw(input, {
-    ...values,
-    decodeInstructions: false
-  });
-  return toJsonValue({
-    source: raw.source,
-    isDxbc: true,
-    version: raw.container.version,
-    totalSize: raw.container.totalSize,
-    chunks: raw.container.chunks.map(({
-      fourCC,
-      offset,
-      size
-    }) => ({
-      fourCC,
-      offset,
-      size
-    })),
-    programTypeName: raw.program ? raw.program.programTypeName : null,
-    shaderModel: raw.program ? `${raw.program.majorVersion}.${raw.program.minorVersion}` : null,
-    inputElementCount: raw.inputSignature ? raw.inputSignature.elements.length : 0,
-    outputElementCount: raw.outputSignature ? raw.outputSignature.elements.length : 0
-  });
-}
-
-/**
- * Deep-convert a value to plain JSON-compatible data. Typed arrays become
- * plain number arrays; Maps/Sets become objects/arrays; class instances
- * with toJSON are honoured.
- *
- * @param {any} value Value to convert.
- * @returns {any} Plain data.
- */
-function toJsonValue(value) {
-  if (value === null || value === undefined) return value ?? null;
-  if (typeof value === "number" || typeof value === "string" || typeof value === "boolean") return value;
-  if (typeof value === "bigint") return value.toString();
-  if (ArrayBuffer.isView(value)) return Array.from(value);
-  if (Array.isArray(value)) return value.map(toJsonValue);
-  if (value instanceof Map) {
-    const out = {};
-    for (const [key, entry] of value) out[key] = toJsonValue(entry);
-    return out;
-  }
-  if (value instanceof Set) return Array.from(value, toJsonValue);
-  if (typeof value === "object") {
-    if (typeof value.toJSON === "function") return toJsonValue(value.toJSON());
-    const out = {};
-    for (const key of Object.keys(value)) out[key] = toJsonValue(value[key]);
-    return out;
-  }
-  return null;
-}
-
-export { DEFAULT_VALUES, OUTPUT_JSON, OUTPUT_RAW, inspectWithValues, normalizeValues, rawToJson, readRaw, readWithValues, toBytes, toJsonValue };
-//# sourceMappingURL=helpers.js.map
+import { DxbcContainer } from './container.js';
+import { DxbcSignatureChunk } from './signature.js';
+import { DxbcShaderProgram } from './program.js';
+import { DxbcInstructionDecoder } from './decoder.js';
+
+/**
+ * Internal read-pipeline glue for CjsDxbcFormat.
+ *
+ * Keeps the public class file small: input normalization, option
+ * normalization, the shared read path used by both the instance and the
+ * static one-shots, and JSON conversion live here.
+ */
+
+const OUTPUT_JSON = "json";
+const OUTPUT_RAW = "raw";
+const DEFAULT_VALUES = Object.freeze({
+  emit: OUTPUT_JSON,
+  source: "memory",
+  decodeInstructions: true
+});
+const VALID_EMITS = new Set([OUTPUT_JSON, OUTPUT_RAW]);
+const INPUT_SIGNATURE_TAGS = ["ISGN", "ISG1"];
+const OUTPUT_SIGNATURE_TAGS = ["OSGN", "OSG1", "OSG5"];
+const PATCH_SIGNATURE_TAGS = ["PCSG", "PSG1"];
+
+/**
+ * Merge format values over a base set and validate them.
+ *
+ * @param {object} base Current values.
+ * @param {object} [options] Values to merge in.
+ * @param {string} [readerName] Reader name used in error messages.
+ * @returns {object} A validated copy of the merged values.
+ */
+function normalizeValues(base, options = {}, readerName = "CjsDxbcFormat") {
+  const values = {
+    ...base,
+    ...options
+  };
+  if (!VALID_EMITS.has(values.emit)) {
+    throw new TypeError(`${readerName}: emit must be "${OUTPUT_JSON}" or "${OUTPUT_RAW}", got ${JSON.stringify(values.emit)}`);
+  }
+  if (typeof values.source !== "string" || !values.source) {
+    values.source = DEFAULT_VALUES.source;
+  }
+  values.decodeInstructions = !!values.decodeInstructions;
+  return {
+    emit: values.emit,
+    source: values.source,
+    decodeInstructions: values.decodeInstructions
+  };
+}
+
+/**
+ * Normalize caller input into a Uint8Array of DXBC bytes.
+ *
+ * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input Candidate payload.
+ * @returns {Uint8Array} The payload bytes.
+ */
+function toBytes(input) {
+  if (input instanceof Uint8Array) return input;
+  if (typeof ArrayBuffer !== "undefined" && input instanceof ArrayBuffer) return new Uint8Array(input);
+  if (ArrayBuffer.isView(input)) return new Uint8Array(input.buffer, input.byteOffset, input.byteLength);
+  throw new TypeError("CjsDxbcFormat: input must be DXBC bytes (Uint8Array, Buffer, DataView or ArrayBuffer)");
+}
+
+/**
+ * Read a signature chunk group from a container if present.
+ *
+ * @param {DxbcContainer} container Parsed container.
+ * @param {string[]} tags Chunk fourCC candidates in priority order.
+ * @param {string} source Source name for errors.
+ * @returns {?DxbcSignatureChunk} Parsed signature or null.
+ */
+function readSignature(container, tags, source) {
+  for (const tag of tags) {
+    const chunk = container.getChunk(tag);
+    if (chunk) return new DxbcSignatureChunk().Read(chunk, {
+      source
+    });
+  }
+  return null;
+}
+
+/**
+ * The shared read path used by the instance Read and the static read.
+ *
+ * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input DXBC payload.
+ * @param {object} values Normalized format values.
+ * @returns {object} Raw read result (class instances).
+ */
+function readRaw(input, values) {
+  const bytes = toBytes(input);
+  const source = values.source;
+  const container = new DxbcContainer().Read(bytes, {
+    source
+  });
+  const shex = container.getChunk("SHEX") || container.getChunk("SHDR");
+  const result = {
+    source,
+    container,
+    program: null,
+    decoder: null,
+    inputSignature: readSignature(container, INPUT_SIGNATURE_TAGS, source),
+    outputSignature: readSignature(container, OUTPUT_SIGNATURE_TAGS, source),
+    patchSignature: readSignature(container, PATCH_SIGNATURE_TAGS, source)
+  };
+  if (shex) {
+    result.program = new DxbcShaderProgram().Read(shex, {
+      source
+    });
+    if (values.decodeInstructions) {
+      result.decoder = new DxbcInstructionDecoder().Decode(result.program, {
+        source
+      });
+    }
+  }
+  return result;
+}
+
+/**
+ * Convert a raw read result to plain JSON-compatible data.
+ *
+ * @param {object} raw Raw read result from readRaw.
+ * @returns {object} Plain data.
+ */
+function rawToJson(raw) {
+  return toJsonValue({
+    source: raw.source,
+    container: raw.container.toJSON(),
+    program: raw.program ? {
+      fourCC: raw.program.fourCC,
+      programType: raw.program.programType,
+      programTypeName: raw.program.programTypeName,
+      majorVersion: raw.program.majorVersion,
+      minorVersion: raw.program.minorVersion,
+      lengthDwords: raw.program.lengthDwords
+    } : null,
+    inputSignature: raw.inputSignature ? raw.inputSignature.elements : null,
+    outputSignature: raw.outputSignature ? raw.outputSignature.elements : null,
+    patchSignature: raw.patchSignature ? raw.patchSignature.elements : null,
+    instructions: raw.decoder ? raw.decoder.instructions : null
+  });
+}
+
+/**
+ * Shared read entry honouring the emit mode.
+ *
+ * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input DXBC payload.
+ * @param {object} values Normalized format values.
+ * @returns {object} Raw result or plain JSON data per values.emit.
+ */
+function readWithValues(input, values) {
+  const raw = readRaw(input, values);
+  return values.emit === OUTPUT_RAW ? raw : rawToJson(raw);
+}
+
+/**
+ * Cheap inspection: container/program facts without instruction decode.
+ *
+ * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input DXBC payload.
+ * @param {object} values Normalized format values.
+ * @returns {object} Plain summary data.
+ */
+function inspectWithValues(input, values) {
+  const raw = readRaw(input, {
+    ...values,
+    decodeInstructions: false
+  });
+  return toJsonValue({
+    source: raw.source,
+    isDxbc: true,
+    version: raw.container.version,
+    totalSize: raw.container.totalSize,
+    chunks: raw.container.chunks.map(({
+      fourCC,
+      offset,
+      size
+    }) => ({
+      fourCC,
+      offset,
+      size
+    })),
+    programTypeName: raw.program ? raw.program.programTypeName : null,
+    shaderModel: raw.program ? `${raw.program.majorVersion}.${raw.program.minorVersion}` : null,
+    inputElementCount: raw.inputSignature ? raw.inputSignature.elements.length : 0,
+    outputElementCount: raw.outputSignature ? raw.outputSignature.elements.length : 0
+  });
+}
+
+/**
+ * Deep-convert a value to plain JSON-compatible data. Typed arrays become
+ * plain number arrays; Maps/Sets become objects/arrays; class instances
+ * with toJSON are honoured.
+ *
+ * @param {any} value Value to convert.
+ * @returns {any} Plain data.
+ */
+function toJsonValue(value) {
+  if (value === null || value === undefined) return value ?? null;
+  if (typeof value === "number" || typeof value === "string" || typeof value === "boolean") return value;
+  if (typeof value === "bigint") return value.toString();
+  if (ArrayBuffer.isView(value)) return Array.from(value);
+  if (Array.isArray(value)) return value.map(toJsonValue);
+  if (value instanceof Map) {
+    const out = {};
+    for (const [key, entry] of value) out[key] = toJsonValue(entry);
+    return out;
+  }
+  if (value instanceof Set) return Array.from(value, toJsonValue);
+  if (typeof value === "object") {
+    if (typeof value.toJSON === "function") return toJsonValue(value.toJSON());
+    const out = {};
+    for (const key of Object.keys(value)) out[key] = toJsonValue(value[key]);
+    return out;
+  }
+  return null;
+}
+
+export { DEFAULT_VALUES, OUTPUT_JSON, OUTPUT_RAW, inspectWithValues, normalizeValues, rawToJson, readRaw, readWithValues, toBytes, toJsonValue };
+//# sourceMappingURL=helpers.js.map

package/dist/formats/dxbc/core/opcodes.js

@@ -1,45 +1,45 @@
-/**
- * SM4/SM5 opcode identifiers for DXBC `SHEX`/`SHDR` token streams.
- *
- * Values match the D3D10/D3D11 token-stream opcode enumeration, validated
- * against `vendor/HLSLcc/src/internal_includes/tokens.h` (`OPCODE_TYPE`).
- */
-const DXBC_OPCODE_CUSTOMDATA = 53;
-
-/**
- * Opcode names indexed by opcode id 0-217.
- */
-const DxbcOpcodeNames = Object.freeze(["add", "and", "break", "breakc", "call", "callc", "case", "continue", "continuec", "cut", "default", "deriv_rtx", "deriv_rty", "discard", "div", "dp2", "dp3", "dp4", "else", "emit", "emit_then_cut", "endif", "endloop", "endswitch", "eq", "exp", "frc", "ftoi", "ftou", "ge", "iadd", "if", "ieq", "ige", "ilt", "imad", "imax", "imin", "imul", "ine", "ineg", "ishl", "ishr", "itof", "label", "ld", "ld_ms", "log", "loop", "lt", "mad", "min", "max", "customdata", "mov", "movc", "mul", "ne", "nop", "not", "or", "resinfo", "ret", "retc", "round_ne", "round_ni", "round_pi", "round_z", "rsq", "sample", "sample_c", "sample_c_lz", "sample_l", "sample_d", "sample_b", "sqrt", "switch", "sincos", "udiv", "ult", "uge", "umul", "umad", "umax", "umin", "ushr", "utof", "xor", "dcl_resource", "dcl_constant_buffer", "dcl_sampler", "dcl_index_range", "dcl_gs_output_primitive_topology", "dcl_gs_input_primitive", "dcl_max_output_vertex_count", "dcl_input", "dcl_input_sgv", "dcl_input_siv", "dcl_input_ps", "dcl_input_ps_sgv", "dcl_input_ps_siv", "dcl_output", "dcl_output_sgv", "dcl_output_siv", "dcl_temps", "dcl_indexable_temp", "dcl_global_flags", "reserved0", "lod", "gather4", "sample_pos", "sample_info", "reserved1", "hs_decls", "hs_control_point_phase", "hs_fork_phase", "hs_join_phase", "emit_stream", "cut_stream", "emitthencut_stream", "interface_call", "bufinfo", "deriv_rtx_coarse", "deriv_rtx_fine", "deriv_rty_coarse", "deriv_rty_fine", "gather4_c", "gather4_po", "gather4_po_c", "rcp", "f32tof16", "f16tof32", "uaddc", "usubb", "countbits", "firstbit_hi", "firstbit_lo", "firstbit_shi", "ubfe", "ibfe", "bfi", "bfrev", "swapc", "dcl_stream", "dcl_function_body", "dcl_function_table", "dcl_interface", "dcl_input_control_point_count", "dcl_output_control_point_count", "dcl_tess_domain", "dcl_tess_partitioning", "dcl_tess_output_primitive", "dcl_hs_max_tessfactor", "dcl_hs_fork_phase_instance_count", "dcl_hs_join_phase_instance_count", "dcl_thread_group", "dcl_unordered_access_view_typed", "dcl_unordered_access_view_raw", "dcl_unordered_access_view_structured", "dcl_thread_group_shared_memory_raw", "dcl_thread_group_shared_memory_structured", "dcl_resource_raw", "dcl_resource_structured", "ld_uav_typed", "store_uav_typed", "ld_raw", "store_raw", "ld_structured", "store_structured", "atomic_and", "atomic_or", "atomic_xor", "atomic_cmp_store", "atomic_iadd", "atomic_imax", "atomic_imin", "atomic_umax", "atomic_umin", "imm_atomic_alloc", "imm_atomic_consume", "imm_atomic_iadd", "imm_atomic_and", "imm_atomic_or", "imm_atomic_xor", "imm_atomic_exch", "imm_atomic_cmp_exch", "imm_atomic_imax", "imm_atomic_imin", "imm_atomic_umax", "imm_atomic_umin", "sync", "dadd", "dmax", "dmin", "dmul", "deq", "dge", "dlt", "dne", "dmov", "dmovc", "dtof", "ftod", "eval_snapped", "eval_sample_index", "eval_centroid", "dcl_gs_instance_count", "abort", "debug_break", "reserved2", "ddiv", "dfma", "drcp", "msad", "dtoi", "dtou", "itod", "utod"]);
-
-/**
- * Opcodes whose control bits carry a zero/nonzero boolean test.
- */
-const DxbcBooleanTestOpcodeNames = Object.freeze(new Set(["breakc", "callc", "continuec", "discard", "if", "retc"]));
-const DECLARATION_RANGES = [[88, 106], [113, 116], [143, 162], [206, 206]];
-
-/**
- * Resolves an opcode id to a stable mnemonic.
- *
- * @param {number} opcode Opcode id from the instruction token.
- * @returns {string} Mnemonic or `opcode_<id>` for unknown values.
- */
-function dxbcOpcodeName(opcode) {
-  return DxbcOpcodeNames[opcode] || `opcode_${opcode}`;
-}
-
-/**
- * Checks whether an opcode id belongs to the declaration/phase block rather
- * than the executable instruction set.
- *
- * @param {number} opcode Opcode id from the instruction token.
- * @returns {boolean} True for `dcl_*`, hull-phase, and custom-data opcodes.
- */
-function dxbcIsDeclarationOpcode(opcode) {
-  if (opcode === DXBC_OPCODE_CUSTOMDATA) {
-    return true;
-  }
-  return DECLARATION_RANGES.some(([start, end]) => opcode >= start && opcode <= end);
-}
-
-export { DXBC_OPCODE_CUSTOMDATA, DxbcBooleanTestOpcodeNames, DxbcOpcodeNames, dxbcIsDeclarationOpcode, dxbcOpcodeName };
-//# sourceMappingURL=opcodes.js.map
+/**
+ * SM4/SM5 opcode identifiers for DXBC `SHEX`/`SHDR` token streams.
+ *
+ * Values match the D3D10/D3D11 token-stream opcode enumeration, validated
+ * against `vendor/HLSLcc/src/internal_includes/tokens.h` (`OPCODE_TYPE`).
+ */
+const DXBC_OPCODE_CUSTOMDATA = 53;
+
+/**
+ * Opcode names indexed by opcode id 0-217.
+ */
+const DxbcOpcodeNames = Object.freeze(["add", "and", "break", "breakc", "call", "callc", "case", "continue", "continuec", "cut", "default", "deriv_rtx", "deriv_rty", "discard", "div", "dp2", "dp3", "dp4", "else", "emit", "emit_then_cut", "endif", "endloop", "endswitch", "eq", "exp", "frc", "ftoi", "ftou", "ge", "iadd", "if", "ieq", "ige", "ilt", "imad", "imax", "imin", "imul", "ine", "ineg", "ishl", "ishr", "itof", "label", "ld", "ld_ms", "log", "loop", "lt", "mad", "min", "max", "customdata", "mov", "movc", "mul", "ne", "nop", "not", "or", "resinfo", "ret", "retc", "round_ne", "round_ni", "round_pi", "round_z", "rsq", "sample", "sample_c", "sample_c_lz", "sample_l", "sample_d", "sample_b", "sqrt", "switch", "sincos", "udiv", "ult", "uge", "umul", "umad", "umax", "umin", "ushr", "utof", "xor", "dcl_resource", "dcl_constant_buffer", "dcl_sampler", "dcl_index_range", "dcl_gs_output_primitive_topology", "dcl_gs_input_primitive", "dcl_max_output_vertex_count", "dcl_input", "dcl_input_sgv", "dcl_input_siv", "dcl_input_ps", "dcl_input_ps_sgv", "dcl_input_ps_siv", "dcl_output", "dcl_output_sgv", "dcl_output_siv", "dcl_temps", "dcl_indexable_temp", "dcl_global_flags", "reserved0", "lod", "gather4", "sample_pos", "sample_info", "reserved1", "hs_decls", "hs_control_point_phase", "hs_fork_phase", "hs_join_phase", "emit_stream", "cut_stream", "emitthencut_stream", "interface_call", "bufinfo", "deriv_rtx_coarse", "deriv_rtx_fine", "deriv_rty_coarse", "deriv_rty_fine", "gather4_c", "gather4_po", "gather4_po_c", "rcp", "f32tof16", "f16tof32", "uaddc", "usubb", "countbits", "firstbit_hi", "firstbit_lo", "firstbit_shi", "ubfe", "ibfe", "bfi", "bfrev", "swapc", "dcl_stream", "dcl_function_body", "dcl_function_table", "dcl_interface", "dcl_input_control_point_count", "dcl_output_control_point_count", "dcl_tess_domain", "dcl_tess_partitioning", "dcl_tess_output_primitive", "dcl_hs_max_tessfactor", "dcl_hs_fork_phase_instance_count", "dcl_hs_join_phase_instance_count", "dcl_thread_group", "dcl_unordered_access_view_typed", "dcl_unordered_access_view_raw", "dcl_unordered_access_view_structured", "dcl_thread_group_shared_memory_raw", "dcl_thread_group_shared_memory_structured", "dcl_resource_raw", "dcl_resource_structured", "ld_uav_typed", "store_uav_typed", "ld_raw", "store_raw", "ld_structured", "store_structured", "atomic_and", "atomic_or", "atomic_xor", "atomic_cmp_store", "atomic_iadd", "atomic_imax", "atomic_imin", "atomic_umax", "atomic_umin", "imm_atomic_alloc", "imm_atomic_consume", "imm_atomic_iadd", "imm_atomic_and", "imm_atomic_or", "imm_atomic_xor", "imm_atomic_exch", "imm_atomic_cmp_exch", "imm_atomic_imax", "imm_atomic_imin", "imm_atomic_umax", "imm_atomic_umin", "sync", "dadd", "dmax", "dmin", "dmul", "deq", "dge", "dlt", "dne", "dmov", "dmovc", "dtof", "ftod", "eval_snapped", "eval_sample_index", "eval_centroid", "dcl_gs_instance_count", "abort", "debug_break", "reserved2", "ddiv", "dfma", "drcp", "msad", "dtoi", "dtou", "itod", "utod"]);
+
+/**
+ * Opcodes whose control bits carry a zero/nonzero boolean test.
+ */
+const DxbcBooleanTestOpcodeNames = Object.freeze(new Set(["breakc", "callc", "continuec", "discard", "if", "retc"]));
+const DECLARATION_RANGES = [[88, 106], [113, 116], [143, 162], [206, 206]];
+
+/**
+ * Resolves an opcode id to a stable mnemonic.
+ *
+ * @param {number} opcode Opcode id from the instruction token.
+ * @returns {string} Mnemonic or `opcode_<id>` for unknown values.
+ */
+function dxbcOpcodeName(opcode) {
+  return DxbcOpcodeNames[opcode] || `opcode_${opcode}`;
+}
+
+/**
+ * Checks whether an opcode id belongs to the declaration/phase block rather
+ * than the executable instruction set.
+ *
+ * @param {number} opcode Opcode id from the instruction token.
+ * @returns {boolean} True for `dcl_*`, hull-phase, and custom-data opcodes.
+ */
+function dxbcIsDeclarationOpcode(opcode) {
+  if (opcode === DXBC_OPCODE_CUSTOMDATA) {
+    return true;
+  }
+  return DECLARATION_RANGES.some(([start, end]) => opcode >= start && opcode <= end);
+}
+
+export { DXBC_OPCODE_CUSTOMDATA, DxbcBooleanTestOpcodeNames, DxbcOpcodeNames, dxbcIsDeclarationOpcode, dxbcOpcodeName };
+//# sourceMappingURL=opcodes.js.map