@kubb/plugin-barrel 5.8.4 → 5.9.1

package/README.md

@@ -24,7 +24,7 @@
 
 ### Barrel-file plugin for Kubb
 
-Automatically generates `index.ts` re-export files for each plugin output directory.
+Generates `index.ts` re-export files for each plugin output directory, and a root `index.ts` when `output.barrel` is set on `defineConfig`.
 
 ## Installation
 
@@ -38,42 +38,42 @@ npm install @kubb/plugin-barrel
 
 ## Usage
 
-Add `pluginBarrel` to the `plugins` array in your `kubb.config.ts`:
+`defineConfig` adds `pluginBarrel()` to `plugins` for you, so you do not add it yourself. Set `output.barrel` on `defineConfig` to write a root barrel and to give every plugin without its own `output.barrel` the same setting:
 
 ```typescript
 import { defineConfig } from 'kubb'
-import { pluginBarrel } from '@kubb/plugin-barrel'
+import { pluginTs } from '@kubb/plugin-ts'
 
 export default defineConfig({
   input: './openapi.yaml',
   output: {
     path: './src/gen',
+    barrel: { type: 'named' },
   },
-  plugins: [
-    pluginBarrel({
-      type: 'named',
-    }),
-  ],
+  plugins: [pluginTs()],
 })
 ```
 
 ## Options
 
-| Option | Type                              | Default   | Description                                 |
-| ------ | --------------------------------- | --------- | ------------------------------------------- |
-| `type` | `'all' \| 'named' \| 'propagate'` | `'named'` | Export style for the generated barrel files |
+`pluginBarrel()` takes no arguments. You configure it through `output.barrel`, on `defineConfig` or on a single plugin.
+
+| Option                 | Type                                                    | Default                   | Description                                                                                        |
+| ---------------------- | ------------------------------------------------------- | ------------------------- | -------------------------------------------------------------------------------------------------- |
+| `output.barrel`        | `{ type: 'all' \| 'named', nested?: boolean } \| false` | `false` on `defineConfig` | Barrel settings. `false` on a plugin turns its barrel off and leaves its files out of the root one |
+| `output.barrel.type`   | `'all' \| 'named'`                                      | None                      | Export style for the generated barrel files                                                        |
+| `output.barrel.nested` | `boolean`                                               | `false`                   | Plugin only. Each barrel re-exports its own directory and the barrels below it                     |
 
 ### Export types
 
-| Value         | Output                                                                          |
-| ------------- | ------------------------------------------------------------------------------- |
-| `'all'`       | `export * from './...'` — wildcard re-exports                                   |
-| `'named'`     | `export { ... } from './...'` — named re-exports, tree-shaking friendly         |
-| `'propagate'` | `export * from './...'` on index files only, propagating up through directories |
+| Value     | Output                                                                  |
+| --------- | ----------------------------------------------------------------------- |
+| `'all'`   | `export * from './...'` — wildcard re-exports                           |
+| `'named'` | `export { ... } from './...'` — named re-exports, tree-shaking friendly |
 
 ## How it works
 
-After every plugin finishes generating files, `@kubb/plugin-barrel` walks the output tree and creates an `index.ts` in each directory, re-exporting everything inside. It then creates a root `index.ts` at the top of the output path that re-exports from all plugin directories.
+After every plugin finishes generating files, `@kubb/plugin-barrel` walks the output tree and creates an `index.ts` in each directory of every plugin output with a barrel enabled. When `output.barrel` is set on `defineConfig`, it also creates a root `index.ts` at the top of the output path that re-exports the files of every plugin that does not set `output.barrel: false`.
 
 `@kubb/plugin-barrel` uses `enforce: 'post'` so it always runs after all regular plugins complete, giving it access to the full set of generated files.
 

package/dist/index.cjs

@@ -71,7 +71,7 @@ var compatibility = {
 };
 //#endregion
 //#region package.json
