@mcp-monorepo/ics 1.2.0 → 1.3.1

package/dist/ics-parser/rrule-expander.js

@@ -0,0 +1,305 @@
+import { DateTime } from 'luxon';
+import { InvalidRruleError } from './errors.js';
+const weekdayMap = { MO: 1, TU: 2, WE: 3, TH: 4, FR: 5, SA: 6, SU: 7 };
+const weekdayReverseMap = { 1: 'MO', 2: 'TU', 3: 'WE', 4: 'TH', 5: 'FR', 6: 'SA', 7: 'SU' };
+// --- Validation and Low-Level Helpers (largely unchanged) ---
+function validateRule(rule) {
+    const nonEmptyAndInRange = (arr, min, max) => !arr || arr.every((n) => Number.isInteger(n) && n >= min && n <= max);
+    if (!rule.freq) {
+        throw new InvalidRruleError('RRULE: FREQ is required.');
+    }
+    if (rule.interval !== undefined && (!Number.isInteger(rule.interval) || rule.interval <= 0)) {
+        throw new InvalidRruleError('RRULE: INTERVAL must be a positive integer.');
+    }
+    if (!nonEmptyAndInRange(rule.bymonth, 1, 12)) {
+        throw new InvalidRruleError('RRULE: BYMONTH must be in 1..12.');
+    }
+    if (rule.bymonthday &&
+        !rule.bymonthday.every((n) => Number.isInteger(n) && ((n >= 1 && n <= 31) || (n <= -1 && n >= -31)))) {
+        throw new InvalidRruleError('RRULE: BYMONTHDAY must be in 1..31 or -31..-1.');
+    }
+    if (rule.byyearday &&
+        !rule.byyearday.every((n) => Number.isInteger(n) && ((n >= 1 && n <= 366) || (n <= -1 && n >= -366)))) {
+        throw new InvalidRruleError('RRULE: BYYEARDAY must be in 1..366 or -366..-1.');
+    }
+    if (rule.byweekno &&
+        !rule.byweekno.every((n) => Number.isInteger(n) && ((n >= 1 && n <= 53) || (n <= -1 && n >= -53)))) {
+        throw new InvalidRruleError('RRULE: BYWEEKNO must be in 1..53 or -53..-1.');
+    }
+    if (!nonEmptyAndInRange(rule.byhour, 0, 23))
+        throw new InvalidRruleError('RRULE: BYHOUR must be in 0..23.');
+    if (!nonEmptyAndInRange(rule.byminute, 0, 59))
+        throw new InvalidRruleError('RRULE: BYMINUTE must be in 0..59.');
+    if (!nonEmptyAndInRange(rule.bysecond, 0, 60))
+        throw new InvalidRruleError('RRULE: BYSECOND must be in 0..60.');
+    if (rule.bysetpos &&
+        !rule.bysetpos.every((n) => Number.isInteger(n) && ((n >= 1 && n <= 366) || (n <= -1 && n >= -366)))) {
+        throw new InvalidRruleError('RRULE: BYSETPOS must be 1..366 or -366..-1.');
+    }
+    if (rule.wkst && !(rule.wkst in weekdayMap)) {
+        throw new InvalidRruleError('RRULE: WKST must be one of MO,TU,WE,TH,FR,SA,SU.');
+    }
+}
+function applyBySetPos(candidates, bysetpos) {
+    if (candidates.length === 0)
+        return [];
+    const result = [];
+    for (const pos of bysetpos) {
+        const index = pos > 0 ? pos - 1 : candidates.length + pos;
+        if (index >= 0 && index < candidates.length) {
+            result.push(candidates[index]);
+        }
+    }
+    const seen = new Set();
+    return result
+        .filter((d) => {
+        const ts = d.toMillis();
+        if (seen.has(ts))
+            return false;
+        seen.add(ts);
+        return true;
+    })
+        .sort((a, b) => a.toMillis() - b.toMillis());
+}
+// --- Core Refactored Expansion Logic ---
+/**
+ * **REFACTORED**: A generator that expands a recurrence rule into a sequence of dates.
+ * This implementation uses an "iterative advancement" strategy to avoid generating
+ * huge arrays of candidates, making it significantly more performant.
+ * @param options - The start date of the event series (`rangeStart`), the rule, and the query `rangeEnd`.
+ */
+export function* expandRrule(options) {
+    const { dtstart, rule, rangeStart, rangeEnd } = options;
+    validateRule(rule);
+    let cursor = dtstart;
+    let count = 0;
+    const interval = rule.interval ?? 1;
+    const wkst = rule.wkst ? weekdayMap[rule.wkst] : 1; // Monday default
+    // Main loop: advances the cursor by the specified FREQ and INTERVAL.
+    while (true) {
+        if ((rule.count !== undefined && count >= rule.count) || (rule.until && cursor > rule.until) || cursor > rangeEnd) {
+            break;
+        }
+        // Generate valid occurrences only for the current period (e.g., this month, this week).
+        const occurrencesInPeriod = generateCandidatesForPeriod(cursor, dtstart, rule, wkst);
+        for (const occurrence of occurrencesInPeriod) {
+            // Filter out dates before the series start or after query/rule end.
+            if (occurrence < dtstart)
+                continue;
+            if ((rule.until && occurrence > rule.until) || occurrence > rangeEnd)
+                continue;
+            if (rule.count !== undefined && count >= rule.count)
+                break;
+            if (occurrence.isValid) {
+                yield occurrence;
+                count++;
+            }
+        }
+        // Advance the cursor to the start of the next period to avoid redundant calculations.
+        cursor = advanceCursor(cursor, rule.freq, interval);
+    }
+}
+/**
+ * **REFACTORED**: Generates candidate dates for a single period (year, month, week, or day)
+ * using a targeted approach instead of "generate and filter".
+ */
+function generateCandidatesForPeriod(cursor, dtstart, rule, wkst) {
+    // 1. Expand Dates: Generate a small, targeted set of days for the period.
+    const days = expandDatesInPeriod(cursor, dtstart, rule, wkst);
+    // 2. Expand Times: Apply time components to the generated days.
+    const times = expandTimes(days, dtstart, rule);
+    // 3. Apply BYSETPOS: This is the only filter that needs a complete, sorted set for the period.
+    if (rule.bysetpos) {
+        // Sort before applying bysetpos.
+        times.sort((a, b) => a.toMillis() - b.toMillis());
+        return applyBySetPos(times, rule.bysetpos);
+    }
+    return times;
+}
+/**
+ * **NEW**: Intelligently expands the date components for the current period.
+ * This is the core of the performance improvement.
+ */
+function expandDatesInPeriod(cursor, dtstart, rule, wkst) {
+    switch (rule.freq) {
+        case 'YEARLY': {
+            if (rule.byweekno) {
+                // Per RFC 5545, BYWEEKNO is only valid with FREQ=YEARLY]. It is used
+                // with BYDAY to select specific days within those weeks.
+                const dates = [];
+                const year = cursor.year;
+                const bydayRule = rule.byday?.map((r) => weekdayMap[r.weekday]) ?? [dtstart.weekday];
+                // Luxon's weeksInWeekYear gives the number of weeks in the ISO week-numbering year.
+                const weeksInYear = cursor.weeksInWeekYear;
+                for (const wn of rule.byweekno) {
+                    // Handle negative week numbers (e.g., -1 is the last week of the year).
+                    const weekNumber = wn > 0 ? wn : weeksInYear + wn + 1;
+                    if (weekNumber < 1 || weekNumber > weeksInYear)
+                        continue;
+                    for (const targetWeekday of bydayRule) {
+                        // Create a date from the ISO week year, week number, and weekday.
+                        // This correctly handles ISO 8601 week definitions.
+                        const date = DateTime.fromObject({
+                            weekYear: year,
+                            weekNumber: weekNumber,
+                            weekday: targetWeekday,
+                        }, { zone: cursor.zone });
+                        // Ensure the generated date falls within the correct calendar year,
+                        // as ISO weeks can cross year boundaries.
+                        if (date.isValid && date.year === year) {
+                            dates.push(date);
+                        }
+                    }
+                }
+                // The RFC specifies that BYMONTH filters the results of previous rules [1].
+                if (rule.bymonth) {
+                    const monthSet = new Set(rule.bymonth);
+                    // Return only the dates that fall in the specified months.
+                    const filtered = dates.filter((d) => monthSet.has(d.month));
+                    filtered.sort((a, b) => a.toMillis() - b.toMillis());
+                    return filtered;
+                }
+                // Sort dates chronologically before returning.
+                dates.sort((a, b) => a.toMillis() - b.toMillis());
+                return dates;
+            }
+            const months = rule.bymonth ?? [dtstart.month];
+            const dates = [];
+            for (const month of months) {
+                const monthCursor = cursor.set({ month });
+                dates.push(...getDaysInScope(monthCursor, dtstart, rule));
+            }
+            return dates;
+        }
+        case 'MONTHLY':
+            return getDaysInScope(cursor, dtstart, rule);
+        case 'WEEKLY': {
+            const startOfWeek = cursor.set({ weekday: wkst });
+            const weekDays = Array.from({ length: 7 }, (_, i) => startOfWeek.plus({ days: i }));
+            const bydayRule = rule.byday?.map((r) => r.weekday) ?? [weekdayReverseMap[dtstart.weekday]];
+            return weekDays.filter((d) => bydayRule.includes(weekdayReverseMap[d.weekday]));
+        }
+        default: // DAILY, HOURLY, MINUTELY, SECONDLY
+            return [cursor];
+    }
+}
+/**
+ * **NEW**: Helper to get valid days within a scope (e.g., a month),
+ * respecting BYDAY, BYMONTHDAY, etc.
+ */
+function getDaysInScope(cursor, dtstart, rule) {
+    const monthStart = cursor.startOf('month');
+    const daysInMonth = cursor.daysInMonth;
+    if (!daysInMonth)
+        return [];
+    const results = new Set();
+    // Handle BYYEARDAY if present (for YEARLY rules)
+    if (rule.byyearday) {
+        for (const yd of rule.byyearday) {
+            const dayOfYear = yd > 0 ? yd : cursor.daysInYear + yd + 1;
+            const date = cursor.startOf('year').plus({ days: dayOfYear - 1 });
+            // Ensure we only add days within the current month being processed
+            if (date.month === cursor.month) {
+                results.add(date);
+            }
+        }
+        return Array.from(results);
+    }
+    // Handle BYDAY
+    if (rule.byday) {
+        for (const byday of rule.byday) {
+            const targetWday = weekdayMap[byday.weekday];
+            if (byday.n) {
+                // Ordinal day, e.g., 2MO (2nd Monday), -1SU (last Sunday)
+                const daysOfMonth = Array.from({ length: daysInMonth }, (_, i) => monthStart.plus({ days: i }));
+                const matchingDays = daysOfMonth.filter((d) => d.weekday === targetWday);
+                const index = byday.n > 0 ? byday.n - 1 : matchingDays.length + byday.n;
+                if (index >= 0 && index < matchingDays.length) {
+                    results.add(matchingDays[index]);
+                }
+            }
+            else {
+                // All days of this type, e.g., all Mondays
+                for (let i = 0; i < daysInMonth; i++) {
+                    const date = monthStart.plus({ days: i });
+                    if (date.weekday === targetWday) {
+                        results.add(date);
+                    }
+                }
+            }
+        }
+    }
+    // Handle BYMONTHDAY
+    if (rule.bymonthday) {
+        for (const md of rule.bymonthday) {
+            const day = md > 0 ? md : daysInMonth + md + 1;
+            if (day > 0 && day <= daysInMonth) {
+                results.add(monthStart.set({ day }));
+            }
+        }
+    }
+    // If no day-related BY... rules, infer from DTSTART
+    if (!rule.byday && !rule.bymonthday && !rule.byyearday) {
+        const day = Math.min(dtstart.day, daysInMonth);
+        results.add(monthStart.set({ day }));
+    }
+    // If both BYDAY and BYMONTHDAY are present, results should be the intersection.
+    // This is implicitly handled because we're adding to a Set. The logic
+    // would need to be more complex for a true intersection, but this covers many cases.
+    // A simple approach is to filter one by the other.
+    if (rule.byday && rule.bymonthday) {
+        const monthDaySet = new Set(rule.bymonthday.map((md) => (md > 0 ? md : daysInMonth + md + 1)));
+        return Array.from(results).filter((d) => monthDaySet.has(d.day));
+    }
+    return Array.from(results);
+}
+/**
+ * **NEW**: Applies time components to a set of dates.
+ */
+function expandTimes(dates, dtstart, rule) {
+    if (dates.length === 0)
+        return [];
+    // If frequency is smaller than daily, time expansion is handled by the cursor advancement.
+    if (['HOURLY', 'MINUTELY', 'SECONDLY'].includes(rule.freq)) {
+        return dates;
+    }
+    const hours = rule.byhour ?? [dtstart.hour];
+    const minutes = rule.byminute ?? [dtstart.minute];
+    const seconds = rule.bysecond ?? [dtstart.second];
+    const results = [];
+    for (const d of dates) {
+        for (const hour of hours) {
+            for (const minute of minutes) {
+                for (const second of seconds) {
+                    results.push(d.set({ hour, minute, second, millisecond: dtstart.millisecond }));
+                }
+            }
+        }
+    }
+    return results;
+}
+/**
+ * **NEW**: Advances the cursor to the start of the next period to process.
+ */
+function advanceCursor(cursor, freq, interval) {
+    switch (freq) {
+        case 'YEARLY':
+            return cursor.plus({ years: interval }).startOf('year');
+        case 'MONTHLY':
+            return cursor.plus({ months: interval }).startOf('month');
+        case 'WEEKLY':
+            return cursor.plus({ weeks: interval }).startOf('week');
+        case 'DAILY':
+            return cursor.plus({ days: interval }).startOf('day');
+        case 'HOURLY':
+            return cursor.plus({ hours: interval }).startOf('hour');
+        case 'MINUTELY':
+            return cursor.plus({ minutes: interval }).startOf('minute');
+        case 'SECONDLY':
+            return cursor.plus({ seconds: interval }).startOf('second');
+        default:
+            // Should not happen due to validation, but prevents infinite loops.
+            return cursor.plus({ years: 999 });
+    }
+}
+//# sourceMappingURL=rrule-expander.js.map

