@cosyte/synth 0.0.6 → 0.0.8

package/dist/{providers-OLz3zAc-.d.cts → providers-B9uVinAe.d.cts}

@@ -1,9 +1,9 @@
 /**
- * The `Corpus` abstraction — a seed plus a self-describing manifest of what was generated, so a
+ * The `Corpus` abstraction: a seed plus a self-describing manifest of what was generated, so a
  * fixture set is itself reproducible and regenerable. A downstream repo pins a seed
  * and gets a stable fixture set that regenerates identically.
  *
- * Generated artifacts and the `Corpus` are **deep-frozen** — this is where the archetype's immutability
+ * Generated artifacts and the `Corpus` are **deep-frozen**: this is where the archetype's immutability
  * invariant lives in a generator: a consumer cannot mutate a shared fixture out from under
  * another test.
  *
@@ -12,7 +12,7 @@
 /** The format an artifact was generated for. */
 type SynthFormat = "hl7v2" | "fhir" | "ccda" | "x12" | "ncpdp" | "astm";
 /**
- * One generated artifact — the serialized wire text plus the metadata needed to reproduce and check
+ * One generated artifact: the serialized wire text plus the metadata needed to reproduce and check
  * it. `warnings` records what the artifact's own parser reported on the round-trip (zero for a
  * spec-clean artifact).
  */
