gantt-lib 0.102.0 → 0.104.0

package/dist/index.d.mts

@@ -305,6 +305,7 @@ declare const nameContains: (substring: string, caseSensitive?: boolean) => Task
 
 type BuiltInTaskListColumnId = 'selection' | 'number' | 'name' | 'startDate' | 'endDate' | 'duration' | 'progress' | 'dependencies' | 'actions';
 type TaskListColumnId = BuiltInTaskListColumnId | (string & {});
+type TaskListColumnWidthMap = Partial<Record<TaskListColumnId, number>>;
 type TaskListColumnAnchor = {
     after: BuiltInTaskListColumnId | string;
 } | {
@@ -343,6 +344,8 @@ interface TableMatrixColumn<TTask extends Task = Task> {
     width?: number | 'auto';
     minWidth?: number;
     maxWidth?: number;
+    periodStartDate?: string | Date;
+    periodEndDate?: string | Date;
     groupId?: string;
     align?: 'left' | 'center' | 'right';
     className?: string;
@@ -357,6 +360,18 @@ interface TableMatrixCellClickContext<TTask extends Task = Task> {
     columnIndex: number;
     event: React$1.MouseEvent<HTMLDivElement>;
 }
+interface TableMatrixDateOverlay<TTask extends Task = Task> {
+    date: string | Date;
+    className?: string;
+    color?: string;
+    edgeColor?: string;
+    shouldRender?: (context: {
+        task: TTask;
+        column: TableMatrixColumn<TTask>;
+        rowIndex: number;
+        columnIndex: number;
+    }) => boolean;
+}
 interface TableMatrixProps<TTask extends Task = Task> {
     tasks: TTask[];
     allTasks?: TTask[];
@@ -368,10 +383,11 @@ interface TableMatrixProps<TTask extends Task = Task> {
     selectedTaskId?: string | null;
     onTaskSelect?: (taskId: string | null) => void;
     onCellClick?: (context: TableMatrixCellClickContext<TTask>) => void;
+    dateOverlay?: TableMatrixDateOverlay<TTask> | false;
     highlightedTaskIds?: Set<string>;
     filterMode?: 'highlight' | 'hide';
 }
-declare function TableMatrix<TTask extends Task = Task>({ tasks, allTasks, columns, columnGroups, rowHeight, headerHeight, bodyMinHeight, selectedTaskId, onTaskSelect, onCellClick, highlightedTaskIds, filterMode, }: TableMatrixProps<TTask>): react_jsx_runtime.JSX.Element;
+declare function TableMatrix<TTask extends Task = Task>({ tasks, allTasks, columns, columnGroups, rowHeight, headerHeight, bodyMinHeight, selectedTaskId, onTaskSelect, onCellClick, dateOverlay, highlightedTaskIds, filterMode, }: TableMatrixProps<TTask>): react_jsx_runtime.JSX.Element;
 
 /**
  * Task data structure for Gantt chart
@@ -549,6 +565,10 @@ interface TaskChartSharedProps<TTask extends Task = Task> {
     additionalColumns?: TaskListColumn<TTask>[];
     /** Built-in or custom TaskList column IDs to hide after column placement is resolved */
     hiddenTaskListColumns?: readonly TaskListColumnId[];
+    /** Initial or controlled TaskList column widths keyed by built-in/custom column id. */
+    taskListColumnWidths?: TaskListColumnWidthMap;
+    /** Called when the user resizes TaskList columns. */
+    onTaskListColumnWidthsChange?: (widths: TaskListColumnWidthMap) => void;
     /** Additional commands rendered in the TaskList row three-dots menu */
     taskListMenuCommands?: TaskListMenuCommand<TTask>[];
     /** Hide row action controls in the TaskList for table-like read/edit presentations. */
@@ -582,6 +602,8 @@ interface TableMatrixModeProps<TTask extends Task = Task> extends TaskChartShare
     matrixColumnGroups?: Array<TableMatrixColumnGroup>;
     /** Called when any data cell in the right-side matrix is clicked. */
     onMatrixCellClick?: (context: TableMatrixCellClickContext<TTask>) => void;
+    /** Optional actual-date overlay rendered under matrix cell content for date-ranged columns. */
+    matrixDateOverlay?: TableMatrixDateOverlay<TTask> | false;
 }
 type GanttChartProps<TTask extends Task = Task, TItem extends ResourceTimelineItem = ResourceTimelineItem> = GanttModeProps<TTask> | TableMatrixModeProps<TTask> | ResourcePlannerChartProps<TItem>;
 interface ExportToPdfOptions {
@@ -871,6 +893,10 @@ interface TaskListProps {
     additionalColumns?: TaskListColumn<any>[];
     /** Built-in or custom TaskList column IDs to hide after column placement is resolved */
     hiddenTaskListColumns?: readonly TaskListColumnId[];
+    /** Initial or controlled TaskList column widths keyed by built-in/custom column id. */
+    taskListColumnWidths?: TaskListColumnWidthMap;
+    /** Called when the user resizes TaskList columns. */
+    onTaskListColumnWidthsChange?: (widths: TaskListColumnWidthMap) => void;
     /** Additional commands rendered in each row three-dots menu */
     taskListMenuCommands?: TaskListMenuCommand<Task>[];
     /** Hide row action controls such as insert, hierarchy action buttons, and the context menu trigger. */
@@ -1380,4 +1406,4 @@ interface VisibleReorderPosition {
  */
 declare function getVisibleReorderPosition(orderedTasks: TaskLike[], visibleTasks: TaskLike[], movedTaskId: string, originVisibleIndex: number, dropVisibleIndex: number): VisibleReorderPosition | null;
 
-export { type BuiltInTaskListColumnId, Button, type ButtonProps, Calendar, type CalendarProps, type CustomDayConfig, type CustomDayPredicateConfig, DatePicker, type DatePickerProps, DragGuideLines, type ExportToPdfHeaderOptions, type ExportToPdfOptions, GanttChart, type GanttChartHandle, type GanttChartProps, type GanttModeProps, GridBackground, Input, type InputProps, type MonthBlock, Popover, PopoverContent, type PopoverContentProps, type PopoverProps, PopoverTrigger, ResourcePlannerChartProps, ResourceTimelineChart, type ResourceTimelineConflictRange, ResourceTimelineItem, type ResourceTimelineLayoutDiagnostic, type ResourceTimelineLayoutItem, type ResourceTimelineLayoutOptions, type ResourceTimelineLayoutResult, type ResourceTimelineLayoutRow, ResourceTimelineResource, TableMatrix, type TableMatrixCellClickContext, type TableMatrixColumn, type TableMatrixColumnGroup, type TableMatrixModeProps, type Task, TaskDateChangeMode, type TaskDependency, TaskList, type TaskListColumn, type TaskListColumnContext, type TaskListColumnId, type TaskListMenuCommand, type TaskListProps, type TaskPredicate, TaskRow, TimeScaleHeader, TodayIndicator, ValidationResult, type VisibleReorderPosition, type WeekBlock, type WeekSpan, type WithoutDepsOptions, type YearSpan, addBusinessDays, and, calculateBezierPath, calculateDependencyPath, calculateGridLines, calculateGridWidth, calculateMilestoneConnectionBounds, calculateMilestoneGeometry, calculateMonthGridLines, calculateOrthogonalPath, calculateTaskBar, calculateWeekGridLines, calculateWeekendBlocks, clampDateRangeForIncomingFS, createCustomDayPredicate, createDateKey, detectEdgeZone, expired, flattenHierarchy, formatDateLabel, formatDateRangeLabel, getBusinessDaysCount, getCursorForPosition, getDayOffset, getMonthBlocks, getMonthDays, getMonthSpans, getMultiMonthDays, getVisibleReorderPosition, getWeekBlocks, getWeekSpans, getYearSpans, inDateRange, isTaskExpired, isToday, isWeekend, layoutResourceTimelineItems, nameContains, normalizeHierarchyTasks, normalizeTaskDates, not, or, parseUTCDate, pixelsToDate, progressInRange, resolveDateRangeFromPixels, resolveTaskHorizontalGeometry, subtractBusinessDays, useTaskDrag, withoutDeps };
+export { type BuiltInTaskListColumnId, Button, type ButtonProps, Calendar, type CalendarProps, type CustomDayConfig, type CustomDayPredicateConfig, DatePicker, type DatePickerProps, DragGuideLines, type ExportToPdfHeaderOptions, type ExportToPdfOptions, GanttChart, type GanttChartHandle, type GanttChartProps, type GanttModeProps, GridBackground, Input, type InputProps, type MonthBlock, Popover, PopoverContent, type PopoverContentProps, type PopoverProps, PopoverTrigger, ResourcePlannerChartProps, ResourceTimelineChart, type ResourceTimelineConflictRange, ResourceTimelineItem, type ResourceTimelineLayoutDiagnostic, type ResourceTimelineLayoutItem, type ResourceTimelineLayoutOptions, type ResourceTimelineLayoutResult, type ResourceTimelineLayoutRow, ResourceTimelineResource, TableMatrix, type TableMatrixCellClickContext, type TableMatrixColumn, type TableMatrixColumnGroup, type TableMatrixDateOverlay, type TableMatrixModeProps, type Task, TaskDateChangeMode, type TaskDependency, TaskList, type TaskListColumn, type TaskListColumnContext, type TaskListColumnId, type TaskListColumnWidthMap, type TaskListMenuCommand, type TaskListProps, type TaskPredicate, TaskRow, TimeScaleHeader, TodayIndicator, ValidationResult, type VisibleReorderPosition, type WeekBlock, type WeekSpan, type WithoutDepsOptions, type YearSpan, addBusinessDays, and, calculateBezierPath, calculateDependencyPath, calculateGridLines, calculateGridWidth, calculateMilestoneConnectionBounds, calculateMilestoneGeometry, calculateMonthGridLines, calculateOrthogonalPath, calculateTaskBar, calculateWeekGridLines, calculateWeekendBlocks, clampDateRangeForIncomingFS, createCustomDayPredicate, createDateKey, detectEdgeZone, expired, flattenHierarchy, formatDateLabel, formatDateRangeLabel, getBusinessDaysCount, getCursorForPosition, getDayOffset, getMonthBlocks, getMonthDays, getMonthSpans, getMultiMonthDays, getVisibleReorderPosition, getWeekBlocks, getWeekSpans, getYearSpans, inDateRange, isTaskExpired, isToday, isWeekend, layoutResourceTimelineItems, nameContains, normalizeHierarchyTasks, normalizeTaskDates, not, or, parseUTCDate, pixelsToDate, progressInRange, resolveDateRangeFromPixels, resolveTaskHorizontalGeometry, subtractBusinessDays, useTaskDrag, withoutDeps };

package/dist/index.d.ts

@@ -305,6 +305,7 @@ declare const nameContains: (substring: string, caseSensitive?: boolean) => Task
 
 type BuiltInTaskListColumnId = 'selection' | 'number' | 'name' | 'startDate' | 'endDate' | 'duration' | 'progress' | 'dependencies' | 'actions';
 type TaskListColumnId = BuiltInTaskListColumnId | (string & {});
+type TaskListColumnWidthMap = Partial<Record<TaskListColumnId, number>>;
 type TaskListColumnAnchor = {
     after: BuiltInTaskListColumnId | string;
 } | {
@@ -343,6 +344,8 @@ interface TableMatrixColumn<TTask extends Task = Task> {
     width?: number | 'auto';
     minWidth?: number;
     maxWidth?: number;
+    periodStartDate?: string | Date;
+    periodEndDate?: string | Date;
     groupId?: string;
     align?: 'left' | 'center' | 'right';
     className?: string;
@@ -357,6 +360,18 @@ interface TableMatrixCellClickContext<TTask extends Task = Task> {
     columnIndex: number;
     event: React$1.MouseEvent<HTMLDivElement>;
 }
+interface TableMatrixDateOverlay<TTask extends Task = Task> {
+    date: string | Date;
+    className?: string;
+    color?: string;
+    edgeColor?: string;
+    shouldRender?: (context: {
+        task: TTask;
+        column: TableMatrixColumn<TTask>;
+        rowIndex: number;
+        columnIndex: number;
+    }) => boolean;
+}
 interface TableMatrixProps<TTask extends Task = Task> {
     tasks: TTask[];
     allTasks?: TTask[];
@@ -368,10 +383,11 @@ interface TableMatrixProps<TTask extends Task = Task> {
     selectedTaskId?: string | null;
     onTaskSelect?: (taskId: string | null) => void;
     onCellClick?: (context: TableMatrixCellClickContext<TTask>) => void;
+    dateOverlay?: TableMatrixDateOverlay<TTask> | false;
     highlightedTaskIds?: Set<string>;
     filterMode?: 'highlight' | 'hide';
 }
-declare function TableMatrix<TTask extends Task = Task>({ tasks, allTasks, columns, columnGroups, rowHeight, headerHeight, bodyMinHeight, selectedTaskId, onTaskSelect, onCellClick, highlightedTaskIds, filterMode, }: TableMatrixProps<TTask>): react_jsx_runtime.JSX.Element;
+declare function TableMatrix<TTask extends Task = Task>({ tasks, allTasks, columns, columnGroups, rowHeight, headerHeight, bodyMinHeight, selectedTaskId, onTaskSelect, onCellClick, dateOverlay, highlightedTaskIds, filterMode, }: TableMatrixProps<TTask>): react_jsx_runtime.JSX.Element;
 
 /**
  * Task data structure for Gantt chart
@@ -549,6 +565,10 @@ interface TaskChartSharedProps<TTask extends Task = Task> {
     additionalColumns?: TaskListColumn<TTask>[];
     /** Built-in or custom TaskList column IDs to hide after column placement is resolved */
     hiddenTaskListColumns?: readonly TaskListColumnId[];
+    /** Initial or controlled TaskList column widths keyed by built-in/custom column id. */
+    taskListColumnWidths?: TaskListColumnWidthMap;
+    /** Called when the user resizes TaskList columns. */
+    onTaskListColumnWidthsChange?: (widths: TaskListColumnWidthMap) => void;
     /** Additional commands rendered in the TaskList row three-dots menu */
     taskListMenuCommands?: TaskListMenuCommand<TTask>[];
     /** Hide row action controls in the TaskList for table-like read/edit presentations. */
@@ -582,6 +602,8 @@ interface TableMatrixModeProps<TTask extends Task = Task> extends TaskChartShare
     matrixColumnGroups?: Array<TableMatrixColumnGroup>;
     /** Called when any data cell in the right-side matrix is clicked. */
     onMatrixCellClick?: (context: TableMatrixCellClickContext<TTask>) => void;
+    /** Optional actual-date overlay rendered under matrix cell content for date-ranged columns. */
+    matrixDateOverlay?: TableMatrixDateOverlay<TTask> | false;
 }
 type GanttChartProps<TTask extends Task = Task, TItem extends ResourceTimelineItem = ResourceTimelineItem> = GanttModeProps<TTask> | TableMatrixModeProps<TTask> | ResourcePlannerChartProps<TItem>;
 interface ExportToPdfOptions {
@@ -871,6 +893,10 @@ interface TaskListProps {
     additionalColumns?: TaskListColumn<any>[];
     /** Built-in or custom TaskList column IDs to hide after column placement is resolved */
     hiddenTaskListColumns?: readonly TaskListColumnId[];
+    /** Initial or controlled TaskList column widths keyed by built-in/custom column id. */
+    taskListColumnWidths?: TaskListColumnWidthMap;
+    /** Called when the user resizes TaskList columns. */
+    onTaskListColumnWidthsChange?: (widths: TaskListColumnWidthMap) => void;
     /** Additional commands rendered in each row three-dots menu */
     taskListMenuCommands?: TaskListMenuCommand<Task>[];
     /** Hide row action controls such as insert, hierarchy action buttons, and the context menu trigger. */
@@ -1380,4 +1406,4 @@ interface VisibleReorderPosition {
  */
 declare function getVisibleReorderPosition(orderedTasks: TaskLike[], visibleTasks: TaskLike[], movedTaskId: string, originVisibleIndex: number, dropVisibleIndex: number): VisibleReorderPosition | null;
 
-export { type BuiltInTaskListColumnId, Button, type ButtonProps, Calendar, type CalendarProps, type CustomDayConfig, type CustomDayPredicateConfig, DatePicker, type DatePickerProps, DragGuideLines, type ExportToPdfHeaderOptions, type ExportToPdfOptions, GanttChart, type GanttChartHandle, type GanttChartProps, type GanttModeProps, GridBackground, Input, type InputProps, type MonthBlock, Popover, PopoverContent, type PopoverContentProps, type PopoverProps, PopoverTrigger, ResourcePlannerChartProps, ResourceTimelineChart, type ResourceTimelineConflictRange, ResourceTimelineItem, type ResourceTimelineLayoutDiagnostic, type ResourceTimelineLayoutItem, type ResourceTimelineLayoutOptions, type ResourceTimelineLayoutResult, type ResourceTimelineLayoutRow, ResourceTimelineResource, TableMatrix, type TableMatrixCellClickContext, type TableMatrixColumn, type TableMatrixColumnGroup, type TableMatrixModeProps, type Task, TaskDateChangeMode, type TaskDependency, TaskList, type TaskListColumn, type TaskListColumnContext, type TaskListColumnId, type TaskListMenuCommand, type TaskListProps, type TaskPredicate, TaskRow, TimeScaleHeader, TodayIndicator, ValidationResult, type VisibleReorderPosition, type WeekBlock, type WeekSpan, type WithoutDepsOptions, type YearSpan, addBusinessDays, and, calculateBezierPath, calculateDependencyPath, calculateGridLines, calculateGridWidth, calculateMilestoneConnectionBounds, calculateMilestoneGeometry, calculateMonthGridLines, calculateOrthogonalPath, calculateTaskBar, calculateWeekGridLines, calculateWeekendBlocks, clampDateRangeForIncomingFS, createCustomDayPredicate, createDateKey, detectEdgeZone, expired, flattenHierarchy, formatDateLabel, formatDateRangeLabel, getBusinessDaysCount, getCursorForPosition, getDayOffset, getMonthBlocks, getMonthDays, getMonthSpans, getMultiMonthDays, getVisibleReorderPosition, getWeekBlocks, getWeekSpans, getYearSpans, inDateRange, isTaskExpired, isToday, isWeekend, layoutResourceTimelineItems, nameContains, normalizeHierarchyTasks, normalizeTaskDates, not, or, parseUTCDate, pixelsToDate, progressInRange, resolveDateRangeFromPixels, resolveTaskHorizontalGeometry, subtractBusinessDays, useTaskDrag, withoutDeps };
+export { type BuiltInTaskListColumnId, Button, type ButtonProps, Calendar, type CalendarProps, type CustomDayConfig, type CustomDayPredicateConfig, DatePicker, type DatePickerProps, DragGuideLines, type ExportToPdfHeaderOptions, type ExportToPdfOptions, GanttChart, type GanttChartHandle, type GanttChartProps, type GanttModeProps, GridBackground, Input, type InputProps, type MonthBlock, Popover, PopoverContent, type PopoverContentProps, type PopoverProps, PopoverTrigger, ResourcePlannerChartProps, ResourceTimelineChart, type ResourceTimelineConflictRange, ResourceTimelineItem, type ResourceTimelineLayoutDiagnostic, type ResourceTimelineLayoutItem, type ResourceTimelineLayoutOptions, type ResourceTimelineLayoutResult, type ResourceTimelineLayoutRow, ResourceTimelineResource, TableMatrix, type TableMatrixCellClickContext, type TableMatrixColumn, type TableMatrixColumnGroup, type TableMatrixDateOverlay, type TableMatrixModeProps, type Task, TaskDateChangeMode, type TaskDependency, TaskList, type TaskListColumn, type TaskListColumnContext, type TaskListColumnId, type TaskListColumnWidthMap, type TaskListMenuCommand, type TaskListProps, type TaskPredicate, TaskRow, TimeScaleHeader, TodayIndicator, ValidationResult, type VisibleReorderPosition, type WeekBlock, type WeekSpan, type WithoutDepsOptions, type YearSpan, addBusinessDays, and, calculateBezierPath, calculateDependencyPath, calculateGridLines, calculateGridWidth, calculateMilestoneConnectionBounds, calculateMilestoneGeometry, calculateMonthGridLines, calculateOrthogonalPath, calculateTaskBar, calculateWeekGridLines, calculateWeekendBlocks, clampDateRangeForIncomingFS, createCustomDayPredicate, createDateKey, detectEdgeZone, expired, flattenHierarchy, formatDateLabel, formatDateRangeLabel, getBusinessDaysCount, getCursorForPosition, getDayOffset, getMonthBlocks, getMonthDays, getMonthSpans, getMultiMonthDays, getVisibleReorderPosition, getWeekBlocks, getWeekSpans, getYearSpans, inDateRange, isTaskExpired, isToday, isWeekend, layoutResourceTimelineItems, nameContains, normalizeHierarchyTasks, normalizeTaskDates, not, or, parseUTCDate, pixelsToDate, progressInRange, resolveDateRangeFromPixels, resolveTaskHorizontalGeometry, subtractBusinessDays, useTaskDrag, withoutDeps };