gantt-lib 0.0.4 → 0.0.6

package/dist/index.d.ts

@@ -1,5 +1,139 @@
 import React$1 from 'react';
 
+/**
+ * Dependency link types following PM standard
+ * - FS (Finish-to-Start): Predecessor must finish before successor starts
+ * - SS (Start-to-Start): Predecessor must start before successor starts
+ * - FF (Finish-to-Finish): Predecessor must finish before successor finishes
+ * - SF (Start-to-Finish): Predecessor must start before successor finishes
+ */
+type LinkType = 'FS' | 'SS' | 'FF' | 'SF';
+/**
+ * Single dependency relationship (predecessor link)
+ */
+interface TaskDependency$1 {
+    /** ID of the predecessor task */
+    taskId: string;
+    /** Type of link: FS (finish-to-start), SS, FF, SF */
+    type: LinkType;
+    /** Lag in days (positive or negative integer, default: 0) */
+    lag?: number;
+}
+/**
+ * Error or warning from dependency validation
+ */
+interface DependencyError {
+    /** Type of error */
+    type: 'cycle' | 'constraint' | 'missing-task';
+    /** ID of the task with the error */
+    taskId: string;
+    /** Human-readable error message */
+    message: string;
+    /** Related task IDs (e.g., cycle path, referenced tasks) */
+    relatedTaskIds?: string[];
+}
+/**
+ * Result of dependency validation
+ */
+interface ValidationResult {
+    /** True if no errors found */
+    isValid: boolean;
+    /** Array of errors/warnings (empty if valid) */
+    errors: DependencyError[];
+}
+/**
+ * Task data structure for Gantt chart
+ */
+interface Task$1 {
+    /** Unique identifier for the task */
+    id: string;
+    /** Display name of the task */
+    name: string;
+    /** Task start date (ISO string or Date object) */
+    startDate: string | Date;
+    /** Task end date (ISO string or Date object) */
+    endDate: string | Date;
+    /** Optional color for task bar visualization */
+    color?: string;
+    /**
+     * Optional progress value from 0-100
+     * - Decimal values are allowed and rounded to nearest integer for display
+     * - Values are clamped to 0-100 range
+     * - Undefined or 0 means no progress is displayed
+     * - Progress is visual-only, no user interaction
+     */
+    progress?: number;
+    /**
+     * Optional flag indicating if task is accepted
+     * - Only meaningful when progress is 100%
+     * - Affects the color of the progress bar (green for accepted, yellow for completed)
+     */
+    accepted?: boolean;
+    /**
+     * Optional array of predecessor dependencies
+     * Each dependency specifies a predecessor task, link type, and optional lag
+     */
+    dependencies?: TaskDependency$1[];
+}
+/**
+ * Date range for Gantt chart display
+ */
+interface GanttDateRange {
+    /** Start date of the visible range */
+    start: Date;
+    /** End date of the visible range */
+    end: Date;
+}
+/**
+ * Task bar positioning and dimensions
+ */
+interface TaskBarGeometry {
+    /** Left position in pixels */
+    left: number;
+    /** Width in pixels */
+    width: number;
+}
+/**
+ * Grid configuration for layout calculations
+ */
+interface GridConfig {
+    /** Width of each day column in pixels */
+    dayWidth: number;
+    /** Height of each task row in pixels */
+    rowHeight: number;
+}
+/**
+ * Represents a month span in the calendar header
+ */
+interface MonthSpan {
+    /** First day of the month (UTC) */
+    month: Date;
+    /** Number of days this month spans in the visible range */
+    days: number;
+    /** Start index in the date range array */
+    startIndex: number;
+}
+/**
+ * Represents a vertical grid line
+ */
+interface GridLine {
+    /** X position in pixels */
+    x: number;
+    /** True if this line is at the start of a month */
+    isMonthStart: boolean;
+    /** True if this line is at the start of a week (Monday) */
+    isWeekStart: boolean;
+}
+/**
+ * Represents a weekend background block
+ */
+interface WeekendBlock {
+    /** Left position in pixels */
+    left: number;
+    /** Width in pixels */
+    width: number;
+}
+
 /**
  * Task data structure for Gantt chart
  */
