@jpahd/kalendus 0.1.0

package/dist/lib/DirectionalCalendarDateCalculator.d.ts

@@ -0,0 +1,29 @@
+import { CalendarDate } from '../lms-calendar';
+/**
+ * This class handles calculations and adjustments for CalendarDate objects based on a specified direction.
+ *
+ * @example
+ * ```javascript
+ * const dateCalculator = new DirectionalCalendarDateCalculator({
+ *   date: { year: 2023, month: 8, day: 15 },
+ *   direction: 'next'
+ * });
+ *
+ * const newDate = dateCalculator.getDateByMonthInDirection();
+ * // newDate would be { year: 2023, month: 9, day: 15 }
+ * ```
+ */
+export default class DirectionalCalendarDateCalculator {
+    private _date?;
+    private _direction?;
+    constructor({ date, direction }: {
+        date?: CalendarDate;
+        direction?: 'previous' | 'next';
+    });
+    set date(date: CalendarDate);
+    set direction(direction: 'previous' | 'next');
+    private _toCalendarDate;
+    getDateByDayInDirection(): CalendarDate;
+    getDateByMonthInDirection(): CalendarDate;
+}
+//# sourceMappingURL=DirectionalCalendarDateCalculator.d.ts.map

package/dist/lib/DirectionalCalendarDateCalculator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DirectionalCalendarDateCalculator.d.ts","sourceRoot":"","sources":["../../src/lib/DirectionalCalendarDateCalculator.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE/C;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,OAAO,OAAO,iCAAiC;IAClD,OAAO,CAAC,KAAK,CAAC,CAAW;IACzB,OAAO,CAAC,UAAU,CAAC,CAAS;gBAEhB,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE;QAAE,IAAI,CAAC,EAAE,YAAY,CAAC;QAAC,SAAS,CAAC,EAAE,UAAU,GAAG,MAAM,CAAA;KAAE;IAOzF,IAAI,IAAI,CAAC,IAAI,EAAE,YAAY,EAM1B;IAED,IAAI,SAAS,CAAC,SAAS,EAAE,UAAU,GAAG,MAAM,EAE3C;IAED,OAAO,CAAC,eAAe;IAQhB,uBAAuB;IAqBvB,yBAAyB;CAoBnC"}

package/dist/lib/LayoutCalculator.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Deterministic layout calculation engine for overlapping calendar events
+ * Separates layout logic from rendering concerns
+ */
+interface CalendarEvent {
+    id: string;
+    heading: string;
+    startTime: {
+        hour: number;
+        minute: number;
+    };
+    endTime: {
+        hour: number;
+        minute: number;
+    };
+    color: string;
+}
+interface GridConfig {
+    minuteHeight: number;
+    eventMinHeight: number;
+}
+export interface LayoutBox {
+    id: string;
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    depth: number;
+    group: number;
+    opacity: number;
+    zIndex: number;
+}
+export interface LayoutResult {
+    boxes: LayoutBox[];
+}
+export declare class LayoutCalculator {
+    private config;
+    constructor(config?: Partial<GridConfig & Record<string, number>>);
+    calculateLayout(events: CalendarEvent[]): LayoutResult;
+    private eventsToIntervals;
+    private calculateGrading;
+    private findOverlapGroups;
+    private intervalsOverlap;
+    private calculateBoxes;
+}
+export {};
+//# sourceMappingURL=LayoutCalculator.d.ts.map

package/dist/lib/LayoutCalculator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LayoutCalculator.d.ts","sourceRoot":"","sources":["../../src/lib/LayoutCalculator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,UAAU,aAAa;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5C,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1C,KAAK,EAAE,MAAM,CAAC;CACjB;AAED,UAAU,UAAU;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,SAAS;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IACzB,KAAK,EAAE,SAAS,EAAE,CAAC;CACtB;AAED,qBAAa,gBAAgB;IACzB,OAAO,CAAC,MAAM,CAAa;gBAEf,MAAM,GAAE,OAAO,CAAC,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAM;IAOrE,eAAe,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,YAAY;IAQtD,OAAO,CAAC,iBAAiB;IAOzB,OAAO,CAAC,gBAAgB;IA2CxB,OAAO,CAAC,iBAAiB;IAkCzB,OAAO,CAAC,gBAAgB;IAOxB,OAAO,CAAC,cAAc;CAiEzB"}

