@kubb/core 5.0.0-alpha.22 → 5.0.0-alpha.23

package/dist/index.cjs

@@ -22,14 +22,6 @@ let empathic_package = require("empathic/package");
 empathic_package = require_chunk.__toESM(empathic_package);
 let semver = require("semver");
 //#region ../../internals/utils/src/errors.ts
-/** Thrown when a plugin's configuration or input fails validation.
-*
-* @example
-* ```ts
-* throw new ValidationPluginError('Invalid config: "output.path" is required')
-* ```
-*/
-var ValidationPluginError = class extends Error {};
 /**
 * Thrown when one or more errors occur during a Kubb build.
 * Carries the full list of underlying errors on `errors`.
@@ -350,28 +342,6 @@ async function clean(path) {
 	});
 }
 //#endregion
-//#region ../../internals/utils/src/names.ts
-/**
-* Registers `originalName` in `data` without altering the returned name.
-* Use when you need to track usage frequency but always emit the original identifier.
-*
-* @example
-* ```ts
-* const seen: Record<string, number> = {}
-* setUniqueName('Foo', seen) // 'Foo'  (seen = { Foo: 1 })
-* setUniqueName('Foo', seen) // 'Foo'  (seen = { Foo: 2 })
-* ```
-*/
-function setUniqueName(originalName, data) {
-	let used = data[originalName] || 0;
-	if (used) {
-		data[originalName] = ++used;
-		return originalName;
-	}
-	data[originalName] = 1;
-	return originalName;
-}
-//#endregion
 //#region ../../internals/utils/src/promise.ts
 /** Returns `true` when `result` is a rejected `Promise.allSettled` result with a typed `reason`.
 *
@@ -995,29 +965,30 @@ var PluginDriver = class {
 	rootNode = void 0;
 	adapter = void 0;
 	#studioIsOpen = false;
-	#plugins = /* @__PURE__ */ new Set();
-	#usedPluginNames = {};
+	plugins = /* @__PURE__ */ new Map();
 	constructor(config, options) {
 		this.config = config;
 		this.options = options;
-		[...config.plugins || []].forEach((plugin) => {
-			const parsedPlugin = this.#parse(plugin);
-			this.#plugins.add(parsedPlugin);
+		config.plugins.map((plugin) => Object.assign({ install() {} }, plugin)).sort((a, b) => {
+			if (b.pre?.includes(a.name)) return 1;
+			if (b.post?.includes(a.name)) return -1;
+			return 0;
+		}).forEach((plugin) => {
+			this.plugins.set(plugin.name, plugin);
 		});
 	}
 	get events() {
 		return this.options.events;
 	}
 	getContext(plugin) {
-		const plugins = [...this.#plugins];
 		const driver = this;
 		const baseContext = {
-			fabric: this.options.fabric,
-			config: this.config,
+			fabric: driver.options.fabric,
+			config: driver.config,
 			plugin,
-			events: this.options.events,
-			driver: this,
-			mode: getMode((0, node_path.resolve)(this.config.root, this.config.output.path)),
+			getPlugin: driver.getPlugin.bind(driver),
+			events: driver.options.events,
+			driver,
 			addFile: async (...files) => {
 				await this.options.fabric.addFile(...files);
 			},
@@ -1030,6 +1001,9 @@ var PluginDriver = class {
 			get adapter() {
 				return driver.adapter;
 			},
+			get resolver() {
+				return plugin.resolver;
+			},
 			openInStudio(options) {
 				if (!driver.config.devtools || driver.#studioIsOpen) return;
 				if (typeof driver.config.devtools !== "object") throw new Error("Devtools must be an object");
@@ -1040,8 +1014,8 @@ var PluginDriver = class {
 			}
 		};
 		const mergedExtras = {};
-		for (const p of plugins) if (typeof p.inject === "function") {
-			const result = p.inject.call(baseContext, baseContext);
+		for (const plugin of this.plugins.values()) if (typeof plugin.inject === "function") {
+			const result = plugin.inject.call(baseContext, baseContext);
 			if (result !== null && typeof result === "object") Object.assign(mergedExtras, result);
 		}
 		return {
@@ -1049,9 +1023,9 @@ var PluginDriver = class {
 			...mergedExtras
 		};
 	}
-	get plugins() {
-		return this.#getSortedPlugins();
-	}
+	/**
+	* @deprecated use resolvers context instead
+	*/
 	getFile({ name, mode, extname, pluginName, options }) {
 		const resolvedName = mode ? mode === "single" ? "" : this.resolveName({
 			name,
@@ -1074,6 +1048,9 @@ var PluginDriver = class {
 			exports: []
 		};
 	}
+	/**
+	* @deprecated use resolvers context instead
+	*/
 	resolvePath = (params) => {
 		const defaultPath = (0, node_path.resolve)((0, node_path.resolve)(this.config.root, this.config.output.path), params.baseName);
 		if (params.pluginName) return this.hookForPluginSync({
@@ -1094,15 +1071,15 @@ var PluginDriver = class {
 			]
 		})?.result || defaultPath;
 	};
+	/**
+	* @deprecated use resolvers context instead
+	*/
 	resolveName = (params) => {
-		if (params.pluginName) {
-			const names = this.hookForPluginSync({
-				pluginName: params.pluginName,
-				hookName: "resolveName",
-				parameters: [params.name.trim(), params.type]
-			});
-			return transformReservedWord([...new Set(names)].at(0) || params.name);
-		}
+		if (params.pluginName) return transformReservedWord(this.hookForPluginSync({
+			pluginName: params.pluginName,
+			hookName: "resolveName",
+			parameters: [params.name.trim(), params.type]
+		})?.at(0) ?? params.name);
 		const name = this.hookFirstSync({
 			hookName: "resolveName",
 			parameters: [params.name.trim(), params.type]
@@ -1113,44 +1090,41 @@ var PluginDriver = class {
 	* Run a specific hookName for plugin x.
 	*/
 	async hookForPlugin({ pluginName, hookName, parameters }) {
-		const plugins = this.getPluginsByName(hookName, pluginName);
+		const plugin = this.plugins.get(pluginName);
+		if (!plugin) return [null];
 		this.events.emit("plugins:hook:progress:start", {
 			hookName,
-			plugins
+			plugins: [plugin]
+		});
+		const result = await this.#execute({
+			strategy: "hookFirst",
+			hookName,
+			parameters,
+			plugin
 		});
-		const items = [];
-		for (const plugin of plugins) {
-			const result = await this.#execute({
-				strategy: "hookFirst",
-				hookName,
-				parameters,
-				plugin
-			});
-			if (result !== void 0 && result !== null) items.push(result);
-		}
 		this.events.emit("plugins:hook:progress:end", { hookName });
-		return items;
+		return [result];
 	}
 	/**
 	* Run a specific hookName for plugin x.
 	*/
 	hookForPluginSync({ pluginName, hookName, parameters }) {
-		return this.getPluginsByName(hookName, pluginName).map((plugin) => {
-			return this.#executeSync({
-				strategy: "hookFirst",
-				hookName,
-				parameters,
-				plugin
-			});
-		}).filter((x) => x !== null);
+		const plugin = this.plugins.get(pluginName);
+		if (!plugin) return null;
+		const result = this.#executeSync({
+			strategy: "hookFirst",
+			hookName,
+			parameters,
+			plugin
+		});
+		return result !== null ? [result] : [];
 	}
 	/**
 	* Returns the first non-null result.
 	*/
 	async hookFirst({ hookName, parameters, skipped }) {
-		const plugins = this.#getSortedPlugins(hookName).filter((plugin) => {
-			return skipped ? !skipped.has(plugin) : true;
-		});
+		const plugins = [];
+		for (const plugin of this.plugins.values()) if (hookName in plugin && (skipped ? !skipped.has(plugin) : true)) plugins.push(plugin);
 		this.events.emit("plugins:hook:progress:start", {
 			hookName,
 			plugins
@@ -1177,10 +1151,9 @@ var PluginDriver = class {
 	*/
 	hookFirstSync({ hookName, parameters, skipped }) {
 		let parseResult = null;
-		const plugins = this.#getSortedPlugins(hookName).filter((plugin) => {
-			return skipped ? !skipped.has(plugin) : true;
-		});
-		for (const plugin of plugins) {
+		for (const plugin of this.plugins.values()) {
+			if (!(hookName in plugin)) continue;
+			if (skipped?.has(plugin)) continue;
 			parseResult = {
 				result: this.#executeSync({
 					strategy: "hookFirst",
@@ -1190,7 +1163,7 @@ var PluginDriver = class {
 				}),
 				plugin
 			};
-			if (parseResult?.result != null) break;
+			if (parseResult.result != null) break;
 		}
 		return parseResult;
 	}
@@ -1198,7 +1171,8 @@ var PluginDriver = class {
 	* Runs all plugins in parallel based on `this.plugin` order and `pre`/`post` settings.
 	*/
 	async hookParallel({ hookName, parameters }) {
-		const plugins = this.#getSortedPlugins(hookName);
+		const plugins = [];
+		for (const plugin of this.plugins.values()) if (hookName in plugin) plugins.push(plugin);
 		this.events.emit("plugins:hook:progress:start", {
 			hookName,
 			plugins
@@ -1217,7 +1191,7 @@ var PluginDriver = class {
 		}), this.options.concurrency);
 		results.forEach((result, index) => {
 			if (isPromiseRejectedResult(result)) {
-				const plugin = this.#getSortedPlugins(hookName)[index];
+				const plugin = plugins[index];
 				if (plugin) {
 					const startTime = pluginStartTimes.get(plugin) ?? node_perf_hooks.performance.now();
 					this.events.emit("error", result.reason, {
@@ -1240,7 +1214,8 @@ var PluginDriver = class {
 	* Chains plugins
 	*/
 	async hookSeq({ hookName, parameters }) {
-		const plugins = this.#getSortedPlugins(hookName);
+		const plugins = [];
+		for (const plugin of this.plugins.values()) if (hookName in plugin) plugins.push(plugin);
 		this.events.emit("plugins:hook:progress:start", {
 			hookName,
 			plugins
@@ -1255,33 +1230,8 @@ var PluginDriver = class {
 		}));
 		this.events.emit("plugins:hook:progress:end", { hookName });
 	}
-	#getSortedPlugins(hookName) {
-		const plugins = [...this.#plugins];
-		if (hookName) return plugins.filter((plugin) => hookName in plugin);
-		return plugins.map((plugin) => {
-			if (plugin.pre) {
-				let missingPlugins = plugin.pre.filter((pluginName) => !plugins.find((pluginToFind) => pluginToFind.name === pluginName));
-				if (missingPlugins.includes("plugin-oas") && this.adapter) missingPlugins = missingPlugins.filter((pluginName) => pluginName !== "plugin-oas");
-				if (missingPlugins.length > 0) throw new ValidationPluginError(`The plugin '${plugin.name}' has a pre set that references missing plugins for '${missingPlugins.join(", ")}'`);
-			}
-			return plugin;
-		}).sort((a, b) => {
-			if (b.pre?.includes(a.name)) return 1;
-			if (b.post?.includes(a.name)) return -1;
-			return 0;
-		});
-	}
-	getPluginByName(pluginName) {
-		return [...this.#plugins].find((item) => item.name === pluginName);
-	}
-	getPluginsByName(hookName, pluginName) {
-		const plugins = [...this.plugins];
-		const pluginByPluginName = plugins.filter((plugin) => hookName in plugin).filter((item) => item.name === pluginName);
-		if (!pluginByPluginName?.length) {
-			const corePlugin = plugins.find((plugin) => plugin.name === "core" && hookName in plugin);
-			return corePlugin ? [corePlugin] : [];
-		}
-		return pluginByPluginName;
+	getPlugin(pluginName) {
+		return this.plugins.get(pluginName);
 	}
 	/**
 	* Run an async plugin hook and return the result.
@@ -1369,16 +1319,6 @@ var PluginDriver = class {
 			return null;
 		}
 	}
-	#parse(plugin) {
-		const usedPluginNames = this.#usedPluginNames;
-		setUniqueName(plugin.name, usedPluginNames);
-		const usageCount = usedPluginNames[plugin.name];
-		if (usageCount && usageCount > 1) throw new ValidationPluginError(`Duplicate plugin "${plugin.name}" detected. Each plugin can only be used once. Use a different configuration instead of adding multiple instances of the same plugin.`);
-		return {
-			install() {},
-			...plugin
-		};
-	}
 };
 //#endregion
 //#region src/createStorage.ts
@@ -1478,7 +1418,7 @@ const fsStorage = createStorage(() => ({
 }));
 //#endregion
 //#region package.json
-var version = "5.0.0-alpha.22";
+var version = "5.0.0-alpha.23";
 //#endregion
 //#region src/utils/diagnostics.ts
 /**
@@ -1674,7 +1614,7 @@ async function safeBuild(options, overrides) {
 	const pluginTimings = /* @__PURE__ */ new Map();
 	const config = driver.config;
 	try {
-		for (const plugin of driver.plugins) {
+		for (const plugin of driver.plugins.values()) {
 			const context = driver.getContext(plugin);
 			const hrStart = process.hrtime();
 			const installer = plugin.install.bind(context);
@@ -1784,7 +1724,7 @@ async function safeBuild(options, overrides) {
 }
 function buildBarrelExports({ barrelFiles, rootDir, existingExports, config, driver }) {
 	const pluginNameMap = /* @__PURE__ */ new Map();
-	for (const plugin of driver.plugins) pluginNameMap.set(plugin.name, plugin);
+	for (const plugin of driver.plugins.values()) pluginNameMap.set(plugin.name, plugin);
 	return barrelFiles.flatMap((file) => {
 		const containsOnlyTypes = file.sources?.every((source) => source.isTypeOnly);
 		return (file.sources ?? []).flatMap((source) => {
@@ -1866,26 +1806,6 @@ function createPlugin(build) {
 	return (options) => build(options ?? {});
 }
 //#endregion
-//#region src/defineBuilder.ts
-/**
-* Defines a builder for a plugin — a named collection of schema-building helpers that
-* can be exported alongside the plugin and imported by other plugins or generators.
-*
-* @example
-* export const builder = defineBuilder<PluginTs>(() => ({
-*   name: 'default',
-*   buildParamsSchema({ params, node, resolver }) {
-*     return createSchema({ type: 'object', properties: [] })
-*   },
-*   buildDataSchemaNode({ node, resolver }) {
-*     return createSchema({ type: 'object', properties: [] })
-*   },
-* }))
-*/
-function defineBuilder(build) {
-	return build();
-}
-//#endregion
 //#region src/defineGenerator.ts
 function defineGenerator(generator) {
 	if (generator.type === "react") return {
@@ -1933,34 +1853,6 @@ function defineLogger(logger) {
 	return logger;
 }
 //#endregion
-//#region src/definePreset.ts
-/**
-* Creates a typed preset object that bundles a name, resolvers, optional
-* transformers, and optional generators — the building block for composable plugin presets.
-*
-* @example
-* import { definePreset } from '@kubb/core'
-* import { resolverTsLegacy } from '@kubb/plugin-ts'
-*
-* export const myPreset = definePreset('myPreset', { resolvers: [resolverTsLegacy] })
-*
-* @example
-* // With custom transformers
-* export const myPreset = definePreset('myPreset', { resolvers: [resolverTsLegacy], transformers: [myTransformer] })
-*
-* @example
-* // With generators
-* export const myPreset = definePreset('myPreset', { resolvers: [resolverTsLegacy], generators: [typeGeneratorLegacy] })
-*/
-function definePreset(name, { resolvers, transformers, generators }) {
-	return {
-		name,
-		resolvers,
-		transformers,
-		generators
-	};
-}
-//#endregion
 //#region src/definePresets.ts
 /**
 * Creates a typed presets registry object — a named collection of {@link Preset} entries.
@@ -2107,13 +1999,7 @@ function defaultResolveOptions(node, { options, exclude = [], include, override
 */
 function defaultResolvePath({ baseName, pathMode, tag, path: groupPath }, { root, output, group }) {
 	if ((pathMode ?? getMode(node_path.default.resolve(root, output.path))) === "single") return node_path.default.resolve(root, output.path);
-	if (group && (groupPath || tag)) {
-		const groupName = group.name ? group.name : (ctx) => {
-			if (group.type === "path") return `${ctx.group.split("/")[1]}`;
-			return `${camelCase(ctx.group)}Controller`;
-		};
-		return node_path.default.resolve(root, output.path, groupName({ group: group.type === "path" ? groupPath : tag }), baseName);
-	}
+	if (group && (groupPath || tag)) return node_path.default.resolve(root, output.path, group.name({ group: group.type === "path" ? groupPath : tag }), baseName);
 	return node_path.default.resolve(root, output.path, baseName);
 }
 /**
@@ -2313,19 +2199,15 @@ async function renderOperations(nodes, options) {
 	const { config, fabric, plugin, Component, driver, adapter } = options;
 	if (!Component) return;
 	const fabricChild = (0, _kubb_react_fabric.createReactFabric)();
-	await fabricChild.render(/* @__PURE__ */ (0, _kubb_react_fabric_jsx_runtime.jsx)(_kubb_react_fabric.Fabric, {
-		meta: {
-			plugin,
-			driver
-		},
-		children: /* @__PURE__ */ (0, _kubb_react_fabric_jsx_runtime.jsx)(Component, {
-			config,
-			plugin,
-			adapter,
-			nodes,
-			options: options.options
-		})
-	}));
+	await fabricChild.render(/* @__PURE__ */ (0, _kubb_react_fabric_jsx_runtime.jsx)(_kubb_react_fabric.Fabric, { children: /* @__PURE__ */ (0, _kubb_react_fabric_jsx_runtime.jsx)(Component, {
+		config,
+		plugin,
+		driver,
+		adapter,
+		nodes,
+		options: options.options,
+		resolver: options.resolver
+	}) }));
 	fabric.context.fileManager.upsert(...fabricChild.files);
 	fabricChild.unmount();
 }
@@ -2336,19 +2218,15 @@ async function renderOperation(node, options) {
 	const { config, fabric, plugin, Component, adapter, driver } = options;
 	if (!Component) return;
 	const fabricChild = (0, _kubb_react_fabric.createReactFabric)();
-	await fabricChild.render(/* @__PURE__ */ (0, _kubb_react_fabric_jsx_runtime.jsx)(_kubb_react_fabric.Fabric, {
-		meta: {
-			plugin,
-			driver
-		},
-		children: /* @__PURE__ */ (0, _kubb_react_fabric_jsx_runtime.jsx)(Component, {
-			config,
-			plugin,
-			adapter,
-			node,
-			options: options.options
-		})
-	}));
+	await fabricChild.render(/* @__PURE__ */ (0, _kubb_react_fabric_jsx_runtime.jsx)(_kubb_react_fabric.Fabric, { children: /* @__PURE__ */ (0, _kubb_react_fabric_jsx_runtime.jsx)(Component, {
+		config,
+		plugin,
+		driver,
+		adapter,
+		node,
+		options: options.options,
+		resolver: options.resolver
+	}) }));
 	fabric.context.fileManager.upsert(...fabricChild.files);
 	fabricChild.unmount();
 }
@@ -2359,19 +2237,15 @@ async function renderSchema(node, options) {
 	const { config, fabric, plugin, Component, adapter, driver } = options;
 	if (!Component) return;
 	const fabricChild = (0, _kubb_react_fabric.createReactFabric)();
-	await fabricChild.render(/* @__PURE__ */ (0, _kubb_react_fabric_jsx_runtime.jsx)(_kubb_react_fabric.Fabric, {
-		meta: {
-			plugin,
-			driver
-		},
-		children: /* @__PURE__ */ (0, _kubb_react_fabric_jsx_runtime.jsx)(Component, {
-			config,
-			plugin,
-			adapter,
-			node,
-			options: options.options
-		})
-	}));
+	await fabricChild.render(/* @__PURE__ */ (0, _kubb_react_fabric_jsx_runtime.jsx)(_kubb_react_fabric.Fabric, { children: /* @__PURE__ */ (0, _kubb_react_fabric_jsx_runtime.jsx)(Component, {
+		config,
+		plugin,
+		driver,
+		adapter,
+		node,
+		options: options.options,
+		resolver: options.resolver
+	}) }));
 	fabric.context.fileManager.upsert(...fabricChild.files);
 	fabricChild.unmount();
 }
@@ -2784,7 +2658,10 @@ async function getBarrelFiles(files, { type, meta = {}, root, output }) {
 */
 async function getConfigs(config, args) {
 	const resolved = await (typeof config === "function" ? config(args) : config);
-	return (Array.isArray(resolved) ? resolved : [resolved]).map((item) => ({ ...item }));
+	return (Array.isArray(resolved) ? resolved : [resolved]).map((item) => ({
+		plugins: [],
+		...item
+	}));
 }
 //#endregion
 //#region src/utils/mergeResolvers.ts
@@ -2816,7 +2693,7 @@ function mergeResolvers(...resolvers) {
 * - Combines preset generators with user-supplied generators; falls back to the `default` preset's generators when neither provides any.
 */
 function getPreset(params) {
-	const { preset: presetName, presets, resolvers, transformers: userTransformers, generators: userGenerators } = params;
+	const { preset: presetName, presets, resolvers = [], transformers: userTransformers = [], generators: userGenerators = [] } = params;
 	const [defaultResolver, ...userResolvers] = resolvers;
 	const preset = presets[presetName];
 	const resolver = mergeResolvers(mergeResolvers(defaultResolver, ...preset?.resolvers ?? []), ...userResolvers ?? []);
@@ -2928,11 +2805,9 @@ exports.defaultResolveFile = defaultResolveFile;
 exports.defaultResolveFooter = defaultResolveFooter;
 exports.defaultResolveOptions = defaultResolveOptions;
 exports.defaultResolvePath = defaultResolvePath;
-exports.defineBuilder = defineBuilder;
 exports.defineConfig = defineConfig;
 exports.defineGenerator = defineGenerator;
 exports.defineLogger = defineLogger;
-exports.definePreset = definePreset;
 exports.definePresets = definePresets;
 Object.defineProperty(exports, "definePrinter", {
 	enumerable: true,