import type { SdocsConfig, ResolvedSdocsConfig } from '../types.js';
/** Find the config file path in the given directory */
export declare function findConfigFile(root: string): string | null;
/** Load the raw config from file (unresolved) */
export declare function loadRawConfig(root: string): Promise<SdocsConfig>;
/** Load and resolve the sdocs config with defaults */
export declare function loadConfig(root: string): Promise<ResolvedSdocsConfig>;
/** Resolve config and finalize paths. Accepts an already-resolved config
 * too — resolution is idempotent, every field passes through unchanged. */
export declare function resolveAndFinalize(userConfig: SdocsConfig | ResolvedSdocsConfig, root: string): ResolvedSdocsConfig;
/** A config that could not be read, reported by path rather than by stack. */
export declare class ConfigError extends Error {
    readonly configPath: string;
    constructor(message: string, configPath: string);
}
/** A public base path always has a leading and trailing slash: '/my-project/'. */
export declare function normalizeBase(base: string | undefined): string;
/** Merge user config with defaults */
export declare function resolveConfig(userConfig: SdocsConfig | ResolvedSdocsConfig): ResolvedSdocsConfig;