gantt-lib 0.144.1 → 0.145.0

package/README.md

@@ -594,3 +594,41 @@ activityDependencyHighlight={{
 ### Hidden system dependencies
 
 Set TaskDependency.hidden to true to omit its arrow, predecessor chip and print label. The full dependency remains available to validation, drag constraints and cascading; this is a presentation flag, not a scheduling switch.
+
+
+### Consumer-owned task controls (0.145.0)
+
+Task callbacks no longer add implicit menu items or row buttons. `taskListMenuCommands`
+continues to render explicitly configured commands (scope, visibility, disabled state,
+icons, dividers and close behavior). An empty command list produces no menu trigger.
+`enableAddTask` now defaults to `false`; set it to `true` with `onAdd` to show the footer.
+
+Use `renderTaskListActions(context)` for arbitrary row buttons and
+`renderTaskListMenu(context, commands)` to replace or compose the entire menu.
+Return `null` to omit either surface for a row. `hideTaskListRowActions` suppresses
+both slots and commands. Context contains `task`, `isParent`, `canPromote`,
+`canDemote`, `closeMenu`, and optional `insertAfter`, `promote`, `demote`, `duplicate`,
+`delete`, `ungroup` operations. Unsupported operations are `undefined`.
+The library retains scheduling, hierarchy and inline-insert behavior; the consumer
+owns labels, icons, colors, menu composition and business actions.
+
+```tsx
+<GanttChart tasks={tasks} showTaskList onTasksChange={setChangedTasks}
+  onAdd={addTask} onInsertAfter={insertTask} onDelete={deleteTask}
+  enableAddTask
+  renderTaskListActions={({ insertAfter, promote, demote }) => <>
+    {insertAfter && <button onClick={insertAfter}>+</button>}
+    {promote && <button onClick={promote}>Promote</button>}
+    {demote && <button onClick={demote}>Demote</button>}
+  </>}
+  renderTaskListMenu={({ task, delete: remove, closeMenu }, commands) => <>
+    {commands}
+    {remove && <button onClick={() => { closeMenu(); remove(); }}>Delete {task.name}</button>}
+  </>}
+/>
+```
+
+Migrate color selection into the application, emitting changed task copies through
+`onTasksChange`. To preserve the previous parent-color behavior, include descendants.
+Do not mutate the context task. Use the optional operation callbacks to preserve the
+library's descendant deletion, duplication and hierarchy scheduling semantics.

package/dist/index.d.mts

@@ -568,6 +568,20 @@ interface TaskDependency {
     /** Lag in days */
     lag: number;
 }
+/** Capability-checked operations for a consumer-owned task action surface. */
+interface TaskListActionContext<TTask extends Task = Task> {
+    task: TTask;
+    isParent: boolean;
+    canPromote: boolean;
+    canDemote: boolean;
+    insertAfter?: () => void;
+    promote?: () => void;
+    demote?: () => void;
+    duplicate?: () => void;
+    delete?: () => void;
+    ungroup?: () => void;
+    closeMenu: () => void;
+}
 interface TaskListMenuCommand<TTask extends Task = Task> {
     /** Stable command id for React keys and consumer bookkeeping */
     id: string;
@@ -719,6 +733,10 @@ interface TaskChartSharedProps<TTask extends Task = Task> {
     onTaskListColumnWidthsChange?: (widths: TaskListColumnWidthMap) => void;
     /** Additional commands rendered in the TaskList row three-dots menu */
     taskListMenuCommands?: TaskListMenuCommand<TTask>[];
+    /** No buttons render unless this slot is supplied. */
+    renderTaskListActions?: (context: TaskListActionContext<TTask>) => React$1.ReactNode;
+    /** Replace/compose the menu; commands contains the configured taskListMenuCommands UI. */
+    renderTaskListMenu?: (context: TaskListActionContext<TTask>, commands: React$1.ReactNode) => React$1.ReactNode;
     /** Hide row action controls in the TaskList for table-like read/edit presentations. */
     hideTaskListRowActions?: boolean;
     /** Returns an extra CSS class name for a TaskList row. */
@@ -1240,6 +1258,8 @@ interface TaskListProps {
     onTaskListColumnWidthsChange?: (widths: TaskListColumnWidthMap) => void;
     /** Additional commands rendered in each row three-dots menu */
     taskListMenuCommands?: TaskListMenuCommand<Task>[];
+    renderTaskListActions?: (context: TaskListActionContext<Task>) => React$1.ReactNode;
+    renderTaskListMenu?: (context: TaskListActionContext<Task>, commands: React$1.ReactNode) => React$1.ReactNode;
     /** Hide row action controls such as insert, hierarchy action buttons, and the context menu trigger. */
     hideTaskListRowActions?: boolean;
     /** Returns an extra CSS class name for a TaskList row. */
@@ -1904,4 +1924,4 @@ interface ResourceTimelineLayoutResult<TItem extends ResourceTimelineItem = Reso
 }
 declare const layoutResourceTimelineItems: <TItem extends ResourceTimelineItem = ResourceTimelineItem>(resources: Array<ResourceTimelineResource<TItem>>, options: ResourceTimelineLayoutOptions) => ResourceTimelineLayoutResult<TItem>;
 
-export { ACTIVITY_LANES_PADDING, ACTIVITY_LANE_BAR_HEIGHT, ACTIVITY_LANE_STEP, type ActivityChainPushResult, type ActivityChainShift, type ActivityChainTask, ActivityDependencyHighlight, type ActivityLanesLayout, type ActivitySegment, type ActivityStartConstraint, ActivityTooltipContext, 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, GanttDateRange, type GanttModeProps, GanttScheduleIntent, GenerationSkeletonRows, type GenerationSkeletonRowsProps, type GenerationSkeletonTaskListLayout, type GenerationSkeletonVariant, GridBackground, Input, type InputProps, MIN_EDGE_ZONE_PX, MIN_MOVE_ZONE_PX, type MonthBlock, type PlanFactCellCommitContext, type PlanFactCellKind, PlanFactMatrix, type PlanFactModeProps, Popover, PopoverContent, type PopoverContentProps, type PopoverProps, PopoverTrigger, type ReorderDropPlacement, type ReorderDropTarget, ResourcePlannerChartProps, ResourceTimelineChart, type ResourceTimelineConflictRange, ResourceTimelineItem, type ResourceTimelineLayoutDiagnostic, type ResourceTimelineLayoutItem, type ResourceTimelineLayoutOptions, type ResourceTimelineLayoutResult, type ResourceTimelineLayoutRow, ResourceTimelineResource, ScaleTaskSubtreeResult, TableMatrix, type TableMatrixCellClickContext, type TableMatrixColumn, type TableMatrixColumnGroup, type TableMatrixDateOverlay, type TableMatrixModeProps, type Task, TaskActivity$1 as TaskActivity, TaskActivityDependency, TaskDateChangeMode, type TaskDependency, TaskList, type TaskListColumn, type TaskListColumnContext, type TaskListColumnId, type TaskListColumnWidthMap, type TaskListMenuCommand, type TaskListProps, type TaskPredicate, TaskRow, TimeScaleHeader, TimelineMarker, TodayIndicator, ValidationResult, type VisibleReorderPlan, type VisibleReorderPosition, type WeekBlock, type WeekSpan, type WithoutDepsOptions, type YearSpan, activityBounds, activityChainMinStartDelta, activityLanesExtraHeight, activitySpanMs, activityStartConstraint, addBusinessDays, and, calculateBezierPath, calculateDependencyPath, calculateGridLines, calculateGridWidth, calculateMilestoneConnectionBounds, calculateMilestoneGeometry, calculateMonthGridLines, calculateOrthogonalPath, calculateTaskBar, calculateWeekGridLines, calculateWeekendBlocks, clampDateRangeForIncomingFS, computeActivityLanes, createCustomDayPredicate, createDateKey, detectEdgeZone, expired, flattenHierarchy, formatDateLabel, formatDateRangeLabel, getBusinessDaysCount, getCursorForPosition, getDateRangeDays, getDayOffset, getMonthBlocks, getMonthDays, getMonthSpans, getMultiMonthDays, getTodayLocalUtcDate, getVisibleReorderPlan, getVisibleReorderPosition, getWeekBlocks, getWeekSpans, getYearSpans, inDateRange, isTaskExpired, isToday, isWeekend, layoutResourceTimelineItems, nameContains, normalizeHierarchyTasks, normalizeTaskDates, not, or, packIntervals, parseUTCDate, pixelsToDate, progressInRange, pushActivityChain, resolveDateRangeFromPixels, resolveTaskHorizontalGeometry, shiftActivityChain, shiftActivityDate, subtractBusinessDays, useTaskDrag, withoutDeps };
+export { ACTIVITY_LANES_PADDING, ACTIVITY_LANE_BAR_HEIGHT, ACTIVITY_LANE_STEP, type ActivityChainPushResult, type ActivityChainShift, type ActivityChainTask, ActivityDependencyHighlight, type ActivityLanesLayout, type ActivitySegment, type ActivityStartConstraint, ActivityTooltipContext, 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, GanttDateRange, type GanttModeProps, GanttScheduleIntent, GenerationSkeletonRows, type GenerationSkeletonRowsProps, type GenerationSkeletonTaskListLayout, type GenerationSkeletonVariant, GridBackground, Input, type InputProps, MIN_EDGE_ZONE_PX, MIN_MOVE_ZONE_PX, type MonthBlock, type PlanFactCellCommitContext, type PlanFactCellKind, PlanFactMatrix, type PlanFactModeProps, Popover, PopoverContent, type PopoverContentProps, type PopoverProps, PopoverTrigger, type ReorderDropPlacement, type ReorderDropTarget, ResourcePlannerChartProps, ResourceTimelineChart, type ResourceTimelineConflictRange, ResourceTimelineItem, type ResourceTimelineLayoutDiagnostic, type ResourceTimelineLayoutItem, type ResourceTimelineLayoutOptions, type ResourceTimelineLayoutResult, type ResourceTimelineLayoutRow, ResourceTimelineResource, ScaleTaskSubtreeResult, TableMatrix, type TableMatrixCellClickContext, type TableMatrixColumn, type TableMatrixColumnGroup, type TableMatrixDateOverlay, type TableMatrixModeProps, type Task, TaskActivity$1 as TaskActivity, TaskActivityDependency, TaskDateChangeMode, type TaskDependency, TaskList, type TaskListActionContext, type TaskListColumn, type TaskListColumnContext, type TaskListColumnId, type TaskListColumnWidthMap, type TaskListMenuCommand, type TaskListProps, type TaskPredicate, TaskRow, TimeScaleHeader, TimelineMarker, TodayIndicator, ValidationResult, type VisibleReorderPlan, type VisibleReorderPosition, type WeekBlock, type WeekSpan, type WithoutDepsOptions, type YearSpan, activityBounds, activityChainMinStartDelta, activityLanesExtraHeight, activitySpanMs, activityStartConstraint, addBusinessDays, and, calculateBezierPath, calculateDependencyPath, calculateGridLines, calculateGridWidth, calculateMilestoneConnectionBounds, calculateMilestoneGeometry, calculateMonthGridLines, calculateOrthogonalPath, calculateTaskBar, calculateWeekGridLines, calculateWeekendBlocks, clampDateRangeForIncomingFS, computeActivityLanes, createCustomDayPredicate, createDateKey, detectEdgeZone, expired, flattenHierarchy, formatDateLabel, formatDateRangeLabel, getBusinessDaysCount, getCursorForPosition, getDateRangeDays, getDayOffset, getMonthBlocks, getMonthDays, getMonthSpans, getMultiMonthDays, getTodayLocalUtcDate, getVisibleReorderPlan, getVisibleReorderPosition, getWeekBlocks, getWeekSpans, getYearSpans, inDateRange, isTaskExpired, isToday, isWeekend, layoutResourceTimelineItems, nameContains, normalizeHierarchyTasks, normalizeTaskDates, not, or, packIntervals, parseUTCDate, pixelsToDate, progressInRange, pushActivityChain, resolveDateRangeFromPixels, resolveTaskHorizontalGeometry, shiftActivityChain, shiftActivityDate, subtractBusinessDays, useTaskDrag, withoutDeps };

package/dist/index.d.ts

@@ -568,6 +568,20 @@ interface TaskDependency {
     /** Lag in days */
     lag: number;
 }
+/** Capability-checked operations for a consumer-owned task action surface. */
+interface TaskListActionContext<TTask extends Task = Task> {
+    task: TTask;
+    isParent: boolean;
+    canPromote: boolean;
+    canDemote: boolean;
+    insertAfter?: () => void;
+    promote?: () => void;
+    demote?: () => void;
+    duplicate?: () => void;
+    delete?: () => void;
+    ungroup?: () => void;
+    closeMenu: () => void;
+}
 interface TaskListMenuCommand<TTask extends Task = Task> {
     /** Stable command id for React keys and consumer bookkeeping */
     id: string;
@@ -719,6 +733,10 @@ interface TaskChartSharedProps<TTask extends Task = Task> {
     onTaskListColumnWidthsChange?: (widths: TaskListColumnWidthMap) => void;
     /** Additional commands rendered in the TaskList row three-dots menu */
     taskListMenuCommands?: TaskListMenuCommand<TTask>[];
+    /** No buttons render unless this slot is supplied. */
+    renderTaskListActions?: (context: TaskListActionContext<TTask>) => React$1.ReactNode;
+    /** Replace/compose the menu; commands contains the configured taskListMenuCommands UI. */
+    renderTaskListMenu?: (context: TaskListActionContext<TTask>, commands: React$1.ReactNode) => React$1.ReactNode;
     /** Hide row action controls in the TaskList for table-like read/edit presentations. */
     hideTaskListRowActions?: boolean;
     /** Returns an extra CSS class name for a TaskList row. */
@@ -1240,6 +1258,8 @@ interface TaskListProps {
     onTaskListColumnWidthsChange?: (widths: TaskListColumnWidthMap) => void;
     /** Additional commands rendered in each row three-dots menu */
     taskListMenuCommands?: TaskListMenuCommand<Task>[];
+    renderTaskListActions?: (context: TaskListActionContext<Task>) => React$1.ReactNode;
+    renderTaskListMenu?: (context: TaskListActionContext<Task>, commands: React$1.ReactNode) => React$1.ReactNode;
     /** Hide row action controls such as insert, hierarchy action buttons, and the context menu trigger. */
     hideTaskListRowActions?: boolean;
     /** Returns an extra CSS class name for a TaskList row. */
@@ -1904,4 +1924,4 @@ interface ResourceTimelineLayoutResult<TItem extends ResourceTimelineItem = Reso
 }
 declare const layoutResourceTimelineItems: <TItem extends ResourceTimelineItem = ResourceTimelineItem>(resources: Array<ResourceTimelineResource<TItem>>, options: ResourceTimelineLayoutOptions) => ResourceTimelineLayoutResult<TItem>;
 
-export { ACTIVITY_LANES_PADDING, ACTIVITY_LANE_BAR_HEIGHT, ACTIVITY_LANE_STEP, type ActivityChainPushResult, type ActivityChainShift, type ActivityChainTask, ActivityDependencyHighlight, type ActivityLanesLayout, type ActivitySegment, type ActivityStartConstraint, ActivityTooltipContext, 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, GanttDateRange, type GanttModeProps, GanttScheduleIntent, GenerationSkeletonRows, type GenerationSkeletonRowsProps, type GenerationSkeletonTaskListLayout, type GenerationSkeletonVariant, GridBackground, Input, type InputProps, MIN_EDGE_ZONE_PX, MIN_MOVE_ZONE_PX, type MonthBlock, type PlanFactCellCommitContext, type PlanFactCellKind, PlanFactMatrix, type PlanFactModeProps, Popover, PopoverContent, type PopoverContentProps, type PopoverProps, PopoverTrigger, type ReorderDropPlacement, type ReorderDropTarget, ResourcePlannerChartProps, ResourceTimelineChart, type ResourceTimelineConflictRange, ResourceTimelineItem, type ResourceTimelineLayoutDiagnostic, type ResourceTimelineLayoutItem, type ResourceTimelineLayoutOptions, type ResourceTimelineLayoutResult, type ResourceTimelineLayoutRow, ResourceTimelineResource, ScaleTaskSubtreeResult, TableMatrix, type TableMatrixCellClickContext, type TableMatrixColumn, type TableMatrixColumnGroup, type TableMatrixDateOverlay, type TableMatrixModeProps, type Task, TaskActivity$1 as TaskActivity, TaskActivityDependency, TaskDateChangeMode, type TaskDependency, TaskList, type TaskListColumn, type TaskListColumnContext, type TaskListColumnId, type TaskListColumnWidthMap, type TaskListMenuCommand, type TaskListProps, type TaskPredicate, TaskRow, TimeScaleHeader, TimelineMarker, TodayIndicator, ValidationResult, type VisibleReorderPlan, type VisibleReorderPosition, type WeekBlock, type WeekSpan, type WithoutDepsOptions, type YearSpan, activityBounds, activityChainMinStartDelta, activityLanesExtraHeight, activitySpanMs, activityStartConstraint, addBusinessDays, and, calculateBezierPath, calculateDependencyPath, calculateGridLines, calculateGridWidth, calculateMilestoneConnectionBounds, calculateMilestoneGeometry, calculateMonthGridLines, calculateOrthogonalPath, calculateTaskBar, calculateWeekGridLines, calculateWeekendBlocks, clampDateRangeForIncomingFS, computeActivityLanes, createCustomDayPredicate, createDateKey, detectEdgeZone, expired, flattenHierarchy, formatDateLabel, formatDateRangeLabel, getBusinessDaysCount, getCursorForPosition, getDateRangeDays, getDayOffset, getMonthBlocks, getMonthDays, getMonthSpans, getMultiMonthDays, getTodayLocalUtcDate, getVisibleReorderPlan, getVisibleReorderPosition, getWeekBlocks, getWeekSpans, getYearSpans, inDateRange, isTaskExpired, isToday, isWeekend, layoutResourceTimelineItems, nameContains, normalizeHierarchyTasks, normalizeTaskDates, not, or, packIntervals, parseUTCDate, pixelsToDate, progressInRange, pushActivityChain, resolveDateRangeFromPixels, resolveTaskHorizontalGeometry, shiftActivityChain, shiftActivityDate, subtractBusinessDays, useTaskDrag, withoutDeps };
+export { ACTIVITY_LANES_PADDING, ACTIVITY_LANE_BAR_HEIGHT, ACTIVITY_LANE_STEP, type ActivityChainPushResult, type ActivityChainShift, type ActivityChainTask, ActivityDependencyHighlight, type ActivityLanesLayout, type ActivitySegment, type ActivityStartConstraint, ActivityTooltipContext, 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, GanttDateRange, type GanttModeProps, GanttScheduleIntent, GenerationSkeletonRows, type GenerationSkeletonRowsProps, type GenerationSkeletonTaskListLayout, type GenerationSkeletonVariant, GridBackground, Input, type InputProps, MIN_EDGE_ZONE_PX, MIN_MOVE_ZONE_PX, type MonthBlock, type PlanFactCellCommitContext, type PlanFactCellKind, PlanFactMatrix, type PlanFactModeProps, Popover, PopoverContent, type PopoverContentProps, type PopoverProps, PopoverTrigger, type ReorderDropPlacement, type ReorderDropTarget, ResourcePlannerChartProps, ResourceTimelineChart, type ResourceTimelineConflictRange, ResourceTimelineItem, type ResourceTimelineLayoutDiagnostic, type ResourceTimelineLayoutItem, type ResourceTimelineLayoutOptions, type ResourceTimelineLayoutResult, type ResourceTimelineLayoutRow, ResourceTimelineResource, ScaleTaskSubtreeResult, TableMatrix, type TableMatrixCellClickContext, type TableMatrixColumn, type TableMatrixColumnGroup, type TableMatrixDateOverlay, type TableMatrixModeProps, type Task, TaskActivity$1 as TaskActivity, TaskActivityDependency, TaskDateChangeMode, type TaskDependency, TaskList, type TaskListActionContext, type TaskListColumn, type TaskListColumnContext, type TaskListColumnId, type TaskListColumnWidthMap, type TaskListMenuCommand, type TaskListProps, type TaskPredicate, TaskRow, TimeScaleHeader, TimelineMarker, TodayIndicator, ValidationResult, type VisibleReorderPlan, type VisibleReorderPosition, type WeekBlock, type WeekSpan, type WithoutDepsOptions, type YearSpan, activityBounds, activityChainMinStartDelta, activityLanesExtraHeight, activitySpanMs, activityStartConstraint, addBusinessDays, and, calculateBezierPath, calculateDependencyPath, calculateGridLines, calculateGridWidth, calculateMilestoneConnectionBounds, calculateMilestoneGeometry, calculateMonthGridLines, calculateOrthogonalPath, calculateTaskBar, calculateWeekGridLines, calculateWeekendBlocks, clampDateRangeForIncomingFS, computeActivityLanes, createCustomDayPredicate, createDateKey, detectEdgeZone, expired, flattenHierarchy, formatDateLabel, formatDateRangeLabel, getBusinessDaysCount, getCursorForPosition, getDateRangeDays, getDayOffset, getMonthBlocks, getMonthDays, getMonthSpans, getMultiMonthDays, getTodayLocalUtcDate, getVisibleReorderPlan, getVisibleReorderPosition, getWeekBlocks, getWeekSpans, getYearSpans, inDateRange, isTaskExpired, isToday, isWeekend, layoutResourceTimelineItems, nameContains, normalizeHierarchyTasks, normalizeTaskDates, not, or, packIntervals, parseUTCDate, pixelsToDate, progressInRange, pushActivityChain, resolveDateRangeFromPixels, resolveTaskHorizontalGeometry, shiftActivityChain, shiftActivityDate, subtractBusinessDays, useTaskDrag, withoutDeps };