@kubb/plugin-oas 0.0.0-canary-20251103125929 → 0.0.0-canary-20251103140549

package/dist/getSchemas-Cl0TZ4XY.cjs

@@ -0,0 +1,113 @@
+const require_chunk = require('./chunk-CUT6urMc.cjs');
+let __kubb_oas = require("@kubb/oas");
+__kubb_oas = require_chunk.__toESM(__kubb_oas);
+
+//#region src/utils/getSchemaFactory.ts
+/**
+* Creates a factory function that generates a versioned OpenAPI schema result.
+*
+* The returned function accepts an optional schema object and produces a {@link SchemaResult} containing the dereferenced schema and the OpenAPI version ('3.0' or '3.1').
+*
+* @returns A function that takes an optional schema and returns a versioned schema result.
+*/
+function getSchemaFactory(oas) {
+	return (schema) => {
+		const version = (0, __kubb_oas.isOpenApiV3_1Document)(oas.api) ? "3.1" : "3.0";
+		return {
+			schemaObject: oas.dereferenceWithRef(schema),
+			version
+		};
+	};
+}
+
+//#endregion
+//#region src/utils/getSchemas.ts
+/**
+* Collect all schema $ref dependencies recursively.
+*/
+function collectRefs(schema, refs = /* @__PURE__ */ new Set()) {
+	if (Array.isArray(schema)) {
+		for (const item of schema) collectRefs(item, refs);
+		return refs;
+	}
+	if (schema && typeof schema === "object") for (const [key, value] of Object.entries(schema)) if (key === "$ref" && typeof value === "string") {
+		const match = value.match(/^#\/components\/schemas\/(.+)$/);
+		if (match) refs.add(match[1]);
+	} else collectRefs(value, refs);
+	return refs;
+}
+/**
+* Sort schemas topologically so referenced schemas appear first.
+*/
+function sortSchemas(schemas) {
+	const deps = /* @__PURE__ */ new Map();
+	for (const [name, schema] of Object.entries(schemas)) deps.set(name, Array.from(collectRefs(schema)));
+	const sorted = [];
+	const visited = /* @__PURE__ */ new Set();
+	function visit(name, stack = /* @__PURE__ */ new Set()) {
+		if (visited.has(name)) return;
+		if (stack.has(name)) return;
+		stack.add(name);
+		const children = deps.get(name) || [];
+		for (const child of children) if (deps.has(child)) visit(child, stack);
+		stack.delete(name);
+		visited.add(name);
+		sorted.push(name);
+	}
+	for (const name of Object.keys(schemas)) visit(name);
+	const sortedSchemas = {};
+	for (const name of sorted) sortedSchemas[name] = schemas[name];
+	return sortedSchemas;
+}
+/**
+* Collect schemas from OpenAPI components (schemas, responses, requestBodies)
+* and return them in dependency order.
+*/
+function getSchemas({ oas, contentType, includes = [
+	"schemas",
+	"requestBodies",
+	"responses"
+] }) {
+	const components = oas.getDefinition().components;
+	let schemas = {};
+	if (includes.includes("schemas")) schemas = {
+		...schemas,
+		...components?.schemas || {}
+	};
+	if (includes.includes("responses")) {
+		const responses = components?.responses || {};
+		for (const [name, response] of Object.entries(responses)) {
+			const r = response;
+			if (r.content && !schemas[name]) {
+				const firstContentType = Object.keys(r.content)[0] || "application/json";
+				schemas[name] = r.content?.[contentType || firstContentType]?.schema;
+			}
+		}
+	}
+	if (includes.includes("requestBodies")) {
+		const requestBodies = components?.requestBodies || {};
+		for (const [name, request] of Object.entries(requestBodies)) {
+			const r = request;
+			if (r.content && !schemas[name]) {
+				const firstContentType = Object.keys(r.content)[0] || "application/json";
+				schemas[name] = r.content?.[contentType || firstContentType]?.schema;
+			}
+		}
+	}
+	return sortSchemas(schemas);
+}
+
+//#endregion
+Object.defineProperty(exports, 'getSchemaFactory', {
+  enumerable: true,
+  get: function () {
+    return getSchemaFactory;
+  }
+});
+Object.defineProperty(exports, 'getSchemas', {
+  enumerable: true,
+  get: function () {
+    return getSchemas;
+  }
+});
+//# sourceMappingURL=getSchemas-Cl0TZ4XY.cjs.map

package/dist/getSchemas-Cl0TZ4XY.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"getSchemas-Cl0TZ4XY.cjs","names":["sorted: string[]","sortedSchemas: Record<string, OasTypes.SchemaObject>","schemas: Record<string, OasTypes.SchemaObject>"],"sources":["../src/utils/getSchemaFactory.ts","../src/utils/getSchemas.ts"],"sourcesContent":["import type { Oas, OpenAPIV3, OpenAPIV3_1, SchemaObject } from '@kubb/oas'\nimport { isOpenApiV3_1Document } from '@kubb/oas'\n\n/**\n * Make it possible to narrow down the schema based on a specific version(3 or 3.1)\n */\ntype SchemaResult<TWithRef extends boolean = false> =\n  | {\n      schemaObject?: (TWithRef extends true ? OpenAPIV3.SchemaObject | OpenAPIV3.ReferenceObject : OpenAPIV3.SchemaObject) & {\n        nullable?: boolean\n        'x-nullable'?: boolean\n      }\n      version: '3.0'\n    }\n  | {\n      schemaObject?: (TWithRef extends true ? OpenAPIV3_1.SchemaObject | OpenAPIV3_1.ReferenceObject : OpenAPIV3_1.SchemaObject) & {\n        nullable?: boolean\n        'x-nullable'?: boolean\n      }\n      version: '3.1'\n    }\n\n/**\n * Creates a factory function that generates a versioned OpenAPI schema result.\n *\n * The returned function accepts an optional schema object and produces a {@link SchemaResult} containing the dereferenced schema and the OpenAPI version ('3.0' or '3.1').\n *\n * @returns A function that takes an optional schema and returns a versioned schema result.\n */\nexport function getSchemaFactory<TWithRef extends boolean = false>(oas: Oas): (schema?: SchemaObject) => SchemaResult<TWithRef> {\n  return (schema?: SchemaObject) => {\n    const version = isOpenApiV3_1Document(oas.api) ? '3.1' : '3.0'\n\n    return {\n      schemaObject: oas.dereferenceWithRef(schema),\n      version,\n    } as SchemaResult<TWithRef>\n  }\n}\n","import type { contentType, Oas, OasTypes } from '@kubb/oas'\n\ntype Mode = 'schemas' | 'responses' | 'requestBodies'\n\ntype GetSchemasProps = {\n  oas: Oas\n  contentType?: contentType\n  includes?: Mode[]\n}\n\n/**\n * Collect all schema $ref dependencies recursively.\n */\nfunction collectRefs(schema: unknown, refs = new Set<string>()): Set<string> {\n  if (Array.isArray(schema)) {\n    for (const item of schema) {\n      collectRefs(item, refs)\n    }\n    return refs\n  }\n\n  if (schema && typeof schema === 'object') {\n    for (const [key, value] of Object.entries(schema)) {\n      if (key === '$ref' && typeof value === 'string') {\n        const match = value.match(/^#\\/components\\/schemas\\/(.+)$/)\n        if (match) {\n          refs.add(match[1]!)\n        }\n      } else {\n        collectRefs(value, refs)\n      }\n    }\n  }\n\n  return refs\n}\n\n/**\n * Sort schemas topologically so referenced schemas appear first.\n */\nfunction sortSchemas(schemas: Record<string, OasTypes.SchemaObject>): Record<string, OasTypes.SchemaObject> {\n  const deps = new Map<string, string[]>()\n\n  for (const [name, schema] of Object.entries(schemas)) {\n    deps.set(name, Array.from(collectRefs(schema)))\n  }\n\n  const sorted: string[] = []\n  const visited = new Set<string>()\n\n  function visit(name: string, stack = new Set<string>()) {\n    if (visited.has(name)) {\n      return\n    }\n    if (stack.has(name)) {\n      return\n    } // circular refs, ignore\n    stack.add(name)\n    const children = deps.get(name) || []\n    for (const child of children) {\n      if (deps.has(child)) {\n        visit(child, stack)\n      }\n    }\n    stack.delete(name)\n    visited.add(name)\n    sorted.push(name)\n  }\n\n  for (const name of Object.keys(schemas)) {\n    visit(name)\n  }\n\n  const sortedSchemas: Record<string, OasTypes.SchemaObject> = {}\n  for (const name of sorted) {\n    sortedSchemas[name] = schemas[name]!\n  }\n  return sortedSchemas\n}\n\n/**\n * Collect schemas from OpenAPI components (schemas, responses, requestBodies)\n * and return them in dependency order.\n */\nexport function getSchemas({ oas, contentType, includes = ['schemas', 'requestBodies', 'responses'] }: GetSchemasProps): Record<string, OasTypes.SchemaObject> {\n  const components = oas.getDefinition().components\n  let schemas: Record<string, OasTypes.SchemaObject> = {}\n\n  if (includes.includes('schemas')) {\n    schemas = {\n      ...schemas,\n      ...((components?.schemas as Record<string, OasTypes.SchemaObject>) || {}),\n    }\n  }\n\n  if (includes.includes('responses')) {\n    const responses = components?.responses || {}\n    for (const [name, response] of Object.entries(responses)) {\n      const r = response as OasTypes.ResponseObject\n      if (r.content && !schemas[name]) {\n        const firstContentType = Object.keys(r.content)[0] || 'application/json'\n        schemas[name] = r.content?.[contentType || firstContentType]?.schema as OasTypes.SchemaObject\n      }\n    }\n  }\n\n  if (includes.includes('requestBodies')) {\n    const requestBodies = components?.requestBodies || {}\n    for (const [name, request] of Object.entries(requestBodies)) {\n      const r = request as OasTypes.RequestBodyObject\n      if (r.content && !schemas[name]) {\n        const firstContentType = Object.keys(r.content)[0] || 'application/json'\n        schemas[name] = r.content?.[contentType || firstContentType]?.schema as OasTypes.SchemaObject\n      }\n    }\n  }\n\n  return sortSchemas(schemas)\n}\n"],"mappings":";;;;;;;;;;;;AA6BA,SAAgB,iBAAmD,KAA6D;AAC9H,SAAQ,WAA0B;EAChC,MAAM,gDAAgC,IAAI,IAAI,GAAG,QAAQ;AAEzD,SAAO;GACL,cAAc,IAAI,mBAAmB,OAAO;GAC5C;GACD;;;;;;;;;ACvBL,SAAS,YAAY,QAAiB,uBAAO,IAAI,KAAa,EAAe;AAC3E,KAAI,MAAM,QAAQ,OAAO,EAAE;AACzB,OAAK,MAAM,QAAQ,OACjB,aAAY,MAAM,KAAK;AAEzB,SAAO;;AAGT,KAAI,UAAU,OAAO,WAAW,SAC9B,MAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,OAAO,CAC/C,KAAI,QAAQ,UAAU,OAAO,UAAU,UAAU;EAC/C,MAAM,QAAQ,MAAM,MAAM,iCAAiC;AAC3D,MAAI,MACF,MAAK,IAAI,MAAM,GAAI;OAGrB,aAAY,OAAO,KAAK;AAK9B,QAAO;;;;;AAMT,SAAS,YAAY,SAAuF;CAC1G,MAAM,uBAAO,IAAI,KAAuB;AAExC,MAAK,MAAM,CAAC,MAAM,WAAW,OAAO,QAAQ,QAAQ,CAClD,MAAK,IAAI,MAAM,MAAM,KAAK,YAAY,OAAO,CAAC,CAAC;CAGjD,MAAMA,SAAmB,EAAE;CAC3B,MAAM,0BAAU,IAAI,KAAa;CAEjC,SAAS,MAAM,MAAc,wBAAQ,IAAI,KAAa,EAAE;AACtD,MAAI,QAAQ,IAAI,KAAK,CACnB;AAEF,MAAI,MAAM,IAAI,KAAK,CACjB;AAEF,QAAM,IAAI,KAAK;EACf,MAAM,WAAW,KAAK,IAAI,KAAK,IAAI,EAAE;AACrC,OAAK,MAAM,SAAS,SAClB,KAAI,KAAK,IAAI,MAAM,CACjB,OAAM,OAAO,MAAM;AAGvB,QAAM,OAAO,KAAK;AAClB,UAAQ,IAAI,KAAK;AACjB,SAAO,KAAK,KAAK;;AAGnB,MAAK,MAAM,QAAQ,OAAO,KAAK,QAAQ,CACrC,OAAM,KAAK;CAGb,MAAMC,gBAAuD,EAAE;AAC/D,MAAK,MAAM,QAAQ,OACjB,eAAc,QAAQ,QAAQ;AAEhC,QAAO;;;;;;AAOT,SAAgB,WAAW,EAAE,KAAK,aAAa,WAAW;CAAC;CAAW;CAAiB;CAAY,IAA4D;CAC7J,MAAM,aAAa,IAAI,eAAe,CAAC;CACvC,IAAIC,UAAiD,EAAE;AAEvD,KAAI,SAAS,SAAS,UAAU,CAC9B,WAAU;EACR,GAAG;EACH,GAAK,YAAY,WAAqD,EAAE;EACzE;AAGH,KAAI,SAAS,SAAS,YAAY,EAAE;EAClC,MAAM,YAAY,YAAY,aAAa,EAAE;AAC7C,OAAK,MAAM,CAAC,MAAM,aAAa,OAAO,QAAQ,UAAU,EAAE;GACxD,MAAM,IAAI;AACV,OAAI,EAAE,WAAW,CAAC,QAAQ,OAAO;IAC/B,MAAM,mBAAmB,OAAO,KAAK,EAAE,QAAQ,CAAC,MAAM;AACtD,YAAQ,QAAQ,EAAE,UAAU,eAAe,mBAAmB;;;;AAKpE,KAAI,SAAS,SAAS,gBAAgB,EAAE;EACtC,MAAM,gBAAgB,YAAY,iBAAiB,EAAE;AACrD,OAAK,MAAM,CAAC,MAAM,YAAY,OAAO,QAAQ,cAAc,EAAE;GAC3D,MAAM,IAAI;AACV,OAAI,EAAE,WAAW,CAAC,QAAQ,OAAO;IAC/B,MAAM,mBAAmB,OAAO,KAAK,EAAE,QAAQ,CAAC,MAAM;AACtD,YAAQ,QAAQ,EAAE,UAAU,eAAe,mBAAmB;;;;AAKpE,QAAO,YAAY,QAAQ"}

