zod-openapi 5.3.0 → 5.4.0

package/README.md

@@ -3,7 +3,7 @@
   <h1 align="center">zod-openapi</h1>
 </p>
 <p align="center">
-A TypeScript library which uses <a href="https://github.com/colinhacks/zod">Zod</a> schemas to generate OpenAPI v3.1x documentation.
+A TypeScript library which uses <a href="https://github.com/colinhacks/zod">Zod</a> schemas to generate OpenAPI v3.x documentation.
 </p>
 <div align="center">
 <a href="https://www.npmjs.com/package/zod-openapi"><img src="https://img.shields.io/npm/v/zod-openapi"/></a>
@@ -31,7 +31,9 @@ pnpm install zod zod-openapi
 
 ### `.meta()`
 
-Use the `.meta()` method to add OpenAPI metadata to a Zod schema. It accepts an object with the following options:
+Use Zod's native `.meta()` method to add OpenAPI metadata to your schemas. This library leverages Zod's built-in metadata functionality - no monkey patching or additional setup is required. Simply call `.meta()` on any Zod schema and it accepts an object with the following options:
+
+> **Note:** To get full TypeScript support for the OpenAPI-specific properties in `.meta()`, you need to import `zod-openapi` somewhere in your project. This import provides TypeScript type definitions that extend Zod's `.meta()` interface at compile-time (no runtime changes), enabling your IDE and TypeScript compiler to recognize the additional properties (like `id`, `param`, `header`, etc.). In most cases this will be done where you call `createDocument` or other zod-openapi functions.
 
 | Option     | Description                                                                                                      |
 | ---------- | ---------------------------------------------------------------------------------------------------------------- |
@@ -42,7 +44,7 @@ Use the `.meta()` method to add OpenAPI metadata to a Zod schema. It accepts an
 | `outputId` | Allows you to set a different ID for the output schema. This is useful when the input and output schemas differ. |
 | `unusedIO` | Allows you to set the `io` for an unused schema added to the components section. Defaults to `output`.           |
 
-You can also set standard OpenAPI properties directly in the `.meta()` method, such as:
+You can also set standard OpenAPI properties directly in Zod's native `.meta()` method, such as:
 
 ```typescript
 z.string().meta({
@@ -51,7 +53,7 @@ z.string().meta({
 });
 ```
 
-You can set additional metadata to the rendered schema in a few different ways. Zod's `.meta()` method allows you to directly set OpenAPI directly to the schema. However, if you wanted to override any field that Zod generates, this may not work as expected. In this case, you can use the `override` option to customize the rendered OpenAPI schema.
+You can set additional metadata to the rendered schema in a few different ways. Zod's native `.meta()` method allows you to directly set OpenAPI properties to the schema. However, if you wanted to override any field that Zod generates, this may not work as expected. In this case, you can use the `override` option to customize the rendered OpenAPI schema.
 
 eg.
 
@@ -74,7 +76,7 @@ Would render the following OpenAPI schema. Note that format is not overridden wi
 }
 ```
 
-In order to override fields which are generated by Zod or this library, you can use the `override` option in the `.meta()` method. This allows you to customize the rendered OpenAPI schema after we have both processed it.
+In order to override fields which are generated by Zod or this library, you can use the `override` option in Zod's `.meta()` method. This allows you to customize the rendered OpenAPI schema after we have both processed it.
 
 ##### override object
 

package/dist/api.cjs

@@ -1,4 +1,4 @@
-const require_components = require('./components-Ccvxvize.cjs');
+const require_components = require('./components-C8ab2kZS.cjs');
 
 exports.createComponents = require_components.createComponents;
 exports.createRegistry = require_components.createRegistry;

package/dist/api.d.cts

@@ -1,4 +1,4 @@
-import { ComponentRegistry, ZodOpenApiBaseMetadata, ZodOpenApiMetadata, ZodOpenApiOverride, ZodOpenApiOverrideContext, ZodOpenApiOverrideMeta, ZodOpenApiOverrideMetaContext, createComponents, createRegistry } from "./components-Br5MCUeG.cjs";
+import { ComponentRegistry, ZodOpenApiBaseMetadata, ZodOpenApiMetadata, ZodOpenApiOverride, ZodOpenApiOverrideContext, ZodOpenApiOverrideMeta, ZodOpenApiOverrideMetaContext, createComponents, createRegistry } from "./components-JnL0iOr_.cjs";
 import * as core from "zod/v4/core";
 import { $ZodObject, $ZodType, $ZodTypes } from "zod/v4/core";
 
@@ -8,4 +8,4 @@ declare const unwrapZodObject: (zodType: $ZodTypes, io: "input" | "output", path
 //#region src/zod.d.ts
 declare const isAnyZodType: (schema: unknown) => schema is core.$ZodTypes;
 //#endregion
-export { ComponentRegistry, ZodOpenApiBaseMetadata, ZodOpenApiMetadata, ZodOpenApiOverride, ZodOpenApiOverrideContext, ZodOpenApiOverrideMeta, ZodOpenApiOverrideMetaContext, createComponents, createRegistry, isAnyZodType, unwrapZodObject };
+export { type ComponentRegistry, ZodOpenApiBaseMetadata, ZodOpenApiMetadata, ZodOpenApiOverride, ZodOpenApiOverrideContext, ZodOpenApiOverrideMeta, ZodOpenApiOverrideMetaContext, createComponents, createRegistry, isAnyZodType, unwrapZodObject };

package/dist/api.d.ts

@@ -1,4 +1,4 @@
-import { ComponentRegistry, ZodOpenApiBaseMetadata, ZodOpenApiMetadata, ZodOpenApiOverride, ZodOpenApiOverrideContext, ZodOpenApiOverrideMeta, ZodOpenApiOverrideMetaContext, createComponents, createRegistry } from "./components-DkyUTLcs.js";
+import { ComponentRegistry, ZodOpenApiBaseMetadata, ZodOpenApiMetadata, ZodOpenApiOverride, ZodOpenApiOverrideContext, ZodOpenApiOverrideMeta, ZodOpenApiOverrideMetaContext, createComponents, createRegistry } from "./components-CXzxKPFp.js";
 import * as core from "zod/v4/core";
 import { $ZodObject, $ZodType, $ZodTypes } from "zod/v4/core";
 
@@ -8,4 +8,4 @@ declare const unwrapZodObject: (zodType: $ZodTypes, io: "input" | "output", path
 //#region src/zod.d.ts
 declare const isAnyZodType: (schema: unknown) => schema is core.$ZodTypes;
 //#endregion
-export { ComponentRegistry, ZodOpenApiBaseMetadata, ZodOpenApiMetadata, ZodOpenApiOverride, ZodOpenApiOverrideContext, ZodOpenApiOverrideMeta, ZodOpenApiOverrideMetaContext, createComponents, createRegistry, isAnyZodType, unwrapZodObject };
+export { type ComponentRegistry, ZodOpenApiBaseMetadata, ZodOpenApiMetadata, ZodOpenApiOverride, ZodOpenApiOverrideContext, ZodOpenApiOverrideMeta, ZodOpenApiOverrideMetaContext, createComponents, createRegistry, isAnyZodType, unwrapZodObject };

package/dist/api.js

@@ -1,3 +1,3 @@
-import { createComponents, createRegistry, isAnyZodType, unwrapZodObject } from "./components-BAO_3m-h.js";
+import { createComponents, createRegistry, isAnyZodType, unwrapZodObject } from "./components-D0GND9iu.js";
 
 export { createComponents, createRegistry, isAnyZodType, unwrapZodObject };

package/dist/{components-Ccvxvize.cjs → components-C8ab2kZS.cjs}

@@ -67,10 +67,9 @@ const unwrapZodObject = (zodType, io, path) => {
 	switch (def.type) {
 		case "object": return zodType;
 		case "lazy": return unwrapZodObject(def.getter(), io, path);
-		case "pipe": {
+		case "pipe":
 			if (io === "input") return unwrapZodObject(def.in, io, path);
 			return unwrapZodObject(def.out, io, path);
-		}
 	}
 	throw new Error(`Failed to unwrap ZodObject from type: ${zodType._zod.def.type} at ${path.join(" > ")}`);
 };
@@ -211,16 +210,27 @@ const createPaths = (paths, registry$1, path) => {
 	return pathsObject;
 };
 
+//#endregion
+//#region src/openapi.ts
+const openApiVersions = [
+	"3.0.0",
+	"3.0.1",
+	"3.0.2",
+	"3.0.3",
+	"3.1.0",
+	"3.1.1"
+];
+const satisfiesVersion = (test, against) => openApiVersions.indexOf(test) >= openApiVersions.indexOf(against);
+
 //#endregion
 //#region src/create/schema/override.ts
 const override = (ctx) => {
 	const def = ctx.zodSchema._zod.def;
 	switch (def.type) {
-		case "bigint": {
+		case "bigint":
 			ctx.jsonSchema.type = "integer";
 			ctx.jsonSchema.format = "int64";
 			break;
-		}
 		case "union": {
 			if ("discriminator" in def && typeof def.discriminator === "string") {
 				ctx.jsonSchema.oneOf = ctx.jsonSchema.anyOf;
@@ -253,18 +263,15 @@ const override = (ctx) => {
 			}
 			break;
 		}
-		case "date": {
+		case "date":
 			ctx.jsonSchema.type = "string";
 			break;
-		}
-		case "literal": {
+		case "literal":
 			if (def.values.includes(void 0)) break;
 			break;
-		}
-		case "undefined": {
+		case "undefined":
 			ctx.jsonSchema.not = {};
 			break;
-		}
 	}
 };
 const validate = (ctx, opts) => {
@@ -273,27 +280,23 @@ const validate = (ctx, opts) => {
 	const allowEmptySchema = opts.allowEmptySchema?.[def.type];
 	if (allowEmptySchema === true || allowEmptySchema?.[ctx.io]) return;
 	switch (def.type) {
-		case "optional": {
+		case "optional":
 			validate({
 				...ctx,
 				zodSchema: def.innerType
 			}, opts);
 			return;
-		}
 		case "any": return;
 		case "unknown": return;
-		case "pipe": {
+		case "pipe":
 			if (ctx.io === "output") throw new Error(`Zod transform found at ${ctx.path.join(" > ")} are not supported in output schemas. Please use \`.overwrite()\` or wrap the schema in a \`.pipe()\` or assign it manual metadata with \`.meta()\``);
 			return;
