@cosyte/synth 0.1.9 → 0.1.11

package/dist/index.d.cts

@@ -1,6 +1,117 @@
-import { s as ssn, p as phone, n as name, e as email, i as ipv4, c as ipv6, u as uuid, d as identifier, f as address, g as dateYmd, h as npi, j as dea } from './providers-B48qUwHU.cjs';
-export { A as Artifact, C as Corpus, k as CorpusManifest, R as Rng, l as SsnBlock, m as SynthFormat, b as SyntheticAddress, a as SyntheticIdentifier, S as SyntheticName, o as createRng, q as makeCorpus } from './providers-B48qUwHU.cjs';
-export { P as PROFILE_QUIRK_APPLIED, a as QuirkArtifact, Q as QuirkDescriptor, c as QuirkProfileDisposition, d as QuirkProfiledVerdict, b as QuirkRoundTripResult, S as SynthProfile, e as SynthProfileSpec, f as assertIntendedWarnings, g as defineSynthProfile, p as profileTolerated, r as resolveQuirk, s as sameCodeSet, v as validateProfileQuirks } from './quirk-BCSs1jPt.cjs';
+import { R as Rng, s as ssn, p as phone, n as name, e as email, i as ipv4, c as ipv6, u as uuid, d as identifier, f as address, g as dateYmd, h as npi, j as dea } from './providers-B48qUwHU.cjs';
+export { A as Artifact, C as Corpus, k as CorpusManifest, l as SsnBlock, m as SynthFormat, b as SyntheticAddress, a as SyntheticIdentifier, S as SyntheticName, o as createRng, q as makeCorpus } from './providers-B48qUwHU.cjs';
+import { A as AnimalCode, a as AnimalSpecies } from './animal-code-Bdl_9Jma.cjs';
+export { b as ANIMAL_CODE_SYSTEM } from './animal-code-Bdl_9Jma.cjs';
+export { P as PROFILE_QUIRK_APPLIED, a as QuirkArtifact, Q as QuirkDescriptor, c as QuirkProfileDisposition, d as QuirkProfiledVerdict, b as QuirkRoundTripResult, S as SynthProfile, e as SynthProfileSpec, f as assertIntendedWarnings, g as defineSynthProfile, p as profileTolerated, r as resolveQuirk, s as sameCodeSet, v as validateProfileQuirks } from './quirk-Q5AxzHSC.cjs';
+
+/**
+ * The synthetic **animal** providers: a pet's name, its species and breed, its microchip, and its
+ * birth date. Like every provider in `../safe`, each is a pure function of an explicit seeded
+ * generator and draws only from a source this module ships or a range we chose for synthetic values.
+ *
+ * - **Species and breed** come from a short list of our own: plain text, with codes in a local
+ *   code system ({@link ANIMAL_CODE_SYSTEM}). No SNOMED CT, VetSCT or VeNom content is used.
+ * - **Pet names** come from a clearly invented pool, like the person-name pool.
+ * - **Microchips** are 15 digits that begin with `999` (see {@link MICROCHIP_TEST_PREFIX}). We
+ *   take `999` to be outside the country and manufacturer codes a real chip carries, but we have
+ *   not verified that against ISO 11784 or any registry.
+ *
+ * `# synthetic: true`
+ *
+ * @module
+ */
+
+/** A species and one of its breeds, as {@link animalBreed} draws them. */
+interface AnimalBreedDraw {
+    /** The species. */
+    readonly species: AnimalCode;
+    /** A breed of that species. */
+    readonly breed: AnimalCode;
+}
+/**
+ * The species and breeds the animal subject draws from: our own short list, in plain text, under
+ * {@link ANIMAL_CODE_SYSTEM}. Small on purpose: structural coverage, not a breed registry.
+ *
+ * @example
+ * ```ts
+ * import { SYNTHETIC_ANIMAL_SPECIES } from "@cosyte/synth";
+ * SYNTHETIC_ANIMAL_SPECIES.map((s) => s.text); // ["Dog", "Cat", "Horse", "Cattle"]
+ * ```
+ */
+declare const SYNTHETIC_ANIMAL_SPECIES: readonly AnimalSpecies[];
+/** Clearly invented pet names. None is a name a reader would take for a real animal's record. */
+declare const SYNTHETIC_PET_NAMES: readonly string[];
+/**
+ * The three digits every synthetic microchip begins with: `999`. We chose it as a range we believe
+ * no implanted chip uses, but we have not verified that against ISO 11784 or any manufacturer code
+ * list. Not verified.
+ */
+declare const MICROCHIP_TEST_PREFIX = "999";
+/**
+ * A **synthetic pet name** from {@link SYNTHETIC_PET_NAMES}.
+ *
+ * @param rng - The seeded generator.
+ * @returns A clearly invented pet name.
+ * @example
+ * ```ts
+ * import { createRng, petName } from "@cosyte/synth";
+ * petName(createRng(1)); // e.g. "Stubtail", synthetic
+ * ```
+ */
+declare function petName(rng: Rng): string;
+/**
+ * A **species and breed** from {@link SYNTHETIC_ANIMAL_SPECIES}: the species first, then one of its
+ * breeds.
+ *
+ * @param rng - The seeded generator.
+ * @returns An {@link AnimalBreedDraw}.
+ * @example
+ * ```ts
+ * import { animalBreed, createRng } from "@cosyte/synth";
+ * const { species, breed } = animalBreed(createRng(1));
+ * ```
+ */
+declare function animalBreed(rng: Rng): AnimalBreedDraw;
+/**
+ * A **synthetic microchip**: 15 digits, {@link MICROCHIP_TEST_PREFIX} then twelve seeded digits.
+ *
+ * @param rng - The seeded generator.
+ * @returns A 15-digit string beginning `999`.
+ * @example
+ * ```ts
+ * import { createRng, isSyntheticMicrochip, microchip } from "@cosyte/synth";
+ * isSyntheticMicrochip(microchip(createRng(1))); // true
+ * ```
+ */
+declare function microchip(rng: Rng): string;
+/**
+ * Whether a value is a synthetic microchip: exactly 15 digits beginning with
+ * {@link MICROCHIP_TEST_PREFIX}.
+ *
+ * @param value - The value to test.
+ * @returns `true` when the value is 15 digits beginning {@link MICROCHIP_TEST_PREFIX}.
+ * @example
+ * ```ts
+ * import { isSyntheticMicrochip } from "@cosyte/synth";
+ * isSyntheticMicrochip("999000000000001"); // true
+ * ```
+ */
+declare function isSyntheticMicrochip(value: string): boolean;
+/**
+ * A **synthetic animal birth date** in `YYYYMMDD` form, from 0 to 20 years before `onDate`, both
+ * ends included. `onDate` is a date the caller supplies (the generators pass the message date), never
+ * the clock, so the same seed and date give the same birth date.
+ *
+ * @param rng - The seeded generator.
+ * @param onDate - The reference date, `YYYYMMDD` (only its first eight digits are read).
+ * @returns A `YYYYMMDD` date no later than `onDate` and no more than 20 years before it.
+ * @example
+ * ```ts
+ * import { animalBirthDate, createRng } from "@cosyte/synth";
+ * animalBirthDate(createRng(1), "20250101"); // between "20050101" and "20250101"
+ * ```
+ */
+declare function animalBirthDate(rng: Rng, onDate: string): string;
 
 /**
  * The reserved / never-collide identifier facts that make a `@cosyte/synth` value **provably
@@ -357,6 +468,7 @@ declare const SYNTHETIC_CITY_NAMES: readonly string[];
  * const rng = createRng(42);
  * safe.ssn(rng);   // never-issued SSN
  * safe.phone(rng); // reserved 555-01NN number
+ * safe.microchip(rng); // 15 digits beginning 999
  * ```
  */
 declare const safe: Readonly<{
@@ -372,6 +484,10 @@ declare const safe: Readonly<{
     dateYmd: typeof dateYmd;
     npi: typeof npi;
     dea: typeof dea;
+    petName: typeof petName;
+    animalBreed: typeof animalBreed;
+    microchip: typeof microchip;
+    animalBirthDate: typeof animalBirthDate;
 }>;
 
 /**
@@ -504,7 +620,11 @@ declare const SYNTH_FATAL_CODES: Readonly<{
     readonly SYNTH_INVALID_DECIMAL: "SYNTH_INVALID_DECIMAL";
     /** An integer range was requested with its maximum below its minimum. Fatal. */
     readonly 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. A corpus given an
+     * empty `mix`, `triggers` or `quirks` list (or a profile whose `quirks` is an empty list) raises it
+     * too: there is no kind to cycle through, and an empty list is never read as the default.
+     */
     readonly SYNTH_EMPTY_POOL: "SYNTH_EMPTY_POOL";
     /** A `defineSynthProfile` spec was not usable (a missing or blank `name`). Fatal. */
     readonly SYNTH_INVALID_PROFILE: "SYNTH_INVALID_PROFILE";
@@ -524,6 +644,20 @@ declare const SYNTH_FATAL_CODES: Readonly<{
      * mislabelled artifact is worse than no artifact.
      */
     readonly SYNTH_PROFILE_NOT_GENERATED: "SYNTH_PROFILE_NOT_GENERATED";
+    /**
+     * The sibling parser a generator builds through is not installed. Raised on the first call that
+     * needs it, by both builds, only when the missing package is the parser itself: a missing
+     * dependency of an installed parser is thrown as Node.js raised it. The error carries the parser's
+     * package name on `peer`, a message from {@link SYNTH_PEER_MESSAGES} that names its install
+     * command, and the error Node.js raised on `cause`.
+     */
+    readonly SYNTH_PEER_NOT_INSTALLED: "SYNTH_PEER_NOT_INSTALLED";
+    /**
+     * An HL7 v2 `ACK` was asked for an inbound message that carries no MSH-10 message control id.
+     * MSA-2 must echo that id, and an acknowledgment that cannot be matched to the message it answers
+     * is not a fixture worth having, so nothing is generated.
+     */
+    readonly SYNTH_ACK_UNCORRELATED: "SYNTH_ACK_UNCORRELATED";
 }>;
 /**
  * A value from {@link SYNTH_FATAL_CODES}: the type carried by a thrown {@link SynthError}.
@@ -549,13 +683,48 @@ type SynthFatalCode = (typeof SYNTH_FATAL_CODES)[keyof typeof SYNTH_FATAL_CODES]
  * ```
  */
 declare const SYNTH_FATAL_MESSAGES: Readonly<Record<SynthFatalCode, string>>;
+/**
+ * The message a {@link SYNTH_FATAL_CODES.SYNTH_PEER_NOT_INSTALLED} error carries for each sibling
+ * parser: which package is missing, and the command that installs it. Keyed by the closed set of
+ * parser packages this package builds through, so like {@link SYNTH_FATAL_MESSAGES} it is a table
+ * of fixed strings, and no caller value can reach it.
+ *
+ * @example
+ * ```ts
+ * import { SYNTH_PEER_MESSAGES } from "@cosyte/synth";
+ * SYNTH_PEER_MESSAGES["@cosyte/hl7"]; // => "@cosyte/hl7 is not installed, and this generator builds through it. Install it beside @cosyte/synth: npm install @cosyte/hl7"
+ * ```
+ */
+declare const SYNTH_PEER_MESSAGES: Readonly<{
+    readonly "@cosyte/hl7": string;
+    readonly "@cosyte/fhir": string;
+    readonly "@cosyte/ccda": string;
+    readonly "@cosyte/x12": string;
+    readonly "@cosyte/ncpdp": string;
+    readonly "@cosyte/astm": string;
+    readonly "@cosyte/deid": string;
+}>;
+/** A sibling parser package: a key of {@link SYNTH_PEER_MESSAGES}. */
+type SynthPeer = keyof typeof SYNTH_PEER_MESSAGES;
+/** What a {@link SynthError} may carry beside its code. */
+interface SynthErrorOptions {
+    /** The error that caused this one, kept on `cause`. */
+    readonly cause?: unknown;
+    /**
+     * For {@link SYNTH_FATAL_CODES.SYNTH_PEER_NOT_INSTALLED}: the parser package that is missing. Its
+     * message then comes from {@link SYNTH_PEER_MESSAGES}.
+     */
+    readonly peer?: SynthPeer;
+}
 /**
  * The typed error every fatal `@cosyte/synth` condition throws. Carries a stable
  * {@link SynthFatalCode} so callers branch on `err.code` without matching message text.
  *
  * It takes **no value parameter**. The message is whatever {@link SYNTH_FATAL_MESSAGES} holds for the
- * code, so no caller-supplied string can reach a diagnostic surface by any route, not `message`, not
- * `stack`, not a field on the thrown object.
+ * code, or for a missing parser whatever {@link SYNTH_PEER_MESSAGES} holds for that package, so no
+ * caller-supplied string can reach a diagnostic surface by any route, not `message`, not `stack`,
+ * not a field on the thrown object. The options carry only an error this package caught (`cause`)
+ * and a package name from that closed set (`peer`).
  *
  * @example
  * ```ts
@@ -566,10 +735,13 @@ declare const SYNTH_FATAL_MESSAGES: Readonly<Record<SynthFatalCode, string>>;
 declare class SynthError extends Error {
     /** The stable fatal code. */
     readonly code: SynthFatalCode;
+    /** The missing parser package, on a {@link SYNTH_FATAL_CODES.SYNTH_PEER_NOT_INSTALLED} error only. */
+    readonly peer?: SynthPeer;
     /**
      * @param code - The stable {@link SynthFatalCode}. The message comes from the frozen registry.
+     * @param options - The error that caused this one, and for a missing parser its package.
      */
-    constructor(code: SynthFatalCode);
+    constructor(code: SynthFatalCode, options?: SynthErrorOptions);
 }
 
 /**
@@ -620,7 +792,8 @@ declare function resolveKind<T extends string>(allowed: readonly T[], requested:
  * of this function also treated `[]` as "nothing supplied", on the stated grounds that it matched the
  * previous behaviour; it did not: `??` fires on `undefined` and never on `[]`, and it changed the
  * result of six published entry points, turning an explicit empty selection into "generate one of
- * everything". A convenience that fails open is not a convenience.
+ * everything". A convenience that fails open is not a convenience. Every corpus then refuses the empty
+ * mix with `SYNTH_EMPTY_POOL`, before it generates anything.
  *
  * @param allowed - Every kind the corpus may generate.
  * @param requested - The mix the caller supplied, or `undefined` for the default.
@@ -669,5 +842,5 @@ declare function resolveMix<T extends string>(allowed: readonly T[], requested:
  */
 declare const VERSION: string;
 
