ezmedicationinput 0.1.48 → 0.1.50

package/dist/fhir-translations.d.ts

@@ -1,8 +1,11 @@
 import { FhirExtension, FhirPrimitiveElement } from "./types";
 export declare const FHIR_TRANSLATION_EXTENSION_URL = "http://hl7.org/fhir/StructureDefinition/translation";
 export declare function cloneI18nRecord(i18n: Record<string, string> | undefined): Record<string, string> | undefined;
+export declare function mergeI18nRecords(...records: Array<Record<string, string> | undefined>): Record<string, string> | undefined;
 export declare function cloneExtension(extension: FhirExtension): FhirExtension;
 export declare function cloneExtensions(extensions: FhirExtension[] | undefined): FhirExtension[] | undefined;
 export declare function clonePrimitiveElement(element: FhirPrimitiveElement | undefined): FhirPrimitiveElement | undefined;
 export declare function buildTranslationPrimitiveElement(translations: Record<string, string> | undefined, base?: FhirPrimitiveElement): FhirPrimitiveElement | undefined;
+export declare function mergeTranslationPrimitiveElement(base: FhirPrimitiveElement | undefined, translations: Record<string, string> | undefined): FhirPrimitiveElement | undefined;
 export declare function getPrimitiveTranslation(element: FhirPrimitiveElement | undefined, locale: string | undefined): string | undefined;
+export declare function getPrimitiveTranslations(element: FhirPrimitiveElement | undefined): Record<string, string> | undefined;

package/dist/fhir.d.ts

@@ -7,6 +7,11 @@ export interface FhirProjectionOptions {
      * Dosage.site.coding while preserving the spatial-relation extension.
      */
     bodySitePostcoordination?: boolean;
+    /**
+     * Emits FHIR primitive translation extensions on coded concepts when
+     * translation metadata is available.
+     */
+    includeTranslationExtensions?: boolean;
 }
 export declare function canonicalToFhir(clause: CanonicalSigClause, textOverride?: string, options?: FhirProjectionOptions): FhirDosage;
 export declare function toFhir(state: ParserState): FhirDosage;

package/dist/index.cjs

