themelia-ui 1.0.0

package/dist/components/features/data-view/data-view.types.d.ts

@@ -0,0 +1,116 @@
+import { RowData } from '@tanstack/react-table';
+import { ReactNode } from 'react';
+import { ActiveFilter, FilterConfig, FilterErrorHandler, FilterStrings, FilterTab } from '../filters/index.js';
+import { DataTableProps } from '../table/index.js';
+import { DataViewPaginationStrings } from './data-view.strings.js';
+export interface DataViewShellProps {
+    children?: ReactNode;
+    header?: ReactNode;
+    toolbar?: ReactNode;
+    footer?: ReactNode;
+    /** Rendered in place of the content when `empty` is set. */
+    emptySlot?: ReactNode;
+    empty?: boolean;
+    className?: string;
+    contentClassName?: string;
+}
+export interface DataViewToolbarProps {
+    leading?: ReactNode;
+    search?: ReactNode;
+    filters?: ReactNode;
+    views?: ReactNode;
+    /** Pushed to the trailing edge — the page's own actions, not the table's. */
+    actions?: ReactNode;
+    className?: string;
+}
+export interface DataViewTableFrameProps {
+    toolbar?: ReactNode;
+    children?: ReactNode;
+    footer?: ReactNode;
+    className?: string;
+    toolbarClassName?: string;
+    contentClassName?: string;
+    footerClassName?: string;
+}
+export interface DataViewFilterRowsArgs<TData extends RowData> {
+    data: readonly TData[];
+    activeFilters: readonly ActiveFilter[];
+    filters: readonly FilterConfig[];
+}
+/** Replaces the built-in row matching entirely — for filtering done on the server. */
+export type DataViewFilterRows<TData extends RowData> = (args: DataViewFilterRowsArgs<TData>) => TData[];
+/** Reads the value a filter compares against, for a nested or computed field. */
+export type DataViewFilterValueGetter<TData extends RowData> = (row: TData, filter: FilterConfig) => unknown;
+export interface DataViewFilteringConfig<TData extends RowData> {
+    filters: FilterConfig[];
+    activeFilters: ActiveFilter[];
+    onFilterChange: (filters: ActiveFilter[]) => void;
+    filterRows?: DataViewFilterRows<TData>;
+    getFilterValue?: DataViewFilterValueGetter<TData>;
+    tabs?: FilterTab[];
+    /** A tab row, or a select — the same saved views, at two widths. */
+    tabsDisplay?: "tabs" | "select";
+    tabsLabel?: string;
+    /** A change is in flight; the bar dims. */
+    isFiltering?: boolean;
+    strings?: Partial<FilterStrings>;
+    onError?: FilterErrorHandler;
+}
+/**
+ * The table's props, minus the ones DataView owns.
+ *
+ * Removed rather than merged, because a consumer setting `surface` here and DataView
+ * setting it too is a conflict with no right answer — the frame already draws the card.
+ */
+export type DataViewTableOptions<TData extends RowData, TValue = unknown> = Omit<DataTableProps<TData, TValue>, "columns" | "data" | "surface" | "headerTransparent" | "topbarContent" | "topbarEnd">;
+export interface DataViewSlots {
+    /** Above the filter bar, inside the table's topbar. */
+    topbarContent?: ReactNode;
+    /** Leading content in the auxiliary row, beside the saved-view select. */
+    toolbarStart?: ReactNode;
+    toolbarAfterFilters?: ReactNode;
+    /** Trailing content in the table's topbar, beside its own controls. */
+    topbarEnd?: ReactNode;
+    /** Below the table, inside the frame. */
+    footer?: ReactNode;
+}
+export interface DataViewProps<TData extends RowData, TValue = unknown> {
+    data: readonly TData[];
+    columns: DataTableProps<TData, TValue>["columns"];
+    filtering?: DataViewFilteringConfig<TData>;
+    table?: DataViewTableOptions<TData, TValue>;
+    slots?: DataViewSlots;
+    className?: string;
+}
+export interface UseDataViewOptions<TData extends RowData> {
+    data: readonly TData[];
+    filtering?: DataViewFilteringConfig<TData>;
+}
+export interface UseDataViewResult<TData extends RowData> {
+    rows: readonly TData[];
+    error: unknown;
+    /** The matcher threw. `rows` is the UNFILTERED data — see the hook. */
+    failed: boolean;
+}
+export interface DataViewPaginationProps {
+    page: number;
+    pageCount?: number;
+    /** The result-count line beside the pager. */
+    total?: ReactNode;
+    onPageChange?: (page: number) => void;
+    disabled?: boolean;
+    className?: string;
+    strings?: Partial<DataViewPaginationStrings>;
+}
+export interface SavedViewTab {
+    id: string;
+    label: ReactNode;
+    count?: ReactNode;
+    disabled?: boolean;
+}
+export interface SavedViewTabsProps {
+    views: readonly SavedViewTab[];
+    value: string;
+    onValueChange: (value: string) => void;
+    className?: string;
+}

