@cosyte/synth 0.0.6 → 0.0.8

package/dist/fhir/index.d.cts

@@ -1,9 +1,9 @@
 import { FhirComplex, StructureDefinition, FhirNode } from '@cosyte/fhir';
-import { C as Corpus, R as Rng, S as SyntheticName, a as SyntheticIdentifier, b as SyntheticAddress } from '../providers-OLz3zAc-.cjs';
-export { C as CodeConcept, E as EXAMPLE_ALLERGENS, a as EXAMPLE_ALLERGY_MANIFESTATIONS, b as EXAMPLE_CONDITIONS, c as EXAMPLE_DIAGNOSTIC_REPORTS, d as EXAMPLE_ENCOUNTER_CLASSES, e as EXAMPLE_ENCOUNTER_TYPES, f as EXAMPLE_ETHNICITY_CATEGORIES, g as EXAMPLE_LAB_OBSERVATIONS, h as EXAMPLE_MEDICATIONS, i as EXAMPLE_PROCEDURES, j as EXAMPLE_RACE_CATEGORIES, k as EXAMPLE_VACCINES, l as EXAMPLE_VITAL_SIGNS, Q as QuantConcept } from '../example-codes-DeXcnCSK.cjs';
+import { C as Corpus, R as Rng, S as SyntheticName, a as SyntheticIdentifier, b as SyntheticAddress } from '../providers-B9uVinAe.cjs';
+export { C as CodeConcept, E as EXAMPLE_ALLERGENS, a as EXAMPLE_ALLERGY_MANIFESTATIONS, b as EXAMPLE_CONDITIONS, c as EXAMPLE_DIAGNOSTIC_REPORTS, d as EXAMPLE_ENCOUNTER_CLASSES, e as EXAMPLE_ENCOUNTER_TYPES, f as EXAMPLE_ETHNICITY_CATEGORIES, g as EXAMPLE_LAB_OBSERVATIONS, h as EXAMPLE_MEDICATIONS, i as EXAMPLE_PROCEDURES, j as EXAMPLE_RACE_CATEGORIES, k as EXAMPLE_VACCINES, l as EXAMPLE_VITAL_SIGNS, Q as QuantConcept } from '../example-codes-88f3_bQZ.cjs';
 
 /**
- * Synthetic FHIR R4 **`Patient`** generation — the anchor of the US Core clinical spine. Built through
+ * Synthetic FHIR R4 **`Patient`** generation: the anchor of the US Core clinical spine. Built through
  * `@cosyte/fhir`'s model constructors, every identity field drawn from the
  * synthetic-safety providers. In `us-core` mode the resource claims US Core Patient via
  * `meta.profile`, satisfies its required elements (`identifier` + `system` + `value`, `name`, `gender`),
@@ -19,7 +19,7 @@ interface GeneratePatientOptions {
     /**
      * The profile posture. `"base"` (default) emits a spec-clean base-R4 `Patient`; `"us-core"` adds the
      * US Core `meta.profile` and the race/ethnicity/birthsex must-support extensions (the required
-     * elements — identifier/name/gender — are always present).
+     * elements, identifier/name/gender, are always present).
      */
     readonly profile?: "base" | "us-core";
 }
