@dayflow/core 3.3.3 → 3.3.5

package/dist/index.d.ts

@@ -45,6 +45,12 @@ interface CalendarType {
     subscribed?: boolean;
     /** The source of this calendar (e.g., 'Google Calendar', 'iCloud', 'Outlook') */
     source?: string;
+    /** Subscription status and metadata */
+    subscription?: {
+        url: string;
+        status: 'loading' | 'ready' | 'error';
+        meta?: Record<string, unknown>;
+    };
 }
 /**
  * Theme mode
@@ -186,7 +192,7 @@ declare function getCalendarColorsForHex(hex: string): {
 };
 
 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' | 'viewEvent' | 'done' | 'quickCreateEvent' | 'quickCreatePlaceholder' | 'noSuggestions' | 'newCalendar' | 'refreshAll' | 'tomorrow' | 'importCalendar' | 'exportCalendar' | 'addSchedule' | 'importCalendarMessage' | 'ok' | 'cut' | 'copy' | 'pasteHere' | 'eventSummary' | 'subscribeCalendar' | 'subscribeCalendarTitle' | 'calendarUrl' | 'calendarUrlPlaceholder' | 'subscribe' | 'fetchingCalendar' | 'subscribeError';
+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' | 'subscribeCalendar' | 'subscribeCalendarTitle' | 'calendarUrl' | 'calendarUrlPlaceholder' | 'subscribe' | 'fetchingCalendar' | 'subscribeError' | 'calendarAlreadySubscribed';
 type LocaleDict = Partial<Record<TranslationKey, string>>;
 type LocaleMessages = Partial<Record<TranslationKey, string>>;
 interface Locale {
@@ -339,8 +345,10 @@ declare enum ViewType {
     DAY = "day",
     WEEK = "week",
     MONTH = "month",
-    YEAR = "year"
+    YEAR = "year",
+    RESOURCE = "resource"
 }
+type CalendarViewType = ViewType | string;
 /**
  * Plugin interface
  * Defines the basic structure of calendar plugins
@@ -356,7 +364,8 @@ interface CalendarPlugin {
  * Defines the basic structure of calendar views
  */
 interface CalendarView {
-    type: ViewType;
+    type: CalendarViewType;
+    label?: string;
     component: TComponent;
     config?: Record<string, unknown>;
 }
