@cosyte/dicom 0.0.1 → 0.0.4

package/dist/index.d.ts

@@ -19,7 +19,7 @@ declare const VERSION: string;
  *
  * Frozen surface. Phase 2 (parser), Phase 3 (dataset/VR), and Phase 7
  * (validate) all depend on this
- * shape — schema-breaking changes here cascade through the codebase.
+ * shape - schema-breaking changes here cascade through the codebase.
  *
  * @module
  */
@@ -28,7 +28,7 @@ declare const VERSION: string;
  *
  * For repeating-group attribute families (`(50xx,xxxx)` curves, `(60xx,xxxx)`
  * overlays, etc.), the tag string preserves lowercase `x` placeholders verbatim
- * — those entries cannot be looked up by concrete tag and are flagged via
+ * - those entries cannot be looked up by concrete tag and are flagged via
  * {@link DictionaryEntry.repeatingGroup}.
  *
  * @example
@@ -40,7 +40,7 @@ type Tag = string;
  * additions (`OV`, `SV`, `UV`) introduced in DICOM 2018.
  *
  * Note that some attributes in the data dictionary list MULTIPLE possible VRs
- * — see {@link DictionaryEntry.vr} (which is always an array, possibly empty
+ * - see {@link DictionaryEntry.vr} (which is always an array, possibly empty
  * for retired entries with no VR or special "See Note" entries).
  *
  * @example
@@ -66,7 +66,7 @@ interface DictionaryEntry {
     readonly vm: string;
     readonly retired: boolean;
     /**
-     * `true` for repeating-group families (`(50xx,xxxx)`, `(60xx,xxxx)` —
+     * `true` for repeating-group families (`(50xx,xxxx)`, `(60xx,xxxx)`:
      * curves/overlays); the {@link DictionaryEntry.tag} field for these contains
      * lowercase `x` placeholders, NOT a concrete 8-hex-char tag. Repeating-group
      * entries are not surfaced by `Dictionary.lookup(tag)` for concrete tags.
@@ -92,19 +92,19 @@ interface UidEntry {
 }
 
 /**
- * Public Dictionary namespace for `@cosyte/dicom` — Phase 1 deliverable.
+ * Public Dictionary namespace for `@cosyte/dicom` - Phase 1 deliverable.
  *
  * D-10:
  *
- *  - {@link lookup} — accepts either an 8-char hex tag (`"00100010"`) or a
+ *  - {@link lookup} - accepts either an 8-char hex tag (`"00100010"`) or a
  *    keyword (`"PatientName"`) and returns the typed {@link DictionaryEntry}
  *    or `undefined`.
- *  - {@link byKeyword} — keyword-only lookup; for cases where the caller has
+ *  - {@link byKeyword} - keyword-only lookup; for cases where the caller has
  *    already validated the input shape and wants a narrower call.
- *  - {@link uid} — UID lookup (DICT-06).
+ *  - {@link uid} - UID lookup (DICT-06).
  *
  * No function throws on miss (D-10: "Returns the typed entry or `undefined`.
- * No throws on miss."). Returned entries are deeply frozen — mutation attempts
+ * No throws on miss."). Returned entries are deeply frozen - mutation attempts
  * throw `TypeError` in strict mode (which all of `@cosyte/dicom`'s emitted code
  * runs under, given `"use strict"` is implicit for ES modules).
  *
@@ -117,7 +117,7 @@ interface UidEntry {
  * Hex tag input is normalized to uppercase; keyword input is case-sensitive.
  * Returns `undefined` for unknown tags, unknown keywords, malformed input, or
  * tags from repeating-group families (those resolve via the family entry's
- * `repeatingGroup` flag — see {@link DictionaryEntry}).
+ * `repeatingGroup` flag - see {@link DictionaryEntry}).
  *
  * @example
  *   import { Dictionary } from "@cosyte/dicom";
@@ -168,10 +168,10 @@ declare namespace index {
  * Shared parser-pipeline types for `@cosyte/dicom`.
  *
  * Phase 2 core-parser context:
- *   - D-02 — `ParseOptions` shape (Phase 2 only; no `profile` field).
- *   - D-03 — `OnWarningCallback` ordering contract (invoked AFTER push to `ctx.warnings`).
- *   - D-07 — `DicomPosition` shape (`byteOffset`, optional `fileMeta` / `deflated` / `contextPath`).
- *   - D-45 — `ParseContext.profile?: unknown` is reserved for Phase 6; Phase 2 never sets it.
+ *   - D-02 - `ParseOptions` shape (Phase 2 only; no `profile` field).
+ *   - D-03 - `OnWarningCallback` ordering contract (invoked AFTER push to `ctx.warnings`).
+ *   - D-07 - `DicomPosition` shape (`byteOffset`, optional `fileMeta` / `deflated` / `contextPath`).
+ *   - D-45 - `ParseContext.profile?: unknown` is reserved for Phase 6; Phase 2 never sets it.
  *
  * Public types (exported via `src/index.ts`): `DicomPosition`, `ParseOptions`, `OnWarningCallback`.
  * Internal type (NOT exported from `src/index.ts`): `ParseContext`.
@@ -202,14 +202,14 @@ interface PrivateTagDefinition {
 }
 /**
  * A source/vendor tolerance preset (Phase 6). A `Profile` bundles three
- * things that only ever **tighten or annotate** a parse — never loosen it
+ * things that only ever **tighten or annotate** a parse - never loosen it
  * past the Postel's-Law default:
  *
- *  - `escalations` — Tier-2 warning codes promoted to a thrown
+ *  - `escalations` - Tier-2 warning codes promoted to a thrown
  *    `DicomParseError` (a stricter posture for known-unsafe deviations).
- *  - `suppressions` — Tier-2 warning codes silenced because they are a
+ *  - `suppressions` - Tier-2 warning codes silenced because they are a
  *    documented, benign quirk of the named source (annotation, not loss).
- *  - `privateDictionary` — a private-creator-keyed overlay resolving the
+ *  - `privateDictionary` - a private-creator-keyed overlay resolving the
  *    Implicit-VR of vendor private data elements via the file's **live**
  *    private-creator string (never a hard-coded block number).
  *
@@ -287,7 +287,7 @@ type OnWarningCallback = (warning: DicomParseWarning) => void;
 /**
  * Options accepted by `parseDicom`.
  *
- * Per `02-CONTEXT.md` D-02 — Phase 2 form only. No `profile` field; Phase 6
+ * Per `02-CONTEXT.md` D-02 - Phase 2 form only. No `profile` field; Phase 6
  * adds it. With `exactOptionalPropertyTypes: true`, callers omit unset keys
  * rather than passing `undefined` for any field below.
  *
@@ -329,9 +329,9 @@ interface ParseOptions {
      */
     readonly onWarning?: OnWarningCallback;
     /**
-     * When `true`, every `Element.rawBytes` is `Buffer.from(slice)` — copying
+     * When `true`, every `Element.rawBytes` is `Buffer.from(slice)` - copying
      * each value out so the source buffer can be released. When `false` (the
-     * default), `Element.rawBytes` is `Buffer.subarray(slice)` — a zero-copy
+     * default), `Element.rawBytes` is `Buffer.subarray(slice)` - a zero-copy
      * view that pins the source ArrayBuffer until every Element is GC'd.
      *
      * Per D-16 / MODEL-03. Omit to use the default.
@@ -341,7 +341,7 @@ interface ParseOptions {
      * Source/vendor tolerance preset (Phase 6, D-45). Applies the profile's
      * `escalations` / `suppressions` to warning emission and its
      * `privateDictionary` to Implicit-VR resolution of private data elements.
-     * A profile only tightens or annotates — it never makes the default
+     * A profile only tightens or annotates - it never makes the default
      * lenient parse throw outside the four Tier-3 fatals, and a private
      * creator the profile does not recognize degrades to generic UN handling
      * plus a `DICOM_PRIVATE_CREATOR_UNKNOWN` warning, never a wrong decode.
@@ -356,11 +356,11 @@ interface ParseOptions {
  * pipeline.
  *
  * Phase 2 core-parser context:
- *   - D-08 — `WARNING_CODES` is a frozen `as const` registry with every code
+ *   - D-08 - `WARNING_CODES` is a frozen `as const` registry with every code
  *     in the TOL-03 catalog (≥25 entries). Phase 2 actively emits 13;
  *     7 VR-decode-time codes are reserved for Phase 3; 2 charset codes are
  *     reserved for Phase 4; 2 codes are reserved for Phase 6 / Phase 7.
- *   - D-12 — Exactly one named factory per actively-emitted code; each
+ *   - D-12 - Exactly one named factory per actively-emitted code; each
  *     factory carries its own JSDoc + `@example` and returns a typed
  *     `DicomParseWarning`.
  *
@@ -375,7 +375,7 @@ interface ParseOptions {
  * Stable string codes for every Tier-2 warning the parser may emit.
  *
  * The registry is frozen via `as const` so TypeScript infers the exact
- * string-literal union for `WarningCode` — there is zero runtime cost and
+ * string-literal union for `WarningCode` - there is zero runtime cost and
  * no magic-string comparisons for consumers. Reserved-but-not-emitted
  * codes carry inline comments documenting which phase activates them
  * (Phase 2 declares the union so the schema is stable for downstream
@@ -439,7 +439,7 @@ type WarningCode = (typeof WARNING_CODES)[keyof typeof WARNING_CODES];
  * subclass) so they can be safely accumulated into `Dataset.warnings` and
  * passed to `onWarning` callbacks.
  *
- * Per D-07 there is intentionally NO `snippet` field on warnings —
+ * Per D-07 there is intentionally NO `snippet` field on warnings:
  * real-world files routinely produce 50+ warnings and a per-warning
  * snippet would balloon retained memory. Snippets appear only on
  * `DicomParseError` (the strict-mode escalation path).
@@ -461,7 +461,7 @@ interface DicomParseWarning {
 }
 
 /**
- * Phase 2 structural `Item` — a single `(FFFE,E000)`-delimited Item
+ * Phase 2 structural `Item` - a single `(FFFE,E000)`-delimited Item
  * inside a Sequence, carrying a nested `Dataset`.
  *
  * Per `02-CONTEXT.md` D-04: structural surface only; navigation methods
@@ -471,7 +471,7 @@ interface DicomParseWarning {
  */
 
 /**
- * Initialiser shape for an `Item` — extends `DatasetInit` with `index`,
+ * Initialiser shape for an `Item` - extends `DatasetInit` with `index`,
  * the 0-based position of the item inside its parent `Sequence`.
  *
  * @internal
@@ -505,32 +505,32 @@ declare class Item extends Dataset {
 }
 
 /**
- * Decoded-value model for Phase 3 — the typed result of `Element.value`.
+ * Decoded-value model for Phase 3 - the typed result of `Element.value`.
  *
  * `DicomValue` is a discriminated union keyed on `kind`; each variant maps
  * to a family of VRs that share a decode shape (per PS3.5 §6.2 Table 6.2-1):
  *
- *   - `empty`         — zero-length value (any VR).
- *   - `text`          — single-value text VRs `LT ST UT UR` (no backslash
+ *   - `empty`         - zero-length value (any VR).
+ *   - `text`          - single-value text VRs `LT ST UT UR` (no backslash
  *                       multiplicity; charset-decoded except `UR`).
- *   - `strings`       — backslash-multi-valued string VRs
+ *   - `strings`       - backslash-multi-valued string VRs
  *                       `AE AS CS LO SH UC UI` (charset-decoded for
  *                       `LO SH UC`; ASCII for the rest).
- *   - `personName`    — `PN`, decoded to its 3-group / 5-component structure.
- *   - `numbers`       — binary numeric VRs `US UL SS SL FL FD` (signedness
+ *   - `personName`    - `PN`, decoded to its 3-group / 5-component structure.
+ *   - `numbers`       - binary numeric VRs `US UL SS SL FL FD` (signedness
  *                       from the VR, never guessed).
- *   - `bigints`       — 64-bit binary VRs `SV UV` (kept as `bigint` so no
+ *   - `bigints`       - 64-bit binary VRs `SV UV` (kept as `bigint` so no
  *                       precision is lost above 2^53).
- *   - `attributeTags` — `AT`, decoded to 8-hex tag strings.
- *   - `decimalString` — `DS`, parsed to `number | null` (non-numeric → null).
- *   - `integerString` — `IS`, parsed to `number | null` (non-integer → null).
- *   - `dates`         — `DA`, tolerant temporal decode.
- *   - `times`         — `TM`, tolerant temporal decode.
- *   - `dateTimes`     — `DT`, tolerant temporal decode.
- *   - `binary`        — bulk byte VRs `OB OD OF OL OV OW UN` (raw preserved;
- *                       not interpreted in v1 — avoids the giant-typed-array
+ *   - `attributeTags` - `AT`, decoded to 8-hex tag strings.
+ *   - `decimalString` - `DS`, parsed to `number | null` (non-numeric → null).
+ *   - `integerString` - `IS`, parsed to `number | null` (non-integer → null).
+ *   - `dates`         - `DA`, tolerant temporal decode.
+ *   - `times`         - `TM`, tolerant temporal decode.
+ *   - `dateTimes`     - `DT`, tolerant temporal decode.
+ *   - `binary`        - bulk byte VRs `OB OD OF OL OV OW UN` (raw preserved;
+ *                       not interpreted in v1 - avoids the giant-typed-array
  *                       footgun for pixel / LUT payloads).
- *   - `sequence`      — `SQ`, the parsed `Item[]`.
+ *   - `sequence`      - `SQ`, the parsed `Item[]`.
  *
  * Every variant whose decode may flag a tolerated deviation carries an
  * optional `warnings` array (decode is lazy and post-parse, so these cannot
@@ -564,7 +564,7 @@ interface PersonNameGroup {
     readonly nameSuffix: string;
 }
 /**
- * A decoded `PN` value — up to three component groups separated on-wire by
+ * A decoded `PN` value - up to three component groups separated on-wire by
  * `=` (PS3.5 §6.2.1.1). `alphabetic` is always present; `ideographic` and
  * `phonetic` are present only when the value supplied them.
  *
@@ -584,7 +584,7 @@ interface PersonName {
 }
 /**
  * A tolerantly-decoded `DA` (Date) value. `raw` always carries the on-wire
- * string (PHI-safe — a date is not an identifier on its own, but is
+ * string (PHI-safe - a date is not an identifier on its own, but is
  * preserved verbatim regardless). `valid` is `true` only when the string
  * parsed cleanly to a `YYYYMMDD` calendar date; otherwise the numeric
  * fields are omitted and `raw` is the source of truth.
@@ -710,11 +710,11 @@ type DicomValue = {
 };
 
 /**
- * Phase 2 structural `Element` — leaf wrapper over an on-wire DICOM
+ * Phase 2 structural `Element` - leaf wrapper over an on-wire DICOM
  * Data Element.
  *
  * Per `02-CONTEXT.md` D-04 + D-42: structural fields ONLY. No `.value`
- * getter, no decoders, no `.items` navigation — those land in Phase 3,
+ * getter, no decoders, no `.items` navigation - those land in Phase 3,
  * which extends this class.
  *
  * Per D-16: `rawBytes` is a `Buffer.subarray()` view over the source
@@ -755,7 +755,7 @@ interface ElementInit {
     /**
      * Byte order of the value bytes, set by the parser per transfer syntax
      * (`true` for Implicit/Explicit VR LE + Deflated; `false` for Explicit VR
-     * BE). Phase 3 numeric decoders read this — signedness comes from the VR,
+     * BE). Phase 3 numeric decoders read this - signedness comes from the VR,
      * endianness from here.
      */
     readonly littleEndian: boolean;
@@ -839,7 +839,7 @@ declare class Element {
     constructor(init: ElementInit);
     /**
      * The decoded value of this element, by VR. Decode is lazy (the structural
-     * parse stays eager; field decode runs on first access) and memoized — the
+     * parse stays eager; field decode runs on first access) and memoized - the
      * documented ~30× win on large studies where most fields are never read.
      * Fail-safe: never throws; a malformed value surfaces as typed-absent with
      * the deviation on the returned value's `warnings`.
@@ -859,7 +859,7 @@ declare class Element {
  * Phase 2 structural `FileMeta` view-object shape.
  *
  * Per `02-CONTEXT.md` D-04 + D-17 + FM-02: a plain interface (not a class)
- * since Phase 2 has no methods. Only `transferSyntaxUID` is required —
+ * since Phase 2 has no methods. Only `transferSyntaxUID` is required;
  * the rest are populated by `parseFileMeta` (plan 02-02) when present
  * but never enforced (Phase 7's `validate()` enforces FM Type-1 fields
  * per D-19). Phase 3 may promote to a class if helpers are added.
@@ -872,9 +872,9 @@ declare class Element {
  * serializer can re-emit an exotic File Meta group byte-for-byte.
  *
  * The typed {@link FileMeta} fields cover the common Type-1/Type-3 elements;
- * anything else a source file carried — e.g. `(0002,0017)`/`(0002,0018)`
+ * anything else a source file carried - e.g. `(0002,0017)`/`(0002,0018)`
  * Sending/Receiving AE Title, `(0002,0100)` Private Information Creator UID,
- * `(0002,0102)` Private Information — is captured here as raw bytes (the
+ * `(0002,0102)` Private Information - is captured here as raw bytes (the
  * on-wire value, even-length per PS3.5 §6.2) rather than dropped. `value` is a
  * defensive copy, so the view never aliases the parsed input buffer.
  */
@@ -929,11 +929,11 @@ interface FileMeta {
  * a missing value is **typed-absent** (`undefined`), never a substituted
  * default; a malformed numeric component stays `null` inside its array
  * rather than being coerced; raw bytes are always still reachable via the
- * underlying `Element`. These views *interpret* nothing about pixels — they
+ * underlying `Element`. These views *interpret* nothing about pixels - they
  * surface the metadata a downstream renderer needs to interpret them
  * correctly.
  *
- * The dangerous DICOM failure is the confident, wrong image — so the
+ * The dangerous DICOM failure is the confident, wrong image - so the
  * deliberate omissions are as load-bearing as the fields: there is no
  * `signed` boolean unless `(0028,0103)` was actually present, no rescale
  * slope unless `(0028,1053)` was, and the three pixel-spacing tags are
@@ -943,7 +943,7 @@ interface FileMeta {
  */
 
 /**
- * One entry of Other Patient IDs Sequence `(0010,1002)` — a `{id, issuer,
+ * One entry of Other Patient IDs Sequence `(0010,1002)` - a `{id, issuer,
  * typeCode}` triple (PS3.3 §10.15, the DICOM analogue of an HL7 v2 CX
  * repetition). Surfaced so a caller never matches on a bare `(0010,0020)`.
  *
@@ -959,7 +959,7 @@ interface OtherPatientId {
     readonly typeCode?: string;
 }
 /**
- * Patient & study identity (§4.1 — the wrong-patient failure class).
+ * Patient & study identity (§4.1 - the wrong-patient failure class).
  *
  * `id` is **not globally unique**; correct cross-system matching needs the
  * `{id, issuerOfId, issuerQualifiers}` tuple plus `otherIds`. `name` keeps
@@ -969,7 +969,7 @@ interface OtherPatientId {
  * ```ts
  * import { parseDicom } from "@cosyte/dicom";
  * const p = parseDicom(buf).patient;
- * p.id;                       // "MRN-42" — meaningless without the issuer
+ * p.id;                       // "MRN-42" - meaningless without the issuer
  * p.issuerOfId;              // "HOSP_A"
  * p.name?.alphabetic.familyName; // "Doe"
  * ```
@@ -1047,7 +1047,7 @@ interface CodedConcept {
     readonly schemeUid?: string;
 }
 /**
- * A Real World Value Mapping (§4.5) — slope/intercept bound atomically to
+ * A Real World Value Mapping (§4.5) - slope/intercept bound atomically to
  * its UCUM measurement-units code, so a number is never detached from its
  * units. From Real World Value Mapping Sequence `(0040,9096)`.
  *
@@ -1067,7 +1067,7 @@ interface RealWorldValueMap {
  * single frame Per-Frame-else-Shared (§4.4, PS3.3 §C.7.6.16). Each macro is
  * typed-absent when present in neither the per-frame nor the shared group
  * (the three *geometry* macros are treated as required for an enhanced
- * object — see {@link ImageView.frame}).
+ * object - see {@link ImageView.frame}).
  *
  * @example
  * ```ts
@@ -1101,7 +1101,7 @@ interface FrameFunctionalGroups {
     };
 }
 /**
- * Pixel-interpretation + geometry metadata (§4.2 / §4.3 / §4.4 / §4.5) — the
+ * Pixel-interpretation + geometry metadata (§4.2 / §4.3 / §4.4 / §4.5) - the
  * "wrong pixels look fine" and "looks fine, measures wrong" classes. v1 does
  * not decode pixels; this view surfaces exactly what a renderer needs so it
  * does not have to guess.
@@ -1119,7 +1119,7 @@ interface FrameFunctionalGroups {
  * const img = parseDicom(buf).image;
  * img.rescaleSlope; // undefined ⇒ caller MUST NOT assume 1
  * img.signed;       // undefined ⇒ signedness unknown, never guess
- * img.pixelSpacing; // patient-plane mm — distinct from imagerPixelSpacing
+ * img.pixelSpacing; // patient-plane mm - distinct from imagerPixelSpacing
  * ```
  */
 interface ImageView {
@@ -1166,7 +1166,7 @@ interface ImageView {
 }
 
 /**
- * Phase 2 structural `Dataset` — top-level container produced by
+ * Phase 2 structural `Dataset` - top-level container produced by
  * `parseDicom`.
  *
  * Per `02-CONTEXT.md` D-04 + D-42: only `fileMeta` and `warnings` are
@@ -1186,7 +1186,7 @@ interface ImageView {
  * Initialiser shape accepted by the `Dataset` (and `Item`) constructor.
  *
  * `fileMeta` is optional because nested `Item` datasets do not carry
- * their own File Meta — only the root `Dataset` returned by
+ * their own File Meta - only the root `Dataset` returned by
  * `parseDicom` does.
  *
  * @internal
@@ -1197,7 +1197,7 @@ interface DatasetInit {
     readonly elements: ReadonlyMap<Tag, Element>;
 }
 /**
- * One parsed DICOM dataset — the structural shell shipped by Phase 2.
+ * One parsed DICOM dataset - the structural shell shipped by Phase 2.
  *
  * Phase 2 public surface: `fileMeta`, `warnings`. The internal element
  * map is stored on `_elements` (protected) and Phase 3 promotes it to
@@ -1276,7 +1276,7 @@ declare class Dataset {
     /**
      * All elements matching a tag as an array (never `undefined`). A dataset
      * holds at most one element per tag, so this returns a 0- or 1-length
-     * array — the convenience complement of {@link Dataset.get} for callers
+     * array - the convenience complement of {@link Dataset.get} for callers
      * that prefer an always-array shape.
      *
      * @example
@@ -1289,7 +1289,7 @@ declare class Dataset {
     getAll(tag: Tag): readonly Element[];
     /**
      * Patient-identity view (§4.1). Fail-safe typed-absent fields; `id` is
-     * **not** globally unique — match on the `{id, issuerOfId, ...}` tuple
+     * **not** globally unique - match on the `{id, issuerOfId, ...}` tuple
      * plus `otherIds`, never on a bare `(0010,0020)`. Memoised on first read.
      *
      * @example
@@ -1342,7 +1342,7 @@ declare class Dataset {
 }
 
 /**
- * Public parser entry — `parseDicom`.
+ * Public parser entry - `parseDicom`.
  *
  * Pipeline (Phase 2 plan 02-02):
  *   1. Dual EMPTY_INPUT check (raw input + post-normalize) per CONTEXT D-13.
@@ -1355,7 +1355,7 @@ declare class Dataset {
  *      unsupported UIDs throw `UNSUPPORTED_TRANSFER_SYNTAX` carrying the
  *      `Dictionary.uid(uid)?.name` in `err.snippet`.
  *   6. The chosen strategy returns a `ReadonlyMap<Tag, Element>` (Phase 2
- *      stubs — real bodies arrive in plans 02-03 / 02-04 / 02-05).
+ *      stubs - real bodies arrive in plans 02-03 / 02-04 / 02-05).
  *   7. The result is assembled into a structural {@link Dataset}.
  *
  * Phase 6 (D-45) wires a source/vendor `Profile` via `ParseOptions.profile`:
@@ -1369,17 +1369,17 @@ declare class Dataset {
 /**
  * Parse a DICOM Part 10 buffer into a structural {@link Dataset}.
  *
- * Lenient by default — recoverable deviations (missing preamble, File Meta
+ * Lenient by default - recoverable deviations (missing preamble, File Meta
  * group-length mismatch, odd-length value, etc.) are pushed into
  * `ds.warnings` with stable codes from `WARNING_CODES`. Four unrecoverable
  * structural failures throw `DicomParseError`:
  *
- *   - `EMPTY_INPUT` — empty `Buffer | Uint8Array | ArrayBuffer`.
- *   - `NOT_DICOM_PART_10` — input lacks both `DICM` magic at offset 128 and
+ *   - `EMPTY_INPUT` - empty `Buffer | Uint8Array | ArrayBuffer`.
+ *   - `NOT_DICOM_PART_10` - input lacks both `DICM` magic at offset 128 and
  *     a recognizable `(0002,0000)` File Meta Group Length at offset 0.
- *   - `INVALID_FILE_META` — File Meta is truncated or `(0002,0010)`
+ *   - `INVALID_FILE_META` - File Meta is truncated or `(0002,0010)`
  *     Transfer Syntax UID is missing.
- *   - `UNSUPPORTED_TRANSFER_SYNTAX` — Transfer Syntax UID is not one of the
+ *   - `UNSUPPORTED_TRANSFER_SYNTAX` - Transfer Syntax UID is not one of the
  *     four v1 UIDs (`1.2.840.10008.1.2`, `…1.2.1`, `…1.2.2`, `…1.2.1.99`).
  *
  * Pass `{ strict: true }` to escalate every Tier-2 warning to a thrown
@@ -1421,9 +1421,9 @@ declare function parseDicom(input: Buffer | Uint8Array | ArrayBuffer): Dataset;
 declare function parseDicom(input: Buffer | Uint8Array | ArrayBuffer, options: ParseOptions): Dataset;
 
 /**
- * Phase 2 structural `Sequence` — wrapper around an SQ element's items.
+ * Phase 2 structural `Sequence` - wrapper around an SQ element's items.
  *
- * Per `02-CONTEXT.md` D-04: structural surface only — `items` and
+ * Per `02-CONTEXT.md` D-04: structural surface only - `items` and
  * `length`. No navigation methods. Phase 3 adds `Sequence.items[N].get(...)`
  * via `Item`'s `Dataset`-superclass extension per D-42.
  *
@@ -1459,9 +1459,9 @@ declare class Sequence {
  * Fatal error taxonomy for the `@cosyte/dicom` parser pipeline.
  *
  * Phase 2 core-parser context:
- *   - D-09 — `FATAL_CODES` is a frozen `as const` registry with EXACTLY
+ *   - D-09 - `FATAL_CODES` is a frozen `as const` registry with EXACTLY
  *     four codes; anything less severe MUST be a Tier-2 warning.
- *   - D-10 — `DicomParseError` carries `code`, `byteOffset`, `snippet`
+ *   - D-10 - `DicomParseError` carries `code`, `byteOffset`, `snippet`
  *     (up to 16 source bytes, space-separated lowercase hex), and an
  *     optional `contextPath`. The thrown `Error.message` is formatted
  *     `[CODE] msg (offset=N)` with `… in path/segments` appended when
@@ -1522,7 +1522,7 @@ declare const FATAL_CODES: {
 type FatalCode = (typeof FATAL_CODES)[keyof typeof FATAL_CODES];
 /**
  * Thrown by `parseDicom` when the input violates one of the four
- * unrecoverable Tier-3 structural rules — or, under `{ strict: true }`,
+ * unrecoverable Tier-3 structural rules - or, under `{ strict: true }`,
  * when any Tier-2 warning is escalated through the single `emit`
  * chokepoint (D-35). Carries byte-offset positional context plus a short
  * source snippet so consumers can log actionable errors.
@@ -1531,7 +1531,7 @@ type FatalCode = (typeof FATAL_CODES)[keyof typeof FATAL_CODES];
  * when `contextPath` is provided.
  *
  * @remarks
- * Snippets may contain PHI when parsing real clinical files — redact at
+ * Snippets may contain PHI when parsing real clinical files - redact at
  * the call site if required by your compliance posture. The library does
  * not redact snippets itself.
  *
@@ -1562,7 +1562,7 @@ declare class DicomParseError extends Error {
 }
 
 /**
- * VR-aware value dispatch — the body behind `Element.value`.
+ * VR-aware value dispatch - the body behind `Element.value`.
  *
  * `decodeElementValue` maps an `Element`'s `vr` + raw bytes to a typed
  * {@link DicomValue}, applying the fail-safe rules from PS3.5 §6.2:
@@ -1613,7 +1613,7 @@ declare function decodeElementValue(element: Element): DicomValue;
  *
  * Term-list corrections verified against PS3.3 §C.12.1.1.2 for this build
  * (the easy-to-get-wrong ones):
- *   - There is **no `ISO_IR 14`** — only `ISO_IR 13` (JIS X 0201 Katakana).
+ *   - There is **no `ISO_IR 14`** - only `ISO_IR 13` (JIS X 0201 Katakana).
  *   - `IR 87` / `IR 159` are **code-extension-only**: the bare `ISO_IR 87` /
  *     `ISO_IR 159` terms do NOT exist; only `ISO 2022 IR 87` / `ISO 2022 IR
  *     159` are valid (so they are absent from the single-byte term list).
@@ -1646,7 +1646,7 @@ declare function parseSpecificCharacterSet(bytes: Buffer): readonly string[];
  * ```ts
  * import { isKnownCharsetTerm } from "@cosyte/dicom";
  * isKnownCharsetTerm("ISO_IR 192"); // true
- * isKnownCharsetTerm("ISO_IR 14"); // false — does not exist
+ * isKnownCharsetTerm("ISO_IR 14"); // false - does not exist
  * ```
  */
 declare function isKnownCharsetTerm(term: string): boolean;
@@ -1707,7 +1707,7 @@ declare function parsePersonName(value: string): PersonName;
  * Tolerant temporal decoders for `DA` / `TM` / `DT` (PS3.5 §6.2).
  *
  * Every decoder is fail-safe: a malformed value yields `valid: false` with
- * the raw string preserved and the numeric fields omitted — it NEVER throws
+ * the raw string preserved and the numeric fields omitted - it NEVER throws
  * and NEVER coerces to a plausible-but-wrong date. Tolerated legacy forms
  * (retired dotted `YYYY.MM.DD`, partial precision, non-standard offsets) are
  * decoded best-effort and flagged to the caller so it can emit the matching
@@ -1768,7 +1768,7 @@ declare function parseDateTime(raw: string): {
  * A coded concept is the triplet `Code Value (0008,0100)` /
  * `Coding Scheme Designator (0008,0102)` / `Code Meaning (0008,0104)`. This
  * module **surfaces** the triplet and resolves the canonical scheme OID for
- * the four standard designators — it performs **no lookup, validation, or
+ * the four standard designators - it performs **no lookup, validation, or
  * mapping** (deferred). Detaching a code value from its scheme is unsafe, so
  * the three parts always travel together.
  *
@@ -1803,7 +1803,7 @@ declare const CODING_SCHEME_OIDS: {
  * ```ts
  * import { codingSchemeOid } from "@cosyte/dicom";
  * codingSchemeOid("UCUM"); // "2.16.840.1.113883.6.8"
- * codingSchemeOid("SRT");  // undefined — not SCT (CP-730)
+ * codingSchemeOid("SRT");  // undefined - not SCT (CP-730)
  * ```
  */
 declare function codingSchemeOid(designator: string | undefined): string | undefined;
@@ -1826,15 +1826,15 @@ declare function readCode(item: Dataset): CodedConcept;
  *
  * This is **separate** from the parser's four-code `FATAL_CODES` /
  * `DicomParseError` (locked to unrecoverable Part 10 structural corruption
- * — see `../../parser/errors.ts`). The §4 helpers are otherwise fail-safe:
+ * - see `../../parser/errors.ts`). The §4 helpers are otherwise fail-safe:
  * a missing *value* is typed-absent (`undefined`), never an exception. The
  * helper layer throws only for a **structural contract violation** the
  * caller asked it to resolve and that cannot be answered safely:
  *
- *   - `FRAME_INDEX_OUT_OF_RANGE` — `image.frame(i)` called with an index
+ *   - `FRAME_INDEX_OUT_OF_RANGE` - `image.frame(i)` called with an index
  *     outside `[0, numberOfFrames)`. Returning a guessed frame would be a
  *     silent wrong-image, so we refuse.
- *   - `MISSING_REQUIRED_FUNCTIONAL_GROUP` — an Enhanced multi-frame object
+ *   - `MISSING_REQUIRED_FUNCTIONAL_GROUP` - an Enhanced multi-frame object
  *     lacks a required geometry macro (Pixel Measures / Plane Position /
  *     Plane Orientation) in *both* the Per-Frame and Shared groups, so the
  *     frame cannot be spatially placed.
@@ -1905,7 +1905,7 @@ declare class DicomValueError extends Error {
 }
 
 /**
- * `serializeDicom` — the Phase 5 Part 10 writer (the conservative half of
+ * `serializeDicom` - the Phase 5 Part 10 writer (the conservative half of
  * Postel's Law).
  *
  * Takes a {@link Dataset} (from `parseDicom`, or hand-built) and emits a
@@ -1913,10 +1913,10 @@ declare class DicomValueError extends Error {
  *
  *   1. 128-byte zero preamble + `DICM` magic (PS3.10 §7.1).
  *   2. File Meta group `0002`, always Explicit VR LE, with a correct
- *      `(0002,0000)` group length — see {@link encodeFileMeta}.
+ *      `(0002,0000)` group length - see {@link encodeFileMeta}.
  *   3. The dataset body, in the dataset's own transfer syntax (**no
- *      transcode**): Implicit VR LE, Explicit VR LE/BE, or — for the Deflated
- *      syntax — an Explicit VR LE body run through RFC 1951 raw deflate
+ *      transcode**): Implicit VR LE, Explicit VR LE/BE, or - for the Deflated
+ *      syntax - an Explicit VR LE body run through RFC 1951 raw deflate
  *      (`zlib.deflateRawSync`), symmetric to the parser's `inflateRawSync`.
  *
  * Conservative behaviour (PS3.5): scalar values are padded to even length on
@@ -1934,7 +1934,7 @@ declare class DicomValueError extends Error {
  * The dataset's transfer syntax is preserved (no transcoding): pixel-data
  * fragments and nested sequences are written back byte-for-byte, while scalar
  * values are re-emitted with correct even-length padding and File Meta group
- * length. Pure function — the input `Dataset` is never mutated.
+ * length. Pure function - the input `Dataset` is never mutated.
  *
  * **Input contract.** The writer is designed for a {@link Dataset} produced by
  * `parseDicom`: it relies on the parser's `Element.rawBytes` representation
@@ -1948,7 +1948,7 @@ declare class DicomValueError extends Error {
  * {@link "../dataset/file-meta".FileMeta} fields plus any non-modeled File Meta
  * elements preserved on `extraElements`), not a byte-exact copy of the original
  * file: the 128-byte preamble is normalized to zeros, the File Meta group is
- * rebuilt in ascending tag order (modeled fields + `extraElements` — see
+ * rebuilt in ascending tag order (modeled fields + `extraElements` - see
  * {@link encodeFileMeta}), odd-length values are padded even, and retired
  * `(gggg,0000)` group lengths are dropped.
  *
@@ -1972,14 +1972,14 @@ declare function serializeDicom(ds: Dataset): Buffer;
  * Like the Phase 4 {@link "../dataset/helpers/errors".DicomValueError}, this
  * is **separate** from the parser's four-code `FATAL_CODES` /
  * `DicomParseError` (which are locked to *read*-side Part 10 structural
- * corruption — see `../parser/errors.ts`). The serializer throws only when
+ * corruption - see `../parser/errors.ts`). The serializer throws only when
  * it is asked to emit a buffer it cannot make spec-clean:
  *
- *   - `MISSING_TRANSFER_SYNTAX` — the `Dataset` has no `fileMeta`, or its
+ *   - `MISSING_TRANSFER_SYNTAX` - the `Dataset` has no `fileMeta`, or its
  *     `fileMeta.transferSyntaxUID` is empty. The Transfer Syntax UID is the
  *     dispatch input that decides every byte of the encoding, so there is no
  *     safe default to fall back to.
- *   - `UNSUPPORTED_TRANSFER_SYNTAX` — the Transfer Syntax UID is not one of
+ *   - `UNSUPPORTED_TRANSFER_SYNTAX` - the Transfer Syntax UID is not one of
  *     the four v1 syntaxes the writer (and parser) support. The writer never
  *     transcodes, so it cannot emit a syntax it does not understand.
  *
@@ -2052,7 +2052,7 @@ declare class DicomSerializeError extends Error {
 }
 
 /**
- * `defineProfile()` — the public factory for building immutable {@link Profile}
+ * `defineProfile()` - the public factory for building immutable {@link Profile}
  * objects (Phase 6). Mirrors the `@cosyte/hl7` sibling's profile factory: a
  * validated options object in, a frozen `Profile` with a `describe()` method
  * out. Invalid input throws {@link ProfileDefinitionError} with an actionable
@@ -2132,14 +2132,14 @@ interface DefineProfileOptions {
 declare function defineProfile(opts: DefineProfileOptions): Profile;
 
 /**
- * `ProfileDefinitionError` — the single typed failure surface for
+ * `ProfileDefinitionError` - the single typed failure surface for
  * `defineProfile()`. Thrown (never returned) when profile-author input is
  * malformed: a bad name, an unknown option key, an unknown warning code, an
  * invalid VR, or a private-tag key that does not match the canonical
  * `GGGGxxEE` notation.
  *
  * This is distinct from the parse-time taxonomy (`DicomParseError` /
- * `DicomValueError` / `DicomSerializeError`) — a profile is built once, at
+ * `DicomValueError` / `DicomSerializeError`) - a profile is built once, at
  * author time, long before any byte is parsed, so its errors never carry a
  * byte offset.
  *
@@ -2195,21 +2195,21 @@ declare const profiles: Readonly<{
 }>;
 
 /**
- * PS3.15 Annex E attribute-action table — DICOM Basic Application Confidentiality
+ * PS3.15 Annex E attribute-action table - DICOM Basic Application Confidentiality
  * Profile + 11 retention/clean option sets.
  *
  * Phase 1 deliverable (D-08 / D-09 / D-14). Consumed by Phase 7 `anonymize()`
  * (ANON-01..ANON-10).
  *
  * NOTE: This module is NOT re-exported from the package's `src/index.ts` (per D-10 +
- * D-27 — Phase 1's external surface is `Dictionary.{lookup,byKeyword,uid}` + `VERSION`
+ * D-27 - Phase 1's external surface is `Dictionary.{lookup,byKeyword,uid}` + `VERSION`
  * only). Phase 7 imports `annexE` via the `@cosyte/dicom/dictionary/annex-e` internal
  * path, which the `package.json` `exports` map will admit when Phase 7 lands its plans.
  *
  * The 9 *metadata-affecting* PS3.15 Annex E option-set columns (E.3.3–E.3.11 plus the
  * collapsed E.3.6 "RetainLongitudinalTemporal") populate `AnnexEAction.optionSet`
- * keys per attribute. The two *pixel-level* options — E.3.1 `CleanPixelData` and
- * E.3.2 `CleanRecognizableVisual` — are not represented per-attribute (PS3.15 Table
+ * keys per attribute. The two *pixel-level* options - E.3.1 `CleanPixelData` and
+ * E.3.2 `CleanRecognizableVisual` - are not represented per-attribute (PS3.15 Table
  * E.1-1 has no column for them); Phase 7 enforces them at the pixel-decode layer.
  * Both names remain in `AnnexEOption` for completeness and for Phase 7's API.
  */
@@ -2253,13 +2253,26 @@ type AnnexEOption = "CleanPixelData" | "CleanRecognizableVisual" | "CleanGraphic
  */
 
 /**
- * The PS3.15 Annex E option sets `deidentify` honours — the nine
+ * The PS3.15 Annex E option sets `deidentify` honours - the nine
  * *metadata-affecting* columns of Table E.1-1. The two pixel-level options
  * (`CleanPixelData` §E.3.1, `CleanRecognizableVisual` §E.3.2) are deliberately
  * excluded: this is a metadata-only de-identifier and cannot inspect pixels
  * (deferred to `@cosyte/dicom-pixel`). When pixel data is present it always
  * warns rather than claiming the image is clean.
  *
+ * **`RetainLongitudinalTemporal` gives you the full-dates branch.** PS3.15
+ * §E.3.6 is *two* options, and Table E.1-1 gives them separate columns:
+ * `Rtn. Long. Full Dates` (keep dates and times as they are) and
+ * `Rtn. Long. Modif. Dates` (keep them only as modified/shifted values). One
+ * name here covers both, and it carries the **full-dates** column - the *less*
+ * protective branch. That is not a rounding difference: the two columns disagree
+ * on **169** rows, and on every one of them full-dates says `K` (keep the real
+ * value) where modified-dates says `C` (clean it). Activate it only when real
+ * dates are genuinely required; leave it off and the Basic Profile action
+ * applies, which removes or empties them. Date *shifting* is not implemented at
+ * this layer - a caller who needs the modified-dates behaviour shifts the values
+ * themselves after the call.
+ *
  * @example
  *   const retain: DeidentifyOption[] = ["RetainLongitudinalTemporal", "RetainSafePrivate"];
  */
@@ -2275,16 +2288,16 @@ type DeidentifyOption = Exclude<AnnexEOption, "CleanPixelData" | "CleanRecogniza
  */
 declare const DEIDENTIFY_OPTIONS: readonly DeidentifyOption[];
 /**
- * What `deidentify` actually did to one attribute — the concrete outcome of the
+ * What `deidentify` actually did to one attribute - the concrete outcome of the
  * resolved Annex E action.
  *
- * - `removed` — the element was deleted (`X`).
- * - `emptied` — replaced with a zero-length value (`Z`).
- * - `dummied` — replaced with a non-identifying dummy of compatible VR (`D`).
- * - `uid-remapped` — UID(s) replaced with internally-consistent UIDs (`U`).
- * - `cleaned` — conservatively blanked because a safe similar-meaning value
+ * - `removed` - the element was deleted (`X`).
+ * - `emptied` - replaced with a zero-length value (`Z`).
+ * - `dummied` - replaced with a non-identifying dummy of compatible VR (`D`).
+ * - `uid-remapped` - UID(s) replaced with internally-consistent UIDs (`U`).
+ * - `cleaned` - conservatively blanked because a safe similar-meaning value
  *   cannot be synthesised at the metadata layer (`C`; see known limitations).
- * - `kept` — retained, either by an active Retain option or because the SQ was
+ * - `kept` - retained, either by an active Retain option or because the SQ was
  *   kept and its items cleaned recursively.
  *
  * @example
@@ -2296,8 +2309,8 @@ declare const DEIDENTIFY_OPTIONS: readonly DeidentifyOption[];
  */
 type AppliedAction = "removed" | "emptied" | "dummied" | "uid-remapped" | "cleaned" | "kept";
 /**
- * One audited attribute outcome. Carries only structural facts — tag, keyword,
- * the resolved Annex E action code, and the SQ context path — **never** a
+ * One audited attribute outcome. Carries only structural facts - tag, keyword,
+ * the resolved Annex E action code, and the SQ context path - **never** a
  * decoded value, so a report is always safe to log.
  *
  * @example
@@ -2305,7 +2318,7 @@ type AppliedAction = "removed" | "emptied" | "dummied" | "uid-remapped" | "clean
  * import { deidentify, parseDicom, type DeidentifiedAttribute } from "@cosyte/dicom";
  * const { report } = deidentify(parseDicom(buf));
  * report.attributes.forEach((a: DeidentifiedAttribute) => {
- *   console.log(a.keyword, a.action, a.applied); // structural facts only — safe to log
+ *   console.log(a.keyword, a.action, a.applied); // structural facts only - safe to log
  * });
  * ```
  */
@@ -2317,10 +2330,17 @@ interface DeidentifiedAttribute {
     readonly applied: AppliedAction;
     /** Tag/index chain for an attribute inside a sequence; omitted at the root. */
     readonly contextPath?: readonly string[];
+    /**
+     * Present when the action came from a Table E.1-1 row that names a
+     * repeating-group family rather than this single tag: the mask that matched,
+     * e.g. `"60xx4000"` for Overlay Comments in any overlay plane. `tag` is always
+     * the concrete tag that was in the file. Absent for every exact-tag row.
+     */
+    readonly repeatingGroup?: string;
 }
 /**
  * The audit trail returned alongside the de-identified dataset. Contains no
- * decoded values — only tags, keywords, action codes, and the UID map (whose
+ * decoded values - only tags, keywords, action codes, and the UID map (whose
  * keys/values are UIDs, not patient data).
  *
  * @example
@@ -2338,13 +2358,13 @@ interface DeidentifyReport {
     readonly removedPrivateTags: readonly Tag[];
     /** Source UID → replacement UID, for cross-file consistency. */
     readonly uidMap: ReadonlyMap<string, string>;
-    /** Safety warnings — notably burned-in-pixel annotation that cannot be cleaned. */
+    /** Safety warnings - notably burned-in-pixel annotation that cannot be cleaned. */
     readonly warnings: readonly DicomParseWarning[];
     /** The Retain/Clean options that were active for this run. */
     readonly retained: readonly DeidentifyOption[];
 }
 /**
- * Options controlling a de-identification run. All optional — the default is
+ * Options controlling a de-identification run. All optional - the default is
  * the Basic Application Level Confidentiality Profile with no Retain options.
  *
  * @example
@@ -2362,8 +2382,8 @@ interface DeidentifyOptions {
     /**
      * A caller-owned source→replacement UID cache. Pass one shared map across a
      * whole study/archive to make UID remapping consistent by construction even
-     * across separate calls (it is consistent anyway — the mapping is content-
-     * derived — but a shared map also makes repeats O(1)).
+     * across separate calls (it is consistent anyway - the mapping is content-
+     * derived - but a shared map also makes repeats O(1)).
      */
     readonly uidMap?: Map<string, string>;
     /**
@@ -2420,14 +2440,14 @@ type DeidentifyErrorCode = (typeof DEIDENTIFY_ERROR_CODES)[keyof typeof DEIDENTI
  * Thrown for an author-time misconfiguration of {@link deidentify} (an unknown
  * Retain option, a malformed UID root). Distinct from the parser's fatal codes,
  * the value layer's `DicomValueError`, and the serializer's `DicomSerializeError`.
- * The message carries only structural facts (option names, the UID root) — never
+ * The message carries only structural facts (option names, the UID root) - never
  * a decoded value.
  *
  * @example
  * ```ts
  * import { deidentify, DeidentifyError } from "@cosyte/dicom";
  * try {
- *   // @ts-expect-error — not a valid option
+ *   // @ts-expect-error - not a valid option
  *   deidentify(ds, { retain: ["RetainEverything"] });
  * } catch (e) {
  *   if (e instanceof DeidentifyError) console.error(e.code); // "INVALID_OPTIONS"
@@ -2444,7 +2464,7 @@ declare class DeidentifyError extends Error {
 }
 
 /**
- * `deidentify` — PS3.15 Annex E metadata-level de-identification.
+ * `deidentify` - PS3.15 Annex E metadata-level de-identification.
  *
  * Applies the **Basic Application Level Confidentiality Profile** plus any of the
  * nine *metadata-affecting* Annex E Options, driven by the generated Table E.1-1
@@ -2458,8 +2478,13 @@ declare class DeidentifyError extends Error {
  *   (see {@link resolveAction}), and applies it: `X` remove, `Z` zero-length, `D`
  *   VR-consistent dummy (falling back to `Z` where no safe dummy exists), `C`
  *   conservative blank, `U` deterministic consistent-UID remap, `K` keep.
+ * - Resolves the three Table E.1-1 rows the standard states as a repeating-group
+ *   mask (`(50xx,xxxx)` Curve Data, `(60xx,3000)` Overlay Data, `(60xx,4000)`
+ *   Overlay Comments) across the groups PS3.5 §7.6 bounds them to, on an
+ *   exact-tag miss. A match is removed *and* reported, with
+ *   `DeidentifiedAttribute.repeatingGroup` naming the mask.
  * - Recurses into kept sequences and **re-encodes** them so nested PHI is removed
- *   in the *serialized* bytes too — not just the object model (the Phase 5 writer
+ *   in the *serialized* bytes too - not just the object model (the Phase 5 writer
  *   blits `SQ` spans verbatim, so a rebuilt `items` array alone would not survive
  *   serialization). Rebuilt sequences are normalized to defined length.
  * - Removes all private attributes by default; with `RetainSafePrivate` + a
@@ -2469,18 +2494,18 @@ declare class DeidentifyError extends Error {
  *   `RetainUIDs`), writes `(0012,0062)` Patient Identity Removed = `YES` and
  *   `(0012,0063)` De-identification Method, and warns
  *   (`DICOM_BURNED_IN_ANNOTATION_NOT_REMOVED`) when Pixel Data is present and not
- *   marked free of burned-in annotation — this metadata-only pass cannot clean
+ *   marked free of burned-in annotation - this metadata-only pass cannot clean
  *   pixels (deferred to `@cosyte/dicom-pixel`).
  *
  * **Known limitations** (documented, fail-safe toward *more* removal):
  * - No IOD Type-1 conformance analysis, so conditional codes always take the
- *   most-protective leftmost branch — a Type-1 attribute that strictly needed a
+ *   most-protective leftmost branch - a Type-1 attribute that strictly needed a
  *   dummy is instead removed/emptied.
  * - `C` (clean) is a conservative blank, not a meaning-preserving structured
  *   replacement (which needs domain context the metadata layer lacks).
  * - Pixel-level options (`CleanPixelData`, `CleanRecognizableVisual`) are out of
  *   scope; burned-in text is warned, never cleaned.
- * - A private data element kept under `RetainSafePrivate` is kept *verbatim* — if
+ * - A private data element kept under `RetainSafePrivate` is kept *verbatim* - if
  *   it is itself a sequence carrying standard PHI attributes, that nested content
  *   is not recursed. The profile vouches the element is safe; nest accordingly.
  * - A sequence whose `items` the parser did not materialize (e.g. an
@@ -2491,7 +2516,7 @@ declare class DeidentifyError extends Error {
  */
 
 /**
- * De-identify a {@link Dataset} per PS3.15 Annex E — the Basic Application Level
+ * De-identify a {@link Dataset} per PS3.15 Annex E - the Basic Application Level
  * Confidentiality Profile, plus any Retain/Clean Options passed in `retain`.
  *
  * Pure: `ds` is never mutated. Returns a fresh dataset and a value-free
@@ -2517,19 +2542,19 @@ declare function deidentify(ds: Dataset, options?: DeidentifyOptions): Deidentif
  * The replacement is a pure function of the source UID and the chosen root:
  * `sha256(sourceUid)` reduced to a decimal string under `<root>.…`. Because it
  * is content-derived, the *same* source UID maps to the *same* replacement
- * across separate `deidentify` calls and across files in a study set — without
- * any shared state — so cross-instance referential integrity (Study ⇄ Series ⇄
+ * across separate `deidentify` calls and across files in a study set - without
+ * any shared state - so cross-instance referential integrity (Study ⇄ Series ⇄
  * SOP, Frame of Reference, referenced instances) is preserved. A per-call cache
  * `Map` makes repeats within one call O(1) and lets a caller thread one map
  * through a whole archive if they prefer explicit sharing.
  *
- * Default root `2.25` is the DICOM-sanctioned UUID-derived arc (PS3.5 §B.2) —
+ * Default root `2.25` is the DICOM-sanctioned UUID-derived arc (PS3.5 §B.2):
  * a globally-unique root that needs no registration.
  *
  * @module
  */
 /**
- * DICOM `2.25` UUID-derived root (PS3.5 §B.2) — no registration required.
+ * DICOM `2.25` UUID-derived root (PS3.5 §B.2) - no registration required.
  *
  * @example
  * ```ts