package/dist/components/features/data-view/index.d.cts

@@ -0,0 +1,5 @@
+export { DataView, DataViewPagination, DataViewShell, DataViewTableFrame, DataViewToolbar, SavedViewTabs, } from './data-view.cjs';
+export { useDataView } from './use-data-view.cjs';
+export { applyDataViewFilters } from './data-view-filtering.cjs';
+export { defaultDataViewFilterTabsLabel, defaultDataViewPaginationStrings, type DataViewPaginationStrings, } from './data-view.strings.cjs';
+export type { DataViewFilterRows, DataViewFilterRowsArgs, DataViewFilterValueGetter, DataViewFilteringConfig, DataViewPaginationProps, DataViewProps, DataViewShellProps, DataViewSlots, DataViewTableFrameProps, DataViewTableOptions, DataViewToolbarProps, SavedViewTab, SavedViewTabsProps, UseDataViewOptions, UseDataViewResult, } from './data-view.types.cjs';

package/dist/components/features/data-view/index.d.ts

@@ -0,0 +1,5 @@
+export { DataView, DataViewPagination, DataViewShell, DataViewTableFrame, DataViewToolbar, SavedViewTabs, } from './data-view.js';
+export { useDataView } from './use-data-view.js';
+export { applyDataViewFilters } from './data-view-filtering.js';
+export { defaultDataViewFilterTabsLabel, defaultDataViewPaginationStrings, type DataViewPaginationStrings, } from './data-view.strings.js';
+export type { DataViewFilterRows, DataViewFilterRowsArgs, DataViewFilterValueGetter, DataViewFilteringConfig, DataViewPaginationProps, DataViewProps, DataViewShellProps, DataViewSlots, DataViewTableFrameProps, DataViewTableOptions, DataViewToolbarProps, SavedViewTab, SavedViewTabsProps, UseDataViewOptions, UseDataViewResult, } from './data-view.types.js';

package/dist/components/features/data-view/use-data-view.d.cts

@@ -0,0 +1,2 @@
+import { UseDataViewOptions, UseDataViewResult } from './data-view.types.cjs';
+export declare function useDataView<TData extends object>({ data, filtering, }: UseDataViewOptions<TData>): UseDataViewResult<TData>;

package/dist/components/features/data-view/use-data-view.d.ts

@@ -0,0 +1,2 @@
+import { UseDataViewOptions, UseDataViewResult } from './data-view.types.js';
+export declare function useDataView<TData extends object>({ data, filtering, }: UseDataViewOptions<TData>): UseDataViewResult<TData>;

package/dist/components/features/event-calendar/event-calendar-day-cell.d.cts

@@ -0,0 +1,2 @@
+import { EventCalendarDayCellProps } from './event-calendar.types.cjs';
+export declare function EventCalendarDayCell({ data, categories, maxEvents, onClick, onEventClick, compact, strings, renderEvent, }: EventCalendarDayCellProps): import("react").JSX.Element;

package/dist/components/features/event-calendar/event-calendar-day-cell.d.ts

@@ -0,0 +1,2 @@
+import { EventCalendarDayCellProps } from './event-calendar.types.js';
+export declare function EventCalendarDayCell({ data, categories, maxEvents, onClick, onEventClick, compact, strings, renderEvent, }: EventCalendarDayCellProps): import("react").JSX.Element;

package/dist/components/features/event-calendar/event-calendar-event-badge.d.cts

@@ -0,0 +1,2 @@
+import { EventCalendarEventBadgeProps } from './event-calendar.types.cjs';
+export declare function EventCalendarEventBadge({ event, category, compact, onClick, strings, }: EventCalendarEventBadgeProps): import("react").JSX.Element;

package/dist/components/features/event-calendar/event-calendar-event-badge.d.ts

@@ -0,0 +1,2 @@
+import { EventCalendarEventBadgeProps } from './event-calendar.types.js';
+export declare function EventCalendarEventBadge({ event, category, compact, onClick, strings, }: EventCalendarEventBadgeProps): import("react").JSX.Element;

