@invana/ui 0.0.23 → 0.0.24

package/dist/index.d.cts

@@ -1568,7 +1568,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 +1585,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 +1636,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 +1745,7 @@ interface NavSection {
 }
 interface BaseNavProps {
     className?: string;
-    orientation: 'horizontal' | 'vertical';
+    orientation: "horizontal" | "vertical";
     sections: {
         start?: NavSection;
         center?: NavSection;
@@ -1669,7 +1780,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 +1866,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>;
@@ -2240,6 +2362,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 +2399,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 +2435,18 @@ 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;
 
 interface TemplateOption {
     /** The projection template — `table-compact@3`. */
@@ -2359,6 +2522,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 +2544,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 +2557,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 +2787,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, 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 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, 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 };