@omnifyjp/ui 0.1.6 → 0.2.0

package/dist/components/dialog.d.ts

@@ -2,15 +2,57 @@ import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as React from 'react';
 import * as DialogPrimitive from '@radix-ui/react-dialog';
 
+/**
+ * Modal dialog component built on Radix UI Dialog.
+ *
+ * Renders a centered overlay panel that interrupts the user with important content
+ * and expects a response. Supports controlled (`open`/`onOpenChange`) and
+ * uncontrolled usage (via `DialogTrigger`).
+ *
+ * @example
+ * ```tsx
+ * <Dialog open={open} onOpenChange={setOpen}>
+ *   <DialogTrigger asChild>
+ *     <Button>Open Dialog</Button>
+ *   </DialogTrigger>
+ *   <DialogContent>
+ *     <DialogHeader>
+ *       <DialogTitle>Edit Profile</DialogTitle>
+ *       <DialogDescription>
+ *         Make changes to your profile here.
+ *       </DialogDescription>
+ *     </DialogHeader>
+ *     <div className="space-y-4">
+ *       <Input placeholder="Name" />
+ *     </div>
+ *     <DialogFooter>
+ *       <Button variant="outline" onClick={() => setOpen(false)}>
+ *         Cancel
+ *       </Button>
+ *       <Button>Save Changes</Button>
+ *     </DialogFooter>
+ *   </DialogContent>
+ * </Dialog>
+ * ```
+ */
 declare function Dialog({ ...props }: React.ComponentProps<typeof DialogPrimitive.Root>): react_jsx_runtime.JSX.Element;
+/** Element that opens the dialog when clicked. Use `asChild` to merge into your own button. */
 declare function DialogTrigger({ ...props }: React.ComponentProps<typeof DialogPrimitive.Trigger>): react_jsx_runtime.JSX.Element;
+/** Portal that renders dialog content outside the DOM hierarchy. */
 declare function DialogPortal({ ...props }: React.ComponentProps<typeof DialogPrimitive.Portal>): react_jsx_runtime.JSX.Element;
+/** Button that closes the dialog. Use `asChild` to merge into your own button. */
 declare function DialogClose({ ...props }: React.ComponentProps<typeof DialogPrimitive.Close>): react_jsx_runtime.JSX.Element;
+/** Semi-transparent backdrop rendered behind the dialog content. */
 declare const DialogOverlay: React.ForwardRefExoticComponent<Omit<DialogPrimitive.DialogOverlayProps & React.RefAttributes<HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
+/** Dialog content panel with overlay backdrop and a built-in close button. */
 declare const DialogContent: React.ForwardRefExoticComponent<Omit<DialogPrimitive.DialogContentProps & React.RefAttributes<HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
+/** Container for DialogTitle and DialogDescription at the top of the dialog. */
 declare function DialogHeader({ className, ...props }: React.ComponentProps<"div">): react_jsx_runtime.JSX.Element;
+/** Container for action buttons at the bottom of the dialog. */
 declare function DialogFooter({ className, ...props }: React.ComponentProps<"div">): react_jsx_runtime.JSX.Element;
+/** Accessible title rendered inside DialogHeader. */
 declare function DialogTitle({ className, ...props }: React.ComponentProps<typeof DialogPrimitive.Title>): react_jsx_runtime.JSX.Element;
+/** Accessible description rendered inside DialogHeader below the title. */
 declare function DialogDescription({ className, ...props }: React.ComponentProps<typeof DialogPrimitive.Description>): react_jsx_runtime.JSX.Element;
 
 export { Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger };

package/dist/components/dialog.js

@@ -1,4 +1,4 @@
-export { Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger } from '../chunk-4N357E44.js';
+export { Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger } from '../chunk-F2ZJLKDP.js';
 import '../chunk-DGPY4WP3.js';
 //# sourceMappingURL=dialog.js.map
 //# sourceMappingURL=dialog.js.map

package/dist/components/drawer.d.ts

@@ -2,16 +2,59 @@ import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as React from 'react';
 import { Drawer as Drawer$1 } from 'vaul';
 