package/dist/components/features/event-calendar/event-calendar-event-card.d.cts

@@ -0,0 +1,7 @@
+import { EventCalendarEventCardStrings } from './event-calendar.strings.cjs';
+import { EventCalendarEventCardProps } from './event-calendar.types.cjs';
+export interface EventCalendarEventCardPropsWithStrings extends EventCalendarEventCardProps {
+    strings?: Partial<EventCalendarEventCardStrings>;
+    className?: string;
+}
+export declare function EventCalendarEventCard({ event, category, onClick, strings, className, }: EventCalendarEventCardPropsWithStrings): import("react").JSX.Element;

package/dist/components/features/event-calendar/event-calendar-event-card.d.ts

@@ -0,0 +1,7 @@
+import { EventCalendarEventCardStrings } from './event-calendar.strings.js';
+import { EventCalendarEventCardProps } from './event-calendar.types.js';
+export interface EventCalendarEventCardPropsWithStrings extends EventCalendarEventCardProps {
+    strings?: Partial<EventCalendarEventCardStrings>;
+    className?: string;
+}
+export declare function EventCalendarEventCard({ event, category, onClick, strings, className, }: EventCalendarEventCardPropsWithStrings): import("react").JSX.Element;

package/dist/components/features/event-calendar/event-calendar-header.d.cts

@@ -0,0 +1,2 @@
+import { EventCalendarHeaderProps } from './event-calendar.types.cjs';
+export declare function EventCalendarHeader({ currentDate, viewMode, displayLabel, onPrevious, onNext, onToday, onViewModeChange, onDateChange, actions, strings, rangeMode, minDate, maxDate, prevDisabled, nextDisabled, className, }: EventCalendarHeaderProps): import("react").JSX.Element;

package/dist/components/features/event-calendar/event-calendar-header.d.ts

@@ -0,0 +1,2 @@
+import { EventCalendarHeaderProps } from './event-calendar.types.js';
+export declare function EventCalendarHeader({ currentDate, viewMode, displayLabel, onPrevious, onNext, onToday, onViewModeChange, onDateChange, actions, strings, rangeMode, minDate, maxDate, prevDisabled, nextDisabled, className, }: EventCalendarHeaderProps): import("react").JSX.Element;

package/dist/components/features/event-calendar/event-calendar-legend.d.cts

@@ -0,0 +1,2 @@
+import { EventCalendarLegendProps } from './event-calendar.types.cjs';
+export declare function EventCalendarLegend({ categories, visibleCategories, onToggleCategory, enableFiltering, strings, className, }: EventCalendarLegendProps): import("react").JSX.Element | null;

package/dist/components/features/event-calendar/event-calendar-legend.d.ts

@@ -0,0 +1,2 @@
+import { EventCalendarLegendProps } from './event-calendar.types.js';
+export declare function EventCalendarLegend({ categories, visibleCategories, onToggleCategory, enableFiltering, strings, className, }: EventCalendarLegendProps): import("react").JSX.Element | null;

package/dist/components/features/event-calendar/event-calendar.d.cts

@@ -0,0 +1,2 @@
+import { EventCalendarProps } from './event-calendar.types.cjs';
+export declare function EventCalendar({ events, categories, viewMode, defaultViewMode, onViewModeChange, date, defaultDate, onDateChange, onEventClick, onDayClick, maxEventsPerDay, showLegend, showHeader, showWeekends, weekStartsOn: weekStartsOnProp, locale, enableCategoryFilter, visibleCategories: controlledVisibleCategories, onVisibleCategoriesChange, loading, emptyStateMessage, className, compact, actions, strings, dayHeadingVariant, dayHeadingClassName, renderDayHeading, rangeMode, minDate, maxDate, disabledDates, filterEvent, renderEvent, renderDayCell, }: EventCalendarProps): import("react").JSX.Element;

package/dist/components/features/event-calendar/event-calendar.d.ts

@@ -0,0 +1,2 @@
+import { EventCalendarProps } from './event-calendar.types.js';
+export declare function EventCalendar({ events, categories, viewMode, defaultViewMode, onViewModeChange, date, defaultDate, onDateChange, onEventClick, onDayClick, maxEventsPerDay, showLegend, showHeader, showWeekends, weekStartsOn: weekStartsOnProp, locale, enableCategoryFilter, visibleCategories: controlledVisibleCategories, onVisibleCategoriesChange, loading, emptyStateMessage, className, compact, actions, strings, dayHeadingVariant, dayHeadingClassName, renderDayHeading, rangeMode, minDate, maxDate, disabledDates, filterEvent, renderEvent, renderDayCell, }: EventCalendarProps): import("react").JSX.Element;