-		}
-		case "transform": {
+		case "transform":
 			if (ctx.io === "output") return;
 			break;
-		}
-		case "literal": {
+		case "literal":
 			if (def.values.includes(void 0)) throw new Error(`Zod literal at ${ctx.path.join(" > ")} cannot include \`undefined\` as a value. Please use \`z.undefined()\` or \`.optional()\` instead.`);
 			return;
-		}
 	}
 	throw new Error(`Zod schema of type \`${def.type}\` at ${ctx.path.join(" > ")} cannot be represented in OpenAPI. Please assign it metadata with \`.meta()\``);
 };
@@ -364,7 +367,8 @@ const createSchema = (schema, ctx = {
 		opts: {
 			...ctx.opts,
 			schemaRefPath: ctx.schemaRefPath
-		}
+		},
+		openapiVersion: ctx.openapiVersion
 	});
 	return {
 		schema: jsonSchemas.schemas.zodOpenApiCreateSchema,
@@ -423,6 +427,7 @@ const createSchemas = (schemas, ctx) => {
 		unrepresentable: "any",
 		reused: ctx.opts.reused,
 		cycles: ctx.opts.cycles,
+		target: satisfiesVersion(ctx.openapiVersion ?? "3.1.0", "3.1.0") ? void 0 : "openapi-3.0",
 		uri: (id) => id === "__shared" ? `#ZOD_OPENAPI/${id}` : `#ZOD_OPENAPI/__shared#/$defs/${id}`
 	});
 	const components = jsonSchema.schemas.__shared?.$defs ?? {};
@@ -595,6 +600,7 @@ const createRegistry = (components) => {
 				const ref = { $ref: `#/components/parameters/${id}` };
 				registry$1.components.parameters.seen.set(parameter, ref);
 				registry$1.components.parameters.ids.set(id, parameterObject);
+				if (opts?.manualId) return parameterObject;
 				return ref;
 			}
 			if (opts?.location?.name || opts?.location?.in) return parameterObject;
@@ -619,6 +625,7 @@ const createRegistry = (components) => {
 				const ref = { $ref: `#/components/headers/${id}` };
 				registry$1.components.headers.ids.set(id, headerObject);
 				registry$1.components.headers.seen.set(header, ref);
+				if (opts?.manualId) return headerObject;
 				return ref;
 			}
 			registry$1.components.headers.seen.set(header, headerObject);
@@ -641,6 +648,7 @@ const createRegistry = (components) => {
 				const ref = { $ref: `#/components/requestBodies/${id}` };
 				registry$1.components.requestBodies.ids.set(id, requestBodyObject);
 				registry$1.components.requestBodies.seen.set(requestBody, ref);
+				if (opts?.manualId) return requestBodyObject;
 				return ref;
 			}
 			registry$1.components.requestBodies.seen.set(requestBody, requestBodyObject);
