schema-components 1.28.2 → 2.0.0

package/dist/openapi/parser.d.mts

@@ -1,11 +1,22 @@
-import { m as JsonObject } from "../types-BTB73MB8.mjs";
-import { i as DiagnosticsOptions } from "../diagnostics-Cbwak-ZX.mjs";
+import { m as JsonObject } from "../types-BrYbjC7_.mjs";
+import { i as DiagnosticsOptions } from "../diagnostics-BTrm3O6J.mjs";
 
 //#region src/openapi/parser.d.ts
+/**
+ * Parsed OpenAPI document: the raw root JSON plus a cache of resolved
+ * `#/components/schemas/*` (or Swagger 2.0 `#/definitions/*`) entries.
+ * Produced by {@link parseOpenApiDocument} and consumed by every other
+ * parser/resolver helper in this module.
+ */
 interface OpenApiDocument {
   doc: JsonObject;
   schemas: Map<string, JsonObject>;
 }
+/**
+ * Lightweight summary of an OpenAPI operation: its location, identity,
+ * description fields, deprecation flag, and the underlying Operation
+ * Object. Returned by {@link listOperations} / {@link listAllOperations}.
+ */
 interface OperationInfo {
   path: string;
   method: string;
@@ -15,7 +26,12 @@ interface OperationInfo {
   deprecated: boolean;
   operation: JsonObject;
 }
+/** Canonical four-value OpenAPI parameter `in` location. */
 type ParameterLocation = "query" | "path" | "header" | "cookie";
+/**
+ * Parsed view of an OpenAPI Parameter Object — name, location,
+ * required flag, deprecation flag, description, and resolved schema.
+ */
 interface ParameterInfo {
   name: string;
   location: ParameterLocation;
@@ -24,6 +40,10 @@ interface ParameterInfo {
   description: string | undefined;
   schema: JsonObject | undefined;
 }
+/**
+ * Parsed view of an OpenAPI Response Object — status code, description,
+ * declared content types, response schema, and resolved headers.
+ */
 interface ResponseInfo {
   statusCode: string;
   description: string | undefined;
@@ -31,16 +51,29 @@ interface ResponseInfo {
   schema: JsonObject | undefined;
   headers: Map<string, HeaderInfo>;
 }
+/**
+ * Parsed view of an OpenAPI Request Body Object — required flag,
+ * description, declared content types, and the request body schema.
+ */
 interface RequestBodyInfo {
   required: boolean;
   description: string | undefined;
   contentTypes: string[];
   schema: JsonObject | undefined;
 }
+/**
+ * A single entry in an OpenAPI Security Requirement Object — the name
+ * of a security scheme paired with its list of required scopes.
+ */
 interface SecurityRequirement {
   name: string;
   scopes: string[];
 }
+/**
+ * Parsed view of an OpenAPI Security Scheme Object covering every
+ * field defined for `apiKey`, `http`, `oauth2`, `openIdConnect`, and
+ * `mutualTLS` schemes.
+ */
 interface SecurityScheme {
   type: string | undefined;
   description: string | undefined;
@@ -51,6 +84,10 @@ interface SecurityScheme {
   flows: JsonObject | undefined;
   openIdConnectUrl: string | undefined;
 }
+/**
+ * Parsed view of an OpenAPI Header Object — name, description, required
+ * and deprecated flags, and resolved schema.
+ */
 interface HeaderInfo {
   name: string;
   description: string | undefined;
@@ -58,14 +95,23 @@ interface HeaderInfo {
   deprecated: boolean;
   schema: JsonObject | undefined;
 }
+/**
+ * Parsed view of a single OpenAPI 3.1 webhook entry: its name and the
+ * operations declared on its Path Item Object.
+ */
 interface WebhookInfo {
   name: string;
   operations: OperationInfo[];
 }
+/** Parsed view of an OpenAPI External Documentation Object. */
 interface ExternalDocs {
   url: string;
   description: string | undefined;
 }
+/**
+ * Parsed view of an OpenAPI XML Object — controls how a schema field
+ * is serialised in an XML payload.
+ */
 interface XmlInfo {
   name: string | undefined;
   namespace: string | undefined;
@@ -73,10 +119,19 @@ interface XmlInfo {
   attribute: boolean;
   wrapped: boolean;
 }
+/**
+ * Parsed view of a single OpenAPI Callback Object: its name and the
+ * operations declared on every callback path.
+ */
 interface CallbackInfo {
   name: string;
   operations: OperationInfo[];
 }
+/**
+ * Parsed view of an OpenAPI Link Object — name, target operation
+ * (`operationId` or `operationRef`), description, parameter mappings,
+ * and the optional request body expression.
+ */
 interface LinkInfo {
   name: string;
   operationId: string | undefined;
@@ -85,15 +140,67 @@ interface LinkInfo {
   parameters: Map<string, string>;
   requestBody: string | undefined;
 }
+/**
+ * Build an {@link OpenApiDocument} from a raw OpenAPI JSON object.
+ *
+ * Eagerly indexes the document's `#/components/schemas/*` entries and
+ * lazily caches any other `$ref` lookup on first request. Used by
+ * every other helper in this module as the single entry point for
+ * structured access to an OpenAPI document.
+ */
 declare function parseOpenApiDocument(doc: JsonObject): OpenApiDocument;
-declare function getSchema(parsed: OpenApiDocument, ref: string): JsonObject | undefined;
+/**
+ * Resolve a `$ref` string against a parsed OpenAPI document. Returns
+ * the cached entry for `#/components/schemas/*` refs (or the lazily
+ * resolved value for arbitrary fragment refs), or `undefined` when the
+ * ref cannot be resolved.
+ */
+declare function extractSchema(parsed: OpenApiDocument, ref: string): JsonObject | undefined;
+/**
+ * List every operation declared under the document's `paths` map.
+ * Follows Path Item `$ref` chains internally; cycles and over-deep
+ * chains surface as diagnostics when a sink is supplied.
+ */
 declare function listOperations(parsed: OpenApiDocument, diagnostics?: DiagnosticsOptions, seenIds?: Map<string, string>): OperationInfo[];
-declare function getParameters(parsed: OpenApiDocument, path: string, method: string, diagnostics?: DiagnosticsOptions): ParameterInfo[];
-declare function getRequestBody(parsed: OpenApiDocument, path: string, method: string): RequestBodyInfo | undefined;
-declare function getResponses(parsed: OpenApiDocument, path: string, method: string, diagnostics?: DiagnosticsOptions): ResponseInfo[];
-declare function getSecurityRequirements(parsed: OpenApiDocument, path: string, method: string): SecurityRequirement[];
-declare function getSecuritySchemes(parsed: OpenApiDocument): Map<string, SecurityScheme>;
-declare function getResponseHeaders(response: JsonObject, doc?: JsonObject, diagnostics?: DiagnosticsOptions): Map<string, HeaderInfo>;
+/**
+ * Resolve the parameters of a single operation, merging path-level
+ * parameters with operation-level overrides and following any
+ * Parameter Object `$ref` chains.
+ */
+declare function extractParameters(parsed: OpenApiDocument, path: string, method: string, diagnostics?: DiagnosticsOptions): ParameterInfo[];
+/**
+ * Resolve the request body of a single operation, including its
+ * declared content types and schema. Returns `undefined` when the
+ * operation declares no request body.
+ */
+declare function extractRequestBody(parsed: OpenApiDocument, path: string, method: string): RequestBodyInfo | undefined;
+/**
+ * Resolve the responses of a single operation, returning one
+ * {@link ResponseInfo} per declared status code (including class
+ * wildcards and `default`).
+ */
+declare function extractResponses(parsed: OpenApiDocument, path: string, method: string, diagnostics?: DiagnosticsOptions): ResponseInfo[];
+/**
+ * Resolve the effective security requirements for a single operation.
+ * Operation-level requirements override the document-level defaults
+ * when present.
+ */
+declare function extractSecurityRequirements(parsed: OpenApiDocument, path: string, method: string): SecurityRequirement[];
+/**
+ * Read the document's `components.securitySchemes` map as a map of
+ * scheme names to {@link SecurityScheme} entries.
+ */
+declare function extractSecuritySchemes(parsed: OpenApiDocument): Map<string, SecurityScheme>;
+/**
+ * Resolve the headers of a single OpenAPI Response Object as a map of
+ * header name to {@link HeaderInfo}. Follows Header Object `$ref`
+ * chains via the optional document root.
+ */
+declare function extractResponseHeaders(response: JsonObject, doc?: JsonObject, diagnostics?: DiagnosticsOptions): Map<string, HeaderInfo>;
+/**
+ * List every OpenAPI 3.1 webhook declared under the document's
+ * `webhooks` map, each with its name and resolved operations.
+ */
 declare function listWebhooks(parsed: OpenApiDocument, diagnostics?: DiagnosticsOptions, seenIds?: Map<string, string>): WebhookInfo[];
 /**
  * Enumerate every operation in the document — both the `paths` map and
@@ -104,9 +211,29 @@ declare function listWebhooks(parsed: OpenApiDocument, diagnostics?: Diagnostics
  * grouping should call `listWebhooks` directly.
  */
 declare function listAllOperations(parsed: OpenApiDocument, diagnostics?: DiagnosticsOptions): OperationInfo[];
-declare function getExternalDocs(obj: JsonObject): ExternalDocs | undefined;
-declare function getXmlInfo(schema: JsonObject): XmlInfo | undefined;
+/**
+ * Read the optional `externalDocs` field on an OpenAPI object
+ * (document, operation, tag, schema, ...) into an {@link ExternalDocs}
+ * record. Returns `undefined` when absent or malformed.
+ */
+declare function extractExternalDocs(obj: JsonObject): ExternalDocs | undefined;
+/**
+ * Read the optional `xml` keyword on a JSON Schema object into an
+ * {@link XmlInfo} record describing how the field is serialised in an
+ * XML payload. Returns `undefined` when absent or malformed.
+ */
+declare function extractXmlInfo(schema: JsonObject): XmlInfo | undefined;
+/**
+ * List the OpenAPI callback definitions declared on a single
+ * operation. Each entry carries the callback name and the operations
+ * declared on its Path Item Object.
+ */
 declare function listCallbacks(parsed: OpenApiDocument, path: string, method: string, diagnostics?: DiagnosticsOptions): CallbackInfo[];
-declare function getLinks(parsed: OpenApiDocument, path: string, method: string, statusCode: string, diagnostics?: DiagnosticsOptions): LinkInfo[];
+/**
+ * List the OpenAPI link definitions declared on a specific response of
+ * a single operation, returning each link's parsed
+ * {@link LinkInfo} entry.
+ */
+declare function extractLinks(parsed: OpenApiDocument, path: string, method: string, statusCode: string, diagnostics?: DiagnosticsOptions): LinkInfo[];
 //#endregion
-export { CallbackInfo, ExternalDocs, HeaderInfo, LinkInfo, OpenApiDocument, OperationInfo, ParameterInfo, ParameterLocation, RequestBodyInfo, ResponseInfo, SecurityRequirement, SecurityScheme, WebhookInfo, XmlInfo, getExternalDocs, getLinks, getParameters, getRequestBody, getResponseHeaders, getResponses, getSchema, getSecurityRequirements, getSecuritySchemes, getXmlInfo, listAllOperations, listCallbacks, listOperations, listWebhooks, parseOpenApiDocument };
+export { CallbackInfo, ExternalDocs, HeaderInfo, LinkInfo, OpenApiDocument, OperationInfo, ParameterInfo, ParameterLocation, RequestBodyInfo, ResponseInfo, SecurityRequirement, SecurityScheme, WebhookInfo, XmlInfo, extractExternalDocs, extractLinks, extractParameters, extractRequestBody, extractResponseHeaders, extractResponses, extractSchema, extractSecurityRequirements, extractSecuritySchemes, extractXmlInfo, listAllOperations, listCallbacks, listOperations, listWebhooks, parseOpenApiDocument };

package/dist/openapi/parser.mjs

@@ -33,6 +33,14 @@ function toParameterLocation(value, parameterName, pointer, diagnostics) {
 		}
 	});
 }
+/**
+* Build an {@link OpenApiDocument} from a raw OpenAPI JSON object.
+*
+* Eagerly indexes the document's `#/components/schemas/*` entries and
+* lazily caches any other `$ref` lookup on first request. Used by
+* every other helper in this module as the single entry point for
+* structured access to an OpenAPI document.
+*/
 function parseOpenApiDocument(doc) {
 	const schemas = /* @__PURE__ */ new Map();
 	const componentSchemas = getProperty(getProperty(doc, "components"), "schemas");
@@ -44,7 +52,13 @@ function parseOpenApiDocument(doc) {
 		schemas
 	};
 }
-function getSchema(parsed, ref) {
+/**
+* Resolve a `$ref` string against a parsed OpenAPI document. Returns
+* the cached entry for `#/components/schemas/*` refs (or the lazily
+* resolved value for arbitrary fragment refs), or `undefined` when the
+* ref cannot be resolved.
+*/
+function extractSchema(parsed, ref) {
 	const cached = parsed.schemas.get(ref);
 	if (cached !== void 0) return cached;
 	const resolved = resolveRefInDoc(parsed.doc, ref);
@@ -125,6 +139,11 @@ function recordOperationId(operationId, location, pointer, seenIds, diagnostics)
 	}
 	seenIds.set(operationId, location);
 }
+/**
+* List every operation declared under the document's `paths` map.
+* Follows Path Item `$ref` chains internally; cycles and over-deep
+* chains surface as diagnostics when a sink is supplied.
+*/
 function listOperations(parsed, diagnostics, seenIds = /* @__PURE__ */ new Map()) {
 	const operations = [];
 	const paths = getProperty(parsed.doc, "paths");
@@ -150,7 +169,12 @@ function listOperations(parsed, diagnostics, seenIds = /* @__PURE__ */ new Map()
 	}
 	return operations;
 }
-function getParameters(parsed, path, method, diagnostics) {
+/**
+* Resolve the parameters of a single operation, merging path-level
+* parameters with operation-level overrides and following any
+* Parameter Object `$ref` chains.
+*/
+function extractParameters(parsed, path, method, diagnostics) {
 	const pathItem = lookupPathItem(parsed, path);
 	if (pathItem === void 0) return [];
 	const operation = getProperty(pathItem, method);
@@ -246,7 +270,12 @@ function resolveParam(doc, param, diagnostics) {
 function jsonPointerEscape(segment) {
 	return segment.replace(/~/g, "~0").replace(/\//g, "~1");
 }
-function getRequestBody(parsed, path, method) {
+/**
+* Resolve the request body of a single operation, including its
+* declared content types and schema. Returns `undefined` when the
+* operation declares no request body.
+*/
+function extractRequestBody(parsed, path, method) {
 	const requestBodyRaw = getProperty(getProperty(lookupPathItem(parsed, path), method), "requestBody");
 	if (!isObject(requestBodyRaw)) return void 0;
 	const requestBody = resolveWrapperRef(parsed.doc, requestBodyRaw);
@@ -267,7 +296,12 @@ function getRequestBody(parsed, path, method) {
 		schema
 	};
 }
-function getResponses(parsed, path, method, diagnostics) {
+/**
+* Resolve the responses of a single operation, returning one
+* {@link ResponseInfo} per declared status code (including class
+* wildcards and `default`).
+*/
+function extractResponses(parsed, path, method, diagnostics) {
 	const responses = getProperty(getProperty(lookupPathItem(parsed, path), method), "responses");
 	if (!isObject(responses)) return [];
 	const result = [];
@@ -278,7 +312,7 @@ function getResponses(parsed, path, method, diagnostics) {
 		const content = getProperty(response, "content");
 		const contentTypes = isObject(content) ? Object.keys(content) : [];
 		const schema = isObject(content) ? extractSchemaFromContent(content) : void 0;
-		const headers = getResponseHeaders(response, parsed.doc, diagnostics);
+		const headers = extractResponseHeaders(response, parsed.doc, diagnostics);
 		result.push({
 			statusCode,
 			description: getString(response, "description"),
@@ -409,7 +443,12 @@ function resolveRefInDoc(doc, ref) {
 	}
 	return isObject(current) ? current : void 0;
 }
-function getSecurityRequirements(parsed, path, method) {
+/**
+* Resolve the effective security requirements for a single operation.
+* Operation-level requirements override the document-level defaults
+* when present.
+*/
+function extractSecurityRequirements(parsed, path, method) {
 	const opSecurity = getProperty(getProperty(lookupPathItem(parsed, path), method), "security");
 	const globalSecurity = getProperty(parsed.doc, "security");
 	const securityArray = Array.isArray(opSecurity) ? opSecurity : Array.isArray(globalSecurity) ? globalSecurity : [];
@@ -423,7 +462,11 @@ function getSecurityRequirements(parsed, path, method) {
 	}
 	return result;
 }
-function getSecuritySchemes(parsed) {
+/**
+* Read the document's `components.securitySchemes` map as a map of
+* scheme names to {@link SecurityScheme} entries.
+*/
+function extractSecuritySchemes(parsed) {
 	const result = /* @__PURE__ */ new Map();
 	const securitySchemes = getProperty(getProperty(parsed.doc, "components"), "securitySchemes");
 	if (!isObject(securitySchemes)) return result;
@@ -443,7 +486,12 @@ function getSecuritySchemes(parsed) {
 	}
 	return result;
 }
-function getResponseHeaders(response, doc, diagnostics) {
+/**
+* Resolve the headers of a single OpenAPI Response Object as a map of
+* header name to {@link HeaderInfo}. Follows Header Object `$ref`
+* chains via the optional document root.
+*/
+function extractResponseHeaders(response, doc, diagnostics) {
 	const result = /* @__PURE__ */ new Map();
 	const headers = getProperty(response, "headers");
 	if (!isObject(headers)) return result;
@@ -461,6 +509,10 @@ function getResponseHeaders(response, doc, diagnostics) {
 	}
 	return result;
 }
+/**
+* List every OpenAPI 3.1 webhook declared under the document's
+* `webhooks` map, each with its name and resolved operations.
+*/
 function listWebhooks(parsed, diagnostics, seenIds = /* @__PURE__ */ new Map()) {
 	const result = [];
 	const webhooks = getProperty(parsed.doc, "webhooks");
@@ -505,7 +557,12 @@ function listAllOperations(parsed, diagnostics) {
 	const webhookOps = listWebhooks(parsed, diagnostics, seenIds).flatMap((w) => w.operations);
 	return [...pathOps, ...webhookOps];
 }
-function getExternalDocs(obj) {
+/**
+* Read the optional `externalDocs` field on an OpenAPI object
+* (document, operation, tag, schema, ...) into an {@link ExternalDocs}
+* record. Returns `undefined` when absent or malformed.
+*/
+function extractExternalDocs(obj) {
 	const docs = getProperty(obj, "externalDocs");
 	if (!isObject(docs)) return void 0;
 	const url = getString(docs, "url");
@@ -515,7 +572,12 @@ function getExternalDocs(obj) {
 		description: getString(docs, "description")
 	};
 }
-function getXmlInfo(schema) {
+/**
+* Read the optional `xml` keyword on a JSON Schema object into an
+* {@link XmlInfo} record describing how the field is serialised in an
+* XML payload. Returns `undefined` when absent or malformed.
+*/
+function extractXmlInfo(schema) {
 	const xml = getProperty(schema, "xml");
 	if (!isObject(xml)) return void 0;
 	return {
@@ -526,6 +588,11 @@ function getXmlInfo(schema) {
 		wrapped: getProperty(xml, "wrapped") === true
 	};
 }
+/**
+* List the OpenAPI callback definitions declared on a single
+* operation. Each entry carries the callback name and the operations
+* declared on its Path Item Object.
+*/
 function listCallbacks(parsed, path, method, diagnostics) {
 	const operation = getProperty(lookupPathItem(parsed, path), method);
 	if (!isObject(operation)) return [];
@@ -559,7 +626,12 @@ function listCallbacks(parsed, path, method, diagnostics) {
 	}
 	return result;
 }
-function getLinks(parsed, path, method, statusCode, diagnostics) {
+/**
+* List the OpenAPI link definitions declared on a specific response of
+* a single operation, returning each link's parsed
+* {@link LinkInfo} entry.
+*/
+function extractLinks(parsed, path, method, statusCode, diagnostics) {
 	const response = getProperty(getProperty(getProperty(lookupPathItem(parsed, path), method), "responses"), statusCode);
 	if (!isObject(response)) return [];
 	const links = getProperty(response, "links");
@@ -585,4 +657,4 @@ function getLinks(parsed, path, method, statusCode, diagnostics) {
 	return result;
 }
 //#endregion
-export { getExternalDocs, getLinks, getParameters, getRequestBody, getResponseHeaders, getResponses, getSchema, getSecurityRequirements, getSecuritySchemes, getXmlInfo, listAllOperations, listCallbacks, listOperations, listWebhooks, parseOpenApiDocument };
+export { extractExternalDocs, extractLinks, extractParameters, extractRequestBody, extractResponseHeaders, extractResponses, extractSchema, extractSecurityRequirements, extractSecuritySchemes, extractXmlInfo, listAllOperations, listCallbacks, listOperations, listWebhooks, parseOpenApiDocument };

package/dist/openapi/resolve.d.mts

@@ -1,5 +1,5 @@
-import { i as DiagnosticsOptions } from "../diagnostics-Cbwak-ZX.mjs";
-import { OpenApiDocument, OperationInfo, ParameterInfo, ResponseInfo, getRequestBody } from "./parser.mjs";
+import { i as DiagnosticsOptions } from "../diagnostics-BTrm3O6J.mjs";
+import { OpenApiDocument, OperationInfo, ParameterInfo, RequestBodyInfo, ResponseInfo } from "./parser.mjs";
 
 //#region src/openapi/resolve.d.ts
 /**
@@ -11,7 +11,7 @@ import { OpenApiDocument, OperationInfo, ParameterInfo, ResponseInfo, getRequest
  * keywords (`nullable`, `discriminator`, `example`), OpenAPI 3.1.x
  * `discriminator`, and Swagger 2.0 documents are all converted to
  * canonical Draft 2020-12 form. The parser and downstream extractors
- * (`getRequestBody`, `getResponses`, etc.) then observe schemas in the
+ * (`extractRequestBody`, `extractResponses`, etc.) then observe schemas in the
  * same form `<SchemaComponent>` does, keeping the OpenAPI components on
  * the same pipeline as the top-level adapter.
  *
@@ -58,74 +58,69 @@ interface PathItemInfo {
   summary: string | undefined;
   description: string | undefined;
 }
+/**
+ * Aggregate view of a single OpenAPI operation: the operation itself,
+ * its Path Item Object context, merged parameters, request body, and
+ * responses. Produced by {@link resolveOperation} for rendering and
+ * inspection.
+ */
 interface ResolvedOperation {
   operation: OperationInfo;
   pathItem: PathItemInfo;
   parameters: ParameterInfo[];
-  requestBody: ReturnType<typeof getRequestBody>;
+  requestBody: RequestBodyInfo | undefined;
   responses: ResponseInfo[];
 }
-/**
- * Resolve an operation against an already-parsed document. Throws if
- * the operation is not found.
- *
- * Used by callers that have already obtained a parsed document via
- * {@link getParsed} — most importantly the React components, which
- * supply `diagnostics` to `getParsed` and must avoid re-running the
- * normalisation pipeline (every re-run would emit each diagnostic
- * again into the sink).
- */
-declare function resolveOperationFromParsed(parsed: OpenApiDocument, path: string, method: string, diagnostics?: DiagnosticsOptions): ResolvedOperation;
 /**
  * Resolve an operation from an OpenAPI document by path and method.
  * Throws if the operation is not found.
  *
- * `diagnostics` is forwarded to {@link getParsed} so normalisation
- * events surface to the caller's sink.
- */
-declare function resolveOperation(doc: Record<string, unknown>, path: string, method: string, diagnostics?: DiagnosticsOptions): ResolvedOperation;
-/**
- * Resolve parameters against an already-parsed document. See
- * {@link resolveOperationFromParsed} for the rationale.
- */
-declare function resolveParametersFromParsed(parsed: OpenApiDocument, path: string, method: string): ParameterInfo[];
-/**
- * Resolve parameters for an operation. Returns empty array if none.
+ * Accepts either a raw document (parsed lazily via {@link getParsed}'s
+ * WeakMap cache) or an already-parsed {@link OpenApiDocument}. Callers
+ * that have a parsed document at hand can pass it directly to avoid
+ * an extra cache lookup; everyone else trusts the cache.
  *
  * `diagnostics` is forwarded to {@link getParsed} so normalisation
- * events surface to the caller's sink.
+ * events surface to the caller's sink exactly once per `(doc, sink)`
+ * pair, no matter how many times this function is called.
  */
-declare function resolveParameters(doc: Record<string, unknown>, path: string, method: string, diagnostics?: DiagnosticsOptions): ParameterInfo[];
+declare function resolveOperation(doc: Record<string, unknown> | OpenApiDocument, path: string, method: string, diagnostics?: DiagnosticsOptions): ResolvedOperation;
 /**
- * Resolve a request body against an already-parsed document. See
- * {@link resolveOperationFromParsed} for the rationale.
- */
-declare function resolveRequestBodyFromParsed(parsed: OpenApiDocument, path: string, method: string): ReturnType<typeof getRequestBody>;
-/**
- * Resolve request body for an operation. Returns undefined if none.
+ * Resolve parameters for an operation. Returns an empty array if none.
  *
- * `diagnostics` is forwarded to {@link getParsed} so normalisation
- * events surface to the caller's sink.
+ * Accepts either a raw document or an already-parsed
+ * {@link OpenApiDocument}. `diagnostics` is forwarded to
+ * {@link getParsed} so normalisation events surface to the caller's
+ * sink.
  */
-declare function resolveRequestBody(doc: Record<string, unknown>, path: string, method: string, diagnostics?: DiagnosticsOptions): ReturnType<typeof getRequestBody>;
+declare function resolveParameters(doc: Record<string, unknown> | OpenApiDocument, path: string, method: string, diagnostics?: DiagnosticsOptions): ParameterInfo[];
 /**
- * Resolve a specific response against an already-parsed document. See
- * {@link resolveOperationFromParsed} for the rationale.
+ * Resolve the request body for an operation. Returns `undefined` if
+ * the operation declares no request body.
+ *
+ * Accepts either a raw document or an already-parsed
+ * {@link OpenApiDocument}. `diagnostics` is forwarded to
+ * {@link getParsed} so normalisation events surface to the caller's
+ * sink.
  */
-declare function resolveResponseFromParsed(parsed: OpenApiDocument, path: string, method: string, statusCode: string): ResponseInfo;
+declare function resolveRequestBody(doc: Record<string, unknown> | OpenApiDocument, path: string, method: string, diagnostics?: DiagnosticsOptions): RequestBodyInfo | undefined;
 /**
  * Resolve a specific response by status code. Throws if not found.
  *
- * `diagnostics` is forwarded to {@link getParsed} so normalisation
- * events surface to the caller's sink.
+ * Accepts either a raw document or an already-parsed
+ * {@link OpenApiDocument}. `diagnostics` is forwarded to
+ * {@link getParsed} so normalisation events surface to the caller's
+ * sink.
  */
-declare function resolveResponse(doc: Record<string, unknown>, path: string, method: string, statusCode: string, diagnostics?: DiagnosticsOptions): ResponseInfo;
+declare function resolveResponse(doc: Record<string, unknown> | OpenApiDocument, path: string, method: string, statusCode: string, diagnostics?: DiagnosticsOptions): ResponseInfo;
 /**
  * Resolve all responses for an operation.
  *
- * `diagnostics` is forwarded to {@link getParsed} so normalisation
- * events surface to the caller's sink.
+ * Accepts either a raw document or an already-parsed
+ * {@link OpenApiDocument}. `diagnostics` is forwarded to
+ * {@link getParsed} so normalisation events surface to the caller's
+ * sink.
  */
-declare function resolveResponses(doc: Record<string, unknown>, path: string, method: string, diagnostics?: DiagnosticsOptions): ResponseInfo[];
+declare function resolveResponses(doc: Record<string, unknown> | OpenApiDocument, path: string, method: string, diagnostics?: DiagnosticsOptions): ResponseInfo[];
 //#endregion
-export { PathItemInfo, ResolvedOperation, getParsed, resolveOperation, resolveOperationFromParsed, resolveParameters, resolveParametersFromParsed, resolveRequestBody, resolveRequestBodyFromParsed, resolveResponse, resolveResponseFromParsed, resolveResponses, toDoc };
+export { PathItemInfo, ResolvedOperation, getParsed, resolveOperation, resolveParameters, resolveRequestBody, resolveResponse, resolveResponses, toDoc };