@cosyte/synth 0.0.6 → 0.0.8

package/dist/ccda/index.d.cts

@@ -1,15 +1,15 @@
-import { S as SyntheticName, a as SyntheticIdentifier, R as Rng, C as Corpus } from '../providers-OLz3zAc-.cjs';
+import { S as SyntheticName, a as SyntheticIdentifier, R as Rng, C as Corpus } from '../providers-B9uVinAe.cjs';
 import { CcdaDocument, BuildCcdaPatient, BuildCode, BuildQuantity } from '@cosyte/ccda';
-import { C as CodeConcept, Q as QuantConcept } from '../example-codes-DeXcnCSK.cjs';
-import { Q as QuirkDescriptor, S as SynthProfile, a as QuirkArtifact, b as QuirkRoundTripResult } from '../quirk-DYMDojVw.cjs';
+import { C as CodeConcept, Q as QuantConcept } from '../example-codes-88f3_bQZ.cjs';
+import { Q as QuirkDescriptor, S as SynthProfile, a as QuirkArtifact, b as QuirkRoundTripResult } from '../quirk-IaHp4z7N.cjs';
 
 /**
- * Synthetic **C-CDA document generation** — a spec-clean Continuity of Care Document
+ * Synthetic **C-CDA document generation**: a spec-clean Continuity of Care Document
  * (CCD) or Referral Note built **through `@cosyte/ccda`'s `buildCcda`**, so template IDs, LOINC section
  * codes, and structured/narrative agreement are the builder's own (spec-clean *by construction*), and
  * every `recordTarget` / clinical identifier is drawn from the synthetic-safety providers.
  *
- * The document round-trips through `parseCcda` with **zero warnings** — the builder's round-trip-by-
+ * The document round-trips through `parseCcda` with **zero warnings**: the builder's round-trip-by-
  * construction guarantee, re-verified independently by {@link ./round-trip.roundTrip}. Coverage tracks
  * `buildCcda`'s section/doc-type maturity: the CCD SHALL sections (Problems,
  * Allergies, Medications, Results, Vital Signs) plus Immunizations, Procedures, and Social History
@@ -19,11 +19,11 @@ import { Q as QuirkDescriptor, S as SynthProfile, a as QuirkArtifact, b as Quirk
  * @module
  */
 
