@kubb/core 5.0.0-alpha.30 → 5.0.0-alpha.31

package/dist/{chunk-ByKO4r7w.cjs → chunk-MlS0t1Af.cjs}

@@ -9,6 +9,15 @@ var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
 var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __exportAll = (all, no_symbols) => {
+	let target = {};
+	for (var name in all) __defProp(target, name, {
+		get: all[name],
+		enumerable: true
+	});
+	if (!no_symbols) __defProp(target, Symbol.toStringTag, { value: "Module" });
+	return target;
+};
 var __copyProps = (to, from, except, desc) => {
 	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
 		key = keys[i];
@@ -24,6 +33,12 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 	enumerable: true
 }) : target, mod));
 //#endregion
+Object.defineProperty(exports, "__exportAll", {
+	enumerable: true,
+	get: function() {
+		return __exportAll;
+	}
+});
 Object.defineProperty(exports, "__name", {
 	enumerable: true,
 	get: function() {

package/dist/chunk-O_arW02_.js

@@ -0,0 +1,17 @@
+//#region \0rolldown/runtime.js
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", {
+	value,
+	configurable: true
+});
+var __exportAll = (all, no_symbols) => {
+	let target = {};
+	for (var name in all) __defProp(target, name, {
+		get: all[name],
+		enumerable: true
+	});
+	if (!no_symbols) __defProp(target, Symbol.toStringTag, { value: "Module" });
+	return target;
+};
+//#endregion
+export { __name as n, __exportAll as t };

package/dist/hooks.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-require("./chunk-ByKO4r7w.cjs");
+require("./chunk-MlS0t1Af.cjs");
 let _kubb_react_fabric = require("@kubb/react-fabric");
 //#region src/hooks/useDriver.ts
 /**

package/dist/hooks.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"hooks.cjs","names":[],"sources":["../src/hooks/useDriver.ts","../src/hooks/useMode.ts","../src/hooks/usePlugin.ts"],"sourcesContent":["import { useFabric } from '@kubb/react-fabric'\nimport type { PluginDriver } from '../PluginDriver.ts'\n\n/**\n * @deprecated use `driver` from the generator component props instead\n */\nexport function useDriver(): PluginDriver {\n  const { meta } = useFabric<{ driver: PluginDriver }>()\n\n  return meta.driver\n}\n","import type { FabricFile } from '@kubb/fabric-core/types'\nimport { useFabric } from '@kubb/react-fabric'\n\n/**\n * @deprecated use `mode` from the generator component props instead\n */\nexport function useMode(): FabricFile.Mode {\n  const { meta } = useFabric<{ mode: FabricFile.Mode }>()\n\n  return meta.mode\n}\n","import { useFabric } from '@kubb/react-fabric'\nimport type { Plugin, PluginFactoryOptions } from '../types.ts'\n\n/**\n * @deprecated use `plugin` from the generator component props instead\n */\nexport function usePlugin<TOptions extends PluginFactoryOptions = PluginFactoryOptions>(): Plugin<TOptions> {\n  const { meta } = useFabric<{ plugin: Plugin<TOptions> }>()\n\n  return meta.plugin\n}\n"],"mappings":";;;;;;;AAMA,SAAgB,YAA0B;CACxC,MAAM,EAAE,UAAA,GAAA,mBAAA,YAA8C;AAEtD,QAAO,KAAK;;;;;;;ACHd,SAAgB,UAA2B;CACzC,MAAM,EAAE,UAAA,GAAA,mBAAA,YAA+C;AAEvD,QAAO,KAAK;;;;;;;ACHd,SAAgB,YAA4F;CAC1G,MAAM,EAAE,UAAA,GAAA,mBAAA,YAAkD;AAE1D,QAAO,KAAK"}
+{"version":3,"file":"hooks.cjs","names":[],"sources":["../src/hooks/useDriver.ts","../src/hooks/useMode.ts","../src/hooks/usePlugin.ts"],"sourcesContent":["import { useFabric } from '@kubb/react-fabric'\nimport type { PluginDriver } from '../PluginDriver.ts'\n\n/**\n * @deprecated use `driver` from the generator component props instead\n */\nexport function useDriver(): PluginDriver {\n  const { meta } = useFabric<{ driver: PluginDriver }>()\n\n  return meta.driver\n}\n","import { useFabric } from '@kubb/react-fabric'\nimport type * as KubbFile from '../KubbFile.ts'\n\n/**\n * @deprecated use `mode` from the generator component props instead\n */\nexport function useMode(): KubbFile.Mode {\n  const { meta } = useFabric<{ mode: KubbFile.Mode }>()\n\n  return meta.mode\n}\n","import { useFabric } from '@kubb/react-fabric'\nimport type { Plugin, PluginFactoryOptions } from '../types.ts'\n\n/**\n * @deprecated use `plugin` from the generator component props instead\n */\nexport function usePlugin<TOptions extends PluginFactoryOptions = PluginFactoryOptions>(): Plugin<TOptions> {\n  const { meta } = useFabric<{ plugin: Plugin<TOptions> }>()\n\n  return meta.plugin\n}\n"],"mappings":";;;;;;;AAMA,SAAgB,YAA0B;CACxC,MAAM,EAAE,UAAA,GAAA,mBAAA,YAA8C;AAEtD,QAAO,KAAK;;;;;;;ACHd,SAAgB,UAAyB;CACvC,MAAM,EAAE,UAAA,GAAA,mBAAA,YAA6C;AAErD,QAAO,KAAK;;;;;;;ACHd,SAAgB,YAA4F;CAC1G,MAAM,EAAE,UAAA,GAAA,mBAAA,YAAkD;AAE1D,QAAO,KAAK"}

package/dist/hooks.d.ts

@@ -1,6 +1,5 @@
-import { t as __name } from "./chunk--u3MIqq1.js";
-import { C as Plugin, T as PluginFactoryOptions, t as PluginDriver } from "./PluginDriver-D110FoJ-.js";
-import { FabricFile } from "@kubb/fabric-core/types";
+import { n as __name } from "./chunk-O_arW02_.js";
+import { C as Plugin, T as PluginFactoryOptions, t as PluginDriver, vt as Mode } from "./PluginDriver-D0dY_hpJ.js";
 
 //#region src/hooks/useDriver.d.ts
 /**
@@ -12,7 +11,7 @@ declare function useDriver(): PluginDriver;
 /**
  * @deprecated use `mode` from the generator component props instead
  */
-declare function useMode(): FabricFile.Mode;
+declare function useMode(): Mode;
 //#endregion
 //#region src/hooks/usePlugin.d.ts
 /**

package/dist/hooks.js

@@ -1,4 +1,4 @@
-import "./chunk--u3MIqq1.js";
+import "./chunk-O_arW02_.js";
 import { useFabric } from "@kubb/react-fabric";
 //#region src/hooks/useDriver.ts
 /**

package/dist/hooks.js.map

@@ -1 +1 @@
-{"version":3,"file":"hooks.js","names":[],"sources":["../src/hooks/useDriver.ts","../src/hooks/useMode.ts","../src/hooks/usePlugin.ts"],"sourcesContent":["import { useFabric } from '@kubb/react-fabric'\nimport type { PluginDriver } from '../PluginDriver.ts'\n\n/**\n * @deprecated use `driver` from the generator component props instead\n */\nexport function useDriver(): PluginDriver {\n  const { meta } = useFabric<{ driver: PluginDriver }>()\n\n  return meta.driver\n}\n","import type { FabricFile } from '@kubb/fabric-core/types'\nimport { useFabric } from '@kubb/react-fabric'\n\n/**\n * @deprecated use `mode` from the generator component props instead\n */\nexport function useMode(): FabricFile.Mode {\n  const { meta } = useFabric<{ mode: FabricFile.Mode }>()\n\n  return meta.mode\n}\n","import { useFabric } from '@kubb/react-fabric'\nimport type { Plugin, PluginFactoryOptions } from '../types.ts'\n\n/**\n * @deprecated use `plugin` from the generator component props instead\n */\nexport function usePlugin<TOptions extends PluginFactoryOptions = PluginFactoryOptions>(): Plugin<TOptions> {\n  const { meta } = useFabric<{ plugin: Plugin<TOptions> }>()\n\n  return meta.plugin\n}\n"],"mappings":";;;;;;AAMA,SAAgB,YAA0B;CACxC,MAAM,EAAE,SAAS,WAAqC;AAEtD,QAAO,KAAK;;;;;;;ACHd,SAAgB,UAA2B;CACzC,MAAM,EAAE,SAAS,WAAsC;AAEvD,QAAO,KAAK;;;;;;;ACHd,SAAgB,YAA4F;CAC1G,MAAM,EAAE,SAAS,WAAyC;AAE1D,QAAO,KAAK"}
+{"version":3,"file":"hooks.js","names":[],"sources":["../src/hooks/useDriver.ts","../src/hooks/useMode.ts","../src/hooks/usePlugin.ts"],"sourcesContent":["import { useFabric } from '@kubb/react-fabric'\nimport type { PluginDriver } from '../PluginDriver.ts'\n\n/**\n * @deprecated use `driver` from the generator component props instead\n */\nexport function useDriver(): PluginDriver {\n  const { meta } = useFabric<{ driver: PluginDriver }>()\n\n  return meta.driver\n}\n","import { useFabric } from '@kubb/react-fabric'\nimport type * as KubbFile from '../KubbFile.ts'\n\n/**\n * @deprecated use `mode` from the generator component props instead\n */\nexport function useMode(): KubbFile.Mode {\n  const { meta } = useFabric<{ mode: KubbFile.Mode }>()\n\n  return meta.mode\n}\n","import { useFabric } from '@kubb/react-fabric'\nimport type { Plugin, PluginFactoryOptions } from '../types.ts'\n\n/**\n * @deprecated use `plugin` from the generator component props instead\n */\nexport function usePlugin<TOptions extends PluginFactoryOptions = PluginFactoryOptions>(): Plugin<TOptions> {\n  const { meta } = useFabric<{ plugin: Plugin<TOptions> }>()\n\n  return meta.plugin\n}\n"],"mappings":";;;;;;AAMA,SAAgB,YAA0B;CACxC,MAAM,EAAE,SAAS,WAAqC;AAEtD,QAAO,KAAK;;;;;;;ACHd,SAAgB,UAAyB;CACvC,MAAM,EAAE,SAAS,WAAoC;AAErD,QAAO,KAAK;;;;;;;ACHd,SAAgB,YAA4F;CAC1G,MAAM,EAAE,SAAS,WAAyC;AAE1D,QAAO,KAAK"}

package/dist/index.cjs

@@ -2,7 +2,7 @@ Object.defineProperties(exports, {
 	__esModule: { value: true },
 	[Symbol.toStringTag]: { value: "Module" }
 });
-const require_chunk = require("./chunk-ByKO4r7w.cjs");
+const require_chunk = require("./chunk-MlS0t1Af.cjs");
 let node_events = require("node:events");
 let node_fs = require("node:fs");
 let node_fs_promises = require("node:fs/promises");
@@ -10,7 +10,6 @@ let node_path = require("node:path");
 node_path = require_chunk.__toESM(node_path);
 let _kubb_ast = require("@kubb/ast");
 let _kubb_react_fabric = require("@kubb/react-fabric");
-let _kubb_react_fabric_parsers = require("@kubb/react-fabric/parsers");
 let _kubb_react_fabric_plugins = require("@kubb/react-fabric/plugins");
 let node_perf_hooks = require("node:perf_hooks");
 let fflate = require("fflate");
@@ -621,17 +620,6 @@ var URLPath = class {
 	}
 };
 //#endregion
