schema-components 1.3.2 → 1.3.3

package/CHANGELOG.md

@@ -1,3 +1,16 @@
+## [1.3.3](https://github.com/Mearman/schema-components/compare/v1.3.2...v1.3.3) (2026-05-14)
+
+### Refactoring
+
+* extract pure resolution layer from openapi components ([5e0ab32](https://github.com/Mearman/schema-components/commit/5e0ab32de44b41b23e74082886a5ae881b418883))
+
+### Tests
+
+* add guards unit tests ([39f53ab](https://github.com/Mearman/schema-components/commit/39f53abf4cf30f1751a09267f34990c4a2532567))
+* add openapi resolution and component unit tests ([75a5892](https://github.com/Mearman/schema-components/commit/75a589220f05b5649a531bec946a63093e824687))
+* add renderer utility unit tests ([3ca3677](https://github.com/Mearman/schema-components/commit/3ca367709acf6324a33a79adf3799528971defc2))
+* expand html and streaming coverage, tighten vitest config ([ac480cd](https://github.com/Mearman/schema-components/commit/ac480cdeb39cf2ae0fa3107de2abae39102cfa26))
+
 ## [1.3.2](https://github.com/Mearman/schema-components/compare/v1.3.1...v1.3.2) (2026-05-14)
 
 ### Refactoring

package/dist/openapi/components.mjs

@@ -1,23 +1,12 @@
-import { isObject, toRecordOrUndefined } from "../core/guards.mjs";
+import { toRecordOrUndefined } from "../core/guards.mjs";
 import { normaliseSchema } from "../core/adapter.mjs";
 import { SchemaNormalisationError } from "../core/errors.mjs";
 import { walk } from "../core/walker.mjs";
-import { getParameters, getRequestBody, getResponses, listOperations, parseOpenApiDocument } from "./parser.mjs";
 import { renderField } from "../react/SchemaComponent.mjs";
+import { resolveOperation, resolveParameters, resolveRequestBody, resolveResponse, toDoc } from "./resolve.mjs";
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
 //#region src/openapi/components.tsx
-const docCache = /* @__PURE__ */ new WeakMap();
-function getParsed(doc) {
-	const cached = docCache.get(doc);
-	if (cached !== void 0) return cached;
-	const parsed = parseOpenApiDocument(doc);
-	docCache.set(doc, parsed);
-	return parsed;
-}
 function noop() {}
-function toDoc(value) {
-	return isObject(value) ? value : {};
-}
 function renderSchema(schema, rootDocument, options) {
 	let jsonSchema;
 	let rootMeta;
@@ -42,38 +31,33 @@ function renderSchema(schema, rootDocument, options) {
 	return renderField(tree, options.value, options.onChange ?? noop, void 0, renderChild);
 }
 function ApiOperation({ schema: doc, path, method, requestBodyValue, onRequestBodyChange, responseValue, meta, requestBodyFields }) {
-	const parsed = getParsed(toDoc(doc));
 	const rootDoc = toDoc(doc);
-	const operation = listOperations(parsed).find((op) => op.path === path && op.method === method);
-	if (operation === void 0) throw new SchemaNormalisationError(`Operation not found: ${method.toUpperCase()} ${path}`, doc, "openapi-invalid");
-	const params = getParameters(parsed, path, method);
-	const requestBody = getRequestBody(parsed, path, method);
-	const responses = getResponses(parsed, path, method);
+	const resolved = resolveOperation(rootDoc, path, method);
 	return /* @__PURE__ */ jsxs("section", {
 		"data-operation": `${method.toUpperCase()} ${path}`,
 		children: [
-			/* @__PURE__ */ jsx(OperationHeader, { operation }),
-			params.length > 0 && /* @__PURE__ */ jsxs("section", {
+			/* @__PURE__ */ jsx(OperationHeader, { operation: resolved.operation }),
+			resolved.parameters.length > 0 && /* @__PURE__ */ jsxs("section", {
 				"data-parameters": true,
 				children: [/* @__PURE__ */ jsx("h4", { children: "Parameters" }), /* @__PURE__ */ jsx(ParameterList, {
-					parameters: params,
+					parameters: resolved.parameters,
 					rootDoc,
 					meta
 				})]
 			}),
-			requestBody?.schema !== void 0 && /* @__PURE__ */ jsxs("section", {
+			resolved.requestBody?.schema !== void 0 && /* @__PURE__ */ jsxs("section", {
 				"data-request-body": true,
 				children: [
-					/* @__PURE__ */ jsxs("h4", { children: ["Request Body", requestBody.required && /* @__PURE__ */ jsx("span", {
+					/* @__PURE__ */ jsxs("h4", { children: ["Request Body", resolved.requestBody.required && /* @__PURE__ */ jsx("span", {
 						"data-required": true,
 						children: "*"
 					})] }),
-					requestBody.description && /* @__PURE__ */ jsx("p", { children: requestBody.description }),
-					requestBody.contentTypes.length > 0 && /* @__PURE__ */ jsx("span", {
+					resolved.requestBody.description && /* @__PURE__ */ jsx("p", { children: resolved.requestBody.description }),
+					resolved.requestBody.contentTypes.length > 0 && /* @__PURE__ */ jsx("span", {
 						"data-content-type": true,
-						children: requestBody.contentTypes[0]
+						children: resolved.requestBody.contentTypes[0]
 					}),
-					renderSchema(requestBody.schema, rootDoc, {
+					renderSchema(resolved.requestBody.schema, rootDoc, {
 						value: requestBodyValue,
 						onChange: onRequestBodyChange,
 						fields: requestBodyFields,
@@ -81,9 +65,9 @@ function ApiOperation({ schema: doc, path, method, requestBodyValue, onRequestBo
 					})
 				]
 			}),
-			responses.length > 0 && /* @__PURE__ */ jsxs("section", {
+			resolved.responses.length > 0 && /* @__PURE__ */ jsxs("section", {
 				"data-responses": true,
-				children: [/* @__PURE__ */ jsx("h4", { children: "Responses" }), responses.map((response) => /* @__PURE__ */ jsx(ResponseCard, {
+				children: [/* @__PURE__ */ jsx("h4", { children: "Responses" }), resolved.responses.map((response) => /* @__PURE__ */ jsx(ResponseCard, {
 					response,
 					rootDoc,
 					value: responseValue,
@@ -94,9 +78,8 @@ function ApiOperation({ schema: doc, path, method, requestBodyValue, onRequestBo
 	});
 }
 function ApiParameters({ schema: doc, path, method, meta, overrides }) {
-	const parsed = getParsed(toDoc(doc));
 	const rootDoc = toDoc(doc);
-	const params = getParameters(parsed, path, method);
+	const params = resolveParameters(rootDoc, path, method);
 	if (params.length === 0) return null;
 	return /* @__PURE__ */ jsxs("section", {
 		"data-parameters": true,
@@ -109,9 +92,8 @@ function ApiParameters({ schema: doc, path, method, meta, overrides }) {
 	});
 }
 function ApiRequestBody({ schema: doc, path, method, value, onChange, meta, fields }) {
-	const parsed = getParsed(toDoc(doc));
 	const rootDoc = toDoc(doc);
-	const requestBody = getRequestBody(parsed, path, method);
+	const requestBody = resolveRequestBody(rootDoc, path, method);
 	if (requestBody?.schema === void 0) return null;
 	return /* @__PURE__ */ jsxs("section", {
 		"data-request-body": true,
@@ -135,10 +117,8 @@ function ApiRequestBody({ schema: doc, path, method, value, onChange, meta, fiel
 	});
 }
 function ApiResponse({ schema: doc, path, method, status, value, meta, fields }) {
-	const parsed = getParsed(toDoc(doc));
 	const rootDoc = toDoc(doc);
-	const response = getResponses(parsed, path, method).find((r) => r.statusCode === status);
-	if (response === void 0) throw new SchemaNormalisationError(`Response not found: ${status}`, doc, "openapi-invalid");
+	const response = resolveResponse(rootDoc, path, method, status);
 	if (response.schema === void 0) return /* @__PURE__ */ jsxs("div", {
 		"data-status": status,
 		children: [

package/dist/openapi/resolve.d.mts

@@ -0,0 +1,42 @@
+import { OpenApiDocument, OperationInfo, ParameterInfo, ResponseInfo, getRequestBody } from "./parser.mjs";
+
+//#region src/openapi/resolve.d.ts
+/**
+ * Parse and cache an OpenAPI document. Returns cached version if
+ * the same object identity has been seen before.
+ */
+declare function getParsed(doc: Record<string, unknown>): OpenApiDocument;
+/**
+ * Coerce an unknown value to a record, returning an empty record
+ * for non-objects.
+ */
+declare function toDoc(value: unknown): Record<string, unknown>;
+interface ResolvedOperation {
+  operation: OperationInfo;
+  parameters: ParameterInfo[];
+  requestBody: ReturnType<typeof getRequestBody>;
+  responses: ResponseInfo[];
+}
+/**
+ * Resolve an operation from an OpenAPI document by path and method.
+ * Throws if the operation is not found.
+ */
+declare function resolveOperation(doc: Record<string, unknown>, path: string, method: string): ResolvedOperation;
+/**
+ * Resolve parameters for an operation. Returns empty array if none.
+ */
+declare function resolveParameters(doc: Record<string, unknown>, path: string, method: string): ParameterInfo[];
+/**
+ * Resolve request body for an operation. Returns undefined if none.
+ */
+declare function resolveRequestBody(doc: Record<string, unknown>, path: string, method: string): ReturnType<typeof getRequestBody>;
+/**
+ * Resolve a specific response by status code. Throws if not found.
+ */
+declare function resolveResponse(doc: Record<string, unknown>, path: string, method: string, statusCode: string): ResponseInfo;
+/**
+ * Resolve all responses for an operation.
+ */
+declare function resolveResponses(doc: Record<string, unknown>, path: string, method: string): ResponseInfo[];
+//#endregion
+export { ResolvedOperation, getParsed, resolveOperation, resolveParameters, resolveRequestBody, resolveResponse, resolveResponses, toDoc };

package/dist/openapi/resolve.mjs

@@ -0,0 +1,72 @@
+import { isObject } from "../core/guards.mjs";
+import { getParameters, getRequestBody, getResponses, listOperations, parseOpenApiDocument } from "./parser.mjs";
+//#region src/openapi/resolve.ts
+/**
+* OpenAPI document resolution and caching.
+*
+* Pure functions for looking up operations, parameters, request bodies,
+* and responses from parsed OpenAPI documents. Extracted from components
+* for testability without React.
+*/
+const docCache = /* @__PURE__ */ new WeakMap();
+/**
+* Parse and cache an OpenAPI document. Returns cached version if
+* the same object identity has been seen before.
+*/
+function getParsed(doc) {
+	const cached = docCache.get(doc);
+	if (cached !== void 0) return cached;
+	const parsed = parseOpenApiDocument(doc);
+	docCache.set(doc, parsed);
+	return parsed;
+}
+/**
+* Coerce an unknown value to a record, returning an empty record
+* for non-objects.
+*/
+function toDoc(value) {
+	return isObject(value) ? value : {};
+}
+/**
+* Resolve an operation from an OpenAPI document by path and method.
+* Throws if the operation is not found.
+*/
+function resolveOperation(doc, path, method) {
+	const parsed = getParsed(doc);
+	const operation = listOperations(parsed).find((op) => op.path === path && op.method === method);
+	if (operation === void 0) throw new Error(`Operation not found: ${method.toUpperCase()} ${path}`);
+	return {
+		operation,
+		parameters: getParameters(parsed, path, method),
+		requestBody: getRequestBody(parsed, path, method),
+		responses: getResponses(parsed, path, method)
+	};
+}
+/**
+* Resolve parameters for an operation. Returns empty array if none.
+*/
+function resolveParameters(doc, path, method) {
+	return getParameters(getParsed(doc), path, method);
+}
+/**
+* Resolve request body for an operation. Returns undefined if none.
+*/
+function resolveRequestBody(doc, path, method) {
+	return getRequestBody(getParsed(doc), path, method);
+}
+/**
+* Resolve a specific response by status code. Throws if not found.
+*/
+function resolveResponse(doc, path, method, statusCode) {
+	const response = getResponses(getParsed(doc), path, method).find((r) => r.statusCode === statusCode);
+	if (response === void 0) throw new Error(`Response not found: ${statusCode}`);
+	return response;
+}
+/**
+* Resolve all responses for an operation.
+*/
+function resolveResponses(doc, path, method) {
+	return getResponses(getParsed(doc), path, method);
+}
+//#endregion
+export { getParsed, resolveOperation, resolveParameters, resolveRequestBody, resolveResponse, resolveResponses, toDoc };

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "schema-components",
-    "version": "1.3.2",
+    "version": "1.3.3",
     "description": "React components that render UI from Zod schemas, JSON Schema, and OpenAPI documents",
     "type": "module",
     "main": "./dist/index.mjs",