gantt-renderer 0.3.0 → 0.4.0

package/CHANGELOG.md

@@ -1,15 +1,19 @@
-# [0.3.0](https://github.com/doberkofler/gantt-renderer/compare/v0.2.0...v0.3.0) (2026-05-08)
+# [0.4.0](https://github.com/doberkofler/gantt-renderer/compare/v0.2.0...v0.4.0) (2026-05-09)
 
 
 ### Bug Fixes
 
 * correct link routing geometry and dependency layer rendering ([d00de8a](https://github.com/doberkofler/gantt-renderer/commit/d00de8a8b51d69b7b50ec4c6bf0ce6dd3657e1a8))
+* improve lint rules ([1644377](https://github.com/doberkofler/gantt-renderer/commit/1644377da0294838a77386ac4d74832c289fcbfb))
 * **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)
+* prevent spurious onTaskMove callback on double-click in timeline ([14976d0](https://github.com/doberkofler/gantt-renderer/commit/14976d0ca8e17bf0b47b34a91e184513e316e811))
 * **rendering:** offset multi-row link midpoint to avoid bar center slicing ([1fe09fa](https://github.com/doberkofler/gantt-renderer/commit/1fe09fa3d736cf948035c4f1619f398fa374464d))
 
 
 ### Features
 
+* add custom tooltip support with onTooltipText callback ([eacc7a8](https://github.com/doberkofler/gantt-renderer/commit/eacc7a845d346f007b4c7ad5a9ed901f9d2e8d60))
+* add readonly support for tasks and links ([48cd946](https://github.com/doberkofler/gantt-renderer/commit/48cd946fe0b22bbcba18cb6b8e04d62d285300a0))
 * **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/dist/index.d.mts

@@ -34,6 +34,7 @@ declare const TaskSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
   startDate: z.ZodString;
   parent: z.ZodOptional<z.ZodNumber>;
   color: z.ZodOptional<z.ZodString>;
+  readonly: z.ZodOptional<z.ZodBoolean>;
   data: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 }, z.core.$strip>, z.ZodObject<{
   kind: z.ZodLiteral<"project">;
@@ -45,6 +46,7 @@ declare const TaskSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
   startDate: z.ZodString;
   parent: z.ZodOptional<z.ZodNumber>;
   color: z.ZodOptional<z.ZodString>;
+  readonly: z.ZodOptional<z.ZodBoolean>;
   data: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 }, z.core.$strip>, z.ZodObject<{
   kind: z.ZodLiteral<"milestone">;
@@ -53,6 +55,7 @@ declare const TaskSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
   startDate: z.ZodString;
   parent: z.ZodOptional<z.ZodNumber>;
   color: z.ZodOptional<z.ZodString>;
+  readonly: z.ZodOptional<z.ZodBoolean>;
   data: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 }, z.core.$strip>], "kind">;
 declare const LinkSchema: z.ZodObject<{
@@ -65,6 +68,7 @@ declare const LinkSchema: z.ZodObject<{
     FF: "FF";
     SF: "SF";
   }>>;
+  readonly: z.ZodOptional<z.ZodBoolean>;
   data: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 }, z.core.$strip>;
 declare const GanttInputSchema: z.ZodObject<{
@@ -77,6 +81,7 @@ declare const GanttInputSchema: z.ZodObject<{
     startDate: z.ZodString;
     parent: z.ZodOptional<z.ZodNumber>;
     color: z.ZodOptional<z.ZodString>;
+    readonly: z.ZodOptional<z.ZodBoolean>;
     data: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
   }, z.core.$strip>, z.ZodObject<{
     kind: z.ZodLiteral<"project">;
@@ -88,6 +93,7 @@ declare const GanttInputSchema: z.ZodObject<{
     startDate: z.ZodString;
     parent: z.ZodOptional<z.ZodNumber>;
     color: z.ZodOptional<z.ZodString>;
+    readonly: z.ZodOptional<z.ZodBoolean>;
     data: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
   }, z.core.$strip>, z.ZodObject<{
     kind: z.ZodLiteral<"milestone">;
@@ -96,6 +102,7 @@ declare const GanttInputSchema: z.ZodObject<{
     startDate: z.ZodString;
     parent: z.ZodOptional<z.ZodNumber>;
     color: z.ZodOptional<z.ZodString>;
+    readonly: z.ZodOptional<z.ZodBoolean>;
     data: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
   }, z.core.$strip>], "kind">>;
   links: z.ZodDefault<z.ZodArray<z.ZodObject<{
@@ -108,6 +115,7 @@ declare const GanttInputSchema: z.ZodObject<{
       FF: "FF";
       SF: "SF";
     }>>;
+    readonly: z.ZodOptional<z.ZodBoolean>;
     data: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
   }, z.core.$strip>>>;
 }, z.core.$strip>;
@@ -460,40 +468,53 @@ declare const GRID_COLUMN_FR_MIN_WIDTH = 120;
 declare function gridNaturalWidth(columns: GridColumn[]): number;
 //#endregion
 //#region src/lib/vanilla/gantt-chart.d.ts
-type OnTaskSelect = (payload: {
+type OnTaskClick = (payload: {
   task: Task;
-}) => void;
+  instance: GanttInstance;
+}) => void | Promise<void>;
 type OnTaskMove = (payload: {
   task: Task;
   newStartDate: Date;
-}) => boolean;
+  instance: GanttInstance;
+}) => boolean | Promise<boolean>;
 type OnTaskResize = (payload: {
   task: Task;
   newDurationHours: number;
-}) => boolean;
+  instance: GanttInstance;
+}) => boolean | Promise<boolean>;
 type OnTaskAdd = (payload: {
   parentTask: Task;
-}) => boolean;
+  instance: GanttInstance;
+}) => boolean | Promise<boolean>;
 type OnTaskDoubleClick = (payload: {
   task: Task;
-}) => void;
+  instance: GanttInstance;
+}) => void | Promise<void>;
 type OnLinkCreate = (payload: {
   type: 'FS';
   sourceTask: Task;
   targetTask: Task;
-}) => boolean;
+  instance: GanttInstance;
+}) => boolean | Promise<boolean>;
 type OnLinkClick = (payload: {
   link: Link;
-}) => void;
+  instance: GanttInstance;
+}) => void | Promise<void>;
 type OnLinkDblClick = (payload: {
   link: Link;
-}) => void;
+  instance: GanttInstance;
+}) => void | Promise<void>;
 type OnProgressChange = (payload: {
   task: Task;
   newPercentComplete: number;
-}) => boolean;
+  instance: GanttInstance;
+}) => boolean | Promise<boolean>;
+type OnTooltipText = (payload: {
+  task: Task;
+  instance: GanttInstance;
+}) => string | null;
 type GanttCallbacks = {
-  onTaskSelect?: OnTaskSelect;
+  onTaskClick?: OnTaskClick;
   onTaskMove?: OnTaskMove;
   onTaskResize?: OnTaskResize;
   onTaskAdd?: OnTaskAdd;
@@ -502,8 +523,15 @@ type GanttCallbacks = {
   onLinkClick?: OnLinkClick;
   onLinkDblClick?: OnLinkDblClick;
   onProgressChange?: OnProgressChange;
-  onLeftPaneWidthChange?: (width: number) => void;
-  onGridColumnsChange?: (columns: GridColumn[]) => void;
+  onTooltipText?: OnTooltipText;
+  onLeftPaneWidthChange?: (payload: {
+    width: number;
+    instance: GanttInstance;
+  }) => void | Promise<void>;
+  onGridColumnsChange?: (payload: {
+    columns: GridColumn[];
+    instance: GanttInstance;
+  }) => void | Promise<void>;
 };
 type ThemeMode = 'light' | 'dark' | 'system';
 type GanttOptions = {
@@ -530,7 +558,8 @@ type GanttOptions = {
 type GanttInstance = {
   update: (input: GanttInput) => void;
   setOptions: (opts: Partial<GanttOptions>) => void;
-  select: (id: number | null) => void;
+  setCallbacks: (cbs: GanttCallbacks) => void;
+  select: (id: number | null, fireCallback?: boolean) => void;
   collapseAll: () => void;
   expandAll: () => void;
   destroy: () => void;
@@ -553,11 +582,20 @@ declare class GanttChart implements GanttInstance {
   /**
    * Constructs a new chart, builds the DOM, and wires internal event handling.
    * Data must be loaded via {@link update} before the chart renders.
+   * Callbacks must be set via {@link setCallbacks} before user interactions are handled.
    *
    * @param container - The host `HTMLElement` the chart will be appended to.
-   * @param opts - Configuration and callback options.
+   * @param opts - Configuration options.
+   */
+  constructor(container: HTMLElement, opts?: GanttOptions);
+  /**
+   * Sets or replaces the chart's user-facing callbacks.
+   * Does not trigger a re-render.
+   *
+   * @param cbs - The {@link GanttCallbacks} to register.
+   * @throws {GanttError} When the instance has been destroyed.
    */
-  constructor(container: HTMLElement, opts?: GanttOptions, cbs?: GanttCallbacks);
+  setCallbacks(cbs: GanttCallbacks): void;
   /**
    * Replaces the full dataset and re-renders.
    *
@@ -579,9 +617,10 @@ declare class GanttChart implements GanttInstance {
    * Programmatically selects or deselects a task.
    *
    * @param id - The task ID to select, or `null` to clear the selection.
+   * @param fireCallback - Whether to fire the `onTaskClick` callback. Default `true`.
    * @throws {GanttError} When the instance has been destroyed.
    */
-  select(id: number | null): void;
+  select(id: number | null, fireCallback?: boolean): void;
   /**
    * Collapses all expandable groups in the task tree.
    *
@@ -615,5 +654,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 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 };
+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 OnTaskClick, type OnTaskDoubleClick, type OnTaskMove, type OnTaskResize, type OnTooltipText, 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