calendar-simple 1.2.0 → 2.0.0-beta.1

package/dist/src/Calendar.d.ts

@@ -0,0 +1,19 @@
+import { default as React } from 'react';
+import { CalendarProps } from './types';
+import { default as Header } from './components/layout/Header';
+import { default as DayView } from './components/views/day_view/DayView';
+import { default as WeekView } from './components/views/week_view/WeekView';
+import { default as MonthView } from './components/views/month_view/MonthView';
+import { default as ScheduleView } from './components/views/schedule_view/ScheduleView';
+import { default as CustomDaysView } from './components/views/custom_days_view/CustomDaysView';
+import { default as View } from './components/views/View';
+declare const MemoizedCalendar: React.NamedExoticComponent<CalendarProps> & {
+    Header: typeof Header;
+    View: typeof View;
+    DayView: typeof DayView;
+    WeekView: typeof WeekView;
+    MonthView: typeof MonthView;
+    ScheduleView: typeof ScheduleView;
+    CustomDaysView: typeof CustomDaysView;
+};
+export default MemoizedCalendar;

package/dist/src/Calendar.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/assets/LeftArrow.d.ts

@@ -0,0 +1,3 @@
+import { default as React } from 'react';
+declare function LeftArrow(): React.JSX.Element;
+export default LeftArrow;

package/dist/src/assets/RightArrow.d.ts

@@ -0,0 +1,3 @@
+import { default as React } from 'react';
+declare function RightArrow(): React.JSX.Element;
+export default RightArrow;

package/dist/src/components/core/all_day_banner/AllDayBanner.d.ts

@@ -0,0 +1,9 @@
+import { default as React } from 'react';
+import { DateType } from '../../../utils';
+import { CalendarEvent, CalendarContentProps } from '../../../types';
+interface AllDayBannerProps extends Pick<CalendarContentProps, "maxEvents" | "onEventClick" | "classNames" | "is12Hour" | "renderEvent" | "locale"> {
+    days: DateType[];
+    events: CalendarEvent[];
+}
+export default function AllDayBanner({ days, events, maxEvents, onEventClick, classNames, is12Hour, renderEvent, locale, }: AllDayBannerProps): React.JSX.Element;
+export {};

package/dist/src/components/core/all_day_banner/AllDayBanner.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/components/core/current_time_line/CurrentTimeLine.d.ts

@@ -0,0 +1,7 @@
+import { default as React } from 'react';
+import { CalendarContentProps } from '../../../types';
+interface CurrentTimeLineProps extends Pick<CalendarContentProps, "minHour" | "maxHour"> {
+    className?: string;
+}
+declare const CurrentTimeLine: ({ className, minHour, maxHour, }: CurrentTimeLineProps) => React.JSX.Element | null;
+export default CurrentTimeLine;

package/dist/src/components/core/current_time_line/CurrentTimeLine.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/components/core/day_column/DayColumn.d.ts

@@ -0,0 +1,11 @@
+import { default as React } from 'react';
+import { DateTime } from 'luxon';
+import { CalendarContentProps } from '../../../types';
+import { DayEventLayout } from '../../../hooks/useDayEventLayout';
+interface DayColumnProps extends Pick<CalendarContentProps, "onEventClick" | "is12Hour" | "classNames" | "showCurrentTime" | "minHour" | "maxHour" | "renderEvent" | "renderHourCell" | "creatable" | "onSlotClick"> {
+    dayEvents: DayEventLayout[];
+    date: DateTime;
+    isToday?: boolean;
+}
+declare function DayColumn({ dayEvents, date, onEventClick, is12Hour, classNames, isToday, showCurrentTime, minHour, maxHour, renderEvent, renderHourCell, creatable, onSlotClick, }: DayColumnProps): React.JSX.Element;
+export default DayColumn;

package/dist/src/components/core/day_column/DayColumn.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/components/core/day_event_item/DayWeekEventItem.d.ts

@@ -0,0 +1,8 @@
+import { default as React } from 'react';
+import { CalendarContentProps } from '../../../types';
+import { DayEventLayout } from '../../../hooks/useDayEventLayout';
+interface DayWeekEventItemProps extends Pick<CalendarContentProps, "onEventClick" | "is12Hour" | "classNames" | "renderEvent"> {
+    item: DayEventLayout;
+}
+export declare function DayWeekEventItem({ item, onEventClick, is12Hour, classNames, renderEvent, }: DayWeekEventItemProps): React.JSX.Element;
+export {};

