/**
 * @fileoverview Pagination primitive — page navigation controls with previous/next links and ellipsis.
 * Pure HTML nav with Tailwind styling, using Button variants for link appearance. Part of the Saasflare base component layer.
 * @module packages/ui/components/ui/pagination
 * @layer core
 *
 * @component
 * @example
 * import { Pagination, PaginationContent, PaginationItem, PaginationLink, PaginationPrevious, PaginationNext } from '@saasflare/ui';
 * <Pagination>
 *   <PaginationContent>
 *     <PaginationItem><PaginationPrevious href="#" /></PaginationItem>
 *     <PaginationItem><PaginationLink href="#" isActive>1</PaginationLink></PaginationItem>
 *     <PaginationItem><PaginationLink href="#">2</PaginationLink></PaginationItem>
 *     <PaginationItem><PaginationNext href="#" /></PaginationItem>
 *   </PaginationContent>
 * </Pagination>
 */
import * as React from "react";
import { type SaasflareComponentProps } from "../../providers";
interface PaginationProps extends Omit<React.ComponentProps<"nav">, keyof SaasflareComponentProps>, SaasflareComponentProps {
}
/**
 * Pagination root — semantic `<nav>` landmark wrapping the page controls.
 *
 * Carries the theme axes (`surface`/`radius`/`animated`) so descendant links
 * can inherit the active design-system context.
 */
declare function Pagination({ className, surface, radius, animated, iconWeight, ...props }: PaginationProps): import("react/jsx-runtime").JSX.Element;
/** Horizontal `<ul>` list that holds the {@link PaginationItem} entries. */
declare function PaginationContent({ className, ...props }: React.ComponentProps<"ul">): import("react/jsx-runtime").JSX.Element;
/** Single `<li>` slot wrapping a {@link PaginationLink} or control. */
declare function PaginationItem({ ...props }: React.ComponentProps<"li">): import("react/jsx-runtime").JSX.Element;
interface PaginationLinkProps extends Omit<React.ComponentProps<"a">, keyof SaasflareComponentProps>, SaasflareComponentProps {
    /** Marks the link as the current page (renders the `outline` button variant + `aria-current`). */
    isActive?: boolean;
    /** Button-variant size token controlling the link's footprint. Defaults to the icon-only `"icon"`. */
    size?: "xs" | "sm" | "md" | "lg" | "xl" | "icon" | "icon-xs" | "icon-sm" | "icon-lg";
}
/**
 * Anchor styled as a button via {@link buttonVariants}. Active state switches
 * to the `outline` variant; inactive uses `ghost`. Carries the theme axes so
 * its radius/surface follow the design-system context like {@link Button}.
 */
declare function PaginationLink({ className, isActive, size, surface, radius, animated, iconWeight, ...props }: PaginationLinkProps): import("react/jsx-runtime").JSX.Element;
/** "Previous page" control — a labelled {@link PaginationLink} with a left caret. */
declare function PaginationPrevious({ className, ...props }: React.ComponentProps<typeof PaginationLink>): import("react/jsx-runtime").JSX.Element;
/** "Next page" control — a labelled {@link PaginationLink} with a right caret. */
declare function PaginationNext({ className, ...props }: React.ComponentProps<typeof PaginationLink>): import("react/jsx-runtime").JSX.Element;
/** Non-interactive ellipsis indicating a gap (skipped pages) in the sequence. */
declare function PaginationEllipsis({ className, ...props }: React.ComponentProps<"span">): import("react/jsx-runtime").JSX.Element;
export { Pagination, PaginationContent, PaginationLink, PaginationItem, PaginationPrevious, PaginationNext, PaginationEllipsis, };