@neynar/ui 0.1.1

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

@@ -0,0 +1,339 @@
+import * as React from "react";
+import * as ContextMenuPrimitive from "@radix-ui/react-context-menu";
+/**
+ * ContextMenu - A contextual menu that appears on right-click or long-press
+ *
+ * Context menus provide contextual actions for specific elements or areas.
+ * Built on Radix UI primitives, they appear when users right-click (or long-press
+ * on touch devices) and offer actions relevant to the clicked item or region.
+ *
+ * @example
+ * ```tsx
+ * // Basic context menu with items
+ * <ContextMenu>
+ *   <ContextMenuTrigger>
+ *     <div className="border rounded p-4">
+ *       Right-click here
+ *     </div>
+ *   </ContextMenuTrigger>
+ *   <ContextMenuContent>
+ *     <ContextMenuItem>Copy</ContextMenuItem>
+ *     <ContextMenuItem>Paste</ContextMenuItem>
+ *     <ContextMenuSeparator />
+ *     <ContextMenuItem variant="destructive">Delete</ContextMenuItem>
+ *   </ContextMenuContent>
+ * </ContextMenu>
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // With sub-menus and shortcuts
+ * <ContextMenu>
+ *   <ContextMenuTrigger>Right-click me</ContextMenuTrigger>
+ *   <ContextMenuContent>
+ *     <ContextMenuItem>
+ *       Edit <ContextMenuShortcut>⌘E</ContextMenuShortcut>
+ *     </ContextMenuItem>
+ *     <ContextMenuSub>
+ *       <ContextMenuSubTrigger>Share</ContextMenuSubTrigger>
+ *       <ContextMenuSubContent>
+ *         <ContextMenuItem>Email</ContextMenuItem>
+ *         <ContextMenuItem>Copy Link</ContextMenuItem>
+ *       </ContextMenuSubContent>
+ *     </ContextMenuSub>
+ *   </ContextMenuContent>
+ * </ContextMenu>
+ * ```
+ *
+ * @accessibility
+ * - Triggered by right-click, long-press, or Shift+F10
+ * - Full keyboard navigation with arrow keys
+ * - Escape key closes the menu and sub-menus
+ * - Enter/Space activates menu items
+ * - Tab moves focus outside the menu
+ * - Proper ARIA roles and focus management
+ * - Screen reader announcements for menu state changes
+ *
+ * @see {@link https://ui.shadcn.com/docs/components/context-menu} shadcn/ui docs
+ * @since 1.0.0
+ * @see {@link https://www.radix-ui.com/primitives/docs/components/context-menu} Radix UI docs
+ */
+declare function ContextMenu({ ...props }: React.ComponentProps<typeof ContextMenuPrimitive.Root>): import("react/jsx-runtime").JSX.Element;
+/**
+ * ContextMenuTrigger - The element that triggers the context menu
+ *
+ * Wraps any element to make it respond to right-click or long-press events.
+ * The trigger element should provide visual feedback about its interactive nature.
+ *
+ * @example
+ * ```tsx
+ * <ContextMenuTrigger>
+ *   <Button variant="outline">Right-click me</Button>
+ * </ContextMenuTrigger>
+ * ```
+ *
+ * @param children - Any React element that should trigger the context menu
+ */
+declare function ContextMenuTrigger({ ...props }: React.ComponentProps<typeof ContextMenuPrimitive.Trigger>): import("react/jsx-runtime").JSX.Element;
+/**
+ * ContextMenuGroup - Logical grouping for menu items
+ *
+ * Groups related menu items together for better organization and accessibility.
+ * Provides semantic structure without visual changes.
+ *
+ * @example
+ * ```tsx
+ * <ContextMenuGroup>
+ *   <ContextMenuItem>Copy</ContextMenuItem>
+ *   <ContextMenuItem>Cut</ContextMenuItem>
+ *   <ContextMenuItem>Paste</ContextMenuItem>
+ * </ContextMenuGroup>
+ * ```
+ */
+declare function ContextMenuGroup({ ...props }: React.ComponentProps<typeof ContextMenuPrimitive.Group>): import("react/jsx-runtime").JSX.Element;
+/**
+ * ContextMenuPortal - Portal container for menu content
+ *
+ * Renders menu content in a portal to ensure proper layering and positioning.
+ * Typically used with sub-menus to control rendering context.
+ *
+ * @example
+ * ```tsx
+ * <ContextMenuPortal>
+ *   <ContextMenuSubContent>
+ *     <ContextMenuItem>Portal Item</ContextMenuItem>
+ *   </ContextMenuSubContent>
+ * </ContextMenuPortal>
+ * ```
+ *
+ * @param container - Custom container element for the portal
+ */
+declare function ContextMenuPortal({ ...props }: React.ComponentProps<typeof ContextMenuPrimitive.Portal>): import("react/jsx-runtime").JSX.Element;
+/**
+ * ContextMenuSub - Container for sub-menu functionality
+ *
+ * Wraps a sub-menu trigger and its content to create nested menu structures.
+ * Enables hierarchical organization of menu items.
+ *
+ * @example
+ * ```tsx
+ * <ContextMenuSub>
+ *   <ContextMenuSubTrigger>Share</ContextMenuSubTrigger>
+ *   <ContextMenuSubContent>
+ *     <ContextMenuItem>Email</ContextMenuItem>
+ *     <ContextMenuItem>Copy Link</ContextMenuItem>
+ *   </ContextMenuSubContent>
+ * </ContextMenuSub>
+ * ```
+ */
+declare function ContextMenuSub({ ...props }: React.ComponentProps<typeof ContextMenuPrimitive.Sub>): import("react/jsx-runtime").JSX.Element;
+/**
+ * ContextMenuRadioGroup - Container for radio button items
+ *
+ * Groups radio items together to allow single selection from multiple options.
+ * Manages the selected state and ensures only one item can be selected.
+ *
+ * @example
+ * ```tsx
+ * <ContextMenuRadioGroup value={theme} onValueChange={setTheme}>
+ *   <ContextMenuRadioItem value="light">Light</ContextMenuRadioItem>
+ *   <ContextMenuRadioItem value="dark">Dark</ContextMenuRadioItem>
+ *   <ContextMenuRadioItem value="system">System</ContextMenuRadioItem>
+ * </ContextMenuRadioGroup>
+ * ```
+ *
+ * @param value - The currently selected value
+ * @param onValueChange - Callback fired when selection changes
+ */
+declare function ContextMenuRadioGroup({ ...props }: React.ComponentProps<typeof ContextMenuPrimitive.RadioGroup>): import("react/jsx-runtime").JSX.Element;
+/**
+ * ContextMenuSubTrigger - Trigger element for opening sub-menus
+ *
+ * Menu item that opens a sub-menu on hover or focus. Automatically includes
+ * a chevron icon to indicate the presence of a sub-menu.
+ *
+ * @example
+ * ```tsx
+ * <ContextMenuSubTrigger>
+ *   <Share className="mr-2 h-4 w-4" />
+ *   Share Options
+ * </ContextMenuSubTrigger>
+ * ```
+ *
+ * @param inset - Whether to indent the trigger for proper alignment
+ * @param children - Content of the trigger (text, icons, etc.)
+ */
+declare function ContextMenuSubTrigger({ className, inset, children, ...props }: React.ComponentProps<typeof ContextMenuPrimitive.SubTrigger> & {
+    /** Whether to indent the trigger for proper alignment */
+    inset?: boolean;
+}): import("react/jsx-runtime").JSX.Element;
+/**
+ * ContextMenuSubContent - Container for sub-menu items
+ *
+ * Contains the items within a sub-menu. Automatically positioned relative
+ * to its trigger with collision detection and smooth animations.
+ *
+ * @example
+ * ```tsx
+ * <ContextMenuSubContent>
+ *   <ContextMenuItem>Option 1</ContextMenuItem>
+ *   <ContextMenuItem>Option 2</ContextMenuItem>
+ *   <ContextMenuSeparator />
+ *   <ContextMenuItem>Option 3</ContextMenuItem>
+ * </ContextMenuSubContent>
+ * ```
+ *
+ * @param className - Additional CSS classes for styling
+ * @param children - Sub-menu items, separators, and labels
+ */
+declare function ContextMenuSubContent({ className, ...props }: React.ComponentProps<typeof ContextMenuPrimitive.SubContent>): import("react/jsx-runtime").JSX.Element;
+/**
+ * ContextMenuContent - The container for context menu items
+ *
+ * Contains all menu items, separators, labels, and sub-menus. Automatically
+ * positioned relative to the trigger point with collision detection.
+ *
+ * @example
+ * ```tsx
+ * <ContextMenuContent className="w-56">
+ *   <ContextMenuLabel>Actions</ContextMenuLabel>
+ *   <ContextMenuSeparator />
+ *   <ContextMenuItem>Copy</ContextMenuItem>
+ *   <ContextMenuItem>Paste</ContextMenuItem>
+ * </ContextMenuContent>
+ * ```
+ *
+ * @param className - Additional CSS classes for styling
+ * @param children - Menu items, separators, labels, and sub-menus
+ */
+declare function ContextMenuContent({ className, ...props }: React.ComponentProps<typeof ContextMenuPrimitive.Content>): import("react/jsx-runtime").JSX.Element;
+/**
+ * ContextMenuItem - An actionable item within the context menu
+ *
+ * Individual menu items that users can interact with. Supports different
+ * variants for visual hierarchy and includes automatic icon styling.
+ *
+ * @example
+ * ```tsx
+ * <ContextMenuItem>
+ *   <Edit className="mr-2 h-4 w-4" />
+ *   Edit
+ *   <ContextMenuShortcut>⌘E</ContextMenuShortcut>
+ * </ContextMenuItem>
+ * ```
+ *
+ * @example
+ * ```tsx
+ * <ContextMenuItem variant="destructive">
+ *   <Trash2 className="mr-2 h-4 w-4" />
+ *   Delete
+ * </ContextMenuItem>
+ * ```
+ *
+ * @param inset - Whether to indent the item (useful when mixing items with/without icons)
+ * @param variant - Visual variant: "default" for normal actions, "destructive" for dangerous actions
+ * @param disabled - Whether the item is disabled and non-interactive
+ * @param onSelect - Callback fired when the item is selected
+ */
+declare function ContextMenuItem({ className, inset, variant, ...props }: React.ComponentProps<typeof ContextMenuPrimitive.Item> & {
+    /** Whether to indent the item for proper alignment */
+    inset?: boolean;
+    /** Visual variant for the menu item */
+    variant?: "default" | "destructive";
+}): import("react/jsx-runtime").JSX.Element;
+/**
+ * ContextMenuCheckboxItem - A menu item with checkbox functionality
+ *
+ * Menu items that can be toggled on/off, useful for binary settings or options.
+ * Displays a check mark when selected and supports controlled state management.
+ *
+ * @example
+ * ```tsx
+ * const [showGrid, setShowGrid] = useState(true)
+ *
+ * <ContextMenuCheckboxItem
+ *   checked={showGrid}
+ *   onCheckedChange={setShowGrid}
+ * >
+ *   Show Grid
+ * </ContextMenuCheckboxItem>
+ * ```
+ *
+ * @param checked - Whether the checkbox is checked
+ * @param onCheckedChange - Callback fired when the checked state changes
+ * @param disabled - Whether the item is disabled
+ */
+declare function ContextMenuCheckboxItem({ className, children, checked, ...props }: React.ComponentProps<typeof ContextMenuPrimitive.CheckboxItem>): import("react/jsx-runtime").JSX.Element;
+/**
+ * ContextMenuRadioItem - A radio button item within a radio group
+ *
+ * Menu items that allow single selection from a group of options.
+ * Must be used within a ContextMenuRadioGroup for proper functionality.
+ *
+ * @example
+ * ```tsx
+ * <ContextMenuRadioGroup value={theme} onValueChange={setTheme}>
+ *   <ContextMenuRadioItem value="light">Light</ContextMenuRadioItem>
+ *   <ContextMenuRadioItem value="dark">Dark</ContextMenuRadioItem>
+ *   <ContextMenuRadioItem value="system">System</ContextMenuRadioItem>
+ * </ContextMenuRadioGroup>
+ * ```
+ *
+ * @param value - The value of this radio item
+ * @param disabled - Whether the item is disabled
+ */
+declare function ContextMenuRadioItem({ className, children, ...props }: React.ComponentProps<typeof ContextMenuPrimitive.RadioItem>): import("react/jsx-runtime").JSX.Element;
+/**
+ * ContextMenuLabel - A non-interactive label for menu sections
+ *
+ * Used to group related menu items and provide context. Labels are not
+ * focusable and serve as visual section headers within the menu.
+ *
+ * @example
+ * ```tsx
+ * <ContextMenuLabel>File Actions</ContextMenuLabel>
+ * <ContextMenuSeparator />
+ * <ContextMenuItem>Open</ContextMenuItem>
+ * <ContextMenuItem>Save</ContextMenuItem>
+ * ```
+ *
+ * @param inset - Whether to indent the label to align with inset items
+ */
+declare function ContextMenuLabel({ className, inset, ...props }: React.ComponentProps<typeof ContextMenuPrimitive.Label> & {
+    /** Whether to indent the label for proper alignment */
+    inset?: boolean;
+}): import("react/jsx-runtime").JSX.Element;
+/**
+ * ContextMenuSeparator - A visual divider between menu items
+ *
+ * Creates visual separation between groups of related menu items.
+ * Typically used after labels or to separate different types of actions.
+ *
+ * @example
+ * ```tsx
+ * <ContextMenuItem>Copy</ContextMenuItem>
+ * <ContextMenuItem>Paste</ContextMenuItem>
+ * <ContextMenuSeparator />
+ * <ContextMenuItem variant="destructive">Delete</ContextMenuItem>
+ * ```
+ */
+declare function ContextMenuSeparator({ className, ...props }: React.ComponentProps<typeof ContextMenuPrimitive.Separator>): import("react/jsx-runtime").JSX.Element;
+/**
+ * ContextMenuShortcut - Displays keyboard shortcuts within menu items
+ *
+ * Shows keyboard shortcuts aligned to the right side of menu items.
+ * Provides visual indication of available keyboard shortcuts for actions.
+ *
+ * @example
+ * ```tsx
+ * <ContextMenuItem>
+ *   Copy
+ *   <ContextMenuShortcut>⌘C</ContextMenuShortcut>
+ * </ContextMenuItem>
+ * ```
+ *
+ * @param children - The shortcut text (e.g., "⌘C", "Ctrl+V")
+ */
+declare function ContextMenuShortcut({ className, ...props }: React.ComponentProps<"span">): import("react/jsx-runtime").JSX.Element;
+export { ContextMenu, ContextMenuTrigger, ContextMenuContent, ContextMenuItem, ContextMenuCheckboxItem, ContextMenuRadioItem, ContextMenuLabel, ContextMenuSeparator, ContextMenuShortcut, ContextMenuGroup, ContextMenuPortal, ContextMenuSub, ContextMenuSubContent, ContextMenuSubTrigger, ContextMenuRadioGroup, };
+//# sourceMappingURL=context-menu.d.ts.map

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

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

