@kubb/middleware-barrel 5.0.0-beta.3 → 5.0.0-beta.31

package/dist/index.js

@@ -46,7 +46,7 @@ function buildTree(rootPath, filePaths) {
 		children: [],
 		isFile: false
 	};
-	const childIndex = /* @__PURE__ */ new Map();
+	const childIndex = /* @__PURE__ */ new WeakMap();
 	childIndex.set(root, /* @__PURE__ */ new Map());
 	const rootPrefix = `${normalizedRoot}/`;
 	for (const filePath of filePaths) {
@@ -86,39 +86,14 @@ function compareByPath(a, b) {
 	return a.path < b.path ? -1 : a.path > b.path ? 1 : 0;
 }
 //#endregion
-//#region src/utils/excludedPaths.ts
-/**
-* Builds a POSIX-normalized prefix for a plugin's output directory, with a trailing `/`.
-*
-* Used to detect (and later exclude) files generated by plugins that opted out of the root barrel.
-*/
-function getPluginOutputPrefix(plugin, config) {
-	return `${toPosixPath(resolve(config.root, config.output.path, plugin.options.output.path))}/`;
-}
-/**
-* Returns `true` when `filePath` lives under any of the given excluded directory prefixes.
-*
-* Both sides are POSIX-normalized so Windows backslash paths match correctly.
-*/
-function isExcludedPath(filePath, prefixes) {
-	const normalized = toPosixPath(filePath);
-	return prefixes.values().some((prefix) => normalized.startsWith(prefix));
-}
-//#endregion
-//#region src/constants.ts
-/**
-* Full file name for barrel files (with extension).
-*/
-const BARREL_FILENAME = "index.ts";
-//#endregion
-//#region src/utils/getBarrelFiles.ts
+//#region src/utils.ts
 const SOURCE_EXTENSIONS = new Set([
 	".ts",
 	".tsx",
 	".js",
 	".jsx"
 ]);
-const BARREL_SUFFIX = `/${BARREL_FILENAME}`;
+const BARREL_SUFFIX = `/index.ts`;
 function toRelativeModulePath(fromDir, filePath) {
 	return `./${filePath.slice(fromDir.length + 1)}`;
 }
@@ -127,7 +102,7 @@ function isBarrelPath(path) {
 }
 function makeBarrel(dirPath, exports) {
 	return createFile({
-		baseName: BARREL_FILENAME,
+		baseName: "index.ts",
 		path: `${dirPath}${BARREL_SUFFIX}`,
 		exports,
 		sources: [],
@@ -177,32 +152,33 @@ const namedStrategy = ({ dirPath, leafPath, sourceFile }) => {
 };
 const LEAF_STRATEGIES = new Map([["all", allStrategy], ["named", namedStrategy]]);
 /**
-* Post-order walk that emits a barrel per visited directory.
+* Post-order walk that yields a barrel per visited directory.
+* Returns the list of leaf file paths collected in this subtree (used by the parent call).
 */
-function walkAllOrNamed(node, params, isRoot, out) {
+function* walkAllOrNamed(node, params, isRoot) {
 	const subtreeLeaves = [];
 	for (const child of node.children) {
 		if (child.isFile) {
 			if (!isBarrelPath(child.path)) subtreeLeaves.push(child.path);
 			continue;
 		}
-		const childLeaves = walkAllOrNamed(child, params, false, out);
+		const childLeaves = yield* walkAllOrNamed(child, params, false);
 		for (const leaf of childLeaves) subtreeLeaves.push(leaf);
 	}
 	if (!isRoot && !params.recursive) return subtreeLeaves;
 	const exports = subtreeLeaves.flatMap((leafPath) => params.strategy({
 		dirPath: node.path,
 		leafPath,
-		sourceFile: params.sourceFiles.get(leafPath)
+		sourceFile: params.sourceFiles.get(leafPath) ?? null
 	}));
-	if (exports.length > 0) out.push(makeBarrel(node.path, exports));
+	if (exports.length > 0) yield makeBarrel(node.path, exports);
 	return subtreeLeaves;
 }
 /**
-* Recursive walk that emits one barrel per directory, re-exporting files and sub-barrels.
+* Recursive walk that yields one barrel per directory, re-exporting files and sub-barrels.
 * Used when nested: true.
 */
-function walkNested(node, out) {
+function* walkNested(node) {
 	const exports = [];
 	for (const child of node.children) {
 		if (child.isFile) {
@@ -210,10 +186,10 @@ function walkNested(node, out) {
 			exports.push(createExport({ path: toRelativeModulePath(node.path, child.path) }));
 			continue;
 		}
-		walkNested(child, out);
+		yield* walkNested(child);
 		exports.push(createExport({ path: toRelativeModulePath(node.path, `${child.path}${BARREL_SUFFIX}`) }));
 	}
-	if (exports.length > 0) out.push(makeBarrel(node.path, exports));
+	if (exports.length > 0) yield makeBarrel(node.path, exports);
 }
 function indexRelevantFiles(files, outputPath) {
 	const outputPrefix = `${toPosixPath(outputPath)}/`;
@@ -233,40 +209,104 @@ function indexRelevantFiles(files, outputPath) {
 	};
 }
 /**
-* Generates barrel `FileNode`s for the directory rooted at `outputPath`.
+* Yields barrel `FileNode`s for the directory rooted at `outputPath`.
+*
+* @example
+* ```ts
+* for (const file of getBarrelFiles({ outputPath, files, barrelType })) {
+*   upsertFile(file)
+* }
+* // or collect into an array
+* const barrels = [...getBarrelFiles({ outputPath, files, barrelType })]
+* ```
 */
-function getBarrelFiles({ outputPath, files, barrelType, nested = false, recursive = false }) {
+function* getBarrelFiles({ outputPath, files, barrelType, nested = false, recursive = false }) {
 	const { sourceFiles, paths } = indexRelevantFiles(files, outputPath);
-	if (paths.length === 0) return [];
+	if (paths.length === 0) return;
 	const tree = buildTree(outputPath, paths);
-	const result = [];
 	if (nested) {
-		walkNested(tree, result);
-		return result;
+		yield* walkNested(tree);
+		return;
 	}
 	const strategy = LEAF_STRATEGIES.get(barrelType);
-	if (!strategy) return result;
-	walkAllOrNamed(tree, {
+	if (!strategy) return;
+	yield* walkAllOrNamed(tree, {
 		sourceFiles,
 		strategy,
 		recursive
-	}, true, result);
-	return result;
+	}, true);
+}
+/**
+* Builds a POSIX-normalized prefix for a plugin's output directory, with a trailing `/`.
+*
+* Used to detect (and later exclude) files generated by plugins that opted out of the root barrel.
+*/
+function getPluginOutputPrefix(plugin, config) {
+	return `${toPosixPath(resolve(config.root, config.output.path, plugin.options.output.path))}/`;
+}
+/**
+* Returns `true` when `filePath` lives under any of the given excluded directory prefixes.
+*
+* Both sides are POSIX-normalized so Windows backslash paths match correctly.
+*/
+function isExcludedPath(filePath, prefixes) {
+	const normalized = toPosixPath(filePath);
+	return prefixes.values().some((prefix) => normalized.startsWith(prefix));
 }
 //#endregion
 //#region src/middleware.ts
 /**
-* Generates `index.ts` barrel files for each plugin and a root barrel at `config.output.path/index.ts`.
+* Applies a plugin's configured `output.banner`/`footer` to a barrel file, flagged as `isBarrel`.
+*
+* Resolves through the plugin's own resolver, and only when the plugin explicitly sets a
+* banner/footer — so barrels stay banner-free by default and never inherit the implicit
+* "Generated by Kubb" notice.
+*/
+function withBarrelBannerFooter({ file, plugin, config }) {
+	const output = plugin.options?.output;
+	const resolver = plugin.resolver;
+	if (!resolver) return file;
+	const hasBanner = output?.banner !== void 0;
+	const hasFooter = output?.footer !== void 0;
+	if (!hasBanner && !hasFooter) return file;
+	const context = {
+		output,
+		config,
+		file: {
+			path: file.path,
+			baseName: file.baseName,
+			isBarrel: true
+		}
+	};
+	return {
+		...file,
+		banner: hasBanner ? resolver.resolveBanner(void 0, context) : file.banner,
+		footer: hasFooter ? resolver.resolveFooter(void 0, context) : file.footer
+	};
+}
+/**
+* Canonical middleware name for `@kubb/middleware-barrel`. Used for driver
+* lookups.
+*/
+const middlewareBarrelName = "middleware-barrel";
+/**
+* Generates an `index.ts` for every plugin output directory and one root
+* barrel at `config.output.path/index.ts` after the build completes. Ships
+* with Kubb and is registered by default in `defineConfig`.
 *
-* Each plugin inherits `output.barrel` from `config.output.barrel` (defaults to `{ type: 'named' }`).
-* Set `barrel: false` on a plugin to disable its barrel and exclude it from the root barrel.
+* Each plugin inherits `output.barrel` from `config.output.barrel` (which
+* defaults to `{ type: 'named' }`). Set `barrel: false` on a plugin to skip
+* its barrel and also exclude its files from the root barrel.
 *
 * @example
 * ```ts
 * import { defineConfig } from '@kubb/core'
 * import { middlewareBarrel } from '@kubb/middleware-barrel'
+* import { pluginTs } from '@kubb/plugin-ts'
+* import { pluginZod } from '@kubb/plugin-zod'
 *
 * export default defineConfig({
+*   input: { path: './petStore.yaml' },
 *   output: { path: 'src/gen', barrel: { type: 'named' } },
 *   plugins: [
 *     pluginTs({ output: { path: 'types', barrel: { type: 'all' } } }),
@@ -276,10 +316,6 @@ function getBarrelFiles({ outputPath, files, barrelType, nested = false, recursi
 * })
 * ```
 */
-/**
-* Stable string identifier for the barrel middleware.
-*/
-const middlewareBarrelName = "middleware-barrel";
 const middlewareBarrel = defineMiddleware(() => {
 	const excludedPrefixes = /* @__PURE__ */ new Set();
 	return {
@@ -289,13 +325,14 @@ const middlewareBarrel = defineMiddleware(() => {
 				const pluginBarrel = plugin.options.output?.barrel;
 				const configBarrel = config.output.barrel;
 				const defaultBarrel = { type: "named" };
-				let barrelConfig;
-				if (pluginBarrel !== void 0) barrelConfig = pluginBarrel;
-				else if (configBarrel !== void 0) barrelConfig = configBarrel === false ? false : {
-					...configBarrel,
-					nested: false
-				};
-				else barrelConfig = defaultBarrel;
+				const barrelConfig = (() => {
+					if (pluginBarrel !== void 0) return pluginBarrel;
+					if (configBarrel !== void 0) return configBarrel === false ? false : {
+						...configBarrel,
+						nested: false
+					};
+					return defaultBarrel;
+				})();
 				if (barrelConfig === false) {
 					excludedPrefixes.add(getPluginOutputPrefix(plugin, config));
 					return;
@@ -306,14 +343,17 @@ const middlewareBarrel = defineMiddleware(() => {
 				const target = resolve(base, plugin.options.output.path);
 				const relative = path.relative(base, target);
 				if (relative.startsWith("..") || path.isAbsolute(relative)) throw new Error("Invalid output path");
-				const barrelFiles = getBarrelFiles({
+				for (const file of getBarrelFiles({
 					outputPath: target,
 					files,
 					barrelType,
 					nested,
 					recursive: true
-				});
-				if (barrelFiles.length > 0) upsertFile(...barrelFiles);
+				})) upsertFile(withBarrelBannerFooter({
+					file,
+					plugin,
+					config
+				}));
 			},
 			"kubb:plugins:end"({ files, config, upsertFile }) {
 				const barrelConfig = config.output.barrel ?? { type: "named" };
@@ -321,12 +361,11 @@ const middlewareBarrel = defineMiddleware(() => {
 				excludedPrefixes.clear();
 				if (barrelConfig === false) return;
 				const barrelType = barrelConfig.type;
-				const rootBarrelFiles = getBarrelFiles({
+				for (const file of getBarrelFiles({
 					outputPath: resolve(config.root, config.output.path),
 					files: filteredFiles,
 					barrelType
-				});
-				if (rootBarrelFiles.length > 0) upsertFile(...rootBarrelFiles);
+				})) upsertFile(file);
 			}
 		}
 	};

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../../internals/utils/src/path.ts","../../../internals/utils/src/buildTree.ts","../src/utils/excludedPaths.ts","../src/constants.ts","../src/utils/getBarrelFiles.ts","../src/middleware.ts"],"sourcesContent":["/**\n * Converts a filesystem path to use POSIX (`/`) separators.\n *\n * Most of the codebase compares and composes paths as strings (prefix matching, joining for\n * import specifiers, splitting on `/`). On POSIX `path.resolve` already returns `/`-separated\n * paths, but on Windows it returns `\\`-separated paths, which breaks every such comparison.\n *\n * Routing every path that crosses a module boundary through `toPosixPath` keeps the rest of the\n * code platform-agnostic. The conversion runs unconditionally so Windows-specific behavior is\n * exercisable from POSIX CI.\n *\n * @example\n * toPosixPath('C:\\\\repo\\\\src\\\\pet.ts') // 'C:/repo/src/pet.ts'\n */\nexport function toPosixPath(filePath: string): string {\n  return filePath.replaceAll('\\\\', '/')\n}\n","import { toPosixPath } from './path.ts'\n\n/**\n * A node in the directory tree used to compute barrel file exports.\n * Either represents a directory (with `children`) or a file (`isFile: true`, empty `children`).\n */\nexport type BuildTree = {\n  /**\n   * Absolute filesystem path of this directory or file. Always normalized to POSIX (`/`) separators.\n   */\n  path: string\n  /**\n   * Sub-directories and files contained within this directory.\n   * Always empty for file nodes.\n   */\n  children: Array<BuildTree>\n  /**\n   * `true` when this node represents a file (leaf), `false` for directory nodes.\n   */\n  isFile: boolean\n}\n\n/**\n * Builds a directory tree rooted at `rootPath` from a list of absolute file paths.\n * Paths outside `rootPath` are silently ignored. Children are sorted alphabetically\n * by path so consumers (barrel exports, propagated indexes) emit a deterministic order.\n *\n * Both POSIX (`/`) and Windows (`\\`) separators are accepted in input paths; emitted node\n * paths are always POSIX-normalized so downstream prefix/lookup operations behave the same\n * across platforms.\n *\n * @example\n * ```ts\n * buildTree('/src/gen/types', [\n *   '/src/gen/types/pet.ts',\n *   '/src/gen/types/pets/listPets.ts',\n * ])\n * ```\n */\nexport function buildTree(rootPath: string, filePaths: ReadonlyArray<string>): BuildTree {\n  const normalizedRoot = toPosixPath(rootPath)\n  const root: BuildTree = { path: normalizedRoot, children: [], isFile: false }\n  // Per-directory child lookup avoids the O(N) `Array.find` scan during insertion.\n  const childIndex = new Map<BuildTree, Map<string, BuildTree>>()\n  childIndex.set(root, new Map())\n\n  const rootPrefix = `${normalizedRoot}/`\n\n  for (const filePath of filePaths) {\n    const normalized = toPosixPath(filePath)\n    if (!normalized.startsWith(rootPrefix)) continue\n\n    const parts = normalized.slice(rootPrefix.length).split('/')\n    if (parts.length === 0) continue\n\n    let current = root\n    const lastIndex = parts.length - 1\n    for (const [i, part] of parts.entries()) {\n      if (!part) continue\n\n      const isLast = i === lastIndex\n      const siblings = childIndex.get(current)!\n      let child = siblings.get(part)\n      if (!child) {\n        child = { path: `${current.path}/${part}`, children: [], isFile: isLast }\n        current.children.push(child)\n        siblings.set(part, child)\n        if (!isLast) childIndex.set(child, new Map())\n      }\n      current = child\n    }\n  }\n\n  sortTree(root)\n\n  return root\n}\n\nfunction sortTree(node: BuildTree): void {\n  if (node.children.length === 0) return\n  node.children.sort(compareByPath)\n  for (const child of node.children) {\n    if (!child.isFile) sortTree(child)\n  }\n}\n\nfunction compareByPath(a: BuildTree, b: BuildTree): number {\n  return a.path < b.path ? -1 : a.path > b.path ? 1 : 0\n}\n","import { resolve } from 'node:path'\nimport type { Config, NormalizedPlugin } from '@kubb/core'\nimport { toPosixPath } from '@internals/utils'\n\n/**\n * Builds a POSIX-normalized prefix for a plugin's output directory, with a trailing `/`.\n *\n * Used to detect (and later exclude) files generated by plugins that opted out of the root barrel.\n */\nexport function getPluginOutputPrefix(plugin: NormalizedPlugin, config: Config): string {\n  return `${toPosixPath(resolve(config.root, config.output.path, plugin.options.output.path))}/`\n}\n\n/**\n * Returns `true` when `filePath` lives under any of the given excluded directory prefixes.\n *\n * Both sides are POSIX-normalized so Windows backslash paths match correctly.\n */\nexport function isExcludedPath(filePath: string, prefixes: ReadonlySet<string>): boolean {\n  const normalized = toPosixPath(filePath)\n  return prefixes.values().some((prefix) => normalized.startsWith(prefix))\n}\n","/**\n * Full file name for barrel files (with extension).\n */\nexport const BARREL_FILENAME = 'index.ts' as const\n","import { extname } from 'node:path'\nimport { createExport, createFile } from '@kubb/ast'\nimport type { ExportNode, FileNode, SourceNode } from '@kubb/ast'\nimport { BARREL_FILENAME } from '../constants.ts'\nimport type { BarrelType } from '../types.ts'\nimport { type BuildTree, buildTree, toPosixPath } from '@internals/utils'\n\nconst SOURCE_EXTENSIONS = new Set(['.ts', '.tsx', '.js', '.jsx'])\nconst BARREL_SUFFIX = `/${BARREL_FILENAME}`\n\nfunction toRelativeModulePath(fromDir: string, filePath: string): string {\n  return `./${filePath.slice(fromDir.length + 1)}`\n}\n\nfunction isBarrelPath(path: string): boolean {\n  return path.endsWith(BARREL_SUFFIX)\n}\n\nfunction makeBarrel(dirPath: string, exports: Array<ExportNode>): FileNode {\n  return createFile({\n    baseName: BARREL_FILENAME,\n    path: `${dirPath}${BARREL_SUFFIX}`,\n    exports,\n    sources: [],\n    imports: [],\n    // Barrel files must never carry a banner or footer: they only re-export\n    // symbols and adding a directive like \"use server\" would break consumers.\n    banner: undefined,\n    footer: undefined,\n  })\n}\n\ntype LeafContext = {\n  dirPath: string\n  leafPath: string\n  sourceFile: FileNode | undefined\n}\n\ntype LeafStrategy = (ctx: LeafContext) => Array<ExportNode>\n\nfunction hasOnlyNonIndexableSources(sources: ReadonlyArray<SourceNode>): boolean {\n  if (sources.length === 0) return false\n  for (const source of sources) {\n    if (source.isIndexable) return false\n  }\n  return true\n}\n\nfunction partitionIndexableNames(sources: ReadonlyArray<SourceNode>): Map<boolean, Set<string>> {\n  const byTypeOnly = new Map<boolean, Set<string>>([\n    [false, new Set()],\n    [true, new Set()],\n  ])\n  for (const source of sources) {\n    if (!source.isIndexable || !source.name) continue\n    byTypeOnly.get(Boolean(source.isTypeOnly))!.add(source.name)\n  }\n  return byTypeOnly\n}\n\nconst allStrategy: LeafStrategy = ({ dirPath, leafPath, sourceFile }) => {\n  if (sourceFile && hasOnlyNonIndexableSources(sourceFile.sources)) return []\n  return [createExport({ path: toRelativeModulePath(dirPath, leafPath) })]\n}\n\nconst namedStrategy: LeafStrategy = ({ dirPath, leafPath, sourceFile }) => {\n  const modulePath = toRelativeModulePath(dirPath, leafPath)\n\n  if (!sourceFile) return [createExport({ path: modulePath })]\n\n  const namesByTypeOnly = partitionIndexableNames(sourceFile.sources)\n  const valueNames = namesByTypeOnly.get(false)!\n  const typeNames = namesByTypeOnly.get(true)!\n\n  if (valueNames.size === 0 && typeNames.size === 0) {\n    if (sourceFile.sources.length > 0) return []\n    return [createExport({ path: modulePath })]\n  }\n\n  const exports: Array<ExportNode> = []\n  if (valueNames.size > 0) {\n    exports.push(createExport({ name: [...valueNames].sort(), path: modulePath }))\n  }\n  if (typeNames.size > 0) {\n    exports.push(createExport({ name: [...typeNames].sort(), path: modulePath, isTypeOnly: true }))\n  }\n  return exports\n}\n\nconst LEAF_STRATEGIES: ReadonlyMap<BarrelType, LeafStrategy> = new Map([\n  ['all', allStrategy],\n  ['named', namedStrategy],\n])\n\ntype LeafWalkParams = {\n  sourceFiles: ReadonlyMap<string, FileNode>\n  strategy: LeafStrategy\n  recursive: boolean\n}\n\n/**\n * Post-order walk that emits a barrel per visited directory.\n */\nfunction walkAllOrNamed(node: BuildTree, params: LeafWalkParams, isRoot: boolean, out: Array<FileNode>): Array<string> {\n  const subtreeLeaves: Array<string> = []\n\n  for (const child of node.children) {\n    if (child.isFile) {\n      if (!isBarrelPath(child.path)) subtreeLeaves.push(child.path)\n      continue\n    }\n\n    const childLeaves = walkAllOrNamed(child, params, false, out)\n    for (const leaf of childLeaves) subtreeLeaves.push(leaf)\n  }\n\n  if (!isRoot && !params.recursive) return subtreeLeaves\n\n  const exports = subtreeLeaves.flatMap((leafPath) => params.strategy({ dirPath: node.path, leafPath, sourceFile: params.sourceFiles.get(leafPath) }))\n\n  if (exports.length > 0) {\n    out.push(makeBarrel(node.path, exports))\n  }\n\n  return subtreeLeaves\n}\n\n/**\n * Recursive walk that emits one barrel per directory, re-exporting files and sub-barrels.\n * Used when nested: true.\n */\nfunction walkNested(node: BuildTree, out: Array<FileNode>): void {\n  const exports: Array<ExportNode> = []\n\n  for (const child of node.children) {\n    if (child.isFile) {\n      if (isBarrelPath(child.path)) continue\n      exports.push(createExport({ path: toRelativeModulePath(node.path, child.path) }))\n      continue\n    }\n\n    walkNested(child, out)\n    exports.push(createExport({ path: toRelativeModulePath(node.path, `${child.path}${BARREL_SUFFIX}`) }))\n  }\n\n  if (exports.length > 0) {\n    out.push(makeBarrel(node.path, exports))\n  }\n}\n\ntype IndexedFiles = {\n  sourceFiles: ReadonlyMap<string, FileNode>\n  paths: ReadonlyArray<string>\n}\n\nfunction indexRelevantFiles(files: ReadonlyArray<FileNode>, outputPath: string): IndexedFiles {\n  const outputPrefix = `${toPosixPath(outputPath)}/`\n  const sourceFiles = new Map<string, FileNode>()\n  const paths: Array<string> = []\n\n  for (const file of files) {\n    const normalized = toPosixPath(file.path)\n    if (!normalized.startsWith(outputPrefix)) continue\n    if (isBarrelPath(normalized)) continue\n    if (!SOURCE_EXTENSIONS.has(extname(normalized))) continue\n\n    sourceFiles.set(normalized, file)\n    paths.push(normalized)\n  }\n\n  return { sourceFiles, paths }\n}\n\ntype GetBarrelFilesParams = {\n  /**\n   * Absolute directory the barrel(s) should be rooted at.\n   * Only files living under this path are considered.\n   */\n  outputPath: string\n  /**\n   * Pool of generated files to scan for indexable sources.\n   */\n  files: ReadonlyArray<FileNode>\n  /**\n   * Export strategy used when emitting each barrel.\n   * - `'all'` re-exports the whole module (`export * from './x'`)\n   * - `'named'` re-exports only the indexable named symbols\n   */\n  barrelType: BarrelType\n  /**\n   * Generate an `index.ts` in every sub-directory, each re-exporting only what's directly inside it (hierarchical).\n   * When false, uses flat generation strategy with optional recursive subdirectory barrels.\n   *\n   * @default false\n   */\n  nested?: boolean\n  /**\n   * Also generate a barrel for each sub-directory when nested is false.\n   * No effect when nested is true (always generates hierarchical structure).\n   *\n   * @default false\n   */\n  recursive?: boolean\n}\n\n/**\n * Generates barrel `FileNode`s for the directory rooted at `outputPath`.\n */\nexport function getBarrelFiles({ outputPath, files, barrelType, nested = false, recursive = false }: GetBarrelFilesParams): Array<FileNode> {\n  const { sourceFiles, paths } = indexRelevantFiles(files, outputPath)\n  if (paths.length === 0) return []\n\n  const tree = buildTree(outputPath, paths)\n  const result: Array<FileNode> = []\n\n  // Use nested walk for hierarchical barrel structure\n  if (nested) {\n    walkNested(tree, result)\n    return result\n  }\n\n  const strategy = LEAF_STRATEGIES.get(barrelType)\n  if (!strategy) return result\n\n  walkAllOrNamed(tree, { sourceFiles, strategy, recursive }, true, result)\n  return result\n}\n","import path from 'node:path'\nimport { resolve } from 'node:path'\nimport { defineMiddleware } from '@kubb/core'\nimport type { Middleware } from '@kubb/core'\nimport type { BarrelConfig, PluginBarrelConfig } from './types.ts'\nimport { getPluginOutputPrefix, isExcludedPath } from './utils/excludedPaths.ts'\nimport { getBarrelFiles } from './utils/getBarrelFiles.ts'\n\ndeclare global {\n  namespace Kubb {\n    interface PluginOptionsRegistry {\n      output: {\n        /**\n         * Barrel configuration for this plugin's output.\n         * Set to `false` to disable barrel generation for this plugin entirely; doing so also\n         * excludes the plugin's files from the root barrel.\n         *\n         * Falls back to `config.output.barrel` when omitted.\n         *\n         * @default { type: 'named' }\n         */\n        barrel?: PluginBarrelConfig | false\n      }\n    }\n    interface ConfigOptionsRegistry {\n      output: {\n        /**\n         * Barrel configuration for the root barrel file at `config.output.path/index.ts`.\n         * Set to `false` to disable root barrel generation. Individual plugins can override\n         * this via their own `output.barrel`.\n         *\n         * @default { type: 'named' }\n         */\n        barrel?: BarrelConfig | false\n      }\n    }\n  }\n}\n\n/**\n * Generates `index.ts` barrel files for each plugin and a root barrel at `config.output.path/index.ts`.\n *\n * Each plugin inherits `output.barrel` from `config.output.barrel` (defaults to `{ type: 'named' }`).\n * Set `barrel: false` on a plugin to disable its barrel and exclude it from the root barrel.\n *\n * @example\n * ```ts\n * import { defineConfig } from '@kubb/core'\n * import { middlewareBarrel } from '@kubb/middleware-barrel'\n *\n * export default defineConfig({\n *   output: { path: 'src/gen', barrel: { type: 'named' } },\n *   plugins: [\n *     pluginTs({ output: { path: 'types', barrel: { type: 'all' } } }),\n *     pluginZod({ output: { path: 'schemas' } }),\n *   ],\n *   middleware: [middlewareBarrel()],\n * })\n * ```\n */\n\n/**\n * Stable string identifier for the barrel middleware.\n */\nexport const middlewareBarrelName = 'middleware-barrel' satisfies Middleware['name']\n\nexport const middlewareBarrel = defineMiddleware(() => {\n  const excludedPrefixes = new Set<string>()\n\n  return {\n    name: middlewareBarrelName,\n    hooks: {\n      'kubb:plugin:end'({ plugin, config, files, upsertFile }) {\n        const pluginBarrel = plugin.options.output?.barrel\n        const configBarrel = config.output.barrel\n        const defaultBarrel = { type: 'named' } as const\n\n        let barrelConfig: PluginBarrelConfig | false\n        if (pluginBarrel !== undefined) {\n          barrelConfig = pluginBarrel\n        } else if (configBarrel !== undefined) {\n          // Root config barrel doesn't have nested, so we add it\n          barrelConfig = configBarrel === false ? false : { ...configBarrel, nested: false }\n        } else {\n          barrelConfig = defaultBarrel\n        }\n\n        if (barrelConfig === false) {\n          excludedPrefixes.add(getPluginOutputPrefix(plugin, config))\n          return\n        }\n\n        const barrelType = barrelConfig.type\n        const nested = barrelConfig.nested ?? false\n\n        const base = resolve(config.root, config.output.path)\n        const target = resolve(base, plugin.options.output.path)\n        const relative = path.relative(base, target)\n        if (relative.startsWith('..') || path.isAbsolute(relative)) {\n          throw new Error('Invalid output path')\n        }\n        const barrelFiles = getBarrelFiles({\n          outputPath: target,\n          files,\n          barrelType,\n          nested,\n          recursive: true,\n        })\n\n        if (barrelFiles.length > 0) {\n          upsertFile(...barrelFiles)\n        }\n      },\n      'kubb:plugins:end'({ files, config, upsertFile }) {\n        const barrelConfig = config.output.barrel ?? { type: 'named' }\n\n        const filteredFiles = excludedPrefixes.size === 0 ? files : files.filter((f) => !isExcludedPath(f.path, excludedPrefixes))\n        excludedPrefixes.clear()\n\n        if (barrelConfig === false) return\n\n        const barrelType = barrelConfig.type\n\n        const rootBarrelFiles = getBarrelFiles({\n          outputPath: resolve(config.root, config.output.path),\n          files: filteredFiles,\n          barrelType,\n        })\n\n        if (rootBarrelFiles.length > 0) {\n          upsertFile(...rootBarrelFiles)\n        }\n      },\n    },\n  }\n})\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAcA,SAAgB,YAAY,UAA0B;AACpD,QAAO,SAAS,WAAW,MAAM,IAAI;;;;;;;;;;;;;;;;;;;;;ACwBvC,SAAgB,UAAU,UAAkB,WAA6C;CACvF,MAAM,iBAAiB,YAAY,SAAS;CAC5C,MAAM,OAAkB;EAAE,MAAM;EAAgB,UAAU,EAAE;EAAE,QAAQ;EAAO;CAE7E,MAAM,6BAAa,IAAI,KAAwC;AAC/D,YAAW,IAAI,sBAAM,IAAI,KAAK,CAAC;CAE/B,MAAM,aAAa,GAAG,eAAe;AAErC,MAAK,MAAM,YAAY,WAAW;EAChC,MAAM,aAAa,YAAY,SAAS;AACxC,MAAI,CAAC,WAAW,WAAW,WAAW,CAAE;EAExC,MAAM,QAAQ,WAAW,MAAM,WAAW,OAAO,CAAC,MAAM,IAAI;AAC5D,MAAI,MAAM,WAAW,EAAG;EAExB,IAAI,UAAU;EACd,MAAM,YAAY,MAAM,SAAS;AACjC,OAAK,MAAM,CAAC,GAAG,SAAS,MAAM,SAAS,EAAE;AACvC,OAAI,CAAC,KAAM;GAEX,MAAM,SAAS,MAAM;GACrB,MAAM,WAAW,WAAW,IAAI,QAAQ;GACxC,IAAI,QAAQ,SAAS,IAAI,KAAK;AAC9B,OAAI,CAAC,OAAO;AACV,YAAQ;KAAE,MAAM,GAAG,QAAQ,KAAK,GAAG;KAAQ,UAAU,EAAE;KAAE,QAAQ;KAAQ;AACzE,YAAQ,SAAS,KAAK,MAAM;AAC5B,aAAS,IAAI,MAAM,MAAM;AACzB,QAAI,CAAC,OAAQ,YAAW,IAAI,uBAAO,IAAI,KAAK,CAAC;;AAE/C,aAAU;;;AAId,UAAS,KAAK;AAEd,QAAO;;AAGT,SAAS,SAAS,MAAuB;AACvC,KAAI,KAAK,SAAS,WAAW,EAAG;AAChC,MAAK,SAAS,KAAK,cAAc;AACjC,MAAK,MAAM,SAAS,KAAK,SACvB,KAAI,CAAC,MAAM,OAAQ,UAAS,MAAM;;AAItC,SAAS,cAAc,GAAc,GAAsB;AACzD,QAAO,EAAE,OAAO,EAAE,OAAO,KAAK,EAAE,OAAO,EAAE,OAAO,IAAI;;;;;;;;;AC9EtD,SAAgB,sBAAsB,QAA0B,QAAwB;AACtF,QAAO,GAAG,YAAY,QAAQ,OAAO,MAAM,OAAO,OAAO,MAAM,OAAO,QAAQ,OAAO,KAAK,CAAC,CAAC;;;;;;;AAQ9F,SAAgB,eAAe,UAAkB,UAAwC;CACvF,MAAM,aAAa,YAAY,SAAS;AACxC,QAAO,SAAS,QAAQ,CAAC,MAAM,WAAW,WAAW,WAAW,OAAO,CAAC;;;;;;;ACjB1E,MAAa,kBAAkB;;;ACI/B,MAAM,oBAAoB,IAAI,IAAI;CAAC;CAAO;CAAQ;CAAO;CAAO,CAAC;AACjE,MAAM,gBAAgB,IAAI;AAE1B,SAAS,qBAAqB,SAAiB,UAA0B;AACvE,QAAO,KAAK,SAAS,MAAM,QAAQ,SAAS,EAAE;;AAGhD,SAAS,aAAa,MAAuB;AAC3C,QAAO,KAAK,SAAS,cAAc;;AAGrC,SAAS,WAAW,SAAiB,SAAsC;AACzE,QAAO,WAAW;EAChB,UAAU;EACV,MAAM,GAAG,UAAU;EACnB;EACA,SAAS,EAAE;EACX,SAAS,EAAE;EAGX,QAAQ,KAAA;EACR,QAAQ,KAAA;EACT,CAAC;;AAWJ,SAAS,2BAA2B,SAA6C;AAC/E,KAAI,QAAQ,WAAW,EAAG,QAAO;AACjC,MAAK,MAAM,UAAU,QACnB,KAAI,OAAO,YAAa,QAAO;AAEjC,QAAO;;AAGT,SAAS,wBAAwB,SAA+D;CAC9F,MAAM,aAAa,IAAI,IAA0B,CAC/C,CAAC,uBAAO,IAAI,KAAK,CAAC,EAClB,CAAC,sBAAM,IAAI,KAAK,CAAC,CAClB,CAAC;AACF,MAAK,MAAM,UAAU,SAAS;AAC5B,MAAI,CAAC,OAAO,eAAe,CAAC,OAAO,KAAM;AACzC,aAAW,IAAI,QAAQ,OAAO,WAAW,CAAC,CAAE,IAAI,OAAO,KAAK;;AAE9D,QAAO;;AAGT,MAAM,eAA6B,EAAE,SAAS,UAAU,iBAAiB;AACvE,KAAI,cAAc,2BAA2B,WAAW,QAAQ,CAAE,QAAO,EAAE;AAC3E,QAAO,CAAC,aAAa,EAAE,MAAM,qBAAqB,SAAS,SAAS,EAAE,CAAC,CAAC;;AAG1E,MAAM,iBAA+B,EAAE,SAAS,UAAU,iBAAiB;CACzE,MAAM,aAAa,qBAAqB,SAAS,SAAS;AAE1D,KAAI,CAAC,WAAY,QAAO,CAAC,aAAa,EAAE,MAAM,YAAY,CAAC,CAAC;CAE5D,MAAM,kBAAkB,wBAAwB,WAAW,QAAQ;CACnE,MAAM,aAAa,gBAAgB,IAAI,MAAM;CAC7C,MAAM,YAAY,gBAAgB,IAAI,KAAK;AAE3C,KAAI,WAAW,SAAS,KAAK,UAAU,SAAS,GAAG;AACjD,MAAI,WAAW,QAAQ,SAAS,EAAG,QAAO,EAAE;AAC5C,SAAO,CAAC,aAAa,EAAE,MAAM,YAAY,CAAC,CAAC;;CAG7C,MAAM,UAA6B,EAAE;AACrC,KAAI,WAAW,OAAO,EACpB,SAAQ,KAAK,aAAa;EAAE,MAAM,CAAC,GAAG,WAAW,CAAC,MAAM;EAAE,MAAM;EAAY,CAAC,CAAC;AAEhF,KAAI,UAAU,OAAO,EACnB,SAAQ,KAAK,aAAa;EAAE,MAAM,CAAC,GAAG,UAAU,CAAC,MAAM;EAAE,MAAM;EAAY,YAAY;EAAM,CAAC,CAAC;AAEjG,QAAO;;AAGT,MAAM,kBAAyD,IAAI,IAAI,CACrE,CAAC,OAAO,YAAY,EACpB,CAAC,SAAS,cAAc,CACzB,CAAC;;;;AAWF,SAAS,eAAe,MAAiB,QAAwB,QAAiB,KAAqC;CACrH,MAAM,gBAA+B,EAAE;AAEvC,MAAK,MAAM,SAAS,KAAK,UAAU;AACjC,MAAI,MAAM,QAAQ;AAChB,OAAI,CAAC,aAAa,MAAM,KAAK,CAAE,eAAc,KAAK,MAAM,KAAK;AAC7D;;EAGF,MAAM,cAAc,eAAe,OAAO,QAAQ,OAAO,IAAI;AAC7D,OAAK,MAAM,QAAQ,YAAa,eAAc,KAAK,KAAK;;AAG1D,KAAI,CAAC,UAAU,CAAC,OAAO,UAAW,QAAO;CAEzC,MAAM,UAAU,cAAc,SAAS,aAAa,OAAO,SAAS;EAAE,SAAS,KAAK;EAAM;EAAU,YAAY,OAAO,YAAY,IAAI,SAAS;EAAE,CAAC,CAAC;AAEpJ,KAAI,QAAQ,SAAS,EACnB,KAAI,KAAK,WAAW,KAAK,MAAM,QAAQ,CAAC;AAG1C,QAAO;;;;;;AAOT,SAAS,WAAW,MAAiB,KAA4B;CAC/D,MAAM,UAA6B,EAAE;AAErC,MAAK,MAAM,SAAS,KAAK,UAAU;AACjC,MAAI,MAAM,QAAQ;AAChB,OAAI,aAAa,MAAM,KAAK,CAAE;AAC9B,WAAQ,KAAK,aAAa,EAAE,MAAM,qBAAqB,KAAK,MAAM,MAAM,KAAK,EAAE,CAAC,CAAC;AACjF;;AAGF,aAAW,OAAO,IAAI;AACtB,UAAQ,KAAK,aAAa,EAAE,MAAM,qBAAqB,KAAK,MAAM,GAAG,MAAM,OAAO,gBAAgB,EAAE,CAAC,CAAC;;AAGxG,KAAI,QAAQ,SAAS,EACnB,KAAI,KAAK,WAAW,KAAK,MAAM,QAAQ,CAAC;;AAS5C,SAAS,mBAAmB,OAAgC,YAAkC;CAC5F,MAAM,eAAe,GAAG,YAAY,WAAW,CAAC;CAChD,MAAM,8BAAc,IAAI,KAAuB;CAC/C,MAAM,QAAuB,EAAE;AAE/B,MAAK,MAAM,QAAQ,OAAO;EACxB,MAAM,aAAa,YAAY,KAAK,KAAK;AACzC,MAAI,CAAC,WAAW,WAAW,aAAa,CAAE;AAC1C,MAAI,aAAa,WAAW,CAAE;AAC9B,MAAI,CAAC,kBAAkB,IAAI,QAAQ,WAAW,CAAC,CAAE;AAEjD,cAAY,IAAI,YAAY,KAAK;AACjC,QAAM,KAAK,WAAW;;AAGxB,QAAO;EAAE;EAAa;EAAO;;;;;AAsC/B,SAAgB,eAAe,EAAE,YAAY,OAAO,YAAY,SAAS,OAAO,YAAY,SAAgD;CAC1I,MAAM,EAAE,aAAa,UAAU,mBAAmB,OAAO,WAAW;AACpE,KAAI,MAAM,WAAW,EAAG,QAAO,EAAE;CAEjC,MAAM,OAAO,UAAU,YAAY,MAAM;CACzC,MAAM,SAA0B,EAAE;AAGlC,KAAI,QAAQ;AACV,aAAW,MAAM,OAAO;AACxB,SAAO;;CAGT,MAAM,WAAW,gBAAgB,IAAI,WAAW;AAChD,KAAI,CAAC,SAAU,QAAO;AAEtB,gBAAe,MAAM;EAAE;EAAa;EAAU;EAAW,EAAE,MAAM,OAAO;AACxE,QAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;ACjKT,MAAa,uBAAuB;AAEpC,MAAa,mBAAmB,uBAAuB;CACrD,MAAM,mCAAmB,IAAI,KAAa;AAE1C,QAAO;EACL,MAAM;EACN,OAAO;GACL,kBAAkB,EAAE,QAAQ,QAAQ,OAAO,cAAc;IACvD,MAAM,eAAe,OAAO,QAAQ,QAAQ;IAC5C,MAAM,eAAe,OAAO,OAAO;IACnC,MAAM,gBAAgB,EAAE,MAAM,SAAS;IAEvC,IAAI;AACJ,QAAI,iBAAiB,KAAA,EACnB,gBAAe;aACN,iBAAiB,KAAA,EAE1B,gBAAe,iBAAiB,QAAQ,QAAQ;KAAE,GAAG;KAAc,QAAQ;KAAO;QAElF,gBAAe;AAGjB,QAAI,iBAAiB,OAAO;AAC1B,sBAAiB,IAAI,sBAAsB,QAAQ,OAAO,CAAC;AAC3D;;IAGF,MAAM,aAAa,aAAa;IAChC,MAAM,SAAS,aAAa,UAAU;IAEtC,MAAM,OAAO,QAAQ,OAAO,MAAM,OAAO,OAAO,KAAK;IACrD,MAAM,SAAS,QAAQ,MAAM,OAAO,QAAQ,OAAO,KAAK;IACxD,MAAM,WAAW,KAAK,SAAS,MAAM,OAAO;AAC5C,QAAI,SAAS,WAAW,KAAK,IAAI,KAAK,WAAW,SAAS,CACxD,OAAM,IAAI,MAAM,sBAAsB;IAExC,MAAM,cAAc,eAAe;KACjC,YAAY;KACZ;KACA;KACA;KACA,WAAW;KACZ,CAAC;AAEF,QAAI,YAAY,SAAS,EACvB,YAAW,GAAG,YAAY;;GAG9B,mBAAmB,EAAE,OAAO,QAAQ,cAAc;IAChD,MAAM,eAAe,OAAO,OAAO,UAAU,EAAE,MAAM,SAAS;IAE9D,MAAM,gBAAgB,iBAAiB,SAAS,IAAI,QAAQ,MAAM,QAAQ,MAAM,CAAC,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAC1H,qBAAiB,OAAO;AAExB,QAAI,iBAAiB,MAAO;IAE5B,MAAM,aAAa,aAAa;IAEhC,MAAM,kBAAkB,eAAe;KACrC,YAAY,QAAQ,OAAO,MAAM,OAAO,OAAO,KAAK;KACpD,OAAO;KACP;KACD,CAAC;AAEF,QAAI,gBAAgB,SAAS,EAC3B,YAAW,GAAG,gBAAgB;;GAGnC;EACF;EACD"}
+{"version":3,"file":"index.js","names":[],"sources":["../../../internals/utils/src/path.ts","../../../internals/utils/src/buildTree.ts","../src/utils.ts","../src/middleware.ts"],"sourcesContent":["/**\n * Converts a filesystem path to use POSIX (`/`) separators.\n *\n * Most of the codebase compares and composes paths as strings (prefix matching, joining for\n * import specifiers, splitting on `/`). On POSIX `path.resolve` already returns `/`-separated\n * paths, but on Windows it returns `\\`-separated paths, which breaks every such comparison.\n *\n * Routing every path that crosses a module boundary through `toPosixPath` keeps the rest of the\n * code platform-agnostic. The conversion runs unconditionally so Windows-specific behavior is\n * exercisable from POSIX CI.\n *\n * @example\n * toPosixPath('C:\\\\repo\\\\src\\\\pet.ts') // 'C:/repo/src/pet.ts'\n */\nexport function toPosixPath(filePath: string): string {\n  return filePath.replaceAll('\\\\', '/')\n}\n","import { toPosixPath } from './path.ts'\n\n/**\n * A node in the directory tree used to compute barrel file exports.\n * Either represents a directory (with `children`) or a file (`isFile: true`, empty `children`).\n */\nexport type BuildTree = {\n  /**\n   * Absolute filesystem path of this directory or file. Always normalized to POSIX (`/`) separators.\n   */\n  path: string\n  /**\n   * Sub-directories and files contained within this directory.\n   * Always empty for file nodes.\n   */\n  children: Array<BuildTree>\n  /**\n   * `true` when this node represents a file (leaf), `false` for directory nodes.\n   */\n  isFile: boolean\n}\n\n/**\n * Builds a directory tree rooted at `rootPath` from a list of absolute file paths.\n * Paths outside `rootPath` are silently ignored. Children are sorted alphabetically\n * by path so consumers (barrel exports, propagated indexes) emit a deterministic order.\n *\n * Both POSIX (`/`) and Windows (`\\`) separators are accepted in input paths; emitted node\n * paths are always POSIX-normalized so downstream prefix/lookup operations behave the same\n * across platforms.\n *\n * @example\n * ```ts\n * buildTree('/src/gen/types', [\n *   '/src/gen/types/pet.ts',\n *   '/src/gen/types/pets/listPets.ts',\n * ])\n * ```\n */\nexport function buildTree(rootPath: string, filePaths: ReadonlyArray<string>): BuildTree {\n  const normalizedRoot = toPosixPath(rootPath)\n  const root: BuildTree = { path: normalizedRoot, children: [], isFile: false }\n  // Per-directory child lookup avoids the O(N) `Array.find` scan during insertion.\n  // WeakMap keyed by object identity so directory nodes are GC-eligible once the tree is discarded.\n  const childIndex = new WeakMap<BuildTree, Map<string, BuildTree>>()\n  childIndex.set(root, new Map())\n\n  const rootPrefix = `${normalizedRoot}/`\n\n  for (const filePath of filePaths) {\n    const normalized = toPosixPath(filePath)\n    if (!normalized.startsWith(rootPrefix)) continue\n\n    const parts = normalized.slice(rootPrefix.length).split('/')\n    if (parts.length === 0) continue\n\n    let current = root\n    const lastIndex = parts.length - 1\n    for (const [i, part] of parts.entries()) {\n      if (!part) continue\n\n      const isLast = i === lastIndex\n      const siblings = childIndex.get(current)!\n      let child = siblings.get(part)\n      if (!child) {\n        child = { path: `${current.path}/${part}`, children: [], isFile: isLast }\n        current.children.push(child)\n        siblings.set(part, child)\n        if (!isLast) childIndex.set(child, new Map())\n      }\n      current = child\n    }\n  }\n\n  sortTree(root)\n\n  return root\n}\n\nfunction sortTree(node: BuildTree): void {\n  if (node.children.length === 0) return\n  node.children.sort(compareByPath)\n  for (const child of node.children) {\n    if (!child.isFile) sortTree(child)\n  }\n}\n\nfunction compareByPath(a: BuildTree, b: BuildTree): number {\n  return a.path < b.path ? -1 : a.path > b.path ? 1 : 0\n}\n","import { extname, resolve } from 'node:path'\nimport { createExport, createFile } from '@kubb/ast'\nimport type { ExportNode, FileNode, SourceNode } from '@kubb/ast'\nimport type { Config, NormalizedPlugin } from '@kubb/core'\nimport { type BuildTree, buildTree, toPosixPath } from '@internals/utils'\nimport type { BarrelType } from './types.ts'\n\nconst SOURCE_EXTENSIONS = new Set(['.ts', '.tsx', '.js', '.jsx'])\nconst BARREL_SUFFIX = `/index.ts`\n\nfunction toRelativeModulePath(fromDir: string, filePath: string): string {\n  return `./${filePath.slice(fromDir.length + 1)}`\n}\n\nfunction isBarrelPath(path: string): boolean {\n  return path.endsWith(BARREL_SUFFIX)\n}\n\nfunction makeBarrel(dirPath: string, exports: Array<ExportNode>): FileNode {\n  return createFile({\n    baseName: 'index.ts',\n    path: `${dirPath}${BARREL_SUFFIX}`,\n    exports,\n    sources: [],\n    imports: [],\n    // Default to no banner/footer. The middleware resolves a configured plugin\n    // banner/footer (with isBarrel: true) afterwards, so a `banner` function can\n    // decide per file whether a barrel should carry a directive like \"use server\".\n    banner: undefined,\n    footer: undefined,\n  })\n}\n\ntype LeafContext = {\n  dirPath: string\n  leafPath: string\n  sourceFile: FileNode | null\n}\n\ntype LeafStrategy = (ctx: LeafContext) => Array<ExportNode>\n\nfunction hasOnlyNonIndexableSources(sources: ReadonlyArray<SourceNode>): boolean {\n  if (sources.length === 0) return false\n  for (const source of sources) {\n    if (source.isIndexable) return false\n  }\n  return true\n}\n\nfunction partitionIndexableNames(sources: ReadonlyArray<SourceNode>): Map<boolean, Set<string>> {\n  const byTypeOnly = new Map<boolean, Set<string>>([\n    [false, new Set()],\n    [true, new Set()],\n  ])\n  for (const source of sources) {\n    if (!source.isIndexable || !source.name) continue\n    byTypeOnly.get(Boolean(source.isTypeOnly))!.add(source.name)\n  }\n  return byTypeOnly\n}\n\nconst allStrategy: LeafStrategy = ({ dirPath, leafPath, sourceFile }) => {\n  if (sourceFile && hasOnlyNonIndexableSources(sourceFile.sources)) return []\n  return [createExport({ path: toRelativeModulePath(dirPath, leafPath) })]\n}\n\nconst namedStrategy: LeafStrategy = ({ dirPath, leafPath, sourceFile }) => {\n  const modulePath = toRelativeModulePath(dirPath, leafPath)\n\n  if (!sourceFile) return [createExport({ path: modulePath })]\n\n  const namesByTypeOnly = partitionIndexableNames(sourceFile.sources)\n  const valueNames = namesByTypeOnly.get(false)!\n  const typeNames = namesByTypeOnly.get(true)!\n\n  if (valueNames.size === 0 && typeNames.size === 0) {\n    if (sourceFile.sources.length > 0) return []\n    return [createExport({ path: modulePath })]\n  }\n\n  const exports: Array<ExportNode> = []\n  if (valueNames.size > 0) {\n    exports.push(createExport({ name: [...valueNames].sort(), path: modulePath }))\n  }\n  if (typeNames.size > 0) {\n    exports.push(createExport({ name: [...typeNames].sort(), path: modulePath, isTypeOnly: true }))\n  }\n  return exports\n}\n\nconst LEAF_STRATEGIES: ReadonlyMap<BarrelType, LeafStrategy> = new Map([\n  ['all', allStrategy],\n  ['named', namedStrategy],\n])\n\ntype LeafWalkParams = {\n  sourceFiles: ReadonlyMap<string, FileNode>\n  strategy: LeafStrategy\n  recursive: boolean\n}\n\n/**\n * Post-order walk that yields a barrel per visited directory.\n * Returns the list of leaf file paths collected in this subtree (used by the parent call).\n */\nfunction* walkAllOrNamed(node: BuildTree, params: LeafWalkParams, isRoot: boolean): Generator<FileNode, Array<string>> {\n  const subtreeLeaves: Array<string> = []\n\n  for (const child of node.children) {\n    if (child.isFile) {\n      if (!isBarrelPath(child.path)) subtreeLeaves.push(child.path)\n      continue\n    }\n\n    const childLeaves = yield* walkAllOrNamed(child, params, false)\n    for (const leaf of childLeaves) subtreeLeaves.push(leaf)\n  }\n\n  if (!isRoot && !params.recursive) return subtreeLeaves\n\n  const exports = subtreeLeaves.flatMap((leafPath) => params.strategy({ dirPath: node.path, leafPath, sourceFile: params.sourceFiles.get(leafPath) ?? null }))\n\n  if (exports.length > 0) {\n    yield makeBarrel(node.path, exports)\n  }\n\n  return subtreeLeaves\n}\n\n/**\n * Recursive walk that yields one barrel per directory, re-exporting files and sub-barrels.\n * Used when nested: true.\n */\nfunction* walkNested(node: BuildTree): Generator<FileNode> {\n  const exports: Array<ExportNode> = []\n\n  for (const child of node.children) {\n    if (child.isFile) {\n      if (isBarrelPath(child.path)) continue\n      exports.push(createExport({ path: toRelativeModulePath(node.path, child.path) }))\n      continue\n    }\n\n    yield* walkNested(child)\n    exports.push(createExport({ path: toRelativeModulePath(node.path, `${child.path}${BARREL_SUFFIX}`) }))\n  }\n\n  if (exports.length > 0) {\n    yield makeBarrel(node.path, exports)\n  }\n}\n\ntype IndexedFiles = {\n  sourceFiles: ReadonlyMap<string, FileNode>\n  paths: ReadonlyArray<string>\n}\n\nfunction indexRelevantFiles(files: ReadonlyArray<FileNode>, outputPath: string): IndexedFiles {\n  const outputPrefix = `${toPosixPath(outputPath)}/`\n  const sourceFiles = new Map<string, FileNode>()\n  const paths: Array<string> = []\n\n  for (const file of files) {\n    const normalized = toPosixPath(file.path)\n    if (!normalized.startsWith(outputPrefix)) continue\n    if (isBarrelPath(normalized)) continue\n    if (!SOURCE_EXTENSIONS.has(extname(normalized))) continue\n\n    sourceFiles.set(normalized, file)\n    paths.push(normalized)\n  }\n\n  return { sourceFiles, paths }\n}\n\ntype GetBarrelFilesParams = {\n  /**\n   * Absolute directory the barrel(s) should be rooted at.\n   * Only files living under this path are considered.\n   */\n  outputPath: string\n  /**\n   * Pool of generated files to scan for indexable sources.\n   */\n  files: ReadonlyArray<FileNode>\n  /**\n   * Export strategy used when emitting each barrel.\n   * - `'all'` re-exports the whole module (`export * from './x'`)\n   * - `'named'` re-exports only the indexable named symbols\n   */\n  barrelType: BarrelType\n  /**\n   * Generate an `index.ts` in every sub-directory, each re-exporting only what's directly inside it (hierarchical).\n   * When false, uses flat generation strategy with optional recursive subdirectory barrels.\n   *\n   * @default false\n   */\n  nested?: boolean\n  /**\n   * Also generate a barrel for each sub-directory when nested is false.\n   * No effect when nested is true (always generates hierarchical structure).\n   *\n   * @default false\n   */\n  recursive?: boolean\n}\n\n/**\n * Yields barrel `FileNode`s for the directory rooted at `outputPath`.\n *\n * @example\n * ```ts\n * for (const file of getBarrelFiles({ outputPath, files, barrelType })) {\n *   upsertFile(file)\n * }\n * // or collect into an array\n * const barrels = [...getBarrelFiles({ outputPath, files, barrelType })]\n * ```\n */\nexport function* getBarrelFiles({ outputPath, files, barrelType, nested = false, recursive = false }: GetBarrelFilesParams): Generator<FileNode> {\n  const { sourceFiles, paths } = indexRelevantFiles(files, outputPath)\n  if (paths.length === 0) return\n\n  const tree = buildTree(outputPath, paths)\n\n  if (nested) {\n    yield* walkNested(tree)\n    return\n  }\n\n  const strategy = LEAF_STRATEGIES.get(barrelType)\n  if (!strategy) return\n\n  yield* walkAllOrNamed(tree, { sourceFiles, strategy, recursive }, true)\n}\n\n/**\n * Builds a POSIX-normalized prefix for a plugin's output directory, with a trailing `/`.\n *\n * Used to detect (and later exclude) files generated by plugins that opted out of the root barrel.\n */\nexport function getPluginOutputPrefix(plugin: NormalizedPlugin, config: Config): string {\n  return `${toPosixPath(resolve(config.root, config.output.path, plugin.options.output.path))}/`\n}\n\n/**\n * Returns `true` when `filePath` lives under any of the given excluded directory prefixes.\n *\n * Both sides are POSIX-normalized so Windows backslash paths match correctly.\n */\nexport function isExcludedPath(filePath: string, prefixes: ReadonlySet<string>): boolean {\n  const normalized = toPosixPath(filePath)\n  return prefixes.values().some((prefix) => normalized.startsWith(prefix))\n}\n","import path from 'node:path'\nimport { resolve } from 'node:path'\nimport type { FileNode } from '@kubb/ast'\nimport { defineMiddleware } from '@kubb/core'\nimport type { Config, Middleware, NormalizedPlugin } from '@kubb/core'\nimport type { BarrelConfig, PluginBarrelConfig } from './types.ts'\nimport { getBarrelFiles, getPluginOutputPrefix, isExcludedPath } from './utils.ts'\n\n/**\n * Applies a plugin's configured `output.banner`/`footer` to a barrel file, flagged as `isBarrel`.\n *\n * Resolves through the plugin's own resolver, and only when the plugin explicitly sets a\n * banner/footer — so barrels stay banner-free by default and never inherit the implicit\n * \"Generated by Kubb\" notice.\n */\nfunction withBarrelBannerFooter({ file, plugin, config }: { file: FileNode; plugin: NormalizedPlugin; config: Config }): FileNode {\n  const output = plugin.options?.output\n  const resolver = plugin.resolver\n  if (!resolver) return file\n\n  const hasBanner = output?.banner !== undefined\n  const hasFooter = output?.footer !== undefined\n  if (!hasBanner && !hasFooter) return file\n\n  const context = { output, config, file: { path: file.path, baseName: file.baseName, isBarrel: true } }\n  return {\n    ...file,\n    banner: hasBanner ? resolver.resolveBanner(undefined, context) : file.banner,\n    footer: hasFooter ? resolver.resolveFooter(undefined, context) : file.footer,\n  }\n}\n\ndeclare global {\n  namespace Kubb {\n    interface PluginOptionsRegistry {\n      output: {\n        /**\n         * Barrel configuration for this plugin's output.\n         * Set to `false` to disable barrel generation for this plugin entirely; doing so also\n         * excludes the plugin's files from the root barrel.\n         *\n         * Falls back to `config.output.barrel` when omitted.\n         *\n         * @default { type: 'named' }\n         */\n        barrel?: PluginBarrelConfig | false\n      }\n    }\n    interface ConfigOptionsRegistry {\n      output: {\n        /**\n         * Barrel configuration for the root barrel file at `config.output.path/index.ts`.\n         * Set to `false` to disable root barrel generation. Individual plugins can override\n         * this via their own `output.barrel`.\n         *\n         * @default { type: 'named' }\n         */\n        barrel?: BarrelConfig | false\n      }\n    }\n  }\n}\n\n/**\n * Canonical middleware name for `@kubb/middleware-barrel`. Used for driver\n * lookups.\n */\nexport const middlewareBarrelName = 'middleware-barrel' satisfies Middleware['name']\n\n/**\n * Generates an `index.ts` for every plugin output directory and one root\n * barrel at `config.output.path/index.ts` after the build completes. Ships\n * with Kubb and is registered by default in `defineConfig`.\n *\n * Each plugin inherits `output.barrel` from `config.output.barrel` (which\n * defaults to `{ type: 'named' }`). Set `barrel: false` on a plugin to skip\n * its barrel and also exclude its files from the root barrel.\n *\n * @example\n * ```ts\n * import { defineConfig } from '@kubb/core'\n * import { middlewareBarrel } from '@kubb/middleware-barrel'\n * import { pluginTs } from '@kubb/plugin-ts'\n * import { pluginZod } from '@kubb/plugin-zod'\n *\n * export default defineConfig({\n *   input: { path: './petStore.yaml' },\n *   output: { path: 'src/gen', barrel: { type: 'named' } },\n *   plugins: [\n *     pluginTs({ output: { path: 'types', barrel: { type: 'all' } } }),\n *     pluginZod({ output: { path: 'schemas' } }),\n *   ],\n *   middleware: [middlewareBarrel()],\n * })\n * ```\n */\nexport const middlewareBarrel = defineMiddleware(() => {\n  const excludedPrefixes = new Set<string>()\n\n  return {\n    name: middlewareBarrelName,\n    hooks: {\n      'kubb:plugin:end'({ plugin, config, files, upsertFile }) {\n        const pluginBarrel = plugin.options.output?.barrel\n        const configBarrel = config.output.barrel\n        const defaultBarrel = { type: 'named' } as const\n\n        // Root config barrel doesn't have nested, so we add it\n        const barrelConfig: PluginBarrelConfig | false = (() => {\n          if (pluginBarrel !== undefined) return pluginBarrel\n          if (configBarrel !== undefined) return configBarrel === false ? false : { ...configBarrel, nested: false }\n          return defaultBarrel\n        })()\n\n        if (barrelConfig === false) {\n          excludedPrefixes.add(getPluginOutputPrefix(plugin, config))\n          return\n        }\n\n        const barrelType = barrelConfig.type\n        const nested = barrelConfig.nested ?? false\n\n        const base = resolve(config.root, config.output.path)\n        const target = resolve(base, plugin.options.output.path)\n        const relative = path.relative(base, target)\n        if (relative.startsWith('..') || path.isAbsolute(relative)) {\n          throw new Error('Invalid output path')\n        }\n        for (const file of getBarrelFiles({ outputPath: target, files, barrelType, nested, recursive: true })) {\n          upsertFile(withBarrelBannerFooter({ file, plugin, config }))\n        }\n      },\n      'kubb:plugins:end'({ files, config, upsertFile }) {\n        const barrelConfig = config.output.barrel ?? { type: 'named' }\n\n        const filteredFiles = excludedPrefixes.size === 0 ? files : files.filter((f) => !isExcludedPath(f.path, excludedPrefixes))\n        excludedPrefixes.clear()\n\n        if (barrelConfig === false) return\n\n        const barrelType = barrelConfig.type\n\n        for (const file of getBarrelFiles({ outputPath: resolve(config.root, config.output.path), files: filteredFiles, barrelType })) {\n          upsertFile(file)\n        }\n      },\n    },\n  }\n})\n"],"mappings":"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"}

package/extension.yaml

@@ -0,0 +1,198 @@
+$schema: https://kubb.dev/schemas/extension.json
+kind: middleware
+id: middleware-barrel
+name: Barrel
+description: Generates `index.ts` re-export files for every plugin output and one root barrel. Ships with Kubb and is enabled by default.
+category: output
+type: official
+npmPackage: '@kubb/middleware-barrel'
+docsPath: /middlewares/middleware-barrel
+repo: https://github.com/kubb-labs/kubb
+maintainers:
+  - name: Stijn Van Hulle
+    github: stijnvanhulle
+compatibility:
+  kubb: '>=5.0.0'
+  node: '>=22'
+tags:
+  - barrel
+  - index
+  - exports
+  - output
+resources:
+  documentation: https://kubb.dev/middlewares/middleware-barrel
+  repository: https://github.com/kubb-labs/kubb
+  issues: https://github.com/kubb-labs/kubb/issues
+  changelog: https://github.com/kubb-labs/kubb/blob/main/packages/middleware-barrel/CHANGELOG.md
+featured: true
+intro: |-
+  `@kubb/middleware-barrel` generates an `index.ts` for every plugin output directory and one root barrel at `output.path/index.ts` after the build completes. The result is a single import surface for every consumer — `import { Pet, usePetByIdQuery, petMock } from './gen'`.
+
+  The middleware ships with Kubb and is registered by default in `defineConfig`, so barrels appear out of the box with no extra configuration. When `middlewareBarrel` is part of `config.middleware`, `defineConfig` also applies a default `output.barrel` of `{ type: 'named' }`. Custom middleware lists that omit `middlewareBarrel` leave `barrel` untouched.
+
+  Plugins inherit `output.barrel` from `config.output.barrel` when their own value is omitted. Setting `barrel: false` on a plugin disables that plugin's barrel **and** excludes its files from the root barrel.
+options:
+  - name: barrel
+    type: "{ type: 'all' | 'named', nested?: boolean } | false"
+    required: false
+    default: "{ type: 'named' }"
+    description: |-
+      Re-export style used for every generated barrel file. Set via `output.barrel` in `defineConfig` (applies to all plugins and the root barrel) or per plugin via that plugin's own `output.barrel`. It is not an argument to the middleware itself.
+
+      At the config level:
+
+      - `{ type: 'all' }` — `export * from '...'` for every generated file.
+      - `{ type: 'named' }` — `export { Foo, Bar } from '...'` using each file's named exports.
+      - `false` — disables barrel generation entirely.
+
+      At the plugin level you also get `nested`:
+
+      - `{ type: 'named', nested: true }` — generates a barrel for every subdirectory, re-exporting only direct children. Lets callers import from any depth.
+      - `false` — disables the plugin's barrel and removes its files from the root barrel.
+
+      The `{ type: 'named' }` default kicks in only when `middlewareBarrel` is part of `config.middleware`.
+    codeBlock:
+      lang: typescript
+      title: kubb.config.ts
+      twoslash: false
+      code: |-
+        import { defineConfig } from 'kubb'
+        import { middlewareBarrel } from '@kubb/middleware-barrel'
+
+        export default defineConfig({
+          input: { path: './petStore.yaml' },
+          output: { path: './src/gen', barrel: { type: 'named' } },
+          middleware: [middlewareBarrel()],
+          plugins: [],
+        })
+examples:
+  - name: "{ type: 'named' } (default)"
+    files:
+      - name: kubb.config.ts
+        lang: typescript
+        twoslash: false
+        code: |-
+          import { defineConfig } from 'kubb'
+
+          export default defineConfig({
+            input: { path: './petStore.yaml' },
+            output: { path: './src/gen' },
+            plugins: [],
+          })
+      - name: Generated output
+        lang: typescript
+        twoslash: false
+        code: |-
+          // src/gen/index.ts
+          export { getUser, User } from './api/user'
+          export { getPost, Post } from './api/post'
+          export { User } from './api/types/User'
+          export { useUser } from './hooks/useUser'
+
+          // src/gen/api/index.ts
+          export { getUser, User } from './user'
+          export { getPost, Post } from './post'
+          export { User } from './types/User'
+
+          // src/gen/api/types/index.ts
+          export { User } from './User'
+  - name: "{ type: 'all' }"
+    files:
+      - name: kubb.config.ts
+        lang: typescript
+        twoslash: false
+        code: |-
+          import { defineConfig } from 'kubb'
+
+          export default defineConfig({
+            input: { path: './petStore.yaml' },
+            output: { path: './src/gen', barrel: { type: 'all' } },
+            plugins: [],
+          })
+      - name: Generated output
+        lang: typescript
+        twoslash: false
+        code: |-
+          // src/gen/index.ts
+          export * from './api/user'
+          export * from './api/post'
+          export * from './api/types/User'
+          export * from './hooks/useUser'
+
+          // src/gen/api/index.ts
+          export * from './user'
+          export * from './post'
+          export * from './types/User'
+
+          // src/gen/api/types/index.ts
+          export * from './User'
+  - name: "{ type: 'named', nested: true }"
+    files:
+      - name: kubb.config.ts
+        lang: typescript
+        twoslash: false
+        code: |-
+          import { defineConfig } from 'kubb'
+
+          export default defineConfig({
+            input: { path: './petStore.yaml' },
+            output: { path: './src/gen', barrel: { type: 'named', nested: true } },
+            plugins: [],
+          })
+      - name: Generated output (chained structure)
+        lang: typescript
+        twoslash: false
+        code: |-
+          // src/gen/index.ts (only exports directories)
+          export * from './api'
+          export * from './hooks'
+
+          // src/gen/api/index.ts (exports files and subdirs)
+          export * from './user'
+          export * from './post'
+          export * from './types'
+
+          // src/gen/api/types/index.ts (exports files)
+          export * from './User'
+  - name: Disable the barrel for a single plugin
+    files:
+      - name: kubb.config.ts
+        lang: typescript
+        twoslash: false
+        code: |-
+          import { defineConfig } from 'kubb'
+          import { pluginTs } from '@kubb/plugin-ts'
+          import { pluginZod } from '@kubb/plugin-zod'
+
+          // pluginZod opts out: no zod/index.ts is created,
+          // and zod files are excluded from the root index.ts.
+          export default defineConfig({
+            input: { path: './petStore.yaml' },
+            output: { path: './src/gen' },
+            plugins: [
+              pluginTs(),
+              pluginZod({ output: { barrel: false } }),
+            ],
+          })
+  - name: Disable only the root barrel
+    files:
+      - name: kubb.config.ts
+        lang: typescript
+        twoslash: false
+        code: |-
+          import { defineConfig } from 'kubb'
+
+          // No root index.ts is generated, but each plugin
+          // still gets its own barrel using its inherited config.
+          export default defineConfig({
+            input: { path: './petStore.yaml' },
+            output: { path: './src/gen', barrel: false },
+            plugins: [],
+          })
+notes:
+  - type: tip
+    body: |-
+      `middleware-barrel` ships with Kubb and is enabled automatically when no `middleware` option is provided. Install it explicitly only when customising barrel behaviour alongside other middlewares.
+  - type: note
+    body: |-
+      `output.barrel` is auto-defaulted to `{ type: 'named' }` only when `middlewareBarrel` is part of `config.middleware`. With a custom middleware list that omits it, set `output.barrel` yourself if you still want a barrel.

package/package.json

@@ -1,14 +1,12 @@
 {
   "name": "@kubb/middleware-barrel",
-  "version": "5.0.0-beta.3",
-  "description": "Barrel-file generation middleware for Kubb. Generates index.ts barrel files for each plugin's output directory and a root index.ts after all plugins have run.",
+  "version": "5.0.0-beta.31",
+  "description": "Barrel-file middleware for Kubb. Automatically generates index.ts re-export files per plugin output directory and an optional root barrel after all plugins complete.",
   "keywords": [
     "barrel",
-    "code-generator",
     "codegen",
     "kubb",
     "middleware",
-    "openapi",
     "typescript"
   ],
   "license": "MIT",
@@ -21,6 +19,7 @@
   "files": [
     "src",
     "dist",
+    "extension.yaml",
     "*.d.ts",
     "*.d.cts",
     "!/**/**.test.**",
@@ -43,11 +42,14 @@
     "access": "public",
     "registry": "https://registry.npmjs.org/"
   },
+  "dependencies": {
+    "@kubb/ast": "5.0.0-beta.31"
+  },
   "devDependencies": {
     "@internals/utils": "0.0.0"
   },
   "peerDependencies": {
-    "@kubb/core": "5.0.0-beta.3"
+    "@kubb/core": "5.0.0-beta.31"
   },
   "engines": {
     "node": ">=22"