@neo-reckoning/core 0.1.0-alpha.1

package/dist/displayType.d.ts

@@ -0,0 +1,9 @@
+import type { DateRange, ViewFidelity } from './types.js';
+/**
+ * Resolve the effective display type for a range at a given fidelity level.
+ * If the range has an explicit displayType (not 'auto'), it is returned as-is.
+ * Otherwise, auto-resolution picks a sensible default based on range characteristics
+ * and the current view fidelity.
+ */
+export declare function resolveDisplayType(range: DateRange, fidelity: ViewFidelity): string;
+//# sourceMappingURL=displayType.d.ts.map

package/dist/displayType.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"displayType.d.ts","sourceRoot":"","sources":["../src/displayType.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1D;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,GAAG,MAAM,CAgBnF"}

package/dist/displayType.js

@@ -0,0 +1,23 @@
+/**
+ * Resolve the effective display type for a range at a given fidelity level.
+ * If the range has an explicit displayType (not 'auto'), it is returned as-is.
+ * Otherwise, auto-resolution picks a sensible default based on range characteristics
+ * and the current view fidelity.
+ */
+export function resolveDisplayType(range, fidelity) {
+    if (range.displayType && range.displayType !== 'auto') {
+        return range.displayType;
+    }
+    // Auto-resolve based on range characteristics and view fidelity
+    if (fidelity === 'year')
+        return 'dot';
+    if (range.startTime || range.everyHour) {
+        return fidelity === 'month' ? 'chip' : 'block';
+    }
+    if (range.fromDate && range.toDate)
+        return 'span';
+    if (range.dates && range.dates.length === 1)
+        return 'dot';
+    return 'fill';
+}
+//# sourceMappingURL=displayType.js.map