package/dist/ics-parser/rrule-expander.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rrule-expander.js","sourceRoot":"","sources":["../../src/ics-parser/rrule-expander.ts"],"names":[],"mappings":"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"}

package/dist/ics-parser/timezone-processor.d.ts

@@ -0,0 +1,40 @@
+import { DateTime } from 'luxon';
+import { type TimeZoneData, type TimeZoneObservance, type TimeZoneResolver, type TimeZoneTransition, type VComponent } from './types.js';
+/**
+ * Processes a single VTIMEZONE component into a structured TimeZoneData object.
+ * This function collects the raw observance rules but does not expand them.
+ * @param tzComponent - The VTIMEZONE component to process.
+ * @returns A structured TimeZoneData object or undefined if the component is invalid.
+ */
+export declare function processVTimeZone(tzComponent: VComponent): {
+    tzid: string;
+    data: TimeZoneData;
+} | undefined;
+/**
+ * Creates a map of all timezone definitions from VTIMEZONE components.
+ * @param timezones - An array of VTIMEZONE components.
+ * @returns A map from TZID to structured TimeZoneData.
+ */
+export declare function buildTimeZoneData(timezones: VComponent[]): Map<string, TimeZoneData>;
+/**
+ * Expands a single TimeZoneObservance into a list of its transitions.
+ * @param observance - The observance to expand.
+ * @param rangeEnd - The end of the expansion range.
+ * @returns A list of transitions.
+ */
+export declare function expandObservanceTransitions(observance: TimeZoneObservance, rangeEnd: DateTime): TimeZoneTransition[];
+/**
+ * Finds the correct UTC offset for a given local time within a pre-processed timezone definition.
+ * This function dynamically expands recurrence rules to find the correct transition.
+ * @param localTime - The local DateTime for which to find the offset.
+ * @param tzInfo - The pre-processed timezone data.
+ * @returns The applicable UTC offset in minutes.
+ */
+export declare function findOffset(localTime: DateTime, tzInfo: TimeZoneData): number;
+/**
+ * Creates a resolver function that can determine the UTC offset for any given local time and TZID.
+ * @param tzData - The pre-built map of all timezone definitions.
+ * @returns A TimeZoneResolver function.
+ */
+export declare function createTimeZoneResolver(tzData: Map<string, TimeZoneData>): TimeZoneResolver;
+//# sourceMappingURL=timezone-processor.d.ts.map

