gantt-lib 0.19.0 → 0.20.0

package/dist/index.d.mts

@@ -1,6 +1,205 @@
 import React$1 from 'react';
 import * as RadixPopover from '@radix-ui/react-popover';
 
+/**
+ * Parse date string as UTC to prevent DST issues
+ * @param date - Date string or Date object
+ * @returns Date object representing UTC midnight
+ * @throws Error if date string is invalid
+ */
+declare const parseUTCDate: (date: string | Date) => Date;
+/**
+ * Get all days in the month of given date (UTC)
+ * @param date - Reference date (any day in the target month)
+ * @returns Array of Date objects for each day in the month
+ */
+declare const getMonthDays: (date: Date | string) => Date[];
+/**
+ * Calculate day offset from month start (0-based)
+ * @param date - The date to calculate offset for
+ * @param monthStart - The start of the month as reference
+ * @returns Number of days from month start (negative if date is before month start)
+ */
+declare const getDayOffset: (date: Date, monthStart: Date) => number;
+/**
+ * Check if date is today (local timezone comparison)
+ * Uses local time to determine today's date boundary so the result matches
+ * the user's timezone rather than UTC (prevents off-by-one errors at midnight).
+ * @param date - Date to check
+ * @returns True if date is today, false otherwise
+ */
+declare const isToday: (date: Date) => boolean;
+/**
+ * Check if date is a weekend day (Saturday or Sunday)
+ * @param date - Date to check
+ * @returns True if date is Saturday (6) or Sunday (0), false otherwise
+ */
+declare const isWeekend: (date: Date) => boolean;
+/**
+ * Create a UTC-safe key for Set-based date lookup
+ * @param date - Date object to create key from
+ * @returns String key in "YYYY-M-D" format using UTC date components
+ *
+ * Example:
+ * createDateKey(new Date(Date.UTC(2026, 2, 15))) // "2026-2-15"
+ *
+ * Note: Uses UTC methods to prevent DST and timezone issues.
+ * Month is 0-indexed (0=January, 11=December) per JavaScript Date convention.
+ */
+declare const createDateKey: (date: Date) => string;
+/**
+ * Configuration for a single custom day
+ */
+interface CustomDayConfig {
+    /** The date to customize */
+    date: Date;
+    /** Type of day: 'weekend' marks as weekend, 'workday' marks as workday */
+    type: 'weekend' | 'workday';
+}
+/**
+ * Configuration for custom day predicate
+ */
+interface CustomDayPredicateConfig {
+    /** Array of custom day configurations with explicit types */
+    customDays?: CustomDayConfig[];
+    /** Optional base weekend predicate (checked before customDays overrides) */
+    isWeekend?: (date: Date) => boolean;
+}
+/**
+ * Create a weekend predicate with unified custom day support
+ *
+ * Precedence order (highest to lowest):
+ * 1. customDays.type='workday' - explicit workday (highest override)
+ * 2. customDays.type='weekend' - explicit weekend (override)
+ * 3. isWeekend (base predicate) - custom base logic
+ * 4. default - Saturday (6) and Sunday (0)
+ *
+ * @param config - Custom day configuration with array and optional predicate
+ * @returns Predicate function (date: Date) => boolean
+ *
+ * Example:
+ * // Simple holidays + working Saturdays
+ * const predicate = createCustomDayPredicate({
+ *   customDays: [
+ *     { date: new Date(Date.UTC(2026, 2, 15)), type: 'workday' }, // working Saturday
+ *     { date: new Date(Date.UTC(2026, 0, 1)), type: 'weekend' }  // holiday Tuesday
+ *   ]
+ * });
+ *
+ * // 4-day work week + occasional overrides
+ * const predicate2 = createCustomDayPredicate({
+ *   isWeekend: (date) => {
+ *     const day = date.getUTCDay();
+ *     return day === 0 || day === 6 || day === 5; // Sun+Sat+Fri
+ *   },
+ *   customDays: [
+ *     { date: new Date(Date.UTC(2026, 2, 10)), type: 'workday' } // working Friday
+ *   ]
+ * });
+ */
+declare const createCustomDayPredicate: (config: CustomDayPredicateConfig) => ((date: Date) => boolean);
+/**
+ * Calculate multi-month date range from task dates
+ * Expands range to include full months with padding on both ends for drag flexibility
+ * Adds 1 month before and 2 months after the task range
+ * @param tasks - Array of tasks with startDate and endDate
+ * @returns Array of Date objects for all days in the expanded range
+ */
+declare const getMultiMonthDays: (tasks: Array<{
+    startDate: string | Date;
+    endDate: string | Date;
+}>) => Date[];
+/**
+ * Calculate month spans within a date range
+ * @param dateRange - Array of Date objects representing the full range
+ * @returns Array of month span objects with month, days count, and start index
+ */
+declare const getMonthSpans: (dateRange: Date[]) => Array<{
+    month: Date;
+    days: number;
+    startIndex: number;
+}>;
+/**
+ * Format date as DD.MM (e.g., 25.03 for March 25th)
+ * @param date - Date to format
+ * @returns Formatted date string in DD.MM format
+ */
+declare const formatDateLabel: (date: Date | string) => string;
+/**
+ * Return block boundaries for week-view, splitting on month boundaries.
+ * Each block represents a column in the week-view header.
+ * Blocks are typically 7 days, but split on month boundaries so
+ * the first/last block of a month may be smaller.
+ *
+ * @param days - Array of dates from getMultiMonthDays
+ * @returns Array of start dates for each block, with actual block sizes
+ */
+interface WeekBlock {
+    /** Start date of this block */
+    startDate: Date;
+    /** Number of days in this block (≤7, splits on month boundaries) */
+    days: number;
+}
+/**
+ * Split the date range into blocks, primarily 7-day weeks,
+ * but splitting blocks on month boundaries for accurate month spans.
+ */
+declare const getWeekBlocks: (days: Date[]) => WeekBlock[];
+/**
+ * Represents a month span in week-view header row 1.
+ * In week-view, the width is calculated from actual day counts,
+ * not from a fixed column count.
+ */
+interface WeekSpan {
+    /** First day of the calendar month (UTC) */
+    month: Date;
+    /** Total number of days this month occupies across all blocks */
+    days: number;
+    /** Start index in the blocks array */
+    startIndex: number;
+}
+/**
+ * Calculate month spans based on week-block boundaries.
+ * Groups consecutive blocks that belong to the same month.
+ */
+declare const getWeekSpans: (days: Date[]) => WeekSpan[];
+interface MonthBlock {
+    /** Первый день месяца (UTC) */
+    startDate: Date;
+    /** Количество дней в этом месяце внутри dateRange (может быть меньше при обрезке) */
+    days: number;
+}
+/**
+ * Разбивает dateRange на блоки по месяцам.
+ * Каждый блок = один месяц (колонка в строке 2 month-view шапки).
+ * Блок на краях может быть неполным если dateRange начинается/заканчивается не с 1-го числа.
+ */
+declare const getMonthBlocks: (days: Date[]) => MonthBlock[];
+interface YearSpan {
+    /** 1 января года (UTC) */
+    year: Date;
+    /** Суммарное кол-во дней этого года внутри dateRange */
+    days: number;
+    /** Начальный индекс в массиве monthBlocks */
+    startIndex: number;
+}
+/**
+ * Группирует month-блоки по годам.
+ * Используется в строке 1 month-view шапки (year label).
+ */
+declare const getYearSpans: (days: Date[]) => YearSpan[];
+/**
+ * Normalize task dates to ensure startDate is always before or equal to endDate.
+ * If dates are swapped (endDate < startDate), they are automatically swapped.
+ * @param startDate - Task start date (string or Date)
+ * @param endDate - Task end date (string or Date)
+ * @returns Object with normalized startDate and endDate as ISO date strings (YYYY-MM-DD)
+ */
+declare const normalizeTaskDates: (startDate: string | Date, endDate: string | Date) => {
+    startDate: string;
+    endDate: string;
+};
+
 /**
  * Dependency link types following PM standard
  * - FS (Finish-to-Start): Predecessor must finish before successor starts
@@ -252,11 +451,9 @@ interface GanttChartProps {
     enableAddTask?: boolean;
     /** View mode: 'day' renders one column per day, 'week' renders one column per 7 days, 'month' renders one column per month (default: 'day') */
     viewMode?: 'day' | 'week' | 'month';
