@omnifyjp/ui 0.1.6 → 0.1.7

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,4 +1,4 @@
-export { FileUpload } from '../chunk-KRDWVQZ6.js';
+export { FileUpload } from '../chunk-UAX7UJIJ.js';
 import '../chunk-Y65FNGEE.js';
 import '../chunk-DGPY4WP3.js';
 //# 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

package/dist/components/pagination.d.ts

@@ -4,15 +4,55 @@ import { Button } from './button.js';
 import 'class-variance-authority/types';
 import 'class-variance-authority';
 
+/**
+ * Page navigation component with numbered links, previous/next buttons, and ellipsis indicators.
+ *
+ * Renders as a `<nav>` with `aria-label="pagination"` for accessibility.
+ * Compose with `PaginationContent`, `PaginationItem`, `PaginationLink`,
+ * `PaginationPrevious`, `PaginationNext`, and `PaginationEllipsis`.
+ *
+ * @example
+ * ```tsx
+ * <Pagination>
+ *   <PaginationContent>
+ *     <PaginationItem>
+ *       <PaginationPrevious href="#" />
+ *     </PaginationItem>
+ *     <PaginationItem>
+ *       <PaginationLink href="#" isActive>1</PaginationLink>
+ *     </PaginationItem>
+ *     <PaginationItem>
+ *       <PaginationLink href="#">2</PaginationLink>
+ *     </PaginationItem>
+ *     <PaginationItem>
+ *       <PaginationEllipsis />
+ *     </PaginationItem>
+ *     <PaginationItem>
+ *       <PaginationLink href="#">10</PaginationLink>
+ *     </PaginationItem>
+ *     <PaginationItem>
+ *       <PaginationNext href="#" />
+ *     </PaginationItem>
+ *   </PaginationContent>
+ * </Pagination>
+ * ```
+ */
 declare function Pagination({ className, ...props }: React.ComponentProps<"nav">): react_jsx_runtime.JSX.Element;
+/** Flex container for pagination items. Renders as a `<ul>`. */
 declare function PaginationContent({ className, ...props }: React.ComponentProps<"ul">): react_jsx_runtime.JSX.Element;
+/** List item wrapper for a single pagination element. */
 declare function PaginationItem({ ...props }: React.ComponentProps<"li">): react_jsx_runtime.JSX.Element;
 type PaginationLinkProps = {
+    /** When true, renders the link with an `outline` variant and `aria-current="page"`. */
     isActive?: boolean;
 } & Pick<React.ComponentProps<typeof Button>, "size"> & React.ComponentProps<"a">;
+/** Styled pagination link using button variants. Supports `isActive` for the current page. */
 declare function PaginationLink({ className, isActive, size, ...props }: PaginationLinkProps): react_jsx_runtime.JSX.Element;
+/** "Previous" pagination link with a left chevron icon. */
 declare function PaginationPrevious({ className, ...props }: React.ComponentProps<typeof PaginationLink>): react_jsx_runtime.JSX.Element;
+/** "Next" pagination link with a right chevron icon. */
 declare function PaginationNext({ className, ...props }: React.ComponentProps<typeof PaginationLink>): react_jsx_runtime.JSX.Element;
+/** Ellipsis indicator for omitted page numbers. Renders a `MoreHorizontal` icon with screen-reader text. */
 declare function PaginationEllipsis({ className, ...props }: React.ComponentProps<"span">): react_jsx_runtime.JSX.Element;
 
 export { Pagination, PaginationContent, PaginationEllipsis, PaginationItem, PaginationLink, PaginationNext, PaginationPrevious };

package/dist/components/pagination.js

@@ -1,4 +1,4 @@
-export { Pagination, PaginationContent, PaginationEllipsis, PaginationItem, PaginationLink, PaginationNext, PaginationPrevious } from '../chunk-QMABUSSD.js';
+export { Pagination, PaginationContent, PaginationEllipsis, PaginationItem, PaginationLink, PaginationNext, PaginationPrevious } from '../chunk-ZHP73HKU.js';
 import '../chunk-Y65FNGEE.js';
 import '../chunk-DGPY4WP3.js';
 //# sourceMappingURL=pagination.js.map

package/dist/components/permission-grid.d.ts

@@ -1,23 +1,38 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 
+/** A single permission action (e.g. "view", "create", "delete"). */
 interface PermissionDefinition {
+    /** Unique key for this permission (e.g. "view", "create"). Used to build `module:action` IDs. */
     key: string;
+    /** Display label shown in the column header. */
     label: string;
 }
+/** A module (row) in the permission grid containing its available permission actions. */
 interface PermissionModule {
+    /** Unique key for this module (e.g. "users", "projects"). Used to build `module:action` IDs. */
     key: string;
+    /** Display label shown in the first column. */
     label: string;
+    /** List of permission actions available for this module. */
     permissions: PermissionDefinition[];
 }
+/** Localizable labels for the permission grid. */
 interface PermissionGridLabels {
+    /** Header text for the module name column. */
     moduleHeader: string;
+    /** Header text for the "Select All" column. */
     selectAll: string;
 }
 interface PermissionGridProps {
+    /** List of modules (rows) to display, each with its available permission actions. */
     modules: PermissionModule[];
+    /** Currently selected permission IDs in `module:action` format (e.g. `["users:view", "users:create"]`). */
     selectedIds: string[];
+    /** Callback with the updated list of selected permission IDs when checkboxes change. */
     onChange?: (ids: string[]) => void;
+    /** When true, all checkboxes are disabled and the "Select All" column is hidden. Defaults to `false`. */
     readOnly?: boolean;
+    /** Localizable UI labels with English defaults. */
     labels?: Partial<PermissionGridLabels>;
 }
 /**
@@ -25,6 +40,28 @@ interface PermissionGridProps {
  * Used internally and exposed for consumers to construct IDs.
  */
 declare function buildPermissionId(moduleKey: string, permissionKey: string): string;
