@ubercode/dcmtk 1.0.0-rc.1 → 1.0.0-rc.2

package/dist/dicom.cjs

@@ -9,10 +9,13 @@ var promises = require('fs/promises');
 var os = require('os');
 var zod = require('zod');
 var fastXmlParser = require('fast-xml-parser');
+var zlib = require('zlib');
+var dicomParser = require('dicom-parser');
 
 function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
 
 var kill__default = /*#__PURE__*/_interopDefault(kill);
+var dicomParser__default = /*#__PURE__*/_interopDefault(dicomParser);
 
 var __defProp = Object.defineProperty;
 var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
@@ -30392,9 +30395,9 @@ var ToolExecutionError = class extends Error {
     this.exitCode = details.exitCode;
   }
 };
-function createToolError(toolName, args, exitCode, stderr4, stdout = "") {
+function createToolError(toolName, args, exitCode, stderr5, stdout = "") {
   const argsStr = truncate(args.join(" "), MAX_ARGS_LENGTH);
-  const stderrStr = truncate(stderr4.trim(), MAX_STDERR_LENGTH);
+  const stderrStr = truncate(stderr5.trim(), MAX_STDERR_LENGTH);
   const parts = [`${toolName} failed (exit code ${String(exitCode)})`];
   if (argsStr.length > 0) {
     parts.push(`args: ${argsStr}`);
@@ -30402,7 +30405,7 @@ function createToolError(toolName, args, exitCode, stderr4, stdout = "") {
   if (stderrStr.length > 0) {
     parts.push(`stderr: ${stderrStr}`);
   }
-  return new ToolExecutionError(parts.join(" | "), { stdout, stderr: stderr4, exitCode });
+  return new ToolExecutionError(parts.join(" | "), { stdout, stderr: stderr5, exitCode });
 }
 function createValidationError(toolName, zodError) {
   const parts = [];
@@ -30434,7 +30437,7 @@ async function execCommand(binary, args, options) {
 }
 function wireSpawnListeners(binary, child, timeoutMs, resolve) {
   let stdout = "";
-  let stderr4 = "";
+  let stderr5 = "";
   let settled = false;
   const name = binary.split("/").pop() ?? binary;
   const settle = (result) => {
@@ -30449,14 +30452,14 @@ function wireSpawnListeners(binary, child, timeoutMs, resolve) {
   }, timeoutMs);
   child.stdout?.on("data", (chunk) => {
     stdout += String(chunk);
-    if (stdout.length + stderr4.length > MAX_OUTPUT_BYTES) {
+    if (stdout.length + stderr5.length > MAX_OUTPUT_BYTES) {
       if (child.pid !== void 0 && child.pid !== null) killTree(child.pid);
       settle(err(new Error(`${name} output exceeded ${MAX_OUTPUT_BYTES} bytes`)));
     }
   });
   child.stderr?.on("data", (chunk) => {
-    stderr4 += String(chunk);
-    if (stdout.length + stderr4.length > MAX_OUTPUT_BYTES) {
+    stderr5 += String(chunk);
+    if (stdout.length + stderr5.length > MAX_OUTPUT_BYTES) {
       if (child.pid !== void 0 && child.pid !== null) killTree(child.pid);
       settle(err(new Error(`${name} output exceeded ${MAX_OUTPUT_BYTES} bytes`)));
     }
@@ -30466,7 +30469,7 @@ function wireSpawnListeners(binary, child, timeoutMs, resolve) {
     settle(err(new Error(`${name} error: ${error.message}`)));
   });
   child.on("close", (code) => {
-    settle(ok({ stdout, stderr: stderr4, exitCode: code ?? 1 }));
+    settle(ok({ stdout, stderr: stderr5, exitCode: code ?? 1 }));
   });
 }
 async function spawnCommand(binary, args, options) {
@@ -30688,8 +30691,8 @@ function unwrapValue(v) {
   const obj = v;
   if ("#text" in obj) return obj["#text"];
   const keys = Object.keys(obj);
-  if (keys.length === 1 && keys[0] !== void 0 && keys[0].startsWith("@_")) {
-    return obj[keys[0]];
+  if (keys.every((k) => k.startsWith("@_"))) {
+    return "";
   }
   return v;
 }
@@ -30895,16 +30898,542 @@ async function dcm2json(inputPath, options) {
   const timeoutMs = options?.timeoutMs ?? DEFAULT_TIMEOUT_MS;
   const signal = options?.signal;
   const startTime = Date.now();
-  const remaining = () => Math.max(1e3, timeoutMs - (Date.now() - startTime));
+  const remaining = () => Math.max(0, timeoutMs - (Date.now() - startTime));
   const verbosity = options?.verbosity;
   if (options?.directOnly === true) {
-    return tryDirectPath(inputPath, remaining(), signal, verbosity);
+    return tryDirectPath(inputPath, timeoutMs, signal, verbosity);
   }
-  const xmlResult = await tryXmlPath(inputPath, remaining(), signal, buildXmlOpts(options));
+  const xmlResult = await tryXmlPath(inputPath, timeoutMs, signal, buildXmlOpts(options));
   if (xmlResult.ok) {
     return xmlResult;
   }
-  return tryDirectPath(inputPath, remaining(), signal, verbosity);
+  return fallbackToDirect(inputPath, xmlResult.error, { budget: remaining(), timeoutMs, signal, verbosity });
+}
+async function fallbackToDirect(inputPath, xmlError, context) {
+  if (context.budget === 0) {
+    return err(
+      new Error(
+        `dcm2json: XML path failed and timeout budget (${String(context.timeoutMs)}ms) is exhausted (skipping direct fallback) | xml: ${xmlError.message}`
+      )
+    );
+  }
+  const directResult = await tryDirectPath(inputPath, context.budget, context.signal, context.verbosity);
+  if (directResult.ok) {
+    return directResult;
+  }
+  return err(new Error(`dcm2json: both paths failed | xml: ${xmlError.message} | direct: ${directResult.error.message}`));
+}
+
+// src/tools/_charset.ts
+var LATIN1 = { kind: "latin1" };
+function label(name) {
+  return { kind: "label", label: name };
+}
+var CHARSET_DECODERS = {
+  "ISO_IR 6": LATIN1,
+  "ISO_IR 100": LATIN1,
+  "ISO_IR 101": label("iso-8859-2"),
+  "ISO_IR 109": label("iso-8859-3"),
+  "ISO_IR 110": label("iso-8859-4"),
+  "ISO_IR 144": label("iso-8859-5"),
+  "ISO_IR 127": label("iso-8859-6"),
+  "ISO_IR 126": label("iso-8859-7"),
+  "ISO_IR 138": label("iso-8859-8"),
+  "ISO_IR 148": label("iso-8859-9"),
+  "ISO_IR 203": label("iso-8859-15"),
+  "ISO_IR 13": label("shift_jis"),
+  "ISO_IR 166": label("windows-874"),
+  "ISO_IR 192": label("utf-8"),
+  GB18030: label("gb18030"),
+  GBK: label("gbk")
+};
+var ISO2022_INITIAL = {
+  "ISO 2022 IR 6": LATIN1,
+  "ISO 2022 IR 13": label("shift_jis"),
+  "ISO 2022 IR 87": LATIN1,
+  "ISO 2022 IR 159": LATIN1,
+  "ISO 2022 IR 149": label("euc-kr"),
+  "ISO 2022 IR 58": label("gbk"),
+  "ISO 2022 IR 100": LATIN1,
+  "ISO 2022 IR 101": label("iso-8859-2"),
+  "ISO 2022 IR 109": label("iso-8859-3"),
+  "ISO 2022 IR 110": label("iso-8859-4"),
+  "ISO 2022 IR 144": label("iso-8859-5"),
+  "ISO 2022 IR 127": label("iso-8859-6"),
+  "ISO 2022 IR 126": label("iso-8859-7"),
+  "ISO 2022 IR 138": label("iso-8859-8"),
+  "ISO 2022 IR 148": label("iso-8859-9"),
+  "ISO 2022 IR 166": label("windows-874"),
+  "ISO 2022 IR 203": label("iso-8859-15")
+};
+var ESCAPE_DECODERS = {
+  "(B": LATIN1,
+  // G0 = ASCII
+  "(J": LATIN1,
+  // G0 = JIS X 0201 romaji
+  ")I": { kind: "katakana" },
+  // G1 = JIS X 0201 katakana
+  "$@": { kind: "iso2022jp", escape: [27, 36, 64] },
+  // G0 = JIS X 0208-1978
+  $B: { kind: "iso2022jp", escape: [27, 36, 66] },
+  // G0 = JIS X 0208
+  "$(D": { kind: "iso2022jp", escape: [27, 36, 40, 68] },
+  // G0 = JIS X 0212
+  "$)C": label("euc-kr"),
+  // G1 = KS X 1001
+  "$)A": label("gbk"),
+  // G1 = GB 2312
+  "-A": LATIN1,
+  // G1 = ISO-8859-1
+  "-B": label("iso-8859-2"),
+  "-C": label("iso-8859-3"),
+  "-D": label("iso-8859-4"),
+  "-F": label("iso-8859-7"),
+  "-G": label("iso-8859-6"),
+  "-H": label("iso-8859-8"),
+  "-L": label("iso-8859-5"),
+  "-M": label("iso-8859-9"),
+  "-T": label("windows-874"),
+  "-b": label("iso-8859-15")
+};
+var CHARSET_ALIASES = {
+  ascii: "ISO_IR 6",
+  "latin-1": "ISO_IR 100",
+  latin1: "ISO_IR 100",
+  "iso-8859-1": "ISO_IR 100",
+  "latin-2": "ISO_IR 101",
+  "latin-3": "ISO_IR 109",
+  "latin-4": "ISO_IR 110",
+  "latin-5": "ISO_IR 148",
+  "latin-9": "ISO_IR 203",
+  cyrillic: "ISO_IR 144",
+  arabic: "ISO_IR 127",
+  greek: "ISO_IR 126",
+  hebrew: "ISO_IR 138",
+  thai: "ISO_IR 166",
+  "shift-jis": "ISO_IR 13",
+  shift_jis: "ISO_IR 13",
+  "utf-8": "ISO_IR 192",
+  utf8: "ISO_IR 192",
+  gb18030: "GB18030",
+  gbk: "GBK"
+};
+var decoderCache = /* @__PURE__ */ new Map();
+function getTextDecoder(labelName) {
+  if (decoderCache.has(labelName)) {
+    return decoderCache.get(labelName);
+  }
+  let decoder;
+  try {
+    decoder = new TextDecoder(labelName);
+  } catch {
+    decoder = void 0;
+  }
+  decoderCache.set(labelName, decoder);
+  return decoder;
+}
+function decodeLatin1(bytes) {
+  return Buffer.from(bytes.buffer, bytes.byteOffset, bytes.byteLength).toString("latin1");
+}
+function decodeSegment(bytes, decoder) {
+  if (bytes.length === 0) return "";
+  switch (decoder.kind) {
+    case "latin1":
+      return decodeLatin1(bytes);
+    case "label": {
+      const td = getTextDecoder(decoder.label);
+      if (td === void 0) return decodeLatin1(bytes);
+      return td.decode(bytes);
+    }
+    case "iso2022jp": {
+      const td = getTextDecoder("iso-2022-jp");
+      if (td === void 0) return decodeLatin1(bytes);
+      const wrapped = new Uint8Array(decoder.escape.length + bytes.length);
+      wrapped.set(decoder.escape, 0);
+      wrapped.set(bytes, decoder.escape.length);
+      return td.decode(wrapped);
+    }
+    case "katakana": {
+      const td = getTextDecoder("shift_jis");
+      if (td === void 0) return decodeLatin1(bytes);
+      return td.decode(bytes);
+    }
+  }
+}
+function readEscape(bytes, start) {
+  let i = start + 1;
+  while (i < bytes.length && bytes[i] >= 32 && bytes[i] <= 47) {
+    i++;
+  }
+  if (i < bytes.length && bytes[i] >= 48 && bytes[i] <= 126) {
+    i++;
+  }
+  const seq = bytes.subarray(start + 1, i);
+  return { key: decodeLatin1(seq), length: i - start };
+}
+function decodeIso2022(bytes, initial) {
+  let out = "";
+  let current = initial;
+  let segStart = 0;
+  let i = 0;
+  while (i < bytes.length) {
+    if (bytes[i] !== 27) {
+      i++;
+      continue;
+    }
+    out += decodeSegment(bytes.subarray(segStart, i), current);
+    const esc = readEscape(bytes, i);
+    current = ESCAPE_DECODERS[esc.key] ?? current;
+    i += esc.length;
+    segStart = i;
+  }
+  out += decodeSegment(bytes.subarray(segStart), current);
+  return out;
+}
+var DEFAULT_CONTEXT = { terms: ["ISO_IR 6"], iso2022: false, initial: LATIN1 };
+function normalizeCharsetName(input) {
+  const trimmed = input.trim();
+  if (CHARSET_DECODERS[trimmed] !== void 0 || ISO2022_INITIAL[trimmed] !== void 0) {
+    return trimmed;
+  }
+  return CHARSET_ALIASES[trimmed.toLowerCase()];
+}
+function buildContext(terms) {
+  const iso2022 = terms.length > 1 || terms.some((t) => t.startsWith("ISO 2022"));
+  const first = terms[0] ?? "ISO_IR 6";
+  const initial = iso2022 ? ISO2022_INITIAL[first] : CHARSET_DECODERS[first];
+  if (initial === void 0) return void 0;
+  return { terms, iso2022, initial };
+}
+function parseSpecificCharacterSet(raw) {
+  const values = raw.split("\\").map((v) => v.trim());
+  return values.map((v, idx) => v === "" && idx === 0 ? "ISO 2022 IR 6" : v).filter((v) => v !== "");
+}
+function contextFromTerms(terms, fallback, source) {
+  const context = buildContext(terms);
+  if (context !== void 0) {
+    return ok(context);
+  }
+  if (fallback !== void 0) {
+    const fallbackTerm = normalizeCharsetName(fallback);
+    const fallbackContext = fallbackTerm !== void 0 ? buildContext([fallbackTerm]) : void 0;
+    if (fallbackContext !== void 0) {
+      return ok(fallbackContext);
+    }
+    return err(new Error(`Unsupported charset fallback '${fallback}' (while handling unsupported ${source})`));
+  }
+  return err(new Error(`Unsupported character set: ${source} \u2014 provide charsetFallback (e.g. 'latin-1') to decode best-effort`));
+}
+function resolveCharsetContext(specificCharacterSet, charsetAssume, charsetFallback) {
+  if (specificCharacterSet === void 0 || specificCharacterSet.trim() === "") {
+    if (charsetAssume === void 0) {
+      return ok(DEFAULT_CONTEXT);
+    }
+    const term = normalizeCharsetName(charsetAssume);
+    if (term === void 0) {
+      return contextFromTerms([charsetAssume], charsetFallback, `charsetAssume '${charsetAssume}'`);
+    }
+    return contextFromTerms([term], charsetFallback, `charsetAssume '${charsetAssume}'`);
+  }
+  const terms = parseSpecificCharacterSet(specificCharacterSet);
+  return contextFromTerms(terms, charsetFallback, `'${specificCharacterSet}' (0008,0005)`);
+}
+function decodeDicomText(bytes, context) {
+  if (context.iso2022) {
+    return decodeIso2022(bytes, context.initial);
+  }
+  return decodeSegment(bytes, context.initial);
+}
+
+// src/tools/_p10ToJson.ts
+var BINARY_VRS = /* @__PURE__ */ new Set(["OB", "OW", "OD", "OF", "OL", "OV", "UN"]);
+var CHARSET_VRS = /* @__PURE__ */ new Set(["SH", "LO", "ST", "LT", "UC", "UT", "PN"]);
+var NO_SPLIT_VRS = /* @__PURE__ */ new Set(["ST", "LT", "UT", "UR"]);
+var NUMERIC_VR_SIZE = { US: 2, SS: 2, UL: 4, SL: 4, FL: 4, FD: 8, SV: 8, UV: 8 };
+var MAX_DATASETS = 1e5;
+function toJsonTag(tag) {
+  return tag.slice(1).toUpperCase();
+}
+function isEncodingArtifact(tag) {
+  return tag.endsWith("0000") && tag.length === 9 || tag.startsWith("xfffe");
+}
+function resolveVr(element) {
+  const vr = element.vr;
+  if (vr !== void 0 && KNOWN_VR_CODES.has(vr)) {
+    return vr;
+  }
+  return "UN";
+}
+function valueBytes(element, byteArray) {
+  return byteArray.subarray(element.dataOffset, element.dataOffset + element.length);
+}
+function trimPadding(value) {
+  let end = value.length;
+  while (end > 0) {
+    const ch = value.charCodeAt(end - 1);
+    if (ch !== 32 && ch !== 0) break;
+    end--;
+  }
+  return value.slice(0, end);
+}
+function readNumericAt(view, offset, vr, littleEndian) {
+  switch (vr) {
+    case "US":
+      return view.getUint16(offset, littleEndian);
+    case "SS":
+      return view.getInt16(offset, littleEndian);
+    case "UL":
+      return view.getUint32(offset, littleEndian);
+    case "SL":
+      return view.getInt32(offset, littleEndian);
+    case "FL":
+      return view.getFloat32(offset, littleEndian);
+    case "FD":
+      return view.getFloat64(offset, littleEndian);
+    case "SV":
+      return Number(view.getBigInt64(offset, littleEndian));
+    /* v8 ignore next 2 -- 'UV' is the only remaining caller-provided VR */
+    default:
+      return Number(view.getBigUint64(offset, littleEndian));
+  }
+}
+function convertNumeric(element, byteArray, vr, littleEndian) {
+  const size = NUMERIC_VR_SIZE[vr];
+  const count = Math.floor(element.length / size);
+  if (count === 0) {
+    return { vr };
+  }
+  const view = new DataView(byteArray.buffer, byteArray.byteOffset + element.dataOffset, element.length);
+  const values = [];
+  for (let i = 0; i < count; i++) {
+    values.push(readNumericAt(view, i * size, vr, littleEndian));
+  }
+  return { vr, Value: values };
+}
+function convertAttributeTag(element, byteArray, littleEndian) {
+  const count = Math.floor(element.length / 4);
+  if (count === 0) {
+    return { vr: "AT" };
+  }
+  const view = new DataView(byteArray.buffer, byteArray.byteOffset + element.dataOffset, element.length);
+  const values = [];
+  for (let i = 0; i < count; i++) {
+    const group = view.getUint16(i * 4, littleEndian);
+    const elem = view.getUint16(i * 4 + 2, littleEndian);
+    values.push(group.toString(16).padStart(4, "0").toUpperCase() + elem.toString(16).padStart(4, "0").toUpperCase());
+  }
+  return { vr: "AT", Value: values };
+}
+function personNameToJson(value) {
+  const groups = trimPadding(value).split("=");
+  const result = {};
+  const names = ["Alphabetic", "Ideographic", "Phonetic"];
+  for (let i = 0; i < names.length; i++) {
+    const group = (groups[i] ?? "").replace(/\^+$/u, "");
+    const name = names[i];
+    if (group !== "" && name !== void 0) {
+      result[name] = group;
+    }
+  }
+  return result;
+}
+function convertPersonName2(element, byteArray, charset) {
+  const decoded = decodeDicomText(valueBytes(element, byteArray), charset);
+  const values = decoded.split("\\").map(personNameToJson);
+  return { vr: "PN", Value: values };
+}
+function convertString(element, byteArray, vr, charset) {
+  const bytes = valueBytes(element, byteArray);
+  const decoded = CHARSET_VRS.has(vr) ? decodeDicomText(bytes, charset) : Buffer.from(bytes.buffer, bytes.byteOffset, bytes.byteLength).toString("latin1");
+  const rawValues = NO_SPLIT_VRS.has(vr) ? [decoded] : decoded.split("\\");
+  const values = rawValues.map((v) => {
+    const trimmed = trimPadding(v);
+    return vr === "DS" || vr === "IS" ? coerceNumeric(trimmed.trim()) : trimmed;
+  });
+  if (values.length === 1 && values[0] === "") {
+    return { vr };
+  }
+  return { vr, Value: values };
+}
+function convertLeaf(element, byteArray, vr, settings) {
+  if (element.fragments !== void 0) {
+    return { vr: "OB" };
+  }
+  if (BINARY_VRS.has(vr)) {
+    return { vr };
+  }
+  if (element.length === 0) {
+    return { vr };
+  }
+  if (NUMERIC_VR_SIZE[vr] !== void 0) {
+    return convertNumeric(element, byteArray, vr, settings.littleEndian);
+  }
+  if (vr === "AT") {
+    return convertAttributeTag(element, byteArray, settings.littleEndian);
+  }
+  if (vr === "PN") {
+    return convertPersonName2(element, byteArray, settings.charset);
+  }
+  return convertString(element, byteArray, vr, settings.charset);
+}
+function datasetCharset(src, parent, options) {
+  const raw = src.string("x00080005");
+  if (raw === void 0) {
+    return ok(parent);
+  }
+  return resolveCharsetContext(raw, void 0, options?.charsetFallback);
+}
+function convertSequence2(element, stack, charset) {
+  const items = element.items ?? [];
+  const values = [];
+  for (const item of items) {
+    const model = {};
+    values.push(model);
+    if (item.dataSet !== void 0) {
+      stack.push({ src: item.dataSet, out: model, parentCharset: charset });
+    }
+  }
+  if (values.length === 0) {
+    return { vr: "SQ" };
+  }
+  return { vr: "SQ", Value: values };
+}
+function isSequence(element, vr) {
+  if (element.fragments !== void 0) {
+    return false;
+  }
+  return vr === "SQ" || element.vr === void 0 && element.items !== void 0;
+}
+function convertDataset(unit, stack, littleEndian, options) {
+  const charsetResult = datasetCharset(unit.src, unit.parentCharset, options);
+  if (!charsetResult.ok) {
+    return err(charsetResult.error);
+  }
+  const charset = charsetResult.value;
+  const keys = Object.keys(unit.src.elements).sort();
+  for (const key of keys) {
+    const element = unit.src.elements[key];
+    if (element === void 0) continue;
+    if (isEncodingArtifact(element.tag)) continue;
+    const tag = toJsonTag(element.tag);
+    const vr = resolveVr(element);
+    if (isSequence(element, vr)) {
+      unit.out[tag] = convertSequence2(element, stack, charset);
+    } else {
+      unit.out[tag] = convertLeaf(element, unit.src.byteArray, vr, { charset, littleEndian });
+    }
+  }
+  return ok(void 0);
+}
+function inflateDeflated(byteArray, position) {
+  const inflated = zlib.inflateRawSync(byteArray.subarray(position));
+  const combined = new Uint8Array(position + inflated.byteLength);
+  combined.set(byteArray.subarray(0, position), 0);
+  combined.set(inflated, position);
+  return combined;
+}
+function implicitVrLookup(tag) {
+  return lookupTag(tag.slice(1))?.vr;
+}
+function parseDicomBuffer(buffer, options) {
+  let dataSet;
+  try {
+    dataSet = dicomParser__default.default.parseDicom(buffer, { vrCallback: implicitVrLookup, inflater: inflateDeflated });
+  } catch (error) {
+    return err(new Error(`Failed to parse DICOM data: ${stderrLib.stderr(error).message}`));
+  }
+  const littleEndian = dataSet.string("x00020010") !== "1.2.840.10008.1.2.2";
+  const rootCharset = resolveCharsetContext(void 0, options?.charsetAssume, options?.charsetFallback);
+  if (!rootCharset.ok) {
+    return err(rootCharset.error);
+  }
+  const data = {};
+  const stack = [{ src: dataSet, out: data, parentCharset: rootCharset.value }];
+  let processed = 0;
+  while (stack.length > 0) {
+    processed++;
+    if (processed > MAX_DATASETS) {
+      return err(new Error(`Failed to parse DICOM data: more than ${String(MAX_DATASETS)} nested datasets`));
+    }
+    const unit = stack.pop();
+    if (unit === void 0) break;
+    const converted = convertDataset(unit, stack, littleEndian, options);
+    if (!converted.ok) {
+      return err(converted.error);
+    }
+  }
+  return ok({ data, warnings: dataSet.warnings });
+}
+
+// src/tools/dicom2json.ts
+var Dicom2jsonOptionsSchema = zod.z.object({
+  timeoutMs: zod.z.number().int().positive().optional(),
+  signal: zod.z.instanceof(AbortSignal).optional(),
+  charsetAssume: zod.z.string().min(1).optional(),
+  charsetFallback: zod.z.string().min(1).optional(),
+  dcmtkFallback: zod.z.boolean().optional()
+}).strict().optional();
+zod.z.object({
+  charsetAssume: zod.z.string().min(1).optional(),
+  charsetFallback: zod.z.string().min(1).optional()
+}).strict().optional();
+async function readFileBounded(inputPath, timeoutMs, signal) {
+  const timeoutSignal = AbortSignal.timeout(timeoutMs);
+  const combined = signal !== void 0 ? AbortSignal.any([signal, timeoutSignal]) : timeoutSignal;
+  try {
+    return ok(await promises.readFile(inputPath, { signal: combined }));
+  } catch (error) {
+    if (timeoutSignal.aborted) {
+      return err(new Error(`dicom2json: reading '${inputPath}' timed out after ${String(timeoutMs)}ms`));
+    }
+    if (signal?.aborted === true) {
+      return err(new Error(`dicom2json: aborted while reading '${inputPath}'`));
+    }
+    const message = error instanceof Error ? error.message : String(error);
+    return err(new Error(`dicom2json: failed to read '${inputPath}': ${message}`));
+  }
+}
+async function runDcmtkFallback(inputPath, jsError, remainingMs, options) {
+  if (remainingMs <= 0) {
+    return err(new Error(`dicom2json: JS parse failed and timeout budget exhausted (skipping DCMTK fallback) | js: ${jsError.message}`));
+  }
+  const fallback = await dcm2json(inputPath, {
+    timeoutMs: remainingMs,
+    signal: options?.signal,
+    charsetAssume: options?.charsetAssume,
+    charsetFallback: options?.charsetFallback
+  });
+  if (!fallback.ok) {
+    return err(new Error(`dicom2json: both engines failed | js: ${jsError.message} | dcmtk: ${fallback.error.message}`));
+  }
+  return ok({ data: fallback.value.data, warnings: [], source: fallback.value.source });
+}
+async function dicom2json(inputPath, options) {
+  const validation = Dicom2jsonOptionsSchema.safeParse(options);
+  if (!validation.success) {
+    return err(createValidationError("dicom2json", validation.error));
+  }
+  const timeoutMs = options?.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+  const startTime = Date.now();
+  const parsed = await parseFromFile(inputPath, timeoutMs, options);
+  if (parsed.ok) {
+    return parsed;
+  }
+  if (options?.dcmtkFallback === true) {
+    return runDcmtkFallback(inputPath, parsed.error, timeoutMs - (Date.now() - startTime), options);
+  }
+  return err(parsed.error);
+}
+async function parseFromFile(inputPath, timeoutMs, options) {
+  const fileResult = await readFileBounded(inputPath, timeoutMs, options?.signal);
+  if (!fileResult.ok) {
+    return err(fileResult.error);
+  }
+  const parsed = parseDicomBuffer(fileResult.value, { charsetAssume: options?.charsetAssume, charsetFallback: options?.charsetFallback });
+  if (!parsed.ok) {
+    return err(parsed.error);
+  }
+  return ok({ data: parsed.value.data, warnings: parsed.value.warnings, source: "js" });
 }
 var TAG_OR_PATH_PATTERN = /^\([0-9A-Fa-f]{4},[0-9A-Fa-f]{4}\)(\[\d+\]\.\([0-9A-Fa-f]{4},[0-9A-Fa-f]{4}\))*(\[\d+\])?$/;
 var TagModificationSchema = zod.z.object({
@@ -31011,6 +31540,17 @@ async function unlinkFile(path) {
 }
 
 // src/dicom/DicomInstance.ts
+async function readDicomJson(path, options) {
+  const shared = {
+    timeoutMs: options?.timeoutMs ?? DEFAULT_TIMEOUT_MS,
+    signal: options?.signal,
+    charsetAssume: options?.charsetAssume,
+    charsetFallback: options?.charsetFallback
+  };
+  const result = options?.engine === "dcmtk" ? await dcm2json(path, shared) : await dicom2json(path, { ...shared, dcmtkFallback: true });
+  if (!result.ok) return err(result.error);
+  return ok(result.value.data);
+}
 var DicomInstance = class _DicomInstance {
   constructor(dataset, changes, filePath, metadata) {
     __publicField(this, "dicomDataset");
@@ -31035,14 +31575,9 @@ var DicomInstance = class _DicomInstance {
   static async open(path, options) {
     const filePathResult = createDicomFilePath(path);
     if (!filePathResult.ok) return err(filePathResult.error);
-    const jsonResult = await dcm2json(path, {
-      timeoutMs: options?.timeoutMs ?? DEFAULT_TIMEOUT_MS,
-      signal: options?.signal,
-      charsetAssume: options?.charsetAssume,
-      charsetFallback: options?.charsetFallback
-    });
+    const jsonResult = await readDicomJson(path, options);
     if (!jsonResult.ok) return err(jsonResult.error);
-    const datasetResult = DicomDataset.fromJson(jsonResult.value.data);
+    const datasetResult = DicomDataset.fromJson(jsonResult.value);
     if (!datasetResult.ok) return err(datasetResult.error);
     return ok(new _DicomInstance(datasetResult.value, ChangeSet.empty(), filePathResult.value, /* @__PURE__ */ new Map()));
   }