@editora/ui-core 0.1.23 → 0.1.25

package/README.md

@@ -252,11 +252,218 @@ and resize, and a toolbar for zoom, filter and sort. Give it `tasks` and `links`
   <img src="https://raw.githubusercontent.com/ajaykr089/Editora/main/packages/ui-core/docs/images/gantt.png" alt="A Gantt chart with a task bar for API contracts, a baseline under it, and an arrow to the QA sign-off milestone" width="900">
 </p>
 
-- `zoom`: `day`, `week`, `month`, `quarter` or `year`. `sort`: `none`, `start`, `end`, `label` or `progress`.
-- `bar-variant`: `solid`, `soft`, `striped`, `outline` or `glass`.
-- Dependency types: `e2s`, `s2s`, `e2e` and `s2e`.
-- Also: `readonly`, `show-toolbar`, `show-today`, `filter`, and `virtualized="false"` for small layouts (large task sets are
-  virtualized automatically).
+That is the whole setup for a basic chart. The rest of this section builds on it.
+
+### A full planner
+
+This one turns on most of the features at once: a two-level time header, weekends and a holiday shaded, parents that
+follow their children, scheduling that pushes the tasks after one you move, the critical path, dependencies you draw
+by dragging, and a date the host refuses to let slip. The chart draws what it is given and reports what the user does;
+the plan lives in your code, so every edit arrives as an event and you decide whether to keep it.
+
+```html
+<ui-gantt
+  id="planner"
+  zoom="week"
+  week-start="1"
+  bar-variant="soft"
+  columns='["label", "assignee", "start", "end", "progress"]'
+  non-working-days
+  auto-summary
+  cascade
+  schedule="auto"
+  critical-path
+  linkable
+  creatable
+></ui-gantt>
+
+<script type="module">
+  import '@editora/ui-core';
+
+  const planner = document.getElementById('planner');
+  const day = (offset) => {
+    const date = new Date();
+    date.setHours(0, 0, 0, 0);
+    date.setDate(date.getDate() + offset);
+    return date;
+  };
+
+  // The chart draws what it is given and reports what the user does; the plan lives here.
+  let tasks = [
+    { id: 'discovery', label: 'Discovery', type: 'summary' },
+    { id: 'research', label: 'User research', parent: 'discovery', start: day(-21), end: day(-12), progress: 100, assignee: 'Mina', baselineStart: day(-21), baselineEnd: day(-13) },
+    { id: 'interviews', label: 'Interviews', parent: 'discovery', start: day(-12), end: day(-5), progress: 100, assignee: 'Jonas' },
+    { id: 'scope', label: 'Scope signed off', parent: 'discovery', start: day(-5), type: 'milestone', tone: 'success' },
+    { id: 'build', label: 'Build', type: 'summary' },
+    { id: 'api', label: 'API and data model', parent: 'build', start: day(-4), end: day(10), progress: 70, assignee: 'Priya' },
+    {
+      id: 'ui',
+      label: 'Planner UI',
+      parent: 'build',
+      start: day(-2),
+      end: day(18),
+      progress: 45,
+      assignee: 'Tomás',
+      segments: [{ start: day(-2), end: day(5) }, { start: day(8), end: day(18) }]
+    },
+    { id: 'integration', label: 'Integration', parent: 'build', start: day(18), end: day(26), progress: 0, assignee: 'Priya' },
+    { id: 'launch', label: 'Launch', type: 'summary' },
+    { id: 'qa', label: 'QA and fixes', parent: 'launch', start: day(26), end: day(33), assignee: 'Aiko' },
+    { id: 'beta', label: 'Beta', parent: 'launch', start: day(33), end: day(40), assignee: 'Aiko' },
+    { id: 'release', label: 'Release', parent: 'launch', start: day(40), type: 'milestone', tone: 'danger' },
+    { id: 'docs', label: 'Write the docs', start: day(30), end: day(38), progress: 20, assignee: 'Sam' }
+  ];
+  let links = [
+    { id: 'l1', source: 'research', target: 'interviews' },
+    { id: 'l2', source: 'interviews', target: 'scope' },
+    { id: 'l3', source: 'scope', target: 'api', lag: 1 },
+    { id: 'l4', source: 'scope', target: 'ui', type: 's2s', lag: 3 },
+    { id: 'l5', source: 'api', target: 'integration' },
+    { id: 'l6', source: 'ui', target: 'integration' },
+    { id: 'l7', source: 'integration', target: 'qa' },
+    { id: 'l8', source: 'qa', target: 'beta' },
+    { id: 'l9', source: 'beta', target: 'release' },
+    { id: 'l10', source: 'beta', target: 'docs' } // docs are planned before beta ends: drawn red
+  ];
+  const sync = () => {
+    planner.tasks = tasks;
+    planner.links = links;
+  };
+  planner.holidays = [{ date: day(12), label: 'Founders day' }];
+  const patch = (id, changes) => {
+    tasks = tasks.map((task) => (task.id === id ? { ...task, ...changes } : task));
+  };
+  sync();
+
+  // Keep the release date: refuse any change that would push it.
+  planner.addEventListener('beforetaskchange', (event) => {
+    if (event.detail.affected.some((change) => change.id === 'release')) event.preventDefault();
+  });
+  planner.addEventListener('taskchange', ({ detail }) => {
+    patch(detail.id, { start: detail.start, end: detail.end });
+    sync();
+  });
+  planner.addEventListener('taskrename', ({ detail }) => {
+    patch(detail.id, { label: detail.label });
+    sync();
+  });
+  planner.addEventListener('taskcreate', ({ detail }) => {
+    const id = `task-${tasks.length + 1}`;
+    tasks = [...tasks, { id, label: 'New task', start: detail.start, end: detail.end, parent: detail.parent }];
+    sync();
+    planner.scrollToTask(id);
+  });
+  planner.addEventListener('linkcreate', ({ detail }) => {
+    links = [...links, { id: `l${links.length + 1}`, ...detail }];
+    sync();
+  });
+  planner.addEventListener('linkdelete', ({ detail }) => {
+    links = links.filter((link) => link.id !== detail.id);
+    sync();
+  });
+</script>
+```
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/ajaykr089/Editora/main/packages/ui-core/docs/images/gantt-planner.png" alt="A project planner: three summary rows, red critical-path bars joined by dependency arrows, shaded weekends and a holiday, a Today marker, a red dashed link for a task planned before its predecessor ends, and a tooltip on the Beta bar" width="900">
+</p>
+
+The red bars are the critical path (`critical-path`), the red dashed arrow is a dependency that is already broken
+(Write the docs is planned before Beta ends), the grey strip under User research is its baseline, and the dots on
+Beta are the handles `linkable` adds.
+
+### Timeline and display
+
+- `zoom`: `day`, `week`, `month`, `quarter`, `year` or `fit` (the whole project scaled to the chart's width, re-fitted when it is
+  resized). The time header has two rows (month over days or weeks, year over months or quarters), a pill marks today, and the chart
+  opens on today when it is off the first screen (`initial-scroll="start"` keeps the start).
+- `week-start` (`0` is Sunday) sets the first day of the week; it defaults to the locale's.
+- `bar-variant`: `solid`, `soft`, `striped`, `outline` or `glass`. Progress is drawn inside each bar, and a task with `segments` is drawn in parts,
+  each with its own progress. `sort`: `none`, `start`, `end`, `label` or `progress`.
+- Non-working time: `non-working-days` (the attribute alone means the weekend, or `0,6` / `[1,2]`) and `holidays` (`["2026-12-25", {"date": "2026-12-26", "label": "Boxing Day"}]`)
+  shade those days behind the rows (not at month scales and wider, where a day is a few pixels) and mute them in the day header. They are shown, not scheduled
+  around: task lengths are calendar days.
+- Size: by default the chart grows with its rows up to 620px (`max-height="60vh"` or the `--ui-gantt-max-height` variable change that); add
+  `fill` and give the element a height (or a flex/grid cell) and it fills it, with the rows scrolling inside. Below 640px of width only the
+  name column is kept. Large task sets (over 240 rows) are virtualized automatically; `virtualized="false"` turns that off.
+- Dates are calendar days (`YYYY-MM-DD`). A time or offset after the day (`2026-03-02T23:30:00Z`) is ignored, so a task never moves a
+  day with the viewer's time zone; `taskchange` reports plain `YYYY-MM-DD`.
+- Translate every word with `labels` (a JSON object with any subset of the label keys, e.g. `{"title": "Planning", "zoomWeek": "semaine"}`) and
+  set `locale` (`fr-FR`) for month names, date formats and the first day of the week.
+
+### Task list
+
+- Choose the columns with `columns` (`["label", "assignee", "start", "end", "duration", "progress"]`, or objects with a `label` and a
+  `width`) and size the list with `grid-width`; a splitter on its edge resizes it (mouse, touch, or the arrow keys) and fires `gridresize`.
+- Parents: opening or closing a branch fires `tasktoggle`. `auto-summary` makes a parent span its children and take their progress (weighted by length)
+  when it has none; `cascade` lets you move a parent and everything under it together (`beforetaskchange` lists the tasks it moves in `affected`,
+  `taskchange` fires for each).
+
+### Dependencies and scheduling
+
+- A link may carry a `lag` (days) and its `type` says what it ties: `e2s` (the default), `s2s`, `e2e` or `s2e`. A link whose target is too early is
+  drawn red and dashed.
+- `schedule="auto"` also pushes the tasks that follow a task you move (later only, keeping their length, down the chain, as one change you can
+  refuse in `beforetaskchange`); `schedule="off"` turns both off. The pushing counts calendar days.
+- `critical-path` computes the critical path from the links (no slack on a chain that is tight all the way) and draws those bars as critical, on top of any
+  task you flag `critical`.
+- `linkable` shows dots beside each bar: drag one onto another bar and the chart fires `linkcreate` with the source, the target and the type the two ends
+  give (`e2s`, `s2s`, `e2e`, `s2e`); click a link to select it and press Delete to get `linkdelete`. As with tasks, your code owns the data.
+
+### Editing
+
+- Dragging: a bar can be dragged, resized from its ends, or moved with the arrow keys (Shift extends the end). The chart scrolls when a drag is held
+  near the left or right edge, Escape cancels it, and `snap="week"` or `snap="month"` snaps it to whole weeks or months. `beforetaskchange`
+  (cancelable) fires before the dates change, so a host can refuse the change with `event.preventDefault()`; `taskchange` fires after.
+- Rename in place: double-click a task's name (or press F2 on a row or a bar). Enter or leaving the field keeps it and fires `taskrename`
+  (cancelable), Escape drops it.
+- With `creatable` there is a **+ Add task** button, and a double-click on empty timeline space does the same for that
+  day: the chart fires `taskcreate` with the dates and the neighbour and your code adds the task. Nothing is written to your data by the chart.
+- `readonly` turns all of this off and keeps the browsing.
+
+### Keyboard and accessibility
+
+- Tab enters the task list once (a row) and once more for the bars. On a row, Up/Down, Home/End and PageUp/PageDown move between rows, Right
+  opens a branch or steps into it, Left closes it or climbs to the parent, Enter or Space selects. On a bar the same keys move between rows, and
+  Left/Right move the bar a day (Shift: extend the end), Delete asks to remove it, and Escape closes the tooltip.
+- Each bar is named for assistive technology with its dates, progress, owner and critical flag, and shows the same facts in a tooltip on
+  hover or keyboard focus. While you drag a bar, the tooltip shows the dates it would take. Bars and the touch targets of the splitter and the
+  link handles grow on touch screens.
+
+### Export and print
+
+`exportSvg()` returns the whole chart (not just the part on screen) as a standalone SVG string, and the chart prints as a whole (no scroll
+area, no sticky headers, no controls; use `zoom="fit"` for a wide project).
+
+### Reference
+
+| Attribute | Values |
+| --- | --- |
+| `zoom` | `day`, `week` (default), `month`, `quarter`, `year`, `fit` |
+| `week-start`, `locale`, `labels` | first weekday (`0`-`6`), a locale tag, a JSON object of label overrides |
+| `bar-variant`, `sort`, `variant` | bar skin, sort key, `contrast` for a dark surface |
+| `columns`, `grid-width` | task list columns and width |
+| `fill`, `max-height`, `virtualized` | sizing and row virtualization |
+| `non-working-days`, `holidays` | shaded days: weekdays, dates |
+| `auto-summary`, `cascade` | parents follow their children, parents move their children |
+| `schedule`, `critical-path` | `auto` pushes successors, red critical bars |
+| `linkable`, `creatable`, `readonly`, `snap`, `initial-scroll` | editing and scrolling behaviour |
+| `filter`, `show-toolbar`, `show-today`, `headless` | toolbar |
+
+| Event | `detail` |
+| --- | --- |
+| `beforetaskchange` (cancelable) | `{ id, start, end, previousStart, previousEnd, source, affected }`, `affected` lists the other tasks the change moves in the same shape |
+| `taskchange` | `{ id, start, end }`, once for each task that moved |
+| `taskselect`, `taskdelete` | `{ id }` |
+| `tasktoggle` | `{ id, open }` |
+| `taskrename` (cancelable) | `{ id, label, previousLabel }` |
+| `taskcreate` | `{ start, end, parent, after }` |
+| `linkcreate` | `{ source, target, type }` |
+| `linkselect`, `linkdelete` | `{ id, source, target, type }` |
+| `zoomchange`, `sortchange`, `filterchange`, `gridresize` | `{ zoom }`, `{ sort }`, `{ filter }`, `{ width }` |
+
+Methods: `scrollToDate(date)`, `scrollToTask(id)`, `toggleTask(id, open?)`, `expandAll()`, `collapseAll()` and `exportSvg()`. `tasks`, `links`
+and `holidays` are also properties that take arrays (with `Date`s if you like).
 
 ## Promise dialogs
 
