@elabs-ai/components-ui 4.2.0 → 5.0.0

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import { ClassValue } from 'clsx';
-import { LucideIcon, LucideProps } from 'lucide-react';
 import * as react from 'react';
-import react__default, { ReactNode, HTMLAttributes, SVGProps, InputHTMLAttributes, ButtonHTMLAttributes, ComponentProps, ComponentPropsWithoutRef, ReactElement, TextareaHTMLAttributes, ForwardRefExoticComponent, RefAttributes, TdHTMLAttributes, ThHTMLAttributes, LiHTMLAttributes, AnchorHTMLAttributes, OlHTMLAttributes } from 'react';
+import react__default, { RefObject, ReactNode, HTMLAttributes, SVGProps, ComponentPropsWithoutRef, InputHTMLAttributes, ButtonHTMLAttributes, ComponentProps, ReactElement, TextareaHTMLAttributes, ForwardRefExoticComponent, RefAttributes, TdHTMLAttributes, ThHTMLAttributes, LiHTMLAttributes, AnchorHTMLAttributes, OlHTMLAttributes, Ref } from 'react';
+import { LucideIcon, LucideProps } from 'lucide-react';
 import * as class_variance_authority_types from 'class-variance-authority/types';
 import { VariantProps } from 'class-variance-authority';
 import * as AccordionPrimitive from '@radix-ui/react-accordion';
@@ -61,6 +61,44 @@ declare function cn(...inputs: ClassValue[]): string;
  */
 declare function useIsMobile(breakpoint?: number): boolean;
 
+/**
+ * The motion gate (`packages/tokens/src/themes.css`, MOTION GATE) sets `--motion-factor` to
+ * 0.0001 under a reduce request and 1 otherwise. Anything at or below this floor is "motion off".
+ */
+declare const MOTION_FACTOR_FLOOR = 0.01;
+/** `--motion-factor` as seen by `el` (default: the document root); 1 when unset or on the server. */
+declare function readMotionFactor(el?: Element | null): number;
+/** True when the factor sits at the floor — the reader asked for reduced motion. */
+declare function isMotionAtFloor(factor: number): boolean;
+/** True when the browser runs scroll-driven CSS animations (`animation-timeline: scroll()`). */
+declare function supportsScrollTimeline(): boolean;
+/**
+ * How root scroll progress is delivered:
+ * - `static` — server render, before hydration, motion at the floor, or disabled: nothing moves.
+ * - `timeline` — the browser runs `animation-timeline: scroll()`; the caller's CSS does the work
+ *   on the compositor and no JavaScript listens to scroll.
+ * - `script` — no scroll timelines: `motion`'s `scroll()` (an optional peer, imported lazily
+ *   only here) calls `onScroll` every frame.
+ */
+type ScrollProgressMode = "static" | "timeline" | "script";
+interface ScrollProgressOptions {
+    /** Skip all work (e.g. a plane whose rate means it never moves). Default `true`. */
+    enabled?: boolean;
+    /** Read `--motion-factor` from this element (so a subtree can dial motion); default the root. */
+    target?: RefObject<Element | null>;
+}
+interface ScrollProgress {
+    mode: ScrollProgressMode;
+    /** `--motion-factor` read once after mount (1 before hydration). */
+    factor: number;
+}
+/**
+ * Root scroll progress under the motion gate. The factor is read once, after hydration, so the
+ * server HTML and the first client render are identical (`static`). `onScroll(scrollY, progress)`
+ * fires only in `script` mode; it may change between renders without resubscribing.
+ */
+declare function useScrollProgress(onScroll?: (scrollY: number, progress: number) => void, { enabled, target }?: ScrollProgressOptions): ScrollProgress;
+
 /**
  * Browser file-download helpers — the single home for the
  * `Blob`/URL → hidden `<a download>` → click → revoke dance that was previously
@@ -854,6 +892,23 @@ declare const EFFORT_SIZE_RUNGS: readonly ["size-2.5", "size-3", "size-3.5", "si
  */
 declare function effortRungForIndex(index: number, count: number): (typeof EFFORT_SIZE_RUNGS)[number];
 
