import * as vscode from 'vscode';
/**
 * Utility class for finding the docs directory across multiple workspace folders
 * and parent directories. Ensures deterministic behavior by sorting workspace folders.
 */
export declare class DocsPathResolver {
    /**
     * Finds the docs directory by searching all workspace folders and optionally
     * parent directories. Returns the first found docs directory or null.
     *
     * @param workspaceFolders Array of workspace folders (can be empty)
     * @param searchParentDirectories Whether to search in parent directories if not found in workspace folders
     * @param maxParentDepth Maximum depth to search in parent directories (default: 5)
     * @returns The path to the docs directory or null if not found
     */
    static findDocsDirectory(workspaceFolders: readonly vscode.WorkspaceFolder[] | undefined, searchParentDirectories?: boolean, maxParentDepth?: number): string | null;
    /**
     * Checks if a docs directory exists in the given directory.
     *
     * @param dir The directory to check
     * @returns The path to the docs directory if it exists, null otherwise
     */
    static findDocsInDirectory(dir: string): string | null;
    /**
     * Searches for a docs directory in parent directories, starting from the given directory.
     * Stops when maxDepth is reached or when the root directory is reached.
     *
     * @param startDir The directory to start searching from
     * @param maxDepth Maximum number of parent levels to search (default: 5)
     * @returns The path to the docs directory if found, null otherwise
     */
    static findDocsInParentDirectories(startDir: string, maxDepth?: number): string | null;
    /**
     * Finds the docs directory from a given path (for CLI usage).
     * Searches in the directory and parent directories.
     *
     * @param startPath The path to start searching from
     * @param maxDepth Maximum number of parent levels to search (default: 5)
     * @returns The path to the docs directory if found, null otherwise
     */
    static findDocsDirectoryFromPath(startPath: string, maxDepth?: number): string | null;
}
//# sourceMappingURL=docs-path-resolver.d.ts.map