@neynar/ui 0.2.0 → 0.3.0

package/llm-docs/button.llm.md

@@ -1,281 +0,0 @@
-# Button
-
-**Type**: component
-
-Button - A versatile, accessible button component with multiple style variants A fundamental UI element built on Radix UI's Slot primitive that supports extensive customization through variants, composition patterns, and comprehensive accessibility features. The component automatically handles icon styling, focus management, form integration, and can be rendered as other elements using the asChild pattern.
-
-## JSX Usage
-
-```jsx
-import { Button } from '@neynar/ui';
-
-<Button
-  variant={value}
-  size={value}
-  asChild={true}
-  className="value"
-  disabled={true}
-  type={value}
-  onClick={handleClick}
-  onFocus={handleFocus}
-  onBlur={handleBlur}
-  onMouseEnter={handleMouseEnter}
-  onMouseLeave={handleMouseLeave}
-  "aria-label"="value"
-  "aria-describedby"="value"
-  "aria-invalid"={value}
-  "aria-expanded"={value}
-  "aria-controls"="value"
-  "aria-pressed"={value}
-  tabIndex={0}
-  autoFocus={true}
-  form="value"
-  formAction={() => {}}
-  formEncType="value"
-  formMethod="value"
-  formNoValidate={true}
-  formTarget="value"
-  name="value"
-  value={value}
-  ref={value}
->
-  {/* Your content here */}
-</Button>
-```
-
-## Component Props
-
-### variant
-- **Type**: `| "default"
-    | "destructive"
-    | "outline"
-    | "secondary"
-    | "ghost"
-    | "link"`
-- **Required**: No
-- **Description**: No description available
-
-### size
-- **Type**: `"default" | "sm" | "lg" | "icon"`
-- **Required**: No
-- **Description**: No description available
-
-### asChild
-- **Type**: `boolean`
-- **Required**: No
-- **Description**: No description available
-
-### children
-- **Type**: `React.ReactNode`
-- **Required**: No
-- **Description**: No description available
-
-### className
-- **Type**: `string`
-- **Required**: No
-- **Description**: No description available
-
-### disabled
-- **Type**: `boolean`
-- **Required**: No
-- **Description**: No description available
-
-### type
-- **Type**: `"button" | "submit" | "reset"`
-- **Required**: No
-- **Description**: No description available
-
-### onClick
-- **Type**: `React.MouseEventHandler<HTMLButtonElement>`
-- **Required**: No
-- **Description**: No description available
-
-### onFocus
-- **Type**: `React.FocusEventHandler<HTMLButtonElement>`
-- **Required**: No
-- **Description**: No description available
-
-### onBlur
-- **Type**: `React.FocusEventHandler<HTMLButtonElement>`
-- **Required**: No
-- **Description**: No description available
-
-### onMouseEnter
-- **Type**: `React.MouseEventHandler<HTMLButtonElement>`
-- **Required**: No
-- **Description**: No description available
-
-### onMouseLeave
-- **Type**: `React.MouseEventHandler<HTMLButtonElement>`
-- **Required**: No
-- **Description**: No description available
-
-### "aria-label"
-- **Type**: `string`
-- **Required**: No
-- **Description**: No description available
-
-### "aria-describedby"
-- **Type**: `string`
-- **Required**: No
-- **Description**: No description available
-
-### "aria-invalid"
-- **Type**: `boolean | "false" | "true" | "grammar" | "spelling"`
-- **Required**: No
-- **Description**: No description available
-
-### "aria-expanded"
-- **Type**: `React.AriaAttributes['aria-expanded']`
-- **Required**: No
-- **Description**: No description available
-
-### "aria-controls"
-- **Type**: `string`
-- **Required**: No
-- **Description**: No description available
-
-### "aria-pressed"
-- **Type**: `boolean | "false" | "true" | "mixed"`
-- **Required**: No
-- **Description**: No description available
-
-### tabIndex
-- **Type**: `number`
-- **Required**: No
-- **Description**: No description available
-
-### autoFocus
-- **Type**: `boolean`
-- **Required**: No
-- **Description**: No description available
-
-### form
-- **Type**: `string`
-- **Required**: No
-- **Description**: No description available
-
-### formAction
-- **Type**: `string | ((formData: FormData) => void | Promise<void>)`
-- **Required**: No
-- **Description**: No description available
-
-### formEncType
-- **Type**: `string`
-- **Required**: No
-- **Description**: No description available
-
-### formMethod
-- **Type**: `string`
-- **Required**: No
-- **Description**: No description available
-
-### formNoValidate
-- **Type**: `boolean`
-- **Required**: No
-- **Description**: No description available
-
-### formTarget
-- **Type**: `string`
-- **Required**: No
-- **Description**: No description available
-
-### name
-- **Type**: `string`
-- **Required**: No
-- **Description**: No description available
-
-### value
-- **Type**: `string | ReadonlyArray<string> | number`
-- **Required**: No
-- **Description**: No description available
-
-### ref
-- **Type**: `React.Ref<HTMLButtonElement>`
-- **Required**: No
-- **Description**: No description available
-
-## Examples
-
-### Example 1
-```tsx
-// Basic usage with different variants
-<Button>Default Button</Button>
-<Button variant="destructive">Delete Item</Button>
-<Button variant="outline" size="lg">Large Outline</Button>
-<Button variant="ghost" size="sm">Small Ghost</Button>
-<Button variant="link">Link Button</Button>
-```
-### Example 2
-```tsx
-// Icon usage (automatically styled with proper spacing)
-import { Download, ArrowRight, Plus, Trash2 } from "lucide-react";
-<Button>
-  <Download className="mr-2" /> Download File
-</Button>
-<Button variant="outline">
-  Continue <ArrowRight className="ml-2" />
-</Button>
-// Icon-only button (always include aria-label)
-<Button size="icon" aria-label="Add new item">
-  <Plus />
-</Button>
-<Button size="icon" variant="destructive" aria-label="Delete item">
-  <Trash2 />
-</Button>
-```
-### Example 3
-```tsx
-// Composition with asChild (render as different elements)
-import Link from "next/link";
-import { ExternalLink } from "lucide-react";
-<Button asChild>
-  <Link href="/dashboard">Go to Dashboard</Link>
-</Button>
-<Button asChild variant="outline">
-  <a href="https://example.com" target="_blank" rel="noopener noreferrer">
-    External Link <ExternalLink className="ml-2 h-4 w-4" />
-  </a>
-</Button>
-```
-### Example 4
-```tsx
-// Form integration and states
-<Button type="submit" disabled={isSubmitting}>
-  {isSubmitting ? "Submitting..." : "Submit Form"}
-</Button>
-<Button
-  variant="destructive"
-  onClick={() => handleDelete()}
-  aria-describedby="delete-warning"
->
-  Delete Account
-</Button>
-<p id="delete-warning" className="sr-only">
-  This action cannot be undone
-</p>
-// Toggle button with pressed state
-<Button
-  variant="outline"
-  aria-pressed={isToggled}
-  onClick={() => setIsToggled(!isToggled)}
->
-  {isToggled ? "Enabled" : "Disabled"}
-</Button>
-```
-### Example 5
-```tsx
-// Loading states and advanced usage
-import { Loader2, Save } from "lucide-react";
-<Button disabled={isLoading}>
-  {isLoading && <Loader2 className="mr-2 h-4 w-4 animate-spin" />}
-  {isLoading ? "Saving..." : "Save Changes"}
-</Button>
-// With custom styling
-<Button
-  className="bg-gradient-to-r from-purple-500 to-pink-500 hover:from-purple-600 hover:to-pink-600"
-  size="lg"
->
-  Gradient Button
-</Button>
-```

