import * as i0 from '@angular/core';
import { InputSignal, InputSignalWithTransform, OutputEmitterRef, Signal } from '@angular/core';
import { VariantProps } from 'class-variance-authority';

/**
 * Event emitted when the paginator changes page index or page size.
 */
interface PageEvent {
    /** The current zero-based page index. */
    pageIndex: number;
    /** The previous zero-based page index. */
    previousPageIndex: number;
    /** The current page size. */
    pageSize: number;
    /** The previous page size before the event. */
    previousPageSize: number;
    /** The total number of items being paged. */
    length: number;
}
/**
 * Function signature for custom range label formatting.
 * Used for i18n and custom label display.
 *
 * @param page Current page index (zero-based)
 * @param pageSize Number of items per page
 * @param length Total number of items
 * @returns Formatted string to display (e.g., "1 – 10 of 100")
 */
type RangeLabelFn = (page: number, pageSize: number, length: number) => string;
/**
 * Default range label function.
 * Produces output like "1 – 10 of 100" or "0 of 0" when empty.
 */
declare function defaultRangeLabel(page: number, pageSize: number, length: number): string;

type PaginatorSize = 'sm' | 'md';
type PaginatorLayout = 'compact' | 'spread';
/**
 * CVA variants for the paginator container.
 * Controls overall layout and spacing.
 */
declare const paginatorContainerVariants: (props?: {
    size?: PaginatorSize;
    layout?: PaginatorLayout;
}) => string;
/**
 * CVA variants for paginator navigation buttons.
 * Controls button sizing, borders, and interactive states.
 */
declare const paginatorButtonVariants: (props?: {
    size?: PaginatorSize;
}) => string;
/**
 * CVA variants for the range label text.
 * Controls typography and color.
 */
declare const paginatorRangeLabelVariants: (props?: {
    size?: PaginatorSize;
}) => string;
/**
 * CVA variants for the page size select element.
 * Controls sizing and styling of the native select.
 */
declare const paginatorSelectVariants: (props?: {
    size?: PaginatorSize;
}) => string;
/**
 * CVA variants for numbered page buttons.
 * Controls button sizing, active state, and interactive states.
 */
declare const paginatorPageButtonVariants: (props?: {
    size?: PaginatorSize;
    active?: boolean;
}) => string;
/**
 * CVA variants for the ellipsis indicator.
 * Controls sizing and styling of the "..." text.
 */
declare const paginatorEllipsisVariants: (props?: {
    size?: PaginatorSize;
}) => string;
type PaginatorContainerVariants = VariantProps<typeof paginatorContainerVariants>;
type PaginatorButtonVariants = VariantProps<typeof paginatorButtonVariants>;
type PaginatorRangeLabelVariants = VariantProps<typeof paginatorRangeLabelVariants>;
type PaginatorSelectVariants = VariantProps<typeof paginatorSelectVariants>;
type PaginatorPageButtonVariants = VariantProps<typeof paginatorPageButtonVariants>;
type PaginatorEllipsisVariants = VariantProps<typeof paginatorEllipsisVariants>;

/** Represents a page number or ellipsis marker in the page range. */
type PageRangeItem = number | 'ellipsis';
/**
 * Paginator component — provides navigation for paginated content.
 *
 * Displays navigation controls, optional page size selector, and range label
 * showing current position within the data set. Supports numbered page buttons
 * when `showPageNumbers` is enabled.
 *
 * @tokens `--color-foreground`, `--color-muted-foreground`,
 *         `--color-border`, `--color-muted`,
 *         `--color-disabled`, `--color-disabled-foreground`,
 *         `--color-ring`, `--color-primary`, `--color-primary-foreground`
 *
 * @example Basic usage
 * ```html
 * <com-paginator
 *   [length]="100"
 *   [pageSize]="10"
 *   [pageIndex]="0"
 *   (page)="onPageChange($event)"
 * />
 * ```
 *
 * @example With page size options
 * ```html
 * <com-paginator
 *   [length]="100"
 *   [pageSize]="10"
 *   [pageIndex]="0"
 *   [pageSizeOptions]="[5, 10, 25, 50]"
 *   (page)="onPageChange($event)"
 * />
 * ```
 *
 * @example With first/last buttons
 * ```html
 * <com-paginator
 *   [length]="100"
 *   [pageSize]="10"
 *   [pageIndex]="0"
 *   [showFirstLastButtons]="true"
 *   (page)="onPageChange($event)"
 * />
 * ```
 *
 * @example With numbered page buttons
 * ```html
 * <com-paginator
 *   [length]="97"
 *   [pageSize]="10"
 *   [showPageNumbers]="true"
 *   (page)="onPageChange($event)"
 * />
 * ```
 *
 * @example Spread layout (summary left, controls right)
 * ```html
 * <com-paginator
 *   [length]="97"
 *   [pageSize]="10"
 *   [showPageNumbers]="true"
 *   layout="spread"
 *   (page)="onPageChange($event)"
 * />
 * ```
 *
 * @example Small size
 * ```html
 * <com-paginator
 *   [length]="50"
 *   [pageSize]="10"
 *   size="sm"
 *   (page)="onPageChange($event)"
 * />
 * ```
 *
 * @example Custom range label (i18n)
 * ```html
 * <com-paginator
 *   [length]="100"
 *   [pageSize]="10"
 *   [rangeLabel]="customLabel"
 *   (page)="onPageChange($event)"
 * />
 * ```
 * ```ts
 * customLabel = (page, pageSize, length) => `Seite ${page + 1} von ${Math.ceil(length / pageSize)}`;
 * ```
 */