package/dist/components/features/event-calendar/event-calendar.strings.d.cts

@@ -0,0 +1,38 @@
+export interface EventCalendarStrings {
+    today: string;
+    previous: string;
+    next: string;
+    loading: string;
+    /** Names the month/year jump control, which draws no label of its own. */
+    jumpToMonth: string;
+    /** Names the legend when it filters, so a screen reader knows the chips do something. */
+    filterCategories: string;
+    /** The overflow line under a day's chips. */
+    moreEvents: (count: number) => string;
+    emptyDay: string;
+    viewMode: {
+        /**
+         * The accessible name of the SWITCHER, not of the current view: its trigger is a
+         * combobox, and a combobox is not named by the option it happens to show.
+         */
+        label: string;
+        month: string;
+        week: string;
+        agenda: string;
+    };
+    /** Sunday first. The calendar rotates them to match `weekStartsOn`. */
+    weekdaysShort: [string, string, string, string, string, string, string];
+}
+export declare const defaultEventCalendarStrings: EventCalendarStrings;
+export interface EventCalendarEventCardStrings {
+    guest: string;
+    guests: string;
+    /**
+     * Names one event chip: its title and when it starts.
+     *
+     * One function rather than a title and a separate " at ", because the word between
+     * them and the order around it are the sentence, and neither is English's to fix.
+     */
+    eventAt: (title: string, time: string) => string;
+}
+export declare const defaultEventCalendarEventCardStrings: EventCalendarEventCardStrings;

package/dist/components/features/event-calendar/event-calendar.strings.d.ts

@@ -0,0 +1,38 @@
+export interface EventCalendarStrings {
+    today: string;
+    previous: string;
+    next: string;
+    loading: string;
+    /** Names the month/year jump control, which draws no label of its own. */
+    jumpToMonth: string;
+    /** Names the legend when it filters, so a screen reader knows the chips do something. */
+    filterCategories: string;
+    /** The overflow line under a day's chips. */
+    moreEvents: (count: number) => string;
+    emptyDay: string;
+    viewMode: {
+        /**
+         * The accessible name of the SWITCHER, not of the current view: its trigger is a
+         * combobox, and a combobox is not named by the option it happens to show.
+         */
+        label: string;
+        month: string;
+        week: string;
+        agenda: string;
+    };
+    /** Sunday first. The calendar rotates them to match `weekStartsOn`. */
+    weekdaysShort: [string, string, string, string, string, string, string];
+}
+export declare const defaultEventCalendarStrings: EventCalendarStrings;
+export interface EventCalendarEventCardStrings {
+    guest: string;
+    guests: string;
+    /**
+     * Names one event chip: its title and when it starts.
+     *
+     * One function rather than a title and a separate " at ", because the word between
+     * them and the order around it are the sentence, and neither is English's to fix.
+     */
+    eventAt: (title: string, time: string) => string;
+}
+export declare const defaultEventCalendarEventCardStrings: EventCalendarEventCardStrings;

package/dist/components/features/event-calendar/event-calendar.types.d.cts

