@dxos/react-ui-trace 0.11.1 → 0.14.0

package/dist/types/src/components/Gantt/Gantt.d.ts

@@ -1,38 +1,91 @@
-import React, { type ReactNode } from 'react';
-import { type ThemedClassName } from '@dxos/react-ui';
-export type GanttLaneKind = 'session' | 'task';
+import React, { type PropsWithChildren, type ReactNode } from 'react';
+import * as Util from '@dxos/react-ui/Util';
+import { type Hue } from '@dxos/ui-theme';
+import { type GanttAxis } from './gantt-scale.ts';
+/**
+ * The chart's vocabulary is groups, lanes, segments and markers — deliberately not the vocabulary of
+ * whatever is being charted. A host maps its own nouns onto these (a process onto a group, a task
+ * onto a lane, a status change onto a marker) and the chart stays ignorant of what they mean.
+ */
 export type GanttLaneStatus = 'pending' | 'blocked' | 'running' | 'review' | 'done' | 'failed';
-export type GanttMarkerKind = 'request' | 'operation' | 'tool' | 'message' | 'error' | 'delegation' | 'task';
+/**
+ * A band of related lanes, enclosed by one rectangle. Pure structure: the lanes inside carry the
+ * labels, so a group needs no name of its own.
+ */
+export type GanttGroup = {
+    id: string;
+    /** Indents under another group; a nested group's band is drawn after its parent's. */
+    parentId?: string;
+};
+/** One stretch during which a lane was worked. `end` is absent while the stretch is still open. */
+export type GanttSegment = {
+    start: number;
+    end?: number;
+};
+/** A fact the host wants beside a lane: the legend shows it in place of, or over, the lane's title, and never interprets it. */
+export type GanttMeta = {
+    label: string;
+    title?: string;
+};
+/**
+ * One row. Its three references are deliberately distinct: `groupId` is which band it sits in,
+ * `parentId` is what it nests under, and `openedFrom` is what caused it. Collapsing any two of them
+ * into one edge is what left the previous model unable to hold a task hierarchy and a process tree
+ * at the same time.
+ */
 export type GanttLane = {
     id: string;
-    kind: GanttLaneKind;
     label: string;
     status: GanttLaneStatus;
-    start?: number;
-    end?: number;
+    /** The band this lane sits in. */
+    groupId?: string;
+    /** Indents under another lane of the same group — nesting, nothing more. */
     parentId?: string;
-    taskId?: string;
-    blockedOn?: readonly string[];
-    delegatedFrom?: {
+    /** Every stretch this lane was worked. A lane with none exists but has no extent, so no bar. */
+    segments?: readonly GanttSegment[];
+    /** The node this lane opened out of, on another lane. */
+    openedFrom?: {
         laneId: string;
         markerId: string;
     };
-    tokens?: {
-        input: number;
-        output: number;
-        total: number;
+    /**
+     * The node this lane's result came back into, on another lane — the mirror of `openedFrom`, and a
+     * separate fact: a lane can open out of another and end without ever reporting back.
+     */
+    closedInto?: {
+        laneId: string;
+        markerId: string;
     };
-    toolCalls?: number;
+    /** Colours the legend dot, the bar, its nodes and its thread in place of the status colour. */
+    hue?: Hue;
+    /** Lanes this one waits on. */
+    blockedOn?: readonly string[];
+    meta?: readonly GanttMeta[];
 };
 export type GanttMarker = {
     id: string;
     laneId: string;
-    kind: GanttMarkerKind;
+    /** The host's own word for what happened; shown in the hover card, never interpreted. */
+    kind?: string;
     timestamp: number;
     label: string;
     level?: 'info' | 'warn' | 'error';
+    /**
+     * A wait begun at this node and since ended — a question put to the reader and answered. Drawn as a
+     * dashed line along the lane to the node that ended it; a wait still open draws nothing, so the lane
+     * ends at the question until the answer lands.
+     */
+    wait?: {
+        until: string;
+    };
+    /** Awaiting a response — an unanswered question. The node pings until the response arrives. */
+    pending?: boolean;
 };
+/** What the legend's column shows per lane: its title, or the facts the host attached to it. */
+export type GanttLegendMode = 'title' | 'stats';
 export type GanttData = {
+    /** The bands. A chart with none draws its lanes plain, with no rectangles. */
+    groups?: readonly GanttGroup[];
     lanes: readonly GanttLane[];
     markers?: readonly GanttMarker[];
     range?: {
@@ -41,15 +94,48 @@ export type GanttData = {
     };
     now?: number;
     showNow?: boolean;
+    /**
+     * What the horizontal axis measures: `unit` steps once per event and scrolls to follow the newest;
+     * `time` fits the whole range to the width and eases to new bounds. `unit` by default.
+     */
+    axis?: GanttAxis;
+    /** Pixels per event on the `unit` axis. */
+    unitStep?: number;
+    /**
+     * Slide a newly arrived event out of the one before it — out of the node that opened its lane, for
+     * a lane's first — and grow its bar to meet it, on the `unit` axis. Only events that arrive while the
+     * chart is on screen animate, so a chart that is merely mounted is still.
+     */
+    animate?: boolean;
     onLaneSelect?: (lane: GanttLane) => void;
     onMarkerSelect?: (marker: GanttMarker) => void;
+    /** Called by `Gantt.AxisToggle`; without it the toggle does not render. */
+    onAxisChange?: (axis: GanttAxis) => void;
+    /** What the legend's column shows; held by the root when absent, `title` to begin with. */
+    legend?: GanttLegendMode;
+    /** Called by `Gantt.LegendToggle`. */
+    onLegendChange?: (legend: GanttLegendMode) => void;
 };
-type GanttRootProps = ThemedClassName<GanttData & {
+type GanttRootProps = Util.ThemedClassName<GanttData & {
     children?: ReactNode;
 }>;
-type GanttLegendProps = ThemedClassName<{}>;
-type GanttMetaProps = ThemedClassName<{}>;
-type GanttChartProps = ThemedClassName<{}>;
+type GanttLegendProps = Util.ThemedClassName<PropsWithChildren>;
+type GanttAxisToggleProps = {};
+/**
+ * Switches the chart between its axes: `time`, the run fitted to the width, and `unit`, one step per
+ * event. Renders nothing unless the root was given `onAxisChange`, since the axis is the host's state.
+ */
+declare const GanttAxisToggle: {
+    (_: GanttAxisToggleProps): React.JSX.Element | null;
+    displayName: string;
+};
+type GanttLegendToggleProps = {};
+/** Switches the legend's column between the lanes' titles and their stats. */
+declare const GanttLegendToggle: {
+    (_: GanttLegendToggleProps): React.JSX.Element;
+    displayName: string;
+};
+type GanttChartProps = Util.ThemedClassName<{}>;
 export declare const Gantt: {
     Root: React.ForwardRefExoticComponent<Omit<GanttRootProps, "className"> & {
         classNames?: import("@dxos/ui-types").ClassNameValue;
@@ -57,12 +143,11 @@ export declare const Gantt: {
     Legend: React.ForwardRefExoticComponent<Omit<GanttLegendProps, "className"> & {
         classNames?: import("@dxos/ui-types").ClassNameValue;
     } & Pick<React.HTMLAttributes<Element>, "children" | "role" | "style"> & React.RefAttributes<HTMLDivElement>>;
+    AxisToggle: typeof GanttAxisToggle;
+    LegendToggle: typeof GanttLegendToggle;
     Chart: React.ForwardRefExoticComponent<Omit<{}, "className"> & {
         classNames?: import("@dxos/ui-types").ClassNameValue;
     } & React.RefAttributes<SVGSVGElement>>;
-    Meta: React.ForwardRefExoticComponent<Omit<GanttMetaProps, "className"> & {
-        classNames?: import("@dxos/ui-types").ClassNameValue;
-    } & Pick<React.HTMLAttributes<Element>, "children" | "role" | "style"> & React.RefAttributes<HTMLDivElement>>;
 };
-export type { GanttChartProps, GanttLegendProps, GanttMetaProps, GanttRootProps };
+export type { GanttAxisToggleProps, GanttChartProps, GanttLegendProps, GanttLegendToggleProps, GanttRootProps };
 //# sourceMappingURL=Gantt.d.ts.map

package/dist/types/src/components/Gantt/Gantt.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Gantt.d.ts","sourceRoot":"","sources":["../../../../../src/components/Gantt/Gantt.tsx"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,EAAsB,KAAK,SAAS,EAAoD,MAAM,OAAO,CAAC;AAGpH,OAAO,EAAa,KAAK,eAAe,EAA+B,MAAM,gBAAgB,CAAC;AAI9F,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,MAAM,CAAC;AAC/C,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,MAAM,GAAG,QAAQ,CAAC;AAC/F,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,WAAW,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,YAAY,GAAG,MAAM,CAAC;AAE7G,MAAM,MAAM,SAAS,GAAG;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,aAAa,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,eAAe,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9B,aAAa,CAAC,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IACrD,MAAM,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1D,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,eAAe,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;CACnC,CAAC;AA6HF,MAAM,MAAM,SAAS,GAAG;IACtB,KAAK,EAAE,SAAS,SAAS,EAAE,CAAC;IAC5B,OAAO,CAAC,EAAE,SAAS,WAAW,EAAE,CAAC;IACjC,KAAK,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IACvC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,SAAS,KAAK,IAAI,CAAC;IACzC,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,IAAI,CAAC;CAChD,CAAC;AAkBF,KAAK,cAAc,GAAG,eAAe,CAAC,SAAS,GAAG;IAAE,QAAQ,CAAC,EAAE,SAAS,CAAA;CAAE,CAAC,CAAC;AA4D5E,KAAK,gBAAgB,GAAG,eAAe,CAAC,EAAE,CAAC,CAAC;AA+C5C,KAAK,cAAc,GAAG,eAAe,CAAC,EAAE,CAAC,CAAC;AA8B1C,KAAK,eAAe,GAAG,eAAe,CAAC,EAAE,CAAC,CAAC;AA+P3C,eAAO,MAAM,KAAK;IAChB,IAAI;;;IACJ,MAAM;;;IACN,KAAK;;;IACL,IAAI;;;CACL,CAAC;AAEF,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,cAAc,EAAE,cAAc,EAAE,CAAC"}
+{"version":3,"file":"Gantt.d.ts","sourceRoot":"","sources":["../../../../../src/components/Gantt/Gantt.tsx"],"names":[],"mappings":"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"}

package/dist/types/src/components/Gantt/Gantt.stories.d.ts

@@ -1,16 +1,39 @@
 import { type StoryObj } from '@storybook/react-vite';
 import React from 'react';
-import { type GanttData, type GanttLane, type GanttMarker } from './Gantt.tsx';
-type StoryArgs = GanttData & {
+import { type GanttData, type GanttGroup, type GanttLane, type GanttMarker } from './Gantt.tsx';
+type EventStreamOptions = {
+    /** How often an event arrives, in milliseconds. The stream is static without it. */
+    interval?: number;
+    /** The supervisor lane: what spawns the first children, and what they report back to. */
+    laneId: string;
+    /** How far each arrival advances the clock — the axis reads the instant, `interval` is real time. */
+    step: number;
+    /** The supervisor opens another child every so many arrivals. */
+    spawnEvery?: number;
+    /** How many events of its own a lane runs before it is finished, inclusive. */
+    childEvents?: readonly [number, number];
+    /** Percent chance a direct child delegates rather than works; halved at each level below it. */
+    nestedChance?: number;
+    /**
+     * How many lanes may be opened at each depth, deepest last. This is what makes the run finite: the
+     * budget is spent, everything in flight reports back, and the chart comes to rest — a demo that
+     * grows for as long as it is left open never shows what finishing looks like.
+     */
+    maxSpawns?: readonly number[];
+};
+type StoryArgs = GanttData & Partial<EventStreamOptions> & {
     /** Render the drawing alone, as a host that already lists the lanes does. */
     chartOnly?: boolean;
+    /** Show the data the chart was drawn from beneath it. */
+    inspect?: boolean;
 };
-declare const DefaultStory: (props: StoryArgs) => React.JSX.Element;
+declare const DefaultStory: ({ chartOnly, inspect, interval, laneId, step, spawnEvery, childEvents, nestedChance, maxSpawns, ...data }: StoryArgs) => React.JSX.Element;
 declare const meta: {
     title: string;
     render: typeof DefaultStory;
     decorators: import("@storybook/react").Decorator[];
     args: {
+        groups: GanttGroup[];
         lanes: GanttLane[];
         markers: GanttMarker[];
         now: number;
@@ -18,6 +41,7 @@ declare const meta: {
             start: number;
             end: number;
         };
+        inspect: true;
         onLaneSelect: (lane: GanttLane) => void;
         onMarkerSelect: (marker: GanttMarker) => void;
     };
@@ -26,5 +50,51 @@ export default meta;
 type Story = StoryObj<typeof meta>;
 export declare const Default: Story;
 export declare const ChartOnly: Story;
+/** The time axis under a stream: every arrival widens the range, so the whole history shifts left. */
 export declare const Live: Story;
+/** The same run on the fitted axis, for contrast with {@link Live}: gaps argue for space by duration. */
+export declare const TimeAxis: Story;
+/** The primitives alone: one lane, one event a second, each opening out of the one before it. */
+export declare const SingleLane: Story;
+/**
+ * The supervisor fans out: every third arrival opens another child, and a child may delegate again
+ * rather than work — less likely the deeper it already is. Each lane runs a handful of events,
+ * reports back into a node of its own, and waits on anything it opened before it does.
+ *
+ * The run finishes: `maxSpawns` bounds how many lanes each depth may open, so the branches unwind
+ * from the leaves up, the supervisor closes its own span, and the chart comes to rest.
+ */
+export declare const Delegation: Story;
+/** One band, one lane, six events. */
+export declare const OneLane: Story;
+/** One band, four lanes over different spans — one worked twice, one still open. */
+export declare const ManyLanes: Story;
+/** A chart wider than its viewport opens scrolled to its newest events, not to the start of the history. */
+export declare const TestOpensAtNewest: Story;
+/** Beside the legend column the chart takes the remaining width, rather than collapsing to nothing. */
+export declare const TestChartFillsRow: Story;
+/**
+ * The legend's toggle switches its column between the lanes' titles and their stats, and hovering a
+ * title shows the stats it is not showing.
+ *
+ * 1. Hover the first lane's title: its card shows the lane's token count.
+ * 2. Press the legend toggle: the column shows stats instead of titles.
+ * 3. Press it again: the titles are back.
+ */
+export declare const TestLegendStats: Story;
+/** In a host taller than its lanes the chart fills it, so the horizontal scroll bar is at the host's foot. */
+export declare const TestScrollerAtFoot: Story;
+/**
+ * The drawing is one keyboard stop that walks its nodes.
+ *
+ * 1. Click the first node of the second lane: the chart takes focus and that node is current.
+ * 2. ArrowRight: the next node along the same lane.
+ * 3. ArrowDown: the nearest node on the lane below.
+ * 4. Space opens the current node's card; Space again closes it.
+ */
+export declare const TestKeyboardNodes: Story;
+/** One band whose lanes branch off one another: `parentId` indents, `openedFrom` and `closedInto` connect. */
+export declare const Branching: Story;
+/** Four bands: two nested under the first, one unrelated. */
+export declare const ManyGroups: Story;
 //# sourceMappingURL=Gantt.stories.d.ts.map

package/dist/types/src/components/Gantt/Gantt.stories.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Gantt.stories.d.ts","sourceRoot":"","sources":["../../../../../src/components/Gantt/Gantt.stories.tsx"],"names":[],"mappings":"AAIA,OAAO,EAAa,KAAK,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,KAA8C,MAAM,OAAO,CAAC;AAMnE,OAAO,EAAS,KAAK,SAAS,EAAE,KAAK,SAAS,EAAE,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAuJtF,KAAK,SAAS,GAAG,SAAS,GAAG;IAC3B,6EAA6E;IAC7E,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB,CAAC;AAUF,QAAA,MAAM,YAAY,UAAW,SAAS,sBAKrC,CAAC;AAkCF,QAAA,MAAM,IAAI;;;;;;;;;YAQG,KAAK;YAAM,GAAG;;6BACF,SAAS;iCACL,WAAW;;CAEH,CAAC;eAEvB,IAAI;AAEnB,KAAK,KAAK,GAAG,QAAQ,CAAC,OAAO,IAAI,CAAC,CAAC;AAEnC,eAAO,MAAM,OAAO,EAAE,KAAU,CAAC;AAEjC,eAAO,MAAM,SAAS,EAAE,KAEvB,CAAC;AAEF,eAAO,MAAM,IAAI,EAAE,KAElB,CAAC"}
+{"version":3,"file":"Gantt.stories.d.ts","sourceRoot":"","sources":["../../../../../src/components/Gantt/Gantt.stories.tsx"],"names":[],"mappings":"AAIA,OAAO,EAAa,KAAK,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,KAA8C,MAAM,OAAO,CAAC;AAOnE,OAAO,EAAS,KAAK,SAAS,EAAE,KAAK,UAAU,EAAE,KAAK,SAAS,EAAE,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAqYvG,KAAK,kBAAkB,GAAG;IACxB,oFAAoF;IACpF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,yFAAyF;IACzF,MAAM,EAAE,MAAM,CAAC;IACf,qGAAqG;IACrG,IAAI,EAAE,MAAM,CAAC;IACb,iEAAiE;IACjE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,+EAA+E;IAC/E,WAAW,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,gGAAgG;IAChG,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;OAIG;IACH,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC/B,CAAC;AAsQF,KAAK,SAAS,GAAG,SAAS,GACxB,OAAO,CAAC,kBAAkB,CAAC,GAAG;IAC5B,6EAA6E;IAC7E,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,yDAAyD;IACzD,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAKJ,QAAA,MAAM,YAAY,8GAWf,SAAS,sBAyCX,CAAC;AAEF,QAAA,MAAM,IAAI;;;;;;;;;;YASG,KAAK;YAAM,GAAG;;;6BAEF,SAAS;iCACL,WAAW;;CAEH,CAAC;eAEvB,IAAI;AAEnB,KAAK,KAAK,GAAG,QAAQ,CAAC,OAAO,IAAI,CAAC,CAAC;AAEnC,eAAO,MAAM,OAAO,EAAE,KAAU,CAAC;AAEjC,eAAO,MAAM,SAAS,EAAE,KAIvB,CAAC;AAEF,sGAAsG;AACtG,eAAO,MAAM,IAAI,EAAE,KAKlB,CAAC;AAEF,yGAAyG;AACzG,eAAO,MAAM,QAAQ,EAAE,KAItB,CAAC;AAEF,iGAAiG;AACjG,eAAO,MAAM,UAAU,EAAE,KAcxB,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,UAAU,EAAE,KAUxB,CAAC;AAMF,sCAAsC;AACtC,eAAO,MAAM,OAAO,EAAE,KASrB,CAAC;AAEF,oFAAoF;AACpF,eAAO,MAAM,SAAS,EAAE,KASvB,CAAC;AAEF,4GAA4G;AAC5G,eAAO,MAAM,iBAAiB,EAAE,KAuB/B,CAAC;AAEF,uGAAuG;AACvG,eAAO,MAAM,iBAAiB,EAAE,KAe/B,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,EAAE,KAoC7B,CAAC;AAEF,8GAA8G;AAC9G,eAAO,MAAM,kBAAkB,EAAE,KAqChC,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,iBAAiB,EAAE,KAyC/B,CAAC;AAEF,8GAA8G;AAC9G,eAAO,MAAM,SAAS,EAAE,KASvB,CAAC;AAEF,6DAA6D;AAC7D,eAAO,MAAM,UAAU,EAAE,KASxB,CAAC"}

package/dist/types/src/components/Gantt/gantt-rows.d.ts

@@ -0,0 +1,26 @@
+import { type GanttGroup, type GanttLane } from './Gantt.tsx';
+export type Row = {
+    lane: GanttLane;
+    depth: number;
+    index: number;
+    groupId: string | undefined;
+};
+/** A group's rows, contiguous — which is what lets one rectangle enclose them. */
+export type Band = {
+    group: GanttGroup;
+    first: number;
+    last: number;
+};
+/**
+ * Rows in reading order: the ungrouped lanes, then each group's band, a nested group's band directly
+ * after its parent's. Within a band the lanes come in the order given, each nested under its
+ * `parentId`.
+ *
+ * A band is contiguous by construction, which is the whole reason the order is settled here rather
+ * than left to the caller: one rectangle can only enclose a run of adjacent rows.
+ */
+export declare const orderRows: (groups: readonly GanttGroup[], lanes: readonly GanttLane[]) => {
+    rows: Row[];
+    bands: Band[];
+};
+//# sourceMappingURL=gantt-rows.d.ts.map

package/dist/types/src/components/Gantt/gantt-rows.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gantt-rows.d.ts","sourceRoot":"","sources":["../../../../../src/components/Gantt/gantt-rows.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,KAAK,UAAU,EAAE,KAAK,SAAS,EAAE,MAAM,aAAa,CAAC;AAE9D,MAAM,MAAM,GAAG,GAAG;IAChB,IAAI,EAAE,SAAS,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;CAC7B,CAAC;AAEF,kFAAkF;AAClF,MAAM,MAAM,IAAI,GAAG;IACjB,KAAK,EAAE,UAAU,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,SAAS,WACZ,SAAS,UAAU,EAAE,SACtB,SAAS,SAAS,EAAE,KAC1B;IAAE,IAAI,EAAE,GAAG,EAAE,CAAC;IAAC,KAAK,EAAE,IAAI,EAAE,CAAA;CAoC9B,CAAC"}

package/dist/types/src/components/Gantt/gantt-rows.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=gantt-rows.test.d.ts.map

package/dist/types/src/components/Gantt/gantt-rows.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gantt-rows.test.d.ts","sourceRoot":"","sources":["../../../../../src/components/Gantt/gantt-rows.test.ts"],"names":[],"mappings":""}

package/dist/types/src/components/Gantt/gantt-scale.d.ts

@@ -0,0 +1,57 @@
+/**
+ * What the horizontal axis measures.
+ * - `time` — real duration, fitted to the width available: an idle gap is as wide as it was long.
+ * - `unit` — one fixed step per event: a burst and a lull read alike, and the drawing grows to the
+ *   right instead of compressing, so an event already placed never moves again. That is what makes a
+ *   live chart watchable — on a fitted axis every arrival shifts the whole history left.
+ */
+export type GanttAxis = 'time' | 'unit';
+/** A labelled gridline, positioned in the same pixels as `GanttScale.at`. */
+export type GanttTick = {
+    at: number;
+    label: string;
+};
+/** The mapping every part of the drawing shares: an instant to a horizontal offset in pixels. */
+export type GanttScale = {
+    at: (time: number) => number;
+    /** The drawing's width: the time axis takes what it is given, the unit axis states its own. */
+    width: number;
+    /** The labelled gridlines, as many as fit — the label's own width decides, so the scale owns this. */
+    ticks: GanttTick[];
+};
+/**
+ * Elapsed time since the start of the axis. The span picks the form for every tick alike, so a
+ * run's labels read as one unit: `0.2s` below a second's step, `45s` below a minute, `1:05` below an
+ * hour, `1:02:05` beyond.
+ */
+export declare const formatElapsed: (elapsed: number, { span, step }: {
+    span: number;
+    step: number;
+}) => string;
+export type TimeScaleOptions = {
+    range: {
+        start: number;
+        end: number;
+    };
+    /** The width the range is fitted into. */
+    width: number;
+    /** Clearance at each end, so a bar's cap and the first tick's label stay inside the drawing. */
+    pad: number;
+};
+/** Duration against width, labelled with the time elapsed since the start of the range. */
+export declare const timeScale: ({ range, width, pad }: TimeScaleOptions) => GanttScale;
+export type UnitScaleOptions = {
+    /** Every event's instant; order and duplicates do not matter. */
+    times: readonly number[];
+    /** Pixels per event — the axis's one unit. */
+    step: number;
+    /** Clearance at each end, which also keeps the newest node off the edge. */
+    pad: number;
+};
+/**
+ * One step per event, in the order they happened. Ordinals are global rather than per lane: a
+ * delegation drops from a parent's node to its child's first node, and only a shared ordering keeps
+ * those two at the same offset.
+ */
+export declare const unitScale: ({ times, step, pad }: UnitScaleOptions) => GanttScale;
+//# sourceMappingURL=gantt-scale.d.ts.map

package/dist/types/src/components/Gantt/gantt-scale.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gantt-scale.d.ts","sourceRoot":"","sources":["../../../../../src/components/Gantt/gantt-scale.ts"],"names":[],"mappings":"AAIA;;;;;;GAMG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,MAAM,CAAC;AAExC,6EAA6E;AAC7E,MAAM,MAAM,SAAS,GAAG;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEtD,iGAAiG;AACjG,MAAM,MAAM,UAAU,GAAG;IACvB,EAAE,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IAC7B,+FAA+F;IAC/F,KAAK,EAAE,MAAM,CAAC;IACd,sGAAsG;IACtG,KAAK,EAAE,SAAS,EAAE,CAAC;CACpB,CAAC;AAcF;;;;GAIG;AACH,eAAO,MAAM,aAAa,YAAa,MAAM,kBAAkB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,KAAG,MAY/F,CAAC;AAKF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,KAAK,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IACtC,0CAA0C;IAC1C,KAAK,EAAE,MAAM,CAAC;IACd,gGAAgG;IAChG,GAAG,EAAE,MAAM,CAAC;CACb,CAAC;AAEF,2FAA2F;AAC3F,eAAO,MAAM,SAAS,0BAA2B,gBAAgB,KAAG,UAanE,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,iEAAiE;IACjE,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IACzB,8CAA8C;IAC9C,IAAI,EAAE,MAAM,CAAC;IACb,4EAA4E;IAC5E,GAAG,EAAE,MAAM,CAAC;CACb,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,SAAS,yBAA0B,gBAAgB,KAAG,UA6ClE,CAAC"}

package/dist/types/src/components/Gantt/gantt-scale.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=gantt-scale.test.d.ts.map

package/dist/types/src/components/Gantt/gantt-scale.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gantt-scale.test.d.ts","sourceRoot":"","sources":["../../../../../src/components/Gantt/gantt-scale.test.ts"],"names":[],"mappings":""}

package/dist/types/src/components/Gantt/index.d.ts

@@ -1,2 +1,4 @@
 export * from './Gantt.tsx';
+export * from './gantt-rows.ts';
+export * from './gantt-scale.ts';
 //# sourceMappingURL=index.d.ts.map

package/dist/types/src/components/Gantt/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/components/Gantt/index.ts"],"names":[],"mappings":"AAIA,cAAc,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/components/Gantt/index.ts"],"names":[],"mappings":"AAIA,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC"}

package/dist/types/src/components/Gantt/useEnter.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Which of `ids` arrived since the last frame.
+ *
+ * A caller draws an entering element at the place it came from — the event before it, the node that
+ * spawned its lane — and the next frame draws it where it belongs, leaving a CSS transition to carry
+ * it the rest of the way. That is all the bookkeeping an enter animation needs: everything else in
+ * the drawing animates from its own previous value, which the browser already has.
+ *
+ * Nothing present on mount ever counts as entering — a chart that animates its whole history open on
+ * first paint is noise, since the reader was not there to see it arrive.
+ */
+export declare const useEnter: (ids: readonly string[]) => ((id: string) => boolean);
+//# sourceMappingURL=useEnter.d.ts.map

package/dist/types/src/components/Gantt/useEnter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useEnter.d.ts","sourceRoot":"","sources":["../../../../../src/components/Gantt/useEnter.ts"],"names":[],"mappings":"AAMA;;;;;;;;;;GAUG;AACH,eAAO,MAAM,QAAQ,QAAS,SAAS,MAAM,EAAE,KAAG,CAAC,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAezE,CAAC"}

package/dist/types/src/components/Gantt/useRangeTween.d.ts

@@ -0,0 +1,12 @@
+export type TimeRange = {
+    start: number;
+    end: number;
+};
+/**
+ * The range to draw with: `target`, reached over a short ease rather than in one step, so a
+ * time axis whose bounds move (a new event, `now` advancing) slides every span, node and tick to
+ * its new place together instead of jumping. A new target mid-flight eases on from wherever the
+ * drawing is, so a stream of updates reads as one continuous motion.
+ */
+export declare const useRangeTween: (target: TimeRange, enabled: boolean) => TimeRange;
+//# sourceMappingURL=useRangeTween.d.ts.map

package/dist/types/src/components/Gantt/useRangeTween.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useRangeTween.d.ts","sourceRoot":"","sources":["../../../../../src/components/Gantt/useRangeTween.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,SAAS,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC;AAavD;;;;;GAKG;AACH,eAAO,MAAM,aAAa,WAAY,SAAS,WAAW,OAAO,KAAG,SAmCnE,CAAC"}

package/dist/types/src/components/ProcessTree/ProcessTree.d.ts

@@ -1,7 +1,7 @@
 import React from 'react';
 import * as Process from '@dxos/compute/Process';
 export type ProcessTreeProps = {
-    processes: readonly Process.Info[];
+    processes: readonly Process.Process[];
     /**
      * Maximum nesting depth from the root (1 = top-level processes only).
      *
@@ -14,12 +14,12 @@ export type ProcessTreeProps = {
      *
      * Must be referentially stable — `ProcessTree` is memoized on its props.
      */
-    resolveLabel?: (process: Process.Info) => string | undefined;
+    resolveLabel?: (process: Process.Process) => string | undefined;
     /** Pids drawn as selected; the tree is controlled, so a click reports through `onSelectedChange`. */
     selected?: readonly string[];
     /** The selection after a click: the clicked pid alone, or toggled among the others on a meta-click. */
     onSelectedChange?: (selected: string[]) => void;
-    onProcessTerminate?: (process: Process.Info) => void;
+    onProcessTerminate?: (process: Process.Process) => void;
 };
 /**
  * The agent's running processes as a tree, one row per process with its status glyph and metrics

package/dist/types/src/components/ProcessTree/ProcessTree.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ProcessTree.d.ts","sourceRoot":"","sources":["../../../../../src/components/ProcessTree/ProcessTree.tsx"],"names":[],"mappings":"AAOA,OAAO,KAAmD,MAAM,OAAO,CAAC;AAExE,OAAO,KAAK,OAAO,MAAM,uBAAuB,CAAC;AAcjD,MAAM,MAAM,gBAAgB,GAAG;IAE7B,SAAS,EAAE,SAAS,OAAO,CAAC,IAAI,EAAE,CAAC;IACnC;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;;OAKG;IACH,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,KAAK,MAAM,GAAG,SAAS,CAAC;IAC7D,qGAAqG;IACrG,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7B,uGAAuG;IACvG,gBAAgB,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;IAChD,kBAAkB,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,KAAK,IAAI,CAAC;CACtD,CAAC;AAeF;;;;GAIG;AACH,eAAO,MAAM,WAAW;;6GAkFvB,CAAC"}
+{"version":3,"file":"ProcessTree.d.ts","sourceRoot":"","sources":["../../../../../src/components/ProcessTree/ProcessTree.tsx"],"names":[],"mappings":"AAOA,OAAO,KAAmD,MAAM,OAAO,CAAC;AAExE,OAAO,KAAK,OAAO,MAAM,uBAAuB,CAAC;AAgBjD,MAAM,MAAM,gBAAgB,GAAG;IAE7B,SAAS,EAAE,SAAS,OAAO,CAAC,OAAO,EAAE,CAAC;IACtC;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;;OAKG;IACH,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,KAAK,MAAM,GAAG,SAAS,CAAC;IAChE,qGAAqG;IACrG,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7B,uGAAuG;IACvG,gBAAgB,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;IAChD,kBAAkB,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,KAAK,IAAI,CAAC;CACzD,CAAC;AAeF;;;;GAIG;AACH,eAAO,MAAM,WAAW;;6GAkFvB,CAAC"}

package/dist/types/src/components/ProcessTree/ProcessTree.stories.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ProcessTree.stories.d.ts","sourceRoot":"","sources":["../../../../../src/components/ProcessTree/ProcessTree.stories.tsx"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,IAAI,EAAE,KAAK,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAUjE,OAAO,EAAE,WAAW,EAAyB,MAAM,mBAAmB,CAAC;AAuDvE,QAAA,MAAM,IAAI,EAAE,IAAI,CAAC,OAAO,WAAW,CAKC,CAAC;eAEtB,IAAI;AAEnB,KAAK,KAAK,GAAG,QAAQ,CAAC,OAAO,IAAI,CAAC,CAAC;AAEnC,eAAO,MAAM,OAAO,EAAE,KAOrB,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,KAKhC,CAAC"}
+{"version":3,"file":"ProcessTree.stories.d.ts","sourceRoot":"","sources":["../../../../../src/components/ProcessTree/ProcessTree.stories.tsx"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,IAAI,EAAE,KAAK,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AASjE,OAAO,EAAE,WAAW,EAAyB,MAAM,mBAAmB,CAAC;AAuDvE,QAAA,MAAM,IAAI,EAAE,IAAI,CAAC,OAAO,WAAW,CAKC,CAAC;eAEtB,IAAI;AAEnB,KAAK,KAAK,GAAG,QAAQ,CAAC,OAAO,IAAI,CAAC,CAAC;AAEnC,eAAO,MAAM,OAAO,EAAE,KAOrB,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,KAKhC,CAAC"}

package/dist/types/src/components/Timeline/Timeline.d.ts

@@ -1,6 +1,6 @@
 import React from 'react';
 import { LogLevel } from '@dxos/log';
-import { type ThemedClassName } from '@dxos/react-ui';
+import * as Util from '@dxos/react-ui/Util';
 import { type TimelineOptions } from './timeline-options.ts';
 /**
  * Mercurial-style Commit.
@@ -17,7 +17,7 @@ export type Commit = {
     /** DXN link for navigation to referenced objects. */
     link?: string;
 };
-export type TimelineProps = ThemedClassName<{
+export type TimelineProps = Util.ThemedClassName<{
     /** Optional whitelist. */
     branches?: string[];
     /**
@@ -31,6 +31,11 @@ export type TimelineProps = ThemedClassName<{
     compact?: boolean;
     options?: TimelineOptions;
     debug?: boolean;
+    /**
+     * The element the rows are windowed against, which the host owns: a `ScrollArea.Viewport` or a
+     * `ScrollContainer.Viewport`, as `MessageList` binds to. Rows mount once it exists.
+     */
+    scroller: HTMLElement | null;
     onChange?: (props: {
         current?: number;
         commit?: Commit;
@@ -43,6 +48,9 @@ export type TimelineProps = ThemedClassName<{
 }>;
 /**
  * GitGraph-style timeline.
+ *
+ * Rows are windowed by `useWindow`, so rendering costs the viewport rather than the history. The
+ * layout is still computed over the whole history, so a windowed row draws every lane crossing it.
  */
 export declare const Timeline: React.NamedExoticComponent<Omit<TimelineProps, "className"> & {
     classNames?: import("@dxos/ui-types").ClassNameValue;

package/dist/types/src/components/Timeline/Timeline.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Timeline.d.ts","sourceRoot":"","sources":["../../../../../src/components/Timeline/Timeline.tsx"],"names":[],"mappings":"AAKA,OAAO,KAA6C,MAAM,OAAO,CAAC;AAGlE,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAQ,KAAK,eAAe,EAAkD,MAAM,gBAAgB,CAAC;AAQ5G,OAAO,EAAE,KAAK,eAAe,EAAkC,MAAM,uBAAuB,CAAC;AAE7F;;GAEG;AACH,MAAM,MAAM,MAAM,GAAG;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,qDAAqD;IACrD,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAWF,MAAM,MAAM,aAAa,GAAG,eAAe,CAAC;IAC1C,0BAA0B;IAC1B,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IAClE;;;OAGG;IACH,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,KAAK,IAAI,CAAC;CACjD,CAAC,CAAC;AAEH;;GAEG;AAEH,eAAO,MAAM,QAAQ;;6GAoTpB,CAAC"}
+{"version":3,"file":"Timeline.d.ts","sourceRoot":"","sources":["../../../../../src/components/Timeline/Timeline.tsx"],"names":[],"mappings":"AAKA,OAAO,KAAkE,MAAM,OAAO,CAAC;AAGvF,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAKrC,OAAO,KAAK,IAAI,MAAM,qBAAqB,CAAC;AAM5C,OAAO,EAAE,KAAK,eAAe,EAAkC,MAAM,uBAAuB,CAAC;AAE7F;;GAEG;AACH,MAAM,MAAM,MAAM,GAAG;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,qDAAqD;IACrD,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAWF,MAAM,MAAM,aAAa,GAAG,IAAI,CAAC,eAAe,CAAC;IAC/C,0BAA0B;IAC1B,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB;;;OAGG;IACH,QAAQ,EAAE,WAAW,GAAG,IAAI,CAAC;IAC7B,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IAClE;;;OAGG;IACH,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,KAAK,IAAI,CAAC;CACjD,CAAC,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,QAAQ;;6GA4LpB,CAAC"}

package/dist/types/src/components/Timeline/Timeline.stories.d.ts

@@ -1,12 +1,9 @@
 import { type StoryObj } from '@storybook/react-vite';
 import React from 'react';
 import { TimelineProps } from './Timeline.tsx';
-declare const DefaultStory: (props: TimelineProps) => React.JSX.Element;
+declare const DefaultStory: (props: Omit<TimelineProps, 'scroller'>) => React.JSX.Element;
 declare const meta: {
     title: string;
-    component: React.NamedExoticComponent<Omit<TimelineProps, "className"> & {
-        classNames?: import("@dxos/ui-types").ClassNameValue;
-    } & Pick<React.HTMLAttributes<Element>, "children" | "role" | "style"> & React.RefAttributes<HTMLDivElement>>;
     render: typeof DefaultStory;
     decorators: import("@storybook/react").Decorator[];
 };
@@ -20,5 +17,12 @@ export declare const Linear: Story;
 export declare const Empty: Story;
 export declare const Random: Story;
 export declare const Compact: Story;
+export declare const Large: Story;
+/**
+ * Windowing must not cost the graph: a row deep in the history still draws every lane crossing it,
+ * because the spans it reads are computed over the whole history, not over the mounted rows.
+ */
+export declare const Branching: Story;
+export declare const Keyboard: Story;
 export declare const Streaming: Story;
 //# sourceMappingURL=Timeline.stories.d.ts.map

package/dist/types/src/components/Timeline/Timeline.stories.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Timeline.stories.d.ts","sourceRoot":"","sources":["../../../../../src/components/Timeline/Timeline.stories.tsx"],"names":[],"mappings":"AAIA,OAAO,EAAa,KAAK,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,KAA2B,MAAM,OAAO,CAAC;AAQhD,OAAO,EAAyB,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAuHtE,QAAA,MAAM,YAAY,UAAW,aAAa,sBAQzC,CAAC;AAEF,QAAA,MAAM,IAAI;;;;;;;CAKuB,CAAC;eAEnB,IAAI;AAEnB,KAAK,KAAK,GAAG,QAAQ,CAAC,OAAO,IAAI,CAAC,CAAC;AAEnC,eAAO,MAAM,OAAO,EAAE,KAgBrB,CAAC;AAEF,eAAO,MAAM,MAAM,EAAE,KAUpB,CAAC;AAEF,eAAO,MAAM,SAAS,EAAE,KA4BvB,CAAC;AAEF,eAAO,MAAM,KAAK,EAAE,KAenB,CAAC;AAEF,eAAO,MAAM,MAAM,EAAE,KAUpB,CAAC;AAEF,eAAO,MAAM,KAAK,EAAE,KAAU,CAAC;AAE/B,eAAO,MAAM,MAAM,EAAE,KAEpB,CAAC;AAEF,eAAO,MAAM,OAAO,EAAE,KAErB,CAAC;AAEF,eAAO,MAAM,SAAS,EAAE,KAqEvB,CAAC"}
+{"version":3,"file":"Timeline.stories.d.ts","sourceRoot":"","sources":["../../../../../src/components/Timeline/Timeline.stories.tsx"],"names":[],"mappings":"AAIA,OAAO,EAAa,KAAK,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,KAA2B,MAAM,OAAO,CAAC;AAchD,OAAO,EAAyB,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAuHtE,QAAA,MAAM,YAAY,UAAW,IAAI,CAAC,aAAa,EAAE,UAAU,CAAC,sBAU3D,CAAC;AAEF,QAAA,MAAM,IAAI;;;;CAI2B,CAAC;eAEvB,IAAI;AAEnB,KAAK,KAAK,GAAG,QAAQ,CAAC,OAAO,IAAI,CAAC,CAAC;AAEnC,eAAO,MAAM,OAAO,EAAE,KAgBrB,CAAC;AAEF,eAAO,MAAM,MAAM,EAAE,KAUpB,CAAC;AAEF,eAAO,MAAM,SAAS,EAAE,KA4BvB,CAAC;AAEF,eAAO,MAAM,KAAK,EAAE,KAenB,CAAC;AAEF,eAAO,MAAM,MAAM,EAAE,KAUpB,CAAC;AAEF,eAAO,MAAM,KAAK,EAAE,KAAU,CAAC;AAE/B,eAAO,MAAM,MAAM,EAAE,KAEpB,CAAC;AAEF,eAAO,MAAM,OAAO,EAAE,KAErB,CAAC;AAuBF,eAAO,MAAM,KAAK,EAAE,KAanB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,SAAS,EAAE,KAqBvB,CAAC;AAEF,eAAO,MAAM,QAAQ,EAAE,KAetB,CAAC;AAEF,eAAO,MAAM,SAAS,EAAE,KAsEvB,CAAC"}

package/dist/types/src/components/Timeline/timeline-layout.d.ts

@@ -0,0 +1,35 @@
+import { type Commit } from './Timeline.tsx';
+/** The row range a branch's line covers, in commit indices. */
+export type TimelineSpan = {
+    start: number;
+    end: number;
+};
+export type TimelineRow = {
+    commit: Commit;
+    /** Index into the commit list the layout was built from; `spans` share these coordinates. */
+    index: number;
+};
+export type TimelineLayout = {
+    /** One row per commit on a whitelisted branch, in commit order. */
+    rows: TimelineRow[];
+    /** Lane per branch; a branch outside the whitelist gets none, and so gets no rows. */
+    branchLane: Map<string, number>;
+    /** Lanes the row graphic has to be wide enough for. */
+    laneCount: number;
+    /** The span each branch's line covers. */
+    spans: Map<string, TimelineSpan>;
+    /** Row index per commit index — the keyboard navigates in commit indices but scrolls rows. */
+    rowByCommitIndex: Map<number, number>;
+    /** Commit index per commit id — a click names a commit, everything else speaks in indices. */
+    commitIndexById: Map<string, number>;
+};
+/**
+ * Lays a commit graph out into rows: which lane each branch draws in, how far each branch's line
+ * runs, and which commits get a row at all.
+ *
+ * Pure and linear in the number of commits: every lookup a commit makes about a parent, and every
+ * lane release, is served from an index built in one pass. Commits are assumed to be in topological
+ * order — a parent always precedes its children.
+ */
+export declare const layoutTimeline: (commits: readonly Commit[], branches: readonly string[]) => TimelineLayout;
+//# sourceMappingURL=timeline-layout.d.ts.map

package/dist/types/src/components/Timeline/timeline-layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeline-layout.d.ts","sourceRoot":"","sources":["../../../../../src/components/Timeline/timeline-layout.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAE7C,+DAA+D;AAC/D,MAAM,MAAM,YAAY,GAAG;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACb,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,6FAA6F;IAC7F,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,mEAAmE;IACnE,IAAI,EAAE,WAAW,EAAE,CAAC;IACpB,sFAAsF;IACtF,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,uDAAuD;IACvD,SAAS,EAAE,MAAM,CAAC;IAClB,0CAA0C;IAC1C,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACjC,8FAA8F;IAC9F,gBAAgB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,8FAA8F;IAC9F,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACtC,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,cAAc,YAAa,SAAS,MAAM,EAAE,YAAY,SAAS,MAAM,EAAE,KAAG,cA+GxF,CAAC"}

package/dist/types/src/components/Timeline/timeline-layout.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=timeline-layout.test.d.ts.map