@ganttloom/gantt-react 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,123 @@
1
+ import * as react from 'react';
2
+ import { CSSProperties, RefObject } from 'react';
3
+ import { GanttTask, GanttDependency, ViewMode, GanttColumn, GanttTheme, WorkingCalendar, GanttMarker, ResourceHistogramOptions, ResourceLoadBucket, ResourceLevelingOptions, ResourceLevelingResult, GanttRenderModel, GanttChart as GanttChart$1, GanttOptions } from '@ganttloom/gantt-core';
4
+ export { ConstraintType, DEFAULT_PALETTE, DENSITY_PRESETS, Density, DependencyType, FilterTasksOptions, FilterTasksResult, GanttAssignee, GanttColumn, GanttDependency, GanttEventMap, GanttMarker, GanttOptions, GanttRenderBar, GanttRenderLink, GanttRenderMarker, GanttRenderModel, GanttRenderRow, GanttRenderTick, GanttTask, GanttTheme, ResourceHistogramOptions, ResourceLevelingOptions, ResourceLevelingResult, ResourceLoadBucket, ViewMode, WorkingCalendar, applyColorByField, applyConstraint, colorByField, computeResourceHistogram, computeWBSCodes, filterTasks, isHoliday, isWithinWorkingHours, isWorkingDay, isWorkingTime, levelResources, nextWorkingDay, previousWorkingDay, renderResourceHistogramSVG, shiftToWorkingDay, shiftToWorkingTime } from '@ganttloom/gantt-core';
5
+
6
+ interface GanttChartProps {
7
+ tasks: GanttTask[];
8
+ dependencies?: GanttDependency[];
9
+ viewMode?: ViewMode;
10
+ columns?: GanttColumn[];
11
+ theme?: Partial<GanttTheme>;
12
+ colorScheme?: "light" | "dark" | "auto";
13
+ columnWidth?: number;
14
+ readonly?: boolean;
15
+ showProgress?: boolean;
16
+ showDependencies?: boolean;
17
+ gridPanelWidth?: number;
18
+ showCriticalPath?: boolean;
19
+ showBaseline?: boolean;
20
+ showDeadlines?: boolean;
21
+ showAssigneeAvatars?: boolean;
22
+ enableHistory?: boolean;
23
+ keyboardAccessible?: boolean;
24
+ virtualScroll?: boolean;
25
+ autoSchedule?: boolean;
26
+ pagination?: {
27
+ pageSize: number;
28
+ page: number;
29
+ };
30
+ snapToUnit?: "hour" | "day" | "week" | false;
31
+ /** working-day/holiday definition used to shade non-working time and (with autoSchedule) skip it when cascading */
32
+ calendar?: WorkingCalendar;
33
+ /** arbitrary labeled vertical lines on the timeline, independent of any task */
34
+ markers?: GanttMarker[];
35
+ /** a group task with no explicit `progress` gets a duration-weighted average of its children's progress instead of 0 */
36
+ autoRollupProgress?: boolean;
37
+ /** enables click/ctrl-click/shift-click multi-selection of task bars, and the handle's bulkShiftDates()/bulkDelete() */
38
+ selectable?: boolean;
39
+ onDateChange?: (task: GanttTask, start: Date, end: Date) => void;
40
+ onProgressChange?: (task: GanttTask, progress: number) => void;
41
+ onDependencyCreate?: (dep: GanttDependency) => void;
42
+ onDependencyRemove?: (dep: GanttDependency) => void;
43
+ /** called on double-click of a dependency link, for building your own "edit this link" UI (see the handle's updateDependency) */
44
+ onDependencyDblClick?: (dep: GanttDependency) => void;
45
+ onTaskClick?: (task: GanttTask) => void;
46
+ onGroupToggle?: (task: GanttTask, collapsed: boolean) => void;
47
+ onContextMenu?: (task: GanttTask, evt: PointerEvent) => void;
48
+ /** called when a task is created via drag-to-create on an empty timeline row */
49
+ onTaskCreate?: (task: GanttTask) => void;
50
+ /** called when a grid column is resized by dragging its header's edge */
51
+ onColumnResize?: (columnId: string, width: number) => void;
52
+ /** called when grid columns are reordered by dragging a header; `order` is the new full list of column ids */
53
+ onColumnReorder?: (order: string[]) => void;
54
+ /** called when a grid row is dragged onto another; "inside" reparents the dragged task under the target */
55
+ onTaskReorder?: (draggedTaskId: string, targetTaskId: string, position: "before" | "after" | "inside") => void;
56
+ onSelectionChange?: (taskIds: string[]) => void;
57
+ /** Applied to the wrapping container div. */
58
+ className?: string;
59
+ style?: CSSProperties;
60
+ }
61
+ /** Imperative escape hatches that don't need to be reactive props. */
62
+ interface GanttChartHandle {
63
+ undo(): void;
64
+ redo(): void;
65
+ canUndo(): boolean;
66
+ canRedo(): boolean;
67
+ expandAll(): void;
68
+ collapseAll(): void;
69
+ toggleGroup(taskId: string): void;
70
+ removeDependency(fromId: string, toId: string): void;
71
+ updateDependency(fromId: string, toId: string, partial: Partial<GanttDependency>): void;
72
+ updateTask(id: string, partial: Partial<GanttTask>): void;
73
+ setViewMode(mode: ViewMode): void;
74
+ fitToViewport(containerWidthPx: number): void;
75
+ scrollToToday(): void;
76
+ scrollToRangeStart(): void;
77
+ scrollToRangeEnd(): void;
78
+ getPageCount(): number;
79
+ setPage(page: number): void;
80
+ zoomIn(factor?: number): void;
81
+ zoomOut(factor?: number): void;
82
+ getZoomLevel(): number;
83
+ getResourceHistogram(options?: ResourceHistogramOptions): ResourceLoadBucket[];
84
+ getLeveledTasks(options?: ResourceLevelingOptions): ResourceLevelingResult;
85
+ selectTask(id: string, options?: {
86
+ additive?: boolean;
87
+ }): void;
88
+ selectAllVisible(): void;
89
+ clearSelection(): void;
90
+ getSelectedTaskIds(): string[];
91
+ bulkShiftDates(deltaMs: number): void;
92
+ bulkDelete(): void;
93
+ toSVGString(): string;
94
+ toPNGDataURL(): Promise<string>;
95
+ toPNGDataURLs(options?: {
96
+ pageWidthPx?: number;
97
+ pageHeightPx?: number;
98
+ }): Promise<string[]>;
99
+ getRenderModel(): GanttRenderModel | null;
100
+ /** Direct access to the underlying framework-agnostic core instance (null before mount). */
101
+ getInstance(): GanttChart$1 | null;
102
+ }
103
+ declare const GanttChart: react.ForwardRefExoticComponent<GanttChartProps & react.RefAttributes<GanttChartHandle>>;
104
+
105
+ interface UseGanttChartResult {
106
+ /** The underlying framework-agnostic GanttChart instance, or null before the DOM mount effect runs (or on the server). */
107
+ chart: GanttChart$1 | null;
108
+ /** Reactive, subscribed to the core's "history-change" event. Only meaningful when `enableHistory` is set in options. */
109
+ canUndo: boolean;
110
+ /** Reactive, subscribed to the core's "history-change" event. Only meaningful when `enableHistory` is set in options. */
111
+ canRedo: boolean;
112
+ }
113
+ /**
114
+ * Lower-level escape hatch for consumers who want to own their own container element
115
+ * and DOM tree instead of using the <GanttChart /> component. Constructs a
116
+ * @ganttloom/gantt-core GanttChart instance against `containerRef.current` on mount,
117
+ * keeps it in sync with `tasks` / `dependencies` / `options` via setTasks / setDependencies /
118
+ * setOptions (reference-equality checks only — pass new arrays/objects to trigger a sync),
119
+ * and destroys it on unmount.
120
+ */
121
+ declare function useGanttChart(containerRef: RefObject<HTMLElement | null>, tasks: GanttTask[], dependencies?: GanttDependency[], options?: GanttOptions): UseGanttChartResult;
122
+
123
+ export { GanttChart, type GanttChartHandle, type GanttChartProps, type UseGanttChartResult, GanttChart as default, useGanttChart };
@@ -0,0 +1,123 @@
1
+ import * as react from 'react';
2
+ import { CSSProperties, RefObject } from 'react';
3
+ import { GanttTask, GanttDependency, ViewMode, GanttColumn, GanttTheme, WorkingCalendar, GanttMarker, ResourceHistogramOptions, ResourceLoadBucket, ResourceLevelingOptions, ResourceLevelingResult, GanttRenderModel, GanttChart as GanttChart$1, GanttOptions } from '@ganttloom/gantt-core';
4
+ export { ConstraintType, DEFAULT_PALETTE, DENSITY_PRESETS, Density, DependencyType, FilterTasksOptions, FilterTasksResult, GanttAssignee, GanttColumn, GanttDependency, GanttEventMap, GanttMarker, GanttOptions, GanttRenderBar, GanttRenderLink, GanttRenderMarker, GanttRenderModel, GanttRenderRow, GanttRenderTick, GanttTask, GanttTheme, ResourceHistogramOptions, ResourceLevelingOptions, ResourceLevelingResult, ResourceLoadBucket, ViewMode, WorkingCalendar, applyColorByField, applyConstraint, colorByField, computeResourceHistogram, computeWBSCodes, filterTasks, isHoliday, isWithinWorkingHours, isWorkingDay, isWorkingTime, levelResources, nextWorkingDay, previousWorkingDay, renderResourceHistogramSVG, shiftToWorkingDay, shiftToWorkingTime } from '@ganttloom/gantt-core';
5
+
6
+ interface GanttChartProps {
7
+ tasks: GanttTask[];
8
+ dependencies?: GanttDependency[];
9
+ viewMode?: ViewMode;
10
+ columns?: GanttColumn[];
11
+ theme?: Partial<GanttTheme>;
12
+ colorScheme?: "light" | "dark" | "auto";
13
+ columnWidth?: number;
14
+ readonly?: boolean;
15
+ showProgress?: boolean;
16
+ showDependencies?: boolean;
17
+ gridPanelWidth?: number;
18
+ showCriticalPath?: boolean;
19
+ showBaseline?: boolean;
20
+ showDeadlines?: boolean;
21
+ showAssigneeAvatars?: boolean;
22
+ enableHistory?: boolean;
23
+ keyboardAccessible?: boolean;
24
+ virtualScroll?: boolean;
25
+ autoSchedule?: boolean;
26
+ pagination?: {
27
+ pageSize: number;
28
+ page: number;
29
+ };
30
+ snapToUnit?: "hour" | "day" | "week" | false;
31
+ /** working-day/holiday definition used to shade non-working time and (with autoSchedule) skip it when cascading */
32
+ calendar?: WorkingCalendar;
33
+ /** arbitrary labeled vertical lines on the timeline, independent of any task */
34
+ markers?: GanttMarker[];
35
+ /** a group task with no explicit `progress` gets a duration-weighted average of its children's progress instead of 0 */
36
+ autoRollupProgress?: boolean;
37
+ /** enables click/ctrl-click/shift-click multi-selection of task bars, and the handle's bulkShiftDates()/bulkDelete() */
38
+ selectable?: boolean;
39
+ onDateChange?: (task: GanttTask, start: Date, end: Date) => void;
40
+ onProgressChange?: (task: GanttTask, progress: number) => void;
41
+ onDependencyCreate?: (dep: GanttDependency) => void;
42
+ onDependencyRemove?: (dep: GanttDependency) => void;
43
+ /** called on double-click of a dependency link, for building your own "edit this link" UI (see the handle's updateDependency) */
44
+ onDependencyDblClick?: (dep: GanttDependency) => void;
45
+ onTaskClick?: (task: GanttTask) => void;
46
+ onGroupToggle?: (task: GanttTask, collapsed: boolean) => void;
47
+ onContextMenu?: (task: GanttTask, evt: PointerEvent) => void;
48
+ /** called when a task is created via drag-to-create on an empty timeline row */
49
+ onTaskCreate?: (task: GanttTask) => void;
50
+ /** called when a grid column is resized by dragging its header's edge */
51
+ onColumnResize?: (columnId: string, width: number) => void;
52
+ /** called when grid columns are reordered by dragging a header; `order` is the new full list of column ids */
53
+ onColumnReorder?: (order: string[]) => void;
54
+ /** called when a grid row is dragged onto another; "inside" reparents the dragged task under the target */
55
+ onTaskReorder?: (draggedTaskId: string, targetTaskId: string, position: "before" | "after" | "inside") => void;
56
+ onSelectionChange?: (taskIds: string[]) => void;
57
+ /** Applied to the wrapping container div. */
58
+ className?: string;
59
+ style?: CSSProperties;
60
+ }
61
+ /** Imperative escape hatches that don't need to be reactive props. */
62
+ interface GanttChartHandle {
63
+ undo(): void;
64
+ redo(): void;
65
+ canUndo(): boolean;
66
+ canRedo(): boolean;
67
+ expandAll(): void;
68
+ collapseAll(): void;
69
+ toggleGroup(taskId: string): void;
70
+ removeDependency(fromId: string, toId: string): void;
71
+ updateDependency(fromId: string, toId: string, partial: Partial<GanttDependency>): void;
72
+ updateTask(id: string, partial: Partial<GanttTask>): void;
73
+ setViewMode(mode: ViewMode): void;
74
+ fitToViewport(containerWidthPx: number): void;
75
+ scrollToToday(): void;
76
+ scrollToRangeStart(): void;
77
+ scrollToRangeEnd(): void;
78
+ getPageCount(): number;
79
+ setPage(page: number): void;
80
+ zoomIn(factor?: number): void;
81
+ zoomOut(factor?: number): void;
82
+ getZoomLevel(): number;
83
+ getResourceHistogram(options?: ResourceHistogramOptions): ResourceLoadBucket[];
84
+ getLeveledTasks(options?: ResourceLevelingOptions): ResourceLevelingResult;
85
+ selectTask(id: string, options?: {
86
+ additive?: boolean;
87
+ }): void;
88
+ selectAllVisible(): void;
89
+ clearSelection(): void;
90
+ getSelectedTaskIds(): string[];
91
+ bulkShiftDates(deltaMs: number): void;
92
+ bulkDelete(): void;
93
+ toSVGString(): string;
94
+ toPNGDataURL(): Promise<string>;
95
+ toPNGDataURLs(options?: {
96
+ pageWidthPx?: number;
97
+ pageHeightPx?: number;
98
+ }): Promise<string[]>;
99
+ getRenderModel(): GanttRenderModel | null;
100
+ /** Direct access to the underlying framework-agnostic core instance (null before mount). */
101
+ getInstance(): GanttChart$1 | null;
102
+ }
103
+ declare const GanttChart: react.ForwardRefExoticComponent<GanttChartProps & react.RefAttributes<GanttChartHandle>>;
104
+
105
+ interface UseGanttChartResult {
106
+ /** The underlying framework-agnostic GanttChart instance, or null before the DOM mount effect runs (or on the server). */
107
+ chart: GanttChart$1 | null;
108
+ /** Reactive, subscribed to the core's "history-change" event. Only meaningful when `enableHistory` is set in options. */
109
+ canUndo: boolean;
110
+ /** Reactive, subscribed to the core's "history-change" event. Only meaningful when `enableHistory` is set in options. */
111
+ canRedo: boolean;
112
+ }
113
+ /**
114
+ * Lower-level escape hatch for consumers who want to own their own container element
115
+ * and DOM tree instead of using the <GanttChart /> component. Constructs a
116
+ * @ganttloom/gantt-core GanttChart instance against `containerRef.current` on mount,
117
+ * keeps it in sync with `tasks` / `dependencies` / `options` via setTasks / setDependencies /
118
+ * setOptions (reference-equality checks only — pass new arrays/objects to trigger a sync),
119
+ * and destroys it on unmount.
120
+ */
121
+ declare function useGanttChart(containerRef: RefObject<HTMLElement | null>, tasks: GanttTask[], dependencies?: GanttDependency[], options?: GanttOptions): UseGanttChartResult;
122
+
123
+ export { GanttChart, type GanttChartHandle, type GanttChartProps, type UseGanttChartResult, GanttChart as default, useGanttChart };
package/dist/index.js ADDED
@@ -0,0 +1,342 @@
1
+ // src/GanttChart.tsx
2
+ import "@ganttloom/gantt-core/styles.css";
3
+ import {
4
+ forwardRef,
5
+ useEffect as useEffect2,
6
+ useImperativeHandle,
7
+ useMemo,
8
+ useRef as useRef2
9
+ } from "react";
10
+
11
+ // src/useGanttChart.ts
12
+ import { useEffect, useRef, useState } from "react";
13
+ import { GanttChart as GanttCore } from "@ganttloom/gantt-core";
14
+ var EMPTY_DEPENDENCIES = [];
15
+ var EMPTY_OPTIONS = {};
16
+ function useGanttChart(containerRef, tasks, dependencies = EMPTY_DEPENDENCIES, options = EMPTY_OPTIONS) {
17
+ const [chart, setChart] = useState(null);
18
+ const [canUndo, setCanUndo] = useState(false);
19
+ const [canRedo, setCanRedo] = useState(false);
20
+ const chartRef = useRef(null);
21
+ const initialTasksRef = useRef(tasks);
22
+ initialTasksRef.current = tasks;
23
+ const initialDepsRef = useRef(dependencies);
24
+ initialDepsRef.current = dependencies;
25
+ const initialOptionsRef = useRef(options);
26
+ initialOptionsRef.current = options;
27
+ useEffect(() => {
28
+ if (typeof window === "undefined") return void 0;
29
+ const container = containerRef.current;
30
+ if (!container) return void 0;
31
+ const instance = new GanttCore(
32
+ container,
33
+ initialTasksRef.current,
34
+ initialDepsRef.current,
35
+ initialOptionsRef.current
36
+ );
37
+ chartRef.current = instance;
38
+ setChart(instance);
39
+ setCanUndo(instance.canUndo);
40
+ setCanRedo(instance.canRedo);
41
+ const onHistoryChange = (state) => {
42
+ setCanUndo(state.canUndo);
43
+ setCanRedo(state.canRedo);
44
+ };
45
+ instance.on("history-change", onHistoryChange);
46
+ return () => {
47
+ instance.off("history-change", onHistoryChange);
48
+ instance.destroy();
49
+ chartRef.current = null;
50
+ setChart(null);
51
+ setCanUndo(false);
52
+ setCanRedo(false);
53
+ };
54
+ }, [containerRef]);
55
+ const isFirstTasksSync = useRef(true);
56
+ useEffect(() => {
57
+ if (isFirstTasksSync.current) {
58
+ isFirstTasksSync.current = false;
59
+ return;
60
+ }
61
+ chartRef.current?.setTasks(tasks);
62
+ }, [tasks]);
63
+ const isFirstDepsSync = useRef(true);
64
+ useEffect(() => {
65
+ if (isFirstDepsSync.current) {
66
+ isFirstDepsSync.current = false;
67
+ return;
68
+ }
69
+ chartRef.current?.setDependencies(dependencies);
70
+ }, [dependencies]);
71
+ const isFirstOptionsSync = useRef(true);
72
+ useEffect(() => {
73
+ if (isFirstOptionsSync.current) {
74
+ isFirstOptionsSync.current = false;
75
+ return;
76
+ }
77
+ chartRef.current?.setOptions(options);
78
+ }, [options]);
79
+ return { chart, canUndo, canRedo };
80
+ }
81
+
82
+ // src/GanttChart.tsx
83
+ import { jsx } from "react/jsx-runtime";
84
+ var EMPTY_DEPENDENCIES2 = [];
85
+ var EMPTY_RENDER_MODEL = {
86
+ width: 0,
87
+ height: 0,
88
+ rowHeight: 0,
89
+ headerHeight: 0,
90
+ rows: [],
91
+ bars: [],
92
+ links: [],
93
+ ticks: [],
94
+ columns: [],
95
+ theme: {},
96
+ markers: [],
97
+ rangeStart: /* @__PURE__ */ new Date(0)
98
+ };
99
+ function GanttChartInner(props, ref) {
100
+ const {
101
+ tasks,
102
+ dependencies = EMPTY_DEPENDENCIES2,
103
+ className,
104
+ style,
105
+ onDateChange,
106
+ onProgressChange,
107
+ onDependencyCreate,
108
+ onDependencyRemove,
109
+ onDependencyDblClick,
110
+ onTaskClick,
111
+ onGroupToggle,
112
+ onContextMenu,
113
+ onTaskCreate,
114
+ onColumnResize,
115
+ onColumnReorder,
116
+ onTaskReorder,
117
+ onSelectionChange,
118
+ ...rest
119
+ } = props;
120
+ const containerRef = useRef2(null);
121
+ const enableContextMenuWiring = useRef2(() => {
122
+ });
123
+ const enableCreateWiring = useRef2(() => {
124
+ });
125
+ const enableColumnResizeWiring = useRef2((_columnId, _width) => {
126
+ });
127
+ const enableColumnReorderWiring = useRef2((_order) => {
128
+ });
129
+ const enableTaskReorderWiring = useRef2(
130
+ (_draggedTaskId, _targetTaskId, _position) => {
131
+ }
132
+ );
133
+ const enableDependencyDblClickWiring = useRef2((_dep) => {
134
+ });
135
+ const options = useMemo(
136
+ () => ({
137
+ ...rest,
138
+ onContextMenu: enableContextMenuWiring.current,
139
+ onTaskCreate: onTaskCreate ? enableCreateWiring.current : void 0,
140
+ onColumnResize: onColumnResize ? enableColumnResizeWiring.current : void 0,
141
+ onColumnReorder: onColumnReorder ? enableColumnReorderWiring.current : void 0,
142
+ onTaskReorder: onTaskReorder ? enableTaskReorderWiring.current : void 0,
143
+ onDependencyDblClick: onDependencyDblClick ? enableDependencyDblClickWiring.current : void 0,
144
+ onSelectionChange
145
+ }),
146
+ [
147
+ rest.viewMode,
148
+ rest.columns,
149
+ rest.theme,
150
+ rest.colorScheme,
151
+ rest.columnWidth,
152
+ rest.readonly,
153
+ rest.showProgress,
154
+ rest.showDependencies,
155
+ rest.gridPanelWidth,
156
+ rest.showCriticalPath,
157
+ rest.showBaseline,
158
+ rest.showDeadlines,
159
+ rest.showAssigneeAvatars,
160
+ rest.enableHistory,
161
+ rest.keyboardAccessible,
162
+ rest.virtualScroll,
163
+ rest.autoSchedule,
164
+ rest.pagination,
165
+ rest.snapToUnit,
166
+ rest.calendar,
167
+ rest.markers,
168
+ rest.autoRollupProgress,
169
+ rest.selectable,
170
+ Boolean(onTaskCreate),
171
+ Boolean(onColumnResize),
172
+ Boolean(onColumnReorder),
173
+ Boolean(onTaskReorder),
174
+ Boolean(onDependencyDblClick),
175
+ onSelectionChange
176
+ ]
177
+ );
178
+ const { chart } = useGanttChart(containerRef, tasks, dependencies, options);
179
+ const callbacksRef = useRef2({
180
+ onDateChange,
181
+ onProgressChange,
182
+ onDependencyCreate,
183
+ onDependencyRemove,
184
+ onDependencyDblClick,
185
+ onTaskClick,
186
+ onGroupToggle,
187
+ onContextMenu,
188
+ onTaskCreate,
189
+ onColumnResize,
190
+ onColumnReorder,
191
+ onTaskReorder,
192
+ onSelectionChange
193
+ });
194
+ callbacksRef.current = {
195
+ onDateChange,
196
+ onProgressChange,
197
+ onDependencyCreate,
198
+ onDependencyRemove,
199
+ onDependencyDblClick,
200
+ onTaskClick,
201
+ onGroupToggle,
202
+ onContextMenu,
203
+ onTaskCreate,
204
+ onColumnResize,
205
+ onColumnReorder,
206
+ onTaskReorder,
207
+ onSelectionChange
208
+ };
209
+ useEffect2(() => {
210
+ if (!chart) return void 0;
211
+ const handleDateChange = (p) => callbacksRef.current.onDateChange?.(p.task, p.start, p.end);
212
+ const handleProgressChange = (p) => callbacksRef.current.onProgressChange?.(p.task, p.progress);
213
+ const handleDependencyCreate = (dep) => callbacksRef.current.onDependencyCreate?.(dep);
214
+ const handleDependencyRemove = (dep) => callbacksRef.current.onDependencyRemove?.(dep);
215
+ const handleTaskClick = (p) => callbacksRef.current.onTaskClick?.(p.task);
216
+ const handleGroupToggle = (p) => callbacksRef.current.onGroupToggle?.(p.task, p.collapsed);
217
+ const handleContextMenu = (p) => callbacksRef.current.onContextMenu?.(p.task, p.evt);
218
+ const handleTaskCreate = (p) => callbacksRef.current.onTaskCreate?.(p.task);
219
+ const handleColumnResize = (p) => callbacksRef.current.onColumnResize?.(p.columnId, p.width);
220
+ const handleColumnReorder = (p) => callbacksRef.current.onColumnReorder?.(p.order);
221
+ const handleDependencyDblClick = (dep) => callbacksRef.current.onDependencyDblClick?.(dep);
222
+ const handleTaskReorder = (p) => callbacksRef.current.onTaskReorder?.(p.draggedTaskId, p.targetTaskId, p.position);
223
+ const handleSelectionChange = (p) => callbacksRef.current.onSelectionChange?.(p.taskIds);
224
+ chart.on("date-change", handleDateChange);
225
+ chart.on("progress-change", handleProgressChange);
226
+ chart.on("dependency-create", handleDependencyCreate);
227
+ chart.on("dependency-remove", handleDependencyRemove);
228
+ chart.on("dependency-dblclick", handleDependencyDblClick);
229
+ chart.on("task-click", handleTaskClick);
230
+ chart.on("group-toggle", handleGroupToggle);
231
+ chart.on("context-menu", handleContextMenu);
232
+ chart.on("task-create", handleTaskCreate);
233
+ chart.on("column-resize", handleColumnResize);
234
+ chart.on("column-reorder", handleColumnReorder);
235
+ chart.on("task-reorder", handleTaskReorder);
236
+ chart.on("selection-change", handleSelectionChange);
237
+ return () => {
238
+ chart.off("date-change", handleDateChange);
239
+ chart.off("progress-change", handleProgressChange);
240
+ chart.off("dependency-create", handleDependencyCreate);
241
+ chart.off("dependency-remove", handleDependencyRemove);
242
+ chart.off("dependency-dblclick", handleDependencyDblClick);
243
+ chart.off("task-click", handleTaskClick);
244
+ chart.off("group-toggle", handleGroupToggle);
245
+ chart.off("context-menu", handleContextMenu);
246
+ chart.off("task-create", handleTaskCreate);
247
+ chart.off("column-resize", handleColumnResize);
248
+ chart.off("column-reorder", handleColumnReorder);
249
+ chart.off("task-reorder", handleTaskReorder);
250
+ chart.off("selection-change", handleSelectionChange);
251
+ };
252
+ }, [chart]);
253
+ useImperativeHandle(
254
+ ref,
255
+ () => ({
256
+ undo: () => chart?.undo(),
257
+ redo: () => chart?.redo(),
258
+ canUndo: () => chart?.canUndo ?? false,
259
+ canRedo: () => chart?.canRedo ?? false,
260
+ expandAll: () => chart?.expandAll(),
261
+ collapseAll: () => chart?.collapseAll(),
262
+ toggleGroup: (taskId) => chart?.toggleGroup(taskId),
263
+ removeDependency: (fromId, toId) => chart?.removeDependency(fromId, toId),
264
+ updateDependency: (fromId, toId, partial) => chart?.updateDependency(fromId, toId, partial),
265
+ updateTask: (id, partial) => chart?.updateTask(id, partial),
266
+ setViewMode: (mode) => chart?.setViewMode(mode),
267
+ fitToViewport: (containerWidthPx) => chart?.fitToViewport(containerWidthPx),
268
+ scrollToToday: () => chart?.scrollToToday(),
269
+ scrollToRangeStart: () => chart?.scrollToRangeStart(),
270
+ scrollToRangeEnd: () => chart?.scrollToRangeEnd(),
271
+ getPageCount: () => chart?.getPageCount() ?? 1,
272
+ setPage: (page) => chart?.setPage(page),
273
+ zoomIn: (factor) => chart?.zoomIn(factor),
274
+ zoomOut: (factor) => chart?.zoomOut(factor),
275
+ getZoomLevel: () => chart?.getZoomLevel() ?? 0,
276
+ getResourceHistogram: (options2) => chart?.getResourceHistogram(options2) ?? [],
277
+ getLeveledTasks: (options2) => chart?.getLeveledTasks(options2) ?? { tasks: [], shifted: [] },
278
+ selectTask: (id, options2) => chart?.selectTask(id, options2),
279
+ selectAllVisible: () => chart?.selectAllVisible(),
280
+ clearSelection: () => chart?.clearSelection(),
281
+ getSelectedTaskIds: () => chart?.getSelectedTaskIds() ?? [],
282
+ bulkShiftDates: (deltaMs) => chart?.bulkShiftDates(deltaMs),
283
+ bulkDelete: () => chart?.bulkDelete(),
284
+ toSVGString: () => chart?.toSVGString() ?? "",
285
+ toPNGDataURL: () => chart?.toPNGDataURL() ?? Promise.resolve(""),
286
+ toPNGDataURLs: (options2) => chart?.toPNGDataURLs(options2) ?? Promise.resolve([]),
287
+ getRenderModel: () => chart?.getRenderModel() ?? EMPTY_RENDER_MODEL,
288
+ getInstance: () => chart
289
+ }),
290
+ [chart]
291
+ );
292
+ return /* @__PURE__ */ jsx("div", { ref: containerRef, className, style });
293
+ }
294
+ var GanttChart = forwardRef(GanttChartInner);
295
+ GanttChart.displayName = "GanttChart";
296
+ var GanttChart_default = GanttChart;
297
+
298
+ // src/index.ts
299
+ import {
300
+ computeWBSCodes,
301
+ applyConstraint,
302
+ isWorkingDay,
303
+ isHoliday,
304
+ isWithinWorkingHours,
305
+ isWorkingTime,
306
+ nextWorkingDay,
307
+ previousWorkingDay,
308
+ shiftToWorkingDay,
309
+ shiftToWorkingTime,
310
+ computeResourceHistogram,
311
+ renderResourceHistogramSVG,
312
+ filterTasks,
313
+ colorByField,
314
+ applyColorByField,
315
+ DEFAULT_PALETTE,
316
+ DENSITY_PRESETS,
317
+ levelResources
318
+ } from "@ganttloom/gantt-core";
319
+ export {
320
+ DEFAULT_PALETTE,
321
+ DENSITY_PRESETS,
322
+ GanttChart,
323
+ applyColorByField,
324
+ applyConstraint,
325
+ colorByField,
326
+ computeResourceHistogram,
327
+ computeWBSCodes,
328
+ GanttChart_default as default,
329
+ filterTasks,
330
+ isHoliday,
331
+ isWithinWorkingHours,
332
+ isWorkingDay,
333
+ isWorkingTime,
334
+ levelResources,
335
+ nextWorkingDay,
336
+ previousWorkingDay,
337
+ renderResourceHistogramSVG,
338
+ shiftToWorkingDay,
339
+ shiftToWorkingTime,
340
+ useGanttChart
341
+ };
342
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/GanttChart.tsx","../src/useGanttChart.ts","../src/index.ts"],"sourcesContent":["// Pulls in the core's default styles so consumers get a working chart out of the box.\n// This resolves through gantt-core's package.json \"exports\" map (\"./styles.css\" -> \"./dist/styles.css\").\n// If your bundler can't resolve CSS imports from a dependency's export map, import it yourself instead:\n// import \"@ganttloom/gantt-core/styles.css\";\nimport \"@ganttloom/gantt-core/styles.css\";\n\nimport {\n forwardRef,\n useEffect,\n useImperativeHandle,\n useMemo,\n useRef,\n type CSSProperties,\n type Ref,\n} from \"react\";\nimport type {\n GanttChart as GanttCore,\n GanttColumn,\n GanttDependency,\n GanttMarker,\n GanttOptions,\n GanttRenderModel,\n GanttTask,\n GanttTheme,\n ResourceHistogramOptions,\n ResourceLoadBucket,\n ResourceLevelingOptions,\n ResourceLevelingResult,\n ViewMode,\n WorkingCalendar,\n} from \"@ganttloom/gantt-core\";\nimport { useGanttChart } from \"./useGanttChart\";\n\nexport interface GanttChartProps {\n tasks: GanttTask[];\n dependencies?: GanttDependency[];\n\n // Mirrors of GanttOptions' non-callback fields.\n viewMode?: ViewMode;\n columns?: GanttColumn[];\n theme?: Partial<GanttTheme>;\n colorScheme?: \"light\" | \"dark\" | \"auto\";\n columnWidth?: number;\n readonly?: boolean;\n showProgress?: boolean;\n showDependencies?: boolean;\n gridPanelWidth?: number;\n showCriticalPath?: boolean;\n showBaseline?: boolean;\n showDeadlines?: boolean;\n showAssigneeAvatars?: boolean;\n enableHistory?: boolean;\n keyboardAccessible?: boolean;\n virtualScroll?: boolean;\n autoSchedule?: boolean;\n pagination?: { pageSize: number; page: number };\n snapToUnit?: \"hour\" | \"day\" | \"week\" | false;\n /** working-day/holiday definition used to shade non-working time and (with autoSchedule) skip it when cascading */\n calendar?: WorkingCalendar;\n /** arbitrary labeled vertical lines on the timeline, independent of any task */\n markers?: GanttMarker[];\n /** a group task with no explicit `progress` gets a duration-weighted average of its children's progress instead of 0 */\n autoRollupProgress?: boolean;\n /** enables click/ctrl-click/shift-click multi-selection of task bars, and the handle's bulkShiftDates()/bulkDelete() */\n selectable?: boolean;\n\n // Mirrors of GanttOptions' callback fields, as normal React event props.\n onDateChange?: (task: GanttTask, start: Date, end: Date) => void;\n onProgressChange?: (task: GanttTask, progress: number) => void;\n onDependencyCreate?: (dep: GanttDependency) => void;\n onDependencyRemove?: (dep: GanttDependency) => void;\n /** called on double-click of a dependency link, for building your own \"edit this link\" UI (see the handle's updateDependency) */\n onDependencyDblClick?: (dep: GanttDependency) => void;\n onTaskClick?: (task: GanttTask) => void;\n onGroupToggle?: (task: GanttTask, collapsed: boolean) => void;\n onContextMenu?: (task: GanttTask, evt: PointerEvent) => void;\n /** called when a task is created via drag-to-create on an empty timeline row */\n onTaskCreate?: (task: GanttTask) => void;\n /** called when a grid column is resized by dragging its header's edge */\n onColumnResize?: (columnId: string, width: number) => void;\n /** called when grid columns are reordered by dragging a header; `order` is the new full list of column ids */\n onColumnReorder?: (order: string[]) => void;\n /** called when a grid row is dragged onto another; \"inside\" reparents the dragged task under the target */\n onTaskReorder?: (draggedTaskId: string, targetTaskId: string, position: \"before\" | \"after\" | \"inside\") => void;\n onSelectionChange?: (taskIds: string[]) => void;\n\n /** Applied to the wrapping container div. */\n className?: string;\n style?: CSSProperties;\n}\n\n/** Imperative escape hatches that don't need to be reactive props. */\nexport interface GanttChartHandle {\n undo(): void;\n redo(): void;\n canUndo(): boolean;\n canRedo(): boolean;\n expandAll(): void;\n collapseAll(): void;\n toggleGroup(taskId: string): void;\n removeDependency(fromId: string, toId: string): void;\n updateDependency(fromId: string, toId: string, partial: Partial<GanttDependency>): void;\n updateTask(id: string, partial: Partial<GanttTask>): void;\n setViewMode(mode: ViewMode): void;\n fitToViewport(containerWidthPx: number): void;\n scrollToToday(): void;\n scrollToRangeStart(): void;\n scrollToRangeEnd(): void;\n getPageCount(): number;\n setPage(page: number): void;\n zoomIn(factor?: number): void;\n zoomOut(factor?: number): void;\n getZoomLevel(): number;\n getResourceHistogram(options?: ResourceHistogramOptions): ResourceLoadBucket[];\n getLeveledTasks(options?: ResourceLevelingOptions): ResourceLevelingResult;\n selectTask(id: string, options?: { additive?: boolean }): void;\n selectAllVisible(): void;\n clearSelection(): void;\n getSelectedTaskIds(): string[];\n bulkShiftDates(deltaMs: number): void;\n bulkDelete(): void;\n toSVGString(): string;\n toPNGDataURL(): Promise<string>;\n toPNGDataURLs(options?: { pageWidthPx?: number; pageHeightPx?: number }): Promise<string[]>;\n getRenderModel(): GanttRenderModel | null;\n /** Direct access to the underlying framework-agnostic core instance (null before mount). */\n getInstance(): GanttCore | null;\n}\n\nconst EMPTY_DEPENDENCIES: GanttDependency[] = [];\n\nconst EMPTY_RENDER_MODEL: GanttRenderModel = {\n width: 0,\n height: 0,\n rowHeight: 0,\n headerHeight: 0,\n rows: [],\n bars: [],\n links: [],\n ticks: [],\n columns: [],\n theme: {} as GanttTheme,\n markers: [],\n rangeStart: new Date(0),\n};\n\nfunction GanttChartInner(props: GanttChartProps, ref: Ref<GanttChartHandle>) {\n const {\n tasks,\n dependencies = EMPTY_DEPENDENCIES,\n className,\n style,\n onDateChange,\n onProgressChange,\n onDependencyCreate,\n onDependencyRemove,\n onDependencyDblClick,\n onTaskClick,\n onGroupToggle,\n onContextMenu,\n onTaskCreate,\n onColumnResize,\n onColumnReorder,\n onTaskReorder,\n onSelectionChange,\n ...rest\n } = props;\n\n const containerRef = useRef<HTMLDivElement | null>(null);\n\n // The core only wires up its internal contextmenu DOM listener (and therefore only\n // ever emits the \"context-menu\" event) when options.onContextMenu is truthy AT\n // CONSTRUCTION TIME (see GanttChart#setupDom in gantt-core). We pass a stable no-op\n // here purely to force that wiring on regardless of whether the consumer supplied\n // onContextMenu, and dispatch the actual prop via the \"context-menu\" event\n // subscription below (so it stays reactive to prop changes and is never double-fired).\n const enableContextMenuWiring = useRef(() => {});\n\n // Same construction-time-only caveat as onContextMenu above: drag-to-create is only\n // wired into the core's InteractionController when options.onTaskCreate is truthy at\n // construction. A stable no-op forces it on whenever this component was given an\n // onTaskCreate prop at all; the real dispatch goes through the \"task-create\" event.\n const enableCreateWiring = useRef(() => {});\n\n // Same construction-time-only caveat: column resize/reorder DOM listeners are only\n // built into the grid header when these options are truthy at construction.\n const enableColumnResizeWiring = useRef((_columnId: string, _width: number) => {});\n const enableColumnReorderWiring = useRef((_order: string[]) => {});\n const enableTaskReorderWiring = useRef(\n (_draggedTaskId: string, _targetTaskId: string, _position: \"before\" | \"after\" | \"inside\") => {}\n );\n const enableDependencyDblClickWiring = useRef((_dep: GanttDependency) => {});\n\n const options = useMemo<GanttOptions>(\n () => ({\n ...rest,\n onContextMenu: enableContextMenuWiring.current,\n onTaskCreate: onTaskCreate ? enableCreateWiring.current : undefined,\n onColumnResize: onColumnResize ? enableColumnResizeWiring.current : undefined,\n onColumnReorder: onColumnReorder ? enableColumnReorderWiring.current : undefined,\n onTaskReorder: onTaskReorder ? enableTaskReorderWiring.current : undefined,\n onDependencyDblClick: onDependencyDblClick ? enableDependencyDblClickWiring.current : undefined,\n onSelectionChange,\n }),\n [\n rest.viewMode,\n rest.columns,\n rest.theme,\n rest.colorScheme,\n rest.columnWidth,\n rest.readonly,\n rest.showProgress,\n rest.showDependencies,\n rest.gridPanelWidth,\n rest.showCriticalPath,\n rest.showBaseline,\n rest.showDeadlines,\n rest.showAssigneeAvatars,\n rest.enableHistory,\n rest.keyboardAccessible,\n rest.virtualScroll,\n rest.autoSchedule,\n rest.pagination,\n rest.snapToUnit,\n rest.calendar,\n rest.markers,\n rest.autoRollupProgress,\n rest.selectable,\n Boolean(onTaskCreate),\n Boolean(onColumnResize),\n Boolean(onColumnReorder),\n Boolean(onTaskReorder),\n Boolean(onDependencyDblClick),\n onSelectionChange,\n ]\n );\n\n const { chart } = useGanttChart(containerRef, tasks, dependencies, options);\n\n // Keep the latest callback props in a ref so the event-subscription effect below\n // doesn't need to re-subscribe (tearing down/rebuilding listeners) on every render.\n const callbacksRef = useRef({\n onDateChange,\n onProgressChange,\n onDependencyCreate,\n onDependencyRemove,\n onDependencyDblClick,\n onTaskClick,\n onGroupToggle,\n onContextMenu,\n onTaskCreate,\n onColumnResize,\n onColumnReorder,\n onTaskReorder,\n onSelectionChange,\n });\n callbacksRef.current = {\n onDateChange,\n onProgressChange,\n onDependencyCreate,\n onDependencyRemove,\n onDependencyDblClick,\n onTaskClick,\n onGroupToggle,\n onContextMenu,\n onTaskCreate,\n onColumnResize,\n onColumnReorder,\n onTaskReorder,\n onSelectionChange,\n };\n\n useEffect(() => {\n if (!chart) return undefined;\n\n const handleDateChange = (p: { task: GanttTask; start: Date; end: Date }) =>\n callbacksRef.current.onDateChange?.(p.task, p.start, p.end);\n const handleProgressChange = (p: { task: GanttTask; progress: number }) =>\n callbacksRef.current.onProgressChange?.(p.task, p.progress);\n const handleDependencyCreate = (dep: GanttDependency) =>\n callbacksRef.current.onDependencyCreate?.(dep);\n const handleDependencyRemove = (dep: GanttDependency) =>\n callbacksRef.current.onDependencyRemove?.(dep);\n const handleTaskClick = (p: { task: GanttTask }) =>\n callbacksRef.current.onTaskClick?.(p.task);\n const handleGroupToggle = (p: { task: GanttTask; collapsed: boolean }) =>\n callbacksRef.current.onGroupToggle?.(p.task, p.collapsed);\n const handleContextMenu = (p: { task: GanttTask; evt: PointerEvent }) =>\n callbacksRef.current.onContextMenu?.(p.task, p.evt);\n const handleTaskCreate = (p: { task: GanttTask }) => callbacksRef.current.onTaskCreate?.(p.task);\n const handleColumnResize = (p: { columnId: string; width: number }) =>\n callbacksRef.current.onColumnResize?.(p.columnId, p.width);\n const handleColumnReorder = (p: { order: string[] }) =>\n callbacksRef.current.onColumnReorder?.(p.order);\n const handleDependencyDblClick = (dep: GanttDependency) =>\n callbacksRef.current.onDependencyDblClick?.(dep);\n const handleTaskReorder = (p: {\n draggedTaskId: string;\n targetTaskId: string;\n position: \"before\" | \"after\" | \"inside\";\n }) => callbacksRef.current.onTaskReorder?.(p.draggedTaskId, p.targetTaskId, p.position);\n const handleSelectionChange = (p: { taskIds: string[] }) =>\n callbacksRef.current.onSelectionChange?.(p.taskIds);\n\n chart.on(\"date-change\", handleDateChange);\n chart.on(\"progress-change\", handleProgressChange);\n chart.on(\"dependency-create\", handleDependencyCreate);\n chart.on(\"dependency-remove\", handleDependencyRemove);\n chart.on(\"dependency-dblclick\", handleDependencyDblClick);\n chart.on(\"task-click\", handleTaskClick);\n chart.on(\"group-toggle\", handleGroupToggle);\n chart.on(\"context-menu\", handleContextMenu);\n chart.on(\"task-create\", handleTaskCreate);\n chart.on(\"column-resize\", handleColumnResize);\n chart.on(\"column-reorder\", handleColumnReorder);\n chart.on(\"task-reorder\", handleTaskReorder);\n chart.on(\"selection-change\", handleSelectionChange);\n\n return () => {\n chart.off(\"date-change\", handleDateChange);\n chart.off(\"progress-change\", handleProgressChange);\n chart.off(\"dependency-create\", handleDependencyCreate);\n chart.off(\"dependency-remove\", handleDependencyRemove);\n chart.off(\"dependency-dblclick\", handleDependencyDblClick);\n chart.off(\"task-click\", handleTaskClick);\n chart.off(\"group-toggle\", handleGroupToggle);\n chart.off(\"context-menu\", handleContextMenu);\n chart.off(\"task-create\", handleTaskCreate);\n chart.off(\"column-resize\", handleColumnResize);\n chart.off(\"column-reorder\", handleColumnReorder);\n chart.off(\"task-reorder\", handleTaskReorder);\n chart.off(\"selection-change\", handleSelectionChange);\n };\n }, [chart]);\n\n useImperativeHandle(\n ref,\n (): GanttChartHandle => ({\n undo: () => chart?.undo(),\n redo: () => chart?.redo(),\n canUndo: () => chart?.canUndo ?? false,\n canRedo: () => chart?.canRedo ?? false,\n expandAll: () => chart?.expandAll(),\n collapseAll: () => chart?.collapseAll(),\n toggleGroup: (taskId: string) => chart?.toggleGroup(taskId),\n removeDependency: (fromId: string, toId: string) => chart?.removeDependency(fromId, toId),\n updateDependency: (fromId: string, toId: string, partial: Partial<GanttDependency>) =>\n chart?.updateDependency(fromId, toId, partial),\n updateTask: (id: string, partial: Partial<GanttTask>) => chart?.updateTask(id, partial),\n setViewMode: (mode: ViewMode) => chart?.setViewMode(mode),\n fitToViewport: (containerWidthPx: number) => chart?.fitToViewport(containerWidthPx),\n scrollToToday: () => chart?.scrollToToday(),\n scrollToRangeStart: () => chart?.scrollToRangeStart(),\n scrollToRangeEnd: () => chart?.scrollToRangeEnd(),\n getPageCount: () => chart?.getPageCount() ?? 1,\n setPage: (page: number) => chart?.setPage(page),\n zoomIn: (factor?: number) => chart?.zoomIn(factor),\n zoomOut: (factor?: number) => chart?.zoomOut(factor),\n getZoomLevel: () => chart?.getZoomLevel() ?? 0,\n getResourceHistogram: (options?: ResourceHistogramOptions) =>\n chart?.getResourceHistogram(options) ?? [],\n getLeveledTasks: (options?: ResourceLevelingOptions) =>\n chart?.getLeveledTasks(options) ?? { tasks: [], shifted: [] },\n selectTask: (id: string, options?: { additive?: boolean }) => chart?.selectTask(id, options),\n selectAllVisible: () => chart?.selectAllVisible(),\n clearSelection: () => chart?.clearSelection(),\n getSelectedTaskIds: () => chart?.getSelectedTaskIds() ?? [],\n bulkShiftDates: (deltaMs: number) => chart?.bulkShiftDates(deltaMs),\n bulkDelete: () => chart?.bulkDelete(),\n toSVGString: () => chart?.toSVGString() ?? \"\",\n toPNGDataURL: () => chart?.toPNGDataURL() ?? Promise.resolve(\"\"),\n toPNGDataURLs: (options?: { pageWidthPx?: number; pageHeightPx?: number }) =>\n chart?.toPNGDataURLs(options) ?? Promise.resolve([]),\n getRenderModel: () => chart?.getRenderModel() ?? EMPTY_RENDER_MODEL,\n getInstance: () => chart,\n }),\n [chart]\n );\n\n return <div ref={containerRef} className={className} style={style} />;\n}\n\nexport const GanttChart = forwardRef(GanttChartInner);\nGanttChart.displayName = \"GanttChart\";\n\nexport default GanttChart;\n","import { useEffect, useRef, useState, type RefObject } from \"react\";\nimport { GanttChart as GanttCore } from \"@ganttloom/gantt-core\";\nimport type { GanttDependency, GanttOptions, GanttTask } from \"@ganttloom/gantt-core\";\n\nexport interface UseGanttChartResult {\n /** The underlying framework-agnostic GanttChart instance, or null before the DOM mount effect runs (or on the server). */\n chart: GanttCore | null;\n /** Reactive, subscribed to the core's \"history-change\" event. Only meaningful when `enableHistory` is set in options. */\n canUndo: boolean;\n /** Reactive, subscribed to the core's \"history-change\" event. Only meaningful when `enableHistory` is set in options. */\n canRedo: boolean;\n}\n\nconst EMPTY_DEPENDENCIES: GanttDependency[] = [];\nconst EMPTY_OPTIONS: GanttOptions = {};\n\n/**\n * Lower-level escape hatch for consumers who want to own their own container element\n * and DOM tree instead of using the <GanttChart /> component. Constructs a\n * @ganttloom/gantt-core GanttChart instance against `containerRef.current` on mount,\n * keeps it in sync with `tasks` / `dependencies` / `options` via setTasks / setDependencies /\n * setOptions (reference-equality checks only — pass new arrays/objects to trigger a sync),\n * and destroys it on unmount.\n */\nexport function useGanttChart(\n containerRef: RefObject<HTMLElement | null>,\n tasks: GanttTask[],\n dependencies: GanttDependency[] = EMPTY_DEPENDENCIES,\n options: GanttOptions = EMPTY_OPTIONS\n): UseGanttChartResult {\n const [chart, setChart] = useState<GanttCore | null>(null);\n const [canUndo, setCanUndo] = useState(false);\n const [canRedo, setCanRedo] = useState(false);\n\n const chartRef = useRef<GanttCore | null>(null);\n\n // Latest props, read from the mount effect so it doesn't need to depend on them\n // (which would otherwise tear down and recreate the whole chart on every change).\n const initialTasksRef = useRef(tasks);\n initialTasksRef.current = tasks;\n const initialDepsRef = useRef(dependencies);\n initialDepsRef.current = dependencies;\n const initialOptionsRef = useRef(options);\n initialOptionsRef.current = options;\n\n useEffect(() => {\n if (typeof window === \"undefined\") return undefined;\n const container = containerRef.current;\n if (!container) return undefined;\n\n const instance = new GanttCore(\n container,\n initialTasksRef.current,\n initialDepsRef.current,\n initialOptionsRef.current\n );\n chartRef.current = instance;\n setChart(instance);\n setCanUndo(instance.canUndo);\n setCanRedo(instance.canRedo);\n\n const onHistoryChange = (state: { canUndo: boolean; canRedo: boolean }) => {\n setCanUndo(state.canUndo);\n setCanRedo(state.canRedo);\n };\n instance.on(\"history-change\", onHistoryChange);\n\n return () => {\n instance.off(\"history-change\", onHistoryChange);\n instance.destroy();\n chartRef.current = null;\n setChart(null);\n setCanUndo(false);\n setCanRedo(false);\n };\n // Intentionally mount/unmount only — the container element identity is what matters.\n // eslint-disable-next-line react-hooks/exhaustive-deps\n }, [containerRef]);\n\n const isFirstTasksSync = useRef(true);\n useEffect(() => {\n if (isFirstTasksSync.current) {\n isFirstTasksSync.current = false;\n return;\n }\n chartRef.current?.setTasks(tasks);\n }, [tasks]);\n\n const isFirstDepsSync = useRef(true);\n useEffect(() => {\n if (isFirstDepsSync.current) {\n isFirstDepsSync.current = false;\n return;\n }\n chartRef.current?.setDependencies(dependencies);\n }, [dependencies]);\n\n const isFirstOptionsSync = useRef(true);\n useEffect(() => {\n if (isFirstOptionsSync.current) {\n isFirstOptionsSync.current = false;\n return;\n }\n chartRef.current?.setOptions(options);\n }, [options]);\n\n return { chart, canUndo, canRedo };\n}\n","export { GanttChart, default } from \"./GanttChart\";\nexport type { GanttChartProps, GanttChartHandle } from \"./GanttChart\";\n\nexport { useGanttChart } from \"./useGanttChart\";\nexport type { UseGanttChartResult } from \"./useGanttChart\";\n\n// Re-exported so consumers never need to add @ganttloom/gantt-core as a direct\n// dependency just to reference its types.\nexport type {\n ViewMode,\n DependencyType,\n GanttDependency,\n GanttAssignee,\n GanttTask,\n GanttColumn,\n GanttTheme,\n GanttRenderRow,\n GanttRenderBar,\n GanttRenderLink,\n GanttRenderTick,\n GanttRenderModel,\n GanttOptions,\n GanttEventMap,\n WorkingCalendar,\n ConstraintType,\n ResourceHistogramOptions,\n ResourceLoadBucket,\n GanttMarker,\n GanttRenderMarker,\n FilterTasksOptions,\n FilterTasksResult,\n Density,\n ResourceLevelingOptions,\n ResourceLevelingResult,\n} from \"@ganttloom/gantt-core\";\n\nexport {\n computeWBSCodes,\n applyConstraint,\n isWorkingDay,\n isHoliday,\n isWithinWorkingHours,\n isWorkingTime,\n nextWorkingDay,\n previousWorkingDay,\n shiftToWorkingDay,\n shiftToWorkingTime,\n computeResourceHistogram,\n renderResourceHistogramSVG,\n filterTasks,\n colorByField,\n applyColorByField,\n DEFAULT_PALETTE,\n DENSITY_PRESETS,\n levelResources,\n} from \"@ganttloom/gantt-core\";\n"],"mappings":"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","names":["useEffect","useRef","EMPTY_DEPENDENCIES","useRef","useEffect","options"]}