@@ -0,0 +1,171 @@
+import { ReactNode } from 'react';
+import { Locale } from 'date-fns';
+import { ActionDefinition } from '../../base/action-menu/index.cjs';
+import { EventCalendarStrings, EventCalendarEventCardStrings } from './event-calendar.strings.cjs';
+export interface CalendarEvent {
+    id: string;
+    title: string;
+    description?: string;
+    startDate: Date;
+    /** Inclusive. An event without one occupies its start day alone. */
+    endDate?: Date;
+    allDay?: boolean;
+    /** A category id. An unknown one falls back to the neutral token. */
+    category: string;
+    /** Free-form payload. The default card reads `customerName`, `guestCount`,
+     *  `serviceName`, and `cellTitle` from it when they are there. */
+    metadata?: Record<string, unknown>;
+    url?: string;
+}
+export type CalendarColorToken = "neutral" | "destructive" | "warning" | "amber" | "yellow" | "success" | "info" | "primary";
+export interface EventCategory {
+    id: string;
+    label: string;
+    colorToken: CalendarColorToken;
+    icon?: ReactNode;
+    description?: string;
+}
+/** The only fallback: a category that is missing entirely. */
+export declare function resolveCategoryColorToken(category?: EventCategory | null): CalendarColorToken;
+export type CalendarViewMode = "month" | "week" | "agenda";
+/** One day, after the events have been placed on it. */
+export interface CalendarDayData {
+    date: Date;
+    isCurrentMonth: boolean;
+    isToday: boolean;
+    isWeekend: boolean;
+    /** All-day first, then by start time. */
+    events: CalendarEvent[];
+    eventCount: number;
+    hasMultipleEvents: boolean;
+}
+/** Explicit dates, a predicate, or both — combined with OR. */
+export type DateRule = Date[] | ((date: Date) => boolean) | {
+    dates?: Date[];
+    predicate?: (date: Date) => boolean;
+};
+/** Returns true to KEEP an event. */
+export type EventFilter = (event: CalendarEvent) => boolean;
+export type RenderEventFn = (event: CalendarEvent, category: EventCategory | undefined) => ReactNode;
+/** `defaultRender` is what would have drawn, so decorating is as easy as replacing. */
+export type RenderDayCellFn = (day: CalendarDayData, defaultRender: () => ReactNode) => ReactNode;
+/** `date` offers a full calendar; `month-year` offers a compact month/year jump. */
+export type EventCalendarRangeMode = "date" | "month-year";
+export type EventCalendarDayHeadingVariant = "default" | "accent" | "tinted" | "bordered";
+export interface EventCalendarProps {
+    /** The calendar does no fetching of its own. */
+    events: CalendarEvent[];
+    categories: EventCategory[];
+    viewMode?: CalendarViewMode;
+    defaultViewMode?: CalendarViewMode;
+    onViewModeChange?: (mode: CalendarViewMode) => void;
+    date?: Date;
+    defaultDate?: Date;
+    onDateChange?: (date: Date) => void;
+    onEventClick?: (event: CalendarEvent) => void;
+    /** Fires with the day and everything on it. */
+    onDayClick?: (date: Date, events: CalendarEvent[]) => void;
+    /** Chips drawn per day before the rest collapse into an overflow line. */
+    maxEventsPerDay?: number;
+    showLegend?: boolean;
+    showHeader?: boolean;
+    showWeekends?: boolean;
+    /** 0 is Sunday. Falls back to the provider's dates config, then Monday. */
+    weekStartsOn?: 0 | 1 | 2 | 3 | 4 | 5 | 6;
+    locale?: Locale;
+    /** Makes the legend chips toggle their category. */
+    enableCategoryFilter?: boolean;
+    /** Ids currently shown. EMPTY means all — a filter nobody has touched hides nothing. */
+    visibleCategories?: string[];
+    onVisibleCategoriesChange?: (categories: string[]) => void;
+    loading?: boolean;
+    emptyStateMessage?: string;
+    className?: string;
+    compact?: boolean;
+    /** Rendered in the header, before the today and navigation controls. */
+    actions?: ActionDefinition[];
+    strings?: Partial<EventCalendarStrings>;
+    dayHeadingVariant?: EventCalendarDayHeadingVariant;
+    dayHeadingClassName?: string;
+    renderDayHeading?: (day: string, index: number) => ReactNode;
+    rangeMode?: EventCalendarRangeMode;
+    /** Navigation stops here, and days beyond it are drawn but not clickable. */
+    minDate?: Date;
+    maxDate?: Date;
+    disabledDates?: DateRule;
+    /** Hides events at render time without touching `events`. */
+    filterEvent?: EventFilter;
+    renderEvent?: RenderEventFn;
+    renderDayCell?: RenderDayCellFn;
+}
+export interface EventCalendarDayCellProps {
+    data: CalendarDayData;
+    categories: EventCategory[];
+    maxEvents?: number;
+    onClick: () => void;
+    /** Fires instead of `onClick` when the press was on an event chip. */
+    onEventClick?: (event: CalendarEvent) => void;
+    compact?: boolean;
+    strings?: Partial<Pick<EventCalendarStrings, "moreEvents">>;
+    renderEvent?: RenderEventFn;
+}
+export interface EventCalendarEventBadgeProps {
+    event: CalendarEvent;
+    category: EventCategory | undefined;
+    compact?: boolean;
+    onClick?: () => void;
+    /** Overrides this chip's own copy — its accessible name. */
+    strings?: Partial<EventCalendarEventCardStrings>;
+}
+export interface EventCalendarEventCardProps {
+    event: CalendarEvent;
+    category: EventCategory | undefined;
+    onClick?: () => void;
+}
+export interface EventCalendarLegendProps {
+    categories: EventCategory[];
+    /** Empty means all are shown. */
+    visibleCategories?: string[];
+    onToggleCategory?: (categoryId: string) => void;
+    enableFiltering?: boolean;
+    strings?: Partial<Pick<EventCalendarStrings, "filterCategories">>;
+    className?: string;
+}
+export interface EventCalendarHeaderProps {
+    currentDate: Date;
+    viewMode: CalendarViewMode;
+    /** The formatted period — "March 2026", or a week's span. */
+    displayLabel: string;
+    onPrevious: () => void;
+    onNext: () => void;
+    onToday: () => void;
+    onViewModeChange?: (mode: CalendarViewMode) => void;
+    onDateChange?: (date: Date) => void;
+    locale?: Locale;
+    actions?: ActionDefinition[];
+    strings?: Partial<EventCalendarStrings>;
+    rangeMode?: EventCalendarRangeMode;
+    minDate?: Date;
+    maxDate?: Date;
+    prevDisabled?: boolean;
+    nextDisabled?: boolean;
+    className?: string;
+}
+export interface UseEventCalendarResult {
+    currentDate: Date;
+    viewMode: CalendarViewMode;
+    calendarDays: CalendarDayData[];
+    visibleEvents: CalendarEvent[];
+    goToToday: () => void;
+    goToNextPeriod: () => void;
+    goToPreviousPeriod: () => void;
+    setDate: (date: Date) => void;
+    setViewMode: (mode: CalendarViewMode) => void;
+    displayLabel: string;
+    hasEvents: boolean;
+}
+export interface UseEventCalendarDataOptions {
+    weekStartsOn?: 0 | 1 | 2 | 3 | 4 | 5 | 6;
+    showWeekends?: boolean;
+    visibleCategories?: string[];
+}