package/dist/src/components/core/day_event_item/DayWeekEventItem.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/components/core/month_event_item/MonthEventItem.d.ts

@@ -0,0 +1,21 @@
+import { default as React } from 'react';
+import { CalendarContentProps, EventListType } from '../../../types';
+import { DateType } from '../../../utils';
+interface MonthEventItemProps extends Pick<CalendarContentProps, "onEventClick" | "theme" | "maxEvents" | "is12Hour" | "showAdjacentMonths" | "classNames" | "renderEvent" | "renderDateCell"> {
+    dataClassName?: string;
+    selectedClassName?: string;
+    todayClassName?: string;
+    date: number;
+    dateObj: DateType;
+    data: (EventListType | null)[];
+    cellWidth: number;
+    className?: string;
+    isSelected: boolean;
+    isToday: boolean;
+    isCurrentMonth: boolean;
+    onClick?: (date: DateType) => void;
+    onMoreClick?: (date: DateType, hiddenEvents: EventListType[]) => void;
+    totalEvents?: number;
+}
+declare function MonthEventItem({ date, dateObj, data, cellWidth, className, dataClassName, isSelected, isToday, onClick, selectedClassName, todayClassName, isCurrentMonth, theme, maxEvents, onMoreClick, onEventClick, totalEvents, is12Hour, showAdjacentMonths, classNames, renderEvent, renderDateCell, }: MonthEventItemProps): React.JSX.Element;
+export default MonthEventItem;

package/dist/src/components/core/month_event_item/MonthEventItem.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/components/core/time_column/TimeColumn.d.ts

@@ -0,0 +1,6 @@
+import { default as React } from 'react';
+import { CalendarContentProps } from '../../../types';
+interface TimeColumnProps extends Pick<CalendarContentProps, "is12Hour" | "classNames" | "minHour" | "maxHour" | "locale"> {
+}
+declare function TimeColumn({ is12Hour, classNames, minHour, maxHour, locale, }: TimeColumnProps): React.JSX.Element;
+export default TimeColumn;

package/dist/src/components/core/time_column/TimeColumn.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/components/layout/Header.d.ts

@@ -0,0 +1,7 @@
+import { default as React } from 'react';
+import { CalendarContentProps } from '../../types';
+export type HeaderProps = Partial<Pick<CalendarContentProps, "pastYearLength" | "futureYearLength" | "onNavigate" | "onViewChange" | "customDays" | "resetDateOnViewChange" | "localeMessages" | "showWeekNumbers">> & {
+    headerClassName?: string;
+};
+declare function Header(props: HeaderProps): React.JSX.Element;
+export default Header;

package/dist/src/components/layout/Header.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/components/ui/CalendarErrorBoundary.d.ts

@@ -0,0 +1,14 @@
+import { default as React, Component, ReactNode, ErrorInfo } from 'react';
+interface Props {
+    children: ReactNode;
+}
+interface State {
+    hasError: boolean;
+}
+export default class CalendarErrorBoundary extends Component<Props, State> {
+    state: State;
+    static getDerivedStateFromError(): State;
+    componentDidCatch(_error: Error, _info: ErrorInfo): void;
+    render(): string | number | bigint | boolean | Iterable<React.ReactNode> | Promise<string | number | bigint | boolean | React.ReactPortal | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | null | undefined> | React.JSX.Element | null | undefined;
+}
+export {};

package/dist/src/components/ui/popover/Popover.d.ts

@@ -0,0 +1,11 @@
+import { default as React } from 'react';
+import { DateType } from '../../../utils';
+import { CalendarContentProps, EventListType } from '../../../types';
+interface PopoverProps extends Pick<CalendarContentProps, "onEventClick" | "is12Hour" | "renderEvent"> {
+    dateObj: DateType;
+    events: EventListType[];
+    onClose: () => void;
+    anchorEl: HTMLElement | null;
+}
+declare function Popover({ dateObj, events, onEventClick, onClose, anchorEl, is12Hour, renderEvent, }: PopoverProps): React.ReactPortal;
+export default Popover;