@@ -672,6 +680,7 @@ const createRegistry = (components) => {
 				const ref = { $ref: `#/components/pathItems/${id}` };
 				registry$1.components.pathItems.ids.set(id, pathItemObject);
 				registry$1.components.pathItems.seen.set(pathItem, ref);
+				if (opts?.manualId) return pathItemObject;
 				return ref;
 			}
 			registry$1.components.pathItems.seen.set(pathItem, pathItemObject);
@@ -695,6 +704,7 @@ const createRegistry = (components) => {
 				const ref = { $ref: `#/components/responses/${id}` };
 				registry$1.components.responses.ids.set(id, responseObject);
 				registry$1.components.responses.seen.set(response, ref);
+				if (opts?.manualId) return responseObject;
 				return ref;
 			}
 			registry$1.components.responses.seen.set(response, responseObject);
@@ -718,6 +728,7 @@ const createRegistry = (components) => {
 				const ref = { $ref: `#/components/callbacks/${id}` };
 				registry$1.components.callbacks.ids.set(id, callbackObject);
 				registry$1.components.callbacks.seen.set(callback, ref);
+				if (opts?.manualId) return callbackObject;
 				return ref;
 			}
 			registry$1.components.callbacks.seen.set(callback, callbackObject);
@@ -734,6 +745,7 @@ const createRegistry = (components) => {
 				const ref = { $ref: `#/components/securitySchemes/${id}` };
 				registry$1.components.securitySchemes.ids.set(id, securitySchemeObject);
 				registry$1.components.securitySchemes.seen.set(securityScheme, ref);
+				if (opts?.manualId) return securitySchemeObject;
 				return ref;
 			}
 			registry$1.components.securitySchemes.seen.set(securityScheme, securitySchemeObject);
@@ -750,6 +762,7 @@ const createRegistry = (components) => {
 				const ref = { $ref: `#/components/links/${id}` };
 				registry$1.components.links.ids.set(id, linkObject);
 				registry$1.components.links.seen.set(link, ref);
+				if (opts?.manualId) return linkObject;
 				return ref;
 			}
 			registry$1.components.links.seen.set(link, linkObject);
@@ -766,6 +779,7 @@ const createRegistry = (components) => {
 				const ref = { $ref: `#/components/examples/${id}` };
 				registry$1.components.examples.ids.set(id, exampleObject);
 				registry$1.components.examples.seen.set(example, ref);
+				if (opts?.manualId) return exampleObject;
 				return ref;
 			}
 			registry$1.components.examples.seen.set(example, exampleObject);
@@ -912,16 +926,18 @@ const createManualSchemas = (registry$1) => {
 		registry$1.components.schemas.ids.set(key, schema);
 	}
 };
-const createComponents = (registry$1, opts) => {
+const createComponents = (registry$1, opts, openapiVersion) => {
 	createIOSchemas({
 		registry: registry$1,
 		io: "input",
-		opts
+		opts,
+		openapiVersion
 	});
 	createIOSchemas({
 		registry: registry$1,
 		io: "output",
-		opts
+		opts,
+		openapiVersion
 	});
 	createManualSchemas(registry$1);
 	const components = {};

package/dist/{components-Br5MCUeG.d.cts → components-CXzxKPFp.d.ts}

@@ -1,7 +1,7 @@
 import { $ZodType, $ZodTypes, JSONSchemaMeta, toJSONSchema } from "zod/v4/core";
 
 //#region src/openapi.d.ts
-declare const openApiVersions: readonly ["3.1.0", "3.1.1"];
+declare const openApiVersions: readonly ["3.0.0", "3.0.1", "3.0.2", "3.0.3", "3.1.0", "3.1.1"];
 type OpenApiVersion = (typeof openApiVersions)[number];
 //#endregion
 //#region packages/openapi3-ts/lib-types/dist/model/specification-extension.d.ts
@@ -630,6 +630,6 @@ interface ComponentRegistry {
   }) => ExampleObject | ReferenceObject;
 }
 declare const createRegistry: (components?: ZodOpenApiComponentsObject) => ComponentRegistry;
-declare const createComponents: (registry: ComponentRegistry, opts: CreateDocumentOptions) => ComponentsObject;
+declare const createComponents: (registry: ComponentRegistry, opts: CreateDocumentOptions, openapiVersion?: OpenApiVersion) => ComponentsObject;
 //#endregion
-export { BaseParameterObject, CallbackObject, CallbacksObject, ComponentRegistry, ComponentsObject, ContactObject, ContentObject, CreateDocumentOptions, DiscriminatorObject, EncodingObject, EncodingPropertyObject, ExampleObject, ExamplesObject, ExternalDocumentationObject, HeaderObject, HeadersObject, IExtensionName, IExtensionType, ISpecificationExtension, InfoObject, LicenseObject, LinkObject, LinkParametersObject, LinksObject, MediaTypeObject, OAuthFlowObject, OAuthFlowsObject, OpenAPIObject, OperationObject, ParameterLocation, ParameterObject, ParameterStyle, PathItemObject, PathObject, PathsObject, ReferenceObject, RequestBodyObject, ResponseObject, ResponsesObject, SchemaObject, SchemaObjectType, SchemasObject, ScopesObject, SecurityRequirementObject, SecuritySchemeObject, SecuritySchemeType, ServerObject, ServerVariableObject, TagObject, XmlObject, ZodObjectInput, ZodOpenApiBaseMetadata, ZodOpenApiCallbackObject, ZodOpenApiCallbacksObject, ZodOpenApiComponentsObject, ZodOpenApiContentObject, ZodOpenApiExampleObject, ZodOpenApiExamplesObject, ZodOpenApiHeaderObject, ZodOpenApiHeadersObject, ZodOpenApiLinkObject, ZodOpenApiLinksObject, ZodOpenApiMediaTypeObject, ZodOpenApiMetadata, ZodOpenApiObject, ZodOpenApiOperationObject, ZodOpenApiOverride, ZodOpenApiOverrideContext, ZodOpenApiOverrideMeta, ZodOpenApiOverrideMetaContext, ZodOpenApiParameterObject, ZodOpenApiParameters, ZodOpenApiPathItemObject, ZodOpenApiPathsObject, ZodOpenApiRequestBodyObject, ZodOpenApiResponseObject, ZodOpenApiResponsesObject, ZodOpenApiSchemaObject, ZodOpenApiSecuritySchemeObject, ZodOpenApiVersion, createComponents, createDocument, createRegistry };
+export { BaseParameterObject, CallbackObject, CallbacksObject, ComponentRegistry, ComponentsObject, ContactObject, ContentObject, CreateDocumentOptions, DiscriminatorObject, EncodingObject, EncodingPropertyObject, ExampleObject, ExamplesObject, ExternalDocumentationObject, HeaderObject, HeadersObject, IExtensionName, IExtensionType, type ISpecificationExtension, InfoObject, LicenseObject, LinkObject, LinkParametersObject, LinksObject, MediaTypeObject, OAuthFlowObject, OAuthFlowsObject, OpenAPIObject, OpenApiVersion, OperationObject, ParameterLocation, ParameterObject, ParameterStyle, PathItemObject, PathObject, PathsObject, ReferenceObject, RequestBodyObject, ResponseObject, ResponsesObject, SchemaObject, SchemaObjectType, SchemasObject, ScopesObject, SecurityRequirementObject, SecuritySchemeObject, SecuritySchemeType, ServerObject, ServerVariableObject, TagObject, XmlObject, ZodObjectInput, ZodOpenApiBaseMetadata, ZodOpenApiCallbackObject, ZodOpenApiCallbacksObject, ZodOpenApiComponentsObject, ZodOpenApiContentObject, ZodOpenApiExampleObject, ZodOpenApiExamplesObject, ZodOpenApiHeaderObject, ZodOpenApiHeadersObject, ZodOpenApiLinkObject, ZodOpenApiLinksObject, ZodOpenApiMediaTypeObject, ZodOpenApiMetadata, ZodOpenApiObject, ZodOpenApiOperationObject, ZodOpenApiOverride, ZodOpenApiOverrideContext, ZodOpenApiOverrideMeta, ZodOpenApiOverrideMetaContext, ZodOpenApiParameterObject, ZodOpenApiParameters, ZodOpenApiPathItemObject, ZodOpenApiPathsObject, ZodOpenApiRequestBodyObject, ZodOpenApiResponseObject, ZodOpenApiResponsesObject, ZodOpenApiSchemaObject, ZodOpenApiSecuritySchemeObject, ZodOpenApiVersion, createComponents, createDocument, createRegistry };