@@ -14,6 +148,38 @@ interface Task {
     endDate: string | Date;
     /** Optional color for task bar visualization */
     color?: string;
+    /**
+     * Optional progress value from 0-100
+     * - Decimal values are allowed and rounded to nearest integer for display
+     * - Values are clamped to 0-100 range
+     * - Undefined or 0 means no progress is displayed
+     * - Progress is visual-only, no user interaction
+     */
+    progress?: number;
+    /**
+     * Optional flag indicating if task is accepted
+     * - Only meaningful when progress is 100%
+     * - Affects the color of the progress bar (green for accepted, yellow for completed)
+     */
+    accepted?: boolean;
+    /**
+     * Optional array of task dependencies
+     * - Each dependency references a predecessor task by ID
+     * - Supports 4 link types: FS (finish-to-start), SS (start-to-start), FF (finish-to-finish), SF (start-to-finish)
+     * - Lag is optional and defaults to 0 (positive = delay, negative = overlap)
+     */
+    dependencies?: TaskDependency[];
+}
+/**
+ * Task dependency definition
+ */
+interface TaskDependency {
+    /** ID of the predecessor task */
+    taskId: string;
+    /** Link type: FS, SS, FF, or SF */
+    type: 'FS' | 'SS' | 'FF' | 'SF';
+    /** Optional lag in days (default: 0) */
+    lag?: number;
 }
 interface GanttChartProps {
     /** Array of tasks to display */
@@ -28,6 +194,14 @@ interface GanttChartProps {
     containerHeight?: number;
     /** Callback when tasks are modified via drag/resize. Can receive either the new tasks array or a functional updater. */
     onChange?: (tasks: Task[] | ((currentTasks: Task[]) => Task[])) => void;
+    /** Optional callback for dependency validation results */
+    onValidateDependencies?: (result: ValidationResult) => void;
+    /** Enable automatic shifting of dependent tasks when predecessor moves (default: false) */
+    enableAutoSchedule?: boolean;
+    /** Disable dependency constraint checking during drag (default: false) */
+    disableConstraints?: boolean;
+    /** Called when a cascade drag completes; receives all shifted tasks (including dragged task) in hard mode */
+    onCascade?: (tasks: Task[]) => void;
 }
 /**
  * GanttChart component - displays tasks on a monthly timeline with Excel-like styling
@@ -65,6 +239,26 @@ interface TaskRowProps {
         left: number;
         width: number;
     }) => void;
+    /** Index of the task row (used for dependency rendering) */
+    rowIndex?: number;
+    /** All tasks in the chart (used for dependency validation) */
+    allTasks?: Task[];
+    /** Whether auto-scheduling is enabled */
+    enableAutoSchedule?: boolean;
+    /** Whether to disable constraint checking during drag */
+    disableConstraints?: boolean;
+    /** Position override for cascade preview — when set, overrides both static and drag position */
+    overridePosition?: {
+        left: number;
+        width: number;
+    };
+    /** Called each RAF during cascade drag with override positions for non-dragged chain tasks */
+    onCascadeProgress?: (overrides: Map<string, {
+        left: number;
+        width: number;
+    }>) => void;
+    /** Called when cascade drag completes; receives all shifted tasks including dragged task */
+    onCascade?: (tasks: Task[]) => void;
 }
 /**
  * TaskRow component - renders a single task row with a task bar
@@ -154,6 +348,7 @@ interface UseTaskDragOptions {
         id: string;
         startDate: Date;
         endDate: Date;
+        updatedDependencies?: Task$1['dependencies'];
     }) => void;
     /** Callback for drag state changes (for parent components to render guide lines) */
     onDragStateChange?: (state: {
@@ -164,6 +359,21 @@ interface UseTaskDragOptions {
     }) => void;
     /** Width of edge zones for resize detection (default: 12px) */
     edgeZoneWidth?: number;
+    /** Array of all tasks for dependency validation */
+    allTasks?: Task$1[];
+    /** Row index of this task (for task lookup) */
+    rowIndex?: number;
+    /** Enable automatic scheduling of dependent tasks */
+    enableAutoSchedule?: boolean;
+    /** When true, dependency constraint checking is skipped during drag (default: false) */
+    disableConstraints?: boolean;
+    /** Callback for real-time cascade preview — called each RAF with non-dragged chain member positions */
+    onCascadeProgress?: (overrides: Map<string, {
+        left: number;
+        width: number;
+    }>) => void;
+    /** Callback when cascade completes — receives all shifted tasks including dragged task */
+    onCascade?: (tasks: Task$1[]) => void;
 }
 /**
  * Return value from useTaskDrag hook
@@ -251,6 +461,52 @@ declare const getMonthSpans: (dateRange: Date[]) => Array<{
  */
 declare const formatDateLabel: (date: Date | string) => string;
 
