/**
 * Versioning support for GitHub-based Docusaurus docs.
 *
 * Handles version discovery and path resolution for multi-version
 * documentation hosted on GitHub.
 */
import type { GitHubAPI } from './api.js';
import type { DocusaurusVersioningConfig } from './config.js';
/**
 * Version information.
 */
export interface GitHubVersionInfo {
    /** Version identifier (e.g., "2026.07.01", "next") */
    version: string;
    /** Path to the content for this version */
    contentPath: string;
    /** Whether this is the "next" (unreleased) version */
    isNext: boolean;
    /** Whether this is the current (latest) version */
    isCurrent: boolean;
}
/**
 * Options for version discovery.
 */
export interface DiscoverVersionsOptions {
    /** Version label to use for the main docs path (default: "next") */
    defaultVersion?: string;
    /** Whether this is the latest/current version */
    isLatest?: boolean;
}
/**
 * Discover versions from a GitHub repository.
 *
 * @param api - GitHub API client
 * @param repo - Repository in "owner/repo" format
 * @param ref - Branch, tag, or commit
 * @param docsPath - Path to docs directory
 * @param versioning - Versioning configuration
 * @param options - Additional options
 * @returns Array of version info
 */
export declare function discoverGitHubVersions(api: GitHubAPI, repo: string, ref: string, docsPath: string, versioning?: DocusaurusVersioningConfig, options?: DiscoverVersionsOptions): Promise<GitHubVersionInfo[]>;
/**
 * Get the versioned docs path for a specific version.
 */
export declare function getVersionedDocsPath(versioning: DocusaurusVersioningConfig, version: string): string;
/**
 * Check if a version should use clean URLs (no version in path).
 */
export declare function shouldUseCleanUrl(version: string, versioning?: DocusaurusVersioningConfig): boolean;
//# sourceMappingURL=versioning.d.ts.map