/**
 * Shared reference selection utility for interactive ID selection.
 *
 * This module provides a reusable function to select references interactively
 * using the existing search prompt infrastructure.
 */
import type { CslItem } from "../../core/csl-json/types.js";
import { type SearchPromptConfig } from "./search-prompt.js";
/**
 * Options for reference selection
 */
export interface ReferenceSelectOptions {
    /** Whether to allow multiple selection (default: true) */
    multiSelect: boolean;
    /** Custom prompt message */
    prompt?: string;
    /** Initial search query */
    initialQuery?: string;
}
/**
 * Result from reference selection
 */
export interface ReferenceSelectResult {
    /** Selected references */
    selected: CslItem[];
    /** Whether the selection was cancelled */
    cancelled: boolean;
}
/**
 * Run interactive reference selection.
 *
 * Launches an interactive search prompt to select references from the library.
 * Supports both single and multiple selection modes.
 *
 * @param allReferences - All references available for selection
 * @param options - Selection options
 * @param config - Interactive prompt configuration
 * @returns Selection result with selected references
 * @throws TTYError if not running in a TTY environment
 */
export declare function runReferenceSelect(allReferences: CslItem[], options: ReferenceSelectOptions, config: SearchPromptConfig): Promise<ReferenceSelectResult>;
/**
 * Options for selectReferencesOrExit helper
 */
export interface SelectReferencesOrExitOptions {
    /** Whether to allow multiple selection */
    multiSelect: boolean;
    /** Initial search query */
    initialQuery?: string;
}
/**
 * Select references interactively or exit if cancelled/empty.
 *
 * This is a convenience wrapper around runReferenceSelect that handles
 * common patterns:
 * - Exits with code 0 if library is empty
 * - Exits with code 0 if selection is cancelled
 * - Returns selected identifiers
 *
 * @param allReferences - All references available for selection
 * @param options - Selection options
 * @param config - Interactive prompt configuration
 * @returns Array of selected reference IDs (never empty)
 */
export declare function selectReferencesOrExit(allReferences: CslItem[], options: SelectReferencesOrExitOptions, config: SearchPromptConfig): Promise<string[]>;
/**
 * Select reference items interactively or exit if cancelled/empty.
 *
 * Similar to selectReferencesOrExit but returns full CslItem objects
 * instead of just identifiers. Useful when the caller needs access to
 * the full reference data (e.g., for confirmation dialogs).
 *
 * @param allReferences - All references available for selection
 * @param options - Selection options
 * @param config - Interactive prompt configuration
 * @returns Array of selected CslItem objects (never empty)
 */
export declare function selectReferenceItemsOrExit(allReferences: CslItem[], options: SelectReferencesOrExitOptions, config: SearchPromptConfig): Promise<CslItem[]>;
//# sourceMappingURL=reference-select.d.ts.map