@gobrand/calendar-core 0.0.17 → 0.0.19

package/dist/index.cjs

@@ -82,16 +82,6 @@ function goToToday() {
   const today = import_polyfill.Temporal.Now.plainDateISO();
   return { year: today.year, month: today.month };
 }
-function getWeekdays(weekStartsOn = 1, locale = "en-US", format = "short") {
-  const referenceDate = import_polyfill.Temporal.PlainDate.from("2023-01-02");
-  const days = [];
-  for (let i = 0; i < 7; i++) {
-    const offset = (weekStartsOn - 1 + i + 7) % 7;
-    const date = referenceDate.add({ days: offset });
-    days.push(date.toLocaleString(locale, { weekday: format }));
-  }
-  return days;
-}
 function getMonthName(month, locale = "en-US") {
   return month.toPlainDate({ day: 1 }).toLocaleString(locale, { month: "long" });
 }
@@ -187,6 +177,7 @@ function buildMonth(year, month, options) {
     }
     const dateKey = currentDate.toString();
     weeks[weeks.length - 1].push({
+      id: `${yearMonth.toString()}-${dateKey}`,
       date: currentDate,
       isCurrentMonth: currentDate.month === month,
       isToday: import_polyfill2.Temporal.PlainDate.compare(currentDate, today) === 0,
@@ -214,7 +205,7 @@ var import_polyfill3 = require("@js-temporal/polyfill");
 function buildDay(date, options) {
   const startHour = options?.startHour ?? 0;
   const endHour = options?.endHour ?? 24;
-  const slotDuration = options?.slotDuration ?? 30;
+  const slotDuration = options?.slotDuration ?? 60;
   const today = options?.today ?? import_polyfill3.Temporal.Now.plainDateISO();
   const data = options?.data ?? [];
   const accessor = options?.accessor;
@@ -228,6 +219,7 @@ function buildDay(date, options) {
     }
   }
   const timeSlots = [];
+  const dateStr = date.toString();
   let currentHour = startHour;
   let currentMinute = 0;
   while (currentHour < endHour) {
@@ -254,6 +246,7 @@ function buildDay(date, options) {
       }
     }
     timeSlots.push({
+      id: `${dateStr}-${String(currentHour).padStart(2, "0")}:${String(currentMinute).padStart(2, "0")}`,
       hour: currentHour,
       minute: currentMinute,
       time: slotStart,
@@ -266,6 +259,7 @@ function buildDay(date, options) {
     }
   }
   return {
+    id: dateStr,
     date,
     isToday: import_polyfill3.Temporal.PlainDate.compare(date, today) === 0,
     timeSlots,
@@ -312,6 +306,7 @@ function buildWeek(date, options) {
       timeSlots = dayView.timeSlots;
     }
     days.push({
+      id: `${weekStart.toString()}-${dateKey}`,
       date: currentDate,
       isToday: import_polyfill4.Temporal.PlainDate.compare(currentDate, today) === 0,
       items: itemsByDate.get(dateKey) ?? [],
@@ -384,8 +379,20 @@ function getDayDateRange(date, timeZone) {
   return { start: startZoned, end: endZoned };
 }
 
-// src/core/calendar.ts
+// src/utils/getWeekdays.ts
 var import_polyfill6 = require("@js-temporal/polyfill");
+function getWeekdays(weekStartsOn = 1, locale = "en-US", format = "short") {
+  const sunday = import_polyfill6.Temporal.PlainDate.from("2023-01-01");
+  const days = [];
+  for (let i = 0; i < 7; i++) {
+    const date = sunday.add({ days: (weekStartsOn + i) % 7 });
+    days.push(date.toLocaleString(locale, { weekday: format }));
+  }
+  return days;
+}
+
+// src/core/calendar.ts
+var import_polyfill7 = require("@js-temporal/polyfill");
 var import_store = require("@tanstack/store");
 function computeDateRange(view, referenceDate, timeZone, weekStartsOn = 1) {
   let start;
@@ -410,22 +417,22 @@ function computeDateRange(view, referenceDate, timeZone, weekStartsOn = 1) {
   }
   const startZoned = start.toZonedDateTime({
     timeZone,
-    plainTime: import_polyfill6.Temporal.PlainTime.from("00:00:00")
+    plainTime: import_polyfill7.Temporal.PlainTime.from("00:00:00")
   });
   const endZoned = end.toZonedDateTime({
     timeZone,
-    plainTime: import_polyfill6.Temporal.PlainTime.from("23:59:59.999")
+    plainTime: import_polyfill7.Temporal.PlainTime.from("23:59:59.999")
   });
   return { start: startZoned, end: endZoned };
 }
 function createCalendar(options) {
   const configuredViews = Object.keys(options.views);
   const defaultView = configuredViews[0];
-  const timeZone = options.timeZone || import_polyfill6.Temporal.Now.timeZoneId();
+  const timeZone = options.timeZone || import_polyfill7.Temporal.Now.timeZoneId();
   const monthView = options.views.month;
   const weekView = options.views.week;
   const weekStartsOn = monthView?.weekStartsOn ?? weekView?.weekStartsOn ?? 1;
-  const initialReferenceDate = options.state?.referenceDate || import_polyfill6.Temporal.Now.plainDateISO();
+  const initialReferenceDate = options.state?.referenceDate || import_polyfill7.Temporal.Now.plainDateISO();
   const initialView = options.state?.currentView || defaultView;
   const initialDateRange = computeDateRange(
     initialView,
@@ -450,18 +457,18 @@ function createCalendar(options) {
     dateRange: initialDateRange,
     ...resolvedOptions.state
   });
-  const getMonthImpl = () => {
+  const getMonthImpl = (data = []) => {
     const state = store.state;
     const { year, month } = state.referenceDate;
     const monthView2 = _options.views.month;
     if (!monthView2) throw new Error("Month view not configured");
     return buildMonth(year, month, {
       weekStartsOn: monthView2.weekStartsOn,
-      data: _options.data,
+      data,
       accessor: monthView2.accessor
     });
   };
-  const getWeekImpl = () => {
+  const getWeekImpl = (data = []) => {
     const state = store.state;
     const weekView2 = _options.views.week;
     if (!weekView2) throw new Error("Week view not configured");
@@ -470,11 +477,11 @@ function createCalendar(options) {
       startHour: weekView2.startHour,
       endHour: weekView2.endHour,
       slotDuration: weekView2.slotDuration,
-      data: _options.data,
+      data,
       accessor: weekView2.accessor
     });
   };
-  const getDayImpl = () => {
+  const getDayImpl = (data = []) => {
     const state = store.state;
     const dayView = _options.views.day;
     if (!dayView) throw new Error("Day view not configured");
@@ -482,7 +489,7 @@ function createCalendar(options) {
       startHour: dayView.startHour,
       endHour: dayView.endHour,
       slotDuration: dayView.slotDuration,
-      data: _options.data,
+      data,
       accessor: dayView.accessor
     });
   };
@@ -510,7 +517,7 @@ function createCalendar(options) {
   };
   const nextMonthImpl = () => {
     setStateImpl((old) => {
-      const current = import_polyfill6.Temporal.PlainYearMonth.from({
+      const current = import_polyfill7.Temporal.PlainYearMonth.from({
         year: old.referenceDate.year,
         month: old.referenceDate.month
       });
@@ -522,7 +529,7 @@ function createCalendar(options) {
   };
   const previousMonthImpl = () => {
     setStateImpl((old) => {
-      const current = import_polyfill6.Temporal.PlainYearMonth.from({
+      const current = import_polyfill7.Temporal.PlainYearMonth.from({
         year: old.referenceDate.year,
         month: old.referenceDate.month
       });
@@ -607,7 +614,7 @@ function createCalendar(options) {
     previousMonth: previousMonthImpl,
     goToMonth(year, month) {
       setStateImpl(() => ({
-        referenceDate: import_polyfill6.Temporal.PlainDate.from({ year, month, day: 1 })
+        referenceDate: import_polyfill7.Temporal.PlainDate.from({ year, month, day: 1 })
       }));
     },
     nextWeek: nextWeekImpl,
@@ -616,7 +623,7 @@ function createCalendar(options) {
     previousDay: previousDayImpl,
     goToToday() {
       setStateImpl(() => ({
-        referenceDate: import_polyfill6.Temporal.Now.plainDateISO()
+        referenceDate: import_polyfill7.Temporal.Now.plainDateISO()
       }));
     },
     goToDate(date) {
@@ -667,6 +674,15 @@ function createCalendar(options) {
     get dateRange() {
       return store.state.dateRange;
     },
+    getDateRange(view) {
+      const effectiveView = view ?? store.state.currentView ?? defaultView;
+      return computeDateRange(
+        effectiveView,
+        store.state.referenceDate,
+        timeZone,
+        weekStartsOn
+      );
+    },
     get options() {
       return _options;
     },

package/dist/index.d.cts

@@ -7,6 +7,8 @@ type CalendarAccessor<TItem> = {
     getEnd?: (item: TItem) => Temporal.ZonedDateTime;
 };
 type CalendarDay<TItem = unknown> = {
+    /** Unique identifier for this day within the view context. Use as React/Vue key. */
+    id: string;
     date: Temporal.PlainDate;
     isCurrentMonth: boolean;
     isToday: boolean;
@@ -18,6 +20,8 @@ type CalendarMonth<TItem = unknown> = {
     month: Temporal.PlainYearMonth;
 };
 type WeekDay<TItem = unknown> = {
+    /** Unique identifier for this day within the view context. Use as React/Vue key. */
+    id: string;
     date: Temporal.PlainDate;
     isToday: boolean;
     items: TItem[];
@@ -29,12 +33,16 @@ type CalendarWeekView<TItem = unknown> = {
     weekEnd: Temporal.PlainDate;
 };
 type TimeSlot<TItem = unknown> = {
+    /** Unique identifier for this time slot. Use as React/Vue key. */
+    id: string;
     hour: number;
     minute: number;
     time: Temporal.PlainTime;
     items: TItem[];
 };
 type CalendarDayView<TItem = unknown> = {
+    /** Unique identifier for this day view. Use as React/Vue key. */
+    id: string;
     date: Temporal.PlainDate;
     isToday: boolean;
     timeSlots: TimeSlot<TItem>[];
@@ -73,17 +81,16 @@ type CalendarViewOptions<TItem> = {
     day?: DayViewOptions<TItem>;
 };
 type CalendarOptions<TItem> = {
-    data: TItem[];
     views: CalendarViewOptions<TItem>;
     timeZone?: 'UTC' | string;
     state?: Partial<CalendarState>;
-    onStateChange?: (updater: Updater<CalendarState>) => void;
+    onStateChange?: (state: CalendarState) => void;
 };
 type HasView<Options, View extends 'month' | 'week' | 'day'> = Options extends {
     views: infer V;
 } ? V extends Record<View, unknown> ? V[View] extends undefined ? false : true : false : false;
 type MonthMethods<TItem, TOptions> = HasView<TOptions, 'month'> extends true ? {
-    getMonth(): CalendarMonth<TItem>;
+    getMonth(data?: TItem[]): CalendarMonth<TItem>;
     nextMonth(): void;
     previousMonth(): void;
     goToMonth(year: number, month: number): void;
@@ -94,7 +101,7 @@ type MonthMethods<TItem, TOptions> = HasView<TOptions, 'month'> extends true ? {
     goToMonth?: never;
 };
 type WeekMethods<TItem, TOptions> = HasView<TOptions, 'week'> extends true ? {
-    getWeek(): CalendarWeekView<TItem>;
+    getWeek(data?: TItem[]): CalendarWeekView<TItem>;
     nextWeek(): void;
     previousWeek(): void;
 } : {
@@ -103,7 +110,7 @@ type WeekMethods<TItem, TOptions> = HasView<TOptions, 'week'> extends true ? {
     previousWeek?: never;
 };
 type DayMethods<TItem, TOptions> = HasView<TOptions, 'day'> extends true ? {
-    getDay(): CalendarDayView<TItem>;
+    getDay(data?: TItem[]): CalendarDayView<TItem>;
     nextDay(): void;
     previousDay(): void;
 } : {
@@ -126,6 +133,7 @@ type BaseCalendarMethods<Options> = {
     currentView: ValidViews<Options>;
     setCurrentView(view: ValidViews<Options>): void;
     dateRange: DateRange;
+    getDateRange(view?: ValidViews<Options>): DateRange;
     options: Options;
     setOptions(updater: (old: Options) => Options): void;
     store: _tanstack_store.Store<CalendarState>;
@@ -133,71 +141,145 @@ type BaseCalendarMethods<Options> = {
     hasWeekView(): boolean;
     hasDayView(): boolean;
 };
-type ViewsToOptions<TItem, TViews extends CalendarViewOptions<TItem>> = {
-    data: TItem[];
-    views: TViews;
+/**
+ * Unified calendar type with conditional methods based on configured views.
+ *
+ * @example
+ * // Calendar with specific options - methods are conditional
+ * const calendar = createCalendar<Post, typeof options>(options);
+ * calendar.getMonth([]); // Only available if month view configured
+ *
+ * @example
+ * // Generic calendar type - all methods available
+ * type AnyPostCalendar = Calendar<Post>;
+ */
+type Calendar<TItem, TOptions extends CalendarOptions<TItem> = CalendarOptions<TItem>> = BaseCalendarMethods<TOptions> & MonthMethods<TItem, TOptions> & WeekMethods<TItem, TOptions> & DayMethods<TItem, TOptions>;
+/**
+ * Calendar instance with all view methods available and typed items.
+ * Use this for contexts where the specific view configuration is unknown at compile time,
+ * but you still want type-safe item data.
+ *
+ * @example
+ * // In React context - store with unknown, consume with specific type
+ * const context = createContext<CalendarInstance<unknown> | null>(null);
+ *
+ * // Consumer gets typed data
+ * function useCalendar<TItem>(): CalendarInstance<TItem> {
+ *   return useContext(context) as CalendarInstance<TItem>;
+ * }
+ */
+type CalendarInstance<TItem = unknown> = {
+    getMonth(data?: TItem[]): CalendarMonth<TItem>;
+    getWeek(data?: TItem[]): CalendarWeekView<TItem>;
+    getDay(data?: TItem[]): CalendarDayView<TItem>;
+    getTitle(view?: ViewType, locales?: Temporal.LocalesArgument, options?: globalThis.Intl.DateTimeFormatOptions): string;
+    getState(): CalendarState;
+    setState(updater: CalendarState | ((old: CalendarState) => Partial<CalendarState>)): void;
+    goToToday(): void;
+    goToDate(date: Temporal.PlainDate): void;
+    next(view?: ViewType): void;
+    previous(view?: ViewType): void;
+    views: ReadonlyArray<string>;
+    currentView: string;
+    setCurrentView(view: string): void;
+    dateRange: DateRange;
+    getDateRange(view?: ViewType): DateRange;
+    options: CalendarOptions<TItem>;
+    setOptions(updater: (old: CalendarOptions<TItem>) => CalendarOptions<TItem>): void;
+    store: _tanstack_store.Store<CalendarState>;
+    nextMonth(): void;
+    previousMonth(): void;
+    goToMonth(year: number, month: number): void;
+    nextWeek(): void;
+    previousWeek(): void;
+    nextDay(): void;
+    previousDay(): void;
+    hasMonthView(): boolean;
+    hasWeekView(): boolean;
+    hasDayView(): boolean;
 };
-type Calendar<TItem, TOptionsOrViews = CalendarOptions<TItem>> = TOptionsOrViews extends CalendarOptions<TItem> ? BaseCalendarMethods<TOptionsOrViews> & MonthMethods<TItem, TOptionsOrViews> & WeekMethods<TItem, TOptionsOrViews> & DayMethods<TItem, TOptionsOrViews> : TOptionsOrViews extends CalendarViewOptions<TItem> ? BaseCalendarMethods<ViewsToOptions<TItem, TOptionsOrViews>> & MonthMethods<TItem, ViewsToOptions<TItem, TOptionsOrViews>> & WeekMethods<TItem, ViewsToOptions<TItem, TOptionsOrViews>> & DayMethods<TItem, ViewsToOptions<TItem, TOptionsOrViews>> : BaseCalendarMethods<CalendarOptions<TItem>> & MonthMethods<TItem, CalendarOptions<TItem>> & WeekMethods<TItem, CalendarOptions<TItem>> & DayMethods<TItem, CalendarOptions<TItem>>;
-type InferViewNames<V extends CalendarViewOptions<unknown>> = keyof V & string;
-type InferViewConfig<V extends CalendarViewOptions<unknown>, Name extends keyof V> = V[Name] extends infer Config ? {
-    name: Name;
-    config: Config;
-} : never;
 /**
- * Extract the item type from a Calendar type
+ * Extract the item type from a Calendar's options
  * @example type Item = CalendarItemType<typeof calendar>; // Post
  */
-type CalendarItemType<C extends Calendar<any, any>> = C extends Calendar<infer TItem, any> ? TItem : never;
+type CalendarItemType<C extends CalendarInstance> = C['options'] extends CalendarOptions<infer TItem> ? TItem : never;
 /**
  * Extract the views configuration from a Calendar type
  * @example type Views = CalendarViewsConfig<typeof calendar>;
  */
-type CalendarViewsConfig<C extends Calendar<any, any>> = C extends Calendar<any, infer TOptions> ? TOptions extends {
+type CalendarViewsConfig<C extends CalendarInstance> = C['options'] extends {
     views: infer V;
-} ? V : TOptions extends CalendarViewOptions<any> ? TOptions : never : never;
+} ? V : never;
 /**
  * Check if a Calendar has a specific view configured
  * @example type HasMonth = HasViewType<typeof calendar, 'month'>; // true | false
  */
-type HasViewType<C extends Calendar<any, any>, V extends 'month' | 'week' | 'day'> = C extends Calendar<any, infer TOptions> ? HasView<TOptions, V> : false;
+type HasViewType<C extends CalendarInstance, V extends 'month' | 'week' | 'day'> = C['options'] extends CalendarOptions<infer TItem> ? HasView<C['options'], V> : false;
 /**
  * Extract valid view names as a union from a Calendar
  * @example type Views = ValidViewNames<typeof calendar>; // 'month' | 'week'
  */
-type ValidViewNames<C extends Calendar<any, any>> = C extends Calendar<any, infer TOptions> ? ValidViews<TOptions> : never;
-/**
- * Extract the item type from CalendarOptions before creating a calendar
- * @example type Item = ItemTypeFromOptions<typeof options>; // Post
- */
-type ItemTypeFromOptions<O extends CalendarOptions<any>> = O extends CalendarOptions<infer TItem> ? TItem : never;
+type ValidViewNames<C extends CalendarInstance> = C['options'] extends CalendarOptions<infer TItem> ? ValidViews<C['options']> : never;
 /**
  * Base props for components that receive a Calendar
  * @example
- * function MyComponent<C extends Calendar<any, any>>(
+ * function MyComponent<C extends CalendarInstance>(
  *   props: CalendarComponentProps<C>
  * ) { ... }
  */
-type CalendarComponentProps<C extends Calendar<any, any>> = {
+type CalendarComponentProps<C extends CalendarInstance> = {
     calendar: C;
 };
 /**
  * Require that a Calendar has month view configured
  * @example
- * function MonthView<C extends Calendar<any, any>>(
+ * function MonthView<C extends CalendarInstance>(
  *   props: { calendar: RequireMonthView<C> }
  * ) {
  *   // calendar.getMonth() is guaranteed to exist
  * }
  */
-type RequireMonthView<C extends Calendar<any, any>> = HasViewType<C, 'month'> extends true ? C : never;
+type RequireMonthView<C extends CalendarInstance> = HasViewType<C, 'month'> extends true ? C : never;
 /**
  * Require that a Calendar has week view configured
  */
-type RequireWeekView<C extends Calendar<any, any>> = HasViewType<C, 'week'> extends true ? C : never;
+type RequireWeekView<C extends CalendarInstance> = HasViewType<C, 'week'> extends true ? C : never;
 /**
  * Require that a Calendar has day view configured
  */
-type RequireDayView<C extends Calendar<any, any>> = HasViewType<C, 'day'> extends true ? C : never;
+type RequireDayView<C extends CalendarInstance> = HasViewType<C, 'day'> extends true ? C : never;
+/**
+ * Built-in view types
+ */
+type ViewType = 'month' | 'week' | 'day';
+/**
+ * Discriminated union of all view results
+ */
+type ViewResult<TItem> = {
+    type: 'month';
+    data: CalendarMonth<TItem>;
+} | {
+    type: 'week';
+    data: CalendarWeekView<TItem>;
+} | {
+    type: 'day';
+    data: CalendarDayView<TItem>;
+};
+/**
+ * Conditional type that narrows ViewResult based on view name
+ * - If V is a specific view type, returns that specific result
+ * - If V is undefined, returns the full discriminated union
+ */
+type ViewResultFor<TItem, V extends ViewType | undefined> = V extends 'month' ? {
+    type: 'month';
+    data: CalendarMonth<TItem>;
+} : V extends 'week' ? {
+    type: 'week';
+    data: CalendarWeekView<TItem>;
+} : V extends 'day' ? {
+    type: 'day';
+    data: CalendarDayView<TItem>;
+} : ViewResult<TItem>;
 
 declare function functionalUpdate<T>(updater: T | ((old: T) => T), input: T): T;
 declare function createCalendarAccessor<T, A extends CalendarAccessor<T> = CalendarAccessor<T>>(accessor: A): A;
@@ -211,7 +293,6 @@ declare function goToToday(): {
     year: number;
     month: number;
 };
-declare function getWeekdays(weekStartsOn?: 0 | 1 | 2 | 3 | 4 | 5 | 6, locale?: string | string[], format?: 'short' | 'long' | 'narrow'): string[];
 declare function getMonthName(month: Temporal.PlainYearMonth, locale?: string): string;
 declare function formatTime(time: Temporal.PlainTime, locale?: string): string;
 declare function getTimeSlotHeight(slotDuration: number, hourHeight: number): number;
@@ -292,6 +373,16 @@ declare function getWeekDateRange(date: Temporal.PlainDate, timeZone: string, op
  */
 declare function getDayDateRange(date: Temporal.PlainDate, timeZone: string): DateRange;
 
+/**
+ * Returns an array of weekday names starting from the specified day.
+ *
+ * @param weekStartsOn - Day the week starts on (0=Sunday, 1=Monday, ..., 6=Saturday). Defaults to 1 (Monday).
+ * @param locale - Locale for formatting weekday names. Defaults to 'en-US'.
+ * @param format - Format for weekday names: 'short' (Mon), 'long' (Monday), or 'narrow' (M). Defaults to 'short'.
+ * @returns Array of 7 weekday names starting from weekStartsOn.
+ */
+declare function getWeekdays(weekStartsOn?: 0 | 1 | 2 | 3 | 4 | 5 | 6, locale?: string | string[], format?: 'short' | 'long' | 'narrow'): string[];
+
 declare function createCalendar<TItem, TOptions extends CalendarOptions<TItem>>(options: TOptions): Calendar<TItem, TOptions>;
 
 declare function createCalendarViews<TItem>(): <const TViews extends {
@@ -300,4 +391,4 @@ declare function createCalendarViews<TItem>(): <const TViews extends {
     day?: DayViewOptions<TItem>;
 }>(views: TViews) => TViews;
 
-export { type Calendar, type CalendarAccessor, type CalendarComponentProps, type CalendarDay, type CalendarDayView, type CalendarItemType, type CalendarMonth, type CalendarOptions, type CalendarState, type CalendarViewOptions, type CalendarViewsConfig, type CalendarWeek, type CalendarWeekView, type DateRange, type DateRangeBounds, type DayViewOptions, type HasViewType, type InferViewConfig, type InferViewNames, type ItemTypeFromOptions, type MonthViewOptions, type RequireDayView, type RequireMonthView, type RequireWeekView, type TimeSlot, type Updater, type ValidViewNames, type WeekDay, type WeekViewOptions, buildDay, buildMonth, buildWeek, convertToTimezone, createCalendar, createCalendarAccessor, createCalendarViews, createZonedDateTime, formatTime, functionalUpdate, getCurrentTimeZone, getDayDateRange, getDayRange, getEventPosition, getMonthDateRange, getMonthName, getMonthRange, getTimeSlotHeight, getTimezoneOffset, getWeekDateRange, getWeekRange, getWeekdays, goToToday, nextDay, nextMonth, nextWeek, previousDay, previousMonth, previousWeek };
+export { type Calendar, type CalendarAccessor, type CalendarComponentProps, type CalendarDay, type CalendarDayView, type CalendarInstance, type CalendarItemType, type CalendarMonth, type CalendarOptions, type CalendarState, type CalendarViewOptions, type CalendarViewsConfig, type CalendarWeek, type CalendarWeekView, type DateRange, type DateRangeBounds, type DayViewOptions, type HasViewType, type MonthViewOptions, type RequireDayView, type RequireMonthView, type RequireWeekView, type TimeSlot, type Updater, type ValidViewNames, type ViewResult, type ViewResultFor, type ViewType, type WeekDay, type WeekViewOptions, buildDay, buildMonth, buildWeek, convertToTimezone, createCalendar, createCalendarAccessor, createCalendarViews, createZonedDateTime, formatTime, functionalUpdate, getCurrentTimeZone, getDayDateRange, getDayRange, getEventPosition, getMonthDateRange, getMonthName, getMonthRange, getTimeSlotHeight, getTimezoneOffset, getWeekDateRange, getWeekRange, getWeekdays, goToToday, nextDay, nextMonth, nextWeek, previousDay, previousMonth, previousWeek };

package/dist/index.d.ts

@@ -7,6 +7,8 @@ type CalendarAccessor<TItem> = {
     getEnd?: (item: TItem) => Temporal.ZonedDateTime;
 };
 type CalendarDay<TItem = unknown> = {
+    /** Unique identifier for this day within the view context. Use as React/Vue key. */
+    id: string;
     date: Temporal.PlainDate;
     isCurrentMonth: boolean;
     isToday: boolean;
@@ -18,6 +20,8 @@ type CalendarMonth<TItem = unknown> = {
     month: Temporal.PlainYearMonth;
 };
 type WeekDay<TItem = unknown> = {
+    /** Unique identifier for this day within the view context. Use as React/Vue key. */
+    id: string;
     date: Temporal.PlainDate;
     isToday: boolean;
     items: TItem[];
@@ -29,12 +33,16 @@ type CalendarWeekView<TItem = unknown> = {
     weekEnd: Temporal.PlainDate;
 };
 type TimeSlot<TItem = unknown> = {
+    /** Unique identifier for this time slot. Use as React/Vue key. */
+    id: string;
     hour: number;
     minute: number;
     time: Temporal.PlainTime;
     items: TItem[];
 };
 type CalendarDayView<TItem = unknown> = {
+    /** Unique identifier for this day view. Use as React/Vue key. */
+    id: string;
     date: Temporal.PlainDate;
     isToday: boolean;
     timeSlots: TimeSlot<TItem>[];
@@ -73,17 +81,16 @@ type CalendarViewOptions<TItem> = {
     day?: DayViewOptions<TItem>;
 };
 type CalendarOptions<TItem> = {
-    data: TItem[];
     views: CalendarViewOptions<TItem>;
     timeZone?: 'UTC' | string;
     state?: Partial<CalendarState>;
-    onStateChange?: (updater: Updater<CalendarState>) => void;
+    onStateChange?: (state: CalendarState) => void;
 };
 type HasView<Options, View extends 'month' | 'week' | 'day'> = Options extends {
     views: infer V;
 } ? V extends Record<View, unknown> ? V[View] extends undefined ? false : true : false : false;
 type MonthMethods<TItem, TOptions> = HasView<TOptions, 'month'> extends true ? {
-    getMonth(): CalendarMonth<TItem>;
+    getMonth(data?: TItem[]): CalendarMonth<TItem>;
     nextMonth(): void;
     previousMonth(): void;
     goToMonth(year: number, month: number): void;
@@ -94,7 +101,7 @@ type MonthMethods<TItem, TOptions> = HasView<TOptions, 'month'> extends true ? {
     goToMonth?: never;
 };
 type WeekMethods<TItem, TOptions> = HasView<TOptions, 'week'> extends true ? {
-    getWeek(): CalendarWeekView<TItem>;
+    getWeek(data?: TItem[]): CalendarWeekView<TItem>;
     nextWeek(): void;
     previousWeek(): void;
 } : {
@@ -103,7 +110,7 @@ type WeekMethods<TItem, TOptions> = HasView<TOptions, 'week'> extends true ? {
     previousWeek?: never;
 };
 type DayMethods<TItem, TOptions> = HasView<TOptions, 'day'> extends true ? {
-    getDay(): CalendarDayView<TItem>;
+    getDay(data?: TItem[]): CalendarDayView<TItem>;
     nextDay(): void;
     previousDay(): void;
 } : {
@@ -126,6 +133,7 @@ type BaseCalendarMethods<Options> = {
     currentView: ValidViews<Options>;
     setCurrentView(view: ValidViews<Options>): void;
     dateRange: DateRange;
+    getDateRange(view?: ValidViews<Options>): DateRange;
     options: Options;
     setOptions(updater: (old: Options) => Options): void;
     store: _tanstack_store.Store<CalendarState>;
@@ -133,71 +141,145 @@ type BaseCalendarMethods<Options> = {
     hasWeekView(): boolean;
     hasDayView(): boolean;
 };
-type ViewsToOptions<TItem, TViews extends CalendarViewOptions<TItem>> = {
-    data: TItem[];
-    views: TViews;
+/**
+ * Unified calendar type with conditional methods based on configured views.
+ *
+ * @example
+ * // Calendar with specific options - methods are conditional
+ * const calendar = createCalendar<Post, typeof options>(options);
+ * calendar.getMonth([]); // Only available if month view configured
+ *
+ * @example
+ * // Generic calendar type - all methods available
+ * type AnyPostCalendar = Calendar<Post>;
+ */
+type Calendar<TItem, TOptions extends CalendarOptions<TItem> = CalendarOptions<TItem>> = BaseCalendarMethods<TOptions> & MonthMethods<TItem, TOptions> & WeekMethods<TItem, TOptions> & DayMethods<TItem, TOptions>;
+/**
+ * Calendar instance with all view methods available and typed items.
+ * Use this for contexts where the specific view configuration is unknown at compile time,
+ * but you still want type-safe item data.
+ *
+ * @example
+ * // In React context - store with unknown, consume with specific type
+ * const context = createContext<CalendarInstance<unknown> | null>(null);
+ *
+ * // Consumer gets typed data
+ * function useCalendar<TItem>(): CalendarInstance<TItem> {
+ *   return useContext(context) as CalendarInstance<TItem>;
+ * }
+ */
+type CalendarInstance<TItem = unknown> = {
+    getMonth(data?: TItem[]): CalendarMonth<TItem>;
+    getWeek(data?: TItem[]): CalendarWeekView<TItem>;
+    getDay(data?: TItem[]): CalendarDayView<TItem>;
+    getTitle(view?: ViewType, locales?: Temporal.LocalesArgument, options?: globalThis.Intl.DateTimeFormatOptions): string;
+    getState(): CalendarState;
+    setState(updater: CalendarState | ((old: CalendarState) => Partial<CalendarState>)): void;
+    goToToday(): void;
+    goToDate(date: Temporal.PlainDate): void;
+    next(view?: ViewType): void;
+    previous(view?: ViewType): void;
+    views: ReadonlyArray<string>;
+    currentView: string;
+    setCurrentView(view: string): void;
+    dateRange: DateRange;
+    getDateRange(view?: ViewType): DateRange;
+    options: CalendarOptions<TItem>;
+    setOptions(updater: (old: CalendarOptions<TItem>) => CalendarOptions<TItem>): void;
+    store: _tanstack_store.Store<CalendarState>;
+    nextMonth(): void;
+    previousMonth(): void;
+    goToMonth(year: number, month: number): void;
+    nextWeek(): void;
+    previousWeek(): void;
+    nextDay(): void;
+    previousDay(): void;
+    hasMonthView(): boolean;
+    hasWeekView(): boolean;
+    hasDayView(): boolean;
 };
-type Calendar<TItem, TOptionsOrViews = CalendarOptions<TItem>> = TOptionsOrViews extends CalendarOptions<TItem> ? BaseCalendarMethods<TOptionsOrViews> & MonthMethods<TItem, TOptionsOrViews> & WeekMethods<TItem, TOptionsOrViews> & DayMethods<TItem, TOptionsOrViews> : TOptionsOrViews extends CalendarViewOptions<TItem> ? BaseCalendarMethods<ViewsToOptions<TItem, TOptionsOrViews>> & MonthMethods<TItem, ViewsToOptions<TItem, TOptionsOrViews>> & WeekMethods<TItem, ViewsToOptions<TItem, TOptionsOrViews>> & DayMethods<TItem, ViewsToOptions<TItem, TOptionsOrViews>> : BaseCalendarMethods<CalendarOptions<TItem>> & MonthMethods<TItem, CalendarOptions<TItem>> & WeekMethods<TItem, CalendarOptions<TItem>> & DayMethods<TItem, CalendarOptions<TItem>>;
-type InferViewNames<V extends CalendarViewOptions<unknown>> = keyof V & string;
-type InferViewConfig<V extends CalendarViewOptions<unknown>, Name extends keyof V> = V[Name] extends infer Config ? {
-    name: Name;
-    config: Config;
-} : never;
 /**
- * Extract the item type from a Calendar type
+ * Extract the item type from a Calendar's options
  * @example type Item = CalendarItemType<typeof calendar>; // Post
  */
-type CalendarItemType<C extends Calendar<any, any>> = C extends Calendar<infer TItem, any> ? TItem : never;
+type CalendarItemType<C extends CalendarInstance> = C['options'] extends CalendarOptions<infer TItem> ? TItem : never;
 /**
  * Extract the views configuration from a Calendar type
  * @example type Views = CalendarViewsConfig<typeof calendar>;
  */
-type CalendarViewsConfig<C extends Calendar<any, any>> = C extends Calendar<any, infer TOptions> ? TOptions extends {
+type CalendarViewsConfig<C extends CalendarInstance> = C['options'] extends {
     views: infer V;
-} ? V : TOptions extends CalendarViewOptions<any> ? TOptions : never : never;
+} ? V : never;
 /**
  * Check if a Calendar has a specific view configured
  * @example type HasMonth = HasViewType<typeof calendar, 'month'>; // true | false
  */
-type HasViewType<C extends Calendar<any, any>, V extends 'month' | 'week' | 'day'> = C extends Calendar<any, infer TOptions> ? HasView<TOptions, V> : false;
+type HasViewType<C extends CalendarInstance, V extends 'month' | 'week' | 'day'> = C['options'] extends CalendarOptions<infer TItem> ? HasView<C['options'], V> : false;
 /**
  * Extract valid view names as a union from a Calendar
  * @example type Views = ValidViewNames<typeof calendar>; // 'month' | 'week'
  */
-type ValidViewNames<C extends Calendar<any, any>> = C extends Calendar<any, infer TOptions> ? ValidViews<TOptions> : never;
-/**
- * Extract the item type from CalendarOptions before creating a calendar
- * @example type Item = ItemTypeFromOptions<typeof options>; // Post
- */
-type ItemTypeFromOptions<O extends CalendarOptions<any>> = O extends CalendarOptions<infer TItem> ? TItem : never;
+type ValidViewNames<C extends CalendarInstance> = C['options'] extends CalendarOptions<infer TItem> ? ValidViews<C['options']> : never;
 /**
  * Base props for components that receive a Calendar
  * @example
- * function MyComponent<C extends Calendar<any, any>>(
+ * function MyComponent<C extends CalendarInstance>(
  *   props: CalendarComponentProps<C>
  * ) { ... }
  */
-type CalendarComponentProps<C extends Calendar<any, any>> = {
+type CalendarComponentProps<C extends CalendarInstance> = {
     calendar: C;
 };
 /**
  * Require that a Calendar has month view configured
  * @example
- * function MonthView<C extends Calendar<any, any>>(
+ * function MonthView<C extends CalendarInstance>(
  *   props: { calendar: RequireMonthView<C> }
  * ) {
  *   // calendar.getMonth() is guaranteed to exist
  * }
  */
-type RequireMonthView<C extends Calendar<any, any>> = HasViewType<C, 'month'> extends true ? C : never;
+type RequireMonthView<C extends CalendarInstance> = HasViewType<C, 'month'> extends true ? C : never;
 /**
  * Require that a Calendar has week view configured
  */
-type RequireWeekView<C extends Calendar<any, any>> = HasViewType<C, 'week'> extends true ? C : never;
+type RequireWeekView<C extends CalendarInstance> = HasViewType<C, 'week'> extends true ? C : never;
 /**
  * Require that a Calendar has day view configured
  */
-type RequireDayView<C extends Calendar<any, any>> = HasViewType<C, 'day'> extends true ? C : never;
+type RequireDayView<C extends CalendarInstance> = HasViewType<C, 'day'> extends true ? C : never;
+/**
+ * Built-in view types
+ */
+type ViewType = 'month' | 'week' | 'day';
+/**
+ * Discriminated union of all view results
+ */
+type ViewResult<TItem> = {
+    type: 'month';
+    data: CalendarMonth<TItem>;
+} | {
+    type: 'week';
+    data: CalendarWeekView<TItem>;
+} | {
+    type: 'day';
+    data: CalendarDayView<TItem>;
+};
+/**
+ * Conditional type that narrows ViewResult based on view name
+ * - If V is a specific view type, returns that specific result
+ * - If V is undefined, returns the full discriminated union
+ */
+type ViewResultFor<TItem, V extends ViewType | undefined> = V extends 'month' ? {
+    type: 'month';
+    data: CalendarMonth<TItem>;
+} : V extends 'week' ? {
+    type: 'week';
+    data: CalendarWeekView<TItem>;
+} : V extends 'day' ? {
+    type: 'day';
+    data: CalendarDayView<TItem>;
+} : ViewResult<TItem>;
 
 declare function functionalUpdate<T>(updater: T | ((old: T) => T), input: T): T;
 declare function createCalendarAccessor<T, A extends CalendarAccessor<T> = CalendarAccessor<T>>(accessor: A): A;
@@ -211,7 +293,6 @@ declare function goToToday(): {
     year: number;
     month: number;
 };
-declare function getWeekdays(weekStartsOn?: 0 | 1 | 2 | 3 | 4 | 5 | 6, locale?: string | string[], format?: 'short' | 'long' | 'narrow'): string[];
 declare function getMonthName(month: Temporal.PlainYearMonth, locale?: string): string;
 declare function formatTime(time: Temporal.PlainTime, locale?: string): string;
 declare function getTimeSlotHeight(slotDuration: number, hourHeight: number): number;
@@ -292,6 +373,16 @@ declare function getWeekDateRange(date: Temporal.PlainDate, timeZone: string, op
  */
 declare function getDayDateRange(date: Temporal.PlainDate, timeZone: string): DateRange;
 
+/**
+ * Returns an array of weekday names starting from the specified day.
+ *
+ * @param weekStartsOn - Day the week starts on (0=Sunday, 1=Monday, ..., 6=Saturday). Defaults to 1 (Monday).
+ * @param locale - Locale for formatting weekday names. Defaults to 'en-US'.
+ * @param format - Format for weekday names: 'short' (Mon), 'long' (Monday), or 'narrow' (M). Defaults to 'short'.
+ * @returns Array of 7 weekday names starting from weekStartsOn.
+ */
+declare function getWeekdays(weekStartsOn?: 0 | 1 | 2 | 3 | 4 | 5 | 6, locale?: string | string[], format?: 'short' | 'long' | 'narrow'): string[];
+
 declare function createCalendar<TItem, TOptions extends CalendarOptions<TItem>>(options: TOptions): Calendar<TItem, TOptions>;
 
 declare function createCalendarViews<TItem>(): <const TViews extends {
@@ -300,4 +391,4 @@ declare function createCalendarViews<TItem>(): <const TViews extends {
     day?: DayViewOptions<TItem>;
 }>(views: TViews) => TViews;
 
-export { type Calendar, type CalendarAccessor, type CalendarComponentProps, type CalendarDay, type CalendarDayView, type CalendarItemType, type CalendarMonth, type CalendarOptions, type CalendarState, type CalendarViewOptions, type CalendarViewsConfig, type CalendarWeek, type CalendarWeekView, type DateRange, type DateRangeBounds, type DayViewOptions, type HasViewType, type InferViewConfig, type InferViewNames, type ItemTypeFromOptions, type MonthViewOptions, type RequireDayView, type RequireMonthView, type RequireWeekView, type TimeSlot, type Updater, type ValidViewNames, type WeekDay, type WeekViewOptions, buildDay, buildMonth, buildWeek, convertToTimezone, createCalendar, createCalendarAccessor, createCalendarViews, createZonedDateTime, formatTime, functionalUpdate, getCurrentTimeZone, getDayDateRange, getDayRange, getEventPosition, getMonthDateRange, getMonthName, getMonthRange, getTimeSlotHeight, getTimezoneOffset, getWeekDateRange, getWeekRange, getWeekdays, goToToday, nextDay, nextMonth, nextWeek, previousDay, previousMonth, previousWeek };
+export { type Calendar, type CalendarAccessor, type CalendarComponentProps, type CalendarDay, type CalendarDayView, type CalendarInstance, type CalendarItemType, type CalendarMonth, type CalendarOptions, type CalendarState, type CalendarViewOptions, type CalendarViewsConfig, type CalendarWeek, type CalendarWeekView, type DateRange, type DateRangeBounds, type DayViewOptions, type HasViewType, type MonthViewOptions, type RequireDayView, type RequireMonthView, type RequireWeekView, type TimeSlot, type Updater, type ValidViewNames, type ViewResult, type ViewResultFor, type ViewType, type WeekDay, type WeekViewOptions, buildDay, buildMonth, buildWeek, convertToTimezone, createCalendar, createCalendarAccessor, createCalendarViews, createZonedDateTime, formatTime, functionalUpdate, getCurrentTimeZone, getDayDateRange, getDayRange, getEventPosition, getMonthDateRange, getMonthName, getMonthRange, getTimeSlotHeight, getTimezoneOffset, getWeekDateRange, getWeekRange, getWeekdays, goToToday, nextDay, nextMonth, nextWeek, previousDay, previousMonth, previousWeek };

package/dist/index.js

@@ -28,16 +28,6 @@ function goToToday() {
   const today = Temporal.Now.plainDateISO();
   return { year: today.year, month: today.month };
 }
-function getWeekdays(weekStartsOn = 1, locale = "en-US", format = "short") {
-  const referenceDate = Temporal.PlainDate.from("2023-01-02");
-  const days = [];
-  for (let i = 0; i < 7; i++) {
-    const offset = (weekStartsOn - 1 + i + 7) % 7;
-    const date = referenceDate.add({ days: offset });
-    days.push(date.toLocaleString(locale, { weekday: format }));
-  }
-  return days;
-}
 function getMonthName(month, locale = "en-US") {
   return month.toPlainDate({ day: 1 }).toLocaleString(locale, { month: "long" });
 }
@@ -133,6 +123,7 @@ function buildMonth(year, month, options) {
     }
     const dateKey = currentDate.toString();
     weeks[weeks.length - 1].push({
+      id: `${yearMonth.toString()}-${dateKey}`,
       date: currentDate,
       isCurrentMonth: currentDate.month === month,
       isToday: Temporal2.PlainDate.compare(currentDate, today) === 0,
@@ -160,7 +151,7 @@ import { Temporal as Temporal3 } from "@js-temporal/polyfill";
 function buildDay(date, options) {
   const startHour = options?.startHour ?? 0;
   const endHour = options?.endHour ?? 24;
-  const slotDuration = options?.slotDuration ?? 30;
+  const slotDuration = options?.slotDuration ?? 60;
   const today = options?.today ?? Temporal3.Now.plainDateISO();
   const data = options?.data ?? [];
   const accessor = options?.accessor;
@@ -174,6 +165,7 @@ function buildDay(date, options) {
     }
   }
   const timeSlots = [];
+  const dateStr = date.toString();
   let currentHour = startHour;
   let currentMinute = 0;
   while (currentHour < endHour) {
@@ -200,6 +192,7 @@ function buildDay(date, options) {
       }
     }
     timeSlots.push({
+      id: `${dateStr}-${String(currentHour).padStart(2, "0")}:${String(currentMinute).padStart(2, "0")}`,
       hour: currentHour,
       minute: currentMinute,
       time: slotStart,
@@ -212,6 +205,7 @@ function buildDay(date, options) {
     }
   }
   return {
+    id: dateStr,
     date,
     isToday: Temporal3.PlainDate.compare(date, today) === 0,
     timeSlots,
@@ -258,6 +252,7 @@ function buildWeek(date, options) {
       timeSlots = dayView.timeSlots;
     }
     days.push({
+      id: `${weekStart.toString()}-${dateKey}`,
       date: currentDate,
       isToday: Temporal4.PlainDate.compare(currentDate, today) === 0,
       items: itemsByDate.get(dateKey) ?? [],
@@ -330,8 +325,20 @@ function getDayDateRange(date, timeZone) {
   return { start: startZoned, end: endZoned };
 }
 
-// src/core/calendar.ts
+// src/utils/getWeekdays.ts
 import { Temporal as Temporal6 } from "@js-temporal/polyfill";
+function getWeekdays(weekStartsOn = 1, locale = "en-US", format = "short") {
+  const sunday = Temporal6.PlainDate.from("2023-01-01");
+  const days = [];
+  for (let i = 0; i < 7; i++) {
+    const date = sunday.add({ days: (weekStartsOn + i) % 7 });
+    days.push(date.toLocaleString(locale, { weekday: format }));
+  }
+  return days;
+}
+
+// src/core/calendar.ts
+import { Temporal as Temporal7 } from "@js-temporal/polyfill";
 import { Store } from "@tanstack/store";
 function computeDateRange(view, referenceDate, timeZone, weekStartsOn = 1) {
   let start;
@@ -356,22 +363,22 @@ function computeDateRange(view, referenceDate, timeZone, weekStartsOn = 1) {
   }
   const startZoned = start.toZonedDateTime({
     timeZone,
-    plainTime: Temporal6.PlainTime.from("00:00:00")
+    plainTime: Temporal7.PlainTime.from("00:00:00")
   });
   const endZoned = end.toZonedDateTime({
     timeZone,
-    plainTime: Temporal6.PlainTime.from("23:59:59.999")
+    plainTime: Temporal7.PlainTime.from("23:59:59.999")
   });
   return { start: startZoned, end: endZoned };
 }
 function createCalendar(options) {
   const configuredViews = Object.keys(options.views);
   const defaultView = configuredViews[0];
-  const timeZone = options.timeZone || Temporal6.Now.timeZoneId();
+  const timeZone = options.timeZone || Temporal7.Now.timeZoneId();
   const monthView = options.views.month;
   const weekView = options.views.week;
   const weekStartsOn = monthView?.weekStartsOn ?? weekView?.weekStartsOn ?? 1;
-  const initialReferenceDate = options.state?.referenceDate || Temporal6.Now.plainDateISO();
+  const initialReferenceDate = options.state?.referenceDate || Temporal7.Now.plainDateISO();
   const initialView = options.state?.currentView || defaultView;
   const initialDateRange = computeDateRange(
     initialView,
@@ -396,18 +403,18 @@ function createCalendar(options) {
     dateRange: initialDateRange,
     ...resolvedOptions.state
   });
-  const getMonthImpl = () => {
+  const getMonthImpl = (data = []) => {
     const state = store.state;
     const { year, month } = state.referenceDate;
     const monthView2 = _options.views.month;
     if (!monthView2) throw new Error("Month view not configured");
     return buildMonth(year, month, {
       weekStartsOn: monthView2.weekStartsOn,
-      data: _options.data,
+      data,
       accessor: monthView2.accessor
     });
   };
-  const getWeekImpl = () => {
+  const getWeekImpl = (data = []) => {
     const state = store.state;
     const weekView2 = _options.views.week;
     if (!weekView2) throw new Error("Week view not configured");
@@ -416,11 +423,11 @@ function createCalendar(options) {
       startHour: weekView2.startHour,
       endHour: weekView2.endHour,
       slotDuration: weekView2.slotDuration,
-      data: _options.data,
+      data,
       accessor: weekView2.accessor
     });
   };
-  const getDayImpl = () => {
+  const getDayImpl = (data = []) => {
     const state = store.state;
     const dayView = _options.views.day;
     if (!dayView) throw new Error("Day view not configured");
@@ -428,7 +435,7 @@ function createCalendar(options) {
       startHour: dayView.startHour,
       endHour: dayView.endHour,
       slotDuration: dayView.slotDuration,
-      data: _options.data,
+      data,
       accessor: dayView.accessor
     });
   };
@@ -456,7 +463,7 @@ function createCalendar(options) {
   };
   const nextMonthImpl = () => {
     setStateImpl((old) => {
-      const current = Temporal6.PlainYearMonth.from({
+      const current = Temporal7.PlainYearMonth.from({
         year: old.referenceDate.year,
         month: old.referenceDate.month
       });
@@ -468,7 +475,7 @@ function createCalendar(options) {
   };
   const previousMonthImpl = () => {
     setStateImpl((old) => {
-      const current = Temporal6.PlainYearMonth.from({
+      const current = Temporal7.PlainYearMonth.from({
         year: old.referenceDate.year,
         month: old.referenceDate.month
       });
@@ -553,7 +560,7 @@ function createCalendar(options) {
     previousMonth: previousMonthImpl,
     goToMonth(year, month) {
       setStateImpl(() => ({
-        referenceDate: Temporal6.PlainDate.from({ year, month, day: 1 })
+        referenceDate: Temporal7.PlainDate.from({ year, month, day: 1 })
       }));
     },
     nextWeek: nextWeekImpl,
@@ -562,7 +569,7 @@ function createCalendar(options) {
     previousDay: previousDayImpl,
     goToToday() {
       setStateImpl(() => ({
-        referenceDate: Temporal6.Now.plainDateISO()
+        referenceDate: Temporal7.Now.plainDateISO()
       }));
     },
     goToDate(date) {
@@ -613,6 +620,15 @@ function createCalendar(options) {
     get dateRange() {
       return store.state.dateRange;
     },
+    getDateRange(view) {
+      const effectiveView = view ?? store.state.currentView ?? defaultView;
+      return computeDateRange(
+        effectiveView,
+        store.state.referenceDate,
+        timeZone,
+        weekStartsOn
+      );
+    },
     get options() {
       return _options;
     },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gobrand/calendar-core",
-  "version": "0.0.17",
+  "version": "0.0.19",
   "description": "Lightweight utility library for building calendars using the Temporal API",
   "private": false,
   "publishConfig": {