ezmedicationinput 0.1.15 → 0.1.16

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, _c, _d, _e;
+    var _a, _b, _c, _d, _e, _f, _g, _h, _j;
     const dosage = {};
     const repeat = {};
     let hasRepeat = false;
@@ -115,10 +115,40 @@ function toFhir(internal) {
             coding
         };
     }
+    if ((_f = internal.additionalInstructions) === null || _f === void 0 ? void 0 : _f.length) {
+        dosage.additionalInstruction = internal.additionalInstructions.map((instruction) => {
+            var _a, _b;
+            return ({
+                text: instruction.text,
+                coding: ((_a = instruction.coding) === null || _a === void 0 ? void 0 : _a.code)
+                    ? [
+                        {
+                            system: (_b = instruction.coding.system) !== null && _b !== void 0 ? _b : SNOMED_SYSTEM,
+                            code: instruction.coding.code,
+                            display: instruction.coding.display
+                        }
+                    ]
+                    : undefined
+            });
+        });
+    }
     if (internal.asNeeded) {
         dosage.asNeededBoolean = true;
-        if (internal.asNeededReason) {
-            dosage.asNeededFor = [{ text: internal.asNeededReason }];
+        if (internal.asNeededReason || ((_g = internal.asNeededReasonCoding) === null || _g === void 0 ? void 0 : _g.code)) {
+            const concept = {};
+            if (internal.asNeededReason) {
+                concept.text = internal.asNeededReason;
+            }
+            if ((_h = internal.asNeededReasonCoding) === null || _h === void 0 ? void 0 : _h.code) {
+                concept.coding = [
+                    {
+                        system: (_j = internal.asNeededReasonCoding.system) !== null && _j !== void 0 ? _j : SNOMED_SYSTEM,
+                        code: internal.asNeededReasonCoding.code,
+                        display: internal.asNeededReasonCoding.display
+                    }
+                ];
+            }
+            dosage.asNeededFor = [concept];
         }
     }
     const longText = (0, format_1.formatInternal)(internal, "long");
@@ -128,7 +158,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, _6, _7;
+    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, _8, _9, _10, _11;
     const internal = {
         input: (_a = dosage.text) !== null && _a !== void 0 ? _a : "",
         tokens: [],
@@ -152,7 +182,9 @@ function internalFromFhir(dosage) {
         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(),
-        siteLookups: []
+        siteLookups: [],
+        prnReasonLookups: [],
+        additionalInstructions: []
     };
     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) {
@@ -171,13 +203,36 @@ function internalFromFhir(dosage) {
             system: siteCoding.system
         };
     }
-    const doseAndRate = (_5 = dosage.doseAndRate) === null || _5 === void 0 ? void 0 : _5[0];
+    const reasonCoding = (_7 = (_6 = (_5 = dosage.asNeededFor) === null || _5 === void 0 ? void 0 : _5[0]) === null || _6 === void 0 ? void 0 : _6.coding) === null || _7 === void 0 ? void 0 : _7[0];
+    if (reasonCoding === null || reasonCoding === void 0 ? void 0 : reasonCoding.code) {
+        internal.asNeededReasonCoding = {
+            code: reasonCoding.code,
+            display: reasonCoding.display,
+            system: reasonCoding.system
+        };
+    }
+    if ((_8 = dosage.additionalInstruction) === null || _8 === void 0 ? void 0 : _8.length) {
+        internal.additionalInstructions = dosage.additionalInstruction.map((concept) => {
+            var _a;
+            return ({
+                text: concept.text,
+                coding: ((_a = concept.coding) === null || _a === void 0 ? void 0 : _a[0])
+                    ? {
+                        code: concept.coding[0].code,
+                        display: concept.coding[0].display,
+                        system: concept.coding[0].system
+                    }
+                    : undefined
+            });
+        });
+    }
+    const doseAndRate = (_9 = dosage.doseAndRate) === null || _9 === void 0 ? void 0 : _9[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 = (_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;
+        internal.unit = (_11 = (_10 = low === null || low === void 0 ? void 0 : low.unit) !== null && _10 !== void 0 ? _10 : high === null || high === void 0 ? void 0 : high.unit) !== null && _11 !== void 0 ? _11 : internal.unit;
     }
     else if (doseAndRate === null || doseAndRate === void 0 ? void 0 : doseAndRate.doseQuantity) {
         const dose = doseAndRate.doseQuantity;

package/dist/format.js

@@ -603,9 +603,33 @@ function formatLong(internal) {
     }
     const body = segments.filter(Boolean).join(" ").replace(/\s+/g, " ").trim();
     if (!body) {
-        return `${grammar.verb}.`;
+        const instructionText = formatAdditionalInstructions(internal);
+        if (!instructionText) {
+            return `${grammar.verb}.`;
+        }
+        return `${grammar.verb}. ${instructionText}`.trim();
+    }
+    const instructionText = formatAdditionalInstructions(internal);
+    const baseSentence = `${grammar.verb} ${body}.`;
+    return instructionText ? `${baseSentence} ${instructionText}` : baseSentence;
+}
+function formatAdditionalInstructions(internal) {
+    var _a;
+    if (!((_a = internal.additionalInstructions) === null || _a === void 0 ? void 0 : _a.length)) {
+        return undefined;
+    }
+    const phrases = internal.additionalInstructions
+        .map((instruction) => { var _a; return instruction.text || ((_a = instruction.coding) === null || _a === void 0 ? void 0 : _a.display); })
+        .filter((text) => Boolean(text))
+        .map((text) => text.trim())
+        .filter((text) => text.length > 0);
+    if (!phrases.length) {
+        return undefined;
     }
-    return `${grammar.verb} ${body}.`;
+    return phrases
+        .map((phrase) => (/[.!?]$/.test(phrase) ? phrase : `${phrase}.`))
+        .join(" ")
+        .trim();
 }
 function stripTrailingZero(value) {
     const text = value.toString();

package/dist/index.js

@@ -46,12 +46,14 @@ 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.applyPrnReasonCoding)(internal, 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.applyPrnReasonCodingAsync)(internal, options);
         yield (0, parser_1.applySiteCodingAsync)(internal, options);
         return buildParseResult(internal, options);
     });