package/dist/hooks.cjs

@@ -1,7 +1,7 @@
 const require_chunk = require('./chunk-CUT6urMc.cjs');
-const require_SchemaGenerator = require('./SchemaGenerator-B8Reay1m.cjs');
+const require_SchemaGenerator = require('./SchemaGenerator-C81yEgKY.cjs');
 const require_SchemaMapper = require('./SchemaMapper-BUV8vhg0.cjs');
-require('./getSchemas-CP_YS4_2.cjs');
+require('./getSchemas-Cl0TZ4XY.cjs');
 let __kubb_react_fabric = require("@kubb/react-fabric");
 __kubb_react_fabric = require_chunk.__toESM(__kubb_react_fabric);
 let __kubb_core_hooks = require("@kubb/core/hooks");

package/dist/hooks.d.cts

@@ -1,4 +1,4 @@
-import { F as Plugin, L as ResolveNameParams, M as FileMetaBase, T as Oas, _ as OperationSchemas, d as OperationGenerator, k as Operation } from "./createGenerator-PIseu7v9.cjs";
+import { F as Plugin, L as ResolveNameParams, M as FileMetaBase, T as Oas, _ as OperationSchemas, d as OperationGenerator, k as Operation } from "./createGenerator-BZv3BSD_.cjs";
 import { t as Schema } from "./SchemaMapper-CX7sIIuZ.cjs";
 import { KubbFile } from "@kubb/fabric-core/types";
 

