@neynar/ui 0.1.1

package/dist/components/ui/dropdown-menu.d.ts

@@ -0,0 +1,349 @@
+import * as React from "react";
+import * as DropdownMenuPrimitive from "@radix-ui/react-dropdown-menu";
+/**
+ * A versatile dropdown menu component built on Radix UI primitives
+ *
+ * Dropdown menus display a list of actions or options that a user can choose from.
+ * They're typically triggered by a button and appear as a floating panel with full
+ * keyboard navigation support, submenus, and various interactive item types.
+ *
+ * Based on the shadcn/ui dropdown-menu component with additional enhancements for
+ * better integration with design systems and improved accessibility.
+ *
+ * @component
+ * @example
+ * ```tsx
+ * // Basic dropdown menu
+ * <DropdownMenu>
+ *   <DropdownMenuTrigger asChild>
+ *     <Button variant="outline">Options</Button>
+ *   </DropdownMenuTrigger>
+ *   <DropdownMenuContent>
+ *     <DropdownMenuItem>Profile</DropdownMenuItem>
+ *     <DropdownMenuItem>Settings</DropdownMenuItem>
+ *     <DropdownMenuSeparator />
+ *     <DropdownMenuItem>Logout</DropdownMenuItem>
+ *   </DropdownMenuContent>
+ * </DropdownMenu>
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Context menu with alignment and destructive actions
+ * <DropdownMenu>
+ *   <DropdownMenuTrigger asChild>
+ *     <Button variant="ghost" size="icon">
+ *       <MoreHorizontal />
+ *     </Button>
+ *   </DropdownMenuTrigger>
+ *   <DropdownMenuContent align="end">
+ *     <DropdownMenuItem>Edit</DropdownMenuItem>
+ *     <DropdownMenuItem>Duplicate</DropdownMenuItem>
+ *     <DropdownMenuSeparator />
+ *     <DropdownMenuItem variant="destructive">Delete</DropdownMenuItem>
+ *   </DropdownMenuContent>
+ * </DropdownMenu>
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Complex menu with checkboxes, radio groups, and submenus
+ * <DropdownMenu>
+ *   <DropdownMenuTrigger asChild>
+ *     <Button>Advanced Menu</Button>
+ *   </DropdownMenuTrigger>
+ *   <DropdownMenuContent className="w-56">
+ *     <DropdownMenuLabel>View Options</DropdownMenuLabel>
+ *     <DropdownMenuSeparator />
+ *     <DropdownMenuCheckboxItem checked={showPanel} onCheckedChange={setShowPanel}>
+ *       Show Panel
+ *     </DropdownMenuCheckboxItem>
+ *     <DropdownMenuSeparator />
+ *     <DropdownMenuRadioGroup value={position} onValueChange={setPosition}>
+ *       <DropdownMenuRadioItem value="top">Top</DropdownMenuRadioItem>
+ *       <DropdownMenuRadioItem value="bottom">Bottom</DropdownMenuRadioItem>
+ *     </DropdownMenuRadioGroup>
+ *     <DropdownMenuSeparator />
+ *     <DropdownMenuSub>
+ *       <DropdownMenuSubTrigger>Share</DropdownMenuSubTrigger>
+ *       <DropdownMenuSubContent>
+ *         <DropdownMenuItem>Email</DropdownMenuItem>
+ *         <DropdownMenuItem>Copy Link</DropdownMenuItem>
+ *       </DropdownMenuSubContent>
+ *     </DropdownMenuSub>
+ *   </DropdownMenuContent>
+ * </DropdownMenu>
+ * ```
+ *
+ * @accessibility
+ * - Full keyboard navigation with arrow keys (Up/Down for navigation)
+ * - Enter/Space to activate items
+ * - Escape key closes the menu and restores focus
+ * - Home/End keys navigate to first/last item
+ * - Type-ahead search to jump to items by first letter
+ * - Left/Right arrow keys for submenu navigation
+ * - Proper ARIA roles (menu, menuitem, menuitemcheckbox, menuitemradio)
+ * - Focus management with focus trapping and restoration
+ * - Screen reader announcements for state changes
+ *
+ * @see {@link ContextMenu} - For right-click context menus
+ * @see {@link Popover} - For rich content overlays
+ * @see {@link Select} - For single selection dropdowns
+ * @see {@link https://ui.shadcn.com/docs/components/dropdown-menu} - shadcn/ui documentation
+ * @since 1.0.0
+ */
+declare function DropdownMenu({ ...props }: React.ComponentProps<typeof DropdownMenuPrimitive.Root>): import("react/jsx-runtime").JSX.Element;
+/**
+ * Portal component for rendering menu content in a different DOM location
+ *
+ * Renders dropdown content outside of the normal DOM hierarchy to avoid
+ * z-index and overflow issues. Automatically used by DropdownMenuContent
+ * but can be used explicitly for submenus.
+ *
+ * @component
+ * @param container - Optional container element for portal rendering
+ * @since 1.0.0
+ */
+declare function DropdownMenuPortal({ ...props }: React.ComponentProps<typeof DropdownMenuPrimitive.Portal>): import("react/jsx-runtime").JSX.Element;
+/**
+ * DropdownMenuTrigger - The element that triggers the dropdown menu
+ *
+ * @component
+ * @example
+ * ```tsx
+ * <DropdownMenuTrigger asChild>
+ *   <Button>Menu</Button>
+ * </DropdownMenuTrigger>
+ * ```
+ * @since 1.0.0
+ */
+declare function DropdownMenuTrigger({ ...props }: React.ComponentProps<typeof DropdownMenuPrimitive.Trigger>): import("react/jsx-runtime").JSX.Element;
+/**
+ * DropdownMenuContent - The content container for dropdown menu items
+ *
+ * @component
+ * @example
+ * ```tsx
+ * <DropdownMenuContent align="end" sideOffset={5}>
+ *   <DropdownMenuItem>Item 1</DropdownMenuItem>
+ * </DropdownMenuContent>
+ * ```
+ * @since 1.0.0
+ */
+declare function DropdownMenuContent({ className, sideOffset, ...props }: React.ComponentProps<typeof DropdownMenuPrimitive.Content>): import("react/jsx-runtime").JSX.Element;
+/**
+ * Groups related dropdown menu items together
+ *
+ * Used to create logical groupings of menu items, typically separated by
+ * DropdownMenuSeparator components. Helps with semantic organization and
+ * keyboard navigation.
+ *
+ * @component
+ * @example
+ * ```tsx
+ * <DropdownMenuGroup>
+ *   <DropdownMenuItem>Profile</DropdownMenuItem>
+ *   <DropdownMenuItem>Settings</DropdownMenuItem>
+ * </DropdownMenuGroup>
+ * ```
+ * @since 1.0.0
+ */
+declare function DropdownMenuGroup({ ...props }: React.ComponentProps<typeof DropdownMenuPrimitive.Group>): import("react/jsx-runtime").JSX.Element;
+/**
+ * DropdownMenuItem - A single item in the dropdown menu
+ *
+ * @component
+ * @example
+ * ```tsx
+ * <DropdownMenuItem onClick={handleClick}>
+ *   Edit
+ * </DropdownMenuItem>
+ * <DropdownMenuItem variant="destructive">
+ *   Delete
+ * </DropdownMenuItem>
+ * ```
+ * @since 1.0.0
+ */
+declare function DropdownMenuItem({ className, inset, variant, ...props }: React.ComponentProps<typeof DropdownMenuPrimitive.Item> & {
+    inset?: boolean;
+    variant?: "default" | "destructive";
+}): import("react/jsx-runtime").JSX.Element;
+/**
+ * A checkable menu item with visual state indication
+ *
+ * Displays a checkbox that can be toggled on/off. The checked state is
+ * visually indicated with a checkmark icon. Useful for menu options that
+ * represent toggleable settings or features.
+ *
+ * @component
+ * @param checked - Whether the checkbox is checked
+ * @param onCheckedChange - Callback when the checked state changes
+ * @param disabled - Whether the item is disabled
+ *
+ * @example
+ * ```tsx
+ * const [showSidebar, setShowSidebar] = useState(true);
+ *
+ * <DropdownMenuCheckboxItem
+ *   checked={showSidebar}
+ *   onCheckedChange={setShowSidebar}
+ * >
+ *   Show Sidebar
+ * </DropdownMenuCheckboxItem>
+ * ```
+ * @since 1.0.0
+ */
+declare function DropdownMenuCheckboxItem({ className, children, checked, ...props }: React.ComponentProps<typeof DropdownMenuPrimitive.CheckboxItem>): import("react/jsx-runtime").JSX.Element;
+/**
+ * Groups radio items for single selection
+ *
+ * Creates a group where only one radio item can be selected at a time.
+ * Use with DropdownMenuRadioItem components to create single-choice options.
+ *
+ * @component
+ * @param value - Currently selected value
+ * @param onValueChange - Callback when selection changes
+ *
+ * @example
+ * ```tsx
+ * const [theme, setTheme] = useState("light");
+ *
+ * <DropdownMenuRadioGroup value={theme} onValueChange={setTheme}>
+ *   <DropdownMenuRadioItem value="light">Light</DropdownMenuRadioItem>
+ *   <DropdownMenuRadioItem value="dark">Dark</DropdownMenuRadioItem>
+ *   <DropdownMenuRadioItem value="system">System</DropdownMenuRadioItem>
+ * </DropdownMenuRadioGroup>
+ * ```
+ * @since 1.0.0
+ */
+declare function DropdownMenuRadioGroup({ ...props }: React.ComponentProps<typeof DropdownMenuPrimitive.RadioGroup>): import("react/jsx-runtime").JSX.Element;
+/**
+ * A radio button menu item for single selection within a group
+ *
+ * Must be used within a DropdownMenuRadioGroup. Shows a filled circle
+ * indicator when selected. Only one radio item can be selected per group.
+ *
+ * @component
+ * @param value - The value this radio item represents
+ * @param disabled - Whether the item is disabled
+ *
+ * @example
+ * ```tsx
+ * <DropdownMenuRadioGroup value={selectedTheme} onValueChange={setSelectedTheme}>
+ *   <DropdownMenuRadioItem value="light">
+ *     Light Theme
+ *   </DropdownMenuRadioItem>
+ *   <DropdownMenuRadioItem value="dark">
+ *     Dark Theme
+ *   </DropdownMenuRadioItem>
+ * </DropdownMenuRadioGroup>
+ * ```
+ * @since 1.0.0
+ */
+declare function DropdownMenuRadioItem({ className, children, ...props }: React.ComponentProps<typeof DropdownMenuPrimitive.RadioItem>): import("react/jsx-runtime").JSX.Element;
+/**
+ * DropdownMenuLabel - A label for grouping menu items
+ *
+ * @component
+ * @example
+ * ```tsx
+ * <DropdownMenuLabel>Actions</DropdownMenuLabel>
+ * ```
+ * @since 1.0.0
+ */
+declare function DropdownMenuLabel({ className, inset, ...props }: React.ComponentProps<typeof DropdownMenuPrimitive.Label> & {
+    inset?: boolean;
+}): import("react/jsx-runtime").JSX.Element;
+/**
+ * DropdownMenuSeparator - A visual separator between menu items
+ *
+ * @component
+ * @since 1.0.0
+ */
+declare function DropdownMenuSeparator({ className, ...props }: React.ComponentProps<typeof DropdownMenuPrimitive.Separator>): import("react/jsx-runtime").JSX.Element;
+/**
+ * Displays keyboard shortcut hints in menu items
+ *
+ * Shows keyboard shortcut text aligned to the right side of menu items.
+ * Purely visual - does not implement the actual keyboard functionality.
+ * Use standard keyboard shortcut notation (⌘, ⌃, ⌥, ⇧).
+ *
+ * @component
+ * @example
+ * ```tsx
+ * <DropdownMenuItem>
+ *   Save Document
+ *   <DropdownMenuShortcut>⌘S</DropdownMenuShortcut>
+ * </DropdownMenuItem>
+ * ```
+ * @since 1.0.0
+ */
+declare function DropdownMenuShortcut({ className, ...props }: React.ComponentProps<"span">): import("react/jsx-runtime").JSX.Element;
+/**
+ * Container for creating nested submenus
+ *
+ * Wraps a submenu trigger and content to create hierarchical menu structures.
+ * Use with DropdownMenuSubTrigger and DropdownMenuSubContent.
+ *
+ * @component
+ * @example
+ * ```tsx
+ * <DropdownMenuSub>
+ *   <DropdownMenuSubTrigger>Share</DropdownMenuSubTrigger>
+ *   <DropdownMenuSubContent>
+ *     <DropdownMenuItem>Email</DropdownMenuItem>
+ *     <DropdownMenuItem>Copy Link</DropdownMenuItem>
+ *   </DropdownMenuSubContent>
+ * </DropdownMenuSub>
+ * ```
+ * @since 1.0.0
+ */
+declare function DropdownMenuSub({ ...props }: React.ComponentProps<typeof DropdownMenuPrimitive.Sub>): import("react/jsx-runtime").JSX.Element;
+/**
+ * Trigger element for opening a submenu
+ *
+ * Displays an arrow indicator and opens the associated submenu on hover or click.
+ * Must be used within a DropdownMenuSub component.
+ *
+ * @component
+ * @param inset - Whether to add left padding to align with items that have icons
+ *
+ * @example
+ * ```tsx
+ * <DropdownMenuSub>
+ *   <DropdownMenuSubTrigger>
+ *     <Share className="mr-2 h-4 w-4" />
+ *     Share Options
+ *   </DropdownMenuSubTrigger>
+ *   <DropdownMenuSubContent>
+ *     <DropdownMenuItem>Email</DropdownMenuItem>
+ *     <DropdownMenuItem>Copy Link</DropdownMenuItem>
+ *   </DropdownMenuSubContent>
+ * </DropdownMenuSub>
+ * ```
+ * @since 1.0.0
+ */
+declare function DropdownMenuSubTrigger({ className, inset, children, ...props }: React.ComponentProps<typeof DropdownMenuPrimitive.SubTrigger> & {
+    inset?: boolean;
+}): import("react/jsx-runtime").JSX.Element;
+/**
+ * Content container for submenu items
+ *
+ * Contains the items displayed when a submenu is opened. Positioned relative
+ * to the trigger and supports the same item types as the main menu.
+ *
+ * @component
+ * @example
+ * ```tsx
+ * <DropdownMenuSubContent>
+ *   <DropdownMenuItem>Submenu Item 1</DropdownMenuItem>
+ *   <DropdownMenuItem>Submenu Item 2</DropdownMenuItem>
+ *   <DropdownMenuSeparator />
+ *   <DropdownMenuItem>Submenu Item 3</DropdownMenuItem>
+ * </DropdownMenuSubContent>
+ * ```
+ * @since 1.0.0
+ */
+declare function DropdownMenuSubContent({ className, ...props }: React.ComponentProps<typeof DropdownMenuPrimitive.SubContent>): import("react/jsx-runtime").JSX.Element;
+export { DropdownMenu, DropdownMenuPortal, DropdownMenuTrigger, DropdownMenuContent, DropdownMenuGroup, DropdownMenuLabel, DropdownMenuItem, DropdownMenuCheckboxItem, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubTrigger, DropdownMenuSubContent, };
+//# sourceMappingURL=dropdown-menu.d.ts.map

