@neo-reckoning/core 0.1.0-alpha.1

package/dist/events.js

@@ -0,0 +1,28 @@
+import { buildDate } from './time.js';
+/**
+ * Convert a native DateRange + one of its expanded Occurrences into a CalendarEvent.
+ */
+export function fromDateRange(range, occurrence) {
+    const start = buildDate(occurrence.date, occurrence.startTime, range.timezone);
+    let end = null;
+    if (occurrence.endTime) {
+        end = buildDate(occurrence.date, occurrence.endTime, range.timezone);
+    }
+    return {
+        id: `${range.id}:${occurrence.date}${occurrence.startTime ? `:${occurrence.startTime}` : ''}`,
+        title: range.title ?? range.label,
+        start,
+        end,
+        allDay: occurrence.allDay,
+        source: 'native',
+        sourceId: range.id,
+        editable: true,
+    };
+}
+/**
+ * Batch-convert: expand a DateRange within a window and return CalendarEvents.
+ */
+export function expandToEvents(range, occurrences) {
+    return occurrences.map(o => fromDateRange(range, o));
+}
+//# sourceMappingURL=events.js.map

package/dist/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,KAAgB,EAAE,UAAsB;IACpE,MAAM,KAAK,GAAG,SAAS,CAAC,UAAU,CAAC,IAAI,EAAE,UAAU,CAAC,SAAS,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;IAE/E,IAAI,GAAG,GAAgB,IAAI,CAAC;IAC5B,IAAI,UAAU,CAAC,OAAO,EAAE,CAAC;QACvB,GAAG,GAAG,SAAS,CAAC,UAAU,CAAC,IAAI,EAAE,UAAU,CAAC,OAAO,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;IACvE,CAAC;IAED,OAAO;QACL,EAAE,EAAE,GAAG,KAAK,CAAC,EAAE,IAAI,UAAU,CAAC,IAAI,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,UAAU,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE;QAC7F,KAAK,EAAE,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,KAAK;QACjC,KAAK;QACL,GAAG;QACH,MAAM,EAAE,UAAU,CAAC,MAAM;QACzB,MAAM,EAAE,QAAQ;QAChB,QAAQ,EAAE,KAAK,CAAC,EAAE;QAClB,QAAQ,EAAE,IAAI;KACf,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAC5B,KAAgB,EAChB,WAAyB;IAEzB,OAAO,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,aAAa,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;AACvD,CAAC"}

package/dist/grid.d.ts

@@ -0,0 +1,36 @@
+import type { CalendarGridConfig, Month, DateRange } from './types.js';
+/**
+ * CalendarGrid — generates the data structure for rendering month-based
+ * calendar views. Produces Month/Week/Day objects with range membership
+ * pre-computed for each day.
+ */
+export declare class CalendarGrid {
+    months: Month[];
+    private focusDate;
+    private numberOfMonths;
+    private ranges;
+    private weekStartsOn;
+    private locale;
+    private evaluator;
+    private fidelity;
+    constructor(config: CalendarGridConfig);
+    /** Advance focus by one month and regenerate. */
+    next(): void;
+    /** Go back one month and regenerate. */
+    prev(): void;
+    /** Jump to a specific date and regenerate. */
+    goTo(date: string): void;
+    /** Get the current focus date. */
+    getFocusDate(): string;
+    /** Update the ranges and regenerate. */
+    setRanges(ranges: DateRange[]): void;
+    private generate;
+    private generateMonth;
+    private generateWeeks;
+    private createDay;
+    private evaluateRangesForDay;
+    private formatMonthLabel;
+    private shiftMonth;
+    private shiftDay;
+}
+//# sourceMappingURL=grid.d.ts.map

