@neynar/ui 0.1.1

package/dist/components/ui/select.d.ts

@@ -0,0 +1,316 @@
+import * as React from "react";
+import * as SelectPrimitive from "@radix-ui/react-select";
+/**
+ * Select - A dropdown selection component built on Radix UI primitives
+ *
+ * Provides a dropdown menu for selecting a single option from a list of choices.
+ * Features comprehensive keyboard navigation, grouping capabilities, accessibility
+ * compliance, and flexible styling options. Perfect for forms, filters, and
+ * configuration interfaces.
+ *
+ * @component
+ * @example
+ * ```tsx
+ * // Basic uncontrolled select
+ * <Select defaultValue="apple">
+ *   <SelectTrigger className="w-[180px]">
+ *     <SelectValue placeholder="Select a fruit" />
+ *   </SelectTrigger>
+ *   <SelectContent>
+ *     <SelectItem value="apple">Apple</SelectItem>
+ *     <SelectItem value="banana">Banana</SelectItem>
+ *     <SelectItem value="orange">Orange</SelectItem>
+ *   </SelectContent>
+ * </Select>
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Controlled select with state management
+ * const [value, setValue] = useState("");
+ *
+ * <Select value={value} onValueChange={setValue}>
+ *   <SelectTrigger>
+ *     <SelectValue placeholder="Choose an option" />
+ *   </SelectTrigger>
+ *   <SelectContent>
+ *     <SelectItem value="option1">Option 1</SelectItem>
+ *     <SelectItem value="option2">Option 2</SelectItem>
+ *   </SelectContent>
+ * </Select>
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Grouped options with separators
+ * <Select>
+ *   <SelectTrigger>
+ *     <SelectValue placeholder="Select a timezone" />
+ *   </SelectTrigger>
+ *   <SelectContent>
+ *     <SelectGroup>
+ *       <SelectLabel>North America</SelectLabel>
+ *       <SelectItem value="est">Eastern Time (EST)</SelectItem>
+ *       <SelectItem value="cst">Central Time (CST)</SelectItem>
+ *     </SelectGroup>
+ *     <SelectSeparator />
+ *     <SelectGroup>
+ *       <SelectLabel>Europe</SelectLabel>
+ *       <SelectItem value="gmt">Greenwich Mean Time (GMT)</SelectItem>
+ *       <SelectItem value="cet">Central European Time (CET)</SelectItem>
+ *     </SelectGroup>
+ *   </SelectContent>
+ * </Select>
+ * ```
+ *
+ * @accessibility
+ * - Full keyboard navigation (Arrow keys, Enter, Space, Escape, Home, End)
+ * - ARIA compliant with proper roles, states, and properties
+ * - Screen reader announcements for selection changes and state updates
+ * - Focus management and trapping within dropdown
+ * - Support for disabled state on both trigger and individual items
+ * - Proper labeling and description associations
+ *
+ * @see {@link SelectTrigger} - The button that opens the dropdown
+ * @see {@link SelectContent} - The dropdown content container
+ * @see {@link SelectItem} - Individual selectable options
+ * @see {@link SelectGroup} - Container for grouping related items
+ * @see {@link SelectValue} - Displays selected value or placeholder
+ * @see {@link https://ui.shadcn.com/docs/components/select} for design patterns
+ * @since 1.0.0
+ */
+declare function Select({ ...props }: React.ComponentProps<typeof SelectPrimitive.Root>): import("react/jsx-runtime").JSX.Element;
+/**
+ * SelectGroup - Container for grouping related select items
+ *
+ * Groups related options together with an optional label for better organization
+ * and improved user experience when dealing with many options.
+ *
+ * @component
+ * @example
+ * ```tsx
+ * <SelectGroup>
+ *   <SelectLabel>Fruits</SelectLabel>
+ *   <SelectItem value="apple">Apple</SelectItem>
+ *   <SelectItem value="banana">Banana</SelectItem>
+ * </SelectGroup>
+ * ```
+ *
+ * @see {@link SelectLabel} - Label for the group
+ * @see {@link SelectItem} - Items within the group
+ * @since 1.0.0
+ */
+declare function SelectGroup({ ...props }: React.ComponentProps<typeof SelectPrimitive.Group>): import("react/jsx-runtime").JSX.Element;
+/**
+ * SelectValue - Displays the selected value or placeholder
+ *
+ * Renders the currently selected option's text or a placeholder when no option
+ * is selected. Must be used inside SelectTrigger.
+ *
+ * @component
+ * @example
+ * ```tsx
+ * <SelectTrigger>
+ *   <SelectValue placeholder="Choose an option" />
+ * </SelectTrigger>
+ * ```
+ *
+ * @see {@link SelectTrigger} - Parent container for the value
+ * @since 1.0.0
+ */
+declare function SelectValue({ ...props }: React.ComponentProps<typeof SelectPrimitive.Value>): import("react/jsx-runtime").JSX.Element;
+/**
+ * SelectTrigger - The button that opens the select dropdown
+ *
+ * A styled button that displays the current value and triggers the dropdown menu.
+ * Includes a chevron icon to indicate dropdown functionality and supports different
+ * size variants for various UI contexts.
+ *
+ * @component
+ * @example
+ * ```tsx
+ * // Basic trigger with custom width
+ * <SelectTrigger className="w-[200px]">
+ *   <SelectValue placeholder="Select an option" />
+ * </SelectTrigger>
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Small size variant for compact layouts
+ * <SelectTrigger size="sm" className="w-[150px]">
+ *   <SelectValue placeholder="Compact" />
+ * </SelectTrigger>
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // With form integration
+ * <SelectTrigger id="user-role" aria-describedby="role-help">
+ *   <SelectValue placeholder="Choose role" />
+ * </SelectTrigger>
+ * ```
+ *
+ * @accessibility
+ * - Keyboard accessible with Enter/Space to open dropdown
+ * - Arrow keys navigate when closed (opens and moves to first/last item)
+ * - Properly announces state changes to screen readers
+ * - Focus visible ring for keyboard navigation
+ * - Supports aria-describedby for additional context
+ * - Disabled state properly communicated to assistive technology
+ *
+ * @see {@link SelectValue} - Displays the selected value or placeholder
+ * @since 1.0.0
+ */
+declare function SelectTrigger({ className, size, children, ...props }: React.ComponentProps<typeof SelectPrimitive.Trigger> & {
+    /**
+     * The size variant of the trigger button
+     * @default "default"
+     */
+    size?: "sm" | "default";
+}): import("react/jsx-runtime").JSX.Element;
+/**
+ * SelectContent - Container for the dropdown content
+ *
+ * The dropdown panel that contains all selectable items, groups, and labels.
+ * Automatically handles scrolling for long lists and positioning relative to the trigger.
+ *
+ * @component
+ * @example
+ * ```tsx
+ * <SelectContent>
+ *   <SelectItem value="1">Option 1</SelectItem>
+ *   <SelectItem value="2">Option 2</SelectItem>
+ *   <SelectItem value="3">Option 3</SelectItem>
+ * </SelectContent>
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // With fixed positioning
+ * <SelectContent position="item-aligned">
+ *   <SelectItem value="1">Option 1</SelectItem>
+ * </SelectContent>
+ * ```
+ *
+ * @accessibility
+ * - Focus trapped within dropdown when open
+ * - Scrollable with keyboard navigation
+ * - Escape key closes the dropdown
+ *
+ * @see {@link SelectItem} - Individual options
+ * @see {@link SelectGroup} - Group container
+ * @since 1.0.0
+ */
+declare function SelectContent({ className, children, position, ...props }: React.ComponentProps<typeof SelectPrimitive.Content>): import("react/jsx-runtime").JSX.Element;
+/**
+ * SelectLabel - Label for a group of select items
+ *
+ * Provides a non-selectable label for categorizing groups of options.
+ * Helps users understand the context of the options below.
+ *
+ * @component
+ * @example
+ * ```tsx
+ * <SelectGroup>
+ *   <SelectLabel>Countries</SelectLabel>
+ *   <SelectItem value="us">United States</SelectItem>
+ *   <SelectItem value="uk">United Kingdom</SelectItem>
+ * </SelectGroup>
+ * ```
+ *
+ * @accessibility
+ * - Properly associated with group for screen readers
+ * - Non-selectable and non-focusable
+ *
+ * @see {@link SelectGroup} - Parent container
+ * @since 1.0.0
+ */
+declare function SelectLabel({ className, ...props }: React.ComponentProps<typeof SelectPrimitive.Label>): import("react/jsx-runtime").JSX.Element;
+/**
+ * SelectItem - Individual selectable option in the dropdown
+ *
+ * Represents a single option that users can select. Shows a checkmark
+ * when selected and supports keyboard navigation.
+ *
+ * @component
+ * @example
+ * ```tsx
+ * <SelectItem value="apple">Apple</SelectItem>
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Disabled item
+ * <SelectItem value="sold-out" disabled>
+ *   Sold Out
+ * </SelectItem>
+ * ```
+ *
+ * @accessibility
+ * - Arrow keys navigate between items
+ * - Enter or Space selects the item
+ * - Shows checkmark icon when selected
+ * - Supports disabled state
+ *
+ * @see {@link SelectContent} - Parent container
+ * @since 1.0.0
+ */
+declare function SelectItem({ className, children, ...props }: React.ComponentProps<typeof SelectPrimitive.Item>): import("react/jsx-runtime").JSX.Element;
+/**
+ * SelectSeparator - Visual divider between select groups
+ *
+ * A horizontal line that visually separates groups of options
+ * for better organization and clarity.
+ *
+ * @component
+ * @example
+ * ```tsx
+ * <SelectContent>
+ *   <SelectGroup>
+ *     <SelectItem value="1">Option 1</SelectItem>
+ *   </SelectGroup>
+ *   <SelectSeparator />
+ *   <SelectGroup>
+ *     <SelectItem value="2">Option 2</SelectItem>
+ *   </SelectGroup>
+ * </SelectContent>
+ * ```
+ *
+ * @accessibility
+ * - Decorative element with no semantic meaning
+ * - Not focusable or interactive
+ *
+ * @since 1.0.0
+ */
+declare function SelectSeparator({ className, ...props }: React.ComponentProps<typeof SelectPrimitive.Separator>): import("react/jsx-runtime").JSX.Element;
+/**
+ * SelectScrollUpButton - Scroll button for navigating up in long lists
+ *
+ * Appears at the top of the dropdown when there are more items above
+ * the visible area. Allows scrolling through long option lists.
+ *
+ * @component
+ * @accessibility
+ * - Keyboard accessible
+ * - Only visible when scrolling is available
+ *
+ * @since 1.0.0
+ */
+declare function SelectScrollUpButton({ className, ...props }: React.ComponentProps<typeof SelectPrimitive.ScrollUpButton>): import("react/jsx-runtime").JSX.Element;
+/**
+ * SelectScrollDownButton - Scroll button for navigating down in long lists
+ *
+ * Appears at the bottom of the dropdown when there are more items below
+ * the visible area. Allows scrolling through long option lists.
+ *
+ * @component
+ * @accessibility
+ * - Keyboard accessible
+ * - Only visible when scrolling is available
+ *
+ * @since 1.0.0
+ */
+declare function SelectScrollDownButton({ className, ...props }: React.ComponentProps<typeof SelectPrimitive.ScrollDownButton>): import("react/jsx-runtime").JSX.Element;
+export { Select, SelectContent, SelectGroup, SelectItem, SelectLabel, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectValue, };
+//# sourceMappingURL=select.d.ts.map

