zod-openapi 5.2.0 → 5.3.1

package/README.md

@@ -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
 
@@ -109,6 +111,8 @@ Generates an OpenAPI documentation object.
 
 ```typescript
 import * as z from 'zod/v4';
+// or import * as z from 'zod'; if using Zod 4.0.0+
+
 import { createDocument } from 'zod-openapi';
 
 const jobId = z.string().meta({

package/api/index.d.cts

@@ -0,0 +1 @@
+export * from '../dist/api.cjs';

package/api/index.d.ts

@@ -1 +1 @@
-export * from '../dist/api';
+export * from '../dist/api.js';

package/api/package.json

@@ -1,5 +1,5 @@
 {
-  "main": "../dist/api.js",
-  "module": "../dist/api.mjs",
-  "types": "./index.d.ts"
+  "main": "../dist/api.cjs",
+  "module": "../dist/api.js",
+  "types": "./index.d.cts"
 }

package/dist/api.cjs

@@ -0,0 +1,6 @@
+const require_components = require('./components-Bgg6LgwE.cjs');
+
+exports.createComponents = require_components.createComponents;
+exports.createRegistry = require_components.createRegistry;
+exports.isAnyZodType = require_components.isAnyZodType;
+exports.unwrapZodObject = require_components.unwrapZodObject;

package/dist/api.d.cts

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

package/dist/api.d.ts

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

package/dist/api.js

@@ -1,6 +1,3 @@
-const require_components = require('./components-BAZgpKwe.js');
+import { createComponents, createRegistry, isAnyZodType, unwrapZodObject } from "./components-B6MpvUFu.js";
 
-exports.createComponents = require_components.createComponents;
-exports.createRegistry = require_components.createRegistry;
-exports.isAnyZodType = require_components.isAnyZodType;
-exports.unwrapZodObject = require_components.unwrapZodObject;
+export { createComponents, createRegistry, isAnyZodType, unwrapZodObject };

package/dist/{components-DPhhXqww.mjs → components-B6MpvUFu.js}

@@ -1,5 +1,5 @@
 import { globalRegistry } from "zod/v4/core";
-import { object, registry, toJSONSchema } from "zod/v4";
+import { object, registry, toJSONSchema as toJSONSchema$1 } from "zod/v4";
 
 //#region src/zod.ts
 const isAnyZodType = (schema) => typeof schema === "object" && schema !== null && "_zod" in schema;
@@ -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(" > ")}`);
 };
@@ -193,11 +192,10 @@ const createPaths = (paths, registry$1, path) => {
 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 +228,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 +245,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()\``);
 };
