@kubb/plugin-barrel 5.8.1 → 5.8.3

package/README.md

@@ -10,7 +10,7 @@
 [![Node][node-src]][node-href]
 
 <h4>
-<a href="https://kubb.dev" target="_blank">Documentation</a>
+<a href="https://kubb.dev/extensions/kubb-labs/plugin-barrel" target="_blank">Documentation</a>
 <span> · </span>
 <a href="https://github.com/kubb-labs/kubb/issues/" target="_blank">Report Bug</a>
 <span> · </span>

package/dist/index.cjs

@@ -71,7 +71,7 @@ var compatibility = {
 };
 //#endregion
 //#region package.json
-var version = "5.8.1";
+var version = "5.8.3";
 //#endregion
 //#region src/utils.ts
 const SOURCE_EXTENSIONS = /* @__PURE__ */ new Set([
@@ -342,7 +342,8 @@ function getState(config) {
 * })
 * ```
 */
-const pluginBarrel = (0, _kubb_kit.definePlugin)({
+const pluginBarrel = (0, _kubb_kit.defineExtension)({
+	kind: "plugin",
 	meta: {
 		name: pluginBarrelName,
 		version,

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":["resolve","relative","isAbsolute","posix","Diagnostics","ast","extname","definePlugin","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 { definePlugin, 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 = definePlugin({\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 },\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.js

@@ -1,6 +1,6 @@
 import "./rolldown-runtime-C0LytTxp.js";
 import path, { extname, isAbsolute, posix, relative, resolve } from "node:path";
-import { Diagnostics, ast, definePlugin } from "@kubb/kit";
+import { Diagnostics, ast, defineExtension } from "@kubb/kit";
 //#region ../../internals/utils/src/fs.ts
 /**
 * Converts a filesystem path to use POSIX (`/`) separators.
@@ -48,7 +48,7 @@ var compatibility = {
 };
 //#endregion
 //#region package.json
-var version = "5.8.1";
+var version = "5.8.3";
 //#endregion
 //#region src/utils.ts
 const SOURCE_EXTENSIONS = /* @__PURE__ */ new Set([
@@ -319,7 +319,8 @@ function getState(config) {
 * })
 * ```
 */
-const pluginBarrel = definePlugin({
+const pluginBarrel = defineExtension({
+	kind: "plugin",
 	meta: {
 		name: pluginBarrelName,
 		version,

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 { definePlugin, 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 = definePlugin({\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.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":"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"}

package/docs/options.md

@@ -0,0 +1,119 @@
+# Options
+
+`pluginBarrel` takes no arguments. You configure it through `output.barrel`, either on `defineConfig` to set the root barrel and the default every plugin inherits, or on a single plugin to override that plugin's barrel. The plugin-level behavior is also summarized under [`output.barrel`](https://kubb.dev/docs/5.x/reference/plugin-options#output-barrel) in the shared plugin options.
+
+## Options overview
+
+| Option                              | Purpose                                                | Default                                                                                     |
+| ----------------------------------- | ------------------------------------------------------ | ------------------------------------------------------------------------------------------- |
+| [`output.barrel`](#output-barrel)   | Re-export style for the barrel files.                  | `false` on `defineConfig`, `{ type: 'named' }` in every generator plugin's default `output` |
+| ↳ [`output.barrel.type`](#type)     | Named exports or a wildcard export.                    | Required when `output.barrel` is an object                                                  |
+| ↳ [`output.barrel.nested`](#nested) | Choose whether barrels reference subdirectory barrels. | `false`                                                                                     |
+
+## Option details
+
+### 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`:
+
+```text
+src/gen
+├── index.ts              root barrel
+├── models
+│   ├── index.ts          plugin barrel
+│   ├── Pet.ts
+│   └── User.ts
+└── clients
+    ├── index.ts          plugin barrel
+    ├── pet
+    │   ├── index.ts
+    │   └── getPetById.ts
+    └── store
+        ├── index.ts
+        └── getInventory.ts
+```
+
+|          |                                                         |
+| -------- | ------------------------------------------------------- |
+| Type     | `{ type: 'all' \| 'named', nested?: boolean } \| false` |
+| Required | `false`                                                 |
+| Default  | `false`                                                 |
+
+The `type` field picks the export style. A plugin's `output.barrel` also accepts `nested`, so each barrel re-exports the barrels below it instead of the leaf files. The root `output.barrel` has no `nested` field and always stays flat.
+
+A plugin called without `output` uses its own default, which sets `barrel: { type: 'named' }`. If you pass your own `output` object, it replaces that default. `pluginTs({ output: { path: 'types' } })` then has no `barrel` and uses `config.output.barrel`, which is `false` unless you set it.
+
+Set `barrel: { type: 'named' | 'all' }` on `defineConfig` to enable barrels everywhere: a root barrel, and the default every plugin without its own `output.barrel` inherits. A plugin that sets its own `output.barrel` overrides that inherited value, including back to `false`, which also drops its files from the root barrel. A plugin with `output.mode: 'file'` gets no barrel of its own, and the root barrel re-exports that file directly.
+
+### type
+
+Export style for the barrel files. Required whenever `output.barrel` is set to an object.
+
+|          |                    |
+| -------- | ------------------ |
+| Type     | `'all' \| 'named'` |
+| Required | `true`             |
+
+::field-group
+
+:::field{name="'named'"}
+Re-exports each symbol by name from the file's named exports. Best for tree-shaking and explicit imports.
+:::
+
+:::field{name="'all'"}
+Uses `export *`, a smaller barrel that re-exports everything.
+:::
+
+::
+
+::code-group
+
+```typescript ['named']
+// src/gen/index.ts
+export { getUser } from './api/user'
+export { getPost, Post } from './api/post'
+export { User } from './api/types/User'
+```
+
+```typescript ['all']
+// src/gen/index.ts
+export * from './api/user'
+export * from './api/post'
+export * from './api/types/User'
+```
+
+::
+
+### nested
+
+Changes what each barrel references. A barrel is written for every directory either way. With `nested: false`, the plugin's top barrel reaches through to the leaf files. With `nested: true`, each barrel re-exports only what sits directly inside its directory, including the subdirectory barrels below it, so callers can import from any depth. This field works on a plugin's `output.barrel` only.
+
+|          |           |
+| -------- | --------- |
+| Type     | `boolean` |
+| Required | `false`   |
+| Default  | `false`   |
+
+::code-group
+
+```typescript [nested: false (default) → barrels reference leaf files]
+// src/gen/api/index.ts
+export * from './user'
+export * from './post'
+export * from './types/User'
+
+// src/gen/api/types/index.ts
+export * from './User'
+```
+
+```typescript [nested: true → barrels reference sub-barrels]
+// src/gen/api/index.ts re-exports its files and subdirectories
+export * from './user'
+export * from './post'
+export * from './types'
+
+// src/gen/api/types/index.ts re-exports its files
+export * from './User'
+```
+
+::

package/{OVERVIEW.md → docs/overview.md}

@@ -8,17 +8,6 @@ Kubb adds it to `plugins` for you. Do not add it yourself. It generates nothing
 
 Set `output.barrel` on `defineConfig` to write a root barrel. Plugins without a barrel setting of their own inherit it.
 
-```ts
-import { defineConfig } from 'kubb/config'
-import { pluginTs } from '@kubb/plugin-ts'
-
-export default defineConfig({
-  input: './petStore.yaml',
-  output: { path: './src/gen', barrel: { type: 'named' } },
-  plugins: [pluginTs()],
-})
-```
-
 ## Options
 
 The plugin takes no arguments. You configure it through `output.barrel`, on `defineConfig` or on a single plugin.
@@ -28,3 +17,18 @@ The plugin takes no arguments. You configure it through `output.barrel`, on `def
 - `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.
+
+See [Options](https://kubb.dev/extensions/kubb-labs/plugin-barrel/options) for the export `type`, `nested` barrels, and per-plugin overrides.
+
+## Example
+
+```typescript [kubb.config.ts]
+import { defineConfig } from 'kubb/config'
+import { pluginTs } from '@kubb/plugin-ts'
+
+export default defineConfig({
+  input: './petStore.yaml',
+  output: { path: './src/gen', barrel: { type: 'named' } },
+  plugins: [pluginTs()],
+})
+```

package/kubb-extension.json

@@ -10,7 +10,8 @@
     "light": "https://kubb.dev/feature/plugins-light.svg"
   },
   "tags": ["barrel", "index", "exports", "output"],
-  "docs": "https://kubb.dev/plugins/plugin-barrel",
+  "docs": "https://kubb.dev/extensions/kubb-labs/plugin-barrel",
+  "maintainers": [{ "name": "Stijn Van Hulle", "github": "stijnvanhulle" }],
   "compatibility": {
     "kubb": ">=5.8.0",
     "node": ">=22"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kubb/plugin-barrel",
-  "version": "5.8.1",
+  "version": "5.8.3",
   "description": "Barrel-file plugin for Kubb. Automatically generates index.ts re-export files per plugin output directory.",
   "keywords": [
     "barrel",
@@ -10,7 +10,7 @@
     "plugin",
     "typescript"
   ],
-  "homepage": "https://kubb.dev/plugins/plugin-barrel",
+  "homepage": "https://kubb.dev/extensions/kubb-labs/plugin-barrel",
   "license": "MIT",
   "author": "stijnvanhulle",
   "repository": {
@@ -35,7 +35,7 @@
   "files": [
     "dist",
     "kubb-extension.json",
-    "OVERVIEW.md",
+    "docs",
     "*.d.ts",
     "*.d.cts",
     "!/**/**.test.**",
@@ -61,11 +61,11 @@
     "registry": "https://registry.npmjs.org/"
   },
   "dependencies": {
-    "@kubb/kit": "5.8.1"
+    "@kubb/kit": "5.8.3"
   },
   "devDependencies": {
     "@internals/utils": "0.0.1",
-    "@kubb/core": "5.8.1"
+    "@kubb/core": "5.8.3"
   },
   "engines": {
     "node": ">=22"