@gobrand/calendar-core 0.0.7 → 0.0.8

package/dist/index.cjs

@@ -661,6 +661,16 @@ function createCalendar(options) {
     setOptions(updater) {
       _options = functionalUpdate(updater, _options);
     },
+    // Type predicates for runtime view checking
+    hasMonthView() {
+      return "month" in _options.views && _options.views.month !== void 0;
+    },
+    hasWeekView() {
+      return "week" in _options.views && _options.views.week !== void 0;
+    },
+    hasDayView() {
+      return "day" in _options.views && _options.views.day !== void 0;
+    },
     store
   };
   return calendar;

package/dist/index.d.cts

@@ -1,44 +1,44 @@
 import * as _tanstack_store from '@tanstack/store';
 import { Temporal } from '@js-temporal/polyfill';
 
-type CalendarAccessor<T> = {
-    getDate: (item: T) => Temporal.PlainDate;
-    getStart?: (item: T) => Temporal.ZonedDateTime;
-    getEnd?: (item: T) => Temporal.ZonedDateTime;
+type CalendarAccessor<TItem> = {
+    getDate: (item: TItem) => Temporal.PlainDate;
+    getStart?: (item: TItem) => Temporal.ZonedDateTime;
+    getEnd?: (item: TItem) => Temporal.ZonedDateTime;
 };
-type CalendarDay<T = unknown> = {
+type CalendarDay<TItem = unknown> = {
     date: Temporal.PlainDate;
     isCurrentMonth: boolean;
     isToday: boolean;
-    items: T[];
+    items: TItem[];
 };
-type CalendarWeek<T = unknown> = CalendarDay<T>[];
-type CalendarMonth<T = unknown> = {
-    weeks: CalendarWeek<T>[];
+type CalendarWeek<TItem = unknown> = CalendarDay<TItem>[];
+type CalendarMonth<TItem = unknown> = {
+    weeks: CalendarWeek<TItem>[];
     month: Temporal.PlainYearMonth;
 };
-type WeekDay<T = unknown> = {
+type WeekDay<TItem = unknown> = {
     date: Temporal.PlainDate;
     isToday: boolean;
-    items: T[];
-    timeSlots?: TimeSlot<T>[];
+    items: TItem[];
+    timeSlots?: TimeSlot<TItem>[];
 };
-type CalendarWeekView<T = unknown> = {
-    days: WeekDay<T>[];
+type CalendarWeekView<TItem = unknown> = {
+    days: WeekDay<TItem>[];
     weekStart: Temporal.PlainDate;
     weekEnd: Temporal.PlainDate;
 };
-type TimeSlot<T = unknown> = {
+type TimeSlot<TItem = unknown> = {
     hour: number;
     minute: number;
     time: Temporal.PlainTime;
-    items: T[];
+    items: TItem[];
 };
-type CalendarDayView<T = unknown> = {
+type CalendarDayView<TItem = unknown> = {
     date: Temporal.PlainDate;
     isToday: boolean;
-    timeSlots: TimeSlot<T>[];
-    items: T[];
+    timeSlots: TimeSlot<TItem>[];
+    items: TItem[];
 };
 type DateRange = {
     start: Temporal.ZonedDateTime;
@@ -50,31 +50,31 @@ type CalendarState = {
     currentView?: string;
     dateRange: DateRange;
 };
-type MonthViewOptions<T> = {
-    accessor: CalendarAccessor<T>;
+type MonthViewOptions<TItem> = {
+    accessor: CalendarAccessor<TItem>;
     weekStartsOn?: 0 | 1 | 2 | 3 | 4 | 5 | 6;
 };
-type WeekViewOptions<T> = {
-    accessor: CalendarAccessor<T>;
+type WeekViewOptions<TItem> = {
+    accessor: CalendarAccessor<TItem>;
     weekStartsOn?: 0 | 1 | 2 | 3 | 4 | 5 | 6;
     startHour?: number;
     endHour?: number;
     slotDuration?: number;
 };
-type DayViewOptions<T> = {
-    accessor: CalendarAccessor<T>;
+type DayViewOptions<TItem> = {
+    accessor: CalendarAccessor<TItem>;
     startHour?: number;
     endHour?: number;
     slotDuration?: number;
 };
-type CalendarViewOptions<T> = {
-    month?: MonthViewOptions<T>;
-    week?: WeekViewOptions<T>;
-    day?: DayViewOptions<T>;
+type CalendarViewOptions<TItem> = {
+    month?: MonthViewOptions<TItem>;
+    week?: WeekViewOptions<TItem>;
+    day?: DayViewOptions<TItem>;
 };
-type CalendarOptions<T> = {
-    data: T[];
-    views: CalendarViewOptions<T>;
+type CalendarOptions<TItem> = {
+    data: TItem[];
+    views: CalendarViewOptions<TItem>;
     timeZone?: 'UTC' | string;
     state?: Partial<CalendarState>;
     onStateChange?: (updater: Updater<CalendarState>) => void;
@@ -82,8 +82,8 @@ type CalendarOptions<T> = {
 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<T, Options> = HasView<Options, 'month'> extends true ? {
-    getMonth(): CalendarMonth<T>;
+type MonthMethods<TItem, TOptions> = HasView<TOptions, 'month'> extends true ? {
+    getMonth(): CalendarMonth<TItem>;
     nextMonth(): void;
     previousMonth(): void;
     goToMonth(year: number, month: number): void;
@@ -93,8 +93,8 @@ type MonthMethods<T, Options> = HasView<Options, 'month'> extends true ? {
     previousMonth?: never;
     goToMonth?: never;
 };
-type WeekMethods<T, Options> = HasView<Options, 'week'> extends true ? {
-    getWeek(): CalendarWeekView<T>;
+type WeekMethods<TItem, TOptions> = HasView<TOptions, 'week'> extends true ? {
+    getWeek(): CalendarWeekView<TItem>;
     nextWeek(): void;
     previousWeek(): void;
 } : {
@@ -102,8 +102,8 @@ type WeekMethods<T, Options> = HasView<Options, 'week'> extends true ? {
     nextWeek?: never;
     previousWeek?: never;
 };
-type DayMethods<T, Options> = HasView<Options, 'day'> extends true ? {
-    getDay(): CalendarDayView<T>;
+type DayMethods<TItem, TOptions> = HasView<TOptions, 'day'> extends true ? {
+    getDay(): CalendarDayView<TItem>;
     nextDay(): void;
     previousDay(): void;
 } : {
@@ -129,17 +129,75 @@ type BaseCalendarMethods<Options> = {
     options: Options;
     setOptions(updater: (old: Options) => Options): void;
     store: _tanstack_store.Store<CalendarState>;
+    hasMonthView(): boolean;
+    hasWeekView(): boolean;
+    hasDayView(): boolean;
 };
-type ViewsToOptions<T, V extends CalendarViewOptions<T>> = {
-    data: T[];
-    views: V;
+type ViewsToOptions<TItem, TViews extends CalendarViewOptions<TItem>> = {
+    data: TItem[];
+    views: TViews;
 };
-type Calendar<T, OptionsOrViews = CalendarOptions<T>> = OptionsOrViews extends CalendarOptions<T> ? BaseCalendarMethods<OptionsOrViews> & MonthMethods<T, OptionsOrViews> & WeekMethods<T, OptionsOrViews> & DayMethods<T, OptionsOrViews> : OptionsOrViews extends CalendarViewOptions<T> ? BaseCalendarMethods<ViewsToOptions<T, OptionsOrViews>> & MonthMethods<T, ViewsToOptions<T, OptionsOrViews>> & WeekMethods<T, ViewsToOptions<T, OptionsOrViews>> & DayMethods<T, ViewsToOptions<T, OptionsOrViews>> : BaseCalendarMethods<CalendarOptions<T>> & MonthMethods<T, CalendarOptions<T>> & WeekMethods<T, CalendarOptions<T>> & DayMethods<T, CalendarOptions<T>>;
+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
+ * @example type Item = CalendarItemType<typeof calendar>; // Post
+ */
+type CalendarItemType<C extends Calendar<any, any>> = C extends Calendar<infer TItem, any> ? 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 {
+    views: infer V;
+} ? V : TOptions extends CalendarViewOptions<any> ? TOptions : never : 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;
+/**
+ * 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;
+/**
+ * Base props for components that receive a Calendar
+ * @example
+ * function MyComponent<C extends Calendar<any, any>>(
+ *   props: CalendarComponentProps<C>
+ * ) { ... }
+ */
+type CalendarComponentProps<C extends Calendar<any, any>> = {
+    calendar: C;
+};
+/**
+ * Require that a Calendar has month view configured
+ * @example
+ * function MonthView<C extends Calendar<any, any>>(
+ *   props: { calendar: RequireMonthView<C> }
+ * ) {
+ *   // calendar.getMonth() is guaranteed to exist
+ * }
+ */
+type RequireMonthView<C extends Calendar<any, any>> = 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;
+/**
+ * Require that a Calendar has day view configured
+ */
+type RequireDayView<C extends Calendar<any, any>> = HasViewType<C, 'day'> extends true ? C : never;
 
 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;
@@ -234,12 +292,12 @@ declare function getWeekDateRange(date: Temporal.PlainDate, timeZone: string, op
  */
 declare function getDayDateRange(date: Temporal.PlainDate, timeZone: string): DateRange;
 
-declare function createCalendar<T, Options extends CalendarOptions<T>>(options: Options): Calendar<T, Options>;
+declare function createCalendar<TItem, TOptions extends CalendarOptions<TItem>>(options: TOptions): Calendar<TItem, TOptions>;
 
-declare function createCalendarViews<T>(): <const V extends {
-    month?: MonthViewOptions<T>;
-    week?: WeekViewOptions<T>;
-    day?: DayViewOptions<T>;
-}>(views: V) => V;
+declare function createCalendarViews<TItem>(): <const TViews extends {
+    month?: MonthViewOptions<TItem>;
+    week?: WeekViewOptions<TItem>;
+    day?: DayViewOptions<TItem>;
+}>(views: TViews) => TViews;
 
-export { type Calendar, type CalendarAccessor, type CalendarDay, type CalendarDayView, type CalendarMonth, type CalendarOptions, type CalendarState, type CalendarViewOptions, type CalendarWeek, type CalendarWeekView, type DateRange, type DateRangeBounds, type DayViewOptions, type InferViewConfig, type InferViewNames, type MonthViewOptions, type TimeSlot, type Updater, 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 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 };

package/dist/index.d.ts

@@ -1,44 +1,44 @@
 import * as _tanstack_store from '@tanstack/store';
 import { Temporal } from '@js-temporal/polyfill';
 
-type CalendarAccessor<T> = {
-    getDate: (item: T) => Temporal.PlainDate;
-    getStart?: (item: T) => Temporal.ZonedDateTime;
-    getEnd?: (item: T) => Temporal.ZonedDateTime;
+type CalendarAccessor<TItem> = {
+    getDate: (item: TItem) => Temporal.PlainDate;
+    getStart?: (item: TItem) => Temporal.ZonedDateTime;
+    getEnd?: (item: TItem) => Temporal.ZonedDateTime;
 };
-type CalendarDay<T = unknown> = {
+type CalendarDay<TItem = unknown> = {
     date: Temporal.PlainDate;
     isCurrentMonth: boolean;
     isToday: boolean;
-    items: T[];
+    items: TItem[];
 };
-type CalendarWeek<T = unknown> = CalendarDay<T>[];
-type CalendarMonth<T = unknown> = {
-    weeks: CalendarWeek<T>[];
+type CalendarWeek<TItem = unknown> = CalendarDay<TItem>[];
+type CalendarMonth<TItem = unknown> = {
+    weeks: CalendarWeek<TItem>[];
     month: Temporal.PlainYearMonth;
 };
-type WeekDay<T = unknown> = {
+type WeekDay<TItem = unknown> = {
     date: Temporal.PlainDate;
     isToday: boolean;
-    items: T[];
-    timeSlots?: TimeSlot<T>[];
+    items: TItem[];
+    timeSlots?: TimeSlot<TItem>[];
 };
-type CalendarWeekView<T = unknown> = {
-    days: WeekDay<T>[];
+type CalendarWeekView<TItem = unknown> = {
+    days: WeekDay<TItem>[];
     weekStart: Temporal.PlainDate;
     weekEnd: Temporal.PlainDate;
 };
-type TimeSlot<T = unknown> = {
+type TimeSlot<TItem = unknown> = {
     hour: number;
     minute: number;
     time: Temporal.PlainTime;
-    items: T[];
+    items: TItem[];
 };
-type CalendarDayView<T = unknown> = {
+type CalendarDayView<TItem = unknown> = {
     date: Temporal.PlainDate;
     isToday: boolean;
-    timeSlots: TimeSlot<T>[];
-    items: T[];
+    timeSlots: TimeSlot<TItem>[];
+    items: TItem[];
 };
 type DateRange = {
     start: Temporal.ZonedDateTime;
@@ -50,31 +50,31 @@ type CalendarState = {
     currentView?: string;
     dateRange: DateRange;
 };
-type MonthViewOptions<T> = {
-    accessor: CalendarAccessor<T>;
+type MonthViewOptions<TItem> = {
+    accessor: CalendarAccessor<TItem>;
     weekStartsOn?: 0 | 1 | 2 | 3 | 4 | 5 | 6;
 };
-type WeekViewOptions<T> = {
-    accessor: CalendarAccessor<T>;
+type WeekViewOptions<TItem> = {
+    accessor: CalendarAccessor<TItem>;
     weekStartsOn?: 0 | 1 | 2 | 3 | 4 | 5 | 6;
     startHour?: number;
     endHour?: number;
     slotDuration?: number;
 };
-type DayViewOptions<T> = {
-    accessor: CalendarAccessor<T>;
+type DayViewOptions<TItem> = {
+    accessor: CalendarAccessor<TItem>;
     startHour?: number;
     endHour?: number;
     slotDuration?: number;
 };
-type CalendarViewOptions<T> = {
-    month?: MonthViewOptions<T>;
-    week?: WeekViewOptions<T>;
-    day?: DayViewOptions<T>;
+type CalendarViewOptions<TItem> = {
+    month?: MonthViewOptions<TItem>;
+    week?: WeekViewOptions<TItem>;
+    day?: DayViewOptions<TItem>;
 };
-type CalendarOptions<T> = {
-    data: T[];
-    views: CalendarViewOptions<T>;
+type CalendarOptions<TItem> = {
+    data: TItem[];
+    views: CalendarViewOptions<TItem>;
     timeZone?: 'UTC' | string;
     state?: Partial<CalendarState>;
     onStateChange?: (updater: Updater<CalendarState>) => void;
@@ -82,8 +82,8 @@ type CalendarOptions<T> = {
 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<T, Options> = HasView<Options, 'month'> extends true ? {
-    getMonth(): CalendarMonth<T>;
+type MonthMethods<TItem, TOptions> = HasView<TOptions, 'month'> extends true ? {
+    getMonth(): CalendarMonth<TItem>;
     nextMonth(): void;
     previousMonth(): void;
     goToMonth(year: number, month: number): void;
@@ -93,8 +93,8 @@ type MonthMethods<T, Options> = HasView<Options, 'month'> extends true ? {
     previousMonth?: never;
     goToMonth?: never;
 };
-type WeekMethods<T, Options> = HasView<Options, 'week'> extends true ? {
-    getWeek(): CalendarWeekView<T>;
+type WeekMethods<TItem, TOptions> = HasView<TOptions, 'week'> extends true ? {
+    getWeek(): CalendarWeekView<TItem>;
     nextWeek(): void;
     previousWeek(): void;
 } : {
@@ -102,8 +102,8 @@ type WeekMethods<T, Options> = HasView<Options, 'week'> extends true ? {
     nextWeek?: never;
     previousWeek?: never;
 };
-type DayMethods<T, Options> = HasView<Options, 'day'> extends true ? {
-    getDay(): CalendarDayView<T>;
+type DayMethods<TItem, TOptions> = HasView<TOptions, 'day'> extends true ? {
+    getDay(): CalendarDayView<TItem>;
     nextDay(): void;
     previousDay(): void;
 } : {
@@ -129,17 +129,75 @@ type BaseCalendarMethods<Options> = {
     options: Options;
     setOptions(updater: (old: Options) => Options): void;
     store: _tanstack_store.Store<CalendarState>;
+    hasMonthView(): boolean;
+    hasWeekView(): boolean;
+    hasDayView(): boolean;
 };
-type ViewsToOptions<T, V extends CalendarViewOptions<T>> = {
-    data: T[];
-    views: V;
+type ViewsToOptions<TItem, TViews extends CalendarViewOptions<TItem>> = {
+    data: TItem[];
+    views: TViews;
 };
-type Calendar<T, OptionsOrViews = CalendarOptions<T>> = OptionsOrViews extends CalendarOptions<T> ? BaseCalendarMethods<OptionsOrViews> & MonthMethods<T, OptionsOrViews> & WeekMethods<T, OptionsOrViews> & DayMethods<T, OptionsOrViews> : OptionsOrViews extends CalendarViewOptions<T> ? BaseCalendarMethods<ViewsToOptions<T, OptionsOrViews>> & MonthMethods<T, ViewsToOptions<T, OptionsOrViews>> & WeekMethods<T, ViewsToOptions<T, OptionsOrViews>> & DayMethods<T, ViewsToOptions<T, OptionsOrViews>> : BaseCalendarMethods<CalendarOptions<T>> & MonthMethods<T, CalendarOptions<T>> & WeekMethods<T, CalendarOptions<T>> & DayMethods<T, CalendarOptions<T>>;
+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
+ * @example type Item = CalendarItemType<typeof calendar>; // Post
+ */
+type CalendarItemType<C extends Calendar<any, any>> = C extends Calendar<infer TItem, any> ? 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 {
+    views: infer V;
+} ? V : TOptions extends CalendarViewOptions<any> ? TOptions : never : 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;
+/**
+ * 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;
+/**
+ * Base props for components that receive a Calendar
+ * @example
+ * function MyComponent<C extends Calendar<any, any>>(
+ *   props: CalendarComponentProps<C>
+ * ) { ... }
+ */
+type CalendarComponentProps<C extends Calendar<any, any>> = {
+    calendar: C;
+};
+/**
+ * Require that a Calendar has month view configured
+ * @example
+ * function MonthView<C extends Calendar<any, any>>(
+ *   props: { calendar: RequireMonthView<C> }
+ * ) {
+ *   // calendar.getMonth() is guaranteed to exist
+ * }
+ */
+type RequireMonthView<C extends Calendar<any, any>> = 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;
+/**
+ * Require that a Calendar has day view configured
+ */
+type RequireDayView<C extends Calendar<any, any>> = HasViewType<C, 'day'> extends true ? C : never;
 
 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;
@@ -234,12 +292,12 @@ declare function getWeekDateRange(date: Temporal.PlainDate, timeZone: string, op
  */
 declare function getDayDateRange(date: Temporal.PlainDate, timeZone: string): DateRange;
 
-declare function createCalendar<T, Options extends CalendarOptions<T>>(options: Options): Calendar<T, Options>;
+declare function createCalendar<TItem, TOptions extends CalendarOptions<TItem>>(options: TOptions): Calendar<TItem, TOptions>;
 
-declare function createCalendarViews<T>(): <const V extends {
-    month?: MonthViewOptions<T>;
-    week?: WeekViewOptions<T>;
-    day?: DayViewOptions<T>;
-}>(views: V) => V;
+declare function createCalendarViews<TItem>(): <const TViews extends {
+    month?: MonthViewOptions<TItem>;
+    week?: WeekViewOptions<TItem>;
+    day?: DayViewOptions<TItem>;
+}>(views: TViews) => TViews;
 
-export { type Calendar, type CalendarAccessor, type CalendarDay, type CalendarDayView, type CalendarMonth, type CalendarOptions, type CalendarState, type CalendarViewOptions, type CalendarWeek, type CalendarWeekView, type DateRange, type DateRangeBounds, type DayViewOptions, type InferViewConfig, type InferViewNames, type MonthViewOptions, type TimeSlot, type Updater, 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 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 };

package/dist/index.js

@@ -607,6 +607,16 @@ function createCalendar(options) {
     setOptions(updater) {
       _options = functionalUpdate(updater, _options);
     },
+    // Type predicates for runtime view checking
+    hasMonthView() {
+      return "month" in _options.views && _options.views.month !== void 0;
+    },
+    hasWeekView() {
+      return "week" in _options.views && _options.views.week !== void 0;
+    },
+    hasDayView() {
+      return "day" in _options.views && _options.views.day !== void 0;
+    },
     store
   };
   return calendar;

package/package.json

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