import type { IndexOptions, MetadataEntry, MetadataIndex } from './types.js';
export type BuildResult = {
    index: MetadataIndex;
    outputPath: string;
};
/**
 * Builds the metadata index by scanning the source directory, parsing all files,
 * resolving dependencies, and writing the output.
 */
export declare function buildMetadataIndex(cwd: string, options: IndexOptions, warn?: (msg: string) => void): BuildResult;
/**
 * Loads an existing metadata index from disk.
 */
export declare function loadMetadataIndex(cwd: string): MetadataIndex | null;
/**
 * Queries the dependency graph for a given API name.
 * Returns direct dependencies and dependents.
 */
export declare function queryDependencies(index: MetadataIndex, apiName: string): {
    entry: MetadataEntry | null;
    dependencies: string[];
    dependents: string[];
};