+/**
+ * Swipeable drawer component built on Vaul.
+ *
+ * Slides from any edge of the screen and can be dismissed by swiping.
+ * Set the `direction` prop on the root to control direction (`"top"`, `"bottom"`,
+ * `"left"`, `"right"`). Always wrap content in `DrawerBody` for proper scrolling.
+ *
+ * @example
+ * ```tsx
+ * <Drawer open={open} onOpenChange={setOpen}>
+ *   <DrawerTrigger asChild>
+ *     <Button variant="outline">Open Drawer</Button>
+ *   </DrawerTrigger>
+ *   <DrawerContent>
+ *     <DrawerHeader>
+ *       <DrawerTitle>Task Details</DrawerTitle>
+ *       <DrawerDescription>
+ *         View and edit task information.
+ *       </DrawerDescription>
+ *     </DrawerHeader>
+ *     <DrawerBody>
+ *       <p>Scrollable content goes here.</p>
+ *     </DrawerBody>
+ *     <DrawerFooter>
+ *       <Button>Save</Button>
+ *       <DrawerClose asChild>
+ *         <Button variant="outline">Cancel</Button>
+ *       </DrawerClose>
+ *     </DrawerFooter>
+ *   </DrawerContent>
+ * </Drawer>
+ * ```
+ */
 declare function Drawer({ ...props }: React.ComponentProps<typeof Drawer$1.Root>): react_jsx_runtime.JSX.Element;
+/** Element that opens the drawer when clicked. Use `asChild` to merge into your own button. */
 declare function DrawerTrigger({ ...props }: React.ComponentProps<typeof Drawer$1.Trigger>): react_jsx_runtime.JSX.Element;
+/** Portal that renders drawer content outside the DOM hierarchy. */
 declare function DrawerPortal({ ...props }: React.ComponentProps<typeof Drawer$1.Portal>): react_jsx_runtime.JSX.Element;
+/** Button that closes the drawer. Use `asChild` to merge into your own button. */
 declare function DrawerClose({ ...props }: React.ComponentProps<typeof Drawer$1.Close>): react_jsx_runtime.JSX.Element;
+/** Semi-transparent backdrop rendered behind the drawer panel. */
 declare function DrawerOverlay({ className, ...props }: React.ComponentProps<typeof Drawer$1.Overlay>): react_jsx_runtime.JSX.Element;
+/** Drawer content panel that slides in from the configured direction. Includes a drag handle for bottom drawers. */
 declare function DrawerContent({ className, children, ...props }: React.ComponentProps<typeof Drawer$1.Content>): react_jsx_runtime.JSX.Element;
+/** Container for DrawerTitle and DrawerDescription at the top of the drawer. */
 declare function DrawerHeader({ className, ...props }: React.ComponentProps<"div">): react_jsx_runtime.JSX.Element;
+/** Scrollable body area for drawer content. Always wrap main content in this component. */
 declare function DrawerBody({ className, ...props }: React.ComponentProps<"div">): react_jsx_runtime.JSX.Element;
+/** Container for action buttons at the bottom of the drawer. Pushed to the bottom via `mt-auto`. */
 declare function DrawerFooter({ className, ...props }: React.ComponentProps<"div">): react_jsx_runtime.JSX.Element;
+/** Accessible title rendered inside DrawerHeader. */
 declare function DrawerTitle({ className, ...props }: React.ComponentProps<typeof Drawer$1.Title>): react_jsx_runtime.JSX.Element;
+/** Accessible description rendered inside DrawerHeader below the title. */
 declare function DrawerDescription({ className, ...props }: React.ComponentProps<typeof Drawer$1.Description>): react_jsx_runtime.JSX.Element;
 
 export { Drawer, DrawerBody, DrawerClose, DrawerContent, DrawerDescription, DrawerFooter, DrawerHeader, DrawerOverlay, DrawerPortal, DrawerTitle, DrawerTrigger };

package/dist/components/drawer.js

@@ -1,4 +1,4 @@
-export { Drawer, DrawerBody, DrawerClose, DrawerContent, DrawerDescription, DrawerFooter, DrawerHeader, DrawerOverlay, DrawerPortal, DrawerTitle, DrawerTrigger } from '../chunk-JPTN62BV.js';
+export { Drawer, DrawerBody, DrawerClose, DrawerContent, DrawerDescription, DrawerFooter, DrawerHeader, DrawerOverlay, DrawerPortal, DrawerTitle, DrawerTrigger } from '../chunk-7XH3MGBR.js';
 import '../chunk-DGPY4WP3.js';
 //# sourceMappingURL=drawer.js.map
 //# sourceMappingURL=drawer.js.map

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

@@ -2,27 +2,75 @@ import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as React from 'react';
 import * as DropdownMenuPrimitive from '@radix-ui/react-dropdown-menu';
 
