/**
 * Async check whether a file exists and is readable.
 */
export declare function fileExists(path: string): Promise<boolean>;
/**
 * Read a JSON file and parse it with an optional type parameter.
 *
 * Throws if the file does not exist or contains invalid JSON.
 */
export declare function readJson<T = unknown>(path: string): Promise<T>;
/**
 * Write data as pretty-printed JSON to the given path.
 *
 * Parent directories are created automatically.
 */
export declare function writeJson(path: string, data: unknown): Promise<void>;
/**
 * Create a directory (and any missing parents) if it does not already exist.
 */
export declare function ensureDir(path: string): Promise<void>;
/**
 * Walk up the directory tree from `startDir` looking for a project root.
 *
 * A directory is considered a project root if it contains
 * `bober.config.json` or `package.json`.
 *
 * @param startDir Starting directory (defaults to `process.cwd()`).
 * @returns Absolute path to the project root, or `null` if none found.
 */
export declare function findProjectRoot(startDir?: string): Promise<string | null>;
//# sourceMappingURL=fs.d.ts.map