import * as express from 'express';
import { OpenAPIV3 } from 'openapi-types';
export { OpenAPIV3 } from 'openapi-types';

interface DelayRange {
    min: number;
    max: number;
}
interface RuntimeConfig {
    /**
     * Custom field generators (by field name).
     */
    generators?: Record<string, () => unknown>;
    /**
     * Error rate between 0 and 1 for random error responses.
     */
    errorRate?: number;
    /**
     * Optional delay range for slow-mode random delays.
     */
    delayRange?: DelayRange;
    /**
     * Enable verbose logging (used by the CLI).
     */
    verbose?: boolean;
}
interface MockServerOptions extends RuntimeConfig {
    port?: number;
    /**
     * Fixed delay in milliseconds (overridden by delayRange when slow mode is enabled).
     */
    delay?: number;
}
interface MockAPIServer {
    start(): Promise<void>;
    stop(): Promise<void>;
    getApp(): express.Express;
}
type SpecInput = string | OpenAPIV3.Document;

/**
 * Create a mock API server from an OpenAPI spec path or inline document.
 */
declare function mockAPI(spec: SpecInput, options?: MockServerOptions): Promise<MockAPIServer>;

export { type MockAPIServer, type MockServerOptions, mockAPI };