gantt-lib 0.88.2 → 0.89.0

package/dist/index.d.mts

@@ -543,13 +543,21 @@ interface ExportToPdfHeaderOptions {
     /** Export date shown on the right; string is rendered as-is */
     exportDate?: string | Date;
 }
+interface ScrollToRowOptions {
+    /** Keep built-in row selection styling after scroll (default: true) */
+    select?: boolean;
+    /** Browser scroll behavior for the vertical scroll action (default: 'smooth') */
+    behavior?: ScrollBehavior;
+    /** Automatically clear built-in row selection after N milliseconds */
+    clearSelectionAfterMs?: number;
+}
 /**
  * Ref handle type for GanttChart — exposes imperative scroll methods.
  */
 interface GanttChartHandle {
     scrollToToday: () => void;
     scrollToTask: (taskId: string) => void;
-    scrollToRow: (taskId: string) => void;
+    scrollToRow: (taskId: string, options?: ScrollToRowOptions) => void;
     collapseAll: () => void;
     expandAll: () => void;
     exportToPdf: (options?: ExportToPdfOptions) => Promise<void>;

package/dist/index.d.ts

@@ -543,13 +543,21 @@ interface ExportToPdfHeaderOptions {
     /** Export date shown on the right; string is rendered as-is */
     exportDate?: string | Date;
 }
+interface ScrollToRowOptions {
+    /** Keep built-in row selection styling after scroll (default: true) */
+    select?: boolean;
+    /** Browser scroll behavior for the vertical scroll action (default: 'smooth') */
+    behavior?: ScrollBehavior;
+    /** Automatically clear built-in row selection after N milliseconds */
+    clearSelectionAfterMs?: number;
+}
 /**
  * Ref handle type for GanttChart — exposes imperative scroll methods.
  */
 interface GanttChartHandle {
     scrollToToday: () => void;
     scrollToTask: (taskId: string) => void;
-    scrollToRow: (taskId: string) => void;
+    scrollToRow: (taskId: string, options?: ScrollToRowOptions) => void;
     collapseAll: () => void;
     expandAll: () => void;
     exportToPdf: (options?: ExportToPdfOptions) => Promise<void>;

package/dist/index.js

@@ -9622,6 +9622,7 @@ function TaskGanttChartInner(props, ref) {
   const containerRef = (0, import_react15.useRef)(null);
   const scrollContainerRef = (0, import_react15.useRef)(null);
   const scrollContentRef = (0, import_react15.useRef)(null);
+  const clearSelectedTaskTimeoutRef = (0, import_react15.useRef)(null);
   const [selectedTaskId, setSelectedTaskId] = (0, import_react15.useState)(null);
   const [taskListHasRightShadow, setTaskListHasRightShadow] = (0, import_react15.useState)(false);
   const [selectedChip, setSelectedChip] = (0, import_react15.useState)(null);
@@ -9741,7 +9742,7 @@ function TaskGanttChartInner(props, ref) {
     const scrollLeft = Math.round(taskOffset - dayWidth * 2);
     container.scrollTo({ left: Math.max(0, scrollLeft), behavior: "smooth" });
   }, [tasks, dateRange, dayWidth]);
-  const scrollToRow = (0, import_react15.useCallback)((taskId) => {
+  const scrollToRow = (0, import_react15.useCallback)((taskId, options = {}) => {
     const container = scrollContainerRef.current;
     if (!container) return;
     const task = tasks.find((t) => t.id === taskId);
@@ -9750,8 +9751,25 @@ function TaskGanttChartInner(props, ref) {
     if (rowIndex === -1) return;
     const paddedRowIndex = Math.max(0, rowIndex - SCROLL_TO_ROW_CONTEXT_ROWS);
     const scrollTop = Math.max(0, rowHeight * paddedRowIndex);
-    setSelectedTaskId(taskId);
-    container.scrollTo({ top: scrollTop, behavior: "smooth" });
+    const {
+      select = true,
+      behavior = "smooth",
+      clearSelectionAfterMs
+    } = options;
+    if (clearSelectedTaskTimeoutRef.current !== null) {
+      window.clearTimeout(clearSelectedTaskTimeoutRef.current);
+      clearSelectedTaskTimeoutRef.current = null;
+    }
+    if (select) {
+      setSelectedTaskId(taskId);
+      if (typeof clearSelectionAfterMs === "number" && clearSelectionAfterMs >= 0) {
+        clearSelectedTaskTimeoutRef.current = window.setTimeout(() => {
+          setSelectedTaskId((current) => current === taskId ? null : current);
+          clearSelectedTaskTimeoutRef.current = null;
+        }, clearSelectionAfterMs);
+      }
+    }
+    container.scrollTo({ top: scrollTop, behavior });
   }, [tasks, visibleTasks, rowHeight]);
   const [dragGuideLines, setDragGuideLines] = (0, import_react15.useState)(null);
   const [draggedTaskOverride, setDraggedTaskOverride] = (0, import_react15.useState)(null);
@@ -9761,6 +9779,11 @@ function TaskGanttChartInner(props, ref) {
     setValidationResult(result);
     onValidateDependencies?.(result);
   }, [tasks, onValidateDependencies]);
+  (0, import_react15.useEffect)(() => () => {
+    if (clearSelectedTaskTimeoutRef.current !== null) {
+      window.clearTimeout(clearSelectedTaskTimeoutRef.current);
+    }
+  }, []);
   const handleTaskChange = (0, import_react15.useCallback)((updatedTasks) => {
     const updatedTask = updatedTasks[0];
     if (!updatedTask) return;