package/dist/hooks.d.ts

@@ -1,4 +1,4 @@
-import { F as Plugin, L as ResolveNameParams, M as FileMetaBase, T as Oas, _ as OperationSchemas, d as OperationGenerator, k as Operation } from "./createGenerator-DlSlv4sR.js";
+import { F as Plugin, L as ResolveNameParams, M as FileMetaBase, T as Oas, _ as OperationSchemas, d as OperationGenerator, k as Operation } from "./createGenerator-DoZXEhFy.js";
 import { t as Schema } from "./SchemaMapper-m5TKynWt.js";
 import { KubbFile } from "@kubb/fabric-core/types";
 

package/dist/hooks.js

@@ -1,6 +1,6 @@
-import { t as SchemaGenerator } from "./SchemaGenerator-ChoBQWm5.js";
+import { t as SchemaGenerator } from "./SchemaGenerator-BwYbrh7a.js";
 import { n as schemaKeywords } from "./SchemaMapper-D30tqRoX.js";
-import "./getSchemas-CTi8zYew.js";
+import "./getSchemas-32BHoMO-.js";
 import { useApp } from "@kubb/react-fabric";
 import { usePlugin, usePluginManager } from "@kubb/core/hooks";
 

package/dist/index.cjs

@@ -1,9 +1,9 @@
 const require_chunk = require('./chunk-CUT6urMc.cjs');
