parser

type FeatureVersionError struct {
	Feature string
	Minimum openapi.Version
	Actual  openapi.Version
}

type LocationError = location.Error

type Settings struct {
	// External is external JSON Schema resolver. If nil, NoExternal resolver is used.
	External jsonschema.ExternalResolver

	// File is the file that is being parsed.
	//
	// Used for error messages.
	File location.File

	// RootURL is the root URL of the spec.
	//
	// If nil, jsonpointer.DummyURL is used.
	RootURL *url.URL

	// DepthLimit limits the number of nested references. Default is 1000.
	DepthLimit int

	// Enables type inference.
	//
	// For example:
	//
	//	{
	//		"items": {
	//			"type": "string"
	//		}
	//	}
	//
	// In that case schemaParser will handle that schema as "array" schema, because it has "items" field.
	InferTypes bool

	// AllowCrossTypeConstraints enables interpretation of cross-type schema constraints.
	// When true (default), constraints like pattern on numbers or maximum on strings
	// are allowed and interpreted during code generation.
	AllowCrossTypeConstraints bool

	// AuthenticationSchemes is the list of allowed HTTP Authorization schemes in a Security Scheme Object.
	//
	// Authorization schemes are case-insensitive.
	//
	// If empty, the ones registered in https://www.iana.org/assignments/http-authschemes/http-authschemes.xhtml are used.
	//
	// See https://swagger.io/specification/#security-scheme-object.
	AuthenticationSchemes []string

	// DisallowDuplicateMethodPaths controls whether paths that normalize to the same
	// structure (e.g., /pets/{petId} and /pets/{id}) are allowed when they have
	// different HTTP methods.
	//
	// When false (default), paths with different parameter names but different HTTP methods
	// are allowed, and operations are disambiguated by path + params + method.
	//
	// When true, duplicate paths are always rejected per strict OpenAPI spec interpretation.
	DisallowDuplicateMethodPaths bool
}