@raydenui/ui 0.1.0 → 0.3.0

package/dist/index.d.cts

@@ -1,8 +1,24 @@
 import * as react from 'react';
-import { ButtonHTMLAttributes, ReactNode, InputHTMLAttributes, HTMLAttributes } from 'react';
+import { SVGAttributes, ButtonHTMLAttributes, ReactNode, InputHTMLAttributes, HTMLAttributes, TdHTMLAttributes, ThHTMLAttributes } from 'react';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ClassValue } from 'clsx';
 
+type IconVariant = "outline" | "solid";
+type IconName = "3d" | "AI-stars" | "AR" | "BTC" | "ETH" | "NFT" | "NFT-add" | "NFT-profile" | "NFT-remove" | "QR-code" | "VR-goggles" | "airplane" | "airpod" | "alarm-clock" | "align-center" | "align-justify" | "align-left" | "align-right" | "arrow-down" | "arrow-down-left" | "arrow-down-right" | "arrow-expand" | "arrow-left" | "arrow-right" | "arrow-shrink" | "arrow-up" | "arrow-up-left" | "arrow-up-right" | "arrow-up-split" | "at" | "backward" | "badge" | "bag" | "ball" | "bank" | "bar-chart-h" | "bar-chart-v" | "battery" | "battery-charging" | "battery-empty" | "bed" | "beizer-curve" | "bell" | "bell-slash" | "bicycle" | "bin" | "bluetooth" | "bold" | "book" | "book-open" | "bookmark" | "bookmark-add" | "bookmarks" | "books" | "bot" | "box" | "box-1" | "branch" | "brush" | "bug" | "building-1" | "building-2" | "building-3" | "building-4" | "building-5" | "building-6" | "bulb" | "bulb-slash" | "bus" | "calendar" | "calendar-add" | "calendar-alt" | "calendar-cross" | "calendar-remove" | "calendar-tick" | "call" | "call-add" | "call-cross" | "call-incoming" | "call-outgoing" | "call-remove" | "call-ringing" | "camera" | "camera-slash" | "candles-h" | "candles-v" | "car" | "card" | "card-add" | "card-cross" | "card-fund" | "card-in" | "card-out" | "card-remove" | "card-tick" | "card-withdraw" | "cart" | "cart-add" | "cart-check" | "cart-cross" | "cart-minus" | "chart" | "chart-down" | "chart-up" | "chat" | "chat-alt" | "chats" | "check" | "check-circle" | "checkbox" | "checkbox-checked" | "chevron-down" | "chevron-h" | "chevron-left" | "chevron-right" | "chevron-up" | "chevron-v" | "clipboard" | "clock" | "cloud" | "cloud-1" | "cloud-download" | "cloud-info" | "cloud-lightning" | "cloud-rain" | "cloud-slash" | "cloud-snowy" | "cloud-upload" | "clouds" | "code" | "code-2" | "coin-stack" | "coin-swap" | "coins" | "coins-alt" | "color-picker" | "column" | "compass" | "conical-flask" | "copy" | "corner" | "corner-down-left" | "corner-down-right" | "corner-left-down" | "corner-left-up" | "corner-right-down" | "corner-right-up" | "corner-up-left" | "corner-up-right" | "crop" | "cup" | "cursor" | "data" | "devices" | "dislike" | "division" | "dollar" | "dots-h" | "dots-h-circle" | "dots-v" | "dots-v-circle" | "download" | "elements" | "emoji" | "emoji-add" | "euro" | "expand" | "eye" | "eye-slash" | "face-id" | "feather" | "feather-AI" | "feather-add" | "file" | "file-alt" | "file-cloud" | "file-code" | "file-download" | "file-upload" | "filter" | "filter-alt" | "fingerprint" | "first-aid" | "flag" | "flower" | "folder" | "folder-add" | "folder-cloud" | "folder-cross" | "folder-download" | "folder-lock" | "folder-move" | "folder-shield" | "folder-upload" | "folder-user" | "fork" | "forward" | "game-pad" | "gear-AI" | "gem" | "gift" | "globe" | "globe-alt" | "gps" | "graduating cap" | "grid" | "grid-2" | "hashtag" | "heading" | "headphones" | "headset" | "health-plus" | "heart" | "heart-beat" | "heart-beat-wave" | "history" | "home" | "home-alt" | "image" | "image-add" | "image-check" | "image-circle" | "image-cross" | "image-remove" | "info-circle" | "info-hexagon" | "info-triangle" | "italics" | "key" | "keyboard" | "lamp" | "laptop" | "layer" | "lifebuoy" | "lightning" | "lightning-off" | "like" | "line-height" | "link" | "link-detach" | "list" | "list-add" | "lock" | "lock-open" | "loudspeaker" | "magic-wand" | "mail" | "mail-add" | "mail-check" | "mail-cross" | "mail-remove" | "map" | "map-alt" | "map-marker" | "media" | "merge" | "message" | "message-alt" | "messages" | "microphone" | "microphone-slash" | "minus" | "minus-circle" | "mobile" | "money" | "money-1" | "money-2" | "moon" | "moon-cloud" | "moon-stars" | "mouse" | "move" | "multiply" | "multiply-circle" | "music" | "music-AI" | "music-note" | "naira" | "navigation" | "navigation-alt" | "newspaper" | "next" | "paint-brush" | "paint-bucket" | "palette" | "paper-clip" | "paragraph-spacing" | "pause" | "pc" | "pc-lock" | "pc-speaker" | "pc-user" | "pencil" | "pencil-edit" | "pie-chart" | "pin" | "pin-alt" | "plant" | "plant-2" | "play" | "playlist" | "plus" | "plus-circle" | "pounds" | "power" | "previous" | "printer" | "processor" | "pull-request" | "question-circle" | "quote" | "radio-button" | "radio-selected" | "receipt" | "redo" | "refresh" | "repeat" | "repeat-once" | "road-sign" | "rocket" | "rocket-alt" | "rotate-left" | "rotate-right" | "route" | "row" | "save" | "scan" | "scissor" | "screenshot" | "search" | "send" | "send-AI" | "send-alt" | "server" | "server-alt" | "settings" | "settings-1" | "settings-2" | "share" | "share-alt" | "shield" | "shield-cross" | "shield-tick" | "ship" | "shower" | "shrink" | "shrink-alt" | "shuffle" | "sign-in" | "sign-out" | "signal" | "signal-off" | "sim" | "snooze" | "snowflake" | "sofa" | "speaker" | "star" | "stars" | "stop" | "stopwatch" | "store" | "strikethrough" | "subscript" | "suitcase" | "sun" | "sun-cloud" | "superscript" | "support" | "switch-diagonal" | "switch-horizontal" | "switch-vertical" | "tablet" | "target" | "taxi" | "terminal" | "text" | "thermometer" | "ticket" | "tissue" | "train" | "trophy" | "truck" | "tv" | "underline" | "undo" | "upload" | "user" | "user-add" | "user-circle" | "user-cross" | "user-group" | "user-heart" | "user-remove" | "user-tick" | "users" | "verified" | "video" | "video-slash" | "voice-note" | "volume" | "volume-low" | "volume-mute" | "volume-slash" | "wallet" | "wallet-add" | "wallet-check" | "wallet-cross" | "wallet-fund" | "wallet-remove" | "wallet-withdraw" | "water-drop" | "wifi" | "wristwatch" | "yen" | "zoom-in" | "zoom-out";
+
+type IconSize = "xs" | "sm" | "md" | "lg" | "xl";
+interface IconProps extends Omit<SVGAttributes<SVGSVGElement>, "children"> {
+    /** Icon name from the registry. */
+    name: IconName;
+    /** Preset size or pixel value. @default "md" */
+    size?: IconSize | number;
+    /** SVG color — applied via CSS `color`. @default "currentColor" */
+    color?: string;
+    /** Outline (stroke) or solid (filled) variant. @default "outline" */
+    variant?: IconVariant;
+}
+declare const Icon: react.ForwardRefExoticComponent<IconProps & react.RefAttributes<SVGSVGElement>>;
+
 type ButtonVariant = "primary" | "secondary" | "grey" | "destructive" | "text" | "success" | "warning" | "info";
 type ButtonAppearance = "solid" | "outlined";
 type ButtonSize = "sm" | "lg";
