@cosyte/terminology 0.0.6 → 0.0.7

package/dist/index.d.cts

@@ -2247,11 +2247,11 @@ declare function parseUcum(unit: string): ParseResult;
  * @throws {Error} If reducing `node` reaches an atom with no linear definition, or one whose
  *   definition does not parse. **No expression {@link parseUcum} accepts reaches either**; a node
  *   you assemble yourself can, including by defining an atom in terms of a special unit such as
- *   `Cel`, which lands on the table's own `Cel`. A third guard, against a definition that leads
- *   back to itself, is **not** reachable from a node you assemble — a definition is resolved
- *   against the bundled table, so your atom can name a table atom but never be one — and is
- *   reached only by mutating an atom of the loaded table in place. The message names the fault,
- *   never the atom.
+ *   `Cel`, which lands on the table's own `Cel`. A third guard catches a definition that leads back
+ *   to itself. Naming a table atom does not reach it — a definition is resolved against the loaded
+ *   table, so your atom can name one but never be one — and neither does the table itself, which is
+ *   frozen; what reaches it is a `value` accessor that re-enters `reduce` for the same atom while
+ *   that atom is still being reduced. The message names the fault, never the atom.
  * @example
  * ```ts
  * import { parseUcum, reduce } from "@cosyte/terminology";
@@ -2282,7 +2282,13 @@ declare function reduce(node: UnitNode): Reduction;
 /**
  * Load the UCUM essence table, parsing the embedded verbatim XML on first call and caching it.
  *
- * @returns The immutable in-memory {@link UcumEssence} model (7 base units, 24 prefixes, ~305 atoms).
+ * One table is shared by every caller and by the engine itself, so it is handed out **frozen**: an
+ * atom's definition cannot be rewritten in place, and neither can the `atoms` array the parser
+ * scans. It used to be, and doing so before that atom's first reduction poisoned the
+ * reduction memo for the life of the process — a fabricated unit equivalence that survived putting
+ * the table back. A write is refused, which in strict mode means a `TypeError`.
+ *
+ * @returns The shared, frozen in-memory {@link UcumEssence} model.
  * @example
  * ```ts
  * import { loadUcumEssence } from "@cosyte/terminology";

package/dist/index.d.ts

@@ -2247,11 +2247,11 @@ declare function parseUcum(unit: string): ParseResult;
  * @throws {Error} If reducing `node` reaches an atom with no linear definition, or one whose
  *   definition does not parse. **No expression {@link parseUcum} accepts reaches either**; a node
  *   you assemble yourself can, including by defining an atom in terms of a special unit such as
- *   `Cel`, which lands on the table's own `Cel`. A third guard, against a definition that leads
- *   back to itself, is **not** reachable from a node you assemble — a definition is resolved
- *   against the bundled table, so your atom can name a table atom but never be one — and is
- *   reached only by mutating an atom of the loaded table in place. The message names the fault,
- *   never the atom.
+ *   `Cel`, which lands on the table's own `Cel`. A third guard catches a definition that leads back
+ *   to itself. Naming a table atom does not reach it — a definition is resolved against the loaded
+ *   table, so your atom can name one but never be one — and neither does the table itself, which is
+ *   frozen; what reaches it is a `value` accessor that re-enters `reduce` for the same atom while
+ *   that atom is still being reduced. The message names the fault, never the atom.
  * @example
  * ```ts
  * import { parseUcum, reduce } from "@cosyte/terminology";
@@ -2282,7 +2282,13 @@ declare function reduce(node: UnitNode): Reduction;
 /**
  * Load the UCUM essence table, parsing the embedded verbatim XML on first call and caching it.
  *
- * @returns The immutable in-memory {@link UcumEssence} model (7 base units, 24 prefixes, ~305 atoms).
+ * One table is shared by every caller and by the engine itself, so it is handed out **frozen**: an
+ * atom's definition cannot be rewritten in place, and neither can the `atoms` array the parser
+ * scans. It used to be, and doing so before that atom's first reduction poisoned the
+ * reduction memo for the life of the process — a fabricated unit equivalence that survived putting
+ * the table back. A write is refused, which in strict mode means a `TypeError`.
+ *
+ * @returns The shared, frozen in-memory {@link UcumEssence} model.
  * @example
  * ```ts
  * import { loadUcumEssence } from "@cosyte/terminology";

package/dist/index.mjs

@@ -3731,7 +3731,29 @@ function parseEssence(xml) {
   atoms.sort((a, b) => b.code.length - a.code.length);
   const atomByCode = new Map(atoms.map((a) => [a.code, a]));
   const prefixByCode = new Map(prefixes.map((p) => [p.code, p]));
-  return { prefixes, atoms, atomByCode, prefixByCode };
+  return freezeEssence({ prefixes, atoms, atomByCode, prefixByCode });
+}
+function refuseTableWrite() {
+  throw new TypeError("the UCUM unit table is immutable");
+}
+function sealLookup(map) {
+  return Object.defineProperties(map, {
+    set: { value: refuseTableWrite },
+    delete: { value: refuseTableWrite },
+    clear: { value: refuseTableWrite }
+  });
+}
+function freezeEssence(essence) {
+  for (const atom of essence.atoms) {
+    if (atom.value) Object.freeze(atom.value);
+    Object.freeze(atom);
+  }
+  for (const prefix of essence.prefixes) Object.freeze(prefix);
+  Object.freeze(essence.atoms);
+  Object.freeze(essence.prefixes);
+  sealLookup(essence.atomByCode);
+  sealLookup(essence.prefixByCode);
+  return Object.freeze(essence);
 }
 var cached;
 function loadUcumEssence() {
@@ -4729,7 +4751,7 @@ function approximateMatch(graph, query, options = {}) {
 }
 
 // src/index.ts
-var VERSION = "0.0.6";
+var VERSION = "0.0.7";
 
 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