@dayflow/core 3.1.0 → 3.1.2

package/README.md

@@ -16,17 +16,17 @@ views, and plugin architecture.
 
 | Monthly                                 | Weekly                                 |
 | --------------------------------------- | -------------------------------------- |
-| ![image](./assets/images/MonthView.png) | ![image](./assets/images/WeekView.png) |
+| ![image](https://raw.githubusercontent.com/dayflow-js/calendar/main/assets/images/MonthView.png) | ![image](https://raw.githubusercontent.com/dayflow-js/calendar/main/assets/images/WeekView.png) |
 
 | Daily                                 | Event Stack Level                        |
 | ------------------------------------- | ---------------------------------------- |
-| ![image](./assets/images/DayView.png) | ![image](./assets/images/stackLevel.png) |
+| ![image](https://raw.githubusercontent.com/dayflow-js/calendar/main/assets/images/DayView.png) | ![image](https://raw.githubusercontent.com/dayflow-js/calendar/main/assets/images/stackLevel.png) |
 
 ### Default Panel (with multiple Event Detail Panel options available)
 
 | Detail Popup                        | Detail Dialog                        |
 | ----------------------------------- | ------------------------------------ |
-| ![image](./assets/images/popup.png) | ![image](./assets/images/dialog.png) |
+| ![image](https://raw.githubusercontent.com/dayflow-js/calendar/main/assets/images/popup.png) | ![image](https://raw.githubusercontent.com/dayflow-js/calendar/main/assets/images/dialog.png) |
 
 ### Easy to resize and drag
 

package/dist/index.d.ts

@@ -1,7 +1,6 @@
 import { Temporal } from 'temporal-polyfill';
 import * as preact from 'preact';
 import { ComponentChildren, RefObject, h } from 'preact';
-import { Event as Event$1 } from '@/types';
 import * as preact_compat from 'preact/compat';
 export { createPortal } from 'preact/compat';
 import { BlossomColorPickerOptions } from '@dayflow/blossom-color-picker';
@@ -200,7 +199,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' | 'done' | 'quickCreateEvent' | 'quickCreatePlaceholder' | 'noSuggestions' | 'newCalendar' | 'refreshAll' | 'tomorrow' | 'importCalendar' | 'exportCalendar' | 'addSchedule' | 'importCalendarMessage' | 'ok' | 'cut' | 'copy' | 'pasteHere' | 'eventSummary';
+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';
 type LocaleDict = Partial<Record<TranslationKey, string>>;
 type LocaleMessages = Partial<Record<TranslationKey, string>>;
 interface Locale {
@@ -218,6 +217,8 @@ interface MobileEventProps {
     onClose: () => void;
     /** Callback to save the event (creates or updates) */
     onSave: (event: Event) => void;
+    /** Callback to delete an existing event by id */
+    onEventDelete?: (id: string) => void;
     /** Current event data (newly created template or existing event) */
     draftEvent: Event | null;
     /** The ICalendarApp instance providing built-in services */
@@ -260,18 +261,35 @@ interface CalendarView {
     component: TComponent;
     config?: Record<string, unknown>;
 }
+type RangeChangeReason = 'initial' | 'navigation' | 'viewChange' | 'scroll';
+type EventChange = {
+    type: 'create';
+    event: Event;
+} | {
+    type: 'update';
+    before: Event;
+    after: Event;
+} | {
+    type: 'delete';
+    event: Event;
+};
 /**
  * Calendar callbacks interface
  * Defines calendar event callback functions
  */
 interface CalendarCallbacks {
+    onEventBatchChange?: (changes: EventChange[]) => void | Promise<void>;
     onViewChange?: (view: ViewType) => void | Promise<void>;
     onEventCreate?: (event: Event) => void | Promise<void>;
     onEventUpdate?: (event: Event) => void | Promise<void>;
     onEventDelete?: (eventId: string) => void | Promise<void>;
     onDateChange?: (date: Date) => void | Promise<void>;
     onRender?: () => void | Promise<void>;
+    /**
+     * @deprecated This method is retained for backward compatibility and will be removed in future releases. Use ``onVisibleRangeChange`` instead.
+     */
     onVisibleMonthChange?: (date: Date) => void | Promise<void>;
+    onVisibleRangeChange?: (start: Date, end: Date, reason: RangeChangeReason) => void | Promise<void>;
     onCalendarUpdate?: (calendar: CalendarType) => void | Promise<void>;
     onCalendarCreate?: (calendar: CalendarType) => void | Promise<void>;
     onCalendarDelete?: (calendarId: string) => void | Promise<void>;
@@ -283,7 +301,7 @@ interface CalendarCallbacks {
 interface CreateCalendarDialogProps {
     onClose: () => void;
     onCreate: (calendar: CalendarType) => void;
-    colorPickerMode?: 'blossom' | 'default';
+    colorPickerMode?: 'default' | 'custom';
 }
 interface CalendarHeaderProps {
     calendar: ICalendarApp;
@@ -387,6 +405,7 @@ interface ICalendarApp {
     mergeCalendars: (sourceId: string, targetId: string) => void;
     setVisibleMonth: (date: Date) => void;
     getVisibleMonth: () => Date;
+    emitVisibleRange: (start: Date, end: Date, reason?: RangeChangeReason) => void;
     dismissUI: () => void;
     getPlugin: <T = unknown>(name: string) => T | undefined;
     hasPlugin: (name: string) => boolean;
@@ -437,6 +456,7 @@ interface UseCalendarAppReturn {
     highlightEvent: (eventId: string | null) => void;
     setVisibleMonth: (date: Date) => void;
     getVisibleMonth: () => Date;
+    emitVisibleRange: (start: Date, end: Date, reason?: RangeChangeReason) => void;
     readOnlyConfig: ReadOnlyConfig;
 }
 /**
@@ -889,6 +909,7 @@ interface UseVirtualMonthScrollReturn {
     currentMonth: string;
     currentYear: number;
     isScrolling: boolean;
+    isNavigating: boolean;
     virtualData: {
         totalHeight: number;
         visibleItems: VirtualWeekItem[];
@@ -1262,6 +1283,7 @@ declare class CalendarApp implements ICalendarApp {
     state: CalendarAppState;
     private callbacks;
     private calendarRegistry;
+    private store;
     private visibleMonth;
     private useEventDetailDialog;
     private useCalendarHeader;
@@ -1272,6 +1294,7 @@ declare class CalendarApp implements ICalendarApp {
     private pendingSnapshot;
     private readonly MAX_UNDO_STACK;
     constructor(config: CalendarAppConfig);
+    private setupStoreListeners;
     private resolveLocale;
     subscribe: (listener: (app: ICalendarApp) => void) => (() => void);
     private notify;
@@ -1285,6 +1308,8 @@ declare class CalendarApp implements ICalendarApp {
     private isInternalEditable;
     changeView: (view: ViewType) => void;
     getCurrentView: () => CalendarView;
+    emitVisibleRange: (start: Date, end: Date, reason?: RangeChangeReason) => void;
+    handleVisibleRangeChange: (reason: RangeChangeReason) => void;
     setCurrentDate: (date: Date) => void;
     getCurrentDate: () => Date;
     setVisibleMonth: (date: Date) => void;
@@ -1365,6 +1390,7 @@ declare class CustomRenderingStore {
     private renderings;
     private overrides;
     private listeners;
+    constructor(initialOverrides?: string[]);
     /**
      * Register a new custom rendering placeholder.
      * Called by the ContentSlot Preact component.
@@ -1397,7 +1423,9 @@ declare class CalendarRenderer {
     private customRenderingStore;
     private unsubscribe;
     private renderRequested;
-    constructor(app: ICalendarApp);
+    private extraProps;
+    constructor(app: ICalendarApp, initialOverrides?: string[]);
+    setProps(props: Record<string, any>): void;
     private requestRender;
     /**
      * Mount the calendar to a DOM container.
@@ -1970,13 +1998,14 @@ declare const formatTemporal: (value: Temporal.ZonedDateTime, format: string, ti
  */
 declare function normalizeCssWidth(width?: number | string, defaultWidth?: string): string;
 /**
- * Check if the browser's scrollbar takes up space in the layout.
+ * Check if the calendar's scrollbar takes up space in the layout.
  *
- * Some browsers (like Safari on macOS with "Show scroll bars: When scrolling" setting)
- * use overlay scrollbars that don't take up space, while others (like Chrome on Windows)
- * use scrollbars that reduce the available width of the container.
+ * Tests inside a .df-calendar-container element so the library's scoped
+ * scrollbar CSS applies (scrollbar-width: thin; ::-webkit-scrollbar { width: 2px }).
+ * Also overrides any host-app CSS that hides scrollbars (e.g. display: none),
+ * since we need to measure the actual rendered scrollbar width.
  *
- * @returns true if scrollbar takes space, false otherwise
+ * @returns true if the calendar scrollbar takes space, false otherwise
  */
 declare function scrollbarTakesSpace(): boolean;
 
@@ -2259,8 +2288,8 @@ declare const groupSearchResults: (results: CalendarSearchEvent[], today: Date)
 
 declare class ClipboardStore {
     private lastCopiedEvent;
-    setEvent(event: Event$1): void;
-    getEvent(): Event$1 | null;
+    setEvent(event: Event): void;
+    getEvent(): Event | null;
     hasEvent(): boolean;
     clear(): void;
 }
@@ -2646,7 +2675,7 @@ declare const sidebarContainer = "df-sidebar flex h-full flex-col border-r borde
 /**
  * Sidebar header
  */
-declare const sidebarHeader = "df-sidebar-header flex items-center px-2 py-2";
+declare const sidebarHeader = "df-sidebar-header flex items-center px-2 py-1";
 /**
  * Sidebar header toggle button
  */
@@ -2657,4 +2686,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, VIRTUAL_MONTH_SCROLL_CONFIG, ViewType, WeekDataCache, addDays, buildParseRegExp, calculateDayIndex, calendarPickerDropdown, cancelButton, capitalize, clipboardStore, conditionalTheme, convertDateEvent, convertDateEventWithTimeZone, createAllDayEvent, createDateWithHour, createDayView, createEvent, createEventWithDate, createEventWithRealDate, createEvents, createEventsPlugin, createMonthView, createStandardViews, createTemporalWithHour, createTimedEvent, createTimezoneEvent, createTimezoneEvents, createWeekView, createYearView, dateToPlainDate, dateToPlainDateTime, dateToZonedDateTime, daysBetween, daysDifference, downloadICS, en, extractHourFromDate, extractHourFromTemporal, formatDate, formatDateConsistent, formatDateToICSTimestamp, formatEventTimeRange, formatICSDate, formatMonthYear, formatTemporal, formatTime, generateDayData, generateICS, generateUniKey, 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, getWeekDaysLabels, getWeekRange, getZoneId, groupSearchResults, importICSFile, isDate, isDeepEqual, isEventEqual, isEventInWeek, isMultiDayEvent, isMultiDayTemporalEvent, isPlainDate, isPlainDateTime, isSameDay, isSamePlainDate, isSameTemporal, isValidLocale, isZonedDateTime, mergeClasses, mergeFormatTemplate, monthNames, normalizeCssWidth, normalizeDate, normalizeLocale, normalizeToZoned, now, pad, parseICS, parseICSDate, parseTemporalString, plainDateTimeToDate, plainDateToDate, recalculateEventDays, registerDragImplementation, registerLocale, registerSidebarImplementation, resolveAppliedTheme, roundToTimeStep, scrollbarTakesSpace, setHourInTemporal, shortMonthNames, sidebarContainer, sidebarHeader, sidebarHeaderTitle, sidebarHeaderToggle, t, temporalToDate, themeClasses, themeCn, today, 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, 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, ReadOnlyConfig, SidebarBridgeReturn, SpecialLayoutRule, SubtreeAnalysis, SupportedLang, TComponent, TNode, ThemeColors, ThemeConfig, ThemeMode, 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, 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, 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 };