@kubb/middleware-barrel 5.0.0-alpha.61 → 5.0.0-alpha.63

package/dist/index.cjs

@@ -11,16 +11,13 @@ const BARREL_FILENAME = "index.ts";
 //#endregion
 //#region src/utils/buildTree.ts
 /**
-* Builds a `TreeNode` directory tree from a list of absolute file paths.
-*
-* All `filePaths` must be inside `rootPath`. Paths that are outside
-* the root or that equal the root are silently ignored.
+* Builds a directory tree rooted at `rootPath` from a list of absolute file paths.
+* Paths outside `rootPath` are silently ignored.
 *
 * @example
 * ```ts
-* const tree = buildTree('/src/gen/types', [
+* buildTree('/src/gen/types', [
 *   '/src/gen/types/pet.ts',
-*   '/src/gen/types/user.ts',
 *   '/src/gen/types/pets/listPets.ts',
 * ])
 * ```
@@ -62,51 +59,48 @@ const SOURCE_EXTENSIONS = new Set([
 	".jsx"
 ]);
 /**
-* Derives a relative module specifier from an absolute `filePath` relative to an absolute `fromDir`.
-* The source extension is preserved so that `@kubb/parser-ts` can apply the `extNames` mapping
-* (e.g. `.ts` → `.js` for ESM output).
+* Derives a relative module specifier from `filePath` relative to `fromDir`.
+* The source extension is preserved so `@kubb/parser-ts` can apply its `extNames` mapping.
 *
 * @example
+* ```ts
 * toRelativeModulePath('/src/gen/types', '/src/gen/types/pet.ts') // './pet.ts'
 * toRelativeModulePath('/src/gen/types', '/src/gen/types/tags/tag.ts') // './tags/tag.ts'
+* ```
 */
 function toRelativeModulePath(fromDir, filePath) {
 	return `./${filePath.slice(fromDir.length).replace(/^[/\\]/g, "")}`;
 }
-/**
-* Generates barrel `FileNode[]` for a given directory tree node using the `'all'` strategy:
-* each leaf file gets a `export * from './relPath'` in the barrel of its nearest ancestor directory.
-*
-* Only a single barrel file (at `treeNode.path`) is generated — sub-directory files are referenced
-* with their full relative path from `treeNode.path`.
-*/
-function getBarrelFilesAll(treeNode, sourceFiles) {
+function getBarrelFilesAll({ treeNode, sourceFiles, recursive = false }) {
 	const leafPaths = collectLeafPaths(treeNode).filter((p) => !p.endsWith(`/${BARREL_FILENAME}`));
 	if (leafPaths.length === 0) return [];
-	const barrelPath = `${treeNode.path}/${BARREL_FILENAME}`;
 	const exports = [];
 	for (const filePath of leafPaths) {
 		const sourceFile = sourceFiles.find((f) => f.path === filePath);
 		if (sourceFile && sourceFile.sources.length > 0 && sourceFile.sources.every((s) => !s.isIndexable)) continue;
 		exports.push((0, _kubb_ast.createExport)({ path: toRelativeModulePath(treeNode.path, filePath) }));
 	}
-	if (exports.length === 0) return [];
-	return [(0, _kubb_ast.createFile)({
+	const result = [];
+	if (recursive) {
+		for (const child of treeNode.children) if (!child.isFile) result.push(...getBarrelFilesAll({
+			treeNode: child,
+			sourceFiles,
+			recursive: true
+		}));
+	}
+	if (exports.length === 0) return result;
+	result.push((0, _kubb_ast.createFile)({
 		baseName: BARREL_FILENAME,
-		path: barrelPath,
+		path: `${treeNode.path}/${BARREL_FILENAME}`,
 		exports,
 		sources: [],
 		imports: []
-	})];
+	}));
+	return result;
 }
-/**
-* Generates barrel `FileNode[]` for a given directory tree node using the `'named'` strategy:
-* each indexable source in each leaf file gets an individual named `export { name } from '...'`.
-*/
-function getBarrelFilesNamed(treeNode, sourceFiles) {
+function getBarrelFilesNamed({ treeNode, sourceFiles, recursive = false }) {
 	const leafPaths = collectLeafPaths(treeNode).filter((p) => !p.endsWith(`/${BARREL_FILENAME}`));
 	if (leafPaths.length === 0) return [];
-	const barrelPath = `${treeNode.path}/${BARREL_FILENAME}`;
 	const exports = [];
 	for (const filePath of leafPaths) {
 		const sourceFile = sourceFiles.find((f) => f.path === filePath);
@@ -133,23 +127,24 @@ function getBarrelFilesNamed(treeNode, sourceFiles) {
 			isTypeOnly: true
 		}));
 	}
-	if (exports.length === 0) return [];
-	return [(0, _kubb_ast.createFile)({
+	const result = [];
+	if (recursive) {
+		for (const child of treeNode.children) if (!child.isFile) result.push(...getBarrelFilesNamed({
+			treeNode: child,
+			sourceFiles,
+			recursive: true
+		}));
+	}
+	if (exports.length > 0) result.push((0, _kubb_ast.createFile)({
 		baseName: BARREL_FILENAME,
-		path: barrelPath,
+		path: `${treeNode.path}/${BARREL_FILENAME}`,
 		exports,
 		sources: [],
 		imports: []
-	})];
+	}));
+	return result;
 }
-/**
-* Generates barrel `FileNode[]` for a given directory tree node using the `'propagate'` strategy:
-* like `'all'` but also generates intermediate barrel files for every sub-directory, so that
-* consumers can import from any depth.
-*
-* Leaf barrels export directly from their files; parent barrels export from their sub-barrel files.
-*/
-function getBarrelFilesPropagate(treeNode) {
+function getBarrelFilesPropagate({ treeNode }) {
 	return collectPropagatedBarrels(treeNode);
 }
 function collectPropagatedBarrels(node) {
@@ -172,24 +167,17 @@ function collectPropagatedBarrels(node) {
 	}));
 	return result;
 }
-/**
-* Collects all leaf (file) paths within a tree node recursively.
-*/
 function collectLeafPaths(node) {
 	if (node.isFile) return [node.path];
 	return node.children.flatMap((c) => collectLeafPaths(c));
 }
 /**
-* Generates barrel `FileNode[]` for a directory rooted at `outputPath`, given the full set of
-* generated source `files`, using the specified `barrelType` strategy.
-*
-* Files not located inside `outputPath` are excluded automatically.
+* Generates barrel `FileNode`s for the directory rooted at `outputPath`.
 *
-* @param outputPath Absolute path to the output directory.
-* @param files All generated files (across all plugins).
-* @param barrelType Barrel generation strategy.
+* Files outside `outputPath`, existing barrel files, and non-source extensions are filtered out
+* before the tree is built.
 */
