@kubb/core 4.38.1 → 4.39.1

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { t as __name } from "./chunk--u3MIqq1.js";
-import { A as UserPlugin, B as AsyncEventEmitter, C as Printer, D as UnknownUserPlugin, E as ResolvePathParams, F as DefineStorage, I as defineStorage, L as formatters, M as KubbEvents, N as PluginManager, O as UserConfig, P as getMode, R as linters, S as PluginWithLifeCycle, T as ResolveNameParams, V as URLPath, _ as PluginFactoryOptions, a as Config, b as PluginLifecycleHooks, c as Group, d as Logger, f as LoggerContext, g as PluginContext, h as Plugin, i as BarrelType, j as UserPluginWithLifeCycle, k as UserLogger, 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 PluginKey, w as PrinterFactoryOptions, x as PluginParameter, y as PluginLifecycle, z as logLevel } from "./types-BwL2CHjl.js";
+import { A as UserLogger, B as logLevel, C as PluginWithLifeCycle, D as ResolvePathParams, E as ResolveNameParams, F as getMode, H as URLPath, I as DefineStorage, L as defineStorage, M as UserPluginWithLifeCycle, N as KubbEvents, O as UnknownUserPlugin, P as PluginManager, R as formatters, S as PluginParameter, T as PrinterFactoryOptions, V as AsyncEventEmitter, _ as PluginContext, a as BarrelType, b as PluginLifecycle, c as GetPluginFactoryOptions, d as InputPath, f as Logger, g as Plugin, h as Output, i as Barrel, j as UserPlugin, k as UserConfig, l as Group, m as LoggerOptions, n as AdapterFactoryOptions, o as Config, p as LoggerContext, r as AdapterSource, s as DevtoolsOptions, t as Adapter, u as InputData, v as PluginFactoryOptions, w as Printer, x as PluginLifecycleHooks, y as PluginKey, z as linters } from "./types-DsJhzsHG.js";
 import { definePrinter } from "@kubb/ast";
 import { KubbFile } from "@kubb/fabric-core/types";
 import { Fabric } from "@kubb/react-fabric/types";
