@ubercode/dcmtk 0.4.0 → 0.6.0

package/dist/{DicomInstance-CGBr3a-C.d.ts → DicomInstance-BjrSIEGN.d.ts}

@@ -1,5 +1,5 @@
 import { R as Result } from './types-Cgumy1N4.js';
-import { D as DicomJsonElement, T as TagModification } from './dcmodify-BvaIeyJg.js';
+import { D as DicomJsonElement, a as DicomJsonModel, T as TagModification } from './dcmodify-CHvwChFu.js';
 
 /**
  * Branded types for domain primitives.
@@ -142,6 +142,47 @@ declare function createPort(input: number): Result<Port>;
  */
 declare function tag(input: string): DicomTagPath;
 
+/**
+ * Utility for iterating all DICOM tags in a JSON Model dataset.
+ *
+ * Supports VR filtering and bounded recursion into sequences.
+ *
+ * @module dicom/walkTags
+ */
+
+/** Information about a visited DICOM tag. */
+interface WalkTagEntry {
+    /** 8-char hex tag key (e.g., '00100010'). */
+    readonly tag: string;
+    /** The DICOM JSON element with vr, Value, etc. */
+    readonly element: DicomJsonElement;
+    /** VR code (e.g., 'PN', 'US', 'SQ'). */
+    readonly vr: string;
+    /** Nesting depth (0 = top-level). */
+    readonly depth: number;
+    /** Dot-separated path (e.g., '00081115[0].0020000E'). */
+    readonly path: string;
+}
+/** Options for walkTags. */
+interface WalkTagsOptions {
+    /** Only visit tags with these VR codes. Omit to visit all. */
+    readonly vrFilter?: ReadonlyArray<string> | undefined;
+    /** Max recursion depth into sequences. Default: 16. */
+    readonly maxDepth?: number | undefined;
+}
+/**
+ * Walks all tags in a DICOM JSON Model dataset.
+ *
+ * Iterates every tag, optionally filtering by VR and recursing into sequences.
+ * Sequences are always recursed into (even if SQ is filtered out) so nested
+ * tags can match the VR filter.
+ *
+ * @param data - A DICOM JSON Model object
+ * @param options - Optional VR filter and max depth
+ * @returns A readonly array of all matching tag entries
+ */
+declare function walkTags(data: DicomJsonModel, options?: WalkTagsOptions): ReadonlyArray<WalkTagEntry>;
+
 /**
  * Immutable DICOM dataset wrapper with type-safe accessors.
  *
@@ -253,6 +294,13 @@ declare class DicomDataset {
      * @returns A readonly array of all matching values (may be empty)
      */
     findValues(path: DicomTagPath): ReadonlyArray<unknown>;
+    /**
+     * Walks all tags in this dataset, optionally filtering by VR and recursing into sequences.
+     *
+     * @param options - Optional VR filter and max depth
+     * @returns A readonly array of all matching tag entries
+     */
+    walkTags(options?: WalkTagsOptions): ReadonlyArray<WalkTagEntry>;
     /** Accession Number (0008,0050). */
     get accession(): string;
     /** Patient's Name (0010,0010). */
@@ -622,4 +670,4 @@ declare class DicomInstance {
     getMetadata(key: string): unknown;
 }
 
-export { type AETitle as A, type Brand as B, ChangeSet as C, type DicomTag as D, type Port as P, type SOPClassUID as S, type TransferSyntaxUID as T, type DicomTagPath as a, DicomDataset as b, type DicomFilePath as c, DicomInstance as d, createAETitle as e, createDicomFilePath as f, createDicomTag as g, createDicomTagPath as h, createPort as i, createSOPClassUID as j, createTransferSyntaxUID as k, tag as t };
+export { type AETitle as A, type Brand as B, ChangeSet as C, type DicomTag as D, type Port as P, type SOPClassUID as S, type TransferSyntaxUID as T, type WalkTagEntry as W, type DicomTagPath as a, DicomDataset as b, type DicomFilePath as c, DicomInstance as d, type WalkTagsOptions as e, createAETitle as f, createDicomFilePath as g, createDicomTag as h, createDicomTagPath as i, createPort as j, createSOPClassUID as k, createTransferSyntaxUID as l, tag as t, walkTags as w };

package/dist/{DicomInstance-DWOjhccQ.d.cts → DicomInstance-zsmyd7fs.d.cts}

@@ -1,5 +1,5 @@
 import { R as Result } from './types-Cgumy1N4.cjs';
-import { D as DicomJsonElement, T as TagModification } from './dcmodify-B9js5K1f.cjs';
+import { D as DicomJsonElement, a as DicomJsonModel, T as TagModification } from './dcmodify-Cf-RPHF3.cjs';
 
 /**
  * Branded types for domain primitives.
@@ -142,6 +142,47 @@ declare function createPort(input: number): Result<Port>;
  */
 declare function tag(input: string): DicomTagPath;
 