+/**
+ * Dropdown menu component built on Radix UI DropdownMenu.
+ *
+ * Displays a menu of actions or options triggered by a button click.
+ * Supports items, checkbox items, radio items, sub-menus, separators,
+ * labels, shortcuts, and destructive variants.
+ *
+ * @example
+ * ```tsx
+ * <DropdownMenu>
+ *   <DropdownMenuTrigger asChild>
+ *     <Button variant="outline">Actions</Button>
+ *   </DropdownMenuTrigger>
+ *   <DropdownMenuContent>
+ *     <DropdownMenuLabel>My Account</DropdownMenuLabel>
+ *     <DropdownMenuSeparator />
+ *     <DropdownMenuItem>
+ *       <UserIcon className="size-4" />
+ *       Profile
+ *       <DropdownMenuShortcut>Ctrl+P</DropdownMenuShortcut>
+ *     </DropdownMenuItem>
+ *     <DropdownMenuItem>
+ *       <SettingsIcon className="size-4" />
+ *       Settings
+ *     </DropdownMenuItem>
+ *     <DropdownMenuSeparator />
+ *     <DropdownMenuItem variant="destructive">
+ *       <TrashIcon className="size-4" />
+ *       Delete
+ *     </DropdownMenuItem>
+ *   </DropdownMenuContent>
+ * </DropdownMenu>
+ * ```
+ */
 declare function DropdownMenu({ ...props }: React.ComponentProps<typeof DropdownMenuPrimitive.Root>): react_jsx_runtime.JSX.Element;
+/** Portal that renders dropdown content outside the DOM hierarchy. */
 declare function DropdownMenuPortal({ ...props }: React.ComponentProps<typeof DropdownMenuPrimitive.Portal>): react_jsx_runtime.JSX.Element;
+/** Element that opens the dropdown menu when clicked. Use `asChild` to merge into your own button. */
 declare function DropdownMenuTrigger({ ...props }: React.ComponentProps<typeof DropdownMenuPrimitive.Trigger>): react_jsx_runtime.JSX.Element;
+/** Floating container for menu items, positioned relative to the trigger. */
 declare function DropdownMenuContent({ className, sideOffset, ...props }: React.ComponentProps<typeof DropdownMenuPrimitive.Content>): react_jsx_runtime.JSX.Element;
+/** Groups related menu items together for accessibility. */
 declare function DropdownMenuGroup({ ...props }: React.ComponentProps<typeof DropdownMenuPrimitive.Group>): react_jsx_runtime.JSX.Element;
+/** Actionable menu item. Set `variant="destructive"` for dangerous actions, `inset` for left-padding alignment. */
 declare function DropdownMenuItem({ className, inset, variant, ...props }: React.ComponentProps<typeof DropdownMenuPrimitive.Item> & {
     inset?: boolean;
     variant?: "default" | "destructive";
 }): react_jsx_runtime.JSX.Element;
+/** Menu item with a checkbox indicator for toggling options. */
 declare function DropdownMenuCheckboxItem({ className, children, checked, ...props }: React.ComponentProps<typeof DropdownMenuPrimitive.CheckboxItem>): react_jsx_runtime.JSX.Element;
+/** Container for radio menu items where only one can be selected at a time. */
 declare function DropdownMenuRadioGroup({ ...props }: React.ComponentProps<typeof DropdownMenuPrimitive.RadioGroup>): react_jsx_runtime.JSX.Element;
+/** Menu item with a radio indicator for single-selection groups. */
 declare function DropdownMenuRadioItem({ className, children, ...props }: React.ComponentProps<typeof DropdownMenuPrimitive.RadioItem>): react_jsx_runtime.JSX.Element;
+/** Non-interactive label used to title a group of menu items. */
 declare function DropdownMenuLabel({ className, inset, ...props }: React.ComponentProps<typeof DropdownMenuPrimitive.Label> & {
     inset?: boolean;
 }): react_jsx_runtime.JSX.Element;
+/** Visual divider between groups of menu items. */
 declare function DropdownMenuSeparator({ className, ...props }: React.ComponentProps<typeof DropdownMenuPrimitive.Separator>): react_jsx_runtime.JSX.Element;
+/** Keyboard shortcut hint displayed at the end of a menu item. */
 declare function DropdownMenuShortcut({ className, ...props }: React.ComponentProps<"span">): react_jsx_runtime.JSX.Element;
+/** Container for a nested sub-menu within the dropdown. */
 declare function DropdownMenuSub({ ...props }: React.ComponentProps<typeof DropdownMenuPrimitive.Sub>): react_jsx_runtime.JSX.Element;
+/** Menu item that opens a sub-menu on hover. Displays a chevron indicator. */
 declare function DropdownMenuSubTrigger({ className, inset, children, ...props }: React.ComponentProps<typeof DropdownMenuPrimitive.SubTrigger> & {
     inset?: boolean;
 }): react_jsx_runtime.JSX.Element;
+/** Floating container for sub-menu items. */
 declare function DropdownMenuSubContent({ className, ...props }: React.ComponentProps<typeof DropdownMenuPrimitive.SubContent>): react_jsx_runtime.JSX.Element;
 
 export { DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger };

package/dist/components/dropdown-menu.js

@@ -1,4 +1,4 @@
-export { DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger } from '../chunk-23SALQ3G.js';
+export { DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger } from '../chunk-IAWKX5W4.js';
 import '../chunk-DGPY4WP3.js';
 //# sourceMappingURL=dropdown-menu.js.map
 //# sourceMappingURL=dropdown-menu.js.map