@@ -408,6 +615,9 @@ Working examples:
 [guide](https://github.com/ajaykr089/Editora/blob/main/packages/ui-core/docs/FRAMEWORK_DIRECT_USAGE.md). For React,
 use [`@editora/ui-react`](https://www.npmjs.com/package/@editora/ui-react).
 
+`@editora/ui-vue`, `@editora/ui-svelte` and `@editora/ui-angular` are deprecated: they never grew past a few stub
+components. Use `@editora/ui-core` directly instead.
+
 ## Good to know
 
 - Components register when their module is imported, so the package is marked `sideEffects: true`. Import it before the

package/dist/components/gantt-schedule.d.ts

@@ -0,0 +1,79 @@
+export type SchedTask = {
+    id: string;
+    start: number;
+    end: number;
+    parent?: string;
+    type?: 'task' | 'summary' | 'milestone';
+    readonly?: boolean;
+    progress?: number;
+};
+export type LinkType = 'e2s' | 's2s' | 'e2e' | 's2e';
+export type SchedLink = {
+    id: string;
+    source: string;
+    target: string;
+    type: LinkType;
+    lag: number;
+};
+/** A date moved by whole calendar days (DST-safe, unlike adding 24 hours). */
+export declare function shiftDays(ms: number, days: number): number;
+/** Whole days between two local-midnight timestamps. */
+export declare function daysBetween(from: number, to: number): number;
+/** Every task under `id`, at any depth (a parent that points back into its own branch is not followed twice). */
+export declare function descendantsOf(tasks: SchedTask[], id: string): SchedTask[];
+export type RolledUp = {
+    start: number;
+    end: number;
+    progress?: number;
+};
+/**
+ * What each parent's dates and progress are when they follow their children: the earliest start and the latest end
+ * below it, and the progress of the children weighted by their length (only the children that have one). Computed
+ * from the bottom up, so a parent of parents works. Tasks without children are not in the result.
+ */
+export declare function rollUp(tasks: SchedTask[]): Map<string, RolledUp>;
+/**
+ * The earliest the target may start (for `e2s` and `s2s`) or end (for `e2e` and `s2e`) given where the source is: the
+ * source's end or start, plus the link's lag in days (which may be negative).
+ */
+export declare function constraintBound(link: SchedLink, source: {
+    start: number;
+    end: number;
+}): {
+    side: 'start' | 'end';
+    min: number;
+};
+export declare function linkSatisfied(link: SchedLink, source: {
+    start: number;
+    end: number;
+}, target: {
+    start: number;
+    end: number;
+}): boolean;
+/** The ids of the links whose target starts or ends earlier than its source allows. A link to a missing task is not one. */
+export declare function violatedLinks(tasks: SchedTask[], links: SchedLink[]): Set<string>;
+export type TaskMove = {
+    id: string;
+    start: number;
+    end: number;
+};
+/**
+ * After some tasks have moved (`moved`: id to their new dates), push the tasks that follow them later until every link holds
+ * again, keeping each pushed task's length. Only forward: a task is never pulled earlier. A read-only task is not pushed (its
+ * link stays violated), and with `cascade` the tasks under a pushed parent go with it. Returns the tasks that changed beyond
+ * `moved`, with their final dates, and gives up on a task after as many pushes as there are tasks (a cycle of links).
+ */
+export declare function pushSuccessors(tasks: SchedTask[], links: SchedLink[], moved: Map<string, {
+    start: number;
+    end: number;
+}>, cascade?: boolean): TaskMove[];
+/**
+ * The critical path of the schedule as it stands: the tasks with no slack on a chain of links that is tight all the way.
+ * Slack is how far a task could finish later without a link pushing something past the end of the project, found with a
+ * backward pass over the links (every type and lag). Only tasks without children count (a parent is its children), a
+ * task without links is never critical, and neither is one whose own incoming links all have room: a task is critical
+ * when it has no slack and either nothing precedes it or something that does is tight against it. Tasks caught in a
+ * cycle of links are left out.
+ */
+export declare function criticalPath(tasks: SchedTask[], links: SchedLink[]): Set<string>;
+//# sourceMappingURL=gantt-schedule.d.ts.map

package/dist/components/gantt-schedule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gantt-schedule.d.ts","sourceRoot":"","sources":["../../src/components/gantt-schedule.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,SAAS,GAAG;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,WAAW,CAAC;IACxC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,CAAC;AAErD,MAAM,MAAM,SAAS,GAAG;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC;AAEpG,8EAA8E;AAC9E,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAK1D;AAED,wDAAwD;AACxD,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAE5D;AAcD,iHAAiH;AACjH,wBAAgB,aAAa,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE,EAAE,EAAE,MAAM,GAAG,SAAS,EAAE,CAczE;AAED,MAAM,MAAM,QAAQ,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAEzE;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAgChE;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,OAAO,GAAG,KAAK,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAG/H;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,EAAE,MAAM,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAGtI;AAED,4HAA4H;AAC5H,wBAAgB,aAAa,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,GAAG,CAAC,MAAM,CAAC,CASjF;AAED,MAAM,MAAM,QAAQ,GAAG;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC;AAElE;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC,EAAE,OAAO,UAAQ,GAAG,QAAQ,EAAE,CAoDtJ;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,GAAG,CAAC,MAAM,CAAC,CA6DhF"}

package/dist/components/ui-gantt.d.ts

@@ -1,7 +1,54 @@
 import { ElementBase } from '../ElementBase';
+/** Every word the component shows or announces, so a host can translate it. `tasksCount` takes {shown} and {total}. */
+export type GanttLabels = {
+    title: string;
+    tasksCount: string;
+    filterPlaceholder: string;
+    filterLabel: string;
+    sortLabel: string;
+    sortManual: string;
+    sortStart: string;
+    sortEnd: string;
+    sortName: string;
+    sortProgress: string;
+    zoomDay: string;
+    zoomWeek: string;
+    zoomMonth: string;
+    zoomQuarter: string;
+    zoomYear: string;
+    zoomFit: string;
+    zoomFitTitle: string;
+    columnTask: string;
+    columnOwner: string;
+    columnDates: string;
+    columnProgress: string;
+    columnStart: string;
+    columnEnd: string;
+    columnDuration: string;
+    splitter: string;
+    scrollToToday: string;
+    addTask: string;
+    rename: string;
+    linkViolated: string;
+    empty: string;
+    noMatches: string;
+    expand: string;
+    collapse: string;
+    timeline: string;
+    today: string;
+    summary: string;
+    milestone: string;
+    to: string;
+    complete: string;
+    assigned: string;
+    critical: string;
+};
 export declare class UIGantt extends ElementBase {
     static get observedAttributes(): string[];
+    private focusRequest;
     private collapsed;
+    /** Task ids already seen, so `open: false` collapses a branch once and never fights the user's toggle. */
+    private seededIds;
     private overrides;
     private drag;
     private selectedId;
@@ -9,6 +56,31 @@ export declare class UIGantt extends ElementBase {
     private viewportTop;
     private viewportLeft;
     private viewportWidth;
+    private hostWidth;
+    /** Where the scroll area was when the header cells and shading were last built: they cover a window around it. */
+    private renderedLeft;
+    /** A smooth scroll in progress, so a render that replaces the scroll area can carry on with it. */
+    private smoothTarget;
+    private selectedLinkId;
+    private linking;
+    private editingId;
+    private editingValue;
+    private suppressBlur;
+    private layoutInfo;
+    private visibleIds;
+    private initialScrollPending;
+    private pendingReveal;
+    private hostHeight;
+    private virtualizedNow;
+    private gridBounds;
+    private descriptions;
+    private tipTimer;
+    private pointerFocus;
+    /** Width of the scroll area's vertical scrollbar, measured after a render; `fit` leaves room for it. */
+    private scrollbarWidth;
+    /** The pixels per day the last render used, for dragging. */
+    private dayWidthNow;
+    private resizeObserver;
     private viewportHeight;
     private renderedFirstRow;
     private renderedLastRow;
@@ -16,21 +88,133 @@ export declare class UIGantt extends ElementBase {
     private overridesVersion;
     private taskCacheRaw;
     private taskCacheVersion;
+    private taskCacheAuto;
+    private taskCacheCritical;
     private taskCache;
     private linkCacheRaw;
     private linkCache;
     private visibleCacheKey;
     private visibleCache;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    private labelsRaw;
+    private labelsCache;
+    /** The labels: the defaults with whatever the `labels` attribute (a JSON object) overrides. */
+    private labelSet;
     protected render(): void;
+    /**
+     * Every render replaces the whole shadow tree, which drops focus. Remember which control had it so
+     * the replacement can take it back (and the caret, for the filter box); without this the filter
+     * accepts one character per click.
+     */
+    private captureFocus;
+    private restoreFocus;
     private bindEvents;
+    private snapUnit;
+    /** The nearest boundary of the snap unit (a week start, a 1st of the month), or the day itself. */
+    private snapDate;
+    private startDrag;
+    /** The dates the bar would take for the pointer's position, snapped, and a repaint of the bar and the tooltip. */
+    private updateDrag;
+    /** While a drag is held near the left or right edge of the timeline the chart scrolls, faster the nearer the edge. */
+    private autoScrollLoop;
+    /** Finish a drag: drop it (commit the new dates), or cancel it (the bar goes back where it was). */
+    private endDrag;
+    /**
+     * With `cascade`, moving a parent moves everything under it by the same number of days (a read-only task stays
+     * put). Anything else is the one change.
+     */
+    private plan;
+    private withCascade;
+    /**
+     * Apply a change to dates. First a cancelable `beforetaskchange` (a host that rejects the change calls
+     * preventDefault and nothing moves), then the new dates are kept and `taskchange` fires for each task.
+     */
+    private applyChanges;
+    /**
+     * Keyboard on a bar. Moving between rows (and selecting) works on every bar, summaries and read-only
+     * charts included; only the keys that change dates or delete need an editable bar.
+     */
+    private handleBarKeydown;
+    /**
+     * Show the tooltip for a bar: above its visible part, centred, kept inside the scroll area; below the bar when
+     * there is no room under the sticky header.
+     */
+    private showTip;
+    private hideTip;
+    /** Links: select one by clicking it (then Delete asks to remove it), and with `linkable` draw new ones from the dots beside a bar. */
+    private bindLinks;
+    private startLink;
+    /** The rubber-band line follows the pointer; the bar (or dot) under it, and which end of it, is the target. */
+    private updateLink;
+    /** Let go: a drop on another task asks the host for a link (`linkcreate`), anywhere else nothing happens. */
+    private endLink;
+    /** Rename a task in place: the name becomes a text field. Does nothing in a read-only chart or for a read-only task. */
+    private startRename;
+    /** Leave the rename field: keep the new name (when `save` and it is not empty or unchanged and nobody refuses it) or drop it. */
+    private finishRename;
+    /** Create a task: the host is told where (`taskcreate`) and adds it; nothing is added here. */
+    private requestCreate;
+    private bindEditing;
+    /** The task list is a treegrid: a row takes focus and the arrow keys move around it. */
+    private bindRows;
+    /** Drag the splitter (or use the arrow keys on it) to resize the task list; it is kept in `grid-width`. */
+    private bindSplitters;
+    private bindTooltips;
+    /** The tasks as an array. Setting it writes the `tasks` attribute (dates may be `Date`s: they become `YYYY-MM-DD`). */
+    get tasks(): Array<Record<string, unknown>>;
+    set tasks(value: Array<Record<string, unknown>> | null | undefined);
+    /** The holidays as an array of `YYYY-MM-DD` strings or `{ date, label }` objects. Setting it writes the attribute (a `Date` becomes its local day). */
+    get holidays(): Array<unknown>;
+    set holidays(value: Array<unknown> | null | undefined);
+    /** The links as an array. Setting it writes the `links` attribute. */
+    get links(): Array<Record<string, unknown>>;
+    set links(value: Array<Record<string, unknown>> | null | undefined);
+    private resolveBehavior;
+    private scrollViewport;
+    /**
+     * Scroll the timeline to a date: a `YYYY-MM-DD` string, a `Date`, a timestamp, or `"today"`. `align` is `center`
+     * (the default) or `start`, which leaves a little room before the date. Does nothing for a date that is not valid.
+     */
+    scrollToDate(date: string | number | Date, options?: {
+        behavior?: ScrollBehavior;
+        align?: 'center' | 'start';
+    }): void;
+    private leftFor;
+    /**
+     * Bring a task into view: open the branches above it, then scroll its row (and its bar) on screen when they are
+     * not. Returns false for an id that is not there or is filtered out.
+     */
+    scrollToTask(id: string, options?: {
+        behavior?: ScrollBehavior;
+    }): boolean;
+    private reveal;
+    /** Open or close a branch (`open` omitted toggles it) and fire `tasktoggle`. */
+    toggleTask(id: string, open?: boolean): void;
+    expandAll(): void;
+    collapseAll(): void;
+    /**
+     * The whole chart as a standalone SVG string (not just the part on screen): the time header, the task names, the bars with
+     * their progress, baselines, parts, milestones and links, the today line and any non-working days. Rows follow the current
+     * filter, sort and collapsed branches; the scale is the one on screen. Colours are the theme's resolved at this moment.
+     * Returns an empty string when there is nothing to draw.
+     */
+    exportSvg(): string;
     private rangeMin;
     private selectTask;
-    private selectAdjacentTask;
+    /** Select a task and give focus to its row or its bar, scrolling it into view first. */
+    private focusTask;
+    /**
+     * Keyboard movement between rows, the same from a row and from a bar: Up and Down, Home and End, PageUp and PageDown. From a row,
+     * Right and Left also open, close and climb the tree. Returns whether the key was one of these.
+     */
+    private navigate;
     private captureViewport;
     private getTasks;
+    private seedCollapsed;
     private getLinks;
     private getVisibleTasks;
     private bumpOverrides;
-    protected shouldRenderOnAttributeChange(name: string, _oldValue: string | null, _newValue: string | null): boolean;
+    protected shouldRenderOnAttributeChange(name: string, oldValue: string | null, newValue: string | null): boolean;
 }
 //# sourceMappingURL=ui-gantt.d.ts.map

package/dist/components/ui-gantt.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ui-gantt.d.ts","sourceRoot":"","sources":["../../src/components/ui-gantt.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AA+/B7C,qBAAa,OAAQ,SAAQ,WAAW;IACtC,MAAM,KAAK,kBAAkB,aAE5B;IAED,OAAO,CAAC,SAAS,CAAqB;IACtC,OAAO,CAAC,SAAS,CAAyC;IAC1D,OAAO,CAAC,IAAI,CAA0B;IACtC,OAAO,CAAC,UAAU,CAAuB;IACzC,OAAO,CAAC,cAAc,CAAM;IAC5B,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,aAAa,CAAQ;IAC7B,OAAO,CAAC,cAAc,CAAO;IAC7B,OAAO,CAAC,gBAAgB,CAAK;IAC7B,OAAO,CAAC,eAAe,CAAK;IAC5B,OAAO,CAAC,WAAW,CAAuB;IAC1C,OAAO,CAAC,gBAAgB,CAAK;IAC7B,OAAO,CAAC,YAAY,CAAuB;IAC3C,OAAO,CAAC,gBAAgB,CAAM;IAC9B,OAAO,CAAC,SAAS,CAAmB;IACpC,OAAO,CAAC,YAAY,CAAuB;IAC3C,OAAO,CAAC,SAAS,CAAmB;IACpC,OAAO,CAAC,eAAe,CAAM;IAC7B,OAAO,CAAC,YAAY,CAAqB;cAEtB,MAAM,IAAI,IAAI;IAmMjC,OAAO,CAAC,UAAU;IAgPlB,OAAO,CAAC,QAAQ;IAMhB,OAAO,CAAC,UAAU;IAWlB,OAAO,CAAC,kBAAkB;IAiB1B,OAAO,CAAC,eAAe;IASvB,OAAO,CAAC,QAAQ;IAUhB,OAAO,CAAC,QAAQ;IAQhB,OAAO,CAAC,eAAe;IASvB,OAAO,CAAC,aAAa;cAMF,6BAA6B,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO;CAU5H"}
+{"version":3,"file":"ui-gantt.d.ts","sourceRoot":"","sources":["../../src/components/ui-gantt.ts"],"names":[],"mappings":"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"}