-export { DEA_REGISTRANT_TYPES, DOC_V6_PREFIX, ITIN_GROUP_RANGES, NPI_LUHN_PREFIX, RESERVED_EMAIL_DOMAINS, SYNTHETIC_ASSIGNING_AUTHORITY, SYNTHETIC_CITY_NAMES, SYNTHETIC_FAMILY_NAMES, SYNTHETIC_GIVEN_NAMES, SYNTHETIC_STREET_NAMES, SYNTH_FATAL_CODES, SYNTH_FATAL_MESSAGES, SynthError, TEST_NET_V4_PREFIXES, VERSION, address, dateYmd, dea, deaCheckDigit, email, identifier, ipv4, ipv6, isItinFormatted, isSyntheticDea, isSyntheticEmail, isSyntheticIp, isSyntheticNpi, isSyntheticPhone, isSyntheticSsn, luhnMod10, name, npi, npiCheckDigit, phone, resolveKind, resolveMix, safe, sfc32Next, splitmix32, ssn, uuid };
-export type { Sfc32State, SynthFatalCode };
+export { AnimalCode, AnimalSpecies, DEA_REGISTRANT_TYPES, DOC_V6_PREFIX, ITIN_GROUP_RANGES, MICROCHIP_TEST_PREFIX, NPI_LUHN_PREFIX, RESERVED_EMAIL_DOMAINS, Rng, SYNTHETIC_ANIMAL_SPECIES, SYNTHETIC_ASSIGNING_AUTHORITY, SYNTHETIC_CITY_NAMES, SYNTHETIC_FAMILY_NAMES, SYNTHETIC_GIVEN_NAMES, SYNTHETIC_PET_NAMES, SYNTHETIC_STREET_NAMES, SYNTH_FATAL_CODES, SYNTH_FATAL_MESSAGES, SYNTH_PEER_MESSAGES, SynthError, TEST_NET_V4_PREFIXES, VERSION, address, animalBirthDate, animalBreed, dateYmd, dea, deaCheckDigit, email, identifier, ipv4, ipv6, isItinFormatted, isSyntheticDea, isSyntheticEmail, isSyntheticIp, isSyntheticMicrochip, isSyntheticNpi, isSyntheticPhone, isSyntheticSsn, luhnMod10, microchip, name, npi, npiCheckDigit, petName, phone, resolveKind, resolveMix, safe, sfc32Next, splitmix32, ssn, uuid };
+export type { AnimalBreedDraw, Sfc32State, SynthErrorOptions, SynthFatalCode, SynthPeer };