package/dist/{components-BAO_3m-h.js → components-D0GND9iu.js}

@@ -44,10 +44,9 @@ const unwrapZodObject = (zodType, io, path) => {
 	switch (def.type) {
 		case "object": return zodType;
 		case "lazy": return unwrapZodObject(def.getter(), io, path);
-		case "pipe": {
+		case "pipe":
 			if (io === "input") return unwrapZodObject(def.in, io, path);
 			return unwrapZodObject(def.out, io, path);
-		}
 	}
 	throw new Error(`Failed to unwrap ZodObject from type: ${zodType._zod.def.type} at ${path.join(" > ")}`);
 };
@@ -188,16 +187,27 @@ const createPaths = (paths, registry$1, path) => {
 	return pathsObject;
 };
 
+//#endregion
+//#region src/openapi.ts
+const openApiVersions = [
+	"3.0.0",
+	"3.0.1",
+	"3.0.2",
+	"3.0.3",
+	"3.1.0",
+	"3.1.1"
+];
+const satisfiesVersion = (test, against) => openApiVersions.indexOf(test) >= openApiVersions.indexOf(against);
+
 //#endregion
 //#region src/create/schema/override.ts
 const override = (ctx) => {
 	const def = ctx.zodSchema._zod.def;
 	switch (def.type) {
-		case "bigint": {
+		case "bigint":
 			ctx.jsonSchema.type = "integer";
 			ctx.jsonSchema.format = "int64";
 			break;
-		}
 		case "union": {
 			if ("discriminator" in def && typeof def.discriminator === "string") {
 				ctx.jsonSchema.oneOf = ctx.jsonSchema.anyOf;
@@ -230,18 +240,15 @@ const override = (ctx) => {
 			}
 			break;
 		}
-		case "date": {
+		case "date":
 			ctx.jsonSchema.type = "string";
 			break;
-		}
-		case "literal": {
+		case "literal":
 			if (def.values.includes(void 0)) break;
 			break;
-		}
-		case "undefined": {
+		case "undefined":
 			ctx.jsonSchema.not = {};
 			break;
-		}
 	}
 };
 const validate = (ctx, opts) => {
@@ -250,27 +257,23 @@ const validate = (ctx, opts) => {
 	const allowEmptySchema = opts.allowEmptySchema?.[def.type];
 	if (allowEmptySchema === true || allowEmptySchema?.[ctx.io]) return;
 	switch (def.type) {
-		case "optional": {
+		case "optional":
 			validate({
 				...ctx,
 				zodSchema: def.innerType
 			}, opts);
 			return;
-		}
 		case "any": return;
 		case "unknown": return;
-		case "pipe": {
+		case "pipe":
 			if (ctx.io === "output") throw new Error(`Zod transform found at ${ctx.path.join(" > ")} are not supported in output schemas. Please use \`.overwrite()\` or wrap the schema in a \`.pipe()\` or assign it manual metadata with \`.meta()\``);
 			return;
-		}
-		case "transform": {
+		case "transform":
 			if (ctx.io === "output") return;
 			break;
-		}
-		case "literal": {
+		case "literal":
 			if (def.values.includes(void 0)) throw new Error(`Zod literal at ${ctx.path.join(" > ")} cannot include \`undefined\` as a value. Please use \`z.undefined()\` or \`.optional()\` instead.`);
 			return;
-		}
 	}
 	throw new Error(`Zod schema of type \`${def.type}\` at ${ctx.path.join(" > ")} cannot be represented in OpenAPI. Please assign it metadata with \`.meta()\``);
 };
@@ -341,7 +344,8 @@ const createSchema = (schema, ctx = {
 		opts: {
 			...ctx.opts,
 			schemaRefPath: ctx.schemaRefPath
-		}
+		},
+		openapiVersion: ctx.openapiVersion
 	});
 	return {
 		schema: jsonSchemas.schemas.zodOpenApiCreateSchema,
@@ -400,6 +404,7 @@ const createSchemas = (schemas, ctx) => {
 		unrepresentable: "any",
 		reused: ctx.opts.reused,
 		cycles: ctx.opts.cycles,
+		target: satisfiesVersion(ctx.openapiVersion ?? "3.1.0", "3.1.0") ? void 0 : "openapi-3.0",
 		uri: (id) => id === "__shared" ? `#ZOD_OPENAPI/${id}` : `#ZOD_OPENAPI/__shared#/$defs/${id}`
 	});
 	const components = jsonSchema.schemas.__shared?.$defs ?? {};
@@ -572,6 +577,7 @@ const createRegistry = (components) => {
 				const ref = { $ref: `#/components/parameters/${id}` };
 				registry$1.components.parameters.seen.set(parameter, ref);
 				registry$1.components.parameters.ids.set(id, parameterObject);
+				if (opts?.manualId) return parameterObject;
 				return ref;
 			}
 			if (opts?.location?.name || opts?.location?.in) return parameterObject;
@@ -596,6 +602,7 @@ const createRegistry = (components) => {
 				const ref = { $ref: `#/components/headers/${id}` };
 				registry$1.components.headers.ids.set(id, headerObject);
 				registry$1.components.headers.seen.set(header, ref);
+				if (opts?.manualId) return headerObject;
 				return ref;
 			}
 			registry$1.components.headers.seen.set(header, headerObject);
@@ -618,6 +625,7 @@ const createRegistry = (components) => {
 				const ref = { $ref: `#/components/requestBodies/${id}` };
 				registry$1.components.requestBodies.ids.set(id, requestBodyObject);
 				registry$1.components.requestBodies.seen.set(requestBody, ref);
+				if (opts?.manualId) return requestBodyObject;
 				return ref;
 			}
 			registry$1.components.requestBodies.seen.set(requestBody, requestBodyObject);
@@ -649,6 +657,7 @@ const createRegistry = (components) => {
 				const ref = { $ref: `#/components/pathItems/${id}` };
 				registry$1.components.pathItems.ids.set(id, pathItemObject);
 				registry$1.components.pathItems.seen.set(pathItem, ref);
+				if (opts?.manualId) return pathItemObject;
 				return ref;
 			}
 			registry$1.components.pathItems.seen.set(pathItem, pathItemObject);
@@ -672,6 +681,7 @@ const createRegistry = (components) => {
 				const ref = { $ref: `#/components/responses/${id}` };
 				registry$1.components.responses.ids.set(id, responseObject);
 				registry$1.components.responses.seen.set(response, ref);
+				if (opts?.manualId) return responseObject;
 				return ref;
 			}
 			registry$1.components.responses.seen.set(response, responseObject);
@@ -695,6 +705,7 @@ const createRegistry = (components) => {
 				const ref = { $ref: `#/components/callbacks/${id}` };
 				registry$1.components.callbacks.ids.set(id, callbackObject);
 				registry$1.components.callbacks.seen.set(callback, ref);
+				if (opts?.manualId) return callbackObject;
 				return ref;
 			}
 			registry$1.components.callbacks.seen.set(callback, callbackObject);
@@ -711,6 +722,7 @@ const createRegistry = (components) => {
 				const ref = { $ref: `#/components/securitySchemes/${id}` };
 				registry$1.components.securitySchemes.ids.set(id, securitySchemeObject);
 				registry$1.components.securitySchemes.seen.set(securityScheme, ref);
+				if (opts?.manualId) return securitySchemeObject;
 				return ref;
 			}
 			registry$1.components.securitySchemes.seen.set(securityScheme, securitySchemeObject);
@@ -727,6 +739,7 @@ const createRegistry = (components) => {
 				const ref = { $ref: `#/components/links/${id}` };
 				registry$1.components.links.ids.set(id, linkObject);
 				registry$1.components.links.seen.set(link, ref);
+				if (opts?.manualId) return linkObject;
 				return ref;
 			}
 			registry$1.components.links.seen.set(link, linkObject);
@@ -743,6 +756,7 @@ const createRegistry = (components) => {
 				const ref = { $ref: `#/components/examples/${id}` };
 				registry$1.components.examples.ids.set(id, exampleObject);
 				registry$1.components.examples.seen.set(example, ref);
+				if (opts?.manualId) return exampleObject;
 				return ref;
 			}
 			registry$1.components.examples.seen.set(example, exampleObject);
@@ -889,16 +903,18 @@ const createManualSchemas = (registry$1) => {
 		registry$1.components.schemas.ids.set(key, schema);
 	}
 };
