@dayflow/core 3.1.2 → 3.2.0

package/dist/index.d.ts

@@ -1,27 +1,10 @@
-import { Temporal } from 'temporal-polyfill';
 import * as preact from 'preact';
-import { ComponentChildren, RefObject, h } from 'preact';
+import { ComponentChildren, AnyComponent, h, RefObject, JSX } from 'preact';
+import { Temporal } from 'temporal-polyfill';
 import * as preact_compat from 'preact/compat';
 export { createPortal } from 'preact/compat';
 import { BlossomColorPickerOptions } from '@dayflow/blossom-color-picker';
 
-/**
- * Calendar event interface (using Temporal API)
- * Unified event data structure supporting single-day, cross-day, and all-day events
- */
-interface Event {
-    id: string;
-    title: string;
-    description?: string;
-    start: Temporal.PlainDate | Temporal.PlainDateTime | Temporal.ZonedDateTime;
-    end: Temporal.PlainDate | Temporal.PlainDateTime | Temporal.ZonedDateTime;
-    allDay?: boolean;
-    icon?: boolean | ComponentChildren;
-    calendarId?: string;
-    meta?: Record<string, any>;
-    day?: number;
-}
-
 type ViewSwitcherMode = 'buttons' | 'select';
 
 /**
@@ -183,11 +166,11 @@ declare class CalendarRegistry {
     /**
      * Check if the current theme is dark
      */
-    private isDarkTheme;
+    private static isDarkTheme;
     /**
      * Validate calendar configuration
      */
-    validate(calendar: Partial<CalendarType>): string[];
+    static validate(calendar: Partial<CalendarType>): string[];
 }
 /**
  * Get calendar colors for a specific hex color
@@ -208,31 +191,30 @@ interface Locale {
 }
 
 /**
- * Mobile event drawer/dialog Props
+ * Calendar event interface (using Temporal API)
+ * Unified event data structure supporting single-day, cross-day, and all-day events
  */
-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;
-    /** 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 */
-    app: ICalendarApp;
+interface Event {
+    id: string;
+    title: string;
+    description?: string;
+    start: Temporal.PlainDate | Temporal.PlainDateTime | Temporal.ZonedDateTime;
+    end: Temporal.PlainDate | Temporal.PlainDateTime | Temporal.ZonedDateTime;
+    allDay?: boolean;
+    icon?: boolean | ComponentChildren;
+    calendarId?: string;
+    meta?: Record<string, unknown>;
+    day?: number;
 }
-/**
- * Custom mobile event renderer (Drawer or Dialog)
- */
-type MobileEventRenderer = any;
 
 /** Generic type for framework-specific components */
-type TComponent = any;
+type TComponent = AnyComponent<any, any>;
 /** Generic type for framework-specific nodes/elements */
-type TNode = any;
+type TNode = ComponentChildren;
+/**
+ * Custom mobile event renderer (Drawer or Dialog)
+ */
+type MobileEventRenderer = AnyComponent<any, any>;
 /**
  * View type enum
  */
@@ -306,7 +288,7 @@ interface CreateCalendarDialogProps {
 interface CalendarHeaderProps {
     calendar: ICalendarApp;
     switcherMode?: ViewSwitcherMode;
-    onAddCalendar?: (e: any) => void;
+    onAddCalendar?: (e: h.JSX.TargetedMouseEvent<HTMLElement> | h.JSX.TargetedTouchEvent<HTMLElement>) => void;
     onSearchChange?: (value: string) => void;
     /** Triggered when search icon is clicked (typically on mobile) */
     onSearchClick?: () => void;
@@ -385,9 +367,9 @@ interface ICalendarApp {
             updates: Partial<Event>;
         }>;
         delete?: string[];
-    }, isPending?: boolean) => void;
+    }, isPending?: boolean, source?: 'drag' | 'resize') => void;
     addEvent: (event: Event) => void;
-    updateEvent: (id: string, event: Partial<Event>, isPending?: boolean) => void;
+    updateEvent: (id: string, event: Partial<Event>, isPending?: boolean, source?: 'drag' | 'resize') => void;
     deleteEvent: (id: string) => void;
     getEvents: () => Event[];
     getAllEvents: () => Event[];
@@ -436,11 +418,11 @@ interface UseCalendarAppReturn {
             updates: Partial<Event>;
         }>;
         delete?: string[];
-    }, isPending?: boolean) => void;
+    }, isPending?: boolean, source?: 'drag' | 'resize') => void;
     changeView: (view: ViewType) => void;
     setCurrentDate: (date: Date) => void;
     addEvent: (event: Event) => void;
-    updateEvent: (id: string, event: Partial<Event>, isPending?: boolean) => void;
+    updateEvent: (id: string, event: Partial<Event>, isPending?: boolean, source?: 'drag' | 'resize') => void;
     deleteEvent: (id: string) => void;
     goToToday: () => void;
     goToPrevious: () => void;
@@ -640,104 +622,6 @@ interface SpecialLayoutRule {
     reason?: string;
 }
 
-/**
- * Virtual scroll item interface (YearView)
- */
-interface VirtualItem {
-    index: number;
-    year: number;
-    top: number;
-    height: number;
-}
-/**
- * Virtual scroll Hook parameters interface (YearView)
- */
-interface UseVirtualScrollProps {
-    currentDate: Date;
-    yearHeight: number;
-    onCurrentYearChange?: (year: number) => void;
-}
-/**
- * Virtual scroll Hook return value interface (YearView)
- */
-interface UseVirtualScrollReturn {
-    scrollTop: number;
-    containerHeight: number;
-    currentYear: number;
-    isScrolling: boolean;
-    virtualData: {
-        totalHeight: number;
-        visibleItems: VirtualItem[];
-    };
-    scrollElementRef: any;
-    handleScroll: (e: any) => void;
-    scrollToYear: (targetYear: number, smooth?: boolean) => void;
-    handlePreviousYear: () => void;
-    handleNextYear: () => void;
-    handleToday: () => void;
-    setScrollTop: (val: number | ((prev: number) => number)) => void;
-    setContainerHeight: (val: number | ((prev: number) => number)) => void;
-    setCurrentYear: (val: number | ((prev: number) => number)) => void;
-    setIsScrolling: (val: boolean | ((prev: boolean) => boolean)) => void;
-}
-/**
- * Drag state Hook return value
- */
-interface UseDragStateReturn {
-    dragRef: RefObject<UnifiedDragRef>;
-    currentDragRef: RefObject<{
-        x: number;
-        y: number;
-    }>;
-    dragState: MonthDragState | WeekDayDragState;
-    setDragState: (val: MonthDragState | WeekDayDragState | ((prev: MonthDragState | WeekDayDragState) => MonthDragState | WeekDayDragState)) => void;
-    resetDragState: () => void;
-    throttledSetEvents: (updateFunc: (events: Event[]) => Event[], dragState?: string) => void;
-}
-/**
- * Drag common utilities Hook return value
- */
-interface UseDragCommonReturn {
-    pixelYToHour: (y: number) => number;
-    getColumnDayIndex: (x: number) => number;
-    checkIfInAllDayArea: (clientY: number) => boolean;
-    handleDirectScroll: (clientY: number) => void;
-    daysDifference: (date1: Date, date2: Date) => number;
-    addDaysToDate: (date: Date, days: number) => Date;
-    getTargetDateFromPosition: (clientX: number, clientY: number) => Date | null;
-    ONE_DAY_MS: number;
-}
-/**
- * Drag management Hook return value
- */
-interface UseDragManagerReturn {
-    dragIndicatorRef: RefObject<HTMLDivElement | null>;
-    removeDragIndicator: () => void;
-    createDragIndicator: (drag: UnifiedDragRef, color?: string, title?: string, layout?: EventLayout | null, sourceElement?: HTMLElement) => void;
-    updateDragIndicator: (...args: (number | boolean | EventLayout | null | undefined)[]) => void;
-}
-/**
- * Drag handler Hook return value
- */
-interface UseDragHandlersReturn {
-    handleDragMove: (e: MouseEvent | TouchEvent) => void;
-    handleDragEnd: (e: MouseEvent | TouchEvent) => void;
-    handleCreateStart: (e: any | any, ...args: (Date | number)[]) => void;
-    handleMoveStart: (e: any | any, event: Event) => void;
-    handleResizeStart: (e: any | any, event: Event, direction: string) => void;
-    handleUniversalDragMove: (e: MouseEvent | TouchEvent) => void;
-    handleUniversalDragEnd: (e?: MouseEvent | TouchEvent) => void;
-}
-/**
- * Drag handler Hook parameters
- */
-interface UseDragHandlersParams {
-    options: useDragProps;
-    common: UseDragCommonReturn;
-    state: UseDragStateReturn;
-    manager: UseDragManagerReturn;
-}
-
 /**
  * Drag mode type
  */
