import type { CslItem } from "../../core/csl-json/types.js";
import type { ILibrary } from "../../core/library-interface.js";
import { type PaginationOptions, type SortOptions } from "../pagination/index.js";
/**
 * Options for listReferences operation
 */
export interface ListOptions extends PaginationOptions, SortOptions {
    /**
     * Include references marked as superseded (#108). They are hidden by default: once a
     * successor exists, the old record is noise in a browsing command.
     */
    includeSuperseded?: boolean;
}
/**
 * Result of listReferences operation
 */
export interface ListResult {
    /** Raw CslItem array */
    items: CslItem[];
    /** Total count before pagination */
    total: number;
    /** Applied limit (0 if unlimited) */
    limit: number;
    /** Applied offset */
    offset: number;
    /** Next page offset, null if no more results */
    nextOffset: number | null;
}
/**
 * List all references from the library.
 *
 * @param library - The library to list references from
 * @param options - Pagination and sorting options
 * @returns Raw CslItem[] with pagination metadata
 */
export declare function listReferences(library: ILibrary, options: ListOptions): Promise<ListResult>;
//# sourceMappingURL=list.d.ts.map