@kubb/core 5.0.0-beta.36 → 5.0.0-beta.38

package/dist/mocks.js

@@ -1,5 +1,5 @@
 import "./chunk-C0LytTxp.js";
-import { a as FileManager, n as applyHookResult, t as KubbDriver } from "./KubbDriver-DrG5-FFe.js";
+import { i as FileManager, n as _usingCtx, t as KubbDriver } from "./KubbDriver-CyNF-NIb.js";
 import { resolve } from "node:path";
 import { transform } from "@kubb/ast";
 //#region src/mocks.ts
@@ -8,6 +8,7 @@ import { transform } from "@kubb/ast";
 * Creates a minimal `PluginDriver` mock for unit tests.
 */
 function createMockedPluginDriver(options = {}) {
+	const fileManager = new FileManager();
 	return {
 		config: options?.config ?? {
 			root: ".",
@@ -17,12 +18,34 @@ function createMockedPluginDriver(options = {}) {
 			return options?.plugin;
 		},
 		getResolver: (_pluginName) => options?.plugin?.resolver,
-		fileManager: new FileManager()
+		fileManager,
+		async dispatch({ result, renderer }) {
+			try {
+				var _usingCtx$1 = _usingCtx();
+				if (!result) return;
+				if (Array.isArray(result)) {
+					fileManager.upsert(...result);
+					return;
+				}
+				if (!renderer) return;
+				const instance = _usingCtx$1.u(renderer());
+				if (instance.stream) {
+					for (const file of instance.stream(result)) fileManager.upsert(file);
+					return;
+				}
+				await instance.render(result);
+				fileManager.upsert(...instance.files);
+			} catch (_) {
+				_usingCtx$1.e = _;
+			} finally {
+				_usingCtx$1.d();
+			}
+		}
 	};
 }
 /**
 * Creates a minimal `Adapter` mock for unit tests.
-* `parse` returns an empty `InputNode` by default; override via `options.parse`.
+* `parse` returns an empty `InputNode` by default. Override via `options.parse`.
 * `getImports` returns `[]` by default.
 */
 function createMockedAdapter(options = {}) {
@@ -90,13 +113,13 @@ async function renderGeneratorSchema(generator, node, opts) {
 	if (!generator.schema) return;
 	const context = createMockedPluginContext(opts);
 	const transformedNode = opts.plugin.transformer ? transform(node, opts.plugin.transformer) : node;
-	await applyHookResult({
-		result: await generator.schema(transformedNode, {
-			...context,
-			options: opts.options
-		}),
-		driver: opts.driver,
-		rendererFactory: generator.renderer
+	const result = await generator.schema(transformedNode, {
+		...context,
+		options: opts.options
+	});
+	await opts.driver.dispatch({
+		result,
+		renderer: generator.renderer
 	});
 }
 /**
@@ -112,13 +135,13 @@ async function renderGeneratorOperation(generator, node, opts) {
 	if (!generator.operation) return;
 	const context = createMockedPluginContext(opts);
 	const transformedNode = opts.plugin.transformer ? transform(node, opts.plugin.transformer) : node;
-	await applyHookResult({
-		result: await generator.operation(transformedNode, {
-			...context,
-			options: opts.options
-		}),
-		driver: opts.driver,
-		rendererFactory: generator.renderer
+	const result = await generator.operation(transformedNode, {
+		...context,
+		options: opts.options
+	});
+	await opts.driver.dispatch({
+		result,
+		renderer: generator.renderer
 	});
 }
 /**
@@ -134,13 +157,13 @@ async function renderGeneratorOperations(generator, nodes, opts) {
 	if (!generator.operations) return;
 	const context = createMockedPluginContext(opts);
 	const transformedNodes = opts.plugin.transformer ? nodes.map((n) => transform(n, opts.plugin.transformer)) : nodes;
-	await applyHookResult({
-		result: await generator.operations(transformedNodes, {
-			...context,
-			options: opts.options
-		}),
-		driver: opts.driver,
-		rendererFactory: generator.renderer
+	const result = await generator.operations(transformedNodes, {
+		...context,
+		options: opts.options
+	});
+	await opts.driver.dispatch({
+		result,
+		renderer: generator.renderer
 	});
 }
 //#endregion

package/dist/mocks.js.map

@@ -1 +1 @@
-{"version":3,"file":"mocks.js","names":[],"sources":["../src/mocks.ts"],"sourcesContent":["import { resolve } from 'node:path'\nimport type { FileNode, InputMeta, OperationNode, SchemaNode, Visitor } from '@kubb/ast'\nimport { transform } from '@kubb/ast'\nimport { FileManager } from './FileManager.ts'\nimport { applyHookResult, KubbDriver } from './KubbDriver.ts'\nimport type { Adapter, AdapterFactoryOptions, Config, Generator, GeneratorContext, NormalizedPlugin, PluginFactoryOptions } from './types.ts'\n\n/**\n\n * Creates a minimal `PluginDriver` mock for unit tests.\n */\nexport function createMockedPluginDriver(options: { name?: string; plugin?: NormalizedPlugin; config?: Config } = {}): KubbDriver {\n  return {\n    config: options?.config ?? {\n      root: '.',\n      output: {\n        path: './path',\n      },\n    },\n    getPlugin(_pluginName: string): NormalizedPlugin | undefined {\n      return options?.plugin\n    },\n    getResolver: (_pluginName: string) => options?.plugin?.resolver,\n    fileManager: new FileManager(),\n  } as unknown as KubbDriver\n}\n\n/**\n * Creates a minimal `Adapter` mock for unit tests.\n * `parse` returns an empty `InputNode` by default; override via `options.parse`.\n * `getImports` returns `[]` by default.\n */\nexport function createMockedAdapter<TOptions extends AdapterFactoryOptions = AdapterFactoryOptions>(\n  options: {\n    name?: TOptions['name']\n    resolvedOptions?: TOptions['resolvedOptions']\n    parse?: Adapter<TOptions>['parse']\n    getImports?: Adapter<TOptions>['getImports']\n  } = {},\n): Adapter<TOptions> {\n  return {\n    name: (options.name ?? 'oas') as TOptions['name'],\n    options: (options.resolvedOptions ?? {}) as TOptions['resolvedOptions'],\n    parse: options.parse ?? (async () => ({ kind: 'Input' as const, schemas: [], operations: [] })),\n    getImports: options.getImports ?? ((_node: SchemaNode, _resolve: (schemaName: string) => { name: string; path: string }) => []),\n  } as Adapter<TOptions>\n}\n\n/**\n * Creates a minimal plugin mock for unit tests.\n *\n * @example\n * `const plugin = createMockedPlugin<PluginTs>({ name: '@kubb/plugin-ts', options })`\n */\nexport function createMockedPlugin<TOptions extends PluginFactoryOptions = PluginFactoryOptions>(params: {\n  name: TOptions['name']\n  options: TOptions['resolvedOptions']\n  resolver?: TOptions['resolver']\n  transformer?: Visitor\n  dependencies?: Array<string>\n}): NormalizedPlugin<TOptions> {\n  return {\n    name: params.name,\n    options: params.options,\n    resolver: params.resolver,\n    transformer: params.transformer,\n    dependencies: params.dependencies,\n    hooks: {},\n  } as unknown as NormalizedPlugin<TOptions>\n}\n\ntype RenderGeneratorOptions<TOptions extends PluginFactoryOptions> = {\n  config: Config\n  adapter: Adapter\n  meta?: InputMeta\n  driver: KubbDriver\n  plugin: NormalizedPlugin<TOptions>\n  options: TOptions['resolvedOptions']\n  resolver: TOptions['resolver']\n}\n\nfunction createMockedPluginContext<TOptions extends PluginFactoryOptions>(opts: RenderGeneratorOptions<TOptions>): Omit<GeneratorContext<TOptions>, 'options'> {\n  const root = resolve(opts.config.root, opts.config.output.path)\n\n  return {\n    config: opts.config,\n    root,\n    getMode: (output: { path: string }) => KubbDriver.getMode(resolve(root, output.path)),\n    adapter: opts.adapter,\n    resolver: opts.resolver,\n    plugin: opts.plugin,\n    driver: opts.driver,\n    getResolver: (name: string) => opts.driver.getResolver(name),\n    meta: opts.meta ?? { circularNames: [], enumNames: [] },\n    addFile: async (...files: Array<FileNode>) => opts.driver.fileManager.add(...files),\n    upsertFile: async (...files: Array<FileNode>) => opts.driver.fileManager.upsert(...files),\n    hooks: opts.driver.hooks ?? ({} as never),\n    warn: (msg: string) => console.warn(msg),\n    error: (msg: string) => console.error(msg),\n    info: (msg: string) => console.info(msg),\n    openInStudio: async () => {},\n  } as unknown as Omit<GeneratorContext<TOptions>, 'options'>\n}\n\n/**\n * Renders a generator's `schema` method in a test context.\n *\n * @example\n * ```ts\n * await renderGeneratorSchema(typeGenerator, node, { config, adapter, driver, plugin, options, resolver })\n * await matchFiles(driver.fileManager.files)\n * ```\n */\nexport async function renderGeneratorSchema<TOptions extends PluginFactoryOptions>(\n  generator: Generator<TOptions>,\n  node: SchemaNode,\n  opts: RenderGeneratorOptions<TOptions>,\n): Promise<void> {\n  if (!generator.schema) return\n  const context = createMockedPluginContext(opts)\n  const transformedNode = opts.plugin.transformer ? transform(node, opts.plugin.transformer) : node\n  const result = await generator.schema(transformedNode, {\n    ...context,\n    options: opts.options,\n  })\n  await applyHookResult({ result, driver: opts.driver, rendererFactory: generator.renderer })\n}\n\n/**\n * Renders a generator's `operation` method in a test context.\n *\n * @example\n * ```ts\n * await renderGeneratorOperation(typeGenerator, node, { config, adapter, driver, plugin, options, resolver })\n * await matchFiles(driver.fileManager.files)\n * ```\n */\nexport async function renderGeneratorOperation<TOptions extends PluginFactoryOptions>(\n  generator: Generator<TOptions>,\n  node: OperationNode,\n  opts: RenderGeneratorOptions<TOptions>,\n): Promise<void> {\n  if (!generator.operation) return\n  const context = createMockedPluginContext(opts)\n  const transformedNode = opts.plugin.transformer ? transform(node, opts.plugin.transformer) : node\n  const result = await generator.operation(transformedNode, {\n    ...context,\n    options: opts.options,\n  })\n  await applyHookResult({ result, driver: opts.driver, rendererFactory: generator.renderer })\n}\n\n/**\n * Renders a generator's `operations` method in a test context.\n *\n * @example\n * ```ts\n * await renderGeneratorOperations(classClientGenerator, nodes, { config, adapter, driver, plugin, options, resolver })\n * await matchFiles(driver.fileManager.files)\n * ```\n */\nexport async function renderGeneratorOperations<TOptions extends PluginFactoryOptions>(\n  generator: Generator<TOptions>,\n  nodes: Array<OperationNode>,\n  opts: RenderGeneratorOptions<TOptions>,\n): Promise<void> {\n  if (!generator.operations) return\n  const context = createMockedPluginContext(opts)\n  const transformedNodes = opts.plugin.transformer ? nodes.map((n) => transform(n, opts.plugin.transformer!)) : nodes\n  const result = await generator.operations(transformedNodes, {\n    ...context,\n    options: opts.options,\n  })\n  await applyHookResult({ result, driver: opts.driver, rendererFactory: generator.renderer })\n}\n"],"mappings":"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"}
+{"version":3,"file":"mocks.js","names":[],"sources":["../src/mocks.ts"],"sourcesContent":["import { resolve } from 'node:path'\nimport type { FileNode, InputMeta, OperationNode, SchemaNode, Visitor } from '@kubb/ast'\nimport { transform } from '@kubb/ast'\nimport { FileManager } from './FileManager.ts'\nimport { KubbDriver } from './KubbDriver.ts'\nimport type { Adapter, AdapterFactoryOptions, Config, Generator, GeneratorContext, NormalizedPlugin, PluginFactoryOptions, RendererFactory } from './types.ts'\n\n/**\n\n * Creates a minimal `PluginDriver` mock for unit tests.\n */\nexport function createMockedPluginDriver(options: { name?: string; plugin?: NormalizedPlugin; config?: Config } = {}): KubbDriver {\n  const fileManager = new FileManager()\n\n  return {\n    config: options?.config ?? {\n      root: '.',\n      output: {\n        path: './path',\n      },\n    },\n    getPlugin(_pluginName: string): NormalizedPlugin | undefined {\n      return options?.plugin\n    },\n    getResolver: (_pluginName: string) => options?.plugin?.resolver,\n    fileManager,\n    async dispatch({ result, renderer }: { result: unknown; renderer?: RendererFactory | null }): Promise<void> {\n      if (!result) return\n\n      if (Array.isArray(result)) {\n        fileManager.upsert(...(result as Array<FileNode>))\n        return\n      }\n\n      if (!renderer) return\n\n      using instance = renderer()\n      if (instance.stream) {\n        for (const file of instance.stream(result)) fileManager.upsert(file)\n        return\n      }\n\n      await instance.render(result)\n      fileManager.upsert(...instance.files)\n    },\n  } as unknown as KubbDriver\n}\n\n/**\n * Creates a minimal `Adapter` mock for unit tests.\n * `parse` returns an empty `InputNode` by default. Override via `options.parse`.\n * `getImports` returns `[]` by default.\n */\nexport function createMockedAdapter<TOptions extends AdapterFactoryOptions = AdapterFactoryOptions>(\n  options: {\n    name?: TOptions['name']\n    resolvedOptions?: TOptions['resolvedOptions']\n    parse?: Adapter<TOptions>['parse']\n    getImports?: Adapter<TOptions>['getImports']\n  } = {},\n): Adapter<TOptions> {\n  return {\n    name: (options.name ?? 'oas') as TOptions['name'],\n    options: (options.resolvedOptions ?? {}) as TOptions['resolvedOptions'],\n    parse: options.parse ?? (async () => ({ kind: 'Input' as const, schemas: [], operations: [] })),\n    getImports: options.getImports ?? ((_node: SchemaNode, _resolve: (schemaName: string) => { name: string; path: string }) => []),\n  } as Adapter<TOptions>\n}\n\n/**\n * Creates a minimal plugin mock for unit tests.\n *\n * @example\n * `const plugin = createMockedPlugin<PluginTs>({ name: '@kubb/plugin-ts', options })`\n */\nexport function createMockedPlugin<TOptions extends PluginFactoryOptions = PluginFactoryOptions>(params: {\n  name: TOptions['name']\n  options: TOptions['resolvedOptions']\n  resolver?: TOptions['resolver']\n  transformer?: Visitor\n  dependencies?: Array<string>\n}): NormalizedPlugin<TOptions> {\n  return {\n    name: params.name,\n    options: params.options,\n    resolver: params.resolver,\n    transformer: params.transformer,\n    dependencies: params.dependencies,\n    hooks: {},\n  } as unknown as NormalizedPlugin<TOptions>\n}\n\ntype RenderGeneratorOptions<TOptions extends PluginFactoryOptions> = {\n  config: Config\n  adapter: Adapter\n  meta?: InputMeta\n  driver: KubbDriver\n  plugin: NormalizedPlugin<TOptions>\n  options: TOptions['resolvedOptions']\n  resolver: TOptions['resolver']\n}\n\nfunction createMockedPluginContext<TOptions extends PluginFactoryOptions>(opts: RenderGeneratorOptions<TOptions>): Omit<GeneratorContext<TOptions>, 'options'> {\n  const root = resolve(opts.config.root, opts.config.output.path)\n\n  return {\n    config: opts.config,\n    root,\n    getMode: (output: { path: string }) => KubbDriver.getMode(resolve(root, output.path)),\n    adapter: opts.adapter,\n    resolver: opts.resolver,\n    plugin: opts.plugin,\n    driver: opts.driver,\n    getResolver: (name: string) => opts.driver.getResolver(name),\n    meta: opts.meta ?? { circularNames: [], enumNames: [] },\n    addFile: async (...files: Array<FileNode>) => opts.driver.fileManager.add(...files),\n    upsertFile: async (...files: Array<FileNode>) => opts.driver.fileManager.upsert(...files),\n    hooks: opts.driver.hooks ?? ({} as never),\n    warn: (msg: string) => console.warn(msg),\n    error: (msg: string) => console.error(msg),\n    info: (msg: string) => console.info(msg),\n    openInStudio: async () => {},\n  } as unknown as Omit<GeneratorContext<TOptions>, 'options'>\n}\n\n/**\n * Renders a generator's `schema` method in a test context.\n *\n * @example\n * ```ts\n * await renderGeneratorSchema(typeGenerator, node, { config, adapter, driver, plugin, options, resolver })\n * await matchFiles(driver.fileManager.files)\n * ```\n */\nexport async function renderGeneratorSchema<TOptions extends PluginFactoryOptions>(\n  generator: Generator<TOptions>,\n  node: SchemaNode,\n  opts: RenderGeneratorOptions<TOptions>,\n): Promise<void> {\n  if (!generator.schema) return\n  const context = createMockedPluginContext(opts)\n  const transformedNode = opts.plugin.transformer ? transform(node, opts.plugin.transformer) : node\n  const result = await generator.schema(transformedNode, {\n    ...context,\n    options: opts.options,\n  })\n  await opts.driver.dispatch({ result, renderer: generator.renderer })\n}\n\n/**\n * Renders a generator's `operation` method in a test context.\n *\n * @example\n * ```ts\n * await renderGeneratorOperation(typeGenerator, node, { config, adapter, driver, plugin, options, resolver })\n * await matchFiles(driver.fileManager.files)\n * ```\n */\nexport async function renderGeneratorOperation<TOptions extends PluginFactoryOptions>(\n  generator: Generator<TOptions>,\n  node: OperationNode,\n  opts: RenderGeneratorOptions<TOptions>,\n): Promise<void> {\n  if (!generator.operation) return\n  const context = createMockedPluginContext(opts)\n  const transformedNode = opts.plugin.transformer ? transform(node, opts.plugin.transformer) : node\n  const result = await generator.operation(transformedNode, {\n    ...context,\n    options: opts.options,\n  })\n  await opts.driver.dispatch({ result, renderer: generator.renderer })\n}\n\n/**\n * Renders a generator's `operations` method in a test context.\n *\n * @example\n * ```ts\n * await renderGeneratorOperations(classClientGenerator, nodes, { config, adapter, driver, plugin, options, resolver })\n * await matchFiles(driver.fileManager.files)\n * ```\n */\nexport async function renderGeneratorOperations<TOptions extends PluginFactoryOptions>(\n  generator: Generator<TOptions>,\n  nodes: Array<OperationNode>,\n  opts: RenderGeneratorOptions<TOptions>,\n): Promise<void> {\n  if (!generator.operations) return\n  const context = createMockedPluginContext(opts)\n  const transformedNodes = opts.plugin.transformer ? nodes.map((n) => transform(n, opts.plugin.transformer!)) : nodes\n  const result = await generator.operations(transformedNodes, {\n    ...context,\n    options: opts.options,\n  })\n  await opts.driver.dispatch({ result, renderer: generator.renderer })\n}\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kubb/core",
-  "version": "5.0.0-beta.36",
+  "version": "5.0.0-beta.38",
   "description": "Core engine for Kubb's plugin-based code generation system. Provides the plugin driver, file manager, defineConfig, and build orchestration used by every Kubb plugin.",
   "keywords": [
     "code-generator",
@@ -58,14 +58,14 @@
   "dependencies": {
     "fflate": "^0.8.3",
     "tinyexec": "~1.1.2",
-    "@kubb/ast": "5.0.0-beta.36"
+    "@kubb/ast": "5.0.0-beta.38"
   },
   "devDependencies": {
     "@internals/utils": "0.0.0",
-    "@kubb/renderer-jsx": "5.0.0-beta.36"
+    "@kubb/renderer-jsx": "5.0.0-beta.38"
   },
   "peerDependencies": {
-    "@kubb/renderer-jsx": "5.0.0-beta.36"
+    "@kubb/renderer-jsx": "5.0.0-beta.38"
   },
   "size-limit": [
     {

package/src/FileManager.ts

@@ -1,6 +1,16 @@
+import { AsyncEventEmitter } from '@internals/utils'
 import type { FileNode } from '@kubb/ast'
 import { createFile } from '@kubb/ast'
 
+/**
+ * Hooks fired by a `FileManager`.
+ *
+ * - `upsert` fires once per resolved file added through `add` or `upsert`.
+ */
+export type FileManagerHooks = {
+  upsert: [file: FileNode]
+}
+
 function mergeFile<TMeta extends object = object>(a: FileNode<TMeta>, b: FileNode<TMeta>): FileNode<TMeta> {
   return {
     ...a,
@@ -19,7 +29,7 @@ function isIndexPath(path: string): boolean {
   return path.endsWith('/index.ts') || path === 'index.ts'
 }
 
-// Sort order: shortest path first; within a length bucket, index.ts barrels last.
+// Sort order: shortest path first. Within a length bucket, index.ts barrels last.
 function compareFiles(a: FileNode, b: FileNode): number {
   const lenDiff = a.path.length - b.path.length
   if (lenDiff !== 0) return lenDiff
@@ -43,23 +53,17 @@ function compareFiles(a: FileNode, b: FileNode): number {
  * ```
  */
 export class FileManager {
+  /**
+   * Subscribe to file-store changes. Listeners on `upsert` see each resolved file as it lands
+   * through `add` or `upsert`.
+   */
+  readonly hooks = new AsyncEventEmitter<FileManagerHooks>()
   readonly #cache = new Map<string, FileNode>()
-  // Cached sorted view; null means stale and rebuilt lazily on next `files` read.
+  // Cached sorted view. Null means stale and rebuilt lazily on next `files` read.
   // Nulled (not mutated) on every write so callers holding a prior reference
-  // keep their snapshot — `dispose()` must not silently empty an array the
+  // keep their snapshot, `dispose()` must not silently empty an array the
   // consumer already holds.
   #sorted: Array<FileNode> | null = null
-  #onUpsert: ((file: FileNode) => void) | null = null
-
-  /**
-   * Registers a callback invoked with the resolved {@link FileNode} on every
-   * `add` / `upsert`. Used by the build loop to track newly written files
-   * without keeping its own scan-based diff. Single subscriber by design —
-   * setting again replaces the previous callback. Pass `null` to detach.
-   */
-  setOnUpsert(callback: ((file: FileNode) => void) | null): void {
-    this.#onUpsert = callback
-  }
 
   add(...files: Array<FileNode>): Array<FileNode> {
     return this.#store(files, false)
@@ -78,7 +82,7 @@ export class FileManager {
       const merged = existing && mergeExisting ? createFile(mergeFile(existing, file)) : createFile(file)
       this.#cache.set(merged.path, merged)
       resolved.push(merged)
-      this.#onUpsert?.(merged)
+      this.hooks.emit('upsert', merged)
     }
 
     if (resolved.length > 0) this.#sorted = null
@@ -111,11 +115,12 @@ export class FileManager {
   }
 
   /**
-   * Releases all stored files. Called by the core after `kubb:build:end`.
+   * Releases all stored files and clears every `hooks` listener. Called by the core after
+   * `kubb:build:end`.
    */
   dispose(): void {
     this.clear()
-    this.#onUpsert = null
+    this.hooks.removeAll()
   }
 
   [Symbol.dispose](): void {
@@ -124,7 +129,7 @@ export class FileManager {
 
   /**
    * All stored files in stable sort order (shortest path first, barrel files
-   * last within a length bucket). Returns a cached view — do not mutate.
+   * last within a length bucket). Returns a cached view, do not mutate.
    */
   get files(): Array<FileNode> {
     return (this.#sorted ??= [...this.#cache.values()].sort(compareFiles))

package/src/FileProcessor.ts

@@ -1,19 +1,30 @@
+import { AsyncEventEmitter } from '@internals/utils'
 import type { CodeNode, FileNode } from '@kubb/ast'
 import { extractStringsFromNodes } from '@kubb/ast'
-import { AsyncEventEmitter } from '@internals/utils'
+import { STREAM_FLUSH_EVERY } from './constants.ts'
+import type { Storage } from './createStorage.ts'
 import type { Parser } from './defineParser.ts'
 
-type ParseOptions = {
-  parsers?: Map<FileNode['extname'], Parser>
-  extension?: Record<FileNode['extname'], FileNode['extname'] | ''>
-}
-
-export type FileProcessorEvents = {
+/**
+ * Hooks fired by a `FileProcessor`.
+ *
+ * - `start` opens a batch, from `run` or a queue flush.
+ * - `update` fires once per file as it is converted.
+ * - `end` closes a batch.
+ * - `enqueue` fires for every `enqueue` call.
+ * - `drain` fires when `drain()` empties the queue with no in-flight batch left.
+ */
+export type FileProcessorHooks = {
   start: [files: Array<FileNode>]
   update: [params: { file: FileNode; source?: string; processed: number; total: number; percentage: number }]
   end: [files: Array<FileNode>]
+  enqueue: [file: FileNode]
+  drain: []
 }
 
+/**
+ * Per-file progress record yielded by `stream` and surfaced through the `update` event.
+ */
 export type ParsedFile = {
   file: FileNode
   source: string
@@ -22,28 +33,70 @@ export type ParsedFile = {
   percentage: number
 }
 
+type FileProcessorOptions = {
+  /**
+   * Storage destination for queued writes.
+   */
+  storage: Storage
+  /**
+   * Parsers indexed by file extension.
+   */
+  parsers?: Map<FileNode['extname'], Parser>
+  /**
+   * Output extname per source extname, applied during conversion.
+   */
+  extension?: Record<FileNode['extname'], FileNode['extname'] | ''>
+}
+
 function joinSources(file: FileNode): string {
   const sources = file.sources
   if (sources.length === 0) return ''
   const parts: Array<string> = []
   for (const source of sources) {
-    const s = extractStringsFromNodes(source.nodes as Array<CodeNode>)
-    if (s) parts.push(s)
+    const text = extractStringsFromNodes(source.nodes as Array<CodeNode>)
+    if (text) parts.push(text)
   }
   return parts.join('\n\n')
 }
 
 /**
- * Converts a single file to a string using the registered parsers.
- * Falls back to joining source values when no matching parser is found.
+ * Turns `FileNode`s into source strings and writes them to storage.
  *
- * @internal
+ * Two modes share the same instance. Stateless mode (`parse`, `stream`, `run`) just runs the
+ * conversion. Queue mode (`enqueue`, `flush`, `drain`) buffers files deduped by path and
+ * writes each batch through storage with up to `STREAM_FLUSH_EVERY` requests in flight.
+ *
+ * `flush` does not wait for its batch to finish, so dispatch can overlap with IO. The next
+ * `flush` or `drain` picks the in-flight batch up. `drain` blocks until everything has been
+ * written and is meant for the end of a build.
+ *
+ * To surface build-level hook signals (`kubb:files:processing:*` and friends) subscribe to
+ * `hooks` and re-emit on the kubb bus.
  */
 export class FileProcessor {
-  readonly events = new AsyncEventEmitter<FileProcessorEvents>()
+  readonly hooks = new AsyncEventEmitter<FileProcessorHooks>()
+  readonly #parsers: Map<FileNode['extname'], Parser> | null
+  readonly #storage: Storage
+  readonly #extension: Record<FileNode['extname'], FileNode['extname'] | ''> | null
+  readonly #pending = new Map<string, FileNode>()
+  #runningFlush: Promise<void> | null = null
+
+  constructor(options: FileProcessorOptions) {
+    this.#parsers = options.parsers ?? null
+    this.#storage = options.storage
+    this.#extension = options.extension ?? null
+  }
 
-  parse(file: FileNode, { parsers, extension }: ParseOptions = {}): string {
-    const parseExtName = extension?.[file.extname] || undefined
+  /**
+   * Files waiting in the queue.
+   */
+  get size(): number {
+    return this.#pending.size
+  }
+
+  parse(file: FileNode): string {
+    const parsers = this.#parsers
+    const parseExtName = this.#extension?.[file.extname] || undefined
 
     if (!parsers || !file.extname) {
       return joinSources(file)
@@ -58,36 +111,101 @@ export class FileProcessor {
     return parser.parse(file, { extname: parseExtName })
   }
 
-  *stream(files: ReadonlyArray<FileNode>, options: ParseOptions = {}): Generator<ParsedFile> {
+  *stream(files: ReadonlyArray<FileNode>): Generator<ParsedFile> {
     const total = files.length
     if (total === 0) return
 
     let processed = 0
     for (const file of files) {
-      const source = this.parse(file, options)
+      const source = this.parse(file)
       processed++
 
       yield { file, source, processed, total, percentage: (processed / total) * 100 }
     }
   }
 
-  async run(files: Array<FileNode>, options: ParseOptions = {}): Promise<Array<FileNode>> {
-    await this.events.emit('start', files)
+  async run(files: Array<FileNode>): Promise<Array<FileNode>> {
+    await this.hooks.emit('start', files)
 
-    for (const { file, source, processed, total, percentage } of this.stream(files, options)) {
-      await this.events.emit('update', { file, source, processed, percentage, total })
+    for (const { file, source, processed, total, percentage } of this.stream(files)) {
+      await this.hooks.emit('update', { file, source, processed, percentage, total })
     }
 
-    await this.events.emit('end', files)
+    await this.hooks.emit('end', files)
 
     return files
   }
 
   /**
-   * Clears all registered event listeners.
+   * Adds a file to the next flush. A later `enqueue` for the same path replaces the previous
+   * entry, matching `FileManager.upsert`. Fires the `enqueue` event.
+   */
+  enqueue(file: FileNode): void {
+    this.#pending.set(file.path, file)
+    this.hooks.emit('enqueue', file)
+  }
+
+  /**
+   * Starts processing the queued files. Waits for any previous flush to finish (so two
+   * batches never run together) and then returns without waiting for the new one. The next
+   * `flush` or `drain` picks up the in-flight task.
+   */
+  async flush(): Promise<void> {
+    if (this.#runningFlush) await this.#runningFlush
+    if (this.#pending.size === 0) return
+
+    const batch = [...this.#pending.values()]
+    this.#pending.clear()
+
+    this.#runningFlush = this.#processAndWrite(batch).finally(() => {
+      this.#runningFlush = null
+    })
+  }
+
+  /**
+   * Waits for the in-flight flush and writes any files still queued. Fires the `drain` event
+   * when both are done.
+   */
+  async drain(): Promise<void> {
+    if (this.#runningFlush) await this.#runningFlush
+
+    if (this.#pending.size > 0) {
+      const batch = [...this.#pending.values()]
+      this.#pending.clear()
+      await this.#processAndWrite(batch)
+    }
+
+    await this.hooks.emit('drain')
+  }
+
+  async #processAndWrite(files: Array<FileNode>): Promise<void> {
+    const storage = this.#storage
+
+    await this.hooks.emit('start', files)
+
+    const items = [...this.stream(files)]
+    for (const item of items) {
+      await this.hooks.emit('update', item)
+    }
+
+    const queue: Array<Promise<void>> = []
+    for (const { file, source } of items) {
+      if (source) {
+        queue.push(storage.setItem(file.path, source))
+        if (queue.length >= STREAM_FLUSH_EVERY) await Promise.all(queue.splice(0))
+      }
+    }
+    await Promise.all(queue)
+
+    await this.hooks.emit('end', files)
+  }
+
+  /**
+   * Clears every listener and the pending queue.
    */
   dispose(): void {
-    this.events.removeAll()
+    this.hooks.removeAll()
+    this.#pending.clear()
   }
 
   [Symbol.dispose](): void {

package/src/HookRegistry.ts

@@ -0,0 +1,45 @@
+import type { AsyncEventEmitter } from '@internals/utils'
+
+export type HookSource = 'plugin' | 'middleware' | 'driver'
+
+export type HookListener<TArgs extends Array<unknown>, TResult = void> = (...args: TArgs) => TResult | Promise<TResult>
+
+type AnyEntry = {
+  event: string
+  handler: HookListener<Array<unknown>, unknown>
+  source: HookSource
+}
+
+/**
+ * Listener bookkeeping around an `AsyncEventEmitter`. Listeners attached through `register`
+ * stay on the emitter but are tracked so `dispose()` removes only them, listeners attached
+ * directly via `emitter.on(...)` survive.
+ */
+export class HookRegistry<TEvents extends { [K in keyof TEvents]: Array<unknown> }> {
+  readonly #emitter: AsyncEventEmitter<TEvents>
+  readonly #entries = new Set<AnyEntry>()
+
+  constructor(options: { emitter: AsyncEventEmitter<TEvents> }) {
+    this.#emitter = options.emitter
+  }
+
+  get emitter(): AsyncEventEmitter<TEvents> {
+    return this.#emitter
+  }
+
+  get size(): number {
+    return this.#entries.size
+  }
+
+  register<K extends keyof TEvents & string>(options: { event: K; handler: HookListener<TEvents[K], unknown>; source: HookSource }): void {
+    this.#emitter.on(options.event, options.handler as HookListener<TEvents[K]>)
+    this.#entries.add(options as unknown as AnyEntry)
+  }
+
+  dispose(): void {
+    for (const entry of this.#entries) {
+      this.#emitter.off(entry.event as keyof TEvents & string, entry.handler as HookListener<Array<unknown>>)
+    }
+    this.#entries.clear()
+  }
+}