@invana/ui 0.0.4 → 0.0.6

package/dist/index.d.cts

@@ -525,6 +525,54 @@ interface MenuItem {
 }
 declare const MenuItem: React$1.FC<MenuItemProps>;
 
+/**
+ * NavItemConfig - Shared configuration for a single navigation item, used by
+ * both NavHorizontal and NavVertical. An item renders as an `<a>` (when `href`
+ * is set), a `<button>` (when `onClick` is set), or a static `<div>`.
+ */
+interface NavItemConfig {
+    /** Optional unique key for React rendering */
+    key?: string;
+    /** Display name shown in tooltip */
+    name: string;
+    /** Optional label text to display next to the icon */
+    label?: React__default.ReactNode;
+    /** Navigation URL (for anchor tag) */
+    href?: string;
+    /** Click handler (for button behavior) */
+    onClick?: () => void;
+    /** Additional CSS classes for the item wrapper */
+    className?: string;
+    /** CSS classes applied when item is active */
+    activeClass?: string;
+    /** CSS classes for the icon */
+    iconClassName?: string;
+    /** Stroke width for the icon (default: 2) */
+    iconStroke?: number;
+    /** Tooltip position */
+    tooltipSide?: 'top' | 'right' | 'bottom' | 'left';
+    /** Show a separator line after this item */
+    showSeperator?: boolean;
+    /** Lucide icon component */
+    icon: React__default.ElementType | LucideIcon;
+    /** Custom tooltip content (overrides name) */
+    tooltip?: React__default.ReactNode;
+}
+interface NavItemsProps {
+    items: NavItemConfig[];
+    /** Layout orientation — drives default icon size, padding, tooltip side and separator. */
+    orientation?: 'horizontal' | 'vertical';
+    /** Default tooltip side when an item doesn't specify one. */
+    tooltipSide?: 'top' | 'right' | 'bottom' | 'left';
+    /** Default icon classes when an item doesn't specify `iconClassName`. */
+    iconClassName?: string;
+}
+/**
+ * NavItems - Shared renderer for navigation items. Renders href / onClick /
+ * static items with identical styling so all three share the same padding,
+ * primary hover + active highlight, and icon size.
+ */
+declare const NavItems: React__default.FC<NavItemsProps>;
 interface NavSection {
     content?: React__default.ReactNode;
     className?: string;
@@ -565,34 +613,7 @@ declare const NavBase: React__default.FC<BaseNavProps>;
  * ];
  * ```
  */
-interface NavHorizontalItem {
-    /** Optional unique key for React rendering */
-    key?: string;
-    /** Display name shown in tooltip */
-    name: string;
-    /** Optional label text to display next to the icon */
-    label?: React__default.ReactNode;
-    /** Navigation URL (for anchor tag) */
-    href?: string;
-    /** Click handler (for button behavior) */
-    onClick?: () => void;
-    /** Additional CSS classes for the item wrapper */
-    className?: string;
-    /** CSS classes applied when item is active */
-    activeClass?: string;
-    /** CSS classes for the icon */
-    iconClassName?: string;
-    /** Stroke width for the icon (default: 2) */
-    iconStroke?: number;
-    /** Tooltip position (default: 'bottom') */
-    tooltipSide?: 'top' | 'right' | 'bottom' | 'left';
-    /** Show a separator line after this item */
-    showSeperator?: boolean;
-    /** Lucide icon component */
-    icon: React__default.ElementType | LucideIcon;
-    /** Custom tooltip content (overrides name) */
-    tooltip?: React__default.ReactNode;
-}
+type NavHorizontalItem = NavItemConfig;
 interface NavHorizontalItemsProps {
     items: NavHorizontalItem[];
 }
@@ -673,32 +694,7 @@ declare const NavHorizontal: React__default.FC<NavHorizontalProps>;
  * ];
  * ```
  */