package/dist/lib/SlotManager.d.ts

@@ -0,0 +1,130 @@
+/**
+ * SlotManager - Centralized abstraction for calendar entry positioning
+ *
+ * This class handles all the complexity of positioning calendar entries across different views:
+ * - Day view: uses slots for time-based positioning
+ * - Week view: uses slots for day+time positioning
+ * - Month view: uses slots for date-based positioning
+ *
+ * It provides a clean, deterministic API that abstracts away the underlying slot mechanism
+ * and grid positioning complexities.
+ */
+import type { ViewMode } from './ViewStateController.js';
+import { type FirstDayOfWeek } from './weekStartHelper.js';
+declare global {
+    type CalendarDate = {
+        day: number;
+        month: number;
+        year: number;
+    };
+    type CalendarTimeInterval = {
+        start: {
+            hour: number;
+            minute: number;
+        };
+        end: {
+            hour: number;
+            minute: number;
+        };
+    };
+}
+export type { ViewMode };
+export type { FirstDayOfWeek };
+export interface PositionConfig {
+    viewMode: ViewMode;
+    date: CalendarDate;
+    time?: CalendarTimeInterval;
+    isAllDay?: boolean;
+    activeDate?: CalendarDate;
+    firstDayOfWeek?: FirstDayOfWeek;
+    weekDates?: CalendarDate[];
+}
+export interface LayoutDimensions {
+    width: number;
+    x: number;
+    zIndex: number;
+    opacity: number;
+    height?: number;
+}
+export interface AccessibilityInfo {
+    tabIndex: number;
+    role: 'button';
+    ariaLabel: string;
+}
+export interface SlotPosition {
+    slotName: string;
+    gridColumn?: number;
+    gridRow?: string;
+    useDirectGrid: boolean;
+    useAbsolutePosition?: boolean;
+    isAllDay?: boolean;
+    dayIndex?: number;
+    isMultiDay?: boolean;
+}
+export declare class SlotManager {
+    /** Cached week-date→index map, keyed by (activeDate + firstDayOfWeek). */
+    private _weekIndexCache;
+    /**
+     * Calculate the slot name and positioning for an entry
+     */
+    calculatePosition(config: PositionConfig): SlotPosition;
+    /**
+     * Generate CSS styles for positioning an entry based on layout dimensions
+     */
+    generatePositionCSS(position: SlotPosition, layout: LayoutDimensions, time?: CalendarTimeInterval): string;
+    /**
+     * Day view positioning: uses absolute positioning for timed entries
+     */
+    private _calculateDayPosition;
+    /**
+     * Week view positioning: uses absolute positioning within per-day slot containers
+     */
+    private _calculateWeekPosition;
+    /**
+     * Month view positioning: uses date-based slots
+     */
+    private _calculateMonthPosition;
+    /**
+     * Convert a pixel offset within a time column to a time object.
+     * Reads --minute-height from the host element. For future drag/resize interactions.
+     */
+    pxToTime(px: number, hostEl: Element): {
+        hour: number;
+        minute: number;
+    };
+    /**
+     * Calculate which day of the week an entry belongs to (0-6, where 0 is the first day).
+     * Internally caches the week-date→index map so repeated calls for the same
+     * (activeDate, firstDayOfWeek) avoid re-allocating 7 Date objects and scanning.
+     */
+    getWeekDayIndex(entryDate: CalendarDate, activeDate: CalendarDate, firstDayOfWeek?: FirstDayOfWeek): number;
+    /**
+     * Look up a date's index within a provided date array (for condensed views).
+     */
+    getIndexInDates(date: CalendarDate, dates: CalendarDate[]): number;
+    /**
+     * Convert time interval to CSS grid row specification
+     */
+    private _getGridSlotByTime;
+    /**
+     * Calculate accessibility information including logical tab order
+     */
+    calculateAccessibility(config: PositionConfig): AccessibilityInfo;
+    /**
+     * Generate comprehensive ARIA label for screen readers
+     */
+    private _generateAriaLabel;
+    /**
+     * Get human-readable description of position (for debugging)
+     */
+    getPositionDescription(config: PositionConfig): string;
+    /**
+     * Validate that a position configuration is valid
+     */
+    validatePosition(config: PositionConfig): {
+        valid: boolean;
+        error?: string;
+    };
+}
+export declare const slotManager: SlotManager;
+//# sourceMappingURL=SlotManager.d.ts.map