@@ -59,6 +59,14 @@ type ConfigInput = PossiblePromise<UserConfig | UserConfig[]> | ((cli: CLIOption
  * - A function returning the config(s), optionally async,
  *   receiving the CLI options as argument
  *
+ * @deprecated Import `defineConfig` from `kubb` instead of `@kubb/core`. The `kubb`
+ * package wires up the OpenAPI adapter, the TypeScript parsers, and the barrel plugin
+ * for you. See the v5 migration guide: https://kubb.dev/docs/5.x/migration-guide
+ *
+ * ```ts
+ * import { defineConfig } from '@kubb/core' // [!code --]
+ * import { defineConfig } from 'kubb' // [!code ++]
+ * ```
  * @example
  * export default defineConfig(({ logLevel }) => ({
  *   root: 'src',
@@ -277,7 +285,10 @@ type FileMetaBase = {
   pluginKey?: Plugin['key'];
 };
 type AddIndexesProps = {
-  type: BarrelType | false | undefined;
+  /**
+   * Explicit barrel strategy. When omitted it is resolved from `output.barrel` (preferred) or the legacy `output.barrelType`.
+   */
+  type?: BarrelType | false;
   /**
    * Root based on root and output.path specified in the config
    */
@@ -287,6 +298,8 @@ type AddIndexesProps = {
    */
   output: {
     path: string;
+    barrel?: Barrel | false;
+    barrelType?: BarrelType | false;
   };
   group?: {
     output: string;
@@ -311,5 +324,19 @@ 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, PluginKey, 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/resolveBarrelType.d.ts
+type BarrelOutput = {
+  barrel?: Barrel | false;
+  barrelType?: BarrelType | false;
+};
+/**
+ * Resolve the effective barrel strategy from an output config.
+ *
+ * Prefers the object `barrel` option and falls back to the legacy `barrelType`.
+ * `barrel: { nested: true }` maps to the legacy `'propagate'` value, and
+ * `barrel: false` disables the barrel file.
+ */
+declare function resolveBarrelType(output: BarrelOutput | undefined): BarrelType | false | undefined;
+//#endregion
+export { Adapter, AdapterFactoryOptions, AdapterSource, AsyncEventEmitter, Barrel, 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, PluginKey, 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, resolveBarrelType, safeBuild, setup };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -1475,7 +1475,7 @@ const fsStorage = defineStorage(() => ({
 }));
 //#endregion
 //#region package.json
-var version$1 = "4.38.1";
+var version$1 = "4.39.1";
 //#endregion
 //#region src/utils/diagnostics.ts
 /**
@@ -1491,6 +1491,25 @@ function getDiagnosticInfo() {
 	};
 }
 //#endregion
+//#region src/utils/resolveBarrelType.ts
+/**
+* Resolve the effective barrel strategy from an output config.
+*
+* Prefers the object `barrel` option and falls back to the legacy `barrelType`.
+* `barrel: { nested: true }` maps to the legacy `'propagate'` value, and
+* `barrel: false` disables the barrel file.
+*/
+function resolveBarrelType(output) {
+	if (!output) return;
+	const { barrel } = output;
+	if (barrel !== void 0) {
+		if (barrel === false) return false;
+		if (barrel.nested) return "propagate";
+		return barrel.type ?? "named";
+	}
+	return output.barrelType;
+}
+//#endregion
 //#region src/build.ts
 async function setup(options) {
 	const { config: userConfig, events = new AsyncEventEmitter() } = options;
@@ -1586,7 +1605,7 @@ async function setup(options) {
 		logs: [
 			"✓ Fabric initialized",
 			`  • Storage: ${storage ? storage.name : "disabled (dry-run)"}`,
-			`  • Barrel type: ${definedConfig.output.barrelType || "none"}`
+			`  • Barrel type: ${resolveBarrelType(definedConfig.output) || "none"}`
 		]
 	});
 	const pluginManager = new PluginManager(definedConfig, {
@@ -1687,14 +1706,15 @@ async function safeBuild(options, overrides) {
 				});
 			}
 		}
-		if (config.output.barrelType) {
+		const rootBarrelType = resolveBarrelType(config.output);
+		if (rootBarrelType) {
 			const rootPath = resolve(resolve(config.root), config.output.path, BARREL_FILENAME);
 			const rootDir = dirname(rootPath);
 			await events.emit("debug", {
 				date: /* @__PURE__ */ new Date(),
 				logs: [
 					"Generating barrel file",
-					`  • Type: ${config.output.barrelType}`,
+					`  • Type: ${rootBarrelType}`,
 					`  • Path: ${rootPath}`
 				]
 			});
@@ -1749,6 +1769,7 @@ async function safeBuild(options, overrides) {
 	}
 }
 function buildBarrelExports({ barrelFiles, rootDir, existingExports, config, pluginManager }) {
+	const rootBarrelType = resolveBarrelType(config.output);
 	const pluginKeyMap = /* @__PURE__ */ new Map();
 	for (const plugin of pluginManager.plugins) pluginKeyMap.set(JSON.stringify(plugin.key), plugin);
 	return barrelFiles.flatMap((file) => {
@@ -1757,13 +1778,13 @@ function buildBarrelExports({ barrelFiles, rootDir, existingExports, config, plu
 			if (!file.path || !source.isIndexable) return [];
 			const meta = file.meta;
 			const pluginOptions = (meta?.pluginKey ? pluginKeyMap.get(JSON.stringify(meta.pluginKey)) : void 0)?.options;
-			if (!pluginOptions || pluginOptions.output?.barrelType === false) return [];
-			const exportName = config.output.barrelType === "all" ? void 0 : source.name ? [source.name] : void 0;
+			if (!pluginOptions || resolveBarrelType(pluginOptions.output) === false) return [];
+			const exportName = rootBarrelType === "all" ? void 0 : source.name ? [source.name] : void 0;
 			if (exportName?.some((n) => existingExports.has(n))) return [];
 			return [{
 				name: exportName,
 				path: getRelativePath(rootDir, file.path),
-				isTypeOnly: config.output.barrelType === "all" ? containsOnlyTypes : source.isTypeOnly
+				isTypeOnly: rootBarrelType === "all" ? containsOnlyTypes : source.isTypeOnly
 			}];
 		});
 	});
@@ -2244,7 +2265,8 @@ function trimExtName(text) {
 	return text;
 }
 async function getBarrelFiles(files, { type, meta = {}, root, output }) {
-	if (!type || type === "propagate") return [];
+	const resolvedType = type ?? resolveBarrelType(output) ?? "named";
+	if (!resolvedType || resolvedType === "propagate") return [];
 	const barrelManager = new BarrelManager();
 	const pathToBuildFrom = join(root, output.path);
 	if (trimExtName(pathToBuildFrom).endsWith("index")) return [];
@@ -2253,7 +2275,7 @@ async function getBarrelFiles(files, { type, meta = {}, root, output }) {
 		root: pathToBuildFrom,
 		meta
 	});
-	if (type === "all") return barrelFiles.map((file) => {
+	if (resolvedType === "all") return barrelFiles.map((file) => {
 		return {
 			...file,
 			exports: file.exports?.map((exportItem) => {
@@ -2320,6 +2342,6 @@ 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 };
+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, resolveBarrelType, safeBuild, setup };
 
 //# sourceMappingURL=index.js.map