package/dist/components/ui/dropdown-menu.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dropdown-menu.d.ts","sourceRoot":"","sources":["../../../src/components/ui/dropdown-menu.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,qBAAqB,MAAM,+BAA+B,CAAC;AAKvE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2FG;AACH,iBAAS,YAAY,CAAC,EACpB,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,OAAO,qBAAqB,CAAC,IAAI,CAAC,2CAEzD;AAED;;;;;;;;;;GAUG;AACH,iBAAS,kBAAkB,CAAC,EAC1B,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,OAAO,qBAAqB,CAAC,MAAM,CAAC,2CAI3D;AAED;;;;;;;;;;;GAWG;AACH,iBAAS,mBAAmB,CAAC,EAC3B,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,OAAO,qBAAqB,CAAC,OAAO,CAAC,2CAO5D;AAED;;;;;;;;;;;GAWG;AACH,iBAAS,mBAAmB,CAAC,EAC3B,SAAS,EACT,UAAc,EACd,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,OAAO,qBAAqB,CAAC,OAAO,CAAC,2CAc5D;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,iBAAS,iBAAiB,CAAC,EACzB,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,OAAO,qBAAqB,CAAC,KAAK,CAAC,2CAI1D;AAED;;;;;;;;;;;;;;GAcG;AACH,iBAAS,gBAAgB,CAAC,EACxB,SAAS,EACT,KAAK,EACL,OAAmB,EACnB,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,OAAO,qBAAqB,CAAC,IAAI,CAAC,GAAG;IAC3D,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,SAAS,GAAG,aAAa,CAAC;CACrC,2CAaA;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,iBAAS,wBAAwB,CAAC,EAChC,SAAS,EACT,QAAQ,EACR,OAAO,EACP,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,OAAO,qBAAqB,CAAC,YAAY,CAAC,2CAmBjE;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,iBAAS,sBAAsB,CAAC,EAC9B,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,OAAO,qBAAqB,CAAC,UAAU,CAAC,2CAO/D;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,iBAAS,qBAAqB,CAAC,EAC7B,SAAS,EACT,QAAQ,EACR,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,OAAO,qBAAqB,CAAC,SAAS,CAAC,2CAkB9D;AAED;;;;;;;;;GASG;AACH,iBAAS,iBAAiB,CAAC,EACzB,SAAS,EACT,KAAK,EACL,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,OAAO,qBAAqB,CAAC,KAAK,CAAC,GAAG;IAC5D,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,2CAYA;AAED;;;;;GAKG;AACH,iBAAS,qBAAqB,CAAC,EAC7B,SAAS,EACT,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,OAAO,qBAAqB,CAAC,SAAS,CAAC,2CAQ9D;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,iBAAS,oBAAoB,CAAC,EAC5B,SAAS,EACT,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,MAAM,CAAC,2CAW9B;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,iBAAS,eAAe,CAAC,EACvB,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,OAAO,qBAAqB,CAAC,GAAG,CAAC,2CAExD;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,iBAAS,sBAAsB,CAAC,EAC9B,SAAS,EACT,KAAK,EACL,QAAQ,EACR,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,OAAO,qBAAqB,CAAC,UAAU,CAAC,GAAG;IACjE,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,2CAeA;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,iBAAS,sBAAsB,CAAC,EAC9B,SAAS,EACT,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,OAAO,qBAAqB,CAAC,UAAU,CAAC,2CAW/D;AAED,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,EACnB,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,wBAAwB,EACxB,sBAAsB,EACtB,qBAAqB,EACrB,qBAAqB,EACrB,oBAAoB,EACpB,eAAe,EACf,sBAAsB,EACtB,sBAAsB,GACvB,CAAC"}

