gantt-lib 0.17.2 → 0.19.0

package/dist/index.d.ts

@@ -252,6 +252,12 @@ 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) */
+    isWeekend?: (date: Date) => boolean;
 }
 /**
  * Ref handle type for GanttChart — exposes imperative scroll methods.
@@ -348,6 +354,8 @@ interface TimeScaleHeaderProps {
     headerHeight: number;
     /** View mode: 'day' renders individual day columns, 'week' renders 7-day week columns, 'month' renders one column per month */
     viewMode?: 'day' | 'week' | 'month';
+    /** Optional predicate for custom weekend logic (e.g., holidays, shift patterns) */
+    isCustomWeekend?: (date: Date) => boolean;
 }
 /**
  * TimeScaleHeader component - displays two-row date headers for the Gantt chart
@@ -370,6 +378,8 @@ interface GridBackgroundProps {
     totalHeight: number;
     /** View mode: 'day' renders per-day lines with weekend blocks, 'week' renders per-week lines only, 'month' renders per-month lines only */
     viewMode?: 'day' | 'week' | 'month';
+    /** Optional predicate for custom weekend logic (e.g., holidays, shift patterns) */
+    isCustomWeekend?: (date: Date) => boolean;
 }
 /**
  * GridBackground component - renders vertical grid lines and weekend background highlighting
@@ -463,6 +473,12 @@ 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 */
+    isWeekend?: (date: Date) => boolean;
 }
 /**
  * TaskList component - displays tasks in a table format as an overlay
@@ -537,6 +553,12 @@ interface CalendarProps {
     initialDate?: Date;
     mode?: 'single' | 'range';
     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>;
 
@@ -555,6 +577,12 @@ 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;
 }
 /**
  * DatePicker component — shows formatted date as a button, opens calendar popup on click.
@@ -672,6 +700,58 @@ declare const isToday: (date: Date) => boolean;
  * @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
@@ -993,9 +1073,21 @@ declare const calculateGridLines: (dateRange: Date[], dayWidth: number) => Array
  * Calculate weekend background blocks for a date range
  * @param dateRange - Array of Date objects representing the visible range
  * @param dayWidth - Width of each day column in pixels
+ * @param isCustomWeekend - Optional predicate for custom weekend logic (e.g., holidays, shift patterns)
  * @returns Array of weekend block objects with left position and width
- */
-declare const calculateWeekendBlocks: (dateRange: Date[], dayWidth: number) => Array<{
+ *
+ * Example:
+ * // Default behavior (Saturday/Sunday)
+ * calculateWeekendBlocks(dateRange, dayWidth)
+ *
+ * // Custom weekends (holidays, shifted workdays)
+ * const isCustomWeekend = createIsWeekendPredicate({
+ *   weekends: [new Date(Date.UTC(2026, 2, 8))], // March 8 holiday
+ *   workdays: [new Date(Date.UTC(2026, 2, 15))] // March 15 workday
+ * });
+ * calculateWeekendBlocks(dateRange, dayWidth, isCustomWeekend)
+ */
+declare const calculateWeekendBlocks: (dateRange: Date[], dayWidth: number, isCustomWeekend?: (date: Date) => boolean) => Array<{
     left: number;
     width: number;
 }>;
@@ -1107,4 +1199,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 YearSpan, buildAdjacencyList, calculateBezierPath, calculateDependencyPath, calculateGridLines, calculateGridWidth, calculateMonthGridLines, calculateOrthogonalPath, calculateSuccessorDate, calculateTaskBar, calculateWeekGridLines, calculateWeekendBlocks, cascadeByLinks, computeLagFromDates, computeParentDates, computeParentProgress, 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, 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 };