package/dist/src/components/ui/popover/Popover.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/components/ui/skeleton/MonthSkeleton.d.ts

@@ -0,0 +1,2 @@
+import { default as React } from 'react';
+export default function MonthSkeleton(): React.JSX.Element;

package/dist/src/components/ui/skeleton/MonthSkeleton.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/components/ui/skeleton/ScheduleSkeleton.d.ts

@@ -0,0 +1,2 @@
+import { default as React } from 'react';
+export default function ScheduleSkeleton(): React.JSX.Element;

package/dist/src/components/ui/skeleton/ScheduleSkeleton.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/components/ui/skeleton/TimeGridSkeleton.d.ts

@@ -0,0 +1,2 @@
+import { default as React } from 'react';
+export default function TimeGridSkeleton(): React.JSX.Element;

package/dist/src/components/ui/skeleton/TimeGridSkeleton.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/components/views/View.d.ts

@@ -0,0 +1,4 @@
+import { default as React } from 'react';
+import { CalendarContentProps } from '../../types';
+export type ViewProps = Partial<Omit<CalendarContentProps, "events" | "locale" | "pastYearLength" | "futureYearLength" | "onNavigate" | "onViewChange" | "resetDateOnViewChange" | "localeMessages">>;
+export default function View(props: ViewProps): React.JSX.Element | null;

package/dist/src/components/views/View.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/components/views/custom_days_view/CustomDaysView.d.ts

@@ -0,0 +1,5 @@
+import { default as React } from 'react';
+import { CalendarContentProps } from '../../../types';
+export type CustomViewProps = Partial<Pick<CalendarContentProps, "is12Hour" | "dayType" | "onEventClick" | "theme" | "classNames" | "showCurrentTime" | "maxEvents" | "autoScrollToCurrentTime" | "minHour" | "maxHour" | "customDays" | "renderEvent" | "renderHourCell" | "renderDateCell" | "showAllDayRow" | "eventOverlapOffset" | "enableEnrichedEvents" | "enrichedEventsByDate" | "eventsAreSorted" | "isEventOrderingEnabled" | "creatable" | "onSlotClick">>;
+declare function CustomView(props: CustomViewProps): React.JSX.Element;
+export default CustomView;

package/dist/src/components/views/custom_days_view/CustomDaysView.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/components/views/day_view/DayView.d.ts

@@ -0,0 +1,5 @@
+import { default as React } from 'react';
+import { CalendarContentProps } from '../../../types';
+export type DayViewProps = Partial<Pick<CalendarContentProps, "is12Hour" | "dayType" | "onEventClick" | "theme" | "classNames" | "showCurrentTime" | "maxEvents" | "autoScrollToCurrentTime" | "minHour" | "maxHour" | "renderEvent" | "renderHourCell" | "renderDateCell" | "showAllDayRow" | "eventOverlapOffset" | "enableEnrichedEvents" | "enrichedEventsByDate" | "eventsAreSorted" | "isEventOrderingEnabled" | "creatable" | "onSlotClick">>;
+declare function DayView(props: DayViewProps): React.JSX.Element;
+export default DayView;

package/dist/src/components/views/day_view/DayView.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/components/views/month_view/MonthView.d.ts

@@ -0,0 +1,5 @@
+import { default as React } from 'react';
+import { CalendarContentProps } from '../../../types';
+export type MonthViewProps = Partial<Pick<CalendarContentProps, "is12Hour" | "selectable" | "maxEvents" | "dayType" | "onDateClick" | "onEventClick" | "onMoreClick" | "theme" | "classNames" | "weekStartsOn" | "weekEndsOn" | "showAdjacentMonths" | "renderEvent" | "renderDateCell" | "enableEnrichedEvents" | "enrichedEventsByDate" | "eventsAreSorted" | "isEventOrderingEnabled" | "sortedMonthView" | "showWeekNumbers" | "creatable" | "onSlotClick">>;
+declare function MonthView(props: MonthViewProps): React.JSX.Element;
+export default MonthView;

package/dist/src/components/views/month_view/MonthView.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/components/views/schedule_view/ScheduleView.d.ts

