@jaeungkim/gantt-chart 0.3.1 → 0.4.0

package/dist/core/scheduling.d.ts

@@ -0,0 +1,104 @@
+import { Dayjs } from 'dayjs';
+import { WorkingCalendar } from './calendar';
+import { DependencyType, Task } from './types';
+/**
+ * How far a predecessor's move carries into its successors.
+ *
+ * - `off` - nothing propagates (the default; a chart behaves exactly as it did before)
+ * - `shift-on-overlap` - a successor is pushed later only when a link would otherwise be
+ *   broken, and is never pulled earlier
+ * - `maintain-gap` - a successor sits exactly at its earliest legal date, so it follows the
+ *   predecessor in both directions and the gap stays equal to the link's lag
+ */
+export type SchedulingPolicy = 'off' | 'shift-on-overlap' | 'maintain-gap';
+/** One dependency, with both ends resolved */
+export interface SchedulingLink {
+    predecessorId: string;
+    successorId: string;
+    type: DependencyType;
+    /** Signed, in the calendar's day unit */
+    lag: number;
+}
+/** Stable identity for a link - used to tag the rendered arrow */
+export declare function linkKey(link: SchedulingLink): string;
+export interface TaskGraph {
+    byId: Map<string, Task>;
+    links: SchedulingLink[];
+    /** successor id -> the links that constrain it */
+    incoming: Map<string, SchedulingLink[]>;
+    /** predecessor id -> the links it constrains */
+    outgoing: Map<string, SchedulingLink[]>;
+    /** Topological order, predecessors first. Excludes anything caught in a cycle. */
+    order: string[];
+    /** Ids that could not be ordered because they sit on a cycle (null when there is none) */
+    cycle: string[] | null;
+}
+/**
+ * Builds the dependency graph and topologically sorts it (Kahn).
+ *
+ * Links pointing at a task that is not in the data are dropped, and anything caught in a
+ * cycle is left out of `order` and reported in `cycle` - so every caller walks a finite,
+ * acyclic list no matter what the data says.
+ */
+export declare function buildTaskGraph(tasks: Task[]): TaskGraph;
+/**
+ * A dependency path from `fromId` to `toId`, or null when there is none.
+ * Walks successors, so the result reads predecessor-first.
+ */
+export declare function findPath(tasks: Task[], fromId: string, toId: string): string[] | null;
+/**
+ * Whether a new predecessor -> successor link can be added without closing a loop.
+ *
+ * Call this before writing a link into the data: a cycle that never gets created is a
+ * cycle the engine never has to work around. `cycle` is the offending chain, ready to
+ * put in an error message.
+ */
+export declare function canLink(tasks: Task[], predecessorId: string, successorId: string): {
+    ok: boolean;
+    cycle: string[] | null;
+};
+/** The instant a task starts (milestones are a single point at startDate) */
+export declare function taskStart(task: Task): Dayjs;
+/** The instant a task finishes (milestones are a single point at startDate) */
+export declare function taskEnd(task: Task): Dayjs;
+/** The predecessor end of a link: FS and FF hang off the finish, SS and SF off the start */
+export declare function linkSourceDate(link: SchedulingLink, predecessor: Task): Dayjs;
+/** The successor end of a link: FS and SS constrain the start, FF and SF the finish */
+export declare function linkTargetDate(link: SchedulingLink, successor: Task): Dayjs;
+/**
+ * How many days the successor must move for this link to hold.
+ *
+ * Positive means it has to move later, negative means it is sitting later than it needs
+ * to. Whole days in the calendar's unit, so applying it keeps every time of day intact.
+ */
+export declare function linkDelta(link: SchedulingLink, predecessor: Task, successor: Task, calendar: WorkingCalendar): number;
+/** Moves a task by whole days - both ends together, so its duration is untouched */
+export declare function shiftTask(task: Task, days: number, calendar: WorkingCalendar): Task;
+export interface ScheduleOptions {
+    policy?: SchedulingPolicy;
+    calendar?: WorkingCalendar;
+    /**
+     * The tasks that just moved. Only their successors are rescheduled, and the seeds
+     * themselves are left exactly where the caller put them.
+     * Omitted, the whole project is levelled.
+     */
+    seeds?: Iterable<string>;
+    /** Pins summary rows - with hierarchy on their dates come from their children */
+    hierarchy?: boolean;
+    /** Called with the ids caught in a dependency cycle; those tasks are left alone */
+    onCycle?: (taskIds: string[]) => void;
+}
+export interface ScheduleResult {
+    /** The same array instance when nothing moved, so callers can skip the update */
+    tasks: Task[];
+    movedIds: string[];
+    cycle: string[] | null;
+}
+/**
+ * Propagates a move through the dependency graph.
+ *
+ * One forward pass in topological order: each task is shifted by the largest delta its
+ * predecessors demand, then becomes the input for its own successors. Cycles are reported
+ * and skipped rather than followed, so this always terminates.
+ */
+export declare function scheduleTasks(tasks: Task[], options?: ScheduleOptions): ScheduleResult;

package/dist/core/tree.d.ts

@@ -0,0 +1,42 @@
+import { Task } from './types';
+/** The minimum a task needs for the tree math - TaskTransformed fits as-is */
+type TaskNode = Pick<Task, "id" | "parentId">;
+/**
+ * A normalized tree built from parentId
+ *
+ * Orphans (a parent id that is not in the data), self-references and cyclic chains all get
+ * their parent link cut and become roots. The parentOf/childIds that come out are therefore
+ * always acyclic, so the functions below - and the render - can walk up or down without
+ * risking an infinite loop.
+ */
+export interface TaskTree {
+    /** parent id -> child ids (in input order) */
+    childIds: Map<string, string[]>;
+    /** task id -> normalized parent id (null for a root, an orphan or a cycle) */
+    parentOf: Map<string, string | null>;
+    /** task id -> depth from the root */
+    depthOf: Map<string, number>;
+    /** Root ids, in input order - the sibling list childIds has no key for */
+    rootIds: string[];
+}
+export declare function buildTaskTree(tasks: TaskNode[]): TaskTree;
+/**
+ * The subtree's ids including the root itself (breadth first)
+ * An id that is not in the tree yields an empty array
+ */
+export declare function collectSubtreeIds(tasks: TaskNode[], rootId: string, tree?: TaskTree): string[];
+/**
+ * The tasks left after dropping any task with a collapsed ancestor
+ * Input order is preserved (row order is decided by the sequence sort)
+ */
+export declare function getVisibleTasks<T extends TaskNode>(tasks: T[], collapsedIds: Iterable<string>, tree?: TaskTree): T[];
+/**
+ * The tasks with every parent recomputed as a summary row
+ *
+ * Start and end always come from the children, never from what the data says
+ * (min(child start)..max(child end); a milestone child counts at its startDate alone).
+ * Deepest first, so a grandchild's move travels up through the parent and the grandparent.
+ * An explicit progress is left alone; only a missing one is rolled up from the children.
+ */
+export declare function rollUpTasks(tasks: Task[], tree?: TaskTree): Task[];
+export {};

package/dist/core/types.d.ts