@@ -792,15 +676,16 @@ interface DragIndicatorProps {
     isMobile?: boolean;
 }
 interface DragIndicatorRenderer {
-    renderAllDayContent: (props: DragIndicatorProps) => any;
-    renderRegularContent: (props: DragIndicatorProps) => any;
-    renderDefaultContent: (props: DragIndicatorProps) => any;
+    renderAllDayContent: (props: DragIndicatorProps) => ComponentChildren;
+    renderRegularContent: (props: DragIndicatorProps) => ComponentChildren;
+    renderDefaultContent: (props: DragIndicatorProps) => ComponentChildren;
 }
 interface UnifiedDragRef extends DragRef {
     targetDate?: Date | null;
     originalDate?: Date | null;
     originalEvent?: Event | null;
     dragOffset?: number;
+    dragOffsetY?: number;
     originalStartDate?: Date | null;
     originalEndDate?: Date | null;
     eventDate?: Date;
@@ -823,9 +708,11 @@ interface UnifiedDragRef extends DragRef {
     title?: string;
 }
 interface useDragProps extends Partial<DragConfig> {
-    calendarRef: any;
-    allDayRowRef?: any;
-    onEventsUpdate: (updateFunc: (events: Event[]) => Event[], isResizing?: boolean) => void;
+    calendarRef: RefObject<HTMLDivElement>;
+    allDayRowRef?: RefObject<HTMLDivElement>;
+    timeGridRef?: RefObject<HTMLDivElement>;
+    viewType: ViewType;
+    onEventsUpdate: (updateFunc: (events: Event[]) => Event[], isResizing?: boolean, source?: 'drag' | 'resize') => void;
     onEventCreate: (event: Event) => void;
     onEventEdit?: (event: Event) => void;
     calculateNewEventLayout?: (dayIndex: number, startHour: number, endHour: number) => EventLayout | null;
@@ -835,6 +722,8 @@ interface useDragProps extends Partial<DragConfig> {
     renderer?: DragIndicatorRenderer;
     app?: ICalendarApp;
     isMobile?: boolean;
+    gridWidth?: string;
+    displayDays?: number;
 }
 type MonthDragState = {
     active: boolean;
@@ -857,10 +746,10 @@ interface useDragReturn {
     createDragIndicator: (drag: UnifiedDragRef, color?: string, title?: string, layout?: EventLayout | null, sourceElement?: HTMLElement) => void;
     updateDragIndicator: (...args: (number | boolean | EventLayout | null | undefined)[]) => void;
     removeDragIndicator: () => void;
-    handleCreateAllDayEvent?: (e: any, dayIndex: number) => void;
-    handleCreateStart: (e: any | any, ...args: (Date | number)[]) => void;
-    handleMoveStart: (e: any | any, event: Event) => void;
-    handleResizeStart: (e: any | any, event: Event, direction: string) => void;
+    handleCreateAllDayEvent?: (e: MouseEvent | TouchEvent, dayIndex: number) => void;
+    handleCreateStart: (e: MouseEvent | TouchEvent, ...args: (Date | number)[]) => void;
+    handleMoveStart: (e: MouseEvent | TouchEvent, event: Event) => void;
+    handleResizeStart: (e: MouseEvent | TouchEvent, event: Event, direction: string) => void;
     dragState: MonthDragState | WeekDayDragState;
     isDragging: boolean;
     pixelYToHour?: (y: number) => number;
@@ -870,6 +759,63 @@ interface useDragReturn {
  * Month view event drag state (alias for MonthDragState, maintains backward compatibility)
  */
 type MonthEventDragState = MonthDragState;
+/**
+ * Drag state Hook return value
+ */
+interface UseDragStateReturn {
+    dragRef: RefObject<UnifiedDragRef>;
+    currentDragRef: RefObject<{
+        x: number;
+        y: number;
+    }>;
+    dragState: MonthDragState | WeekDayDragState;
+    setDragState: (val: MonthDragState | WeekDayDragState | ((prev: MonthDragState | WeekDayDragState) => MonthDragState | WeekDayDragState)) => void;
+    resetDragState: () => void;
+    throttledSetEvents: (updateFunc: (events: Event[]) => Event[], dragState?: string) => void;
+}
+/**
+ * Drag common utilities Hook return value
+ */
+interface UseDragCommonReturn {
+    pixelYToHour: (y: number) => number;
+    getColumnDayIndex: (x: number) => number;
+    checkIfInAllDayArea: (clientY: number) => boolean;
+    handleDirectScroll: (clientY: number) => void;
+    daysDifference: (date1: Date, date2: Date) => number;
+    addDaysToDate: (date: Date, days: number) => Date;
+    getTargetDateFromPosition: (clientX: number, clientY: number) => Date | null;
+    ONE_DAY_MS: number;
+}
+/**
+ * Drag management Hook return value
+ */
+interface UseDragManagerReturn {
+    dragIndicatorRef: RefObject<HTMLDivElement | null>;
+    removeDragIndicator: () => void;
+    createDragIndicator: (drag: UnifiedDragRef, color?: string, title?: string, layout?: EventLayout | null, sourceElement?: HTMLElement) => void;
+    updateDragIndicator: (...args: (number | boolean | EventLayout | null | undefined)[]) => void;
+}
+/**
+ * Drag handler Hook return value
+ */
+interface UseDragHandlersReturn {
+    handleDragMove: (e: MouseEvent | TouchEvent) => void;
+    handleDragEnd: (e: MouseEvent | TouchEvent) => void;
+    handleCreateStart: (e: MouseEvent | TouchEvent, ...args: (Date | number)[]) => void;
+    handleMoveStart: (e: MouseEvent | TouchEvent, event: Event) => void;
+    handleResizeStart: (e: MouseEvent | TouchEvent, event: Event, direction: string) => void;
+    handleUniversalDragMove: (e: MouseEvent | TouchEvent) => void;
+    handleUniversalDragEnd: (e?: MouseEvent | TouchEvent) => void;
+}
+/**
+ * Drag handler Hook parameters
+ */
+interface UseDragHandlersParams {
+    options: useDragProps;
+    common: UseDragCommonReturn;
+    state: UseDragStateReturn;
+    manager: UseDragManagerReturn;
+}
 interface UseMonthDragReturn {
     daysDifference: (date1: Date, date2: Date) => number;
     addDaysToDate: (date: Date, days: number) => Date;
@@ -882,7 +828,7 @@ interface UseMonthDragParams {
     manager: UseDragManagerReturn;
 }
 interface UseWeekDayDragReturn {
-    handleCreateAllDayEvent: (e: any, dayIndex: number) => void;
+    handleCreateAllDayEvent: (e: MouseEvent | TouchEvent, dayIndex: number) => void;
     pixelYToHour: (y: number) => number;
     getColumnDayIndex: (x: number) => number;
 }
@@ -901,6 +847,7 @@ interface UseVirtualMonthScrollProps {
     onCurrentMonthChange?: (month: string, year: number) => void;
     initialWeeksToLoad?: number;
     locale?: string;
+    startOfWeek?: number;
     isEnabled?: boolean;
 }
 interface UseVirtualMonthScrollReturn {
@@ -915,17 +862,17 @@ interface UseVirtualMonthScrollReturn {
         visibleItems: VirtualWeekItem[];
         displayStartIndex: number;
     };
-    scrollElementRef: any;
-    handleScroll: (e: any) => void;
+    scrollElementRef: RefObject<HTMLDivElement>;
+    handleScroll: (e: JSX.TargetedEvent<HTMLDivElement, globalThis.Event>) => void;
     scrollToDate: (targetDate: Date, smooth?: boolean) => void;
     handlePreviousMonth: () => void;
     handleNextMonth: () => void;
     handleToday: () => void;
-    setScrollTop: React.Dispatch<React.SetStateAction<number>>;
-    setContainerHeight: React.Dispatch<React.SetStateAction<number>>;
-    setCurrentMonth: React.Dispatch<React.SetStateAction<string>>;
-    setCurrentYear: React.Dispatch<React.SetStateAction<number>>;
-    setIsScrolling: React.Dispatch<React.SetStateAction<boolean>>;
+    setScrollTop: (val: number | ((prev: number) => number)) => void;
+    setContainerHeight: (val: number | ((prev: number) => number)) => void;
+    setCurrentMonth: (val: string | ((prev: string) => string)) => void;
+    setCurrentYear: (val: number | ((prev: number) => number)) => void;
+    setIsScrolling: (val: boolean | ((prev: boolean) => boolean)) => void;
     cache: WeekDataCache;
     scrollElementRefCallback: (element: HTMLDivElement | null) => void;
     weeksData: WeeksData[];
@@ -953,7 +900,7 @@ declare class WeekDataCache {
     private accessOrder;
     private maxSize;
     constructor(maxSize?: number);
-    private getKey;
+    private static getKey;
     get(weekStartDate: Date): WeeksData | undefined;
     set(weekStartDate: Date, data: WeeksData): void;
     private updateAccessOrder;
@@ -970,15 +917,15 @@ interface EventDetailPanelProps {
     /** Panel position information */
     position: EventDetailPosition;
     /** Panel DOM reference */
-    panelRef: any;
+    panelRef: RefObject<HTMLDivElement>;
     /** Whether the event is all-day */
     isAllDay: boolean;
     /** Event visibility state */
     eventVisibility: 'visible' | 'sticky-top' | 'sticky-bottom';
     /** Calendar container reference */
-    calendarRef: any;
+    calendarRef: RefObject<HTMLDivElement>;
     /** Selected event element reference */
-    selectedEventElementRef: any;
+    selectedEventElementRef: RefObject<HTMLElement | null>;
     /** Event update callback */
     onEventUpdate: (updatedEvent: Event) => void;
     /** Event delete callback */
@@ -989,7 +936,7 @@ interface EventDetailPanelProps {
 /**
  * Custom event detail panel renderer (full panel including positioning and styling)
  */
-type EventDetailPanelRenderer = any;
+type EventDetailPanelRenderer = AnyComponent<EventDetailPanelProps, any>;
 /**
  * Event detail content Props (excluding panel container, content only)
  */
@@ -1004,11 +951,12 @@ interface EventDetailContentProps {
     onEventDelete: (eventId: string) => void;
     /** Close panel callback (optional) */
     onClose?: () => void;
+    app?: ICalendarApp;
 }
 /**
  * Custom event detail content renderer (content only, will be wrapped in default panel)
  */
-type EventDetailContentRenderer = any;
+type EventDetailContentRenderer = AnyComponent<EventDetailContentProps, any>;
 /**
  * Event detail dialog Props
  */
@@ -1030,13 +978,146 @@ interface EventDetailDialogProps {
 /**
  * Custom event detail dialog renderer (Dialog/Modal mode)
  */
-type EventDetailDialogRenderer = any;
+type EventDetailDialogRenderer = AnyComponent<EventDetailDialogProps, any>;
+
+/**
+ * Common IANA TimeZone identifiers.
+ * This enum provides a convenient way for users to specify secondary timezones
+ * without having to look up the exact Temporal/Intl TimeZone strings.
+ */
+declare enum TimeZone {
+    UTC = "UTC",
+    NEW_YORK = "America/New_York",
+    CHICAGO = "America/Chicago",
+    DENVER = "America/Denver",
+    LOS_ANGELES = "America/Los_Angeles",
+    TORONTO = "America/Toronto",
+    VANCOUVER = "America/Vancouver",
+    PHOENIX = "America/Phoenix",
+    ANCHORAGE = "America/Anchorage",
+    HONOLULU = "Pacific/Honolulu",
+    MEXICO_CITY = "America/Mexico_City",
+    WINNIPEG = "America/Winnipeg",
+    HALIFAX = "America/Halifax",
+    ST_JOHNS = "America/St_Johns",
+    DETROIT = "America/Detroit",
+    MIAMI = "America/Miami",
+    SEATTLE = "America/Los_Angeles",
+    ATLANTA = "America/New_York",
+    DALLAS = "America/Chicago",
+    HOUSTON = "America/Chicago",
+    LAS_VEGAS = "America/Los_Angeles",
+    SAN_FRANCISCO = "America/Los_Angeles",
+    LONDON = "Europe/London",
+    PARIS = "Europe/Paris",
+    BERLIN = "Europe/Berlin",
+    MADRID = "Europe/Madrid",
+    ROME = "Europe/Rome",
+    AMSTERDAM = "Europe/Amsterdam",
+    ZURICH = "Europe/Zurich",
+    STOCKHOLM = "Europe/Stockholm",
+    OSLO = "Europe/Oslo",
+    COPENHAGEN = "Europe/Copenhagen",
+    MOSCOW = "Europe/Moscow",
+    ISTANBUL = "Europe/Istanbul",
+    DUBLIN = "Europe/Dublin",
+    LISBON = "Europe/Lisbon",
+    PRAGUE = "Europe/Prague",
+    VIENNA = "Europe/Vienna",
+    WARSAW = "Europe/Warsaw",
+    BRUSSELS = "Europe/Brussels",
+    ATHENS = "Europe/Athens",
+    BUCHAREST = "Europe/Bucharest",
+    HELSINKI = "Europe/Helsinki",
+    KYIV = "Europe/Kyiv",
+    BUDAPEST = "Europe/Budapest",
+    BELGRADE = "Europe/Belgrade",
+    LUXEMBOURG = "Europe/Luxembourg",
+    MONACO = "Europe/Monaco",
+    REYKJAVIK = "Atlantic/Reykjavik",
+    TOKYO = "Asia/Tokyo",
+    SHANGHAI = "Asia/Shanghai",
+    BEIJING = "Asia/Shanghai",
+    HONG_KONG = "Asia/Hong_Kong",
+    TAIPEI = "Asia/Taipei",
+    SEOUL = "Asia/Seoul",
+    SINGAPORE = "Asia/Singapore",
+    HANOI = "Asia/Ho_Chi_Minh",
+    BANGKOK = "Asia/Bangkok",
+    JAKARTA = "Asia/Jakarta",
+    KUALA_LUMPUR = "Asia/Kuala_Lumpur",
+    MANILA = "Asia/Manila",
+    DUBAI = "Asia/Dubai",
+    KOLKATA = "Asia/Kolkata",
+    MUMBAI = "Asia/Kolkata",
+    RIYADH = "Asia/Riyadh",
+    TEHRAN = "Asia/Tehran",
+    JERUSALEM = "Asia/Jerusalem",
+    TEL_AVIV = "Asia/Tel_Aviv",
+    BAGHDAD = "Asia/Baghdad",
+    DHAKA = "Asia/Dhaka",
+    KARA_CHI = "Asia/Karachi",
+    KABUL = "Asia/Kabul",
+    KATHMANDU = "Asia/Kathmandu",
+    COLOMBO = "Asia/Colombo",
+    TASHKENT = "Asia/Tashkent",
+    ALMATY = "Asia/Almaty",
+    PHNOM_PENH = "Asia/Phnom_Penh",
+    VIENTIANE = "Asia/Vientiane",
+    MUSCAT = "Asia/Muscat",
+    SYDNEY = "Australia/Sydney",
+    MELBOURNE = "Australia/Melbourne",
+    BRISBANE = "Australia/Brisbane",
+    PERTH = "Australia/Perth",
+    ADELAIDE = "Australia/Adelaide",
+    DARWIN = "Australia/Darwin",
+    HOBART = "Australia/Hobart",
+    AUCKLAND = "Pacific/Auckland",
+    FIJI = "Pacific/Fiji",
+    GUAM = "Pacific/Guam",
+    NOUMEA = "Pacific/Noumea",
+    PAGO_PAGO = "Pacific/Pago_Pago",
+    PORT_MORESBY = "Pacific/Port_Moresby",
+    SAO_PAULO = "America/Sao_Paulo",
+    RIO_DE_JANEIRO = "America/Sao_Paulo",
+    BUENOS_AIRES = "America/Argentina/Buenos_Aires",
+    SANTIAGO = "America/Santiago",
+    LIMA = "America/Lima",
+    BOGOTA = "America/Bogota",
+    CARACAS = "America/Caracas",
+    LA_PAZ = "America/La_Paz",
+    MONTEVIDEO = "America/Montevideo",
+    QUITO = "America/Quito",
+    ASUNCION = "America/Asuncion",
+    GEORGETOWN = "America/Guyana",
+    CAIRO = "Africa/Cairo",
+    JOHANNESBURG = "Africa/Johannesburg",
+    LAGOS = "Africa/Lagos",
+    NAIROBI = "Africa/Nairobi",
+    CASABLANCA = "Africa/Casablanca",
+    ALGIERS = "Africa/Algiers",
+    TUNIS = "Africa/Tunis",
+    ADDIS_ABABA = "Africa/Addis_Ababa",
+    ACCRA = "Africa/Accra",
+    DAKAR = "Africa/Dakar",
+    LUANDA = "Africa/Luanda",
+    ANTANANARIVO = "Indian/Antananarivo",
+    KINSHASA = "Africa/Kinshasa",
+    DAR_ES_SALAAM = "Africa/Dar_es_Salaam",
+    MCMURDO = "Antarctica/McMurdo",
+    CASEY = "Antarctica/Casey"
+}
+/**
+ * Type helper for secondaryTimeZone configuration
+ * Allows using either the TimeZone enum or a raw IANA string.
+ */
+type TimeZoneValue = TimeZone | string;
 
 /**
  * Common Props interface for view components
  * Base properties for all view components
  */
-interface BaseViewProps<TConfig = any> {
+interface BaseViewProps<TConfig = unknown> {
     app: ICalendarApp;
     currentDate?: Date;
     currentView?: ViewType;
@@ -1053,57 +1134,44 @@ interface BaseViewProps<TConfig = any> {
     onDetailPanelToggle?: (eventId: string | null) => void;
     customDetailPanelContent?: EventDetailContentRenderer;
     customEventDetailDialog?: EventDetailDialogRenderer;
-    calendarRef: any;
+    calendarRef: RefObject<HTMLDivElement>;
     switcherMode?: ViewSwitcherMode;
-    meta?: Record<string, any>;
+    meta?: Record<string, unknown>;
 }
 /**
  * Day view specific Props
  */
-interface DayViewProps extends BaseViewProps<DayViewConfig> {
-}
+type DayViewProps = BaseViewProps<DayViewConfig>;
 /**
  * Week view specific Props
  */
-interface WeekViewProps extends BaseViewProps<WeekViewConfig> {
-}
+type WeekViewProps = BaseViewProps<WeekViewConfig>;
 /**
  * Month view specific Props
  */
-interface MonthViewProps extends BaseViewProps<MonthViewConfig> {
-}
+type MonthViewProps = BaseViewProps<MonthViewConfig>;
 /**
  * Year view specific Props
  */
-interface YearViewProps extends BaseViewProps<YearViewConfig> {
-}
+type YearViewProps = BaseViewProps<YearViewConfig>;
 /**
  * View factory configuration interface
  * Base configuration for creating views
  */
 interface ViewFactoryConfig {
-    enableDrag?: boolean;
-    enableResize?: boolean;
-    enableCreate?: boolean;
-    dragConfig?: Record<string, any>;
-    eventsConfig?: Record<string, any>;
-    virtualScrollConfig?: Record<string, any>;
-    viewConfig?: Record<string, any>;
+    hourHeight?: number;
+    firstHour?: number;
+    lastHour?: number;
+    allDayHeight?: number;
+    timeFormat?: '12h' | '24h';
 }
 /**
  * Day view factory configuration
  */
 interface DayViewConfig extends ViewFactoryConfig {
-    showMiniCalendar?: boolean;
     showAllDay?: boolean;
     scrollToCurrentTime?: boolean;
-    hourHeight?: number;
-    firstHour?: number;
-    lastHour?: number;
-    HOUR_HEIGHT?: number;
-    FIRST_HOUR?: number;
-    LAST_HOUR?: number;
-    ALL_DAY_HEIGHT?: number;
+    secondaryTimeZone?: TimeZoneValue;
 }
 /**
  * Week view factory configuration
@@ -1113,32 +1181,23 @@ interface WeekViewConfig extends ViewFactoryConfig {
     showAllDay?: boolean;
     startOfWeek?: number;
     scrollToCurrentTime?: boolean;
-    hourHeight?: number;
-    firstHour?: number;
-    lastHour?: number;
-    HOUR_HEIGHT?: number;
-    FIRST_HOUR?: number;
-    LAST_HOUR?: number;
-    ALL_DAY_HEIGHT?: number;
+    secondaryTimeZone?: TimeZoneValue;
 }
 /**
  * Month view factory configuration
  */
 interface MonthViewConfig extends ViewFactoryConfig {
-    showOtherMonth?: boolean;
-    weekHeight?: number;
     showWeekNumbers?: boolean;
-    enableVirtualScroll?: boolean;
-    initialWeeksToLoad?: number;
+    showMonthIndicator?: boolean;
+    startOfWeek?: number;
 }
 /**
  * Year view factory configuration
  */
 interface YearViewConfig extends ViewFactoryConfig {
-    enableVirtualScroll?: boolean;
-    showDebugInfo?: boolean;
     mode?: 'year-canvas' | 'fixed-week';
     showTimedEventsInYearView?: boolean;
+    startOfWeek?: number;
 }
 /**
  * View adapter Props
@@ -1146,7 +1205,7 @@ interface YearViewConfig extends ViewFactoryConfig {
  */
 interface ViewAdapterProps extends BaseViewProps {
     viewType: ViewType;
-    originalComponent: any;
+    originalComponent: AnyComponent<any, any>;
     config: ViewFactoryConfig;
     className?: string;
 }
@@ -1157,8 +1216,8 @@ interface ViewAdapterProps extends BaseViewProps {
 interface DragIntegrationProps {
     app: ICalendarApp;
     viewType: ViewType;
-    calendarRef: any;
-    allDayRowRef?: any;
+    calendarRef: RefObject<HTMLDivElement>;
+    allDayRowRef?: RefObject<HTMLDivElement>;
     events: Event[];
     onEventsUpdate: (updateFunc: (events: Event[]) => Event[]) => void;
     onEventCreate: (event: Event) => void;
@@ -1235,10 +1294,10 @@ interface EventsPluginConfig {
  * Drag Hook options
  */
 interface DragHookOptions extends Partial<DragConfig> {
-    calendarRef: any;
-    allDayRowRef?: any;
+    calendarRef: unknown;
+    allDayRowRef?: unknown;
     viewType: ViewType;
-    onEventsUpdate: (updateFunc: (events: Event[]) => Event[], isResizing?: boolean) => void;
+    onEventsUpdate: (updateFunc: (events: Event[]) => Event[], isResizing?: boolean, source?: 'drag' | 'resize') => void;
     onEventCreate: (event: Event) => void;
     onEventEdit: (event: Event) => void;
     currentWeekStart: Date;
@@ -1246,15 +1305,18 @@ interface DragHookOptions extends Partial<DragConfig> {
     calculateNewEventLayout?: (dayIndex: number, startHour: number, endHour: number) => EventLayout | null;
     calculateDragLayout?: (event: Event, targetDay: number, targetStartHour: number, targetEndHour: number) => EventLayout | null;
     isMobile?: boolean;
+    timeGridRef?: unknown;
+    gridWidth?: string;
+    displayDays?: number;
 }
 /**
  * Drag Hook return value
  */
 interface DragHookReturn {
-    handleMoveStart?: (e: any | any, event: Event) => void;
-    handleCreateStart?: (e: any | any, ...args: (Date | number)[]) => void;
-    handleResizeStart?: (e: any | any, event: Event, direction: string) => void;
-    handleCreateAllDayEvent?: (e: any, dayIndex: number) => void;
+    handleMoveStart?: (e: unknown, event: Event) => void;
+    handleCreateStart?: (e: unknown, ...args: (Date | number)[]) => void;
+    handleResizeStart?: (e: unknown, event: Event, direction: string) => void;
+    handleCreateAllDayEvent?: (e: unknown, dayIndex: number) => void;
     dragState: MonthDragState | WeekDayDragState;
     isDragging: boolean;
 }
@@ -1267,6 +1329,8 @@ interface DragPluginConfig {
     enableCreate: boolean;
     enableAllDayCreate: boolean;
     supportedViews: ViewType[];
+    onEventDrop?: (updatedEvent: Event, originalEvent: Event) => void | Promise<void>;
+    onEventResize?: (updatedEvent: Event, originalEvent: Event) => void | Promise<void>;
     [key: string]: unknown;
 }
 /**
@@ -1279,6 +1343,71 @@ interface DragService {
     isViewSupported: (viewType: ViewType) => boolean;
 }
 
+/**
+ * Virtual scroll item interface (YearView)
+ */
+interface VirtualItem {
+    index: number;
+    year: number;
+    top: number;
+    height: number;
+}
+/**
+ * Virtual scroll Hook parameters interface (YearView)
+ */
+interface UseVirtualScrollProps {
+    currentDate: Date;
+    yearHeight: number;
+    onCurrentYearChange?: (year: number) => void;
+}
+
+/**
+ * Virtual scroll item interface (YearView)
+ */
+/**
+ * Virtual scroll Hook return value interface (YearView)
+ */
+interface UseVirtualScrollReturn {
+    scrollTop: number;
+    containerHeight: number;
+    currentYear: number;
+    isScrolling: boolean;
+    virtualData: {
+        totalHeight: number;
+        visibleItems: VirtualItem[];
+    };
+    scrollElementRef: RefObject<HTMLDivElement>;
+    handleScroll: (e: JSX.TargetedEvent<HTMLDivElement, globalThis.Event>) => void;
+    scrollToYear: (targetYear: number, smooth?: boolean) => void;
+    handlePreviousYear: () => void;
+    handleNextYear: () => void;
+    handleToday: () => void;
+    setScrollTop: (val: number | ((prev: number) => number)) => void;
+    setContainerHeight: (val: number | ((prev: number) => number)) => void;
+    setCurrentYear: (val: number | ((prev: number) => number)) => void;
+    setIsScrolling: (val: boolean | ((prev: boolean) => boolean)) => void;
+}
+
+/**
+ * Mobile event drawer/dialog Props
+ */
+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;
+    /** 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 */
+    app: ICalendarApp;
+    /** Time format for event display */
+    timeFormat?: '12h' | '24h';
+}
+
 declare class CalendarApp implements ICalendarApp {
     state: CalendarAppState;
     private callbacks;
@@ -1292,10 +1421,11 @@ declare class CalendarApp implements ICalendarApp {
     private listeners;
     private undoStack;
     private pendingSnapshot;
+    private pendingChangeSource;
     private readonly MAX_UNDO_STACK;
     constructor(config: CalendarAppConfig);
     private setupStoreListeners;
-    private resolveLocale;
+    private static resolveLocale;
     subscribe: (listener: (app: ICalendarApp) => void) => (() => void);
     private notify;
     private pushToUndo;
@@ -1325,9 +1455,9 @@ declare class CalendarApp implements ICalendarApp {
             updates: Partial<Event>;
         }>;
         delete?: string[];
-    }, isPending?: boolean) => void;
+    }, isPending?: boolean, source?: "drag" | "resize") => void;
     addEvent: (event: Event) => void;
-    updateEvent: (id: string, eventUpdate: Partial<Event>, isPending?: boolean) => void;
+    updateEvent: (id: string, eventUpdate: Partial<Event>, isPending?: boolean, source?: "drag" | "resize") => void;
     deleteEvent: (id: string) => void;
     getAllEvents: () => Event[];
     onEventClick: (event: Event) => void;
@@ -1344,7 +1474,7 @@ declare class CalendarApp implements ICalendarApp {
     createCalendar: (calendar: CalendarType) => void;
     deleteCalendar: (id: string) => void;
     mergeCalendars: (sourceId: string, targetId: string) => void;
-    getCalendarHeaderConfig: () => boolean | ((props: any) => TNode);
+    getCalendarHeaderConfig: () => boolean | ((props: CalendarHeaderProps) => TNode);
     private installPlugin;
     getPlugin: <T = unknown>(name: string) => T | undefined;
     hasPlugin: (name: string) => boolean;
@@ -1383,7 +1513,7 @@ interface CustomRendering {
     id: string;
     containerEl: HTMLElement;
     generatorName: string;
-    generatorArgs: any;
+    generatorArgs: unknown;
 }
 type CustomRenderingListener = (map: Map<string, CustomRendering>) => void;
 declare class CustomRenderingStore {
@@ -1425,7 +1555,7 @@ declare class CalendarRenderer {
     private renderRequested;
     private extraProps;
     constructor(app: ICalendarApp, initialOverrides?: string[]);
-    setProps(props: Record<string, any>): void;
+    setProps(props: Record<string, unknown>): void;
     private requestRender;
     /**
      * Mount the calendar to a DOM container.
@@ -1474,6 +1604,12 @@ declare const getStartOfDay: (dateTime: Date | Temporal.PlainDate | Temporal.Pla
  * @returns End of day
  */
 declare const getEndOfDay: (dateTime: Date | Temporal.PlainDate | Temporal.PlainDateTime | Temporal.ZonedDateTime) => Date | Temporal.ZonedDateTime;
+/**
+ * Get the ISO week number for a given date
+ * @param date Date object
+ * @returns Week number (1-53)
+ */
+declare const getWeekNumber: (date: Date) => number;
 /**
  * Check if two dates are on the same day
  * @param date1 Date 1
@@ -1529,18 +1665,29 @@ declare const getLineColor: (calendarIdOrColor: string, registry?: CalendarRegis
  */
 declare const TIME_STEP = 0.25;
 /**
- * Format hours and minutes to HH:MM format
+ * Format hours and minutes to HH:MM format or 12h format (e.g. 1AM)
  * @param hours Hour number (supports decimals, e.g., 14.5 = 14:30)
  * @param minutes Optional minutes (if not provided, extracted from decimal hours)
- * @returns Formatted time string (e.g., "14:30")
+ * @param format Time format ('12h' or '24h', defaults to '24h')
+ * @param showUnits Whether to show AM/PM for 12h format (defaults to true)
+ * @returns Formatted time string (e.g., "14:30" or "2PM")
  */
-declare const formatTime: (hours: number, minutes?: number) => string;
+declare const formatTime: (hours: number, minutes?: number, format?: "12h" | "24h", showUnits?: boolean) => string;
+/**
+ * Get event end hour (handles cross-day events less than 24 hours)
+ * When an event ends exactly at midnight of the next day and duration is less than 24 hours,
+ * it should be treated as 24:00 of the current day in week/day views to avoid displaying as next day 00:00.
+ * @param event Event object
+ * @returns End hour (0-24)
+ */
+declare const getEventEndHour: (event: Event) => number;
 /**
  * Format event time range as a string
  * @param event Event object
+ * @param format Time format ('12h' or '24h', defaults to '24h')
  * @returns Formatted time range (e.g., "14:00 - 16:00" or "All day")
  */
-declare const formatEventTimeRange: (event: Event) => string;
+declare const formatEventTimeRange: (event: Event, format?: "12h" | "24h") => string;
 /**
  * Round hour to nearest time step
  * @param hour Hour number
@@ -1548,13 +1695,27 @@ declare const formatEventTimeRange: (event: Event) => string;
  */
 declare const roundToTimeStep: (hour: number) => number;
 /**
- * Get event end hour (handles cross-day events less than 24 hours)
- * When an event ends exactly at midnight of the next day and duration is less than 24 hours,
- * it should be treated as 24:00 of the current day in week/day views to avoid displaying as next day 00:00.
- * @param event Event object
- * @returns End hour (0-24)
+ * Generate secondary timezone time labels for each primary time slot.
+ * Uses Temporal to correctly handle DST and timezone conversions.
+ *
+ * @param timeSlots Primary time slots array
+ * @param secondaryTimeZone Secondary IANA timezone identifier
+ * @param timeFormat Time format ('12h' or '24h')
+ * @param referenceDate Reference date used for DST-accurate conversion (defaults to today)
+ * @returns Array of formatted time strings for the secondary timezone
+ */
+declare const generateSecondaryTimeSlots: (timeSlots: Array<{
+    hour: number;
+    label: string;
+}>, secondaryTimeZone: TimeZoneValue, timeFormat?: "12h" | "24h", referenceDate?: Date) => string[];
+/**
+ * Get a short display label for a timezone, e.g. "CST" or "GMT+8".
+ *
+ * @param timeZone IANA timezone identifier
+ * @param date Reference date for DST-aware abbreviation (defaults to today)
+ * @returns Short timezone label
  */
-declare const getEventEndHour: (event: Event) => number;
+declare const getTimezoneDisplayLabel: (timeZone: TimeZoneValue, date?: Date) => string;
 
 /**
  * Date Constants
@@ -1586,19 +1747,21 @@ declare const shortMonthNames: string[];
  * for week-based operations (Monday-Sunday).
  */
 /**
- * Get the Monday-Sunday range for a given date
+ * Get the week range for a given date
  * @param date Input date
- * @returns Object with monday and sunday dates
+ * @param startOfWeek Week start day (0: Sunday, 1: Monday, etc.)
+ * @returns Object with monday and sunday dates (monday and sunday here are just start/end of week)
  */
-declare const getWeekRange: (date: Date) => {
+declare const getWeekRange: (date: Date, startOfWeek?: number) => {
     monday: Date;
     sunday: Date;
 };
 /**
- * Get current week dates (Monday-Sunday) with today indicator
+ * Get current week dates with today indicator
+ * @param startOfWeek Week start day (0: Sun, 1: Mon, etc.)
  * @returns Array of 7 date objects with date, month, and isToday flag
  */
-declare const getCurrentWeekDates: () => {
+declare const getCurrentWeekDates: (startOfWeek?: number) => {
     date: number;
     month: string;
     isToday: boolean;
@@ -1625,6 +1788,16 @@ declare const generateDayData: (date: string | number | Date) => {
     shortMonthName: string;
     isToday: boolean;
 };
+/**
+ * Determine which month and year a week belongs to (based on majority of days)
+ * @param days Array of day data
+ * @returns Month name, month index, and year
+ */
+declare const getMonthYearOfWeek: (days: DayData[]) => {
+    month: string;
+    monthIndex: number;
+    year: number;
+};
 /**
  * Generate week data (7 days starting from given date)
  * @param startDate Week start date
@@ -1647,16 +1820,6 @@ declare const generateWeekData: (startDate: string | number | Date) => {
         year: number;
     };
 };
-/**
- * Determine which month and year a week belongs to (based on majority of days)
- * @param days Array of day data
- * @returns Month name, month index, and year
- */
-declare const getMonthYearOfWeek: (days: DayData[]) => {
-    month: string;
-    monthIndex: number;
-    year: number;
-};
 /**
  * Generate weeks data around a central date
  * @param centralDate Central date for range
@@ -1684,9 +1847,10 @@ declare const generateWeeksData: (centralDate: Date, monthsToLoad?: number) => {
  * Generate week range around a center date
  * @param centerDate Center date for range
  * @param totalWeeks Total number of weeks to generate
+ * @param startOfWeek Week start day (0: Sunday, 1: Monday, etc.)
  * @returns Array of weeks data
  */
-declare function generateWeekRange(centerDate: Date, totalWeeks: number): WeeksData[];
+declare function generateWeekRange(centerDate: Date, totalWeeks: number, startOfWeek?: number): WeeksData[];
 
 /**
  * Event Utilities
@@ -1786,13 +1950,33 @@ declare const createEventWithRealDate: (eventData: Omit<Event, "start" | "end">,
  * @returns Updated event
  */
 declare const updateEventWithRealDate: (event: Event, newDayIndex: number, weekStart: Date) => Event;
+/**
+ * Create event with PlainDateTime (default for local events)
+ * This is the recommended function for creating events without timezone complexity
+ */
+declare const createEventWithPlainDateTime: (eventData: Omit<Event, "start" | "end">, weekStart: Date) => Event;
+/**
+ * Create event with ZonedDateTime (for timezone-aware events)
+ * Use when explicit timezone control is needed
+ */
+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
  */
-declare const isEventEqual: (event1: Event | null, event2: Event | null) => boolean;
+declare const isEventDeepEqual: (event1: Event | null, event2: Event | null) => boolean;
+/**
+ * Check if event's primary fields (start, end, title) have changed.
+ * This is commonly used to determine if an event update should be persisted
+ * after a drag or resize operation.
+ *
+ * @param oldEvent Original event
+ * @param newEvent Updated event
+ * @returns Whether primary fields have changed
+ */
+declare const hasEventChanged: (oldEvent: Event, newEvent: Event) => boolean;
 
 /**
  * Test Data Generation Utilities
@@ -1825,7 +2009,7 @@ declare function generateUniKey(): string;
  * Performs a deep comparison between two values to determine if they are equivalent.
  * Supports primitives, Date objects, and plain objects/arrays.
  */
-declare function isDeepEqual(a: any, b: any): boolean;
+declare function isDeepEqual(a: unknown, b: unknown): boolean;
 
 /**
  * Format date to DD/MM/YYYY format
@@ -1852,15 +2036,15 @@ declare const formatDate: (temporal: Temporal.PlainDate | Temporal.PlainDateTime
 /**
  * Check if temporal is PlainDate (date only, no time)
  */
-declare function isPlainDate(temporal: any): temporal is Temporal.PlainDate;
+declare function isPlainDate(temporal: unknown): temporal is Temporal.PlainDate;
 /**
  * Check if temporal is PlainDateTime (date + time, no timezone)
  */
-declare function isPlainDateTime(temporal: any): temporal is Temporal.PlainDateTime;
+declare function isPlainDateTime(temporal: unknown): temporal is Temporal.PlainDateTime;
 /**
  * Check if temporal is ZonedDateTime (date + time + timezone)
  */
-declare function isZonedDateTime(temporal: any): temporal is Temporal.ZonedDateTime;
+declare function isZonedDateTime(temporal: unknown): temporal is Temporal.ZonedDateTime;
 /**
  * Convert any Temporal type or Date to Date (for internal processing)
  * Handles all three Temporal types and native Date uniformly
@@ -1897,14 +2081,14 @@ declare function extractHourFromTemporal(temporal: Temporal.PlainDate | Temporal
  * @param hour Hour with decimals (e.g., 14.5 = 14:30)
  */
 declare function setHourInTemporal(temporal: Temporal.PlainDateTime | Temporal.ZonedDateTime, hour: number): Temporal.PlainDateTime | Temporal.ZonedDateTime;
-/**
- * Check if two Temporal objects represent the same day
- */
-declare function isSameTemporal(t1: Temporal.PlainDate | Temporal.PlainDateTime | Temporal.ZonedDateTime | Date, t2: Temporal.PlainDate | Temporal.PlainDateTime | Temporal.ZonedDateTime | Date): boolean;
 /**
  * Get PlainDate from any Temporal type or Date
  */
 declare function getPlainDate(temporal: Temporal.PlainDate | Temporal.PlainDateTime | Temporal.ZonedDateTime | Date): Temporal.PlainDate;
+/**
+ * Check if two Temporal objects represent the same day
+ */
+declare function isSameTemporal(t1: Temporal.PlainDate | Temporal.PlainDateTime | Temporal.ZonedDateTime | Date, t2: Temporal.PlainDate | Temporal.PlainDateTime | Temporal.ZonedDateTime | Date): boolean;
 
 /**
  * Temporal API utility functions
@@ -1914,7 +2098,7 @@ declare function getPlainDate(temporal: Temporal.PlainDate | Temporal.PlainDateT
 /**
  * Check if value is Date object
  */
-declare function isDate(value: any): value is Date;
+declare function isDate(value: unknown): value is Date;
 /**
  * Convert Temporal.ZonedDateTime to Date
  * @param zdt Temporal.ZonedDateTime
@@ -2125,7 +2309,7 @@ interface CreateEventParams {
     end: Date | Temporal.PlainDate | Temporal.PlainDateTime;
     allDay?: boolean;
     calendarId?: string;
-    meta?: Record<string, any>;
+    meta?: Record<string, unknown>;
 }
 /**
  * Timezone event creation parameters
@@ -2139,7 +2323,7 @@ interface CreateTimezoneEventParams {
     end: Date | Temporal.ZonedDateTime;
     timeZone: string;
     calendarId?: string;
-    meta?: Record<string, any>;
+    meta?: Record<string, unknown>;
 }
 /**
  * Create local event (recommended for most use cases)
@@ -2234,7 +2418,7 @@ declare function createTimedEvent(id: string, title: string, start: Date, end: D
 declare function convertDateEvent(id: string, title: string, startDate: Date, endDate: Date, allDay?: boolean, options?: {
     description?: string;
     calendarId?: string;
-    meta?: Record<string, any>;
+    meta?: Record<string, unknown>;
 }): Event;
 /**
  * Convert legacy Date-based event to timezone-aware event
@@ -2243,12 +2427,12 @@ declare function convertDateEvent(id: string, title: string, startDate: Date, en
 declare function convertDateEventWithTimeZone(id: string, title: string, startDate: Date, endDate: Date, timeZone: string, options?: {
     description?: string;
     calendarId?: string;
-    meta?: Record<string, any>;
+    meta?: Record<string, unknown>;
 }): Event;
 
 type CalendarSearchEvent = Event & {
     color?: string;
-    [key: string]: any;
+    [key: string]: unknown;
 };
 
 /**
@@ -2256,7 +2440,7 @@ type CalendarSearchEvent = Event & {
  * @param dateInput Date, string, or Temporal object
  * @returns Date object
  */
-declare const getDateObj: (dateInput: any) => Date;
+declare const getDateObj: (dateInput: unknown) => Date;
 /**
  * Helper to normalize date (reset time to 00:00:00)
  * @param date Date object
@@ -2271,7 +2455,7 @@ declare const normalizeDate: (date: Date) => Date;
  * @param t Translation function
  * @returns Object with title and colorClass
  */
-declare const getSearchHeaderInfo: (groupDate: Date, today: Date, locale: string, t: (key: any) => string) => {
+declare const getSearchHeaderInfo: (groupDate: Date, today: Date, locale: string, t: (key: TranslationKey) => string) => {
     title: string;
     colorClass: string;
 };
@@ -2388,17 +2572,9 @@ interface ICSParseError {
 }
 
 /**
- * ICS Date Utilities
- *
- * Convert between ICS date formats (RFC 5545) and Temporal API types.
- *
- * ICS Date Formats:
- * 1. DATE (all-day): YYYYMMDD (e.g., 20250115)
- * 2. DATE-TIME (local): YYYYMMDDTHHMMSS (e.g., 20250115T143000)
- * 3. DATE-TIME (UTC): YYYYMMDDTHHMMSSZ (e.g., 20250115T143000Z)
- * 4. DATE-TIME (with TZID): DTSTART;TZID=America/New_York:20250115T143000
+ * Pad number to 2 digits
  */
-
+declare function pad2(num: number | string): string;
 /**
  * Parse ICS date string to Temporal type
  *
@@ -2423,6 +2599,14 @@ declare function formatICSDate(temporal: Temporal.PlainDate | Temporal.PlainDate
  * Format a Date to ICS timestamp (UTC format for DTSTAMP)
  */
 declare function formatDateToICSTimestamp(date: Date): string;
+declare function escapeICSValue(value: string): string;
+declare function unescapeICSValue(value: string): string;
+declare function foldLine(line: string): string;
+declare function formatProperty(name: string, value: string, params?: Record<string, string>): string;
+declare function generateVEvent(event: Event): string[];
+declare function extractVEvents(lines: string[]): string[][];
+declare function parseVEventLines(lines: string[]): ICSVEvent;
+declare function convertToDayFlowEvent(icsEvent: ICSVEvent, options: ICSImportOptions): Event;
 
 /**
  * ICS Parser
@@ -2494,9 +2678,9 @@ declare function getIntlLabel(key: 'today' | 'day' | 'week' | 'month' | 'year',
  */
 declare function capitalize(str: string): string;
 /**
- * Get localized weekday labels (Mon, Tue, etc.)
+ * Get localized weekday labels starting from startOfWeek (0: Sun, 1: Mon, etc.)
  */
-declare const getWeekDaysLabels: (locale: string, format?: "long" | "short" | "narrow") => string[];
+declare const getWeekDaysLabels: (locale: string, format?: "long" | "short" | "narrow", startOfWeek?: number) => string[];
 /**
  * Get localized month labels
  */
@@ -2531,7 +2715,7 @@ declare function isValidLocale(locale: string): boolean;
 interface LocaleContextValue {
     locale: LocaleCode;
     t: (key: TranslationKey, vars?: Record<string, string>) => string;
-    getWeekDaysLabels: (locale: string, format?: 'long' | 'short' | 'narrow') => string[];
+    getWeekDaysLabels: (locale: string, format?: 'long' | 'short' | 'narrow', startOfWeek?: number) => string[];
     getMonthLabels: (locale: string, format?: 'long' | 'short' | 'narrow' | 'numeric' | '2-digit') => string[];
     isDefault?: boolean;
 }
@@ -2545,7 +2729,7 @@ declare function useLocale(): LocaleContextValue;
 interface LocaleProviderProps {
     locale?: LocaleCode | Locale;
     messages?: LocaleMessages;
-    children?: any;
+    children?: ComponentChildren;
 }
 declare const LocaleProvider: ({ locale, messages, children, }: LocaleProviderProps) => preact.JSX.Element;
 
@@ -2587,7 +2771,7 @@ interface ContextMenuProps {
     x: number;
     y: number;
     onClose: () => void;
-    children: any;
+    children: ComponentChildren;
     className?: string;
 }
 declare const ContextMenu: preact.FunctionalComponent<preact_compat.PropsWithoutRef<ContextMenuProps> & {
@@ -2595,18 +2779,20 @@ declare const ContextMenu: preact.FunctionalComponent<preact_compat.PropsWithout
 }>;
 declare const ContextMenuItem: ({ onClick, children, icon, danger, disabled, }: {
     onClick: () => void;
-    children: any;
-    icon?: any;
+    children: ComponentChildren;
+    icon?: ComponentChildren;
     danger?: boolean;
     disabled?: boolean;
-}) => h.JSX.Element;
-declare const ContextMenuSeparator: () => h.JSX.Element;
-declare const ContextMenuLabel: any;
+}) => preact.JSX.Element;
+declare const ContextMenuSeparator: () => preact.JSX.Element;
+declare const ContextMenuLabel: ({ children, }: {
+    children: ComponentChildren;
+}) => preact.JSX.Element;
 declare const ContextMenuColorPicker: ({ selectedColor, onSelect, onCustomColor, }: {
     selectedColor?: string;
     onSelect: (color: string) => void;
     onCustomColor?: () => void;
-}) => h.JSX.Element;
+}) => preact.JSX.Element;
 
 interface BlossomColorPickerProps extends Partial<BlossomColorPickerOptions> {
     className?: string;
@@ -2619,7 +2805,7 @@ interface DefaultColorPickerProps {
         hex: string;
     }, isPending?: boolean) => void;
     onClose?: () => void;
-    [key: string]: any;
+    [key: string]: unknown;
 }
 declare const DefaultColorPicker: ({ color, onChange, onClose, }: DefaultColorPickerProps) => preact.JSX.Element;
 
@@ -2637,9 +2823,9 @@ declare const CreateCalendarDialog: ({ onClose, onCreate, colorPickerMode, }: Cr
 
 interface ContentSlotProps {
     generatorName: string;
-    generatorArgs?: any;
-    defaultContent?: any;
-    store?: any;
+    generatorArgs?: unknown;
+    defaultContent?: ComponentChildren;
+    store?: CustomRenderingStore | null;
 }
 /**
  * Preact component: Creates a placeholder <div> and registers it with CustomRenderingStore.
@@ -2685,5 +2871,5 @@ 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, 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 };
+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 };