@@ -62,7 +64,7 @@ function formatSig(dosage, style = "short", options) {
     return (0, format_1.formatInternal)(internal, style, localization);
 }
 function fromFhirDosage(dosage, options) {
-    var _a, _b, _c;
+    var _a, _b, _c, _d, _e, _f;
     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);
@@ -89,13 +91,40 @@ function fromFhirDosage(dosage, options) {
                             }
                             : undefined
                     }
+                    : undefined,
+                prnReason: internal.asNeededReason || ((_d = internal.asNeededReasonCoding) === null || _d === void 0 ? void 0 : _d.code)
+                    ? {
+                        text: internal.asNeededReason,
+                        coding: ((_e = internal.asNeededReasonCoding) === null || _e === void 0 ? void 0 : _e.code)
+                            ? {
+                                code: internal.asNeededReasonCoding.code,
+                                display: internal.asNeededReasonCoding.display,
+                                system: internal.asNeededReasonCoding.system
+                            }
+                            : undefined
+                    }
+                    : undefined,
+                additionalInstructions: ((_f = internal.additionalInstructions) === null || _f === void 0 ? void 0 : _f.length)
+                    ? internal.additionalInstructions.map((instruction) => {
+                        var _a;
+                        return ({
+                            text: instruction.text,
+                            coding: ((_a = instruction.coding) === null || _a === void 0 ? void 0 : _a.code)
+                                ? {
+                                    code: instruction.coding.code,
+                                    display: instruction.coding.display,
+                                    system: instruction.coding.system
+                                }
+                                : undefined
+                        });
+                    })
                     : undefined
             }
         }
     };
 }
 function buildParseResult(internal, options) {
-    var _a;
+    var _a, _b, _c;
     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);
