gantt-lib 0.136.1 → 0.138.0

package/README.md

@@ -115,6 +115,83 @@ const tasks: Task[] = [
 When using controlled `collapsedParentIds`, provide `onToggleCollapse` to update
 the collapsed parent IDs in application state.
 
+## Row Activities (Flow Line)
+
+Give a row `activities` to turn it into a multi-bar lane — several works inside
+one row, packed into sub-lanes (e.g. finishing works on one floor). Sequential
+works share a lane; concurrent ones stack below and the row grows to fit the
+busiest day. Activities are plain bars: drag to move, drag an edge to resize,
+both snap to days. The hover tooltip is a narrow one-liner pinned above the bar:
+the row (floor) name, a middle dot, then the work name — e.g. `Floor 12 ·
+Wallpaper`; there is no native `title`. No hierarchy, dependencies, or
+per-activity progress — works in the default gantt mode only.
+
+Set `activityChain: true` to enable the ОН-conveyor (finish-to-start chain):
+inside the row every work follows the previous one, and identical works (same
+`id` or `name`) of consecutive chained rows are linked as well, so dragging one
+work pulls the whole conveyor below — live, while the pointer moves, like every
+other bar in the chart — the classic line-of-balance flow.
+
+Consecutive works of a lane are linked: a plain gap is drawn as a horizontal
+arrow with the lag («+N») at its head, while overlapping works (or works in
+different lanes) get the standard orthogonal Gantt connector, routed down when
+the successor drops to a lower lane. Turn links and lag labels off with
+`showActivityLinks` and `showActivityLag`.
+
+Click-activation is opt-in via `activityClickToDrag`: the first click arms a
+work (a plain drag pans the canvas) and only the armed work is dragged.
+`activityActivationMode` picks the activation visual — `'none'` (default),
+`'dim'` (other work types fade) or `'highlight'` (the chain of the same work,
+matched by `id` or `name` across rows, is outlined). Appearance is tuned with
+`--gantt-activity-dim-opacity`, `--gantt-activity-active-outline`,
+`--gantt-activity-chain-outline`, `--gantt-activity-tip-bg` and
+`--gantt-activity-tip-color`.
+
+The tooltip header (`row · work`) is fixed; extend it with declarative
+`tooltipFields` on the activity (label–value rows, any React node as the value)
+and/or the `activityTooltip(context)` render prop, whose context carries
+`{ task, activity, startDate, endDate, durationDays }` — use it to show dates,
+duration, crew, anything.
+
+Two conveyor modes are available via `activityChain`. `true` — rigid: dragging a
+work translates the whole downstream chain by the same delta. `'push'` —
+выталкивание (ASAP): when a work moves earlier the downstream gaps fill in
+immediately; when it moves later, successors stay put (the gap stretches) until
+the predecessor's end crosses their start — then they get pushed. An activity's
+`lag` (days) sets a constant gap before its start (e.g. technological curing):
+both fill and push keep «predecessor end + lag» exactly. The lag belongs to the
+same-floor sequence only — the vertical «same work on the floor above» link
+carries no lag. Starts are clamped so
+a dragged work cannot violate its own incoming links. Gaps wider than zero are
+drawn as horizontal arrows between consecutive works of one lane.
+
+In `'push'` mode the clamp is live and visible: the bar physically stops at the
+binding predecessor instead of snapping back on drop, the blocking work gets a
+red outline, and the dragged bar shows a stop edge with a «Блок: … · зазор N д»
+line in the tooltip. The binding gap is labelled «+N» at the arrow head in the
+dependency-line colour, matching the dependency lag labels.
+
+```tsx
+const tasks: Task[] = [
+  {
+    id: "floor-12",
+    name: "Floor 12",
+    startDate: "2026-03-24",
+    endDate: "2026-04-02",
+    activityChain: true,
+    activities: [
+      { id: "screed", name: "Screed", startDate: "2026-03-24", endDate: "2026-03-26", color: "#8b5cf6" },
+      { id: "wallpaper", name: "Wallpaper", startDate: "2026-03-27", endDate: "2026-03-30", color: "#f59e0b" },
+      {
+        id: "doors", name: "Doors", startDate: "2026-03-31", endDate: "2026-04-01", color: "#10b981",
+        lag: 1, // constant gap (days) before this work starts — same-row chain only
+        tooltipFields: [{ label: "Contractor", value: "SK Stroy" }],
+      },
+    ],
+  },
+];
+```
+
 ## Resource Planner Mode
 
 Use `mode="resource-planner"` when the primary rows are people, equipment, rooms, or other resources instead of tasks. Omitted `mode` still renders the default task Gantt chart.
@@ -218,6 +295,9 @@ interface Task {
   locked?: boolean;
   divider?: 'top' | 'bottom';
   parentId?: string;
+  activities?: TaskActivity[]; // multi-bar lane mode for the row
+  activityChain?: boolean | 'push'; // ОН-conveyor: chained dragging; 'push' = ASAP с выталкиванием
+  // Gantt props: activityClickToDrag, activityActivationMode, showActivityLinks, showActivityLag, activityTooltip
 }
 ```
 

package/dist/core/scheduling/index.d.mts

@@ -1,2 +1,2 @@
-export { ai as CascadeContext, C as CriticalPathOptions, D as DAY_MS, f as DependencyError, L as LinkType, n as ScaleTaskSubtreeAnchor, o as ScaleTaskSubtreeErrorCode, p as ScaleTaskSubtreeExternalPolicy, q as ScaleTaskSubtreeOptions, S as ScaleTaskSubtreeResult, r as ScaleTaskSubtreeWarning, aj as ScheduleCommandOptions, ak as ScheduleCommandResult, al as ScheduleDependency, am as ScheduleTask, an as ScheduleTaskUpdate, T as Task, ao as TaskDependency, V as ValidationResult, ap as addBusinessDays, t as alignToWorkingDay, u as areTasksHierarchicallyRelated, v as buildAdjacencyList, w as buildTaskRangeFromEnd, x as buildTaskRangeFromStart, y as calculateSuccessorDate, z as cascadeByLinks, aq as cascadeTaskProgress, A as clampTaskRangeForIncomingFS, E as computeCriticalPath, F as computeLagFromDates, H as computeParentDates, I as computeParentProgress, ar as createCascadeContext, J as detectCycles, K as extendCriticalIdsToParents, N as findParentId, O as getAllDependencyEdges, P as getAllDescendants, Q as getBusinessDayOffset, as as getBusinessDaysCount, U as getChildren, X as getDependencyLag, Y as getSuccessorChain, Z as getTaskDuration, _ as getTransitiveCascadeChain, $ as isAncestorTask, a0 as isTaskParent, a1 as moveTaskRange, a2 as moveTaskWithCascade, a3 as normalizeDependencyLag, a4 as normalizePredecessorDates, a5 as normalizeTaskDependencyLags, a6 as normalizeUTCDate, a7 as parseDateOnly, a8 as recalculateIncomingLags, a9 as recalculateProjectSchedule, aa as recalculateTaskFromDependencies, ab as reflowTasksOnModeSwitch, ac as removeDependenciesBetweenTasks, ad as resizeTaskWithCascade, ae as scaleTaskSubtreeDuration, af as shiftBusinessDayOffset, at as subtractBusinessDays, ag as universalCascade, ah as validateDependencies } from '../../index-D99kbU4p.mjs';
+export { al as CascadeContext, C as CriticalPathOptions, D as DAY_MS, g as DependencyError, L as LinkType, o as ScaleTaskSubtreeAnchor, p as ScaleTaskSubtreeErrorCode, q as ScaleTaskSubtreeExternalPolicy, r as ScaleTaskSubtreeOptions, S as ScaleTaskSubtreeResult, s as ScaleTaskSubtreeWarning, am as ScheduleCommandOptions, an as ScheduleCommandResult, ao as ScheduleDependency, ap as ScheduleTask, aq as ScheduleTaskUpdate, T as Task, ar as TaskDependency, V as ValidationResult, as as addBusinessDays, v as alignToWorkingDay, w as areTasksHierarchicallyRelated, x as buildAdjacencyList, y as buildTaskRangeFromEnd, z as buildTaskRangeFromStart, E as calculateSuccessorDate, F as cascadeByLinks, at as cascadeTaskProgress, H as clampTaskRangeForIncomingFS, I as computeCriticalPath, J as computeLagFromDates, K as computeParentDates, N as computeParentProgress, au as createCascadeContext, O as detectCycles, P as extendCriticalIdsToParents, Q as findParentId, U as getAllDependencyEdges, X as getAllDescendants, Y as getBusinessDayOffset, av as getBusinessDaysCount, Z as getChildren, _ as getDependencyLag, $ as getSuccessorChain, a0 as getTaskDuration, a1 as getTransitiveCascadeChain, a2 as isAncestorTask, a3 as isTaskParent, a4 as moveTaskRange, a5 as moveTaskWithCascade, a6 as normalizeDependencyLag, a7 as normalizePredecessorDates, a8 as normalizeTaskDependencyLags, a9 as normalizeUTCDate, aa as parseDateOnly, ab as recalculateIncomingLags, ac as recalculateProjectSchedule, ad as recalculateTaskFromDependencies, ae as reflowTasksOnModeSwitch, af as removeDependenciesBetweenTasks, ag as resizeTaskWithCascade, ah as scaleTaskSubtreeDuration, ai as shiftBusinessDayOffset, aw as subtractBusinessDays, aj as universalCascade, ak as validateDependencies } from '../../index-C3mZqSTf.mjs';
 import 'react';

package/dist/core/scheduling/index.d.ts

@@ -1,2 +1,2 @@
-export { ai as CascadeContext, C as CriticalPathOptions, D as DAY_MS, f as DependencyError, L as LinkType, n as ScaleTaskSubtreeAnchor, o as ScaleTaskSubtreeErrorCode, p as ScaleTaskSubtreeExternalPolicy, q as ScaleTaskSubtreeOptions, S as ScaleTaskSubtreeResult, r as ScaleTaskSubtreeWarning, aj as ScheduleCommandOptions, ak as ScheduleCommandResult, al as ScheduleDependency, am as ScheduleTask, an as ScheduleTaskUpdate, T as Task, ao as TaskDependency, V as ValidationResult, ap as addBusinessDays, t as alignToWorkingDay, u as areTasksHierarchicallyRelated, v as buildAdjacencyList, w as buildTaskRangeFromEnd, x as buildTaskRangeFromStart, y as calculateSuccessorDate, z as cascadeByLinks, aq as cascadeTaskProgress, A as clampTaskRangeForIncomingFS, E as computeCriticalPath, F as computeLagFromDates, H as computeParentDates, I as computeParentProgress, ar as createCascadeContext, J as detectCycles, K as extendCriticalIdsToParents, N as findParentId, O as getAllDependencyEdges, P as getAllDescendants, Q as getBusinessDayOffset, as as getBusinessDaysCount, U as getChildren, X as getDependencyLag, Y as getSuccessorChain, Z as getTaskDuration, _ as getTransitiveCascadeChain, $ as isAncestorTask, a0 as isTaskParent, a1 as moveTaskRange, a2 as moveTaskWithCascade, a3 as normalizeDependencyLag, a4 as normalizePredecessorDates, a5 as normalizeTaskDependencyLags, a6 as normalizeUTCDate, a7 as parseDateOnly, a8 as recalculateIncomingLags, a9 as recalculateProjectSchedule, aa as recalculateTaskFromDependencies, ab as reflowTasksOnModeSwitch, ac as removeDependenciesBetweenTasks, ad as resizeTaskWithCascade, ae as scaleTaskSubtreeDuration, af as shiftBusinessDayOffset, at as subtractBusinessDays, ag as universalCascade, ah as validateDependencies } from '../../index-D99kbU4p.js';
+export { al as CascadeContext, C as CriticalPathOptions, D as DAY_MS, g as DependencyError, L as LinkType, o as ScaleTaskSubtreeAnchor, p as ScaleTaskSubtreeErrorCode, q as ScaleTaskSubtreeExternalPolicy, r as ScaleTaskSubtreeOptions, S as ScaleTaskSubtreeResult, s as ScaleTaskSubtreeWarning, am as ScheduleCommandOptions, an as ScheduleCommandResult, ao as ScheduleDependency, ap as ScheduleTask, aq as ScheduleTaskUpdate, T as Task, ar as TaskDependency, V as ValidationResult, as as addBusinessDays, v as alignToWorkingDay, w as areTasksHierarchicallyRelated, x as buildAdjacencyList, y as buildTaskRangeFromEnd, z as buildTaskRangeFromStart, E as calculateSuccessorDate, F as cascadeByLinks, at as cascadeTaskProgress, H as clampTaskRangeForIncomingFS, I as computeCriticalPath, J as computeLagFromDates, K as computeParentDates, N as computeParentProgress, au as createCascadeContext, O as detectCycles, P as extendCriticalIdsToParents, Q as findParentId, U as getAllDependencyEdges, X as getAllDescendants, Y as getBusinessDayOffset, av as getBusinessDaysCount, Z as getChildren, _ as getDependencyLag, $ as getSuccessorChain, a0 as getTaskDuration, a1 as getTransitiveCascadeChain, a2 as isAncestorTask, a3 as isTaskParent, a4 as moveTaskRange, a5 as moveTaskWithCascade, a6 as normalizeDependencyLag, a7 as normalizePredecessorDates, a8 as normalizeTaskDependencyLags, a9 as normalizeUTCDate, aa as parseDateOnly, ab as recalculateIncomingLags, ac as recalculateProjectSchedule, ad as recalculateTaskFromDependencies, ae as reflowTasksOnModeSwitch, af as removeDependenciesBetweenTasks, ag as resizeTaskWithCascade, ah as scaleTaskSubtreeDuration, ai as shiftBusinessDayOffset, aw as subtractBusinessDays, aj as universalCascade, ak as validateDependencies } from '../../index-C3mZqSTf.js';
 import 'react';

package/dist/core/scheduling/index.js

@@ -550,6 +550,29 @@ function parseCascadeDateInput(date) {
   }
   return normalizeUTCDate(/* @__PURE__ */ new Date(`${date.split("T")[0]}T00:00:00.000Z`));
 }
+function projectDayDelta(from, to, businessDays, weekendPredicate) {
+  if (businessDays && weekendPredicate) {
+    return getBusinessDayOffset(from, to, weekendPredicate);
+  }
+  return Math.round((to.getTime() - from.getTime()) / DAY_MS);
+}
+function shiftTaskActivities(activities, dayDelta, businessDays, weekendPredicate) {
+  if (!activities || activities.length === 0 || dayDelta === 0) return void 0;
+  const shiftDate = (value) => {
+    const base = parseDateOnly(value);
+    const shifted = businessDays && weekendPredicate ? shiftBusinessDayOffset(base, dayDelta, weekendPredicate) : new Date(base.getTime() + dayDelta * DAY_MS);
+    return typeof value === "string" ? shifted.toISOString().slice(0, 10) : shifted;
+  };
+  return activities.map((activity) => ({
+    ...activity,
+    startDate: shiftDate(activity.startDate),
+    endDate: shiftDate(activity.endDate)
+  }));
+}
+function shiftedActivitiesPatch(activities, dayDelta, businessDays, weekendPredicate) {
+  const shifted = shiftTaskActivities(activities, dayDelta, businessDays, weekendPredicate);
+  return shifted ? { activities: shifted } : {};
+}
 function createCascadeContext(allTasks) {
   const childrenByParentId = /* @__PURE__ */ new Map();
   const dependentsByPredecessorId = /* @__PURE__ */ new Map();
@@ -625,7 +648,8 @@ function cascadeByLinks(movedTaskId, newStart, newEnd, allTasks, skipChildCascad
         result.push(normalizeTaskDependencyLags({
           ...child,
           startDate: newChildStart.toISOString().split("T")[0],
-          endDate: newChildEnd.toISOString().split("T")[0]
+          endDate: newChildEnd.toISOString().split("T")[0],
+          ...shiftedActivitiesPatch(child.activities, Math.round(parentStartDelta / DAY_MS), false)
         }));
         queue.push(child.id);
       }
@@ -769,7 +793,14 @@ function universalCascade(movedTask, newStart, newEnd, allTasks, businessDays =
         resultMap.set(child.id, normalizeTaskDependencyLags({
           ...child,
           startDate: childNewStart.toISOString().split("T")[0],
-          endDate: childNewEnd.toISOString().split("T")[0]
+          endDate: childNewEnd.toISOString().split("T")[0],
+          // Дети едут параллельно: вместе с датами строки сдвигаются и её работы.
+          ...shiftedActivitiesPatch(
+            child.activities,
+            projectDayDelta(childOrigStart, childNewStart, businessDays, weekendPredicate),
+            businessDays,
+            weekendPredicate
+          )
         }));
       }
     }
@@ -848,7 +879,13 @@ function universalCascade(movedTask, newStart, newEnd, allTasks, businessDays =
       resultMap.set(task.id, normalizeTaskDependencyLags({
         ...task,
         startDate: succNewStart.toISOString().split("T")[0],
-        endDate: succNewEnd.toISOString().split("T")[0]
+        endDate: succNewEnd.toISOString().split("T")[0],
+        ...shiftedActivitiesPatch(
+          task.activities,
+          projectDayDelta(origStart, succNewStart, businessDays, weekendPredicate),
+          businessDays,
+          weekendPredicate
+        )
       }));
     }
   }