@omnifyjp/ui 0.1.6 → 0.1.7

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/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-RIIADVOV.js';
-import '../chunk-KOGOYUEE.js';
-import '../chunk-TEYOLOZY.js';
-import '../chunk-ONAUEREV.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-3TGN2DFB.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,6 +1,6 @@
-export { CalendarToolbar } from '../chunk-74K7VSEO.js';
-import '../chunk-OHBCYKNT.js';
-import '../chunk-725ICC47.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

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 };

package/dist/components/calendar.js

@@ -1,4 +1,4 @@
-export { Calendar } from '../chunk-EMHO6GT6.js';
+export { Calendar } from '../chunk-33DTBAFF.js';
 import '../chunk-Y65FNGEE.js';
 import '../chunk-DGPY4WP3.js';
 //# sourceMappingURL=calendar.js.map

package/dist/components/card.d.ts

@@ -1,12 +1,43 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as React from 'react';
 
+/**
+ * Styled card container with header, title, description, action, content, and footer sub-components.
+ *
+ * Uses density tokens (`px-card`, `pt-card`, `pb-card`, `gap-card`) for consistent
+ * internal spacing that adapts to the design system.
+ *
+ * @example
+ * ```tsx
+ * <Card>
+ *   <CardHeader>
+ *     <CardTitle>Notifications</CardTitle>
+ *     <CardDescription>You have 3 unread messages.</CardDescription>
+ *     <CardAction>
+ *       <Button variant="outline">Mark all read</Button>
+ *     </CardAction>
+ *   </CardHeader>
+ *   <CardContent>
+ *     <p>Your recent activity will appear here.</p>
+ *   </CardContent>
+ *   <CardFooter>
+ *     <Button>View all</Button>
+ *   </CardFooter>
+ * </Card>
+ * ```
+ */
 declare function Card({ className, ...props }: React.ComponentProps<"div">): react_jsx_runtime.JSX.Element;
+/** Card header section. Lays out title, description, and optional action in a grid. */
 declare function CardHeader({ className, ...props }: React.ComponentProps<"div">): react_jsx_runtime.JSX.Element;
+/** Card title rendered as an `<h4>` element. */
 declare function CardTitle({ className, ...props }: React.ComponentProps<"div">): react_jsx_runtime.JSX.Element;
+/** Card description text displayed in muted foreground color. */
 declare function CardDescription({ className, ...props }: React.ComponentProps<"div">): react_jsx_runtime.JSX.Element;
+/** Card action slot positioned at the top-right of `CardHeader`. Place buttons or menus here. */
 declare function CardAction({ className, ...props }: React.ComponentProps<"div">): react_jsx_runtime.JSX.Element;
+/** Card content area with horizontal padding. Bottom padding applied when last child. */
 declare function CardContent({ className, ...props }: React.ComponentProps<"div">): react_jsx_runtime.JSX.Element;
+/** Card footer with horizontal layout. Typically used for action buttons. */
 declare function CardFooter({ className, ...props }: React.ComponentProps<"div">): react_jsx_runtime.JSX.Element;
 
 export { Card, CardAction, CardContent, CardDescription, CardFooter, CardHeader, CardTitle };

package/dist/components/card.js

@@ -1,4 +1,4 @@
-export { Card, CardAction, CardContent, CardDescription, CardFooter, CardHeader, CardTitle } from '../chunk-OXQNDQJW.js';
+export { Card, CardAction, CardContent, CardDescription, CardFooter, CardHeader, CardTitle } from '../chunk-Z2QAABLM.js';
 import '../chunk-DGPY4WP3.js';
 //# sourceMappingURL=card.js.map
 //# sourceMappingURL=card.js.map

package/dist/components/carousel.d.ts

@@ -10,15 +10,43 @@ type UseCarouselParameters = Parameters<typeof useEmblaCarousel>;
 type CarouselOptions = UseCarouselParameters[0];
 type CarouselPlugin = UseCarouselParameters[1];
 type CarouselProps = {
+    /** Embla Carousel options (e.g., `{ loop: true, align: "start" }`). */
     opts?: CarouselOptions;
+    /** Embla Carousel plugins (e.g., Autoplay, ClassNames). */
     plugins?: CarouselPlugin;
+    /** Scroll axis direction. Defaults to `"horizontal"`. */
     orientation?: "horizontal" | "vertical";
+    /** Callback to receive the Embla API instance for external control. */
     setApi?: (api: CarouselApi) => void;
 };