declare class ComPaginator {
    /** Page number buttons for keyboard navigation. */
    private readonly pageButtons;
    /** Total number of items being paged. */
    readonly length: InputSignal<number>;
    /** Number of items to display per page. */
    readonly pageSize: InputSignal<number>;
    /** Current zero-based page index. */
    readonly pageIndex: InputSignal<number>;
    /** Available page size options. Hides selector if empty. */
    readonly pageSizeOptions: InputSignal<number[]>;
    /** Whether to show first/last navigation buttons. */
    readonly showFirstLastButtons: InputSignalWithTransform<boolean, unknown>;
    /** Whether to show numbered page buttons. */
    readonly showPageNumbers: InputSignalWithTransform<boolean, unknown>;
    /** Whether all controls are disabled. */
    readonly disabled: InputSignalWithTransform<boolean, unknown>;
    /** Whether to hide the page size selector. */
    readonly hidePageSize: InputSignalWithTransform<boolean, unknown>;
    /** Size variant. */
    readonly size: InputSignal<PaginatorSize>;
    /** Layout variant. Only applies when showPageNumbers is true. */
    readonly layout: InputSignal<PaginatorLayout>;
    /** Number of pages to show on each side of the current page. */
    readonly siblingCount: InputSignal<number>;
    /** Number of pages to always show at the start and end. */
    readonly boundaryCount: InputSignal<number>;
    /** Accessible label for the nav element. */
    readonly ariaLabel: InputSignal<string>;
    /** Custom function for range label formatting. */
    readonly rangeLabel: InputSignal<RangeLabelFn>;
    /** Emits when page index or page size changes. */
    readonly page: OutputEmitterRef<PageEvent>;
    /** Total number of pages. */
    protected readonly numberOfPages: Signal<number>;
    /** Whether there is a previous page. */
    protected readonly hasPreviousPage: Signal<boolean>;
    /** Whether there is a next page. */
    protected readonly hasNextPage: Signal<boolean>;
    /** The formatted range label text. */
    protected readonly rangeLabelText: Signal<string>;
    /** Icon size based on component size. */
    protected readonly iconSize: Signal<'xs' | 'sm'>;
    /** Unique ID for page size label. */
    protected readonly pageSizeLabelId: Signal<string>;
    /** Unique ID for page size select element. */
    protected readonly pageSizeSelectId: Signal<string>;
    /** Classes for the container. */
    protected readonly containerClasses: Signal<string>;
    /** Classes for navigation buttons. */
    protected readonly buttonClasses: Signal<string>;
    /** Classes for the range label. */
    protected readonly rangeLabelClasses: Signal<string>;
    /** Classes for the page size select. */
    protected readonly selectClasses: Signal<string>;
    /** Classes for the ellipsis indicator. */
    protected readonly ellipsisClasses: Signal<string>;
    /** Cached classes for active page button. */
    protected readonly activePageButtonClasses: Signal<string>;
    /** Cached classes for inactive page button. */
    protected readonly inactivePageButtonClasses: Signal<string>;
    /**
     * Computed page range for numbered pagination.
     * Returns array like [0, 'ellipsis', 3, 4, 5, 'ellipsis', 9] (zero-indexed).
     */
    protected readonly pageRange: Signal<PageRangeItem[]>;
    /** Navigate to the first page. */
    firstPage(): void;
    /** Navigate to the previous page. */
    previousPage(): void;
    /** Navigate to the next page. */
    nextPage(): void;
    /** Navigate to the last page. */
    lastPage(): void;
    /** Navigate to a specific page by index (zero-based). */
    goToPage(pageIndex: number): void;
    /** Handle page size selection change. */
    protected onPageSizeChange(event: Event): void;
    /** Handle keyboard navigation within page buttons (roving tabindex). */
    protected onPageButtonsKeydown(event: KeyboardEvent): void;
    /** Track function for page items. */
    protected trackPageItem(index: number, item: PageRangeItem): string;
    private emitPageEvent;
    /** Generate a range of numbers from start to end (inclusive). */
    private range;
    static ɵfac: i0.ɵɵFactoryDeclaration<ComPaginator, never>;
    static ɵcmp: i0.ɵɵComponentDeclaration<ComPaginator, "com-paginator", ["comPaginator"], { "length": { "alias": "length"; "required": false; "isSignal": true; }; "pageSize": { "alias": "pageSize"; "required": false; "isSignal": true; }; "pageIndex": { "alias": "pageIndex"; "required": false; "isSignal": true; }; "pageSizeOptions": { "alias": "pageSizeOptions"; "required": false; "isSignal": true; }; "showFirstLastButtons": { "alias": "showFirstLastButtons"; "required": false; "isSignal": true; }; "showPageNumbers": { "alias": "showPageNumbers"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "hidePageSize": { "alias": "hidePageSize"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "layout": { "alias": "layout"; "required": false; "isSignal": true; }; "siblingCount": { "alias": "siblingCount"; "required": false; "isSignal": true; }; "boundaryCount": { "alias": "boundaryCount"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "aria-label"; "required": false; "isSignal": true; }; "rangeLabel": { "alias": "rangeLabel"; "required": false; "isSignal": true; }; }, { "page": "page"; }, never, never, true, never>;
}

export { ComPaginator, defaultRangeLabel, paginatorButtonVariants, paginatorContainerVariants, paginatorEllipsisVariants, paginatorPageButtonVariants, paginatorRangeLabelVariants, paginatorSelectVariants };
export type { PageEvent, PageRangeItem, PaginatorButtonVariants, PaginatorContainerVariants, PaginatorEllipsisVariants, PaginatorLayout, PaginatorPageButtonVariants, PaginatorRangeLabelVariants, PaginatorSelectVariants, PaginatorSize, RangeLabelFn };