@neo-reckoning/core 0.1.0-alpha.1

package/dist/time.js

@@ -0,0 +1,169 @@
+/**
+ * Internal time/date utilities for neo-reckoning.
+ * Uses Intl.DateTimeFormat for timezone conversion — no external dependencies.
+ */
+/** Parse "HH:mm" into { hour, minute } */
+export function parseTime(time) {
+    const [h, m] = time.split(':').map(Number);
+    return { hour: h, minute: m };
+}
+/** Format { hour, minute } into "HH:mm" */
+export function formatTime(hour, minute) {
+    return `${String(hour).padStart(2, '0')}:${String(minute).padStart(2, '0')}`;
+}
+/** Convert minutes since midnight to "HH:mm" */
+export function minutesToTime(minutes) {
+    const h = Math.floor(minutes / 60);
+    const m = minutes % 60;
+    return formatTime(h, m);
+}
+/** Convert "HH:mm" to minutes since midnight */
+export function timeToMinutes(time) {
+    const { hour, minute } = parseTime(time);
+    return hour * 60 + minute;
+}
+/** Add minutes to a time string, clamping at 24:00. Returns null if result >= 24:00. */
+export function addMinutes(time, minutes) {
+    const total = timeToMinutes(time) + minutes;
+    if (total >= 1440)
+        return null; // past midnight
+    return minutesToTime(total);
+}
+/** Parse "YYYY-MM-DD" into { year, month, day } */
+export function parseDate(date) {
+    const [y, m, d] = date.split('-').map(Number);
+    return { year: y, month: m - 1, day: d }; // month is 0-indexed like JS Date
+}
+/** Format a Date to "YYYY-MM-DD" */
+export function formatDate(date) {
+    const y = date.getFullYear();
+    const m = String(date.getMonth() + 1).padStart(2, '0');
+    const d = String(date.getDate()).padStart(2, '0');
+    return `${y}-${m}-${d}`;
+}
+/** Get the day of week (0=Sunday) for a "YYYY-MM-DD" string */
+export function getDayOfWeek(dateStr) {
+    const { year, month, day } = parseDate(dateStr);
+    return new Date(year, month, day).getDay();
+}
+/** Get the number of days in a given month (0-indexed month) */
+export function daysInMonth(year, month) {
+    return new Date(year, month + 1, 0).getDate();
+}
+/** Compare two "YYYY-MM-DD" strings. Returns -1, 0, or 1. */
+export function compareDates(a, b) {
+    if (a < b)
+        return -1;
+    if (a > b)
+        return 1;
+    return 0;
+}
+/** Generate all dates (as "YYYY-MM-DD") between from and to, inclusive. */
+export function dateRange(from, to) {
+    const dates = [];
+    const { year: fy, month: fm, day: fd } = parseDate(from);
+    const { year: ty, month: tm, day: td } = parseDate(to);
+    const start = new Date(fy, fm, fd);
+    const end = new Date(ty, tm, td);
+    const current = new Date(start);
+    while (current <= end) {
+        dates.push(formatDate(current));
+        current.setDate(current.getDate() + 1);
+    }
+    return dates;
+}
+/** Get today's date as "YYYY-MM-DD" in a given timezone (or local if not specified). */
+export function getToday(timezone) {
+    if (timezone) {
+        return formatDateInTimezone(new Date(), timezone);
+    }
+    return formatDate(new Date());
+}
+/**
+ * Format a Date as "YYYY-MM-DD" in a specific timezone using Intl.DateTimeFormat.
+ */
+export function formatDateInTimezone(date, timezone) {
+    const formatter = new Intl.DateTimeFormat('en-CA', {
+        timeZone: timezone,
+        year: 'numeric',
+        month: '2-digit',
+        day: '2-digit',
+    });
+    // en-CA gives YYYY-MM-DD format
+    return formatter.format(date);
+}
+/**
+ * Get the hour and minute of a Date in a specific timezone.
+ */
+export function getTimeInTimezone(date, timezone) {
+    const formatter = new Intl.DateTimeFormat('en-US', {
+        timeZone: timezone,
+        hour: 'numeric',
+        minute: 'numeric',
+        hour12: false,
+    });
+    const parts = formatter.formatToParts(date);
+    const hour = Number(parts.find(p => p.type === 'hour')?.value ?? 0);
+    const minute = Number(parts.find(p => p.type === 'minute')?.value ?? 0);
+    return { hour, minute };
+}
+/**
+ * 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 function convertTime(dateStr, time, fromTimezone, toTimezone) {
+    if (fromTimezone === toTimezone)
+        return time;
+    const { year, month, day } = parseDate(dateStr);
+    const { hour, minute } = parseTime(time);
+    // Create a Date in the source timezone by using a known UTC offset approach.
+    // We build a UTC date then adjust based on the source timezone offset.
+    const utcDate = new Date(Date.UTC(year, month, day, hour, minute));
+    // Get the offset of the source timezone at this time
+    const sourceOffset = getTimezoneOffset(utcDate, fromTimezone);
+    // Adjust to actual UTC
+    const actualUtc = new Date(utcDate.getTime() + sourceOffset * 60000);
+    // Now get the time in the target timezone
+    const targetTime = getTimeInTimezone(actualUtc, toTimezone);
+    // Check if the source time actually exists (DST spring-forward gap)
+    const verifyTime = getTimeInTimezone(actualUtc, fromTimezone);
+    if (verifyTime.hour !== hour || verifyTime.minute !== minute) {
+        return null; // Time doesn't exist in source timezone (DST gap)
+    }
+    return formatTime(targetTime.hour, targetTime.minute);
+}
+/**
+ * Get the UTC offset of a timezone in minutes at a given instant.
+ * Positive means behind UTC (e.g., UTC-5 returns 300).
+ */
+function getTimezoneOffset(date, timezone) {
+    const utcStr = date.toLocaleString('en-US', { timeZone: 'UTC' });
+    const tzStr = date.toLocaleString('en-US', { timeZone: timezone });
+    const utcDate = new Date(utcStr);
+    const tzDate = new Date(tzStr);
+    return (utcDate.getTime() - tzDate.getTime()) / 60000;
+}
+/**
+ * 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 function buildDate(dateStr, time, timezone) {
+    const { year, month, day } = parseDate(dateStr);
+    if (!time) {
+        return new Date(year, month, day);
+    }
+    const { hour, minute } = parseTime(time);
+    if (!timezone) {
+        // Floating — local time
+        return new Date(year, month, day, hour, minute);
+    }
+    if (timezone === 'UTC') {
+        return new Date(Date.UTC(year, month, day, hour, minute));
+    }
+    // Specific timezone — build via UTC offset
+    const utcGuess = new Date(Date.UTC(year, month, day, hour, minute));
+    const offset = getTimezoneOffset(utcGuess, timezone);
+    return new Date(utcGuess.getTime() + offset * 60000);
+}
+//# sourceMappingURL=time.js.map

package/dist/time.js.map

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

package/dist/timeline.d.ts

@@ -0,0 +1,24 @@
+import type { TimelineGridConfig, TimelineSlot, PositionedEvent, CalendarEvent } from './types.js';
+/**
+ * TimelineGrid — produces the data structure for rendering hourly/timeline
+ * day views. Handles event positioning including overlap detection for
+ * side-by-side concurrent events.
+ */
+export declare class TimelineGrid {
+    slots: TimelineSlot[];
+    private date;
+    private startHour;
+    private endHour;
+    private intervalMinutes;
+    private events;
+    constructor(config: TimelineGridConfig);
+    private generate;
+    private getEventStartMinutes;
+    private getEventEndMinutes;
+}
+/**
+ * Compute positioned events with column assignments for overlapping events.
+ * Uses a greedy column-assignment algorithm.
+ */
+export declare function computeEventPositions(events: CalendarEvent[], startHour?: number, endHour?: number): PositionedEvent[];
+//# sourceMappingURL=timeline.d.ts.map