@@ -0,0 +1,76 @@
+/**
+ * The task data model - the part of it the headless core owns.
+ *
+ * Everything here is plain data and pure functions: no React, no DOM, no pixels.
+ * `src/types/task.ts` re-exports these and adds the render-side types (bar geometry,
+ * arrow coordinates) on top.
+ */
+export type TaskType = 'task' | 'milestone';
+export type DependencyType = 'FS' | 'SS' | 'FF' | 'SF';
+export interface TaskDependency {
+    /** The predecessor's id - a task's `dependencies` list the tasks it waits on */
+    targetId: string;
+    type: DependencyType;
+    /**
+     * Signed delay between the two ends of the link, in days
+     *
+     * Positive is lag (wait this long after the predecessor), negative is lead (overlap).
+     * Counted in working days when the working-day calendar is on, calendar days otherwise.
+     */
+    lag?: number;
+}
+export interface Task {
+    id: string;
+    name: string;
+    startDate: string;
+    endDate: string;
+    parentId: string | null;
+    sequence: string;
+    /** Task kind - 'milestone' renders as a diamond at startDate (default 'task') */
+    type?: TaskType;
+    /** Progress 0-100 (%) - omitted means no progress display */
+    progress?: number;
+    /**
+     * Bar color - any CSS color value
+     *
+     * The progress fill and the hover shade are derived from it, so one value colors the
+     * whole bar. Omitted, the `--gantt-*` theme tokens decide as before.
+     */
+    color?: string;
+    /** Extra class name put on this task's bar and its task-list row */
+    className?: string;
+    /**
+     * Swimlane this task shares a row with
+     *
+     * Tasks with the same lane (inside the same group) are drawn side by side on one
+     * row; overlapping ones stack onto extra rows automatically. Omitted, the task
+     * gets a row of its own as before.
+     */
+    lane?: string;
+    dependencies?: TaskDependency[];
+    /** Blocks every gesture on this task - overrides the chart's `readOnly` prop */
+    readOnly?: boolean;
+    /** Allows/blocks moving this task - overrides both `readOnly` settings */
+    allowMove?: boolean;
+    /** Allows/blocks resizing this task - overrides both `readOnly` settings */
+    allowResize?: boolean;
+    /** Allows/blocks dragging this task's progress handle - overrides both `readOnly` settings */
+    allowProgressChange?: boolean;
+    /** Allows/blocks starting a dependency drag from this task - overrides both `readOnly` settings */
+    allowLinkCreate?: boolean;
+    /** Allows/blocks deleting a dependency this task owns - overrides both `readOnly` settings */
+    allowLinkDelete?: boolean;
+    /** Earliest date this task may be dragged to (ISO string) - overrides the chart's `minDate` */
+    minDate?: string;
+    /** Latest date this task may be dragged to (ISO string) - overrides the chart's `maxDate` */
+    maxDate?: string;
+    /** The scheduling engine never moves this task; it still constrains its successors */
+    manuallyScheduled?: boolean;
+    /** Planned start snapshot - drawn as a thin bar under the live one (UTC ISO string) */
+    baselineStart?: string;
+    /** Planned end snapshot (UTC ISO string) */
+    baselineEnd?: string;
+}
+export declare function isMilestoneTask(task: Pick<Task, 'type'>): boolean;
+/** Normalizes progress into the 0-100 range; null when the value is missing or invalid */
+export declare function normalizeProgress(progress: number | undefined): number | null;

package/dist/gantt-chart.css

