/** Normalized pagination parameters read from a query string. */
export interface PageParams {
    /** 1-based page number; clamped to `>= 1`. */
    page: number;
    /** Items per page; clamped to `[1, maxLimit]`. */
    limit: number;
    /** Zero-based offset (`(page - 1) * limit`), for slicing or SQL `OFFSET`. */
    offset: number;
}
/** Options for {@link pageParams}. */
export interface PageOptions {
    /** Items per page when `limit` is absent. Default 20. */
    defaultLimit?: number;
    /** Upper bound on `limit`, so a client can't request an unbounded page. Default 100. */
    maxLimit?: number;
}
/**
 * Read `?page` (1-based) and `?limit` from a query string into normalized,
 * clamped {@link PageParams}. Invalid or missing values fall back to the
 * defaults; `limit` is clamped to `[1, maxLimit]` and `page` to `>= 1`.
 *
 * ```ts
 * @get('/') list(ctx) {
 *   const p = pageParams(ctx.query)
 *   const [rows, total] = repo.page(p.offset, p.limit)
 *   return paginated(rows, total, p)
 * }
 * ```
 *
 * @param query - The request query string to read `page` and `limit` from.
 * @param options - Default and maximum page size.
 * @returns Normalized, clamped pagination parameters.
 */
export declare function pageParams(query: URLSearchParams, options?: PageOptions): PageParams;
/** A page of results in a standard envelope. */
export interface Page<T> {
    /** The items on this page. */
    data: T[];
    /** 1-based page number. */
    page: number;
    /** Items per page. */
    limit: number;
    /** Total number of items across all pages. */
    total: number;
    /** Total number of pages (`ceil(total / limit)`, at least 1). */
    totalPages: number;
}
/**
 * Wrap a page of `data` (and the overall `total`) in a standard {@link Page}
 * envelope with the page number, limit, total count, and derived page count.
 *
 * @typeParam T - The item type carried on the page.
 * @param data - The items on the current page.
 * @param total - Total number of items across all pages.
 * @param params - The pagination parameters this page was fetched with.
 * @returns The items wrapped in a standard {@link Page} envelope.
 */
export declare function paginated<T>(data: T[], total: number, params: PageParams): Page<T>;
//# sourceMappingURL=pagination.d.ts.map