@cosyte/synth 0.1.4 → 0.1.6

package/dist/astm/index.d.cts

@@ -91,6 +91,7 @@ declare function generateAstmResultFramed(options: GenerateAstmOptions): Uint8Ar
  *
  * @module
  */
+
 /** The verdict of one round-trip through `@cosyte/astm`. */
 interface AstmRoundTripResult {
     /** The serialized ASTM wire text (records: the `CR`-terminated stream; framed: the raw bytes as latin1). */
@@ -398,6 +399,12 @@ interface AstmCorpusOptions {
     readonly count?: number;
     /** The message kinds to cycle through. Defaults to one of each. */
     readonly mix?: readonly AstmCorpusKind[];
+    /**
+     * Whether each artifact is read back through its parser and the parser's findings recorded as its
+     * `warnings`. Defaults to `true`. `false` skips the read, a large share of a corpus's time; every
+     * artifact's `warnings` is then empty without having been checked.
+     */
+    readonly verify?: boolean;
 }
 /**
  * Build a reproducible {@link Corpus} of spec-clean ASTM messages. Each message is generated from a

package/dist/astm/index.d.ts

@@ -91,6 +91,7 @@ declare function generateAstmResultFramed(options: GenerateAstmOptions): Uint8Ar
  *
  * @module
  */
+
 /** The verdict of one round-trip through `@cosyte/astm`. */
 interface AstmRoundTripResult {
     /** The serialized ASTM wire text (records: the `CR`-terminated stream; framed: the raw bytes as latin1). */
@@ -398,6 +399,12 @@ interface AstmCorpusOptions {
     readonly count?: number;
     /** The message kinds to cycle through. Defaults to one of each. */
     readonly mix?: readonly AstmCorpusKind[];
+    /**
+     * Whether each artifact is read back through its parser and the parser's findings recorded as its
+     * `warnings`. Defaults to `true`. `false` skips the read, a large share of a corpus's time; every
+     * artifact's `warnings` is then empty without having been checked.
+     */
+    readonly verify?: boolean;
 }
 /**
  * Build a reproducible {@link Corpus} of spec-clean ASTM messages. Each message is generated from a

package/dist/astm/index.mjs

@@ -1,4 +1,12 @@
-import { buildAstmMessage, composeAstmFrames, parseAstmRecords, serializeAstmRecords, parseFramedAstm, serializeFramedAstm, astmProfiles } from '@cosyte/astm';
+import { createRequire } from 'module';
+import { fileURLToPath } from 'url';
+
+var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
+  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
+}) : x)(function(x) {
+  if (typeof require !== "undefined") return require.apply(this, arguments);
+  throw Error('Dynamic require of "' + x + '" is not supported');
+});
 
 // src/rng/splitmix32.ts
 function splitmix32(seed) {
@@ -30,7 +38,16 @@ function sfc32Next(s) {
 }
 
 // src/codes.ts
-var SYNTH_FATAL_CODES = {
+var SYNTH_FATAL_CODES = Object.freeze({
+  /**
+   * A format was requested that this build cannot generate through a real parser builder/serializer.
+   * Fatal, never a hand-written byte fallback.
+   *
+   * **No code path in this build raises it.** All six formats generate, so it is reserved for a
+   * future format that does not, and is kept because removing a published code is a breaking change.
+   * An unsupported *kind* within a format that does generate is `SYNTH_UNSUPPORTED_KIND`.
+   */
+  SYNTH_UNSUPPORTED_FORMAT: "SYNTH_UNSUPPORTED_FORMAT",
   /**
    * A vendor quirk was requested that the target format's profile system does not support. Fatal,
    * never a silent no-op and never a fabricated quirk.
@@ -47,6 +64,10 @@ var SYNTH_FATAL_CODES = {
    * warning code(s). Fatal, never emit a mislabeled fixture.
    */
   SYNTH_INTENDED_WARNING_MISMATCH: "SYNTH_INTENDED_WARNING_MISMATCH",
+  /** A concept's code-system URI has no OID mapping in the C-CDA example-code table. Fatal. */
+  SYNTH_UNMAPPED_CODE_SYSTEM: "SYNTH_UNMAPPED_CODE_SYSTEM",
+  /** 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. */
@@ -59,7 +80,17 @@ var SYNTH_FATAL_CODES = {
    * 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.
    */
-  SYNTH_UNSUPPORTED_KIND: "SYNTH_UNSUPPORTED_KIND"};
+  SYNTH_UNSUPPORTED_KIND: "SYNTH_UNSUPPORTED_KIND",
+  /**
+   * A requested profile IS published by the adopted implementation guide, and this build does not
+   * generate it. Deliberately distinct from `SYNTH_UNSUPPORTED_KIND`, which says the name is not in
+   * the adopted set at all: "the guide does not publish this" and "we do not generate this yet" are
+   * different answers, and a caller building to a regulatory profile set has to be able to tell them
+   * apart without matching message text. Fatal, and raised **before** anything is generated: a
+   * mislabelled artifact is worse than no artifact.
+   */
+  SYNTH_PROFILE_NOT_GENERATED: "SYNTH_PROFILE_NOT_GENERATED"
+});
 var SYNTH_FATAL_MESSAGES = Object.freeze({
   SYNTH_UNSUPPORTED_FORMAT: "The requested format is not generable by this build. A generator has no byte fallback: it builds through a parser's own serializer or it refuses.",
   SYNTH_UNSUPPORTED_QUIRK: "The requested vendor quirk is not in the target format's quirk registry. Compare the request against that format's exported registry (HL7_QUIRKS, CCDA_QUIRKS, ASTM_QUIRKS).",
@@ -125,6 +156,7 @@ function createRng(seed) {
 }
 
 // src/corpus.ts
+var UNCHECKED = Object.freeze([]);
 function makeCorpus(seed, artifacts, quirks = []) {
   const counts = {};
   const formats = /* @__PURE__ */ new Set();
@@ -470,88 +502,90 @@ function astmHeaderIdentity(rng) {
 }
 
 // src/astm/example-codes.ts
-var EXAMPLE_ASTM_TESTS = Object.freeze([
-  {
-    localCode: "GLU",
-    loinc: "2345-7",
-    name: "Glucose",
-    units: "mg/dL",
-    referenceRange: "70-110",
-    valueLow: 55,
-    valueHigh: 260,
-    decimals: 0
-  },
-  {
-    localCode: "K",
-    loinc: "2823-3",
-    name: "Potassium",
-    units: "mmol/L",
-    referenceRange: "3.5-5.1",
-    valueLow: 28,
-    valueHigh: 62,
-    decimals: 1
-  },
-  {
-    localCode: "NA",
-    loinc: "2951-2",
-    name: "Sodium",
-    units: "mmol/L",
-    referenceRange: "136-145",
-    valueLow: 125,
-    valueHigh: 155,
-    decimals: 0
-  },
-  {
-    localCode: "CREA",
-    loinc: "2160-0",
-    name: "Creatinine",
-    units: "mg/dL",
-    referenceRange: "0.6-1.3",
-    valueLow: 4,
-    valueHigh: 32,
-    decimals: 1
-  },
-  {
-    localCode: "HGB",
-    loinc: "718-7",
-    name: "Hemoglobin",
-    units: "g/dL",
-    referenceRange: "12.0-17.5",
-    valueLow: 80,
-    valueHigh: 190,
-    decimals: 1
-  },
-  {
-    localCode: "WBC",
-    loinc: "6690-2",
-    name: "Leukocytes",
-    units: "10*3/uL",
-    referenceRange: "4.5-11.0",
-    valueLow: 30,
-    valueHigh: 150,
-    decimals: 1
-  },
-  {
-    localCode: "TSH",
-    loinc: "3016-3",
-    name: "Thyrotropin",
-    units: "mIU/L",
-    referenceRange: "0.40-4.50",
-    valueLow: 2,
-    valueHigh: 90,
-    decimals: 2
-  },
-  {
-    localCode: "ALT",
-    loinc: "1742-6",
-    name: "Alanine aminotransferase",
-    units: "U/L",
-    referenceRange: "7-56",
-    valueLow: 5,
-    valueHigh: 120,
-    decimals: 0
-  }
-]);
+var EXAMPLE_ASTM_TESTS = Object.freeze(
+  [
+    {
+      localCode: "GLU",
+      loinc: "2345-7",
+      name: "Glucose",
+      units: "mg/dL",
+      referenceRange: "70-110",
+      valueLow: 55,
+      valueHigh: 260,
+      decimals: 0
+    },
+    {
+      localCode: "K",
+      loinc: "2823-3",
+      name: "Potassium",
+      units: "mmol/L",
+      referenceRange: "3.5-5.1",
+      valueLow: 28,
+      valueHigh: 62,
+      decimals: 1
+    },
+    {
+      localCode: "NA",
+      loinc: "2951-2",
+      name: "Sodium",
+      units: "mmol/L",
+      referenceRange: "136-145",
+      valueLow: 125,
+      valueHigh: 155,
+      decimals: 0
+    },
+    {
+      localCode: "CREA",
+      loinc: "2160-0",
+      name: "Creatinine",
+      units: "mg/dL",
+      referenceRange: "0.6-1.3",
+      valueLow: 4,
+      valueHigh: 32,
+      decimals: 1
+    },
+    {
+      localCode: "HGB",
+      loinc: "718-7",
+      name: "Hemoglobin",
+      units: "g/dL",
+      referenceRange: "12.0-17.5",
+      valueLow: 80,
+      valueHigh: 190,
+      decimals: 1
+    },
+    {
+      localCode: "WBC",
+      loinc: "6690-2",
+      name: "Leukocytes",
+      units: "10*3/uL",
+      referenceRange: "4.5-11.0",
+      valueLow: 30,
+      valueHigh: 150,
+      decimals: 1
+    },
+    {
+      localCode: "TSH",
+      loinc: "3016-3",
+      name: "Thyrotropin",
+      units: "mIU/L",
+      referenceRange: "0.40-4.50",
+      valueLow: 2,
+      valueHigh: 90,
+      decimals: 2
+    },
+    {
+      localCode: "ALT",
+      loinc: "1742-6",
+      name: "Alanine aminotransferase",
+      units: "U/L",
+      referenceRange: "7-56",
+      valueLow: 5,
+      valueHigh: 120,
+      decimals: 0
+    }
+  ].map((entry) => Object.freeze(entry))
+);
 var ASTM_ABNORMAL_FLAGS = Object.freeze(["N", "L", "H", "A"]);
 var ASTM_RESULT_STATUSES = Object.freeze(["F", "P", "C"]);
 var ASTM_COMMENT_TEXT = Object.freeze([
@@ -559,6 +593,28 @@ var ASTM_COMMENT_TEXT = Object.freeze([
   "Sample generated by @cosyte/synth.",
   "Placeholder result comment for conformance testing."
 ]);
+function defaultHost() {
+  if (typeof import.meta.resolve !== "function") return { require: __require, resolve: void 0 };
+  return { require: createRequire(import.meta.url), resolve: (s) => import.meta.resolve(s) };
+}
+function isRequireEsmRefusal(error) {
+  return error?.code === "ERR_REQUIRE_ESM";
+}
+function loadPeer(specifier, host) {
+  if (host.resolve === void 0) return host.require(specifier);
+  const entry = fileURLToPath(host.resolve(specifier));
+  try {
+    return host.require(entry);
+  } catch (error) {
+    if (!isRequireEsmRefusal(error)) throw error;
+    return host.require(specifier);
+  }
+}
+function lazyPeer(specifier, host) {
+  let loaded;
+  return () => loaded ??= loadPeer(specifier, defaultHost());
+}
+var astmPeer = lazyPeer("@cosyte/astm");
 
 // src/astm/message.ts
 function resultValue(rng, low, high, decimals) {
@@ -613,7 +669,7 @@ function buildResultInput(options) {
   };
 }
 function generateAstmResult(options) {
-  return buildAstmMessage(buildResultInput(options));
+  return astmPeer().buildAstmMessage(buildResultInput(options));
 }
 function generateAstmOrder(options) {
   return generateAstmResult({ ...options, resultCount: 0, comment: false });
@@ -621,21 +677,23 @@ function generateAstmOrder(options) {
 function generateAstmResultFramed(options) {
   const raw = generateAstmResult(options);
   const recordLines = raw.split("\r").filter((line) => line.length > 0).map((line) => `${line}\r`);
-  return composeAstmFrames(recordLines);
+  return astmPeer().composeAstmFrames(recordLines);
 }
+
+// src/astm/round-trip.ts
 function astmRoundTrip(raw) {
-  const message = parseAstmRecords(raw);
+  const message = astmPeer().parseAstmRecords(raw);
   const warnings = message.warnings.map((w) => String(w.code));
-  const byteStable = serializeAstmRecords(message) === raw;
+  const byteStable = astmPeer().serializeAstmRecords(message) === raw;
   return { content: raw, warnings, byteStable, specClean: warnings.length === 0 && byteStable };
 }
 function astmFramedRoundTrip(bytes) {
-  const { message, frameWarnings } = parseFramedAstm(bytes);
+  const { message, frameWarnings } = astmPeer().parseFramedAstm(bytes);
   const warnings = [
     ...frameWarnings.map((w) => String(w.code)),
     ...message.warnings.map((w) => String(w.code))
   ];
-  const reframed = serializeFramedAstm(message);
+  const reframed = astmPeer().serializeFramedAstm(message);
   const byteStable = bytesEqual(reframed, bytes);
   const content = latin1(bytes);
   return { content, warnings, byteStable, specClean: warnings.length === 0 && byteStable };
@@ -650,6 +708,11 @@ function latin1(bytes) {
   for (const b of bytes) out += String.fromCharCode(b);
   return out;
 }
+function astmCorpusArtifact(raw, verify) {
+  if (!verify) return { content: raw, warnings: UNCHECKED };
+  const warnings = astmPeer().parseAstmRecords(raw).warnings.map((w) => String(w.code));
+  return { content: raw, warnings };
+}
 
 // src/select.ts
 function resolveKind(allowed, requested) {
@@ -737,7 +800,7 @@ var ASTM_QUIRKS = Object.freeze({
   })
 });
 function toleratingProfile(quirk) {
-  return quirk === "unknown-escape" ? astmProfiles.referenceCorpus : void 0;
+  return quirk === "unknown-escape" ? astmPeer().astmProfiles.referenceCorpus : void 0;
 }
 var CR = "\r";
 function applyQuirk(quirk, records) {
@@ -781,7 +844,7 @@ function generateAstmQuirk(options) {
   }
   assertIntendedWarnings(
     descriptor.intendedWarnings,
-    parseAstmRecords(content).warnings.map((w) => String(w.code))
+    astmPeer().parseAstmRecords(content).warnings.map((w) => String(w.code))
   );
   return Object.freeze({
     format: "astm",
@@ -794,12 +857,10 @@ function generateAstmQuirk(options) {
 function astmQuirkRoundTrip(artifact) {
   const quirk = artifact.quirk;
   const descriptor = resolveQuirk(ASTM_QUIRKS, "astm", quirk);
-  const bare = parseAstmRecords(artifact.content).warnings.map((w) => String(w.code));
+  const bare = astmPeer().parseAstmRecords(artifact.content).warnings.map((w) => String(w.code));
   const profile = toleratingProfile(quirk);
   const withProfile = profile !== void 0 && descriptor.toleratingProfile !== void 0 ? (() => {
-    const warnings = parseAstmRecords(artifact.content, { profile }).warnings.map(
-      (w) => String(w.code)
-    );
+    const warnings = astmPeer().parseAstmRecords(artifact.content, { profile }).warnings.map((w) => String(w.code));
     return {
       profileName: descriptor.toleratingProfile,
       disposition: descriptor.disposition,
@@ -849,23 +910,23 @@ var astmQuirkProfile = defineSynthProfile({
 // src/astm/index.ts
 var ALL_KINDS = Object.freeze(["Result", "Order"]);
 var DEFAULT_MIX = ALL_KINDS;
-function generateKind(kind, seed) {
+function generateKind(kind, seed, verify) {
   switch (kind) {
     case "Result":
-      return astmRoundTrip(generateAstmResult({ seed }));
+      return astmCorpusArtifact(generateAstmResult({ seed }), verify);
     case "Order":
-      return astmRoundTrip(generateAstmOrder({ seed }));
+      return astmCorpusArtifact(generateAstmOrder({ seed }), verify);
   }
 }
 function astmCorpus(options) {
-  const { seed } = options;
+  const { seed, verify = true } = options;
   const mix = resolveMix(ALL_KINDS, options.mix, DEFAULT_MIX);
   const count = options.count ?? mix.length;
   const seedStream = createRng(seed);
   const artifacts = Array.from({ length: count }, (_unused, i) => {
     const kind = mix[i % mix.length] ?? "Result";
     const msgSeed = seedStream.nextUint32();
-    const rt = generateKind(kind, msgSeed);
+    const rt = generateKind(kind, msgSeed, verify);
     return {
       format: "astm",
       kind,