package/dist/index.d.ts

@@ -1,6 +1,117 @@
-import { s as ssn, p as phone, n as name, e as email, i as ipv4, c as ipv6, u as uuid, d as identifier, f as address, g as dateYmd, h as npi, j as dea } from './providers-B48qUwHU.js';
-export { A as Artifact, C as Corpus, k as CorpusManifest, R as Rng, l as SsnBlock, m as SynthFormat, b as SyntheticAddress, a as SyntheticIdentifier, S as SyntheticName, o as createRng, q as makeCorpus } from './providers-B48qUwHU.js';
-export { P as PROFILE_QUIRK_APPLIED, a as QuirkArtifact, Q as QuirkDescriptor, c as QuirkProfileDisposition, d as QuirkProfiledVerdict, b as QuirkRoundTripResult, S as SynthProfile, e as SynthProfileSpec, f as assertIntendedWarnings, g as defineSynthProfile, p as profileTolerated, r as resolveQuirk, s as sameCodeSet, v as validateProfileQuirks } from './quirk-BfObsiWV.js';
+import { R as Rng, s as ssn, p as phone, n as name, e as email, i as ipv4, c as ipv6, u as uuid, d as identifier, f as address, g as dateYmd, h as npi, j as dea } from './providers-B48qUwHU.js';
+export { A as Artifact, C as Corpus, k as CorpusManifest, l as SsnBlock, m as SynthFormat, b as SyntheticAddress, a as SyntheticIdentifier, S as SyntheticName, o as createRng, q as makeCorpus } from './providers-B48qUwHU.js';
+import { A as AnimalCode, a as AnimalSpecies } from './animal-code-Bdl_9Jma.js';
+export { b as ANIMAL_CODE_SYSTEM } from './animal-code-Bdl_9Jma.js';
+export { P as PROFILE_QUIRK_APPLIED, a as QuirkArtifact, Q as QuirkDescriptor, c as QuirkProfileDisposition, d as QuirkProfiledVerdict, b as QuirkRoundTripResult, S as SynthProfile, e as SynthProfileSpec, f as assertIntendedWarnings, g as defineSynthProfile, p as profileTolerated, r as resolveQuirk, s as sameCodeSet, v as validateProfileQuirks } from './quirk-CzknuYUo.js';
+
+/**
+ * The synthetic **animal** providers: a pet's name, its species and breed, its microchip, and its
+ * birth date. Like every provider in `../safe`, each is a pure function of an explicit seeded
+ * generator and draws only from a source this module ships or a range we chose for synthetic values.
+ *
+ * - **Species and breed** come from a short list of our own: plain text, with codes in a local
+ *   code system ({@link ANIMAL_CODE_SYSTEM}). No SNOMED CT, VetSCT or VeNom content is used.
+ * - **Pet names** come from a clearly invented pool, like the person-name pool.
+ * - **Microchips** are 15 digits that begin with `999` (see {@link MICROCHIP_TEST_PREFIX}). We
+ *   take `999` to be outside the country and manufacturer codes a real chip carries, but we have
+ *   not verified that against ISO 11784 or any registry.
+ *
+ * `# synthetic: true`
+ *
+ * @module
+ */
+
+/** A species and one of its breeds, as {@link animalBreed} draws them. */
+interface AnimalBreedDraw {
+    /** The species. */
+    readonly species: AnimalCode;
+    /** A breed of that species. */
+    readonly breed: AnimalCode;
+}
+/**
+ * The species and breeds the animal subject draws from: our own short list, in plain text, under
+ * {@link ANIMAL_CODE_SYSTEM}. Small on purpose: structural coverage, not a breed registry.
+ *
+ * @example
+ * ```ts
+ * import { SYNTHETIC_ANIMAL_SPECIES } from "@cosyte/synth";
+ * SYNTHETIC_ANIMAL_SPECIES.map((s) => s.text); // ["Dog", "Cat", "Horse", "Cattle"]
+ * ```
+ */
+declare const SYNTHETIC_ANIMAL_SPECIES: readonly AnimalSpecies[];
+/** Clearly invented pet names. None is a name a reader would take for a real animal's record. */
+declare const SYNTHETIC_PET_NAMES: readonly string[];
+/**
+ * The three digits every synthetic microchip begins with: `999`. We chose it as a range we believe
+ * no implanted chip uses, but we have not verified that against ISO 11784 or any manufacturer code
+ * list. Not verified.
+ */
+declare const MICROCHIP_TEST_PREFIX = "999";
+/**
+ * A **synthetic pet name** from {@link SYNTHETIC_PET_NAMES}.
+ *
+ * @param rng - The seeded generator.
+ * @returns A clearly invented pet name.
+ * @example
+ * ```ts
+ * import { createRng, petName } from "@cosyte/synth";
+ * petName(createRng(1)); // e.g. "Stubtail", synthetic
+ * ```
+ */
+declare function petName(rng: Rng): string;
+/**
+ * A **species and breed** from {@link SYNTHETIC_ANIMAL_SPECIES}: the species first, then one of its
+ * breeds.
+ *
+ * @param rng - The seeded generator.
+ * @returns An {@link AnimalBreedDraw}.
+ * @example
+ * ```ts
+ * import { animalBreed, createRng } from "@cosyte/synth";
+ * const { species, breed } = animalBreed(createRng(1));
+ * ```
+ */
+declare function animalBreed(rng: Rng): AnimalBreedDraw;
+/**
+ * A **synthetic microchip**: 15 digits, {@link MICROCHIP_TEST_PREFIX} then twelve seeded digits.
+ *
+ * @param rng - The seeded generator.
+ * @returns A 15-digit string beginning `999`.
+ * @example
+ * ```ts
+ * import { createRng, isSyntheticMicrochip, microchip } from "@cosyte/synth";
+ * isSyntheticMicrochip(microchip(createRng(1))); // true
+ * ```
+ */
+declare function microchip(rng: Rng): string;
+/**
+ * Whether a value is a synthetic microchip: exactly 15 digits beginning with
+ * {@link MICROCHIP_TEST_PREFIX}.
+ *
+ * @param value - The value to test.
+ * @returns `true` when the value is 15 digits beginning {@link MICROCHIP_TEST_PREFIX}.
+ * @example
+ * ```ts
+ * import { isSyntheticMicrochip } from "@cosyte/synth";
+ * isSyntheticMicrochip("999000000000001"); // true
+ * ```
+ */
+declare function isSyntheticMicrochip(value: string): boolean;
+/**
+ * A **synthetic animal birth date** in `YYYYMMDD` form, from 0 to 20 years before `onDate`, both
+ * ends included. `onDate` is a date the caller supplies (the generators pass the message date), never
+ * the clock, so the same seed and date give the same birth date.
+ *
+ * @param rng - The seeded generator.
+ * @param onDate - The reference date, `YYYYMMDD` (only its first eight digits are read).
+ * @returns A `YYYYMMDD` date no later than `onDate` and no more than 20 years before it.
+ * @example
+ * ```ts
+ * import { animalBirthDate, createRng } from "@cosyte/synth";
+ * animalBirthDate(createRng(1), "20250101"); // between "20050101" and "20250101"
+ * ```
+ */
+declare function animalBirthDate(rng: Rng, onDate: string): string;
 
 /**
  * The reserved / never-collide identifier facts that make a `@cosyte/synth` value **provably
@@ -357,6 +468,7 @@ declare const SYNTHETIC_CITY_NAMES: readonly string[];
  * const rng = createRng(42);
  * safe.ssn(rng);   // never-issued SSN
  * safe.phone(rng); // reserved 555-01NN number
+ * safe.microchip(rng); // 15 digits beginning 999
  * ```
  */
 declare const safe: Readonly<{
@@ -372,6 +484,10 @@ declare const safe: Readonly<{
     dateYmd: typeof dateYmd;
     npi: typeof npi;
     dea: typeof dea;
+    petName: typeof petName;
+    animalBreed: typeof animalBreed;
+    microchip: typeof microchip;
+    animalBirthDate: typeof animalBirthDate;
 }>;
 
 /**
@@ -504,7 +620,11 @@ declare const SYNTH_FATAL_CODES: Readonly<{
     readonly SYNTH_INVALID_DECIMAL: "SYNTH_INVALID_DECIMAL";
     /** An integer range was requested with its maximum below its minimum. Fatal. */
     readonly 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. A corpus given an
+     * empty `mix`, `triggers` or `quirks` list (or a profile whose `quirks` is an empty list) raises it
+     * too: there is no kind to cycle through, and an empty list is never read as the default.
+     */
     readonly SYNTH_EMPTY_POOL: "SYNTH_EMPTY_POOL";
     /** A `defineSynthProfile` spec was not usable (a missing or blank `name`). Fatal. */
     readonly SYNTH_INVALID_PROFILE: "SYNTH_INVALID_PROFILE";
@@ -524,6 +644,20 @@ declare const SYNTH_FATAL_CODES: Readonly<{
      * mislabelled artifact is worse than no artifact.
      */
     readonly SYNTH_PROFILE_NOT_GENERATED: "SYNTH_PROFILE_NOT_GENERATED";
+    /**
+     * The sibling parser a generator builds through is not installed. Raised on the first call that
+     * needs it, by both builds, only when the missing package is the parser itself: a missing
+     * dependency of an installed parser is thrown as Node.js raised it. The error carries the parser's
+     * package name on `peer`, a message from {@link SYNTH_PEER_MESSAGES} that names its install
+     * command, and the error Node.js raised on `cause`.
+     */
+    readonly SYNTH_PEER_NOT_INSTALLED: "SYNTH_PEER_NOT_INSTALLED";
+    /**
+     * An HL7 v2 `ACK` was asked for an inbound message that carries no MSH-10 message control id.
+     * MSA-2 must echo that id, and an acknowledgment that cannot be matched to the message it answers
+     * is not a fixture worth having, so nothing is generated.
+     */
+    readonly SYNTH_ACK_UNCORRELATED: "SYNTH_ACK_UNCORRELATED";
 }>;
 /**
  * A value from {@link SYNTH_FATAL_CODES}: the type carried by a thrown {@link SynthError}.
@@ -549,13 +683,48 @@ type SynthFatalCode = (typeof SYNTH_FATAL_CODES)[keyof typeof SYNTH_FATAL_CODES]
  * ```
  */
 declare const SYNTH_FATAL_MESSAGES: Readonly<Record<SynthFatalCode, string>>;
+/**
+ * The message a {@link SYNTH_FATAL_CODES.SYNTH_PEER_NOT_INSTALLED} error carries for each sibling
+ * parser: which package is missing, and the command that installs it. Keyed by the closed set of
+ * parser packages this package builds through, so like {@link SYNTH_FATAL_MESSAGES} it is a table
+ * of fixed strings, and no caller value can reach it.
+ *
+ * @example
+ * ```ts
+ * import { SYNTH_PEER_MESSAGES } from "@cosyte/synth";
+ * SYNTH_PEER_MESSAGES["@cosyte/hl7"]; // => "@cosyte/hl7 is not installed, and this generator builds through it. Install it beside @cosyte/synth: npm install @cosyte/hl7"
+ * ```
+ */
+declare const SYNTH_PEER_MESSAGES: Readonly<{
+    readonly "@cosyte/hl7": string;
+    readonly "@cosyte/fhir": string;
+    readonly "@cosyte/ccda": string;
+    readonly "@cosyte/x12": string;
+    readonly "@cosyte/ncpdp": string;
+    readonly "@cosyte/astm": string;
+    readonly "@cosyte/deid": string;
+}>;
+/** A sibling parser package: a key of {@link SYNTH_PEER_MESSAGES}. */
+type SynthPeer = keyof typeof SYNTH_PEER_MESSAGES;
+/** What a {@link SynthError} may carry beside its code. */
+interface SynthErrorOptions {
+    /** The error that caused this one, kept on `cause`. */
+    readonly cause?: unknown;
+    /**
+     * For {@link SYNTH_FATAL_CODES.SYNTH_PEER_NOT_INSTALLED}: the parser package that is missing. Its
+     * message then comes from {@link SYNTH_PEER_MESSAGES}.
+     */
+    readonly peer?: SynthPeer;
+}
 /**
  * The typed error every fatal `@cosyte/synth` condition throws. Carries a stable
  * {@link SynthFatalCode} so callers branch on `err.code` without matching message text.
  *
  * It takes **no value parameter**. The message is whatever {@link SYNTH_FATAL_MESSAGES} holds for the
- * code, so no caller-supplied string can reach a diagnostic surface by any route, not `message`, not
- * `stack`, not a field on the thrown object.
+ * code, or for a missing parser whatever {@link SYNTH_PEER_MESSAGES} holds for that package, so no
+ * caller-supplied string can reach a diagnostic surface by any route, not `message`, not `stack`,
+ * not a field on the thrown object. The options carry only an error this package caught (`cause`)
+ * and a package name from that closed set (`peer`).
  *
  * @example
  * ```ts
@@ -566,10 +735,13 @@ declare const SYNTH_FATAL_MESSAGES: Readonly<Record<SynthFatalCode, string>>;
 declare class SynthError extends Error {
     /** The stable fatal code. */
     readonly code: SynthFatalCode;
+    /** The missing parser package, on a {@link SYNTH_FATAL_CODES.SYNTH_PEER_NOT_INSTALLED} error only. */
+    readonly peer?: SynthPeer;
     /**
      * @param code - The stable {@link SynthFatalCode}. The message comes from the frozen registry.
+     * @param options - The error that caused this one, and for a missing parser its package.
      */
-    constructor(code: SynthFatalCode);
+    constructor(code: SynthFatalCode, options?: SynthErrorOptions);
 }
 
 /**
@@ -620,7 +792,8 @@ declare function resolveKind<T extends string>(allowed: readonly T[], requested:
  * of this function also treated `[]` as "nothing supplied", on the stated grounds that it matched the
  * previous behaviour; it did not: `??` fires on `undefined` and never on `[]`, and it changed the
  * result of six published entry points, turning an explicit empty selection into "generate one of
- * everything". A convenience that fails open is not a convenience.
+ * everything". A convenience that fails open is not a convenience. Every corpus then refuses the empty
+ * mix with `SYNTH_EMPTY_POOL`, before it generates anything.
  *
  * @param allowed - Every kind the corpus may generate.
  * @param requested - The mix the caller supplied, or `undefined` for the default.
@@ -669,5 +842,5 @@ declare function resolveMix<T extends string>(allowed: readonly T[], requested:
  */
 declare const VERSION: string;
 
