@kubb/middleware-barrel 5.0.0-beta.5 → 5.0.0-beta.50

package/extension.yaml

@@ -2,7 +2,7 @@ $schema: https://kubb.dev/schemas/extension.json
 kind: middleware
 id: middleware-barrel
 name: Barrel
-description: Automatically generates barrel files (index.ts exports) for every plugin output directory. Ships with Kubb and is enabled by default.
+description: Generates `index.ts` re-export files for every plugin output and one root barrel. Ships with Kubb and is enabled by default.
 category: output
 type: official
 npmPackage: '@kubb/middleware-barrel'
@@ -26,9 +26,9 @@ resources:
   changelog: https://github.com/kubb-labs/kubb/blob/main/packages/middleware-barrel/CHANGELOG.md
 featured: true
 intro: |-
-  The barrel middleware automatically generates `index.ts` (and `index.js`) re-export files for every plugin output directory **and** a root barrel at `config.output.path/index.ts` after the build finishes.
+  `@kubb/middleware-barrel` generates an `index.ts` for every plugin output directory and one root barrel at `output.path/index.ts` after the build completes. The result is a single import surface for every consumer — `import { Pet, usePetByIdQuery, petMock } from './gen'`.
 
-  It ships with Kubb and is registered as a default middleware in `defineConfig`, so you get barrel files out of the box with no extra configuration. When `middlewareBarrel` is part of `config.middleware`, `defineConfig` also applies a default `output.barrel` of `{ type: 'named' }`. Custom middleware lists that omit `middlewareBarrel` leave `barrel` untouched.
+  The middleware ships with Kubb and is registered by default in `defineConfig`, so barrels appear out of the box with no extra configuration. When `middlewareBarrel` is part of `config.middleware`, `defineConfig` also applies a default `output.barrel` of `{ type: 'named' }`. Custom middleware lists that omit `middlewareBarrel` leave `barrel` untouched.
 
   Plugins inherit `output.barrel` from `config.output.barrel` when their own value is omitted. Setting `barrel: false` on a plugin disables that plugin's barrel **and** excludes its files from the root barrel.
 options:
@@ -37,18 +37,20 @@ options:
     required: false
     default: "{ type: 'named' }"
     description: |-
-      Re-export style for the generated barrel files. Configured via `output.barrel` in `defineConfig` (root level) or per plugin via the plugin's own `output.barrel`. This is not a middleware argument.
+      Re-export style used for every generated barrel file. Set via `output.barrel` in `defineConfig` (applies to all plugins and the root barrel) or per plugin via that plugin's own `output.barrel`. It is not an argument to the middleware itself.
 
       At the config level:
-      - `{ type: 'all' }` — `export * from '...'` for every generated file
-      - `{ type: 'named' }` — `export { name1, name2 } from '...'` using each file's named exports
-      - `false` — disables barrel generation entirely
 
-      At the plugin level, the `nested` flag is also available:
-      - `{ type: 'named', nested: true }` — generates a barrel for every directory, re-exporting only direct children, creating a chain for imports from any depth
-      - `false` — disables barrel generation for that plugin and excludes its files from the root barrel
+      - `{ type: 'all' }` — `export * from '...'` for every generated file.
+      - `{ type: 'named' }` — `export { Foo, Bar } from '...'` using each file's named exports.
+      - `false` — disables barrel generation entirely.
 
-      The `{ type: 'named' }` default is applied automatically by `defineConfig` only when `middlewareBarrel` is part of `config.middleware`.
+      At the plugin level you also get `nested`:
+
+      - `{ type: 'named', nested: true }` — generates a barrel for every subdirectory, re-exporting only direct children. Lets callers import from any depth.
+      - `false` — disables the plugin's barrel and removes its files from the root barrel.
+
+      The `{ type: 'named' }` default kicks in only when `middlewareBarrel` is part of `config.middleware`.
     codeBlock:
       lang: typescript
       title: kubb.config.ts
