ezmedicationinput 0.1.44 → 0.1.45

package/dist/schedule.js

@@ -1,1636 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.nextDueDoses = nextDueDoses;
-exports.calculateTotalUnits = calculateTotalUnits;
-const types_1 = require("./types");
-const advice_1 = require("./advice");
-const array_1 = require("./utils/array");
-const units_1 = require("./utils/units");
-const strength_1 = require("./utils/strength");
-/**
- * Default institution times used when a dosage only specifies frequency without
- * explicit EventTiming anchors. Clinics can override these through the
- * configuration bag when desired.
- */
-const DEFAULT_FREQUENCY_DEFAULTS = {
-    byCode: {
-        BID: ["08:00", "20:00"],
-        TID: ["08:00", "14:00", "20:00"],
-        QID: ["08:00", "12:00", "16:00", "20:00"],
-        QD: ["09:00"],
-        QOD: ["09:00"],
-        AM: ["08:00"],
-        PM: ["20:00"]
-    },
-    byFrequency: {
-        "freq:1/d": ["09:00"],
-        "freq:2/d": ["08:00", "20:00"],
-        "freq:3/d": ["08:00", "14:00", "20:00"],
-        "freq:4/d": ["08:00", "12:00", "16:00", "20:00"]
-    }
-};
-const SECONDS_PER_MINUTE = 60;
-const MINUTES_PER_DAY = 24 * 60;
-/** Caches expensive Intl.DateTimeFormat objects per time zone. */
-const dateTimeFormatCache = new Map();
-/** Separate cache for weekday formatting to avoid rebuilding formatters. */
-const weekdayFormatCache = new Map();
-/** Simple zero-padding helper for numeric components. */
-function pad(value, length = 2) {
-    const absolute = Math.abs(value);
-    let output = absolute.toString();
-    while (output.length < length) {
-        output = `0${output}`;
-    }
-    return value < 0 ? `-${output}` : output;
-}
-function formatToParts(formatter, date) {
-    const withParts = formatter;
-    if (typeof withParts.formatToParts === "function") {
-        return withParts.formatToParts(date);
-    }
-    const iso = date.toISOString();
-    return [
-        { type: "year", value: iso.slice(0, 4) },
-        { type: "month", value: iso.slice(5, 7) },
-        { type: "day", value: iso.slice(8, 10) },
-        { type: "hour", value: iso.slice(11, 13) },
-        { type: "minute", value: iso.slice(14, 16) },
-        { type: "second", value: iso.slice(17, 19) }
-    ];
-}
-/**
- * Normalizes HH:mm or HH:mm:ss clocks into a consistent HH:mm:ss string.
- */
-function normalizeClock(clock) {
-    var _a;
-    const parts = clock.split(":");
-    if (parts.length < 2 || parts.length > 3) {
-        throw new Error(`Invalid clock value: ${clock}`);
-    }
-    const [hourPart, minutePart, secondPart] = [
-        parts[0],
-        parts[1],
-        (_a = parts[2]) !== null && _a !== void 0 ? _a : "00"
-    ];
-    const hour = Number(hourPart);
-    const minute = Number(minutePart);
-    const second = Number(secondPart);
-    if (Number.isNaN(hour) ||
-        Number.isNaN(minute) ||
-        Number.isNaN(second) ||
-        hour < 0 ||
-        hour > 23 ||
-        minute < 0 ||
-        minute > 59 ||
-        second < 0 ||
-        second > 59) {
-        throw new Error(`Invalid clock value: ${clock}`);
-    }
-    return `${pad(hour)}:${pad(minute)}:${pad(second)}`;
-}
-/** Retrieves (and caches) an Intl formatter for calendar components. */
-function getDateTimeFormat(timeZone) {
-    let formatter = dateTimeFormatCache.get(timeZone);
-    if (!formatter) {
-        const options = {
-            timeZone,
-            calendar: "iso8601",
-            numberingSystem: "latn",
-            hour12: false,
-            year: "numeric",
-            month: "2-digit",
-            day: "2-digit",
-            hour: "2-digit",
-            minute: "2-digit",
-            second: "2-digit"
-        };
-        formatter = new Intl.DateTimeFormat("en-CA", options);
-        dateTimeFormatCache.set(timeZone, formatter);
-    }
-    return formatter;
-}
-/** Retrieves (and caches) a formatter for weekday lookups. */
-function getWeekdayFormat(timeZone) {
-    let formatter = weekdayFormatCache.get(timeZone);
-    if (!formatter) {
-        formatter = new Intl.DateTimeFormat("en-CA", {
-            timeZone,
-            weekday: "short"
-        });
-        weekdayFormatCache.set(timeZone, formatter);
-    }
-    return formatter;
-}
-/**
- * Extracts calendar components for a Date interpreted within the supplied time
- * zone.
- */
-function getTimeParts(date, timeZone) {
-    var _a, _b;
-    const formatter = getDateTimeFormat(timeZone);
-    const parts = {};
-    const rawParts = formatToParts(formatter, date);
-    for (const part of rawParts) {
-        if (part.type === "literal") {
-            continue;
-        }
-        if (part.type === "year") {
-            parts.year = Number(part.value);
-        }
-        else if (part.type === "month") {
-            parts.month = Number(part.value);
-        }
-        else if (part.type === "day") {
-            parts.day = Number(part.value);
-        }
-        else if (part.type === "hour") {
-            parts.hour = Number(part.value);
-        }
-        else if (part.type === "minute") {
-            parts.minute = Number(part.value);
-        }
-        else if (part.type === "second") {
-            parts.second = Number(part.value);
-        }
-    }
-    if (parts.hour === 24) {
-        // Some locales express midnight as 24:00 of the previous day. Nudge the
-        // instant forward slightly so we can capture the correct calendar date and
-        // reset the hour component back to zero.
-        const forward = new Date(date.getTime() + 60 * 1000);
-        const forwardParts = formatToParts(formatter, forward);
-        for (const part of forwardParts) {
-            if (part.type === "literal") {
-                continue;
-            }
-            if (part.type === "year") {
-                parts.year = Number(part.value);
-            }
-            else if (part.type === "month") {
-                parts.month = Number(part.value);
-            }
-            else if (part.type === "day") {
-                parts.day = Number(part.value);
-            }
-        }
-        parts.hour = 0;
-        parts.minute = (_a = parts.minute) !== null && _a !== void 0 ? _a : 0;
-        parts.second = (_b = parts.second) !== null && _b !== void 0 ? _b : 0;
-    }
-    if (parts.year === undefined ||
-        parts.month === undefined ||
-        parts.day === undefined ||
-        parts.hour === undefined ||
-        parts.minute === undefined ||
-        parts.second === undefined) {
-        throw new Error("Unable to resolve time parts for provided date");
-    }
-    return parts;
-}
-/** Calculates the time-zone offset in minutes for a given instant. */
-function getOffset(date, timeZone) {
-    const { year, month, day, hour, minute, second } = getTimeParts(date, timeZone);
-    const zonedTime = Date.UTC(year, month - 1, day, hour, minute, second);
-    return (zonedTime - date.getTime()) / (SECONDS_PER_MINUTE * 1000);
-}
-/**
- * Renders an ISO-8601 string that reflects the provided time zone instead of
- * defaulting to UTC.
- */
-function formatZonedIso(date, timeZone) {
-    const { year, month, day, hour, minute, second } = getTimeParts(date, timeZone);
-    const offsetMinutes = getOffset(date, timeZone);
-    const offsetSign = offsetMinutes >= 0 ? "+" : "-";
-    const absoluteOffset = Math.abs(offsetMinutes);
-    const offsetHours = Math.floor(absoluteOffset / SECONDS_PER_MINUTE);
-    const offsetRemainder = absoluteOffset % SECONDS_PER_MINUTE;
-    return `${pad(year, 4)}-${pad(month)}-${pad(day)}T${pad(hour)}:${pad(minute)}:${pad(second)}${offsetSign}${pad(offsetHours)}:${pad(offsetRemainder)}`;
-}
-/**
- * Builds a Date representing a local wall-clock time in the target time zone.
- */
-function makeZonedDate(timeZone, year, month, day, hour, minute, second) {
-    const initialUtc = Date.UTC(year, month - 1, day, hour, minute, second);
-    let candidate = new Date(initialUtc);
-    let offset = getOffset(candidate, timeZone);
-    candidate = new Date(initialUtc - offset * SECONDS_PER_MINUTE * 1000);
-    const recalculatedOffset = getOffset(candidate, timeZone);
-    if (recalculatedOffset !== offset) {
-        candidate = new Date(initialUtc - recalculatedOffset * SECONDS_PER_MINUTE * 1000);
-    }
-    const parts = getTimeParts(candidate, timeZone);
-    if (parts.year !== year ||
-        parts.month !== month ||
-        parts.day !== day ||
-        parts.hour !== hour ||
-        parts.minute !== minute ||
-        parts.second !== second) {
-        return null;
-    }
-    return candidate;
-}
-/** Convenience wrapper around makeZonedDate for day-level math. */
-function makeZonedDateFromDay(base, timeZone, clock) {
-    var _a, _b, _c;
-    const { year, month, day } = getTimeParts(base, timeZone);
-    const parts = clock.split(":").map((value) => Number(value));
-    const hour = (_a = parts[0]) !== null && _a !== void 0 ? _a : 0;
-    const minute = (_b = parts[1]) !== null && _b !== void 0 ? _b : 0;
-    const second = (_c = parts[2]) !== null && _c !== void 0 ? _c : 0;
-    return makeZonedDate(timeZone, year, month, day, hour, minute, second);
-}
-/** Returns a Date pinned to the start of the local day. */
-function startOfLocalDay(date, timeZone) {
-    const { year, month, day } = getTimeParts(date, timeZone);
-    const zoned = makeZonedDate(timeZone, year, month, day, 0, 0, 0);
-    if (!zoned) {
-        throw new Error("Unable to resolve start of day for provided date");
-    }
-    return zoned;
-}
-/** Adds a number of calendar days while remaining aligned to the time zone. */
-function addLocalDays(date, days, timeZone) {
-    const { year, month, day } = getTimeParts(date, timeZone);
-    const rollover = new Date(Date.UTC(year, month - 1, day + days));
-    const zoned = makeZonedDate(timeZone, rollover.getUTCFullYear(), rollover.getUTCMonth() + 1, rollover.getUTCDate(), 0, 0, 0);
-    if (!zoned) {
-        throw new Error("Unable to shift local day – invalid calendar combination");
-    }
-    return zoned;
-}
-/** Computes the local weekday token (mon..sun). */
-function getLocalWeekday(date, timeZone) {
-    const formatted = getWeekdayFormat(timeZone).format(date);
-    switch (formatted.toLowerCase()) {
-        case "mon":
-            return "mon";
-        case "tue":
-            return "tue";
-        case "wed":
-            return "wed";
-        case "thu":
-            return "thu";
-        case "fri":
-            return "fri";
-        case "sat":
-            return "sat";
-        case "sun":
-            return "sun";
-        default:
-            throw new Error(`Unexpected weekday token: ${formatted}`);
-    }
-}
-function getLocalDayNumber(date, timeZone) {
-    const { year, month, day } = getTimeParts(date, timeZone);
-    return Math.floor(Date.UTC(year, month - 1, day) / (24 * 60 * 60 * 1000));
-}
-function getLocalMonthIndex(date, timeZone) {
-    const { year, month } = getTimeParts(date, timeZone);
-    return year * 12 + (month - 1);
-}
-function isDateAlignedToPeriodCycle(candidateDay, anchorDay, repeat, timeZone) {
-    const period = repeat.period;
-    const periodUnit = repeat.periodUnit;
-    if (!period || period <= 0 || !periodUnit) {
-        return true;
-    }
-    if (periodUnit === "d") {
-        const deltaDays = getLocalDayNumber(candidateDay, timeZone) - getLocalDayNumber(anchorDay, timeZone);
-        return deltaDays >= 0 && deltaDays % period === 0;
-    }
-    if (periodUnit === "wk") {
-        const deltaDays = getLocalDayNumber(candidateDay, timeZone) - getLocalDayNumber(anchorDay, timeZone);
-        if (deltaDays < 0) {
-            return false;
-        }
-        const deltaWeeks = Math.floor(deltaDays / 7);
-        return deltaWeeks % period === 0;
-    }
-    if (periodUnit === "mo") {
-        const deltaMonths = getLocalMonthIndex(candidateDay, timeZone) - getLocalMonthIndex(anchorDay, timeZone);
-        return deltaMonths >= 0 && deltaMonths % period === 0;
-    }
-    if (periodUnit === "a") {
-        const candidateYear = getTimeParts(candidateDay, timeZone).year;
-        const anchorYear = getTimeParts(anchorDay, timeZone).year;
-        const deltaYears = candidateYear - anchorYear;
-        return deltaYears >= 0 && deltaYears % period === 0;
-    }
-    return true;
-}
-/** Parses arbitrary string/Date inputs into a valid Date instance. */
-function coerceDate(value, label) {
-    const date = value instanceof Date ? value : new Date(value);
-    if (Number.isNaN(date.getTime())) {
-        throw new Error(`Invalid ${label} supplied to nextDueDoses`);
-    }
-    return date;
-}
-/**
- * Applies a minute offset to a normalized HH:mm:ss clock, tracking any day
- * rollover that might occur.
- */
-function applyOffset(clock, offsetMinutes) {
-    const [hour, minute, second] = clock.split(":").map((part) => Number(part));
-    let totalMinutes = hour * SECONDS_PER_MINUTE + minute + offsetMinutes;
-    let dayShift = 0;
-    while (totalMinutes < 0) {
-        totalMinutes += MINUTES_PER_DAY;
-        dayShift -= 1;
-    }
-    while (totalMinutes >= MINUTES_PER_DAY) {
-        totalMinutes -= MINUTES_PER_DAY;
-        dayShift += 1;
-    }
-    const adjustedHour = Math.floor(totalMinutes / SECONDS_PER_MINUTE);
-    const adjustedMinute = totalMinutes % SECONDS_PER_MINUTE;
-    return {
-        time: `${pad(adjustedHour)}:${pad(adjustedMinute)}:${pad(second)}`,
-        dayShift
-    };
-}
-function parseBoundsDurationUnit(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 resolveRepeatBoundsDuration(repeat) {
-    var _a, _b, _c, _d;
-    if (!repeat) {
-        return {};
-    }
-    if (((_a = repeat.boundsDuration) === null || _a === void 0 ? void 0 : _a.value) !== undefined) {
-        return {
-            value: repeat.boundsDuration.value,
-            unit: parseBoundsDurationUnit(repeat.boundsDuration)
-        };
-    }
-    if (!repeat.boundsRange) {
-        return {};
-    }
-    return {
-        value: (_b = repeat.boundsRange.low) === null || _b === void 0 ? void 0 : _b.value,
-        max: (_c = repeat.boundsRange.high) === null || _c === void 0 ? void 0 : _c.value,
-        unit: (_d = parseBoundsDurationUnit(repeat.boundsRange.low)) !== null && _d !== void 0 ? _d : parseBoundsDurationUnit(repeat.boundsRange.high)
-    };
-}
-function resolveRepeatDurationCapEnd(repeat, anchor, timeZone) {
-    var _a, _b;
-    const bounds = resolveRepeatBoundsDuration(repeat);
-    const durationValue = (_a = bounds.max) !== null && _a !== void 0 ? _a : bounds.value;
-    const durationUnit = bounds.unit;
-    if (durationValue === undefined ||
-        !Number.isFinite(durationValue) ||
-        durationValue <= 0 ||
-        !durationUnit) {
-        return null;
-    }
-    const stepper = createIntervalStepper({ period: durationValue, periodUnit: durationUnit }, timeZone);
-    if (!stepper) {
-        return null;
-    }
-    return (_b = stepper(anchor)) !== null && _b !== void 0 ? _b : null;
-}
-function resolveDayFilteredSeriesRepeat(repeat, enforceDayFilter) {
-    var _a, _b, _c, _d;
-    if (!enforceDayFilter) {
-        return undefined;
-    }
-    if (repeat.frequency) {
-        return undefined;
-    }
-    if (((_b = (_a = repeat.when) === null || _a === void 0 ? void 0 : _a.length) !== null && _b !== void 0 ? _b : 0) > 0 || ((_d = (_c = repeat.timeOfDay) === null || _c === void 0 ? void 0 : _c.length) !== null && _d !== void 0 ? _d : 0) > 0) {
-        return undefined;
-    }
-    switch (repeat.periodUnit) {
-        case types_1.FhirPeriodUnit.Week:
-        case types_1.FhirPeriodUnit.Month:
-        case types_1.FhirPeriodUnit.Year:
-            return repeat.period ? repeat : undefined;
-        case undefined:
-            return repeat.period === undefined
-                ? Object.assign(Object.assign({}, repeat), { period: 1, periodUnit: types_1.FhirPeriodUnit.Week }) : undefined;
-        default:
-            return undefined;
-    }
-}
-function isSingleAdministrationRepeat(repeat) {
-    var _a, _b, _c, _d, _e, _f;
-    return (repeat.count === 1 &&
-        repeat.frequency === undefined &&
-        repeat.frequencyMax === undefined &&
-        repeat.period === undefined &&
-        repeat.periodMax === undefined &&
-        repeat.periodUnit === undefined &&
-        ((_b = (_a = repeat.dayOfWeek) === null || _a === void 0 ? void 0 : _a.length) !== null && _b !== void 0 ? _b : 0) === 0 &&
-        ((_d = (_c = repeat.when) === null || _c === void 0 ? void 0 : _c.length) !== null && _d !== void 0 ? _d : 0) === 0 &&
-        ((_f = (_e = repeat.timeOfDay) === null || _e === void 0 ? void 0 : _e.length) !== null && _f !== void 0 ? _f : 0) === 0);
-}
-function hasUnresolvedRelationalInstruction(dosage) {
-    var _a, _b, _c, _d, _e, _f;
-    const texts = [];
-    if ((_a = dosage.patientInstruction) === null || _a === void 0 ? void 0 : _a.trim()) {
-        texts.push(dosage.patientInstruction.trim());
-    }
-    for (const instruction of (_b = dosage.additionalInstruction) !== null && _b !== void 0 ? _b : []) {
-        const text = ((_c = instruction.text) === null || _c === void 0 ? void 0 : _c.trim()) || ((_f = (_e = (_d = instruction.coding) === null || _d === void 0 ? void 0 : _d.find((coding) => { var _a; return (_a = coding.display) === null || _a === void 0 ? void 0 : _a.trim(); })) === null || _e === void 0 ? void 0 : _e.display) === null || _f === void 0 ? void 0 : _f.trim());
-        if (text) {
-            texts.push(text);
-        }
-    }
-    for (const text of texts) {
-        const parsed = (0, advice_1.parseAdditionalInstructions)(text, { start: 0, end: text.length }, { defaultPredicate: "take" });
-        for (const instruction of parsed) {
-            for (const frame of instruction.frames) {
-                if (frame.relation) {
-                    return true;
-                }
-            }
-        }
-    }
-    return false;
-}
-function minDate(left, right) {
-    if (!right) {
-        return left;
-    }
-    return right.getTime() < left.getTime() ? right : left;
-}
-/** Provides the default meal pairing used for AC/PC expansions. */
-function getDefaultMealPairs(config) {
-    return [types_1.EventTiming.Breakfast, types_1.EventTiming.Lunch, types_1.EventTiming.Dinner];
-}
-const SPECIFIC_BEFORE_MEALS = {
-    [types_1.EventTiming["Before Breakfast"]]: types_1.EventTiming.Breakfast,
-    [types_1.EventTiming["Before Lunch"]]: types_1.EventTiming.Lunch,
-    [types_1.EventTiming["Before Dinner"]]: types_1.EventTiming.Dinner
-};
-const SPECIFIC_AFTER_MEALS = {
-    [types_1.EventTiming["After Breakfast"]]: types_1.EventTiming.Breakfast,
-    [types_1.EventTiming["After Lunch"]]: types_1.EventTiming.Lunch,
-    [types_1.EventTiming["After Dinner"]]: types_1.EventTiming.Dinner
-};
-/**
- * Expands a single EventTiming code into concrete wall-clock entries.
- */
-function expandTiming(code, config, repeat) {
-    var _a, _b, _c, _d, _e, _f, _g, _h;
-    const mealOffsets = (_a = config.mealOffsets) !== null && _a !== void 0 ? _a : {};
-    const eventClock = (_b = config.eventClock) !== null && _b !== void 0 ? _b : {};
-    const normalized = [];
-    const clockValue = eventClock[code];
-    if (clockValue) {
-        normalized.push({ time: normalizeClock(clockValue), dayShift: 0 });
-    }
-    else if (code === types_1.EventTiming["Before Meal"]) {
-        for (const meal of getDefaultMealPairs(config)) {
-            const base = eventClock[meal];
-            if (!base) {
-                continue;
-            }
-            normalized.push(applyOffset(normalizeClock(base), (_c = mealOffsets[code]) !== null && _c !== void 0 ? _c : 0));
-        }
-    }
-    else if (code === types_1.EventTiming["After Meal"]) {
-        for (const meal of getDefaultMealPairs(config)) {
-            const base = eventClock[meal];
-            if (!base) {
-                continue;
-            }
-            normalized.push(applyOffset(normalizeClock(base), (_d = mealOffsets[code]) !== null && _d !== void 0 ? _d : 0));
-        }
-    }
-    else if (code === types_1.EventTiming.Meal) {
-        for (const meal of getDefaultMealPairs(config)) {
-            const base = eventClock[meal];
-            if (!base) {
-                continue;
-            }
-            normalized.push({ time: normalizeClock(base), dayShift: 0 });
-        }
-    }
-    else if (code in SPECIFIC_BEFORE_MEALS) {
-        const mealCode = SPECIFIC_BEFORE_MEALS[code];
-        const base = eventClock[mealCode];
-        if (base) {
-            const baseClock = normalizeClock(base);
-            const offset = (_f = (_e = mealOffsets[code]) !== null && _e !== void 0 ? _e : mealOffsets[types_1.EventTiming["Before Meal"]]) !== null && _f !== void 0 ? _f : 0;
-            normalized.push(offset ? applyOffset(baseClock, offset) : { time: baseClock, dayShift: 0 });
-        }
-    }
-    else if (code in SPECIFIC_AFTER_MEALS) {
-        const mealCode = SPECIFIC_AFTER_MEALS[code];
-        const base = eventClock[mealCode];
-        if (base) {
-            const baseClock = normalizeClock(base);
-            const offset = (_h = (_g = mealOffsets[code]) !== null && _g !== void 0 ? _g : mealOffsets[types_1.EventTiming["After Meal"]]) !== null && _h !== void 0 ? _h : 0;
-            normalized.push(offset ? applyOffset(baseClock, offset) : { time: baseClock, dayShift: 0 });
-        }
-    }
-    if (repeat.offset && normalized.length) {
-        return normalized.map((entry) => {
-            var _a;
-            const adjusted = applyOffset(entry.time, (_a = repeat.offset) !== null && _a !== void 0 ? _a : 0);
-            return {
-                time: adjusted.time,
-                dayShift: entry.dayShift + adjusted.dayShift
-            };
-        });
-    }
-    return normalized;
-}
-/** Consolidates EventTiming arrays into a deduplicated/sorted clock list. */
-function expandWhenCodes(whenCodes, config, repeat) {
-    const entries = [];
-    const seen = new Set();
-    for (const code of whenCodes) {
-        if (code === types_1.EventTiming.Immediate) {
-            continue;
-        }
-        const expansions = expandTiming(code, config, repeat);
-        for (const expansion of expansions) {
-            const key = `${expansion.dayShift}|${expansion.time}`;
-            if (seen.has(key)) {
-                continue;
-            }
-            seen.add(key);
-            entries.push(expansion);
-        }
-    }
-    return entries.sort((a, b) => {
-        if (a.dayShift !== b.dayShift) {
-            return a.dayShift - b.dayShift;
-        }
-        return a.time.localeCompare(b.time);
-    });
-}
-const DEFAULT_WHEN_FALLBACK_CLOCKS = {
-    [types_1.EventTiming.Wake]: ["06:00:00"],
-    [types_1.EventTiming["Early Morning"]]: ["06:00:00"],
-    [types_1.EventTiming.Morning]: ["08:00:00"],
-    [types_1.EventTiming["Late Morning"]]: ["10:00:00"],
-    [types_1.EventTiming.Breakfast]: ["08:00:00"],
-    [types_1.EventTiming["Before Breakfast"]]: ["07:30:00"],
-    [types_1.EventTiming["After Breakfast"]]: ["08:30:00"],
-    [types_1.EventTiming.Noon]: ["12:00:00"],
-    [types_1.EventTiming.Lunch]: ["12:30:00"],
-    [types_1.EventTiming["Before Lunch"]]: ["12:00:00"],
-    [types_1.EventTiming["After Lunch"]]: ["13:00:00"],
-    [types_1.EventTiming["Early Afternoon"]]: ["14:00:00"],
-    [types_1.EventTiming.Afternoon]: ["15:00:00"],
-    [types_1.EventTiming["Late Afternoon"]]: ["16:00:00"],
-    [types_1.EventTiming["Early Evening"]]: ["18:00:00"],
-    [types_1.EventTiming.Evening]: ["19:00:00"],
-    [types_1.EventTiming["Late Evening"]]: ["20:00:00"],
-    [types_1.EventTiming.Dinner]: ["18:30:00"],
-    [types_1.EventTiming["Before Dinner"]]: ["18:00:00"],
-    [types_1.EventTiming["After Dinner"]]: ["19:00:00"],
-    [types_1.EventTiming.Night]: ["21:00:00"],
-    [types_1.EventTiming["Before Sleep"]]: ["22:00:00"],
-    [types_1.EventTiming["After Sleep"]]: ["06:30:00"],
-    [types_1.EventTiming.Meal]: ["08:00:00", "12:30:00", "18:30:00"],
-    [types_1.EventTiming["Before Meal"]]: ["07:30:00", "12:00:00", "18:00:00"],
-    [types_1.EventTiming["After Meal"]]: ["08:30:00", "13:00:00", "19:00:00"]
-};
-function inferWhenFallbackEntries(whenCodes, repeat) {
-    const entries = [];
-    const seen = new Set();
-    const addClock = (clock) => {
-        var _a;
-        const normalized = normalizeClock(clock);
-        const adjusted = repeat.offset
-            ? applyOffset(normalized, (_a = repeat.offset) !== null && _a !== void 0 ? _a : 0)
-            : { time: normalized, dayShift: 0 };
-        const key = `${adjusted.dayShift}|${adjusted.time}`;
-        if (seen.has(key)) {
-            return;
-        }
-        seen.add(key);
-        entries.push(adjusted);
-    };
-    for (const code of whenCodes) {
-        if (code === types_1.EventTiming.Immediate) {
-            continue;
-        }
-        const fallbackClocks = DEFAULT_WHEN_FALLBACK_CLOCKS[code];
-        if (!fallbackClocks) {
-            continue;
-        }
-        for (const clock of fallbackClocks) {
-            addClock(clock);
-        }
-    }
-    return entries.sort((a, b) => {
-        if (a.dayShift !== b.dayShift) {
-            return a.dayShift - b.dayShift;
-        }
-        return a.time.localeCompare(b.time);
-    });
-}
-function mergeFrequencyDefaults(base, override) {
-    var _a, _b, _c, _d;
-    if (!base && !override) {
-        return undefined;
-    }
-    const merged = {};
-    if ((base === null || base === void 0 ? void 0 : base.byCode) || (override === null || override === void 0 ? void 0 : override.byCode)) {
-        merged.byCode = Object.assign(Object.assign({}, ((_a = base === null || base === void 0 ? void 0 : base.byCode) !== null && _a !== void 0 ? _a : {})), ((_b = override === null || override === void 0 ? void 0 : override.byCode) !== null && _b !== void 0 ? _b : {}));
-    }
-    if ((base === null || base === void 0 ? void 0 : base.byFrequency) || (override === null || override === void 0 ? void 0 : override.byFrequency)) {
-        merged.byFrequency = Object.assign(Object.assign({}, ((_c = base === null || base === void 0 ? void 0 : base.byFrequency) !== null && _c !== void 0 ? _c : {})), ((_d = override === null || override === void 0 ? void 0 : override.byFrequency) !== null && _d !== void 0 ? _d : {}));
-    }
-    return merged;
-}
-function inferDailyFrequencyClocks(frequency) {
-    if (!Number.isFinite(frequency) || frequency <= 0) {
-        return [];
-    }
-    if (frequency === 1) {
-        return ["09:00:00"];
-    }
-    const startMinutes = 8 * 60;
-    const endMinutes = 20 * 60;
-    const spanMinutes = endMinutes - startMinutes;
-    const clocks = new Set();
-    for (let index = 0; index < frequency; index += 1) {
-        const minutes = startMinutes + Math.round((spanMinutes * index) / (frequency - 1));
-        const hour = Math.floor(minutes / SECONDS_PER_MINUTE);
-        const minute = minutes % SECONDS_PER_MINUTE;
-        clocks.add(`${pad(hour)}:${pad(minute)}:00`);
-    }
-    return Array.from(clocks).sort();
-}
-/** Resolves fallback clock arrays for frequency-only schedules. */
-function resolveFrequencyClocks(timing, config) {
-    var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
-    const defaults = {
-        byCode: Object.assign(Object.assign({}, DEFAULT_FREQUENCY_DEFAULTS.byCode), ((_b = (_a = config.frequencyDefaults) === null || _a === void 0 ? void 0 : _a.byCode) !== null && _b !== void 0 ? _b : {})),
-        byFrequency: Object.assign(Object.assign({}, DEFAULT_FREQUENCY_DEFAULTS.byFrequency), ((_d = (_c = config.frequencyDefaults) === null || _c === void 0 ? void 0 : _c.byFrequency) !== null && _d !== void 0 ? _d : {}))
-    };
-    const collected = new Set();
-    const code = (_g = (_f = (_e = timing.code) === null || _e === void 0 ? void 0 : _e.coding) === null || _f === void 0 ? void 0 : _f.find((coding) => coding.code)) === null || _g === void 0 ? void 0 : _g.code;
-    const normalizedCode = code === null || code === void 0 ? void 0 : code.toUpperCase();
-    if (normalizedCode && ((_h = defaults.byCode) === null || _h === void 0 ? void 0 : _h[normalizedCode])) {
-        for (const clock of defaults.byCode[normalizedCode]) {
-            collected.add(normalizeClock(clock));
-        }
-    }
-    const repeat = timing.repeat;
-    if ((repeat === null || repeat === void 0 ? void 0 : repeat.frequency) && repeat.period && repeat.periodUnit) {
-        const key = `freq:${repeat.frequency}/${repeat.periodUnit}`;
-        if ((_j = defaults.byFrequency) === null || _j === void 0 ? void 0 : _j[key]) {
-            for (const clock of defaults.byFrequency[key]) {
-                collected.add(normalizeClock(clock));
-            }
-        }
-        const perPeriodKey = `freq:${repeat.frequency}/per:${repeat.period}${repeat.periodUnit}`;
-        if ((_k = defaults.byFrequency) === null || _k === void 0 ? void 0 : _k[perPeriodKey]) {
-            for (const clock of defaults.byFrequency[perPeriodKey]) {
-                collected.add(normalizeClock(clock));
-            }
-        }
-        if (collected.size === 0 && repeat.period === 1 && repeat.periodUnit === "d") {
-            for (const clock of inferDailyFrequencyClocks(repeat.frequency)) {
-                collected.add(clock);
-            }
-        }
-    }
-    return Array.from(collected).sort();
-}
-/**
- * Produces the next dose timestamps in ascending order according to the
- * provided configuration and dosage metadata.
- */
-function nextDueDoses(dosage, options) {
-    var _a, _b, _c, _d, _e, _f, _g, _h, _j;
-    if (!options || typeof options !== "object") {
-        throw new Error("Options argument is required for nextDueDoses");
-    }
-    if (options.from === undefined) {
-        throw new Error("The 'from' option is required for nextDueDoses");
-    }
-    const limit = (_a = options.limit) !== null && _a !== void 0 ? _a : 10;
-    if (!Number.isFinite(limit) || limit <= 0) {
-        return [];
-    }
-    const from = coerceDate(options.from, "from");
-    const orderedAt = options.orderedAt === undefined ? null : coerceDate(options.orderedAt, "orderedAt");
-    const priorCountInput = options.priorCount;
-    if (priorCountInput !== undefined) {
-        if (!Number.isFinite(priorCountInput) || priorCountInput < 0) {
-            throw new Error("Invalid priorCount supplied to nextDueDoses");
-        }
-    }
-    let priorCount = priorCountInput !== undefined ? Math.floor(priorCountInput) : 0;
-    const needsDerivedPriorCount = priorCountInput === undefined && !!orderedAt;
-    const baseTime = orderedAt !== null && orderedAt !== void 0 ? orderedAt : from;
-    const providedConfig = options.config;
-    const timeZone = (_b = options.timeZone) !== null && _b !== void 0 ? _b : providedConfig === null || providedConfig === void 0 ? void 0 : providedConfig.timeZone;
-    if (!timeZone) {
-        throw new Error("Configuration with a valid timeZone is required");
-    }
-    const eventClock = Object.assign(Object.assign({}, ((_c = providedConfig === null || providedConfig === void 0 ? void 0 : providedConfig.eventClock) !== null && _c !== void 0 ? _c : {})), ((_d = options.eventClock) !== null && _d !== void 0 ? _d : {}));
-    const mealOffsets = Object.assign(Object.assign({}, ((_e = providedConfig === null || providedConfig === void 0 ? void 0 : providedConfig.mealOffsets) !== null && _e !== void 0 ? _e : {})), ((_f = options.mealOffsets) !== null && _f !== void 0 ? _f : {}));
-    const frequencyDefaults = mergeFrequencyDefaults(providedConfig === null || providedConfig === void 0 ? void 0 : providedConfig.frequencyDefaults, options.frequencyDefaults);
-    const config = {
-        timeZone,
-        eventClock,
-        mealOffsets,
-        frequencyDefaults
-    };
-    const timing = dosage.timing;
-    const repeat = timing === null || timing === void 0 ? void 0 : timing.repeat;
-    const courseEnd = timing && repeat ? resolveRepeatDurationCapEnd(repeat, baseTime, timeZone) : null;
-    if (needsDerivedPriorCount &&
-        orderedAt &&
-        timing &&
-        repeat &&
-        repeat.count !== undefined) {
-        priorCount = derivePriorCountFromHistory(timing, repeat, config, orderedAt, from, timeZone);
-    }
-    if (!timing || !repeat) {
-        return [];
-    }
-    if (courseEnd && from >= courseEnd) {
-        return [];
-    }
-    const rawCount = repeat.count;
-    const normalizedCount = rawCount === undefined ? undefined : Math.max(0, Math.floor(rawCount));
-    if (normalizedCount === 0) {
-        return [];
-    }
-    const remainingCount = normalizedCount === undefined ? undefined : Math.max(0, normalizedCount - priorCount);
-    if (remainingCount === 0) {
-        return [];
-    }
-    const effectiveLimit = remainingCount !== undefined ? Math.min(limit, remainingCount) : limit;
-    if (isSingleAdministrationRepeat(repeat)) {
-        if (hasUnresolvedRelationalInstruction(dosage)) {
-            return [];
-        }
-        const anchor = orderedAt !== null && orderedAt !== void 0 ? orderedAt : from;
-        if ((orderedAt && orderedAt < from) || (courseEnd && anchor >= courseEnd)) {
-            return [];
-        }
-        return [formatZonedIso(anchor, timeZone)].slice(0, effectiveLimit);
-    }
-    const results = [];
-    const seen = new Set();
-    const dayFilter = new Set(((_g = repeat.dayOfWeek) !== null && _g !== void 0 ? _g : []).map((day) => day.toLowerCase()));
-    const enforceDayFilter = dayFilter.size > 0;
-    const dayFilteredSeriesRepeat = resolveDayFilteredSeriesRepeat(repeat, enforceDayFilter);
-    const whenCodes = (_h = repeat.when) !== null && _h !== void 0 ? _h : [];
-    const timeOfDayEntries = (_j = repeat.timeOfDay) !== null && _j !== void 0 ? _j : [];
-    if (whenCodes.length > 0 || timeOfDayEntries.length > 0) {
-        const expanded = expandWhenCodes(whenCodes, config, repeat);
-        if (timeOfDayEntries.length > 0) {
-            for (const clock of timeOfDayEntries) {
-                expanded.push({ time: normalizeClock(clock), dayShift: 0 });
-            }
-            expanded.sort((a, b) => {
-                if (a.dayShift !== b.dayShift) {
-                    return a.dayShift - b.dayShift;
-                }
-                return a.time.localeCompare(b.time);
-            });
-        }
-        if (expanded.length === 0 &&
-            timeOfDayEntries.length === 0 &&
-            (!repeat.frequency || !repeat.period || !repeat.periodUnit)) {
-            expanded.push(...inferWhenFallbackEntries(whenCodes, repeat));
-        }
-        const includesImmediate = (0, array_1.arrayIncludes)(whenCodes, types_1.EventTiming.Immediate);
-        if (includesImmediate) {
-            const immediateSource = orderedAt !== null && orderedAt !== void 0 ? orderedAt : from;
-            if ((!orderedAt || orderedAt >= from) && (!courseEnd || immediateSource < courseEnd)) {
-                const instantIso = formatZonedIso(immediateSource, timeZone);
-                if (!seen.has(instantIso)) {
-                    seen.add(instantIso);
-                    results.push(instantIso);
-                }
-            }
-        }
-        if (results.length >= effectiveLimit) {
-            return results.slice(0, effectiveLimit);
-        }
-        const canFallbackToFrequency = expanded.length === 0 &&
-            timeOfDayEntries.length === 0 &&
-            !!repeat.frequency &&
-            !!repeat.period &&
-            !!repeat.periodUnit;
-        if (!canFallbackToFrequency) {
-            if (expanded.length === 0) {
-                return results.slice(0, effectiveLimit);
-            }
-            let currentDay = startOfLocalDay(from, timeZone);
-            let iterations = 0;
-            const maxIterations = effectiveLimit * 31;
-            while (results.length < effectiveLimit &&
-                iterations < maxIterations &&
-                (!courseEnd || currentDay < courseEnd)) {
-                const weekday = getLocalWeekday(currentDay, timeZone);
-                if (!enforceDayFilter || dayFilter.has(weekday)) {
-                    for (const entry of expanded) {
-                        const targetDay = entry.dayShift === 0
-                            ? currentDay
-                            : addLocalDays(currentDay, entry.dayShift, timeZone);
-                        const zoned = makeZonedDateFromDay(targetDay, timeZone, entry.time);
-                        if (!zoned) {
-                            continue;
-                        }
-                        if (zoned < from) {
-                            continue;
-                        }
-                        if (orderedAt && zoned < orderedAt) {
-                            continue;
-                        }
-                        if (courseEnd && zoned >= courseEnd) {
-                            continue;
-                        }
-                        const iso = formatZonedIso(zoned, timeZone);
-                        if (!seen.has(iso)) {
-                            seen.add(iso);
-                            results.push(iso);
-                            if (results.length === effectiveLimit) {
-                                break;
-                            }
-                        }
-                    }
-                }
-                if (results.length >= effectiveLimit) {
-                    break;
-                }
-                currentDay = addLocalDays(currentDay, 1, timeZone);
-                iterations += 1;
-            }
-            return results.slice(0, effectiveLimit);
-        }
-    }
-    const treatAsInterval = !!repeat.period &&
-        !!repeat.periodUnit &&
-        (!repeat.frequency ||
-            repeat.periodUnit !== "d" ||
-            (repeat.frequency === 1 && repeat.period > 1));
-    const supportsDayFilteredInterval = isDayFilteredIntervalSupported(repeat, enforceDayFilter);
-    if (treatAsInterval && supportsDayFilteredInterval) {
-        // True interval schedules advance from the order start in fixed units. The
-        // timing.code remains advisory so we only rely on the period/unit fields.
-        const candidates = generateIntervalSeries(baseTime, from, effectiveLimit, repeat, timeZone, dayFilter, enforceDayFilter, orderedAt, courseEnd);
-        return candidates;
-    }
-    if (dayFilteredSeriesRepeat) {
-        return generateDayFilteredPeriodSeries({
-            repeat: dayFilteredSeriesRepeat,
-            timeZone,
-            dayFilter,
-            anchorDay: startOfLocalDay(baseTime, timeZone),
-            startDay: from,
-            from,
-            to: courseEnd !== null && courseEnd !== void 0 ? courseEnd : undefined,
-            orderedAt,
-            limit: effectiveLimit,
-            defaultClock: toLocalClock(baseTime, timeZone)
-        }).slice(0, effectiveLimit);
-    }
-    if (repeat.frequency && repeat.period && repeat.periodUnit) {
-        // Pure frequency schedules (e.g., BID/TID) rely on institution clocks that
-        // clinicians expect. These can be overridden via configuration when
-        // facilities use bespoke medication rounds.
-        const clocks = resolveFrequencyClocks(timing, config);
-        if (clocks.length === 0) {
-            return [];
-        }
-        let currentDay = startOfLocalDay(from, timeZone);
-        let iterations = 0;
-        const maxIterations = effectiveLimit * 31;
-        while (results.length < effectiveLimit &&
-            iterations < maxIterations &&
-            (!courseEnd || currentDay < courseEnd)) {
-            const weekday = getLocalWeekday(currentDay, timeZone);
-            if (!enforceDayFilter || dayFilter.has(weekday)) {
-                for (const clock of clocks) {
-                    const zoned = makeZonedDateFromDay(currentDay, timeZone, clock);
-                    if (!zoned) {
-                        continue;
-                    }
-                    if (zoned < from) {
-                        continue;
-                    }
-                    if (orderedAt && zoned < orderedAt) {
-                        continue;
-                    }
-                    if (courseEnd && zoned >= courseEnd) {
-                        continue;
-                    }
-                    const iso = formatZonedIso(zoned, timeZone);
-                    if (!seen.has(iso)) {
-                        seen.add(iso);
-                        results.push(iso);
-                        if (results.length === effectiveLimit) {
-                            break;
-                        }
-                    }
-                }
-            }
-            currentDay = addLocalDays(currentDay, 1, timeZone);
-            iterations += 1;
-        }
-        return results.slice(0, effectiveLimit);
-    }
-    return [];
-}
-function derivePriorCountFromHistory(timing, repeat, config, orderedAt, from, timeZone) {
-    var _a, _b, _c;
-    if (from <= orderedAt) {
-        return 0;
-    }
-    const normalizedCount = repeat.count === undefined
-        ? undefined
-        : Math.max(0, Math.floor(repeat.count));
-    if (normalizedCount === 0) {
-        return 0;
-    }
-    const dayFilter = new Set(((_a = repeat.dayOfWeek) !== null && _a !== void 0 ? _a : []).map((day) => day.toLowerCase()));
-    const enforceDayFilter = dayFilter.size > 0;
-    const dayFilteredSeriesRepeat = resolveDayFilteredSeriesRepeat(repeat, enforceDayFilter);
-    const seen = new Set();
-    let count = 0;
-    const recordCandidate = (candidate) => {
-        if (!candidate) {
-            return false;
-        }
-        if (candidate < orderedAt || candidate >= from) {
-            return false;
-        }
-        const iso = formatZonedIso(candidate, timeZone);
-        if (seen.has(iso)) {
-            return false;
-        }
-        seen.add(iso);
-        count += 1;
-        return true;
-    };
-    const whenCodes = (_b = repeat.when) !== null && _b !== void 0 ? _b : [];
-    const timeOfDayEntries = (_c = repeat.timeOfDay) !== null && _c !== void 0 ? _c : [];
-    if (whenCodes.length > 0 || timeOfDayEntries.length > 0) {
-        const expanded = expandWhenCodes(whenCodes, config, repeat);
-        if (timeOfDayEntries.length > 0) {
-            for (const clock of timeOfDayEntries) {
-                expanded.push({ time: normalizeClock(clock), dayShift: 0 });
-            }
-            expanded.sort((a, b) => {
-                if (a.dayShift !== b.dayShift) {
-                    return a.dayShift - b.dayShift;
-                }
-                return a.time.localeCompare(b.time);
-            });
-        }
-        if (expanded.length === 0 &&
-            timeOfDayEntries.length === 0 &&
-            (!repeat.frequency || !repeat.period || !repeat.periodUnit)) {
-            expanded.push(...inferWhenFallbackEntries(whenCodes, repeat));
-        }
-        if ((0, array_1.arrayIncludes)(whenCodes, types_1.EventTiming.Immediate)) {
-            if (recordCandidate(orderedAt) && normalizedCount !== undefined && seen.size >= normalizedCount) {
-                return count;
-            }
-        }
-        const canFallbackToFrequency = expanded.length === 0 &&
-            timeOfDayEntries.length === 0 &&
-            !!repeat.frequency &&
-            !!repeat.period &&
-            !!repeat.periodUnit;
-        if (!canFallbackToFrequency) {
-            if (expanded.length === 0) {
-                return count;
-            }
-            let currentDay = startOfLocalDay(orderedAt, timeZone);
-            let iterations = 0;
-            const maxIterations = normalizedCount !== undefined ? normalizedCount * 31 : 31 * 365;
-            while (currentDay < from && iterations < maxIterations) {
-                const weekday = getLocalWeekday(currentDay, timeZone);
-                if (!enforceDayFilter || dayFilter.has(weekday)) {
-                    for (const entry of expanded) {
-                        const targetDay = entry.dayShift === 0
-                            ? currentDay
-                            : addLocalDays(currentDay, entry.dayShift, timeZone);
-                        const zoned = makeZonedDateFromDay(targetDay, timeZone, entry.time);
-                        if (!zoned) {
-                            continue;
-                        }
-                        if (zoned < orderedAt || zoned >= from) {
-                            continue;
-                        }
-                        if (recordCandidate(zoned) && normalizedCount !== undefined && seen.size >= normalizedCount) {
-                            return count;
-                        }
-                    }
-                }
-                currentDay = addLocalDays(currentDay, 1, timeZone);
-                iterations += 1;
-            }
-            return count;
-        }
-    }
-    const treatAsInterval = !!repeat.period &&
-        !!repeat.periodUnit &&
-        (!repeat.frequency ||
-            repeat.periodUnit !== "d" ||
-            (repeat.frequency === 1 && repeat.period > 1));
-    const supportsDayFilteredInterval = isDayFilteredIntervalSupported(repeat, enforceDayFilter);
-    if (treatAsInterval && supportsDayFilteredInterval) {
-        const increment = createIntervalStepper(repeat, timeZone);
-        if (!increment) {
-            return count;
-        }
-        let current = orderedAt;
-        let guard = 0;
-        const maxIterations = normalizedCount !== undefined ? normalizedCount * 1000 : 1000;
-        while (current < from && guard < maxIterations) {
-            const weekday = getLocalWeekday(current, timeZone);
-            if (!enforceDayFilter || dayFilter.has(weekday)) {
-                if (recordCandidate(current) && normalizedCount !== undefined && seen.size >= normalizedCount) {
-                    return count;
-                }
-            }
-            const next = increment(current);
-            if (!next || next.getTime() === current.getTime()) {
-                break;
-            }
-            current = next;
-            guard += 1;
-        }
-        return count;
-    }
-    if (dayFilteredSeriesRepeat) {
-        const generated = generateDayFilteredPeriodSeries({
-            repeat: dayFilteredSeriesRepeat,
-            timeZone,
-            dayFilter,
-            anchorDay: startOfLocalDay(orderedAt, timeZone),
-            startDay: orderedAt,
-            from: orderedAt,
-            to: from,
-            orderedAt,
-            limit: normalizedCount !== null && normalizedCount !== void 0 ? normalizedCount : 31 * 365,
-            defaultClock: toLocalClock(orderedAt, timeZone)
-        });
-        return count + generated.length;
-    }
-    if (repeat.frequency && repeat.period && repeat.periodUnit) {
-        const clocks = resolveFrequencyClocks(timing, config);
-        if (clocks.length === 0) {
-            return count;
-        }
-        let currentDay = startOfLocalDay(orderedAt, timeZone);
-        let iterations = 0;
-        const maxIterations = normalizedCount !== undefined ? normalizedCount * 31 : 31 * 365;
-        while (currentDay < from && iterations < maxIterations) {
-            const weekday = getLocalWeekday(currentDay, timeZone);
-            if (!enforceDayFilter || dayFilter.has(weekday)) {
-                for (const clock of clocks) {
-                    const zoned = makeZonedDateFromDay(currentDay, timeZone, clock);
-                    if (!zoned) {
-                        continue;
-                    }
-                    if (zoned < orderedAt || zoned >= from) {
-                        continue;
-                    }
-                    if (recordCandidate(zoned) && normalizedCount !== undefined && seen.size >= normalizedCount) {
-                        return count;
-                    }
-                }
-            }
-            currentDay = addLocalDays(currentDay, 1, timeZone);
-            iterations += 1;
-        }
-    }
-    return count;
-}
-/**
- * Generates an interval-based series by stepping forward from the base time
- * until the requested number of timestamps have been produced.
- */
-function generateIntervalSeries(baseTime, from, effectiveLimit, repeat, timeZone, dayFilter, enforceDayFilter, orderedAt, upperBound) {
-    const increment = createIntervalStepper(repeat, timeZone);
-    if (!increment) {
-        return [];
-    }
-    const results = [];
-    const seen = new Set();
-    let current = baseTime;
-    let guard = 0;
-    const maxIterations = effectiveLimit * 1000;
-    while (current < from && guard < maxIterations) {
-        const next = increment(current);
-        if (!next || next.getTime() === current.getTime()) {
-            break;
-        }
-        current = next;
-        guard += 1;
-    }
-    while (results.length < effectiveLimit &&
-        guard < maxIterations &&
-        (!upperBound || current < upperBound)) {
-        const weekday = getLocalWeekday(current, timeZone);
-        if (!enforceDayFilter || dayFilter.has(weekday)) {
-            if (current < from) {
-                // Ensure the current candidate respects the evaluation window.
-                guard += 1;
-                const next = increment(current);
-                if (!next || next.getTime() === current.getTime()) {
-                    break;
-                }
-                current = next;
-                continue;
-            }
-            if (orderedAt && current < orderedAt) {
-                guard += 1;
-                const next = increment(current);
-                if (!next || next.getTime() === current.getTime()) {
-                    break;
-                }
-                current = next;
-                continue;
-            }
-            if (upperBound && current >= upperBound) {
-                break;
-            }
-            const iso = formatZonedIso(current, timeZone);
-            if (!seen.has(iso)) {
-                seen.add(iso);
-                results.push(iso);
-            }
-        }
-        const next = increment(current);
-        if (!next || next.getTime() === current.getTime()) {
-            break;
-        }
-        current = next;
-        guard += 1;
-    }
-    return results.slice(0, effectiveLimit);
-}
-/**
- * Builds a function that advances a Date according to repeat.period/unit.
- *
- * @param repeat FHIR repeat object containing `period` and `periodUnit`.
- * @param timeZone IANA timezone used for calendar-aware month/year stepping.
- * @returns Stepper function advancing one interval, or `null` when unsupported.
- */
-function createIntervalStepper(repeat, timeZone) {
-    const { period, periodUnit } = repeat;
-    if (!period || !periodUnit) {
-        return null;
-    }
-    if (periodUnit === "s" || periodUnit === "min" || periodUnit === "h") {
-        const multiplier = periodUnit === "s" ? 1000 : periodUnit === "min" ? 60 * 1000 : 60 * 60 * 1000;
-        const delta = period * multiplier;
-        return (value) => new Date(value.getTime() + delta);
-    }
-    if (periodUnit === "d") {
-        const delta = period * 24 * 60 * 60 * 1000;
-        return (value) => new Date(value.getTime() + delta);
-    }
-    if (periodUnit === "wk") {
-        const delta = period * 7 * 24 * 60 * 60 * 1000;
-        return (value) => new Date(value.getTime() + delta);
-    }
-    if (periodUnit === "mo") {
-        return (value) => addCalendarMonths(value, period, timeZone);
-    }
-    if (periodUnit === "a") {
-        return (value) => addCalendarMonths(value, period * 12, timeZone);
-    }
-    return null;
-}
-/**
- * Adds calendar months while respecting varying month lengths and DST.
- *
- * @param date Starting instant.
- * @param months Number of calendar months to add.
- * @param timeZone IANA timezone used for wall-clock preservation.
- * @returns Shifted date preserving local clock and clamped day-of-month.
- */
-function addCalendarMonths(date, months, timeZone) {
-    const { year, month, day, hour, minute, second } = getTimeParts(date, timeZone);
-    const targetMonthIndex = month - 1 + months;
-    const targetYear = year + Math.floor(targetMonthIndex / 12);
-    const targetMonth = (targetMonthIndex % 12 + 12) % 12;
-    const candidate = makeZonedDate(timeZone, targetYear, targetMonth + 1, 1, hour, minute, second);
-    if (!candidate) {
-        throw new Error("Unable to compute candidate month while scheduling");
-    }
-    const lastDay = new Date(candidate.getTime());
-    lastDay.setUTCMonth(lastDay.getUTCMonth() + 1);
-    lastDay.setUTCDate(0);
-    const maxDay = getTimeParts(lastDay, timeZone).day;
-    const resolvedDay = Math.min(day, maxDay);
-    const final = makeZonedDate(timeZone, targetYear, targetMonth + 1, resolvedDay, hour, minute, second);
-    if (!final) {
-        throw new Error("Unable to resolve monthly advancement – invalid calendar date");
-    }
-    return final;
-}
-/**
- * Determines whether interval stepping can safely combine with a day-of-week filter.
- *
- * @param repeat FHIR timing repeat object containing period unit metadata.
- * @param enforceDayFilter Whether a `dayOfWeek` filter is active for this schedule.
- * @returns `true` when interval stepping should be used directly; otherwise fallback logic is required.
- */
-function isDayFilteredIntervalSupported(repeat, enforceDayFilter) {
-    if (!enforceDayFilter) {
-        return true;
-    }
-    return (repeat.periodUnit === "s" ||
-        repeat.periodUnit === "min" ||
-        repeat.periodUnit === "h" ||
-        repeat.periodUnit === "d");
-}
-/**
- * Expands weekly/monthly/yearly day-filtered schedules into concrete dose timestamps.
- *
- * @param options Configuration describing bounds, cadence, and clock defaults.
- * @param options.repeat FHIR repeat block driving cadence and cycle alignment.
- * @param options.timeZone IANA timezone used for local weekday and clock resolution.
- * @param options.dayFilter Set of lowercased weekdays that are allowed (e.g. `mon`, `tue`).
- * @param options.anchorDay Cycle anchor day used to determine period alignment.
- * @param options.startDay First local day to begin scanning.
- * @param options.from Inclusive lower bound for candidate timestamps.
- * @param options.to Optional exclusive upper bound for candidate timestamps.
- * @param options.orderedAt Optional lower bound representing the order start.
- * @param options.limit Maximum number of timestamps to emit.
- * @param options.defaultClock Default local clock (`HH:MM:SS`) when no explicit clock is provided.
- * @returns Sorted zoned ISO timestamps matching the requested cadence and bounds.
- */
-function generateDayFilteredPeriodSeries(options) {
-    const { repeat, timeZone, dayFilter, anchorDay, startDay, from, to, orderedAt, limit, defaultClock } = options;
-    if (limit <= 0) {
-        return [];
-    }
-    const results = [];
-    const seen = new Set();
-    const clocks = [defaultClock !== null && defaultClock !== void 0 ? defaultClock : "08:00:00"];
-    let currentDay = startOfLocalDay(startDay, timeZone);
-    let iterations = 0;
-    const startMs = currentDay.getTime();
-    const estimatedDays = to
-        ? Math.max(1, Math.ceil((to.getTime() - startMs) / (24 * 60 * 60 * 1000)))
-        : limit * 31;
-    const maxIterations = Math.max(limit * 31, estimatedDays + 31);
-    while (results.length < limit &&
-        iterations < maxIterations &&
-        (!to || currentDay < to)) {
-        const weekday = getLocalWeekday(currentDay, timeZone);
-        const inPeriodCycle = isDateAlignedToPeriodCycle(currentDay, anchorDay, repeat, timeZone);
-        if (inPeriodCycle && dayFilter.has(weekday)) {
-            for (const clock of clocks) {
-                const zoned = makeZonedDateFromDay(currentDay, timeZone, clock);
-                if (!zoned) {
-                    continue;
-                }
-                if (zoned < from) {
-                    continue;
-                }
-                if (to && zoned >= to) {
-                    continue;
-                }
-                if (orderedAt && zoned < orderedAt) {
-                    continue;
-                }
-                const iso = formatZonedIso(zoned, timeZone);
-                if (!seen.has(iso)) {
-                    seen.add(iso);
-                    results.push(iso);
-                    if (results.length === limit) {
-                        break;
-                    }
-                }
-            }
-        }
-        currentDay = addLocalDays(currentDay, 1, timeZone);
-        iterations += 1;
-    }
-    return results;
-}
-/**
- * Formats a date into a local `HH:MM:SS` clock for the supplied timezone.
- *
- * @param date Source instant.
- * @param timeZone IANA timezone to interpret the instant.
- * @returns Local wall-clock time in `HH:MM:SS` format.
- */
-function toLocalClock(date, timeZone) {
-    const parts = getTimeParts(date, timeZone);
-    const twoDigits = (value) => (value < 10 ? `0${value}` : `${value}`);
-    const h = twoDigits(parts.hour);
-    const m = twoDigits(parts.minute);
-    const s = twoDigits(parts.second);
-    return `${h}:${m}:${s}`;
-}
-/**
- * Internal helper to count dose events within a time range.
- *
- * @param dosage Dosage definition with timing metadata.
- * @param from Inclusive lower time bound for counting.
- * @param to Exclusive upper time bound for counting.
- * @param config Scheduling configuration (timezone, clocks, offsets).
- * @param baseTime Anchor instant used for interval alignment.
- * @param orderedAt Optional order timestamp used as an additional lower bound.
- * @param limit Optional hard cap on emitted candidates to avoid runaway loops.
- * @returns Number of unique dose events in the requested window.
- */
-function countScheduleEvents(dosage, from, to, config, baseTime, orderedAt, limit) {
-    var _a, _b, _c;
-    const timing = dosage.timing;
-    const repeat = timing === null || timing === void 0 ? void 0 : timing.repeat;
-    if (!timing || !repeat)
-        return 0;
-    const normalizedCount = repeat.count === undefined
-        ? undefined
-        : Math.max(0, Math.floor(repeat.count));
-    if (normalizedCount === 0) {
-        return 0;
-    }
-    const dayFilter = new Set(((_a = repeat.dayOfWeek) !== null && _a !== void 0 ? _a : []).map((day) => day.toLowerCase()));
-    const enforceDayFilter = dayFilter.size > 0;
-    const dayFilteredSeriesRepeat = resolveDayFilteredSeriesRepeat(repeat, enforceDayFilter);
-    const seen = new Set();
-    let count = 0;
-    const timeZone = config.timeZone;
-    const priorCount = normalizedCount !== undefined && orderedAt && from > orderedAt
-        ? derivePriorCountFromHistory(timing, repeat, config, orderedAt, from, timeZone)
-        : 0;
-    const countLimit = normalizedCount === undefined
-        ? (limit !== null && limit !== void 0 ? limit : Number.POSITIVE_INFINITY)
-        : Math.min(limit !== null && limit !== void 0 ? limit : normalizedCount, Math.max(0, normalizedCount - priorCount));
-    if (countLimit <= 0) {
-        return 0;
-    }
-    const hardLimit = Number.isFinite(countLimit) ? countLimit : 365 * 31;
-    if (isSingleAdministrationRepeat(repeat)) {
-        if (hasUnresolvedRelationalInstruction(dosage)) {
-            return 0;
-        }
-        const anchor = orderedAt !== null && orderedAt !== void 0 ? orderedAt : baseTime;
-        if (anchor < from || anchor >= to) {
-            return 0;
-        }
-        return 1;
-    }
-    const recordCandidate = (candidate) => {
-        if (!candidate)
-            return false;
-        if (candidate < from || candidate >= to)
-            return false;
-        const iso = formatZonedIso(candidate, timeZone);
-        if (seen.has(iso))
-            return false;
-        seen.add(iso);
-        count += 1;
-        return true;
-    };
-    const whenCodes = (_b = repeat.when) !== null && _b !== void 0 ? _b : [];
-    const timeOfDayEntries = (_c = repeat.timeOfDay) !== null && _c !== void 0 ? _c : [];
-    if (whenCodes.length > 0 || timeOfDayEntries.length > 0) {
-        const expanded = expandWhenCodes(whenCodes, config, repeat);
-        if (timeOfDayEntries.length > 0) {
-            for (const clock of timeOfDayEntries) {
-                expanded.push({ time: normalizeClock(clock), dayShift: 0 });
-            }
-            expanded.sort((a, b) => {
-                if (a.dayShift !== b.dayShift)
-                    return a.dayShift - b.dayShift;
-                return a.time.localeCompare(b.time);
-            });
-        }
-        if (expanded.length === 0 &&
-            timeOfDayEntries.length === 0 &&
-            (!repeat.frequency || !repeat.period || !repeat.periodUnit)) {
-            expanded.push(...inferWhenFallbackEntries(whenCodes, repeat));
-        }
-        if ((0, array_1.arrayIncludes)(whenCodes, types_1.EventTiming.Immediate)) {
-            const immediateSource = orderedAt !== null && orderedAt !== void 0 ? orderedAt : from;
-            if (!orderedAt || orderedAt >= from) {
-                recordCandidate(immediateSource);
-            }
-        }
-        const canFallbackToFrequency = expanded.length === 0 &&
-            timeOfDayEntries.length === 0 &&
-            !!repeat.frequency &&
-            !!repeat.period &&
-            !!repeat.periodUnit;
-        if (!canFallbackToFrequency) {
-            if (expanded.length === 0)
-                return count;
-            let currentDay = startOfLocalDay(from, timeZone);
-            let iterations = 0;
-            const maxIterations = hardLimit * 31;
-            while (count < countLimit && currentDay < to && iterations < maxIterations) {
-                const weekday = getLocalWeekday(currentDay, timeZone);
-                if (!enforceDayFilter || dayFilter.has(weekday)) {
-                    for (const entry of expanded) {
-                        const targetDay = entry.dayShift === 0
-                            ? currentDay
-                            : addLocalDays(currentDay, entry.dayShift, timeZone);
-                        const zoned = makeZonedDateFromDay(targetDay, timeZone, entry.time);
-                        if (zoned)
-                            recordCandidate(zoned);
-                    }
-                }
-                currentDay = addLocalDays(currentDay, 1, timeZone);
-                iterations += 1;
-            }
-            return count;
-        }
-    }
-    const treatAsInterval = !!repeat.period &&
-        !!repeat.periodUnit &&
-        (!repeat.frequency ||
-            repeat.periodUnit !== "d" ||
-            (repeat.frequency === 1 && repeat.period > 1));
-    const supportsDayFilteredInterval = isDayFilteredIntervalSupported(repeat, enforceDayFilter);
-    if (treatAsInterval && supportsDayFilteredInterval) {
-        const increment = createIntervalStepper(repeat, timeZone);
-        if (!increment)
-            return count;
-        let current = baseTime;
-        let guard = 0;
-        const maxIterations = hardLimit * 1000;
-        // Advance to "from"
-        while (current < from && guard < maxIterations) {
-            const next = increment(current);
-            if (!next || next.getTime() === current.getTime())
-                break;
-            current = next;
-            guard++;
-        }
-        while (current < to && count < countLimit && guard < maxIterations) {
-            const weekday = getLocalWeekday(current, timeZone);
-            if (!enforceDayFilter || dayFilter.has(weekday)) {
-                recordCandidate(current);
-            }
-            const next = increment(current);
-            if (!next || next.getTime() === current.getTime())
-                break;
-            current = next;
-            guard += 1;
-        }
-        return count;
-    }
-    if (repeat.frequency && repeat.period && repeat.periodUnit) {
-        const clocks = resolveFrequencyClocks(timing, config);
-        if (clocks.length === 0)
-            return count;
-        let currentDay = startOfLocalDay(from, timeZone);
-        let iterations = 0;
-        const maxIterations = hardLimit * 31;
-        while (count < countLimit && currentDay < to && iterations < maxIterations) {
-            const weekday = getLocalWeekday(currentDay, timeZone);
-            if (!enforceDayFilter || dayFilter.has(weekday)) {
-                for (const clock of clocks) {
-                    const zoned = makeZonedDateFromDay(currentDay, timeZone, clock);
-                    if (zoned)
-                        recordCandidate(zoned);
-                }
-            }
-            currentDay = addLocalDays(currentDay, 1, timeZone);
-            iterations += 1;
-        }
-    }
-    // Fallback for dayOfWeek with period/periodUnit but no explicit frequency/clocks
-    if (dayFilteredSeriesRepeat) {
-        const generated = generateDayFilteredPeriodSeries({
-            repeat: dayFilteredSeriesRepeat,
-            timeZone,
-            dayFilter,
-            anchorDay: startOfLocalDay(baseTime, timeZone),
-            startDay: from,
-            from,
-            to,
-            orderedAt,
-            limit: hardLimit,
-            defaultClock: toLocalClock(baseTime, timeZone)
-        });
-        return count + generated.length;
-    }
-    return count;
-}
-function calculateTotalUnitsSingle(options) {
-    var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o;
-    const { dosage, durationValue, durationUnit, roundToMultiple, context } = options;
-    const from = coerceDate(options.from, "from");
-    const orderedAtDate = options.orderedAt === undefined ? null : coerceDate(options.orderedAt, "orderedAt");
-    const providedConfig = options.config;
-    const timeZone = (_a = options.timeZone) !== null && _a !== void 0 ? _a : providedConfig === null || providedConfig === void 0 ? void 0 : providedConfig.timeZone;
-    if (!timeZone) {
-        throw new Error("timeZone is required for calculateTotalUnits");
-    }
-    const eventClock = Object.assign(Object.assign({}, ((_b = providedConfig === null || providedConfig === void 0 ? void 0 : providedConfig.eventClock) !== null && _b !== void 0 ? _b : {})), ((_c = options.eventClock) !== null && _c !== void 0 ? _c : {}));
-    const mealOffsets = Object.assign(Object.assign({}, ((_d = providedConfig === null || providedConfig === void 0 ? void 0 : providedConfig.mealOffsets) !== null && _d !== void 0 ? _d : {})), ((_e = options.mealOffsets) !== null && _e !== void 0 ? _e : {}));
-    const frequencyDefaults = mergeFrequencyDefaults(providedConfig === null || providedConfig === void 0 ? void 0 : providedConfig.frequencyDefaults, options.frequencyDefaults);
-    const config = {
-        timeZone,
-        eventClock,
-        mealOffsets,
-        frequencyDefaults
-    };
-    // Calculate end date based on duration
-    let endDay;
-    const dummyRepeat = { period: durationValue, periodUnit: durationUnit };
-    const stepper = createIntervalStepper(dummyRepeat, timeZone);
-    if (stepper) {
-        endDay = stepper(from) || from;
-    }
-    else {
-        endDay = from;
-    }
-    endDay = minDate(endDay, resolveRepeatDurationCapEnd((_f = dosage.timing) === null || _f === void 0 ? void 0 : _f.repeat, orderedAtDate !== null && orderedAtDate !== void 0 ? orderedAtDate : from, timeZone));
-    const count = countScheduleEvents(dosage, from, endDay, config, orderedAtDate !== null && orderedAtDate !== void 0 ? orderedAtDate : from, orderedAtDate, 2000);
-    const doseQuantity = (_k = (_j = (_h = (_g = dosage.doseAndRate) === null || _g === void 0 ? void 0 : _g[0]) === null || _h === void 0 ? void 0 : _h.doseQuantity) === null || _j === void 0 ? void 0 : _j.value) !== null && _k !== void 0 ? _k : 0;
-    let totalUnits = count * doseQuantity;
-    if (roundToMultiple && roundToMultiple > 0) {
-        totalUnits = Math.ceil(totalUnits / roundToMultiple) * roundToMultiple;
-    }
-    const result = { totalUnits };
-    // Handle containers
-    const containerValue = context === null || context === void 0 ? void 0 : context.containerValue;
-    const containerUnit = context === null || context === void 0 ? void 0 : context.containerUnit;
-    const doseUnit = (_o = (_m = (_l = dosage.doseAndRate) === null || _l === void 0 ? void 0 : _l[0]) === null || _m === void 0 ? void 0 : _m.doseQuantity) === null || _o === void 0 ? void 0 : _o.unit;
-    if (containerValue && containerValue > 0) {
-        let effectiveUnits = totalUnits;
-        if (containerUnit && doseUnit && containerUnit !== doseUnit) {
-            let strength = context === null || context === void 0 ? void 0 : context.strengthRatio;
-            if (!strength && (context === null || context === void 0 ? void 0 : context.strength)) {
-                strength = (0, strength_1.parseStrengthIntoRatio)(context.strength, context) || undefined;
-            }
-            const converted = (0, units_1.convertValue)(totalUnits, doseUnit, containerUnit, strength);
-            if (converted !== null) {
-                effectiveUnits = converted;
-            }
-        }
-        result.totalContainers = Math.ceil(effectiveUnits / containerValue);
-    }
-    return result;
-}
-function calculateTotalUnits(options) {
-    if (Array.isArray(options.dosage)) {
-        const hasAnyDosage = options.dosage.length > 0;
-        if (!hasAnyDosage) {
-            return { totalUnits: 0 };
-        }
-        let totalUnits = 0;
-        let totalContainers = 0;
-        let sawContainers = false;
-        for (const dosage of options.dosage) {
-            const result = calculateTotalUnitsSingle(Object.assign(Object.assign({}, options), { dosage }));
-            totalUnits += result.totalUnits;
-            if (result.totalContainers !== undefined) {
-                totalContainers += result.totalContainers;
-                sawContainers = true;
-            }
-        }
-        return sawContainers ? { totalUnits, totalContainers } : { totalUnits };
-    }
-    return calculateTotalUnitsSingle(options);
-}