/**
 * @fileoverview DataPagination — a total-driven, batteries-included pagination
 * control. A fully additive sibling to the `Pagination` compound (NOT a rename
 * or overload of it): give it `total` + `pageSize` (or a precomputed
 * `pageCount`) and it renders prev/next controls, numbered page links with
 * ellipsis truncation, an optional page-size `<select>`, and an optional
 * "X–Y of N" summary in a single prop call.
 *
 * It is built ENTIRELY on existing primitives — it composes the `Pagination*`
 * parts and drives them with the {@link usePagination} hook (zero new range /
 * ellipsis logic, zero new runtime deps). Use the `Pagination` compound when you
 * need full hand-wired control; reach for `DataPagination` for the common
 * total-driven case (e.g. a table footer).
 *
 * @module packages/ui/components/ui/data-pagination
 * @layer core
 *
 * @component
 * @example
 * import { DataPagination } from '@saasflare/ui';
 * <DataPagination total={248} pageSize={20} showSummary onPageChange={fetchPage} />
 */
import * as React from "react";
import { type SaasflareComponentProps } from "../../providers";
import { type PaginationSummaryRange } from "../../hooks/use-pagination";
/**
 * Where the page-size selector + range summary sit relative to the page numbers.
 *
 * - `"split"` — summary on the leading edge, numbers centred, size selector on
 *   the trailing edge (the canonical table-footer layout).
 * - `"center"` — everything grouped and centred.
 * - `"end"` — everything grouped on the trailing edge.
 *
 * @example
 * <DataPagination total={248} pageSize={20} layout="end" />
 */
export type DataPaginationLayout = "split" | "center" | "end";
/** Size token for the number links + controls. */
type DataPaginationSize = "xs" | "sm" | "md" | "lg";
/** i18n / label overrides for {@link DataPagination}. */
export interface DataPaginationLabels {
    /** Accessible label for the "previous" control. Default: `"Previous"`. */
    previous?: string;
    /** Accessible label for the "next" control. Default: `"Next"`. */
    next?: string;
    /** Builder for the summary string. Receives `{ from, to, total }`. Default: `({ from, to, total }) => `${from}–${to} of ${total}``. */
    summary?: (range: PaginationSummaryRange) => string;
    /** Builder for the per-number aria-label. Default: `(p) => `Go to page ${p}``. */
    page?: (page: number) => string;
    /** Label/prefix for the page-size select. Default: `"Rows per page"`. */
    pageSize?: string;
}
/**
 * Props for {@link DataPagination} — a total-driven, batteries-included
 * pagination control. Mutually-exclusive total inputs: provide EITHER `total`
 * (item count, with `pageSize`) OR `pageCount` (precomputed page count).
 * `pageCount` wins if both are given.
 */
export interface DataPaginationProps extends Omit<React.ComponentProps<"nav">, "onChange" | keyof SaasflareComponentProps>, SaasflareComponentProps {
    /** Total number of ITEMS across all pages. Used with `pageSize` to derive page count + the "X–Y of N" summary. Ignored if `pageCount` is set. */
    total?: number;
    /** Precomputed total number of PAGES. Use when the backend returns a page count directly (no item total). Takes precedence over `total`/`pageSize`. */
    pageCount?: number;
    /** Items per page. Required when using `total`; drives summary math + page-count derivation. Default: `10`. */
    pageSize?: number;
    /** Controlled active page (1-indexed). When provided, the component is controlled and you MUST update it from `onPageChange`. */
    page?: number;
    /** Initial page for uncontrolled mode. Default: `1`. Ignored when `page` is provided. */
    defaultPage?: number;
    /** Fired with the next 1-indexed page when the user navigates. Always clamped to `[1, derivedPageCount]`. */
    onPageChange?: (page: number) => void;
    /** Sibling pages shown each side of the active page (forwarded to {@link usePagination}). Default: `1`. */
    siblings?: number;
    /** Boundary pages pinned at each end (forwarded to {@link usePagination}). Default: `1`. */
    boundaries?: number;
    /** Show the prev/next caret controls. Default: `true`. */
    showControls?: boolean;
    /** Show numbered page links + ellipsis. When `false`, renders only controls + summary (compact mode). Default: `true`. */
    showNumbers?: boolean;
    /** Render the "X–Y of N" summary text. Auto-disabled (with a dev warning) when neither `total` nor an item count is known. Default: `false`. */
    showSummary?: boolean;
    /** Render a page-size `<select>` built on {@link NativeSelect}. Requires `onPageSizeChange`. Default: `false`. */
    showPageSize?: boolean;
    /** Selectable page sizes for the size selector. Default: `[10, 20, 50, 100]`. */
    pageSizeOptions?: readonly number[];
    /**
     * Fired with the chosen page size. The component does NOT internally manage
     * `pageSize` (controlled-only) — keeps a single source of truth with the
     * consumer. Changing `pageSize` does NOT auto-correct the active page when it
     * exceeds the new page count; reset the page yourself (e.g. `setPage(1)`).
     */
    onPageSizeChange?: (pageSize: number) => void;
    /** Visual placement of summary/size-selector vs the page numbers. Default: `"split"` (summary left, numbers center, size right). */
    layout?: DataPaginationLayout;
    /** Button-variant size token for prev/next + number links (forwarded to PaginationLink). Default: `"md"` (icon-square numbers + `md` controls). */
    size?: DataPaginationSize;
    /** Accessible label for the nav landmark. Default: `"pagination"`. */
    "aria-label"?: string;
    /** i18n / label overrides. */
    labels?: DataPaginationLabels;
}
/**
 * Total-driven pagination control. Composes the existing `Pagination` compound
 * + the {@link usePagination} hook into a single semantic component with an
 * optional page-size selector and "X–Y of N" summary. Controlled or
 * uncontrolled. Inherits the `surface`/`radius`/`animated`/`iconWeight` axes
 * from {@link SaasflareShell} and forwards them into the compound parts so the
 * whole control is visually coherent.
 *
 * For full, hand-wired control over each link, use the lower-level `Pagination`
 * compound directly.
 *
 * @component
 * @layer core
 *
 * @example
 * // Uncontrolled, total-driven
 * <DataPagination total={248} pageSize={20} showSummary onPageChange={fetchPage} />
 *
 * @example
 * // Controlled with page-size selector (table footer)
 * <DataPagination
 *   total={count} pageSize={size} page={page}
 *   showSummary showPageSize pageSizeOptions={[10, 25, 50]}
 *   onPageChange={setPage} onPageSizeChange={(s) => { setSize(s); setPage(1) }}
 * />
 *
 * @example
 * // Compact: controls + summary only, no numbers
 * <DataPagination pageCount={9} page={p} showNumbers={false} showSummary onPageChange={setP} />
 */
export declare function DataPagination({ total, pageCount, pageSize, page, defaultPage, onPageChange, siblings, boundaries, showControls, showNumbers, showSummary, showPageSize, pageSizeOptions, onPageSizeChange, layout, size, className, surface, radius, animated, iconWeight, labels, "aria-label": ariaLabel, ...props }: DataPaginationProps): React.JSX.Element;
export {};