zod-openapi 5.0.0-beta.11 → 5.0.0-beta.13

package/dist/api.d.mts

@@ -1,4 +1,4 @@
-import { ComponentRegistry, Override, createComponents, createRegistry } from "./components-29xRAW1K.mjs";
+import { ComponentRegistry, Override, createComponents, createRegistry } from "./components-Ck7iRc2n.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-nS-mzdlW.js";
+import { ComponentRegistry, Override, createComponents, createRegistry } from "./components-DLKlRo1M.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-BdF0iREJ.js');
+const require_components = require('./components-D7SEPn4F.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-3Hqib_T0.mjs";
+import { createComponents, createRegistry, isAnyZodType, unwrapZodObject } from "./components-DGJXTZGV.mjs";
 
 export { createComponents, createRegistry, isAnyZodType, unwrapZodObject };

package/dist/{components-29xRAW1K.d.mts → components-Ck7iRc2n.d.mts}

@@ -481,6 +481,15 @@ interface CreateDocumentOptions {
 declare const createDocument: (zodOpenApiObject: ZodOpenApiObject, opts?: CreateDocumentOptions) => OpenAPIObject;
 //#endregion
 //#region src/create/components.d.ts
+type SchemaSource = {
+  type: 'mediaType' | 'header';
+} | {
+  type: 'parameter';
+  location: {
+    in: string;
+    name: string;
+  };
+};
 interface ComponentRegistry {
   components: {
     schemas: {
@@ -488,10 +497,16 @@ interface ComponentRegistry {
       input: Map<string, {
         zodType: $ZodType;
         schemaObject: SchemaObject | ReferenceObject;
+        source: SchemaSource & {
+          path: string[];
+        };
       }>;
       output: Map<string, {
         zodType: $ZodType;
         schemaObject: SchemaObject | ReferenceObject;
+        source: SchemaSource & {
+          path: string[];
+        };
       }>;
       ids: Map<string, SchemaObject | ReferenceObject>;
       manual: Map<string, {
@@ -531,8 +546,9 @@ interface ComponentRegistry {
       seen: WeakMap<ZodOpenApiPathItemObject, PathItemObject | ReferenceObject>;
     };
   };
-  addSchema: (schema: $ZodType, path: string[], opts?: {
+  addSchema: (schema: $ZodType, path: string[], opts: {
     io: 'input' | 'output';
+    source: SchemaSource;
   }) => SchemaObject | ReferenceObject;
   addHeader: (header: $ZodType, path: string[], opts?: {
     manualId?: string;

package/dist/{components-BdF0iREJ.js → components-D7SEPn4F.js}

@@ -31,7 +31,10 @@ const isAnyZodType = (schema) => typeof schema === "object" && schema !== null &
 //#region src/create/content.ts
 const createMediaTypeObject = (mediaTypeObject, ctx, path) => {
 	if (isAnyZodType(mediaTypeObject.schema)) {
-		const schemaObject = ctx.registry.addSchema(mediaTypeObject.schema, [...path, "schema"], { io: ctx.io });
+		const schemaObject = ctx.registry.addSchema(mediaTypeObject.schema, [...path, "schema"], {
+			io: ctx.io,
+			source: { type: "mediaType" }
+		});
 		return {
 			...mediaTypeObject,
 			schema: schemaObject
@@ -470,11 +473,14 @@ const createRegistry = (components) => {
 			}
 		},
 		addSchema: (schema, path, opts) => {
-			const io = opts?.io ?? "output";
 			const schemaObject = {};
-			registry$1.components.schemas[io].set(path.join(" > "), {
+			registry$1.components.schemas[opts.io].set(path.join(" > "), {
 				schemaObject,
-				zodType: schema
+				zodType: schema,
+				source: {
+					path,
+					...opts?.source
+				}
 			});
 			return schemaObject;
 		},
@@ -485,7 +491,21 @@ const createRegistry = (components) => {
 			const name = opts?.location?.name ?? meta?.param?.name;
 			const inLocation = opts?.location?.in ?? meta?.param?.in;
 			if (!name || !inLocation) throw new Error(`Parameter at ${path.join(" > ")} is missing \`.meta({ param: { name, in } })\` information`);
-			const schemaObject = registry$1.addSchema(parameter, [...path, "schema"], { io: "input" });
+			const schemaObject = registry$1.addSchema(parameter, [
+				...path,
+				inLocation,
+				name,
+				"schema"
+			], {
+				io: "input",
+				source: {
+					type: "parameter",
+					location: {
+						in: inLocation,
+						name
+					}
+				}
+			});
 			const { id: metaId,...rest } = meta?.param ?? {};
 			const parameterObject = {
 				...rest,
@@ -497,7 +517,7 @@ const createRegistry = (components) => {
 			if (!parameterObject.description && meta?.description) parameterObject.description = meta.description;
 			const id = metaId ?? opts?.manualId;
 			if (id) {
-				if (registry$1.components.parameters.ids.has(id)) throw new Error(`Schema "${id}" is already registered`);
+				if (registry$1.components.parameters.ids.has(id)) throw new Error(`Schema "${id}" at ${path.join(" > ")} is already registered`);
 				const ref = { $ref: `#/components/parameters/${id}` };
 				registry$1.components.parameters.seen.set(parameter, ref);
 				registry$1.components.parameters.ids.set(id, parameterObject);
@@ -515,7 +535,10 @@ const createRegistry = (components) => {
 			const headerObject = rest;
 			if (isRequired(header, "output")) headerObject.required = true;
 			if (!headerObject.description && meta?.description) headerObject.description = meta.description;
-			headerObject.schema = registry$1.addSchema(header, [...path, "schema"], { io: "output" });
+			headerObject.schema = registry$1.addSchema(header, [...path, "schema"], {
+				io: "output",
+				source: { type: "header" }
+			});
 			if (id) {
 				if (registry$1.components.schemas.ids.has(id)) throw new Error(`Schema "${id}" is already registered`);
 				const ref = { $ref: `#/components/headers/${id}` };

package/dist/{components-3Hqib_T0.mjs → components-DGJXTZGV.mjs}

@@ -8,7 +8,10 @@ const isAnyZodType = (schema) => typeof schema === "object" && schema !== null &
 //#region src/create/content.ts
 const createMediaTypeObject = (mediaTypeObject, ctx, path) => {
 	if (isAnyZodType(mediaTypeObject.schema)) {
-		const schemaObject = ctx.registry.addSchema(mediaTypeObject.schema, [...path, "schema"], { io: ctx.io });
+		const schemaObject = ctx.registry.addSchema(mediaTypeObject.schema, [...path, "schema"], {
+			io: ctx.io,
+			source: { type: "mediaType" }
+		});
 		return {
 			...mediaTypeObject,
 			schema: schemaObject
@@ -447,11 +450,14 @@ const createRegistry = (components) => {
 			}
 		},
 		addSchema: (schema, path, opts) => {
-			const io = opts?.io ?? "output";
 			const schemaObject = {};
-			registry$1.components.schemas[io].set(path.join(" > "), {
+			registry$1.components.schemas[opts.io].set(path.join(" > "), {
 				schemaObject,
-				zodType: schema
+				zodType: schema,
+				source: {
+					path,
+					...opts?.source
+				}
 			});
 			return schemaObject;
 		},
@@ -462,7 +468,21 @@ const createRegistry = (components) => {
 			const name = opts?.location?.name ?? meta?.param?.name;
 			const inLocation = opts?.location?.in ?? meta?.param?.in;
 			if (!name || !inLocation) throw new Error(`Parameter at ${path.join(" > ")} is missing \`.meta({ param: { name, in } })\` information`);
-			const schemaObject = registry$1.addSchema(parameter, [...path, "schema"], { io: "input" });
+			const schemaObject = registry$1.addSchema(parameter, [
+				...path,
+				inLocation,
+				name,
+				"schema"
+			], {
+				io: "input",
+				source: {
+					type: "parameter",
+					location: {
+						in: inLocation,
+						name
+					}
+				}
+			});
 			const { id: metaId,...rest } = meta?.param ?? {};
 			const parameterObject = {
 				...rest,
@@ -474,7 +494,7 @@ const createRegistry = (components) => {
 			if (!parameterObject.description && meta?.description) parameterObject.description = meta.description;
 			const id = metaId ?? opts?.manualId;
 			if (id) {
-				if (registry$1.components.parameters.ids.has(id)) throw new Error(`Schema "${id}" is already registered`);
+				if (registry$1.components.parameters.ids.has(id)) throw new Error(`Schema "${id}" at ${path.join(" > ")} is already registered`);
 				const ref = { $ref: `#/components/parameters/${id}` };
 				registry$1.components.parameters.seen.set(parameter, ref);
 				registry$1.components.parameters.ids.set(id, parameterObject);
@@ -492,7 +512,10 @@ const createRegistry = (components) => {
 			const headerObject = rest;
 			if (isRequired(header, "output")) headerObject.required = true;
 			if (!headerObject.description && meta?.description) headerObject.description = meta.description;
-			headerObject.schema = registry$1.addSchema(header, [...path, "schema"], { io: "output" });
+			headerObject.schema = registry$1.addSchema(header, [...path, "schema"], {
+				io: "output",
+				source: { type: "header" }
+			});
 			if (id) {
 				if (registry$1.components.schemas.ids.has(id)) throw new Error(`Schema "${id}" is already registered`);
 				const ref = { $ref: `#/components/headers/${id}` };

package/dist/{components-nS-mzdlW.d.ts → components-DLKlRo1M.d.ts}

@@ -481,6 +481,15 @@ interface CreateDocumentOptions {
 declare const createDocument: (zodOpenApiObject: ZodOpenApiObject, opts?: CreateDocumentOptions) => OpenAPIObject;
 //#endregion
 //#region src/create/components.d.ts
+type SchemaSource = {
+  type: 'mediaType' | 'header';
+} | {
+  type: 'parameter';
+  location: {
+    in: string;
+    name: string;
+  };
+};
 interface ComponentRegistry {
   components: {
     schemas: {
@@ -488,10 +497,16 @@ interface ComponentRegistry {
       input: Map<string, {
         zodType: $ZodType;
         schemaObject: SchemaObject | ReferenceObject;
+        source: SchemaSource & {
+          path: string[];
+        };
       }>;
       output: Map<string, {
         zodType: $ZodType;
         schemaObject: SchemaObject | ReferenceObject;
+        source: SchemaSource & {
+          path: string[];
+        };
       }>;
       ids: Map<string, SchemaObject | ReferenceObject>;
       manual: Map<string, {
@@ -531,8 +546,9 @@ interface ComponentRegistry {
       seen: WeakMap<ZodOpenApiPathItemObject, PathItemObject | ReferenceObject>;
     };
   };
-  addSchema: (schema: $ZodType, path: string[], opts?: {
+  addSchema: (schema: $ZodType, path: string[], opts: {
     io: 'input' | 'output';
+    source: SchemaSource;
   }) => SchemaObject | ReferenceObject;
   addHeader: (header: $ZodType, path: string[], opts?: {
     manualId?: string;

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-29xRAW1K.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, ZodOpenApiHeaderObject, ZodOpenApiHeadersObject, ZodOpenApiMediaTypeObject, ZodOpenApiObject, ZodOpenApiOperationObject, ZodOpenApiParameterObject, ZodOpenApiParameters, ZodOpenApiPathItemObject, ZodOpenApiPathsObject, ZodOpenApiRequestBodyObject, ZodOpenApiResponseObject, ZodOpenApiResponsesObject, ZodOpenApiSchemaObject, ZodOpenApiVersion, createDocument } from "./components-Ck7iRc2n.mjs";
 import { core } from "zod/v4";
 
 //#region rolldown:runtime

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-nS-mzdlW.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, ZodOpenApiHeaderObject, ZodOpenApiHeadersObject, ZodOpenApiMediaTypeObject, ZodOpenApiObject, ZodOpenApiOperationObject, ZodOpenApiParameterObject, ZodOpenApiParameters, ZodOpenApiPathItemObject, ZodOpenApiPathsObject, ZodOpenApiRequestBodyObject, ZodOpenApiResponseObject, ZodOpenApiResponsesObject, ZodOpenApiSchemaObject, ZodOpenApiVersion, createDocument } from "./components-DLKlRo1M.js";
 import { core } from "zod/v4";
 
 //#region rolldown:runtime

package/dist/index.js

@@ -1,4 +1,4 @@
-const require_components = require('./components-BdF0iREJ.js');
+const require_components = require('./components-D7SEPn4F.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-3Hqib_T0.mjs";
+import { createComponents, createPaths, createRegistry, createSchema } from "./components-DGJXTZGV.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.11",
+  "version": "5.0.0-beta.13",
   "description": "Convert Zod Schemas to OpenAPI v3.x documentation",
   "keywords": [
     "typescript",