import { PathItemObject, TagObject } from 'openapi3-ts/oas31';
import { OARoute } from '../types';
/**
 * Transforms an **OARoute** (your internal DSL) into the
 * OpenAPI 3.1 structures required by `openapi3-ts`.
 *
 * Usage:
 * ```ts
 * const adapter = new OperationBuilder(route);
 * const { path, item } = adapter.buildPathItem();
 * ```
 */
export declare class OperationBuilder {
    private readonly route;
    constructor(route: OARoute);
    /** Convert `:id` style params to `{id}` style – OpenAPI friendly. */
    private get openApiPath();
    /** Public entry point – returns the PathItem ready for builder.addPath(). */
    buildPathItem(): {
        path: string;
        item: PathItemObject;
        tags: TagObject[];
    };
    /** Build the `OperationObject` for the current route. */
    private buildOperation;
    /** Translate our auth flags to the proper OpenAPI `security` array. */
    private buildSecurity;
    /** Map body Zod schema (if any) to OpenAPI RequestBodyObject. */
    private buildRequestBody;
    /** Combine params, query and headers into one flat array. */
    private buildParameters;
    private defaultPathParams;
    private buildPathParameterList;
    /** Convert a ZodObject into an array of ParameterObjects. */
    private buildParameterList;
    /** Build the `responses` section, falling back to a “default”. */
    private buildResponses;
    /** Auto-generate a predictable operationId: `getUserById` etc. */
    private generateOperationId;
}