package/llm-docs/calendar-day-button.llm.md

@@ -1,57 +0,0 @@
-# CalendarDayButton
-
-**Type**: component
-
-CalendarDayButton - Individual day button component for calendar dates Renders a single interactive day button with appropriate styling for different states including selected, today, disabled, and range selection indicators. This component is used internally by the Calendar component but can be customized if needed.
-
-## JSX Usage
-
-```jsx
-import { CalendarDayButton } from '@neynar/ui';
-
-<CalendarDayButton
-  className={value}
-  day={value}
-  modifiers={value}
-  ...props={value}
-/>
-```
-
-## Component Props
-
-### className
-- **Type**: `unknown`
-- **Required**: Yes
-- **Description**: No description available
-
-### day
-- **Type**: `unknown`
-- **Required**: Yes
-- **Description**: No description available
-
-### modifiers
-- **Type**: `unknown`
-- **Required**: Yes
-- **Description**: No description available
-
-### ...props
-- **Type**: `unknown`
-- **Required**: Yes
-- **Description**: No description available
-
-## Examples
-
-```tsx
-// Used internally by Calendar component
-<CalendarDayButton
-  day={dayObject}
-  modifiers={{
-    selected: true,
-    today: false,
-    disabled: false,
-    range_start: false,
-    range_end: false,
-    range_middle: false
-  }}
-/>
-```

package/llm-docs/calendar.llm.md