@@ -114,6 +143,28 @@ function buildParseResult(internal, options) {
             system: internal.siteCoding.system
         }
         : undefined;
+    const prnReasonCoding = ((_b = internal.asNeededReasonCoding) === null || _b === void 0 ? void 0 : _b.code)
+        ? {
+            code: internal.asNeededReasonCoding.code,
+            display: internal.asNeededReasonCoding.display,
+            system: internal.asNeededReasonCoding.system
+        }
+        : undefined;
+    const additionalInstructions = ((_c = internal.additionalInstructions) === null || _c === void 0 ? void 0 : _c.length)
+        ? internal.additionalInstructions.map((instruction) => {
+            var _a;
+            return ({
+                text: instruction.text,
+                coding: ((_a = instruction.coding) === null || _a === void 0 ? void 0 : _a.code)
+                    ? {
+                        code: instruction.coding.code,
+                        display: instruction.coding.display,
+                        system: instruction.coding.system
+                    }
+                    : undefined
+            });
+        })
+        : undefined;
     const siteLookups = internal.siteLookups.length
         ? internal.siteLookups.map((entry) => ({
             request: entry.request,
@@ -127,6 +178,21 @@ function buildParseResult(internal, options) {
             }))
         }))
         : undefined;
+    const prnReasonLookups = internal.prnReasonLookups.length
+        ? internal.prnReasonLookups.map((entry) => ({
+            request: entry.request,
+            suggestions: entry.suggestions.map((suggestion) => ({
+                coding: suggestion.coding
+                    ? {
+                        code: suggestion.coding.code,
+                        display: suggestion.coding.display,
+                        system: suggestion.coding.system
+                    }
+                    : undefined,
+                text: suggestion.text
+            }))
+        }))
+        : undefined;
     return {
         fhir,
         shortText,
@@ -145,9 +211,17 @@ function buildParseResult(internal, options) {
                         text: internal.siteText,
                         coding: siteCoding
                     }
-                    : undefined
+                    : undefined,
+                prnReason: internal.asNeededReason || prnReasonCoding
+                    ? {
+                        text: internal.asNeededReason,
+                        coding: prnReasonCoding
+                    }
+                    : undefined,
+                additionalInstructions
             },
-            siteLookups
+            siteLookups,
+            prnReasonLookups
         }
     };
 }

package/dist/internal-types.d.ts

@@ -1,8 +1,12 @@
-import { EventTiming, FhirCoding, FhirDayOfWeek, FhirPeriodUnit, RouteCode, SiteCodeLookupRequest, SiteCodeSuggestion } from "./types";
+import { EventTiming, FhirCoding, FhirDayOfWeek, FhirPeriodUnit, PrnReasonLookupRequest, PrnReasonSuggestion, RouteCode, SiteCodeLookupRequest, SiteCodeSuggestion } from "./types";
 export interface SiteLookupDetail {
     request: SiteCodeLookupRequest;
     suggestions: SiteCodeSuggestion[];
 }