@@ -0,0 +1,4 @@
+import { default as React } from 'react';
+import { CalendarContentProps } from '../../../types';
+export type ScheduleViewProps = Partial<Pick<CalendarContentProps, "is12Hour" | "dayType" | "onEventClick" | "theme" | "classNames" | "autoScrollToCurrentTime" | "renderEvent" | "renderScheduleSeparator">>;
+export default function ScheduleView(props: ScheduleViewProps): React.JSX.Element;

package/dist/src/components/views/schedule_view/ScheduleView.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/components/views/week_view/WeekView.d.ts

@@ -0,0 +1,5 @@
+import { default as React } from 'react';
+import { CalendarContentProps } from '../../../types';
+export type WeekViewProps = Partial<Pick<CalendarContentProps, "is12Hour" | "dayType" | "onEventClick" | "theme" | "classNames" | "showCurrentTime" | "maxEvents" | "autoScrollToCurrentTime" | "weekStartsOn" | "weekEndsOn" | "minHour" | "maxHour" | "renderEvent" | "renderHourCell" | "renderDateCell" | "showAllDayRow" | "eventOverlapOffset" | "enableEnrichedEvents" | "enrichedEventsByDate" | "eventsAreSorted" | "isEventOrderingEnabled" | "creatable" | "onSlotClick">>;
+declare function WeekView(props: WeekViewProps): React.JSX.Element;
+export default WeekView;

package/dist/src/components/views/week_view/WeekView.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/constants/calendar.d.ts

@@ -0,0 +1,96 @@
+/** Test ID strings used to locate header dropdown elements in tests and automation. */
+export declare const CALENDAR_STRINGS: {
+    MONTH: string;
+    YEAR: string;
+};
+/** View options shown in the header view switcher dropdown (excludes CustomDays, which is dynamic). */
+export declare const VIEW_OPTIONS: ({
+    label: string;
+    value: "day";
+} | {
+    label: string;
+    value: "week";
+} | {
+    label: string;
+    value: "month";
+} | {
+    label: string;
+    value: "schedule";
+})[];
+/** Default values merged into `CalendarProps` by `useCalendarProps` when the consumer omits a prop. */
+export declare const defaultCalendarProps: {
+    events: never[];
+    view: "month";
+    locale: string;
+    localeMessages: {
+        today: string;
+        day: string;
+        week: string;
+        month: string;
+        schedule: string;
+        days: string;
+    };
+    is12Hour: boolean;
+    selectable: boolean;
+    creatable: boolean;
+    dayType: "half";
+    pastYearLength: number;
+    futureYearLength: number;
+    showCurrentTime: boolean;
+    autoScrollToCurrentTime: boolean;
+    minHour: number;
+    maxHour: number;
+    weekStartsOn: number;
+    weekEndsOn: number;
+    theme: {};
+    classNames: {};
+    showAdjacentMonths: boolean;
+    showWeekNumbers: boolean;
+    resetDateOnViewChange: boolean;
+    showAllDayRow: boolean;
+    eventOverlapOffset: number;
+    enableEnrichedEvents: boolean;
+    eventsAreSorted: boolean;
+    isEventOrderingEnabled: boolean;
+    sortedMonthView: boolean;
+    testId: string;
+    isLoading: boolean;
+};
+/**
+ * Locale primary subtags that default to RTL layout when no explicit `direction` prop is given.
+ * Match is case-insensitive and handles BCP-47 region/script tags (e.g. ar-SA → ar).
+ */
+export declare const RTL_LOCALES: readonly ["ar", "he", "fa", "ur", "ps", "sd", "ckb", "yi"];
+/** Action type strings dispatched to the calendar reducer. */
+export declare const CALENDAR_ACTIONS: {
+    readonly SET_DATE: "SET_DATE";
+    readonly SET_VIEW: "SET_VIEW";
+    readonly SET_CUSTOM_DAYS: "SET_CUSTOM_DAYS";
+    readonly NEXT: "NEXT";
+    readonly PREV: "PREV";
+    readonly TODAY: "TODAY";
+};
+/** Common time unit values used in duration and overlap calculations. */
+export declare const TIME_CONSTANTS: {
+    readonly MINUTES_IN_HOUR: 60;
+    readonly HOURS_IN_DAY: 24;
+    readonly DAYS_IN_WEEK: 7;
+    readonly MS_PER_MINUTE: 60000;
+    readonly MS_PER_HOUR: 3600000;
+};
+/** Luxon format strings used throughout the calendar for date and time display. */
+export declare const DATE_FORMATS: {
+    readonly DATE: "yyyy-MM-dd";
+    readonly TIME: "HH:mm";
+    readonly TIME_12H: "hh:mm a";
+    readonly HOUR_12H: "hh a";
+    readonly MONTH_YEAR: "MMMM yyyy";
+    readonly DAY_INDEX: "c";
+    readonly DAY_NUMBER: "d";
+    readonly FULL_DATE: "EEEE, MMMM d, yyyy";
+    readonly MONTH_DAY_YEAR: "MMMM d, yyyy";
+    readonly SHORT_MONTH_YEAR: "MMM yyyy";
+    readonly SHORT_MONTH: "MMM";
+    readonly SHORT_DAY: "EEE";
+    readonly DAY_DATE_SHORT_MONTH: "EEE, d MMM";
+};

