import{nothing,type PropertyValues,type TemplateResult}from'lit';import{LyraElement}from'../../../internal/lyra-element.js';import type{LyraAppearance,LyraSize}from'../../../internal/variants.js';
/** `standard` renders the numbered page list; `compact` collapses it to the page-jump field. */
export type LyraPaginationFormat='standard'|'compact';export interface LyraPaginationChangeDetail{readonly page:number;readonly pageSize:number;}export interface LyraPaginationEventMap{'lr-before-page-change':CustomEvent<LyraPaginationChangeDetail>;'lr-page-change':CustomEvent<LyraPaginationChangeDetail>;'lr-activate':CustomEvent<{value:number;}>;blur:FocusEvent;focus:FocusEvent;}
/**
* `<lr-pagination>` — controlled, server-friendly page navigation: a numbered
* page list with elided gaps, optional first/last controls, an optional
* item-range summary, and a compact layout that swaps the list for an
* editable page jump.
*
* The component never mutates `page`. Button and compact-field activation emits
* `lr-page-change`; link-mode anchors navigate without either page-change event. The consumer
* applies a button/field request after its own routing or data-fetch decision. Once the `page` property changes, a polite
* live region announces the applied page and focus follows the newly current
* page control (or the compact page field).
* Public `focus()`, `blur()`, and `click()` resolve the primary control for the active format:
* the applied page control in standard format, or the page-jump input in compact format.
*
* `total="-1"` enters indeterminate mode for a server API that never returns a total (limit/offset
* and cursor/keyset APIs typically don't) -- it renders previous/next plus a page-number field, no
* numbered page list, no item-range summary, and no `page-count`. `format`, `with-summary`, and
* `with-edges` are ignored in this mode: there is no total to lay a page list or a "last page"
* button against. `hasNext` (default `true`) is the one extra signal the mode needs -- previous
* availability stays derivable from `page` alone, but forward availability generally is not for a
* caller with no total. Any OTHER negative `total` (e.g. a computed `-50`) still renders the
* ordinary empty state, exactly like today: only the exact `-1` sentinel opts in, so a garbage or
* miscalculated negative value never silently reclassifies into a different rendering mode. Picked
* over a pair of `has-next`/`has-previous` booleans as the sole entry point because `total` is the
* one property every consumer already sets, and it mirrors `<lr-table>`'s own established
* negative-sentinel `total-items` precedent (see that property's own doc for why the two sentinels
* are kept numerically distinct). Event, focus-management, and announcement contracts are
* unchanged: `lr-before-page-change`/`lr-page-change`/`lr-activate` fire the same way, and the
* applied-page announcement/focus-follow both still run, just against a page-only message with no
* total-pages figure.
*
* @customElement lr-pagination
* @event lr-before-page-change - Fired before a valid button or compact-field page request.
*   `detail: { page, pageSize }`. Cancelable; vetoing it suppresses `lr-page-change`. Link-mode
*   anchors navigate without emitting.
* @event lr-page-change - Fired when a button or compact field requests a valid page.
*   `detail: { page, pageSize }`. The component remains controlled and never mutates `page`
*   itself; link-mode anchors navigate without emitting.
* @event lr-activate - Fired on every accepted page request, whether or not the page actually
*   moved. `detail: { value }` carries the requested page number. Bubbling and composed, so a host
*   outside the shadow tree receives it. Not cancelable: `lr-before-page-change` is this
*   component's veto point, and a vetoed request emits no activation at all. Re-requesting the
*   current page is the case `lr-page-change` deliberately stays silent for -- "load that page
*   again" is a real intent, and it is otherwise unobservable, because the page buttons and the
*   jump input live in this shadow root, so a retargeted `click` names no page and pressing Enter
*   on the jump field produces no click. When a request does move the page,
*   `lr-before-page-change` and `lr-page-change` are emitted first. Link-mode anchors navigate
*   without emitting.
* @slot first-icon - Replacement for the first-page icon.
* @slot previous-icon - Replacement for the previous-page icon.
* @slot next-icon - Replacement for the next-page icon.
* @slot last-icon - Replacement for the last-page icon.
* @event {FocusEvent} blur - Re-dispatched from an internal pagination control as one bubbling,
*   composed native `FocusEvent`, preserving its focus payload.
* @event {FocusEvent} focus - Re-dispatched from an internal pagination control as one bubbling,
*   composed native `FocusEvent`, preserving its focus payload.
* @csspart base - Compatibility name for the navigation wrapper; use `pagination`.
* @csspart pagination - The navigation wrapper. It is the same node as `base`.
* @csspart summary - The item-range summary.
* @csspart controls - The previous/pages/next control group.
* @csspart pages - The `role="list"` wrapper around the numbered page items.
* @csspart page - One numbered page control; a `<button>`, or an `<a>` when `href-template` is set.
* @csspart page-current - Also carried by the page control for the applied page, alongside `page`.
* @csspart button - Shared part on every page, ellipsis, and navigation control.
* @csspart ellipsis - An interactive control that jumps across a skipped run of pages.
* @csspart first-button - The first-page button, rendered with `with-edges`.
* @csspart first-icon - The first-page directional icon.
* @csspart previous-button - The previous-page button.
* @csspart previous-icon - The previous-page directional icon.
* @csspart page-field - The current-page input and page-count wrapper (`format="compact"`).
* @csspart label - Upstream alias on the same compact wrapper as `page-field`.
* @csspart page-input - The validated numeric page-jump input (`format="compact"`).
* @csspart page-count - The total page count shown after the input (`format="compact"`).
* @csspart next-button - The next-page button.
* @csspart next-icon - The next-page directional icon.
* @csspart last-button - The last-page button, rendered with `with-edges`.
* @csspart last-icon - The last-page directional icon.
* @csspart live-region - The visually hidden, `aria-hidden` mirror of the applied-page
* announcement. The announcement itself lands in the shared light-DOM polite region
* (`acquireAnnouncementSink()` in `internal/announcer.ts`), because a live region inside a shadow
* root is not reliably announced; this part is a styling/inspection surface only.
* @cssstate disabled - Applied when the public `disabled` property is true.
* @cssprop --lr-pagination-control-size - Control inline/block size; defaults from the `size` variant.
* @cssprop --lr-pagination-font-size - Control font size; defaults from the `size` variant.
* @cssprop --lr-pagination-control-bg - Resting background of every control; defaults from the
*   `appearance` variant.
* @cssprop --lr-pagination-control-border-color - Resting border color of every control; defaults
*   from the `appearance` variant.
* @cssprop [--lr-pagination-control-color=var(--lr-color-text)] - Resting control foreground.
* @cssprop [--lr-pagination-current-bg=var(--lr-color-brand)] - Current-page background.
* @cssprop [--lr-pagination-current-border-color=transparent] - Current-page border color.
* @cssprop [--lr-pagination-current-color=var(--lr-color-on-brand)] - Current-page foreground.
* @cssprop [--lr-pagination-hover-bg=var(--lr-color-brand-quiet)] - Ordinary control hover background.
* @cssprop [--lr-pagination-hover-border-color=var(--lr-color-brand)] - Ordinary control hover border color.
* @cssprop --lr-pagination-active-bg - Ordinary control pressed background; defaults to the
*   current quiet-brand active mix.
* @cssprop [--lr-pagination-active-border-color=var(--lr-color-brand)] - Ordinary control pressed border color.
* @cssprop [--lr-pagination-current-hover-bg=var(--lr-color-brand)] - Current-page hover background.
* @cssprop [--lr-pagination-current-hover-border-color=transparent] - Current-page hover border color.
* @cssprop --lr-pagination-current-active-bg - Current-page pressed background; defaults to the
*   current brand active mix.
* @cssprop [--lr-pagination-current-active-border-color=transparent] - Current-page pressed border color.
* @cssprop [--lr-pagination-control-radius=var(--lr-radius)] - Border radius of navigation
* buttons and the page input.
* @cssprop [--lr-pagination-control-padding=var(--lr-space-xs)] - Inner padding of the nav buttons
* and the page input. Uniform across every `size` (the control footprint is fixed by
* `--lr-pagination-control-size`, so this only adjusts the icon/digit inset).
* @cssprop [--lr-pagination-base-gap=var(--lr-space-m)] - Gap between the summary and controls.
* @cssprop [--lr-pagination-controls-gap=var(--lr-space-xs)] - Gap between the navigation controls
*   and the numbered-page list or compact page field.
* @cssprop [--lr-pagination-pages-gap=var(--lr-space-xs)] - Gap between numbered page controls.
* @cssprop [--lr-pagination-invalid-border=var(--lr-color-danger)] - Border color of
*   `[part="page-input"]` while the typed page is out of range (`aria-invalid="true"`).
* @status stable
* @since 4.0.0
*/
export declare class LyraPagination extends LyraElement<LyraPaginationEventMap>{static styles:import("lit").CSSResultGroup[];
/** The currently applied page. Controlled; this component never mutates it. */
page:number;
/** Number of items represented by one page. Non-positive values produce no pages. */
pageSize:number;
/** Total number of items across every page. Non-positive values render the empty state, with one
*  exact exception: `-1` enters indeterminate mode instead (see the class doc) -- every other
*  negative value, including one arrived at by a miscalculation, still renders the ordinary empty
*  state. Named `total` to match `wa-pagination`; it used to be `total-items`, which a mechanical
*  rename left unset — silently rendering the empty state. */
total:number;
/** Whether at least one more page exists past the current one. Consulted only in indeterminate
*  mode (`total="-1"`, see the class doc) -- previous availability is always derivable from
*  `page`, but forward availability generally is not for a caller with no total. Defaults to
*  `true` so an indeterminate pager stays navigable until told otherwise. */
hasNext:boolean;disabled:boolean;
/** Disables navigation and exposes `aria-busy="true"` while a page is loading. */
loading:boolean;
/** Renders the localized "showing X–Y of Z" summary row. Opt-in and `false` by default,
*  matching `wa-pagination`. It used to be `hide-summary`, an opt-*out* whose default showed the
*  summary, so a mechanical rename silently added a row to every migrated pager. */
withSummary:boolean;
/** Control footprint, on the library-wide six-step ladder. Web Awesome's and Shoelace's
*  `small`/`medium`/`large` spellings are accepted as exact synonyms of `s`/`m`/`l`, so
*  migrating from either is a tag rename with no attribute rewrite. */
size:LyraSize;private _format;
/** `standard` renders the numbered page list; `compact` swaps it for the editable page jump,
*  which fits a toolbar or a card footer where a full list would not. Unknown runtime values
*  normalize to `standard`. */
get format():LyraPaginationFormat;set format(value:LyraPaginationFormat);
/** Pages shown either side of the current page in the numbered list. */
siblingCount:number;
/** Pages always pinned at the start and at the end of the numbered list. */
boundaryCount:number;
/** Renders buttons that jump straight to the first and last page. */
withEdges:boolean;
/** Hides the previous and next controls while retaining pages and optional edge controls. */
withoutNav:boolean;
/** Renders nothing when zero or one page exists. */
hideSinglePage:boolean;
/** Renders each page as a link instead of a button, for SSR, crawlers, and no-JS navigation.
*  A string uses `{page}` as the placeholder (`/products?page={page}`); a function receives the
*  page number and returns the URL. A page whose resolved URL is not a safe navigation target
*  falls back to a button. */
hrefTemplate:string|((page:number)=>string);
/** Resting look of every control. The applied page stays a solid brand chip in all of them, so
*  it is never the appearance that decides whether the current page is identifiable. */
appearance:LyraAppearance;
/** Optional item noun used in the summary. Empty uses the localized `item`/`items` keys. */
itemLabel:string;
/** Accessible name forwarded from the host to the internal navigation landmark. */
accessibleLabel:string|null;
/** Accessible-name override for the internal navigation landmark, applied when no host
*  `aria-label` is set. Optional. Omitting it localizes the default `paginationLabel` message;
*  an explicit empty string renders no visible/accessible label. */
label?:string;
/** Optional control-label overrides. Omission localizes the matching message key; supplied
* strings, including the built-in English text or an empty string, render verbatim. */
pageLabel?:string;previousLabel?:string;nextLabel?:string;firstLabel?:string;lastLabel?:string;private draftPage;private invalidDraft;private liveText;private pageInput?;private readonly internals;private initialized;
/** Handle on the shared light-DOM live region page changes actually announce through -- a region
*  rendered inside this shadow root is not reliably announced (JAWS with Firefox ignores one
*  outright), so `[part="live-region"]` is only an `aria-hidden` mirror. */
private sink?;private pendingFocusPage?;private pendingFocusOrigin;private clearPendingFocus;private focusTargetIsInside;connectedCallback():void;disconnectedCallback():void;
/** The primary page control for the active format. Indeterminate mode always renders the
*  page-jump field (see `render()`), regardless of `format`. */
private get primaryControl();
/** Focus the current-page button/link, or the editable page-jump input in compact format. */
focus(options?:FocusOptions):void;
/** Blur the primary page control for the active format. */
blur():void;
/** Forward host activation to the primary page control for the active format. */
click():void;
/** Read-time-safe view of `total` -- non-negative, finite, truncated to a whole item count. */
private get normalizedTotalItems();
/** Read-time-safe view of `pageSize` -- non-negative, finite, truncated to a whole item count. */
private get normalizedPageSize();
/** Private total-page calculation used by rendering and navigation. */
private get calculatedTotalPages();
/** The total number of pages, derived from `total` and `pageSize`. Always `0` in indeterminate
*  mode -- there is no total to derive a page count from. */
get totalPages():number;
/** `total === -1` exactly (see the class doc and `total`'s own doc) -- the one sentinel that
*  enters indeterminate mode. Any other negative `total` still renders the ordinary empty state. */
private get indeterminate();
/** True whenever the control has a page to show at all -- either a real derived page count, or
*  indeterminate mode, which always has "a" current page even though it has no total. Replaces a
*  bare `calculatedTotalPages === 0` empty-state check everywhere indeterminate mode also counts
*  as non-empty. */
private get hasPages();
/** The highest page a request may target: unbounded (subject to `hasNext`, checked separately)
*  in indeterminate mode, the derived page count otherwise. */
private get maxRequestablePage();
/** Read-time-safe view of the controlled `page` property, clamped to `[1, totalPages]` (the
*  page count itself depending on the now-safe `total`/`pageSize` above) -- never mutates
*  `page` itself, matching this component's fully controlled contract. Indeterminate mode has no
*  upper bound to clamp against, only a floor of `1`. */
private get currentPage();private get controlsDisabled();
/** Read-time-safe view of `siblingCount`, clamped so the rendered list stays bounded. */
private get normalizedSiblingCount();
/** Read-time-safe view of `boundaryCount`, clamped so the rendered list stays bounded. */
private get normalizedBoundaryCount();
/** The URL this page would navigate to, or `null` when there is no template or the resolved URL
*  is not a safe navigation target (a `javascript:`/`data:` template fails closed to a button
*  rather than shipping the scheme into an anchor). */
private pageHref;private get hasHrefTemplate();
/** Resolve a URL only for a control that can navigate. Configured link mode keeps inactive
* controls as anchors without invoking a consumer callback or exposing an `href`. */
private pageLink;private localizedProperty;private formatNumber;private summaryText;protected willUpdate(changed:PropertyValues):void;protected updated(changed:PropertyValues):void;private validRequestedPage;private requestPage;private onPageInput;private commitPage;private onPageKeyDown;private onControlFocus;private onControlBlur;
/** Previous/next. Both directions share one shape so the two never drift apart. */
private renderNavButton;
/** First/last. The doubled chevron is the conventional "all the way to the end" glyph, and it
*  mirrors under RTL through the wrapping part rather than the icon itself. */
private renderEdgeButton;
/** One numbered page. The visible number is its accessible name -- an extra `aria-label` would
*  only make a screen reader announce the same digit twice. */
private renderPage;
/** One skipped range. Its target lands several pages toward that side while remaining inside
* the omitted range, so repeated activation makes steady progress without duplicating a visible
* page button. */
private renderEllipsis;private renderPageList;private renderPageField;render():TemplateResult|typeof nothing;}declare global{interface HTMLElementTagNameMap{'lr-pagination':LyraPagination;}}