-const require_SchemaGenerator = require('./SchemaGenerator-B8Reay1m.cjs');
+const require_SchemaGenerator = require('./SchemaGenerator-C81yEgKY.cjs');
 const require_generators = require('./generators-udGOxdUV.cjs');
 require('./getFooter-DPh4lxBH.cjs');
 const require_SchemaMapper = require('./SchemaMapper-BUV8vhg0.cjs');
-require('./getSchemas-CP_YS4_2.cjs');
+require('./getSchemas-Cl0TZ4XY.cjs');
 const require_parseFromConfig = require('./parseFromConfig-EjsCZ0-8.cjs');
 let __kubb_core = require("@kubb/core");
 __kubb_core = require_chunk.__toESM(__kubb_core);

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import { A as SchemaObject, C as ResolvePathOptions, F as Plugin, I as PluginFactoryOptions, N as Config, R as UserPluginWithLifeCycle, S as Refs, _ as OperationSchemas, b as PluginOas, c as SchemaGeneratorBuildOptions, d as OperationGenerator, f as OperationMethodResult, g as OperationSchema, h as Include, i as ReactGenerator, k as Operation, l as SchemaGeneratorOptions, m as Exclude, o as GetSchemaGeneratorOptions, p as API, s as SchemaGenerator, u as SchemaMethodResult, v as Options, w as Resolver, x as Ref, y as Override } from "./createGenerator-PIseu7v9.cjs";
+import { A as SchemaObject, C as ResolvePathOptions, F as Plugin, I as PluginFactoryOptions, N as Config, R as UserPluginWithLifeCycle, S as Refs, _ as OperationSchemas, b as PluginOas, c as SchemaGeneratorBuildOptions, d as OperationGenerator, f as OperationMethodResult, g as OperationSchema, h as Include, i as ReactGenerator, k as Operation, l as SchemaGeneratorOptions, m as Exclude, o as GetSchemaGeneratorOptions, p as API, s as SchemaGenerator, u as SchemaMethodResult, v as Options, w as Resolver, x as Ref, y as Override } from "./createGenerator-BZv3BSD_.cjs";
 import { a as SchemaMapper, c as schemaKeywords, i as SchemaKeywordMapper, n as SchemaKeyword, o as SchemaTree, r as SchemaKeywordBase, s as isKeyword, t as Schema } from "./SchemaMapper-CX7sIIuZ.cjs";
 import { Fabric } from "@kubb/react-fabric";
 

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { A as SchemaObject, C as ResolvePathOptions, F as Plugin, I as PluginFactoryOptions, N as Config, R as UserPluginWithLifeCycle, S as Refs, _ as OperationSchemas, b as PluginOas, c as SchemaGeneratorBuildOptions, d as OperationGenerator, f as OperationMethodResult, g as OperationSchema, h as Include, i as ReactGenerator, k as Operation, l as SchemaGeneratorOptions, m as Exclude, o as GetSchemaGeneratorOptions, p as API, s as SchemaGenerator, u as SchemaMethodResult, v as Options, w as Resolver, x as Ref, y as Override } from "./createGenerator-DlSlv4sR.js";
+import { A as SchemaObject, C as ResolvePathOptions, F as Plugin, I as PluginFactoryOptions, N as Config, R as UserPluginWithLifeCycle, S as Refs, _ as OperationSchemas, b as PluginOas, c as SchemaGeneratorBuildOptions, d as OperationGenerator, f as OperationMethodResult, g as OperationSchema, h as Include, i as ReactGenerator, k as Operation, l as SchemaGeneratorOptions, m as Exclude, o as GetSchemaGeneratorOptions, p as API, s as SchemaGenerator, u as SchemaMethodResult, v as Options, w as Resolver, x as Ref, y as Override } from "./createGenerator-DoZXEhFy.js";
 import { a as SchemaMapper, c as schemaKeywords, i as SchemaKeywordMapper, n as SchemaKeyword, o as SchemaTree, r as SchemaKeywordBase, s as isKeyword, t as Schema } from "./SchemaMapper-m5TKynWt.js";
 import { Fabric } from "@kubb/react-fabric";
 