@@ -378,7 +387,7 @@ type EventChange = {
  */
 interface CalendarCallbacks {
     onEventBatchChange?: (changes: EventChange[]) => void | Promise<void>;
-    onViewChange?: (view: ViewType) => void | Promise<void>;
+    onViewChange?: (view: CalendarViewType) => void | Promise<void>;
     onEventCreate?: (event: Event) => void | Promise<void>;
     onEventUpdate?: (event: Event) => void | Promise<void>;
     onEventDelete?: (eventId: string) => void | Promise<void>;
@@ -434,7 +443,7 @@ interface CalendarAppConfig {
     plugins?: CalendarPlugin[];
     events?: Event[];
     callbacks?: CalendarCallbacks;
-    defaultView?: ViewType;
+    defaultView?: CalendarViewType;
     initialDate?: Date;
     switcherMode?: ViewSwitcherMode;
     calendars?: CalendarType[];
@@ -460,11 +469,11 @@ interface ReadOnlyConfig {
  * Internal state of CalendarApp
  */
 interface CalendarAppState {
-    currentView: ViewType;
+    currentView: CalendarViewType;
     currentDate: Date;
     events: Event[];
     plugins: Map<string, CalendarPlugin>;
-    views: Map<ViewType, CalendarView>;
+    views: Map<CalendarViewType, CalendarView>;
     switcherMode?: ViewSwitcherMode;
     locale: string | Locale;
     highlightedEventId?: string | null;
@@ -480,10 +489,11 @@ interface CalendarAppState {
 interface ICalendarApp {
     state: CalendarAppState;
     getReadOnlyConfig: () => ReadOnlyConfig;
+    canMutateFromUI: () => boolean;
     subscribe: (listener: (app: ICalendarApp) => void) => () => void;
-    changeView: (view: ViewType) => void;
+    changeView: (view: CalendarViewType) => void;
     getCurrentView: () => CalendarView;
-    getViewConfig: (viewType: ViewType) => Record<string, unknown>;
+    getViewConfig: (viewType: CalendarViewType) => Record<string, unknown>;
     setCurrentDate: (date: Date) => void;
     getCurrentDate: () => Date;
     goToToday: () => void;
@@ -500,8 +510,10 @@ interface ICalendarApp {
         delete?: string[];
     }, isPending?: boolean, source?: 'drag' | 'resize') => void;
     addEvent: (event: Event) => void;
-    updateEvent: (id: string, event: Partial<Event>, isPending?: boolean, source?: 'drag' | 'resize') => void;
-    deleteEvent: (id: string) => void;
+    /** Add events from external sources (like subscriptions) without persisting to main DB */
+    addExternalEvents: (calendarId: string, events: Event[]) => void;
+    updateEvent: (id: string, event: Partial<Event>, isPending?: boolean, source?: 'drag' | 'resize') => Promise<void>;
+    deleteEvent: (id: string) => Promise<void>;
     getEvents: () => Event[];
     getAllEvents: () => Event[];
     onEventClick: (event: Event) => void;
@@ -513,9 +525,9 @@ interface ICalendarApp {
     setCalendarVisibility: (calendarId: string, visible: boolean) => void;
     setAllCalendarsVisibility: (visible: boolean) => void;
     updateCalendar: (id: string, updates: Partial<CalendarType>, isPending?: boolean) => void;
-    createCalendar: (calendar: CalendarType) => void;
-    deleteCalendar: (id: string) => void;
-    mergeCalendars: (sourceId: string, targetId: string) => void;
+    createCalendar: (calendar: CalendarType) => Promise<void>;
+    deleteCalendar: (id: string) => Promise<void>;
+    mergeCalendars: (sourceId: string, targetId: string) => Promise<void>;
     setVisibleMonth: (date: Date) => void;
     getVisibleMonth: () => Date;
     emitVisibleRange: (start: Date, end: Date, reason?: RangeChangeReason) => void;
@@ -540,7 +552,7 @@ interface ICalendarApp {
  */
 interface UseCalendarAppReturn {
     app: ICalendarApp;
-    currentView: ViewType;
+    currentView: CalendarViewType;
     currentDate: Date;
     events: Event[];
     applyEventsChanges: (changes: {
@@ -551,19 +563,19 @@ interface UseCalendarAppReturn {
         }>;
         delete?: string[];
     }, isPending?: boolean, source?: 'drag' | 'resize') => void;
-    changeView: (view: ViewType) => void;
+    changeView: (view: CalendarViewType) => void;
     setCurrentDate: (date: Date) => void;
     addEvent: (event: Event) => void;
-    updateEvent: (id: string, event: Partial<Event>, isPending?: boolean, source?: 'drag' | 'resize') => void;
-    deleteEvent: (id: string) => void;
+    updateEvent: (id: string, event: Partial<Event>, isPending?: boolean, source?: 'drag' | 'resize') => Promise<void>;
+    deleteEvent: (id: string) => Promise<void>;
     goToToday: () => void;
     goToPrevious: () => void;
     goToNext: () => void;
     selectDate: (date: Date) => void;
     undo: () => void;
     getCalendars: () => CalendarType[];
-    createCalendar: (calendar: CalendarType) => void;
-    mergeCalendars: (sourceId: string, targetId: string) => void;
+    createCalendar: (calendar: CalendarType) => Promise<void>;
+    mergeCalendars: (sourceId: string, targetId: string) => Promise<void>;
     setCalendarVisibility: (calendarId: string, visible: boolean) => void;
     setAllCalendarsVisibility: (visible: boolean) => void;
     getAllEvents: () => Event[];
@@ -571,6 +583,7 @@ interface UseCalendarAppReturn {
     setVisibleMonth: (date: Date) => void;
     getVisibleMonth: () => Date;
     emitVisibleRange: (start: Date, end: Date, reason?: RangeChangeReason) => void;
+    canMutateFromUI: () => boolean;
     readOnlyConfig: ReadOnlyConfig;
 }
 /**
@@ -599,17 +612,17 @@ interface CalendarConfig {
     };
 }
 interface UseCalendarReturn {
-    view: ViewType;
+    view: CalendarViewType;
     currentDate: Date;
     events: Event[];
     currentWeekStart: Date;
-    changeView: (view: ViewType) => void;
+    changeView: (view: CalendarViewType) => void;
     goToToday: () => void;
     goToPrevious: () => void;
     goToNext: () => void;
     selectDate: (date: Date) => void;
-    updateEvent: (eventId: string, updates: Partial<Event>, isPending?: boolean) => void;
-    deleteEvent: (eventId: string) => void;
+    updateEvent: (eventId: string, updates: Partial<Event>, isPending?: boolean) => Promise<void>;
+    deleteEvent: (eventId: string) => Promise<void>;
     addEvent: (event: Omit<Event, 'id'>) => void;
     setEvents: (events: Event[] | ((prev: Event[]) => Event[])) => void;
 }
@@ -952,9 +965,9 @@ interface EventDetailPanelProps {
     /** Selected event element reference */
     selectedEventElementRef: RefObject<HTMLElement | null>;
     /** Event update callback */
-    onEventUpdate: (updatedEvent: Event) => void;
+    onEventUpdate: (updatedEvent: Event) => void | Promise<void>;
     /** Event delete callback */
-    onEventDelete: (eventId: string) => void;
+    onEventDelete: (eventId: string) => void | Promise<void>;
     /** Close panel callback (optional) */
     onClose?: () => void;
 }
@@ -971,9 +984,9 @@ interface EventDetailContentProps {
     /** Whether the event is all-day */
     isAllDay: boolean;
     /** Event update callback */
-    onEventUpdate: (updatedEvent: Event) => void;
+    onEventUpdate: (updatedEvent: Event) => void | Promise<void>;
     /** Event delete callback */
-    onEventDelete: (eventId: string) => void;
+    onEventDelete: (eventId: string) => void | Promise<void>;
     /** Close panel callback (optional) */
     onClose?: () => void;
     app?: ICalendarApp;
@@ -993,9 +1006,9 @@ interface EventDetailDialogProps {
     /** Whether the event is all-day */
     isAllDay: boolean;
     /** Event update callback */
-    onEventUpdate: (updatedEvent: Event) => void;
+    onEventUpdate: (updatedEvent: Event) => void | Promise<void>;
     /** Event delete callback */
-    onEventDelete: (eventId: string) => void;
+    onEventDelete: (eventId: string) => void | Promise<void>;
     /** Close dialog callback */
     onClose: () => void;
     app?: ICalendarApp;
@@ -1145,13 +1158,13 @@ type TimeZoneValue = TimeZone | string;
 interface BaseViewProps<TConfig = unknown> {
     app: ICalendarApp;
     currentDate?: Date;
-    currentView?: ViewType;
+    currentView?: CalendarViewType;
     events?: Event[];
-    onEventUpdate?: (event: Event) => void;
-    onEventDelete?: (eventId: string) => void;
+    onEventUpdate?: (event: Event) => void | Promise<void>;
+    onEventDelete?: (eventId: string) => void | Promise<void>;
     onEventCreate?: (event: Event) => void;
     onDateChange?: (date: Date) => void;
-    onViewChange?: (view: ViewType) => void;
+    onViewChange?: (view: CalendarViewType) => void;
     config: TConfig;
     selectedEventId?: string | null;
     onEventSelect?: (eventId: string | null) => void;
@@ -1272,7 +1285,7 @@ interface YearViewConfig extends ViewFactoryConfig {
  * Adapter properties for wrapping original components
  */
 interface ViewAdapterProps extends BaseViewProps {
-    viewType: ViewType;
+    viewType: CalendarViewType;
     originalComponent: AnyComponent<any, any>;
     config: ViewFactoryConfig;
     className?: string;
@@ -1359,7 +1372,7 @@ interface ColorPickerProps {
 }
 interface CreateCalendarDialogProps {
     onClose: () => void;
-    onCreate: (calendar: CalendarType) => void;
+    onCreate: (calendar: CalendarType) => void | Promise<void>;
     app: ICalendarApp;
 }
 /**
@@ -1370,8 +1383,8 @@ interface EventsService {
     getAll: () => Event[];
     getById: (id: string) => Event | undefined;
     add: (event: Event) => void;
-    update: (id: string, updates: Partial<Event>) => Event;
-    delete: (id: string) => void;
+    update: (id: string, updates: Partial<Event>) => void | Promise<void>;
+    delete: (id: string) => void | Promise<void>;
     getByDate: (date: Date) => Event[];
     getByDateRange: (startDate: Date, endDate: Date) => Event[];
     getByDay: (dayIndex: number, weekStart: Date) => Event[];
@@ -1522,6 +1535,7 @@ declare class CalendarApp implements ICalendarApp {
     private pendingSnapshot;
     private pendingChangeSource;
     private readonly MAX_UNDO_STACK;
+    private externalEvents;
     constructor(config: CalendarAppConfig);
     private setupStoreListeners;
     private static resolveLocale;
@@ -1530,12 +1544,8 @@ declare class CalendarApp implements ICalendarApp {
     private pushToUndo;
     undo: () => void;
     getReadOnlyConfig: () => ReadOnlyConfig;
-    /**
-     * Helper to check if the calendar is in any form of read-only mode.
-     * If readOnly config is present, it's considered non-editable.
-     */
-    private isInternalEditable;
-    changeView: (view: ViewType) => void;
+    canMutateFromUI: () => boolean;
+    changeView: (view: CalendarViewType) => void;
     getCurrentView: () => CalendarView;
     emitVisibleRange: (start: Date, end: Date, reason?: RangeChangeReason) => void;
     handleVisibleRangeChange: (reason: RangeChangeReason) => void;
@@ -1556,8 +1566,18 @@ declare class CalendarApp implements ICalendarApp {
         delete?: string[];
     }, isPending?: boolean, source?: "drag" | "resize") => void;
     addEvent: (event: Event) => void;
-    updateEvent: (id: string, eventUpdate: Partial<Event>, isPending?: boolean, source?: "drag" | "resize") => void;
-    deleteEvent: (id: string) => void;
+    /**
+     * Add external events to the state without persisting to the core store.
+     * This is used for temporary/subscription-based events.
+     */
+    addExternalEvents: (calendarId: string, events: Event[]) => void;
+    /**
+     * Synchronize all events (core + external) into the main state.events array.
+     * This ensures all views and plugins that listen to state.events see the combined list.
+     */
+    private syncExternalEventsToState;
+    updateEvent: (id: string, eventUpdate: Partial<Event>, isPending?: boolean, source?: "drag" | "resize") => Promise<void>;
+    deleteEvent: (id: string) => Promise<void>;
     getAllEvents: () => Event[];
     onEventClick: (event: Event) => void;
     onMoreEventsClick: (date: Date) => void;
@@ -1570,16 +1590,16 @@ declare class CalendarApp implements ICalendarApp {
     setCalendarVisibility: (calendarId: string, visible: boolean) => void;
     setAllCalendarsVisibility: (visible: boolean) => void;
     updateCalendar: (id: string, updates: Partial<CalendarType>, isPending?: boolean) => void;
-    createCalendar: (calendar: CalendarType) => void;
-    deleteCalendar: (id: string) => void;
-    mergeCalendars: (sourceId: string, targetId: string) => void;
+    createCalendar: (calendar: CalendarType) => Promise<void>;
+    deleteCalendar: (id: string) => Promise<void>;
+    mergeCalendars: (sourceId: string, targetId: string) => Promise<void>;
     getCalendarHeaderConfig: () => boolean | ((props: CalendarHeaderProps) => TNode);
     private installPlugin;
     getPlugin: <T = unknown>(name: string) => T | undefined;
     hasPlugin: (name: string) => boolean;
     getPluginConfig: (pluginName: string) => Record<string, unknown>;
     updatePluginConfig: (pluginName: string, config: Record<string, unknown>) => void;
-    getViewConfig: (viewType: ViewType) => Record<string, unknown>;
+    getViewConfig: (viewType: CalendarViewType) => Record<string, unknown>;
     triggerRender: () => void;
     getCalendarRegistry: () => CalendarRegistry;
     getUseEventDetailDialog: () => boolean;
@@ -2793,6 +2813,16 @@ interface RestoredTimedDragState {
 }
 declare const restoreTimedDragFromAllDayTransition: ({ wasOriginallyAllDay, mouseHour, hourOffset, duration, originalStartHour, originalEndHour, firstHour, lastHour, minDuration, roundToTimeStep, }: RestoreTimedDragOptions) => RestoredTimedDragState;
 
+interface SubscribeResult {
+    calendar: CalendarType;
+    events: Event[];
+}
+/**
+ * Utility to fetch and parse a calendar subscription.
+ * Does not perform any storage operations.
+ */
+declare function subscribeCalendar(url: string): Promise<SubscribeResult>;
+
 /**
  * Core translation function.
  * 1. Try Intl API for standard terms.
@@ -2927,6 +2957,39 @@ declare const ContextMenuColorPicker: ({ selectedColor, onSelect, onCustomColor,
     onCustomColor?: () => void;
 }) => preact.JSX.Element;
 
+interface GridContextMenuProps {
+    x: number;
+    y: number;
+    date: Date;
+    onClose: () => void;
+    app: ICalendarApp;
+    onCreateEvent: () => void;
+    viewType?: ViewType;
+}
+declare const GridContextMenu: ({ x, y, date, onClose, app, onCreateEvent, viewType, }: GridContextMenuProps) => preact.JSX.Element | null;
+
+interface EventContextMenuProps {
+    event: Event;
+    x: number;
+    y: number;
+    onClose: () => void;
+    app: ICalendarApp;
+    onDetailPanelToggle?: (id: string | null) => void;
+    detailPanelKey: string;
+}
+declare const EventContextMenu: ({ event, x, y, onClose, app, }: EventContextMenuProps) => preact.JSX.Element | null;
+
+interface ButtonProps extends Omit<JSX.HTMLAttributes<HTMLButtonElement>, 'onClick'> {
+    loading?: boolean;
+    loadingText?: string;
+    onClick?: (e: JSX.TargetedMouseEvent<HTMLButtonElement>) => void | Promise<void>;
+    children?: ComponentChildren;
+    disabled?: boolean;
+    type?: 'button' | 'submit' | 'reset';
+    className?: string;
+}
+declare const LoadingButton: ({ children, onClick, loading: propLoading, loadingText, disabled, className, type, ...props }: ButtonProps) => JSX.Element;
+
 interface BlossomColorPickerProps extends Partial<BlossomColorPickerOptions> {
     className?: string;
 }
@@ -2942,6 +3005,30 @@ interface DefaultColorPickerProps {
 }
 declare const DefaultColorPicker: ({ color, onChange, onClose, }: DefaultColorPickerProps) => preact.JSX.Element;
 
+type ZonedRange = [Temporal.ZonedDateTime, Temporal.ZonedDateTime];
+interface RangePickerProps {
+    value: [
+        Temporal.PlainDate | Temporal.PlainDateTime | Temporal.ZonedDateTime,
+        Temporal.PlainDate | Temporal.PlainDateTime | Temporal.ZonedDateTime
+    ];
+    format?: string;
+    showTimeFormat?: string;
+    showTime?: boolean | {
+        format?: string;
+    };
+    onChange?: (value: ZonedRange, dateString: [string, string]) => void;
+    onOk?: (value: ZonedRange, dateString: [string, string]) => void;
+    timeZone?: string;
+    disabled?: boolean;
+    placement?: 'bottomLeft' | 'bottomRight' | 'topLeft' | 'topRight';
+    autoAdjustOverflow?: boolean;
+    getPopupContainer?: () => HTMLElement;
+    matchTriggerWidth?: boolean;
+    locale?: string | Locale;
+}
+
+declare const RangePicker: ({ value, format, showTimeFormat, showTime, onChange, onOk, timeZone, disabled, placement, autoAdjustOverflow, getPopupContainer, matchTriggerWidth, locale, }: RangePickerProps) => JSX.Element;
+
 interface MiniCalendarProps {
     visibleMonth: Date;
     currentDate: Date;
@@ -2954,6 +3041,23 @@ declare const MiniCalendar: ({ visibleMonth, currentDate, showHeader, onMonthCha
 
 declare const CreateCalendarDialog: ({ onClose, onCreate, app, }: CreateCalendarDialogProps) => preact.VNode<any> | null;
 
+interface DefaultEventDetailPanelProps extends EventDetailPanelProps {
+    app?: ICalendarApp;
+}
+/**
+ * Default event detail panel component
+ */
+declare const DefaultEventDetailPanel: ({ event, position, panelRef, isAllDay: _isAllDay, eventVisibility, calendarRef, selectedEventElementRef, onEventUpdate, onEventDelete, onClose: _onClose, app, }: DefaultEventDetailPanelProps) => preact.VNode<any> | null;
+
+interface DefaultEventDetailDialogProps extends EventDetailDialogProps {
+    app?: ICalendarApp;
+}
+/**
+ * Default event detail dialog component (Dialog mode)
+ * Content is consistent with DefaultEventDetailPanel, but displayed using Dialog/Modal
+ */
+declare const DefaultEventDetailDialog: ({ event, isOpen, onEventUpdate, onEventDelete, onClose, app, }: DefaultEventDetailDialogProps) => preact.VNode<any> | null;
+
 interface ContentSlotProps {
     generatorName: string | null;
     generatorArgs?: unknown;
@@ -2967,19 +3071,114 @@ interface ContentSlotProps {
  */
 declare function ContentSlot({ generatorName, generatorArgs, defaultContent, store: propStore, }: ContentSlotProps): preact.JSX.Element;
 
+interface MultiDayEventSegment {
+    id: string;
+    originalEventId: string;
+    event: Event;
+    startDayIndex: number;
+    endDayIndex: number;
+    segmentType: 'start' | 'middle' | 'end' | 'single' | 'start-week-end' | 'end-week-start';
+    totalDays: number;
+    segmentIndex: number;
+    isFirstSegment: boolean;
+    isLastSegment: boolean;
+    yPosition?: number;
+}
+
+interface YearMultiDaySegment {
+    id: string;
+    event: Event;
+    startCellIndex: number;
+    endCellIndex: number;
+    isFirstSegment: boolean;
+    isLastSegment: boolean;
+    visualRowIndex: number;
+}
+
+interface CalendarEventProps {
+    event: Event;
+    layout?: EventLayout;
+    isAllDay?: boolean;
+    allDayHeight?: number;
+    calendarRef: RefObject<HTMLDivElement>;
+    isBeingDragged?: boolean;
+    isBeingResized?: boolean;
+    viewType: ViewType;
+    isMultiDay?: boolean;
+    segment?: MultiDayEventSegment;
+    yearSegment?: YearMultiDaySegment;
+    columnsPerRow?: number;
+    segmentIndex?: number;
+    hourHeight: number;
+    firstHour: number;
+    newlyCreatedEventId?: string | null;
+    selectedEventId?: string | null;
+    detailPanelEventId?: string | null;
+    onMoveStart?: (e: MouseEvent | TouchEvent, event: Event) => void;
+    onResizeStart?: (e: MouseEvent | TouchEvent, event: Event, direction: string) => void;
+    onEventUpdate: (updatedEvent: Event) => void;
+    onEventDelete: (eventId: string) => void;
+    onDetailPanelOpen?: () => void;
+    onEventSelect?: (eventId: string | null) => void;
+    onEventLongPress?: (eventId: string) => void;
+    onDetailPanelToggle?: (eventId: string | null) => void;
+    /** Custom event detail content component (content only, will be wrapped in default panel) */
+    customDetailPanelContent?: EventDetailContentRenderer;
+    /** Custom event detail dialog component (Dialog mode) */
+    customEventDetailDialog?: EventDetailDialogRenderer;
+    /** Multi-day regular event segment information */
+    multiDaySegmentInfo?: {
+        startHour: number;
+        endHour: number;
+        isFirst: boolean;
+        isLast: boolean;
+        dayIndex?: number;
+    };
+    app?: ICalendarApp;
+    /** Whether the current view is in mobile mode */
+    isMobile?: boolean;
+    /** Whether the current view is in mobile sliding mode */
+    isSlidingView?: boolean;
+    /** Force enable touch interactions regardless of isMobile */
+    enableTouch?: boolean;
+    /** Whether to hide the time in the event display (Month view regular events only) */
+    hideTime?: boolean;
+    /** Time format for event display */
+    timeFormat?: '12h' | '24h';
+    /** Optional style override for custom view layouts */
+    styleOverride?: Record<string, string | number>;
+    /** Optional additional class names */
+    className?: string;
+    /** Disable built-in layout calculation and rely on styleOverride */
+    disableDefaultStyle?: boolean;
+    /**
+     * Override the visual content rendered inside the event shell.
+     * The function receives the built-in default content as its argument,
+     * which can be wrapped, replaced, or ignored entirely.
+     */
+    renderVisualContent?: (defaultContent: ComponentChildren) => ComponentChildren;
+    /** Override resize handle orientation for custom views */
+    resizeHandleOrientation?: 'vertical' | 'horizontal';
+}
+
+declare const CalendarEvent: ({ event, layout, isAllDay, allDayHeight, calendarRef, isBeingDragged, isBeingResized, viewType, isMultiDay, segment, yearSegment, columnsPerRow, segmentIndex, hourHeight, firstHour, selectedEventId, detailPanelEventId, onMoveStart, onResizeStart, onEventUpdate, onEventDelete, newlyCreatedEventId, onDetailPanelOpen, onEventSelect, onEventLongPress, onDetailPanelToggle, customDetailPanelContent, customEventDetailDialog, multiDaySegmentInfo, app, isMobile, isSlidingView, enableTouch, hideTime, timeFormat, styleOverride, className, disableDefaultStyle, renderVisualContent, resizeHandleOrientation, }: CalendarEventProps) => preact.JSX.Element;
+
 interface IconProps {
     className?: string;
     width?: number;
     height?: number;
+    title?: string;
 }
 declare const ChevronRight: ({ className, width, height, }: IconProps) => preact.JSX.Element;
 declare const ChevronDown: ({ 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 Loader2: ({ 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;
 declare const AudioLines: ({ className, width, height, }: IconProps) => preact.JSX.Element;
+declare const AlertCircle: ({ className, width, height, }: IconProps) => preact.JSX.Element;
 
 /**
  * Cancel button
@@ -3006,5 +3205,5 @@ declare const sidebarHeaderToggle = "df-sidebar-header-toggle flex h-8 w-8 items
  */
 declare const sidebarHeaderTitle = "df-sidebar-header-title text-sm font-semibold text-gray-700 dark:text-gray-200";
 
-export { AudioLines, BlossomColorPicker, CalendarApp, CalendarRegistry, CalendarRenderer, Check, ChevronDown, ChevronRight, ChevronsUpDown, ContentSlot, ContextMenu, ContextMenuColorPicker, ContextMenuItem, ContextMenuLabel, ContextMenuSeparator, CreateCalendarDialog, CustomRenderingStore, DefaultColorPicker, LAYOUT_CONFIG, LOCALES, LocaleContext, LocaleProvider, MiniCalendar, PanelRightClose, PanelRightOpen, Plus, TIME_STEP, TimeZone, VIRTUAL_MONTH_SCROLL_CONFIG, ViewType, WeekDataCache, addDays, buildParseRegExp, calculateDayIndex, calendarPickerDropdown, cancelButton, capitalize, clipboardStore, compareAllDayDisplayPriority, conditionalTheme, convertDateEvent, convertDateEventWithTimeZone, convertToDayFlowEvent, createAllDayDisplayComparator, createAllDayEvent, createDateWithHour, createDayView, createEvent, createEventWithDate, createEventWithPlainDateTime, createEventWithRealDate, createEventWithZonedDateTime, createEvents, createEventsPlugin, createMonthView, createStandardViews, createTemporalWithHour, createTimedEvent, createTimezoneEvent, createTimezoneEvents, createWeekView, createYearView, dateToPlainDate, dateToPlainDateTime, dateToZonedDateTime, daysBetween, daysDifference, downloadICS, en, escapeICSValue, extractHourFromDate, extractHourFromTemporal, extractVEvents, foldLine, formatDate, formatDateConsistent, formatDateToICSTimestamp, formatEventTimeRange, formatICSDate, formatMonthYear, formatProperty, formatTemporal, formatTime, generateDayData, generateICS, generateSecondaryTimeSlots, generateUniKey, generateVEvent, generateWeekData, generateWeekRange, generateWeeksData, getAllDayEventsForDay, getAllDayRangeMetrics, getCalendarColorsForHex, getCurrentWeekDates, getDateByDayIndex, getDateObj, getDayIndexByDate, getEndOfDay, getEndOfTemporal, getEventBgColor, getEventEndHour, getEventTextColor, getEventsForDay, getEventsForWeek, getIntlLabel, getLineColor, getMonthLabels, getMonthYearOfWeek, getPlainDate, getSearchHeaderInfo, getSelectedBgColor, getStartOfDay, getStartOfTemporal, getTestEvents, getTimezoneDisplayLabel, getWeekDaysLabels, getWeekNumber, getWeekRange, getZoneId, groupSearchResults, hasEventChanged, importICSFile, isDate, isDeepEqual, isEventDeepEqual, isEventInWeek, isMultiDayEvent, isMultiDayTemporalEvent, isPlainDate, isPlainDateTime, isSameDay, isSamePlainDate, isSameTemporal, isValidLocale, isZonedDateTime, mergeClasses, mergeFormatTemplate, monthNames, normalizeCssWidth, normalizeDate, normalizeLocale, normalizeToZoned, now, pad, pad2, parseICS, parseICSDate, parseTemporalString, parseVEventLines, plainDateTimeToDate, plainDateToDate, recalculateEventDays, registerDragImplementation, registerLocale, registerSidebarImplementation, resolveAppliedTheme, restoreTimedDragFromAllDayTransition, roundToTimeStep, scrollbarTakesSpace, setHourInTemporal, shortMonthNames, sidebarContainer, sidebarHeader, sidebarHeaderTitle, sidebarHeaderToggle, sortAllDayByTitle, t, temporalToDate, themeClasses, themeCn, today, unescapeICSValue, updateEventDateAndDay, updateEventWithRealDate, useDragForView, useLocale, useSidebarBridge, weekDays, weekDaysFullName, zonedDateTimeToDate };
-export type { AllDaySortComparator, BalanceStrategy, BaseViewProps, CalendarAppConfig, CalendarAppState, CalendarCallbacks, CalendarColors, CalendarConfig, CalendarHeaderProps, CalendarPlugin, CalendarType, CalendarView, CalendarsConfig, ColorPickerProps, CreateCalendarDialogColorPickerProps, CreateCalendarDialogProps, CreateEventParams, CreateTimezoneEventParams, CustomRendering, DayData, DayViewConfig, DayViewProps, DragConfig, DragHookOptions, DragHookReturn, DragIndicatorProps, DragIndicatorRenderer, DragIntegrationProps, DragPluginConfig, DragRef, DragService, Event, EventChange, EventContentSlotArgs, 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, MonthScrollConfig, MonthViewConfig, MonthViewProps, NestedLayer, RangeChangeReason, ReadOnlyConfig, SidebarBridgeReturn, SidebarHeaderSlotArgs, SpecialLayoutRule, SubtreeAnalysis, SupportedLang, TComponent, TNode, ThemeColors, ThemeConfig, ThemeMode, TimeZoneValue, TitleBarSlotProps, 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 };
+export { AlertCircle, AudioLines, BlossomColorPicker, CalendarApp, CalendarEvent, CalendarRegistry, CalendarRenderer, Check, ChevronDown, ChevronRight, ChevronsUpDown, ContentSlot, ContextMenu, ContextMenuColorPicker, ContextMenuItem, ContextMenuLabel, ContextMenuSeparator, CreateCalendarDialog, CustomRenderingStore, RangePicker as DayflowRangePicker, DefaultColorPicker, DefaultEventDetailDialog, DefaultEventDetailPanel, EventContextMenu, GridContextMenu, LAYOUT_CONFIG, LOCALES, Loader2, LoadingButton, LocaleContext, LocaleProvider, MiniCalendar, PanelRightClose, PanelRightOpen, Plus, TIME_STEP, TimeZone, VIRTUAL_MONTH_SCROLL_CONFIG, ViewType, WeekDataCache, addDays, buildParseRegExp, calculateDayIndex, calendarPickerDropdown, cancelButton, capitalize, clipboardStore, compareAllDayDisplayPriority, conditionalTheme, convertDateEvent, convertDateEventWithTimeZone, convertToDayFlowEvent, createAllDayDisplayComparator, createAllDayEvent, createDateWithHour, createDayView, createEvent, createEventWithDate, createEventWithPlainDateTime, createEventWithRealDate, createEventWithZonedDateTime, createEvents, createEventsPlugin, createMonthView, createStandardViews, createTemporalWithHour, createTimedEvent, createTimezoneEvent, createTimezoneEvents, createWeekView, createYearView, dateToPlainDate, dateToPlainDateTime, dateToZonedDateTime, daysBetween, daysDifference, downloadICS, en, escapeICSValue, extractHourFromDate, extractHourFromTemporal, extractVEvents, foldLine, formatDate, formatDateConsistent, formatDateToICSTimestamp, formatEventTimeRange, formatICSDate, formatMonthYear, formatProperty, formatTemporal, formatTime, generateDayData, generateICS, generateSecondaryTimeSlots, generateUniKey, generateVEvent, generateWeekData, generateWeekRange, generateWeeksData, getAllDayEventsForDay, getAllDayRangeMetrics, getCalendarColorsForHex, getCurrentWeekDates, getDateByDayIndex, getDateObj, getDayIndexByDate, getEndOfDay, getEndOfTemporal, getEventBgColor, getEventEndHour, getEventTextColor, getEventsForDay, getEventsForWeek, getIntlLabel, getLineColor, getMonthLabels, getMonthYearOfWeek, getPlainDate, getSearchHeaderInfo, getSelectedBgColor, getStartOfDay, getStartOfTemporal, getTestEvents, getTimezoneDisplayLabel, getWeekDaysLabels, getWeekNumber, getWeekRange, getZoneId, groupSearchResults, hasEventChanged, importICSFile, isDate, isDeepEqual, isEventDeepEqual, isEventInWeek, isMultiDayEvent, isMultiDayTemporalEvent, isPlainDate, isPlainDateTime, isSameDay, isSamePlainDate, isSameTemporal, isValidLocale, isZonedDateTime, mergeClasses, mergeFormatTemplate, monthNames, normalizeCssWidth, normalizeDate, normalizeLocale, normalizeToZoned, now, pad, pad2, parseICS, parseICSDate, parseTemporalString, parseVEventLines, plainDateTimeToDate, plainDateToDate, recalculateEventDays, registerDragImplementation, registerLocale, registerSidebarImplementation, resolveAppliedTheme, restoreTimedDragFromAllDayTransition, roundToTimeStep, scrollbarTakesSpace, setHourInTemporal, shortMonthNames, sidebarContainer, sidebarHeader, sidebarHeaderTitle, sidebarHeaderToggle, sortAllDayByTitle, subscribeCalendar, t, temporalToDate, themeClasses, themeCn, today, unescapeICSValue, updateEventDateAndDay, updateEventWithRealDate, useDragForView, useLocale, useSidebarBridge, weekDays, weekDaysFullName, zonedDateTimeToDate };
+export type { AllDaySortComparator, BalanceStrategy, BaseViewProps, CalendarAppConfig, CalendarAppState, CalendarCallbacks, CalendarColors, CalendarConfig, CalendarEventProps, CalendarHeaderProps, CalendarPlugin, CalendarType, CalendarView, CalendarViewType, CalendarsConfig, ColorPickerProps, CreateCalendarDialogColorPickerProps, CreateCalendarDialogProps, CreateEventParams, CreateTimezoneEventParams, CustomRendering, DayData, DayViewConfig, DayViewProps, DragConfig, DragHookOptions, DragHookReturn, DragIndicatorProps, DragIndicatorRenderer, DragIntegrationProps, DragPluginConfig, DragRef, DragService, Event, EventChange, EventContentSlotArgs, 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, MonthScrollConfig, MonthViewConfig, MonthViewProps, NestedLayer, RangeChangeReason, RangePickerProps, ReadOnlyConfig, SidebarBridgeReturn, SidebarHeaderSlotArgs, SpecialLayoutRule, SubscribeResult, SubtreeAnalysis, SupportedLang, TComponent, TNode, ThemeColors, ThemeConfig, ThemeMode, TimeZoneValue, TitleBarSlotProps, 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, ZonedRange, useDragProps, useDragReturn };