+/**
+ * Table-based permission matrix with modules as rows and permission actions
+ * as columns. Each cell is a checkbox. Permission IDs use `module:action`
+ * format (built via {@link buildPermissionId}). Includes per-row "Select All"
+ * toggles. Supports read-only mode.
+ *
+ * @example
+ * ```tsx
+ * const modules: PermissionModule[] = [
+ *   { key: "users", label: "Users", permissions: [
+ *     { key: "view", label: "View" },
+ *     { key: "create", label: "Create" },
+ *   ]},
+ * ];
+ *
+ * <PermissionGrid
+ *   modules={modules}
+ *   selectedIds={["users:view"]}
+ *   onChange={(ids) => setPermissions(ids)}
+ * />
+ * ```
+ */
 declare function PermissionGrid({ modules, selectedIds, onChange, readOnly, labels: labelOverrides, }: PermissionGridProps): react_jsx_runtime.JSX.Element;
 
 export { type PermissionDefinition, PermissionGrid, type PermissionGridLabels, type PermissionGridProps, type PermissionModule, buildPermissionId };

package/dist/components/permission-grid.js

@@ -1,5 +1,5 @@
-export { PermissionGrid, buildPermissionId } from '../chunk-RVJDDGQW.js';
-import '../chunk-PPZSGU2L.js';
+export { PermissionGrid, buildPermissionId } from '../chunk-TJMK2KBE.js';
+import '../chunk-WL4ZO2H3.js';
 import '../chunk-DGPY4WP3.js';
 //# sourceMappingURL=permission-grid.js.map
 //# sourceMappingURL=permission-grid.js.map

package/dist/components/popover.d.ts

@@ -2,9 +2,36 @@ import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as React from 'react';
 import * as PopoverPrimitive from '@radix-ui/react-popover';
 
+/**
+ * Floating popover component built on Radix UI Popover.
+ *
+ * Displays rich content in a floating panel anchored to a trigger element.
+ * Supports controlled (`open`/`onOpenChange`) and uncontrolled usage.
+ * Content is portaled and positioned automatically.
+ *
+ * @example
+ * ```tsx
+ * <Popover>
+ *   <PopoverTrigger asChild>
+ *     <Button variant="outline">Open Popover</Button>
+ *   </PopoverTrigger>
+ *   <PopoverContent>
+ *     <div className="space-y-2">
+ *       <h4 className="font-medium text-sm">Dimensions</h4>
+ *       <p className="text-sm text-muted-foreground">
+ *         Set the dimensions for the layer.
+ *       </p>
+ *     </div>
+ *   </PopoverContent>
+ * </Popover>
+ * ```
+ */
 declare function Popover({ ...props }: React.ComponentProps<typeof PopoverPrimitive.Root>): react_jsx_runtime.JSX.Element;
+/** Element that toggles the popover when clicked. Use `asChild` to merge into your own button. */
 declare function PopoverTrigger({ ...props }: React.ComponentProps<typeof PopoverPrimitive.Trigger>): react_jsx_runtime.JSX.Element;
+/** Floating content panel positioned relative to the trigger. */
 declare function PopoverContent({ className, align, sideOffset, ...props }: React.ComponentProps<typeof PopoverPrimitive.Content>): react_jsx_runtime.JSX.Element;
+/** Custom anchor element for positioning the popover content relative to a different element than the trigger. */
 declare function PopoverAnchor({ ...props }: React.ComponentProps<typeof PopoverPrimitive.Anchor>): react_jsx_runtime.JSX.Element;
 
 export { Popover, PopoverAnchor, PopoverContent, PopoverTrigger };

package/dist/components/popover.js

@@ -1,4 +1,4 @@
-export { Popover, PopoverAnchor, PopoverContent, PopoverTrigger } from '../chunk-AZARDPXB.js';
+export { Popover, PopoverAnchor, PopoverContent, PopoverTrigger } from '../chunk-C34KSTWA.js';
 import '../chunk-DGPY4WP3.js';
 //# sourceMappingURL=popover.js.map
 //# sourceMappingURL=popover.js.map

package/dist/components/progress.d.ts

@@ -2,6 +2,19 @@ import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as React from 'react';
 import * as ProgressPrimitive from '@radix-ui/react-progress';
 
-declare function Progress({ className, value, ...props }: React.ComponentProps<typeof ProgressPrimitive.Root>): react_jsx_runtime.JSX.Element;
+type ProgressProps = React.ComponentProps<typeof ProgressPrimitive.Root>;
+/**
+ * Horizontal bar that indicates the completion progress of a task or operation.
+ *
+ * @example
+ * ```tsx
+ * // Basic usage (65% complete)
+ * <Progress value={65} />
+ *
+ * // With custom styling
+ * <Progress value={40} className="h-3" />
+ * ```
+ */
+declare function Progress({ className, value, ...props }: ProgressProps): react_jsx_runtime.JSX.Element;
 
-export { Progress };
+export { Progress, type ProgressProps };

package/dist/components/progress.js

@@ -1,4 +1,4 @@
-export { Progress } from '../chunk-L46XUK4O.js';
+export { Progress } from '../chunk-R2CDE5DO.js';
 import '../chunk-DGPY4WP3.js';
 //# sourceMappingURL=progress.js.map
 //# sourceMappingURL=progress.js.map