@@ -373,7 +364,7 @@ const createSchemas = (schemas, ctx) => {
 	zodRegistry.add(object(entries), { id: "zodOpenApiCreateSchema" });
 	for (const [id, { zodType }] of ctx.registry.components.schemas.manual) zodRegistry.add(zodType, { id });
 	const outputIds = /* @__PURE__ */ new Map();
-	const jsonSchema = toJSONSchema(zodRegistry, {
+	const jsonSchema = toJSONSchema$1(zodRegistry, {
 		override(context) {
 			const meta = context.zodSchema.meta();
 			if (meta?.outputId && meta?.id) outputIds.set(meta.id, meta.outputId);
@@ -572,6 +563,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 +588,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 +611,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 +643,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 +667,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 +691,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 +708,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 +725,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 +742,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);

package/dist/{components-Ddt0DmKC.d.ts → components-BYHzS0hV.d.ts}

@@ -1,14 +1,17 @@
-import * as core from "zod/v4/core";
-import { $ZodType, $ZodTypes } from "zod/v4/core";
+import { $ZodType, $ZodTypes, JSONSchemaMeta, toJSONSchema } from "zod/v4/core";
 
-//#region src/openapi3-ts/dist/model/specification-extension.d.ts
+//#region src/openapi.d.ts
+declare const openApiVersions: readonly ["3.1.0", "3.1.1"];
+type OpenApiVersion = (typeof openApiVersions)[number];
+//#endregion
+//#region packages/openapi3-ts/lib-types/dist/model/specification-extension.d.ts
 type IExtensionName = `x-${string}`;
 type IExtensionType = any;
 type ISpecificationExtension = {
   [extensionName: IExtensionName]: IExtensionType;
 };
 //#endregion
-//#region src/openapi3-ts/dist/model/oas-common.d.ts
+//#region packages/openapi3-ts/lib-types/dist/model/oas-common.d.ts
 interface ServerObject extends ISpecificationExtension {
   url: string;
   description?: string;
@@ -22,7 +25,7 @@ interface ServerVariableObject extends ISpecificationExtension {
   description?: string;
 }
 //#endregion
-//#region src/openapi3-ts/dist/model/openapi31.d.ts
+//#region packages/openapi3-ts/lib-types/dist/model/openapi31.d.ts
 interface OpenAPIObject extends ISpecificationExtension {
   openapi: string;
   info: InfoObject;
@@ -319,16 +322,15 @@ interface SecurityRequirementObject {
   [name: string]: string[];
 }
 //#endregion
-//#region src/openapi.d.ts
-declare const openApiVersions: readonly ["3.1.0", "3.1.1"];
-type OpenApiVersion = (typeof openApiVersions)[number];
-//#endregion
 //#region src/types.d.ts
-type OverrideParameters = Parameters<NonNullable<NonNullable<Parameters<typeof core.toJSONSchema>[1]>['override']>>[0];
+type OverrideParameters = Parameters<NonNullable<NonNullable<Parameters<typeof toJSONSchema>[1]>['override']>>[0];
+type OverrideSchemaParameters = Omit<OverrideParameters, 'zodSchema'>;
 type ZodOpenApiOverrideContext = OverrideParameters & {
   io: 'input' | 'output';
 };
-type Override = (ctx: ZodOpenApiOverrideContext) => void;
+type ZodOpenApiOverrideMetaContext = OverrideSchemaParameters;
+type ZodOpenApiOverrideMeta = (ctx: ZodOpenApiOverrideMetaContext) => void;
+type ZodOpenApiOverride = (ctx: ZodOpenApiOverrideContext) => void;
 interface ZodOpenApiBaseMetadata {
   /**
    * Used to set metadata for a parameter
@@ -351,7 +353,7 @@ interface ZodOpenApiBaseMetadata {
   /**
    * Use to override the rendered schema
    */
-  override?: SchemaObject | Override;
+  override?: SchemaObject | ZodOpenApiOverrideMeta;
   /**
    * For use only if this Zod Schema is manually registered in the `components` section
    * and is not used anywhere else in the document.
@@ -364,7 +366,7 @@ interface ZodOpenApiBaseMetadata {
    */
   outputId?: string;
 }
-interface ZodOpenApiMetadata extends ZodOpenApiBaseMetadata, core.JSONSchemaMeta {
+interface ZodOpenApiMetadata extends ZodOpenApiBaseMetadata, JSONSchemaMeta {
   examples?: unknown[];
   /**
    * @deprecated - Use `examples` instead.
@@ -491,7 +493,7 @@ interface CreateDocumentOptions {
    * - `{ type: 'string' }` — Override the schema type to be a string using an object
    * - `(ctx) => { ctx.jsonSchema.type = 'string'; }` — Override the schema type to be a string using a function
    */
-  override?: Override;
+  override?: ZodOpenApiOverride;
   /**
    * Suffix to append to the output ID of the schema.
    * This is useful to avoid conflicts with other schemas that may have the same name.
@@ -630,4 +632,4 @@ interface ComponentRegistry {
 declare const createRegistry: (components?: ZodOpenApiComponentsObject) => ComponentRegistry;
 declare const createComponents: (registry: ComponentRegistry, opts: CreateDocumentOptions) => 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, Override, 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, ZodOpenApiOverrideContext, 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, 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-BAZgpKwe.js → components-Bgg6LgwE.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(" > ")}`);
 };
@@ -216,11 +215,10 @@ const createPaths = (paths, registry$1, path) => {
 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 +251,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 +268,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()\``);
 };
@@ -595,6 +586,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 +611,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 +634,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 +666,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 +690,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 +714,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 +731,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 +748,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 +765,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);

package/dist/{components-CERE3LYU.d.mts → components-CJtL_UCT.d.cts}

@@ -1,14 +1,17 @@
-import * as core from "zod/v4/core";
-import { $ZodType, $ZodTypes } from "zod/v4/core";
+import { $ZodType, $ZodTypes, JSONSchemaMeta, toJSONSchema } from "zod/v4/core";
 
-//#region src/openapi3-ts/dist/model/specification-extension.d.ts
+//#region src/openapi.d.ts
+declare const openApiVersions: readonly ["3.1.0", "3.1.1"];
+type OpenApiVersion = (typeof openApiVersions)[number];
+//#endregion
+//#region packages/openapi3-ts/lib-types/dist/model/specification-extension.d.ts
 type IExtensionName = `x-${string}`;
 type IExtensionType = any;
 type ISpecificationExtension = {
   [extensionName: IExtensionName]: IExtensionType;
 };
 //#endregion
-//#region src/openapi3-ts/dist/model/oas-common.d.ts
+//#region packages/openapi3-ts/lib-types/dist/model/oas-common.d.ts
 interface ServerObject extends ISpecificationExtension {
   url: string;
   description?: string;
@@ -22,7 +25,7 @@ interface ServerVariableObject extends ISpecificationExtension {
   description?: string;
 }
 //#endregion
-//#region src/openapi3-ts/dist/model/openapi31.d.ts
+//#region packages/openapi3-ts/lib-types/dist/model/openapi31.d.ts
 interface OpenAPIObject extends ISpecificationExtension {
   openapi: string;
   info: InfoObject;
@@ -319,16 +322,15 @@ interface SecurityRequirementObject {
   [name: string]: string[];
 }
 //#endregion
-//#region src/openapi.d.ts
-declare const openApiVersions: readonly ["3.1.0", "3.1.1"];
-type OpenApiVersion = (typeof openApiVersions)[number];
-//#endregion
 //#region src/types.d.ts
-type OverrideParameters = Parameters<NonNullable<NonNullable<Parameters<typeof core.toJSONSchema>[1]>['override']>>[0];
+type OverrideParameters = Parameters<NonNullable<NonNullable<Parameters<typeof toJSONSchema>[1]>['override']>>[0];
+type OverrideSchemaParameters = Omit<OverrideParameters, 'zodSchema'>;
 type ZodOpenApiOverrideContext = OverrideParameters & {
   io: 'input' | 'output';
 };
-type Override = (ctx: ZodOpenApiOverrideContext) => void;
+type ZodOpenApiOverrideMetaContext = OverrideSchemaParameters;
+type ZodOpenApiOverrideMeta = (ctx: ZodOpenApiOverrideMetaContext) => void;
+type ZodOpenApiOverride = (ctx: ZodOpenApiOverrideContext) => void;
 interface ZodOpenApiBaseMetadata {
   /**
    * Used to set metadata for a parameter
@@ -351,7 +353,7 @@ interface ZodOpenApiBaseMetadata {
   /**
    * Use to override the rendered schema
    */
-  override?: SchemaObject | Override;
+  override?: SchemaObject | ZodOpenApiOverrideMeta;
   /**
    * For use only if this Zod Schema is manually registered in the `components` section
    * and is not used anywhere else in the document.
@@ -364,7 +366,7 @@ interface ZodOpenApiBaseMetadata {
    */
   outputId?: string;
 }
-interface ZodOpenApiMetadata extends ZodOpenApiBaseMetadata, core.JSONSchemaMeta {
+interface ZodOpenApiMetadata extends ZodOpenApiBaseMetadata, JSONSchemaMeta {
   examples?: unknown[];
   /**
    * @deprecated - Use `examples` instead.
@@ -491,7 +493,7 @@ interface CreateDocumentOptions {
    * - `{ type: 'string' }` — Override the schema type to be a string using an object
    * - `(ctx) => { ctx.jsonSchema.type = 'string'; }` — Override the schema type to be a string using a function
    */
-  override?: Override;
+  override?: ZodOpenApiOverride;
   /**
    * Suffix to append to the output ID of the schema.
    * This is useful to avoid conflicts with other schemas that may have the same name.
@@ -630,4 +632,4 @@ interface ComponentRegistry {
 declare const createRegistry: (components?: ZodOpenApiComponentsObject) => ComponentRegistry;
 declare const createComponents: (registry: ComponentRegistry, opts: CreateDocumentOptions) => 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, Override, 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, ZodOpenApiOverrideContext, 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, 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

@@ -0,0 +1,29 @@
+const require_components = require('./components-Bgg6LgwE.cjs');
+
+//#region src/create/document.ts
+const createDocument = (zodOpenApiObject, opts = {}) => {
+	const { paths, webhooks, components,...rest } = zodOpenApiObject;
+	const document = rest;
+	const registry = require_components.createRegistry(components);
+	const createdPaths = require_components.createPaths(paths, registry, ["paths"]);
+	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);
+	if (Object.keys(createdComponents).length > 0) document.components = createdComponents;
+	return document;
+};
+
+//#endregion
+//#region packages/openapi3-ts/src/dist/oas31.ts
+var oas31_exports = {};
+
+//#endregion
+exports.createDocument = createDocument;
+exports.createSchema = require_components.createSchema;
+Object.defineProperty(exports, 'oas31', {
+  enumerable: true,
+  get: function () {
+    return oas31_exports;
+  }
+});

package/dist/{index.d.mts → index.d.cts}

@@ -1,7 +1,10 @@
-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, Override, 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, ZodOpenApiOverrideContext, ZodOpenApiParameterObject, ZodOpenApiParameters, ZodOpenApiPathItemObject, ZodOpenApiPathsObject, ZodOpenApiRequestBodyObject, ZodOpenApiResponseObject, ZodOpenApiResponsesObject, ZodOpenApiSchemaObject, ZodOpenApiSecuritySchemeObject, ZodOpenApiVersion, createDocument } from "./components-CERE3LYU.mjs";
+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 * as core from "zod/v4/core";
 
 //#region rolldown:runtime
+declare namespace oas31_d_exports {
+  export { BaseParameterObject, CallbackObject, CallbacksObject, ComponentsObject, ContactObject, ContentObject, 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 };
+}
 //#endregion
 //#region src/create/schema/schema.d.ts
 interface SchemaResult {
@@ -24,8 +27,5 @@ declare const createSchema: (schema: core.$ZodType, ctx?: {
   schema: SchemaObject | ReferenceObject;
   components: Record<string, SchemaObject>;
 };
-declare namespace oas31_d_exports {
-  export { BaseParameterObject, CallbackObject, CallbacksObject, ComponentsObject, ContactObject, ContentObject, 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 };
-}
 //#endregion
-export { CreateDocumentOptions, Override, SchemaResult, ZodObjectInput, ZodOpenApiBaseMetadata, ZodOpenApiCallbackObject, ZodOpenApiCallbacksObject, ZodOpenApiComponentsObject, ZodOpenApiContentObject, ZodOpenApiExampleObject, ZodOpenApiExamplesObject, ZodOpenApiHeaderObject, ZodOpenApiHeadersObject, ZodOpenApiLinkObject, ZodOpenApiLinksObject, ZodOpenApiMediaTypeObject, ZodOpenApiMetadata, ZodOpenApiObject, ZodOpenApiOperationObject, ZodOpenApiOverrideContext, 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,7 +1,10 @@
-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, Override, 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, ZodOpenApiOverrideContext, ZodOpenApiParameterObject, ZodOpenApiParameters, ZodOpenApiPathItemObject, ZodOpenApiPathsObject, ZodOpenApiRequestBodyObject, ZodOpenApiResponseObject, ZodOpenApiResponsesObject, ZodOpenApiSchemaObject, ZodOpenApiSecuritySchemeObject, ZodOpenApiVersion, createDocument } from "./components-Ddt0DmKC.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, 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 * as core from "zod/v4/core";
 
 //#region rolldown:runtime
+declare namespace oas31_d_exports {
+  export { BaseParameterObject, CallbackObject, CallbacksObject, ComponentsObject, ContactObject, ContentObject, 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 };
+}
 //#endregion
 //#region src/create/schema/schema.d.ts
 interface SchemaResult {
@@ -24,8 +27,5 @@ declare const createSchema: (schema: core.$ZodType, ctx?: {
   schema: SchemaObject | ReferenceObject;
   components: Record<string, SchemaObject>;
 };
-declare namespace oas31_d_exports {
-  export { BaseParameterObject, CallbackObject, CallbacksObject, ComponentsObject, ContactObject, ContentObject, 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 };
-}
 //#endregion
-export { CreateDocumentOptions, Override, SchemaResult, ZodObjectInput, ZodOpenApiBaseMetadata, ZodOpenApiCallbackObject, ZodOpenApiCallbacksObject, ZodOpenApiComponentsObject, ZodOpenApiContentObject, ZodOpenApiExampleObject, ZodOpenApiExamplesObject, ZodOpenApiHeaderObject, ZodOpenApiHeadersObject, ZodOpenApiLinkObject, ZodOpenApiLinksObject, ZodOpenApiMediaTypeObject, ZodOpenApiMetadata, ZodOpenApiObject, ZodOpenApiOperationObject, ZodOpenApiOverrideContext, 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,19 +1,22 @@
-const require_components = require('./components-BAZgpKwe.js');
+import { createComponents, createPaths, createRegistry, createSchema } from "./components-B6MpvUFu.js";
 
 //#region src/create/document.ts
 const createDocument = (zodOpenApiObject, opts = {}) => {
 	const { paths, webhooks, components,...rest } = zodOpenApiObject;
 	const document = rest;
-	const registry = require_components.createRegistry(components);
-	const createdPaths = require_components.createPaths(paths, registry, ["paths"]);
+	const registry = createRegistry(components);
+	const createdPaths = createPaths(paths, registry, ["paths"]);
 	if (createdPaths) document.paths = createdPaths;
-	const createdWebhooks = require_components.createPaths(webhooks, registry, ["webhooks"]);
+	const createdWebhooks = createPaths(webhooks, registry, ["webhooks"]);
 	if (createdWebhooks) document.webhooks = createdWebhooks;
-	const createdComponents = require_components.createComponents(registry, opts);
+	const createdComponents = createComponents(registry, opts);
 	if (Object.keys(createdComponents).length > 0) document.components = createdComponents;
 	return document;
 };
 
 //#endregion
-exports.createDocument = createDocument;
-exports.createSchema = require_components.createSchema;
+//#region packages/openapi3-ts/src/dist/oas31.ts
+var oas31_exports = {};
+
+//#endregion
+export { createDocument, createSchema, oas31_exports as oas31 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zod-openapi",
-  "version": "5.2.0",
+  "version": "5.3.1",
   "description": "Convert Zod Schemas to OpenAPI v3.x documentation",
   "keywords": [
     "typescript",
@@ -22,20 +22,21 @@
   "funding": "https://github.com/samchungy/zod-openapi?sponsor=1",
   "license": "MIT",
   "sideEffects": false,
+  "type": "module",
   "exports": {
     ".": {
-      "import": "./dist/index.mjs",
-      "require": "./dist/index.js"
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
     },
     "./api": {
-      "import": "./dist/api.mjs",
-      "require": "./dist/api.js"
+      "import": "./dist/api.js",
+      "require": "./dist/api.cjs"
     },
     "./package.json": "./package.json"
   },
-  "main": "./dist/index.js",
-  "module": "./dist/index.mjs",
-  "types": "./dist/index.d.ts",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.cts",
   "files": [
     "dist",
     "api"
@@ -44,16 +45,18 @@
     "@arethetypeswrong/cli": "0.18.2",
     "@changesets/changelog-github": "0.5.1",
     "@changesets/cli": "2.29.5",
-    "@redocly/cli": "1.34.4",
+    "@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.0",
+    "eslint-plugin-import-zod": "1.2.0",
     "eslint-plugin-zod-openapi": "2.0.0",
-    "openapi3-ts": "4.5.0",
-    "skuba": "11.1.0",
-    "tsdown": "0.12.9",
+    "skuba": "12.0.2",
+    "tsdown": "0.13.2",
+    "vitest": "3.2.4",
     "yaml": "2.8.0",
-    "zod": "4.0.5"
+    "zod": "4.0.14"
   },
   "peerDependencies": {
     "zod": "^3.25.74 || ^4.0.0"
@@ -72,14 +75,14 @@
     "version": "11.0.0"
   },
   "scripts": {
-    "build": "pnpm copy:types && tsdown",
+    "build": "pnpm -r build && tsdown",
     "copy:types": "skuba node scripts/copyTypes.ts",
     "create:docs": " skuba node examples/simple/createSchema.ts && redocly build-docs examples/simple/openapi.yml --output=examples/simple/redoc-static.html",
     "format": "skuba format",
     "lint": "skuba lint",
     "release": "pnpm build && changeset publish",
-    "test": "skuba test",
-    "test:ci": "skuba test --coverage",
-    "test:watch": "skuba test --watch"
+    "test": "vitest run",
+    "test:ci": "vitest run --coverage",
+    "test:watch": "vitest"
   }
 }

package/dist/api.d.mts

@@ -1,11 +0,0 @@
-import { ComponentRegistry, Override, ZodOpenApiBaseMetadata, ZodOpenApiMetadata, ZodOpenApiOverrideContext, createComponents, createRegistry } from "./components-CERE3LYU.mjs";
-import * as core from "zod/v4/core";
-import { $ZodObject, $ZodType, $ZodTypes } from "zod/v4/core";
-
-//#region src/create/object.d.ts
-declare const unwrapZodObject: (zodType: $ZodTypes, io: "input" | "output", path: string[]) => $ZodObject;
-//#endregion
-//#region src/zod.d.ts
-declare const isAnyZodType: (schema: unknown) => schema is core.$ZodTypes;
-//#endregion
-export { ComponentRegistry, Override, ZodOpenApiBaseMetadata, ZodOpenApiMetadata, ZodOpenApiOverrideContext, createComponents, createRegistry, isAnyZodType, unwrapZodObject };

package/dist/api.mjs

@@ -1,3 +0,0 @@
-import { createComponents, createRegistry, isAnyZodType, unwrapZodObject } from "./components-DPhhXqww.mjs";
-
-export { createComponents, createRegistry, isAnyZodType, unwrapZodObject };

package/dist/index.mjs

@@ -1,18 +0,0 @@
-import { createComponents, createPaths, createRegistry, createSchema } from "./components-DPhhXqww.mjs";
-
-//#region src/create/document.ts
-const createDocument = (zodOpenApiObject, opts = {}) => {
-	const { paths, webhooks, components,...rest } = zodOpenApiObject;
-	const document = rest;
-	const registry = createRegistry(components);
-	const createdPaths = createPaths(paths, registry, ["paths"]);
-	if (createdPaths) document.paths = createdPaths;
-	const createdWebhooks = createPaths(webhooks, registry, ["webhooks"]);
-	if (createdWebhooks) document.webhooks = createdWebhooks;
-	const createdComponents = createComponents(registry, opts);
-	if (Object.keys(createdComponents).length > 0) document.components = createdComponents;
-	return document;
-};
-
-//#endregion
-export { createDocument, createSchema };