package/dist/components/file-upload.d.ts

@@ -1,16 +1,43 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 
 interface FileUploadProps {
+    /** Array of currently uploaded File objects. */
     value?: File[];
+    /** Callback fired when files are added or removed. */
     onChange?: (files: File[]) => void;
+    /** Accepted file types (e.g., `"image/*,.pdf"`). Maps to the HTML `accept` attribute. */
     accept?: string;
+    /** Whether multiple files can be selected at once. Defaults to `false`. */
     multiple?: boolean;
+    /** Maximum file size in bytes. Defaults to 10 MB. */
     maxSize?: number;
+    /** Maximum number of files allowed. */
     maxFiles?: number;
+    /** Whether the upload area is disabled. */
     disabled?: boolean;
+    /** Additional CSS class for the outer wrapper. */
     className?: string;
+    /** Whether to show the file list with previews below the drop zone. Defaults to `true`. */
     showPreview?: boolean;
 }
+/**
+ * File upload component with drag-and-drop support and file previews.
+ * Validates file size and count, shows image thumbnails, and provides remove buttons.
+ *
+ * @example
+ * ```tsx
+ * const [files, setFiles] = useState<File[]>([]);
+ *
+ * <FileUpload
+ *   value={files}
+ *   onChange={setFiles}
+ *   accept="image/*,.pdf"
+ *   multiple
+ *   maxSize={5 * 1024 * 1024}
+ *   maxFiles={3}
+ * />
+ * ```
+ */
 declare function FileUpload({ value, onChange, accept, multiple, maxSize, // 10MB default
 maxFiles, disabled, className, showPreview, }: FileUploadProps): react_jsx_runtime.JSX.Element;
 

package/dist/components/file-upload.js

@@ -1,5 +1,5 @@
-export { FileUpload } from '../chunk-KRDWVQZ6.js';
-import '../chunk-Y65FNGEE.js';
+export { FileUpload } from '../chunk-G7HTZBUR.js';
+import '../chunk-55E7D2HR.js';
 import '../chunk-DGPY4WP3.js';
 //# sourceMappingURL=file-upload.js.map
 //# sourceMappingURL=file-upload.js.map

package/dist/components/form.d.ts

@@ -5,8 +5,42 @@ import * as React from 'react';
 import * as LabelPrimitive from '@radix-ui/react-label';
 import { Slot } from '@radix-ui/react-slot';
 
+/**
+ * Form provider component built on react-hook-form's FormProvider.
+ * Wraps form fields and provides form context for validation, error display, and accessibility.
+ *
+ * @example
+ * ```tsx
+ * const form = useForm({ defaultValues: { email: "" } });
+ *
+ * <Form {...form}>
+ *   <form onSubmit={form.handleSubmit(onSubmit)}>
+ *     <FormField
+ *       control={form.control}
+ *       name="email"
+ *       render={({ field }) => (
+ *         <FormItem>
+ *           <FormLabel>Email</FormLabel>
+ *           <FormControl>
+ *             <Input placeholder="you@example.com" {...field} />
+ *           </FormControl>
+ *           <FormDescription>Your work email address.</FormDescription>
+ *           <FormMessage />
+ *         </FormItem>
+ *       )}
+ *     />
+ *     <Button type="submit">Submit</Button>
+ *   </form>
+ * </Form>
+ * ```
+ */
 declare const Form: <TFieldValues extends FieldValues, TContext = any, TTransformedValues = TFieldValues>(props: react_hook_form.FormProviderProps<TFieldValues, TContext, TTransformedValues>) => React.JSX.Element;
+/** Connects a form field to react-hook-form's Controller and provides field context. */
 declare const FormField: <TFieldValues extends FieldValues = FieldValues, TName extends FieldPath<TFieldValues> = FieldPath<TFieldValues>>({ ...props }: ControllerProps<TFieldValues, TName>) => react_jsx_runtime.JSX.Element;
