@juv/codego-react-ui 3.1.7 → 3.1.8

package/dist/index.d.ts

@@ -6,6 +6,12 @@ type AuthView = "login" | "register" | "resetPassword";
 interface AuthField {
     name: string;
     label: string;
+    type?: "text" | "email" | "password" | "tel" | "url" | "numeric" | "integer";
+    placeholder?: string;
+    required?: boolean;
+    disabled?: boolean;
+    error?: string;
+    revealable?: boolean;
     render?: (value: string, onChange: (v: string) => void) => React.ReactNode;
 }
 type AuthVariant = "default" | "split" | "minimal" | "glass";
@@ -96,375 +102,97 @@ interface BreadcrumbProps {
 }
 declare function Breadcrumb({ items, separator, maxItems, className, }: BreadcrumbProps): react_jsx_runtime.JSX.Element;
 
-interface ButtonProps extends React.ButtonHTMLAttributes<HTMLButtonElement> {
-    variant?: "primary" | "secondary" | "outline" | "ghost" | "link" | "danger" | "success" | "destructive";
-    size?: "xs" | "sm" | "md" | "lg" | "xl";
-    fullWidth?: boolean;
-    width?: number | string;
-    height?: number | string;
-    rounded?: "none" | "sm" | "md" | "lg" | "xl" | "full";
-    bgColor?: string;
-    textColor?: string;
-    borderColor?: string;
-    borderWidth?: number;
-    shadow?: boolean;
-    shadowColor?: string;
-    opacity?: number;
-    gradientFrom?: string;
-    gradientTo?: string;
-    gradientDirection?: "to-r" | "to-l" | "to-t" | "to-b" | "to-tr" | "to-tl" | "to-br" | "to-bl";
-    fontSize?: number;
-    fontWeight?: "normal" | "medium" | "semibold" | "bold";
-    padding?: number | string;
-    margin?: number | string;
-    label?: string;
-    children?: React.ReactNode;
-    leftIcon?: React.ReactNode;
-    rightIcon?: React.ReactNode;
-    iconOnly?: boolean;
-    loading?: boolean;
-    loadingText?: string;
-    loadingPosition?: "left" | "right" | "center";
-    disabled?: boolean;
-    active?: boolean;
-    selected?: boolean;
-    animate?: boolean;
-    transitionDuration?: number;
-    transitionType?: "ease" | "linear" | "spring";
-    hoverScale?: number;
-    hoverOpacity?: number;
-    hoverBgColor?: string;
-    hoverTextColor?: string;
-    hoverBorderColor?: string;
-    activeScale?: number;
-    pressAnimation?: "shrink" | "bounce" | "none";
-    rippleEffect?: boolean;
-    rippleColor?: string;
-    rippleDuration?: number;
-    animationType?: "bounce" | "pulse" | "shake" | "wiggle";
-    loopAnimation?: boolean;
-    animationDelay?: number;
-    fadeIn?: boolean;
-    slideIn?: boolean;
-    slideDirection?: "left" | "right" | "top" | "bottom";
-    onClick?: (e?: any) => void;
-    onDoubleClick?: (e?: any) => void;
-    onMouseEnter?: (e?: any) => void;
-    onMouseLeave?: (e?: any) => void;
-    onMouseDown?: (e?: any) => void;
-    onMouseUp?: (e?: any) => void;
-    onPress?: () => void;
-    onLongPress?: () => void;
-    onPressIn?: () => void;
-    onPressOut?: () => void;
-    onFocus?: () => void;
-    onBlur?: () => void;
-    ariaLabel?: string;
-    role?: string;
-    tabIndex?: number;
-    type?: "button" | "submit" | "reset";
-    preventDefault?: boolean;
-    stopPropagation?: boolean;
-    debounceTime?: number;
-    throttleTime?: number;
-    confirmBeforeClick?: boolean;
-    confirmBeforeClickModalTitle?: string;
-    confirmBeforeClickModalContent?: React.ReactNode;
-    confirmBeforeClickFooterAction?: React.ReactNode;
-    href?: string;
-    target?: "_blank" | "_self";
-    as?: "button" | "a" | "div";
-    className?: string;
-    style?: React.CSSProperties;
-    testID?: string;
+type ToastVariant = "default" | "success" | "error" | "warning" | "info";
+type ToastPosition = "top-left" | "top-center" | "top-right" | "bottom-left" | "bottom-center" | "bottom-right";
+interface ToastItem {
+    id: string;
+    title?: React.ReactNode;
+    description?: React.ReactNode;
+    variant?: ToastVariant;
+    /** Duration in ms before auto-dismiss. 0 = no auto-dismiss */
+    duration?: number;
+    /** Show a progress bar counting down the duration */
+    showProgress?: boolean;
+    /** Custom icon — overrides the variant icon */
+    icon?: React.ReactNode;
+    /** Action button */
+    action?: {
+        label: string;
+        onClick: () => void;
+    };
+    /** Whether the toast can be manually closed */
+    closable?: boolean;
+    /** Override the provider's default position for this toast */
+    position?: ToastPosition;
 }
-declare const Button: React.ForwardRefExoticComponent<ButtonProps & React.RefAttributes<HTMLElement>>;
-
-interface CalendarEvent {
-    id?: string;
-    date: Date;
-    endDate?: Date;
-    label: string;
-    color?: string;
-    allDay?: boolean;
-    description?: string;
+interface ToastContextValue {
+    toast: (item: Omit<ToastItem, "id">) => string;
+    dismiss: (id: string) => void;
+    dismissAll: () => void;
 }
-type CalendarView = "month" | "week" | "day";
-interface CalendarProps {
-    events?: CalendarEvent[];
-    defaultView?: CalendarView;
-    defaultDate?: Date;
-    onEventClick?: (event: CalendarEvent) => void;
-    onDateClick?: (date: Date) => void;
-    onAddEvent?: (date: Date) => void;
-    className?: string;
+declare function useToast(): ToastContextValue;
+interface ToastProviderProps {
+    children: React.ReactNode;
+    /** Default position for all toasts */
+    position?: ToastPosition;
+    /** Max toasts visible at once */
+    maxToasts?: number;
 }
-declare const EVENT_COLORS: string[];
-declare function Calendar({ events, defaultView, defaultDate, onEventClick, onDateClick, onAddEvent, className, }: CalendarProps): react_jsx_runtime.JSX.Element;
-
-declare const Card: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLDivElement> & React.RefAttributes<HTMLDivElement>>;
-declare const CardHeader: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLDivElement> & React.RefAttributes<HTMLDivElement>>;
-declare const CardTitle: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLHeadingElement> & React.RefAttributes<HTMLParagraphElement>>;
-declare const CardDescription: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLParagraphElement> & React.RefAttributes<HTMLParagraphElement>>;
-declare const CardContent: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLDivElement> & React.RefAttributes<HTMLDivElement>>;
-declare const CardFooter: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLDivElement> & React.RefAttributes<HTMLDivElement>>;
-
-interface CheckboxProps extends Omit<React.InputHTMLAttributes<HTMLInputElement>, "type"> {
-    inline?: boolean;
-    label?: React.ReactNode;
-    accepted?: boolean;
-    acceptedColor?: string;
-    declined?: boolean;
-    declinedColor?: string;
-    height?: number | string;
-    width?: number | string;
+declare function ToastProvider({ children, position, maxToasts, }: ToastProviderProps): react_jsx_runtime.JSX.Element;
+type NotificationVariant = "default" | "success" | "error" | "warning" | "info";
+interface NotificationItem {
+    id: string;
+    title: React.ReactNode;
+    description?: React.ReactNode;
+    variant?: NotificationVariant;
+    /** Timestamp label e.g. "2m ago" */
+    time?: string;
+    /** Avatar or icon node shown on the left */
+    avatar?: React.ReactNode;
+    /** Whether the notification has been read */
+    read?: boolean;
+    /** Click handler for the whole row */
+    onClick?: () => void;
+    /** Action buttons */
+    actions?: {
+        label: string;
+        onClick: () => void;
+        variant?: "primary" | "ghost";
+    }[];
 }
-declare const Checkbox: React.ForwardRefExoticComponent<CheckboxProps & React.RefAttributes<HTMLInputElement>>;
-
-interface ColorPickerProps {
-    value?: string;
-    defaultValue?: string;
-    onChange?: (color: string) => void;
-    showOpacity?: boolean;
-    showSwatches?: boolean;
-    disabled?: boolean;
+interface NotificationPanelProps {
+    items: NotificationItem[];
+    /** Header title */
+    title?: string;
+    /** Show a badge with unread count on the bell icon trigger */
+    showBadge?: boolean;
+    /** Called when "Mark all read" is clicked */
+    onMarkAllRead?: () => void;
+    /** Called when "Clear all" is clicked */
+    onClearAll?: () => void;
+    /** Called when a single item is dismissed */
+    onDismiss?: (id: string) => void;
+    /** Empty state message */
+    emptyMessage?: string;
     className?: string;
-}
-declare function ColorPicker({ value: controlled, defaultValue, onChange, showOpacity, showSwatches, disabled, className, }: ColorPickerProps): react_jsx_runtime.JSX.Element;
-
-interface ComboboxOption {
-    value: string;
-    label: string;
-    description?: string;
-    icon?: React.ReactNode;
-    disabled?: boolean;
-    group?: string;
-}
-interface ComboboxProps {
-    options: ComboboxOption[];
-    value?: string | string[];
-    defaultValue?: string | string[];
-    onChange?: (value: string | string[]) => void;
-    placeholder?: string;
-    searchPlaceholder?: string;
-    multiple?: boolean;
-    creatable?: boolean;
-    clearable?: boolean;
-    disabled?: boolean;
+    /** Max height of the list */
     maxHeight?: string;
-    className?: string;
 }
-declare function Combobox({ options, value: controlled, defaultValue, onChange, placeholder, searchPlaceholder, multiple, creatable, clearable, disabled, maxHeight, className, }: ComboboxProps): react_jsx_runtime.JSX.Element;
-
-interface CommandItem {
-    id: string;
-    label: string;
-    description?: string;
+declare function NotificationPanel({ items, title, showBadge, onMarkAllRead, onClearAll, onDismiss, emptyMessage, className, maxHeight, }: NotificationPanelProps): react_jsx_runtime.JSX.Element;
+interface NotificationBannerProps {
+    variant?: NotificationVariant;
+    title?: React.ReactNode;
+    description?: React.ReactNode;
     icon?: React.ReactNode;
-    shortcut?: string;
-    group?: string;
-    onSelect: () => void;
-    keywords?: string[];
-}
-interface CommandPaletteProps {
-    items: CommandItem[];
-    open?: boolean;
-    onOpenChange?: (open: boolean) => void;
-    placeholder?: string;
-    maxRecent?: number;
+    closable?: boolean;
+    onClose?: () => void;
+    action?: {
+        label: string;
+        onClick: () => void;
+    };
     className?: string;
 }
-declare function CommandPalette({ items, open: controlled, onOpenChange, placeholder, maxRecent, className, }: CommandPaletteProps): react_jsx_runtime.JSX.Element;
-
-interface ContextMenuItem {
-    label?: React.ReactNode;
-    icon?: React.ReactNode;
-    shortcut?: string;
-    onClick?: () => void;
-    disabled?: boolean;
-    danger?: boolean;
-    separator?: boolean;
-    children?: ContextMenuItem[];
-}
-interface ContextMenuProps {
-    items: ContextMenuItem[];
-    children: React.ReactNode;
-    className?: string;
-}
-declare function ContextMenu({ items, children, className }: ContextMenuProps): react_jsx_runtime.JSX.Element;
-
-type TrendDir = "up" | "down" | "neutral";
-type SemanticColor = "primary" | "info" | "success" | "warning" | "danger" | "muted";
-interface StatsWidgetProps {
-    title: string;
-    value: string | number;
-    subtitle?: string;
-    icon?: React.ReactNode;
-    iconColor?: SemanticColor;
-    trend?: TrendDir;
-    trendValue?: string;
-    trendLabel?: string;
-    delta?: string | number;
-    sparkline?: number[];
-    sparklineColor?: SemanticColor;
-    progress?: number;
-    progressColor?: SemanticColor;
-    badge?: React.ReactNode;
-    footer?: React.ReactNode;
-    animate?: boolean;
-    loading?: boolean;
-    onClick?: () => void;
-    className?: string;
-}
-declare function StatsWidget({ title, value, subtitle, icon, iconColor, trend, trendValue, trendLabel, delta, sparkline, sparklineColor, progress, progressColor, badge, footer, animate, loading, onClick, className, }: StatsWidgetProps): react_jsx_runtime.JSX.Element;
-interface ChartDataPoint {
-    label: string;
-    value: number;
-    color?: SemanticColor;
-}
-interface ChartWidgetProps {
-    title: string;
-    description?: string;
-    data: ChartDataPoint[];
-    type?: "bar" | "line" | "donut";
-    color?: SemanticColor;
-    height?: number;
-    showLegend?: boolean;
-    showValues?: boolean;
-    showGrid?: boolean;
-    unit?: string;
-    action?: React.ReactNode;
-    footer?: React.ReactNode;
-    loading?: boolean;
-    className?: string;
-}
-declare function ChartWidget({ title, description, data, type, color, height, showLegend, showValues, showGrid, unit, action, footer, loading, className, }: ChartWidgetProps): react_jsx_runtime.JSX.Element;
-interface TableWidgetProps {
-    title: string;
-    description?: string;
-    action?: React.ReactNode;
-    footer?: React.ReactNode;
-    children: React.ReactNode;
-    className?: string;
-}
-declare function TableWidget({ title, description, action, footer, children, className }: TableWidgetProps): react_jsx_runtime.JSX.Element;
-interface ComposableWidgetProps {
-    title?: string;
-    description?: string;
-    headerLeft?: React.ReactNode;
-    headerRight?: React.ReactNode;
-    toolbar?: React.ReactNode;
-    children: React.ReactNode;
-    footer?: React.ReactNode;
-    padding?: "none" | "sm" | "md";
-    className?: string;
-}
-declare function ComposableWidget({ title, description, headerLeft, headerRight, toolbar, children, footer, padding, className, }: ComposableWidgetProps): react_jsx_runtime.JSX.Element;
-interface MetricItem {
-    label: string;
-    value: string | number;
-    trend?: TrendDir;
-    trendValue?: string;
-    color?: SemanticColor;
-}
-interface MetricRowProps {
-    items: MetricItem[];
-    divided?: boolean;
-    className?: string;
-}
-declare function MetricRow({ items, divided, className }: MetricRowProps): react_jsx_runtime.JSX.Element;
-
-type ToastVariant = "default" | "success" | "error" | "warning" | "info";
-type ToastPosition = "top-left" | "top-center" | "top-right" | "bottom-left" | "bottom-center" | "bottom-right";
-interface ToastItem {
-    id: string;
-    title?: React.ReactNode;
-    description?: React.ReactNode;
-    variant?: ToastVariant;
-    /** Duration in ms before auto-dismiss. 0 = no auto-dismiss */
-    duration?: number;
-    /** Show a progress bar counting down the duration */
-    showProgress?: boolean;
-    /** Custom icon — overrides the variant icon */
-    icon?: React.ReactNode;
-    /** Action button */
-    action?: {
-        label: string;
-        onClick: () => void;
-    };
-    /** Whether the toast can be manually closed */
-    closable?: boolean;
-    /** Override the provider's default position for this toast */
-    position?: ToastPosition;
-}
-interface ToastContextValue {
-    toast: (item: Omit<ToastItem, "id">) => string;
-    dismiss: (id: string) => void;
-    dismissAll: () => void;
-}
-declare function useToast(): ToastContextValue;
-interface ToastProviderProps {
-    children: React.ReactNode;
-    /** Default position for all toasts */
-    position?: ToastPosition;
-    /** Max toasts visible at once */
-    maxToasts?: number;
-}
-declare function ToastProvider({ children, position, maxToasts, }: ToastProviderProps): react_jsx_runtime.JSX.Element;
-type NotificationVariant = "default" | "success" | "error" | "warning" | "info";
-interface NotificationItem {
-    id: string;
-    title: React.ReactNode;
-    description?: React.ReactNode;
-    variant?: NotificationVariant;
-    /** Timestamp label e.g. "2m ago" */
-    time?: string;
-    /** Avatar or icon node shown on the left */
-    avatar?: React.ReactNode;
-    /** Whether the notification has been read */
-    read?: boolean;
-    /** Click handler for the whole row */
-    onClick?: () => void;
-    /** Action buttons */
-    actions?: {
-        label: string;
-        onClick: () => void;
-        variant?: "primary" | "ghost";
-    }[];
-}
-interface NotificationPanelProps {
-    items: NotificationItem[];
-    /** Header title */
-    title?: string;
-    /** Show a badge with unread count on the bell icon trigger */
-    showBadge?: boolean;
-    /** Called when "Mark all read" is clicked */
-    onMarkAllRead?: () => void;
-    /** Called when "Clear all" is clicked */
-    onClearAll?: () => void;
-    /** Called when a single item is dismissed */
-    onDismiss?: (id: string) => void;
-    /** Empty state message */
-    emptyMessage?: string;
-    className?: string;
-    /** Max height of the list */
-    maxHeight?: string;
-}
-declare function NotificationPanel({ items, title, showBadge, onMarkAllRead, onClearAll, onDismiss, emptyMessage, className, maxHeight, }: NotificationPanelProps): react_jsx_runtime.JSX.Element;
-interface NotificationBannerProps {
-    variant?: NotificationVariant;
-    title?: React.ReactNode;
-    description?: React.ReactNode;
-    icon?: React.ReactNode;
-    closable?: boolean;
-    onClose?: () => void;
-    action?: {
-        label: string;
-        onClick: () => void;
-    };
-    className?: string;
-}
-declare function NotificationBanner({ variant, title, description, icon, closable, onClose, action, className, }: NotificationBannerProps): react_jsx_runtime.JSX.Element;
+declare function NotificationBanner({ variant, title, description, icon, closable, onClose, action, className, }: NotificationBannerProps): react_jsx_runtime.JSX.Element;
 
 interface ServerPaginationLink {
     page: number;
@@ -520,160 +248,563 @@ interface ServerPaginationProp {
     currentPage: number;
     goToPage: (page: number) => void;
 }
-declare function useServerTable<T extends Record<string, any>>({ url, params, encrypt, key, decryptPayloadLog, columnOverrides }: UseServerTableOptions): UseServerTableReturn<T>;
-type ActionFieldType = "input" | "password" | "textarea" | "checkbox" | "toggle" | "select" | "radio" | "slider" | "tag-input" | "otp" | "combobox" | "color-picker" | "date-range" | "rich-text" | "file-upload" | "repeater";
-interface ActionField {
-    key: string;
+declare function useServerTable<T extends Record<string, any>>({ url, params, encrypt, key, decryptPayloadLog, columnOverrides }: UseServerTableOptions): UseServerTableReturn<T>;
+type ActionFieldType = "input" | "password" | "textarea" | "checkbox" | "toggle" | "select" | "radio" | "slider" | "tag-input" | "otp" | "combobox" | "color-picker" | "date-range" | "rich-text" | "file-upload" | "repeater";
+interface ActionField {
+    key: string;
+    label: string;
+    type?: ActionFieldType;
+    /** HTML input type for type="input" (e.g. "email", "number", "password") */
+    inputType?: string;
+    /** Options for type="select", "radio", "combobox" — string[] or { label, value }[] */
+    options?: string[] | {
+        label: string;
+        value: string;
+    }[];
+    placeholder?: string;
+    required?: boolean;
+    /** Min value for type="slider" */
+    min?: number;
+    /** Max value for type="slider" */
+    max?: number;
+    /** Step for type="slider" */
+    step?: number;
+    /** Number of OTP digits for type="otp" */
+    digits?: number;
+    /** Custom render — overrides built-in field renderer */
+    render?: (value: any, onChange: (v: any) => void) => React.ReactNode;
+}
+/** Controls appearance of a default action button (view / edit / delete) */
+interface ActionButtonConfig {
+    /** Button variant. Defaults: view→"outline", edit→"outline", delete→"danger" */
+    variant?: "primary" | "secondary" | "outline" | "ghost" | "link" | "danger" | "success" | "destructive";
+    size?: "xs" | "sm" | "md" | "lg" | "xl";
+    rounded?: "none" | "sm" | "md" | "lg" | "xl" | "full";
+    gradientFrom?: string;
+    gradientTo?: string;
+    gradientDirection?: "to-r" | "to-l" | "to-t" | "to-b" | "to-tr" | "to-tl" | "to-br" | "to-bl";
+    bgColor?: string;
+    textColor?: string;
+    borderColor?: string;
+    borderWidth?: number;
+    shadow?: boolean;
+    /** Override the default icon */
+    icon?: React.ReactNode;
+    /** Override the default label text */
+    label?: string;
+    /** "icon" = icon only, "text" = label only, "icon-text" = icon + label. Default "icon" */
+    displayMode?: "icon" | "text" | "icon-text";
+    className?: string;
+}
+/** Extra action button appended alongside the default view/edit/delete buttons */
+interface ExtraActionConfig<T> {
+    /** Unique key */
+    key: string;
+    /** Button label */
+    label?: string;
+    /** Icon rendered in the button */
+    icon?: React.ReactNode;
+    /** "icon" | "text" | "icon-text". Default "icon-text" */
+    displayMode?: "icon" | "text" | "icon-text";
+    variant?: "primary" | "secondary" | "outline" | "ghost" | "link" | "danger" | "success" | "destructive";
+    size?: "xs" | "sm" | "md" | "lg" | "xl";
+    rounded?: "none" | "sm" | "md" | "lg" | "xl" | "full";
+    gradientFrom?: string;
+    gradientTo?: string;
+    gradientDirection?: "to-r" | "to-l" | "to-t" | "to-b" | "to-tr" | "to-tl" | "to-br" | "to-bl";
+    bgColor?: string;
+    textColor?: string;
+    borderColor?: string;
+    borderWidth?: number;
+    shadow?: boolean;
+    className?: string;
+    onClick: (item: T) => void;
+}
+interface DefaultActionsConfig<T> {
+    /**
+     * Base URL used to build PUT and DELETE requests.
+     * PUT  → `{baseUrl}/{id}/update`
+     * DELETE → `{baseUrl}/{id}/delete`
+     */
+    baseUrl: string;
+    /** Row key used as the URL id segment. Defaults to "id". */
+    idKey?: keyof T;
+    /** Position of the Actions column. Default "last". */
+    position?: "first" | "last";
+    /** Fields rendered in the Edit modal form. Auto-derived from row keys when omitted. */
+    editForm?: ActionField[];
+    /** Fields rendered in the View modal. Auto-derived from row keys when omitted. */
+    viewForm?: ActionField[];
+    /** Called after a successful edit or delete so the parent can refresh data. */
+    onSuccess?: (action: "edit" | "delete", item: T) => void;
+    /** Show a toast or notification banner on successful edit/delete */
+    onSuccessNotif?: ActionSuccessNotif;
+    /** Customize the View button appearance */
+    viewButton?: ActionButtonConfig;
+    /** Customize the Edit button appearance */
+    editButton?: ActionButtonConfig;
+    /** Customize the Delete button appearance */
+    deleteButton?: ActionButtonConfig;
+    /** Extra action buttons rendered alongside view/edit/delete */
+    extraActions?: ExtraActionConfig<T>[];
+}
+interface ActionSuccessNotif {
+    /** "toast" uses the ToastProvider. "notification" renders an inline banner. Default "toast". */
+    type?: "toast" | "notification";
+    /** Toast position. Only used when type="toast". Default "bottom-right". */
+    toastPosition?: ToastPosition;
+    /** Variant for edit success. Default "success". */
+    editVariant?: ToastVariant;
+    /** Variant for delete success. Default "success". */
+    deleteVariant?: ToastVariant;
+    /** Title for edit success notification */
+    editTitle?: React.ReactNode;
+    /** Body/description for edit success notification */
+    editBody?: React.ReactNode;
+    /** Title for delete success notification */
+    deleteTitle?: React.ReactNode;
+    /** Body/description for delete success notification */
+    deleteBody?: React.ReactNode;
+    /** Extra action element rendered inside the notification */
+    action?: React.ReactNode;
+}
+interface Column<T> {
+    key: keyof T | string;
+    title: string;
+    type?: "text" | "image" | "badge" | "icon" | "stack" | "select" | "toggle" | "color" | "checkbox";
+    stackProps?: {
+        limit?: number;
+        stacked?: boolean;
+        shape?: "circle" | "square";
+        size?: number;
+    };
+    /** Options for type="select" */
+    selectOptions?: string[];
+    render?: (item: T) => React.ReactNode;
+    sortable?: boolean;
+    /** Called when a cell value changes (select, toggle, color, checkbox) */
+    onChange?: (item: T, value: any) => void;
+}
+interface TableProps<T> {
+    data: T[];
+    columns: Column<T>[];
+    searchable?: boolean;
+    searchPlaceholder?: string;
+    pagination?: boolean;
+    itemsPerPage?: number;
+    selectable?: boolean;
+    onBulkDelete?: (selectedIds: string[]) => void;
+    idKey?: keyof T;
+    /** When provided, appends an Actions column with View / Edit / Delete buttons */
+    defaultActions?: DefaultActionsConfig<T>;
+    /** Pass the serverPagination object from useServerTable to enable server-side pagination */
+    serverPagination?: ServerPaginationProp | null;
+    className?: string;
+}
+declare function Table<T extends Record<string, any>>({ data, columns, searchable, searchPlaceholder, pagination, itemsPerPage, selectable, onBulkDelete, idKey, defaultActions, serverPagination, className, }: TableProps<T>): react_jsx_runtime.JSX.Element;
+
+type BulletinPriority = "low" | "medium" | "high" | "urgent";
+type BulletinLayout = "grid" | "list" | "masonry";
+type BulletinVariant = "card" | "minimal" | "bordered";
+type BulletinColumns = 1 | 2 | 3 | 4;
+interface BulletinAction {
+    label: string;
+    icon?: React.ReactNode;
+    onClick: (item: BulletinItem) => void;
+    variant?: "default" | "danger";
+}
+interface BulletinItem {
+    id: string | number;
+    title: string;
+    body?: React.ReactNode;
+    author?: string;
+    /** Author avatar URL */
+    authorImage?: string;
+    /** Author avatar fallback icon */
+    authorIcon?: React.ReactNode;
+    date?: string | Date;
+    category?: string;
+    /** Cover image URL */
+    image?: string;
+    pinned?: boolean;
+    priority?: BulletinPriority;
+    tags?: string[];
+    /** Per-item action menu items */
+    actions?: BulletinAction[];
+    className?: string;
+}
+interface BulletinServerPaginationProp {
+    pagination: ServerPagination;
+    currentPage: number;
+    goToPage: (page: number) => void;
+}
+interface UseServerBulletinOptions {
+    url: string;
+    params?: Record<string, string | number>;
+    encrypt?: boolean;
+    key?: string;
+    decryptPayloadLog?: boolean;
+    /** Map raw API row → BulletinItem */
+    transform?: (row: any) => BulletinItem;
+}
+interface UseServerBulletinReturn {
+    items: BulletinItem[];
+    currentPage: number;
+    pagination: ServerPagination | null;
+    serverPagination: BulletinServerPaginationProp | null;
+    loading: boolean;
+    error: string | null;
+    goToPage: (page: number) => void;
+    reload: () => void;
+}
+declare function useServerBulletin({ url, params, encrypt, key, decryptPayloadLog, transform, }: UseServerBulletinOptions): UseServerBulletinReturn;
+interface BulletinPreviewProps {
+    item: BulletinItem;
+    onClose: () => void;
+    onEdit?: (item: BulletinItem) => void;
+    onDelete?: (item: BulletinItem) => void;
+    onView?: (item: BulletinItem) => void;
+    /** Custom actions to add to the preview header */
+    customActions?: BulletinAction[];
+}
+declare function BulletinPreview({ item, onClose, onEdit, onDelete, onView, customActions }: BulletinPreviewProps): React.ReactPortal;
+interface BulletinBoardProps {
+    /** Array of bulletin post items. */
+    items: BulletinItem[];
+    /** Board layout mode. */
+    layout?: "grid" | "list" | "masonry";
+    /** Number of grid columns (responsive). */
+    columns?: 1 | 2 | 3 | 4;
+    /** Visual style of each post card. */
+    variant?: "card" | "minimal" | "bordered";
+    /** Show a search input above the board. */
+    searchable?: boolean;
+    /** Show category filter chips above the board. */
+    filterable?: boolean;
+    /** Explicit category list for filter chips. Auto-derived from items if omitted. */
+    categories?: string[];
+    /** Board header title. */
+    title?: React.ReactNode;
+    /** Trailing element in the board header (e.g. a New Post button). */
+    headerAction?: React.ReactNode;
+    /** Show or hide the board header bar. */
+    showHeader?: boolean;
+    /** Content shown when the filtered list is empty. */
+    emptyMessage?: React.ReactNode;
+    /** Show skeleton cards instead of real content. */
+    loading?: boolean;
+    /** Number of skeleton cards to render while loading. */
+    loadingCount?: number;
+    /** Open a BulletinPreview modal when a card is clicked. */
+    preview?: boolean;
+    /** Called when the Edit button is clicked inside the preview. */
+    onEdit?: (item: BulletinItem) => void;
+    /** Called when the Delete button is clicked inside the preview. */
+    onDelete?: (item: BulletinItem) => void;
+    /** Called when the View button is clicked inside the preview. */
+    onView?: (item: BulletinItem) => void;
+    /** Base URL for built-in PUT {baseUrl}/{id} request. */
+    editBaseUrl?: string;
+    /** HTTP method for edit request (default: PUT). */
+    editMethod?: "PUT" | "PATCH" | "POST";
+    /** Item key used as the id segment in the edit URL. */
+    editIdKey?: string;
+    /** Base URL for built-in DELETE {baseUrl}/{id}/delete request. */
+    deleteBaseUrl?: string;
+    /** Item key used as the id segment in the delete URL. */
+    deleteIdKey?: string;
+    /** Pass the serverPagination from useServerBulletin to enable server-driven pagination. */
+    serverPagination?: BulletinServerPaginationProp | null;
+    /** Fired when a post card is clicked (ignored when preview=true). */
+    onItemClick?: (item: BulletinItem) => void;
+    /** Additional CSS classes on the outer wrapper. */
+    className?: string;
+}
+declare function BulletinBoard({ items, layout, columns, variant, searchable, filterable, categories: categoriesProp, title, headerAction, showHeader, emptyMessage, loading, loadingCount, onItemClick, onView, onEdit, onDelete, preview, deleteBaseUrl, deleteIdKey, serverPagination, className, }: BulletinBoardProps): react_jsx_runtime.JSX.Element;
+
+interface ButtonProps extends React.ButtonHTMLAttributes<HTMLButtonElement> {
+    variant?: "primary" | "secondary" | "outline" | "ghost" | "link" | "danger" | "success" | "destructive";
+    size?: "xs" | "sm" | "md" | "lg" | "xl";
+    fullWidth?: boolean;
+    width?: number | string;
+    height?: number | string;
+    rounded?: "none" | "sm" | "md" | "lg" | "xl" | "full";
+    bgColor?: string;
+    textColor?: string;
+    borderColor?: string;
+    borderWidth?: number;
+    shadow?: boolean;
+    shadowColor?: string;
+    opacity?: number;
+    gradientFrom?: string;
+    gradientTo?: string;
+    gradientDirection?: "to-r" | "to-l" | "to-t" | "to-b" | "to-tr" | "to-tl" | "to-br" | "to-bl";
+    fontSize?: number;
+    fontWeight?: "normal" | "medium" | "semibold" | "bold";
+    padding?: number | string;
+    margin?: number | string;
+    label?: string;
+    children?: React.ReactNode;
+    leftIcon?: React.ReactNode;
+    rightIcon?: React.ReactNode;
+    iconOnly?: boolean;
+    loading?: boolean;
+    loadingText?: string;
+    loadingPosition?: "left" | "right" | "center";
+    disabled?: boolean;
+    active?: boolean;
+    selected?: boolean;
+    animate?: boolean;
+    transitionDuration?: number;
+    transitionType?: "ease" | "linear" | "spring";
+    hoverScale?: number;
+    hoverOpacity?: number;
+    hoverBgColor?: string;
+    hoverTextColor?: string;
+    hoverBorderColor?: string;
+    activeScale?: number;
+    pressAnimation?: "shrink" | "bounce" | "none";
+    rippleEffect?: boolean;
+    rippleColor?: string;
+    rippleDuration?: number;
+    animationType?: "bounce" | "pulse" | "shake" | "wiggle";
+    loopAnimation?: boolean;
+    animationDelay?: number;
+    fadeIn?: boolean;
+    slideIn?: boolean;
+    slideDirection?: "left" | "right" | "top" | "bottom";
+    onClick?: (e?: any) => void;
+    onDoubleClick?: (e?: any) => void;
+    onMouseEnter?: (e?: any) => void;
+    onMouseLeave?: (e?: any) => void;
+    onMouseDown?: (e?: any) => void;
+    onMouseUp?: (e?: any) => void;
+    onPress?: () => void;
+    onLongPress?: () => void;
+    onPressIn?: () => void;
+    onPressOut?: () => void;
+    onFocus?: () => void;
+    onBlur?: () => void;
+    ariaLabel?: string;
+    role?: string;
+    tabIndex?: number;
+    type?: "button" | "submit" | "reset";
+    preventDefault?: boolean;
+    stopPropagation?: boolean;
+    debounceTime?: number;
+    throttleTime?: number;
+    confirmBeforeClick?: boolean;
+    confirmBeforeClickModalTitle?: string;
+    confirmBeforeClickModalContent?: React.ReactNode;
+    confirmBeforeClickFooterAction?: React.ReactNode;
+    href?: string;
+    target?: "_blank" | "_self";
+    as?: "button" | "a" | "div";
+    className?: string;
+    style?: React.CSSProperties;
+    testID?: string;
+}
+declare const Button: React.ForwardRefExoticComponent<ButtonProps & React.RefAttributes<HTMLElement>>;
+
+interface CalendarEvent {
+    id?: string;
+    date: Date;
+    endDate?: Date;
+    label: string;
+    color?: string;
+    allDay?: boolean;
+    description?: string;
+}
+type CalendarView = "month" | "week" | "day";
+interface CalendarProps {
+    events?: CalendarEvent[];
+    defaultView?: CalendarView;
+    defaultDate?: Date;
+    onEventClick?: (event: CalendarEvent) => void;
+    onDateClick?: (date: Date) => void;
+    onAddEvent?: (date: Date) => void;
+    className?: string;
+}
+declare const EVENT_COLORS: string[];
+declare function Calendar({ events, defaultView, defaultDate, onEventClick, onDateClick, onAddEvent, className, }: CalendarProps): react_jsx_runtime.JSX.Element;
+
+declare const Card: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLDivElement> & React.RefAttributes<HTMLDivElement>>;
+declare const CardHeader: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLDivElement> & React.RefAttributes<HTMLDivElement>>;
+declare const CardTitle: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLHeadingElement> & React.RefAttributes<HTMLParagraphElement>>;
+declare const CardDescription: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLParagraphElement> & React.RefAttributes<HTMLParagraphElement>>;
+declare const CardContent: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLDivElement> & React.RefAttributes<HTMLDivElement>>;
+declare const CardFooter: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLDivElement> & React.RefAttributes<HTMLDivElement>>;
+
+interface CheckboxProps extends Omit<React.InputHTMLAttributes<HTMLInputElement>, "type"> {
+    inline?: boolean;
+    label?: React.ReactNode;
+    accepted?: boolean;
+    acceptedColor?: string;
+    declined?: boolean;
+    declinedColor?: string;
+    height?: number | string;
+    width?: number | string;
+    required?: boolean;
+    error?: string;
+}
+declare const Checkbox: React.ForwardRefExoticComponent<CheckboxProps & React.RefAttributes<HTMLInputElement>>;
+
+interface ColorPickerProps {
+    value?: string;
+    defaultValue?: string;
+    onChange?: (color: string) => void;
+    showOpacity?: boolean;
+    showSwatches?: boolean;
+    disabled?: boolean;
+    className?: string;
+    required?: boolean;
+    error?: string;
+}
+declare function ColorPicker({ value: controlled, defaultValue, onChange, showOpacity, showSwatches, disabled, className, required, error, }: ColorPickerProps): react_jsx_runtime.JSX.Element;
+
+interface ComboboxOption {
+    value: string;
+    label: string;
+    description?: string;
+    icon?: React.ReactNode;
+    disabled?: boolean;
+    group?: string;
+}
+interface ComboboxProps {
+    options: ComboboxOption[];
+    value?: string | string[];
+    defaultValue?: string | string[];
+    onChange?: (value: string | string[]) => void;
+    placeholder?: string;
+    searchPlaceholder?: string;
+    multiple?: boolean;
+    creatable?: boolean;
+    clearable?: boolean;
+    disabled?: boolean;
+    maxHeight?: string;
+    className?: string;
+    required?: boolean;
+    error?: string;
+}
+declare function Combobox({ options, value: controlled, defaultValue, onChange, placeholder, searchPlaceholder, multiple, creatable, clearable, disabled, maxHeight, className, required, error, }: ComboboxProps): react_jsx_runtime.JSX.Element;
+
+interface CommandItem {
+    id: string;
     label: string;
-    type?: ActionFieldType;
-    /** HTML input type for type="input" (e.g. "email", "number", "password") */
-    inputType?: string;
-    /** Options for type="select", "radio", "combobox" — string[] or { label, value }[] */
-    options?: string[] | {
-        label: string;
-        value: string;
-    }[];
+    description?: string;
+    icon?: React.ReactNode;
+    shortcut?: string;
+    group?: string;
+    onSelect: () => void;
+    keywords?: string[];
+}
+interface CommandPaletteProps {
+    items: CommandItem[];
+    open?: boolean;
+    onOpenChange?: (open: boolean) => void;
     placeholder?: string;
-    required?: boolean;
-    /** Min value for type="slider" */
-    min?: number;
-    /** Max value for type="slider" */
-    max?: number;
-    /** Step for type="slider" */
-    step?: number;
-    /** Number of OTP digits for type="otp" */
-    digits?: number;
-    /** Custom render — overrides built-in field renderer */
-    render?: (value: any, onChange: (v: any) => void) => React.ReactNode;
+    maxRecent?: number;
+    className?: string;
 }
-/** Controls appearance of a default action button (view / edit / delete) */
-interface ActionButtonConfig {
-    /** Button variant. Defaults: view→"outline", edit→"outline", delete→"danger" */
-    variant?: "primary" | "secondary" | "outline" | "ghost" | "link" | "danger" | "success" | "destructive";
-    size?: "xs" | "sm" | "md" | "lg" | "xl";
-    rounded?: "none" | "sm" | "md" | "lg" | "xl" | "full";
-    gradientFrom?: string;
-    gradientTo?: string;
-    gradientDirection?: "to-r" | "to-l" | "to-t" | "to-b" | "to-tr" | "to-tl" | "to-br" | "to-bl";
-    bgColor?: string;
-    textColor?: string;
-    borderColor?: string;
-    borderWidth?: number;
-    shadow?: boolean;
-    /** Override the default icon */
+declare function CommandPalette({ items, open: controlled, onOpenChange, placeholder, maxRecent, className, }: CommandPaletteProps): react_jsx_runtime.JSX.Element;
+
+interface ContextMenuItem {
+    label?: React.ReactNode;
     icon?: React.ReactNode;
-    /** Override the default label text */
-    label?: string;
-    /** "icon" = icon only, "text" = label only, "icon-text" = icon + label. Default "icon" */
-    displayMode?: "icon" | "text" | "icon-text";
+    shortcut?: string;
+    onClick?: () => void;
+    disabled?: boolean;
+    danger?: boolean;
+    separator?: boolean;
+    children?: ContextMenuItem[];
+}
+interface ContextMenuProps {
+    items: ContextMenuItem[];
+    children: React.ReactNode;
     className?: string;
 }
-/** Extra action button appended alongside the default view/edit/delete buttons */
-interface ExtraActionConfig<T> {
-    /** Unique key */
-    key: string;
-    /** Button label */
-    label?: string;
-    /** Icon rendered in the button */
+declare function ContextMenu({ items, children, className }: ContextMenuProps): react_jsx_runtime.JSX.Element;
+
+type TrendDir = "up" | "down" | "neutral";
+type SemanticColor = "primary" | "info" | "success" | "warning" | "danger" | "muted";
+interface StatsWidgetProps {
+    title: string;
+    value: string | number;
+    subtitle?: string;
     icon?: React.ReactNode;
-    /** "icon" | "text" | "icon-text". Default "icon-text" */
-    displayMode?: "icon" | "text" | "icon-text";
-    variant?: "primary" | "secondary" | "outline" | "ghost" | "link" | "danger" | "success" | "destructive";
-    size?: "xs" | "sm" | "md" | "lg" | "xl";
-    rounded?: "none" | "sm" | "md" | "lg" | "xl" | "full";
-    gradientFrom?: string;
-    gradientTo?: string;
-    gradientDirection?: "to-r" | "to-l" | "to-t" | "to-b" | "to-tr" | "to-tl" | "to-br" | "to-bl";
-    bgColor?: string;
-    textColor?: string;
-    borderColor?: string;
-    borderWidth?: number;
-    shadow?: boolean;
+    iconColor?: SemanticColor;
+    trend?: TrendDir;
+    trendValue?: string;
+    trendLabel?: string;
+    delta?: string | number;
+    sparkline?: number[];
+    sparklineColor?: SemanticColor;
+    progress?: number;
+    progressColor?: SemanticColor;
+    badge?: React.ReactNode;
+    footer?: React.ReactNode;
+    animate?: boolean;
+    loading?: boolean;
+    onClick?: () => void;
     className?: string;
-    onClick: (item: T) => void;
 }
-interface DefaultActionsConfig<T> {
-    /**
-     * Base URL used to build PUT and DELETE requests.
-     * PUT  → `{baseUrl}/{id}/update`
-     * DELETE → `{baseUrl}/{id}/delete`
-     */
-    baseUrl: string;
-    /** Row key used as the URL id segment. Defaults to "id". */
-    idKey?: keyof T;
-    /** Position of the Actions column. Default "last". */
-    position?: "first" | "last";
-    /** Fields rendered in the Edit modal form. Auto-derived from row keys when omitted. */
-    editForm?: ActionField[];
-    /** Fields rendered in the View modal. Auto-derived from row keys when omitted. */
-    viewForm?: ActionField[];
-    /** Called after a successful edit or delete so the parent can refresh data. */
-    onSuccess?: (action: "edit" | "delete", item: T) => void;
-    /** Show a toast or notification banner on successful edit/delete */
-    onSuccessNotif?: ActionSuccessNotif;
-    /** Customize the View button appearance */
-    viewButton?: ActionButtonConfig;
-    /** Customize the Edit button appearance */
-    editButton?: ActionButtonConfig;
-    /** Customize the Delete button appearance */
-    deleteButton?: ActionButtonConfig;
-    /** Extra action buttons rendered alongside view/edit/delete */
-    extraActions?: ExtraActionConfig<T>[];
+declare function StatsWidget({ title, value, subtitle, icon, iconColor, trend, trendValue, trendLabel, delta, sparkline, sparklineColor, progress, progressColor, badge, footer, animate, loading, onClick, className, }: StatsWidgetProps): react_jsx_runtime.JSX.Element;
+interface ChartDataPoint {
+    label: string;
+    value: number;
+    color?: SemanticColor;
 }
-interface ActionSuccessNotif {
-    /** "toast" uses the ToastProvider. "notification" renders an inline banner. Default "toast". */
-    type?: "toast" | "notification";
-    /** Toast position. Only used when type="toast". Default "bottom-right". */
-    toastPosition?: ToastPosition;
-    /** Variant for edit success. Default "success". */
-    editVariant?: ToastVariant;
-    /** Variant for delete success. Default "success". */
-    deleteVariant?: ToastVariant;
-    /** Title for edit success notification */
-    editTitle?: React.ReactNode;
-    /** Body/description for edit success notification */
-    editBody?: React.ReactNode;
-    /** Title for delete success notification */
-    deleteTitle?: React.ReactNode;
-    /** Body/description for delete success notification */
-    deleteBody?: React.ReactNode;
-    /** Extra action element rendered inside the notification */
+interface ChartWidgetProps {
+    title: string;
+    description?: string;
+    data: ChartDataPoint[];
+    type?: "bar" | "line" | "donut";
+    color?: SemanticColor;
+    height?: number;
+    showLegend?: boolean;
+    showValues?: boolean;
+    showGrid?: boolean;
+    unit?: string;
     action?: React.ReactNode;
+    footer?: React.ReactNode;
+    loading?: boolean;
+    className?: string;
 }
-interface Column<T> {
-    key: keyof T | string;
+declare function ChartWidget({ title, description, data, type, color, height, showLegend, showValues, showGrid, unit, action, footer, loading, className, }: ChartWidgetProps): react_jsx_runtime.JSX.Element;
+interface TableWidgetProps {
     title: string;
-    type?: "text" | "image" | "badge" | "icon" | "stack" | "select" | "toggle" | "color" | "checkbox";
-    stackProps?: {
-        limit?: number;
-        stacked?: boolean;
-        shape?: "circle" | "square";
-        size?: number;
-    };
-    /** Options for type="select" */
-    selectOptions?: string[];
-    render?: (item: T) => React.ReactNode;
-    sortable?: boolean;
-    /** Called when a cell value changes (select, toggle, color, checkbox) */
-    onChange?: (item: T, value: any) => void;
+    description?: string;
+    action?: React.ReactNode;
+    footer?: React.ReactNode;
+    children: React.ReactNode;
+    className?: string;
 }
-interface TableProps<T> {
-    data: T[];
-    columns: Column<T>[];
-    searchable?: boolean;
-    searchPlaceholder?: string;
-    pagination?: boolean;
-    itemsPerPage?: number;
-    selectable?: boolean;
-    onBulkDelete?: (selectedIds: string[]) => void;
-    idKey?: keyof T;
-    /** When provided, appends an Actions column with View / Edit / Delete buttons */
-    defaultActions?: DefaultActionsConfig<T>;
-    /** Pass the serverPagination object from useServerTable to enable server-side pagination */
-    serverPagination?: ServerPaginationProp | null;
+declare function TableWidget({ title, description, action, footer, children, className }: TableWidgetProps): react_jsx_runtime.JSX.Element;
+interface ComposableWidgetProps {
+    title?: string;
+    description?: string;
+    headerLeft?: React.ReactNode;
+    headerRight?: React.ReactNode;
+    toolbar?: React.ReactNode;
+    children: React.ReactNode;
+    footer?: React.ReactNode;
+    padding?: "none" | "sm" | "md";
     className?: string;
 }
-declare function Table<T extends Record<string, any>>({ data, columns, searchable, searchPlaceholder, pagination, itemsPerPage, selectable, onBulkDelete, idKey, defaultActions, serverPagination, className, }: TableProps<T>): react_jsx_runtime.JSX.Element;
+declare function ComposableWidget({ title, description, headerLeft, headerRight, toolbar, children, footer, padding, className, }: ComposableWidgetProps): react_jsx_runtime.JSX.Element;
+interface MetricItem {
+    label: string;
+    value: string | number;
+    trend?: TrendDir;
+    trendValue?: string;
+    color?: SemanticColor;
+}
+interface MetricRowProps {
+    items: MetricItem[];
+    divided?: boolean;
+    className?: string;
+}
+declare function MetricRow({ items, divided, className }: MetricRowProps): react_jsx_runtime.JSX.Element;
 
 interface ServerDataGridProp {
     pagination: ServerPagination;
@@ -863,8 +994,10 @@ interface FileUploadProps extends React.HTMLAttributes<HTMLDivElement>, FileType
     /** Image editor configuration */
     imageEditorOptions?: ImageEditorOptions;
     className?: string;
+    required?: boolean;
+    error?: string;
 }
-declare function FileUpload({ className, onFileSelect, onFilesChange, onValidationError, accept, multiple, maxSize, maxFiles, disabled, reorderable, imagePreviewHeight, panelAspectRatio, label, helperText, hint, imageEditor, imageEditorOptions, allowedFileTypes, rejectedFileTypes, mimeTypes, ...props }: FileUploadProps): react_jsx_runtime.JSX.Element;
+declare function FileUpload({ className, onFileSelect, onFilesChange, onValidationError, accept, multiple, maxSize, maxFiles, disabled, reorderable, imagePreviewHeight, panelAspectRatio, label, helperText, hint, imageEditor, imageEditorOptions, allowedFileTypes, rejectedFileTypes, mimeTypes, required, error: externalError, ...props }: FileUploadProps): react_jsx_runtime.JSX.Element;
 
 type FlexDirection = "row" | "row-reverse" | "col" | "col-reverse";
 type FlexWrap = "nowrap" | "wrap" | "wrap-reverse";
@@ -925,6 +1058,8 @@ interface InputProps extends Omit<React.InputHTMLAttributes<HTMLInputElement>, "
     autocapitalize?: "none" | "sentences" | "words" | "characters" | boolean;
     prefix?: React.ReactNode;
     suffix?: React.ReactNode;
+    required?: boolean;
+    error?: string;
     regexValidation?: {
         pattern: RegExp;
         message?: string;
@@ -1272,8 +1407,10 @@ interface OtpInputProps {
     disabled?: boolean;
     invalid?: boolean;
     className?: string;
+    required?: boolean;
+    error?: string;
 }
-declare function OtpInput({ length, value: controlled, onChange, onComplete, mask, disabled, invalid, className, }: OtpInputProps): react_jsx_runtime.JSX.Element;
+declare function OtpInput({ length, value: controlled, onChange, onComplete, mask, disabled, invalid, className, required, error, }: OtpInputProps): react_jsx_runtime.JSX.Element;
 
 interface PaginationProps {
     page: number;
@@ -1410,8 +1547,10 @@ interface RadioGroupProps {
     orientation?: "horizontal" | "vertical";
     name?: string;
     className?: string;
+    required?: boolean;
+    error?: string;
 }
-declare function RadioGroup({ options, value: controlledValue, defaultValue, onChange, variant, size, orientation, name, className, }: RadioGroupProps): react_jsx_runtime.JSX.Element;
+declare function RadioGroup({ options, value: controlledValue, defaultValue, onChange, variant, size, orientation, name, className, required, error, }: RadioGroupProps): react_jsx_runtime.JSX.Element;
 
 interface RepeaterProps<T> {
     items: T[];
@@ -1486,8 +1625,10 @@ interface SelectProps extends Omit<React.HTMLAttributes<HTMLDivElement>, 'onChan
     createOptionForm?: React.ReactNode;
     suffixIcon?: React.ReactNode;
     suffixIconColor?: "success" | "error" | "warning" | "info" | (string & {});
+    required?: boolean;
+    error?: string;
 }
-declare function Select({ options, value, onChange, placeholder, searchable, native, label, loadingMessage, noSearchResultsMessage, searchingMessage, multiple, reorderable, disabled, createOptionForm, suffixIcon, suffixIconColor, className, ...props }: SelectProps): react_jsx_runtime.JSX.Element;
+declare function Select({ options, value, onChange, placeholder, searchable, native, label, loadingMessage, noSearchResultsMessage, searchingMessage, multiple, reorderable, disabled, createOptionForm, suffixIcon, suffixIconColor, required, error, className, ...props }: SelectProps): react_jsx_runtime.JSX.Element;
 
 type Theme = 'dark' | 'light' | 'system';
 type ThemeColors = {
@@ -1570,6 +1711,8 @@ interface SliderProps {
     label?: React.ReactNode;
     showValue?: boolean;
     className?: string;
+    required?: boolean;
+    error?: string;
 }
 interface RangeSliderProps {
     value?: [number, number];
@@ -1583,9 +1726,11 @@ interface RangeSliderProps {
     label?: React.ReactNode;
     showValue?: boolean;
     className?: string;
+    required?: boolean;
+    error?: string;
 }
-declare function Slider({ value: controlled, defaultValue, min, max, step, onChange, disabled, showTooltip, showMarks, marks, label, showValue, className, }: SliderProps): react_jsx_runtime.JSX.Element;
-declare function RangeSlider({ value: controlled, defaultValue, min, max, step, onChange, disabled, showTooltip, label, showValue, className, }: RangeSliderProps): react_jsx_runtime.JSX.Element;
+declare function Slider({ value: controlled, defaultValue, min, max, step, onChange, disabled, showTooltip, showMarks, marks, label, showValue, className, required, error, }: SliderProps): react_jsx_runtime.JSX.Element;
+declare function RangeSlider({ value: controlled, defaultValue, min, max, step, onChange, disabled, showTooltip, label, showValue, className, required, error, }: RangeSliderProps): react_jsx_runtime.JSX.Element;
 
 type StatTrend = "up" | "down" | "neutral";
 interface StatCardProps {
@@ -1652,8 +1797,10 @@ interface TagInputProps {
     allowDuplicates?: boolean;
     disabled?: boolean;
     className?: string;
+    required?: boolean;
+    error?: string;
 }
-declare function TagInput({ value: controlled, defaultValue, onChange, placeholder, maxTags, allowDuplicates, disabled, className, }: TagInputProps): react_jsx_runtime.JSX.Element;
+declare function TagInput({ value: controlled, defaultValue, onChange, placeholder, maxTags, allowDuplicates, disabled, className, required, error, }: TagInputProps): react_jsx_runtime.JSX.Element;
 
 interface TextareaProps extends Omit<React.TextareaHTMLAttributes<HTMLTextAreaElement>, "rows" | "cols" | "readOnly" | "minLength" | "maxLength"> {
     rows?: number;
@@ -1665,6 +1812,9 @@ interface TextareaProps extends Omit<React.TextareaHTMLAttributes<HTMLTextAreaEl
     minLength?: number;
     maxLength?: number;
     length?: number;
+    label?: string;
+    required?: boolean;
+    error?: string;
 }
 declare const Textarea: React.ForwardRefExoticComponent<TextareaProps & React.RefAttributes<HTMLTextAreaElement>>;
 
@@ -1721,6 +1871,8 @@ interface ToggleSwitchProps extends Omit<React.InputHTMLAttributes<HTMLInputElem
     declinedColor?: string;
     width?: number | string;
     height?: number | string;
+    required?: boolean;
+    error?: string;
 }
 declare const ToggleSwitch: React.ForwardRefExoticComponent<ToggleSwitchProps & React.RefAttributes<HTMLInputElement>>;
 
@@ -1866,4 +2018,4 @@ interface WizardProps {
 }
 declare function Wizard({ steps, step: controlledStep, defaultStep, onStepChange, onFinish, onClose, layout, variant, size, isOpen, showClose, unchange, title, description, hideHeader, footer, renderActions, backLabel, nextLabel, finishLabel, cancelLabel, showCancel, showBackOnFirst, loading, clickableSteps, className, contentClassName, }: WizardProps): react_jsx_runtime.JSX.Element;
 
-export { Accordion, type AccordionItem, type AccordionProps, type AccordionVariant, type ActionField, type ActionFieldType, type AuthField, type AuthVariant, type AuthView, Authentication, type AuthenticationProps, AvatarStack, type AvatarStackProps, Badge, type BadgeProps, type BadgeSize, type BadgeVariant, Breadcrumb, type BreadcrumbItem, type BreadcrumbProps, Button, type ButtonProps, COLOR_PALETTE, Calendar, CalendarDateRangePicker, type CalendarDateRangePickerProps, type CalendarDateRangeVariant, type CalendarEvent, type CalendarProps, type CalendarView, Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, type ChartDataPoint, ChartWidget, type ChartWidgetProps, Checkbox, type CheckboxProps, CircularProgress, type CircularProgressProps, type ClusterVariant, ColorPicker, type ColorPickerProps, type Column, Combobox, type ComboboxOption, type ComboboxProps, type CommandItem, CommandPalette, type CommandPaletteProps, ComposableWidget, type ComposableWidgetProps, type ConfirmVariant, ContextMenu, type ContextMenuItem, type ContextMenuProps, DataGrid, type DataGridColumn, type DataGridProps, DatePickerPopup, type DateRange, DateRangePicker, type DateRangePickerProps, type DefaultActionsConfig, DocsLayout, Drawer, type DrawerProps, type DrawerSide, Dropdown, DropdownItem, DropdownLabel, type DropdownProps, DropdownSeparator, EVENT_COLORS, type FileTypeValidation, FileUpload, type FileUploadProps, type FlexAlign, type FlexDirection, type FlexGap, FlexItem, type FlexItemProps, type FlexJustify, FlexLayout, type FlexLayoutProps, type FlexWrap, type FlyToOptions, type FormField, type FormFieldType, type GridAlign, type GridCols, type GridGap, GridItem, type GridItemProps, GridLayout, type GridLayoutProps, GroupNavigation, type GroupNavigationProps, type ImageEditorMode, type ImageEditorOptions, Input, type InputProps, KanbanBoard, type KanbanBoardProps, type KanbanCard, type KanbanColumn, Label, LeafletMap, type LeafletMapProps, LeftSidebar, type LeftSidebarProps, type MapLibreClusterVariant, MapLibreMap, type MapLibreMarker, type MapLibreProps, type MapLibreRoute, type MapLibreRouteType, type MapLibreStyle, type MapMarker, type MapRoute, type MarkerColor, type MetricItem, MetricRow, type MetricRowProps, Modal, ModalConfirmation, type ModalConfirmationProps, type ModalProps, ModalUnchange, type ModalUnchangeProps, ModalWithForms, type ModalWithFormsProps, type NavGroup, type NavItem, Navigation, type NavigationProps, NotificationBanner, type NotificationBannerProps, type NotificationItem, NotificationPanel, type NotificationPanelProps, type NotificationVariant, OtpInput, type OtpInputProps, Pagination, type PaginationProps, Panel, type PanelProps, PanelSettings, type PanelSettingsProps, type PanelSettingsTab, PanelSidebarGroup, PanelSidebarItem, Popover, type PopoverPlacement, type PopoverProps, Progress, type ProgressProps, type ProgressSize, type ProgressVariant, type PropRow, PropsTable, RadioGroup, type RadioGroupProps, type RadioOption, type RadioSize, type RadioVariant, RangeSlider, type RangeSliderProps, Repeater, type RepeaterProps, ResizablePanels, type ResizablePanelsProps, RichTextEditor, type RichTextEditorProps, RightSidebar, type RightSidebarProps, type RouteType, ScrollArea, type ScrollAreaProps, Section, SectionBlock, type SectionProps, type SectionVariant, Select, type SelectOption, type SelectProps, type SemanticColor, type ServerDataGridProp, type ServerPagination, type ServerPaginationLink, type ServerPaginationProp, type ServerTableResponse, Skeleton, Slider, type SliderProps, type SortDir, StatCard, type StatCardProps, type StatTrend, StatsWidget, type StatsWidgetProps, type Step, type StepStatus, Stepper, type StepperProps, type TabItem, type TabSize, type TabVariant, Table, TableOfContents, type TableProps, TableWidget, type TableWidgetProps, Tabs, type TabsProps, TagInput, type TagInputProps, Textarea, type TextareaProps, type ThemeColors, ThemeProvider, type ThemeSettings, Timeline, type TimelineItem, type TimelineProps, type TimelineVariant, type ToastItem, type ToastPosition, ToastProvider, type ToastProviderProps, type ToastVariant, type TocItem, TocProvider, ToggleSwitch, type ToggleSwitchProps, Tooltip, type TooltipProps, Topbar, type TopbarProps, type TreeNode, TreeView, type TreeViewProps, type TrendDir, type UseServerDataGridOptions, type UseServerDataGridReturn, type UseServerTableOptions, type UseServerTableReturn, Widget, type WidgetProps, Wizard, type WizardActionProps, type WizardLayout, type WizardProps, type WizardSize, type WizardStep, type WizardVariant, useServerDataGrid, useServerTable, useTheme, useToast, useToc };
+export { Accordion, type AccordionItem, type AccordionProps, type AccordionVariant, type ActionField, type ActionFieldType, type AuthField, type AuthVariant, type AuthView, Authentication, type AuthenticationProps, AvatarStack, type AvatarStackProps, Badge, type BadgeProps, type BadgeSize, type BadgeVariant, Breadcrumb, type BreadcrumbItem, type BreadcrumbProps, type BulletinAction, BulletinBoard, type BulletinBoardProps, type BulletinColumns, type BulletinItem, type BulletinLayout, BulletinPreview, type BulletinPreviewProps, type BulletinPriority, type BulletinServerPaginationProp, type BulletinVariant, Button, type ButtonProps, COLOR_PALETTE, Calendar, CalendarDateRangePicker, type CalendarDateRangePickerProps, type CalendarDateRangeVariant, type CalendarEvent, type CalendarProps, type CalendarView, Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, type ChartDataPoint, ChartWidget, type ChartWidgetProps, Checkbox, type CheckboxProps, CircularProgress, type CircularProgressProps, type ClusterVariant, ColorPicker, type ColorPickerProps, type Column, Combobox, type ComboboxOption, type ComboboxProps, type CommandItem, CommandPalette, type CommandPaletteProps, ComposableWidget, type ComposableWidgetProps, type ConfirmVariant, ContextMenu, type ContextMenuItem, type ContextMenuProps, DataGrid, type DataGridColumn, type DataGridProps, DatePickerPopup, type DateRange, DateRangePicker, type DateRangePickerProps, type DefaultActionsConfig, DocsLayout, Drawer, type DrawerProps, type DrawerSide, Dropdown, DropdownItem, DropdownLabel, type DropdownProps, DropdownSeparator, EVENT_COLORS, type FileTypeValidation, FileUpload, type FileUploadProps, type FlexAlign, type FlexDirection, type FlexGap, FlexItem, type FlexItemProps, type FlexJustify, FlexLayout, type FlexLayoutProps, type FlexWrap, type FlyToOptions, type FormField, type FormFieldType, type GridAlign, type GridCols, type GridGap, GridItem, type GridItemProps, GridLayout, type GridLayoutProps, GroupNavigation, type GroupNavigationProps, type ImageEditorMode, type ImageEditorOptions, Input, type InputProps, KanbanBoard, type KanbanBoardProps, type KanbanCard, type KanbanColumn, Label, LeafletMap, type LeafletMapProps, LeftSidebar, type LeftSidebarProps, type MapLibreClusterVariant, MapLibreMap, type MapLibreMarker, type MapLibreProps, type MapLibreRoute, type MapLibreRouteType, type MapLibreStyle, type MapMarker, type MapRoute, type MarkerColor, type MetricItem, MetricRow, type MetricRowProps, Modal, ModalConfirmation, type ModalConfirmationProps, type ModalProps, ModalUnchange, type ModalUnchangeProps, ModalWithForms, type ModalWithFormsProps, type NavGroup, type NavItem, Navigation, type NavigationProps, NotificationBanner, type NotificationBannerProps, type NotificationItem, NotificationPanel, type NotificationPanelProps, type NotificationVariant, OtpInput, type OtpInputProps, Pagination, type PaginationProps, Panel, type PanelProps, PanelSettings, type PanelSettingsProps, type PanelSettingsTab, PanelSidebarGroup, PanelSidebarItem, Popover, type PopoverPlacement, type PopoverProps, Progress, type ProgressProps, type ProgressSize, type ProgressVariant, type PropRow, PropsTable, RadioGroup, type RadioGroupProps, type RadioOption, type RadioSize, type RadioVariant, RangeSlider, type RangeSliderProps, Repeater, type RepeaterProps, ResizablePanels, type ResizablePanelsProps, RichTextEditor, type RichTextEditorProps, RightSidebar, type RightSidebarProps, type RouteType, ScrollArea, type ScrollAreaProps, Section, SectionBlock, type SectionProps, type SectionVariant, Select, type SelectOption, type SelectProps, type SemanticColor, type ServerDataGridProp, type ServerPagination, type ServerPaginationLink, type ServerPaginationProp, type ServerTableResponse, Skeleton, Slider, type SliderProps, type SortDir, StatCard, type StatCardProps, type StatTrend, StatsWidget, type StatsWidgetProps, type Step, type StepStatus, Stepper, type StepperProps, type TabItem, type TabSize, type TabVariant, Table, TableOfContents, type TableProps, TableWidget, type TableWidgetProps, Tabs, type TabsProps, TagInput, type TagInputProps, Textarea, type TextareaProps, type ThemeColors, ThemeProvider, type ThemeSettings, Timeline, type TimelineItem, type TimelineProps, type TimelineVariant, type ToastItem, type ToastPosition, ToastProvider, type ToastProviderProps, type ToastVariant, type TocItem, TocProvider, ToggleSwitch, type ToggleSwitchProps, Tooltip, type TooltipProps, Topbar, type TopbarProps, type TreeNode, TreeView, type TreeViewProps, type TrendDir, type UseServerBulletinOptions, type UseServerBulletinReturn, type UseServerDataGridOptions, type UseServerDataGridReturn, type UseServerTableOptions, type UseServerTableReturn, Widget, type WidgetProps, Wizard, type WizardActionProps, type WizardLayout, type WizardProps, type WizardSize, type WizardStep, type WizardVariant, useServerBulletin, useServerDataGrid, useServerTable, useTheme, useToast, useToc };