-function getBarrelFiles(outputPath, files, barrelType) {
+function getBarrelFiles({ outputPath, files, barrelType, recursive = false }) {
 	const relevantFiles = files.filter((f) => {
 		const normalizedFilePath = f.path.replace(/\\/g, "/");
 		const normalizedOutputPath = outputPath.replace(/\\/g, "/");
@@ -202,9 +190,17 @@ function getBarrelFiles(outputPath, files, barrelType) {
 	if (relevantFiles.length === 0) return [];
 	const tree = buildTree(outputPath, relevantFiles.map((f) => f.path));
 	switch (barrelType) {
-		case "all": return getBarrelFilesAll(tree, relevantFiles);
-		case "named": return getBarrelFilesNamed(tree, relevantFiles);
-		case "propagate": return getBarrelFilesPropagate(tree);
+		case "all": return getBarrelFilesAll({
+			treeNode: tree,
+			sourceFiles: relevantFiles,
+			recursive
+		});
+		case "named": return getBarrelFilesNamed({
+			treeNode: tree,
+			sourceFiles: relevantFiles,
+			recursive
+		});
+		case "propagate": return getBarrelFilesPropagate({ treeNode: tree });
 		default: return [];
 	}
 }
@@ -213,47 +209,46 @@ function getBarrelFiles(outputPath, files, barrelType) {
 /**
 * Generates barrel files for a single plugin's output directory.
 *
-* The barrel file is placed at `resolve(config.root, config.output.path, plugin.options.output.path)/index.ts`
-* and re-exports all files generated by that plugin, using the given `barrelType` strategy.
-*
-* Note: `plugin.options.output.path` is relative to `config.output.path`, not to `config.root`.
-* Files generated by plugins land at `config.root + config.output.path + plugin.output.path`,
-* so the barrel directory must be resolved with all three segments.
+* The barrel is placed at `<config.root>/<config.output.path>/<plugin.options.output.path>/index.ts`.
+* When the plugin uses `group`, additional sub-directory barrels are generated so that grouped
+* output (e.g. `petController/index.ts`) gets its own re-export entry point.
 */
 function generatePerPluginBarrel({ barrelType, plugin, files, config }) {
-	return getBarrelFiles((0, node_path.resolve)(config.root, config.output.path, plugin.options.output.path), files, barrelType);
+	return getBarrelFiles({
+		outputPath: (0, node_path.resolve)(config.root, config.output.path, plugin.options.output.path),
+		files,
+		barrelType,
+		recursive: true
+	});
 }
 //#endregion
 //#region src/utils/generateRootBarrel.ts
 /**
-* Generates a root barrel file at `resolve(config.root, config.output.path)/index.ts`.
+* Generates the root barrel file at `<config.root>/<config.output.path>/index.ts`.
 *
-* The root barrel re-exports from all files across all plugins that are located
-* inside the root output directory, using the given `barrelType` strategy.
-*
-* In practice this re-exports the per-plugin barrels when `barrelType = 'propagate'`,
-* or all individual files when `barrelType = 'all'` or `'named'`.
+* Unlike `generatePerPluginBarrel`, this does not recurse into sub-directories — each
+* plugin is responsible for its own per-plugin barrels.
 */
 function generateRootBarrel({ barrelType, files, config }) {
-	return getBarrelFiles((0, node_path.resolve)(config.root, config.output.path), files, barrelType);
+	return getBarrelFiles({
+		outputPath: (0, node_path.resolve)(config.root, config.output.path),
+		files,
+		barrelType
+	});
 }
 //#endregion
 //#region src/middleware.ts
 /**
-* Barrel-file generation middleware.
-*
-* When added to `config.middleware`, generates an `index.ts` barrel file for each
-* plugin. When `output.barrelType` is omitted on a plugin it inherits from `config.output.barrelType`,
-* and when that is also omitted both default to `'all'`. Set `barrelType: false` to disable
-* barrel generation for a specific plugin or for the root entirely.
+* Generates `index.ts` barrel files for each plugin's output directory and one root barrel
+* at `config.output.path/index.ts`.
 *
-* The `barrelType` option controls the re-export style:
-* - `'all'`       — `export * from '...'` for each generated file
-* - `'named'`     — `export { name1, name2 } from '...'` using each file's indexable sources
-* - `'propagate'` — like `'all'` with intermediate barrel files for sub-directories
+* Plugins inherit `output.barrelType` from `config.output.barrelType` (which itself defaults to `'named'`).
+* Setting `barrelType: false` on a plugin disables its barrel and excludes the plugin's files from the
+* root barrel as well.
 *
 * @example
 * ```ts
+* import { defineConfig } from '@kubb/core'
 * import { middlewareBarrel } from '@kubb/middleware-barrel'
 *
 * export default defineConfig({
@@ -270,17 +265,15 @@ const middlewareBarrel = (0, _kubb_core.defineMiddleware)({
 	name: "middleware-barrel",
 	install(hooks) {
 		let ctx;
-		const excludedOutputPaths = [];
+		const excludedPaths = /* @__PURE__ */ new Set();
 		hooks.on("kubb:build:start", (buildCtx) => {
 			ctx = buildCtx;
 		});
 		hooks.on("kubb:plugin:end", ({ plugin }) => {
 			if (!ctx) return;
-			const pluginOutput = plugin.options.output;
-			const barrelType = pluginOutput?.barrelType !== void 0 ? pluginOutput.barrelType : ctx.config.output.barrelType ?? "all";
+			const barrelType = plugin.options.output?.barrelType ?? ctx.config.output.barrelType ?? "all";
 			if (!barrelType) {
-				const outputPath = plugin.options.output.path;
-				excludedOutputPaths.push(outputPath);
+				excludedPaths.add((0, node_path.resolve)(ctx.config.root, ctx.config.output.path, plugin.options.output.path));
 				return;
 			}
 			const barrelFiles = generatePerPluginBarrel({
@@ -292,14 +285,11 @@ const middlewareBarrel = (0, _kubb_core.defineMiddleware)({
 			if (barrelFiles.length > 0) ctx.upsertFile(...barrelFiles);
 		});
 		hooks.on("kubb:plugins:end", ({ files, config, upsertFile }) => {
-			const rootBarrelType = config.output.barrelType ?? "all";
+			const rootBarrelType = config.output.barrelType ?? "named";
 			if (!rootBarrelType) return;
 			const rootBarrelFiles = generateRootBarrel({
 				barrelType: rootBarrelType,
-				files: excludedOutputPaths.length > 0 ? files.filter((f) => {
-					const normalizedPath = f.path.replace(/\\/g, "/");
-					return !excludedOutputPaths.some((excluded) => normalizedPath.startsWith(excluded.replace(/\\/g, "/") + "/"));
-				}) : files,
+				files: excludedPaths.size > 0 ? files.filter((f) => ![...excludedPaths].some((excluded) => f.path.startsWith(excluded + "/"))) : files,
 				config
 			});
 			if (rootBarrelFiles.length > 0) upsertFile(...rootBarrelFiles);

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":["posix"],"sources":["../src/constants.ts","../src/utils/buildTree.ts","../src/utils/getBarrelFiles.ts","../src/utils/generatePerPluginBarrel.ts","../src/utils/generateRootBarrel.ts","../src/middleware.ts"],"sourcesContent":["\n/**\n * Full file name for barrel files (with extension).\n */\nexport const BARREL_FILENAME = 'index.ts' as const\n","import { posix } from 'node:path'\n\n/**\n * A node in a directory tree used to compute barrel file exports.\n *\n * Each `TreeNode` represents either a directory or a file entry.\n * Directory nodes have `children`; file nodes have an empty `children` array.\n */\nexport type BuildTree = {\n  /**\n   * Absolute path of the directory (root of this subtree) or file.\n   */\n  path: string\n  /**\n   * Child nodes (sub-directories and files) within this directory.\n   */\n  children: Array<BuildTree>\n  /**\n   * `true` when this node represents a file (leaf node).\n   */\n  isFile: boolean\n}\n\n/**\n * Builds a `TreeNode` directory tree from a list of absolute file paths.\n *\n * All `filePaths` must be inside `rootPath`. Paths that are outside\n * the root or that equal the root are silently ignored.\n *\n * @example\n * ```ts\n * const tree = buildTree('/src/gen/types', [\n *   '/src/gen/types/pet.ts',\n *   '/src/gen/types/user.ts',\n *   '/src/gen/types/pets/listPets.ts',\n * ])\n * ```\n */\nexport function buildTree(rootPath: string, filePaths: ReadonlyArray<string>): BuildTree {\n  const root: BuildTree = { path: rootPath, children: [], isFile: false }\n\n  for (const filePath of filePaths) {\n    // Only include files inside rootPath\n    if (!filePath.startsWith(rootPath + posix.sep) && !filePath.startsWith(rootPath + '/')) {\n      continue\n    }\n\n    const relative = filePath.slice(rootPath.length).replace(/^\\//g, '').replace(/^\\\\/g, '')\n    const parts = relative.split(/[/\\\\]/).filter(Boolean)\n\n    let current = root\n    for (let i = 0; i < parts.length; i++) {\n      const isLast = i === parts.length - 1\n      const part = parts[i]!\n      const childPath = `${current.path}/${part}`\n\n      let child = current.children.find((c) => c.path === childPath)\n      if (!child) {\n        child = { path: childPath, children: [], isFile: isLast }\n        current.children.push(child)\n      }\n      current = child\n    }\n  }\n\n  return root\n}\n","import { createExport, createFile } from '@kubb/ast'\nimport type { FileNode } from '@kubb/ast'\nimport { BARREL_FILENAME } from '../constants.ts'\nimport type { BarrelType } from '../types.ts'\nimport { buildTree, type BuildTree } from './buildTree.ts'\n\nconst SOURCE_EXTENSIONS = new Set(['.ts', '.tsx', '.js', '.jsx'])\n\n/**\n * Derives a relative module specifier from an absolute `filePath` relative to an absolute `fromDir`.\n * The source extension is preserved so that `@kubb/parser-ts` can apply the `extNames` mapping\n * (e.g. `.ts` → `.js` for ESM output).\n *\n * @example\n * toRelativeModulePath('/src/gen/types', '/src/gen/types/pet.ts') // './pet.ts'\n * toRelativeModulePath('/src/gen/types', '/src/gen/types/tags/tag.ts') // './tags/tag.ts'\n */\nfunction toRelativeModulePath(fromDir: string, filePath: string): string {\n  const relative = filePath.slice(fromDir.length).replace(/^[/\\\\]/g, '')\n  return `./${relative}`\n}\n\n/**\n * Generates barrel `FileNode[]` for a given directory tree node using the `'all'` strategy:\n * each leaf file gets a `export * from './relPath'` in the barrel of its nearest ancestor directory.\n *\n * Only a single barrel file (at `treeNode.path`) is generated — sub-directory files are referenced\n * with their full relative path from `treeNode.path`.\n */\nfunction getBarrelFilesAll(treeNode: BuildTree, sourceFiles: ReadonlyArray<FileNode>): Array<FileNode> {\n  // Collect all source file paths under this node (excluding barrel files themselves)\n  const leafPaths = collectLeafPaths(treeNode).filter((p) => !p.endsWith(`/${BARREL_FILENAME}`))\n\n  if (leafPaths.length === 0) return []\n\n  const barrelPath = `${treeNode.path}/${BARREL_FILENAME}`\n  const exports: ReturnType<typeof createExport>[] = []\n\n  for (const filePath of leafPaths) {\n    const sourceFile = sourceFiles.find((f) => f.path === filePath)\n    // Skip files whose sources all have isIndexable: false (e.g. internal injected files)\n    if (sourceFile && sourceFile.sources.length > 0 && sourceFile.sources.every((s) => !s.isIndexable)) {\n      continue\n    }\n    exports.push(createExport({ path: toRelativeModulePath(treeNode.path, filePath) }))\n  }\n\n  if (exports.length === 0) return []\n\n  return [\n    createFile({\n      baseName: BARREL_FILENAME,\n      path: barrelPath,\n      exports,\n      sources: [],\n      imports: [],\n    }),\n  ]\n}\n\n/**\n * Generates barrel `FileNode[]` for a given directory tree node using the `'named'` strategy:\n * each indexable source in each leaf file gets an individual named `export { name } from '...'`.\n */\nfunction getBarrelFilesNamed(treeNode: BuildTree, sourceFiles: ReadonlyArray<FileNode>): Array<FileNode> {\n  const leafPaths = collectLeafPaths(treeNode).filter((p) => !p.endsWith(`/${BARREL_FILENAME}`))\n\n  if (leafPaths.length === 0) return []\n\n  const barrelPath = `${treeNode.path}/${BARREL_FILENAME}`\n  const exports: ReturnType<typeof createExport>[] = []\n\n  for (const filePath of leafPaths) {\n    const sourceFile = sourceFiles.find((f) => f.path === filePath)\n    if (!sourceFile) {\n      // Fall back to wildcard if the source file is not in our set\n      exports.push(createExport({ path: toRelativeModulePath(treeNode.path, filePath) }))\n      continue\n    }\n\n    const indexableSources = sourceFile.sources.filter((s) => s.isIndexable && s.name)\n    if (indexableSources.length === 0) {\n      // If the file has explicit sources but none are indexable, skip it entirely.\n      // Only fall back to wildcard when there are no sources at all (unknown exports).\n      if (sourceFile.sources.length > 0) continue\n      exports.push(createExport({ path: toRelativeModulePath(treeNode.path, filePath) }))\n      continue\n    }\n\n    const valueNames = indexableSources.filter((s) => !s.isTypeOnly).map((s) => s.name as string)\n    const typeNames = indexableSources.filter((s) => s.isTypeOnly).map((s) => s.name as string)\n    const modulePath = toRelativeModulePath(treeNode.path, filePath)\n\n    if (valueNames.length > 0) {\n      exports.push(createExport({ name: valueNames, path: modulePath }))\n    }\n    if (typeNames.length > 0) {\n      exports.push(createExport({ name: typeNames, path: modulePath, isTypeOnly: true }))\n    }\n  }\n\n  if (exports.length === 0) return []\n\n  return [\n    createFile({\n      baseName: BARREL_FILENAME,\n      path: barrelPath,\n      exports,\n      sources: [],\n      imports: [],\n    }),\n  ]\n}\n\n/**\n * Generates barrel `FileNode[]` for a given directory tree node using the `'propagate'` strategy:\n * like `'all'` but also generates intermediate barrel files for every sub-directory, so that\n * consumers can import from any depth.\n *\n * Leaf barrels export directly from their files; parent barrels export from their sub-barrel files.\n */\nfunction getBarrelFilesPropagate(treeNode: BuildTree): Array<FileNode> {\n  return collectPropagatedBarrels(treeNode)\n}\n\nfunction collectPropagatedBarrels(node: BuildTree): Array<FileNode> {\n  const result: Array<FileNode> = []\n  const barrelExports: ReturnType<typeof createExport>[] = []\n\n  for (const child of node.children) {\n    if (child.isFile) {\n      if (!child.path.endsWith(`/${BARREL_FILENAME}`)) {\n        barrelExports.push(createExport({ path: toRelativeModulePath(node.path, child.path) }))\n      }\n    } else {\n      // Recurse into sub-directory\n      const subBarrels = collectPropagatedBarrels(child)\n      result.push(...subBarrels)\n\n      // Export the sub-directory's barrel (not individual files)\n      const subBarrelPath = `${child.path}/${BARREL_FILENAME}`\n      barrelExports.push(createExport({ path: toRelativeModulePath(node.path, subBarrelPath) }))\n    }\n  }\n\n  if (barrelExports.length > 0) {\n    result.push(\n      createFile({\n        baseName: BARREL_FILENAME,\n        path: `${node.path}/${BARREL_FILENAME}`,\n        exports: barrelExports,\n        sources: [],\n        imports: [],\n      }),\n    )\n  }\n\n  return result\n}\n\n/**\n * Collects all leaf (file) paths within a tree node recursively.\n */\nfunction collectLeafPaths(node: BuildTree): Array<string> {\n  if (node.isFile) return [node.path]\n  return node.children.flatMap((c) => collectLeafPaths(c))\n}\n\n/**\n * Generates barrel `FileNode[]` for a directory rooted at `outputPath`, given the full set of\n * generated source `files`, using the specified `barrelType` strategy.\n *\n * Files not located inside `outputPath` are excluded automatically.\n *\n * @param outputPath Absolute path to the output directory.\n * @param files All generated files (across all plugins).\n * @param barrelType Barrel generation strategy.\n */\nexport function getBarrelFiles(outputPath: string, files: ReadonlyArray<FileNode>, barrelType: BarrelType): Array<FileNode> {\n  // Only include files that live inside this outputPath and have a recognised source extension\n  const relevantFiles = files.filter((f) => {\n    const normalizedFilePath = f.path.replace(/\\\\/g, '/')\n    const normalizedOutputPath = outputPath.replace(/\\\\/g, '/')\n    if (!normalizedFilePath.startsWith(normalizedOutputPath + '/')) return false\n    if (normalizedFilePath.endsWith(`/${BARREL_FILENAME}`)) return false\n    const dotIndex = normalizedFilePath.lastIndexOf('.')\n    const ext = dotIndex === -1 ? '' : normalizedFilePath.slice(dotIndex)\n    return SOURCE_EXTENSIONS.has(ext)\n  })\n\n  if (relevantFiles.length === 0) return []\n\n  const tree = buildTree(\n    outputPath,\n    relevantFiles.map((f) => f.path),\n  )\n\n  switch (barrelType) {\n    case 'all':\n      return getBarrelFilesAll(tree, relevantFiles)\n    case 'named':\n      return getBarrelFilesNamed(tree, relevantFiles)\n    case 'propagate':\n      return getBarrelFilesPropagate(tree)\n    default:\n      return []\n  }\n}\n","import { resolve } from 'node:path'\nimport type { FileNode } from '@kubb/ast'\nimport type { Config, NormalizedPlugin } from '@kubb/core'\nimport type { BarrelType } from '../types.ts'\nimport { getBarrelFiles } from './getBarrelFiles.ts'\n\nexport type GeneratePerPluginBarrelParams = {\n  barrelType: BarrelType\n  plugin: NormalizedPlugin\n  files: ReadonlyArray<FileNode>\n  config: Config\n}\n\n/**\n * Generates barrel files for a single plugin's output directory.\n *\n * The barrel file is placed at `resolve(config.root, config.output.path, plugin.options.output.path)/index.ts`\n * and re-exports all files generated by that plugin, using the given `barrelType` strategy.\n *\n * Note: `plugin.options.output.path` is relative to `config.output.path`, not to `config.root`.\n * Files generated by plugins land at `config.root + config.output.path + plugin.output.path`,\n * so the barrel directory must be resolved with all three segments.\n */\nexport function generatePerPluginBarrel({ barrelType, plugin, files, config }: GeneratePerPluginBarrelParams): Array<FileNode> {\n  const outputPath = resolve(config.root, config.output.path, plugin.options.output.path)\n\n  return getBarrelFiles(outputPath, files, barrelType)\n}\n","import { resolve } from 'node:path'\nimport type { FileNode } from '@kubb/ast'\nimport type { Config } from '@kubb/core'\nimport type { BarrelType } from '../types.ts'\nimport { getBarrelFiles } from './getBarrelFiles.ts'\n\nexport type GenerateRootBarrelParams = {\n  barrelType: BarrelType\n  files: ReadonlyArray<FileNode>\n  config: Config\n}\n\n/**\n * Generates a root barrel file at `resolve(config.root, config.output.path)/index.ts`.\n *\n * The root barrel re-exports from all files across all plugins that are located\n * inside the root output directory, using the given `barrelType` strategy.\n *\n * In practice this re-exports the per-plugin barrels when `barrelType = 'propagate'`,\n * or all individual files when `barrelType = 'all'` or `'named'`.\n */\nexport function generateRootBarrel({ barrelType, files, config }: GenerateRootBarrelParams): Array<FileNode> {\n  const outputPath = resolve(config.root, config.output.path)\n\n  return getBarrelFiles(outputPath, files, barrelType)\n}\n","import { defineMiddleware } from '@kubb/core'\nimport type { KubbBuildStartContext } from '@kubb/core'\nimport './types.ts'\nimport type { BarrelType } from './types.ts'\nimport { generatePerPluginBarrel } from './utils/generatePerPluginBarrel.ts'\nimport { generateRootBarrel } from './utils/generateRootBarrel.ts'\n\n\ndeclare global {\n  namespace Kubb {\n    interface PluginOptionsRegistry {\n      output: {\n        /**\n         * Controls which barrel file (index.ts) is generated for this plugin's output directory.\n         *\n         * - `'all'`       — `export * from '...'` for every generated file.\n         * - `'named'`     — `export { … } from '...'` using the file's named exports.\n         * - `'propagate'` — like `'all'` but also generates intermediate barrel files.\n         * - `false`       — disable barrel generation for this plugin.\n         *\n         * When omitted, the root `config.output.barrelType` is used as the default.\n         */\n        barrelType?: BarrelType | false\n      }\n    }\n    interface ConfigOptionsRegistry {\n      output: {\n        /**\n         * Controls the root barrel file (index.ts) generated at `config.output.path`.\n         *\n         * - `'all'`       — `export * from '...'` for every plugin's barrel.\n         * - `'named'`     — `export { … } from '...'` using the barrel's named exports.\n         * - `'propagate'` — like `'all'` but also generates intermediate barrel files.\n         * - `false`       — disable root barrel generation.\n         *\n         * Individual plugins can override this via their own `output.barrelType`.\n         */\n        barrelType?: BarrelType | false\n      }\n    }\n  }\n}\n\n/**\n * Barrel-file generation middleware.\n *\n * When added to `config.middleware`, generates an `index.ts` barrel file for each\n * plugin. When `output.barrelType` is omitted on a plugin it inherits from `config.output.barrelType`,\n * and when that is also omitted both default to `'all'`. Set `barrelType: false` to disable\n * barrel generation for a specific plugin or for the root entirely.\n *\n * The `barrelType` option controls the re-export style:\n * - `'all'`       — `export * from '...'` for each generated file\n * - `'named'`     — `export { name1, name2 } from '...'` using each file's indexable sources\n * - `'propagate'` — like `'all'` with intermediate barrel files for sub-directories\n *\n * @example\n * ```ts\n * import { middlewareBarrel } from '@kubb/middleware-barrel'\n *\n * export default defineConfig({\n *   output: { path: 'src/gen', barrelType: 'named' },\n *   plugins: [\n *     pluginTs({ output: { path: 'types', barrelType: 'all' } }),\n *     pluginZod({ output: { path: 'schemas' } }),\n *   ],\n *   middleware: [middlewareBarrel],\n * })\n * ```\n */\nexport const middlewareBarrel = defineMiddleware({\n  name: 'middleware-barrel',\n  install(hooks) {\n    let ctx: KubbBuildStartContext\n    // Track output paths of plugins with barrelType: false so the root barrel\n    // can exclude their files.\n    const excludedOutputPaths: string[] = []\n\n    hooks.on('kubb:build:start', (buildCtx) => {\n      ctx = buildCtx\n    })\n\n    hooks.on('kubb:plugin:end', ({ plugin }) => {\n      if (!ctx) return\n\n      const pluginOutput = plugin.options.output\n      const barrelType = pluginOutput?.barrelType !== undefined ? pluginOutput.barrelType : (ctx.config.output.barrelType ?? 'all')\n\n      if (!barrelType) {\n        // Remember this plugin's output path so we can exclude it from the root barrel\n        const outputPath = plugin.options.output.path\n        excludedOutputPaths.push(outputPath)\n        return\n      }\n\n      const barrelFiles = generatePerPluginBarrel({\n        barrelType,\n        plugin,\n        files: ctx.files,\n        config: ctx.config,\n      })\n\n      if (barrelFiles.length > 0) {\n        ctx.upsertFile(...barrelFiles)\n      }\n    })\n\n    hooks.on('kubb:plugins:end', ({ files, config, upsertFile }) => {\n      const rootBarrelType = config.output.barrelType ?? 'all'\n\n      if (!rootBarrelType) return\n\n      // Exclude files that belong to plugins with barrelType: false\n      const filteredFiles =\n        excludedOutputPaths.length > 0\n          ? files.filter((f) => {\n              const normalizedPath = f.path.replace(/\\\\/g, '/')\n              return !excludedOutputPaths.some((excluded) => normalizedPath.startsWith(excluded.replace(/\\\\/g, '/') + '/'))\n            })\n          : files\n\n      const rootBarrelFiles = generateRootBarrel({\n        barrelType: rootBarrelType,\n        files: filteredFiles,\n        config,\n      })\n\n      if (rootBarrelFiles.length > 0) {\n        upsertFile(...rootBarrelFiles)\n      }\n    })\n  },\n})\n"],"mappings":"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"}
+{"version":3,"file":"index.cjs","names":["posix"],"sources":["../src/constants.ts","../src/utils/buildTree.ts","../src/utils/getBarrelFiles.ts","../src/utils/generatePerPluginBarrel.ts","../src/utils/generateRootBarrel.ts","../src/middleware.ts"],"sourcesContent":["/**\n * Full file name for barrel files (with extension).\n */\nexport const BARREL_FILENAME = 'index.ts' as const\n","import { posix } from 'node:path'\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.\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.\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 root: BuildTree = { path: rootPath, children: [], isFile: false }\n\n  for (const filePath of filePaths) {\n    // Only include files inside rootPath\n    if (!filePath.startsWith(rootPath + posix.sep) && !filePath.startsWith(rootPath + '/')) {\n      continue\n    }\n\n    const relative = filePath.slice(rootPath.length).replace(/^\\//g, '').replace(/^\\\\/g, '')\n    const parts = relative.split(/[/\\\\]/).filter(Boolean)\n\n    let current = root\n    for (let i = 0; i < parts.length; i++) {\n      const isLast = i === parts.length - 1\n      const part = parts[i]!\n      const childPath = `${current.path}/${part}`\n\n      let child = current.children.find((c) => c.path === childPath)\n      if (!child) {\n        child = { path: childPath, children: [], isFile: isLast }\n        current.children.push(child)\n      }\n      current = child\n    }\n  }\n\n  return root\n}\n","import { createExport, createFile } from '@kubb/ast'\nimport type { FileNode } from '@kubb/ast'\nimport { BARREL_FILENAME } from '../constants.ts'\nimport type { BarrelType } from '../types.ts'\nimport { buildTree, type BuildTree } from './buildTree.ts'\n\nconst SOURCE_EXTENSIONS = new Set(['.ts', '.tsx', '.js', '.jsx'])\n\n/**\n * Derives a relative module specifier from `filePath` relative to `fromDir`.\n * The source extension is preserved so `@kubb/parser-ts` can apply its `extNames` mapping.\n *\n * @example\n * ```ts\n * toRelativeModulePath('/src/gen/types', '/src/gen/types/pet.ts') // './pet.ts'\n * toRelativeModulePath('/src/gen/types', '/src/gen/types/tags/tag.ts') // './tags/tag.ts'\n * ```\n */\nfunction toRelativeModulePath(fromDir: string, filePath: string): string {\n  const relative = filePath.slice(fromDir.length).replace(/^[/\\\\]/g, '')\n  return `./${relative}`\n}\n\ntype BarrelFilesParams = {\n  treeNode: BuildTree\n  sourceFiles: ReadonlyArray<FileNode>\n  recursive?: boolean\n}\n\nfunction getBarrelFilesAll({ treeNode, sourceFiles, recursive = false }: BarrelFilesParams): Array<FileNode> {\n  const leafPaths = collectLeafPaths(treeNode).filter((p) => !p.endsWith(`/${BARREL_FILENAME}`))\n\n  if (leafPaths.length === 0) return []\n\n  const exports: ReturnType<typeof createExport>[] = []\n\n  for (const filePath of leafPaths) {\n    const sourceFile = sourceFiles.find((f) => f.path === filePath)\n    if (sourceFile && sourceFile.sources.length > 0 && sourceFile.sources.every((s) => !s.isIndexable)) {\n      continue\n    }\n    exports.push(createExport({ path: toRelativeModulePath(treeNode.path, filePath) }))\n  }\n\n  const result: Array<FileNode> = []\n\n  if (recursive) {\n    for (const child of treeNode.children) {\n      if (!child.isFile) {\n        result.push(...getBarrelFilesAll({ treeNode: child, sourceFiles, recursive: true }))\n      }\n    }\n  }\n\n  if (exports.length === 0) return result\n\n  result.push(\n    createFile({\n      baseName: BARREL_FILENAME,\n      path: `${treeNode.path}/${BARREL_FILENAME}`,\n      exports,\n      sources: [],\n      imports: [],\n    }),\n  )\n\n  return result\n}\n\nfunction getBarrelFilesNamed({ treeNode, sourceFiles, recursive = false }: BarrelFilesParams): Array<FileNode> {\n  const leafPaths = collectLeafPaths(treeNode).filter((p) => !p.endsWith(`/${BARREL_FILENAME}`))\n\n  if (leafPaths.length === 0) return []\n\n  const exports: ReturnType<typeof createExport>[] = []\n\n  for (const filePath of leafPaths) {\n    const sourceFile = sourceFiles.find((f) => f.path === filePath)\n    if (!sourceFile) {\n      exports.push(createExport({ path: toRelativeModulePath(treeNode.path, filePath) }))\n      continue\n    }\n\n    const indexableSources = sourceFile.sources.filter((s) => s.isIndexable && s.name)\n    if (indexableSources.length === 0) {\n      if (sourceFile.sources.length > 0) continue\n      exports.push(createExport({ path: toRelativeModulePath(treeNode.path, filePath) }))\n      continue\n    }\n\n    const valueNames = indexableSources.filter((s) => !s.isTypeOnly).map((s) => s.name as string)\n    const typeNames = indexableSources.filter((s) => s.isTypeOnly).map((s) => s.name as string)\n    const modulePath = toRelativeModulePath(treeNode.path, filePath)\n\n    if (valueNames.length > 0) {\n      exports.push(createExport({ name: valueNames, path: modulePath }))\n    }\n    if (typeNames.length > 0) {\n      exports.push(createExport({ name: typeNames, path: modulePath, isTypeOnly: true }))\n    }\n  }\n\n  const result: Array<FileNode> = []\n\n  if (recursive) {\n    for (const child of treeNode.children) {\n      if (!child.isFile) {\n        result.push(...getBarrelFilesNamed({ treeNode: child, sourceFiles, recursive: true }))\n      }\n    }\n  }\n\n  if (exports.length > 0) {\n    result.push(\n      createFile({\n        baseName: BARREL_FILENAME,\n        path: `${treeNode.path}/${BARREL_FILENAME}`,\n        exports,\n        sources: [],\n        imports: [],\n      }),\n    )\n  }\n\n  return result\n}\n\nfunction getBarrelFilesPropagate({ treeNode }: Pick<BarrelFilesParams, 'treeNode'>): Array<FileNode> {\n  return collectPropagatedBarrels(treeNode)\n}\n\nfunction collectPropagatedBarrels(node: BuildTree): Array<FileNode> {\n  const result: Array<FileNode> = []\n  const barrelExports: ReturnType<typeof createExport>[] = []\n\n  for (const child of node.children) {\n    if (child.isFile) {\n      if (!child.path.endsWith(`/${BARREL_FILENAME}`)) {\n        barrelExports.push(createExport({ path: toRelativeModulePath(node.path, child.path) }))\n      }\n    } else {\n      const subBarrels = collectPropagatedBarrels(child)\n      result.push(...subBarrels)\n\n      const subBarrelPath = `${child.path}/${BARREL_FILENAME}`\n      barrelExports.push(createExport({ path: toRelativeModulePath(node.path, subBarrelPath) }))\n    }\n  }\n\n  if (barrelExports.length > 0) {\n    result.push(\n      createFile({\n        baseName: BARREL_FILENAME,\n        path: `${node.path}/${BARREL_FILENAME}`,\n        exports: barrelExports,\n        sources: [],\n        imports: [],\n      }),\n    )\n  }\n\n  return result\n}\n\nfunction collectLeafPaths(node: BuildTree): Array<string> {\n  if (node.isFile) return [node.path]\n  return node.children.flatMap((c) => collectLeafPaths(c))\n}\n\nexport type GetBarrelFilesParams = {\n  /**\n   * Absolute path to the directory the barrel(s) should be rooted at.\n   * Files outside this directory are ignored.\n   */\n  outputPath: string\n  /**\n   * Full set of generated files across all plugins.\n   * Used both to discover what to re-export and to read each file's indexable sources.\n   */\n  files: ReadonlyArray<FileNode>\n  /**\n   * Re-export style used in the generated barrel(s).\n   */\n  barrelType: BarrelType\n  /**\n   * When `true`, also generate a barrel for each sub-directory of `outputPath`.\n   * Used by per-plugin barrels so that grouped output (e.g. `petController/`) gets its own `index.ts`.\n   *\n   * Has no effect for `barrelType: 'propagate'`, which always recurses by design.\n   *\n   * @default false\n   */\n  recursive?: boolean\n}\n\n/**\n * Generates barrel `FileNode`s for the directory rooted at `outputPath`.\n *\n * Files outside `outputPath`, existing barrel files, and non-source extensions are filtered out\n * before the tree is built.\n */\nexport function getBarrelFiles({ outputPath, files, barrelType, recursive = false }: GetBarrelFilesParams): Array<FileNode> {\n  const relevantFiles = files.filter((f) => {\n    const normalizedFilePath = f.path.replace(/\\\\/g, '/')\n    const normalizedOutputPath = outputPath.replace(/\\\\/g, '/')\n    if (!normalizedFilePath.startsWith(normalizedOutputPath + '/')) return false\n    if (normalizedFilePath.endsWith(`/${BARREL_FILENAME}`)) return false\n    const dotIndex = normalizedFilePath.lastIndexOf('.')\n    const ext = dotIndex === -1 ? '' : normalizedFilePath.slice(dotIndex)\n    return SOURCE_EXTENSIONS.has(ext)\n  })\n\n  if (relevantFiles.length === 0) return []\n\n  const tree = buildTree(\n    outputPath,\n    relevantFiles.map((f) => f.path),\n  )\n\n  switch (barrelType) {\n    case 'all':\n      return getBarrelFilesAll({ treeNode: tree, sourceFiles: relevantFiles, recursive })\n    case 'named':\n      return getBarrelFilesNamed({ treeNode: tree, sourceFiles: relevantFiles, recursive })\n    case 'propagate':\n      return getBarrelFilesPropagate({ treeNode: tree })\n    default:\n      return []\n  }\n}\n","import { resolve } from 'node:path'\nimport type { FileNode } from '@kubb/ast'\nimport type { Config, NormalizedPlugin } from '@kubb/core'\nimport type { BarrelType } from '../types.ts'\nimport { getBarrelFiles } from './getBarrelFiles.ts'\n\nexport type GeneratePerPluginBarrelParams = {\n  /**\n   * Re-export style used in the plugin's barrel file(s).\n   */\n  barrelType: BarrelType\n  /**\n   * Plugin whose `output.path` determines the barrel directory.\n   */\n  plugin: NormalizedPlugin\n  /**\n   * Full set of generated files across all plugins.\n   * Files outside the plugin's output directory are filtered out automatically.\n   */\n  files: ReadonlyArray<FileNode>\n  /**\n   * Resolved Kubb config; used to compute the absolute output directory.\n   */\n  config: Config\n}\n\n/**\n * Generates barrel files for a single plugin's output directory.\n *\n * The barrel is placed at `<config.root>/<config.output.path>/<plugin.options.output.path>/index.ts`.\n * When the plugin uses `group`, additional sub-directory barrels are generated so that grouped\n * output (e.g. `petController/index.ts`) gets its own re-export entry point.\n */\nexport function generatePerPluginBarrel({ barrelType, plugin, files, config }: GeneratePerPluginBarrelParams): Array<FileNode> {\n  const outputPath = resolve(config.root, config.output.path, plugin.options.output.path)\n\n  return getBarrelFiles({ outputPath, files, barrelType, recursive: true })\n}\n","import { resolve } from 'node:path'\nimport type { FileNode } from '@kubb/ast'\nimport type { Config } from '@kubb/core'\nimport type { BarrelType } from '../types.ts'\nimport { getBarrelFiles } from './getBarrelFiles.ts'\n\nexport type GenerateRootBarrelParams = {\n  /**\n   * Re-export style used in the root barrel file.\n   */\n  barrelType: BarrelType\n  /**\n   * Files eligible for re-export. The middleware filters out files belonging to plugins\n   * with `barrelType: false` before passing them in.\n   */\n  files: ReadonlyArray<FileNode>\n  /**\n   * Resolved Kubb config; used to compute the root output directory.\n   */\n  config: Config\n}\n\n/**\n * Generates the root barrel file at `<config.root>/<config.output.path>/index.ts`.\n *\n * Unlike `generatePerPluginBarrel`, this does not recurse into sub-directories — each\n * plugin is responsible for its own per-plugin barrels.\n */\nexport function generateRootBarrel({ barrelType, files, config }: GenerateRootBarrelParams): Array<FileNode> {\n  const outputPath = resolve(config.root, config.output.path)\n\n  return getBarrelFiles({ outputPath, files, barrelType })\n}\n","import { defineMiddleware } from '@kubb/core'\nimport type { KubbBuildStartContext } from '@kubb/core'\nimport type { BarrelType } from './types.ts'\nimport { generatePerPluginBarrel } from './utils/generatePerPluginBarrel.ts'\nimport { generateRootBarrel } from './utils/generateRootBarrel.ts'\nimport { resolve } from 'node:path'\n\ndeclare global {\n  namespace Kubb {\n    interface PluginOptionsRegistry {\n      output: {\n        /**\n         * Re-export style for this plugin's barrel file.\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.barrelType` when omitted.\n         */\n        barrelType?: BarrelType | false\n      }\n    }\n    interface ConfigOptionsRegistry {\n      output: {\n        /**\n         * Re-export style 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.barrelType`.\n         *\n         * @default 'named'\n         */\n        barrelType?: BarrelType | false\n      }\n    }\n  }\n}\n\n/**\n * Generates `index.ts` barrel files for each plugin's output directory and one root barrel\n * at `config.output.path/index.ts`.\n *\n * Plugins inherit `output.barrelType` from `config.output.barrelType` (which itself defaults to `'named'`).\n * Setting `barrelType: false` on a plugin disables its barrel and excludes the plugin's files from the\n * root barrel as well.\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', barrelType: 'named' },\n *   plugins: [\n *     pluginTs({ output: { path: 'types', barrelType: 'all' } }),\n *     pluginZod({ output: { path: 'schemas' } }),\n *   ],\n *   middleware: [middlewareBarrel],\n * })\n * ```\n */\nexport const middlewareBarrel = defineMiddleware({\n  name: 'middleware-barrel',\n  install(hooks) {\n    let ctx: KubbBuildStartContext\n    const excludedPaths = new Set<string>()\n\n    hooks.on('kubb:build:start', (buildCtx) => {\n      ctx = buildCtx\n    })\n\n    hooks.on('kubb:plugin:end', ({ plugin }) => {\n      if (!ctx) return\n\n      const barrelType = plugin.options.output?.barrelType ?? ctx.config.output.barrelType ?? 'all'\n\n      if (!barrelType) {\n        excludedPaths.add(resolve(ctx.config.root, ctx.config.output.path, plugin.options.output.path))\n        return\n      }\n\n      const barrelFiles = generatePerPluginBarrel({\n        barrelType,\n        plugin,\n        files: ctx.files,\n        config: ctx.config,\n      })\n\n      if (barrelFiles.length > 0) {\n        ctx.upsertFile(...barrelFiles)\n      }\n    })\n\n    hooks.on('kubb:plugins:end', ({ files, config, upsertFile }) => {\n      const rootBarrelType = config.output.barrelType ?? 'named'\n      if (!rootBarrelType) return\n\n      const filteredFiles = excludedPaths.size > 0 ? files.filter((f) => ![...excludedPaths].some((excluded) => f.path.startsWith(excluded + '/'))) : files\n\n      const rootBarrelFiles = generateRootBarrel({\n        barrelType: rootBarrelType,\n        files: filteredFiles,\n        config,\n      })\n\n      if (rootBarrelFiles.length > 0) {\n        upsertFile(...rootBarrelFiles)\n      }\n    })\n  },\n})\n"],"mappings":";;;;;;;;;AAGA,MAAa,kBAAkB;;;;;;;;;;;;;;;AC+B/B,SAAgB,UAAU,UAAkB,WAA6C;CACvF,MAAM,OAAkB;EAAE,MAAM;EAAU,UAAU,EAAE;EAAE,QAAQ;EAAO;AAEvE,MAAK,MAAM,YAAY,WAAW;AAEhC,MAAI,CAAC,SAAS,WAAW,WAAWA,UAAAA,MAAM,IAAI,IAAI,CAAC,SAAS,WAAW,WAAW,IAAI,CACpF;EAIF,MAAM,QADW,SAAS,MAAM,SAAS,OAAO,CAAC,QAAQ,QAAQ,GAAG,CAAC,QAAQ,QAAQ,GAC/D,CAAC,MAAM,QAAQ,CAAC,OAAO,QAAQ;EAErD,IAAI,UAAU;AACd,OAAK,IAAI,IAAI,GAAG,IAAI,MAAM,QAAQ,KAAK;GACrC,MAAM,SAAS,MAAM,MAAM,SAAS;GACpC,MAAM,OAAO,MAAM;GACnB,MAAM,YAAY,GAAG,QAAQ,KAAK,GAAG;GAErC,IAAI,QAAQ,QAAQ,SAAS,MAAM,MAAM,EAAE,SAAS,UAAU;AAC9D,OAAI,CAAC,OAAO;AACV,YAAQ;KAAE,MAAM;KAAW,UAAU,EAAE;KAAE,QAAQ;KAAQ;AACzD,YAAQ,SAAS,KAAK,MAAM;;AAE9B,aAAU;;;AAId,QAAO;;;;ACvDT,MAAM,oBAAoB,IAAI,IAAI;CAAC;CAAO;CAAQ;CAAO;CAAO,CAAC;;;;;;;;;;;AAYjE,SAAS,qBAAqB,SAAiB,UAA0B;AAEvE,QAAO,KADU,SAAS,MAAM,QAAQ,OAAO,CAAC,QAAQ,WAAW,GAC/C;;AAStB,SAAS,kBAAkB,EAAE,UAAU,aAAa,YAAY,SAA6C;CAC3G,MAAM,YAAY,iBAAiB,SAAS,CAAC,QAAQ,MAAM,CAAC,EAAE,SAAS,IAAI,kBAAkB,CAAC;AAE9F,KAAI,UAAU,WAAW,EAAG,QAAO,EAAE;CAErC,MAAM,UAA6C,EAAE;AAErD,MAAK,MAAM,YAAY,WAAW;EAChC,MAAM,aAAa,YAAY,MAAM,MAAM,EAAE,SAAS,SAAS;AAC/D,MAAI,cAAc,WAAW,QAAQ,SAAS,KAAK,WAAW,QAAQ,OAAO,MAAM,CAAC,EAAE,YAAY,CAChG;AAEF,UAAQ,MAAA,GAAA,UAAA,cAAkB,EAAE,MAAM,qBAAqB,SAAS,MAAM,SAAS,EAAE,CAAC,CAAC;;CAGrF,MAAM,SAA0B,EAAE;AAElC,KAAI;OACG,MAAM,SAAS,SAAS,SAC3B,KAAI,CAAC,MAAM,OACT,QAAO,KAAK,GAAG,kBAAkB;GAAE,UAAU;GAAO;GAAa,WAAW;GAAM,CAAC,CAAC;;AAK1F,KAAI,QAAQ,WAAW,EAAG,QAAO;AAEjC,QAAO,MAAA,GAAA,UAAA,YACM;EACT,UAAU;EACV,MAAM,GAAG,SAAS,KAAK,GAAG;EAC1B;EACA,SAAS,EAAE;EACX,SAAS,EAAE;EACZ,CAAC,CACH;AAED,QAAO;;AAGT,SAAS,oBAAoB,EAAE,UAAU,aAAa,YAAY,SAA6C;CAC7G,MAAM,YAAY,iBAAiB,SAAS,CAAC,QAAQ,MAAM,CAAC,EAAE,SAAS,IAAI,kBAAkB,CAAC;AAE9F,KAAI,UAAU,WAAW,EAAG,QAAO,EAAE;CAErC,MAAM,UAA6C,EAAE;AAErD,MAAK,MAAM,YAAY,WAAW;EAChC,MAAM,aAAa,YAAY,MAAM,MAAM,EAAE,SAAS,SAAS;AAC/D,MAAI,CAAC,YAAY;AACf,WAAQ,MAAA,GAAA,UAAA,cAAkB,EAAE,MAAM,qBAAqB,SAAS,MAAM,SAAS,EAAE,CAAC,CAAC;AACnF;;EAGF,MAAM,mBAAmB,WAAW,QAAQ,QAAQ,MAAM,EAAE,eAAe,EAAE,KAAK;AAClF,MAAI,iBAAiB,WAAW,GAAG;AACjC,OAAI,WAAW,QAAQ,SAAS,EAAG;AACnC,WAAQ,MAAA,GAAA,UAAA,cAAkB,EAAE,MAAM,qBAAqB,SAAS,MAAM,SAAS,EAAE,CAAC,CAAC;AACnF;;EAGF,MAAM,aAAa,iBAAiB,QAAQ,MAAM,CAAC,EAAE,WAAW,CAAC,KAAK,MAAM,EAAE,KAAe;EAC7F,MAAM,YAAY,iBAAiB,QAAQ,MAAM,EAAE,WAAW,CAAC,KAAK,MAAM,EAAE,KAAe;EAC3F,MAAM,aAAa,qBAAqB,SAAS,MAAM,SAAS;AAEhE,MAAI,WAAW,SAAS,EACtB,SAAQ,MAAA,GAAA,UAAA,cAAkB;GAAE,MAAM;GAAY,MAAM;GAAY,CAAC,CAAC;AAEpE,MAAI,UAAU,SAAS,EACrB,SAAQ,MAAA,GAAA,UAAA,cAAkB;GAAE,MAAM;GAAW,MAAM;GAAY,YAAY;GAAM,CAAC,CAAC;;CAIvF,MAAM,SAA0B,EAAE;AAElC,KAAI;OACG,MAAM,SAAS,SAAS,SAC3B,KAAI,CAAC,MAAM,OACT,QAAO,KAAK,GAAG,oBAAoB;GAAE,UAAU;GAAO;GAAa,WAAW;GAAM,CAAC,CAAC;;AAK5F,KAAI,QAAQ,SAAS,EACnB,QAAO,MAAA,GAAA,UAAA,YACM;EACT,UAAU;EACV,MAAM,GAAG,SAAS,KAAK,GAAG;EAC1B;EACA,SAAS,EAAE;EACX,SAAS,EAAE;EACZ,CAAC,CACH;AAGH,QAAO;;AAGT,SAAS,wBAAwB,EAAE,YAAkE;AACnG,QAAO,yBAAyB,SAAS;;AAG3C,SAAS,yBAAyB,MAAkC;CAClE,MAAM,SAA0B,EAAE;CAClC,MAAM,gBAAmD,EAAE;AAE3D,MAAK,MAAM,SAAS,KAAK,SACvB,KAAI,MAAM;MACJ,CAAC,MAAM,KAAK,SAAS,YAAsB,CAC7C,eAAc,MAAA,GAAA,UAAA,cAAkB,EAAE,MAAM,qBAAqB,KAAK,MAAM,MAAM,KAAK,EAAE,CAAC,CAAC;QAEpF;EACL,MAAM,aAAa,yBAAyB,MAAM;AAClD,SAAO,KAAK,GAAG,WAAW;EAE1B,MAAM,gBAAgB,GAAG,MAAM,KAAK,GAAG;AACvC,gBAAc,MAAA,GAAA,UAAA,cAAkB,EAAE,MAAM,qBAAqB,KAAK,MAAM,cAAc,EAAE,CAAC,CAAC;;AAI9F,KAAI,cAAc,SAAS,EACzB,QAAO,MAAA,GAAA,UAAA,YACM;EACT,UAAU;EACV,MAAM,GAAG,KAAK,KAAK,GAAG;EACtB,SAAS;EACT,SAAS,EAAE;EACX,SAAS,EAAE;EACZ,CAAC,CACH;AAGH,QAAO;;AAGT,SAAS,iBAAiB,MAAgC;AACxD,KAAI,KAAK,OAAQ,QAAO,CAAC,KAAK,KAAK;AACnC,QAAO,KAAK,SAAS,SAAS,MAAM,iBAAiB,EAAE,CAAC;;;;;;;;AAmC1D,SAAgB,eAAe,EAAE,YAAY,OAAO,YAAY,YAAY,SAAgD;CAC1H,MAAM,gBAAgB,MAAM,QAAQ,MAAM;EACxC,MAAM,qBAAqB,EAAE,KAAK,QAAQ,OAAO,IAAI;EACrD,MAAM,uBAAuB,WAAW,QAAQ,OAAO,IAAI;AAC3D,MAAI,CAAC,mBAAmB,WAAW,uBAAuB,IAAI,CAAE,QAAO;AACvE,MAAI,mBAAmB,SAAS,YAAsB,CAAE,QAAO;EAC/D,MAAM,WAAW,mBAAmB,YAAY,IAAI;EACpD,MAAM,MAAM,aAAa,KAAK,KAAK,mBAAmB,MAAM,SAAS;AACrE,SAAO,kBAAkB,IAAI,IAAI;GACjC;AAEF,KAAI,cAAc,WAAW,EAAG,QAAO,EAAE;CAEzC,MAAM,OAAO,UACX,YACA,cAAc,KAAK,MAAM,EAAE,KAAK,CACjC;AAED,SAAQ,YAAR;EACE,KAAK,MACH,QAAO,kBAAkB;GAAE,UAAU;GAAM,aAAa;GAAe;GAAW,CAAC;EACrF,KAAK,QACH,QAAO,oBAAoB;GAAE,UAAU;GAAM,aAAa;GAAe;GAAW,CAAC;EACvF,KAAK,YACH,QAAO,wBAAwB,EAAE,UAAU,MAAM,CAAC;EACpD,QACE,QAAO,EAAE;;;;;;;;;;;;AClMf,SAAgB,wBAAwB,EAAE,YAAY,QAAQ,OAAO,UAA0D;AAG7H,QAAO,eAAe;EAAE,aAAA,GAAA,UAAA,SAFG,OAAO,MAAM,OAAO,OAAO,MAAM,OAAO,QAAQ,OAAO,KAEhD;EAAE;EAAO;EAAY,WAAW;EAAM,CAAC;;;;;;;;;;ACR3E,SAAgB,mBAAmB,EAAE,YAAY,OAAO,UAAqD;AAG3G,QAAO,eAAe;EAAE,aAAA,GAAA,UAAA,SAFG,OAAO,MAAM,OAAO,OAAO,KAEpB;EAAE;EAAO;EAAY,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;AC4B1D,MAAa,oBAAA,GAAA,WAAA,kBAAoC;CAC/C,MAAM;CACN,QAAQ,OAAO;EACb,IAAI;EACJ,MAAM,gCAAgB,IAAI,KAAa;AAEvC,QAAM,GAAG,qBAAqB,aAAa;AACzC,SAAM;IACN;AAEF,QAAM,GAAG,oBAAoB,EAAE,aAAa;AAC1C,OAAI,CAAC,IAAK;GAEV,MAAM,aAAa,OAAO,QAAQ,QAAQ,cAAc,IAAI,OAAO,OAAO,cAAc;AAExF,OAAI,CAAC,YAAY;AACf,kBAAc,KAAA,GAAA,UAAA,SAAY,IAAI,OAAO,MAAM,IAAI,OAAO,OAAO,MAAM,OAAO,QAAQ,OAAO,KAAK,CAAC;AAC/F;;GAGF,MAAM,cAAc,wBAAwB;IAC1C;IACA;IACA,OAAO,IAAI;IACX,QAAQ,IAAI;IACb,CAAC;AAEF,OAAI,YAAY,SAAS,EACvB,KAAI,WAAW,GAAG,YAAY;IAEhC;AAEF,QAAM,GAAG,qBAAqB,EAAE,OAAO,QAAQ,iBAAiB;GAC9D,MAAM,iBAAiB,OAAO,OAAO,cAAc;AACnD,OAAI,CAAC,eAAgB;GAIrB,MAAM,kBAAkB,mBAAmB;IACzC,YAAY;IACZ,OAJoB,cAAc,OAAO,IAAI,MAAM,QAAQ,MAAM,CAAC,CAAC,GAAG,cAAc,CAAC,MAAM,aAAa,EAAE,KAAK,WAAW,WAAW,IAAI,CAAC,CAAC,GAAG;IAK9I;IACD,CAAC;AAEF,OAAI,gBAAgB,SAAS,EAC3B,YAAW,GAAG,gBAAgB;IAEhC;;CAEL,CAAC"}

package/dist/index.d.ts

@@ -3,12 +3,11 @@ import * as _$_kubb_core0 from "@kubb/core";
 
 //#region src/types.d.ts
 /**
- * The barrel type controls the style of re-exports generated in barrel files.
- *
- * - `'all'`       — `export * from '...'` (re-export everything)
- * - `'named'`     — `export { name1, name2 } from '...'` (named re-exports only)
- * - `'propagate'` — like `'all'` but also generates intermediate barrel files for
- *                   every sub-directory so that consumers can import from any depth.
+ * Re-export style used when generating barrel `index.ts` files.
+ * - `'all'` emits `export * from '...'` for every file.
+ * - `'named'` emits `export { name1, name2 } from '...'` from each file's indexable sources.
+ * - `'propagate'` behaves like `'all'` and also generates an intermediate barrel for every
+ *   sub-directory so consumers can import from any depth.
  */
 type BarrelType = 'all' | 'named' | 'propagate';
 //#endregion
@@ -18,14 +17,11 @@ declare global {
     interface PluginOptionsRegistry {
       output: {
         /**
-         * Controls which barrel file (index.ts) is generated for this plugin's output directory.
-         *
-         * - `'all'`       — `export * from '...'` for every generated file.
-         * - `'named'`     — `export { … } from '...'` using the file's named exports.
-         * - `'propagate'` — like `'all'` but also generates intermediate barrel files.
-         * - `false`       — disable barrel generation for this plugin.
+         * Re-export style for this plugin's barrel file.
+         * Set to `false` to disable barrel generation for this plugin entirely; doing so also
+         * excludes the plugin's files from the root barrel.
          *
-         * When omitted, the root `config.output.barrelType` is used as the default.
+         * Falls back to `config.output.barrelType` when omitted.
          */
         barrelType?: BarrelType | false;
       };
@@ -33,14 +29,11 @@ declare global {
     interface ConfigOptionsRegistry {
       output: {
         /**
-         * Controls the root barrel file (index.ts) generated at `config.output.path`.
+         * Re-export style for the root barrel file at `config.output.path/index.ts`.
+         * Set to `false` to disable root barrel generation. Individual plugins can override
+         * this via their own `output.barrelType`.
          *
-         * - `'all'`       — `export * from '...'` for every plugin's barrel.
-         * - `'named'`     — `export { … } from '...'` using the barrel's named exports.
-         * - `'propagate'` — like `'all'` but also generates intermediate barrel files.
-         * - `false`       — disable root barrel generation.
-         *
-         * Individual plugins can override this via their own `output.barrelType`.
+         * @default 'named'
          */
         barrelType?: BarrelType | false;
       };
@@ -48,20 +41,16 @@ declare global {
   }
 }
 /**
- * Barrel-file generation middleware.
- *
- * When added to `config.middleware`, generates an `index.ts` barrel file for each
- * plugin. When `output.barrelType` is omitted on a plugin it inherits from `config.output.barrelType`,
- * and when that is also omitted both default to `'all'`. Set `barrelType: false` to disable
- * barrel generation for a specific plugin or for the root entirely.
+ * Generates `index.ts` barrel files for each plugin's output directory and one root barrel
+ * at `config.output.path/index.ts`.
  *
- * The `barrelType` option controls the re-export style:
- * - `'all'`       — `export * from '...'` for each generated file
- * - `'named'`     — `export { name1, name2 } from '...'` using each file's indexable sources
- * - `'propagate'` — like `'all'` with intermediate barrel files for sub-directories
+ * Plugins inherit `output.barrelType` from `config.output.barrelType` (which itself defaults to `'named'`).
+ * Setting `barrelType: false` on a plugin disables its barrel and excludes the plugin's files from the
+ * root barrel as well.
  *
  * @example
  * ```ts
+ * import { defineConfig } from '@kubb/core'
  * import { middlewareBarrel } from '@kubb/middleware-barrel'
  *
  * export default defineConfig({