@omnifyjp/ui 0.1.5 → 0.1.7

package/dist/components/alert-dialog.js

@@ -1,5 +1,5 @@
-export { AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogOverlay, AlertDialogPortal, AlertDialogTitle, AlertDialogTrigger } from '../chunk-RSHV4SNK.js';
-import '../chunk-3BB6UBX4.js';
+export { AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogOverlay, AlertDialogPortal, AlertDialogTitle, AlertDialogTrigger } from '../chunk-YE7EHQ6P.js';
+import '../chunk-Y65FNGEE.js';
 import '../chunk-DGPY4WP3.js';
 //# sourceMappingURL=alert-dialog.js.map
 //# sourceMappingURL=alert-dialog.js.map

package/dist/components/alert.d.ts

@@ -3,11 +3,40 @@ import * as class_variance_authority_types from 'class-variance-authority/types'
 import * as React from 'react';
 import { VariantProps } from 'class-variance-authority';
 
+/** Style variants for the Alert component. Supports `"default"` and `"destructive"` variants. */
 declare const alertVariants: (props?: ({
     variant?: "default" | "destructive" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
+/**
+ * Static alert banner for displaying important messages.
+ *
+ * Renders an inline callout with an optional icon, title, and description.
+ * Use `variant="destructive"` for error or warning messages.
+ * Unlike AlertDialog, this is not a modal -- it renders inline in the page.
+ *
+ * @example
+ * ```tsx
+ * <Alert>
+ *   <InfoIcon className="size-4" />
+ *   <AlertTitle>Heads up!</AlertTitle>
+ *   <AlertDescription>
+ *     You can add components to your app using the CLI.
+ *   </AlertDescription>
+ * </Alert>
+ *
+ * <Alert variant="destructive">
+ *   <AlertCircleIcon className="size-4" />
+ *   <AlertTitle>Error</AlertTitle>
+ *   <AlertDescription>
+ *     Your session has expired. Please log in again.
+ *   </AlertDescription>
+ * </Alert>
+ * ```
+ */
 declare function Alert({ className, variant, ...props }: React.ComponentProps<"div"> & VariantProps<typeof alertVariants>): react_jsx_runtime.JSX.Element;
+/** Bold title text within an Alert. Rendered in the second grid column when an icon is present. */
 declare function AlertTitle({ className, ...props }: React.ComponentProps<"div">): react_jsx_runtime.JSX.Element;
+/** Descriptive body text within an Alert, rendered below the title. */
 declare function AlertDescription({ className, ...props }: React.ComponentProps<"div">): react_jsx_runtime.JSX.Element;
 
 export { Alert, AlertDescription, AlertTitle };

package/dist/components/alert.js

@@ -1,4 +1,4 @@
-export { Alert, AlertDescription, AlertTitle } from '../chunk-FBNG2KGO.js';
+export { Alert, AlertDescription, AlertTitle } from '../chunk-L6K7UH3O.js';
 import '../chunk-DGPY4WP3.js';
 //# sourceMappingURL=alert.js.map
 //# sourceMappingURL=alert.js.map

package/dist/components/aspect-ratio.d.ts

@@ -1,6 +1,23 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as AspectRatioPrimitive from '@radix-ui/react-aspect-ratio';
 
+/**
+ * Maintains a consistent width-to-height ratio for its content.
+ *
+ * Useful for images, videos, and maps that need to preserve their aspect ratio
+ * across different viewport sizes. Built on Radix AspectRatio.
+ *
+ * @example
+ * ```tsx
+ * <AspectRatio ratio={16 / 9}>
+ *   <img
+ *     src="/hero.jpg"
+ *     alt="Hero image"
+ *     className="h-full w-full rounded-md object-cover"
+ *   />
+ * </AspectRatio>
+ * ```
+ */
 declare function AspectRatio({ ...props }: React.ComponentProps<typeof AspectRatioPrimitive.Root>): react_jsx_runtime.JSX.Element;
 
 export { AspectRatio };

package/dist/components/aspect-ratio.js

@@ -1,3 +1,3 @@
-export { AspectRatio } from '../chunk-DIS42JLG.js';
+export { AspectRatio } from '../chunk-35DNN46W.js';
 //# sourceMappingURL=aspect-ratio.js.map
 //# sourceMappingURL=aspect-ratio.js.map

package/dist/components/avatar.d.ts

@@ -2,8 +2,47 @@ import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as React from 'react';
 import * as AvatarPrimitive from '@radix-ui/react-avatar';
 
-declare function Avatar({ className, ...props }: React.ComponentProps<typeof AvatarPrimitive.Root>): react_jsx_runtime.JSX.Element;
-declare function AvatarImage({ className, ...props }: React.ComponentProps<typeof AvatarPrimitive.Image>): react_jsx_runtime.JSX.Element;
-declare function AvatarFallback({ className, ...props }: React.ComponentProps<typeof AvatarPrimitive.Fallback>): react_jsx_runtime.JSX.Element;
+type AvatarProps = React.ComponentProps<typeof AvatarPrimitive.Root>;
+/**
+ * Circular container for user profile images or initials.
+ * Use with {@link AvatarImage} and {@link AvatarFallback} for graceful loading.
+ *
+ * @example
+ * ```tsx
+ * <Avatar>
+ *   <AvatarImage src="/avatar.jpg" alt="User" />
+ *   <AvatarFallback>JD</AvatarFallback>
+ * </Avatar>
+ *
+ * // Custom size
+ * <Avatar className="size-8">
+ *   <AvatarImage src="/small.jpg" alt="User" />
+ *   <AvatarFallback>U</AvatarFallback>
+ * </Avatar>
+ * ```
+ */
+declare function Avatar({ className, ...props }: AvatarProps): react_jsx_runtime.JSX.Element;
+type AvatarImageProps = React.ComponentProps<typeof AvatarPrimitive.Image>;
+/**
+ * Image element rendered inside an {@link Avatar}. Falls back to
+ * {@link AvatarFallback} when the image fails to load.
+ *
+ * @example
+ * ```tsx
+ * <AvatarImage src="/photo.jpg" alt="Jane Doe" />
+ * ```
+ */
+declare function AvatarImage({ className, ...props }: AvatarImageProps): react_jsx_runtime.JSX.Element;
+type AvatarFallbackProps = React.ComponentProps<typeof AvatarPrimitive.Fallback>;
+/**
+ * Fallback content displayed while the {@link AvatarImage} is loading or
+ * if it fails. Typically shows user initials (max 2 characters).
+ *
+ * @example
+ * ```tsx
+ * <AvatarFallback>JD</AvatarFallback>
+ * ```
+ */
+declare function AvatarFallback({ className, ...props }: AvatarFallbackProps): react_jsx_runtime.JSX.Element;
 
-export { Avatar, AvatarFallback, AvatarImage };
+export { Avatar, AvatarFallback, type AvatarFallbackProps, AvatarImage, type AvatarImageProps, type AvatarProps };

package/dist/components/avatar.js

@@ -1,4 +1,4 @@
-export { Avatar, AvatarFallback, AvatarImage } from '../chunk-Z47W426M.js';
+export { Avatar, AvatarFallback, AvatarImage } from '../chunk-67YUL2ZS.js';
 import '../chunk-DGPY4WP3.js';
 //# sourceMappingURL=avatar.js.map
 //# sourceMappingURL=avatar.js.map

package/dist/components/badge.d.ts

@@ -6,8 +6,24 @@ import { VariantProps } from 'class-variance-authority';
 declare const badgeVariants: (props?: ({
     variant?: "default" | "destructive" | "outline" | "secondary" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
-declare function Badge({ className, variant, asChild, ...props }: React.ComponentProps<"span"> & VariantProps<typeof badgeVariants> & {
+interface BadgeProps extends React.ComponentProps<"span">, VariantProps<typeof badgeVariants> {
+    /** Render as a child component using Radix Slot. @default false */
     asChild?: boolean;
-}): react_jsx_runtime.JSX.Element;
+}
+/**
+ * Inline status descriptor for categorization and metadata display.
+ *
+ * @example
+ * ```tsx
+ * // Basic usage
+ * <Badge>New</Badge>
+ *
+ * // With variants
+ * <Badge variant="secondary">Draft</Badge>
+ * <Badge variant="destructive">Error</Badge>
+ * <Badge variant="outline">v1.0.0</Badge>
+ * ```
+ */
+declare function Badge({ className, variant, asChild, ...props }: BadgeProps): react_jsx_runtime.JSX.Element;
 
-export { Badge, badgeVariants };
+export { Badge, type BadgeProps, badgeVariants };

package/dist/components/badge.js

@@ -1,4 +1,4 @@
-export { Badge, badgeVariants } from '../chunk-3TGN2DFB.js';
+export { Badge, badgeVariants } from '../chunk-OBZQTY3H.js';
 import '../chunk-DGPY4WP3.js';
 //# sourceMappingURL=badge.js.map
 //# sourceMappingURL=badge.js.map

package/dist/components/breadcrumb.d.ts

@@ -1,14 +1,50 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as React from 'react';
 
+/**
+ * Navigation breadcrumb trail showing the current page hierarchy.
+ *
+ * Renders as a `<nav>` with `aria-label="breadcrumb"` for accessibility.
+ * Use `BreadcrumbSeparator` between items (defaults to a chevron icon)
+ * and `BreadcrumbEllipsis` for collapsed intermediate items.
+ *
+ * @example
+ * ```tsx
+ * <Breadcrumb>
+ *   <BreadcrumbList>
+ *     <BreadcrumbItem>
+ *       <BreadcrumbLink href="/">Home</BreadcrumbLink>
+ *     </BreadcrumbItem>
+ *     <BreadcrumbSeparator />
+ *     <BreadcrumbItem>
+ *       <BreadcrumbLink href="/projects">Projects</BreadcrumbLink>
+ *     </BreadcrumbItem>
+ *     <BreadcrumbSeparator />
+ *     <BreadcrumbItem>
+ *       <BreadcrumbPage>Current Project</BreadcrumbPage>
+ *     </BreadcrumbItem>
+ *   </BreadcrumbList>
+ * </Breadcrumb>
+ * ```
+ */
 declare function Breadcrumb({ ...props }: React.ComponentProps<"nav">): react_jsx_runtime.JSX.Element;
+/** Ordered list container for breadcrumb items. Handles wrapping and spacing. */
 declare function BreadcrumbList({ className, ...props }: React.ComponentProps<"ol">): react_jsx_runtime.JSX.Element;
+/** Individual breadcrumb list item wrapping a link or page indicator. */
 declare function BreadcrumbItem({ className, ...props }: React.ComponentProps<"li">): react_jsx_runtime.JSX.Element;
+/**
+ * Clickable breadcrumb link. Set `asChild` to render a custom element (e.g., React Router `Link`).
+ *
+ * @param asChild - When true, renders the child element instead of an `<a>` tag.
+ */
 declare function BreadcrumbLink({ asChild, className, ...props }: React.ComponentProps<"a"> & {
     asChild?: boolean;
 }): react_jsx_runtime.JSX.Element;
+/** Non-interactive breadcrumb label for the current page. Rendered with `aria-current="page"`. */
 declare function BreadcrumbPage({ className, ...props }: React.ComponentProps<"span">): react_jsx_runtime.JSX.Element;
+/** Visual separator between breadcrumb items. Defaults to a `ChevronRight` icon; pass custom children to override. */
 declare function BreadcrumbSeparator({ children, className, ...props }: React.ComponentProps<"li">): react_jsx_runtime.JSX.Element;
+/** Ellipsis indicator for collapsed breadcrumb items. Renders a `MoreHorizontal` icon with screen-reader text. */
 declare function BreadcrumbEllipsis({ className, ...props }: React.ComponentProps<"span">): react_jsx_runtime.JSX.Element;
 
 export { Breadcrumb, BreadcrumbEllipsis, BreadcrumbItem, BreadcrumbLink, BreadcrumbList, BreadcrumbPage, BreadcrumbSeparator };

package/dist/components/breadcrumb.js

@@ -1,4 +1,4 @@
-export { Breadcrumb, BreadcrumbEllipsis, BreadcrumbItem, BreadcrumbLink, BreadcrumbList, BreadcrumbPage, BreadcrumbSeparator } from '../chunk-WAPGZIAL.js';
+export { Breadcrumb, BreadcrumbEllipsis, BreadcrumbItem, BreadcrumbLink, BreadcrumbList, BreadcrumbPage, BreadcrumbSeparator } from '../chunk-7RMTPT6O.js';
 import '../chunk-DGPY4WP3.js';
 //# sourceMappingURL=breadcrumb.js.map
 //# sourceMappingURL=breadcrumb.js.map

package/dist/components/button.d.ts

@@ -6,12 +6,52 @@ declare const buttonVariants: (props?: ({
     variant?: "link" | "default" | "destructive" | "outline" | "secondary" | "ghost" | null | undefined;
     size?: "default" | "xs" | "sm" | "lg" | "xl" | "icon" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
-declare const Button: React.ForwardRefExoticComponent<Omit<React.ClassAttributes<HTMLButtonElement> & React.ButtonHTMLAttributes<HTMLButtonElement> & VariantProps<(props?: ({
-    variant?: "link" | "default" | "destructive" | "outline" | "secondary" | "ghost" | null | undefined;
-    size?: "default" | "xs" | "sm" | "lg" | "xl" | "icon" | null | undefined;
-} & class_variance_authority_types.ClassProp) | undefined) => string> & {
+interface ButtonProps extends React.ComponentProps<"button">, VariantProps<typeof buttonVariants> {
+    /**
+     * Render as a child component using Radix Slot.
+     * When `true`, the button merges its props onto its single child element.
+     * @default false
+     */
     asChild?: boolean;
+    /**
+     * Make the button take the full width of its container.
+     * Equivalent to Ant Design's `block` prop.
+     * @default false
+     * @example
+     * ```tsx
+     * <Button block>Full Width</Button>
+     * <Button size="xl" block>Login</Button>
+     * ```
+     */
     block?: boolean;
-}, "ref"> & React.RefAttributes<HTMLButtonElement>>;
+}
+/**
+ * Button component with multiple variants and sizes.
+ *
+ * @example
+ * ```tsx
+ * // Default button
+ * <Button>Click me</Button>
+ *
+ * // Variants
+ * <Button variant="destructive">Delete</Button>
+ * <Button variant="outline">Cancel</Button>
+ * <Button variant="secondary">Secondary</Button>
+ * <Button variant="ghost">Ghost</Button>
+ * <Button variant="link">Link</Button>
+ *
+ * // Sizes: xs (24px) | sm (28px) | default (32px) | lg (36px) | xl (44px) | icon (32x32)
+ * <Button size="xs">Tiny</Button>
+ * <Button size="xl">Large</Button>
+ * <Button size="icon"><PlusIcon /></Button>
+ *
+ * // Full width (block)
+ * <Button block>Full Width</Button>
+ *
+ * // As child (slot)
+ * <Button asChild><a href="/home">Home</a></Button>
+ * ```
+ */
+declare const Button: React.ForwardRefExoticComponent<Omit<ButtonProps, "ref"> & React.RefAttributes<HTMLButtonElement>>;
 
-export { Button, buttonVariants };
+export { Button, type ButtonProps, buttonVariants };

package/dist/components/button.js

@@ -1,4 +1,4 @@
-export { Button, buttonVariants } from '../chunk-3BB6UBX4.js';
+export { Button, buttonVariants } from '../chunk-Y65FNGEE.js';
 import '../chunk-DGPY4WP3.js';
 //# sourceMappingURL=button.js.map
 //# sourceMappingURL=button.js.map

package/dist/components/calendar-category-badge.d.ts

@@ -1,10 +1,24 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 
 interface CalendarCategoryBadgeProps {
+    /** The category key (e.g. "meeting", "deadline"). Determines the badge color from built-in or custom styles. */
     category: string;
+    /** Override display label. Defaults to the raw category key. */
     label?: string;
+    /** Custom className styles per category key, merged with built-in defaults. */
     styles?: Record<string, string>;
 }
+/**
+ * Color-coded badge for calendar event categories. Ships with built-in styles
+ * for meeting (blue), deadline (red), reminder (amber), personal (purple), and
+ * holiday (green). Custom categories can be styled via the `styles` prop.
+ *
+ * @example
+ * ```tsx
+ * <CalendarCategoryBadge category="meeting" label="Meeting" />
+ * <CalendarCategoryBadge category="custom" label="Custom" styles={{ custom: "bg-pink-50 text-pink-600" }} />
+ * ```
+ */
 declare function CalendarCategoryBadge({ category, label, styles }: CalendarCategoryBadgeProps): react_jsx_runtime.JSX.Element;
 
 export { CalendarCategoryBadge, type CalendarCategoryBadgeProps };

package/dist/components/calendar-category-badge.js

@@ -1,5 +1,5 @@
-export { CalendarCategoryBadge } from '../chunk-TEYOLOZY.js';
-import '../chunk-3TGN2DFB.js';
+export { CalendarCategoryBadge } from '../chunk-V4ZOPVXV.js';
+import '../chunk-OBZQTY3H.js';
 import '../chunk-DGPY4WP3.js';
 //# sourceMappingURL=calendar-category-badge.js.map
 //# sourceMappingURL=calendar-category-badge.js.map

package/dist/components/calendar-event-chip.d.ts

@@ -1,18 +1,41 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 
+/** Event data shape required by CalendarEventChip. */
 interface CalendarEventChipEvent {
+    /** Unique event identifier. */
     id: string;
+    /** Display title of the event. */
     title: string;
+    /** Event start date/time. */
     start: Date;
+    /** Event end date/time. */
     end: Date;
+    /** Whether this is an all-day event. When true, time is not displayed. */
     allDay?: boolean;
+    /** CSS color string used for the chip background, text, and left border. */
     color: string;
 }
 interface CalendarEventChipProps {
+    /** The event to display. */
     event: CalendarEventChipEvent;
+    /** Use compact layout with tighter line-height. Defaults to `false`. */
     compact?: boolean;
+    /** Callback when the chip is clicked. */
     onClick?: (event: CalendarEventChipEvent) => void;
 }
+/**
+ * Small colored chip representing a calendar event. Shows the event title
+ * with a colored left border and tinted background. Optionally displays
+ * the start time for non-all-day events.
+ *
+ * @example
+ * ```tsx
+ * <CalendarEventChip
+ *   event={{ id: "1", title: "Standup", start: new Date(), end: new Date(), color: "#3b82f6" }}
+ *   onClick={(e) => openDetail(e.id)}
+ * />
+ * ```
+ */
 declare function CalendarEventChip({ event, compact, onClick }: CalendarEventChipProps): react_jsx_runtime.JSX.Element;
 
 export { CalendarEventChip, type CalendarEventChipEvent, type CalendarEventChipProps };

package/dist/components/calendar-event-chip.js

@@ -1,4 +1,4 @@
-export { CalendarEventChip } from '../chunk-5WCL47ZW.js';
+export { CalendarEventChip } from '../chunk-TTH7TWVX.js';
 import '../chunk-DGPY4WP3.js';
 //# sourceMappingURL=calendar-event-chip.js.map
 //# sourceMappingURL=calendar-event-chip.js.map

package/dist/components/calendar-event-sheet.d.ts

@@ -1,31 +1,68 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 
+/** Extended event data shape for the detail sheet, including description, location, and attendees. */
 interface CalendarEventSheetEvent {
+    /** Unique event identifier. */
     id: string;
+    /** Display title of the event. */
     title: string;
+    /** Optional long description or notes for the event. */
     description?: string;
+    /** Event start date/time. */
     start: Date;
+    /** Event end date/time. */
     end: Date;
+    /** Whether this is an all-day event. */
     allDay?: boolean;
+    /** CSS color string for the event. */
     color: string;
+    /** Category key (e.g. "meeting", "deadline") used by CalendarCategoryBadge. */
     category: string;
+    /** Optional location string. */
     location?: string;
+    /** Optional list of attendee email addresses. */
     attendees?: string[];
 }
+/** Localizable labels for the event detail sheet. All have English defaults. */
 interface CalendarEventSheetLabels {
+    /** Text displayed for all-day events instead of a time range. */
     allDay?: string;
+    /** Heading text for the attendees section. */
     attendees?: string;
+    /** Label for the delete button. */
     delete?: string;
 }
 interface CalendarEventSheetProps {
+    /** The event to display, or `null` to render nothing. */
     event: CalendarEventSheetEvent | null;
+    /** Whether the sheet is open. */
     open: boolean;
+    /** Callback to toggle the sheet open state. */
     onOpenChange: (open: boolean) => void;
+    /** Optional callback when the delete button is clicked. Receives the event id. */
     onDelete?: (id: string) => void;
+    /** Override display label for the category badge. */
     categoryLabel?: string;
+    /** Custom className styles per category key for the CalendarCategoryBadge. */
     categoryStyles?: Record<string, string>;
+    /** Localizable UI labels with English defaults. */
     labels?: CalendarEventSheetLabels;
 }
+/**
+ * Side sheet that displays full event details including title, category badge,
+ * description, date/time, location, attendees, and a delete action.
+ * Built on top of the Sheet component.
+ *
+ * @example
+ * ```tsx
+ * <CalendarEventSheet
+ *   event={selectedEvent}
+ *   open={sheetOpen}
+ *   onOpenChange={setSheetOpen}
+ *   onDelete={(id) => removeEvent(id)}
+ * />
+ * ```
+ */
 declare function CalendarEventSheet({ event, open, onOpenChange, onDelete, categoryLabel, categoryStyles, labels: labelsProp, }: CalendarEventSheetProps): react_jsx_runtime.JSX.Element | null;
 
 export { CalendarEventSheet, type CalendarEventSheetEvent, type CalendarEventSheetLabels, type CalendarEventSheetProps };

package/dist/components/calendar-event-sheet.js

@@ -1,9 +1,9 @@
-export { CalendarEventSheet } from '../chunk-7W3WTMUH.js';
-import '../chunk-KOGOYUEE.js';
-import '../chunk-TEYOLOZY.js';
-import '../chunk-ONAUEREV.js';
-import '../chunk-3BB6UBX4.js';
-import '../chunk-3TGN2DFB.js';
+export { CalendarEventSheet } from '../chunk-WNKEQCXM.js';
+import '../chunk-JLTBUACL.js';
+import '../chunk-V4ZOPVXV.js';
+import '../chunk-PGWNOZDX.js';
+import '../chunk-Y65FNGEE.js';
+import '../chunk-OBZQTY3H.js';
 import '../chunk-DGPY4WP3.js';
 //# sourceMappingURL=calendar-event-sheet.js.map
 //# sourceMappingURL=calendar-event-sheet.js.map

package/dist/components/calendar-mini.d.ts

@@ -1,29 +1,65 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 
+/** A category that can be toggled on/off in the mini calendar's filter section. */
 interface CalendarCategory {
+    /** Unique key for this category. */
     key: string;
+    /** CSS color string used for the category dot. */
     color: string;
+    /** Display label for the category. */
     label: string;
 }
+/** Localizable labels for the mini calendar. All have English defaults. */
 interface CalendarMiniLabels {
+    /** Label for Sunday column header. */
     sun?: string;
+    /** Label for Monday column header. */
     mon?: string;
+    /** Label for Tuesday column header. */
     tue?: string;
+    /** Label for Wednesday column header. */
     wed?: string;
+    /** Label for Thursday column header. */
     thu?: string;
+    /** Label for Friday column header. */
     fri?: string;
+    /** Label for Saturday column header. */
     sat?: string;
+    /** Heading text for the categories filter section. */
     categories?: string;
 }
 interface CalendarMiniProps {
+    /** The month to display (any date within the target month). */
     currentDate: Date;
+    /** The currently selected date, highlighted with primary color. */
     selectedDate: Date;
+    /** Callback when a day cell is clicked. */
     onSelectDate: (date: Date) => void;
+    /** Optional list of event categories for the filter section. */
     categories?: CalendarCategory[];
+    /** Keys of currently enabled categories. */
     enabledCategories?: string[];
+    /** Callback when a category checkbox is toggled. */
     onToggleCategory?: (key: string) => void;
+    /** Localizable UI labels with English defaults. */
     labels?: CalendarMiniLabels;
 }
+/**
+ * Compact month calendar with optional category filters. Designed for sidebar
+ * placement in calendar views. Locale-agnostic via the `labels` prop.
+ *
+ * @example
+ * ```tsx
+ * <CalendarMini
+ *   currentDate={new Date()}
+ *   selectedDate={selectedDate}
+ *   onSelectDate={setSelectedDate}
+ *   categories={[{ key: "meeting", color: "#3b82f6", label: "Meeting" }]}
+ *   enabledCategories={["meeting"]}
+ *   onToggleCategory={(key) => toggle(key)}
+ * />
+ * ```
+ */
 declare function CalendarMini({ currentDate, selectedDate, onSelectDate, categories, enabledCategories, onToggleCategory, labels: labelsProp, }: CalendarMiniProps): react_jsx_runtime.JSX.Element;
 
 export { type CalendarCategory, CalendarMini, type CalendarMiniLabels, type CalendarMiniProps };

package/dist/components/calendar-mini.js

@@ -1,6 +1,6 @@
-export { CalendarMini } from '../chunk-CESZTYQQ.js';
-import '../chunk-PPZSGU2L.js';
-import '../chunk-ONAUEREV.js';
+export { CalendarMini } from '../chunk-KTBOZ4NE.js';
+import '../chunk-WL4ZO2H3.js';
+import '../chunk-PGWNOZDX.js';
 import '../chunk-DGPY4WP3.js';
 //# sourceMappingURL=calendar-mini.js.map
 //# sourceMappingURL=calendar-mini.js.map

package/dist/components/calendar-toolbar.d.ts

@@ -1,25 +1,58 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 
+/** Supported calendar view modes. */
 type CalendarView = 'month' | 'week' | 'day';
+/** Localizable labels for the calendar toolbar. All have English defaults. */
 interface CalendarToolbarLabels {
+    /** Label for the "Today" button. */
     today?: string;
+    /** Label for the "Month" view toggle. */
     month?: string;
+    /** Label for the "Week" view toggle. */
     week?: string;
+    /** Label for the "Day" view toggle. */
     day?: string;
+    /** Label for the "Create Event" button. */
     createEvent?: string;
 }
 interface CalendarToolbarProps {
+    /** The date currently being viewed. Used for the title display. */
     currentDate: Date;
+    /** The active calendar view mode. */
     view: CalendarView;
+    /** Callback when the user switches between month/week/day views. */
     onViewChange: (view: CalendarView) => void;
+    /** Navigate to the previous period. */
     onPrev: () => void;
+    /** Navigate to the next period. */
     onNext: () => void;
+    /** Navigate to today. */
     onToday: () => void;
+    /** Optional callback for the "Create Event" button. Button is hidden when omitted. */
     onCreateEvent?: () => void;
+    /** Localizable UI labels with English defaults. */
     labels?: CalendarToolbarLabels;
-    /** date-fns format string for the title */
+    /** date-fns format string for the title. Defaults to `"MMMM yyyy"` or `"EEEE, MMMM d, yyyy"` for day view. */
     titleFormat?: string;
 }
+/**
+ * Toolbar for calendar views with navigation controls (prev/next/today),
+ * view mode toggle (month/week/day), and an optional "Create Event" button.
+ * Locale-agnostic via the `labels` prop.
+ *
+ * @example
+ * ```tsx
+ * <CalendarToolbar
+ *   currentDate={currentDate}
+ *   view="month"
+ *   onViewChange={setView}
+ *   onPrev={handlePrev}
+ *   onNext={handleNext}
+ *   onToday={handleToday}
+ *   onCreateEvent={() => setDialogOpen(true)}
+ * />
+ * ```
+ */
 declare function CalendarToolbar({ currentDate, view, onViewChange, onPrev, onNext, onToday, onCreateEvent, labels: labelsProp, titleFormat: titleFormatProp, }: CalendarToolbarProps): react_jsx_runtime.JSX.Element;
 
 export { CalendarToolbar, type CalendarToolbarLabels, type CalendarToolbarProps, type CalendarView };

package/dist/components/calendar-toolbar.js

@@ -1,7 +1,7 @@
-export { CalendarToolbar } from '../chunk-ZMHZH572.js';
-import '../chunk-OHBCYKNT.js';
-import '../chunk-725ICC47.js';
-import '../chunk-3BB6UBX4.js';
+export { CalendarToolbar } from '../chunk-YT3W2URB.js';
+import '../chunk-ZPMXRW2A.js';
+import '../chunk-NU56GKGM.js';
+import '../chunk-Y65FNGEE.js';
 import '../chunk-DGPY4WP3.js';
 //# sourceMappingURL=calendar-toolbar.js.map
 //# sourceMappingURL=calendar-toolbar.js.map

package/dist/components/calendar.d.ts

@@ -2,6 +2,18 @@ import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as React from 'react';
 import { DayPicker } from 'react-day-picker';
 
+/**
+ * Date picker calendar built on `react-day-picker`. Supports single, multiple,
+ * and range selection modes. Styled with Shadcn UI conventions.
+ *
+ * @param showOutsideDays - Whether to show days from adjacent months. Defaults to `true`.
+ *
+ * @example
+ * ```tsx
+ * const [date, setDate] = useState<Date | undefined>();
+ * <Calendar mode="single" selected={date} onSelect={setDate} />
+ * ```
+ */
 declare function Calendar({ className, classNames, showOutsideDays, ...props }: React.ComponentProps<typeof DayPicker>): react_jsx_runtime.JSX.Element;
 
 export { Calendar };