@neo-reckoning/core 0.1.0-alpha.1

package/dist/types.d.ts

@@ -0,0 +1,349 @@
+/**
+ * View fidelity level — controls how much detail CalendarGrid computes per day.
+ * - 'year': only hasActivity boolean (skip ranges[], timeSlots[])
+ * - 'month': ranges[] populated (skip timeSlots[])
+ * - 'week' / 'day': both ranges[] and timeSlots[] populated
+ */
+export type ViewFidelity = 'year' | 'month' | 'week' | 'day';
+/**
+ * Display type hint — passed through from the API for the SPA to interpret.
+ */
+export type DisplayType = 'auto' | 'span' | 'dot' | 'fill' | 'chip' | 'block';
+/**
+ * A DateRange defines a set of dates and/or times using either explicit values
+ * or recurrence patterns. This is the core data model of neo-reckoning,
+ * carried forward from the original Reckoning library and extended with
+ * sub-day time support.
+ */
+export interface DateRange {
+    id: string;
+    label: string;
+    title?: string;
+    /** Explicit date list, e.g. ["2026-03-21", "2026-03-25"] */
+    dates?: string[];
+    /** Range start date (YYYY-MM-DD) */
+    fromDate?: string;
+    /** Range end date (YYYY-MM-DD) */
+    toDate?: string;
+    /** If true, recurrence is constrained to the fromDate/toDate window */
+    fixedBetween?: boolean;
+    /** Days of month this range recurs on, e.g. [1, 15] */
+    everyDate?: number[];
+    /** Days of week (0=Sunday, 6=Saturday), e.g. [1, 3, 5] for Mon/Wed/Fri */
+    everyWeekday?: number[];
+    /** Months (1-12), e.g. [6, 12] for June and December */
+    everyMonth?: number[];
+    /** Specific hours (0-23), e.g. [6, 14, 22]. Mutually exclusive with startTime/repeatEvery. */
+    everyHour?: number[];
+    /** Start time in HH:mm format. Mutually exclusive with everyHour. */
+    startTime?: string;
+    /** End time in HH:mm format. Requires startTime. */
+    endTime?: string;
+    /** Repeat interval in minutes from startTime. Requires startTime. */
+    repeatEvery?: number;
+    /** Duration in minutes per occurrence. */
+    duration?: number;
+    /**
+     * IANA timezone identifier.
+     * - "UTC": times are in UTC, will be converted to userTimezone for display (default for API ranges)
+     * - Other IANA tz: times are in that timezone, converted to userTimezone
+     * - null/undefined: floating time — no conversion, times are as-is
+     */
+    timezone?: string | null;
+    /** Display hint from the API. Neo-reckoning passes this through, SPA interprets it. */
+    displayType?: DisplayType;
+    /**
+     * Flexibility score (0-5). 0=locked, 1-5=increasingly flexible.
+     * Neo-reckoning passes this through — agent-facing code interprets it.
+     */
+    flexibility?: number;
+}
+/**
+ * A concrete occurrence of a DateRange — one specific date/time that the range
+ * evaluates to within a given window.
+ */
+export interface Occurrence {
+    /** Date in YYYY-MM-DD format */
+    date: string;
+    /** Start time in HH:mm format, null for all-day */
+    startTime: string | null;
+    /** End time in HH:mm format, null for all-day or when no end is defined */
+    endTime: string | null;
+    /** ID of the source DateRange */
+    rangeId: string;
+    /** Label from the source DateRange */
+    label: string;
+    /** Whether this is an all-day occurrence (no time fields) */
+    allDay: boolean;
+    /** Display type hint passed through from the source DateRange */
+    displayType?: string;
+}
+/**
+ * A free (unoccupied) time slot within a single day.
+ * Produced by RangeEvaluator.findFreeSlots().
+ */
+export interface FreeSlot {
+    /** Date in YYYY-MM-DD format */
+    date: string;
+    /** Start time in HH:mm format */
+    startTime: string;
+    /** End time in HH:mm format */
+    endTime: string;
+    /** Duration in minutes */
+    duration: number;
+}
+/**
+ * A time slot within a single day — used for day/week detail views.
+ */
+export interface TimeSlot {
+    /** Start time in HH:mm format */
+    startTime: string;
+    /** End time in HH:mm format, null if open-ended */
+    endTime: string | null;
+    /** Duration in minutes, null if not computable */
+    duration: number | null;
+    /** ID of the source DateRange */
+    rangeId: string;
+    /** Label from the source DateRange */
+    label: string;
+}
+/**
+ * Information about a DateRange's presence on a specific day — used for
+ * month-grid rendering to show contiguous spans.
+ */
+export interface DayRangeInfo {
+    /** ID of the source DateRange */
+    rangeId: string;
+    /** Label from the source DateRange */
+    label: string;
+    /** True if this is the first day of a contiguous span */
+    isStart: boolean;
+    /** True if this is the last day of a contiguous span */
+    isEnd: boolean;
+    /** True if this day is in the middle of a contiguous span */
+    isContinuation: boolean;
+    /** Display type hint passed through from the source DateRange */
+    displayType?: string;
+}
+/**
+ * Information about a contiguous span of days for a DateRange within a window.
+ * Used for overlap detection and lane-based rendering in month/timeline views.
+ */
+export interface SpanInfo {
+    /** ID of the source DateRange */
+    rangeId: string;
+    /** Label from the source DateRange */
+    label: string;
+    /** Display type hint passed through from the DateRange */
+    displayType?: string;
+    /** First day of this contiguous span (YYYY-MM-DD) */
+    startDate: string;
+    /** Last day of this contiguous span (YYYY-MM-DD) */
+    endDate: string;
+    /** Total days in this span */
+    length: number;
+    /** Maximum number of overlapping ranges at any point in this span */
+    maxOverlap: number;
+    /** Consistent lane assignment for rendering (0-based) */
+    lane: number;
+    /** Total number of lanes needed across all spans sharing any overlap day with this span */
+    totalLanes: number;
+}
+/**
+ * A single day in a calendar grid.
+ */
+export interface Day {
+    /** Date in YYYY-MM-DD format */
+    date: string;
+    /** Day of month (1-31) */
+    dayOfMonth: number;
+    /** Whether this day belongs to the month being displayed */
+    isCurrentMonth: boolean;
+    /** Whether this is today */
+    isToday: boolean;
+    /** Which ranges this day belongs to */
+    ranges: DayRangeInfo[];
+    /** Sub-day occurrences, populated for day/week views */
+    timeSlots: TimeSlot[];
+    /** True if any range matches this day. Only computed for 'year' fidelity to save work. */
+    hasActivity?: boolean;
+}
+/**
+ * A week in a calendar grid — always 7 days.
+ */
+export interface Week {
+    days: Day[];
+}
+/**
+ * A month in a calendar grid.
+ */
+export interface Month {
+    year: number;
+    /** Month number (0-11, matching JS Date convention) */
+    month: number;
+    /** Formatted label, e.g. "March 2026" */
+    label: string;
+    weeks: Week[];
+}
+/**
+ * Normalized event model — the single shape consumed by the rendering layer.
+ * Both native DateRanges and imported .ics events converge into this.
+ */
+export interface CalendarEvent {
+    id: string;
+    title: string;
+    start: Date;
+    end: Date | null;
+    allDay: boolean;
+    source: 'native' | 'imported';
+    /** Range ID (native) or subscription ID (imported) — SPA maps this to colors */
+    sourceId: string;
+    editable: boolean;
+    /** Source-specific extras (location, description, etc.) */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * A positioned event in a timeline view — includes layout data for rendering.
+ */
+export interface PositionedEvent {
+    event: CalendarEvent;
+    /** Percentage offset from the timeline start (0-100) */
+    top: number;
+    /** Percentage height based on duration (0-100) */
+    height: number;
+    /** Column index for side-by-side overlapping events (0-based) */
+    column: number;
+    /** Total number of columns at this overlap point */
+    totalColumns: number;
+}
+/**
+ * A slot in a timeline view.
+ */
+export interface TimelineSlot {
+    /** Time label, e.g. "06:00" */
+    time: string;
+    hour: number;
+    minute: number;
+    /** Events that overlap this slot */
+    events: PositionedEvent[];
+}
+/**
+ * Configuration for CalendarGrid.
+ */
+export interface CalendarGridConfig {
+    /** Center the grid on this date (YYYY-MM-DD) */
+    focusDate: string;
+    /** How many months to generate */
+    numberOfMonths: number;
+    /** DateRanges to evaluate against the grid */
+    ranges: DateRange[];
+    /** Week start day: 0=Sunday, 1=Monday. Default: 0 */
+    weekStartsOn?: number;
+    /** BCP 47 locale tag for Intl formatting. Default: browser/runtime default */
+    locale?: string;
+    /** IANA timezone for the user viewing the calendar */
+    userTimezone?: string;
+    /** View fidelity level — controls how much detail is computed per day. Default: 'month' */
+    fidelity?: ViewFidelity;
+}
+/**
+ * Configuration for TimelineGrid.
+ */
+export interface TimelineGridConfig {
+    /** Which day to render (YYYY-MM-DD) */
+    date: string;
+    /** Start hour of the timeline (0-23). Default: 0 */
+    startHour?: number;
+    /** End hour of the timeline (1-24). Default: 24 */
+    endHour?: number;
+    /** Slot granularity in minutes: 15, 30, or 60. Default: 60 */
+    intervalMinutes?: number;
+    /** Normalized events for this day */
+    events: CalendarEvent[];
+}
+/**
+ * Pluggable cache adapter for @neo-reckoning/ical.
+ * Supports both sync (web localStorage) and async (React Native AsyncStorage) implementations.
+ */
+export interface CacheAdapter {
+    get(key: string): Promise<string | null> | string | null;
+    set(key: string, value: string): Promise<void> | void;
+    remove(key: string): Promise<void> | void;
+}
+/**
+ * Configuration for YearGrid.
+ */
+export interface YearGridConfig {
+    /** The year to generate (e.g. 2026) */
+    year: number;
+    /** DateRanges to evaluate against the grid */
+    ranges: DateRange[];
+    /** IANA timezone for the user viewing the calendar */
+    userTimezone?: string;
+}
+/**
+ * A month within a year grid — lightweight, no weeks/time slots.
+ */
+export interface YearMonth {
+    /** Month number (0-11) */
+    month: number;
+    /** Month label, e.g. "January" */
+    label: string;
+    /** Count of days that have at least one range match */
+    activeDays: number;
+    /** Total days in the month */
+    totalDays: number;
+    /** Per-day activity data for heatmap-style rendering */
+    days: YearDay[];
+}
+/**
+ * A single day in a year grid.
+ */
+export interface YearDay {
+    /** Date in YYYY-MM-DD format */
+    date: string;
+    /** Day of month (1-31) */
+    dayOfMonth: number;
+    /** How many ranges match this day */
+    rangeCount: number;
+    /** IDs of matching ranges (SPA maps these to colors) */
+    rangeIds: string[];
+}
+/**
+ * Score summarising the quality of a schedule across a date window.
+ */
+export interface ScheduleScore {
+    /** Total conflicts across the window */
+    conflicts: number;
+    /** Total minutes of free time within working hours across the window */
+    freeMinutes: number;
+    /** Number of uninterrupted focus blocks >= focusBlockMinutes */
+    focusBlocks: number;
+    /** Number of context switches (transitions between different ranges) per day, averaged */
+    avgContextSwitches: number;
+    /** Total days with at least one conflict */
+    conflictDays: number;
+}
+/**
+ * A time-level conflict between two ranges on a specific date.
+ * Only timed ranges can conflict — two all-day ranges stack, they don't conflict.
+ */
+export interface Conflict {
+    /** First conflicting range */
+    rangeA: {
+        id: string;
+        label: string;
+    };
+    /** Second conflicting range */
+    rangeB: {
+        id: string;
+        label: string;
+    };
+    /** Date of the conflict (YYYY-MM-DD) */
+    date: string;
+    /** Start of the overlap window (HH:mm), null for all-day */
+    overlapStart: string | null;
+    /** End of the overlap window (HH:mm), null for all-day */
+    overlapEnd: string | null;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,KAAK,CAAC;AAE7D;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAE9E;;;;;GAKG;AACH,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IAGf,4DAA4D;IAC5D,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,oCAAoC;IACpC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kCAAkC;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uEAAuE;IACvE,YAAY,CAAC,EAAE,OAAO,CAAC;IAGvB,uDAAuD;IACvD,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,0EAA0E;IAC1E,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,wDAAwD;IACxD,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IAKtB,8FAA8F;IAC9F,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IAGrB,qEAAqE;IACrE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oDAAoD;IACpD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qEAAqE;IACrE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAGlB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAEzB,uFAAuF;IACvF,WAAW,CAAC,EAAE,WAAW,CAAC;IAE1B;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,mDAAmD;IACnD,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,2EAA2E;IAC3E,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,iCAAiC;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,sCAAsC;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,6DAA6D;IAC7D,MAAM,EAAE,OAAO,CAAC;IAChB,iEAAiE;IACjE,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,MAAM,WAAW,QAAQ;IACvB,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,iCAAiC;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,+BAA+B;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,0BAA0B;IAC1B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,iCAAiC;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,mDAAmD;IACnD,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,kDAAkD;IAClD,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,iCAAiC;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,sCAAsC;IACtC,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,iCAAiC;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,sCAAsC;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,yDAAyD;IACzD,OAAO,EAAE,OAAO,CAAC;IACjB,wDAAwD;IACxD,KAAK,EAAE,OAAO,CAAC;IACf,6DAA6D;IAC7D,cAAc,EAAE,OAAO,CAAC;IACxB,iEAAiE;IACjE,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,MAAM,WAAW,QAAQ;IACvB,iCAAiC;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,sCAAsC;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,0DAA0D;IAC1D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qDAAqD;IACrD,SAAS,EAAE,MAAM,CAAC;IAClB,oDAAoD;IACpD,OAAO,EAAE,MAAM,CAAC;IAChB,8BAA8B;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,qEAAqE;IACrE,UAAU,EAAE,MAAM,CAAC;IACnB,yDAAyD;IACzD,IAAI,EAAE,MAAM,CAAC;IACb,2FAA2F;IAC3F,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,GAAG;IAClB,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,0BAA0B;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,4DAA4D;IAC5D,cAAc,EAAE,OAAO,CAAC;IACxB,4BAA4B;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,uCAAuC;IACvC,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB,wDAAwD;IACxD,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,0FAA0F;IAC1F,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,IAAI;IACnB,IAAI,EAAE,GAAG,EAAE,CAAC;CACb;AAED;;GAEG;AACH,MAAM,WAAW,KAAK;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,uDAAuD;IACvD,KAAK,EAAE,MAAM,CAAC;IACd,yCAAyC;IACzC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,IAAI,EAAE,CAAC;CACf;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,IAAI,CAAC;IACZ,GAAG,EAAE,IAAI,GAAG,IAAI,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,QAAQ,GAAG,UAAU,CAAC;IAC9B,gFAAgF;IAChF,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,aAAa,CAAC;IACrB,wDAAwD;IACxD,GAAG,EAAE,MAAM,CAAC;IACZ,kDAAkD;IAClD,MAAM,EAAE,MAAM,CAAC;IACf,iEAAiE;IACjE,MAAM,EAAE,MAAM,CAAC;IACf,oDAAoD;IACpD,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,+BAA+B;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,oCAAoC;IACpC,MAAM,EAAE,eAAe,EAAE,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,gDAAgD;IAChD,SAAS,EAAE,MAAM,CAAC;IAClB,kCAAkC;IAClC,cAAc,EAAE,MAAM,CAAC;IACvB,8CAA8C;IAC9C,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,qDAAqD;IACrD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,8EAA8E;IAC9E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,sDAAsD;IACtD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,2FAA2F;IAC3F,QAAQ,CAAC,EAAE,YAAY,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,uCAAuC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,oDAAoD;IACpD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mDAAmD;IACnD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8DAA8D;IAC9D,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,qCAAqC;IACrC,MAAM,EAAE,aAAa,EAAE,CAAC;CACzB;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,MAAM,GAAG,IAAI,CAAC;IACzD,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACtD,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CAC3C;AAID;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,uCAAuC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,8CAA8C;IAC9C,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,sDAAsD;IACtD,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,0BAA0B;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,kCAAkC;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,uDAAuD;IACvD,UAAU,EAAE,MAAM,CAAC;IACnB,8BAA8B;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,wDAAwD;IACxD,IAAI,EAAE,OAAO,EAAE,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,0BAA0B;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,qCAAqC;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,wDAAwD;IACxD,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,wCAAwC;IACxC,SAAS,EAAE,MAAM,CAAC;IAClB,wEAAwE;IACxE,WAAW,EAAE,MAAM,CAAC;IACpB,gEAAgE;IAChE,WAAW,EAAE,MAAM,CAAC;IACpB,0FAA0F;IAC1F,kBAAkB,EAAE,MAAM,CAAC;IAC3B,4CAA4C;IAC5C,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,MAAM,WAAW,QAAQ;IACvB,8BAA8B;IAC9B,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IACtC,+BAA+B;IAC/B,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IACtC,wCAAwC;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,4DAA4D;IAC5D,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,0DAA0D;IAC1D,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/yearGrid.d.ts

@@ -0,0 +1,16 @@
+import type { YearGridConfig, YearMonth } from './types.js';
+/**
+ * YearGrid — lightweight year-level grid for heatmap-style rendering.
+ * No weeks, no time slots, no span tracking — just per-day activity data.
+ */
+export declare class YearGrid {
+    months: YearMonth[];
+    private year;
+    private ranges;
+    private evaluator;
+    constructor(config: YearGridConfig);
+    private generate;
+    private generateMonth;
+    private formatMonthLabel;
+}
+//# sourceMappingURL=yearGrid.d.ts.map

package/dist/yearGrid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"yearGrid.d.ts","sourceRoot":"","sources":["../src/yearGrid.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,cAAc,EACd,SAAS,EAEV,MAAM,YAAY,CAAC;AAIpB;;;GAGG;AACH,qBAAa,QAAQ;IACnB,MAAM,EAAE,SAAS,EAAE,CAAC;IAEpB,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,SAAS,CAAiB;gBAEtB,MAAM,EAAE,cAAc;IAOlC,OAAO,CAAC,QAAQ;IAUhB,OAAO,CAAC,aAAa;IAqCrB,OAAO,CAAC,gBAAgB;CAIzB"}

package/dist/yearGrid.js

@@ -0,0 +1,61 @@
+import { RangeEvaluator } from './evaluator.js';
+import { formatDate, daysInMonth } from './time.js';
+/**
+ * YearGrid — lightweight year-level grid for heatmap-style rendering.
+ * No weeks, no time slots, no span tracking — just per-day activity data.
+ */
+export class YearGrid {
+    months;
+    year;
+    ranges;
+    evaluator;
+    constructor(config) {
+        this.year = config.year;
+        this.ranges = config.ranges;
+        this.evaluator = new RangeEvaluator(config.userTimezone);
+        this.months = this.generate();
+    }
+    generate() {
+        const months = [];
+        for (let month = 0; month < 12; month++) {
+            months.push(this.generateMonth(month));
+        }
+        return months;
+    }
+    generateMonth(month) {
+        const label = this.formatMonthLabel(month);
+        const totalDays = daysInMonth(this.year, month);
+        const days = [];
+        let activeDays = 0;
+        for (let day = 1; day <= totalDays; day++) {
+            const dateStr = formatDate(new Date(this.year, month, day));
+            const matchingRangeIds = [];
+            for (const range of this.ranges) {
+                if (this.evaluator.isDateInRange(dateStr, range)) {
+                    matchingRangeIds.push(range.id);
+                }
+            }
+            if (matchingRangeIds.length > 0) {
+                activeDays++;
+            }
+            days.push({
+                date: dateStr,
+                dayOfMonth: day,
+                rangeCount: matchingRangeIds.length,
+                rangeIds: matchingRangeIds,
+            });
+        }
+        return {
+            month,
+            label,
+            activeDays,
+            totalDays,
+            days,
+        };
+    }
+    formatMonthLabel(month) {
+        const date = new Date(this.year, month, 1);
+        return new Intl.DateTimeFormat('en-US', { month: 'long' }).format(date);
+    }
+}
+//# sourceMappingURL=yearGrid.js.map

package/dist/yearGrid.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"yearGrid.js","sourceRoot":"","sources":["../src/yearGrid.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAEpD;;;GAGG;AACH,MAAM,OAAO,QAAQ;IACnB,MAAM,CAAc;IAEZ,IAAI,CAAS;IACb,MAAM,CAAc;IACpB,SAAS,CAAiB;IAElC,YAAY,MAAsB;QAChC,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;QACxB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;QAC5B,IAAI,CAAC,SAAS,GAAG,IAAI,cAAc,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;QACzD,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;IAChC,CAAC;IAEO,QAAQ;QACd,MAAM,MAAM,GAAgB,EAAE,CAAC;QAE/B,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,EAAE,EAAE,KAAK,EAAE,EAAE,CAAC;YACxC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC;QACzC,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAEO,aAAa,CAAC,KAAa;QACjC,MAAM,KAAK,GAAG,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC;QAC3C,MAAM,SAAS,GAAG,WAAW,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAChD,MAAM,IAAI,GAAc,EAAE,CAAC;QAC3B,IAAI,UAAU,GAAG,CAAC,CAAC;QAEnB,KAAK,IAAI,GAAG,GAAG,CAAC,EAAE,GAAG,IAAI,SAAS,EAAE,GAAG,EAAE,EAAE,CAAC;YAC1C,MAAM,OAAO,GAAG,UAAU,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC;YAC5D,MAAM,gBAAgB,GAAa,EAAE,CAAC;YAEtC,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;gBAChC,IAAI,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,OAAO,EAAE,KAAK,CAAC,EAAE,CAAC;oBACjD,gBAAgB,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;gBAClC,CAAC;YACH,CAAC;YAED,IAAI,gBAAgB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAChC,UAAU,EAAE,CAAC;YACf,CAAC;YAED,IAAI,CAAC,IAAI,CAAC;gBACR,IAAI,EAAE,OAAO;gBACb,UAAU,EAAE,GAAG;gBACf,UAAU,EAAE,gBAAgB,CAAC,MAAM;gBACnC,QAAQ,EAAE,gBAAgB;aAC3B,CAAC,CAAC;QACL,CAAC;QAED,OAAO;YACL,KAAK;YACL,KAAK;YACL,UAAU;YACV,SAAS;YACT,IAAI;SACL,CAAC;IACJ,CAAC;IAEO,gBAAgB,CAAC,KAAa;QACpC,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;QAC3C,OAAO,IAAI,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC1E,CAAC;CACF"}

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "@neo-reckoning/core",
+  "version": "0.1.0-alpha.1",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "NODE_OPTIONS='--experimental-vm-modules' jest",
+    "typecheck": "tsc --noEmit"
+  },
+  "files": [
+    "dist"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/sdougbrown/neo-reckoning.git",
+    "directory": "packages/core"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}