@dayflow/core 3.0.1 → 3.1.1

package/README.md

@@ -0,0 +1,49 @@
+# DayFlow
+
+**English** | [中文](README.zh.md) | [日本語](README.ja.md) | [Getting Started & Contributing](CONTRIBUTING.md)
+
+A flexible and feature-rich calendar component library for React applications with drag-and-drop support, multiple
+views, and plugin architecture.
+
+[![npm](https://img.shields.io/npm/v/@dayflow/core?logo=npm&color=blue&label=version)](https://www.npmjs.com/package/@dayflow/core)
+[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen?logo=github)](https://github.com/dayflow-js/dayflow/pulls)
+[![License](https://img.shields.io/github/license/dayflow-js/dayflow)](https://github.com/dayflow-js/dayflow/blob/main/LICENSE)
+[![Discord](https://img.shields.io/badge/Discord-Join%20Chat-5865F2?logo=discord&logoColor=white)](https://discord.gg/9vdFZKJqBb)
+
+## Features
+
+### Monthly, Weekly, Daily and Various View Types
+
+| Monthly                                 | Weekly                                 |
+| --------------------------------------- | -------------------------------------- |
+| ![image](https://raw.githubusercontent.com/dayflow-js/calendar/main/assets/images/MonthView.png) | ![image](https://raw.githubusercontent.com/dayflow-js/calendar/main/assets/images/WeekView.png) |
+
+| Daily                                 | Event Stack Level                        |
+| ------------------------------------- | ---------------------------------------- |
+| ![image](https://raw.githubusercontent.com/dayflow-js/calendar/main/assets/images/DayView.png) | ![image](https://raw.githubusercontent.com/dayflow-js/calendar/main/assets/images/stackLevel.png) |
+
+### Default Panel (with multiple Event Detail Panel options available)
+
+| Detail Popup                        | Detail Dialog                        |
+| ----------------------------------- | ------------------------------------ |
+| ![image](https://raw.githubusercontent.com/dayflow-js/calendar/main/assets/images/popup.png) | ![image](https://raw.githubusercontent.com/dayflow-js/calendar/main/assets/images/dialog.png) |
+
+### Easy to resize and drag
+
+https://github.com/user-attachments/assets/726a5232-35a8-4fe3-8e7b-4de07c455353
+
+https://github.com/user-attachments/assets/957317e5-02d8-4419-a74b-62b7d191e347
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+## Bug Reports
+
+If you find a bug, please file an issue on [GitHub Issues](https://github.com/dayflow-js/dayflow/issues).
+
+## Support
+
+For questions and support, please open an issue on GitHub or go to discord.
+
+---

package/dist/index.d.ts

@@ -1,6 +1,9 @@
 import { Temporal } from 'temporal-polyfill';
 import * as preact from 'preact';
-import { ComponentChildren, RefObject } from 'preact';
+import { ComponentChildren, RefObject, h } from 'preact';
+import * as preact_compat from 'preact/compat';
+export { createPortal } from 'preact/compat';
+import { BlossomColorPickerOptions } from '@dayflow/blossom-color-picker';
 
 /**
  * Calendar event interface (using Temporal API)
@@ -186,9 +189,17 @@ declare class CalendarRegistry {
      */
     validate(calendar: Partial<CalendarType>): string[];
 }
+/**
+ * Get calendar colors for a specific hex color
+ * Tries to match with default calendar types, otherwise generates generic colors
+ */
+declare function getCalendarColorsForHex(hex: string): {
+    colors: CalendarColors;
+    darkColors?: CalendarColors;
+};
 
 type LocaleCode = string;
-type TranslationKey = 'allDay' | 'noEvents' | 'more' | 'eventTitle' | 'dateRange' | 'timeRange' | 'note' | 'addNotePlaceholder' | 'setAsAllDay' | 'setAsTimed' | 'delete' | 'confirm' | 'cancel' | 'today' | 'day' | 'week' | 'month' | 'year' | 'newEvent' | 'newAllDayEvent' | 'newCalendarEvent' | 'newAllDayCalendarEvent' | 'save' | 'deleteCalendar' | 'deleteCalendarMessage' | 'merge' | 'confirmDeleteTitle' | 'confirmDeleteMessage' | 'mergeConfirmTitle' | 'mergeConfirmMessage' | 'expandSidebar' | 'collapseSidebar' | 'calendars' | 'createCalendar' | 'calendarNamePlaceholder' | 'customColor' | 'create' | 'calendarOptions' | 'untitled' | 'search' | 'noResults' | 'calendar' | 'starts' | 'ends' | 'notes' | 'titlePlaceholder' | 'notesPlaceholder' | 'editEvent' | 'done' | 'quickCreateEvent' | 'quickCreatePlaceholder' | 'noSuggestions' | 'newCalendar' | 'refreshAll' | 'tomorrow' | 'importCalendar' | 'exportCalendar' | 'addSchedule' | 'importCalendarMessage' | 'ok' | 'cut' | 'copy' | 'pasteHere' | 'eventSummary';
+type TranslationKey = 'allDay' | 'noEvents' | 'more' | 'eventTitle' | 'dateRange' | 'timeRange' | 'note' | 'addNotePlaceholder' | 'setAsAllDay' | 'setAsTimed' | 'delete' | 'confirm' | 'cancel' | 'today' | 'day' | 'week' | 'month' | 'year' | 'newEvent' | 'newAllDayEvent' | 'newCalendarEvent' | 'newAllDayCalendarEvent' | 'save' | 'deleteCalendar' | 'deleteCalendarMessage' | 'merge' | 'confirmDeleteTitle' | 'confirmDeleteMessage' | 'mergeConfirmTitle' | 'mergeConfirmMessage' | 'expandSidebar' | 'collapseSidebar' | 'calendars' | 'createCalendar' | 'calendarNamePlaceholder' | 'customColor' | 'create' | 'calendarOptions' | 'untitled' | 'search' | 'noResults' | 'calendar' | 'starts' | 'ends' | 'notes' | 'titlePlaceholder' | 'notesPlaceholder' | 'editEvent' | 'viewEvent' | 'done' | 'quickCreateEvent' | 'quickCreatePlaceholder' | 'noSuggestions' | 'newCalendar' | 'refreshAll' | 'tomorrow' | 'importCalendar' | 'exportCalendar' | 'addSchedule' | 'importCalendarMessage' | 'ok' | 'cut' | 'copy' | 'pasteHere' | 'eventSummary';
 type LocaleDict = Partial<Record<TranslationKey, string>>;
 type LocaleMessages = Partial<Record<TranslationKey, string>>;
 interface Locale {
@@ -206,6 +217,8 @@ interface MobileEventProps {
     onClose: () => void;
     /** Callback to save the event (creates or updates) */
     onSave: (event: Event) => void;
+    /** Callback to delete an existing event by id */
+    onEventDelete?: (id: string) => void;
     /** Current event data (newly created template or existing event) */
     draftEvent: Event | null;
     /** The ICalendarApp instance providing built-in services */
@@ -248,29 +261,47 @@ interface CalendarView {
     component: TComponent;
     config?: Record<string, unknown>;
 }
+type RangeChangeReason = 'initial' | 'navigation' | 'viewChange' | 'scroll';
+type EventChange = {
+    type: 'create';
+    event: Event;
+} | {
+    type: 'update';
+    before: Event;
+    after: Event;
+} | {
+    type: 'delete';
+    event: Event;
+};
 /**
  * Calendar callbacks interface
  * Defines calendar event callback functions
  */
 interface CalendarCallbacks {
+    onEventBatchChange?: (changes: EventChange[]) => void | Promise<void>;
     onViewChange?: (view: ViewType) => void | Promise<void>;
     onEventCreate?: (event: Event) => void | Promise<void>;
     onEventUpdate?: (event: Event) => void | Promise<void>;
     onEventDelete?: (eventId: string) => void | Promise<void>;
     onDateChange?: (date: Date) => void | Promise<void>;
     onRender?: () => void | Promise<void>;
+    /**
+     * @deprecated This method is retained for backward compatibility and will be removed in future releases. Use ``onVisibleRangeChange`` instead.
+     */
     onVisibleMonthChange?: (date: Date) => void | Promise<void>;
+    onVisibleRangeChange?: (start: Date, end: Date, reason: RangeChangeReason) => void | Promise<void>;
     onCalendarUpdate?: (calendar: CalendarType) => void | Promise<void>;
     onCalendarCreate?: (calendar: CalendarType) => void | Promise<void>;
     onCalendarDelete?: (calendarId: string) => void | Promise<void>;
     onCalendarMerge?: (sourceId: string, targetId: string) => void | Promise<void>;
     onEventClick?: (event: Event) => void | Promise<void>;
     onMoreEventsClick?: (date: Date) => void | Promise<void>;
+    onDismissUI?: () => void | Promise<void>;
 }
 interface CreateCalendarDialogProps {
     onClose: () => void;
     onCreate: (calendar: CalendarType) => void;
-    colorPickerMode?: 'blossom' | 'default';
+    colorPickerMode?: 'default' | 'custom';
 }
 interface CalendarHeaderProps {
     calendar: ICalendarApp;
@@ -285,38 +316,6 @@ interface CalendarHeaderProps {
     /** Left safe area padding (px) to avoid overlapping with traffic light buttons in macMode */
     safeAreaLeft?: number;
 }
-/**
- * Sidebar render props
- */
-interface CalendarSidebarRenderProps {
-    app: ICalendarApp;
-    calendars: CalendarType[];
-    toggleCalendarVisibility: (calendarId: string, visible: boolean) => void;
-    toggleAll: (visible: boolean) => void;
-    isCollapsed: boolean;
-    setCollapsed: (collapsed: boolean) => void;
-    renderCalendarContextMenu?: (calendar: CalendarType, onClose: () => void) => TNode;
-    createCalendarMode?: 'inline' | 'modal';
-    renderCreateCalendarDialog?: (props: CreateCalendarDialogProps) => TNode;
-    editingCalendarId?: string | null;
-    setEditingCalendarId?: (id: string | null) => void;
-    onCreateCalendar?: () => void;
-    colorPickerMode?: 'blossom' | 'default';
-}
-/**
- * Sidebar config
- */
-interface SidebarConfig {
-    enabled?: boolean;
-    width?: number | string;
-    initialCollapsed?: boolean;
-    render?: (props: CalendarSidebarRenderProps) => TNode;
-    renderCalendarContextMenu?: (calendar: CalendarType, onClose: () => void) => TNode;
-    createCalendarMode?: 'inline' | 'modal';
-    renderCreateCalendarDialog?: (props: CreateCalendarDialogProps) => TNode;
-    /** Color picker mode: 'blossom' for BlossomColorPicker, 'default' for react-color */
-    colorPickerMode?: 'blossom' | 'default';
-}
 /**
  * Calendar application configuration
  * Used to initialize CalendarApp
@@ -332,7 +331,6 @@ interface CalendarAppConfig {
     calendars?: CalendarType[];
     defaultCalendar?: string;
     theme?: ThemeConfig;
-    useSidebar?: boolean | SidebarConfig;
     useEventDetailDialog?: boolean;
     useCalendarHeader?: boolean | ((props: CalendarHeaderProps) => TNode);
     customMobileEventRenderer?: MobileEventRenderer;
@@ -357,9 +355,9 @@ interface CalendarAppState {
     plugins: Map<string, CalendarPlugin>;
     views: Map<ViewType, CalendarView>;
     switcherMode?: ViewSwitcherMode;
-    sidebar?: SidebarConfig;
     locale: string | Locale;
     highlightedEventId?: string | null;
+    selectedEventId?: string | null;
     readOnly: boolean | ReadOnlyConfig;
 }
 /**
@@ -396,6 +394,7 @@ interface ICalendarApp {
     onEventClick: (event: Event) => void;
     onMoreEventsClick: (date: Date) => void;
     highlightEvent: (eventId: string | null) => void;
+    selectEvent: (eventId: string | null) => void;
     getCalendars: () => CalendarType[];
     reorderCalendars: (fromIndex: number, toIndex: number) => void;
     setCalendarVisibility: (calendarId: string, visible: boolean) => void;
@@ -406,9 +405,10 @@ interface ICalendarApp {
     mergeCalendars: (sourceId: string, targetId: string) => void;
     setVisibleMonth: (date: Date) => void;
     getVisibleMonth: () => Date;
+    emitVisibleRange: (start: Date, end: Date, reason?: RangeChangeReason) => void;
+    dismissUI: () => void;
     getPlugin: <T = unknown>(name: string) => T | undefined;
     hasPlugin: (name: string) => boolean;
-    getSidebarConfig: () => SidebarConfig;
     getCalendarHeaderConfig: () => boolean | ((props: CalendarHeaderProps) => TNode);
     triggerRender: () => void;
     getCalendarRegistry: () => CalendarRegistry;
@@ -456,7 +456,7 @@ interface UseCalendarAppReturn {
     highlightEvent: (eventId: string | null) => void;
     setVisibleMonth: (date: Date) => void;
     getVisibleMonth: () => Date;
-    sidebarConfig: SidebarConfig;
+    emitVisibleRange: (start: Date, end: Date, reason?: RangeChangeReason) => void;
     readOnlyConfig: ReadOnlyConfig;
 }
 /**
@@ -909,6 +909,7 @@ interface UseVirtualMonthScrollReturn {
     currentMonth: string;
     currentYear: number;
     isScrolling: boolean;
+    isNavigating: boolean;
     virtualData: {
         totalHeight: number;
         visibleItems: VirtualWeekItem[];
@@ -1282,7 +1283,7 @@ declare class CalendarApp implements ICalendarApp {
     state: CalendarAppState;
     private callbacks;
     private calendarRegistry;
-    private sidebarConfig;
+    private store;
     private visibleMonth;
     private useEventDetailDialog;
     private useCalendarHeader;
@@ -1293,6 +1294,7 @@ declare class CalendarApp implements ICalendarApp {
     private pendingSnapshot;
     private readonly MAX_UNDO_STACK;
     constructor(config: CalendarAppConfig);
+    private setupStoreListeners;
     private resolveLocale;
     subscribe: (listener: (app: ICalendarApp) => void) => (() => void);
     private notify;
@@ -1306,6 +1308,8 @@ declare class CalendarApp implements ICalendarApp {
     private isInternalEditable;
     changeView: (view: ViewType) => void;
     getCurrentView: () => CalendarView;
+    emitVisibleRange: (start: Date, end: Date, reason?: RangeChangeReason) => void;
+    handleVisibleRangeChange: (reason: RangeChangeReason) => void;
     setCurrentDate: (date: Date) => void;
     getCurrentDate: () => Date;
     setVisibleMonth: (date: Date) => void;
@@ -1329,6 +1333,8 @@ declare class CalendarApp implements ICalendarApp {
     onEventClick: (event: Event) => void;
     onMoreEventsClick: (date: Date) => void;
     highlightEvent: (eventId: string | null) => void;
+    selectEvent: (eventId: string | null) => void;
+    dismissUI: () => void;
     getEvents: () => Event[];
     getCalendars: () => CalendarType[];
     reorderCalendars: (fromIndex: number, toIndex: number) => void;
@@ -1338,7 +1344,6 @@ declare class CalendarApp implements ICalendarApp {
     createCalendar: (calendar: CalendarType) => void;
     deleteCalendar: (id: string) => void;
     mergeCalendars: (sourceId: string, targetId: string) => void;
-    getSidebarConfig: () => SidebarConfig;
     getCalendarHeaderConfig: () => boolean | ((props: any) => TNode);
     private installPlugin;
     getPlugin: <T = unknown>(name: string) => T | undefined;
@@ -1385,6 +1390,7 @@ declare class CustomRenderingStore {
     private renderings;
     private overrides;
     private listeners;
+    constructor(initialOverrides?: string[]);
     /**
      * Register a new custom rendering placeholder.
      * Called by the ContentSlot Preact component.
@@ -1417,7 +1423,9 @@ declare class CalendarRenderer {
     private customRenderingStore;
     private unsubscribe;
     private renderRequested;
-    constructor(app: ICalendarApp);
+    private extraProps;
+    constructor(app: ICalendarApp, initialOverrides?: string[]);
+    setProps(props: Record<string, any>): void;
     private requestRender;
     /**
      * Mount the calendar to a DOM container.
@@ -1869,7 +1877,7 @@ declare function dateToPlainDateTime(date: Date): Temporal.PlainDateTime;
 /**
  * Convert Date to ZonedDateTime (for timezone-aware events)
  */
-declare function dateToZonedDateTime(date: Date, timeZone: string): Temporal.ZonedDateTime;
+declare function dateToZonedDateTime(date: Date, timeZone?: string): Temporal.ZonedDateTime;
 /**
  * Convert PlainDateTime to Date
  */
@@ -2277,6 +2285,15 @@ declare const groupSearchResults: (results: CalendarSearchEvent[], today: Date)
     events: CalendarSearchEvent[];
 }>;
 
+declare class ClipboardStore {
+    private lastCopiedEvent;
+    setEvent(event: Event): void;
+    getEvent(): Event | null;
+    hasEvent(): boolean;
+    clear(): void;
+}
+declare const clipboardStore: ClipboardStore;
+
 /**
  * ICS (iCalendar) Types
  *
@@ -2486,28 +2503,19 @@ declare const getMonthLabels: (locale: string, format?: "long" | "short" | "narr
 
 declare const en: Locale;
 
-declare const zh: Locale;
-
-declare const ja: Locale;
-
-declare const ko: Locale;
-
-declare const fr: Locale;
-
-declare const de: Locale;
-
-declare const es: Locale;
-
-declare const LOCALES: {
-    en: Locale;
-    zh: Locale;
-    ja: Locale;
-    ko: Locale;
-    fr: Locale;
-    de: Locale;
-    es: Locale;
-};
-type SupportedLang = keyof typeof LOCALES;
+/**
+ * Global locale registry for the core library.
+ * Default includes English.
+ */
+declare const LOCALES: Record<string, Locale>;
+type SupportedLang = string;
+/**
+ * Registers a new locale in the global registry.
+ * This allows plugins to provide additional translations.
+ *
+ * @param locale The locale object to register
+ */
+declare function registerLocale(locale: Locale): void;
 
 /**
  * Normalizes a locale string to a supported language code.
@@ -2533,6 +2541,13 @@ declare const LocaleContext: preact.Context<LocaleContextValue>;
  */
 declare function useLocale(): LocaleContextValue;
 
+interface LocaleProviderProps {
+    locale?: LocaleCode | Locale;
+    messages?: LocaleMessages;
+    children?: any;
+}
+declare const LocaleProvider: ({ locale, messages, children, }: LocaleProviderProps) => preact.JSX.Element;
+
 declare const createDayView: ViewFactory<DayViewConfig>;
 
 declare const createWeekView: ViewFactory<WeekViewConfig>;
@@ -2547,9 +2562,127 @@ declare function createStandardViews(config?: {
     month?: Partial<MonthViewConfig>;
 }): CalendarView[];
 
-declare function createDragPlugin(config?: Partial<DragPluginConfig>): CalendarPlugin;
-
 declare function createEventsPlugin(config?: EventsPluginConfig): CalendarPlugin;
 
-export { CalendarApp, CalendarRegistry, CalendarRenderer, CustomRenderingStore, LAYOUT_CONFIG, LOCALES, LocaleContext, TIME_STEP, VIRTUAL_MONTH_SCROLL_CONFIG, ViewType, WeekDataCache, addDays, buildParseRegExp, calculateDayIndex, capitalize, conditionalTheme, convertDateEvent, convertDateEventWithTimeZone, createAllDayEvent, createDateWithHour, createDayView, createDragPlugin, createEvent, createEventWithDate, createEventWithRealDate, createEvents, createEventsPlugin, createMonthView, createStandardViews, createTemporalWithHour, createTimedEvent, createTimezoneEvent, createTimezoneEvents, createWeekView, createYearView, dateToPlainDate, dateToPlainDateTime, dateToZonedDateTime, daysBetween, daysDifference, de, downloadICS, en, es, extractHourFromDate, extractHourFromTemporal, formatDate, formatDateConsistent, formatDateToICSTimestamp, formatEventTimeRange, formatICSDate, formatMonthYear, formatTemporal, formatTime, fr, generateDayData, generateICS, generateUniKey, generateWeekData, generateWeekRange, generateWeeksData, getAllDayEventsForDay, getCurrentWeekDates, getDateByDayIndex, getDateObj, getDayIndexByDate, getEndOfDay, getEndOfTemporal, getEventBgColor, getEventEndHour, getEventTextColor, getEventsForDay, getEventsForWeek, getIntlLabel, getLineColor, getMonthLabels, getMonthYearOfWeek, getPlainDate, getSearchHeaderInfo, getSelectedBgColor, getStartOfDay, getStartOfTemporal, getTestEvents, getWeekDaysLabels, getWeekRange, getZoneId, groupSearchResults, importICSFile, isDate, isDeepEqual, isEventEqual, isEventInWeek, isMultiDayEvent, isMultiDayTemporalEvent, isPlainDate, isPlainDateTime, isSameDay, isSamePlainDate, isSameTemporal, isValidLocale, isZonedDateTime, ja, ko, mergeClasses, mergeFormatTemplate, monthNames, normalizeCssWidth, normalizeDate, normalizeLocale, normalizeToZoned, now, pad, parseICS, parseICSDate, parseTemporalString, plainDateTimeToDate, plainDateToDate, recalculateEventDays, resolveAppliedTheme, roundToTimeStep, scrollbarTakesSpace, setHourInTemporal, shortMonthNames, t, temporalToDate, themeClasses, themeCn, today, updateEventDateAndDay, updateEventWithRealDate, useLocale, weekDays, weekDaysFullName, zh, zonedDateTimeToDate };
-export type { BalanceStrategy, BaseViewProps, CalendarAppConfig, CalendarAppState, CalendarCallbacks, CalendarColors, CalendarConfig, CalendarHeaderProps, CalendarPlugin, CalendarSidebarRenderProps, CalendarType, CalendarView, CalendarsConfig, CreateCalendarDialogProps, CreateEventParams, CreateTimezoneEventParams, CustomRendering, DayData, DayViewConfig, DayViewProps, DragConfig, DragHookOptions, DragHookReturn, DragIndicatorProps, DragIndicatorRenderer, DragIntegrationProps, DragPluginConfig, DragRef, DragService, Event, EventDetailContentProps, EventDetailContentRenderer, EventDetailDialogProps, EventDetailDialogRenderer, EventDetailPanelProps, EventDetailPanelRenderer, EventDetailPosition, EventGroup, EventLayout, EventRelations, EventsPluginConfig, EventsService, ICSDateParams, ICSExportOptions, ICSImportOptions, ICSImportResult, ICSParseError, ICSVEvent, ICalendarApp, Locale, LocaleCode, LocaleContextValue, LocaleDict, LocaleMessages, MobileEventProps, MobileEventRenderer, Mode, MonthDragState, MonthEventDragState, MonthViewConfig, MonthViewProps, NestedLayer, ReadOnlyConfig, SidebarConfig, SpecialLayoutRule, SubtreeAnalysis, SupportedLang, TComponent, TNode, ThemeColors, ThemeConfig, ThemeMode, TransferOperation, TranslationKey, UnifiedDragRef, UseCalendarAppReturn, UseCalendarReturn, UseDragCommonReturn, UseDragHandlersParams, UseDragHandlersReturn, UseDragManagerReturn, UseDragStateReturn, UseMonthDragParams, UseMonthDragReturn, UseVirtualMonthScrollProps, UseVirtualMonthScrollReturn, UseVirtualScrollProps, UseVirtualScrollReturn, UseWeekDayDragParams, UseWeekDayDragReturn, ViewAdapterProps, ViewFactory, ViewFactoryConfig, VirtualItem, VirtualScrollIntegrationProps, VirtualWeekItem, WeekDayDragState, WeekViewConfig, WeekViewProps, WeeksData, YearViewConfig, YearViewProps, useDragProps, useDragReturn };
+type DragForViewFn = (app: ICalendarApp, options: DragHookOptions) => DragHookReturn;
+declare function registerDragImplementation(fn: DragForViewFn): void;
+declare function useDragForView(app: ICalendarApp, options: DragHookOptions): DragHookReturn;
+
+interface SidebarBridgeReturn {
+    enabled: boolean;
+    width: string;
+    isCollapsed: boolean;
+    toggleCollapsed: () => void;
+    miniWidth: string;
+    content: TNode | null;
+    extraContent: TNode | null;
+    safeAreaLeft: number;
+}
+type SidebarBridgeFn = (app: ICalendarApp) => SidebarBridgeReturn;
+declare function registerSidebarImplementation(fn: SidebarBridgeFn): void;
+declare function useSidebarBridge(app: ICalendarApp): SidebarBridgeReturn;
+
+interface ContextMenuProps {
+    x: number;
+    y: number;
+    onClose: () => void;
+    children: any;
+    className?: string;
+}
+declare const ContextMenu: preact.FunctionalComponent<preact_compat.PropsWithoutRef<ContextMenuProps> & {
+    ref?: preact.Ref<HTMLDivElement> | undefined;
+}>;
+declare const ContextMenuItem: ({ onClick, children, icon, danger, disabled, }: {
+    onClick: () => void;
+    children: any;
+    icon?: any;
+    danger?: boolean;
+    disabled?: boolean;
+}) => h.JSX.Element;
+declare const ContextMenuSeparator: () => h.JSX.Element;
+declare const ContextMenuLabel: any;
+declare const ContextMenuColorPicker: ({ selectedColor, onSelect, onCustomColor, }: {
+    selectedColor?: string;
+    onSelect: (color: string) => void;
+    onCustomColor?: () => void;
+}) => h.JSX.Element;
+
+interface BlossomColorPickerProps extends Partial<BlossomColorPickerOptions> {
+    className?: string;
+}
+declare const BlossomColorPicker: (props: BlossomColorPickerProps) => preact.JSX.Element;
+
+interface DefaultColorPickerProps {
+    color: string;
+    onChange: (color: {
+        hex: string;
+    }, isPending?: boolean) => void;
+    onClose?: () => void;
+    [key: string]: any;
+}
+declare const DefaultColorPicker: ({ color, onChange, onClose, }: DefaultColorPickerProps) => preact.JSX.Element;
+
+interface MiniCalendarProps {
+    visibleMonth: Date;
+    currentDate: Date;
+    showHeader?: boolean;
+    onMonthChange: (offset: number) => void;
+    onDateSelect: (date: Date) => void;
+    locale?: string;
+}
+declare const MiniCalendar: ({ visibleMonth, currentDate, showHeader, onMonthChange, onDateSelect, }: MiniCalendarProps) => preact.JSX.Element;
+
+declare const CreateCalendarDialog: ({ onClose, onCreate, colorPickerMode, }: CreateCalendarDialogProps) => preact.VNode<any> | null;
+
+interface ContentSlotProps {
+    generatorName: string;
+    generatorArgs?: any;
+    defaultContent?: any;
+    store?: any;
+}
+/**
+ * Preact component: Creates a placeholder <div> and registers it with CustomRenderingStore.
+ * If a framework adapter (React/Vue) is present, it will portal its content into this <div>.
+ * Otherwise, it displays defaultContent.
+ */
+declare function ContentSlot({ generatorName, generatorArgs, defaultContent, store: propStore, }: ContentSlotProps): preact.JSX.Element;
+
+interface IconProps {
+    className?: string;
+    width?: number;
+    height?: number;
+}
+declare const ChevronRight: ({ className, width, height, }: IconProps) => preact.JSX.Element;
+declare const Plus: ({ className, width, height }: IconProps) => preact.JSX.Element;
+declare const Check: ({ className, width, height }: IconProps) => preact.JSX.Element;
+declare const ChevronsUpDown: ({ className, width, height, }: IconProps) => preact.JSX.Element;
+declare const PanelRightClose: ({ className, width, height, }: IconProps) => preact.JSX.Element;
+declare const PanelRightOpen: ({ className, width, height, }: IconProps) => preact.JSX.Element;
+
+/**
+ * Cancel button
+ */
+declare const cancelButton = "rounded-md bg-background border border-border px-3 py-2 text-xs font-medium text-gray-700 dark:text-gray-300 hover:bg-(--hover)";
+/**
+ * Calendar picker dropdown (for selecting calendar for an event)
+ */
+declare const calendarPickerDropdown = "bg-white dark:bg-gray-800 rounded-md shadow-lg border border-gray-200 dark:border-gray-700 overflow-hidden transition-all duration-200 origin-top-right animate-in fade-in zoom-in-95";
+/**
+ * Sidebar container
+ */
+declare const sidebarContainer = "df-sidebar flex h-full flex-col border-r border-gray-200 dark:border-gray-700 bg-white dark:bg-slate-900";
+/**
+ * Sidebar header
+ */
+declare const sidebarHeader = "df-sidebar-header flex items-center px-2 py-1";
+/**
+ * Sidebar header toggle button
+ */
+declare const sidebarHeaderToggle = "df-sidebar-header-toggle flex h-8 w-8 items-center justify-center rounded hover:bg-gray-100 dark:hover:bg-slate-800";
+/**
+ * Sidebar header title
+ */
+declare const sidebarHeaderTitle = "df-sidebar-header-title text-sm font-semibold text-gray-700 dark:text-gray-200";
+
+export { BlossomColorPicker, CalendarApp, CalendarRegistry, CalendarRenderer, Check, ChevronRight, ChevronsUpDown, ContentSlot, ContextMenu, ContextMenuColorPicker, ContextMenuItem, ContextMenuLabel, ContextMenuSeparator, CreateCalendarDialog, CustomRenderingStore, DefaultColorPicker, LAYOUT_CONFIG, LOCALES, LocaleContext, LocaleProvider, MiniCalendar, PanelRightClose, PanelRightOpen, Plus, TIME_STEP, VIRTUAL_MONTH_SCROLL_CONFIG, ViewType, WeekDataCache, addDays, buildParseRegExp, calculateDayIndex, calendarPickerDropdown, cancelButton, capitalize, clipboardStore, conditionalTheme, convertDateEvent, convertDateEventWithTimeZone, createAllDayEvent, createDateWithHour, createDayView, createEvent, createEventWithDate, createEventWithRealDate, createEvents, createEventsPlugin, createMonthView, createStandardViews, createTemporalWithHour, createTimedEvent, createTimezoneEvent, createTimezoneEvents, createWeekView, createYearView, dateToPlainDate, dateToPlainDateTime, dateToZonedDateTime, daysBetween, daysDifference, downloadICS, en, extractHourFromDate, extractHourFromTemporal, formatDate, formatDateConsistent, formatDateToICSTimestamp, formatEventTimeRange, formatICSDate, formatMonthYear, formatTemporal, formatTime, generateDayData, generateICS, generateUniKey, generateWeekData, generateWeekRange, generateWeeksData, getAllDayEventsForDay, getCalendarColorsForHex, getCurrentWeekDates, getDateByDayIndex, getDateObj, getDayIndexByDate, getEndOfDay, getEndOfTemporal, getEventBgColor, getEventEndHour, getEventTextColor, getEventsForDay, getEventsForWeek, getIntlLabel, getLineColor, getMonthLabels, getMonthYearOfWeek, getPlainDate, getSearchHeaderInfo, getSelectedBgColor, getStartOfDay, getStartOfTemporal, getTestEvents, getWeekDaysLabels, getWeekRange, getZoneId, groupSearchResults, importICSFile, isDate, isDeepEqual, isEventEqual, isEventInWeek, isMultiDayEvent, isMultiDayTemporalEvent, isPlainDate, isPlainDateTime, isSameDay, isSamePlainDate, isSameTemporal, isValidLocale, isZonedDateTime, mergeClasses, mergeFormatTemplate, monthNames, normalizeCssWidth, normalizeDate, normalizeLocale, normalizeToZoned, now, pad, parseICS, parseICSDate, parseTemporalString, plainDateTimeToDate, plainDateToDate, recalculateEventDays, registerDragImplementation, registerLocale, registerSidebarImplementation, resolveAppliedTheme, roundToTimeStep, scrollbarTakesSpace, setHourInTemporal, shortMonthNames, sidebarContainer, sidebarHeader, sidebarHeaderTitle, sidebarHeaderToggle, t, temporalToDate, themeClasses, themeCn, today, updateEventDateAndDay, updateEventWithRealDate, useDragForView, useLocale, useSidebarBridge, weekDays, weekDaysFullName, zonedDateTimeToDate };
+export type { BalanceStrategy, BaseViewProps, CalendarAppConfig, CalendarAppState, CalendarCallbacks, CalendarColors, CalendarConfig, CalendarHeaderProps, CalendarPlugin, CalendarType, CalendarView, CalendarsConfig, CreateCalendarDialogProps, CreateEventParams, CreateTimezoneEventParams, CustomRendering, DayData, DayViewConfig, DayViewProps, DragConfig, DragHookOptions, DragHookReturn, DragIndicatorProps, DragIndicatorRenderer, DragIntegrationProps, DragPluginConfig, DragRef, DragService, Event, EventChange, EventDetailContentProps, EventDetailContentRenderer, EventDetailDialogProps, EventDetailDialogRenderer, EventDetailPanelProps, EventDetailPanelRenderer, EventDetailPosition, EventGroup, EventLayout, EventRelations, EventsPluginConfig, EventsService, ICSDateParams, ICSExportOptions, ICSImportOptions, ICSImportResult, ICSParseError, ICSVEvent, ICalendarApp, Locale, LocaleCode, LocaleContextValue, LocaleDict, LocaleMessages, LocaleProviderProps, MobileEventProps, MobileEventRenderer, Mode, MonthDragState, MonthEventDragState, MonthViewConfig, MonthViewProps, NestedLayer, RangeChangeReason, ReadOnlyConfig, SidebarBridgeReturn, SpecialLayoutRule, SubtreeAnalysis, SupportedLang, TComponent, TNode, ThemeColors, ThemeConfig, ThemeMode, TransferOperation, TranslationKey, UnifiedDragRef, UseCalendarAppReturn, UseCalendarReturn, UseDragCommonReturn, UseDragHandlersParams, UseDragHandlersReturn, UseDragManagerReturn, UseDragStateReturn, UseMonthDragParams, UseMonthDragReturn, UseVirtualMonthScrollProps, UseVirtualMonthScrollReturn, UseVirtualScrollProps, UseVirtualScrollReturn, UseWeekDayDragParams, UseWeekDayDragReturn, ViewAdapterProps, ViewFactory, ViewFactoryConfig, VirtualItem, VirtualScrollIntegrationProps, VirtualWeekItem, WeekDayDragState, WeekViewConfig, WeekViewProps, WeeksData, YearViewConfig, YearViewProps, useDragProps, useDragReturn };