package/dist/src/constants/index.d.ts

@@ -0,0 +1,2 @@
+export * from './theme';
+export * from './calendar';

package/dist/src/constants/theme.d.ts

@@ -0,0 +1,38 @@
+/**
+ * @file Default theme values and layout/keyboard constants.
+ */
+/** Fallback color theme applied when no `theme` prop is provided. */
+export declare const defaultTheme: {
+    default: {
+        color: string;
+        bgColor: string;
+    };
+    selected: {
+        color: string;
+        bgColor: string;
+    };
+    today: {
+        color: string;
+        bgColor: string;
+    };
+};
+/** Pixel dimensions used by layout algorithms to calculate cell sizes and event positioning. */
+export declare const LAYOUT_CONSTANTS: {
+    readonly HEADER_HEIGHT: 122;
+    readonly DATE_LABEL_HEIGHT: 28;
+    readonly CELL_PADDING: 8;
+    readonly EVENT_HEIGHT: 26;
+    readonly DEFAULT_ROWS: 6;
+    readonly MIN_ROWS: 4;
+    readonly ALL_DAY_ROW_HEIGHT: 24;
+    readonly EVENT_ITEM_PADDING: 16;
+    readonly SMALL_EVENT_HEIGHT: 40;
+    readonly TINY_EVENT_HEIGHT: 20;
+    readonly DEFAULT_EVENT_COLOR: "#3b82f6";
+};
+/** Keyboard key values that trigger interactive calendar actions. */
+export declare const KEYBOARD_SHORTCUTS: {
+    readonly OPEN: "Enter";
+    readonly ACTIVATE: " ";
+    readonly CLOSE: "Escape";
+};

package/dist/src/context/CalendarContext.d.ts

