import * as _angular_core from '@angular/core';
import { InjectionToken, Signal, Provider } from '@angular/core';
import { WritingDirection } from 'forty-cdk/core';
import * as forty_cdk_pagination from 'forty-cdk/pagination';

/**
 * One entry in the computed visible-page list: either a clickable page number
 * or an ellipsis gap standing in for a collapsed run of pages.
 */
interface PaginationItem {
    /** Discriminator: a real page button, or a non-interactive ellipsis gap. */
    readonly type: 'page' | 'ellipsis';
    /** 1-based page number. Present only when `type` is `'page'`. */
    readonly value?: number;
}

/**
 * Coordination contract owned by `ForPagination`. Page buttons, previous, and
 * next pieces inject it to read the current page / derived list and drive
 * navigation from a single source of truth.
 */
interface ForPaginationContext {
    /**
     * The consumer-bound 1-based page model. May hold an out-of-range value; use
     * `effectivePage` for anything that must reflect a valid page.
     */
    readonly page: Signal<number>;
    /**
     * The current page clamped to `[1, max(1, count)]`. This is the value every
     * piece must read for display and navigation semantics, so an out-of-range
     * `page` still resolves to a real page (matching `aria-current`, the visible
     * list, and previous/next math).
     */
    readonly effectivePage: Signal<number>;
    /** Total number of pages. */
    readonly count: Signal<number>;
    /** Whether the whole control is disabled. */
    readonly disabled: Signal<boolean>;
    /** The computed visible-page list (page numbers + ellipsis gaps). */
    readonly items: Signal<readonly PaginationItem[]>;
    /** Whether the current page is the first (no previous page). */
    readonly isFirst: Signal<boolean>;
    /** Whether the current page is the last (no next page). */
    readonly isLast: Signal<boolean>;
    /** Navigate to `page`, clamped to `[1, count]`. No-op when disabled. */
    goToPage(page: number): void;
    /** Navigate to the previous page. No-op at the first page or when disabled. */
    previous(): void;
    /** Navigate to the next page. No-op at the last page or when disabled. */
    next(): void;
}
/** DI token providing the pagination context to descendant pieces. */
declare const FOR_PAGINATION_CONTEXT: InjectionToken<ForPaginationContext>;

/**
 * Headless pagination navigation landmark, implementing the
 * [WAI-ARIA `navigation` landmark](https://www.w3.org/WAI/ARIA/apg/patterns/landmarks/examples/navigation.html)
 * with [`aria-current="page"`](https://www.w3.org/TR/wai-aria-1.2/#aria-current) on the active page.
 *
 * Derives the visible page list (with ellipsis gaps) from `page`, `count`,
 * `siblingCount`, and `boundaryCount`. Exposes `items()`, `isFirst()`,
 * `isLast()`, and navigation methods for the consumer template to render.
 *
 * There is no roving tabindex — each page button, previous, and next are their
 * own tab stops. RTL is visual-only: the resolved `dir` reflects on the host
 * for CSS; navigation semantics (previous = decrement, next = increment) never
 * change based on direction.
 *
 * @example
 * ```html
 * <nav forPagination [(page)]="page" [count]="20" ariaLabel="Pagination" #pg="forPagination">
 *   <button forPaginationPrevious ariaLabel="Previous page">‹</button>
 *   @for (item of pg.items(); track $index) {
 *     @if (item.type === 'page') {
 *       <button forPaginationItem [page]="item.value!">{{ item.value }}</button>
 *     } @else {
 *       <span aria-hidden="true">…</span>
 *     }
 *   }
 *   <button forPaginationNext ariaLabel="Next page">›</button>
 * </nav>
 * ```
 */
