import z, { ZodObject, ZodType } from 'zod';
import { ContentType, ResponseConfig } from '../types';
export declare const spec: {
    /**
     * Shortcut to define a file input schema within a ZodObject body.
     * Automatically sets the correct OpenAPI `type` and `format` for file uploads.
     *
     * @param name - Optional name for the file (used for internal identification)
     * @returns A Zod schema representing a binary file field
     */
    readonly file: (name?: string) => z.ZodFile;
    /**
     * Generates a Invalid response spec with `validate()` structure
     */
    readonly invalid: (schema?: ZodObject) => ResponseConfig;
    /**
     * Generates simple Exception response spec
     */
    readonly exception: (status: number) => ResponseConfig;
    /**
     * Helper to define an OpenAPI-compatible response schema.
     *
     * This function simplifies attaching status codes, content type, and schema definitions
     * for OpenAPI route documentation.
     *
     * @param status - HTTP status code (e.g., 200) or 'default'
     * @param schema - The Zod schema representing the response body
     * @param type - Optional content type (defaults to 'application/json')
     * @returns A typed response config for OpenAPI documentation
     */
    readonly response: (status: number | "default", schema: ZodType, type?: ContentType) => ResponseConfig;
};