@dayflow/core 3.3.2 → 3.3.4

package/dist/index.d.ts

@@ -339,8 +339,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 +358,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 +381,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 +437,7 @@ interface CalendarAppConfig {
     plugins?: CalendarPlugin[];
     events?: Event[];
     callbacks?: CalendarCallbacks;
-    defaultView?: ViewType;
+    defaultView?: CalendarViewType;
     initialDate?: Date;
     switcherMode?: ViewSwitcherMode;
     calendars?: CalendarType[];
@@ -460,11 +463,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;
@@ -481,9 +484,9 @@ interface ICalendarApp {
     state: CalendarAppState;
     getReadOnlyConfig: () => ReadOnlyConfig;
     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;
@@ -540,7 +543,7 @@ interface ICalendarApp {
  */
 interface UseCalendarAppReturn {
     app: ICalendarApp;
-    currentView: ViewType;
+    currentView: CalendarViewType;
     currentDate: Date;
     events: Event[];
     applyEventsChanges: (changes: {
@@ -551,7 +554,7 @@ 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;
@@ -599,11 +602,11 @@ 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;
@@ -1145,13 +1148,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;
     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 +1275,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;
@@ -1535,7 +1538,7 @@ declare class CalendarApp implements ICalendarApp {
      * If readOnly config is present, it's considered non-editable.
      */
     private isInternalEditable;
-    changeView: (view: ViewType) => void;
+    changeView: (view: CalendarViewType) => void;
     getCurrentView: () => CalendarView;
     emitVisibleRange: (start: Date, end: Date, reason?: RangeChangeReason) => void;
     handleVisibleRangeChange: (reason: RangeChangeReason) => void;
@@ -1579,7 +1582,7 @@ declare class CalendarApp implements ICalendarApp {
     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;
@@ -2967,6 +2970,98 @@ 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;
@@ -3006,5 +3101,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 { AudioLines, BlossomColorPicker, CalendarApp, CalendarEvent, 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, 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, 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 };