import type { PlatformPaths } from './types.js';
/**
 * Ensures that a directory exists on disk.
 *
 * If the directory does not already exist, it will be created recursively.
 * Throws an error if the directory cannot be created.
 *
 * @param dir - The absolute path of the directory to ensure exists.
 * @throws Error if directory creation fails due to filesystem errors.
 */
export declare function ensureDir(dir: string): void;
/**
 * Resolves the appropriate configuration directory path for the current operating system.
 *
 * Accepts an object mapping platform identifiers (`darwin`, `win32`, `linux`) to path templates.
 * On Windows, replaces `{APPDATA}` placeholders with the actual APPDATA environment variable.
 *
 * @param paths - An object containing platform-specific path templates.
 * @returns The resolved configuration path for the current platform.
 * @throws Error if the platform is unsupported or required environment variables are missing.
 */
export declare function getPlatformPath(paths: PlatformPaths): string;