-const createComponents = (registry$1, opts) => {
+const createComponents = (registry$1, opts, openapiVersion) => {
 	createIOSchemas({
 		registry: registry$1,
 		io: "input",
-		opts
+		opts,
+		openapiVersion
 	});
 	createIOSchemas({
 		registry: registry$1,
 		io: "output",
-		opts
+		opts,
+		openapiVersion
 	});
 	createManualSchemas(registry$1);
 	const components = {};

package/dist/{components-DkyUTLcs.d.ts → components-JnL0iOr_.d.cts}

@@ -1,7 +1,7 @@
 import { $ZodType, $ZodTypes, JSONSchemaMeta, toJSONSchema } from "zod/v4/core";
 
 //#region src/openapi.d.ts
-declare const openApiVersions: readonly ["3.1.0", "3.1.1"];
+declare const openApiVersions: readonly ["3.0.0", "3.0.1", "3.0.2", "3.0.3", "3.1.0", "3.1.1"];
 type OpenApiVersion = (typeof openApiVersions)[number];
 //#endregion
 //#region packages/openapi3-ts/lib-types/dist/model/specification-extension.d.ts
@@ -630,6 +630,6 @@ interface ComponentRegistry {
   }) => ExampleObject | ReferenceObject;
 }
 declare const createRegistry: (components?: ZodOpenApiComponentsObject) => ComponentRegistry;
-declare const createComponents: (registry: ComponentRegistry, opts: CreateDocumentOptions) => ComponentsObject;
+declare const createComponents: (registry: ComponentRegistry, opts: CreateDocumentOptions, openapiVersion?: OpenApiVersion) => ComponentsObject;
 //#endregion