-/** The C-CDA document type a generator emits — the two `buildCcda` supports. */
+/** The C-CDA document type a generator emits: the two `buildCcda` supports. */
 type CcdaDocumentType = "ccd" | "referralNote";
 /** Options common to every C-CDA generator. */
 interface GenerateCcdaOptions {
-    /** The seed (deterministic — same seed yields a byte-identical document). Defaults to `0`. */
+    /** The seed (deterministic: same seed yields a byte-identical document). Defaults to `0`. */
     readonly seed?: number;
     /** The document type to emit. Defaults to `"ccd"`. */
     readonly documentType?: CcdaDocumentType;
@@ -56,7 +56,7 @@ declare function generateCcda(options?: GenerateCcdaOptions): CcdaDocument;
  */
 declare function generateCcd(options?: Omit<GenerateCcdaOptions, "documentType">): CcdaDocument;
 /**
- * Generate a spec-clean synthetic **Referral Note** — the second document type `buildCcda` supports,
+ * Generate a spec-clean synthetic **Referral Note**: the second document type `buildCcda` supports,
  * with its own US Realm Header specialization and Reason-for-Referral / Assessment narrative sections.
  *
  * @param options - Seed (deterministic). See {@link GenerateCcdaOptions}.
@@ -70,14 +70,14 @@ declare function generateCcd(options?: Omit<GenerateCcdaOptions, "documentType">
 declare function generateReferralNote(options?: Omit<GenerateCcdaOptions, "documentType">): CcdaDocument;
 
 /**
- * The **round-trip-through-the-parser harness** for C-CDA — the headline gate for the synthetic-fixture
- * generator. A generated document is "spec-clean" only if `@cosyte/ccda` — not
- * `@cosyte/synth`'s own opinion — reads it back cleanly. This harness serializes a generated document,
+ * The **round-trip-through-the-parser harness** for C-CDA: the headline gate for the synthetic-fixture
+ * generator. A generated document is "spec-clean" only if `@cosyte/ccda`, not
+ * `@cosyte/synth`'s own opinion, reads it back cleanly. This harness serializes a generated document,
  * parses it straight back through `parseCcda`, and reports what the parser found, so a false
  * "spec-clean" claim cannot hide.
  *
  * `@cosyte/ccda`'s `buildCcda` is round-trip-by-construction (it emits through the same DOM the parser
- * reads), so a clean build carries zero warnings — but this harness re-verifies that *independently*,
+ * reads), so a clean build carries zero warnings, but this harness re-verifies that *independently*,
  * against the parser, because the parser is the judge.
  *
  * @module
@@ -110,19 +110,19 @@ interface RoundTripResult {
 declare function roundTrip(doc: CcdaDocument): RoundTripResult;
 
 /**
- * Synthetic C-CDA patient identity — the `recordTarget` demographics for a generated document, every
+ * Synthetic C-CDA patient identity: the `recordTarget` demographics for a generated document, every
  * field minted from the synthetic-safety providers in `../safe`. No value a generated
  * C-CDA carries at a PHI locus can be real or plausibly-real: the name is from the shipped fake-name
  * pool, the MRN lives under the synthetic assigning-authority OID (never a real facility namespace),
  * and the birth date comes from the seeded generator (never wall-clock).
  *
- * The draw order is **fixed** (name → MRN → DOB → gender) so the same seed yields the same identity —
+ * The draw order is **fixed** (name → MRN → DOB → gender) so the same seed yields the same identity,
  * the reproducibility contract.
  *
  * @module
  */
 
-/** A synthetic C-CDA patient identity — the values threaded into a document's `recordTarget`. */
+/** A synthetic C-CDA patient identity: the values threaded into a document's `recordTarget`. */
 interface CcdaPatientIdentity {
     /** The `BuildCcdaPatient` `@cosyte/ccda` consumes for the single `recordTarget`. */
     readonly patient: BuildCcdaPatient;
@@ -133,7 +133,7 @@ interface CcdaPatientIdentity {
 }
 /**
  * Mint a complete synthetic {@link CcdaPatientIdentity}. Every value comes from a synthetic-safety
- * provider — no code path here can return a real identifier. The MRN is scoped to the
+ * provider, no code path here can return a real identifier. The MRN is scoped to the
  * synthetic assigning-authority OID (`mrnRoot`), so it is non-colliding by *namespace*, not by value.
  *
  * @param rng - The seeded generator.
@@ -148,12 +148,12 @@ interface CcdaPatientIdentity {
 declare function ccdaPatientIdentity(rng: Rng): CcdaPatientIdentity;
 
 /**
- * The C-CDA example-code pool — a thin adapter that **reuses** the same license-clean, public
+ * The C-CDA example-code pool: a thin adapter that **reuses** the same license-clean, public
  * code facts the FHIR generators ship (`../fhir/example-codes.ts`), reshaped into `@cosyte/ccda`'s
  * `BuildCode` tuple (an OID `codeSystem` instead of a FHIR `system` URI). Reusing one source of truth
  * keeps the LOINC / RxNorm / SNOMED / CVX pools consistent across the FHIR and C-CDA surfaces;
  * `@cosyte/synth` still bundles
- * **no** terminology content — these are public spec-example codes, not copyrighted tables.
+ * **no** terminology content: these are public spec-example codes, not copyrighted tables.
  *
  * Nothing here is PHI: codes and their display text are not patient identifiers. The synthetic-safety
  * invariant governs identity fields (name / DOB / MRN / telecom), which come from `../safe`.
@@ -178,7 +178,7 @@ declare function ccdaPatientIdentity(rng: Rng): CcdaPatientIdentity;
  */
 declare function toBuildCode(concept: CodeConcept): BuildCode;
 /**
- * Draw a synthetic-but-structurally-sane {@link BuildQuantity} for a quantitative concept — a value in
+ * Draw a synthetic-but-structurally-sane {@link BuildQuantity} for a quantitative concept: a value in
  * the concept's plausible band (from the seeded generator, so reproducible) rendered to the concept's
  * decimal precision, with its UCUM unit. The value implies **no** real measurement.
  *
@@ -225,7 +225,7 @@ declare const ROUTES: readonly BuildCode[];
 /**
  * C-CDA **vendor-quirk generation**. A quirk deviates the
  * *structure* of an otherwise spec-clean document (built through `@cosyte/ccda`'s `buildCcda`) so it
- * round-trips through `parseCcda` to **exactly** one intended, stable warning code — the tolerance a
+ * round-trips through `parseCcda` to **exactly** one intended, stable warning code: the tolerance a
  * `defineCcdaProfile` profile encodes. With the matching built-in profile active, that warning is
  * **re-badged** to the value-free `PROFILE_QUIRK_APPLIED` marker (`expected: true`, `toleratedCode` = the
  * original), exactly as the parser's `profileQuirkApplied` does.
@@ -234,14 +234,14 @@ declare const ROUTES: readonly BuildCode[];
  * publicly grounded and re-badged by a built-in public profile:
  *
  * - **`template-extension-absent`** → `TEMPLATE_EXTENSION_ABSENT` (profile `legacyR11`). The R2.1
- *   `@extension="2015-08-01"` version stamp is dropped from the document-type templateId — a legacy
+ *   `@extension="2015-08-01"` version stamp is dropped from the document-type templateId: a legacy
  *   R1.1-era document shape.
  * - **`deprecated-loinc`** → `DEPRECATED_LOINC` (profile `smartScorecard`). A result/vital observation
  *   LOINC code is swapped to a known-deprecated LOINC (`41909-3`).
  * - **`deprecated-code-system`** → `DEPRECATED_CODE_SYSTEM` (profile `smartScorecard`). A problem
  *   observation's value is swapped to a deprecated code system (ICD-9-CM `2.16.840.1.113883.6.103`).
  *
- * A quirk **never** introduces a real-looking value — it changes a template stamp or a code, never a PHI
+ * A quirk **never** introduces a real-looking value: it changes a template stamp or a code, never a PHI
  * locus, so the synthetic-safety gate still runs and stays zero.
  *
  * @module
@@ -249,11 +249,11 @@ declare const ROUTES: readonly BuildCode[];
 
 /** Every C-CDA quirk this package ships. */
 type CcdaQuirkName = "template-extension-absent" | "deprecated-loinc" | "deprecated-code-system";
-/** The C-CDA quirk registry — each recipe bound to the exact `@cosyte/ccda` warning code it targets. */
+/** The C-CDA quirk registry: each recipe bound to the exact `@cosyte/ccda` warning code it targets. */
 declare const CCDA_QUIRKS: Readonly<Record<CcdaQuirkName, QuirkDescriptor>>;
 /**
  * Apply a C-CDA quirk transform to a spec-clean document, or **fail closed**. Refuses to return a
- * document that does not carry the intended deviation (a quirk whose structural anchor is absent) —
+ * document that does not carry the intended deviation (a quirk whose structural anchor is absent):
  * a fixture that silently lost its quirk would test the wrong thing.
  *
  * @param quirk - The quirk to inject.
@@ -270,7 +270,7 @@ declare const CCDA_QUIRKS: Readonly<Record<CcdaQuirkName, QuirkDescriptor>>;
 declare function injectCcdaQuirk(quirk: CcdaQuirkName, cleanXml: string): string;
 /** Options for {@link generateCcdaQuirk}. */
 interface GenerateCcdaQuirkOptions {
-    /** The seed — the same seed + quirk yields a byte-identical document. Defaults to `0`. */
+    /** The seed: the same seed + quirk yields a byte-identical document. Defaults to `0`. */
     readonly seed?: number;
     /** The quirk to inject. Required. */
     readonly quirk: CcdaQuirkName;
@@ -283,14 +283,14 @@ interface GenerateCcdaQuirkOptions {
  * `quirk` + `documentType`.
  *
  * @param options - Seed, quirk, and base document type. See {@link GenerateCcdaQuirkOptions}.
- * @returns The {@link QuirkArtifact} — its `content` round-trips to `intendedWarnings` exactly.
+ * @returns The {@link QuirkArtifact}: its `content` round-trips to `intendedWarnings` exactly.
  * @throws SynthError `SYNTH_UNSUPPORTED_QUIRK` if `quirk` is not a supported C-CDA quirk.
  * @throws Error if the base document does not contain the structural anchor the quirk targets.
  * @example
  * ```ts
  * import { generateCcdaQuirk, ccdaQuirkRoundTrip } from "@cosyte/synth/ccda";
  * const rt = ccdaQuirkRoundTrip(generateCcdaQuirk({ seed: 1, quirk: "deprecated-loinc" }));
- * rt.withProfile?.tolerated; // true — `smartScorecard` re-badges DEPRECATED_LOINC
+ * rt.withProfile?.tolerated; // true, `smartScorecard` re-badges DEPRECATED_LOINC
  * ```
  */
 declare function generateCcdaQuirk(options: GenerateCcdaQuirkOptions): QuirkArtifact;
@@ -338,11 +338,11 @@ declare function ccdaQuirkCorpus(options: CcdaQuirkCorpusOptions): Corpus;
 declare const ccdaQuirkProfile: SynthProfile;
 
 /**
- * `@cosyte/synth/ccda` — the C-CDA generation surface, exposed as its own subpath so importing the
+ * `@cosyte/synth/ccda`: the C-CDA generation surface, exposed as its own subpath so importing the
  * package root does **not** pull `@cosyte/ccda`. This is the **lazy, per-format** boundary: a consumer
  * who only needs C-CDA fixtures imports `@cosyte/synth/ccda`; one who needs only the core primitives
  * never loads a parser.
- * `@cosyte/ccda` is an **optional peer dependency** — present only for this subpath.
+ * `@cosyte/ccda` is an **optional peer dependency**, present only for this subpath.
  *
  * This subpath ships spec-clean C-CDA document generation via `@cosyte/ccda`'s
  * `buildCcda`: a **CCD** (`generateCcd`) and a **Referral Note** (`generateReferralNote`), each built
@@ -352,7 +352,7 @@ declare const ccdaQuirkProfile: SynthProfile;
  * @module
  */
 
-/** Every C-CDA document kind {@link ccdaCorpus} generates — the `documentType` used as the corpus `kind`. */
+/** Every C-CDA document kind {@link ccdaCorpus} generates: the `documentType` used as the corpus `kind`. */
 type CcdaCorpusKind = CcdaDocumentType;
 /** Options for {@link ccdaCorpus}. */
 interface CcdaCorpusOptions {
@@ -374,7 +374,7 @@ interface CcdaCorpusOptions {
  * ```ts
  * import { ccdaCorpus } from "@cosyte/synth/ccda";
  * const corpus = ccdaCorpus({ seed: 42, count: 4 });
- * corpus.artifacts.every((a) => a.warnings.length === 0); // true — spec-clean
+ * corpus.artifacts.every((a) => a.warnings.length === 0); // true, spec-clean
  * ```
  */
 declare function ccdaCorpus(options: CcdaCorpusOptions): Corpus;

package/dist/ccda/index.d.ts

@@ -1,15 +1,15 @@
-import { S as SyntheticName, a as SyntheticIdentifier, R as Rng, C as Corpus } from '../providers-OLz3zAc-.js';
+import { S as SyntheticName, a as SyntheticIdentifier, R as Rng, C as Corpus } from '../providers-B9uVinAe.js';
 import { CcdaDocument, BuildCcdaPatient, BuildCode, BuildQuantity } from '@cosyte/ccda';
-import { C as CodeConcept, Q as QuantConcept } from '../example-codes-DeXcnCSK.js';
-import { Q as QuirkDescriptor, S as SynthProfile, a as QuirkArtifact, b as QuirkRoundTripResult } from '../quirk-C9t9CkPS.js';
+import { C as CodeConcept, Q as QuantConcept } from '../example-codes-88f3_bQZ.js';
+import { Q as QuirkDescriptor, S as SynthProfile, a as QuirkArtifact, b as QuirkRoundTripResult } from '../quirk-HZdznAkM.js';
 
 /**
- * Synthetic **C-CDA document generation** — a spec-clean Continuity of Care Document
+ * Synthetic **C-CDA document generation**: a spec-clean Continuity of Care Document
  * (CCD) or Referral Note built **through `@cosyte/ccda`'s `buildCcda`**, so template IDs, LOINC section
  * codes, and structured/narrative agreement are the builder's own (spec-clean *by construction*), and
  * every `recordTarget` / clinical identifier is drawn from the synthetic-safety providers.
  *
- * The document round-trips through `parseCcda` with **zero warnings** — the builder's round-trip-by-
+ * The document round-trips through `parseCcda` with **zero warnings**: the builder's round-trip-by-
  * construction guarantee, re-verified independently by {@link ./round-trip.roundTrip}. Coverage tracks
  * `buildCcda`'s section/doc-type maturity: the CCD SHALL sections (Problems,
  * Allergies, Medications, Results, Vital Signs) plus Immunizations, Procedures, and Social History
@@ -19,11 +19,11 @@ import { Q as QuirkDescriptor, S as SynthProfile, a as QuirkArtifact, b as Quirk
  * @module
  */
 
-/** The C-CDA document type a generator emits — the two `buildCcda` supports. */
+/** The C-CDA document type a generator emits: the two `buildCcda` supports. */
 type CcdaDocumentType = "ccd" | "referralNote";
 /** Options common to every C-CDA generator. */
 interface GenerateCcdaOptions {
-    /** The seed (deterministic — same seed yields a byte-identical document). Defaults to `0`. */
+    /** The seed (deterministic: same seed yields a byte-identical document). Defaults to `0`. */
     readonly seed?: number;
     /** The document type to emit. Defaults to `"ccd"`. */
     readonly documentType?: CcdaDocumentType;
@@ -56,7 +56,7 @@ declare function generateCcda(options?: GenerateCcdaOptions): CcdaDocument;
  */
 declare function generateCcd(options?: Omit<GenerateCcdaOptions, "documentType">): CcdaDocument;
 /**
- * Generate a spec-clean synthetic **Referral Note** — the second document type `buildCcda` supports,
+ * Generate a spec-clean synthetic **Referral Note**: the second document type `buildCcda` supports,
  * with its own US Realm Header specialization and Reason-for-Referral / Assessment narrative sections.
  *
  * @param options - Seed (deterministic). See {@link GenerateCcdaOptions}.
@@ -70,14 +70,14 @@ declare function generateCcd(options?: Omit<GenerateCcdaOptions, "documentType">
 declare function generateReferralNote(options?: Omit<GenerateCcdaOptions, "documentType">): CcdaDocument;
 
 /**
- * The **round-trip-through-the-parser harness** for C-CDA — the headline gate for the synthetic-fixture
- * generator. A generated document is "spec-clean" only if `@cosyte/ccda` — not
- * `@cosyte/synth`'s own opinion — reads it back cleanly. This harness serializes a generated document,
+ * The **round-trip-through-the-parser harness** for C-CDA: the headline gate for the synthetic-fixture
+ * generator. A generated document is "spec-clean" only if `@cosyte/ccda`, not
+ * `@cosyte/synth`'s own opinion, reads it back cleanly. This harness serializes a generated document,
  * parses it straight back through `parseCcda`, and reports what the parser found, so a false
  * "spec-clean" claim cannot hide.
  *
  * `@cosyte/ccda`'s `buildCcda` is round-trip-by-construction (it emits through the same DOM the parser
- * reads), so a clean build carries zero warnings — but this harness re-verifies that *independently*,
+ * reads), so a clean build carries zero warnings, but this harness re-verifies that *independently*,
  * against the parser, because the parser is the judge.
  *
  * @module
@@ -110,19 +110,19 @@ interface RoundTripResult {
 declare function roundTrip(doc: CcdaDocument): RoundTripResult;
 
 /**
- * Synthetic C-CDA patient identity — the `recordTarget` demographics for a generated document, every
+ * Synthetic C-CDA patient identity: the `recordTarget` demographics for a generated document, every
  * field minted from the synthetic-safety providers in `../safe`. No value a generated
  * C-CDA carries at a PHI locus can be real or plausibly-real: the name is from the shipped fake-name
  * pool, the MRN lives under the synthetic assigning-authority OID (never a real facility namespace),
  * and the birth date comes from the seeded generator (never wall-clock).
  *
- * The draw order is **fixed** (name → MRN → DOB → gender) so the same seed yields the same identity —
+ * The draw order is **fixed** (name → MRN → DOB → gender) so the same seed yields the same identity,
  * the reproducibility contract.
  *
  * @module
  */
 
-/** A synthetic C-CDA patient identity — the values threaded into a document's `recordTarget`. */
+/** A synthetic C-CDA patient identity: the values threaded into a document's `recordTarget`. */
 interface CcdaPatientIdentity {
     /** The `BuildCcdaPatient` `@cosyte/ccda` consumes for the single `recordTarget`. */
     readonly patient: BuildCcdaPatient;
@@ -133,7 +133,7 @@ interface CcdaPatientIdentity {
 }
 /**
  * Mint a complete synthetic {@link CcdaPatientIdentity}. Every value comes from a synthetic-safety
- * provider — no code path here can return a real identifier. The MRN is scoped to the
+ * provider, no code path here can return a real identifier. The MRN is scoped to the
  * synthetic assigning-authority OID (`mrnRoot`), so it is non-colliding by *namespace*, not by value.
  *
  * @param rng - The seeded generator.
@@ -148,12 +148,12 @@ interface CcdaPatientIdentity {
 declare function ccdaPatientIdentity(rng: Rng): CcdaPatientIdentity;
 
 /**
- * The C-CDA example-code pool — a thin adapter that **reuses** the same license-clean, public
+ * The C-CDA example-code pool: a thin adapter that **reuses** the same license-clean, public
  * code facts the FHIR generators ship (`../fhir/example-codes.ts`), reshaped into `@cosyte/ccda`'s
  * `BuildCode` tuple (an OID `codeSystem` instead of a FHIR `system` URI). Reusing one source of truth
  * keeps the LOINC / RxNorm / SNOMED / CVX pools consistent across the FHIR and C-CDA surfaces;
  * `@cosyte/synth` still bundles
- * **no** terminology content — these are public spec-example codes, not copyrighted tables.
+ * **no** terminology content: these are public spec-example codes, not copyrighted tables.
  *
  * Nothing here is PHI: codes and their display text are not patient identifiers. The synthetic-safety
  * invariant governs identity fields (name / DOB / MRN / telecom), which come from `../safe`.
@@ -178,7 +178,7 @@ declare function ccdaPatientIdentity(rng: Rng): CcdaPatientIdentity;
  */
 declare function toBuildCode(concept: CodeConcept): BuildCode;
 /**
- * Draw a synthetic-but-structurally-sane {@link BuildQuantity} for a quantitative concept — a value in
+ * Draw a synthetic-but-structurally-sane {@link BuildQuantity} for a quantitative concept: a value in
  * the concept's plausible band (from the seeded generator, so reproducible) rendered to the concept's
  * decimal precision, with its UCUM unit. The value implies **no** real measurement.
  *
@@ -225,7 +225,7 @@ declare const ROUTES: readonly BuildCode[];
 /**
  * C-CDA **vendor-quirk generation**. A quirk deviates the
  * *structure* of an otherwise spec-clean document (built through `@cosyte/ccda`'s `buildCcda`) so it
- * round-trips through `parseCcda` to **exactly** one intended, stable warning code — the tolerance a
+ * round-trips through `parseCcda` to **exactly** one intended, stable warning code: the tolerance a
  * `defineCcdaProfile` profile encodes. With the matching built-in profile active, that warning is
  * **re-badged** to the value-free `PROFILE_QUIRK_APPLIED` marker (`expected: true`, `toleratedCode` = the
  * original), exactly as the parser's `profileQuirkApplied` does.
@@ -234,14 +234,14 @@ declare const ROUTES: readonly BuildCode[];
  * publicly grounded and re-badged by a built-in public profile:
  *
  * - **`template-extension-absent`** → `TEMPLATE_EXTENSION_ABSENT` (profile `legacyR11`). The R2.1
- *   `@extension="2015-08-01"` version stamp is dropped from the document-type templateId — a legacy
+ *   `@extension="2015-08-01"` version stamp is dropped from the document-type templateId: a legacy
  *   R1.1-era document shape.
  * - **`deprecated-loinc`** → `DEPRECATED_LOINC` (profile `smartScorecard`). A result/vital observation
  *   LOINC code is swapped to a known-deprecated LOINC (`41909-3`).
  * - **`deprecated-code-system`** → `DEPRECATED_CODE_SYSTEM` (profile `smartScorecard`). A problem
  *   observation's value is swapped to a deprecated code system (ICD-9-CM `2.16.840.1.113883.6.103`).
  *
- * A quirk **never** introduces a real-looking value — it changes a template stamp or a code, never a PHI
+ * A quirk **never** introduces a real-looking value: it changes a template stamp or a code, never a PHI
  * locus, so the synthetic-safety gate still runs and stays zero.
  *
  * @module
@@ -249,11 +249,11 @@ declare const ROUTES: readonly BuildCode[];
 
 /** Every C-CDA quirk this package ships. */
 type CcdaQuirkName = "template-extension-absent" | "deprecated-loinc" | "deprecated-code-system";
-/** The C-CDA quirk registry — each recipe bound to the exact `@cosyte/ccda` warning code it targets. */
+/** The C-CDA quirk registry: each recipe bound to the exact `@cosyte/ccda` warning code it targets. */
 declare const CCDA_QUIRKS: Readonly<Record<CcdaQuirkName, QuirkDescriptor>>;
 /**
  * Apply a C-CDA quirk transform to a spec-clean document, or **fail closed**. Refuses to return a
- * document that does not carry the intended deviation (a quirk whose structural anchor is absent) —
+ * document that does not carry the intended deviation (a quirk whose structural anchor is absent):
  * a fixture that silently lost its quirk would test the wrong thing.
  *
  * @param quirk - The quirk to inject.
@@ -270,7 +270,7 @@ declare const CCDA_QUIRKS: Readonly<Record<CcdaQuirkName, QuirkDescriptor>>;
 declare function injectCcdaQuirk(quirk: CcdaQuirkName, cleanXml: string): string;
 /** Options for {@link generateCcdaQuirk}. */
 interface GenerateCcdaQuirkOptions {
-    /** The seed — the same seed + quirk yields a byte-identical document. Defaults to `0`. */
+    /** The seed: the same seed + quirk yields a byte-identical document. Defaults to `0`. */
     readonly seed?: number;
     /** The quirk to inject. Required. */
     readonly quirk: CcdaQuirkName;
@@ -283,14 +283,14 @@ interface GenerateCcdaQuirkOptions {
  * `quirk` + `documentType`.
  *
  * @param options - Seed, quirk, and base document type. See {@link GenerateCcdaQuirkOptions}.
- * @returns The {@link QuirkArtifact} — its `content` round-trips to `intendedWarnings` exactly.
+ * @returns The {@link QuirkArtifact}: its `content` round-trips to `intendedWarnings` exactly.
  * @throws SynthError `SYNTH_UNSUPPORTED_QUIRK` if `quirk` is not a supported C-CDA quirk.
  * @throws Error if the base document does not contain the structural anchor the quirk targets.
  * @example
  * ```ts
  * import { generateCcdaQuirk, ccdaQuirkRoundTrip } from "@cosyte/synth/ccda";
  * const rt = ccdaQuirkRoundTrip(generateCcdaQuirk({ seed: 1, quirk: "deprecated-loinc" }));
- * rt.withProfile?.tolerated; // true — `smartScorecard` re-badges DEPRECATED_LOINC
+ * rt.withProfile?.tolerated; // true, `smartScorecard` re-badges DEPRECATED_LOINC
  * ```
  */
 declare function generateCcdaQuirk(options: GenerateCcdaQuirkOptions): QuirkArtifact;
@@ -338,11 +338,11 @@ declare function ccdaQuirkCorpus(options: CcdaQuirkCorpusOptions): Corpus;
 declare const ccdaQuirkProfile: SynthProfile;
 
 /**
- * `@cosyte/synth/ccda` — the C-CDA generation surface, exposed as its own subpath so importing the
+ * `@cosyte/synth/ccda`: the C-CDA generation surface, exposed as its own subpath so importing the
  * package root does **not** pull `@cosyte/ccda`. This is the **lazy, per-format** boundary: a consumer
  * who only needs C-CDA fixtures imports `@cosyte/synth/ccda`; one who needs only the core primitives
  * never loads a parser.
- * `@cosyte/ccda` is an **optional peer dependency** — present only for this subpath.
+ * `@cosyte/ccda` is an **optional peer dependency**, present only for this subpath.
  *
  * This subpath ships spec-clean C-CDA document generation via `@cosyte/ccda`'s
  * `buildCcda`: a **CCD** (`generateCcd`) and a **Referral Note** (`generateReferralNote`), each built
@@ -352,7 +352,7 @@ declare const ccdaQuirkProfile: SynthProfile;
  * @module
  */
 
-/** Every C-CDA document kind {@link ccdaCorpus} generates — the `documentType` used as the corpus `kind`. */
+/** Every C-CDA document kind {@link ccdaCorpus} generates: the `documentType` used as the corpus `kind`. */
 type CcdaCorpusKind = CcdaDocumentType;
 /** Options for {@link ccdaCorpus}. */
 interface CcdaCorpusOptions {
@@ -374,7 +374,7 @@ interface CcdaCorpusOptions {
  * ```ts
  * import { ccdaCorpus } from "@cosyte/synth/ccda";
  * const corpus = ccdaCorpus({ seed: 42, count: 4 });
- * corpus.artifacts.every((a) => a.warnings.length === 0); // true — spec-clean
+ * corpus.artifacts.every((a) => a.warnings.length === 0); // true, spec-clean
  * ```
  */
 declare function ccdaCorpus(options: CcdaCorpusOptions): Corpus;

package/dist/ccda/index.mjs

@@ -32,32 +32,32 @@ function sfc32Next(s) {
 // src/codes.ts
 var SYNTH_FATAL_CODES = {
   /**
-   * A vendor quirk was requested that the target format's profile system does not support. Fatal —
+   * A vendor quirk was requested that the target format's profile system does not support. Fatal,
    * never a silent no-op and never a fabricated quirk.
    */
   SYNTH_UNSUPPORTED_QUIRK: "SYNTH_UNSUPPORTED_QUIRK",
   /**
    * A quirk transform found no structural anchor to mutate, so the fixture would not carry the
-   * deviation it is labelled with. Fatal — a golden file that lies about its parser verdict is worse
+   * deviation it is labelled with. Fatal: a golden file that lies about its parser verdict is worse
    * than no golden file.
    */
   SYNTH_QUIRK_ANCHOR_ABSENT: "SYNTH_QUIRK_ANCHOR_ABSENT",
   /**
    * A bare parse of a freshly-generated quirk artifact did not produce exactly the declared intended
-   * warning code(s). Fatal — never emit a mislabeled fixture.
+   * warning code(s). Fatal, never emit a mislabeled fixture.
    */
   SYNTH_INTENDED_WARNING_MISMATCH: "SYNTH_INTENDED_WARNING_MISMATCH",
   /** A concept's code-system URI has no OID mapping in the C-CDA example-code table. Fatal. */
   SYNTH_UNMAPPED_CODE_SYSTEM: "SYNTH_UNMAPPED_CODE_SYSTEM",
   /** 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 `defineSynthProfile` spec was not usable (a missing or blank `name`). Fatal. */
   SYNTH_INVALID_PROFILE: "SYNTH_INVALID_PROFILE",
   /**
    * A caller-supplied selector (a message kind, a document type, a corpus mix entry, a claim
-   * variant, a Bundle type, a resource profile) is not in the closed set that governs it. Fatal —
+   * 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.
    */
@@ -151,7 +151,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"
@@ -433,23 +433,23 @@ var SYSTEM = Object.freeze({
   IDENTIFIER_TYPE: "http://terminology.hl7.org/CodeSystem/v2-0203",
   /** OMB race & ethnicity category system (US Core race/ethnicity `ombCategory`). */
   OMB_RACE_ETHNICITY: "urn:oid:2.16.840.1.113883.6.238",
-  /** LOINC — `Observation.code` (lab + vital-signs). */
+  /** LOINC, `Observation.code` (lab + vital-signs). */
   LOINC: "http://loinc.org",
-  /** SNOMED CT — `Condition.code`. */
+  /** SNOMED CT, `Condition.code`. */
   SNOMED: "http://snomed.info/sct",
-  /** RxNorm — `MedicationRequest.medicationCodeableConcept` + an allergen substance. */
+  /** RxNorm, `MedicationRequest.medicationCodeableConcept` + an allergen substance. */
   RXNORM: "http://www.nlm.nih.gov/research/umls/rxnorm",
-  /** UCUM — `Quantity.system` for units of measure. */
+  /** UCUM, `Quantity.system` for units of measure. */
   UCUM: "http://unitsofmeasure.org",
-  /** CVX (CDC vaccine administered) — `Immunization.vaccineCode`. */
+  /** CVX (CDC vaccine administered), `Immunization.vaccineCode`. */
   CVX: "http://hl7.org/fhir/sid/cvx",
-  /** HL7 v3 `ActCode` — `Encounter.class`. */
+  /** HL7 v3 `ActCode`, `Encounter.class`. */
   V3_ACT_CODE: "http://terminology.hl7.org/CodeSystem/v3-ActCode",
-  /** HL7 v2 `0074` diagnostic-service-section — `DiagnosticReport.category` (`LAB`). */
+  /** HL7 v2 `0074` diagnostic-service-section, `DiagnosticReport.category` (`LAB`). */
   DIAGNOSTIC_SERVICE_SECTION: "http://terminology.hl7.org/CodeSystem/v2-0074",
-  /** HL7 Terminology `allergyintolerance-clinical` — `AllergyIntolerance.clinicalStatus`. */
+  /** HL7 Terminology `allergyintolerance-clinical`, `AllergyIntolerance.clinicalStatus`. */
   ALLERGY_CLINICAL: "http://terminology.hl7.org/CodeSystem/allergyintolerance-clinical",
-  /** HL7 Terminology `allergyintolerance-verification` — `AllergyIntolerance.verificationStatus`. */
+  /** HL7 Terminology `allergyintolerance-verification`, `AllergyIntolerance.verificationStatus`. */
   ALLERGY_VERIFICATION: "http://terminology.hl7.org/CodeSystem/allergyintolerance-verification"
 });