package/dist/lib/SlotManager.d.ts.map

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

package/dist/lib/ViewStateController.d.ts

@@ -0,0 +1,22 @@
+import type { ReactiveController, ReactiveControllerHost } from 'lit';
+export type ViewMode = 'month' | 'week' | 'day' | 'year';
+export declare class ViewStateController implements ReactiveController {
+    private _host;
+    private _viewMode;
+    private _activeDate;
+    constructor(host: ReactiveControllerHost);
+    hostConnected(): void;
+    get viewMode(): ViewMode;
+    get activeDate(): CalendarDate;
+    get expandedDate(): CalendarDate | undefined;
+    setViewMode(mode: ViewMode): void;
+    setActiveDate(date: CalendarDate): void;
+    navigateNext(): void;
+    navigatePrevious(): void;
+    jumpToToday(): void;
+    switchToMonthView(): void;
+    switchToWeekView(): void;
+    switchToDayView(): void;
+    switchToYearView(): void;
+}
+//# sourceMappingURL=ViewStateController.d.ts.map

package/dist/lib/ViewStateController.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ViewStateController.d.ts","sourceRoot":"","sources":["../../src/lib/ViewStateController.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,KAAK,CAAC;AAEtE,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,CAAC;AAEzD,qBAAa,mBAAoB,YAAW,kBAAkB;IAC1D,OAAO,CAAC,KAAK,CAAyB;IACtC,OAAO,CAAC,SAAS,CAAqB;IACtC,OAAO,CAAC,WAAW,CAAe;gBAEtB,IAAI,EAAE,sBAAsB;IAYxC,aAAa,IAAI,IAAI;IAErB,IAAI,QAAQ,IAAI,QAAQ,CAEvB;IAED,IAAI,UAAU,IAAI,YAAY,CAE7B;IAED,IAAI,YAAY,IAAI,YAAY,GAAG,SAAS,CAE3C;IAED,WAAW,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI;IAKjC,aAAa,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI;IAKvC,YAAY,IAAI,IAAI;IAwCpB,gBAAgB,IAAI,IAAI;IAwCxB,WAAW,IAAI,IAAI;IASnB,iBAAiB,IAAI,IAAI;IAIzB,gBAAgB,IAAI,IAAI;IAIxB,eAAe,IAAI,IAAI;IAIvB,gBAAgB,IAAI,IAAI;CAG3B"}

package/dist/lib/allDayLayout.d.ts

@@ -0,0 +1,24 @@
+export interface AllDayEvent {
+    id: string;
+    days: number[];
+    isMultiDay: boolean;
+}
+export interface AllDayLayoutResult {
+    rowAssignments: Map<string, number>;
+    totalRows: number;
+}
+/**
+ * Allocate row positions for all-day events so they don't overlap.
+ * Multi-day events are placed first, then single-day events fill remaining slots.
+ */
+export declare function allocateAllDayRows(events: AllDayEvent[]): AllDayLayoutResult;
+/**
+ * Determine the span class for an all-day entry based on its position within a multi-day span.
+ */
+export declare function computeSpanClass(entry: {
+    continuationIndex: number;
+    totalDays: number;
+    visibleStartIndex: number;
+    visibleEndIndex: number;
+}): 'first-day' | 'middle-day' | 'last-day' | 'single-day';
+//# sourceMappingURL=allDayLayout.d.ts.map

package/dist/lib/allDayLayout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"allDayLayout.d.ts","sourceRoot":"","sources":["../../src/lib/allDayLayout.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,UAAU,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,kBAAkB;IAC/B,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,SAAS,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,kBAAkB,CAqF5E;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE;IACpC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,eAAe,EAAE,MAAM,CAAC;CAC3B,GAAG,WAAW,GAAG,YAAY,GAAG,UAAU,GAAG,YAAY,CAoBzD"}

