ezmedicationinput 0.1.43 → 0.1.44

package/dist/fhir.js

@@ -1,94 +1,310 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.canonicalToFhir = canonicalToFhir;
 exports.toFhir = toFhir;
-exports.internalFromFhir = internalFromFhir;
+exports.canonicalFromFhir = canonicalFromFhir;
+exports.parserStateFromFhir = parserStateFromFhir;
+const advice_1 = require("./advice");
+const fhir_translations_1 = require("./fhir-translations");
 const format_1 = require("./format");
+const parser_state_1 = require("./parser-state");
+const prn_1 = require("./prn");
 const maps_1 = require("./maps");
 const types_1 = require("./types");
 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, _f, _g, _h, _j, _k;
+const UCUM_SYSTEM = "http://unitsofmeasure.org";
+function createEmptyCanonicalClause(rawText) {
+    return {
+        kind: "administration",
+        rawText,
+        raw: {
+            start: 0,
+            end: rawText.length,
+            text: rawText
+        },
+        leftovers: [],
+        evidence: [],
+        confidence: 1
+    };
+}
+function selectFirstCodingWithCode(concept) {
+    var _a;
+    if (!((_a = concept === null || concept === void 0 ? void 0 : concept.coding) === null || _a === void 0 ? void 0 : _a.length)) {
+        return undefined;
+    }
+    for (const coding of concept.coding) {
+        if (coding.code) {
+            return coding;
+        }
+    }
+    return undefined;
+}
+function selectPreferredSiteCoding(site) {
+    var _a;
+    if (!((_a = site === null || site === void 0 ? void 0 : site.coding) === null || _a === void 0 ? void 0 : _a.length)) {
+        return undefined;
+    }
+    for (const coding of site.coding) {
+        if (coding.system === SNOMED_SYSTEM && coding.code) {
+            return coding;
+        }
+    }
+    return selectFirstCodingWithCode(site);
+}
+function buildFhirDoseRange(range, unit) {
+    const fhirRange = {};
+    if (range.low !== undefined) {
+        fhirRange.low = {
+            value: range.low,
+            unit
+        };
+    }
+    if (range.high !== undefined) {
+        fhirRange.high = {
+            value: range.high,
+            unit
+        };
+    }
+    if (!fhirRange.low && !fhirRange.high) {
+        return undefined;
+    }
+    return fhirRange;
+}
+function describeDurationUnit(unit, value) {
+    const plural = value !== 1;
+    switch (unit) {
+        case types_1.FhirPeriodUnit.Second:
+            return plural ? "seconds" : "second";
+        case types_1.FhirPeriodUnit.Minute:
+            return plural ? "minutes" : "minute";
+        case types_1.FhirPeriodUnit.Hour:
+            return plural ? "hours" : "hour";
+        case types_1.FhirPeriodUnit.Day:
+            return plural ? "days" : "day";
+        case types_1.FhirPeriodUnit.Week:
+            return plural ? "weeks" : "week";
+        case types_1.FhirPeriodUnit.Month:
+            return plural ? "months" : "month";
+        case types_1.FhirPeriodUnit.Year:
+            return plural ? "years" : "year";
+        default:
+            return unit;
+    }
+}
+function buildFhirDurationQuantity(value, unit) {
+    return {
+        value,
+        unit: describeDurationUnit(unit, value),
+        system: UCUM_SYSTEM,
+        code: unit
+    };
+}
+function buildFhirBoundsRange(low, high, unit) {
+    return {
+        low: buildFhirDurationQuantity(low, unit),
+        high: buildFhirDurationQuantity(high, unit)
+    };
+}
+function parseFhirDurationUnit(quantity) {
+    var _a, _b, _c;
+    const candidate = (_b = (_a = quantity === null || quantity === void 0 ? void 0 : quantity.code) === null || _a === void 0 ? void 0 : _a.trim().toLowerCase()) !== null && _b !== void 0 ? _b : (_c = quantity === null || quantity === void 0 ? void 0 : quantity.unit) === null || _c === void 0 ? void 0 : _c.trim().toLowerCase();
+    switch (candidate) {
+        case "s":
+        case "sec":
+        case "second":
+        case "seconds":
+            return types_1.FhirPeriodUnit.Second;
+        case "min":
+        case "mins":
+        case "minute":
+        case "minutes":
+            return types_1.FhirPeriodUnit.Minute;
+        case "h":
+        case "hr":
+        case "hrs":
+        case "hour":
+        case "hours":
+            return types_1.FhirPeriodUnit.Hour;
+        case "d":
+        case "day":
+        case "days":
+            return types_1.FhirPeriodUnit.Day;
+        case "wk":
+        case "wks":
+        case "week":
+        case "weeks":
+            return types_1.FhirPeriodUnit.Week;
+        case "mo":
+        case "month":
+        case "months":
+            return types_1.FhirPeriodUnit.Month;
+        case "a":
+        case "yr":
+        case "yrs":
+        case "year":
+        case "years":
+            return types_1.FhirPeriodUnit.Year;
+        default:
+            return undefined;
+    }
+}
+function extractCanonicalTimingBounds(repeat) {
+    var _a;
+    if (!repeat) {
+        return {};
+    }
+    if (((_a = repeat.boundsDuration) === null || _a === void 0 ? void 0 : _a.value) !== undefined) {
+        const durationUnit = parseFhirDurationUnit(repeat.boundsDuration);
+        if (!durationUnit) {
+            return {};
+        }
+        return {
+            duration: repeat.boundsDuration.value,
+            durationUnit
+        };
+    }
+    if (!repeat.boundsRange) {
+        return {};
+    }
+    const low = repeat.boundsRange.low;
+    const high = repeat.boundsRange.high;
+    const lowUnit = parseFhirDurationUnit(low);
+    const highUnit = parseFhirDurationUnit(high);
+    const durationUnit = lowUnit !== null && lowUnit !== void 0 ? lowUnit : highUnit;
+    if (!durationUnit) {
+        return {};
+    }
+    let warning;
+    if (lowUnit && highUnit && lowUnit !== highUnit) {
+        warning = `FHIR timing boundsRange low/high units differ (${lowUnit} vs ${highUnit}); preserved numeric bounds using ${durationUnit}.`;
+    }
+    return {
+        duration: low === null || low === void 0 ? void 0 : low.value,
+        durationMax: high === null || high === void 0 ? void 0 : high.value,
+        durationUnit,
+        warning
+    };
+}
+function extractCanonicalDoseRange(range) {
+    var _a, _b, _c, _d;
+    const canonicalRange = {};
+    const lowUnit = (_a = range.low) === null || _a === void 0 ? void 0 : _a.unit;
+    const highUnit = (_b = range.high) === null || _b === void 0 ? void 0 : _b.unit;
+    if (((_c = range.low) === null || _c === void 0 ? void 0 : _c.value) !== undefined) {
+        canonicalRange.low = range.low.value;
+    }
+    if (((_d = range.high) === null || _d === void 0 ? void 0 : _d.value) !== undefined) {
+        canonicalRange.high = range.high.value;
+    }
+    if (canonicalRange.low === undefined && canonicalRange.high === undefined) {
+        return {};
+    }
+    const unit = lowUnit !== null && lowUnit !== void 0 ? lowUnit : highUnit;
+    let warning;
+    if (lowUnit && highUnit && lowUnit !== highUnit) {
+        warning = `FHIR doseRange low/high units differ (${lowUnit} vs ${highUnit}); preserved numeric bounds using ${unit}.`;
+    }
+    return {
+        range: canonicalRange,
+        unit,
+        warning
+    };
+}
+function appendWarning(warnings, warning) {
+    if (!warning) {
+        return warnings;
+    }
+    if (!warnings) {
+        return [warning];
+    }
+    warnings.push(warning);
+    return warnings;
+}
+function canonicalToFhir(clause, textOverride) {
+    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;
     const dosage = {};
     const repeat = {};
     let hasRepeat = false;
-    if (internal.frequency !== undefined) {
-        repeat.frequency = internal.frequency;
+    const schedule = clause.schedule;
+    if ((schedule === null || schedule === void 0 ? void 0 : schedule.frequency) !== undefined) {
+        repeat.frequency = schedule.frequency;
         hasRepeat = true;
     }
-    if (internal.count !== undefined) {
-        repeat.count = internal.count;
+    if ((schedule === null || schedule === void 0 ? void 0 : schedule.count) !== undefined) {
+        repeat.count = schedule.count;
         hasRepeat = true;
     }
-    if (internal.frequencyMax !== undefined) {
-        repeat.frequencyMax = internal.frequencyMax;
+    if ((schedule === null || schedule === void 0 ? void 0 : schedule.duration) !== undefined && schedule.durationUnit) {
+        if (schedule.durationMax !== undefined && schedule.durationMax !== schedule.duration) {
+            repeat.boundsRange = buildFhirBoundsRange(schedule.duration, schedule.durationMax, schedule.durationUnit);
+        }
+        else {
+            repeat.boundsDuration = buildFhirDurationQuantity(schedule.duration, schedule.durationUnit);
+        }
+        hasRepeat = true;
+    }
+    if ((schedule === null || schedule === void 0 ? void 0 : schedule.frequencyMax) !== undefined) {
+        repeat.frequencyMax = schedule.frequencyMax;
         hasRepeat = true;
     }
-    if (internal.period !== undefined && internal.periodUnit) {
-        repeat.period = internal.period;
-        repeat.periodUnit = internal.periodUnit;
+    if ((schedule === null || schedule === void 0 ? void 0 : schedule.period) !== undefined && schedule.periodUnit) {
+        repeat.period = schedule.period;
+        repeat.periodUnit = schedule.periodUnit;
         hasRepeat = true;
     }
-    if (internal.periodMax !== undefined) {
-        repeat.periodMax = internal.periodMax;
+    if ((schedule === null || schedule === void 0 ? void 0 : schedule.periodMax) !== undefined) {
+        repeat.periodMax = schedule.periodMax;
         hasRepeat = true;
     }
-    if (internal.dayOfWeek.length) {
-        repeat.dayOfWeek = [...internal.dayOfWeek];
+    if ((_a = schedule === null || schedule === void 0 ? void 0 : schedule.dayOfWeek) === null || _a === void 0 ? void 0 : _a.length) {
+        repeat.dayOfWeek = [...schedule.dayOfWeek];
         hasRepeat = true;
     }
-    if (internal.when.length) {
-        repeat.when = [...internal.when];
+    if ((_b = schedule === null || schedule === void 0 ? void 0 : schedule.when) === null || _b === void 0 ? void 0 : _b.length) {
+        repeat.when = [...schedule.when];
         hasRepeat = true;
     }
-    if ((_a = internal.timeOfDay) === null || _a === void 0 ? void 0 : _a.length) {
-        repeat.timeOfDay = [...internal.timeOfDay];
+    if ((_c = schedule === null || schedule === void 0 ? void 0 : schedule.timeOfDay) === null || _c === void 0 ? void 0 : _c.length) {
+        repeat.timeOfDay = [...schedule.timeOfDay];
         hasRepeat = true;
     }
     if (hasRepeat) {
         dosage.timing = { repeat };
     }
-    else {
-        dosage.timing = {};
-    }
-    if (internal.timingCode) {
-        dosage.timing = (_b = dosage.timing) !== null && _b !== void 0 ? _b : {};
+    if (schedule === null || schedule === void 0 ? void 0 : schedule.timingCode) {
+        dosage.timing = (_d = dosage.timing) !== null && _d !== void 0 ? _d : {};
         dosage.timing.code = {
-            coding: [{ code: internal.timingCode }],
-            text: internal.timingCode
+            coding: [{ code: schedule.timingCode }],
+            text: schedule.timingCode
         };
     }
-    if (internal.doseRange) {
-        dosage.doseAndRate = [
-            {
-                doseRange: {
-                    low: internal.doseRange.low !== undefined
-                        ? { value: internal.doseRange.low, unit: internal.unit }
-                        : undefined,
-                    high: internal.doseRange.high !== undefined
-                        ? { value: internal.doseRange.high, unit: internal.unit }
-                        : undefined
+    if ((_e = clause.dose) === null || _e === void 0 ? void 0 : _e.range) {
+        const doseRange = buildFhirDoseRange(clause.dose.range, clause.dose.unit);
+        if (doseRange) {
+            dosage.doseAndRate = [
+                {
+                    doseRange
                 }
-            }
-        ];
+            ];
+        }
     }
-    else if (internal.dose !== undefined) {
+    else if (((_f = clause.dose) === null || _f === void 0 ? void 0 : _f.value) !== undefined) {
         dosage.doseAndRate = [
             {
                 doseQuantity: {
-                    value: internal.dose,
-                    unit: internal.unit
+                    value: clause.dose.value,
+                    unit: clause.dose.unit
                 }
             }
         ];
     }
-    // Emit SNOMED-coded routes whenever we have parsed or inferred route data.
-    if (internal.routeCode || internal.routeText) {
-        const coding = internal.routeCode ? maps_1.ROUTE_SNOMED[internal.routeCode] : undefined;
-        const text = (_c = internal.routeText) !== null && _c !== void 0 ? _c : (internal.routeCode ? maps_1.ROUTE_TEXT[internal.routeCode] : undefined);
+    if (((_g = clause.route) === null || _g === void 0 ? void 0 : _g.code) || ((_h = clause.route) === null || _h === void 0 ? void 0 : _h.text)) {
+        const routeCode = (_j = clause.route) === null || _j === void 0 ? void 0 : _j.code;
+        const coding = routeCode ? maps_1.ROUTE_SNOMED[routeCode] : undefined;
+        const text = (_l = (_k = clause.route) === null || _k === void 0 ? void 0 : _k.text) !== null && _l !== void 0 ? _l : (routeCode ? maps_1.ROUTE_TEXT[routeCode] : undefined);
         if (coding) {
-            // Provide both text and coding so human-readable and coded systems align.
             dosage.route = {
                 text,
                 coding: [
@@ -104,128 +320,332 @@ function toFhir(internal) {
             dosage.route = { text };
         }
     }
-    if (internal.siteText || ((_d = internal.siteCoding) === null || _d === void 0 ? void 0 : _d.code)) {
-        const coding = ((_e = internal.siteCoding) === null || _e === void 0 ? void 0 : _e.code)
+    if (((_m = clause.site) === null || _m === void 0 ? void 0 : _m.text) || ((_p = (_o = clause.site) === null || _o === void 0 ? void 0 : _o.coding) === null || _p === void 0 ? void 0 : _p.code)) {
+        const coding = ((_r = (_q = clause.site) === null || _q === void 0 ? void 0 : _q.coding) === null || _r === void 0 ? void 0 : _r.code)
             ? [
                 {
-                    system: (_f = internal.siteCoding.system) !== null && _f !== void 0 ? _f : SNOMED_SYSTEM,
-                    code: internal.siteCoding.code,
-                    display: internal.siteCoding.display
+                    system: (_s = clause.site.coding.system) !== null && _s !== void 0 ? _s : SNOMED_SYSTEM,
+                    code: clause.site.coding.code,
+                    display: clause.site.coding.display
                 }
             ]
             : undefined;
         dosage.site = {
-            text: internal.siteText,
+            text: (_t = clause.site) === null || _t === void 0 ? void 0 : _t.text,
             coding
         };
     }
-    if ((_g = internal.additionalInstructions) === null || _g === void 0 ? void 0 : _g.length) {
-        dosage.additionalInstruction = internal.additionalInstructions.map((instruction) => {
-            var _a, _b;
-            return ({
+    if (((_u = clause.method) === null || _u === void 0 ? void 0 : _u.text) || ((_v = clause.method) === null || _v === void 0 ? void 0 : _v._text) || ((_x = (_w = clause.method) === null || _w === void 0 ? void 0 : _w.coding) === null || _x === void 0 ? void 0 : _x.code)) {
+        dosage.method = {
+            text: (_y = clause.method) === null || _y === void 0 ? void 0 : _y.text,
+            _text: (0, fhir_translations_1.clonePrimitiveElement)((_z = clause.method) === null || _z === void 0 ? void 0 : _z._text),
+            coding: ((_1 = (_0 = clause.method) === null || _0 === void 0 ? void 0 : _0.coding) === null || _1 === void 0 ? void 0 : _1.code)
+                ? [
+                    {
+                        system: (_2 = clause.method.coding.system) !== null && _2 !== void 0 ? _2 : SNOMED_SYSTEM,
+                        code: clause.method.coding.code,
+                        display: clause.method.coding.display,
+                        _display: (0, fhir_translations_1.clonePrimitiveElement)(clause.method.coding._display)
+                    }
+                ]
+                : undefined
+        };
+    }
+    if ((_3 = clause.additionalInstructions) === null || _3 === void 0 ? void 0 : _3.length) {
+        dosage.additionalInstruction = [];
+        for (const instruction of clause.additionalInstructions) {
+            dosage.additionalInstruction.push({
                 text: instruction.text,
-                coding: ((_a = instruction.coding) === null || _a === void 0 ? void 0 : _a.code)
+                coding: ((_4 = instruction.coding) === null || _4 === void 0 ? void 0 : _4.code)
                     ? [
                         {
-                            system: (_b = instruction.coding.system) !== null && _b !== void 0 ? _b : SNOMED_SYSTEM,
+                            system: (_5 = instruction.coding.system) !== null && _5 !== void 0 ? _5 : SNOMED_SYSTEM,
                             code: instruction.coding.code,
                             display: instruction.coding.display
                         }
                     ]
                     : undefined
             });
-        });
+        }
     }
-    if (internal.asNeeded) {
+    if ((_6 = clause.prn) === null || _6 === void 0 ? void 0 : _6.enabled) {
         dosage.asNeededBoolean = true;
-        if (internal.asNeededReason || ((_h = internal.asNeededReasonCoding) === null || _h === void 0 ? void 0 : _h.code)) {
-            const concept = {};
-            if (internal.asNeededReason) {
-                concept.text = internal.asNeededReason;
-            }
-            if ((_j = internal.asNeededReasonCoding) === null || _j === void 0 ? void 0 : _j.code) {
-                concept.coding = [
-                    {
-                        system: (_k = internal.asNeededReasonCoding.system) !== null && _k !== void 0 ? _k : SNOMED_SYSTEM,
-                        code: internal.asNeededReasonCoding.code,
-                        display: internal.asNeededReasonCoding.display
-                    }
-                ];
+        const reasons = ((_7 = clause.prn.reasons) === null || _7 === void 0 ? void 0 : _7.length) ? clause.prn.reasons : clause.prn.reason ? [clause.prn.reason] : [];
+        if (reasons.length) {
+            dosage.asNeededFor = [];
+            for (const reason of reasons) {
+                const concept = {};
+                if (reason.text) {
+                    concept.text = reason.text;
+                }
+                if ((_8 = reason.coding) === null || _8 === void 0 ? void 0 : _8.code) {
+                    concept.coding = [
+                        {
+                            system: (_9 = reason.coding.system) !== null && _9 !== void 0 ? _9 : SNOMED_SYSTEM,
+                            code: reason.coding.code,
+                            display: reason.coding.display
+                        }
+                    ];
+                }
+                dosage.asNeededFor.push(concept);
             }
-            dosage.asNeededFor = [concept];
         }
     }
-    const longText = (0, format_1.formatInternal)(internal, "long");
+    const longText = textOverride !== null && textOverride !== void 0 ? textOverride : (0, format_1.formatCanonicalClause)(clause, "long");
     if (longText) {
         dosage.text = longText;
     }
+    if (clause.patientInstruction) {
+        dosage.patientInstruction = clause.patientInstruction;
+    }
     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, _8, _9, _10, _11, _12, _13, _14;
-    const internal = {
-        input: (_a = dosage.text) !== null && _a !== void 0 ? _a : "",
-        tokens: [],
-        consumed: new Set(),
-        dayOfWeek: ((_c = (_b = dosage.timing) === null || _b === void 0 ? void 0 : _b.repeat) === null || _c === void 0 ? void 0 : _c.dayOfWeek)
-            ? [...dosage.timing.repeat.dayOfWeek]
-            : [],
-        when: ((_e = (_d = dosage.timing) === null || _d === void 0 ? void 0 : _d.repeat) === null || _e === void 0 ? void 0 : _e.when)
-            ? dosage.timing.repeat.when.filter((value) => (0, array_1.arrayIncludes)((0, object_1.objectValues)(types_1.EventTiming), value))
-            : [],
-        timeOfDay: ((_g = (_f = dosage.timing) === null || _f === void 0 ? void 0 : _f.repeat) === null || _g === void 0 ? void 0 : _g.timeOfDay)
-            ? [...dosage.timing.repeat.timeOfDay]
-            : [],
-        warnings: [],
-        timingCode: (_l = (_k = (_j = (_h = dosage.timing) === null || _h === void 0 ? void 0 : _h.code) === null || _j === void 0 ? void 0 : _j.coding) === null || _k === void 0 ? void 0 : _k[0]) === null || _l === void 0 ? void 0 : _l.code,
-        count: (_o = (_m = dosage.timing) === null || _m === void 0 ? void 0 : _m.repeat) === null || _o === void 0 ? void 0 : _o.count,
-        frequency: (_q = (_p = dosage.timing) === null || _p === void 0 ? void 0 : _p.repeat) === null || _q === void 0 ? void 0 : _q.frequency,
-        frequencyMax: (_s = (_r = dosage.timing) === null || _r === void 0 ? void 0 : _r.repeat) === null || _s === void 0 ? void 0 : _s.frequencyMax,
-        period: (_u = (_t = dosage.timing) === null || _t === void 0 ? void 0 : _t.repeat) === null || _u === void 0 ? void 0 : _u.period,
-        periodMax: (_w = (_v = dosage.timing) === null || _v === void 0 ? void 0 : _v.repeat) === null || _w === void 0 ? void 0 : _w.periodMax,
-        periodUnit: (_y = (_x = dosage.timing) === null || _x === void 0 ? void 0 : _x.repeat) === null || _y === void 0 ? void 0 : _y.periodUnit,
-        routeText: (_z = dosage.route) === null || _z === void 0 ? void 0 : _z.text,
-        siteText: (_0 = dosage.site) === null || _0 === void 0 ? void 0 : _0.text,
-        asNeeded: dosage.asNeededBoolean,
-        asNeededReason: (_2 = (_1 = dosage.asNeededFor) === null || _1 === void 0 ? void 0 : _1[0]) === null || _2 === void 0 ? void 0 : _2.text,
-        siteTokenIndices: new Set(),
-        siteLookups: [],
-        prnReasonLookups: [],
-        additionalInstructions: []
-    };
-    const routeCoding = (_4 = (_3 = dosage.route) === null || _3 === void 0 ? void 0 : _3.coding) === null || _4 === void 0 ? void 0 : _4.find((code) => code.system === SNOMED_SYSTEM);
+function toFhir(state) {
+    var _a;
+    const clauses = state.clauses;
+    const clause = (_a = clauses[0]) !== null && _a !== void 0 ? _a : createEmptyCanonicalClause(state.input);
+    return canonicalToFhir(clause);
+}
+function canonicalFromFhir(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, _8, _9;
+    const rawText = (_a = dosage.text) !== null && _a !== void 0 ? _a : "";
+    const clause = createEmptyCanonicalClause(rawText);
+    let routeCode;
+    const routeCoding = (_c = (_b = dosage.route) === null || _b === void 0 ? void 0 : _b.coding) === null || _c === void 0 ? void 0 : _c.find((code) => code.system === SNOMED_SYSTEM);
+    if (routeCoding === null || routeCoding === void 0 ? void 0 : routeCoding.code) {
+        routeCode = maps_1.ROUTE_BY_SNOMED[routeCoding.code];
+    }
+    if (routeCode || ((_d = dosage.route) === null || _d === void 0 ? void 0 : _d.text)) {
+        clause.route = {
+            code: routeCode,
+            text: (_f = (_e = dosage.route) === null || _e === void 0 ? void 0 : _e.text) !== null && _f !== void 0 ? _f : (routeCode ? maps_1.ROUTE_TEXT[routeCode] : undefined)
+        };
+    }
+    const siteCoding = selectPreferredSiteCoding(dosage.site);
+    if (((_g = dosage.site) === null || _g === void 0 ? void 0 : _g.text) || (siteCoding === null || siteCoding === void 0 ? void 0 : siteCoding.code)) {
+        clause.site = {
+            text: (_h = dosage.site) === null || _h === void 0 ? void 0 : _h.text,
+            coding: (siteCoding === null || siteCoding === void 0 ? void 0 : siteCoding.code)
+                ? {
+                    code: siteCoding.code,
+                    display: siteCoding.display,
+                    system: siteCoding.system
+                }
+                : undefined,
+            source: "text"
+        };
+    }
+    const methodCoding = selectFirstCodingWithCode(dosage.method);
+    if (((_j = dosage.method) === null || _j === void 0 ? void 0 : _j.text) || ((_k = dosage.method) === null || _k === void 0 ? void 0 : _k._text) || (methodCoding === null || methodCoding === void 0 ? void 0 : methodCoding.code)) {
+        clause.method = {
+            text: (_l = dosage.method) === null || _l === void 0 ? void 0 : _l.text,
+            _text: (0, fhir_translations_1.clonePrimitiveElement)((_m = dosage.method) === null || _m === void 0 ? void 0 : _m._text),
+            coding: (methodCoding === null || methodCoding === void 0 ? void 0 : methodCoding.code)
+                ? {
+                    code: methodCoding.code,
+                    display: methodCoding.display,
+                    system: methodCoding.system,
+                    _display: (0, fhir_translations_1.clonePrimitiveElement)(methodCoding._display)
+                }
+                : undefined
+        };
+    }
+    const repeat = (_o = dosage.timing) === null || _o === void 0 ? void 0 : _o.repeat;
+    const timingBounds = extractCanonicalTimingBounds(repeat);
+    if (((_s = (_r = (_q = (_p = dosage.timing) === null || _p === void 0 ? void 0 : _p.code) === null || _q === void 0 ? void 0 : _q.coding) === null || _r === void 0 ? void 0 : _r[0]) === null || _s === void 0 ? void 0 : _s.code) ||
+        (repeat === null || repeat === void 0 ? void 0 : repeat.count) !== undefined ||
+        (repeat === null || repeat === void 0 ? void 0 : repeat.boundsDuration) ||
+        (repeat === null || repeat === void 0 ? void 0 : repeat.boundsRange) ||
+        (repeat === null || repeat === void 0 ? void 0 : repeat.frequency) !== undefined ||
+        (repeat === null || repeat === void 0 ? void 0 : repeat.frequencyMax) !== undefined ||
+        (repeat === null || repeat === void 0 ? void 0 : repeat.period) !== undefined ||
+        (repeat === null || repeat === void 0 ? void 0 : repeat.periodMax) !== undefined ||
+        (repeat === null || repeat === void 0 ? void 0 : repeat.periodUnit) ||
+        ((_t = repeat === null || repeat === void 0 ? void 0 : repeat.dayOfWeek) === null || _t === void 0 ? void 0 : _t.length) ||
+        ((_u = repeat === null || repeat === void 0 ? void 0 : repeat.when) === null || _u === void 0 ? void 0 : _u.length) ||
+        ((_v = repeat === null || repeat === void 0 ? void 0 : repeat.timeOfDay) === null || _v === void 0 ? void 0 : _v.length)) {
+        clause.schedule = {
+            timingCode: (_z = (_y = (_x = (_w = dosage.timing) === null || _w === void 0 ? void 0 : _w.code) === null || _x === void 0 ? void 0 : _x.coding) === null || _y === void 0 ? void 0 : _y[0]) === null || _z === void 0 ? void 0 : _z.code,
+            count: repeat === null || repeat === void 0 ? void 0 : repeat.count,
+            duration: timingBounds.duration,
+            durationMax: timingBounds.durationMax,
+            durationUnit: timingBounds.durationUnit,
+            frequency: repeat === null || repeat === void 0 ? void 0 : repeat.frequency,
+            frequencyMax: repeat === null || repeat === void 0 ? void 0 : repeat.frequencyMax,
+            period: repeat === null || repeat === void 0 ? void 0 : repeat.period,
+            periodMax: repeat === null || repeat === void 0 ? void 0 : repeat.periodMax,
+            periodUnit: repeat === null || repeat === void 0 ? void 0 : repeat.periodUnit,
+            dayOfWeek: (repeat === null || repeat === void 0 ? void 0 : repeat.dayOfWeek) ? [...repeat.dayOfWeek] : undefined,
+            when: (repeat === null || repeat === void 0 ? void 0 : repeat.when) ? [...repeat.when] : undefined,
+            timeOfDay: (repeat === null || repeat === void 0 ? void 0 : repeat.timeOfDay) ? [...repeat.timeOfDay] : undefined
+        };
+        clause.warnings = appendWarning(clause.warnings, timingBounds.warning);
+    }
+    const doseAndRate = (_0 = dosage.doseAndRate) === null || _0 === void 0 ? void 0 : _0[0];
+    if (doseAndRate === null || doseAndRate === void 0 ? void 0 : doseAndRate.doseRange) {
+        const extracted = extractCanonicalDoseRange(doseAndRate.doseRange);
+        if (extracted.range) {
+            clause.dose = {
+                range: extracted.range,
+                unit: extracted.unit
+            };
+            clause.warnings = appendWarning(clause.warnings, extracted.warning);
+        }
+    }
+    else if (((_1 = doseAndRate === null || doseAndRate === void 0 ? void 0 : doseAndRate.doseQuantity) === null || _1 === void 0 ? void 0 : _1.value) !== undefined) {
+        clause.dose = {
+            value: doseAndRate.doseQuantity.value,
+            unit: doseAndRate.doseQuantity.unit
+        };
+    }
+    const prnReasons = ((_2 = dosage.asNeededFor) === null || _2 === void 0 ? void 0 : _2.length)
+        ? dosage.asNeededFor.map((concept) => {
+            var _a;
+            const coding = (_a = concept.coding) === null || _a === void 0 ? void 0 : _a.find((code) => Boolean(code.code));
+            return {
+                text: concept.text,
+                coding: (coding === null || coding === void 0 ? void 0 : coding.code)
+                    ? {
+                        code: coding.code,
+                        display: coding.display,
+                        system: coding.system
+                    }
+                    : undefined
+            };
+        })
+        : undefined;
+    const primaryReason = prnReasons === null || prnReasons === void 0 ? void 0 : prnReasons[0];
+    if (dosage.asNeededBoolean || (primaryReason === null || primaryReason === void 0 ? void 0 : primaryReason.text) || ((_3 = primaryReason === null || primaryReason === void 0 ? void 0 : primaryReason.coding) === null || _3 === void 0 ? void 0 : _3.code)) {
+        clause.prn = {
+            enabled: Boolean(dosage.asNeededBoolean || (primaryReason === null || primaryReason === void 0 ? void 0 : primaryReason.text) || ((_4 = primaryReason === null || primaryReason === void 0 ? void 0 : primaryReason.coding) === null || _4 === void 0 ? void 0 : _4.code)),
+            reason: (prnReasons === null || prnReasons === void 0 ? void 0 : prnReasons.length) === 1
+                ? primaryReason
+                : (prnReasons === null || prnReasons === void 0 ? void 0 : prnReasons.length)
+                    ? { text: (0, prn_1.joinCanonicalPrnReasonTexts)(prnReasons) }
+                    : undefined,
+            reasons: (prnReasons === null || prnReasons === void 0 ? void 0 : prnReasons.length) ? prnReasons : undefined
+        };
+    }
+    if ((_5 = dosage.additionalInstruction) === null || _5 === void 0 ? void 0 : _5.length) {
+        clause.additionalInstructions = [];
+        for (const instruction of dosage.additionalInstruction) {
+            const coding = (_6 = instruction.coding) === null || _6 === void 0 ? void 0 : _6.find((code) => Boolean(code.code));
+            clause.additionalInstructions.push({
+                text: instruction.text,
+                coding: (coding === null || coding === void 0 ? void 0 : coding.code)
+                    ? {
+                        code: coding.code,
+                        display: coding.display,
+                        system: coding.system
+                    }
+                    : undefined,
+                frames: (coding === null || coding === void 0 ? void 0 : coding.code)
+                    ? (0, advice_1.buildAdditionalInstructionFramesFromCoding)((_7 = coding.system) !== null && _7 !== void 0 ? _7 : SNOMED_SYSTEM, coding.code, (_9 = (_8 = instruction.text) !== null && _8 !== void 0 ? _8 : coding.display) !== null && _9 !== void 0 ? _9 : "", clause.raw)
+                    : undefined
+            });
+        }
+    }
+    if (dosage.patientInstruction) {
+        clause.patientInstruction = dosage.patientInstruction;
+    }
+    return clause;
+}
+function parserStateFromFhir(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, _8, _9, _10, _11, _12;
+    const state = new parser_state_1.ParserState((_a = dosage.text) !== null && _a !== void 0 ? _a : "", []);
+    const timingBounds = extractCanonicalTimingBounds((_b = dosage.timing) === null || _b === void 0 ? void 0 : _b.repeat);
+    state.timeOfDay = ((_d = (_c = dosage.timing) === null || _c === void 0 ? void 0 : _c.repeat) === null || _d === void 0 ? void 0 : _d.timeOfDay)
+        ? [...dosage.timing.repeat.timeOfDay]
+        : [];
+    state.timingCode = (_h = (_g = (_f = (_e = dosage.timing) === null || _e === void 0 ? void 0 : _e.code) === null || _f === void 0 ? void 0 : _f.coding) === null || _g === void 0 ? void 0 : _g[0]) === null || _h === void 0 ? void 0 : _h.code;
+    state.count = (_k = (_j = dosage.timing) === null || _j === void 0 ? void 0 : _j.repeat) === null || _k === void 0 ? void 0 : _k.count;
+    state.duration = timingBounds.duration;
+    state.durationMax = timingBounds.durationMax;
+    state.durationUnit = timingBounds.durationUnit;
+    state.frequency = (_m = (_l = dosage.timing) === null || _l === void 0 ? void 0 : _l.repeat) === null || _m === void 0 ? void 0 : _m.frequency;
+    state.frequencyMax = (_p = (_o = dosage.timing) === null || _o === void 0 ? void 0 : _o.repeat) === null || _p === void 0 ? void 0 : _p.frequencyMax;
+    state.period = (_r = (_q = dosage.timing) === null || _q === void 0 ? void 0 : _q.repeat) === null || _r === void 0 ? void 0 : _r.period;
+    state.periodMax = (_t = (_s = dosage.timing) === null || _s === void 0 ? void 0 : _s.repeat) === null || _t === void 0 ? void 0 : _t.periodMax;
+    state.periodUnit = (_v = (_u = dosage.timing) === null || _u === void 0 ? void 0 : _u.repeat) === null || _v === void 0 ? void 0 : _v.periodUnit;
+    state.routeText = (_w = dosage.route) === null || _w === void 0 ? void 0 : _w.text;
+    state.siteText = (_x = dosage.site) === null || _x === void 0 ? void 0 : _x.text;
+    state.methodText = (_y = dosage.method) === null || _y === void 0 ? void 0 : _y.text;
+    state.methodTextElement = (0, fhir_translations_1.clonePrimitiveElement)((_z = dosage.method) === null || _z === void 0 ? void 0 : _z._text);
+    state.patientInstruction = dosage.patientInstruction;
+    state.asNeeded = dosage.asNeededBoolean;
+    if ((_0 = dosage.asNeededFor) === null || _0 === void 0 ? void 0 : _0.length) {
+        const prnReasons = dosage.asNeededFor.map((concept) => {
+            const coding = selectFirstCodingWithCode(concept);
+            return {
+                text: concept.text,
+                coding: (coding === null || coding === void 0 ? void 0 : coding.code)
+                    ? {
+                        code: coding.code,
+                        display: coding.display,
+                        system: coding.system,
+                        _display: (0, fhir_translations_1.clonePrimitiveElement)(coding._display)
+                    }
+                    : undefined
+            };
+        });
+        state.asNeededReasons = prnReasons;
+        state.asNeededReason = (0, prn_1.joinCanonicalPrnReasonTexts)(prnReasons);
+    }
+    if ((_2 = (_1 = dosage.timing) === null || _1 === void 0 ? void 0 : _1.repeat) === null || _2 === void 0 ? void 0 : _2.dayOfWeek) {
+        state.dayOfWeek.push(...dosage.timing.repeat.dayOfWeek);
+    }
+    if ((_4 = (_3 = dosage.timing) === null || _3 === void 0 ? void 0 : _3.repeat) === null || _4 === void 0 ? void 0 : _4.when) {
+        const whenValues = dosage.timing.repeat.when.filter((value) => (0, array_1.arrayIncludes)((0, object_1.objectValues)(types_1.EventTiming), value));
+        state.when.push(...whenValues);
+    }
+    const routeCoding = (_6 = (_5 = dosage.route) === null || _5 === void 0 ? void 0 : _5.coding) === null || _6 === void 0 ? void 0 : _6.find((code) => code.system === SNOMED_SYSTEM);
     if (routeCoding === null || routeCoding === void 0 ? void 0 : routeCoding.code) {
         // Translate SNOMED codings back into the simplified enum for round-trip fidelity.
         const mapped = maps_1.ROUTE_BY_SNOMED[routeCoding.code];
         if (mapped) {
-            internal.routeCode = mapped;
-            internal.routeText = maps_1.ROUTE_TEXT[mapped];
+            state.routeCode = mapped;
+            state.routeText = maps_1.ROUTE_TEXT[mapped];
         }
     }
-    const siteCoding = (_6 = (_5 = dosage.site) === null || _5 === void 0 ? void 0 : _5.coding) === null || _6 === void 0 ? void 0 : _6.find((code) => code.system === SNOMED_SYSTEM);
+    const siteCoding = selectPreferredSiteCoding(dosage.site);
     if (siteCoding === null || siteCoding === void 0 ? void 0 : siteCoding.code) {
-        internal.siteCoding = {
+        state.siteCoding = {
             code: siteCoding.code,
             display: siteCoding.display,
             system: siteCoding.system
         };
+        state.siteSource = "text";
+    }
+    else if ((_7 = dosage.site) === null || _7 === void 0 ? void 0 : _7.text) {
+        state.siteSource = "text";
     }
-    const reasonCoding = (_9 = (_8 = (_7 = dosage.asNeededFor) === null || _7 === void 0 ? void 0 : _7[0]) === null || _8 === void 0 ? void 0 : _8.coding) === null || _9 === void 0 ? void 0 : _9[0];
-    if (reasonCoding === null || reasonCoding === void 0 ? void 0 : reasonCoding.code) {
-        const defaultDef = (0, maps_1.findPrnReasonDefinitionByCoding)((_10 = reasonCoding.system) !== null && _10 !== void 0 ? _10 : SNOMED_SYSTEM, reasonCoding.code);
-        internal.asNeededReasonCoding = {
-            code: reasonCoding.code,
-            display: reasonCoding.display,
-            system: reasonCoding.system,
-            i18n: defaultDef === null || defaultDef === void 0 ? void 0 : defaultDef.i18n
+    const methodCoding = selectFirstCodingWithCode(dosage.method);
+    if (methodCoding === null || methodCoding === void 0 ? void 0 : methodCoding.code) {
+        state.methodCoding = {
+            code: methodCoding.code,
+            display: methodCoding.display,
+            system: methodCoding.system,
+            _display: (0, fhir_translations_1.clonePrimitiveElement)(methodCoding._display)
         };
     }
-    if ((_11 = dosage.additionalInstruction) === null || _11 === void 0 ? void 0 : _11.length) {
-        internal.additionalInstructions = dosage.additionalInstruction.map((concept) => {
-            var _a, _b;
-            const coding = (_a = concept.coding) === null || _a === void 0 ? void 0 : _a[0];
+    if (((_8 = dosage.asNeededFor) === null || _8 === void 0 ? void 0 : _8.length) === 1) {
+        const reasonCoding = selectFirstCodingWithCode(dosage.asNeededFor[0]);
+        if (reasonCoding === null || reasonCoding === void 0 ? void 0 : reasonCoding.code) {
+            const defaultDef = (0, maps_1.findPrnReasonDefinitionByCoding)((_9 = reasonCoding.system) !== null && _9 !== void 0 ? _9 : SNOMED_SYSTEM, reasonCoding.code);
+            state.asNeededReasonCoding = {
+                code: reasonCoding.code,
+                display: reasonCoding.display,
+                system: reasonCoding.system,
+                i18n: defaultDef === null || defaultDef === void 0 ? void 0 : defaultDef.i18n
+            };
+        }
+    }
+    if ((_10 = dosage.additionalInstruction) === null || _10 === void 0 ? void 0 : _10.length) {
+        state.additionalInstructions = dosage.additionalInstruction.map((concept) => {
+            var _a, _b, _c, _d, _e, _f;
+            const coding = selectFirstCodingWithCode(concept);
             const defaultDef = (coding === null || coding === void 0 ? void 0 : coding.code)
-                ? (0, maps_1.findAdditionalInstructionDefinitionByCoding)((_b = coding.system) !== null && _b !== void 0 ? _b : SNOMED_SYSTEM, coding.code)
+                ? (0, advice_1.findAdditionalInstructionDefinitionByCoding)((_a = coding.system) !== null && _a !== void 0 ? _a : SNOMED_SYSTEM, coding.code)
                 : undefined;
             return {
                 text: concept.text,
@@ -236,26 +656,38 @@ function internalFromFhir(dosage) {
                         system: coding.system,
                         i18n: defaultDef === null || defaultDef === void 0 ? void 0 : defaultDef.i18n
                     }
+                    : undefined,
+                frames: (coding === null || coding === void 0 ? void 0 : coding.code)
+                    ? (0, advice_1.buildAdditionalInstructionFramesFromCoding)((_b = coding.system) !== null && _b !== void 0 ? _b : SNOMED_SYSTEM, coding.code, (_d = (_c = concept.text) !== null && _c !== void 0 ? _c : coding.display) !== null && _d !== void 0 ? _d : "", { start: 0, end: ((_f = (_e = concept.text) !== null && _e !== void 0 ? _e : coding.display) !== null && _f !== void 0 ? _f : "").length })
                     : undefined
             };
         });
     }
-    const doseAndRate = (_12 = dosage.doseAndRate) === null || _12 === void 0 ? void 0 : _12[0];
+    if (timingBounds.warning) {
+        const nextWarnings = appendWarning(state.warnings, timingBounds.warning);
+        if (nextWarnings) {
+            state.warnings = nextWarnings;
+        }
+    }
+    const doseAndRate = (_11 = dosage.doseAndRate) === null || _11 === void 0 ? void 0 : _11[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 };
+        const extracted = extractCanonicalDoseRange(doseAndRate.doseRange);
+        if (extracted.range) {
+            state.primaryClause.dose = {
+                range: extracted.range,
+                unit: extracted.unit
+            };
+            state.warnings = (_12 = appendWarning(state.warnings, extracted.warning)) !== null && _12 !== void 0 ? _12 : state.warnings;
         }
-        internal.unit = (_14 = (_13 = low === null || low === void 0 ? void 0 : low.unit) !== null && _13 !== void 0 ? _13 : high === null || high === void 0 ? void 0 : high.unit) !== null && _14 !== void 0 ? _14 : internal.unit;
     }
     else if (doseAndRate === null || doseAndRate === void 0 ? void 0 : doseAndRate.doseQuantity) {
         const dose = doseAndRate.doseQuantity;
         if (dose.value !== undefined) {
-            internal.dose = dose.value;
+            state.dose = dose.value;
         }
         if (dose.unit) {
-            internal.unit = dose.unit;
+            state.unit = dose.unit;
         }
     }
-    return internal;
+    return state;
 }