@cosyte/synth 0.0.3 → 0.0.4

package/dist/index.cjs

@@ -29,6 +29,76 @@ function sfc32Next(s) {
   return t >>> 0;
 }
 
+// src/codes.ts
+var SYNTH_FATAL_CODES = {
+  /**
+   * A format was requested that this build cannot generate through a real parser builder/serializer.
+   * Fatal — never a hand-written byte fallback.
+   *
+   * **No code path in this build raises it.** All six formats generate, so it is reserved for a
+   * future format that does not, and is kept because removing a published code is a breaking change.
+   * An unsupported *kind* within a format that does generate is `SYNTH_UNSUPPORTED_KIND`.
+   */
+  SYNTH_UNSUPPORTED_FORMAT: "SYNTH_UNSUPPORTED_FORMAT",
+  /**
+   * A vendor quirk was requested that the target format's profile system does not support. Fatal —
+   * never a silent no-op and never a fabricated quirk.
+   */
+  SYNTH_UNSUPPORTED_QUIRK: "SYNTH_UNSUPPORTED_QUIRK",
+  /**
+   * A quirk transform found no structural anchor to mutate, so the fixture would not carry the
+   * deviation it is labelled with. Fatal — a golden file that lies about its parser verdict is worse
+   * than no golden file.
+   */
+  SYNTH_QUIRK_ANCHOR_ABSENT: "SYNTH_QUIRK_ANCHOR_ABSENT",
+  /**
+   * A bare parse of a freshly-generated quirk artifact did not produce exactly the declared intended
+   * warning code(s). Fatal — never emit a mislabeled fixture.
+   */
+  SYNTH_INTENDED_WARNING_MISMATCH: "SYNTH_INTENDED_WARNING_MISMATCH",
+  /** A concept's code-system URI has no OID mapping in the C-CDA example-code table. Fatal. */
+  SYNTH_UNMAPPED_CODE_SYSTEM: "SYNTH_UNMAPPED_CODE_SYSTEM",
+  /** A money value could not be read as an X12 decimal. Fatal — a generator never rounds to a float. */
+  SYNTH_INVALID_DECIMAL: "SYNTH_INVALID_DECIMAL",
+  /** An integer range was requested with its maximum below its minimum. Fatal. */
+  SYNTH_INVALID_RANGE: "SYNTH_INVALID_RANGE",
+  /** A value was drawn from an empty pool. Fatal — never a fabricated substitute. */
+  SYNTH_EMPTY_POOL: "SYNTH_EMPTY_POOL",
+  /** A `defineSynthProfile` spec was not usable (a missing or blank `name`). Fatal. */
+  SYNTH_INVALID_PROFILE: "SYNTH_INVALID_PROFILE",
+  /**
+   * A caller-supplied selector (a message kind, a document type, a corpus mix entry, a claim
+   * variant, a Bundle type, a resource profile) is not in the closed set that governs it. Fatal —
+   * see `resolveKind`: a selector union is erased at run time, and a selector that falls through
+   * either mislabels the fixture or hands the value to a peer builder that quotes it back.
+   */
+  SYNTH_UNSUPPORTED_KIND: "SYNTH_UNSUPPORTED_KIND"
+};
+var SYNTH_FATAL_MESSAGES = Object.freeze({
+  SYNTH_UNSUPPORTED_FORMAT: "The requested format is not generable by this build. A generator has no byte fallback: it builds through a parser's own serializer or it refuses.",
+  SYNTH_UNSUPPORTED_QUIRK: "The requested vendor quirk is not in the target format's quirk registry. Compare the request against that format's exported registry (HL7_QUIRKS, CCDA_QUIRKS, ASTM_QUIRKS).",
+  SYNTH_QUIRK_ANCHOR_ABSENT: "The quirk transform found no structural anchor to mutate, so the fixture would not carry the deviation it is labelled with. Refusing to emit a mislabeled fixture.",
+  SYNTH_INTENDED_WARNING_MISMATCH: "A bare parse of the generated quirk artifact did not produce exactly the declared intended warning code(s). Refusing to emit a mislabeled fixture.",
+  SYNTH_UNMAPPED_CODE_SYSTEM: "The concept's code-system URI has no OID mapping in the C-CDA example-code table.",
+  SYNTH_INVALID_DECIMAL: "The value could not be read as an X12 decimal.",
+  SYNTH_INVALID_RANGE: "An integer range was requested with its maximum below its minimum.",
+  SYNTH_EMPTY_POOL: "A value was drawn from an empty pool.",
+  SYNTH_INVALID_PROFILE: "defineSynthProfile requires a non-empty string name.",
+  SYNTH_UNSUPPORTED_KIND: "The requested kind, document type, corpus mix entry, variant or profile is not one this generator supports. The supported set is the exported union for that option."
+});
+var SynthError = class extends Error {
+  /** The stable fatal code. */
+  code;
+  /**
+   * @param code - The stable {@link SynthFatalCode}. The message comes from the frozen registry.
+   */
+  constructor(code) {
+    super(SYNTH_FATAL_MESSAGES[code]);
+    this.name = "SynthError";
+    this.code = code;
+  }
+};
+
 // src/rng/rng.ts
 var Sfc32Rng = class {
   seed;
@@ -46,7 +116,7 @@ var Sfc32Rng = class {
     return this.nextUint32() / 4294967296;
   }
   int(min, max) {
-    if (max < min) throw new RangeError(`Rng.int: max (${String(max)}) < min (${String(min)})`);
+    if (max < min) throw new SynthError(SYNTH_FATAL_CODES.SYNTH_INVALID_RANGE);
     const span = max - min + 1;
     return min + Math.floor(this.float() * span);
   }
@@ -54,7 +124,7 @@ var Sfc32Rng = class {
     return this.float() < p;
   }
   pick(items) {
-    if (items.length === 0) throw new RangeError("Rng.pick: empty array");
+    if (items.length === 0) throw new SynthError(SYNTH_FATAL_CODES.SYNTH_EMPTY_POOL);
     return items[this.int(0, items.length - 1)];
   }
   digits(n) {
@@ -397,7 +467,7 @@ function makeCorpus(seed, artifacts, quirks = []) {
 // src/profile.ts
 function defineSynthProfile(spec) {
   if (typeof spec.name !== "string" || spec.name.trim().length === 0) {
-    throw new TypeError("defineSynthProfile: `name` is required and must be a non-empty string.");
+    throw new SynthError(SYNTH_FATAL_CODES.SYNTH_INVALID_PROFILE);
   }
   return Object.freeze({
     name: spec.name,
@@ -407,33 +477,6 @@ function defineSynthProfile(spec) {
   });
 }
 
-// src/codes.ts
-var SYNTH_FATAL_CODES = {
-  /**
-   * A format was requested that this build cannot generate through a real parser builder/serializer
-   * (e.g. ASTM before `@cosyte/astm`'s serializer ships). Fatal — never a hand-written byte fallback.
-   */
-  SYNTH_UNSUPPORTED_FORMAT: "SYNTH_UNSUPPORTED_FORMAT",
-  /**
-   * A vendor quirk was requested that the target format's profile system does not support. Fatal —
-   * never a silent no-op and never a fabricated quirk.
-   */
-  SYNTH_UNSUPPORTED_QUIRK: "SYNTH_UNSUPPORTED_QUIRK"
-};
-var SynthError = class extends Error {
-  /** The stable fatal code. */
-  code;
-  /**
-   * @param code - The stable {@link SynthFatalCode}.
-   * @param message - A human-readable detail (never contains PHI — there is none).
-   */
-  constructor(code, message) {
-    super(message);
-    this.name = "SynthError";
-    this.code = code;
-  }
-};
-
 // src/quirk.ts
 var PROFILE_QUIRK_APPLIED = "PROFILE_QUIRK_APPLIED";
 function sameCodeSet(a, b) {
@@ -450,12 +493,8 @@ function sameCodeSet(a, b) {
 }
 function resolveQuirk(registry, format, name2) {
   const descriptor = registry[name2];
-  if (descriptor === void 0) {
-    const supported = Object.keys(registry).sort().join(", ");
-    throw new SynthError(
-      SYNTH_FATAL_CODES.SYNTH_UNSUPPORTED_QUIRK,
-      `${format}: unsupported quirk "${name2}". The ${format} profile system supports: ${supported}.`
-    );
+  if (descriptor === void 0 || descriptor.format !== format) {
+    throw new SynthError(SYNTH_FATAL_CODES.SYNTH_UNSUPPORTED_QUIRK);
   }
   return descriptor;
 }
@@ -470,11 +509,9 @@ function profileTolerated(disposition, intendedWarnings, warningsUnderProfile) {
       return false;
   }
 }
-function assertIntendedWarnings(quirk, intendedWarnings, bareWarnings) {
+function assertIntendedWarnings(intendedWarnings, bareWarnings) {
   if (!sameCodeSet(bareWarnings, intendedWarnings)) {
-    throw new Error(
-      `quirk "${quirk}": the intended-warning contract does not hold \u2014 expected exactly [${intendedWarnings.join(", ")}] but a bare parse produced [${bareWarnings.join(", ")}]. Refusing to emit a mislabeled fixture.`
-    );
+    throw new SynthError(SYNTH_FATAL_CODES.SYNTH_INTENDED_WARNING_MISMATCH);
   }
 }
 function validateProfileQuirks(profile, registry, format) {
@@ -482,6 +519,17 @@ function validateProfileQuirks(profile, registry, format) {
   return profile.quirks;
 }
 
+// src/select.ts
+function resolveKind(allowed, requested) {
+  const match = allowed.find((value) => value === requested);
+  if (match === void 0) throw new SynthError(SYNTH_FATAL_CODES.SYNTH_UNSUPPORTED_KIND);
+  return match;
+}
+function resolveMix(allowed, requested, fallback) {
+  if (requested === void 0) return fallback;
+  return requested.map((entry) => resolveKind(allowed, entry));
+}
+
 // src/index.ts
 var VERSION = "0.0.0";
 
@@ -496,6 +544,7 @@ exports.SYNTHETIC_FAMILY_NAMES = SYNTHETIC_FAMILY_NAMES;
 exports.SYNTHETIC_GIVEN_NAMES = SYNTHETIC_GIVEN_NAMES;
 exports.SYNTHETIC_STREET_NAMES = SYNTHETIC_STREET_NAMES;
 exports.SYNTH_FATAL_CODES = SYNTH_FATAL_CODES;
+exports.SYNTH_FATAL_MESSAGES = SYNTH_FATAL_MESSAGES;
 exports.SynthError = SynthError;
 exports.TEST_NET_V4_PREFIXES = TEST_NET_V4_PREFIXES;
 exports.VERSION = VERSION;
@@ -523,6 +572,8 @@ exports.npi = npi;
 exports.npiCheckDigit = npiCheckDigit;
 exports.phone = phone;
 exports.profileTolerated = profileTolerated;
+exports.resolveKind = resolveKind;
+exports.resolveMix = resolveMix;
 exports.resolveQuirk = resolveQuirk;
 exports.safe = safe;
 exports.sameCodeSet = sameCodeSet;

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/rng/splitmix32.ts","../src/rng/sfc32.ts","../src/rng/rng.ts","../src/safe/reserved.ts","../src/safe/names-pool.ts","../src/safe/providers.ts","../src/safe/index.ts","../src/corpus.ts","../src/profile.ts","../src/codes.ts","../src/quirk.ts","../src/index.ts"],"names":["name"],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * `splitmix32` — a tiny, well-studied 32-bit mixing PRNG used **only** to expand a single integer\n * seed into the four 32-bit state words that seed {@link ../rng/sfc32.sfc32}. It is not the corpus\n * generator itself (that is `sfc32`); it exists so that a one-number seed deterministically produces a\n * well-distributed 128-bit `sfc32` state, avoiding the poor low-bit behavior of naive\n * `state = seed`-style initialization.\n *\n * Zero-dependency, `Math.random`-free (lint-enforced): the whole point of the library is that a seed —\n * and only the seed — determines the output, on any machine, any run.\n *\n * @module\n */\n\n/**\n * A stateful `splitmix32` step function. Each call advances the internal 32-bit state and returns the\n * next unsigned 32-bit integer. Deterministic for a given seed.\n *\n * @param seed - The 32-bit seed. Coerced to a 32-bit integer via `| 0`.\n * @returns A nullary function returning the next `uint32` in the stream.\n * @example\n * ```ts\n * import { splitmix32 } from \"@cosyte/synth\";\n * const next = splitmix32(12345);\n * const a = next(); // deterministic uint32\n * ```\n */\nexport function splitmix32(seed: number): () => number {\n  let a = seed | 0;\n  return function next(): number {\n    a = (a + 0x9e3779b9) | 0;\n    let t = a ^ (a >>> 16);\n    t = Math.imul(t, 0x21f0aaad);\n    t = t ^ (t >>> 15);\n    t = Math.imul(t, 0x735a2d97);\n    t = t ^ (t >>> 15);\n    return t >>> 0;\n  };\n}\n","/**\n * `sfc32` (Small Fast Counter, 32-bit, 128-bit state) — the deterministic, non-cryptographic PRNG that\n * drives every value `@cosyte/synth` generates. Chosen over `mulberry32` (whose author flags that it\n * skips ~1/3 of 32-bit outputs) and over a CSPRNG (`node:crypto`, which is **not seedable** and would\n * defeat reproducibility). A synthetic-fixture generator has **no secrets** — statistical quality plus\n * byte-for-byte reproducibility is exactly the right trade.\n *\n * The state is four 32-bit words. This module exposes the raw step function; {@link ../rng/rng.Rng}\n * wraps it with a seed-expansion ({@link ./splitmix32.splitmix32}) and the ergonomic draw helpers.\n *\n * @module\n */\n\n/**\n * The mutable four-word `sfc32` state. Threaded explicitly (never global) by {@link ../rng/rng.Rng}.\n */\nexport interface Sfc32State {\n  /** State word `a`. */\n  a: number;\n  /** State word `b`. */\n  b: number;\n  /** State word `c`. */\n  c: number;\n  /** Counter word `d`. */\n  d: number;\n}\n\n/**\n * Advance an {@link Sfc32State} in place by one step and return the next unsigned 32-bit integer.\n *\n * This is the canonical `sfc32` step. The state object is mutated (the counter `d` increments and the\n * mixing words rotate); callers that need reproducible independence hold their own state and never\n * share it — {@link ../rng/rng.Rng} creates a fresh state per seed so two runs from the same seed are\n * identical.\n *\n * @param s - The state to advance. Mutated in place.\n * @returns The next `uint32` in the stream.\n * @example\n * ```ts\n * import { sfc32Next, type Sfc32State } from \"@cosyte/synth\";\n * const s: Sfc32State = { a: 1, b: 2, c: 3, d: 4 };\n * const x = sfc32Next(s); // uint32\n * ```\n */\nexport function sfc32Next(s: Sfc32State): number {\n  s.a |= 0;\n  s.b |= 0;\n  s.c |= 0;\n  s.d |= 0;\n  const t = (((s.a + s.b) | 0) + s.d) | 0;\n  s.d = (s.d + 1) | 0;\n  s.a = s.b ^ (s.b >>> 9);\n  s.b = (s.c + (s.c << 3)) | 0;\n  s.c = (s.c << 21) | (s.c >>> 11);\n  s.c = (s.c + t) | 0;\n  return t >>> 0;\n}\n","/**\n * `Rng` — the seeded, deterministic random source every `@cosyte/synth` provider draws from.\n *\n * **The reproducibility contract.** A seed — and only the seed — determines the output.\n * `createRng(seed)` expands the integer seed through {@link ./splitmix32.splitmix32} into the four\n * `sfc32` state words, then every draw advances that state via {@link ./sfc32.sfc32Next}. Two `Rng`s\n * created from the same seed emit the **identical** sequence on any machine, any run — the property\n * the parsers', `transform`'s, and `deid`'s regression suites depend on.\n *\n * **Explicit, never global.** An `Rng` is a value you thread through a build; there is no ambient\n * shared generator and **`Math.random` is lint-banned** in `src/` (it is not seedable — its seed is\n * engine-chosen and cannot be reset, so a corpus built on it is not reproducible). Because each\n * generation creates a fresh `Rng` from its seed, generations are independent and parallel-safe.\n *\n * The `Rng` object is stateful by nature (a PRNG advances). Immutability in this library lives where it\n * is testable and matters: the generated **artifacts and the `Corpus` are deep-frozen** (see\n * `../corpus.ts`). Determinism, not object-immutability, is the `Rng`'s guarantee.\n *\n * @module\n */\n\nimport { splitmix32 } from \"./splitmix32.js\";\nimport { sfc32Next, type Sfc32State } from \"./sfc32.js\";\n\n/**\n * A seeded, deterministic random source. Created via {@link createRng}; passed explicitly to every\n * provider. All draw methods advance the internal state deterministically.\n */\nexport interface Rng {\n  /** The integer seed this generator was created from (part of the `Corpus` manifest). */\n  readonly seed: number;\n  /** The next unsigned 32-bit integer. */\n  nextUint32(): number;\n  /** The next float in `[0, 1)`. */\n  float(): number;\n  /**\n   * A uniformly-distributed integer in the inclusive range `[min, max]`.\n   *\n   * @param min - Inclusive lower bound (integer).\n   * @param max - Inclusive upper bound (integer, `>= min`).\n   */\n  int(min: number, max: number): number;\n  /** `true` with probability `p` (default `0.5`). */\n  bool(p?: number): boolean;\n  /**\n   * Pick one element from a non-empty array.\n   *\n   * @param items - A non-empty readonly array.\n   */\n  pick<T>(items: readonly T[]): T;\n  /**\n   * A string of `n` decimal digits (`0`–`9`), each drawn uniformly.\n   *\n   * @param n - The number of digits (`>= 0`).\n   */\n  digits(n: number): string;\n}\n\n/**\n * The concrete {@link Rng}. Holds the mutable `sfc32` state; every method advances it deterministically.\n */\nclass Sfc32Rng implements Rng {\n  public readonly seed: number;\n  readonly #state: Sfc32State;\n\n  public constructor(seed: number) {\n    this.seed = seed | 0;\n    // Expand the single seed into four well-distributed state words. Seeding sfc32 directly from the\n    // raw seed gives poor low-bit behavior; splitmix32 is the standard fix (bryc / roadmap §5).\n    const mix = splitmix32(this.seed);\n    this.#state = { a: mix(), b: mix(), c: mix(), d: mix() };\n    // A short warm-up so nearby seeds diverge immediately.\n    for (let i = 0; i < 8; i += 1) sfc32Next(this.#state);\n  }\n\n  public nextUint32(): number {\n    return sfc32Next(this.#state);\n  }\n\n  public float(): number {\n    return this.nextUint32() / 0x1_0000_0000;\n  }\n\n  public int(min: number, max: number): number {\n    if (max < min) throw new RangeError(`Rng.int: max (${String(max)}) < min (${String(min)})`);\n    const span = max - min + 1;\n    return min + Math.floor(this.float() * span);\n  }\n\n  public bool(p = 0.5): boolean {\n    return this.float() < p;\n  }\n\n  public pick<T>(items: readonly T[]): T {\n    if (items.length === 0) throw new RangeError(\"Rng.pick: empty array\");\n    // `int(0, length-1)` is always in-bounds on a non-empty array, so this access cannot be a hole;\n    // the cast discharges `noUncheckedIndexedAccess`'s `T | undefined` without a runtime re-check.\n    return items[this.int(0, items.length - 1)] as T;\n  }\n\n  public digits(n: number): string {\n    let out = \"\";\n    for (let i = 0; i < n; i += 1) out += String(this.int(0, 9));\n    return out;\n  }\n}\n\n/**\n * Create a seeded, deterministic {@link Rng}. The same `seed` yields the same sequence everywhere.\n *\n * @param seed - The integer seed. Coerced to a 32-bit integer.\n * @returns A fresh, independent {@link Rng}.\n * @example\n * ```ts\n * import { createRng } from \"@cosyte/synth\";\n * const rng = createRng(12345);\n * rng.int(1, 6); // deterministic for seed 12345\n * ```\n */\nexport function createRng(seed: number): Rng {\n  return new Sfc32Rng(seed);\n}\n","/**\n * The reserved / never-collide identifier facts that make a `@cosyte/synth` value **provably\n * synthetic** — the ground truth behind the synthetic-safety invariant.\n *\n * These are **facts**, not copyrighted prose: authoritative ranges published by SSA, NANPA, and the\n * IETF that are guaranteed never to denote a real person or a real routable resource. Every provider\n * draws only from these; the predicates here are the executable half of the CI synthetic-safety gate —\n * they let a test assert that no emitted value falls **outside** a reserved source.\n *\n * Sources:\n * - **SSN** — SSA never issues area numbers `000`, `666`, or `900–999`; the `987-65-4320…4329` block\n *   is SSA's explicitly-reserved advertising range. (ssa.gov)\n * - **Phone** — NANP reserves `555-0100…555-0199` as the fictional/non-working line range. (nanpa.com)\n * - **Email/domain** — RFC 2606 / RFC 6761 reserved: `example.com`/`.net`/`.org` and the `.example`,\n *   `.test`, `.invalid`, `.localhost` TLDs.\n * - **IP** — RFC 5737 IPv4 TEST-NET-1/2/3 (`192.0.2.0/24`, `198.51.100.0/24`, `203.0.113.0/24`) and\n *   RFC 3849 IPv6 documentation prefix `2001:db8::/32`.\n * - **NPI** — a real National Provider Identifier is a 10-digit number whose last digit is a Luhn\n *   check digit computed over the `80840` prefix + the 9-digit base (CMS NPI check-digit rule, ISO\n *   7812). A number whose check digit is **wrong** therefore cannot be a NPPES-issued NPI. `synth`\n *   emits NPIs with a deliberately-invalid check digit, so no generated NPI can collide with a real\n *   provider.\n *\n * @module\n */\n\n/**\n * The synthetic **assigning authority** `@cosyte/synth` mints MRNs / account / member identifiers\n * under. There is **no** reserved MRN range (an MRN is unique only within its assigning-authority /\n * OID namespace), so — a documented design decision — every synthetic identifier\n * is scoped to a namespace that clearly cannot be a real facility's: a `SYNTH`-labelled authority whose\n * OID lives under HL7's designated **example** root `2.16.840.1.113883.19`. A value under this AA can\n * never collide with a real record because the *namespace itself* is synthetic.\n */\nexport const SYNTHETIC_ASSIGNING_AUTHORITY = Object.freeze({\n  /** The human-readable assigning-authority namespace id (HL7 HD.1). */\n  namespaceId: \"COSYTE-SYNTH\",\n  /** The universal id — an OID under HL7's example arc `2.16.840.1.113883.19` (HD.2). */\n  universalId: \"2.16.840.1.113883.19.999\",\n  /** The universal id type (HD.3). */\n  universalIdType: \"ISO\",\n});\n\n/** RFC 2606 / 6761 reserved email domains `@cosyte/synth` draws from. */\nexport const RESERVED_EMAIL_DOMAINS: readonly string[] = Object.freeze([\n  \"example.com\",\n  \"example.org\",\n  \"example.net\",\n]);\n\n/** RFC 5737 IPv4 documentation (TEST-NET) `/24` network prefixes. */\nexport const TEST_NET_V4_PREFIXES: readonly string[] = Object.freeze([\n  \"192.0.2\", // TEST-NET-1\n  \"198.51.100\", // TEST-NET-2\n  \"203.0.113\", // TEST-NET-3\n]);\n\n/** RFC 3849 IPv6 documentation prefix. */\nexport const DOC_V6_PREFIX = \"2001:db8\";\n\n/**\n * The `80840` prefix prepended to a 10-digit NPI before the Luhn check (the CMS NPI check-digit\n * rule — `80840` is the ISO 7812 issuer identifier for the US health-application namespace). A real\n * NPI satisfies `luhn(\"80840\" + npi) ≡ 0 (mod 10)`.\n */\nexport const NPI_LUHN_PREFIX = \"80840\";\n\n/**\n * The Luhn sum (mod 10) of a numeric string, doubling every second digit from the right. Used to\n * verify (or deliberately break) an NPI check digit.\n *\n * @param digits - A string of decimal digits.\n * @returns The Luhn sum modulo 10 (0 ⇒ the string passes the Luhn check).\n * @internal\n */\nexport function luhnMod10(digits: string): number {\n  let sum = 0;\n  // Standard Luhn: the RIGHTMOST digit is never doubled; doubling starts one position in and\n  // alternates. For a full payload+check string this makes a Luhn-valid string sum to 0 (mod 10);\n  // for a payload with a `0` placeholder in the check position it yields the complement of the\n  // correct check digit.\n  let double = false;\n  for (let i = digits.length - 1; i >= 0; i -= 1) {\n    let d = digits.charCodeAt(i) - 48;\n    if (d < 0 || d > 9) continue;\n    if (double) {\n      d *= 2;\n      if (d > 9) d -= 9;\n    }\n    sum += d;\n    double = !double;\n  }\n  return sum % 10;\n}\n\n/**\n * The correct NPI check digit for a 9-digit base — the value that makes `80840` + base + check pass\n * the Luhn check.\n *\n * @param base9 - The 9-digit NPI base (positions 1–9).\n * @returns The check digit (`0`–`9`) a real NPI would carry for this base.\n * @example\n * ```ts\n * import { npiCheckDigit } from \"@cosyte/synth\";\n * npiCheckDigit(\"123456789\"); // 3 — so 1234567893 is a Luhn-valid NPI shape\n * ```\n */\nexport function npiCheckDigit(base9: string): number {\n  // Luhn over \"80840\" + base9 with a trailing 0 check placeholder; the check digit closes the sum.\n  const partial = luhnMod10(`${NPI_LUHN_PREFIX}${base9}0`);\n  return (10 - partial) % 10;\n}\n\n/**\n * The DEA-registration prefix letters `@cosyte/synth` draws a synthetic DEA number's first character\n * from. A real DEA number is `<registrant-type><last-name-initial>` + 7 digits; the first letter is the\n * registrant type (A/B/F/G/M/P/R/X are the widely-published values; the second letter is the\n * registrant's last-name initial). These letters are a **fact** about the number's shape, not\n * copyrighted prose — they only shape the value; the synthetic guarantee is the deliberately-**invalid\n * checksum** (see {@link dea} / {@link isSyntheticDea}).\n */\nexport const DEA_REGISTRANT_TYPES: readonly string[] = Object.freeze([\n  \"A\",\n  \"B\",\n  \"F\",\n  \"G\",\n  \"M\",\n  \"P\",\n  \"R\",\n  \"X\",\n]);\n\n/**\n * The correct DEA check digit for a 7-digit numeric base. The published DEA checksum is\n * `(d1 + d3 + d5) + 2·(d2 + d4 + d6)`, whose **units digit** is the 7th (check) digit. A real DEA\n * number satisfies this; a number whose 7th digit differs cannot be a validly-issued DEA registration.\n *\n * @param base6 - The first 6 digits of the DEA number (positions 1–6).\n * @returns The check digit (`0`–`9`) a real DEA number would carry for this base.\n * @example\n * ```ts\n * import { deaCheckDigit } from \"@cosyte/synth\";\n * deaCheckDigit(\"123456\"); // the units digit of (1+3+5) + 2·(2+4+6)\n * ```\n */\nexport function deaCheckDigit(base6: string): number {\n  let odd = 0;\n  let even = 0;\n  for (let i = 0; i < 6; i += 1) {\n    const digit = base6.charCodeAt(i) - 48;\n    if (i % 2 === 0) odd += digit;\n    else even += digit;\n  }\n  return (odd + 2 * even) % 10;\n}\n\n/**\n * Whether a DEA number (`XX` + 7 digits, case-insensitive) is **provably synthetic** — its check digit\n * (the 7th digit) does **not** match the published DEA checksum, so it cannot be a validly-issued DEA\n * registration. A checksum-valid DEA number (which *could* denote a real prescriber) returns `false`; a\n * value that is not the DEA shape returns `false`.\n *\n * @param value - The candidate DEA number (with or without incidental separators).\n * @returns `true` when the DEA number's checksum is wrong (never a real DEA registration).\n * @example\n * ```ts\n * import { isSyntheticDea } from \"@cosyte/synth\";\n * isSyntheticDea(\"AF1234561\"); // depends on the base — true when the 7th digit is wrong\n * ```\n */\nexport function isSyntheticDea(value: string): boolean {\n  const compact = value.replace(/[\\s-]/g, \"\").toUpperCase();\n  if (!/^[A-Z]{2}\\d{7}$/.test(compact)) return false;\n  const digits = compact.slice(2);\n  const check = digits.charCodeAt(6) - 48;\n  return deaCheckDigit(digits.slice(0, 6)) !== check;\n}\n\n/**\n * Whether a 10-digit NPI is **provably synthetic** — i.e. its check digit is invalid, so it cannot be\n * a NPPES-issued NPI. A Luhn-valid 10-digit NPI (which *could* denote a real registered provider)\n * returns `false`; a non-10-digit value returns `false` (not an NPI shape).\n *\n * @param value - The candidate NPI (digits only, or with incidental separators).\n * @returns `true` when the NPI's check digit is wrong (never a real NPI).\n * @example\n * ```ts\n * import { isSyntheticNpi } from \"@cosyte/synth\";\n * isSyntheticNpi(\"1234567894\"); // true  — invalid check digit (valid would be 1234567893)\n * isSyntheticNpi(\"1234567893\"); // false — Luhn-valid, could be a real NPI\n * ```\n */\nexport function isSyntheticNpi(value: string): boolean {\n  const digits = value.replace(/\\D/g, \"\");\n  if (digits.length !== 10) return false;\n  return luhnMod10(`${NPI_LUHN_PREFIX}${digits}`) !== 0;\n}\n\n/**\n * Whether a `ddd-dd-dddd` (or `ddddddddd`) SSN string is drawn from an SSA never-issued / reserved\n * space — area `000`, `666`, or `900–999`. A real, issuable SSN returns `false`.\n *\n * @param value - The candidate SSN (dashes optional).\n * @returns `true` when the SSN is provably synthetic.\n * @example\n * ```ts\n * import { isSyntheticSsn } from \"@cosyte/synth\";\n * isSyntheticSsn(\"900-12-3456\"); // true (never issued)\n * isSyntheticSsn(\"123456789\");   // false (issuable area 123)\n * ```\n */\nexport function isSyntheticSsn(value: string): boolean {\n  const digits = value.replace(/\\D/g, \"\");\n  if (digits.length !== 9) return false;\n  const area = Number(digits.slice(0, 3));\n  return area === 0 || area === 666 || area >= 900;\n}\n\n/**\n * Whether a phone string contains the NANP `555-0100…555-0199` reserved fictional line range.\n *\n * @param value - The candidate phone (any formatting).\n * @returns `true` when the number is in the reserved fictional block.\n * @example\n * ```ts\n * import { isSyntheticPhone } from \"@cosyte/synth\";\n * isSyntheticPhone(\"(202) 555-0142\"); // true\n * ```\n */\nexport function isSyntheticPhone(value: string): boolean {\n  const digits = value.replace(/\\D/g, \"\");\n  // The reserved guarantee is the 7-digit tail: exchange 555 + line 01NN.\n  const tail = digits.slice(-7);\n  return /^555 ?01\\d\\d$/.test(tail) || /^55501\\d\\d$/.test(tail);\n}\n\n/**\n * Whether an email's domain is an RFC 2606 / 6761 reserved / test domain.\n *\n * @param value - The candidate email address.\n * @returns `true` when the domain is reserved (never real).\n * @example\n * ```ts\n * import { isSyntheticEmail } from \"@cosyte/synth\";\n * isSyntheticEmail(\"faux.testerson@example.com\"); // true\n * ```\n */\nexport function isSyntheticEmail(value: string): boolean {\n  const at = value.lastIndexOf(\"@\");\n  if (at < 0) return false;\n  const domain = value.slice(at + 1).toLowerCase();\n  if (RESERVED_EMAIL_DOMAINS.includes(domain)) return true;\n  return /\\.(example|test|invalid|localhost)$/.test(domain);\n}\n\n/**\n * Whether an IP string is in an RFC 5737 (IPv4 TEST-NET) or RFC 3849 (IPv6 documentation) reserved\n * block. A real routable address returns `false`.\n *\n * @param value - The candidate IPv4 or IPv6 address.\n * @returns `true` when the address is a reserved documentation address.\n * @example\n * ```ts\n * import { isSyntheticIp } from \"@cosyte/synth\";\n * isSyntheticIp(\"192.0.2.44\");  // true (TEST-NET-1)\n * isSyntheticIp(\"8.8.8.8\");     // false (real)\n * ```\n */\nexport function isSyntheticIp(value: string): boolean {\n  if (value.toLowerCase().startsWith(`${DOC_V6_PREFIX}:`)) return true;\n  return TEST_NET_V4_PREFIXES.some((prefix) => value.startsWith(`${prefix}.`));\n}\n","/**\n * The shipped **clearly-fake name pool** — `@cosyte/synth`'s own license-clean synthetic data.\n *\n * Deliberately **not** a `faker`-style realistic-name corpus (which could match a real person at a real\n * address — the exact hazard the synthetic-safety invariant forbids). Every token is\n * an obviously-invented, fixture-flavoured word: a reader can tell at a glance it names no one. The pool\n * is small on purpose — structural coverage, not demographic realism, is the goal.\n *\n * `# synthetic: true`\n *\n * @module\n */\n\n/** Obviously-synthetic given names. None is a plausible real person's name. */\nexport const SYNTHETIC_GIVEN_NAMES: readonly string[] = Object.freeze([\n  \"Testina\",\n  \"Fixtura\",\n  \"Synthos\",\n  \"Placeholda\",\n  \"Sampleton\",\n  \"Prototius\",\n  \"Stubbina\",\n  \"Exampla\",\n  \"Quilliam\",\n  \"Fabrica\",\n  \"Simula\",\n  \"Testry\",\n  \"Seedwin\",\n  \"Corpora\",\n  \"Reprodo\",\n  \"Mocktavia\",\n  \"Dummett\",\n  \"Voidwin\",\n  \"Deteria\",\n  \"Randomir\",\n]);\n\n/** Obviously-synthetic family names. None is a plausible real surname at a real address. */\nexport const SYNTHETIC_FAMILY_NAMES: readonly string[] = Object.freeze([\n  \"Testerson\",\n  \"Fauxman\",\n  \"Placeholt\",\n  \"Mockridge\",\n  \"Fixtingham\",\n  \"Synthwell\",\n  \"Dummerton\",\n  \"Examplewood\",\n  \"Fabricant\",\n  \"Simulacre\",\n  \"Nonesuch\",\n  \"Seedman\",\n  \"Corpusworth\",\n  \"Reprodus\",\n  \"Voidmark\",\n  \"Deterwood\",\n  \"Randomson\",\n  \"Quillfeather\",\n  \"Notreal\",\n  \"Genfield\",\n]);\n\n/** Obviously-synthetic street names for structured address fields. */\nexport const SYNTHETIC_STREET_NAMES: readonly string[] = Object.freeze([\n  \"Fixture Lane\",\n  \"Sample Street\",\n  \"Placeholder Avenue\",\n  \"Synthetic Way\",\n  \"Example Boulevard\",\n  \"Testing Terrace\",\n  \"Mock Road\",\n  \"Prototype Court\",\n]);\n\n/**\n * Obviously-synthetic city names. Combined only ever with a synthetic street + a fake name (the\n * *combination* is what identifies, and the combination is always synthetic).\n */\nexport const SYNTHETIC_CITY_NAMES: readonly string[] = Object.freeze([\n  \"Faketon\",\n  \"Synthville\",\n  \"Exampleburg\",\n  \"Testford\",\n  \"Mockhaven\",\n  \"Fixtureton\",\n]);\n","/**\n * The synthetic-safety provider layer — every identifier, contact point, name, and date\n * `@cosyte/synth` emits is minted here, and **only** from a guaranteed-non-colliding source. There is no code\n * path that returns a value not drawn from a reserved range or the\n * shipped fake-name pool. This is the inverse of a parser's liberality: the generator is *closed-world*\n * on its data sources, so no output *can* be real or plausibly-real PHI.\n *\n * All providers are pure functions of an explicit {@link ../rng/rng.Rng} — same seed, same values.\n *\n * @module\n */\n\nimport type { Rng } from \"../rng/rng.js\";\n\nimport {\n  RESERVED_EMAIL_DOMAINS,\n  TEST_NET_V4_PREFIXES,\n  DOC_V6_PREFIX,\n  SYNTHETIC_ASSIGNING_AUTHORITY,\n  npiCheckDigit,\n  deaCheckDigit,\n  DEA_REGISTRANT_TYPES,\n} from \"./reserved.js\";\nimport {\n  SYNTHETIC_GIVEN_NAMES,\n  SYNTHETIC_FAMILY_NAMES,\n  SYNTHETIC_STREET_NAMES,\n  SYNTHETIC_CITY_NAMES,\n} from \"./names-pool.js\";\n\n/** A synthetic person name drawn from the shipped fake-name pool. */\nexport interface SyntheticName {\n  /** A clearly-fake given name. */\n  readonly given: string;\n  /** A clearly-fake family name. */\n  readonly family: string;\n}\n\n/** A synthetic postal address — synthetic street + city, a fixed non-real ZIP. */\nexport interface SyntheticAddress {\n  /** A clearly-fake street line. */\n  readonly street: string;\n  /** A clearly-fake city. */\n  readonly city: string;\n  /** A US state abbreviation (structural only; never combined with a real street + name + DOB). */\n  readonly state: string;\n  /** A reserved non-real ZIP (`00000`). */\n  readonly zip: string;\n}\n\n/** A synthetic identifier scoped to the synthetic assigning authority. */\nexport interface SyntheticIdentifier {\n  /** The identifier value (digits) — unique only within the synthetic namespace. */\n  readonly value: string;\n  /** HL7 identifier type code (`MR` = medical record, `AN` = account, `MB` = member). */\n  readonly typeCode: \"MR\" | \"AN\" | \"MB\";\n  /** The synthetic assigning-authority namespace id. */\n  readonly assigningAuthority: string;\n  /** The synthetic assigning-authority OID (HL7 example arc). */\n  readonly assigningAuthorityOid: string;\n}\n\n/** Which SSN reserved space to draw from. */\nexport type SsnBlock = \"never-issued\" | \"advertising\";\n\n/**\n * A **synthetic SSN** — dashed `AAA-GG-SSSS`. Default draws the SSA never-issued area space\n * (`900–999`); `block: \"advertising\"` draws SSA's reserved advertising block (`987-65-4320…4329`).\n * A value from this function can never be a real SSN.\n *\n * @param rng - The seeded generator.\n * @param block - Which reserved space to draw from. Defaults to `\"never-issued\"`.\n * @returns A dashed synthetic SSN string.\n * @example\n * ```ts\n * import { createRng, ssn } from \"@cosyte/synth\";\n * ssn(createRng(1)); // e.g. a 900-area, never-issued SSN\n * ```\n */\nexport function ssn(rng: Rng, block: SsnBlock = \"never-issued\"): string {\n  if (block === \"advertising\") {\n    // SSA's explicitly-reserved advertising block: last digit 0..9 within -4320..-4329.\n    return `987-65-432${String(rng.int(0, 9))}`;\n  }\n  const area = rng.int(900, 999); // SSA never issues 900-999.\n  const group = rng.digits(2);\n  const serial = rng.digits(4);\n  return `${String(area)}-${group}-${serial}`;\n}\n\n/**\n * A **synthetic phone** in the NANP reserved fictional block — `(AAA) 555-01NN`. The reserved\n * guarantee is the `555-01NN` tail (exchange 555, line 0100–0199); the area code is any NANP-valid\n * `NXX`. Can never be a working number.\n *\n * @param rng - The seeded generator.\n * @returns A formatted synthetic phone string.\n * @example\n * ```ts\n * import { createRng, phone } from \"@cosyte/synth\";\n * phone(createRng(1)); // e.g. \"(2XX) 555-01NN\"\n * ```\n */\nexport function phone(rng: Rng): string {\n  const area = `${String(rng.int(2, 9))}${rng.digits(2)}`; // NXX area code.\n  const line = `01${rng.digits(2)}`; // reserved 0100-0199.\n  return `(${area}) 555-${line}`;\n}\n\n/**\n * A **synthetic name** drawn from the shipped clearly-fake pool.\n *\n * @param rng - The seeded generator.\n * @returns A {@link SyntheticName}.\n * @example\n * ```ts\n * import { createRng, name } from \"@cosyte/synth\";\n * const { given, family } = name(createRng(1));\n * ```\n */\nexport function name(rng: Rng): SyntheticName {\n  return { given: rng.pick(SYNTHETIC_GIVEN_NAMES), family: rng.pick(SYNTHETIC_FAMILY_NAMES) };\n}\n\n/**\n * A **synthetic email** at an RFC 2606 / 6761 reserved domain — `<slug>@example.com`.\n *\n * @param rng - The seeded generator.\n * @param person - Optional name to derive the local-part slug from; otherwise a random slug is used.\n * @returns A synthetic email address.\n * @example\n * ```ts\n * import { createRng, email, name } from \"@cosyte/synth\";\n * email(createRng(1), name(createRng(1))); // \"<given>.<family>@example.com\"\n * ```\n */\nexport function email(rng: Rng, person?: SyntheticName): string {\n  const domain = rng.pick(RESERVED_EMAIL_DOMAINS);\n  const slug = person ? `${person.given}.${person.family}`.toLowerCase() : `synth${rng.digits(6)}`;\n  return `${slug}@${domain}`;\n}\n\n/**\n * A **synthetic IPv4** in an RFC 5737 TEST-NET block — never routable.\n *\n * @param rng - The seeded generator.\n * @returns A TEST-NET IPv4 address string.\n * @example\n * ```ts\n * import { createRng, ipv4 } from \"@cosyte/synth\";\n * ipv4(createRng(1)); // e.g. \"192.0.2.NN\"\n * ```\n */\nexport function ipv4(rng: Rng): string {\n  return `${rng.pick(TEST_NET_V4_PREFIXES)}.${String(rng.int(1, 254))}`;\n}\n\n/**\n * A **synthetic IPv6** in the RFC 3849 documentation prefix `2001:db8::/32` — never routable.\n *\n * @param rng - The seeded generator.\n * @returns A documentation-prefix IPv6 address string.\n * @example\n * ```ts\n * import { createRng, ipv6 } from \"@cosyte/synth\";\n * ipv6(createRng(1)); // e.g. \"2001:db8::NNNN\"\n * ```\n */\nexport function ipv6(rng: Rng): string {\n  const tail = rng.nextUint32().toString(16).padStart(4, \"0\").slice(-4);\n  return `${DOC_V6_PREFIX}::${tail}`;\n}\n\n/**\n * A **deterministic UUIDv4-shaped** surrogate key from the seeded generator. Because it is seeded (not\n * from `node:crypto`, which is not reproducible), the cryptographic non-collision argument is weaker —\n * acceptable because the identifier namespace is synthetic anyway, and noted honestly.\n *\n * @param rng - The seeded generator.\n * @returns A canonical `8-4-4-4-12` lowercase-hex UUID string with version `4` and RFC 4122 variant.\n * @example\n * ```ts\n * import { createRng, uuid } from \"@cosyte/synth\";\n * uuid(createRng(1)); // \"xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx\"\n * ```\n */\nexport function uuid(rng: Rng): string {\n  const bytes = new Uint8Array(16);\n  for (let i = 0; i < 16; i += 1) bytes[i] = rng.int(0, 255);\n  bytes[6] = ((bytes[6] ?? 0) & 0x0f) | 0x40; // version 4\n  bytes[8] = ((bytes[8] ?? 0) & 0x3f) | 0x80; // variant 10xx\n  const hex = Array.from(bytes, (b) => b.toString(16).padStart(2, \"0\"));\n  return `${hex.slice(0, 4).join(\"\")}-${hex.slice(4, 6).join(\"\")}-${hex.slice(6, 8).join(\"\")}-${hex.slice(8, 10).join(\"\")}-${hex.slice(10, 16).join(\"\")}`;\n}\n\n/**\n * A **synthetic NPI** — a 10-digit National Provider Identifier with a **deliberately-invalid Luhn\n * check digit**, so it can never be a NPPES-issued NPI (a real NPI must satisfy the `80840`-prefixed\n * Luhn check). The 9-digit base is drawn from the seeded generator; the check digit is\n * set to `(correct + 1) mod 10`, guaranteeing the full value fails validation.\n *\n * @param rng - The seeded generator.\n * @returns A 10-digit NPI-shaped string that is provably not a real NPI.\n * @example\n * ```ts\n * import { createRng, npi, isSyntheticNpi } from \"@cosyte/synth\";\n * isSyntheticNpi(npi(createRng(1))); // true — invalid check digit by construction\n * ```\n */\nexport function npi(rng: Rng): string {\n  const base9 = rng.digits(9);\n  const wrongCheck = (npiCheckDigit(base9) + 1) % 10;\n  return `${base9}${String(wrongCheck)}`;\n}\n\n/**\n * A **synthetic DEA number** — `<registrant-type><initial>` + 7 digits with a **deliberately-invalid\n * checksum**, so it can never be a validly-issued DEA registration (a real DEA number's 7th digit\n * satisfies the published DEA checksum). The first letter is a registrant-type letter, the\n * second is derived from `person` (its family initial) when supplied so the number reads plausibly; the\n * 6-digit base is seeded and the check digit is set to `(correct + 1) mod 10`, guaranteeing the value\n * fails validation. NCPDP carries prescriber DEA, and this is the identity locus a refuter attacks\n * hardest, so — like {@link npi} — non-collision is a construction-level guarantee, not a heuristic.\n *\n * @param rng - The seeded generator.\n * @param person - Optional name whose family initial becomes the DEA's second letter.\n * @returns A DEA-shaped string that is provably not a real DEA registration.\n * @example\n * ```ts\n * import { createRng, dea, isSyntheticDea } from \"@cosyte/synth\";\n * isSyntheticDea(dea(createRng(1))); // true — invalid checksum by construction\n * ```\n */\nexport function dea(rng: Rng, person?: SyntheticName): string {\n  const type = rng.pick(DEA_REGISTRANT_TYPES);\n  const initialSource = person?.family ?? rng.pick(SYNTHETIC_FAMILY_NAMES);\n  const initial = initialSource.slice(0, 1).toUpperCase();\n  const base6 = rng.digits(6);\n  const wrongCheck = (deaCheckDigit(base6) + 1) % 10;\n  return `${type}${initial}${base6}${String(wrongCheck)}`;\n}\n\n/**\n * A **synthetic identifier** (MRN / account / member id) scoped to the synthetic assigning authority.\n * There is no reserved MRN range, so non-collision is guaranteed by the *namespace*, not the value: the\n * identifier lives under a `SYNTH` authority no real facility uses.\n *\n * @param rng - The seeded generator.\n * @param typeCode - The HL7 identifier type: `MR` (default), `AN`, or `MB`.\n * @returns A {@link SyntheticIdentifier}.\n * @example\n * ```ts\n * import { createRng, identifier } from \"@cosyte/synth\";\n * identifier(createRng(1), \"MR\"); // { value, typeCode: \"MR\", assigningAuthority: \"COSYTE-SYNTH\", ... }\n * ```\n */\nexport function identifier(\n  rng: Rng,\n  typeCode: SyntheticIdentifier[\"typeCode\"] = \"MR\",\n): SyntheticIdentifier {\n  return {\n    value: rng.digits(8),\n    typeCode,\n    assigningAuthority: SYNTHETIC_ASSIGNING_AUTHORITY.namespaceId,\n    assigningAuthorityOid: SYNTHETIC_ASSIGNING_AUTHORITY.universalId,\n  };\n}\n\n/**\n * A **synthetic address** — a fake street + city, a reserved non-real ZIP (`00000`). A real state\n * abbreviation may appear (structural only) but is never combined with a real street + name + DOB.\n *\n * @param rng - The seeded generator.\n * @returns A {@link SyntheticAddress}.\n * @example\n * ```ts\n * import { createRng, address } from \"@cosyte/synth\";\n * address(createRng(1)); // { street, city, state, zip: \"00000\" }\n * ```\n */\nexport function address(rng: Rng): SyntheticAddress {\n  const number = rng.int(1, 9999);\n  return {\n    street: `${String(number)} ${rng.pick(SYNTHETIC_STREET_NAMES)}`,\n    city: rng.pick(SYNTHETIC_CITY_NAMES),\n    state: rng.pick(US_STATES),\n    zip: \"00000\",\n  };\n}\n\n/**\n * A **synthetic date** in HL7 `YYYYMMDD` form, drawn uniformly within an inclusive year range. Comes\n * from the seeded generator (never wall-clock), so it is reproducible and implies no real event.\n *\n * @param rng - The seeded generator.\n * @param minYear - Inclusive lower year bound (default `1930`).\n * @param maxYear - Inclusive upper year bound (default `2010`).\n * @returns An `YYYYMMDD` date string (always a valid calendar day).\n * @example\n * ```ts\n * import { createRng, dateYmd } from \"@cosyte/synth\";\n * dateYmd(createRng(1), 1970, 2000); // \"YYYYMMDD\"\n * ```\n */\nexport function dateYmd(rng: Rng, minYear = 1930, maxYear = 2010): string {\n  const year = rng.int(minYear, maxYear);\n  const month = rng.int(1, 12);\n  const daysInMonth = new Date(Date.UTC(year, month, 0)).getUTCDate();\n  const day = rng.int(1, daysInMonth);\n  return `${String(year).padStart(4, \"0\")}${String(month).padStart(2, \"0\")}${String(day).padStart(2, \"0\")}`;\n}\n\n/** US state abbreviations — structural only (see {@link address}). */\nconst US_STATES: readonly string[] = Object.freeze([\n  \"AL\",\n  \"AK\",\n  \"AZ\",\n  \"AR\",\n  \"CA\",\n  \"CO\",\n  \"CT\",\n  \"DE\",\n  \"FL\",\n  \"GA\",\n  \"HI\",\n  \"ID\",\n  \"IL\",\n  \"IN\",\n  \"IA\",\n  \"KS\",\n  \"KY\",\n  \"LA\",\n  \"ME\",\n  \"MD\",\n  \"MA\",\n  \"MI\",\n  \"MN\",\n  \"MS\",\n  \"MO\",\n  \"MT\",\n  \"NE\",\n  \"NV\",\n  \"NH\",\n  \"NJ\",\n  \"NM\",\n  \"NY\",\n  \"NC\",\n  \"ND\",\n  \"OH\",\n  \"OK\",\n  \"OR\",\n  \"PA\",\n  \"RI\",\n  \"SC\",\n  \"SD\",\n  \"TN\",\n  \"TX\",\n  \"UT\",\n  \"VT\",\n  \"VA\",\n  \"WA\",\n  \"WV\",\n  \"WI\",\n  \"WY\",\n]);\n","/**\n * The `safe` namespace — the single entry point for every synthetic-by-construction value provider.\n *\n * Grouped under one object so a consumer reads `safe.ssn(rng)` / `safe.phone(rng)` and it is\n * self-evident that the value is drawn from a guaranteed-non-colliding synthetic source.\n * The individual functions and the reserved-range predicates are also exported by name from the\n * package root for direct import.\n *\n * @module\n */\n\nimport {\n  ssn,\n  phone,\n  name,\n  email,\n  ipv4,\n  ipv6,\n  uuid,\n  identifier,\n  address,\n  dateYmd,\n  npi,\n  dea,\n} from \"./providers.js\";\n\nexport * from \"./providers.js\";\nexport * from \"./reserved.js\";\nexport * from \"./names-pool.js\";\n\n/**\n * The synthetic-safety provider namespace. Every function draws only from a reserved range or the\n * shipped fake-name pool — no value it returns can be real or plausibly-real PHI.\n *\n * @example\n * ```ts\n * import { createRng, safe } from \"@cosyte/synth\";\n * const rng = createRng(42);\n * safe.ssn(rng);   // never-issued SSN\n * safe.phone(rng); // reserved 555-01NN number\n * ```\n */\nexport const safe = Object.freeze({\n  ssn,\n  phone,\n  name,\n  email,\n  ipv4,\n  ipv6,\n  uuid,\n  identifier,\n  address,\n  dateYmd,\n  npi,\n  dea,\n});\n","/**\n * The `Corpus` abstraction — a seed plus a self-describing manifest of what was generated, so a\n * fixture set is itself reproducible and regenerable. A downstream repo pins a seed\n * and gets a stable fixture set that regenerates identically.\n *\n * Generated artifacts and the `Corpus` are **deep-frozen** — this is where the archetype's immutability\n * invariant lives in a generator: a consumer cannot mutate a shared fixture out from under\n * another test.\n *\n * @module\n */\n\n/** The format an artifact was generated for. */\nexport type SynthFormat = \"hl7v2\" | \"fhir\" | \"ccda\" | \"x12\" | \"ncpdp\" | \"astm\";\n\n/**\n * One generated artifact — the serialized wire text plus the metadata needed to reproduce and check\n * it. `warnings` records what the artifact's own parser reported on the round-trip (zero for a\n * spec-clean artifact).\n */\nexport interface Artifact {\n  /** The format this artifact belongs to. */\n  readonly format: SynthFormat;\n  /** A format-specific kind label (e.g. `\"ADT^A01\"`). */\n  readonly kind: string;\n  /** The serialized wire text, produced by the parser's own conservative serializer. */\n  readonly content: string;\n  /** The warning codes the parser emitted when the artifact was round-tripped (empty = spec-clean). */\n  readonly warnings: readonly string[];\n}\n\n/** A self-describing manifest of a {@link Corpus}. */\nexport interface CorpusManifest {\n  /** The formats present in the corpus. */\n  readonly formats: readonly SynthFormat[];\n  /** Per-kind artifact counts (e.g. `{ \"ADT^A01\": 3 }`). */\n  readonly counts: Readonly<Record<string, number>>;\n  /** The quirk names applied. */\n  readonly quirks: readonly string[];\n}\n\n/** A reproducible, self-describing set of generated artifacts. */\nexport interface Corpus {\n  /** The seed the corpus was generated from — regenerating from it yields byte-identical artifacts. */\n  readonly seed: number;\n  /** The manifest describing what was generated. */\n  readonly manifest: CorpusManifest;\n  /** The generated artifacts, in generation order. */\n  readonly artifacts: readonly Artifact[];\n}\n\n/**\n * Assemble a deep-frozen {@link Corpus} from a seed and its artifacts, deriving the manifest.\n *\n * @param seed - The seed the artifacts were generated from.\n * @param artifacts - The generated artifacts, in order.\n * @param quirks - The quirk names applied (default none).\n * @returns A deep-frozen, self-describing {@link Corpus}.\n * @example\n * ```ts\n * import { makeCorpus } from \"@cosyte/synth\";\n * const corpus = makeCorpus(1, [{ format: \"hl7v2\", kind: \"ADT^A01\", content, warnings: [] }]);\n * corpus.manifest.counts[\"ADT^A01\"]; // 1\n * ```\n */\nexport function makeCorpus(\n  seed: number,\n  artifacts: readonly Artifact[],\n  quirks: readonly string[] = [],\n): Corpus {\n  const counts: Record<string, number> = {};\n  const formats = new Set<SynthFormat>();\n  const frozenArtifacts = artifacts.map((a) => {\n    counts[a.kind] = (counts[a.kind] ?? 0) + 1;\n    formats.add(a.format);\n    return Object.freeze({ ...a, warnings: Object.freeze([...a.warnings]) });\n  });\n  const manifest: CorpusManifest = Object.freeze({\n    formats: Object.freeze([...formats]),\n    counts: Object.freeze(counts),\n    quirks: Object.freeze([...quirks]),\n  });\n  return Object.freeze({\n    seed,\n    manifest,\n    artifacts: Object.freeze(frozenArtifacts),\n  });\n}\n","/**\n * `defineSynthProfile` — the growth-loop hook for site/vendor fixture recipes. A profile bundles the\n * value pools and the quirk recipe a fixture set should use, authored through the same public API as\n * the built-ins: a validated, frozen `SynthProfile` carrying a name, optional value overrides, and the\n * quirk names a format's quirk corpus should apply.\n *\n * @module\n */\n\n/** The user-authored spec passed to {@link defineSynthProfile}. */\nexport interface SynthProfileSpec {\n  /** A stable, human-readable profile name (e.g. `\"acme-hospital\"`). Required, non-empty. */\n  readonly name: string;\n  /** Optional given-name pool override (clearly-synthetic names only — see the safety invariant). */\n  readonly givenNames?: readonly string[];\n  /** Optional family-name pool override (clearly-synthetic names only). */\n  readonly familyNames?: readonly string[];\n  /**\n   * The vendor quirk recipe names this profile requests. Validated against the target format's quirk\n   * registry when the profile drives a quirk corpus (an unsupported quirk is a fatal\n   * `SYNTH_UNSUPPORTED_QUIRK`, never a silent no-op).\n   */\n  readonly quirks?: readonly string[];\n}\n\n/** A frozen, validated fixture recipe produced by {@link defineSynthProfile}. */\nexport interface SynthProfile {\n  /** The profile name. */\n  readonly name: string;\n  /** The given-name pool this profile draws from (overrides or the built-in default). */\n  readonly givenNames?: readonly string[];\n  /** The family-name pool this profile draws from. */\n  readonly familyNames?: readonly string[];\n  /** The requested quirk recipe names. */\n  readonly quirks: readonly string[];\n}\n\n/**\n * Define a reusable, frozen synthetic-fixture profile.\n *\n * @param spec - The profile spec; `name` is required and non-empty.\n * @returns A deep-frozen {@link SynthProfile}.\n * @throws TypeError when `name` is missing or blank.\n * @example\n * ```ts\n * import { defineSynthProfile } from \"@cosyte/synth\";\n * const acme = defineSynthProfile({ name: \"acme-hospital\", quirks: [] });\n * ```\n */\nexport function defineSynthProfile(spec: SynthProfileSpec): SynthProfile {\n  if (typeof spec.name !== \"string\" || spec.name.trim().length === 0) {\n    throw new TypeError(\"defineSynthProfile: `name` is required and must be a non-empty string.\");\n  }\n  return Object.freeze({\n    name: spec.name,\n    ...(spec.givenNames ? { givenNames: Object.freeze([...spec.givenNames]) } : {}),\n    ...(spec.familyNames ? { familyNames: Object.freeze([...spec.familyNames]) } : {}),\n    quirks: Object.freeze([...(spec.quirks ?? [])]),\n  });\n}\n","/**\n * Stable diagnostic codes for `@cosyte/synth` and the {@link SynthError} they travel on.\n *\n * Unlike a parser (which recovers from bad *input* into Tier-2 warnings), a **generator** has no input\n * to tolerate — its reflex is *synthetic-by-construction* and *fail-closed on impossibility*. So the\n * codes here are **fatal**: a caller asked for something the library cannot honor spec-clean, and the\n * only safe answer is to throw, never to silently fabricate a value or a byte workaround. Codes are `key ===\n * value` and part of the public contract —\n * renaming one is a breaking change.\n *\n * @module\n */\n\n/**\n * The stable **fatal** code registry. Additions-only thereafter.\n *\n * @example\n * ```ts\n * import { SYNTH_FATAL_CODES, SynthError } from \"@cosyte/synth\";\n * try {\n *   // ...generate...\n * } catch (err) {\n *   if (err instanceof SynthError && err.code === SYNTH_FATAL_CODES.SYNTH_UNSUPPORTED_FORMAT) {\n *     // handle an unsupported format request\n *   }\n * }\n * ```\n */\nexport const SYNTH_FATAL_CODES = {\n  /**\n   * A format was requested that this build cannot generate through a real parser builder/serializer\n   * (e.g. ASTM before `@cosyte/astm`'s serializer ships). Fatal — never a hand-written byte fallback.\n   */\n  SYNTH_UNSUPPORTED_FORMAT: \"SYNTH_UNSUPPORTED_FORMAT\",\n  /**\n   * A vendor quirk was requested that the target format's profile system does not support. Fatal —\n   * never a silent no-op and never a fabricated quirk.\n   */\n  SYNTH_UNSUPPORTED_QUIRK: \"SYNTH_UNSUPPORTED_QUIRK\",\n} as const;\n\n/**\n * A value from {@link SYNTH_FATAL_CODES} — the type carried by a thrown {@link SynthError}.\n */\nexport type SynthFatalCode = (typeof SYNTH_FATAL_CODES)[keyof typeof SYNTH_FATAL_CODES];\n\n/**\n * The typed error every fatal `@cosyte/synth` condition throws. Carries a stable\n * {@link SynthFatalCode} so callers branch on `err.code` without matching message text.\n *\n * @example\n * ```ts\n * import { SynthError, SYNTH_FATAL_CODES } from \"@cosyte/synth\";\n * throw new SynthError(SYNTH_FATAL_CODES.SYNTH_UNSUPPORTED_FORMAT, \"astm is not yet generable\");\n * ```\n */\nexport class SynthError extends Error {\n  /** The stable fatal code. */\n  public readonly code: SynthFatalCode;\n\n  /**\n   * @param code - The stable {@link SynthFatalCode}.\n   * @param message - A human-readable detail (never contains PHI — there is none).\n   */\n  public constructor(code: SynthFatalCode, message: string) {\n    super(message);\n    this.name = \"SynthError\";\n    this.code = code;\n  }\n}\n","/**\n * The **quirk core**. Where the spec-clean generators prove\n * *synthetic-by-construction* through each parser's own builder, the quirk layer proves the mirror\n * property: a **deliberately off-spec** fixture round-trips to **exactly the intended parser warning\n * code(s)** — no more, no fewer. The quirk vocabulary **is the parsers' own profile systems**\n * (`hl7.defineProfile`, `ccda.defineCcdaProfile`, `astm.defineAstmProfile`): a quirk exercises exactly\n * the tolerance the corresponding parser profile encodes, so a quirk fixture is never a fiction — it\n * targets a documented, coded leniency (the **intended-warning contract**).\n *\n * This module is the **format-agnostic** part: the descriptor a quirk carries, the artifact a quirk\n * generator returns, the round-trip verdict shape, and the `SYNTH_UNSUPPORTED_QUIRK` fail-closed. Each\n * format's concrete quirk recipes + transforms live behind its own subpath (`@cosyte/synth/hl7`, …).\n *\n * @module\n */\n\nimport type { SynthFormat } from \"./corpus.js\";\nimport { SYNTH_FATAL_CODES, SynthError } from \"./codes.js\";\nimport type { SynthProfile } from \"./profile.js\";\n\n/**\n * How the parser's matching profile treats a quirk once it is active — the three shapes the parsers'\n * profile systems actually exhibit (verified firsthand against each parser):\n *\n * - `\"suppressed\"` — the profile makes the warning **disappear** (HL7 v2: a `defineProfile`\n *   `customSegments` claim suppresses `UNKNOWN_SEGMENT` for a declared Z-segment).\n * - `\"rebadged\"` — the profile **downgrades** the warning to the value-free `PROFILE_QUIRK_APPLIED`\n *   marker with `expected: true` (C-CDA `defineCcdaProfile` / ASTM `defineAstmProfile`\n *   `profileQuirkApplied`).\n * - `\"bare\"` — no shipped profile tolerates it; the quirk targets a real coded leniency a consumer can\n *   tolerate via their own `defineProfile`/`defineAstmProfile`, but no built-in re-badges it.\n */\nexport type QuirkProfileDisposition = \"suppressed\" | \"rebadged\" | \"bare\";\n\n/**\n * The stable, value-free re-badge code the C-CDA and ASTM parsers emit when a profile tolerates a\n * quirk. HL7 v2 has no equivalent (it suppresses instead — see {@link QuirkProfileDisposition}).\n */\nexport const PROFILE_QUIRK_APPLIED = \"PROFILE_QUIRK_APPLIED\";\n\n/**\n * A public, grounded description of one vendor quirk — the metadata that binds a quirk recipe to a real\n * parser warning code and a **publicly-groundable** deviation (cited-public, never a private\n * vendor corpus).\n */\nexport interface QuirkDescriptor {\n  /** The quirk recipe name (e.g. `\"unknown-zsegment\"`). Stable; part of the public contract. */\n  readonly name: string;\n  /** The format this quirk applies to. */\n  readonly format: SynthFormat;\n  /**\n   * The **exact** parser warning code(s) a bare parse (no profile) surfaces for this quirk — the\n   * intended-warning contract. A quirk that produces any other code, or none, is a generation bug.\n   */\n  readonly intendedWarnings: readonly string[];\n  /**\n   * The **public** grounding for this quirk — the spec clause or the parser's public profile that\n   * documents the tolerance. Never a private vendor-attributed corpus.\n   */\n  readonly grounding: string;\n  /** The parser profile that tolerates this quirk (when a built-in public one exists). */\n  readonly toleratingProfile?: string;\n  /** How {@link toleratingProfile} treats the quirk. */\n  readonly disposition: QuirkProfileDisposition;\n}\n\n/** One generated quirk artifact — the off-spec wire text plus the contract it is meant to satisfy. */\nexport interface QuirkArtifact {\n  /** The format this artifact belongs to. */\n  readonly format: SynthFormat;\n  /** The quirk recipe applied. */\n  readonly quirk: string;\n  /** The underlying spec-clean message kind the quirk was injected into (e.g. `\"ORU^R01\"`). */\n  readonly kind: string;\n  /** The **quirked** wire text (deterministic in the seed + quirk). */\n  readonly content: string;\n  /** The exact parser warning code(s) this artifact is meant to round-trip to. */\n  readonly intendedWarnings: readonly string[];\n}\n\n/** The verdict of a bare parse under the tolerating profile, if any. */\nexport interface QuirkProfiledVerdict {\n  /** The profile applied. */\n  readonly profileName: string;\n  /** How the profile treats the quirk. */\n  readonly disposition: QuirkProfileDisposition;\n  /** The warning codes the parser emitted with the profile active. */\n  readonly warnings: readonly string[];\n  /**\n   * `true` iff the profile handled the quirk as its disposition declares: `\"suppressed\"` ⇒ the intended\n   * code is gone; `\"rebadged\"` ⇒ the intended code is gone and `PROFILE_QUIRK_APPLIED` is present.\n   */\n  readonly tolerated: boolean;\n}\n\n/** The verdict of round-tripping a quirk artifact through its parser. */\nexport interface QuirkRoundTripResult {\n  /** The quirked wire text that was parsed. */\n  readonly content: string;\n  /** The warning codes a **bare** parse (no profile) emitted. */\n  readonly warnings: readonly string[];\n  /** The exact code(s) the quirk is meant to produce. */\n  readonly intendedWarnings: readonly string[];\n  /**\n   * `true` iff the bare parse produced **exactly** the intended code(s) — the intended-warning contract.\n   */\n  readonly intendedWarningHeld: boolean;\n  /** The verdict under the tolerating profile, when a built-in public one exists. */\n  readonly withProfile?: QuirkProfiledVerdict;\n}\n\n/**\n * Exact multiset (order-independent) equality of two code lists — the intended-warning comparison.\n *\n * @param a - The first code list.\n * @param b - The second code list.\n * @returns `true` iff the two lists contain the same codes with the same multiplicities.\n * @example\n * ```ts\n * import { sameCodeSet } from \"@cosyte/synth\";\n * sameCodeSet([\"A\", \"B\"], [\"B\", \"A\"]); // true\n * ```\n */\nexport function sameCodeSet(a: readonly string[], b: readonly string[]): boolean {\n  if (a.length !== b.length) return false;\n  const counts = new Map<string, number>();\n  for (const c of a) counts.set(c, (counts.get(c) ?? 0) + 1);\n  for (const c of b) {\n    const n = counts.get(c);\n    if (n === undefined) return false;\n    if (n === 1) counts.delete(c);\n    else counts.set(c, n - 1);\n  }\n  return counts.size === 0;\n}\n\n/**\n * Resolve a requested quirk name against a format's registry, or **fail closed**. A quirk the format's\n * profile system does not support is a fatal `SYNTH_UNSUPPORTED_QUIRK` — never a silent no-op and never\n * a fabricated quirk with a made-up warning.\n *\n * @param registry - The format's quirk descriptors, keyed by name.\n * @param format - The format being generated (for the error message).\n * @param name - The requested quirk name.\n * @returns The matching {@link QuirkDescriptor}.\n * @throws SynthError with code `SYNTH_UNSUPPORTED_QUIRK` when `name` is not a supported quirk.\n * @example\n * ```ts\n * import { resolveQuirk } from \"@cosyte/synth\";\n * import { HL7_QUIRKS } from \"@cosyte/synth/hl7\";\n * resolveQuirk(HL7_QUIRKS, \"hl7v2\", \"unknown-zsegment\").intendedWarnings; // [\"UNKNOWN_SEGMENT\"]\n * ```\n */\nexport function resolveQuirk(\n  registry: Readonly<Record<string, QuirkDescriptor>>,\n  format: SynthFormat,\n  name: string,\n): QuirkDescriptor {\n  const descriptor = registry[name];\n  if (descriptor === undefined) {\n    const supported = Object.keys(registry).sort().join(\", \");\n    throw new SynthError(\n      SYNTH_FATAL_CODES.SYNTH_UNSUPPORTED_QUIRK,\n      `${format}: unsupported quirk \"${name}\". The ${format} profile system supports: ${supported}.`,\n    );\n  }\n  return descriptor;\n}\n\n/**\n * Evaluate whether a profiled parse tolerated a quirk as its disposition declares. Shared across the\n * formats so the \"suppressed vs re-badged\" logic lives in exactly one place.\n *\n * @param disposition - The quirk's declared profile disposition.\n * @param intendedWarnings - The bare-parse intended code(s).\n * @param warningsUnderProfile - The code(s) the parser emitted with the profile active.\n * @returns `true` iff the profile handled the quirk correctly for its disposition.\n * @example\n * ```ts\n * import { profileTolerated } from \"@cosyte/synth\";\n * profileTolerated(\"suppressed\", [\"UNKNOWN_SEGMENT\"], []); // true — the profile suppressed it\n * ```\n */\nexport function profileTolerated(\n  disposition: QuirkProfileDisposition,\n  intendedWarnings: readonly string[],\n  warningsUnderProfile: readonly string[],\n): boolean {\n  const stillHasIntended = intendedWarnings.some((c) => warningsUnderProfile.includes(c));\n  switch (disposition) {\n    case \"suppressed\":\n      return !stillHasIntended;\n    case \"rebadged\":\n      return !stillHasIntended && warningsUnderProfile.includes(PROFILE_QUIRK_APPLIED);\n    case \"bare\":\n      return false;\n  }\n}\n\n/**\n * Assert a freshly-generated quirk artifact **actually** round-trips to its intended warning(s), or\n * **fail closed**. This is the generator's self-check on the intended-warning contract: a\n * fixture whose bare parse does not produce exactly the declared code(s) is a *mislabeled* fixture — a\n * golden file that lies about the parser verdict it anchors — and must never be emitted. It is a\n * stronger guard than \"the transform changed some bytes\": a transform can mutate the wrong element (a\n * template a given document type does not key its warning on) and still change bytes while producing no\n * warning. Every format's `generate*Quirk` calls this after transforming, so the contract is enforced at\n * generation time, not merely at round-trip time.\n *\n * @param quirk - The quirk name (for the error message).\n * @param intendedWarnings - The declared intended code(s).\n * @param bareWarnings - The code(s) a bare parse of the generated artifact actually produced.\n * @throws Error when the bare parse did not produce exactly the intended code(s).\n * @example\n * ```ts\n * import { assertIntendedWarnings } from \"@cosyte/synth\";\n * assertIntendedWarnings(\"unknown-zsegment\", [\"UNKNOWN_SEGMENT\"], [\"UNKNOWN_SEGMENT\"]); // ok\n * ```\n */\nexport function assertIntendedWarnings(\n  quirk: string,\n  intendedWarnings: readonly string[],\n  bareWarnings: readonly string[],\n): void {\n  if (!sameCodeSet(bareWarnings, intendedWarnings)) {\n    throw new Error(\n      `quirk \"${quirk}\": the intended-warning contract does not hold — expected exactly ` +\n        `[${intendedWarnings.join(\", \")}] but a bare parse produced [${bareWarnings.join(\", \")}]. ` +\n        `Refusing to emit a mislabeled fixture.`,\n    );\n  }\n}\n\n/**\n * Validate the quirk names carried by a {@link SynthProfile} against a format's registry, failing closed\n * on the first unsupported one. Lets a consumer author a fixture recipe with `defineSynthProfile` and\n * have its quirks checked against the *parser's* real tolerance before any fixture is generated.\n *\n * @param profile - The synth profile whose `quirks` to validate.\n * @param registry - The format's quirk descriptors.\n * @param format - The format being generated.\n * @returns The validated quirk names (the profile's, in order).\n * @throws SynthError `SYNTH_UNSUPPORTED_QUIRK` for the first unsupported quirk.\n * @example\n * ```ts\n * import { validateProfileQuirks, defineSynthProfile } from \"@cosyte/synth\";\n * import { HL7_QUIRKS } from \"@cosyte/synth/hl7\";\n * const p = defineSynthProfile({ name: \"site\", quirks: [\"unknown-zsegment\"] });\n * validateProfileQuirks(p, HL7_QUIRKS, \"hl7v2\"); // [\"unknown-zsegment\"]\n * ```\n */\nexport function validateProfileQuirks(\n  profile: SynthProfile,\n  registry: Readonly<Record<string, QuirkDescriptor>>,\n  format: SynthFormat,\n): readonly string[] {\n  for (const name of profile.quirks) resolveQuirk(registry, format, name);\n  return profile.quirks;\n}\n","/**\n * `@cosyte/synth` — a deterministic, seedable **synthetic-data / test-fixture generator** for the\n * cosyte healthcare formats. A *consumer* of the parsers, not a parser: it builds artifacts **through\n * each parser's own builder/serializer** (so output is spec-clean by construction) and draws every\n * value from a **guaranteed-non-colliding synthetic source** (so no output can be real or\n * plausibly-real PHI). It is a **format/conformance generator, not a clinical simulator**.\n *\n * This root entry point exposes the **format-agnostic core**: the seeded PRNG, the synthetic-safety\n * providers, the `Corpus` abstraction, the profile skeleton, and the fatal codes. Per-format\n * generation lives behind its own subpath (`@cosyte/synth/hl7`) so importing the root never pulls a\n * parser — the lazy per-format boundary.\n *\n * @module\n */\n\n/**\n * Library version string, synced with `package.json#version` by downstream release tooling.\n *\n * @example\n * ```ts\n * import { VERSION } from \"@cosyte/synth\";\n * console.log(VERSION);\n * ```\n */\nexport const VERSION = \"0.0.0\";\n\n// ── Seeded, deterministic PRNG (the reproducibility contract, roadmap §5) ──\nexport { createRng, type Rng } from \"./rng/rng.js\";\nexport { splitmix32 } from \"./rng/splitmix32.js\";\nexport { sfc32Next, type Sfc32State } from \"./rng/sfc32.js\";\n\n// ── The synthetic-safety provider layer (roadmap §4) ──\nexport {\n  safe,\n  ssn,\n  phone,\n  name,\n  email,\n  ipv4,\n  ipv6,\n  uuid,\n  identifier,\n  address,\n  dateYmd,\n  npi,\n  dea,\n  type SyntheticName,\n  type SyntheticAddress,\n  type SyntheticIdentifier,\n  type SsnBlock,\n} from \"./safe/index.js\";\nexport {\n  isSyntheticSsn,\n  isSyntheticPhone,\n  isSyntheticEmail,\n  isSyntheticIp,\n  isSyntheticNpi,\n  npiCheckDigit,\n  luhnMod10,\n  isSyntheticDea,\n  deaCheckDigit,\n  DEA_REGISTRANT_TYPES,\n  SYNTHETIC_ASSIGNING_AUTHORITY,\n  RESERVED_EMAIL_DOMAINS,\n  TEST_NET_V4_PREFIXES,\n  DOC_V6_PREFIX,\n  NPI_LUHN_PREFIX,\n} from \"./safe/reserved.js\";\nexport {\n  SYNTHETIC_GIVEN_NAMES,\n  SYNTHETIC_FAMILY_NAMES,\n  SYNTHETIC_STREET_NAMES,\n  SYNTHETIC_CITY_NAMES,\n} from \"./safe/names-pool.js\";\n\n// ── The reproducible Corpus abstraction (roadmap §2, §5) ──\nexport {\n  makeCorpus,\n  type Corpus,\n  type CorpusManifest,\n  type Artifact,\n  type SynthFormat,\n} from \"./corpus.js\";\n\n// ── The profile growth-loop skeleton (roadmap §Phase 1) ──\nexport { defineSynthProfile, type SynthProfile, type SynthProfileSpec } from \"./profile.js\";\n\n// ── The quirk core (roadmap §Phase 7 — the differentiator; format recipes live per-subpath) ──\nexport {\n  resolveQuirk,\n  sameCodeSet,\n  profileTolerated,\n  validateProfileQuirks,\n  assertIntendedWarnings,\n  PROFILE_QUIRK_APPLIED,\n  type QuirkDescriptor,\n  type QuirkArtifact,\n  type QuirkProfileDisposition,\n  type QuirkProfiledVerdict,\n  type QuirkRoundTripResult,\n} from \"./quirk.js\";\n\n// ── Stable fatal codes + the typed error (roadmap §Phase 1) ──\nexport { SYNTH_FATAL_CODES, SynthError, type SynthFatalCode } from \"./codes.js\";\n"]}
+{"version":3,"sources":["../src/rng/splitmix32.ts","../src/rng/sfc32.ts","../src/codes.ts","../src/rng/rng.ts","../src/safe/reserved.ts","../src/safe/names-pool.ts","../src/safe/providers.ts","../src/safe/index.ts","../src/corpus.ts","../src/profile.ts","../src/quirk.ts","../src/select.ts","../src/index.ts"],"names":["name"],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * `splitmix32` — a tiny, well-studied 32-bit mixing PRNG used **only** to expand a single integer\n * seed into the four 32-bit state words that seed {@link ../rng/sfc32.sfc32}. It is not the corpus\n * generator itself (that is `sfc32`); it exists so that a one-number seed deterministically produces a\n * well-distributed 128-bit `sfc32` state, avoiding the poor low-bit behavior of naive\n * `state = seed`-style initialization.\n *\n * Zero-dependency, `Math.random`-free (lint-enforced): the whole point of the library is that a seed —\n * and only the seed — determines the output, on any machine, any run.\n *\n * @module\n */\n\n/**\n * A stateful `splitmix32` step function. Each call advances the internal 32-bit state and returns the\n * next unsigned 32-bit integer. Deterministic for a given seed.\n *\n * @param seed - The 32-bit seed. Coerced to a 32-bit integer via `| 0`.\n * @returns A nullary function returning the next `uint32` in the stream.\n * @example\n * ```ts\n * import { splitmix32 } from \"@cosyte/synth\";\n * const next = splitmix32(12345);\n * const a = next(); // deterministic uint32\n * ```\n */\nexport function splitmix32(seed: number): () => number {\n  let a = seed | 0;\n  return function next(): number {\n    a = (a + 0x9e3779b9) | 0;\n    let t = a ^ (a >>> 16);\n    t = Math.imul(t, 0x21f0aaad);\n    t = t ^ (t >>> 15);\n    t = Math.imul(t, 0x735a2d97);\n    t = t ^ (t >>> 15);\n    return t >>> 0;\n  };\n}\n","/**\n * `sfc32` (Small Fast Counter, 32-bit, 128-bit state) — the deterministic, non-cryptographic PRNG that\n * drives every value `@cosyte/synth` generates. Chosen over `mulberry32` (whose author flags that it\n * skips ~1/3 of 32-bit outputs) and over a CSPRNG (`node:crypto`, which is **not seedable** and would\n * defeat reproducibility). A synthetic-fixture generator has **no secrets** — statistical quality plus\n * byte-for-byte reproducibility is exactly the right trade.\n *\n * The state is four 32-bit words. This module exposes the raw step function; {@link ../rng/rng.Rng}\n * wraps it with a seed-expansion ({@link ./splitmix32.splitmix32}) and the ergonomic draw helpers.\n *\n * @module\n */\n\n/**\n * The mutable four-word `sfc32` state. Threaded explicitly (never global) by {@link ../rng/rng.Rng}.\n */\nexport interface Sfc32State {\n  /** State word `a`. */\n  a: number;\n  /** State word `b`. */\n  b: number;\n  /** State word `c`. */\n  c: number;\n  /** Counter word `d`. */\n  d: number;\n}\n\n/**\n * Advance an {@link Sfc32State} in place by one step and return the next unsigned 32-bit integer.\n *\n * This is the canonical `sfc32` step. The state object is mutated (the counter `d` increments and the\n * mixing words rotate); callers that need reproducible independence hold their own state and never\n * share it — {@link ../rng/rng.Rng} creates a fresh state per seed so two runs from the same seed are\n * identical.\n *\n * @param s - The state to advance. Mutated in place.\n * @returns The next `uint32` in the stream.\n * @example\n * ```ts\n * import { sfc32Next, type Sfc32State } from \"@cosyte/synth\";\n * const s: Sfc32State = { a: 1, b: 2, c: 3, d: 4 };\n * const x = sfc32Next(s); // uint32\n * ```\n */\nexport function sfc32Next(s: Sfc32State): number {\n  s.a |= 0;\n  s.b |= 0;\n  s.c |= 0;\n  s.d |= 0;\n  const t = (((s.a + s.b) | 0) + s.d) | 0;\n  s.d = (s.d + 1) | 0;\n  s.a = s.b ^ (s.b >>> 9);\n  s.b = (s.c + (s.c << 3)) | 0;\n  s.c = (s.c << 21) | (s.c >>> 11);\n  s.c = (s.c + t) | 0;\n  return t >>> 0;\n}\n","/**\n * Stable diagnostic codes for `@cosyte/synth` and the {@link SynthError} they travel on.\n *\n * Unlike a parser (which recovers from bad *input* into Tier-2 warnings), a **generator** has no input\n * to tolerate — its reflex is *synthetic-by-construction* and *fail-closed on impossibility*. So the\n * codes here are **fatal**: a caller asked for something the library cannot honor spec-clean, and the\n * only safe answer is to throw, never to silently fabricate a value or a byte workaround. Codes are `key ===\n * value` and part of the public contract —\n * renaming one is a breaking change.\n *\n * @module\n */\n\n/**\n * The stable **fatal** code registry. Additions-only thereafter.\n *\n * @example\n * ```ts\n * import { SYNTH_FATAL_CODES, SynthError } from \"@cosyte/synth\";\n * try {\n *   // ...generate...\n * } catch (err) {\n *   if (err instanceof SynthError && err.code === SYNTH_FATAL_CODES.SYNTH_UNSUPPORTED_FORMAT) {\n *     // handle an unsupported format request\n *   }\n * }\n * ```\n */\nexport const SYNTH_FATAL_CODES = {\n  /**\n   * A format was requested that this build cannot generate through a real parser builder/serializer.\n   * Fatal — never a hand-written byte fallback.\n   *\n   * **No code path in this build raises it.** All six formats generate, so it is reserved for a\n   * future format that does not, and is kept because removing a published code is a breaking change.\n   * An unsupported *kind* within a format that does generate is `SYNTH_UNSUPPORTED_KIND`.\n   */\n  SYNTH_UNSUPPORTED_FORMAT: \"SYNTH_UNSUPPORTED_FORMAT\",\n  /**\n   * A vendor quirk was requested that the target format's profile system does not support. Fatal —\n   * never a silent no-op and never a fabricated quirk.\n   */\n  SYNTH_UNSUPPORTED_QUIRK: \"SYNTH_UNSUPPORTED_QUIRK\",\n  /**\n   * A quirk transform found no structural anchor to mutate, so the fixture would not carry the\n   * deviation it is labelled with. Fatal — a golden file that lies about its parser verdict is worse\n   * than no golden file.\n   */\n  SYNTH_QUIRK_ANCHOR_ABSENT: \"SYNTH_QUIRK_ANCHOR_ABSENT\",\n  /**\n   * A bare parse of a freshly-generated quirk artifact did not produce exactly the declared intended\n   * warning code(s). Fatal — never emit a mislabeled fixture.\n   */\n  SYNTH_INTENDED_WARNING_MISMATCH: \"SYNTH_INTENDED_WARNING_MISMATCH\",\n  /** A concept's code-system URI has no OID mapping in the C-CDA example-code table. Fatal. */\n  SYNTH_UNMAPPED_CODE_SYSTEM: \"SYNTH_UNMAPPED_CODE_SYSTEM\",\n  /** A money value could not be read as an X12 decimal. Fatal — a generator never rounds to a float. */\n  SYNTH_INVALID_DECIMAL: \"SYNTH_INVALID_DECIMAL\",\n  /** An integer range was requested with its maximum below its minimum. Fatal. */\n  SYNTH_INVALID_RANGE: \"SYNTH_INVALID_RANGE\",\n  /** A value was drawn from an empty pool. Fatal — never a fabricated substitute. */\n  SYNTH_EMPTY_POOL: \"SYNTH_EMPTY_POOL\",\n  /** A `defineSynthProfile` spec was not usable (a missing or blank `name`). Fatal. */\n  SYNTH_INVALID_PROFILE: \"SYNTH_INVALID_PROFILE\",\n  /**\n   * A caller-supplied selector (a message kind, a document type, a corpus mix entry, a claim\n   * variant, a Bundle type, a resource profile) is not in the closed set that governs it. Fatal —\n   * see `resolveKind`: a selector union is erased at run time, and a selector that falls through\n   * either mislabels the fixture or hands the value to a peer builder that quotes it back.\n   */\n  SYNTH_UNSUPPORTED_KIND: \"SYNTH_UNSUPPORTED_KIND\",\n} as const;\n\n/**\n * A value from {@link SYNTH_FATAL_CODES} — the type carried by a thrown {@link SynthError}.\n */\nexport type SynthFatalCode = (typeof SYNTH_FATAL_CODES)[keyof typeof SYNTH_FATAL_CODES];\n\n/**\n * The **frozen message registry** — the only place a {@link SynthError} message can come from.\n *\n * A message here is a fixed string. It never quotes the request that produced it, and there is no\n * parameter through which it could: {@link SynthError} takes a code and nothing else. That is the\n * whole mechanism, and it is deliberately a mechanism rather than a habit. Every one of these\n * messages used to be assembled by interpolating the caller's value into a template, and the reason\n * that was safe was not the design — it was that the caller happened to be passing a quirk name.\n *\n * The trade is real and is accepted: a fatal no longer tells you *which* value it rejected. It tells\n * you which rule refused, on `err.code`, and the stack frame tells you where. The caller already\n * holds the value it passed.\n *\n * @example\n * ```ts\n * import { SYNTH_FATAL_CODES, SYNTH_FATAL_MESSAGES } from \"@cosyte/synth\";\n * SYNTH_FATAL_MESSAGES[SYNTH_FATAL_CODES.SYNTH_EMPTY_POOL]; // => \"A value was drawn from an empty pool.\"\n * ```\n */\nexport const SYNTH_FATAL_MESSAGES: Readonly<Record<SynthFatalCode, string>> = Object.freeze({\n  SYNTH_UNSUPPORTED_FORMAT:\n    \"The requested format is not generable by this build. A generator has no byte fallback: it \" +\n    \"builds through a parser's own serializer or it refuses.\",\n  SYNTH_UNSUPPORTED_QUIRK:\n    \"The requested vendor quirk is not in the target format's quirk registry. Compare the request \" +\n    \"against that format's exported registry (HL7_QUIRKS, CCDA_QUIRKS, ASTM_QUIRKS).\",\n  SYNTH_QUIRK_ANCHOR_ABSENT:\n    \"The quirk transform found no structural anchor to mutate, so the fixture would not carry the \" +\n    \"deviation it is labelled with. Refusing to emit a mislabeled fixture.\",\n  SYNTH_INTENDED_WARNING_MISMATCH:\n    \"A bare parse of the generated quirk artifact did not produce exactly the declared intended \" +\n    \"warning code(s). Refusing to emit a mislabeled fixture.\",\n  SYNTH_UNMAPPED_CODE_SYSTEM:\n    \"The concept's code-system URI has no OID mapping in the C-CDA example-code table.\",\n  SYNTH_INVALID_DECIMAL: \"The value could not be read as an X12 decimal.\",\n  SYNTH_INVALID_RANGE: \"An integer range was requested with its maximum below its minimum.\",\n  SYNTH_EMPTY_POOL: \"A value was drawn from an empty pool.\",\n  SYNTH_INVALID_PROFILE: \"defineSynthProfile requires a non-empty string name.\",\n  SYNTH_UNSUPPORTED_KIND:\n    \"The requested kind, document type, corpus mix entry, variant or profile is not one this \" +\n    \"generator supports. The supported set is the exported union for that option.\",\n});\n\n/**\n * The typed error every fatal `@cosyte/synth` condition throws. Carries a stable\n * {@link SynthFatalCode} so callers branch on `err.code` without matching message text.\n *\n * It takes **no value parameter**. The message is whatever {@link SYNTH_FATAL_MESSAGES} holds for the\n * code, so no caller-supplied string can reach a diagnostic surface by any route — not `message`, not\n * `stack`, not a field on the thrown object.\n *\n * @example\n * ```ts\n * import { SynthError, SYNTH_FATAL_CODES } from \"@cosyte/synth\";\n * throw new SynthError(SYNTH_FATAL_CODES.SYNTH_UNSUPPORTED_FORMAT);\n * ```\n */\nexport class SynthError extends Error {\n  /** The stable fatal code. */\n  public readonly code: SynthFatalCode;\n\n  /**\n   * @param code - The stable {@link SynthFatalCode}. The message comes from the frozen registry.\n   */\n  public constructor(code: SynthFatalCode) {\n    super(SYNTH_FATAL_MESSAGES[code]);\n    this.name = \"SynthError\";\n    this.code = code;\n  }\n}\n","/**\n * `Rng` — the seeded, deterministic random source every `@cosyte/synth` provider draws from.\n *\n * **The reproducibility contract.** A seed — and only the seed — determines the output.\n * `createRng(seed)` expands the integer seed through {@link ./splitmix32.splitmix32} into the four\n * `sfc32` state words, then every draw advances that state via {@link ./sfc32.sfc32Next}. Two `Rng`s\n * created from the same seed emit the **identical** sequence on any machine, any run — the property\n * the parsers', `transform`'s, and `deid`'s regression suites depend on.\n *\n * **Explicit, never global.** An `Rng` is a value you thread through a build; there is no ambient\n * shared generator and **`Math.random` is lint-banned** in `src/` (it is not seedable — its seed is\n * engine-chosen and cannot be reset, so a corpus built on it is not reproducible). Because each\n * generation creates a fresh `Rng` from its seed, generations are independent and parallel-safe.\n *\n * The `Rng` object is stateful by nature (a PRNG advances). Immutability in this library lives where it\n * is testable and matters: the generated **artifacts and the `Corpus` are deep-frozen** (see\n * `../corpus.ts`). Determinism, not object-immutability, is the `Rng`'s guarantee.\n *\n * @module\n */\n\nimport { splitmix32 } from \"./splitmix32.js\";\nimport { sfc32Next, type Sfc32State } from \"./sfc32.js\";\nimport { SYNTH_FATAL_CODES, SynthError } from \"../codes.js\";\n\n/**\n * A seeded, deterministic random source. Created via {@link createRng}; passed explicitly to every\n * provider. All draw methods advance the internal state deterministically.\n */\nexport interface Rng {\n  /** The integer seed this generator was created from (part of the `Corpus` manifest). */\n  readonly seed: number;\n  /** The next unsigned 32-bit integer. */\n  nextUint32(): number;\n  /** The next float in `[0, 1)`. */\n  float(): number;\n  /**\n   * A uniformly-distributed integer in the inclusive range `[min, max]`.\n   *\n   * @param min - Inclusive lower bound (integer).\n   * @param max - Inclusive upper bound (integer, `>= min`).\n   */\n  int(min: number, max: number): number;\n  /** `true` with probability `p` (default `0.5`). */\n  bool(p?: number): boolean;\n  /**\n   * Pick one element from a non-empty array.\n   *\n   * @param items - A non-empty readonly array.\n   */\n  pick<T>(items: readonly T[]): T;\n  /**\n   * A string of `n` decimal digits (`0`–`9`), each drawn uniformly.\n   *\n   * @param n - The number of digits (`>= 0`).\n   */\n  digits(n: number): string;\n}\n\n/**\n * The concrete {@link Rng}. Holds the mutable `sfc32` state; every method advances it deterministically.\n */\nclass Sfc32Rng implements Rng {\n  public readonly seed: number;\n  readonly #state: Sfc32State;\n\n  public constructor(seed: number) {\n    this.seed = seed | 0;\n    // Expand the single seed into four well-distributed state words. Seeding sfc32 directly from the\n    // raw seed gives poor low-bit behavior; splitmix32 is the standard fix (bryc / roadmap §5).\n    const mix = splitmix32(this.seed);\n    this.#state = { a: mix(), b: mix(), c: mix(), d: mix() };\n    // A short warm-up so nearby seeds diverge immediately.\n    for (let i = 0; i < 8; i += 1) sfc32Next(this.#state);\n  }\n\n  public nextUint32(): number {\n    return sfc32Next(this.#state);\n  }\n\n  public float(): number {\n    return this.nextUint32() / 0x1_0000_0000;\n  }\n\n  public int(min: number, max: number): number {\n    if (max < min) throw new SynthError(SYNTH_FATAL_CODES.SYNTH_INVALID_RANGE);\n    const span = max - min + 1;\n    return min + Math.floor(this.float() * span);\n  }\n\n  public bool(p = 0.5): boolean {\n    return this.float() < p;\n  }\n\n  public pick<T>(items: readonly T[]): T {\n    if (items.length === 0) throw new SynthError(SYNTH_FATAL_CODES.SYNTH_EMPTY_POOL);\n    // `int(0, length-1)` is always in-bounds on a non-empty array, so this access cannot be a hole;\n    // the cast discharges `noUncheckedIndexedAccess`'s `T | undefined` without a runtime re-check.\n    return items[this.int(0, items.length - 1)] as T;\n  }\n\n  public digits(n: number): string {\n    let out = \"\";\n    for (let i = 0; i < n; i += 1) out += String(this.int(0, 9));\n    return out;\n  }\n}\n\n/**\n * Create a seeded, deterministic {@link Rng}. The same `seed` yields the same sequence everywhere.\n *\n * @param seed - The integer seed. Coerced to a 32-bit integer.\n * @returns A fresh, independent {@link Rng}.\n * @example\n * ```ts\n * import { createRng } from \"@cosyte/synth\";\n * const rng = createRng(12345);\n * rng.int(1, 6); // deterministic for seed 12345\n * ```\n */\nexport function createRng(seed: number): Rng {\n  return new Sfc32Rng(seed);\n}\n","/**\n * The reserved / never-collide identifier facts that make a `@cosyte/synth` value **provably\n * synthetic** — the ground truth behind the synthetic-safety invariant.\n *\n * These are **facts**, not copyrighted prose: authoritative ranges published by SSA, NANPA, and the\n * IETF that are guaranteed never to denote a real person or a real routable resource. Every provider\n * draws only from these; the predicates here are the executable half of the CI synthetic-safety gate —\n * they let a test assert that no emitted value falls **outside** a reserved source.\n *\n * Sources:\n * - **SSN** — SSA never issues area numbers `000`, `666`, or `900–999`; the `987-65-4320…4329` block\n *   is SSA's explicitly-reserved advertising range. (ssa.gov)\n * - **Phone** — NANP reserves `555-0100…555-0199` as the fictional/non-working line range. (nanpa.com)\n * - **Email/domain** — RFC 2606 / RFC 6761 reserved: `example.com`/`.net`/`.org` and the `.example`,\n *   `.test`, `.invalid`, `.localhost` TLDs.\n * - **IP** — RFC 5737 IPv4 TEST-NET-1/2/3 (`192.0.2.0/24`, `198.51.100.0/24`, `203.0.113.0/24`) and\n *   RFC 3849 IPv6 documentation prefix `2001:db8::/32`.\n * - **NPI** — a real National Provider Identifier is a 10-digit number whose last digit is a Luhn\n *   check digit computed over the `80840` prefix + the 9-digit base (CMS NPI check-digit rule, ISO\n *   7812). A number whose check digit is **wrong** therefore cannot be a NPPES-issued NPI. `synth`\n *   emits NPIs with a deliberately-invalid check digit, so no generated NPI can collide with a real\n *   provider.\n *\n * @module\n */\n\n/**\n * The synthetic **assigning authority** `@cosyte/synth` mints MRNs / account / member identifiers\n * under. There is **no** reserved MRN range (an MRN is unique only within its assigning-authority /\n * OID namespace), so — a documented design decision — every synthetic identifier\n * is scoped to a namespace that clearly cannot be a real facility's: a `SYNTH`-labelled authority whose\n * OID lives under HL7's designated **example** root `2.16.840.1.113883.19`. A value under this AA can\n * never collide with a real record because the *namespace itself* is synthetic.\n */\nexport const SYNTHETIC_ASSIGNING_AUTHORITY = Object.freeze({\n  /** The human-readable assigning-authority namespace id (HL7 HD.1). */\n  namespaceId: \"COSYTE-SYNTH\",\n  /** The universal id — an OID under HL7's example arc `2.16.840.1.113883.19` (HD.2). */\n  universalId: \"2.16.840.1.113883.19.999\",\n  /** The universal id type (HD.3). */\n  universalIdType: \"ISO\",\n});\n\n/** RFC 2606 / 6761 reserved email domains `@cosyte/synth` draws from. */\nexport const RESERVED_EMAIL_DOMAINS: readonly string[] = Object.freeze([\n  \"example.com\",\n  \"example.org\",\n  \"example.net\",\n]);\n\n/** RFC 5737 IPv4 documentation (TEST-NET) `/24` network prefixes. */\nexport const TEST_NET_V4_PREFIXES: readonly string[] = Object.freeze([\n  \"192.0.2\", // TEST-NET-1\n  \"198.51.100\", // TEST-NET-2\n  \"203.0.113\", // TEST-NET-3\n]);\n\n/** RFC 3849 IPv6 documentation prefix. */\nexport const DOC_V6_PREFIX = \"2001:db8\";\n\n/**\n * The `80840` prefix prepended to a 10-digit NPI before the Luhn check (the CMS NPI check-digit\n * rule — `80840` is the ISO 7812 issuer identifier for the US health-application namespace). A real\n * NPI satisfies `luhn(\"80840\" + npi) ≡ 0 (mod 10)`.\n */\nexport const NPI_LUHN_PREFIX = \"80840\";\n\n/**\n * The Luhn sum (mod 10) of a numeric string, doubling every second digit from the right. Used to\n * verify (or deliberately break) an NPI check digit.\n *\n * @param digits - A string of decimal digits.\n * @returns The Luhn sum modulo 10 (0 ⇒ the string passes the Luhn check).\n * @internal\n */\nexport function luhnMod10(digits: string): number {\n  let sum = 0;\n  // Standard Luhn: the RIGHTMOST digit is never doubled; doubling starts one position in and\n  // alternates. For a full payload+check string this makes a Luhn-valid string sum to 0 (mod 10);\n  // for a payload with a `0` placeholder in the check position it yields the complement of the\n  // correct check digit.\n  let double = false;\n  for (let i = digits.length - 1; i >= 0; i -= 1) {\n    let d = digits.charCodeAt(i) - 48;\n    if (d < 0 || d > 9) continue;\n    if (double) {\n      d *= 2;\n      if (d > 9) d -= 9;\n    }\n    sum += d;\n    double = !double;\n  }\n  return sum % 10;\n}\n\n/**\n * The correct NPI check digit for a 9-digit base — the value that makes `80840` + base + check pass\n * the Luhn check.\n *\n * @param base9 - The 9-digit NPI base (positions 1–9).\n * @returns The check digit (`0`–`9`) a real NPI would carry for this base.\n * @example\n * ```ts\n * import { npiCheckDigit } from \"@cosyte/synth\";\n * npiCheckDigit(\"123456789\"); // 3 — so 1234567893 is a Luhn-valid NPI shape\n * ```\n */\nexport function npiCheckDigit(base9: string): number {\n  // Luhn over \"80840\" + base9 with a trailing 0 check placeholder; the check digit closes the sum.\n  const partial = luhnMod10(`${NPI_LUHN_PREFIX}${base9}0`);\n  return (10 - partial) % 10;\n}\n\n/**\n * The DEA-registration prefix letters `@cosyte/synth` draws a synthetic DEA number's first character\n * from. A real DEA number is `<registrant-type><last-name-initial>` + 7 digits; the first letter is the\n * registrant type (A/B/F/G/M/P/R/X are the widely-published values; the second letter is the\n * registrant's last-name initial). These letters are a **fact** about the number's shape, not\n * copyrighted prose — they only shape the value; the synthetic guarantee is the deliberately-**invalid\n * checksum** (see {@link dea} / {@link isSyntheticDea}).\n */\nexport const DEA_REGISTRANT_TYPES: readonly string[] = Object.freeze([\n  \"A\",\n  \"B\",\n  \"F\",\n  \"G\",\n  \"M\",\n  \"P\",\n  \"R\",\n  \"X\",\n]);\n\n/**\n * The correct DEA check digit for a 7-digit numeric base. The published DEA checksum is\n * `(d1 + d3 + d5) + 2·(d2 + d4 + d6)`, whose **units digit** is the 7th (check) digit. A real DEA\n * number satisfies this; a number whose 7th digit differs cannot be a validly-issued DEA registration.\n *\n * @param base6 - The first 6 digits of the DEA number (positions 1–6).\n * @returns The check digit (`0`–`9`) a real DEA number would carry for this base.\n * @example\n * ```ts\n * import { deaCheckDigit } from \"@cosyte/synth\";\n * deaCheckDigit(\"123456\"); // the units digit of (1+3+5) + 2·(2+4+6)\n * ```\n */\nexport function deaCheckDigit(base6: string): number {\n  let odd = 0;\n  let even = 0;\n  for (let i = 0; i < 6; i += 1) {\n    const digit = base6.charCodeAt(i) - 48;\n    if (i % 2 === 0) odd += digit;\n    else even += digit;\n  }\n  return (odd + 2 * even) % 10;\n}\n\n/**\n * Whether a DEA number (`XX` + 7 digits, case-insensitive) is **provably synthetic** — its check digit\n * (the 7th digit) does **not** match the published DEA checksum, so it cannot be a validly-issued DEA\n * registration. A checksum-valid DEA number (which *could* denote a real prescriber) returns `false`; a\n * value that is not the DEA shape returns `false`.\n *\n * @param value - The candidate DEA number (with or without incidental separators).\n * @returns `true` when the DEA number's checksum is wrong (never a real DEA registration).\n * @example\n * ```ts\n * import { isSyntheticDea } from \"@cosyte/synth\";\n * isSyntheticDea(\"AF1234561\"); // depends on the base — true when the 7th digit is wrong\n * ```\n */\nexport function isSyntheticDea(value: string): boolean {\n  const compact = value.replace(/[\\s-]/g, \"\").toUpperCase();\n  if (!/^[A-Z]{2}\\d{7}$/.test(compact)) return false;\n  const digits = compact.slice(2);\n  const check = digits.charCodeAt(6) - 48;\n  return deaCheckDigit(digits.slice(0, 6)) !== check;\n}\n\n/**\n * Whether a 10-digit NPI is **provably synthetic** — i.e. its check digit is invalid, so it cannot be\n * a NPPES-issued NPI. A Luhn-valid 10-digit NPI (which *could* denote a real registered provider)\n * returns `false`; a non-10-digit value returns `false` (not an NPI shape).\n *\n * @param value - The candidate NPI (digits only, or with incidental separators).\n * @returns `true` when the NPI's check digit is wrong (never a real NPI).\n * @example\n * ```ts\n * import { isSyntheticNpi } from \"@cosyte/synth\";\n * isSyntheticNpi(\"1234567894\"); // true  — invalid check digit (valid would be 1234567893)\n * isSyntheticNpi(\"1234567893\"); // false — Luhn-valid, could be a real NPI\n * ```\n */\nexport function isSyntheticNpi(value: string): boolean {\n  const digits = value.replace(/\\D/g, \"\");\n  if (digits.length !== 10) return false;\n  return luhnMod10(`${NPI_LUHN_PREFIX}${digits}`) !== 0;\n}\n\n/**\n * Whether a `ddd-dd-dddd` (or `ddddddddd`) SSN string is drawn from an SSA never-issued / reserved\n * space — area `000`, `666`, or `900–999`. A real, issuable SSN returns `false`.\n *\n * @param value - The candidate SSN (dashes optional).\n * @returns `true` when the SSN is provably synthetic.\n * @example\n * ```ts\n * import { isSyntheticSsn } from \"@cosyte/synth\";\n * isSyntheticSsn(\"900-12-3456\"); // true (never issued)\n * isSyntheticSsn(\"123456789\");   // false (issuable area 123)\n * ```\n */\nexport function isSyntheticSsn(value: string): boolean {\n  const digits = value.replace(/\\D/g, \"\");\n  if (digits.length !== 9) return false;\n  const area = Number(digits.slice(0, 3));\n  return area === 0 || area === 666 || area >= 900;\n}\n\n/**\n * Whether a phone string contains the NANP `555-0100…555-0199` reserved fictional line range.\n *\n * @param value - The candidate phone (any formatting).\n * @returns `true` when the number is in the reserved fictional block.\n * @example\n * ```ts\n * import { isSyntheticPhone } from \"@cosyte/synth\";\n * isSyntheticPhone(\"(202) 555-0142\"); // true\n * ```\n */\nexport function isSyntheticPhone(value: string): boolean {\n  const digits = value.replace(/\\D/g, \"\");\n  // The reserved guarantee is the 7-digit tail: exchange 555 + line 01NN.\n  const tail = digits.slice(-7);\n  return /^555 ?01\\d\\d$/.test(tail) || /^55501\\d\\d$/.test(tail);\n}\n\n/**\n * Whether an email's domain is an RFC 2606 / 6761 reserved / test domain.\n *\n * @param value - The candidate email address.\n * @returns `true` when the domain is reserved (never real).\n * @example\n * ```ts\n * import { isSyntheticEmail } from \"@cosyte/synth\";\n * isSyntheticEmail(\"faux.testerson@example.com\"); // true\n * ```\n */\nexport function isSyntheticEmail(value: string): boolean {\n  const at = value.lastIndexOf(\"@\");\n  if (at < 0) return false;\n  const domain = value.slice(at + 1).toLowerCase();\n  if (RESERVED_EMAIL_DOMAINS.includes(domain)) return true;\n  return /\\.(example|test|invalid|localhost)$/.test(domain);\n}\n\n/**\n * Whether an IP string is in an RFC 5737 (IPv4 TEST-NET) or RFC 3849 (IPv6 documentation) reserved\n * block. A real routable address returns `false`.\n *\n * @param value - The candidate IPv4 or IPv6 address.\n * @returns `true` when the address is a reserved documentation address.\n * @example\n * ```ts\n * import { isSyntheticIp } from \"@cosyte/synth\";\n * isSyntheticIp(\"192.0.2.44\");  // true (TEST-NET-1)\n * isSyntheticIp(\"8.8.8.8\");     // false (real)\n * ```\n */\nexport function isSyntheticIp(value: string): boolean {\n  if (value.toLowerCase().startsWith(`${DOC_V6_PREFIX}:`)) return true;\n  return TEST_NET_V4_PREFIXES.some((prefix) => value.startsWith(`${prefix}.`));\n}\n","/**\n * The shipped **clearly-fake name pool** — `@cosyte/synth`'s own license-clean synthetic data.\n *\n * Deliberately **not** a `faker`-style realistic-name corpus (which could match a real person at a real\n * address — the exact hazard the synthetic-safety invariant forbids). Every token is\n * an obviously-invented, fixture-flavoured word: a reader can tell at a glance it names no one. The pool\n * is small on purpose — structural coverage, not demographic realism, is the goal.\n *\n * `# synthetic: true`\n *\n * @module\n */\n\n/** Obviously-synthetic given names. None is a plausible real person's name. */\nexport const SYNTHETIC_GIVEN_NAMES: readonly string[] = Object.freeze([\n  \"Testina\",\n  \"Fixtura\",\n  \"Synthos\",\n  \"Placeholda\",\n  \"Sampleton\",\n  \"Prototius\",\n  \"Stubbina\",\n  \"Exampla\",\n  \"Quilliam\",\n  \"Fabrica\",\n  \"Simula\",\n  \"Testry\",\n  \"Seedwin\",\n  \"Corpora\",\n  \"Reprodo\",\n  \"Mocktavia\",\n  \"Dummett\",\n  \"Voidwin\",\n  \"Deteria\",\n  \"Randomir\",\n]);\n\n/** Obviously-synthetic family names. None is a plausible real surname at a real address. */\nexport const SYNTHETIC_FAMILY_NAMES: readonly string[] = Object.freeze([\n  \"Testerson\",\n  \"Fauxman\",\n  \"Placeholt\",\n  \"Mockridge\",\n  \"Fixtingham\",\n  \"Synthwell\",\n  \"Dummerton\",\n  \"Examplewood\",\n  \"Fabricant\",\n  \"Simulacre\",\n  \"Nonesuch\",\n  \"Seedman\",\n  \"Corpusworth\",\n  \"Reprodus\",\n  \"Voidmark\",\n  \"Deterwood\",\n  \"Randomson\",\n  \"Quillfeather\",\n  \"Notreal\",\n  \"Genfield\",\n]);\n\n/** Obviously-synthetic street names for structured address fields. */\nexport const SYNTHETIC_STREET_NAMES: readonly string[] = Object.freeze([\n  \"Fixture Lane\",\n  \"Sample Street\",\n  \"Placeholder Avenue\",\n  \"Synthetic Way\",\n  \"Example Boulevard\",\n  \"Testing Terrace\",\n  \"Mock Road\",\n  \"Prototype Court\",\n]);\n\n/**\n * Obviously-synthetic city names. Combined only ever with a synthetic street + a fake name (the\n * *combination* is what identifies, and the combination is always synthetic).\n */\nexport const SYNTHETIC_CITY_NAMES: readonly string[] = Object.freeze([\n  \"Faketon\",\n  \"Synthville\",\n  \"Exampleburg\",\n  \"Testford\",\n  \"Mockhaven\",\n  \"Fixtureton\",\n]);\n","/**\n * The synthetic-safety provider layer — every identifier, contact point, name, and date\n * `@cosyte/synth` emits is minted here, and **only** from a guaranteed-non-colliding source. There is no code\n * path that returns a value not drawn from a reserved range or the\n * shipped fake-name pool. This is the inverse of a parser's liberality: the generator is *closed-world*\n * on its data sources, so no output *can* be real or plausibly-real PHI.\n *\n * All providers are pure functions of an explicit {@link ../rng/rng.Rng} — same seed, same values.\n *\n * @module\n */\n\nimport type { Rng } from \"../rng/rng.js\";\n\nimport {\n  RESERVED_EMAIL_DOMAINS,\n  TEST_NET_V4_PREFIXES,\n  DOC_V6_PREFIX,\n  SYNTHETIC_ASSIGNING_AUTHORITY,\n  npiCheckDigit,\n  deaCheckDigit,\n  DEA_REGISTRANT_TYPES,\n} from \"./reserved.js\";\nimport {\n  SYNTHETIC_GIVEN_NAMES,\n  SYNTHETIC_FAMILY_NAMES,\n  SYNTHETIC_STREET_NAMES,\n  SYNTHETIC_CITY_NAMES,\n} from \"./names-pool.js\";\n\n/** A synthetic person name drawn from the shipped fake-name pool. */\nexport interface SyntheticName {\n  /** A clearly-fake given name. */\n  readonly given: string;\n  /** A clearly-fake family name. */\n  readonly family: string;\n}\n\n/** A synthetic postal address — synthetic street + city, a fixed non-real ZIP. */\nexport interface SyntheticAddress {\n  /** A clearly-fake street line. */\n  readonly street: string;\n  /** A clearly-fake city. */\n  readonly city: string;\n  /** A US state abbreviation (structural only; never combined with a real street + name + DOB). */\n  readonly state: string;\n  /** A reserved non-real ZIP (`00000`). */\n  readonly zip: string;\n}\n\n/** A synthetic identifier scoped to the synthetic assigning authority. */\nexport interface SyntheticIdentifier {\n  /** The identifier value (digits) — unique only within the synthetic namespace. */\n  readonly value: string;\n  /** HL7 identifier type code (`MR` = medical record, `AN` = account, `MB` = member). */\n  readonly typeCode: \"MR\" | \"AN\" | \"MB\";\n  /** The synthetic assigning-authority namespace id. */\n  readonly assigningAuthority: string;\n  /** The synthetic assigning-authority OID (HL7 example arc). */\n  readonly assigningAuthorityOid: string;\n}\n\n/** Which SSN reserved space to draw from. */\nexport type SsnBlock = \"never-issued\" | \"advertising\";\n\n/**\n * A **synthetic SSN** — dashed `AAA-GG-SSSS`. Default draws the SSA never-issued area space\n * (`900–999`); `block: \"advertising\"` draws SSA's reserved advertising block (`987-65-4320…4329`).\n * A value from this function can never be a real SSN.\n *\n * @param rng - The seeded generator.\n * @param block - Which reserved space to draw from. Defaults to `\"never-issued\"`.\n * @returns A dashed synthetic SSN string.\n * @example\n * ```ts\n * import { createRng, ssn } from \"@cosyte/synth\";\n * ssn(createRng(1)); // e.g. a 900-area, never-issued SSN\n * ```\n */\nexport function ssn(rng: Rng, block: SsnBlock = \"never-issued\"): string {\n  if (block === \"advertising\") {\n    // SSA's explicitly-reserved advertising block: last digit 0..9 within -4320..-4329.\n    return `987-65-432${String(rng.int(0, 9))}`;\n  }\n  const area = rng.int(900, 999); // SSA never issues 900-999.\n  const group = rng.digits(2);\n  const serial = rng.digits(4);\n  return `${String(area)}-${group}-${serial}`;\n}\n\n/**\n * A **synthetic phone** in the NANP reserved fictional block — `(AAA) 555-01NN`. The reserved\n * guarantee is the `555-01NN` tail (exchange 555, line 0100–0199); the area code is any NANP-valid\n * `NXX`. Can never be a working number.\n *\n * @param rng - The seeded generator.\n * @returns A formatted synthetic phone string.\n * @example\n * ```ts\n * import { createRng, phone } from \"@cosyte/synth\";\n * phone(createRng(1)); // e.g. \"(2XX) 555-01NN\"\n * ```\n */\nexport function phone(rng: Rng): string {\n  const area = `${String(rng.int(2, 9))}${rng.digits(2)}`; // NXX area code.\n  const line = `01${rng.digits(2)}`; // reserved 0100-0199.\n  return `(${area}) 555-${line}`;\n}\n\n/**\n * A **synthetic name** drawn from the shipped clearly-fake pool.\n *\n * @param rng - The seeded generator.\n * @returns A {@link SyntheticName}.\n * @example\n * ```ts\n * import { createRng, name } from \"@cosyte/synth\";\n * const { given, family } = name(createRng(1));\n * ```\n */\nexport function name(rng: Rng): SyntheticName {\n  return { given: rng.pick(SYNTHETIC_GIVEN_NAMES), family: rng.pick(SYNTHETIC_FAMILY_NAMES) };\n}\n\n/**\n * A **synthetic email** at an RFC 2606 / 6761 reserved domain — `<slug>@example.com`.\n *\n * @param rng - The seeded generator.\n * @param person - Optional name to derive the local-part slug from; otherwise a random slug is used.\n * @returns A synthetic email address.\n * @example\n * ```ts\n * import { createRng, email, name } from \"@cosyte/synth\";\n * email(createRng(1), name(createRng(1))); // \"<given>.<family>@example.com\"\n * ```\n */\nexport function email(rng: Rng, person?: SyntheticName): string {\n  const domain = rng.pick(RESERVED_EMAIL_DOMAINS);\n  const slug = person ? `${person.given}.${person.family}`.toLowerCase() : `synth${rng.digits(6)}`;\n  return `${slug}@${domain}`;\n}\n\n/**\n * A **synthetic IPv4** in an RFC 5737 TEST-NET block — never routable.\n *\n * @param rng - The seeded generator.\n * @returns A TEST-NET IPv4 address string.\n * @example\n * ```ts\n * import { createRng, ipv4 } from \"@cosyte/synth\";\n * ipv4(createRng(1)); // e.g. \"192.0.2.NN\"\n * ```\n */\nexport function ipv4(rng: Rng): string {\n  return `${rng.pick(TEST_NET_V4_PREFIXES)}.${String(rng.int(1, 254))}`;\n}\n\n/**\n * A **synthetic IPv6** in the RFC 3849 documentation prefix `2001:db8::/32` — never routable.\n *\n * @param rng - The seeded generator.\n * @returns A documentation-prefix IPv6 address string.\n * @example\n * ```ts\n * import { createRng, ipv6 } from \"@cosyte/synth\";\n * ipv6(createRng(1)); // e.g. \"2001:db8::NNNN\"\n * ```\n */\nexport function ipv6(rng: Rng): string {\n  const tail = rng.nextUint32().toString(16).padStart(4, \"0\").slice(-4);\n  return `${DOC_V6_PREFIX}::${tail}`;\n}\n\n/**\n * A **deterministic UUIDv4-shaped** surrogate key from the seeded generator. Because it is seeded (not\n * from `node:crypto`, which is not reproducible), the cryptographic non-collision argument is weaker —\n * acceptable because the identifier namespace is synthetic anyway, and noted honestly.\n *\n * @param rng - The seeded generator.\n * @returns A canonical `8-4-4-4-12` lowercase-hex UUID string with version `4` and RFC 4122 variant.\n * @example\n * ```ts\n * import { createRng, uuid } from \"@cosyte/synth\";\n * uuid(createRng(1)); // \"xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx\"\n * ```\n */\nexport function uuid(rng: Rng): string {\n  const bytes = new Uint8Array(16);\n  for (let i = 0; i < 16; i += 1) bytes[i] = rng.int(0, 255);\n  bytes[6] = ((bytes[6] ?? 0) & 0x0f) | 0x40; // version 4\n  bytes[8] = ((bytes[8] ?? 0) & 0x3f) | 0x80; // variant 10xx\n  const hex = Array.from(bytes, (b) => b.toString(16).padStart(2, \"0\"));\n  return `${hex.slice(0, 4).join(\"\")}-${hex.slice(4, 6).join(\"\")}-${hex.slice(6, 8).join(\"\")}-${hex.slice(8, 10).join(\"\")}-${hex.slice(10, 16).join(\"\")}`;\n}\n\n/**\n * A **synthetic NPI** — a 10-digit National Provider Identifier with a **deliberately-invalid Luhn\n * check digit**, so it can never be a NPPES-issued NPI (a real NPI must satisfy the `80840`-prefixed\n * Luhn check). The 9-digit base is drawn from the seeded generator; the check digit is\n * set to `(correct + 1) mod 10`, guaranteeing the full value fails validation.\n *\n * @param rng - The seeded generator.\n * @returns A 10-digit NPI-shaped string that is provably not a real NPI.\n * @example\n * ```ts\n * import { createRng, npi, isSyntheticNpi } from \"@cosyte/synth\";\n * isSyntheticNpi(npi(createRng(1))); // true — invalid check digit by construction\n * ```\n */\nexport function npi(rng: Rng): string {\n  const base9 = rng.digits(9);\n  const wrongCheck = (npiCheckDigit(base9) + 1) % 10;\n  return `${base9}${String(wrongCheck)}`;\n}\n\n/**\n * A **synthetic DEA number** — `<registrant-type><initial>` + 7 digits with a **deliberately-invalid\n * checksum**, so it can never be a validly-issued DEA registration (a real DEA number's 7th digit\n * satisfies the published DEA checksum). The first letter is a registrant-type letter, the\n * second is derived from `person` (its family initial) when supplied so the number reads plausibly; the\n * 6-digit base is seeded and the check digit is set to `(correct + 1) mod 10`, guaranteeing the value\n * fails validation. NCPDP carries prescriber DEA, and this is the identity locus a refuter attacks\n * hardest, so — like {@link npi} — non-collision is a construction-level guarantee, not a heuristic.\n *\n * @param rng - The seeded generator.\n * @param person - Optional name whose family initial becomes the DEA's second letter.\n * @returns A DEA-shaped string that is provably not a real DEA registration.\n * @example\n * ```ts\n * import { createRng, dea, isSyntheticDea } from \"@cosyte/synth\";\n * isSyntheticDea(dea(createRng(1))); // true — invalid checksum by construction\n * ```\n */\nexport function dea(rng: Rng, person?: SyntheticName): string {\n  const type = rng.pick(DEA_REGISTRANT_TYPES);\n  const initialSource = person?.family ?? rng.pick(SYNTHETIC_FAMILY_NAMES);\n  const initial = initialSource.slice(0, 1).toUpperCase();\n  const base6 = rng.digits(6);\n  const wrongCheck = (deaCheckDigit(base6) + 1) % 10;\n  return `${type}${initial}${base6}${String(wrongCheck)}`;\n}\n\n/**\n * A **synthetic identifier** (MRN / account / member id) scoped to the synthetic assigning authority.\n * There is no reserved MRN range, so non-collision is guaranteed by the *namespace*, not the value: the\n * identifier lives under a `SYNTH` authority no real facility uses.\n *\n * @param rng - The seeded generator.\n * @param typeCode - The HL7 identifier type: `MR` (default), `AN`, or `MB`.\n * @returns A {@link SyntheticIdentifier}.\n * @example\n * ```ts\n * import { createRng, identifier } from \"@cosyte/synth\";\n * identifier(createRng(1), \"MR\"); // { value, typeCode: \"MR\", assigningAuthority: \"COSYTE-SYNTH\", ... }\n * ```\n */\nexport function identifier(\n  rng: Rng,\n  typeCode: SyntheticIdentifier[\"typeCode\"] = \"MR\",\n): SyntheticIdentifier {\n  return {\n    value: rng.digits(8),\n    typeCode,\n    assigningAuthority: SYNTHETIC_ASSIGNING_AUTHORITY.namespaceId,\n    assigningAuthorityOid: SYNTHETIC_ASSIGNING_AUTHORITY.universalId,\n  };\n}\n\n/**\n * A **synthetic address** — a fake street + city, a reserved non-real ZIP (`00000`). A real state\n * abbreviation may appear (structural only) but is never combined with a real street + name + DOB.\n *\n * @param rng - The seeded generator.\n * @returns A {@link SyntheticAddress}.\n * @example\n * ```ts\n * import { createRng, address } from \"@cosyte/synth\";\n * address(createRng(1)); // { street, city, state, zip: \"00000\" }\n * ```\n */\nexport function address(rng: Rng): SyntheticAddress {\n  const number = rng.int(1, 9999);\n  return {\n    street: `${String(number)} ${rng.pick(SYNTHETIC_STREET_NAMES)}`,\n    city: rng.pick(SYNTHETIC_CITY_NAMES),\n    state: rng.pick(US_STATES),\n    zip: \"00000\",\n  };\n}\n\n/**\n * A **synthetic date** in HL7 `YYYYMMDD` form, drawn uniformly within an inclusive year range. Comes\n * from the seeded generator (never wall-clock), so it is reproducible and implies no real event.\n *\n * @param rng - The seeded generator.\n * @param minYear - Inclusive lower year bound (default `1930`).\n * @param maxYear - Inclusive upper year bound (default `2010`).\n * @returns An `YYYYMMDD` date string (always a valid calendar day).\n * @example\n * ```ts\n * import { createRng, dateYmd } from \"@cosyte/synth\";\n * dateYmd(createRng(1), 1970, 2000); // \"YYYYMMDD\"\n * ```\n */\nexport function dateYmd(rng: Rng, minYear = 1930, maxYear = 2010): string {\n  const year = rng.int(minYear, maxYear);\n  const month = rng.int(1, 12);\n  const daysInMonth = new Date(Date.UTC(year, month, 0)).getUTCDate();\n  const day = rng.int(1, daysInMonth);\n  return `${String(year).padStart(4, \"0\")}${String(month).padStart(2, \"0\")}${String(day).padStart(2, \"0\")}`;\n}\n\n/** US state abbreviations — structural only (see {@link address}). */\nconst US_STATES: readonly string[] = Object.freeze([\n  \"AL\",\n  \"AK\",\n  \"AZ\",\n  \"AR\",\n  \"CA\",\n  \"CO\",\n  \"CT\",\n  \"DE\",\n  \"FL\",\n  \"GA\",\n  \"HI\",\n  \"ID\",\n  \"IL\",\n  \"IN\",\n  \"IA\",\n  \"KS\",\n  \"KY\",\n  \"LA\",\n  \"ME\",\n  \"MD\",\n  \"MA\",\n  \"MI\",\n  \"MN\",\n  \"MS\",\n  \"MO\",\n  \"MT\",\n  \"NE\",\n  \"NV\",\n  \"NH\",\n  \"NJ\",\n  \"NM\",\n  \"NY\",\n  \"NC\",\n  \"ND\",\n  \"OH\",\n  \"OK\",\n  \"OR\",\n  \"PA\",\n  \"RI\",\n  \"SC\",\n  \"SD\",\n  \"TN\",\n  \"TX\",\n  \"UT\",\n  \"VT\",\n  \"VA\",\n  \"WA\",\n  \"WV\",\n  \"WI\",\n  \"WY\",\n]);\n","/**\n * The `safe` namespace — the single entry point for every synthetic-by-construction value provider.\n *\n * Grouped under one object so a consumer reads `safe.ssn(rng)` / `safe.phone(rng)` and it is\n * self-evident that the value is drawn from a guaranteed-non-colliding synthetic source.\n * The individual functions and the reserved-range predicates are also exported by name from the\n * package root for direct import.\n *\n * @module\n */\n\nimport {\n  ssn,\n  phone,\n  name,\n  email,\n  ipv4,\n  ipv6,\n  uuid,\n  identifier,\n  address,\n  dateYmd,\n  npi,\n  dea,\n} from \"./providers.js\";\n\nexport * from \"./providers.js\";\nexport * from \"./reserved.js\";\nexport * from \"./names-pool.js\";\n\n/**\n * The synthetic-safety provider namespace. Every function draws only from a reserved range or the\n * shipped fake-name pool — no value it returns can be real or plausibly-real PHI.\n *\n * @example\n * ```ts\n * import { createRng, safe } from \"@cosyte/synth\";\n * const rng = createRng(42);\n * safe.ssn(rng);   // never-issued SSN\n * safe.phone(rng); // reserved 555-01NN number\n * ```\n */\nexport const safe = Object.freeze({\n  ssn,\n  phone,\n  name,\n  email,\n  ipv4,\n  ipv6,\n  uuid,\n  identifier,\n  address,\n  dateYmd,\n  npi,\n  dea,\n});\n","/**\n * The `Corpus` abstraction — a seed plus a self-describing manifest of what was generated, so a\n * fixture set is itself reproducible and regenerable. A downstream repo pins a seed\n * and gets a stable fixture set that regenerates identically.\n *\n * Generated artifacts and the `Corpus` are **deep-frozen** — this is where the archetype's immutability\n * invariant lives in a generator: a consumer cannot mutate a shared fixture out from under\n * another test.\n *\n * @module\n */\n\n/** The format an artifact was generated for. */\nexport type SynthFormat = \"hl7v2\" | \"fhir\" | \"ccda\" | \"x12\" | \"ncpdp\" | \"astm\";\n\n/**\n * One generated artifact — the serialized wire text plus the metadata needed to reproduce and check\n * it. `warnings` records what the artifact's own parser reported on the round-trip (zero for a\n * spec-clean artifact).\n */\nexport interface Artifact {\n  /** The format this artifact belongs to. */\n  readonly format: SynthFormat;\n  /** A format-specific kind label (e.g. `\"ADT^A01\"`). */\n  readonly kind: string;\n  /** The serialized wire text, produced by the parser's own conservative serializer. */\n  readonly content: string;\n  /** The warning codes the parser emitted when the artifact was round-tripped (empty = spec-clean). */\n  readonly warnings: readonly string[];\n}\n\n/** A self-describing manifest of a {@link Corpus}. */\nexport interface CorpusManifest {\n  /** The formats present in the corpus. */\n  readonly formats: readonly SynthFormat[];\n  /** Per-kind artifact counts (e.g. `{ \"ADT^A01\": 3 }`). */\n  readonly counts: Readonly<Record<string, number>>;\n  /** The quirk names applied. */\n  readonly quirks: readonly string[];\n}\n\n/** A reproducible, self-describing set of generated artifacts. */\nexport interface Corpus {\n  /** The seed the corpus was generated from — regenerating from it yields byte-identical artifacts. */\n  readonly seed: number;\n  /** The manifest describing what was generated. */\n  readonly manifest: CorpusManifest;\n  /** The generated artifacts, in generation order. */\n  readonly artifacts: readonly Artifact[];\n}\n\n/**\n * Assemble a deep-frozen {@link Corpus} from a seed and its artifacts, deriving the manifest.\n *\n * @param seed - The seed the artifacts were generated from.\n * @param artifacts - The generated artifacts, in order.\n * @param quirks - The quirk names applied (default none).\n * @returns A deep-frozen, self-describing {@link Corpus}.\n * @example\n * ```ts\n * import { makeCorpus } from \"@cosyte/synth\";\n * const corpus = makeCorpus(1, [{ format: \"hl7v2\", kind: \"ADT^A01\", content, warnings: [] }]);\n * corpus.manifest.counts[\"ADT^A01\"]; // 1\n * ```\n */\nexport function makeCorpus(\n  seed: number,\n  artifacts: readonly Artifact[],\n  quirks: readonly string[] = [],\n): Corpus {\n  const counts: Record<string, number> = {};\n  const formats = new Set<SynthFormat>();\n  const frozenArtifacts = artifacts.map((a) => {\n    counts[a.kind] = (counts[a.kind] ?? 0) + 1;\n    formats.add(a.format);\n    return Object.freeze({ ...a, warnings: Object.freeze([...a.warnings]) });\n  });\n  const manifest: CorpusManifest = Object.freeze({\n    formats: Object.freeze([...formats]),\n    counts: Object.freeze(counts),\n    quirks: Object.freeze([...quirks]),\n  });\n  return Object.freeze({\n    seed,\n    manifest,\n    artifacts: Object.freeze(frozenArtifacts),\n  });\n}\n","/**\n * `defineSynthProfile` — the growth-loop hook for site/vendor fixture recipes. A profile bundles the\n * value pools and the quirk recipe a fixture set should use, authored through the same public API as\n * the built-ins: a validated, frozen `SynthProfile` carrying a name, optional value overrides, and the\n * quirk names a format's quirk corpus should apply.\n *\n * @module\n */\n\nimport { SYNTH_FATAL_CODES, SynthError } from \"./codes.js\";\n\n/** The user-authored spec passed to {@link defineSynthProfile}. */\nexport interface SynthProfileSpec {\n  /** A stable, human-readable profile name (e.g. `\"acme-hospital\"`). Required, non-empty. */\n  readonly name: string;\n  /** Optional given-name pool override (clearly-synthetic names only — see the safety invariant). */\n  readonly givenNames?: readonly string[];\n  /** Optional family-name pool override (clearly-synthetic names only). */\n  readonly familyNames?: readonly string[];\n  /**\n   * The vendor quirk recipe names this profile requests. Validated against the target format's quirk\n   * registry when the profile drives a quirk corpus (an unsupported quirk is a fatal\n   * `SYNTH_UNSUPPORTED_QUIRK`, never a silent no-op).\n   */\n  readonly quirks?: readonly string[];\n}\n\n/** A frozen, validated fixture recipe produced by {@link defineSynthProfile}. */\nexport interface SynthProfile {\n  /** The profile name. */\n  readonly name: string;\n  /** The given-name pool this profile draws from (overrides or the built-in default). */\n  readonly givenNames?: readonly string[];\n  /** The family-name pool this profile draws from. */\n  readonly familyNames?: readonly string[];\n  /** The requested quirk recipe names. */\n  readonly quirks: readonly string[];\n}\n\n/**\n * Define a reusable, frozen synthetic-fixture profile.\n *\n * @param spec - The profile spec; `name` is required and non-empty.\n * @returns A deep-frozen {@link SynthProfile}.\n * @throws SynthError `SYNTH_INVALID_PROFILE` when `name` is missing or blank.\n * @example\n * ```ts\n * import { defineSynthProfile } from \"@cosyte/synth\";\n * const acme = defineSynthProfile({ name: \"acme-hospital\", quirks: [] });\n * ```\n */\nexport function defineSynthProfile(spec: SynthProfileSpec): SynthProfile {\n  if (typeof spec.name !== \"string\" || spec.name.trim().length === 0) {\n    throw new SynthError(SYNTH_FATAL_CODES.SYNTH_INVALID_PROFILE);\n  }\n  return Object.freeze({\n    name: spec.name,\n    ...(spec.givenNames ? { givenNames: Object.freeze([...spec.givenNames]) } : {}),\n    ...(spec.familyNames ? { familyNames: Object.freeze([...spec.familyNames]) } : {}),\n    quirks: Object.freeze([...(spec.quirks ?? [])]),\n  });\n}\n","/**\n * The **quirk core**. Where the spec-clean generators prove\n * *synthetic-by-construction* through each parser's own builder, the quirk layer proves the mirror\n * property: a **deliberately off-spec** fixture round-trips to **exactly the intended parser warning\n * code(s)** — no more, no fewer. The quirk vocabulary **is the parsers' own profile systems**\n * (`hl7.defineProfile`, `ccda.defineCcdaProfile`, `astm.defineAstmProfile`): a quirk exercises exactly\n * the tolerance the corresponding parser profile encodes, so a quirk fixture is never a fiction — it\n * targets a documented, coded leniency (the **intended-warning contract**).\n *\n * This module is the **format-agnostic** part: the descriptor a quirk carries, the artifact a quirk\n * generator returns, the round-trip verdict shape, and the `SYNTH_UNSUPPORTED_QUIRK` fail-closed. Each\n * format's concrete quirk recipes + transforms live behind its own subpath (`@cosyte/synth/hl7`, …).\n *\n * @module\n */\n\nimport type { SynthFormat } from \"./corpus.js\";\nimport { SYNTH_FATAL_CODES, SynthError } from \"./codes.js\";\nimport type { SynthProfile } from \"./profile.js\";\n\n/**\n * How the parser's matching profile treats a quirk once it is active — the three shapes the parsers'\n * profile systems actually exhibit (verified firsthand against each parser):\n *\n * - `\"suppressed\"` — the profile makes the warning **disappear** (HL7 v2: a `defineProfile`\n *   `customSegments` claim suppresses `UNKNOWN_SEGMENT` for a declared Z-segment).\n * - `\"rebadged\"` — the profile **downgrades** the warning to the value-free `PROFILE_QUIRK_APPLIED`\n *   marker with `expected: true` (C-CDA `defineCcdaProfile` / ASTM `defineAstmProfile`\n *   `profileQuirkApplied`).\n * - `\"bare\"` — no shipped profile tolerates it; the quirk targets a real coded leniency a consumer can\n *   tolerate via their own `defineProfile`/`defineAstmProfile`, but no built-in re-badges it.\n */\nexport type QuirkProfileDisposition = \"suppressed\" | \"rebadged\" | \"bare\";\n\n/**\n * The stable, value-free re-badge code the C-CDA and ASTM parsers emit when a profile tolerates a\n * quirk. HL7 v2 has no equivalent (it suppresses instead — see {@link QuirkProfileDisposition}).\n */\nexport const PROFILE_QUIRK_APPLIED = \"PROFILE_QUIRK_APPLIED\";\n\n/**\n * A public, grounded description of one vendor quirk — the metadata that binds a quirk recipe to a real\n * parser warning code and a **publicly-groundable** deviation (cited-public, never a private\n * vendor corpus).\n */\nexport interface QuirkDescriptor {\n  /** The quirk recipe name (e.g. `\"unknown-zsegment\"`). Stable; part of the public contract. */\n  readonly name: string;\n  /** The format this quirk applies to. */\n  readonly format: SynthFormat;\n  /**\n   * The **exact** parser warning code(s) a bare parse (no profile) surfaces for this quirk — the\n   * intended-warning contract. A quirk that produces any other code, or none, is a generation bug.\n   */\n  readonly intendedWarnings: readonly string[];\n  /**\n   * The **public** grounding for this quirk — the spec clause or the parser's public profile that\n   * documents the tolerance. Never a private vendor-attributed corpus.\n   */\n  readonly grounding: string;\n  /** The parser profile that tolerates this quirk (when a built-in public one exists). */\n  readonly toleratingProfile?: string;\n  /** How {@link toleratingProfile} treats the quirk. */\n  readonly disposition: QuirkProfileDisposition;\n}\n\n/** One generated quirk artifact — the off-spec wire text plus the contract it is meant to satisfy. */\nexport interface QuirkArtifact {\n  /** The format this artifact belongs to. */\n  readonly format: SynthFormat;\n  /** The quirk recipe applied. */\n  readonly quirk: string;\n  /** The underlying spec-clean message kind the quirk was injected into (e.g. `\"ORU^R01\"`). */\n  readonly kind: string;\n  /** The **quirked** wire text (deterministic in the seed + quirk). */\n  readonly content: string;\n  /** The exact parser warning code(s) this artifact is meant to round-trip to. */\n  readonly intendedWarnings: readonly string[];\n}\n\n/** The verdict of a bare parse under the tolerating profile, if any. */\nexport interface QuirkProfiledVerdict {\n  /** The profile applied. */\n  readonly profileName: string;\n  /** How the profile treats the quirk. */\n  readonly disposition: QuirkProfileDisposition;\n  /** The warning codes the parser emitted with the profile active. */\n  readonly warnings: readonly string[];\n  /**\n   * `true` iff the profile handled the quirk as its disposition declares: `\"suppressed\"` ⇒ the intended\n   * code is gone; `\"rebadged\"` ⇒ the intended code is gone and `PROFILE_QUIRK_APPLIED` is present.\n   */\n  readonly tolerated: boolean;\n}\n\n/** The verdict of round-tripping a quirk artifact through its parser. */\nexport interface QuirkRoundTripResult {\n  /** The quirked wire text that was parsed. */\n  readonly content: string;\n  /** The warning codes a **bare** parse (no profile) emitted. */\n  readonly warnings: readonly string[];\n  /** The exact code(s) the quirk is meant to produce. */\n  readonly intendedWarnings: readonly string[];\n  /**\n   * `true` iff the bare parse produced **exactly** the intended code(s) — the intended-warning contract.\n   */\n  readonly intendedWarningHeld: boolean;\n  /** The verdict under the tolerating profile, when a built-in public one exists. */\n  readonly withProfile?: QuirkProfiledVerdict;\n}\n\n/**\n * Exact multiset (order-independent) equality of two code lists — the intended-warning comparison.\n *\n * @param a - The first code list.\n * @param b - The second code list.\n * @returns `true` iff the two lists contain the same codes with the same multiplicities.\n * @example\n * ```ts\n * import { sameCodeSet } from \"@cosyte/synth\";\n * sameCodeSet([\"A\", \"B\"], [\"B\", \"A\"]); // true\n * ```\n */\nexport function sameCodeSet(a: readonly string[], b: readonly string[]): boolean {\n  if (a.length !== b.length) return false;\n  const counts = new Map<string, number>();\n  for (const c of a) counts.set(c, (counts.get(c) ?? 0) + 1);\n  for (const c of b) {\n    const n = counts.get(c);\n    if (n === undefined) return false;\n    if (n === 1) counts.delete(c);\n    else counts.set(c, n - 1);\n  }\n  return counts.size === 0;\n}\n\n/**\n * Resolve a requested quirk name against a format's registry, or **fail closed**. A quirk the format's\n * profile system does not support is a fatal `SYNTH_UNSUPPORTED_QUIRK` — never a silent no-op and never\n * a fabricated quirk with a made-up warning.\n *\n * The refusal names neither the request nor the registry. `registry`, `format` and `name` are all\n * caller-supplied, and a diagnostic that quotes its input is a diagnostic that can be made to carry\n * anything the caller was holding — which for a fixture generator wired into someone else's pipeline\n * is not a hypothetical. Branch on `err.code`; the supported set is the registry you passed\n * (`HL7_QUIRKS`, `CCDA_QUIRKS`, `ASTM_QUIRKS`), which you can enumerate directly.\n *\n * @param registry - The format's quirk descriptors, keyed by name.\n * @param format - The format being generated.\n * @param name - The requested quirk name.\n * @returns The matching {@link QuirkDescriptor}.\n * @throws SynthError with code `SYNTH_UNSUPPORTED_QUIRK` when `name` is not a supported quirk.\n * @example\n * ```ts\n * import { resolveQuirk } from \"@cosyte/synth\";\n * import { HL7_QUIRKS } from \"@cosyte/synth/hl7\";\n * resolveQuirk(HL7_QUIRKS, \"hl7v2\", \"unknown-zsegment\").intendedWarnings; // [\"UNKNOWN_SEGMENT\"]\n * ```\n */\nexport function resolveQuirk(\n  registry: Readonly<Record<string, QuirkDescriptor>>,\n  format: SynthFormat,\n  name: string,\n): QuirkDescriptor {\n  const descriptor = registry[name];\n  // `format` is compared, never rendered. A descriptor found under the wrong format's registry is a\n  // mislabeled fixture waiting to happen, so the mismatch fails closed on the same code.\n  if (descriptor === undefined || descriptor.format !== format) {\n    throw new SynthError(SYNTH_FATAL_CODES.SYNTH_UNSUPPORTED_QUIRK);\n  }\n  return descriptor;\n}\n\n/**\n * Evaluate whether a profiled parse tolerated a quirk as its disposition declares. Shared across the\n * formats so the \"suppressed vs re-badged\" logic lives in exactly one place.\n *\n * @param disposition - The quirk's declared profile disposition.\n * @param intendedWarnings - The bare-parse intended code(s).\n * @param warningsUnderProfile - The code(s) the parser emitted with the profile active.\n * @returns `true` iff the profile handled the quirk correctly for its disposition.\n * @example\n * ```ts\n * import { profileTolerated } from \"@cosyte/synth\";\n * profileTolerated(\"suppressed\", [\"UNKNOWN_SEGMENT\"], []); // true — the profile suppressed it\n * ```\n */\nexport function profileTolerated(\n  disposition: QuirkProfileDisposition,\n  intendedWarnings: readonly string[],\n  warningsUnderProfile: readonly string[],\n): boolean {\n  const stillHasIntended = intendedWarnings.some((c) => warningsUnderProfile.includes(c));\n  switch (disposition) {\n    case \"suppressed\":\n      return !stillHasIntended;\n    case \"rebadged\":\n      return !stillHasIntended && warningsUnderProfile.includes(PROFILE_QUIRK_APPLIED);\n    case \"bare\":\n      return false;\n  }\n}\n\n/**\n * Assert a freshly-generated quirk artifact **actually** round-trips to its intended warning(s), or\n * **fail closed**. This is the generator's self-check on the intended-warning contract: a\n * fixture whose bare parse does not produce exactly the declared code(s) is a *mislabeled* fixture — a\n * golden file that lies about the parser verdict it anchors — and must never be emitted. It is a\n * stronger guard than \"the transform changed some bytes\": a transform can mutate the wrong element (a\n * template a given document type does not key its warning on) and still change bytes while producing no\n * warning. Every format's `generate*Quirk` calls this after transforming, so the contract is enforced at\n * generation time, not merely at round-trip time.\n *\n * It no longer takes the quirk name. That parameter existed for one reason — to be interpolated into\n * the refusal — and a parameter whose only job is to reach a message is the exact shape this package\n * is removing, so it is gone rather than merely unused. The refusal names neither code list either;\n * both are caller-supplied, and the caller reads the comparison back off the arguments it holds.\n *\n * @param intendedWarnings - The declared intended code(s).\n * @param bareWarnings - The code(s) a bare parse of the generated artifact actually produced.\n * @throws SynthError `SYNTH_INTENDED_WARNING_MISMATCH` when the bare parse did not produce exactly\n *   the intended code(s).\n * @example\n * ```ts\n * import { assertIntendedWarnings } from \"@cosyte/synth\";\n * assertIntendedWarnings([\"UNKNOWN_SEGMENT\"], [\"UNKNOWN_SEGMENT\"]); // ok\n * ```\n */\nexport function assertIntendedWarnings(\n  intendedWarnings: readonly string[],\n  bareWarnings: readonly string[],\n): void {\n  if (!sameCodeSet(bareWarnings, intendedWarnings)) {\n    throw new SynthError(SYNTH_FATAL_CODES.SYNTH_INTENDED_WARNING_MISMATCH);\n  }\n}\n\n/**\n * Validate the quirk names carried by a {@link SynthProfile} against a format's registry, failing closed\n * on the first unsupported one. Lets a consumer author a fixture recipe with `defineSynthProfile` and\n * have its quirks checked against the *parser's* real tolerance before any fixture is generated.\n *\n * @param profile - The synth profile whose `quirks` to validate.\n * @param registry - The format's quirk descriptors.\n * @param format - The format being generated.\n * @returns The validated quirk names (the profile's, in order).\n * @throws SynthError `SYNTH_UNSUPPORTED_QUIRK` for the first unsupported quirk.\n * @example\n * ```ts\n * import { validateProfileQuirks, defineSynthProfile } from \"@cosyte/synth\";\n * import { HL7_QUIRKS } from \"@cosyte/synth/hl7\";\n * const p = defineSynthProfile({ name: \"site\", quirks: [\"unknown-zsegment\"] });\n * validateProfileQuirks(p, HL7_QUIRKS, \"hl7v2\"); // [\"unknown-zsegment\"]\n * ```\n */\nexport function validateProfileQuirks(\n  profile: SynthProfile,\n  registry: Readonly<Record<string, QuirkDescriptor>>,\n  format: SynthFormat,\n): readonly string[] {\n  for (const name of profile.quirks) resolveQuirk(registry, format, name);\n  return profile.quirks;\n}\n","/**\n * The **selector chokepoint**. A generator's options are almost all *selectors*: a message kind, a\n * document type, a corpus mix, a claim variant, a Bundle type, a profile. Each is typed as a closed\n * union, and every one of those unions is **erased at run time**, so a JavaScript caller (or a\n * `as never` in someone's test) reaches the branch with any string at all.\n *\n * Three things went wrong when that was left unchecked, and they are all the same bug:\n *\n * 1. **The value reached a diagnostic.** An unrecognised `documentType` travelled into\n *    `@cosyte/ccda`'s `buildCcda`, which is entitled to quote it back in its own `TypeError` and\n *    does. This package then has a caller-supplied string on an `err.message` and an `err.stack`,\n *    through its own public entry point, having taken no care of it.\n * 2. **The value reached the model.** A corpus mix entry becomes an `Artifact.kind` and a\n *    `manifest.counts` key, which is precisely the structural-identifier position a downstream\n *    package interpolates to describe a location.\n * 3. **The fixture was silently mislabeled.** An exhaustive `switch` over an erased union takes no\n *    branch and returns `undefined`, or a trailing `else` quietly generates something else. A corpus\n *    whose manifest says it holds one transaction and holds another is a golden file that lies.\n *\n * So a selector is resolved against its own set, once, before anything is generated, and an\n * unrecognised one is a fatal `SYNTH_UNSUPPORTED_KIND`. Like every fatal here it carries a code and a\n * fixed message, and quotes neither the request nor the set.\n *\n * @module\n */\n\nimport { SYNTH_FATAL_CODES, SynthError } from \"./codes.js\";\n\n/**\n * Resolve one caller-supplied selector against the closed set that governs it, or **fail closed**.\n *\n * @param allowed - Every value the selector may take.\n * @param requested - The selector the caller supplied.\n * @returns `requested`, narrowed to the union.\n * @throws SynthError `SYNTH_UNSUPPORTED_KIND` when `requested` is not in `allowed`.\n * @example\n * ```ts\n * import { resolveKind } from \"@cosyte/synth\";\n * resolveKind([\"ccd\", \"referralNote\"] as const, \"ccd\"); // \"ccd\"\n * ```\n */\nexport function resolveKind<T extends string>(allowed: readonly T[], requested: string): T {\n  const match = allowed.find((value) => value === requested);\n  if (match === undefined) throw new SynthError(SYNTH_FATAL_CODES.SYNTH_UNSUPPORTED_KIND);\n  return match;\n}\n\n/**\n * Resolve every entry of a caller-supplied corpus mix, in order, or **fail closed** on the first\n * unrecognised one.\n *\n * It substitutes the default **only** when the caller supplied nothing, which is exactly what the\n * `??` it replaced did. An empty array is a supplied mix and is returned as one. An earlier version\n * of this function also treated `[]` as \"nothing supplied\", on the stated grounds that it matched the\n * previous behaviour; it did not — `??` fires on `undefined` and never on `[]` — and it changed the\n * result of six published entry points, turning an explicit empty selection into \"generate one of\n * everything\". A convenience that fails open is not a convenience.\n *\n * @param allowed - Every kind the corpus may generate.\n * @param requested - The mix the caller supplied, or `undefined` for the default.\n * @param fallback - The default mix, used only when `requested` is `undefined`.\n * @returns The resolved mix.\n * @throws SynthError `SYNTH_UNSUPPORTED_KIND` on the first unrecognised entry.\n * @example\n * ```ts\n * import { resolveMix } from \"@cosyte/synth\";\n * resolveMix([\"Result\", \"Order\"] as const, [\"Order\"], [\"Result\", \"Order\"]); // [\"Order\"]\n * ```\n */\nexport function resolveMix<T extends string>(\n  allowed: readonly T[],\n  requested: readonly string[] | undefined,\n  fallback: readonly T[],\n): readonly T[] {\n  if (requested === undefined) return fallback;\n  return requested.map((entry) => resolveKind(allowed, entry));\n}\n","/**\n * `@cosyte/synth` — a deterministic, seedable **synthetic-data / test-fixture generator** for the\n * cosyte healthcare formats. A *consumer* of the parsers, not a parser: it builds artifacts **through\n * each parser's own builder/serializer** (so output is spec-clean by construction) and draws every\n * value from a **guaranteed-non-colliding synthetic source** (so no output can be real or\n * plausibly-real PHI). It is a **format/conformance generator, not a clinical simulator**.\n *\n * This root entry point exposes the **format-agnostic core**: the seeded PRNG, the synthetic-safety\n * providers, the `Corpus` abstraction, the profile skeleton, and the fatal codes. Per-format\n * generation lives behind its own subpath (`@cosyte/synth/hl7`) so importing the root never pulls a\n * parser — the lazy per-format boundary.\n *\n * @module\n */\n\n/**\n * Library version string, synced with `package.json#version` by downstream release tooling.\n *\n * @example\n * ```ts\n * import { VERSION } from \"@cosyte/synth\";\n * console.log(VERSION);\n * ```\n */\nexport const VERSION = \"0.0.0\";\n\n// ── Seeded, deterministic PRNG (the reproducibility contract, roadmap §5) ──\nexport { createRng, type Rng } from \"./rng/rng.js\";\nexport { splitmix32 } from \"./rng/splitmix32.js\";\nexport { sfc32Next, type Sfc32State } from \"./rng/sfc32.js\";\n\n// ── The synthetic-safety provider layer (roadmap §4) ──\nexport {\n  safe,\n  ssn,\n  phone,\n  name,\n  email,\n  ipv4,\n  ipv6,\n  uuid,\n  identifier,\n  address,\n  dateYmd,\n  npi,\n  dea,\n  type SyntheticName,\n  type SyntheticAddress,\n  type SyntheticIdentifier,\n  type SsnBlock,\n} from \"./safe/index.js\";\nexport {\n  isSyntheticSsn,\n  isSyntheticPhone,\n  isSyntheticEmail,\n  isSyntheticIp,\n  isSyntheticNpi,\n  npiCheckDigit,\n  luhnMod10,\n  isSyntheticDea,\n  deaCheckDigit,\n  DEA_REGISTRANT_TYPES,\n  SYNTHETIC_ASSIGNING_AUTHORITY,\n  RESERVED_EMAIL_DOMAINS,\n  TEST_NET_V4_PREFIXES,\n  DOC_V6_PREFIX,\n  NPI_LUHN_PREFIX,\n} from \"./safe/reserved.js\";\nexport {\n  SYNTHETIC_GIVEN_NAMES,\n  SYNTHETIC_FAMILY_NAMES,\n  SYNTHETIC_STREET_NAMES,\n  SYNTHETIC_CITY_NAMES,\n} from \"./safe/names-pool.js\";\n\n// ── The reproducible Corpus abstraction (roadmap §2, §5) ──\nexport {\n  makeCorpus,\n  type Corpus,\n  type CorpusManifest,\n  type Artifact,\n  type SynthFormat,\n} from \"./corpus.js\";\n\n// ── The profile growth-loop skeleton (roadmap §Phase 1) ──\nexport { defineSynthProfile, type SynthProfile, type SynthProfileSpec } from \"./profile.js\";\n\n// ── The quirk core (roadmap §Phase 7 — the differentiator; format recipes live per-subpath) ──\nexport {\n  resolveQuirk,\n  sameCodeSet,\n  profileTolerated,\n  validateProfileQuirks,\n  assertIntendedWarnings,\n  PROFILE_QUIRK_APPLIED,\n  type QuirkDescriptor,\n  type QuirkArtifact,\n  type QuirkProfileDisposition,\n  type QuirkProfiledVerdict,\n  type QuirkRoundTripResult,\n} from \"./quirk.js\";\n\n// ── Stable fatal codes + the typed error (roadmap §Phase 1) ──\nexport {\n  SYNTH_FATAL_CODES,\n  SYNTH_FATAL_MESSAGES,\n  SynthError,\n  type SynthFatalCode,\n} from \"./codes.js\";\nexport { resolveKind, resolveMix } from \"./select.js\";\n"]}