+/**
+ * Utility for iterating all DICOM tags in a JSON Model dataset.
+ *
+ * Supports VR filtering and bounded recursion into sequences.
+ *
+ * @module dicom/walkTags
+ */
+
+/** Information about a visited DICOM tag. */
+interface WalkTagEntry {
+    /** 8-char hex tag key (e.g., '00100010'). */
+    readonly tag: string;
+    /** The DICOM JSON element with vr, Value, etc. */
+    readonly element: DicomJsonElement;
+    /** VR code (e.g., 'PN', 'US', 'SQ'). */
+    readonly vr: string;
+    /** Nesting depth (0 = top-level). */
+    readonly depth: number;
+    /** Dot-separated path (e.g., '00081115[0].0020000E'). */
+    readonly path: string;
+}
+/** Options for walkTags. */
+interface WalkTagsOptions {
+    /** Only visit tags with these VR codes. Omit to visit all. */
+    readonly vrFilter?: ReadonlyArray<string> | undefined;
+    /** Max recursion depth into sequences. Default: 16. */
+    readonly maxDepth?: number | undefined;
+}
+/**
+ * Walks all tags in a DICOM JSON Model dataset.
+ *
+ * Iterates every tag, optionally filtering by VR and recursing into sequences.
+ * Sequences are always recursed into (even if SQ is filtered out) so nested
+ * tags can match the VR filter.
+ *
+ * @param data - A DICOM JSON Model object
+ * @param options - Optional VR filter and max depth
+ * @returns A readonly array of all matching tag entries
+ */
+declare function walkTags(data: DicomJsonModel, options?: WalkTagsOptions): ReadonlyArray<WalkTagEntry>;
+
 /**
  * Immutable DICOM dataset wrapper with type-safe accessors.
  *
@@ -253,6 +294,13 @@ declare class DicomDataset {
      * @returns A readonly array of all matching values (may be empty)
      */
     findValues(path: DicomTagPath): ReadonlyArray<unknown>;
+    /**
+     * Walks all tags in this dataset, optionally filtering by VR and recursing into sequences.
+     *
+     * @param options - Optional VR filter and max depth
+     * @returns A readonly array of all matching tag entries
+     */
+    walkTags(options?: WalkTagsOptions): ReadonlyArray<WalkTagEntry>;
     /** Accession Number (0008,0050). */
     get accession(): string;
     /** Patient's Name (0010,0010). */
@@ -622,4 +670,4 @@ declare class DicomInstance {
     getMetadata(key: string): unknown;
 }
 
-export { type AETitle as A, type Brand as B, ChangeSet as C, type DicomTag as D, type Port as P, type SOPClassUID as S, type TransferSyntaxUID as T, type DicomTagPath as a, DicomDataset as b, type DicomFilePath as c, DicomInstance as d, createAETitle as e, createDicomFilePath as f, createDicomTag as g, createDicomTagPath as h, createPort as i, createSOPClassUID as j, createTransferSyntaxUID as k, tag as t };
+export { type AETitle as A, type Brand as B, ChangeSet as C, type DicomTag as D, type Port as P, type SOPClassUID as S, type TransferSyntaxUID as T, type WalkTagEntry as W, type DicomTagPath as a, DicomDataset as b, type DicomFilePath as c, DicomInstance as d, type WalkTagsOptions as e, createAETitle as f, createDicomFilePath as g, createDicomTag as h, createDicomTagPath as i, createPort as j, createSOPClassUID as k, createTransferSyntaxUID as l, tag as t, walkTags as w };

package/dist/{dcmodify-BvaIeyJg.d.ts → dcmodify-CHvwChFu.d.ts}

