@nextlyhq/ui 0.0.2-alpha.58 → 0.0.2-alpha.60

package/dist/index.d.cts

@@ -267,8 +267,13 @@ interface GridProps extends HTMLAttributes<HTMLDivElement> {
     cols?: Cols;
     /** Gap between cells. Default `4`. */
     gap?: Gap;
+    /**
+     * Collapse to one column in a narrow container. Off by default so existing
+     * callers keep the fixed column count they were written against.
+     */
+    responsive?: boolean;
 }
-/** Simple fixed-column grid.
+/** Simple fixed-column grid, or a container-responsive one via `responsive`.
  * @experimental
  */
 declare const Grid: react.ForwardRefExoticComponent<GridProps & react.RefAttributes<HTMLDivElement>>;
@@ -1132,8 +1137,8 @@ declare const TabsList: react.ForwardRefExoticComponent<Omit<_radix_ui_react_tab
  * - Padding: 6px 16px (px-4 py-2)
  * - Font: text-sm (14px), font-medium (500)
  * - Transition: 150ms (design system standard)
- * - Active state: blue text with blue bottom  border border-border (2px)
- * - Hover: blue text with blue bottom  border border-border
+ * - Active state: the accent colour on the text and on the 2px trailing border
+ * - Hover: the same accent, so the target reads before it is chosen
  * - Gmail-inspired clean underline style
  *
  * Accessibility:
@@ -1661,6 +1666,72 @@ declare function SelectScrollUpButton({ className, ...props }: ComponentProps<ty
 /** @experimental */
 declare function SelectScrollDownButton({ className, ...props }: ComponentProps<typeof SelectPrimitive.ScrollDownButton>): react_jsx_runtime.JSX.Element;
 
+/**
+ * Sheet Component Types
+ *
+ * TypeScript type definitions for the Sheet component (Dialog variant).
+ */
+
+/**
+ * Sheet root component props
+ * Extends Radix UI Dialog.Root props
+ * @public
+ */
+type SheetProps = React.ComponentPropsWithoutRef<typeof DialogPrimitive.Root>;
+/**
+ * Sheet trigger component props
+ * Extends Radix UI Dialog.Trigger props
+ * @experimental
+ */
+type SheetTriggerProps = React.ComponentPropsWithoutRef<typeof DialogPrimitive.Trigger>;
+/**
+ * Sheet close component props
+ * Extends Radix UI Dialog.Close props
+ * @experimental
+ */
+type SheetCloseProps = React.ComponentPropsWithoutRef<typeof DialogPrimitive.Close>;
+/**
+ * Sheet overlay component props
+ * Extends Radix UI Dialog.Overlay props
+ * @experimental
+ */
+type SheetOverlayProps = React.ComponentPropsWithoutRef<typeof DialogPrimitive.Overlay>;
+/**
+ * Sheet header component props
+ * Standard div props
+ * @public
+ */
+type SheetHeaderProps = React.HTMLAttributes<HTMLDivElement>;
+/**
+ * Sheet footer component props
+ * Standard div props
+ * @experimental
+ */
+type SheetFooterProps = React.HTMLAttributes<HTMLDivElement>;
+/**
+ * Sheet title component props
+ * Extends Radix UI Dialog.Title props
+ * @public
+ */
+type SheetTitleProps = React.ComponentPropsWithoutRef<typeof DialogPrimitive.Title>;
+/**
+ * Sheet description component props
+ * Extends Radix UI Dialog.Description props
+ * @public
+ */
+type SheetDescriptionProps = React.ComponentPropsWithoutRef<typeof DialogPrimitive.Description>;
+/**
+ * Sheet component refs
+ * @experimental
+ */
+type SheetOverlayRef = React.ElementRef<typeof DialogPrimitive.Overlay>;
+/** @experimental */
+type SheetContentRef = React.ElementRef<typeof DialogPrimitive.Content>;
+/** @experimental */
+type SheetTitleRef = React.ElementRef<typeof DialogPrimitive.Title>;
+/** @experimental */
+type SheetDescriptionRef = React.ElementRef<typeof DialogPrimitive.Description>;
+
 /**
  * Sheet Component
  *
@@ -1715,7 +1786,10 @@ declare function SelectScrollDownButton({ className, ...props }: ComponentProps<
  * @see https://www.radix-ui.com/primitives/docs/components/dialog
  * @public
  */
-declare const Sheet: react.FC<DialogPrimitive.DialogProps>;
+declare const Sheet: {
+    ({ modal, children, ...props }: SheetProps): react_jsx_runtime.JSX.Element;
+    displayName: string;
+};
 /** @experimental */
 declare const SheetTrigger: react.ForwardRefExoticComponent<DialogPrimitive.DialogTriggerProps & react.RefAttributes<HTMLButtonElement>>;
 /** @experimental */
@@ -1809,72 +1883,6 @@ declare const SheetTitle: react.ForwardRefExoticComponent<Omit<DialogPrimitive.D
  */
 declare const SheetDescription: react.ForwardRefExoticComponent<Omit<DialogPrimitive.DialogDescriptionProps & react.RefAttributes<HTMLParagraphElement>, "ref"> & react.RefAttributes<HTMLParagraphElement>>;
 
-/**
- * Sheet Component Types
- *
- * TypeScript type definitions for the Sheet component (Dialog variant).
- */
-
-/**
- * Sheet root component props
- * Extends Radix UI Dialog.Root props
- * @public
- */
-type SheetProps = React.ComponentPropsWithoutRef<typeof DialogPrimitive.Root>;
-/**
- * Sheet trigger component props
- * Extends Radix UI Dialog.Trigger props
- * @experimental
- */
-type SheetTriggerProps = React.ComponentPropsWithoutRef<typeof DialogPrimitive.Trigger>;
-/**
- * Sheet close component props
- * Extends Radix UI Dialog.Close props
- * @experimental
- */
-type SheetCloseProps = React.ComponentPropsWithoutRef<typeof DialogPrimitive.Close>;
-/**
- * Sheet overlay component props
- * Extends Radix UI Dialog.Overlay props
- * @experimental
- */
-type SheetOverlayProps = React.ComponentPropsWithoutRef<typeof DialogPrimitive.Overlay>;
-/**
- * Sheet header component props
- * Standard div props
- * @public
- */
-type SheetHeaderProps = React.HTMLAttributes<HTMLDivElement>;
-/**
- * Sheet footer component props
- * Standard div props
- * @experimental
- */
-type SheetFooterProps = React.HTMLAttributes<HTMLDivElement>;
-/**
- * Sheet title component props
- * Extends Radix UI Dialog.Title props
- * @public
- */
-type SheetTitleProps = React.ComponentPropsWithoutRef<typeof DialogPrimitive.Title>;
-/**
- * Sheet description component props
- * Extends Radix UI Dialog.Description props
- * @public
- */
-type SheetDescriptionProps = React.ComponentPropsWithoutRef<typeof DialogPrimitive.Description>;
-/**
- * Sheet component refs
- * @experimental
- */
-type SheetOverlayRef = React.ElementRef<typeof DialogPrimitive.Overlay>;
-/** @experimental */
-type SheetContentRef = React.ElementRef<typeof DialogPrimitive.Content>;
-/** @experimental */
-type SheetTitleRef = React.ElementRef<typeof DialogPrimitive.Title>;
-/** @experimental */
-type SheetDescriptionRef = React.ElementRef<typeof DialogPrimitive.Description>;
-
 /**
  * Command Component
  *
@@ -3087,4 +3095,130 @@ type KeySequence = readonly KeyChord[];
  */
 declare function parseKeys(spec: string): KeySequence;
 
-export { Accordion, AccordionContent, type AccordionContentProps, AccordionItem, type AccordionItemProps, type AccordionProps, AccordionTrigger, type AccordionTriggerProps, type ActionCallbacks, type ActiveShortcut, Alert, AlertDescription, type AlertDescriptionProps, AlertDialog, AlertDialogAction, type AlertDialogActionProps, AlertDialogCancel, type AlertDialogCancelProps, AlertDialogContent, type AlertDialogContentProps, AlertDialogDescription, type AlertDialogDescriptionProps, AlertDialogFooter, type AlertDialogFooterProps, AlertDialogHeader, type AlertDialogHeaderProps, AlertDialogOverlay, type AlertDialogOverlayProps, AlertDialogPortal, AlertDialogTitle, type AlertDialogTitleProps, AlertDialogTrigger, type AlertProps, AlertTitle, type AlertTitleProps, Avatar, AvatarFallback, type AvatarFallbackProps, AvatarImage, type AvatarImageProps, type AvatarProps, Badge, type BadgeProps, Button, type ButtonProps, Card, CardAction, type CardActionProps, CardContent, type CardContentProps, CardDescription, type CardDescriptionProps, CardFooter, type CardFooterProps, CardHeader, type CardHeaderProps, type CardProps, CardTitle, type CardTitleProps, Checkbox, Collapsible, CollapsibleContent, CollapsibleTrigger, ColorPicker, type ColorPickerProps, type ColorSwatch, Command, CommandDialog, type CommandDialogProps, CommandEmpty, type CommandEmptyProps, CommandGroup, type CommandGroupProps, CommandInput, type CommandInputProps, CommandItem, type CommandItemProps, CommandList, type CommandListProps, type CommandProps, CommandSeparator, type CommandSeparatorProps, CommandShortcut, type CommandShortcutProps, ContextMenu, ContextMenuCheckboxItem, ContextMenuContent, ContextMenuGroup, ContextMenuItem, ContextMenuLabel, ContextMenuRadioGroup, ContextMenuRadioItem, ContextMenuSeparator, ContextMenuShortcut, ContextMenuSub, ContextMenuSubContent, ContextMenuSubTrigger, ContextMenuTrigger, type DataFetcher, Dialog, DialogClose, DialogContent, type DialogContentProps, DialogDescription, type DialogDescriptionProps, DialogFooter, type DialogFooterProps, DialogHeader, type DialogHeaderProps, DialogOverlay, type DialogOverlayProps, DialogPortal, DialogTitle, type DialogTitleProps, DialogTrigger, DropdownMenu, DropdownMenuCheckboxItem, type DropdownMenuCheckboxItemProps, DropdownMenuContent, type DropdownMenuContentProps, DropdownMenuGroup, DropdownMenuItem, type DropdownMenuItemProps, DropdownMenuLabel, type DropdownMenuLabelProps, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, type DropdownMenuRadioItemProps, DropdownMenuSeparator, type DropdownMenuSeparatorProps, DropdownMenuShortcut, type DropdownMenuShortcutProps, DropdownMenuSub, DropdownMenuSubContent, type DropdownMenuSubContentProps, DropdownMenuSubTrigger, type DropdownMenuSubTriggerProps, DropdownMenuTrigger, type FilterInfo, FormLabelWithTooltip, type FormLabelWithTooltipProps, Grid, type GridProps, Input, type InputProps, type KeyChord, type KeySequence, Label, type ListResponse, type PaginationConfig, type PaginationMeta, Popover, PopoverAnchor, PopoverContent, PopoverTrigger, PortalProvider, Progress, type ProgressProps, RadioGroup, RadioGroupItem, ResizableHandle, ResizablePanel, ResizablePanelGroup, Select, SelectContent, SelectGroup, SelectItem, SelectLabel, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, type SelectTriggerProps, SelectValue, Separator, Sheet, SheetClose, type SheetCloseProps, SheetContent, type SheetContentProps, type SheetContentRef, SheetDescription, type SheetDescriptionProps, type SheetDescriptionRef, SheetFooter, type SheetFooterProps, SheetHeader, type SheetHeaderProps, SheetOverlay, type SheetOverlayProps, type SheetOverlayRef, SheetPortal, type SheetProps, SheetTitle, type SheetTitleProps, type SheetTitleRef, SheetTrigger, type SheetTriggerProps, type ShortcutBinding, type ShortcutLayerOptions, type ShortcutManager, type ShortcutManagerOptions, ShortcutProvider, type ShortcutProviderProps, type ShortcutRegistration, ShortcutScope, Skeleton, type SkeletonProps, Slider, type SliderProps, type SliderThumbProps, type SortInfo, Spinner, type SpinnerProps, Stack, type StackProps, Stat, type StatProps, Switch, Table, TableBody, TableCaption, TableCell, TableEmpty, type TableEmptyProps, TableError, type TableErrorProps, TableFooter, TableHead, TableHeader, TableLoading, type TableParams, TableRow, TableSearch, type TableSearchProps, TableSkeleton, type TableSkeletonProps, Tabs, TabsContent, type TabsContentProps, TabsList, type TabsListProps, type TabsProps, TabsTrigger, type TabsTriggerProps, Textarea, Toaster, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, type TreeNode, TreeView, type TreeViewProps, type UseShortcutsOptions, alertVariants, avatarVariants, badgeVariants, buttonVariants, cardVariants, commandDefaultFilter, createShortcutManager, dialogContentVariants, inputVariants, parseKeys, progressVariants, selectTriggerVariants, sheetVariants, spinnerVariants, useActiveShortcuts, usePortalContainer, useShortcutManager, useShortcuts };
+/**
+ * How wide a field's CONTROL may grow.
+ *
+ * Named rather than measured so a page cannot invent a one-off width, which is
+ * how the eight admin forms diverged. The caps read from custom properties with
+ * literal fallbacks, so a theme can retune them centrally without this file
+ * changing and without a page overriding them locally.
+ * @experimental
+ */
+type FieldWidth = "half" | "full" | "fill";
+/**
+ * The wiring `FieldShell` computes for its control: the id to attach, the
+ * composed `aria-describedby` (`undefined` when nothing is rendered to point
+ * at), and whether a rendered `error` forces the control invalid (`undefined`
+ * when there is no error to force one way or the other).
+ *
+ * A render-function `children` (see `FieldShellProps`) receives exactly this
+ * object — the SAME computation the element-clone path derives its
+ * `cloneElement` overrides from — so a caller wiring a compound control (a
+ * Radix `Select`'s trigger, for example) gets precisely the values the
+ * simple, single-element case would have applied.
+ * @experimental
+ */
+interface FieldShellRenderProps {
+    id: string;
+    describedBy: string | undefined;
+    invalid: boolean | undefined;
+}
+/** @experimental */
+interface FieldShellProps {
+    label?: React.ReactNode;
+    /** Helper text under the control. Rendered only when present. */
+    description?: React.ReactNode;
+    /** Validation message under the control. Rendered only when present. */
+    error?: React.ReactNode;
+    /** Defaults to "half": most admin inputs are short values. */
+    width?: FieldWidth;
+    htmlFor?: string;
+    className?: string;
+    /**
+     * Either a single element to clone, or a function that receives the
+     * computed wiring and applies it itself.
+     *
+     * The element form is `FieldShell` cloning it with `cloneElement` to
+     * attach the id, `aria-describedby` and `aria-invalid` it computes —
+     * unchanged from before, and still the right choice for an atomic control
+     * (`Input`, `Textarea`, `Switch`) that spreads its own props onto a real
+     * DOM node. Typing this branch as `ReactNode` would let a composite field
+     * (two inputs with a unit between them, for example) compile and then
+     * crash on mount, so it stays a single `ReactElement` — wrap several
+     * elements in one real element, a `<div>`, not a `<Fragment>`: a Fragment
+     * forwards none of those props to what is inside it.
+     *
+     * The function form exists for a compound control built on a Radix `Root`
+     * (`Select`, and by the same shape `RadioGroup`): `Root` destructures a
+     * fixed, named prop list and never spreads the remainder, so `id` handed
+     * to it via `cloneElement` is silently dropped rather than reaching the
+     * actual focusable element two levels down (`Select` > `SelectTrigger` >
+     * `SelectValue`). A render function is called with `FieldShellRenderProps`
+     * and applies `id`/`describedBy`/`invalid` to whichever nested element is
+     * the real control, instead of relying on a single top-level clone that
+     * can never reach it.
+     */
+    children: React.ReactElement | ((field: FieldShellRenderProps) => React.ReactNode);
+}
+/**
+ * The page measure. "form" suits most pages; "wide" is opt-in for dense ones.
+ * @experimental
+ */
+type FormMeasure = "form" | "wide";
+/** @experimental */
+interface FormLayoutProps {
+    width?: FormMeasure;
+    className?: string;
+    children: React.ReactNode;
+}
+/** @experimental */
+interface FormActionsProps {
+    /**
+     * Whether the form has unsaved changes. Supplied by the page from the form
+     * state that already tracks it; never computed here.
+     */
+    dirty?: boolean;
+    className?: string;
+    children: React.ReactNode;
+}
+
+/** @experimental */
+declare function FieldShell({ label, description, error, width, htmlFor, className, children, }: FieldShellProps): react_jsx_runtime.JSX.Element;
+
+/** @experimental */
+interface FormSectionProps {
+    /** Short label above the card, rendered uppercase. */
+    label: string;
+    /** Optional sentence under the label. */
+    description?: react.ReactNode;
+    className?: string;
+    children: react.ReactNode;
+}
+/**
+ * A labelled card holding a group of fields.
+ *
+ * Composes `Card` rather than hand-rolling its own border and background, so
+ * a section carries the CONTAINER radius tier `Card` already defines instead
+ * of a second, drifting copy of the same chrome. There is deliberately no
+ * footer slot. A form commits as one document, so its action belongs to the
+ * page rather than to a section.
+ * @experimental
+ */
+declare function FormSection({ label, description, className, children, }: FormSectionProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * @experimental
+ */
+declare function FormLayout({ width, className, children, }: FormLayoutProps): react_jsx_runtime.JSX.Element;
+/**
+ * One action bar per form, at the end of the measure.
+ *
+ * A form commits as a single document, so there is one place to commit it. The
+ * dirty flag arrives from the page because the form state already answers that
+ * question, and a second implementation of it here would disagree with the
+ * first as soon as either changed.
+ * @experimental
+ */
+declare function FormActions({ dirty, className, children }: FormActionsProps): react_jsx_runtime.JSX.Element;
+
+export { Accordion, AccordionContent, type AccordionContentProps, AccordionItem, type AccordionItemProps, type AccordionProps, AccordionTrigger, type AccordionTriggerProps, type ActionCallbacks, type ActiveShortcut, Alert, AlertDescription, type AlertDescriptionProps, AlertDialog, AlertDialogAction, type AlertDialogActionProps, AlertDialogCancel, type AlertDialogCancelProps, AlertDialogContent, type AlertDialogContentProps, AlertDialogDescription, type AlertDialogDescriptionProps, AlertDialogFooter, type AlertDialogFooterProps, AlertDialogHeader, type AlertDialogHeaderProps, AlertDialogOverlay, type AlertDialogOverlayProps, AlertDialogPortal, AlertDialogTitle, type AlertDialogTitleProps, AlertDialogTrigger, type AlertProps, AlertTitle, type AlertTitleProps, Avatar, AvatarFallback, type AvatarFallbackProps, AvatarImage, type AvatarImageProps, type AvatarProps, Badge, type BadgeProps, Button, type ButtonProps, Card, CardAction, type CardActionProps, CardContent, type CardContentProps, CardDescription, type CardDescriptionProps, CardFooter, type CardFooterProps, CardHeader, type CardHeaderProps, type CardProps, CardTitle, type CardTitleProps, Checkbox, Collapsible, CollapsibleContent, CollapsibleTrigger, ColorPicker, type ColorPickerProps, type ColorSwatch, Command, CommandDialog, type CommandDialogProps, CommandEmpty, type CommandEmptyProps, CommandGroup, type CommandGroupProps, CommandInput, type CommandInputProps, CommandItem, type CommandItemProps, CommandList, type CommandListProps, type CommandProps, CommandSeparator, type CommandSeparatorProps, CommandShortcut, type CommandShortcutProps, ContextMenu, ContextMenuCheckboxItem, ContextMenuContent, ContextMenuGroup, ContextMenuItem, ContextMenuLabel, ContextMenuRadioGroup, ContextMenuRadioItem, ContextMenuSeparator, ContextMenuShortcut, ContextMenuSub, ContextMenuSubContent, ContextMenuSubTrigger, ContextMenuTrigger, type DataFetcher, Dialog, DialogClose, DialogContent, type DialogContentProps, DialogDescription, type DialogDescriptionProps, DialogFooter, type DialogFooterProps, DialogHeader, type DialogHeaderProps, DialogOverlay, type DialogOverlayProps, DialogPortal, DialogTitle, type DialogTitleProps, DialogTrigger, DropdownMenu, DropdownMenuCheckboxItem, type DropdownMenuCheckboxItemProps, DropdownMenuContent, type DropdownMenuContentProps, DropdownMenuGroup, DropdownMenuItem, type DropdownMenuItemProps, DropdownMenuLabel, type DropdownMenuLabelProps, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, type DropdownMenuRadioItemProps, DropdownMenuSeparator, type DropdownMenuSeparatorProps, DropdownMenuShortcut, type DropdownMenuShortcutProps, DropdownMenuSub, DropdownMenuSubContent, type DropdownMenuSubContentProps, DropdownMenuSubTrigger, type DropdownMenuSubTriggerProps, DropdownMenuTrigger, FieldShell, type FieldShellProps, type FieldShellRenderProps, type FieldWidth, type FilterInfo, FormActions, type FormActionsProps, FormLabelWithTooltip, type FormLabelWithTooltipProps, FormLayout, type FormLayoutProps, type FormMeasure, FormSection, type FormSectionProps, Grid, type GridProps, Input, type InputProps, type KeyChord, type KeySequence, Label, type ListResponse, type PaginationConfig, type PaginationMeta, Popover, PopoverAnchor, PopoverContent, PopoverTrigger, PortalProvider, Progress, type ProgressProps, RadioGroup, RadioGroupItem, ResizableHandle, ResizablePanel, ResizablePanelGroup, Select, SelectContent, SelectGroup, SelectItem, SelectLabel, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, type SelectTriggerProps, SelectValue, Separator, Sheet, SheetClose, type SheetCloseProps, SheetContent, type SheetContentProps, type SheetContentRef, SheetDescription, type SheetDescriptionProps, type SheetDescriptionRef, SheetFooter, type SheetFooterProps, SheetHeader, type SheetHeaderProps, SheetOverlay, type SheetOverlayProps, type SheetOverlayRef, SheetPortal, type SheetProps, SheetTitle, type SheetTitleProps, type SheetTitleRef, SheetTrigger, type SheetTriggerProps, type ShortcutBinding, type ShortcutLayerOptions, type ShortcutManager, type ShortcutManagerOptions, ShortcutProvider, type ShortcutProviderProps, type ShortcutRegistration, ShortcutScope, Skeleton, type SkeletonProps, Slider, type SliderProps, type SliderThumbProps, type SortInfo, Spinner, type SpinnerProps, Stack, type StackProps, Stat, type StatProps, Switch, Table, TableBody, TableCaption, TableCell, TableEmpty, type TableEmptyProps, TableError, type TableErrorProps, TableFooter, TableHead, TableHeader, TableLoading, type TableParams, TableRow, TableSearch, type TableSearchProps, TableSkeleton, type TableSkeletonProps, Tabs, TabsContent, type TabsContentProps, TabsList, type TabsListProps, type TabsProps, TabsTrigger, type TabsTriggerProps, Textarea, Toaster, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, type TreeNode, TreeView, type TreeViewProps, type UseShortcutsOptions, alertVariants, avatarVariants, badgeVariants, buttonVariants, cardVariants, commandDefaultFilter, createShortcutManager, dialogContentVariants, inputVariants, parseKeys, progressVariants, selectTriggerVariants, sheetVariants, spinnerVariants, useActiveShortcuts, usePortalContainer, useShortcutManager, useShortcuts };

package/dist/index.d.ts

@@ -267,8 +267,13 @@ interface GridProps extends HTMLAttributes<HTMLDivElement> {
     cols?: Cols;
     /** Gap between cells. Default `4`. */
     gap?: Gap;
+    /**
+     * Collapse to one column in a narrow container. Off by default so existing
+     * callers keep the fixed column count they were written against.
+     */
+    responsive?: boolean;
 }
-/** Simple fixed-column grid.
+/** Simple fixed-column grid, or a container-responsive one via `responsive`.
  * @experimental
  */
 declare const Grid: react.ForwardRefExoticComponent<GridProps & react.RefAttributes<HTMLDivElement>>;
@@ -1132,8 +1137,8 @@ declare const TabsList: react.ForwardRefExoticComponent<Omit<_radix_ui_react_tab
  * - Padding: 6px 16px (px-4 py-2)
  * - Font: text-sm (14px), font-medium (500)
  * - Transition: 150ms (design system standard)
- * - Active state: blue text with blue bottom  border border-border (2px)
- * - Hover: blue text with blue bottom  border border-border
+ * - Active state: the accent colour on the text and on the 2px trailing border
+ * - Hover: the same accent, so the target reads before it is chosen
  * - Gmail-inspired clean underline style
  *
  * Accessibility:
@@ -1661,6 +1666,72 @@ declare function SelectScrollUpButton({ className, ...props }: ComponentProps<ty
 /** @experimental */
 declare function SelectScrollDownButton({ className, ...props }: ComponentProps<typeof SelectPrimitive.ScrollDownButton>): react_jsx_runtime.JSX.Element;
 
+/**
+ * Sheet Component Types
+ *
+ * TypeScript type definitions for the Sheet component (Dialog variant).
+ */
+
+/**
+ * Sheet root component props
+ * Extends Radix UI Dialog.Root props
+ * @public
+ */
+type SheetProps = React.ComponentPropsWithoutRef<typeof DialogPrimitive.Root>;
+/**
+ * Sheet trigger component props
+ * Extends Radix UI Dialog.Trigger props
+ * @experimental
+ */
+type SheetTriggerProps = React.ComponentPropsWithoutRef<typeof DialogPrimitive.Trigger>;
+/**
+ * Sheet close component props
+ * Extends Radix UI Dialog.Close props
+ * @experimental
+ */
+type SheetCloseProps = React.ComponentPropsWithoutRef<typeof DialogPrimitive.Close>;
+/**
+ * Sheet overlay component props
+ * Extends Radix UI Dialog.Overlay props
+ * @experimental
+ */
+type SheetOverlayProps = React.ComponentPropsWithoutRef<typeof DialogPrimitive.Overlay>;
+/**
+ * Sheet header component props
+ * Standard div props
+ * @public
+ */
+type SheetHeaderProps = React.HTMLAttributes<HTMLDivElement>;
+/**
+ * Sheet footer component props
+ * Standard div props
+ * @experimental
+ */
+type SheetFooterProps = React.HTMLAttributes<HTMLDivElement>;
+/**
+ * Sheet title component props
+ * Extends Radix UI Dialog.Title props
+ * @public
+ */
+type SheetTitleProps = React.ComponentPropsWithoutRef<typeof DialogPrimitive.Title>;
+/**
+ * Sheet description component props
+ * Extends Radix UI Dialog.Description props
+ * @public
+ */
+type SheetDescriptionProps = React.ComponentPropsWithoutRef<typeof DialogPrimitive.Description>;
+/**
+ * Sheet component refs
+ * @experimental
+ */
+type SheetOverlayRef = React.ElementRef<typeof DialogPrimitive.Overlay>;
+/** @experimental */
+type SheetContentRef = React.ElementRef<typeof DialogPrimitive.Content>;
+/** @experimental */
+type SheetTitleRef = React.ElementRef<typeof DialogPrimitive.Title>;
+/** @experimental */
+type SheetDescriptionRef = React.ElementRef<typeof DialogPrimitive.Description>;
+
 /**
  * Sheet Component
  *
@@ -1715,7 +1786,10 @@ declare function SelectScrollDownButton({ className, ...props }: ComponentProps<
  * @see https://www.radix-ui.com/primitives/docs/components/dialog
  * @public
  */
-declare const Sheet: react.FC<DialogPrimitive.DialogProps>;
+declare const Sheet: {
+    ({ modal, children, ...props }: SheetProps): react_jsx_runtime.JSX.Element;
+    displayName: string;
+};
 /** @experimental */
 declare const SheetTrigger: react.ForwardRefExoticComponent<DialogPrimitive.DialogTriggerProps & react.RefAttributes<HTMLButtonElement>>;
 /** @experimental */
@@ -1809,72 +1883,6 @@ declare const SheetTitle: react.ForwardRefExoticComponent<Omit<DialogPrimitive.D
  */
 declare const SheetDescription: react.ForwardRefExoticComponent<Omit<DialogPrimitive.DialogDescriptionProps & react.RefAttributes<HTMLParagraphElement>, "ref"> & react.RefAttributes<HTMLParagraphElement>>;
 
-/**
- * Sheet Component Types
- *
- * TypeScript type definitions for the Sheet component (Dialog variant).
- */
-
-/**
- * Sheet root component props
- * Extends Radix UI Dialog.Root props
- * @public
- */
-type SheetProps = React.ComponentPropsWithoutRef<typeof DialogPrimitive.Root>;
-/**
- * Sheet trigger component props
- * Extends Radix UI Dialog.Trigger props
- * @experimental
- */
-type SheetTriggerProps = React.ComponentPropsWithoutRef<typeof DialogPrimitive.Trigger>;
-/**
- * Sheet close component props
- * Extends Radix UI Dialog.Close props
- * @experimental
- */
-type SheetCloseProps = React.ComponentPropsWithoutRef<typeof DialogPrimitive.Close>;
-/**
- * Sheet overlay component props
- * Extends Radix UI Dialog.Overlay props
- * @experimental
- */
-type SheetOverlayProps = React.ComponentPropsWithoutRef<typeof DialogPrimitive.Overlay>;
-/**
- * Sheet header component props
- * Standard div props
- * @public
- */
-type SheetHeaderProps = React.HTMLAttributes<HTMLDivElement>;
-/**
- * Sheet footer component props
- * Standard div props
- * @experimental
- */
-type SheetFooterProps = React.HTMLAttributes<HTMLDivElement>;
-/**
- * Sheet title component props
- * Extends Radix UI Dialog.Title props
- * @public
- */
-type SheetTitleProps = React.ComponentPropsWithoutRef<typeof DialogPrimitive.Title>;
-/**
- * Sheet description component props
- * Extends Radix UI Dialog.Description props
- * @public
- */
-type SheetDescriptionProps = React.ComponentPropsWithoutRef<typeof DialogPrimitive.Description>;
-/**
- * Sheet component refs
- * @experimental
- */
-type SheetOverlayRef = React.ElementRef<typeof DialogPrimitive.Overlay>;
-/** @experimental */
-type SheetContentRef = React.ElementRef<typeof DialogPrimitive.Content>;
-/** @experimental */
-type SheetTitleRef = React.ElementRef<typeof DialogPrimitive.Title>;
-/** @experimental */
-type SheetDescriptionRef = React.ElementRef<typeof DialogPrimitive.Description>;
-
 /**
  * Command Component
  *
@@ -3087,4 +3095,130 @@ type KeySequence = readonly KeyChord[];
  */
 declare function parseKeys(spec: string): KeySequence;
 
-export { Accordion, AccordionContent, type AccordionContentProps, AccordionItem, type AccordionItemProps, type AccordionProps, AccordionTrigger, type AccordionTriggerProps, type ActionCallbacks, type ActiveShortcut, Alert, AlertDescription, type AlertDescriptionProps, AlertDialog, AlertDialogAction, type AlertDialogActionProps, AlertDialogCancel, type AlertDialogCancelProps, AlertDialogContent, type AlertDialogContentProps, AlertDialogDescription, type AlertDialogDescriptionProps, AlertDialogFooter, type AlertDialogFooterProps, AlertDialogHeader, type AlertDialogHeaderProps, AlertDialogOverlay, type AlertDialogOverlayProps, AlertDialogPortal, AlertDialogTitle, type AlertDialogTitleProps, AlertDialogTrigger, type AlertProps, AlertTitle, type AlertTitleProps, Avatar, AvatarFallback, type AvatarFallbackProps, AvatarImage, type AvatarImageProps, type AvatarProps, Badge, type BadgeProps, Button, type ButtonProps, Card, CardAction, type CardActionProps, CardContent, type CardContentProps, CardDescription, type CardDescriptionProps, CardFooter, type CardFooterProps, CardHeader, type CardHeaderProps, type CardProps, CardTitle, type CardTitleProps, Checkbox, Collapsible, CollapsibleContent, CollapsibleTrigger, ColorPicker, type ColorPickerProps, type ColorSwatch, Command, CommandDialog, type CommandDialogProps, CommandEmpty, type CommandEmptyProps, CommandGroup, type CommandGroupProps, CommandInput, type CommandInputProps, CommandItem, type CommandItemProps, CommandList, type CommandListProps, type CommandProps, CommandSeparator, type CommandSeparatorProps, CommandShortcut, type CommandShortcutProps, ContextMenu, ContextMenuCheckboxItem, ContextMenuContent, ContextMenuGroup, ContextMenuItem, ContextMenuLabel, ContextMenuRadioGroup, ContextMenuRadioItem, ContextMenuSeparator, ContextMenuShortcut, ContextMenuSub, ContextMenuSubContent, ContextMenuSubTrigger, ContextMenuTrigger, type DataFetcher, Dialog, DialogClose, DialogContent, type DialogContentProps, DialogDescription, type DialogDescriptionProps, DialogFooter, type DialogFooterProps, DialogHeader, type DialogHeaderProps, DialogOverlay, type DialogOverlayProps, DialogPortal, DialogTitle, type DialogTitleProps, DialogTrigger, DropdownMenu, DropdownMenuCheckboxItem, type DropdownMenuCheckboxItemProps, DropdownMenuContent, type DropdownMenuContentProps, DropdownMenuGroup, DropdownMenuItem, type DropdownMenuItemProps, DropdownMenuLabel, type DropdownMenuLabelProps, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, type DropdownMenuRadioItemProps, DropdownMenuSeparator, type DropdownMenuSeparatorProps, DropdownMenuShortcut, type DropdownMenuShortcutProps, DropdownMenuSub, DropdownMenuSubContent, type DropdownMenuSubContentProps, DropdownMenuSubTrigger, type DropdownMenuSubTriggerProps, DropdownMenuTrigger, type FilterInfo, FormLabelWithTooltip, type FormLabelWithTooltipProps, Grid, type GridProps, Input, type InputProps, type KeyChord, type KeySequence, Label, type ListResponse, type PaginationConfig, type PaginationMeta, Popover, PopoverAnchor, PopoverContent, PopoverTrigger, PortalProvider, Progress, type ProgressProps, RadioGroup, RadioGroupItem, ResizableHandle, ResizablePanel, ResizablePanelGroup, Select, SelectContent, SelectGroup, SelectItem, SelectLabel, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, type SelectTriggerProps, SelectValue, Separator, Sheet, SheetClose, type SheetCloseProps, SheetContent, type SheetContentProps, type SheetContentRef, SheetDescription, type SheetDescriptionProps, type SheetDescriptionRef, SheetFooter, type SheetFooterProps, SheetHeader, type SheetHeaderProps, SheetOverlay, type SheetOverlayProps, type SheetOverlayRef, SheetPortal, type SheetProps, SheetTitle, type SheetTitleProps, type SheetTitleRef, SheetTrigger, type SheetTriggerProps, type ShortcutBinding, type ShortcutLayerOptions, type ShortcutManager, type ShortcutManagerOptions, ShortcutProvider, type ShortcutProviderProps, type ShortcutRegistration, ShortcutScope, Skeleton, type SkeletonProps, Slider, type SliderProps, type SliderThumbProps, type SortInfo, Spinner, type SpinnerProps, Stack, type StackProps, Stat, type StatProps, Switch, Table, TableBody, TableCaption, TableCell, TableEmpty, type TableEmptyProps, TableError, type TableErrorProps, TableFooter, TableHead, TableHeader, TableLoading, type TableParams, TableRow, TableSearch, type TableSearchProps, TableSkeleton, type TableSkeletonProps, Tabs, TabsContent, type TabsContentProps, TabsList, type TabsListProps, type TabsProps, TabsTrigger, type TabsTriggerProps, Textarea, Toaster, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, type TreeNode, TreeView, type TreeViewProps, type UseShortcutsOptions, alertVariants, avatarVariants, badgeVariants, buttonVariants, cardVariants, commandDefaultFilter, createShortcutManager, dialogContentVariants, inputVariants, parseKeys, progressVariants, selectTriggerVariants, sheetVariants, spinnerVariants, useActiveShortcuts, usePortalContainer, useShortcutManager, useShortcuts };
+/**
+ * How wide a field's CONTROL may grow.
+ *
+ * Named rather than measured so a page cannot invent a one-off width, which is
+ * how the eight admin forms diverged. The caps read from custom properties with
+ * literal fallbacks, so a theme can retune them centrally without this file
+ * changing and without a page overriding them locally.
+ * @experimental
+ */
+type FieldWidth = "half" | "full" | "fill";
+/**
+ * The wiring `FieldShell` computes for its control: the id to attach, the
+ * composed `aria-describedby` (`undefined` when nothing is rendered to point
+ * at), and whether a rendered `error` forces the control invalid (`undefined`
+ * when there is no error to force one way or the other).
+ *
+ * A render-function `children` (see `FieldShellProps`) receives exactly this
+ * object — the SAME computation the element-clone path derives its
+ * `cloneElement` overrides from — so a caller wiring a compound control (a
+ * Radix `Select`'s trigger, for example) gets precisely the values the
+ * simple, single-element case would have applied.
+ * @experimental
+ */
+interface FieldShellRenderProps {
+    id: string;
+    describedBy: string | undefined;
+    invalid: boolean | undefined;
+}
+/** @experimental */
+interface FieldShellProps {
+    label?: React.ReactNode;
+    /** Helper text under the control. Rendered only when present. */
+    description?: React.ReactNode;
+    /** Validation message under the control. Rendered only when present. */
+    error?: React.ReactNode;
+    /** Defaults to "half": most admin inputs are short values. */
+    width?: FieldWidth;
+    htmlFor?: string;
+    className?: string;
+    /**
+     * Either a single element to clone, or a function that receives the
+     * computed wiring and applies it itself.
+     *
+     * The element form is `FieldShell` cloning it with `cloneElement` to
+     * attach the id, `aria-describedby` and `aria-invalid` it computes —
+     * unchanged from before, and still the right choice for an atomic control
+     * (`Input`, `Textarea`, `Switch`) that spreads its own props onto a real
+     * DOM node. Typing this branch as `ReactNode` would let a composite field
+     * (two inputs with a unit between them, for example) compile and then
+     * crash on mount, so it stays a single `ReactElement` — wrap several
+     * elements in one real element, a `<div>`, not a `<Fragment>`: a Fragment
+     * forwards none of those props to what is inside it.
+     *
+     * The function form exists for a compound control built on a Radix `Root`
+     * (`Select`, and by the same shape `RadioGroup`): `Root` destructures a
+     * fixed, named prop list and never spreads the remainder, so `id` handed
+     * to it via `cloneElement` is silently dropped rather than reaching the
+     * actual focusable element two levels down (`Select` > `SelectTrigger` >
+     * `SelectValue`). A render function is called with `FieldShellRenderProps`
+     * and applies `id`/`describedBy`/`invalid` to whichever nested element is
+     * the real control, instead of relying on a single top-level clone that
+     * can never reach it.
+     */
+    children: React.ReactElement | ((field: FieldShellRenderProps) => React.ReactNode);
+}
+/**
+ * The page measure. "form" suits most pages; "wide" is opt-in for dense ones.
+ * @experimental
+ */
+type FormMeasure = "form" | "wide";
+/** @experimental */
+interface FormLayoutProps {
+    width?: FormMeasure;
+    className?: string;
+    children: React.ReactNode;
+}
+/** @experimental */
+interface FormActionsProps {
+    /**
+     * Whether the form has unsaved changes. Supplied by the page from the form
+     * state that already tracks it; never computed here.
+     */
+    dirty?: boolean;
+    className?: string;
+    children: React.ReactNode;
+}
+
+/** @experimental */
+declare function FieldShell({ label, description, error, width, htmlFor, className, children, }: FieldShellProps): react_jsx_runtime.JSX.Element;
+
+/** @experimental */
+interface FormSectionProps {
+    /** Short label above the card, rendered uppercase. */
+    label: string;
+    /** Optional sentence under the label. */
+    description?: react.ReactNode;
+    className?: string;
+    children: react.ReactNode;
+}
+/**
+ * A labelled card holding a group of fields.
+ *
+ * Composes `Card` rather than hand-rolling its own border and background, so
+ * a section carries the CONTAINER radius tier `Card` already defines instead
+ * of a second, drifting copy of the same chrome. There is deliberately no
+ * footer slot. A form commits as one document, so its action belongs to the
+ * page rather than to a section.
+ * @experimental
+ */
+declare function FormSection({ label, description, className, children, }: FormSectionProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * @experimental
+ */
+declare function FormLayout({ width, className, children, }: FormLayoutProps): react_jsx_runtime.JSX.Element;
+/**
+ * One action bar per form, at the end of the measure.
+ *
+ * A form commits as a single document, so there is one place to commit it. The
+ * dirty flag arrives from the page because the form state already answers that
+ * question, and a second implementation of it here would disagree with the
+ * first as soon as either changed.
+ * @experimental
+ */
+declare function FormActions({ dirty, className, children }: FormActionsProps): react_jsx_runtime.JSX.Element;
+
+export { Accordion, AccordionContent, type AccordionContentProps, AccordionItem, type AccordionItemProps, type AccordionProps, AccordionTrigger, type AccordionTriggerProps, type ActionCallbacks, type ActiveShortcut, Alert, AlertDescription, type AlertDescriptionProps, AlertDialog, AlertDialogAction, type AlertDialogActionProps, AlertDialogCancel, type AlertDialogCancelProps, AlertDialogContent, type AlertDialogContentProps, AlertDialogDescription, type AlertDialogDescriptionProps, AlertDialogFooter, type AlertDialogFooterProps, AlertDialogHeader, type AlertDialogHeaderProps, AlertDialogOverlay, type AlertDialogOverlayProps, AlertDialogPortal, AlertDialogTitle, type AlertDialogTitleProps, AlertDialogTrigger, type AlertProps, AlertTitle, type AlertTitleProps, Avatar, AvatarFallback, type AvatarFallbackProps, AvatarImage, type AvatarImageProps, type AvatarProps, Badge, type BadgeProps, Button, type ButtonProps, Card, CardAction, type CardActionProps, CardContent, type CardContentProps, CardDescription, type CardDescriptionProps, CardFooter, type CardFooterProps, CardHeader, type CardHeaderProps, type CardProps, CardTitle, type CardTitleProps, Checkbox, Collapsible, CollapsibleContent, CollapsibleTrigger, ColorPicker, type ColorPickerProps, type ColorSwatch, Command, CommandDialog, type CommandDialogProps, CommandEmpty, type CommandEmptyProps, CommandGroup, type CommandGroupProps, CommandInput, type CommandInputProps, CommandItem, type CommandItemProps, CommandList, type CommandListProps, type CommandProps, CommandSeparator, type CommandSeparatorProps, CommandShortcut, type CommandShortcutProps, ContextMenu, ContextMenuCheckboxItem, ContextMenuContent, ContextMenuGroup, ContextMenuItem, ContextMenuLabel, ContextMenuRadioGroup, ContextMenuRadioItem, ContextMenuSeparator, ContextMenuShortcut, ContextMenuSub, ContextMenuSubContent, ContextMenuSubTrigger, ContextMenuTrigger, type DataFetcher, Dialog, DialogClose, DialogContent, type DialogContentProps, DialogDescription, type DialogDescriptionProps, DialogFooter, type DialogFooterProps, DialogHeader, type DialogHeaderProps, DialogOverlay, type DialogOverlayProps, DialogPortal, DialogTitle, type DialogTitleProps, DialogTrigger, DropdownMenu, DropdownMenuCheckboxItem, type DropdownMenuCheckboxItemProps, DropdownMenuContent, type DropdownMenuContentProps, DropdownMenuGroup, DropdownMenuItem, type DropdownMenuItemProps, DropdownMenuLabel, type DropdownMenuLabelProps, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, type DropdownMenuRadioItemProps, DropdownMenuSeparator, type DropdownMenuSeparatorProps, DropdownMenuShortcut, type DropdownMenuShortcutProps, DropdownMenuSub, DropdownMenuSubContent, type DropdownMenuSubContentProps, DropdownMenuSubTrigger, type DropdownMenuSubTriggerProps, DropdownMenuTrigger, FieldShell, type FieldShellProps, type FieldShellRenderProps, type FieldWidth, type FilterInfo, FormActions, type FormActionsProps, FormLabelWithTooltip, type FormLabelWithTooltipProps, FormLayout, type FormLayoutProps, type FormMeasure, FormSection, type FormSectionProps, Grid, type GridProps, Input, type InputProps, type KeyChord, type KeySequence, Label, type ListResponse, type PaginationConfig, type PaginationMeta, Popover, PopoverAnchor, PopoverContent, PopoverTrigger, PortalProvider, Progress, type ProgressProps, RadioGroup, RadioGroupItem, ResizableHandle, ResizablePanel, ResizablePanelGroup, Select, SelectContent, SelectGroup, SelectItem, SelectLabel, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, type SelectTriggerProps, SelectValue, Separator, Sheet, SheetClose, type SheetCloseProps, SheetContent, type SheetContentProps, type SheetContentRef, SheetDescription, type SheetDescriptionProps, type SheetDescriptionRef, SheetFooter, type SheetFooterProps, SheetHeader, type SheetHeaderProps, SheetOverlay, type SheetOverlayProps, type SheetOverlayRef, SheetPortal, type SheetProps, SheetTitle, type SheetTitleProps, type SheetTitleRef, SheetTrigger, type SheetTriggerProps, type ShortcutBinding, type ShortcutLayerOptions, type ShortcutManager, type ShortcutManagerOptions, ShortcutProvider, type ShortcutProviderProps, type ShortcutRegistration, ShortcutScope, Skeleton, type SkeletonProps, Slider, type SliderProps, type SliderThumbProps, type SortInfo, Spinner, type SpinnerProps, Stack, type StackProps, Stat, type StatProps, Switch, Table, TableBody, TableCaption, TableCell, TableEmpty, type TableEmptyProps, TableError, type TableErrorProps, TableFooter, TableHead, TableHeader, TableLoading, type TableParams, TableRow, TableSearch, type TableSearchProps, TableSkeleton, type TableSkeletonProps, Tabs, TabsContent, type TabsContentProps, TabsList, type TabsListProps, type TabsProps, TabsTrigger, type TabsTriggerProps, Textarea, Toaster, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, type TreeNode, TreeView, type TreeViewProps, type UseShortcutsOptions, alertVariants, avatarVariants, badgeVariants, buttonVariants, cardVariants, commandDefaultFilter, createShortcutManager, dialogContentVariants, inputVariants, parseKeys, progressVariants, selectTriggerVariants, sheetVariants, spinnerVariants, useActiveShortcuts, usePortalContainer, useShortcutManager, useShortcuts };