+/**
+ * Build adjacency list for dependency graph (task -> successors)
+ */
+declare function buildAdjacencyList(tasks: Task$1[]): Map<string, string[]>;
+/**
+ * Detect circular dependencies using depth-first search
+ */
+declare function detectCycles(tasks: Task$1[]): {
+    hasCycle: boolean;
+    cyclePath?: string[];
+};
+/**
+ * Calculate successor date based on predecessor dates, link type, and lag
+ *
+ * Link type semantics:
+ * - FS: Successor start = Predecessor end + lag
+ * - SS: Successor start = Predecessor start + lag
+ * - FF: Successor end = Predecessor end + lag
+ * - SF: Successor end = Predecessor start + lag
+ */
+declare function calculateSuccessorDate(predecessorStart: Date, predecessorEnd: Date, linkType: LinkType, lag?: number): Date;
+/**
+ * Validate all dependencies in the task list
+ */
+declare function validateDependencies(tasks: Task$1[]): ValidationResult;
+/**
+ * Get all FS successor tasks of a dragged task using BFS (FS edges only, Phase 7).
+ *
+ * Returns tasks in breadth-first order (direct successors first, then their successors).
+ * The dragged task itself is NOT included in the returned array.
+ *
+ * The visited set prevents infinite loops in case of cycles (cycle detection already
+ * prevents cycles in valid data, but the guard adds safety during cascade computation).
+ */
+declare function getSuccessorChain(draggedTaskId: string, allTasks: Task$1[]): Task$1[];
+/**
+ * Get all dependency edges for rendering
+ * Returns array of { predecessorId, successorId, type, lag }
+ */
+declare function getAllDependencyEdges(tasks: Task$1[]): Array<{
+    predecessorId: string;
+    successorId: string;
+    type: LinkType;
+    lag: number;
+}>;
+
 /**
  * Calculate task bar positioning and dimensions
  * @param taskStartDate - Start date of the task
@@ -313,64 +569,33 @@ declare const calculateWeekendBlocks: (dateRange: Date[], dayWidth: number) => A
     left: number;
     width: number;
 }>;
-
-/**
- * Date range for Gantt chart display
- */
-interface GanttDateRange {
-    /** Start date of the visible range */
-    start: Date;
-    /** End date of the visible range */
-    end: Date;
-}
-/**
- * Task bar positioning and dimensions
- */
-interface TaskBarGeometry {
-    /** Left position in pixels */
-    left: number;
-    /** Width in pixels */
-    width: number;
-}
-/**
- * Grid configuration for layout calculations
- */
-interface GridConfig {
-    /** Width of each day column in pixels */
-    dayWidth: number;
-    /** Height of each task row in pixels */
-    rowHeight: number;
-}
 /**
- * Represents a month span in the calendar header
+ * Calculate SVG cubic Bezier curve path for dependency lines
+ * @param from - Start point {x, y} (right edge of predecessor)
+ * @param to - End point {x, y} (left edge of successor)
+ * @returns SVG path string for cubic Bezier curve
  */
-interface MonthSpan {
-    /** First day of the month (UTC) */
-    month: Date;
-    /** Number of days this month spans in the visible range */
-    days: number;
-    /** Start index in the date range array */
-    startIndex: number;
-}
-/**
- * Represents a vertical grid line
- */
-interface GridLine {
-    /** X position in pixels */
+declare const calculateBezierPath: (from: {
     x: number;
-    /** True if this line is at the start of a month */
-    isMonthStart: boolean;
-    /** True if this line is at the start of a week (Monday) */
-    isWeekStart: boolean;
-}
+    y: number;
+}, to: {
+    x: number;
+    y: number;
+}) => string;
 /**
- * Represents a weekend background block
+ * Calculate SVG Г-shaped (L-shaped) path for FS dependency lines.
+ * Goes vertically from the right edge of the predecessor bar, then horizontally
+ * to the left edge of the successor bar. Supports negative lag (overlap).
+ * @param from - Start point {x, y} (right edge of predecessor, vertical center)
+ * @param to - End point {x, y} (left edge of successor, vertical center)
+ * @returns SVG path string
  */
-interface WeekendBlock {
-    /** Left position in pixels */
-    left: number;
-    /** Width in pixels */
-    width: number;
-}
+declare const calculateOrthogonalPath: (from: {
+    x: number;
+    y: number;
+}, to: {
+    x: number;
+    y: number;
+}) => string;
 
-export { DragGuideLines, GanttChart, type GanttChartProps, type GanttDateRange, GridBackground, type GridConfig, type GridLine, type MonthSpan, type Task, type TaskBarGeometry, TaskRow, TimeScaleHeader, TodayIndicator, type WeekendBlock, calculateGridLines, calculateGridWidth, calculateTaskBar, calculateWeekendBlocks, detectEdgeZone, formatDateLabel, getCursorForPosition, getDayOffset, getMonthDays, getMonthSpans, getMultiMonthDays, isToday, isWeekend, parseUTCDate, pixelsToDate, useTaskDrag };
+export { DragGuideLines, GanttChart, type GanttChartProps, type GanttDateRange, GridBackground, type GridConfig, type GridLine, type MonthSpan, type Task, type TaskBarGeometry, type TaskDependency, TaskRow, TimeScaleHeader, TodayIndicator, type WeekendBlock, buildAdjacencyList, calculateBezierPath, calculateGridLines, calculateGridWidth, calculateOrthogonalPath, calculateSuccessorDate, calculateTaskBar, calculateWeekendBlocks, detectCycles, detectEdgeZone, formatDateLabel, getAllDependencyEdges, getCursorForPosition, getDayOffset, getMonthDays, getMonthSpans, getMultiMonthDays, getSuccessorChain, isToday, isWeekend, parseUTCDate, pixelsToDate, useTaskDrag, validateDependencies };