-    /** Custom weekend dates to ADD to default weekends (e.g., holidays) */
-    weekends?: Date[];
-    /** Custom workday dates to EXCLUDE from default weekends (e.g., shifted workdays) */
-    workdays?: Date[];
-    /** Flexible weekend logic predicate (overrides arrays) */
+    /** Custom day configurations with explicit type (weekend or workday) */
+    customDays?: CustomDayConfig[];
+    /** Optional base weekend predicate (checked before customDays overrides) */
     isWeekend?: (date: Date) => boolean;
 }
 /**
@@ -473,11 +670,9 @@ interface TaskListProps {
     onPromoteTask?: (taskId: string) => void;
     /** Callback when task is demoted (parentId set to previous task) */
     onDemoteTask?: (taskId: string, newParentId: string) => void;
-    /** Optional custom weekend dates (holidays) for date picker */
-    weekends?: Date[];
-    /** Optional custom workday dates - overrides weekends */
-    workdays?: Date[];
-    /** Optional predicate for custom weekend logic in date picker */
+    /** Custom day configurations for date picker */
+    customDays?: CustomDayConfig[];
+    /** Optional base weekend predicate for date picker */
     isWeekend?: (date: Date) => boolean;
 }
 /**
@@ -555,10 +750,6 @@ interface CalendarProps {
     disabled?: boolean;
     /** Optional predicate for custom weekend logic (e.g., holidays, shift patterns) */
     isWeekend?: (date: Date) => boolean;