-//#region src/config.ts
-function defineConfig(config) {
-	return config;
-}
-/**
-* Type guard to check if a given config has an `input.path`.
-*/
-function isInputPath(config) {
-	return typeof config?.input === "object" && config.input !== null && "path" in config.input;
-}
-//#endregion
 //#region src/constants.ts
 /**
 * Base URL for the Kubb Studio web app.
@@ -723,6 +711,34 @@ const formatters = {
 	}
 };
 //#endregion
+//#region src/defineParser.ts
+/**
+* Defines a parser with type safety.
+*
+* Use this function to create parsers that transform generated files to strings
+* based on their extension.
+*
+* @example
+* ```ts
+* import { defineParser } from '@kubb/core'
+*
+* export const jsonParser = defineParser({
+*   name: 'json',
+*   extNames: ['.json'],
+*   parse(file) {
+*     return file.sources.map((s) => s.value).join('\n')
+*   },
+* })
+* ```
+*/
+function defineParser(parser) {
+	return {
+		install() {},
+		type: "parser",
+		...parser
+	};
+}
+//#endregion
 //#region src/devtools.ts
 /**
 * Encodes a `RootNode` as a compressed, URL-safe string.
@@ -1357,7 +1373,7 @@ var PluginDriver = class {
 * Handles the return value of a plugin AST hook or generator method.
 *
 * - React element → rendered via an isolated react-fabric context, files merged into `fabric`
-* - `Array<FabricFile.File>` → upserted directly into `fabric`
+* - `Array<KubbFile.File>` → upserted directly into `fabric`
 * - `void` / `null` / `undefined` → no-op (plugin handled it via `this.upsertFile`)
 */
 async function applyHookResult(result, fabric) {
@@ -1469,7 +1485,7 @@ const fsStorage = createStorage(() => ({
 }));
 //#endregion
 //#region package.json
-var version = "5.0.0-alpha.30";
+var version = "5.0.0-alpha.31";
 //#endregion
 //#region src/utils/diagnostics.ts
 /**
@@ -1491,7 +1507,7 @@ function getDiagnosticInfo() {
 //#region src/utils/TreeNode.ts
 /**
 * Tree structure used to build per-directory barrel (`index.ts`) files from a
-* flat list of generated {@link FabricFile.File} entries.
+* flat list of generated {@link KubbFile.File} entries.
 *
 * Each node represents either a directory or a file within the output tree.
 * Use {@link TreeNode.build} to construct a root node from a file list, then
@@ -1723,6 +1739,14 @@ async function getBarrelFiles(files, { type, meta = {}, root, output }) {
 	});
 }
 //#endregion
+//#region src/utils/isInputPath.ts
+/**
+* Type guard to check if a given config has an `input.path`.
+*/
+function isInputPath(config) {
+	return typeof config?.input === "object" && config.input !== null && "path" in config.input;
+}
+//#endregion
 //#region src/build.ts
 /**
 * Initializes all Kubb infrastructure for a build without executing any plugins.
@@ -1731,6 +1755,7 @@ async function getBarrelFiles(files, { type, meta = {}, root, output }) {
 * - Applies config defaults (`root`, `output.*`, `devtools`).
 * - Creates the Fabric instance and wires storage, format, and lint hooks.
 * - Runs the adapter (if configured) to produce the universal `RootNode`.
+*   When no adapter is supplied and `@kubb/adapter-oas` is installed as an
 *
 * Pass the returned {@link SetupResult} directly to {@link safeBuild} or {@link build}
 * via the `overrides` argument to reuse the same infrastructure across multiple runs.
@@ -1770,9 +1795,12 @@ async function setup(options) {
 			throw new Error(`Cannot read file/URL defined in \`input.path\` or set with \`kubb generate PATH\` in the CLI of your Kubb config ${userConfig.input.path}`, { cause: error });
 		}
 	}
-	const definedConfig = {
+	if (!userConfig.adapter) throw new Error("Adapter should be defined");
+	const config = {
 		root: userConfig.root || process.cwd(),
 		...userConfig,
+		parsers: userConfig.parsers ?? [],
+		adapter: userConfig.adapter,
 		output: {
 			write: true,
 			barrelType: "named",
@@ -1786,17 +1814,24 @@ async function setup(options) {
 		} : void 0,
 		plugins: userConfig.plugins
 	};
-	const storage = definedConfig.output.write === false ? null : definedConfig.output.storage ?? fsStorage();
-	if (definedConfig.output.clean) {
+	const storage = config.output.write === false ? null : config.output.storage ?? fsStorage();
+	if (config.output.clean) {
 		await events.emit("debug", {
 			date: /* @__PURE__ */ new Date(),
-			logs: ["Cleaning output directories", `  • Output: ${definedConfig.output.path}`]
+			logs: ["Cleaning output directories", `  • Output: ${config.output.path}`]
 		});
