@dayflow/core 1.0.8 → 2.0.0

package/dist/types/core.d.ts

@@ -4,6 +4,7 @@ import { ViewSwitcherMode } from '../components/common/ViewHeader';
 import { CalendarType, ThemeConfig, ThemeMode } from './calendarTypes';
 import { CalendarRegistry } from '../core/calendarRegistry';
 import { Locale } from '../locale/types';
+import { MobileEventRenderer } from './mobileEvent';
 /**
  * View type enum
  */
@@ -48,11 +49,24 @@ export interface CalendarCallbacks {
     onCalendarCreate?: (calendar: CalendarType) => void | Promise<void>;
     onCalendarDelete?: (calendarId: string) => void | Promise<void>;
     onCalendarMerge?: (sourceId: string, targetId: string) => void | Promise<void>;
+    onEventClick?: (event: Event) => void | Promise<void>;
+    onMoreEventsClick?: (date: Date) => void | Promise<void>;
 }
 export interface CreateCalendarDialogProps {
     onClose: () => void;
     onCreate: (calendar: CalendarType) => void;
 }
+export interface CalendarHeaderProps {
+    calendar: CalendarApp;
+    switcherMode?: ViewSwitcherMode;
+    onAddCalendar?: (e: React.MouseEvent<HTMLButtonElement>) => void;
+    onSearchChange?: (value: string) => void;
+    /** Triggered when search icon is clicked (typically on mobile) */
+    onSearchClick?: () => void;
+    searchValue?: string;
+    isSearchOpen?: boolean;
+    isEditable?: boolean;
+}
 /**
  * Sidebar render props
  */
