import { type ClaudePluginRoot } from "../discovery/helpers.js";
/** Turns raw file content (from `filePath`) into a config, or `null` to skip the file. */
export type ConfigFileAdapter<T> = (content: string, filePath: string) => T | null;
/** One entry of a config stack; `read` yields `null` for unreadable or rejected files. */
export interface ConfigFileSource<T> {
    read(): T | null;
}
/**
 * Read one JSON/YAML config file through `adapt`. Reading, parsing and rejecting
 * all happen inside one guard so an unreadable, malformed, or irrelevant file is
 * skipped instead of thrown. `adapt` receives the raw content because the YAML/JSON
 * split lives with the config files that consume this walk, not here.
 */
export declare function readConfigFile<T>(filePath: string, adapt: ConfigFileAdapter<T>): T | null;
export interface ConfigFileSourcesOptions<T> {
    /** Extra source emitted right after each plugin root's config files (e.g. its marketplace catalog). */
    pluginRootSource?: (root: ClaudePluginRoot) => ConfigFileSource<T>;
}
/**
 * Config sources for base name `base` — `"lsp"` covers `lsp.json`/`.lsp.json`/`lsp.yaml`/`.lsp.yaml`/
 * `lsp.yml`/`.lsp.yml` — in priority order: cwd files, project config dirs, user config dirs,
 * plugin roots (plus {@link ConfigFileSourcesOptions.pluginRootSource} per root), then home-directory
 * files. Lowest priority comes last, so callers merge over a reversed list.
 */
export declare function configFileSources<T>(base: string, cwd: string, adapt: ConfigFileAdapter<T>, options?: ConfigFileSourcesOptions<T>): ConfigFileSource<T>[];