@neynar/ui 0.1.1 → 0.1.2

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

@@ -1 +1 @@
-{"version":3,"file":"dropdown-menu.d.ts","sourceRoot":"","sources":["../../../src/components/ui/dropdown-menu.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"dropdown-menu.d.ts","sourceRoot":"","sources":["../../../src/components/ui/dropdown-menu.tsx"],"names":[],"mappings":"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"}

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

@@ -1,70 +1,56 @@
 import * as React from "react";
 /**
- * Props for the EmptyState component
+ * EmptyState - Displays empty or no-data states with consistent UX patterns
  *
- * Extends standard HTML div attributes to support all native div functionality
- * while providing specific props for empty state content and behavior.
+ * A comprehensive component for handling empty states across applications. Provides
+ * a standardized way to communicate when content is unavailable, data is missing,
+ * or initial setup is required. Built with accessibility-first principles and
+ * follows established empty state design patterns to guide users toward resolution.
  *
- * @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
+ * **Common Use Cases:**
+ * - Search results with no matches
+ * - Empty lists, tables, or dashboards
+ * - Inbox or notification centers with no items
+ * - Data visualization with no data
+ * - Onboarding states for new users
+ * - Error recovery scenarios
  *
- * 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.
+ * **Component Structure:**
+ * The component follows a top-down visual hierarchy: Icon → Title → Description → Action.
+ * All elements except the title are optional, allowing for flexible implementation
+ * across different contexts while maintaining visual consistency.
  *
  * @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"
- * />
+ * // Minimal empty state with just title
+ * <EmptyState title="No notifications" />
  * ```
  *
  * @example
  * ```tsx
- * // Empty state with icon and action button
+ * // Search results empty state
  * 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"
+ *   title="No results found"
+ *   description="Try adjusting your search terms or filters"
  *   action={{
- *     label: "Clear search",
- *     onClick: () => handleClearSearch()
+ *     label: "Clear filters",
+ *     onClick: () => resetFilters()
  *   }}
  * />
  * ```
  *
  * @example
  * ```tsx
- * // Inbox empty state with contextual messaging
- * import { Inbox } from 'lucide-react';
+ * // Inbox empty state with call-to-action
+ * import { Inbox, Plus } 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"
+ *   description="New messages and notifications will appear here"
  *   action={{
  *     label: "Compose message",
  *     onClick: () => openComposer()
@@ -74,60 +60,146 @@ export type EmptyStateProps = React.HTMLAttributes<HTMLDivElement> & {
  *
  * @example
  * ```tsx
- * // Custom styled empty state for data visualization
- * import { Database } from 'lucide-react';
+ * // Data dashboard empty state with custom styling
+ * import { BarChart3, TrendingUp } 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"
+ *   className="min-h-[400px] bg-gradient-to-br from-muted/20 to-muted/10 rounded-lg border border-dashed border-muted-foreground/20"
+ *   icon={<BarChart3 className="w-14 h-14 opacity-60" />}
+ *   title="No analytics data"
+ *   description="Connect your data source or import historical data to view insights"
  *   action={{
- *     label: "Import data",
- *     onClick: () => showImportDialog()
+ *     label: "Connect data source",
+ *     onClick: () => showDataSourceModal()
  *   }}
  * />
  * ```
  *
+ * @example
+ * ```tsx
+ * // File manager empty state
+ * import { FolderOpen, Upload } from 'lucide-react';
+ *
+ * <EmptyState
+ *   icon={<FolderOpen className="w-12 h-12" />}
+ *   title="This folder is empty"
+ *   description="Drag and drop files here or use the upload button"
+ *   action={{
+ *     label: "Upload files",
+ *     onClick: () => triggerFileUpload()
+ *   }}
+ * />
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Error recovery empty state
+ * import { AlertTriangle, RefreshCw } from 'lucide-react';
+ *
+ * <EmptyState
+ *   icon={<AlertTriangle className="w-12 h-12 text-destructive" />}
+ *   title="Failed to load data"
+ *   description="There was a problem loading your content. Please try again."
+ *   action={{
+ *     label: "Retry",
+ *     onClick: () => refetchData()
+ *   }}
+ * />
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Team members empty state with multiple actions
+ * import { Users, UserPlus, Mail } from 'lucide-react';
+ *
+ * function TeamEmptyState() {
+ *   return (
+ *     <div className="space-y-4">
+ *       <EmptyState
+ *         icon={<Users className="w-16 h-16" />}
+ *         title="No team members yet"
+ *         description="Invite colleagues to collaborate on projects"
+ *         action={{
+ *           label: "Invite members",
+ *           onClick: () => openInviteModal()
+ *         }}
+ *       />
+ *       <div className="flex justify-center gap-2">
+ *         <Button variant="outline" size="sm" onClick={() => importFromCsv()}>
+ *           <Mail className="w-4 h-4 mr-2" />
+ *           Import from CSV
+ *         </Button>
+ *       </div>
+ *     </div>
+ *   );
+ * }
+ * ```
+ *
  * @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
+ * @param props.title - Main heading text that describes the empty state
+ * @param props.description - Optional explanatory text or guidance for users
+ * @param props.icon - Optional visual element (icon, illustration, or custom React element)
+ * @param props.action - Optional primary action button configuration
+ * @param props.className - Additional CSS classes for custom styling
+ * @param props.children - Not used; component has fixed content structure
+ * @param ref - Forwarded ref to the root div element for DOM access
+ *
+ * @accessibility
+ * - **Semantic Structure**: Uses proper heading hierarchy with h3 for screen readers
+ * - **Keyboard Navigation**: Action button fully keyboard accessible with Tab/Enter/Space
+ * - **Screen Readers**: Title and description are properly associated and announced
+ * - **Focus Management**: Action button receives proper focus indicators (3px ring)
+ * - **Landmark Navigation**: No explicit landmark roles; inherits from container context
+ * - **Content Flow**: Logical reading order from icon → title → description → action
+ * - **Icon Accessibility**: Decorative icons don't interfere with screen readers
+ * - **Button Integration**: Inherits full Button component accessibility features
+ * - **High Contrast**: Text colors meet WCAG 2.1 AA contrast requirements
+ * - **Responsive Design**: Adapts to different viewport sizes maintaining readability
  *
  * @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
+ * **Visual Design:**
+ * - Default padding of py-12 px-4 provides generous whitespace
+ * - Centered alignment (flex-col items-center justify-center text-center)
+ * - Icon rendered with muted foreground color for subtle prominence
+ * - Title uses text-lg font-semibold with foreground color for prominence
+ * - Description limited to max-w-sm (24rem) for optimal readability
+ * - Action button positioned with mb-6 spacing from description
+ * - Responsive spacing adapts to content presence (conditional margins)
+ *
+ * **Performance Considerations:**
+ * - Lightweight component with minimal re-renders
+ * - Icon rendering optimized for various React element types
+ * - Button component lazy-loaded only when action is provided
+ * - No state management or effects, purely presentational
+ * - Supports React 18 concurrent features
+ *
+ * **Customization:**
+ * - All Tailwind utility classes can be overridden via className
+ * - Icon styling can be customized at the element level
+ * - Button inherits default variant but supports additional props via composition
+ * - Container div accepts all standard HTML attributes for event handling
+ * - Supports ref forwarding for programmatic DOM manipulation
+ *
+ * **Design System Integration:**
+ * - Uses design tokens (foreground, muted-foreground, etc.) for consistent theming
+ * - Follows spacing scale (mb-2, mb-4, mb-6, py-12, px-4)
+ * - Typography scale integration (text-lg for title, default for description)
+ * - Color system compatibility with light/dark mode switching
+ * - Button component integration maintains design system consistency
+ *
+ * @see {@link Button} for action button styling, variants, and accessibility
+ * @see {@link https://ui.patterns.build/empty-states} Empty state design patterns
+ * @see {@link https://www.nngroup.com/articles/empty-state-interface-design/} Nielsen Norman Group empty state guidelines
  * @since 1.0.0
  */
-declare const EmptyState: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLDivElement> & {
-    /** Main title text displayed prominently in the empty state */
+declare const EmptyState: React.ForwardRefExoticComponent<Omit<React.ClassAttributes<HTMLDivElement> & React.HTMLAttributes<HTMLDivElement> & {
     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>>;
+}, "ref"> & React.RefAttributes<HTMLDivElement>>;
 export { EmptyState };
 //# sourceMappingURL=empty-state.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"empty-state.d.ts","sourceRoot":"","sources":["../../../src/components/ui/empty-state.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AA6E/B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgMG;AACH,QAAA,MAAM,UAAU;WAGL,MAAM;kBACC,MAAM;WACb,KAAK,CAAC,SAAS;aACb;QACP,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,IAAI,CAAC;KACrB;gDAoBH,CAAC;AAIH,OAAO,EAAE,UAAU,EAAE,CAAC"}

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

@@ -1,13 +1,16 @@
 import * as React from "react";
 import * as HoverCardPrimitive from "@radix-ui/react-hover-card";
 /**
- * HoverCard component for previewing content available behind a link
+ * HoverCard - Preview content that appears on hover for rich contextual information
  *
- * 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.
+ * A floating card component that reveals rich content when users hover over a trigger element.
+ * Designed specifically for sighted users to preview content available behind links without
+ * requiring navigation. Built on Radix UI primitives with smooth animations and intelligent
+ * positioning to avoid viewport boundaries.
  *
- * Built on Radix UI Hover Card primitive with custom styling and animations.
+ * Perfect for user profiles, repository information, link previews, tooltips with complex
+ * content, and any contextual details that enhance the user experience without interrupting
+ * their current workflow.
  *
  * @example
  * ```tsx
@@ -51,58 +54,274 @@ import * as HoverCardPrimitive from "@radix-ui/react-hover-card";
  *
  * @example
  * ```tsx
- * // Interactive content
+ * // Interactive hover card with buttons
  * <HoverCard>
  *   <HoverCardTrigger asChild>
- *     <Button>Settings</Button>
+ *     <Button variant="ghost">Quick Actions</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>
+ *       <h4 className="font-semibold">Available Actions</h4>
+ *       <div className="flex flex-col gap-1">
+ *         <Button size="sm" variant="ghost">Edit Profile</Button>
+ *         <Button size="sm" variant="ghost">View Analytics</Button>
+ *         <Button size="sm" variant="ghost">Manage Settings</Button>
+ *       </div>
+ *     </div>
+ *   </HoverCardContent>
+ * </HoverCard>
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Link preview with rich content
+ * <HoverCard openDelay={300}>
+ *   <HoverCardTrigger asChild>
+ *     <a href="/article/123" className="text-blue-600 hover:underline">
+ *       Advanced React Patterns
+ *     </a>
+ *   </HoverCardTrigger>
+ *   <HoverCardContent className="w-96">
+ *     <div className="space-y-3">
+ *       <img src="/article-thumbnail.jpg" className="rounded w-full h-32 object-cover" />
+ *       <div>
+ *         <h4 className="font-semibold">Advanced React Patterns</h4>
+ *         <p className="text-sm text-muted-foreground">
+ *           Learn modern React patterns including render props, compound components,
+ *           and advanced hook compositions for scalable applications.
+ *         </p>
+ *         <div className="flex items-center gap-2 mt-2 text-xs text-muted-foreground">
+ *           <span>12 min read</span>
+ *           <span>•</span>
+ *           <span>Published Mar 15, 2024</span>
+ *         </div>
+ *       </div>
  *     </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.
+ * **Important Limitations**: Hover cards are intended for sighted users only and present
+ * significant accessibility challenges. The content is inaccessible to keyboard-only users
+ * and screen reader users who cannot hover. Consider these alternatives:
  *
- * - 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
+ * - Provide keyboard-accessible alternatives (buttons, modals, expanded sections)
+ * - Ensure all essential information is available through other means
+ * - Use hover cards only for supplementary, non-critical content
+ * - Consider implementing focus-based triggers for keyboard users
  *
- * @see {@link https://ui.shadcn.com/docs/components/hover-card} shadcn/ui documentation
+ * **Current Accessibility Features**:
+ * - Opens on mouse hover with configurable delay
+ * - Stays open when hovering over the content area
+ * - Closes automatically when mouse leaves with configurable delay
+ * - Intelligent positioning to avoid viewport overflow
+ * - Smooth animations that respect prefers-reduced-motion
+ * - Proper focus management within interactive content
+ *
+ * @see {@link HoverCardTrigger} Element that triggers the hover card on hover
+ * @see {@link HoverCardContent} Container for the hover card content and positioning
+ * @see {@link https://ui.shadcn.com/docs/components/hover-card} shadcn/ui Hover Card Documentation
+ * @see {@link https://www.radix-ui.com/primitives/docs/components/hover-card} Radix UI Hover Card Primitive
+ * @see {@link https://www.w3.org/WAI/ARIA/apg/patterns/tooltip/} WAI-ARIA Tooltip Pattern (for accessibility considerations)
  * @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
+ * HoverCard - Root container that manages hover card state and timing
+ *
+ * The main wrapper component that provides context to all hover card subcomponents.
+ * Controls the opening and closing behavior, timing delays, and overall state management.
+ * Must contain HoverCardTrigger and HoverCardContent as children.
+ *
+ * @example
+ * ```tsx
+ * // Basic usage with default timing
+ * <HoverCard>
+ *   <HoverCardTrigger>Hover me</HoverCardTrigger>
+ *   <HoverCardContent>Content appears here</HoverCardContent>
+ * </HoverCard>
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Custom timing and controlled state
+ * <HoverCard
+ *   openDelay={200}
+ *   closeDelay={500}
+ *   open={isOpen}
+ *   onValueChange={setIsOpen}
+ * >
+ *   <HoverCardTrigger>Controlled hover card</HoverCardTrigger>
+ *   <HoverCardContent>This hover card is controlled externally</HoverCardContent>
+ * </HoverCard>
+ * ```
  *
- * @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
+ * @see {@link HoverCardTrigger} The element that triggers the hover behavior
+ * @see {@link HoverCardContent} The content container with positioning logic
  */
-declare function HoverCard({ ...props }: React.ComponentProps<typeof HoverCardPrimitive.Root>): import("react/jsx-runtime").JSX.Element;
+declare function HoverCard(props: React.ComponentProps<typeof HoverCardPrimitive.Root>): import("react/jsx-runtime").JSX.Element;
 /**
- * Trigger element that opens the hover card on hover
+ * HoverCardTrigger - Interactive element that activates the hover card on mouse hover
+ *
+ * The trigger component that users hover over to reveal the hover card content.
+ * Can wrap any element or render as its child using the asChild prop. Automatically
+ * manages hover detection and integrates with the parent HoverCard's timing configuration.
  *
- * @param asChild - When true, merges props with immediate child element
+ * When using asChild, the trigger merges its props with the immediate child element,
+ * allowing for seamless integration with buttons, links, or any other interactive elements.
+ *
+ * @example
+ * ```tsx
+ * // Basic trigger with text
+ * <HoverCardTrigger>
+ *   <span className="text-blue-600 cursor-pointer">Hover for details</span>
+ * </HoverCardTrigger>
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Using asChild with a button
+ * <HoverCardTrigger asChild>
+ *   <Button variant="outline">User Profile</Button>
+ * </HoverCardTrigger>
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // With a link element
+ * <HoverCardTrigger asChild>
+ *   <a href="/profile/john" className="font-medium hover:underline">
+ *     @johndoe
+ *   </a>
+ * </HoverCardTrigger>
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Complex trigger with icon
+ * <HoverCardTrigger className="inline-flex items-center gap-2">
+ *   <UserIcon className="h-4 w-4" />
+ *   <span>View Profile</span>
+ * </HoverCardTrigger>
+ * ```
+ *
+ * @accessibility
+ * - Responds to mouse hover events to show/hide content
+ * - Maintains keyboard focus when asChild is used with focusable elements
+ * - Does not provide keyboard-only access to hover card content
+ * - Consider providing alternative access methods for keyboard users
+ *
+ * @see {@link HoverCardContent} The content that appears when this trigger is hovered
  */
-declare function HoverCardTrigger({ ...props }: React.ComponentProps<typeof HoverCardPrimitive.Trigger>): import("react/jsx-runtime").JSX.Element;
+declare function HoverCardTrigger(props: React.ComponentProps<typeof HoverCardPrimitive.Trigger>): import("react/jsx-runtime").JSX.Element;
 /**
- * Content container with built-in styling and animations
+ * HoverCardContent - Floating content container with intelligent positioning and animations
+ *
+ * The content area that appears when the trigger is hovered. Features built-in animations,
+ * intelligent positioning to avoid viewport boundaries, and customizable alignment options.
+ * Automatically portaled to prevent z-index and overflow issues, with smooth fade and scale
+ * transitions that respect user motion preferences.
+ *
+ * The content supports rich layouts including text, images, buttons, and complex components.
+ * Positioning is automatically calculated based on available space, with collision detection
+ * to ensure the content remains visible within the viewport.
+ *
+ * @example
+ * ```tsx
+ * // Simple text content
+ * <HoverCardContent>
+ *   <p>This is a simple hover card with text content.</p>
+ * </HoverCardContent>
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Positioned above the trigger with custom alignment
+ * <HoverCardContent side="top" align="start" sideOffset={8}>
+ *   <div className="text-sm">
+ *     Content appears above the trigger, aligned to the start edge
+ *   </div>
+ * </HoverCardContent>
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Rich content with custom width and complex layout
+ * <HoverCardContent className="w-80">
+ *   <div className="space-y-3">
+ *     <div className="flex items-center gap-3">
+ *       <Avatar className="h-12 w-12">
+ *         <AvatarImage src="/avatar.jpg" />
+ *         <AvatarFallback>JD</AvatarFallback>
+ *       </Avatar>
+ *       <div>
+ *         <h4 className="font-semibold">John Doe</h4>
+ *         <p className="text-sm text-muted-foreground">Software Engineer</p>
+ *       </div>
+ *     </div>
+ *     <Separator />
+ *     <div className="grid grid-cols-2 gap-4 text-sm">
+ *       <div>
+ *         <p className="font-medium">Repositories</p>
+ *         <p className="text-muted-foreground">42</p>
+ *       </div>
+ *       <div>
+ *         <p className="font-medium">Followers</p>
+ *         <p className="text-muted-foreground">1.2k</p>
+ *       </div>
+ *     </div>
+ *   </div>
+ * </HoverCardContent>
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Interactive content with buttons
+ * <HoverCardContent>
+ *   <div className="space-y-3">
+ *     <h4 className="font-semibold">Quick Actions</h4>
+ *     <div className="flex flex-col gap-2">
+ *       <Button size="sm" variant="ghost" className="justify-start">
+ *         <EditIcon className="mr-2 h-4 w-4" />
+ *         Edit Details
+ *       </Button>
+ *       <Button size="sm" variant="ghost" className="justify-start">
+ *         <ShareIcon className="mr-2 h-4 w-4" />
+ *         Share Profile
+ *       </Button>
+ *       <Button size="sm" variant="ghost" className="justify-start">
+ *         <SettingsIcon className="mr-2 h-4 w-4" />
+ *         Settings
+ *       </Button>
+ *     </div>
+ *   </div>
+ * </HoverCardContent>
+ * ```
+ *
+ * @accessibility
+ * - Content is rendered in a portal to avoid z-index conflicts
+ * - Smooth animations that respect prefers-reduced-motion settings
+ * - Interactive content within the hover card remains functional
+ * - Focus management for interactive elements when content is open
+ * - Proper contrast ratios with popover color scheme
+ * - Content stays open when hovering over it, allowing interaction
+ *
+ * @animation
+ * - Fade in/out animations using data-[state] attributes
+ * - Scale animations (zoom-in-95/zoom-out-95) for smooth appearance
+ * - Directional slide animations based on positioning side
+ * - Origin-based scaling using CSS custom properties from Radix UI
+ * - Animations automatically disabled when prefers-reduced-motion is set
+ *
+ * @positioning
+ * - Auto-positioning with collision detection to stay within viewport
+ * - Supports all four sides (top, right, bottom, left) relative to trigger
+ * - Three alignment options (start, center, end) for each side
+ * - Configurable offsets for fine-tuned positioning
+ * - Boundary detection with customizable collision boundaries
+ * - Sticky positioning when content would overflow viewport
  *
- * @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
+ * @see {@link HoverCardTrigger} The element that activates this content
  */
 declare function HoverCardContent({ className, align, sideOffset, ...props }: React.ComponentProps<typeof HoverCardPrimitive.Content>): import("react/jsx-runtime").JSX.Element;
 export { HoverCard, HoverCardTrigger, HoverCardContent };

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

@@ -1 +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"}
+{"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;AA0EjE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6HG;AACH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,iBAAS,SAAS,CAChB,KAAK,EAAE,KAAK,CAAC,cAAc,CAAC,OAAO,kBAAkB,CAAC,IAAI,CAAC,2CAG5D;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoDG;AACH,iBAAS,gBAAgB,CACvB,KAAK,EAAE,KAAK,CAAC,cAAc,CAAC,OAAO,kBAAkB,CAAC,OAAO,CAAC,2CAK/D;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4GG;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"}