@@ -37,7 +37,7 @@ interface CorpusManifest {
 }
 /** A reproducible, self-describing set of generated artifacts. */
 interface Corpus {
-    /** The seed the corpus was generated from — regenerating from it yields byte-identical artifacts. */
+    /** The seed the corpus was generated from: regenerating from it yields byte-identical artifacts. */
     readonly seed: number;
     /** The manifest describing what was generated. */
     readonly manifest: CorpusManifest;
@@ -61,16 +61,16 @@ interface Corpus {
 declare function makeCorpus(seed: number, artifacts: readonly Artifact[], quirks?: readonly string[]): Corpus;
 
 /**
- * `Rng` — the seeded, deterministic random source every `@cosyte/synth` provider draws from.
+ * `Rng`: the seeded, deterministic random source every `@cosyte/synth` provider draws from.
  *
- * **The reproducibility contract.** A seed — and only the seed — determines the output.
+ * **The reproducibility contract.** A seed, and only the seed, determines the output.
  * `createRng(seed)` expands the integer seed through {@link ./splitmix32.splitmix32} into the four
  * `sfc32` state words, then every draw advances that state via {@link ./sfc32.sfc32Next}. Two `Rng`s
- * created from the same seed emit the **identical** sequence on any machine, any run — the property
+ * created from the same seed emit the **identical** sequence on any machine, any run: the property
  * the parsers', `transform`'s, and `deid`'s regression suites depend on.
  *
  * **Explicit, never global.** An `Rng` is a value you thread through a build; there is no ambient
- * shared generator and **`Math.random` is lint-banned** in `src/` (it is not seedable — its seed is
+ * shared generator and **`Math.random` is lint-banned** in `src/` (it is not seedable: its seed is
  * engine-chosen and cannot be reset, so a corpus built on it is not reproducible). Because each
  * generation creates a fresh `Rng` from its seed, generations are independent and parallel-safe.
  *
@@ -128,13 +128,13 @@ interface Rng {
 declare function createRng(seed: number): Rng;
 
 /**
- * The synthetic-safety provider layer — every identifier, contact point, name, and date
+ * The synthetic-safety provider layer: every identifier, contact point, name, and date
  * `@cosyte/synth` emits is minted here, and **only** from a guaranteed-non-colliding source. There is no code
  * path that returns a value not drawn from a reserved range or the
  * shipped fake-name pool. This is the inverse of a parser's liberality: the generator is *closed-world*
  * on its data sources, so no output *can* be real or plausibly-real PHI.
  *
- * All providers are pure functions of an explicit {@link ../rng/rng.Rng} — same seed, same values.
+ * All providers are pure functions of an explicit {@link ../rng/rng.Rng}, same seed, same values.
  *
  * @module
  */
@@ -146,7 +146,7 @@ interface SyntheticName {
     /** A clearly-fake family name. */
     readonly family: string;
 }
-/** A synthetic postal address — synthetic street + city, a fixed non-real ZIP. */
+/** A synthetic postal address: synthetic street + city, a fixed non-real ZIP. */
 interface SyntheticAddress {
     /** A clearly-fake street line. */
     readonly street: string;
@@ -159,7 +159,7 @@ interface SyntheticAddress {
 }
 /** A synthetic identifier scoped to the synthetic assigning authority. */
 interface SyntheticIdentifier {
-    /** The identifier value (digits) — unique only within the synthetic namespace. */
+    /** The identifier value (digits): unique only within the synthetic namespace. */
     readonly value: string;
     /** HL7 identifier type code (`MR` = medical record, `AN` = account, `MB` = member). */
     readonly typeCode: "MR" | "AN" | "MB";
@@ -171,7 +171,7 @@ interface SyntheticIdentifier {
 /** Which SSN reserved space to draw from. */
 type SsnBlock = "never-issued" | "advertising";
 /**
- * A **synthetic SSN** — dashed `AAA-GG-SSSS`. Default draws the SSA never-issued area space
+ * A **synthetic SSN**: dashed `AAA-GG-SSSS`. Default draws the SSA never-issued area space
  * (`900–999`); `block: "advertising"` draws SSA's reserved advertising block (`987-65-4320…4329`).
  * A value from this function can never be a real SSN.
  *
@@ -186,7 +186,7 @@ type SsnBlock = "never-issued" | "advertising";
  */
 declare function ssn(rng: Rng, block?: SsnBlock): string;
 /**
- * A **synthetic phone** in the NANP reserved fictional block — `(AAA) 555-01NN`. The reserved
+ * A **synthetic phone** in the NANP reserved fictional block: `(AAA) 555-01NN`. The reserved
  * guarantee is the `555-01NN` tail (exchange 555, line 0100–0199); the area code is any NANP-valid
  * `NXX`. Can never be a working number.
  *
@@ -212,7 +212,7 @@ declare function phone(rng: Rng): string;
  */
 declare function name(rng: Rng): SyntheticName;
 /**
- * A **synthetic email** at an RFC 2606 / 6761 reserved domain — `<slug>@example.com`.
+ * A **synthetic email** at an RFC 2606 / 6761 reserved domain: `<slug>@example.com`.
  *
  * @param rng - The seeded generator.
  * @param person - Optional name to derive the local-part slug from; otherwise a random slug is used.
@@ -225,7 +225,7 @@ declare function name(rng: Rng): SyntheticName;
  */
 declare function email(rng: Rng, person?: SyntheticName): string;
 /**
- * A **synthetic IPv4** in an RFC 5737 TEST-NET block — never routable.
+ * A **synthetic IPv4** in an RFC 5737 TEST-NET block, never routable.
  *
  * @param rng - The seeded generator.
  * @returns A TEST-NET IPv4 address string.
@@ -237,7 +237,7 @@ declare function email(rng: Rng, person?: SyntheticName): string;
  */
 declare function ipv4(rng: Rng): string;
 /**
- * A **synthetic IPv6** in the RFC 3849 documentation prefix `2001:db8::/32` — never routable.
+ * A **synthetic IPv6** in the RFC 3849 documentation prefix `2001:db8::/32`, never routable.
  *
  * @param rng - The seeded generator.
  * @returns A documentation-prefix IPv6 address string.
@@ -250,7 +250,7 @@ declare function ipv4(rng: Rng): string;
 declare function ipv6(rng: Rng): string;
 /**
  * A **deterministic UUIDv4-shaped** surrogate key from the seeded generator. Because it is seeded (not
- * from `node:crypto`, which is not reproducible), the cryptographic non-collision argument is weaker —
+ * from `node:crypto`, which is not reproducible), the cryptographic non-collision argument is weaker,
  * acceptable because the identifier namespace is synthetic anyway, and noted honestly.
  *
  * @param rng - The seeded generator.
@@ -263,7 +263,7 @@ declare function ipv6(rng: Rng): string;
  */
 declare function uuid(rng: Rng): string;
 /**
- * A **synthetic NPI** — a 10-digit National Provider Identifier with a **deliberately-invalid Luhn
+ * A **synthetic NPI**: a 10-digit National Provider Identifier with a **deliberately-invalid Luhn
  * check digit**, so it can never be a NPPES-issued NPI (a real NPI must satisfy the `80840`-prefixed
  * Luhn check). The 9-digit base is drawn from the seeded generator; the check digit is
  * set to `(correct + 1) mod 10`, guaranteeing the full value fails validation.
@@ -273,18 +273,18 @@ declare function uuid(rng: Rng): string;
  * @example
  * ```ts
  * import { createRng, npi, isSyntheticNpi } from "@cosyte/synth";
- * isSyntheticNpi(npi(createRng(1))); // true — invalid check digit by construction
+ * isSyntheticNpi(npi(createRng(1))); // true: invalid check digit by construction
  * ```
  */
 declare function npi(rng: Rng): string;
 /**
- * A **synthetic DEA number** — `<registrant-type><initial>` + 7 digits with a **deliberately-invalid
+ * A **synthetic DEA number**: `<registrant-type><initial>` + 7 digits with a **deliberately-invalid
  * checksum**, so it can never be a validly-issued DEA registration (a real DEA number's 7th digit
  * satisfies the published DEA checksum). The first letter is a registrant-type letter, the
  * second is derived from `person` (its family initial) when supplied so the number reads plausibly; the
  * 6-digit base is seeded and the check digit is set to `(correct + 1) mod 10`, guaranteeing the value
  * fails validation. NCPDP carries prescriber DEA, and this is the identity locus a refuter attacks
- * hardest, so — like {@link npi} — non-collision is a construction-level guarantee, not a heuristic.
+ * hardest, so, like {@link npi}, non-collision is a construction-level guarantee, not a heuristic.
  *
  * @param rng - The seeded generator.
  * @param person - Optional name whose family initial becomes the DEA's second letter.
@@ -292,7 +292,7 @@ declare function npi(rng: Rng): string;
  * @example
  * ```ts
  * import { createRng, dea, isSyntheticDea } from "@cosyte/synth";
- * isSyntheticDea(dea(createRng(1))); // true — invalid checksum by construction
+ * isSyntheticDea(dea(createRng(1))); // true: invalid checksum by construction
  * ```
  */
 declare function dea(rng: Rng, person?: SyntheticName): string;
@@ -312,7 +312,7 @@ declare function dea(rng: Rng, person?: SyntheticName): string;
  */
 declare function identifier(rng: Rng, typeCode?: SyntheticIdentifier["typeCode"]): SyntheticIdentifier;
 /**
- * A **synthetic address** — a fake street + city, a reserved non-real ZIP (`00000`). A real state
+ * A **synthetic address**: a fake street + city, a reserved non-real ZIP (`00000`). A real state
  * abbreviation may appear (structural only) but is never combined with a real street + name + DOB.
  *
  * @param rng - The seeded generator.

package/dist/{providers-OLz3zAc-.d.ts → providers-B9uVinAe.d.ts}

@@ -1,9 +1,9 @@
 /**
- * The `Corpus` abstraction — a seed plus a self-describing manifest of what was generated, so a
+ * The `Corpus` abstraction: a seed plus a self-describing manifest of what was generated, so a
  * fixture set is itself reproducible and regenerable. A downstream repo pins a seed
  * and gets a stable fixture set that regenerates identically.
  *
- * Generated artifacts and the `Corpus` are **deep-frozen** — this is where the archetype's immutability
+ * Generated artifacts and the `Corpus` are **deep-frozen**: this is where the archetype's immutability
  * invariant lives in a generator: a consumer cannot mutate a shared fixture out from under
  * another test.
  *
@@ -12,7 +12,7 @@
 /** The format an artifact was generated for. */
 type SynthFormat = "hl7v2" | "fhir" | "ccda" | "x12" | "ncpdp" | "astm";
 /**
- * One generated artifact — the serialized wire text plus the metadata needed to reproduce and check
+ * One generated artifact: the serialized wire text plus the metadata needed to reproduce and check
  * it. `warnings` records what the artifact's own parser reported on the round-trip (zero for a
  * spec-clean artifact).
  */
@@ -37,7 +37,7 @@ interface CorpusManifest {
 }
 /** A reproducible, self-describing set of generated artifacts. */
 interface Corpus {
-    /** The seed the corpus was generated from — regenerating from it yields byte-identical artifacts. */
+    /** The seed the corpus was generated from: regenerating from it yields byte-identical artifacts. */
     readonly seed: number;
     /** The manifest describing what was generated. */
     readonly manifest: CorpusManifest;
@@ -61,16 +61,16 @@ interface Corpus {
 declare function makeCorpus(seed: number, artifacts: readonly Artifact[], quirks?: readonly string[]): Corpus;
 
 /**
- * `Rng` — the seeded, deterministic random source every `@cosyte/synth` provider draws from.
+ * `Rng`: the seeded, deterministic random source every `@cosyte/synth` provider draws from.
  *
- * **The reproducibility contract.** A seed — and only the seed — determines the output.
+ * **The reproducibility contract.** A seed, and only the seed, determines the output.
  * `createRng(seed)` expands the integer seed through {@link ./splitmix32.splitmix32} into the four
  * `sfc32` state words, then every draw advances that state via {@link ./sfc32.sfc32Next}. Two `Rng`s
- * created from the same seed emit the **identical** sequence on any machine, any run — the property
+ * created from the same seed emit the **identical** sequence on any machine, any run: the property
  * the parsers', `transform`'s, and `deid`'s regression suites depend on.
  *
  * **Explicit, never global.** An `Rng` is a value you thread through a build; there is no ambient
- * shared generator and **`Math.random` is lint-banned** in `src/` (it is not seedable — its seed is
+ * shared generator and **`Math.random` is lint-banned** in `src/` (it is not seedable: its seed is
  * engine-chosen and cannot be reset, so a corpus built on it is not reproducible). Because each
  * generation creates a fresh `Rng` from its seed, generations are independent and parallel-safe.
  *
@@ -128,13 +128,13 @@ interface Rng {
 declare function createRng(seed: number): Rng;
 
 /**
- * The synthetic-safety provider layer — every identifier, contact point, name, and date
+ * The synthetic-safety provider layer: every identifier, contact point, name, and date
  * `@cosyte/synth` emits is minted here, and **only** from a guaranteed-non-colliding source. There is no code
  * path that returns a value not drawn from a reserved range or the
  * shipped fake-name pool. This is the inverse of a parser's liberality: the generator is *closed-world*
  * on its data sources, so no output *can* be real or plausibly-real PHI.
  *
- * All providers are pure functions of an explicit {@link ../rng/rng.Rng} — same seed, same values.
+ * All providers are pure functions of an explicit {@link ../rng/rng.Rng}, same seed, same values.
  *
  * @module
  */
@@ -146,7 +146,7 @@ interface SyntheticName {
     /** A clearly-fake family name. */
     readonly family: string;
 }
-/** A synthetic postal address — synthetic street + city, a fixed non-real ZIP. */
+/** A synthetic postal address: synthetic street + city, a fixed non-real ZIP. */
 interface SyntheticAddress {
     /** A clearly-fake street line. */
     readonly street: string;
@@ -159,7 +159,7 @@ interface SyntheticAddress {
 }
 /** A synthetic identifier scoped to the synthetic assigning authority. */
 interface SyntheticIdentifier {
-    /** The identifier value (digits) — unique only within the synthetic namespace. */
+    /** The identifier value (digits): unique only within the synthetic namespace. */
     readonly value: string;
     /** HL7 identifier type code (`MR` = medical record, `AN` = account, `MB` = member). */
     readonly typeCode: "MR" | "AN" | "MB";
@@ -171,7 +171,7 @@ interface SyntheticIdentifier {
 /** Which SSN reserved space to draw from. */
 type SsnBlock = "never-issued" | "advertising";
 /**
- * A **synthetic SSN** — dashed `AAA-GG-SSSS`. Default draws the SSA never-issued area space
+ * A **synthetic SSN**: dashed `AAA-GG-SSSS`. Default draws the SSA never-issued area space
  * (`900–999`); `block: "advertising"` draws SSA's reserved advertising block (`987-65-4320…4329`).
  * A value from this function can never be a real SSN.
  *
@@ -186,7 +186,7 @@ type SsnBlock = "never-issued" | "advertising";
  */
 declare function ssn(rng: Rng, block?: SsnBlock): string;
 /**
- * A **synthetic phone** in the NANP reserved fictional block — `(AAA) 555-01NN`. The reserved
+ * A **synthetic phone** in the NANP reserved fictional block: `(AAA) 555-01NN`. The reserved
  * guarantee is the `555-01NN` tail (exchange 555, line 0100–0199); the area code is any NANP-valid
  * `NXX`. Can never be a working number.
  *
@@ -212,7 +212,7 @@ declare function phone(rng: Rng): string;
  */
 declare function name(rng: Rng): SyntheticName;
 /**
- * A **synthetic email** at an RFC 2606 / 6761 reserved domain — `<slug>@example.com`.
+ * A **synthetic email** at an RFC 2606 / 6761 reserved domain: `<slug>@example.com`.
  *
  * @param rng - The seeded generator.
  * @param person - Optional name to derive the local-part slug from; otherwise a random slug is used.
@@ -225,7 +225,7 @@ declare function name(rng: Rng): SyntheticName;
  */
 declare function email(rng: Rng, person?: SyntheticName): string;
 /**
- * A **synthetic IPv4** in an RFC 5737 TEST-NET block — never routable.
+ * A **synthetic IPv4** in an RFC 5737 TEST-NET block, never routable.
  *
  * @param rng - The seeded generator.
  * @returns A TEST-NET IPv4 address string.
@@ -237,7 +237,7 @@ declare function email(rng: Rng, person?: SyntheticName): string;
  */
 declare function ipv4(rng: Rng): string;
 /**
- * A **synthetic IPv6** in the RFC 3849 documentation prefix `2001:db8::/32` — never routable.
+ * A **synthetic IPv6** in the RFC 3849 documentation prefix `2001:db8::/32`, never routable.
  *
  * @param rng - The seeded generator.
  * @returns A documentation-prefix IPv6 address string.
@@ -250,7 +250,7 @@ declare function ipv4(rng: Rng): string;
 declare function ipv6(rng: Rng): string;
 /**
  * A **deterministic UUIDv4-shaped** surrogate key from the seeded generator. Because it is seeded (not
- * from `node:crypto`, which is not reproducible), the cryptographic non-collision argument is weaker —
+ * from `node:crypto`, which is not reproducible), the cryptographic non-collision argument is weaker,
  * acceptable because the identifier namespace is synthetic anyway, and noted honestly.
  *
  * @param rng - The seeded generator.
@@ -263,7 +263,7 @@ declare function ipv6(rng: Rng): string;
  */
 declare function uuid(rng: Rng): string;
 /**
- * A **synthetic NPI** — a 10-digit National Provider Identifier with a **deliberately-invalid Luhn
+ * A **synthetic NPI**: a 10-digit National Provider Identifier with a **deliberately-invalid Luhn
  * check digit**, so it can never be a NPPES-issued NPI (a real NPI must satisfy the `80840`-prefixed
  * Luhn check). The 9-digit base is drawn from the seeded generator; the check digit is
  * set to `(correct + 1) mod 10`, guaranteeing the full value fails validation.
@@ -273,18 +273,18 @@ declare function uuid(rng: Rng): string;
  * @example
  * ```ts
  * import { createRng, npi, isSyntheticNpi } from "@cosyte/synth";
- * isSyntheticNpi(npi(createRng(1))); // true — invalid check digit by construction
+ * isSyntheticNpi(npi(createRng(1))); // true: invalid check digit by construction
  * ```
  */
 declare function npi(rng: Rng): string;
 /**
- * A **synthetic DEA number** — `<registrant-type><initial>` + 7 digits with a **deliberately-invalid
+ * A **synthetic DEA number**: `<registrant-type><initial>` + 7 digits with a **deliberately-invalid
  * checksum**, so it can never be a validly-issued DEA registration (a real DEA number's 7th digit
  * satisfies the published DEA checksum). The first letter is a registrant-type letter, the
  * second is derived from `person` (its family initial) when supplied so the number reads plausibly; the
  * 6-digit base is seeded and the check digit is set to `(correct + 1) mod 10`, guaranteeing the value
  * fails validation. NCPDP carries prescriber DEA, and this is the identity locus a refuter attacks
- * hardest, so — like {@link npi} — non-collision is a construction-level guarantee, not a heuristic.
+ * hardest, so, like {@link npi}, non-collision is a construction-level guarantee, not a heuristic.
  *
  * @param rng - The seeded generator.
  * @param person - Optional name whose family initial becomes the DEA's second letter.
@@ -292,7 +292,7 @@ declare function npi(rng: Rng): string;
  * @example
  * ```ts
  * import { createRng, dea, isSyntheticDea } from "@cosyte/synth";
- * isSyntheticDea(dea(createRng(1))); // true — invalid checksum by construction
+ * isSyntheticDea(dea(createRng(1))); // true: invalid checksum by construction
  * ```
  */
 declare function dea(rng: Rng, person?: SyntheticName): string;
@@ -312,7 +312,7 @@ declare function dea(rng: Rng, person?: SyntheticName): string;
  */
 declare function identifier(rng: Rng, typeCode?: SyntheticIdentifier["typeCode"]): SyntheticIdentifier;
 /**
- * A **synthetic address** — a fake street + city, a reserved non-real ZIP (`00000`). A real state
+ * A **synthetic address**: a fake street + city, a reserved non-real ZIP (`00000`). A real state
  * abbreviation may appear (structural only) but is never combined with a real street + name + DOB.
  *
  * @param rng - The seeded generator.

package/dist/{quirk-C9t9CkPS.d.ts → quirk-HZdznAkM.d.ts}

@@ -1,7 +1,7 @@
-import { m as SynthFormat } from './providers-OLz3zAc-.js';
+import { m as SynthFormat } from './providers-B9uVinAe.js';
 
 /**
- * `defineSynthProfile` — the growth-loop hook for site/vendor fixture recipes. A profile bundles the
+ * `defineSynthProfile`: the growth-loop hook for site/vendor fixture recipes. A profile bundles the
  * value pools and the quirk recipe a fixture set should use, authored through the same public API as
  * the built-ins: a validated, frozen `SynthProfile` carrying a name, optional value overrides, and the
  * quirk names a format's quirk corpus should apply.
@@ -12,7 +12,7 @@ import { m as SynthFormat } from './providers-OLz3zAc-.js';
 interface SynthProfileSpec {
     /** A stable, human-readable profile name (e.g. `"acme-hospital"`). Required, non-empty. */
     readonly name: string;
-    /** Optional given-name pool override (clearly-synthetic names only — see the safety invariant). */
+    /** Optional given-name pool override (clearly-synthetic names only, see the safety invariant). */
     readonly givenNames?: readonly string[];
     /** Optional family-name pool override (clearly-synthetic names only). */
     readonly familyNames?: readonly string[];
@@ -52,9 +52,9 @@ declare function defineSynthProfile(spec: SynthProfileSpec): SynthProfile;
  * The **quirk core**. Where the spec-clean generators prove
  * *synthetic-by-construction* through each parser's own builder, the quirk layer proves the mirror
  * property: a **deliberately off-spec** fixture round-trips to **exactly the intended parser warning
- * code(s)** — no more, no fewer. The quirk vocabulary **is the parsers' own profile systems**
+ * code(s)**, no more, no fewer. The quirk vocabulary **is the parsers' own profile systems**
  * (`hl7.defineProfile`, `ccda.defineCcdaProfile`, `astm.defineAstmProfile`): a quirk exercises exactly
- * the tolerance the corresponding parser profile encodes, so a quirk fixture is never a fiction — it
+ * the tolerance the corresponding parser profile encodes, so a quirk fixture is never a fiction, it
  * targets a documented, coded leniency (the **intended-warning contract**).
  *
  * This module is the **format-agnostic** part: the descriptor a quirk carries, the artifact a quirk
@@ -65,25 +65,25 @@ declare function defineSynthProfile(spec: SynthProfileSpec): SynthProfile;
  */
 
 /**
- * How the parser's matching profile treats a quirk once it is active — the three shapes the parsers'
+ * How the parser's matching profile treats a quirk once it is active: the three shapes the parsers'
  * profile systems actually exhibit (verified firsthand against each parser):
  *
- * - `"suppressed"` — the profile makes the warning **disappear** (HL7 v2: a `defineProfile`
+ * - `"suppressed"`, the profile makes the warning **disappear** (HL7 v2: a `defineProfile`
  *   `customSegments` claim suppresses `UNKNOWN_SEGMENT` for a declared Z-segment).
- * - `"rebadged"` — the profile **downgrades** the warning to the value-free `PROFILE_QUIRK_APPLIED`
+ * - `"rebadged"`, the profile **downgrades** the warning to the value-free `PROFILE_QUIRK_APPLIED`
  *   marker with `expected: true` (C-CDA `defineCcdaProfile` / ASTM `defineAstmProfile`
  *   `profileQuirkApplied`).
- * - `"bare"` — no shipped profile tolerates it; the quirk targets a real coded leniency a consumer can
+ * - `"bare"`, no shipped profile tolerates it; the quirk targets a real coded leniency a consumer can
  *   tolerate via their own `defineProfile`/`defineAstmProfile`, but no built-in re-badges it.
  */
 type QuirkProfileDisposition = "suppressed" | "rebadged" | "bare";
 /**
  * The stable, value-free re-badge code the C-CDA and ASTM parsers emit when a profile tolerates a
- * quirk. HL7 v2 has no equivalent (it suppresses instead — see {@link QuirkProfileDisposition}).
+ * quirk. HL7 v2 has no equivalent (it suppresses instead: see {@link QuirkProfileDisposition}).
  */
 declare const PROFILE_QUIRK_APPLIED = "PROFILE_QUIRK_APPLIED";
 /**
- * A public, grounded description of one vendor quirk — the metadata that binds a quirk recipe to a real
+ * A public, grounded description of one vendor quirk: the metadata that binds a quirk recipe to a real
  * parser warning code and a **publicly-groundable** deviation (cited-public, never a private
  * vendor corpus).
  */
@@ -93,12 +93,12 @@ interface QuirkDescriptor {
     /** The format this quirk applies to. */
     readonly format: SynthFormat;
     /**
-     * The **exact** parser warning code(s) a bare parse (no profile) surfaces for this quirk — the
+     * The **exact** parser warning code(s) a bare parse (no profile) surfaces for this quirk, the
      * intended-warning contract. A quirk that produces any other code, or none, is a generation bug.
      */
     readonly intendedWarnings: readonly string[];
     /**
-     * The **public** grounding for this quirk — the spec clause or the parser's public profile that
+     * The **public** grounding for this quirk, the spec clause or the parser's public profile that
      * documents the tolerance. Never a private vendor-attributed corpus.
      */
     readonly grounding: string;
@@ -107,7 +107,7 @@ interface QuirkDescriptor {
     /** How {@link toleratingProfile} treats the quirk. */
     readonly disposition: QuirkProfileDisposition;
 }
-/** One generated quirk artifact — the off-spec wire text plus the contract it is meant to satisfy. */
+/** One generated quirk artifact: the off-spec wire text plus the contract it is meant to satisfy. */
 interface QuirkArtifact {
     /** The format this artifact belongs to. */
     readonly format: SynthFormat;
@@ -143,14 +143,14 @@ interface QuirkRoundTripResult {
     /** The exact code(s) the quirk is meant to produce. */
     readonly intendedWarnings: readonly string[];
     /**
-     * `true` iff the bare parse produced **exactly** the intended code(s) — the intended-warning contract.
+     * `true` iff the bare parse produced **exactly** the intended code(s), the intended-warning contract.
      */
     readonly intendedWarningHeld: boolean;
     /** The verdict under the tolerating profile, when a built-in public one exists. */
     readonly withProfile?: QuirkProfiledVerdict;
 }
 /**
- * Exact multiset (order-independent) equality of two code lists — the intended-warning comparison.
+ * Exact multiset (order-independent) equality of two code lists: the intended-warning comparison.
  *
  * @param a - The first code list.
  * @param b - The second code list.
@@ -164,12 +164,12 @@ interface QuirkRoundTripResult {
 declare function sameCodeSet(a: readonly string[], b: readonly string[]): boolean;
 /**
  * Resolve a requested quirk name against a format's registry, or **fail closed**. A quirk the format's
- * profile system does not support is a fatal `SYNTH_UNSUPPORTED_QUIRK` — never a silent no-op and never
+ * profile system does not support is a fatal `SYNTH_UNSUPPORTED_QUIRK`, never a silent no-op and never
  * a fabricated quirk with a made-up warning.
  *
  * The refusal names neither the request nor the registry. `registry`, `format` and `name` are all
  * caller-supplied, and a diagnostic that quotes its input is a diagnostic that can be made to carry
- * anything the caller was holding — which for a fixture generator wired into someone else's pipeline
+ * anything the caller was holding, which for a fixture generator wired into someone else's pipeline
  * is not a hypothetical. Branch on `err.code`; the supported set is the registry you passed
  * (`HL7_QUIRKS`, `CCDA_QUIRKS`, `ASTM_QUIRKS`), which you can enumerate directly.
  *
@@ -197,22 +197,22 @@ declare function resolveQuirk(registry: Readonly<Record<string, QuirkDescriptor>
  * @example
  * ```ts
  * import { profileTolerated } from "@cosyte/synth";
- * profileTolerated("suppressed", ["UNKNOWN_SEGMENT"], []); // true — the profile suppressed it
+ * profileTolerated("suppressed", ["UNKNOWN_SEGMENT"], []); // true: the profile suppressed it
  * ```
  */
 declare function profileTolerated(disposition: QuirkProfileDisposition, intendedWarnings: readonly string[], warningsUnderProfile: readonly string[]): boolean;
 /**
  * Assert a freshly-generated quirk artifact **actually** round-trips to its intended warning(s), or
  * **fail closed**. This is the generator's self-check on the intended-warning contract: a
- * fixture whose bare parse does not produce exactly the declared code(s) is a *mislabeled* fixture — a
- * golden file that lies about the parser verdict it anchors — and must never be emitted. It is a
+ * fixture whose bare parse does not produce exactly the declared code(s) is a *mislabeled* fixture, a
+ * golden file that lies about the parser verdict it anchors, and must never be emitted. It is a
  * stronger guard than "the transform changed some bytes": a transform can mutate the wrong element (a
  * template a given document type does not key its warning on) and still change bytes while producing no
  * warning. Every format's `generate*Quirk` calls this after transforming, so the contract is enforced at
  * generation time, not merely at round-trip time.
  *
- * It no longer takes the quirk name. That parameter existed for one reason — to be interpolated into
- * the refusal — and a parameter whose only job is to reach a message is the exact shape this package
+ * It no longer takes the quirk name. That parameter existed for one reason, to be interpolated into
+ * the refusal, and a parameter whose only job is to reach a message is the exact shape this package
  * is removing, so it is gone rather than merely unused. The refusal names neither code list either;
  * both are caller-supplied, and the caller reads the comparison back off the arguments it holds.
  *