import type { VersionGuardConfig } from './types';
/**
 * Returns a deep-cloned copy of the built-in VersionGuard configuration.
 *
 * @public
 * @since 0.1.0
 * @remarks
 * A fresh clone is returned so callers can safely modify the result without
 * mutating shared defaults.
 *
 * @returns The default VersionGuard configuration.
 * @example
 * ```ts
 * import { getDefaultConfig } from 'versionguard';
 *
 * const config = getDefaultConfig();
 * ```
 */
export declare function getDefaultConfig(): VersionGuardConfig;
/**
 * Finds the first supported VersionGuard config file in a directory.
 *
 * @public
 * @since 0.1.0
 * @remarks
 * Search order follows `CONFIG_FILE_NAMES`, so `.versionguard.yml` takes
 * precedence over the other supported filenames.
 *
 * @param cwd - Directory to search.
 * @returns The resolved config path, or `null` when no config file exists.
 * @example
 * ```ts
 * import { findConfig } from 'versionguard';
 *
 * const configPath = findConfig(process.cwd());
 * ```
 */
export declare function findConfig(cwd?: string): string | null;
/**
 * Loads a VersionGuard config file from disk.
 *
 * @public
 * @since 0.1.0
 * @remarks
 * The parsed YAML object is merged with the built-in defaults so omitted keys
 * inherit their default values.
 *
 * @param configPath - Path to the YAML config file.
 * @returns The merged VersionGuard configuration.
 * @example
 * ```ts
 * import { loadConfig } from 'versionguard';
 *
 * const config = loadConfig('.versionguard.yml');
 * ```
 */
export declare function loadConfig(configPath: string): VersionGuardConfig;
/**
 * Resolves the active VersionGuard configuration for a project.
 *
 * @public
 * @since 0.1.0
 * @remarks
 * If no config file is present, this falls back to the built-in defaults.
 *
 * @param cwd - Project directory to inspect.
 * @returns The resolved VersionGuard configuration.
 * @example
 * ```ts
 * import { getConfig } from 'versionguard';
 *
 * const config = getConfig(process.cwd());
 * ```
 */
export declare function getConfig(cwd?: string): VersionGuardConfig;
/**
 * Initializes a new VersionGuard config file in a project.
 *
 * @public
 * @since 0.1.0
 * @remarks
 * This writes `.versionguard.yml` using the bundled example when available,
 * otherwise it writes a generated default configuration.
 *
 * @param cwd - Project directory where the config should be created.
 * @returns The path to the created config file.
 * @example
 * ```ts
 * import { initConfig } from 'versionguard';
 *
 * const configPath = initConfig(process.cwd());
 * ```
 */
export declare function initConfig(cwd?: string): string;
//# sourceMappingURL=config.d.ts.map