package/dist/grid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grid.d.ts","sourceRoot":"","sources":["../src/grid.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kBAAkB,EAClB,KAAK,EAIL,SAAS,EAEV,MAAM,YAAY,CAAC;AASpB;;;;GAIG;AACH,qBAAa,YAAY;IACvB,MAAM,EAAE,KAAK,EAAE,CAAC;IAEhB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,SAAS,CAAiB;IAClC,OAAO,CAAC,QAAQ,CAAe;gBAEnB,MAAM,EAAE,kBAAkB;IAWtC,iDAAiD;IACjD,IAAI,IAAI,IAAI;IAKZ,wCAAwC;IACxC,IAAI,IAAI,IAAI;IAKZ,8CAA8C;IAC9C,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAKxB,kCAAkC;IAClC,YAAY,IAAI,MAAM;IAItB,wCAAwC;IACxC,SAAS,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,IAAI;IAOpC,OAAO,CAAC,QAAQ;IAehB,OAAO,CAAC,aAAa;IAOrB,OAAO,CAAC,aAAa;IA8CrB,OAAO,CAAC,SAAS;IAmCjB,OAAO,CAAC,oBAAoB;IAyB5B,OAAO,CAAC,gBAAgB;IAMxB,OAAO,CAAC,UAAU;IASlB,OAAO,CAAC,QAAQ;CAKjB"}

package/dist/grid.js

@@ -0,0 +1,177 @@
+import { RangeEvaluator } from './evaluator.js';
+import { parseDate, formatDate, daysInMonth, getToday, } from './time.js';
+/**
+ * CalendarGrid — generates the data structure for rendering month-based
+ * calendar views. Produces Month/Week/Day objects with range membership
+ * pre-computed for each day.
+ */
+export class CalendarGrid {
+    months;
+    focusDate;
+    numberOfMonths;
+    ranges;
+    weekStartsOn;
+    locale;
+    evaluator;
+    fidelity;
+    constructor(config) {
+        this.focusDate = config.focusDate;
+        this.numberOfMonths = config.numberOfMonths;
+        this.ranges = config.ranges;
+        this.weekStartsOn = config.weekStartsOn ?? 0;
+        this.locale = config.locale;
+        this.fidelity = config.fidelity ?? 'month';
+        this.evaluator = new RangeEvaluator(config.userTimezone);
+        this.months = this.generate();
+    }
+    /** Advance focus by one month and regenerate. */
+    next() {
+        this.focusDate = this.shiftMonth(this.focusDate, 1);
+        this.months = this.generate();
+    }
+    /** Go back one month and regenerate. */
+    prev() {
+        this.focusDate = this.shiftMonth(this.focusDate, -1);
+        this.months = this.generate();
+    }
+    /** Jump to a specific date and regenerate. */
+    goTo(date) {
+        this.focusDate = date;
+        this.months = this.generate();
+    }
+    /** Get the current focus date. */
+    getFocusDate() {
+        return this.focusDate;
+    }
+    /** Update the ranges and regenerate. */
+    setRanges(ranges) {
+        this.ranges = ranges;
+        this.months = this.generate();
+    }
+    // === Private ===
+    generate() {
+        const months = [];
+        const { year, month } = parseDate(this.focusDate);
+        const today = getToday();
+        for (let i = 0; i < this.numberOfMonths; i++) {
+            const d = new Date(year, month + i, 1);
+            const m = d.getMonth();
+            const y = d.getFullYear();
+            months.push(this.generateMonth(y, m, today));
+        }
+        return months;
+    }
+    generateMonth(year, month, today) {
+        const label = this.formatMonthLabel(year, month);
+        const weeks = this.generateWeeks(year, month, today);
+        return { year, month, label, weeks };
+    }
+    generateWeeks(year, month, today) {
+        const weeks = [];
+        const totalDays = daysInMonth(year, month);
+        // Find the weekday of the 1st (0=Sun, 6=Sat)
+        const firstDayOfMonth = new Date(year, month, 1).getDay();
+        // How many leading days from the previous month
+        const leadingDays = (firstDayOfMonth - this.weekStartsOn + 7) % 7;
+        // Build all day cells needed
+        const dayCells = [];
+        // Previous month padding
+        const prevMonth = month === 0 ? 11 : month - 1;
+        const prevYear = month === 0 ? year - 1 : year;
+        const prevMonthDays = daysInMonth(prevYear, prevMonth);
+        for (let i = leadingDays - 1; i >= 0; i--) {
+            const day = prevMonthDays - i;
+            const dateStr = formatDate(new Date(prevYear, prevMonth, day));
+            dayCells.push(this.createDay(dateStr, day, false, today));
+        }
+        // Current month
+        for (let day = 1; day <= totalDays; day++) {
+            const dateStr = formatDate(new Date(year, month, day));
+            dayCells.push(this.createDay(dateStr, day, true, today));
+        }
+        // Next month padding — fill to complete weeks
+        const nextMonth = month === 11 ? 0 : month + 1;
+        const nextYear = month === 11 ? year + 1 : year;
+        let nextDay = 1;
+        while (dayCells.length % 7 !== 0) {
+            const dateStr = formatDate(new Date(nextYear, nextMonth, nextDay));
+            dayCells.push(this.createDay(dateStr, nextDay, false, today));
+            nextDay++;
+        }
+        // Chunk into weeks
+        for (let i = 0; i < dayCells.length; i += 7) {
+            weeks.push({ days: dayCells.slice(i, i + 7) });
+        }
+        return weeks;
+    }
+    createDay(dateStr, dayOfMonth, isCurrentMonth, today) {
+        const fidelity = this.fidelity;
+        if (fidelity === 'year') {
+            // Year fidelity: only compute hasActivity, skip ranges[] and timeSlots[]
+            const hasActivity = this.ranges.some(r => this.evaluator.isDateInRange(dateStr, r));
+            return {
+                date: dateStr,
+                dayOfMonth,
+                isCurrentMonth,
+                isToday: dateStr === today,
+                ranges: [],
+                timeSlots: [],
+                hasActivity,
+            };
+        }
+        // Month, week, and day fidelity: compute ranges[]
+        const ranges = this.evaluateRangesForDay(dateStr);
+        // Week and day fidelity: also compute timeSlots[]
+        const timeSlots = (fidelity === 'week' || fidelity === 'day')
+            ? this.ranges.flatMap(r => this.evaluator.expandDay(r, dateStr))
+            : [];
+        return {
+            date: dateStr,
+            dayOfMonth,
+            isCurrentMonth,
+            isToday: dateStr === today,
+            ranges,
+            timeSlots,
+        };
+    }
+    evaluateRangesForDay(dateStr) {
+        const infos = [];
+        for (const range of this.ranges) {
+            if (!this.evaluator.isDateInRange(dateStr, range))
+                continue;
+            // Check contiguous span boundaries
+            const prevDate = this.shiftDay(dateStr, -1);
+            const nextDate = this.shiftDay(dateStr, 1);
+            const prevInRange = this.evaluator.isDateInRange(prevDate, range);
+            const nextInRange = this.evaluator.isDateInRange(nextDate, range);
+            infos.push({
+                rangeId: range.id,
+                label: range.label,
+                isStart: !prevInRange,
+                isEnd: !nextInRange,
+                isContinuation: prevInRange && nextInRange,
+                ...(range.displayType !== undefined ? { displayType: range.displayType } : {}),
+            });
+        }
+        return infos;
+    }
+    formatMonthLabel(year, month) {
+        const date = new Date(year, month, 1);
+        const options = { year: 'numeric', month: 'long' };
+        return new Intl.DateTimeFormat(this.locale, options).format(date);
+    }
+    shiftMonth(dateStr, delta) {
+        const { year, month, day } = parseDate(dateStr);
+        const d = new Date(year, month + delta, 1);
+        // Clamp day to the new month's max
+        const maxDay = daysInMonth(d.getFullYear(), d.getMonth());
+        d.setDate(Math.min(day, maxDay));
+        return formatDate(d);
+    }
+    shiftDay(dateStr, delta) {
+        const { year, month, day } = parseDate(dateStr);
+        const d = new Date(year, month, day + delta);
+        return formatDate(d);
+    }
+}
+//# sourceMappingURL=grid.js.map

