@dayflow/core 3.5.3 → 3.6.1

package/dist/index.d.ts

@@ -480,6 +480,7 @@ declare enum ViewType {
     WEEK = "week",
     MONTH = "month",
     YEAR = "year",
+    AGENDA = "agenda",
     RESOURCE = "resource"
 }
 type CalendarViewType = ViewType | string;
@@ -776,6 +777,7 @@ interface CalendarConfig {
         day: Record<string, unknown>;
         week: Record<string, unknown>;
         month: Record<string, unknown>;
+        agenda: Record<string, unknown>;
     };
 }
 interface UseCalendarReturn {
@@ -1157,6 +1159,10 @@ type WeekViewProps = BaseViewProps<WeekViewConfig>;
  * Month view specific Props
  */
 type MonthViewProps = BaseViewProps<MonthViewConfig>;
+/**
+ * Agenda view specific Props
+ */
+type AgendaViewProps = BaseViewProps<AgendaViewConfig>;
 /**
  * Year view specific Props
  */
@@ -1197,11 +1203,12 @@ interface WeekViewConfig extends ViewFactoryConfig {
     gridDateClick?: 'day-view' | 'none' | ((date: Date, events: Event[]) => void);
     /**
      * Action when a date cell is double-clicked.
-     * - 'day-view' (default): navigate to the Day View
+     * - 'create-event' (default): create a 1-hour timed event at the clicked position (hour)
+     * - 'day-view': navigate to the Day View
      * - 'none': no action
      * - function: custom handler
      */
-    gridDateDoubleClick?: 'day-view' | 'none' | ((date: Date, events: Event[]) => void);
+    gridDateDoubleClick?: 'create-event' | 'day-view' | 'none' | ((date: Date, events: Event[]) => void);
 }
 /**
  * Month scroll / navigation configuration
@@ -1227,17 +1234,41 @@ interface MonthViewConfig extends ViewFactoryConfig {
     /** Scroll / navigation behavior for the month view */
     scroll?: MonthScrollConfig;
     showEventDots?: boolean;
+    /** Height in pixels of each event row in the month grid. Default: 16 */
+    eventHeight?: number;
     /**
      * Action when a date cell is clicked.
      */
     gridDateClick?: 'week-view' | 'day-view' | 'none' | ((date: Date, events: Event[]) => void);
     /**
      * Action when a date cell is double-clicked.
-     * - 'week-view' (default): navigate to the Week View
+     * - 'create-event' (default): create a timed event from 9:00 to 10:00 on the clicked date
+     * - 'week-view': navigate to the Week View
+     * - 'day-view': navigate to the Day View
      * - 'none': no action
      * - function: custom handler
      */
-    gridDateDoubleClick?: 'week-view' | 'day-view' | 'none' | ((date: Date, events: Event[]) => void);
+    gridDateDoubleClick?: 'create-event' | 'week-view' | 'day-view' | 'none' | ((date: Date, events: Event[]) => void);
+}
+/**
+ * Agenda view factory configuration
+ */
+interface AgendaViewConfig extends ViewFactoryConfig {
+    /** Number of days rendered in one agenda page. */
+    daysToShow?: number;
+    /** Whether empty dates should still render a section in the list. */
+    showEmptyDays?: boolean;
+    /**
+     * Action when a date section is clicked.
+     */
+    gridDateClick?: 'day-view' | 'none' | ((date: Date, events: Event[]) => void);
+    /**
+     * Action when a date section is double-clicked.
+     * - 'day-view' (default): navigate to the Day View
+     * - 'none': no action
+     * - function: custom handler
+     */
+    gridDateDoubleClick?: 'day-view' | 'none' | ((date: Date, events: Event[]) => void);
 }
 /**
  * Year view factory configuration
@@ -1255,11 +1286,12 @@ interface YearViewConfig extends ViewFactoryConfig {
     gridDateClick?: 'popup' | 'day-view' | 'none' | ((date: Date, events: Event[]) => void);
     /**
      * Grid mode: action when a date cell is double-clicked.
-     * - 'day-view' (default): navigate to the Day View
+     * - 'create-event' (default): create a timed event from 9:00 to 10:00 on the clicked date
+     * - 'day-view': navigate to the Day View
      * - 'none': no action
      * - function: custom handler
      */