package/dist/components/ui/date-picker.d.ts

@@ -0,0 +1,145 @@
+/**
+ * Properties for the DatePicker component
+ *
+ * @type DatePickerProps
+ * @since 1.0.0
+ */
+type DatePickerProps = {
+    /**
+     * The currently selected date value. When undefined, no date is selected.
+     *
+     * @example
+     * ```tsx
+     * const [selectedDate, setSelectedDate] = useState<Date>();
+     * <DatePicker date={selectedDate} onDateChange={setSelectedDate} />
+     * ```
+     */
+    date?: Date;
+    /**
+     * Callback function invoked when the user selects or clears a date.
+     * Receives the selected date or undefined when cleared.
+     *
+     * @param date - The newly selected date or undefined if cleared
+     *
+     * @example
+     * ```tsx
+     * <DatePicker onDateChange={(date) => console.log('Selected:', date)} />
+     * ```
+     */
+    onDateChange?: (date: Date | undefined) => void;
+    /**
+     * Placeholder text displayed in the trigger button when no date is selected.
+     * Provides context about what kind of date selection is expected.
+     *
+     * @default "Pick a date"
+     *
+     * @example
+     * ```tsx
+     * <DatePicker placeholder="Select your birthday" />
+     * ```
+     */
+    placeholder?: string;
+    /**
+     * When true, disables the date picker preventing user interaction.
+     * The trigger button will appear disabled and the popover cannot be opened.
+     *
+     * @default false
+     *
+     * @example
+     * ```tsx
+     * <DatePicker disabled={true} placeholder="Date locked" />
+     * ```
+     */
+    disabled?: boolean;
+    /**
+     * Additional CSS classes to apply to the trigger button.
+     * Useful for customizing width, spacing, or other styling.
+     *
+     * @example
+     * ```tsx
+     * <DatePicker className="w-full" /> // Full width
+     * <DatePicker className="w-[300px]" /> // Fixed width
+     * ```
+     */
+    className?: string;
+};
+/**
+ * A comprehensive date selection component that combines an accessible button trigger
+ * with a full-featured calendar popover for intuitive date picking.
+ *
+ * Built on shadcn/ui design principles, this component provides a polished interface
+ * for date selection with proper accessibility, keyboard navigation, and visual feedback.
+ * The selected date is displayed using date-fns formatting for consistent presentation.
+ *
+ * @component
+ * @example
+ * ```tsx
+ * // Basic controlled date picker
+ * const [date, setDate] = useState<Date>();
+ *
+ * <DatePicker
+ *   date={date}
+ *   onDateChange={setDate}
+ *   placeholder="Select date"
+ * />
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Date picker for forms with validation
+ * const [birthDate, setBirthDate] = useState<Date>();
+ *
+ * <DatePicker
+ *   date={birthDate}
+ *   onDateChange={setBirthDate}
+ *   placeholder="Select birth date"
+ *   className="w-[280px]"
+ *   disabled={isSubmitting}
+ * />
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Date range start/end picker
+ * <div className="flex gap-2 items-center">
+ *   <DatePicker
+ *     date={startDate}
+ *     onDateChange={setStartDate}
+ *     placeholder="Start date"
+ *     className="w-[180px]"
+ *   />
+ *   <span>to</span>
+ *   <DatePicker
+ *     date={endDate}
+ *     onDateChange={setEndDate}
+ *     placeholder="End date"
+ *     className="w-[180px]"
+ *   />
+ * </div>
+ * ```
+ *
+ * @accessibility
+ * - **Keyboard Navigation**: Full keyboard support with Tab, Enter, Escape, and arrow keys
+ * - **Screen Reader Support**: Proper ARIA labels and live announcements for date changes
+ * - **Focus Management**: Focus returns to trigger button when popover closes
+ * - **Visual Indicators**: Clear visual states for disabled, selected, and focused elements
+ * - **Date Formatting**: Consistent date presentation using localized formatting
+ *
+ * @features
+ * - Single date selection with visual confirmation
+ * - Popover-based calendar that doesn't interfere with page layout
+ * - Automatic popover positioning and collision detection
+ * - Internal state management with optional external control
+ * - Customizable trigger button styling and width
+ * - Date formatting using date-fns for internationalization support
+ *
+ * @see {@link https://ui.shadcn.com/docs/components/date-picker} shadcn/ui Date Picker patterns
+ * @see {@link Calendar} - The underlying calendar component
+ * @see {@link Popover} - The popover container component
+ * @see {@link Button} - The trigger button component
+ *
+ * @since 1.0.0
+ */
+declare function DatePicker({ date, onDateChange, placeholder, disabled, className, }: DatePickerProps): import("react/jsx-runtime").JSX.Element;
+export { DatePicker };
+//# sourceMappingURL=date-picker.d.ts.map

package/dist/components/ui/date-picker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"date-picker.d.ts","sourceRoot":"","sources":["../../../src/components/ui/date-picker.tsx"],"names":[],"mappings":"AASA;;;;;GAKG;AACH,KAAK,eAAe,GAAG;IACrB;;;;;;;;OAQG;IACH,IAAI,CAAC,EAAE,IAAI,CAAC;IAEZ;;;;;;;;;;OAUG;IACH,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,GAAG,SAAS,KAAK,IAAI,CAAC;IAEhD;;;;;;;;;;OAUG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;;;;;;;;OASG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4EG;AACH,iBAAS,UAAU,CAAC,EAClB,IAAI,EACJ,YAAY,EACZ,WAA2B,EAC3B,QAAgB,EAChB,SAAS,GACV,EAAE,eAAe,2CAgDjB;AAED,OAAO,EAAE,UAAU,EAAE,CAAC"}