package/dist/lib/catchError.d.ts

@@ -0,0 +1,2 @@
+export declare function catchError<T>(promise: Promise<T>): Promise<[undefined, T] | [Error]>;
+//# sourceMappingURL=catchError.d.ts.map

package/dist/lib/catchError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catchError.d.ts","sourceRoot":"","sources":["../../src/lib/catchError.ts"],"names":[],"mappings":"AAAA,wBAAgB,UAAU,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAIpF"}

package/dist/lib/getColorTextWithContrast.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Calculates the text color and background color based on the given color.
+ *
+ * @param {string} color - The color to process.
+ * @returns {[string, string]} An array containing the text color and background color.
+ */
+export default function getColorTextWithContrast(color?: string): [string, string];
+//# sourceMappingURL=getColorTextWithContrast.d.ts.map

package/dist/lib/getColorTextWithContrast.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getColorTextWithContrast.d.ts","sourceRoot":"","sources":["../../src/lib/getColorTextWithContrast.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,CAAC,OAAO,UAAU,wBAAwB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CA8CjF"}

package/dist/lib/getOverlappingEntitiesIndices.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Calculates the indices and depths of overlapping entities within a set of partitions.
+ *
+ * @param {Array<Interval[]>} partitions - An array of partitions, where each partition is an array of intervals.
+ * @returns {Array<Grading>} An array of grading objects, representing indices and depths of overlapping entities.
+ */
+export default function getOverlappingEntitiesIndices(partitions: Array<Interval[]>): Array<Grading>;
+//# sourceMappingURL=getOverlappingEntitiesIndices.d.ts.map

package/dist/lib/getOverlappingEntitiesIndices.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getOverlappingEntitiesIndices.d.ts","sourceRoot":"","sources":["../../src/lib/getOverlappingEntitiesIndices.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,CAAC,OAAO,UAAU,6BAA6B,CACjD,UAAU,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC,GAC9B,KAAK,CAAC,OAAO,CAAC,CAYhB"}

package/dist/lib/getSortedGradingsByIndex.d.ts

@@ -0,0 +1,2 @@
+export default function rearrangeDepths(gradings: Grading[]): Grading[];
+//# sourceMappingURL=getSortedGradingsByIndex.d.ts.map

package/dist/lib/getSortedGradingsByIndex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getSortedGradingsByIndex.d.ts","sourceRoot":"","sources":["../../src/lib/getSortedGradingsByIndex.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,OAAO,UAAU,eAAe,CAAC,QAAQ,EAAE,OAAO,EAAE,aAoB1D"}

package/dist/lib/localization.d.ts

@@ -0,0 +1,34 @@
+import { DateTime } from 'luxon';
+/**
+ * Format a DateTime with the given locale
+ */
+export declare function formatDateTime(dateTime: DateTime, format: string, locale?: string): string;
+/**
+ * Get localized month name (abbreviated)
+ */
+export declare function getLocalizedMonth(month: number, locale?: string): string;
+/**
+ * Format day + abbreviated month using the locale's natural ordering.
+ * e.g., "1. Feb." (de), "1 feb" (es), "2月1日" (zh/ja)
+ */
+export declare function getLocalizedDayMonth(day: number, month: number, year: number, locale?: string): string;
+/**
+ * Get localized weekday name (abbreviated for calendar headers)
+ */
+export declare function getLocalizedWeekdayShort(weekday: number, locale?: string): string;
+/**
+ * Format a time (hour + minute) using the locale's preferred notation.
+ * e.g., "3:30 PM" (en), "15:30" (de), "下午3:30" (zh-CN)
+ */
+export declare function formatLocalizedTime(hour: number, minute: number, locale?: string): string;
+/**
+ * Format a time range with an en-dash separator.
+ * e.g., "9:00 AM – 5:00 PM" (en), "09:00 – 17:00" (de)
+ */
+export declare function formatLocalizedTimeRange(startHour: number, startMinute: number, endHour: number, endMinute: number, locale?: string): string;
+/**
+ * Format a full date (day + month + year) using the locale's natural ordering.
+ * e.g., "Feb 1, 2026" (en), "1. Feb. 2026" (de), "2026年2月1日" (ja)
+ */
+export declare function formatLocalizedDate(day: number, month: number, year: number, locale?: string): string;
+//# sourceMappingURL=localization.d.ts.map

