ezmedicationinput 0.1.8 → 0.1.11

package/README.md

@@ -14,6 +14,7 @@
 - Applies medication context to infer default units when they are omitted.
 - Surfaces warnings when discouraged tokens (`QD`, `QOD`, `BLD`) are used and optionally rejects them.
 - Generates upcoming administration timestamps from FHIR dosage data via `nextDueDoses` using configurable clinic clocks.
+- Auto-codes common body-site phrases (e.g. "left arm", "right eye") with SNOMED CT anatomy concepts and supports interactive lookup flows for ambiguous sites.
 
 ## Installation
 
@@ -110,6 +111,105 @@ When `when` is populated, `timeOfDay` is intentionally omitted to stay within HL
 
 Routes always include SNOMED CT codings. Every code from the SNOMED Route of Administration value set is represented so you can confidently pass parsed results into downstream FHIR services that expect coded routes.
 
+### SNOMED body-site coding & interactive probes
+
+Spelled-out application sites are automatically coded when the phrase is known to the bundled SNOMED CT anatomy dictionary. The normalized site text is also surfaced in `Dosage.site.text` and in the `ParseResult.meta.normalized.site` object.
+
+```ts
+import { parseSig } from "ezmedicationinput";
+
+const result = parseSig("apply cream to left arm twice daily");
+
+result.fhir.site?.coding?.[0];
+// → { system: "http://snomed.info/sct", code: "368208006", display: "Left upper arm structure" }
+```
+
+When the parser encounters an unfamiliar site, it leaves the text untouched and records nothing in `meta.siteLookups`. Wrapping the phrase in braces (e.g. `apply to {mole on scalp}`) preserves the same parsing behavior but flags the entry as a **probe** so `meta.siteLookups` always contains the request. This allows UIs to display lookup widgets even before a matching code exists. Braces are optional when the site is already recognized—they simply make the clinician's intent explicit.
+
+You can extend or replace the built-in codings via `ParseOptions`:
+
+```ts
+import { parseSigAsync } from "ezmedicationinput";
+
+const result = await parseSigAsync("apply to {left temple} nightly", {
+  siteCodeMap: {
+    "left temple": {
+      coding: {
+        system: "http://example.org/custom",
+        code: "LTEMP",
+        display: "Left temple"
+      }
+    }
+  },
+  siteCodeResolvers: async (request) => {
+    if (request.canonical === "mole on scalp") {
+      return {
+        coding: { system: "http://snomed.info/sct", code: "39937001", display: "Scalp structure" },
+        text: request.text
+      };
+    }
+    return undefined;
+  },
+  siteCodeSuggestionResolvers: async (request) => {
+    if (request.isProbe) {
+      return [
+        {
+          coding: { system: "http://snomed.info/sct", code: "39937001", display: "Scalp structure" },
+          text: "Scalp"
+        },
+        {
+          coding: { system: "http://snomed.info/sct", code: "280447003", display: "Temple region of head" },
+          text: "Temple"
+        }
+      ];
+    }
+    return undefined;
+  }
+});
+
+result.meta.siteLookups;
+// → [{ request: { text: "left temple", isProbe: true, ... }, suggestions: [...] }]
+```
+
+- `siteCodeMap` lets you supply deterministic overrides for normalized site phrases.
+- `siteCodeResolvers` (sync or async) can call external services to resolve sites on demand.
+- `siteCodeSuggestionResolvers` return candidate codes; their results populate `meta.siteLookups[0].suggestions`.
+- Each resolver receives the full `SiteCodeLookupRequest`, including the original input, the cleaned site text, and a `{ start, end }` range you can use to highlight the substring in UI workflows.
+- `parseSigAsync` behaves like `parseSig` but awaits asynchronous resolvers and suggestion providers.
+
+#### Site resolver signatures
+
+```ts
+export interface SiteCodeLookupRequest {
+  originalText: string; // Sanitized phrase before brace/whitespace cleanup
+  text: string;         // Brace-free, whitespace-collapsed site text
+  normalized: string;   // Lower-case variant of `text`
+  canonical: string;    // Normalized key for dictionary lookups
+  isProbe: boolean;     // True when the sig used `{placeholder}` syntax
+  inputText: string;    // Full sig string the parser received
+  sourceText?: string;  // Substring extracted from `inputText`
+  range?: { start: number; end: number }; // Character range of `sourceText`
+}
+
+export type SiteCodeResolver = (
+  request: SiteCodeLookupRequest
+) => SiteCodeResolution | null | undefined | Promise<SiteCodeResolution | null | undefined>;
+
+export type SiteCodeSuggestionResolver = (
+  request: SiteCodeLookupRequest
+) =>
+  | SiteCodeSuggestionsResult
+  | SiteCodeSuggestion[]
+  | SiteCodeSuggestion
+  | null
+  | undefined
+  | Promise<SiteCodeSuggestionsResult | SiteCodeSuggestion[] | SiteCodeSuggestion | null | undefined>;
+```
+
+`SiteCodeResolution`, `SiteCodeSuggestion`, and `SiteCodeSuggestionsResult` mirror the values shown in the example above. Resolvers can use `request.range` (start inclusive, end exclusive) together with `request.sourceText` to paint highlights or replace the detected phrase in client applications.
+
+Consumers that only need synchronous resolution can continue calling `parseSig`. If any synchronous resolver accidentally returns a Promise, an error is thrown with guidance to switch to `parseSigAsync`.
+
 You can specify the number of times (total count) the medication is supposed to be used by ending with `for {number} times`, `x {number} doses`, or simply `x {number}`
 
 ### Advanced parsing options