package/dist/components/ui/empty-state.d.ts

@@ -0,0 +1,133 @@
+import * as React from "react";
+/**
+ * Props for the EmptyState component
+ *
+ * Extends standard HTML div attributes to support all native div functionality
+ * while providing specific props for empty state content and behavior.
+ *
+ * @type EmptyStateProps
+ * @extends {React.HTMLAttributes<HTMLDivElement>}
+ */
+export type EmptyStateProps = React.HTMLAttributes<HTMLDivElement> & {
+    /** Main title text displayed prominently in the empty state */
+    title: string;
+    /** Optional descriptive text providing additional context or guidance */
+    description?: string;
+    /** Optional icon, illustration, or React element displayed above the title */
+    icon?: React.ReactNode;
+    /** Optional action button configuration for primary user action */
+    action?: {
+        /** Text label for the action button */
+        label: string;
+        /** Click handler function executed when the action button is pressed */
+        onClick: () => void;
+    };
+};
+/**
+ * EmptyState component for displaying empty or no-data states
+ *
+ * A versatile component that provides a consistent way to show empty states when there's
+ * no content to display. Commonly used in lists, tables, search results, dashboards,
+ * or any area where data might be absent. Follows standard empty state UX patterns
+ * with support for icons, descriptions, and call-to-action buttons to guide users.
+ *
+ * @example
+ * ```tsx
+ * // Basic empty state with title and description
+ * <EmptyState
+ *   title="No results found"
+ *   description="Try adjusting your search or filters to find what you're looking for"
+ * />
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Empty state with icon and action button
+ * import { Search } from 'lucide-react';
+ *
+ * <EmptyState
+ *   icon={<Search className="w-12 h-12" />}
+ *   title="No search results"
+ *   description="We couldn't find anything matching your search criteria"
+ *   action={{
+ *     label: "Clear search",
+ *     onClick: () => handleClearSearch()
+ *   }}
+ * />
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Inbox empty state with contextual messaging
+ * import { Inbox } from 'lucide-react';
+ *
+ * <EmptyState
+ *   icon={<Inbox className="w-16 h-16" />}
+ *   title="Your inbox is empty"
+ *   description="When you receive new messages, they'll appear here"
+ *   action={{
+ *     label: "Compose message",
+ *     onClick: () => openComposer()
+ *   }}
+ * />
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Custom styled empty state for data visualization
+ * import { Database } from 'lucide-react';
+ *
+ * <EmptyState
+ *   className="min-h-[400px] bg-muted/30 rounded-lg"
+ *   icon={<Database className="w-14 h-14 opacity-50" />}
+ *   title="No data available"
+ *   description="Import data or connect a data source to get started"
+ *   action={{
+ *     label: "Import data",
+ *     onClick: () => showImportDialog()
+ *   }}
+ * />
+ * ```
+ *
+ * @param props - Component props extending HTMLDivElement attributes
+ * @param props.title - Main title text displayed prominently (required)
+ * @param props.description - Optional descriptive text providing context
+ * @param props.icon - Optional icon or React element displayed above title
+ * @param props.action - Optional action button configuration
+ * @param props.className - Additional CSS classes for styling
+ * @param ref - Forwarded ref to the container div element
+ *
+ * @remarks
+ * **Accessibility Features:**
+ * - Uses semantic HTML structure with proper heading hierarchy
+ * - Title rendered as h3 element for screen reader navigation
+ * - Action button follows Button component accessibility patterns
+ * - Supports keyboard navigation and focus management
+ * - Screen reader friendly text content structure
+ *
+ * **Design Guidelines:**
+ * - Icon should be 48-64px (w-12 h-12 to w-16 h-16) for optimal visual balance
+ * - Keep titles concise and action-oriented
+ * - Use descriptions to provide helpful context or next steps
+ * - Action buttons should have clear, specific labels
+ *
+ * @see {@link Button} for action button styling and behavior
+ * @since 1.0.0
+ */
+declare const EmptyState: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLDivElement> & {
+    /** Main title text displayed prominently in the empty state */
+    title: string;
+    /** Optional descriptive text providing additional context or guidance */
+    description?: string;
+    /** Optional icon, illustration, or React element displayed above the title */
+    icon?: React.ReactNode;
+    /** Optional action button configuration for primary user action */
+    action?: {
+        /** Text label for the action button */
+        label: string;
+        /** Click handler function executed when the action button is pressed */
+        onClick: () => void;
+    };
+} & React.RefAttributes<HTMLDivElement>>;
+export { EmptyState };
+//# sourceMappingURL=empty-state.d.ts.map