package/dist/lib/localization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"localization.d.ts","sourceRoot":"","sources":["../../src/lib/localization.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAwEjC;;GAEG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,SAAO,GAAG,MAAM,CAExF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,SAAO,GAAG,MAAM,CAEtE;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,SAAO,GAAG,MAAM,CAGpG;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,SAAO,GAAG,MAAM,CAE/E;AAeD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,SAAO,GAAG,MAAM,CAGvF;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CACpC,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,MAAM,SAAO,GACd,MAAM,CAIR;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAC/B,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,MAAM,SAAO,GACd,MAAM,CAQR"}

package/dist/lib/messages.d.ts

@@ -0,0 +1,4 @@
+export type MessageKey = 'day' | 'week' | 'month' | 'currentMonth' | 'allDay' | 'today' | 'noTitle' | 'noContent' | 'noTime' | 'eventDetails' | 'exportAsICS' | 'title' | 'time' | 'date' | 'notes' | 'close' | 'calendarWeek' | 'year' | 'previous' | 'next' | 'events' | 'calendarEvent' | 'pressToOpen' | 'to' | 'switchToDayView' | 'showEarlierDays' | 'showLaterDays' | 'more' | 'calendarView' | 'viewLabel';
+export type ResolvedMessages = Readonly<Record<MessageKey, string>>;
+export declare function getMessages(locale: string): ResolvedMessages;
+//# sourceMappingURL=messages.d.ts.map

package/dist/lib/messages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../../src/lib/messages.ts"],"names":[],"mappings":"AA8CA,MAAM,MAAM,UAAU,GAChB,KAAK,GACL,MAAM,GACN,OAAO,GACP,cAAc,GACd,QAAQ,GACR,OAAO,GACP,SAAS,GACT,WAAW,GACX,QAAQ,GACR,cAAc,GACd,aAAa,GACb,OAAO,GACP,MAAM,GACN,MAAM,GACN,OAAO,GACP,OAAO,GACP,cAAc,GACd,MAAM,GACN,UAAU,GACV,MAAM,GACN,QAAQ,GACR,eAAe,GACf,aAAa,GACb,IAAI,GACJ,iBAAiB,GACjB,iBAAiB,GACjB,eAAe,GACf,MAAM,GACN,cAAc,GACd,WAAW,CAAC;AAElB,MAAM,MAAM,gBAAgB,GAAG,QAAQ,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC;AA2CpE,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,gBAAgB,CAY5D"}

package/dist/lib/partitionOverlappingIntervals.d.ts

@@ -0,0 +1,6 @@
+/** This is an implementation of the sweep-line algorithm
+ *  Ref: https://www.baeldung.com/cs/finding-all-overlapping-intervals \
+ *  Example: https://stackoverflow.com/questions/30472556/how-to-find-all-overlapping-ranges-and-partition-them-into-chunks
+ */
+export default function partitionOverlappingIntervals(intervals: Array<Interval>): Array<Interval[]>;
+//# sourceMappingURL=partitionOverlappingIntervals.d.ts.map

package/dist/lib/partitionOverlappingIntervals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"partitionOverlappingIntervals.d.ts","sourceRoot":"","sources":["../../src/lib/partitionOverlappingIntervals.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAC,OAAO,UAAU,6BAA6B,CACjD,SAAS,EAAE,KAAK,CAAC,QAAQ,CAAC,GAC3B,KAAK,CAAC,QAAQ,EAAE,CAAC,CA8BnB"}