-    /** Optional custom weekend dates (holidays) - takes precedence over default weekends */
-    weekends?: Date[];
-    /** Optional custom workday dates - overrides both default and custom weekends */
-    workdays?: Date[];
 }
 declare const Calendar: React$1.FC<CalendarProps>;
 
@@ -577,10 +768,6 @@ interface DatePickerProps {
     className?: string;
     /** Whether the picker is disabled */
     disabled?: boolean;
-    /** Optional custom weekend dates (holidays) */
-    weekends?: Date[];
-    /** Optional custom workday dates - overrides weekends */
-    workdays?: Date[];
     /** Optional predicate for custom weekend logic */
     isWeekend?: (date: Date) => boolean;
 }
@@ -666,194 +853,6 @@ interface UseTaskDragReturn {
  */
 declare const useTaskDrag: (options: UseTaskDragOptions) => UseTaskDragReturn;
 
-/**
- * Parse date string as UTC to prevent DST issues
- * @param date - Date string or Date object
- * @returns Date object representing UTC midnight
- * @throws Error if date string is invalid
- */
-declare const parseUTCDate: (date: string | Date) => Date;
-/**
- * Get all days in the month of given date (UTC)
- * @param date - Reference date (any day in the target month)
- * @returns Array of Date objects for each day in the month
- */
-declare const getMonthDays: (date: Date | string) => Date[];
-/**
- * Calculate day offset from month start (0-based)
- * @param date - The date to calculate offset for
- * @param monthStart - The start of the month as reference
- * @returns Number of days from month start (negative if date is before month start)
- */
-declare const getDayOffset: (date: Date, monthStart: Date) => number;
-/**
- * Check if date is today (local timezone comparison)
- * Uses local time to determine today's date boundary so the result matches
- * the user's timezone rather than UTC (prevents off-by-one errors at midnight).
- * @param date - Date to check
- * @returns True if date is today, false otherwise
- */
-declare const isToday: (date: Date) => boolean;
-/**
- * Check if date is a weekend day (Saturday or Sunday)
- * @param date - Date to check
- * @returns True if date is Saturday (6) or Sunday (0), false otherwise
- */
-declare const isWeekend: (date: Date) => boolean;
-/**
- * Create a UTC-safe key for Set-based date lookup
- * @param date - Date object to create key from
- * @returns String key in "YYYY-M-D" format using UTC date components
- *
- * Example:
- * createDateKey(new Date(Date.UTC(2026, 2, 15))) // "2026-2-15"
- *
- * Note: Uses UTC methods to prevent DST and timezone issues.
- * Month is 0-indexed (0=January, 11=December) per JavaScript Date convention.
- */
-declare const createDateKey: (date: Date) => string;
-/**
- * Configuration for custom weekend calendar
- */
-interface WeekendConfig {
-    /** Array of dates to ADD to default weekends (e.g., holidays) */
-    weekends?: Date[];
-    /** Array of dates to EXCLUDE from default weekends (e.g., shifted workdays) */
-    workdays?: Date[];
-    /** Custom predicate for flexible weekend logic (overrides arrays) */
-    isWeekend?: (date: Date) => boolean;
-}
-/**
- * Create a weekend predicate with custom calendar support
- *
- * Precedence order (highest to lowest):
- * 1. isWeekend (custom predicate) - use directly, ignore arrays
- * 2. workdays - exclude these dates from default weekends
- * 3. weekends - add these dates to default weekends
- * 4. default - Saturday (6) and Sunday (0)
- *
- * @param config - Weekend configuration with optional arrays and predicate
- * @returns Predicate function (date: Date) => boolean
- *
- * Example:
- * // Add March 8 as holiday (Monday becomes weekend)
- * const predicate = createIsWeekendPredicate({
- *   weekends: [new Date(Date.UTC(2026, 2, 8))]
- * });
- *
- * // Make March 15 a workday (Saturday becomes workday)
- * const predicate2 = createIsWeekendPredicate({
- *   workdays: [new Date(Date.UTC(2026, 2, 15))]
- * });
- *
- * // Custom shift pattern (Sunday-only weekends)
- * const predicate3 = createIsWeekendPredicate({
- *   isWeekend: (date) => date.getUTCDay() === 0
- * });
- */
-declare const createIsWeekendPredicate: (config: WeekendConfig) => ((date: Date) => boolean);
-/**
- * Calculate multi-month date range from task dates
- * Expands range to include full months with padding on both ends for drag flexibility
- * Adds 1 month before and 2 months after the task range
- * @param tasks - Array of tasks with startDate and endDate
- * @returns Array of Date objects for all days in the expanded range
- */
-declare const getMultiMonthDays: (tasks: Array<{
-    startDate: string | Date;
-    endDate: string | Date;
-}>) => Date[];
-/**
- * Calculate month spans within a date range
- * @param dateRange - Array of Date objects representing the full range
- * @returns Array of month span objects with month, days count, and start index
- */
-declare const getMonthSpans: (dateRange: Date[]) => Array<{
-    month: Date;
-    days: number;
-    startIndex: number;
-}>;
-/**
- * Format date as DD.MM (e.g., 25.03 for March 25th)
- * @param date - Date to format
- * @returns Formatted date string in DD.MM format
- */
-declare const formatDateLabel: (date: Date | string) => string;
-/**
- * Return block boundaries for week-view, splitting on month boundaries.
- * Each block represents a column in the week-view header.
- * Blocks are typically 7 days, but split on month boundaries so
- * the first/last block of a month may be smaller.
- *
- * @param days - Array of dates from getMultiMonthDays
- * @returns Array of start dates for each block, with actual block sizes
- */
-interface WeekBlock {
-    /** Start date of this block */
-    startDate: Date;
-    /** Number of days in this block (≤7, splits on month boundaries) */
-    days: number;
-}
-/**
- * Split the date range into blocks, primarily 7-day weeks,
- * but splitting blocks on month boundaries for accurate month spans.
- */
-declare const getWeekBlocks: (days: Date[]) => WeekBlock[];
-/**
- * Represents a month span in week-view header row 1.
- * In week-view, the width is calculated from actual day counts,
- * not from a fixed column count.
- */
-interface WeekSpan {
-    /** First day of the calendar month (UTC) */
-    month: Date;
-    /** Total number of days this month occupies across all blocks */
-    days: number;
-    /** Start index in the blocks array */
-    startIndex: number;
-}
-/**
- * Calculate month spans based on week-block boundaries.
- * Groups consecutive blocks that belong to the same month.
- */
-declare const getWeekSpans: (days: Date[]) => WeekSpan[];
-interface MonthBlock {
-    /** Первый день месяца (UTC) */
-    startDate: Date;
-    /** Количество дней в этом месяце внутри dateRange (может быть меньше при обрезке) */
-    days: number;
-}
-/**
- * Разбивает dateRange на блоки по месяцам.
- * Каждый блок = один месяц (колонка в строке 2 month-view шапки).
- * Блок на краях может быть неполным если dateRange начинается/заканчивается не с 1-го числа.
- */
-declare const getMonthBlocks: (days: Date[]) => MonthBlock[];
-interface YearSpan {
-    /** 1 января года (UTC) */
-    year: Date;
-    /** Суммарное кол-во дней этого года внутри dateRange */
-    days: number;
-    /** Начальный индекс в массиве monthBlocks */
-    startIndex: number;
-}
-/**
- * Группирует month-блоки по годам.
- * Используется в строке 1 month-view шапки (year label).
- */
-declare const getYearSpans: (days: Date[]) => YearSpan[];
-/**
- * Normalize task dates to ensure startDate is always before or equal to endDate.
- * If dates are swapped (endDate < startDate), they are automatically swapped.
- * @param startDate - Task start date (string or Date)
- * @param endDate - Task end date (string or Date)
- * @returns Object with normalized startDate and endDate as ISO date strings (YYYY-MM-DD)
- */
-declare const normalizeTaskDates: (startDate: string | Date, endDate: string | Date) => {
-    startDate: string;
-    endDate: string;
-};
-
 /**
  * Build adjacency list for dependency graph (task -> successors)
  */
@@ -1199,4 +1198,4 @@ interface VisibleReorderPosition {
  */
 declare function getVisibleReorderPosition(orderedTasks: TaskLike[], visibleTasks: TaskLike[], movedTaskId: string, originVisibleIndex: number, dropVisibleIndex: number): VisibleReorderPosition | null;
 
-export { Button, type ButtonProps, Calendar, type CalendarProps, DatePicker, type DatePickerProps, DragGuideLines, GanttChart, type GanttChartHandle, type GanttChartProps, type GanttDateRange, GridBackground, type GridConfig, type GridLine, Input, type InputProps, type MonthBlock, type MonthSpan, Popover, PopoverContent, type PopoverContentProps, type PopoverProps, PopoverTrigger, type Task, type TaskBarGeometry, type TaskDependency, TaskList, type TaskListProps, TaskRow, TimeScaleHeader, TodayIndicator, type VisibleReorderPosition, type WeekBlock, type WeekSpan, type WeekendBlock, type WeekendConfig, type YearSpan, buildAdjacencyList, calculateBezierPath, calculateDependencyPath, calculateGridLines, calculateGridWidth, calculateMonthGridLines, calculateOrthogonalPath, calculateSuccessorDate, calculateTaskBar, calculateWeekGridLines, calculateWeekendBlocks, cascadeByLinks, computeLagFromDates, computeParentDates, computeParentProgress, createDateKey, createIsWeekendPredicate, detectCycles, detectEdgeZone, findParentId, flattenHierarchy, formatDateLabel, getAllDependencyEdges, getChildren, getCursorForPosition, getDayOffset, getMonthBlocks, getMonthDays, getMonthSpans, getMultiMonthDays, getSuccessorChain, getTransitiveCascadeChain, getVisibleReorderPosition, getWeekBlocks, getWeekSpans, getYearSpans, isTaskParent, isToday, isWeekend, normalizeHierarchyTasks, normalizeTaskDates, parseUTCDate, pixelsToDate, recalculateIncomingLags, removeDependenciesBetweenTasks, universalCascade, useTaskDrag, validateDependencies };
+export { Button, type ButtonProps, Calendar, type CalendarProps, type CustomDayConfig, type CustomDayPredicateConfig, DatePicker, type DatePickerProps, DragGuideLines, GanttChart, type GanttChartHandle, type GanttChartProps, type GanttDateRange, GridBackground, type GridConfig, type GridLine, Input, type InputProps, type MonthBlock, type MonthSpan, Popover, PopoverContent, type PopoverContentProps, type PopoverProps, PopoverTrigger, type Task, type TaskBarGeometry, type TaskDependency, TaskList, type TaskListProps, TaskRow, TimeScaleHeader, TodayIndicator, type VisibleReorderPosition, type WeekBlock, type WeekSpan, type WeekendBlock, type YearSpan, buildAdjacencyList, calculateBezierPath, calculateDependencyPath, calculateGridLines, calculateGridWidth, calculateMonthGridLines, calculateOrthogonalPath, calculateSuccessorDate, calculateTaskBar, calculateWeekGridLines, calculateWeekendBlocks, cascadeByLinks, computeLagFromDates, computeParentDates, computeParentProgress, createCustomDayPredicate, createDateKey, detectCycles, detectEdgeZone, findParentId, flattenHierarchy, formatDateLabel, getAllDependencyEdges, getChildren, getCursorForPosition, getDayOffset, getMonthBlocks, getMonthDays, getMonthSpans, getMultiMonthDays, getSuccessorChain, getTransitiveCascadeChain, getVisibleReorderPosition, getWeekBlocks, getWeekSpans, getYearSpans, isTaskParent, isToday, isWeekend, normalizeHierarchyTasks, normalizeTaskDates, parseUTCDate, pixelsToDate, recalculateIncomingLags, removeDependenciesBetweenTasks, universalCascade, useTaskDrag, validateDependencies };