-interface NavVerticalItem {
-    /** Optional unique key for React rendering */
-    key?: string;
-    /** Display name shown in tooltip */
-    name: string;
-    /** Navigation URL (for anchor tag) */
-    href?: string;
-    /** Click handler (for button behavior) */
-    onClick?: () => void;
-    /** Additional CSS classes for the item wrapper */
-    className?: string;
-    /** CSS classes applied when item is active */
-    activeClass?: string;
-    /** CSS classes for the icon */
-    iconClassName?: string;
-    /** Stroke width for the icon (default: 2) */
-    iconStroke?: number;
-    /** Tooltip position (default: 'right') */
-    tooltipSide?: 'top' | 'right' | 'bottom' | 'left';
-    /** Show a separator line after this item */
-    showSeperator?: boolean;
-    /** Lucide icon component */
-    icon: React__default.ElementType | LucideIcon;
-    /** Custom tooltip content (overrides name) */
-    tooltip?: React__default.ReactNode;
-}
+type NavVerticalItem = NavItemConfig;
 interface NavVerticalItemsProps {
     items: NavVerticalItem[];
 }
@@ -775,6 +771,59 @@ interface PanelContentProps {
 }
 declare function PanelContent({ title, titleText, children, onClose, showClose, headerClassName, bodyClassName, footerContent, footerClassName, closeIcon }: PanelContentProps): react_jsx_runtime.JSX.Element;
 