package/dist/components/ui/select.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"select.d.ts","sourceRoot":"","sources":["../../../src/components/ui/select.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,eAAe,MAAM,wBAAwB,CAAC;AAK1D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8EG;AACH,iBAAS,MAAM,CAAC,EACd,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,OAAO,eAAe,CAAC,IAAI,CAAC,2CAEnD;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,iBAAS,WAAW,CAAC,EACnB,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,OAAO,eAAe,CAAC,KAAK,CAAC,2CAEpD;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,iBAAS,WAAW,CAAC,EACnB,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,OAAO,eAAe,CAAC,KAAK,CAAC,2CAEpD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,iBAAS,aAAa,CAAC,EACrB,SAAS,EACT,IAAgB,EAChB,QAAQ,EACR,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,OAAO,eAAe,CAAC,OAAO,CAAC,GAAG;IACxD;;;OAGG;IACH,IAAI,CAAC,EAAE,IAAI,GAAG,SAAS,CAAC;CACzB,2CAiBA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,iBAAS,aAAa,CAAC,EACrB,SAAS,EACT,QAAQ,EACR,QAAmB,EACnB,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,OAAO,eAAe,CAAC,OAAO,CAAC,2CA4BtD;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,iBAAS,WAAW,CAAC,EACnB,SAAS,EACT,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,OAAO,eAAe,CAAC,KAAK,CAAC,2CAQpD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,iBAAS,UAAU,CAAC,EAClB,SAAS,EACT,QAAQ,EACR,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,OAAO,eAAe,CAAC,IAAI,CAAC,2CAkBnD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,iBAAS,eAAe,CAAC,EACvB,SAAS,EACT,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,OAAO,eAAe,CAAC,SAAS,CAAC,2CAQxD;AAED;;;;;;;;;;;;GAYG;AACH,iBAAS,oBAAoB,CAAC,EAC5B,SAAS,EACT,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,OAAO,eAAe,CAAC,cAAc,CAAC,2CAa7D;AAED;;;;;;;;;;;;GAYG;AACH,iBAAS,sBAAsB,CAAC,EAC9B,SAAS,EACT,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,OAAO,eAAe,CAAC,gBAAgB,CAAC,2CAa/D;AAED,OAAO,EACL,MAAM,EACN,aAAa,EACb,WAAW,EACX,UAAU,EACV,WAAW,EACX,sBAAsB,EACtB,oBAAoB,EACpB,eAAe,EACf,aAAa,EACb,WAAW,GACZ,CAAC"}