-export { BaseParameterObject, CallbackObject, CallbacksObject, ComponentRegistry, ComponentsObject, ContactObject, ContentObject, CreateDocumentOptions, DiscriminatorObject, EncodingObject, EncodingPropertyObject, ExampleObject, ExamplesObject, ExternalDocumentationObject, HeaderObject, HeadersObject, IExtensionName, IExtensionType, ISpecificationExtension, InfoObject, LicenseObject, LinkObject, LinkParametersObject, LinksObject, MediaTypeObject, OAuthFlowObject, OAuthFlowsObject, OpenAPIObject, OperationObject, ParameterLocation, ParameterObject, ParameterStyle, PathItemObject, PathObject, PathsObject, ReferenceObject, RequestBodyObject, ResponseObject, ResponsesObject, SchemaObject, SchemaObjectType, SchemasObject, ScopesObject, SecurityRequirementObject, SecuritySchemeObject, SecuritySchemeType, ServerObject, ServerVariableObject, TagObject, XmlObject, ZodObjectInput, ZodOpenApiBaseMetadata, ZodOpenApiCallbackObject, ZodOpenApiCallbacksObject, ZodOpenApiComponentsObject, ZodOpenApiContentObject, ZodOpenApiExampleObject, ZodOpenApiExamplesObject, ZodOpenApiHeaderObject, ZodOpenApiHeadersObject, ZodOpenApiLinkObject, ZodOpenApiLinksObject, ZodOpenApiMediaTypeObject, ZodOpenApiMetadata, ZodOpenApiObject, ZodOpenApiOperationObject, ZodOpenApiOverride, ZodOpenApiOverrideContext, ZodOpenApiOverrideMeta, ZodOpenApiOverrideMetaContext, ZodOpenApiParameterObject, ZodOpenApiParameters, ZodOpenApiPathItemObject, ZodOpenApiPathsObject, ZodOpenApiRequestBodyObject, ZodOpenApiResponseObject, ZodOpenApiResponsesObject, ZodOpenApiSchemaObject, ZodOpenApiSecuritySchemeObject, ZodOpenApiVersion, createComponents, createDocument, createRegistry };
+export { BaseParameterObject, CallbackObject, CallbacksObject, ComponentRegistry, ComponentsObject, ContactObject, ContentObject, CreateDocumentOptions, DiscriminatorObject, EncodingObject, EncodingPropertyObject, ExampleObject, ExamplesObject, ExternalDocumentationObject, HeaderObject, HeadersObject, IExtensionName, IExtensionType, type ISpecificationExtension, InfoObject, LicenseObject, LinkObject, LinkParametersObject, LinksObject, MediaTypeObject, OAuthFlowObject, OAuthFlowsObject, OpenAPIObject, OpenApiVersion, OperationObject, ParameterLocation, ParameterObject, ParameterStyle, PathItemObject, PathObject, PathsObject, ReferenceObject, RequestBodyObject, ResponseObject, ResponsesObject, SchemaObject, SchemaObjectType, SchemasObject, ScopesObject, SecurityRequirementObject, SecuritySchemeObject, SecuritySchemeType, ServerObject, ServerVariableObject, TagObject, XmlObject, ZodObjectInput, ZodOpenApiBaseMetadata, ZodOpenApiCallbackObject, ZodOpenApiCallbacksObject, ZodOpenApiComponentsObject, ZodOpenApiContentObject, ZodOpenApiExampleObject, ZodOpenApiExamplesObject, ZodOpenApiHeaderObject, ZodOpenApiHeadersObject, ZodOpenApiLinkObject, ZodOpenApiLinksObject, ZodOpenApiMediaTypeObject, ZodOpenApiMetadata, ZodOpenApiObject, ZodOpenApiOperationObject, ZodOpenApiOverride, ZodOpenApiOverrideContext, ZodOpenApiOverrideMeta, ZodOpenApiOverrideMetaContext, ZodOpenApiParameterObject, ZodOpenApiParameters, ZodOpenApiPathItemObject, ZodOpenApiPathsObject, ZodOpenApiRequestBodyObject, ZodOpenApiResponseObject, ZodOpenApiResponsesObject, ZodOpenApiSchemaObject, ZodOpenApiSecuritySchemeObject, ZodOpenApiVersion, createComponents, createDocument, createRegistry };

package/dist/index.cjs