-		await storage?.clear((0, node_path.resolve)(definedConfig.root, definedConfig.output.path));
+		await storage?.clear((0, node_path.resolve)(config.root, config.output.path));
 	}
 	const fabric = (0, _kubb_react_fabric.createFabric)();
 	fabric.use(_kubb_react_fabric_plugins.fsPlugin);
-	fabric.use(_kubb_react_fabric_parsers.typescriptParser);
+	for (const parser of config.parsers) fabric.use(parser);
+	fabric.use(defineParser({
+		name: "fallback",
+		extNames: void 0,
+		parse(file) {
+			return file.sources.map((item) => item.value).filter((value) => value != null).join("\n\n");
+		}
+	}));
 	fabric.context.on("files:processing:start", (files) => {
 		events.emit("files:processing:start", files);
 		events.emit("debug", {
@@ -1808,11 +1843,11 @@ async function setup(options) {
 		const { file, source } = params;
 		await events.emit("file:processing:update", {
 			...params,
-			config: definedConfig,
+			config,
 			source
 		});
 		if (source) {
-			const key = (0, node_path.relative)((0, node_path.resolve)(definedConfig.root), file.path);
+			const key = (0, node_path.relative)((0, node_path.resolve)(config.root), file.path);
 			await storage?.setItem(key, source);
 			sources.set(file.path, source);
 		}
@@ -1829,35 +1864,36 @@ async function setup(options) {
 		logs: [
 			"✓ Fabric initialized",
 			`  • Storage: ${storage ? storage.name : "disabled (dry-run)"}`,
-			`  • Barrel type: ${definedConfig.output.barrelType || "none"}`
+			`  • Barrel type: ${config.output.barrelType || "none"}`
 		]
 	});
-	const pluginDriver = new PluginDriver(definedConfig, {
+	const driver = new PluginDriver(config, {
 		fabric,
 		events,
 		concurrency: 15
 	});
-	if (definedConfig.adapter) {
-		const source = inputToAdapterSource(definedConfig);
-		await events.emit("debug", {
-			date: /* @__PURE__ */ new Date(),
-			logs: [`Running adapter: ${definedConfig.adapter.name}`]
-		});
-		pluginDriver.adapter = definedConfig.adapter;
-		pluginDriver.rootNode = await definedConfig.adapter.parse(source);
-		await events.emit("debug", {
-			date: /* @__PURE__ */ new Date(),
-			logs: [
-				`✓ Adapter '${definedConfig.adapter.name}' resolved RootNode`,
-				`  • Schemas: ${pluginDriver.rootNode.schemas.length}`,
-				`  • Operations: ${pluginDriver.rootNode.operations.length}`
-			]
-		});
-	}
+	const adapter = config.adapter;
+	if (!adapter) throw new Error("No adapter configured. Please provide an adapter in your kubb.config.ts.");
+	const source = inputToAdapterSource(config);
+	await events.emit("debug", {
+		date: /* @__PURE__ */ new Date(),
+		logs: [`Running adapter: ${adapter.name}`]
+	});
+	driver.adapter = adapter;
+	driver.rootNode = await adapter.parse(source);
+	await events.emit("debug", {
+		date: /* @__PURE__ */ new Date(),
+		logs: [
+			`✓ Adapter '${adapter.name}' resolved RootNode`,
+			`  • Schemas: ${driver.rootNode.schemas.length}`,
+			`  • Operations: ${driver.rootNode.operations.length}`
+		]
+	});
 	return {
+		config,
 		events,
 		fabric,
-		driver: pluginDriver,
+		driver,
 		sources
 	};
 }
@@ -1891,7 +1927,7 @@ async function build(options, overrides) {
 * - Each hook accepts a single handler **or an array** — all entries are called in sequence.
 * - Nodes that are excluded by `exclude`/`include` plugin options are skipped automatically.
 * - Return values are handled via `applyHookResult`: React elements are rendered,
-*   `FabricFile.File[]` are written via upsert, and `void` is a no-op (manual handling).
+*   `KubbFile.File[]` are written via upsert, and `void` is a no-op (manual handling).
 * - Barrel files are generated automatically when `output.barrelType` is set.
 */
 async function runPluginAstHooks(plugin, context) {
@@ -2154,6 +2190,11 @@ function createPlugin(build) {
 	return (options) => build(options ?? {});
 }
 //#endregion
+//#region src/defineConfig.ts
+function defineConfig(config) {
+	return config;
+}
+//#endregion
 //#region src/defineGenerator.ts
 /**
 * Defines a generator. Returns the object as-is with correct `this` typings.
@@ -2379,7 +2420,7 @@ function defaultResolvePath({ baseName, pathMode, tag, path: groupPath }, { root
 /**
 * Default file resolver used by `defineResolver`.
 *
-* Resolves a `FabricFile.File` by combining name resolution (`resolver.default`) with
+* Resolves a `KubbFile.File` by combining name resolution (`resolver.default`) with
 * path resolution (`resolver.resolvePath`). The resolved file always has empty
 * `sources`, `imports`, and `exports` arrays — consumers populate those separately.
 *
@@ -2529,7 +2570,7 @@ function defaultResolveFooter(node, { output }) {
 * - `default` — name casing strategy (camelCase / PascalCase)
 * - `resolveOptions` — include/exclude/override filtering
 * - `resolvePath` — output path computation
-* - `resolveFile` — full `FabricFile.File` construction
+* - `resolveFile` — full `KubbFile.File` construction
 *
 * Methods in the builder have access to `this` (the full resolver object), so they
 * can call other resolver methods without circular imports.
@@ -2579,6 +2620,9 @@ function defineResolver(build) {
 	};
 }
 //#endregion
+//#region src/KubbFile.ts
+var KubbFile_exports = /* @__PURE__ */ require_chunk.__exportAll({});
+//#endregion
 //#region src/storages/memoryStorage.ts
 /**
 * In-memory storage driver. Useful for testing and dry-run scenarios where
@@ -2883,6 +2927,12 @@ function satisfiesDependency(dependency, version, cwd) {
 //#endregion
 exports.AsyncEventEmitter = AsyncEventEmitter;
 exports.FunctionParams = FunctionParams;
+Object.defineProperty(exports, "KubbFile", {
+	enumerable: true,
+	get: function() {
+		return KubbFile_exports;
+	}
+});
 exports.PluginDriver = PluginDriver;
 exports.URLPath = URLPath;
 exports.build = build;
@@ -2905,6 +2955,7 @@ exports.defaultResolvePath = defaultResolvePath;
 exports.defineConfig = defineConfig;
 exports.defineGenerator = defineGenerator;
 exports.defineLogger = defineLogger;
+exports.defineParser = defineParser;
 exports.definePresets = definePresets;
 Object.defineProperty(exports, "definePrinter", {
 	enumerable: true,