@cosyte/synth 0.0.7 → 0.0.8

package/dist/{quirk-DYMDojVw.d.cts → quirk-IaHp4z7N.d.cts}

@@ -1,7 +1,7 @@
-import { m as SynthFormat } from './providers-OLz3zAc-.cjs';
+import { m as SynthFormat } from './providers-B9uVinAe.cjs';
 
 /**
- * `defineSynthProfile` — the growth-loop hook for site/vendor fixture recipes. A profile bundles the
+ * `defineSynthProfile`: the growth-loop hook for site/vendor fixture recipes. A profile bundles the
  * value pools and the quirk recipe a fixture set should use, authored through the same public API as
  * the built-ins: a validated, frozen `SynthProfile` carrying a name, optional value overrides, and the
  * quirk names a format's quirk corpus should apply.
@@ -12,7 +12,7 @@ import { m as SynthFormat } from './providers-OLz3zAc-.cjs';
 interface SynthProfileSpec {
     /** A stable, human-readable profile name (e.g. `"acme-hospital"`). Required, non-empty. */
     readonly name: string;
-    /** Optional given-name pool override (clearly-synthetic names only — see the safety invariant). */
+    /** Optional given-name pool override (clearly-synthetic names only, see the safety invariant). */
     readonly givenNames?: readonly string[];
     /** Optional family-name pool override (clearly-synthetic names only). */
     readonly familyNames?: readonly string[];
@@ -52,9 +52,9 @@ declare function defineSynthProfile(spec: SynthProfileSpec): SynthProfile;
  * The **quirk core**. Where the spec-clean generators prove
  * *synthetic-by-construction* through each parser's own builder, the quirk layer proves the mirror
  * property: a **deliberately off-spec** fixture round-trips to **exactly the intended parser warning
- * code(s)** — no more, no fewer. The quirk vocabulary **is the parsers' own profile systems**
+ * code(s)**, no more, no fewer. The quirk vocabulary **is the parsers' own profile systems**
  * (`hl7.defineProfile`, `ccda.defineCcdaProfile`, `astm.defineAstmProfile`): a quirk exercises exactly
- * the tolerance the corresponding parser profile encodes, so a quirk fixture is never a fiction — it
+ * the tolerance the corresponding parser profile encodes, so a quirk fixture is never a fiction, it
  * targets a documented, coded leniency (the **intended-warning contract**).
  *
  * This module is the **format-agnostic** part: the descriptor a quirk carries, the artifact a quirk
@@ -65,25 +65,25 @@ declare function defineSynthProfile(spec: SynthProfileSpec): SynthProfile;
  */
 
 /**
- * How the parser's matching profile treats a quirk once it is active — the three shapes the parsers'
+ * How the parser's matching profile treats a quirk once it is active: the three shapes the parsers'
  * profile systems actually exhibit (verified firsthand against each parser):
  *
- * - `"suppressed"` — the profile makes the warning **disappear** (HL7 v2: a `defineProfile`
+ * - `"suppressed"`, the profile makes the warning **disappear** (HL7 v2: a `defineProfile`
  *   `customSegments` claim suppresses `UNKNOWN_SEGMENT` for a declared Z-segment).
- * - `"rebadged"` — the profile **downgrades** the warning to the value-free `PROFILE_QUIRK_APPLIED`
+ * - `"rebadged"`, the profile **downgrades** the warning to the value-free `PROFILE_QUIRK_APPLIED`
  *   marker with `expected: true` (C-CDA `defineCcdaProfile` / ASTM `defineAstmProfile`
  *   `profileQuirkApplied`).
- * - `"bare"` — no shipped profile tolerates it; the quirk targets a real coded leniency a consumer can
+ * - `"bare"`, no shipped profile tolerates it; the quirk targets a real coded leniency a consumer can
  *   tolerate via their own `defineProfile`/`defineAstmProfile`, but no built-in re-badges it.
  */
 type QuirkProfileDisposition = "suppressed" | "rebadged" | "bare";
 /**
  * The stable, value-free re-badge code the C-CDA and ASTM parsers emit when a profile tolerates a
- * quirk. HL7 v2 has no equivalent (it suppresses instead — see {@link QuirkProfileDisposition}).
+ * quirk. HL7 v2 has no equivalent (it suppresses instead: see {@link QuirkProfileDisposition}).
  */
 declare const PROFILE_QUIRK_APPLIED = "PROFILE_QUIRK_APPLIED";
 /**
- * A public, grounded description of one vendor quirk — the metadata that binds a quirk recipe to a real
+ * A public, grounded description of one vendor quirk: the metadata that binds a quirk recipe to a real
  * parser warning code and a **publicly-groundable** deviation (cited-public, never a private
  * vendor corpus).
  */
