@kubb/core 5.0.0-alpha.2 → 5.0.0-alpha.4

package/dist/index.d.ts

@@ -1,7 +1,8 @@
 import { t as __name } from "./chunk--u3MIqq1.js";
-import { A as UserPluginWithLifeCycle, B as URLPath, C as PrinterFactoryOptions, D as UserConfig, E as UnknownUserPlugin, F as defineStorage, I as formatters, L as linters, M as PluginManager, N as getMode, O as UserLogger, P as DefineStorage, R as logLevel, S as Printer, T as ResolvePathParams, _ as PluginFactoryOptions, a as Config, b as PluginParameter, c as Group, d as Logger, f as LoggerContext, g as PluginContext, h as Plugin, i as BarrelType, j as KubbEvents, k as UserPlugin, l as InputData, m as Output, n as AdapterFactoryOptions, o as DevtoolsOptions, p as LoggerOptions, r as AdapterSource, s as GetPluginFactoryOptions, t as Adapter, u as InputPath, v as PluginLifecycle, w as ResolveNameParams, x as PluginWithLifeCycle, y as PluginLifecycleHooks, z as AsyncEventEmitter } from "./types-B7eZvqwD.js";
+import { A as UserPluginWithLifeCycle, B as formatters, C as PrinterFactoryOptions, D as UserConfig, E as UnknownUserPlugin, F as KubbEvents, H as logLevel, I as PluginManager, L as getMode, M as Generator, N as ReactGeneratorV2, O as UserLogger, P as defineGenerator, R as DefineStorage, S as Printer, T as ResolvePathParams, U as AsyncEventEmitter, V as linters, W as URLPath, _ as PluginFactoryOptions, a as Config, b as PluginParameter, c as Group, d as Logger, f as LoggerContext, g as PluginContext, h as Plugin, i as BarrelType, j as CoreGeneratorV2, k as UserPlugin, l as InputData, m as Output, n as AdapterFactoryOptions, o as DevtoolsOptions, p as LoggerOptions, r as AdapterSource, s as GetPluginFactoryOptions, t as Adapter, u as InputPath, v as PluginLifecycle, w as ResolveNameParams, x as PluginWithLifeCycle, y as PluginLifecycleHooks, z as defineStorage } from "./types-Bbh1o0yW.js";
 import { definePrinter } from "@kubb/ast";
 import { Fabric } from "@kubb/react-fabric";
+import { Node } from "@kubb/ast/types";
 import { KubbFile } from "@kubb/fabric-core/types";
 
 //#region src/build.d.ts
@@ -311,5 +312,40 @@ declare function getConfigs(config: ConfigInput | UserConfig, args: CLIOptions):
 type Linter = keyof typeof linters;
 declare function detectLinter(): Promise<Linter | undefined>;
 //#endregion