@@ -58,12 +60,13 @@ options:
         import { middlewareBarrel } from '@kubb/middleware-barrel'
 
         export default defineConfig({
-          input: { path: './petstore.yaml' },
+          input: { path: './petStore.yaml' },
           output: { path: './src/gen', barrel: { type: 'named' } },
           middleware: [middlewareBarrel()],
+          plugins: [],
         })
 examples:
-  - name: "barrel: { type: 'named' } (default)"
+  - name: "{ type: 'named' } (default)"
     files:
       - name: kubb.config.ts
         lang: typescript
@@ -72,10 +75,11 @@ examples:
           import { defineConfig } from 'kubb'
 
           export default defineConfig({
-            input: { path: './petstore.yaml' },
+            input: { path: './petStore.yaml' },
             output: { path: './src/gen' },
+            plugins: [],
           })
-      - name: 'Generated output'
+      - name: Generated output
         lang: typescript
         twoslash: false
         code: |-
@@ -92,7 +96,7 @@ examples:
 
           // src/gen/api/types/index.ts
           export { User } from './User'
-  - name: "barrel: { type: 'all' }"
+  - name: "{ type: 'all' }"
     files:
       - name: kubb.config.ts
         lang: typescript
@@ -101,10 +105,11 @@ examples:
           import { defineConfig } from 'kubb'
 
           export default defineConfig({
-            input: { path: './petstore.yaml' },
+            input: { path: './petStore.yaml' },
             output: { path: './src/gen', barrel: { type: 'all' } },
+            plugins: [],
           })
-      - name: 'Generated output'
+      - name: Generated output
         lang: typescript
         twoslash: false
         code: |-
@@ -121,7 +126,7 @@ examples:
 
           // src/gen/api/types/index.ts
           export * from './User'
-  - name: "barrel: { type: 'named', nested: true }"
+  - name: "{ type: 'named', nested: true }"
     files:
       - name: kubb.config.ts
         lang: typescript
@@ -130,10 +135,11 @@ examples:
           import { defineConfig } from 'kubb'
 
           export default defineConfig({
-            input: { path: './petstore.yaml' },
+            input: { path: './petStore.yaml' },
             output: { path: './src/gen', barrel: { type: 'named', nested: true } },
+            plugins: [],
           })
-      - name: 'Generated output (chained structure)'
+      - name: Generated output (chained structure)
         lang: typescript
         twoslash: false
         code: |-
@@ -148,7 +154,7 @@ examples:
 
           // src/gen/api/types/index.ts (exports files)
           export * from './User'
-  - name: Disable barrel for a single plugin
+  - name: Disable the barrel for a single plugin
     files:
       - name: kubb.config.ts
         lang: typescript
@@ -158,17 +164,17 @@ examples:
           import { pluginTs } from '@kubb/plugin-ts'
           import { pluginZod } from '@kubb/plugin-zod'
 
-          // pluginZod opts out: no zod/index.ts is created
+          // pluginZod opts out: no zod/index.ts is created,
           // and zod files are excluded from the root index.ts.
           export default defineConfig({
-            input: { path: './petstore.yaml' },
+            input: { path: './petStore.yaml' },
             output: { path: './src/gen' },
             plugins: [
               pluginTs(),
               pluginZod({ output: { barrel: false } }),
             ],
           })
-  - name: Disable the root barrel only
+  - name: Disable only the root barrel
     files:
       - name: kubb.config.ts
         lang: typescript
@@ -177,15 +183,16 @@ examples:
           import { defineConfig } from 'kubb'
 
           // No root index.ts is generated, but each plugin
-          // still gets its own barrel using its inherited barrel config.
+          // still gets its own barrel using its inherited config.
           export default defineConfig({
-            input: { path: './petstore.yaml' },
+            input: { path: './petStore.yaml' },
             output: { path: './src/gen', barrel: false },
+            plugins: [],
           })
 notes:
   - type: tip
     body: |-
