import type { PathMapper } from "../types.js";
/**
 * Expand ~ shortcut to the provided home directory.
 */
export declare function expandHome(targetPath: string, homeDir: string): string;
/**
 * Validate that a path is home-relative (starts with ~).
 * Throws if the path is not home-relative.
 */
export declare function validateHomePath(targetPath: string): void;
/**
 * Resolve a path with optional path mapping for isolated configurations.
 * 1. Validates the path starts with ~
 * 2. Expands ~ to home directory
 * 3. If pathMapper is provided, maps the directory portion and reconstructs the path
 */
export declare function resolvePath(rawPath: string, homeDir: string, pathMapper?: PathMapper): string;