@underverse-ui/underverse 0.1.37 → 0.2.0

package/dist/index.d.ts

@@ -684,6 +684,128 @@ declare const DateRangePicker: React$1.FC<{
     className?: string;
 }>;
 
+type TimeFormat = "24" | "12";
+type TimePickerVariant = "default" | "compact" | "inline";
+interface TimePickerProps extends Omit<React$1.HTMLAttributes<HTMLDivElement>, "onChange"> {
+    value?: string;
+    defaultValue?: string;
+    onChange?: (value: string | undefined) => void;
+    placeholder?: string;
+    disabled?: boolean;
+    size?: "sm" | "md" | "lg";
+    label?: string;
+    required?: boolean;
+    format?: TimeFormat;
+    includeSeconds?: boolean;
+    minuteStep?: number;
+    secondStep?: number;
+    clearable?: boolean;
+    /** Visual variant of the picker */
+    variant?: TimePickerVariant;
+    /** Show "Now" button */
+    showNow?: boolean;
+    /** Show time presets (Morning, Afternoon, Evening) */
+    showPresets?: boolean;
+    /** Enable manual input */
+    allowManualInput?: boolean;
+    /** Custom presets with labels and times */
+    customPresets?: Array<{
+        label: string;
+        time: string;
+    }>;
+    /** Minimum allowed time (e.g., "09:00") */
+    minTime?: string;
+    /** Maximum allowed time (e.g., "18:00") */
+    maxTime?: string;
+    /** Disabled times function or array */
+    disabledTimes?: ((time: string) => boolean) | string[];
+    /** Show validation feedback */
+    error?: string;
+    /** Success state */
+    success?: boolean;
+    /** Helper text */
+    helperText?: string;
+    /** Enable smooth animations */
+    animate?: boolean;
+    /** Callback when popover opens */
+    onOpen?: () => void;
+    /** Callback when popover closes */
+    onClose?: () => void;
+}
+declare function TimePicker({ value, defaultValue, onChange, placeholder, disabled, size, label, required, format, includeSeconds, minuteStep, secondStep, clearable, variant, showNow, showPresets, allowManualInput, customPresets, minTime, maxTime, disabledTimes, error, success, helperText, animate, onOpen, onClose, className, ...rest }: TimePickerProps): react_jsx_runtime.JSX.Element;
+
+type SelectMode = "single" | "multiple" | "range";
+type Variant$3 = "default" | "bordered" | "card" | "minimal";
+type DisplayMode = "month" | "week" | "year";
+interface CalendarEvent {
+    date: Date | string;
+    title?: string;
+    color?: string;
+    badge?: string;
+}
+interface CalendarProps extends Omit<React$1.HTMLAttributes<HTMLDivElement>, 'defaultValue' | 'value' | 'onSelect'> {
+    month?: Date;
+    defaultMonth?: Date;
+    onMonthChange?: (next: Date) => void;
+    value?: Date | Date[] | {
+        start?: Date;
+        end?: Date;
+    };
+    defaultValue?: Date | Date[] | {
+        start?: Date;
+        end?: Date;
+    };
+    onSelect?: (value: Date | Date[] | {
+        start?: Date;
+        end?: Date;
+    }) => void;
+    selectMode?: SelectMode;
+    weekStartsOn?: 0 | 1 | 2 | 3 | 4 | 5 | 6;
+    showWeekdays?: boolean;
+    showHeader?: boolean;
+    size?: "sm" | "md" | "lg" | "xl";
+    variant?: Variant$3;
+    events?: CalendarEvent[];
+    renderDay?: (args: {
+        date: Date;
+        isCurrentMonth: boolean;
+        isToday: boolean;
+        isSelected: boolean;
+        events: CalendarEvent[];
+    }) => React$1.ReactNode;
+    labels?: {
+        weekdays?: string[];
+        month?: (date: Date) => string;
+        prev?: string;
+        next?: string;
+        today?: string;
+        clear?: string;
+    };
+    /** Display mode: month grid, single week, or year */
+    display?: DisplayMode;
+    /** Number of months to render side-by-side (month mode only) */
+    months?: number;
+    /** Show "Today" button */
+    showToday?: boolean;
+    /** Show "Clear" button */
+    showClear?: boolean;
+    /** Minimum selectable date */
+    minDate?: Date;
+    /** Maximum selectable date */
+    maxDate?: Date;
+    /** Disabled dates */
+    disabledDates?: Date[] | ((date: Date) => boolean);
+    /** Dense mode with less padding */
+    dense?: boolean;
+    /** Animate transitions */
+    animate?: boolean;
+    /** Show event badges */
+    showEventBadges?: boolean;
+    /** Highlight weekends */
+    highlightWeekends?: boolean;
+}
+declare function Calendar({ month, defaultMonth, onMonthChange, value, defaultValue, onSelect, selectMode, weekStartsOn, showWeekdays, showHeader, size, variant, events, renderDay, labels, className, display, months, showToday, showClear, minDate, maxDate, disabledDates, dense, animate, showEventBadges, highlightWeekends, ...rest }: CalendarProps): react_jsx_runtime.JSX.Element;
+
 type ComboboxOption = string | {
     label: string;
     value: any;
@@ -889,13 +1011,13 @@ interface ImageUploadProps {
 declare function ImageUpload({ onUpload, onRemove, maxSize, // Convert bytes to MB
 accept, multiple, disabled, className, showPreview, previewSize, dragDropText, browseText, supportedFormatsText }: ImageUploadProps): react_jsx_runtime.JSX.Element;
 
-type AnimationVariant = "slide" | "fade" | "scale";
+type AnimationVariant$1 = "slide" | "fade" | "scale";
 type Orientation = "horizontal" | "vertical";
 interface CarouselProps {
     children: React$1.ReactNode[];
     autoScroll?: boolean;
     autoScrollInterval?: number;
-    animation?: AnimationVariant;
+    animation?: AnimationVariant$1;
     orientation?: Orientation;
     showArrows?: boolean;
     showDots?: boolean;
@@ -945,6 +1067,268 @@ interface FallingIconsProps {
 }
 declare function FallingIcons({ icon: Icon, imageUrl, count, className, areaClassName, colorClassName, zIndex, speedRange, sizeRange, horizontalDrift, spin, fullScreen, randomizeEachLoop, glow, glowColor, glowIntensity, trail, trailLength, physics, easingFunction, }: FallingIconsProps): react_jsx_runtime.JSX.Element;
 
+type Variant$2 = "plain" | "outlined" | "soft" | "bordered" | "card" | "flush" | "striped";
+type Size$1 = "xs" | "sm" | "md" | "lg";
+interface ListProps extends React$1.HTMLAttributes<HTMLUListElement> {
+    as?: "ul" | "ol" | "div";
+    ordered?: boolean;
+    variant?: Variant$2;
+    size?: Size$1;
+    divided?: boolean;
+    inset?: boolean;
+    hoverable?: boolean;
+    /** Show loading skeleton */
+    loading?: boolean;
+    /** Number of skeleton items to show */
+    loadingCount?: number;
+    /** Show empty state when no children */
+    emptyText?: string;
+    /** Make items more compact */
+    dense?: boolean;
+}
+interface ListItemProps extends React$1.HTMLAttributes<HTMLLIElement> {
+    as?: "li" | "div" | "a" | "button";
+    selected?: boolean;
+    disabled?: boolean;
+    href?: string;
+    label?: React$1.ReactNode;
+    description?: React$1.ReactNode;
+    leftIcon?: React$1.ComponentType<{
+        className?: string;
+    }>;
+    rightIcon?: React$1.ComponentType<{
+        className?: string;
+    }>;
+    /** Show avatar on the left */
+    avatar?: string | React$1.ReactNode;
+    /** Show badge/tag */
+    badge?: React$1.ReactNode;
+    /** Badge color variant */
+    badgeVariant?: "default" | "success" | "warning" | "error" | "info";
+    /** Action button on hover */
+    action?: React$1.ReactNode;
+    /** Make item collapsible */
+    collapsible?: boolean;
+    /** Expanded state for collapsible */
+    expanded?: boolean;
+    /** Callback when expanded state changes */
+    onExpandChange?: (expanded: boolean) => void;
+    /** Content to show when expanded */
+    expandContent?: React$1.ReactNode;
+}
+declare const ListItem: React$1.ForwardRefExoticComponent<ListItemProps & React$1.RefAttributes<HTMLLIElement>>;
+declare const List: React$1.ForwardRefExoticComponent<ListProps & React$1.RefAttributes<HTMLUListElement>> & {
+    Item: React$1.ForwardRefExoticComponent<ListItemProps & React$1.RefAttributes<HTMLLIElement>>;
+};
+
+type WatermarkPreset = "confidential" | "draft" | "sample" | "copyright" | "doNotCopy" | "internal";
+type WatermarkPattern = "diagonal" | "grid" | "straight";
+type AnimationVariant = "fade" | "slide" | "scale" | "pulse" | "none";
+interface WatermarkProps extends React$1.HTMLAttributes<HTMLDivElement> {
+    text?: string | string[];
+    image?: string;
+    width?: number;
+    height?: number;
+    gapX?: number;
+    gapY?: number;
+    rotate?: number;
+    fontSize?: number;
+    fontFamily?: string;
+    fontWeight?: number | string;
+    fontStyle?: "normal" | "italic";
+    color?: string;
+    /** Use gradient colors */
+    gradient?: string;
+    opacity?: number;
+    offsetLeft?: number;
+    offsetTop?: number;
+    zIndex?: number;
+    fullPage?: boolean;
+    /** Preset watermark styles */
+    preset?: WatermarkPreset;
+    /** Pattern layout */
+    pattern?: WatermarkPattern;
+    /** Enable interactive mode (click to toggle) */
+    interactive?: boolean;
+    /** Animation effect */
+    animate?: boolean;
+    /** Animation variant */
+    animationVariant?: AnimationVariant;
+    /** Enable backdrop blur */
+    blur?: boolean;
+    /** Blur amount in pixels */
+    blurAmount?: number;
+    /** Enable text shadow/glow */
+    textShadow?: boolean;
+    /** Text shadow color */
+    shadowColor?: string;
+    /** Enable dark mode auto-adjust */
+    darkMode?: boolean;
+    /** Class for the overlay layer */
+    overlayClassName?: string;
+    /** ARIA label for accessibility */
+    ariaLabel?: string;
+}
+declare const Watermark: React$1.FC<WatermarkProps>;
+
+type Align = "left" | "right" | "alternate";
+type Variant$1 = "default" | "outlined" | "card" | "minimal" | "modern" | "gradient";
+type Size = "sm" | "md" | "lg" | "xl";
+type Mode = "vertical" | "horizontal";
+type LineStyle = "solid" | "dashed" | "dotted";
+interface TimelineProps extends React$1.HTMLAttributes<HTMLDivElement> {
+    align?: Align;
+    variant?: Variant$1;
+    size?: Size;
+    mode?: Mode;
+    lineColor?: string;
+    lineStyle?: LineStyle;
+    items?: TimelineItemProps[];
+    itemClassName?: string;
+    /** Animate items on mount */
+    animate?: boolean;
+    /** Compact spacing */
+    dense?: boolean;
+    /** Show connecting line */
+    showLine?: boolean;
+}
+interface TimelineItemProps extends Omit<React$1.HTMLAttributes<HTMLDivElement>, 'title'> {
+    title?: React$1.ReactNode;
+    description?: React$1.ReactNode;
+    time?: React$1.ReactNode;
+    icon?: React$1.ComponentType<{
+        className?: string;
+    }>;
+    status?: "default" | "primary" | "success" | "warning" | "error" | "info";
+    color?: string;
+    active?: boolean;
+    /** Custom dot content */
+    dot?: React$1.ReactNode;
+    /** Make item collapsible */
+    collapsible?: boolean;
+    /** Expanded state for collapsible */
+    expanded?: boolean;
+    /** Callback when expanded state changes */
+    onExpandChange?: (expanded: boolean) => void;
+    /** Content to show when expanded */
+    expandContent?: React$1.ReactNode;
+    /** Custom badge/tag */
+    badge?: React$1.ReactNode;
+}
+declare const TimelineItem: React$1.ForwardRefExoticComponent<TimelineItemProps & React$1.RefAttributes<HTMLDivElement>>;
+declare const Timeline: React$1.ForwardRefExoticComponent<TimelineProps & React$1.RefAttributes<HTMLDivElement>> & {
+    Item: React$1.ForwardRefExoticComponent<TimelineItemProps & React$1.RefAttributes<HTMLDivElement>>;
+};
+
+type OutputFormat = "hex" | "rgba" | "hsl" | "hsla";
+type ColorPickerSize = "sm" | "md" | "lg";
+type ColorPickerVariant = "default" | "compact" | "full" | "minimal";
+interface ColorPickerProps extends Omit<React$1.HTMLAttributes<HTMLDivElement>, "onChange"> {
+    value?: string;
+    defaultValue?: string;
+    onChange?: (value: string) => void;
+    disabled?: boolean;
+    withAlpha?: boolean;
+    format?: OutputFormat;
+    presets?: string[];
+    /** Class for the trigger button */
+    triggerClassName?: string;
+    /** Class for the popover content panel */
+    contentClassName?: string;
+    /** Show a clear button to reset to empty */
+    clearable?: boolean;
+    /** Show copy to clipboard button */
+    copyable?: boolean;
+    /** Size variant of the picker */
+    size?: ColorPickerSize;
+    /** Visual variant of the picker */
+    variant?: ColorPickerVariant;
+    /** Show recent colors history */
+    showRecent?: boolean;
+    /** Show color harmony suggestions */
+    showHarmony?: boolean;
+    /** Max recent colors to remember */
+    maxRecent?: number;
+}
+declare function ColorPicker({ value, defaultValue, onChange, disabled, withAlpha, format, presets, className, triggerClassName, contentClassName, clearable, copyable, size, variant, showRecent, showHarmony, maxRecent, ...rest }: ColorPickerProps): react_jsx_runtime.JSX.Element;
+
+type Breakpoint = "sm" | "md" | "lg" | "xl" | "2xl";
+type ResponsiveConfig = Partial<{
+    columns: number | string;
+    rows: number | string;
+    minColumnWidth: number | string;
+    gap: number | string;
+    gapX: number | string;
+    gapY: number | string;
+}>;
+type GridVariant = "default" | "bordered" | "card" | "flat" | "glass";
+type GridAutoFlow = "row" | "column" | "row dense" | "column dense";
+interface GridProps extends React__default.HTMLAttributes<HTMLDivElement> {
+    /** Number of columns or full template string. Default: 12 (1fr each). */
+    columns?: number | string;
+    /** Number of rows or full template string. */
+    rows?: number | string;
+    /** Overall gap (shorthand). */
+    gap?: number | string;
+    /** Horizontal gap. */
+    gapX?: number | string;
+    /** Vertical gap. */
+    gapY?: number | string;
+    /** Auto rows value (e.g. 'minmax(100px, auto)'). */
+    autoRows?: string;
+    /** Auto columns value (e.g. 'minmax(100px, 1fr)'). */
+    autoColumns?: string;
+    /** Grid auto-flow direction and density. */
+    autoFlow?: GridAutoFlow;
+    /** Use auto-fit with a min width to create responsive columns. */
+    minColumnWidth?: number | string;
+    /** CSS grid-template-areas. Provide full string or joined lines. */
+    areas?: string | string[];
+    /** Item alignment within cells. */
+    alignItems?: React__default.CSSProperties["alignItems"];
+    justifyItems?: React__default.CSSProperties["justifyItems"];
+    /** Grid content alignment. */
+    alignContent?: React__default.CSSProperties["alignContent"];
+    justifyContent?: React__default.CSSProperties["justifyContent"];
+    /** Responsive overrides by breakpoint (Tailwind defaults). */
+    responsive?: Partial<Record<Breakpoint, ResponsiveConfig>>;
+    /** Visual variant style. */
+    variant?: GridVariant;
+    /** Enable smooth animations for grid layout changes. */
+    animated?: boolean;
+    /** Apply Card-like outline (rounded + border + bg-card). @deprecated Use variant="card" instead */
+    outlined?: boolean;
+}
+interface GridItemProps extends React__default.HTMLAttributes<HTMLDivElement> {
+    /** Column span (e.g., 3 => span 3). */
+    colSpan?: number | string;
+    /** Row span. */
+    rowSpan?: number | string;
+    /** Column start line. */
+    colStart?: number | string;
+    /** Column end line. */
+    colEnd?: number | string;
+    /** Row start line. */
+    rowStart?: number | string;
+    /** Row end line. */
+    rowEnd?: number | string;
+    /** Named area (must match container areas). */
+    area?: string;
+    /** Item alignment override. */
+    alignSelf?: React__default.CSSProperties["alignSelf"];
+    justifySelf?: React__default.CSSProperties["justifySelf"];
+    /** Order of the item in the grid. */
+    order?: number;
+    /** Add hover effect. */
+    hoverable?: boolean;
+    /** Add animation delay (in ms). */
+    animationDelay?: number;
+}
+declare const GridItem: React__default.ForwardRefExoticComponent<GridItemProps & React__default.RefAttributes<HTMLDivElement>>;
+declare const Grid: React__default.ForwardRefExoticComponent<GridProps & React__default.RefAttributes<HTMLDivElement>> & {
+    Item: React__default.ForwardRefExoticComponent<GridItemProps & React__default.RefAttributes<HTMLDivElement>>;
+};
+
 interface ClientOnlyProps {
     children: React.ReactNode;
     fallback?: React.ReactNode;
@@ -1498,4 +1882,4 @@ declare function getUnderverseMessages(locale?: UnderverseLocale): {
     };
 };
 
-export { AccessDenied, Alert, Avatar, Badge, Badge as BadgeBase, BatteryProgress, BottomSheet, Breadcrumb, Button, ButtonLoading, type ButtonProps, Card, Carousel, CategoryTreeSelect, Checkbox, type CheckboxProps, CircularProgress, ClientOnly, Combobox, type ComboboxProps, CompactPagination, type CompactPaginationProps, DataTable, type DataTableColumn, type DataTableQuery, DatePicker, type DatePickerProps, DateRangePicker, date as DateUtils, Drawer, DropdownMenu, DropdownMenuItem, DropdownMenuSeparator, FallingIcons, FloatingContacts, Form, FormActions, FormCheckbox, FormControl, FormDescription, FormField, FormInput, FormItem, FormLabel, FormMessage, FormSubmitButton, GlobalLoading, GradientBadge, ImageUpload, InlineLoading, Input, type InputProps, InteractiveBadge, Label, type LanguageOption, LanguageSwitcherHeadless as LanguageSwitcher, LanguageSwitcherHeadless, type LanguageSwitcherHeadlessProps, type LanguageSwitcherHeadlessProps as LanguageSwitcherProps, LoadingBar, LoadingDots, LoadingProgress, LoadingSpinner, MiniProgress, Modal, MultiCombobox, type MultiComboboxProps, NotificationBadge, NotificationModal, NumberInput, OverlayControls, PageLoading, Pagination, type PaginationProps, PasswordInput, PillTabs, Popover, Progress, PulseBadge, RadioGroup, RadioGroupItem, SIZE_STYLES_BTN, ScrollArea, SearchInput, Section, SegmentedProgress, SelectDropdown, Sheet, SidebarSheet, SimplePagination, type SimplePaginationProps, SimpleTabs, Skeleton, SkeletonAvatar, SkeletonButton, SkeletonCard, SkeletonList, SkeletonMessage, SkeletonPost, SkeletonTable, SkeletonText, SlideOver, Slider, SmartImage, type Sorter, StatusBadge, StepProgress, Switch, Table, TableBody, TableCaption, TableCell, TableFooter, TableHead, TableHeader, TableRow, Tabs, TagBadge, Textarea, type ThemeMode, ThemeToggleHeadless as ThemeToggle, ThemeToggleHeadless, type ThemeToggleHeadlessProps, type ThemeToggleHeadlessProps as ThemeToggleProps, ToastProvider, Tooltip, type UnderverseLocale, VARIANT_STYLES_ALERT, VARIANT_STYLES_BTN, VerticalTabs, cn, getUnderverseMessages, underverseMessages, useFormField, useToast };
+export { AccessDenied, Alert, Avatar, Badge, Badge as BadgeBase, BatteryProgress, BottomSheet, Breadcrumb, Button, ButtonLoading, type ButtonProps, Calendar, type CalendarEvent, type CalendarProps, Card, Carousel, CategoryTreeSelect, Checkbox, type CheckboxProps, CircularProgress, ClientOnly, ColorPicker, type ColorPickerProps, Combobox, type ComboboxProps, CompactPagination, type CompactPaginationProps, DataTable, type DataTableColumn, type DataTableQuery, DatePicker, type DatePickerProps, DateRangePicker, date as DateUtils, Drawer, DropdownMenu, DropdownMenuItem, DropdownMenuSeparator, FallingIcons, FloatingContacts, Form, FormActions, FormCheckbox, FormControl, FormDescription, FormField, FormInput, FormItem, FormLabel, FormMessage, FormSubmitButton, GlobalLoading, GradientBadge, Grid, GridItem, type GridItemProps, type GridProps, ImageUpload, InlineLoading, Input, type InputProps, InteractiveBadge, Label, type LanguageOption, LanguageSwitcherHeadless as LanguageSwitcher, LanguageSwitcherHeadless, type LanguageSwitcherHeadlessProps, type LanguageSwitcherHeadlessProps as LanguageSwitcherProps, List, ListItem, LoadingBar, LoadingDots, LoadingProgress, LoadingSpinner, MiniProgress, Modal, MultiCombobox, type MultiComboboxProps, NotificationBadge, NotificationModal, NumberInput, OverlayControls, PageLoading, Pagination, type PaginationProps, PasswordInput, PillTabs, Popover, Progress, PulseBadge, RadioGroup, RadioGroupItem, SIZE_STYLES_BTN, ScrollArea, SearchInput, Section, SegmentedProgress, SelectDropdown, Sheet, SidebarSheet, SimplePagination, type SimplePaginationProps, SimpleTabs, Skeleton, SkeletonAvatar, SkeletonButton, SkeletonCard, SkeletonList, SkeletonMessage, SkeletonPost, SkeletonTable, SkeletonText, SlideOver, Slider, SmartImage, type Sorter, StatusBadge, StepProgress, Switch, Table, TableBody, TableCaption, TableCell, TableFooter, TableHead, TableHeader, TableRow, Tabs, TagBadge, Textarea, type ThemeMode, ThemeToggleHeadless as ThemeToggle, ThemeToggleHeadless, type ThemeToggleHeadlessProps, type ThemeToggleHeadlessProps as ThemeToggleProps, TimePicker, type TimePickerProps, Timeline, TimelineItem, ToastProvider, Tooltip, type UnderverseLocale, VARIANT_STYLES_ALERT, VARIANT_STYLES_BTN, VerticalTabs, Watermark, type WatermarkProps, cn, getUnderverseMessages, underverseMessages, useFormField, useToast };