import type { Config as ConfigShape } from "./config.js";
/**
 * Creates a new configuration file with sample content
 *
 * @param configPath - Path where the config file should be created
 * @param force - If true, overwrites existing file. If false, fails if file exists.
 * @throws {Error} If the file cannot be created or already exists (when not forcing)
 */
export declare function createSampleConfig(configPath: string, force?: boolean): Promise<void>;
/**
 * Loads and parses a configuration file.
 * Throws specific errors for missing or invalid configuration.
 *
 * @param configPath - Path to the JSON config file. `~` is supported.
 * @throws {ConfigNotFoundError} When the config file doesn't exist
 * @throws {ConfigAccessError} When the config file cannot be accessed (permissions, not a file)
 * @throws {ConfigParseError} When the config file cannot be parsed or is invalid
 */
export declare function loadConfig(configPath: string): Promise<ConfigShape>;