@@ -481,6 +481,24 @@ function normalizeLocaleKey(locale) {
 function cloneI18nRecord(i18n) {
   return i18n ? __spreadValues({}, i18n) : void 0;
 }
+function mergeI18nRecords(...records) {
+  var _a2;
+  const merged = {};
+  for (const record of records) {
+    if (!record) {
+      continue;
+    }
+    for (const locale in record) {
+      const normalizedLocale = normalizeLocaleKey(locale);
+      const content = (_a2 = record[locale]) == null ? void 0 : _a2.trim();
+      if (!normalizedLocale || !content) {
+        continue;
+      }
+      merged[normalizedLocale] = content;
+    }
+  }
+  return Object.keys(merged).length ? merged : void 0;
+}
 function cloneExtension(extension) {
   var _a2, _b, _c, _d;
   return {
@@ -567,6 +585,32 @@ function buildTranslationPrimitiveElement(translations, base) {
     extension: nextExtensions
   };
 }
+function mergeTranslationPrimitiveElement(base, translations) {
+  var _a2, _b, _c, _d;
+  const nextExtensions = (_b = (_a2 = base == null ? void 0 : base.extension) == null ? void 0 : _a2.map(cloneExtension)) != null ? _b : [];
+  const existingTranslationLocales = /* @__PURE__ */ new Set();
+  for (const extension of nextExtensions) {
+    if (extension.url !== FHIR_TRANSLATION_EXTENSION_URL) {
+      continue;
+    }
+    const { locale } = getTranslationParts(extension);
+    if (locale) {
+      existingTranslationLocales.add(locale);
+    }
+  }
+  const additions = (_d = (_c = buildTranslationPrimitiveElement(translations)) == null ? void 0 : _c.extension) != null ? _d : [];
+  for (const extension of additions) {
+    const { locale } = getTranslationParts(extension);
+    if (locale && existingTranslationLocales.has(locale)) {
+      continue;
+    }
+    if (locale) {
+      existingTranslationLocales.add(locale);
+    }
+    nextExtensions.push(extension);
+  }
+  return nextExtensions.length ? { extension: nextExtensions } : void 0;
+}
 function getTranslationParts(extension) {
   var _a2, _b;
   const parts = (_a2 = extension.extension) != null ? _a2 : [];
@@ -610,6 +654,24 @@ function getPrimitiveTranslation(element, locale) {
   }
   return languagePrefixMatch;
 }
+function getPrimitiveTranslations(element) {
+  var _a2;
+  if (!((_a2 = element == null ? void 0 : element.extension) == null ? void 0 : _a2.length)) {
+    return void 0;
+  }
+  const translations = {};
+  for (const extension of element.extension) {
+    if (extension.url !== FHIR_TRANSLATION_EXTENSION_URL) {
+      continue;
+    }
+    const { locale, content } = getTranslationParts(extension);
+    if (!locale || !content) {
+      continue;
+    }
+    translations[locale] = content;
+  }
+  return Object.keys(translations).length ? translations : void 0;
+}
 
 // src/body-site-spatial.ts
 var SNOMED_SYSTEM2 = "http://snomed.info/sct";
@@ -1178,6 +1240,7 @@ var DEFAULT_BODY_SITE_SNOMED_SOURCE = [
     definition: {
       coding: { code: "81745001", display: "Eye" },
       text: "eye",
+      i18n: { th: "\u0E15\u0E32" },
       routeHint: RouteCode["Ophthalmic route"]
     }
   },
@@ -1186,6 +1249,7 @@ var DEFAULT_BODY_SITE_SNOMED_SOURCE = [
     definition: {
       coding: { code: "1290031003", display: "Structure of left eye proper" },
       text: "left eye",
+      i18n: { th: "\u0E15\u0E32\u0E0B\u0E49\u0E32\u0E22" },
       routeHint: RouteCode["Ophthalmic route"]
     }
   },
@@ -1194,6 +1258,7 @@ var DEFAULT_BODY_SITE_SNOMED_SOURCE = [
     definition: {
       coding: { code: "1290032005", display: "Structure of right eye proper" },
       text: "right eye",
+      i18n: { th: "\u0E15\u0E32\u0E02\u0E27\u0E32" },
       routeHint: RouteCode["Ophthalmic route"]
     }
   },
@@ -1202,6 +1267,7 @@ var DEFAULT_BODY_SITE_SNOMED_SOURCE = [
     definition: {
       coding: { code: "40638003", display: "Structure of both eyes" },
       text: "both eyes",
+      i18n: { th: "\u0E15\u0E32\u0E17\u0E31\u0E49\u0E07\u0E2A\u0E2D\u0E07\u0E02\u0E49\u0E32\u0E07" },
       routeHint: RouteCode["Ophthalmic route"]
     }
   },
@@ -4591,7 +4657,8 @@ function buildBodySiteCoding(definition) {
   return {
     code: coding.code,
     display: coding.display,
-    system: (_a2 = coding.system) != null ? _a2 : SNOMED_SYSTEM3
+    system: (_a2 = coding.system) != null ? _a2 : SNOMED_SYSTEM3,
+    i18n: mergeI18nRecords(definition == null ? void 0 : definition.i18n, coding.i18n)
   };
 }
 function cloneBodySiteCode(coding) {
@@ -4603,7 +4670,7 @@ function cloneBodySiteCode(coding) {
     code: coding.code,
     display: coding.display,
     system: (_a2 = coding.system) != null ? _a2 : SNOMED_SYSTEM3,
-    i18n: coding.i18n
+    i18n: mergeI18nRecords(coding.i18n)
   };
 }
 function lookupDefinitionForCanonical(canonical, customSiteMap) {
@@ -10026,6 +10093,7 @@ var ParserState = class {
     for (const reason of value) {
       reasons.push({
         text: reason.text,
+        i18n: cloneI18nRecord(reason.i18n),
         spatialRelation: cloneBodySiteSpatialRelation(reason.spatialRelation),
         coding: reason.coding ? {
           code: reason.coding.code,
@@ -10033,7 +10101,7 @@ var ParserState = class {
           system: reason.coding.system,
           extension: cloneExtensions(reason.coding.extension),
           _display: clonePrimitiveElement(reason.coding._display),
-          i18n: reason.coding.i18n
+          i18n: cloneI18nRecord(reason.coding.i18n)
         } : void 0
       });
     }
@@ -10065,7 +10133,7 @@ var ParserState = class {
       system: value.system,
       extension: cloneExtensions(value.extension),
       _display: clonePrimitiveElement(value._display),
-      i18n: value.i18n
+      i18n: cloneI18nRecord(value.i18n)
     } : void 0;
   }
   get siteText() {
@@ -10098,7 +10166,7 @@ var ParserState = class {
       code: value.code,
       display: value.display,
       system: value.system,
-      i18n: value.i18n
+      i18n: cloneI18nRecord(value.i18n)
     } : void 0;
   }
   get siteSpatialRelation() {
@@ -10283,17 +10351,18 @@ function selectCanonicalSiteCoding(site, options) {
   );
   return (options == null ? void 0 : options.bodySitePostcoordination) === true ? postcoordinated != null ? postcoordinated : site == null ? void 0 : site.coding : (_a2 = site == null ? void 0 : site.coding) != null ? _a2 : postcoordinated;
 }
-function buildSiteCodingArray(siteCoding) {
+function buildSiteCodingArray(siteCoding, options) {
   var _a2;
   if (!(siteCoding == null ? void 0 : siteCoding.code)) {
     return void 0;
   }
+  const displayElement = (options == null ? void 0 : options.includeTranslationExtensions) ? buildTranslationPrimitiveElement(siteCoding.i18n) : void 0;
   return [
-    {
+    __spreadValues({
       system: (_a2 = siteCoding.system) != null ? _a2 : SNOMED_SYSTEM5,
       code: siteCoding.code,
       display: siteCoding.display
-    }
+    }, displayElement ? { _display: displayElement } : {})
   ];
 }
 function getFallbackSiteText(site) {
@@ -10307,6 +10376,18 @@ function getFallbackSiteText(site) {
     display: siteCoding.display
   }) : void 0;
 }
+function codeableConceptTranslationI18n(concept, coding, fallback) {
+  return {
+    text: mergeI18nRecords(
+      fallback,
+      getPrimitiveTranslations(concept == null ? void 0 : concept._text)
+    ),
+    display: mergeI18nRecords(
+      coding == null ? void 0 : coding.i18n,
+      getPrimitiveTranslations(coding == null ? void 0 : coding._display)
+    )
+  };
+}
 function lowerFirst(value) {
   const trimmed = value == null ? void 0 : value.trim();
   return trimmed ? trimmed.charAt(0).toLowerCase() + trimmed.slice(1) : void 0;
@@ -10553,7 +10634,7 @@ function appendWarning(warnings, warning) {
   return warnings;
 }
 function canonicalToFhir(clause, textOverride, options) {
-  var _a2, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k, _l, _m, _n, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x, _y, _z, _A, _B, _C, _D, _E, _F, _G;
+  var _a2, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k, _l, _m, _n, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x, _y, _z, _A, _B, _C, _D, _E, _F, _G, _H, _I, _J;
   const dosage = {};
   const repeat = {};
   let hasRepeat = false;
@@ -10653,19 +10734,21 @@ function canonicalToFhir(clause, textOverride, options) {
   }
   if (((_l = clause.site) == null ? void 0 : _l.text) || ((_n = (_m = clause.site) == null ? void 0 : _m.coding) == null ? void 0 : _n.code) || ((_o = clause.site) == null ? void 0 : _o.spatialRelation)) {
     const siteCoding = selectCanonicalSiteCoding(clause.site, options);
-    dosage.site = {
-      text: (_p = clause.site) == null ? void 0 : _p.text,
-      coding: buildSiteCodingArray(siteCoding),
-      extension: buildBodySiteSpatialRelationExtensions((_q = clause.site) == null ? void 0 : _q.spatialRelation)
-    };
+    const siteTextElement = (options == null ? void 0 : options.includeTranslationExtensions) ? buildTranslationPrimitiveElement((_p = clause.site.i18n) != null ? _p : siteCoding == null ? void 0 : siteCoding.i18n) : void 0;
+    dosage.site = __spreadProps(__spreadValues({
+      text: (_q = clause.site) == null ? void 0 : _q.text
+    }, siteTextElement ? { _text: siteTextElement } : {}), {
+      coding: buildSiteCodingArray(siteCoding, options),
+      extension: buildBodySiteSpatialRelationExtensions((_r = clause.site) == null ? void 0 : _r.spatialRelation)
+    });
   }
-  if (((_r = clause.method) == null ? void 0 : _r.text) || ((_s = clause.method) == null ? void 0 : _s._text) || ((_u = (_t = clause.method) == null ? void 0 : _t.coding) == null ? void 0 : _u.code)) {
+  if (((_s = clause.method) == null ? void 0 : _s.text) || ((_t = clause.method) == null ? void 0 : _t._text) || ((_v = (_u = clause.method) == null ? void 0 : _u.coding) == null ? void 0 : _v.code)) {
     dosage.method = {
-      text: (_v = clause.method) == null ? void 0 : _v.text,
-      _text: clonePrimitiveElement((_w = clause.method) == null ? void 0 : _w._text),
-      coding: ((_y = (_x = clause.method) == null ? void 0 : _x.coding) == null ? void 0 : _y.code) ? [
+      text: (_w = clause.method) == null ? void 0 : _w.text,
+      _text: clonePrimitiveElement((_x = clause.method) == null ? void 0 : _x._text),
+      coding: ((_z = (_y = clause.method) == null ? void 0 : _y.coding) == null ? void 0 : _z.code) ? [
         {
-          system: (_z = clause.method.coding.system) != null ? _z : SNOMED_SYSTEM5,
+          system: (_A = clause.method.coding.system) != null ? _A : SNOMED_SYSTEM5,
           code: clause.method.coding.code,
           display: clause.method.coding.display,
           _display: clonePrimitiveElement(clause.method.coding._display)
@@ -10673,14 +10756,14 @@ function canonicalToFhir(clause, textOverride, options) {
       ] : void 0
     };
   }
-  if ((_A = clause.additionalInstructions) == null ? void 0 : _A.length) {
+  if ((_B = clause.additionalInstructions) == null ? void 0 : _B.length) {
     dosage.additionalInstruction = [];
     for (const instruction of clause.additionalInstructions) {
       dosage.additionalInstruction.push({
         text: instruction.text,
-        coding: ((_B = instruction.coding) == null ? void 0 : _B.code) ? [
+        coding: ((_C = instruction.coding) == null ? void 0 : _C.code) ? [
           {
-            system: (_C = instruction.coding.system) != null ? _C : SNOMED_SYSTEM5,
+            system: (_D = instruction.coding.system) != null ? _D : SNOMED_SYSTEM5,
             code: instruction.coding.code,
             display: instruction.coding.display
           }
@@ -10688,9 +10771,9 @@ function canonicalToFhir(clause, textOverride, options) {
       });
     }
   }
-  if ((_D = clause.prn) == null ? void 0 : _D.enabled) {
+  if ((_E = clause.prn) == null ? void 0 : _E.enabled) {
     dosage.asNeededBoolean = true;
-    const reasons = ((_E = clause.prn.reasons) == null ? void 0 : _E.length) ? clause.prn.reasons : clause.prn.reason ? [clause.prn.reason] : [];
+    const reasons = ((_F = clause.prn.reasons) == null ? void 0 : _F.length) ? clause.prn.reasons : clause.prn.reason ? [clause.prn.reason] : [];
     if (reasons.length) {
       dosage.asNeededFor = [];
       for (const reason of reasons) {
@@ -10698,14 +10781,23 @@ function canonicalToFhir(clause, textOverride, options) {
         if (reason.text) {
           concept.text = reason.text;
         }
-        if ((_F = reason.coding) == null ? void 0 : _F.code) {
+        const reasonTextElement = (options == null ? void 0 : options.includeTranslationExtensions) ? buildTranslationPrimitiveElement((_H = reason.i18n) != null ? _H : (_G = reason.coding) == null ? void 0 : _G.i18n) : void 0;
+        if (reasonTextElement) {
+          concept._text = reasonTextElement;
+        }
+        if ((_I = reason.coding) == null ? void 0 : _I.code) {
+          const displayElement = (options == null ? void 0 : options.includeTranslationExtensions) ? mergeTranslationPrimitiveElement(
+            reason.coding._display,
+            reason.coding.i18n
+          ) : clonePrimitiveElement(reason.coding._display);
           concept.coding = [
-            {
-              system: (_G = reason.coding.system) != null ? _G : SNOMED_SYSTEM5,
+            __spreadProps(__spreadValues({
+              system: (_J = reason.coding.system) != null ? _J : SNOMED_SYSTEM5,
               code: reason.coding.code,
-              display: reason.coding.display,
+              display: reason.coding.display
+            }, displayElement ? { _display: displayElement } : {}), {
               extension: cloneExtensions(reason.coding.extension)
-            }
+            })
           ];
         }
         concept.extension = buildBodySiteSpatialRelationExtensions(reason.spatialRelation);
@@ -10740,14 +10832,17 @@ function canonicalFromFhir(dosage) {
   const siteCoding = selectPreferredSiteCoding(dosage.site);
   const siteSpatialRelation = parseBodySiteSpatialRelationExtension(dosage.site);
   const siteText = getFallbackSiteText(dosage.site);
+  const siteI18n = codeableConceptTranslationI18n(dosage.site, siteCoding);
   if (siteText || (siteCoding == null ? void 0 : siteCoding.code) || siteSpatialRelation) {
     clause.site = {
       text: siteText,
+      i18n: siteI18n.text,
       spatialRelation: siteSpatialRelation,
       coding: (siteCoding == null ? void 0 : siteCoding.code) ? {
         code: siteCoding.code,
         display: siteCoding.display,
-        system: siteCoding.system
+        system: siteCoding.system,
+        i18n: siteI18n.display
       } : void 0,
       source: "text"
     };
@@ -10802,16 +10897,21 @@ function canonicalFromFhir(dosage) {
     };
   }
   const prnReasons = ((_y = dosage.asNeededFor) == null ? void 0 : _y.length) ? dosage.asNeededFor.map((concept) => {
-    var _a3;
+    var _a3, _b2;
     const coding = (_a3 = concept.coding) == null ? void 0 : _a3.find((code) => Boolean(code.code));
+    const defaultDef = (coding == null ? void 0 : coding.code) ? findPrnReasonDefinitionByCoding((_b2 = coding.system) != null ? _b2 : SNOMED_SYSTEM5, coding.code) : void 0;
+    const i18n = codeableConceptTranslationI18n(concept, coding, defaultDef == null ? void 0 : defaultDef.i18n);
     return {
       text: getFallbackPrnReasonText(concept),
+      i18n: i18n.text,
       spatialRelation: parseBodySiteSpatialRelationExtension(concept),
       coding: (coding == null ? void 0 : coding.code) ? {
         code: coding.code,
         display: coding.display,
         system: coding.system,
-        extension: cloneExtensions(coding.extension)
+        extension: cloneExtensions(coding.extension),
+        _display: clonePrimitiveElement(coding._display),
+        i18n: i18n.display
       } : void 0
     };
   }) : void 0;
@@ -16639,7 +16739,8 @@ function applyRouteSiteDefault(state) {
     state.siteCoding = {
       system: (_i = definition.coding.system) != null ? _i : "http://snomed.info/sct",
       code: definition.coding.code,
-      display: definition.coding.display
+      display: definition.coding.display,
+      i18n: mergeI18nRecords(definition.i18n, definition.coding.i18n)
     };
   }
 }
@@ -17951,7 +18052,8 @@ function applySiteDefinition(internal, definition) {
   internal.siteCoding = (coding == null ? void 0 : coding.code) ? {
     code: coding.code,
     display: coding.display,
-    system: (_a2 = coding.system) != null ? _a2 : SNOMED_SYSTEM9
+    system: (_a2 = coding.system) != null ? _a2 : SNOMED_SYSTEM9,
+    i18n: mergeI18nRecords(definition.i18n, coding.i18n)
   } : void 0;
   if (definition.text) {
     internal.siteText = definition.text;
@@ -18307,7 +18409,8 @@ function seedKnownSiteCoding(state) {
   state.siteCoding = {
     system: (_b = definition.coding.system) != null ? _b : SNOMED_SYSTEM10,
     code: definition.coding.code,
-    display: definition.coding.display
+    display: definition.coding.display,
+    i18n: mergeI18nRecords(definition.i18n, definition.coding.i18n)
   };
 }
 function parseClauseState(input, options) {
@@ -21609,7 +21712,8 @@ function cloneBodySiteCoding2(coding) {
   return {
     code: coding.code,
     display: coding.display,
-    system: coding.system
+    system: coding.system,
+    i18n: cloneI18nRecord(coding.i18n)
   };
 }
 function buildNormalizedMetaFromClause(clause, fhir, options) {
@@ -21656,7 +21760,8 @@ function buildParseResult(state, options) {
   const shortText = formatCanonicalClause(clause, "short", localization, options);
   const longText = formatCanonicalClause(clause, "long", localization, options);
   const fhir = canonicalToFhir(clause, longText, {
-    bodySitePostcoordination: options == null ? void 0 : options.bodySitePostcoordination
+    bodySitePostcoordination: options == null ? void 0 : options.bodySitePostcoordination,
+    includeTranslationExtensions: Boolean((options == null ? void 0 : options.locale) || (options == null ? void 0 : options.i18n))
   });
   const consumedTokens = [];
   const leftoverParts = [];

package/dist/index.js

@@ -385,6 +385,24 @@ function normalizeLocaleKey(locale) {
 function cloneI18nRecord(i18n) {
   return i18n ? __spreadValues({}, i18n) : void 0;
 }
+function mergeI18nRecords(...records) {
+  var _a2;
+  const merged = {};
+  for (const record of records) {
+    if (!record) {
+      continue;
+    }
+    for (const locale in record) {
+      const normalizedLocale = normalizeLocaleKey(locale);
+      const content = (_a2 = record[locale]) == null ? void 0 : _a2.trim();
+      if (!normalizedLocale || !content) {
+        continue;
+      }
+      merged[normalizedLocale] = content;
+    }
+  }
+  return Object.keys(merged).length ? merged : void 0;
+}
 function cloneExtension(extension) {
   var _a2, _b, _c, _d;
   return {
@@ -471,6 +489,32 @@ function buildTranslationPrimitiveElement(translations, base) {
     extension: nextExtensions
   };
 }
+function mergeTranslationPrimitiveElement(base, translations) {
+  var _a2, _b, _c, _d;
+  const nextExtensions = (_b = (_a2 = base == null ? void 0 : base.extension) == null ? void 0 : _a2.map(cloneExtension)) != null ? _b : [];
+  const existingTranslationLocales = /* @__PURE__ */ new Set();
+  for (const extension of nextExtensions) {
+    if (extension.url !== FHIR_TRANSLATION_EXTENSION_URL) {
+      continue;
+    }
+    const { locale } = getTranslationParts(extension);
+    if (locale) {
+      existingTranslationLocales.add(locale);
+    }
+  }
+  const additions = (_d = (_c = buildTranslationPrimitiveElement(translations)) == null ? void 0 : _c.extension) != null ? _d : [];
+  for (const extension of additions) {
+    const { locale } = getTranslationParts(extension);
+    if (locale && existingTranslationLocales.has(locale)) {
+      continue;
+    }
+    if (locale) {
+      existingTranslationLocales.add(locale);
+    }
+    nextExtensions.push(extension);
+  }
+  return nextExtensions.length ? { extension: nextExtensions } : void 0;
+}
 function getTranslationParts(extension) {
   var _a2, _b;
   const parts = (_a2 = extension.extension) != null ? _a2 : [];
@@ -514,6 +558,24 @@ function getPrimitiveTranslation(element, locale) {
   }
   return languagePrefixMatch;
 }
+function getPrimitiveTranslations(element) {
+  var _a2;
+  if (!((_a2 = element == null ? void 0 : element.extension) == null ? void 0 : _a2.length)) {
+    return void 0;
+  }
+  const translations = {};
+  for (const extension of element.extension) {
+    if (extension.url !== FHIR_TRANSLATION_EXTENSION_URL) {
+      continue;
+    }
+    const { locale, content } = getTranslationParts(extension);
+    if (!locale || !content) {
+      continue;
+    }
+    translations[locale] = content;
+  }
+  return Object.keys(translations).length ? translations : void 0;
+}
 
 // src/body-site-spatial.ts
 var SNOMED_SYSTEM2 = "http://snomed.info/sct";
@@ -1082,6 +1144,7 @@ var DEFAULT_BODY_SITE_SNOMED_SOURCE = [
     definition: {
       coding: { code: "81745001", display: "Eye" },
       text: "eye",
+      i18n: { th: "\u0E15\u0E32" },
       routeHint: RouteCode["Ophthalmic route"]
     }
   },
@@ -1090,6 +1153,7 @@ var DEFAULT_BODY_SITE_SNOMED_SOURCE = [
     definition: {
       coding: { code: "1290031003", display: "Structure of left eye proper" },
       text: "left eye",
+      i18n: { th: "\u0E15\u0E32\u0E0B\u0E49\u0E32\u0E22" },
       routeHint: RouteCode["Ophthalmic route"]
     }
   },
@@ -1098,6 +1162,7 @@ var DEFAULT_BODY_SITE_SNOMED_SOURCE = [
     definition: {
       coding: { code: "1290032005", display: "Structure of right eye proper" },
       text: "right eye",
+      i18n: { th: "\u0E15\u0E32\u0E02\u0E27\u0E32" },
       routeHint: RouteCode["Ophthalmic route"]
     }
   },
@@ -1106,6 +1171,7 @@ var DEFAULT_BODY_SITE_SNOMED_SOURCE = [
     definition: {
       coding: { code: "40638003", display: "Structure of both eyes" },
       text: "both eyes",
+      i18n: { th: "\u0E15\u0E32\u0E17\u0E31\u0E49\u0E07\u0E2A\u0E2D\u0E07\u0E02\u0E49\u0E32\u0E07" },
       routeHint: RouteCode["Ophthalmic route"]
     }
   },
@@ -4495,7 +4561,8 @@ function buildBodySiteCoding(definition) {
   return {
     code: coding.code,
     display: coding.display,
-    system: (_a2 = coding.system) != null ? _a2 : SNOMED_SYSTEM3
+    system: (_a2 = coding.system) != null ? _a2 : SNOMED_SYSTEM3,
+    i18n: mergeI18nRecords(definition == null ? void 0 : definition.i18n, coding.i18n)
   };
 }
 function cloneBodySiteCode(coding) {
@@ -4507,7 +4574,7 @@ function cloneBodySiteCode(coding) {
     code: coding.code,
     display: coding.display,
     system: (_a2 = coding.system) != null ? _a2 : SNOMED_SYSTEM3,
-    i18n: coding.i18n
+    i18n: mergeI18nRecords(coding.i18n)
   };
 }
 function lookupDefinitionForCanonical(canonical, customSiteMap) {
@@ -9930,6 +9997,7 @@ var ParserState = class {
     for (const reason of value) {
       reasons.push({
         text: reason.text,
+        i18n: cloneI18nRecord(reason.i18n),
         spatialRelation: cloneBodySiteSpatialRelation(reason.spatialRelation),
         coding: reason.coding ? {
           code: reason.coding.code,
@@ -9937,7 +10005,7 @@ var ParserState = class {
           system: reason.coding.system,
           extension: cloneExtensions(reason.coding.extension),
           _display: clonePrimitiveElement(reason.coding._display),
-          i18n: reason.coding.i18n
+          i18n: cloneI18nRecord(reason.coding.i18n)
         } : void 0
       });
     }
@@ -9969,7 +10037,7 @@ var ParserState = class {
       system: value.system,
       extension: cloneExtensions(value.extension),
       _display: clonePrimitiveElement(value._display),
-      i18n: value.i18n
+      i18n: cloneI18nRecord(value.i18n)
     } : void 0;
   }
   get siteText() {
@@ -10002,7 +10070,7 @@ var ParserState = class {
       code: value.code,
       display: value.display,
       system: value.system,
-      i18n: value.i18n
+      i18n: cloneI18nRecord(value.i18n)
     } : void 0;
   }
   get siteSpatialRelation() {
@@ -10187,17 +10255,18 @@ function selectCanonicalSiteCoding(site, options) {
   );
   return (options == null ? void 0 : options.bodySitePostcoordination) === true ? postcoordinated != null ? postcoordinated : site == null ? void 0 : site.coding : (_a2 = site == null ? void 0 : site.coding) != null ? _a2 : postcoordinated;
 }
-function buildSiteCodingArray(siteCoding) {
+function buildSiteCodingArray(siteCoding, options) {
   var _a2;
   if (!(siteCoding == null ? void 0 : siteCoding.code)) {
     return void 0;
   }
+  const displayElement = (options == null ? void 0 : options.includeTranslationExtensions) ? buildTranslationPrimitiveElement(siteCoding.i18n) : void 0;
   return [
-    {
+    __spreadValues({
       system: (_a2 = siteCoding.system) != null ? _a2 : SNOMED_SYSTEM5,
       code: siteCoding.code,
       display: siteCoding.display
-    }
+    }, displayElement ? { _display: displayElement } : {})
   ];
 }
 function getFallbackSiteText(site) {
@@ -10211,6 +10280,18 @@ function getFallbackSiteText(site) {
     display: siteCoding.display
   }) : void 0;
 }
+function codeableConceptTranslationI18n(concept, coding, fallback) {
+  return {
+    text: mergeI18nRecords(
+      fallback,
+      getPrimitiveTranslations(concept == null ? void 0 : concept._text)
+    ),
+    display: mergeI18nRecords(
+      coding == null ? void 0 : coding.i18n,
+      getPrimitiveTranslations(coding == null ? void 0 : coding._display)
+    )
+  };
+}
 function lowerFirst(value) {
   const trimmed = value == null ? void 0 : value.trim();
   return trimmed ? trimmed.charAt(0).toLowerCase() + trimmed.slice(1) : void 0;
@@ -10457,7 +10538,7 @@ function appendWarning(warnings, warning) {
   return warnings;
 }
 function canonicalToFhir(clause, textOverride, options) {
-  var _a2, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k, _l, _m, _n, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x, _y, _z, _A, _B, _C, _D, _E, _F, _G;
+  var _a2, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k, _l, _m, _n, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x, _y, _z, _A, _B, _C, _D, _E, _F, _G, _H, _I, _J;
   const dosage = {};
   const repeat = {};
   let hasRepeat = false;
@@ -10557,19 +10638,21 @@ function canonicalToFhir(clause, textOverride, options) {
   }
   if (((_l = clause.site) == null ? void 0 : _l.text) || ((_n = (_m = clause.site) == null ? void 0 : _m.coding) == null ? void 0 : _n.code) || ((_o = clause.site) == null ? void 0 : _o.spatialRelation)) {
     const siteCoding = selectCanonicalSiteCoding(clause.site, options);
-    dosage.site = {
-      text: (_p = clause.site) == null ? void 0 : _p.text,
-      coding: buildSiteCodingArray(siteCoding),
-      extension: buildBodySiteSpatialRelationExtensions((_q = clause.site) == null ? void 0 : _q.spatialRelation)
-    };
+    const siteTextElement = (options == null ? void 0 : options.includeTranslationExtensions) ? buildTranslationPrimitiveElement((_p = clause.site.i18n) != null ? _p : siteCoding == null ? void 0 : siteCoding.i18n) : void 0;
+    dosage.site = __spreadProps(__spreadValues({
+      text: (_q = clause.site) == null ? void 0 : _q.text
+    }, siteTextElement ? { _text: siteTextElement } : {}), {
+      coding: buildSiteCodingArray(siteCoding, options),
+      extension: buildBodySiteSpatialRelationExtensions((_r = clause.site) == null ? void 0 : _r.spatialRelation)
+    });
   }
-  if (((_r = clause.method) == null ? void 0 : _r.text) || ((_s = clause.method) == null ? void 0 : _s._text) || ((_u = (_t = clause.method) == null ? void 0 : _t.coding) == null ? void 0 : _u.code)) {
+  if (((_s = clause.method) == null ? void 0 : _s.text) || ((_t = clause.method) == null ? void 0 : _t._text) || ((_v = (_u = clause.method) == null ? void 0 : _u.coding) == null ? void 0 : _v.code)) {
     dosage.method = {
-      text: (_v = clause.method) == null ? void 0 : _v.text,
-      _text: clonePrimitiveElement((_w = clause.method) == null ? void 0 : _w._text),
-      coding: ((_y = (_x = clause.method) == null ? void 0 : _x.coding) == null ? void 0 : _y.code) ? [
+      text: (_w = clause.method) == null ? void 0 : _w.text,
+      _text: clonePrimitiveElement((_x = clause.method) == null ? void 0 : _x._text),
+      coding: ((_z = (_y = clause.method) == null ? void 0 : _y.coding) == null ? void 0 : _z.code) ? [
         {
-          system: (_z = clause.method.coding.system) != null ? _z : SNOMED_SYSTEM5,
+          system: (_A = clause.method.coding.system) != null ? _A : SNOMED_SYSTEM5,
           code: clause.method.coding.code,
           display: clause.method.coding.display,
           _display: clonePrimitiveElement(clause.method.coding._display)
@@ -10577,14 +10660,14 @@ function canonicalToFhir(clause, textOverride, options) {
       ] : void 0
     };
   }
-  if ((_A = clause.additionalInstructions) == null ? void 0 : _A.length) {
+  if ((_B = clause.additionalInstructions) == null ? void 0 : _B.length) {
     dosage.additionalInstruction = [];
     for (const instruction of clause.additionalInstructions) {
       dosage.additionalInstruction.push({
         text: instruction.text,
-        coding: ((_B = instruction.coding) == null ? void 0 : _B.code) ? [
+        coding: ((_C = instruction.coding) == null ? void 0 : _C.code) ? [
           {
-            system: (_C = instruction.coding.system) != null ? _C : SNOMED_SYSTEM5,
+            system: (_D = instruction.coding.system) != null ? _D : SNOMED_SYSTEM5,
             code: instruction.coding.code,
             display: instruction.coding.display
           }
@@ -10592,9 +10675,9 @@ function canonicalToFhir(clause, textOverride, options) {
       });
     }
   }
-  if ((_D = clause.prn) == null ? void 0 : _D.enabled) {
+  if ((_E = clause.prn) == null ? void 0 : _E.enabled) {
     dosage.asNeededBoolean = true;
-    const reasons = ((_E = clause.prn.reasons) == null ? void 0 : _E.length) ? clause.prn.reasons : clause.prn.reason ? [clause.prn.reason] : [];
+    const reasons = ((_F = clause.prn.reasons) == null ? void 0 : _F.length) ? clause.prn.reasons : clause.prn.reason ? [clause.prn.reason] : [];
     if (reasons.length) {
       dosage.asNeededFor = [];
       for (const reason of reasons) {
@@ -10602,14 +10685,23 @@ function canonicalToFhir(clause, textOverride, options) {
         if (reason.text) {
           concept.text = reason.text;
         }
-        if ((_F = reason.coding) == null ? void 0 : _F.code) {
+        const reasonTextElement = (options == null ? void 0 : options.includeTranslationExtensions) ? buildTranslationPrimitiveElement((_H = reason.i18n) != null ? _H : (_G = reason.coding) == null ? void 0 : _G.i18n) : void 0;
+        if (reasonTextElement) {
+          concept._text = reasonTextElement;
+        }
+        if ((_I = reason.coding) == null ? void 0 : _I.code) {
+          const displayElement = (options == null ? void 0 : options.includeTranslationExtensions) ? mergeTranslationPrimitiveElement(
+            reason.coding._display,
+            reason.coding.i18n
+          ) : clonePrimitiveElement(reason.coding._display);
           concept.coding = [
-            {
-              system: (_G = reason.coding.system) != null ? _G : SNOMED_SYSTEM5,
+            __spreadProps(__spreadValues({
+              system: (_J = reason.coding.system) != null ? _J : SNOMED_SYSTEM5,
               code: reason.coding.code,
-              display: reason.coding.display,
+              display: reason.coding.display
+            }, displayElement ? { _display: displayElement } : {}), {
               extension: cloneExtensions(reason.coding.extension)
-            }
+            })
           ];
         }
         concept.extension = buildBodySiteSpatialRelationExtensions(reason.spatialRelation);
@@ -10644,14 +10736,17 @@ function canonicalFromFhir(dosage) {
   const siteCoding = selectPreferredSiteCoding(dosage.site);
   const siteSpatialRelation = parseBodySiteSpatialRelationExtension(dosage.site);
   const siteText = getFallbackSiteText(dosage.site);
+  const siteI18n = codeableConceptTranslationI18n(dosage.site, siteCoding);
   if (siteText || (siteCoding == null ? void 0 : siteCoding.code) || siteSpatialRelation) {
     clause.site = {
       text: siteText,
+      i18n: siteI18n.text,
       spatialRelation: siteSpatialRelation,
       coding: (siteCoding == null ? void 0 : siteCoding.code) ? {
         code: siteCoding.code,
         display: siteCoding.display,
-        system: siteCoding.system
+        system: siteCoding.system,
+        i18n: siteI18n.display
       } : void 0,
       source: "text"
     };
@@ -10706,16 +10801,21 @@ function canonicalFromFhir(dosage) {
     };
   }
   const prnReasons = ((_y = dosage.asNeededFor) == null ? void 0 : _y.length) ? dosage.asNeededFor.map((concept) => {
-    var _a3;
+    var _a3, _b2;
     const coding = (_a3 = concept.coding) == null ? void 0 : _a3.find((code) => Boolean(code.code));
+    const defaultDef = (coding == null ? void 0 : coding.code) ? findPrnReasonDefinitionByCoding((_b2 = coding.system) != null ? _b2 : SNOMED_SYSTEM5, coding.code) : void 0;
+    const i18n = codeableConceptTranslationI18n(concept, coding, defaultDef == null ? void 0 : defaultDef.i18n);
     return {
       text: getFallbackPrnReasonText(concept),
+      i18n: i18n.text,
       spatialRelation: parseBodySiteSpatialRelationExtension(concept),
       coding: (coding == null ? void 0 : coding.code) ? {
         code: coding.code,
         display: coding.display,
         system: coding.system,
-        extension: cloneExtensions(coding.extension)
+        extension: cloneExtensions(coding.extension),
+        _display: clonePrimitiveElement(coding._display),
+        i18n: i18n.display
       } : void 0
     };
   }) : void 0;
@@ -16543,7 +16643,8 @@ function applyRouteSiteDefault(state) {
     state.siteCoding = {
       system: (_i = definition.coding.system) != null ? _i : "http://snomed.info/sct",
       code: definition.coding.code,
-      display: definition.coding.display
+      display: definition.coding.display,
+      i18n: mergeI18nRecords(definition.i18n, definition.coding.i18n)
     };
   }
 }
@@ -17855,7 +17956,8 @@ function applySiteDefinition(internal, definition) {
   internal.siteCoding = (coding == null ? void 0 : coding.code) ? {
     code: coding.code,
     display: coding.display,
-    system: (_a2 = coding.system) != null ? _a2 : SNOMED_SYSTEM9
+    system: (_a2 = coding.system) != null ? _a2 : SNOMED_SYSTEM9,
+    i18n: mergeI18nRecords(definition.i18n, coding.i18n)
   } : void 0;
   if (definition.text) {
     internal.siteText = definition.text;
@@ -18211,7 +18313,8 @@ function seedKnownSiteCoding(state) {
   state.siteCoding = {
     system: (_b = definition.coding.system) != null ? _b : SNOMED_SYSTEM10,
     code: definition.coding.code,
-    display: definition.coding.display
+    display: definition.coding.display,
+    i18n: mergeI18nRecords(definition.i18n, definition.coding.i18n)
   };
 }
 function parseClauseState(input, options) {
@@ -21513,7 +21616,8 @@ function cloneBodySiteCoding2(coding) {
   return {
     code: coding.code,
     display: coding.display,
-    system: coding.system
+    system: coding.system,
+    i18n: cloneI18nRecord(coding.i18n)
   };
 }
 function buildNormalizedMetaFromClause(clause, fhir, options) {
@@ -21560,7 +21664,8 @@ function buildParseResult(state, options) {
   const shortText = formatCanonicalClause(clause, "short", localization, options);
   const longText = formatCanonicalClause(clause, "long", localization, options);
   const fhir = canonicalToFhir(clause, longText, {
-    bodySitePostcoordination: options == null ? void 0 : options.bodySitePostcoordination
+    bodySitePostcoordination: options == null ? void 0 : options.bodySitePostcoordination,
+    includeTranslationExtensions: Boolean((options == null ? void 0 : options.locale) || (options == null ? void 0 : options.i18n))
   });
   const consumedTokens = [];
   const leftoverParts = [];

package/dist/types.d.ts

@@ -416,6 +416,8 @@ export interface BodySiteDefinition {
     text?: string;
     spatialRelation?: BodySiteSpatialRelation;
     routeHint?: RouteCode;
+    /** Optional translations for different locales (e.g., { "th": "ตา" }) */
+    i18n?: Record<string, string>;
     /**
      * Optional phrases that should resolve to the same coding as this entry.
      * Aliases are normalized with the same logic as map keys so callers can
@@ -756,6 +758,7 @@ export interface CanonicalRouteExpr {
 }
 export interface CanonicalSiteExpr {
     text?: string;
+    i18n?: Record<string, string>;
     coding?: BodySiteCode;
     spatialRelation?: BodySiteSpatialRelation;
     source?: "abbreviation" | "text" | "selection" | "resolver";
@@ -786,6 +789,7 @@ export interface CanonicalScheduleExpr {
 }
 export interface CanonicalPrnReasonExpr {
     text?: string;
+    i18n?: Record<string, string>;
     coding?: FhirCoding;
     spatialRelation?: BodySiteSpatialRelation;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ezmedicationinput",
-  "version": "0.1.48",
+  "version": "0.1.50",
   "description": "Parse concise medication sigs into FHIR R5 Dosage JSON",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -14,6 +14,11 @@
       "default": "./dist/index.js"
     }
   },
+  "scripts": {
+    "test:dist": "npm run build && vitest run test-dist",
+    "build": "tsup && tsc -p tsconfig.types.json",
+    "test": "vitest run --dir test"
+  },
   "files": [
     "dist"
   ],
@@ -34,10 +39,5 @@
     "tsup": "^8.5.1",
     "typescript": "^5.4.0",
     "vitest": "^1.5.0"
-  },
-  "scripts": {
-    "test:dist": "npm run build && vitest run test-dist",
-    "build": "tsup && tsc -p tsconfig.types.json",
-    "test": "vitest run --dir test"
   }
-}
+}