@@ -1,4 +1,4 @@
-const require_components = require('./components-Ccvxvize.cjs');
+const require_components = require('./components-C8ab2kZS.cjs');
 
 //#region src/create/document.ts
 const createDocument = (zodOpenApiObject, opts = {}) => {
@@ -9,7 +9,7 @@ const createDocument = (zodOpenApiObject, opts = {}) => {
 	if (createdPaths) document.paths = createdPaths;
 	const createdWebhooks = require_components.createPaths(webhooks, registry, ["webhooks"]);
 	if (createdWebhooks) document.webhooks = createdWebhooks;
-	const createdComponents = require_components.createComponents(registry, opts);
+	const createdComponents = require_components.createComponents(registry, opts, zodOpenApiObject.openapi);
 	if (Object.keys(createdComponents).length > 0) document.components = createdComponents;
 	return document;
 };

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import { BaseParameterObject, CallbackObject, CallbacksObject, ComponentRegistry, ComponentsObject, ContactObject, ContentObject, CreateDocumentOptions, DiscriminatorObject, EncodingObject, EncodingPropertyObject, ExampleObject, ExamplesObject, ExternalDocumentationObject, HeaderObject, HeadersObject, IExtensionName, IExtensionType, ISpecificationExtension, InfoObject, LicenseObject, LinkObject, LinkParametersObject, LinksObject, MediaTypeObject, OAuthFlowObject, OAuthFlowsObject, OpenAPIObject, OperationObject, ParameterLocation, ParameterObject, ParameterStyle, PathItemObject, PathObject, PathsObject, ReferenceObject, RequestBodyObject, ResponseObject, ResponsesObject, SchemaObject, SchemaObjectType, SchemasObject, ScopesObject, SecurityRequirementObject, SecuritySchemeObject, SecuritySchemeType, ServerObject, ServerVariableObject, TagObject, XmlObject, ZodObjectInput, ZodOpenApiBaseMetadata, ZodOpenApiCallbackObject, ZodOpenApiCallbacksObject, ZodOpenApiComponentsObject, ZodOpenApiContentObject, ZodOpenApiExampleObject, ZodOpenApiExamplesObject, ZodOpenApiHeaderObject, ZodOpenApiHeadersObject, ZodOpenApiLinkObject, ZodOpenApiLinksObject, ZodOpenApiMediaTypeObject, ZodOpenApiMetadata, ZodOpenApiObject, ZodOpenApiOperationObject, ZodOpenApiOverride, ZodOpenApiOverrideContext, ZodOpenApiOverrideMeta, ZodOpenApiOverrideMetaContext, ZodOpenApiParameterObject, ZodOpenApiParameters, ZodOpenApiPathItemObject, ZodOpenApiPathsObject, ZodOpenApiRequestBodyObject, ZodOpenApiResponseObject, ZodOpenApiResponsesObject, ZodOpenApiSchemaObject, ZodOpenApiSecuritySchemeObject, ZodOpenApiVersion, createDocument } from "./components-Br5MCUeG.cjs";
+import { BaseParameterObject, CallbackObject, CallbacksObject, ComponentRegistry, ComponentsObject, ContactObject, ContentObject, CreateDocumentOptions, DiscriminatorObject, EncodingObject, EncodingPropertyObject, ExampleObject, ExamplesObject, ExternalDocumentationObject, HeaderObject, HeadersObject, IExtensionName, IExtensionType, ISpecificationExtension, InfoObject, LicenseObject, LinkObject, LinkParametersObject, LinksObject, MediaTypeObject, OAuthFlowObject, OAuthFlowsObject, OpenAPIObject, OpenApiVersion, OperationObject, ParameterLocation, ParameterObject, ParameterStyle, PathItemObject, PathObject, PathsObject, ReferenceObject, RequestBodyObject, ResponseObject, ResponsesObject, SchemaObject, SchemaObjectType, SchemasObject, ScopesObject, SecurityRequirementObject, SecuritySchemeObject, SecuritySchemeType, ServerObject, ServerVariableObject, TagObject, XmlObject, ZodObjectInput, ZodOpenApiBaseMetadata, ZodOpenApiCallbackObject, ZodOpenApiCallbacksObject, ZodOpenApiComponentsObject, ZodOpenApiContentObject, ZodOpenApiExampleObject, ZodOpenApiExamplesObject, ZodOpenApiHeaderObject, ZodOpenApiHeadersObject, ZodOpenApiLinkObject, ZodOpenApiLinksObject, ZodOpenApiMediaTypeObject, ZodOpenApiMetadata, ZodOpenApiObject, ZodOpenApiOperationObject, ZodOpenApiOverride, ZodOpenApiOverrideContext, ZodOpenApiOverrideMeta, ZodOpenApiOverrideMetaContext, ZodOpenApiParameterObject, ZodOpenApiParameters, ZodOpenApiPathItemObject, ZodOpenApiPathsObject, ZodOpenApiRequestBodyObject, ZodOpenApiResponseObject, ZodOpenApiResponsesObject, ZodOpenApiSchemaObject, ZodOpenApiSecuritySchemeObject, ZodOpenApiVersion, createDocument } from "./components-JnL0iOr_.cjs";
 import * as core from "zod/v4/core";
 
 //#region rolldown:runtime
@@ -23,9 +23,10 @@ declare const createSchema: (schema: core.$ZodType, ctx?: {
    * The $ref path to use for a schema component. Defaults to `#/components/schemas/`
    */
   schemaRefPath?: string;
+  openapiVersion?: OpenApiVersion;
 }) => {
   schema: SchemaObject | ReferenceObject;
   components: Record<string, SchemaObject>;
 };
 //#endregion
-export { CreateDocumentOptions, SchemaResult, ZodObjectInput, ZodOpenApiBaseMetadata, ZodOpenApiCallbackObject, ZodOpenApiCallbacksObject, ZodOpenApiComponentsObject, ZodOpenApiContentObject, ZodOpenApiExampleObject, ZodOpenApiExamplesObject, ZodOpenApiHeaderObject, ZodOpenApiHeadersObject, ZodOpenApiLinkObject, ZodOpenApiLinksObject, ZodOpenApiMediaTypeObject, ZodOpenApiMetadata, ZodOpenApiObject, ZodOpenApiOperationObject, ZodOpenApiOverride, ZodOpenApiOverrideContext, ZodOpenApiOverrideMeta, ZodOpenApiOverrideMetaContext, ZodOpenApiParameterObject, ZodOpenApiParameters, ZodOpenApiPathItemObject, ZodOpenApiPathsObject, ZodOpenApiRequestBodyObject, ZodOpenApiResponseObject, ZodOpenApiResponsesObject, ZodOpenApiSchemaObject, ZodOpenApiSecuritySchemeObject, ZodOpenApiVersion, createDocument, createSchema, oas31_d_exports as oas31 };
+export { CreateDocumentOptions, type SchemaResult, ZodObjectInput, ZodOpenApiBaseMetadata, ZodOpenApiCallbackObject, ZodOpenApiCallbacksObject, ZodOpenApiComponentsObject, ZodOpenApiContentObject, ZodOpenApiExampleObject, ZodOpenApiExamplesObject, ZodOpenApiHeaderObject, ZodOpenApiHeadersObject, ZodOpenApiLinkObject, ZodOpenApiLinksObject, ZodOpenApiMediaTypeObject, ZodOpenApiMetadata, ZodOpenApiObject, ZodOpenApiOperationObject, ZodOpenApiOverride, ZodOpenApiOverrideContext, ZodOpenApiOverrideMeta, ZodOpenApiOverrideMetaContext, ZodOpenApiParameterObject, ZodOpenApiParameters, ZodOpenApiPathItemObject, ZodOpenApiPathsObject, ZodOpenApiRequestBodyObject, ZodOpenApiResponseObject, ZodOpenApiResponsesObject, ZodOpenApiSchemaObject, ZodOpenApiSecuritySchemeObject, ZodOpenApiVersion, createDocument, createSchema, oas31_d_exports as oas31 };

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { BaseParameterObject, CallbackObject, CallbacksObject, ComponentRegistry, ComponentsObject, ContactObject, ContentObject, CreateDocumentOptions, DiscriminatorObject, EncodingObject, EncodingPropertyObject, ExampleObject, ExamplesObject, ExternalDocumentationObject, HeaderObject, HeadersObject, IExtensionName, IExtensionType, ISpecificationExtension, InfoObject, LicenseObject, LinkObject, LinkParametersObject, LinksObject, MediaTypeObject, OAuthFlowObject, OAuthFlowsObject, OpenAPIObject, OperationObject, ParameterLocation, ParameterObject, ParameterStyle, PathItemObject, PathObject, PathsObject, ReferenceObject, RequestBodyObject, ResponseObject, ResponsesObject, SchemaObject, SchemaObjectType, SchemasObject, ScopesObject, SecurityRequirementObject, SecuritySchemeObject, SecuritySchemeType, ServerObject, ServerVariableObject, TagObject, XmlObject, ZodObjectInput, ZodOpenApiBaseMetadata, ZodOpenApiCallbackObject, ZodOpenApiCallbacksObject, ZodOpenApiComponentsObject, ZodOpenApiContentObject, ZodOpenApiExampleObject, ZodOpenApiExamplesObject, ZodOpenApiHeaderObject, ZodOpenApiHeadersObject, ZodOpenApiLinkObject, ZodOpenApiLinksObject, ZodOpenApiMediaTypeObject, ZodOpenApiMetadata, ZodOpenApiObject, ZodOpenApiOperationObject, ZodOpenApiOverride, ZodOpenApiOverrideContext, ZodOpenApiOverrideMeta, ZodOpenApiOverrideMetaContext, ZodOpenApiParameterObject, ZodOpenApiParameters, ZodOpenApiPathItemObject, ZodOpenApiPathsObject, ZodOpenApiRequestBodyObject, ZodOpenApiResponseObject, ZodOpenApiResponsesObject, ZodOpenApiSchemaObject, ZodOpenApiSecuritySchemeObject, ZodOpenApiVersion, createDocument } from "./components-DkyUTLcs.js";
+import { BaseParameterObject, CallbackObject, CallbacksObject, ComponentRegistry, ComponentsObject, ContactObject, ContentObject, CreateDocumentOptions, DiscriminatorObject, EncodingObject, EncodingPropertyObject, ExampleObject, ExamplesObject, ExternalDocumentationObject, HeaderObject, HeadersObject, IExtensionName, IExtensionType, ISpecificationExtension, InfoObject, LicenseObject, LinkObject, LinkParametersObject, LinksObject, MediaTypeObject, OAuthFlowObject, OAuthFlowsObject, OpenAPIObject, OpenApiVersion, OperationObject, ParameterLocation, ParameterObject, ParameterStyle, PathItemObject, PathObject, PathsObject, ReferenceObject, RequestBodyObject, ResponseObject, ResponsesObject, SchemaObject, SchemaObjectType, SchemasObject, ScopesObject, SecurityRequirementObject, SecuritySchemeObject, SecuritySchemeType, ServerObject, ServerVariableObject, TagObject, XmlObject, ZodObjectInput, ZodOpenApiBaseMetadata, ZodOpenApiCallbackObject, ZodOpenApiCallbacksObject, ZodOpenApiComponentsObject, ZodOpenApiContentObject, ZodOpenApiExampleObject, ZodOpenApiExamplesObject, ZodOpenApiHeaderObject, ZodOpenApiHeadersObject, ZodOpenApiLinkObject, ZodOpenApiLinksObject, ZodOpenApiMediaTypeObject, ZodOpenApiMetadata, ZodOpenApiObject, ZodOpenApiOperationObject, ZodOpenApiOverride, ZodOpenApiOverrideContext, ZodOpenApiOverrideMeta, ZodOpenApiOverrideMetaContext, ZodOpenApiParameterObject, ZodOpenApiParameters, ZodOpenApiPathItemObject, ZodOpenApiPathsObject, ZodOpenApiRequestBodyObject, ZodOpenApiResponseObject, ZodOpenApiResponsesObject, ZodOpenApiSchemaObject, ZodOpenApiSecuritySchemeObject, ZodOpenApiVersion, createDocument } from "./components-CXzxKPFp.js";
 import * as core from "zod/v4/core";
 
 //#region rolldown:runtime
@@ -23,9 +23,10 @@ declare const createSchema: (schema: core.$ZodType, ctx?: {
    * The $ref path to use for a schema component. Defaults to `#/components/schemas/`
    */
   schemaRefPath?: string;
+  openapiVersion?: OpenApiVersion;
 }) => {
   schema: SchemaObject | ReferenceObject;
   components: Record<string, SchemaObject>;
 };
 //#endregion
-export { CreateDocumentOptions, SchemaResult, ZodObjectInput, ZodOpenApiBaseMetadata, ZodOpenApiCallbackObject, ZodOpenApiCallbacksObject, ZodOpenApiComponentsObject, ZodOpenApiContentObject, ZodOpenApiExampleObject, ZodOpenApiExamplesObject, ZodOpenApiHeaderObject, ZodOpenApiHeadersObject, ZodOpenApiLinkObject, ZodOpenApiLinksObject, ZodOpenApiMediaTypeObject, ZodOpenApiMetadata, ZodOpenApiObject, ZodOpenApiOperationObject, ZodOpenApiOverride, ZodOpenApiOverrideContext, ZodOpenApiOverrideMeta, ZodOpenApiOverrideMetaContext, ZodOpenApiParameterObject, ZodOpenApiParameters, ZodOpenApiPathItemObject, ZodOpenApiPathsObject, ZodOpenApiRequestBodyObject, ZodOpenApiResponseObject, ZodOpenApiResponsesObject, ZodOpenApiSchemaObject, ZodOpenApiSecuritySchemeObject, ZodOpenApiVersion, createDocument, createSchema, oas31_d_exports as oas31 };
+export { CreateDocumentOptions, type SchemaResult, ZodObjectInput, ZodOpenApiBaseMetadata, ZodOpenApiCallbackObject, ZodOpenApiCallbacksObject, ZodOpenApiComponentsObject, ZodOpenApiContentObject, ZodOpenApiExampleObject, ZodOpenApiExamplesObject, ZodOpenApiHeaderObject, ZodOpenApiHeadersObject, ZodOpenApiLinkObject, ZodOpenApiLinksObject, ZodOpenApiMediaTypeObject, ZodOpenApiMetadata, ZodOpenApiObject, ZodOpenApiOperationObject, ZodOpenApiOverride, ZodOpenApiOverrideContext, ZodOpenApiOverrideMeta, ZodOpenApiOverrideMetaContext, ZodOpenApiParameterObject, ZodOpenApiParameters, ZodOpenApiPathItemObject, ZodOpenApiPathsObject, ZodOpenApiRequestBodyObject, ZodOpenApiResponseObject, ZodOpenApiResponsesObject, ZodOpenApiSchemaObject, ZodOpenApiSecuritySchemeObject, ZodOpenApiVersion, createDocument, createSchema, oas31_d_exports as oas31 };

package/dist/index.js

@@ -1,4 +1,4 @@
-import { createComponents, createPaths, createRegistry, createSchema } from "./components-BAO_3m-h.js";
+import { createComponents, createPaths, createRegistry, createSchema } from "./components-D0GND9iu.js";
 
 //#region src/create/document.ts
 const createDocument = (zodOpenApiObject, opts = {}) => {
@@ -9,7 +9,7 @@ const createDocument = (zodOpenApiObject, opts = {}) => {
 	if (createdPaths) document.paths = createdPaths;
 	const createdWebhooks = createPaths(webhooks, registry, ["webhooks"]);
 	if (createdWebhooks) document.webhooks = createdWebhooks;
-	const createdComponents = createComponents(registry, opts);
+	const createdComponents = createComponents(registry, opts, zodOpenApiObject.openapi);
 	if (Object.keys(createdComponents).length > 0) document.components = createdComponents;
 	return document;
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zod-openapi",
-  "version": "5.3.0",
+  "version": "5.4.0",
   "description": "Convert Zod Schemas to OpenAPI v3.x documentation",
   "keywords": [
     "typescript",
@@ -44,19 +44,19 @@
   "devDependencies": {
     "@arethetypeswrong/cli": "0.18.2",
     "@changesets/changelog-github": "0.5.1",
-    "@changesets/cli": "2.29.5",
-    "@redocly/cli": "1.34.4",
+    "@changesets/cli": "2.29.6",
+    "@redocly/cli": "2.0.2",
     "@types/node": "22.15.21",
     "@vitest/coverage-v8": "3.2.4",
     "@zod-openapi/openapi3-ts": "1.0.0",
     "ajv": "8.17.1",
-    "eslint-plugin-import-zod": "1.1.1",
+    "eslint-plugin-import-zod": "1.2.0",
     "eslint-plugin-zod-openapi": "2.0.0",
-    "skuba": "12.0.2",
-    "tsdown": "0.12.9",
+    "skuba": "12.1.1",
+    "tsdown": "0.14.0",
     "vitest": "3.2.4",
-    "yaml": "2.8.0",
-    "zod": "4.0.5"
+    "yaml": "2.8.1",
+    "zod": "4.1.1"
   },
   "peerDependencies": {
     "zod": "^3.25.74 || ^4.0.0"
@@ -72,7 +72,7 @@
     "entryPoint": "src/index.ts",
     "template": "oss-npm-package",
     "type": "package",
-    "version": "11.0.0"
+    "version": "12.1.1"
   },
   "scripts": {
     "build": "pnpm -r build && tsdown",