@invana/ui 0.0.23 → 0.0.25

package/dist/index.d.cts

@@ -1106,6 +1106,30 @@ interface CitationListProps extends React$1.HTMLAttributes<HTMLUListElement> {
 declare const CitationList: React$1.ForwardRefExoticComponent<CitationListProps & React$1.RefAttributes<HTMLUListElement>>;
 declare const CitationRow: React$1.ForwardRefExoticComponent<CitationRowProps & React$1.RefAttributes<HTMLLIElement>>;
 
+interface ClampedTextProps extends Omit<React$1.HTMLAttributes<HTMLDivElement>, "children"> {
+    /** How many lines survive before the fold. Three is the panel default. */
+    lines?: number;
+    moreLabel?: string;
+    lessLabel?: string;
+    children?: React$1.ReactNode;
+}
+/**
+ * Prose that shows its first few lines and offers the rest.
+ *
+ * A project's purpose, an agent's instructions, a dataset's note: text whose
+ * *first sentence* is what a panel is for, and whose full length would push the
+ * list under it off the screen. It clamps to `lines`, and reveals the rest in
+ * place — never in a tooltip or a dialog, because the reader is already looking
+ * at the right place.
+ *
+ * **The toggle only exists when there is something behind it.** The clamp is
+ * measured, not guessed from a character count: a three-line paragraph in a
+ * wide panel is one line in a wider one, and a `Show more` that reveals nothing
+ * teaches the reader to stop pressing it. Re-measured on resize for the same
+ * reason.
+ */
+declare const ClampedText: React$1.ForwardRefExoticComponent<ClampedTextProps & React$1.RefAttributes<HTMLDivElement>>;
+
 interface ClarifyOption {
     /** Stable id handed back to `onSelect`. */
     value: string;
@@ -1568,7 +1592,8 @@ interface NavMenuItem {
  * is set), a `<button>` (when `onClick` is set), or a static `<div>`.
  */
 interface NavItemConfig {
-    /** Optional unique key for React rendering */
+    /** Optional unique key for React rendering, and the item's identity for
+     *  `activeKey`. Falls back to `name`. */
     key?: string;
     /** Display name shown in tooltip */
     name: string;
@@ -1584,22 +1609,44 @@ interface NavItemConfig {
     activeClass?: string;
     /** CSS classes for the icon */
     iconClassName?: string;
+    /** Classes for the label span alone — a truncation cap, usually
+     *  (`max-w-[16ch] truncate`). */
+    labelClassName?: string;
     /** Stroke width for the icon (default: 2) */
     iconStroke?: number;
     /** Tooltip position */
-    tooltipSide?: 'top' | 'right' | 'bottom' | 'left';
+    tooltipSide?: "top" | "right" | "bottom" | "left";
     /** Show a separator line after this item */
     showSeperator?: boolean;
     /** Lucide icon component. Optional — items may be label-only (e.g. status-bar text). */
     icon?: React__default.ElementType | LucideIcon;
     /** Custom tooltip content (overrides name) */
     tooltip?: React__default.ReactNode;
+    /** Greys the item out and drops every interaction on it. */
+    disabled?: boolean;
+    /**
+     * Inline style passthrough — for a per-item value the theme cannot express,
+     * such as a colour carried by the data (a page's own accent). Everything
+     * static belongs in `className`.
+     */
+    style?: React__default.CSSProperties;
     /**
      * Rows of a dropdown opened by this item. With `menuItems` the item is a
      * menu trigger — it needs no `onClick`, and stays highlighted while its menu
      * is open. Ignored when `href` is set.
      */
     menuItems?: NavMenuItem[];
+    /**
+     * Where `menuItems` hangs off.
+     *
+     * `'item'` (the default) — the whole item is the trigger. Clicking anywhere
+     * on it opens the menu.
+     *
+     * `'caret'` — a chevron button *inside* the item: the body still selects,
+     * and only the caret opens the menu. That is what a page tab needs, and it
+     * is why a tab strip could not be built on nav items before.
+     */
+    menuTrigger?: "item" | "caret";
     /**
      * A count pinned to the item's top-right — unread reviews, waiting questions.
      *
@@ -1613,19 +1660,107 @@ interface NavItemConfig {
      */
     badge?: React__default.ReactNode;
 }
+/**
+ * The visual treatments a strip of nav items can wear.
+ *
+ * One table, because the kit draws all three and used to draw two of them by
+ * hand in separate components. `nav` is what nav items have always looked
+ * like; `underline` and `folder` are the two tab strips — a panel's views and
+ * a workbook's pages — lifted out of `TabbedPanel` and
+ * `CanvasPagesViewPanel` unchanged, so migrating those renders identically.
+ */
+declare const VARIANT: {
+    /** The capsule: a filled, ringed chip. Toolbars, rails, header actions. */
+    readonly nav: {
+        readonly item: "rounded-control ring-1 ring-transparent";
+        readonly hover: "hover:bg-primary/10 hover:text-primary hover:ring-primary/25";
+        readonly open: "data-[state=open]:bg-primary/15 data-[state=open]:text-primary data-[state=open]:ring-primary/25";
+        readonly active: "bg-primary/15 text-primary ring-primary/25";
+        readonly strip: "";
+    };
+    /** The panel tab: accented fill with a rule under it, merging into the body. */
+    readonly underline: {
+        readonly item: "h-full rounded-none px-3 py-2";
+        readonly hover: "hover:text-foreground";
+        readonly open: "data-[state=open]:text-foreground";
+        readonly active: "bg-primary/10 text-primary border-b-2 border-primary mb-[-1px]";
+        readonly strip: "items-stretch";
+    };
+    /**
+     * The workbook tab: boxed on top / left / right with an *open bottom*, so it
+     * punches through the strip's own rule — the classic folder-tab notch.
+     */
+    readonly folder: {
+        readonly item: "h-full rounded-none px-3 py-2 gap-1.5";
+        readonly hover: "hover:text-foreground";
+        readonly open: "data-[state=open]:text-foreground";
+        readonly active: "mb-[-1px] rounded-t-md border border-b-0 border-primary text-primary";
+        readonly strip: "items-stretch";
+    };
+};
+type NavItemsVariant = keyof typeof VARIANT;
 interface NavItemsProps {
     items: NavItemConfig[];
     /** Layout orientation — drives default icon size, padding, tooltip side and separator. */
-    orientation?: 'horizontal' | 'vertical';
+    orientation?: "horizontal" | "vertical";
     /** Default tooltip side when an item doesn't specify one. */
-    tooltipSide?: 'top' | 'right' | 'bottom' | 'left';
+    tooltipSide?: "top" | "right" | "bottom" | "left";
     /** Default icon classes when an item doesn't specify `iconClassName`. */
     iconClassName?: string;
+    /** Visual treatment — see {@link VARIANT}. Defaults to `nav`. */
+    variant?: NavItemsVariant;
+    /**
+     * The selected item's key (`item.key ?? item.name`).
+     *
+     * Passing it makes the strip **controlled**: the internal highlight is
+     * bypassed entirely and the caller owns which item is lit. Omit it and the
+     * strip keeps its own state exactly as it always has.
+     */
+    activeKey?: string;
+    /** Fires with the item's key whenever selection changes, controlled or not. */
+    onActiveChange?: (key: string) => void;
+    /**
+     * `'tabs'` announces the strip as a tab list and gives it tab keyboard
+     * behaviour: `role="tablist"` on the container, `role="tab"` +
+     * `aria-selected` per item, ONE tab stop for the whole strip (roving
+     * tabindex), and ← → ↑ ↓ Home End moving between items with selection
+     * following focus — the same model Radix's tabs use.
+     *
+     * `'none'` (the default) leaves items as the plain buttons and links they
+     * have always been.
+     */
+    selectionMode?: "none" | "tabs";
+    /** Item key → the `id` of the panel it controls, for `aria-controls`. */
+    panelId?: (key: string) => string;
+    /**
+     * Fold the items that do not fit into a `…` dropdown at the end of the strip.
+     *
+     * **Off by default.** A strip only becomes responsive because its owner asked
+     * it to — a toolbar that would rather scroll, or one whose items must all
+     * stay visible, is unaffected by this existing.
+     *
+     * Requires the strip to have a bounded width to measure against: put
+     * `min-w-0` on it (or on its flex parent) or it will report that everything
+     * fits, forever. Ignored on a vertical strip, which grows downward.
+     */
+    overflow?: boolean;
+    /** Accessible name and tooltip for the overflow trigger. */
+    overflowLabel?: string;
+    /** Classes for the strip container. Only rendered when the strip needs one —
+     *  see the note on the return value in {@link NavItems}. */
+    className?: string;
 }
 /**
  * NavItems - Shared renderer for navigation items. Renders href / onClick /
  * static items with identical styling so all three share the same padding,
  * primary hover + active highlight, and icon size.
+ *
+ * **What it returns.** With neither `selectionMode` nor `overflow` set it
+ * returns a bare fragment, exactly as it always has, and the caller's own
+ * wrapper lays the items out — every existing consumer is untouched. Ask for
+ * either and it renders its own container, because both need one: a tab list
+ * needs an element to carry `role="tablist"` and the keyboard handler, and
+ * overflow needs an element whose width is the budget.
  */
 declare const NavItems: React__default.FC<NavItemsProps>;
 interface NavSection {
@@ -1634,7 +1769,7 @@ interface NavSection {
 }
 interface BaseNavProps {
     className?: string;
-    orientation: 'horizontal' | 'vertical';
+    orientation: "horizontal" | "vertical";
     sections: {
         start?: NavSection;
         center?: NavSection;
@@ -1669,7 +1804,12 @@ declare const NavBase: React__default.FC<BaseNavProps>;
  * ```
  */
 type NavHorizontalItem = NavItemConfig;
-interface NavHorizontalItemsProps {
+/**
+ * Everything `NavItems` takes except the orientation, which this component
+ * fixes. Forwarding the whole surface is what lets a header opt into
+ * `overflow`, `variant` or tab semantics without reaching past the wrapper.
+ */
+interface NavHorizontalItemsProps extends Omit<NavItemsProps, 'orientation' | 'items'> {
     items: NavHorizontalItem[];
 }
 declare const NavHorizontalItems: React__default.FC<NavHorizontalItemsProps>;
@@ -1750,7 +1890,13 @@ declare const NavHorizontal: React__default.FC<NavHorizontalProps>;
  * ```
  */
 type NavVerticalItem = NavItemConfig;
-interface NavVerticalItemsProps {
+/**
+ * Everything `NavItems` takes except the orientation, which this component
+ * fixes — so a rail can opt into `variant`, controlled selection or tab
+ * semantics without reaching past the wrapper. (`overflow` is ignored on a
+ * vertical strip: it grows downward, where there is always room.)
+ */
+interface NavVerticalItemsProps extends Omit<NavItemsProps, 'orientation' | 'items'> {
     items: NavVerticalItem[];
 }
 declare const NavVerticalItems: React__default.FC<NavVerticalItemsProps>;
@@ -2170,6 +2316,41 @@ interface SearchInputProps extends Omit<React__default.ComponentProps<'input'>,
 }
 declare const SearchInput: React__default.FC<SearchInputProps>;
 
+interface EyebrowProps extends React$1.HTMLAttributes<HTMLDivElement> {
+    /**
+     * Right-aligned trailing text — a count, a position, a state. Kept separate
+     * from `children` so the label stays left and the fact stays right without
+     * every call site building its own flex row.
+     */
+    aside?: React$1.ReactNode;
+    /**
+     * `muted` (default) for a label being scanned past, `foreground` when it
+     * titles a card that has no other heading, `accent` when it names something
+     * the reader is being taught.
+     */
+    tone?: "muted" | "foreground" | "accent";
+    children?: React$1.ReactNode;
+}
+/**
+ * The smallest heading in the system: a label over the thing it names.
+ *
+ * `WHY IT MATTERS`, `1 · CONNECTED`, `OPTIONAL`, `REFERENCED COMPONENTS`. It
+ * titles a band of content without the weight — or the 35px and the rule — of
+ * a {@link SectionHeader}, so several can sit in one scrolling column and still
+ * read as subordinate to the panel's own title.
+ *
+ * Uppercase at `text-meta` with tracking, because at this size caps are what
+ * separate a label from the sentence under it; lowercase at 11px reads as body
+ * copy set small. That is also why it is a component rather than four utility
+ * classes: the treatment was being retyped, and a label that drifts a weight or
+ * a tracking step in one panel stops reading as the same kind of thing.
+ *
+ * `tone="accent"` is for a label that names something the reader is being
+ * *taught* rather than something they are scanning — a callout's kind, a
+ * concept's name. Use it rarely; muted is the default for a reason.
+ */
+declare const Eyebrow: React$1.ForwardRefExoticComponent<EyebrowProps & React$1.RefAttributes<HTMLDivElement>>;
+
 interface SectionHeaderProps extends Omit<React$1.HTMLAttributes<HTMLDivElement>, "title"> {
     /** Sits before the title. A 14px lucide icon, usually. */
     icon?: React$1.ReactNode;
@@ -2240,6 +2421,11 @@ interface TabConfig {
     value: string;
     /** Label text or custom React node to display in the tab */
     label: string | React__default.ReactNode;
+    /**
+     * Plain-text name for the tab's tooltip and its accessible name. Only needed
+     * when `label` is a node rather than a string — the value is used otherwise.
+     */
+    name?: string;
     /** Optional icon component to show before the label */
     icon?: React__default.ElementType;
     /** Content to display when this tab is active */
@@ -2272,6 +2458,31 @@ interface TabbedPanelProps {
      * ```
      */
     headerActions?: NavHorizontalItem[];
+    /**
+     * Fold the tabs that do not fit the header into a `…` dropdown at the end of
+     * the strip, instead of letting the strip set the panel's minimum width.
+     *
+     * **Off by default**, so an existing panel renders exactly as it did. Turn it
+     * on for a panel whose width the user controls — a resizable inspector, a
+     * side panel — or any strip carrying more than a handful of tabs. The active
+     * tab never folds, and arrowing onto a folded one brings it back.
+     *
+     * ```tsx
+     * <TabbedPanel overflow tabs={nineOfThem} />
+     * ```
+     */
+    overflow?: boolean;
+    /** Accessible name for the overflow trigger. */
+    overflowLabel?: string;
+    /**
+     * Keep every tab's content mounted and hide the inactive ones, instead of
+     * mounting only the active tab.
+     *
+     * Off by default. Turn it on when a panel's tabs hold state worth keeping —
+     * a scroll position, a half-typed edit, a live canvas — and pay for it in
+     * the work every hidden tab keeps doing.
+     */
+    keepMounted?: boolean;
     /** Additional CSS classes for the container */
     className?: string;
     /** Additional CSS classes for the header */
@@ -2283,7 +2494,164 @@ interface TabbedPanelProps {
     /** Optional footer content */
     footerContent?: React__default.ReactNode;
 }
-declare function TabbedPanel({ tabs, defaultTab, activeTab, onTabChange, headerActions, className, headerClassName, bodyClassName, footerClassName, footerContent, }: TabbedPanelProps): React__default.JSX.Element;
+/**
+ * TabbedPanel — a panel whose views sit behind one 30px tab strip.
+ *
+ * The strip is a `NavItems` tab list (`variant="underline"`), not a Radix
+ * `Tabs`: the same component draws this kit's nav rails and its workbook tabs,
+ * so tab keyboard behaviour, the `…` overflow and the three visual treatments
+ * are written once. Switching content here is a plain `active === value`,
+ * which is what makes `keepMounted` possible — Radix unmounts an inactive
+ * `TabsContent`, and a panel that tears its canvas down on every tab switch is
+ * not a panel anyone wants.
+ */
+declare function TabbedPanel({ tabs, defaultTab, activeTab, onTabChange, headerActions, overflow, overflowLabel, keepMounted, className, headerClassName, bodyClassName, footerClassName, footerContent, }: TabbedPanelProps): React__default.JSX.Element;
+
+/**
+ * What a task did with its slice of the run's clock.
+ *
+ * These are the engine's own step statuses (`StepStatus`, plus `skipped` for a
+ * branch that never ran), not a second vocabulary: a Gantt row and a log line
+ * are the same task seen twice, so they say the same word for the same state.
+ */
+type TaskGanttStatus = "succeeded" | "running" | "failed" | "needs_input" | "stopped" | "skipped" | "queued";
+/** A `Date`, an ISO string, or epoch milliseconds — whatever the JSON carried. */
+type TaskGanttInstant = string | number | Date;
+/**
+ * One bar. A task is usually one of these; a retried task is two or more, the
+ * failed attempt sitting to the left of the one that stuck.
+ */
+interface TaskGanttSegment {
+    /** Offset from the run's zero. Use this, or `startedAt` with `origin`. */
+    startMs?: number;
+    durationMs?: number;
+    startedAt?: TaskGanttInstant;
+    finishedAt?: TaskGanttInstant;
+    status?: TaskGanttStatus;
+    /** Overrides the hover text, which otherwise reads `key · status · duration`. */
+    title?: string;
+}
+interface TaskGanttTask extends TaskGanttSegment {
+    /** `task_key` — what the log lines call this task. Also the row's label. */
+    key: string;
+    /** Shown instead of `key`, when the row wants a human name. */
+    label?: React$1.ReactNode;
+    /** Earlier attempts, oldest first. A failed one draws in `destructive`. */
+    attempts?: TaskGanttSegment[];
+    /** Overrides the right-hand duration cell. `—` when the task never ran. */
+    duration?: React$1.ReactNode;
+    /** One line — what the task said. The card's last line. */
+    log?: React$1.ReactNode;
+    /** A sentence under the card's header, when the row wants one. */
+    summary?: React$1.ReactNode;
+    /**
+     * What the task produced — its `result.json`, or any part of it.
+     *
+     * An object renders as label/value pairs, with nested values as JSON; a node
+     * renders as given, which is the hook for a kind-specific card (a table
+     * preview, a subgraph thumb) without replacing the whole body.
+     */
+    result?: React$1.ReactNode | Record<string, unknown>;
+    /** Why it failed. Drawn in `destructive`, above the result. */
+    error?: {
+        code?: React$1.ReactNode;
+        message?: React$1.ReactNode;
+        detail?: React$1.ReactNode;
+    };
+    /** Replaces this row's card body entirely. */
+    detail?: React$1.ReactNode;
+}
+interface TaskGanttProps extends Omit<React$1.HTMLAttributes<HTMLDivElement>, "onSelect"> {
+    /** One entry per task, in plan order — the run's `steps`, grouped by task. */
+    tasks: TaskGanttTask[];
+    /** The run's zero, when tasks carry timestamps. Defaults to the earliest one. */
+    origin?: TaskGanttInstant;
+    /** The clock's ceiling. Defaults to the last end, or `nowMs` if that is later. */
+    spanMs?: number;
+    /** Draws the *now* line. Set it while the run is in flight; omit it after. */
+    nowMs?: number;
+    /** Marks the last axis label `8s+` — the run has not decided its own length yet. */
+    openEnded?: boolean;
+    /** Intervals on the axis. Five labels by default. */
+    ticks?: number;
+    formatTick?: (ms: number) => string;
+    formatDuration?: (ms: number) => string;
+    /** The key column, in px. 112 in the drawer, wider on a dashboard. */
+    labelWidth?: number;
+    /**
+     * `compact` in a drawer, `comfortable` on a dashboard. It moves the bar's
+     * height, not the type scale — one component, three surfaces (SR14).
+     */
+    density?: "compact" | "comfortable";
+    /**
+     * The card on hover. On by default; a row with nothing to say shows none.
+     *
+     * Supplementary by design — the same facts are in the log band and in
+     * `result.json`, because a hover card is not reachable by touch.
+     */
+    showDetail?: boolean;
+    /**
+     * Replaces the default card body, for every row. Return `null` for a row that
+     * should not open one.
+     */
+    renderDetail?: (task: TaskGanttTask) => React$1.ReactNode;
+    /** Where the card sits, how fast it opens, and how wide it is. */
+    detailProps?: TaskGanttDetailProps;
+    /** The task the log is currently filtered to (SR15). */
+    selectedKey?: string | null;
+    /** Makes the rows pickable. Picking one is what filters the log. */
+    onSelectTask?: (key: string) => void;
+}
+interface TaskGanttDetailProps {
+    /** @default "right" */
+    side?: "top" | "right" | "bottom" | "left";
+    /** @default "start" */
+    align?: "start" | "center" | "end";
+    sideOffset?: number;
+    /** @default 200 */
+    openDelay?: number;
+    /** @default 80 */
+    closeDelay?: number;
+    /** The card's width. A `result.json` wants more than the 256px default. */
+    width?: number | string;
+    className?: string;
+}
+interface TaskGanttDetailCardProps extends Omit<React$1.HTMLAttributes<HTMLDivElement>, "children"> {
+    task: TaskGanttTask;
+    /** Elapsed so far, for a task still running — it has no `durationMs` yet. */
+    elapsedMs?: number;
+    formatDuration?: (ms: number) => string;
+}
+/**
+ * What one task did, as a card.
+ *
+ * The body of the hover card, and exported so a surface can compose its own
+ * around the same header — `renderDetail` returning this with a kind-specific
+ * block under it is the intended way to specialise, rather than redrawing the
+ * header and drifting the status vocabulary.
+ *
+ * Order is fixed and is the order a reader asks in: what state, how long, what
+ * went wrong, what came out, what it said last.
+ */
+declare const TaskGanttDetailCard: React$1.ForwardRefExoticComponent<TaskGanttDetailCardProps & React$1.RefAttributes<HTMLDivElement>>;
+/**
+ * Where the time went — one row per task, on the run's own clock.
+ *
+ * Duration is the question a run detail is opened with, and a step list with a
+ * duration column answers it one row at a time. A bar placed by start and sized
+ * by duration puts the slow task, the retry and the branch that never ran in one
+ * glance (SR14).
+ *
+ * It is one component across three surfaces — the Runs drawer (compact, with a
+ * line of log per row), the run dashboard (full width, logs off) and the
+ * document rendering — so `density` and `showLogs` are props, not three
+ * drawings.
+ *
+ * Colour never carries state alone: every row names its duration, the bar
+ * titles itself with its status, and a task that never ran is an *outline*
+ * rather than a paler fill.
+ */
+declare const TaskGantt: React$1.ForwardRefExoticComponent<TaskGanttProps & React$1.RefAttributes<HTMLDivElement>>;
 
 interface TemplateOption {
     /** The projection template — `table-compact@3`. */
@@ -2359,6 +2727,18 @@ interface TerminalProps extends React$1.HTMLAttributes<HTMLDivElement> {
 declare const Terminal: React$1.ForwardRefExoticComponent<TerminalProps & React$1.RefAttributes<HTMLDivElement>>;
 declare const TerminalLine: React$1.ForwardRefExoticComponent<TerminalLineProps & React$1.RefAttributes<HTMLDivElement>>;
 
+/**
+ * How the list arranges one entry.
+ *
+ * `columns` — `when` is a fixed left column, entries divided by a rule. The
+ * dense-log shape: `when` is short and uniform (`Fri 08:00`) and a reader
+ * scanning for "what changed on Friday" reads down one edge. Needs the width.
+ *
+ * `rail` — `when` sits above the title and a line threads the markers. For a
+ * narrow card or sidebar, where a 72px column would eat a third of the width
+ * and titles wrap anyway; the rail supplies the alignment the column was.
+ */
+type TimelineVariant = "columns" | "rail";
 interface TimelineEntryProps extends Omit<React$1.HTMLAttributes<HTMLLIElement>, "title"> {
     /** When — `Fri 5 Sep`, `09:47`, `Sun`. */
     when: React$1.ReactNode;
@@ -2369,6 +2749,11 @@ interface TimelineEntryProps extends Omit<React$1.HTMLAttributes<HTMLLIElement>,
     children?: React$1.ReactNode;
 }
 interface TimelineListProps extends React$1.HTMLAttributes<HTMLOListElement> {
+    /** @default "columns" */
+    variant?: TimelineVariant;
+    children?: React$1.ReactNode;
+}
+interface TimelineFooterProps extends React$1.HTMLAttributes<HTMLLIElement> {
     children?: React$1.ReactNode;
 }
 /**
@@ -2377,12 +2762,21 @@ interface TimelineListProps extends React$1.HTMLAttributes<HTMLOListElement> {
  * A task's history, a session's past rounds, a schedule's firings. An `<ol>`
  * because the order carries meaning — these are events in sequence, not a set.
  *
- * `when` is a column rather than a line above the entry, so a reader scanning
- * for "what changed on Friday" reads down one edge instead of hunting through
- * prose.
+ * Both variants take the same entries; only the arrangement differs. See
+ * `TimelineVariant` for which one a surface wants.
  */
 declare const TimelineList: React$1.ForwardRefExoticComponent<TimelineListProps & React$1.RefAttributes<HTMLOListElement>>;
 declare const TimelineEntry: React$1.ForwardRefExoticComponent<TimelineEntryProps & React$1.RefAttributes<HTMLLIElement>>;
+/**
+ * What to do next, at the end of the rail — `View changelog →`, `See all runs`.
+ *
+ * The rail runs into it, which is what says the list continues rather than
+ * stops. `role="presentation"` because a footer is not one of the events: it
+ * drops the `<li>` from the list's count while its content stays readable.
+ *
+ * `columns` has no rail to run on, so the footer is a plain last row there.
+ */
+declare const TimelineFooter: React$1.ForwardRefExoticComponent<TimelineFooterProps & React$1.RefAttributes<HTMLLIElement>>;
 
 declare const Toolbar: React__default.FC;
 
@@ -2598,4 +2992,76 @@ declare const Typography: {
     Pre: React$1.ForwardRefExoticComponent<TypographyPreProps & React$1.RefAttributes<HTMLPreElement>>;
 };
 
-export { Accordion, AccordionContent, AccordionItem, AccordionTrigger, AgentChip, type AgentChipProps, Alert, AlertDescription, AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogOverlay, AlertDialogPortal, AlertDialogTitle, AlertDialogTrigger, AlertTitle, AppStatusBar, type AppStatusBarProps, Avatar, AvatarFallback, AvatarImage, Badge, type BadgeProps, BarChartH, type BarChartHProps, BarChartV, type BarChartVProps, type BarDatum, type BaseNavProps, Breadcrumb, BreadcrumbEllipsis, BreadcrumbItem, BreadcrumbLink, BreadcrumbList, BreadcrumbPage, BreadcrumbSeparator, Button, ButtonGroup, ButtonGroupSeparator, ButtonGroupText, type ButtonProps, ButtonWithTooltip, type ButtonWithTooltipProps, CannotAnswerCard, type CannotAnswerCardProps, Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, CardWithHeader, Carousel, type CarouselApi, CarouselContent, CarouselItem, CarouselNext, CarouselPrevious, ChatSession, ChatSessionActivityRow, type ChatSessionActivityRowProps, type ChatSessionActivityStatus, ChatSessionActivitySubLine, type ChatSessionActivitySubLineProps, ChatSessionComposer, type ChatSessionComposerProps, ChatSessionContextChip, type ChatSessionContextChipProps, ChatSessionDisclosure, type ChatSessionDisclosureProps, ChatSessionMessage, type ChatSessionMessageAction, ChatSessionMessageOptions, type ChatSessionMessageOptionsProps, type ChatSessionMessageProps, type ChatSessionMessageRole, type ChatSessionMessageStatus, ChatSessionProgressLine, type ChatSessionProgressLineProps, ChatSessionPromptRow, type ChatSessionPromptRowProps, type ChatSessionProps, ChatSessionStatusBar, type ChatSessionStatusBarProps, ChatSessionTaskGroup, type ChatSessionTaskGroupProps, ChatSessionTaskRow, type ChatSessionTaskRowProps, type ChatSessionTaskStatus, CitationList, type CitationListProps, CitationMarker, CitationRow, type CitationRowProps, ClarifyCard, type ClarifyCardProps, type ClarifyOption, type ColumnDatum, Command, CommandDialog, CommandEmpty, CommandGroup, CommandInput, CommandItem, CommandList, CommandSeparator, CommandShortcut, ContextBar, type ContextBarProps, DiagnosisCard, type DiagnosisCardProps, Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger, DiffList, type DiffListProps, type DiffOp, DiffRow, type DiffRowProps, DivergingBar, type DivergingBarProps, type DivergingDatum, DotRating, type DotRatingProps, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, EmissionCard, type EmissionCardProps, EmissionHeader, type EmissionHeaderProps, type EmissionKind, EmptyState, EmptyStateLock, type EmptyStateLockProps, type EmptyStateProps, ErrorBoundary, FilterBar, type FilterBarProps, FilterChip, type FilterChipProps, type HeatCell, type HeatState, HeatStrip, type HeatStripProps, HoverCard, HoverCardContent, HoverCardTrigger, Item, ItemActions, ItemContent, ItemDescription, ItemFooter, ItemGroup, ItemHeader, ItemMedia, ItemSeparator, ItemTitle, Kbd, KbdGroup, Legend, LegendItem, type LegendItemProps, type LegendProps, type LegendSwatchKind, MenuItem, type MenuItemProps, Menubar, MenubarCheckboxItem, MenubarContent, MenubarGroup, MenubarItem, MenubarLabel, MenubarMenu, MenubarPortal, MenubarRadioGroup, MenubarRadioItem, MenubarSeparator, MenubarShortcut, MenubarSub, MenubarSubContent, MenubarSubTrigger, MenubarTrigger, MetricGrid, type MetricGridProps, MetricTile, type MetricTileProps, NavBase, NavHorizontal, type NavHorizontalItem, NavHorizontalItems, type NavHorizontalItemsProps, type NavHorizontalProps, type NavItemConfig, NavItems, type NavItemsProps, type NavMenuItem, type NavSection, NavVertical, type NavVerticalItem, NavVerticalItems, type NavVerticalItemsProps, type NavVerticalProps, NavigationMenu, NavigationMenuContent, NavigationMenuIndicator, NavigationMenuItem, NavigationMenuLink, NavigationMenuList, NavigationMenuTrigger, NavigationMenuViewport, NestedMenu, type NestedMenuProps, Pagination, PaginationContent, PaginationEllipsis, PaginationItem, PaginationLink, PaginationNext, PaginationPrevious, PanelContent, type PanelContentProps, PanelStack, type PanelStackProps, type PanelStackSection, Popover, PopoverContent, PopoverTrigger, Progress, PropertyList, type PropertyListProps, PropertyRow, type PropertyRowProps, ProposalCard, type ProposalCardProps, RatingControl, type RatingControlProps, RepairNote, type RepairNoteProps, ResizableHandle, ResizablePanel, ResizablePanelGroup, RetryNote, type RetryNoteProps, RichSelect, type RichSelectOption, type RichSelectProps, ScrollArea, ScrollBar, SearchInput, type SearchInputProps, type SearchInputSize, SectionHeader, type SectionHeaderProps, Separator, Sheet, SheetClose, SheetContent, SheetDescription, SheetFooter, SheetHeader, SheetOverlay, SheetPortal, SheetTitle, SheetTrigger, Sidebar, SidebarContent, SidebarFooter, SidebarGroup, SidebarGroupAction, SidebarGroupContent, SidebarGroupLabel, SidebarHeader, SidebarInput, SidebarInset, SidebarMenu, SidebarMenuAction, SidebarMenuBadge, SidebarMenuButton, SidebarMenuItem, SidebarMenuSkeleton, SidebarMenuSub, SidebarMenuSubButton, SidebarMenuSubItem, SidebarProvider, SidebarRail, SidebarSeparator, SidebarTrigger, Skeleton, Sparkline, type SparklineProps, Spinner, StatusDot, type StatusDotProps, type TabConfig, TabbedPanel, type TabbedPanelProps, Table, TableBody, TableCaption, TableCell, TableFooter, TableHead, TableHeader, TableRow, Tabs, TabsContent, TabsList, TabsTrigger, type TemplateOption, TemplatePicker, type TemplatePickerProps, Terminal, TerminalLine, type TerminalLineKind, type TerminalLineProps, type TerminalProps, TimelineEntry, type TimelineEntryProps, TimelineList, type TimelineListProps, Toaster, Toggle, ToggleGroup, ToggleGroupItem, Toolbar, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, Tour, type TourController, type TourProps, type TourReference, type TourStep, TreeItem, TreeView, type TreeViewProps, Typography, TypographyBlockquote, type TypographyBlockquoteProps, TypographyH1, type TypographyH1Props, TypographyH2, type TypographyH2Props, TypographyH3, type TypographyH3Props, TypographyH4, type TypographyH4Props, TypographyH5, type TypographyH5Props, TypographyH6, type TypographyH6Props, TypographyInlineCode, type TypographyInlineCodeProps, TypographyLarge, type TypographyLargeProps, TypographyLead, type TypographyLeadProps, TypographyList, type TypographyListProps, TypographyMuted, type TypographyMutedProps, TypographyP, type TypographyPProps, TypographyPre, type TypographyPreProps, TypographySmall, type TypographySmallProps, UnderDevelopment, type UnderDevelopmentProps, type UseTourOptions, type Verdict, agentChipVariants, badgeVariants, buttonGroupVariants, buttonVariants, chatSessionGutterClass, cn, navigationMenuTriggerStyle, statusDotVariants, toggleVariants, useSidebar, useTour };
+interface UseOverflowItemsOptions {
+    /** How many items the strip renders. */
+    count: number;
+    /**
+     * Off when false: nothing is measured, nothing folds, and the hook costs a
+     * consumer nothing but a ref it can ignore. This is what keeps `overflow` an
+     * opt-in on every component that wires the hook up.
+     */
+    enabled?: boolean;
+    /**
+     * An index that must never fold — the selected tab. A strip whose active
+     * item has folded reads as having no selection at all, and arrowing onto a
+     * folded tab is what brings it back (the new active index is pinned, so the
+     * next fit keeps it).
+     */
+    pinnedIndex?: number;
+    /**
+     * Width to keep free for the overflow trigger, in px. Only charged when
+     * something actually folds — see `fit`.
+     */
+    reserve?: number;
+}
+interface UseOverflowItemsResult {
+    /** Attach to the element whose width is the budget. */
+    containerRef: React$1.RefCallback<HTMLElement>;
+    /** Attach to item `index`. Stable per index, so items don't re-attach. */
+    itemRef: (index: number) => React$1.RefCallback<HTMLElement>;
+    /** Indices that do not fit, ascending. Identity is stable while unchanged. */
+    hiddenIndices: readonly number[];
+    /** `true` when item `index` should not be rendered on the strip. */
+    isHidden: (index: number) => boolean;
+}
+/**
+ * Measure a horizontal strip and report which of its items do not fit.
+ *
+ * The hook owns **only the arithmetic**. It renders nothing, knows nothing
+ * about tabs, nav items or menus, and takes no opinion on what a consumer does
+ * with the overflow — `NavItems` folds it into a `…` dropdown, but a
+ * breadcrumb could collapse it to an ellipsis and a toolbar could drop it
+ * entirely. That is the whole reason it is a hook and not a prop on one
+ * component: the three strips in this kit render through three different
+ * components and share no markup.
+ *
+ * **How it measures.** An item that has been folded has no box to measure, so
+ * the hook caches each item's natural width the last time it was on the strip
+ * and plans with that. The first render therefore lays every item out — that
+ * pass is what fills the cache — and the fold is applied in a layout effect,
+ * before the browser paints, so there is no flash of an overflowing strip.
+ *
+ * **How it avoids looping.** Folding changes the DOM, which fires the observers
+ * again; the result only reaches React when the index list actually differs,
+ * and widths are cached only from items that are currently laid out (a
+ * `display:none` item reports `0`, which would otherwise poison the cache).
+ *
+ * @example
+ * ```tsx
+ * const { containerRef, itemRef, hiddenIndices, isHidden } = useOverflowItems({
+ *   count: items.length,
+ *   enabled: overflow,
+ *   pinnedIndex: items.findIndex((i) => i.key === activeKey),
+ * });
+ *
+ * <div ref={containerRef} className="flex min-w-0 flex-1 items-center gap-1">
+ *   {items.map((item, i) =>
+ *     isHidden(i) ? null : <button key={item.key} ref={itemRef(i)}>{item.label}</button>
+ *   )}
+ *   {hiddenIndices.length > 0 && <OverflowMenu items={hiddenIndices.map((i) => items[i])} />}
+ * </div>
+ * ```
+ */
+declare function useOverflowItems({ count, enabled, pinnedIndex, reserve, }: UseOverflowItemsOptions): UseOverflowItemsResult;
+
+export { Accordion, AccordionContent, AccordionItem, AccordionTrigger, AgentChip, type AgentChipProps, Alert, AlertDescription, AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogOverlay, AlertDialogPortal, AlertDialogTitle, AlertDialogTrigger, AlertTitle, AppStatusBar, type AppStatusBarProps, Avatar, AvatarFallback, AvatarImage, Badge, type BadgeProps, BarChartH, type BarChartHProps, BarChartV, type BarChartVProps, type BarDatum, type BaseNavProps, Breadcrumb, BreadcrumbEllipsis, BreadcrumbItem, BreadcrumbLink, BreadcrumbList, BreadcrumbPage, BreadcrumbSeparator, Button, ButtonGroup, ButtonGroupSeparator, ButtonGroupText, type ButtonProps, ButtonWithTooltip, type ButtonWithTooltipProps, CannotAnswerCard, type CannotAnswerCardProps, Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, CardWithHeader, Carousel, type CarouselApi, CarouselContent, CarouselItem, CarouselNext, CarouselPrevious, ChatSession, ChatSessionActivityRow, type ChatSessionActivityRowProps, type ChatSessionActivityStatus, ChatSessionActivitySubLine, type ChatSessionActivitySubLineProps, ChatSessionComposer, type ChatSessionComposerProps, ChatSessionContextChip, type ChatSessionContextChipProps, ChatSessionDisclosure, type ChatSessionDisclosureProps, ChatSessionMessage, type ChatSessionMessageAction, ChatSessionMessageOptions, type ChatSessionMessageOptionsProps, type ChatSessionMessageProps, type ChatSessionMessageRole, type ChatSessionMessageStatus, ChatSessionProgressLine, type ChatSessionProgressLineProps, ChatSessionPromptRow, type ChatSessionPromptRowProps, type ChatSessionProps, ChatSessionStatusBar, type ChatSessionStatusBarProps, ChatSessionTaskGroup, type ChatSessionTaskGroupProps, ChatSessionTaskRow, type ChatSessionTaskRowProps, type ChatSessionTaskStatus, CitationList, type CitationListProps, CitationMarker, CitationRow, type CitationRowProps, ClampedText, type ClampedTextProps, ClarifyCard, type ClarifyCardProps, type ClarifyOption, type ColumnDatum, Command, CommandDialog, CommandEmpty, CommandGroup, CommandInput, CommandItem, CommandList, CommandSeparator, CommandShortcut, ContextBar, type ContextBarProps, DiagnosisCard, type DiagnosisCardProps, Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger, DiffList, type DiffListProps, type DiffOp, DiffRow, type DiffRowProps, DivergingBar, type DivergingBarProps, type DivergingDatum, DotRating, type DotRatingProps, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, EmissionCard, type EmissionCardProps, EmissionHeader, type EmissionHeaderProps, type EmissionKind, EmptyState, EmptyStateLock, type EmptyStateLockProps, type EmptyStateProps, ErrorBoundary, Eyebrow, type EyebrowProps, FilterBar, type FilterBarProps, FilterChip, type FilterChipProps, type HeatCell, type HeatState, HeatStrip, type HeatStripProps, HoverCard, HoverCardContent, HoverCardTrigger, Item, ItemActions, ItemContent, ItemDescription, ItemFooter, ItemGroup, ItemHeader, ItemMedia, ItemSeparator, ItemTitle, Kbd, KbdGroup, Legend, LegendItem, type LegendItemProps, type LegendProps, type LegendSwatchKind, MenuItem, type MenuItemProps, Menubar, MenubarCheckboxItem, MenubarContent, MenubarGroup, MenubarItem, MenubarLabel, MenubarMenu, MenubarPortal, MenubarRadioGroup, MenubarRadioItem, MenubarSeparator, MenubarShortcut, MenubarSub, MenubarSubContent, MenubarSubTrigger, MenubarTrigger, MetricGrid, type MetricGridProps, MetricTile, type MetricTileProps, NavBase, NavHorizontal, type NavHorizontalItem, NavHorizontalItems, type NavHorizontalItemsProps, type NavHorizontalProps, type NavItemConfig, NavItems, type NavItemsProps, type NavItemsVariant, type NavMenuItem, type NavSection, NavVertical, type NavVerticalItem, NavVerticalItems, type NavVerticalItemsProps, type NavVerticalProps, NavigationMenu, NavigationMenuContent, NavigationMenuIndicator, NavigationMenuItem, NavigationMenuLink, NavigationMenuList, NavigationMenuTrigger, NavigationMenuViewport, NestedMenu, type NestedMenuProps, Pagination, PaginationContent, PaginationEllipsis, PaginationItem, PaginationLink, PaginationNext, PaginationPrevious, PanelContent, type PanelContentProps, PanelStack, type PanelStackProps, type PanelStackSection, Popover, PopoverContent, PopoverTrigger, Progress, PropertyList, type PropertyListProps, PropertyRow, type PropertyRowProps, ProposalCard, type ProposalCardProps, RatingControl, type RatingControlProps, RepairNote, type RepairNoteProps, ResizableHandle, ResizablePanel, ResizablePanelGroup, RetryNote, type RetryNoteProps, RichSelect, type RichSelectOption, type RichSelectProps, ScrollArea, ScrollBar, SearchInput, type SearchInputProps, type SearchInputSize, SectionHeader, type SectionHeaderProps, Separator, Sheet, SheetClose, SheetContent, SheetDescription, SheetFooter, SheetHeader, SheetOverlay, SheetPortal, SheetTitle, SheetTrigger, Sidebar, SidebarContent, SidebarFooter, SidebarGroup, SidebarGroupAction, SidebarGroupContent, SidebarGroupLabel, SidebarHeader, SidebarInput, SidebarInset, SidebarMenu, SidebarMenuAction, SidebarMenuBadge, SidebarMenuButton, SidebarMenuItem, SidebarMenuSkeleton, SidebarMenuSub, SidebarMenuSubButton, SidebarMenuSubItem, SidebarProvider, SidebarRail, SidebarSeparator, SidebarTrigger, Skeleton, Sparkline, type SparklineProps, Spinner, StatusDot, type StatusDotProps, type TabConfig, TabbedPanel, type TabbedPanelProps, Table, TableBody, TableCaption, TableCell, TableFooter, TableHead, TableHeader, TableRow, Tabs, TabsContent, TabsList, TabsTrigger, TaskGantt, TaskGanttDetailCard, type TaskGanttDetailCardProps, type TaskGanttDetailProps, type TaskGanttInstant, type TaskGanttProps, type TaskGanttSegment, type TaskGanttStatus, type TaskGanttTask, type TemplateOption, TemplatePicker, type TemplatePickerProps, Terminal, TerminalLine, type TerminalLineKind, type TerminalLineProps, type TerminalProps, TimelineEntry, type TimelineEntryProps, TimelineFooter, type TimelineFooterProps, TimelineList, type TimelineListProps, type TimelineVariant, Toaster, Toggle, ToggleGroup, ToggleGroupItem, Toolbar, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, Tour, type TourController, type TourProps, type TourReference, type TourStep, TreeItem, TreeView, type TreeViewProps, Typography, TypographyBlockquote, type TypographyBlockquoteProps, TypographyH1, type TypographyH1Props, TypographyH2, type TypographyH2Props, TypographyH3, type TypographyH3Props, TypographyH4, type TypographyH4Props, TypographyH5, type TypographyH5Props, TypographyH6, type TypographyH6Props, TypographyInlineCode, type TypographyInlineCodeProps, TypographyLarge, type TypographyLargeProps, TypographyLead, type TypographyLeadProps, TypographyList, type TypographyListProps, TypographyMuted, type TypographyMutedProps, TypographyP, type TypographyPProps, TypographyPre, type TypographyPreProps, TypographySmall, type TypographySmallProps, UnderDevelopment, type UnderDevelopmentProps, type UseOverflowItemsOptions, type UseOverflowItemsResult, type UseTourOptions, type Verdict, agentChipVariants, badgeVariants, buttonGroupVariants, buttonVariants, chatSessionGutterClass, cn, navigationMenuTriggerStyle, statusDotVariants, toggleVariants, useOverflowItems, useSidebar, useTour };