-export { DEA_REGISTRANT_TYPES, DOC_V6_PREFIX, ITIN_GROUP_RANGES, NPI_LUHN_PREFIX, RESERVED_EMAIL_DOMAINS, SYNTHETIC_ASSIGNING_AUTHORITY, SYNTHETIC_CITY_NAMES, SYNTHETIC_FAMILY_NAMES, SYNTHETIC_GIVEN_NAMES, SYNTHETIC_STREET_NAMES, SYNTH_FATAL_CODES, SYNTH_FATAL_MESSAGES, SynthError, TEST_NET_V4_PREFIXES, VERSION, address, dateYmd, dea, deaCheckDigit, email, identifier, ipv4, ipv6, isItinFormatted, isSyntheticDea, isSyntheticEmail, isSyntheticIp, isSyntheticNpi, isSyntheticPhone, isSyntheticSsn, luhnMod10, name, npi, npiCheckDigit, phone, resolveKind, resolveMix, safe, sfc32Next, splitmix32, ssn, uuid };
-export type { Sfc32State, SynthFatalCode };
+export { AnimalCode, AnimalSpecies, DEA_REGISTRANT_TYPES, DOC_V6_PREFIX, ITIN_GROUP_RANGES, MICROCHIP_TEST_PREFIX, NPI_LUHN_PREFIX, RESERVED_EMAIL_DOMAINS, Rng, SYNTHETIC_ANIMAL_SPECIES, SYNTHETIC_ASSIGNING_AUTHORITY, SYNTHETIC_CITY_NAMES, SYNTHETIC_FAMILY_NAMES, SYNTHETIC_GIVEN_NAMES, SYNTHETIC_PET_NAMES, SYNTHETIC_STREET_NAMES, SYNTH_FATAL_CODES, SYNTH_FATAL_MESSAGES, SYNTH_PEER_MESSAGES, SynthError, TEST_NET_V4_PREFIXES, VERSION, address, animalBirthDate, animalBreed, dateYmd, dea, deaCheckDigit, email, identifier, ipv4, ipv6, isItinFormatted, isSyntheticDea, isSyntheticEmail, isSyntheticIp, isSyntheticMicrochip, isSyntheticNpi, isSyntheticPhone, isSyntheticSsn, luhnMod10, microchip, name, npi, npiCheckDigit, petName, phone, resolveKind, resolveMix, safe, sfc32Next, splitmix32, ssn, uuid };
+export type { AnimalBreedDraw, Sfc32State, SynthErrorOptions, SynthFatalCode, SynthPeer };