+/**
+ * Carousel/slider component powered by Embla Carousel.
+ *
+ * Provides a context for child components (`CarouselContent`, `CarouselItem`,
+ * `CarouselPrevious`, `CarouselNext`). Supports horizontal/vertical orientation,
+ * keyboard navigation (arrow keys), and plugin extensibility.
+ *
+ * @example
+ * ```tsx
+ * <Carousel opts={{ loop: true }}>
+ *   <CarouselContent>
+ *     <CarouselItem>Slide 1</CarouselItem>
+ *     <CarouselItem>Slide 2</CarouselItem>
+ *     <CarouselItem>Slide 3</CarouselItem>
+ *   </CarouselContent>
+ *   <CarouselPrevious />
+ *   <CarouselNext />
+ * </Carousel>
+ * ```
+ */
 declare function Carousel({ orientation, opts, setApi, plugins, className, children, ...props }: React.ComponentProps<"div"> & CarouselProps): react_jsx_runtime.JSX.Element;
+/** Scrollable container for `CarouselItem` elements. Manages the overflow viewport. */
 declare function CarouselContent({ className, ...props }: React.ComponentProps<"div">): react_jsx_runtime.JSX.Element;
+/** Individual slide within the carousel. Defaults to full-width (`basis-full`). */
 declare function CarouselItem({ className, ...props }: React.ComponentProps<"div">): react_jsx_runtime.JSX.Element;
+/** Navigation button to scroll to the previous slide. Automatically disabled when at the beginning. */
 declare function CarouselPrevious({ className, variant, size, ...props }: React.ComponentProps<typeof Button>): react_jsx_runtime.JSX.Element;
+/** Navigation button to scroll to the next slide. Automatically disabled when at the end. */
 declare function CarouselNext({ className, variant, size, ...props }: React.ComponentProps<typeof Button>): react_jsx_runtime.JSX.Element;
 
 export { Carousel, type CarouselApi, CarouselContent, CarouselItem, CarouselNext, CarouselPrevious };

package/dist/components/carousel.js

@@ -1,4 +1,4 @@
-export { Carousel, CarouselContent, CarouselItem, CarouselNext, CarouselPrevious } from '../chunk-CF2MMEOS.js';
+export { Carousel, CarouselContent, CarouselItem, CarouselNext, CarouselPrevious } from '../chunk-TX42RKQU.js';
 import '../chunk-Y65FNGEE.js';
 import '../chunk-DGPY4WP3.js';
 //# sourceMappingURL=carousel.js.map

package/dist/components/chart.d.ts

@@ -6,37 +6,97 @@ declare const THEMES: {
     readonly light: "";
     readonly dark: ".dark";
 };
+/**
+ * Configuration object for chart data series. Each key maps to a data series
+ * and defines its label, optional icon, and color (either a single color or
+ * per-theme colors).
+ *
+ * @example
+ * ```tsx
+ * const config: ChartConfig = {
+ *   revenue: { label: "Revenue", color: "var(--color-blue-500)" },
+ *   expenses: { label: "Expenses", theme: { light: "#ef4444", dark: "#f87171" } },
+ * };
+ * ```
+ */
 type ChartConfig = {
     [k in string]: {
+        /** Display label for this data series. */
         label?: React.ReactNode;
+        /** Optional icon component displayed in the legend. */
         icon?: React.ComponentType;
     } & ({
         color?: string;
         theme?: never;
     } | {
-        color?: never;
+        color?: never; /** Per-theme color mapping (light/dark). */
         theme: Record<keyof typeof THEMES, string>;
     });
 };
+/**
+ * Wrapper that provides chart configuration context, injects theme-aware CSS
+ * custom properties for data series colors, and renders a Recharts
+ * `ResponsiveContainer`.
+ *
+ * @param config - Chart configuration mapping data keys to labels, icons, and colors.
+ *
+ * @example
+ * ```tsx
+ * <ChartContainer config={{ revenue: { label: "Revenue", color: "#3b82f6" } }}>
+ *   <BarChart data={data}>
+ *     <Bar dataKey="revenue" fill="var(--color-revenue)" />
+ *   </BarChart>
+ * </ChartContainer>
+ * ```
+ */
 declare function ChartContainer({ id, className, children, config, ...props }: React.ComponentProps<"div"> & {
+    /** Chart configuration mapping data keys to labels, icons, and colors. */
     config: ChartConfig;
+    /** Recharts chart element (e.g. BarChart, LineChart). */
     children: React.ComponentProps<typeof RechartsPrimitive.ResponsiveContainer>["children"];
 }): react_jsx_runtime.JSX.Element;
+/** Injects a `<style>` tag with CSS custom properties for chart colors, scoped to the chart container. */
 declare const ChartStyle: ({ id, config }: {
     id: string;
     config: ChartConfig;
 }) => react_jsx_runtime.JSX.Element | null;
