@cosyte/terminology 0.0.10 → 0.0.12

package/dist/index.mjs

@@ -18,7 +18,7 @@ function codeableConcept(init) {
 // src/common/diagnostics.ts
 var DIAGNOSTIC_CODES = {
   /**
-   * A `$translate` found no target for the source code. A **first-class outcome, never an error** —
+   * A `$translate` found no target for the source code. A **first-class outcome, never an error**:
    * the source is surfaced as `unmapped`, never replaced with a guessed target (the never-fabricate
    * invariant).
    */
@@ -29,30 +29,30 @@ var DIAGNOSTIC_CODES = {
    */
   TERM_SYSTEM_UNRECOGNIZED: "TERM_SYSTEM_UNRECOGNIZED",
   /**
-   * An RRF (pipe-delimited RxNorm/UMLS release) row was structurally unusable — too few columns to
+   * An RRF (pipe-delimited RxNorm/UMLS release) row was structurally unusable: too few columns to
    * reach a configured field, or a missing code. The row is **skipped and surfaced** as a load
    * warning (liberal on load), never kept as a partially-parsed concept.
    */
   TERM_RRF_MALFORMED_ROW: "TERM_RRF_MALFORMED_ROW",
   /**
-   * A CSV (RFC-4180, e.g. LOINC `Loinc.csv`) row was structurally unusable — too few fields to reach
+   * A CSV (RFC-4180, e.g. LOINC `Loinc.csv`) row was structurally unusable: too few fields to reach
    * a configured column. The row is **skipped and surfaced** as a load warning, never partial.
    */
   TERM_CSV_MALFORMED: "TERM_CSV_MALFORMED",
   /**
-   * A fixed-width (e.g. ICD-10-CM order file) row was structurally unusable — too short to contain
+   * A fixed-width (e.g. ICD-10-CM order file) row was structurally unusable: too short to contain
    * the configured code field, or a missing code. Skipped and surfaced, never partial.
    */
   TERM_FIXED_WIDTH_MALFORMED: "TERM_FIXED_WIDTH_MALFORMED",
   /**
-   * A concept inside a FHIR `CodeSystem` resource was unusable — not an object, or missing its
+   * A concept inside a FHIR `CodeSystem` resource was unusable: not an object, or missing its
    * required `code`. Skipped and surfaced (the whole resource still loads); `line` is `0` since a
    * JSON concept is not line-addressable.
    */
   TERM_FHIR_CONCEPT_MALFORMED: "TERM_FHIR_CONCEPT_MALFORMED",
   /**
    * A `$lookup`/`$validate-code` found no concept for the code in the loaded release. A **first-class
-   * typed outcome, never a guess** — the engine returns `unknown`/`valid: false`, never a fabricated
+   * typed outcome, never a guess**: the engine returns `unknown`/`valid: false`, never a fabricated
    * display or a coerced `valid: true` (the never-fabricate invariant, applied to code identity).
    */
   TERM_CODE_UNKNOWN: "TERM_CODE_UNKNOWN",
@@ -69,7 +69,7 @@ var DIAGNOSTIC_CODES = {
    */
   TERM_CONCEPT_HEADER_NOT_BILLABLE: "TERM_CONCEPT_HEADER_NOT_BILLABLE",
   /**
-   * A ValueSet `compose` part could **not be expanded** — an intensional `include`/`exclude` whose
+   * A ValueSet `compose` part could **not be expanded**: an intensional `include`/`exclude` whose
    * code system was not supplied, an unresolvable referenced value set, or a `filter` operator the
    * engine does not implement. Surfaced as a typed outcome that marks the expansion **incomplete**;
    * the engine **never** fabricates a member and **never** returns a silently-empty "no members"
@@ -77,14 +77,14 @@ var DIAGNOSTIC_CODES = {
    */
   TERM_VALUESET_CANNOT_EXPAND: "TERM_VALUESET_CANNOT_EXPAND",
   /**
-   * A **pre-computed** `ValueSet.expansion` is **incomplete** — its `total` exceeds the number of
+   * A **pre-computed** `ValueSet.expansion` is **incomplete**: its `total` exceeds the number of
    * `contains` entries, or it is flagged too-costly (the VSAC `$expand` >1200-code truncation
    * hazard). The engine **never treats a truncated expansion as complete membership**: a code
    * absent from a truncated expansion is `undetermined`, never a confident "not a member".
    */
   TERM_VALUESET_EXPANSION_TRUNCATED: "TERM_VALUESET_EXPANSION_TRUNCATED",
   /**
-   * A UCUM unit expression is **not valid** — it does not parse against the UCUM grammar, or it
+   * A UCUM unit expression is **not valid**: it does not parse against the UCUM grammar, or it
    * names an atom absent from the vendored UCUM table. A **first-class typed outcome, never an
    * error and never a guess**: {@link validateUcum} returns `{ valid: false, reason }`, never a
    * coerced or "nearest" unit (the never-fabricate invariant, applied to units). The
@@ -92,7 +92,7 @@ var DIAGNOSTIC_CODES = {
    */
   TERM_UCUM_INVALID: "TERM_UCUM_INVALID",
   /**
-   * A crosswalk source code has an **authored No-Map** — the steward declares it has no valid target
+   * A crosswalk source code has an **authored No-Map**: the steward declares it has no valid target
    * in the other classification (a GEM `NoDx`/`NoPCS` sentinel, or a SNOMED complex-map `447638001`
    * "cannot be classified" category). A **first-class typed outcome, never an error and never a
    * guess** (the never-fabricate invariant, applied to crosswalks). Distinct from
@@ -100,7 +100,7 @@ var DIAGNOSTIC_CODES = {
    */
   TERM_CROSSWALK_NO_MAP: "TERM_CROSSWALK_NO_MAP",
   /**
-   * A crosswalk source code is **absent from the map entirely** — not an authored No-Map, simply not
+   * A crosswalk source code is **absent from the map entirely**: not an authored No-Map, simply not
    * present. Surfaced as a typed outcome (never a fabricated target, never a silent success), and
    * kept distinct from {@link TERM_CROSSWALK_NO_MAP} so a caller can tell "the steward said no target"
    * from "this code was not in the file".
@@ -109,26 +109,26 @@ var DIAGNOSTIC_CODES = {
   /**
    * A SNOMED→ICD-10-CM complex-map group's decision needs **patient context** (an `IFA` age band or
    * gender) the caller did not supply. The engine surfaces the candidate rules + advice and **refuses
-   * to pick a branch** it lacks the data for — never a silently-chosen target.
+   * to pick a branch** it lacks the data for: never a silently-chosen target.
    */
   TERM_CROSSWALK_CONTEXT_REQUIRED: "TERM_CROSSWALK_CONTEXT_REQUIRED",
   /**
-   * A GEM file line was structurally unusable — not three whitespace-delimited fields, or a flag
+   * A GEM file line was structurally unusable: not three whitespace-delimited fields, or a flag
    * field that is not a 5-digit code. The row is **skipped and surfaced** as a load warning (liberal
    * on load), never kept as a partially-parsed entry.
    */
   TERM_GEM_MALFORMED_ROW: "TERM_GEM_MALFORMED_ROW",
   /**
-   * A SNOMED complex-map RF2 refset row was structurally unusable — missing its
+   * A SNOMED complex-map RF2 refset row was structurally unusable: missing its
    * `referencedComponentId`/`mapGroup`/`mapPriority`. Skipped and surfaced, never partial.
    */
   TERM_COMPLEX_MAP_MALFORMED_ROW: "TERM_COMPLEX_MAP_MALFORMED_ROW",
   /**
-   * A RxNorm RRF row (`RXNCONSO` / `RXNREL` / `RXNSAT`) was structurally unusable — too few columns to
+   * A RxNorm RRF row (`RXNCONSO` / `RXNREL` / `RXNSAT`) was structurally unusable: too few columns to
    * reach a required field, or a missing `RXCUI`/NDC value. The row is **skipped and surfaced** as a
    * load warning (liberal on load), never kept as a partial concept/edge. Rows that are simply *not of
    * interest* (a non-`RXNORM` atom, an atom-level relationship, a non-`NDC` attribute) are skipped
-   * **silently** — they are expected, not faults.
+   * **silently**: they are expected, not faults.
    */
   TERM_RXNORM_MALFORMED_ROW: "TERM_RXNORM_MALFORMED_ROW",
   /**
@@ -142,7 +142,7 @@ var DIAGNOSTIC_CODES = {
    */
   TERM_RXNORM_UNTYPED_CONCEPT: "TERM_RXNORM_UNTYPED_CONCEPT",
   /**
-   * A RxNorm graph navigation was asked about an `RXCUI` **absent from the loaded release** — a
+   * A RxNorm graph navigation was asked about an `RXCUI` **absent from the loaded release**: a
    * first-class typed outcome, never a fabricated concept and never an empty "success" (the
    * never-fabricate invariant, applied to the drug graph). Distinct from a *present*
    * concept that simply has no edge of the requested relationship (that is a found result with empty
@@ -150,7 +150,7 @@ var DIAGNOSTIC_CODES = {
    */
   TERM_RXNORM_UNKNOWN_RXCUI: "TERM_RXNORM_UNKNOWN_RXCUI",
   /**
-   * An NDC could **not be resolved** to any `RXCUI` in the loaded RxNorm release — a typed, surfaced
+   * An NDC could **not be resolved** to any `RXCUI` in the loaded RxNorm release: a typed, surfaced
    * absence, never a guessed `RXCUI`. NDC↔RXCUI is many:1 and temporal, so a resolution
    * is always release-scoped; an NDC not present in the loaded release is this diagnostic.
    */
@@ -158,33 +158,33 @@ var DIAGNOSTIC_CODES = {
 };
 var FATAL_CODES = {
   /**
-   * A `ConceptMap` resource was structurally unusable — wrong `resourceType`, or a group/element
+   * A `ConceptMap` resource was structurally unusable: wrong `resourceType`, or a group/element
    * missing a required field. Thrown rather than silently loading a partial, misleading map.
    */
   TERM_CONCEPTMAP_MALFORMED: "TERM_CONCEPTMAP_MALFORMED",
   /**
-   * A CodeSystem *source* was structurally unusable — a FHIR resource with the wrong `resourceType`,
+   * A CodeSystem *source* was structurally unusable: a FHIR resource with the wrong `resourceType`,
    * or a delimited source whose configured code/display column is absent from the header. Thrown
    * rather than silently loading an empty or mis-keyed release. (Malformed individual **rows** are
-   * skipped-and-surfaced load warnings, not fatals — only an unusable *source* is fatal.)
+   * skipped-and-surfaced load warnings, not fatals: only an unusable *source* is fatal.)
    */
   TERM_CODESYSTEM_MALFORMED: "TERM_CODESYSTEM_MALFORMED",
   /**
-   * A `ValueSet` resource was structurally unusable — wrong `resourceType`, or a `compose`/`expansion`
+   * A `ValueSet` resource was structurally unusable: wrong `resourceType`, or a `compose`/`expansion`
    * whose required shape (an `include` that is not an object, a `contains` entry missing its `code`)
    * is corrupt. Thrown rather than silently loading a partial value set that would bind *some* codes
-   * and quietly drop others. (A `filter` operator the engine does not implement is **not** fatal — it
+   * and quietly drop others. (A `filter` operator the engine does not implement is **not** fatal; it
    * is the surfaced `TERM_VALUESET_CANNOT_EXPAND` diagnostic at expansion time.)
    */
   TERM_VALUESET_MALFORMED: "TERM_VALUESET_MALFORMED",
   /**
-   * A crosswalk map *source* was structurally unusable — e.g. a SNOMED complex-map RF2 refset with
+   * A crosswalk map *source* was structurally unusable: e.g. a SNOMED complex-map RF2 refset with
    * empty content or a header missing a required column. Thrown rather than silently loading an empty
    * or mis-keyed map. (Malformed individual **rows** are skipped-and-surfaced warnings, not fatals.)
    */
   TERM_CROSSWALK_MALFORMED: "TERM_CROSSWALK_MALFORMED",
   /**
-   * An **inversion** of a directional crosswalk was requested — a forbidden operation. The GEMs and
+   * An **inversion** of a directional crosswalk was requested: a forbidden operation. The GEMs and
    * the SNOMED→ICD-10-CM map are authoritative in **one direction only**; a forward map is not the
    * inverse of the backward map. Thrown by {@link ../crosswalk/gems.invertGem} so the
    * never-invert refusal is a first-class, discoverable contract rather than a silent absence.
@@ -197,7 +197,7 @@ var TerminologyError = class _TerminologyError extends Error {
   /**
    * @param code - The stable {@link FatalCode} describing the fault.
    * @param message - A **value-free** structural description (path + fault; never an input value).
-   *   Every piece of it must be engine-owned — a literal, a frozen-table entry, or a locus this
+   *   Every piece of it must be engine-owned: a literal, a frozen-table entry, or a locus this
    *   package built. This string reaches `err.stack`, so interpolating a caller-supplied or
    *   document-derived value into it is how a diagnostic becomes a leak.
    */
@@ -3912,7 +3912,7 @@ function parseTerm(cur, inParen) {
     factors.push({ sign: op === "/" ? -1 : 1, node: comp.node });
   }
   if (inParen) {
-    if (cur.s[cur.pos] !== ")") return { ok: false, reason: "unbalanced '(' \u2014 missing ')'" };
+    if (cur.s[cur.pos] !== ")") return { ok: false, reason: "unbalanced '(': missing ')'" };
     cur.pos++;
   }
   return { ok: true, node: { kind: "term", factors } };
@@ -4185,10 +4185,10 @@ function applyGem(map, source) {
   return Object.freeze(matched);
 }
 var NOT_INVERTIBLE_MESSAGE = /* @__PURE__ */ new Map([
-  ["9-to-10", "GEM map (direction 9-to-10) cannot be inverted \u2014 load the 10-to-9 GEM file instead"],
-  ["10-to-9", "GEM map (direction 10-to-9) cannot be inverted \u2014 load the 9-to-10 GEM file instead"]
+  ["9-to-10", "GEM map (direction 9-to-10) cannot be inverted: load the 10-to-9 GEM file instead"],
+  ["10-to-9", "GEM map (direction 10-to-9) cannot be inverted: load the 9-to-10 GEM file instead"]
 ]);
-var NOT_INVERTIBLE_UNKNOWN_DIRECTION = "GEM map cannot be inverted \u2014 load the reverse GEM file instead";
+var NOT_INVERTIBLE_UNKNOWN_DIRECTION = "GEM map cannot be inverted: load the reverse GEM file instead";
 function invertGem(map) {
   throw new TerminologyError(
     FATAL_CODES.TERM_MAP_NOT_INVERTIBLE,
@@ -4198,13 +4198,13 @@ function invertGem(map) {
 
 // src/crosswalk/categories.ts
 var MAP_CATEGORIES = {
-  /** `447637006` — "Map source concept is properly classified" (a normal, usable target). */
+  /** `447637006`: "Map source concept is properly classified" (a normal, usable target). */
   PROPERLY_CLASSIFIED: "447637006",
-  /** `447638001` — "Map source concept cannot be classified with available data" — a **No-Map**. */
+  /** `447638001`: "Map source concept cannot be classified with available data" (a **No-Map**). */
   NO_MAP: "447638001",
-  /** `447639009` — "Map of source concept is context dependent" (needs runtime patient context). */
+  /** `447639009`: "Map of source concept is context dependent" (needs runtime patient context). */
   CONTEXT_DEPENDENT: "447639009",
-  /** `447640006` — "Source concept is ambiguous" — surface candidates, never pick one. */
+  /** `447640006`: "Source concept is ambiguous" (surface candidates, never pick one). */
   AMBIGUOUS: "447640006"
 };
 var NO_MAP_CATEGORIES = /* @__PURE__ */ new Set([MAP_CATEGORIES.NO_MAP]);
@@ -4633,37 +4633,37 @@ var RELA = {
    * Neither reaches an `SCD`.
    */
   INGREDIENT_OF: "ingredient_of",
-  /** `has_precise_ingredient` — subject *has precise ingredient* object (a `PIN`). */
+  /** `has_precise_ingredient`: subject *has precise ingredient* object (a `PIN`). */
   HAS_PRECISE_INGREDIENT: "has_precise_ingredient",
-  /** `precise_ingredient_of` — inverse of `has_precise_ingredient`. */
+  /** `precise_ingredient_of`: inverse of `has_precise_ingredient`. */
   PRECISE_INGREDIENT_OF: "precise_ingredient_of",
-  /** `tradename_of` — subject (a branded concept) *is a tradename of* object (its generic). */
+  /** `tradename_of`: subject (a branded concept) *is a tradename of* object (its generic). */
   TRADENAME_OF: "tradename_of",
-  /** `has_tradename` — subject (a generic concept) *has tradename* object (a branded concept). */
+  /** `has_tradename`: subject (a generic concept) *has tradename* object (a branded concept). */
   HAS_TRADENAME: "has_tradename",
-  /** `has_dose_form` — subject (a drug) *has dose form* object (a `DF`). */
+  /** `has_dose_form`: subject (a drug) *has dose form* object (a `DF`). */
   HAS_DOSE_FORM: "has_dose_form",
-  /** `dose_form_of` — subject (a `DF`) *is the dose form of* object (a drug). */
+  /** `dose_form_of`: subject (a `DF`) *is the dose form of* object (a drug). */
   DOSE_FORM_OF: "dose_form_of",
-  /** `has_doseformgroup` — subject *has dose-form group* object (a `DFG`). */
+  /** `has_doseformgroup`: subject *has dose-form group* object (a `DFG`). */
   HAS_DOSE_FORM_GROUP: "has_doseformgroup",
-  /** `doseformgroup_of` — inverse of `has_doseformgroup`. */
+  /** `doseformgroup_of`: inverse of `has_doseformgroup`. */
   DOSE_FORM_GROUP_OF: "doseformgroup_of",
-  /** `consists_of` — subject (an `SCD`/`SBD`) *consists of* object (its `SCDC`/`SBDC` component(s)). */
+  /** `consists_of`: subject (an `SCD`/`SBD`) *consists of* object (its `SCDC`/`SBDC` component(s)). */
   CONSISTS_OF: "consists_of",
-  /** `constitutes` — subject (a component) *constitutes* object (the drug). Inverse of `consists_of`. */
+  /** `constitutes`: subject (a component) *constitutes* object (the drug). Inverse of `consists_of`. */
   CONSTITUTES: "constitutes",
-  /** `contains` — subject (a pack) *contains* object (a member drug). */
+  /** `contains`: subject (a pack) *contains* object (a member drug). */
   CONTAINS: "contains",
-  /** `contained_in` — subject (a drug) *is contained in* object (a pack). Inverse of `contains`. */
+  /** `contained_in`: subject (a drug) *is contained in* object (a pack). Inverse of `contains`. */
   CONTAINED_IN: "contained_in",
-  /** `has_quantified_form` — subject *has quantified form* object. */
+  /** `has_quantified_form`: subject *has quantified form* object. */
   HAS_QUANTIFIED_FORM: "has_quantified_form",
-  /** `quantified_form_of` — inverse of `has_quantified_form`. */
+  /** `quantified_form_of`: inverse of `has_quantified_form`. */
   QUANTIFIED_FORM_OF: "quantified_form_of",
-  /** `isa` — subject *is a* object (hierarchical, e.g. `SCD isa SCDG`). */
+  /** `isa`: subject *is a* object (hierarchical, e.g. `SCD isa SCDG`). */
   ISA: "isa",
-  /** `inverse_isa` — subject *is a parent of* object. Inverse of `isa`. */
+  /** `inverse_isa`: subject *is a parent of* object. Inverse of `isa`. */
   INVERSE_ISA: "inverse_isa"
 };
 var RELA_INVERSE = Object.freeze({
@@ -4774,7 +4774,7 @@ function approximateMatch(graph, query, options = {}) {
 }
 
 // src/index.ts
-var VERSION = "0.0.10";
+var VERSION = "0.0.12";
 
 export { COMPLEX_MAP_SOURCE_SYSTEM, DIAGNOSTIC_CODES, FATAL_CODES, HL7_V2_OID_ROOT, HL7_V2_URL_PREFIX, ICD10CM_ORDER_FILE_FIELDS, ICD10CM_SYSTEM, ICD9CM_SYSTEM, MAP_CATEGORIES, NO_MAP_CATEGORIES, RELA, RELA_INVERSE, RXNORM_SYSTEM, SNOMEDCT_SYSTEM, SYSTEM_IDENTITIES, TERM_TYPES, TerminologyError, VERSION, applyComplexMap, applyGem, approximateMatch, asTermType, brandsFor, buildSubsumption, codeableConcept, coding, consistsOf, defaultStatusMapper, doseFormsOf, expand, genericFor, getArray, getBoolean, getConcept, getNumber, getString, ingredientsOf, invertGem, isA, isJsonObject, isSynonymTermType, isUnknownSystem, loadCodeSystem, loadComplexMap, loadConceptMap, loadGems, loadRxNormGraph, loadUcumEssence, loadValueSet, lookup, makeStatus, matchesFilter, parseCsv, parseCsvSource, parseFhirCodeSystem, parseFixedWidth, parseRrf, parseRrfLine, parseUcum, reduce, relatedByRela, resolveNdc, resolveSystem, sliceField, translate, ucumEqual, unsupportedOps, validateCode, validateCodeInValueSet, validateUcum };
 //# sourceMappingURL=index.mjs.map