@@ -1,340 +0,0 @@
-# Calendar
-
-**Type**: component
-
-Calendar - A comprehensive date selection calendar component A fully-featured calendar component built on react-day-picker that provides intuitive date selection with extensive customization options. Supports single dates, date ranges, multiple dates, and custom validation rules with built-in accessibility features. Built on the powerful react-day-picker library, this component provides a complete calendar interface with advanced features like custom formatters, modifiers, disabled dates, localization, and extensive styling options.
-
-## JSX Usage
-
-```jsx
-import { Calendar } from '@neynar/ui';
-
-<Calendar
-  mode={value}
-  selected={[]}
-  onSelect={handleSelect}
-  buttonVariant={value}
-  captionLayout={value}
-  showOutsideDays={true}
-  numberOfMonths={0}
-  showWeekNumber={true}
-  ISOWeek={true}
-  fixedWeeks={true}
-  disabled={[]}
-  highlighted={[]}
-  defaultMonth={value}
-  month={value}
-  onMonthChange={handleMonthChange}
-  startMonth={value}
-  endMonth={value}
-  fromYear={0}
-  toYear={0}
-  disableNavigation={true}
-  hideNavigation={true}
-  animate={true}
-  weekStartsOn={value}
-  firstWeekContainsDate={value}
-  locale={value}
-  dir={value}
-  onDayClick={handleDayClick}
-  onDayMouseEnter={handleDayMouseEnter}
-  onDayMouseLeave={handleDayMouseLeave}
-  onDayKeyDown={handleDayKeyDown}
-  onWeekNumberClick={handleWeekNumberClick}
-  formatters={() => {}}
-  classNames={value}
-  components={value}
-  footer={value}
-  modifiers={[]}
-  className="value"
-  style={value}
-/>
-```
-
-## Component Props
-
-### mode
-- **Type**: `"single" | "multiple" | "range" | "none"`
-- **Required**: No
-- **Description**: No description available
-
-### selected
-- **Type**: `Date | Date[] | DateRange | undefined`
-- **Required**: No
-- **Description**: No description available
-
-### onSelect
-- **Type**: `(value: Date | Date[] | DateRange | undefined) => void`
-- **Required**: No
-- **Description**: No description available
-
-### buttonVariant
-- **Type**: `| "default"
-    | "destructive"
-    | "outline"
-    | "secondary"
-    | "ghost"
-    | "link"`
-- **Required**: No
-- **Description**: No description available
-
-### captionLayout
-- **Type**: `"buttons" | "dropdown" | "dropdown-buttons"`
-- **Required**: No
-- **Description**: No description available
-
-### showOutsideDays
-- **Type**: `boolean`
-- **Required**: No
-- **Description**: No description available
-
-### numberOfMonths
-- **Type**: `number`
-- **Required**: No
-- **Description**: No description available
-
-### showWeekNumber
-- **Type**: `boolean`
-- **Required**: No
-- **Description**: No description available
-
-### ISOWeek
-- **Type**: `boolean`
-- **Required**: No
-- **Description**: No description available
-
-### fixedWeeks
-- **Type**: `boolean`
-- **Required**: No
-- **Description**: No description available
-
-### disabled
-- **Type**: `Matcher | Matcher[]`
-- **Required**: No
-- **Description**: No description available
-
-### highlighted
-- **Type**: `Matcher | Matcher[]`
-- **Required**: No
-- **Description**: No description available
-
-### defaultMonth
-- **Type**: `Date`
-- **Required**: No
-- **Description**: No description available
-
-### month
-- **Type**: `Date`
-- **Required**: No
-- **Description**: No description available
-
-### onMonthChange
-- **Type**: `(month: Date) => void`
-- **Required**: No
-- **Description**: No description available
-
-### startMonth
-- **Type**: `Date`
-- **Required**: No
-- **Description**: No description available
-
-### endMonth
-- **Type**: `Date`
-- **Required**: No
-- **Description**: No description available
-
-### fromYear
-- **Type**: `number`
-- **Required**: No
-- **Description**: No description available
-
-### toYear
-- **Type**: `number`
-- **Required**: No
-- **Description**: No description available
-
-### disableNavigation
-- **Type**: `boolean`
-- **Required**: No
-- **Description**: No description available
-
-### hideNavigation
-- **Type**: `boolean`
-- **Required**: No
-- **Description**: No description available
-
-### animate
-- **Type**: `boolean`
-- **Required**: No
-- **Description**: No description available
-
-### weekStartsOn
-- **Type**: `0 | 1 | 2 | 3 | 4 | 5 | 6`
-- **Required**: No
-- **Description**: No description available
-
-### firstWeekContainsDate
-- **Type**: `1 | 4`
-- **Required**: No
-- **Description**: No description available
-
-### locale
-- **Type**: `Locale`
-- **Required**: No
-- **Description**: No description available
-
-### dir
-- **Type**: `"ltr" | "rtl"`
-- **Required**: No
-- **Description**: No description available
-
-### onDayClick
-- **Type**: `(day: Date, modifiers: Record<string, boolean>) => void`
-- **Required**: No
-- **Description**: No description available
-
-### onDayMouseEnter
-- **Type**: `(day: Date, modifiers: Record<string, boolean>) => void`
-- **Required**: No
-- **Description**: No description available
-
-### onDayMouseLeave
-- **Type**: `(day: Date, modifiers: Record<string, boolean>) => void`
-- **Required**: No
-- **Description**: No description available
-
-### onDayKeyDown
-- **Type**: `(
-    day: Date,
-    key: string,
-    modifiers: Record<string, boolean>,
-  ) => void`
-- **Required**: No
-- **Description**: No description available
-
-### onWeekNumberClick
-- **Type**: `(weekNumber: number, dates: Date[]) => void`
-- **Required**: No
-- **Description**: No description available
-
-### formatters
-- **Type**: `{
-    /** Format individual day numbers */
-    formatDay?: (date: Date) => string;
-    /** Format month caption (header) */
-    formatMonthCaption?: (date: Date) => string;
-    /** Format week numbers */
-    formatWeekNumber?: (weekNumber: number) => string;
-    /** Format weekday names in header */
-    formatWeekdayName?: (date: Date) => string;
-    /** Format year in dropdown */
-    formatYearDropdown?: (date: Date) => string;
-    /** Format month in dropdown */
-    formatMonthDropdown?: (date: Date) => string;
-  }`
-- **Required**: No
-- **Description**: No description available
-
-### classNames
-- **Type**: `{
-    /** Root calendar container */
-    root?: string;
-    /** Months container */
-    months?: string;
-    /** Individual month container */
-    month?: string;
-    /** Month caption/header */
-    month_caption?: string;
-    /** Navigation container */
-    nav?: string;
-    /** Previous month button */
-    button_previous?: string;
-    /** Next month button */
-    button_next?: string;
-    /** Month/year dropdowns container */
-    dropdowns?: string;
-    /** Individual dropdown */
-    dropdown?: string;
-    /** Weekdays header row */
-    weekdays?: string;
-    /** Individual weekday header */
-    weekday?: string;
-    /** Week row container */
-    week?: string;
-    /** Week number cell */
-    week_number?: string;
-    /** Individual day cell */
-    day?: string;
-    /** Selected day(s) */
-    selected?: string;
-    /** Today's date */
-    today?: string;
-    /** Disabled days */
-    disabled?: string;
-    /** Days outside current month */
-    outside?: string;
-    /** Range start day */
-    range_start?: string;
-    /** Range end day */
-    range_end?: string;
-    /** Days in middle of range */
-    range_middle?: string;
-    /** Hidden days */
-    hidden?: string;
-  }`
-- **Required**: No
-- **Description**: No description available
-
-### components
-- **Type**: `{
-    /** Root calendar container component */
-    Root?: React.ComponentType<
-      React.ComponentProps<"div"> & { rootRef?: React.Ref<HTMLDivElement> }
-    >;
-    /** Month caption component */
-    MonthCaption?: React.ComponentType<{ displayMonth: Date }>;
-    /** Navigation chevron icons */
-    Chevron?: React.ComponentType<
-      React.ComponentProps<"svg"> & {
-        orientation?: "left" | "right" | "up" | "down";
-      }
-    >;
-    /** Individual day button */
-    DayButton?: React.ComponentType<React.ComponentProps<typeof DayButton>>;
-    /** Day content (number/text inside day) */
-    DayContent?: React.ComponentType<{ date: Date }>;
-    /** Dropdown select components */
-    Dropdown?: React.ComponentType<React.ComponentProps<"select">>;
-    /** Week number component */
-    WeekNumber?: React.ComponentType<
-      React.ComponentProps<"td"> & { children: React.ReactNode }
-    >;
-    /** Footer component */
-    Footer?: React.ComponentType<{ children: React.ReactNode }>;
-    /** Weekdays header */
-    Weekdays?: React.ComponentType<React.ComponentProps<"tr">>;
-    /** Week row component */
-    Week?: React.ComponentType<React.ComponentProps<"tr">>;
-  }`
-- **Required**: No
-- **Description**: No description available
-
-### footer
-- **Type**: `React.ReactNode`
-- **Required**: No
-- **Description**: No description available
-
-### modifiers
-- **Type**: `Record<string, Matcher | Matcher[]>`
-- **Required**: No
-- **Description**: No description available
-
-### className
-- **Type**: `string`
-- **Required**: No
-- **Description**: No description available
-
-### style
-- **Type**: `React.CSSProperties`
-- **Required**: No
-- **Description**: No description available