/**
 * Clone only the docs folder from a GitHub repo using git sparse-checkout.
 * This avoids GitHub API rate limits entirely.
 */
export declare function cloneDocsFolder(tag: string, destDir: string, repoUrl?: string, docsPath?: string): Promise<void>;
/**
 * Recursively collect all .md and .mdx files from a directory.
 */
export declare function collectDocFiles(dir: string, baseDir?: string): {
    relativePath: string;
    title: string;
}[];
/**
 * Build a hierarchical structure from the flat file list.
 */
export interface DocSection {
    name: string;
    title: string;
    files: {
        relativePath: string;
        localPath: string;
        title: string;
    }[];
    subsections: DocSection[];
}
export declare function buildDocTree(files: {
    relativePath: string;
    title: string;
}[]): DocSection[];