package/dist/components/ui/separator.d.ts

@@ -0,0 +1,80 @@
+import * as React from "react";
+import * as SeparatorPrimitive from "@radix-ui/react-separator";
+/**
+ * Separator component for visually dividing content sections
+ *
+ * A flexible separator component built on Radix UI primitives that creates
+ * visual or semantic divisions between content sections. Supports both horizontal
+ * and vertical orientations with full accessibility features including decorative
+ * and semantic separator modes for screen reader compatibility.
+ *
+ * @example
+ * ```tsx
+ * // Basic horizontal separator
+ * <div>
+ *   <p>Above content</p>
+ *   <Separator />
+ *   <p>Below content</p>
+ * </div>
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Vertical separator in toolbars
+ * <div className="flex items-center">
+ *   <button>Bold</button>
+ *   <Separator orientation="vertical" className="mx-2 h-6" />
+ *   <button>Italic</button>
+ * </div>
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Semantic separator for navigation
+ * <nav className="flex items-center">
+ *   <a href="/home">Home</a>
+ *   <Separator
+ *     orientation="vertical"
+ *     decorative={false}
+ *     aria-label="Navigation separator"
+ *     className="mx-2 h-4"
+ *   />
+ *   <a href="/about">About</a>
+ * </nav>
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Custom styled separator
+ * <Separator className="my-6 h-0.5 bg-gradient-to-r from-transparent via-border to-transparent" />
+ * ```
+ *
+ * @see {@link https://ui.shadcn.com/docs/components/separator} for design patterns
+ * @since 1.0.0
+ * @see {@link https://www.radix-ui.com/primitives/docs/components/separator} for API reference
+ */
+/**
+ * Props for the Separator component
+ */
+type SeparatorProps = React.ComponentProps<typeof SeparatorPrimitive.Root> & {
+    /** Additional CSS class names to apply to the separator */
+    className?: string;
+    /** The orientation of the separator. @default "horizontal" */
+    orientation?: "horizontal" | "vertical";
+    /** Whether the separator is purely decorative (hidden from screen readers). @default true */
+    decorative?: boolean;
+};
+/**
+ * Separator component implementation
+ *
+ * @param className - Additional CSS class names to apply
+ * @param orientation - The orientation of the separator ("horizontal" | "vertical")
+ * @param decorative - Whether the separator is decorative (hidden from screen readers)
+ * @param props - Additional props passed to the underlying Radix Separator primitive
+ */
+declare function Separator({ className, orientation, decorative, ...props }: SeparatorProps): import("react/jsx-runtime").JSX.Element;
+declare namespace Separator {
+    var displayName: string;
+}
+export { Separator, type SeparatorProps };
+//# sourceMappingURL=separator.d.ts.map

package/dist/components/ui/separator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"separator.d.ts","sourceRoot":"","sources":["../../../src/components/ui/separator.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,kBAAkB,MAAM,2BAA2B,CAAC;AAIhE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoDG;AACH;;GAEG;AACH,KAAK,cAAc,GAAG,KAAK,CAAC,cAAc,CAAC,OAAO,kBAAkB,CAAC,IAAI,CAAC,GAAG;IAC3E,2DAA2D;IAC3D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8DAA8D;IAC9D,WAAW,CAAC,EAAE,YAAY,GAAG,UAAU,CAAC;IACxC,6FAA6F;IAC7F,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB,CAAC;AAEF;;;;;;;GAOG;AACH,iBAAS,SAAS,CAAC,EACjB,SAAS,EACT,WAA0B,EAC1B,UAAiB,EACjB,GAAG,KAAK,EACT,EAAE,cAAc,2CAahB;kBAlBQ,SAAS;;;AAsBlB,OAAO,EAAE,SAAS,EAAE,KAAK,cAAc,EAAE,CAAC"}