package/dist/components/features/event-calendar/event-calendar.types.d.ts

@@ -0,0 +1,171 @@
+import { ReactNode } from 'react';
+import { Locale } from 'date-fns';
+import { ActionDefinition } from '../../base/action-menu/index.js';
+import { EventCalendarStrings, EventCalendarEventCardStrings } from './event-calendar.strings.js';
+export interface CalendarEvent {
+    id: string;
+    title: string;
+    description?: string;
+    startDate: Date;
+    /** Inclusive. An event without one occupies its start day alone. */
+    endDate?: Date;
+    allDay?: boolean;
+    /** A category id. An unknown one falls back to the neutral token. */
+    category: string;
+    /** Free-form payload. The default card reads `customerName`, `guestCount`,
+     *  `serviceName`, and `cellTitle` from it when they are there. */
+    metadata?: Record<string, unknown>;
+    url?: string;
+}
+export type CalendarColorToken = "neutral" | "destructive" | "warning" | "amber" | "yellow" | "success" | "info" | "primary";
+export interface EventCategory {
+    id: string;
+    label: string;
+    colorToken: CalendarColorToken;
+    icon?: ReactNode;
+    description?: string;
+}
+/** The only fallback: a category that is missing entirely. */
+export declare function resolveCategoryColorToken(category?: EventCategory | null): CalendarColorToken;
+export type CalendarViewMode = "month" | "week" | "agenda";
+/** One day, after the events have been placed on it. */
+export interface CalendarDayData {
+    date: Date;
+    isCurrentMonth: boolean;
+    isToday: boolean;
+    isWeekend: boolean;
+    /** All-day first, then by start time. */
+    events: CalendarEvent[];
+    eventCount: number;
+    hasMultipleEvents: boolean;
+}
+/** Explicit dates, a predicate, or both — combined with OR. */
+export type DateRule = Date[] | ((date: Date) => boolean) | {
+    dates?: Date[];
+    predicate?: (date: Date) => boolean;
+};
+/** Returns true to KEEP an event. */
+export type EventFilter = (event: CalendarEvent) => boolean;
+export type RenderEventFn = (event: CalendarEvent, category: EventCategory | undefined) => ReactNode;
+/** `defaultRender` is what would have drawn, so decorating is as easy as replacing. */
+export type RenderDayCellFn = (day: CalendarDayData, defaultRender: () => ReactNode) => ReactNode;
+/** `date` offers a full calendar; `month-year` offers a compact month/year jump. */
+export type EventCalendarRangeMode = "date" | "month-year";
+export type EventCalendarDayHeadingVariant = "default" | "accent" | "tinted" | "bordered";
+export interface EventCalendarProps {
+    /** The calendar does no fetching of its own. */
+    events: CalendarEvent[];
+    categories: EventCategory[];
+    viewMode?: CalendarViewMode;
+    defaultViewMode?: CalendarViewMode;
+    onViewModeChange?: (mode: CalendarViewMode) => void;
+    date?: Date;
+    defaultDate?: Date;
+    onDateChange?: (date: Date) => void;
+    onEventClick?: (event: CalendarEvent) => void;
+    /** Fires with the day and everything on it. */
+    onDayClick?: (date: Date, events: CalendarEvent[]) => void;
+    /** Chips drawn per day before the rest collapse into an overflow line. */
+    maxEventsPerDay?: number;
+    showLegend?: boolean;
+    showHeader?: boolean;
+    showWeekends?: boolean;
+    /** 0 is Sunday. Falls back to the provider's dates config, then Monday. */
+    weekStartsOn?: 0 | 1 | 2 | 3 | 4 | 5 | 6;
+    locale?: Locale;
+    /** Makes the legend chips toggle their category. */
+    enableCategoryFilter?: boolean;
+    /** Ids currently shown. EMPTY means all — a filter nobody has touched hides nothing. */
+    visibleCategories?: string[];
+    onVisibleCategoriesChange?: (categories: string[]) => void;
+    loading?: boolean;
+    emptyStateMessage?: string;
+    className?: string;
+    compact?: boolean;
+    /** Rendered in the header, before the today and navigation controls. */
+    actions?: ActionDefinition[];
+    strings?: Partial<EventCalendarStrings>;
+    dayHeadingVariant?: EventCalendarDayHeadingVariant;
+    dayHeadingClassName?: string;
+    renderDayHeading?: (day: string, index: number) => ReactNode;
+    rangeMode?: EventCalendarRangeMode;
+    /** Navigation stops here, and days beyond it are drawn but not clickable. */
+    minDate?: Date;
+    maxDate?: Date;
+    disabledDates?: DateRule;
+    /** Hides events at render time without touching `events`. */
+    filterEvent?: EventFilter;
+    renderEvent?: RenderEventFn;
+    renderDayCell?: RenderDayCellFn;
+}
+export interface EventCalendarDayCellProps {
+    data: CalendarDayData;
+    categories: EventCategory[];
+    maxEvents?: number;
+    onClick: () => void;
+    /** Fires instead of `onClick` when the press was on an event chip. */
+    onEventClick?: (event: CalendarEvent) => void;
+    compact?: boolean;
+    strings?: Partial<Pick<EventCalendarStrings, "moreEvents">>;
+    renderEvent?: RenderEventFn;
+}
+export interface EventCalendarEventBadgeProps {
+    event: CalendarEvent;
+    category: EventCategory | undefined;
+    compact?: boolean;
+    onClick?: () => void;
+    /** Overrides this chip's own copy — its accessible name. */
+    strings?: Partial<EventCalendarEventCardStrings>;
+}
+export interface EventCalendarEventCardProps {
+    event: CalendarEvent;
+    category: EventCategory | undefined;
+    onClick?: () => void;
+}
+export interface EventCalendarLegendProps {
+    categories: EventCategory[];
+    /** Empty means all are shown. */
+    visibleCategories?: string[];
+    onToggleCategory?: (categoryId: string) => void;
+    enableFiltering?: boolean;
+    strings?: Partial<Pick<EventCalendarStrings, "filterCategories">>;
+    className?: string;
+}
+export interface EventCalendarHeaderProps {
+    currentDate: Date;
+    viewMode: CalendarViewMode;
+    /** The formatted period — "March 2026", or a week's span. */
+    displayLabel: string;
+    onPrevious: () => void;
+    onNext: () => void;
+    onToday: () => void;
+    onViewModeChange?: (mode: CalendarViewMode) => void;
+    onDateChange?: (date: Date) => void;
+    locale?: Locale;
+    actions?: ActionDefinition[];
+    strings?: Partial<EventCalendarStrings>;
+    rangeMode?: EventCalendarRangeMode;
+    minDate?: Date;
+    maxDate?: Date;
+    prevDisabled?: boolean;
+    nextDisabled?: boolean;
+    className?: string;
+}
+export interface UseEventCalendarResult {
+    currentDate: Date;
+    viewMode: CalendarViewMode;
+    calendarDays: CalendarDayData[];
+    visibleEvents: CalendarEvent[];
+    goToToday: () => void;
+    goToNextPeriod: () => void;
+    goToPreviousPeriod: () => void;
+    setDate: (date: Date) => void;
+    setViewMode: (mode: CalendarViewMode) => void;
+    displayLabel: string;
+    hasEvents: boolean;
+}
+export interface UseEventCalendarDataOptions {
+    weekStartsOn?: 0 | 1 | 2 | 3 | 4 | 5 | 6;
+    showWeekends?: boolean;
+    visibleCategories?: string[];
+}