package/dist/index.js

@@ -1,8 +1,8 @@
-import { a as pLimit, i as buildSchema, n as buildOperation, r as buildOperations, t as SchemaGenerator } from "./SchemaGenerator-ChoBQWm5.js";
+import { a as pLimit, i as buildSchema, n as buildOperation, r as buildOperations, t as SchemaGenerator } from "./SchemaGenerator-BwYbrh7a.js";
 import { t as jsonGenerator } from "./generators-CJDEf8Kn.js";
 import "./getFooter-CV73pVXj.js";
 import { n as schemaKeywords, t as isKeyword } from "./SchemaMapper-D30tqRoX.js";
-import "./getSchemas-CTi8zYew.js";
+import "./getSchemas-32BHoMO-.js";
 import { t as parseFromConfig } from "./parseFromConfig-BkUoWC2U.js";
 import { BaseGenerator, createPlugin, getMode } from "@kubb/core";
 import transformers, { camelCase } from "@kubb/core/transformers";

package/dist/utils.cjs

@@ -1,6 +1,6 @@
 const require_chunk = require('./chunk-CUT6urMc.cjs');
 const require_getFooter = require('./getFooter-DPh4lxBH.cjs');
-const require_getSchemas = require('./getSchemas-CP_YS4_2.cjs');
+const require_getSchemas = require('./getSchemas-Cl0TZ4XY.cjs');
 const require_parseFromConfig = require('./parseFromConfig-EjsCZ0-8.cjs');
 let __kubb_core_transformers = require("@kubb/core/transformers");
 __kubb_core_transformers = require_chunk.__toESM(__kubb_core_transformers);

