@dayflow/core 3.6.2 → 3.6.3

package/dist/index.d.ts

@@ -151,8 +151,9 @@ declare class CalendarRegistry {
      */
     getDefaultCalendar(): CalendarType;
     /**
-     * Get the first writable (non-readOnly, non-subscription) calendar for event creation.
-     * Prefers the default calendar; falls back to the first writable calendar.
+     * Get the first writable calendar for event creation.
+     * Prefers non-subscription calendars; falls back to non-readOnly subscription
+     * calendars (e.g. a writable Google Calendar sync).
      * Returns undefined if every calendar is read-only.
      */
     getDefaultWritableCalendar(): CalendarType | undefined;
@@ -505,7 +506,14 @@ interface CalendarView {
     config?: Record<string, unknown>;
 }
 type RangeChangeReason = 'initial' | 'navigation' | 'viewChange' | 'scroll';
-type EventChange = {
+/**
+ * Source of an event mutation.
+ * - 'local': user-initiated change from the UI
+ * - 'remote': applied by an external sync engine (e.g. CalDAV); must not trigger write-back
+ * - 'drag' / 'resize': UI drag or resize interaction (pending → confirmed)
+ */
+type EventMutationSource = 'local' | 'remote' | 'drag' | 'resize';
+type RawEventChange = {
     type: 'create';
     event: Event;
 } | {
@@ -516,6 +524,19 @@ type EventChange = {
     type: 'delete';
     event: Event;
 };
+type EventChange = RawEventChange & {
+    source: EventMutationSource;
+};
+/**
+ * Payload delivered to subscribeVisibleRangeChange listeners.
+ * Includes the view type so sync engines can scope their range queries correctly.
+ */
+type VisibleRangePayload = {
+    start: Date;
+    end: Date;
+    reason: RangeChangeReason;
+    view: CalendarViewType;
+};
 /**
  * Calendar callbacks interface
  * Defines calendar event callback functions
@@ -583,6 +604,15 @@ interface GridContextMenuSlotArgs {
     viewType?: ViewType;
     onClose: () => void;
 }
+/** Args passed to the monthDateNumberContent slot renderer. */
+interface MonthDateNumberSlotArgs {
+    date: Date;
+    day: number;
+    isToday: boolean;
+    belongsToCurrentMonth: boolean;
+    locale: string;
+    viewType: ViewType.MONTH;
+}
 /**
  * Calendar application configuration
  * Used to initialize CalendarApp
@@ -654,6 +684,19 @@ interface ICalendarApp {
     getReadOnlyConfig: (id?: string) => ReadOnlyConfig;
     canMutateFromUI: (id?: string) => boolean;
     subscribe: (listener: (app: ICalendarApp) => void) => () => void;
+    /**
+     * Subscribe to visible range changes. Fires on navigation, view change, and scroll.
+     * The payload includes the current view so sync engines can scope range queries.
+     * Returns an unsubscribe function.
+     */
+    subscribeVisibleRangeChange: (listener: (payload: VisibleRangePayload) => void) => () => void;
+    /**
+     * Subscribe to all event mutations (create, update, delete).
+     * Each change includes a `source` field — remote sync engines should skip write-back
+     * when `source === 'remote'`.
+     * Returns an unsubscribe function.
+     */
+    subscribeEventChanges: (listener: (changes: EventChange[]) => void) => () => void;
     changeView: (view: CalendarViewType) => void;
     getCurrentView: () => CalendarView;
     getViewConfig: (viewType: CalendarViewType) => Record<string, unknown>;
@@ -671,11 +714,11 @@ interface ICalendarApp {
             updates: Partial<Event>;
         }>;
         delete?: string[];
-    }, isPending?: boolean, source?: 'drag' | 'resize') => void;
+    }, isPending?: boolean, source?: EventMutationSource) => void;
     addEvent: (event: Event) => 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>;
+    updateEvent: (id: string, event: Partial<Event>, isPending?: boolean, source?: EventMutationSource) => Promise<void>;
     deleteEvent: (id: string) => Promise<void>;
     getEvents: () => Event[];
     getAllEvents: () => Event[];
@@ -700,6 +743,8 @@ interface ICalendarApp {
     dismissUI: () => void;
     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;
     getCalendarHeaderConfig: () => boolean;
     triggerRender: () => void;
     getCalendarRegistry: () => CalendarRegistry;
@@ -730,11 +775,11 @@ interface UseCalendarAppReturn {
             updates: Partial<Event>;
         }>;
         delete?: string[];
-    }, isPending?: boolean, source?: 'drag' | 'resize') => void;
+    }, isPending?: boolean, source?: EventMutationSource) => void;
     changeView: (view: CalendarViewType) => void;
     setCurrentDate: (date: Date) => void;
     addEvent: (event: Event) => void;