package/dist/components/features/event-calendar/index.d.cts

@@ -0,0 +1,11 @@
+export { EventCalendar } from './event-calendar.cjs';
+export { EventCalendarHeader } from './event-calendar-header.cjs';
+export { EventCalendarDayCell } from './event-calendar-day-cell.cjs';
+export { EventCalendarEventBadge } from './event-calendar-event-badge.cjs';
+export { EventCalendarEventCard, type EventCalendarEventCardPropsWithStrings, } from './event-calendar-event-card.cjs';
+export { EventCalendarLegend } from './event-calendar-legend.cjs';
+export { useEventCalendar, type UseEventCalendarOptions } from './use-event-calendar.cjs';
+export { useEventCalendarData, getEventsForDay, getCategoryById, } from './use-event-calendar-data.cjs';
+export { defaultEventCalendarStrings, defaultEventCalendarEventCardStrings, type EventCalendarStrings, type EventCalendarEventCardStrings, } from './event-calendar.strings.cjs';
+export { resolveCategoryColorToken } from './event-calendar.types.cjs';
+export type { CalendarColorToken, CalendarDayData, CalendarEvent, CalendarViewMode, DateRule, EventCalendarDayCellProps, EventCalendarDayHeadingVariant, EventCalendarEventBadgeProps, EventCalendarEventCardProps, EventCalendarHeaderProps, EventCalendarLegendProps, EventCalendarProps, EventCalendarRangeMode, EventCategory, EventFilter, RenderDayCellFn, RenderEventFn, UseEventCalendarDataOptions, UseEventCalendarResult, } from './event-calendar.types.cjs';

