/**
 * Path Validation Utilities
 *
 * Provides utilities for validating file paths, resolving relative paths,
 * and ensuring security constraints for the file linking functionality.
 */
export interface PathValidationResult {
    isValid: boolean;
    resolvedPath?: string;
    error?: string;
}
export declare class PathValidationUtils {
    /**
     * Validate if a string is a known template name
     */
    static isTemplateName(value: string, availableTemplates: string[]): boolean;
    /**
     * Validate and resolve a file path
     */
    static validateFilePath(filePath: string, projectPath: string): Promise<PathValidationResult>;
    /**
     * Validate and resolve a file or directory path
     */
    static validateFileOrDirectoryPath(filePath: string, projectPath: string): Promise<PathValidationResult>;
    /**
     * Resolve a file path to absolute, handling various formats
     */
    static resolvePath(filePath: string, projectPath: string): string;
    /**
     * Check if a resolved path is within safe boundaries
     * Prevents directory traversal attacks
     */
    static isPathSafe(resolvedPath: string, projectPath: string): boolean;
    /**
     * Validate parameter as either template name or file path
     */
    static validateParameter(value: string, availableTemplates: string[], projectPath: string): Promise<{
        isTemplate: boolean;
        isFilePath: boolean;
        resolvedPath?: string;
        error?: string;
    }>;
    /**
     * Get common file patterns for documentation
     */
    static getCommonDocumentationPatterns(): {
        architecture: string[];
        requirements: string[];
        design: string[];
    };
}