-      `middleware-barrel` is bundled with Kubb and enabled automatically when no `middleware` option is provided. You only need to install it explicitly when customising the barrel behaviour alongside other middlewares.
+      `middleware-barrel` ships with Kubb and is enabled automatically when no `middleware` option is provided. Install it explicitly only when customizing barrel behavior alongside other middlewares.
   - type: note
     body: |-
-      `output.barrel` is only auto-defaulted to `{ type: 'named' }` when `middlewareBarrel` is part of `config.middleware`. If you provide a custom middleware list without it, set `output.barrel` yourself if you still want a barrel.
+      `output.barrel` is auto-defaulted to `{ type: 'named' }` only when `middlewareBarrel` is part of `config.middleware`. With a custom middleware list that omits it, set `output.barrel` yourself if you still want a barrel.

package/package.json

@@ -1,14 +1,12 @@
 {
   "name": "@kubb/middleware-barrel",
-  "version": "5.0.0-beta.5",
-  "description": "Barrel-file generation middleware for Kubb. Generates index.ts barrel files for each plugin's output directory and a root index.ts after all plugins have run.",
+  "version": "5.0.0-beta.50",
+  "description": "Barrel-file middleware for Kubb. Automatically generates index.ts re-export files per plugin output directory and an optional root barrel after all plugins complete.",
   "keywords": [
     "barrel",
-    "code-generator",
     "codegen",
     "kubb",
     "middleware",
-    "openapi",
     "typescript"
   ],
   "license": "MIT",
@@ -44,21 +42,26 @@
     "access": "public",
     "registry": "https://registry.npmjs.org/"
   },