-    gridDateDoubleClick?: 'day-view' | 'none' | ((date: Date, events: Event[]) => void);
+    gridDateDoubleClick?: 'create-event' | 'day-view' | 'none' | ((date: Date, events: Event[]) => void);
     /**
      * Grid mode: render custom popup content.
      * Receives the clicked date and its events; return null/undefined to use the default popup.
@@ -2956,12 +2988,15 @@ declare const createWeekView: ViewFactory<WeekViewConfig>;
 
 declare const createMonthView: ViewFactory<MonthViewConfig>;
 
+declare const createAgendaView: ViewFactory<AgendaViewConfig>;
+
 declare const createYearView: ViewFactory<YearViewConfig>;
 
 declare function createStandardViews(config?: {
     day?: Partial<DayViewConfig>;
     week?: Partial<WeekViewConfig>;
     month?: Partial<MonthViewConfig>;
+    agenda?: Partial<AgendaViewConfig>;
 }): CalendarView[];
 
 declare function createEventsPlugin(config?: EventsPluginConfig): CalendarPlugin;
@@ -3195,9 +3230,11 @@ interface CalendarEventProps {
     resizeHandleOrientation?: 'vertical' | 'horizontal';
     /** App-level timezone used to project event times for display (Month/Year view). */
     appTimeZone?: string;
+    /** Height in pixels of each event row in the month grid (month multi-day events only). */
+    monthEventHeight?: number;
 }
 
