@type responses_map() :: %{
  required(String.t()) => OpenApiSpex.Response.t() | OpenApiSpex.Reference.t()
}

@type schemas_map() :: %{
  required(String.t()) => OpenApiSpex.Schema.t() | OpenApiSpex.Reference.t()
}

@type t() :: %OpenApiSpex.Components{
  callbacks:
    %{
      required(String.t()) =>
        OpenApiSpex.Callback.t() | OpenApiSpex.Reference.t()
    }
    | nil,
  examples:
    %{
      required(String.t()) =>
        OpenApiSpex.Example.t() | OpenApiSpex.Reference.t()
    }
    | nil,
  extensions: %{required(String.t()) => any()} | nil,
  headers:
    %{
      required(String.t()) => OpenApiSpex.Header.t() | OpenApiSpex.Reference.t()
    }
    | nil,
  links:
    %{required(String.t()) => OpenApiSpex.Link.t() | OpenApiSpex.Reference.t()}
    | nil,
  parameters:
    %{
      required(String.t()) =>
        OpenApiSpex.Parameter.t() | OpenApiSpex.Reference.t()
    }
    | nil,
  requestBodies:
    %{
      required(String.t()) =>
        OpenApiSpex.RequestBody.t() | OpenApiSpex.Reference.t()
    }
    | nil,
  responses: responses_map() | nil,
  schemas: schemas_map() | nil,
  securitySchemes:
    %{
      required(String.t()) =>
        OpenApiSpex.SecurityScheme.t() | OpenApiSpex.Reference.t()
    }
    | nil
}