package/dist/components/ui/empty-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"empty-state.d.ts","sourceRoot":"","sources":["../../../src/components/ui/empty-state.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAI/B;;;;;;;;GAQG;AACH,MAAM,MAAM,eAAe,GAAG,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC,GAAG;IACnE,+DAA+D;IAC/D,KAAK,EAAE,MAAM,CAAC;IACd,yEAAyE;IACzE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,8EAA8E;IAC9E,IAAI,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACvB,mEAAmE;IACnE,MAAM,CAAC,EAAE;QACP,uCAAuC;QACvC,KAAK,EAAE,MAAM,CAAC;QACd,wEAAwE;QACxE,OAAO,EAAE,MAAM,IAAI,CAAC;KACrB,CAAC;CACH,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0FG;AACH,QAAA,MAAM,UAAU;IA1Gd,+DAA+D;WACxD,MAAM;IACb,yEAAyE;kBAC3D,MAAM;IACpB,8EAA8E;WACvE,KAAK,CAAC,SAAS;IACtB,mEAAmE;aAC1D;QACP,uCAAuC;QACvC,KAAK,EAAE,MAAM,CAAC;QACd,wEAAwE;QACxE,OAAO,EAAE,MAAM,IAAI,CAAC;KACrB;wCAkHF,CAAC;AAIF,OAAO,EAAE,UAAU,EAAE,CAAC"}

