zod-openapi 5.0.0-beta.10 → 5.0.0-beta.12

package/dist/api.d.mts

@@ -1,4 +1,4 @@
-import { ComponentRegistry, Override, createComponents, createRegistry } from "./components-DLZ-sf1V.mjs";
+import { ComponentRegistry, Override, createComponents, createRegistry } from "./components-VJHAKH5Q.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-CtvxFnRF.js";
+import { ComponentRegistry, Override, createComponents, createRegistry } from "./components-Ci95nsUp.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-Cp63fKGN.js');
+const require_components = require('./components-DPGXI3C3.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-DKJ1Dtzd.mjs";
+import { createComponents, createRegistry, isAnyZodType, unwrapZodObject } from "./components-GWr6bv6y.mjs";
 
 export { createComponents, createRegistry, isAnyZodType, unwrapZodObject };

package/dist/{components-CtvxFnRF.d.ts → components-Ci95nsUp.d.ts}

@@ -473,6 +473,10 @@ interface CreateDocumentOptions {
    * - `"ref"` — Default. Cycles will be broken using $defs
    * - `"throw"` — Cycles will throw an error if encountered */
   cycles?: 'ref' | 'throw';
+  /**
+   * The $ref path to use for a schema component. Defaults to `#/components/schemas/`
+   */
+  schemaRefPath?: string;
 }
 declare const createDocument: (zodOpenApiObject: ZodOpenApiObject, opts?: CreateDocumentOptions) => OpenAPIObject;
 //#endregion
@@ -484,10 +488,12 @@ interface ComponentRegistry {
       input: Map<string, {
         zodType: $ZodType;
         schemaObject: SchemaObject | ReferenceObject;
+        path: string[];
       }>;
       output: Map<string, {
         zodType: $ZodType;
         schemaObject: SchemaObject | ReferenceObject;
+        path: string[];
       }>;
       ids: Map<string, SchemaObject | ReferenceObject>;
       manual: Map<string, {

package/dist/{components-Cp63fKGN.js → components-DPGXI3C3.js}

@@ -259,14 +259,15 @@ const validate = (ctx, opts) => {
 
 //#endregion
 //#region src/create/schema/rename.ts
-const renameComponents = (components, outputIds, ctx) => {
+const renameComponents = (components, outputIds, ctx, refPath) => {
 	const componentsToRename = /* @__PURE__ */ new Map();
 	if (ctx.io === "input") return componentsToRename;
 	const componentDependencies = /* @__PURE__ */ new Map();
 	const stringifiedComponents = /* @__PURE__ */ new Map();
 	for (const [key, value] of Object.entries(components)) {
 		const stringified = JSON.stringify(value);
-		const matches = stringified.matchAll(/"#\/components\/schemas\/([^"]+)"/g);
+		const regex = new RegExp(`"${refPath}([^"]+)"`, "g");
+		const matches = stringified.matchAll(regex);
 		const dependencies = /* @__PURE__ */ new Set();
 		for (const match of matches) {
 			const dep = match[1];
@@ -334,6 +335,7 @@ const createSchema = (schema, ctx = {
 	};
 };
 const createSchemas = (schemas, ctx) => {
+	const refPath = ctx.opts.schemaRefPath ?? "#/components/schemas/";
 	const entries = {};
 	for (const [name, { zodType }] of Object.entries(schemas)) entries[name] = zodType;
 	const zodRegistry = (0, zod_v4.registry)();
@@ -375,7 +377,7 @@ const createSchemas = (schemas, ctx) => {
 	const dynamicComponents = /* @__PURE__ */ new Map();
 	for (const [key, value] of Object.entries(components)) if (/^schema\d+$/.test(key)) {
 		const newName = `__schema${ctx.registry.components.schemas.dynamicSchemaCount++}`;
-		dynamicComponents.set(key, `"#/components/schemas/${newName}"`);
+		dynamicComponents.set(key, `"${refPath}${newName}"`);
 		if (newName !== key) {
 			components[newName] = value;
 			delete components[key];
@@ -387,7 +389,7 @@ const createSchemas = (schemas, ctx) => {
 		if (dynamic) return dynamic;
 		const manualComponent = ctx.registry.components.schemas.manual.get(match);
 		if (manualComponent) manualUsed[match] = true;
-		return `"#/components/schemas/${match}"`;
+		return `"${refPath}${match}"`;
 	}));
 	const parsedComponents = parsedJsonSchema.schemas.__shared?.$defs ?? {};
 	parsedJsonSchema.schemas.__shared ??= { $defs: parsedComponents };
@@ -403,7 +405,7 @@ const createSchemas = (schemas, ctx) => {
 			parsedComponents[key] = manualComponent;
 		}
 	}
-	const componentsToRename = renameComponents(parsedComponents, outputIds, ctx);
+	const componentsToRename = renameComponents(parsedComponents, outputIds, ctx, refPath);
 	if (!componentsToRename.size) {
 		const parsedSchemas = parsedJsonSchema.schemas.zodOpenApiCreateSchema?.properties;
 		delete parsedJsonSchema.schemas.zodOpenApiCreateSchema;
@@ -414,10 +416,10 @@ const createSchemas = (schemas, ctx) => {
 			manual: parsedJsonSchema.schemas
 		};
 	}
-	const renamedJsonSchema = JSON.parse(JSON.stringify(parsedJsonSchema).replace(/"#\/components\/schemas\/([^"]+)"/g, (_, match) => {
+	const renamedJsonSchema = JSON.parse(JSON.stringify(parsedJsonSchema).replace(new RegExp(`"${refPath}([^"]+)"`, "g"), (_, match) => {
 		const replacement = componentsToRename.get(match);
-		if (replacement) return `"#/components/schemas/${replacement}"`;
-		return `"#/components/schemas/${match}"`;
+		if (replacement) return `"${refPath}${replacement}"`;
+		return `"${refPath}${match}"`;
 	}));
 	const renamedSchemas = renamedJsonSchema.schemas.zodOpenApiCreateSchema?.properties;
 	const renamedComponents = renamedJsonSchema.schemas.__shared?.$defs ?? {};
@@ -472,7 +474,8 @@ const createRegistry = (components) => {
 			const schemaObject = {};
 			registry$1.components.schemas[io].set(path.join(" > "), {
 				schemaObject,
-				zodType: schema
+				zodType: schema,
+				path
 			});
 			return schemaObject;
 		},

package/dist/{components-DKJ1Dtzd.mjs → components-GWr6bv6y.mjs}

@@ -236,14 +236,15 @@ const validate = (ctx, opts) => {
 
 //#endregion
 //#region src/create/schema/rename.ts
-const renameComponents = (components, outputIds, ctx) => {
+const renameComponents = (components, outputIds, ctx, refPath) => {
 	const componentsToRename = /* @__PURE__ */ new Map();
 	if (ctx.io === "input") return componentsToRename;
 	const componentDependencies = /* @__PURE__ */ new Map();
 	const stringifiedComponents = /* @__PURE__ */ new Map();
 	for (const [key, value] of Object.entries(components)) {
 		const stringified = JSON.stringify(value);
-		const matches = stringified.matchAll(/"#\/components\/schemas\/([^"]+)"/g);
+		const regex = new RegExp(`"${refPath}([^"]+)"`, "g");
+		const matches = stringified.matchAll(regex);
 		const dependencies = /* @__PURE__ */ new Set();
 		for (const match of matches) {
 			const dep = match[1];
@@ -311,6 +312,7 @@ const createSchema = (schema, ctx = {
 	};
 };
 const createSchemas = (schemas, ctx) => {
+	const refPath = ctx.opts.schemaRefPath ?? "#/components/schemas/";
 	const entries = {};
 	for (const [name, { zodType }] of Object.entries(schemas)) entries[name] = zodType;
 	const zodRegistry = registry();
@@ -352,7 +354,7 @@ const createSchemas = (schemas, ctx) => {
 	const dynamicComponents = /* @__PURE__ */ new Map();
 	for (const [key, value] of Object.entries(components)) if (/^schema\d+$/.test(key)) {
 		const newName = `__schema${ctx.registry.components.schemas.dynamicSchemaCount++}`;
-		dynamicComponents.set(key, `"#/components/schemas/${newName}"`);
+		dynamicComponents.set(key, `"${refPath}${newName}"`);
 		if (newName !== key) {
 			components[newName] = value;
 			delete components[key];
@@ -364,7 +366,7 @@ const createSchemas = (schemas, ctx) => {
 		if (dynamic) return dynamic;
 		const manualComponent = ctx.registry.components.schemas.manual.get(match);
 		if (manualComponent) manualUsed[match] = true;
-		return `"#/components/schemas/${match}"`;
+		return `"${refPath}${match}"`;
 	}));
 	const parsedComponents = parsedJsonSchema.schemas.__shared?.$defs ?? {};
 	parsedJsonSchema.schemas.__shared ??= { $defs: parsedComponents };
@@ -380,7 +382,7 @@ const createSchemas = (schemas, ctx) => {
 			parsedComponents[key] = manualComponent;
 		}
 	}
-	const componentsToRename = renameComponents(parsedComponents, outputIds, ctx);
+	const componentsToRename = renameComponents(parsedComponents, outputIds, ctx, refPath);
 	if (!componentsToRename.size) {
 		const parsedSchemas = parsedJsonSchema.schemas.zodOpenApiCreateSchema?.properties;
 		delete parsedJsonSchema.schemas.zodOpenApiCreateSchema;
@@ -391,10 +393,10 @@ const createSchemas = (schemas, ctx) => {
 			manual: parsedJsonSchema.schemas
 		};
 	}
-	const renamedJsonSchema = JSON.parse(JSON.stringify(parsedJsonSchema).replace(/"#\/components\/schemas\/([^"]+)"/g, (_, match) => {
+	const renamedJsonSchema = JSON.parse(JSON.stringify(parsedJsonSchema).replace(new RegExp(`"${refPath}([^"]+)"`, "g"), (_, match) => {
 		const replacement = componentsToRename.get(match);
-		if (replacement) return `"#/components/schemas/${replacement}"`;
-		return `"#/components/schemas/${match}"`;
+		if (replacement) return `"${refPath}${replacement}"`;
+		return `"${refPath}${match}"`;
 	}));
 	const renamedSchemas = renamedJsonSchema.schemas.zodOpenApiCreateSchema?.properties;
 	const renamedComponents = renamedJsonSchema.schemas.__shared?.$defs ?? {};
@@ -449,7 +451,8 @@ const createRegistry = (components) => {
 			const schemaObject = {};
 			registry$1.components.schemas[io].set(path.join(" > "), {
 				schemaObject,
-				zodType: schema
+				zodType: schema,
+				path
 			});
 			return schemaObject;
 		},

package/dist/{components-DLZ-sf1V.d.mts → components-VJHAKH5Q.d.mts}

@@ -473,6 +473,10 @@ interface CreateDocumentOptions {
    * - `"ref"` — Default. Cycles will be broken using $defs
    * - `"throw"` — Cycles will throw an error if encountered */
   cycles?: 'ref' | 'throw';
+  /**
+   * The $ref path to use for a schema component. Defaults to `#/components/schemas/`
+   */
+  schemaRefPath?: string;
 }
 declare const createDocument: (zodOpenApiObject: ZodOpenApiObject, opts?: CreateDocumentOptions) => OpenAPIObject;
 //#endregion
@@ -484,10 +488,12 @@ interface ComponentRegistry {
       input: Map<string, {
         zodType: $ZodType;
         schemaObject: SchemaObject | ReferenceObject;
+        path: string[];
       }>;
       output: Map<string, {
         zodType: $ZodType;
         schemaObject: SchemaObject | ReferenceObject;
+        path: string[];
       }>;
       ids: Map<string, SchemaObject | ReferenceObject>;
       manual: Map<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-DLZ-sf1V.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-VJHAKH5Q.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-CtvxFnRF.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-Ci95nsUp.js";
 import { core } from "zod/v4";
 
 //#region rolldown:runtime

package/dist/index.js

@@ -1,4 +1,4 @@
-const require_components = require('./components-Cp63fKGN.js');
+const require_components = require('./components-DPGXI3C3.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-DKJ1Dtzd.mjs";
+import { createComponents, createPaths, createRegistry, createSchema } from "./components-GWr6bv6y.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.10",
+  "version": "5.0.0-beta.12",
   "description": "Convert Zod Schemas to OpenAPI v3.x documentation",
   "keywords": [
     "typescript",