@@ -0,0 +1,83 @@
+import { default as React, ReactNode, Dispatch } from 'react';
+import { DateType } from '../utils';
+import { ECalendarViewType, CalendarProps } from '../types';
+import { CALENDAR_ACTIONS } from '../constants';
+/**
+ * Mutable runtime state managed by the calendar reducer.
+ */
+export interface CalendarState {
+    /** The currently selected (navigated-to) date. */
+    selectedDate: DateType;
+    /** The active view mode. */
+    view: ECalendarViewType;
+    /** Number of days shown when view is `customDays`. */
+    customDays?: number;
+}
+/**
+ * Union of all dispatchable actions for the calendar reducer.
+ * - `SET_DATE` — jump to a specific date
+ * - `SET_VIEW` — switch the active view
+ * - `NEXT` / `PREV` — advance or retreat by one view-unit (month, week, day, or N custom days)
+ * - `TODAY` — reset navigation to today
+ */
+export type CalendarAction = {
+    type: typeof CALENDAR_ACTIONS.SET_DATE;
+    payload: DateType;
+} | {
+    type: typeof CALENDAR_ACTIONS.SET_VIEW;
+    payload: ECalendarViewType;
+} | {
+    type: typeof CALENDAR_ACTIONS.SET_CUSTOM_DAYS;
+    payload: number;
+} | {
+    type: typeof CALENDAR_ACTIONS.NEXT;
+} | {
+    type: typeof CALENDAR_ACTIONS.PREV;
+} | {
+    type: typeof CALENDAR_ACTIONS.TODAY;
+};
+/**
+ * Shape of the value exposed by `CalendarContext`.
+ */
+export interface CalendarContextValue {
+    /** Current reducer state (selected date, view, customDays). */
+    state: CalendarState;
+    /** Dispatch function for sending actions to the reducer. */
+    dispatch: Dispatch<CalendarAction>;
+    /** `data-testid` forwarded from the root `<Calendar>` prop. */
+    testId?: string;
+    /** Static calendar configuration props (everything except `children`, `selectedDate`, and `view`). */
+    config: Omit<CalendarProps, "children" | "selectedDate" | "view">;
+    /** Resolved color scheme ("light" or "dark") for portaled UI such as Popover. */
+    colorScheme: "light" | "dark";
+}
+export declare const CalendarContext: React.Context<CalendarContextValue | undefined>;
+/**
+ * Props accepted by `CalendarProvider`.
+ */
+export interface CalendarProviderProps {
+    /** Content rendered inside the calendar layout. */
+    children: ReactNode;
+    /** Starting selected date for the reducer. */
+    initialDate: DateType;
+    /** Starting view mode for the reducer. */
+    initialView: ECalendarViewType;
+    /** Starting value for `customDays` when the initial view is `customDays`. */
+    initialCustomDays?: number;
+    /** Forwarded `data-testid` from the root `<Calendar>` prop. */
+    testId?: string;
+    /** Static configuration props passed through to all child components via context. */
+    config?: Omit<CalendarProps, "children" | "selectedDate" | "view">;
+}
+/**
+ * Provides calendar state and dispatch to the component tree via `CalendarContext`.
+ * Wrap view components with this provider; consume state via `useCalendar()`.
+ */
+export declare function CalendarProvider({ children, initialDate, initialView, initialCustomDays, testId, config, }: CalendarProviderProps): React.JSX.Element;
+/**
+ * Consumes `CalendarContext` and returns the current state, dispatch, and config.
+ * Must be called inside a `CalendarProvider` — throws if the context is missing.
+ *
+ * @returns The current `CalendarContextValue`.
+ */
+export declare function useCalendar(): CalendarContextValue;

package/dist/src/context/CalendarContext.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/hooks/useAllDayBanner.d.ts

@@ -0,0 +1,48 @@
+import { DateType } from '../utils/date';
+import { CalendarEvent } from '../types';
+/**
+ * Represents the layout information for an event displayed in the all-day banner.
+ */
+export interface BannerLayoutEvent {
+    /** The original calendar event data */
+    event: CalendarEvent;
+    /** The index of the day where the event starts within the current view */
+    startIndex: number;
+    /** The index of the day where the event ends within the current view */
+    endIndex: number;
+    /** Indicates if the event starts before the current view's start date */
+    isClippedLeft: boolean;
+    /** Indicates if the event ends after the current view's end date */
+    isClippedRight: boolean;
+    /** The vertical row index where the event should be positioned to avoid overlap */
+    row: number;
+}
+/**
+ * Hook to calculate layout and positioning for multi-day and all-day events in a banner view.
+ * It determines which events are visible, how they stack vertically to avoid overlapping,
+ * and handles an expanded/collapsed state when there are too many concurrent events.
+ *
+ * @param days - The array of days currently visible in the calendar view.
+ * @param events - The complete array of calendar events to filter and layout.
+ * @param isExpanded - Whether the banner is currently expanded to show all stacked events.
+ * @param maxVisibleRows - The maximum number of event rows to show before collapsing (default: 3).
+ * @returns An object containing layout details:
+ * - `layoutEvents`: All calculated events that intersect with the current view.
+ * - `rowCount`: The total number of rows required to display all events without overlap.
+ * - `effectiveMaxRows`: The effective limit on visible rows.
+ * - `hiddenCounts`: An array representing the number of hidden events for each day index.
+ * - `hasHiddenEvents`: A boolean flag indicating if any events exceed the `maxVisibleRows`.
+ * - `visibleLayoutEvents`: The events that should currently be rendered based on the `isExpanded` state.
+ * - `containerHeight`: The computed height of the banner container.
+ * - `showExpandCollapse`: A boolean flag indicating if the expand/collapse button should be rendered.
+ */
+export default function useAllDayBanner(days: DateType[], events: CalendarEvent[], isExpanded: boolean, maxVisibleRows?: number): {
+    layoutEvents: BannerLayoutEvent[];
+    rowCount: number;
+    effectiveMaxRows: number;
+    hiddenCounts: any[];
+    hasHiddenEvents: boolean;
+    visibleLayoutEvents: BannerLayoutEvent[];
+    containerHeight: number;
+    showExpandCollapse: boolean;
+};