-    updateEvent: (id: string, event: Partial<Event>, isPending?: boolean, source?: 'drag' | 'resize') => Promise<void>;
+    updateEvent: (id: string, event: Partial<Event>, isPending?: boolean, source?: EventMutationSource) => Promise<void>;
     deleteEvent: (id: string) => Promise<void>;
     goToToday: () => void;
     goToPrevious: () => void;
@@ -1675,6 +1720,8 @@ declare class CalendarApp implements ICalendarApp {
     constructor(config: CalendarAppConfig);
     private static resolveLocale;
     subscribe: (listener: (app: ICalendarApp) => void) => (() => void);
+    subscribeVisibleRangeChange: (listener: (payload: VisibleRangePayload) => void) => (() => void);
+    subscribeEventChanges: (listener: (changes: EventChange[]) => void) => (() => void);
     private notify;
     triggerRender: () => void;
     changeView: (view: CalendarViewType) => void;
@@ -1697,10 +1744,10 @@ declare class CalendarApp implements ICalendarApp {
             updates: Partial<Event>;
         }>;
         delete?: string[];
-    }, isPending?: boolean, source?: "drag" | "resize") => void;
+    }, isPending?: boolean, source?: EventMutationSource) => void;
     addEvent: (event: Event) => void;
     addExternalEvents: (calendarId: string, events: Event[]) => void;
-    updateEvent: (id: string, eventUpdate: Partial<Event>, isPending?: boolean, source?: "drag" | "resize") => Promise<void>;
+    updateEvent: (id: string, eventUpdate: Partial<Event>, isPending?: boolean, source?: EventMutationSource) => Promise<void>;
     deleteEvent: (id: string) => Promise<void>;
     getAllEvents: () => Event[];
     getEvents: () => Event[];
@@ -3265,22 +3312,22 @@ declare const EventLayoutCalculator: {
     calculateDayEventLayouts(dayEvents: Event[], params?: LayoutCalculationParams): Map<string, EventLayout>;
 };
 
-interface IconProps {
+interface IconProps extends Record<string, any> {
     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;
+declare const ChevronRight: ({ className, width, height, ...props }: IconProps) => preact.JSX.Element;
+declare const ChevronDown: ({ className, width, height, ...props }: IconProps) => preact.JSX.Element;
+declare const Plus: ({ className, width, height, ...props }: IconProps) => preact.JSX.Element;
+declare const Check: ({ className, width, height, ...props }: IconProps) => preact.JSX.Element;
+declare const ChevronsUpDown: ({ className, width, height, ...props }: IconProps) => preact.JSX.Element;
+declare const Loader2: ({ className, width, height, ...props }: IconProps) => preact.JSX.Element;
+declare const PanelRightClose: ({ className, width, height, ...props }: IconProps) => preact.JSX.Element;
+declare const PanelRightOpen: ({ className, width, height, ...props }: IconProps) => preact.JSX.Element;
+declare const AudioLines: ({ className, width, height, ...props }: IconProps) => preact.JSX.Element;
+declare const AlertCircle: ({ className, width, height, ...props }: IconProps) => preact.JSX.Element;
 
 /**
  * Cancel button
@@ -3308,4 +3355,4 @@ 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, createAgendaView, createAllDayDisplayComparator, createAllDayEvent, createConfigSyncSnapshot, createDateWithHour, createDayView, createEvent, createEventWithDate, createEventWithPlainDateTime, createEventWithRealDate, createEventWithZonedDateTime, createEvents, createEventsPlugin, createMonthView, createNormalizedCalendarAppConfigGetter, createStandardViews, createTemporalWithHour, 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, CreateAllDayEventDateInput, CreateAllDayEventParams, 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 type { AgendaViewConfig, AgendaViewProps, AllDaySortComparator, BalanceStrategy, BaseViewProps, CalendarAppConfig, CalendarAppConfigSyncSnapshot, CalendarAppState, CalendarCallbacks, CalendarColors, CalendarConfig, CalendarEventProps, CalendarHeaderProps, CalendarPlugin, CalendarSearchEvent, CalendarSearchProps, CalendarType, CalendarView, CalendarViewType, CalendarsConfig, ColorPickerProps, CreateAllDayEventDateInput, CreateAllDayEventParams, 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, EventMutationSource, EventRelations, EventsPluginConfig, EventsService, FixedWeekMonthData, GridContextMenuSlotArgs, ICSDateParams, ICSExportOptions, ICSImportOptions, ICSImportResult, ICSParseError, ICSVEvent, ICalendarApp, Locale, LocaleCode, LocaleContextValue, LocaleDict, LocaleMessages, LocaleProviderProps, MobileEventProps, Mode, MonthDateNumberSlotArgs, MonthDragState, MonthEventDragState, MonthEventSegment, MonthScrollConfig, MonthViewConfig, MonthViewProps, NestedLayer, RangeChangeReason, RawEventChange, 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, VisibleRangePayload, WeekDayDragState, WeekViewConfig, WeekViewProps, WeeksData, YearMultiDaySegment, YearViewConfig, YearViewProps, useDragProps, useDragReturn };