@@ -123,4 +123,4 @@ interface DcmodifyResult {
  */
 declare function dcmodify(inputPath: string, options: DcmodifyOptions): Promise<Result<DcmodifyResult>>;
 
-export { type DicomJsonElement as D, type TagModification as T, type DcmodifyOptions as a, type DcmodifyResult as b, type DicomJsonModel as c, type ToolBaseOptions as d, dcmodify as e, xmlToJson as x };
+export { type DicomJsonElement as D, type TagModification as T, type DicomJsonModel as a, type DcmodifyOptions as b, type DcmodifyResult as c, type ToolBaseOptions as d, dcmodify as e, xmlToJson as x };

package/dist/{dcmodify-B9js5K1f.d.cts → dcmodify-Cf-RPHF3.d.cts}

@@ -123,4 +123,4 @@ interface DcmodifyResult {
  */
 declare function dcmodify(inputPath: string, options: DcmodifyOptions): Promise<Result<DcmodifyResult>>;
 
-export { type DicomJsonElement as D, type TagModification as T, type DcmodifyOptions as a, type DcmodifyResult as b, type DicomJsonModel as c, type ToolBaseOptions as d, dcmodify as e, xmlToJson as x };
+export { type DicomJsonElement as D, type TagModification as T, type DicomJsonModel as a, type DcmodifyOptions as b, type DcmodifyResult as c, type ToolBaseOptions as d, dcmodify as e, xmlToJson as x };

package/dist/dicom.cjs

@@ -29725,6 +29725,45 @@ function segmentsToModifyPath(segments) {
 function segmentsToString(segments) {
   return segmentsToModifyPath(segments);
 }
+
+// src/dicom/walkTags.ts
+var DEFAULT_MAX_DEPTH = 16;
+function walkTags(data, options) {
+  const ctx = {
+    maxDepth: options?.maxDepth ?? DEFAULT_MAX_DEPTH,
+    vrSet: options?.vrFilter !== void 0 ? new Set(options.vrFilter) : void 0,
+    results: []
+  };
+  walkLevel(data, 0, "", ctx);
+  return ctx.results;
+}
+function walkLevel(data, depth, pathPrefix, ctx) {
+  const keys = Object.keys(data);
+  for (let i = 0; i < keys.length; i++) {
+    const tag = keys[i];
+    if (tag === void 0) continue;
+    const element = data[tag];
+    if (element === void 0) continue;
+    const vr = element.vr;
+    const path = pathPrefix.length > 0 ? `${pathPrefix}.${tag}` : tag;
+    if (ctx.vrSet === void 0 || ctx.vrSet.has(vr)) {
+      ctx.results.push({ tag, element, vr, depth, path });
+    }
+    if (vr === "SQ" && element.Value !== void 0 && depth < ctx.maxDepth) {
+      walkSequenceItems(element.Value, depth, path, ctx);
+    }
+  }
+}
+function walkSequenceItems(items, depth, parentPath, ctx) {
+  for (let idx = 0; idx < items.length; idx++) {
+    const item = items[idx];
+    if (typeof item !== "object" || item === null) continue;
+    const itemPath = `${parentPath}[${idx}]`;
+    walkLevel(item, depth + 1, itemPath, ctx);
+  }
+}
+
+// src/dicom/DicomDataset.ts
 var HEX_TAG_KEY = /^[0-9A-Fa-f]{8}$/;
 function isDicomJsonElement(value) {
   return typeof value === "object" && value !== null && "vr" in value && typeof value["vr"] === "string";
@@ -30053,6 +30092,15 @@ var DicomDataset = class _DicomDataset {
     const result = collectWildcard(this.data, segments);
     return result.values;
   }
+  /**
+   * Walks all tags in this dataset, optionally filtering by VR and recursing into sequences.
+   *
+   * @param options - Optional VR filter and max depth
+   * @returns A readonly array of all matching tag entries
+   */
+  walkTags(options) {
+    return walkTags(this.data, options);
+  }
   // -----------------------------------------------------------------------
   // Convenience readonly getters
   // -----------------------------------------------------------------------
@@ -30614,15 +30662,32 @@ function convertSequence(attr, element) {
   }
   if (values.length > 0) element.Value = values;
 }
-function convertRegularValue(attr, element) {
+var NUMERIC_JSON_VRS = /* @__PURE__ */ new Set(["DS", "FL", "FD", "IS", "SL", "SS", "SV", "UL", "US", "UV"]);
+function unwrapValue(v) {
+  if (typeof v !== "object" || v === null) return 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]];
+  }
+  return v;
+}
+function coerceNumeric(value) {
+  if (typeof value === "number") return value;
+  if (typeof value !== "string") return value;
+  const trimmed = value.trim();
+  if (trimmed.length === 0) return value;
+  const num = Number(trimmed);
+  return Number.isNaN(num) ? value : num;
+}
+function convertRegularValue(attr, element, vr) {
   const valArray = toArray(attr.Value);
   const values = [];
+  const isNumeric = NUMERIC_JSON_VRS.has(vr);
   for (const v of valArray) {
-    if (typeof v === "object" && v !== null && "#text" in v) {
-      values.push(v["#text"]);
-    } else {
-      values.push(v);
-    }
+    const unwrapped = unwrapValue(v);
+    values.push(isNumeric ? coerceNumeric(unwrapped) : unwrapped);
   }
   if (values.length > 0) element.Value = values;
 }
@@ -30639,7 +30704,7 @@ function convertElement(attr) {
   } else if (element.vr === "SQ" && attr.Item !== void 0) {
     convertSequence(attr, element);
   } else if (attr.Value !== void 0) {
-    convertRegularValue(attr, element);
+    convertRegularValue(attr, element, vr);
   }
   return Object.freeze(element);
 }