package/dist/src/hooks/useAllDayBanner.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/hooks/useCalendarProps.d.ts

@@ -0,0 +1,10 @@
+import { CalendarProps, CalendarContentProps } from '../types';
+/**
+ * Merges the global calendar config from context with view-local props.
+ * Local props take precedence — undefined values are ignored so they don't
+ * accidentally overwrite context defaults.
+ *
+ * @param localProps - Props specific to the calling view component.
+ * @returns Merged `CalendarContentProps` with all required defaults guaranteed.
+ */
+export default function useCalendarProps<T extends Partial<CalendarProps>>(localProps: T): CalendarContentProps;

package/dist/src/hooks/useColorScheme.d.ts

@@ -0,0 +1,2 @@
+import { ColorScheme } from '../types';
+export default function useColorScheme(colorScheme: ColorScheme | undefined): "light" | "dark";

package/dist/src/hooks/useColorScheme.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/hooks/useDayEventLayout.d.ts

@@ -0,0 +1,27 @@
+import { CalendarEvent } from '../types';
+import { DateType } from '../utils/date';
+export interface UseDayEventLayoutOptions {
+    enableEnrichedEvents?: boolean;
+    enrichedEventsByDate?: Record<string, CalendarEvent[]>;
+    eventsAreSorted?: boolean;
+    isEventOrderingEnabled?: boolean;
+}
+/**
+ * Represents the final calculated CSS positioning for an event in the day view.
+ */
+export interface DayEventLayout {
+    event: CalendarEvent;
+    top: number;
+    height: number;
+    left: number;
+    width: number;
+    zIndex: number;
+}
+/**
+ * Hook to calculate layout and positioning for timed events in a day or week view.
+ *
+ * @param events - The complete array of calendar events.
+ * @param currentDateOrDates - A single date (for Day view) or array of dates (for Week view) to render.
+ * @returns A layout array (for a single day) or a nested array of layouts (for multiple days).
+ */
+export default function useDayEventLayout(events: CalendarEvent[], currentDateOrDates: DateType | DateType[], minHour: number, maxHour: number, showAllDayRow: boolean, eventOverlapOffset: number, options?: UseDayEventLayoutOptions): DayEventLayout[] | DayEventLayout[][];

package/dist/src/hooks/useDayEventLayout.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/hooks/useEvents.d.ts

@@ -0,0 +1,16 @@
+import { CalendarEvent } from '../types/events';
+/**
+ * Hook to filter and return only valid calendar events.
+ *
+ * Events where `endDate` is chronologically before `startDate` are silently removed.
+ * This is intentional — such events have no renderable duration (C-TC3).
+ *
+ * @param events - The raw array of calendar events to process. Events with
+ *   `endDate < startDate` are filtered out (negative-duration guard).
+ * @param eventsAreSorted - When `true`, skips validation and returns events as-is (caller guarantees
+ *   events are pre-sorted by `startDate` ascending). **Caveat:** unsorted input will render in the
+ *   provided order — the library never re-sorts the array.
+ * @param enableEnrichedEvents - When `true`, skips validation (caller supplies pre-enriched events via `enrichedEventsByDate`).
+ * @returns A memoized array containing only logically valid events.
+ */
+export default function useEvents(events: CalendarEvent[], eventsAreSorted?: boolean, enableEnrichedEvents?: boolean): CalendarEvent[];

package/dist/src/hooks/useEvents.test.d.ts

@@ -0,0 +1 @@
+export {};