@dayflow/core 3.2.0 → 3.2.2

package/README.md

@@ -1,8 +1,6 @@
-# DayFlow
+# DayFlow Core
 
-**English** | [中文](README.zh.md) | [日本語](README.ja.md) | [Getting Started & Contributing](CONTRIBUTING.md)
-
-A flexible and feature-rich calendar component library for **React, Vue, Angular, and Svelte** with drag-and-drop support, multiple views, and plugin architecture.
+The core engine of DayFlow, a flexible and feature-rich calendar library 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)
@@ -15,47 +13,47 @@ A flexible and feature-rich calendar component library for **React, Vue, Angular
 
 #### Day View
 
-![Day View](https://raw.githubusercontent.com/dayflow-js/calendar/main/assets/images/DayView.png)
+![Day View](https://raw.githubusercontent.com/dayflow-js/dayflow/main/assets/images/DayView.png)
 
 #### Week View
 
-![Week View](https://raw.githubusercontent.com/dayflow-js/calendar/main/assets/images/WeekView.png)
+![Week View](https://raw.githubusercontent.com/dayflow-js/dayflow/main/assets/images/WeekView.png)
 
 #### Month View
 
-![Month View](https://raw.githubusercontent.com/dayflow-js/calendar/main/assets/images/MonthView.png)
+![Month View](https://raw.githubusercontent.com/dayflow-js/dayflow/main/assets/images/MonthView.png)
 
 #### Year View(Fixed-Week)
 
-![Year View](https://raw.githubusercontent.com/dayflow-js/calendar/main/assets/images/Year-Fixed-Week.png)
+![Year View](https://raw.githubusercontent.com/dayflow-js/dayflow/main/assets/images/Year-Fixed-Week.png)
 
 #### Year View(Year-Canvas)
 
-![Year Canvas View](https://raw.githubusercontent.com/dayflow-js/calendar/main/assets/images/Year-Canvas.png)
+![Year Canvas View](https://raw.githubusercontent.com/dayflow-js/dayflow/main/assets/images/Year-Canvas.png)
 
 ### Mobile View Support
 
 #### Mobile Day & Year View
 
-![Mobile Day and Year View](https://raw.githubusercontent.com/dayflow-js/calendar/main/assets/images/Mobile-Day-Year.png)
+![Mobile Day and Year View](https://raw.githubusercontent.com/dayflow-js/dayflow/main/assets/images/Mobile-Day-Year.png)
 
 #### Mobile Week & Month View
 
-![Mobile Week and Month View](https://raw.githubusercontent.com/dayflow-js/calendar/main/assets/images/Mobile-Week-Month.png)
+![Mobile Week and Month View](https://raw.githubusercontent.com/dayflow-js/dayflow/main/assets/images/Mobile-Week-Month.png)
 
 ### Multiple Event Detail Panel options
 
 #### Detail Popup
 
-![Popup](https://raw.githubusercontent.com/dayflow-js/calendar/main/assets/images/popup.png)
+![Popup](https://raw.githubusercontent.com/dayflow-js/dayflow/main/assets/images/popup.png)
 
 #### Detail Dialog
 
-![Dialog](https://raw.githubusercontent.com/dayflow-js/calendar/main/assets/images/dialog.png)
+![Dialog](https://raw.githubusercontent.com/dayflow-js/dayflow/main/assets/images/dialog.png)
 
 ### Dark Mode Support
 
-![Dark Mode](https://raw.githubusercontent.com/dayflow-js/calendar/main/assets/images/DarkMode.png)
+![Dark Mode](https://raw.githubusercontent.com/dayflow-js/dayflow/main/assets/images/DarkMode.png)
 
 ### Easy to resize and drag
 
@@ -74,5 +72,3 @@ If you find a bug, please file an issue on [GitHub Issues](https://github.com/da
 ## Support
 
 For questions and support, please open an issue on GitHub or go to discord.
-
----

package/dist/index.d.ts

@@ -207,6 +207,119 @@ interface Event {
     day?: number;
 }
 
+/**
+ * Event layout configuration constants
+ * Controls visual presentation of events in the calendar
+ */
+declare const LAYOUT_CONFIG: {
+    readonly INDENT_STEP: 2;
+    readonly MIN_WIDTH: 25;
+    readonly MARGIN_BETWEEN: 2;
+    readonly CONTAINER_WIDTH: 320;
+    readonly OVERLAP_THRESHOLD: 0.25;
+    readonly EDGE_MARGIN: 3;
+    readonly MAX_LOAD_IMBALANCE: 0;
+    readonly REBALANCE_THRESHOLD: 2;
+};
+/**
+ * Event layout interface
+ * Defines position and styling of events in the UI
+ */
+interface EventLayout {
+    id: string;
+    left: number;
+    width: number;
+    zIndex: number;
+    level: number;
+    isPrimary: boolean;
+    indentOffset: number;
+    importance: number;
+}
+/**
+ * Nested layer interface
+ * Represents hierarchical relationships of events
+ */
+interface NestedLayer {
+    events: Event[];
+    level: number;
+    parentEvent?: Event;
+    timeSlot?: {
+        start: number;
+        end: number;
+    };
+}
+/**
+ * Event group interface
+ * Represents a group of related events and their nested structure
+ */
+interface EventGroup {
+    events: Event[];
+    startHour: number;
+    endHour: number;
+    primaryEvent?: Event;
+    nestedStructure: NestedLayer[];
+    specialLayoutRules?: SpecialLayoutRule[];
+    originalBranchMap?: Map<string, Event>;
+}
+/**
+ * Event relationship information interface
+ * Describes relationships of events in nested structures
+ */
+interface EventRelations {
+    directChildren: Event[];
+    allDescendants: Event[];
+    directParent: Event | null;
+    layer: NestedLayer | null;
+    subtreeSize: number;
+    isLeaf: boolean;
+}
+/**
+ * Subtree analysis interface
+ * Used to analyze structural information of event trees
+ */
+interface SubtreeAnalysis {
+    rootEvent: Event;
+    allDescendants: Event[];
+    timeSpan: {
+        start: number;
+        end: number;
+        duration: number;
+    };
+    descendantCount: number;
+    maxDepth: number;
+    branchPath: Event[];
+}
+/**
+ * Balance strategy interface
+ * Used for balance algorithms to optimize event layouts
+ */
+interface BalanceStrategy {
+    type: 'count_balance' | 'timespan_balance';
+    transfers: TransferOperation[];
+    specialLayoutRules: SpecialLayoutRule[];
+}
+/**
+ * Transfer operation interface
+ * Describes movement of events in layout optimization
+ */
+interface TransferOperation {
+    event: Event;
+    fromParent: Event;
+    toParent: Event;
+    reason: string;
+}
+/**
+ * Special layout rule interface
+ * Defines layout constraints for specific events
+ */
+interface SpecialLayoutRule {
+    eventId: string;
+    layoutType: 'align_with_ancestor' | 'full_width' | 'full_width_from_level' | 'align_with_sibling';
+    referenceEvent?: Event;
+    targetLevel?: number;
+    reason?: string;
+}
+
 /** Generic type for framework-specific components */
 type TComponent = AnyComponent<any, any>;
 /** Generic type for framework-specific nodes/elements */
@@ -280,10 +393,32 @@ interface CalendarCallbacks {
     onMoreEventsClick?: (date: Date) => void | Promise<void>;
     onDismissUI?: () => void | Promise<void>;
 }
+interface TitleBarSlotProps {
+    isCollapsed: boolean;
+    toggleCollapsed: () => void;
+}
+interface CreateCalendarDialogColorPickerProps {
+    color: string;
+    onChange: (color: {
+        hex: string;
+    }) => void;
+    onAccept?: () => void;
+    onCancel?: () => void;
+    styles?: any;
+}
+interface ColorPickerProps {
+    color: string;
+    onChange: (color: {
+        hex: string;
+    }) => void;
+    onChangeComplete?: (color: {
+        hex: string;
+    }) => void;
+}
 interface CreateCalendarDialogProps {
     onClose: () => void;
     onCreate: (calendar: CalendarType) => void;
-    colorPickerMode?: 'default' | 'custom';
+    app: ICalendarApp;
 }
 interface CalendarHeaderProps {
     calendar: ICalendarApp;
@@ -298,6 +433,16 @@ interface CalendarHeaderProps {
     /** Left safe area padding (px) to avoid overlapping with traffic light buttons in macMode */
     safeAreaLeft?: number;
 }
+/** Args passed to all eventContent* slot renderers. */
+interface EventContentSlotArgs {
+    event: Event;
+    viewType: ViewType;
+    isAllDay: boolean;
+    isMobile: boolean;
+    isSelected: boolean;
+    isDragging: boolean;
+    layout?: EventLayout;
+}
 /**
  * Calendar application configuration
  * Used to initialize CalendarApp
@@ -341,6 +486,7 @@ interface CalendarAppState {
     highlightedEventId?: string | null;
     selectedEventId?: string | null;
     readOnly: boolean | ReadOnlyConfig;
+    overrides: string[];
 }
 /**
  * Calendar application instance
@@ -397,6 +543,7 @@ interface ICalendarApp {
     getUseEventDetailDialog: () => boolean;
     getCustomMobileEventRenderer: () => MobileEventRenderer | undefined;
     updateConfig: (config: Partial<CalendarAppConfig>) => void;
+    setOverrides: (overrides: string[]) => void;
     setTheme: (mode: ThemeMode) => void;
     getTheme: () => ThemeMode;
     subscribeThemeChange: (callback: (theme: ThemeMode) => void) => () => void;
@@ -509,119 +656,6 @@ interface WeeksData {
     };
 }
 
-/**
- * Event layout configuration constants
- * Controls visual presentation of events in the calendar
- */
-declare const LAYOUT_CONFIG: {
-    readonly INDENT_STEP: 2;
-    readonly MIN_WIDTH: 25;
-    readonly MARGIN_BETWEEN: 2;
-    readonly CONTAINER_WIDTH: 320;
-    readonly OVERLAP_THRESHOLD: 0.25;
-    readonly EDGE_MARGIN: 3;
-    readonly MAX_LOAD_IMBALANCE: 0;
-    readonly REBALANCE_THRESHOLD: 2;
-};
-/**
- * Event layout interface
- * Defines position and styling of events in the UI
- */
-interface EventLayout {
-    id: string;
-    left: number;
-    width: number;
-    zIndex: number;
-    level: number;
-    isPrimary: boolean;
-    indentOffset: number;
-    importance: number;
-}
-/**
- * Nested layer interface
- * Represents hierarchical relationships of events
- */
-interface NestedLayer {
-    events: Event[];
-    level: number;
-    parentEvent?: Event;
-    timeSlot?: {
-        start: number;
-        end: number;
-    };
-}
-/**
- * Event group interface
- * Represents a group of related events and their nested structure
- */
-interface EventGroup {
-    events: Event[];
-    startHour: number;
-    endHour: number;
-    primaryEvent?: Event;
-    nestedStructure: NestedLayer[];
-    specialLayoutRules?: SpecialLayoutRule[];
-    originalBranchMap?: Map<string, Event>;
-}
-/**
- * Event relationship information interface
- * Describes relationships of events in nested structures
- */
-interface EventRelations {
-    directChildren: Event[];
-    allDescendants: Event[];
-    directParent: Event | null;
-    layer: NestedLayer | null;
-    subtreeSize: number;
-    isLeaf: boolean;
-}
-/**
- * Subtree analysis interface
- * Used to analyze structural information of event trees
- */
-interface SubtreeAnalysis {
-    rootEvent: Event;
-    allDescendants: Event[];
-    timeSpan: {
-        start: number;
-        end: number;
-        duration: number;
-    };
-    descendantCount: number;
-    maxDepth: number;
-    branchPath: Event[];
-}
-/**
- * Balance strategy interface
- * Used for balance algorithms to optimize event layouts
- */
-interface BalanceStrategy {
-    type: 'count_balance' | 'timespan_balance';
-    transfers: TransferOperation[];
-    specialLayoutRules: SpecialLayoutRule[];
-}
-/**
- * Transfer operation interface
- * Describes movement of events in layout optimization
- */
-interface TransferOperation {
-    event: Event;
-    fromParent: Event;
-    toParent: Event;
-    reason: string;
-}
-/**
- * Special layout rule interface
- * Defines layout constraints for specific events
- */
-interface SpecialLayoutRule {
-    eventId: string;
-    layoutType: 'align_with_ancestor' | 'full_width' | 'full_width_from_level' | 'align_with_sibling';
-    referenceEvent?: Event;
-    targetLevel?: number;
-    reason?: string;
-}
-
 /**
  * Drag mode type
  */
@@ -849,6 +883,7 @@ interface UseVirtualMonthScrollProps {
     locale?: string;
     startOfWeek?: number;
     isEnabled?: boolean;
+    snapToMonth?: boolean;
 }
 interface UseVirtualMonthScrollReturn {
     scrollTop: number;
@@ -1190,6 +1225,7 @@ interface MonthViewConfig extends ViewFactoryConfig {
     showWeekNumbers?: boolean;
     showMonthIndicator?: boolean;
     startOfWeek?: number;
+    snapToMonth?: boolean;
 }
 /**
  * Year view factory configuration
@@ -1486,6 +1522,7 @@ declare class CalendarApp implements ICalendarApp {
     getUseEventDetailDialog: () => boolean;
     getCustomMobileEventRenderer: () => MobileEventRenderer | undefined;
     updateConfig: (config: Partial<CalendarAppConfig>) => void;
+    setOverrides: (overrides: string[]) => void;
     /**
      * Set theme mode
      * @param mode - Theme mode ('light', 'dark', or 'auto')
@@ -2819,10 +2856,10 @@ interface MiniCalendarProps {
 }
 declare const MiniCalendar: ({ visibleMonth, currentDate, showHeader, onMonthChange, onDateSelect, }: MiniCalendarProps) => preact.JSX.Element;
 
-declare const CreateCalendarDialog: ({ onClose, onCreate, colorPickerMode, }: CreateCalendarDialogProps) => preact.VNode<any> | null;
+declare const CreateCalendarDialog: ({ onClose, onCreate, app, }: CreateCalendarDialogProps) => preact.VNode<any> | null;
 
 interface ContentSlotProps {
-    generatorName: string;
+    generatorName: string | null;
     generatorArgs?: unknown;
     defaultContent?: ComponentChildren;
     store?: CustomRenderingStore | null;
@@ -2872,4 +2909,4 @@ 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 { 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, TimeZone, VIRTUAL_MONTH_SCROLL_CONFIG, ViewType, WeekDataCache, addDays, buildParseRegExp, calculateDayIndex, calendarPickerDropdown, cancelButton, capitalize, clipboardStore, conditionalTheme, convertDateEvent, convertDateEventWithTimeZone, convertToDayFlowEvent, 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, 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, roundToTimeStep, scrollbarTakesSpace, setHourInTemporal, shortMonthNames, sidebarContainer, sidebarHeader, sidebarHeaderTitle, sidebarHeaderToggle, t, temporalToDate, themeClasses, themeCn, today, unescapeICSValue, 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, TimeZoneValue, 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 type { 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, MonthViewConfig, MonthViewProps, NestedLayer, RangeChangeReason, ReadOnlyConfig, SidebarBridgeReturn, 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 };