declare class ForPagination implements ForPaginationContext {
    #private;
    /**
     * Current 1-based page number. Two-way bindable via `[(page)]`. The implicit
     * `pageChange` output emits whenever the directive updates this value (via
     * clicks, previous, or next). Do not add a separate `pageChange` output.
     */
    readonly page: _angular_core.ModelSignal<number>;
    /**
     * Total number of pages. Always bind as `[count]="n"` (a number, not a
     * string). Required.
     */
    readonly count: _angular_core.InputSignal<number>;
    /**
     * Pages shown on each side of the current page before collapsing to an
     * ellipsis. Default read from `provideForPaginationDefaults` for the
     * surrounding scope (library fallback: `1`).
     */
    readonly siblingCount: _angular_core.InputSignalWithTransform<number, unknown>;
    /**
     * Pages always shown at each end (first and last). Default read from
     * `provideForPaginationDefaults` for the surrounding scope (library
     * fallback: `1`).
     */
    readonly boundaryCount: _angular_core.InputSignalWithTransform<number, unknown>;
    /** Whether the entire pagination control is disabled. */
    readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
    /**
     * Writing direction. When unset (default `null`), the inherited ambient
     * direction is resolved from the nearest ancestor carrying a `dir` attribute
     * (or `<html dir>`), defaulting to `'ltr'`. An explicit `[dir]` always wins.
     * The resolved value is reflected to the host `dir` attribute. RTL affects
     * visual layout only — previous/next semantics do not change.
     */
    readonly _dirInput: _angular_core.InputSignal<WritingDirection | null>;
    readonly dir: _angular_core.Signal<WritingDirection>;
    /**
     * Accessible label for the navigation landmark. Supply this (or point
     * `aria-labelledby` at a visible label element) when the page contains more
     * than one `<nav>`. A `null` or empty value emits no attribute.
     */
    readonly ariaLabel: _angular_core.InputSignal<string | null>;
    protected readonly resolvedAriaLabel: _angular_core.Signal<string | null>;
    /**
     * `count` coerced to a non-negative integer. A non-finite (`NaN` /
     * `±Infinity`), fractional, or negative `count` is sanitized here (dropped
     * fractional part, floored at `0`) so the visible list, reconciliation, and
     * navigation math never propagate invalid values. The raw `count` input stays
     * public and unchanged for consumers reading it back.
     */
    readonly effectiveCount: _angular_core.Signal<number>;
    /**
     * The current page reconciled against `count`, clamped to `[1, max(1,
     * count)]`. A consumer-written out-of-range `page` (e.g. `50` while `count`
     * is `10`) reads through as a real page here, so `aria-current`, the visible
     * list, and previous/next math all track a valid page. The `page` model
     * stays the writable source of truth; navigation writes the reconciled value
     * back into it via `goToPage`.
     */
    readonly effectivePage: _angular_core.Signal<number>;
    /** The computed visible-page list (page numbers + ellipsis gaps). */
    readonly items: _angular_core.Signal<readonly PaginationItem[]>;
    /** Whether the current page is the first (no previous page). */
    readonly isFirst: _angular_core.Signal<boolean>;
    /** Whether the current page is the last (no next page). */
    readonly isLast: _angular_core.Signal<boolean>;
    /**
     * Navigate to `page`, clamped to `[1, count]`, and write the reconciled value
     * back into the `page` model so a two-way `[(page)]` binding sees it. No-op
     * when disabled.
     */
    goToPage(page: number): void;
    /** Navigate to the previous page. No-op at the first page or when disabled. */
    previous(): void;
    /** Navigate to the next page. No-op at the last page or when disabled. */
    next(): void;
    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ForPagination, never>;
    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<ForPagination, "[forPagination]", ["forPagination"], { "page": { "alias": "page"; "required": false; "isSignal": true; }; "count": { "alias": "count"; "required": true; "isSignal": true; }; "siblingCount": { "alias": "siblingCount"; "required": false; "isSignal": true; }; "boundaryCount": { "alias": "boundaryCount"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "_dirInput": { "alias": "dir"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; }, { "page": "pageChange"; }, never, never, true, never>;
}

/**
 * Page number button. Apply on a `<button>` so Enter/Space activation is
 * native. Reflects `aria-current="page"` when this button represents the
 * currently active page. Clicking calls `ctx.goToPage(page)`.
 */
declare class ForPaginationItem {
    protected readonly buttonType: _angular_core.Signal<string | null>;
    protected readonly ctx: forty_cdk_pagination.ForPaginationContext;
    /** The 1-based page number this button navigates to. */
    readonly page: _angular_core.InputSignal<number>;
    /** Per-item disabled override (in addition to the root's `disabled`). */
    readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
    /** Whether this item is effectively disabled (own or root disabled). */
    readonly effectiveDisabled: _angular_core.Signal<boolean>;
    /** Whether this button represents the currently active page. */
    readonly isCurrent: _angular_core.Signal<boolean>;
    constructor();
    protected activate(): void;
    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ForPaginationItem, never>;
    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<ForPaginationItem, "[forPaginationItem]", ["forPaginationItem"], { "page": { "alias": "page"; "required": true; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
}

/**
 * Previous-page button. Apply on a `<button>` so Enter/Space activation is
 * native. Disabled (via the native `disabled` attribute) when the current page
 * is the first page or the root is disabled. Clicking calls `ctx.previous()`.
 */
declare class ForPaginationPrevious {
    protected readonly buttonType: _angular_core.Signal<string | null>;
    protected readonly ctx: forty_cdk_pagination.ForPaginationContext;
    /**
     * Accessible label for this button (e.g. "Previous page"). When `null`
     * (default), no `aria-label` is emitted — the consumer should supply a
     * visible label or set this input.
     */
    readonly ariaLabel: _angular_core.InputSignal<string | null>;
    protected readonly resolvedAriaLabel: _angular_core.Signal<string | null>;
    protected readonly isDisabled: _angular_core.Signal<boolean>;
    constructor();
    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ForPaginationPrevious, never>;
    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<ForPaginationPrevious, "[forPaginationPrevious]", ["forPaginationPrevious"], { "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
}

/**
 * Next-page button. Apply on a `<button>` so Enter/Space activation is
 * native. Disabled (via the native `disabled` attribute) when the current page
 * is the last page or the root is disabled. Clicking calls `ctx.next()`.
 */
declare class ForPaginationNext {
    protected readonly buttonType: _angular_core.Signal<string | null>;
    protected readonly ctx: forty_cdk_pagination.ForPaginationContext;
    /**
     * Accessible label for this button (e.g. "Next page"). When `null`
     * (default), no `aria-label` is emitted — the consumer should supply a
     * visible label or set this input.
     */
    readonly ariaLabel: _angular_core.InputSignal<string | null>;
    protected readonly resolvedAriaLabel: _angular_core.Signal<string | null>;
    protected readonly isDisabled: _angular_core.Signal<boolean>;
    constructor();
    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ForPaginationNext, never>;
    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<ForPaginationNext, "[forPaginationNext]", ["forPaginationNext"], { "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
}

/**
 * Defaults inherited by descendant paginations in the surrounding injector
 * scope. Configure with `provideForPaginationDefaults` at the application root
 * or in any component's `providers`; partial overrides merge with the parent.
 */
interface ForPaginationDefaults {
    /** Pages shown on each side of the current page before collapsing to an ellipsis. */
    siblingCount: number;
    /** Pages always shown at each end (first/last). */
    boundaryCount: number;
}
/** Token holding the resolved pagination defaults for the current scope. */
declare const FOR_PAGINATION_DEFAULTS: _angular_core.InjectionToken<ForPaginationDefaults>;
/**
 * Configures forty-cdk pagination defaults for this injector scope. Partial
 * overrides inherit unspecified keys from the parent scope (or library defaults
 * at the root).
 */
declare function provideForPaginationDefaults(defaults?: Partial<ForPaginationDefaults>): Provider[];

export { FOR_PAGINATION_CONTEXT, FOR_PAGINATION_DEFAULTS, ForPagination, ForPaginationItem, ForPaginationNext, ForPaginationPrevious, provideForPaginationDefaults };
export type { ForPaginationContext, ForPaginationDefaults, PaginationItem };