@kubb/core 5.0.0-alpha.3 → 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-CiPWLv-5.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

@@ -5,7 +5,7 @@ import { parseArgs, styleText } from "node:util";
 import { readFileSync } from "node:fs";
 import { access, mkdir, readFile, readdir, rm, writeFile } from "node:fs/promises";
 import path, { basename, dirname, extname, join, posix, relative, resolve } from "node:path";
-import { definePrinter } from "@kubb/ast";
+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";
@@ -1456,7 +1456,7 @@ const fsStorage = defineStorage(() => ({
 }));
 //#endregion
 //#region package.json
-var version$1 = "5.0.0-alpha.3";
+var version$1 = "5.0.0-alpha.4";
 //#endregion
 //#region src/utils/diagnostics.ts
 /**
@@ -1789,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 };
@@ -2302,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