@@ -93,12 +93,12 @@ interface QuirkDescriptor {
     /** The format this quirk applies to. */
     readonly format: SynthFormat;
     /**
-     * The **exact** parser warning code(s) a bare parse (no profile) surfaces for this quirk — the
+     * The **exact** parser warning code(s) a bare parse (no profile) surfaces for this quirk, the
      * intended-warning contract. A quirk that produces any other code, or none, is a generation bug.
      */
     readonly intendedWarnings: readonly string[];
     /**
-     * The **public** grounding for this quirk — the spec clause or the parser's public profile that
+     * The **public** grounding for this quirk, the spec clause or the parser's public profile that
      * documents the tolerance. Never a private vendor-attributed corpus.
      */
     readonly grounding: string;
@@ -107,7 +107,7 @@ interface QuirkDescriptor {
     /** How {@link toleratingProfile} treats the quirk. */
     readonly disposition: QuirkProfileDisposition;
 }
-/** One generated quirk artifact — the off-spec wire text plus the contract it is meant to satisfy. */
+/** One generated quirk artifact: the off-spec wire text plus the contract it is meant to satisfy. */
 interface QuirkArtifact {
     /** The format this artifact belongs to. */
     readonly format: SynthFormat;
@@ -143,14 +143,14 @@ interface QuirkRoundTripResult {
     /** The exact code(s) the quirk is meant to produce. */
     readonly intendedWarnings: readonly string[];
     /**
-     * `true` iff the bare parse produced **exactly** the intended code(s) — the intended-warning contract.
+     * `true` iff the bare parse produced **exactly** the intended code(s), the intended-warning contract.
      */
     readonly intendedWarningHeld: boolean;
     /** The verdict under the tolerating profile, when a built-in public one exists. */
     readonly withProfile?: QuirkProfiledVerdict;
 }
 /**
- * Exact multiset (order-independent) equality of two code lists — the intended-warning comparison.
+ * Exact multiset (order-independent) equality of two code lists: the intended-warning comparison.
  *
  * @param a - The first code list.
  * @param b - The second code list.
@@ -164,12 +164,12 @@ interface QuirkRoundTripResult {
 declare function sameCodeSet(a: readonly string[], b: readonly string[]): boolean;
 /**
  * Resolve a requested quirk name against a format's registry, or **fail closed**. A quirk the format's
- * profile system does not support is a fatal `SYNTH_UNSUPPORTED_QUIRK` — never a silent no-op and never
+ * profile system does not support is a fatal `SYNTH_UNSUPPORTED_QUIRK`, never a silent no-op and never
  * a fabricated quirk with a made-up warning.
  *
  * The refusal names neither the request nor the registry. `registry`, `format` and `name` are all
  * caller-supplied, and a diagnostic that quotes its input is a diagnostic that can be made to carry
- * anything the caller was holding — which for a fixture generator wired into someone else's pipeline
+ * anything the caller was holding, which for a fixture generator wired into someone else's pipeline
  * is not a hypothetical. Branch on `err.code`; the supported set is the registry you passed
  * (`HL7_QUIRKS`, `CCDA_QUIRKS`, `ASTM_QUIRKS`), which you can enumerate directly.
  *
@@ -197,22 +197,22 @@ declare function resolveQuirk(registry: Readonly<Record<string, QuirkDescriptor>
  * @example
  * ```ts
  * import { profileTolerated } from "@cosyte/synth";
- * profileTolerated("suppressed", ["UNKNOWN_SEGMENT"], []); // true — the profile suppressed it
+ * profileTolerated("suppressed", ["UNKNOWN_SEGMENT"], []); // true: the profile suppressed it
  * ```
  */
 declare function profileTolerated(disposition: QuirkProfileDisposition, intendedWarnings: readonly string[], warningsUnderProfile: readonly string[]): boolean;
 /**
  * Assert a freshly-generated quirk artifact **actually** round-trips to its intended warning(s), or
  * **fail closed**. This is the generator's self-check on the intended-warning contract: a
- * fixture whose bare parse does not produce exactly the declared code(s) is a *mislabeled* fixture — a
- * golden file that lies about the parser verdict it anchors — and must never be emitted. It is a
+ * fixture whose bare parse does not produce exactly the declared code(s) is a *mislabeled* fixture, a
+ * golden file that lies about the parser verdict it anchors, and must never be emitted. It is a
  * stronger guard than "the transform changed some bytes": a transform can mutate the wrong element (a
  * template a given document type does not key its warning on) and still change bytes while producing no
  * warning. Every format's `generate*Quirk` calls this after transforming, so the contract is enforced at
  * generation time, not merely at round-trip time.
  *
- * It no longer takes the quirk name. That parameter existed for one reason — to be interpolated into
- * the refusal — and a parameter whose only job is to reach a message is the exact shape this package
+ * It no longer takes the quirk name. That parameter existed for one reason, to be interpolated into
+ * the refusal, and a parameter whose only job is to reach a message is the exact shape this package
  * is removing, so it is gone rather than merely unused. The refusal names neither code list either;
  * both are caller-supplied, and the caller reads the comparison back off the arguments it holds.
  *

package/dist/x12/index.cjs

@@ -33,15 +33,15 @@ function sfc32Next(s) {
 
 // src/codes.ts
 var SYNTH_FATAL_CODES = {
-  /** A money value could not be read as an X12 decimal. Fatal — a generator never rounds to a float. */
+  /** A money value could not be read as an X12 decimal. Fatal: a generator never rounds to a float. */
   SYNTH_INVALID_DECIMAL: "SYNTH_INVALID_DECIMAL",
   /** An integer range was requested with its maximum below its minimum. Fatal. */
   SYNTH_INVALID_RANGE: "SYNTH_INVALID_RANGE",
-  /** A value was drawn from an empty pool. Fatal — never a fabricated substitute. */
+  /** A value was drawn from an empty pool. Fatal, never a fabricated substitute. */
   SYNTH_EMPTY_POOL: "SYNTH_EMPTY_POOL",
   /**
    * A caller-supplied selector (a message kind, a document type, a corpus mix entry, a claim
-   * variant, a Bundle type, a resource profile) is not in the closed set that governs it. Fatal —
+   * variant, a Bundle type, a resource profile) is not in the closed set that governs it. Fatal:
    * see `resolveKind`: a selector union is erased at run time, and a selector that falls through
    * either mislabels the fixture or hands the value to a peer builder that quotes it back.
    */
@@ -143,7 +143,7 @@ function money(n) {
 var SYNTHETIC_ASSIGNING_AUTHORITY = Object.freeze({
   /** The human-readable assigning-authority namespace id (HL7 HD.1). */
   namespaceId: "COSYTE-SYNTH",
-  /** The universal id — an OID under HL7's example arc `2.16.840.1.113883.19` (HD.2). */
+  /** The universal id, an OID under HL7's example arc `2.16.840.1.113883.19` (HD.2). */
   universalId: "2.16.840.1.113883.19.999",
   /** The universal id type (HD.3). */
   universalIdType: "ISO"
@@ -653,7 +653,7 @@ function specOf(rng, variant) {
     claims: [
       {
         ...claim,
-        // Rendering provider (Loop 2310B, NM1 fields round-trip) — a person with an invalid-Luhn NPI.
+        // Rendering provider (Loop 2310B, NM1 fields round-trip), a person with an invalid-Luhn NPI.
         providers: [
           {
             entityIdentifierCode: "82",
@@ -680,7 +680,7 @@ function specOf(rng, variant) {
         state: org.address.state,
         postalCode: org.address.zip
       },
-      // Provider tax id as a never-issued (900-range) SSN at REF*SY — provably synthetic (roadmap §4.1).
+      // Provider tax id as a never-issued (900-range) SSN at REF*SY, provably synthetic (roadmap §4.1).
       references: [{ qualifier: "SY", value: org.taxIdSsn }]
     },
     subscribers: [subscriber]