gantt-renderer 0.2.0 → 0.3.0

package/CHANGELOG.md

@@ -1,3 +1,17 @@
+# [0.3.0](https://github.com/doberkofler/gantt-renderer/compare/v0.2.0...v0.3.0) (2026-05-08)
+
+
+### Bug Fixes
+
+* correct link routing geometry and dependency layer rendering ([d00de8a](https://github.com/doberkofler/gantt-renderer/commit/d00de8a8b51d69b7b50ec4c6bf0ce6dd3657e1a8))
+* **interaction:** deep-clone input in update() to prevent drag mutations leaking to consumer data ([ce814a0](https://github.com/doberkofler/gantt-renderer/commit/ce814a02bb87230108635ae663f165497f522f7e)), closes [#patchTask](https://github.com/doberkofler/gantt-renderer/issues/patchTask)
+* **rendering:** offset multi-row link midpoint to avoid bar center slicing ([1fe09fa](https://github.com/doberkofler/gantt-renderer/commit/1fe09fa3d736cf948035c4f1619f398fa374464d))
+
+
+### Features
+
+* **interaction:** add progress bar drag with progressDragEnabled option ([77833b5](https://github.com/doberkofler/gantt-renderer/commit/77833b50b5984158bd9a2ab3ddcc744d05ccb18f))
+
 # [0.2.0](https://github.com/doberkofler/gantt-renderer/compare/v0.1.3...v0.2.0) (2026-05-07)
 
 

package/README.md

@@ -30,7 +30,7 @@ optimize timelines, resolve resource constraints, or perform planning logic itse
 
 ## Scope
 
-The library is designed as a core chart component (`src/gantt-chart/**/*`) that your product can
+The library is designed as a core chart component (`src/lib/**/*`) that your product can
 embed. Outer-page/demo concerns (export toolbars, fullscreen shell controls, demo-only control
 rows) are intentionally outside the core scope.
 

package/dist/index.d.mts

@@ -1,13 +1,13 @@
 import { z } from "zod";
 
-//#region src/gantt-chart/validation/schemas.d.ts
+//#region src/lib/validation/schemas.d.ts
 declare const LinkTypeSchema: z.ZodEnum<{
   FS: "FS";
   SS: "SS";
   FF: "FF";
   SF: "SF";
 }>;
-declare const TaskTypeSchema: z.ZodEnum<{
+declare const TaskKindSchema: z.ZodEnum<{
   task: "task";
   project: "project";
   milestone: "milestone";
@@ -25,21 +25,36 @@ declare const SpecialDaySchema: z.ZodObject<{
   label: z.ZodOptional<z.ZodString>;
   className: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
-declare const TaskSchema: z.ZodObject<{
+declare const TaskSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+  kind: z.ZodLiteral<"task">;
+  durationHours: z.ZodNumber;
+  percentComplete: z.ZodDefault<z.ZodNumber>;
   id: z.ZodNumber;
   text: z.ZodString;
   startDate: z.ZodString;
-  durationHours: z.ZodNumber;
   parent: z.ZodOptional<z.ZodNumber>;
+  color: z.ZodOptional<z.ZodString>;
+  data: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>, z.ZodObject<{
+  kind: z.ZodLiteral<"project">;
+  durationHours: z.ZodNumber;
   percentComplete: z.ZodDefault<z.ZodNumber>;
-  type: z.ZodDefault<z.ZodEnum<{
-    task: "task";
-    project: "project";
-    milestone: "milestone";
-  }>>;
   open: z.ZodDefault<z.ZodBoolean>;
+  id: z.ZodNumber;
+  text: z.ZodString;
+  startDate: z.ZodString;
+  parent: z.ZodOptional<z.ZodNumber>;
   color: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>;
+  data: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>, z.ZodObject<{
+  kind: z.ZodLiteral<"milestone">;
+  id: z.ZodNumber;
+  text: z.ZodString;
+  startDate: z.ZodString;
+  parent: z.ZodOptional<z.ZodNumber>;
+  color: z.ZodOptional<z.ZodString>;
+  data: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>], "kind">;
 declare const LinkSchema: z.ZodObject<{
   id: z.ZodNumber;
   source: z.ZodNumber;
@@ -50,23 +65,39 @@ declare const LinkSchema: z.ZodObject<{
     FF: "FF";
     SF: "SF";
   }>>;
+  data: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 }, z.core.$strip>;
 declare const GanttInputSchema: z.ZodObject<{
-  tasks: z.ZodArray<z.ZodObject<{
+  tasks: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"task">;
+    durationHours: z.ZodNumber;
+    percentComplete: z.ZodDefault<z.ZodNumber>;
     id: z.ZodNumber;
     text: z.ZodString;
     startDate: z.ZodString;
-    durationHours: z.ZodNumber;
     parent: z.ZodOptional<z.ZodNumber>;
+    color: z.ZodOptional<z.ZodString>;
+    data: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+  }, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"project">;
+    durationHours: z.ZodNumber;
     percentComplete: z.ZodDefault<z.ZodNumber>;
-    type: z.ZodDefault<z.ZodEnum<{
-      task: "task";
-      project: "project";
-      milestone: "milestone";
-    }>>;
     open: z.ZodDefault<z.ZodBoolean>;
+    id: z.ZodNumber;
+    text: z.ZodString;
+    startDate: z.ZodString;
+    parent: z.ZodOptional<z.ZodNumber>;
     color: z.ZodOptional<z.ZodString>;
-  }, z.core.$strip>>;
+    data: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+  }, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"milestone">;
+    id: z.ZodNumber;
+    text: z.ZodString;
+    startDate: z.ZodString;
+    parent: z.ZodOptional<z.ZodNumber>;
+    color: z.ZodOptional<z.ZodString>;
+    data: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+  }, z.core.$strip>], "kind">>;
   links: z.ZodDefault<z.ZodArray<z.ZodObject<{
     id: z.ZodNumber;
     source: z.ZodNumber;
@@ -77,19 +108,24 @@ declare const GanttInputSchema: z.ZodObject<{
       FF: "FF";
       SF: "SF";
     }>>;
+    data: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
   }, z.core.$strip>>>;
 }, z.core.$strip>;
 /** The raw, unvalidated input shape that consumers pass to {@link parseGanttInput}. */
 type GanttInputRaw = z.input<typeof GanttInputSchema>;
 /** Allowed dependency link type values: `'FS'`, `'SS'`, `'FF'`, or `'SF'`. */
 type LinkType = z.infer<typeof LinkTypeSchema>;
-/** Allowed task type values: `'task'`, `'project'`, or `'milestone'`. */
-type TaskType = z.infer<typeof TaskTypeSchema>;
+/** Allowed task kind values: `'task'`, `'project'`, or `'milestone'`. */
+type TaskKind = z.infer<typeof TaskKindSchema>;
 type SpecialDayKind = z.infer<typeof SpecialDayKindSchema>;
 type SpecialDay = z.infer<typeof SpecialDaySchema>;
 /**
- * A project task in the Gantt chart. Defines timing (start date, duration in hours),
- * hierarchy (parent id), and visual properties (type, percentComplete, color).
+ * A task in the Gantt chart — discriminated by `kind` into leaf tasks,
+ * summary projects, and milestones.
+ *
+ * - **`kind: 'task'`** — A regular task with a colored bar and duration.
+ * - **`kind: 'project'`** — A summary/group row with a colored bar and optional tree state.
+ * - **`kind: 'milestone'`** — A zero-duration marker rendered as a diamond.
  */
 type Task = z.infer<typeof TaskSchema>;
 /**
@@ -112,15 +148,8 @@ type GanttInput = z.infer<typeof GanttInputSchema>;
  * @throws {import('zod').ZodError} On schema validation failure.
  */
 declare function parseGanttInput(raw: GanttInputRaw): GanttInput;
-/**
- * Parses without throwing; returns `null` on validation failure.
- *
- * @param raw - The unvalidated input from the consumer.
- * @returns The parsed {@link GanttInput} or `null` when the input is invalid.
- */
-declare function safeParseGanttInput(raw: GanttInputRaw): GanttInput | null;
 //#endregion
-//#region src/gantt-chart/timeline/scale.d.ts
+//#region src/lib/timeline/scale.d.ts
 type TimeScale = 'hour' | 'day' | 'week' | 'month' | 'quarter' | 'year';
 type ScaleConfig = {
   /** Pixel width of one column unit */columnWidth: number; /** Milliseconds per column unit */
@@ -129,7 +158,7 @@ type ScaleConfig = {
 };
 declare const SCALE_CONFIGS: Record<TimeScale, ScaleConfig>;
 //#endregion
-//#region src/gantt-chart/domain/tree.d.ts
+//#region src/lib/domain/tree.d.ts
 /**
  * A task node in the render tree, combining the flat {@link Task} input data
  * with computed hierarchy structure.
@@ -147,7 +176,9 @@ type TaskNode = Task & {
  *
  * @param tasks - The flat array of tasks to convert into a tree.
  * @returns Root-level {@link TaskNode} instances with populated `children`.
- * @throws {GanttError} When a task references a `parent` id that does not exist.
+ * @throws {GanttError} When a task references a `parent` id that does not exist,
+ *         when a parent cycle is detected, or when a `parent` points to a
+ *         milestone or leaf task.
  */
 declare function buildTaskTree(tasks: Task[]): TaskNode[];
 /**
@@ -167,7 +198,7 @@ declare function flattenTree(roots: TaskNode[], expandedIds: ReadonlySet<number>
  */
 declare function isParent(node: TaskNode): boolean;
 //#endregion
-//#region src/gantt-chart/timeline/pixelMapper.d.ts
+//#region src/lib/timeline/pixelMapper.d.ts
 type PixelMapper = {
   /** Date → x pixel offset from viewport start */toX: (date: Date) => number; /** x pixel offset → Date */
   toDate: (x: number) => Date; /** Hours → pixel width */
@@ -186,7 +217,7 @@ type PixelMapper = {
  */
 declare function createPixelMapper(scale: TimeScale, viewportStart: Date): PixelMapper;
 //#endregion
-//#region src/gantt-chart/timeline/layoutEngine.d.ts
+//#region src/lib/timeline/layoutEngine.d.ts
 declare const DENSITY: {
   readonly rowHeight: 44;
   readonly barHeight: 28;
@@ -205,7 +236,7 @@ type BarLayout = {
   width: number;
   height: number;
   progressWidth: number;
-  type: 'task' | 'project' | 'milestone';
+  kind: 'task' | 'project' | 'milestone';
   rowIndex: number; /** Center x; identical to x + width/2 or x for milestones */
   centerX: number;
   centerY: number;
@@ -228,7 +259,7 @@ declare function computeLayout(rows: TaskNode[], mapper: PixelMapper): Map<numbe
  */
 declare function deriveViewport(tasks: TaskNode[], paddingHours?: number): [Date, Date];
 //#endregion
-//#region src/gantt-chart/locale.d.ts
+//#region src/lib/locale.d.ts
 type LocaleLabelKey = 'ariaTask' | 'ariaMilestone' | 'addSubtaskTitle' | 'columnTaskName' | 'columnStartDate' | 'columnDuration' | 'columnQuarter';
 type ChartLocale = {
   code: string;
@@ -293,7 +324,7 @@ declare function formatWeekNumber(date: Date, scheme: 'iso' | 'us' | 'simple'):
  */
 declare function formatLabel(template: string, arg: string): string;
 //#endregion
-//#region src/gantt-chart/domain/dependencies.d.ts
+//#region src/lib/domain/dependencies.d.ts
 /**
  * Detects circular dependencies in the link graph using DFS tri-colour marking.
  *
@@ -303,15 +334,18 @@ declare function formatLabel(template: string, arg: string): string;
  */
 declare function detectCycles(tasks: Task[], links: Link[]): void;
 /**
- * Validates that every link references existing task IDs.
+ * Validates that every link references existing task IDs and that no
+ * duplicate (source, target) pairs exist.
  *
  * @param tasks - The task list (used as the reference set of valid IDs).
  * @param links - The dependency links to validate.
- * @throws {GanttError} When any link references a non-existent source or target task.
+ * @throws {GanttError} When any link references a non-existent source or target task,
+ *         when a non-FS link connects to/from a milestone, or when duplicate
+ *         (source, target) pairs exist.
  */
 declare function validateLinkRefs(tasks: Task[], links: Link[]): void;
 //#endregion
-//#region src/gantt-chart/domain/dateMath.d.ts
+//#region src/lib/domain/dateMath.d.ts
 /**
  * Parses `YYYY-MM-DD` → UTC midnight `Date`.
  *
@@ -353,7 +387,7 @@ declare function diffDays(a: Date, b: Date): number;
  */
 declare function diffHours(a: Date, b: Date): number;
 //#endregion
-//#region src/gantt-chart/rendering/linkRouter.d.ts
+//#region src/lib/rendering/linkRouter.d.ts
 type Point = {
   x: number;
   y: number;
@@ -361,7 +395,8 @@ type Point = {
 type RoutedLink = {
   linkId: number;
   sourceTaskId: number;
-  targetTaskId: number; /** Ordered vertices of the orthogonal polyline (source → target). */
+  targetTaskId: number;
+  type: LinkType; /** Ordered vertices of the orthogonal polyline (source → target). */
   points: Point[];
 };
 /**
@@ -369,20 +404,26 @@ type RoutedLink = {
  * Links whose source or target is not in the layout map are skipped silently
  * (e.g. when the row is collapsed).
  *
- * @param links - The dependency links to route.
+ * @param links   - The dependency links to route.
  * @param layouts - A map from task ID to its computed {@link BarLayout}.
  * @returns An array of {@link RoutedLink} objects with computed vertex paths.
  */
 declare function routeLinks(links: Link[], layouts: Map<number, BarLayout>): RoutedLink[];
 //#endregion
-//#region src/gantt-chart/vanilla/dom/gridColumns.d.ts
+//#region src/lib/vanilla/dom/gridColumns.d.ts
+/**
+ * Union of all field names that can appear on any {@link Task} variant.
+ * Use when referencing task fields in grid column schemas that apply
+ * across a heterogeneous set of task kinds.
+ */
+type TaskDataField = keyof Task | 'durationHours' | 'percentComplete' | 'open';
 type GridColumn = {
   id: string;
   header: string;
   width: string;
   align?: 'left' | 'center' | 'right';
   visible?: boolean;
-  field?: keyof Task;
+  field?: TaskDataField;
   format?: (value: unknown, task: Task, row: TaskNode, locale: ChartLocale) => string;
 };
 declare const DEFAULT_GRID_COLUMNS: GridColumn[];
@@ -418,42 +459,49 @@ declare const GRID_COLUMN_FR_MIN_WIDTH = 120;
  */
 declare function gridNaturalWidth(columns: GridColumn[]): number;
 //#endregion
-//#region src/gantt-chart/vanilla/gantt-chart.d.ts
-type OnTaskSelect = (taskId: number | null) => void;
-type OnTaskMove = (payload: {
-  id: number;
-  startDate: Date;
+//#region src/lib/vanilla/gantt-chart.d.ts
+type OnTaskSelect = (payload: {
+  task: Task;
 }) => void;
+type OnTaskMove = (payload: {
+  task: Task;
+  newStartDate: Date;
+}) => boolean;
 type OnTaskResize = (payload: {
-  id: number;
-  durationHours: number;
-}) => void;
+  task: Task;
+  newDurationHours: number;
+}) => boolean;
 type OnTaskAdd = (payload: {
-  parentId: number;
-}) => void;
+  parentTask: Task;
+}) => boolean;
 type OnTaskDoubleClick = (payload: {
-  id: number;
-  source: 'grid' | 'bar' | 'milestone';
-}) => void;
-type OnTaskEditIntent = (payload: {
-  id: number;
-  source: 'grid' | 'bar' | 'milestone';
-  trigger: 'doubleClick';
   task: Task;
 }) => void;
 type OnLinkCreate = (payload: {
-  sourceTaskId: number;
-  targetTaskId: number;
   type: 'FS';
+  sourceTask: Task;
+  targetTask: Task;
+}) => boolean;
+type OnLinkClick = (payload: {
+  link: Link;
 }) => void;
+type OnLinkDblClick = (payload: {
+  link: Link;
+}) => void;
+type OnProgressChange = (payload: {
+  task: Task;
+  newPercentComplete: number;
+}) => boolean;
 type GanttCallbacks = {
-  onSelect?: OnTaskSelect;
-  onMove?: OnTaskMove;
-  onResize?: OnTaskResize;
-  onAdd?: OnTaskAdd;
+  onTaskSelect?: OnTaskSelect;
+  onTaskMove?: OnTaskMove;
+  onTaskResize?: OnTaskResize;
+  onTaskAdd?: OnTaskAdd;
   onTaskDoubleClick?: OnTaskDoubleClick;
-  onTaskEditIntent?: OnTaskEditIntent;
   onLinkCreate?: OnLinkCreate;
+  onLinkClick?: OnLinkClick;
+  onLinkDblClick?: OnLinkDblClick;
+  onProgressChange?: OnProgressChange;
   onLeftPaneWidthChange?: (width: number) => void;
   onGridColumnsChange?: (columns: GridColumn[]) => void;
 };
@@ -462,6 +510,7 @@ type GanttOptions = {
   scale?: TimeScale;
   highlightLinkedDependenciesOnSelect?: boolean;
   linkCreationEnabled?: boolean;
+  progressDragEnabled?: boolean;
   leftPaneWidth?: number;
   responsiveSplitPane?: boolean;
   mobileBreakpoint?: number;
@@ -477,10 +526,10 @@ type GanttOptions = {
   specialDays?: SpecialDay[];
   gridColumns?: GridColumn[];
   theme?: ThemeMode;
-} & GanttCallbacks;
+};
 type GanttInstance = {
   update: (input: GanttInput) => void;
-  setScale: (scale: TimeScale) => void;
+  setOptions: (opts: Partial<GanttOptions>) => void;
   select: (id: number | null) => void;
   collapseAll: () => void;
   expandAll: () => void;
@@ -508,7 +557,7 @@ declare class GanttChart implements GanttInstance {
    * @param container - The host `HTMLElement` the chart will be appended to.
    * @param opts - Configuration and callback options.
    */
-  constructor(container: HTMLElement, opts?: GanttOptions);
+  constructor(container: HTMLElement, opts?: GanttOptions, cbs?: GanttCallbacks);
   /**
    * Replaces the full dataset and re-renders.
    *
@@ -517,12 +566,15 @@ declare class GanttChart implements GanttInstance {
    */
   update(newInput: GanttInput): void;
   /**
-   * Switches the time scale and re-renders.
+   * Merges the supplied options into the current configuration and re-renders
+   * only the panes affected by the changed options.
    *
-   * @param scale - The new {@link TimeScale} to display.
+   * @param opts - A partial {@link GanttOptions} object. Only the keys present
+   *               in this parameter are updated; missing keys keep their
+   *               previous values.
    * @throws {GanttError} When the instance has been destroyed.
    */
-  setScale(scale: TimeScale): void;
+  setOptions(opts: Partial<GanttOptions>): void;
   /**
    * Programmatically selects or deselects a task.
    *
@@ -549,8 +601,8 @@ declare class GanttChart implements GanttInstance {
   destroy(): void;
 }
 //#endregion
-//#region src/gantt-chart/errors.d.ts
-type GanttErrorCode = 'PARENT_REFERENCE' | 'LINK_REFERENCE' | 'DEPENDENCY_CYCLE' | 'INSTANCE_DESTROYED';
+//#region src/lib/errors.d.ts
+type GanttErrorCode = 'PARENT_REFERENCE' | 'PARENT_CYCLE' | 'LINK_REFERENCE' | 'DEPENDENCY_CYCLE' | 'MILESTONE_LINK_TYPE' | 'DUPLICATE_LINK_PAIR' | 'INSTANCE_DESTROYED';
 /**
  * Domain-specific error with a machine-readable {@link GanttErrorCode}.
  */
@@ -563,5 +615,5 @@ declare class GanttError extends Error {
   constructor(code: GanttErrorCode, message: string);
 }
 //#endregion
-export { BAR_HEIGHT, BAR_Y_OFFSET, type BarLayout, CHART_LOCALE_EN_US, type ChartLocale, DEFAULT_GRID_COLUMNS, DENSITY, EN_US_LABELS, GRID_COLUMN_FR_MIN_WIDTH, type GanttCallbacks, GanttChart, GanttError, type GanttErrorCode, type GanttInput, type GanttInputRaw, GanttInputSchema, type GanttInstance, type GanttOptions, type GridColumn, type Link, LinkSchema, type LinkType, LinkTypeSchema, type LocaleLabelKey, MILESTONE_HALF, MILESTONE_SIZE, type OnLinkCreate, type OnTaskAdd, type OnTaskDoubleClick, type OnTaskEditIntent, type OnTaskMove, type OnTaskResize, type OnTaskSelect, type PixelMapper, type Point, ROW_HEIGHT, type RoutedLink, SCALE_CONFIGS, type ScaleConfig, type SpecialDay, type SpecialDayKind, SpecialDayKindSchema, SpecialDaySchema, type Task, type TaskNode, TaskSchema, type TaskType, TaskTypeSchema, type ThemeMode, type TimeScale, addDays, addHours, buildTaskTree, computeLayout, createPixelMapper, deriveViewport, deriveWeekNumbering, deriveWeekStartsOn, deriveWeekendDays, detectCycles, diffDays, diffHours, flattenTree, formatLabel, formatWeekNumber, gridColumnDefaults, gridNaturalWidth, gridTemplateColumns, isParent, parseDate, parseGanttInput, resolveChartLocale, routeLinks, safeParseGanttInput, validateLinkRefs, visibleColumns };
+export { BAR_HEIGHT, BAR_Y_OFFSET, type BarLayout, CHART_LOCALE_EN_US, type ChartLocale, DEFAULT_GRID_COLUMNS, DENSITY, EN_US_LABELS, GRID_COLUMN_FR_MIN_WIDTH, type GanttCallbacks, GanttChart, GanttError, type GanttErrorCode, type GanttInput, type GanttInputRaw, GanttInputSchema, type GanttInstance, type GanttOptions, type GridColumn, type Link, LinkSchema, type LinkType, LinkTypeSchema, type LocaleLabelKey, MILESTONE_HALF, MILESTONE_SIZE, type OnLinkClick, type OnLinkCreate, type OnLinkDblClick, type OnProgressChange, type OnTaskAdd, type OnTaskDoubleClick, type OnTaskMove, type OnTaskResize, type OnTaskSelect, type PixelMapper, type Point, ROW_HEIGHT, type RoutedLink, SCALE_CONFIGS, type ScaleConfig, type SpecialDay, type SpecialDayKind, SpecialDayKindSchema, SpecialDaySchema, type Task, type TaskDataField, type TaskKind, TaskKindSchema, type TaskNode, TaskSchema, type ThemeMode, type TimeScale, addDays, addHours, buildTaskTree, computeLayout, createPixelMapper, deriveViewport, deriveWeekNumbering, deriveWeekStartsOn, deriveWeekendDays, detectCycles, diffDays, diffHours, flattenTree, formatLabel, formatWeekNumber, gridColumnDefaults, gridNaturalWidth, gridTemplateColumns, isParent, parseDate, parseGanttInput, resolveChartLocale, routeLinks, validateLinkRefs, visibleColumns };
 //# sourceMappingURL=index.d.mts.map