@cosyte/synth 0.0.7 → 0.0.8

package/dist/astm/index.d.cts

@@ -1,8 +1,8 @@
-import { S as SyntheticName, R as Rng, C as Corpus } from '../providers-OLz3zAc-.cjs';
-import { Q as QuirkDescriptor, S as SynthProfile, a as QuirkArtifact, b as QuirkRoundTripResult } from '../quirk-DYMDojVw.cjs';
+import { S as SyntheticName, R as Rng, C as Corpus } from '../providers-B9uVinAe.cjs';
+import { Q as QuirkDescriptor, S as SynthProfile, a as QuirkArtifact, b as QuirkRoundTripResult } from '../quirk-IaHp4z7N.cjs';
 
 /**
- * Spec-clean ASTM (E1394 / CLSI LIS02) message generation — the `H`/`P`/`O`/`R`/`C`/`L` record report —
+ * Spec-clean ASTM (E1394 / CLSI LIS02) message generation: the `H`/`P`/`O`/`R`/`C`/`L` record report,
  * built through `@cosyte/astm`'s `buildAstmMessage` so the delimiter declaration (`H|\^&`), the record
  * type letters, the per-type sequence counters, the `L` terminator, and every escape are the parser's
  * own conservative emit. Nothing clinical is defaulted: a
@@ -10,8 +10,8 @@ import { Q as QuirkDescriptor, S as SynthProfile, a as QuirkArtifact, b as Quirk
  *
  * A framed **E1381 / CLSI LIS01** variant is also offered ({@link generateAstmResultFramed}) via
  * `composeAstmFrames`, which frames each record into `<STX> FN text <ETB|ETX> CS <CR><LF>` with the
- * **modulo-256 checksum and the `0`–`7` frame number computed by the parser** — never faked. Both round
- * trip through `@cosyte/astm` cleanly (`parseAstmRecords` / `parseFramedAstm` — see `./round-trip`).
+ * **modulo-256 checksum and the `0`–`7` frame number computed by the parser**, never faked. Both round
+ * trip through `@cosyte/astm` cleanly (`parseAstmRecords` / `parseFramedAstm`: see `./round-trip`).
  *
  * Every value at a PHI-bearing locus (the `P` record's name / DOB / practice+lab IDs) is
  * drawn from the synthetic-safety providers via `./identity`, so no output can be real or plausibly-real
@@ -22,7 +22,7 @@ import { Q as QuirkDescriptor, S as SynthProfile, a as QuirkArtifact, b as Quirk
  */
 /** Options for the ASTM message generators. */
 interface GenerateAstmOptions {
-    /** The seed (deterministic — same seed yields a byte-identical message). */
+    /** The seed (deterministic: same seed yields a byte-identical message). */
     readonly seed: number;
     /** How many `R` (result) records to emit. Defaults to a seeded 1–4. */
     readonly resultCount?: number;
@@ -30,7 +30,7 @@ interface GenerateAstmOptions {
     readonly comment?: boolean;
 }
 /**
- * Generate a spec-clean ASTM **result message** — an `H`/`P`/`O`/`R`…/`C`/`L` record stream — built
+ * Generate a spec-clean ASTM **result message**: an `H`/`P`/`O`/`R`…/`C`/`L` record stream, built
  * through `@cosyte/astm`'s `buildAstmMessage`. Every identity value is synthetic-by-construction; the message
  * round-trips through `parseAstmRecords` with zero warnings and re-serializes
  * byte-identically (see `./round-trip`).
@@ -45,7 +45,7 @@ interface GenerateAstmOptions {
  */
 declare function generateAstmResult(options: GenerateAstmOptions): string;
 /**
- * Generate a spec-clean ASTM **order message** — an `H`/`P`/`O`/`L` record stream with no results, for
+ * Generate a spec-clean ASTM **order message**: an `H`/`P`/`O`/`L` record stream with no results, for
  * the order side of the flow. Built through `buildAstmMessage`; synthetic-by-construction; round-trips
  * clean.
  *
@@ -59,10 +59,10 @@ declare function generateAstmResult(options: GenerateAstmOptions): string;
  */
 declare function generateAstmOrder(options: GenerateAstmOptions): string;
 /**
- * Generate a spec-clean **framed** ASTM result message — the same `H`/`P`/`O`/`R`…/`C`/`L` records,
+ * Generate a spec-clean **framed** ASTM result message: the same `H`/`P`/`O`/`R`…/`C`/`L` records,
  * wrapped in the **E1381 / CLSI LIS01** frame envelope (`<STX> FN text <ETB|ETX> CS <CR><LF>`) via
  * `@cosyte/astm`'s `composeAstmFrames`. The **modulo-256 checksum and the `0`–`7` frame number are
- * computed by the parser** (never hand-written), and a record over 240 bytes is split across frames —
+ * computed by the parser** (never hand-written), and a record over 240 bytes is split across frames,
  * so the bytes round-trip through `parseFramedAstm` with zero frame **and** record warnings (see
  * `./round-trip`). Each record is framed independently (one `ETX`-closed run per record), mirroring what
  * `decodeAstmFrames` reassembles.
@@ -72,21 +72,21 @@ declare function generateAstmOrder(options: GenerateAstmOptions): string;
  * @example
  * ```ts
  * import { generateAstmResultFramed } from "@cosyte/synth/astm";
- * const bytes = generateAstmResultFramed({ seed: 42 }); // Uint8Array — E1381 framed
+ * const bytes = generateAstmResultFramed({ seed: 42 }); // Uint8Array, E1381 framed
  * ```
  */
 declare function generateAstmResultFramed(options: GenerateAstmOptions): Uint8Array;
 
 /**
- * The **round-trip-through-the-parser harness** for ASTM — the headline gate for the synthetic-fixture
+ * The **round-trip-through-the-parser harness** for ASTM: the headline gate for the synthetic-fixture
  * generator. A generated ASTM record stream (or framed byte stream) is "spec-clean" only
- * if `@cosyte/astm` — not `@cosyte/synth`'s own opinion — reads it back cleanly. Each harness parses the
+ * if `@cosyte/astm`, not `@cosyte/synth`'s own opinion, reads it back cleanly. Each harness parses the
  * generated wire straight back through the parser and reports what it found, so a false "spec-clean"
  * claim cannot hide.
  *
  * The **record** layer (E1394) and the **frame** layer (E1381) are separate concerns, so each gets its
  * own harness; both report the same {@link AstmRoundTripResult} shape (the framed one additionally folds
- * the frame-layer warnings — bad checksum, sequence gap, unterminated, oversize — into `warnings`, so a
+ * the frame-layer warnings (bad checksum, sequence gap, unterminated, oversize) into `warnings`, so a
  * framing defect is caught by the same gate).
  *
  * @module
@@ -122,7 +122,7 @@ declare function astmRoundTrip(raw: string): AstmRoundTripResult;
  * byte-identically.
  *
  * @param bytes - The framed byte stream (typically from `generateAstmResultFramed`).
- * @returns The {@link AstmRoundTripResult} — `content` holds the framed bytes decoded as latin1.
+ * @returns The {@link AstmRoundTripResult}: `content` holds the framed bytes decoded as latin1.
  * @example
  * ```ts
  * import { generateAstmResultFramed, astmFramedRoundTrip } from "@cosyte/synth/astm";
@@ -132,7 +132,7 @@ declare function astmRoundTrip(raw: string): AstmRoundTripResult;
 declare function astmFramedRoundTrip(bytes: Uint8Array): AstmRoundTripResult;
 
 /**
- * Synthetic identity for ASTM (E1394 / CLSI LIS02) messages — every value `synth` puts into a `P`
+ * Synthetic identity for ASTM (E1394 / CLSI LIS02) messages: every value `synth` puts into a `P`
  * (patient) record, an `O` (order) accession, or the `H` header is minted here, and **only** from the
  * synthetic-safety providers. ASTM's PHI-dense locus is the **`P` record**: it carries the
  * patient **name** (`Last^First^Middle`), **birthdate**, **sex**, and the **practice-assigned** and
@@ -146,7 +146,7 @@ declare function astmFramedRoundTrip(bytes: Uint8Array): AstmRoundTripResult;
  * @module
  */
 
-/** A synthetic ASTM patient — every field drawn from `../safe`. */
+/** A synthetic ASTM patient: every field drawn from `../safe`. */
 interface AstmPatient {
     /** Name from the shipped fake-name pool, plus a fictional middle initial. */
     readonly person: SyntheticName;
@@ -154,21 +154,21 @@ interface AstmPatient {
     readonly middle: string;
     /** Birthdate `YYYYMMDD`, from the seeded generator (no real event implied). */
     readonly birthDate: string;
-    /** Sex code, emitted verbatim (`M` / `F` — structural, never defaulted by the builder). */
+    /** Sex code, emitted verbatim (`M` / `F`, structural, never defaulted by the builder). */
     readonly sex: "M" | "F";
-    /** Practice-assigned patient ID — synthetic-AA scoped (`PRA`-prefixed). Distinct from the lab ID. */
+    /** Practice-assigned patient ID, synthetic-AA scoped (`PRA`-prefixed). Distinct from the lab ID. */
     readonly practiceAssignedId: string;
-    /** Laboratory-assigned patient ID — synthetic-AA scoped (`LAB`-prefixed). Distinct from the practice ID. */
+    /** Laboratory-assigned patient ID, synthetic-AA scoped (`LAB`-prefixed). Distinct from the practice ID. */
     readonly laboratoryAssignedId: string;
 }
-/** A synthetic ASTM order identity — the specimen / accession id and priority. */
+/** A synthetic ASTM order identity: the specimen / accession id and priority. */
 interface AstmOrder {
-    /** Specimen / accession id — synthetic-AA scoped (`ACC`-prefixed). */
+    /** Specimen / accession id: synthetic-AA scoped (`ACC`-prefixed). */
     readonly specimenId: string;
     /** Priority code, emitted verbatim (`R` routine, `S` stat). */
     readonly priority: "R" | "S";
 }
-/** A synthetic ASTM header identity — the sender and analyzer strings for the `H` record. */
+/** A synthetic ASTM header identity: the sender and analyzer strings for the `H` record. */
 interface AstmHeaderIdentity {
     /** The sending system id (clearly synthetic). */
     readonly sender: string;
@@ -191,7 +191,7 @@ interface AstmHeaderIdentity {
  */
 declare function astmPatient(rng: Rng): AstmPatient;
 /**
- * Mint a synthetic order identity for an `O` record — a synthetic-AA-scoped accession id and a priority.
+ * Mint a synthetic order identity for an `O` record: a synthetic-AA-scoped accession id and a priority.
  *
  * @param rng - The seeded generator.
  * @returns A synthetic {@link AstmOrder}.
@@ -204,7 +204,7 @@ declare function astmPatient(rng: Rng): AstmPatient;
  */
 declare function astmOrder(rng: Rng): AstmOrder;
 /**
- * Mint a synthetic header identity for the `H` record — a clearly-synthetic sender and analyzer.
+ * Mint a synthetic header identity for the `H` record: a clearly-synthetic sender and analyzer.
  *
  * @param rng - The seeded generator.
  * @returns A synthetic {@link AstmHeaderIdentity}.
@@ -218,18 +218,18 @@ declare function astmOrder(rng: Rng): AstmOrder;
 declare function astmHeaderIdentity(rng: Rng): AstmHeaderIdentity;
 
 /**
- * A small, **license-clean** pool of example ASTM laboratory tests — the analyte codes, units, and
+ * A small, **license-clean** pool of example ASTM laboratory tests: the analyte codes, units, and
  * plausible value ranges `synth` draws on when populating `O` (order) and `R` (result) records. The
  * codes are **facts** (a LOINC number is a public identifier, and the local analyzer codes here are
- * invented), never a bundled terminology table. Nothing clinical is asserted — a `synth` result pairs a value
+ * invented), never a bundled terminology table. Nothing clinical is asserted: a `synth` result pairs a value
  * and a code with no claim of clinical coherence: the pool exists only to make a *structurally* realistic
  * result record.
  *
  * @module
  */
-/** One example laboratory analyte — its codes, units, reference range, and a seeded value window. */
+/** One example laboratory analyte: its codes, units, reference range, and a seeded value window. */
 interface AstmExampleTest {
-    /** A local analyzer test code (invented — never a real vendor assay id). */
+    /** A local analyzer test code (invented, never a real vendor assay id). */
     readonly localCode: string;
     /** The public LOINC identifier for the analyte (a fact, not bundled terminology prose). */
     readonly loinc: string;
@@ -248,7 +248,7 @@ interface AstmExampleTest {
 }
 /**
  * The example test pool. A handful of common chemistry/hematology analytes, each with a public LOINC
- * code, invented local code, units, and a value window the seeded generator samples. Frozen — the pool
+ * code, invented local code, units, and a value window the seeded generator samples. Frozen: the pool
  * is shared, immutable data.
  *
  * @example
@@ -262,14 +262,14 @@ declare const EXAMPLE_ASTM_TESTS: readonly AstmExampleTest[];
 declare const ASTM_ABNORMAL_FLAGS: readonly string[];
 /** Result-status codes `synth` draws from (`F` final, `P` preliminary, `C` correction). */
 declare const ASTM_RESULT_STATUSES: readonly string[];
-/** Free-text result comments — clearly synthetic, carry no PHI. */
+/** Free-text result comments: clearly synthetic, carry no PHI. */
 declare const ASTM_COMMENT_TEXT: readonly string[];
 
 /**
  * ASTM E1394 **vendor-quirk generation**. A quirk deviates the
  * *structure* of an otherwise spec-clean record report (built through `@cosyte/astm`'s
  * `buildAstmMessage`) so it round-trips through `parseAstmRecords` to **exactly** one intended, stable
- * warning code — a code in the parser's `defineAstmProfile` tolerable set. Where a built-in public
+ * warning code: a code in the parser's `defineAstmProfile` tolerable set. Where a built-in public
  * profile tolerates the quirk, the warning is **re-badged** to the value-free `PROFILE_QUIRK_APPLIED`
  * marker (`expected: true`), exactly as the parser's `profileQuirkApplied` does.
  *
@@ -280,11 +280,11 @@ declare const ASTM_COMMENT_TEXT: readonly string[];
  *   `referenceCorpus` profile (the redistributable kxepal/python-astm + senaite OSS corpus), which
  *   re-badges it.
  * - **`unknown-record-type`** → `ASTM_RECORD_UNKNOWN_TYPE`. A record's leading type letter is changed to
- *   a site-defined `Z` — a real ASTM tolerance (the parser's tolerable set includes this code), but no
+ *   a site-defined `Z`: a real ASTM tolerance (the parser's tolerable set includes this code), but no
  *   built-in profile tolerates it, so it is a `"bare"` quirk (a consumer authors a `defineAstmProfile`
  *   to re-badge it).
  *
- * A quirk **never** introduces a real-looking value — it changes an escape body or a record type letter,
+ * A quirk **never** introduces a real-looking value: it changes an escape body or a record type letter,
  * never a P-record identity locus, so the synthetic-safety gate still runs and stays zero.
  *
  * @module
@@ -293,16 +293,16 @@ declare const ASTM_COMMENT_TEXT: readonly string[];
 /** Every ASTM quirk this package ships. */
 type AstmQuirkName = "unknown-escape" | "unknown-record-type";
 /**
- * Both shipped ASTM quirks are **result-report** deviations — `unknown-escape` targets an `R` record's
+ * Both shipped ASTM quirks are **result-report** deviations: `unknown-escape` targets an `R` record's
  * units field and `unknown-record-type` a `C` (comment) record, neither of which an *order* report
  * carries. So the quirk base is always a result report (`generateAstmResult`).
  */
 type AstmQuirkKind = "Result";
-/** The ASTM quirk registry — each recipe bound to the exact `@cosyte/astm` warning code it targets. */
+/** The ASTM quirk registry: each recipe bound to the exact `@cosyte/astm` warning code it targets. */
 declare const ASTM_QUIRKS: Readonly<Record<AstmQuirkName, QuirkDescriptor>>;
 /** Options for {@link generateAstmQuirk}. */
 interface GenerateAstmQuirkOptions {
-    /** The seed — the same seed + quirk yields a byte-identical record stream. Defaults to `0`. */
+    /** The seed: the same seed + quirk yields a byte-identical record stream. Defaults to `0`. */
     readonly seed?: number;
     /** The quirk to inject. Required. */
     readonly quirk: AstmQuirkName;
@@ -314,21 +314,21 @@ interface GenerateAstmQuirkOptions {
  * the requested vendor deviation injected post-serialize. Deterministic in `seed` + `quirk` + `kind`.
  *
  * @param options - Seed, quirk, and base kind. See {@link GenerateAstmQuirkOptions}.
- * @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 ASTM quirk.
  * @throws Error if the base report does not contain the structural anchor the quirk targets.
  * @example
  * ```ts
  * import { generateAstmQuirk, astmQuirkRoundTrip } from "@cosyte/synth/astm";
  * const rt = astmQuirkRoundTrip(generateAstmQuirk({ seed: 1, quirk: "unknown-escape" }));
- * rt.withProfile?.tolerated; // true — `referenceCorpus` re-badges ASTM_UNKNOWN_ESCAPE_SEQUENCE
+ * rt.withProfile?.tolerated; // true, `referenceCorpus` re-badges ASTM_UNKNOWN_ESCAPE_SEQUENCE
  * ```
  */
 declare function generateAstmQuirk(options: GenerateAstmQuirkOptions): QuirkArtifact;
 /**
  * Round-trip an ASTM quirk artifact through `@cosyte/astm` and report the intended-warning verdict: a bare
- * parse must produce **exactly** the intended code, and — when a built-in public
- * profile tolerates the quirk — the profiled parse must re-badge it to `PROFILE_QUIRK_APPLIED`.
+ * parse must produce **exactly** the intended code, and, when a built-in public
+ * profile tolerates the quirk, the profiled parse must re-badge it to `PROFILE_QUIRK_APPLIED`.
  *
  * @param artifact - The quirk artifact (from {@link generateAstmQuirk}).
  * @returns The {@link QuirkRoundTripResult}.
@@ -367,28 +367,28 @@ declare function astmQuirkCorpus(options: AstmQuirkCorpusOptions): Corpus;
 declare const astmQuirkProfile: SynthProfile;
 
 /**
- * `@cosyte/synth/astm` — the ASTM generation surface, exposed as its own subpath so importing the
+ * `@cosyte/synth/astm`: the ASTM generation surface, exposed as its own subpath so importing the
  * package root does **not** pull `@cosyte/astm`. This is the **lazy, per-format** boundary: a consumer
  * who only needs ASTM fixtures imports `@cosyte/synth/astm`; one who needs only the core primitives
  * never loads a parser.
- * `@cosyte/astm` is an **optional peer dependency** — present only for this subpath.
+ * `@cosyte/astm` is an **optional peer dependency**, present only for this subpath.
  *
  * This subpath ships spec-clean generation of the E1394 record report and its E1381 framed twin, each
  * built through `@cosyte/astm`'s own emit surface:
  *
  * - **Records (E1394):** `generateAstmResult` (`H`/`P`/`O`/`R`…/`C`/`L`) and `generateAstmOrder`
- *   (`H`/`P`/`O`/`L`) via `buildAstmMessage` — each round-tripping through `parseAstmRecords` with zero
+ *   (`H`/`P`/`O`/`L`) via `buildAstmMessage`, each round-tripping through `parseAstmRecords` with zero
  *   warnings and byte-stable, and carrying a `P` record whose name / DOB / practice+lab IDs are all
  *   synthetic-by-construction. The practice- and laboratory-assigned patient IDs are
  *   minted independently, so they stay **distinct**.
- * - **Framing (E1381):** `generateAstmResultFramed` via `composeAstmFrames` — the modulo-256 checksum
+ * - **Framing (E1381):** `generateAstmResultFramed` via `composeAstmFrames`, the modulo-256 checksum
  *   and the `0`–`7` frame number are **computed by the parser, never faked**, and the bytes round-trip
  *   through `parseFramedAstm` with zero frame **and** record warnings.
  *
  * @module
  */
 
-/** Every ASTM message kind {@link astmCorpus} generates — the label used as the corpus `kind`. */
+/** Every ASTM message kind {@link astmCorpus} generates: the label used as the corpus `kind`. */
 type AstmCorpusKind = "Result" | "Order";
 /** Options for {@link astmCorpus}. */
 interface AstmCorpusOptions {
@@ -410,7 +410,7 @@ interface AstmCorpusOptions {
  * ```ts
  * import { astmCorpus } from "@cosyte/synth/astm";
  * const corpus = astmCorpus({ 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 astmCorpus(options: AstmCorpusOptions): Corpus;

package/dist/astm/index.d.ts

@@ -1,8 +1,8 @@
-import { S as SyntheticName, R as Rng, C as Corpus } from '../providers-OLz3zAc-.js';
-import { Q as QuirkDescriptor, S as SynthProfile, a as QuirkArtifact, b as QuirkRoundTripResult } from '../quirk-C9t9CkPS.js';
+import { S as SyntheticName, R as Rng, C as Corpus } from '../providers-B9uVinAe.js';
+import { Q as QuirkDescriptor, S as SynthProfile, a as QuirkArtifact, b as QuirkRoundTripResult } from '../quirk-HZdznAkM.js';
 
 /**
- * Spec-clean ASTM (E1394 / CLSI LIS02) message generation — the `H`/`P`/`O`/`R`/`C`/`L` record report —
+ * Spec-clean ASTM (E1394 / CLSI LIS02) message generation: the `H`/`P`/`O`/`R`/`C`/`L` record report,
  * built through `@cosyte/astm`'s `buildAstmMessage` so the delimiter declaration (`H|\^&`), the record
  * type letters, the per-type sequence counters, the `L` terminator, and every escape are the parser's
  * own conservative emit. Nothing clinical is defaulted: a
@@ -10,8 +10,8 @@ import { Q as QuirkDescriptor, S as SynthProfile, a as QuirkArtifact, b as Quirk
  *
  * A framed **E1381 / CLSI LIS01** variant is also offered ({@link generateAstmResultFramed}) via
  * `composeAstmFrames`, which frames each record into `<STX> FN text <ETB|ETX> CS <CR><LF>` with the
- * **modulo-256 checksum and the `0`–`7` frame number computed by the parser** — never faked. Both round
- * trip through `@cosyte/astm` cleanly (`parseAstmRecords` / `parseFramedAstm` — see `./round-trip`).
+ * **modulo-256 checksum and the `0`–`7` frame number computed by the parser**, never faked. Both round
+ * trip through `@cosyte/astm` cleanly (`parseAstmRecords` / `parseFramedAstm`: see `./round-trip`).
  *
  * Every value at a PHI-bearing locus (the `P` record's name / DOB / practice+lab IDs) is
  * drawn from the synthetic-safety providers via `./identity`, so no output can be real or plausibly-real
@@ -22,7 +22,7 @@ import { Q as QuirkDescriptor, S as SynthProfile, a as QuirkArtifact, b as Quirk
  */
 /** Options for the ASTM message generators. */
 interface GenerateAstmOptions {
-    /** The seed (deterministic — same seed yields a byte-identical message). */
+    /** The seed (deterministic: same seed yields a byte-identical message). */
     readonly seed: number;
     /** How many `R` (result) records to emit. Defaults to a seeded 1–4. */
     readonly resultCount?: number;
@@ -30,7 +30,7 @@ interface GenerateAstmOptions {
     readonly comment?: boolean;
 }
 /**
- * Generate a spec-clean ASTM **result message** — an `H`/`P`/`O`/`R`…/`C`/`L` record stream — built
+ * Generate a spec-clean ASTM **result message**: an `H`/`P`/`O`/`R`…/`C`/`L` record stream, built
  * through `@cosyte/astm`'s `buildAstmMessage`. Every identity value is synthetic-by-construction; the message
  * round-trips through `parseAstmRecords` with zero warnings and re-serializes
  * byte-identically (see `./round-trip`).
@@ -45,7 +45,7 @@ interface GenerateAstmOptions {
  */
 declare function generateAstmResult(options: GenerateAstmOptions): string;
 /**
- * Generate a spec-clean ASTM **order message** — an `H`/`P`/`O`/`L` record stream with no results, for
+ * Generate a spec-clean ASTM **order message**: an `H`/`P`/`O`/`L` record stream with no results, for
  * the order side of the flow. Built through `buildAstmMessage`; synthetic-by-construction; round-trips
  * clean.
  *
@@ -59,10 +59,10 @@ declare function generateAstmResult(options: GenerateAstmOptions): string;
  */
 declare function generateAstmOrder(options: GenerateAstmOptions): string;
 /**
- * Generate a spec-clean **framed** ASTM result message — the same `H`/`P`/`O`/`R`…/`C`/`L` records,
+ * Generate a spec-clean **framed** ASTM result message: the same `H`/`P`/`O`/`R`…/`C`/`L` records,
  * wrapped in the **E1381 / CLSI LIS01** frame envelope (`<STX> FN text <ETB|ETX> CS <CR><LF>`) via
  * `@cosyte/astm`'s `composeAstmFrames`. The **modulo-256 checksum and the `0`–`7` frame number are
- * computed by the parser** (never hand-written), and a record over 240 bytes is split across frames —
+ * computed by the parser** (never hand-written), and a record over 240 bytes is split across frames,
  * so the bytes round-trip through `parseFramedAstm` with zero frame **and** record warnings (see
  * `./round-trip`). Each record is framed independently (one `ETX`-closed run per record), mirroring what
  * `decodeAstmFrames` reassembles.
@@ -72,21 +72,21 @@ declare function generateAstmOrder(options: GenerateAstmOptions): string;
  * @example
  * ```ts
  * import { generateAstmResultFramed } from "@cosyte/synth/astm";
- * const bytes = generateAstmResultFramed({ seed: 42 }); // Uint8Array — E1381 framed
+ * const bytes = generateAstmResultFramed({ seed: 42 }); // Uint8Array, E1381 framed
  * ```
  */
 declare function generateAstmResultFramed(options: GenerateAstmOptions): Uint8Array;
 
 /**
- * The **round-trip-through-the-parser harness** for ASTM — the headline gate for the synthetic-fixture
+ * The **round-trip-through-the-parser harness** for ASTM: the headline gate for the synthetic-fixture
  * generator. A generated ASTM record stream (or framed byte stream) is "spec-clean" only
- * if `@cosyte/astm` — not `@cosyte/synth`'s own opinion — reads it back cleanly. Each harness parses the
+ * if `@cosyte/astm`, not `@cosyte/synth`'s own opinion, reads it back cleanly. Each harness parses the
  * generated wire straight back through the parser and reports what it found, so a false "spec-clean"
  * claim cannot hide.
  *
  * The **record** layer (E1394) and the **frame** layer (E1381) are separate concerns, so each gets its
  * own harness; both report the same {@link AstmRoundTripResult} shape (the framed one additionally folds
- * the frame-layer warnings — bad checksum, sequence gap, unterminated, oversize — into `warnings`, so a
+ * the frame-layer warnings (bad checksum, sequence gap, unterminated, oversize) into `warnings`, so a
  * framing defect is caught by the same gate).
  *
  * @module
@@ -122,7 +122,7 @@ declare function astmRoundTrip(raw: string): AstmRoundTripResult;
  * byte-identically.
  *
  * @param bytes - The framed byte stream (typically from `generateAstmResultFramed`).
- * @returns The {@link AstmRoundTripResult} — `content` holds the framed bytes decoded as latin1.
+ * @returns The {@link AstmRoundTripResult}: `content` holds the framed bytes decoded as latin1.
  * @example
  * ```ts
  * import { generateAstmResultFramed, astmFramedRoundTrip } from "@cosyte/synth/astm";
@@ -132,7 +132,7 @@ declare function astmRoundTrip(raw: string): AstmRoundTripResult;
 declare function astmFramedRoundTrip(bytes: Uint8Array): AstmRoundTripResult;
 
 /**
- * Synthetic identity for ASTM (E1394 / CLSI LIS02) messages — every value `synth` puts into a `P`
+ * Synthetic identity for ASTM (E1394 / CLSI LIS02) messages: every value `synth` puts into a `P`
  * (patient) record, an `O` (order) accession, or the `H` header is minted here, and **only** from the
  * synthetic-safety providers. ASTM's PHI-dense locus is the **`P` record**: it carries the
  * patient **name** (`Last^First^Middle`), **birthdate**, **sex**, and the **practice-assigned** and
@@ -146,7 +146,7 @@ declare function astmFramedRoundTrip(bytes: Uint8Array): AstmRoundTripResult;
  * @module
  */
 
-/** A synthetic ASTM patient — every field drawn from `../safe`. */
+/** A synthetic ASTM patient: every field drawn from `../safe`. */
 interface AstmPatient {
     /** Name from the shipped fake-name pool, plus a fictional middle initial. */
     readonly person: SyntheticName;
@@ -154,21 +154,21 @@ interface AstmPatient {
     readonly middle: string;
     /** Birthdate `YYYYMMDD`, from the seeded generator (no real event implied). */
     readonly birthDate: string;
-    /** Sex code, emitted verbatim (`M` / `F` — structural, never defaulted by the builder). */
+    /** Sex code, emitted verbatim (`M` / `F`, structural, never defaulted by the builder). */
     readonly sex: "M" | "F";
-    /** Practice-assigned patient ID — synthetic-AA scoped (`PRA`-prefixed). Distinct from the lab ID. */
+    /** Practice-assigned patient ID, synthetic-AA scoped (`PRA`-prefixed). Distinct from the lab ID. */
     readonly practiceAssignedId: string;
-    /** Laboratory-assigned patient ID — synthetic-AA scoped (`LAB`-prefixed). Distinct from the practice ID. */
+    /** Laboratory-assigned patient ID, synthetic-AA scoped (`LAB`-prefixed). Distinct from the practice ID. */
     readonly laboratoryAssignedId: string;
 }
-/** A synthetic ASTM order identity — the specimen / accession id and priority. */
+/** A synthetic ASTM order identity: the specimen / accession id and priority. */
 interface AstmOrder {
-    /** Specimen / accession id — synthetic-AA scoped (`ACC`-prefixed). */
+    /** Specimen / accession id: synthetic-AA scoped (`ACC`-prefixed). */
     readonly specimenId: string;
     /** Priority code, emitted verbatim (`R` routine, `S` stat). */
     readonly priority: "R" | "S";
 }
-/** A synthetic ASTM header identity — the sender and analyzer strings for the `H` record. */
+/** A synthetic ASTM header identity: the sender and analyzer strings for the `H` record. */
 interface AstmHeaderIdentity {
     /** The sending system id (clearly synthetic). */
     readonly sender: string;
@@ -191,7 +191,7 @@ interface AstmHeaderIdentity {
  */
 declare function astmPatient(rng: Rng): AstmPatient;
 /**
- * Mint a synthetic order identity for an `O` record — a synthetic-AA-scoped accession id and a priority.
+ * Mint a synthetic order identity for an `O` record: a synthetic-AA-scoped accession id and a priority.
  *
  * @param rng - The seeded generator.
  * @returns A synthetic {@link AstmOrder}.
@@ -204,7 +204,7 @@ declare function astmPatient(rng: Rng): AstmPatient;
  */
 declare function astmOrder(rng: Rng): AstmOrder;
 /**
- * Mint a synthetic header identity for the `H` record — a clearly-synthetic sender and analyzer.
+ * Mint a synthetic header identity for the `H` record: a clearly-synthetic sender and analyzer.
  *
  * @param rng - The seeded generator.
  * @returns A synthetic {@link AstmHeaderIdentity}.
@@ -218,18 +218,18 @@ declare function astmOrder(rng: Rng): AstmOrder;
 declare function astmHeaderIdentity(rng: Rng): AstmHeaderIdentity;
 
 /**
- * A small, **license-clean** pool of example ASTM laboratory tests — the analyte codes, units, and
+ * A small, **license-clean** pool of example ASTM laboratory tests: the analyte codes, units, and
  * plausible value ranges `synth` draws on when populating `O` (order) and `R` (result) records. The
  * codes are **facts** (a LOINC number is a public identifier, and the local analyzer codes here are
- * invented), never a bundled terminology table. Nothing clinical is asserted — a `synth` result pairs a value
+ * invented), never a bundled terminology table. Nothing clinical is asserted: a `synth` result pairs a value
  * and a code with no claim of clinical coherence: the pool exists only to make a *structurally* realistic
  * result record.
  *
  * @module
  */
-/** One example laboratory analyte — its codes, units, reference range, and a seeded value window. */
+/** One example laboratory analyte: its codes, units, reference range, and a seeded value window. */
 interface AstmExampleTest {
-    /** A local analyzer test code (invented — never a real vendor assay id). */
+    /** A local analyzer test code (invented, never a real vendor assay id). */
     readonly localCode: string;
     /** The public LOINC identifier for the analyte (a fact, not bundled terminology prose). */
     readonly loinc: string;
@@ -248,7 +248,7 @@ interface AstmExampleTest {
 }
 /**
  * The example test pool. A handful of common chemistry/hematology analytes, each with a public LOINC
- * code, invented local code, units, and a value window the seeded generator samples. Frozen — the pool
+ * code, invented local code, units, and a value window the seeded generator samples. Frozen: the pool
  * is shared, immutable data.
  *
  * @example
@@ -262,14 +262,14 @@ declare const EXAMPLE_ASTM_TESTS: readonly AstmExampleTest[];
 declare const ASTM_ABNORMAL_FLAGS: readonly string[];
 /** Result-status codes `synth` draws from (`F` final, `P` preliminary, `C` correction). */
 declare const ASTM_RESULT_STATUSES: readonly string[];
-/** Free-text result comments — clearly synthetic, carry no PHI. */
+/** Free-text result comments: clearly synthetic, carry no PHI. */
 declare const ASTM_COMMENT_TEXT: readonly string[];
 
 /**
  * ASTM E1394 **vendor-quirk generation**. A quirk deviates the
  * *structure* of an otherwise spec-clean record report (built through `@cosyte/astm`'s
  * `buildAstmMessage`) so it round-trips through `parseAstmRecords` to **exactly** one intended, stable
- * warning code — a code in the parser's `defineAstmProfile` tolerable set. Where a built-in public
+ * warning code: a code in the parser's `defineAstmProfile` tolerable set. Where a built-in public
  * profile tolerates the quirk, the warning is **re-badged** to the value-free `PROFILE_QUIRK_APPLIED`
  * marker (`expected: true`), exactly as the parser's `profileQuirkApplied` does.
  *
@@ -280,11 +280,11 @@ declare const ASTM_COMMENT_TEXT: readonly string[];
  *   `referenceCorpus` profile (the redistributable kxepal/python-astm + senaite OSS corpus), which
  *   re-badges it.
  * - **`unknown-record-type`** → `ASTM_RECORD_UNKNOWN_TYPE`. A record's leading type letter is changed to
- *   a site-defined `Z` — a real ASTM tolerance (the parser's tolerable set includes this code), but no
+ *   a site-defined `Z`: a real ASTM tolerance (the parser's tolerable set includes this code), but no
  *   built-in profile tolerates it, so it is a `"bare"` quirk (a consumer authors a `defineAstmProfile`
  *   to re-badge it).
  *
- * A quirk **never** introduces a real-looking value — it changes an escape body or a record type letter,
+ * A quirk **never** introduces a real-looking value: it changes an escape body or a record type letter,
  * never a P-record identity locus, so the synthetic-safety gate still runs and stays zero.
  *
  * @module
@@ -293,16 +293,16 @@ declare const ASTM_COMMENT_TEXT: readonly string[];
 /** Every ASTM quirk this package ships. */
 type AstmQuirkName = "unknown-escape" | "unknown-record-type";
 /**
- * Both shipped ASTM quirks are **result-report** deviations — `unknown-escape` targets an `R` record's
+ * Both shipped ASTM quirks are **result-report** deviations: `unknown-escape` targets an `R` record's
  * units field and `unknown-record-type` a `C` (comment) record, neither of which an *order* report
  * carries. So the quirk base is always a result report (`generateAstmResult`).
  */
 type AstmQuirkKind = "Result";
-/** The ASTM quirk registry — each recipe bound to the exact `@cosyte/astm` warning code it targets. */
+/** The ASTM quirk registry: each recipe bound to the exact `@cosyte/astm` warning code it targets. */
 declare const ASTM_QUIRKS: Readonly<Record<AstmQuirkName, QuirkDescriptor>>;
 /** Options for {@link generateAstmQuirk}. */
 interface GenerateAstmQuirkOptions {
-    /** The seed — the same seed + quirk yields a byte-identical record stream. Defaults to `0`. */
+    /** The seed: the same seed + quirk yields a byte-identical record stream. Defaults to `0`. */
     readonly seed?: number;
     /** The quirk to inject. Required. */
     readonly quirk: AstmQuirkName;
@@ -314,21 +314,21 @@ interface GenerateAstmQuirkOptions {
  * the requested vendor deviation injected post-serialize. Deterministic in `seed` + `quirk` + `kind`.
  *
  * @param options - Seed, quirk, and base kind. See {@link GenerateAstmQuirkOptions}.
- * @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 ASTM quirk.
  * @throws Error if the base report does not contain the structural anchor the quirk targets.
  * @example
  * ```ts
  * import { generateAstmQuirk, astmQuirkRoundTrip } from "@cosyte/synth/astm";
  * const rt = astmQuirkRoundTrip(generateAstmQuirk({ seed: 1, quirk: "unknown-escape" }));
- * rt.withProfile?.tolerated; // true — `referenceCorpus` re-badges ASTM_UNKNOWN_ESCAPE_SEQUENCE
+ * rt.withProfile?.tolerated; // true, `referenceCorpus` re-badges ASTM_UNKNOWN_ESCAPE_SEQUENCE
  * ```
  */
 declare function generateAstmQuirk(options: GenerateAstmQuirkOptions): QuirkArtifact;
 /**
  * Round-trip an ASTM quirk artifact through `@cosyte/astm` and report the intended-warning verdict: a bare
- * parse must produce **exactly** the intended code, and — when a built-in public
- * profile tolerates the quirk — the profiled parse must re-badge it to `PROFILE_QUIRK_APPLIED`.
+ * parse must produce **exactly** the intended code, and, when a built-in public
+ * profile tolerates the quirk, the profiled parse must re-badge it to `PROFILE_QUIRK_APPLIED`.
  *
  * @param artifact - The quirk artifact (from {@link generateAstmQuirk}).
  * @returns The {@link QuirkRoundTripResult}.
@@ -367,28 +367,28 @@ declare function astmQuirkCorpus(options: AstmQuirkCorpusOptions): Corpus;
 declare const astmQuirkProfile: SynthProfile;
 
 /**
- * `@cosyte/synth/astm` — the ASTM generation surface, exposed as its own subpath so importing the
+ * `@cosyte/synth/astm`: the ASTM generation surface, exposed as its own subpath so importing the
  * package root does **not** pull `@cosyte/astm`. This is the **lazy, per-format** boundary: a consumer
  * who only needs ASTM fixtures imports `@cosyte/synth/astm`; one who needs only the core primitives
  * never loads a parser.
- * `@cosyte/astm` is an **optional peer dependency** — present only for this subpath.
+ * `@cosyte/astm` is an **optional peer dependency**, present only for this subpath.
  *
  * This subpath ships spec-clean generation of the E1394 record report and its E1381 framed twin, each
  * built through `@cosyte/astm`'s own emit surface:
  *
  * - **Records (E1394):** `generateAstmResult` (`H`/`P`/`O`/`R`…/`C`/`L`) and `generateAstmOrder`
- *   (`H`/`P`/`O`/`L`) via `buildAstmMessage` — each round-tripping through `parseAstmRecords` with zero
+ *   (`H`/`P`/`O`/`L`) via `buildAstmMessage`, each round-tripping through `parseAstmRecords` with zero
  *   warnings and byte-stable, and carrying a `P` record whose name / DOB / practice+lab IDs are all
  *   synthetic-by-construction. The practice- and laboratory-assigned patient IDs are
  *   minted independently, so they stay **distinct**.
- * - **Framing (E1381):** `generateAstmResultFramed` via `composeAstmFrames` — the modulo-256 checksum
+ * - **Framing (E1381):** `generateAstmResultFramed` via `composeAstmFrames`, the modulo-256 checksum
  *   and the `0`–`7` frame number are **computed by the parser, never faked**, and the bytes round-trip
  *   through `parseFramedAstm` with zero frame **and** record warnings.
  *
  * @module
  */
 
-/** Every ASTM message kind {@link astmCorpus} generates — the label used as the corpus `kind`. */
+/** Every ASTM message kind {@link astmCorpus} generates: the label used as the corpus `kind`. */
 type AstmCorpusKind = "Result" | "Order";
 /** Options for {@link astmCorpus}. */
 interface AstmCorpusOptions {
@@ -410,7 +410,7 @@ interface AstmCorpusOptions {
  * ```ts
  * import { astmCorpus } from "@cosyte/synth/astm";
  * const corpus = astmCorpus({ 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 astmCorpus(options: AstmCorpusOptions): Corpus;