/**
 * LAFS-compliant pagination utility for list commands.
 *
 * Wraps result arrays in LAFSPage offset pagination objects.
 * Supports both offset-based and cursor-based pagination modes.
 *
 * @task T4668
 * @epic T4663
 */
import type { LAFSPage } from '@cleocode/lafs';
/**
 * Input parameters for paginating a result set.
 *
 * @task T4668
 * @epic T4663
 */
export interface PaginateInput {
    /** Total number of items before pagination. */
    total: number;
    /** Number of items to return per page. */
    limit?: number;
    /** Number of items to skip. */
    offset?: number;
}
/**
 * Create an LAFSPage object from pagination parameters.
 *
 * Returns mode:"none" when no pagination is requested (no limit/offset).
 * Returns mode:"offset" with hasMore/total when pagination is active.
 *
 * @task T4668
 * @epic T4663
 */
export declare function createPage(input: PaginateInput): LAFSPage;
/**
 * Apply pagination to an array of items and return the sliced result with page metadata.
 *
 * @task T4668
 * @epic T4663
 */
export declare function paginate<T>(items: T[] | undefined | null, limit?: number, offset?: number): {
    items: T[];
    page: LAFSPage;
};
//# sourceMappingURL=pagination.d.ts.map