gantt-renderer 0.8.0 → 0.10.0

package/CHANGELOG.md

@@ -1,3 +1,18 @@
+# [0.10.0](https://github.com/doberkofler/gantt-renderer/compare/v0.9.0...v0.10.0) (2026-05-13)
+
+
+### Features
+
+* **gantt:** add onExpandCollapse/onExpandCollapseAll callbacks and header +/− controls ([652d626](https://github.com/doberkofler/gantt-renderer/commit/652d6261b7d6cdfd74c07acebb54b84708a155b1))
+
+# [0.9.0](https://github.com/doberkofler/gantt-renderer/compare/v0.8.0...v0.9.0) (2026-05-13)
+
+
+### Features
+
+* **locales:** modular locale system with 43 languages via subpath exports ([4866724](https://github.com/doberkofler/gantt-renderer/commit/48667247005c245fd55b9421012e03ec13d82ba1))
+* **vanilla:** add showTodayMarker option to toggle current-date line ([49ddc0f](https://github.com/doberkofler/gantt-renderer/commit/49ddc0fa1e00356403df286e99df71242cca0b01))
+
 # [0.8.0](https://github.com/doberkofler/gantt-renderer/compare/v0.7.0...v0.8.0) (2026-05-12)
 
 

package/dist/index.d.mts

@@ -1,31 +1,7 @@
+import { a as deriveWeekStartsOn, c as formatWeekNumber, i as deriveWeekNumbering, l as resolveChartLocale, n as EN_US_LABELS, o as deriveWeekendDays, r as LocaleLabelKey, s as formatLabel, t as ChartLocale } from "./locale-B81kcgPd.mjs";
 import { z } from "zod";
 
 //#region src/lib/validation/schemas.d.ts
-declare const LinkTypeSchema: z.ZodEnum<{
-  FS: "FS";
-  SS: "SS";
-  FF: "FF";
-  SF: "SF";
-}>;
-declare const TaskKindSchema: z.ZodEnum<{
-  task: "task";
-  project: "project";
-  milestone: "milestone";
-}>;
-declare const SpecialDayKindSchema: z.ZodEnum<{
-  holiday: "holiday";
-  custom: "custom";
-}>;
-/** @internal */
-declare const SpecialDaySchema: z.ZodObject<{
-  date: z.ZodString;
-  kind: z.ZodEnum<{
-    holiday: "holiday";
-    custom: "custom";
-  }>;
-  label: z.ZodOptional<z.ZodString>;
-  className: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>;
 declare const TaskSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
   kind: z.ZodLiteral<"task">;
   endDate: z.ZodString;
@@ -77,26 +53,6 @@ declare const LinkSchema: z.ZodObject<{
 type ZodTaskInferred = z.infer<typeof TaskSchema>;
 /** @internal */
 type ZodLinkInferred = z.infer<typeof LinkSchema>;
-/** @internal */
-type ZodTaskInput = z.input<typeof TaskSchema>;
-/** @internal */
-type ZodLinkInput = z.input<typeof LinkSchema>;
-/** Raw input version of a task — uses zod's input shape where fields with defaults are optional. */
-type TaskRaw<TData = never> = WithoutData<ZodTaskInput> & WithData<TData>;
-/** Raw input version of a link — uses zod's input shape where fields with defaults are optional. */
-type LinkRaw<TData = never> = WithoutData<ZodLinkInput> & WithData<TData>;
-/**
- * Conditional data property helper.
- * When `T` is `never`, adds nothing. Otherwise adds `{data?: T | undefined}`.
- */
-type WithData<T> = [T] extends [never] ? Record<never, never> : {
-  data?: T | undefined;
-};
-/**
- * Distributes `Omit` over union members so variant-specific properties
- * (e.g. `endDate`, `percentComplete`, `open`) are preserved in discriminated unions.
- */
-type WithoutData<T> = T extends unknown ? Omit<T, 'data'> : never;
 /**
  * A task in the Gantt chart &mdash; discriminated by `kind` into leaf tasks,
  * summary projects, and milestones.
@@ -118,13 +74,55 @@ type WithoutData<T> = T extends unknown ? Omit<T, 'data'> : never;
  * };
  * ```
  */
-type Task<TData = never> = WithoutData<ZodTaskInferred> & WithData<TData>;
+type Task<TData = never> = {
+  id: number;
+  text: string;
+  startDate: string;
+  parent?: number | undefined;
+  color?: string | undefined;
+  readonly?: boolean | undefined;
+  data?: unknown;
+  kind: 'task';
+  endDate: string;
+  percentComplete: number;
+} | {
+  id: number;
+  text: string;
+  startDate: string;
+  parent?: number | undefined;
+  color?: string | undefined;
+  readonly?: boolean | undefined;
+  data?: unknown;
+  kind: 'project';
+  endDate: string;
+  percentComplete: number;
+  open: boolean;
+} | {
+  id: number;
+  text: string;
+  startDate: string;
+  parent?: number | undefined;
+  color?: string | undefined;
+  readonly?: boolean | undefined;
+  data?: unknown;
+  kind: 'milestone';
+} extends infer _U ? _U extends unknown ? Omit<_U, 'data'> & ([TData] extends [never] ? Record<never, never> : {
+  data?: TData | undefined;
+}) : never : never;
 /**
  * A dependency link between two tasks.
  *
  * @param TData - The type of the optional `data` property. Defaults to `never`.
  */
-type Link<TData = never> = WithoutData<ZodLinkInferred> & WithData<TData>;
+type Link<TData = never> = {
+  id: number;
+  source: number;
+  target: number;
+  type: LinkType;
+  readonly?: boolean | undefined;
+} & ([TData] extends [never] ? Record<never, never> : {
+  data?: TData | undefined;
+});
 /**
  * The complete input data for the chart.
  *
@@ -144,15 +142,62 @@ type GanttInput<TTaskData = never, TLinkData = never> = {
  * @param TLinkData - The type of the `data` property on links. Defaults to `never`.
  */
 type GanttInputRaw<TTaskData = never, TLinkData = never> = {
-  tasks: readonly TaskRaw<TTaskData>[];
-  links?: readonly LinkRaw<TLinkData>[];
+  tasks: readonly ({
+    id: number;
+    text: string;
+    startDate: string;
+    parent?: number | undefined;
+    color?: string | undefined;
+    readonly?: boolean | undefined;
+    data?: unknown;
+    kind: 'task';
+    endDate: string;
+    percentComplete?: number | undefined;
+  } | {
+    id: number;
+    text: string;
+    startDate: string;
+    parent?: number | undefined;
+    color?: string | undefined;
+    readonly?: boolean | undefined;
+    data?: unknown;
+    kind: 'project';
+    endDate: string;
+    percentComplete?: number | undefined;
+    open?: boolean | undefined;
+  } | {
+    id: number;
+    text: string;
+    startDate: string;
+    parent?: number | undefined;
+    color?: string | undefined;
+    readonly?: boolean | undefined;
+    data?: unknown;
+    kind: 'milestone';
+  } extends infer _RU ? _RU extends unknown ? Omit<_RU, 'data'> & ([TTaskData] extends [never] ? Record<never, never> : {
+    data?: TTaskData | undefined;
+  }) : never : never)[];
+  links?: readonly ({
+    id: number;
+    source: number;
+    target: number;
+    type?: LinkType | undefined;
+    readonly?: boolean | undefined;
+  } & ([TLinkData] extends [never] ? Record<never, never> : {
+    data?: TLinkData | undefined;
+  }))[];
 };
 /** Allowed dependency link type values: `'FS'`, `'SS'`, `'FF'`, or `'SF'`. */
-type LinkType = z.infer<typeof LinkTypeSchema>;
+type LinkType = 'FS' | 'SS' | 'FF' | 'SF';
 /** 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>;
+type TaskKind = 'task' | 'project' | 'milestone';
+type SpecialDayKind = 'holiday' | 'custom';
+type SpecialDay = {
+  /** ISO date: YYYY-MM-DD */date: string;
+  kind: SpecialDayKind;
+  label?: string | undefined;
+  className?: string | undefined;
+};
 //#endregion
 //#region src/lib/timeline/scale.d.ts
 type TimeScale = 'hour' | 'day' | 'week' | 'month' | 'quarter' | 'year';
@@ -171,7 +216,7 @@ declare const SCALE_CONFIGS: Record<TimeScale, ScaleConfig>;
  * Produced by {@link buildTaskTree}; consumed by virtualized row rendering
  * and the timeline layout engine.
  */
-type TaskNode = ZodTaskInferred & {
+type TaskNode = Task<Record<string, unknown>> & {
   /** Array of child task nodes in the tree hierarchy. */children: TaskNode[]; /** 0 = root */
   depth: number;
 };
@@ -264,79 +309,6 @@ declare function computeLayout(rows: TaskNode[], mapper: PixelMapper): Map<numbe
  */
 declare function deriveViewport(tasks: TaskNode[], paddingHours?: number): [Date, Date];
 //#endregion
-//#region src/lib/locale.d.ts
-type LocaleLabelKey = 'ariaTask' | 'ariaMilestone' | 'addSubtaskTitle' | 'columnTaskName' | 'columnStartDate' | 'columnEndDate' | 'columnDuration' | 'columnQuarter';
-type ChartLocale = {
-  code: string;
-  labels?: Partial<Record<LocaleLabelKey, string>>;
-  weekStartsOn?: 0 | 1 | 6;
-  weekNumbering?: 'iso' | 'us' | 'simple';
-  weekendDays?: number[];
-};
-declare const EN_US_LABELS: Record<LocaleLabelKey, string>;
-declare const CHART_LOCALE_EN_US: ChartLocale;
-declare const CHART_LOCALE_EN_GB: ChartLocale;
-declare const CHART_LOCALE_DE_DE: ChartLocale;
-declare const CHART_LOCALE_FR_FR: ChartLocale;
-declare const CHART_LOCALE_ES_ES: ChartLocale;
-declare const CHART_LOCALE_IT_IT: ChartLocale;
-declare const CHART_LOCALE_PT_PT: ChartLocale;
-declare const CHART_LOCALE_ZH_CN: ChartLocale;
-declare const CHART_LOCALE_JA_JP: ChartLocale;
-/**
- * Derives the first day of week (0=Sun, 1=Mon, 6=Sat) from a BCP 47 code.
- * Uses `Intl.Locale.getWeekInfo()` where available (Chromium, Safari 15.4+),
- * with a CLDR-based fallback table for Firefox and older runtimes.
- *
- * @param code - A BCP 47 language tag (e.g. `'en-US'`, `'de-DE'`).
- * @returns The first day of the week: `0` (Sunday), `1` (Monday), or `6` (Saturday).
- */
-declare function deriveWeekStartsOn(code: string): 0 | 1 | 6;
-/**
- * Derives the week numbering scheme from a BCP 47 code.
- * Europe and ISO-aligned regions default to `'iso'`; Americas and others to `'us'`.
- *
- * @param code - A BCP 47 language tag (e.g. `'en-US'`, `'de-DE'`).
- * @returns The week numbering scheme: `'iso'`, `'us'`, or `'simple'`.
- */
-declare function deriveWeekNumbering(code: string): 'iso' | 'us' | 'simple';
-/**
- * Derives weekend days (0=Sun … 6=Sat) from a BCP 47 code.
- * Uses `Intl.Locale.getWeekInfo()` where available, with a CLDR-based fallback table.
- *
- * @param code - A BCP 47 language tag (e.g. `'en-US'`, `'de-DE'`).
- * @returns An array of weekend day indices (sorted ascending).
- */
-declare function deriveWeekendDays(code: string): number[];
-/**
- * Resolves a {@link ChartLocale} from either a full `ChartLocale` object or a BCP 47 string.
- * When given a string, derives `weekStartsOn`, `weekNumbering`, and `weekendDays` from CLDR conventions.
- *
- * @param raw - A {@link ChartLocale} object, a BCP 47 language tag string, or `undefined`.
- * @returns A fully resolved {@link ChartLocale} with defaults applied.
- */
-declare function resolveChartLocale(raw: ChartLocale | string | undefined): ChartLocale;
-/**
- * Formats a week number according to the specified scheme.
- *
- * - `'iso'`: ISO 8601 (week 1 contains the first Thursday; Monday start).
- * - `'us'`: Week 1 contains January 1; Sunday start.
- * - `'simple'`: `Math.ceil(dayOfYear / 7)`.
- *
- * @param date - The date to compute the week number for.
- * @param scheme - The week numbering scheme: `'iso'`, `'us'`, or `'simple'`.
- * @returns The week number as a positive integer.
- */
-declare function formatWeekNumber(date: Date, scheme: 'iso' | 'us' | 'simple'): number;
-/**
- * Formats a label template by replacing `{0}` with the given argument.
- *
- * @param template - The template string containing `{0}` as placeholder.
- * @param arg - The value to substitute for `{0}`.
- * @returns The formatted string with the placeholder replaced.
- */
-declare function formatLabel(template: string, arg: string): string;
-//#endregion
 //#region src/lib/domain/dependencies.d.ts
 /**
  * Detects circular dependencies in the link graph using DFS tri-colour marking.
@@ -429,7 +401,7 @@ declare function routeLinks(links: ZodLinkInferred[], layouts: Map<number, BarLa
  * Use when referencing task fields in grid column schemas that apply
  * across a heterogeneous set of task kinds.
  */
-type TaskDataField = keyof ZodTaskInferred | 'endDate' | 'percentComplete' | 'open';
+type TaskDataField = keyof Task | 'endDate' | 'percentComplete' | 'open';
 type GridColumn = {
   id: string;
   header: string;
@@ -437,7 +409,7 @@ type GridColumn = {
   align?: 'left' | 'center' | 'right';
   visible?: boolean;
   field?: TaskDataField;
-  format?: (value: unknown, task: ZodTaskInferred, row: TaskNode, locale: ChartLocale) => string;
+  format?: (value: unknown, task: Task<Record<string, unknown>>, row: TaskNode, locale: ChartLocale) => string;
 };
 declare const DEFAULT_GRID_COLUMNS: GridColumn[];
 /**
@@ -517,6 +489,14 @@ type OnProgressChange<TTaskData = never, TLinkData = never> = (payload: {
   newPercentComplete: number;
   instance: GanttInstance<TTaskData, TLinkData>;
 }) => boolean | Promise<boolean>;
+type OnExpandCollapse<TTaskData = never, TLinkData = never> = (payload: {
+  task: Task<TTaskData>;
+  instance: GanttInstance<TTaskData, TLinkData>;
+}) => void | Promise<void>;
+type OnExpandCollapseAll<TTaskData = never, TLinkData = never> = (payload: {
+  tasks: Task<TTaskData>[];
+  instance: GanttInstance<TTaskData, TLinkData>;
+}) => void | Promise<void>;
 type OnTooltipText<TTaskData = never, TLinkData = never> = (payload: {
   task: Task<TTaskData>;
   instance: GanttInstance<TTaskData, TLinkData>;
@@ -531,6 +511,8 @@ type GanttCallbacks<TTaskData = never, TLinkData = never> = {
   onLinkClick?: OnLinkClick<TTaskData, TLinkData>;
   onLinkDblClick?: OnLinkDblClick<TTaskData, TLinkData>;
   onProgressChange?: OnProgressChange<TTaskData, TLinkData>;
+  onExpandCollapse?: OnExpandCollapse<TTaskData, TLinkData>;
+  onExpandCollapseAll?: OnExpandCollapseAll<TTaskData, TLinkData>;
   onTooltipText?: OnTooltipText<TTaskData, TLinkData>;
   onLeftPaneWidthChange?: (payload: {
     width: number;
@@ -563,6 +545,7 @@ type GanttOptions = {
   gridColumns?: GridColumn[];
   theme?: ThemeMode;
   showAddTaskButton?: boolean;
+  showTodayMarker?: boolean;
 };
 type GanttInstance<TTaskData = never, TLinkData = never> = {
   update: (input: GanttInputRaw<TTaskData, TLinkData>) => void;
@@ -666,5 +649,5 @@ declare class GanttError extends Error {
   constructor(code: GanttErrorCode, message: string);
 }
 //#endregion
-export { BAR_HEIGHT, BAR_Y_OFFSET, type BarLayout, CHART_LOCALE_DE_DE, CHART_LOCALE_EN_GB, CHART_LOCALE_EN_US, CHART_LOCALE_ES_ES, CHART_LOCALE_FR_FR, CHART_LOCALE_IT_IT, CHART_LOCALE_JA_JP, CHART_LOCALE_PT_PT, CHART_LOCALE_ZH_CN, type ChartLocale, DEFAULT_GRID_COLUMNS, DENSITY, EN_US_LABELS, GRID_COLUMN_FR_MIN_WIDTH, type GanttCallbacks, GanttChart, GanttError, type GanttErrorCode, type GanttInput, type GanttInputRaw, type GanttInstance, type GanttOptions, type GridColumn, type Link, type LinkType, 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, type Task, type TaskDataField, type TaskKind, type TaskNode, type ThemeMode, type TimeScale, addDays, addHours, buildTaskTree, computeLayout, createPixelMapper, deriveViewport, deriveWeekNumbering, deriveWeekStartsOn, deriveWeekendDays, detectCycles, diffDays, diffHours, flattenTree, formatLabel, formatWeekNumber, gridColumnDefaults, gridNaturalWidth, gridTemplateColumns, isParent, parseDate, resolveChartLocale, routeLinks, validateLinkRefs, visibleColumns };
+export { BAR_HEIGHT, BAR_Y_OFFSET, type BarLayout, type ChartLocale, DEFAULT_GRID_COLUMNS, DENSITY, EN_US_LABELS, GRID_COLUMN_FR_MIN_WIDTH, type GanttCallbacks, GanttChart, GanttError, type GanttErrorCode, type GanttInput, type GanttInputRaw, type GanttInstance, type GanttOptions, type GridColumn, type Link, type LinkType, type LocaleLabelKey, MILESTONE_HALF, MILESTONE_SIZE, type OnExpandCollapse, type OnExpandCollapseAll, 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, type Task, type TaskDataField, type TaskKind, type TaskNode, type ThemeMode, type TimeScale, addDays, addHours, buildTaskTree, computeLayout, createPixelMapper, deriveViewport, deriveWeekNumbering, deriveWeekStartsOn, deriveWeekendDays, detectCycles, diffDays, diffHours, flattenTree, formatLabel, formatWeekNumber, gridColumnDefaults, gridNaturalWidth, gridTemplateColumns, isParent, parseDate, resolveChartLocale, routeLinks, validateLinkRefs, visibleColumns };
 //# sourceMappingURL=index.d.mts.map