+declare const badgeVariants: (props?: ({
+    variant?: "default" | "secondary" | "outline" | "success" | "warning" | "destructive" | "info" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+type BadgeAppearance = "tint" | "solid" | "outline" | "neutral";
+interface BadgeProps extends HTMLAttributes<HTMLSpanElement>, VariantProps<typeof badgeVariants> {
+    /**
+     * Explicit per-instance override of the fill/border/ink treatment. Unset
+     * (default) renders NO `data-appearance` attribute, so the badge is driven
+     * purely by the ancestor `--badge-appearance` token (`auto` = each
+     * variant's own recipe, today's look). Meaningful only on the
+     * colour-bearing variants (`default`, `success`, `warning`, `destructive`,
+     * `info`) — see `badgeVariants`.
+     */
+    appearance?: BadgeAppearance;
+}
+declare const Badge: react.ForwardRefExoticComponent<BadgeProps & react.RefAttributes<HTMLSpanElement>>;
+
 /** The canonical, closed 7-state status enum (research 10 §B.1). */
 declare const STATUSES: readonly ["pending", "running", "complete", "awaiting-approval", "denied", "failed", "skipped"];
 type Status = (typeof STATUSES)[number];
@@ -931,6 +986,16 @@ interface StatusBadgeProps extends HTMLAttributes<HTMLSpanElement>, Omit<Variant
     status: Status | CustomStatus;
     /** Render label-only (no status icon). */
     hideIcon?: boolean;
+    /**
+     * Explicit per-instance override of the fill/border/ink treatment — see
+     * `Badge`'s own doc. Meaningful only on the colour-bearing statuses
+     * (`running`/`complete`/`awaiting-approval`/`failed`) and tones
+     * (`info`/`success`/`warning`/`destructive`); `pending`/`denied`/`skipped`
+     * and the `neutral` tone are already neutral pills. On a `CustomStatus`
+     * (the out-of-vocabulary hatch), `"solid"` is never honoured — the hatch
+     * is calm-only (integrity constraint 2, file docblock).
+     */
+    appearance?: BadgeAppearance;
 }
 declare const StatusBadge: react.ForwardRefExoticComponent<StatusBadgeProps & react.RefAttributes<HTMLSpanElement>>;
 /** The editor/markdown `Timeline` 3-state vocabulary (`@elabs-ai/components-editor`). */
@@ -1166,7 +1231,17 @@ declare const FirstRunIllustration: react.ForwardRefExoticComponent<Omit<Illustr
 
 declare const Accordion: react.ForwardRefExoticComponent<(AccordionPrimitive.AccordionSingleProps | AccordionPrimitive.AccordionMultipleProps) & react.RefAttributes<HTMLDivElement>>;
 declare const AccordionItem: react.ForwardRefExoticComponent<Omit<AccordionPrimitive.AccordionItemProps & react.RefAttributes<HTMLDivElement>, "ref"> & react.RefAttributes<HTMLDivElement>>;
-declare const AccordionTrigger: react.ForwardRefExoticComponent<Omit<AccordionPrimitive.AccordionTriggerProps & react.RefAttributes<HTMLButtonElement>, "ref"> & react.RefAttributes<HTMLButtonElement>>;
+interface AccordionTriggerProps extends ComponentPropsWithoutRef<typeof AccordionPrimitive.Trigger> {
+    /**
+     * The heading level Radix's `Accordion.Header` renders. Radix hardcodes `h3`,
+     * which skips a level whenever the accordion sits directly under the page
+     * `h1` — so the level is the caller's to set. Visually identical at every
+     * level: the type comes from the trigger, not the heading.
+     * @default 3
+     */
+    headingLevel?: 2 | 3 | 4 | 5 | 6;
+}
+declare const AccordionTrigger: react.ForwardRefExoticComponent<AccordionTriggerProps & react.RefAttributes<HTMLButtonElement>>;
 declare const AccordionContent: react.ForwardRefExoticComponent<Omit<AccordionPrimitive.AccordionContentProps & react.RefAttributes<HTMLDivElement>, "ref"> & react.RefAttributes<HTMLDivElement>>;
 
 interface AdvancedGroupProps extends Omit<HTMLAttributes<HTMLDivElement>, "title"> {
@@ -1219,6 +1294,72 @@ interface ButtonProps extends ButtonHTMLAttributes<HTMLButtonElement>, VariantPr
 }
 declare const Button: react.ForwardRefExoticComponent<ButtonProps & react.RefAttributes<HTMLButtonElement>>;
 
+type CollapsiblePanelSide = "left" | "right";
+type CollapsiblePanelState = "expanded" | "collapsed";
+/**
+ * Where the CONTAINER fragment positions itself. `"viewport"` (default) pins
+ * to the viewport edge (`fixed`) — Sidebar's original mechanism, byte-
+ * identical to pre-#432 output. `"inset"` pins to the panel's OWN nearest
+ * `relative` ancestor instead (`absolute`) — for a panel nested inside
+ * another `fixed`-to-viewport element (e.g. a `SideDock` inside a Sidebar's
+ * `SidebarInset`), so the two never race for the same viewport edge (#432).
+ * The consumer must give that ancestor `relative` itself; `SideDock` does
+ * this via its own `containerPosition` prop.
+ */
+type CollapsiblePanelContainerPosition = "viewport" | "inset";
+interface UseCollapsiblePanelOptions {
+    /** Which edge the panel lives on. Default `"left"`. */
+    side?: CollapsiblePanelSide;
+    /** Controlled open state (`isControlled = open !== undefined`). */
+    open?: boolean;
+    /** Uncontrolled initial open state. Default `true`. */
+    defaultOpen?: boolean;
+    /** Called with the next open state on `setOpen`/`toggle`. */
+    onOpenChange?: (open: boolean) => void;
+    /**
+     * Literal expanded-width utility (e.g. `"w-(--sidebar-width)"`). Must be a
+     * literal in the consumer's source so Tailwind generates it.
+     */
+    widthClassName?: string;
+    /**
+     * Literal collapsed-state utility for the gap spacer (e.g.
+     * `"group-data-[collapsible=offcanvas]:w-0"`).
+     */
+    spacerCollapsedClassName?: string;
+    /**
+     * Literal off-screen slide utilities for the fixed container, keyed by side
+     * (e.g. `left: "left-0 group-data-[collapsible=offcanvas]:left-[calc(var(--sidebar-width)*-1)]"`).
+     */
+    containerSlideClassNames?: Record<CollapsiblePanelSide, string>;
+    /**
+     * `"viewport"` (default, byte-identical to pre-#432) or `"inset"` — see
+     * `CollapsiblePanelContainerPosition`.
+     */
+    containerPosition?: CollapsiblePanelContainerPosition;
+}
+/** Data attributes for the panel's `group` element. */
+interface CollapsiblePanelAttrs {
+    "data-state": CollapsiblePanelState;
+    "data-side": CollapsiblePanelSide;
+}
+interface UseCollapsiblePanelReturn {
+    /** Resolved open state (controlled prop wins). */
+    open: boolean;
+    /** `"expanded"` when open, `"collapsed"` when closed. */
+    state: CollapsiblePanelState;
+    side: CollapsiblePanelSide;
+    /** Set the open state (accepts a value or an updater fn). */
+    setOpen: (open: boolean | ((open: boolean) => boolean)) => void;
+    toggle: () => void;
+    /** `data-state`/`data-side` for the group element wrapping both fragments. */
+    attrs: CollapsiblePanelAttrs;
+    /** The gap-spacer fragment: reserves/releases the inline width. */
+    spacerClassName: string;
+    /** The fixed-container fragment: slides the panel off-screen. */
+    containerClassName: string;
+}
+declare function useCollapsiblePanel({ side, open: openProp, defaultOpen, onOpenChange, widthClassName, spacerCollapsedClassName, containerSlideClassNames, containerPosition, }?: UseCollapsiblePanelOptions): UseCollapsiblePanelReturn;
+
 declare const TooltipProvider: react.FC<TooltipPrimitive.TooltipProviderProps>;
 declare const Tooltip: react.FC<TooltipPrimitive.TooltipProps>;
 declare const TooltipTrigger: react.ForwardRefExoticComponent<TooltipPrimitive.TooltipTriggerProps & react.RefAttributes<HTMLButtonElement>>;
@@ -1265,6 +1406,16 @@ declare const Sidebar: react.ForwardRefExoticComponent<Omit<react.ClassAttribute
     side?: "left" | "right";
     variant?: "sidebar" | "floating" | "inset";
     collapsible?: "offcanvas" | "icon" | "none";
+    /**
+     * Where the rail's container pins itself. Default `"viewport"` (`fixed` to the window
+     * edge — today's behaviour, byte-identical). `"inset"` pins to the rail's own place in
+     * the layout instead (`absolute` against a `relative` wrapper this component provides),
+     * for a whole app frame rendered INSIDE a box — a preview pane, a docs page, a
+     * dashboard tile — where a `fixed` rail would escape to the window. Same seam as
+     * `SideDock`'s `containerPosition`. No effect on the mobile `Sheet` or on
+     * `collapsible="none"`.
+     */
+    containerPosition?: CollapsiblePanelContainerPosition;
 }, "ref"> & react.RefAttributes<HTMLDivElement>>;
 declare const SidebarTrigger: react.ForwardRefExoticComponent<Omit<ButtonProps & react.RefAttributes<HTMLButtonElement>, "ref"> & react.RefAttributes<HTMLButtonElement>>;
 declare const SidebarRail: react.ForwardRefExoticComponent<Omit<react.DetailedHTMLProps<react.ButtonHTMLAttributes<HTMLButtonElement>, HTMLButtonElement>, "ref"> & react.RefAttributes<HTMLButtonElement>>;
@@ -1394,10 +1545,17 @@ declare const Alert: react.ForwardRefExoticComponent<HTMLAttributes<HTMLDivEleme
 interface AlertTitleProps extends HTMLAttributes<HTMLHeadingElement> {
     /**
      * Render at a different heading level to fit the surrounding document
-     * outline (#329). The visual (`mb-1 font-medium leading-none
-     * tracking-tight`) is identical at every level. @default "h5"
+     * outline (#329), or as a `"div"` to stay out of the outline entirely. The
+     * visual (`mb-1 font-medium leading-none tracking-tight`) is identical for
+     * every value. @default "h5"
+     *
+     * `"div"` is for a title whose depth the author cannot know — content rendered
+     * into someone else's page, such as an A2UI surface, where a fixed `h5` breaks
+     * `heading-order` under any host that has no `h4` above it. The alert's own
+     * `role="alert"` announces the title either way, so nothing is lost; `CardTitle`
+     * makes the same default choice for the same reason.
      */
-    as?: "h1" | "h2" | "h3" | "h4" | "h5" | "h6";
+    as?: "div" | "h1" | "h2" | "h3" | "h4" | "h5" | "h6";
 }
 declare const AlertTitle: react.ForwardRefExoticComponent<AlertTitleProps & react.RefAttributes<HTMLHeadingElement>>;
 interface AlertDescriptionProps extends HTMLAttributes<HTMLParagraphElement> {
@@ -1421,11 +1579,91 @@ declare const AlertDialogDescription: react.ForwardRefExoticComponent<Omit<Alert
 declare const AlertDialogAction: react.ForwardRefExoticComponent<Omit<AlertDialogPrimitive.AlertDialogActionProps & react.RefAttributes<HTMLButtonElement>, "ref"> & react.RefAttributes<HTMLButtonElement>>;
 declare const AlertDialogCancel: react.ForwardRefExoticComponent<Omit<AlertDialogPrimitive.AlertDialogCancelProps & react.RefAttributes<HTMLButtonElement>, "ref"> & react.RefAttributes<HTMLButtonElement>>;
 
+/** Colour-role tokens an ambient stop or tint may reference (always `var(--<token>)`). */
+type AmbientToken = "primary" | "accent" | `chart-${1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12}` | "surface-1" | "surface-2" | "surface-3" | "info" | "success" | "warning" | "destructive";
+/** Default mesh: the brand colour, the second chart hue, and the deepest surface. */
+declare const AMBIENT_DEFAULT_STOPS: readonly AmbientToken[];
+/** The ceiling for the mesh alpha — an ambient ground stays under content, never competes. */
+declare const AMBIENT_MAX_ALPHA = 0.18;
+interface AmbientFieldProps extends react.HTMLAttributes<HTMLDivElement> {
+    /** Two or three colour tokens for the mesh; extra entries are ignored. */
+    stops?: readonly AmbientToken[];
+    /** Mesh alpha, clamped to 0…{@link AMBIENT_MAX_ALPHA}. Default 0.14. */
+    alpha?: number;
+    /** Run the slow 20 s drift (paused whenever the motion gate is at its floor). Default `true`. */
+    drift?: boolean;
+    /** Shift the first stop to this token (crossfades over `--t-base`); sets `data-ambient-tint`. */
+    tint?: AmbientToken;
+}
+/**
+ * A decorative ambient ground: a blurred radial mesh of token colours on a masked `::before`
+ * layer, absolutely positioned under its container's content. Put it first inside a positioned,
+ * `isolate` container. Pure CSS — renders the same on the server, animates only `transform`.
+ */
+declare const AmbientField: react.ForwardRefExoticComponent<AmbientFieldProps & react.RefAttributes<HTMLDivElement>>;
+
+/** `topBar` slots — see `AppShellProps.topBar`. */
+interface AppShellTopBarSlots {
+    /** Leading content, after the brand (when `brandPlacement="topbar"`). */
+    start?: ReactNode;
+    /** Centred content (e.g. a global search field) — see `TopNav`'s `center`. */
+    center?: ReactNode;
+    /** Trailing content (actions, account menu). */
+    end?: ReactNode;
+}
 interface AppShellProps {
-    /** Persistent left navigation (often a <Sidebar />). */
+    /**
+     * Persistent left navigation (often a <Sidebar />). Not rendered when
+     * `navigation="topbar"` — put the primary navigation in `topBar`/`topNav`
+     * instead.
+     */
     sidebar?: ReactNode;
-    /** Top bar (often a <TopNav />). */
+    /**
+     * Top bar (often a <TopNav />), a fully-formed node the caller already
+     * brought. **Wins over `topBar` when both are passed** — this shell never
+     * merges the two, so pass one or the other, never both. Use `topNav` when
+     * you want to compose `TopNav` (or any other element) yourself; use
+     * `topBar` for the common case where this shell should compose `TopNav`
+     * for you from plain slots.
+     */
     topNav?: ReactNode;
+    /**
+     * Slots this shell composes into a `TopNav` for you — the convenience path
+     * for the common case (see `topNav` for precedence when both are set).
+     * `center` renders through `TopNav`'s own `center` prop: a true 3-column
+     * grid, so centred content (e.g. a global search field) stays centred
+     * regardless of how wide `start`/`end` are.
+     */
+    topBar?: AppShellTopBarSlots;
+    /**
+     * Where the brand mark lives. `"sidebar"` (default) is today's behavior:
+     * this shell renders no brand of its own — the caller's `sidebar` node
+     * (e.g. a `SidebarHeader` / `TeamSwitcher`) owns it. `"topbar"` renders
+     * `brand` as the leading element of the top bar, before `topBar.start`.
+     * Has no effect without a `brand` node, and no effect when `topNav` is
+     * passed instead of `topBar` (bring your own top bar, bring your own
+     * brand placement inside it).
+     * @default "sidebar"
+     */
+    brandPlacement?: "sidebar" | "topbar";
+    /** Brand mark rendered in the top bar when `brandPlacement="topbar"`. */
+    brand?: ReactNode;
+    /**
+     * Where the primary navigation lives. `"sidebar"` (default) renders
+     * `sidebar` in the left column, unchanged. `"topbar"` renders no sidebar
+     * column at all — compose the primary navigation into `topBar`/`topNav`
+     * instead (e.g. a `NavigationMenu` in `topBar.center`).
+     * @default "sidebar"
+     */
+    navigation?: "sidebar" | "topbar";
+    /**
+     * A second column beside the sidebar (e.g. a resource/filter panel) —
+     * `w-(--shell-secondary-width)` (16rem by default, every theme), hidden
+     * below `md` exactly like `sidebar`. Independent of `navigation`/`sidebar`:
+     * renders whenever it is passed. Pure layout, like `sidebar` — bring your
+     * own chrome (background, border) on the node itself.
+     */
+    secondaryPanel?: ReactNode;
     children: ReactNode;
     className?: string;
     /** Class for the scrolling main content region. */
@@ -1462,6 +1700,14 @@ interface AppShellProps {
  * AppShell code change is needed to reach navigation below `md`, because
  * `SidebarProvider` is a plain React context and is never blocked by this
  * component's internal wrapper `<div>`.
+ *
+ * `brandPlacement`, `topBar`, `navigation` and `secondaryPanel` are all
+ * optional, off by default: with none of them passed this renders exactly
+ * what it always has (a `sidebar` column, `topNav` verbatim, `<main>`). They
+ * generalise the shape `Layout/App Shell/Flagship` already hand-builds —
+ * brand in the top bar, a centred search field, horizontal primary
+ * navigation, a second resource column — into props any consumer can reach
+ * for without hand-rolling the layout again.
  */
 declare const AppShell: react.ForwardRefExoticComponent<AppShellProps & react.RefAttributes<HTMLDivElement>>;
 
@@ -1559,13 +1805,6 @@ declare const Avatar: react.ForwardRefExoticComponent<Omit<AvatarPrimitive.Avata
 declare const AvatarImage: react.ForwardRefExoticComponent<Omit<AvatarPrimitive.AvatarImageProps & react.RefAttributes<HTMLImageElement>, "ref"> & react.RefAttributes<HTMLImageElement>>;
 declare const AvatarFallback: react.ForwardRefExoticComponent<Omit<AvatarPrimitive.AvatarFallbackProps & react.RefAttributes<HTMLSpanElement>, "ref"> & react.RefAttributes<HTMLSpanElement>>;
 
-declare const badgeVariants: (props?: ({
-    variant?: "default" | "secondary" | "outline" | "success" | "warning" | "destructive" | "info" | null | undefined;
-} & class_variance_authority_types.ClassProp) | undefined) => string;
-interface BadgeProps extends HTMLAttributes<HTMLSpanElement>, VariantProps<typeof badgeVariants> {
-}
-declare const Badge: react.ForwardRefExoticComponent<BadgeProps & react.RefAttributes<HTMLSpanElement>>;
-
 interface BentoGridProps extends HTMLAttributes<HTMLDivElement> {
     /** Additional className merged via cn(). */
     className?: string;
@@ -1765,6 +2004,13 @@ interface CardProps extends HTMLAttributes<HTMLDivElement>, VariantProps<typeof
     detailSize?: string;
     /** Accessible label for the detail region. @default "Details" */
     detailLabel?: string;
+    /**
+     * Opt-in hairline gesture: the edges of two sheets stacked behind the card's
+     * top edge (the `hairline-stack` utility). It draws OUTSIDE the card, so it
+     * needs ~12px of room above and a card that does not clip — a plain card, not
+     * a `detail` one (whose grid is `overflow-hidden`). @default false
+     */
+    stacked?: boolean;
 }
 declare const Card: react.ForwardRefExoticComponent<CardProps & react.RefAttributes<HTMLDivElement>>;
 declare const CardHeader: react.ForwardRefExoticComponent<HTMLAttributes<HTMLDivElement> & react.RefAttributes<HTMLDivElement>>;
@@ -1788,6 +2034,23 @@ interface CardDescriptionProps extends HTMLAttributes<HTMLParagraphElement> {
 }
 declare const CardDescription: react.ForwardRefExoticComponent<CardDescriptionProps & react.RefAttributes<HTMLParagraphElement>>;
 declare const CardAction: react.ForwardRefExoticComponent<HTMLAttributes<HTMLDivElement> & react.RefAttributes<HTMLDivElement>>;
+declare const cardMediaVariants: (props?: ({
+    ground?: "none" | "hatch" | "dots" | null | undefined;
+    fade?: "bottom" | "top" | "center" | "edges" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+interface CardMediaProps extends HTMLAttributes<HTMLDivElement>, VariantProps<typeof cardMediaVariants> {
+}
+/**
+ * The card's media WELL — the recessed region that holds an illustration, a
+ * mini chart, a product fragment or a logo grid. Its ground is a faded hairline
+ * hatch by default (`ground="dots"` for a dot field, `"none"` for a bare well),
+ * painted on an inert layer behind the media, so whatever you put in it sits ON
+ * the texture and is never tinted or masked by it.
+ *
+ * Place it above `CardHeader` (media first) or below `CardContent`. It centres
+ * its children; pass `className` to change that.
+ */
+declare const CardMedia: react.ForwardRefExoticComponent<CardMediaProps & react.RefAttributes<HTMLDivElement>>;
 declare const CardContent: react.ForwardRefExoticComponent<HTMLAttributes<HTMLDivElement> & react.RefAttributes<HTMLDivElement>>;
 declare const CardFooter: react.ForwardRefExoticComponent<HTMLAttributes<HTMLDivElement> & react.RefAttributes<HTMLDivElement>>;
 
@@ -1983,56 +2246,6 @@ declare const Collapsible: react.ForwardRefExoticComponent<CollapsiblePrimitive.
 declare const CollapsibleTrigger: react.ForwardRefExoticComponent<CollapsiblePrimitive.CollapsibleTriggerProps & react.RefAttributes<HTMLButtonElement>>;
 declare const CollapsibleContent: react.ForwardRefExoticComponent<Omit<CollapsiblePrimitive.CollapsibleContentProps & react.RefAttributes<HTMLDivElement>, "ref"> & react.RefAttributes<HTMLDivElement>>;
 
-type CollapsiblePanelSide = "left" | "right";
-type CollapsiblePanelState = "expanded" | "collapsed";
-interface UseCollapsiblePanelOptions {
-    /** Which edge the panel lives on. Default `"left"`. */
-    side?: CollapsiblePanelSide;
-    /** Controlled open state (`isControlled = open !== undefined`). */
-    open?: boolean;
-    /** Uncontrolled initial open state. Default `true`. */
-    defaultOpen?: boolean;
-    /** Called with the next open state on `setOpen`/`toggle`. */
-    onOpenChange?: (open: boolean) => void;
-    /**
-     * Literal expanded-width utility (e.g. `"w-(--sidebar-width)"`). Must be a
-     * literal in the consumer's source so Tailwind generates it.
-     */
-    widthClassName?: string;
-    /**
-     * Literal collapsed-state utility for the gap spacer (e.g.
-     * `"group-data-[collapsible=offcanvas]:w-0"`).
-     */
-    spacerCollapsedClassName?: string;
-    /**
-     * Literal off-screen slide utilities for the fixed container, keyed by side
-     * (e.g. `left: "left-0 group-data-[collapsible=offcanvas]:left-[calc(var(--sidebar-width)*-1)]"`).
-     */
-    containerSlideClassNames?: Record<CollapsiblePanelSide, string>;
-}
-/** Data attributes for the panel's `group` element. */
-interface CollapsiblePanelAttrs {
-    "data-state": CollapsiblePanelState;
-    "data-side": CollapsiblePanelSide;
-}
-interface UseCollapsiblePanelReturn {
-    /** Resolved open state (controlled prop wins). */
-    open: boolean;
-    /** `"expanded"` when open, `"collapsed"` when closed. */
-    state: CollapsiblePanelState;
-    side: CollapsiblePanelSide;
-    /** Set the open state (accepts a value or an updater fn). */
-    setOpen: (open: boolean | ((open: boolean) => boolean)) => void;
-    toggle: () => void;
-    /** `data-state`/`data-side` for the group element wrapping both fragments. */
-    attrs: CollapsiblePanelAttrs;
-    /** The gap-spacer fragment: reserves/releases the inline width. */
-    spacerClassName: string;
-    /** The fixed-container fragment: slides the panel off-screen. */
-    containerClassName: string;
-}
-declare function useCollapsiblePanel({ side, open: openProp, defaultOpen, onOpenChange, widthClassName, spacerCollapsedClassName, containerSlideClassNames, }?: UseCollapsiblePanelOptions): UseCollapsiblePanelReturn;
-
 /**
  * The semantic color token names that ColorPicker understands as "safe" values.
  * These map 1-to-1 with Tailwind utilities backed by CSS variables so they
@@ -2654,6 +2867,13 @@ declare const descriptionsVariants: (props?: ({
     columns?: 1 | 2 | 3 | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 type DescriptionsLayout = "horizontal" | "vertical";
+/**
+ * The label column's share of a `horizontal` item. Static class names, never
+ * a computed `w-[…]`, so Tailwind can see them. `"1/3"` is the default and
+ * the historical render; `"1/4"`/`"1/5"` suit a record whose labels are
+ * short ("What it did", "Owner") and whose values are sentences.
+ */
+type DescriptionsLabelWidth = "1/3" | "1/4" | "1/5";
 interface DescriptionsProps extends HTMLAttributes<HTMLDListElement>, VariantProps<typeof descriptionsVariants> {
     /**
      * Number of columns at the widest breakpoint. Collapses to a single column
@@ -2665,6 +2885,11 @@ interface DescriptionsProps extends HTMLAttributes<HTMLDListElement>, VariantPro
      * label above the value. Default `horizontal`.
      */
     layout?: DescriptionsLayout;
+    /**
+     * Width of the label column in the `horizontal` layout, as a share of the
+     * item. Default `"1/3"`. Ignored by `vertical`.
+     */
+    labelWidth?: DescriptionsLabelWidth;
 }
 /**
  * Descriptions — a responsive definition list of label↔value pairs.
@@ -3164,7 +3389,7 @@ type TextareaProps = TextareaHTMLAttributes<HTMLTextAreaElement>;
 declare const Textarea: react.ForwardRefExoticComponent<TextareaProps & react.RefAttributes<HTMLTextAreaElement>>;
 
 declare const inputGroupVariants: (props?: ({
-    variant?: "outline" | "card" | "surface" | null | undefined;
+    variant?: "card" | "outline" | "surface" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 type InputGroupProps = ComponentProps<"div"> & VariantProps<typeof inputGroupVariants>;
 declare const InputGroup: react.ForwardRefExoticComponent<Omit<InputGroupProps, "ref"> & react.RefAttributes<HTMLDivElement>>;
@@ -3918,13 +4143,40 @@ declare const ModelPicker: react.ForwardRefExoticComponent<ModelPickerProps & re
  * each side so a drift shows up as a failing test rather than as two surfaces
  * disagreeing about what `1500` looks like.
  */
-/** How a numeric value is rendered. Mirrors the charts `ChartValueFormat`. */
+/** How a numeric value is rendered. Mirrors the charts `ChartValueFormatPreset`. */
 type NumberFormatKind = "number" | "compact" | "currency" | "percent";
+/**
+ * The object form of {@link NumberFormat} (RM-109) — decimals, sign,
+ * prefix/suffix and abbreviation as independent knobs. Mirrors the charts
+ * `ChartValueFormatSpec` field-for-field; see that type's docblock
+ * (`packages/charts/src/charts/value-format.ts`) for the full contract of
+ * each field — this is the DELIBERATE TWIN, not a reinterpretation.
+ */
+interface NumberFormatSpec {
+    style?: "number" | "currency" | "percent";
+    decimals?: number;
+    optionalDecimals?: boolean;
+    abbreviate?: boolean | "auto";
+    sign?: "auto" | "always" | "parens";
+    prefix?: string;
+    suffix?: string;
+    grouping?: boolean;
+    currency?: string;
+}
+/** A preset string or the {@link NumberFormatSpec} object form (RM-109). */
+type NumberFormat = NumberFormatKind | NumberFormatSpec;
 
 declare const metricValueVariants: (props?: ({
     emphasis?: "default" | "headline" | null | undefined;
+    size?: "md" | "sm" | "lg" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 type MetricCardEmphasis = NonNullable<VariantProps<typeof metricValueVariants>["emphasis"]>;
+/**
+ * Tile tier (RM-072). `sm`: label + value only (no icon, delta, description,
+ * sparkline, visual or evidence); `md`: the default tile; `lg`: the kpi value
+ * rung with more room for the `sparkline` slot.
+ */
+type MetricCardSize = NonNullable<VariantProps<typeof metricValueVariants>["size"]>;
 /**
  * How a NUMERIC `value` is rendered. A function takes over completely.
  *
@@ -3933,8 +4185,15 @@ type MetricCardEmphasis = NonNullable<VariantProps<typeof metricValueVariants>["
  * away via `CopyableValue`. Anything that is not a `number` (a string, an
  * element) is passed through untouched, so every existing call site is
  * unaffected.
+ *
+ * Also accepts the object form (RM-109, `NumberFormatSpec` —
+ * `{ decimals, abbreviate, sign, prefix, suffix, … }`,
+ * `packages/ui/src/lib/compact-number.ts`) for a tile that needs e.g.
+ * `{ decimals: 1, suffix: "%" }` without hand-formatting the string itself.
+ * The two preset-string cases render byte-for-byte as before this type
+ * widened — only a spec OBJECT argument reaches the new code path.
  */
-type MetricCardValueFormat = NumberFormatKind | ((value: number) => ReactNode);
+type MetricCardValueFormat = NumberFormat | ((value: number) => ReactNode);
 interface MetricCardProps extends HTMLAttributes<HTMLDivElement>, VariantProps<typeof metricValueVariants> {
     label: ReactNode;
     value: ReactNode;
@@ -3959,8 +4218,13 @@ interface MetricCardProps extends HTMLAttributes<HTMLDivElement>, VariantProps<t
     /** Whether "up" is good (green) — flip for metrics where down is good. */
     positiveIsGood?: boolean;
     icon?: ReactNode;
-    /** Optional inline visual (e.g. a sparkline) shown under the value/description. */
+    /** Optional inline visual shown under the value/description. */
     visual?: ReactNode;
+    /**
+     * Trend slot rendered directly under the value (RM-072) — pass a
+     * `<Sparkline …/>` from `@elabs-ai/components-charts`. Hidden at `size="sm"`.
+     */
+    sparkline?: ReactNode;
     /**
      * Optional grounding footer (research 11 §B.5 KPI-3) — connects a cited
      * figure to its source (e.g. an `EvidenceChip` from `@elabs-ai/components-ai`). Rendered
@@ -4077,16 +4341,28 @@ interface NavUserUser {
 }
 interface NavUserProps {
     user: NavUserUser;
+    /** Fires when "Settings" is chosen. Ignored when `settingsHref` is set. */
+    onSettings?: () => void;
+    /** Route of the settings screen — "Settings" renders as a link to it. */
+    settingsHref?: string;
+    /** Fires when "Sign out" is chosen. */
+    onSignOut?: () => void;
+    /**
+     * Extra `DropdownMenuItem`s, placed above "Settings" (e.g. Profile, Billing).
+     * Settings and Sign out are always present — they are the standard pair.
+     */
+    children?: ReactNode;
 }
 /**
- * Sidebar account / user menu. Shared primitive from sidebar-04 (issue #99).
- * Renders a trigger showing name + email + avatar; the dropdown exposes
- * account, billing, notifications and log-out actions.
+ * The standard sidebar footer: the signed-in user (avatar, name, email) as one
+ * row that opens the account menu — Settings, then Sign out. EVERY app shell's
+ * nav rail ends with this; settings never sits in the footer as a loose nav
+ * row, and the footer carries no environment/meta line.
  *
- * Wire your own action handlers by composing custom `DropdownMenuItem` children
- * if you need more than the default actions — or extend via className.
+ * Collapsed to the 48px icon rail the row is the avatar alone, and its
+ * accessible name is written out because the visible label is gone.
  */
-declare function NavUser({ user }: NavUserProps): react.JSX.Element;
+declare function NavUser({ user, onSettings, settingsHref, onSignOut, children }: NavUserProps): react.JSX.Element;
 
 declare const NavigationMenu: react.ForwardRefExoticComponent<Omit<NavigationMenuPrimitive.NavigationMenuProps & react.RefAttributes<HTMLElement>, "ref"> & react.RefAttributes<HTMLElement>>;
 declare const NavigationMenuList: react.ForwardRefExoticComponent<Omit<NavigationMenuPrimitive.NavigationMenuListProps & react.RefAttributes<HTMLUListElement>, "ref"> & react.RefAttributes<HTMLUListElement>>;
@@ -4106,12 +4382,12 @@ interface PageShellProps extends ComponentProps<"div"> {
      * Byte-identical to today.
      *
      * "toolbar" — for a `<ViewToolbar>` header (`@elabs-ai/components-ui`,
-     * `Docs/View Toolbar Contract`): wraps `header` in a `sticky top-0` container
+     * `Layout/ViewToolbar → Contract`): wraps `header` in a `sticky top-0` container
      * with an opaque/blurred fill and a bottom hairline, so it stays pinned while
      * the body scrolls beneath it. PLACES whatever node `header` is — it does not
      * reimplement ViewToolbar's own info/left-cluster/actions grammar, and it does
      * NOT cap the row's height (a `<ViewToolbar>` wraps at narrow widths; see
-     * `Docs/View Toolbar Contract` R7).
+     * `Layout/ViewToolbar → Contract` R7).
      */
     headerVariant?: "default" | "toolbar";
     /** Constrain content width. Defaults to "xl". */
@@ -4164,6 +4440,85 @@ declare function PaginationPrevious({ className, ...props }: ComponentProps<"a">
 declare function PaginationNext({ className, ...props }: ComponentProps<"a">): react.JSX.Element;
 declare function PaginationEllipsis({ className, ...props }: ComponentProps<"span">): react.JSX.Element;
 
+/** The three depth planes of a page: the ground, the content, and floating accents. */
+type ParallaxPlaneKind = "ground" | "content" | "float";
+/** Default scroll rate per plane, relative to the page (content moves with it at 1×). */
+declare const PARALLAX_PLANE_RATES: Record<ParallaxPlaneKind, number>;
+/** The largest offset, in px, any plane may drift from the content plane. */
+declare const PARALLAX_MAX_TRAVEL = 60;
+interface ParallaxPlaneProps extends react.HTMLAttributes<HTMLDivElement> {
+    /** Which depth plane this is; sets `data-plane` and the default `rate`. Default `content`. */
+    plane?: ParallaxPlaneKind;
+    /** Scroll rate relative to the page (1 = moves with the content). Defaults per `plane`. */
+    rate?: number;
+}
+/**
+ * Offset of a plane from the content plane after `scrollY` px of scroll: `(1 − rate) × factor`
+ * per px, clamped to ±{@link PARALLAX_MAX_TRAVEL}. Reduced motion (factor at the floor) gives an
+ * effective rate of 1 for every plane — no parallax.
+ */
+declare function parallaxOffset(scrollY: number, rate: number, factor: number): number;
+/**
+ * A depth plane that scrolls at its own rate. Uses CSS `animation-timeline: scroll(root)` where
+ * the browser has it, else `motion`'s `scroll()` (lazy optional peer) writing `transform`. The
+ * server HTML has no transform; motion starts after hydration and only when the gate is open.
+ * The plane owns its `transform` — put layout transforms on a child.
+ */
+declare const ParallaxPlane: react.ForwardRefExoticComponent<ParallaxPlaneProps & react.RefAttributes<HTMLDivElement>>;
+
+/**
+ * Meter — a word-sized read-only quantity: a confidence, a share of a
+ * ceiling, "4 of 5 signals held".
+ *
+ * NOT a `Progress` (dedupe audit, 2026-09-18): `Progress` is a
+ * `role="progressbar"` — assistive tech announces it as a task in flight and
+ * it is block-level by design. A meter is the ARIA `meter` role: a scalar
+ * within a known range that is not going anywhere. The two share the visual
+ * recipe (track, fill, an optional reference tick) so a page that mixes them
+ * reads as one system; they differ in semantics, default ink and size.
+ *
+ * - Default fill is `foreground` ink, not `primary`: a quantity is a fact,
+ *   not an action or a status. The status tones exist for the case where the
+ *   quantity IS a verdict (over a ceiling → `destructive`), and a non-default
+ *   tone must be paired with `aria-valuetext` so the state is never color-only.
+ * - `segments` turns the continuous track into a countable strip of discrete
+ *   cells ("|||| 4 of 5"): five facts read better as five marks than as 80%.
+ * - `marker` draws a reference tick (a ceiling, a target) outside the clipped
+ *   track, exactly as `Progress.marker` does; `markerLabel` joins the value
+ *   text so AT hears the reference too.
+ */
+declare const meterVariants: (props?: ({
+    size?: "md" | "sm" | "xs" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+declare const meterFillVariants: (props?: ({
+    variant?: "default" | "success" | "warning" | "destructive" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+interface MeterProps extends Omit<HTMLAttributes<HTMLDivElement>, "children">, VariantProps<typeof meterVariants>, VariantProps<typeof meterFillVariants> {
+    /** The measured value. Clamped to `[min, max]` for the fill; reported as-is to AT. */
+    value: number;
+    /** Range floor. Default 0. */
+    min?: number;
+    /** Range ceiling. Default 100. */
+    max?: number;
+    /**
+     * Draw the track as this many discrete cells instead of one continuous
+     * fill; the value fills `round((value − min) / (max − min) × segments)` of
+     * them. For "n of m" facts pass `segments={m}` with `max={m}`.
+     */
+    segments?: number;
+    /**
+     * Reference point on the same scale as `value` (a ceiling, a target),
+     * rendered as a thin vertical tick on the track. Unset renders no tick.
+     */
+    marker?: number;
+    /**
+     * What `marker` represents, already localized ("ceiling $500"). Appended to
+     * the accessible value text; a caller-supplied `aria-valuetext` always wins.
+     */
+    markerLabel?: string;
+}
+declare const Meter: react.ForwardRefExoticComponent<MeterProps & react.RefAttributes<HTMLDivElement>>;
+
 /**
  * Tone vocabulary reused from `StatusBadge`/`Alert` (success/warning/destructive
  * on semantic tokens, #358) rather than reinvented. `default` keeps the fill
@@ -4173,6 +4528,23 @@ declare const progressIndicatorVariants: (props?: ({
     variant?: "default" | "success" | "warning" | "destructive" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 interface ProgressProps extends ComponentPropsWithoutRef<typeof ProgressPrimitive.Root>, VariantProps<typeof progressIndicatorVariants> {
+    /**
+     * Reference point (0–100, same scale as `value`) — e.g. an "expected by
+     * today" pace or a target — rendered as a thin vertical tick on the track.
+     * Unset (default) renders no tick and leaves the DOM/layout byte-identical
+     * to a marker-less `Progress`.
+     */
+    marker?: number;
+    /**
+     * What `marker` represents (already localized by the caller — e.g.
+     * `"expected 70% by today"`). When set, it is appended to the progress
+     * bar's accessible value text so assistive tech hears the reference point
+     * alongside the value; a caller-supplied `aria-valuetext` always wins over
+     * this composition. When `marker` is set but `markerLabel` is not, the
+     * tick is purely decorative and `aria-valuetext` is left untouched — this
+     * component never invents its own English copy (i18n-strings).
+     */
+    markerLabel?: string;
 }
 /**
  * Color must not be the only signal a guardrail tripped: set `aria-valuetext`
@@ -4217,7 +4589,7 @@ interface RatingProps extends Omit<HTMLAttributes<HTMLDivElement>, "onChange" |
 declare const Rating: react.ForwardRefExoticComponent<RatingProps & react.RefAttributes<HTMLDivElement>>;
 
 declare const ResizablePanelGroup: ForwardRefExoticComponent<React.ComponentProps<typeof ResizablePrimitive.PanelGroup> & RefAttributes<ResizablePrimitive.ImperativePanelGroupHandle>>;
-declare const ResizablePanel: ForwardRefExoticComponent<Omit<react.HTMLAttributes<HTMLAnchorElement | HTMLElement | HTMLDivElement | HTMLSpanElement | HTMLObjectElement | HTMLTitleElement | HTMLBodyElement | HTMLMetaElement | HTMLParagraphElement | HTMLSelectElement | HTMLLinkElement | HTMLInputElement | HTMLAreaElement | HTMLAudioElement | HTMLBaseElement | HTMLQuoteElement | HTMLBRElement | HTMLButtonElement | HTMLCanvasElement | HTMLTableColElement | HTMLDataElement | HTMLDataListElement | HTMLModElement | HTMLDetailsElement | HTMLDialogElement | HTMLDListElement | HTMLEmbedElement | HTMLFieldSetElement | HTMLFormElement | HTMLHeadingElement | HTMLHeadElement | HTMLHRElement | HTMLHtmlElement | HTMLIFrameElement | HTMLImageElement | HTMLLabelElement | HTMLLegendElement | HTMLLIElement | HTMLMapElement | HTMLMeterElement | HTMLOListElement | HTMLOptGroupElement | HTMLOptionElement | HTMLOutputElement | HTMLPreElement | HTMLProgressElement | HTMLScriptElement | HTMLSlotElement | HTMLSourceElement | HTMLStyleElement | HTMLTableElement | HTMLTableSectionElement | HTMLTableCellElement | HTMLTemplateElement | HTMLTextAreaElement | HTMLTimeElement | HTMLTableRowElement | HTMLTrackElement | HTMLUListElement | HTMLVideoElement | HTMLTableCaptionElement | HTMLMenuElement | HTMLPictureElement>, "id" | "onResize"> & {
+declare const ResizablePanel: ForwardRefExoticComponent<Omit<react.HTMLAttributes<HTMLElement | HTMLAnchorElement | HTMLDivElement | HTMLSpanElement | HTMLObjectElement | HTMLTitleElement | HTMLBodyElement | HTMLMetaElement | HTMLParagraphElement | HTMLSelectElement | HTMLLinkElement | HTMLInputElement | HTMLDialogElement | HTMLScriptElement | HTMLAreaElement | HTMLAudioElement | HTMLBaseElement | HTMLQuoteElement | HTMLBRElement | HTMLButtonElement | HTMLCanvasElement | HTMLTableColElement | HTMLDataElement | HTMLDataListElement | HTMLModElement | HTMLDetailsElement | HTMLDListElement | HTMLEmbedElement | HTMLFieldSetElement | HTMLFormElement | HTMLHeadingElement | HTMLHeadElement | HTMLHRElement | HTMLHtmlElement | HTMLIFrameElement | HTMLImageElement | HTMLLabelElement | HTMLLegendElement | HTMLLIElement | HTMLMapElement | HTMLMeterElement | HTMLOListElement | HTMLOptGroupElement | HTMLOptionElement | HTMLOutputElement | HTMLPreElement | HTMLProgressElement | HTMLSlotElement | HTMLSourceElement | HTMLStyleElement | HTMLTableElement | HTMLTableSectionElement | HTMLTableCellElement | HTMLTemplateElement | HTMLTextAreaElement | HTMLTimeElement | HTMLTableRowElement | HTMLTrackElement | HTMLUListElement | HTMLVideoElement | HTMLTableCaptionElement | HTMLMenuElement | HTMLPictureElement>, "id" | "onResize"> & {
     className?: string | undefined;
     collapsedSize?: number | undefined;
     collapsible?: boolean | undefined;
@@ -4253,7 +4625,7 @@ declare function ResizableHandle({ withHandle, className, hitAreaMargins, ...pro
  * start state through any stagger delay so items don't flash in early.
  */
 declare const revealVariants: (props?: ({
-    appear?: "left" | "right" | "zoom" | "up" | "down" | "fade" | null | undefined;
+    appear?: "left" | "right" | "zoom" | "fade" | "up" | "down" | null | undefined;
     speed?: "base" | "fast" | "slow" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 interface RevealProps extends HTMLAttributes<HTMLDivElement>, VariantProps<typeof revealVariants> {
@@ -4278,6 +4650,22 @@ interface RevealGroupProps extends HTMLAttributes<HTMLDivElement>, VariantProps<
  */
 declare const RevealGroup: react.ForwardRefExoticComponent<RevealGroupProps & react.RefAttributes<HTMLDivElement>>;
 
+/** Elements RevealOnEnter may render as. */
+type RevealOnEnterElement = "div" | "section" | "article" | "aside" | "header" | "footer" | "ul" | "ol" | "li";
+interface RevealOnEnterProps extends react.HTMLAttributes<HTMLElement> {
+    /** The element to render. Default `div`. */
+    as?: RevealOnEnterElement;
+    /** Reveal each direct child in turn (60 ms × `--motion-factor` apart) instead of the whole. */
+    stagger?: boolean;
+}
+/**
+ * Fades and lifts its content in the first time it scrolls into view — once, never re-hiding.
+ * Content is never hidden from a reader or a crawler: the server HTML is fully visible, and the
+ * hidden state is applied only after hydration, only when the motion gate is open, only when
+ * `IntersectionObserver` exists, and only for content that is not already on screen.
+ */
+declare const RevealOnEnter: react.ForwardRefExoticComponent<RevealOnEnterProps & react.RefAttributes<HTMLElement>>;
+
 /**
  * schema-form-spec.ts — Serializable FormSpec for SchemaForm.
  *
@@ -4375,16 +4763,22 @@ declare const stringFieldSchema: z.ZodObject<{
         field: string;
         equals: string | number | boolean;
     }>>;
+    /**
+     * Show the value as read-only text (a `Descriptions` item) instead of an
+     * editable control. The value still belongs to the form's `values`.
+     */
+    readOnly: z.ZodOptional<z.ZodBoolean>;
     type: z.ZodLiteral<"string">;
 }, "strip", z.ZodTypeAny, {
     name: string;
     type: "string";
-    label?: string | undefined;
     default?: string | undefined;
+    label?: string | undefined;
     format?: "email" | "date" | "uri" | "date-time" | undefined;
     pattern?: string | undefined;
     maxLength?: number | undefined;
     minLength?: number | undefined;
+    readOnly?: boolean | undefined;
     required?: boolean | undefined;
     description?: string | undefined;
     multiline?: boolean | undefined;
@@ -4395,12 +4789,13 @@ declare const stringFieldSchema: z.ZodObject<{
 }, {
     name: string;
     type: "string";
-    label?: string | undefined;
     default?: string | undefined;
+    label?: string | undefined;
     format?: "email" | "date" | "uri" | "date-time" | undefined;
     pattern?: string | undefined;
     maxLength?: number | undefined;
     minLength?: number | undefined;
+    readOnly?: boolean | undefined;
     required?: boolean | undefined;
     description?: string | undefined;
     multiline?: boolean | undefined;
@@ -4443,14 +4838,20 @@ declare const numberFieldSchema: z.ZodObject<{
         field: string;
         equals: string | number | boolean;
     }>>;
+    /**
+     * Show the value as read-only text (a `Descriptions` item) instead of an
+     * editable control. The value still belongs to the form's `values`.
+     */
+    readOnly: z.ZodOptional<z.ZodBoolean>;
     type: z.ZodLiteral<"number">;
 }, "strip", z.ZodTypeAny, {
     name: string;
     type: "number";
-    label?: string | undefined;
     default?: number | undefined;
+    label?: string | undefined;
     max?: number | undefined;
     min?: number | undefined;
+    readOnly?: boolean | undefined;
     required?: boolean | undefined;
     description?: string | undefined;
     visibleWhen?: {
@@ -4460,10 +4861,11 @@ declare const numberFieldSchema: z.ZodObject<{
 }, {
     name: string;
     type: "number";
-    label?: string | undefined;
     default?: number | undefined;
+    label?: string | undefined;
     max?: number | undefined;
     min?: number | undefined;
+    readOnly?: boolean | undefined;
     required?: boolean | undefined;
     description?: string | undefined;
     visibleWhen?: {
@@ -4505,14 +4907,20 @@ declare const integerFieldSchema: z.ZodObject<{
         field: string;
         equals: string | number | boolean;
     }>>;
+    /**
+     * Show the value as read-only text (a `Descriptions` item) instead of an
+     * editable control. The value still belongs to the form's `values`.
+     */
+    readOnly: z.ZodOptional<z.ZodBoolean>;
     type: z.ZodLiteral<"integer">;
 }, "strip", z.ZodTypeAny, {
     name: string;
     type: "integer";
-    label?: string | undefined;
     default?: number | undefined;
+    label?: string | undefined;
     max?: number | undefined;
     min?: number | undefined;
+    readOnly?: boolean | undefined;
     required?: boolean | undefined;
     description?: string | undefined;
     visibleWhen?: {
@@ -4522,10 +4930,11 @@ declare const integerFieldSchema: z.ZodObject<{
 }, {
     name: string;
     type: "integer";
-    label?: string | undefined;
     default?: number | undefined;
+    label?: string | undefined;
     max?: number | undefined;
     min?: number | undefined;
+    readOnly?: boolean | undefined;
     required?: boolean | undefined;
     description?: string | undefined;
     visibleWhen?: {
@@ -4565,12 +4974,18 @@ declare const booleanFieldSchema: z.ZodObject<{
         field: string;
         equals: string | number | boolean;
     }>>;
+    /**
+     * Show the value as read-only text (a `Descriptions` item) instead of an
+     * editable control. The value still belongs to the form's `values`.
+     */
+    readOnly: z.ZodOptional<z.ZodBoolean>;
     type: z.ZodLiteral<"boolean">;
 }, "strip", z.ZodTypeAny, {
     name: string;
     type: "boolean";
-    label?: string | undefined;
     default?: boolean | undefined;
+    label?: string | undefined;
+    readOnly?: boolean | undefined;
     required?: boolean | undefined;
     description?: string | undefined;
     visibleWhen?: {
@@ -4580,8 +4995,9 @@ declare const booleanFieldSchema: z.ZodObject<{
 }, {
     name: string;
     type: "boolean";
-    label?: string | undefined;
     default?: boolean | undefined;
+    label?: string | undefined;
+    readOnly?: boolean | undefined;
     required?: boolean | undefined;
     description?: string | undefined;
     visibleWhen?: {
@@ -4631,6 +5047,11 @@ declare const enumFieldSchema: z.ZodObject<{
         field: string;
         equals: string | number | boolean;
     }>>;
+    /**
+     * Show the value as read-only text (a `Descriptions` item) instead of an
+     * editable control. The value still belongs to the form's `values`.
+     */
+    readOnly: z.ZodOptional<z.ZodBoolean>;
     type: z.ZodLiteral<"enum">;
 }, "strip", z.ZodTypeAny, {
     name: string;
@@ -4639,8 +5060,9 @@ declare const enumFieldSchema: z.ZodObject<{
         const: string;
         title?: string | undefined;
     })[];
-    label?: string | undefined;
     default?: string | undefined;
+    label?: string | undefined;
+    readOnly?: boolean | undefined;
     required?: boolean | undefined;
     description?: string | undefined;
     visibleWhen?: {
@@ -4654,8 +5076,9 @@ declare const enumFieldSchema: z.ZodObject<{
         const: string;
         title?: string | undefined;
     })[];
-    label?: string | undefined;
     default?: string | undefined;
+    label?: string | undefined;
+    readOnly?: boolean | undefined;
     required?: boolean | undefined;
     description?: string | undefined;
     visibleWhen?: {
@@ -4705,6 +5128,11 @@ declare const multiEnumFieldSchema: z.ZodObject<{
         field: string;
         equals: string | number | boolean;
     }>>;
+    /**
+     * Show the value as read-only text (a `Descriptions` item) instead of an
+     * editable control. The value still belongs to the form's `values`.
+     */
+    readOnly: z.ZodOptional<z.ZodBoolean>;
     type: z.ZodLiteral<"multi-enum">;
 }, "strip", z.ZodTypeAny, {
     name: string;
@@ -4713,8 +5141,9 @@ declare const multiEnumFieldSchema: z.ZodObject<{
         const: string;
         title?: string | undefined;
     })[];
-    label?: string | undefined;
     default?: string[] | undefined;
+    label?: string | undefined;
+    readOnly?: boolean | undefined;
     required?: boolean | undefined;
     description?: string | undefined;
     visibleWhen?: {
@@ -4728,8 +5157,9 @@ declare const multiEnumFieldSchema: z.ZodObject<{
         const: string;
         title?: string | undefined;
     })[];
-    label?: string | undefined;
     default?: string[] | undefined;
+    label?: string | undefined;
+    readOnly?: boolean | undefined;
     required?: boolean | undefined;
     description?: string | undefined;
     visibleWhen?: {
@@ -4772,12 +5202,18 @@ declare const listFieldSchema: z.ZodObject<{
         field: string;
         equals: string | number | boolean;
     }>>;
+    /**
+     * Show the value as read-only text (a `Descriptions` item) instead of an
+     * editable control. The value still belongs to the form's `values`.
+     */
+    readOnly: z.ZodOptional<z.ZodBoolean>;
     type: z.ZodLiteral<"list">;
 }, "strip", z.ZodTypeAny, {
     name: string;
     type: "list";
-    label?: string | undefined;
     default?: string[] | undefined;
+    label?: string | undefined;
+    readOnly?: boolean | undefined;
     required?: boolean | undefined;
     description?: string | undefined;
     visibleWhen?: {
@@ -4790,8 +5226,9 @@ declare const listFieldSchema: z.ZodObject<{
 }, {
     name: string;
     type: "list";
-    label?: string | undefined;
     default?: string[] | undefined;
+    label?: string | undefined;
+    readOnly?: boolean | undefined;
     required?: boolean | undefined;
     description?: string | undefined;
     visibleWhen?: {
@@ -4849,16 +5286,22 @@ declare const keyValueFieldSchema: z.ZodObject<{
         field: string;
         equals: string | number | boolean;
     }>>;
+    /**
+     * Show the value as read-only text (a `Descriptions` item) instead of an
+     * editable control. The value still belongs to the form's `values`.
+     */
+    readOnly: z.ZodOptional<z.ZodBoolean>;
     type: z.ZodLiteral<"key-value">;
 }, "strip", z.ZodTypeAny, {
     name: string;
     type: "key-value";
-    label?: string | undefined;
     default?: {
         key: string;
         value: string;
         secret?: boolean | undefined;
     }[] | undefined;
+    label?: string | undefined;
+    readOnly?: boolean | undefined;
     required?: boolean | undefined;
     description?: string | undefined;
     keyPlaceholder?: string | undefined;
@@ -4870,12 +5313,13 @@ declare const keyValueFieldSchema: z.ZodObject<{
 }, {
     name: string;
     type: "key-value";
-    label?: string | undefined;
     default?: {
         key: string;
         value: string;
         secret?: boolean | undefined;
     }[] | undefined;
+    label?: string | undefined;
+    readOnly?: boolean | undefined;
     required?: boolean | undefined;
     description?: string | undefined;
     keyPlaceholder?: string | undefined;
@@ -4923,6 +5367,11 @@ declare const fileFieldSchema: z.ZodObject<{
         field: string;
         equals: string | number | boolean;
     }>>;
+    /**
+     * Show the value as read-only text (a `Descriptions` item) instead of an
+     * editable control. The value still belongs to the form's `values`.
+     */
+    readOnly: z.ZodOptional<z.ZodBoolean>;
     type: z.ZodLiteral<"file">;
 }, "strip", z.ZodTypeAny, {
     name: string;
@@ -4930,6 +5379,7 @@ declare const fileFieldSchema: z.ZodObject<{
     label?: string | undefined;
     accept?: string | undefined;
     multiple?: boolean | undefined;
+    readOnly?: boolean | undefined;
     required?: boolean | undefined;
     description?: string | undefined;
     maxSize?: number | undefined;
@@ -4944,6 +5394,7 @@ declare const fileFieldSchema: z.ZodObject<{
     label?: string | undefined;
     accept?: string | undefined;
     multiple?: boolean | undefined;
+    readOnly?: boolean | undefined;
     required?: boolean | undefined;
     description?: string | undefined;
     maxSize?: number | undefined;
@@ -5025,19 +5476,77 @@ declare const formSpecSchema: z.ZodObject<{
     fields: z.ZodArray<z.ZodType<FieldSpec, z.ZodTypeDef, FieldSpec>, "many">;
     /** Submit button label. @default "Submit" */
     submitLabel: z.ZodOptional<z.ZodString>;
+    /**
+     * Collapsible groups of top-level fields, in display order. Fields not named
+     * in any section render first, ungrouped. Omit for the flat layout.
+     */
+    sections: z.ZodOptional<z.ZodArray<z.ZodLazy<z.ZodObject<{
+        /** Stable key for the section. */
+        id: z.ZodString;
+        /** Heading on the section's disclosure trigger. */
+        label: z.ZodString;
+        /** Names of the top-level fields the section holds, in display order. */
+        fields: z.ZodArray<z.ZodString, "many">;
+        /** Start collapsed. @default false */
+        collapsed: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        label: string;
+        id: string;
+        fields: string[];
+        collapsed?: boolean | undefined;
+    }, {
+        label: string;
+        id: string;
+        fields: string[];
+        collapsed?: boolean | undefined;
+    }>>, "many">>;
 }, "strip", z.ZodTypeAny, {
     fields: FieldSpec[];
     formName: string;
     title?: string | undefined;
     description?: string | undefined;
+    sections?: {
+        label: string;
+        id: string;
+        fields: string[];
+        collapsed?: boolean | undefined;
+    }[] | undefined;
     submitLabel?: string | undefined;
 }, {
     fields: FieldSpec[];
     formName: string;
     title?: string | undefined;
     description?: string | undefined;
+    sections?: {
+        label: string;
+        id: string;
+        fields: string[];
+        collapsed?: boolean | undefined;
+    }[] | undefined;
     submitLabel?: string | undefined;
 }>;
+/** One collapsible group of top-level fields in a `FormSpec`. */
+declare const formSectionSchema: z.ZodObject<{
+    /** Stable key for the section. */
+    id: z.ZodString;
+    /** Heading on the section's disclosure trigger. */
+    label: z.ZodString;
+    /** Names of the top-level fields the section holds, in display order. */
+    fields: z.ZodArray<z.ZodString, "many">;
+    /** Start collapsed. @default false */
+    collapsed: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    label: string;
+    id: string;
+    fields: string[];
+    collapsed?: boolean | undefined;
+}, {
+    label: string;
+    id: string;
+    fields: string[];
+    collapsed?: boolean | undefined;
+}>;
+type FormSectionSpec = z.infer<typeof formSectionSchema>;
 type FormSpec = Omit<z.infer<typeof formSpecSchema>, "fields"> & {
     fields: FieldSpec[];
 };
@@ -5059,6 +5568,8 @@ interface NormalizedFormSpec {
     description?: string;
     submitLabel?: string;
     fields: FieldSpec[];
+    /** Collapsible field groups; absent when the spec declares none. */
+    sections?: FormSectionSpec[];
 }
 declare function normalizeFormSpec(spec: unknown): {
     ok: true;
@@ -5384,7 +5895,28 @@ interface FromJsonSchemaOptions {
  */
 declare function fromJsonSchema(schema: unknown, options: FromJsonSchemaOptions): FormSpec;
 
-declare const ScrollArea: react.ForwardRefExoticComponent<Omit<ScrollAreaPrimitive.ScrollAreaProps & react.RefAttributes<HTMLDivElement>, "ref"> & react.RefAttributes<HTMLDivElement>>;
+interface ScrollAreaProps extends ComponentPropsWithoutRef<typeof ScrollAreaPrimitive.Root> {
+    /**
+     * Props for the scrolling VIEWPORT — the element that actually overflows, which is
+     * otherwise unreachable from the outside.
+     *
+     * The viewport is deliberately NOT focusable by default: when the content inside it is
+     * focusable (a list of links, rows of buttons) a keyboard user reaches the overflow by
+     * tabbing through it, and a tab stop on the viewport would be noise. When the content is
+     * plain text or non-focusable rows, that same user cannot scroll it at all — axe's
+     * `scrollable-region-focusable` is the gate that catches it. Make it a named tab stop the
+     * way `ChartFrame` does for its scrolling body:
+     *
+     * ```tsx
+     * viewportProps={{ tabIndex: 0, role: "group", "aria-label": "Scrollable list" }}
+     * ```
+     *
+     * `role="group"` rather than `"region"`: ARIA 1.2 forbids `aria-label` on a generic
+     * element, and `group` gives the name a host without adding a landmark.
+     */
+    viewportProps?: ComponentPropsWithoutRef<typeof ScrollAreaPrimitive.Viewport>;
+}
+declare const ScrollArea: react.ForwardRefExoticComponent<ScrollAreaProps & react.RefAttributes<HTMLDivElement>>;
 declare const ScrollBar: react.ForwardRefExoticComponent<Omit<ScrollAreaPrimitive.ScrollAreaScrollbarProps & react.RefAttributes<HTMLDivElement>, "ref"> & react.RefAttributes<HTMLDivElement>>;
 
 interface SectionHeaderProps {
@@ -5541,9 +6073,10 @@ interface SideDockProps extends Omit<ComponentProps<"aside">, "title"> {
      */
     title: ReactNode;
     /**
-     * Optional longer description. Visible under the title in the column
-     * presentation; `sr-only` in the overlay presentation (the compact sheet
-     * header has no room for it, but it still reaches assistive tech).
+     * Optional longer description. Visible at the top of the body in the column
+     * presentation — never inside the header band, which is fixed at the app
+     * shell's header height; `sr-only` in the overlay presentation (the compact
+     * sheet header has no room for it, but it still reaches assistive tech).
      */
     description?: ReactNode;
     /** Optional controls placed in the header row beside the built-in close button. */
@@ -5556,6 +6089,17 @@ interface SideDockProps extends Omit<ComponentProps<"aside">, "title"> {
     onOpenChange?: (open: boolean) => void;
     /** Which edge it docks to. Default `"right"`. */
     side?: "left" | "right";
+    /**
+     * Where the column presentation's fixed/absolute container positions
+     * itself. Default `"viewport"` (pins to the viewport edge — byte-identical
+     * pre-#432 behavior). `"inset"` pins to the dock's OWN position in the
+     * layout instead (`absolute` against a `relative` wrapper this component
+     * provides) — use this when the dock is nested inside another element that
+     * already pins itself to the same viewport edge (e.g. an app `Sidebar`),
+     * so the two never race for the same edge (#432). Has no effect on the
+     * overlay `Sheet` presentation below `overlayBreakpoint`.
+     */
+    containerPosition?: CollapsiblePanelContainerPosition;
     /**
      * `width`, `defaultWidth`, `minWidth`, `maxWidth`, `minContentWidth` and
      * `resizable` (below) govern the COLUMN presentation only — viewport at or
@@ -5841,7 +6385,7 @@ declare function StatePanel({ kind, title, description, icon, illustration, titl
  * copy of these three classes. See `Layout/Resizable`'s `Tiered` story.
  */
 declare const splitPaneVariants: (props?: ({
-    tone?: "muted" | "card" | "plain" | null | undefined;
+    tone?: "card" | "muted" | "plain" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 type SplitPanelTone = NonNullable<VariantProps<typeof splitPaneVariants>["tone"]>;
 interface SplitPanelProps {
@@ -5917,16 +6461,6 @@ declare const TableCell: react.ForwardRefExoticComponent<TdHTMLAttributes<HTMLTa
 declare const TableCaption: react.ForwardRefExoticComponent<HTMLAttributes<HTMLTableCaptionElement> & react.RefAttributes<HTMLTableCaptionElement>>;
 
 declare const Tabs: react.ForwardRefExoticComponent<TabsPrimitive.TabsProps & react.RefAttributes<HTMLDivElement>>;
-/**
- * `overflow-x-auto` + `max-w-full` turn an overflowing tab strip into a
- * scroll container instead of silently clipping it — a bare `inline-flex`
- * has no bound on this element's own width, so without `max-w-full` it would
- * just grow past its parent instead of scrolling. `justify-center-safe`
- * (not `justify-center`) is required too: plain `justify-center` strands the
- * first tab off the left edge once the set overflows; `safe` falls back to
- * start-alignment on overflow while staying visually identical when the
- * strip fits (see #344).
- */
 declare const tabsListVariants: (props?: ({
     variant?: "underline" | "segmented" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
@@ -6046,6 +6580,12 @@ interface ThemeSwitcherProps extends Omit<HTMLAttributes<HTMLButtonElement>, "on
     effect?: ThemeTransitionEffect;
     /** Control size. Default "default". */
     size?: ButtonSize;
+    /**
+     * The trigger button's variant. Default: `"outline"` for the dropdown forms and `"ghost"` for
+     * the two-theme toggle (today's behaviour). Pass `"ghost"` when the switcher sits in a row of
+     * borderless icon buttons — an app top bar — so it reads as one of them.
+     */
+    variant?: ButtonProps["variant"];
     /**
      * Controlled preference (#366). When set, the switcher derives its "current"
      * state — including "system" — from this prop instead of its own internal,
@@ -6084,6 +6624,54 @@ interface ThemeSwitcherProps extends Omit<HTMLAttributes<HTMLButtonElement>, "on
  */
 declare const ThemeSwitcher: react.ForwardRefExoticComponent<ThemeSwitcherProps & react.RefAttributes<HTMLButtonElement>>;
 
+type ThemeFamilySwitchMode = "light" | "dark";
+type ThemeFamilySwitchSize = "sm" | "md" | "lg";
+/** The two colours a family's chip is painted with — any CSS colour, resolved by the host. */
+interface ThemeFamilySwatch {
+    /** The family's ground (`--background` in the active mode). */
+    background: string;
+    /** The family's accent (`--primary` in the active mode). */
+    primary: string;
+}
+interface ThemeFamilySwitchFamily {
+    /** Family id — what `value` holds and `onChange` reports. */
+    id: string;
+    /** Display name: the swatch's accessible name and its tooltip wordmark. */
+    label: string;
+    /** Chip colours. The switch never imports a theme; the host passes these in. */
+    swatch: ThemeFamilySwatch;
+}
+interface ThemeFamilySwitchLabels {
+    /** Accessible name of the swatch row. */
+    families: string;
+    /** Accessible name of the mode toggle. */
+    mode: string;
+    light: string;
+    dark: string;
+}
+declare const DEFAULT_THEME_FAMILY_SWITCH_LABELS: ThemeFamilySwitchLabels;
+interface ThemeFamilySwitchProps extends Omit<HTMLAttributes<HTMLDivElement>, "onChange" | "defaultValue"> {
+    /** Families in display order. */
+    families: readonly ThemeFamilySwitchFamily[];
+    /** Id of the active family. */
+    value: string;
+    /** A family was applied (click, Enter or Space). Arrow keys only move focus. */
+    onChange: (familyId: string) => void;
+    /** Active mode; with `onModeChange`, renders the Light/Dark toggle after the swatches. */
+    mode?: ThemeFamilySwitchMode;
+    onModeChange?: (mode: ThemeFamilySwitchMode) => void;
+    size?: ThemeFamilySwitchSize;
+    /** UI strings, for localisation. */
+    labels?: Partial<ThemeFamilySwitchLabels>;
+}
+/**
+ * One control that re-skins a page across theme families (concept §5a): a row of two-tone
+ * family chips with roving focus — Tab enters the row, arrow keys move, Enter/Space apply —
+ * plus an optional Light/Dark toggle. The selected chip carries a solid ring (a shape cue,
+ * not colour alone) and `aria-checked`; each chip is named by its family.
+ */
+declare const ThemeFamilySwitch: react.ForwardRefExoticComponent<ThemeFamilySwitchProps & react.RefAttributes<HTMLDivElement>>;
+
 /**
  * A single revision entry. The APP assigns `lane` (0-based column index),
  * computes `additions`/`deletions`, and orders revisions newest-first.
@@ -6319,6 +6907,17 @@ declare const ToolbarSlot: react.ForwardRefExoticComponent<ToolbarPrimitive.Tool
 interface TopNavProps extends HTMLAttributes<HTMLElement> {
     /** Left slot (brand on mobile, breadcrumbs, title). */
     start?: ReactNode;
+    /**
+     * Centred slot (e.g. a global search field, or horizontal primary
+     * navigation). Laid out as the middle column of a 3-column grid, so it
+     * stays visually centred in the bar regardless of how wide `start`/`end`
+     * are — plain `flex-1` filler only centres content when both sides are
+     * equal width. Passing `center` switches the bar to this grid layout and
+     * `children` is ignored (pass everything through `start`/`center`/`end`
+     * instead); omit `center` to keep the original `start` / `children` / `end`
+     * flex row unchanged.
+     */
+    center?: ReactNode;
     /** Right slot (search, actions, account menu). */
     end?: ReactNode;
 }
@@ -6396,8 +6995,8 @@ interface TreeProps<T = unknown> extends Omit<HTMLAttributes<HTMLDivElement>, "o
     checkboxes?: boolean;
     /**
      * The surface on which the tree is rendered.
-     * - `"default"` (default) — renders selected rows with `bg-accent` (for use on
-     *   background/card surfaces).
+     * - `"default"` (default) — renders selected rows with `bg-selection` (for use
+     *   on background/card surfaces).
      * - `"sidebar"` — renders selected rows with the sidebar's own active-item
      *   treatment (`bg-sidebar-accent` + `text-sidebar-accent-foreground` +
      *   `font-medium`), so selection reads consistently with `SidebarMenuButton`'s
@@ -6528,10 +7127,12 @@ declare const TEXT_ROLE_REM: {
     readonly meta: 0.75;
     readonly kpi: 2;
     readonly code: 0.8125;
+    readonly "kpi-sm": 1.5;
+    readonly "display-lg": 3;
 };
 type TextRole = keyof typeof TEXT_ROLE_REM;
 declare const textVariants: (props?: ({
-    variant?: "body" | "caption" | "meta" | "kpi" | "code" | "lead" | null | undefined;
+    variant?: "body" | "caption" | "meta" | "eyebrow" | "kpi" | "kpi-sm" | "code" | "lead" | null | undefined;
     tone?: "default" | "muted" | "primary" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 type TextVariant = NonNullable<VariantProps<typeof textVariants>["variant"]>;
@@ -6545,7 +7146,7 @@ interface TextProps extends HTMLAttributes<HTMLParagraphElement>, VariantProps<t
 declare const Text: react.ForwardRefExoticComponent<TextProps & react.RefAttributes<HTMLParagraphElement>>;
 type HeadingLevel = 1 | 2 | 3 | 4 | 5 | 6;
 declare const headingVariants: (props?: ({
-    size?: "display" | "title" | "subtitle" | null | undefined;
+    size?: "display-lg" | "display" | "title" | "subtitle" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 type HeadingSize = NonNullable<VariantProps<typeof headingVariants>["size"]>;
 interface HeadingProps extends HTMLAttributes<HTMLHeadingElement>, VariantProps<typeof headingVariants> {
@@ -6611,7 +7212,7 @@ interface ViewToolbarProps extends HTMLAttributes<HTMLDivElement> {
      * focus but deliberately NOT on tap (and Radix suppresses the focus-open when
      * focus arrived from a pointer), so on a touch device this text is
      * unreachable. Treat `info` as progressive enhancement: never put something a
-     * phone user cannot do without in it. See `Docs/View Toolbar Contract`.
+     * phone user cannot do without in it. See `Layout/ViewToolbar → Contract`.
      */
     info?: ReactNode;
     /** Left cluster — status/context, `ViewToolbarFilters`, `ResultCount`. */
@@ -6903,4 +7504,556 @@ interface WizardNavProps extends HTMLAttributes<HTMLDivElement> {
 /** WizardNav — Back / Next (or Finish on the last step) controls. */
 declare const WizardNav: react.ForwardRefExoticComponent<WizardNavProps & react.RefAttributes<HTMLDivElement>>;
 
-export { APPROVAL_SCOPE_DESCRIPTION_KEYS, ATTRIBUTIONS, Accordion, AccordionContent, AccordionItem, AccordionTrigger, AdvancedGroup, type AdvancedGroupProps, type AgentEventOutcome, type AgentEventPhase, Alert, AlertDescription, type AlertDescriptionProps, AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogPortal, AlertDialogTitle, AlertDialogTrigger, AlertTitle, type AlertTitleProps, AppShell, type AppShellProps, AppSidebar, type AppSidebarProps, type ApprovalOption, type ApprovalScope, AspectRatio, type Attribution, type AttributionCategory, AttributionPanel, type AttributionPanelProps, Avatar, AvatarFallback, AvatarImage, Badge, type BadgeProps, BentoGrid, BentoGridItem, type BentoGridItemProps, type BentoGridItemVariants, type BentoGridProps, type BentoGridSize, type BooleanFieldSpec, BoundedNumber, type BoundedNumberProps, Breadcrumb, BreadcrumbEllipsis, BreadcrumbItem, BreadcrumbLink, BreadcrumbList, BreadcrumbPage, BreadcrumbSeparator, Button, ButtonGroup, ButtonGroupSeparator, ButtonGroupText, type ButtonProps, CATEGORY_LABEL, COLOR_TOKENS, COPY_FEEDBACK_MS, Calendar, type CalendarProps, Card, CardAction, CardContent, CardDescription, type CardDescriptionProps, CardFooter, CardHeader, type CardProps, CardTitle, type CardTitleProps, Carousel, type CarouselApi, CarouselContent, CarouselItem, CarouselNext, CarouselPrevious, type ChangeHunk, type ChangeHunkStatus, type ChangeProvenance, ChangeReview, type ChangeReviewActions, ChangeReviewHeader, type ChangeReviewHeaderProps, ChangeReviewHunk, type ChangeReviewHunkProps, ChangeReviewList, type ChangeReviewListProps, type ChangeReviewProps, ChangeReviewProvenance, type ChangeReviewProvenanceProps, ChangeReviewProvider, type ChangeReviewProviderProps, type ChangeReviewState, type CheckResult, type CheckSummary, Checkbox, Collapsible, CollapsibleContent, type CollapsiblePanelAttrs, type CollapsiblePanelSide, type CollapsiblePanelState, CollapsibleTrigger, ColorPicker, type ColorPickerProps, type ColorToken, Combobox, type ComboboxOption, type ComboboxProps, Command, CommandDialog, type CommandDialogProps, CommandEmpty, CommandGroup, CommandInput, CommandItem, CommandList, type CommandProps, CommandSeparator, CommandShortcut, CommandTrigger, type CommandTriggerProps, ConfirmDialog, type ConfirmDialogProps, ContextMenu, ContextMenuCheckboxItem, ContextMenuContent, ContextMenuGroup, ContextMenuItem, ContextMenuLabel, ContextMenuRadioGroup, ContextMenuRadioItem, ContextMenuSeparator, ContextMenuShortcut, ContextMenuSub, ContextMenuSubContent, ContextMenuSubTrigger, ContextMenuTrigger, ContextRail, type ContextRailProps, type ContextRailSection, type CopyToClipboard, CopyableValue, type CopyableValueProps, type CustomStatus, DEFAULT_MESSAGES, DOCUMENT_ADDRESS_KINDS, DatePicker, type DatePickerProps, DateRangePicker, type DateRangePickerProps, type DateRangePreset, Descriptions, DescriptionsItem, type DescriptionsItemProps, type DescriptionsProps, Dialog, DialogBody, type DialogBodyProps, DialogClose, DialogContent, DialogDescription, type DialogDismissGuard, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogSection, type DialogSectionProps, DialogTitle, DialogTrigger, type DiffLine, type DiffLineType, type DiffRow, type DocumentAddress, type DocumentAddressKind, type DocumentRect, Drawer, DrawerClose, DrawerContent, DrawerDescription, DrawerFooter, DrawerHeader, DrawerPortal, DrawerTitle, DrawerTrigger, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, type EffortLevel, EmptyListIllustration, EmptyState, type EmptyStateProps, type EnumFieldSpec, type EnumOption, ErrorIllustration, ErrorState, type ErrorStateProps, ExpandDialog, ExpandDialogContent, type ExpandDialogContentProps, ExpandDialogHeader, type ExpandDialogHeaderProps, ExpandDialogPanes, type ExpandDialogPanesProps, type ExpandDialogProps, FILE_CATEGORY_ICONS, FieldControl, type FieldControlProps, FieldDescription, FieldError, type FieldKeyValueRow, FieldLabel, FieldRoot, type FieldRootProps, FieldRow, type FieldRowProps, type FieldSpec, type FileCategory, type FileFieldSpec, type FileIssue, type FileKind, type FileSource, FileUpload, FileUploadDropzone, type FileUploadDropzoneProps, FileUploadItem, type FileUploadItemProps, FileUploadList, type FileUploadListProps, type FileUploadProps, type FileUploadStatus, FilterChip, type FilterChipProps, type FindTriggerQueryOptions, FirstRunIllustration, type FormSpec, type FormSubmitState, type FormValue, type FormValues, type FromJsonSchemaOptions, type GroupFieldSpec, type GroupItemSpec, Heading, type HeadingLevel, type HeadingProps, type HeadingSize, HoverCard, HoverCardContent, HoverCardTrigger, ILLUSTRATION_ACCENT_VAR, IconButton, type IconButtonProps, type IconButtonSize, type IllustrationProps, Input, InputGroup, InputGroupAddon, InputGroupButton, InputGroupInput, type InputGroupProps, InputGroupText, InputGroupTextarea, InputOTP, InputOTPGroup, InputOTPSeparator, InputOTPSlot, type InputProps, type InsertMentionResult, type IntegerFieldSpec, Kbd, KeyValueEditor, type KeyValueEditorProps, type KeyValueFieldSpec, type KeyValueRow, KeyboardShortcuts, type KeyboardShortcutsProps, Label, LinkPreview, LinkPreviewCard, type LinkPreviewCardProps, ListEditor, type ListEditorProps, type ListFieldSpec, LoadingState, type LoadingStateProps, type LocaleContextValue, LocaleProvider, type LocaleProviderProps, MatchHighlight, type MatchHighlightProps, type MatchRange, type Mention, MentionInput, MentionInputContent, type MentionInputContentProps, type MentionInputContextValue, MentionInputEmpty, type MentionInputEmptyProps, MentionInputItem, type MentionInputItemProps, MentionInputList, type MentionInputListProps, type MentionInputProps, MentionInputTextarea, type MentionInputTextareaProps, type MentionOption, type MentionValue, Menubar, MenubarCheckboxItem, MenubarContent, MenubarItem, MenubarRadioItem, MenubarSeparator, MenubarShortcut, MenubarSubContent, MenubarSubTrigger, MenubarTrigger, type MessageValue, type Messages, MetricCard, type MetricCardEmphasis, type MetricCardProps, ModelPicker, type ModelPickerBody, type ModelPickerGroup, type ModelPickerItem, type ModelPickerProps, type ModelPickerStatus, type MultiEnumFieldSpec, NavMain, type NavMainProps, type NavMainRoute, type NavMainSubItem, type NavNotification, NavNotifications, type NavNotificationsProps, NavUser, type NavUserProps, type NavUserUser, NavigationMenu, NavigationMenuContent, NavigationMenuItem, NavigationMenuLink, NavigationMenuList, NavigationMenuTrigger, NavigationMenuViewport, NoAccessIllustration, NoResultsIllustration, type NormalizedFormSpec, type NormalizedText, type NumberFieldSpec, NumberInput, type NumberInputProps, OfflineIllustration, type OperatingMode, PROSE_HEADING_REM, PROSE_HEADING_TRACKING, PROSE_HEADING_WEIGHT, PageShell, type PageShellProps, Pagination, PaginationContent, PaginationEllipsis, PaginationItem, PaginationLink, PaginationNext, PaginationPrevious, type PluralCategory, type PluralMessage, Popover, PopoverAnchor, PopoverContent, PopoverTrigger, Progress, type ProgressProps, ProseBlockquote, ProseHeading, type ProseHeadingLevel, type ProseHeadingProps, ProseInlineCode, ProseLink, type ProseLinkProps, ProseList, ProseListItem, type ProseListProps, ProseText, type ProseTextProps, type QuoteAddress, RadioGroup, RadioGroupItem, type RangeAddress, Rating, type RatingProps, type RectAddress, ResizableHandle, ResizablePanel, ResizablePanelGroup, type ResolvedFileSource, ResultCount, type ResultCountProps, Reveal, RevealGroup, type RevealGroupProps, type RevealProps, type Revision, type RevisionBranch, type RevisionEdge, RevisionTimeline, type RevisionTimelineDensity, type RevisionTimelineProps, STATUSES, STATUS_LABELS, STATUS_ROLE, STATUS_TONES, STATUS_TONE_ICONS, STREAMDOWN_TRANSLATION_KEYS, SchemaForm, SchemaFormDescription, type SchemaFormDescriptionProps, SchemaFormError, type SchemaFormErrorProps, SchemaFormFallback, type SchemaFormFallbackProps, SchemaFormField, type SchemaFormFieldProps, SchemaFormFields, type SchemaFormFieldsProps, type SchemaFormProps, SchemaFormProvider, type SchemaFormProviderProps, SchemaFormRoot, type SchemaFormRootProps, SchemaFormSubmit, type SchemaFormSubmitProps, SchemaFormTestAction, type SchemaFormTestActionProps, type SchemaFormTestActionStatus, SchemaFormTitle, type SchemaFormTitleProps, ScrollArea, ScrollBar, SectionHeader, type SectionHeaderProps, SegmentedField, type SegmentedFieldOption, type SegmentedFieldProps, Select, SelectContent, SelectGroup, SelectItem, SelectLabel, SelectSeparator, SelectTrigger, SelectValue, Separator, type SeparatorProps, type SessionCapability, type SessionQuickAction, type SessionWhatsNewItem, Sheet, SheetClose, SheetContent, type SheetContentProps, SheetDescription, SheetFooter, SheetHeader, SheetPortal, SheetTitle, SheetTrigger, type Shortcut, type ShortcutGroup, SideDock, type SideDockProps, Sidebar, SidebarContent, SidebarFooter, SidebarGroup, SidebarGroupAction, SidebarGroupContent, SidebarGroupLabel, SidebarHeader, SidebarInput, SidebarInset, type SidebarInsetGutter, type SidebarInsetProps, SidebarMenu, SidebarMenuAction, SidebarMenuBadge, SidebarMenuButton, SidebarMenuItem, SidebarMenuSkeleton, SidebarMenuSub, SidebarMenuSubButton, SidebarMenuSubItem, SidebarProvider, SidebarRail, SidebarSeparator, SidebarTrigger, Skeleton, type SkeletonProps, SkipLink, type SkipLinkProps, type SlashCommand, Slider, SliderNumber, type SliderNumberProps, type SliderProps, type SliderThumbProps, Spinner, type SpinnerProps, SplitPanel, type SplitPanelProps, type SplitPanelTone, StatePanel, type StatePanelProps, type Status, StatusBadge, type StatusBadgeProps, StatusIcon, type StatusIconProps, type StatusTone, type StreamdownTranslationKey, type StreamdownTranslationMap, type StringFieldSpec, SuccessIllustration, Switch, TEXT_ROLE_REM, Table, TableBody, TableCaption, TableCell, TableFooter, TableHead, TableHeader, TableRow, Tabs, TabsContent, TabsList, type TabsListProps, TabsTrigger, type TabsVariant, TagInput, type TagInputProps, TeamSwitcher, type TeamSwitcherProps, type TeamSwitcherTeam, Text, type TextProps, type TextRole, type TextTone, type TextVariant, Textarea, type TextareaProps, type ThemePreference, ThemeSwitcher, type ThemeSwitcherProps, type ThemeTransitionEffect, Timeline, type TimelineEntry, TimelineItem, type TimelineItemProps, type TimelineProps, TimelineRoot, type TimelineRootProps, type TimelineStatus, Toaster, type ToasterProps, Toggle, ToggleGroup, ToggleGroupItem, Toolbar, ToolbarButton, type ToolbarButtonProps, type ToolbarProps, ToolbarSeparator, type ToolbarSeparatorProps, ToolbarSlot, ToolbarToggleGroup, type ToolbarToggleGroupProps, ToolbarToggleItem, type ToolbarToggleItemProps, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, TopNav, type TopNavProps, Transfer, type TransferItem, type TransferProps, Tree, type TreeNode, type TreeProps, TreeSelect, type TreeSelectProps, type TriggerBoundary, type TriggerQuery, UnsupportedJsonSchemaError, type UploadFile, type UseCollapsiblePanelOptions, type UseCollapsiblePanelReturn, type UseCopyToClipboardOptions, type UseDialogDismissGuardOptions, type UseTreeKeyboardOptions, type UseTreeKeyboardResult, ViewToolbar, ViewToolbarFilters, type ViewToolbarFiltersProps, type ViewToolbarProps, VirtualSelect, type VirtualSelectOption, type VirtualSelectProps, Wizard, WizardNav, type WizardNavProps, type WizardProps, WizardStep, type WizardStepMeta, type WizardStepProps, WizardSteps, type WizardStepsProps, type WizardValidator, type Workspace, WorkspacePicker, type WorkspacePickerProps, agentEventOutcomeStatus, alertVariants, badgeVariants, bentoGridItemVariants, booleanFieldSchema, buttonGroupVariants, buttonVariants, cardVariants, checkFileIssue, cn, collapseDiffRows, collectValidatableFields, countItems, csvQuoteField, csvStringifyValue, defaultMentionFilter, defaultSlashCommandFilter, dialogContentVariants, diffLineAccessibleLabel, diffLineMarker, downloadBlob, downloadUrl, effortRungForIndex, enumFieldSchema, enumOptionSchema, expandDialogPanesVariants, extensionOf, fieldLabel, fieldSpecSchema, fileFieldSchema, fileIconFor, fileMatchesAccept, findFieldByName, findTriggerQuery, formSpecSchema, formatElapsed, formatLastOpened, fromJsonSchema, fromTimelineStatus, groupFieldSchema, groupItemSchema, headingVariants, hunkVariants, illustrationAccent, initialFormValues, inputGroupAddonVariants, inputGroupVariants, insertMention, integerFieldSchema, isCustomStatus, isFieldVisible, isModuleNotFoundMessage, isOptionalPeerMissing, keyValueFieldSchema, keyValueRowSchema, laneColor, listFieldSchema, mediaTypeFromName, mentionAt, mentionEnd, modelPickerBody, multiEnumFieldSchema, navigationMenuTriggerStyle, normalizeFileSource, normalizeFormSpec, normalizeQuoteText, normalizeQuoteTextWithOffsets, normalizeRanges, numberFieldSchema, optionLabel, optionValue, progressIndicatorVariants, queryToRanges, remapMentions, replaceTriggerRun, resolveFileKind, revealVariants, revisionTimelineVariants, serializeMentions, showsInlineError, sidebarMenuButtonVariants, splitPaneVariants, statePanelVariants, statusBadgeVariants, stepIndex, stringFieldSchema, tabsListVariants, tabsTriggerVariants, textVariants, toggleVariants, toolbarVariants, useCollapsiblePanel, useCommandActiveItemId, useCopyToClipboard, useDialogDismissGuard, useDiffRows, useFileUpload, useIsMobile, useLocale, useMentionInput, useSidebar, useStreamdownTranslations, useThemeTransition, useTreeKeyboard, useVirtualListbox, validateField, validateForm };
+/** One install target: the host a visitor runs the command in, and the exact command. */
+interface CommandChipHost {
+    /** Stable id, reported to `onValueChange`. */
+    id: string;
+    /** Host name shown in the menu and on the trigger. */
+    label: string;
+    /** The exact text shown in the chip and written to the clipboard. */
+    command: string;
+}
+/** Every string the chip renders — pass your own to localize it. */
+interface CommandChipLabels {
+    /** Accessible name of the copy button. */
+    copy: string;
+    /** Announced (and shown to sighted users as the check icon) after a successful copy. */
+    copied: string;
+    /** Announced when the clipboard is unavailable and the command is selected instead. */
+    selectFallback: string;
+    /** Accessible name prefix of the host trigger (the current host follows it). */
+    chooseHost: string;
+    /** Heading of the host menu. */
+    menuLabel: string;
+}
+declare const DEFAULT_COMMAND_CHIP_LABELS: CommandChipLabels;
+interface CommandChipProps extends Omit<HTMLAttributes<HTMLDivElement>, "onCopy"> {
+    /** The hosts to choose between; the first is the default selection. */
+    hosts: CommandChipHost[];
+    /** Selected host id (controlled). */
+    value?: string;
+    /** Initially selected host id (uncontrolled). Default: the first host. */
+    defaultValue?: string;
+    /** Fires when the visitor picks another host. */
+    onValueChange?: (id: string) => void;
+    /** Fires after a copy attempt with the command and whether the clipboard accepted it. */
+    onCopyCommand?: (command: string, copied: boolean) => void;
+    /** Override any rendered string. */
+    labels?: Partial<CommandChipLabels>;
+}
+/**
+ * A one-line install command in a monospace chip: pick the host (Claude Code, Cursor, …) from a
+ * menu, copy the exact command. When the page has no clipboard access (insecure origin, denied
+ * permission) the command text is selected instead so the visitor can copy it by hand; either
+ * outcome is announced through an always-mounted live region.
+ */
+declare const CommandChip: react.ForwardRefExoticComponent<CommandChipProps & react.RefAttributes<HTMLDivElement>>;
+
+interface AffordanceHintProps extends HTMLAttributes<HTMLSpanElement> {
+    /** `sessionStorage` key: once the hint has shown (or the visitor interacted), it never returns this session. */
+    storageKey: string;
+    /** ms after mount before the hint appears; skipped entirely when the motion gate is closed. Default 800. */
+    delay?: number;
+}
+/**
+ * A one-time visual nudge ("Drag a tile") pinned in the corner of its positioned parent. It
+ * appears `delay` ms after mounting (at once when motion is reduced), leaves on the first
+ * `pointerdown`/`keydown` inside that parent, and shows once per `storageKey` per session. It is
+ * `aria-hidden` — the surface it points at is accessible on its own; this is a visual cue only.
+ */
+declare const AffordanceHint: react.ForwardRefExoticComponent<AffordanceHintProps & react.RefAttributes<HTMLSpanElement>>;
+/** Every string the actions row renders — pass your own to localize it. */
+interface SurfaceTourActionsLabels {
+    openInStorybook: string;
+    copyPrompt: string;
+    promptCopied: string;
+    promptCopyFailed: string;
+    scaffold: string;
+    copyCommand: string;
+}
+declare const DEFAULT_SURFACE_TOUR_ACTIONS_LABELS: SurfaceTourActionsLabels;
+interface SurfaceTourActionsProps extends HTMLAttributes<HTMLDivElement> {
+    /** Where "Open in Storybook" goes. Omit to hide the link. */
+    storybookHref?: string;
+    /** The (multi-line) prompt "Copy prompt" writes to the clipboard. Omit to hide the button. */
+    prompt?: string;
+    /** The scaffold command shown in a copyable chip. Omit to hide the chip. */
+    command?: string;
+    /** Override any rendered string. */
+    labels?: Partial<SurfaceTourActionsLabels>;
+}
+/** The per-surface actions row: open the story, copy an agent prompt, copy the scaffold command. */
+declare const SurfaceTourActions: react.ForwardRefExoticComponent<SurfaceTourActionsProps & react.RefAttributes<HTMLDivElement>>;
+/** One surface in the tour. */
+interface SurfaceTourTab {
+    /** Stable id — the tab value, the `#<hashKey>=<id>` deep link and the hint's session key. */
+    id: string;
+    /** Tab label. */
+    label: ReactNode;
+    /** One sentence under the frame saying what this surface is for. */
+    useCase?: ReactNode;
+    /** The actions row under the frame (typically a `SurfaceTourActions`). */
+    actions?: ReactNode;
+    /** Corner hint shown once per session when the surface first mounts. */
+    hint?: ReactNode;
+    /** Renders the surface. May suspend (a `React.lazy` or `next/dynamic` component). */
+    render: () => ReactNode;
+    /** Starts loading the surface's code; called on tab hover/focus, never on scroll. */
+    prefetch?: () => void;
+    /** Shown while the surface suspends. Default: a frame-filling `Skeleton`. */
+    fallback?: ReactNode;
+}
+interface SurfaceTourProps extends Omit<HTMLAttributes<HTMLElement>, "title"> {
+    tabs: SurfaceTourTab[];
+    /** The tab shown first. Default: the first tab. */
+    defaultTab?: string;
+    /** Fires when the visitor picks another tab. */
+    onTabChange?: (id: string) => void;
+    /** Section heading. */
+    title?: ReactNode;
+    /** One sentence under the heading. */
+    description?: ReactNode;
+    /** When set, the active tab is read from and written to `#<hashKey>=<id>` (no history entries). */
+    hashKey?: string;
+    /** Classes for the frame — give it a height so every surface fills the same box. */
+    frameClassName?: string;
+}
+/**
+ * A tour of full-size surfaces behind a sticky tab strip. The frame stays put while the
+ * surfaces crossfade (`--t-base`, instant under reduced motion); the frame's min-height only
+ * ever grows, so switching never jumps the page. Surfaces mount on first selection and may
+ * suspend (lazy code) behind a `Skeleton`; `prefetch` runs on hover/focus of a tab. The sticky
+ * offset is the `--surface-tour-sticky-top` custom property (set it to your nav height).
+ */
+declare const SurfaceTour: react.ForwardRefExoticComponent<SurfaceTourProps & react.RefAttributes<HTMLElement>>;
+
+/** One problem a validator reports — the shape both the A2UI and DashboardSpec validators use. */
+interface SpecPlaygroundError {
+    /** JSON-path-like address of the problem (`root.children[2].props.label`, `$.tiles[0]`). */
+    path: string;
+    /** The validator's machine-readable code (`missing-prop`, `overlap`, …). */
+    code: string;
+    message: string;
+}
+/** What `validate` returns: the typed spec, or the validator's own errors. */
+type SpecPlaygroundValidation<TSpec> = {
+    ok: true;
+    spec: TSpec;
+} | {
+    ok: false;
+    errors: readonly SpecPlaygroundError[];
+};
+/** An entry in the `Load example` menu. */
+interface SpecPlaygroundExample {
+    id: string;
+    label: string;
+    /** The JSON text loaded into the editor. */
+    value: string;
+}
+/** The playground's status: what the last validated text turned out to be. */
+type SpecPlaygroundStatus = "valid" | "invalid" | "parse-error";
+/** Every string the playground renders — pass your own to localize it. */
+interface SpecPlaygroundLabels {
+    /** Accessible name of the default textarea editor. */
+    editor: string;
+    /** Accessible name of the rendered-result region. */
+    preview: string;
+    /** Accessible name of the error list. */
+    errors: string;
+    /** Trigger of the examples menu. */
+    loadExample: string;
+    /** Resets the editor to its initial text. */
+    reset: string;
+    /** Status chip: the text validates. */
+    valid: string;
+    /** Status chip: the validator reported `count` errors. */
+    errorCount: (count: number) => string;
+    /** Status chip: the text is not JSON. */
+    parseError: string;
+    /** Shown over the render when it is the last valid spec, not the current text. */
+    showingLastValid: string;
+    /** Shown in the render pane before any text has validated. */
+    nothingValid: string;
+    /** Suffix naming the editor line an error points at. */
+    line: (line: number) => string;
+}
+declare const DEFAULT_SPEC_PLAYGROUND_LABELS: SpecPlaygroundLabels;
+interface SpecPlaygroundProps<TSpec> extends Omit<HTMLAttributes<HTMLDivElement>, "onChange" | "defaultValue"> {
+    /** The JSON text (controlled). */
+    value?: string;
+    /** Initial JSON text (uncontrolled); also what `Reset` restores. Default: the first example. */
+    defaultValue?: string;
+    /** Called with the new text on every edit, example load and reset. */
+    onChange?: (value: string) => void;
+    /** Checks the parsed JSON; the errors shown are exactly the ones it returns. */
+    validate: (json: unknown) => SpecPlaygroundValidation<TSpec>;
+    /** Renders a validated spec. */
+    render: (spec: TSpec) => ReactNode;
+    /** Entries of the `Load example` menu (the menu is hidden without any). */
+    examples?: readonly SpecPlaygroundExample[];
+    /**
+     * The editor. Bind it to `value`/`onChange` yourself. Default: a `Textarea`, so the
+     * playground works without a code editor.
+     */
+    editor?: ReactNode;
+    /**
+     * Called when an error is chosen, with the editor line its path resolves to — move a custom
+     * editor's caret there. The default textarea handles this itself.
+     */
+    onErrorSelect?: (error: SpecPlaygroundError, line: number | undefined) => void;
+    /** Milliseconds between the last edit and validation. Default 250. */
+    debounceMs?: number;
+    labels?: Partial<SpecPlaygroundLabels>;
+}
+/**
+ * A live spec editor: JSON on the left, what it renders on the right (stacked below 1024 px).
+ * Edits are validated after a short pause by the host's own `validate`; its errors are listed
+ * under the editor (`path · code · message`, click to jump to the line) and the render keeps
+ * the last valid spec, marked as such, until the text validates again. The editor, validator
+ * and renderer all come from the host — this component owns only the loop between them.
+ */
+declare const SpecPlayground: <TSpec>(props: SpecPlaygroundProps<TSpec> & {
+    ref?: Ref<HTMLDivElement>;
+}) => ReactElement;
+
+/** One host the visitor can pick — the selection swaps every row's copy action. */
+interface IntegrationMatrixHost {
+    /** Stable id, matched against each action's `value` map. */
+    id: string;
+    /** Shown in the selector. */
+    label: string;
+}
+/** One action a row offers: copy a command, or follow a link. */
+interface IntegrationMatrixAction {
+    /** Shown on the link button, or as the copy button's accessible name suffix. */
+    label: string;
+    kind: "copy" | "link";
+    /**
+     * `kind: "copy"` — the exact text per host id (a row that never changes by host
+     * repeats the same string under every id). `kind: "link"` — a single href string.
+     */
+    value: string | Record<string, string>;
+}
+/** One installable unit — hosted MCP, local MCP + CLI, the plugin, `llms.txt`, … */
+interface IntegrationMatrixRow {
+    id: string;
+    unit: string;
+    gives: string;
+    actions: IntegrationMatrixAction[];
+}
+/** One step of the routine line below the matrix (`info → search → docs → …`). */
+interface IntegrationMatrixRoutineStep {
+    verb: string;
+    /** Tooltip body — what the verb does. */
+    does: string;
+}
+interface IntegrationMatrixLabels {
+    /** Visible label beside the host selector. */
+    hostSelectLabel: string;
+    /** `aria-label` of the host `Select` trigger. */
+    hostSelectAriaLabel: string;
+    unitHeading: string;
+    givesHeading: string;
+    actionsHeading: string;
+    /** Heading above the routine chips. */
+    routineHeading: string;
+}
+declare const DEFAULT_INTEGRATION_MATRIX_LABELS: IntegrationMatrixLabels;
+interface IntegrationMatrixProps extends HTMLAttributes<HTMLDivElement> {
+    hosts: IntegrationMatrixHost[];
+    rows: IntegrationMatrixRow[];
+    /** The routine strip below the matrix; omitted entirely when empty. */
+    routine?: IntegrationMatrixRoutineStep[];
+    /** Selected host id (controlled). */
+    value?: string;
+    /** Initially selected host id (uncontrolled). Default: the first host. */
+    defaultValue?: string;
+    /** Fires when the visitor picks another host. */
+    onValueChange?: (id: string) => void;
+    /** Fires after a copy attempt with the row id, the action label and the text. */
+    onCopyAction?: (rowId: string, actionLabel: string, text: string, copied: boolean) => void;
+    labels?: Partial<IntegrationMatrixLabels>;
+}
+declare const IntegrationMatrix: react.ForwardRefExoticComponent<IntegrationMatrixProps & react.RefAttributes<HTMLDivElement>>;
+
+/** One option in the `pnpm add` or `Copy-own` select — the exact command it resolves to. */
+interface InstallTabsSelectOption {
+    id: string;
+    label: string;
+    command: string;
+}
+/** One host-specific tab (Claude Code, Cursor, …), one or more commands top to bottom. */
+interface InstallTabsHostTab {
+    id: string;
+    label: string;
+    commands: {
+        label: string;
+        command: string;
+    }[];
+}
+interface InstallTabsLabels {
+    packagesTab: string;
+    copyOwnTab: string;
+    promptTab: string;
+    packageSelectAriaLabel: string;
+    blockSelectAriaLabel: string;
+    packageCommandLabel: string;
+    blockCommandLabel: string;
+    /** `aria-label` of the read-only prompt textarea. */
+    promptAriaLabel: string;
+    promptCopyLabel: string;
+    promptCopiedLabel: string;
+}
+declare const DEFAULT_INSTALL_TABS_LABELS: InstallTabsLabels;
+interface InstallTabsProps extends HTMLAttributes<HTMLDivElement> {
+    /** The `pnpm add` tab's per-archetype options; the first is the default selection. */
+    packageOptions: InstallTabsSelectOption[];
+    /** The `Copy-own` tab's per-block options; the first is the default selection. */
+    blockOptions: InstallTabsSelectOption[];
+    /** One tab per host, in order, between `Copy-own` and `Prompt`. */
+    hostTabs: InstallTabsHostTab[];
+    /** The multi-line agent prompt shown (read-only) on the `Prompt` tab. */
+    prompt: string;
+    /** Selected tab id (controlled): `"packages"`, `"copy-own"`, a host id, or `"prompt"`. */
+    value?: string;
+    /** Initially selected tab id (uncontrolled). Default: `"packages"`. */
+    defaultValue?: string;
+    onValueChange?: (id: string) => void;
+    /** Selected `pnpm add` archetype id (controlled). */
+    packageValue?: string;
+    onPackageValueChange?: (id: string) => void;
+    /** Selected `Copy-own` block id (controlled). */
+    blockValue?: string;
+    onBlockValueChange?: (id: string) => void;
+    onCommandCopy?: (command: string, copied: boolean) => void;
+    onPromptCopy?: (copied: boolean) => void;
+    labels?: Partial<InstallTabsLabels>;
+}
+declare const InstallTabs: react.ForwardRefExoticComponent<InstallTabsProps & react.RefAttributes<HTMLDivElement>>;
+
+/** One chip: a semantic token plus its display label. */
+interface TokenSpotlightToken {
+    /** The CSS custom property name, including its leading `--` (e.g. `--primary`). */
+    token: string;
+    /** Display label for the chip — supply your own to localize. */
+    label: string;
+}
+interface TokenSpotlightLabels {
+    /** Accessible name of the chip row (`role="group"`). */
+    row: string;
+    /** sr-only text appended to each chip's accessible name, describing what hovering does. */
+    hint: string;
+}
+declare const DEFAULT_TOKEN_SPOTLIGHT_LABELS: TokenSpotlightLabels;
+/** Hard cap on elements a single scan pass examines (wave-4 ruling 26). */
+declare const TOKEN_SPOTLIGHT_SCAN_LIMIT = 2000;
+/**
+ * Resolves `token`'s CURRENT value the same way the browser will compare it: an off-screen probe
+ * element takes `background-color: var(token)`, so whatever colour-space normalisation the
+ * browser applies happens identically for the probe and for every candidate element below —
+ * string equality holds regardless of how a theme authored the value (oklch, rgb, …).
+ */
+declare function resolveTokenMatchValue(token: string, doc?: Document): string;
+/**
+ * What a chip shows a person for `token` on `root` (#585): a colour as a rounded `oklch(L C H)`
+ * — never the `lab()` a CSS build may have transpiled it to — and a length as resolved px, never
+ * a raw `calc()`. Anything else (a font stack, a shadow) is shown as authored. `""` when there is
+ * no `document` yet (SSR — the component fills it in after mount).
+ */
+declare function resolveTokenDisplayValue(token: string, root?: HTMLElement): string;
+/**
+ * Scans `root` in idle-time chunks for elements that visibly paint `matchValue` (from
+ * {@link resolveTokenMatchValue}) — a background, a border side with width, their own text, or an
+ * SVG shape's fill/stroke (reported as its `<svg>`) — capped at `limit` elements EXAMINED. Never a
+ * long task, never inline styles (callers add/remove a `data-token-consumer` attribute instead).
+ * Returns a canceller for effect cleanup.
+ */
+declare function scanForConsumers(root: ParentNode, matchValue: string, limit: number, onDone: (elements: HTMLElement[]) => void): () => void;
+interface TokenSpotlightProps extends Omit<react.HTMLAttributes<HTMLDivElement>, "onSelect"> {
+    /** Chips to render, in order. */
+    tokens: readonly TokenSpotlightToken[];
+    /** Fires with the token on hover/focus, and `null` when the spotlight clears. */
+    onSpotlight?: (token: string | null) => void;
+    /** Upper bound on elements a scan pass examines. Default {@link TOKEN_SPOTLIGHT_SCAN_LIMIT}. */
+    scanLimit?: number;
+    labels?: Partial<TokenSpotlightLabels>;
+}
+/**
+ * A row of token chips (concept §4.5, §5a "Scroll choreography 5"): hovering or focusing one sets
+ * `data-token-spotlight` on `<html>` and marks every element on the page that resolves to the
+ * same colour with `data-token-consumer` (never an inline style), so a stylesheet can draw the
+ * highlight. `onSpotlight` lets the host tint an `AmbientField` to match. Each chip shows the
+ * token's own resolved value, re-read on every theme change.
+ */
+declare const TokenSpotlight: react.ForwardRefExoticComponent<TokenSpotlightProps & react.RefAttributes<HTMLDivElement>>;
+
+/**
+ * color-scale.ts — `colorScaleFor(values, spec)`: the one value → colour
+ * decision behind every thematic encoding (RM-124). A choropleth fill
+ * (`charts`), a DataTable heatmap cell (`data`) and a map symbol or legend ramp
+ * (`maps`) all ask the same question, and those three packages depend on `ui`
+ * but never on each other — so the answer lives here, once.
+ *
+ * Pure: no React, no DOM. It returns data a renderer paints.
+ *
+ * ## Colours are token REFERENCES
+ *
+ * Every colour this module hands back is a `var(--chart-…)` reference — the
+ * `--chart-seq-*` ramp, the `--chart-div-*` ramp or the `--chart-1…12`
+ * categorical set — never a literal. The result re-colours on a theme flip with
+ * no re-render, and the on-mark ink seam (`charts`' `on-mark-ink.ts`) can
+ * resolve every step it paints.
+ *
+ * The price: nothing here can MIX two steps, because their values are unknown
+ * until the browser resolves the active theme. So:
+ *
+ * - a **continuous** scale snaps each value to the nearest ramp step (7
+ *   sequential, 5 diverging). {@link ColorScale.positionOf} gives the exact,
+ *   unsnapped ramp position (a legend marker) and {@link ColorScale.stops} the
+ *   value at which each step is exact (a gradient's colour stops);
+ * - a **stepped** scale is CLAMPED to its ramp: ask for more classes than the
+ *   ramp has tokens (7 sequential, 5 diverging) and you get the ramp's length,
+ *   because two classes painted the same colour are one class. `steps` is a
+ *   ceiling, never a promise; read `scale.steps.length` for what was painted.
+ *   (`method: "custom"` keeps every break the host named.)
+ *
+ * ## Step membership
+ *
+ * A step is `(from, to]`: the upper bound is inclusive and the first step also
+ * includes its `from`. Jenks breaks are class UPPER bounds, so a published
+ * break list reads straight across. Values outside the domain clamp into the
+ * end steps, the way a map never shows a hole for an outlier.
+ */
+/** A smooth ramp, or countable classes. */
+type ColorScaleType = "continuous" | "stepped";
+/**
+ * Where a continuous ramp's stops sit. `linear` spreads them evenly from min
+ * to max; `median`, `quartiles`, `quintiles` and `deciles` pin them to those
+ * quantiles of the data; `natural` pins them to the Jenks breaks.
+ */
+type ContinuousColorScaleMethod = "linear" | "median" | "quartiles" | "quintiles" | "deciles" | "natural";
+/**
+ * How a stepped scale cuts its classes. `equidistant` makes equal widths;
+ * `rounded` makes equal widths whose inner breaks round to the step's leading
+ * power of ten; `quantile` makes equal counts; `jenks` minimises the variance
+ * inside each class; `custom` uses {@link SteppedColorScaleSpec.breaks}.
+ */
+type SteppedColorScaleMethod = "equidistant" | "rounded" | "quantile" | "jenks" | "custom";
+type ColorScaleMethod = ContinuousColorScaleMethod | SteppedColorScaleMethod;
+/**
+ * Which token set paints the scale. `sequential` answers "how much",
+ * `diverging` answers "how far from the centre, and on which side", and
+ * `categorical` gives each distinct value its own colour.
+ */
+type ColorScalePalette = "sequential" | "diverging" | "categorical";
+/** `[min, max]`, or `[min, center, max]` to pin the ramp's middle colour. */
+type ColorScaleDomain = readonly [min: number, max: number] | readonly [min: number, center: number, max: number];
+interface ColorScaleSpecBase {
+    /**
+     * Fixed ends instead of the data's own min / max, so two maps share one
+     * scale. A middle entry is the CENTRE: the value that paints the ramp's
+     * middle colour.
+     */
+    domain?: ColorScaleDomain;
+    /**
+     * Default: `"diverging"` when `domain` has a centre, else `"sequential"`. A
+     * diverging scale without a centre centres on 0 when the domain spans 0, and
+     * on the domain's midpoint otherwise.
+     */
+    palette?: ColorScalePalette;
+}
+interface ContinuousColorScaleSpec extends ColorScaleSpecBase {
+    type: "continuous";
+    /** Default `"linear"`. */
+    method?: ContinuousColorScaleMethod;
+    /** `method: "natural"` only: how many Jenks classes place the stops. Default 5. */
+    steps?: number;
+}
+interface SteppedColorScaleSpec extends ColorScaleSpecBase {
+    type: "stepped";
+    /** Default `"equidistant"`. */
+    method?: SteppedColorScaleMethod;
+    /**
+     * How many classes. Default 5. Ignored by `custom`. `quantile` and `jenks`
+     * can return fewer when the data has fewer distinct values.
+     */
+    steps?: number;
+    /**
+     * `method: "custom"` only: the inner thresholds, ascending. The scale's ends
+     * widen to include them, so the same breaks give the same colours on every
+     * dataset.
+     */
+    breaks?: readonly number[];
+}
+/** What to build. The feature / column the values come from is the caller's business. */
+type ColorScaleSpec = ContinuousColorScaleSpec | SteppedColorScaleSpec;
+/**
+ * One input value. Numeric scales read finite numbers only; categorical scales
+ * read non-empty strings and finite numbers. Everything else is "no data".
+ */
+type ColorScaleValue = number | string | null | undefined;
+/** One class of the scale, low → high. See the module docblock for membership. */
+interface ColorScaleStep {
+    from: number;
+    to: number;
+    /** A `var(--chart-…)` reference. */
+    color: string;
+}
+/** The value at which one ramp token is exact: a gradient's colour stop. */
+interface ColorScaleStop {
+    value: number;
+    /** A `var(--chart-…)` reference. */
+    color: string;
+}
+/** One category of a categorical scale, in first-seen order. */
+interface ColorScaleCategory {
+    value: string | number;
+    /** A `var(--chart-…)` reference. */
+    color: string;
+}
+/** The resolved scale. Every colour in it is a `var(--chart-…)` reference. */
+interface ColorScale {
+    type: ColorScaleType;
+    /** The method actually used (a data-driven method with no data falls back to linear / equidistant). */
+    method: ColorScaleMethod;
+    palette: ColorScalePalette;
+    /** The resolved `[lo, hi]`; `null` for a categorical scale or when there is nothing to scale. */
+    domain: readonly [number, number] | null;
+    /** The value that paints the ramp's middle colour, or `null` when none applies. */
+    center: number | null;
+    /**
+     * The classes a value can land in, low → high. Continuous: one per ramp
+     * token (the value band that snaps to it). Categorical: empty.
+     */
+    steps: readonly ColorScaleStep[];
+    /** Continuous only: one per ramp token. Stepped and categorical: empty. */
+    stops: readonly ColorScaleStop[];
+    /** Categorical only: one per distinct value. Otherwise empty. */
+    categories: readonly ColorScaleCategory[];
+    /** The colour for a value, or `null` for no data (and for an unseen category). */
+    colorOf(value: ColorScaleValue): string | null;
+    /** The index into `steps` (or `categories`) a value lands in; `-1` for no data. */
+    indexOf(value: ColorScaleValue): number;
+    /**
+     * Where a value sits on a key whose tokens (continuous) or swatches (stepped)
+     * are drawn evenly: `0` = the start of the strip, `1` = the end. `null` for
+     * no data and for categorical scales.
+     */
+    positionOf(value: ColorScaleValue): number | null;
+}
+/**
+ * Build a colour scale over `values`.
+ *
+ * ```ts
+ * const scale = colorScaleFor(rows.map((r) => r.share), {
+ *   type: "stepped",
+ *   method: "quantile",
+ *   steps: 5,
+ * });
+ * scale.colorOf(0.42); // "var(--chart-seq-4)"
+ * scale.steps;         // five { from, to, color } classes for the legend
+ * ```
+ */
+declare function colorScaleFor(values: readonly ColorScaleValue[], spec: ColorScaleSpec): ColorScale;
+
+export { AMBIENT_DEFAULT_STOPS, AMBIENT_MAX_ALPHA, APPROVAL_SCOPE_DESCRIPTION_KEYS, ATTRIBUTIONS, Accordion, AccordionContent, AccordionItem, AccordionTrigger, AdvancedGroup, type AdvancedGroupProps, AffordanceHint, type AffordanceHintProps, type AgentEventOutcome, type AgentEventPhase, Alert, AlertDescription, type AlertDescriptionProps, AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogPortal, AlertDialogTitle, AlertDialogTrigger, AlertTitle, type AlertTitleProps, AmbientField, type AmbientFieldProps, type AmbientToken, AppShell, type AppShellProps, type AppShellTopBarSlots, AppSidebar, type AppSidebarProps, type ApprovalOption, type ApprovalScope, AspectRatio, type Attribution, type AttributionCategory, AttributionPanel, type AttributionPanelProps, Avatar, AvatarFallback, AvatarImage, Badge, type BadgeProps, BentoGrid, BentoGridItem, type BentoGridItemProps, type BentoGridItemVariants, type BentoGridProps, type BentoGridSize, type BooleanFieldSpec, BoundedNumber, type BoundedNumberProps, Breadcrumb, BreadcrumbEllipsis, BreadcrumbItem, BreadcrumbLink, BreadcrumbList, BreadcrumbPage, BreadcrumbSeparator, Button, ButtonGroup, ButtonGroupSeparator, ButtonGroupText, type ButtonProps, CATEGORY_LABEL, COLOR_TOKENS, COPY_FEEDBACK_MS, Calendar, type CalendarProps, Card, CardAction, CardContent, CardDescription, type CardDescriptionProps, CardFooter, CardHeader, CardMedia, type CardMediaProps, type CardProps, CardTitle, type CardTitleProps, Carousel, type CarouselApi, CarouselContent, CarouselItem, CarouselNext, CarouselPrevious, type ChangeHunk, type ChangeHunkStatus, type ChangeProvenance, ChangeReview, type ChangeReviewActions, ChangeReviewHeader, type ChangeReviewHeaderProps, ChangeReviewHunk, type ChangeReviewHunkProps, ChangeReviewList, type ChangeReviewListProps, type ChangeReviewProps, ChangeReviewProvenance, type ChangeReviewProvenanceProps, ChangeReviewProvider, type ChangeReviewProviderProps, type ChangeReviewState, type CheckResult, type CheckSummary, Checkbox, Collapsible, CollapsibleContent, type CollapsiblePanelAttrs, type CollapsiblePanelContainerPosition, type CollapsiblePanelSide, type CollapsiblePanelState, CollapsibleTrigger, ColorPicker, type ColorPickerProps, type ColorScale, type ColorScaleCategory, type ColorScaleDomain, type ColorScaleMethod, type ColorScalePalette, type ColorScaleSpec, type ColorScaleStep, type ColorScaleStop, type ColorScaleType, type ColorScaleValue, type ColorToken, Combobox, type ComboboxOption, type ComboboxProps, Command, CommandChip, type CommandChipHost, type CommandChipLabels, type CommandChipProps, CommandDialog, type CommandDialogProps, CommandEmpty, CommandGroup, CommandInput, CommandItem, CommandList, type CommandProps, CommandSeparator, CommandShortcut, CommandTrigger, type CommandTriggerProps, ConfirmDialog, type ConfirmDialogProps, ContextMenu, ContextMenuCheckboxItem, ContextMenuContent, ContextMenuGroup, ContextMenuItem, ContextMenuLabel, ContextMenuRadioGroup, ContextMenuRadioItem, ContextMenuSeparator, ContextMenuShortcut, ContextMenuSub, ContextMenuSubContent, ContextMenuSubTrigger, ContextMenuTrigger, ContextRail, type ContextRailProps, type ContextRailSection, type ContinuousColorScaleMethod, type ContinuousColorScaleSpec, type CopyToClipboard, CopyableValue, type CopyableValueProps, type CustomStatus, DEFAULT_COMMAND_CHIP_LABELS, DEFAULT_INSTALL_TABS_LABELS, DEFAULT_INTEGRATION_MATRIX_LABELS, DEFAULT_MESSAGES, DEFAULT_SPEC_PLAYGROUND_LABELS, DEFAULT_SURFACE_TOUR_ACTIONS_LABELS, DEFAULT_THEME_FAMILY_SWITCH_LABELS, DEFAULT_TOKEN_SPOTLIGHT_LABELS, DOCUMENT_ADDRESS_KINDS, DatePicker, type DatePickerProps, DateRangePicker, type DateRangePickerProps, type DateRangePreset, Descriptions, DescriptionsItem, type DescriptionsItemProps, type DescriptionsLabelWidth, type DescriptionsProps, Dialog, DialogBody, type DialogBodyProps, DialogClose, DialogContent, DialogDescription, type DialogDismissGuard, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogSection, type DialogSectionProps, DialogTitle, DialogTrigger, type DiffLine, type DiffLineType, type DiffRow, type DocumentAddress, type DocumentAddressKind, type DocumentRect, Drawer, DrawerClose, DrawerContent, DrawerDescription, DrawerFooter, DrawerHeader, DrawerPortal, DrawerTitle, DrawerTrigger, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, type EffortLevel, EmptyListIllustration, EmptyState, type EmptyStateProps, type EnumFieldSpec, type EnumOption, ErrorIllustration, ErrorState, type ErrorStateProps, ExpandDialog, ExpandDialogContent, type ExpandDialogContentProps, ExpandDialogHeader, type ExpandDialogHeaderProps, ExpandDialogPanes, type ExpandDialogPanesProps, type ExpandDialogProps, FILE_CATEGORY_ICONS, FieldControl, type FieldControlProps, FieldDescription, FieldError, type FieldKeyValueRow, FieldLabel, FieldRoot, type FieldRootProps, FieldRow, type FieldRowProps, type FieldSpec, type FileCategory, type FileFieldSpec, type FileIssue, type FileKind, type FileSource, FileUpload, FileUploadDropzone, type FileUploadDropzoneProps, FileUploadItem, type FileUploadItemProps, FileUploadList, type FileUploadListProps, type FileUploadProps, type FileUploadStatus, FilterChip, type FilterChipProps, type FindTriggerQueryOptions, FirstRunIllustration, type FormSectionSpec, type FormSpec, type FormSubmitState, type FormValue, type FormValues, type FromJsonSchemaOptions, type GroupFieldSpec, type GroupItemSpec, Heading, type HeadingLevel, type HeadingProps, type HeadingSize, HoverCard, HoverCardContent, HoverCardTrigger, ILLUSTRATION_ACCENT_VAR, IconButton, type IconButtonProps, type IconButtonSize, type IllustrationProps, Input, InputGroup, InputGroupAddon, InputGroupButton, InputGroupInput, type InputGroupProps, InputGroupText, InputGroupTextarea, InputOTP, InputOTPGroup, InputOTPSeparator, InputOTPSlot, type InputProps, type InsertMentionResult, InstallTabs, type InstallTabsHostTab, type InstallTabsLabels, type InstallTabsProps, type InstallTabsSelectOption, type IntegerFieldSpec, IntegrationMatrix, type IntegrationMatrixAction, type IntegrationMatrixHost, type IntegrationMatrixLabels, type IntegrationMatrixProps, type IntegrationMatrixRoutineStep, type IntegrationMatrixRow, Kbd, KeyValueEditor, type KeyValueEditorProps, type KeyValueFieldSpec, type KeyValueRow, KeyboardShortcuts, type KeyboardShortcutsProps, Label, LinkPreview, LinkPreviewCard, type LinkPreviewCardProps, ListEditor, type ListEditorProps, type ListFieldSpec, LoadingState, type LoadingStateProps, type LocaleContextValue, LocaleProvider, type LocaleProviderProps, MOTION_FACTOR_FLOOR, MatchHighlight, type MatchHighlightProps, type MatchRange, type Mention, MentionInput, MentionInputContent, type MentionInputContentProps, type MentionInputContextValue, MentionInputEmpty, type MentionInputEmptyProps, MentionInputItem, type MentionInputItemProps, MentionInputList, type MentionInputListProps, type MentionInputProps, MentionInputTextarea, type MentionInputTextareaProps, type MentionOption, type MentionValue, Menubar, MenubarCheckboxItem, MenubarContent, MenubarItem, MenubarRadioItem, MenubarSeparator, MenubarShortcut, MenubarSubContent, MenubarSubTrigger, MenubarTrigger, type MessageValue, type Messages, Meter, type MeterProps, MetricCard, type MetricCardEmphasis, type MetricCardProps, type MetricCardSize, ModelPicker, type ModelPickerBody, type ModelPickerGroup, type ModelPickerItem, type ModelPickerProps, type ModelPickerStatus, type MultiEnumFieldSpec, NavMain, type NavMainProps, type NavMainRoute, type NavMainSubItem, type NavNotification, NavNotifications, type NavNotificationsProps, NavUser, type NavUserProps, type NavUserUser, NavigationMenu, NavigationMenuContent, NavigationMenuItem, NavigationMenuLink, NavigationMenuList, NavigationMenuTrigger, NavigationMenuViewport, NoAccessIllustration, NoResultsIllustration, type NormalizedFormSpec, type NormalizedText, type NumberFieldSpec, NumberInput, type NumberInputProps, OfflineIllustration, type OperatingMode, PARALLAX_MAX_TRAVEL, PARALLAX_PLANE_RATES, PROSE_HEADING_REM, PROSE_HEADING_TRACKING, PROSE_HEADING_WEIGHT, PageShell, type PageShellProps, Pagination, PaginationContent, PaginationEllipsis, PaginationItem, PaginationLink, PaginationNext, PaginationPrevious, ParallaxPlane, type ParallaxPlaneKind, type ParallaxPlaneProps, type PluralCategory, type PluralMessage, Popover, PopoverAnchor, PopoverContent, PopoverTrigger, Progress, type ProgressProps, ProseBlockquote, ProseHeading, type ProseHeadingLevel, type ProseHeadingProps, ProseInlineCode, ProseLink, type ProseLinkProps, ProseList, ProseListItem, type ProseListProps, ProseText, type ProseTextProps, type QuoteAddress, RadioGroup, RadioGroupItem, type RangeAddress, Rating, type RatingProps, type RectAddress, ResizableHandle, ResizablePanel, ResizablePanelGroup, type ResolvedFileSource, ResultCount, type ResultCountProps, Reveal, RevealGroup, type RevealGroupProps, RevealOnEnter, type RevealOnEnterElement, type RevealOnEnterProps, type RevealProps, type Revision, type RevisionBranch, type RevisionEdge, RevisionTimeline, type RevisionTimelineDensity, type RevisionTimelineProps, STATUSES, STATUS_LABELS, STATUS_ROLE, STATUS_TONES, STATUS_TONE_ICONS, STREAMDOWN_TRANSLATION_KEYS, SchemaForm, SchemaFormDescription, type SchemaFormDescriptionProps, SchemaFormError, type SchemaFormErrorProps, SchemaFormFallback, type SchemaFormFallbackProps, SchemaFormField, type SchemaFormFieldProps, SchemaFormFields, type SchemaFormFieldsProps, type SchemaFormProps, SchemaFormProvider, type SchemaFormProviderProps, SchemaFormRoot, type SchemaFormRootProps, SchemaFormSubmit, type SchemaFormSubmitProps, SchemaFormTestAction, type SchemaFormTestActionProps, type SchemaFormTestActionStatus, SchemaFormTitle, type SchemaFormTitleProps, ScrollArea, type ScrollAreaProps, ScrollBar, type ScrollProgress, type ScrollProgressMode, type ScrollProgressOptions, SectionHeader, type SectionHeaderProps, SegmentedField, type SegmentedFieldOption, type SegmentedFieldProps, Select, SelectContent, SelectGroup, SelectItem, SelectLabel, SelectSeparator, SelectTrigger, SelectValue, Separator, type SeparatorProps, type SessionCapability, type SessionQuickAction, type SessionWhatsNewItem, Sheet, SheetClose, SheetContent, type SheetContentProps, SheetDescription, SheetFooter, SheetHeader, SheetPortal, SheetTitle, SheetTrigger, type Shortcut, type ShortcutGroup, SideDock, type SideDockProps, Sidebar, SidebarContent, SidebarFooter, SidebarGroup, SidebarGroupAction, SidebarGroupContent, SidebarGroupLabel, SidebarHeader, SidebarInput, SidebarInset, type SidebarInsetGutter, type SidebarInsetProps, SidebarMenu, SidebarMenuAction, SidebarMenuBadge, SidebarMenuButton, SidebarMenuItem, SidebarMenuSkeleton, SidebarMenuSub, SidebarMenuSubButton, SidebarMenuSubItem, SidebarProvider, SidebarRail, SidebarSeparator, SidebarTrigger, Skeleton, type SkeletonProps, SkipLink, type SkipLinkProps, type SlashCommand, Slider, SliderNumber, type SliderNumberProps, type SliderProps, type SliderThumbProps, SpecPlayground, type SpecPlaygroundError, type SpecPlaygroundExample, type SpecPlaygroundLabels, type SpecPlaygroundProps, type SpecPlaygroundStatus, type SpecPlaygroundValidation, Spinner, type SpinnerProps, SplitPanel, type SplitPanelProps, type SplitPanelTone, StatePanel, type StatePanelProps, type Status, StatusBadge, type StatusBadgeProps, StatusIcon, type StatusIconProps, type StatusTone, type SteppedColorScaleMethod, type SteppedColorScaleSpec, type StreamdownTranslationKey, type StreamdownTranslationMap, type StringFieldSpec, SuccessIllustration, SurfaceTour, SurfaceTourActions, type SurfaceTourActionsLabels, type SurfaceTourActionsProps, type SurfaceTourProps, type SurfaceTourTab, Switch, TEXT_ROLE_REM, TOKEN_SPOTLIGHT_SCAN_LIMIT, Table, TableBody, TableCaption, TableCell, TableFooter, TableHead, TableHeader, TableRow, Tabs, TabsContent, TabsList, type TabsListProps, TabsTrigger, type TabsVariant, TagInput, type TagInputProps, TeamSwitcher, type TeamSwitcherProps, type TeamSwitcherTeam, Text, type TextProps, type TextRole, type TextTone, type TextVariant, Textarea, type TextareaProps, type ThemeFamilySwatch, ThemeFamilySwitch, type ThemeFamilySwitchFamily, type ThemeFamilySwitchLabels, type ThemeFamilySwitchMode, type ThemeFamilySwitchProps, type ThemeFamilySwitchSize, type ThemePreference, ThemeSwitcher, type ThemeSwitcherProps, type ThemeTransitionEffect, Timeline, type TimelineEntry, TimelineItem, type TimelineItemProps, type TimelineProps, TimelineRoot, type TimelineRootProps, type TimelineStatus, Toaster, type ToasterProps, Toggle, ToggleGroup, ToggleGroupItem, TokenSpotlight, type TokenSpotlightLabels, type TokenSpotlightProps, type TokenSpotlightToken, Toolbar, ToolbarButton, type ToolbarButtonProps, type ToolbarProps, ToolbarSeparator, type ToolbarSeparatorProps, ToolbarSlot, ToolbarToggleGroup, type ToolbarToggleGroupProps, ToolbarToggleItem, type ToolbarToggleItemProps, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, TopNav, type TopNavProps, Transfer, type TransferItem, type TransferProps, Tree, type TreeNode, type TreeProps, TreeSelect, type TreeSelectProps, type TriggerBoundary, type TriggerQuery, UnsupportedJsonSchemaError, type UploadFile, type UseCollapsiblePanelOptions, type UseCollapsiblePanelReturn, type UseCopyToClipboardOptions, type UseDialogDismissGuardOptions, type UseTreeKeyboardOptions, type UseTreeKeyboardResult, ViewToolbar, ViewToolbarFilters, type ViewToolbarFiltersProps, type ViewToolbarProps, VirtualSelect, type VirtualSelectOption, type VirtualSelectProps, Wizard, WizardNav, type WizardNavProps, type WizardProps, WizardStep, type WizardStepMeta, type WizardStepProps, WizardSteps, type WizardStepsProps, type WizardValidator, type Workspace, WorkspacePicker, type WorkspacePickerProps, agentEventOutcomeStatus, alertVariants, badgeVariants, bentoGridItemVariants, booleanFieldSchema, buttonGroupVariants, buttonVariants, cardVariants, checkFileIssue, cn, collapseDiffRows, collectValidatableFields, colorScaleFor, countItems, csvQuoteField, csvStringifyValue, defaultMentionFilter, defaultSlashCommandFilter, dialogContentVariants, diffLineAccessibleLabel, diffLineMarker, downloadBlob, downloadUrl, effortRungForIndex, enumFieldSchema, enumOptionSchema, expandDialogPanesVariants, extensionOf, fieldLabel, fieldSpecSchema, fileFieldSchema, fileIconFor, fileMatchesAccept, findFieldByName, findTriggerQuery, formSectionSchema, formSpecSchema, formatElapsed, formatLastOpened, fromJsonSchema, fromTimelineStatus, groupFieldSchema, groupItemSchema, headingVariants, hunkVariants, illustrationAccent, initialFormValues, inputGroupAddonVariants, inputGroupVariants, insertMention, integerFieldSchema, isCustomStatus, isFieldVisible, isModuleNotFoundMessage, isMotionAtFloor, isOptionalPeerMissing, keyValueFieldSchema, keyValueRowSchema, laneColor, listFieldSchema, mediaTypeFromName, mentionAt, mentionEnd, meterFillVariants, meterVariants, modelPickerBody, multiEnumFieldSchema, navigationMenuTriggerStyle, normalizeFileSource, normalizeFormSpec, normalizeQuoteText, normalizeQuoteTextWithOffsets, normalizeRanges, numberFieldSchema, optionLabel, optionValue, parallaxOffset, progressIndicatorVariants, queryToRanges, readMotionFactor, remapMentions, replaceTriggerRun, resolveFileKind, resolveTokenDisplayValue, resolveTokenMatchValue, revealVariants, revisionTimelineVariants, scanForConsumers, serializeMentions, showsInlineError, sidebarMenuButtonVariants, splitPaneVariants, statePanelVariants, statusBadgeVariants, stepIndex, stringFieldSchema, supportsScrollTimeline, tabsListVariants, tabsTriggerVariants, textVariants, toggleVariants, toolbarVariants, useCollapsiblePanel, useCommandActiveItemId, useCopyToClipboard, useDialogDismissGuard, useDiffRows, useFileUpload, useIsMobile, useLocale, useMentionInput, useScrollProgress, useSidebar, useStreamdownTranslations, useThemeTransition, useTreeKeyboard, useVirtualListbox, validateField, validateForm };