/**
 * Path Validation Utility
 *
 * Provides secure path validation to prevent:
 * - Path traversal attacks (../)
 * - Symlink-based traversal
 * - Access outside allowed directories
 *
 * Based on text-editor.ts implementation, extracted for reuse across tools.
 */
export interface PathValidationResult {
    valid: boolean;
    resolved: string;
    error?: string;
}
export interface PathValidatorOptions {
    /** Base directory for path validation (default: cwd) */
    baseDirectory?: string;
    /** Allow paths outside base directory (default: false) */
    allowOutsideBase?: boolean;
    /** Follow symlinks for validation (default: true) */
    checkSymlinks?: boolean;
    /** Additional allowed directories outside base */
    additionalAllowedPaths?: string[];
}
/**
 * Path Validator class for secure file operations
 */
export declare class PathValidator {
    private baseDirectory;
    private allowOutsideBase;
    private checkSymlinks;
    private additionalAllowedPaths;
    constructor(options?: PathValidatorOptions);
    /**
     * Set the base directory for path validation
     */
    setBaseDirectory(dir: string): void;
    /**
     * Get the current base directory
     */
    getBaseDirectory(): string;
    /**
     * Validate a file path for security
     */
    validate(filePath: string): PathValidationResult;
    /**
     * Validate multiple paths
     */
    validateMany(filePaths: string[]): {
        valid: boolean;
        results: Map<string, PathValidationResult>;
        errors: string[];
    };
    /**
     * Check if a path is safe (returns boolean only)
     */
    isSafe(filePath: string): boolean;
    /**
     * Resolve a path and throw if invalid
     */
    resolveOrThrow(filePath: string): string;
}
/**
 * Get the default path validator (lazily initialized)
 */
export declare function getPathValidator(): PathValidator;
/**
 * Initialize the default path validator with custom options
 */
export declare function initializePathValidator(options: PathValidatorOptions): PathValidator;
/**
 * Convenience function to validate a path using the default validator
 */
export declare function validatePath(filePath: string): PathValidationResult;
/**
 * Convenience function to check if a path is safe
 */
export declare function isPathSafe(filePath: string): boolean;
declare const _default: {
    PathValidator: typeof PathValidator;
    getPathValidator: typeof getPathValidator;
    initializePathValidator: typeof initializePathValidator;
    validatePath: typeof validatePath;
    isPathSafe: typeof isPathSafe;
};
export default _default;
