@cosyte/synth 0.0.6 → 0.0.8

package/dist/ncpdp/index.d.cts

@@ -1,15 +1,15 @@
-import { S as SyntheticName, b as SyntheticAddress, R as Rng, C as Corpus } from '../providers-OLz3zAc-.cjs';
+import { S as SyntheticName, b as SyntheticAddress, R as Rng, C as Corpus } from '../providers-B9uVinAe.cjs';
 
 /**
- * Spec-clean NCPDP **SCRIPT** (XML ePrescribing) generation — `NewRx`, `RxRenewalRequest`, and
- * `RxChangeRequest` — built through `@cosyte/ncpdp`'s own emit surface so the XML is spec-clean by the
+ * Spec-clean NCPDP **SCRIPT** (XML ePrescribing) generation: `NewRx`, `RxRenewalRequest`, and
+ * `RxChangeRequest`, built through `@cosyte/ncpdp`'s own emit surface so the XML is spec-clean by the
  * same mechanism that makes the parser's serializer spec-clean:
  *
  * - **NewRx** is built through the validated `buildNewRx` builder (it refuses a NewRx with no
  *   medication description) and serialized by `serializeScript`.
  * - **RxRenewalRequest / RxChangeRequest** have no dedicated builder in `@cosyte/ncpdp` (its builders
- *   cover NewRx + the Status/Error/Verify responses), so — exactly as the X12 generator constructs a
- *   typed model and lets `serializeX12` emit it — these are built as the parser's **public, typed
+ *   cover NewRx + the Status/Error/Verify responses), so, exactly as the X12 generator constructs a
+ *   typed model and lets `serializeX12` emit it, these are built as the parser's **public, typed
  *   `ScriptMessage` model** (the same immutable model `buildNewRx` returns) and serialized by
  *   `serializeScript`. No byte is hand-written; the round-trip harness ({@link ./round-trip.scriptRoundTrip})
  *   re-parses every message through `parseScript` and asserts **zero warnings**, so spec-cleanliness is
@@ -23,7 +23,7 @@ import { S as SyntheticName, b as SyntheticAddress, R as Rng, C as Corpus } from
  */
 /** Options for the SCRIPT generators. */
 interface GenerateScriptOptions {
-    /** The seed (deterministic — same seed yields a byte-identical message). */
+    /** The seed (deterministic: same seed yields a byte-identical message). */
     readonly seed: number;
 }
 /**
@@ -72,8 +72,8 @@ declare function generateRxRenewalRequest(options: GenerateScriptOptions): strin
 declare function generateRxChangeRequest(options: GenerateScriptOptions): string;
 
 /**
- * Spec-clean NCPDP **Telecommunication vD.0** claim generation — `B1` (billing), `B2` (reversal), and
- * `B3` (rebill) — built through `@cosyte/ncpdp`'s `buildTelecomRequest` + `serializeTelecom` so the
+ * Spec-clean NCPDP **Telecommunication vD.0** claim generation: `B1` (billing), `B2` (reversal), and
+ * `B3` (rebill), built through `@cosyte/ncpdp`'s `buildTelecomRequest` + `serializeTelecom` so the
  * fixed Transaction Header, the FS/GS/RS framing, and every field are the parser's own conservative
  * emit. Every field id below is a real 2-character NCPDP field identifier, and every
  * value at a PHI-bearing locus is drawn from the synthetic-safety providers via {@link ./identity}: the
@@ -88,7 +88,7 @@ declare function generateRxChangeRequest(options: GenerateScriptOptions): string
 type TelecomTransactionCode = "B1" | "B2" | "B3";
 /** Options for the Telecom generators. */
 interface GenerateTelecomOptions {
-    /** The seed (deterministic — same seed yields a byte-identical transaction). */
+    /** The seed (deterministic: same seed yields a byte-identical transaction). */
     readonly seed: number;
 }
 /**
@@ -147,9 +147,9 @@ declare function generateB2(options: GenerateTelecomOptions): string;
 declare function generateB3(options: GenerateTelecomOptions): string;
 
 /**
- * The **round-trip-through-the-parser harness** for NCPDP — the headline gate for the synthetic-fixture
+ * The **round-trip-through-the-parser harness** for NCPDP: the headline gate for the synthetic-fixture
  * generator. A generated SCRIPT XML or Telecom claim is "spec-clean" only if
- * `@cosyte/ncpdp` — not `@cosyte/synth`'s own opinion — reads it back cleanly. Each harness parses the
+ * `@cosyte/ncpdp`, not `@cosyte/synth`'s own opinion, reads it back cleanly. Each harness parses the
  * generated wire text straight back through the parser and reports what it found, so a false
  * "spec-clean" claim cannot hide.
  *
@@ -197,41 +197,41 @@ declare function scriptRoundTrip(xml: string): RoundTripResult;
 declare function telecomRoundTrip(wire: string): RoundTripResult;
 
 /**
- * Synthetic identity for NCPDP transactions — every patient, prescriber, pharmacy, and cardholder
+ * Synthetic identity for NCPDP transactions: every patient, prescriber, pharmacy, and cardholder
  * identifier `synth` puts into a SCRIPT ePrescription or a Telecom claim is minted here, and **only**
  * from the synthetic-safety providers. NCPDP is identity-dense in a way the refuter
  * attacks hardest: a NewRx carries the **patient** (name, DOB, gender) *and* the **prescriber** (name,
  * NPI, **DEA**); a Telecom claim adds the **cardholder / member** (name, member id). Every locus below
  * has a construction-level guarantee, not a heuristic:
  *
- * - **NPI** — a deliberately **invalid Luhn** check digit, so it can never be a NPPES-issued NPI
+ * - **NPI**: a deliberately **invalid Luhn** check digit, so it can never be a NPPES-issued NPI
  *   ({@link ../safe/reserved.isSyntheticNpi}).
- * - **DEA** — a deliberately **invalid checksum**, so it can never be a validly-issued DEA registration
+ * - **DEA**: a deliberately **invalid checksum**, so it can never be a validly-issued DEA registration
  *   ({@link ../safe/reserved.isSyntheticDea}). This is the NCPDP-specific identity locus X12 did not have.
- * - **member / cardholder / patient id** — minted under the synthetic assigning authority with an
+ * - **member / cardholder / patient id**: minted under the synthetic assigning authority with an
  *   `MBR` prefix (no reserved range exists; the *namespace* is the guarantee).
- * - **name** — the shipped clearly-fake pool; **DOB** — the seeded generator (no real event implied);
- *   **phone** — the reserved `555-01xx` block; **address** — synthetic street + reserved ZIP.
+ * - **name**: the shipped clearly-fake pool; **DOB**: the seeded generator (no real event implied);
+ *   **phone**: the reserved `555-01xx` block; **address**: synthetic street + reserved ZIP.
  *
  * @module
  */
 