@@ -10,7 +26,7 @@ interface ButtonProps extends ButtonHTMLAttributes<HTMLButtonElement> {
     variant?: ButtonVariant;
     appearance?: ButtonAppearance;
     size?: ButtonSize;
-    icon?: ReactNode;
+    icon?: ReactNode | IconName;
     iconPosition?: "none" | "leading" | "trailing" | "icon-only";
 }
 declare const Button: react.ForwardRefExoticComponent<ButtonProps & react.RefAttributes<HTMLButtonElement>>;
@@ -22,8 +38,8 @@ interface ButtonGroupProps {
 declare function ButtonGroup({ children, className }: ButtonGroupProps): react_jsx_runtime.JSX.Element;
 
 interface ButtonGroupItemProps extends ButtonHTMLAttributes<HTMLButtonElement> {
-    leadingIcon?: ReactNode;
-    trailingIcon?: ReactNode;
+    leadingIcon?: ReactNode | IconName;
+    trailingIcon?: ReactNode | IconName;
     active?: boolean;
 }
 declare const ButtonGroupItem: react.ForwardRefExoticComponent<ButtonGroupItemProps & react.RefAttributes<HTMLButtonElement>>;
@@ -41,9 +57,9 @@ interface InputProps extends Omit<InputHTMLAttributes<HTMLInputElement>, "size">
     /** Success message or boolean. Overrides helperText styling. */
     success?: string | boolean;
     /** Icon on the left side of the input */
-    leadingIcon?: ReactNode;
+    leadingIcon?: ReactNode | IconName;
     /** Icon on the right side of the input */
-    trailingIcon?: ReactNode;
+    trailingIcon?: ReactNode | IconName;
     /** Text addon on the right side */
     addonRight?: string;
     /** Wrapper className */
@@ -64,7 +80,7 @@ declare function Tabs({ variant, value, defaultValue, onValueChange, children, c
 
 interface TabProps {
     value: string;
-    icon?: ReactNode;
+    icon?: ReactNode | IconName;
     badge?: number | string;
     disabled?: boolean;
     children: ReactNode;
@@ -74,7 +90,7 @@ declare function Tab({ value, icon, badge, disabled, children, className, }: Tab
 
 interface ChipProps extends HTMLAttributes<HTMLDivElement> {
     variant?: "input" | "filter";
-    icon?: ReactNode;
+    icon?: ReactNode | IconName;
     disabled?: boolean;
     onClose?: () => void;
     onDropdown?: () => void;
@@ -106,8 +122,8 @@ interface BadgeProps extends HTMLAttributes<HTMLSpanElement> {
     color?: BadgeColor;
     type?: BadgeType;
     size?: BadgeSize;
-    leadingIcon?: ReactNode;
-    trailingIcon?: ReactNode;
+    leadingIcon?: ReactNode | IconName;
+    trailingIcon?: ReactNode | IconName;
 }
 declare function Badge({ color, type, size, leadingIcon, trailingIcon, className, children, ...rest }: BadgeProps): react_jsx_runtime.JSX.Element;
 
@@ -122,7 +138,7 @@ interface AlertProps extends HTMLAttributes<HTMLDivElement> {
     state?: AlertState;
     title?: string;
     description?: string;
-    icon?: ReactNode;
+    icon?: ReactNode | IconName;
     showIcon?: boolean;
     onClose?: () => void;
     primaryAction?: AlertAction;
@@ -134,9 +150,9 @@ type DividerVariant = "default" | "with-icon" | "with-label" | "with-title" | "w
 interface DividerProps extends HTMLAttributes<HTMLDivElement> {
     variant?: DividerVariant;
     label?: string;
-    icon?: ReactNode;
+    icon?: ReactNode | IconName;
     buttonLabel?: string;
-    buttonIcon?: ReactNode;
+    buttonIcon?: ReactNode | IconName;
     onButtonClick?: () => void;
 }
 declare function Divider({ variant, label, icon, buttonLabel, buttonIcon, onButtonClick, className, ...rest }: DividerProps): react_jsx_runtime.JSX.Element;
@@ -191,7 +207,7 @@ declare const Toggle: react.ForwardRefExoticComponent<ToggleProps & react.RefAtt
 interface BreadcrumbItem {
     label: string;
     href?: string;
-    icon?: ReactNode;
+    icon?: ReactNode | IconName;
     disabled?: boolean;
     active?: boolean;
 }
@@ -201,6 +217,336 @@ interface BreadcrumbProps extends HTMLAttributes<HTMLElement> {
 }
 declare function Breadcrumb({ items, separator, className, ...rest }: BreadcrumbProps): react_jsx_runtime.JSX.Element;
 
+type AvatarType = "image" | "icon" | "initials";
+type AvatarSize = "xs" | "sm" | "md" | "lg" | "xl" | "2xl";
+type AvatarStatus = "none" | "online" | "offline" | "verified";
+interface AvatarProps extends HTMLAttributes<HTMLDivElement> {
+    /** Visual type of the avatar. @default "image" */
+    type?: AvatarType;
+    /** Size preset. @default "md" */
+    size?: AvatarSize;
+    /** Status indicator shown at bottom-right. @default "none" */
+    status?: AvatarStatus;
+    /** Image URL (for type="image"). */
+    src?: string;
+    /** Alt text (for type="image"). */
+    alt?: string;
+    /** Initials text (for type="initials"). */
+    initials?: string;
+    /** Custom icon (for type="icon"). Accepts ReactNode or IconName. @default "user" */
+    icon?: ReactNode | IconName;
+}
+declare const Avatar: react.ForwardRefExoticComponent<AvatarProps & react.RefAttributes<HTMLDivElement>>;
+type AvatarGroupSize = "sm" | "md" | "lg";
+interface AvatarGroupProps extends HTMLAttributes<HTMLDivElement> {
+    /** Controls the size of avatars in the group. @default "md" */
+    size?: AvatarGroupSize;
+    /** Maximum visible avatars. Overflow shows a "+N" counter. */
+    max?: number;
+}
+declare const AvatarGroup: react.ForwardRefExoticComponent<AvatarGroupProps & react.RefAttributes<HTMLDivElement>>;
+
+type MetricsCardVariation = "1" | "2" | "3" | "4" | "5" | "6";
+type MetricsCardTrend = "up" | "down";
+interface MetricsCardTrendBadge {
+    label: string;
+    trend?: MetricsCardTrend;
+}
+interface MetricsCardStatusBadge {
+    label: string;
+    variant?: "success" | "error" | "warning" | "info";
+}
+interface MetricsCardCta {
+    label: string;
+    onClick: () => void;
+    icon?: ReactNode | IconName;
+}
+interface MetricsCardProps extends HTMLAttributes<HTMLDivElement> {
+    /** Layout variation (1–6), each with a distinct layout */
+    variation?: MetricsCardVariation;
+    /** Metric label, e.g. "Total Solar Sales" */
+    label: string;
+    /** Main metric value, e.g. "$45,823" */
+    value: string | number;
+    /** Optional icon — renders in a bordered square (v2,3,6) or large tinted square (v4) */
+    icon?: ReactNode | IconName;
+    /** Trend badge with arrow icon, e.g. { label: "10%", trend: "up" } — used in v2–6 */
+    trendBadge?: MetricsCardTrendBadge;
+    /** Status badge, e.g. { label: "Paid", variant: "success" } — used in v1 */
+    statusBadge?: MetricsCardStatusBadge;
+    /** Description text, e.g. "Compared to last month" */
+    description?: string;
+    /** Secondary text shown on the right in v1, e.g. "Jun 12th, 2023" */
+    secondaryText?: string;
+    /** Call-to-action link */
+    cta?: MetricsCardCta;
+}
+declare function MetricsCard({ variation, className, ...props }: MetricsCardProps): react_jsx_runtime.JSX.Element;
+
+type FileUploadItemStatus = "pending" | "uploading" | "complete" | "error";
+interface FileUploadFileData {
+    id: string;
+    name: string;
+    size: number;
+    type: string;
+    progress?: number;
+    status: FileUploadItemStatus;
+    uploadedAt?: Date;
+    error?: string;
+}
+interface FileUploadItemProps extends HTMLAttributes<HTMLDivElement> {
+    file: FileUploadFileData;
+    onRemove?: (fileId: string) => void;
+    onRetry?: (fileId: string) => void;
+    onDownload?: (fileId: string) => void;
+}
+declare const FileUploadItem: react.ForwardRefExoticComponent<FileUploadItemProps & react.RefAttributes<HTMLDivElement>>;
+
+interface FileUploadProps extends HTMLAttributes<HTMLDivElement> {
+    /** Allow multiple file uploads */
+    multiple?: boolean;
+    /** MIME types to accept, e.g. "image/*,.pdf" */
+    accept?: string;
+    /** Maximum file size in bytes */
+    maxSize?: number;
+    /** Maximum number of files (for multiple mode) */
+    maxFiles?: number;
+    /** Header title, e.g. "Upload Documents" */
+    title?: string;
+    /** Description shown in the drop zone */
+    description?: string;
+    /** Controlled file list */
+    files: FileUploadFileData[];
+    /** Called when files list changes */
+    onFilesChange: (files: FileUploadFileData[]) => void;
+    /** Called when new files are selected for upload */
+    onUpload?: (file: File) => void;
+    /** Called when remove/delete is clicked */
+    onRemove?: (fileId: string) => void;
+    /** Called when retry is clicked */
+    onRetry?: (fileId: string) => void;
+    /** Called when download is clicked */
+    onDownload?: (fileId: string) => void;
+    /** Show the header with title and close button */
+    showHeader?: boolean;
+    /** Close handler for the header */
+    onClose?: () => void;
+}
+declare const FileUpload: react.ForwardRefExoticComponent<FileUploadProps & react.RefAttributes<HTMLDivElement>>;
+
+type DropZoneState = "default" | "dragging" | "uploading" | "success" | "error";
+interface FileUploadDropZoneProps extends HTMLAttributes<HTMLDivElement> {
+    /** Current visual state */
+    state?: DropZoneState;
+    /** Description text, e.g. "SVG, PNG, JPG or GIF (max 800x400px)" */
+    description?: string;
+    /** MIME types to accept */
+    accept?: string;
+    /** Allow multiple files */
+    multiple?: boolean;
+    /** File info for uploading state */
+    uploadingFile?: {
+        name: string;
+        type: string;
+        progress: number;
+    };
+    /** Error message for error state */
+    errorMessage?: string;
+    /** Called when files are dropped or selected */
+    onFilesSelected?: (files: FileList) => void;
+    /** Called on "Clear Upload" in success state */
+    onClear?: () => void;
+    /** Called on "Try Again" in error state */
+    onRetry?: () => void;
+}
+declare const FileUploadDropZone: react.ForwardRefExoticComponent<FileUploadDropZoneProps & react.RefAttributes<HTMLDivElement>>;
+
+type SidebarMenuTheme = "light" | "blue" | "dark-blue" | "dark-grey";
+interface SidebarMenuContextValue {
+    activeValue: string;
+    onSelect: (value: string) => void;
+    collapsed: boolean;
+    theme: SidebarMenuTheme;
+}
+interface SidebarMenuProps extends HTMLAttributes<HTMLElement> {
+    /** Controlled active item value */
+    value?: string;
+    /** Uncontrolled default active item */
+    defaultValue?: string;
+    /** Called when active item changes */
+    onValueChange?: (value: string) => void;
+    /** Collapsed icon-only mode (82 px wide) */
+    collapsed?: boolean;
+    /** Color theme */
+    theme?: SidebarMenuTheme;
+    children: ReactNode;
+}
+declare const SidebarMenu: react.ForwardRefExoticComponent<SidebarMenuProps & react.RefAttributes<HTMLElement>>;
+
+interface SidebarMenuSubProps {
+    children: ReactNode;
+}
+declare function SidebarMenuSub({ children }: SidebarMenuSubProps): react_jsx_runtime.JSX.Element;
+declare namespace SidebarMenuSub {
+    var displayName: string;
+}
+interface SidebarMenuSubItemProps extends ButtonHTMLAttributes<HTMLButtonElement> {
+    /** Unique identifier for this sub-item */
+    value: string;
+    children: ReactNode;
+}
+declare const SidebarMenuSubItem: react.ForwardRefExoticComponent<SidebarMenuSubItemProps & react.RefAttributes<HTMLButtonElement>>;
+interface SidebarMenuItemProps extends ButtonHTMLAttributes<HTMLButtonElement> {
+    /** Unique identifier for this item */
+    value: string;
+    /** Icon displayed to the left — accepts IconName string or ReactNode */
+    icon?: ReactNode | IconName;
+    /** Optional count badge displayed on the right */
+    badge?: string | number;
+    /** Disabled state */
+    disabled?: boolean;
+    children: ReactNode;
+}
+declare const SidebarMenuItem: react.ForwardRefExoticComponent<SidebarMenuItemProps & react.RefAttributes<HTMLButtonElement>>;
+
+interface SidebarMenuSectionProps extends HTMLAttributes<HTMLDivElement> {
+    /** Optional section title, e.g. "MAIN MENU" */
+    title?: string;
+    /** Whether to show a divider below the section */
+    showDivider?: boolean;
+    children: ReactNode;
+}
+declare const SidebarMenuSection: react.ForwardRefExoticComponent<SidebarMenuSectionProps & react.RefAttributes<HTMLDivElement>>;
+
+declare const illustrationNames: readonly ["calendar", "chat", "contacts", "dashboard", "favorites", "file-manager", "forms", "gallery", "inbox", "invoice", "notifications", "product-catalog", "project-list", "search", "shopping-cart", "subscriptions", "survey", "task-templates", "team"];
+type IllustrationName = (typeof illustrationNames)[number];
+
+interface EmptyStateIllustrationProps extends Omit<HTMLAttributes<HTMLDivElement>, "children"> {
+    /** Which illustration to display */
+    name: IllustrationName;
+    /** Show the colored or grey/monochrome variant (default: true) */
+    colored?: boolean;
+    /**
+     * Custom color palette for theming colored illustrations.
+     * Provide 11 hex colors (lightest → darkest) to replace the default
+     * primary orange palette. Ignored when `colored` is false.
+     */
+    palette?: string[];
+    /** Width/height in pixels (default: 150, the native SVG size) */
+    size?: number;
+}
+declare const EmptyStateIllustration: react.ForwardRefExoticComponent<EmptyStateIllustrationProps & react.RefAttributes<HTMLDivElement>>;
+
+interface TableProps extends HTMLAttributes<HTMLTableElement> {
+}
+declare const Table: react.ForwardRefExoticComponent<TableProps & react.RefAttributes<HTMLTableElement>>;
+interface TableHeaderProps extends HTMLAttributes<HTMLTableSectionElement> {
+}
+declare const TableHeader: react.ForwardRefExoticComponent<TableHeaderProps & react.RefAttributes<HTMLTableSectionElement>>;
+interface TableBodyProps extends HTMLAttributes<HTMLTableSectionElement> {
+}
+declare const TableBody: react.ForwardRefExoticComponent<TableBodyProps & react.RefAttributes<HTMLTableSectionElement>>;
+interface TableRowProps extends HTMLAttributes<HTMLTableRowElement> {
+    /** Whether this row is selected */
+    selected?: boolean;
+}
+declare const TableRow: react.ForwardRefExoticComponent<TableRowProps & react.RefAttributes<HTMLTableRowElement>>;
+type SortDirection = "asc" | "desc" | null;
+interface TableHeadProps extends ThHTMLAttributes<HTMLTableCellElement> {
+    /** Enable sort indicator and click-to-sort behavior */
+    sortable?: boolean;
+    /** Current sort direction for this column */
+    sortDirection?: SortDirection;
+    /** Called when the sort indicator is clicked */
+    onSort?: () => void;
+}
+declare const TableHead: react.ForwardRefExoticComponent<TableHeadProps & react.RefAttributes<HTMLTableCellElement>>;
+interface TableCellProps extends TdHTMLAttributes<HTMLTableCellElement> {
+}
+declare const TableCell: react.ForwardRefExoticComponent<TableCellProps & react.RefAttributes<HTMLTableCellElement>>;
+
+interface DropdownMenuProps extends HTMLAttributes<HTMLDivElement> {
+    /** Controlled open state */
+    open?: boolean;
+    /** Uncontrolled default open state */
+    defaultOpen?: boolean;
+    /** Called when open state changes */
+    onOpenChange?: (open: boolean) => void;
+    children: ReactNode;
+}
+declare const DropdownMenu: react.ForwardRefExoticComponent<DropdownMenuProps & react.RefAttributes<HTMLDivElement>>;
+interface DropdownMenuTriggerProps extends ButtonHTMLAttributes<HTMLButtonElement> {
+}
+declare const DropdownMenuTrigger: react.ForwardRefExoticComponent<DropdownMenuTriggerProps & react.RefAttributes<HTMLButtonElement>>;
+interface DropdownMenuContentProps extends HTMLAttributes<HTMLDivElement> {
+    /** Alignment relative to trigger */
+    align?: "start" | "end";
+    /** Gap from trigger in px */
+    sideOffset?: number;
+}
+declare const DropdownMenuContent: react.ForwardRefExoticComponent<DropdownMenuContentProps & react.RefAttributes<HTMLDivElement>>;
+interface DropdownMenuGroupProps extends HTMLAttributes<HTMLDivElement> {
+}
+declare const DropdownMenuGroup: react.ForwardRefExoticComponent<DropdownMenuGroupProps & react.RefAttributes<HTMLDivElement>>;
+interface DropdownMenuLabelProps extends HTMLAttributes<HTMLDivElement> {
+    /** Optional description below the title */
+    description?: string;
+}
+declare const DropdownMenuLabel: react.ForwardRefExoticComponent<DropdownMenuLabelProps & react.RefAttributes<HTMLDivElement>>;
+interface DropdownMenuItemProps extends Omit<ButtonHTMLAttributes<HTMLButtonElement>, "onSelect"> {
+    /** Leading icon — accepts a ReactNode or an IconName string */
+    icon?: ReactNode | IconName;
+    /** Keyboard shortcut label (e.g. "⌘C") */
+    shortcut?: string;
+    /** Whether this item is selected (shows check indicator) */
+    selected?: boolean;
+    /** Whether this item is disabled */
+    disabled?: boolean;
+    /** Called when the item is selected (click or Enter/Space) */
+    onSelect?: () => void;
+}
+declare const DropdownMenuItem: react.ForwardRefExoticComponent<DropdownMenuItemProps & react.RefAttributes<HTMLButtonElement>>;
+interface DropdownMenuSeparatorProps extends HTMLAttributes<HTMLDivElement> {
+}
+declare const DropdownMenuSeparator: react.ForwardRefExoticComponent<DropdownMenuSeparatorProps & react.RefAttributes<HTMLDivElement>>;
+
+interface SelectProps extends Omit<HTMLAttributes<HTMLDivElement>, "defaultValue"> {
+    /** Controlled value */
+    value?: string;
+    /** Uncontrolled default value */
+    defaultValue?: string;
+    /** Called when value changes */
+    onValueChange?: (value: string) => void;
+    /** Placeholder text when no value is selected */
+    placeholder?: string;
+    /** Label text above the select */
+    label?: string;
+    /** Helper text below the select */
+    helperText?: string;
+    /** Whether the select is disabled */
+    disabled?: boolean;
+    /** Wrapper className for the outermost div */
+    wrapperClassName?: string;
+    children: ReactNode;
+}
+declare const Select: react.ForwardRefExoticComponent<SelectProps & react.RefAttributes<HTMLDivElement>>;
+
+interface SelectOptionProps extends Omit<ButtonHTMLAttributes<HTMLButtonElement>, "value"> {
+    /** Unique value for this option */
+    value: string;
+    /** Leading icon — accepts a ReactNode or IconName string */
+    icon?: ReactNode | IconName;
+    /** Leading avatar element (e.g., <Avatar />) */
+    avatar?: ReactNode;
+    /** Status dot color (CSS color string, e.g., "#04802E") */
+    statusColor?: string;
+    /** Supporting text shown after the label */
+    description?: string;
+    /** Whether this option is disabled */
+    disabled?: boolean;
+}
+declare const SelectOption: react.ForwardRefExoticComponent<SelectOptionProps & react.RefAttributes<HTMLButtonElement>>;
+
 declare function cn(...inputs: ClassValue[]): string;
 
-export { Alert, type AlertAction, type AlertProps, type AlertState, type AlertVariant, Badge, type BadgeColor, type BadgeProps, type BadgeSize, type BadgeType, Breadcrumb, type BreadcrumbItem, type BreadcrumbProps, Button, type ButtonAppearance, ButtonGroup, ButtonGroupItem, type ButtonGroupItemProps, type ButtonGroupProps, type ButtonProps, type ButtonSize, type ButtonVariant, Checkbox, type CheckboxProps, Chip, type ChipProps, Divider, type DividerProps, type DividerVariant, Input, type InputProps, type InputSize, Pagination, type PaginationProps, ProgressBar, type ProgressBarProps, type ProgressBarSize, ProgressCircle, type ProgressCircleProps, type ProgressCircleSize, Radio, type RadioProps, Tab, type TabProps, Tabs, type TabsProps, type TabsVariant, Toggle, type ToggleProps, Tooltip, type TooltipAction, type TooltipPosition, type TooltipProps, type TooltipTheme, cn };
+export { Alert, type AlertAction, type AlertProps, type AlertState, type AlertVariant, Avatar, AvatarGroup, type AvatarGroupProps, type AvatarGroupSize, type AvatarProps, type AvatarSize, type AvatarStatus, type AvatarType, Badge, type BadgeColor, type BadgeProps, type BadgeSize, type BadgeType, Breadcrumb, type BreadcrumbItem, type BreadcrumbProps, Button, type ButtonAppearance, ButtonGroup, ButtonGroupItem, type ButtonGroupItemProps, type ButtonGroupProps, type ButtonProps, type ButtonSize, type ButtonVariant, Checkbox, type CheckboxProps, Chip, type ChipProps, Divider, type DividerProps, type DividerVariant, type DropZoneState, DropdownMenu, DropdownMenuContent, type DropdownMenuContentProps, DropdownMenuGroup, type DropdownMenuGroupProps, DropdownMenuItem, type DropdownMenuItemProps, DropdownMenuLabel, type DropdownMenuLabelProps, type DropdownMenuProps, DropdownMenuSeparator, type DropdownMenuSeparatorProps, DropdownMenuTrigger, type DropdownMenuTriggerProps, EmptyStateIllustration, type EmptyStateIllustrationProps, FileUpload, FileUploadDropZone, type FileUploadDropZoneProps, type FileUploadFileData, FileUploadItem, type FileUploadItemProps, type FileUploadItemStatus, type FileUploadProps, Icon, type IconName, type IconProps, type IconSize, type IconVariant, type IllustrationName, Input, type InputProps, type InputSize, MetricsCard, type MetricsCardCta, type MetricsCardProps, type MetricsCardStatusBadge, type MetricsCardTrend, type MetricsCardTrendBadge, type MetricsCardVariation, Pagination, type PaginationProps, ProgressBar, type ProgressBarProps, type ProgressBarSize, ProgressCircle, type ProgressCircleProps, type ProgressCircleSize, Radio, type RadioProps, Select, SelectOption, type SelectOptionProps, type SelectProps, SidebarMenu, type SidebarMenuContextValue, SidebarMenuItem, type SidebarMenuItemProps, type SidebarMenuProps, SidebarMenuSection, type SidebarMenuSectionProps, SidebarMenuSub, SidebarMenuSubItem, type SidebarMenuSubItemProps, type SidebarMenuSubProps, type SidebarMenuTheme, type SortDirection, Tab, type TabProps, Table, TableBody, type TableBodyProps, TableCell, type TableCellProps, TableHead, type TableHeadProps, TableHeader, type TableHeaderProps, type TableProps, TableRow, type TableRowProps, Tabs, type TabsProps, type TabsVariant, Toggle, type ToggleProps, Tooltip, type TooltipAction, type TooltipPosition, type TooltipProps, type TooltipTheme, cn, illustrationNames };