-declare const _default: ({ 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, useEventDetailPanel, multiDaySegmentInfo, app, isMobile, isSlidingView, enableTouch, hideTime, timeFormat, styleOverride, className, disableDefaultStyle, renderVisualContent, resizeHandleOrientation, appTimeZone, }: CalendarEventProps) => preact.JSX.Element;
+declare const _default: ({ 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, useEventDetailPanel, multiDaySegmentInfo, app, isMobile, isSlidingView, enableTouch, hideTime, timeFormat, styleOverride, className, disableDefaultStyle, renderVisualContent, resizeHandleOrientation, appTimeZone, monthEventHeight, }: CalendarEventProps) => preact.JSX.Element;
 
 interface LayoutCalculationParams {
     containerWidth?: number;
@@ -3255,5 +3292,5 @@ declare const sidebarHeaderToggle = "df-sidebar-toggle";
  */
 declare const sidebarHeaderTitle = "df-sidebar-header-title";
 
-export { AlertCircle, AudioLines, BlossomColorPicker, CalendarApp, _default as CalendarEvent, CalendarRegistry, CalendarRenderer, Check, ChevronDown, ChevronRight, ChevronsUpDown, ContentSlot, CreateCalendarDialog, CustomRenderingStore, DefaultColorPicker, DefaultEventDetailDialog, DefaultEventDetailPanel, EventContextMenu, EventLayoutCalculator, GridContextMenu, LAYOUT_CONFIG, LOCALES, Loader2, LoadingButton, LocaleContext, LocaleProvider, MiniCalendar, PanelRightClose, PanelRightOpen, Plus, TIME_STEP, TimeZone, VIRTUAL_MONTH_SCROLL_CONFIG, ViewType, WeekDataCache, addDays, analyzeMultiDayEventsForRow, buildColorBarGradient, buildDiagonalColorBarGradient, buildDiagonalPatternBackground, buildFixedWeekMonthsData, calculateDayIndex, calendarPickerDropdown, cancelButton, capitalize, clipboardStore, compareAllDayDisplayPriority, compareViews, convertToDayFlowEvent, createAllDayDisplayComparator, createAllDayEvent, createConfigSyncSnapshot, createDateWithHour, createDayView, createEvent, createEventWithDate, createEventWithPlainDateTime, createEventWithRealDate, createEventWithZonedDateTime, createEvents, createEventsPlugin, createMonthView, createNormalizedCalendarAppConfigGetter, 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, formatTime, generateDayData, generateICS, generateSecondaryTimeSlots, generateUniKey, generateVEvent, generateWeekData, generateWeekRange, generateWeeksData, getAllDayEventsForDay, getAllDayRangeMetrics, getCalendarColorsForHex, getCalendarEventBgColors, getCalendarLineColors, getCallbackConfigUpdate, getCurrentWeekDates, getDateByDayIndex, getDateObj, getDayIndexByDate, getEndOfDay, getEndOfTemporal, getEventBgColor, getEventEndHour, getEventIcon, getEventTextColor, getEventsForDay, getEventsForWeek, getFixedWeekTotalColumns, getIntlLabel, getLineColor, getMonthLabels, getMonthYearOfWeek, getNextHourRangeInTimeZone, getNowInTimeZone, getPlainDate, getPrimaryCalendarId, getSearchHeaderInfo, getSelectedBgColor, getStartOfDay, getStartOfTemporal, getSyncConfigUpdates, getTestEvents, getTimezoneDisplayLabel, getTodayInTimeZone, getWeekDaysLabels, getWeekNumber, getWeekRange, groupDaysIntoRows, groupSearchResults, hasEventChanged, importICSFile, isDate, isDeepEqual, isEventDeepEqual, isEventInWeek, isMultiDayEvent, isMultiDayTemporalEvent, isPlainDate, isPlainDateTime, isSameDay, isSamePlainDate, isSameTemporal, isValidLocale, isZonedDateTime, monthNames, normalizeCssWidth, normalizeDate, normalizeLocale, normalizeTimeZoneValue, now, pad2, parseICS, parseICSDate, parseVEventLines, pickSyncableConfig, plainDateTimeToDate, plainDateToDate, recalculateEventDays, registerDragImplementation, registerLocale, registerSidebarImplementation, resolveAppliedTheme, restoreTimedDragFromAllDayTransition, restoreVisualEventToCanonical, restoreVisualTimedTemporalToCanonical, roundToTimeStep, scrollbarTakesSpace, setHourInTemporal, shortMonthNames, sidebarContainer, sidebarHeader, sidebarHeaderTitle, sidebarHeaderToggle, sortAllDayByTitle, subscribeCalendar, syncCalendarAppConfig, t, temporalToDate, temporalToVisualDate, temporalToVisualTemporal, today, unescapeICSValue, updateEventDateAndDay, updateEventWithRealDate, useDragForView, useLocale, useSidebarBridge, weekDays, weekDaysFullName, zonedDateTimeToDate };
-export type { AllDaySortComparator, BalanceStrategy, BaseViewProps, CalendarAppConfig, CalendarAppConfigSyncSnapshot, CalendarAppState, CalendarCallbacks, CalendarColors, CalendarConfig, CalendarEventProps, CalendarHeaderProps, CalendarPlugin, CalendarSearchEvent, CalendarSearchProps, 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, EventContextMenuSlotArgs, EventDetailContentProps, EventDetailContentRenderer, EventDetailDialogProps, EventDetailDialogRenderer, EventDetailPanelProps, EventDetailPanelRenderer, EventDetailPosition, EventGroup, EventLayout, EventRelations, EventsPluginConfig, EventsService, FixedWeekMonthData, GridContextMenuSlotArgs, ICSDateParams, ICSExportOptions, ICSImportOptions, ICSImportResult, ICSParseError, ICSVEvent, ICalendarApp, Locale, LocaleCode, LocaleContextValue, LocaleDict, LocaleMessages, LocaleProviderProps, MobileEventProps, Mode, MonthDragState, MonthEventDragState, MonthEventSegment, MonthScrollConfig, MonthViewConfig, MonthViewProps, NestedLayer, RangeChangeReason, ReadOnlyConfig, SidebarBridgeReturn, SidebarHeaderSlotArgs, SpecialLayoutRule, SubscribeResult, SubtreeAnalysis, SupportedLang, SyncableCalendarAppConfig, 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, ViewConfigComparison, ViewFactory, ViewFactoryConfig, VirtualItem, VirtualScrollIntegrationProps, VirtualWeekItem, WeekDayDragState, WeekViewConfig, WeekViewProps, WeeksData, YearMultiDaySegment, YearViewConfig, YearViewProps, useDragProps, useDragReturn };
+export { AlertCircle, AudioLines, BlossomColorPicker, CalendarApp, _default as CalendarEvent, CalendarRegistry, CalendarRenderer, Check, ChevronDown, ChevronRight, ChevronsUpDown, ContentSlot, CreateCalendarDialog, CustomRenderingStore, DefaultColorPicker, DefaultEventDetailDialog, DefaultEventDetailPanel, EventContextMenu, EventLayoutCalculator, GridContextMenu, LAYOUT_CONFIG, LOCALES, Loader2, LoadingButton, LocaleContext, LocaleProvider, MiniCalendar, PanelRightClose, PanelRightOpen, Plus, TIME_STEP, TimeZone, VIRTUAL_MONTH_SCROLL_CONFIG, ViewType, WeekDataCache, addDays, analyzeMultiDayEventsForRow, buildColorBarGradient, buildDiagonalColorBarGradient, buildDiagonalPatternBackground, buildFixedWeekMonthsData, calculateDayIndex, calendarPickerDropdown, cancelButton, capitalize, clipboardStore, compareAllDayDisplayPriority, compareViews, convertToDayFlowEvent, createAgendaView, createAllDayDisplayComparator, createAllDayEvent, createConfigSyncSnapshot, createDateWithHour, createDayView, createEvent, createEventWithDate, createEventWithPlainDateTime, createEventWithRealDate, createEventWithZonedDateTime, createEvents, createEventsPlugin, createMonthView, createNormalizedCalendarAppConfigGetter, 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, formatTime, generateDayData, generateICS, generateSecondaryTimeSlots, generateUniKey, generateVEvent, generateWeekData, generateWeekRange, generateWeeksData, getAllDayEventsForDay, getAllDayRangeMetrics, getCalendarColorsForHex, getCalendarEventBgColors, getCalendarLineColors, getCallbackConfigUpdate, getCurrentWeekDates, getDateByDayIndex, getDateObj, getDayIndexByDate, getEndOfDay, getEndOfTemporal, getEventBgColor, getEventEndHour, getEventIcon, getEventTextColor, getEventsForDay, getEventsForWeek, getFixedWeekTotalColumns, getIntlLabel, getLineColor, getMonthLabels, getMonthYearOfWeek, getNextHourRangeInTimeZone, getNowInTimeZone, getPlainDate, getPrimaryCalendarId, getSearchHeaderInfo, getSelectedBgColor, getStartOfDay, getStartOfTemporal, getSyncConfigUpdates, getTestEvents, getTimezoneDisplayLabel, getTodayInTimeZone, getWeekDaysLabels, getWeekNumber, getWeekRange, groupDaysIntoRows, groupSearchResults, hasEventChanged, importICSFile, isDate, isDeepEqual, isEventDeepEqual, isEventInWeek, isMultiDayEvent, isMultiDayTemporalEvent, isPlainDate, isPlainDateTime, isSameDay, isSamePlainDate, isSameTemporal, isValidLocale, isZonedDateTime, monthNames, normalizeCssWidth, normalizeDate, normalizeLocale, normalizeTimeZoneValue, now, pad2, parseICS, parseICSDate, parseVEventLines, pickSyncableConfig, plainDateTimeToDate, plainDateToDate, recalculateEventDays, registerDragImplementation, registerLocale, registerSidebarImplementation, resolveAppliedTheme, restoreTimedDragFromAllDayTransition, restoreVisualEventToCanonical, restoreVisualTimedTemporalToCanonical, roundToTimeStep, scrollbarTakesSpace, setHourInTemporal, shortMonthNames, sidebarContainer, sidebarHeader, sidebarHeaderTitle, sidebarHeaderToggle, sortAllDayByTitle, subscribeCalendar, syncCalendarAppConfig, t, temporalToDate, temporalToVisualDate, temporalToVisualTemporal, today, unescapeICSValue, updateEventDateAndDay, updateEventWithRealDate, useDragForView, useLocale, useSidebarBridge, weekDays, weekDaysFullName, zonedDateTimeToDate };
+export type { AgendaViewConfig, AgendaViewProps, AllDaySortComparator, BalanceStrategy, BaseViewProps, CalendarAppConfig, CalendarAppConfigSyncSnapshot, CalendarAppState, CalendarCallbacks, CalendarColors, CalendarConfig, CalendarEventProps, CalendarHeaderProps, CalendarPlugin, CalendarSearchEvent, CalendarSearchProps, 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, EventContextMenuSlotArgs, EventDetailContentProps, EventDetailContentRenderer, EventDetailDialogProps, EventDetailDialogRenderer, EventDetailPanelProps, EventDetailPanelRenderer, EventDetailPosition, EventGroup, EventLayout, EventRelations, EventsPluginConfig, EventsService, FixedWeekMonthData, GridContextMenuSlotArgs, ICSDateParams, ICSExportOptions, ICSImportOptions, ICSImportResult, ICSParseError, ICSVEvent, ICalendarApp, Locale, LocaleCode, LocaleContextValue, LocaleDict, LocaleMessages, LocaleProviderProps, MobileEventProps, Mode, MonthDragState, MonthEventDragState, MonthEventSegment, MonthScrollConfig, MonthViewConfig, MonthViewProps, NestedLayer, RangeChangeReason, ReadOnlyConfig, SidebarBridgeReturn, SidebarHeaderSlotArgs, SpecialLayoutRule, SubscribeResult, SubtreeAnalysis, SupportedLang, SyncableCalendarAppConfig, 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, ViewConfigComparison, ViewFactory, ViewFactoryConfig, VirtualItem, VirtualScrollIntegrationProps, VirtualWeekItem, WeekDayDragState, WeekViewConfig, WeekViewProps, WeeksData, YearMultiDaySegment, YearViewConfig, YearViewProps, useDragProps, useDragReturn };