+export interface PrnReasonLookupDetail {
+    request: PrnReasonLookupRequest;
+    suggestions: PrnReasonSuggestion[];
+}
 export interface Token {
     original: string;
     lower: string;
@@ -31,6 +35,7 @@ export interface ParsedSigInternal {
     timingCode?: string;
     asNeeded?: boolean;
     asNeededReason?: string;
+    asNeededReasonCoding?: FhirCoding;
     warnings: string[];
     siteText?: string;
     siteSource?: "abbreviation" | "text";
@@ -39,4 +44,10 @@ export interface ParsedSigInternal {
     siteLookupRequest?: SiteCodeLookupRequest;
     siteLookups: SiteLookupDetail[];
     customSiteHints?: Set<string>;
+    prnReasonLookupRequest?: PrnReasonLookupRequest;
+    prnReasonLookups: PrnReasonLookupDetail[];
+    additionalInstructions: Array<{
+        text?: string;
+        coding?: FhirCoding;
+    }>;
 }

package/dist/maps.d.ts

@@ -1,4 +1,4 @@
-import { BodySiteDefinition, EventTiming, FhirDayOfWeek, FhirPeriodUnit, RouteCode, SNOMEDCTRouteCodes } from "./types";
+import { AdditionalInstructionDefinition, BodySiteDefinition, EventTiming, FhirDayOfWeek, FhirPeriodUnit, PrnReasonDefinition, 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
@@ -58,3 +58,19 @@ export declare const KNOWN_DOSAGE_FORMS_TO_DOSE: Record<string, string>;
 export declare const KNOWN_TMT_DOSAGE_FORM_TO_SNOMED_ROUTE: Record<string, SNOMEDCTRouteCodes>;
 export declare const DEFAULT_UNIT_BY_NORMALIZED_FORM: Record<string, string>;
 export declare const DEFAULT_UNIT_BY_ROUTE: Partial<Record<RouteCode, string>>;
+export declare function normalizePrnReasonKey(value: string): string;
+export declare function normalizeAdditionalInstructionKey(value: string): string;
+export interface PrnReasonDictionaryEntry {
+    canonical: string;
+    definition: PrnReasonDefinition;
+    terms: string[];
+}
+export declare const DEFAULT_PRN_REASON_ENTRIES: PrnReasonDictionaryEntry[];
+export declare const DEFAULT_PRN_REASON_DEFINITIONS: Record<string, PrnReasonDefinition>;
+export interface AdditionalInstructionDictionaryEntry {
+    canonical: string;
+    definition: AdditionalInstructionDefinition;
+    terms: string[];
+}
+export declare const DEFAULT_ADDITIONAL_INSTRUCTION_ENTRIES: AdditionalInstructionDictionaryEntry[];
+export declare const DEFAULT_ADDITIONAL_INSTRUCTION_DEFINITIONS: Record<string, AdditionalInstructionDefinition>;

package/dist/maps.js

@@ -1,9 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DEFAULT_UNIT_BY_ROUTE = exports.DEFAULT_UNIT_BY_NORMALIZED_FORM = exports.KNOWN_TMT_DOSAGE_FORM_TO_SNOMED_ROUTE = exports.KNOWN_DOSAGE_FORMS_TO_DOSE = exports.WORD_FREQUENCIES = exports.DAY_OF_WEEK_TOKENS = exports.DISCOURAGED_TOKENS = exports.MEAL_KEYWORDS = exports.EVENT_TIMING_TOKENS = exports.TIMING_ABBREVIATIONS = exports.DEFAULT_UNIT_SYNONYMS = exports.HOUSEHOLD_VOLUME_UNITS = exports.DEFAULT_BODY_SITE_SNOMED = exports.DEFAULT_ROUTE_SYNONYMS = exports.ROUTE_BY_SNOMED = exports.ROUTE_TEXT = exports.ROUTE_SNOMED = void 0;
+exports.DEFAULT_ADDITIONAL_INSTRUCTION_DEFINITIONS = exports.DEFAULT_ADDITIONAL_INSTRUCTION_ENTRIES = exports.DEFAULT_PRN_REASON_DEFINITIONS = exports.DEFAULT_PRN_REASON_ENTRIES = exports.DEFAULT_UNIT_BY_ROUTE = exports.DEFAULT_UNIT_BY_NORMALIZED_FORM = exports.KNOWN_TMT_DOSAGE_FORM_TO_SNOMED_ROUTE = exports.KNOWN_DOSAGE_FORMS_TO_DOSE = exports.WORD_FREQUENCIES = exports.DAY_OF_WEEK_TOKENS = exports.DISCOURAGED_TOKENS = exports.MEAL_KEYWORDS = exports.EVENT_TIMING_TOKENS = exports.TIMING_ABBREVIATIONS = exports.DEFAULT_UNIT_SYNONYMS = exports.HOUSEHOLD_VOLUME_UNITS = exports.DEFAULT_BODY_SITE_SNOMED = exports.DEFAULT_ROUTE_SYNONYMS = exports.ROUTE_BY_SNOMED = exports.ROUTE_TEXT = exports.ROUTE_SNOMED = void 0;
 exports.normalizeBodySiteKey = normalizeBodySiteKey;
+exports.normalizePrnReasonKey = normalizePrnReasonKey;
+exports.normalizeAdditionalInstructionKey = normalizeAdditionalInstructionKey;
 const types_1 = require("./types");
 const object_1 = require("./utils/object");
+const SNOMED_SYSTEM = "http://snomed.info/sct";
 const ROUTE_TEXT_OVERRIDES = {
     [types_1.RouteCode["Oral route"]]: "by mouth",
     [types_1.RouteCode["Sublingual route"]]: "sublingual",
@@ -1253,3 +1256,313 @@ exports.DEFAULT_UNIT_BY_ROUTE = (() => {
     ensure(types_1.RouteCode["Transdermal route"], "patch");
     return resolved;
 })();
+function normalizePrnReasonKey(value) {
+    return value
+        .trim()
+        .toLowerCase()
+        .replace(/[^\p{L}\p{N}]+/gu, " ")
+        .replace(/\s+/g, " ")
+        .trim();
+}
+function normalizeAdditionalInstructionKey(value) {
+    return value
+        .trim()
+        .toLowerCase()
+        .replace(/[^\p{L}\p{N}]+/gu, " ")
+        .replace(/\s+/g, " ")
+        .trim();
+}
+const DEFAULT_PRN_REASON_SOURCE = [
+    {
+        names: ["pain", "ache", "aches", "pains"],
+        definition: {
+            coding: { system: SNOMED_SYSTEM, code: "22253000", display: "Pain" },
+            text: "Pain"
+        }
+    },
+    {
+        names: ["nausea", "queasiness"],
+        definition: {
+            coding: { system: SNOMED_SYSTEM, code: "422587007", display: "Nausea" },
+            text: "Nausea"
+        }
+    },
+    {
+        names: ["itch", "itching", "itchy"],
+        definition: {
+            coding: {
+                system: SNOMED_SYSTEM,
+                code: "418363000",
+                display: "Itching of skin"
+            },
+            text: "Itching"
+        }
+    },
+    {
+        names: ["anxiety", "nervousness"],
+        definition: {
+            coding: { system: SNOMED_SYSTEM, code: "48694002", display: "Anxiety" },
+            text: "Anxiety"
+        }
+    },
+    {
+        names: ["sleep", "sleeping", "insomnia", "sleep issues"],
+        definition: {
+            coding: {
+                system: SNOMED_SYSTEM,
+                code: "193462001",
+                display: "Insomnia"
+            },
+            text: "Sleep"
+        }
+    },
+    {
+        names: ["cough", "coughing"],
+        definition: {
+            coding: { system: SNOMED_SYSTEM, code: "49727002", display: "Cough" },
+            text: "Cough"
+        }
+    },
+    {
+        names: ["fever", "temperature", "pyrexia"],
+        definition: {
+            coding: { system: SNOMED_SYSTEM, code: "386661006", display: "Fever" },
+            text: "Fever"
+        }
+    },
+    {
+        names: ["spasm", "spasms", "muscle spasm"],
+        definition: {
+            coding: { system: SNOMED_SYSTEM, code: "45352006", display: "Spasm" },
+            text: "Spasm"
+        }
+    },
+    {
+        names: ["constipation"],
+        definition: {
+            coding: {
+                system: SNOMED_SYSTEM,
+                code: "14760008",
+                display: "Constipation"
+            },
+            text: "Constipation"
+        }
+    },
+    {
+        names: ["dyspnea", "shortness of breath", "sob", "breathlessness"],
+        definition: {
+            coding: {
+                system: SNOMED_SYSTEM,
+                code: "267036007",
+                display: "Dyspnea"
+            },
+            text: "Shortness of breath"
+        }
+    }
+];
+exports.DEFAULT_PRN_REASON_ENTRIES = DEFAULT_PRN_REASON_SOURCE.map((source) => {
+    var _a, _b, _c;
+    const canonicalTerm = (_c = (_a = source.definition.text) !== null && _a !== void 0 ? _a : (_b = source.definition.coding) === null || _b === void 0 ? void 0 : _b.display) !== null && _c !== void 0 ? _c : source.names[0];
+    return {
+        canonical: normalizePrnReasonKey(canonicalTerm !== null && canonicalTerm !== void 0 ? canonicalTerm : ""),
+        definition: source.definition,
+        terms: [...source.names]
+    };
+});
+exports.DEFAULT_PRN_REASON_DEFINITIONS = (0, object_1.objectFromEntries)(DEFAULT_PRN_REASON_SOURCE.reduce((entries, source) => {
+    for (const name of source.names) {
+        const key = normalizePrnReasonKey(name);
+        if (!key) {
+            continue;
+        }
+        entries.push([key, source.definition]);
+    }
+    if (source.definition.aliases) {
+        for (const alias of source.definition.aliases) {
+            const key = normalizePrnReasonKey(alias);
+            if (!key) {
+                continue;
+            }
+            entries.push([key, source.definition]);
+        }
+    }
+    return entries;
+}, []));
+const DEFAULT_ADDITIONAL_INSTRUCTION_SOURCE = [
+    {
+        names: ["with food", "with meals", "with meal", "after food", "after meals"],
+        definition: {
+            coding: {
+                system: SNOMED_SYSTEM,
+                code: "311504000",
+                display: "With or after food"
+            },
+            text: "Take with or after food"
+        }
+    },
+    {
+        names: ["before food", "before meals", "before meal", "1 hour before food"],
+        definition: {
+            coding: {
+                system: SNOMED_SYSTEM,
+                code: "311501008",
+                display: "Half to one hour before food"
+            },
+            text: "Take before food"
+        }
+    },
+    {
+        names: ["empty stomach", "on empty stomach"],
+        definition: {
+            coding: {
+                system: SNOMED_SYSTEM,
+                code: "717154004",
+                display: "Take on an empty stomach (qualifier value)"
+            },
+            text: "Take on an empty stomach"
+        }
+    },
+    {
+        names: ["with water", "with plenty of water", "drink water", "with lots of water"],
+        definition: {
+            coding: {
+                system: SNOMED_SYSTEM,
+                code: "419303009",
+                display: "With plenty of water"
+            },
+            text: "Take with plenty of water"
+        }
+    },
+    {
+        names: ["dissolve in water", "mix with water", "mix in water"],
+        definition: {
+            coding: {
+                system: SNOMED_SYSTEM,
+                code: "417995008",
+                display: "Dissolve or mix with water before taking"
+            },
+            text: "Dissolve or mix with water before taking"
+        }
+    },
+    {
+        names: ["avoid alcohol", "no alcohol", "no alc", "avoid alcoholic drink"],
+        definition: {
+            coding: {
+                system: SNOMED_SYSTEM,
+                code: "419822006",
+                display: "Warning. Avoid alcoholic drink (qualifier value)"
+            },
+            text: "Avoid alcoholic drinks"
+        }
+    },
+    {
+        names: ["may cause drowsiness", "do not drive", "avoid driving", "no driving", "no drive"],
+        definition: {
+            coding: {
+                system: SNOMED_SYSTEM,
+                code: "418954008",
+                display: "Warning. May cause drowsiness. If affected do not drive or operate machinery (qualifier value)"
+            },
+            text: "May cause drowsiness; do not drive if affected"
+        }
+    },
+    {
+        names: [
+            "drowsiness avoid alcohol",
+            "may cause drowsiness avoid alcohol",
+            "do not drive avoid alcohol",
+            "drowsy avoid alc",
+            "drowsy avoid drive",
+            "drowsy avoid driving",
+            "drowsy no drive",
+            "drowsy no driving",
+            "drowsy no alc"
+        ],
+        definition: {
+            coding: {
+                system: SNOMED_SYSTEM,
+                code: "418914006",
+                display: "Warning. May cause drowsiness. If affected do not drive or operate machinery. Avoid alcoholic drink (qualifier value)"
+            },
+            text: "May cause drowsiness; avoid driving or alcohol"
+        }
+    },
+    {
+        names: [
+            "drowsiness next day",
+            "drowsiness next day avoid alcohol",
+            "may cause drowsiness next day",
+            "may next day drowsy",
+            "may drowsy next day"
+        ],
+        definition: {
+            coding: {
+                system: SNOMED_SYSTEM,
+                code: "418071006",
+                display: "Warning. Causes drowsiness which may continue the next day. If affected do not drive or operate machinery. Avoid alcoholic drink (qualifier value)"
+            },
+            text: "May cause next-day drowsiness; avoid driving or alcohol"
+        }
+    },
+    {
+        names: ["avoid sun", "avoid sunlight", "avoid sun lamps"],
+        definition: {
+            coding: {
+                system: SNOMED_SYSTEM,
+                code: "418521000",
+                display: "Avoid exposure of skin to direct sunlight or sun lamps (qualifier value)"
+            },
+            text: "Avoid sunlight or sun lamps"
+        }
+    },
+    {
+        names: ["swallow whole", "do not chew", "do not crush", "do not crush or chew", "no chewing"],
+        definition: {
+            coding: {
+                system: SNOMED_SYSTEM,
+                code: "418693002",
+                display: "Swallowed whole, not chewed (qualifier value)"
+            },
+            text: "Swallow whole; do not crush or chew"
+        }
+    },
+    {
+        names: ["chew", "chewed", "sucked or chewed", "please chew", "must chew"],
+        definition: {
+            coding: {
+                system: SNOMED_SYSTEM,
+                code: "418991002",
+                display: "Sucked or chewed (qualifier value)"
+            },
+            text: "Suck or chew before swallowing"
+        }
+    }
+];
+exports.DEFAULT_ADDITIONAL_INSTRUCTION_ENTRIES = DEFAULT_ADDITIONAL_INSTRUCTION_SOURCE.map((source) => {
+    var _a, _b, _c;
+    const canonicalTerm = (_c = (_a = source.definition.text) !== null && _a !== void 0 ? _a : (_b = source.definition.coding) === null || _b === void 0 ? void 0 : _b.display) !== null && _c !== void 0 ? _c : source.names[0];
+    return {
+        canonical: normalizeAdditionalInstructionKey(canonicalTerm !== null && canonicalTerm !== void 0 ? canonicalTerm : ""),
+        definition: source.definition,
+        terms: [...source.names]
+    };
+});
+exports.DEFAULT_ADDITIONAL_INSTRUCTION_DEFINITIONS = (0, object_1.objectFromEntries)(DEFAULT_ADDITIONAL_INSTRUCTION_SOURCE.reduce((entries, source) => {
+    for (const name of source.names) {
+        const key = normalizeAdditionalInstructionKey(name);
+        if (!key) {
+            continue;
+        }
+        entries.push([key, source.definition]);
+    }
+    if (source.definition.aliases) {
+        for (const alias of source.definition.aliases) {
+            const key = normalizeAdditionalInstructionKey(alias);
+            if (!key) {
+                continue;
+            }
+            entries.push([key, source.definition]);
+        }
+    }
+    return entries;
+}, []));

package/dist/parser.d.ts

@@ -6,6 +6,8 @@ export declare function parseInternal(input: string, options?: ParseOptions): Pa
  * Resolves parsed site text against SNOMED dictionaries and synchronous
  * callbacks, applying the best match to the in-progress parse result.
  */
+export declare function applyPrnReasonCoding(internal: ParsedSigInternal, options?: ParseOptions): void;
+export declare function applyPrnReasonCodingAsync(internal: ParsedSigInternal, options?: ParseOptions): Promise<void>;
 export declare function applySiteCoding(internal: ParsedSigInternal, options?: ParseOptions): void;
 /**
  * Asynchronous counterpart to {@link applySiteCoding} that awaits resolver and