import { IJsonSchemaAttribute } from "../schema/IJsonSchemaAttribute";
import * as tags from "../tags";
/**
 * Swagger v2.0 specification types.
 *
 * `SwaggerV2` contains TypeScript type definitions for Swagger v2.0 (OpenAPI
 * v2) documents. Used for parsing legacy Swagger specifications. For a
 * normalized format that unifies all OpenAPI versions, use {@link OpenApi}.
 *
 * Key differences from OpenAPI v3.x:
 *
 * - Uses `definitions` instead of `components.schemas`
 * - Body parameters use `in: "body"` with `schema` property
 * - No `requestBody`, `oneOf`, `anyOf`, or `nullable`
 * - Uses `host` + `basePath` instead of `servers`
 *
 * @author Jeongho Nam - https://github.com/samchon
 */
export declare namespace SwaggerV2 {
    /** HTTP method of the operation. */
    type Method = "get" | "post" | "put" | "delete" | "options" | "head" | "patch" | "trace";
    /** Swagger document structure. */
    interface IDocument {
        /** Swagger version. */
        swagger: "2.0" | `2.0.${number}`;
        /** API metadata. */
        info?: IDocument.IInfo;
        /** Host address. */
        host?: string;
        /** Base path for all operations. */
        basePath?: string;
        /** Global content types consumed. */
        consumes?: string[];
        /** Global content types produced. */
        produces?: string[];
        /** Schema definitions. */
        definitions?: Record<string, IJsonSchema>;
        /** Reusable parameter definitions. */
        parameters?: Record<string, IOperation.IParameter>;
        /** Reusable response definitions. */
        responses?: Record<string, IOperation.IResponse>;
        /** Security scheme definitions. */
        securityDefinitions?: Record<string, ISecurityDefinition>;
        /** Global security requirements. */
        security?: Record<string, string[]>[];
        /** API paths and operations. */
        paths?: Record<string, IPath>;
        /** Tag definitions. */
        tags?: IDocument.ITag[];
    }
    namespace IDocument {
        /** API metadata. */
        interface IInfo {
            /** API title. */
            title: string;
            /** API description. */
            description?: string;
            /** Terms of service URL. */
            termsOfService?: string;
            /** Contact information. */
            contact?: IContact;
            /** License information. */
            license?: ILicense;
            /** API version. */
            version: string;
        }
        /** Contact information. */
        interface IContact {
            /** Contact name. */
            name?: string;
            /** Contact URL. */
            url?: string;
            /** Contact email. */
            email?: string & tags.Format<"email">;
        }
        /** License information. */
        interface ILicense {
            /** License name. */
            name: string;
            /** License URL. */
            url?: string;
        }
        /** Tag for grouping operations. */
        interface ITag {
            /** Tag name. */
            name: string;
            /** Tag description. */
            description?: string;
        }
    }
    /** Path item containing operations by HTTP method. */
    interface IPath extends Partial<Record<Method, IOperation | undefined>> {
        /** Path-level parameters. */
        parameters?: Array<IOperation.IParameter | IJsonSchema.IReference<`#/parameters/${string}`>>;
        /**
         * Non-standard HTTP method operations (extension).
         *
         * Used when downgrading from OpenAPI v3.2 to preserve non-standard methods
         * like `query` or custom methods.
         */
        "x-additionalOperations"?: Record<string, IOperation>;
    }
    /** API operation metadata. */
    interface IOperation {
        /** Unique operation identifier. */
        operationId?: string;
        /** Operation parameters. */
        parameters?: Array<IOperation.IParameter | IJsonSchema.IReference<`#/definitions/parameters/${string}`>>;
        /** Response definitions by status code. */
        responses?: Record<string, IOperation.IResponse | IJsonSchema.IReference<`#/definitions/responses/${string}`>>;
        /** Short summary. */
        summary?: string;
        /** Full description. */
        description?: string;
        /** Security requirements. */
        security?: Record<string, string[]>[];
        /** Operation tags. */
        tags?: string[];
        /** Whether deprecated. */
        deprecated?: boolean;
    }
    namespace IOperation {
        /** Operation parameter (general or body). */
        type IParameter = IGeneralParameter | IBodyParameter;
        /** General parameter (path, query, header, formData). */
        type IGeneralParameter = IJsonSchema & {
            name: string;
            in: string;
            description?: string;
        };
        /** Body parameter. */
        interface IBodyParameter {
            /** Body schema. */
            schema: IJsonSchema;
            /** Parameter name. */
            name: string;
            /** Parameter location (always "body"). */
            in: string;
            /** Parameter description. */
            description?: string;
            /** Whether required. */
            required?: boolean;
        }
        /** Response definition. */
        interface IResponse {
            /** Response description. */
            description?: string;
            /** Response headers. */
            headers?: Record<string, IJsonSchema>;
            /** Response body schema. */
            schema?: IJsonSchema;
            /** Example value. */
            example?: any;
        }
    }
    /** JSON Schema type for Swagger. */
    type IJsonSchema = IJsonSchema.IBoolean | IJsonSchema.IInteger | IJsonSchema.INumber | IJsonSchema.IString | IJsonSchema.IArray | IJsonSchema.IObject | IJsonSchema.IReference | IJsonSchema.IAnyOf | IJsonSchema.IOneOf | IJsonSchema.INullOnly | IJsonSchema.IUnknown;
    namespace IJsonSchema {
        /** Boolean type. */
        interface IBoolean extends Omit<IJsonSchemaAttribute.IBoolean, "examples">, __ISignificant<"boolean"> {
            /** Default value. */
            default?: boolean | null;
            /** Allowed values. */
            enum?: Array<boolean | null>;
        }
        /** Integer type. */
        interface IInteger extends Omit<IJsonSchemaAttribute.IInteger, "examples">, __ISignificant<"integer"> {
            /** Default value. */
            default?: (number & tags.Type<"int64">) | null;
            /** Allowed values. */
            enum?: Array<(number & tags.Type<"int64">) | null>;
            /** Minimum value. */
            minimum?: number & tags.Type<"int64">;
            /** Maximum value. */
            maximum?: number & tags.Type<"int64">;
            /** Exclusive minimum. */
            exclusiveMinimum?: number | boolean;
            /** Exclusive maximum. */
            exclusiveMaximum?: number | boolean;
            /** Multiple of constraint. */
            multipleOf?: number & tags.ExclusiveMinimum<0>;
        }
        /** Number (double) type. */
        interface INumber extends Omit<IJsonSchemaAttribute.INumber, "examples">, __ISignificant<"number"> {
            /** Default value. */
            default?: number | null;
            /** Allowed values. */
            enum?: Array<number | null>;
            /** Minimum value. */
            minimum?: number;
            /** Maximum value. */
            maximum?: number;
            /** Exclusive minimum. */
            exclusiveMinimum?: number | boolean;
            /** Exclusive maximum. */
            exclusiveMaximum?: number | boolean;
            /** Multiple of constraint. */
            multipleOf?: number & tags.ExclusiveMinimum<0>;
        }
        /** String type. */
        interface IString extends Omit<IJsonSchemaAttribute.IString, "examples">, __ISignificant<"string"> {
            /** Default value. */
            default?: string | null;
            /** Allowed values. */
            enum?: Array<string | null>;
            /** String format. */
            format?: "binary" | "byte" | "password" | "regex" | "uuid" | "email" | "hostname" | "idn-email" | "idn-hostname" | "iri" | "iri-reference" | "ipv4" | "ipv6" | "uri" | "uri-reference" | "uri-template" | "url" | "date-time" | "date" | "time" | "duration" | "json-pointer" | "relative-json-pointer" | (string & {});
            /** Regex pattern. */
            pattern?: string;
            /** Minimum length. */
            minLength?: number & tags.Type<"uint64">;
            /** Maximum length. */
            maxLength?: number & tags.Type<"uint64">;
        }
        /** Array type. */
        interface IArray extends Omit<IJsonSchemaAttribute.IArray, "examples">, __ISignificant<"array"> {
            /** Element type. */
            items: IJsonSchema;
            /** Whether elements must be unique. */
            uniqueItems?: boolean;
            /** Minimum items. */
            minItems?: number & tags.Type<"uint64">;
            /** Maximum items. */
            maxItems?: number & tags.Type<"uint64">;
        }
        /** Object type. */
        interface IObject extends Omit<IJsonSchemaAttribute.IObject, "examples">, __ISignificant<"object"> {
            /** Property schemas. */
            properties?: Record<string, IJsonSchema>;
            /** Required property names. */
            required?: string[];
            /** Additional properties schema. */
            additionalProperties?: boolean | IJsonSchema;
            /** Maximum properties. */
            maxProperties?: number;
            /** Minimum properties. */
            minProperties?: number;
        }
        /** Reference to a named schema. */
        interface IReference<Key = string> extends __IAttribute {
            /** Reference path. */
            $ref: Key;
        }
        /** All-of combination. */
        interface IAllOf extends __IAttribute {
            /** Schemas to combine. */
            allOf: IJsonSchema[];
        }
        /** Any-of union (Swagger extension). */
        interface IAnyOf extends __IAttribute {
            /** Union member schemas. */
            "x-anyOf": IJsonSchema[];
        }
        /** One-of union (Swagger extension). */
        interface IOneOf extends __IAttribute {
            /** Union member schemas. */
            "x-oneOf": IJsonSchema[];
        }
        /** Null type. */
        interface INullOnly extends __IAttribute {
            /** Type discriminator. */
            type: "null";
            /** Default value. */
            default?: null;
        }
        /** Unknown type. */
        interface IUnknown extends __IAttribute {
            /** Type discriminator (undefined for unknown). */
            type?: undefined;
        }
        /** @ignore Base Interface with type discriminator. */
        interface __ISignificant<Type extends string> extends __IAttribute {
            /** Type discriminator. */
            type: Type;
            /** Nullable flag (Swagger extension). */
            "x-nullable"?: boolean;
        }
        /** @ignore Base Attribute interface. */
        interface __IAttribute extends Omit<IJsonSchemaAttribute, "examples" | "writeOnly"> {
            /** Example values. */
            examples?: any[];
        }
    }
    /** Security scheme types. */
    type ISecurityDefinition = ISecurityDefinition.IApiKey | ISecurityDefinition.IBasic | ISecurityDefinition.IOauth2Implicit | ISecurityDefinition.IOauth2AccessCode | ISecurityDefinition.IOauth2Password | ISecurityDefinition.IOauth2Application;
    namespace ISecurityDefinition {
        /** API key authentication. */
        interface IApiKey {
            /** Scheme type. */
            type: "apiKey";
            /** Key location. */
            in?: "header" | "query" | "cookie";
            /** Key name. */
            name?: string;
            /** Scheme description. */
            description?: string;
        }
        /** HTTP basic authentication. */
        interface IBasic {
            /** Scheme type. */
            type: "basic";
            /** Scheme name. */
            name?: string;
            /** Scheme description. */
            description?: string;
        }
        /** OAuth2 implicit flow. */
        interface IOauth2Implicit {
            /** Scheme type. */
            type: "oauth2";
            /** OAuth2 flow type. */
            flow: "implicit";
            /** Authorization URL. */
            authorizationUrl?: string;
            /** Available scopes. */
            scopes?: Record<string, string>;
            /** Scheme description. */
            description?: string;
        }
        /** OAuth2 authorization code flow. */
        interface IOauth2AccessCode {
            /** Scheme type. */
            type: "oauth2";
            /** OAuth2 flow type. */
            flow: "accessCode";
            /** Authorization URL. */
            authorizationUrl?: string;
            /** Token URL. */
            tokenUrl?: string;
            /** Available scopes. */
            scopes?: Record<string, string>;
            /** Scheme description. */
            description?: string;
        }
        /** OAuth2 password flow. */
        interface IOauth2Password {
            /** Scheme type. */
            type: "oauth2";
            /** OAuth2 flow type. */
            flow: "password";
            /** Token URL. */
            tokenUrl?: string;
            /** Available scopes. */
            scopes?: Record<string, string>;
            /** Scheme description. */
            description?: string;
        }
        /** OAuth2 application (client credentials) flow. */
        interface IOauth2Application {
            /** Scheme type. */
            type: "oauth2";
            /** OAuth2 flow type. */
            flow: "application";
            /** Token URL. */
            tokenUrl?: string;
            /** Available scopes. */
            scopes?: Record<string, string>;
            /** Scheme description. */
            description?: string;
        }
    }
}