-export { Adapter, AdapterFactoryOptions, AdapterSource, AsyncEventEmitter, BarrelType, type CLIOptions, Config, type ConfigInput, DefineStorage, DevtoolsOptions, type FileMetaBase, FunctionParams, type FunctionParamsAST, GetPluginFactoryOptions, Group, InputData, InputPath, KubbEvents, Logger, LoggerContext, LoggerOptions, Output, PackageManager, Plugin, PluginContext, PluginFactoryOptions, PluginLifecycle, PluginLifecycleHooks, PluginManager, PluginParameter, PluginWithLifeCycle, Printer, PrinterFactoryOptions, PromiseManager, ResolveNameParams, ResolvePathParams, URLPath, UnknownUserPlugin, UserConfig, UserLogger, UserPlugin, UserPluginWithLifeCycle, build, build as default, defineAdapter, defineConfig, defineLogger, definePlugin, definePrinter, defineStorage, detectFormatter, detectLinter, formatters, fsStorage, getBarrelFiles, getConfigs, getMode, isInputPath, linters, logLevel, memoryStorage, safeBuild, setup };
+//#region src/utils/resolveOptions.d.ts
+type FilterItem = {
+  type: string;
+  pattern: string | RegExp;
+};
+type OverrideItem<TOptions> = FilterItem & {
+  options: Partial<TOptions>;
+};
+type ResolveOptionsContext<TOptions> = {
+  options: TOptions;
+  exclude?: Array<FilterItem>;
+  include?: Array<FilterItem>;
+  override?: Array<OverrideItem<TOptions>>;
+};
+/**
+ * Resolves the effective plugin options for a given AST node by applying
+ * `exclude`, `include`, and `override` rules from the plugin configuration.
+ *
+ * Returns `null` when the node is excluded or not matched by `include`.
+ * Returns the merged options (base options merged with any matching `override`) otherwise.
+ *
+ * Supported filter types for `OperationNode`: `tag`, `operationId`, `path`, `method`.
+ * Supported filter types for `SchemaNode`: `schemaName`.
+ *
+ * @example
+ * const resolved = resolveOptions(operationNode, { options, exclude, include, override })
+ * if (!resolved) return // excluded
+ */
+declare function resolveOptions<TOptions>(node: Node, {
+  options,
+  exclude,
+  include,
+  override
+}: ResolveOptionsContext<TOptions>): TOptions | null;
+//#endregion
+export { Adapter, AdapterFactoryOptions, AdapterSource, AsyncEventEmitter, BarrelType, type CLIOptions, Config, type ConfigInput, CoreGeneratorV2, DefineStorage, DevtoolsOptions, type FileMetaBase, FunctionParams, type FunctionParamsAST, Generator, GetPluginFactoryOptions, Group, InputData, InputPath, KubbEvents, Logger, LoggerContext, LoggerOptions, Output, PackageManager, Plugin, PluginContext, PluginFactoryOptions, PluginLifecycle, PluginLifecycleHooks, PluginManager, PluginParameter, PluginWithLifeCycle, Printer, PrinterFactoryOptions, PromiseManager, ReactGeneratorV2, ResolveNameParams, ResolvePathParams, URLPath, UnknownUserPlugin, UserConfig, UserLogger, UserPlugin, UserPluginWithLifeCycle, build, build as default, defineAdapter, defineConfig, defineGenerator, defineLogger, definePlugin, definePrinter, defineStorage, detectFormatter, detectLinter, formatters, fsStorage, getBarrelFiles, getConfigs, getMode, isInputPath, linters, logLevel, memoryStorage, resolveOptions, safeBuild, setup };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -4,8 +4,8 @@ import { EventEmitter } from "node:events";
 import { parseArgs, styleText } from "node:util";
 import { readFileSync } from "node:fs";
 import { access, mkdir, readFile, readdir, rm, writeFile } from "node:fs/promises";
-import path, { dirname, join, posix, relative, resolve } from "node:path";
-import { definePrinter } from "@kubb/ast";
+import path, { basename, dirname, extname, join, posix, relative, resolve } from "node:path";
+import { definePrinter, isOperationNode, isSchemaNode } from "@kubb/ast";
 import { createFabric } from "@kubb/react-fabric";
 import { typescriptParser } from "@kubb/react-fabric/parsers";
 import { fsPlugin } from "@kubb/react-fabric/plugins";