@@ -39,7 +39,7 @@ interface GeneratePatientOptions {
 declare function generatePatient(options?: GeneratePatientOptions): FhirComplex;
 
 /**
- * Synthetic FHIR R4 **`Condition`** generation — a US Core "Problems and Health Concerns" problem-list
+ * Synthetic FHIR R4 **`Condition`** generation: a US Core "Problems and Health Concerns" problem-list
  * item. Built through `@cosyte/fhir`; the `code` comes from the license-clean SNOMED
  * example pool, the `subject` from a supplied or derived synthetic Patient reference.
  *
@@ -69,10 +69,10 @@ interface GenerateConditionOptions {
 declare function generateCondition(options?: GenerateConditionOptions): FhirComplex;
 
 /**
- * Synthetic FHIR R4 **`Observation`** generation — US Core Laboratory Result and US Core Vital Signs. Built
+ * Synthetic FHIR R4 **`Observation`** generation: US Core Laboratory Result and US Core Vital Signs. Built
  * through `@cosyte/fhir`; `code` and the measured `valueQuantity` come from
  * the license-clean LOINC/UCUM example pool, `subject` from a supplied or derived Patient reference.
- * The measured value is drawn from the seeded generator within a structurally-sane band — it implies no
+ * The measured value is drawn from the seeded generator within a structurally-sane band: it implies no
  * real measurement.
  *
  * @module
@@ -114,7 +114,7 @@ declare function generateObservationLab(options?: GenerateObservationOptions): F
 declare function generateVitalSign(options?: GenerateObservationOptions): FhirComplex;
 
 /**
- * Synthetic FHIR R4 **`MedicationRequest`** generation — a US Core MedicationRequest with an inline
+ * Synthetic FHIR R4 **`MedicationRequest`** generation: a US Core MedicationRequest with an inline
  * `medicationCodeableConcept`. Built through `@cosyte/fhir`; the medication comes
  * from the license-clean RxNorm example pool. US Core invariant `us-core-21` requires a `requester`
  * whenever `intent = order`, so a synthetic requester reference is always emitted.
@@ -147,7 +147,7 @@ interface GenerateMedicationRequestOptions {
 declare function generateMedicationRequest(options?: GenerateMedicationRequestOptions): FhirComplex;
 
 /**
- * Synthetic FHIR R4 **`Encounter`** generation — a US Core Encounter. Built through `@cosyte/fhir`'s model
+ * Synthetic FHIR R4 **`Encounter`** generation: a US Core Encounter. Built through `@cosyte/fhir`'s model
  * constructors; `class` and `type` come from the
  * license-clean v3-ActCode / SNOMED example pools, `subject` from a supplied or derived synthetic
  * Patient reference. The required elements (`status`, `class`, `type`, `subject`) are always present.
@@ -178,7 +178,7 @@ interface GenerateEncounterOptions {
 declare function generateEncounter(options?: GenerateEncounterOptions): FhirComplex;
 
 /**
- * Synthetic FHIR R4 **`Immunization`** generation — a US Core Immunization. Built through `@cosyte/fhir`;
+ * Synthetic FHIR R4 **`Immunization`** generation: a US Core Immunization. Built through `@cosyte/fhir`;
  * `vaccineCode` comes from the license-clean CVX example
  * pool, `patient` from a supplied or derived synthetic Patient reference. The required elements
  * (`status`, `vaccineCode`, `patient`, `occurrenceDateTime`) are always present.
@@ -209,7 +209,7 @@ interface GenerateImmunizationOptions {
 declare function generateImmunization(options?: GenerateImmunizationOptions): FhirComplex;
 
 /**
- * Synthetic FHIR R4 **`AllergyIntolerance`** generation — a US Core AllergyIntolerance. Built through
+ * Synthetic FHIR R4 **`AllergyIntolerance`** generation: a US Core AllergyIntolerance. Built through
  * `@cosyte/fhir`; the allergen `code` and reaction
  * `manifestation` come from the license-clean RxNorm/SNOMED example pools, `patient` from a supplied or
  * derived synthetic Patient reference. `clinicalStatus` + `verificationStatus` are emitted together so
@@ -242,7 +242,7 @@ interface GenerateAllergyIntoleranceOptions {
 declare function generateAllergyIntolerance(options?: GenerateAllergyIntoleranceOptions): FhirComplex;
 
 /**
- * Synthetic FHIR R4 **`Procedure`** generation — a US Core Procedure. Built through `@cosyte/fhir`; the
+ * Synthetic FHIR R4 **`Procedure`** generation: a US Core Procedure. Built through `@cosyte/fhir`; the
  * `code` comes from the license-clean SNOMED procedure
  * example pool (never CPT), `subject` from a supplied or derived synthetic Patient
  * reference. The required elements (`status`, `code`, `subject`) plus the must-support
@@ -274,7 +274,7 @@ interface GenerateProcedureOptions {
 declare function generateProcedure(options?: GenerateProcedureOptions): FhirComplex;
 
 /**
- * Synthetic FHIR R4 **`DiagnosticReport`** generation — the US Core DiagnosticReport Profile for
+ * Synthetic FHIR R4 **`DiagnosticReport`** generation: the US Core DiagnosticReport Profile for
  * Laboratory Results Reporting. Built through `@cosyte/fhir`;
  * the report `code` comes from the license-clean LOINC example pool, `subject` from a supplied or
  * derived synthetic Patient reference. The required `category` carries the profile's mandated `LAB`
@@ -311,7 +311,7 @@ interface GenerateDiagnosticReportOptions {
 declare function generateDiagnosticReport(options?: GenerateDiagnosticReportOptions): FhirComplex;
 
 /**
- * Synthetic FHIR R4 **`Bundle`** generation — a self-contained `collection`,
+ * Synthetic FHIR R4 **`Bundle`** generation: a self-contained `collection`,
  * `transaction`, or `document` Bundle assembling a synthetic US Core `Patient` and its full clinical
  * spine (`Condition`, lab + vital-sign `Observation`s, `MedicationRequest`, `Encounter`,
  * `Immunization`, `AllergyIntolerance`, `Procedure`, `DiagnosticReport`), wired by `urn:uuid:`
@@ -361,7 +361,7 @@ interface FhirCorpusOptions {
  * resource is generated from a distinct sub-seed derived from the corpus seed and round-tripped through
  * `@cosyte/fhir`; the per-artifact `warnings` record the validator's non-informational findings (empty
  * ⇒ spec-clean, no US Core profiles supplied). Pass US Core `StructureDefinition`s to a per-resource
- * {@link roundTrip} call to additionally assert profile conformance (BYO — none is bundled).
+ * {@link roundTrip} call to additionally assert profile conformance (BYO, none is bundled).
  *
  * @param options - Seed, count, and the resource mix. See {@link FhirCorpusOptions}.
  * @returns A deep-frozen {@link Corpus}.
@@ -375,7 +375,7 @@ interface FhirCorpusOptions {
 declare function fhirCorpus(options: FhirCorpusOptions): Corpus;
 
 /**
- * Synthetic FHIR R4 **`Composition`** generation — the mandatory first resource of a `document` Bundle
+ * Synthetic FHIR R4 **`Composition`** generation: the mandatory first resource of a `document` Bundle
  * (FHIR invariant `bdl-11`), built through `@cosyte/fhir`.
  * A Composition is a base-R4 resource (US Core 6.1.0 defines no Composition profile), so it is grounded
  * against base FHIR R4; every reference it carries (`subject`, `author`, `custodian`, section `entry`s)
@@ -420,15 +420,15 @@ interface BuildCompositionInput {
 declare function buildComposition(rng: Rng, input: BuildCompositionInput): FhirComplex;
 
 /**
- * The **round-trip-through-the-parser harness** for FHIR — the headline gate for the synthetic-fixture
- * generator. A generated resource is "spec-clean" only if `@cosyte/fhir` — not
- * `@cosyte/synth`'s own opinion — reads it back, validates it, and re-serializes it byte-identically.
+ * The **round-trip-through-the-parser harness** for FHIR: the headline gate for the synthetic-fixture
+ * generator. A generated resource is "spec-clean" only if `@cosyte/fhir`, not
+ * `@cosyte/synth`'s own opinion, reads it back, validates it, and re-serializes it byte-identically.
  * This harness serializes a generated resource, parses it back, validates it (optionally against
  * supplied US Core / vendor `StructureDefinition`s), and re-serializes, reporting what the parser found
  * so a false "spec-clean" claim cannot hide.
  *
  * `@cosyte/synth` bundles **no** profile content: to validate US Core conformance, a caller supplies
- * the `StructureDefinition`s via {@link RoundTripOptions.profiles} — exactly the content-free posture of
+ * the `StructureDefinition`s via {@link RoundTripOptions.profiles}, exactly the content-free posture of
  * `@cosyte/fhir.validateResource({ profiles })`.
  *
  * @module
@@ -437,7 +437,7 @@ declare function buildComposition(rng: Rng, input: BuildCompositionInput): FhirC
 /** Options for {@link roundTrip}. */
 interface RoundTripOptions {
     /**
-     * US Core / vendor profiles (`StructureDefinition`s) to validate against. **None is bundled** — a
+     * US Core / vendor profiles (`StructureDefinition`s) to validate against. **None is bundled**: a
      * caller supplies them (BYO), matching `@cosyte/fhir`'s content-free posture.
      */
     readonly profiles?: readonly StructureDefinition[];
@@ -449,7 +449,7 @@ interface RoundTripResult {
     /**
      * The validation issue codes at `error`/`fatal` severity (empty ⇒ valid). `information`/`warning`
      * findings (e.g. `MUST_SUPPORT_ABSENT`, `INVARIANT_UNCHECKED`, base `dom-6`) are advisory and are
-     * excluded here — they never make a resource invalid.
+     * excluded here: they never make a resource invalid.
      */
     readonly errors: readonly string[];
     /** All non-informational issue codes (errors **and** warnings), for the `Corpus` artifact record. */
@@ -478,10 +478,10 @@ interface RoundTripResult {
 declare function roundTrip(resource: FhirComplex, options?: RoundTripOptions): RoundTripResult;
 
 /**
- * Shared FHIR model-construction helpers — the small vocabulary every resource generator uses
+ * Shared FHIR model-construction helpers: the small vocabulary every resource generator uses
  * to build **through `@cosyte/fhir`'s own model constructors** (`complex` / `list` / `primitive` /
  * `decimal`). A generated resource is a `FhirComplex` tree assembled here and serialized by
- * `@cosyte/fhir`'s conservative writer, so it is **spec-clean by construction** — the same mechanism
+ * `@cosyte/fhir`'s conservative writer, so it is **spec-clean by construction**: the same mechanism
  * that makes the parser's emit side spec-clean. Nothing here hand-writes JSON
  * bytes.
  *
@@ -493,7 +493,7 @@ declare function roundTrip(resource: FhirComplex, options?: RoundTripOptions): R
  * @module
  */
 
-/** A named FHIR property (`{ name, value }`) — the shape `complex` consumes. */
+/** A named FHIR property (`{ name, value }`): the shape `complex` consumes. */
 type Prop = {
     readonly name: string;
     readonly value: FhirNode;
@@ -593,11 +593,11 @@ declare function codeableConcept(concept: {
 declare function reference(ref: string): FhirComplex;
 /**
  * A generated `Narrative` (`text`) with `status: "generated"` and an XHTML `div` carrying only
- * synthetic text — satisfies the base `dom-6` best-practice constraint so a generated resource is
+ * synthetic text, satisfies the base `dom-6` best-practice constraint so a generated resource is
  * robust as well as valid. The `div` is XHTML-namespaced and carries no markup beyond a paragraph, so
  * it round-trips byte-for-byte through `@cosyte/fhir`'s codec.
  *
- * @param text - The plain synthetic summary text (no PHI — it is composed from synthetic values).
+ * @param text - The plain synthetic summary text (no PHI: it is composed from synthetic values).
  * @returns A `Narrative` `FhirComplex`.
  * @example
  * ```ts
@@ -620,9 +620,9 @@ declare function narrative(text: string): FhirComplex;
  * ```
  */
 declare function meta(profiles: readonly string[]): FhirComplex;
-/** A synthetic FHIR patient identity — every field drawn from `../safe`. */
+/** A synthetic FHIR patient identity: every field drawn from `../safe`. */
 interface FhirPatientIdentity {
-    /** A synthetic resource `id` (a seeded UUID) — never a real record key. */
+    /** A synthetic resource `id` (a seeded UUID), never a real record key. */
     readonly id: string;
     /** Name from the shipped fake-name pool. */
     readonly person: SyntheticName;
@@ -653,7 +653,7 @@ interface FhirPatientIdentity {
 declare function toFhirDate(ymd: string): string;
 /**
  * Mint a complete synthetic {@link FhirPatientIdentity}. Every value comes from a synthetic-safety
- * provider — no code path here can return a real or plausibly-real identifier. The draw
+ * provider, no code path here can return a real or plausibly-real identifier. The draw
  * order is fixed (id → name → MRN → DOB → gender → address → phone → email) so the same seed yields the
  * same identity.
  *
@@ -667,7 +667,7 @@ declare function toFhirDate(ymd: string): string;
  */
 declare function fhirPatientIdentity(rng: Rng): FhirPatientIdentity;
 /**
- * The US Core Patient `identifier` element for a synthetic MRN — `type` (`MR`), the synthetic
+ * The US Core Patient `identifier` element for a synthetic MRN: `type` (`MR`), the synthetic
  * assigning-authority OID as `system`, and the synthetic value. Satisfies US Core Patient's required
  * `identifier.system` + `identifier.value`.
  *
@@ -683,18 +683,18 @@ declare function fhirPatientIdentity(rng: Rng): FhirPatientIdentity;
 declare function mrnIdentifier(mrn: SyntheticIdentifier): FhirComplex;
 
 /**
- * US Core + base-FHIR **canonical URLs and code-system identifiers** — the facts `@cosyte/synth` needs
+ * US Core + base-FHIR **canonical URLs and code-system identifiers**: the facts `@cosyte/synth` needs
  * to emit US-Core-conformant resources, and nothing more.
  *
- * **Content-free, exactly like `@cosyte/fhir`.** These are *identifiers* — canonical URLs and code
- * `system` URIs — not the copyrighted terminology tables or the profile `StructureDefinition` content
+ * **Content-free, exactly like `@cosyte/fhir`.** These are *identifiers*: canonical URLs and code
+ * `system` URIs, not the copyrighted terminology tables or the profile `StructureDefinition` content
  * they name. `@cosyte/synth` bundles **no** US Core IG: a consumer who wants to *validate* generated
  * output against US Core supplies the `StructureDefinition`s themselves (BYO), exactly as
  * `@cosyte/fhir.validateResource({ profiles })` requires. What is encoded here is only which canonical
- * URL a resource's `meta.profile` claims and which `system` a coding carries — public facts.
+ * URL a resource's `meta.profile` claims and which `system` a coding carries: public facts.
  *
  * The URLs target **US Core 6.1.0** (the USCDI v3 / ONC HTI-1 §170.315(g)(10) anchor, FHIR R4 4.0.1),
- * grounded firsthand against the published IG (`hl7.org/fhir/us/core/STU6.1`) — the same version the
+ * grounded firsthand against the published IG (`hl7.org/fhir/us/core/STU6.1`): the same version the
  * test corpus validates against.
  *
  * @module
@@ -730,7 +730,7 @@ declare const US_CORE_ETHNICITY_EXTENSION = "http://hl7.org/fhir/us/core/Structu
 declare const US_CORE_BIRTHSEX_EXTENSION = "http://hl7.org/fhir/us/core/StructureDefinition/us-core-birthsex";
 /**
  * The code-system `system` URIs the generators reference. Public identity URIs (HL7-published),
- * never the code-system *content* — no SNOMED/LOINC/RxNorm table is bundled.
+ * never the code-system *content*, no SNOMED/LOINC/RxNorm table is bundled.
  */
 declare const SYSTEM: Readonly<{
     /** FHIR `administrative-gender` (`Patient.gender`). */
@@ -747,23 +747,23 @@ declare const SYSTEM: Readonly<{
     readonly IDENTIFIER_TYPE: "http://terminology.hl7.org/CodeSystem/v2-0203";
     /** OMB race & ethnicity category system (US Core race/ethnicity `ombCategory`). */
     readonly OMB_RACE_ETHNICITY: "urn:oid:2.16.840.1.113883.6.238";
-    /** LOINC — `Observation.code` (lab + vital-signs). */
+    /** LOINC, `Observation.code` (lab + vital-signs). */
     readonly LOINC: "http://loinc.org";
-    /** SNOMED CT — `Condition.code`. */
+    /** SNOMED CT, `Condition.code`. */
     readonly SNOMED: "http://snomed.info/sct";
-    /** RxNorm — `MedicationRequest.medicationCodeableConcept` + an allergen substance. */
+    /** RxNorm, `MedicationRequest.medicationCodeableConcept` + an allergen substance. */
     readonly RXNORM: "http://www.nlm.nih.gov/research/umls/rxnorm";
-    /** UCUM — `Quantity.system` for units of measure. */
+    /** UCUM, `Quantity.system` for units of measure. */
     readonly UCUM: "http://unitsofmeasure.org";
-    /** CVX (CDC vaccine administered) — `Immunization.vaccineCode`. */
+    /** CVX (CDC vaccine administered), `Immunization.vaccineCode`. */
     readonly CVX: "http://hl7.org/fhir/sid/cvx";
-    /** HL7 v3 `ActCode` — `Encounter.class`. */
+    /** HL7 v3 `ActCode`, `Encounter.class`. */
     readonly 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`). */
     readonly DIAGNOSTIC_SERVICE_SECTION: "http://terminology.hl7.org/CodeSystem/v2-0074";
-    /** HL7 Terminology `allergyintolerance-clinical` — `AllergyIntolerance.clinicalStatus`. */
+    /** HL7 Terminology `allergyintolerance-clinical`, `AllergyIntolerance.clinicalStatus`. */
     readonly ALLERGY_CLINICAL: "http://terminology.hl7.org/CodeSystem/allergyintolerance-clinical";
-    /** HL7 Terminology `allergyintolerance-verification` — `AllergyIntolerance.verificationStatus`. */
+    /** HL7 Terminology `allergyintolerance-verification`, `AllergyIntolerance.verificationStatus`. */
     readonly ALLERGY_VERIFICATION: "http://terminology.hl7.org/CodeSystem/allergyintolerance-verification";
 }>;
 /** A US Core profile canonical URL. */

package/dist/fhir/index.d.ts

@@ -1,9 +1,9 @@
 import { FhirComplex, StructureDefinition, FhirNode } from '@cosyte/fhir';
-import { C as Corpus, R as Rng, S as SyntheticName, a as SyntheticIdentifier, b as SyntheticAddress } from '../providers-OLz3zAc-.js';
-export { C as CodeConcept, E as EXAMPLE_ALLERGENS, a as EXAMPLE_ALLERGY_MANIFESTATIONS, b as EXAMPLE_CONDITIONS, c as EXAMPLE_DIAGNOSTIC_REPORTS, d as EXAMPLE_ENCOUNTER_CLASSES, e as EXAMPLE_ENCOUNTER_TYPES, f as EXAMPLE_ETHNICITY_CATEGORIES, g as EXAMPLE_LAB_OBSERVATIONS, h as EXAMPLE_MEDICATIONS, i as EXAMPLE_PROCEDURES, j as EXAMPLE_RACE_CATEGORIES, k as EXAMPLE_VACCINES, l as EXAMPLE_VITAL_SIGNS, Q as QuantConcept } from '../example-codes-DeXcnCSK.js';
+import { C as Corpus, R as Rng, S as SyntheticName, a as SyntheticIdentifier, b as SyntheticAddress } from '../providers-B9uVinAe.js';
+export { C as CodeConcept, E as EXAMPLE_ALLERGENS, a as EXAMPLE_ALLERGY_MANIFESTATIONS, b as EXAMPLE_CONDITIONS, c as EXAMPLE_DIAGNOSTIC_REPORTS, d as EXAMPLE_ENCOUNTER_CLASSES, e as EXAMPLE_ENCOUNTER_TYPES, f as EXAMPLE_ETHNICITY_CATEGORIES, g as EXAMPLE_LAB_OBSERVATIONS, h as EXAMPLE_MEDICATIONS, i as EXAMPLE_PROCEDURES, j as EXAMPLE_RACE_CATEGORIES, k as EXAMPLE_VACCINES, l as EXAMPLE_VITAL_SIGNS, Q as QuantConcept } from '../example-codes-88f3_bQZ.js';
 
 /**
- * Synthetic FHIR R4 **`Patient`** generation — the anchor of the US Core clinical spine. Built through
+ * Synthetic FHIR R4 **`Patient`** generation: the anchor of the US Core clinical spine. Built through
  * `@cosyte/fhir`'s model constructors, every identity field drawn from the
  * synthetic-safety providers. In `us-core` mode the resource claims US Core Patient via
  * `meta.profile`, satisfies its required elements (`identifier` + `system` + `value`, `name`, `gender`),
@@ -19,7 +19,7 @@ interface GeneratePatientOptions {
     /**
      * The profile posture. `"base"` (default) emits a spec-clean base-R4 `Patient`; `"us-core"` adds the
      * US Core `meta.profile` and the race/ethnicity/birthsex must-support extensions (the required
-     * elements — identifier/name/gender — are always present).
+     * elements, identifier/name/gender, are always present).
      */
     readonly profile?: "base" | "us-core";
 }
@@ -39,7 +39,7 @@ interface GeneratePatientOptions {
 declare function generatePatient(options?: GeneratePatientOptions): FhirComplex;
 
 /**
- * Synthetic FHIR R4 **`Condition`** generation — a US Core "Problems and Health Concerns" problem-list
+ * Synthetic FHIR R4 **`Condition`** generation: a US Core "Problems and Health Concerns" problem-list
  * item. Built through `@cosyte/fhir`; the `code` comes from the license-clean SNOMED
  * example pool, the `subject` from a supplied or derived synthetic Patient reference.
  *
@@ -69,10 +69,10 @@ interface GenerateConditionOptions {
 declare function generateCondition(options?: GenerateConditionOptions): FhirComplex;
 
 /**
- * Synthetic FHIR R4 **`Observation`** generation — US Core Laboratory Result and US Core Vital Signs. Built
+ * Synthetic FHIR R4 **`Observation`** generation: US Core Laboratory Result and US Core Vital Signs. Built
  * through `@cosyte/fhir`; `code` and the measured `valueQuantity` come from
  * the license-clean LOINC/UCUM example pool, `subject` from a supplied or derived Patient reference.
- * The measured value is drawn from the seeded generator within a structurally-sane band — it implies no
+ * The measured value is drawn from the seeded generator within a structurally-sane band: it implies no
  * real measurement.
  *
  * @module
@@ -114,7 +114,7 @@ declare function generateObservationLab(options?: GenerateObservationOptions): F
 declare function generateVitalSign(options?: GenerateObservationOptions): FhirComplex;
 
 /**
- * Synthetic FHIR R4 **`MedicationRequest`** generation — a US Core MedicationRequest with an inline
+ * Synthetic FHIR R4 **`MedicationRequest`** generation: a US Core MedicationRequest with an inline
  * `medicationCodeableConcept`. Built through `@cosyte/fhir`; the medication comes
  * from the license-clean RxNorm example pool. US Core invariant `us-core-21` requires a `requester`
  * whenever `intent = order`, so a synthetic requester reference is always emitted.
@@ -147,7 +147,7 @@ interface GenerateMedicationRequestOptions {
 declare function generateMedicationRequest(options?: GenerateMedicationRequestOptions): FhirComplex;
 
 /**
- * Synthetic FHIR R4 **`Encounter`** generation — a US Core Encounter. Built through `@cosyte/fhir`'s model
+ * Synthetic FHIR R4 **`Encounter`** generation: a US Core Encounter. Built through `@cosyte/fhir`'s model
  * constructors; `class` and `type` come from the
  * license-clean v3-ActCode / SNOMED example pools, `subject` from a supplied or derived synthetic
  * Patient reference. The required elements (`status`, `class`, `type`, `subject`) are always present.
@@ -178,7 +178,7 @@ interface GenerateEncounterOptions {
 declare function generateEncounter(options?: GenerateEncounterOptions): FhirComplex;
 
 /**
- * Synthetic FHIR R4 **`Immunization`** generation — a US Core Immunization. Built through `@cosyte/fhir`;
+ * Synthetic FHIR R4 **`Immunization`** generation: a US Core Immunization. Built through `@cosyte/fhir`;
  * `vaccineCode` comes from the license-clean CVX example
  * pool, `patient` from a supplied or derived synthetic Patient reference. The required elements
  * (`status`, `vaccineCode`, `patient`, `occurrenceDateTime`) are always present.
@@ -209,7 +209,7 @@ interface GenerateImmunizationOptions {
 declare function generateImmunization(options?: GenerateImmunizationOptions): FhirComplex;
 
 /**
- * Synthetic FHIR R4 **`AllergyIntolerance`** generation — a US Core AllergyIntolerance. Built through
+ * Synthetic FHIR R4 **`AllergyIntolerance`** generation: a US Core AllergyIntolerance. Built through
  * `@cosyte/fhir`; the allergen `code` and reaction
  * `manifestation` come from the license-clean RxNorm/SNOMED example pools, `patient` from a supplied or
  * derived synthetic Patient reference. `clinicalStatus` + `verificationStatus` are emitted together so
@@ -242,7 +242,7 @@ interface GenerateAllergyIntoleranceOptions {
 declare function generateAllergyIntolerance(options?: GenerateAllergyIntoleranceOptions): FhirComplex;
 
 /**
- * Synthetic FHIR R4 **`Procedure`** generation — a US Core Procedure. Built through `@cosyte/fhir`; the
+ * Synthetic FHIR R4 **`Procedure`** generation: a US Core Procedure. Built through `@cosyte/fhir`; the
  * `code` comes from the license-clean SNOMED procedure
  * example pool (never CPT), `subject` from a supplied or derived synthetic Patient
  * reference. The required elements (`status`, `code`, `subject`) plus the must-support
@@ -274,7 +274,7 @@ interface GenerateProcedureOptions {
 declare function generateProcedure(options?: GenerateProcedureOptions): FhirComplex;
 
 /**
- * Synthetic FHIR R4 **`DiagnosticReport`** generation — the US Core DiagnosticReport Profile for
+ * Synthetic FHIR R4 **`DiagnosticReport`** generation: the US Core DiagnosticReport Profile for
  * Laboratory Results Reporting. Built through `@cosyte/fhir`;
  * the report `code` comes from the license-clean LOINC example pool, `subject` from a supplied or
  * derived synthetic Patient reference. The required `category` carries the profile's mandated `LAB`
@@ -311,7 +311,7 @@ interface GenerateDiagnosticReportOptions {
 declare function generateDiagnosticReport(options?: GenerateDiagnosticReportOptions): FhirComplex;
 
 /**
- * Synthetic FHIR R4 **`Bundle`** generation — a self-contained `collection`,
+ * Synthetic FHIR R4 **`Bundle`** generation: a self-contained `collection`,
  * `transaction`, or `document` Bundle assembling a synthetic US Core `Patient` and its full clinical
  * spine (`Condition`, lab + vital-sign `Observation`s, `MedicationRequest`, `Encounter`,
  * `Immunization`, `AllergyIntolerance`, `Procedure`, `DiagnosticReport`), wired by `urn:uuid:`
@@ -361,7 +361,7 @@ interface FhirCorpusOptions {
  * resource is generated from a distinct sub-seed derived from the corpus seed and round-tripped through
  * `@cosyte/fhir`; the per-artifact `warnings` record the validator's non-informational findings (empty
  * ⇒ spec-clean, no US Core profiles supplied). Pass US Core `StructureDefinition`s to a per-resource
- * {@link roundTrip} call to additionally assert profile conformance (BYO — none is bundled).
+ * {@link roundTrip} call to additionally assert profile conformance (BYO, none is bundled).
  *
  * @param options - Seed, count, and the resource mix. See {@link FhirCorpusOptions}.
  * @returns A deep-frozen {@link Corpus}.
@@ -375,7 +375,7 @@ interface FhirCorpusOptions {
 declare function fhirCorpus(options: FhirCorpusOptions): Corpus;
 
 /**
- * Synthetic FHIR R4 **`Composition`** generation — the mandatory first resource of a `document` Bundle
+ * Synthetic FHIR R4 **`Composition`** generation: the mandatory first resource of a `document` Bundle
  * (FHIR invariant `bdl-11`), built through `@cosyte/fhir`.
  * A Composition is a base-R4 resource (US Core 6.1.0 defines no Composition profile), so it is grounded
  * against base FHIR R4; every reference it carries (`subject`, `author`, `custodian`, section `entry`s)
@@ -420,15 +420,15 @@ interface BuildCompositionInput {
 declare function buildComposition(rng: Rng, input: BuildCompositionInput): FhirComplex;
 
 /**
- * The **round-trip-through-the-parser harness** for FHIR — the headline gate for the synthetic-fixture
- * generator. A generated resource is "spec-clean" only if `@cosyte/fhir` — not
- * `@cosyte/synth`'s own opinion — reads it back, validates it, and re-serializes it byte-identically.
+ * The **round-trip-through-the-parser harness** for FHIR: the headline gate for the synthetic-fixture
+ * generator. A generated resource is "spec-clean" only if `@cosyte/fhir`, not
+ * `@cosyte/synth`'s own opinion, reads it back, validates it, and re-serializes it byte-identically.
  * This harness serializes a generated resource, parses it back, validates it (optionally against
  * supplied US Core / vendor `StructureDefinition`s), and re-serializes, reporting what the parser found
  * so a false "spec-clean" claim cannot hide.
  *
  * `@cosyte/synth` bundles **no** profile content: to validate US Core conformance, a caller supplies
- * the `StructureDefinition`s via {@link RoundTripOptions.profiles} — exactly the content-free posture of
+ * the `StructureDefinition`s via {@link RoundTripOptions.profiles}, exactly the content-free posture of
  * `@cosyte/fhir.validateResource({ profiles })`.
  *
  * @module
@@ -437,7 +437,7 @@ declare function buildComposition(rng: Rng, input: BuildCompositionInput): FhirC
 /** Options for {@link roundTrip}. */
 interface RoundTripOptions {
     /**
-     * US Core / vendor profiles (`StructureDefinition`s) to validate against. **None is bundled** — a
+     * US Core / vendor profiles (`StructureDefinition`s) to validate against. **None is bundled**: a
      * caller supplies them (BYO), matching `@cosyte/fhir`'s content-free posture.
      */
     readonly profiles?: readonly StructureDefinition[];
@@ -449,7 +449,7 @@ interface RoundTripResult {
     /**
      * The validation issue codes at `error`/`fatal` severity (empty ⇒ valid). `information`/`warning`
      * findings (e.g. `MUST_SUPPORT_ABSENT`, `INVARIANT_UNCHECKED`, base `dom-6`) are advisory and are
-     * excluded here — they never make a resource invalid.
+     * excluded here: they never make a resource invalid.
      */
     readonly errors: readonly string[];
     /** All non-informational issue codes (errors **and** warnings), for the `Corpus` artifact record. */
@@ -478,10 +478,10 @@ interface RoundTripResult {
 declare function roundTrip(resource: FhirComplex, options?: RoundTripOptions): RoundTripResult;
 
 /**
- * Shared FHIR model-construction helpers — the small vocabulary every resource generator uses
+ * Shared FHIR model-construction helpers: the small vocabulary every resource generator uses
  * to build **through `@cosyte/fhir`'s own model constructors** (`complex` / `list` / `primitive` /
  * `decimal`). A generated resource is a `FhirComplex` tree assembled here and serialized by
- * `@cosyte/fhir`'s conservative writer, so it is **spec-clean by construction** — the same mechanism
+ * `@cosyte/fhir`'s conservative writer, so it is **spec-clean by construction**: the same mechanism
  * that makes the parser's emit side spec-clean. Nothing here hand-writes JSON
  * bytes.
  *
@@ -493,7 +493,7 @@ declare function roundTrip(resource: FhirComplex, options?: RoundTripOptions): R
  * @module
  */
 
-/** A named FHIR property (`{ name, value }`) — the shape `complex` consumes. */
+/** A named FHIR property (`{ name, value }`): the shape `complex` consumes. */
 type Prop = {
     readonly name: string;
     readonly value: FhirNode;
@@ -593,11 +593,11 @@ declare function codeableConcept(concept: {
 declare function reference(ref: string): FhirComplex;
 /**
  * A generated `Narrative` (`text`) with `status: "generated"` and an XHTML `div` carrying only
- * synthetic text — satisfies the base `dom-6` best-practice constraint so a generated resource is
+ * synthetic text, satisfies the base `dom-6` best-practice constraint so a generated resource is
  * robust as well as valid. The `div` is XHTML-namespaced and carries no markup beyond a paragraph, so
  * it round-trips byte-for-byte through `@cosyte/fhir`'s codec.
  *
- * @param text - The plain synthetic summary text (no PHI — it is composed from synthetic values).
+ * @param text - The plain synthetic summary text (no PHI: it is composed from synthetic values).
  * @returns A `Narrative` `FhirComplex`.
  * @example
  * ```ts
@@ -620,9 +620,9 @@ declare function narrative(text: string): FhirComplex;
  * ```
  */
 declare function meta(profiles: readonly string[]): FhirComplex;
-/** A synthetic FHIR patient identity — every field drawn from `../safe`. */
+/** A synthetic FHIR patient identity: every field drawn from `../safe`. */
 interface FhirPatientIdentity {
-    /** A synthetic resource `id` (a seeded UUID) — never a real record key. */
+    /** A synthetic resource `id` (a seeded UUID), never a real record key. */
     readonly id: string;
     /** Name from the shipped fake-name pool. */
     readonly person: SyntheticName;
@@ -653,7 +653,7 @@ interface FhirPatientIdentity {
 declare function toFhirDate(ymd: string): string;
 /**
  * Mint a complete synthetic {@link FhirPatientIdentity}. Every value comes from a synthetic-safety
- * provider — no code path here can return a real or plausibly-real identifier. The draw
+ * provider, no code path here can return a real or plausibly-real identifier. The draw
  * order is fixed (id → name → MRN → DOB → gender → address → phone → email) so the same seed yields the
  * same identity.
  *
@@ -667,7 +667,7 @@ declare function toFhirDate(ymd: string): string;
  */
 declare function fhirPatientIdentity(rng: Rng): FhirPatientIdentity;
 /**
- * The US Core Patient `identifier` element for a synthetic MRN — `type` (`MR`), the synthetic
+ * The US Core Patient `identifier` element for a synthetic MRN: `type` (`MR`), the synthetic
  * assigning-authority OID as `system`, and the synthetic value. Satisfies US Core Patient's required
  * `identifier.system` + `identifier.value`.
  *
@@ -683,18 +683,18 @@ declare function fhirPatientIdentity(rng: Rng): FhirPatientIdentity;
 declare function mrnIdentifier(mrn: SyntheticIdentifier): FhirComplex;
 
 /**
- * US Core + base-FHIR **canonical URLs and code-system identifiers** — the facts `@cosyte/synth` needs
+ * US Core + base-FHIR **canonical URLs and code-system identifiers**: the facts `@cosyte/synth` needs
  * to emit US-Core-conformant resources, and nothing more.
  *
- * **Content-free, exactly like `@cosyte/fhir`.** These are *identifiers* — canonical URLs and code
- * `system` URIs — not the copyrighted terminology tables or the profile `StructureDefinition` content
+ * **Content-free, exactly like `@cosyte/fhir`.** These are *identifiers*: canonical URLs and code
+ * `system` URIs, not the copyrighted terminology tables or the profile `StructureDefinition` content
  * they name. `@cosyte/synth` bundles **no** US Core IG: a consumer who wants to *validate* generated
  * output against US Core supplies the `StructureDefinition`s themselves (BYO), exactly as
  * `@cosyte/fhir.validateResource({ profiles })` requires. What is encoded here is only which canonical
- * URL a resource's `meta.profile` claims and which `system` a coding carries — public facts.
+ * URL a resource's `meta.profile` claims and which `system` a coding carries: public facts.
  *
  * The URLs target **US Core 6.1.0** (the USCDI v3 / ONC HTI-1 §170.315(g)(10) anchor, FHIR R4 4.0.1),
- * grounded firsthand against the published IG (`hl7.org/fhir/us/core/STU6.1`) — the same version the
+ * grounded firsthand against the published IG (`hl7.org/fhir/us/core/STU6.1`): the same version the
  * test corpus validates against.
  *
  * @module
@@ -730,7 +730,7 @@ declare const US_CORE_ETHNICITY_EXTENSION = "http://hl7.org/fhir/us/core/Structu
 declare const US_CORE_BIRTHSEX_EXTENSION = "http://hl7.org/fhir/us/core/StructureDefinition/us-core-birthsex";
 /**
  * The code-system `system` URIs the generators reference. Public identity URIs (HL7-published),
- * never the code-system *content* — no SNOMED/LOINC/RxNorm table is bundled.
+ * never the code-system *content*, no SNOMED/LOINC/RxNorm table is bundled.
  */
 declare const SYSTEM: Readonly<{
     /** FHIR `administrative-gender` (`Patient.gender`). */
@@ -747,23 +747,23 @@ declare const SYSTEM: Readonly<{
     readonly IDENTIFIER_TYPE: "http://terminology.hl7.org/CodeSystem/v2-0203";
     /** OMB race & ethnicity category system (US Core race/ethnicity `ombCategory`). */
     readonly OMB_RACE_ETHNICITY: "urn:oid:2.16.840.1.113883.6.238";
-    /** LOINC — `Observation.code` (lab + vital-signs). */
+    /** LOINC, `Observation.code` (lab + vital-signs). */
     readonly LOINC: "http://loinc.org";
-    /** SNOMED CT — `Condition.code`. */
+    /** SNOMED CT, `Condition.code`. */
     readonly SNOMED: "http://snomed.info/sct";
-    /** RxNorm — `MedicationRequest.medicationCodeableConcept` + an allergen substance. */
+    /** RxNorm, `MedicationRequest.medicationCodeableConcept` + an allergen substance. */
     readonly RXNORM: "http://www.nlm.nih.gov/research/umls/rxnorm";
-    /** UCUM — `Quantity.system` for units of measure. */
+    /** UCUM, `Quantity.system` for units of measure. */
     readonly UCUM: "http://unitsofmeasure.org";
-    /** CVX (CDC vaccine administered) — `Immunization.vaccineCode`. */
+    /** CVX (CDC vaccine administered), `Immunization.vaccineCode`. */
     readonly CVX: "http://hl7.org/fhir/sid/cvx";
-    /** HL7 v3 `ActCode` — `Encounter.class`. */
+    /** HL7 v3 `ActCode`, `Encounter.class`. */
     readonly 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`). */
     readonly DIAGNOSTIC_SERVICE_SECTION: "http://terminology.hl7.org/CodeSystem/v2-0074";
-    /** HL7 Terminology `allergyintolerance-clinical` — `AllergyIntolerance.clinicalStatus`. */
+    /** HL7 Terminology `allergyintolerance-clinical`, `AllergyIntolerance.clinicalStatus`. */
     readonly ALLERGY_CLINICAL: "http://terminology.hl7.org/CodeSystem/allergyintolerance-clinical";
-    /** HL7 Terminology `allergyintolerance-verification` — `AllergyIntolerance.verificationStatus`. */
+    /** HL7 Terminology `allergyintolerance-verification`, `AllergyIntolerance.verificationStatus`. */
     readonly ALLERGY_VERIFICATION: "http://terminology.hl7.org/CodeSystem/allergyintolerance-verification";
 }>;
 /** A US Core profile canonical URL. */

package/dist/fhir/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.
    */
@@ -112,7 +112,7 @@ function createRng(seed) {
 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"
@@ -421,23 +421,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"
 });