import type { ArangoVectorSimilarityMetric, VectorIndexSlot } from './vector-index-definition.js';
export declare function mapMetricForArango(metric: string): ArangoVectorSimilarityMetric;
/**
 * Computes the recommended nLists value based on the document count.
 * Formula: max(1, min(N, round(15 * sqrt(N))))
 */
export declare function computeAutoNLists(docCount: number): number;
/**
 * Returns the ArangoDB index name for a vector index using the A/B slot naming scheme.
 */
export declare function vectorIndexSlotName(fieldName: string, slot: VectorIndexSlot): string;
/**
 * Returns the other slot for A/B naming.
 */
export declare function otherVectorIndexSlot(slot: VectorIndexSlot): VectorIndexSlot;
/**
 * Determines the slot of an existing vector index by its name.
 * Returns undefined if the name does not match the expected pattern.
 */
export declare function getVectorIndexSlot(indexName: string): VectorIndexSlot | undefined;
/**
 * Checks whether the nLists drift between an existing and a new value exceeds the given threshold.
 * The threshold is a fraction (e.g. 0.25 for 25%).
 */
export declare function nListsDriftExceedsThreshold(existingNLists: number, newNLists: number, threshold: number): boolean;