package/dist/displayType.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"displayType.js","sourceRoot":"","sources":["../src/displayType.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAgB,EAAE,QAAsB;IACzE,IAAI,KAAK,CAAC,WAAW,IAAI,KAAK,CAAC,WAAW,KAAK,MAAM,EAAE,CAAC;QACtD,OAAO,KAAK,CAAC,WAAW,CAAC;IAC3B,CAAC;IAED,gEAAgE;IAChE,IAAI,QAAQ,KAAK,MAAM;QAAE,OAAO,KAAK,CAAC;IAEtC,IAAI,KAAK,CAAC,SAAS,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;QACvC,OAAO,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC;IACjD,CAAC;IAED,IAAI,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC,MAAM;QAAE,OAAO,MAAM,CAAC;IAClD,IAAI,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAE1D,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/evaluator.d.ts

@@ -0,0 +1,86 @@
+import type { DateRange, Occurrence, TimeSlot, SpanInfo, Conflict, FreeSlot } from './types.js';
+/**
+ * RangeEvaluator — the core computation engine of neo-reckoning.
+ *
+ * Determines whether dates/times fall within a DateRange and expands
+ * ranges into concrete occurrences within a given window.
+ */
+export declare class RangeEvaluator {
+    private userTimezone;
+    constructor(userTimezone?: string);
+    /**
+     * Check if a date (YYYY-MM-DD) falls within a range's day-level criteria.
+     */
+    isDateInRange(dateStr: string, range: DateRange): boolean;
+    /**
+     * Get all time occurrences for a range on a specific day.
+     * Returns empty array for all-day ranges (check isDateInRange instead).
+     */
+    getTimeSlots(dateStr: string, range: DateRange): TimeSlot[];
+    /**
+     * Check if a specific datetime falls within a range (both day and time criteria).
+     */
+    isInRange(datetime: Date, range: DateRange): boolean;
+    /**
+     * Expand a DateRange into all concrete occurrences within a date window.
+     * This is the core computation described in the plan's Addendum C.
+     */
+    expand(range: DateRange, from: Date, to: Date): Occurrence[];
+    /**
+     * Expand a DateRange for a single day — convenience for day/week views.
+     */
+    expandDay(range: DateRange, dateStr: string): TimeSlot[];
+    /**
+     * Compute contiguous spans for multiple ranges within a date window.
+     * Groups consecutive matching days into SpanInfo objects, assigns lanes
+     * using greedy interval scheduling, and computes overlap metrics.
+     */
+    computeSpans(ranges: DateRange[], from: Date, to: Date): SpanInfo[];
+    /**
+     * Find time-level conflicts among ranges on a single date.
+     * Two timed ranges that overlap in time are a conflict.
+     * Two all-day ranges, or an all-day + timed range, are NOT conflicts.
+     */
+    findConflicts(ranges: DateRange[], date: string): Conflict[];
+    /**
+     * Find time-level conflicts across a date window.
+     */
+    findConflictsInWindow(ranges: DateRange[], from: Date, to: Date): Conflict[];
+    /**
+     * Find free (unoccupied) time slots on a given date by analysing all ranges.
+     *
+     * Algorithm:
+     * 1. Expand all ranges for the date into time slots (using getTimeSlots)
+     * 2. Collect occupied intervals as [startMinutes, endMinutes] pairs
+     * 3. Merge overlapping intervals
+     * 4. Walk from dayStart to dayEnd — gaps between merged intervals are free slots
+     * 5. Filter by minDuration
+     */
+    findFreeSlots(ranges: DateRange[], date: string, options?: {
+        minDuration?: number;
+        dayStart?: string;
+        dayEnd?: string;
+    }): FreeSlot[];
+    /**
+     * Find the next free slot of at least `duration` minutes, searching day by day
+     * from `from` to `to`.
+     */
+    findNextFreeSlot(ranges: DateRange[], from: Date, to: Date, duration: number, options?: {
+        dayStart?: string;
+        dayEnd?: string;
+    }): FreeSlot | null;
+    /**
+     * Check if dateB is exactly the day after dateA.
+     */
+    private isNextDay;
+    private isDateInBounds;
+    private getCandidateDays;
+    private hasTimeFields;
+    /**
+     * Resolve a time in the range's timezone to the user's timezone.
+     * Returns null if the time doesn't exist (DST spring-forward gap).
+     * Returns the time unchanged if the range has no timezone (floating).
+     */
+    private resolveTime;
+}
+//# sourceMappingURL=evaluator.d.ts.map

package/dist/evaluator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evaluator.d.ts","sourceRoot":"","sources":["../src/evaluator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAgBhG;;;;;GAKG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,YAAY,CAAS;gBAEjB,YAAY,CAAC,EAAE,MAAM;IAIjC;;OAEG;IACH,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,OAAO;IAoCzD;;;OAGG;IACH,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,QAAQ,EAAE;IAuF3D;;OAEG;IACH,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,GAAG,OAAO;IAiCpD;;;OAGG;IACH,MAAM,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,GAAG,UAAU,EAAE;IAwC5D;;OAEG;IACH,SAAS,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,QAAQ,EAAE;IAOxD;;;;OAIG;IACH,YAAY,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,GAAG,QAAQ,EAAE;IAyLnE;;;;OAIG;IACH,aAAa,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,QAAQ,EAAE;IAiE5D;;OAEG;IACH,qBAAqB,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,GAAG,QAAQ,EAAE;IAgB5E;;;;;;;;;OASG;IACH,aAAa,CACX,MAAM,EAAE,SAAS,EAAE,EACnB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;QACR,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,GACA,QAAQ,EAAE;IAyEb;;;OAGG;IACH,gBAAgB,CACd,MAAM,EAAE,SAAS,EAAE,EACnB,IAAI,EAAE,IAAI,EACV,EAAE,EAAE,IAAI,EACR,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE;QACR,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,GACA,QAAQ,GAAG,IAAI;IAuBlB;;OAEG;IACH,OAAO,CAAC,SAAS;IAMjB,OAAO,CAAC,cAAc;IAWtB,OAAO,CAAC,gBAAgB;IA4BxB,OAAO,CAAC,aAAa;IAIrB;;;;OAIG;IACH,OAAO,CAAC,WAAW;CAMpB"}