@cosyte/synth 0.0.7 → 0.0.8

package/dist/x12/index.d.cts

@@ -1,9 +1,9 @@
-import { b as SyntheticAddress, S as SyntheticName, R as Rng, C as Corpus } from '../providers-OLz3zAc-.cjs';
+import { b as SyntheticAddress, S as SyntheticName, R as Rng, C as Corpus } from '../providers-B9uVinAe.cjs';
 import { X12Interchange, X12Decimal } from '@cosyte/x12';
 
 /**
- * Spec-clean HIPAA 005010 **837** claim generation — Professional (`build837P`, TR3 005010X222A2),
- * Institutional (`build837I`, X223A3), and Dental (`build837D`, X224A2) — built through
+ * Spec-clean HIPAA 005010 **837** claim generation: Professional (`build837P`, TR3 005010X222A2),
+ * Institutional (`build837I`, X223A3), and Dental (`build837D`, X224A2), built through
  * `@cosyte/x12`'s domain builders so the ISA/GS/ST…SE/GE/IEA envelope, the computed HL spine, and
  * every segment are the parser's own conservative emit. Every subscriber, patient,
  * provider, and payer identifier is drawn from the synthetic-safety providers via {@link ./identity};
@@ -16,7 +16,7 @@ import { X12Interchange, X12Decimal } from '@cosyte/x12';
 type Claim837Variant = "P" | "I" | "D";
 /** Options for {@link generate837}. */
 interface Generate837Options {
-    /** The seed (deterministic — same seed yields a byte-identical interchange). */
+    /** The seed (deterministic: same seed yields a byte-identical interchange). */
     readonly seed: number;
 }
 /**
@@ -76,8 +76,8 @@ declare function generate837D(options: Generate837Options): X12Interchange;
  * Spec-clean HIPAA 005010X221A1 **835** Health Care Claim Payment/Advice (ERA) generation, built
  * through `@cosyte/x12`'s `build835`. The 835 is **balance-checked by construction**:
  * `build835` REFUSES an out-of-balance remit, so `synth` computes amounts that satisfy the three X12
- * balance identities — line (`charge = payment + Σ CAS`), claim (`totalCharge = totalPayment +
- * patientResponsibility`), and remit (`BPR-02 = Σ CLP-04 − Σ PLB`) — before handing them to the
+ * balance identities, line (`charge = payment + Σ CAS`), claim (`totalCharge = totalPayment +
+ * patientResponsibility`), and remit (`BPR-02 = Σ CLP-04 − Σ PLB`), before handing them to the
  * builder. Patient, payer, and payee identity is drawn from the synthetic-safety providers
  * ({@link ./identity}); every generated 835 round-trips through `@cosyte/x12` with zero warnings.
  *
@@ -86,7 +86,7 @@ declare function generate837D(options: Generate837Options): X12Interchange;
 
 /** Options for {@link generate835}. */
 interface Generate835Options {
-    /** The seed (deterministic — same seed yields a byte-identical interchange). */
+    /** The seed (deterministic: same seed yields a byte-identical interchange). */
     readonly seed: number;
 }
 /**
@@ -114,7 +114,7 @@ declare function generate835(options: Generate835Options): X12Interchange;
  * round-trips through `@cosyte/x12` with zero warnings.
  *
  * **Note (coverage tracks the builder):** `@cosyte/x12` ships a **271** builder but no
- * **270** (request) builder — the 270 is only *read* (as the echoed trace on the 271). Per the
+ * **270** (request) builder, the 270 is only *read* (as the echoed trace on the 271). Per the
  * through-the-builder discipline (never hand-write bytes around a missing builder), `synth` generates
  * the 271 and **defers 270** until `@cosyte/x12` grows a `build270` (noted in the README + CHANGELOG).
  *
@@ -123,7 +123,7 @@ declare function generate835(options: Generate835Options): X12Interchange;
 
 /** Options for {@link generate271}. */
 interface Generate271Options {
-    /** The seed (deterministic — same seed yields a byte-identical interchange). */
+    /** The seed (deterministic: same seed yields a byte-identical interchange). */
     readonly seed: number;
 }
 /**
@@ -144,9 +144,9 @@ interface Generate271Options {
 declare function generate271(options: Generate271Options): X12Interchange;
 
 /**
- * The **round-trip-through-the-parser harness** for X12 — the headline gate for the synthetic-fixture
- * generator. A generated interchange is "spec-clean" only if `@cosyte/x12` — not
- * `@cosyte/synth`'s own opinion — reads it back cleanly. This harness serializes a built interchange,
+ * The **round-trip-through-the-parser harness** for X12: the headline gate for the synthetic-fixture
+ * generator. A generated interchange is "spec-clean" only if `@cosyte/x12`, not
+ * `@cosyte/synth`'s own opinion, reads it back cleanly. This harness serializes a built interchange,
  * parses it straight back through `parseX12`, and reports what the parser found, so a false
  * "spec-clean" claim cannot hide.
  *
@@ -188,14 +188,14 @@ declare function roundTrip(interchange: X12Interchange): RoundTripResult;
 /**
  * Shared money helpers for the X12 generators. X12 amounts are {@link "@cosyte/x12".X12Decimal}, never
  * a float (float arithmetic destroys cents), so every generated charge / payment / adjustment is
- * constructed through {@link dec} — a single, tested conversion point rather than a per-generator
+ * constructed through {@link dec}: a single, tested conversion point rather than a per-generator
  * duplicate.
  *
  * @module
  */
 
 /**
- * A non-null `X12Decimal` from a decimal string. Throws on an unparseable string — the generators only
+ * A non-null `X12Decimal` from a decimal string. Throws on an unparseable string: the generators only
  * ever pass literals or `${n}.00` strings, so the throw is a defensive guard, never a runtime path.
  *
  * @param value - A decimal string, e.g. `"150.00"`.
@@ -223,27 +223,27 @@ declare function dec(value: string): X12Decimal;
 declare function money(n: number): string;
 
 /**
- * Synthetic identity for X12 healthcare transactions — every subscriber, patient, provider, and payer
+ * Synthetic identity for X12 healthcare transactions: every subscriber, patient, provider, and payer
  * identifier `synth` puts into an 837 / 835 / 271 is minted here, and **only** from the
  * synthetic-safety providers. X12 is uniquely identity-dense: a claim carries subscriber
- * *and* patient names, member ids, provider NPIs, a provider tax id, dates of birth, and addresses —
+ * *and* patient names, member ids, provider NPIs, a provider tax id, dates of birth, and addresses,
  * across two HL loops. The synthetic-by-construction invariant is therefore attacked hardest here, so
  * every locus below has a construction-level guarantee, not a heuristic:
  *
- * - **member id** — minted under the synthetic assigning authority (no reserved range exists; the
+ * - **member id**: minted under the synthetic assigning authority (no reserved range exists; the
  *   *namespace* is the guarantee).
- * - **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}).
- * - **provider tax id** — emitted as an SSN (REF*SY) in the SSA **never-issued** 900-range, so it can
- *   never be a real, issuable SSN (900–999 is never assigned as an SSN — the universal synthetic-safe
+ * - **provider tax id**: emitted as an SSN (REF*SY) in the SSA **never-issued** 900-range, so it can
+ *   never be a real, issuable SSN (900–999 is never assigned as an SSN, the universal synthetic-safe
  *   SSN convention).
- * - **name** — the shipped clearly-fake pool; **DOB / dates** — the seeded generator (no real event
- *   implied); **address** — synthetic street + reserved ZIP.
+ * - **name**: the shipped clearly-fake pool; **DOB / dates**: the seeded generator (no real event
+ *   implied); **address**: synthetic street + reserved ZIP.
  *
  * @module
  */
 