package/dist/fhir.js

@@ -9,7 +9,7 @@ const object_1 = require("./utils/object");
 const array_1 = require("./utils/array");
 const SNOMED_SYSTEM = "http://snomed.info/sct";
 function toFhir(internal) {
-    var _a, _b;
+    var _a, _b, _c, _d, _e;
     const dosage = {};
     const repeat = {};
     let hasRepeat = false;
@@ -100,8 +100,20 @@ function toFhir(internal) {
             dosage.route = { text };
         }
     }
-    if (internal.siteText) {
-        dosage.site = { text: internal.siteText };
+    if (internal.siteText || ((_c = internal.siteCoding) === null || _c === void 0 ? void 0 : _c.code)) {
+        const coding = ((_d = internal.siteCoding) === null || _d === void 0 ? void 0 : _d.code)
+            ? [
+                {
+                    system: (_e = internal.siteCoding.system) !== null && _e !== void 0 ? _e : SNOMED_SYSTEM,
+                    code: internal.siteCoding.code,
+                    display: internal.siteCoding.display
+                }
+            ]
+            : undefined;
+        dosage.site = {
+            text: internal.siteText,
+            coding
+        };
     }
     if (internal.asNeeded) {
         dosage.asNeededBoolean = true;
@@ -116,7 +128,7 @@ function toFhir(internal) {
     return dosage;
 }
 function internalFromFhir(dosage) {
-    var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x, _y, _z, _0, _1, _2, _3, _4, _5;
+    var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x, _y, _z, _0, _1, _2, _3, _4, _5, _6, _7;
     const internal = {
         input: (_a = dosage.text) !== null && _a !== void 0 ? _a : "",
         tokens: [],
@@ -139,7 +151,8 @@ function internalFromFhir(dosage) {
         siteText: (_y = dosage.site) === null || _y === void 0 ? void 0 : _y.text,
         asNeeded: dosage.asNeededBoolean,
         asNeededReason: (_0 = (_z = dosage.asNeededFor) === null || _z === void 0 ? void 0 : _z[0]) === null || _0 === void 0 ? void 0 : _0.text,
-        siteTokenIndices: new Set()
+        siteTokenIndices: new Set(),
+        siteLookups: []
     };
     const routeCoding = (_2 = (_1 = dosage.route) === null || _1 === void 0 ? void 0 : _1.coding) === null || _2 === void 0 ? void 0 : _2.find((code) => code.system === SNOMED_SYSTEM);
     if (routeCoding === null || routeCoding === void 0 ? void 0 : routeCoding.code) {
@@ -150,13 +163,21 @@ function internalFromFhir(dosage) {
             internal.routeText = maps_1.ROUTE_TEXT[mapped];
         }
     }
-    const doseAndRate = (_3 = dosage.doseAndRate) === null || _3 === void 0 ? void 0 : _3[0];
+    const siteCoding = (_4 = (_3 = dosage.site) === null || _3 === void 0 ? void 0 : _3.coding) === null || _4 === void 0 ? void 0 : _4.find((code) => code.system === SNOMED_SYSTEM);
+    if (siteCoding === null || siteCoding === void 0 ? void 0 : siteCoding.code) {
+        internal.siteCoding = {
+            code: siteCoding.code,
+            display: siteCoding.display,
+            system: siteCoding.system
+        };
+    }
+    const doseAndRate = (_5 = dosage.doseAndRate) === null || _5 === void 0 ? void 0 : _5[0];
     if (doseAndRate === null || doseAndRate === void 0 ? void 0 : doseAndRate.doseRange) {
         const { low, high } = doseAndRate.doseRange;
         if ((low === null || low === void 0 ? void 0 : low.value) !== undefined && (high === null || high === void 0 ? void 0 : high.value) !== undefined) {
             internal.doseRange = { low: low.value, high: high.value };
         }
-        internal.unit = (_5 = (_4 = low === null || low === void 0 ? void 0 : low.unit) !== null && _4 !== void 0 ? _4 : high === null || high === void 0 ? void 0 : high.unit) !== null && _5 !== void 0 ? _5 : internal.unit;
+        internal.unit = (_7 = (_6 = low === null || low === void 0 ? void 0 : low.unit) !== null && _6 !== void 0 ? _6 : high === null || high === void 0 ? void 0 : high.unit) !== null && _7 !== void 0 ? _7 : internal.unit;
     }
     else if (doseAndRate === null || doseAndRate === void 0 ? void 0 : doseAndRate.doseQuantity) {
         const dose = doseAndRate.doseQuantity;

package/dist/i18n.js

@@ -126,39 +126,103 @@ const DAY_NAMES_THAI = {
     sun: "วันอาทิตย์"
 };
 exports.THAI_SITE_TRANSLATIONS = {
+    eye: "ตา",
+    eyes: "ตา",
     "right eye": "ตาขวา",
     "left eye": "ตาซ้าย",
     "both eyes": "ตาทั้งสองข้าง",
+    "bilateral eyes": "ตาทั้งสองข้าง",
     "right ear": "หูขวา",
     "left ear": "หูซ้าย",
     "both ears": "หูทั้งสองข้าง",
+    "bilateral ears": "หูทั้งสองข้าง",
     ear: "หู",
     ears: "หูทั้งสองข้าง",
+    nostril: "รูจมูก",
+    nostrils: "รูจมูกทั้งสองข้าง",
     "right nostril": "รูจมูกขวา",
     "left nostril": "รูจมูกซ้าย",
     "both nostrils": "รูจมูกทั้งสองข้าง",
+    "left naris": "รูจมูกซ้าย",
+    "right naris": "รูจมูกขวา",
+    nares: "รูจมูกทั้งสองข้าง",
+    "anterior nares": "รูจมูกด้านหน้า",
+    nose: "จมูก",
+    mouth: "ปาก",
+    tongue: "ลิ้น",
+    tongues: "ลิ้น",
     "right arm": "แขนขวา",
     "left arm": "แขนซ้าย",
     "both arms": "แขนทั้งสองข้าง",
+    arm: "แขน",
+    "upper arm": "ต้นแขน",
+    "left upper arm": "ต้นแขนซ้าย",
+    "right upper arm": "ต้นแขนขวา",
+    "bilateral arms": "แขนทั้งสองข้าง",
     "right leg": "ขาขวา",
     "left leg": "ขาซ้าย",
     "both legs": "ขาทั้งสองข้าง",
+    leg: "ขา",
+    "lower leg": "ขาส่วนล่าง",
+    "left lower leg": "ขาส่วนล่างซ้าย",
+    "right lower leg": "ขาส่วนล่างขวา",
+    "bilateral legs": "ขาทั้งสองข้าง",
     "right hand": "มือขวา",
     "left hand": "มือซ้าย",
     "both hands": "มือทั้งสองข้าง",
+    hand: "มือ",
+    hands: "มือทั้งสองข้าง",
     "right foot": "เท้าขวา",
     "left foot": "เท้าซ้าย",
     "both feet": "เท้าทั้งสองข้าง",
+    foot: "เท้า",
+    feet: "เท้า",
     abdomen: "ช่องท้อง",
+    abdominal: "ช่องท้อง",
     belly: "ท้อง",
     back: "แผ่นหลัง",
+    scalp: "หนังศีรษะ",
+    face: "ใบหน้า",
     cheek: "แก้ม",
     cheeks: "แก้มทั้งสองข้าง",
+    forehead: "หน้าผาก",
+    chin: "คาง",
+    neck: "คอ",
     forearm: "ปลายแขน",
+    "left forearm": "ปลายแขนซ้าย",
+    "right forearm": "ปลายแขนขวา",
     shoulder: "ไหล่",
     shoulders: "ไหล่ทั้งสองข้าง",
     thigh: "ต้นขา",
-    thighs: "ต้นขาทั้งสองข้าง"
+    thighs: "ต้นขาทั้งสองข้าง",
+    "left thigh": "ต้นขาซ้าย",
+    "right thigh": "ต้นขาขวา",
+    gum: "เหงือก",
+    gums: "เหงือก",
+    tooth: "ฟัน",
+    teeth: "ฟัน",
+    buttock: "สะโพก",
+    buttocks: "สะโพกทั้งสองข้าง",
+    gluteal: "สะโพก",
+    glute: "สะโพก",
+    "left buttock": "สะโพกซ้าย",
+    "left gluteal": "สะโพกซ้าย",
+    "right buttock": "สะโพกขวา",
+    "right gluteal": "สะโพกขวา",
+    muscle: "กล้ามเนื้อ",
+    muscles: "กล้ามเนื้อทั้งหมด",
+    vein: "หลอดเลือดดำ",
+    veins: "หลอดเลือดดำทั้งหมด",
+    vagina: "ช่องคลอด",
+    vaginal: "บริเวณช่องคลอด",
+    penis: "อวัยวะเพศชาย",
+    penile: "บริเวณอวัยวะเพศชาย",
+    rectum: "ไส้ตรง",
+    rectal: "บริเวณทวารหนัก",
+    anus: "ทวารหนัก",
+    perineum: "ฝีเย็บ",
+    skin: "ผิวหนัง",
+    hair: "เส้นผม"
 };
 const DEFAULT_THAI_ROUTE_GRAMMAR = { verb: "ใช้" };
 const THAI_ROUTE_GRAMMAR = {
@@ -613,6 +677,9 @@ function formatShortThai(internal) {
             .join(",");
         parts.push(days);
     }
+    if (internal.count !== undefined) {
+        parts.push(`x${stripTrailingZero(internal.count)}`);
+    }
     const asNeeded = formatAsNeededThai(internal);
     if (asNeeded) {
         parts.push(asNeeded);
@@ -629,6 +696,9 @@ function formatLongThai(internal) {
     const eventParts = collectWhenPhrasesThai(internal);
     const timing = combineFrequencyAndEventsThai(frequencyPart, eventParts);
     const dayPart = describeDayOfWeekThai(internal);
+    const countPart = internal.count !== undefined
+        ? `จำนวน ${stripTrailingZero(internal.count)} ครั้ง`
+        : undefined;
     const asNeeded = formatAsNeededThai(internal);
     const segments = [dosePart];
     if (routePart) {
@@ -643,6 +713,9 @@ function formatLongThai(internal) {
     if (dayPart) {
         segments.push(dayPart);
     }
+    if (countPart) {
+        segments.push(countPart);
+    }
     if (asNeeded) {
         segments.push(asNeeded);
     }

package/dist/index.d.ts

@@ -6,5 +6,6 @@ export { nextDueDoses } from "./schedule";
 export { getRegisteredSigLocalizations, registerSigLocalization, resolveSigLocalization, resolveSigTranslation } from "./i18n";
 export type { SigLocalization, SigLocalizationConfig, SigTranslation, SigTranslationConfig } from "./i18n";
 export declare function parseSig(input: string, options?: ParseOptions): ParseResult;
+export declare function parseSigAsync(input: string, options?: ParseOptions): Promise<ParseResult>;
 export declare function formatSig(dosage: FhirDosage, style?: "short" | "long", options?: FormatOptions): string;
 export declare function fromFhirDosage(dosage: FhirDosage, options?: FormatOptions): ParseResult;

package/dist/index.js

@@ -13,9 +13,19 @@ var __createBinding = (this && this.__createBinding) || (Object.create ? (functi
 var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.resolveSigTranslation = exports.resolveSigLocalization = exports.registerSigLocalization = exports.getRegisteredSigLocalizations = exports.nextDueDoses = exports.suggestSig = exports.parseInternal = void 0;
 exports.parseSig = parseSig;
+exports.parseSigAsync = parseSigAsync;
 exports.formatSig = formatSig;
 exports.fromFhirDosage = fromFhirDosage;
 const format_1 = require("./format");
@@ -36,6 +46,56 @@ Object.defineProperty(exports, "resolveSigLocalization", { enumerable: true, get
 Object.defineProperty(exports, "resolveSigTranslation", { enumerable: true, get: function () { return i18n_2.resolveSigTranslation; } });
 function parseSig(input, options) {
     const internal = (0, parser_1.parseInternal)(input, options);
+    (0, parser_1.applySiteCoding)(internal, options);
+    return buildParseResult(internal, options);
+}
+function parseSigAsync(input, options) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const internal = (0, parser_1.parseInternal)(input, options);
+        yield (0, parser_1.applySiteCodingAsync)(internal, options);
+        return buildParseResult(internal, options);
+    });
+}
+function formatSig(dosage, style = "short", options) {
+    const internal = (0, fhir_1.internalFromFhir)(dosage);
+    const localization = (0, i18n_1.resolveSigLocalization)(options === null || options === void 0 ? void 0 : options.locale, options === null || options === void 0 ? void 0 : options.i18n);
+    return (0, format_1.formatInternal)(internal, style, localization);
+}
+function fromFhirDosage(dosage, options) {
+    var _a, _b, _c;
+    const internal = (0, fhir_1.internalFromFhir)(dosage);
+    const localization = (0, i18n_1.resolveSigLocalization)(options === null || options === void 0 ? void 0 : options.locale, options === null || options === void 0 ? void 0 : options.i18n);
+    const shortText = (0, format_1.formatInternal)(internal, "short", localization);
+    const computedLong = (0, format_1.formatInternal)(internal, "long", localization);
+    const longText = localization ? computedLong : (_a = dosage.text) !== null && _a !== void 0 ? _a : computedLong;
+    return {
+        fhir: dosage,
+        shortText,
+        longText,
+        warnings: [],
+        meta: {
+            consumedTokens: [],
+            normalized: {
+                route: internal.routeCode,
+                unit: internal.unit,
+                site: internal.siteText || ((_b = internal.siteCoding) === null || _b === void 0 ? void 0 : _b.code)
+                    ? {
+                        text: internal.siteText,
+                        coding: ((_c = internal.siteCoding) === null || _c === void 0 ? void 0 : _c.code)
+                            ? {
+                                code: internal.siteCoding.code,
+                                display: internal.siteCoding.display,
+                                system: internal.siteCoding.system
+                            }
+                            : undefined
+                    }
+                    : undefined
+            }
+        }
+    };
+}
+function buildParseResult(internal, options) {
+    var _a;
     const localization = (0, i18n_1.resolveSigLocalization)(options === null || options === void 0 ? void 0 : options.locale, options === null || options === void 0 ? void 0 : options.i18n);
     const shortText = (0, format_1.formatInternal)(internal, "short", localization);
     const longText = (0, format_1.formatInternal)(internal, "long", localization);
@@ -47,6 +107,26 @@ function parseSig(input, options) {
         .filter((token) => internal.consumed.has(token.index))
         .map((token) => token.original);
     const leftoverTokens = internal.tokens.filter((token) => !internal.consumed.has(token.index));
+    const siteCoding = ((_a = internal.siteCoding) === null || _a === void 0 ? void 0 : _a.code)
+        ? {
+            code: internal.siteCoding.code,
+            display: internal.siteCoding.display,
+            system: internal.siteCoding.system
+        }
+        : undefined;
+    const siteLookups = internal.siteLookups.length
+        ? internal.siteLookups.map((entry) => ({
+            request: entry.request,
+            suggestions: entry.suggestions.map((suggestion) => ({
+                coding: {
+                    code: suggestion.coding.code,
+                    display: suggestion.coding.display,
+                    system: suggestion.coding.system
+                },
+                text: suggestion.text
+            }))
+        }))
+        : undefined;
     return {
         fhir,
         shortText,
@@ -59,34 +139,15 @@ function parseSig(input, options) {
                 : undefined,
             normalized: {
                 route: internal.routeCode,
-                unit: internal.unit
-            }
-        }
-    };
-}
-function formatSig(dosage, style = "short", options) {
-    const internal = (0, fhir_1.internalFromFhir)(dosage);
-    const localization = (0, i18n_1.resolveSigLocalization)(options === null || options === void 0 ? void 0 : options.locale, options === null || options === void 0 ? void 0 : options.i18n);
-    return (0, format_1.formatInternal)(internal, style, localization);
-}
-function fromFhirDosage(dosage, options) {
-    var _a;
-    const internal = (0, fhir_1.internalFromFhir)(dosage);
-    const localization = (0, i18n_1.resolveSigLocalization)(options === null || options === void 0 ? void 0 : options.locale, options === null || options === void 0 ? void 0 : options.i18n);
-    const shortText = (0, format_1.formatInternal)(internal, "short", localization);
-    const computedLong = (0, format_1.formatInternal)(internal, "long", localization);
-    const longText = localization ? computedLong : (_a = dosage.text) !== null && _a !== void 0 ? _a : computedLong;
-    return {
-        fhir: dosage,
-        shortText,
-        longText,
-        warnings: [],
-        meta: {
-            consumedTokens: [],
-            normalized: {
-                route: internal.routeCode,
-                unit: internal.unit
-            }
+                unit: internal.unit,
+                site: internal.siteText || siteCoding
+                    ? {
+                        text: internal.siteText,
+                        coding: siteCoding
+                    }
+                    : undefined
+            },
+            siteLookups
         }
     };
 }

package/dist/internal-types.d.ts

@@ -1,4 +1,8 @@
-import { EventTiming, FhirDayOfWeek, FhirPeriodUnit, RouteCode } from "./types";
+import { EventTiming, FhirCoding, FhirDayOfWeek, FhirPeriodUnit, RouteCode, SiteCodeLookupRequest, SiteCodeSuggestion } from "./types";
+export interface SiteLookupDetail {
+    request: SiteCodeLookupRequest;
+    suggestions: SiteCodeSuggestion[];
+}
 export interface Token {
     original: string;
     lower: string;
@@ -31,4 +35,7 @@ export interface ParsedSigInternal {
     siteText?: string;
     siteSource?: "abbreviation" | "text";
     siteTokenIndices: Set<number>;
+    siteCoding?: FhirCoding;
+    siteLookupRequest?: SiteCodeLookupRequest;
+    siteLookups: SiteLookupDetail[];
 }

package/dist/maps.d.ts

@@ -1,4 +1,4 @@
-import { EventTiming, FhirDayOfWeek, FhirPeriodUnit, RouteCode, SNOMEDCTRouteCodes } from "./types";
+import { BodySiteDefinition, EventTiming, FhirDayOfWeek, FhirPeriodUnit, RouteCode, SNOMEDCTRouteCodes } from "./types";
 /**
  * SNOMED CT codings aligned with every known RouteCode. Keeping the structure
  * data-driven ensures any additions to the enumeration are surfaced
@@ -19,6 +19,13 @@ export interface RouteSynonym {
     text: string;
 }
 export declare const DEFAULT_ROUTE_SYNONYMS: Record<string, RouteSynonym>;
+/**
+ * Normalizes body-site phrases into lookup keys by trimming, lower-casing, and
+ * collapsing whitespace. Custom site maps should normalize their keys with the
+ * same logic to ensure consistent lookups.
+ */
+export declare function normalizeBodySiteKey(value: string): string;
+export declare const DEFAULT_BODY_SITE_SNOMED: Record<string, BodySiteDefinition>;
 export declare const HOUSEHOLD_VOLUME_UNITS: readonly ["tsp", "tbsp"];
 export declare const DEFAULT_UNIT_SYNONYMS: Record<string, string>;
 export interface FrequencyDescriptor {