@@ -1 +1 @@
-@import"https://fonts.googleapis.com/css2?family=Geist:wght@400;500;600&display=swap";:root{--font-sans: "Geist", -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif;--background: #fafafa;--foreground: #18181b;--muted: #f4f4f5;--muted-foreground: #71717a;--border: #e4e4e7;--border-subtle: rgba(0, 0, 0, .04);--bar-bg: #e4e4e7;--bar-bg-hover: #d4d4d8;--bar-text: #18181b;--bar-shadow: 0 1px 2px rgba(0, 0, 0, .05);--bar-shadow-hover: 0 4px 12px rgba(0, 0, 0, .1);--bar-shadow-drag: 0 8px 24px rgba(0, 0, 0, .15);--arrow: #a1a1aa;--accent: #3b82f6;--transition-fast: .15s ease;--transition-normal: .2s ease}.dark,[data-theme=dark]{--background: #09090b;--foreground: #fafafa;--muted: #18181b;--muted-foreground: #a1a1aa;--border: #27272a;--border-subtle: rgba(255, 255, 255, .04);--bar-bg: #27272a;--bar-bg-hover: #3f3f46;--bar-text: #fafafa;--bar-shadow: 0 1px 2px rgba(0, 0, 0, .2);--bar-shadow-hover: 0 4px 12px rgba(0, 0, 0, .3);--bar-shadow-drag: 0 8px 24px rgba(0, 0, 0, .4);--arrow: #71717a}.gantt-container{display:flex;flex-direction:column;overflow:hidden;background:var(--background);font-family:var(--font-sans);font-size:13px;line-height:1.5;color:var(--foreground);-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}.gantt-toolbar{flex-shrink:0;display:flex;align-items:center;justify-content:flex-end;padding:12px 16px;background:var(--background);border-bottom:1px solid var(--border)}.gantt-scale-selector{display:inline-flex}.gantt-scale-control{display:flex;gap:2px;padding:3px;background:var(--muted);border-radius:8px;border:1px solid var(--border)}.gantt-scale-button{position:relative;padding:6px 14px;font-family:inherit;font-size:12px;font-weight:500;color:var(--muted-foreground);background:transparent;border:none;border-radius:6px;cursor:pointer;transition:all var(--transition-fast);text-transform:capitalize}.gantt-scale-button:hover{color:var(--foreground)}.gantt-scale-button:focus-visible{outline:2px solid var(--accent);outline-offset:-2px}.gantt-scale-button[data-active=true]{color:var(--foreground);background:var(--background);box-shadow:0 1px 3px #00000014}.gantt-main{flex:1;min-height:0;overflow:hidden}.gantt-scroll-container{width:100%;height:100%;overflow:auto}.gantt-scroll-container::-webkit-scrollbar{width:10px;height:10px}.gantt-scroll-container::-webkit-scrollbar-track{background:transparent}.gantt-scroll-container::-webkit-scrollbar-thumb{background:var(--border);border-radius:5px;border:2px solid var(--background)}.gantt-scroll-container::-webkit-scrollbar-thumb:hover{background:var(--muted-foreground)}.gantt-scroll-container::-webkit-scrollbar-corner{background:transparent}.gantt-header-wrapper{position:sticky;top:0;z-index:30}.gantt-header{position:relative;background:var(--background);border-bottom:1px solid var(--border)}.gantt-header-content{display:flex;flex-direction:column}.gantt-top-header{position:relative;display:flex;height:44px;border-bottom:1px solid var(--border-subtle)}.gantt-top-groups{display:flex}.gantt-top-group{display:flex;align-items:center;padding:0 16px;font-size:13px;font-weight:600;letter-spacing:-.01em;background:var(--background);color:var(--foreground)}.gantt-top-group.sticky{position:sticky;left:0;z-index:1}.gantt-top-group-label{margin:0;padding:0;white-space:nowrap}.gantt-bottom-row{display:flex;height:28px;background:var(--muted)}.gantt-bottom-cell{display:flex;align-items:center;justify-content:center;font-size:11px;font-weight:500;color:var(--muted-foreground);letter-spacing:.01em}.gantt-content{position:relative;background:var(--background)}.gantt-rows{position:absolute;top:0;left:0;width:100%;height:100%;z-index:1;pointer-events:none}.gantt-task-row{position:absolute;top:0;left:0;display:flex;width:100%;align-items:center;border-bottom:1px solid var(--border-subtle);pointer-events:none}.gantt-dependency-arrows{position:absolute;top:0;left:0;width:100%;pointer-events:none;z-index:5}.gantt-dependency-arrow{stroke:var(--arrow);stroke-width:1.5;fill:none}.gantt-dependency-arrow-head{fill:var(--arrow);stroke:none}.gantt-task-bar{position:relative;z-index:10;display:flex;align-items:center;background:var(--bar-bg);border-radius:6px;-webkit-user-select:none;user-select:none;cursor:grab;box-shadow:var(--bar-shadow);transition:background var(--transition-fast),box-shadow var(--transition-normal)}.gantt-task-bar:before,.gantt-task-bar:after{content:"";position:absolute;top:50%;width:3px;height:12px;background:var(--muted-foreground);border-radius:2px;opacity:0;transform:translateY(-50%);transition:opacity var(--transition-fast)}.gantt-task-bar:before{left:4px}.gantt-task-bar:after{right:4px}.gantt-task-bar:hover{background:var(--bar-bg-hover);box-shadow:var(--bar-shadow-hover)}.gantt-task-bar:hover:before,.gantt-task-bar:hover:after{opacity:.5}.gantt-task-bar:active,.gantt-task-bar.dragging{cursor:grabbing;box-shadow:var(--bar-shadow-drag);z-index:100}.gantt-task-bar.dragging:before,.gantt-task-bar.dragging:after{opacity:.7}.gantt-task-name{flex:1;padding:0 14px;font-family:inherit;font-size:12px;font-weight:500;color:var(--bar-text);white-space:nowrap;overflow:hidden;text-overflow:ellipsis;pointer-events:none}.gantt-bar-tooltip{position:absolute;bottom:calc(100% + 8px);left:50%;transform:translate(-50%);z-index:200;padding:8px 12px;background:var(--foreground);color:var(--background);border-radius:6px;font-family:inherit;font-size:11px;font-weight:500;white-space:nowrap;box-shadow:0 4px 16px #00000026;pointer-events:none;animation:tooltipFadeIn var(--transition-fast) ease-out}@keyframes tooltipFadeIn{0%{opacity:0;transform:translate(-50%) translateY(4px)}to{opacity:1;transform:translate(-50%) translateY(0)}}.gantt-bar-tooltip:after{content:"";position:absolute;top:100%;left:50%;transform:translate(-50%);border:5px solid transparent;border-top-color:var(--foreground)}@media (max-width: 768px){.gantt-toolbar{padding:8px 12px}.gantt-scale-button{padding:5px 10px;font-size:11px}.gantt-top-group{font-size:12px;padding:0 12px}.gantt-bottom-cell{font-size:10px}.gantt-task-name{font-size:11px;padding:0 10px}}
+.gantt-container{--gantt-font-sans: -apple-system, BlinkMacSystemFont, "Segoe UI", "Geist", system-ui, sans-serif;--gantt-background: #fafafa;--gantt-foreground: #18181b;--gantt-muted: #f4f4f5;--gantt-muted-foreground: #71717a;--gantt-border: #e4e4e7;--gantt-border-subtle: rgba(0, 0, 0, .04);--gantt-bar-bg: #e4e4e7;--gantt-bar-bg-hover: #d4d4d8;--gantt-bar-text: #18181b;--gantt-bar-shadow: 0 1px 2px rgba(0, 0, 0, .05);--gantt-bar-shadow-hover: 0 4px 12px rgba(0, 0, 0, .1);--gantt-bar-shadow-drag: 0 8px 24px rgba(0, 0, 0, .15);--gantt-arrow: #a1a1aa;--gantt-accent: #3b82f6;--gantt-today-marker: #f43f5e;--gantt-marker: #6366f1;--gantt-marker-warning: #f59e0b;--gantt-marker-label: #ffffff;--gantt-band-bg: rgba(99, 102, 241, .1);--gantt-milestone-bg: #52525b;--gantt-milestone-bg-hover: #3f3f46;--gantt-critical: #dc2626;--gantt-critical-bg: #fecaca;--gantt-critical-bg-hover: #fca5a5;--gantt-critical-text: #7f1d1d;--gantt-baseline-bg: #a1a1aa;--gantt-progress-bg: #a1a1aa;--gantt-progress-handle: #52525b;--gantt-non-working-bg: rgba(0, 0, 0, .035);--gantt-duration-fast: .15s;--gantt-transition-fast: .15s ease;--gantt-transition-normal: .2s ease}.gantt-container.dark,.gantt-container[data-theme=dark]{--gantt-background: #09090b;--gantt-foreground: #fafafa;--gantt-muted: #18181b;--gantt-muted-foreground: #a1a1aa;--gantt-border: #27272a;--gantt-border-subtle: rgba(255, 255, 255, .04);--gantt-bar-bg: #27272a;--gantt-bar-bg-hover: #3f3f46;--gantt-bar-text: #fafafa;--gantt-bar-shadow: 0 1px 2px rgba(0, 0, 0, .2);--gantt-bar-shadow-hover: 0 4px 12px rgba(0, 0, 0, .3);--gantt-bar-shadow-drag: 0 8px 24px rgba(0, 0, 0, .4);--gantt-arrow: #71717a;--gantt-today-marker: #fb7185;--gantt-marker: #818cf8;--gantt-marker-warning: #fbbf24;--gantt-marker-label: #18181b;--gantt-band-bg: rgba(129, 140, 248, .16);--gantt-milestone-bg: #d4d4d8;--gantt-milestone-bg-hover: #e4e4e7;--gantt-critical: #f87171;--gantt-critical-bg: #7f1d1d;--gantt-critical-bg-hover: #991b1b;--gantt-critical-text: #fee2e2;--gantt-baseline-bg: #71717a;--gantt-progress-bg: #52525b;--gantt-progress-handle: #a1a1aa;--gantt-non-working-bg: rgba(255, 255, 255, .03)}@media(prefers-color-scheme:dark){.gantt-container:not(.light):not([data-theme=light]){--gantt-background: #09090b;--gantt-foreground: #fafafa;--gantt-muted: #18181b;--gantt-muted-foreground: #a1a1aa;--gantt-border: #27272a;--gantt-border-subtle: rgba(255, 255, 255, .04);--gantt-bar-bg: #27272a;--gantt-bar-bg-hover: #3f3f46;--gantt-bar-text: #fafafa;--gantt-bar-shadow: 0 1px 2px rgba(0, 0, 0, .2);--gantt-bar-shadow-hover: 0 4px 12px rgba(0, 0, 0, .3);--gantt-bar-shadow-drag: 0 8px 24px rgba(0, 0, 0, .4);--gantt-arrow: #71717a;--gantt-today-marker: #fb7185;--gantt-marker: #818cf8;--gantt-marker-warning: #fbbf24;--gantt-marker-label: #18181b;--gantt-band-bg: rgba(129, 140, 248, .16);--gantt-milestone-bg: #d4d4d8;--gantt-milestone-bg-hover: #e4e4e7;--gantt-critical: #f87171;--gantt-critical-bg: #7f1d1d;--gantt-critical-bg-hover: #991b1b;--gantt-critical-text: #fee2e2;--gantt-baseline-bg: #71717a;--gantt-progress-bg: #52525b;--gantt-progress-handle: #a1a1aa;--gantt-non-working-bg: rgba(255, 255, 255, .03)}}.gantt-container,.gantt-container *,.gantt-container *:before,.gantt-container *:after{box-sizing:border-box}.gantt-container{display:flex;flex-direction:column;overflow:hidden;background:var(--gantt-background);font-family:var(--gantt-font-sans);font-size:13px;line-height:1.5;color:var(--gantt-foreground);-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}.gantt-container:focus{outline:none}.gantt-toolbar{flex-shrink:0;display:flex;align-items:center;justify-content:flex-end;padding:12px 16px;background:var(--gantt-background);border-bottom:1px solid var(--gantt-border)}.gantt-grid-toggle{margin-right:auto;display:inline-flex;align-items:center;justify-content:center;width:30px;height:30px;padding:0;color:var(--gantt-muted-foreground);background:transparent;border:1px solid var(--gantt-border);border-radius:6px;cursor:pointer;transition:color var(--gantt-transition-fast),background var(--gantt-transition-fast)}.gantt-grid-toggle:hover{color:var(--gantt-foreground);background:var(--gantt-muted)}.gantt-grid-toggle:focus-visible{outline:2px solid var(--gantt-accent);outline-offset:-2px}.gantt-grid-toggle svg{width:16px;height:16px;fill:none;stroke:currentColor;stroke-width:1.3}.gantt-grid-toggle[aria-expanded=true] svg rect{fill:var(--gantt-muted)}.gantt-scale-selector{display:inline-flex}.gantt-scale-control{display:flex;gap:2px;padding:3px;background:var(--gantt-muted);border-radius:8px;border:1px solid var(--gantt-border)}.gantt-scale-button{position:relative;padding:6px 14px;font-family:inherit;font-size:12px;font-weight:500;color:var(--gantt-muted-foreground);background:transparent;border:none;border-radius:6px;cursor:pointer;transition:all var(--gantt-transition-fast);text-transform:capitalize}.gantt-scale-button:hover{color:var(--gantt-foreground)}.gantt-scale-button:focus-visible{outline:2px solid var(--gantt-accent);outline-offset:-2px}.gantt-scale-button[data-active=true]{color:var(--gantt-foreground);background:var(--gantt-background);box-shadow:0 1px 3px #00000014}.gantt-main{position:relative;flex:1;min-height:0;overflow:hidden}.gantt-scroll-container{position:relative;width:100%;height:100%;overflow:auto}.gantt-body{display:flex;align-items:stretch;width:max-content;min-width:100%}.gantt-timeline{position:relative;flex:none}.gantt-grid{position:sticky;left:0;z-index:50;flex:none;background:var(--gantt-background);border-right:1px solid var(--gantt-border)}.gantt-grid-header{position:sticky;top:0;z-index:1;display:flex;align-items:flex-end;padding-bottom:6px;overflow:hidden;background:var(--gantt-background);border-bottom:1px solid var(--gantt-border)}.gantt-grid-header-cell{padding:0 10px;font-size:11px;font-weight:600;letter-spacing:.02em;text-transform:uppercase;color:var(--gantt-muted-foreground);white-space:nowrap;overflow:hidden;text-overflow:ellipsis}.gantt-grid-body{position:relative}.gantt-grid-row{position:absolute;top:0;left:0;display:flex;width:100%;align-items:center;overflow:hidden;border-bottom:1px solid var(--gantt-border-subtle)}.gantt-grid-row:hover{background:var(--gantt-muted)}.gantt-grid-row.summary{font-weight:600}.gantt-grid-row.selected{background:var(--gantt-muted);box-shadow:inset 2px 0 0 var(--gantt-accent)}.gantt-grid-row.draggable{cursor:grab}.gantt-grid.row-dragging,.gantt-grid.row-dragging .gantt-grid-row{cursor:grabbing}.gantt-grid-row.dragging{opacity:.45}.gantt-grid-row.drop-into{background:color-mix(in srgb,var(--gantt-accent) 14%,transparent);box-shadow:inset 0 0 0 1px var(--gantt-accent)}.gantt-grid-row.drop-into.invalid,.gantt-grid.row-dragging .gantt-grid-row.drop-into.invalid{background:color-mix(in srgb,var(--gantt-today-marker) 14%,transparent);box-shadow:inset 0 0 0 1px var(--gantt-today-marker);cursor:no-drop}.gantt-grid-drop-line{position:absolute;left:0;right:0;height:2px;margin-top:-1px;background:var(--gantt-accent);pointer-events:none}.gantt-grid-drop-line:before{content:"";position:absolute;top:-3px;left:0;width:8px;height:8px;border-radius:50%;background:inherit}.gantt-grid-drop-line.invalid{background:var(--gantt-today-marker)}.gantt-grid-cell{display:flex;align-items:center;min-width:0;padding:0 10px;font-size:12px;color:var(--gantt-foreground)}.gantt-grid-cell+.gantt-grid-cell{color:var(--gantt-muted-foreground)}.gantt-grid-cell-text{min-width:0;white-space:nowrap;overflow:hidden;text-overflow:ellipsis}.gantt-grid-indent{flex:none}.gantt-grid-expander{flex:none;display:inline-flex;align-items:center;justify-content:center;width:16px;height:16px;margin-right:4px;padding:0;color:var(--gantt-muted-foreground);background:transparent;border:none;border-radius:3px;cursor:pointer}.gantt-grid-expander:hover{color:var(--gantt-foreground);background:var(--gantt-border)}.gantt-grid-expander:focus-visible{outline:2px solid var(--gantt-accent);outline-offset:-2px}.gantt-grid-expander svg{width:12px;height:12px;fill:none;stroke:currentColor;stroke-width:1.6;stroke-linecap:round;stroke-linejoin:round;transition:transform var(--gantt-transition-fast)}.gantt-grid-expander.open svg{transform:rotate(90deg)}.gantt-grid-expander-spacer{flex:none;width:20px}.gantt-grid-splitter{position:absolute;top:0;bottom:0;z-index:60;width:5px;cursor:col-resize;touch-action:none;-webkit-user-select:none;user-select:none}.gantt-grid-splitter:hover,.gantt-grid-splitter:focus-visible{background:var(--gantt-accent);opacity:.5;outline:none}.gantt-drag-guides{position:absolute;top:0;bottom:0;left:0;z-index:40;pointer-events:none}.gantt-drag-guide{position:absolute;top:0;bottom:0;width:1px;background:var(--gantt-accent);opacity:.9}.gantt-drag-guide-label{position:absolute;top:6px;left:0;transform:translate(-50%);padding:3px 7px;background:var(--gantt-accent);color:#fff;border-radius:4px;font-family:inherit;font-size:11px;font-weight:500;white-space:nowrap}.gantt-scroll-container{scrollbar-width:thin;scrollbar-color:var(--gantt-border) transparent}.gantt-scroll-container::-webkit-scrollbar{width:10px;height:10px}.gantt-scroll-container::-webkit-scrollbar-track{background:transparent}.gantt-scroll-container::-webkit-scrollbar-thumb{background:var(--gantt-border);border-radius:5px;border:2px solid var(--gantt-background)}.gantt-scroll-container::-webkit-scrollbar-thumb:hover{background:var(--gantt-muted-foreground)}.gantt-scroll-container::-webkit-scrollbar-corner{background:transparent}.gantt-header-wrapper{position:sticky;top:0;z-index:30}.gantt-header{position:relative;background:var(--gantt-background);border-bottom:1px solid var(--gantt-border)}.gantt-header-content{display:flex;flex-direction:column}.gantt-top-header{position:relative;display:flex;height:44px;border-bottom:1px solid var(--gantt-border-subtle)}.gantt-top-groups{display:flex}.gantt-top-group{--top-group-inset: 16px;display:flex;align-items:center;padding:0 var(--top-group-inset);font-size:13px;font-weight:600;letter-spacing:-.01em;background:var(--gantt-background);color:var(--gantt-foreground)}.gantt-top-group-label{position:sticky;left:var(--top-group-inset);margin:0;padding:0;white-space:nowrap}.gantt-bottom-row{display:flex;height:28px;background:var(--gantt-muted)}.gantt-bottom-cell{display:flex;align-items:center;justify-content:center;font-size:11px;font-weight:500;color:var(--gantt-muted-foreground);letter-spacing:.01em}.gantt-content{position:relative;background:var(--gantt-background)}.gantt-non-working-layer{position:absolute;top:0;left:0;width:100%;height:100%;pointer-events:none;z-index:0}.gantt-non-working-range{position:absolute;top:0;bottom:0;background:var(--gantt-non-working-bg)}.gantt-rows{position:absolute;top:0;left:0;width:100%;height:100%;z-index:0;pointer-events:none}.gantt-task-row{position:absolute;top:0;left:0;display:flex;width:100%;align-items:center;border-bottom:1px solid var(--gantt-border-subtle);pointer-events:none}.gantt-range-band-layer{position:absolute;top:0;left:0;width:100%;height:100%;pointer-events:none;z-index:0}.gantt-range-band{position:absolute;top:0;bottom:0;background:var(--gantt-band-color, var(--gantt-band-bg))}.gantt-range-band-label{position:absolute;top:2px;left:4px;font-size:10px;font-weight:600;color:var(--gantt-muted-foreground);white-space:nowrap}.gantt-marker{position:absolute;top:0;bottom:0;width:2px;margin-left:-1px;background:var(--gantt-marker-color, var(--gantt-marker));pointer-events:none;z-index:2}.gantt-marker[data-warning=true]{--gantt-marker-color: var(--gantt-marker-warning)}.gantt-marker-label{position:absolute;top:2px;left:3px;padding:1px 5px;font-size:10px;font-weight:600;line-height:1.4;color:var(--gantt-marker-label);background:var(--gantt-marker-color, var(--gantt-marker));border-radius:3px;white-space:nowrap}.gantt-today-marker{position:absolute;top:0;bottom:0;width:2px;margin-left:-1px;background:var(--gantt-today-marker);opacity:.7;pointer-events:none;z-index:2}.gantt-dependency-arrows{position:absolute;top:0;left:0;width:100%;pointer-events:none;z-index:0}.gantt-dependency-arrows.linking{z-index:150}.gantt-dependency-arrow{stroke:var(--gantt-arrow);stroke-width:1.5;fill:none}.gantt-dependency-arrow.selected{stroke:var(--gantt-accent);stroke-width:2.5}.gantt-dependency-arrow-head{fill:var(--gantt-arrow);stroke:none}.gantt-dependency-hit{stroke:transparent;stroke-width:12;fill:none;cursor:pointer;pointer-events:stroke}.gantt-dependency-hit:hover+.gantt-dependency-arrow{stroke:var(--gantt-accent)}.gantt-dependency-delete{cursor:pointer;pointer-events:auto}.gantt-dependency-delete circle{fill:var(--gantt-accent)}.gantt-dependency-delete path{stroke:#fff;stroke-width:1.6;stroke-linecap:round}.gantt-link-handle{position:absolute;top:50%;width:10px;height:10px;background:var(--gantt-background);border:2px solid var(--gantt-accent);border-radius:50%;transform:translateY(-50%);opacity:0;cursor:crosshair;touch-action:none;pointer-events:none;transition:opacity var(--gantt-transition-fast)}.gantt-link-handle.start{left:-14px}.gantt-link-handle.end{right:-14px}.gantt-milestone .gantt-link-handle.start{left:-9px}.gantt-milestone .gantt-link-handle.end{left:15px;right:auto}.gantt-task-bar:hover .gantt-link-handle,.gantt-milestone:hover .gantt-link-handle,.gantt-task-bar.selected .gantt-link-handle,.gantt-milestone.selected .gantt-link-handle{opacity:1;pointer-events:auto}.gantt-task-bar.link-target,.gantt-milestone.link-target .gantt-milestone-diamond{outline:2px solid var(--gantt-accent);outline-offset:2px}.gantt-task-bar.link-target.invalid,.gantt-milestone.link-target.invalid .gantt-milestone-diamond{outline-color:var(--gantt-today-marker)}.gantt-link-preview-line{stroke:var(--gantt-accent);stroke-width:2;stroke-dasharray:4 3;fill:none}.gantt-link-preview-line.invalid{stroke:var(--gantt-today-marker)}.gantt-link-preview-origin{fill:var(--gantt-accent)}.gantt-link-preview-reason{fill:var(--gantt-today-marker);font-family:inherit;font-size:11px;font-weight:500;paint-order:stroke;stroke:var(--gantt-background);stroke-width:3px;stroke-linejoin:round}.gantt-content.drawable{cursor:crosshair}.gantt-draw-ghost{position:absolute;top:0;left:0;height:19px;margin-top:9px;background:var(--gantt-accent);opacity:.35;border:1px dashed var(--gantt-accent);border-radius:6px;pointer-events:none;z-index:5}.gantt-task-bar{position:relative;touch-action:pan-x pan-y;z-index:10;display:flex;align-items:center;background:var(--gantt-bar-color, var(--gantt-bar-bg));border-radius:6px;-webkit-user-select:none;user-select:none;cursor:grab;box-shadow:var(--gantt-bar-shadow);transition:background var(--gantt-transition-fast),box-shadow var(--gantt-transition-normal)}.gantt-task-bar:before,.gantt-task-bar:after{content:"";position:absolute;top:50%;width:3px;height:12px;background:var(--gantt-muted-foreground);border-radius:2px;opacity:0;transform:translateY(-50%);transition:opacity var(--gantt-transition-fast)}.gantt-task-bar:before{left:4px}.gantt-task-bar:after{right:4px}.gantt-task-bar:hover{background:var(--gantt-bar-color-hover, var(--gantt-bar-bg-hover));box-shadow:var(--gantt-bar-shadow-hover)}.gantt-task-bar:hover:before,.gantt-task-bar:hover:after{opacity:.5}.gantt-task-bar:active,.gantt-task-bar.dragging{cursor:grabbing;box-shadow:var(--gantt-bar-shadow-drag);z-index:100}.gantt-task-bar.dragging:before,.gantt-task-bar.dragging:after{opacity:.7}.gantt-task-bar.summary{background:var(--gantt-bar-color, var(--gantt-milestone-bg));border-radius:3px}.gantt-task-bar.summary:hover{background:var(--gantt-bar-color-hover, var(--gantt-milestone-bg-hover))}.gantt-task-bar.summary .gantt-task-name{color:var(--gantt-background)}.gantt-task-bar.summary .gantt-task-name.outside{color:var(--gantt-foreground)}.gantt-task-bar.summary .gantt-progress-fill{background:var(--gantt-progress-color, var(--gantt-foreground));opacity:.35;border-radius:3px 0 0 3px}.gantt-task-bar.summary:before,.gantt-task-bar.summary:after,.gantt-task-bar.summary:hover:before,.gantt-task-bar.summary:hover:after{opacity:0}.gantt-baseline{position:absolute;bottom:3px;height:4px;background:var(--gantt-baseline-bg);border-radius:2px;opacity:.65;pointer-events:none}.gantt-baseline.milestone{width:8px;height:8px;bottom:1px;margin-left:-4px;border-radius:1px;transform:rotate(45deg)}.gantt-task-bar.critical{background:var(--gantt-critical-bg)}.gantt-task-bar.critical:hover{background:var(--gantt-critical-bg-hover)}.gantt-task-bar.critical .gantt-task-name{color:var(--gantt-critical-text)}.gantt-task-bar.critical .gantt-task-name.outside{color:var(--gantt-foreground)}.gantt-task-bar.critical .gantt-progress-fill{background:var(--gantt-critical);opacity:.45}.gantt-milestone.critical .gantt-milestone-diamond{background:var(--gantt-critical)}.gantt-dependency-arrow.critical{stroke:var(--gantt-critical);stroke-width:2}.gantt-dependency-arrow-head.critical{fill:var(--gantt-critical)}.gantt-task-bar.selected,.gantt-milestone.selected .gantt-milestone-diamond{outline:2px solid var(--gantt-accent);outline-offset:2px}.gantt-task-bar.reverting,.gantt-milestone.reverting{transition:transform var(--gantt-transition-normal),width var(--gantt-transition-normal),background var(--gantt-transition-fast),box-shadow var(--gantt-transition-normal)}.gantt-task-bar.reverting .gantt-progress-fill,.gantt-task-bar.reverting .gantt-progress-handle{transition:width var(--gantt-transition-normal),left var(--gantt-transition-normal)}.gantt-task-bar.compact:before,.gantt-task-bar.compact:after,.gantt-task-bar.compact:hover:before,.gantt-task-bar.compact:hover:after,.gantt-task-bar.compact.dragging:before,.gantt-task-bar.compact.dragging:after,.gantt-task-bar.no-resize:before,.gantt-task-bar.no-resize:after,.gantt-task-bar.no-resize:hover:before,.gantt-task-bar.no-resize:hover:after,.gantt-task-bar.no-resize.dragging:before,.gantt-task-bar.no-resize.dragging:after{opacity:0}.gantt-progress-fill{position:absolute;top:0;left:0;bottom:0;background:var(--gantt-progress-color, var(--gantt-progress-bg));border-radius:6px 0 0 6px;pointer-events:none}.gantt-progress-handle{position:absolute;top:50%;width:10px;height:10px;margin-left:-5px;background:var(--gantt-background);border:2px solid var(--gantt-progress-handle);border-radius:50%;transform:translateY(-50%);opacity:0;cursor:ew-resize;transition:opacity var(--gantt-transition-fast)}.gantt-task-bar:hover .gantt-progress-handle,.gantt-progress-handle.dragging{opacity:1}@media(hover:none){.gantt-progress-handle{opacity:1}.gantt-progress-handle:before{content:"";position:absolute;top:-17px;right:-17px;bottom:-17px;left:-17px}}.gantt-task-name{position:relative;flex:1;padding:0 14px;font-family:inherit;font-size:12px;font-weight:500;color:var(--gantt-bar-text);white-space:nowrap;overflow:hidden;text-overflow:ellipsis;pointer-events:none}.gantt-task-name.outside{position:absolute;left:100%;flex:none;padding:0 0 0 8px;color:var(--gantt-foreground);overflow:visible}.gantt-milestone{position:relative;touch-action:pan-x pan-y;z-index:10;display:flex;align-items:center;gap:10px;-webkit-user-select:none;user-select:none;cursor:grab}.gantt-milestone-diamond{flex-shrink:0;width:16px;height:16px;background:var(--gantt-bar-color, var(--gantt-milestone-bg));border-radius:3px;transform:rotate(45deg);box-shadow:var(--gantt-bar-shadow);transition:background var(--gantt-transition-fast),box-shadow var(--gantt-transition-normal)}.gantt-milestone:hover .gantt-milestone-diamond{background:var(--gantt-bar-color-hover, var(--gantt-milestone-bg-hover));box-shadow:var(--gantt-bar-shadow-hover)}.gantt-milestone:active,.gantt-milestone.dragging{cursor:grabbing;z-index:100}.gantt-milestone.dragging .gantt-milestone-diamond{box-shadow:var(--gantt-bar-shadow-drag)}.gantt-milestone-name{font-family:inherit;font-size:12px;font-weight:500;color:var(--gantt-foreground);white-space:nowrap;pointer-events:none}.gantt-bar-tooltip{position:absolute;top:calc(100% + 8px);left:50%;transform:translate(-50%);z-index:200;padding:8px 12px;background:var(--gantt-foreground);color:var(--gantt-background);border-radius:6px;font-family:inherit;font-size:11px;font-weight:500;white-space:nowrap;box-shadow:0 4px 16px #00000026;pointer-events:none;animation:tooltipFadeIn var(--gantt-duration-fast) ease-out}@keyframes tooltipFadeIn{0%{opacity:0;transform:translate(-50%) translateY(-4px)}to{opacity:1;transform:translate(-50%) translateY(0)}}.gantt-bar-tooltip-detail{display:flex;flex-direction:column;gap:2px;text-align:left}.gantt-tooltip-name{font-weight:600}.gantt-tooltip-meta{opacity:.75}.gantt-bar-tooltip:after{content:"";position:absolute;bottom:100%;left:50%;transform:translate(-50%);border:5px solid transparent;border-bottom-color:var(--gantt-foreground)}@media(max-width:768px){.gantt-toolbar{padding:8px 12px}.gantt-scale-button{padding:5px 10px;font-size:11px}.gantt-top-group{--top-group-inset: 12px;font-size:12px}.gantt-bottom-cell{font-size:10px}.gantt-task-name{font-size:11px;padding:0 10px}}.gantt-grid-row.group,.gantt-task-row.group{background:var(--gantt-muted);font-weight:600}.gantt-grid-row.group .gantt-grid-cell{gap:6px}.gantt-group-label{position:sticky;left:0;display:flex;align-items:center;gap:6px;height:100%;padding:0 10px;pointer-events:auto;font-weight:600;white-space:nowrap}.gantt-grid-group-count{flex:none;padding:0 6px;border-radius:999px;background:var(--gantt-border);color:var(--gantt-muted-foreground);font-size:10px;font-weight:600;line-height:16px}.gantt-sr-only{position:absolute;width:1px;height:1px;margin:-1px;padding:0;overflow:hidden;border:0;clip:rect(0 0 0 0);clip-path:inset(50%);white-space:nowrap}.gantt-container [data-gantt-cell]:focus-visible{outline:2px solid var(--gantt-accent);outline-offset:1px}@media(prefers-reduced-motion:reduce){.gantt-container *,.gantt-container *:before,.gantt-container *:after{transition-duration:.01ms!important;animation-duration:.01ms!important;animation-iteration-count:1!important;scroll-behavior:auto!important}}

package/dist/hooks/useGanttBarDrag.d.ts

@@ -0,0 +1,35 @@
+import { Dayjs } from 'dayjs';
+import { GanttBeforeChangeHandler, GanttDragMode, GanttScheduling } from '../types/gantt';
+import { GanttInteractionConfig, Task, TaskTransformed } from '../types/task';
+export type DragMode = GanttDragMode;
+export interface GanttBarDragOptions {
+    onTasksChange?: (updatedTasks: Task[]) => void;
+    onBeforeTaskChange?: GanttBeforeChangeHandler;
+    /** Scroll the timeline when the drag reaches a viewport edge (default true) */
+    autoScroll?: boolean;
+}
+/** The dates the drag is proposing for the tasks it moves directly */
+type DraggedDates = Map<string, {
+    start: Dayjs;
+    end: Dayjs;
+}>;
+/** The task array with the dragged tasks' proposed dates written in */
+export declare function applyDraggedDates(rawTasks: Task[], dragged: DraggedDates): Task[];
+/**
+ * Runs the scheduling engine for the tasks the drag is moving.
+ * The dragged tasks are the seeds, so only what they reach is rescheduled and the bar
+ * under the pointer stays exactly where the pointer put it.
+ */
+export declare function reschedule(rawTasks: Task[], dragged: DraggedDates, scheduling: GanttScheduling): import('core').ScheduleResult;
+/**
+ * Hook providing the Gantt bar drag behavior
+ *
+ * `autoScroll` (default on) scrolls the timeline when the drag reaches a viewport edge,
+ * faster the closer the pointer gets, and stops on drop or cancel.
+ */
+export declare function useGanttBarDrag(task: TaskTransformed, options?: GanttBarDragOptions, interaction?: GanttInteractionConfig, scheduling?: GanttScheduling): {
+    onPointerDown: import('react').PointerEventHandler<HTMLDivElement>;
+    dragMode: GanttDragMode | null;
+    consumeDragClick: () => boolean;
+};
+export {};

package/dist/hooks/useGanttDrawCreate.d.ts

@@ -0,0 +1,31 @@
+/** The task the user drew, handed to `onTaskCreate` - nothing is committed by the chart */
+export interface GanttTaskDraft {
+    /** UTC ISO string, snapped to the current scale */
+    startDate: string;
+    endDate: string;
+    /** Id of the task whose row the range was drawn on, null when the row has none */
+    rowTaskId: string | null;
+}
+/** The ghost bar drawn while the pointer is down (px, timeline content coordinates) */
+interface DrawGhost {
+    leftPx: number;
+    widthPx: number;
+    topPx: number;
+}
+interface UseGanttDrawCreateParams {
+    enabled: boolean;
+    /** Rows on screen, in order - the row under the pointer names the task it belongs to */
+    rowIds: (string | null)[];
+    onTaskCreate?: (draft: GanttTaskDraft) => void;
+}
+/**
+ * Drawing a new task on the empty part of a row
+ *
+ * The chart never adds the task itself: the drawn range is snapped to the current scale
+ * and handed to `onTaskCreate`, and the host decides what (if anything) to do with it.
+ */
+export declare function useGanttDrawCreate({ enabled, rowIds, onTaskCreate, }: UseGanttDrawCreateParams): {
+    onDrawPointerDown: (e: React.PointerEvent<HTMLDivElement>) => void;
+    ghost: DrawGhost | null;
+};
+export {};

package/dist/hooks/useGanttExportApi.d.ts

@@ -0,0 +1,30 @@
+import { RefObject } from 'react';
+import { GanttBottomRowCell, GanttScaleKey } from '../types/gantt';
+import { GanttExportOptions } from '../utils/pngExport';
+/** Imperative export API */
+export interface GanttExportApi {
+    /**
+     * Renders the whole chart to a PNG and resolves with the blob
+     *
+     * No download is triggered - what to do with the blob is the caller's choice
+     * (save it, upload it, drop it into a PDF).
+     */
+    exportToPng: (options?: GanttExportOptions) => Promise<Blob>;
+}
+interface UseGanttExportApiParams {
+    scrollRef: RefObject<HTMLDivElement | null>;
+    bottomRowCells: GanttBottomRowCell[];
+    selectedScale: GanttScaleKey;
+    taskCount: number;
+    totalWidth: number;
+}
+/**
+ * Imperative PNG export
+ *
+ * Rows, arrows and header cells are all virtualized, so the live DOM only ever
+ * holds the visible slice. The export turns virtualization off, waits for the
+ * full chart to render, captures it, and puts the chart back exactly as it was
+ * - scroll position included - whether the capture succeeded or threw.
+ */
+export declare function useGanttExportApi({ scrollRef, bottomRowCells, selectedScale, taskCount, totalWidth, }: UseGanttExportApiParams): GanttExportApi;
+export {};

package/dist/hooks/useGanttHistoryApi.d.ts

@@ -0,0 +1,28 @@
+import { default as React } from 'react';
+import { Task } from '../types/task';
+/** Imperative undo/redo API */
+export interface GanttHistoryApi {
+    /** Reverts the newest gesture and fires `onTasksChange`. No-op with an empty stack. */
+    undo: () => void;
+    /** Replays the newest undone gesture and fires `onTasksChange`. No-op with an empty stack. */
+    redo: () => void;
+    /** Whether there is a gesture to undo */
+    canUndo: boolean;
+    /** Whether there is an undone gesture to redo */
+    canRedo: boolean;
+}
+/**
+ * Whether the key event landed in something the user is typing into, e.g. an input
+ * rendered by a custom task list cell
+ */
+export declare function isTextEntryTarget(target: unknown): boolean;
+/**
+ * Undo/redo for the chart: the imperative methods plus the keyboard shortcuts.
+ *
+ * The key handler is meant for the chart container, so it only ever sees events
+ * from inside the chart - the shortcut does nothing while the chart is not focused.
+ */
+export declare function useGanttHistoryApi(onTasksChange?: (updatedTasks: Task[]) => void): {
+    historyApi: GanttHistoryApi;
+    onKeyDown: React.KeyboardEventHandler<HTMLElement>;
+};

package/dist/hooks/useGanttLinkDrag.d.ts

@@ -0,0 +1,31 @@
+import { DependencyType, GanttInteractionConfig, Task, TaskTransformed } from '../types/task';
+import { LinkAnchor } from '../utils/dependency';
+/** The link the user drew, handed to `onDependencyCreate` before anything is committed */
+export interface GanttDependencyChange {
+    /** Task the drag started on */
+    predecessorId: string;
+    /** Task the drag was dropped on - the one whose `dependencies` gains the entry */
+    successorId: string;
+    type: DependencyType;
+}
+interface UseGanttLinkDragParams {
+    task: TaskTransformed;
+    interaction?: GanttInteractionConfig;
+    onTasksChange?: (updatedTasks: Task[]) => void;
+    /** Returning false rejects the link */
+    onDependencyCreate?: (change: GanttDependencyChange) => boolean | void;
+}
+/**
+ * Dragging a dependency from one of a bar's connector dots to another bar
+ *
+ * The gesture's direction is the dependency's direction: the bar the drag starts on is
+ * the predecessor, the bar it lands on the successor. Which ends the two dots sit on
+ * decides the type (see `linkTypeFromAnchors`).
+ *
+ * The drop target is found with `elementFromPoint` rather than from the bar geometry, so
+ * virtualization, scrolling and the sticky task list pane all take care of themselves.
+ */
+export declare function useGanttLinkDrag({ task, interaction, onTasksChange, onDependencyCreate, }: UseGanttLinkDragParams): {
+    startLink: (anchor: LinkAnchor) => (e: React.PointerEvent<HTMLElement>) => void;
+};
+export {};

package/dist/hooks/useGanttProgressDrag.d.ts

@@ -0,0 +1,16 @@
+import { default as React } from 'react';
+import { GanttBeforeChangeHandler } from '../types/gantt';
+import { Task, TaskTransformed } from '../types/task';
+export interface GanttProgressDragOptions {
+    onTasksChange?: (updatedTasks: Task[]) => void;
+    onBeforeTaskChange?: GanttBeforeChangeHandler;
+}
+/**
+ * Progress handle drag hook
+ * Previews with a local value while dragging, commits to rawTasks on pointerup
+ */
+export declare function useGanttProgressDrag(task: TaskTransformed, barRef: React.RefObject<HTMLDivElement | null>, options?: GanttProgressDragOptions): {
+    onProgressPointerDown: React.PointerEventHandler<HTMLDivElement>;
+    progress: number | null;
+    isDraggingProgress: boolean;
+};

package/dist/hooks/useGanttRowDrag.d.ts

@@ -0,0 +1,33 @@
+import { RefObject } from 'react';
+import { GanttReorderChange } from '../types/gantt';
+import { Task } from '../types/task';
+import { RowDropRow, RowDropTarget } from '../utils/rowDrag';
+export interface RowDragState {
+    draggedId: string;
+    /** Where the drop would land - null while the pointer is nowhere useful */
+    target: RowDropTarget | null;
+}
+interface UseGanttRowDragParams {
+    /** The rows on screen, in row order */
+    rows: RowDropRow[];
+    /** The element the rows are positioned in - pointer Y is measured from its top */
+    bodyRef: RefObject<HTMLDivElement | null>;
+    enabled: boolean;
+    onReorder?: (change: GanttReorderChange) => void | boolean;
+    onTasksChange?: (updatedTasks: Task[]) => void;
+}
+/**
+ * Vertical drag of a grid row - reorders siblings and re-parents
+ *
+ * Deliberately separate from useGanttBarDrag: that one is horizontal and lives on the bars in
+ * the timeline pane, this one is vertical and lives on the rows in the grid pane, so neither
+ * gesture can start the other.
+ *
+ * Nothing is committed while the drop is illegal - the indicator says so during the drag and
+ * the pointerup does nothing.
+ */
+export declare function useGanttRowDrag({ rows, bodyRef, enabled, onReorder, onTasksChange, }: UseGanttRowDragParams): {
+    onRowPointerDown: import('react').PointerEventHandler<HTMLDivElement>;
+    dragState: RowDragState | null;
+};
+export {};

package/dist/hooks/useGanttScrollApi.d.ts

@@ -0,0 +1,63 @@
+import { Dayjs } from 'dayjs';
+import { RefObject } from 'react';
+import { GanttExportApi } from './useGanttExportApi';
+import { GanttHistoryApi } from './useGanttHistoryApi';
+import { GanttBottomRowCell, GanttScaleKey } from '../types/gantt';
+import { TaskTransformed } from '../types/task';
+/** Options for the scrollTo* methods */
+export interface GanttScrollOptions {
+    /** Whether to animate the scroll (default true) */
+    smooth?: boolean;
+    /** Where the target lands inside the viewport (default 'center') */
+    align?: "start" | "center";
+}
+/** A date pinned at a fixed distance from the timeline's visible left edge */
+export interface GanttZoomAnchor {
+    date: Dayjs;
+    /** px from the left edge of the timeline area (the task list pane excluded) */
+    viewportX: number;
+}
+/** Imperative scroll and zoom API */
+export interface GanttScrollApi {
+    /** Scroll horizontally to a given date */
+    scrollToDate: (date: string | Date | Dayjs, options?: GanttScrollOptions) => void;
+    /** Scroll horizontally to today */
+    scrollToToday: (options?: GanttScrollOptions) => void;
+    /** Scroll horizontally and vertically to a given task */
+    scrollToTask: (taskId: string, options?: GanttScrollOptions) => void;
+    /**
+     * Switch to the finest scale at which the whole project fits the viewport width
+     *
+     * Also scrolls the project into view. Does nothing while there are no tasks.
+     */
+    zoomToFit: () => void;
+    /** The scroll container DOM node (null when unavailable) */
+    getScrollElement: () => HTMLDivElement | null;
+}
+/** Imperative API exposed through the ref */
+export interface GanttHandle extends GanttScrollApi, GanttExportApi, GanttHistoryApi {
+}
+interface UseGanttScrollApiParams {
+    scrollRef: RefObject<HTMLDivElement | null>;
+    bottomRowCells: GanttBottomRowCell[];
+    transformedTasks: TaskTransformed[];
+    selectedScale: GanttScaleKey;
+    rowHeight: number;
+    /**
+     * How much width the pinned task list on the left covers (default 0)
+     *
+     * The timeline starts that far to the right, so centering has to measure against the
+     * narrowed viewport or the target lands behind the pane.
+     */
+    viewportInsetPx?: number;
+    /** Switches scale while keeping the anchor date where it is on screen */
+    zoomTo: (scale: GanttScaleKey, anchor: GanttZoomAnchor) => void;
+}
+/**
+ * Imperative scroll API
+ *
+ * Dates outside the timeline and unknown task ids are ignored silently - so that
+ * the common case of calling while data is still loading does not throw.
+ */
+export declare function useGanttScrollApi({ scrollRef, bottomRowCells, transformedTasks, selectedScale, rowHeight, viewportInsetPx, zoomTo, }: UseGanttScrollApiParams): GanttScrollApi;
+export {};

package/dist/hooks/useGanttSelectors.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Hook selecting the state and actions needed from the Gantt store
+ * Uses shallow comparison to avoid unnecessary re-renders
+ *
+ * dragOffsets/currentTask change on every drag frame and are deliberately not
+ * subscribed to here. (Components that need them subscribe individually - this keeps
+ * the whole chart from re-rendering every frame)
+ */
+export declare function useGanttSelectors(): {
+    rawTasks: import('..').Task[];
+    transformedTasks: import('..').TaskTransformed[];
+    bottomRowCells: import('../types/gantt').GanttBottomRowCell[];
+    selectedScale: import('..').GanttScaleKey;
+    selectedTaskId: string | null;
+    syncTasksFromProps: (rawTasks: import('..').Task[]) => void;
+    setHistoryLimit: (limit: number) => void;
+    setTransformedTasks: (tasks: import('..').TaskTransformed[]) => void;
+    setBottomRowCells: (cells: import('../types/gantt').GanttBottomRowCell[]) => void;
+    setSelectedScale: (scale: import('..').GanttScaleKey) => void;
+    setLocaleOptions: (options: import('../types/gantt').GanttLocaleOptions | undefined) => void;
+    clearAllDragOffsets: () => void;
+    getTotalWidth: () => number;
+};

package/dist/hooks/useGanttVirtualization.d.ts

@@ -0,0 +1,32 @@
+import { Virtualizer } from '@tanstack/react-virtual';
+import { RefObject } from 'react';
+import { GanttBottomRowCell } from '../types/gantt';
+interface UseGanttColumnVirtualizationParams {
+    bottomRowCells: GanttBottomRowCell[];
+    scrollRef: RefObject<HTMLDivElement | null>;
+}
+interface UseGanttColumnVirtualizationResult {
+    columnVirtualizer: Virtualizer<HTMLDivElement, Element>;
+    isBarVisible: (barLeft: number, barWidth: number) => boolean;
+}
+interface UseGanttVirtualizationParams extends UseGanttColumnVirtualizationParams {
+    /** Number of rows on screen - not the task count, since a lane can share one row */
+    rowCount: number;
+}
+interface UseGanttVirtualizationResult extends UseGanttColumnVirtualizationResult {
+    rowVirtualizer: Virtualizer<HTMLDivElement, Element>;
+}
+/**
+ * Column virtualization
+ *
+ * Split out so that rendering the header's bottom time cells and judging horizontal
+ * visibility use the same window - the header and the bars must not be culled by
+ * different criteria.
+ */
+export declare function useGanttColumnVirtualization({ bottomRowCells, scrollRef, }: UseGanttColumnVirtualizationParams): UseGanttColumnVirtualizationResult;
+/**
+ * Hook managing the Gantt chart's virtualization
+ * Sets up row and column virtualization and provides the visibility check
+ */
+export declare function useGanttVirtualization({ rowCount, bottomRowCells, scrollRef, }: UseGanttVirtualizationParams): UseGanttVirtualizationResult;
+export {};

package/dist/hooks/useResolvedTheme.d.ts

@@ -0,0 +1,15 @@
+import { GanttTheme } from '../types/gantt';
+interface UseResolvedThemeResult {
+    containerClassName: string;
+    dataTheme: 'light' | 'dark' | undefined;
+}
+/**
+ * Hook that resolves the theme and builds the matching class name and data attribute
+ *
+ * The 'system' theme is subscribed to with useSyncExternalStore - server rendering and
+ * the first hydration render use null (no theme class) and switch to the real system
+ * setting after hydration, so there is no hydration mismatch and no getting stuck on
+ * the wrong theme.
+ */
+export declare function useResolvedTheme(theme?: GanttTheme, baseClassName?: string): UseResolvedThemeResult;
+export {};