package/dist/components/features/event-calendar/index.d.ts

@@ -0,0 +1,11 @@
+export { EventCalendar } from './event-calendar.js';
+export { EventCalendarHeader } from './event-calendar-header.js';
+export { EventCalendarDayCell } from './event-calendar-day-cell.js';
+export { EventCalendarEventBadge } from './event-calendar-event-badge.js';
+export { EventCalendarEventCard, type EventCalendarEventCardPropsWithStrings, } from './event-calendar-event-card.js';
+export { EventCalendarLegend } from './event-calendar-legend.js';
+export { useEventCalendar, type UseEventCalendarOptions } from './use-event-calendar.js';
+export { useEventCalendarData, getEventsForDay, getCategoryById, } from './use-event-calendar-data.js';
+export { defaultEventCalendarStrings, defaultEventCalendarEventCardStrings, type EventCalendarStrings, type EventCalendarEventCardStrings, } from './event-calendar.strings.js';
+export { resolveCategoryColorToken } from './event-calendar.types.js';
+export type { CalendarColorToken, CalendarDayData, CalendarEvent, CalendarViewMode, DateRule, EventCalendarDayCellProps, EventCalendarDayHeadingVariant, EventCalendarEventBadgeProps, EventCalendarEventCardProps, EventCalendarHeaderProps, EventCalendarLegendProps, EventCalendarProps, EventCalendarRangeMode, EventCategory, EventFilter, RenderDayCellFn, RenderEventFn, UseEventCalendarDataOptions, UseEventCalendarResult, } from './event-calendar.types.js';

package/dist/components/features/event-calendar/use-event-calendar-data.d.cts

@@ -0,0 +1,7 @@
+import { CalendarDayData, CalendarEvent, CalendarViewMode, UseEventCalendarDataOptions } from './event-calendar.types.cjs';
+export declare function useEventCalendarData(events: CalendarEvent[], currentDate: Date, viewMode: CalendarViewMode, options?: UseEventCalendarDataOptions): CalendarDayData[];
+/** The same placement for one day, for a consumer building their own surface. */
+export declare function getEventsForDay(events: CalendarEvent[], date: Date): CalendarEvent[];
+export declare function getCategoryById<T extends {
+    id: string;
+}>(categories: T[], categoryId: string): T | undefined;