import type { CslItem } from "../../core/csl-json/types.js";
import type { ILibrary } from "../../core/library-interface.js";
/**
 * Options for addReference operation.
 */
export interface AddReferenceOptions {
    /** The CSL item to add. */
    item: CslItem;
}
/**
 * Result of addReference operation.
 *
 * Note: this helper throws on failure, so there is no success/failure flag
 * on the result. Compare with UpdateResult.updated / RemoveResult.removed,
 * which report miss-by-identifier outcomes — an API that add() does not
 * have.
 */
export interface AddReferenceResult {
    /** The item returned by the library (with generated ID/UUID as needed). */
    item: CslItem;
}
/**
 * Add a reference to the library and persist the change to disk.
 *
 * Mirrors the shape of updateReference/removeReference by bundling the
 * library mutation together with the save(), so callers (e.g. server
 * routes) cannot accidentally skip persistence.
 */
export declare function addReference(library: ILibrary, options: AddReferenceOptions): Promise<AddReferenceResult>;
//# sourceMappingURL=add-reference.d.ts.map