package/dist/timeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeline.d.ts","sourceRoot":"","sources":["../src/timeline.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kBAAkB,EAClB,YAAY,EACZ,eAAe,EACf,aAAa,EACd,MAAM,YAAY,CAAC;AAGpB;;;;GAIG;AACH,qBAAa,YAAY;IACvB,KAAK,EAAE,YAAY,EAAE,CAAC;IAEtB,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,MAAM,CAAkB;gBAEpB,MAAM,EAAE,kBAAkB;IAStC,OAAO,CAAC,QAAQ;IAsChB,OAAO,CAAC,oBAAoB;IAI5B,OAAO,CAAC,kBAAkB;CAO3B;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,aAAa,EAAE,EACvB,SAAS,GAAE,MAAU,EACrB,OAAO,GAAE,MAAW,GACnB,eAAe,EAAE,CA8EnB"}

package/dist/timeline.js

@@ -0,0 +1,158 @@
+import { formatTime, timeToMinutes } from './time.js';
+/**
+ * TimelineGrid — produces the data structure for rendering hourly/timeline
+ * day views. Handles event positioning including overlap detection for
+ * side-by-side concurrent events.
+ */
+export class TimelineGrid {
+    slots;
+    date;
+    startHour;
+    endHour;
+    intervalMinutes;
+    events;
+    constructor(config) {
+        this.date = config.date;
+        this.startHour = config.startHour ?? 0;
+        this.endHour = config.endHour ?? 24;
+        this.intervalMinutes = config.intervalMinutes ?? 60;
+        this.events = config.events;
+        this.slots = this.generate();
+    }
+    generate() {
+        const slots = [];
+        const positioned = computeEventPositions(this.events, this.startHour, this.endHour);
+        const totalMinutes = (this.endHour - this.startHour) * 60;
+        let currentMinutes = this.startHour * 60;
+        const endMinutes = this.endHour * 60;
+        while (currentMinutes < endMinutes) {
+            const hour = Math.floor(currentMinutes / 60);
+            const minute = currentMinutes % 60;
+            const time = formatTime(hour, minute);
+            // Find events that overlap this slot
+            const slotEnd = currentMinutes + this.intervalMinutes;
+            const overlapping = positioned.filter(pe => {
+                const eventStart = this.getEventStartMinutes(pe.event);
+                const eventEnd = this.getEventEndMinutes(pe.event);
+                return eventStart < slotEnd && eventEnd > currentMinutes;
+            });
+            slots.push({
+                time,
+                hour,
+                minute,
+                events: overlapping,
+            });
+            currentMinutes += this.intervalMinutes;
+        }
+        return slots;
+    }
+    getEventStartMinutes(event) {
+        return event.start.getHours() * 60 + event.start.getMinutes();
+    }
+    getEventEndMinutes(event) {
+        if (event.end) {
+            return event.end.getHours() * 60 + event.end.getMinutes();
+        }
+        // Default to 30 minutes if no end time
+        return this.getEventStartMinutes(event) + 30;
+    }
+}
+/**
+ * Compute positioned events with column assignments for overlapping events.
+ * Uses a greedy column-assignment algorithm.
+ */
+export function computeEventPositions(events, startHour = 0, endHour = 24) {
+    if (events.length === 0)
+        return [];
+    const totalMinutes = (endHour - startHour) * 60;
+    const timelineStart = startHour * 60;
+    // Sort by start time, then by duration (longer first)
+    const sorted = [...events].sort((a, b) => {
+        const aStart = a.start.getHours() * 60 + a.start.getMinutes();
+        const bStart = b.start.getHours() * 60 + b.start.getMinutes();
+        if (aStart !== bStart)
+            return aStart - bStart;
+        const aEnd = a.end
+            ? a.end.getHours() * 60 + a.end.getMinutes()
+            : aStart + 30;
+        const bEnd = b.end
+            ? b.end.getHours() * 60 + b.end.getMinutes()
+            : bStart + 30;
+        return (bEnd - bStart) - (aEnd - aStart); // Longer events first
+    });
+    // Assign columns using a greedy approach
+    // Track when each column becomes free
+    const columnEnds = [];
+    const assignments = [];
+    for (const event of sorted) {
+        const eventStart = event.start.getHours() * 60 + event.start.getMinutes();
+        const eventEnd = event.end
+            ? event.end.getHours() * 60 + event.end.getMinutes()
+            : eventStart + 30;
+        // Find the first available column
+        let assignedColumn = -1;
+        for (let col = 0; col < columnEnds.length; col++) {
+            if (columnEnds[col] <= eventStart) {
+                assignedColumn = col;
+                columnEnds[col] = eventEnd;
+                break;
+            }
+        }
+        if (assignedColumn === -1) {
+            assignedColumn = columnEnds.length;
+            columnEnds.push(eventEnd);
+        }
+        assignments.push({
+            event,
+            column: assignedColumn,
+            startMin: eventStart,
+            endMin: eventEnd,
+        });
+    }
+    // Compute total columns for each group of overlapping events
+    // We need to find connected components of overlapping events
+    const groups = findOverlapGroups(assignments);
+    const positioned = [];
+    for (const group of groups) {
+        const maxColumn = Math.max(...group.map(a => a.column)) + 1;
+        for (const assignment of group) {
+            const top = ((assignment.startMin - timelineStart) / totalMinutes) * 100;
+            const height = ((assignment.endMin - assignment.startMin) / totalMinutes) * 100;
+            positioned.push({
+                event: assignment.event,
+                top: Math.max(0, top),
+                height: Math.min(height, 100 - Math.max(0, top)),
+                column: assignment.column,
+                totalColumns: maxColumn,
+            });
+        }
+    }
+    return positioned;
+}
+/**
+ * Find groups of events that overlap with each other (connected components).
+ */
+function findOverlapGroups(assignments) {
+    if (assignments.length === 0)
+        return [];
+    const sorted = [...assignments].sort((a, b) => a.startMin - b.startMin);
+    const groups = [];
+    let currentGroup = [sorted[0]];
+    let groupEnd = sorted[0].endMin;
+    for (let i = 1; i < sorted.length; i++) {
+        if (sorted[i].startMin < groupEnd) {
+            // Overlaps with current group
+            currentGroup.push(sorted[i]);
+            groupEnd = Math.max(groupEnd, sorted[i].endMin);
+        }
+        else {
+            // New group
+            groups.push(currentGroup);
+            currentGroup = [sorted[i]];
+            groupEnd = sorted[i].endMin;
+        }
+    }
+    groups.push(currentGroup);
+    return groups;
+}
+//# sourceMappingURL=timeline.js.map

package/dist/timeline.js.map

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