@j3m-quantum/ui 0.9.1 → 1.3.0

package/dist/index.d.ts

@@ -25,7 +25,7 @@ import * as AlertDialogPrimitive from '@radix-ui/react-alert-dialog';
 import * as ProgressPrimitive from '@radix-ui/react-progress';
 import * as TooltipPrimitive from '@radix-ui/react-tooltip';
 import { ToasterProps } from 'sonner';
-import { LucideProps } from 'lucide-react';
+import { LucideProps, LucideIcon } from 'lucide-react';
 import { Command as Command$1 } from 'cmdk';
 import * as DialogPrimitive from '@radix-ui/react-dialog';
 import * as DropdownMenuPrimitive from '@radix-ui/react-dropdown-menu';
@@ -38,6 +38,7 @@ import * as HoverCardPrimitive from '@radix-ui/react-hover-card';
 import * as ScrollAreaPrimitive from '@radix-ui/react-scroll-area';
 import * as CollapsiblePrimitive from '@radix-ui/react-collapsible';
 import * as ResizablePrimitive from 'react-resizable-panels';
+export { areIntervalsOverlapping, format, getDay, isSameDay, isSameMonth, isToday, parseISO } from 'date-fns';
 
 declare function useIsMobile(): boolean;
 
@@ -223,6 +224,27 @@ declare function Avatar({ className, ...props }: React$1.ComponentProps<typeof A
 declare function AvatarImage({ className, ...props }: React$1.ComponentProps<typeof AvatarPrimitive.Image>): react_jsx_runtime.JSX.Element;
 declare function AvatarFallback({ className, ...props }: React$1.ComponentProps<typeof AvatarPrimitive.Fallback>): react_jsx_runtime.JSX.Element;
 
+/**
+ * User Avatars Dropdown Component
+ *
+ * A reusable component that displays stacked user avatars with a dropdown
+ * for selection. Shows first N avatars with "+X" overflow indicator.
+ */
+interface UserAvatarItem {
+    id: string;
+    name: string;
+    image?: string;
+}
+interface UserAvatarsDropdownProps {
+    users: UserAvatarItem[];
+    selectedUserId: string | null;
+    onSelect: (userId: string | null) => void;
+    maxVisible?: number;
+    label?: string;
+    className?: string;
+}
+declare function UserAvatarsDropdown({ users, selectedUserId, onSelect, maxVisible, label, className, }: UserAvatarsDropdownProps): react_jsx_runtime.JSX.Element;
+
 declare function Skeleton({ className, ...props }: React.ComponentProps<"div">): react_jsx_runtime.JSX.Element;
 
 declare function Accordion({ ...props }: React$1.ComponentProps<typeof AccordionPrimitive.Root>): react_jsx_runtime.JSX.Element;
@@ -353,7 +375,7 @@ declare function Tooltip({ ...props }: React$1.ComponentProps<typeof TooltipPrim
 declare function TooltipTrigger({ ...props }: React$1.ComponentProps<typeof TooltipPrimitive.Trigger>): react_jsx_runtime.JSX.Element;
 declare function TooltipContent({ className, sideOffset, children, ...props }: React$1.ComponentProps<typeof TooltipPrimitive.Content>): react_jsx_runtime.JSX.Element;
 
-declare const Toaster: ({ ...props }: ToasterProps) => react_jsx_runtime.JSX.Element;
+declare const Toaster: ({ theme: themeProp, ...props }: ToasterProps) => react_jsx_runtime.JSX.Element;
 
 declare function Spinner({ className, ...props }: LucideProps): react_jsx_runtime.JSX.Element;
 
@@ -406,6 +428,24 @@ declare function CommandSeparator({ className, ...props }: React$1.ComponentProp
 declare function CommandItem({ className, ...props }: React$1.ComponentProps<typeof Command$1.Item>): react_jsx_runtime.JSX.Element;
 declare function CommandShortcut({ className, ...props }: React$1.ComponentProps<"span">): react_jsx_runtime.JSX.Element;
 
+interface SearchTriggerProps extends React$1.ButtonHTMLAttributes<HTMLButtonElement> {
+    /** Placeholder text shown in the search button */
+    placeholder?: string;
+    /** Whether to show the keyboard shortcut hint */
+    showShortcut?: boolean;
+    /** Custom keyboard shortcut to display (defaults to ⌘K) */
+    shortcutKey?: string;
+    /** Whether to use the command modifier symbol (⌘ on Mac, Ctrl on others) */
+    shortcutModifier?: string;
+}
+declare const SearchTrigger: React$1.ForwardRefExoticComponent<SearchTriggerProps & React$1.RefAttributes<HTMLButtonElement>>;
+/**
+ * A hook that sets up keyboard shortcut handling for the search trigger.
+ * @param onOpen - Callback fired when the shortcut is pressed
+ * @param key - The key to listen for (default: "k")
+ */
+declare function useSearchShortcut(onOpen: () => void, key?: string): void;
+
 declare function DropdownMenu({ ...props }: React$1.ComponentProps<typeof DropdownMenuPrimitive.Root>): react_jsx_runtime.JSX.Element;
 declare function DropdownMenuPortal({ ...props }: React$1.ComponentProps<typeof DropdownMenuPrimitive.Portal>): react_jsx_runtime.JSX.Element;
 declare function DropdownMenuTrigger({ ...props }: React$1.ComponentProps<typeof DropdownMenuPrimitive.Trigger>): react_jsx_runtime.JSX.Element;
@@ -615,4 +655,615 @@ declare const SectionDescription: React$1.ForwardRefExoticComponent<React$1.HTML
 declare const SectionContent: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLDivElement> & React$1.RefAttributes<HTMLDivElement>>;
 declare const SectionFooter: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLDivElement> & React$1.RefAttributes<HTMLDivElement>>;
 
-export { Accordion, AccordionContent, AccordionItem, AccordionTrigger, Alert, AlertDescription, AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogOverlay, AlertDialogPortal, AlertDialogTitle, AlertDialogTrigger, AlertTitle, AspectRatio, Avatar, AvatarFallback, AvatarImage, Badge, Breadcrumb, BreadcrumbEllipsis, BreadcrumbItem, BreadcrumbLink, BreadcrumbList, BreadcrumbPage, BreadcrumbSeparator, Button, ButtonGroup, ButtonGroupSeparator, ButtonGroupText, type ButtonProps, Calendar, CalendarDayButton, Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, Carousel, type CarouselApi, CarouselContent, CarouselItem, CarouselNext, CarouselPrevious, type ChartConfig, ChartContainer, ChartLegend, ChartLegendContent, ChartStyle, ChartTooltip, ChartTooltipContent, Checkbox, Collapsible, CollapsibleContent, CollapsibleTrigger, Command, CommandDialog, CommandEmpty, CommandGroup, CommandInput, CommandItem, CommandList, CommandSeparator, CommandShortcut, ContextMenu, ContextMenuCheckboxItem, ContextMenuContent, ContextMenuGroup, ContextMenuItem, ContextMenuLabel, ContextMenuPortal, ContextMenuRadioGroup, ContextMenuRadioItem, ContextMenuSeparator, ContextMenuShortcut, ContextMenuSub, ContextMenuSubContent, ContextMenuSubTrigger, ContextMenuTrigger, Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger, Drawer, DrawerClose, DrawerContent, DrawerDescription, DrawerFooter, DrawerHeader, DrawerOverlay, DrawerPortal, DrawerTitle, DrawerTrigger, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, Empty, EmptyContent, EmptyDescription, EmptyHeader, EmptyMedia, EmptyTitle, Field, FieldContent, FieldDescription, FieldError, FieldGroup, FieldLabel, FieldLegend, FieldSeparator, FieldSet, FieldTitle, Form, FormControl, FormDescription, FormField, FormItem, FormLabel, FormMessage, HoverCard, HoverCardContent, HoverCardTrigger, Input, InputGroup, InputGroupAddon, InputGroupButton, InputGroupInput, InputGroupText, InputGroupTextarea, Item, ItemActions, ItemContent, ItemDescription, ItemFooter, ItemGroup, ItemHeader, ItemMedia, ItemSeparator, ItemTitle, Kbd, KbdGroup, Label, Menubar, MenubarCheckboxItem, MenubarContent, MenubarGroup, MenubarItem, MenubarLabel, MenubarMenu, MenubarPortal, MenubarRadioGroup, MenubarRadioItem, MenubarSeparator, MenubarShortcut, MenubarSub, MenubarSubContent, MenubarSubTrigger, MenubarTrigger, NativeSelect, NativeSelectOptGroup, NativeSelectOption, NavigationMenu, NavigationMenuContent, NavigationMenuIndicator, NavigationMenuItem, NavigationMenuLink, NavigationMenuList, NavigationMenuTrigger, NavigationMenuViewport, Pagination, PaginationContent, PaginationEllipsis, PaginationItem, PaginationLink, PaginationNext, PaginationPrevious, PlayerCanvas, PlayerCanvasActionButton, PlayerCanvasControls, PlayerCanvasDivider, PlayerCanvasInfo, PlayerCanvasLabel, PlayerCanvasPlayButton, PlayerCanvasProgress, PlayerCanvasSkipButton, PlayerCanvasTitle, Popover, PopoverAnchor, PopoverContent, PopoverTrigger, Progress, RadioGroup, RadioGroupItem, ResizableHandle, ResizablePanel, ResizablePanelGroup, ScrollArea, ScrollBar, Section, SectionContent, SectionDescription, SectionFooter, SectionHeader, type SectionProps, SectionTitle, Select, SelectContent, SelectGroup, SelectItem, SelectLabel, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectValue, Separator, Sheet, SheetBody, SheetClose, SheetContent, SheetDescription, SheetFooter, SheetHeader, SheetTitle, SheetTrigger, Sidebar, SidebarContent, SidebarFooter, SidebarGroup, SidebarGroupAction, SidebarGroupContent, SidebarGroupLabel, SidebarHeader, SidebarInput, SidebarInset, SidebarMenu, SidebarMenuAction, SidebarMenuBadge, SidebarMenuButton, SidebarMenuItem, SidebarMenuSkeleton, SidebarMenuSub, SidebarMenuSubButton, SidebarMenuSubItem, SidebarProvider, SidebarRail, SidebarSeparator, SidebarTrigger, Skeleton, Slider, Spinner, Switch, Table, TableBody, TableCaption, TableCell, TableFooter, TableHead, TableHeader, TableRow, Tabs, TabsContent, TabsList, TabsTrigger, Textarea, Toaster, Toggle, ToggleGroup, ToggleGroupItem, ToolBarCanvas, ToolBarCanvasButton, ToolBarCanvasDivider, ToolBarCanvasGroup, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, badgeVariants, buttonGroupVariants, buttonVariants, cardVariants, navigationMenuTriggerStyle, playerCanvasPlayButtonVariants, playerCanvasSkipButtonVariants, sectionVariants, toggleVariants, toolBarCanvasButtonVariants, useFormField, useIsMobile, useSidebar };
+interface BreadcrumbItemType {
+    label: string;
+    href?: string;
+}
+interface SiteHeaderProps {
+    /** Slot for sidebar trigger - use <SidebarTrigger /> from @j3m-quantum/ui */
+    trigger?: React$1.ReactNode;
+    breadcrumbs?: BreadcrumbItemType[];
+    showSearch?: boolean;
+    className?: string;
+    children?: React$1.ReactNode;
+}
+declare function SiteHeader({ trigger, breadcrumbs, showSearch, className, children }: SiteHeaderProps): react_jsx_runtime.JSX.Element;
+
+interface NavItem {
+    title: string;
+    url: string;
+    icon?: LucideIcon;
+    isActive?: boolean;
+    items?: {
+        title: string;
+        url: string;
+    }[];
+}
+interface NavMainProps {
+    items: NavItem[];
+    label?: string;
+}
+declare function NavMain({ items, label }: NavMainProps): react_jsx_runtime.JSX.Element;
+
+interface NavProject {
+    name: string;
+    url: string;
+    icon: LucideIcon;
+}
+interface NavProjectsProps {
+    projects: NavProject[];
+    label?: string;
+}
+declare function NavProjects({ projects, label }: NavProjectsProps): react_jsx_runtime.JSX.Element;
+
+interface NavSecondaryItem {
+    title: string;
+    url: string;
+    icon: LucideIcon;
+}
+interface NavSecondaryProps extends React$1.ComponentProps<typeof SidebarGroup> {
+    items: NavSecondaryItem[];
+}
+declare function NavSecondary({ items, ...props }: NavSecondaryProps): react_jsx_runtime.JSX.Element;
+
+interface NavUserProps {
+    user: {
+        name: string;
+        email: string;
+        avatar: string;
+    };
+}
+declare function NavUser({ user }: NavUserProps): react_jsx_runtime.JSX.Element;
+
+declare function SearchForm({ ...props }: React$1.ComponentProps<"form">): react_jsx_runtime.JSX.Element;
+
+/**
+ * Event Calendar Types
+ * Based on big-calendar by Leonardo Ramos (MIT License)
+ * https://github.com/lramos33/big-calendar
+ *
+ * Adapted for J3M UI with Tailwind v4 and design token integration.
+ */
+type TEventColor = "blue" | "green" | "red" | "yellow" | "purple" | "orange";
+type TBadgeVariant = "dot" | "colored" | "mixed";
+type TCalendarView = "month" | "week" | "day" | "year" | "agenda";
+interface IUser {
+    id: string;
+    name: string;
+    picturePath?: string;
+}
+interface IEvent {
+    id: string;
+    title: string;
+    description?: string;
+    startDate: string;
+    endDate: string;
+    color: TEventColor;
+    user: IUser;
+}
+interface ICalendarState {
+    selectedDate: Date;
+    selectedUserId: string | null;
+    events: IEvent[];
+    users: IUser[];
+    badgeVariant: TBadgeVariant;
+    view: TCalendarView;
+}
+interface ICalendarActions {
+    setSelectedDate: (date: Date) => void;
+    setSelectedUserId: (userId: string | null) => void;
+    setEvents: (events: IEvent[]) => void;
+    addEvent: (event: IEvent) => void;
+    updateEvent: (event: IEvent) => void;
+    deleteEvent: (eventId: string) => void;
+    setBadgeVariant: (variant: TBadgeVariant) => void;
+    setView: (view: TCalendarView) => void;
+    goToToday: () => void;
+    goToPrevious: () => void;
+    goToNext: () => void;
+}
+interface ICalendarContext extends ICalendarState, ICalendarActions {
+}
+interface IEventDialogProps {
+    mode: "add" | "edit";
+    event?: IEvent;
+    defaultDate?: Date;
+    onSubmit: (event: Omit<IEvent, "id"> | IEvent) => void;
+    onClose: () => void;
+}
+interface IViewProps {
+    events: IEvent[];
+    selectedDate: Date;
+    onEventClick?: (event: IEvent) => void;
+    onDateClick?: (date: Date) => void;
+    onEventDrop?: (event: IEvent, newStart: Date, newEnd: Date) => void;
+}
+interface ICalendarHeaderProps {
+    showViewSwitcher?: boolean;
+    showUserFilter?: boolean;
+    showBadgeVariant?: boolean;
+    showToday?: boolean;
+}
+interface IDayCellProps {
+    date: Date;
+    events: IEvent[];
+    isCurrentMonth: boolean;
+    isToday: boolean;
+    isSelected: boolean;
+    onDateClick?: (date: Date) => void;
+    onEventClick?: (event: IEvent) => void;
+    onEventDrop?: (event: IEvent, newDate: Date) => void;
+}
+interface ITimeSlotProps {
+    date: Date;
+    hour: number;
+    events: IEvent[];
+    onTimeClick?: (date: Date, hour: number) => void;
+    onEventClick?: (event: IEvent) => void;
+    onEventDrop?: (event: IEvent, newStart: Date) => void;
+}
+interface IEventBadgeProps {
+    event: IEvent;
+    variant: TBadgeVariant;
+    onClick?: (event: IEvent) => void;
+    isDragging?: boolean;
+}
+interface IDragContext {
+    draggedEvent: IEvent | null;
+    setDraggedEvent: (event: IEvent | null) => void;
+    isDragging: boolean;
+}
+type TWorkingHours = {
+    [key: number]: {
+        from: number;
+        to: number;
+    };
+};
+type TVisibleHours = {
+    from: number;
+    to: number;
+};
+interface IWorkingHours {
+    start: number;
+    end: number;
+}
+declare const DEFAULT_WORKING_HOURS: TWorkingHours;
+declare const DEFAULT_VISIBLE_HOURS: TVisibleHours;
+interface ICalendarCell {
+    day: number;
+    currentMonth: boolean;
+    date: Date;
+}
+interface ICalendarConfig {
+    workingHours?: TWorkingHours;
+    visibleHours?: TVisibleHours;
+    weekStartsOn?: 0 | 1 | 2 | 3 | 4 | 5 | 6;
+    locale?: string;
+    timeFormat?: "12h" | "24h";
+}
+interface IEventPosition {
+    top: number;
+    left: number;
+    width: number;
+    height: number;
+}
+declare const EVENT_COLORS: Record<TEventColor, {
+    bg: string;
+    text: string;
+    border: string;
+}>;
+declare const VIEW_LABELS: Record<TCalendarView, string>;
+declare const BADGE_VARIANT_LABELS: Record<TBadgeVariant, string>;
+
+interface IExtendedCalendarContext {
+    selectedDate: Date;
+    selectedUserId: string | null;
+    events: IEvent[];
+    users: IUser[];
+    badgeVariant: TBadgeVariant;
+    view: TCalendarView;
+    workingHours: TWorkingHours;
+    visibleHours: TVisibleHours;
+    setSelectedDate: (date: Date) => void;
+    setSelectedUserId: (userId: string | null) => void;
+    setEvents: (events: IEvent[]) => void;
+    addEvent: (event: IEvent) => void;
+    updateEvent: (event: IEvent) => void;
+    deleteEvent: (eventId: string) => void;
+    setBadgeVariant: (variant: TBadgeVariant) => void;
+    setView: (view: TCalendarView) => void;
+    setWorkingHours: (hours: TWorkingHours) => void;
+    setVisibleHours: (hours: TVisibleHours) => void;
+    goToToday: () => void;
+    goToPrevious: () => void;
+    goToNext: () => void;
+}
+declare const CalendarContext: React$1.Context<IExtendedCalendarContext | null>;
+interface EventCalendarProviderProps {
+    children: React$1.ReactNode;
+    events?: IEvent[];
+    users?: IUser[];
+    defaultDate?: Date;
+    defaultView?: TCalendarView;
+    defaultBadgeVariant?: TBadgeVariant;
+    defaultUserId?: string | null;
+    defaultWorkingHours?: TWorkingHours;
+    defaultVisibleHours?: TVisibleHours;
+    onEventAdd?: (event: IEvent) => void;
+    onEventUpdate?: (event: IEvent) => void;
+    onEventDelete?: (eventId: string) => void;
+}
+declare function EventCalendarProvider({ children, events: initialEvents, users: initialUsers, defaultDate, defaultView, defaultBadgeVariant, defaultUserId, defaultWorkingHours, defaultVisibleHours, onEventAdd, onEventUpdate, onEventDelete, }: EventCalendarProviderProps): react_jsx_runtime.JSX.Element;
+declare function useEventCalendar(): IExtendedCalendarContext;
+declare function useFilteredEvents(): IEvent[];
+declare function useEventsInRange(startDate: Date, endDate: Date): IEvent[];
+
+/**
+ * Get range text for header navigation
+ */
+declare function rangeText(view: TCalendarView, date: Date): string;
+/**
+ * Navigate date based on view
+ */
+declare function navigateDate(date: Date, view: TCalendarView, direction: "previous" | "next"): Date;
+/**
+ * Get events count for a date based on view
+ */
+declare function getEventsCount(events: IEvent[], date: Date, view: TCalendarView): number;
+/**
+ * Get current events (happening now)
+ */
+declare function getCurrentEvents(events: IEvent[]): IEvent[];
+/**
+ * Group events by time slots to handle overlapping
+ */
+declare function groupEvents(dayEvents: IEvent[]): IEvent[][];
+/**
+ * Get event block style for week/day view
+ * Returns pixel-based positioning for 96px/hour grid
+ */
+declare function getEventBlockStyle(event: IEvent, day: Date, groupIndex: number, groupSize: number, visibleHoursRange?: {
+    from: number;
+    to: number;
+}, hourHeight?: number): {
+    top: string;
+    height: string;
+    width: string;
+    left: string;
+};
+/**
+ * Check if hour is working hour (per-day configuration)
+ */
+declare function isWorkingHour(day: Date, hour: number, workingHours: TWorkingHours): boolean;
+/**
+ * Get visible hours with adjustment for events
+ */
+declare function getVisibleHours(visibleHours: TVisibleHours, singleDayEvents: IEvent[]): {
+    hours: number[];
+    earliestEventHour: number;
+    latestEventHour: number;
+};
+/**
+ * Get calendar cells for month view
+ */
+declare function getCalendarCells(selectedDate: Date): ICalendarCell[];
+/**
+ * Calculate event positions for month view (handles multi-day events)
+ */
+declare function calculateMonthEventPositions(multiDayEvents: IEvent[], singleDayEvents: IEvent[], selectedDate: Date): {
+    [key: string]: number;
+};
+/**
+ * Get events for a specific month cell with positions
+ */
+declare function getMonthCellEvents(date: Date, events: IEvent[], eventPositions: Record<string, number>): {
+    position: number;
+    isMultiDay: boolean;
+    id: string;
+    title: string;
+    description?: string;
+    startDate: string;
+    endDate: string;
+    color: TEventColor;
+    user: IUser;
+}[];
+/**
+ * Get the days of the month grid (including days from prev/next months)
+ */
+declare function getMonthDays(date: Date, weekStartsOn?: 0 | 1 | 2 | 3 | 4 | 5 | 6): Date[];
+/**
+ * Get the days of a week
+ */
+declare function getWeekDays(date: Date, weekStartsOn?: 0 | 1 | 2 | 3 | 4 | 5 | 6): Date[];
+/**
+ * Get hours of a day
+ */
+declare function getDayHours(date: Date, start?: number, end?: number): Date[];
+/**
+ * Get months of a year
+ */
+declare function getYearMonths(date: Date): Date[];
+/**
+ * Filter events for a specific date
+ */
+declare function getEventsForDate(events: IEvent[], date: Date): IEvent[];
+/**
+ * Filter events for a date range
+ */
+declare function getEventsInRange(events: IEvent[], start: Date, end: Date): IEvent[];
+/**
+ * Split events into single-day and multi-day
+ */
+declare function splitEventsByDuration(events: IEvent[]): {
+    singleDayEvents: IEvent[];
+    multiDayEvents: IEvent[];
+};
+/**
+ * Check if an event spans multiple days
+ */
+declare function isMultiDayEvent(event: IEvent): boolean;
+/**
+ * Get the number of days an event spans
+ */
+declare function getEventDuration(event: IEvent): number;
+/**
+ * Get the duration of an event in minutes
+ */
+declare function getEventDurationMinutes(event: IEvent): number;
+/**
+ * Sort events by start date, then by duration (longer first)
+ */
+declare function sortEvents(events: IEvent[]): IEvent[];
+/**
+ * Get the top position percentage for an event in time view
+ */
+declare function getTimePosition(event: IEvent, visibleHoursRange?: {
+    from: number;
+    to: number;
+}): number;
+/**
+ * Get the height percentage for an event in time view
+ */
+declare function getTimeHeight(event: IEvent, visibleHoursRange?: {
+    from: number;
+    to: number;
+}): number;
+/**
+ * Format time based on 12h or 24h format
+ */
+declare function formatTime(date: Date, use24h?: boolean): string;
+/**
+ * Get the week day names
+ */
+declare function getWeekDayNames(weekStartsOn?: 0 | 1 | 2 | 3 | 4 | 5 | 6, shortNames?: boolean): string[];
+/**
+ * Get display label for calendar header
+ */
+declare function getHeaderLabel(date: Date, view: string): string;
+/**
+ * Get the date range for the current view
+ */
+declare function getViewDateRange(date: Date, view: string): {
+    start: Date;
+    end: Date;
+};
+/**
+ * Format date range for display
+ */
+declare function formatDateRange(start: Date, end: Date): string;
+
+/**
+ * Create a new event with default values
+ */
+declare function createDefaultEvent(startDate: Date, duration?: number): Omit<IEvent, "id">;
+/**
+ * Generate a unique ID for an event
+ */
+declare function generateEventId(): string;
+/**
+ * Calculate new event dates after drag and drop
+ */
+declare function calculateDropDates(event: IEvent, newStartDate: Date): {
+    startDate: string;
+    endDate: string;
+};
+/**
+ * Snap a date to the nearest time interval
+ */
+declare function snapToInterval(date: Date, intervalMinutes?: number): Date;
+
+interface EventBadgeProps extends Omit<IEventBadgeProps, "onClick"> {
+    className?: string;
+    showTime?: boolean;
+    compact?: boolean;
+    onClick?: (event: IEvent, e: React$1.MouseEvent) => void;
+}
+declare function EventBadge({ event, variant, className, showTime, compact, isDragging, onClick, }: EventBadgeProps): react_jsx_runtime.JSX.Element;
+interface MoreEventsProps {
+    count: number;
+    onClick?: () => void;
+    className?: string;
+}
+declare function MoreEvents({ count, onClick, className }: MoreEventsProps): react_jsx_runtime.JSX.Element;
+interface TimeIndicatorProps {
+    className?: string;
+}
+declare function TimeIndicator({ className }: TimeIndicatorProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * Date Badge Component
+ * Based on big-calendar by Leonardo Ramos (MIT License)
+ * https://github.com/lramos33/big-calendar
+ *
+ * Adapted for J3M UI with Tailwind v4 and design token integration.
+ */
+interface DateBadgeProps {
+    date: Date;
+    className?: string;
+}
+declare function DateBadge({ date, className }: DateBadgeProps): react_jsx_runtime.JSX.Element;
+
+interface MonthViewProps extends Partial<IViewProps> {
+    className?: string;
+    maxEventsPerDay?: number;
+    weekStartsOn?: 0 | 1 | 2 | 3 | 4 | 5 | 6;
+    onMoreClick?: (date: Date, events: IEvent[]) => void;
+}
+declare function MonthView({ className, maxEventsPerDay, weekStartsOn, onEventClick, onDateClick, onMoreClick, }: MonthViewProps): react_jsx_runtime.JSX.Element;
+
+interface WeekViewProps extends Partial<IViewProps> {
+    className?: string;
+    weekStartsOn?: 0 | 1 | 2 | 3 | 4 | 5 | 6;
+    onTimeClick?: (date: Date, hour: number, minute: number) => void;
+}
+declare function WeekView({ className, weekStartsOn, onEventClick, onDateClick, onTimeClick, }: WeekViewProps): react_jsx_runtime.JSX.Element;
+
+interface DayViewProps extends Partial<IViewProps> {
+    className?: string;
+    showSidebar?: boolean;
+    onTimeClick?: (date: Date, hour: number, minute: number) => void;
+}
+declare function DayView({ className, showSidebar, onEventClick, onTimeClick, }: DayViewProps): react_jsx_runtime.JSX.Element;
+
+interface YearViewProps extends Partial<IViewProps> {
+    className?: string;
+    weekStartsOn?: 0 | 1 | 2 | 3 | 4 | 5 | 6;
+    onMonthClick?: (date: Date) => void;
+}
+declare function YearView({ className, weekStartsOn, onMonthClick, onDateClick, }: YearViewProps): react_jsx_runtime.JSX.Element;
+
+interface AgendaViewProps extends Partial<IViewProps> {
+    className?: string;
+    emptyMessage?: string;
+}
+declare function AgendaView({ className, emptyMessage, onEventClick, onDateClick, }: AgendaViewProps): react_jsx_runtime.JSX.Element;
+
+interface CalendarHeaderProps extends ICalendarHeaderProps {
+    className?: string;
+    showAddButton?: boolean;
+    onAddClick?: () => void;
+}
+declare function CalendarHeader({ className, showViewSwitcher, showUserFilter, showBadgeVariant, // Hidden by default, controlled via settings
+showToday, showAddButton, onAddClick, }: CalendarHeaderProps): react_jsx_runtime.JSX.Element;
+interface CalendarHeaderCompactProps {
+    className?: string;
+    showAddButton?: boolean;
+    onAddClick?: () => void;
+}
+declare function CalendarHeaderCompact({ className, showAddButton, onAddClick, }: CalendarHeaderCompactProps): react_jsx_runtime.JSX.Element;
+
+interface EventDialogProps {
+    open: boolean;
+    onOpenChange: (open: boolean) => void;
+    mode?: "add" | "edit";
+    event?: IEvent | null;
+    defaultDate?: Date;
+    defaultUserId?: string;
+}
+declare function EventDialog({ open, onOpenChange, mode, event, defaultDate, defaultUserId, }: EventDialogProps): react_jsx_runtime.JSX.Element;
+interface QuickAddEventProps {
+    date: Date;
+    onAdd: (event: Omit<IEvent, "id">) => void;
+    onOpenDialog: () => void;
+    onClose: () => void;
+}
+declare function QuickAddEvent({ date, onAdd, onOpenDialog, onClose, }: QuickAddEventProps): react_jsx_runtime.JSX.Element;
+
+declare const DragContext: React$1.Context<IDragContext | null>;
+interface DragProviderProps {
+    children: React$1.ReactNode;
+    snapMinutes?: number;
+    onDragStart?: (event: IEvent) => void;
+    onDragEnd?: (event: IEvent, newStart: Date, newEnd: Date) => void;
+}
+declare function DragProvider({ children, snapMinutes, onDragStart, onDragEnd, }: DragProviderProps): react_jsx_runtime.JSX.Element;
+declare function useDrag(): IDragContext;
+interface DraggableEventProps {
+    event: IEvent;
+    children: React$1.ReactNode;
+    disabled?: boolean;
+}
+declare function DraggableEvent({ event, children, disabled, }: DraggableEventProps): react_jsx_runtime.JSX.Element;
+interface DroppableZoneProps {
+    date: Date;
+    children: React$1.ReactNode;
+    onDrop?: (event: IEvent, date: Date) => void;
+    className?: string;
+}
+declare function DroppableZone({ date, children, onDrop, className, }: DroppableZoneProps): react_jsx_runtime.JSX.Element;
+interface UseDroppableOptions {
+    date: Date;
+    hour?: number;
+    minute?: number;
+    onDrop?: (event: IEvent, newDate: Date) => void;
+}
+declare function useDroppable({ date, hour, minute, onDrop }: UseDroppableOptions): {
+    isOver: boolean;
+    dropProps: {
+        onDragOver: (e: React$1.DragEvent) => void;
+        onDragLeave: () => void;
+        onDrop: (e: React$1.DragEvent) => void;
+        "data-drag-over": boolean;
+    };
+};
+declare function useDraggable(event: IEvent, disabled?: boolean): {
+    isDragged: boolean;
+    dragProps: {
+        draggable: boolean;
+        onDragStart: (e: React$1.DragEvent) => void;
+        onDragEnd: () => void;
+        style: {
+            cursor: string;
+        };
+    };
+};
+
+/**
+ * Calendar Settings Panel
+ * Based on big-calendar by Leonardo Ramos (MIT License)
+ * https://github.com/lramos33/big-calendar
+ */
+interface CalendarSettingsPanelProps {
+    className?: string;
+    showBadgeVariant?: boolean;
+    showVisibleHours?: boolean;
+    showWorkingHours?: boolean;
+}
+declare function CalendarSettingsPanel({ className, showBadgeVariant, showVisibleHours, showWorkingHours, }: CalendarSettingsPanelProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * Badge Variant Input
+ * Based on big-calendar by Leonardo Ramos (MIT License)
+ * https://github.com/lramos33/big-calendar
+ */
+declare function ChangeBadgeVariantInput(): react_jsx_runtime.JSX.Element;
+
+/**
+ * Visible Hours Input
+ * Based on big-calendar by Leonardo Ramos (MIT License)
+ * https://github.com/lramos33/big-calendar
+ */
+declare function ChangeVisibleHoursInput(): react_jsx_runtime.JSX.Element;
+
+/**
+ * Working Hours Input
+ * Based on big-calendar by Leonardo Ramos (MIT License)
+ * https://github.com/lramos33/big-calendar
+ */
+declare function ChangeWorkingHoursInput(): react_jsx_runtime.JSX.Element;
+
+interface BigCalendarProps extends Omit<EventCalendarProviderProps, "children"> {
+    className?: string;
+    compact?: boolean | "auto";
+    bordered?: boolean;
+    showHeader?: boolean;
+    showAddButton?: boolean;
+    showSettings?: boolean;
+    enableDragDrop?: boolean;
+    weekStartsOn?: 0 | 1 | 2 | 3 | 4 | 5 | 6;
+    maxEventsPerDay?: number;
+    config?: ICalendarConfig;
+}
+declare function BigCalendar({ className, compact, bordered, showHeader, showAddButton, showSettings, enableDragDrop, weekStartsOn, maxEventsPerDay, config, ...providerProps }: BigCalendarProps): react_jsx_runtime.JSX.Element;
+
+export { Accordion, AccordionContent, AccordionItem, AccordionTrigger, AgendaView, type AgendaViewProps, Alert, AlertDescription, AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogOverlay, AlertDialogPortal, AlertDialogTitle, AlertDialogTrigger, AlertTitle, AspectRatio, Avatar, AvatarFallback, AvatarImage, BADGE_VARIANT_LABELS, Badge, BigCalendar, type BigCalendarProps, Breadcrumb, BreadcrumbEllipsis, BreadcrumbItem, BreadcrumbLink, BreadcrumbList, BreadcrumbPage, BreadcrumbSeparator, Button, ButtonGroup, ButtonGroupSeparator, ButtonGroupText, type ButtonProps, Calendar, CalendarContext, CalendarDayButton, CalendarHeader, CalendarHeaderCompact, type CalendarHeaderCompactProps, type CalendarHeaderProps, CalendarSettingsPanel, type CalendarSettingsPanelProps, Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, Carousel, type CarouselApi, CarouselContent, CarouselItem, CarouselNext, CarouselPrevious, ChangeBadgeVariantInput, ChangeVisibleHoursInput, ChangeWorkingHoursInput, type ChartConfig, ChartContainer, ChartLegend, ChartLegendContent, ChartStyle, ChartTooltip, ChartTooltipContent, Checkbox, Collapsible, CollapsibleContent, CollapsibleTrigger, Command, CommandDialog, CommandEmpty, CommandGroup, CommandInput, CommandItem, CommandList, CommandSeparator, CommandShortcut, ContextMenu, ContextMenuCheckboxItem, ContextMenuContent, ContextMenuGroup, ContextMenuItem, ContextMenuLabel, ContextMenuPortal, ContextMenuRadioGroup, ContextMenuRadioItem, ContextMenuSeparator, ContextMenuShortcut, ContextMenuSub, ContextMenuSubContent, ContextMenuSubTrigger, ContextMenuTrigger, DEFAULT_VISIBLE_HOURS, DEFAULT_WORKING_HOURS, DateBadge, type DateBadgeProps, DayView, type DayViewProps, Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger, DragContext, DragProvider, type DragProviderProps, DraggableEvent, type DraggableEventProps, Drawer, DrawerClose, DrawerContent, DrawerDescription, DrawerFooter, DrawerHeader, DrawerOverlay, DrawerPortal, DrawerTitle, DrawerTrigger, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, DroppableZone, type DroppableZoneProps, EVENT_COLORS, Empty, EmptyContent, EmptyDescription, EmptyHeader, EmptyMedia, EmptyTitle, EventBadge, type EventBadgeProps, EventCalendarProvider, type EventCalendarProviderProps, EventDialog, type EventDialogProps, Field, FieldContent, FieldDescription, FieldError, FieldGroup, FieldLabel, FieldLegend, FieldSeparator, FieldSet, FieldTitle, Form, FormControl, FormDescription, FormField, FormItem, FormLabel, FormMessage, HoverCard, HoverCardContent, HoverCardTrigger, type ICalendarActions, type ICalendarCell, type ICalendarConfig, type ICalendarContext, type ICalendarHeaderProps, type ICalendarState, type IDayCellProps, type IDragContext, type IEvent, type IEventBadgeProps, type IEventDialogProps, type IEventPosition, type ITimeSlotProps, type IUser, type IViewProps, type IWorkingHours, Input, InputGroup, InputGroupAddon, InputGroupButton, InputGroupInput, InputGroupText, InputGroupTextarea, Item, ItemActions, ItemContent, ItemDescription, ItemFooter, ItemGroup, ItemHeader, ItemMedia, ItemSeparator, ItemTitle, Kbd, KbdGroup, Label, Menubar, MenubarCheckboxItem, MenubarContent, MenubarGroup, MenubarItem, MenubarLabel, MenubarMenu, MenubarPortal, MenubarRadioGroup, MenubarRadioItem, MenubarSeparator, MenubarShortcut, MenubarSub, MenubarSubContent, MenubarSubTrigger, MenubarTrigger, MonthView, type MonthViewProps, MoreEvents, type MoreEventsProps, NativeSelect, NativeSelectOptGroup, NativeSelectOption, type NavItem, NavMain, type NavProject, NavProjects, NavSecondary, NavUser, NavigationMenu, NavigationMenuContent, NavigationMenuIndicator, NavigationMenuItem, NavigationMenuLink, NavigationMenuList, NavigationMenuTrigger, NavigationMenuViewport, Pagination, PaginationContent, PaginationEllipsis, PaginationItem, PaginationLink, PaginationNext, PaginationPrevious, PlayerCanvas, PlayerCanvasActionButton, PlayerCanvasControls, PlayerCanvasDivider, PlayerCanvasInfo, PlayerCanvasLabel, PlayerCanvasPlayButton, PlayerCanvasProgress, PlayerCanvasSkipButton, PlayerCanvasTitle, Popover, PopoverAnchor, PopoverContent, PopoverTrigger, Progress, QuickAddEvent, type QuickAddEventProps, RadioGroup, RadioGroupItem, ResizableHandle, ResizablePanel, ResizablePanelGroup, ScrollArea, ScrollBar, SearchForm, SearchTrigger, type SearchTriggerProps, Section, SectionContent, SectionDescription, SectionFooter, SectionHeader, type SectionProps, SectionTitle, Select, SelectContent, SelectGroup, SelectItem, SelectLabel, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectValue, Separator, Sheet, SheetBody, SheetClose, SheetContent, SheetDescription, SheetFooter, SheetHeader, SheetTitle, SheetTrigger, Sidebar, SidebarContent, SidebarFooter, SidebarGroup, SidebarGroupAction, SidebarGroupContent, SidebarGroupLabel, SidebarHeader, SidebarInput, SidebarInset, SidebarMenu, SidebarMenuAction, SidebarMenuBadge, SidebarMenuButton, SidebarMenuItem, SidebarMenuSkeleton, SidebarMenuSub, SidebarMenuSubButton, SidebarMenuSubItem, SidebarProvider, SidebarRail, SidebarSeparator, SidebarTrigger, SiteHeader, Skeleton, Slider, Spinner, Switch, type TBadgeVariant, type TCalendarView, type TEventColor, type TVisibleHours, type TWorkingHours, Table, TableBody, TableCaption, TableCell, TableFooter, TableHead, TableHeader, TableRow, Tabs, TabsContent, TabsList, TabsTrigger, Textarea, TimeIndicator, type TimeIndicatorProps, Toaster, Toggle, ToggleGroup, ToggleGroupItem, ToolBarCanvas, ToolBarCanvasButton, ToolBarCanvasDivider, ToolBarCanvasGroup, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, type UseDroppableOptions, type UserAvatarItem, UserAvatarsDropdown, type UserAvatarsDropdownProps, VIEW_LABELS, WeekView, type WeekViewProps, YearView, type YearViewProps, badgeVariants, buttonGroupVariants, buttonVariants, calculateDropDates, calculateMonthEventPositions, cardVariants, createDefaultEvent, formatDateRange, formatTime, generateEventId, getCalendarCells, getCurrentEvents, getDayHours, getEventBlockStyle, getEventDuration, getEventDurationMinutes, getEventsCount, getEventsForDate, getEventsInRange, getHeaderLabel, getMonthCellEvents, getMonthDays, getTimeHeight, getTimePosition, getViewDateRange, getVisibleHours, getWeekDayNames, getWeekDays, getYearMonths, groupEvents, isMultiDayEvent, isWorkingHour, navigateDate, navigationMenuTriggerStyle, playerCanvasPlayButtonVariants, playerCanvasSkipButtonVariants, rangeText, sectionVariants, snapToInterval, sortEvents, splitEventsByDuration, toggleVariants, toolBarCanvasButtonVariants, useDrag, useDraggable, useDroppable, useEventCalendar, useEventsInRange, useFilteredEvents, useFormField, useIsMobile, useSearchShortcut, useSidebar };