export type SemVer = `${number}.${number}.${number}`;
export interface OpenApi3 {
    openapi: SemVer;
    info: InfoObject;
    servers?: ServerObject[];
    paths: PathsObject;
    components?: ComponentsObject;
    security?: SecurityRequirementObject[];
    tags?: TagObject[];
    externalDocs?: ExternalDocumentationObject;
}
export interface InfoObject {
    title: string;
    description?: string;
    termsOfService?: string;
    contact?: ContactObject;
    license?: LicenseObject;
    version: string;
}
export interface ServerObject {
    url: string;
    description?: string;
    variables?: {
        [name: string]: ServerVariableObject;
    };
}
export interface PathsObject {
    [path: `/${string}`]: PathItemObject;
}
export interface ComponentsObject {
    schemas?: {
        [name: string]: SchemaObject;
    };
}
export interface SecurityRequirementObject {
    [name: string]: string[];
}
export interface TagObject {
    name: string;
    description?: string;
    externalDocs?: ExternalDocumentationObject;
}
export interface SchemaObject {
    type?: string;
    default?: unknown;
    items?: SchemaObject | ReferenceObject;
    enum?: unknown[];
    properties?: {
        [key: string]: SchemaObject | ReferenceObject;
    };
    required?: string[];
    additionalProperties?: unknown;
    oneOf?: (SchemaObject | ReferenceObject)[];
}
export interface ExternalDocumentationObject {
    url: string;
    description?: string;
}
export interface ContactObject {
    name?: string;
    url?: string;
    email?: string;
}
export interface LicenseObject {
    name: string;
    url?: string;
}
export interface ServerVariableObject {
    enum?: string[];
    default: string;
    description?: string;
}
export type PathItemObject = {
    $ref?: string;
    summary?: string;
    description?: string;
    parameters?: (ParameterObject | ReferenceObject)[];
    servers?: ServerObject[];
} & {
    [operation in HTTPMethod]?: OperationObject;
};
export type HTTPMethod = "get" | "put" | "post" | "delete" | "options" | "head" | "patch" | "trace";
export interface OperationObject {
    tags?: string[];
    description?: string;
    responses: ResponsesObject;
    externalDocs?: ExternalDocumentationObject;
    operationId?: string;
    parameters?: (ParameterObject | ReferenceObject)[];
    requestBody?: RequestBodyObject | ReferenceObject;
}
export type ParameterObject = {
    name: string;
    description?: string;
    deprecated?: boolean;
    allowEmptyValue?: boolean;
} & ({
    in: "path";
    required: boolean;
} | {
    in: "query" | "header" | "cookie";
    required?: boolean;
}) & {
    style?: "simple" | "form" | "deepObject";
    explode?: boolean;
    allowReserved?: boolean;
    schema?: SchemaObject | ReferenceObject;
};
export interface ResponsesObject {
    [responseCode: HttpStatusCode]: ResponseObject | ReferenceObject;
    default?: ResponseObject | ReferenceObject;
}
export interface ResponseObject {
    description: string;
    content?: {
        [key: string]: MediaTypeObject;
    };
}
export interface ReferenceObject {
    $ref: string;
}
export interface RequestBodyObject {
    description?: string;
    content: {
        [key: string]: MediaTypeObject;
    };
    required?: boolean;
}
export interface MediaTypeObject {
    schema?: SchemaObject | ReferenceObject;
    example?: unknown;
    examples?: {
        [key: string]: ExampleObject | ReferenceObject;
    };
    encoding?: {
        [key: string]: EncodingObject;
    };
}
export interface ExampleObject {
    summary?: string;
    description?: string;
    value?: unknown;
    externalValue?: string;
}
export interface EncodingObject {
    contentType?: string;
    headers?: {
        [key: string]: HeaderObject | ReferenceObject;
    };
}
export type HeaderObject = Omit<ParameterObject, "in" | "name">;
export type HttpStatusCode = `${number}${number}${number}`;