@omnifyjp/ui 0.5.3 → 1.0.0

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

@@ -0,0 +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

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

package/dist/components/aspect-ratio.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"aspect-ratio.js"}

package/dist/components/avatar.d.ts

@@ -0,0 +1,48 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import * as React from 'react';
+import * as AvatarPrimitive from '@radix-ui/react-avatar';
+
+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, type AvatarFallbackProps, AvatarImage, type AvatarImageProps, type AvatarProps };

package/dist/components/avatar.js

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

package/dist/components/avatar.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"avatar.js"}

package/dist/components/badge.d.ts

@@ -0,0 +1,52 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import * as class_variance_authority_types from 'class-variance-authority/types';
+import * as React from 'react';
+import { VariantProps } from 'class-variance-authority';
+import { UIColor } from '../lib/types.js';
+
+declare const badgeVariants: (props?: ({
+    variant?: "destructive" | "default" | "secondary" | "outline" | "soft" | null | undefined;
+    color?: "primary" | "destructive" | "success" | "warning" | "info" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+interface BadgeProps extends React.ComponentProps<"span">, Omit<VariantProps<typeof badgeVariants>, "color"> {
+    /**
+     * Semantic color intent.
+     *
+     * @default "primary"
+     * @example
+     * ```tsx
+     * <Badge color="success">Done</Badge>
+     * <Badge color="warning">Pending</Badge>
+     * <Badge variant="soft" color="destructive">Failed</Badge>
+     * ```
+     */
+    color?: UIColor;
+    /** Render as a child component using Radix Slot. @default false */
+    asChild?: boolean;
+}
+/**
+ * Inline status descriptor with semantic colors and visual variants.
+ *
+ * @example
+ * ```tsx
+ * // Solid (default)
+ * <Badge>New</Badge>
+ * <Badge color="success">Done</Badge>
+ * <Badge color="warning">Pending</Badge>
+ *
+ * // Soft (light tinted background)
+ * <Badge variant="soft" color="success">Approved</Badge>
+ * <Badge variant="soft" color="destructive">Rejected</Badge>
+ *
+ * // Outline
+ * <Badge variant="outline">v1.0.0</Badge>
+ * <Badge variant="outline" color="info">Beta</Badge>
+ *
+ * // Legacy (still works)
+ * <Badge variant="destructive">Error</Badge>
+ * <Badge variant="secondary">Draft</Badge>
+ * ```
+ */
+declare function Badge({ className, variant, color, asChild, ...props }: BadgeProps): react_jsx_runtime.JSX.Element;
+
+export { Badge, type BadgeProps, badgeVariants };

package/dist/components/badge.js

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

package/dist/components/badge.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"badge.js"}

package/dist/components/breadcrumb.d.ts

@@ -0,0 +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

@@ -0,0 +1,4 @@
+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/breadcrumb.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"breadcrumb.js"}

package/dist/components/button.d.ts

@@ -0,0 +1,81 @@
+import * as class_variance_authority_types from 'class-variance-authority/types';
+import * as React from 'react';
+import { VariantProps } from 'class-variance-authority';
+import { UIColor } from '../lib/types.js';
+
+declare const buttonVariants: (props?: ({
+    variant?: "link" | "destructive" | "default" | "secondary" | "outline" | "soft" | "ghost" | null | undefined;
+    color?: "primary" | "destructive" | "success" | "warning" | "info" | null | undefined;
+    size?: "default" | "xs" | "sm" | "lg" | "xl" | "icon" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+interface ButtonProps extends React.ComponentProps<"button">, Omit<VariantProps<typeof buttonVariants>, "color"> {
+    /**
+     * Semantic color intent. Works with `variant` to produce the final appearance.
+     *
+     * | Color | Use for |
+     * |-------|---------|
+     * | `primary` | Main actions (default) |
+     * | `destructive` | Delete, errors |
+     * | `success` | Approve, confirm |
+     * | `warning` | Caution, attention |
+     * | `info` | Informational |
+     *
+     * @default "primary"
+     * @example
+     * ```tsx
+     * <Button color="success">Approve</Button>
+     * <Button variant="outline" color="destructive">Reject</Button>
+     * <Button variant="soft" color="warning">Review</Button>
+     * ```
+     */
+    color?: UIColor;
+    /**
+     * 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.
+     * @default false
+     * @example
+     * ```tsx
+     * <Button block>Full Width</Button>
+     * <Button size="xl" block>Sign In</Button>
+     * ```
+     */
+    block?: boolean;
+}
+/**
+ * Button component with semantic colors, visual variants, and standard sizes.
+ *
+ * Combines `variant` (how it looks) with `color` (what it means) for full flexibility.
+ * All existing `variant="destructive"` usage continues to work unchanged.
+ *
+ * @example
+ * ```tsx
+ * // Default (solid primary)
+ * <Button>Save</Button>
+ *
+ * // Semantic colors
+ * <Button color="success">Approve</Button>
+ * <Button color="destructive">Delete</Button>
+ * <Button color="warning">Proceed with caution</Button>
+ *
+ * // Variant × Color combinations
+ * <Button variant="outline" color="destructive">Reject</Button>
+ * <Button variant="soft" color="success">Approved</Button>
+ * <Button variant="ghost" color="info">Learn more</Button>
+ *
+ * // Legacy (still works)
+ * <Button variant="destructive">Delete</Button>
+ *
+ * // Sizes: xs (24px) | sm (28px) | default (32px) | lg (36px) | xl (44px) | icon (32x32)
+ * <Button size="xs">Tiny</Button>
+ * <Button size="xl" block>Sign In</Button>
+ * <Button size="icon"><PlusIcon /></Button>
+ * ```
+ */
+declare const Button: React.ForwardRefExoticComponent<Omit<ButtonProps, "ref"> & React.RefAttributes<HTMLButtonElement>>;
+
+export { Button, type ButtonProps, buttonVariants };

package/dist/components/button.js

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

package/dist/components/button.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"button.js"}

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

@@ -0,0 +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

@@ -0,0 +1,5 @@
+export { CalendarCategoryBadge } from '../chunk-JAJMM32I.js';
+import '../chunk-A3BB5ZOC.js';
+import '../chunk-DGPY4WP3.js';
+//# sourceMappingURL=calendar-category-badge.js.map
+//# sourceMappingURL=calendar-category-badge.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"calendar-category-badge.js"}

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

@@ -0,0 +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

@@ -0,0 +1,4 @@
+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-chip.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"calendar-event-chip.js"}

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

@@ -0,0 +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

@@ -0,0 +1,9 @@
+export { CalendarEventSheet } from '../chunk-THQUH6WX.js';
+import '../chunk-JLTBUACL.js';
+import '../chunk-JAJMM32I.js';
+import '../chunk-PGWNOZDX.js';
+import '../chunk-55E7D2HR.js';
+import '../chunk-A3BB5ZOC.js';
+import '../chunk-DGPY4WP3.js';
+//# sourceMappingURL=calendar-event-sheet.js.map
+//# sourceMappingURL=calendar-event-sheet.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"calendar-event-sheet.js"}

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

@@ -0,0 +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

@@ -0,0 +1,6 @@
+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-mini.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"calendar-mini.js"}

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

@@ -0,0 +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. 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

@@ -0,0 +1,7 @@
+export { CalendarToolbar } from '../chunk-36YYHIJU.js';
+import '../chunk-ZPMXRW2A.js';
+import '../chunk-NU56GKGM.js';
+import '../chunk-55E7D2HR.js';
+import '../chunk-DGPY4WP3.js';
+//# sourceMappingURL=calendar-toolbar.js.map
+//# sourceMappingURL=calendar-toolbar.js.map

package/dist/components/calendar-toolbar.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"calendar-toolbar.js"}

package/dist/components/calendar.d.ts

@@ -0,0 +1,19 @@
+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` v9. 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

@@ -0,0 +1,5 @@
+export { Calendar } from '../chunk-QB3UWRZH.js';
+import '../chunk-55E7D2HR.js';
+import '../chunk-DGPY4WP3.js';
+//# sourceMappingURL=calendar.js.map
+//# sourceMappingURL=calendar.js.map

package/dist/components/calendar.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"calendar.js"}