@@ -68,6 +82,7 @@ export interface CalendarSidebarRenderProps {
     renderCreateCalendarDialog?: (props: CreateCalendarDialogProps) => React.ReactNode;
     editingCalendarId?: string | null;
     setEditingCalendarId?: (id: string | null) => void;
+    onCreateCalendar?: () => void;
 }
 /**
  * Sidebar config
@@ -98,7 +113,17 @@ export interface CalendarAppConfig {
     theme?: ThemeConfig;
     useSidebar?: boolean | SidebarConfig;
     useEventDetailDialog?: boolean;
+    useCalendarHeader?: boolean | ((props: CalendarHeaderProps) => React.ReactNode);
+    customMobileEventRenderer?: MobileEventRenderer;
     locale?: string | Locale;
+    readOnly?: boolean | ReadOnlyConfig;
+}
+/**
+ * Read-only configuration
+ */
+export interface ReadOnlyConfig {
+    draggable?: boolean;
+    viewable?: boolean;
 }
 /**
  * Calendar application state
@@ -114,6 +139,7 @@ export interface CalendarAppState {
     sidebar?: SidebarConfig;
     locale: string | Locale;
     highlightedEventId?: string | null;
+    readOnly: boolean | ReadOnlyConfig;
 }
 /**
  * Calendar application instance
@@ -121,6 +147,7 @@ export interface CalendarAppState {
  */
 export interface CalendarApp {
     state: CalendarAppState;
+    getReadOnlyConfig: () => ReadOnlyConfig;
     changeView: (view: ViewType) => void;
     getCurrentView: () => CalendarView;
     setCurrentDate: (date: Date) => void;
@@ -134,6 +161,8 @@ export interface CalendarApp {
     deleteEvent: (id: string) => void;
     getEvents: () => Event[];
     getAllEvents: () => Event[];
+    onEventClick: (event: Event) => void;
+    onMoreEventsClick: (date: Date) => void;
     highlightEvent: (eventId: string | null) => void;
     getCalendars: () => CalendarType[];
     reorderCalendars: (fromIndex: number, toIndex: number) => void;
@@ -149,9 +178,12 @@ export interface CalendarApp {
     hasPlugin: (name: string) => boolean;
     render: () => React.ReactElement;
     getSidebarConfig: () => SidebarConfig;
+    getCalendarHeaderConfig: () => boolean | ((props: CalendarHeaderProps) => React.ReactNode);
     triggerRender: () => void;
     getCalendarRegistry: () => CalendarRegistry;
     getUseEventDetailDialog: () => boolean;
+    getCustomMobileEventRenderer: () => MobileEventRenderer | undefined;
+    updateConfig: (config: Partial<CalendarAppConfig>) => void;
     setTheme: (mode: ThemeMode) => void;
     getTheme: () => ThemeMode;
     subscribeThemeChange: (callback: (theme: ThemeMode) => void) => (() => void);
@@ -185,6 +217,7 @@ export interface UseCalendarAppReturn {
     setVisibleMonth: (date: Date) => void;
     getVisibleMonth: () => Date;
     sidebarConfig: SidebarConfig;
+    readOnlyConfig: ReadOnlyConfig;
 }
 /**
  * Calendar configuration system type

package/dist/types/dragIndicator.d.ts

@@ -53,6 +53,7 @@ export interface DragIndicatorProps {
     getLineColor: (color: string) => string;
     getDynamicPadding: (drag: DragRef) => string;
     locale?: string;
+    isMobile?: boolean;
 }
 export interface DragIndicatorRenderer {
     renderAllDayContent: (props: DragIndicatorProps) => React.ReactNode;
@@ -95,6 +96,7 @@ export interface useDragProps extends Partial<DragConfig> {
     events: Event[];
     renderer?: DragIndicatorRenderer;
     app?: CalendarApp;
+    isMobile?: boolean;
 }
 export type MonthDragState = {
     active: boolean;
@@ -118,9 +120,9 @@ export interface useDragReturn {
     updateDragIndicator: (...args: (number | boolean | EventLayout | null | undefined)[]) => void;
     removeDragIndicator: () => void;
     handleCreateAllDayEvent?: (e: React.MouseEvent, dayIndex: number) => void;
-    handleCreateStart: (e: React.MouseEvent, ...args: (Date | number)[]) => void;
-    handleMoveStart: (e: React.MouseEvent, event: Event) => void;
-    handleResizeStart: (e: React.MouseEvent, event: Event, direction: string) => void;
+    handleCreateStart: (e: React.MouseEvent | React.TouchEvent, ...args: (Date | number)[]) => void;
+    handleMoveStart: (e: React.MouseEvent | React.TouchEvent, event: Event) => void;
+    handleResizeStart: (e: React.MouseEvent | React.TouchEvent, event: Event, direction: string) => void;
     dragState: MonthDragState | WeekDayDragState;
     isDragging: boolean;
     pixelYToHour?: (y: number) => number;

package/dist/types/event.d.ts

@@ -1,4 +1,5 @@
 import { Temporal } from 'temporal-polyfill';
+import { ReactNode } from 'react';
 /**
  * Calendar event interface (using Temporal API)
  * Unified event data structure supporting single-day, cross-day, and all-day events
@@ -10,6 +11,7 @@ export interface Event {
     start: Temporal.PlainDate | Temporal.PlainDateTime | Temporal.ZonedDateTime;
     end: Temporal.PlainDate | Temporal.PlainDateTime | Temporal.ZonedDateTime;
     allDay?: boolean;
+    icon?: boolean | ReactNode;
     calendarId?: string;
     meta?: Record<string, any>;
     day?: number;

package/dist/types/hook.d.ts

@@ -84,13 +84,13 @@ export interface UseDragManagerReturn {
  * Drag handler Hook return value
  */
 export interface UseDragHandlersReturn {
-    handleDragMove: (e: MouseEvent) => void;
-    handleDragEnd: (e: MouseEvent) => void;
-    handleCreateStart: (e: React.MouseEvent, ...args: (Date | number)[]) => void;
-    handleMoveStart: (e: React.MouseEvent, event: Event) => void;
-    handleResizeStart: (e: React.MouseEvent, event: Event, direction: string) => void;
-    handleUniversalDragMove: (e: MouseEvent) => void;
-    handleUniversalDragEnd: () => void;
+    handleDragMove: (e: MouseEvent | TouchEvent) => void;
+    handleDragEnd: (e: MouseEvent | TouchEvent) => void;
+    handleCreateStart: (e: React.MouseEvent | React.TouchEvent, ...args: (Date | number)[]) => void;
+    handleMoveStart: (e: React.MouseEvent | React.TouchEvent, event: Event) => void;
+    handleResizeStart: (e: React.MouseEvent | React.TouchEvent, event: Event, direction: string) => void;
+    handleUniversalDragMove: (e: MouseEvent | TouchEvent) => void;
+    handleUniversalDragEnd: (e?: MouseEvent | TouchEvent) => void;
 }
 /**
  * Drag handler Hook parameters

package/dist/types/index.d.ts

@@ -9,4 +9,5 @@ export * from './plugin';
 export * from './config';
 export * from './hook';
 export * from './eventDetail';
+export * from './mobileEvent';
 export * from './calendarTypes';

package/dist/types/mobileEvent.d.ts

@@ -0,0 +1,21 @@
+import { Event } from './event';
+import { CalendarApp } from './core';
+/**
+ * Mobile event drawer/dialog Props
+ */
+export interface MobileEventProps {
+    /** Whether the drawer/dialog is open */
+    isOpen: boolean;
+    /** Callback to close the drawer/dialog */
+    onClose: () => void;
+    /** Callback to save the event (creates or updates) */
+    onSave: (event: Event) => void;
+    /** Current event data (newly created template or existing event) */
+    draftEvent: Event | null;
+    /** The CalendarApp instance providing built-in services */
+    app: CalendarApp;
+}
+/**
+ * Custom mobile event renderer (Drawer or Dialog)
+ */
+export type MobileEventRenderer = React.ComponentType<MobileEventProps>;

package/dist/types/monthView.d.ts

@@ -5,6 +5,7 @@ export interface UseVirtualMonthScrollProps {
     onCurrentMonthChange?: (month: string, year: number) => void;
     initialWeeksToLoad?: number;
     locale?: string;
+    isEnabled?: boolean;
 }
 export interface UseVirtualMonthScrollReturn {
     scrollTop: number;

package/dist/types/plugin.d.ts

@@ -3,6 +3,7 @@ import { Event } from './event';
 import { EventLayout } from './layout';
 import { ViewType } from './core';
 import { MonthDragState, WeekDayDragState } from './dragIndicator';
+import { DragConfig } from './config';
 /**
  * Events service interface
  * Provides various event management functions
@@ -33,7 +34,7 @@ export interface EventsPluginConfig {
 /**
  * Drag Hook options
  */
-export interface DragHookOptions {
+export interface DragHookOptions extends Partial<DragConfig> {
     calendarRef: React.RefObject<HTMLDivElement | null>;
     allDayRowRef?: React.RefObject<HTMLDivElement | null>;
     viewType: ViewType;
@@ -44,14 +45,15 @@ export interface DragHookOptions {
     events: Event[];
     calculateNewEventLayout?: (dayIndex: number, startHour: number, endHour: number) => EventLayout | null;
     calculateDragLayout?: (event: Event, targetDay: number, targetStartHour: number, targetEndHour: number) => EventLayout | null;
+    isMobile?: boolean;
 }
 /**
  * Drag Hook return value
  */
 export interface DragHookReturn {
-    handleMoveStart: (e: React.MouseEvent, event: Event) => void;
-    handleCreateStart: (e: React.MouseEvent, ...args: (Date | number)[]) => void;
-    handleResizeStart: (e: React.MouseEvent, event: Event, direction: string) => void;
+    handleMoveStart?: (e: React.MouseEvent | React.TouchEvent, event: Event) => void;
+    handleCreateStart?: (e: React.MouseEvent | React.TouchEvent, ...args: (Date | number)[]) => void;
+    handleResizeStart?: (e: React.MouseEvent | React.TouchEvent, event: Event, direction: string) => void;
     handleCreateAllDayEvent?: (e: React.MouseEvent, dayIndex: number) => void;
     dragState: MonthDragState | WeekDayDragState;
     isDragging: boolean;

package/dist/utils/compareUtils.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Performs a deep comparison between two values to determine if they are equivalent.
+ * Supports primitives, Date objects, and plain objects/arrays.
+ */
+export declare function isDeepEqual(a: any, b: any): boolean;

package/dist/utils/eventUtils.d.ts

@@ -106,3 +106,10 @@ export declare const createEventWithPlainDateTime: (eventData: Omit<Event, "star
  * Use when explicit timezone control is needed
  */
 export declare const createEventWithZonedDateTime: (eventData: Omit<Event, "start" | "end">, weekStart: Date, timeZone: string) => Event;
+/**
+ * Compare two events for equality
+ * @param event1 First event
+ * @param event2 Second event
+ * @returns Whether events are equal in content
+ */
+export declare const isEventEqual: (event1: Event | null, event2: Event | null) => boolean;

package/dist/utils/helpers.d.ts

@@ -21,6 +21,7 @@ export { TIME_STEP, formatTime, formatEventTimeRange, roundToTimeStep, getEventE
 export { weekDays, weekDaysFullName, monthNames, shortMonthNames, } from './dateConstants';
 export { getWeekRange, getCurrentWeekDates } from './dateRangeUtils';
 export { generateDayData, generateWeekData, getMonthYearOfWeek, generateWeeksData, generateWeekRange, } from './calendarDataUtils';
-export { getEventsForDay, getAllDayEventsForDay, getDateByDayIndex, updateEventDateAndDay, createEventWithDate, calculateDayIndex, isEventInWeek, recalculateEventDays, getDayIndexByDate, getEventsForWeek, createEventWithRealDate, updateEventWithRealDate, } from './eventUtils';
+export { getEventsForDay, getAllDayEventsForDay, getDateByDayIndex, updateEventDateAndDay, createEventWithDate, calculateDayIndex, isEventInWeek, recalculateEventDays, getDayIndexByDate, getEventsForWeek, createEventWithRealDate, updateEventWithRealDate, isEventEqual, } from './eventUtils';
 export { getTestEvents } from './testDataUtils';
 export { generateUniKey } from './utilityFunctions';
+export { isDeepEqual } from './compareUtils';

package/dist/views/MonthView.d.ts

@@ -1,13 +1,11 @@
 import React from 'react';
 import { CalendarApp } from '@/core';
 import { EventDetailContentRenderer, EventDetailDialogRenderer } from '@/types';
-import { ViewSwitcherMode } from '@/components/common/ViewHeader';
 interface MonthViewProps {
     app: CalendarApp;
     customDetailPanelContent?: EventDetailContentRenderer;
     customEventDetailDialog?: EventDetailDialogRenderer;
     calendarRef: React.RefObject<HTMLDivElement>;
-    switcherMode?: ViewSwitcherMode;
 }
 declare const MonthView: React.FC<MonthViewProps>;
 export default MonthView;

package/dist/views/WeekView.d.ts

@@ -1,13 +1,11 @@
 import React from 'react';
 import { CalendarApp } from '@/core';
 import { EventDetailContentRenderer, EventDetailDialogRenderer } from '@/types';
-import { ViewSwitcherMode } from '@/components/common/ViewHeader';
 interface WeekViewProps {
     app: CalendarApp;
     customDetailPanelContent?: EventDetailContentRenderer;
     customEventDetailDialog?: EventDetailDialogRenderer;
     calendarRef: React.RefObject<HTMLDivElement>;
-    switcherMode?: ViewSwitcherMode;
 }
 declare const WeekView: React.FC<WeekViewProps>;
 export default WeekView;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dayflow/core",
-  "version": "1.0.8",
+  "version": "2.0.0",
   "description": "A flexible and feature-rich calendar component library for React applications with drag-and-drop support, multiple views (Day, Week, Month, Year), and plugin architecture",
   "main": "dist/index.js",
   "module": "dist/index.esm.js",