package/dist/grid.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"grid.js","sourceRoot":"","sources":["../src/grid.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EACL,SAAS,EACT,UAAU,EACV,WAAW,EACX,QAAQ,GACT,MAAM,WAAW,CAAC;AAEnB;;;;GAIG;AACH,MAAM,OAAO,YAAY;IACvB,MAAM,CAAU;IAER,SAAS,CAAS;IAClB,cAAc,CAAS;IACvB,MAAM,CAAc;IACpB,YAAY,CAAS;IACrB,MAAM,CAAqB;IAC3B,SAAS,CAAiB;IAC1B,QAAQ,CAAe;IAE/B,YAAY,MAA0B;QACpC,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC;QAClC,IAAI,CAAC,cAAc,GAAG,MAAM,CAAC,cAAc,CAAC;QAC5C,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;QAC5B,IAAI,CAAC,YAAY,GAAG,MAAM,CAAC,YAAY,IAAI,CAAC,CAAC;QAC7C,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;QAC5B,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,IAAI,OAAO,CAAC;QAC3C,IAAI,CAAC,SAAS,GAAG,IAAI,cAAc,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;QACzD,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;IAChC,CAAC;IAED,iDAAiD;IACjD,IAAI;QACF,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;QACpD,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;IAChC,CAAC;IAED,wCAAwC;IACxC,IAAI;QACF,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,CAAC;QACrD,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;IAChC,CAAC;IAED,8CAA8C;IAC9C,IAAI,CAAC,IAAY;QACf,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QACtB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;IAChC,CAAC;IAED,kCAAkC;IAClC,YAAY;QACV,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAED,wCAAwC;IACxC,SAAS,CAAC,MAAmB;QAC3B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;IAChC,CAAC;IAED,kBAAkB;IAEV,QAAQ;QACd,MAAM,MAAM,GAAY,EAAE,CAAC;QAC3B,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAClD,MAAM,KAAK,GAAG,QAAQ,EAAE,CAAC;QAEzB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,cAAc,EAAE,CAAC,EAAE,EAAE,CAAC;YAC7C,MAAM,CAAC,GAAG,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;YACvC,MAAM,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC;YACvB,MAAM,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;YAC1B,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;QAC/C,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAEO,aAAa,CAAC,IAAY,EAAE,KAAa,EAAE,KAAa;QAC9D,MAAM,KAAK,GAAG,IAAI,CAAC,gBAAgB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QACjD,MAAM,KAAK,GAAG,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;QAErD,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;IACvC,CAAC;IAEO,aAAa,CAAC,IAAY,EAAE,KAAa,EAAE,KAAa;QAC9D,MAAM,KAAK,GAAW,EAAE,CAAC;QACzB,MAAM,SAAS,GAAG,WAAW,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAE3C,6CAA6C;QAC7C,MAAM,eAAe,GAAG,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;QAC1D,gDAAgD;QAChD,MAAM,WAAW,GAAG,CAAC,eAAe,GAAG,IAAI,CAAC,YAAY,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;QAElE,6BAA6B;QAC7B,MAAM,QAAQ,GAAU,EAAE,CAAC;QAE3B,yBAAyB;QACzB,MAAM,SAAS,GAAG,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC;QAC/C,MAAM,QAAQ,GAAG,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAC/C,MAAM,aAAa,GAAG,WAAW,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;QACvD,KAAK,IAAI,CAAC,GAAG,WAAW,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YAC1C,MAAM,GAAG,GAAG,aAAa,GAAG,CAAC,CAAC;YAC9B,MAAM,OAAO,GAAG,UAAU,CAAC,IAAI,IAAI,CAAC,QAAQ,EAAE,SAAS,EAAE,GAAG,CAAC,CAAC,CAAC;YAC/D,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;QAC5D,CAAC;QAED,gBAAgB;QAChB,KAAK,IAAI,GAAG,GAAG,CAAC,EAAE,GAAG,IAAI,SAAS,EAAE,GAAG,EAAE,EAAE,CAAC;YAC1C,MAAM,OAAO,GAAG,UAAU,CAAC,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC;YACvD,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;QAC3D,CAAC;QAED,8CAA8C;QAC9C,MAAM,SAAS,GAAG,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC;QAC/C,MAAM,QAAQ,GAAG,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAChD,IAAI,OAAO,GAAG,CAAC,CAAC;QAChB,OAAO,QAAQ,CAAC,MAAM,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YACjC,MAAM,OAAO,GAAG,UAAU,CAAC,IAAI,IAAI,CAAC,QAAQ,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC;YACnE,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;YAC9D,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,mBAAmB;QACnB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;YAC5C,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC;QACjD,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;IAEO,SAAS,CAAC,OAAe,EAAE,UAAkB,EAAE,cAAuB,EAAE,KAAa;QAC3F,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;QAE/B,IAAI,QAAQ,KAAK,MAAM,EAAE,CAAC;YACxB,yEAAyE;YACzE,MAAM,WAAW,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC;YACpF,OAAO;gBACL,IAAI,EAAE,OAAO;gBACb,UAAU;gBACV,cAAc;gBACd,OAAO,EAAE,OAAO,KAAK,KAAK;gBAC1B,MAAM,EAAE,EAAE;gBACV,SAAS,EAAE,EAAE;gBACb,WAAW;aACZ,CAAC;QACJ,CAAC;QAED,kDAAkD;QAClD,MAAM,MAAM,GAAG,IAAI,CAAC,oBAAoB,CAAC,OAAO,CAAC,CAAC;QAElD,kDAAkD;QAClD,MAAM,SAAS,GAAG,CAAC,QAAQ,KAAK,MAAM,IAAI,QAAQ,KAAK,KAAK,CAAC;YAC3D,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;YAChE,CAAC,CAAC,EAAE,CAAC;QAEP,OAAO;YACL,IAAI,EAAE,OAAO;YACb,UAAU;YACV,cAAc;YACd,OAAO,EAAE,OAAO,KAAK,KAAK;YAC1B,MAAM;YACN,SAAS;SACV,CAAC;IACJ,CAAC;IAEO,oBAAoB,CAAC,OAAe;QAC1C,MAAM,KAAK,GAAmB,EAAE,CAAC;QAEjC,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,OAAO,EAAE,KAAK,CAAC;gBAAE,SAAS;YAE5D,mCAAmC;YACnC,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC;YAC5C,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;YAC3C,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;YAClE,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;YAElE,KAAK,CAAC,IAAI,CAAC;gBACT,OAAO,EAAE,KAAK,CAAC,EAAE;gBACjB,KAAK,EAAE,KAAK,CAAC,KAAK;gBAClB,OAAO,EAAE,CAAC,WAAW;gBACrB,KAAK,EAAE,CAAC,WAAW;gBACnB,cAAc,EAAE,WAAW,IAAI,WAAW;gBAC1C,GAAG,CAAC,KAAK,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC/E,CAAC,CAAC;QACL,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;IAEO,gBAAgB,CAAC,IAAY,EAAE,KAAa;QAClD,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;QACtC,MAAM,OAAO,GAA+B,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;QAC/E,OAAO,IAAI,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACpE,CAAC;IAEO,UAAU,CAAC,OAAe,EAAE,KAAa;QAC/C,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;QAChD,MAAM,CAAC,GAAG,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC;QAC3C,mCAAmC;QACnC,MAAM,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC;QAC1D,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC;QACjC,OAAO,UAAU,CAAC,CAAC,CAAC,CAAC;IACvB,CAAC;IAEO,QAAQ,CAAC,OAAe,EAAE,KAAa;QAC7C,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;QAChD,MAAM,CAAC,GAAG,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,GAAG,KAAK,CAAC,CAAC;QAC7C,OAAO,UAAU,CAAC,CAAC,CAAC,CAAC;IACvB,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export type { DateRange, Occurrence, TimeSlot, DayRangeInfo, SpanInfo, Day, Week, Month, CalendarEvent, PositionedEvent, TimelineSlot, CalendarGridConfig, TimelineGridConfig, CacheAdapter, ViewFidelity, DisplayType, YearGridConfig, YearMonth, YearDay, Conflict, FreeSlot, ScheduleScore, } from './types.js';
+export { RangeEvaluator } from './evaluator.js';
+export { CalendarGrid } from './grid.js';
+export { TimelineGrid, computeEventPositions } from './timeline.js';
+export { YearGrid } from './yearGrid.js';
+export { scoreSchedule } from './scoring.js';
+export { resolveDisplayType } from './displayType.js';
+export { fromDateRange, expandToEvents } from './events.js';
+export { parseTime, formatTime, timeToMinutes, minutesToTime, parseDate, formatDate, getDayOfWeek, daysInMonth, dateRange, getToday, convertTime, buildDate, } from './time.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,YAAY,EACV,SAAS,EACT,UAAU,EACV,QAAQ,EACR,YAAY,EACZ,QAAQ,EACR,GAAG,EACH,IAAI,EACJ,KAAK,EACL,aAAa,EACb,eAAe,EACf,YAAY,EACZ,kBAAkB,EAClB,kBAAkB,EAClB,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,cAAc,EACd,SAAS,EACT,OAAO,EACP,QAAQ,EACR,QAAQ,EACR,aAAa,GACd,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACpE,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAGzC,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAG7C,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAGtD,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAG5D,OAAO,EACL,SAAS,EACT,UAAU,EACV,aAAa,EACb,aAAa,EACb,SAAS,EACT,UAAU,EACV,YAAY,EACZ,WAAW,EACX,SAAS,EACT,QAAQ,EACR,WAAW,EACX,SAAS,GACV,MAAM,WAAW,CAAC"}

package/dist/index.js

@@ -0,0 +1,14 @@
+// Core classes
+export { RangeEvaluator } from './evaluator.js';
+export { CalendarGrid } from './grid.js';
+export { TimelineGrid, computeEventPositions } from './timeline.js';
+export { YearGrid } from './yearGrid.js';
+// Schedule scoring
+export { scoreSchedule } from './scoring.js';
+// Display type resolution
+export { resolveDisplayType } from './displayType.js';
+// Event normalization
+export { fromDateRange, expandToEvents } from './events.js';
+// Time utilities (exposed for consumers that need them)
+export { parseTime, formatTime, timeToMinutes, minutesToTime, parseDate, formatDate, getDayOfWeek, daysInMonth, dateRange, getToday, convertTime, buildDate, } from './time.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AA0BA,eAAe;AACf,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACpE,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC,mBAAmB;AACnB,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C,0BAA0B;AAC1B,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAEtD,sBAAsB;AACtB,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE5D,wDAAwD;AACxD,OAAO,EACL,SAAS,EACT,UAAU,EACV,aAAa,EACb,aAAa,EACb,SAAS,EACT,UAAU,EACV,YAAY,EACZ,WAAW,EACX,SAAS,EACT,QAAQ,EACR,WAAW,EACX,SAAS,GACV,MAAM,WAAW,CAAC"}

package/dist/scoring.d.ts

@@ -0,0 +1,14 @@
+import type { DateRange, ScheduleScore } from './types.js';
+import { RangeEvaluator } from './evaluator.js';
+/**
+ * Score a schedule across a date window.
+ *
+ * Analyses conflicts, free time, focus blocks, and context switches
+ * for a set of DateRanges evaluated within [from, to].
+ */
+export declare function scoreSchedule(evaluator: RangeEvaluator, ranges: DateRange[], from: Date, to: Date, options?: {
+    focusBlockMinutes?: number;
+    dayStart?: string;
+    dayEnd?: string;
+}): ScheduleScore;
+//# sourceMappingURL=scoring.d.ts.map

package/dist/scoring.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scoring.d.ts","sourceRoot":"","sources":["../src/scoring.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAY,MAAM,YAAY,CAAC;AACrE,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAGhD;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,SAAS,EAAE,cAAc,EACzB,MAAM,EAAE,SAAS,EAAE,EACnB,IAAI,EAAE,IAAI,EACV,EAAE,EAAE,IAAI,EACR,OAAO,CAAC,EAAE;IACR,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GACA,aAAa,CAiGf"}

package/dist/scoring.js

@@ -0,0 +1,152 @@
+import { RangeEvaluator } from './evaluator.js';
+import { formatDate, dateRange, timeToMinutes } from './time.js';
+/**
+ * Score a schedule across a date window.
+ *
+ * Analyses conflicts, free time, focus blocks, and context switches
+ * for a set of DateRanges evaluated within [from, to].
+ */
+export function scoreSchedule(evaluator, ranges, from, to, options) {
+    const focusBlockMinutes = options?.focusBlockMinutes ?? 60;
+    const dayStartMin = timeToMinutes(options?.dayStart ?? '09:00');
+    const dayEndMin = timeToMinutes(options?.dayEnd ?? '17:00');
+    const fromStr = formatDate(from);
+    const toStr = formatDate(to);
+    const days = dateRange(fromStr, toStr);
+    let totalConflicts = 0;
+    let totalFreeMinutes = 0;
+    let totalFocusBlocks = 0;
+    let totalContextSwitches = 0;
+    let conflictDays = 0;
+    for (const day of days) {
+        // Gather all time slots for this day across all ranges
+        const allSlots = [];
+        for (const range of ranges) {
+            if (!evaluator.isDateInRange(day, range))
+                continue;
+            const slots = evaluator.getTimeSlots(day, range);
+            if (slots.length > 0) {
+                allSlots.push(...slots);
+            }
+        }
+        // Sort slots by start time
+        allSlots.sort((a, b) => timeToMinutes(a.startTime) - timeToMinutes(b.startTime));
+        // --- Conflicts ---
+        // Count pairs of slots that overlap in time
+        let dayHasConflict = false;
+        for (let i = 0; i < allSlots.length; i++) {
+            const slotAStart = timeToMinutes(allSlots[i].startTime);
+            const slotAEnd = allSlots[i].endTime
+                ? timeToMinutes(allSlots[i].endTime)
+                : slotAStart + (allSlots[i].duration ?? 0);
+            if (slotAEnd <= slotAStart)
+                continue; // skip point-in-time
+            for (let j = i + 1; j < allSlots.length; j++) {
+                const slotBStart = timeToMinutes(allSlots[j].startTime);
+                const slotBEnd = allSlots[j].endTime
+                    ? timeToMinutes(allSlots[j].endTime)
+                    : slotBStart + (allSlots[j].duration ?? 0);
+                if (slotBEnd <= slotBStart)
+                    continue;
+                // Since sorted by start, slotBStart >= slotAStart
+                if (slotBStart < slotAEnd) {
+                    totalConflicts++;
+                    dayHasConflict = true;
+                }
+            }
+        }
+        if (dayHasConflict)
+            conflictDays++;
+        // --- Build merged occupied intervals within working hours ---
+        const occupied = mergeIntervals(allSlots, dayStartMin, dayEndMin);
+        // --- Free time = working hours minus occupied ---
+        const workingMinutes = dayEndMin - dayStartMin;
+        let occupiedMinutes = 0;
+        for (const [s, e] of occupied) {
+            occupiedMinutes += e - s;
+        }
+        const freeMinutes = workingMinutes - occupiedMinutes;
+        totalFreeMinutes += freeMinutes;
+        // --- Focus blocks: gaps within working hours >= focusBlockMinutes ---
+        const gaps = computeGaps(occupied, dayStartMin, dayEndMin);
+        for (const [s, e] of gaps) {
+            if (e - s >= focusBlockMinutes) {
+                totalFocusBlocks++;
+            }
+        }
+        // --- Context switches ---
+        // Transitions between different rangeIds in chronological order
+        let switches = 0;
+        let lastRangeId = null;
+        for (const slot of allSlots) {
+            if (lastRangeId !== null && slot.rangeId !== lastRangeId) {
+                switches++;
+            }
+            lastRangeId = slot.rangeId;
+        }
+        totalContextSwitches += switches;
+    }
+    const avgContextSwitches = days.length > 0 ? totalContextSwitches / days.length : 0;
+    return {
+        conflicts: totalConflicts,
+        freeMinutes: totalFreeMinutes,
+        focusBlocks: totalFocusBlocks,
+        avgContextSwitches,
+        conflictDays,
+    };
+}
+/**
+ * Merge time slots into non-overlapping intervals, clipped to [dayStart, dayEnd].
+ * Returns sorted array of [start, end] minute pairs.
+ */
+function mergeIntervals(slots, dayStartMin, dayEndMin) {
+    // Convert to minute intervals, clipped to working hours
+    const intervals = [];
+    for (const slot of slots) {
+        const start = timeToMinutes(slot.startTime);
+        const end = slot.endTime
+            ? timeToMinutes(slot.endTime)
+            : start + (slot.duration ?? 0);
+        if (end <= start)
+            continue; // skip zero-length
+        const clippedStart = Math.max(start, dayStartMin);
+        const clippedEnd = Math.min(end, dayEndMin);
+        if (clippedStart < clippedEnd) {
+            intervals.push([clippedStart, clippedEnd]);
+        }
+    }
+    if (intervals.length === 0)
+        return [];
+    // Sort by start
+    intervals.sort((a, b) => a[0] - b[0]);
+    // Merge overlapping
+    const merged = [intervals[0]];
+    for (let i = 1; i < intervals.length; i++) {
+        const last = merged[merged.length - 1];
+        if (intervals[i][0] <= last[1]) {
+            last[1] = Math.max(last[1], intervals[i][1]);
+        }
+        else {
+            merged.push(intervals[i]);
+        }
+    }
+    return merged;
+}
+/**
+ * Compute gaps between merged intervals within [dayStart, dayEnd].
+ */
+function computeGaps(merged, dayStartMin, dayEndMin) {
+    const gaps = [];
+    let cursor = dayStartMin;
+    for (const [s, e] of merged) {
+        if (s > cursor) {
+            gaps.push([cursor, s]);
+        }
+        cursor = Math.max(cursor, e);
+    }
+    if (cursor < dayEndMin) {
+        gaps.push([cursor, dayEndMin]);
+    }
+    return gaps;
+}
+//# sourceMappingURL=scoring.js.map

package/dist/scoring.js.map

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

package/dist/time.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Internal time/date utilities for neo-reckoning.
+ * Uses Intl.DateTimeFormat for timezone conversion — no external dependencies.
+ */
+/** Parse "HH:mm" into { hour, minute } */
+export declare function parseTime(time: string): {
+    hour: number;
+    minute: number;
+};
+/** Format { hour, minute } into "HH:mm" */
+export declare function formatTime(hour: number, minute: number): string;
+/** Convert minutes since midnight to "HH:mm" */
+export declare function minutesToTime(minutes: number): string;
+/** Convert "HH:mm" to minutes since midnight */
+export declare function timeToMinutes(time: string): number;
+/** Add minutes to a time string, clamping at 24:00. Returns null if result >= 24:00. */
+export declare function addMinutes(time: string, minutes: number): string | null;
+/** Parse "YYYY-MM-DD" into { year, month, day } */
+export declare function parseDate(date: string): {
+    year: number;
+    month: number;
+    day: number;
+};
+/** Format a Date to "YYYY-MM-DD" */
+export declare function formatDate(date: Date): string;
+/** Get the day of week (0=Sunday) for a "YYYY-MM-DD" string */
+export declare function getDayOfWeek(dateStr: string): number;
+/** Get the number of days in a given month (0-indexed month) */
+export declare function daysInMonth(year: number, month: number): number;
+/** Compare two "YYYY-MM-DD" strings. Returns -1, 0, or 1. */
+export declare function compareDates(a: string, b: string): number;
+/** Generate all dates (as "YYYY-MM-DD") between from and to, inclusive. */
+export declare function dateRange(from: string, to: string): string[];
+/** Get today's date as "YYYY-MM-DD" in a given timezone (or local if not specified). */
+export declare function getToday(timezone?: string): string;
+/**
+ * Format a Date as "YYYY-MM-DD" in a specific timezone using Intl.DateTimeFormat.
+ */
+export declare function formatDateInTimezone(date: Date, timezone: string): string;
+/**
+ * Get the hour and minute of a Date in a specific timezone.
+ */
+export declare function getTimeInTimezone(date: Date, timezone: string): {
+    hour: number;
+    minute: number;
+};
+/**
+ * Convert a time from one timezone to another on a given date.
+ * Returns the converted time as "HH:mm", or null if the time doesn't exist
+ * (e.g., spring-forward DST gap).
+ */
+export declare function convertTime(dateStr: string, time: string, fromTimezone: string, toTimezone: string): string | null;
+/**
+ * Build a Date object from a date string and time string in a given timezone.
+ * If timezone is null/undefined (floating), uses local time.
+ */
+export declare function buildDate(dateStr: string, time: string | null, timezone?: string | null): Date;
+//# sourceMappingURL=time.d.ts.map

package/dist/time.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"time.d.ts","sourceRoot":"","sources":["../src/time.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,0CAA0C;AAC1C,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAGxE;AAED,2CAA2C;AAC3C,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAE/D;AAED,gDAAgD;AAChD,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAIrD;AAED,gDAAgD;AAChD,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGlD;AAED,wFAAwF;AACxF,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAIvE;AAED,mDAAmD;AACnD,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAGpF;AAED,oCAAoC;AACpC,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAK7C;AAED,+DAA+D;AAC/D,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAGpD;AAED,gEAAgE;AAChE,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAE/D;AAED,6DAA6D;AAC7D,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAIzD;AAED,2EAA2E;AAC3E,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE,CAc5D;AAED,wFAAwF;AACxF,wBAAgB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAKlD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CASzE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAWhG;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CACzB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,GACjB,MAAM,GAAG,IAAI,CAyBf;AAcD;;;GAGG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAsB9F"}