@@ -951,7 +951,7 @@ function isPromiseRejectedResult(result) {
 //#region src/PluginManager.ts
 function getMode(fileOrFolder) {
 	if (!fileOrFolder) return "split";
-	return path.extname(fileOrFolder) ? "single" : "split";
+	return extname(fileOrFolder) ? "single" : "split";
 }
 var PluginManager = class {
 	config;
@@ -961,6 +961,7 @@ var PluginManager = class {
 	* the build pipeline after the adapter's `parse()` resolves.
 	*/
 	rootNode = void 0;
+	adapter = void 0;
 	#studioIsOpen = false;
 	#plugins = /* @__PURE__ */ new Set();
 	#usedPluginNames = {};
@@ -986,7 +987,7 @@ var PluginManager = class {
 			plugin,
 			events: this.options.events,
 			pluginManager: this,
-			mode: getMode(path.resolve(this.config.root, this.config.output.path)),
+			mode: getMode(resolve(this.config.root, this.config.output.path)),
 			addFile: async (...files) => {
 				await this.options.fabric.addFile(...files);
 			},
@@ -996,10 +997,13 @@ var PluginManager = class {
 			get rootNode() {
 				return pluginManager.rootNode;
 			},
+			get adapter() {
+				return pluginManager.adapter;
+			},
 			openInStudio(options) {
+				if (!pluginManager.config.devtools || pluginManager.#studioIsOpen) return;
 				if (typeof pluginManager.config.devtools !== "object") throw new Error("Devtools must be an object");
-				if (!pluginManager.rootNode) throw new Error("RootNode is not defined, make sure you have set the parser in kubb.config.ts");
-				if (pluginManager.#studioIsOpen) return;
+				if (!pluginManager.rootNode || !pluginManager.adapter) throw new Error("adapter is not defined, make sure you have set the parser in kubb.config.ts");
 				pluginManager.#studioIsOpen = true;
 				const studioUrl = pluginManager.config.devtools?.studioUrl ?? "https://studio.kubb.dev";
 				return openInStudio(pluginManager.rootNode, studioUrl, options);
@@ -1019,17 +1023,21 @@ var PluginManager = class {
 		return this.#getSortedPlugins();
 	}
 	getFile({ name, mode, extname, pluginName, options }) {
-		const baseName = `${name}${extname}`;
+		const resolvedName = mode ? mode === "single" ? "" : this.resolveName({
+			name,
+			pluginName,
+			type: "file"
+		}) : name;
 		const path = this.resolvePath({
-			baseName,
+			baseName: `${resolvedName}${extname}`,
 			mode,
 			pluginName,
 			options
 		});
-		if (!path) throw new Error(`Filepath should be defined for resolvedName "${name}" and pluginName "${pluginName}"`);
+		if (!path) throw new Error(`Filepath should be defined for resolvedName "${resolvedName}" and pluginName "${pluginName}"`);
 		return {
 			path,
-			baseName,
+			baseName: basename(path),
 			meta: { pluginName },
 			sources: [],
 			imports: [],
@@ -1037,8 +1045,7 @@ var PluginManager = class {
 		};
 	}
 	resolvePath = (params) => {
-		const root = path.resolve(this.config.root, this.config.output.path);
-		const defaultPath = path.resolve(root, params.baseName);
+		const defaultPath = resolve(resolve(this.config.root, this.config.output.path), params.baseName);
 		if (params.pluginName) return this.hookForPluginSync({
 			pluginName: params.pluginName,
 			hookName: "resolvePath",
@@ -1226,7 +1233,8 @@ var PluginManager = class {
 		if (hookName) return plugins.filter((plugin) => hookName in plugin);
 		return plugins.map((plugin) => {
 			if (plugin.pre) {
-				const missingPlugins = plugin.pre.filter((pluginName) => !plugins.find((pluginToFind) => pluginToFind.name === pluginName));
+				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;
@@ -1448,7 +1456,7 @@ const fsStorage = defineStorage(() => ({
 }));
 //#endregion
 //#region package.json
-var version$1 = "5.0.0-alpha.2";
+var version$1 = "5.0.0-alpha.4";
 //#endregion
 //#region src/utils/diagnostics.ts
 /**
@@ -1573,6 +1581,7 @@ async function setup(options) {
 			date: /* @__PURE__ */ new Date(),
 			logs: [`Running adapter: ${definedConfig.adapter.name}`]
 		});
+		pluginManager.adapter = definedConfig.adapter;
 		pluginManager.rootNode = await definedConfig.adapter.parse(source);
 		await events.emit("debug", {
 			date: /* @__PURE__ */ new Date(),
@@ -1780,6 +1789,36 @@ function defineAdapter(build) {
 	return (options) => build(options ?? {});
 }
 //#endregion
+//#region src/defineGenerator.ts
+function defineGenerator(generator) {
+	if (generator.type === "react") return {
+		version: "2",
+		Operations() {
+			return null;
+		},
+		Operation() {
+			return null;
+		},
+		Schema() {
+			return null;
+		},
+		...generator
+	};
+	return {
+		version: "2",
+		async operations() {
+			return [];
+		},
+		async operation() {
+			return [];
+		},
+		async schema() {
+			return [];
+		},
+		...generator
+	};
+}
+//#endregion
 //#region src/defineLogger.ts
 function defineLogger(logger) {
 	return { ...logger };
@@ -2293,6 +2332,61 @@ async function detectLinter() {
 	]) if (await isLinterAvailable(linter)) return linter;
 }
 //#endregion
-export { AsyncEventEmitter, FunctionParams, PackageManager, PluginManager, PromiseManager, URLPath, build, build as default, defineAdapter, defineConfig, defineLogger, definePlugin, definePrinter, defineStorage, detectFormatter, detectLinter, formatters, fsStorage, getBarrelFiles, getConfigs, getMode, isInputPath, linters, logLevel, memoryStorage, safeBuild, setup };
+//#region src/utils/resolveOptions.ts
+function matchesOperationPattern(node, type, pattern) {
+	switch (type) {
+		case "tag": return node.tags.some((tag) => !!tag.match(pattern));
+		case "operationId": return !!node.operationId.match(pattern);
+		case "path": return !!node.path.match(pattern);
+		case "method": return !!node.method.toLowerCase().match(pattern);
+		default: return false;
+	}
+}
+function matchesSchemaPattern(node, type, pattern) {
+	switch (type) {
+		case "schemaName": return node.name ? !!node.name.match(pattern) : false;
+		default: return null;
+	}
+}
+/**
+* Resolves the effective plugin options for a given AST node by applying
+* `exclude`, `include`, and `override` rules from the plugin configuration.
+*
+* Returns `null` when the node is excluded or not matched by `include`.
+* Returns the merged options (base options merged with any matching `override`) otherwise.
+*
+* Supported filter types for `OperationNode`: `tag`, `operationId`, `path`, `method`.
+* Supported filter types for `SchemaNode`: `schemaName`.
+*
+* @example
+* const resolved = resolveOptions(operationNode, { options, exclude, include, override })
+* if (!resolved) return // excluded
+*/
+function resolveOptions(node, { options, exclude = [], include, override = [] }) {
+	if (isOperationNode(node)) {
+		if (exclude.some(({ type, pattern }) => matchesOperationPattern(node, type, pattern))) return null;
+		if (include && !include.some(({ type, pattern }) => matchesOperationPattern(node, type, pattern))) return null;
+		const overrideOptions = override.find(({ type, pattern }) => matchesOperationPattern(node, type, pattern))?.options;
+		return {
+			...options,
+			...overrideOptions
+		};
+	}
+	if (isSchemaNode(node)) {
+		if (exclude.some(({ type, pattern }) => matchesSchemaPattern(node, type, pattern) === true)) return null;
+		if (include) {
+			const applicable = include.map(({ type, pattern }) => matchesSchemaPattern(node, type, pattern)).filter((r) => r !== null);
+			if (applicable.length > 0 && !applicable.includes(true)) return null;
+		}
+		const overrideOptions = override.find(({ type, pattern }) => matchesSchemaPattern(node, type, pattern) === true)?.options;
+		return {
+			...options,
+			...overrideOptions
+		};
+	}
+	return options;
+}
+//#endregion
+export { AsyncEventEmitter, FunctionParams, PackageManager, PluginManager, PromiseManager, URLPath, build, build as default, defineAdapter, defineConfig, defineGenerator, defineLogger, definePlugin, definePrinter, defineStorage, detectFormatter, detectLinter, formatters, fsStorage, getBarrelFiles, getConfigs, getMode, isInputPath, linters, logLevel, memoryStorage, resolveOptions, safeBuild, setup };
 
 //# sourceMappingURL=index.js.map