@adminlte/react 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,1010 @@
+import * as React$1 from 'react';
+import React__default, { AnchorHTMLAttributes, ReactNode, Key } from 'react';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { ApexOptions } from 'apexcharts';
+
+/**
+ * Bootstrap color theme variants.
+ */
+type BootstrapTheme = 'primary' | 'secondary' | 'success' | 'info' | 'warning' | 'danger' | 'light' | 'dark';
+/**
+ * Component size variants.
+ */
+type ComponentSize = 'sm' | 'lg';
+/**
+ * Color mode for light/dark theme support.
+ */
+type ColorMode = 'light' | 'dark' | 'auto';
+/**
+ * Bootstrap responsive breakpoint sizes.
+ */
+type BreakpointSize = 'sm' | 'md' | 'lg' | 'xl' | 'xxl';
+
+/**
+ * Menu header item (non-interactive section label).
+ */
+interface MenuHeader {
+    type: 'header';
+    text: string;
+}
+/**
+ * Menu link item (clickable, can have children).
+ */
+interface MenuItem {
+    type: 'item';
+    text: string;
+    href: string;
+    icon?: string;
+    iconColor?: BootstrapTheme;
+    badge?: string | number;
+    badgeColor?: BootstrapTheme;
+    target?: '_blank' | '_self';
+}
+/**
+ * Menu group item (collapsible submenu).
+ */
+interface MenuGroup {
+    type: 'group';
+    text: string;
+    icon?: string;
+    iconColor?: BootstrapTheme;
+    badge?: string | number;
+    badgeColor?: BootstrapTheme;
+    children: MenuNode[];
+}
+/**
+ * Discriminated union of all menu node types.
+ */
+type MenuNode = MenuHeader | MenuItem | MenuGroup;
+
+type LinkProps = AnchorHTMLAttributes<HTMLAnchorElement> & {
+    href: string;
+    children?: ReactNode;
+};
+/**
+ * A drop-in replacement for `<a>`. Library consumers can inject their framework's
+ * router link (e.g. Next.js `next/link`, React Router `Link`) so in-app navigation
+ * is client-side. Must accept `href` plus the usual anchor props and render an `<a>`.
+ */
+type LinkComponent = (props: LinkProps) => ReactNode;
+declare function LinkProvider({ component, children, }: {
+    component?: LinkComponent;
+    children: ReactNode;
+}): react_jsx_runtime.JSX.Element;
+/** The active Link component — consumer-injected router link, or a plain `<a>` fallback. */
+declare function useLinkComponent(): LinkComponent;
+
+/**
+ * The signed-in user shown in the topbar user menu.
+ */
+interface TopbarUser {
+    name: string;
+    image: string;
+    role?: string;
+    memberSince?: string;
+}
+/**
+ * Props for the DashboardLayout component.
+ */
+interface DashboardLayoutProps {
+    menuItems: MenuNode[];
+    logo?: React__default.ReactNode;
+    logoHref?: string;
+    user?: TopbarUser;
+    sidebarTheme?: 'light' | 'dark';
+    sidebarClass?: string;
+    sidebarBreakpoint?: BreakpointSize;
+    sidebarMini?: boolean;
+    fixedHeader?: boolean;
+    fixedSidebar?: boolean;
+    fixedFooter?: boolean;
+    colorModeToggle?: boolean;
+    initialColorMode?: ColorMode;
+    dir?: 'ltr' | 'rtl';
+    enableSidebarPersistence?: boolean;
+    navbarClass?: string;
+    bodyClass?: string;
+    topbarStart?: React__default.ReactNode;
+    topbarEnd?: React__default.ReactNode;
+    footer?: React__default.ReactNode;
+    /**
+     * Router link to use for sidebar navigation (e.g. an adapter around `next/link`).
+     * Enables client-side navigation; defaults to a plain `<a>` (full-page navigation).
+     */
+    linkComponent?: LinkComponent;
+    /** Optional sidebar footer link, e.g. to your documentation. Hidden when unset. */
+    docsHref?: string;
+    /** Label for the sidebar footer link (default "View documentation"). */
+    docsLabel?: string;
+    children: React__default.ReactNode;
+}
+/**
+ * Props for the AuthLayout component (login/register).
+ */
+interface AuthLayoutProps {
+    authType?: 'login' | 'register';
+    logo?: React__default.ReactNode;
+    logoHref?: string;
+    children: React__default.ReactNode;
+}
+/**
+ * Props for the AppContent wrapper component.
+ */
+interface AppContentProps {
+    header?: React__default.ReactNode;
+    breadcrumbs?: Array<{
+        label: string;
+        href?: string;
+    }>;
+    title?: string;
+    fluid?: boolean;
+    children: React__default.ReactNode;
+}
+
+interface DirectChatContact {
+    name: string;
+    image: string;
+    date: string;
+    preview: string;
+}
+interface DirectChatMessage {
+    from: string;
+    image: string;
+    timestamp: string;
+    text: string;
+    isOwn?: boolean;
+}
+
+interface SidebarContextValue {
+    isCollapsed: boolean;
+    isMobileOpen: boolean;
+    isMiniMode: boolean;
+    toggle: () => void;
+    collapse: () => void;
+    expand: () => void;
+    sidebarBreakpoint: number;
+}
+interface SidebarProviderProps {
+    sidebarMini?: boolean;
+    enablePersistence?: boolean;
+    sidebarBreakpoint?: number;
+    children: React__default.ReactNode;
+}
+declare function SidebarProvider({ sidebarMini, enablePersistence, sidebarBreakpoint, children, }: SidebarProviderProps): react_jsx_runtime.JSX.Element;
+declare function useSidebarContext(): SidebarContextValue;
+
+interface ColorModeContextValue {
+    colorMode: ColorMode;
+    setColorMode: (mode: ColorMode) => void;
+    resolvedMode: 'light' | 'dark';
+}
+interface ColorModeProviderProps {
+    initialMode?: ColorMode;
+    children: React__default.ReactNode;
+}
+declare function ColorModeProvider({ initialMode, children, }: ColorModeProviderProps): react_jsx_runtime.JSX.Element;
+declare function useColorModeContext(): ColorModeContextValue;
+
+interface CommandPaletteContextValue {
+    isOpen: boolean;
+    open: () => void;
+    close: () => void;
+    toggle: () => void;
+}
+declare function CommandPaletteProvider({ children }: {
+    children: React__default.ReactNode;
+}): react_jsx_runtime.JSX.Element;
+/**
+ * Returns the command-palette controls, or `undefined` if rendered outside a
+ * CommandPaletteProvider (so the topbar search button degrades gracefully).
+ */
+declare function useCommandPalette(): CommandPaletteContextValue | undefined;
+
+/**
+ * Main dashboard layout component (RSC outer shell).
+ * Computes static body classes server-side, nests client providers inside.
+ */
+declare function DashboardLayout({ menuItems, logo, logoHref, user, sidebarTheme, sidebarClass, sidebarBreakpoint, sidebarMini, fixedHeader, fixedSidebar, fixedFooter, colorModeToggle, initialColorMode, dir, enableSidebarPersistence, navbarClass, bodyClass, topbarStart, topbarEnd, footer, linkComponent, docsHref, docsLabel, children, }: DashboardLayoutProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * Standalone auth page layout (login/register/lockscreen).
+ * Applies the `<authType>-page` classes to <body> via effect so it works
+ * under a Next.js App Router root layout that already owns <html>/<body>.
+ */
+declare function AuthLayout({ authType, logo, logoHref, children, }: AuthLayoutProps): react_jsx_runtime.JSX.Element;
+
+declare function AppContent({ breadcrumbs, title, fluid, children, }: AppContentProps): react_jsx_runtime.JSX.Element;
+
+interface TopbarProps {
+    start?: React.ReactNode;
+    end?: React.ReactNode;
+    colorModeToggle?: boolean;
+    search?: boolean;
+    fullscreen?: boolean;
+    user?: TopbarUser;
+    navbarClass?: string;
+}
+declare function Topbar({ start, end, colorModeToggle, search, fullscreen, user, navbarClass, }: TopbarProps): react_jsx_runtime.JSX.Element;
+
+interface SidebarProps {
+    items: MenuNode[];
+    logo?: React.ReactNode;
+    logoHref?: string;
+    theme?: 'light' | 'dark';
+    sidebarClass?: string;
+    docsHref?: string;
+    docsLabel?: string;
+}
+declare function Sidebar({ items, logo, logoHref, theme, sidebarClass, docsHref, docsLabel, }: SidebarProps): react_jsx_runtime.JSX.Element;
+
+interface SidebarBrandProps {
+    logo?: React.ReactNode;
+    href?: string;
+}
+declare function SidebarBrand({ logo, href }: SidebarBrandProps): react_jsx_runtime.JSX.Element;
+
+interface SidebarNavProps {
+    items: MenuNode[];
+    /** Optional footer link (e.g. to your docs). Omitted when not provided. */
+    docsHref?: string;
+    docsLabel?: string;
+}
+declare function SidebarNav({ items, docsHref, docsLabel }: SidebarNavProps): react_jsx_runtime.JSX.Element;
+
+interface SidebarNavItemProps {
+    item: MenuNode;
+    currentPath: string;
+    depth?: number;
+}
+declare function SidebarNavItem({ item, currentPath, depth }: SidebarNavItemProps): react_jsx_runtime.JSX.Element;
+
+declare function SidebarOverlay(): react_jsx_runtime.JSX.Element;
+
+interface FooterProps {
+    children?: React.ReactNode;
+}
+declare function Footer({ children }: FooterProps): react_jsx_runtime.JSX.Element;
+
+declare function ColorModeToggle(): react_jsx_runtime.JSX.Element;
+
+interface SmallBoxProps {
+    title: React.ReactNode;
+    text?: string;
+    icon?: React.ReactNode;
+    theme?: BootstrapTheme;
+    url?: string;
+    urlText?: string;
+}
+declare function SmallBox({ title, text, icon, theme, url, urlText, }: SmallBoxProps): react_jsx_runtime.JSX.Element;
+
+interface InfoBoxProps {
+    title?: string;
+    text?: string;
+    icon?: string;
+    theme?: BootstrapTheme;
+    progress?: number;
+    progressText?: string;
+}
+declare function InfoBox({ title, text, icon, theme, progress, progressText, }: InfoBoxProps): react_jsx_runtime.JSX.Element;
+
+interface CardProps {
+    title?: string;
+    icon?: string;
+    theme?: BootstrapTheme;
+    /**
+     * Color treatment when `theme` is set:
+     * - 'default' → colored header (`card card-{theme}`)
+     * - 'outline' → colored top border (`card card-outline card-{theme}`)
+     * - 'solid'   → fully colored card (`card text-bg-{theme}`)
+     */
+    variant?: 'default' | 'outline' | 'solid';
+    /** @deprecated use `variant="outline"` */
+    outline?: boolean;
+    collapsible?: boolean;
+    defaultCollapsed?: boolean;
+    removable?: boolean;
+    /** Called after the card removes itself via the remove tool button */
+    onRemove?: () => void;
+    maximizable?: boolean;
+    bodyClass?: string;
+    headerClass?: string;
+    footerClass?: string;
+    tools?: React.ReactNode;
+    footer?: React.ReactNode;
+    children: React.ReactNode;
+    className?: string;
+}
+declare function Card({ title, icon, theme, variant, outline, collapsible, defaultCollapsed, removable, onRemove, maximizable, bodyClass, headerClass, footerClass, tools, footer, children, className, }: CardProps): react_jsx_runtime.JSX.Element | null;
+
+interface AlertProps {
+    theme?: BootstrapTheme;
+    title?: string;
+    icon?: string;
+    dismissable?: boolean;
+    children: React.ReactNode;
+}
+declare function Alert({ theme, title, icon, dismissable, children, }: AlertProps): react_jsx_runtime.JSX.Element;
+
+interface CalloutProps {
+    theme?: BootstrapTheme;
+    title?: string;
+    icon?: string;
+    children: React.ReactNode;
+}
+declare function Callout({ theme, title, icon, children }: CalloutProps): react_jsx_runtime.JSX.Element;
+
+interface ProgressProps {
+    value?: number;
+    theme?: BootstrapTheme;
+    striped?: boolean;
+    animated?: boolean;
+    height?: string;
+    showLabel?: boolean;
+}
+declare function Progress({ value, theme, striped, animated, height, showLabel, }: ProgressProps): react_jsx_runtime.JSX.Element;
+
+interface ProgressGroupProps {
+    label: string;
+    value: number;
+    color?: BootstrapTheme;
+    max?: number;
+    showPercentage?: boolean;
+}
+declare function ProgressGroup({ label, value, color, max, showPercentage, }: ProgressGroupProps): react_jsx_runtime.JSX.Element;
+
+interface RatingsProps {
+    value: number;
+    max?: number;
+    color?: BootstrapTheme;
+    readonly?: boolean;
+    className?: string;
+}
+declare function Ratings({ value, max, color, readonly, className, }: RatingsProps): react_jsx_runtime.JSX.Element;
+
+interface SocialLink {
+    icon: string;
+    url: string;
+    label?: string;
+}
+interface ProfileCardProps {
+    name: string;
+    title?: string;
+    image?: string;
+    imageAlt?: string;
+    socials?: SocialLink[];
+    description?: string;
+    className?: string;
+    children?: React.ReactNode;
+}
+declare function ProfileCard({ name, title, image, imageAlt, socials, description, className, children, }: ProfileCardProps): react_jsx_runtime.JSX.Element;
+
+interface DescriptionBlockProps {
+    title: string;
+    text?: string;
+    items?: Record<string, string>;
+    className?: string;
+}
+declare function DescriptionBlock({ title, text, items, className, }: DescriptionBlockProps): react_jsx_runtime.JSX.Element;
+
+interface TimelineItem {
+    time: string;
+    icon?: string;
+    iconTheme?: BootstrapTheme;
+    title: string;
+    body?: React.ReactNode;
+    footer?: React.ReactNode;
+    url?: string;
+}
+interface TimelineProps {
+    items: TimelineItem[];
+    className?: string;
+}
+declare function Timeline({ items, className }: TimelineProps): react_jsx_runtime.JSX.Element;
+
+interface NavMessage {
+    from: string;
+    text: string;
+    image?: string;
+    url?: string;
+    time?: string;
+    star?: BootstrapTheme;
+}
+interface NavMessagesProps {
+    messages: NavMessage[];
+    badgeColor?: BootstrapTheme;
+    count?: number | string;
+    seeAllUrl?: string;
+    seeAllText?: string;
+}
+declare function NavMessages({ messages, badgeColor, count, seeAllUrl, seeAllText, }: NavMessagesProps): react_jsx_runtime.JSX.Element;
+
+interface NavNotification {
+    text: string;
+    icon?: string;
+    time?: string;
+    url?: string;
+}
+interface NavNotificationsProps {
+    notifications: NavNotification[];
+    badgeColor?: BootstrapTheme;
+    count?: number | string;
+    seeAllUrl?: string;
+    seeAllText?: string;
+}
+declare function NavNotifications({ notifications, badgeColor, count, seeAllUrl, seeAllText, }: NavNotificationsProps): react_jsx_runtime.JSX.Element;
+
+interface NavTask {
+    text: string;
+    progress: number;
+    color?: BootstrapTheme;
+    url?: string;
+}
+interface NavTasksProps {
+    tasks: NavTask[];
+    badgeColor?: BootstrapTheme;
+    seeAllUrl?: string;
+    seeAllText?: string;
+}
+declare function NavTasks({ tasks, badgeColor, seeAllUrl, seeAllText, }: NavTasksProps): react_jsx_runtime.JSX.Element;
+
+interface DirectChatProps {
+    badge?: number;
+    contacts?: DirectChatContact[];
+    messages?: DirectChatMessage[];
+    collapsible?: boolean;
+    removable?: boolean;
+    onRemove?: () => void;
+    className?: string;
+}
+declare function DirectChat({ badge, contacts, messages, collapsible, removable, onRemove, className, }: DirectChatProps): react_jsx_runtime.JSX.Element | null;
+
+interface ApexChartProps {
+    id: string;
+    series: NonNullable<ApexOptions['series']>;
+    config: ApexOptions;
+}
+declare function ApexChart({ id, series, config }: ApexChartProps): react_jsx_runtime.JSX.Element;
+
+interface SparklineChartProps {
+    id: string;
+    data: number[];
+}
+declare function SparklineChart({ id, data }: SparklineChartProps): react_jsx_runtime.JSX.Element;
+
+interface WorldMapProps {
+    id: string;
+    height?: number;
+}
+declare function WorldMap({ id, height }: WorldMapProps): react_jsx_runtime.JSX.Element;
+
+interface CommandItem {
+    label: string;
+    href: string;
+    icon?: string;
+    section?: string;
+}
+/**
+ * Flattens a MenuNode tree into a flat list of navigable commands.
+ * Skips placeholder links (`href === '#'`) and de-duplicates by href.
+ *
+ * Lives outside the 'use client' command-palette module so Server Components
+ * (e.g. DashboardLayout) can call it during server render.
+ */
+declare function flattenMenuToCommands(nodes: MenuNode[]): CommandItem[];
+
+interface CommandPaletteProps {
+    items: CommandItem[];
+    placeholder?: string;
+}
+declare function CommandPalette({ items, placeholder }: CommandPaletteProps): react_jsx_runtime.JSX.Element | null;
+
+interface AccordionItem {
+    title: React.ReactNode;
+    children: React.ReactNode;
+}
+interface AccordionProps {
+    items: AccordionItem[];
+    /** Index open on first render; -1 for all closed. */
+    defaultOpen?: number;
+    /** Allow multiple panels open at once. */
+    alwaysOpen?: boolean;
+    /** Edge-to-edge style (`.accordion-flush`). */
+    flush?: boolean;
+    id?: string;
+    className?: string;
+}
+/**
+ * Bootstrap accordion driven by React state (no Bootstrap JS / data-bs-toggle).
+ */
+declare function Accordion({ items, defaultOpen, alwaysOpen, flush, id, className, }: AccordionProps): react_jsx_runtime.JSX.Element;
+
+interface TabItem {
+    label: React.ReactNode;
+    children: React.ReactNode;
+}
+interface TabsProps {
+    items: TabItem[];
+    defaultIndex?: number;
+    variant?: 'tabs' | 'pills';
+    fill?: boolean;
+    justified?: boolean;
+    className?: string;
+}
+/**
+ * Bootstrap tabs/pills driven by React state (no Bootstrap JS).
+ */
+declare function Tabs({ items, defaultIndex, variant, fill, justified, className, }: TabsProps): react_jsx_runtime.JSX.Element;
+
+interface ToastProps {
+    show: boolean;
+    onClose: () => void;
+    title?: string;
+    theme?: BootstrapTheme;
+    /** Auto-dismiss after this many ms; 0 disables. */
+    autohideMs?: number;
+    children: React.ReactNode;
+}
+/**
+ * Controlled Bootstrap toast (no Bootstrap JS). Render inside a
+ * `.toast-container` to position it. Auto-dismisses unless `autohideMs={0}`.
+ */
+declare function Toast({ show, onClose, title, theme, autohideMs, children }: ToastProps): react_jsx_runtime.JSX.Element | null;
+
+interface TooltipProps {
+    title: string;
+    placement?: 'top' | 'bottom' | 'left' | 'right';
+    children: React.ReactNode;
+}
+/**
+ * Lightweight tooltip driven by hover/focus state (no Bootstrap JS / Popper).
+ * Uses Bootstrap's `.tooltip` styles; positions the bubble with inline styles.
+ */
+declare function Tooltip({ title, placement, children }: TooltipProps): react_jsx_runtime.JSX.Element;
+
+interface BadgeProps {
+    theme?: BootstrapTheme;
+    /** Fully rounded "pill" shape. */
+    pill?: boolean;
+    /** Position the badge over a parent (parent needs `position-relative`). */
+    positioned?: boolean;
+    className?: string;
+    children: React.ReactNode;
+}
+/** Bootstrap badge with a contrast-aware `text-bg-*` background. */
+declare function Badge({ theme, pill, positioned, className, children }: BadgeProps): react_jsx_runtime.JSX.Element;
+
+interface BreadcrumbItem {
+    label: React.ReactNode;
+    href?: string;
+}
+interface BreadcrumbProps {
+    items: BreadcrumbItem[];
+    /** Optional divider character (Bootstrap default is "/"). */
+    divider?: string;
+    className?: string;
+    label?: string;
+}
+/** Bootstrap breadcrumb trail. The last item is rendered as the active page. */
+declare function Breadcrumb({ items, divider, className, label }: BreadcrumbProps): react_jsx_runtime.JSX.Element;
+
+interface SpinnerProps {
+    theme?: BootstrapTheme;
+    /** `border` (default) or `grow`. */
+    variant?: 'border' | 'grow';
+    small?: boolean;
+    /** Visually-hidden status text for screen readers. */
+    label?: string;
+    className?: string;
+}
+/** Bootstrap loading spinner with an accessible status label. */
+declare function Spinner({ theme, variant, small, label, className, }: SpinnerProps): react_jsx_runtime.JSX.Element;
+
+type AvatarStatus = 'online' | 'offline' | 'away' | 'busy';
+interface AvatarProps {
+    src?: string;
+    alt?: string;
+    /** Fallback initials shown when there is no `src`. */
+    initials?: string;
+    /** Pixel size (width & height). Default 40. */
+    size?: number;
+    /** Square with rounded corners instead of a circle. */
+    rounded?: boolean;
+    /** Background theme for the initials fallback. */
+    theme?: BootstrapTheme;
+    status?: AvatarStatus;
+    className?: string;
+}
+/** A user avatar — image or initials fallback, optional presence dot. */
+declare function Avatar({ src, alt, initials, size, rounded, theme, status, className, }: AvatarProps): react_jsx_runtime.JSX.Element;
+interface AvatarGroupProps {
+    /** Pixel overlap between stacked avatars. Default 12. */
+    overlap?: number;
+    className?: string;
+    children: React.ReactNode;
+}
+/** Overlapping stack of `Avatar`s. */
+declare function AvatarGroup({ overlap, className, children }: AvatarGroupProps): react_jsx_runtime.JSX.Element;
+
+interface ListGroupProps {
+    /** Remove the outer border/rounding (for use inside a card). */
+    flush?: boolean;
+    /** Lay items out horizontally. */
+    horizontal?: boolean;
+    className?: string;
+    children: React.ReactNode;
+}
+/** Bootstrap list group container. */
+declare function ListGroup({ flush, horizontal, className, children }: ListGroupProps): react_jsx_runtime.JSX.Element;
+interface ListGroupItemProps {
+    active?: boolean;
+    disabled?: boolean;
+    /** Render as an interactive action (hover/focus styles). Implied by `href`/`onClick`. */
+    action?: boolean;
+    theme?: BootstrapTheme;
+    href?: string;
+    onClick?: () => void;
+    className?: string;
+    children: React.ReactNode;
+}
+/** A single list group item — `<a>`, `<button>` or `<div>` depending on its props. */
+declare function ListGroupItem({ active, disabled, action, theme, href, onClick, className, children, }: ListGroupItemProps): react_jsx_runtime.JSX.Element;
+
+interface TableColumn<T> {
+    /** Key into the row, or a unique id when using `render`. */
+    key: string;
+    header: ReactNode;
+    /** Custom cell renderer; defaults to `String(row[key])`. */
+    render?: (row: T, index: number) => ReactNode;
+    align?: 'start' | 'center' | 'end';
+    className?: string;
+    headerClassName?: string;
+}
+interface TableProps<T> {
+    columns: TableColumn<T>[];
+    data: T[];
+    rowKey?: (row: T, index: number) => Key;
+    striped?: boolean;
+    hover?: boolean;
+    bordered?: boolean;
+    borderless?: boolean;
+    small?: boolean;
+    /** Wrap in a `.table-responsive` scroll container. */
+    responsive?: boolean;
+    /** `table-dark` / coloured table variant. */
+    theme?: 'dark' | 'light';
+    caption?: ReactNode;
+    emptyMessage?: ReactNode;
+    className?: string;
+}
+/** A typed, declarative table driven by `columns` + `data`. */
+declare function Table<T>({ columns, data, rowKey, striped, hover, bordered, borderless, small, responsive, theme, caption, emptyMessage, className, }: TableProps<T>): react_jsx_runtime.JSX.Element;
+
+interface PaginationProps {
+    /** 1-based current page. */
+    page: number;
+    totalPages: number;
+    onPageChange?: (page: number) => void;
+    size?: ComponentSize;
+    /** Numbered links to show on each side of the current page. Default 1. */
+    siblingCount?: number;
+    align?: 'start' | 'center' | 'end';
+    /** Hide the ‹ › previous/next controls. */
+    hideControls?: boolean;
+    label?: string;
+    className?: string;
+}
+/** Bootstrap pagination. Renders `<button>`s when `onPageChange` is given, else `<a href="#">`. */
+declare function Pagination({ page, totalPages, onPageChange, size, siblingCount, align, hideControls, label, className, }: PaginationProps): react_jsx_runtime.JSX.Element | null;
+
+interface Step {
+    label: React.ReactNode;
+    description?: React.ReactNode;
+    /** Bootstrap icon class for the marker (e.g. `bi-person`); defaults to a number/check. */
+    icon?: string;
+}
+interface StepperProps {
+    steps: Step[];
+    /** 0-based index of the current step. Earlier steps render as complete. */
+    active: number;
+    orientation?: 'horizontal' | 'vertical';
+    /** Makes markers clickable. */
+    onStepClick?: (index: number) => void;
+    className?: string;
+}
+/** A progress stepper (wizard). Pure/controlled — drive `active` from parent state. */
+declare function Stepper({ steps, active, orientation, onStepClick, className }: StepperProps): react_jsx_runtime.JSX.Element;
+
+interface DropdownItem {
+    label?: React.ReactNode;
+    href?: string;
+    onClick?: () => void;
+    active?: boolean;
+    disabled?: boolean;
+    /** Render a divider (other fields ignored). */
+    divider?: boolean;
+    /** Render a non-interactive header label. */
+    header?: boolean;
+    icon?: string;
+}
+interface DropdownProps {
+    label: React.ReactNode;
+    items: DropdownItem[];
+    theme?: BootstrapTheme;
+    size?: ComponentSize;
+    variant?: 'solid' | 'outline';
+    /** Open the menu from the end of the toggle. */
+    align?: 'start' | 'end';
+    /** Drop direction. */
+    direction?: 'down' | 'up' | 'start' | 'end';
+    /** Split button: separate caret toggle. */
+    split?: boolean;
+    className?: string;
+}
+/**
+ * Bootstrap dropdown (driven by the Bootstrap JS bundle via `data-bs-toggle`).
+ * Ensure `bootstrap.bundle.js` is loaded in the host app.
+ */
+declare function Dropdown({ label, items, theme, size, variant, align, direction, split, className, }: DropdownProps): react_jsx_runtime.JSX.Element;
+
+interface CarouselSlide {
+    src?: string;
+    alt?: string;
+    /** Custom slide content (used instead of an image). */
+    content?: React.ReactNode;
+    caption?: {
+        title?: React.ReactNode;
+        text?: React.ReactNode;
+    };
+}
+interface CarouselProps {
+    /** Required: unique id used to wire controls/indicators. */
+    id: string;
+    slides: CarouselSlide[];
+    controls?: boolean;
+    indicators?: boolean;
+    /** Auto-cycle. `true` starts after first interaction; `'carousel'` starts on load. */
+    ride?: boolean | 'carousel';
+    /** Crossfade instead of slide. */
+    fade?: boolean;
+    interval?: number;
+    className?: string;
+}
+/**
+ * Bootstrap carousel (driven by the Bootstrap JS bundle). Pass a unique `id`.
+ */
+declare function Carousel({ id, slides, controls, indicators, ride, fade, interval, className, }: CarouselProps): react_jsx_runtime.JSX.Element;
+
+interface OffcanvasProps {
+    /** Required: unique id; triggers reference it via `target`. */
+    id: string;
+    title?: React.ReactNode;
+    placement?: 'start' | 'end' | 'top' | 'bottom';
+    /** Allow body scroll while open. */
+    scroll?: boolean;
+    /** Show a backdrop (default true). */
+    backdrop?: boolean;
+    footer?: React.ReactNode;
+    className?: string;
+    children: React.ReactNode;
+}
+/**
+ * Bootstrap offcanvas panel (driven by the Bootstrap JS bundle). Pair with an
+ * `OffcanvasTrigger` (or any element with `data-bs-toggle="offcanvas"`).
+ */
+declare function Offcanvas({ id, title, placement, scroll, backdrop, footer, className, children, }: OffcanvasProps): react_jsx_runtime.JSX.Element;
+interface OffcanvasTriggerProps {
+    /** The `id` of the Offcanvas to open. */
+    target: string;
+    theme?: BootstrapTheme;
+    variant?: 'solid' | 'outline';
+    size?: ComponentSize;
+    className?: string;
+    children: React.ReactNode;
+}
+/** A button that opens the Offcanvas with the matching `target` id. */
+declare function OffcanvasTrigger({ target, theme, variant, size, className, children, }: OffcanvasTriggerProps): react_jsx_runtime.JSX.Element;
+
+interface ButtonProps extends React.ButtonHTMLAttributes<HTMLButtonElement> {
+    theme?: BootstrapTheme;
+    outline?: boolean;
+    size?: ComponentSize;
+    icon?: string;
+    label?: string;
+}
+declare function Button({ theme, outline, size, icon, label, children, className, ...props }: ButtonProps): react_jsx_runtime.JSX.Element;
+
+interface InputProps extends React.InputHTMLAttributes<HTMLInputElement> {
+    label?: string;
+    igroupSize?: ComponentSize;
+    fgroupClass?: string;
+    error?: string;
+    hint?: string;
+}
+declare const Input: React$1.ForwardRefExoticComponent<InputProps & React$1.RefAttributes<HTMLInputElement>>;
+
+interface SelectProps extends React.SelectHTMLAttributes<HTMLSelectElement> {
+    label?: string;
+    fgroupClass?: string;
+    error?: string;
+    options?: Array<{
+        value: string | number;
+        label: string;
+    }>;
+    children?: React.ReactNode;
+}
+declare const Select: React$1.ForwardRefExoticComponent<SelectProps & React$1.RefAttributes<HTMLSelectElement>>;
+
+interface TextareaProps extends React.TextareaHTMLAttributes<HTMLTextAreaElement> {
+    label?: string;
+    fgroupClass?: string;
+    error?: string;
+    hint?: string;
+}
+declare const Textarea: React$1.ForwardRefExoticComponent<TextareaProps & React$1.RefAttributes<HTMLTextAreaElement>>;
+
+interface InputSwitchProps {
+    name: string;
+    label?: string;
+    id?: string;
+    checked?: boolean;
+    defaultChecked?: boolean;
+    onChange?: (checked: boolean) => void;
+    fgroupClass?: string;
+    error?: string;
+}
+declare const InputSwitch: React$1.ForwardRefExoticComponent<InputSwitchProps & React$1.RefAttributes<HTMLInputElement>>;
+
+interface InputColorProps extends React.InputHTMLAttributes<HTMLInputElement> {
+    label?: string;
+    fgroupClass?: string;
+    error?: string;
+}
+declare function InputColor({ name, label, fgroupClass, error, className, defaultValue, ...props }: InputColorProps): react_jsx_runtime.JSX.Element;
+
+interface InputFileProps extends React.InputHTMLAttributes<HTMLInputElement> {
+    label?: string;
+    fgroupClass?: string;
+    error?: string;
+    multiple?: boolean;
+}
+declare function InputFile({ name, label, fgroupClass, error, multiple, className, ...props }: InputFileProps): react_jsx_runtime.JSX.Element;
+
+interface InputFlatpickrProps extends React.InputHTMLAttributes<HTMLInputElement> {
+    label?: string;
+    fgroupClass?: string;
+    error?: string;
+    dateType?: 'text' | 'date' | 'time' | 'datetime';
+    options?: Record<string, unknown>;
+}
+declare function InputFlatpickr({ name, label, fgroupClass, error, dateType, options, className, ...props }: InputFlatpickrProps): react_jsx_runtime.JSX.Element;
+
+interface InputTomSelectProps extends React.SelectHTMLAttributes<HTMLSelectElement> {
+    label?: string;
+    fgroupClass?: string;
+    error?: string;
+    options?: Array<{
+        value: string | number;
+        label: string;
+    }>;
+    tomSelectOptions?: Record<string, unknown>;
+}
+declare function InputTomSelect({ name, label, fgroupClass, error, options, tomSelectOptions, className, 'aria-label': ariaLabelProp, ...props }: InputTomSelectProps): react_jsx_runtime.JSX.Element;
+
+interface ModalProps {
+    id: string;
+    title?: string;
+    size?: ComponentSize | 'xl';
+    theme?: BootstrapTheme;
+    staticBackdrop?: boolean;
+    scrollable?: boolean;
+    centered?: boolean;
+    footer?: React.ReactNode;
+    children: React.ReactNode;
+    onShow?: () => void;
+    onHide?: () => void;
+}
+declare function Modal({ id, title, size, theme, staticBackdrop, scrollable, centered, footer, children, }: ModalProps): react_jsx_runtime.JSX.Element;
+
+interface DatatableColumn {
+    title: string;
+    field: string;
+    sorter?: string;
+    formatter?: string;
+    width?: number | string;
+}
+interface DatatableProps {
+    id?: string;
+    columns: DatatableColumn[];
+    data?: Record<string, unknown>[];
+    apiUrl?: string;
+    tabulatorOptions?: Record<string, unknown>;
+    className?: string;
+}
+declare function Datatable({ id, columns, data, apiUrl, tabulatorOptions, className, }: DatatableProps): react_jsx_runtime.JSX.Element;
+
+interface EditorProps {
+    name: string;
+    label?: string;
+    value?: string;
+    /** Init-only: Quill 2 has no re-init API, so changes after mount are ignored. */
+    placeholder?: string;
+    /** Init-only: Quill 2 has no re-init API, so changes after mount are ignored. */
+    quillOptions?: Record<string, unknown>;
+    fgroupClass?: string;
+    onChange?: (html: string) => void;
+}
+declare function Editor({ name, label, value, placeholder, quillOptions, fgroupClass, onChange, }: EditorProps): react_jsx_runtime.JSX.Element;
+
+interface UsePushMenuOptions {
+    sidebarBreakpoint?: number;
+    enablePersistence?: boolean;
+    isMiniMode?: boolean;
+}
+interface UsePushMenuResult {
+    isCollapsed: boolean;
+    isMobileOpen: boolean;
+    toggle: () => void;
+    collapse: () => void;
+    expand: () => void;
+}
+/**
+ * Hook that manages sidebar open/collapse state with responsive behavior.
+ * Ports the logic from push-menu.ts.
+ */
+declare function usePushMenu(options?: UsePushMenuOptions): UsePushMenuResult;
+
+interface UseCardWidgetResult {
+    isCollapsed: boolean;
+    isMaximized: boolean;
+    isRemoved: boolean;
+    collapse: () => void;
+    expand: () => void;
+    toggleCollapse: () => void;
+    maximize: () => void;
+    minimize: () => void;
+    toggleMaximize: () => void;
+    remove: () => void;
+}
+/**
+ * Hook that manages card widget state: collapse, maximize, and remove.
+ * Ports the logic from card-widget.ts.
+ */
+declare function useCardWidget(initialCollapsed?: boolean): UseCardWidgetResult;
+
+interface UseDirectChatResult {
+    isContactsOpen: boolean;
+    toggleContacts: () => void;
+    openContacts: () => void;
+    closeContacts: () => void;
+}
+/**
+ * Hook that manages direct chat contacts pane visibility.
+ * Ports the logic from direct-chat.ts.
+ */
+declare function useDirectChat(): UseDirectChatResult;
+
+interface UseFullscreenResult {
+    isFullscreen: boolean;
+    toggleFullscreen: () => void;
+    enterFullscreen: () => void;
+    exitFullscreen: () => void;
+}
+/**
+ * Hook that manages browser fullscreen state.
+ * Ports the logic from fullscreen.ts.
+ */
+declare function useFullscreen(): UseFullscreenResult;
+
+interface UseTreeviewAnimationResult {
+    ref: React.RefObject<HTMLUListElement | null>;
+    style: React.CSSProperties;
+}
+/**
+ * Hook that manages height animation for treeview expansion/collapse.
+ * Uses CSS transitions instead of jQuery's slideUp/slideDown.
+ */
+declare function useTreeviewAnimation(isOpen: boolean, speed?: number): UseTreeviewAnimationResult;
+
+declare function useSortable(enabled?: boolean): void;
+
+export { Accordion, type AccordionItem, type AccordionProps, Alert, ApexChart, AppContent, type AppContentProps, AuthLayout, type AuthLayoutProps, Avatar, AvatarGroup, type AvatarGroupProps, type AvatarProps, type AvatarStatus, Badge, type BadgeProps, type BootstrapTheme, Breadcrumb, type BreadcrumbItem, type BreadcrumbProps, type BreakpointSize, Button, Callout, Card, Carousel, type CarouselProps, type CarouselSlide, type ColorMode, ColorModeProvider, ColorModeToggle, type CommandItem, CommandPalette, CommandPaletteProvider, type ComponentSize, DashboardLayout, type DashboardLayoutProps, Datatable, DescriptionBlock, DirectChat, type DirectChatContact, type DirectChatMessage, Dropdown, type DropdownItem, type DropdownProps, Editor, Footer, InfoBox, Input, InputColor, InputFile, InputFlatpickr, InputSwitch, InputTomSelect, type LinkComponent, type LinkProps, LinkProvider, ListGroup, ListGroupItem, type ListGroupItemProps, type ListGroupProps, type MenuGroup, type MenuHeader, type MenuItem, type MenuNode, Modal, NavMessages, NavNotifications, NavTasks, Offcanvas, type OffcanvasProps, OffcanvasTrigger, type OffcanvasTriggerProps, Pagination, type PaginationProps, ProfileCard, Progress, ProgressGroup, Ratings, Select, Sidebar, SidebarBrand, SidebarNav, SidebarNavItem, SidebarOverlay, SidebarProvider, SmallBox, SparklineChart, Spinner, type SpinnerProps, type Step, Stepper, type StepperProps, type TabItem, Table, type TableColumn, type TableProps, Tabs, type TabsProps, Textarea, Timeline, Toast, type ToastProps, Tooltip, type TooltipProps, Topbar, type TopbarUser, WorldMap, flattenMenuToCommands, useCardWidget, useColorModeContext, useCommandPalette, useDirectChat, useFullscreen, useLinkComponent, usePushMenu, useSidebarContext, useSortable, useTreeviewAnimation };