package/dist/lib/weekDisplayContext.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Week display context — computes the visible day subset for condensed week views.
+ *
+ * Pure function (apart from a single `getComputedStyle` read for CSS tokens).
+ * Designed for easy unit testing by passing a mock host element.
+ */
+import { type FirstDayOfWeek } from './weekStartHelper.js';
+export interface WeekDisplayContext {
+    /** Full 7-day week dates. */
+    weekDates: CalendarDate[];
+    /** Subset actually shown (same as weekDates when not condensed). */
+    visibleDates: CalendarDate[];
+    /** Offset into weekDates where visibleDates starts. */
+    visibleStartIndex: number;
+    /** How many columns are visible. */
+    visibleLength: number;
+    /** True when showing fewer than 7 days. */
+    isCondensed: boolean;
+    /** CSS grid-template-columns value for the week grid. */
+    gridColumns: string;
+}
+/**
+ * Compute the week display context based on CSS custom properties and viewport width.
+ *
+ * Reads three tokens from `hostEl`:
+ * - `--week-day-count` (default 7): full-width column count
+ * - `--week-mobile-day-count` (default 3): condensed column count below breakpoint
+ * - `--week-mobile-breakpoint` (default 768px): width threshold
+ */
+export declare function computeWeekDisplayContext(activeDate: CalendarDate, firstDayOfWeek: FirstDayOfWeek, calendarWidth: number, hostEl: Element): WeekDisplayContext;
+//# sourceMappingURL=weekDisplayContext.d.ts.map

package/dist/lib/weekDisplayContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"weekDisplayContext.d.ts","sourceRoot":"","sources":["../../src/lib/weekDisplayContext.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,KAAK,cAAc,EAAgB,MAAM,sBAAsB,CAAC;AAEzE,MAAM,WAAW,kBAAkB;IAC/B,6BAA6B;IAC7B,SAAS,EAAE,YAAY,EAAE,CAAC;IAC1B,oEAAoE;IACpE,YAAY,EAAE,YAAY,EAAE,CAAC;IAC7B,uDAAuD;IACvD,iBAAiB,EAAE,MAAM,CAAC;IAC1B,oCAAoC;IACpC,aAAa,EAAE,MAAM,CAAC;IACtB,2CAA2C;IAC3C,WAAW,EAAE,OAAO,CAAC;IACrB,yDAAyD;IACzD,WAAW,EAAE,MAAM,CAAC;CACvB;AAoCD;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CACrC,UAAU,EAAE,YAAY,EACxB,cAAc,EAAE,cAAc,EAC9B,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE,OAAO,GAChB,kBAAkB,CAwCpB"}

package/dist/lib/weekStartHelper.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Week-start helpers — centralizes the "first day of week" offset math
+ * that was previously duplicated across lms-calendar.ts, Week.ts, Month.ts,
+ * and SlotManager.ts.
+ *
+ * All functions are pure and dependency-free (only JS Date + CalendarDate).
+ */
+/**
+ * Supported first-day-of-week values (JS Date convention).
+ * 0 = Sunday, 1 = Monday (ISO 8601 default), 6 = Saturday
+ */
+export type FirstDayOfWeek = 0 | 1 | 2 | 3 | 4 | 5 | 6;
+/**
+ * How many days to subtract from `jsDayOfWeek` to reach `firstDay`.
+ *
+ * JS Date.getDay(): 0 = Sun, 1 = Mon, ..., 6 = Sat
+ *
+ * @example getWeekStartOffset(0, 1) // Sunday when Monday-first → 6
+ * @example getWeekStartOffset(1, 1) // Monday when Monday-first → 0
+ * @example getWeekStartOffset(0, 0) // Sunday when Sunday-first → 0
+ */
+export declare function getWeekStartOffset(jsDayOfWeek: number, firstDay: FirstDayOfWeek): number;
+/**
+ * Return the 7 CalendarDate values of the week containing `activeDate`,
+ * starting from `firstDay`.
+ */
+export declare function getWeekDates(activeDate: CalendarDate, firstDay: FirstDayOfWeek): CalendarDate[];
+/**
+ * Column offset for the 1st of a month in a week-start-aware grid.
+ *
+ * @example getFirstDayOffset({ year: 2026, month: 1, day: 1 }, 1) // Thu → 3
+ * @example getFirstDayOffset({ year: 2026, month: 1, day: 1 }, 0) // Thu → 4
+ */
+export declare function getFirstDayOffset(date: CalendarDate, firstDay: FirstDayOfWeek): number;
+/**
+ * Map Luxon weekday numbers to display order for a given firstDay.
+ * Returns an array of 7 Luxon weekday numbers (1 = Mon ... 7 = Sun).
+ *
+ * @example getWeekdayOrder(1) // Monday-first → [1, 2, 3, 4, 5, 6, 7]
+ * @example getWeekdayOrder(0) // Sunday-first → [7, 1, 2, 3, 4, 5, 6]
+ */
+export declare function getWeekdayOrder(firstDay: FirstDayOfWeek): number[];
+/**
+ * Look up the conventional first day of week for a given locale tag.
+ *
+ * Resolution order:
+ * 1. Exact match (e.g., "en-US")
+ * 2. Language-only fallback (e.g., "en")
+ * 3. Default to Monday (ISO 8601)
+ *
+ * @example getFirstDayForLocale('en-US') // 0 (Sunday)
+ * @example getFirstDayForLocale('de')    // 1 (Monday)
+ * @example getFirstDayForLocale('ar')    // 6 (Saturday)
+ * @example getFirstDayForLocale('xx')    // 1 (Monday, default)
+ */
+export declare function getFirstDayForLocale(locale: string): FirstDayOfWeek;
+//# sourceMappingURL=weekStartHelper.d.ts.map