+  "dependencies": {
+    "@kubb/ast": "5.0.0-beta.50",
+    "@kubb/core": "5.0.0-beta.50"
+  },
   "devDependencies": {
     "@internals/utils": "0.0.0"
   },
   "peerDependencies": {
-    "@kubb/core": "5.0.0-beta.5"
+    "@kubb/core": "5.0.0-beta.50"
   },
   "engines": {
     "node": ">=22"
   },
   "scripts": {
     "build": "tsdown",
-    "clean": "npx rimraf ./dist",
+    "clean": "node -e \"require('node:fs').rmSync('./dist', {recursive:true,force:true})\"",
     "lint": "oxlint .",
     "lint:fix": "oxlint --fix .",
     "release": "pnpm publish --no-git-check",
+    "release:stage": "pnpm stage publish --no-git-check",
     "start": "tsdown --watch",
     "test": "vitest --passWithNoTests",
     "typecheck": "tsc -p ./tsconfig.json --noEmit --emitDeclarationOnly false"

package/src/middleware.ts

@@ -1,10 +1,34 @@
 import path from 'node:path'
 import { resolve } from 'node:path'
+import type { FileNode } from '@kubb/ast'
 import { defineMiddleware } from '@kubb/core'
-import type { Middleware } from '@kubb/core'
+import type { Config, Middleware, NormalizedPlugin } from '@kubb/core'
 import type { BarrelConfig, PluginBarrelConfig } from './types.ts'
-import { getPluginOutputPrefix, isExcludedPath } from './utils/excludedPaths.ts'
-import { getBarrelFiles } from './utils/getBarrelFiles.ts'
+import { getBarrelFiles, getPluginOutputPrefix, isExcludedPath } from './utils.ts'
+
+/**
+ * Applies a plugin's configured `output.banner`/`footer` to a barrel file, flagged as `isBarrel`.
+ *
+ * Resolves through the plugin's own resolver, and only when the plugin explicitly sets a
+ * banner/footer, so barrels stay banner-free by default and never inherit the implicit
+ * "Generated by Kubb" notice.
+ */
+function withBarrelBannerFooter({ file, plugin, config }: { file: FileNode; plugin: NormalizedPlugin; config: Config }): FileNode {
+  const output = plugin.options?.output
+  const resolver = plugin.resolver
+  if (!resolver) return file
+
+  const hasBanner = output?.banner !== undefined
+  const hasFooter = output?.footer !== undefined
+  if (!hasBanner && !hasFooter) return file
+
+  const context = { output, config, file: { path: file.path, baseName: file.baseName, isBarrel: true } }
+  return {
+    ...file,
+    banner: hasBanner ? resolver.resolveBanner(undefined, context) : file.banner,
+    footer: hasFooter ? resolver.resolveFooter(undefined, context) : file.footer,
+  }
+}
 
 declare global {
   namespace Kubb {
@@ -12,7 +36,7 @@ declare global {
       output: {
         /**
          * Barrel configuration for this plugin's output.
-         * Set to `false` to disable barrel generation for this plugin entirely; doing so also
+         * Set to `false` to disable barrel generation for this plugin entirely. Doing so also
          * excludes the plugin's files from the root barrel.
          *
          * Falls back to `config.output.barrel` when omitted.
@@ -38,17 +62,32 @@ declare global {
 }
 
 /**
- * Generates `index.ts` barrel files for each plugin and a root barrel at `config.output.path/index.ts`.
+ * Canonical middleware name for `@kubb/middleware-barrel`. Used for driver
+ * lookups.
+ */
+export const middlewareBarrelName = 'middleware-barrel' satisfies Middleware['name']
+
+/**
+ * Generates an `index.ts` for every plugin output directory and one root
+ * barrel at `config.output.path/index.ts` after the build completes. Ships
+ * with Kubb and is registered by default in `defineConfig`.
+ *
+ * Each plugin inherits `output.barrel` from `config.output.barrel` (which
+ * defaults to `{ type: 'named' }`). Set `barrel: false` on a plugin to skip
+ * its barrel and also exclude its files from the root barrel.
  *
- * Each plugin inherits `output.barrel` from `config.output.barrel` (defaults to `{ type: 'named' }`).
- * Set `barrel: false` on a plugin to disable its barrel and exclude it from the root barrel.
+ * A plugin with `output.mode: 'file'` gets no per-plugin barrel, since its output
+ * is a single file. The root barrel re-exports that file directly.
  *
  * @example
  * ```ts
  * import { defineConfig } from '@kubb/core'
  * import { middlewareBarrel } from '@kubb/middleware-barrel'
+ * import { pluginTs } from '@kubb/plugin-ts'
+ * import { pluginZod } from '@kubb/plugin-zod'
  *
  * export default defineConfig({
+ *   input: { path: './petStore.yaml' },
  *   output: { path: 'src/gen', barrel: { type: 'named' } },
  *   plugins: [
  *     pluginTs({ output: { path: 'types', barrel: { type: 'all' } } }),
@@ -58,12 +97,6 @@ declare global {
  * })
  * ```
  */
-
-/**
- * Stable string identifier for the barrel middleware.
- */
-export const middlewareBarrelName = 'middleware-barrel' satisfies Middleware['name']
-
 export const middlewareBarrel = defineMiddleware(() => {
   const excludedPrefixes = new Set<string>()
 
@@ -75,21 +108,24 @@ export const middlewareBarrel = defineMiddleware(() => {
         const configBarrel = config.output.barrel
         const defaultBarrel = { type: 'named' } as const
 
-        let barrelConfig: PluginBarrelConfig | false
-        if (pluginBarrel !== undefined) {
-          barrelConfig = pluginBarrel
-        } else if (configBarrel !== undefined) {
-          // Root config barrel doesn't have nested, so we add it
-          barrelConfig = configBarrel === false ? false : { ...configBarrel, nested: false }
-        } else {
-          barrelConfig = defaultBarrel
-        }
+        // Root config barrel doesn't have nested, so we add it
+        const barrelConfig: PluginBarrelConfig | false = (() => {
+          if (pluginBarrel !== undefined) return pluginBarrel
+          if (configBarrel !== undefined) return configBarrel === false ? false : { ...configBarrel, nested: false }
+          return defaultBarrel
+        })()
 
         if (barrelConfig === false) {
           excludedPrefixes.add(getPluginOutputPrefix(plugin, config))
           return
         }
 
+        // `mode: 'file'` writes a single file, so there is no directory to barrel. The root barrel
+        // re-exports that file as a direct leaf of `config.output.path`.
+        if (plugin.options.output.mode === 'file') {
+          return
+        }
+
         const barrelType = barrelConfig.type
         const nested = barrelConfig.nested ?? false
 
@@ -99,16 +135,8 @@ export const middlewareBarrel = defineMiddleware(() => {
         if (relative.startsWith('..') || path.isAbsolute(relative)) {
           throw new Error('Invalid output path')
         }
-        const barrelFiles = getBarrelFiles({
-          outputPath: target,
-          files,
-          barrelType,
-          nested,
-          recursive: true,
-        })
-
-        if (barrelFiles.length > 0) {
-          upsertFile(...barrelFiles)
+        for (const file of getBarrelFiles({ outputPath: target, files, barrelType, nested, recursive: true })) {
+          upsertFile(withBarrelBannerFooter({ file, plugin, config }))
         }
       },
       'kubb:plugins:end'({ files, config, upsertFile }) {
@@ -121,14 +149,8 @@ export const middlewareBarrel = defineMiddleware(() => {
 
         const barrelType = barrelConfig.type
 
-        const rootBarrelFiles = getBarrelFiles({
-          outputPath: resolve(config.root, config.output.path),
-          files: filteredFiles,
-          barrelType,
-        })
-
-        if (rootBarrelFiles.length > 0) {
-          upsertFile(...rootBarrelFiles)
+        for (const file of getBarrelFiles({ outputPath: resolve(config.root, config.output.path), files: filteredFiles, barrelType })) {
+          upsertFile(file)
         }
       },
     },

package/src/types.ts

@@ -1,8 +1,8 @@
 /**
  * Barrel export strategy.
  *
- * - `'all'` — generates `export * from '...'` for every file
- * - `'named'` — generates `export { name1, name2 } from '...'` using each file's named exports
+ * - `'all'` generates `export * from '...'` for every file
+ * - `'named'` generates `export { name1, name2 } from '...'` using each file's named exports
  */
 export type BarrelType = 'all' | 'named'
 
@@ -19,8 +19,8 @@ export type BarrelType = 'all' | 'named'
 export type BarrelConfig = {
   /**
    * Export strategy for the root barrel file.
-   * - `'all'` — wildcard exports: `export * from './file'`
-   * - `'named'` — explicit exports: `export { x, y } from './file'`
+   * - `'all'` wildcard exports: `export * from './file'`
+   * - `'named'` explicit exports: `export { x, y } from './file'`
    */
   type: BarrelType
 }
@@ -40,8 +40,8 @@ export type BarrelConfig = {
 export type PluginBarrelConfig = {
   /**
    * Export strategy for the plugin's barrel files.
-   * - `'all'` — wildcard exports: `export * from './file'`
-   * - `'named'` — explicit exports: `export { x, y } from './file'`
+   * - `'all'` wildcard exports: `export * from './file'`
+   * - `'named'` explicit exports: `export { x, y } from './file'`
    */
   type: BarrelType
   /**

package/src/{utils/getBarrelFiles.ts → utils.ts}

@@ -1,12 +1,12 @@
-import { extname } from 'node:path'
+import { extname, resolve } from 'node:path'
 import { createExport, createFile } from '@kubb/ast'
 import type { ExportNode, FileNode, SourceNode } from '@kubb/ast'
-import { BARREL_FILENAME } from '../constants.ts'
-import type { BarrelType } from '../types.ts'
+import type { Config, NormalizedPlugin } from '@kubb/core'
 import { type BuildTree, buildTree, toPosixPath } from '@internals/utils'
+import type { BarrelType } from './types.ts'
 
 const SOURCE_EXTENSIONS = new Set(['.ts', '.tsx', '.js', '.jsx'])
-const BARREL_SUFFIX = `/${BARREL_FILENAME}`
+const BARREL_SUFFIX = `/index.ts`
 
 function toRelativeModulePath(fromDir: string, filePath: string): string {
   return `./${filePath.slice(fromDir.length + 1)}`
@@ -18,13 +18,14 @@ function isBarrelPath(path: string): boolean {
 
 function makeBarrel(dirPath: string, exports: Array<ExportNode>): FileNode {
   return createFile({
-    baseName: BARREL_FILENAME,
+    baseName: 'index.ts',
     path: `${dirPath}${BARREL_SUFFIX}`,
     exports,
     sources: [],
     imports: [],
-    // Barrel files must never carry a banner or footer: they only re-export
-    // symbols and adding a directive like "use server" would break consumers.
+    // Default to no banner/footer. The middleware resolves a configured plugin
+    // banner/footer (with isBarrel: true) afterwards, so a `banner` function can
+    // decide per file whether a barrel should carry a directive like "use server".
     banner: undefined,
     footer: undefined,
   })
@@ -33,7 +34,7 @@ function makeBarrel(dirPath: string, exports: Array<ExportNode>): FileNode {
 type LeafContext = {
   dirPath: string
   leafPath: string
-  sourceFile: FileNode | undefined
+  sourceFile: FileNode | null
 }
 
 type LeafStrategy = (ctx: LeafContext) => Array<ExportNode>
@@ -99,9 +100,10 @@ type LeafWalkParams = {
 }
 
 /**
- * Post-order walk that emits a barrel per visited directory.
+ * Post-order walk that yields a barrel per visited directory.
+ * Returns the list of leaf file paths collected in this subtree (used by the parent call).
  */
-function walkAllOrNamed(node: BuildTree, params: LeafWalkParams, isRoot: boolean, out: Array<FileNode>): Array<string> {
+function* walkAllOrNamed(node: BuildTree, params: LeafWalkParams, isRoot: boolean): Generator<FileNode, Array<string>> {
   const subtreeLeaves: Array<string> = []
 
   for (const child of node.children) {
@@ -110,26 +112,26 @@ function walkAllOrNamed(node: BuildTree, params: LeafWalkParams, isRoot: boolean
       continue
     }
 
-    const childLeaves = walkAllOrNamed(child, params, false, out)
+    const childLeaves = yield* walkAllOrNamed(child, params, false)
     for (const leaf of childLeaves) subtreeLeaves.push(leaf)
   }
 
   if (!isRoot && !params.recursive) return subtreeLeaves
 
-  const exports = subtreeLeaves.flatMap((leafPath) => params.strategy({ dirPath: node.path, leafPath, sourceFile: params.sourceFiles.get(leafPath) }))
+  const exports = subtreeLeaves.flatMap((leafPath) => params.strategy({ dirPath: node.path, leafPath, sourceFile: params.sourceFiles.get(leafPath) ?? null }))
 
   if (exports.length > 0) {
-    out.push(makeBarrel(node.path, exports))
+    yield makeBarrel(node.path, exports)
   }
 
   return subtreeLeaves
 }
 
 /**
- * Recursive walk that emits one barrel per directory, re-exporting files and sub-barrels.
+ * Recursive walk that yields one barrel per directory, re-exporting files and sub-barrels.
  * Used when nested: true.
  */
-function walkNested(node: BuildTree, out: Array<FileNode>): void {
+function* walkNested(node: BuildTree): Generator<FileNode> {
   const exports: Array<ExportNode> = []
 
   for (const child of node.children) {
@@ -139,12 +141,12 @@ function walkNested(node: BuildTree, out: Array<FileNode>): void {
       continue
     }
 
-    walkNested(child, out)
+    yield* walkNested(child)
     exports.push(createExport({ path: toRelativeModulePath(node.path, `${child.path}${BARREL_SUFFIX}`) }))
   }
 
   if (exports.length > 0) {
-    out.push(makeBarrel(node.path, exports))
+    yield makeBarrel(node.path, exports)
   }
 }
 
@@ -204,24 +206,53 @@ type GetBarrelFilesParams = {
 }
 
 /**
- * Generates barrel `FileNode`s for the directory rooted at `outputPath`.
+ * Yields barrel `FileNode`s for the directory rooted at `outputPath`.
+ *
+ * @example
+ * ```ts
+ * for (const file of getBarrelFiles({ outputPath, files, barrelType })) {
+ *   upsertFile(file)
+ * }
+ * // or collect into an array
+ * const barrels = [...getBarrelFiles({ outputPath, files, barrelType })]
+ * ```
  */
-export function getBarrelFiles({ outputPath, files, barrelType, nested = false, recursive = false }: GetBarrelFilesParams): Array<FileNode> {
+export function* getBarrelFiles({ outputPath, files, barrelType, nested = false, recursive = false }: GetBarrelFilesParams): Generator<FileNode> {
   const { sourceFiles, paths } = indexRelevantFiles(files, outputPath)
-  if (paths.length === 0) return []
+  if (paths.length === 0) return
 
   const tree = buildTree(outputPath, paths)
-  const result: Array<FileNode> = []
 
-  // Use nested walk for hierarchical barrel structure
   if (nested) {
-    walkNested(tree, result)
-    return result
+    yield* walkNested(tree)
+    return
   }
 
   const strategy = LEAF_STRATEGIES.get(barrelType)
-  if (!strategy) return result
+  if (!strategy) return
 
-  walkAllOrNamed(tree, { sourceFiles, strategy, recursive }, true, result)
-  return result
+  yield* walkAllOrNamed(tree, { sourceFiles, strategy, recursive }, true)
+}
+
+/**
+ * Builds a POSIX-normalized prefix for a plugin's output. A directory output gets a trailing `/`,
+ * while a `mode: 'file'` output (the path is the file itself) gets the exact path with no trailing `/`.
+ *
+ * Used to detect (and later exclude) files generated by plugins that opted out of the root barrel.
+ */
+export function getPluginOutputPrefix(plugin: NormalizedPlugin, config: Config): string {
+  const resolved = toPosixPath(resolve(config.root, config.output.path, plugin.options.output.path))
+  return plugin.options.output.mode === 'file' ? resolved : `${resolved}/`
+}
+
+/**
+ * Returns `true` when `filePath` lives under any of the given excluded prefixes. A prefix with a
+ * trailing `/` matches a directory subtree, and a prefix without one matches that exact file
+ * (used for `mode: 'file'` outputs).
+ *
+ * Both sides are POSIX-normalized so Windows backslash paths match correctly.
+ */
+export function isExcludedPath(filePath: string, prefixes: ReadonlySet<string>): boolean {
+  const normalized = toPosixPath(filePath)
+  return prefixes.values().some((prefix) => (prefix.endsWith('/') ? normalized.startsWith(prefix) : normalized === prefix))
 }

package/src/constants.ts

@@ -1,4 +0,0 @@
-/**
- * Full file name for barrel files (with extension).
- */
-export const BARREL_FILENAME = 'index.ts' as const

package/src/utils/excludedPaths.ts

@@ -1,22 +0,0 @@
-import { resolve } from 'node:path'
-import type { Config, NormalizedPlugin } from '@kubb/core'
-import { toPosixPath } from '@internals/utils'
-
-/**
- * Builds a POSIX-normalized prefix for a plugin's output directory, with a trailing `/`.
- *
- * Used to detect (and later exclude) files generated by plugins that opted out of the root barrel.
- */
-export function getPluginOutputPrefix(plugin: NormalizedPlugin, config: Config): string {
-  return `${toPosixPath(resolve(config.root, config.output.path, plugin.options.output.path))}/`
-}
-
-/**
- * Returns `true` when `filePath` lives under any of the given excluded directory prefixes.
- *
- * Both sides are POSIX-normalized so Windows backslash paths match correctly.
- */
-export function isExcludedPath(filePath: string, prefixes: ReadonlySet<string>): boolean {
-  const normalized = toPosixPath(filePath)
-  return prefixes.values().some((prefix) => normalized.startsWith(prefix))
-}