@dayflow/core 2.0.6 → 3.0.0

package/dist/types/hook.d.ts

@@ -1,103 +0,0 @@
-import React from 'react';
-import { Root } from 'react-dom/client';
-import { Event } from './event';
-import { EventLayout } from './layout';
-import { UnifiedDragRef, MonthDragState, WeekDayDragState, useDragProps } from './dragIndicator';
-/**
- * Virtual scroll item interface (YearView)
- */
-export interface VirtualItem {
-    index: number;
-    year: number;
-    top: number;
-    height: number;
-}
-/**
- * Virtual scroll Hook parameters interface (YearView)
- */
-export interface UseVirtualScrollProps {
-    currentDate: Date;
-    yearHeight: number;
-    onCurrentYearChange?: (year: number) => void;
-}
-/**
- * Virtual scroll Hook return value interface (YearView)
- */
-export interface UseVirtualScrollReturn {
-    scrollTop: number;
-    containerHeight: number;
-    currentYear: number;
-    isScrolling: boolean;
-    virtualData: {
-        totalHeight: number;
-        visibleItems: VirtualItem[];
-    };
-    scrollElementRef: React.RefObject<HTMLDivElement>;
-    handleScroll: (e: React.UIEvent<HTMLDivElement>) => void;
-    scrollToYear: (targetYear: number, smooth?: boolean) => void;
-    handlePreviousYear: () => void;
-    handleNextYear: () => void;
-    handleToday: () => void;
-    setScrollTop: React.Dispatch<React.SetStateAction<number>>;
-    setContainerHeight: React.Dispatch<React.SetStateAction<number>>;
-    setCurrentYear: React.Dispatch<React.SetStateAction<number>>;
-    setIsScrolling: React.Dispatch<React.SetStateAction<boolean>>;
-}
-/**
- * Drag state Hook return value
- */
-export interface UseDragStateReturn {
-    dragRef: React.MutableRefObject<UnifiedDragRef>;
-    currentDragRef: React.MutableRefObject<{
-        x: number;
-        y: number;
-    }>;
-    dragState: MonthDragState | WeekDayDragState;
-    setDragState: React.Dispatch<React.SetStateAction<MonthDragState | WeekDayDragState>>;
-    resetDragState: () => void;
-    throttledSetEvents: (updateFunc: (events: Event[]) => Event[], dragState?: string) => void;
-}
-/**
- * Drag common utilities Hook return value
- */
-export 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
- */
-export interface UseDragManagerReturn {
-    dragIndicatorRef: React.RefObject<HTMLDivElement | null>;
-    reactRootRef: React.RefObject<Root | 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
- */
-export interface UseDragHandlersReturn {
-    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
- */
-export interface UseDragHandlersParams {
-    options: useDragProps;
-    common: UseDragCommonReturn;
-    state: UseDragStateReturn;
-    manager: UseDragManagerReturn;
-}

package/dist/types/index.d.ts

@@ -1,13 +0,0 @@
-export * from './core';
-export * from './calendar';
-export * from './event';
-export * from './layout';
-export * from './dragIndicator';
-export * from './monthView';
-export * from './factory';
-export * from './plugin';
-export * from './config';
-export * from './hook';
-export * from './eventDetail';
-export * from './mobileEvent';
-export * from './calendarTypes';

package/dist/types/layout.d.ts

@@ -1,113 +0,0 @@
-import { Event } from './event';
-/**
- * Event layout configuration constants
- * Controls visual presentation of events in the calendar
- */
-export declare const LAYOUT_CONFIG: {
-    readonly INDENT_STEP: 2;
-    readonly MIN_WIDTH: 25;
-    readonly MARGIN_BETWEEN: 2;
-    readonly CONTAINER_WIDTH: 320;
-    readonly OVERLAP_THRESHOLD: 0.25;
-    readonly EDGE_MARGIN: 3;
-    readonly MAX_LOAD_IMBALANCE: 0;
-    readonly REBALANCE_THRESHOLD: 2;
-};
-/**
- * Event layout interface
- * Defines position and styling of events in the UI
- */
-export interface EventLayout {
-    id: string;
-    left: number;
-    width: number;
-    zIndex: number;
-    level: number;
-    isPrimary: boolean;
-    indentOffset: number;
-    importance: number;
-}
-/**
- * Nested layer interface
- * Represents hierarchical relationships of events
- */
-export interface NestedLayer {
-    events: Event[];
-    level: number;
-    parentEvent?: Event;
-    timeSlot?: {
-        start: number;
-        end: number;
-    };
-}
-/**
- * Event group interface
- * Represents a group of related events and their nested structure
- */
-export interface EventGroup {
-    events: Event[];
-    startHour: number;
-    endHour: number;
-    primaryEvent?: Event;
-    nestedStructure: NestedLayer[];
-    specialLayoutRules?: SpecialLayoutRule[];
-    originalBranchMap?: Map<string, Event>;
-}
-/**
- * Event relationship information interface
- * Describes relationships of events in nested structures
- */
-export interface EventRelations {
-    directChildren: Event[];
-    allDescendants: Event[];
-    directParent: Event | null;
-    layer: NestedLayer | null;
-    subtreeSize: number;
-    isLeaf: boolean;
-}
-/**
- * Subtree analysis interface
- * Used to analyze structural information of event trees
- */
-export interface SubtreeAnalysis {
-    rootEvent: Event;
-    allDescendants: Event[];
-    timeSpan: {
-        start: number;
-        end: number;
-        duration: number;
-    };
-    descendantCount: number;
-    maxDepth: number;
-    branchPath: Event[];
-}
-/**
- * Balance strategy interface
- * Used for balance algorithms to optimize event layouts
- */
-export interface BalanceStrategy {
-    type: 'count_balance' | 'timespan_balance';
-    transfers: TransferOperation[];
-    specialLayoutRules: SpecialLayoutRule[];
-}
-/**
- * Transfer operation interface
- * Describes movement of events in layout optimization
- */
-export interface TransferOperation {
-    event: Event;
-    fromParent: Event;
-    toParent: Event;
-    reason: string;
-}
-/**
- * Special layout rule interface
- * Defines layout constraints for specific events
- */
-export interface SpecialLayoutRule {
-    eventId: string;
-    layoutType: 'align_with_ancestor' | 'full_width' | 'full_width_from_level' | 'align_with_sibling';
-    referenceEvent?: Event;
-    targetLevel?: number;
-    reason?: string;
-}

package/dist/types/mobileEvent.d.ts

@@ -1,21 +0,0 @@
-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

@@ -1,65 +0,0 @@
-import { WeeksData } from '.';
-export interface UseVirtualMonthScrollProps {
-    currentDate: Date;
-    weekHeight: number;
-    onCurrentMonthChange?: (month: string, year: number) => void;
-    initialWeeksToLoad?: number;
-    locale?: string;
-    isEnabled?: boolean;
-}
-export interface UseVirtualMonthScrollReturn {
-    scrollTop: number;
-    containerHeight: number;
-    currentMonth: string;
-    currentYear: number;
-    isScrolling: boolean;
-    virtualData: {
-        totalHeight: number;
-        visibleItems: VirtualWeekItem[];
-        displayStartIndex: number;
-    };
-    scrollElementRef: React.RefObject<HTMLDivElement>;
-    handleScroll: (e: React.UIEvent<HTMLDivElement>) => 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>>;
-    cache: WeekDataCache;
-    scrollElementRefCallback: (element: HTMLDivElement | null) => void;
-    weeksData: WeeksData[];
-}
-export declare const VIRTUAL_MONTH_SCROLL_CONFIG: {
-    readonly OVERSCAN: 6;
-    readonly BUFFER_SIZE: 100;
-    readonly MIN_YEAR: 1900;
-    readonly MAX_YEAR: 2200;
-    readonly SCROLL_THROTTLE: 8;
-    readonly SCROLL_DEBOUNCE: 150;
-    readonly CACHE_CLEANUP_THRESHOLD: 200;
-    readonly MOBILE_WEEK_HEIGHT: 80;
-    readonly TABLET_WEEK_HEIGHT: 90;
-    readonly WEEK_HEIGHT: 119;
-};
-export interface VirtualWeekItem {
-    index: number;
-    weekData: WeeksData;
-    top: number;
-    height: number;
-}
-export declare class WeekDataCache {
-    private cache;
-    private accessOrder;
-    private maxSize;
-    constructor(maxSize?: number);
-    private getKey;
-    get(weekStartDate: Date): WeeksData | undefined;
-    set(weekStartDate: Date, data: WeeksData): void;
-    private updateAccessOrder;
-    getSize(): number;
-    clear(): void;
-}

package/dist/types/plugin.d.ts

@@ -1,80 +0,0 @@
-import React from 'react';
-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
- */
-export interface EventsService {
-    getAll: () => Event[];
-    getById: (id: string) => Event | undefined;
-    add: (event: Event) => void;
-    update: (id: string, updates: Partial<Event>) => Event;
-    delete: (id: string) => void;
-    getByDate: (date: Date) => Event[];
-    getByDateRange: (startDate: Date, endDate: Date) => Event[];
-    getByDay: (dayIndex: number, weekStart: Date) => Event[];
-    getAllDayEvents: (dayIndex: number, events: Event[]) => Event[];
-    recalculateEventDays: (events: Event[], weekStart: Date) => Event[];
-    validateEvent: (event: Partial<Event>) => string[];
-    filterEvents: (events: Event[], filter: (event: Event) => boolean) => Event[];
-}
-/**
- * Events plugin configuration
- */
-export interface EventsPluginConfig {
-    enableAutoRecalculate?: boolean;
-    enableValidation?: boolean;
-    defaultEvents?: Event[];
-    maxEventsPerDay?: number;
-}
-/**
- * Drag Hook options
- */
-export interface DragHookOptions extends Partial<DragConfig> {
-    calendarRef: React.RefObject<HTMLDivElement | null>;
-    allDayRowRef?: React.RefObject<HTMLDivElement | null>;
-    viewType: ViewType;
-    onEventsUpdate: (updateFunc: (events: Event[]) => Event[], isResizing?: boolean) => void;
-    onEventCreate: (event: Event) => void;
-    onEventEdit: (event: Event) => void;
-    currentWeekStart: Date;
-    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 | 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;
-}
-/**
- * Drag plugin configuration
- */
-export interface DragPluginConfig {
-    enableDrag: boolean;
-    enableResize: boolean;
-    enableCreate: boolean;
-    enableAllDayCreate: boolean;
-    supportedViews: ViewType[];
-    [key: string]: unknown;
-}
-/**
- * Drag service interface
- * Provides drag capability for views
- */
-export interface DragService {
-    getConfig: () => DragPluginConfig;
-    updateConfig: (updates: Partial<DragPluginConfig>) => void;
-    isViewSupported: (viewType: ViewType) => boolean;
-}

package/dist/types/search.d.ts

@@ -1,35 +0,0 @@
-import { Event } from './event';
-export type CalendarSearchEvent = Event & {
-    color?: string;
-    [key: string]: any;
-};
-export interface CalendarSearchProps {
-    /**
-     * Debounce delay in ms
-     * @default 300
-     */
-    debounceDelay?: number;
-    /**
-     * Async search method
-     */
-    onSearch?: (keyword: string) => Promise<CalendarSearchEvent[]>;
-    /**
-     * Custom search logic (takes over completely)
-     */
-    customSearch?: (params: {
-        keyword: string;
-        events: CalendarSearchEvent[];
-    }) => CalendarSearchEvent[];
-    /**
-     * Search state callback
-     */
-    onSearchStateChange?: (state: {
-        keyword: string;
-        loading: boolean;
-        results: CalendarSearchEvent[];
-    }) => void;
-    /**
-     * Empty result text
-     */
-    emptyText?: string | Record<string, string>;
-}

package/dist/utils/calendarDataUtils.d.ts

@@ -1,83 +0,0 @@
-/**
- * Calendar Data Generation Utilities
- *
- * This module provides utilities for generating calendar data structures
- * including days, weeks, and month/year metadata.
- */
-import { DayData, WeeksData } from '../types';
-/**
- * Generate day data object from a date
- * @param date Date to generate data for
- * @returns Day data with date, day, month, year, and isToday flag
- */
-export declare const generateDayData: (date: string | number | Date) => {
-    date: Date;
-    day: number;
-    month: number;
-    year: number;
-    monthName: string;
-    shortMonthName: string;
-    isToday: boolean;
-};
-/**
- * Generate week data (7 days starting from given date)
- * @param startDate Week start date
- * @returns Week data with days array, startDate, and monthYear
- */
-export declare const generateWeekData: (startDate: string | number | Date) => {
-    days: {
-        date: Date;
-        day: number;
-        month: number;
-        year: number;
-        monthName: string;
-        shortMonthName: string;
-        isToday: boolean;
-    }[];
-    startDate: Date;
-    monthYear: {
-        month: string;
-        monthIndex: number;
-        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
- */
-export declare const getMonthYearOfWeek: (days: DayData[]) => {
-    month: string;
-    monthIndex: number;
-    year: number;
-};
-/**
- * Generate weeks data around a central date
- * @param centralDate Central date for range
- * @param monthsToLoad Number of months to load (default: 3)
- * @returns Array of week data
- */
-export declare const generateWeeksData: (centralDate: Date, monthsToLoad?: number) => {
-    days: {
-        date: Date;
-        day: number;
-        month: number;
-        year: number;
-        monthName: string;
-        shortMonthName: string;
-        isToday: boolean;
-    }[];
-    startDate: Date;
-    monthYear: {
-        month: string;
-        monthIndex: number;
-        year: number;
-    };
-}[];
-/**
- * Generate week range around a center date
- * @param centerDate Center date for range
- * @param totalWeeks Total number of weeks to generate
- * @returns Array of weeks data
- */
-export declare function generateWeekRange(centerDate: Date, totalWeeks: number): WeeksData[];

package/dist/utils/colorUtils.d.ts

@@ -1,27 +0,0 @@
-/**
- * Color Utilities
- *
- * This module provides utilities for resolving event colors using the calendar registry.
- * All color functions return actual color values (not CSS classes) for inline styles.
- */
-import { CalendarRegistry } from '../core/calendarRegistry';
-/**
- * Get event background color (actual color value, not CSS class)
- * Use this for inline styles
- */
-export declare const getEventBgColor: (calendarIdOrColor: string, registry?: CalendarRegistry) => string;
-/**
- * Get event text color (actual color value, not CSS class)
- * Use this for inline styles
- */
-export declare const getEventTextColor: (calendarIdOrColor: string, registry?: CalendarRegistry) => string;
-/**
- * Get selected background color
- * Now uses the calendar registry for color resolution
- */
-export declare const getSelectedBgColor: (calendarIdOrColor: string, registry?: CalendarRegistry) => string;
-/**
- * Get line color
- * Now uses the calendar registry for color resolution
- */
-export declare const getLineColor: (calendarIdOrColor: string, registry?: CalendarRegistry) => string;

package/dist/utils/compareUtils.d.ts

@@ -1,5 +0,0 @@
-/**
- * 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/dateConstants.d.ts

@@ -1,22 +0,0 @@
-/**
- * Date Constants
- *
- * This module provides constant arrays for day and month names in various formats.
- * Used throughout the application for displaying date information.
- */
-/**
- * Week day abbreviations (Mon-Sun)
- */
-export declare const weekDays: string[];
-/**
- * Full week day names (Monday-Sunday)
- */
-export declare const weekDaysFullName: string[];
-/**
- * Full month names (January-December)
- */
-export declare const monthNames: string[];
-/**
- * Month abbreviations (Jan-Dec)
- */
-export declare const shortMonthNames: string[];

package/dist/utils/dateFormat.d.ts

@@ -1,15 +0,0 @@
-import { Temporal } from 'temporal-polyfill';
-/**
- * Format date to DD/MM/YYYY format
- * Ensures consistent server and client rendering
- */
-export declare const formatDateConsistent: (date?: Date | Temporal.PlainDate | Temporal.PlainDateTime | Temporal.ZonedDateTime) => string;
-/**
- * Format month and year to consistent format
- */
-export declare const formatMonthYear: (date: Date) => string;
-/**
- * Format date to "DD MMM YYYY" format (e.g., "15 Jan 2025")
- * Used for event detail display
- */
-export declare const formatDate: (temporal: Temporal.PlainDate | Temporal.PlainDateTime | Temporal.ZonedDateTime) => string;

package/dist/utils/dateRangeUtils.d.ts

@@ -1,24 +0,0 @@
-/**
- * Date Range Utilities
- *
- * This module provides utilities for calculating date ranges, particularly
- * for week-based operations (Monday-Sunday).
- */
-/**
- * Get the Monday-Sunday range for a given date
- * @param date Input date
- * @returns Object with monday and sunday dates
- */
-export declare const getWeekRange: (date: Date) => {
-    monday: Date;
-    sunday: Date;
-};
-/**
- * Get current week dates (Monday-Sunday) with today indicator
- * @returns Array of 7 date objects with date, month, and isToday flag
- */
-export declare const getCurrentWeekDates: () => {
-    date: number;
-    month: string;
-    isToday: boolean;
-}[];

package/dist/utils/dateTimeUtils.d.ts

@@ -1,49 +0,0 @@
-/**
- * Date and Time Conversion Utilities
- *
- * This module provides utilities for converting between Date and Temporal API objects,
- * extracting time components, and performing date comparisons.
- *
- * All functions support both legacy Date objects and modern Temporal API types
- * for backward compatibility and future-proofing.
- */
-import { Temporal } from 'temporal-polyfill';
-/**
- * Extract hour number from Date or Temporal object (with decimal for minutes, e.g., 14.5 = 14:30)
- * @param dateTime Date or Temporal object
- * @returns Hour number (0-24, supports decimals)
- */
-export declare const extractHourFromDate: (dateTime: Date | Temporal.PlainDate | Temporal.PlainDateTime | Temporal.ZonedDateTime) => number;
-/**
- * Create a new date-time object based on given date but set to specified hour
- * @param baseDateTime Base date-time
- * @param hour Hour number (supports decimals, e.g., 14.5 = 14:30)
- * @returns Date or Temporal (PlainDateTime or ZonedDateTime)
- */
-export declare const createDateWithHour: (baseDateTime: Date | Temporal.PlainDate | Temporal.PlainDateTime | Temporal.ZonedDateTime, hour: number) => Date | Temporal.PlainDateTime | Temporal.ZonedDateTime;
-/**
- * Get start of day (00:00:00.000)
- * @param dateTime Date-time
- * @returns Start of day
- */
-export declare const getStartOfDay: (dateTime: Date | Temporal.PlainDate | Temporal.PlainDateTime | Temporal.ZonedDateTime) => Date | Temporal.ZonedDateTime;
-/**
- * Get end of day (23:59:59.999)
- * @param dateTime Date-time
- * @returns End of day
- */
-export declare const getEndOfDay: (dateTime: Date | Temporal.PlainDate | Temporal.PlainDateTime | Temporal.ZonedDateTime) => Date | Temporal.ZonedDateTime;
-/**
- * Check if two dates are on the same day
- * @param date1 Date 1
- * @param date2 Date 2
- * @returns Whether they are the same day
- */
-export declare const isSameDay: (date1: Date | Temporal.PlainDate | Temporal.PlainDateTime | Temporal.ZonedDateTime, date2: Date | Temporal.PlainDate | Temporal.PlainDateTime | Temporal.ZonedDateTime) => boolean;
-/**
- * Check if event spans multiple days
- * @param start Start time
- * @param end End time
- * @returns Whether it's a multi-day event
- */
-export declare const isMultiDayEvent: (start: Date | Temporal.PlainDate | Temporal.PlainDateTime | Temporal.ZonedDateTime, end: Date | Temporal.PlainDate | Temporal.PlainDateTime | Temporal.ZonedDateTime) => boolean;