package/dist/ics-parser/timezone-processor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timezone-processor.d.ts","sourceRoot":"","sources":["../../src/ics-parser/timezone-processor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAmB,MAAM,OAAO,CAAA;AAKjD,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,UAAU,EAChB,MAAM,YAAY,CAAA;AAQnB;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,UAAU,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,YAAY,CAAA;CAAE,GAAG,SAAS,CAiC1G;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,UAAU,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAWpF;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CAAC,UAAU,EAAE,kBAAkB,EAAE,QAAQ,EAAE,QAAQ,GAAG,kBAAkB,EAAE,CA2CpH;AAsED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,YAAY,GAAG,MAAM,CAqC5E;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,GAAG,gBAAgB,CAc1F"}

package/dist/ics-parser/timezone-processor.js

@@ -0,0 +1,219 @@
+import { DateTime, FixedOffsetZone } from 'luxon';
+import { InvalidObservanceError, TimeZoneDefinitionNotFoundError } from './errors.js';
+import { parseDateTimeList, parseOffset, parseRruleString } from './property-parsers.js';
+import { expandRrule } from './rrule-expander.js';
+import { findProperty, findProperties } from './utils.js';
+/**
+ * Buffer for expanding transitions into the future.
+ */
+const EXPANSION_RANGE_BUFFER_YEARS = 1;
+/**
+ * Processes a single VTIMEZONE component into a structured TimeZoneData object.
+ * This function collects the raw observance rules but does not expand them.
+ * @param tzComponent - The VTIMEZONE component to process.
+ * @returns A structured TimeZoneData object or undefined if the component is invalid.
+ */
+export function processVTimeZone(tzComponent) {
+    const tzidProp = findProperty(tzComponent, 'TZID');
+    if (!tzidProp)
+        return undefined;
+    const tzid = tzidProp.value;
+    const observances = [];
+    const url = findProperty(tzComponent, 'TZURL')?.value;
+    for (const sub of tzComponent.subComponents) {
+        if (sub.type !== 'STANDARD' && sub.type !== 'DAYLIGHT')
+            continue;
+        const dtstartProp = findProperty(sub, 'DTSTART');
+        const offsetToProp = findProperty(sub, 'TZOFFSETTO');
+        const offsetFromProp = findProperty(sub, 'TZOFFSETFROM');
+        // DTSTART, TZOFFSETTO, and TZOFFSETFROM are required for each observance rule.
+        if (!dtstartProp || !offsetToProp || !offsetFromProp)
+            continue;
+        observances.push({
+            dtstart: dtstartProp.value,
+            offsetTo: parseOffset(offsetToProp.value),
+            offsetFrom: parseOffset(offsetFromProp.value),
+            rrule: findProperty(sub, 'RRULE')?.value,
+            rdates: findProperties(sub, 'RDATE'),
+        });
+    }
+    // Per RFC 5545, a VTIMEZONE MUST have at least one STANDARD or DAYLIGHT sub-component.
+    if (observances.length === 0) {
+        return undefined;
+    }
+    return { tzid, data: { observances, url } };
+}
+/**
+ * Creates a map of all timezone definitions from VTIMEZONE components.
+ * @param timezones - An array of VTIMEZONE components.
+ * @returns A map from TZID to structured TimeZoneData.
+ */
+export function buildTimeZoneData(timezones) {
+    const tzData = new Map();
+    for (const tz of timezones) {
+        const processed = processVTimeZone(tz);
+        if (processed) {
+            // NOTE: For full TZURL support, one would fetch and parse the URL here
+            // if the initial `processed.data.observances` is empty or outdated.
+            tzData.set(processed.tzid, processed.data);
+        }
+    }
+    return tzData;
+}
+/**
+ * Expands a single TimeZoneObservance into a list of its transitions.
+ * @param observance - The observance to expand.
+ * @param rangeEnd - The end of the expansion range.
+ * @returns A list of transitions.
+ */
+export function expandObservanceTransitions(observance, rangeEnd) {
+    const transitions = [];
+    const localTransitionStart = DateTime.fromFormat(observance.dtstart, "yyyyMMdd'T'HHmmss", { zone: 'local' });
+    const utcTransitionStart = localTransitionStart
+        .setZone(FixedOffsetZone.instance(observance.offsetFrom), { keepLocalTime: true })
+        .toUTC();
+    // If the first transition is after our range, there are no occurrences to add.
+    if (utcTransitionStart > rangeEnd) {
+        return [];
+    }
+    // Add transitions from RRULE properties
+    if (observance.rrule) {
+        const rule = parseRruleString(observance.rrule);
+        const occurrences = expandRrule({
+            dtstart: utcTransitionStart,
+            rule,
+            rangeEnd,
+        });
+        for (const occ of occurrences) {
+            transitions.push({ transitionTime: occ, offsetTo: observance.offsetTo });
+        }
+    }
+    else {
+        // Add the primary DTSTART transition
+        transitions.push({ transitionTime: utcTransitionStart, offsetTo: observance.offsetTo });
+    }
+    // Add transitions from RDATE properties
+    for (const rdateProp of observance.rdates) {
+        for (const localRDateTime of parseDateTimeList(rdateProp)) {
+            // RDATE must be interpreted relative to the TZOFFSETFROM.
+            const utcRDateTime = localRDateTime
+                .setZone(FixedOffsetZone.instance(observance.offsetFrom), { keepLocalTime: true })
+                .toUTC();
+            if (utcRDateTime <= rangeEnd) {
+                transitions.push({ transitionTime: utcRDateTime, offsetTo: observance.offsetTo });
+            }
+        }
+    }
+    return transitions;
+}
+/**
+ * The core logic for finding an offset, assuming transitions have been pre-calculated.
+ * @private
+ */
+function findOffsetWithTransitions(localTime, tzInfo, transitions, initialOffset) {
+    // Determine potential UTC times for the given local time using all unique offsets.
+    const allOffsets = [
+        ...new Set(transitions.map((t) => t.offsetTo).concat(tzInfo.observances.map((o) => o.offsetFrom))),
+    ];
+    const potentialUTCTimes = allOffsets.map((offset) => ({
+        offset,
+        utcTime: localTime.setZone(FixedOffsetZone.instance(offset), { keepLocalTime: true }),
+    }));
+    const validInterpretations = potentialUTCTimes
+        .map(({ offset, utcTime }) => {
+        const lastTransition = transitions.filter((t) => t.transitionTime <= utcTime).pop();
+        const effectiveOffset = lastTransition ? lastTransition.offsetTo : initialOffset;
+        // A valid interpretation is when the assumed offset matches the effective offset after the transition.
+        if (effectiveOffset === offset) {
+            return { utcTime, offset };
+        }
+        return undefined;
+    })
+        .filter((v) => v !== undefined)
+        .sort((a, b) => a.utcTime.toMillis() - b.utcTime.toMillis());
+    if (validInterpretations.length === 1) {
+        return validInterpretations[0].offset; // Unambiguous time
+    }
+    if (validInterpretations.length > 1) {
+        return validInterpretations[0].offset; // Ambiguous time (fall back), use first occurrence
+    }
+    // No valid interpretations means the time is in a "gap" (spring forward).
+    // Per RFC 5545, we should use the offset from before the gap.
+    // We can find this by identifying the transition that would have just occurred.
+    // The 'correct' UTC time would be just after this transition.
+    // The earliest potential UTC time is the one calculated with the largest offset (e.g., -0400 vs -0500).
+    const earliestPotentialUTC = DateTime.max(...potentialUTCTimes.map((p) => p.utcTime));
+    const transitionBeforeGap = earliestPotentialUTC !== undefined
+        ? transitions.filter((t) => t.transitionTime <= earliestPotentialUTC).pop()
+        : undefined;
+    if (transitionBeforeGap) {
+        // We need the offset *before* this transition. We find the observance that created it.
+        for (const obs of tzInfo.observances) {
+            if (obs.offsetTo === transitionBeforeGap.offsetTo) {
+                // This is a candidate. To be more certain, we could check if transitionBeforeGap
+                // is one of the expanded dates of this observance, but that is slow.
+                // A simple heuristic is that the `offsetFrom` of this observance is the one we want.
+                return obs.offsetFrom;
+            }
+        }
+    }
+    return initialOffset; // Fallback
+}
+const transitionCache = new Map();
+/**
+ * Finds the correct UTC offset for a given local time within a pre-processed timezone definition.
+ * This function dynamically expands recurrence rules to find the correct transition.
+ * @param localTime - The local DateTime for which to find the offset.
+ * @param tzInfo - The pre-processed timezone data.
+ * @returns The applicable UTC offset in minutes.
+ */
+export function findOffset(localTime, tzInfo) {
+    if (tzInfo.observances.length === 0) {
+        throw new InvalidObservanceError();
+    }
+    const cacheKey = JSON.stringify(tzInfo.observances);
+    if (!transitionCache.has(cacheKey)) {
+        // We need a reasonable, very large range to pre-calculate all transitions we might need.
+        // Events far in the future might need this. Let's say 100 years from now.
+        const expansionRangeEnd = DateTime.now().plus({ years: 10 });
+        transitionCache.set(cacheKey, tzInfo.observances
+            .flatMap((obs) => expandObservanceTransitions(obs, expansionRangeEnd))
+            .sort((a, b) => a.transitionTime.toMillis() - b.transitionTime.toMillis()));
+    }
+    // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+    const transitions = transitionCache.get(cacheKey);
+    // Determine the offset for any time before the very first transition.
+    const getInitialOffset = () => {
+        // Find the earliest rule and use its `offsetFrom`.
+        const firstObservance = tzInfo.observances.reduce((earliest, current) => {
+            return current.dtstart < earliest.dtstart ? current : earliest;
+        });
+        return firstObservance.offsetFrom;
+    };
+    const initialOffset = getInitialOffset();
+    if (transitions.length === 0 || localTime < transitions[0].transitionTime) {
+        return initialOffset;
+    }
+    return findOffsetWithTransitions(localTime, tzInfo, transitions, initialOffset);
+}
+/**
+ * Creates a resolver function that can determine the UTC offset for any given local time and TZID.
+ * @param tzData - The pre-built map of all timezone definitions.
+ * @returns A TimeZoneResolver function.
+ */
+export function createTimeZoneResolver(tzData) {
+    return (localTime, tzid) => {
+        if (!localTime.isValid) {
+            throw new Error('Invalid input DateTime');
+        }
+        const tzInfo = tzData.get(tzid);
+        if (!tzInfo) {
+            if (Intl.supportedValuesOf('timeZone').includes(tzid)) {
+                return localTime.setZone(tzid, { keepLocalTime: true }).offset;
+            }
+            throw new TimeZoneDefinitionNotFoundError(tzid);
+        }
+        return findOffset(localTime, tzInfo);
+    };
+}
+//# sourceMappingURL=timezone-processor.js.map

package/dist/ics-parser/timezone-processor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timezone-processor.js","sourceRoot":"","sources":["../../src/ics-parser/timezone-processor.ts"],"names":[],"mappings":"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"}