package/dist/lib/weekStartHelper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"weekStartHelper.d.ts","sourceRoot":"","sources":["../../src/lib/weekStartHelper.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAEvD;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,GAAG,MAAM,CAExF;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,UAAU,EAAE,YAAY,EAAE,QAAQ,EAAE,cAAc,GAAG,YAAY,EAAE,CAW/F;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,YAAY,EAAE,QAAQ,EAAE,cAAc,GAAG,MAAM,CAGtF;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,cAAc,GAAG,MAAM,EAAE,CAKlE;AAgDD;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,CAcnE"}

package/dist/lms-calendar.d.ts

@@ -0,0 +1,166 @@
+import { LitElement, PropertyValueMap } from 'lit';
+import { Interval } from 'luxon';
+import LMSCalendarContext from './components/Context';
+import './components/Context.js';
+import LMSCalendarDay from './components/Day';
+import './components/Day.js';
+import LMSCalendarEntry from './components/Entry';
+import './components/Entry.js';
+import LMSCalendarHeader from './components/Header';
+import './components/Header.js';
+import LMSCalendarMenu from './components/Menu';
+import './components/Menu.js';
+import LMSCalendarMonth from './components/Month';
+import './components/Month.js';
+import LMSCalendarWeek from './components/Week';
+import './components/Week.js';
+import LMSCalendarYear from './components/Year';
+import './components/Year.js';
+import type { DensityMode, DrillTarget } from './components/Year.js';
+import { type FirstDayOfWeek } from './lib/SlotManager.js';
+export default class LMSCalendar extends LitElement {
+    heading?: string;
+    firstDayOfWeek: FirstDayOfWeek;
+    locale: string;
+    yearDrillTarget: DrillTarget;
+    yearDensityMode: DensityMode;
+    private _viewState;
+    get activeDate(): CalendarDate;
+    set activeDate(value: CalendarDate);
+    entries: CalendarEntry[];
+    color: string;
+    get _expandedDate(): CalendarDate | undefined;
+    _calendarWidth: number;
+    _menuOpen: boolean;
+    _menuEventDetails?: {
+        heading: string;
+        content: string;
+        time?: CalendarTimeInterval;
+        displayTime: string;
+        date?: CalendarDate;
+        anchorRect?: DOMRect;
+    };
+    private _menuTriggerEntry?;
+    private _processedEntries;
+    /** All entries expanded across their date spans (shared by every view). */
+    private _expandedEntries;
+    /** Month view: sorted + color-annotated, ready for _renderEntries. */
+    private _monthViewSorted;
+    /** Mobile badge view: per-day event counts, ready for _renderEntriesSumByDay. */
+    private _entrySumByDay;
+    /** Day/week view: expanded entries grouped by ISO date for O(1) lookup. */
+    private _expandedByISODate;
+    /** Day/week view: cached LayoutCalculator results keyed by ISO date. */
+    private _layoutCache;
+    /** Day/week view: cached all-day row assignments keyed by week/day key. */
+    private _allDayLayoutCache;
+    private _layoutCalculator;
+    private _handleResize;
+    private _resizeController;
+    static styles: import("lit").CSSResult;
+    disconnectedCallback(): void;
+    protected updated(changedProperties: PropertyValueMap<never> | Map<PropertyKey, unknown>): void;
+    private _handleClickOutside;
+    private _handleEscape;
+    private _closeMenuAndClearSelections;
+    private _returnFocusToTrigger;
+    protected firstUpdated(_changedProperties: PropertyValueMap<never> | Map<PropertyKey, unknown>): void;
+    /** We filter invalid entries in the willUpdate hook, so be prepared:
+     *  - This will not be shown
+     *   ```json
+     *   { date: ..., time: { start: { hour: 10, minute: 30 }, end: { hour: 10, minute: 00 } } }
+     *  ```
+     *  - The same goes for invalid dates meaning the end date being before the start date.
+     *
+     *  We then sort the entries inplace.
+     */
+    protected willUpdate(changedProperties: PropertyValueMap<never> | Map<PropertyKey, unknown>): void;
+    private _clearEntryCaches;
+    private _computeEntryCaches;
+    render(): import("lit").TemplateResult<1>;
+    private _handleSwitchDate;
+    private _handleSwitchView;
+    private _handleJumpToday;
+    private _handlePeekNavigate;
+    private _handleExpand;
+    private _handleOpenMenu;
+    private _handleClearOtherSelections;
+    private _handleMenuClose;
+    openMenu(eventDetails: {
+        heading: string;
+        content: string;
+        time?: CalendarTimeInterval;
+        displayTime: string;
+        date?: CalendarDate;
+        anchorRect?: DOMRect;
+    }): void;
+    private _composeEntry;
+    private _determineDensity;
+    /** Create an array of <lms-calendar-entry> elements for each day the entry spans
+     *  and add them to the entries array. */
+    private _expandEntryMaybe;
+    private _createConsistentEventId;
+    private _renderEntries;
+    private _renderEntriesByDate;
+    private _renderEntriesWithSlotManager;
+    private _renderDayEntriesWithSlotManager;
+    private _renderEntriesSumByDay;
+    private _getSmartLayout;
+    private _getDaysRange;
+    private _isEffectivelyAllDay;
+    private _isAllDayEvent;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'lms-calendar': LMSCalendar;
+        'lms-calendar-header': LMSCalendarHeader;
+        'lms-calendar-month': LMSCalendarMonth;
+        'lms-calendar-week': LMSCalendarWeek;
+        'lms-calendar-day': LMSCalendarDay;
+        'lms-calendar-context': LMSCalendarContext;
+        'lms-calendar-entry': LMSCalendarEntry;
+        'lms-calendar-menu': LMSCalendarMenu;
+        'lms-calendar-year': LMSCalendarYear;
+    }
+    type CalendarTime = {
+        hour: number;
+        minute: number;
+    };
+    type CalendarDateInterval = {
+        start: CalendarDate;
+        end: CalendarDate;
+    };
+    type CalendarEntry = {
+        date: CalendarDateInterval;
+        time: CalendarTimeInterval;
+        heading: string;
+        content: string;
+        color: string;
+        isContinuation: boolean;
+        continuation?: Continuation;
+    };
+    type Continuation = {
+        has: boolean;
+        is: boolean;
+        index: number;
+        total: number;
+    };
+    type Interval = {
+        start: number;
+        end: number;
+    };
+    type Grading = {
+        index: number;
+        depth: number;
+        group: number;
+    };
+    type Partition = {
+        index?: number;
+        depth?: number;
+        group?: number;
+        start: number;
+        end: number;
+    };
+}
+export { CalendarDate, CalendarDateInterval, CalendarEntry, CalendarTime, CalendarTimeInterval, Continuation, Grading, Interval, Partition, };
+//# sourceMappingURL=lms-calendar.d.ts.map