package/dist/utils.d.cts

@@ -1,4 +1,4 @@
-import { A as SchemaObject$1, D as OpenAPIV3$1, E as OasTypes, N as Config, O as OpenAPIV3_1, P as Output, T as Oas, g as OperationSchema, j as contentType, k as Operation } from "./createGenerator-PIseu7v9.cjs";
+import { A as SchemaObject$1, D as OpenAPIV3$1, E as OasTypes, N as Config, O as OpenAPIV3_1, P as Output, T as Oas, g as OperationSchema, j as contentType, k as Operation } from "./createGenerator-BZv3BSD_.cjs";
 import "./SchemaMapper-CX7sIIuZ.cjs";
 import { OASDocument, SchemaObject } from "oas/types";
 import { OpenAPIV3 } from "openapi-types";
@@ -105,6 +105,10 @@ type GetSchemasProps = {
   contentType?: contentType;
   includes?: Mode[];
 };
+/**
+ * Collect schemas from OpenAPI components (schemas, responses, requestBodies)
+ * and return them in dependency order.
+ */
 declare function getSchemas({
   oas,
   contentType,

package/dist/utils.d.ts

@@ -1,4 +1,4 @@
-import { A as SchemaObject$1, D as OpenAPIV3$1, E as OasTypes, N as Config, O as OpenAPIV3_1, P as Output, T as Oas, g as OperationSchema, j as contentType, k as Operation } from "./createGenerator-DlSlv4sR.js";
+import { A as SchemaObject$1, D as OpenAPIV3$1, E as OasTypes, N as Config, O as OpenAPIV3_1, P as Output, T as Oas, g as OperationSchema, j as contentType, k as Operation } from "./createGenerator-DoZXEhFy.js";
 import "./SchemaMapper-m5TKynWt.js";
 import { OASDocument, SchemaObject } from "oas/types";
 import { OpenAPIV3 } from "openapi-types";
@@ -105,6 +105,10 @@ type GetSchemasProps = {
   contentType?: contentType;
   includes?: Mode[];
 };
+/**
+ * Collect schemas from OpenAPI components (schemas, responses, requestBodies)
+ * and return them in dependency order.
+ */
 declare function getSchemas({
   oas,
   contentType,

package/dist/utils.js

@@ -1,5 +1,5 @@
 import { n as getBanner, t as getFooter } from "./getFooter-CV73pVXj.js";
-import { n as getSchemaFactory, t as getSchemas } from "./getSchemas-CTi8zYew.js";
+import { n as getSchemaFactory, t as getSchemas } from "./getSchemas-32BHoMO-.js";
 import { t as parseFromConfig } from "./parseFromConfig-BkUoWC2U.js";
 import transformers, { camelCase, isValidVarName } from "@kubb/core/transformers";
 import { URLPath } from "@kubb/core/utils";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kubb/plugin-oas",
-  "version": "0.0.0-canary-20251103125929",
+  "version": "0.0.0-canary-20251103140549",
   "description": "OpenAPI Specification (OAS) plugin for Kubb, providing core functionality for parsing and processing OpenAPI/Swagger schemas for code generation.",
   "keywords": [
     "openapi",
@@ -83,8 +83,8 @@
     "@stoplight/yaml": "^4.3.0",
     "p-limit": "^7.2.0",
     "remeda": "^2.32.0",
-    "@kubb/core": "0.0.0-canary-20251103125929",
-    "@kubb/oas": "0.0.0-canary-20251103125929"
+    "@kubb/core": "0.0.0-canary-20251103140549",
+    "@kubb/oas": "0.0.0-canary-20251103140549"
   },
   "devDependencies": {},
   "peerDependencies": {

package/src/SchemaGenerator.ts

@@ -91,14 +91,6 @@ export class SchemaGenerator<
     return uniqueWith(schemas, isDeepEqual)
   }
 
-  deepSearch<T extends keyof SchemaKeywordMapper>(tree: Schema[] | undefined, keyword: T): Array<SchemaKeywordMapper[T]> {
-    return SchemaGenerator.deepSearch<T>(tree, keyword)
-  }
-
-  find<T extends keyof SchemaKeywordMapper>(tree: Schema[] | undefined, keyword: T): SchemaKeywordMapper[T] | undefined {
-    return SchemaGenerator.find<T>(tree, keyword)
-  }
-
   static deepSearch<T extends keyof SchemaKeywordMapper>(tree: Schema[] | undefined, keyword: T): Array<SchemaKeywordMapper[T]> {
     const foundItems: SchemaKeywordMapper[T][] = []
 
@@ -145,32 +137,6 @@ export class SchemaGenerator<
     return foundItems
   }
 
-  static findInObject<T extends keyof SchemaKeywordMapper>(tree: Schema[] | undefined, keyword: T): SchemaKeywordMapper[T] | undefined {
-    let foundItem: SchemaKeywordMapper[T] | undefined
-
-    tree?.forEach((schema) => {
-      if (!foundItem && schema.keyword === keyword) {
-        foundItem = schema as SchemaKeywordMapper[T]
-      }
-
-      if (isKeyword(schema, schemaKeywords.object)) {
-        Object.values(schema.args?.properties || {}).forEach((entrySchema) => {
-          if (!foundItem) {
-            foundItem = SchemaGenerator.find<T>(entrySchema, keyword)
-          }
-        })
-
-        Object.values(schema.args?.additionalProperties || {}).forEach((entrySchema) => {
-          if (!foundItem) {
-            foundItem = SchemaGenerator.find<T>([entrySchema], keyword)
-          }
-        })
-      }
-    })
-
-    return foundItem
-  }
-
   static find<T extends keyof SchemaKeywordMapper>(tree: Schema[] | undefined, keyword: T): SchemaKeywordMapper[T] | undefined {
     let foundItem: SchemaKeywordMapper[T] | undefined
 
@@ -563,13 +529,17 @@ export class SchemaGenerator<
     if (max !== undefined) {
       if (exclusiveMaximum) {
         baseItems.unshift({ keyword: schemaKeywords.exclusiveMaximum, args: max })
-      } else baseItems.unshift({ keyword: schemaKeywords.max, args: max })
+      } else {
+        baseItems.unshift({ keyword: schemaKeywords.max, args: max })
+      }
     }
 
     if (min !== undefined) {
       if (exclusiveMinimum) {
         baseItems.unshift({ keyword: schemaKeywords.exclusiveMinimum, args: min })
-      } else baseItems.unshift({ keyword: schemaKeywords.min, args: min })
+      } else {
+        baseItems.unshift({ keyword: schemaKeywords.min, args: min })
+      }
     }
 
     if (typeof exclusiveMaximum === 'number') {

package/src/utils/getSchemas.ts

@@ -8,9 +8,82 @@ type GetSchemasProps = {
   includes?: Mode[]
 }
 
+/**
+ * Collect all schema $ref dependencies recursively.
+ */
+function collectRefs(schema: unknown, refs = new Set<string>()): Set<string> {
+  if (Array.isArray(schema)) {
+    for (const item of schema) {
+      collectRefs(item, refs)
+    }
+    return refs
+  }
+
+  if (schema && typeof schema === 'object') {
+    for (const [key, value] of Object.entries(schema)) {
+      if (key === '$ref' && typeof value === 'string') {
+        const match = value.match(/^#\/components\/schemas\/(.+)$/)
+        if (match) {
+          refs.add(match[1]!)
+        }
+      } else {
+        collectRefs(value, refs)
+      }
+    }
+  }
+
+  return refs
+}
+
+/**
+ * Sort schemas topologically so referenced schemas appear first.
+ */
+function sortSchemas(schemas: Record<string, OasTypes.SchemaObject>): Record<string, OasTypes.SchemaObject> {
+  const deps = new Map<string, string[]>()
+
+  for (const [name, schema] of Object.entries(schemas)) {
+    deps.set(name, Array.from(collectRefs(schema)))
+  }
+
+  const sorted: string[] = []
+  const visited = new Set<string>()
+
+  function visit(name: string, stack = new Set<string>()) {
+    if (visited.has(name)) {
+      return
+    }
+    if (stack.has(name)) {
+      return
+    } // circular refs, ignore
+    stack.add(name)
+    const children = deps.get(name) || []
+    for (const child of children) {
+      if (deps.has(child)) {
+        visit(child, stack)
+      }
+    }
+    stack.delete(name)
+    visited.add(name)
+    sorted.push(name)
+  }
+
+  for (const name of Object.keys(schemas)) {
+    visit(name)
+  }
+
+  const sortedSchemas: Record<string, OasTypes.SchemaObject> = {}
+  for (const name of sorted) {
+    sortedSchemas[name] = schemas[name]!
+  }
+  return sortedSchemas
+}
+
+/**
+ * Collect schemas from OpenAPI components (schemas, responses, requestBodies)
+ * and return them in dependency order.
+ */
 export function getSchemas({ oas, contentType, includes = ['schemas', 'requestBodies', 'responses'] }: GetSchemasProps): Record<string, OasTypes.SchemaObject> {
   const components = oas.getDefinition().components
-
   let schemas: Record<string, OasTypes.SchemaObject> = {}
 
   if (includes.includes('schemas')) {
@@ -20,26 +93,27 @@ export function getSchemas({ oas, contentType, includes = ['schemas', 'requestBo
     }
   }
 
-  const requestBodies = components?.requestBodies || {}
   if (includes.includes('responses')) {
     const responses = components?.responses || {}
-
-    Object.entries(responses).forEach(([name, response]: [string, OasTypes.ResponseObject]) => {
-      if (response.content && !schemas[name]) {
-        const firstContentType = Object.keys(response.content)[0] || 'application/json'
-        schemas[name] = response.content?.[contentType || firstContentType]?.schema as OasTypes.SchemaObject
+    for (const [name, response] of Object.entries(responses)) {
+      const r = response as OasTypes.ResponseObject
+      if (r.content && !schemas[name]) {
+        const firstContentType = Object.keys(r.content)[0] || 'application/json'
+        schemas[name] = r.content?.[contentType || firstContentType]?.schema as OasTypes.SchemaObject
       }
-    })
+    }
   }
 
   if (includes.includes('requestBodies')) {
-    Object.entries(requestBodies).forEach(([name, request]: [string, OasTypes.RequestBodyObject]) => {
-      if (request.content && !schemas[name]) {
-        const firstContentType = Object.keys(request.content)[0] || 'application/json'
-        schemas[name] = request.content?.[contentType || firstContentType]?.schema as OasTypes.SchemaObject
+    const requestBodies = components?.requestBodies || {}
+    for (const [name, request] of Object.entries(requestBodies)) {
+      const r = request as OasTypes.RequestBodyObject
+      if (r.content && !schemas[name]) {
+        const firstContentType = Object.keys(r.content)[0] || 'application/json'
+        schemas[name] = r.content?.[contentType || firstContentType]?.schema as OasTypes.SchemaObject
       }
-    })
+    }
   }
 
-  return schemas
+  return sortSchemas(schemas)
 }