-var version = "5.8.4";
+var version = "5.9.1";
 //#endregion
 //#region src/utils.ts
 const SOURCE_EXTENSIONS = /* @__PURE__ */ new Set([
@@ -347,7 +347,8 @@ const pluginBarrel = (0, _kubb_kit.defineExtension)({
 	meta: {
 		name: pluginBarrelName,
 		version,
-		compatibility
+		compatibility,
+		issues: "https://github.com/kubb-labs/kubb/issues"
 	},
 	enforce: "post",
 	hooks: {

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":["resolve","relative","isAbsolute","posix","Diagnostics","ast","extname","defineExtension","path","Diagnostics"],"sources":["../../../internals/utils/src/fs.ts","../kubb-extension.json","../package.json","../src/utils.ts","../src/plugin.ts"],"sourcesContent":["import { access, mkdir, readFile, rm, writeFile } from 'node:fs/promises'\nimport { dirname, isAbsolute, relative, resolve } from 'node:path'\nimport { runtime } from './runtime.ts'\n\n/**\n * Resolves to `true` when the file or directory at `path` exists.\n * Uses `Bun.file().exists()` when running under Bun, `fs.access` otherwise.\n *\n * @example\n * ```ts\n * if (await exists('./kubb.config.ts')) {\n *   const content = await read('./kubb.config.ts')\n * }\n * ```\n */\nexport async function exists(path: string): Promise<boolean> {\n  if (runtime.isBun) {\n    return Bun.file(path).exists()\n  }\n  return access(path).then(\n    () => true,\n    () => false,\n  )\n}\n\n/**\n * Reads the file at `path` as a UTF-8 string.\n * Uses `Bun.file().text()` when running under Bun, `fs.readFile` otherwise.\n *\n * @example\n * ```ts\n * const source = await read('./src/Pet.ts')\n * ```\n */\nexport async function read(path: string): Promise<string> {\n  if (runtime.isBun) {\n    return Bun.file(path).text()\n  }\n  return readFile(path, { encoding: 'utf8' })\n}\n\ntype WriteOptions = {\n  /**\n   * Previously read content, or `null` when the file does not exist.\n   * Omitting this value reads the file before writing.\n   */\n  stored?: string | null\n  /**\n   * When `true`, re-reads the file immediately after writing and throws if the\n   * content does not match — useful for catching write failures on unreliable file systems.\n   */\n  sanity?: boolean\n}\n\n/**\n * Whether `stored` already holds `source`, comparing on the trimmed text rather than the exact\n * bytes. Surrounding whitespace is what a formatter adds and what editors strip, and neither is a\n * reason to rewrite the file.\n *\n * Both sides are trimmed, so a storage that keeps bytes verbatim settles on the same answer as one\n * that normalizes what it stores. Trimming only `stored` would leave a source with leading\n * whitespace rewritten on every build, since the stored copy keeps the whitespace the comparison\n * has already dropped.\n */\nexport function matchesStored({ stored, source }: { stored: string; source: string }): boolean {\n  return stored.trim() === source.trim()\n}\n\n/**\n * Writes `data` to `path`, trimming surrounding whitespace and ending the file with a single newline\n * the way prettier, biome, and oxfmt all do.\n * Skips the write when the trimmed content is empty, or when the file already holds that content.\n * Creates any missing parent directories automatically.\n * When `sanity` is `true`, re-reads the file after writing and throws if the content does not match.\n *\n * @example\n * ```ts\n * await write('./src/Pet.ts', source)         // writes and returns the trimmed content plus a newline\n * await write('./src/Pet.ts', source)         // null — file unchanged\n * await write('./src/Pet.ts', '  ')           // null — empty content skipped\n * ```\n */\nexport async function write(path: string, data: string, options: WriteOptions = {}): Promise<string | null> {\n  const trimmed = data.trim()\n  if (trimmed === '') return null\n\n  const content = `${trimmed}\\n`\n  const resolved = resolve(path)\n  let stored = options.stored\n\n  if (stored === undefined) {\n    if (runtime.isBun) {\n      const file = Bun.file(resolved)\n      stored = (await file.exists()) ? await file.text() : null\n    } else {\n      try {\n        stored = await readFile(resolved, { encoding: 'utf-8' })\n      } catch {\n        /* file doesn't exist yet */\n        stored = null\n      }\n    }\n  }\n  if (matchesStored({ stored: stored ?? '', source: trimmed })) return null\n\n  if (runtime.isBun) {\n    await Bun.write(resolved, content)\n    return content\n  }\n\n  // Creating the directory up front costs a syscall per file, and every file after the first in a\n  // directory pays it for nothing. Write first and only fall back when the directory is missing,\n  // which also stays correct when something removed it mid-run.\n  try {\n    await writeFile(resolved, content, { encoding: 'utf-8' })\n  } catch (error) {\n    if ((error as NodeJS.ErrnoException).code !== 'ENOENT') throw error\n\n    await mkdir(dirname(resolved), { recursive: true })\n    await writeFile(resolved, content, { encoding: 'utf-8' })\n  }\n\n  if (options.sanity) {\n    const savedData = await readFile(resolved, { encoding: 'utf-8' })\n    if (savedData !== content) {\n      throw new Error(`Sanity check failed for ${path}\\n\\nData[${data.length}]:\\n${data}\\n\\nSaved[${savedData.length}]:\\n${savedData}\\n`)\n    }\n    return savedData\n  }\n\n  return content\n}\n\n/**\n * Recursively removes `path`. Silently succeeds when `path` does not exist.\n *\n * @example\n * ```ts\n * await clean('./dist')\n * ```\n */\nexport async function clean(path: string): Promise<void> {\n  return rm(path, { recursive: true, force: true })\n}\n\n/**\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\n/**\n * Strips the file extension from a path or file name.\n * Only removes the last `.ext` segment when the dot is not part of a directory name.\n *\n * @example\n * trimExtName('petStore.ts')             // 'petStore'\n * trimExtName('/src/models/pet.ts')      // '/src/models/pet'\n * trimExtName('/project.v2/gen/pet.ts')  // '/project.v2/gen/pet'\n * trimExtName('noExtension')             // 'noExtension'\n */\nexport function trimExtName(text: string): string {\n  const dotIndex = text.lastIndexOf('.')\n  if (dotIndex > 0 && !text.includes('/', dotIndex)) {\n    return text.slice(0, dotIndex)\n  }\n  return text\n}\n\n/**\n * Resolves to `true` when `path` is `parent` itself or nested inside it. Both sides are resolved\n * to absolute paths first, so relative and `..`-containing inputs compare correctly.\n *\n * Guards a destructive or an out-of-tree operation: before wiping an output directory, check that\n * it does not contain the project root, and before loading a path a caller supplied, check that it\n * did not escape the directory it is allowed to read from.\n *\n * @example\n * isPathInside('./src/gen', '.')   // true  — nested inside the root\n * isPathInside('.', '.')           // true  — the same directory counts as inside\n * isPathInside('.', './src/gen')   // false — the root is not inside its own output\n * isPathInside('../other', '.')    // false — escapes the root\n */\nexport function isPathInside(path: string, parent: string): boolean {\n  const resolvedPath = resolve(path)\n  const resolvedParent = resolve(parent)\n  if (resolvedPath === resolvedParent) {\n    return true\n  }\n\n  const rel = relative(resolvedParent, resolvedPath)\n\n  return rel !== '' && !rel.startsWith('..') && !isAbsolute(rel)\n}\n","","","import { extname, posix } from 'node:path'\nimport { ast, Diagnostics } from '@kubb/kit'\nimport { 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\n/**\n * A file (no `children`) or directory in the tree barrels are computed from. `path` is absolute and\n * POSIX-normalized, and a directory's `children` are keyed by entry name in sorted order.\n */\ntype TreeNode = { path: string; children?: undefined } | DirectoryNode\ntype DirectoryNode = { path: string; children: Map<string, TreeNode> }\n\n/**\n * Orders paths split into segments the way a directory listing sorts them: by name at each level.\n */\nfunction compareSegments(a: ReadonlyArray<string>, b: ReadonlyArray<string>): number {\n  const index = a.findIndex((segment, i) => segment !== b[i])\n  if (index === -1) return a.length - b.length\n  if (index >= b.length) return 1\n\n  return a[index]! < b[index]! ? -1 : 1\n}\n\nfunction toRelativeModulePath(fromDir: string, filePath: string): string {\n  return `./${posix.relative(fromDir, filePath)}`\n}\n\ntype WalkContext = {\n  sourceFiles: ReadonlyMap<string, ast.FileNode>\n  reportedCollisions: Set<string>\n  recursive: boolean\n  leafExports: (dirPath: string, leafPath: string) => Array<ast.ExportNode>\n}\n\n/**\n * Builds the `index.ts` for `dirPath`. Keeps the first export of each name and reports later duplicates once per build.\n */\nfunction makeBarrel(dirPath: string, exports: Array<ast.ExportNode>, { sourceFiles, reportedCollisions }: WalkContext): ast.FileNode {\n  const owners = new Map<string, string>()\n  const uniqueExports = exports.flatMap((item) => {\n    const itemPath = posix.join(dirPath, item.path)\n    // A wildcard export carries no names, so collisions are checked against its source file.\n    const names = item.name == null ? (sourceFiles.get(itemPath)?.sources.flatMap((source) => source.name || []) ?? []) : [item.name].flat()\n    const uniqueNames = names.filter((name) => {\n      const first = owners.get(name)\n      if (!first) {\n        owners.set(name, item.path)\n        return true\n      }\n\n      const key = [name, posix.join(dirPath, first), itemPath].join('\\0')\n      if (!reportedCollisions.has(key)) {\n        reportedCollisions.add(key)\n        Diagnostics.report({\n          code: Diagnostics.code.barrelDuplicateExport,\n          severity: 'error',\n          message: `\"${name}\" is exported by both \"${first}\" and \"${item.path}\", so \"${dirPath}${BARREL_SUFFIX}\" cannot re-export both.`,\n          help: 'Rename one of the colliding declarations, or configure the plugin resolver to produce distinct names.',\n        })\n      }\n      return false\n    })\n\n    if (item.name == null) return [item]\n    return uniqueNames.length > 0 ? [ast.factory.createExport({ ...item, name: Array.isArray(item.name) ? uniqueNames : uniqueNames[0] })] : []\n  })\n\n  return ast.factory.createFile({ baseName: 'index.ts', path: `${dirPath}${BARREL_SUFFIX}`, exports: uniqueExports })\n}\n\ntype LeafStrategy = (path: string, sourceFile: ast.FileNode | undefined) => Array<ast.ExportNode>\n\nfunction indexableNames(sources: ReadonlyArray<ast.SourceNode>, isTypeOnly: boolean): Array<string> {\n  const names = sources.flatMap((source) => (source.isIndexable && source.name && Boolean(source.isTypeOnly) === isTypeOnly ? [source.name] : []))\n  return [...new Set(names)].sort()\n}\n\n/**\n * Re-exports the whole module, unless it has sources and none of them is indexable.\n */\nconst allStrategy: LeafStrategy = (path, sourceFile) => {\n  const sources = sourceFile?.sources ?? []\n  return sources.length > 0 && !sources.some((source) => source.isIndexable) ? [] : [ast.factory.createExport({ path })]\n}\n\n/**\n * Re-exports the indexable names, values and types separately, or the whole module when it has no sources.\n */\nconst namedStrategy: LeafStrategy = (path, sourceFile) => {\n  if (!sourceFile?.sources.length) return [ast.factory.createExport({ path })]\n\n  const valueNames = indexableNames(sourceFile.sources, false)\n  const typeNames = indexableNames(sourceFile.sources, true)\n  return [\n    ...(valueNames.length > 0 ? [ast.factory.createExport({ name: valueNames, path })] : []),\n    ...(typeNames.length > 0 ? [ast.factory.createExport({ name: typeNames, path, isTypeOnly: true })] : []),\n  ]\n}\n\ntype FlatWalk = { barrels: Array<ast.FileNode>; leaves: Array<string> }\n\n/**\n * Post-order walk that builds a barrel re-exporting every leaf below the visited directory, for\n * the start node and, with `recursive`, every sub-directory. Also returns the subtree's leaf paths.\n */\nfunction walkFlat(node: DirectoryNode, ctx: WalkContext, isRoot = true): FlatWalk {\n  const results = [...node.children.values()].map((child): FlatWalk => (child.children ? walkFlat(child, ctx, false) : { barrels: [], leaves: [child.path] }))\n  const barrels = results.flatMap((result) => result.barrels)\n  const leaves = results.flatMap((result) => result.leaves)\n  const exports = isRoot || ctx.recursive ? leaves.flatMap((leaf) => ctx.leafExports(node.path, leaf)) : []\n\n  return { barrels: exports.length > 0 ? [...barrels, makeBarrel(node.path, exports, ctx)] : barrels, leaves }\n}\n\n/**\n * Recursive walk that builds one barrel per directory, re-exporting files and sub-barrels.\n * Used when nested: true. Leaf files honor the barrel `strategy`, so `named` emits explicit\n * named exports instead of wildcards. Sub-directory barrels are chained with a wildcard\n * re-export, which forwards the names the child barrel already curated. A sub-directory that\n * produced no barrel is never re-exported.\n */\nfunction walkNested(node: DirectoryNode, ctx: WalkContext): Array<ast.FileNode> {\n  const results = [...node.children.values()].map((child) => {\n    if (!child.children) return { barrels: [], exports: ctx.leafExports(node.path, child.path) }\n\n    // A sub-directory has barrels only when it has its own `index.ts`.\n    const barrels = walkNested(child, ctx)\n    const exports = barrels.length > 0 ? [ast.factory.createExport({ path: toRelativeModulePath(node.path, `${child.path}${BARREL_SUFFIX}`) })] : []\n    return { barrels, exports }\n  })\n  const barrels = results.flatMap((result) => result.barrels)\n  const exports = results.flatMap((result) => result.exports)\n\n  return exports.length > 0 ? [...barrels, makeBarrel(node.path, exports, ctx)] : barrels\n}\n\n/**\n * A directory tree plus the source-file lookup it was built from, scoped to a single output root.\n * Build it once with {@link buildBarrelIndex} and derive every barrel (per-plugin and root) from\n * it via {@link getBarrelFiles}, instead of re-scanning the full file set once per barrel.\n */\ntype BarrelIndex = {\n  tree: DirectoryNode\n  sourceFiles: ReadonlyMap<string, ast.FileNode>\n}\n\n/**\n * Indexes `files` once for the directory rooted at `outputPath`: filters to indexable source\n * files under that path and builds their directory tree. Reuse the result across every barrel\n * derived from the same root rather than re-filtering and re-building per barrel.\n */\nexport function buildBarrelIndex(outputPath: string, files: ReadonlyArray<ast.FileNode>): BarrelIndex {\n  const tree: DirectoryNode = { path: toPosixPath(outputPath), children: new Map() }\n  const sourceFiles = new Map(\n    files.flatMap((file) => {\n      const filePath = toPosixPath(file.path)\n      const isSource = filePath.startsWith(`${tree.path}/`) && !filePath.endsWith(BARREL_SUFFIX) && SOURCE_EXTENSIONS.has(extname(filePath))\n      return isSource ? [[filePath, file] as const] : []\n    }),\n  )\n\n  // Inserting paths in per-segment order keeps every directory's children sorted by name.\n  const entries = [...sourceFiles.keys()]\n    .map((filePath) =>\n      filePath\n        .slice(tree.path.length + 1)\n        .split('/')\n        .filter(Boolean),\n    )\n    .sort(compareSegments)\n  entries.forEach((parts) => {\n    parts.reduce<DirectoryNode>((dir, part, i) => {\n      const path = `${dir.path}/${part}`\n      const child: TreeNode = dir.children.get(part) ?? (i === parts.length - 1 ? { path } : { path, children: new Map() })\n      dir.children.set(part, child)\n      return child.children ? child : dir\n    }, tree)\n  })\n\n  return { tree, sourceFiles }\n}\n\n/**\n * Locates the directory node for `targetPath` within an index tree. Returns `undefined` when no\n * file exists under `targetPath` (nothing to barrel).\n */\nfunction findDirectory(tree: DirectoryNode, targetPath: string): DirectoryNode | undefined {\n  if (targetPath === tree.path) return tree\n  if (!targetPath.startsWith(`${tree.path}/`)) return undefined\n\n  const node = targetPath\n    .slice(tree.path.length + 1)\n    .split('/')\n    .reduce<TreeNode | undefined>((current, part) => current?.children?.get(part), tree)\n  return node?.children ? node : undefined\n}\n\ntype GetBarrelFilesParams = {\n  /**\n   * Index built once via {@link buildBarrelIndex} for the shared output root.\n   */\n  index: BarrelIndex\n  /**\n   * Absolute directory the barrel(s) should be rooted at, a subtree of the index root.\n   * Defaults to the index root.\n   */\n  targetPath?: string\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  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  recursive?: boolean\n  /**\n   * Collision identities reported by related barrel generations in the same build.\n   */\n  reportedCollisions?: Set<string>\n}\n\n/**\n * Returns the barrel `ast.FileNode`s for `targetPath` (or the index root), derived from a shared index.\n * Locating the subtree is a bounded walk down from the root, so deriving many barrels (one per\n * plugin, plus the root) from one index avoids re-scanning the full file set for each.\n *\n * @example\n * ```ts\n * const index = buildBarrelIndex(outputPath, files)\n * getBarrelFiles({ index, targetPath, barrelType }).forEach((file) => upsertFile(file))\n * ```\n */\nexport function getBarrelFiles({\n  index,\n  targetPath,\n  barrelType,\n  nested = false,\n  recursive = false,\n  reportedCollisions = new Set(),\n}: GetBarrelFilesParams): Array<ast.FileNode> {\n  const node = targetPath ? findDirectory(index.tree, toPosixPath(targetPath)) : index.tree\n  if (!node) return []\n\n  const strategy = barrelType === 'named' ? namedStrategy : allStrategy\n  const ctx: WalkContext = {\n    sourceFiles: index.sourceFiles,\n    reportedCollisions,\n    recursive,\n    leafExports: (dirPath, leafPath) => strategy(toRelativeModulePath(dirPath, leafPath), index.sourceFiles.get(leafPath)),\n  }\n\n  return nested ? walkNested(node, ctx) : walkFlat(node, ctx).barrels\n}\n","import path from 'node:path'\nimport { isPathInside } from '@internals/utils'\nimport { defineExtension, Diagnostics } from '@kubb/kit'\nimport type { ast, Config, NormalizedPlugin, Plugin } from '@kubb/kit'\nimport { compatibility } from '../kubb-extension.json'\nimport { version } from '../package.json'\nimport type { BarrelType, PluginBarrelConfig } from './types.ts'\nimport { buildBarrelIndex, getBarrelFiles } 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: ast.FileNode; plugin: NormalizedPlugin; config: Config }): ast.FileNode {\n  const output = plugin.options?.output\n  const resolver = plugin.resolver\n  const hasBanner = output?.banner !== undefined\n  const hasFooter = output?.footer !== undefined\n  if (!resolver || (!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.default.banner(undefined, context) : file.banner,\n    footer: hasFooter ? resolver.default.footer(undefined, context) : file.footer,\n  }\n}\n\n/**\n * Canonical plugin name for `@kubb/plugin-barrel`. Used for driver lookups\n * and to guard the `kubb:plugin:end` handler against reacting to its own lifecycle hook.\n */\nexport const pluginBarrelName = 'plugin-barrel' satisfies Plugin['name']\n\ntype PendingBarrel = {\n  plugin: NormalizedPlugin\n  target: string\n  barrelType: BarrelType\n  nested: boolean\n}\n\ntype BarrelState = {\n  excludedPlugins: Set<string>\n  // Subdirectories of `barrel: false` plugins, for files without a `meta.pluginName` owner.\n  excludedTargets: Array<string>\n  pendingBarrels: Array<PendingBarrel>\n}\n\n// One state per build, keyed by the build's `config`. The object form has no factory closure to hold it.\nconst states = new WeakMap<Config, BarrelState>()\n\nfunction getState(config: Config): BarrelState {\n  const state = states.get(config) ?? { excludedPlugins: new Set(), excludedTargets: [], pendingBarrels: [] }\n  states.set(config, state)\n  return state\n}\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`, but generates\n * nothing until a barrel is configured.\n *\n * Each plugin inherits `output.barrel` from `config.output.barrel` (which\n * defaults to `false`, no barrel). Set `barrel: { type: 'named' | 'all' }` on\n * the root config, a plugin, or both to opt in; a plugin-level `false`\n * overrides an enabled root barrel and also excludes that plugin's files\n * from the root barrel.\n *\n * A plugin with `output.mode: 'file'` gets no per-plugin barrel, since its output\n * is a single file. The root barrel re-exports that file directly.\n *\n * @example\n * ```ts\n * import { defineConfig } from '@kubb/core'\n * import { pluginBarrel } from '@kubb/plugin-barrel'\n * import { pluginTs } from '@kubb/plugin-ts'\n * import { pluginZod } from '@kubb/plugin-zod'\n *\n * export default defineConfig({\n *   input: './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 *     pluginBarrel(),\n *   ],\n * })\n * ```\n */\nexport const pluginBarrel = defineExtension({\n  kind: 'plugin',\n  meta: { name: pluginBarrelName, version, compatibility },\n  enforce: 'post',\n  hooks: {\n    'kubb:plugin:end'({ plugin, config }) {\n      // Skip reactions to the barrel plugin's own lifecycle hook\n      if (plugin.name === pluginBarrelName) return\n\n      const { excludedPlugins, excludedTargets, pendingBarrels } = getState(config)\n\n      // A plugin-level `false` wins over an enabled root barrel.\n      const barrelConfig: PluginBarrelConfig | false = plugin.options.output?.barrel ?? config.output.barrel ?? false\n      const base = path.resolve(config.root, config.output.path)\n      const target = path.resolve(base, plugin.options.output.path ?? '.')\n\n      if (barrelConfig === false) {\n        excludedPlugins.add(plugin.name)\n        // The output root holds every plugin's files, so there only the owner match applies.\n        if (target !== base && isPathInside(target, base)) {\n          excludedTargets.push(target)\n        }\n        return\n      }\n\n      // A plugin at the output root (no own `output.path`) gets no per-plugin barrel, which would\n      // claim every other plugin's directory. The root barrel picks up its files.\n      if (target === base) {\n        return\n      }\n\n      // `mode: 'file'` writes a single file, so there is no directory to barrel. The root barrel\n      // re-exports that file as a direct leaf of `config.output.path`.\n      if (plugin.options.output.mode === 'file') {\n        return\n      }\n\n      if (!isPathInside(target, base)) {\n        throw new Diagnostics.Error({\n          code: Diagnostics.code.pathTraversal,\n          severity: 'error',\n          message: `Output path \"${plugin.options.output.path}\" of plugin \"${plugin.name}\" resolves outside the output directory \"${base}\".`,\n          help: 'Keep the plugin `output.path` within `config.output.path`.',\n          location: { kind: 'config' },\n        })\n      }\n\n      // Only the target directory and barrel strategy are recorded here. The actual file-set\n      // scan and directory-tree build happen once, in `kubb:plugins:end`, and are shared by\n      // every plugin barrel plus the root barrel instead of repeating per plugin.\n      pendingBarrels.push({ plugin, target, barrelType: barrelConfig.type, nested: barrelConfig.nested ?? false })\n    },\n    'kubb:plugins:end'({ files, config, upsertFile }) {\n      const { excludedPlugins, excludedTargets, pendingBarrels } = getState(config)\n      const rootBarrelConfig = config.output.barrel ?? false\n      const outputPath = path.resolve(config.root, config.output.path)\n\n      // A `barrel: false` plugin gets no barrel and stays out of the root, so drop its files\n      // once here. Every barrel below then derives from a single index of what remains.\n      const relevantFiles = files.filter((file) => {\n        const owner = (file.meta as { pluginName?: string } | undefined)?.pluginName\n        if (owner) return !excludedPlugins.has(owner)\n\n        return !excludedTargets.some((target) => isPathInside(file.path, target))\n      })\n      excludedPlugins.clear()\n      excludedTargets.length = 0\n\n      const index = buildBarrelIndex(outputPath, relevantFiles)\n      const reportedCollisions = new Set<string>()\n\n      pendingBarrels.forEach(({ plugin, target, barrelType, nested }) => {\n        getBarrelFiles({ index, targetPath: target, barrelType, nested, recursive: true, reportedCollisions }).forEach((file) => {\n          upsertFile(withBarrelBannerFooter({ file, plugin, config }))\n        })\n      })\n      pendingBarrels.length = 0\n\n      if (rootBarrelConfig === false) return\n\n      getBarrelFiles({ index, barrelType: rootBarrelConfig.type, reportedCollisions }).forEach((file) => {\n        upsertFile(file)\n      })\n    },\n  },\n})\n"],"mappings":"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"}
+{"version":3,"file":"index.cjs","names":["resolve","relative","isAbsolute","posix","Diagnostics","ast","extname","defineExtension","path","Diagnostics"],"sources":["../../../internals/utils/src/fs.ts","../kubb-extension.json","../package.json","../src/utils.ts","../src/plugin.ts"],"sourcesContent":["import { access, mkdir, readFile, rm, writeFile } from 'node:fs/promises'\nimport { dirname, isAbsolute, relative, resolve } from 'node:path'\nimport { runtime } from './runtime.ts'\n\n/**\n * Resolves to `true` when the file or directory at `path` exists.\n * Uses `Bun.file().exists()` when running under Bun, `fs.access` otherwise.\n *\n * @example\n * ```ts\n * if (await exists('./kubb.config.ts')) {\n *   const content = await read('./kubb.config.ts')\n * }\n * ```\n */\nexport async function exists(path: string): Promise<boolean> {\n  if (runtime.isBun) {\n    return Bun.file(path).exists()\n  }\n  return access(path).then(\n    () => true,\n    () => false,\n  )\n}\n\n/**\n * Reads the file at `path` as a UTF-8 string.\n * Uses `Bun.file().text()` when running under Bun, `fs.readFile` otherwise.\n *\n * @example\n * ```ts\n * const source = await read('./src/Pet.ts')\n * ```\n */\nexport async function read(path: string): Promise<string> {\n  if (runtime.isBun) {\n    return Bun.file(path).text()\n  }\n  return readFile(path, { encoding: 'utf8' })\n}\n\ntype WriteOptions = {\n  /**\n   * Previously read content, or `null` when the file does not exist.\n   * Omitting this value reads the file before writing.\n   */\n  stored?: string | null\n  /**\n   * When `true`, re-reads the file immediately after writing and throws if the\n   * content does not match — useful for catching write failures on unreliable file systems.\n   */\n  sanity?: boolean\n}\n\n/**\n * Whether `stored` already holds `source`, comparing on the trimmed text rather than the exact\n * bytes. Surrounding whitespace is what a formatter adds and what editors strip, and neither is a\n * reason to rewrite the file.\n *\n * Both sides are trimmed, so a storage that keeps bytes verbatim settles on the same answer as one\n * that normalizes what it stores. Trimming only `stored` would leave a source with leading\n * whitespace rewritten on every build, since the stored copy keeps the whitespace the comparison\n * has already dropped.\n */\nexport function matchesStored({ stored, source }: { stored: string; source: string }): boolean {\n  return stored.trim() === source.trim()\n}\n\n/**\n * Writes `data` to `path`, trimming surrounding whitespace and ending the file with a single newline\n * the way prettier, biome, and oxfmt all do.\n * Skips the write when the trimmed content is empty, or when the file already holds that content.\n * Creates any missing parent directories automatically.\n * When `sanity` is `true`, re-reads the file after writing and throws if the content does not match.\n *\n * @example\n * ```ts\n * await write('./src/Pet.ts', source)         // writes and returns the trimmed content plus a newline\n * await write('./src/Pet.ts', source)         // null — file unchanged\n * await write('./src/Pet.ts', '  ')           // null — empty content skipped\n * ```\n */\nexport async function write(path: string, data: string, options: WriteOptions = {}): Promise<string | null> {\n  const trimmed = data.trim()\n  if (trimmed === '') return null\n\n  const content = `${trimmed}\\n`\n  const resolved = resolve(path)\n  let stored = options.stored\n\n  if (stored === undefined) {\n    if (runtime.isBun) {\n      const file = Bun.file(resolved)\n      stored = (await file.exists()) ? await file.text() : null\n    } else {\n      try {\n        stored = await readFile(resolved, { encoding: 'utf-8' })\n      } catch {\n        /* file doesn't exist yet */\n        stored = null\n      }\n    }\n  }\n  if (matchesStored({ stored: stored ?? '', source: trimmed })) return null\n\n  if (runtime.isBun) {\n    await Bun.write(resolved, content)\n    return content\n  }\n\n  // Creating the directory up front costs a syscall per file, and every file after the first in a\n  // directory pays it for nothing. Write first and only fall back when the directory is missing,\n  // which also stays correct when something removed it mid-run.\n  try {\n    await writeFile(resolved, content, { encoding: 'utf-8' })\n  } catch (error) {\n    if ((error as NodeJS.ErrnoException).code !== 'ENOENT') throw error\n\n    await mkdir(dirname(resolved), { recursive: true })\n    await writeFile(resolved, content, { encoding: 'utf-8' })\n  }\n\n  if (options.sanity) {\n    const savedData = await readFile(resolved, { encoding: 'utf-8' })\n    if (savedData !== content) {\n      throw new Error(`Sanity check failed for ${path}\\n\\nData[${data.length}]:\\n${data}\\n\\nSaved[${savedData.length}]:\\n${savedData}\\n`)\n    }\n    return savedData\n  }\n\n  return content\n}\n\n/**\n * Recursively removes `path`. Silently succeeds when `path` does not exist.\n *\n * @example\n * ```ts\n * await clean('./dist')\n * ```\n */\nexport async function clean(path: string): Promise<void> {\n  return rm(path, { recursive: true, force: true })\n}\n\n/**\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\n/**\n * Strips the file extension from a path or file name.\n * Only removes the last `.ext` segment when the dot is not part of a directory name.\n *\n * @example\n * trimExtName('petStore.ts')             // 'petStore'\n * trimExtName('/src/models/pet.ts')      // '/src/models/pet'\n * trimExtName('/project.v2/gen/pet.ts')  // '/project.v2/gen/pet'\n * trimExtName('noExtension')             // 'noExtension'\n */\nexport function trimExtName(text: string): string {\n  const dotIndex = text.lastIndexOf('.')\n  if (dotIndex > 0 && !text.includes('/', dotIndex)) {\n    return text.slice(0, dotIndex)\n  }\n  return text\n}\n\n/**\n * Resolves to `true` when `path` is `parent` itself or nested inside it. Both sides are resolved\n * to absolute paths first, so relative and `..`-containing inputs compare correctly.\n *\n * Guards a destructive or an out-of-tree operation: before wiping an output directory, check that\n * it does not contain the project root, and before loading a path a caller supplied, check that it\n * did not escape the directory it is allowed to read from.\n *\n * @example\n * isPathInside('./src/gen', '.')   // true  — nested inside the root\n * isPathInside('.', '.')           // true  — the same directory counts as inside\n * isPathInside('.', './src/gen')   // false — the root is not inside its own output\n * isPathInside('../other', '.')    // false — escapes the root\n */\nexport function isPathInside(path: string, parent: string): boolean {\n  const resolvedPath = resolve(path)\n  const resolvedParent = resolve(parent)\n  if (resolvedPath === resolvedParent) {\n    return true\n  }\n\n  const rel = relative(resolvedParent, resolvedPath)\n\n  return rel !== '' && !rel.startsWith('..') && !isAbsolute(rel)\n}\n","","","import { extname, posix } from 'node:path'\nimport { ast, Diagnostics } from '@kubb/kit'\nimport { 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\n/**\n * A file (no `children`) or directory in the tree barrels are computed from. `path` is absolute and\n * POSIX-normalized, and a directory's `children` are keyed by entry name in sorted order.\n */\ntype TreeNode = { path: string; children?: undefined } | DirectoryNode\ntype DirectoryNode = { path: string; children: Map<string, TreeNode> }\n\n/**\n * Orders paths split into segments the way a directory listing sorts them: by name at each level.\n */\nfunction compareSegments(a: ReadonlyArray<string>, b: ReadonlyArray<string>): number {\n  const index = a.findIndex((segment, i) => segment !== b[i])\n  if (index === -1) return a.length - b.length\n  if (index >= b.length) return 1\n\n  return a[index]! < b[index]! ? -1 : 1\n}\n\nfunction toRelativeModulePath(fromDir: string, filePath: string): string {\n  return `./${posix.relative(fromDir, filePath)}`\n}\n\ntype WalkContext = {\n  sourceFiles: ReadonlyMap<string, ast.FileNode>\n  reportedCollisions: Set<string>\n  recursive: boolean\n  leafExports: (dirPath: string, leafPath: string) => Array<ast.ExportNode>\n}\n\n/**\n * Builds the `index.ts` for `dirPath`. Keeps the first export of each name and reports later duplicates once per build.\n */\nfunction makeBarrel(dirPath: string, exports: Array<ast.ExportNode>, { sourceFiles, reportedCollisions }: WalkContext): ast.FileNode {\n  const owners = new Map<string, string>()\n  const uniqueExports = exports.flatMap((item) => {\n    const itemPath = posix.join(dirPath, item.path)\n    // A wildcard export carries no names, so collisions are checked against its source file.\n    const names = item.name == null ? (sourceFiles.get(itemPath)?.sources.flatMap((source) => source.name || []) ?? []) : [item.name].flat()\n    const uniqueNames = names.filter((name) => {\n      const first = owners.get(name)\n      if (!first) {\n        owners.set(name, item.path)\n        return true\n      }\n\n      const key = [name, posix.join(dirPath, first), itemPath].join('\\0')\n      if (!reportedCollisions.has(key)) {\n        reportedCollisions.add(key)\n        Diagnostics.report({\n          code: Diagnostics.code.barrelDuplicateExport,\n          severity: 'error',\n          message: `\"${name}\" is exported by both \"${first}\" and \"${item.path}\", so \"${dirPath}${BARREL_SUFFIX}\" cannot re-export both.`,\n          help: 'Rename one of the colliding declarations, or configure the plugin resolver to produce distinct names.',\n        })\n      }\n      return false\n    })\n\n    if (item.name == null) return [item]\n    return uniqueNames.length > 0 ? [ast.factory.createExport({ ...item, name: Array.isArray(item.name) ? uniqueNames : uniqueNames[0] })] : []\n  })\n\n  return ast.factory.createFile({ baseName: 'index.ts', path: `${dirPath}${BARREL_SUFFIX}`, exports: uniqueExports })\n}\n\ntype LeafStrategy = (path: string, sourceFile: ast.FileNode | undefined) => Array<ast.ExportNode>\n\nfunction indexableNames(sources: ReadonlyArray<ast.SourceNode>, isTypeOnly: boolean): Array<string> {\n  const names = sources.flatMap((source) => (source.isIndexable && source.name && Boolean(source.isTypeOnly) === isTypeOnly ? [source.name] : []))\n  return [...new Set(names)].sort()\n}\n\n/**\n * Re-exports the whole module, unless it has sources and none of them is indexable.\n */\nconst allStrategy: LeafStrategy = (path, sourceFile) => {\n  const sources = sourceFile?.sources ?? []\n  return sources.length > 0 && !sources.some((source) => source.isIndexable) ? [] : [ast.factory.createExport({ path })]\n}\n\n/**\n * Re-exports the indexable names, values and types separately, or the whole module when it has no sources.\n */\nconst namedStrategy: LeafStrategy = (path, sourceFile) => {\n  if (!sourceFile?.sources.length) return [ast.factory.createExport({ path })]\n\n  const valueNames = indexableNames(sourceFile.sources, false)\n  const typeNames = indexableNames(sourceFile.sources, true)\n  return [\n    ...(valueNames.length > 0 ? [ast.factory.createExport({ name: valueNames, path })] : []),\n    ...(typeNames.length > 0 ? [ast.factory.createExport({ name: typeNames, path, isTypeOnly: true })] : []),\n  ]\n}\n\ntype FlatWalk = { barrels: Array<ast.FileNode>; leaves: Array<string> }\n\n/**\n * Post-order walk that builds a barrel re-exporting every leaf below the visited directory, for\n * the start node and, with `recursive`, every sub-directory. Also returns the subtree's leaf paths.\n */\nfunction walkFlat(node: DirectoryNode, ctx: WalkContext, isRoot = true): FlatWalk {\n  const results = [...node.children.values()].map((child): FlatWalk => (child.children ? walkFlat(child, ctx, false) : { barrels: [], leaves: [child.path] }))\n  const barrels = results.flatMap((result) => result.barrels)\n  const leaves = results.flatMap((result) => result.leaves)\n  const exports = isRoot || ctx.recursive ? leaves.flatMap((leaf) => ctx.leafExports(node.path, leaf)) : []\n\n  return { barrels: exports.length > 0 ? [...barrels, makeBarrel(node.path, exports, ctx)] : barrels, leaves }\n}\n\n/**\n * Recursive walk that builds one barrel per directory, re-exporting files and sub-barrels.\n * Used when nested: true. Leaf files honor the barrel `strategy`, so `named` emits explicit\n * named exports instead of wildcards. Sub-directory barrels are chained with a wildcard\n * re-export, which forwards the names the child barrel already curated. A sub-directory that\n * produced no barrel is never re-exported.\n */\nfunction walkNested(node: DirectoryNode, ctx: WalkContext): Array<ast.FileNode> {\n  const results = [...node.children.values()].map((child) => {\n    if (!child.children) return { barrels: [], exports: ctx.leafExports(node.path, child.path) }\n\n    // A sub-directory has barrels only when it has its own `index.ts`.\n    const barrels = walkNested(child, ctx)\n    const exports = barrels.length > 0 ? [ast.factory.createExport({ path: toRelativeModulePath(node.path, `${child.path}${BARREL_SUFFIX}`) })] : []\n    return { barrels, exports }\n  })\n  const barrels = results.flatMap((result) => result.barrels)\n  const exports = results.flatMap((result) => result.exports)\n\n  return exports.length > 0 ? [...barrels, makeBarrel(node.path, exports, ctx)] : barrels\n}\n\n/**\n * A directory tree plus the source-file lookup it was built from, scoped to a single output root.\n * Build it once with {@link buildBarrelIndex} and derive every barrel (per-plugin and root) from\n * it via {@link getBarrelFiles}, instead of re-scanning the full file set once per barrel.\n */\ntype BarrelIndex = {\n  tree: DirectoryNode\n  sourceFiles: ReadonlyMap<string, ast.FileNode>\n}\n\n/**\n * Indexes `files` once for the directory rooted at `outputPath`: filters to indexable source\n * files under that path and builds their directory tree. Reuse the result across every barrel\n * derived from the same root rather than re-filtering and re-building per barrel.\n */\nexport function buildBarrelIndex(outputPath: string, files: ReadonlyArray<ast.FileNode>): BarrelIndex {\n  const tree: DirectoryNode = { path: toPosixPath(outputPath), children: new Map() }\n  const sourceFiles = new Map(\n    files.flatMap((file) => {\n      const filePath = toPosixPath(file.path)\n      const isSource = filePath.startsWith(`${tree.path}/`) && !filePath.endsWith(BARREL_SUFFIX) && SOURCE_EXTENSIONS.has(extname(filePath))\n      return isSource ? [[filePath, file] as const] : []\n    }),\n  )\n\n  // Inserting paths in per-segment order keeps every directory's children sorted by name.\n  const entries = [...sourceFiles.keys()]\n    .map((filePath) =>\n      filePath\n        .slice(tree.path.length + 1)\n        .split('/')\n        .filter(Boolean),\n    )\n    .sort(compareSegments)\n  entries.forEach((parts) => {\n    parts.reduce<DirectoryNode>((dir, part, i) => {\n      const path = `${dir.path}/${part}`\n      const child: TreeNode = dir.children.get(part) ?? (i === parts.length - 1 ? { path } : { path, children: new Map() })\n      dir.children.set(part, child)\n      return child.children ? child : dir\n    }, tree)\n  })\n\n  return { tree, sourceFiles }\n}\n\n/**\n * Locates the directory node for `targetPath` within an index tree. Returns `undefined` when no\n * file exists under `targetPath` (nothing to barrel).\n */\nfunction findDirectory(tree: DirectoryNode, targetPath: string): DirectoryNode | undefined {\n  if (targetPath === tree.path) return tree\n  if (!targetPath.startsWith(`${tree.path}/`)) return undefined\n\n  const node = targetPath\n    .slice(tree.path.length + 1)\n    .split('/')\n    .reduce<TreeNode | undefined>((current, part) => current?.children?.get(part), tree)\n  return node?.children ? node : undefined\n}\n\ntype GetBarrelFilesParams = {\n  /**\n   * Index built once via {@link buildBarrelIndex} for the shared output root.\n   */\n  index: BarrelIndex\n  /**\n   * Absolute directory the barrel(s) should be rooted at, a subtree of the index root.\n   * Defaults to the index root.\n   */\n  targetPath?: string\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  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  recursive?: boolean\n  /**\n   * Collision identities reported by related barrel generations in the same build.\n   */\n  reportedCollisions?: Set<string>\n}\n\n/**\n * Returns the barrel `ast.FileNode`s for `targetPath` (or the index root), derived from a shared index.\n * Locating the subtree is a bounded walk down from the root, so deriving many barrels (one per\n * plugin, plus the root) from one index avoids re-scanning the full file set for each.\n *\n * @example\n * ```ts\n * const index = buildBarrelIndex(outputPath, files)\n * getBarrelFiles({ index, targetPath, barrelType }).forEach((file) => upsertFile(file))\n * ```\n */\nexport function getBarrelFiles({\n  index,\n  targetPath,\n  barrelType,\n  nested = false,\n  recursive = false,\n  reportedCollisions = new Set(),\n}: GetBarrelFilesParams): Array<ast.FileNode> {\n  const node = targetPath ? findDirectory(index.tree, toPosixPath(targetPath)) : index.tree\n  if (!node) return []\n\n  const strategy = barrelType === 'named' ? namedStrategy : allStrategy\n  const ctx: WalkContext = {\n    sourceFiles: index.sourceFiles,\n    reportedCollisions,\n    recursive,\n    leafExports: (dirPath, leafPath) => strategy(toRelativeModulePath(dirPath, leafPath), index.sourceFiles.get(leafPath)),\n  }\n\n  return nested ? walkNested(node, ctx) : walkFlat(node, ctx).barrels\n}\n","import path from 'node:path'\nimport { isPathInside } from '@internals/utils'\nimport { defineExtension, Diagnostics } from '@kubb/kit'\nimport type { ast, Config, NormalizedPlugin, Plugin } from '@kubb/kit'\nimport { compatibility } from '../kubb-extension.json'\nimport { version } from '../package.json'\nimport type { BarrelType, PluginBarrelConfig } from './types.ts'\nimport { buildBarrelIndex, getBarrelFiles } 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: ast.FileNode; plugin: NormalizedPlugin; config: Config }): ast.FileNode {\n  const output = plugin.options?.output\n  const resolver = plugin.resolver\n  const hasBanner = output?.banner !== undefined\n  const hasFooter = output?.footer !== undefined\n  if (!resolver || (!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.default.banner(undefined, context) : file.banner,\n    footer: hasFooter ? resolver.default.footer(undefined, context) : file.footer,\n  }\n}\n\n/**\n * Canonical plugin name for `@kubb/plugin-barrel`. Used for driver lookups\n * and to guard the `kubb:plugin:end` handler against reacting to its own lifecycle hook.\n */\nexport const pluginBarrelName = 'plugin-barrel' satisfies Plugin['name']\n\ntype PendingBarrel = {\n  plugin: NormalizedPlugin\n  target: string\n  barrelType: BarrelType\n  nested: boolean\n}\n\ntype BarrelState = {\n  excludedPlugins: Set<string>\n  // Subdirectories of `barrel: false` plugins, for files without a `meta.pluginName` owner.\n  excludedTargets: Array<string>\n  pendingBarrels: Array<PendingBarrel>\n}\n\n// One state per build, keyed by the build's `config`. The object form has no factory closure to hold it.\nconst states = new WeakMap<Config, BarrelState>()\n\nfunction getState(config: Config): BarrelState {\n  const state = states.get(config) ?? { excludedPlugins: new Set(), excludedTargets: [], pendingBarrels: [] }\n  states.set(config, state)\n  return state\n}\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`, but generates\n * nothing until a barrel is configured.\n *\n * Each plugin inherits `output.barrel` from `config.output.barrel` (which\n * defaults to `false`, no barrel). Set `barrel: { type: 'named' | 'all' }` on\n * the root config, a plugin, or both to opt in; a plugin-level `false`\n * overrides an enabled root barrel and also excludes that plugin's files\n * from the root barrel.\n *\n * A plugin with `output.mode: 'file'` gets no per-plugin barrel, since its output\n * is a single file. The root barrel re-exports that file directly.\n *\n * @example\n * ```ts\n * import { defineConfig } from '@kubb/core'\n * import { pluginBarrel } from '@kubb/plugin-barrel'\n * import { pluginTs } from '@kubb/plugin-ts'\n * import { pluginZod } from '@kubb/plugin-zod'\n *\n * export default defineConfig({\n *   input: './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 *     pluginBarrel(),\n *   ],\n * })\n * ```\n */\nexport const pluginBarrel = defineExtension({\n  kind: 'plugin',\n  meta: { name: pluginBarrelName, version, compatibility, issues: 'https://github.com/kubb-labs/kubb/issues' },\n  enforce: 'post',\n  hooks: {\n    'kubb:plugin:end'({ plugin, config }) {\n      // Skip reactions to the barrel plugin's own lifecycle hook\n      if (plugin.name === pluginBarrelName) return\n\n      const { excludedPlugins, excludedTargets, pendingBarrels } = getState(config)\n\n      // A plugin-level `false` wins over an enabled root barrel.\n      const barrelConfig: PluginBarrelConfig | false = plugin.options.output?.barrel ?? config.output.barrel ?? false\n      const base = path.resolve(config.root, config.output.path)\n      const target = path.resolve(base, plugin.options.output.path ?? '.')\n\n      if (barrelConfig === false) {\n        excludedPlugins.add(plugin.name)\n        // The output root holds every plugin's files, so there only the owner match applies.\n        if (target !== base && isPathInside(target, base)) {\n          excludedTargets.push(target)\n        }\n        return\n      }\n\n      // A plugin at the output root (no own `output.path`) gets no per-plugin barrel, which would\n      // claim every other plugin's directory. The root barrel picks up its files.\n      if (target === base) {\n        return\n      }\n\n      // `mode: 'file'` writes a single file, so there is no directory to barrel. The root barrel\n      // re-exports that file as a direct leaf of `config.output.path`.\n      if (plugin.options.output.mode === 'file') {\n        return\n      }\n\n      if (!isPathInside(target, base)) {\n        throw new Diagnostics.Error({\n          code: Diagnostics.code.pathTraversal,\n          severity: 'error',\n          message: `Output path \"${plugin.options.output.path}\" of plugin \"${plugin.name}\" resolves outside the output directory \"${base}\".`,\n          help: 'Keep the plugin `output.path` within `config.output.path`.',\n          location: { kind: 'config' },\n        })\n      }\n\n      // Only the target directory and barrel strategy are recorded here. The actual file-set\n      // scan and directory-tree build happen once, in `kubb:plugins:end`, and are shared by\n      // every plugin barrel plus the root barrel instead of repeating per plugin.\n      pendingBarrels.push({ plugin, target, barrelType: barrelConfig.type, nested: barrelConfig.nested ?? false })\n    },\n    'kubb:plugins:end'({ files, config, upsertFile }) {\n      const { excludedPlugins, excludedTargets, pendingBarrels } = getState(config)\n      const rootBarrelConfig = config.output.barrel ?? false\n      const outputPath = path.resolve(config.root, config.output.path)\n\n      // A `barrel: false` plugin gets no barrel and stays out of the root, so drop its files\n      // once here. Every barrel below then derives from a single index of what remains.\n      const relevantFiles = files.filter((file) => {\n        const owner = (file.meta as { pluginName?: string } | undefined)?.pluginName\n        if (owner) return !excludedPlugins.has(owner)\n\n        return !excludedTargets.some((target) => isPathInside(file.path, target))\n      })\n      excludedPlugins.clear()\n      excludedTargets.length = 0\n\n      const index = buildBarrelIndex(outputPath, relevantFiles)\n      const reportedCollisions = new Set<string>()\n\n      pendingBarrels.forEach(({ plugin, target, barrelType, nested }) => {\n        getBarrelFiles({ index, targetPath: target, barrelType, nested, recursive: true, reportedCollisions }).forEach((file) => {\n          upsertFile(withBarrelBannerFooter({ file, plugin, config }))\n        })\n      })\n      pendingBarrels.length = 0\n\n      if (rootBarrelConfig === false) return\n\n      getBarrelFiles({ index, barrelType: rootBarrelConfig.type, reportedCollisions }).forEach((file) => {\n        upsertFile(file)\n      })\n    },\n  },\n})\n"],"mappings":"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"}

package/dist/index.d.ts

@@ -38,7 +38,7 @@ export declare const pluginBarrelName = "plugin-barrel";
  * })
  * ```
  */
-export declare const pluginBarrel: import("@kubb/core").PluginFactory<import("@kubb/core").PluginFactoryOptions<string, object, object, import("@kubb/core").Resolver>>;
+export declare const pluginBarrel: import("@kubb/core").PluginFactory<import("@kubb/core").PluginType<string, object, object, import("@kubb/core").Resolver>>;
 //#endregion
 //#region src/types.d.ts
 /**

package/dist/index.js

@@ -48,7 +48,7 @@ var compatibility = {
 };
 //#endregion
 //#region package.json
-var version = "5.8.4";
+var version = "5.9.1";
 //#endregion
 //#region src/utils.ts
 const SOURCE_EXTENSIONS = /* @__PURE__ */ new Set([
@@ -324,7 +324,8 @@ const pluginBarrel = defineExtension({
 	meta: {
 		name: pluginBarrelName,
 		version,
-		compatibility
+		compatibility,
+		issues: "https://github.com/kubb-labs/kubb/issues"
 	},
 	enforce: "post",
 	hooks: {

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../../internals/utils/src/fs.ts","../kubb-extension.json","../package.json","../src/utils.ts","../src/plugin.ts"],"sourcesContent":["import { access, mkdir, readFile, rm, writeFile } from 'node:fs/promises'\nimport { dirname, isAbsolute, relative, resolve } from 'node:path'\nimport { runtime } from './runtime.ts'\n\n/**\n * Resolves to `true` when the file or directory at `path` exists.\n * Uses `Bun.file().exists()` when running under Bun, `fs.access` otherwise.\n *\n * @example\n * ```ts\n * if (await exists('./kubb.config.ts')) {\n *   const content = await read('./kubb.config.ts')\n * }\n * ```\n */\nexport async function exists(path: string): Promise<boolean> {\n  if (runtime.isBun) {\n    return Bun.file(path).exists()\n  }\n  return access(path).then(\n    () => true,\n    () => false,\n  )\n}\n\n/**\n * Reads the file at `path` as a UTF-8 string.\n * Uses `Bun.file().text()` when running under Bun, `fs.readFile` otherwise.\n *\n * @example\n * ```ts\n * const source = await read('./src/Pet.ts')\n * ```\n */\nexport async function read(path: string): Promise<string> {\n  if (runtime.isBun) {\n    return Bun.file(path).text()\n  }\n  return readFile(path, { encoding: 'utf8' })\n}\n\ntype WriteOptions = {\n  /**\n   * Previously read content, or `null` when the file does not exist.\n   * Omitting this value reads the file before writing.\n   */\n  stored?: string | null\n  /**\n   * When `true`, re-reads the file immediately after writing and throws if the\n   * content does not match — useful for catching write failures on unreliable file systems.\n   */\n  sanity?: boolean\n}\n\n/**\n * Whether `stored` already holds `source`, comparing on the trimmed text rather than the exact\n * bytes. Surrounding whitespace is what a formatter adds and what editors strip, and neither is a\n * reason to rewrite the file.\n *\n * Both sides are trimmed, so a storage that keeps bytes verbatim settles on the same answer as one\n * that normalizes what it stores. Trimming only `stored` would leave a source with leading\n * whitespace rewritten on every build, since the stored copy keeps the whitespace the comparison\n * has already dropped.\n */\nexport function matchesStored({ stored, source }: { stored: string; source: string }): boolean {\n  return stored.trim() === source.trim()\n}\n\n/**\n * Writes `data` to `path`, trimming surrounding whitespace and ending the file with a single newline\n * the way prettier, biome, and oxfmt all do.\n * Skips the write when the trimmed content is empty, or when the file already holds that content.\n * Creates any missing parent directories automatically.\n * When `sanity` is `true`, re-reads the file after writing and throws if the content does not match.\n *\n * @example\n * ```ts\n * await write('./src/Pet.ts', source)         // writes and returns the trimmed content plus a newline\n * await write('./src/Pet.ts', source)         // null — file unchanged\n * await write('./src/Pet.ts', '  ')           // null — empty content skipped\n * ```\n */\nexport async function write(path: string, data: string, options: WriteOptions = {}): Promise<string | null> {\n  const trimmed = data.trim()\n  if (trimmed === '') return null\n\n  const content = `${trimmed}\\n`\n  const resolved = resolve(path)\n  let stored = options.stored\n\n  if (stored === undefined) {\n    if (runtime.isBun) {\n      const file = Bun.file(resolved)\n      stored = (await file.exists()) ? await file.text() : null\n    } else {\n      try {\n        stored = await readFile(resolved, { encoding: 'utf-8' })\n      } catch {\n        /* file doesn't exist yet */\n        stored = null\n      }\n    }\n  }\n  if (matchesStored({ stored: stored ?? '', source: trimmed })) return null\n\n  if (runtime.isBun) {\n    await Bun.write(resolved, content)\n    return content\n  }\n\n  // Creating the directory up front costs a syscall per file, and every file after the first in a\n  // directory pays it for nothing. Write first and only fall back when the directory is missing,\n  // which also stays correct when something removed it mid-run.\n  try {\n    await writeFile(resolved, content, { encoding: 'utf-8' })\n  } catch (error) {\n    if ((error as NodeJS.ErrnoException).code !== 'ENOENT') throw error\n\n    await mkdir(dirname(resolved), { recursive: true })\n    await writeFile(resolved, content, { encoding: 'utf-8' })\n  }\n\n  if (options.sanity) {\n    const savedData = await readFile(resolved, { encoding: 'utf-8' })\n    if (savedData !== content) {\n      throw new Error(`Sanity check failed for ${path}\\n\\nData[${data.length}]:\\n${data}\\n\\nSaved[${savedData.length}]:\\n${savedData}\\n`)\n    }\n    return savedData\n  }\n\n  return content\n}\n\n/**\n * Recursively removes `path`. Silently succeeds when `path` does not exist.\n *\n * @example\n * ```ts\n * await clean('./dist')\n * ```\n */\nexport async function clean(path: string): Promise<void> {\n  return rm(path, { recursive: true, force: true })\n}\n\n/**\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\n/**\n * Strips the file extension from a path or file name.\n * Only removes the last `.ext` segment when the dot is not part of a directory name.\n *\n * @example\n * trimExtName('petStore.ts')             // 'petStore'\n * trimExtName('/src/models/pet.ts')      // '/src/models/pet'\n * trimExtName('/project.v2/gen/pet.ts')  // '/project.v2/gen/pet'\n * trimExtName('noExtension')             // 'noExtension'\n */\nexport function trimExtName(text: string): string {\n  const dotIndex = text.lastIndexOf('.')\n  if (dotIndex > 0 && !text.includes('/', dotIndex)) {\n    return text.slice(0, dotIndex)\n  }\n  return text\n}\n\n/**\n * Resolves to `true` when `path` is `parent` itself or nested inside it. Both sides are resolved\n * to absolute paths first, so relative and `..`-containing inputs compare correctly.\n *\n * Guards a destructive or an out-of-tree operation: before wiping an output directory, check that\n * it does not contain the project root, and before loading a path a caller supplied, check that it\n * did not escape the directory it is allowed to read from.\n *\n * @example\n * isPathInside('./src/gen', '.')   // true  — nested inside the root\n * isPathInside('.', '.')           // true  — the same directory counts as inside\n * isPathInside('.', './src/gen')   // false — the root is not inside its own output\n * isPathInside('../other', '.')    // false — escapes the root\n */\nexport function isPathInside(path: string, parent: string): boolean {\n  const resolvedPath = resolve(path)\n  const resolvedParent = resolve(parent)\n  if (resolvedPath === resolvedParent) {\n    return true\n  }\n\n  const rel = relative(resolvedParent, resolvedPath)\n\n  return rel !== '' && !rel.startsWith('..') && !isAbsolute(rel)\n}\n","","","import { extname, posix } from 'node:path'\nimport { ast, Diagnostics } from '@kubb/kit'\nimport { 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\n/**\n * A file (no `children`) or directory in the tree barrels are computed from. `path` is absolute and\n * POSIX-normalized, and a directory's `children` are keyed by entry name in sorted order.\n */\ntype TreeNode = { path: string; children?: undefined } | DirectoryNode\ntype DirectoryNode = { path: string; children: Map<string, TreeNode> }\n\n/**\n * Orders paths split into segments the way a directory listing sorts them: by name at each level.\n */\nfunction compareSegments(a: ReadonlyArray<string>, b: ReadonlyArray<string>): number {\n  const index = a.findIndex((segment, i) => segment !== b[i])\n  if (index === -1) return a.length - b.length\n  if (index >= b.length) return 1\n\n  return a[index]! < b[index]! ? -1 : 1\n}\n\nfunction toRelativeModulePath(fromDir: string, filePath: string): string {\n  return `./${posix.relative(fromDir, filePath)}`\n}\n\ntype WalkContext = {\n  sourceFiles: ReadonlyMap<string, ast.FileNode>\n  reportedCollisions: Set<string>\n  recursive: boolean\n  leafExports: (dirPath: string, leafPath: string) => Array<ast.ExportNode>\n}\n\n/**\n * Builds the `index.ts` for `dirPath`. Keeps the first export of each name and reports later duplicates once per build.\n */\nfunction makeBarrel(dirPath: string, exports: Array<ast.ExportNode>, { sourceFiles, reportedCollisions }: WalkContext): ast.FileNode {\n  const owners = new Map<string, string>()\n  const uniqueExports = exports.flatMap((item) => {\n    const itemPath = posix.join(dirPath, item.path)\n    // A wildcard export carries no names, so collisions are checked against its source file.\n    const names = item.name == null ? (sourceFiles.get(itemPath)?.sources.flatMap((source) => source.name || []) ?? []) : [item.name].flat()\n    const uniqueNames = names.filter((name) => {\n      const first = owners.get(name)\n      if (!first) {\n        owners.set(name, item.path)\n        return true\n      }\n\n      const key = [name, posix.join(dirPath, first), itemPath].join('\\0')\n      if (!reportedCollisions.has(key)) {\n        reportedCollisions.add(key)\n        Diagnostics.report({\n          code: Diagnostics.code.barrelDuplicateExport,\n          severity: 'error',\n          message: `\"${name}\" is exported by both \"${first}\" and \"${item.path}\", so \"${dirPath}${BARREL_SUFFIX}\" cannot re-export both.`,\n          help: 'Rename one of the colliding declarations, or configure the plugin resolver to produce distinct names.',\n        })\n      }\n      return false\n    })\n\n    if (item.name == null) return [item]\n    return uniqueNames.length > 0 ? [ast.factory.createExport({ ...item, name: Array.isArray(item.name) ? uniqueNames : uniqueNames[0] })] : []\n  })\n\n  return ast.factory.createFile({ baseName: 'index.ts', path: `${dirPath}${BARREL_SUFFIX}`, exports: uniqueExports })\n}\n\ntype LeafStrategy = (path: string, sourceFile: ast.FileNode | undefined) => Array<ast.ExportNode>\n\nfunction indexableNames(sources: ReadonlyArray<ast.SourceNode>, isTypeOnly: boolean): Array<string> {\n  const names = sources.flatMap((source) => (source.isIndexable && source.name && Boolean(source.isTypeOnly) === isTypeOnly ? [source.name] : []))\n  return [...new Set(names)].sort()\n}\n\n/**\n * Re-exports the whole module, unless it has sources and none of them is indexable.\n */\nconst allStrategy: LeafStrategy = (path, sourceFile) => {\n  const sources = sourceFile?.sources ?? []\n  return sources.length > 0 && !sources.some((source) => source.isIndexable) ? [] : [ast.factory.createExport({ path })]\n}\n\n/**\n * Re-exports the indexable names, values and types separately, or the whole module when it has no sources.\n */\nconst namedStrategy: LeafStrategy = (path, sourceFile) => {\n  if (!sourceFile?.sources.length) return [ast.factory.createExport({ path })]\n\n  const valueNames = indexableNames(sourceFile.sources, false)\n  const typeNames = indexableNames(sourceFile.sources, true)\n  return [\n    ...(valueNames.length > 0 ? [ast.factory.createExport({ name: valueNames, path })] : []),\n    ...(typeNames.length > 0 ? [ast.factory.createExport({ name: typeNames, path, isTypeOnly: true })] : []),\n  ]\n}\n\ntype FlatWalk = { barrels: Array<ast.FileNode>; leaves: Array<string> }\n\n/**\n * Post-order walk that builds a barrel re-exporting every leaf below the visited directory, for\n * the start node and, with `recursive`, every sub-directory. Also returns the subtree's leaf paths.\n */\nfunction walkFlat(node: DirectoryNode, ctx: WalkContext, isRoot = true): FlatWalk {\n  const results = [...node.children.values()].map((child): FlatWalk => (child.children ? walkFlat(child, ctx, false) : { barrels: [], leaves: [child.path] }))\n  const barrels = results.flatMap((result) => result.barrels)\n  const leaves = results.flatMap((result) => result.leaves)\n  const exports = isRoot || ctx.recursive ? leaves.flatMap((leaf) => ctx.leafExports(node.path, leaf)) : []\n\n  return { barrels: exports.length > 0 ? [...barrels, makeBarrel(node.path, exports, ctx)] : barrels, leaves }\n}\n\n/**\n * Recursive walk that builds one barrel per directory, re-exporting files and sub-barrels.\n * Used when nested: true. Leaf files honor the barrel `strategy`, so `named` emits explicit\n * named exports instead of wildcards. Sub-directory barrels are chained with a wildcard\n * re-export, which forwards the names the child barrel already curated. A sub-directory that\n * produced no barrel is never re-exported.\n */\nfunction walkNested(node: DirectoryNode, ctx: WalkContext): Array<ast.FileNode> {\n  const results = [...node.children.values()].map((child) => {\n    if (!child.children) return { barrels: [], exports: ctx.leafExports(node.path, child.path) }\n\n    // A sub-directory has barrels only when it has its own `index.ts`.\n    const barrels = walkNested(child, ctx)\n    const exports = barrels.length > 0 ? [ast.factory.createExport({ path: toRelativeModulePath(node.path, `${child.path}${BARREL_SUFFIX}`) })] : []\n    return { barrels, exports }\n  })\n  const barrels = results.flatMap((result) => result.barrels)\n  const exports = results.flatMap((result) => result.exports)\n\n  return exports.length > 0 ? [...barrels, makeBarrel(node.path, exports, ctx)] : barrels\n}\n\n/**\n * A directory tree plus the source-file lookup it was built from, scoped to a single output root.\n * Build it once with {@link buildBarrelIndex} and derive every barrel (per-plugin and root) from\n * it via {@link getBarrelFiles}, instead of re-scanning the full file set once per barrel.\n */\ntype BarrelIndex = {\n  tree: DirectoryNode\n  sourceFiles: ReadonlyMap<string, ast.FileNode>\n}\n\n/**\n * Indexes `files` once for the directory rooted at `outputPath`: filters to indexable source\n * files under that path and builds their directory tree. Reuse the result across every barrel\n * derived from the same root rather than re-filtering and re-building per barrel.\n */\nexport function buildBarrelIndex(outputPath: string, files: ReadonlyArray<ast.FileNode>): BarrelIndex {\n  const tree: DirectoryNode = { path: toPosixPath(outputPath), children: new Map() }\n  const sourceFiles = new Map(\n    files.flatMap((file) => {\n      const filePath = toPosixPath(file.path)\n      const isSource = filePath.startsWith(`${tree.path}/`) && !filePath.endsWith(BARREL_SUFFIX) && SOURCE_EXTENSIONS.has(extname(filePath))\n      return isSource ? [[filePath, file] as const] : []\n    }),\n  )\n\n  // Inserting paths in per-segment order keeps every directory's children sorted by name.\n  const entries = [...sourceFiles.keys()]\n    .map((filePath) =>\n      filePath\n        .slice(tree.path.length + 1)\n        .split('/')\n        .filter(Boolean),\n    )\n    .sort(compareSegments)\n  entries.forEach((parts) => {\n    parts.reduce<DirectoryNode>((dir, part, i) => {\n      const path = `${dir.path}/${part}`\n      const child: TreeNode = dir.children.get(part) ?? (i === parts.length - 1 ? { path } : { path, children: new Map() })\n      dir.children.set(part, child)\n      return child.children ? child : dir\n    }, tree)\n  })\n\n  return { tree, sourceFiles }\n}\n\n/**\n * Locates the directory node for `targetPath` within an index tree. Returns `undefined` when no\n * file exists under `targetPath` (nothing to barrel).\n */\nfunction findDirectory(tree: DirectoryNode, targetPath: string): DirectoryNode | undefined {\n  if (targetPath === tree.path) return tree\n  if (!targetPath.startsWith(`${tree.path}/`)) return undefined\n\n  const node = targetPath\n    .slice(tree.path.length + 1)\n    .split('/')\n    .reduce<TreeNode | undefined>((current, part) => current?.children?.get(part), tree)\n  return node?.children ? node : undefined\n}\n\ntype GetBarrelFilesParams = {\n  /**\n   * Index built once via {@link buildBarrelIndex} for the shared output root.\n   */\n  index: BarrelIndex\n  /**\n   * Absolute directory the barrel(s) should be rooted at, a subtree of the index root.\n   * Defaults to the index root.\n   */\n  targetPath?: string\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  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  recursive?: boolean\n  /**\n   * Collision identities reported by related barrel generations in the same build.\n   */\n  reportedCollisions?: Set<string>\n}\n\n/**\n * Returns the barrel `ast.FileNode`s for `targetPath` (or the index root), derived from a shared index.\n * Locating the subtree is a bounded walk down from the root, so deriving many barrels (one per\n * plugin, plus the root) from one index avoids re-scanning the full file set for each.\n *\n * @example\n * ```ts\n * const index = buildBarrelIndex(outputPath, files)\n * getBarrelFiles({ index, targetPath, barrelType }).forEach((file) => upsertFile(file))\n * ```\n */\nexport function getBarrelFiles({\n  index,\n  targetPath,\n  barrelType,\n  nested = false,\n  recursive = false,\n  reportedCollisions = new Set(),\n}: GetBarrelFilesParams): Array<ast.FileNode> {\n  const node = targetPath ? findDirectory(index.tree, toPosixPath(targetPath)) : index.tree\n  if (!node) return []\n\n  const strategy = barrelType === 'named' ? namedStrategy : allStrategy\n  const ctx: WalkContext = {\n    sourceFiles: index.sourceFiles,\n    reportedCollisions,\n    recursive,\n    leafExports: (dirPath, leafPath) => strategy(toRelativeModulePath(dirPath, leafPath), index.sourceFiles.get(leafPath)),\n  }\n\n  return nested ? walkNested(node, ctx) : walkFlat(node, ctx).barrels\n}\n","import path from 'node:path'\nimport { isPathInside } from '@internals/utils'\nimport { defineExtension, Diagnostics } from '@kubb/kit'\nimport type { ast, Config, NormalizedPlugin, Plugin } from '@kubb/kit'\nimport { compatibility } from '../kubb-extension.json'\nimport { version } from '../package.json'\nimport type { BarrelType, PluginBarrelConfig } from './types.ts'\nimport { buildBarrelIndex, getBarrelFiles } 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: ast.FileNode; plugin: NormalizedPlugin; config: Config }): ast.FileNode {\n  const output = plugin.options?.output\n  const resolver = plugin.resolver\n  const hasBanner = output?.banner !== undefined\n  const hasFooter = output?.footer !== undefined\n  if (!resolver || (!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.default.banner(undefined, context) : file.banner,\n    footer: hasFooter ? resolver.default.footer(undefined, context) : file.footer,\n  }\n}\n\n/**\n * Canonical plugin name for `@kubb/plugin-barrel`. Used for driver lookups\n * and to guard the `kubb:plugin:end` handler against reacting to its own lifecycle hook.\n */\nexport const pluginBarrelName = 'plugin-barrel' satisfies Plugin['name']\n\ntype PendingBarrel = {\n  plugin: NormalizedPlugin\n  target: string\n  barrelType: BarrelType\n  nested: boolean\n}\n\ntype BarrelState = {\n  excludedPlugins: Set<string>\n  // Subdirectories of `barrel: false` plugins, for files without a `meta.pluginName` owner.\n  excludedTargets: Array<string>\n  pendingBarrels: Array<PendingBarrel>\n}\n\n// One state per build, keyed by the build's `config`. The object form has no factory closure to hold it.\nconst states = new WeakMap<Config, BarrelState>()\n\nfunction getState(config: Config): BarrelState {\n  const state = states.get(config) ?? { excludedPlugins: new Set(), excludedTargets: [], pendingBarrels: [] }\n  states.set(config, state)\n  return state\n}\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`, but generates\n * nothing until a barrel is configured.\n *\n * Each plugin inherits `output.barrel` from `config.output.barrel` (which\n * defaults to `false`, no barrel). Set `barrel: { type: 'named' | 'all' }` on\n * the root config, a plugin, or both to opt in; a plugin-level `false`\n * overrides an enabled root barrel and also excludes that plugin's files\n * from the root barrel.\n *\n * A plugin with `output.mode: 'file'` gets no per-plugin barrel, since its output\n * is a single file. The root barrel re-exports that file directly.\n *\n * @example\n * ```ts\n * import { defineConfig } from '@kubb/core'\n * import { pluginBarrel } from '@kubb/plugin-barrel'\n * import { pluginTs } from '@kubb/plugin-ts'\n * import { pluginZod } from '@kubb/plugin-zod'\n *\n * export default defineConfig({\n *   input: './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 *     pluginBarrel(),\n *   ],\n * })\n * ```\n */\nexport const pluginBarrel = defineExtension({\n  kind: 'plugin',\n  meta: { name: pluginBarrelName, version, compatibility },\n  enforce: 'post',\n  hooks: {\n    'kubb:plugin:end'({ plugin, config }) {\n      // Skip reactions to the barrel plugin's own lifecycle hook\n      if (plugin.name === pluginBarrelName) return\n\n      const { excludedPlugins, excludedTargets, pendingBarrels } = getState(config)\n\n      // A plugin-level `false` wins over an enabled root barrel.\n      const barrelConfig: PluginBarrelConfig | false = plugin.options.output?.barrel ?? config.output.barrel ?? false\n      const base = path.resolve(config.root, config.output.path)\n      const target = path.resolve(base, plugin.options.output.path ?? '.')\n\n      if (barrelConfig === false) {\n        excludedPlugins.add(plugin.name)\n        // The output root holds every plugin's files, so there only the owner match applies.\n        if (target !== base && isPathInside(target, base)) {\n          excludedTargets.push(target)\n        }\n        return\n      }\n\n      // A plugin at the output root (no own `output.path`) gets no per-plugin barrel, which would\n      // claim every other plugin's directory. The root barrel picks up its files.\n      if (target === base) {\n        return\n      }\n\n      // `mode: 'file'` writes a single file, so there is no directory to barrel. The root barrel\n      // re-exports that file as a direct leaf of `config.output.path`.\n      if (plugin.options.output.mode === 'file') {\n        return\n      }\n\n      if (!isPathInside(target, base)) {\n        throw new Diagnostics.Error({\n          code: Diagnostics.code.pathTraversal,\n          severity: 'error',\n          message: `Output path \"${plugin.options.output.path}\" of plugin \"${plugin.name}\" resolves outside the output directory \"${base}\".`,\n          help: 'Keep the plugin `output.path` within `config.output.path`.',\n          location: { kind: 'config' },\n        })\n      }\n\n      // Only the target directory and barrel strategy are recorded here. The actual file-set\n      // scan and directory-tree build happen once, in `kubb:plugins:end`, and are shared by\n      // every plugin barrel plus the root barrel instead of repeating per plugin.\n      pendingBarrels.push({ plugin, target, barrelType: barrelConfig.type, nested: barrelConfig.nested ?? false })\n    },\n    'kubb:plugins:end'({ files, config, upsertFile }) {\n      const { excludedPlugins, excludedTargets, pendingBarrels } = getState(config)\n      const rootBarrelConfig = config.output.barrel ?? false\n      const outputPath = path.resolve(config.root, config.output.path)\n\n      // A `barrel: false` plugin gets no barrel and stays out of the root, so drop its files\n      // once here. Every barrel below then derives from a single index of what remains.\n      const relevantFiles = files.filter((file) => {\n        const owner = (file.meta as { pluginName?: string } | undefined)?.pluginName\n        if (owner) return !excludedPlugins.has(owner)\n\n        return !excludedTargets.some((target) => isPathInside(file.path, target))\n      })\n      excludedPlugins.clear()\n      excludedTargets.length = 0\n\n      const index = buildBarrelIndex(outputPath, relevantFiles)\n      const reportedCollisions = new Set<string>()\n\n      pendingBarrels.forEach(({ plugin, target, barrelType, nested }) => {\n        getBarrelFiles({ index, targetPath: target, barrelType, nested, recursive: true, reportedCollisions }).forEach((file) => {\n          upsertFile(withBarrelBannerFooter({ file, plugin, config }))\n        })\n      })\n      pendingBarrels.length = 0\n\n      if (rootBarrelConfig === false) return\n\n      getBarrelFiles({ index, barrelType: rootBarrelConfig.type, reportedCollisions }).forEach((file) => {\n        upsertFile(file)\n      })\n    },\n  },\n})\n"],"mappings":";;;;;;;;;;;;;;;;;;AA+JA,SAAgB,YAAY,UAA0B;CACpD,OAAO,SAAS,WAAW,MAAM,GAAG;AACtC;;;;;;;;;;;;;;;AAkCA,SAAgB,aAAa,MAAc,QAAyB;CAClE,MAAM,eAAe,QAAQ,IAAI;CACjC,MAAM,iBAAiB,QAAQ,MAAM;CACrC,IAAI,iBAAiB,gBACnB,OAAO;CAGT,MAAM,MAAM,SAAS,gBAAgB,YAAY;CAEjD,OAAO,QAAQ,MAAM,CAAC,IAAI,WAAW,IAAI,KAAK,CAAC,WAAW,GAAG;AAC/D;;;;;;;;;;;;AGxMA,MAAM,oCAAoB,IAAI,IAAI;CAAC;CAAO;CAAQ;CAAO;AAAM,CAAC;AAChE,MAAM,gBAAgB;;;;AAYtB,SAAS,gBAAgB,GAA0B,GAAkC;CACnF,MAAM,QAAQ,EAAE,WAAW,SAAS,MAAM,YAAY,EAAE,EAAE;CAC1D,IAAI,UAAU,IAAI,OAAO,EAAE,SAAS,EAAE;CACtC,IAAI,SAAS,EAAE,QAAQ,OAAO;CAE9B,OAAO,EAAE,SAAU,EAAE,SAAU,KAAK;AACtC;AAEA,SAAS,qBAAqB,SAAiB,UAA0B;CACvE,OAAO,KAAK,MAAM,SAAS,SAAS,QAAQ;AAC9C;;;;AAYA,SAAS,WAAW,SAAiB,SAAgC,EAAE,aAAa,sBAAiD;CACnI,MAAM,yBAAS,IAAI,IAAoB;CACvC,MAAM,gBAAgB,QAAQ,SAAS,SAAS;EAC9C,MAAM,WAAW,MAAM,KAAK,SAAS,KAAK,IAAI;EAG9C,MAAM,eADQ,KAAK,QAAQ,OAAQ,YAAY,IAAI,QAAQ,CAAC,EAAE,QAAQ,SAAS,WAAW,OAAO,QAAQ,CAAC,CAAC,KAAK,CAAC,IAAK,CAAC,KAAK,IAAI,CAAC,CAAC,KAAK,EAAA,CAC7G,QAAQ,SAAS;GACzC,MAAM,QAAQ,OAAO,IAAI,IAAI;GAC7B,IAAI,CAAC,OAAO;IACV,OAAO,IAAI,MAAM,KAAK,IAAI;IAC1B,OAAO;GACT;GAEA,MAAM,MAAM;IAAC;IAAM,MAAM,KAAK,SAAS,KAAK;IAAG;GAAQ,CAAC,CAAC,KAAK,IAAI;GAClE,IAAI,CAAC,mBAAmB,IAAI,GAAG,GAAG;IAChC,mBAAmB,IAAI,GAAG;IAC1B,YAAY,OAAO;KACjB,MAAM,YAAY,KAAK;KACvB,UAAU;KACV,SAAS,IAAI,KAAK,yBAAyB,MAAM,SAAS,KAAK,KAAK,SAAS,UAAU,cAAc;KACrG,MAAM;IACR,CAAC;GACH;GACA,OAAO;EACT,CAAC;EAED,IAAI,KAAK,QAAQ,MAAM,OAAO,CAAC,IAAI;EACnC,OAAO,YAAY,SAAS,IAAI,CAAC,IAAI,QAAQ,aAAa;GAAE,GAAG;GAAM,MAAM,MAAM,QAAQ,KAAK,IAAI,IAAI,cAAc,YAAY;EAAG,CAAC,CAAC,IAAI,CAAC;CAC5I,CAAC;CAED,OAAO,IAAI,QAAQ,WAAW;EAAE,UAAU;EAAY,MAAM,GAAG,UAAU;EAAiB,SAAS;CAAc,CAAC;AACpH;AAIA,SAAS,eAAe,SAAwC,YAAoC;CAClG,MAAM,QAAQ,QAAQ,SAAS,WAAY,OAAO,eAAe,OAAO,QAAQ,QAAQ,OAAO,UAAU,MAAM,aAAa,CAAC,OAAO,IAAI,IAAI,CAAC,CAAE;CAC/I,OAAO,CAAC,GAAG,IAAI,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK;AAClC;;;;AAKA,MAAM,eAA6B,MAAM,eAAe;CACtD,MAAM,UAAU,YAAY,WAAW,CAAC;CACxC,OAAO,QAAQ,SAAS,KAAK,CAAC,QAAQ,MAAM,WAAW,OAAO,WAAW,IAAI,CAAC,IAAI,CAAC,IAAI,QAAQ,aAAa,EAAE,KAAK,CAAC,CAAC;AACvH;;;;AAKA,MAAM,iBAA+B,MAAM,eAAe;CACxD,IAAI,CAAC,YAAY,QAAQ,QAAQ,OAAO,CAAC,IAAI,QAAQ,aAAa,EAAE,KAAK,CAAC,CAAC;CAE3E,MAAM,aAAa,eAAe,WAAW,SAAS,KAAK;CAC3D,MAAM,YAAY,eAAe,WAAW,SAAS,IAAI;CACzD,OAAO,CACL,GAAI,WAAW,SAAS,IAAI,CAAC,IAAI,QAAQ,aAAa;EAAE,MAAM;EAAY;CAAK,CAAC,CAAC,IAAI,CAAC,GACtF,GAAI,UAAU,SAAS,IAAI,CAAC,IAAI,QAAQ,aAAa;EAAE,MAAM;EAAW;EAAM,YAAY;CAAK,CAAC,CAAC,IAAI,CAAC,CACxG;AACF;;;;;AAQA,SAAS,SAAS,MAAqB,KAAkB,SAAS,MAAgB;CAChF,MAAM,UAAU,CAAC,GAAG,KAAK,SAAS,OAAO,CAAC,CAAC,CAAC,KAAK,UAAqB,MAAM,WAAW,SAAS,OAAO,KAAK,KAAK,IAAI;EAAE,SAAS,CAAC;EAAG,QAAQ,CAAC,MAAM,IAAI;CAAE,CAAE;CAC3J,MAAM,UAAU,QAAQ,SAAS,WAAW,OAAO,OAAO;CAC1D,MAAM,SAAS,QAAQ,SAAS,WAAW,OAAO,MAAM;CACxD,MAAM,UAAU,UAAU,IAAI,YAAY,OAAO,SAAS,SAAS,IAAI,YAAY,KAAK,MAAM,IAAI,CAAC,IAAI,CAAC;CAExG,OAAO;EAAE,SAAS,QAAQ,SAAS,IAAI,CAAC,GAAG,SAAS,WAAW,KAAK,MAAM,SAAS,GAAG,CAAC,IAAI;EAAS;CAAO;AAC7G;;;;;;;;AASA,SAAS,WAAW,MAAqB,KAAuC;CAC9E,MAAM,UAAU,CAAC,GAAG,KAAK,SAAS,OAAO,CAAC,CAAC,CAAC,KAAK,UAAU;EACzD,IAAI,CAAC,MAAM,UAAU,OAAO;GAAE,SAAS,CAAC;GAAG,SAAS,IAAI,YAAY,KAAK,MAAM,MAAM,IAAI;EAAE;EAG3F,MAAM,UAAU,WAAW,OAAO,GAAG;EAErC,OAAO;GAAE;GAAS,SADF,QAAQ,SAAS,IAAI,CAAC,IAAI,QAAQ,aAAa,EAAE,MAAM,qBAAqB,KAAK,MAAM,GAAG,MAAM,OAAO,eAAe,EAAE,CAAC,CAAC,IAAI,CAAC;EACrH;CAC5B,CAAC;CACD,MAAM,UAAU,QAAQ,SAAS,WAAW,OAAO,OAAO;CAC1D,MAAM,UAAU,QAAQ,SAAS,WAAW,OAAO,OAAO;CAE1D,OAAO,QAAQ,SAAS,IAAI,CAAC,GAAG,SAAS,WAAW,KAAK,MAAM,SAAS,GAAG,CAAC,IAAI;AAClF;;;;;;AAiBA,SAAgB,iBAAiB,YAAoB,OAAiD;CACpG,MAAM,OAAsB;EAAE,MAAM,YAAY,UAAU;EAAG,0BAAU,IAAI,IAAI;CAAE;CACjF,MAAM,cAAc,IAAI,IACtB,MAAM,SAAS,SAAS;EACtB,MAAM,WAAW,YAAY,KAAK,IAAI;EAEtC,OADiB,SAAS,WAAW,GAAG,KAAK,KAAK,EAAE,KAAK,CAAC,SAAS,SAAS,aAAa,KAAK,kBAAkB,IAAI,QAAQ,QAAQ,CAAC,IACnH,CAAC,CAAC,UAAU,IAAI,CAAU,IAAI,CAAC;CACnD,CAAC,CACH;CAWA,CARiB,GAAG,YAAY,KAAK,CAAC,CAAC,CACpC,KAAK,aACJ,SACG,MAAM,KAAK,KAAK,SAAS,CAAC,CAAC,CAC3B,MAAM,GAAG,CAAC,CACV,OAAO,OAAO,CACnB,CAAC,CACA,KAAK,eACF,CAAC,CAAC,SAAS,UAAU;EACzB,MAAM,QAAuB,KAAK,MAAM,MAAM;GAC5C,MAAM,OAAO,GAAG,IAAI,KAAK,GAAG;GAC5B,MAAM,QAAkB,IAAI,SAAS,IAAI,IAAI,MAAM,MAAM,MAAM,SAAS,IAAI,EAAE,KAAK,IAAI;IAAE;IAAM,0BAAU,IAAI,IAAI;GAAE;GACnH,IAAI,SAAS,IAAI,MAAM,KAAK;GAC5B,OAAO,MAAM,WAAW,QAAQ;EAClC,GAAG,IAAI;CACT,CAAC;CAED,OAAO;EAAE;EAAM;CAAY;AAC7B;;;;;AAMA,SAAS,cAAc,MAAqB,YAA+C;CACzF,IAAI,eAAe,KAAK,MAAM,OAAO;CACrC,IAAI,CAAC,WAAW,WAAW,GAAG,KAAK,KAAK,EAAE,GAAG,OAAO,KAAA;CAEpD,MAAM,OAAO,WACV,MAAM,KAAK,KAAK,SAAS,CAAC,CAAC,CAC3B,MAAM,GAAG,CAAC,CACV,QAA8B,SAAS,SAAS,SAAS,UAAU,IAAI,IAAI,GAAG,IAAI;CACrF,OAAO,MAAM,WAAW,OAAO,KAAA;AACjC;;;;;;;;;;;;AA6CA,SAAgB,eAAe,EAC7B,OACA,YACA,YACA,SAAS,OACT,YAAY,OACZ,qCAAqB,IAAI,IAAI,KACe;CAC5C,MAAM,OAAO,aAAa,cAAc,MAAM,MAAM,YAAY,UAAU,CAAC,IAAI,MAAM;CACrF,IAAI,CAAC,MAAM,OAAO,CAAC;CAEnB,MAAM,WAAW,eAAe,UAAU,gBAAgB;CAC1D,MAAM,MAAmB;EACvB,aAAa,MAAM;EACnB;EACA;EACA,cAAc,SAAS,aAAa,SAAS,qBAAqB,SAAS,QAAQ,GAAG,MAAM,YAAY,IAAI,QAAQ,CAAC;CACvH;CAEA,OAAO,SAAS,WAAW,MAAM,GAAG,IAAI,SAAS,MAAM,GAAG,CAAC,CAAC;AAC9D;;;;;;;;;;ACvPA,SAAS,uBAAuB,EAAE,MAAM,QAAQ,UAA0F;CACxI,MAAM,SAAS,OAAO,SAAS;CAC/B,MAAM,WAAW,OAAO;CACxB,MAAM,YAAY,QAAQ,WAAW,KAAA;CACrC,MAAM,YAAY,QAAQ,WAAW,KAAA;CACrC,IAAI,CAAC,YAAa,CAAC,aAAa,CAAC,WAAY,OAAO;CAEpD,MAAM,UAAU;EAAE;EAAQ;EAAQ,MAAM;GAAE,MAAM,KAAK;GAAM,UAAU,KAAK;GAAU,UAAU;EAAK;CAAE;CACrG,OAAO;EACL,GAAG;EACH,QAAQ,YAAY,SAAS,QAAQ,OAAO,KAAA,GAAW,OAAO,IAAI,KAAK;EACvE,QAAQ,YAAY,SAAS,QAAQ,OAAO,KAAA,GAAW,OAAO,IAAI,KAAK;CACzE;AACF;;;;;AAMA,MAAa,mBAAmB;AAiBhC,MAAM,yBAAS,IAAI,QAA6B;AAEhD,SAAS,SAAS,QAA6B;CAC7C,MAAM,QAAQ,OAAO,IAAI,MAAM,KAAK;EAAE,iCAAiB,IAAI,IAAI;EAAG,iBAAiB,CAAC;EAAG,gBAAgB,CAAC;CAAE;CAC1G,OAAO,IAAI,QAAQ,KAAK;CACxB,OAAO;AACT;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmCA,MAAa,eAAe,gBAAgB;CAC1C,MAAM;CACN,MAAM;EAAE,MAAM;EAAkB;EAAS;CAAc;CACvD,SAAS;CACT,OAAO;EACL,kBAAkB,EAAE,QAAQ,UAAU;GAEpC,IAAI,OAAO,SAAA,iBAA2B;GAEtC,MAAM,EAAE,iBAAiB,iBAAiB,mBAAmB,SAAS,MAAM;GAG5E,MAAM,eAA2C,OAAO,QAAQ,QAAQ,UAAU,OAAO,OAAO,UAAU;GAC1G,MAAM,OAAO,KAAK,QAAQ,OAAO,MAAM,OAAO,OAAO,IAAI;GACzD,MAAM,SAAS,KAAK,QAAQ,MAAM,OAAO,QAAQ,OAAO,QAAQ,GAAG;GAEnE,IAAI,iBAAiB,OAAO;IAC1B,gBAAgB,IAAI,OAAO,IAAI;IAE/B,IAAI,WAAW,QAAQ,aAAa,QAAQ,IAAI,GAC9C,gBAAgB,KAAK,MAAM;IAE7B;GACF;GAIA,IAAI,WAAW,MACb;GAKF,IAAI,OAAO,QAAQ,OAAO,SAAS,QACjC;GAGF,IAAI,CAAC,aAAa,QAAQ,IAAI,GAC5B,MAAM,IAAI,YAAY,MAAM;IAC1B,MAAM,YAAY,KAAK;IACvB,UAAU;IACV,SAAS,gBAAgB,OAAO,QAAQ,OAAO,KAAK,eAAe,OAAO,KAAK,2CAA2C,KAAK;IAC/H,MAAM;IACN,UAAU,EAAE,MAAM,SAAS;GAC7B,CAAC;GAMH,eAAe,KAAK;IAAE;IAAQ;IAAQ,YAAY,aAAa;IAAM,QAAQ,aAAa,UAAU;GAAM,CAAC;EAC7G;EACA,mBAAmB,EAAE,OAAO,QAAQ,cAAc;GAChD,MAAM,EAAE,iBAAiB,iBAAiB,mBAAmB,SAAS,MAAM;GAC5E,MAAM,mBAAmB,OAAO,OAAO,UAAU;GACjD,MAAM,aAAa,KAAK,QAAQ,OAAO,MAAM,OAAO,OAAO,IAAI;GAI/D,MAAM,gBAAgB,MAAM,QAAQ,SAAS;IAC3C,MAAM,QAAS,KAAK,MAA8C;IAClE,IAAI,OAAO,OAAO,CAAC,gBAAgB,IAAI,KAAK;IAE5C,OAAO,CAAC,gBAAgB,MAAM,WAAW,aAAa,KAAK,MAAM,MAAM,CAAC;GAC1E,CAAC;GACD,gBAAgB,MAAM;GACtB,gBAAgB,SAAS;GAEzB,MAAM,QAAQ,iBAAiB,YAAY,aAAa;GACxD,MAAM,qCAAqB,IAAI,IAAY;GAE3C,eAAe,SAAS,EAAE,QAAQ,QAAQ,YAAY,aAAa;IACjE,eAAe;KAAE;KAAO,YAAY;KAAQ;KAAY;KAAQ,WAAW;KAAM;IAAmB,CAAC,CAAC,CAAC,SAAS,SAAS;KACvH,WAAW,uBAAuB;MAAE;MAAM;MAAQ;KAAO,CAAC,CAAC;IAC7D,CAAC;GACH,CAAC;GACD,eAAe,SAAS;GAExB,IAAI,qBAAqB,OAAO;GAEhC,eAAe;IAAE;IAAO,YAAY,iBAAiB;IAAM;GAAmB,CAAC,CAAC,CAAC,SAAS,SAAS;IACjG,WAAW,IAAI;GACjB,CAAC;EACH;CACF;AACF,CAAC"}
+{"version":3,"file":"index.js","names":[],"sources":["../../../internals/utils/src/fs.ts","../kubb-extension.json","../package.json","../src/utils.ts","../src/plugin.ts"],"sourcesContent":["import { access, mkdir, readFile, rm, writeFile } from 'node:fs/promises'\nimport { dirname, isAbsolute, relative, resolve } from 'node:path'\nimport { runtime } from './runtime.ts'\n\n/**\n * Resolves to `true` when the file or directory at `path` exists.\n * Uses `Bun.file().exists()` when running under Bun, `fs.access` otherwise.\n *\n * @example\n * ```ts\n * if (await exists('./kubb.config.ts')) {\n *   const content = await read('./kubb.config.ts')\n * }\n * ```\n */\nexport async function exists(path: string): Promise<boolean> {\n  if (runtime.isBun) {\n    return Bun.file(path).exists()\n  }\n  return access(path).then(\n    () => true,\n    () => false,\n  )\n}\n\n/**\n * Reads the file at `path` as a UTF-8 string.\n * Uses `Bun.file().text()` when running under Bun, `fs.readFile` otherwise.\n *\n * @example\n * ```ts\n * const source = await read('./src/Pet.ts')\n * ```\n */\nexport async function read(path: string): Promise<string> {\n  if (runtime.isBun) {\n    return Bun.file(path).text()\n  }\n  return readFile(path, { encoding: 'utf8' })\n}\n\ntype WriteOptions = {\n  /**\n   * Previously read content, or `null` when the file does not exist.\n   * Omitting this value reads the file before writing.\n   */\n  stored?: string | null\n  /**\n   * When `true`, re-reads the file immediately after writing and throws if the\n   * content does not match — useful for catching write failures on unreliable file systems.\n   */\n  sanity?: boolean\n}\n\n/**\n * Whether `stored` already holds `source`, comparing on the trimmed text rather than the exact\n * bytes. Surrounding whitespace is what a formatter adds and what editors strip, and neither is a\n * reason to rewrite the file.\n *\n * Both sides are trimmed, so a storage that keeps bytes verbatim settles on the same answer as one\n * that normalizes what it stores. Trimming only `stored` would leave a source with leading\n * whitespace rewritten on every build, since the stored copy keeps the whitespace the comparison\n * has already dropped.\n */\nexport function matchesStored({ stored, source }: { stored: string; source: string }): boolean {\n  return stored.trim() === source.trim()\n}\n\n/**\n * Writes `data` to `path`, trimming surrounding whitespace and ending the file with a single newline\n * the way prettier, biome, and oxfmt all do.\n * Skips the write when the trimmed content is empty, or when the file already holds that content.\n * Creates any missing parent directories automatically.\n * When `sanity` is `true`, re-reads the file after writing and throws if the content does not match.\n *\n * @example\n * ```ts\n * await write('./src/Pet.ts', source)         // writes and returns the trimmed content plus a newline\n * await write('./src/Pet.ts', source)         // null — file unchanged\n * await write('./src/Pet.ts', '  ')           // null — empty content skipped\n * ```\n */\nexport async function write(path: string, data: string, options: WriteOptions = {}): Promise<string | null> {\n  const trimmed = data.trim()\n  if (trimmed === '') return null\n\n  const content = `${trimmed}\\n`\n  const resolved = resolve(path)\n  let stored = options.stored\n\n  if (stored === undefined) {\n    if (runtime.isBun) {\n      const file = Bun.file(resolved)\n      stored = (await file.exists()) ? await file.text() : null\n    } else {\n      try {\n        stored = await readFile(resolved, { encoding: 'utf-8' })\n      } catch {\n        /* file doesn't exist yet */\n        stored = null\n      }\n    }\n  }\n  if (matchesStored({ stored: stored ?? '', source: trimmed })) return null\n\n  if (runtime.isBun) {\n    await Bun.write(resolved, content)\n    return content\n  }\n\n  // Creating the directory up front costs a syscall per file, and every file after the first in a\n  // directory pays it for nothing. Write first and only fall back when the directory is missing,\n  // which also stays correct when something removed it mid-run.\n  try {\n    await writeFile(resolved, content, { encoding: 'utf-8' })\n  } catch (error) {\n    if ((error as NodeJS.ErrnoException).code !== 'ENOENT') throw error\n\n    await mkdir(dirname(resolved), { recursive: true })\n    await writeFile(resolved, content, { encoding: 'utf-8' })\n  }\n\n  if (options.sanity) {\n    const savedData = await readFile(resolved, { encoding: 'utf-8' })\n    if (savedData !== content) {\n      throw new Error(`Sanity check failed for ${path}\\n\\nData[${data.length}]:\\n${data}\\n\\nSaved[${savedData.length}]:\\n${savedData}\\n`)\n    }\n    return savedData\n  }\n\n  return content\n}\n\n/**\n * Recursively removes `path`. Silently succeeds when `path` does not exist.\n *\n * @example\n * ```ts\n * await clean('./dist')\n * ```\n */\nexport async function clean(path: string): Promise<void> {\n  return rm(path, { recursive: true, force: true })\n}\n\n/**\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\n/**\n * Strips the file extension from a path or file name.\n * Only removes the last `.ext` segment when the dot is not part of a directory name.\n *\n * @example\n * trimExtName('petStore.ts')             // 'petStore'\n * trimExtName('/src/models/pet.ts')      // '/src/models/pet'\n * trimExtName('/project.v2/gen/pet.ts')  // '/project.v2/gen/pet'\n * trimExtName('noExtension')             // 'noExtension'\n */\nexport function trimExtName(text: string): string {\n  const dotIndex = text.lastIndexOf('.')\n  if (dotIndex > 0 && !text.includes('/', dotIndex)) {\n    return text.slice(0, dotIndex)\n  }\n  return text\n}\n\n/**\n * Resolves to `true` when `path` is `parent` itself or nested inside it. Both sides are resolved\n * to absolute paths first, so relative and `..`-containing inputs compare correctly.\n *\n * Guards a destructive or an out-of-tree operation: before wiping an output directory, check that\n * it does not contain the project root, and before loading a path a caller supplied, check that it\n * did not escape the directory it is allowed to read from.\n *\n * @example\n * isPathInside('./src/gen', '.')   // true  — nested inside the root\n * isPathInside('.', '.')           // true  — the same directory counts as inside\n * isPathInside('.', './src/gen')   // false — the root is not inside its own output\n * isPathInside('../other', '.')    // false — escapes the root\n */\nexport function isPathInside(path: string, parent: string): boolean {\n  const resolvedPath = resolve(path)\n  const resolvedParent = resolve(parent)\n  if (resolvedPath === resolvedParent) {\n    return true\n  }\n\n  const rel = relative(resolvedParent, resolvedPath)\n\n  return rel !== '' && !rel.startsWith('..') && !isAbsolute(rel)\n}\n","","","import { extname, posix } from 'node:path'\nimport { ast, Diagnostics } from '@kubb/kit'\nimport { 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\n/**\n * A file (no `children`) or directory in the tree barrels are computed from. `path` is absolute and\n * POSIX-normalized, and a directory's `children` are keyed by entry name in sorted order.\n */\ntype TreeNode = { path: string; children?: undefined } | DirectoryNode\ntype DirectoryNode = { path: string; children: Map<string, TreeNode> }\n\n/**\n * Orders paths split into segments the way a directory listing sorts them: by name at each level.\n */\nfunction compareSegments(a: ReadonlyArray<string>, b: ReadonlyArray<string>): number {\n  const index = a.findIndex((segment, i) => segment !== b[i])\n  if (index === -1) return a.length - b.length\n  if (index >= b.length) return 1\n\n  return a[index]! < b[index]! ? -1 : 1\n}\n\nfunction toRelativeModulePath(fromDir: string, filePath: string): string {\n  return `./${posix.relative(fromDir, filePath)}`\n}\n\ntype WalkContext = {\n  sourceFiles: ReadonlyMap<string, ast.FileNode>\n  reportedCollisions: Set<string>\n  recursive: boolean\n  leafExports: (dirPath: string, leafPath: string) => Array<ast.ExportNode>\n}\n\n/**\n * Builds the `index.ts` for `dirPath`. Keeps the first export of each name and reports later duplicates once per build.\n */\nfunction makeBarrel(dirPath: string, exports: Array<ast.ExportNode>, { sourceFiles, reportedCollisions }: WalkContext): ast.FileNode {\n  const owners = new Map<string, string>()\n  const uniqueExports = exports.flatMap((item) => {\n    const itemPath = posix.join(dirPath, item.path)\n    // A wildcard export carries no names, so collisions are checked against its source file.\n    const names = item.name == null ? (sourceFiles.get(itemPath)?.sources.flatMap((source) => source.name || []) ?? []) : [item.name].flat()\n    const uniqueNames = names.filter((name) => {\n      const first = owners.get(name)\n      if (!first) {\n        owners.set(name, item.path)\n        return true\n      }\n\n      const key = [name, posix.join(dirPath, first), itemPath].join('\\0')\n      if (!reportedCollisions.has(key)) {\n        reportedCollisions.add(key)\n        Diagnostics.report({\n          code: Diagnostics.code.barrelDuplicateExport,\n          severity: 'error',\n          message: `\"${name}\" is exported by both \"${first}\" and \"${item.path}\", so \"${dirPath}${BARREL_SUFFIX}\" cannot re-export both.`,\n          help: 'Rename one of the colliding declarations, or configure the plugin resolver to produce distinct names.',\n        })\n      }\n      return false\n    })\n\n    if (item.name == null) return [item]\n    return uniqueNames.length > 0 ? [ast.factory.createExport({ ...item, name: Array.isArray(item.name) ? uniqueNames : uniqueNames[0] })] : []\n  })\n\n  return ast.factory.createFile({ baseName: 'index.ts', path: `${dirPath}${BARREL_SUFFIX}`, exports: uniqueExports })\n}\n\ntype LeafStrategy = (path: string, sourceFile: ast.FileNode | undefined) => Array<ast.ExportNode>\n\nfunction indexableNames(sources: ReadonlyArray<ast.SourceNode>, isTypeOnly: boolean): Array<string> {\n  const names = sources.flatMap((source) => (source.isIndexable && source.name && Boolean(source.isTypeOnly) === isTypeOnly ? [source.name] : []))\n  return [...new Set(names)].sort()\n}\n\n/**\n * Re-exports the whole module, unless it has sources and none of them is indexable.\n */\nconst allStrategy: LeafStrategy = (path, sourceFile) => {\n  const sources = sourceFile?.sources ?? []\n  return sources.length > 0 && !sources.some((source) => source.isIndexable) ? [] : [ast.factory.createExport({ path })]\n}\n\n/**\n * Re-exports the indexable names, values and types separately, or the whole module when it has no sources.\n */\nconst namedStrategy: LeafStrategy = (path, sourceFile) => {\n  if (!sourceFile?.sources.length) return [ast.factory.createExport({ path })]\n\n  const valueNames = indexableNames(sourceFile.sources, false)\n  const typeNames = indexableNames(sourceFile.sources, true)\n  return [\n    ...(valueNames.length > 0 ? [ast.factory.createExport({ name: valueNames, path })] : []),\n    ...(typeNames.length > 0 ? [ast.factory.createExport({ name: typeNames, path, isTypeOnly: true })] : []),\n  ]\n}\n\ntype FlatWalk = { barrels: Array<ast.FileNode>; leaves: Array<string> }\n\n/**\n * Post-order walk that builds a barrel re-exporting every leaf below the visited directory, for\n * the start node and, with `recursive`, every sub-directory. Also returns the subtree's leaf paths.\n */\nfunction walkFlat(node: DirectoryNode, ctx: WalkContext, isRoot = true): FlatWalk {\n  const results = [...node.children.values()].map((child): FlatWalk => (child.children ? walkFlat(child, ctx, false) : { barrels: [], leaves: [child.path] }))\n  const barrels = results.flatMap((result) => result.barrels)\n  const leaves = results.flatMap((result) => result.leaves)\n  const exports = isRoot || ctx.recursive ? leaves.flatMap((leaf) => ctx.leafExports(node.path, leaf)) : []\n\n  return { barrels: exports.length > 0 ? [...barrels, makeBarrel(node.path, exports, ctx)] : barrels, leaves }\n}\n\n/**\n * Recursive walk that builds one barrel per directory, re-exporting files and sub-barrels.\n * Used when nested: true. Leaf files honor the barrel `strategy`, so `named` emits explicit\n * named exports instead of wildcards. Sub-directory barrels are chained with a wildcard\n * re-export, which forwards the names the child barrel already curated. A sub-directory that\n * produced no barrel is never re-exported.\n */\nfunction walkNested(node: DirectoryNode, ctx: WalkContext): Array<ast.FileNode> {\n  const results = [...node.children.values()].map((child) => {\n    if (!child.children) return { barrels: [], exports: ctx.leafExports(node.path, child.path) }\n\n    // A sub-directory has barrels only when it has its own `index.ts`.\n    const barrels = walkNested(child, ctx)\n    const exports = barrels.length > 0 ? [ast.factory.createExport({ path: toRelativeModulePath(node.path, `${child.path}${BARREL_SUFFIX}`) })] : []\n    return { barrels, exports }\n  })\n  const barrels = results.flatMap((result) => result.barrels)\n  const exports = results.flatMap((result) => result.exports)\n\n  return exports.length > 0 ? [...barrels, makeBarrel(node.path, exports, ctx)] : barrels\n}\n\n/**\n * A directory tree plus the source-file lookup it was built from, scoped to a single output root.\n * Build it once with {@link buildBarrelIndex} and derive every barrel (per-plugin and root) from\n * it via {@link getBarrelFiles}, instead of re-scanning the full file set once per barrel.\n */\ntype BarrelIndex = {\n  tree: DirectoryNode\n  sourceFiles: ReadonlyMap<string, ast.FileNode>\n}\n\n/**\n * Indexes `files` once for the directory rooted at `outputPath`: filters to indexable source\n * files under that path and builds their directory tree. Reuse the result across every barrel\n * derived from the same root rather than re-filtering and re-building per barrel.\n */\nexport function buildBarrelIndex(outputPath: string, files: ReadonlyArray<ast.FileNode>): BarrelIndex {\n  const tree: DirectoryNode = { path: toPosixPath(outputPath), children: new Map() }\n  const sourceFiles = new Map(\n    files.flatMap((file) => {\n      const filePath = toPosixPath(file.path)\n      const isSource = filePath.startsWith(`${tree.path}/`) && !filePath.endsWith(BARREL_SUFFIX) && SOURCE_EXTENSIONS.has(extname(filePath))\n      return isSource ? [[filePath, file] as const] : []\n    }),\n  )\n\n  // Inserting paths in per-segment order keeps every directory's children sorted by name.\n  const entries = [...sourceFiles.keys()]\n    .map((filePath) =>\n      filePath\n        .slice(tree.path.length + 1)\n        .split('/')\n        .filter(Boolean),\n    )\n    .sort(compareSegments)\n  entries.forEach((parts) => {\n    parts.reduce<DirectoryNode>((dir, part, i) => {\n      const path = `${dir.path}/${part}`\n      const child: TreeNode = dir.children.get(part) ?? (i === parts.length - 1 ? { path } : { path, children: new Map() })\n      dir.children.set(part, child)\n      return child.children ? child : dir\n    }, tree)\n  })\n\n  return { tree, sourceFiles }\n}\n\n/**\n * Locates the directory node for `targetPath` within an index tree. Returns `undefined` when no\n * file exists under `targetPath` (nothing to barrel).\n */\nfunction findDirectory(tree: DirectoryNode, targetPath: string): DirectoryNode | undefined {\n  if (targetPath === tree.path) return tree\n  if (!targetPath.startsWith(`${tree.path}/`)) return undefined\n\n  const node = targetPath\n    .slice(tree.path.length + 1)\n    .split('/')\n    .reduce<TreeNode | undefined>((current, part) => current?.children?.get(part), tree)\n  return node?.children ? node : undefined\n}\n\ntype GetBarrelFilesParams = {\n  /**\n   * Index built once via {@link buildBarrelIndex} for the shared output root.\n   */\n  index: BarrelIndex\n  /**\n   * Absolute directory the barrel(s) should be rooted at, a subtree of the index root.\n   * Defaults to the index root.\n   */\n  targetPath?: string\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  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  recursive?: boolean\n  /**\n   * Collision identities reported by related barrel generations in the same build.\n   */\n  reportedCollisions?: Set<string>\n}\n\n/**\n * Returns the barrel `ast.FileNode`s for `targetPath` (or the index root), derived from a shared index.\n * Locating the subtree is a bounded walk down from the root, so deriving many barrels (one per\n * plugin, plus the root) from one index avoids re-scanning the full file set for each.\n *\n * @example\n * ```ts\n * const index = buildBarrelIndex(outputPath, files)\n * getBarrelFiles({ index, targetPath, barrelType }).forEach((file) => upsertFile(file))\n * ```\n */\nexport function getBarrelFiles({\n  index,\n  targetPath,\n  barrelType,\n  nested = false,\n  recursive = false,\n  reportedCollisions = new Set(),\n}: GetBarrelFilesParams): Array<ast.FileNode> {\n  const node = targetPath ? findDirectory(index.tree, toPosixPath(targetPath)) : index.tree\n  if (!node) return []\n\n  const strategy = barrelType === 'named' ? namedStrategy : allStrategy\n  const ctx: WalkContext = {\n    sourceFiles: index.sourceFiles,\n    reportedCollisions,\n    recursive,\n    leafExports: (dirPath, leafPath) => strategy(toRelativeModulePath(dirPath, leafPath), index.sourceFiles.get(leafPath)),\n  }\n\n  return nested ? walkNested(node, ctx) : walkFlat(node, ctx).barrels\n}\n","import path from 'node:path'\nimport { isPathInside } from '@internals/utils'\nimport { defineExtension, Diagnostics } from '@kubb/kit'\nimport type { ast, Config, NormalizedPlugin, Plugin } from '@kubb/kit'\nimport { compatibility } from '../kubb-extension.json'\nimport { version } from '../package.json'\nimport type { BarrelType, PluginBarrelConfig } from './types.ts'\nimport { buildBarrelIndex, getBarrelFiles } 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: ast.FileNode; plugin: NormalizedPlugin; config: Config }): ast.FileNode {\n  const output = plugin.options?.output\n  const resolver = plugin.resolver\n  const hasBanner = output?.banner !== undefined\n  const hasFooter = output?.footer !== undefined\n  if (!resolver || (!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.default.banner(undefined, context) : file.banner,\n    footer: hasFooter ? resolver.default.footer(undefined, context) : file.footer,\n  }\n}\n\n/**\n * Canonical plugin name for `@kubb/plugin-barrel`. Used for driver lookups\n * and to guard the `kubb:plugin:end` handler against reacting to its own lifecycle hook.\n */\nexport const pluginBarrelName = 'plugin-barrel' satisfies Plugin['name']\n\ntype PendingBarrel = {\n  plugin: NormalizedPlugin\n  target: string\n  barrelType: BarrelType\n  nested: boolean\n}\n\ntype BarrelState = {\n  excludedPlugins: Set<string>\n  // Subdirectories of `barrel: false` plugins, for files without a `meta.pluginName` owner.\n  excludedTargets: Array<string>\n  pendingBarrels: Array<PendingBarrel>\n}\n\n// One state per build, keyed by the build's `config`. The object form has no factory closure to hold it.\nconst states = new WeakMap<Config, BarrelState>()\n\nfunction getState(config: Config): BarrelState {\n  const state = states.get(config) ?? { excludedPlugins: new Set(), excludedTargets: [], pendingBarrels: [] }\n  states.set(config, state)\n  return state\n}\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`, but generates\n * nothing until a barrel is configured.\n *\n * Each plugin inherits `output.barrel` from `config.output.barrel` (which\n * defaults to `false`, no barrel). Set `barrel: { type: 'named' | 'all' }` on\n * the root config, a plugin, or both to opt in; a plugin-level `false`\n * overrides an enabled root barrel and also excludes that plugin's files\n * from the root barrel.\n *\n * A plugin with `output.mode: 'file'` gets no per-plugin barrel, since its output\n * is a single file. The root barrel re-exports that file directly.\n *\n * @example\n * ```ts\n * import { defineConfig } from '@kubb/core'\n * import { pluginBarrel } from '@kubb/plugin-barrel'\n * import { pluginTs } from '@kubb/plugin-ts'\n * import { pluginZod } from '@kubb/plugin-zod'\n *\n * export default defineConfig({\n *   input: './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 *     pluginBarrel(),\n *   ],\n * })\n * ```\n */\nexport const pluginBarrel = defineExtension({\n  kind: 'plugin',\n  meta: { name: pluginBarrelName, version, compatibility, issues: 'https://github.com/kubb-labs/kubb/issues' },\n  enforce: 'post',\n  hooks: {\n    'kubb:plugin:end'({ plugin, config }) {\n      // Skip reactions to the barrel plugin's own lifecycle hook\n      if (plugin.name === pluginBarrelName) return\n\n      const { excludedPlugins, excludedTargets, pendingBarrels } = getState(config)\n\n      // A plugin-level `false` wins over an enabled root barrel.\n      const barrelConfig: PluginBarrelConfig | false = plugin.options.output?.barrel ?? config.output.barrel ?? false\n      const base = path.resolve(config.root, config.output.path)\n      const target = path.resolve(base, plugin.options.output.path ?? '.')\n\n      if (barrelConfig === false) {\n        excludedPlugins.add(plugin.name)\n        // The output root holds every plugin's files, so there only the owner match applies.\n        if (target !== base && isPathInside(target, base)) {\n          excludedTargets.push(target)\n        }\n        return\n      }\n\n      // A plugin at the output root (no own `output.path`) gets no per-plugin barrel, which would\n      // claim every other plugin's directory. The root barrel picks up its files.\n      if (target === base) {\n        return\n      }\n\n      // `mode: 'file'` writes a single file, so there is no directory to barrel. The root barrel\n      // re-exports that file as a direct leaf of `config.output.path`.\n      if (plugin.options.output.mode === 'file') {\n        return\n      }\n\n      if (!isPathInside(target, base)) {\n        throw new Diagnostics.Error({\n          code: Diagnostics.code.pathTraversal,\n          severity: 'error',\n          message: `Output path \"${plugin.options.output.path}\" of plugin \"${plugin.name}\" resolves outside the output directory \"${base}\".`,\n          help: 'Keep the plugin `output.path` within `config.output.path`.',\n          location: { kind: 'config' },\n        })\n      }\n\n      // Only the target directory and barrel strategy are recorded here. The actual file-set\n      // scan and directory-tree build happen once, in `kubb:plugins:end`, and are shared by\n      // every plugin barrel plus the root barrel instead of repeating per plugin.\n      pendingBarrels.push({ plugin, target, barrelType: barrelConfig.type, nested: barrelConfig.nested ?? false })\n    },\n    'kubb:plugins:end'({ files, config, upsertFile }) {\n      const { excludedPlugins, excludedTargets, pendingBarrels } = getState(config)\n      const rootBarrelConfig = config.output.barrel ?? false\n      const outputPath = path.resolve(config.root, config.output.path)\n\n      // A `barrel: false` plugin gets no barrel and stays out of the root, so drop its files\n      // once here. Every barrel below then derives from a single index of what remains.\n      const relevantFiles = files.filter((file) => {\n        const owner = (file.meta as { pluginName?: string } | undefined)?.pluginName\n        if (owner) return !excludedPlugins.has(owner)\n\n        return !excludedTargets.some((target) => isPathInside(file.path, target))\n      })\n      excludedPlugins.clear()\n      excludedTargets.length = 0\n\n      const index = buildBarrelIndex(outputPath, relevantFiles)\n      const reportedCollisions = new Set<string>()\n\n      pendingBarrels.forEach(({ plugin, target, barrelType, nested }) => {\n        getBarrelFiles({ index, targetPath: target, barrelType, nested, recursive: true, reportedCollisions }).forEach((file) => {\n          upsertFile(withBarrelBannerFooter({ file, plugin, config }))\n        })\n      })\n      pendingBarrels.length = 0\n\n      if (rootBarrelConfig === false) return\n\n      getBarrelFiles({ index, barrelType: rootBarrelConfig.type, reportedCollisions }).forEach((file) => {\n        upsertFile(file)\n      })\n    },\n  },\n})\n"],"mappings":"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"}

package/docs/options.md

@@ -14,7 +14,7 @@
 
 ### output.barrel
 
-Kubb writes one root barrel and an `index.ts` in every directory of a plugin's output. For two plugins that write to `models` and `clients`:
+Kubb writes an `index.ts` in every directory of a plugin's output, and a root barrel when `output.barrel` is set on `defineConfig`. For two plugins that write to `models` and `clients`, with `output.barrel` set on `defineConfig`:
 
 ```text
 src/gen

package/docs/overview.md

@@ -1,27 +1,27 @@
-# Barrel plugin
+# Barrel
 
-The barrel plugin writes `index.ts` files that re-export generated code, one for each plugin's output and one root barrel, so you can import everything from a single entry point.
-
-Kubb adds it to `plugins` for you. Do not add it yourself. It generates nothing until you configure `output.barrel`.
+The Barrel plugin writes `index.ts` files that re-export generated code, so you can import everything from a single entry point. It writes a barrel in every folder of each plugin output that has a barrel setting, plus a root barrel when you set `output.barrel` on `defineConfig`.
 
 ## Setup
 
-Set `output.barrel` on `defineConfig` to write a root barrel. Plugins without a barrel setting of their own inherit it.
+Kubb adds the plugin to `plugins` for you, so no setup is needed. Generator plugins such as `pluginTs()` turn on their own barrels by default. Plugins without their own `output.barrel` inherit the root setting.
 
-## Options
+## Options worth knowing
 
-The plugin takes no arguments. You configure it through `output.barrel`, on `defineConfig` or on a single plugin.
+`pluginBarrel()` takes no arguments. You configure it through `output.barrel`, on `defineConfig` or on a single plugin.
 
 - `type: 'named'` re-exports each symbol by name, which suits tree-shaking. `type: 'all'` writes `export *`.
-- `nested: true`, on a plugin only, makes each barrel re-export just its own directory and the barrels below it. The root barrel is always flat.
+- `nested: true`, on a plugin only, makes each barrel re-export just its own folder and the barrels below it. The root barrel is always flat.
 - `false` on a plugin turns its barrel off and leaves its files out of the root barrel.
 
-A plugin with `output.mode: 'file'` gets no barrel of its own. The root barrel re-exports that file directly. Passing your own `output` object to a plugin replaces its default `barrel: { type: 'named' }`, so it falls back to the root setting.
+A plugin with `output.mode: 'file'` gets no barrel of its own, and the root barrel re-exports that file directly. Passing your own `output` object to a plugin replaces its default `barrel: { type: 'named' }`, so that plugin falls back to the root setting. When two files export the same name, Kubb reports an error, and a `named` barrel keeps only the first one.
 
-See [Options](https://kubb.dev/extensions/kubb-labs/plugin-barrel/options) for the export `type`, `nested` barrels, and per-plugin overrides.
+See [Options](https://kubb.dev/extensions/kubb-labs/plugin-barrel/options) for every option and its default.
 
 ## Example
 
+The config below writes a root `src/gen/index.ts` that re-exports the generated types by name.
+
 ```typescript [kubb.config.ts]
 import { defineConfig } from 'kubb/config'
 import { pluginTs } from '@kubb/plugin-ts'
@@ -29,6 +29,8 @@ import { pluginTs } from '@kubb/plugin-ts'
 export default defineConfig({
   input: './petStore.yaml',
   output: { path: './src/gen', barrel: { type: 'named' } },
-  plugins: [pluginTs()],
+  plugins: [
+    pluginTs(),
+  ],
 })
 ```

package/kubb-extension.json

@@ -4,7 +4,7 @@
   "name": "plugin-barrel",
   "export": "pluginBarrel",
   "displayName": "Barrel",
-  "description": "Generates index.ts barrel files for every plugin output and one root barrel.",
+  "description": "Generates index.ts barrel files for every plugin output, plus a root barrel when output.barrel is set on defineConfig.",
   "category": "output",
   "icon": {
     "light": "https://kubb.dev/feature/plugins-light.svg"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kubb/plugin-barrel",
-  "version": "5.8.4",
+  "version": "5.9.1",
   "description": "Barrel-file plugin for Kubb. Automatically generates index.ts re-export files per plugin output directory.",
   "keywords": [
     "barrel",
@@ -61,11 +61,11 @@
     "registry": "https://registry.npmjs.org/"
   },
   "dependencies": {
-    "@kubb/kit": "5.8.4"
+    "@kubb/kit": "5.9.1"
   },
   "devDependencies": {
     "@internals/utils": "0.0.1",
-    "@kubb/core": "5.8.4"
+    "@kubb/core": "5.9.1"
   },
   "engines": {
     "node": ">=22"