-/** A synthetic patient — every field from `../safe`. */
+/** A synthetic patient: every field from `../safe`. */
 interface NcpdpPatient {
     /** Name from the shipped fake-name pool. */
     readonly person: SyntheticName;
     /** Date of birth `CCYYMMDD` from the seeded generator. */
     readonly dob: string;
-    /** Administrative gender code (`1` = male, `2` = female — NCPDP gender codes). */
+    /** Administrative gender code (`1` = male, `2` = female, NCPDP gender codes). */
     readonly gender: "1" | "2";
-    /** Patient id, synthetic-AA scoped (`MBR`-prefixed — never a bare SSN). */
+    /** Patient id, synthetic-AA scoped (`MBR`-prefixed, never a bare SSN). */
     readonly patientId: string;
     /** Reserved `555-01xx` phone. */
     readonly phone: string;
     /** Synthetic postal address (reserved non-real ZIP). */
     readonly address: SyntheticAddress;
 }
-/** A synthetic prescriber — name + invalid-Luhn NPI + invalid-checksum DEA. */
+/** A synthetic prescriber: name + invalid-Luhn NPI + invalid-checksum DEA. */
 interface NcpdpPrescriber {
     /** A clearly-fake prescriber name. */
     readonly person: SyntheticName;
@@ -240,16 +240,16 @@ interface NcpdpPrescriber {
     /** A DEA number with a deliberately-invalid checksum (never a real DEA registration). */
     readonly dea: string;
 }
-/** A synthetic dispensing pharmacy — business name + invalid-Luhn NPI + synthetic NCPDP id. */
+/** A synthetic dispensing pharmacy: business name + invalid-Luhn NPI + synthetic NCPDP id. */
 interface NcpdpPharmacy {
     /** A clearly-fictional pharmacy business name. */
     readonly businessName: string;
     /** A 10-digit NPI with a deliberately-invalid Luhn check digit. */
     readonly npi: string;
-    /** A 7-digit NCPDP provider id (synthetic — an all-digit id under no real chain). */
+    /** A 7-digit NCPDP provider id (synthetic, an all-digit id under no real chain). */
     readonly ncpdpId: string;
 }
-/** A synthetic cardholder / insurance identity — the covered person on a Telecom claim. */
+/** A synthetic cardholder / insurance identity: the covered person on a Telecom claim. */
 interface NcpdpCardholder {
     /** The cardholder name (may differ from the patient). */
     readonly person: SyntheticName;
@@ -257,7 +257,7 @@ interface NcpdpCardholder {
     readonly cardholderId: string;
     /** Group id, synthetic. */
     readonly groupId: string;
-    /** Person code (`01` = cardholder, `02` = spouse, `03` = child — structural). */
+    /** Person code (`01` = cardholder, `02` = spouse, `03` = child, structural). */
     readonly personCode: string;
 }
 /**
@@ -275,7 +275,7 @@ interface NcpdpCardholder {
  */
 declare function ncpdpPatient(rng: Rng): NcpdpPatient;
 /**
- * Mint a synthetic prescriber — a person name, an invalid-Luhn NPI, and an invalid-checksum DEA (the
+ * Mint a synthetic prescriber: a person name, an invalid-Luhn NPI, and an invalid-checksum DEA (the
  * DEA's second letter is derived from the prescriber's family name so it reads plausibly).
  *
  * @param rng - The seeded generator.
@@ -289,7 +289,7 @@ declare function ncpdpPatient(rng: Rng): NcpdpPatient;
  */
 declare function ncpdpPrescriber(rng: Rng): NcpdpPrescriber;
 /**
- * Mint a synthetic dispensing pharmacy — a fictional business name, an invalid-Luhn NPI, and a 7-digit
+ * Mint a synthetic dispensing pharmacy: a fictional business name, an invalid-Luhn NPI, and a 7-digit
  * synthetic NCPDP provider id.
  *
  * @param rng - The seeded generator.
@@ -315,13 +315,13 @@ declare function ncpdpPharmacy(rng: Rng): NcpdpPharmacy;
  * ```
  */
 declare function ncpdpCardholder(rng: Rng): NcpdpCardholder;
-/** A seeded SCRIPT routing/correlation bundle — message ids + timestamps, all reproducible. */
+/** A seeded SCRIPT routing/correlation bundle: message ids + timestamps, all reproducible. */
 interface NcpdpScriptRouting {
-    /** `<MessageID>` — a synthetic message id. */
+    /** `<MessageID>`: a synthetic message id. */
     readonly messageId: string;
-    /** `<SentTime>` — a seeded ISO-8601 timestamp (never wall-clock). */
+    /** `<SentTime>`, a seeded ISO-8601 timestamp (never wall-clock). */
     readonly sentTime: string;
-    /** `<PrescriberOrderNumber>` — a synthetic order number. */
+    /** `<PrescriberOrderNumber>`, a synthetic order number. */
     readonly prescriberOrderNumber: string;
     /** A `CCYYMMDD` written / service date (seeded, recent window). */
     readonly date: string;
@@ -343,11 +343,11 @@ declare function ncpdpScriptRouting(rng: Rng): NcpdpScriptRouting;
 
 /**
  * License-clean example drug + code pools for synthetic NCPDP generation. NCPDP charges for its
- * standards and is protective of their prose, so — like every other `synth` format — **no NCPDP
+ * standards and is protective of their prose, so, like every other `synth` format, **no NCPDP
  * copyrighted text is bundled**: these are widely-known generic drug descriptions and invented,
  * clearly-example product codes, not lifted from any NCPDP data dictionary.
  *
- * A drug code is **not** PHI — it names a product, never a patient — so realism here carries no
+ * A drug code is **not** PHI: it names a product, never a patient, so realism here carries no
  * synthetic-safety hazard; the pool exists only to give a generated NewRx / claim a plausible,
  * license-clean drug. Patient / prescriber identity comes from the synthetic-safety providers
  * (`../safe`), never from here.
@@ -360,7 +360,7 @@ declare function ncpdpScriptRouting(rng: Rng): NcpdpScriptRouting;
 interface NcpdpExampleDrug {
     /** A widely-known generic drug description (RxNorm-style; public knowledge, not NCPDP prose). */
     readonly description: string;
-    /** An invented 11-digit NDC (`5-4-2`, digits only) — an example product code, never a real NDC. */
+    /** An invented 11-digit NDC (`5-4-2`, digits only), an example product code, never a real NDC. */
     readonly ndc: string;
     /** The dispense quantity unit-of-measure qualifier hint (structural only). */
     readonly form: string;
@@ -371,30 +371,30 @@ interface NcpdpExampleDrug {
  * generics anyone can name without a licensed database.
  */
 declare const EXAMPLE_DRUGS: readonly NcpdpExampleDrug[];
-/** Example free-text SIG directions (public, common-sense dosing text — not NCPDP prose). */
+/** Example free-text SIG directions (public, common-sense dosing text, not NCPDP prose). */
 declare const EXAMPLE_SIG_TEXT: readonly string[];
 /** Dispense-as-written / product-selection codes (single-digit, structural). */
 declare const DAW_CODES: readonly string[];
 
 /**
- * `@cosyte/synth/ncpdp` — the NCPDP generation surface, exposed as its own subpath so importing the
+ * `@cosyte/synth/ncpdp`: the NCPDP generation surface, exposed as its own subpath so importing the
  * package root does **not** pull `@cosyte/ncpdp`. This is the **lazy, per-format** boundary: a consumer
  * who only needs NCPDP fixtures imports `@cosyte/synth/ncpdp`; one who needs only the core primitives
  * never loads a parser.
- * `@cosyte/ncpdp` is an **optional peer dependency** — present only for this subpath.
+ * `@cosyte/ncpdp` is an **optional peer dependency**, present only for this subpath.
  *
  * This subpath ships spec-clean generation across both NCPDP standards, each built through
  * `@cosyte/ncpdp`'s own emit surface:
  *
  * - **SCRIPT** ePrescribing (`@cosyte/ncpdp/script`): `generateNewRx` (via the validated `buildNewRx`
  *   builder), `generateRxRenewalRequest`, and `generateRxChangeRequest` (via the parser's public typed
- *   `ScriptMessage` model + `serializeScript`) — each round-tripping through `parseScript` with zero
+ *   `ScriptMessage` model + `serializeScript`), each round-tripping through `parseScript` with zero
  *   warnings, and carrying a prescriber whose NPI is invalid-Luhn and whose **DEA is invalid-checksum**.
  * - **Telecom** claims (`@cosyte/ncpdp/telecom`): `generateB1` (billing), `generateB2` (reversal), and
- *   `generateB3` (rebill) via `buildTelecomRequest` + `serializeTelecom` — each round-tripping through
+ *   `generateB3` (rebill) via `buildTelecomRequest` + `serializeTelecom`, each round-tripping through
  *   `parseTelecom` with zero warnings, with patient / cardholder identity from the synthetic providers.
  *
- * **Deferred:** **quirk mode**. SCRIPT is limited to the transactions `@cosyte/ncpdp` can *build* — NewRx
+ * **Deferred:** **quirk mode**. SCRIPT is limited to the transactions `@cosyte/ncpdp` can *build*: NewRx
  * plus the
  * renewal/change **requests**; the renewal/change *responses* and the reversal cases beyond B2's
  * reference set track the parser's builder surface, never hand-written bytes.
@@ -402,7 +402,7 @@ declare const DAW_CODES: readonly string[];
  * @module
  */
 
-/** Every NCPDP transaction kind {@link ncpdpCorpus} generates — the label used as the corpus `kind`. */
+/** Every NCPDP transaction kind {@link ncpdpCorpus} generates: the label used as the corpus `kind`. */
 type NcpdpCorpusKind = "NewRx" | "RxRenewalRequest" | "RxChangeRequest" | "B1" | "B2" | "B3";
 /** Options for {@link ncpdpCorpus}. */
 interface NcpdpCorpusOptions {
@@ -424,7 +424,7 @@ interface NcpdpCorpusOptions {
  * ```ts
  * import { ncpdpCorpus } from "@cosyte/synth/ncpdp";
  * const corpus = ncpdpCorpus({ seed: 42 });
- * corpus.artifacts.every((a) => a.warnings.length === 0); // true — spec-clean
+ * corpus.artifacts.every((a) => a.warnings.length === 0); // true, spec-clean
  * ```
  */
 declare function ncpdpCorpus(options: NcpdpCorpusOptions): Corpus;

package/dist/ncpdp/index.d.ts

@@ -1,15 +1,15 @@
-import { S as SyntheticName, b as SyntheticAddress, R as Rng, C as Corpus } from '../providers-OLz3zAc-.js';
+import { S as SyntheticName, b as SyntheticAddress, R as Rng, C as Corpus } from '../providers-B9uVinAe.js';
 
 /**
- * Spec-clean NCPDP **SCRIPT** (XML ePrescribing) generation — `NewRx`, `RxRenewalRequest`, and
- * `RxChangeRequest` — built through `@cosyte/ncpdp`'s own emit surface so the XML is spec-clean by the
+ * Spec-clean NCPDP **SCRIPT** (XML ePrescribing) generation: `NewRx`, `RxRenewalRequest`, and
+ * `RxChangeRequest`, built through `@cosyte/ncpdp`'s own emit surface so the XML is spec-clean by the
  * same mechanism that makes the parser's serializer spec-clean:
  *
  * - **NewRx** is built through the validated `buildNewRx` builder (it refuses a NewRx with no
  *   medication description) and serialized by `serializeScript`.
  * - **RxRenewalRequest / RxChangeRequest** have no dedicated builder in `@cosyte/ncpdp` (its builders
- *   cover NewRx + the Status/Error/Verify responses), so — exactly as the X12 generator constructs a
- *   typed model and lets `serializeX12` emit it — these are built as the parser's **public, typed
+ *   cover NewRx + the Status/Error/Verify responses), so, exactly as the X12 generator constructs a
+ *   typed model and lets `serializeX12` emit it, these are built as the parser's **public, typed
  *   `ScriptMessage` model** (the same immutable model `buildNewRx` returns) and serialized by
  *   `serializeScript`. No byte is hand-written; the round-trip harness ({@link ./round-trip.scriptRoundTrip})
  *   re-parses every message through `parseScript` and asserts **zero warnings**, so spec-cleanliness is
@@ -23,7 +23,7 @@ import { S as SyntheticName, b as SyntheticAddress, R as Rng, C as Corpus } from
  */
 /** Options for the SCRIPT generators. */
 interface GenerateScriptOptions {
-    /** The seed (deterministic — same seed yields a byte-identical message). */
+    /** The seed (deterministic: same seed yields a byte-identical message). */
     readonly seed: number;
 }
 /**
@@ -72,8 +72,8 @@ declare function generateRxRenewalRequest(options: GenerateScriptOptions): strin
 declare function generateRxChangeRequest(options: GenerateScriptOptions): string;
 
 /**
- * Spec-clean NCPDP **Telecommunication vD.0** claim generation — `B1` (billing), `B2` (reversal), and
- * `B3` (rebill) — built through `@cosyte/ncpdp`'s `buildTelecomRequest` + `serializeTelecom` so the
+ * Spec-clean NCPDP **Telecommunication vD.0** claim generation: `B1` (billing), `B2` (reversal), and
+ * `B3` (rebill), built through `@cosyte/ncpdp`'s `buildTelecomRequest` + `serializeTelecom` so the
  * fixed Transaction Header, the FS/GS/RS framing, and every field are the parser's own conservative
  * emit. Every field id below is a real 2-character NCPDP field identifier, and every
  * value at a PHI-bearing locus is drawn from the synthetic-safety providers via {@link ./identity}: the
@@ -88,7 +88,7 @@ declare function generateRxChangeRequest(options: GenerateScriptOptions): string
 type TelecomTransactionCode = "B1" | "B2" | "B3";
 /** Options for the Telecom generators. */
 interface GenerateTelecomOptions {
-    /** The seed (deterministic — same seed yields a byte-identical transaction). */
+    /** The seed (deterministic: same seed yields a byte-identical transaction). */
     readonly seed: number;
 }
 /**
@@ -147,9 +147,9 @@ declare function generateB2(options: GenerateTelecomOptions): string;
 declare function generateB3(options: GenerateTelecomOptions): string;
 
 /**
- * The **round-trip-through-the-parser harness** for NCPDP — the headline gate for the synthetic-fixture
+ * The **round-trip-through-the-parser harness** for NCPDP: the headline gate for the synthetic-fixture
  * generator. A generated SCRIPT XML or Telecom claim is "spec-clean" only if
- * `@cosyte/ncpdp` — not `@cosyte/synth`'s own opinion — reads it back cleanly. Each harness parses the
+ * `@cosyte/ncpdp`, not `@cosyte/synth`'s own opinion, reads it back cleanly. Each harness parses the
  * generated wire text straight back through the parser and reports what it found, so a false
  * "spec-clean" claim cannot hide.
  *
@@ -197,41 +197,41 @@ declare function scriptRoundTrip(xml: string): RoundTripResult;
 declare function telecomRoundTrip(wire: string): RoundTripResult;
 
 /**
- * Synthetic identity for NCPDP transactions — every patient, prescriber, pharmacy, and cardholder
+ * Synthetic identity for NCPDP transactions: every patient, prescriber, pharmacy, and cardholder
  * identifier `synth` puts into a SCRIPT ePrescription or a Telecom claim is minted here, and **only**
  * from the synthetic-safety providers. NCPDP is identity-dense in a way the refuter
  * attacks hardest: a NewRx carries the **patient** (name, DOB, gender) *and* the **prescriber** (name,
  * NPI, **DEA**); a Telecom claim adds the **cardholder / member** (name, member id). Every locus below
  * has a construction-level guarantee, not a heuristic:
  *
- * - **NPI** — a deliberately **invalid Luhn** check digit, so it can never be a NPPES-issued NPI
+ * - **NPI**: a deliberately **invalid Luhn** check digit, so it can never be a NPPES-issued NPI
  *   ({@link ../safe/reserved.isSyntheticNpi}).
- * - **DEA** — a deliberately **invalid checksum**, so it can never be a validly-issued DEA registration
+ * - **DEA**: a deliberately **invalid checksum**, so it can never be a validly-issued DEA registration
  *   ({@link ../safe/reserved.isSyntheticDea}). This is the NCPDP-specific identity locus X12 did not have.
- * - **member / cardholder / patient id** — minted under the synthetic assigning authority with an
+ * - **member / cardholder / patient id**: minted under the synthetic assigning authority with an
  *   `MBR` prefix (no reserved range exists; the *namespace* is the guarantee).
- * - **name** — the shipped clearly-fake pool; **DOB** — the seeded generator (no real event implied);
- *   **phone** — the reserved `555-01xx` block; **address** — synthetic street + reserved ZIP.
+ * - **name**: the shipped clearly-fake pool; **DOB**: the seeded generator (no real event implied);
+ *   **phone**: the reserved `555-01xx` block; **address**: synthetic street + reserved ZIP.
  *
  * @module
  */
 
-/** A synthetic patient — every field from `../safe`. */
+/** A synthetic patient: every field from `../safe`. */
 interface NcpdpPatient {
     /** Name from the shipped fake-name pool. */
     readonly person: SyntheticName;
     /** Date of birth `CCYYMMDD` from the seeded generator. */
     readonly dob: string;
-    /** Administrative gender code (`1` = male, `2` = female — NCPDP gender codes). */
+    /** Administrative gender code (`1` = male, `2` = female, NCPDP gender codes). */
     readonly gender: "1" | "2";
-    /** Patient id, synthetic-AA scoped (`MBR`-prefixed — never a bare SSN). */
+    /** Patient id, synthetic-AA scoped (`MBR`-prefixed, never a bare SSN). */
     readonly patientId: string;
     /** Reserved `555-01xx` phone. */
     readonly phone: string;
     /** Synthetic postal address (reserved non-real ZIP). */
     readonly address: SyntheticAddress;
 }
-/** A synthetic prescriber — name + invalid-Luhn NPI + invalid-checksum DEA. */
+/** A synthetic prescriber: name + invalid-Luhn NPI + invalid-checksum DEA. */
 interface NcpdpPrescriber {
     /** A clearly-fake prescriber name. */
     readonly person: SyntheticName;
@@ -240,16 +240,16 @@ interface NcpdpPrescriber {
     /** A DEA number with a deliberately-invalid checksum (never a real DEA registration). */
     readonly dea: string;
 }
-/** A synthetic dispensing pharmacy — business name + invalid-Luhn NPI + synthetic NCPDP id. */
+/** A synthetic dispensing pharmacy: business name + invalid-Luhn NPI + synthetic NCPDP id. */
 interface NcpdpPharmacy {
     /** A clearly-fictional pharmacy business name. */
     readonly businessName: string;
     /** A 10-digit NPI with a deliberately-invalid Luhn check digit. */
     readonly npi: string;
-    /** A 7-digit NCPDP provider id (synthetic — an all-digit id under no real chain). */
+    /** A 7-digit NCPDP provider id (synthetic, an all-digit id under no real chain). */
     readonly ncpdpId: string;
 }
-/** A synthetic cardholder / insurance identity — the covered person on a Telecom claim. */
+/** A synthetic cardholder / insurance identity: the covered person on a Telecom claim. */
 interface NcpdpCardholder {
     /** The cardholder name (may differ from the patient). */
     readonly person: SyntheticName;
@@ -257,7 +257,7 @@ interface NcpdpCardholder {
     readonly cardholderId: string;
     /** Group id, synthetic. */
     readonly groupId: string;
-    /** Person code (`01` = cardholder, `02` = spouse, `03` = child — structural). */
+    /** Person code (`01` = cardholder, `02` = spouse, `03` = child, structural). */
     readonly personCode: string;
 }
 /**
@@ -275,7 +275,7 @@ interface NcpdpCardholder {
  */
 declare function ncpdpPatient(rng: Rng): NcpdpPatient;
 /**
- * Mint a synthetic prescriber — a person name, an invalid-Luhn NPI, and an invalid-checksum DEA (the
+ * Mint a synthetic prescriber: a person name, an invalid-Luhn NPI, and an invalid-checksum DEA (the
  * DEA's second letter is derived from the prescriber's family name so it reads plausibly).
  *
  * @param rng - The seeded generator.
@@ -289,7 +289,7 @@ declare function ncpdpPatient(rng: Rng): NcpdpPatient;
  */
 declare function ncpdpPrescriber(rng: Rng): NcpdpPrescriber;
 /**
- * Mint a synthetic dispensing pharmacy — a fictional business name, an invalid-Luhn NPI, and a 7-digit
+ * Mint a synthetic dispensing pharmacy: a fictional business name, an invalid-Luhn NPI, and a 7-digit
  * synthetic NCPDP provider id.
  *
  * @param rng - The seeded generator.
@@ -315,13 +315,13 @@ declare function ncpdpPharmacy(rng: Rng): NcpdpPharmacy;
  * ```
  */
 declare function ncpdpCardholder(rng: Rng): NcpdpCardholder;
-/** A seeded SCRIPT routing/correlation bundle — message ids + timestamps, all reproducible. */
+/** A seeded SCRIPT routing/correlation bundle: message ids + timestamps, all reproducible. */
 interface NcpdpScriptRouting {
-    /** `<MessageID>` — a synthetic message id. */
+    /** `<MessageID>`: a synthetic message id. */
     readonly messageId: string;
-    /** `<SentTime>` — a seeded ISO-8601 timestamp (never wall-clock). */
+    /** `<SentTime>`, a seeded ISO-8601 timestamp (never wall-clock). */
     readonly sentTime: string;
-    /** `<PrescriberOrderNumber>` — a synthetic order number. */
+    /** `<PrescriberOrderNumber>`, a synthetic order number. */
     readonly prescriberOrderNumber: string;
     /** A `CCYYMMDD` written / service date (seeded, recent window). */
     readonly date: string;
@@ -343,11 +343,11 @@ declare function ncpdpScriptRouting(rng: Rng): NcpdpScriptRouting;
 
 /**
  * License-clean example drug + code pools for synthetic NCPDP generation. NCPDP charges for its
- * standards and is protective of their prose, so — like every other `synth` format — **no NCPDP
+ * standards and is protective of their prose, so, like every other `synth` format, **no NCPDP
  * copyrighted text is bundled**: these are widely-known generic drug descriptions and invented,
  * clearly-example product codes, not lifted from any NCPDP data dictionary.
  *
- * A drug code is **not** PHI — it names a product, never a patient — so realism here carries no
+ * A drug code is **not** PHI: it names a product, never a patient, so realism here carries no
  * synthetic-safety hazard; the pool exists only to give a generated NewRx / claim a plausible,
  * license-clean drug. Patient / prescriber identity comes from the synthetic-safety providers
  * (`../safe`), never from here.
@@ -360,7 +360,7 @@ declare function ncpdpScriptRouting(rng: Rng): NcpdpScriptRouting;
 interface NcpdpExampleDrug {
     /** A widely-known generic drug description (RxNorm-style; public knowledge, not NCPDP prose). */
     readonly description: string;
-    /** An invented 11-digit NDC (`5-4-2`, digits only) — an example product code, never a real NDC. */
+    /** An invented 11-digit NDC (`5-4-2`, digits only), an example product code, never a real NDC. */
     readonly ndc: string;
     /** The dispense quantity unit-of-measure qualifier hint (structural only). */
     readonly form: string;
@@ -371,30 +371,30 @@ interface NcpdpExampleDrug {
  * generics anyone can name without a licensed database.
  */
 declare const EXAMPLE_DRUGS: readonly NcpdpExampleDrug[];
-/** Example free-text SIG directions (public, common-sense dosing text — not NCPDP prose). */
+/** Example free-text SIG directions (public, common-sense dosing text, not NCPDP prose). */
 declare const EXAMPLE_SIG_TEXT: readonly string[];
 /** Dispense-as-written / product-selection codes (single-digit, structural). */
 declare const DAW_CODES: readonly string[];
 
 /**
- * `@cosyte/synth/ncpdp` — the NCPDP generation surface, exposed as its own subpath so importing the
+ * `@cosyte/synth/ncpdp`: the NCPDP generation surface, exposed as its own subpath so importing the
  * package root does **not** pull `@cosyte/ncpdp`. This is the **lazy, per-format** boundary: a consumer
  * who only needs NCPDP fixtures imports `@cosyte/synth/ncpdp`; one who needs only the core primitives
  * never loads a parser.
- * `@cosyte/ncpdp` is an **optional peer dependency** — present only for this subpath.
+ * `@cosyte/ncpdp` is an **optional peer dependency**, present only for this subpath.
  *
  * This subpath ships spec-clean generation across both NCPDP standards, each built through
  * `@cosyte/ncpdp`'s own emit surface:
  *
  * - **SCRIPT** ePrescribing (`@cosyte/ncpdp/script`): `generateNewRx` (via the validated `buildNewRx`
  *   builder), `generateRxRenewalRequest`, and `generateRxChangeRequest` (via the parser's public typed
- *   `ScriptMessage` model + `serializeScript`) — each round-tripping through `parseScript` with zero
+ *   `ScriptMessage` model + `serializeScript`), each round-tripping through `parseScript` with zero
  *   warnings, and carrying a prescriber whose NPI is invalid-Luhn and whose **DEA is invalid-checksum**.
  * - **Telecom** claims (`@cosyte/ncpdp/telecom`): `generateB1` (billing), `generateB2` (reversal), and
- *   `generateB3` (rebill) via `buildTelecomRequest` + `serializeTelecom` — each round-tripping through
+ *   `generateB3` (rebill) via `buildTelecomRequest` + `serializeTelecom`, each round-tripping through
  *   `parseTelecom` with zero warnings, with patient / cardholder identity from the synthetic providers.
  *
- * **Deferred:** **quirk mode**. SCRIPT is limited to the transactions `@cosyte/ncpdp` can *build* — NewRx
+ * **Deferred:** **quirk mode**. SCRIPT is limited to the transactions `@cosyte/ncpdp` can *build*: NewRx
  * plus the
  * renewal/change **requests**; the renewal/change *responses* and the reversal cases beyond B2's
  * reference set track the parser's builder surface, never hand-written bytes.
@@ -402,7 +402,7 @@ declare const DAW_CODES: readonly string[];
  * @module
  */
 
-/** Every NCPDP transaction kind {@link ncpdpCorpus} generates — the label used as the corpus `kind`. */
+/** Every NCPDP transaction kind {@link ncpdpCorpus} generates: the label used as the corpus `kind`. */
 type NcpdpCorpusKind = "NewRx" | "RxRenewalRequest" | "RxChangeRequest" | "B1" | "B2" | "B3";
 /** Options for {@link ncpdpCorpus}. */
 interface NcpdpCorpusOptions {
@@ -424,7 +424,7 @@ interface NcpdpCorpusOptions {
  * ```ts
  * import { ncpdpCorpus } from "@cosyte/synth/ncpdp";
  * const corpus = ncpdpCorpus({ seed: 42 });
- * corpus.artifacts.every((a) => a.warnings.length === 0); // true — spec-clean
+ * corpus.artifacts.every((a) => a.warnings.length === 0); // true, spec-clean
  * ```
  */
 declare function ncpdpCorpus(options: NcpdpCorpusOptions): Corpus;

package/dist/ncpdp/index.mjs

@@ -35,11 +35,11 @@ function sfc32Next(s) {
 var SYNTH_FATAL_CODES = {
   /** 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. */
+  /** A value was drawn from an empty pool. Fatal, never a fabricated substitute. */
   SYNTH_EMPTY_POOL: "SYNTH_EMPTY_POOL",
   /**
    * 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 —
+   * 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.
    */
@@ -133,7 +133,7 @@ function makeCorpus(seed, artifacts, quirks = []) {
 var SYNTHETIC_ASSIGNING_AUTHORITY = Object.freeze({
   /** The human-readable assigning-authority namespace id (HL7 HD.1). */
   namespaceId: "COSYTE-SYNTH",
-  /** The universal id — an OID under HL7's example arc `2.16.840.1.113883.19` (HD.2). */
+  /** The universal id, an OID under HL7's example arc `2.16.840.1.113883.19` (HD.2). */
   universalId: "2.16.840.1.113883.19.999",
   /** The universal id type (HD.3). */
   universalIdType: "ISO"