+/**
+ * Hook that returns field state, IDs, and error information for the current form field.
+ * Must be used within a `FormField` component.
+ */
 declare const useFormField: () => {
     invalid: boolean;
     isDirty: boolean;
@@ -19,10 +53,15 @@ declare const useFormField: () => {
     formDescriptionId: string;
     formMessageId: string;
 };
+/** Container for a single form field, grouping label, control, description, and message. */
 declare function FormItem({ className, ...props }: React.ComponentProps<"div">): react_jsx_runtime.JSX.Element;
+/** Label for a form field that turns red on validation error. */
 declare function FormLabel({ className, ...props }: React.ComponentProps<typeof LabelPrimitive.Root>): react_jsx_runtime.JSX.Element;
+/** Slot wrapper that wires up aria attributes for the form control. */
 declare function FormControl({ ...props }: React.ComponentProps<typeof Slot>): react_jsx_runtime.JSX.Element;
+/** Helper text displayed below the form control. */
 declare function FormDescription({ className, ...props }: React.ComponentProps<"p">): react_jsx_runtime.JSX.Element;
+/** Displays the validation error message for the form field. */
 declare function FormMessage({ className, ...props }: React.ComponentProps<"p">): react_jsx_runtime.JSX.Element | null;
 
 export { Form, FormControl, FormDescription, FormField, FormItem, FormLabel, FormMessage, useFormField };

package/dist/components/form.js

@@ -1,5 +1,5 @@
-export { Form, FormControl, FormDescription, FormField, FormItem, FormLabel, FormMessage, useFormField } from '../chunk-BJO5JCFB.js';
-import '../chunk-KXZ7IND6.js';
+export { Form, FormControl, FormDescription, FormField, FormItem, FormLabel, FormMessage, useFormField } from '../chunk-LVZNNIK4.js';
+import '../chunk-P3M5TZD2.js';
 import '../chunk-DGPY4WP3.js';
 //# sourceMappingURL=form.js.map
 //# sourceMappingURL=form.js.map

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

@@ -2,8 +2,42 @@ import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as React from 'react';
 import * as HoverCardPrimitive from '@radix-ui/react-hover-card';
 
+/**
+ * Hover-activated floating card built on Radix UI HoverCard.
+ *
+ * Displays a preview card when the user hovers over a trigger element.
+ * Ideal for showing user profiles, link previews, or supplementary info
+ * without requiring a click.
+ *
+ * @example
+ * ```tsx
+ * <HoverCard>
+ *   <HoverCardTrigger asChild>
+ *     <a href="/user/john" className="underline">
+ *       @john
+ *     </a>
+ *   </HoverCardTrigger>
+ *   <HoverCardContent>
+ *     <div className="flex gap-4">
+ *       <Avatar>
+ *         <AvatarImage src="/avatars/john.png" />
+ *         <AvatarFallback>JD</AvatarFallback>
+ *       </Avatar>
+ *       <div>
+ *         <h4 className="text-sm font-semibold">John Doe</h4>
+ *         <p className="text-sm text-muted-foreground">
+ *           Software Engineer
+ *         </p>
+ *       </div>
+ *     </div>
+ *   </HoverCardContent>
+ * </HoverCard>
+ * ```
+ */
 declare function HoverCard({ ...props }: React.ComponentProps<typeof HoverCardPrimitive.Root>): react_jsx_runtime.JSX.Element;
+/** Element that shows the hover card on mouse enter. Use `asChild` to merge into your own element. */
 declare function HoverCardTrigger({ ...props }: React.ComponentProps<typeof HoverCardPrimitive.Trigger>): react_jsx_runtime.JSX.Element;
+/** Floating content panel that appears on hover. */
 declare function HoverCardContent({ className, align, sideOffset, ...props }: React.ComponentProps<typeof HoverCardPrimitive.Content>): react_jsx_runtime.JSX.Element;
 
 export { HoverCard, HoverCardContent, HoverCardTrigger };

package/dist/components/hover-card.js

@@ -1,4 +1,4 @@
-export { HoverCard, HoverCardContent, HoverCardTrigger } from '../chunk-EIF6WZAZ.js';
+export { HoverCard, HoverCardContent, HoverCardTrigger } from '../chunk-JRU2QX7T.js';
 import '../chunk-DGPY4WP3.js';
 //# sourceMappingURL=hover-card.js.map
 //# sourceMappingURL=hover-card.js.map

package/dist/components/input-otp.d.ts

@@ -2,13 +2,37 @@ import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as React from 'react';
 import { OTPInput } from 'input-otp';
 
+/**
+ * One-time password input component built on the `input-otp` library.
+ * Renders a segmented input for entering verification codes.
+ *
+ * @example
+ * ```tsx
+ * <InputOTP maxLength={6} value={otp} onChange={setOtp}>
+ *   <InputOTPGroup>
+ *     <InputOTPSlot index={0} />
+ *     <InputOTPSlot index={1} />
+ *     <InputOTPSlot index={2} />
+ *   </InputOTPGroup>
+ *   <InputOTPSeparator />
+ *   <InputOTPGroup>
+ *     <InputOTPSlot index={3} />
+ *     <InputOTPSlot index={4} />
+ *     <InputOTPSlot index={5} />
+ *   </InputOTPGroup>
+ * </InputOTP>
+ * ```
+ */
 declare function InputOTP({ className, containerClassName, ...props }: React.ComponentProps<typeof OTPInput> & {
     containerClassName?: string;
 }): react_jsx_runtime.JSX.Element;
+/** Groups adjacent OTP slots together visually. */
 declare function InputOTPGroup({ className, ...props }: React.ComponentProps<"div">): react_jsx_runtime.JSX.Element;
+/** Individual character slot within an OTP group. */
 declare function InputOTPSlot({ index, className, ...props }: React.ComponentProps<"div"> & {
     index: number;
 }): react_jsx_runtime.JSX.Element;
+/** Visual separator (dash) between OTP groups. */
 declare function InputOTPSeparator({ ...props }: React.ComponentProps<"div">): react_jsx_runtime.JSX.Element;
 
 export { InputOTP, InputOTPGroup, InputOTPSeparator, InputOTPSlot };

package/dist/components/input-otp.js

@@ -1,4 +1,4 @@
-export { InputOTP, InputOTPGroup, InputOTPSeparator, InputOTPSlot } from '../chunk-LI7CKURD.js';
+export { InputOTP, InputOTPGroup, InputOTPSeparator, InputOTPSlot } from '../chunk-RQNZDWY3.js';
 import '../chunk-DGPY4WP3.js';
 //# sourceMappingURL=input-otp.js.map
 //# sourceMappingURL=input-otp.js.map

package/dist/components/label.d.ts

@@ -1,6 +1,20 @@
 import * as React from 'react';
 import * as LabelPrimitive from '@radix-ui/react-label';
 
+type LabelProps = React.ComponentPropsWithoutRef<typeof LabelPrimitive.Root>;
+/**
+ * Accessible label for form controls, automatically associated via `htmlFor`.
+ *
+ * @example
+ * ```tsx
+ * // With an input
+ * <Label htmlFor="email">Email address</Label>
+ * <Input id="email" type="email" />
+ *
+ * // Disabled state (responds to group/peer disabled)
+ * <Label htmlFor="name">Name</Label>
+ * ```
+ */
 declare const Label: React.ForwardRefExoticComponent<Omit<LabelPrimitive.LabelProps & React.RefAttributes<HTMLLabelElement>, "ref"> & React.RefAttributes<HTMLLabelElement>>;
 
-export { Label };
+export { Label, type LabelProps };

package/dist/components/label.js

@@ -1,4 +1,4 @@
-export { Label } from '../chunk-KXZ7IND6.js';
+export { Label } from '../chunk-P3M5TZD2.js';
 import '../chunk-DGPY4WP3.js';
 //# sourceMappingURL=label.js.map
 //# sourceMappingURL=label.js.map

package/dist/components/menubar.d.ts

@@ -2,28 +2,81 @@ import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as React from 'react';
 import * as MenubarPrimitive from '@radix-ui/react-menubar';
 
+/**
+ * Horizontal menu bar component built on Radix UI Menubar.
+ *
+ * Provides a desktop-style menu bar with multiple dropdown menus.
+ * Each menu is defined by a `MenubarMenu` containing a `MenubarTrigger`
+ * and `MenubarContent` with items.
+ *
+ * @example
+ * ```tsx
+ * <Menubar>
+ *   <MenubarMenu>
+ *     <MenubarTrigger>File</MenubarTrigger>
+ *     <MenubarContent>
+ *       <MenubarItem>
+ *         New Tab
+ *         <MenubarShortcut>Ctrl+T</MenubarShortcut>
+ *       </MenubarItem>
+ *       <MenubarItem>New Window</MenubarItem>
+ *       <MenubarSeparator />
+ *       <MenubarSub>
+ *         <MenubarSubTrigger>Share</MenubarSubTrigger>
+ *         <MenubarSubContent>
+ *           <MenubarItem>Email Link</MenubarItem>
+ *           <MenubarItem>Messages</MenubarItem>
+ *         </MenubarSubContent>
+ *       </MenubarSub>
+ *     </MenubarContent>
+ *   </MenubarMenu>
+ *   <MenubarMenu>
+ *     <MenubarTrigger>Edit</MenubarTrigger>
+ *     <MenubarContent>
+ *       <MenubarItem>Undo</MenubarItem>
+ *       <MenubarItem>Redo</MenubarItem>
+ *     </MenubarContent>
+ *   </MenubarMenu>
+ * </Menubar>
+ * ```
+ */
 declare function Menubar({ className, ...props }: React.ComponentProps<typeof MenubarPrimitive.Root>): react_jsx_runtime.JSX.Element;
+/** Wraps a single menu within the menu bar, containing a trigger and content. */
 declare function MenubarMenu({ ...props }: React.ComponentProps<typeof MenubarPrimitive.Menu>): react_jsx_runtime.JSX.Element;
+/** Groups related menubar items together for accessibility. */
 declare function MenubarGroup({ ...props }: React.ComponentProps<typeof MenubarPrimitive.Group>): react_jsx_runtime.JSX.Element;
+/** Portal that renders menubar content outside the DOM hierarchy. */
 declare function MenubarPortal({ ...props }: React.ComponentProps<typeof MenubarPrimitive.Portal>): react_jsx_runtime.JSX.Element;
+/** Container for radio menubar items where only one can be selected at a time. */
 declare function MenubarRadioGroup({ ...props }: React.ComponentProps<typeof MenubarPrimitive.RadioGroup>): react_jsx_runtime.JSX.Element;
+/** Button label in the menu bar that opens its associated dropdown content on click. */
 declare function MenubarTrigger({ className, ...props }: React.ComponentProps<typeof MenubarPrimitive.Trigger>): react_jsx_runtime.JSX.Element;
+/** Floating container for menubar items, positioned below the trigger. */
 declare function MenubarContent({ className, align, alignOffset, sideOffset, ...props }: React.ComponentProps<typeof MenubarPrimitive.Content>): react_jsx_runtime.JSX.Element;
+/** Actionable menu item. Set `variant="destructive"` for dangerous actions, `inset` for left-padding alignment. */
 declare function MenubarItem({ className, inset, variant, ...props }: React.ComponentProps<typeof MenubarPrimitive.Item> & {
     inset?: boolean;
     variant?: "default" | "destructive";
 }): react_jsx_runtime.JSX.Element;
+/** Menu item with a checkbox indicator for toggling options. */
 declare function MenubarCheckboxItem({ className, children, checked, ...props }: React.ComponentProps<typeof MenubarPrimitive.CheckboxItem>): react_jsx_runtime.JSX.Element;
+/** Menu item with a radio indicator for single-selection groups. */
 declare function MenubarRadioItem({ className, children, ...props }: React.ComponentProps<typeof MenubarPrimitive.RadioItem>): react_jsx_runtime.JSX.Element;
+/** Non-interactive label used to title a group of menu items. */
 declare function MenubarLabel({ className, inset, ...props }: React.ComponentProps<typeof MenubarPrimitive.Label> & {
     inset?: boolean;
 }): react_jsx_runtime.JSX.Element;
+/** Visual divider between groups of menu items. */
 declare function MenubarSeparator({ className, ...props }: React.ComponentProps<typeof MenubarPrimitive.Separator>): react_jsx_runtime.JSX.Element;
+/** Keyboard shortcut hint displayed at the end of a menu item. */
 declare function MenubarShortcut({ className, ...props }: React.ComponentProps<"span">): react_jsx_runtime.JSX.Element;
+/** Container for a nested sub-menu within the menubar. */
 declare function MenubarSub({ ...props }: React.ComponentProps<typeof MenubarPrimitive.Sub>): react_jsx_runtime.JSX.Element;
+/** Menu item that opens a sub-menu on hover. Displays a chevron indicator. */
 declare function MenubarSubTrigger({ className, inset, children, ...props }: React.ComponentProps<typeof MenubarPrimitive.SubTrigger> & {
     inset?: boolean;
 }): react_jsx_runtime.JSX.Element;
+/** Floating container for sub-menu items. */
 declare function MenubarSubContent({ className, ...props }: React.ComponentProps<typeof MenubarPrimitive.SubContent>): react_jsx_runtime.JSX.Element;
 
 export { Menubar, MenubarCheckboxItem, MenubarContent, MenubarGroup, MenubarItem, MenubarLabel, MenubarMenu, MenubarPortal, MenubarRadioGroup, MenubarRadioItem, MenubarSeparator, MenubarShortcut, MenubarSub, MenubarSubContent, MenubarSubTrigger, MenubarTrigger };

package/dist/components/menubar.js

@@ -1,4 +1,4 @@
-export { Menubar, MenubarCheckboxItem, MenubarContent, MenubarGroup, MenubarItem, MenubarLabel, MenubarMenu, MenubarPortal, MenubarRadioGroup, MenubarRadioItem, MenubarSeparator, MenubarShortcut, MenubarSub, MenubarSubContent, MenubarSubTrigger, MenubarTrigger } from '../chunk-SABAKV4J.js';
+export { Menubar, MenubarCheckboxItem, MenubarContent, MenubarGroup, MenubarItem, MenubarLabel, MenubarMenu, MenubarPortal, MenubarRadioGroup, MenubarRadioItem, MenubarSeparator, MenubarShortcut, MenubarSub, MenubarSubContent, MenubarSubTrigger, MenubarTrigger } from '../chunk-INLM7UJC.js';
 import '../chunk-DGPY4WP3.js';
 //# sourceMappingURL=menubar.js.map
 //# sourceMappingURL=menubar.js.map

package/dist/components/navigation-menu.d.ts

@@ -3,16 +3,62 @@ import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as React from 'react';
 import * as NavigationMenuPrimitive from '@radix-ui/react-navigation-menu';
 
+/**
+ * Accessible navigation menu built on Radix UI NavigationMenu.
+ *
+ * Provides a horizontal navigation bar with dropdown content panels,
+ * suitable for site-wide navigation with rich sub-menus. Set `viewport={false}`
+ * to render content inline instead of in a shared viewport container.
+ *
+ * @example
+ * ```tsx
+ * <NavigationMenu>
+ *   <NavigationMenuList>
+ *     <NavigationMenuItem>
+ *       <NavigationMenuTrigger>Getting Started</NavigationMenuTrigger>
+ *       <NavigationMenuContent>
+ *         <ul className="grid gap-3 p-4 w-[400px]">
+ *           <li>
+ *             <NavigationMenuLink href="/docs">
+ *               <div className="font-medium">Introduction</div>
+ *               <p className="text-muted-foreground">
+ *                 Learn the basics of the component library.
+ *               </p>
+ *             </NavigationMenuLink>
+ *           </li>
+ *         </ul>
+ *       </NavigationMenuContent>
+ *     </NavigationMenuItem>
+ *     <NavigationMenuItem>
+ *       <NavigationMenuLink
+ *         className={navigationMenuTriggerStyle()}
+ *         href="/docs"
+ *       >
+ *         Documentation
+ *       </NavigationMenuLink>
+ *     </NavigationMenuItem>
+ *   </NavigationMenuList>
+ * </NavigationMenu>
+ * ```
+ */
 declare function NavigationMenu({ className, children, viewport, ...props }: React.ComponentProps<typeof NavigationMenuPrimitive.Root> & {
     viewport?: boolean;
 }): react_jsx_runtime.JSX.Element;
+/** Horizontal list container for navigation menu items. */
 declare function NavigationMenuList({ className, ...props }: React.ComponentProps<typeof NavigationMenuPrimitive.List>): react_jsx_runtime.JSX.Element;
+/** Individual navigation menu item that can contain a trigger and content or a direct link. */
 declare function NavigationMenuItem({ className, ...props }: React.ComponentProps<typeof NavigationMenuPrimitive.Item>): react_jsx_runtime.JSX.Element;
+/** Shared style variant for navigation menu trigger buttons and standalone links. Apply with `className={navigationMenuTriggerStyle()}`. */
 declare const navigationMenuTriggerStyle: (props?: class_variance_authority_types.ClassProp | undefined) => string;
+/** Button that opens the associated NavigationMenuContent dropdown. Displays a chevron indicator. */
 declare function NavigationMenuTrigger({ className, children, ...props }: React.ComponentProps<typeof NavigationMenuPrimitive.Trigger>): react_jsx_runtime.JSX.Element;
+/** Dropdown content panel revealed when a NavigationMenuTrigger is activated. */
 declare function NavigationMenuContent({ className, ...props }: React.ComponentProps<typeof NavigationMenuPrimitive.Content>): react_jsx_runtime.JSX.Element;
+/** Shared viewport container that displays the active NavigationMenuContent with animated transitions. */
 declare function NavigationMenuViewport({ className, ...props }: React.ComponentProps<typeof NavigationMenuPrimitive.Viewport>): react_jsx_runtime.JSX.Element;
+/** Accessible link element within navigation menu content. Supports `data-[active=true]` styling. */
 declare function NavigationMenuLink({ className, ...props }: React.ComponentProps<typeof NavigationMenuPrimitive.Link>): react_jsx_runtime.JSX.Element;
+/** Animated arrow indicator that tracks the active menu trigger position. */
 declare function NavigationMenuIndicator({ className, ...props }: React.ComponentProps<typeof NavigationMenuPrimitive.Indicator>): react_jsx_runtime.JSX.Element;
 
 export { NavigationMenu, NavigationMenuContent, NavigationMenuIndicator, NavigationMenuItem, NavigationMenuLink, NavigationMenuList, NavigationMenuTrigger, NavigationMenuViewport, navigationMenuTriggerStyle };

package/dist/components/navigation-menu.js

@@ -1,4 +1,4 @@
-export { NavigationMenu, NavigationMenuContent, NavigationMenuIndicator, NavigationMenuItem, NavigationMenuLink, NavigationMenuList, NavigationMenuTrigger, NavigationMenuViewport, navigationMenuTriggerStyle } from '../chunk-KXT75MXF.js';
+export { NavigationMenu, NavigationMenuContent, NavigationMenuIndicator, NavigationMenuItem, NavigationMenuLink, NavigationMenuList, NavigationMenuTrigger, NavigationMenuViewport, navigationMenuTriggerStyle } from '../chunk-YBMEQZX7.js';
 import '../chunk-DGPY4WP3.js';
 //# sourceMappingURL=navigation-menu.js.map
 //# sourceMappingURL=navigation-menu.js.map