-/** A synthetic person (subscriber / patient / rendering provider) — all fields from `../safe`. */
+/** A synthetic person (subscriber / patient / rendering provider): all fields from `../safe`. */
 interface X12Person {
     /** Name from the shipped fake-name pool. */
     readonly person: SyntheticName;
@@ -256,18 +256,18 @@ interface X12Person {
     /** Synthetic postal address (reserved non-real ZIP). */
     readonly address: SyntheticAddress;
 }
-/** A synthetic billing organization — org name + invalid-Luhn NPI + never-issued-SSN tax id. */
+/** A synthetic billing organization: org name + invalid-Luhn NPI + never-issued-SSN tax id. */
 interface X12Organization {
     /** A clearly-fictional organization name. */
     readonly name: string;
     /** A 10-digit NPI with a deliberately-invalid Luhn check digit (never a real NPI). */
     readonly npi: string;
-    /** The provider tax id as a never-issued (900-range) SSN — emitted at REF*SY. */
+    /** The provider tax id as a never-issued (900-range) SSN, emitted at REF*SY. */
     readonly taxIdSsn: string;
     /** Synthetic postal address. */
     readonly address: SyntheticAddress;
 }
-/** A synthetic payer — name + a synthetic payer id (PI). */
+/** A synthetic payer: name + a synthetic payer id (PI). */
 interface X12Payer {
     /** A clearly-fictional payer name. */
     readonly name: string;
@@ -296,7 +296,7 @@ interface X12TradingPartners {
  */
 declare function x12Person(rng: Rng): X12Person;
 /**
- * Mint a synthetic billing organization — org name, an invalid-Luhn NPI, a never-issued-SSN tax id,
+ * Mint a synthetic billing organization: org name, an invalid-Luhn NPI, a never-issued-SSN tax id,
  * and an address.
  *
  * @param rng - The seeded generator.
@@ -310,7 +310,7 @@ declare function x12Person(rng: Rng): X12Person;
  */
 declare function x12Organization(rng: Rng): X12Organization;
 /**
- * Mint a synthetic rendering/service provider **person** — a person name plus an invalid-Luhn NPI.
+ * Mint a synthetic rendering/service provider **person**: a person name plus an invalid-Luhn NPI.
  *
  * @param rng - The seeded generator.
  * @returns The provider name and NPI.
@@ -326,7 +326,7 @@ declare function x12ProviderPerson(rng: Rng): {
     readonly npi: string;
 };
 /**
- * Mint a synthetic payer — a fictional name and a synthetic payer id.
+ * Mint a synthetic payer: a fictional name and a synthetic payer id.
  *
  * @param rng - The seeded generator.
  * @returns A synthetic {@link X12Payer}.
@@ -385,13 +385,13 @@ declare function x12EnvelopeTiming(rng: Rng): X12EnvelopeTiming;
 
 /**
  * License-clean example code pools for X12 generation. `synth` ships only a tiny curated
- * set of **spec-example codes** — the same codes that appear in the WPC 005010 TR3 implementation-guide
- * examples and the `@cosyte/x12` builder test fixtures — never a bundled CPT/ICD/NDC table. They are
+ * set of **spec-example codes**: the same codes that appear in the WPC 005010 TR3 implementation-guide
+ * examples and the `@cosyte/x12` builder test fixtures, never a bundled CPT/ICD/NDC table. They are
  * used purely to give a generated claim a structurally-valid code element; a consumer who needs a real
  * code set supplies their own (matching `@cosyte/terminology`'s content-free stance).
  *
  * Every code here is a *structural placeholder*: a `synth` claim may pair a diagnosis and a procedure
- * that make no clinical sense, and that is correct — `synth` exercises the *parser*, not clinical
+ * that make no clinical sense, and that is correct, `synth` exercises the *parser*, not clinical
  * coherence.
  *
  * @module
@@ -400,11 +400,11 @@ declare function x12EnvelopeTiming(rng: Rng): X12EnvelopeTiming;
 interface X12ExampleCode {
     /** The code value (the element or composite component). */
     readonly code: string;
-    /** A short human label — documentation only, never emitted. */
+    /** A short human label, documentation only, never emitted. */
     readonly label: string;
 }
 /**
- * HCPCS/CPT professional procedure codes (SV1-01-2, qualifier `HC`) — office-visit / lab E&M codes
+ * HCPCS/CPT professional procedure codes (SV1-01-2, qualifier `HC`): office-visit / lab E&M codes
  * from the 837P TR3 examples. Structural placeholders only.
  */
 declare const PROFESSIONAL_PROCEDURES: readonly X12ExampleCode[];
@@ -413,38 +413,38 @@ declare const PROCEDURE_MODIFIERS: readonly string[];
 /** Place-of-service codes (CLM-05-1 / SV1-05). */
 declare const PLACES_OF_SERVICE: readonly string[];
 /**
- * ICD-10-CM diagnosis codes (HI qualifier `ABK` principal / `ABF` secondary) — codes from the TR3
+ * ICD-10-CM diagnosis codes (HI qualifier `ABK` principal / `ABF` secondary): codes from the TR3
  * examples. Structural placeholders only.
  */
 declare const DIAGNOSES: readonly X12ExampleCode[];
-/** NUBC revenue codes (837I SV2-01) — spec-example codes. */
+/** NUBC revenue codes (837I SV2-01): spec-example codes. */
 declare const REVENUE_CODES: readonly X12ExampleCode[];
 /** Institutional procedure codes paired with revenue lines (837I SV2-02-2, qualifier `HC`). */
 declare const INSTITUTIONAL_PROCEDURES: readonly X12ExampleCode[];
-/** CDT dental procedure codes (837D SV3-01-2, qualifier `AD`) — spec-example codes. */
+/** CDT dental procedure codes (837D SV3-01-2, qualifier `AD`): spec-example codes. */
 declare const DENTAL_PROCEDURES: readonly X12ExampleCode[];
 /** ADA tooth codes (837D TOO-02, qualifier `JP`) + surfaces (TOO-03). */
 declare const TOOTH_CODES: readonly string[];
 /** Tooth surface codes (TOO-03). */
 declare const TOOTH_SURFACES: readonly string[];
 /**
- * Claim adjustment reason codes (CARC — CAS-02) paired with a group code. CARC is a public WPC code
+ * Claim adjustment reason codes (CARC: CAS-02) paired with a group code. CARC is a public WPC code
  * list; these are the handful used in the 835 TR3 examples. Structural placeholders only.
  */
 declare const CARC_CODES: readonly string[];
-/** Service type codes (271 EB-03) — the public X12 code list 1365, spec-example subset. */
+/** Service type codes (271 EB-03): the public X12 code list 1365, spec-example subset. */
 declare const SERVICE_TYPE_CODES: readonly string[];
 
 /**
- * `@cosyte/synth/x12` — the X12 EDI generation surface, exposed as its own subpath so importing the
+ * `@cosyte/synth/x12`: the X12 EDI generation surface, exposed as its own subpath so importing the
  * package root does **not** pull `@cosyte/x12`. This is the **lazy, per-format** boundary: a consumer
  * who only needs X12 fixtures imports `@cosyte/synth/x12`; one who needs only the core primitives
  * never loads a parser.
- * `@cosyte/x12` is an **optional peer dependency** — present only for this subpath.
+ * `@cosyte/x12` is an **optional peer dependency**, present only for this subpath.
  *
  * This subpath ships spec-clean HIPAA 005010 generation via `@cosyte/x12`'s domain
  * builders: **837P/I/D** claims (`generate837P`/`generate837I`/`generate837D`), the **835** remittance
- * (`generate835`), and the **271** eligibility response (`generate271`) — each built through the
+ * (`generate835`), and the **271** eligibility response (`generate271`), each built through the
  * parser's own builder so the ISA/GS/ST…SE/GE/IEA envelope and every segment are spec-clean by
  * construction, each round-tripping through `@cosyte/x12` with zero warnings, and each drawing every
  * subscriber/patient/provider identifier from the synthetic-safety providers.
@@ -455,7 +455,7 @@ declare const SERVICE_TYPE_CODES: readonly string[];
  * @module
  */
 
-/** Every X12 transaction kind {@link x12Corpus} generates — the label used as the corpus `kind`. */
+/** Every X12 transaction kind {@link x12Corpus} generates: the label used as the corpus `kind`. */
 type X12CorpusKind = "837P" | "837I" | "837D" | "835" | "271";
 /** Options for {@link x12Corpus}. */
 interface X12CorpusOptions {
@@ -477,7 +477,7 @@ interface X12CorpusOptions {
  * ```ts
  * import { x12Corpus } from "@cosyte/synth/x12";
  * const corpus = x12Corpus({ 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 x12Corpus(options: X12CorpusOptions): Corpus;

package/dist/x12/index.d.ts

@@ -1,9 +1,9 @@
-import { b as SyntheticAddress, S as SyntheticName, R as Rng, C as Corpus } from '../providers-OLz3zAc-.js';
+import { b as SyntheticAddress, S as SyntheticName, R as Rng, C as Corpus } from '../providers-B9uVinAe.js';
 import { X12Interchange, X12Decimal } from '@cosyte/x12';
 
 /**
- * Spec-clean HIPAA 005010 **837** claim generation — Professional (`build837P`, TR3 005010X222A2),
- * Institutional (`build837I`, X223A3), and Dental (`build837D`, X224A2) — built through
+ * Spec-clean HIPAA 005010 **837** claim generation: Professional (`build837P`, TR3 005010X222A2),
+ * Institutional (`build837I`, X223A3), and Dental (`build837D`, X224A2), built through
  * `@cosyte/x12`'s domain builders so the ISA/GS/ST…SE/GE/IEA envelope, the computed HL spine, and
  * every segment are the parser's own conservative emit. Every subscriber, patient,
  * provider, and payer identifier is drawn from the synthetic-safety providers via {@link ./identity};
@@ -16,7 +16,7 @@ import { X12Interchange, X12Decimal } from '@cosyte/x12';
 type Claim837Variant = "P" | "I" | "D";
 /** Options for {@link generate837}. */
 interface Generate837Options {
-    /** The seed (deterministic — same seed yields a byte-identical interchange). */
+    /** The seed (deterministic: same seed yields a byte-identical interchange). */
     readonly seed: number;
 }
 /**
@@ -76,8 +76,8 @@ declare function generate837D(options: Generate837Options): X12Interchange;
  * Spec-clean HIPAA 005010X221A1 **835** Health Care Claim Payment/Advice (ERA) generation, built
  * through `@cosyte/x12`'s `build835`. The 835 is **balance-checked by construction**:
  * `build835` REFUSES an out-of-balance remit, so `synth` computes amounts that satisfy the three X12
- * balance identities — line (`charge = payment + Σ CAS`), claim (`totalCharge = totalPayment +
- * patientResponsibility`), and remit (`BPR-02 = Σ CLP-04 − Σ PLB`) — before handing them to the
+ * balance identities, line (`charge = payment + Σ CAS`), claim (`totalCharge = totalPayment +
+ * patientResponsibility`), and remit (`BPR-02 = Σ CLP-04 − Σ PLB`), before handing them to the
  * builder. Patient, payer, and payee identity is drawn from the synthetic-safety providers
  * ({@link ./identity}); every generated 835 round-trips through `@cosyte/x12` with zero warnings.
  *
@@ -86,7 +86,7 @@ declare function generate837D(options: Generate837Options): X12Interchange;
 
 /** Options for {@link generate835}. */
 interface Generate835Options {
-    /** The seed (deterministic — same seed yields a byte-identical interchange). */
+    /** The seed (deterministic: same seed yields a byte-identical interchange). */
     readonly seed: number;
 }
 /**
@@ -114,7 +114,7 @@ declare function generate835(options: Generate835Options): X12Interchange;
  * round-trips through `@cosyte/x12` with zero warnings.
  *
  * **Note (coverage tracks the builder):** `@cosyte/x12` ships a **271** builder but no
- * **270** (request) builder — the 270 is only *read* (as the echoed trace on the 271). Per the
+ * **270** (request) builder, the 270 is only *read* (as the echoed trace on the 271). Per the
  * through-the-builder discipline (never hand-write bytes around a missing builder), `synth` generates
  * the 271 and **defers 270** until `@cosyte/x12` grows a `build270` (noted in the README + CHANGELOG).
  *
@@ -123,7 +123,7 @@ declare function generate835(options: Generate835Options): X12Interchange;
 
 /** Options for {@link generate271}. */
 interface Generate271Options {
-    /** The seed (deterministic — same seed yields a byte-identical interchange). */
+    /** The seed (deterministic: same seed yields a byte-identical interchange). */
     readonly seed: number;
 }
 /**
@@ -144,9 +144,9 @@ interface Generate271Options {
 declare function generate271(options: Generate271Options): X12Interchange;
 
 /**
- * The **round-trip-through-the-parser harness** for X12 — the headline gate for the synthetic-fixture
- * generator. A generated interchange is "spec-clean" only if `@cosyte/x12` — not
- * `@cosyte/synth`'s own opinion — reads it back cleanly. This harness serializes a built interchange,
+ * The **round-trip-through-the-parser harness** for X12: the headline gate for the synthetic-fixture
+ * generator. A generated interchange is "spec-clean" only if `@cosyte/x12`, not
+ * `@cosyte/synth`'s own opinion, reads it back cleanly. This harness serializes a built interchange,
  * parses it straight back through `parseX12`, and reports what the parser found, so a false
  * "spec-clean" claim cannot hide.
  *
@@ -188,14 +188,14 @@ declare function roundTrip(interchange: X12Interchange): RoundTripResult;
 /**
  * Shared money helpers for the X12 generators. X12 amounts are {@link "@cosyte/x12".X12Decimal}, never
  * a float (float arithmetic destroys cents), so every generated charge / payment / adjustment is
- * constructed through {@link dec} — a single, tested conversion point rather than a per-generator
+ * constructed through {@link dec}: a single, tested conversion point rather than a per-generator
  * duplicate.
  *
  * @module
  */
 
 /**
- * A non-null `X12Decimal` from a decimal string. Throws on an unparseable string — the generators only
+ * A non-null `X12Decimal` from a decimal string. Throws on an unparseable string: the generators only
  * ever pass literals or `${n}.00` strings, so the throw is a defensive guard, never a runtime path.
  *
  * @param value - A decimal string, e.g. `"150.00"`.
@@ -223,27 +223,27 @@ declare function dec(value: string): X12Decimal;
 declare function money(n: number): string;
 
 /**
- * Synthetic identity for X12 healthcare transactions — every subscriber, patient, provider, and payer
+ * Synthetic identity for X12 healthcare transactions: every subscriber, patient, provider, and payer
  * identifier `synth` puts into an 837 / 835 / 271 is minted here, and **only** from the
  * synthetic-safety providers. X12 is uniquely identity-dense: a claim carries subscriber
- * *and* patient names, member ids, provider NPIs, a provider tax id, dates of birth, and addresses —
+ * *and* patient names, member ids, provider NPIs, a provider tax id, dates of birth, and addresses,
  * across two HL loops. The synthetic-by-construction invariant is therefore attacked hardest here, so
  * every locus below has a construction-level guarantee, not a heuristic:
  *
- * - **member id** — minted under the synthetic assigning authority (no reserved range exists; the
+ * - **member id**: minted under the synthetic assigning authority (no reserved range exists; the
  *   *namespace* is the guarantee).
- * - **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}).
- * - **provider tax id** — emitted as an SSN (REF*SY) in the SSA **never-issued** 900-range, so it can
- *   never be a real, issuable SSN (900–999 is never assigned as an SSN — the universal synthetic-safe
+ * - **provider tax id**: emitted as an SSN (REF*SY) in the SSA **never-issued** 900-range, so it can
+ *   never be a real, issuable SSN (900–999 is never assigned as an SSN, the universal synthetic-safe
  *   SSN convention).
- * - **name** — the shipped clearly-fake pool; **DOB / dates** — the seeded generator (no real event
- *   implied); **address** — synthetic street + reserved ZIP.
+ * - **name**: the shipped clearly-fake pool; **DOB / dates**: the seeded generator (no real event
+ *   implied); **address**: synthetic street + reserved ZIP.
  *
  * @module
  */
 
-/** A synthetic person (subscriber / patient / rendering provider) — all fields from `../safe`. */
+/** A synthetic person (subscriber / patient / rendering provider): all fields from `../safe`. */
 interface X12Person {
     /** Name from the shipped fake-name pool. */
     readonly person: SyntheticName;
@@ -256,18 +256,18 @@ interface X12Person {
     /** Synthetic postal address (reserved non-real ZIP). */
     readonly address: SyntheticAddress;
 }
-/** A synthetic billing organization — org name + invalid-Luhn NPI + never-issued-SSN tax id. */
+/** A synthetic billing organization: org name + invalid-Luhn NPI + never-issued-SSN tax id. */
 interface X12Organization {
     /** A clearly-fictional organization name. */
     readonly name: string;
     /** A 10-digit NPI with a deliberately-invalid Luhn check digit (never a real NPI). */
     readonly npi: string;
-    /** The provider tax id as a never-issued (900-range) SSN — emitted at REF*SY. */
+    /** The provider tax id as a never-issued (900-range) SSN, emitted at REF*SY. */
     readonly taxIdSsn: string;
     /** Synthetic postal address. */
     readonly address: SyntheticAddress;
 }
-/** A synthetic payer — name + a synthetic payer id (PI). */
+/** A synthetic payer: name + a synthetic payer id (PI). */
 interface X12Payer {
     /** A clearly-fictional payer name. */
     readonly name: string;
@@ -296,7 +296,7 @@ interface X12TradingPartners {
  */
 declare function x12Person(rng: Rng): X12Person;
 /**
- * Mint a synthetic billing organization — org name, an invalid-Luhn NPI, a never-issued-SSN tax id,
+ * Mint a synthetic billing organization: org name, an invalid-Luhn NPI, a never-issued-SSN tax id,
  * and an address.
  *
  * @param rng - The seeded generator.
@@ -310,7 +310,7 @@ declare function x12Person(rng: Rng): X12Person;
  */
 declare function x12Organization(rng: Rng): X12Organization;
 /**
- * Mint a synthetic rendering/service provider **person** — a person name plus an invalid-Luhn NPI.
+ * Mint a synthetic rendering/service provider **person**: a person name plus an invalid-Luhn NPI.
  *
  * @param rng - The seeded generator.
  * @returns The provider name and NPI.
@@ -326,7 +326,7 @@ declare function x12ProviderPerson(rng: Rng): {
     readonly npi: string;
 };
 /**
- * Mint a synthetic payer — a fictional name and a synthetic payer id.
+ * Mint a synthetic payer: a fictional name and a synthetic payer id.
  *
  * @param rng - The seeded generator.
  * @returns A synthetic {@link X12Payer}.
@@ -385,13 +385,13 @@ declare function x12EnvelopeTiming(rng: Rng): X12EnvelopeTiming;
 
 /**
  * License-clean example code pools for X12 generation. `synth` ships only a tiny curated
- * set of **spec-example codes** — the same codes that appear in the WPC 005010 TR3 implementation-guide
- * examples and the `@cosyte/x12` builder test fixtures — never a bundled CPT/ICD/NDC table. They are
+ * set of **spec-example codes**: the same codes that appear in the WPC 005010 TR3 implementation-guide
+ * examples and the `@cosyte/x12` builder test fixtures, never a bundled CPT/ICD/NDC table. They are
  * used purely to give a generated claim a structurally-valid code element; a consumer who needs a real
  * code set supplies their own (matching `@cosyte/terminology`'s content-free stance).
  *
  * Every code here is a *structural placeholder*: a `synth` claim may pair a diagnosis and a procedure
- * that make no clinical sense, and that is correct — `synth` exercises the *parser*, not clinical
+ * that make no clinical sense, and that is correct, `synth` exercises the *parser*, not clinical
  * coherence.
  *
  * @module
@@ -400,11 +400,11 @@ declare function x12EnvelopeTiming(rng: Rng): X12EnvelopeTiming;
 interface X12ExampleCode {
     /** The code value (the element or composite component). */
     readonly code: string;
-    /** A short human label — documentation only, never emitted. */
+    /** A short human label, documentation only, never emitted. */
     readonly label: string;
 }
 /**
- * HCPCS/CPT professional procedure codes (SV1-01-2, qualifier `HC`) — office-visit / lab E&M codes
+ * HCPCS/CPT professional procedure codes (SV1-01-2, qualifier `HC`): office-visit / lab E&M codes
  * from the 837P TR3 examples. Structural placeholders only.
  */
 declare const PROFESSIONAL_PROCEDURES: readonly X12ExampleCode[];
@@ -413,38 +413,38 @@ declare const PROCEDURE_MODIFIERS: readonly string[];
 /** Place-of-service codes (CLM-05-1 / SV1-05). */
 declare const PLACES_OF_SERVICE: readonly string[];
 /**
- * ICD-10-CM diagnosis codes (HI qualifier `ABK` principal / `ABF` secondary) — codes from the TR3
+ * ICD-10-CM diagnosis codes (HI qualifier `ABK` principal / `ABF` secondary): codes from the TR3
  * examples. Structural placeholders only.
  */
 declare const DIAGNOSES: readonly X12ExampleCode[];
-/** NUBC revenue codes (837I SV2-01) — spec-example codes. */
+/** NUBC revenue codes (837I SV2-01): spec-example codes. */
 declare const REVENUE_CODES: readonly X12ExampleCode[];
 /** Institutional procedure codes paired with revenue lines (837I SV2-02-2, qualifier `HC`). */
 declare const INSTITUTIONAL_PROCEDURES: readonly X12ExampleCode[];
-/** CDT dental procedure codes (837D SV3-01-2, qualifier `AD`) — spec-example codes. */
+/** CDT dental procedure codes (837D SV3-01-2, qualifier `AD`): spec-example codes. */
 declare const DENTAL_PROCEDURES: readonly X12ExampleCode[];
 /** ADA tooth codes (837D TOO-02, qualifier `JP`) + surfaces (TOO-03). */
 declare const TOOTH_CODES: readonly string[];
 /** Tooth surface codes (TOO-03). */
 declare const TOOTH_SURFACES: readonly string[];
 /**
- * Claim adjustment reason codes (CARC — CAS-02) paired with a group code. CARC is a public WPC code
+ * Claim adjustment reason codes (CARC: CAS-02) paired with a group code. CARC is a public WPC code
  * list; these are the handful used in the 835 TR3 examples. Structural placeholders only.
  */
 declare const CARC_CODES: readonly string[];
-/** Service type codes (271 EB-03) — the public X12 code list 1365, spec-example subset. */
+/** Service type codes (271 EB-03): the public X12 code list 1365, spec-example subset. */
 declare const SERVICE_TYPE_CODES: readonly string[];
 
 /**
- * `@cosyte/synth/x12` — the X12 EDI generation surface, exposed as its own subpath so importing the
+ * `@cosyte/synth/x12`: the X12 EDI generation surface, exposed as its own subpath so importing the
  * package root does **not** pull `@cosyte/x12`. This is the **lazy, per-format** boundary: a consumer
  * who only needs X12 fixtures imports `@cosyte/synth/x12`; one who needs only the core primitives
  * never loads a parser.
- * `@cosyte/x12` is an **optional peer dependency** — present only for this subpath.
+ * `@cosyte/x12` is an **optional peer dependency**, present only for this subpath.
  *
  * This subpath ships spec-clean HIPAA 005010 generation via `@cosyte/x12`'s domain
  * builders: **837P/I/D** claims (`generate837P`/`generate837I`/`generate837D`), the **835** remittance
- * (`generate835`), and the **271** eligibility response (`generate271`) — each built through the
+ * (`generate835`), and the **271** eligibility response (`generate271`), each built through the
  * parser's own builder so the ISA/GS/ST…SE/GE/IEA envelope and every segment are spec-clean by
  * construction, each round-tripping through `@cosyte/x12` with zero warnings, and each drawing every
  * subscriber/patient/provider identifier from the synthetic-safety providers.
@@ -455,7 +455,7 @@ declare const SERVICE_TYPE_CODES: readonly string[];
  * @module
  */
 
-/** Every X12 transaction kind {@link x12Corpus} generates — the label used as the corpus `kind`. */
+/** Every X12 transaction kind {@link x12Corpus} generates: the label used as the corpus `kind`. */
 type X12CorpusKind = "837P" | "837I" | "837D" | "835" | "271";
 /** Options for {@link x12Corpus}. */
 interface X12CorpusOptions {
@@ -477,7 +477,7 @@ interface X12CorpusOptions {
  * ```ts
  * import { x12Corpus } from "@cosyte/synth/x12";
  * const corpus = x12Corpus({ 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 x12Corpus(options: X12CorpusOptions): Corpus;

package/dist/x12/index.mjs

@@ -31,15 +31,15 @@ function sfc32Next(s) {
 
 // src/codes.ts
 var SYNTH_FATAL_CODES = {
-  /** A money value could not be read as an X12 decimal. Fatal — a generator never rounds to a float. */
+  /** 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. */
+  /** 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.
    */
@@ -141,7 +141,7 @@ function money(n) {
 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"
@@ -651,7 +651,7 @@ function specOf(rng, variant) {
     claims: [
       {
         ...claim,
-        // Rendering provider (Loop 2310B, NM1 fields round-trip) — a person with an invalid-Luhn NPI.
+        // Rendering provider (Loop 2310B, NM1 fields round-trip), a person with an invalid-Luhn NPI.
         providers: [
           {
             entityIdentifierCode: "82",
@@ -678,7 +678,7 @@ function specOf(rng, variant) {
         state: org.address.state,
         postalCode: org.address.zip
       },
-      // Provider tax id as a never-issued (900-range) SSN at REF*SY — provably synthetic (roadmap §4.1).
+      // Provider tax id as a never-issued (900-range) SSN at REF*SY, provably synthetic (roadmap §4.1).
       references: [{ qualifier: "SY", value: org.taxIdSsn }]
     },
     subscribers: [subscriber]