import { GeneratedArtifacts } from "../lib/generated-artifacts.js";
import type { RouteArtifact } from "../lib/generated-artifacts.js";
import { OpenApiRegistry } from "../lib/openapi.js";
import type { OperationDescriptor } from "../lib/openapi-types.js";
import type { MDXFile, PageMeta } from "../lib/types.js";
type GeneratePage = (mdxFile: MDXFile, options?: {
    apiOperation?: OperationDescriptor;
}) => Promise<void>;
type RemoveOwnedRoute = (slug: string) => Promise<void>;
type WriteAllowlist = () => Promise<void>;
type CleanupStalePages = (nextRoutes: Map<string, string>, realSlugs: Set<string>) => Promise<void>;
export declare class ApiReferenceGenerator {
    private readonly outputDir;
    private readonly artifacts;
    private pendingStaleRoutes;
    constructor(outputDir: string, artifacts: GeneratedArtifacts);
    mergePages(registry: OpenApiRegistry, realPages: PageMeta[]): PageMeta[];
    writePages(registry: OpenApiRegistry, apiBaseSlug: string, realPages: PageMeta[], generatePage: GeneratePage, writeAllowlist: WriteAllowlist, cleanupStalePages: CleanupStalePages, writtenRoutes?: Map<string, string>): Promise<Map<string, string>>;
    writeAllowlist(registry: OpenApiRegistry): Promise<void>;
    cleanupStalePages(nextRoutes: Map<string, string>, occupiedMdxSlugs: Set<string>, removeOwnedRoute: RemoveOwnedRoute, additionalPreviousRoutes?: Iterable<RouteArtifact>): Promise<void>;
}
export {};