package/dist/components/ui/hover-card.d.ts

@@ -0,0 +1,109 @@
+import * as React from "react";
+import * as HoverCardPrimitive from "@radix-ui/react-hover-card";
+/**
+ * HoverCard component for previewing content available behind a link
+ *
+ * For sighted users to preview content available behind a link. Displays rich content
+ * when users hover over a trigger element. Ideal for showing previews, user profiles,
+ * repository information, or contextual details without requiring navigation.
+ *
+ * Built on Radix UI Hover Card primitive with custom styling and animations.
+ *
+ * @example
+ * ```tsx
+ * // Basic user profile hover card
+ * <HoverCard>
+ *   <HoverCardTrigger asChild>
+ *     <Button variant="link">@nextjs</Button>
+ *   </HoverCardTrigger>
+ *   <HoverCardContent className="w-80">
+ *     <div className="flex justify-between gap-4">
+ *       <Avatar>
+ *         <AvatarImage src="https://github.com/vercel.png" />
+ *         <AvatarFallback>VC</AvatarFallback>
+ *       </Avatar>
+ *       <div className="space-y-1">
+ *         <h4 className="text-sm font-semibold">@nextjs</h4>
+ *         <p className="text-sm">
+ *           The React Framework – created and maintained by @vercel.
+ *         </p>
+ *         <div className="text-muted-foreground text-xs">
+ *           Joined December 2021
+ *         </div>
+ *       </div>
+ *     </div>
+ *   </HoverCardContent>
+ * </HoverCard>
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // With custom positioning and delays
+ * <HoverCard openDelay={500} closeDelay={200}>
+ *   <HoverCardTrigger asChild>
+ *     <Button>Hover me</Button>
+ *   </HoverCardTrigger>
+ *   <HoverCardContent side="top" align="start">
+ *     Content appears above with custom alignment
+ *   </HoverCardContent>
+ * </HoverCard>
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Interactive content
+ * <HoverCard>
+ *   <HoverCardTrigger asChild>
+ *     <Button>Settings</Button>
+ *   </HoverCardTrigger>
+ *   <HoverCardContent>
+ *     <div className="space-y-2">
+ *       <h4 className="font-semibold">Quick Actions</h4>
+ *       <Button size="sm">Manage Team</Button>
+ *       <Button size="sm">View Reports</Button>
+ *     </div>
+ *   </HoverCardContent>
+ * </HoverCard>
+ * ```
+ *
+ * @accessibility
+ * **Important**: Hover cards are intended for sighted users only. The content will be
+ * inaccessible to keyboard users. Consider providing alternative access methods.
+ *
+ * - Opens on hover with configurable `openDelay`
+ * - Stays open when hovering over content
+ * - Closes with configurable `closeDelay`
+ * - Auto-positions to avoid viewport overflow
+ * - Supports focus-based interactions for some accessibility
+ *
+ * @see {@link https://ui.shadcn.com/docs/components/hover-card} shadcn/ui documentation
+ * @since 1.0.0
+ * @see {@link https://www.radix-ui.com/primitives/docs/components/hover-card} Radix UI Hover Card
+ */
+/**
+ * Root container for the hover card component
+ *
+ * @param openDelay - Delay in milliseconds before the hover card opens (default: 700)
+ * @param closeDelay - Delay in milliseconds before the hover card closes (default: 300)
+ * @param open - Controlled open state
+ * @param onOpenChange - Callback when open state changes
+ */
+declare function HoverCard({ ...props }: React.ComponentProps<typeof HoverCardPrimitive.Root>): import("react/jsx-runtime").JSX.Element;
+/**
+ * Trigger element that opens the hover card on hover
+ *
+ * @param asChild - When true, merges props with immediate child element
+ */
+declare function HoverCardTrigger({ ...props }: React.ComponentProps<typeof HoverCardPrimitive.Trigger>): import("react/jsx-runtime").JSX.Element;
+/**
+ * Content container with built-in styling and animations
+ *
+ * @param side - Side of the trigger to position content ("top" | "right" | "bottom" | "left")
+ * @param align - Alignment relative to trigger ("start" | "center" | "end")
+ * @param sideOffset - Distance in pixels from the trigger (default: 4)
+ * @param alignOffset - Offset in pixels from the alignment axis
+ * @param className - Additional CSS classes
+ */
+declare function HoverCardContent({ className, align, sideOffset, ...props }: React.ComponentProps<typeof HoverCardPrimitive.Content>): import("react/jsx-runtime").JSX.Element;
+export { HoverCard, HoverCardTrigger, HoverCardContent };
+//# sourceMappingURL=hover-card.d.ts.map

package/dist/components/ui/hover-card.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hover-card.d.ts","sourceRoot":"","sources":["../../../src/components/ui/hover-card.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,kBAAkB,MAAM,4BAA4B,CAAC;AAIjE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+EG;AACH;;;;;;;GAOG;AACH,iBAAS,SAAS,CAAC,EACjB,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,OAAO,kBAAkB,CAAC,IAAI,CAAC,2CAEtD;AAED;;;;GAIG;AACH,iBAAS,gBAAgB,CAAC,EACxB,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,OAAO,kBAAkB,CAAC,OAAO,CAAC,2CAIzD;AAED;;;;;;;;GAQG;AACH,iBAAS,gBAAgB,CAAC,EACxB,SAAS,EACT,KAAgB,EAChB,UAAc,EACd,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,OAAO,kBAAkB,CAAC,OAAO,CAAC,2CAezD;AAED,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,CAAC"}