gantt-task-react-v 1.1.18 → 1.1.20

package/dist/components/gantt/task-gantt-content.d.ts

@@ -30,6 +30,10 @@ export interface TaskGanttContentProps extends GanttTaskBarActions {
     selectTaskOnMouseDown: (taskId: string, event: MouseEvent) => void;
     selectedIdsMirror: Readonly<Record<string, true>>;
     onTooltipTask: (task: Task | null, element: Element | null) => void;
+    /**
+     * When true, disable interactive behaviors for task bars (drag, click, relations)
+     */
+    isLoading?: boolean;
     startColumnIndex: number;
     taskYOffset: number;
     visibleTasksMirror: Readonly<Record<string, true>>;

package/dist/components/task-list/index.d.ts

@@ -38,6 +38,10 @@ export type TaskListProps = {
     taskListContainerRef: RefObject<HTMLDivElement>;
     taskListRef: RefObject<HTMLDivElement>;
     tasks: readonly RenderTask[];
+    /**
+     * When true, disable user interactions on the task list (clicks, context menu)
+     */
+    isLoading?: boolean;
     onResizeColumn?: OnResizeColumn;
     tableBottom?: TableRenderBottomProps;
 };

package/dist/gantt-task-react.es.js

@@ -10637,20 +10637,22 @@ const TaskListTableDefaultInner = ({
   );
 };
 const TaskListTable = memo(TaskListTableDefaultInner);
-const taskListRoot = "_taskListRoot_yoz76_1";
-const taskListHorizontalScroll = "_taskListHorizontalScroll_yoz76_19";
-const taskListResizer = "_taskListResizer_yoz76_81";
-const horizontalContainer$1 = "_horizontalContainer_yoz76_145";
-const tableWrapper = "_tableWrapper_yoz76_159";
-const scrollToTop = "_scrollToTop_yoz76_173";
-const scrollToBottom = "_scrollToBottom_yoz76_189";
-const hidden = "_hidden_yoz76_205";
+const taskListRoot = "_taskListRoot_6kpxi_1";
+const taskListHorizontalScroll = "_taskListHorizontalScroll_6kpxi_19";
+const taskListResizer = "_taskListResizer_6kpxi_81";
+const horizontalContainer$1 = "_horizontalContainer_6kpxi_145";
+const tableWrapper = "_tableWrapper_6kpxi_159";
+const loadingOverlayBody$1 = "_loadingOverlayBody_6kpxi_173";
+const scrollToTop = "_scrollToTop_6kpxi_195";
+const scrollToBottom = "_scrollToBottom_6kpxi_211";
+const hidden = "_hidden_6kpxi_227";
 const styles$d = {
   taskListRoot,
   taskListHorizontalScroll,
   taskListResizer,
   horizontalContainer: horizontalContainer$1,
   tableWrapper,
+  loadingOverlayBody: loadingOverlayBody$1,
   scrollToTop,
   scrollToBottom,
   hidden
@@ -10700,6 +10702,7 @@ const TaskListInner = ({
   taskListHorizontalScrollRef,
   taskListRef,
   tasks,
+  isLoading = false,
   onResizeColumn,
   canReorderTasks,
   tableBottom
@@ -10755,7 +10758,8 @@ const TaskListInner = ({
         onClick,
         onExpanderClick,
         scrollToTask,
-        selectTaskOnMouseDown,
+        selectTaskOnMouseDown: isLoading ? () => {
+        } : selectTaskOnMouseDown,
         task,
         depth
       };
@@ -10780,6 +10784,7 @@ const TaskListInner = ({
       onExpanderClick,
       scrollToTask,
       selectTaskOnMouseDown,
+      isLoading,
       selectedIdsMirror
     ]
   );
@@ -10805,6 +10810,13 @@ const TaskListInner = ({
             }
           ),
           /* @__PURE__ */ jsxs("div", { className: styles$d.tableWrapper, children: [
+            (isLoading || false) && /* @__PURE__ */ jsx(
+              "div",
+              {
+                className: styles$d.loadingOverlayBody,
+                "data-testid": "tasklist-loading-overlay"
+              }
+            ),
             /* @__PURE__ */ jsx(
               "div",
               {
@@ -10850,7 +10862,8 @@ const TaskListInner = ({
                         handleMoveTaskBefore,
                         handleMoveTaskAfter,
                         handleMoveTasksInside,
-                        handleOpenContextMenu,
+                        handleOpenContextMenu: isLoading ? () => {
+                        } : handleOpenContextMenu,
                         icons,
                         isShowTaskNumbers,
                         mapTaskToNestedIndex,
@@ -12970,6 +12983,7 @@ const TaskGanttContentInner = (props) => {
     selectTaskOnMouseDown,
     selectedIdsMirror,
     onTooltipTask,
+    isLoading = false,
     startColumnIndex,
     taskYOffset,
     taskHeight,
@@ -13098,17 +13112,17 @@ const TaskGanttContentInner = (props) => {
                 distances,
                 taskHeight,
                 taskHalfHeight,
-                isProgressChangeable: (t) => isProgressChangeable(t) && !waitCommitTasks,
+                isProgressChangeable: (t) => isProgressChangeable(t) && !waitCommitTasks && !isLoading,
                 isDateChangeable: (t) => isDateChangeable(t) && !waitCommitTasks,
-                isRelationChangeable: (t) => isRelationChangeable(t) && !waitCommitTasks,
+                isRelationChangeable: (t) => isRelationChangeable(t) && !waitCommitTasks && !isLoading,
                 authorizedRelations,
                 ganttRelationEvent,
-                canDelete: !task.isDisabled && !waitCommitTasks,
-                onDoubleClick,
-                onClick,
-                onEventStart: onTaskBarDragStart,
+                canDelete: !task.isDisabled && !waitCommitTasks && !isLoading,
+                onDoubleClick: isLoading ? void 0 : onDoubleClick,
+                onClick: isLoading ? void 0 : onClick,
+                onEventStart: isLoading ? void 0 : onTaskBarDragStart,
                 onTooltipTask,
-                onRelationStart: onTaskBarRelationStart,
+                onRelationStart: isLoading ? void 0 : onTaskBarRelationStart,
                 isSelected: Boolean(selectedIdsMirror[taskId]),
                 isCritical,
                 rtl,
@@ -13328,7 +13342,8 @@ const TaskGanttContentInner = (props) => {
     visibleTasksMirror,
     onArrowDoubleClick,
     showProgress,
-    progressColor
+    progressColor,
+    isLoading
   ]);
   return /* @__PURE__ */ jsxs("g", { className: "content", children: [
     renderedSelectedTasks,
@@ -13363,15 +13378,19 @@ const TaskGanttContentInner = (props) => {
   ] });
 };
 const TaskGanttContent = memo(TaskGanttContentInner);
-const ganttVerticalContainer = "_ganttVerticalContainer_1wr55_1";
-const horizontalContainer = "_horizontalContainer_1wr55_73";
-const wrapper = "_wrapper_1wr55_85";
-const calendarDragging = "_calendarDragging_1wr55_109";
+const ganttVerticalContainer = "_ganttVerticalContainer_19ply_1";
+const horizontalContainer = "_horizontalContainer_19ply_73";
+const wrapper = "_wrapper_19ply_93";
+const calendarDragging = "_calendarDragging_19ply_117";
+const loadingOverlay = "_loadingOverlay_19ply_125";
+const loadingOverlayBody = "_loadingOverlayBody_19ply_141";
 const styles$2 = {
   ganttVerticalContainer,
   horizontalContainer,
   wrapper,
-  calendarDragging
+  calendarDragging,
+  loadingOverlay,
+  loadingOverlayBody
 };
 const TaskGanttInner = (props) => {
   const {
@@ -13426,7 +13445,7 @@ const TaskGanttInner = (props) => {
     ]
   );
   useEffect(() => {
-    if (!contentRef.current) {
+    if (!contentRef.current || barProps.isLoading) {
       return () => {
       };
     }
@@ -13496,7 +13515,12 @@ const TaskGanttInner = (props) => {
       contentContainer.removeEventListener("mouseup", onScrollEnd);
       contentContainer.removeEventListener("mouseout", onScrollEnd);
     };
-  }, [verticalScrollbarRef, horizontalContainerRef, verticalGanttContainerRef]);
+  }, [
+    verticalScrollbarRef,
+    horizontalContainerRef,
+    verticalGanttContainerRef,
+    barProps.isLoading
+  ]);
   return /* @__PURE__ */ jsxs(
     "div",
     {
@@ -13515,41 +13539,50 @@ const TaskGanttInner = (props) => {
             children: /* @__PURE__ */ jsx(Calendar, { scrollRef: verticalGanttContainerRef, ...calendarProps })
           }
         ),
-        /* @__PURE__ */ jsx(
+        /* @__PURE__ */ jsxs(
           "div",
           {
             ref: horizontalContainerRef,
             className: styles$2.horizontalContainer,
             style: containerStyle,
-            children: /* @__PURE__ */ jsx("div", { style: gridStyle, children: /* @__PURE__ */ jsxs(
-              "svg",
-              {
-                xmlns: "http://www.w3.org/2000/svg",
-                width: fullSvgWidth,
-                height: ganttFullHeight,
-                fontFamily: "var(--gantt-font-family)",
-                ref: ganttSVGRef,
-                onContextMenu: (event) => {
-                  event.preventDefault();
-                  if (onOpenGanttContextMenu) {
-                    onOpenGanttContextMenu(event.clientX, event.clientY);
-                  }
-                },
-                children: [
-                  /* @__PURE__ */ jsx(GanttToday, { ...ganttTodayProps }),
-                  /* @__PURE__ */ jsx(
-                    "rect",
-                    {
-                      ref: contentRef,
-                      width: "100%",
-                      height: "100%",
-                      fill: "transparent"
+            children: [
+              barProps.isLoading && /* @__PURE__ */ jsx(
+                "div",
+                {
+                  className: styles$2.loadingOverlayBody,
+                  "data-testid": "gantt-loading-overlay-body"
+                }
+              ),
+              /* @__PURE__ */ jsx("div", { style: gridStyle, children: /* @__PURE__ */ jsxs(
+                "svg",
+                {
+                  xmlns: "http://www.w3.org/2000/svg",
+                  width: fullSvgWidth,
+                  height: ganttFullHeight,
+                  fontFamily: "var(--gantt-font-family)",
+                  ref: ganttSVGRef,
+                  onContextMenu: (event) => {
+                    event.preventDefault();
+                    if (onOpenGanttContextMenu) {
+                      onOpenGanttContextMenu(event.clientX, event.clientY);
                     }
-                  ),
-                  /* @__PURE__ */ jsx(TaskGanttContent, { ...barProps })
-                ]
-              }
-            ) })
+                  },
+                  children: [
+                    /* @__PURE__ */ jsx(GanttToday, { ...ganttTodayProps }),
+                    /* @__PURE__ */ jsx(
+                      "rect",
+                      {
+                        ref: contentRef,
+                        width: "100%",
+                        height: "100%",
+                        fill: "transparent"
+                      }
+                    ),
+                    /* @__PURE__ */ jsx(TaskGanttContent, { ...barProps })
+                  ]
+                }
+              ) })
+            ]
           }
         )
       ]
@@ -18986,6 +19019,7 @@ const Gantt = (props) => {
     showProgress = true,
     progressColor
   } = props;
+  const { isLoading = false } = props;
   const ganttSVGRef = useRef(null);
   const wrapperRef = useRef(null);
   const taskListRef = useRef(null);
@@ -19300,6 +19334,9 @@ const Gantt = (props) => {
   });
   const handleOpenGanttContextMenu = useCallback(
     (task, clientX, clientY) => {
+      if (isLoading) {
+        return;
+      }
       const wrapperNode = wrapperRef.current;
       if (!wrapperNode) {
         return;
@@ -19312,7 +19349,7 @@ const Gantt = (props) => {
         y: clientY - top
       });
     },
-    [wrapperRef]
+    [wrapperRef, isLoading]
   );
   const handleCloseGanttContextMenu = useCallback(() => {
     setGanttContextMenu({
@@ -19446,6 +19483,10 @@ const Gantt = (props) => {
     horizontalContainerRef
   ]);
   const handleKeyDown = (event) => {
+    if (isLoading) {
+      event.preventDefault();
+      return;
+    }
     const { columnWidth, rowHeight: rowHeight2 } = distances;
     let newScrollY = scrollY;
     let newScrollX = scrollX;
@@ -20111,6 +20152,9 @@ const Gantt = (props) => {
   }, [taskList.contextMenuOptions, locale]);
   const handleOpenContextMenuForRow = useCallback(
     (task, clientX, clientY) => {
+      if (isLoading) {
+        return;
+      }
       try {
         if (onRowContextMenu && task) {
           onRowContextMenu(task);
@@ -20128,7 +20172,8 @@ const Gantt = (props) => {
       handleOpenContextMenu,
       selectTask,
       contextMenuOptions,
-      selectedIdsMirror
+      selectedIdsMirror,
+      isLoading
     ]
   );
   const ganttContextMenuOptions = useMemo(() => {
@@ -20262,6 +20307,7 @@ const Gantt = (props) => {
       onDeleteTask: (taskForDelete) => handleDeleteTasks([taskForDelete]),
       onTaskBarDragStart: handleTaskDragStart,
       onTooltipTask: onChangeTooltipTask,
+      isLoading,
       mapGlobalRowIndexToTask,
       onArrowDoubleClick,
       renderedRowIndexes,
@@ -20314,7 +20360,8 @@ const Gantt = (props) => {
       changeInProgress == null ? void 0 : changeInProgress.action,
       handleDeleteTasks,
       showProgress,
-      progressColor
+      progressColor,
+      isLoading
     ]
   );
   const renderTaskListProps = useMemo(
@@ -20347,7 +20394,8 @@ const Gantt = (props) => {
       taskListContainerRef,
       taskListRef,
       tasks: visibleTasks,
-      ganttRef: wrapperRef
+      ganttRef: wrapperRef,
+      isLoading
     }),
     [
       childTasksMap,
@@ -20375,6 +20423,7 @@ const Gantt = (props) => {
       selectTaskOnMouseDown,
       selectedIdsMirror,
       taskList,
+      isLoading,
       taskListContainerRef,
       visibleTasks
     ]

package/dist/gantt-task-react.umd.js

@@ -10654,20 +10654,22 @@
     );
   };
   const TaskListTable = React.memo(TaskListTableDefaultInner);
-  const taskListRoot = "_taskListRoot_yoz76_1";
-  const taskListHorizontalScroll = "_taskListHorizontalScroll_yoz76_19";
-  const taskListResizer = "_taskListResizer_yoz76_81";
-  const horizontalContainer$1 = "_horizontalContainer_yoz76_145";
-  const tableWrapper = "_tableWrapper_yoz76_159";
-  const scrollToTop = "_scrollToTop_yoz76_173";
-  const scrollToBottom = "_scrollToBottom_yoz76_189";
-  const hidden = "_hidden_yoz76_205";
+  const taskListRoot = "_taskListRoot_6kpxi_1";
+  const taskListHorizontalScroll = "_taskListHorizontalScroll_6kpxi_19";
+  const taskListResizer = "_taskListResizer_6kpxi_81";
+  const horizontalContainer$1 = "_horizontalContainer_6kpxi_145";
+  const tableWrapper = "_tableWrapper_6kpxi_159";
+  const loadingOverlayBody$1 = "_loadingOverlayBody_6kpxi_173";
+  const scrollToTop = "_scrollToTop_6kpxi_195";
+  const scrollToBottom = "_scrollToBottom_6kpxi_211";
+  const hidden = "_hidden_6kpxi_227";
   const styles$d = {
     taskListRoot,
     taskListHorizontalScroll,
     taskListResizer,
     horizontalContainer: horizontalContainer$1,
     tableWrapper,
+    loadingOverlayBody: loadingOverlayBody$1,
     scrollToTop,
     scrollToBottom,
     hidden
@@ -10717,6 +10719,7 @@
     taskListHorizontalScrollRef,
     taskListRef,
     tasks,
+    isLoading = false,
     onResizeColumn,
     canReorderTasks,
     tableBottom
@@ -10772,7 +10775,8 @@
           onClick,
           onExpanderClick,
           scrollToTask,
-          selectTaskOnMouseDown,
+          selectTaskOnMouseDown: isLoading ? () => {
+          } : selectTaskOnMouseDown,
           task,
           depth
         };
@@ -10797,6 +10801,7 @@
         onExpanderClick,
         scrollToTask,
         selectTaskOnMouseDown,
+        isLoading,
         selectedIdsMirror
       ]
     );
@@ -10822,6 +10827,13 @@
               }
             ),
             /* @__PURE__ */ jsxRuntime.jsxs("div", { className: styles$d.tableWrapper, children: [
+              (isLoading || false) && /* @__PURE__ */ jsxRuntime.jsx(
+                "div",
+                {
+                  className: styles$d.loadingOverlayBody,
+                  "data-testid": "tasklist-loading-overlay"
+                }
+              ),
               /* @__PURE__ */ jsxRuntime.jsx(
                 "div",
                 {
@@ -10867,7 +10879,8 @@
                           handleMoveTaskBefore,
                           handleMoveTaskAfter,
                           handleMoveTasksInside,
-                          handleOpenContextMenu,
+                          handleOpenContextMenu: isLoading ? () => {
+                          } : handleOpenContextMenu,
                           icons,
                           isShowTaskNumbers,
                           mapTaskToNestedIndex,
@@ -12987,6 +13000,7 @@
       selectTaskOnMouseDown,
       selectedIdsMirror,
       onTooltipTask,
+      isLoading = false,
       startColumnIndex,
       taskYOffset,
       taskHeight,
@@ -13115,17 +13129,17 @@
                   distances,
                   taskHeight,
                   taskHalfHeight,
-                  isProgressChangeable: (t) => isProgressChangeable(t) && !waitCommitTasks,
+                  isProgressChangeable: (t) => isProgressChangeable(t) && !waitCommitTasks && !isLoading,
                   isDateChangeable: (t) => isDateChangeable(t) && !waitCommitTasks,
-                  isRelationChangeable: (t) => isRelationChangeable(t) && !waitCommitTasks,
+                  isRelationChangeable: (t) => isRelationChangeable(t) && !waitCommitTasks && !isLoading,
                   authorizedRelations,
                   ganttRelationEvent,
-                  canDelete: !task.isDisabled && !waitCommitTasks,
-                  onDoubleClick,
-                  onClick,
-                  onEventStart: onTaskBarDragStart,
+                  canDelete: !task.isDisabled && !waitCommitTasks && !isLoading,
+                  onDoubleClick: isLoading ? void 0 : onDoubleClick,
+                  onClick: isLoading ? void 0 : onClick,
+                  onEventStart: isLoading ? void 0 : onTaskBarDragStart,
                   onTooltipTask,
-                  onRelationStart: onTaskBarRelationStart,
+                  onRelationStart: isLoading ? void 0 : onTaskBarRelationStart,
                   isSelected: Boolean(selectedIdsMirror[taskId]),
                   isCritical,
                   rtl,
@@ -13345,7 +13359,8 @@
       visibleTasksMirror,
       onArrowDoubleClick,
       showProgress,
-      progressColor
+      progressColor,
+      isLoading
     ]);
     return /* @__PURE__ */ jsxRuntime.jsxs("g", { className: "content", children: [
       renderedSelectedTasks,
@@ -13380,15 +13395,19 @@
     ] });
   };
   const TaskGanttContent = React.memo(TaskGanttContentInner);
-  const ganttVerticalContainer = "_ganttVerticalContainer_1wr55_1";
-  const horizontalContainer = "_horizontalContainer_1wr55_73";
-  const wrapper = "_wrapper_1wr55_85";
-  const calendarDragging = "_calendarDragging_1wr55_109";
+  const ganttVerticalContainer = "_ganttVerticalContainer_19ply_1";
+  const horizontalContainer = "_horizontalContainer_19ply_73";
+  const wrapper = "_wrapper_19ply_93";
+  const calendarDragging = "_calendarDragging_19ply_117";
+  const loadingOverlay = "_loadingOverlay_19ply_125";
+  const loadingOverlayBody = "_loadingOverlayBody_19ply_141";
   const styles$2 = {
     ganttVerticalContainer,
     horizontalContainer,
     wrapper,
-    calendarDragging
+    calendarDragging,
+    loadingOverlay,
+    loadingOverlayBody
   };
   const TaskGanttInner = (props) => {
     const {
@@ -13443,7 +13462,7 @@
       ]
     );
     React.useEffect(() => {
-      if (!contentRef.current) {
+      if (!contentRef.current || barProps.isLoading) {
         return () => {
         };
       }
@@ -13513,7 +13532,12 @@
         contentContainer.removeEventListener("mouseup", onScrollEnd);
         contentContainer.removeEventListener("mouseout", onScrollEnd);
       };
-    }, [verticalScrollbarRef, horizontalContainerRef, verticalGanttContainerRef]);
+    }, [
+      verticalScrollbarRef,
+      horizontalContainerRef,
+      verticalGanttContainerRef,
+      barProps.isLoading
+    ]);
     return /* @__PURE__ */ jsxRuntime.jsxs(
       "div",
       {
@@ -13532,41 +13556,50 @@
               children: /* @__PURE__ */ jsxRuntime.jsx(Calendar, { scrollRef: verticalGanttContainerRef, ...calendarProps })
             }
           ),
-          /* @__PURE__ */ jsxRuntime.jsx(
+          /* @__PURE__ */ jsxRuntime.jsxs(
             "div",
             {
               ref: horizontalContainerRef,
               className: styles$2.horizontalContainer,
               style: containerStyle,
-              children: /* @__PURE__ */ jsxRuntime.jsx("div", { style: gridStyle, children: /* @__PURE__ */ jsxRuntime.jsxs(
-                "svg",
-                {
-                  xmlns: "http://www.w3.org/2000/svg",
-                  width: fullSvgWidth,
-                  height: ganttFullHeight,
-                  fontFamily: "var(--gantt-font-family)",
-                  ref: ganttSVGRef,
-                  onContextMenu: (event) => {
-                    event.preventDefault();
-                    if (onOpenGanttContextMenu) {
-                      onOpenGanttContextMenu(event.clientX, event.clientY);
-                    }
-                  },
-                  children: [
-                    /* @__PURE__ */ jsxRuntime.jsx(GanttToday, { ...ganttTodayProps }),
-                    /* @__PURE__ */ jsxRuntime.jsx(
-                      "rect",
-                      {
-                        ref: contentRef,
-                        width: "100%",
-                        height: "100%",
-                        fill: "transparent"
+              children: [
+                barProps.isLoading && /* @__PURE__ */ jsxRuntime.jsx(
+                  "div",
+                  {
+                    className: styles$2.loadingOverlayBody,
+                    "data-testid": "gantt-loading-overlay-body"
+                  }
+                ),
+                /* @__PURE__ */ jsxRuntime.jsx("div", { style: gridStyle, children: /* @__PURE__ */ jsxRuntime.jsxs(
+                  "svg",
+                  {
+                    xmlns: "http://www.w3.org/2000/svg",
+                    width: fullSvgWidth,
+                    height: ganttFullHeight,
+                    fontFamily: "var(--gantt-font-family)",
+                    ref: ganttSVGRef,
+                    onContextMenu: (event) => {
+                      event.preventDefault();
+                      if (onOpenGanttContextMenu) {
+                        onOpenGanttContextMenu(event.clientX, event.clientY);
                       }
-                    ),
-                    /* @__PURE__ */ jsxRuntime.jsx(TaskGanttContent, { ...barProps })
-                  ]
-                }
-              ) })
+                    },
+                    children: [
+                      /* @__PURE__ */ jsxRuntime.jsx(GanttToday, { ...ganttTodayProps }),
+                      /* @__PURE__ */ jsxRuntime.jsx(
+                        "rect",
+                        {
+                          ref: contentRef,
+                          width: "100%",
+                          height: "100%",
+                          fill: "transparent"
+                        }
+                      ),
+                      /* @__PURE__ */ jsxRuntime.jsx(TaskGanttContent, { ...barProps })
+                    ]
+                  }
+                ) })
+              ]
             }
           )
         ]
@@ -19003,6 +19036,7 @@
       showProgress = true,
       progressColor
     } = props;
+    const { isLoading = false } = props;
     const ganttSVGRef = React.useRef(null);
     const wrapperRef = React.useRef(null);
     const taskListRef = React.useRef(null);
@@ -19317,6 +19351,9 @@
     });
     const handleOpenGanttContextMenu = React.useCallback(
       (task, clientX, clientY) => {
+        if (isLoading) {
+          return;
+        }
         const wrapperNode = wrapperRef.current;
         if (!wrapperNode) {
           return;
@@ -19329,7 +19366,7 @@
           y: clientY - top
         });
       },
-      [wrapperRef]
+      [wrapperRef, isLoading]
     );
     const handleCloseGanttContextMenu = React.useCallback(() => {
       setGanttContextMenu({
@@ -19463,6 +19500,10 @@
       horizontalContainerRef
     ]);
     const handleKeyDown = (event) => {
+      if (isLoading) {
+        event.preventDefault();
+        return;
+      }
       const { columnWidth, rowHeight: rowHeight2 } = distances;
       let newScrollY = scrollY;
       let newScrollX = scrollX;
@@ -20128,6 +20169,9 @@
     }, [taskList.contextMenuOptions, locale]);
     const handleOpenContextMenuForRow = React.useCallback(
       (task, clientX, clientY) => {
+        if (isLoading) {
+          return;
+        }
         try {
           if (onRowContextMenu && task) {
             onRowContextMenu(task);
@@ -20145,7 +20189,8 @@
         handleOpenContextMenu,
         selectTask,
         contextMenuOptions,
-        selectedIdsMirror
+        selectedIdsMirror,
+        isLoading
       ]
     );
     const ganttContextMenuOptions = React.useMemo(() => {
@@ -20279,6 +20324,7 @@
         onDeleteTask: (taskForDelete) => handleDeleteTasks([taskForDelete]),
         onTaskBarDragStart: handleTaskDragStart,
         onTooltipTask: onChangeTooltipTask,
+        isLoading,
         mapGlobalRowIndexToTask,
         onArrowDoubleClick,
         renderedRowIndexes,
@@ -20331,7 +20377,8 @@
         changeInProgress == null ? void 0 : changeInProgress.action,
         handleDeleteTasks,
         showProgress,
-        progressColor
+        progressColor,
+        isLoading
       ]
     );
     const renderTaskListProps = React.useMemo(
@@ -20364,7 +20411,8 @@
         taskListContainerRef,
         taskListRef,
         tasks: visibleTasks,
-        ganttRef: wrapperRef
+        ganttRef: wrapperRef,
+        isLoading
       }),
       [
         childTasksMap,
@@ -20392,6 +20440,7 @@
         selectTaskOnMouseDown,
         selectedIdsMirror,
         taskList,
+        isLoading,
         taskListContainerRef,
         visibleTasks
       ]

package/dist/style.css

@@ -282,7 +282,7 @@
   border-bottom: 1px solid var(--gantt-divider-color);
   table-layout: fixed;
 }
-._taskListRoot_yoz76_1 {
+._taskListRoot_6kpxi_1 {
   position: relative;
   height: 100%;
   display: flex;
@@ -291,23 +291,23 @@
   border-left: 1px solid var(--gantt-table-divider-color, var(--gantt-divider-color));
 }
 
-._taskListHorizontalScroll_yoz76_19 {
+._taskListHorizontalScroll_6kpxi_19 {
   overflow-x: scroll;
   height: 100%;
   display: flex;
   flex-direction: column;
 }
 
-._taskListHorizontalScroll_yoz76_19::-webkit-scrollbar {
+._taskListHorizontalScroll_6kpxi_19::-webkit-scrollbar {
   width: 1rem;
   height: 1rem;
 }
 
-._taskListHorizontalScroll_yoz76_19::-webkit-scrollbar-corner {
+._taskListHorizontalScroll_6kpxi_19::-webkit-scrollbar-corner {
   background: transparent;
 }
 
-._taskListHorizontalScroll_yoz76_19::-webkit-scrollbar-thumb {
+._taskListHorizontalScroll_6kpxi_19::-webkit-scrollbar-thumb {
   border: 4px solid transparent;
   /*noinspection CssUnresolvedCustomProperty*/
   background: var(--gantt-scrollbar-thumb-color);
@@ -315,14 +315,14 @@
   background-clip: padding-box;
 }
 
-._taskListHorizontalScroll_yoz76_19::-webkit-scrollbar-thumb:hover {
+._taskListHorizontalScroll_6kpxi_19::-webkit-scrollbar-thumb:hover {
   border: 2px solid transparent;
   /*noinspection CssUnresolvedCustomProperty*/
   background: var(--gantt-scrollbar-thumb-color);
   background-clip: padding-box;
 }
 
-._taskListResizer_yoz76_81 {
+._taskListResizer_6kpxi_81 {
   position: absolute;
   top: 0;
   right: -3px;
@@ -334,16 +334,16 @@
 }
 
 /*noinspection CssUnresolvedCustomProperty*/
-._taskListResizer_yoz76_81:hover {
+._taskListResizer_6kpxi_81:hover {
   background-color: var(--gantt-table-hover-action-color);
   filter: var(--gantt-hover-filter);
 }
 
-._taskListResizer_yoz76_81:hover::before {
+._taskListResizer_6kpxi_81:hover::before {
   display: none;
 }
 
-._taskListResizer_yoz76_81::before {
+._taskListResizer_6kpxi_81::before {
   content: "";
   position: absolute;
   top: 0;
@@ -354,21 +354,32 @@
   background-color: var(--gantt-table-resize-color, var(--gantt-divider-color));
 }
 
-._horizontalContainer_yoz76_145 {
+._horizontalContainer_6kpxi_145 {
   margin: 0;
   padding: 0;
   overflow: hidden;
   flex-grow: 1;
 }
 
-._tableWrapper_yoz76_159 {
+._tableWrapper_6kpxi_159 {
   position: relative;
   flex-grow: 1;
   display: flex;
   flex-direction: column;
 }
 
-._scrollToTop_yoz76_173 {
+._loadingOverlayBody_6kpxi_173 {
+  position: absolute;
+  left: 0;
+  right: 0;
+  top: 0; /* We'll position overlay inside body wrapper so header remains visible */
+  bottom: 0;
+  background: rgba(255,255,255,0.6);
+  z-index: 2;
+  pointer-events: auto;
+}
+
+._scrollToTop_6kpxi_195 {
   position: absolute;
   top: 0;
   left: 0;
@@ -376,7 +387,7 @@
   height: 20px;
 }
 
-._scrollToBottom_yoz76_189 {
+._scrollToBottom_6kpxi_211 {
   position: absolute;
   bottom: 0;
   left: 0;
@@ -384,7 +395,7 @@
   height: 20px;
 }
 
-._hidden_yoz76_205 {
+._hidden_6kpxi_227 {
   display: none;
 }
 ._ganttToday_1oyhk_1 {
@@ -578,7 +589,7 @@
   user-select: none;
   stroke-width: 0;
 }
-._ganttVerticalContainer_1wr55_1 {
+._ganttVerticalContainer_19ply_1 {
   overflow-x: scroll;
   overflow-y: hidden;
   font-size: 0;
@@ -590,16 +601,16 @@
   height: 100%;
 }
 
-._ganttVerticalContainer_1wr55_1::-webkit-scrollbar {
+._ganttVerticalContainer_19ply_1::-webkit-scrollbar {
   width: 1rem;
   height: 1rem;
 }
 
-._ganttVerticalContainer_1wr55_1::-webkit-scrollbar-corner {
+._ganttVerticalContainer_19ply_1::-webkit-scrollbar-corner {
   background: transparent;
 }
 
-._ganttVerticalContainer_1wr55_1::-webkit-scrollbar-thumb {
+._ganttVerticalContainer_19ply_1::-webkit-scrollbar-thumb {
   border: 4px solid transparent;
   /*noinspection CssUnresolvedCustomProperty*/
   background: var(--gantt-scrollbar-thumb-color);
@@ -607,20 +618,24 @@
   background-clip: padding-box;
 }
 
-._ganttVerticalContainer_1wr55_1::-webkit-scrollbar-thumb:hover {
+._ganttVerticalContainer_19ply_1::-webkit-scrollbar-thumb:hover {
   border: 2px solid transparent;
   /*noinspection CssUnresolvedCustomProperty*/
   background: var(--gantt-scrollbar-thumb-color);
   background-clip: padding-box;
 }
 
-._horizontalContainer_1wr55_73 {
+._horizontalContainer_19ply_73 {
   margin: 0;
   padding: 0;
   overflow: hidden;
 }
 
-._wrapper_1wr55_85 {
+._horizontalContainer_19ply_73 {
+  position: relative;
+}
+
+._wrapper_19ply_93 {
   display: flex;
   padding: 0;
   margin: 0;
@@ -632,9 +647,28 @@
   border-bottom: 1px solid var(--gantt-divider-color);
 }
 
-._calendarDragging_1wr55_109 {
+._calendarDragging_19ply_117 {
   cursor: grabbing;
 }
+
+._loadingOverlay_19ply_125 {
+  position: absolute;
+  inset: 0;
+  background: rgba(255, 255, 255, 0.6);
+  z-index: 9999;
+  pointer-events: auto;
+}
+
+._loadingOverlayBody_19ply_141 {
+  position: absolute;
+  left: 0;
+  right: 0;
+  top: 0;
+  bottom: 0;
+  background: rgba(255, 255, 255, 0.6);
+  z-index: 3;
+  pointer-events: auto;
+}
 /*noinspection CssUnresolvedCustomProperty*/
 ._menuOption_1c3e3_3 {
   display: flex;

package/dist/types/public-types.d.ts

@@ -368,6 +368,12 @@ export interface GanttProps {
      * Custom color for progress bars. If not provided, theme progress colors are used.
      */
     progressColor?: string;
+    /**
+     * When true, disables user interactions with the gantt and task list and
+     * shows a loading/disabled state. Useful while external updates are in
+     * progress to prevent rapid user actions.
+     */
+    isLoading?: boolean;
 }
 export interface GanttTaskBarActions {
     allowMoveTaskBar?: (action: TaskBarMoveAction, task: RenderTask) => boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gantt-task-react-v",
-  "version": "1.1.18",
+  "version": "1.1.20",
   "description": "Interactive Gantt Chart for React with TypeScript.",
   "author": "aguilanbon",
   "homepage": "https://github.com/aguilanbon/gantt-task-react-v",