import { OpenApiBuilder } from 'openapi3-ts/oas31';
import type { ZodType } from 'zod';
import type { OARoute, BuildedRoute } from '../types';
/**
 * ---------------------------------------------------------------------------
 * OpenAPI Registry – a singleton façade around `OpenApiBuilder`
 * ---------------------------------------------------------------------------
 *
 * Responsibilities
 *  - Hold a single `OpenApiBuilder` instance.
 *  - Provide convenience helpers for:
 *      - routes      (`addRoute`)
 *      – schemas     (`addSchema`)
 *      – tags        (`addTag`)
 *      – servers     (`addServer`)
 *      – spec output (`getJson`, `getYaml`, `getSpec`)
 *  - Ensure `info` fields fall back to app-level defaults from `config`.
 *
 * Environment overrides:
 *  - OPENAPI_TITLE        default title
 *  - OPENAPI_DESCRIPTION  default description
 *  - VERSION              default version
 */
export declare const openapi: {
    readonly builder: () => OpenApiBuilder;
    readonly addSchema: (name: string, schema: ZodType) => OpenApiBuilder;
    readonly addBuildedRoute: (route: BuildedRoute) => void;
    readonly addRoute: (route: OARoute) => void;
    readonly addServer: (url: string, description?: string) => OpenApiBuilder;
    readonly addTag: (name: string, description?: string) => void;
    readonly getSpec: () => import("openapi3-ts/oas31").OpenAPIObject;
    readonly getJson: () => string;
    readonly getYaml: () => string;
    readonly title: (title: string) => void;
    readonly description: (description: string) => void;
    readonly version: (version: string) => void;
    readonly swagger: (docPath?: string) => string;
    readonly scalar: (docPath?: string) => string;
};