+interface RichSelectOption {
+    /** Stable key used as the selection value. */
+    value: string;
+    /** Rich primary content — string or JSX. */
+    label: React$1.ReactNode;
+    /** Secondary line shown muted under the label. */
+    description?: React$1.ReactNode;
+    /** Lucide glyph or any component accepting `{ size }`. */
+    icon?: React$1.ElementType;
+    /** Trailing content (e.g. a count or status badge), pushed to the right. */
+    badge?: React$1.ReactNode;
+    disabled?: boolean;
+}
+interface RichSelectProps {
+    options: RichSelectOption[];
+    /** `string` in single mode, `string[]` in multi mode. */
+    value: string | string[];
+    /** Fired with the new selection — mirrors the mode of {@link value}. */
+    onChange: (value: string | string[]) => void;
+    /** Enable multi-select (checkboxes). Default `false` (radio). */
+    multiple?: boolean;
+    /** Menu heading and default trigger prefix. */
+    label?: string;
+    /** Trigger content when nothing is selected. */
+    placeholder?: React$1.ReactNode;
+    /** Full custom row JSX. Overrides the default row layout. */
+    renderOption?: (option: RichSelectOption, state: {
+        selected: boolean;
+    }) => React$1.ReactNode;
+    /** Full custom trigger JSX for the current selection. Overrides the default. */
+    renderValue?: (selected: RichSelectOption[]) => React$1.ReactNode;
+    /** Menu alignment relative to the trigger. Default `'start'`. */
+    align?: "start" | "center" | "end";
+    /** Trigger tooltip content; omit to disable the tooltip. */
+    tooltip?: React$1.ReactNode;
+    /** Side the trigger tooltip is placed on. Default `'top'`. */
+    tooltipSide?: "top" | "right" | "bottom" | "left";
+    disabled?: boolean;
+    /** Class merged onto the trigger Button. */
+    triggerClassName?: string;
+    /** Class merged onto the dropdown content. */
+    contentClassName?: string;
+    /** Alias of {@link triggerClassName} for ergonomics. */
+    className?: string;
+}
+/**
+ * A `<select>` replacement built on {@link DropdownMenu}. Each option carries
+ * rich content (`label`, `description`, `icon`, `badge`) and both the rows and
+ * the trigger are fully customizable via `renderOption` / `renderValue`.
+ * Supports single (radio) and multi (checkbox) selection via `multiple`.
+ */
+declare function RichSelect({ options, value, onChange, multiple, label, placeholder, renderOption, renderValue, align, tooltip, tooltipSide, disabled, triggerClassName, contentClassName, className, }: RichSelectProps): react_jsx_runtime.JSX.Element;
+
 interface TabConfig {
     /** Unique identifier for the tab */
     value: string;
@@ -1038,4 +1087,4 @@ declare const Typography: {
     Pre: React$1.ForwardRefExoticComponent<TypographyPreProps & React$1.RefAttributes<HTMLPreElement>>;
 };
 
-export { Accordion, AccordionContent, AccordionItem, AccordionTrigger, Alert, AlertDescription, AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogOverlay, AlertDialogPortal, AlertDialogTitle, AlertDialogTrigger, AlertTitle, Avatar, AvatarFallback, AvatarImage, Badge, type BadgeProps, type BaseNavProps, Breadcrumb, BreadcrumbEllipsis, BreadcrumbItem, BreadcrumbLink, BreadcrumbList, BreadcrumbPage, BreadcrumbSeparator, Button, ButtonGroup, ButtonGroupSeparator, ButtonGroupText, type ButtonProps, ButtonWithTooltip, type ButtonWithTooltipProps, Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, CardWithHeader, Carousel, type CarouselApi, CarouselContent, CarouselItem, CarouselNext, CarouselPrevious, Command, CommandDialog, CommandEmpty, CommandGroup, CommandInput, CommandItem, CommandList, CommandSeparator, CommandShortcut, Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, ErrorBoundary, HoverCard, HoverCardContent, HoverCardTrigger, Item, ItemActions, ItemContent, ItemDescription, ItemFooter, ItemGroup, ItemHeader, ItemMedia, ItemSeparator, ItemTitle, Kbd, KbdGroup, MenuItem, type MenuItemProps, Menubar, MenubarCheckboxItem, MenubarContent, MenubarGroup, MenubarItem, MenubarLabel, MenubarMenu, MenubarPortal, MenubarRadioGroup, MenubarRadioItem, MenubarSeparator, MenubarShortcut, MenubarSub, MenubarSubContent, MenubarSubTrigger, MenubarTrigger, NavBase, NavHorizontal, type NavHorizontalItem, NavHorizontalItems, type NavHorizontalItemsProps, type NavHorizontalProps, type NavSection, NavVertical, type NavVerticalItem, NavVerticalItems, type NavVerticalItemsProps, type NavVerticalProps, NavigationMenu, NavigationMenuContent, NavigationMenuIndicator, NavigationMenuItem, NavigationMenuLink, NavigationMenuList, NavigationMenuTrigger, NavigationMenuViewport, NestedMenu, type NestedMenuProps, Pagination, PaginationContent, PaginationEllipsis, PaginationItem, PaginationLink, PaginationNext, PaginationPrevious, PanelContent, type PanelContentProps, Popover, PopoverContent, PopoverTrigger, Progress, ResizableHandle, ResizablePanel, ResizablePanelGroup, ScrollArea, ScrollBar, SearchInput, Separator, Sheet, SheetClose, SheetContent, SheetDescription, SheetFooter, SheetHeader, SheetOverlay, SheetPortal, SheetTitle, SheetTrigger, Sidebar, SidebarContent, SidebarFooter, SidebarGroup, SidebarGroupAction, SidebarGroupContent, SidebarGroupLabel, SidebarHeader, SidebarInput, SidebarInset, SidebarMenu, SidebarMenuAction, SidebarMenuBadge, SidebarMenuButton, SidebarMenuItem, SidebarMenuSkeleton, SidebarMenuSub, SidebarMenuSubButton, SidebarMenuSubItem, SidebarProvider, SidebarRail, SidebarSeparator, SidebarTrigger, Skeleton, Spinner, type TabConfig, TabbedPanel, type TabbedPanelProps, Table, TableBody, TableCaption, TableCell, TableFooter, TableHead, TableHeader, TableRow, Tabs, TabsContent, TabsList, TabsTrigger, Toaster, Toggle, ToggleGroup, ToggleGroupItem, Toolbar, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, Tour, type TourController, type TourProps, type TourReference, type TourStep, TreeItem, TreeView, type TreeViewProps, Typography, TypographyBlockquote, type TypographyBlockquoteProps, TypographyH1, type TypographyH1Props, TypographyH2, type TypographyH2Props, TypographyH3, type TypographyH3Props, TypographyH4, type TypographyH4Props, TypographyH5, type TypographyH5Props, TypographyH6, type TypographyH6Props, TypographyInlineCode, type TypographyInlineCodeProps, TypographyLarge, type TypographyLargeProps, TypographyLead, type TypographyLeadProps, TypographyList, type TypographyListProps, TypographyMuted, type TypographyMutedProps, TypographyP, type TypographyPProps, TypographyPre, type TypographyPreProps, TypographySmall, type TypographySmallProps, UnderDevelopment, type UnderDevelopmentProps, type UseTourOptions, badgeVariants, buttonGroupVariants, buttonVariants, cn, navigationMenuTriggerStyle, toggleVariants, useSidebar, useTour };
+export { Accordion, AccordionContent, AccordionItem, AccordionTrigger, Alert, AlertDescription, AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogOverlay, AlertDialogPortal, AlertDialogTitle, AlertDialogTrigger, AlertTitle, Avatar, AvatarFallback, AvatarImage, Badge, type BadgeProps, type BaseNavProps, Breadcrumb, BreadcrumbEllipsis, BreadcrumbItem, BreadcrumbLink, BreadcrumbList, BreadcrumbPage, BreadcrumbSeparator, Button, ButtonGroup, ButtonGroupSeparator, ButtonGroupText, type ButtonProps, ButtonWithTooltip, type ButtonWithTooltipProps, Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, CardWithHeader, Carousel, type CarouselApi, CarouselContent, CarouselItem, CarouselNext, CarouselPrevious, Command, CommandDialog, CommandEmpty, CommandGroup, CommandInput, CommandItem, CommandList, CommandSeparator, CommandShortcut, Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, ErrorBoundary, HoverCard, HoverCardContent, HoverCardTrigger, Item, ItemActions, ItemContent, ItemDescription, ItemFooter, ItemGroup, ItemHeader, ItemMedia, ItemSeparator, ItemTitle, Kbd, KbdGroup, MenuItem, type MenuItemProps, Menubar, MenubarCheckboxItem, MenubarContent, MenubarGroup, MenubarItem, MenubarLabel, MenubarMenu, MenubarPortal, MenubarRadioGroup, MenubarRadioItem, MenubarSeparator, MenubarShortcut, MenubarSub, MenubarSubContent, MenubarSubTrigger, MenubarTrigger, NavBase, NavHorizontal, type NavHorizontalItem, NavHorizontalItems, type NavHorizontalItemsProps, type NavHorizontalProps, type NavItemConfig, NavItems, type NavItemsProps, type NavSection, NavVertical, type NavVerticalItem, NavVerticalItems, type NavVerticalItemsProps, type NavVerticalProps, NavigationMenu, NavigationMenuContent, NavigationMenuIndicator, NavigationMenuItem, NavigationMenuLink, NavigationMenuList, NavigationMenuTrigger, NavigationMenuViewport, NestedMenu, type NestedMenuProps, Pagination, PaginationContent, PaginationEllipsis, PaginationItem, PaginationLink, PaginationNext, PaginationPrevious, PanelContent, type PanelContentProps, Popover, PopoverContent, PopoverTrigger, Progress, ResizableHandle, ResizablePanel, ResizablePanelGroup, RichSelect, type RichSelectOption, type RichSelectProps, ScrollArea, ScrollBar, SearchInput, Separator, Sheet, SheetClose, SheetContent, SheetDescription, SheetFooter, SheetHeader, SheetOverlay, SheetPortal, SheetTitle, SheetTrigger, Sidebar, SidebarContent, SidebarFooter, SidebarGroup, SidebarGroupAction, SidebarGroupContent, SidebarGroupLabel, SidebarHeader, SidebarInput, SidebarInset, SidebarMenu, SidebarMenuAction, SidebarMenuBadge, SidebarMenuButton, SidebarMenuItem, SidebarMenuSkeleton, SidebarMenuSub, SidebarMenuSubButton, SidebarMenuSubItem, SidebarProvider, SidebarRail, SidebarSeparator, SidebarTrigger, Skeleton, Spinner, type TabConfig, TabbedPanel, type TabbedPanelProps, Table, TableBody, TableCaption, TableCell, TableFooter, TableHead, TableHeader, TableRow, Tabs, TabsContent, TabsList, TabsTrigger, Toaster, Toggle, ToggleGroup, ToggleGroupItem, Toolbar, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, Tour, type TourController, type TourProps, type TourReference, type TourStep, TreeItem, TreeView, type TreeViewProps, Typography, TypographyBlockquote, type TypographyBlockquoteProps, TypographyH1, type TypographyH1Props, TypographyH2, type TypographyH2Props, TypographyH3, type TypographyH3Props, TypographyH4, type TypographyH4Props, TypographyH5, type TypographyH5Props, TypographyH6, type TypographyH6Props, TypographyInlineCode, type TypographyInlineCodeProps, TypographyLarge, type TypographyLargeProps, TypographyLead, type TypographyLeadProps, TypographyList, type TypographyListProps, TypographyMuted, type TypographyMutedProps, TypographyP, type TypographyPProps, TypographyPre, type TypographyPreProps, TypographySmall, type TypographySmallProps, UnderDevelopment, type UnderDevelopmentProps, type UseTourOptions, badgeVariants, buttonGroupVariants, buttonVariants, cn, navigationMenuTriggerStyle, toggleVariants, useSidebar, useTour };

package/dist/index.d.ts

@@ -525,6 +525,54 @@ interface MenuItem {
 }
 declare const MenuItem: React$1.FC<MenuItemProps>;
 
+/**
+ * NavItemConfig - Shared configuration for a single navigation item, used by
+ * both NavHorizontal and NavVertical. An item renders as an `<a>` (when `href`
+ * is set), a `<button>` (when `onClick` is set), or a static `<div>`.
+ */
+interface NavItemConfig {
+    /** Optional unique key for React rendering */
+    key?: string;
+    /** Display name shown in tooltip */
+    name: string;
+    /** Optional label text to display next to the icon */
+    label?: React__default.ReactNode;
+    /** Navigation URL (for anchor tag) */
+    href?: string;
+    /** Click handler (for button behavior) */
+    onClick?: () => void;
+    /** Additional CSS classes for the item wrapper */
+    className?: string;
+    /** CSS classes applied when item is active */
+    activeClass?: string;
+    /** CSS classes for the icon */
+    iconClassName?: string;
+    /** Stroke width for the icon (default: 2) */
+    iconStroke?: number;
+    /** Tooltip position */
+    tooltipSide?: 'top' | 'right' | 'bottom' | 'left';
+    /** Show a separator line after this item */
+    showSeperator?: boolean;
+    /** Lucide icon component */
+    icon: React__default.ElementType | LucideIcon;
+    /** Custom tooltip content (overrides name) */
+    tooltip?: React__default.ReactNode;
+}
+interface NavItemsProps {
+    items: NavItemConfig[];
+    /** Layout orientation — drives default icon size, padding, tooltip side and separator. */
+    orientation?: 'horizontal' | 'vertical';
+    /** Default tooltip side when an item doesn't specify one. */
+    tooltipSide?: 'top' | 'right' | 'bottom' | 'left';
+    /** Default icon classes when an item doesn't specify `iconClassName`. */
+    iconClassName?: string;
+}
+/**
+ * NavItems - Shared renderer for navigation items. Renders href / onClick /
+ * static items with identical styling so all three share the same padding,
+ * primary hover + active highlight, and icon size.
+ */
+declare const NavItems: React__default.FC<NavItemsProps>;
 interface NavSection {
     content?: React__default.ReactNode;
     className?: string;
@@ -565,34 +613,7 @@ declare const NavBase: React__default.FC<BaseNavProps>;
  * ];
  * ```
  */
-interface NavHorizontalItem {
-    /** Optional unique key for React rendering */
-    key?: string;
-    /** Display name shown in tooltip */
-    name: string;
-    /** Optional label text to display next to the icon */
-    label?: React__default.ReactNode;
-    /** Navigation URL (for anchor tag) */
-    href?: string;
-    /** Click handler (for button behavior) */
-    onClick?: () => void;
-    /** Additional CSS classes for the item wrapper */
-    className?: string;
-    /** CSS classes applied when item is active */
-    activeClass?: string;
-    /** CSS classes for the icon */
-    iconClassName?: string;
-    /** Stroke width for the icon (default: 2) */
-    iconStroke?: number;
-    /** Tooltip position (default: 'bottom') */
-    tooltipSide?: 'top' | 'right' | 'bottom' | 'left';
-    /** Show a separator line after this item */
-    showSeperator?: boolean;
-    /** Lucide icon component */
-    icon: React__default.ElementType | LucideIcon;
-    /** Custom tooltip content (overrides name) */
-    tooltip?: React__default.ReactNode;
-}
+type NavHorizontalItem = NavItemConfig;
 interface NavHorizontalItemsProps {
     items: NavHorizontalItem[];
 }
@@ -673,32 +694,7 @@ declare const NavHorizontal: React__default.FC<NavHorizontalProps>;
  * ];
  * ```
  */
-interface NavVerticalItem {
-    /** Optional unique key for React rendering */
-    key?: string;
-    /** Display name shown in tooltip */
-    name: string;
-    /** Navigation URL (for anchor tag) */
-    href?: string;
-    /** Click handler (for button behavior) */
-    onClick?: () => void;
-    /** Additional CSS classes for the item wrapper */
-    className?: string;
-    /** CSS classes applied when item is active */
-    activeClass?: string;
-    /** CSS classes for the icon */
-    iconClassName?: string;
-    /** Stroke width for the icon (default: 2) */
-    iconStroke?: number;
-    /** Tooltip position (default: 'right') */
-    tooltipSide?: 'top' | 'right' | 'bottom' | 'left';
-    /** Show a separator line after this item */
-    showSeperator?: boolean;
-    /** Lucide icon component */
-    icon: React__default.ElementType | LucideIcon;
-    /** Custom tooltip content (overrides name) */
-    tooltip?: React__default.ReactNode;
-}
+type NavVerticalItem = NavItemConfig;
 interface NavVerticalItemsProps {
     items: NavVerticalItem[];
 }
@@ -775,6 +771,59 @@ interface PanelContentProps {
 }
 declare function PanelContent({ title, titleText, children, onClose, showClose, headerClassName, bodyClassName, footerContent, footerClassName, closeIcon }: PanelContentProps): react_jsx_runtime.JSX.Element;
 
+interface RichSelectOption {
+    /** Stable key used as the selection value. */
+    value: string;
+    /** Rich primary content — string or JSX. */
+    label: React$1.ReactNode;
+    /** Secondary line shown muted under the label. */
+    description?: React$1.ReactNode;
+    /** Lucide glyph or any component accepting `{ size }`. */
+    icon?: React$1.ElementType;
+    /** Trailing content (e.g. a count or status badge), pushed to the right. */
+    badge?: React$1.ReactNode;
+    disabled?: boolean;
+}
+interface RichSelectProps {
+    options: RichSelectOption[];
+    /** `string` in single mode, `string[]` in multi mode. */
+    value: string | string[];
+    /** Fired with the new selection — mirrors the mode of {@link value}. */
+    onChange: (value: string | string[]) => void;
+    /** Enable multi-select (checkboxes). Default `false` (radio). */
+    multiple?: boolean;
+    /** Menu heading and default trigger prefix. */
+    label?: string;
+    /** Trigger content when nothing is selected. */
+    placeholder?: React$1.ReactNode;
+    /** Full custom row JSX. Overrides the default row layout. */
+    renderOption?: (option: RichSelectOption, state: {
+        selected: boolean;
+    }) => React$1.ReactNode;
+    /** Full custom trigger JSX for the current selection. Overrides the default. */
+    renderValue?: (selected: RichSelectOption[]) => React$1.ReactNode;
+    /** Menu alignment relative to the trigger. Default `'start'`. */
+    align?: "start" | "center" | "end";
+    /** Trigger tooltip content; omit to disable the tooltip. */
+    tooltip?: React$1.ReactNode;
+    /** Side the trigger tooltip is placed on. Default `'top'`. */
+    tooltipSide?: "top" | "right" | "bottom" | "left";
+    disabled?: boolean;
+    /** Class merged onto the trigger Button. */
+    triggerClassName?: string;
+    /** Class merged onto the dropdown content. */
+    contentClassName?: string;
+    /** Alias of {@link triggerClassName} for ergonomics. */
+    className?: string;
+}
+/**
+ * A `<select>` replacement built on {@link DropdownMenu}. Each option carries
+ * rich content (`label`, `description`, `icon`, `badge`) and both the rows and
+ * the trigger are fully customizable via `renderOption` / `renderValue`.
+ * Supports single (radio) and multi (checkbox) selection via `multiple`.
+ */
+declare function RichSelect({ options, value, onChange, multiple, label, placeholder, renderOption, renderValue, align, tooltip, tooltipSide, disabled, triggerClassName, contentClassName, className, }: RichSelectProps): react_jsx_runtime.JSX.Element;
+
 interface TabConfig {
     /** Unique identifier for the tab */
     value: string;
@@ -1038,4 +1087,4 @@ declare const Typography: {
     Pre: React$1.ForwardRefExoticComponent<TypographyPreProps & React$1.RefAttributes<HTMLPreElement>>;
 };
 
-export { Accordion, AccordionContent, AccordionItem, AccordionTrigger, Alert, AlertDescription, AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogOverlay, AlertDialogPortal, AlertDialogTitle, AlertDialogTrigger, AlertTitle, Avatar, AvatarFallback, AvatarImage, Badge, type BadgeProps, type BaseNavProps, Breadcrumb, BreadcrumbEllipsis, BreadcrumbItem, BreadcrumbLink, BreadcrumbList, BreadcrumbPage, BreadcrumbSeparator, Button, ButtonGroup, ButtonGroupSeparator, ButtonGroupText, type ButtonProps, ButtonWithTooltip, type ButtonWithTooltipProps, Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, CardWithHeader, Carousel, type CarouselApi, CarouselContent, CarouselItem, CarouselNext, CarouselPrevious, Command, CommandDialog, CommandEmpty, CommandGroup, CommandInput, CommandItem, CommandList, CommandSeparator, CommandShortcut, Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, ErrorBoundary, HoverCard, HoverCardContent, HoverCardTrigger, Item, ItemActions, ItemContent, ItemDescription, ItemFooter, ItemGroup, ItemHeader, ItemMedia, ItemSeparator, ItemTitle, Kbd, KbdGroup, MenuItem, type MenuItemProps, Menubar, MenubarCheckboxItem, MenubarContent, MenubarGroup, MenubarItem, MenubarLabel, MenubarMenu, MenubarPortal, MenubarRadioGroup, MenubarRadioItem, MenubarSeparator, MenubarShortcut, MenubarSub, MenubarSubContent, MenubarSubTrigger, MenubarTrigger, NavBase, NavHorizontal, type NavHorizontalItem, NavHorizontalItems, type NavHorizontalItemsProps, type NavHorizontalProps, type NavSection, NavVertical, type NavVerticalItem, NavVerticalItems, type NavVerticalItemsProps, type NavVerticalProps, NavigationMenu, NavigationMenuContent, NavigationMenuIndicator, NavigationMenuItem, NavigationMenuLink, NavigationMenuList, NavigationMenuTrigger, NavigationMenuViewport, NestedMenu, type NestedMenuProps, Pagination, PaginationContent, PaginationEllipsis, PaginationItem, PaginationLink, PaginationNext, PaginationPrevious, PanelContent, type PanelContentProps, Popover, PopoverContent, PopoverTrigger, Progress, ResizableHandle, ResizablePanel, ResizablePanelGroup, ScrollArea, ScrollBar, SearchInput, Separator, Sheet, SheetClose, SheetContent, SheetDescription, SheetFooter, SheetHeader, SheetOverlay, SheetPortal, SheetTitle, SheetTrigger, Sidebar, SidebarContent, SidebarFooter, SidebarGroup, SidebarGroupAction, SidebarGroupContent, SidebarGroupLabel, SidebarHeader, SidebarInput, SidebarInset, SidebarMenu, SidebarMenuAction, SidebarMenuBadge, SidebarMenuButton, SidebarMenuItem, SidebarMenuSkeleton, SidebarMenuSub, SidebarMenuSubButton, SidebarMenuSubItem, SidebarProvider, SidebarRail, SidebarSeparator, SidebarTrigger, Skeleton, Spinner, type TabConfig, TabbedPanel, type TabbedPanelProps, Table, TableBody, TableCaption, TableCell, TableFooter, TableHead, TableHeader, TableRow, Tabs, TabsContent, TabsList, TabsTrigger, Toaster, Toggle, ToggleGroup, ToggleGroupItem, Toolbar, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, Tour, type TourController, type TourProps, type TourReference, type TourStep, TreeItem, TreeView, type TreeViewProps, Typography, TypographyBlockquote, type TypographyBlockquoteProps, TypographyH1, type TypographyH1Props, TypographyH2, type TypographyH2Props, TypographyH3, type TypographyH3Props, TypographyH4, type TypographyH4Props, TypographyH5, type TypographyH5Props, TypographyH6, type TypographyH6Props, TypographyInlineCode, type TypographyInlineCodeProps, TypographyLarge, type TypographyLargeProps, TypographyLead, type TypographyLeadProps, TypographyList, type TypographyListProps, TypographyMuted, type TypographyMutedProps, TypographyP, type TypographyPProps, TypographyPre, type TypographyPreProps, TypographySmall, type TypographySmallProps, UnderDevelopment, type UnderDevelopmentProps, type UseTourOptions, badgeVariants, buttonGroupVariants, buttonVariants, cn, navigationMenuTriggerStyle, toggleVariants, useSidebar, useTour };
+export { Accordion, AccordionContent, AccordionItem, AccordionTrigger, Alert, AlertDescription, AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogOverlay, AlertDialogPortal, AlertDialogTitle, AlertDialogTrigger, AlertTitle, Avatar, AvatarFallback, AvatarImage, Badge, type BadgeProps, type BaseNavProps, Breadcrumb, BreadcrumbEllipsis, BreadcrumbItem, BreadcrumbLink, BreadcrumbList, BreadcrumbPage, BreadcrumbSeparator, Button, ButtonGroup, ButtonGroupSeparator, ButtonGroupText, type ButtonProps, ButtonWithTooltip, type ButtonWithTooltipProps, Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, CardWithHeader, Carousel, type CarouselApi, CarouselContent, CarouselItem, CarouselNext, CarouselPrevious, Command, CommandDialog, CommandEmpty, CommandGroup, CommandInput, CommandItem, CommandList, CommandSeparator, CommandShortcut, Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, ErrorBoundary, HoverCard, HoverCardContent, HoverCardTrigger, Item, ItemActions, ItemContent, ItemDescription, ItemFooter, ItemGroup, ItemHeader, ItemMedia, ItemSeparator, ItemTitle, Kbd, KbdGroup, MenuItem, type MenuItemProps, Menubar, MenubarCheckboxItem, MenubarContent, MenubarGroup, MenubarItem, MenubarLabel, MenubarMenu, MenubarPortal, MenubarRadioGroup, MenubarRadioItem, MenubarSeparator, MenubarShortcut, MenubarSub, MenubarSubContent, MenubarSubTrigger, MenubarTrigger, NavBase, NavHorizontal, type NavHorizontalItem, NavHorizontalItems, type NavHorizontalItemsProps, type NavHorizontalProps, type NavItemConfig, NavItems, type NavItemsProps, type NavSection, NavVertical, type NavVerticalItem, NavVerticalItems, type NavVerticalItemsProps, type NavVerticalProps, NavigationMenu, NavigationMenuContent, NavigationMenuIndicator, NavigationMenuItem, NavigationMenuLink, NavigationMenuList, NavigationMenuTrigger, NavigationMenuViewport, NestedMenu, type NestedMenuProps, Pagination, PaginationContent, PaginationEllipsis, PaginationItem, PaginationLink, PaginationNext, PaginationPrevious, PanelContent, type PanelContentProps, Popover, PopoverContent, PopoverTrigger, Progress, ResizableHandle, ResizablePanel, ResizablePanelGroup, RichSelect, type RichSelectOption, type RichSelectProps, ScrollArea, ScrollBar, SearchInput, Separator, Sheet, SheetClose, SheetContent, SheetDescription, SheetFooter, SheetHeader, SheetOverlay, SheetPortal, SheetTitle, SheetTrigger, Sidebar, SidebarContent, SidebarFooter, SidebarGroup, SidebarGroupAction, SidebarGroupContent, SidebarGroupLabel, SidebarHeader, SidebarInput, SidebarInset, SidebarMenu, SidebarMenuAction, SidebarMenuBadge, SidebarMenuButton, SidebarMenuItem, SidebarMenuSkeleton, SidebarMenuSub, SidebarMenuSubButton, SidebarMenuSubItem, SidebarProvider, SidebarRail, SidebarSeparator, SidebarTrigger, Skeleton, Spinner, type TabConfig, TabbedPanel, type TabbedPanelProps, Table, TableBody, TableCaption, TableCell, TableFooter, TableHead, TableHeader, TableRow, Tabs, TabsContent, TabsList, TabsTrigger, Toaster, Toggle, ToggleGroup, ToggleGroupItem, Toolbar, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, Tour, type TourController, type TourProps, type TourReference, type TourStep, TreeItem, TreeView, type TreeViewProps, Typography, TypographyBlockquote, type TypographyBlockquoteProps, TypographyH1, type TypographyH1Props, TypographyH2, type TypographyH2Props, TypographyH3, type TypographyH3Props, TypographyH4, type TypographyH4Props, TypographyH5, type TypographyH5Props, TypographyH6, type TypographyH6Props, TypographyInlineCode, type TypographyInlineCodeProps, TypographyLarge, type TypographyLargeProps, TypographyLead, type TypographyLeadProps, TypographyList, type TypographyListProps, TypographyMuted, type TypographyMutedProps, TypographyP, type TypographyPProps, TypographyPre, type TypographyPreProps, TypographySmall, type TypographySmallProps, UnderDevelopment, type UnderDevelopmentProps, type UseTourOptions, badgeVariants, buttonGroupVariants, buttonVariants, cn, navigationMenuTriggerStyle, toggleVariants, useSidebar, useTour };