import { type ComponentPropsWithoutRef, type ReactNode } from "react";
export interface PaginationProps extends Omit<ComponentPropsWithoutRef<"nav">, "onChange" | "defaultValue" | "children"> {
    /** Total number of items across all pages. Required for total-row label + total-page math. */
    totalItems: number;
    /** Items per page. Controls page math AND drives the optional page-size selector. */
    pageSize: number;
    /** Available page-size options. When omitted, the page-size selector is hidden. */
    pageSizeOptions?: number[];
    /** Controlled: current 1-based page index. */
    page?: number;
    /** Uncontrolled: initial 1-based page index. Default `1`. */
    defaultPage?: number;
    /** Fires when the user navigates to a new page. */
    onPageChange?: (page: number) => void;
    /** Fires when the user picks a new page size. */
    onPageSizeChange?: (pageSize: number) => void;
    /** Number of neighbor pages to render around the current page. Default `1`. */
    siblingCount?: number;
    /** Number of pages to always show at the boundaries. Default `1`. */
    boundaryCount?: number;
    /** Show First / Last buttons. Default `true`. */
    showFirstLast?: boolean;
    /** Show Prev / Next buttons. Default `true`. */
    showPrevNext?: boolean;
    /**
     * Compact mode hides the numeric page list entirely — leaves
     * Prev / Next + the current-page label. Use for cramped surfaces
     * (sidebar widgets, mobile breakpoints).
     */
    compact?: boolean;
    /** Show the "Showing X–Y of Z" label. Default `true`. */
    showTotal?: boolean;
    /** Override the total label. Receives `{ from, to, total }`. */
    formatTotal?: (range: {
        from: number;
        to: number;
        total: number;
    }) => ReactNode;
    /**
     * Show a "Go to page" input. Lets users jump straight to a page
     * without clicking through. Useful for very long lists. Default `false`.
     */
    showJumpToPage?: boolean;
    /** Disable the entire control (e.g. while loading). */
    disabled?: boolean;
    /** Size. Default `"md"`. */
    size?: "sm" | "md" | "lg";
}
export declare const Pagination: import("react").ForwardRefExoticComponent<PaginationProps & import("react").RefAttributes<HTMLElement>>;
//# sourceMappingURL=Pagination.d.ts.map