zod-openapi 5.3.1 → 5.4.1

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>

package/dist/api.cjs

@@ -1,4 +1,4 @@
-const require_components = require('./components-Bgg6LgwE.cjs');
+const require_components = require('./components-y0WDbAMK.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-CJtL_UCT.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";
 

package/dist/api.d.ts

@@ -1,4 +1,4 @@
-import { ComponentRegistry, ZodOpenApiBaseMetadata, ZodOpenApiMetadata, ZodOpenApiOverride, ZodOpenApiOverrideContext, ZodOpenApiOverrideMeta, ZodOpenApiOverrideMetaContext, createComponents, createRegistry } from "./components-BYHzS0hV.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";
 

package/dist/api.js

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

package/dist/{components-BYHzS0hV.d.ts → 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, type 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-B6MpvUFu.js → components-DTiQQs5D.js}

@@ -1,5 +1,5 @@
 import { globalRegistry } from "zod/v4/core";
-import { object, registry, toJSONSchema as toJSONSchema$1 } from "zod/v4";
+import { globalRegistry as globalRegistry$1, object, registry, toJSONSchema as toJSONSchema$1 } from "zod/v4";
 
 //#region src/zod.ts
 const isAnyZodType = (schema) => typeof schema === "object" && schema !== null && "_zod" in schema;
@@ -187,6 +187,18 @@ 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) => {
@@ -218,7 +230,7 @@ const override = (ctx) => {
 				}
 				ctx.jsonSchema.discriminator.mapping = mapping;
 			}
-			const meta = ctx.zodSchema.meta();
+			const meta = globalRegistry$1.get(ctx.zodSchema);
 			if (typeof meta?.unionOneOf === "boolean") {
 				if (meta.unionOneOf) {
 					ctx.jsonSchema.oneOf = ctx.jsonSchema.anyOf;
@@ -332,7 +344,8 @@ const createSchema = (schema, ctx = {
 		opts: {
 			...ctx.opts,
 			schemaRefPath: ctx.schemaRefPath
-		}
+		},
+		openapiVersion: ctx.openapiVersion
 	});
 	return {
 		schema: jsonSchemas.schemas.zodOpenApiCreateSchema,
@@ -366,7 +379,7 @@ const createSchemas = (schemas, ctx) => {
 	const outputIds = /* @__PURE__ */ new Map();
 	const jsonSchema = toJSONSchema$1(zodRegistry, {
 		override(context) {
-			const meta = context.zodSchema.meta();
+			const meta = globalRegistry$1.get(context.zodSchema);
 			if (meta?.outputId && meta?.id) outputIds.set(meta.id, meta.outputId);
 			if (context.jsonSchema.$ref) return;
 			const enrichedContext = {
@@ -391,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 ?? {};
@@ -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-CJtL_UCT.d.cts → 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, type 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-Bgg6LgwE.cjs → components-y0WDbAMK.cjs}

@@ -21,8 +21,10 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 }) : target, mod));
 
 //#endregion
-const zod_v4_core = __toESM(require("zod/v4/core"));
-const zod_v4 = __toESM(require("zod/v4"));
+let zod_v4_core = require("zod/v4/core");
+zod_v4_core = __toESM(zod_v4_core);
+let zod_v4 = require("zod/v4");
+zod_v4 = __toESM(zod_v4);
 
 //#region src/zod.ts
 const isAnyZodType = (schema) => typeof schema === "object" && schema !== null && "_zod" in schema;
@@ -210,6 +212,18 @@ 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) => {
@@ -241,7 +255,7 @@ const override = (ctx) => {
 				}
 				ctx.jsonSchema.discriminator.mapping = mapping;
 			}
-			const meta = ctx.zodSchema.meta();
+			const meta = zod_v4.globalRegistry.get(ctx.zodSchema);
 			if (typeof meta?.unionOneOf === "boolean") {
 				if (meta.unionOneOf) {
 					ctx.jsonSchema.oneOf = ctx.jsonSchema.anyOf;
@@ -355,7 +369,8 @@ const createSchema = (schema, ctx = {
 		opts: {
 			...ctx.opts,
 			schemaRefPath: ctx.schemaRefPath
-		}
+		},
+		openapiVersion: ctx.openapiVersion
 	});
 	return {
 		schema: jsonSchemas.schemas.zodOpenApiCreateSchema,
@@ -389,7 +404,7 @@ const createSchemas = (schemas, ctx) => {
 	const outputIds = /* @__PURE__ */ new Map();
 	const jsonSchema = (0, zod_v4.toJSONSchema)(zodRegistry, {
 		override(context) {
-			const meta = context.zodSchema.meta();
+			const meta = zod_v4.globalRegistry.get(context.zodSchema);
 			if (meta?.outputId && meta?.id) outputIds.set(meta.id, meta.outputId);
 			if (context.jsonSchema.$ref) return;
 			const enrichedContext = {
@@ -414,6 +429,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 ?? {};
@@ -912,16 +928,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/index.cjs

@@ -1,4 +1,4 @@
-const require_components = require('./components-Bgg6LgwE.cjs');
+const require_components = require('./components-y0WDbAMK.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-CJtL_UCT.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,6 +23,7 @@ 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>;

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-BYHzS0hV.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,6 +23,7 @@ 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>;

package/dist/index.js

@@ -1,4 +1,4 @@
-import { createComponents, createPaths, createRegistry, createSchema } from "./components-B6MpvUFu.js";
+import { createComponents, createPaths, createRegistry, createSchema } from "./components-DTiQQs5D.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.1",
+  "version": "5.4.1",
   "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": "2.0.2",
+    "@changesets/cli": "2.29.6",
+    "@redocly/cli": "2.0.8",
     "@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.2.0",
     "eslint-plugin-zod-openapi": "2.0.0",
-    "skuba": "12.0.2",
-    "tsdown": "0.13.2",
+    "skuba": "12.2.0",
+    "tsdown": "0.14.2",
     "vitest": "3.2.4",
-    "yaml": "2.8.0",
-    "zod": "4.0.14"
+    "yaml": "2.8.1",
+    "zod": "4.1.5"
   },
   "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",