zod-openapi 5.0.0-beta.17 → 5.0.0-beta.19

package/README.md

@@ -15,6 +15,9 @@ A TypeScript library which uses <a href="https://github.com/colinhacks/zod">Zod<
 </div>
 <br>
 
+> [!TIP]
+> Zod v4 support is available via `zod-openapi@beta`. Please read the [documentation](https://github.com/samchungy/zod-openapi/blob/v4-stash/docs/v5.md) for more information. A codegen will be available on release to help you migrate if you wish to wait.
+
 ## Installation
 
 Install via `npm`, `yarn`, or `pnpm`:
@@ -56,7 +59,7 @@ z.string().meta({
 Generates an OpenAPI documentation object.
 
 ```typescript
-import { z } from 'zod';
+import * as z from 'zod/v4';
 import { createDocument } from 'zod-openapi';
 
 const jobId = z.string().meta({
@@ -207,7 +210,7 @@ createDocument(doc, {
 Creates an OpenAPI Schema Object along with any registered components. OpenAPI 3.1.0 Schema Objects are fully compatible with JSON Schema.
 
 ```typescript
-import { z } from 'zod';
+import * as z from 'zod/v4';
 import { createSchema } from 'zod-openapi';
 
 const jobId = z.string().meta({
@@ -263,7 +266,7 @@ const { schema, components } = createSchema(job);
 
 `createSchema` takes an optional `CreateSchemaOptions` parameter which includes all options from [CreateDocumentOptions](#createdocumentoptions) plus the following:
 
-````typescript
+```typescript
 const { schema, components } = createSchema(job, {
   // Input/Output context - controls how schemas are generated
   io: 'input', // 'input' for request bodies/params, 'output' for responses
@@ -272,6 +275,7 @@ const { schema, components } = createSchema(job, {
   schemaComponents: { jobId: z.string() }, // Pre-defined components to use
   schemaComponentRefPath: '#/definitions/', // Custom path prefix for component references
 });
+```
 
 ### Request Parameters
 
@@ -292,7 +296,7 @@ createDocument({
     },
   },
 });
-````
+```
 
 If you would like to declare parameters in a more traditional way you may also declare them using the [parameters](https://swagger.io/docs/specification/describing-parameters/) key. The definitions will then all be combined.
 
@@ -636,7 +640,7 @@ createDocument({
 
 Path Items can also be registered
 
-````typescript
+```typescript
 const pathItem: ZodOpenApiPathItemObject = {
   id: 'some-path-item',
   get: {
@@ -664,7 +668,88 @@ createDocument({
 });
 ```
 
+#### Security Schemes
+
+Security Schemes can be registered for authentication methods:
+
+```typescript
+createDocument({
+  components: {
+    securitySchemes: {
+      bearerAuth: {
+        type: 'http',
+        scheme: 'bearer',
+        bearerFormat: 'JWT',
+        description: 'JWT Authentication',
+      },
+    },
+  },
+});
+```
+
+#### Links
+
+Links can be registered to describe relationships between operations:
 
+```typescript
+const link: ZodOpenApiLinkObject = {
+  id: 'getUserById',
+  operationId: 'getUser',
+  parameters: {
+    userId: '$request.path.id',
+  },
+  description: 'Link to get user by id',
+};
+
+// or
+
+createDocument({
+  components: {
+    links: {
+      getUserById: {
+        operationId: 'getUser',
+        parameters: {
+          userId: '$request.path.id',
+        },
+        description: 'Link to get user by id',
+      },
+    },
+  },
+});
+```
+
+#### Examples
+
+Examples can be registered to provide sample values for schemas:
+
+```typescript
+const example: ZodOpenApiExampleObject = {
+  id: 'userExample',
+  summary: 'A sample user',
+  value: {
+    id: '123',
+    name: 'Jane Doe',
+    email: 'jane@example.com',
+  },
+};
+
+// or
+
+createDocument({
+  components: {
+    examples: {
+      userExample: {
+        summary: 'A sample user',
+        value: {
+          id: '123',
+          name: 'Jane Doe',
+          email: 'jane@example.com',
+        },
+      },
+    },
+  },
+});
+```
 
 ### Zod Types
 
@@ -682,11 +767,11 @@ Output:
 
 In general, you want to avoid using a registered input schema in an output context and vice versa. This is because the rendered input and output schemas of a simple Zod schema will differ, even with a simple Zod schema like `z.object()`.
 
-```ts
+```typescript
 const schema = z.object({
   name: z.string(),
 });
-````
+```
 
 Input schemas (request bodies, parameters):
 

package/dist/api.d.mts

@@ -1,4 +1,4 @@
-import { ComponentRegistry, Override, createComponents, createRegistry } from "./components-uNe8arnt.mjs";
+import { ComponentRegistry, Override, createComponents, createRegistry } from "./components-DkESnIB9.mjs";
 import { $ZodObject, $ZodType, $ZodTypes } from "zod/v4/core";
 import { core } from "zod/v4";
 

package/dist/api.d.ts

@@ -1,4 +1,4 @@
-import { ComponentRegistry, Override, createComponents, createRegistry } from "./components-Ds_qyBU9.js";
+import { ComponentRegistry, Override, createComponents, createRegistry } from "./components-BLmIpmmY.js";
 import { $ZodObject, $ZodType, $ZodTypes } from "zod/v4/core";
 import { core } from "zod/v4";
 

package/dist/api.js

@@ -1,4 +1,4 @@
-const require_components = require('./components-D4JjPRqN.js');
+const require_components = require('./components-BuSFAjHY.js');
 
 exports.createComponents = require_components.createComponents;
 exports.createRegistry = require_components.createRegistry;

package/dist/api.mjs

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

package/dist/{components-Ds_qyBU9.d.ts → components-BLmIpmmY.d.ts}

@@ -381,9 +381,10 @@ interface ZodOpenApiRequestBodyObject extends Omit<RequestBodyObject, 'content'>
   id?: string;
 }
 type ZodOpenApiHeadersObject = ZodObjectInput | HeadersObject;
-interface ZodOpenApiResponseObject extends Omit<ResponseObject, 'content' | 'headers'> {
+interface ZodOpenApiResponseObject extends Omit<ResponseObject, 'content' | 'headers' | 'links'> {
   content?: ZodOpenApiContentObject;
   headers?: ZodOpenApiHeadersObject;
+  links?: ZodOpenApiLinksObject;
   /** Use this field to auto register this response object as a component */
   id?: string;
 }
@@ -427,7 +428,23 @@ interface ZodOpenApiPathsObject extends ISpecificationExtension {
 type ZodOpenApiParameterObject = $ZodType | ParameterObject | ReferenceObject;
 type ZodOpenApiHeaderObject = $ZodType | HeaderObject | ReferenceObject;
 type ZodOpenApiSchemaObject = $ZodType | SchemaObject | ReferenceObject;
-interface ZodOpenApiComponentsObject extends Omit<ComponentsObject, 'schemas' | 'responses' | 'requestBodies' | 'headers' | 'parameters' | 'pathItems' | 'callbacks'> {
+interface ZodOpenApiSecuritySchemeObject extends SecuritySchemeObject {
+  /**
+   * Used to register this security scheme as a component.
+   */
+  id?: string;
+}
+interface ZodOpenApiLinkObject extends LinkObject {
+  /** Use this field to auto register this link object as a component */
+  id?: string;
+}
+type ZodOpenApiLinksObject = Record<string, ZodOpenApiLinkObject | ReferenceObject>;
+interface ZodOpenApiExampleObject extends ExampleObject {
+  /** Use this field to auto register this example object as a component */
+  id?: string;
+}
+type ZodOpenApiExamplesObject = Record<string, ZodOpenApiExampleObject | ReferenceObject>;
+interface ZodOpenApiComponentsObject extends Omit<ComponentsObject, 'schemas' | 'responses' | 'requestBodies' | 'headers' | 'parameters' | 'pathItems' | 'callbacks' | 'securitySchemes' | 'examples'> {
   parameters?: Record<string, ZodOpenApiParameterObject>;
   schemas?: Record<string, ZodOpenApiSchemaObject>;
   requestBodies?: Record<string, ZodOpenApiRequestBodyObject>;
@@ -435,6 +452,9 @@ interface ZodOpenApiComponentsObject extends Omit<ComponentsObject, 'schemas' |
   responses?: Record<string, ZodOpenApiResponseObject>;
   callbacks?: Record<string, ZodOpenApiCallbackObject>;
   pathItems?: Record<string, ZodOpenApiPathItemObject>;
+  securitySchemes?: Record<string, ZodOpenApiSecuritySchemeObject>;
+  links?: Record<string, ZodOpenApiLinkObject>;
+  examples?: Record<string, ZodOpenApiExampleObject>;
 }
 type ZodOpenApiVersion = OpenApiVersion;
 interface ZodOpenApiObject extends Omit<OpenAPIObject, 'openapi' | 'paths' | 'webhooks' | 'components'> {
@@ -553,6 +573,18 @@ interface ComponentRegistry {
       ids: Map<string, PathItemObject | ReferenceObject>;
       seen: WeakMap<ZodOpenApiPathItemObject, PathItemObject | ReferenceObject>;
     };
+    securitySchemes: {
+      ids: Map<string, SecuritySchemeObject | ReferenceObject>;
+      seen: WeakMap<ZodOpenApiSecuritySchemeObject, SecuritySchemeObject | ReferenceObject>;
+    };
+    links: {
+      ids: Map<string, LinkObject | ReferenceObject>;
+      seen: WeakMap<ZodOpenApiLinkObject, LinkObject | ReferenceObject>;
+    };
+    examples: {
+      ids: Map<string, ExampleObject | ReferenceObject>;
+      seen: WeakMap<ZodOpenApiExampleObject, ExampleObject | ReferenceObject>;
+    };
   };
   addSchema: (schema: $ZodType, path: string[], opts: {
     io: 'input' | 'output';
@@ -580,8 +612,17 @@ interface ComponentRegistry {
   addCallback: (callback: ZodOpenApiCallbackObject, path: string[], opts?: {
     manualId?: string;
   }) => CallbackObject | ReferenceObject;
+  addSecurityScheme: (securityScheme: ZodOpenApiSecuritySchemeObject, path: string[], opts?: {
+    manualId?: string;
+  }) => SecuritySchemeObject | ReferenceObject;
+  addLink: (link: ZodOpenApiLinkObject, path: string[], opts?: {
+    manualId?: string;
+  }) => LinkObject | ReferenceObject;
+  addExample: (example: ZodOpenApiExampleObject, path: string[], opts?: {
+    manualId?: string;
+  }) => ExampleObject | ReferenceObject;
 }
 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, ZodOpenApiCallbackObject, ZodOpenApiCallbacksObject, ZodOpenApiComponentsObject, ZodOpenApiContentObject, ZodOpenApiHeaderObject, ZodOpenApiHeadersObject, ZodOpenApiMediaTypeObject, ZodOpenApiObject, ZodOpenApiOperationObject, ZodOpenApiParameterObject, ZodOpenApiParameters, ZodOpenApiPathItemObject, ZodOpenApiPathsObject, ZodOpenApiRequestBodyObject, ZodOpenApiResponseObject, ZodOpenApiResponsesObject, ZodOpenApiSchemaObject, ZodOpenApiVersion, createComponents, createDocument, createRegistry };
+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, ZodOpenApiCallbackObject, ZodOpenApiCallbacksObject, ZodOpenApiComponentsObject, ZodOpenApiContentObject, ZodOpenApiExampleObject, ZodOpenApiExamplesObject, ZodOpenApiHeaderObject, ZodOpenApiHeadersObject, ZodOpenApiLinkObject, ZodOpenApiLinksObject, ZodOpenApiMediaTypeObject, ZodOpenApiObject, ZodOpenApiOperationObject, ZodOpenApiParameterObject, ZodOpenApiParameters, ZodOpenApiPathItemObject, ZodOpenApiPathsObject, ZodOpenApiRequestBodyObject, ZodOpenApiResponseObject, ZodOpenApiResponsesObject, ZodOpenApiSchemaObject, ZodOpenApiSecuritySchemeObject, ZodOpenApiVersion, createComponents, createDocument, createRegistry };

package/dist/{components-D4JjPRqN.js → components-BuSFAjHY.js}

@@ -27,19 +27,31 @@ const zod_v4 = __toESM(require("zod/v4"));
 //#region src/zod.ts
 const isAnyZodType = (schema) => typeof schema === "object" && schema !== null && "_zod" in schema;
 
+//#endregion
+//#region src/create/examples.ts
+const createExamples = (examples, registry$1, path) => {
+	if (!examples) return void 0;
+	const examplesObject = {};
+	for (const [name, example] of Object.entries(examples)) {
+		const exampleObject = registry$1.addExample(example, [...path, name]);
+		examplesObject[name] = exampleObject;
+	}
+	return examplesObject;
+};
+
 //#endregion
 //#region src/create/content.ts
-const createMediaTypeObject = (mediaTypeObject, ctx, path) => {
-	if (isAnyZodType(mediaTypeObject.schema)) {
-		const schemaObject = ctx.registry.addSchema(mediaTypeObject.schema, [...path, "schema"], {
+const createMediaTypeObject = (mediaType, ctx, path) => {
+	const { schema, examples,...rest } = mediaType;
+	const mediaTypeObject = rest;
+	if (isAnyZodType(schema)) {
+		const schemaObject = ctx.registry.addSchema(schema, [...path, "schema"], {
 			io: ctx.io,
 			source: { type: "mediaType" }
 		});
-		return {
-			...mediaTypeObject,
-			schema: schemaObject
-		};
+		mediaTypeObject.schema = schemaObject;
 	}
+	if (examples) mediaTypeObject.examples = createExamples(examples, ctx.registry, [...path, "examples"]);
 	return mediaTypeObject;
 };
 const createContent = (content, ctx, path) => {
@@ -83,6 +95,18 @@ const createHeaders = (headers, registry$1, path) => {
 	return headers;
 };
 
+//#endregion
+//#region src/create/links.ts
+const createLinks = (links, registry$1, path) => {
+	if (!links) return void 0;
+	const linksObject = {};
+	for (const [name, link] of Object.entries(links)) {
+		const linkObject = registry$1.addLink(link, [...path, name]);
+		linksObject[name] = linkObject;
+	}
+	return linksObject;
+};
+
 //#endregion
 //#region src/create/parameters.ts
 const createManualParameters = (parameters, registry$1, path) => {
@@ -206,7 +230,10 @@ const override = (ctx) => {
 				const mapping = {};
 				for (const [index, obj] of Object.entries(ctx.jsonSchema.oneOf)) {
 					const ref = obj.$ref;
-					if (!ref) return;
+					if (!ref) {
+						delete ctx.jsonSchema.discriminator;
+						return;
+					}
 					const discriminatorValues = def.options[Number(index)]._zod.propValues?.[def.discriminator];
 					if (!discriminatorValues?.size) return;
 					for (const value of [...discriminatorValues ?? []]) {
@@ -470,6 +497,18 @@ const createRegistry = (components) => {
 			pathItems: {
 				ids: /* @__PURE__ */ new Map(),
 				seen: /* @__PURE__ */ new WeakMap()
+			},
+			securitySchemes: {
+				ids: /* @__PURE__ */ new Map(),
+				seen: /* @__PURE__ */ new WeakMap()
+			},
+			links: {
+				ids: /* @__PURE__ */ new Map(),
+				seen: /* @__PURE__ */ new WeakMap()
+			},
+			examples: {
+				ids: /* @__PURE__ */ new Map(),
+				seen: /* @__PURE__ */ new WeakMap()
 			}
 		},
 		addSchema: (schema, path, opts) => {
@@ -507,13 +546,20 @@ const createRegistry = (components) => {
 					}
 				}
 			});
-			const { id: metaId,...rest } = meta?.param ?? {};
+			const { id: metaId, examples,...rest } = meta?.param ?? {};
 			const parameterObject = {
-				...rest,
-				name,
 				in: inLocation,
-				schema: schemaObject
+				name,
+				schema: schemaObject,
+				...rest
 			};
+			const examplesObject = createExamples(examples, registry$1, [
+				...path,
+				inLocation,
+				name,
+				"examples"
+			]);
+			if (examplesObject) parameterObject.examples = examplesObject;
 			if (isRequired(parameter, "input")) parameterObject.required = true;
 			if (!parameterObject.description && meta?.description) parameterObject.description = meta.description;
 			const id = metaId ?? opts?.manualId;
@@ -607,7 +653,7 @@ const createRegistry = (components) => {
 		addResponse: (response, path, opts) => {
 			const seenResponse = registry$1.components.responses.seen.get(response);
 			if (seenResponse) return seenResponse;
-			const { content, headers, id: metaId,...rest } = response;
+			const { content, headers, links, id: metaId,...rest } = response;
 			const responseObject = rest;
 			const maybeHeaders = createHeaders(headers, registry$1, [...path, "headers"]);
 			if (maybeHeaders) responseObject.headers = maybeHeaders;
@@ -615,6 +661,7 @@ const createRegistry = (components) => {
 				registry: registry$1,
 				io: "output"
 			}, [...path, "content"]);
+			if (links) responseObject.links = createLinks(links, registry$1, [...path, "links"]);
 			const id = metaId ?? opts?.manualId;
 			if (id) {
 				if (registry$1.components.responses.ids.has(id)) throw new Error(`Response "${id}" at ${path.join(" > ")} is already registered`);
@@ -648,6 +695,54 @@ const createRegistry = (components) => {
 			}
 			registry$1.components.callbacks.seen.set(callback, callbackObject);
 			return callbackObject;
+		},
+		addSecurityScheme: (securityScheme, path, opts) => {
+			const seenSecurityScheme = registry$1.components.securitySchemes.seen.get(securityScheme);
+			if (seenSecurityScheme) return seenSecurityScheme;
+			const { id: metaId,...rest } = securityScheme;
+			const securitySchemeObject = rest;
+			const id = metaId ?? opts?.manualId;
+			if (id) {
+				if (registry$1.components.securitySchemes.ids.has(id)) throw new Error(`SecurityScheme "${id}" at ${path.join(" > ")} is already registered`);
+				const ref = { $ref: `#/components/securitySchemes/${id}` };
+				registry$1.components.securitySchemes.ids.set(id, securitySchemeObject);
+				registry$1.components.securitySchemes.seen.set(securityScheme, ref);
+				return ref;
+			}
+			registry$1.components.securitySchemes.seen.set(securityScheme, securitySchemeObject);
+			return securitySchemeObject;
+		},
+		addLink: (link, path, opts) => {
+			const seenLink = registry$1.components.links.seen.get(link);
+			if (seenLink) return seenLink;
+			const { id: metaId,...rest } = link;
+			const linkObject = rest;
+			const id = metaId ?? opts?.manualId;
+			if (id) {
+				if (registry$1.components.links.ids.has(id)) throw new Error(`Link "${id}" at ${path.join(" > ")} is already registered`);
+				const ref = { $ref: `#/components/links/${id}` };
+				registry$1.components.links.ids.set(id, linkObject);
+				registry$1.components.links.seen.set(link, ref);
+				return ref;
+			}
+			registry$1.components.links.seen.set(link, linkObject);
+			return linkObject;
+		},
+		addExample: (example, path, opts) => {
+			const seenExample = registry$1.components.examples.seen.get(example);
+			if (seenExample) return seenExample;
+			const { id: metaId,...rest } = example;
+			const exampleObject = rest;
+			const id = metaId ?? opts?.manualId;
+			if (id) {
+				if (registry$1.components.examples.ids.has(id)) throw new Error(`Example "${id}" at ${path.join(" > ")} is already registered`);
+				const ref = { $ref: `#/components/examples/${id}` };
+				registry$1.components.examples.ids.set(id, exampleObject);
+				registry$1.components.examples.seen.set(example, ref);
+				return ref;
+			}
+			registry$1.components.examples.seen.set(example, exampleObject);
+			return exampleObject;
 		}
 	};
 	registerSchemas(components?.schemas, registry$1);
@@ -657,6 +752,9 @@ const createRegistry = (components) => {
 	registerPathItems(components?.pathItems, registry$1);
 	registerRequestBodies(components?.requestBodies, registry$1);
 	registerCallbacks(components?.callbacks, registry$1);
+	registerSecuritySchemes(components?.securitySchemes, registry$1);
+	registerLinks(components?.links, registry$1);
+	registerExamples(components?.examples, registry$1);
 	return registry$1;
 };
 const registerSchemas = (schemas, registry$1) => {
@@ -746,6 +844,26 @@ const registerPathItems = (pathItems, registry$1) => {
 		key
 	], { manualId: key });
 };
+const registerSecuritySchemes = (securitySchemes, registry$1) => {
+	if (!securitySchemes) return;
+	for (const [key, schema] of Object.entries(securitySchemes)) registry$1.addSecurityScheme(schema, [
+		"components",
+		"securitySchemes",
+		key
+	], { manualId: key });
+};
+const registerLinks = (links, registry$1) => {
+	if (!links) return;
+	for (const [key, schema] of Object.entries(links)) registry$1.addLink(schema, [
+		"components",
+		"links",
+		key
+	], { manualId: key });
+};
+const registerExamples = (examples, registry$1) => {
+	if (!examples) return;
+	for (const [key, schema] of Object.entries(examples)) registry$1.components.examples.ids.set(key, schema);
+};
 const createIOSchemas = (ctx) => {
 	const { schemas, components, manual } = createSchemas(Object.fromEntries(ctx.registry.components.schemas[ctx.io]), ctx);
 	for (const [key, schema] of Object.entries(components)) ctx.registry.components.schemas.ids.set(key, schema);
@@ -787,6 +905,9 @@ const createComponents = (registry$1, opts) => {
 	if (registry$1.components.parameters.ids.size > 0) components.parameters = Object.fromEntries(registry$1.components.parameters.ids);
 	if (registry$1.components.callbacks.ids.size > 0) components.callbacks = Object.fromEntries(registry$1.components.callbacks.ids);
 	if (registry$1.components.pathItems.ids.size > 0) components.pathItems = Object.fromEntries(registry$1.components.pathItems.ids);
+	if (registry$1.components.securitySchemes.ids.size > 0) components.securitySchemes = Object.fromEntries(registry$1.components.securitySchemes.ids);
+	if (registry$1.components.links.ids.size > 0) components.links = Object.fromEntries(registry$1.components.links.ids);
+	if (registry$1.components.examples.ids.size > 0) components.examples = Object.fromEntries(registry$1.components.examples.ids);
 	return components;
 };
 

package/dist/{components-uNe8arnt.d.mts → components-DkESnIB9.d.mts}

@@ -381,9 +381,10 @@ interface ZodOpenApiRequestBodyObject extends Omit<RequestBodyObject, 'content'>
   id?: string;
 }
 type ZodOpenApiHeadersObject = ZodObjectInput | HeadersObject;
-interface ZodOpenApiResponseObject extends Omit<ResponseObject, 'content' | 'headers'> {
+interface ZodOpenApiResponseObject extends Omit<ResponseObject, 'content' | 'headers' | 'links'> {
   content?: ZodOpenApiContentObject;
   headers?: ZodOpenApiHeadersObject;
+  links?: ZodOpenApiLinksObject;
   /** Use this field to auto register this response object as a component */
   id?: string;
 }
@@ -427,7 +428,23 @@ interface ZodOpenApiPathsObject extends ISpecificationExtension {
 type ZodOpenApiParameterObject = $ZodType | ParameterObject | ReferenceObject;
 type ZodOpenApiHeaderObject = $ZodType | HeaderObject | ReferenceObject;
 type ZodOpenApiSchemaObject = $ZodType | SchemaObject | ReferenceObject;
-interface ZodOpenApiComponentsObject extends Omit<ComponentsObject, 'schemas' | 'responses' | 'requestBodies' | 'headers' | 'parameters' | 'pathItems' | 'callbacks'> {
+interface ZodOpenApiSecuritySchemeObject extends SecuritySchemeObject {
+  /**
+   * Used to register this security scheme as a component.
+   */
+  id?: string;
+}
+interface ZodOpenApiLinkObject extends LinkObject {
+  /** Use this field to auto register this link object as a component */
+  id?: string;
+}
+type ZodOpenApiLinksObject = Record<string, ZodOpenApiLinkObject | ReferenceObject>;
+interface ZodOpenApiExampleObject extends ExampleObject {
+  /** Use this field to auto register this example object as a component */
+  id?: string;
+}
+type ZodOpenApiExamplesObject = Record<string, ZodOpenApiExampleObject | ReferenceObject>;
+interface ZodOpenApiComponentsObject extends Omit<ComponentsObject, 'schemas' | 'responses' | 'requestBodies' | 'headers' | 'parameters' | 'pathItems' | 'callbacks' | 'securitySchemes' | 'examples'> {
   parameters?: Record<string, ZodOpenApiParameterObject>;
   schemas?: Record<string, ZodOpenApiSchemaObject>;
   requestBodies?: Record<string, ZodOpenApiRequestBodyObject>;
@@ -435,6 +452,9 @@ interface ZodOpenApiComponentsObject extends Omit<ComponentsObject, 'schemas' |
   responses?: Record<string, ZodOpenApiResponseObject>;
   callbacks?: Record<string, ZodOpenApiCallbackObject>;
   pathItems?: Record<string, ZodOpenApiPathItemObject>;
+  securitySchemes?: Record<string, ZodOpenApiSecuritySchemeObject>;
+  links?: Record<string, ZodOpenApiLinkObject>;
+  examples?: Record<string, ZodOpenApiExampleObject>;
 }
 type ZodOpenApiVersion = OpenApiVersion;
 interface ZodOpenApiObject extends Omit<OpenAPIObject, 'openapi' | 'paths' | 'webhooks' | 'components'> {
@@ -553,6 +573,18 @@ interface ComponentRegistry {
       ids: Map<string, PathItemObject | ReferenceObject>;
       seen: WeakMap<ZodOpenApiPathItemObject, PathItemObject | ReferenceObject>;
     };
+    securitySchemes: {
+      ids: Map<string, SecuritySchemeObject | ReferenceObject>;
+      seen: WeakMap<ZodOpenApiSecuritySchemeObject, SecuritySchemeObject | ReferenceObject>;
+    };
+    links: {
+      ids: Map<string, LinkObject | ReferenceObject>;
+      seen: WeakMap<ZodOpenApiLinkObject, LinkObject | ReferenceObject>;
+    };
+    examples: {
+      ids: Map<string, ExampleObject | ReferenceObject>;
+      seen: WeakMap<ZodOpenApiExampleObject, ExampleObject | ReferenceObject>;
+    };
   };
   addSchema: (schema: $ZodType, path: string[], opts: {
     io: 'input' | 'output';
@@ -580,8 +612,17 @@ interface ComponentRegistry {
   addCallback: (callback: ZodOpenApiCallbackObject, path: string[], opts?: {
     manualId?: string;
   }) => CallbackObject | ReferenceObject;
+  addSecurityScheme: (securityScheme: ZodOpenApiSecuritySchemeObject, path: string[], opts?: {
+    manualId?: string;
+  }) => SecuritySchemeObject | ReferenceObject;
+  addLink: (link: ZodOpenApiLinkObject, path: string[], opts?: {
+    manualId?: string;
+  }) => LinkObject | ReferenceObject;
+  addExample: (example: ZodOpenApiExampleObject, path: string[], opts?: {
+    manualId?: string;
+  }) => ExampleObject | ReferenceObject;
 }
 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, ZodOpenApiCallbackObject, ZodOpenApiCallbacksObject, ZodOpenApiComponentsObject, ZodOpenApiContentObject, ZodOpenApiHeaderObject, ZodOpenApiHeadersObject, ZodOpenApiMediaTypeObject, ZodOpenApiObject, ZodOpenApiOperationObject, ZodOpenApiParameterObject, ZodOpenApiParameters, ZodOpenApiPathItemObject, ZodOpenApiPathsObject, ZodOpenApiRequestBodyObject, ZodOpenApiResponseObject, ZodOpenApiResponsesObject, ZodOpenApiSchemaObject, ZodOpenApiVersion, createComponents, createDocument, createRegistry };
+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, ZodOpenApiCallbackObject, ZodOpenApiCallbacksObject, ZodOpenApiComponentsObject, ZodOpenApiContentObject, ZodOpenApiExampleObject, ZodOpenApiExamplesObject, ZodOpenApiHeaderObject, ZodOpenApiHeadersObject, ZodOpenApiLinkObject, ZodOpenApiLinksObject, ZodOpenApiMediaTypeObject, ZodOpenApiObject, ZodOpenApiOperationObject, ZodOpenApiParameterObject, ZodOpenApiParameters, ZodOpenApiPathItemObject, ZodOpenApiPathsObject, ZodOpenApiRequestBodyObject, ZodOpenApiResponseObject, ZodOpenApiResponsesObject, ZodOpenApiSchemaObject, ZodOpenApiSecuritySchemeObject, ZodOpenApiVersion, createComponents, createDocument, createRegistry };

package/dist/{components-CncTLZvX.mjs → components-n2uYApmq.mjs}

@@ -4,19 +4,31 @@ import { object, registry, toJSONSchema } from "zod/v4";
 //#region src/zod.ts
 const isAnyZodType = (schema) => typeof schema === "object" && schema !== null && "_zod" in schema;
 
+//#endregion
+//#region src/create/examples.ts
+const createExamples = (examples, registry$1, path) => {
+	if (!examples) return void 0;
+	const examplesObject = {};
+	for (const [name, example] of Object.entries(examples)) {
+		const exampleObject = registry$1.addExample(example, [...path, name]);
+		examplesObject[name] = exampleObject;
+	}
+	return examplesObject;
+};
+
 //#endregion
 //#region src/create/content.ts
-const createMediaTypeObject = (mediaTypeObject, ctx, path) => {
-	if (isAnyZodType(mediaTypeObject.schema)) {
-		const schemaObject = ctx.registry.addSchema(mediaTypeObject.schema, [...path, "schema"], {
+const createMediaTypeObject = (mediaType, ctx, path) => {
+	const { schema, examples,...rest } = mediaType;
+	const mediaTypeObject = rest;
+	if (isAnyZodType(schema)) {
+		const schemaObject = ctx.registry.addSchema(schema, [...path, "schema"], {
 			io: ctx.io,
 			source: { type: "mediaType" }
 		});
-		return {
-			...mediaTypeObject,
-			schema: schemaObject
-		};
+		mediaTypeObject.schema = schemaObject;
 	}
+	if (examples) mediaTypeObject.examples = createExamples(examples, ctx.registry, [...path, "examples"]);
 	return mediaTypeObject;
 };
 const createContent = (content, ctx, path) => {
@@ -60,6 +72,18 @@ const createHeaders = (headers, registry$1, path) => {
 	return headers;
 };
 
+//#endregion
+//#region src/create/links.ts
+const createLinks = (links, registry$1, path) => {
+	if (!links) return void 0;
+	const linksObject = {};
+	for (const [name, link] of Object.entries(links)) {
+		const linkObject = registry$1.addLink(link, [...path, name]);
+		linksObject[name] = linkObject;
+	}
+	return linksObject;
+};
+
 //#endregion
 //#region src/create/parameters.ts
 const createManualParameters = (parameters, registry$1, path) => {
@@ -183,7 +207,10 @@ const override = (ctx) => {
 				const mapping = {};
 				for (const [index, obj] of Object.entries(ctx.jsonSchema.oneOf)) {
 					const ref = obj.$ref;
-					if (!ref) return;
+					if (!ref) {
+						delete ctx.jsonSchema.discriminator;
+						return;
+					}
 					const discriminatorValues = def.options[Number(index)]._zod.propValues?.[def.discriminator];
 					if (!discriminatorValues?.size) return;
 					for (const value of [...discriminatorValues ?? []]) {
@@ -447,6 +474,18 @@ const createRegistry = (components) => {
 			pathItems: {
 				ids: /* @__PURE__ */ new Map(),
 				seen: /* @__PURE__ */ new WeakMap()
+			},
+			securitySchemes: {
+				ids: /* @__PURE__ */ new Map(),
+				seen: /* @__PURE__ */ new WeakMap()
+			},
+			links: {
+				ids: /* @__PURE__ */ new Map(),
+				seen: /* @__PURE__ */ new WeakMap()
+			},
+			examples: {
+				ids: /* @__PURE__ */ new Map(),
+				seen: /* @__PURE__ */ new WeakMap()
 			}
 		},
 		addSchema: (schema, path, opts) => {
@@ -484,13 +523,20 @@ const createRegistry = (components) => {
 					}
 				}
 			});
-			const { id: metaId,...rest } = meta?.param ?? {};
+			const { id: metaId, examples,...rest } = meta?.param ?? {};
 			const parameterObject = {
-				...rest,
-				name,
 				in: inLocation,
-				schema: schemaObject
+				name,
+				schema: schemaObject,
+				...rest
 			};
+			const examplesObject = createExamples(examples, registry$1, [
+				...path,
+				inLocation,
+				name,
+				"examples"
+			]);
+			if (examplesObject) parameterObject.examples = examplesObject;
 			if (isRequired(parameter, "input")) parameterObject.required = true;
 			if (!parameterObject.description && meta?.description) parameterObject.description = meta.description;
 			const id = metaId ?? opts?.manualId;
@@ -584,7 +630,7 @@ const createRegistry = (components) => {
 		addResponse: (response, path, opts) => {
 			const seenResponse = registry$1.components.responses.seen.get(response);
 			if (seenResponse) return seenResponse;
-			const { content, headers, id: metaId,...rest } = response;
+			const { content, headers, links, id: metaId,...rest } = response;
 			const responseObject = rest;
 			const maybeHeaders = createHeaders(headers, registry$1, [...path, "headers"]);
 			if (maybeHeaders) responseObject.headers = maybeHeaders;
@@ -592,6 +638,7 @@ const createRegistry = (components) => {
 				registry: registry$1,
 				io: "output"
 			}, [...path, "content"]);
+			if (links) responseObject.links = createLinks(links, registry$1, [...path, "links"]);
 			const id = metaId ?? opts?.manualId;
 			if (id) {
 				if (registry$1.components.responses.ids.has(id)) throw new Error(`Response "${id}" at ${path.join(" > ")} is already registered`);
@@ -625,6 +672,54 @@ const createRegistry = (components) => {
 			}
 			registry$1.components.callbacks.seen.set(callback, callbackObject);
 			return callbackObject;
+		},
+		addSecurityScheme: (securityScheme, path, opts) => {
+			const seenSecurityScheme = registry$1.components.securitySchemes.seen.get(securityScheme);
+			if (seenSecurityScheme) return seenSecurityScheme;
+			const { id: metaId,...rest } = securityScheme;
+			const securitySchemeObject = rest;
+			const id = metaId ?? opts?.manualId;
+			if (id) {
+				if (registry$1.components.securitySchemes.ids.has(id)) throw new Error(`SecurityScheme "${id}" at ${path.join(" > ")} is already registered`);
+				const ref = { $ref: `#/components/securitySchemes/${id}` };
+				registry$1.components.securitySchemes.ids.set(id, securitySchemeObject);
+				registry$1.components.securitySchemes.seen.set(securityScheme, ref);
+				return ref;
+			}
+			registry$1.components.securitySchemes.seen.set(securityScheme, securitySchemeObject);
+			return securitySchemeObject;
+		},
+		addLink: (link, path, opts) => {
+			const seenLink = registry$1.components.links.seen.get(link);
+			if (seenLink) return seenLink;
+			const { id: metaId,...rest } = link;
+			const linkObject = rest;
+			const id = metaId ?? opts?.manualId;
+			if (id) {
+				if (registry$1.components.links.ids.has(id)) throw new Error(`Link "${id}" at ${path.join(" > ")} is already registered`);
+				const ref = { $ref: `#/components/links/${id}` };
+				registry$1.components.links.ids.set(id, linkObject);
+				registry$1.components.links.seen.set(link, ref);
+				return ref;
+			}
+			registry$1.components.links.seen.set(link, linkObject);
+			return linkObject;
+		},
+		addExample: (example, path, opts) => {
+			const seenExample = registry$1.components.examples.seen.get(example);
+			if (seenExample) return seenExample;
+			const { id: metaId,...rest } = example;
+			const exampleObject = rest;
+			const id = metaId ?? opts?.manualId;
+			if (id) {
+				if (registry$1.components.examples.ids.has(id)) throw new Error(`Example "${id}" at ${path.join(" > ")} is already registered`);
+				const ref = { $ref: `#/components/examples/${id}` };
+				registry$1.components.examples.ids.set(id, exampleObject);
+				registry$1.components.examples.seen.set(example, ref);
+				return ref;
+			}
+			registry$1.components.examples.seen.set(example, exampleObject);
+			return exampleObject;
 		}
 	};
 	registerSchemas(components?.schemas, registry$1);
@@ -634,6 +729,9 @@ const createRegistry = (components) => {
 	registerPathItems(components?.pathItems, registry$1);
 	registerRequestBodies(components?.requestBodies, registry$1);
 	registerCallbacks(components?.callbacks, registry$1);
+	registerSecuritySchemes(components?.securitySchemes, registry$1);
+	registerLinks(components?.links, registry$1);
+	registerExamples(components?.examples, registry$1);
 	return registry$1;
 };
 const registerSchemas = (schemas, registry$1) => {
@@ -723,6 +821,26 @@ const registerPathItems = (pathItems, registry$1) => {
 		key
 	], { manualId: key });
 };
+const registerSecuritySchemes = (securitySchemes, registry$1) => {
+	if (!securitySchemes) return;
+	for (const [key, schema] of Object.entries(securitySchemes)) registry$1.addSecurityScheme(schema, [
+		"components",
+		"securitySchemes",
+		key
+	], { manualId: key });
+};
+const registerLinks = (links, registry$1) => {
+	if (!links) return;
+	for (const [key, schema] of Object.entries(links)) registry$1.addLink(schema, [
+		"components",
+		"links",
+		key
+	], { manualId: key });
+};
+const registerExamples = (examples, registry$1) => {
+	if (!examples) return;
+	for (const [key, schema] of Object.entries(examples)) registry$1.components.examples.ids.set(key, schema);
+};
 const createIOSchemas = (ctx) => {
 	const { schemas, components, manual } = createSchemas(Object.fromEntries(ctx.registry.components.schemas[ctx.io]), ctx);
 	for (const [key, schema] of Object.entries(components)) ctx.registry.components.schemas.ids.set(key, schema);
@@ -764,6 +882,9 @@ const createComponents = (registry$1, opts) => {
 	if (registry$1.components.parameters.ids.size > 0) components.parameters = Object.fromEntries(registry$1.components.parameters.ids);
 	if (registry$1.components.callbacks.ids.size > 0) components.callbacks = Object.fromEntries(registry$1.components.callbacks.ids);
 	if (registry$1.components.pathItems.ids.size > 0) components.pathItems = Object.fromEntries(registry$1.components.pathItems.ids);
+	if (registry$1.components.securitySchemes.ids.size > 0) components.securitySchemes = Object.fromEntries(registry$1.components.securitySchemes.ids);
+	if (registry$1.components.links.ids.size > 0) components.links = Object.fromEntries(registry$1.components.links.ids);
+	if (registry$1.components.examples.ids.size > 0) components.examples = Object.fromEntries(registry$1.components.examples.ids);
 	return components;
 };
 

package/dist/index.d.mts

@@ -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, Override, ParameterLocation, ParameterObject, ParameterStyle, PathItemObject, PathObject, PathsObject, ReferenceObject, RequestBodyObject, ResponseObject, ResponsesObject, SchemaObject, SchemaObjectType, SchemasObject, ScopesObject, SecurityRequirementObject, SecuritySchemeObject, SecuritySchemeType, ServerObject, ServerVariableObject, TagObject, XmlObject, ZodObjectInput, ZodOpenApiCallbackObject, ZodOpenApiCallbacksObject, ZodOpenApiComponentsObject, ZodOpenApiContentObject, ZodOpenApiHeaderObject, ZodOpenApiHeadersObject, ZodOpenApiMediaTypeObject, ZodOpenApiObject, ZodOpenApiOperationObject, ZodOpenApiParameterObject, ZodOpenApiParameters, ZodOpenApiPathItemObject, ZodOpenApiPathsObject, ZodOpenApiRequestBodyObject, ZodOpenApiResponseObject, ZodOpenApiResponsesObject, ZodOpenApiSchemaObject, ZodOpenApiVersion, createDocument } from "./components-uNe8arnt.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, Override, ParameterLocation, ParameterObject, ParameterStyle, PathItemObject, PathObject, PathsObject, ReferenceObject, RequestBodyObject, ResponseObject, ResponsesObject, SchemaObject, SchemaObjectType, SchemasObject, ScopesObject, SecurityRequirementObject, SecuritySchemeObject, SecuritySchemeType, ServerObject, ServerVariableObject, TagObject, XmlObject, ZodObjectInput, ZodOpenApiCallbackObject, ZodOpenApiCallbacksObject, ZodOpenApiComponentsObject, ZodOpenApiContentObject, ZodOpenApiExampleObject, ZodOpenApiExamplesObject, ZodOpenApiHeaderObject, ZodOpenApiHeadersObject, ZodOpenApiLinkObject, ZodOpenApiLinksObject, ZodOpenApiMediaTypeObject, ZodOpenApiObject, ZodOpenApiOperationObject, ZodOpenApiParameterObject, ZodOpenApiParameters, ZodOpenApiPathItemObject, ZodOpenApiPathsObject, ZodOpenApiRequestBodyObject, ZodOpenApiResponseObject, ZodOpenApiResponsesObject, ZodOpenApiSchemaObject, ZodOpenApiSecuritySchemeObject, ZodOpenApiVersion, createDocument } from "./components-DkESnIB9.mjs";
 import { core } from "zod/v4";
 
 //#region rolldown:runtime
@@ -22,4 +22,4 @@ 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, ZodOpenApiCallbackObject, ZodOpenApiCallbacksObject, ZodOpenApiComponentsObject, ZodOpenApiContentObject, ZodOpenApiHeaderObject, ZodOpenApiHeadersObject, ZodOpenApiMediaTypeObject, ZodOpenApiObject, ZodOpenApiOperationObject, ZodOpenApiParameterObject, ZodOpenApiParameters, ZodOpenApiPathItemObject, ZodOpenApiPathsObject, ZodOpenApiRequestBodyObject, ZodOpenApiResponseObject, ZodOpenApiResponsesObject, ZodOpenApiSchemaObject, ZodOpenApiVersion, createDocument, createSchema, oas31_d_exports as oas31 };
+export { CreateDocumentOptions, Override, SchemaResult, ZodObjectInput, ZodOpenApiCallbackObject, ZodOpenApiCallbacksObject, ZodOpenApiComponentsObject, ZodOpenApiContentObject, ZodOpenApiExampleObject, ZodOpenApiExamplesObject, ZodOpenApiHeaderObject, ZodOpenApiHeadersObject, ZodOpenApiLinkObject, ZodOpenApiLinksObject, ZodOpenApiMediaTypeObject, ZodOpenApiObject, ZodOpenApiOperationObject, 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, Override, ParameterLocation, ParameterObject, ParameterStyle, PathItemObject, PathObject, PathsObject, ReferenceObject, RequestBodyObject, ResponseObject, ResponsesObject, SchemaObject, SchemaObjectType, SchemasObject, ScopesObject, SecurityRequirementObject, SecuritySchemeObject, SecuritySchemeType, ServerObject, ServerVariableObject, TagObject, XmlObject, ZodObjectInput, ZodOpenApiCallbackObject, ZodOpenApiCallbacksObject, ZodOpenApiComponentsObject, ZodOpenApiContentObject, ZodOpenApiHeaderObject, ZodOpenApiHeadersObject, ZodOpenApiMediaTypeObject, ZodOpenApiObject, ZodOpenApiOperationObject, ZodOpenApiParameterObject, ZodOpenApiParameters, ZodOpenApiPathItemObject, ZodOpenApiPathsObject, ZodOpenApiRequestBodyObject, ZodOpenApiResponseObject, ZodOpenApiResponsesObject, ZodOpenApiSchemaObject, ZodOpenApiVersion, createDocument } from "./components-Ds_qyBU9.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, Override, ParameterLocation, ParameterObject, ParameterStyle, PathItemObject, PathObject, PathsObject, ReferenceObject, RequestBodyObject, ResponseObject, ResponsesObject, SchemaObject, SchemaObjectType, SchemasObject, ScopesObject, SecurityRequirementObject, SecuritySchemeObject, SecuritySchemeType, ServerObject, ServerVariableObject, TagObject, XmlObject, ZodObjectInput, ZodOpenApiCallbackObject, ZodOpenApiCallbacksObject, ZodOpenApiComponentsObject, ZodOpenApiContentObject, ZodOpenApiExampleObject, ZodOpenApiExamplesObject, ZodOpenApiHeaderObject, ZodOpenApiHeadersObject, ZodOpenApiLinkObject, ZodOpenApiLinksObject, ZodOpenApiMediaTypeObject, ZodOpenApiObject, ZodOpenApiOperationObject, ZodOpenApiParameterObject, ZodOpenApiParameters, ZodOpenApiPathItemObject, ZodOpenApiPathsObject, ZodOpenApiRequestBodyObject, ZodOpenApiResponseObject, ZodOpenApiResponsesObject, ZodOpenApiSchemaObject, ZodOpenApiSecuritySchemeObject, ZodOpenApiVersion, createDocument } from "./components-BLmIpmmY.js";
 import { core } from "zod/v4";
 
 //#region rolldown:runtime
@@ -22,4 +22,4 @@ 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, ZodOpenApiCallbackObject, ZodOpenApiCallbacksObject, ZodOpenApiComponentsObject, ZodOpenApiContentObject, ZodOpenApiHeaderObject, ZodOpenApiHeadersObject, ZodOpenApiMediaTypeObject, ZodOpenApiObject, ZodOpenApiOperationObject, ZodOpenApiParameterObject, ZodOpenApiParameters, ZodOpenApiPathItemObject, ZodOpenApiPathsObject, ZodOpenApiRequestBodyObject, ZodOpenApiResponseObject, ZodOpenApiResponsesObject, ZodOpenApiSchemaObject, ZodOpenApiVersion, createDocument, createSchema, oas31_d_exports as oas31 };
+export { CreateDocumentOptions, Override, SchemaResult, ZodObjectInput, ZodOpenApiCallbackObject, ZodOpenApiCallbacksObject, ZodOpenApiComponentsObject, ZodOpenApiContentObject, ZodOpenApiExampleObject, ZodOpenApiExamplesObject, ZodOpenApiHeaderObject, ZodOpenApiHeadersObject, ZodOpenApiLinkObject, ZodOpenApiLinksObject, ZodOpenApiMediaTypeObject, ZodOpenApiObject, ZodOpenApiOperationObject, 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 @@
-const require_components = require('./components-D4JjPRqN.js');
+const require_components = require('./components-BuSFAjHY.js');
 
 //#region src/create/document.ts
 const createDocument = (zodOpenApiObject, opts = {}) => {

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { createComponents, createPaths, createRegistry, createSchema } from "./components-CncTLZvX.mjs";
+import { createComponents, createPaths, createRegistry, createSchema } from "./components-n2uYApmq.mjs";
 
 //#region src/create/document.ts
 const createDocument = (zodOpenApiObject, opts = {}) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zod-openapi",
-  "version": "5.0.0-beta.17",
+  "version": "5.0.0-beta.19",
   "description": "Convert Zod Schemas to OpenAPI v3.x documentation",
   "keywords": [
     "typescript",
@@ -54,6 +54,7 @@
     "@arethetypeswrong/cli": "0.18.1",
     "@redocly/cli": "1.34.3",
     "@types/node": "22.15.21",
+    "eslint-plugin-import-zod": "1.0.3",
     "eslint-plugin-zod-openapi": "2.0.0-beta.1",
     "openapi3-ts": "4.5.0",
     "skuba": "11.0.1",