+/** Re-export of Recharts Tooltip for use with ChartTooltipContent. */
 declare const ChartTooltip: typeof RechartsPrimitive.Tooltip;
+/**
+ * Styled tooltip content for use inside `<ChartTooltip content={<ChartTooltipContent />} />`.
+ * Renders data series with color indicators, labels from ChartConfig, and formatted values.
+ *
+ * @param indicator - Shape of the color indicator: `"dot"`, `"line"`, or `"dashed"`.
+ * @param hideLabel - Whether to hide the tooltip header label.
+ * @param hideIndicator - Whether to hide the color indicator.
+ * @param nameKey - Data key to resolve series name from the payload.
+ * @param labelKey - Data key to resolve the tooltip header label from config.
+ */
 declare function ChartTooltipContent({ active, payload, className, indicator, hideLabel, hideIndicator, label, labelFormatter, labelClassName, formatter, color, nameKey, labelKey, }: React.ComponentProps<typeof RechartsPrimitive.Tooltip> & React.ComponentProps<"div"> & {
+    /** Whether to hide the tooltip header label. */
     hideLabel?: boolean;
+    /** Whether to hide the color indicator next to each series. */
     hideIndicator?: boolean;
+    /** Shape of the color indicator. Defaults to `"dot"`. */
     indicator?: "line" | "dot" | "dashed";
+    /** Data key used to resolve the series name from payload. */
     nameKey?: string;
+    /** Data key used to resolve the header label from config. */
     labelKey?: string;
 }): react_jsx_runtime.JSX.Element | null;
+/** Re-export of Recharts Legend for use with ChartLegendContent. */
 declare const ChartLegend: typeof RechartsPrimitive.Legend;
+/**
+ * Styled legend content for use inside `<ChartLegend content={<ChartLegendContent />} />`.
+ * Renders a horizontal list of series labels with color indicators or custom icons from ChartConfig.
+ *
+ * @param hideIcon - Whether to hide the color dot / custom icon.
+ * @param nameKey - Data key to resolve the series name from payload.
+ */
 declare function ChartLegendContent({ className, hideIcon, payload, verticalAlign, nameKey, }: React.ComponentProps<"div"> & Pick<RechartsPrimitive.LegendProps, "payload" | "verticalAlign"> & {
+    /** Whether to hide the color indicator or custom icon. */
     hideIcon?: boolean;
+    /** Data key used to resolve the series name from payload. */
     nameKey?: string;
 }): react_jsx_runtime.JSX.Element | null;
 

package/dist/components/chart.js

@@ -1,4 +1,4 @@
-export { ChartContainer, ChartLegend, ChartLegendContent, ChartStyle, ChartTooltip, ChartTooltipContent } from '../chunk-NFAXCC73.js';
+export { ChartContainer, ChartLegend, ChartLegendContent, ChartStyle, ChartTooltip, ChartTooltipContent } from '../chunk-B434PORR.js';
 import '../chunk-DGPY4WP3.js';
 //# sourceMappingURL=chart.js.map
 //# sourceMappingURL=chart.js.map

package/dist/components/checkbox.d.ts

@@ -1,6 +1,24 @@
 import * as React from 'react';
 import * as CheckboxPrimitive from '@radix-ui/react-checkbox';
 
+type CheckboxProps = React.ComponentPropsWithoutRef<typeof CheckboxPrimitive.Root>;
+/**
+ * Checkable input that allows selecting one or more options from a set.
+ * Supports checked, unchecked, and indeterminate states.
+ *
+ * @example
+ * ```tsx
+ * // Basic usage
+ * <Checkbox id="terms" />
+ * <Label htmlFor="terms">Accept terms</Label>
+ *
+ * // Controlled
+ * <Checkbox checked={accepted} onCheckedChange={setAccepted} />
+ *
+ * // Indeterminate (partial selection)
+ * <Checkbox checked="indeterminate" />
+ * ```
+ */
 declare const Checkbox: React.ForwardRefExoticComponent<Omit<CheckboxPrimitive.CheckboxProps & React.RefAttributes<HTMLButtonElement>, "ref"> & React.RefAttributes<HTMLButtonElement>>;
 
-export { Checkbox };
+export { Checkbox, type CheckboxProps };

package/dist/components/checkbox.js

@@ -1,4 +1,4 @@
-export { Checkbox } from '../chunk-PPZSGU2L.js';
+export { Checkbox } from '../chunk-WL4ZO2H3.js';
 import '../chunk-DGPY4WP3.js';
 //# sourceMappingURL=checkbox.js.map
 //# sourceMappingURL=checkbox.js.map