@kubb/core 5.0.0-beta.82 → 5.0.0-beta.85

package/dist/index.cjs

@@ -1,14 +1,49 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_memoryStorage = require("./memoryStorage-DQ6qXJ8o.cjs");
-let node_crypto = require("node:crypto");
+const require_usingCtx = require("./usingCtx-fxRpJw0P.cjs");
+let node_async_hooks = require("node:async_hooks");
 let node_util = require("node:util");
+let node_crypto = require("node:crypto");
 let node_fs_promises = require("node:fs/promises");
 let node_path = require("node:path");
-node_path = require_memoryStorage.__toESM(node_path, 1);
-let node_async_hooks = require("node:async_hooks");
+node_path = require_usingCtx.__toESM(node_path, 1);
 let _kubb_ast = require("@kubb/ast");
 let node_process = require("node:process");
-node_process = require_memoryStorage.__toESM(node_process, 1);
+node_process = require_usingCtx.__toESM(node_process, 1);
+//#region src/createAdapter.ts
+/**
+* Defines a custom adapter that translates a spec format into Kubb's universal
+* AST, for example GraphQL, gRPC, or AsyncAPI. The built-in `@kubb/adapter-oas`
+* handles OpenAPI/Swagger documents.
+*
+* Adapters must return an `InputNode` from `parse`. That node is what every
+* plugin in the build consumes.
+*
+* @example
+* ```ts
+* import { createAdapter, type AdapterFactoryOptions } from '@kubb/core'
+* import { ast } from '@kubb/ast'
+*
+* type MyAdapter = AdapterFactoryOptions<'my-adapter', { validate?: boolean }>
+*
+* export const myAdapter = createAdapter<MyAdapter>((options) => ({
+*   name: 'my-adapter',
+*   options,
+*   document: null,
+*   async parse(_source) {
+*     // Convert the source (path or inline data) into an InputNode.
+*     return ast.factory.createInput()
+*   },
+*   getImports: () => [],
+*   async validate() {
+*     // Throw here when the spec is invalid.
+*   },
+* }))
+* ```
+*/
+function createAdapter(build) {
+	return (options) => build(options ?? {});
+}
+//#endregion
 //#region ../../internals/utils/src/time.ts
 /**
 * Calculates elapsed time in milliseconds from a high-resolution `process.hrtime` start time.
@@ -92,21 +127,11 @@ const randomColors = [
 */
 function randomCliColor(text) {
 	if (!text) return "";
-	return (0, node_util.styleText)(randomColors[(0, node_crypto.hash)("sha256", text, "buffer").readUInt32BE(0) % randomColors.length] ?? "white", text);
+	const index = (0, node_crypto.hash)("sha256", text, "buffer").readUInt32BE(0) % randomColors.length;
+	return (0, node_util.styleText)(randomColors[index] ?? "white", text);
 }
 //#endregion
 //#region ../../internals/utils/src/promise.ts
-/** Returns `true` when `result` is a thenable `Promise`.
-*
-* @example
-* ```ts
-* isPromise(Promise.resolve(1)) // true
-* isPromise(42)                 // false
-* ```
-*/
-function isPromise(result) {
-	return result !== null && result !== void 0 && typeof result["then"] === "function";
-}
 /**
 * Wraps `factory` with a keyed cache backed by the provided store.
 *
@@ -145,258 +170,116 @@ function memoize(store, factory) {
 		return value;
 	};
 }
-/**
-* Wraps a plain array in a reusable `AsyncIterable`.
-* Each `[Symbol.asyncIterator]()` call returns a fresh generator so the
-* iterable can be consumed multiple times (e.g. once per plugin pre-scan).
-*
-* @example
-* ```ts
-* const stream = arrayToAsyncIterable([1, 2, 3])
-* for await (const n of stream) console.log(n) // 1, 2, 3
-* ```
-*/
-function arrayToAsyncIterable(arr) {
-	return { [Symbol.asyncIterator]() {
-		return (async function* () {
-			yield* arr;
-		})();
-	} };
-}
 //#endregion
-//#region ../../internals/utils/src/reserved.ts
+//#region package.json
+var version = "5.0.0-beta.85";
+//#endregion
+//#region src/constants.ts
 /**
-* JavaScript and Java reserved words.
-* @link https://github.com/jonschlinkert/reserved/blob/master/index.js
+* Plugin `include` filter types that select operations directly. When one of these is set
+* without a `schemaName` include, the generate phase pre-scans operations to compute the set
+* of schemas they reach, so unreachable schemas can be pruned for that plugin.
 */
-const reservedWords = /* @__PURE__ */ new Set([
-	"abstract",
-	"arguments",
-	"boolean",
-	"break",
-	"byte",
-	"case",
-	"catch",
-	"char",
-	"class",
-	"const",
-	"continue",
-	"debugger",
-	"default",
-	"delete",
-	"do",
-	"double",
-	"else",
-	"enum",
-	"eval",
-	"export",
-	"extends",
-	"false",
-	"final",
-	"finally",
-	"float",
-	"for",
-	"function",
-	"goto",
-	"if",
-	"implements",
-	"import",
-	"in",
-	"instanceof",
-	"int",
-	"interface",
-	"let",
-	"long",
-	"native",
-	"new",
-	"null",
-	"package",
-	"private",
-	"protected",
-	"public",
-	"return",
-	"short",
-	"static",
-	"super",
-	"switch",
-	"synchronized",
-	"this",
-	"throw",
-	"throws",
-	"transient",
-	"true",
-	"try",
-	"typeof",
-	"var",
-	"void",
-	"volatile",
-	"while",
-	"with",
-	"yield",
-	"Array",
-	"Date",
-	"hasOwnProperty",
-	"Infinity",
-	"isFinite",
-	"isNaN",
-	"isPrototypeOf",
-	"length",
-	"Math",
-	"name",
-	"NaN",
-	"Number",
-	"Object",
-	"prototype",
-	"String",
-	"toString",
-	"undefined",
-	"valueOf"
+const OPERATION_FILTER_TYPES = /* @__PURE__ */ new Set([
+	"tag",
+	"operationId",
+	"path",
+	"method",
+	"contentType"
 ]);
 /**
-* Returns `true` when `name` is a syntactically valid JavaScript variable name.
-*
-* @example
-* ```ts
-* isValidVarName('status')  // true
-* isValidVarName('class')   // false (reserved word)
-* isValidVarName('42foo')   // false (starts with digit)
-* ```
+* Stable codes Kubb attaches to a `Diagnostic`. Each maps to a known failure mode
+* and stays stable so it can be referenced in tooling and (later) docs. Reference
+* these instead of inlining the string at a throw site.
 */
-function isValidVarName(name) {
-	if (!name || reservedWords.has(name)) return false;
-	return isIdentifier(name);
-}
-/**
-* Returns `true` when `name` is syntactically a valid identifier, ignoring reserved words.
-*
-* Reserved words and globals (`class`, `name`, `Date`, …) are valid as bare object-literal keys
-* even though they are not valid variable names, so use this (not {@link isValidVarName}) when
-* deciding whether an object key needs quoting.
-*
-* @example
-* ```ts
-* isIdentifier('name')   // true
-* isIdentifier('x-total')// false
-* ```
-*/
-function isIdentifier(name) {
-	return /^[a-zA-Z_$][a-zA-Z0-9_$]*$/.test(name);
-}
-//#endregion
-//#region ../../internals/utils/src/url.ts
-function transformParam(raw, casing) {
-	const param = isValidVarName(raw) ? raw : require_memoryStorage.camelCase(raw);
-	return casing === "camelcase" ? require_memoryStorage.camelCase(param) : param;
-}
-function toParamsObject(path, { replacer, casing } = {}) {
-	const params = {};
-	for (const match of path.matchAll(/\{([^}]+)\}/g)) {
-		const param = transformParam(match[1], casing);
-		const key = replacer ? replacer(param) : param;
-		params[key] = key;
-	}
-	return Object.keys(params).length > 0 ? params : null;
-}
-/**
-* Helpers for OpenAPI/Swagger paths, plus a thin wrapper over the native `URL`.
-*/
-var Url = class Url {
+const diagnosticCode = {
 	/**
-	* Converts an OpenAPI/Swagger path to Express-style colon syntax.
-	*
-	* @example
-	* Url.toPath('/pet/{petId}') // '/pet/:petId'
+	* Fallback for an unstructured error with no specific code.
 	*/
-	static toPath(path) {
-		return path.replace(/\{([^}]+)\}/g, ":$1");
-	}
+	unknown: "KUBB_UNKNOWN",
 	/**
-	* Converts an OpenAPI/Swagger path to a TypeScript template literal string.
-	* `prefix` is prepended inside the literal, `replacer` transforms each parameter name,
-	* and `casing` controls parameter identifier casing.
-	*
-	* @example
-	* Url.toTemplateString('/pet/{petId}') // '`/pet/${petId}`'
-	*
-	* @example
-	* Url.toTemplateString('/pet/{petId}', { prefix: 'https://api' }) // '`https://api/pet/${petId}`'
+	* The `input.path` file or URL could not be read.
 	*/
-	static toTemplateString(path, { prefix, replacer, casing } = {}) {
-		const result = path.split(/\{([^}]+)\}/).map((part, i) => {
-			if (i % 2 === 0) return part;
-			const param = transformParam(part, casing);
-			return `\${${replacer ? replacer(param) : param}}`;
-		}).join("");
-		return `\`${prefix ?? ""}${result}\``;
-	}
+	inputNotFound: "KUBB_INPUT_NOT_FOUND",
 	/**
-	* Returns the path and its extracted params as a structured `URLObject`, or as a stringified
-	* expression when `stringify` is set.
-	*
-	* @example
-	* Url.toObject('/pet/{petId}')
-	* // { url: '/pet/:petId', params: { petId: 'petId' } }
-	*/
-	static toObject(path, { type = "path", replacer, stringify, casing } = {}) {
-		const object = {
-			url: type === "path" ? Url.toPath(path) : Url.toTemplateString(path, {
-				replacer,
-				casing
-			}),
-			params: toParamsObject(path, {
-				replacer,
-				casing
-			})
-		};
-		if (stringify) {
-			if (type === "template") return JSON.stringify(object).replaceAll("'", "").replaceAll(`"`, "");
-			if (object.params) return `{ url: '${object.url}', params: ${JSON.stringify(object.params).replaceAll("'", "").replaceAll(`"`, "")} }`;
-			return `{ url: '${object.url}' }`;
-		}
-		return object;
-	}
+	* An adapter was configured without an `input`.
+	*/
+	inputRequired: "KUBB_INPUT_REQUIRED",
+	/**
+	* A `$ref` (or equivalent reference) could not be resolved in the source document.
+	*/
+	refNotFound: "KUBB_REF_NOT_FOUND",
+	/**
+	* A server variable value is not allowed by its `enum`.
+	*/
+	invalidServerVariable: "KUBB_INVALID_SERVER_VARIABLE",
+	/**
+	* A required plugin is missing from the config.
+	*/
+	pluginNotFound: "KUBB_PLUGIN_NOT_FOUND",
+	/**
+	* A plugin threw while generating.
+	*/
+	pluginFailed: "KUBB_PLUGIN_FAILED",
+	/**
+	* A plugin reported a non-fatal warning through `ctx.warn`.
+	*/
+	pluginWarning: "KUBB_PLUGIN_WARNING",
+	/**
+	* A plugin reported an informational message through `ctx.info`.
+	*/
+	pluginInfo: "KUBB_PLUGIN_INFO",
+	/**
+	* A schema uses a `format` Kubb does not map to a specific type. Reserved for
+	* adapters to emit as a `warning`.
+	*/
+	unsupportedFormat: "KUBB_UNSUPPORTED_FORMAT",
+	/**
+	* A referenced schema or operation is marked `deprecated`. Reserved for adapters
+	* to emit as an `info`.
+	*/
+	deprecated: "KUBB_DEPRECATED",
+	/**
+	* An adapter is required but the config has none. The build cannot read the input
+	* without one.
+	*/
+	adapterRequired: "KUBB_ADAPTER_REQUIRED",
+	/**
+	* A resolved output path escapes the output directory, which can stem from a path
+	* traversal in the spec or a misconfigured `group.name`.
+	*/
+	pathTraversal: "KUBB_PATH_TRAVERSAL",
+	/**
+	* A plugin's options are invalid, for example `output.mode: 'file'` paired with a `group` option.
+	*/
+	invalidPluginOptions: "KUBB_INVALID_PLUGIN_OPTIONS",
+	/**
+	* A post-generate shell hook (`hooks.done`) exited with a failure.
+	*/
+	hookFailed: "KUBB_HOOK_FAILED",
+	/**
+	* The formatter pass over the generated files failed.
+	*/
+	formatFailed: "KUBB_FORMAT_FAILED",
+	/**
+	* The linter pass over the generated files failed.
+	*/
+	lintFailed: "KUBB_LINT_FAILED",
+	/**
+	* Not a failure. Carries a plugin's elapsed time, summed into the run total.
+	*/
+	performance: "KUBB_PERFORMANCE",
+	/**
+	* Not a failure. A newer Kubb version is available on npm.
+	*/
+	updateAvailable: "KUBB_UPDATE_AVAILABLE"
 };
 //#endregion
-//#region src/createAdapter.ts
-/**
-* Defines a custom adapter that translates a spec format into Kubb's universal
-* AST, for example GraphQL, gRPC, or AsyncAPI. The built-in `@kubb/adapter-oas`
-* handles OpenAPI/Swagger documents.
-*
-* Adapters must return an `InputNode` from `parse`. That node is what every
-* plugin in the build consumes.
-*
-* @example
-* ```ts
-* import { createAdapter, type AdapterFactoryOptions } from '@kubb/core'
-* import { ast } from '@kubb/ast'
-*
-* type MyAdapter = AdapterFactoryOptions<'my-adapter', { validate?: boolean }>
-*
-* export const myAdapter = createAdapter<MyAdapter>((options) => ({
-*   name: 'my-adapter',
-*   options,
-*   document: null,
-*   async parse(_source) {
-*     // Convert the source (path or inline data) into an InputNode.
-*     return ast.factory.createInput()
-*   },
-*   getImports: () => [],
-*   async validate() {
-*     // Throw here when the spec is invalid.
-*   },
-* }))
-* ```
-*/
-function createAdapter(build) {
-	return (options) => build(options ?? {});
-}
-//#endregion
-//#region src/diagnostics.ts
+//#region src/Diagnostics.ts
 /**
 * Docs major version, derived from the package version so the link tracks the published major.
 */
-const docsMajor = "5.0.0-beta.82".split(".")[0] ?? "5";
+const docsMajor = version.split(".")[0] ?? "5";
 /**
 * Narrows a {@link Diagnostic} to the variant for `code`, or `null` when it does not match.
 *
@@ -454,106 +337,106 @@ const isUpdate = isKind("update");
 * blue info).
 */
 const severityStyle = {
-	error: { color: "red" },
-	warning: { color: "yellow" },
-	info: { color: "blue" }
+	error: "red",
+	warning: "yellow",
+	info: "blue"
 };
 /**
 * Explanation for every {@link diagnosticCode}. Use {@link Diagnostics.explain} to look one up
 * and `Diagnostics.docsUrl` for the matching kubb.dev page.
 */
 const diagnosticCatalog = {
-	[require_memoryStorage.diagnosticCode.unknown]: {
+	[diagnosticCode.unknown]: {
 		title: "Unknown error",
 		cause: "An error was thrown without a stable Kubb code, so it is reported as-is.",
 		fix: "Read the underlying message and stack. If it comes from a plugin or adapter, check its configuration; otherwise report it as a possible Kubb bug."
 	},
-	[require_memoryStorage.diagnosticCode.inputNotFound]: {
+	[diagnosticCode.inputNotFound]: {
 		title: "Input not found",
 		cause: "The file or URL set in `input.path` (or passed as `kubb generate PATH`) could not be read.",
 		fix: "Check that the path or URL exists and is readable, then set it in `input.path` or pass it on the CLI."
 	},
-	[require_memoryStorage.diagnosticCode.inputRequired]: {
+	[diagnosticCode.inputRequired]: {
 		title: "Input required",
 		cause: "An adapter is configured but no `input` was provided.",
 		fix: "Set `input.path` (a file or URL) or `input.data` (an inline spec) in your Kubb config."
 	},
-	[require_memoryStorage.diagnosticCode.refNotFound]: {
+	[diagnosticCode.refNotFound]: {
 		title: "Reference not found",
 		cause: "A `$ref` could not be resolved in the source document.",
 		fix: "Add the missing definition (for example under `components.schemas`) or fix the `$ref`. Run `kubb validate` to check the spec."
 	},
-	[require_memoryStorage.diagnosticCode.invalidServerVariable]: {
+	[diagnosticCode.invalidServerVariable]: {
 		title: "Invalid server variable",
 		cause: "A server variable value is not allowed by its `enum`.",
 		fix: "Use one of the values listed in the server variable `enum`, or update the spec."
 	},
-	[require_memoryStorage.diagnosticCode.pluginNotFound]: {
+	[diagnosticCode.pluginNotFound]: {
 		title: "Plugin not found",
 		cause: "A plugin that another plugin depends on is missing from the config.",
 		fix: "Add the required plugin to the `plugins` array in kubb.config.ts, or remove the dependency on it."
 	},
-	[require_memoryStorage.diagnosticCode.pluginFailed]: {
+	[diagnosticCode.pluginFailed]: {
 		title: "Plugin failed",
 		cause: "A plugin threw while generating, or reported an error through `ctx.error`.",
 		fix: "Read the underlying error and check the plugin options and the schema or operation it failed on."
 	},
-	[require_memoryStorage.diagnosticCode.pluginWarning]: {
+	[diagnosticCode.pluginWarning]: {
 		title: "Plugin warning",
 		cause: "A plugin reported a non-fatal warning through `ctx.warn`.",
 		fix: "Review the message. It does not fail the build; adjust the plugin options or input if the warning is unwanted."
 	},
-	[require_memoryStorage.diagnosticCode.pluginInfo]: {
+	[diagnosticCode.pluginInfo]: {
 		title: "Plugin info",
 		cause: "A plugin reported an informational message through `ctx.info`.",
 		fix: "Informational only. No action is required."
 	},
-	[require_memoryStorage.diagnosticCode.unsupportedFormat]: {
+	[diagnosticCode.unsupportedFormat]: {
 		title: "Unsupported format",
 		cause: "A schema uses a `format` Kubb does not map to a specific type, so it falls back to the base type.",
 		fix: "Use a format Kubb supports, or handle the custom format with a parser or plugin."
 	},
-	[require_memoryStorage.diagnosticCode.deprecated]: {
+	[diagnosticCode.deprecated]: {
 		title: "Deprecated",
 		cause: "A referenced schema or operation is marked `deprecated`.",
 		fix: "Migrate off the deprecated definition if the warning is unwanted."
 	},
-	[require_memoryStorage.diagnosticCode.adapterRequired]: {
+	[diagnosticCode.adapterRequired]: {
 		title: "Adapter required",
 		cause: "An action needs an adapter but none is configured.",
 		fix: "Set `adapter` in kubb.config.ts, for example `adapterOas()`."
 	},
-	[require_memoryStorage.diagnosticCode.pathTraversal]: {
+	[diagnosticCode.pathTraversal]: {
 		title: "Path traversal",
 		cause: "A resolved output path escaped the output directory, which can stem from a path traversal in the spec or a misconfigured `group.name`.",
 		fix: "Keep generated paths within the output directory. Review the `group.name` function and the names coming from the spec."
 	},
-	[require_memoryStorage.diagnosticCode.invalidPluginOptions]: {
+	[diagnosticCode.invalidPluginOptions]: {
 		title: "Invalid plugin options",
 		cause: "A plugin was configured with options that cannot be honored, for example `output.mode: 'file'` paired with a `group` option.",
 		fix: "Fix the plugin options. A single-file output has nothing to group, so remove the `group` option or use `output.mode: 'directory'`."
 	},
-	[require_memoryStorage.diagnosticCode.hookFailed]: {
+	[diagnosticCode.hookFailed]: {
 		title: "Hook failed",
 		cause: "A post-generate shell hook (`hooks.done`) exited with a non-zero status.",
 		fix: "Check the command is installed and correct, and run it manually to see the error."
 	},
-	[require_memoryStorage.diagnosticCode.formatFailed]: {
+	[diagnosticCode.formatFailed]: {
 		title: "Format failed",
 		cause: "The formatter pass over the generated files failed.",
 		fix: "Check the formatter (oxfmt, biome, or prettier) is installed and its config is valid, then run it manually on the output."
 	},
-	[require_memoryStorage.diagnosticCode.lintFailed]: {
+	[diagnosticCode.lintFailed]: {
 		title: "Lint failed",
 		cause: "The linter pass over the generated files failed.",
 		fix: "Check the linter (oxlint, biome, or eslint) is installed and its config is valid, then run it manually on the output."
 	},
-	[require_memoryStorage.diagnosticCode.performance]: {
+	[diagnosticCode.performance]: {
 		title: "Performance",
 		cause: "Not a failure. Records a plugin’s elapsed time, summed into the run total.",
 		fix: "No action. This is an informational metric."
 	},
-	[require_memoryStorage.diagnosticCode.updateAvailable]: {
+	[diagnosticCode.updateAvailable]: {
 		title: "Update available",
 		cause: "A newer Kubb version is published on npm than the one running.",
 		fix: "Update the `@kubb/*` packages, for example `npm install -g @kubb/cli`, to get the latest fixes."
@@ -565,15 +448,15 @@ const diagnosticCatalog = {
 *
 * The sink lives in a single `AsyncLocalStorage` in the `@kubb/core` bundle.
 * `Diagnostics.scope` activates it for a run, so anything inside that run (the
-* adapter parse, a lazily consumed stream, a generator) reports through
-* `Diagnostics.report` and lands in the same run.
+* adapter parse, a generator) reports through `Diagnostics.report` and lands
+* in the same run.
 */
 var Diagnostics = class Diagnostics {
 	static #reporterStorage = new node_async_hooks.AsyncLocalStorage();
 	/**
 	* The diagnostic code catalog, exposed as `Diagnostics.code` (e.g. `Diagnostics.code.refNotFound`).
 	*/
-	static code = require_memoryStorage.diagnosticCode;
+	static code = diagnosticCode;
 	/**
 	* Type guard for a build {@link ProblemDiagnostic}.
 	*/
@@ -658,9 +541,9 @@ var Diagnostics = class Diagnostics {
 			current = current.cause;
 		}
 		return {
-			code: require_memoryStorage.diagnosticCode.unknown,
+			code: diagnosticCode.unknown,
 			severity: "error",
-			message: root ? root.message : require_memoryStorage.getErrorMessage(error),
+			message: root ? root.message : require_usingCtx.getErrorMessage(error),
 			cause: root
 		};
 	}
@@ -670,7 +553,7 @@ var Diagnostics = class Diagnostics {
 	static performance({ plugin, duration }) {
 		return {
 			kind: "performance",
-			code: require_memoryStorage.diagnosticCode.performance,
+			code: diagnosticCode.performance,
 			severity: "info",
 			message: `${plugin} generated in ${Math.round(duration)}ms`,
 			plugin,
@@ -683,7 +566,7 @@ var Diagnostics = class Diagnostics {
 	static update({ currentVersion, latestVersion }) {
 		return {
 			kind: "update",
-			code: require_memoryStorage.diagnosticCode.updateAvailable,
+			code: diagnosticCode.updateAvailable,
 			severity: "info",
 			message: `Update available: v${currentVersion} → v${latestVersion}. Run \`npm install -g @kubb/cli\` to update.`,
 			currentVersion,
@@ -752,7 +635,8 @@ var Diagnostics = class Diagnostics {
 	* `KUBB_REF_NOT_FOUND` → `https://kubb.dev/docs/5.x/reference/diagnostics/kubb-ref-not-found`.
 	*/
 	static docsUrl(code) {
-		return `https://kubb.dev/docs/${docsMajor}.x/reference/diagnostics/${code.toLowerCase().replaceAll("_", "-")}`;
+		const slug = code.toLowerCase().replaceAll("_", "-");
+		return `https://kubb.dev/docs/${docsMajor}.x/reference/diagnostics/${slug}`;
 	}
 	/**
 	* The catalog entry for a code: its title, cause, and fix. Mirrors the kubb.dev
@@ -775,7 +659,7 @@ var Diagnostics = class Diagnostics {
 			...problem?.location ? { location: problem.location } : {},
 			...problem?.help ? { help: problem.help } : {},
 			...problem?.plugin ? { plugin: problem.plugin } : {},
-			...diagnostic.code === require_memoryStorage.diagnosticCode.unknown ? {} : { docsUrl: Diagnostics.docsUrl(diagnostic.code) }
+			...diagnostic.code === diagnosticCode.unknown ? {} : { docsUrl: Diagnostics.docsUrl(diagnostic.code) }
 		};
 	}
 	/**
@@ -788,14 +672,14 @@ var Diagnostics = class Diagnostics {
 	*/
 	static format(diagnostic) {
 		const { code, severity, message } = diagnostic;
-		const { color } = severityStyle[severity];
+		const color = severityStyle[severity];
 		const problem = isProblem(diagnostic) ? diagnostic : void 0;
 		const tag = (0, node_util.styleText)(color, (0, node_util.styleText)("bold", `[${code}]`));
 		const headline = problem?.plugin ? `${tag} ${problem.plugin}: ${message}` : `${tag}: ${message}`;
 		const details = [];
 		if (problem?.location && "pointer" in problem.location) details.push(`  ${(0, node_util.styleText)("dim", "at:")} ${(0, node_util.styleText)("cyan", problem.location.pointer)}`);
 		if (problem?.help) details.push(`  ${(0, node_util.styleText)("cyan", "fix:")} ${problem.help}`);
-		if (code !== require_memoryStorage.diagnosticCode.unknown) details.push(`  ${(0, node_util.styleText)("dim", "see:")} ${(0, node_util.styleText)("cyan", Diagnostics.docsUrl(code))}`);
+		if (code !== diagnosticCode.unknown) details.push(`  ${(0, node_util.styleText)("dim", "see:")} ${(0, node_util.styleText)("cyan", Diagnostics.docsUrl(code))}`);
 		return {
 			headline,
 			details
@@ -820,7 +704,7 @@ var Diagnostics = class Diagnostics {
 function normalizeOutput({ output, group, pluginName }) {
 	const mode = output.mode ?? "directory";
 	if (mode === "file" && group) throw new Diagnostics.Error({
-		code: require_memoryStorage.diagnosticCode.invalidPluginOptions,
+		code: diagnosticCode.invalidPluginOptions,
 		severity: "error",
 		message: `Plugin "${pluginName}" sets \`output.mode: 'file'\` but also configures a \`group\` option.`,
 		help: "A single-file output has nothing to group. Remove the `group` option, or use `output.mode: 'directory'` to organize files into subdirectories.",
@@ -858,412 +742,284 @@ function definePlugin(factory) {
 	return (options) => factory(options ?? {});
 }
 //#endregion
-//#region src/defineResolver.ts
-/**
-* Merges document `meta` with per-file `file` context into the `BannerMeta` passed to a
-* `banner`/`footer` function. Missing fields default to empty/`false` so the object shape
-* is stable even when a caller (e.g. the barrel plugin) has no document metadata.
-*/
-function buildBannerMeta({ meta, file }) {
-	return {
-		title: meta?.title,
-		description: meta?.description,
-		version: meta?.version,
-		baseURL: meta?.baseURL,
-		circularNames: meta?.circularNames ?? [],
-		enumNames: meta?.enumNames ?? [],
-		filePath: file?.path ?? "",
-		baseName: file?.baseName ?? "",
-		isBarrel: file?.isBarrel ?? false,
-		isAggregation: file?.isAggregation ?? false
-	};
-}
-const stringPatternCache = /* @__PURE__ */ new Map();
-function testPattern(value, pattern) {
-	if (typeof pattern === "string") {
-		let regex = stringPatternCache.get(pattern);
-		if (!regex) {
-			regex = new RegExp(pattern);
-			stringPatternCache.set(pattern, regex);
-		}
-		return regex.test(value);
-	}
-	return value.match(pattern) !== null;
+//#region src/createResolver.ts
+function isNamespace(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 /**
-* Checks if an operation matches a pattern for a given filter type (`tag`, `operationId`, `path`, `method`).
-*/
-function matchesOperationPattern(node, type, pattern) {
-	if (type === "tag") return node.tags.some((tag) => testPattern(tag, pattern));
-	if (type === "operationId") return testPattern(node.operationId, pattern);
-	if (type === "path") return node.path !== void 0 && testPattern(node.path, pattern);
-	if (type === "method") return node.method !== void 0 && testPattern(node.method.toLowerCase(), pattern);
-	if (type === "contentType") return node.requestBody?.content?.some((c) => testPattern(c.contentType, pattern)) ?? false;
-	return false;
-}
-/**
-* Checks if a schema matches a pattern for a given filter type (`schemaName`).
-*
-* Returns `null` when the filter type doesn't apply to schemas.
-*/
-function matchesSchemaPattern(node, type, pattern) {
-	if (type === "schemaName") return node.name ? testPattern(node.name, pattern) : false;
-	return null;
-}
-/**
-* Default name resolver used by `defineResolver`.
+* Base constraint for all plugin resolver objects.
 *
-* - `camelCase` for `file`, with dotted names split into `/`-joined nested paths.
-* - `PascalCase` for `type`.
-* - `camelCase` for `function` and everything else.
-*/
-function defaultResolver(name, type) {
-	if (type === "file") return require_memoryStorage.toFilePath(name);
-	if (type === "type") return require_memoryStorage.pascalCase(name);
-	return require_memoryStorage.camelCase(name);
-}
-/**
-* Default option resolver. Applies include/exclude filters and merges matching override options.
-*
-* Returns `null` when the node is filtered out by an `exclude` rule or not matched by any `include` rule.
+* The built-in machinery lives under `default`. Generators call the top-level `name` and
+* `file`, and a plugin overrides them to set its conventions. Extend with top-level helpers
+* (`typeName`, …) and/or grouped namespaces (`query`, `schema`, …).
 *
-* @example Include/exclude filtering
+* @example Top-level helper
 * ```ts
-* const options = defaultResolveOptions(operationNode, {
-*   options: { output: 'types' },
-*   exclude: [{ type: 'tag', pattern: 'internal' }],
-* })
-* // → null when node has tag 'internal'
+* type MyResolver = Resolver & {
+*   typeName(name: string): string
+* }
 * ```
 *
-* @example Override merging
+* @example Grouped namespace
 * ```ts
-* const options = defaultResolveOptions(operationNode, {
-*   options: { enumType: 'asConst' },
-*   override: [{ type: 'operationId', pattern: 'listPets', options: { enumType: 'enum' } }],
-* })
-* // → { enumType: 'enum' } when operationId matches
+* type MyResolver = Resolver & {
+*   query: {
+*     name(node: OperationNode): string
+*     keyName(node: OperationNode): string
+*   }
+* }
 * ```
 */
-const resolveOptionsCache = /* @__PURE__ */ new WeakMap();
-function computeOptions(node, options, exclude, include, override) {
-	if (_kubb_ast.operationDef.is(node)) {
-		if (exclude.some(({ type, pattern }) => matchesOperationPattern(node, type, pattern))) return null;
-		if (include && !include.some(({ type, pattern }) => matchesOperationPattern(node, type, pattern))) return null;
-		const overrideOptions = override.find(({ type, pattern }) => matchesOperationPattern(node, type, pattern))?.options;
+var Resolver = class Resolver {
+	static #patternCache = /* @__PURE__ */ new Map();
+	static #optionsCache = /* @__PURE__ */ new WeakMap();
+	pluginName;
+	#options;
+	constructor(options) {
+		this.pluginName = options.pluginName;
+		this.#options = options;
+		this.#apply(options);
+	}
+	/**
+	* The built-in resolution machinery. Always reaches the untouched defaults, even when a
+	* plugin overrides the top-level `name` or `file`.
+	*/
+	get default() {
 		return {
-			...options,
-			...overrideOptions
+			name: require_usingCtx.camelCase,
+			options: this.#resolveOptions.bind(this),
+			path: this.#resolvePath.bind(this),
+			file: this.#resolveFile.bind(this),
+			banner: this.#resolveBanner.bind(this),
+			footer: this.#resolveFooter.bind(this)
 		};
 	}
-	if (_kubb_ast.schemaDef.is(node)) {
-		if (exclude.some(({ type, pattern }) => matchesSchemaPattern(node, type, pattern) === true)) return null;
-		if (include) {
-			const applicable = include.map(({ type, pattern }) => matchesSchemaPattern(node, type, pattern)).filter((result) => result !== null);
-			if (applicable.length > 0 && !applicable.includes(true)) return null;
+	name(name) {
+		return this.default.name(name);
+	}
+	file(params, context) {
+		return this.default.file(params, context);
+	}
+	/**
+	* Merges `override` over `base` and returns a new resolver with helpers re-bound.
+	* Each key is replaced wholesale. Used when applying `setResolver` partial overrides.
+	*/
+	static merge(base, override) {
+		const patch = override instanceof Resolver ? override.#options : override;
+		return createResolver({
+			...base.#options,
+			...patch
+		});
+	}
+	/**
+	* Binds each entry of `options` onto the resolver, so `this.name`, `this.default`, and
+	* `this.file` resolve there for top-level helpers and namespace methods alike. `default`
+	* is skipped so it can't be shadowed.
+	*/
+	#apply(options) {
+		const root = this;
+		const bind = (value) => typeof value === "function" ? value.bind(root) : value;
+		for (const [key, value] of Object.entries(options)) {
+			if (key === "pluginName" || key === "default" || value === void 0) continue;
+			root[key] = isNamespace(value) ? Object.fromEntries(Object.entries(value).map(([method, member]) => [method, bind(member)])) : bind(value);
 		}
-		const overrideOptions = override.find(({ type, pattern }) => matchesSchemaPattern(node, type, pattern) === true)?.options;
-		return {
-			...options,
-			...overrideOptions
-		};
 	}
-	return options;
-}
-function defaultResolveOptions(node, { options, exclude = [], include, override = [] }) {
-	if (typeof options !== "object" || options === null) return computeOptions(node, options, exclude, include, override);
-	let byOptions = resolveOptionsCache.get(options);
-	if (!byOptions) {
-		byOptions = /* @__PURE__ */ new WeakMap();
-		resolveOptionsCache.set(options, byOptions);
-	}
-	const cached = byOptions.get(node);
-	if (cached !== void 0) return cached.value;
-	const result = computeOptions(node, options, exclude, include, override);
-	byOptions.set(node, { value: result });
-	return result;
-}
-/**
-* Default path resolver used by `defineResolver`.
-*
-* - `mode: 'file'` resolves directly to `output.path` (the full file path, extension included).
-* - `mode: 'directory'` (default) resolves to `output.path/{baseName}`, or into a
-*   subdirectory when `group` and a `tag`/`path` value are provided.
-*
-* A custom `group.name` function overrides the default subdirectory naming.
-* For `tag` groups the default is the camelCased tag.
-* For `path` groups the default is the first path segment after `/`.
-*
-* @example Flat output
-* ```ts
-* defaultResolvePath({ baseName: 'petTypes.ts' }, { root: '/src', output: { path: 'types' } })
-* // → '/src/types/petTypes.ts'
-* ```
-*
-* @example Tag-based grouping
-* ```ts
-* defaultResolvePath(
-*   { baseName: 'petTypes.ts', tag: 'pets' },
-*   { root: '/src', output: { path: 'types' }, group: { type: 'tag' } },
-* )
-* // → '/src/types/pets/petTypes.ts'
-* ```
-*
-* @example Path-based grouping
-* ```ts
-* defaultResolvePath(
-*   { baseName: 'petTypes.ts', path: '/pets/list' },
-*   { root: '/src', output: { path: 'types' }, group: { type: 'path' } },
-* )
-* // → '/src/types/pets/petTypes.ts'
-* ```
-*
-* @example Single file (`mode: 'file'`)
-* ```ts
-* defaultResolvePath(
-*   { baseName: 'petTypes.ts' },
-*   { root: '/src', output: { path: 'types.ts', mode: 'file' } },
-* )
-* // → '/src/types.ts'
-* ```
-*/
-function defaultResolvePath({ baseName, tag, path: groupPath }, { root, output, group }) {
-	if ((output.mode ?? "directory") === "file") return node_path.default.resolve(root, output.path);
-	const result = (() => {
-		if (group && (groupPath || tag)) {
-			const groupValue = group.type === "path" ? groupPath : tag;
-			const defaultName = group.type === "tag" ? ({ group: groupName }) => require_memoryStorage.camelCase(groupName) : ({ group: groupName }) => {
-				const segment = groupName.split("/").filter((part) => part !== "" && part !== "." && part !== "..")[0];
-				return segment ? require_memoryStorage.camelCase(segment) : "";
+	static #testPattern(value, pattern) {
+		if (typeof pattern === "string") {
+			let regex = Resolver.#patternCache.get(pattern);
+			regex ??= new RegExp(pattern);
+			Resolver.#patternCache.set(pattern, regex);
+			return regex.test(value);
+		}
+		return value.match(pattern) !== null;
+	}
+	static #matchesOperation(node, { type, pattern }) {
+		if (type === "tag") return node.tags.some((tag) => Resolver.#testPattern(tag, pattern));
+		if (type === "operationId") return Resolver.#testPattern(node.operationId, pattern);
+		if (type === "path") return node.path !== void 0 && Resolver.#testPattern(node.path, pattern);
+		if (type === "method") return node.method !== void 0 && Resolver.#testPattern(node.method.toLowerCase(), pattern);
+		if (type === "contentType") return node.requestBody?.content?.some((c) => Resolver.#testPattern(c.contentType, pattern)) ?? false;
+		return false;
+	}
+	/**
+	* Returns `null` when the filter type doesn't apply to schemas, so include rules built
+	* from operation filters (e.g. `tag`) don't exclude every schema.
+	*/
+	static #matchesSchema(node, { type, pattern }) {
+		if (type === "schemaName") return node.name ? Resolver.#testPattern(node.name, pattern) : false;
+		return null;
+	}
+	static #computeOptions(node, { options, exclude = [], include, override = [] }) {
+		if (_kubb_ast.operationDef.is(node)) {
+			if (exclude.some((filter) => Resolver.#matchesOperation(node, filter))) return null;
+			if (include && !include.some((filter) => Resolver.#matchesOperation(node, filter))) return null;
+			return {
+				...options,
+				...override.find((filter) => Resolver.#matchesOperation(node, filter))?.options
 			};
-			const groupName = (group.name ?? defaultName)({ group: groupValue });
-			return node_path.default.resolve(root, output.path, groupName, baseName);
 		}
-		return node_path.default.resolve(root, output.path, baseName);
-	})();
-	const outputDir = node_path.default.resolve(root, output.path);
-	const outputDirWithSep = outputDir.endsWith(node_path.default.sep) ? outputDir : `${outputDir}${node_path.default.sep}`;
-	if (result !== outputDir && !result.startsWith(outputDirWithSep)) throw new Diagnostics.Error({
-		code: Diagnostics.code.pathTraversal,
-		severity: "error",
-		message: `Resolved path "${result}" is outside the output directory "${outputDir}".`,
-		help: "This can stem from a path traversal in the OpenAPI specification or a misconfigured `group.name` function. Keep generated paths within the output directory.",
-		location: { kind: "config" }
-	});
-	return result;
-}
-/**
-* Default file resolver used by `defineResolver`.
-*
-* Resolves a `FileNode` by combining name resolution (`resolver.default`) with
-* path resolution (`resolver.resolvePath`). The resolved file always has empty
-* `sources`, `imports`, and `exports` arrays, which consumers populate separately.
-*
-* In `mode: 'file'` the name is omitted and the file sits directly at the output path.
-*
-* @example Resolve a schema file
-* ```ts
-* const file = defaultResolveFile.call(
-*   resolver,
-*   { name: 'pet', extname: '.ts' },
-*   { root: '/src', output: { path: 'types' } },
-* )
-* // → { baseName: 'pet.ts', path: '/src/types/pet.ts', sources: [], ... }
-* ```
-*
-* @example Resolve an operation file with tag grouping
-* ```ts
-* const file = defaultResolveFile.call(
-*   resolver,
-*   { name: 'listPets', extname: '.ts', tag: 'pets' },
-*   { root: '/src', output: { path: 'types' }, group: { type: 'tag' } },
-* )
-* // → { baseName: 'listPets.ts', path: '/src/types/pets/listPets.ts', ... }
-* ```
-*/
-function defaultResolveFile({ name, extname, tag, path: groupPath }, context) {
-	const baseName = `${(context.output.mode ?? "directory") === "file" ? "" : this.default(name, "file")}${extname}`;
-	const filePath = this.resolvePath({
-		baseName,
-		tag,
-		path: groupPath
-	}, context);
-	return _kubb_ast.ast.factory.createFile({
-		path: filePath,
-		baseName: node_path.default.basename(filePath),
-		meta: { pluginName: this.pluginName },
-		sources: [],
-		imports: [],
-		exports: []
-	});
-}
-/**
-* Generates the default "Generated by Kubb" banner from config and optional node metadata.
-*/
-function buildDefaultBanner({ title, description, version, config }) {
-	try {
-		const source = (() => {
-			if (Array.isArray(config.input)) {
-				const first = config.input[0];
-				if (first && "path" in first) return node_path.default.basename(first.path);
-				return "";
+		if (_kubb_ast.schemaDef.is(node)) {
+			if (exclude.some((filter) => Resolver.#matchesSchema(node, filter) === true)) return null;
+			if (include) {
+				const applicable = include.map((filter) => Resolver.#matchesSchema(node, filter)).filter((result) => result !== null);
+				if (applicable.length > 0 && !applicable.includes(true)) return null;
 			}
-			if (config.input && "path" in config.input) return node_path.default.basename(config.input.path);
-			if (config.input && "data" in config.input) return "text content";
-			return "";
-		})();
-		let banner = "/**\n* Generated by Kubb (https://kubb.dev/).\n* Do not edit manually.\n";
-		if (config.output.defaultBanner === "simple") {
-			banner += "*/\n";
-			return banner;
+			return {
+				...options,
+				...override.find((filter) => Resolver.#matchesSchema(node, filter) === true)?.options
+			};
 		}
-		if (source) banner += `* Source: ${source}\n`;
-		if (title) banner += `* Title: ${title}\n`;
-		if (description) {
-			const formattedDescription = description.replace(/\n/gm, "\n* ");
-			banner += `* Description: ${formattedDescription}\n`;
+		return options;
+	}
+	/**
+	* Applies include/exclude filters and merges matching override options, caching the result
+	* per `(options, node)` pair. Returns `null` when the node is filtered out.
+	*/
+	#resolveOptions(node, context) {
+		const { options } = context;
+		if (typeof options !== "object" || options === null) return Resolver.#computeOptions(node, context);
+		let byOptions = Resolver.#optionsCache.get(options);
+		if (!byOptions) {
+			byOptions = /* @__PURE__ */ new WeakMap();
+			Resolver.#optionsCache.set(options, byOptions);
 		}
-		if (version) banner += `* OpenAPI spec version: ${version}\n`;
-		banner += "*/\n";
-		return banner;
-	} catch (_error) {
-		return "/**\n* Generated by Kubb (https://kubb.dev/).\n* Do not edit manually.\n*/";
+		const cached = byOptions.get(node);
+		if (cached) return cached.value;
+		const result = Resolver.#computeOptions(node, context);
+		byOptions.set(node, { value: result });
+		return result;
 	}
-}
-/**
-* Default banner resolver. Returns the banner string for a generated file.
-*
-* A user-supplied `output.banner` overrides the default Kubb "Generated by Kubb" notice.
-* When no `output.banner` is set, the Kubb notice is used (including `title` and `version`
-* from the document metadata when `meta` is provided).
-*
-* - When `output.banner` is a function, calls it with the file's `BannerMeta` and returns the result.
-* - When `output.banner` is a string, returns it directly.
-* - When `config.output.defaultBanner` is `false`, returns `undefined`.
-* - Otherwise returns the Kubb "Generated by Kubb" notice.
-*
-* @example String banner overrides default
-* ```ts
-* defaultResolveBanner(undefined, { output: { banner: '// my banner' }, config })
-* // → '// my banner'
-* ```
-*
-* @example Function banner with metadata
-* ```ts
-* defaultResolveBanner(meta, { output: { banner: (m) => `// v${m.version}` }, config })
-* // → '// v3.0.0'
-* ```
-*
-* @example Function banner skips re-export files
-* ```ts
-* defaultResolveBanner(meta, { output: { banner: (m) => (m.isBarrel ? '' : "'use server'") }, config, file: { path, baseName, isBarrel: true } })
-* // → ''
-* ```
-*
-* @example No user banner, Kubb notice with OAS metadata
-* ```ts
-* defaultResolveBanner(meta, { config })
-* // → '/** Generated by Kubb ... Title: Pet Store ... *\/'
-* ```
-*
-* @example Disabled default banner
-* ```ts
-* defaultResolveBanner(undefined, { config: { output: { defaultBanner: false }, ...config } })
-* // → null
-* ```
-*/
-function defaultResolveBanner(meta, { output, config, file }) {
-	if (typeof output?.banner === "function") return output.banner(buildBannerMeta({
-		meta,
-		file
-	}));
-	if (typeof output?.banner === "string") return output.banner;
-	if (config.output.defaultBanner === false) return null;
-	return buildDefaultBanner({
-		title: meta?.title,
-		version: meta?.version,
-		config
-	});
-}
-/**
-* Default footer resolver. Returns the footer string for a generated file.
-*
-* - When `output.footer` is a function, calls it with the file's `BannerMeta` and returns the result.
-* - When `output.footer` is a string, returns it directly.
-* - Otherwise returns `undefined`.
-*
-* @example String footer
-* ```ts
-* defaultResolveFooter(undefined, { output: { footer: '// end of file' }, config })
-* // → '// end of file'
-* ```
-*
-* @example Function footer with metadata
-* ```ts
-* defaultResolveFooter(meta, { output: { footer: (m) => `// ${m.title}` }, config })
-* // → '// Pet Store'
-* ```
-*/
-function defaultResolveFooter(meta, { output, file }) {
-	if (typeof output?.footer === "function") return output.footer(buildBannerMeta({
-		meta,
-		file
-	}));
-	if (typeof output?.footer === "string") return output.footer;
-	return null;
-}
+	/**
+	* A custom `group.name` wins; otherwise `tag` groups use the camelCased tag and `path`
+	* groups use the first non-traversal segment (`''` when none remain, placing the file in
+	* the output root, kept safe by the caller's boundary check).
+	*/
+	static #resolveGroupDir(group, groupValue) {
+		if (group.name) return group.name({ group: groupValue });
+		if (group.type === "tag") return require_usingCtx.camelCase(groupValue);
+		const segment = groupValue.split("/").filter((part) => part !== "" && part !== "." && part !== "..")[0];
+		return segment ? require_usingCtx.camelCase(segment) : "";
+	}
+	/**
+	* `mode: 'file'` resolves directly to `output.path`. `mode: 'directory'` (default) resolves
+	* to `output.path/{baseName}`, or into a subdirectory when `group` and a `tag`/`path` value
+	* are provided.
+	*/
+	#resolvePath({ baseName, tag, path: groupPath }, { root, output, group }) {
+		if (output.mode === "file") return node_path.default.resolve(root, output.path);
+		const outputDir = node_path.default.resolve(root, output.path);
+		const result = group && (groupPath || tag) ? node_path.default.resolve(outputDir, Resolver.#resolveGroupDir(group, group.type === "path" ? groupPath : tag), baseName) : node_path.default.resolve(outputDir, baseName);
+		const outputDirWithSep = outputDir.endsWith(node_path.default.sep) ? outputDir : `${outputDir}${node_path.default.sep}`;
+		if (result !== outputDir && !result.startsWith(outputDirWithSep)) throw new Diagnostics.Error({
+			code: Diagnostics.code.pathTraversal,
+			severity: "error",
+			message: `Resolved path "${result}" is outside the output directory "${outputDir}".`,
+			help: "This can stem from a path traversal in the OpenAPI specification or a misconfigured `group.name` function. Keep generated paths within the output directory.",
+			location: { kind: "config" }
+		});
+		return result;
+	}
+	/**
+	* Builds a `FileNode` by combining file-name casing (`params.resolveName`) with path
+	* resolution. The resolved file starts with empty `sources`, `imports`, and `exports`,
+	* which consumers populate separately.
+	*/
+	#resolveFile({ name, extname, tag, path: groupPath, resolveName = require_usingCtx.toFilePath }, context) {
+		const resolvedName = context.output.mode === "file" ? "" : resolveName(name);
+		const filePath = this.#resolvePath({
+			baseName: `${resolvedName}${extname}`,
+			tag,
+			path: groupPath
+		}, context);
+		return _kubb_ast.ast.factory.createFile({
+			path: filePath,
+			baseName: node_path.default.basename(filePath),
+			meta: { pluginName: this.pluginName },
+			sources: [],
+			imports: [],
+			exports: []
+		});
+	}
+	/**
+	* Missing fields default to empty/`false` so the `BannerMeta` shape stays stable even when
+	* a caller (e.g. the barrel plugin) has no document metadata.
+	*/
+	static #buildBannerMeta(meta, file) {
+		return {
+			title: meta?.title,
+			description: meta?.description,
+			version: meta?.version,
+			baseURL: meta?.baseURL,
+			circularNames: meta?.circularNames ?? [],
+			enumNames: meta?.enumNames ?? [],
+			filePath: file?.path ?? "",
+			baseName: file?.baseName ?? "",
+			isBarrel: file?.isBarrel ?? false,
+			isAggregation: file?.isAggregation ?? false
+		};
+	}
+	/**
+	* Resolves a user-configured banner/footer value. `undefined` means not configured.
+	*/
+	static #resolveUserText(value, meta, file) {
+		if (typeof value === "function") return value(Resolver.#buildBannerMeta(meta, file));
+		if (typeof value === "string") return value;
+	}
+	static #buildDefaultBanner({ title, version, config }) {
+		const lines = [
+			"/**",
+			"* Generated by Kubb (https://kubb.dev/).",
+			"* Do not edit manually."
+		];
+		if (config.output.defaultBanner !== "simple") {
+			const input = Array.isArray(config.input) ? config.input[0] : config.input;
+			const source = input && "path" in input ? node_path.default.basename(input.path) : input && "data" in input ? "text content" : "";
+			if (source) lines.push(`* Source: ${source}`);
+			if (title) lines.push(`* Title: ${title}`);
+			if (version) lines.push(`* OpenAPI spec version: ${version}`);
+		}
+		return `${lines.join("\n")}\n*/\n`;
+	}
+	/**
+	* A user-supplied `output.banner` overrides the default Kubb notice. When
+	* `config.output.defaultBanner` is `false` and no user banner is set, returns `null`.
+	*/
+	#resolveBanner(meta, { output, config, file }) {
+		const userBanner = Resolver.#resolveUserText(output?.banner, meta, file);
+		if (userBanner !== void 0) return userBanner;
+		if (config.output.defaultBanner === false) return null;
+		return Resolver.#buildDefaultBanner({
+			title: meta?.title,
+			version: meta?.version,
+			config
+		});
+	}
+	#resolveFooter(meta, { output, file }) {
+		return Resolver.#resolveUserText(output?.footer, meta, file) ?? null;
+	}
+};
 /**
-* Defines a plugin resolver. The resolver is the object that decides what
-* every generated symbol and file path is called. Built-in defaults handle
-* name casing, include/exclude/override filtering, output path computation,
-* and file construction. Supply your own to override any of them:
-*
-* - `default` sets the name casing strategy (camelCase or PascalCase).
-* - `resolveOptions` does include/exclude/override filtering.
-* - `resolvePath` computes the output path.
-* - `resolveFile` builds the full `FileNode`.
-* - `resolveBanner` and `resolveFooter` produce the top and bottom of file text.
-*
-* Methods in the returned object can call sibling resolver methods via `this`.
-* A custom rule can delegate to a default, for example `this.default(name, 'type')`.
+* Defines a plugin resolver, the object that decides what every generated symbol and file
+* path is called. Override the top-level `name` and `file` to set the plugin's conventions,
+* and add your own naming helpers, top-level (`typeName`, …) or grouped in namespaces
+* (`query`, `schema`, …). Every method reaches sibling helpers and the built-in machinery
+* through `this.name`, `this.file`, and `this.default`.
 *
-* @example Basic resolver with naming helpers
+* @example Custom identifier and file casing
 * ```ts
-* export const resolverTs = defineResolver<PluginTs>(() => ({
-*   name: 'default',
-*   resolveName(name) {
-*     return this.default(name, 'function')
+* export const resolverTs = createResolver<PluginTs>({
+*   pluginName: 'plugin-ts',
+*   name(name) {
+*     return ensureValidVarName(pascalCase(name))
 *   },
-*   resolveTypeName(name) {
-*     return this.default(name, 'type')
+*   file(params, context) {
+*     return this.default.file({ ...params, resolveName: (name) => toFilePath(name, pascalCase) }, context)
 *   },
-* }))
-* ```
-*
-* @example Custom output path
-* ```ts
-* import path from 'node:path'
-*
-* export const resolverTs = defineResolver<PluginTs>(() => ({
-*   name: 'custom',
-*   resolvePath({ baseName }, { root, output }) {
-*     return path.resolve(root, output.path, 'generated', baseName)
-*   },
-* }))
+* })
 * ```
 */
-function defineResolver(build) {
-	let resolver;
-	resolver = {
-		default: defaultResolver,
-		resolveOptions: defaultResolveOptions,
-		resolvePath: defaultResolvePath,
-		resolveFile: (params, context) => defaultResolveFile.call(resolver, params, context),
-		resolveBanner: defaultResolveBanner,
-		resolveFooter: defaultResolveFooter,
-		...build()
-	};
-	return resolver;
+function createResolver(options) {
+	return new Resolver(options);
 }
 //#endregion
 //#region src/Transform.ts
@@ -1284,12 +1040,6 @@ var Transform = class {
 	#composed = /* @__PURE__ */ new Map();
 	#memo = /* @__PURE__ */ new Map();
 	/**
-	* Number of plugins with at least one registered macro.
-	*/
-	get size() {
-		return this.#macros.size;
-	}
-	/**
 	* Appends `macro` to the plugin's list, after any macros already registered.
 	*/
 	add(pluginName, macro) {
@@ -1306,12 +1056,6 @@ var Transform = class {
 		this.#invalidate(pluginName);
 	}
 	/**
-	* Looks up the composed visitor for `pluginName`, or `undefined` when the plugin has no macros.
-	*/
-	get(pluginName) {
-		return this.#visitorFor(pluginName);
-	}
-	/**
 	* Runs the plugin's macros on `node`. Returns the original node reference when the plugin has no
 	* macros, so callers can compare by identity to detect a no-op.
 	*/
@@ -1355,20 +1099,49 @@ var Transform = class {
 };
 //#endregion
 //#region src/KubbDriver.ts
-function enforceOrder(enforce) {
-	return enforce === "pre" ? -1 : enforce === "post" ? 1 : 0;
+const ENFORCE_ORDER = {
+	pre: -1,
+	post: 1
+};
+/**
+* Orders plugins so every dependency runs before its dependents (Kahn's algorithm), with
+* `enforce` (`'pre'` before normal before `'post'`) and declaration order as tiebreaks.
+* A pairwise `Array.sort` comparator cannot do this: dependency relations are not transitive
+* at the comparator level, so a chain where A depends on B and B depends on C could come out
+* wrong when A and C are never compared directly. Dependencies on plugins missing from the
+* config are ignored here and surface later through `requirePlugin`.
+*/
+function sortPlugins(plugins) {
+	const queue = [...plugins].sort((a, b) => (a.enforce ? ENFORCE_ORDER[a.enforce] : 0) - (b.enforce ? ENFORCE_ORDER[b.enforce] : 0));
+	const names = new Set(queue.map((plugin) => plugin.name));
+	const blockedBy = new Map(queue.map((plugin) => [plugin.name, new Set(plugin.dependencies?.filter((name) => names.has(name) && name !== plugin.name))]));
+	const sorted = [];
+	while (queue.length > 0) {
+		const index = queue.findIndex((plugin) => blockedBy.get(plugin.name)?.size === 0);
+		if (index === -1) throw new Diagnostics.Error({
+			code: Diagnostics.code.invalidPluginOptions,
+			severity: "error",
+			message: `Plugin dependencies form a cycle: ${queue.map((plugin) => plugin.name).join(" → ")}.`,
+			help: "Remove one of the `dependencies` entries so the plugins can be ordered.",
+			location: { kind: "config" }
+		});
+		const [plugin] = queue.splice(index, 1);
+		if (!plugin) break;
+		sorted.push(plugin);
+		for (const blockers of blockedBy.values()) blockers.delete(plugin.name);
+	}
+	return sorted;
 }
 var KubbDriver = class {
 	config;
 	options;
 	/**
-	* The streaming `InputNode<true>` produced by the adapter. Set after adapter setup.
-	* Parse-only adapters are wrapped automatically.
+	* The `InputNode` produced by the adapter. Set after adapter setup.
 	*/
 	inputNode = null;
 	adapter = null;
 	/**
-	* Raw adapter source so `adapter.parse()` / `adapter.stream()` can run lazily.
+	* Raw adapter source so `adapter.parse()` can run lazily.
 	* Intentionally outlives the build, cleared by `dispose()`.
 	*/
 	#adapterSource = null;
@@ -1377,7 +1150,7 @@ var KubbDriver = class {
 	* Plugins should use `this.addFile()` / `this.upsertFile()` (via their context) to
 	* add files. This property gives direct read/write access when needed.
 	*/
-	fileManager = new require_memoryStorage.FileManager();
+	fileManager = new require_usingCtx.FileManager();
 	plugins = /* @__PURE__ */ new Map();
 	/**
 	* Tracks which plugins have generators registered via `addGenerator()` (event-based path).
@@ -1416,15 +1189,8 @@ var KubbDriver = class {
 	* so `run` can parse it later.
 	*/
 	async setup() {
-		const normalized = this.config.plugins.map((rawPlugin) => this.#normalizePlugin(rawPlugin));
-		const dependenciesByName = new Map(normalized.map((plugin) => [plugin.name, new Set(plugin.dependencies ?? [])]));
-		normalized.sort((a, b) => {
-			if (dependenciesByName.get(b.name)?.has(a.name)) return -1;
-			if (dependenciesByName.get(a.name)?.has(b.name)) return 1;
-			return enforceOrder(a.enforce) - enforceOrder(b.enforce);
-		});
+		const normalized = sortPlugins(this.config.plugins.map((rawPlugin) => this.#normalizePlugin(rawPlugin)));
 		for (const plugin of normalized) {
-			if (plugin.apply) plugin.apply(this.config);
 			this.#registerPlugin(plugin);
 			this.plugins.set(plugin.name, plugin);
 		}
@@ -1435,11 +1201,11 @@ var KubbDriver = class {
 	}
 	/**
 	* Builds a `NormalizedPlugin` from a hook-style plugin, filling in default
-	* options and copying `apply` when present. Registering its lifecycle handlers
-	* on the `AsyncEventEmitter` is done separately by `#registerPlugin`.
+	* options. Registering its lifecycle handlers on the `AsyncEventEmitter` is
+	* done separately by `#registerPlugin`.
 	*/
 	#normalizePlugin(plugin) {
-		const normalized = {
+		return {
 			name: plugin.name,
 			dependencies: plugin.dependencies,
 			enforce: plugin.enforce,
@@ -1453,30 +1219,14 @@ var KubbDriver = class {
 				override: []
 			}
 		};
-		if ("apply" in plugin && typeof plugin.apply === "function") normalized.apply = plugin.apply;
-		return normalized;
 	}
 	/**
 	* Parses the adapter source into `this.inputNode`. Idempotent, so repeated calls from
-	* `run` do not re-parse. Adapters with `stream()` are used directly.
-	* Adapters with only `parse()` are wrapped via `ast.factory.createInput({ stream: true })` so the dispatch loop
-	* stays stream-only.
+	* `run` do not re-parse.
 	*/
 	async #parseInput() {
 		if (this.inputNode || !this.adapter || !this.#adapterSource) return;
-		const adapter = this.adapter;
-		const source = this.#adapterSource;
-		if (adapter.stream) {
-			this.inputNode = await adapter.stream(source);
-			return;
-		}
-		const parsed = await adapter.parse(source);
-		this.inputNode = _kubb_ast.ast.factory.createInput({
-			stream: true,
-			schemas: arrayToAsyncIterable(parsed.schemas),
-			operations: arrayToAsyncIterable(parsed.operations),
-			meta: parsed.meta
-		});
+		this.inputNode = await this.adapter.parse(this.#adapterSource);
 	}
 	/**
 	* Registers a hook-style plugin's lifecycle handlers on the shared `AsyncEventEmitter`.
@@ -1590,10 +1340,10 @@ var KubbDriver = class {
 	}
 	/**
 	* Returns `true` when at least one generator was registered for the given plugin
-	* via `addGenerator()` in `kubb:plugin:setup` (event-based path).
+	* via `addGenerator()` in `kubb:plugin:setup`.
 	*
 	* Used by the build loop to decide whether to walk the AST and emit generator events
-	* for a plugin that has no static `plugin.generators`.
+	* for a plugin.
 	*/
 	hasEventGenerators(pluginName) {
 		return this.#eventGeneratorPlugins.has(pluginName);
@@ -1605,34 +1355,28 @@ var KubbDriver = class {
 	* contributes a `timing` diagnostic for the run summary.
 	*/
 	async run({ storage }) {
-		const { hooks, config } = this;
+		const { hooks, config, fileManager } = this;
 		const diagnostics = [];
 		const parsersMap = /* @__PURE__ */ new Map();
 		for (const parser of config.parsers) if (parser.extNames) for (const ext of parser.extNames) parsersMap.set(ext, parser);
-		const processor = new require_memoryStorage.FileProcessor({
-			parsers: parsersMap,
-			storage,
-			extension: config.output.extension
-		});
-		processor.hooks.on("start", async (files) => {
+		const onWriteStart = async (files) => {
 			await hooks.emit("kubb:files:processing:start", { files });
-		});
+		};
 		const updateBuffer = [];
-		processor.hooks.on("update", (item) => {
+		const onWriteUpdate = (item) => {
 			updateBuffer.push(item);
-		});
-		processor.hooks.on("end", async (files) => {
+		};
+		const onWriteEnd = async (files) => {
 			await hooks.emit("kubb:files:processing:update", { files: updateBuffer.map((item) => ({
 				...item,
 				config
 			})) });
 			updateBuffer.length = 0;
 			await hooks.emit("kubb:files:processing:end", { files });
-		});
-		const onFileUpsert = (file) => {
-			processor.enqueue(file);
 		};
-		this.fileManager.hooks.on("upsert", onFileUpsert);
+		fileManager.hooks.on("start", onWriteStart);
+		fileManager.hooks.on("update", onWriteUpdate);
+		fileManager.hooks.on("end", onWriteEnd);
 		return Diagnostics.scope((diagnostic) => diagnostics.push(diagnostic), async () => {
 			try {
 				const outputRoot = (0, node_path.resolve)(config.root, config.output.path);
@@ -1687,10 +1431,13 @@ var KubbDriver = class {
 						success: true
 					});
 				}
-				diagnostics.push(...await this.#runGenerators(generatorPlugins, () => processor.flush()));
-				await processor.drain();
+				diagnostics.push(...await this.#runGenerators(generatorPlugins));
 				await hooks.emit("kubb:plugins:end", Object.assign({ config }, this.#filesPayload()));
-				await processor.drain();
+				await fileManager.write(fileManager.files, {
+					storage,
+					parsers: parsersMap,
+					extension: config.output.extension
+				});
 				await hooks.emit("kubb:build:end", {
 					files: this.fileManager.files,
 					config,
@@ -1701,7 +1448,9 @@ var KubbDriver = class {
 				diagnostics.push(Diagnostics.from(caughtError));
 				return { diagnostics: Diagnostics.dedupe(diagnostics) };
 			} finally {
-				this.fileManager.hooks.off("upsert", onFileUpsert);
+				fileManager.hooks.off("start", onWriteStart);
+				fileManager.hooks.off("update", onWriteUpdate);
+				fileManager.hooks.off("end", onWriteEnd);
 			}
 		});
 	}
@@ -1724,22 +1473,21 @@ var KubbDriver = class {
 		}, this.#filesPayload()));
 	}
 	/**
-	* Streams schemas and operations through every plugin's generators. Each node is run
+	* Runs schemas and operations through every plugin's generators. Each node is run
 	* through the plugin's macros (from `this.#transforms`) before the generator sees it,
 	* so plugins stay isolated and the hot path stays per-node. Schemas run before operations
-	* because the two passes share `flushPending` and the FileProcessor's event emitter.
+	* so file output stays deterministic across runs.
 	* A failing plugin contributes an error diagnostic so the rest of the build continues.
 	* Every plugin also contributes a `timing` diagnostic.
 	*
-	* Plugins run sequentially so `kubb:plugin:end` fires as each plugin completes, instead
-	* of all at once after every plugin has marched through the parallel batches together.
-	* That ordering is what drives the CLI's `Plugins N/M` counter. Without it the bar would
-	* sit at the initial value until the very end of the run.
+	* Plugins are processed one at a time, in full, so `kubb:plugin:end` fires as each one
+	* completes rather than all at once at the end. That ordering drives the CLI's
+	* `Plugins N/M` counter.
 	*
 	* When `this.inputNode` is `null`, every entry still gets a `kubb:plugin:end` so
 	* post-plugin listeners (the barrel writer and friends) complete.
 	*/
-	async #runGenerators(entries, flushPending) {
+	async #runGenerators(entries) {
 		const diagnostics = [];
 		if (entries.length === 0) return diagnostics;
 		if (!this.inputNode) {
@@ -1759,160 +1507,104 @@ var KubbDriver = class {
 		}
 		const transforms = this.#transforms;
 		const { schemas, operations } = this.inputNode;
-		const states = entries.map(({ plugin, context, hrStart }) => {
-			const { exclude, include, override } = plugin.options;
-			const hasExclude = Array.isArray(exclude) && exclude.length > 0;
-			const hasInclude = Array.isArray(include) && include.length > 0;
-			const hasOverride = Array.isArray(override) && override.length > 0;
-			return {
-				plugin,
-				generatorContext: {
-					...context,
-					resolver: this.getResolver(plugin.name)
-				},
-				generators: plugin.generators ?? [],
-				hrStart,
-				failed: false,
-				error: null,
-				optionsAreStatic: !hasExclude && !hasInclude && !hasOverride,
-				allowedSchemaNames: null
-			};
-		});
 		const emitsSchemaHook = this.hooks.listenerCount("kubb:generate:schema") > 0;
 		const emitsOperationHook = this.hooks.listenerCount("kubb:generate:operation") > 0;
 		const emitsOperationsHook = this.hooks.listenerCount("kubb:generate:operations") > 0;
-		const schemasBuffer = await Array.fromAsync(schemas);
-		const operationsBuffer = await Array.fromAsync(operations);
-		const pruningStates = states.filter(({ plugin }) => {
-			const { include } = plugin.options;
-			return (include?.some(({ type }) => require_memoryStorage.OPERATION_FILTER_TYPES.has(type)) ?? false) && !(include?.some(({ type }) => type === "schemaName") ?? false);
-		});
-		if (pruningStates.length > 0) {
-			const includedOpsByState = new Map(pruningStates.map((state) => [state, []]));
-			for (const operation of operationsBuffer) for (const state of pruningStates) {
-				const { exclude, include, override } = state.plugin.options;
-				if (state.generatorContext.resolver.resolveOptions(operation, {
-					options: state.plugin.options,
-					exclude,
-					include,
-					override
-				}) !== null) includedOpsByState.get(state)?.push(operation);
-			}
-			for (const state of pruningStates) {
-				state.allowedSchemaNames = (0, _kubb_ast.collectUsedSchemaNames)(includedOpsByState.get(state) ?? [], schemasBuffer);
-				includedOpsByState.delete(state);
-			}
-		}
-		const resolveForPlugin = (state, node) => {
-			const { plugin, generatorContext } = state;
-			const transformedNode = transforms.applyTo(plugin.name, node);
-			if (state.optionsAreStatic) return {
-				transformedNode,
-				options: plugin.options
-			};
+		const allowedSchemaNamesByPlugin = /* @__PURE__ */ new Map();
+		for (const { plugin } of entries) {
 			const { exclude, include, override } = plugin.options;
-			const options = generatorContext.resolver.resolveOptions(transformedNode, {
+			if (!((include?.some(({ type }) => OPERATION_FILTER_TYPES.has(type)) ?? false) && !(include?.some(({ type }) => type === "schemaName") ?? false))) continue;
+			const resolver = this.getResolver(plugin.name);
+			const includedOps = operations.filter((operation) => resolver.default.options(operation, {
 				options: plugin.options,
 				exclude,
 				include,
 				override
-			});
-			if (options === null) return null;
-			return {
-				transformedNode,
-				options
+			}) !== null);
+			allowedSchemaNamesByPlugin.set(plugin.name, (0, _kubb_ast.collectUsedSchemaNames)(includedOps, schemas));
+		}
+		for (const { plugin, context, hrStart } of entries) {
+			const generatorContext = {
+				...context,
+				resolver: this.getResolver(plugin.name)
 			};
-		};
-		const dispatchNode = async (state, node, dispatch) => {
-			if (state.failed) return;
-			try {
-				const resolved = resolveForPlugin(state, node);
-				if (!resolved) return;
-				const { transformedNode, options } = resolved;
-				if (dispatch.checkAllowedNames && state.allowedSchemaNames !== null && "name" in transformedNode && transformedNode.name && !state.allowedSchemaNames.has(transformedNode.name)) return;
-				const ctx = {
-					...state.generatorContext,
+			const { exclude, include, override } = plugin.options;
+			const optionsAreStatic = !exclude?.length && !include?.length && !override?.length;
+			const allowedSchemaNames = allowedSchemaNamesByPlugin.get(plugin.name) ?? null;
+			let error = null;
+			const resolveForPlugin = (node) => {
+				const transformedNode = transforms.applyTo(plugin.name, node);
+				if (optionsAreStatic) return {
+					transformedNode,
+					options: plugin.options
+				};
+				const options = generatorContext.resolver.default.options(transformedNode, {
+					options: plugin.options,
+					exclude,
+					include,
+					override
+				});
+				if (options === null) return null;
+				return {
+					transformedNode,
 					options
 				};
-				for (const gen of state.generators) {
-					const run = gen[dispatch.method];
-					if (!run) continue;
-					const raw = run(transformedNode, ctx);
-					const result = isPromise(raw) ? await raw : raw;
-					const applied = this.dispatch({
-						result,
-						renderer: gen.renderer
+			};
+			if (emitsSchemaHook) for (const node of schemas) {
+				if (error) break;
+				try {
+					const resolved = resolveForPlugin(node);
+					if (!resolved) continue;
+					const { transformedNode, options } = resolved;
+					if (allowedSchemaNames !== null && transformedNode.name && !allowedSchemaNames.has(transformedNode.name)) continue;
+					await this.hooks.emit("kubb:generate:schema", transformedNode, {
+						...generatorContext,
+						options
 					});
-					if (isPromise(applied)) await applied;
+				} catch (caughtError) {
+					error = caughtError;
 				}
-				if (dispatch.emit) await dispatch.emit(transformedNode, ctx);
-			} catch (caughtError) {
-				state.failed = true;
-				state.error = caughtError;
 			}
-		};
-		const schemaDispatch = {
-			method: "schema",
-			checkAllowedNames: true,
-			emit: emitsSchemaHook ? (node, ctx) => this.hooks.emit("kubb:generate:schema", node, ctx) : null
-		};
-		const operationDispatch = {
-			method: "operation",
-			checkAllowedNames: false,
-			emit: emitsOperationHook ? (node, ctx) => this.hooks.emit("kubb:generate:operation", node, ctx) : null
-		};
-		const dispatchPass = async (state, nodes, dispatch) => {
-			let sinceFlush = 0;
-			for (const node of nodes) {
-				await dispatchNode(state, node, dispatch);
-				if (++sinceFlush >= 8) {
-					sinceFlush = 0;
-					await flushPending();
+			if (emitsOperationHook) for (const node of operations) {
+				if (error) break;
+				try {
+					const resolved = resolveForPlugin(node);
+					if (!resolved) continue;
+					await this.hooks.emit("kubb:generate:operation", resolved.transformedNode, {
+						...generatorContext,
+						options: resolved.options
+					});
+				} catch (caughtError) {
+					error = caughtError;
 				}
 			}
-			if (sinceFlush > 0) await flushPending();
-		};
-		for (const state of states) {
-			const needsOperationsAggregate = emitsOperationsHook || state.generators.some((gen) => !!gen.operations);
-			await dispatchPass(state, schemasBuffer, schemaDispatch);
-			await dispatchPass(state, operationsBuffer, operationDispatch);
-			if (!state.failed && needsOperationsAggregate) try {
-				const { plugin, generatorContext, generators } = state;
+			if (!error && emitsOperationsHook) try {
 				const ctx = {
 					...generatorContext,
 					options: plugin.options
 				};
-				const pluginOperations = operationsBuffer.reduce((acc, node) => {
-					const resolved = resolveForPlugin(state, node);
+				const pluginOperations = operations.reduce((acc, node) => {
+					const resolved = resolveForPlugin(node);
 					if (resolved) acc.push(resolved.transformedNode);
 					return acc;
 				}, []);
-				for (const gen of generators) {
-					if (!gen.operations) continue;
-					const result = await gen.operations(pluginOperations, ctx);
-					await this.dispatch({
-						result,
-						renderer: gen.renderer
-					});
-				}
 				await this.hooks.emit("kubb:generate:operations", pluginOperations, ctx);
 			} catch (caughtError) {
-				state.failed = true;
-				state.error = caughtError;
+				error = caughtError;
 			}
-			const duration = getElapsedMs(state.hrStart);
+			const duration = getElapsedMs(hrStart);
 			await this.#emitPluginEnd({
-				plugin: state.plugin,
+				plugin,
 				duration,
-				success: !state.failed,
-				error: state.failed && state.error ? state.error : void 0
+				success: !error,
+				error: error ?? void 0
 			});
-			if (state.failed && state.error) diagnostics.push({
-				...Diagnostics.from(state.error),
-				plugin: state.plugin.name
+			if (error) diagnostics.push({
+				...Diagnostics.from(error),
+				plugin: plugin.name
 			});
 			diagnostics.push(Diagnostics.performance({
-				plugin: state.plugin.name,
+				plugin: plugin.name,
 				duration
 			}));
 		}
@@ -1932,7 +1624,7 @@ var KubbDriver = class {
 	*/
 	async dispatch({ result, renderer }) {
 		try {
-			var _usingCtx$2 = require_memoryStorage._usingCtx();
+			var _usingCtx$2 = require_usingCtx._usingCtx();
 			if (!result) return;
 			if (Array.isArray(result)) {
 				this.fileManager.upsert(...result);
@@ -1940,10 +1632,6 @@ var KubbDriver = class {
 			}
 			if (!renderer) return;
 			const instance = _usingCtx$2.u(renderer());
-			if (instance.stream) {
-				for (const file of instance.stream(result)) this.fileManager.upsert(file);
-				return;
-			}
 			await instance.render(result);
 			this.fileManager.upsert(...instance.files);
 		} catch (_) {
@@ -1972,26 +1660,21 @@ var KubbDriver = class {
 	[Symbol.dispose]() {
 		this.dispose();
 	}
-	#getDefaultResolver = memoize(this.#defaultResolvers, (pluginName) => defineResolver(() => ({
-		name: "default",
-		pluginName
-	})));
+	#getDefaultResolver = memoize(this.#defaultResolvers, (pluginName) => createResolver({ pluginName }));
 	/**
 	* Merges `partial` with the plugin's default resolver and stores the result.
 	* Also mirrors it onto `plugin.resolver` so callers using `getPlugin(name).resolver`
 	* get the up-to-date resolver without going through `getResolver()`.
 	*/
 	setPluginResolver(pluginName, partial) {
-		const merged = {
-			...this.#getDefaultResolver(pluginName),
-			...partial
-		};
+		const defaultResolver = this.#getDefaultResolver(pluginName);
+		const merged = Resolver.merge(defaultResolver, partial);
 		this.#resolvers.set(pluginName, merged);
 		const plugin = this.plugins.get(pluginName);
 		if (plugin) plugin.resolver = merged;
 	}
 	getResolver(pluginName) {
-		return this.#resolvers.get(pluginName) ?? this.plugins.get(pluginName)?.resolver ?? this.#getDefaultResolver(pluginName);
+		return this.#resolvers.get(pluginName) ?? this.#getDefaultResolver(pluginName);
 	}
 	getContext(plugin) {
 		const driver = this;
@@ -2096,7 +1779,73 @@ function inputToAdapterSource(config) {
 	};
 }
 //#endregion
+//#region src/createStorage.ts
+/**
+* Defines a custom storage backend. The builder receives user options and
+* returns a `Storage` implementation. Kubb ships with filesystem and in-memory
+* storages. A custom backend writes generated files elsewhere, such as cloud
+* storage or a database.
+*
+* @example In-memory storage (the built-in implementation)
+* ```ts
+* import { createStorage } from '@kubb/core'
+*
+* export const memoryStorage = createStorage(() => {
+*   const store = new Map<string, string>()
+*
+*   return {
+*     name: 'memory',
+*     async hasItem(key) {
+*       return store.has(key)
+*     },
+*     async getItem(key) {
+*       return store.get(key) ?? null
+*     },
+*     async setItem(key, value) {
+*       store.set(key, value)
+*     },
+*     async removeItem(key) {
+*       store.delete(key)
+*     },
+*     async getKeys(base) {
+*       const keys = [...store.keys()]
+*       return base ? keys.filter((k) => k.startsWith(base)) : keys
+*     },
+*     async clear(base) {
+*       if (!base) store.clear()
+*     },
+*   }
+* })
+* ```
+*/
+function createStorage(build) {
+	return (options) => build(options ?? {});
+}
+//#endregion
 //#region src/storages/fsStorage.ts
+const WRITE_CONCURRENCY = 50;
+function createLimiter(concurrency) {
+	let active = 0;
+	const queue = [];
+	function next() {
+		if (active >= concurrency) return;
+		const run = queue.shift();
+		if (!run) return;
+		active++;
+		run();
+	}
+	return function limit(task) {
+		return new Promise((resolve, reject) => {
+			queue.push(() => {
+				task().then(resolve, reject).finally(() => {
+					active--;
+					next();
+				});
+			});
+			next();
+		});
+	};
+}
 /**
 * Built-in filesystem storage driver.
 *
@@ -2109,6 +1858,8 @@ function inputToAdapterSource(config) {
 * - the write is skipped when the file content is already identical
 * - missing parent directories are created automatically
 * - Bun's native file API is used when running under Bun
+* - concurrent `setItem` calls are capped at {@link WRITE_CONCURRENCY} in flight, so a caller
+*   can fire every file's write without pacing itself
 *
 * @example
 * ```ts
@@ -2122,91 +1873,50 @@ function inputToAdapterSource(config) {
 * })
 * ```
 */
-const fsStorage = require_memoryStorage.createStorage(() => ({
-	name: "fs",
-	async hasItem(key) {
-		try {
-			await (0, node_fs_promises.access)((0, node_path.resolve)(key));
-			return true;
-		} catch (_error) {
-			return false;
-		}
-	},
-	async getItem(key) {
-		try {
-			return await (0, node_fs_promises.readFile)((0, node_path.resolve)(key), "utf8");
-		} catch (_error) {
-			return null;
-		}
-	},
-	async setItem(key, value) {
-		await require_memoryStorage.write((0, node_path.resolve)(key), value, { sanity: false });
-	},
-	async removeItem(key) {
-		await (0, node_fs_promises.rm)((0, node_path.resolve)(key), { force: true });
-	},
-	async getKeys(base) {
-		const resolvedBase = (0, node_path.resolve)(base ?? process.cwd());
-		if (require_memoryStorage.runtime.isBun) {
-			const bunGlob = new Bun.Glob("**/*");
-			return Array.fromAsync(bunGlob.scan({
-				cwd: resolvedBase,
-				onlyFiles: true,
-				dot: true
-			}));
-		}
-		const keys = [];
-		try {
-			for await (const entry of (0, node_fs_promises.glob)("**/*", {
-				cwd: resolvedBase,
-				withFileTypes: true
-			})) if (entry.isFile()) keys.push(require_memoryStorage.toPosixPath((0, node_path.relative)(resolvedBase, (0, node_path.join)(entry.parentPath, entry.name))));
-		} catch (_error) {}
-		return keys;
-	},
-	async clear(base) {
-		if (!base) return;
-		await require_memoryStorage.clean((0, node_path.resolve)(base));
-	}
-}));
-//#endregion
-//#region src/createKubb.ts
-/**
-* Builds a `Storage` view scoped to the file paths produced by the current build.
-* Reads delegate to the underlying `storage` so source bytes stay where they were
-* written. Writes register the key so subsequent reads and `getKeys` are scoped
-* to this build's output.
-*/
-function createSourcesView(storage) {
-	const paths = /* @__PURE__ */ new Set();
-	return require_memoryStorage.createStorage(() => ({
-		name: `${storage.name}:sources`,
+const fsStorage = createStorage(() => {
+	const limit = createLimiter(WRITE_CONCURRENCY);
+	return {
+		name: "fs",
 		async hasItem(key) {
-			return paths.has(key) && await storage.hasItem(key);
+			try {
+				await (0, node_fs_promises.access)((0, node_path.resolve)(key));
+				return true;
+			} catch (_error) {
+				return false;
+			}
 		},
 		async getItem(key) {
-			return paths.has(key) ? storage.getItem(key) : null;
+			try {
+				return await (0, node_fs_promises.readFile)((0, node_path.resolve)(key), "utf8");
+			} catch (_error) {
+				return null;
+			}
 		},
 		async setItem(key, value) {
-			paths.add(key);
-			await storage.setItem(key, value);
+			await limit(() => require_usingCtx.write((0, node_path.resolve)(key), value, { sanity: false }));
 		},
 		async removeItem(key) {
-			paths.delete(key);
-			await storage.removeItem(key);
+			await (0, node_fs_promises.rm)((0, node_path.resolve)(key), { force: true });
 		},
 		async getKeys(base) {
-			if (!base) return [...paths];
-			const result = [];
-			for (const key of paths) if (key.startsWith(base)) result.push(key);
-			return result;
+			const resolvedBase = (0, node_path.resolve)(base ?? process.cwd());
+			const keys = [];
+			try {
+				for await (const entry of (0, node_fs_promises.glob)("**/*", {
+					cwd: resolvedBase,
+					withFileTypes: true
+				})) if (entry.isFile()) keys.push(require_usingCtx.toPosixPath((0, node_path.relative)(resolvedBase, (0, node_path.join)(entry.parentPath, entry.name))));
+			} catch (_error) {}
+			return keys;
 		},
-		async clear() {
-			paths.clear();
-			await storage.clear();
+		async clear(base) {
+			if (!base) return;
+			await require_usingCtx.clean((0, node_path.resolve)(base));
 		}
-	}))();
-}
+	};
+});
+//#endregion
+//#region src/createKubb.ts
 function resolveConfig(userConfig) {
 	return {
 		...userConfig,
@@ -2248,7 +1958,7 @@ var Kubb = class {
 	#storage = null;
 	constructor(userConfig, options = {}) {
 		this.config = resolveConfig(userConfig);
-		this.hooks = options.hooks ?? new require_memoryStorage.AsyncEventEmitter();
+		this.hooks = options.hooks ?? new require_usingCtx.AsyncEventEmitter();
 	}
 	get storage() {
 		if (!this.#storage) throw new Error("[kubb] setup() must be called before accessing storage");
@@ -2264,12 +1974,11 @@ var Kubb = class {
 	async setup() {
 		const config = this.config;
 		const driver = new KubbDriver(config, { hooks: this.hooks });
-		const storage = createSourcesView(config.storage);
 		this.hooks.setMaxListeners(Math.max(10, config.plugins.length * 4));
 		if (config.output.clean) await config.storage.clear((0, node_path.resolve)(config.root, config.output.path));
 		await driver.setup();
 		this.#driver = driver;
-		this.#storage = storage;
+		this.#storage = config.storage;
 	}
 	/**
 	* Runs the full pipeline and throws on any plugin error.
@@ -2279,7 +1988,7 @@ var Kubb = class {
 		const out = await this.safeBuild();
 		if (Diagnostics.hasError(out.diagnostics)) {
 			const errors = out.diagnostics.filter(Diagnostics.isProblem).filter((diagnostic) => diagnostic.severity === "error").map((diagnostic) => diagnostic.cause ?? new Diagnostics.Error(diagnostic));
-			throw new require_memoryStorage.BuildError(`Build failed with ${errors.length} ${errors.length === 1 ? "error" : "errors"}`, { errors });
+			throw new require_usingCtx.BuildError(`Build failed with ${errors.length} ${errors.length === 1 ? "error" : "errors"}`, { errors });
 		}
 		return out;
 	}
@@ -2290,7 +1999,7 @@ var Kubb = class {
 	*/
 	async safeBuild() {
 		try {
-			var _usingCtx$1 = require_memoryStorage._usingCtx();
+			var _usingCtx$1 = require_usingCtx._usingCtx();
 			if (!this.#driver) await this.setup();
 			const cleanup = _usingCtx$1.u(this);
 			const driver = cleanup.driver;
@@ -2374,22 +2083,19 @@ const logLevel = {
 * ```
 */
 function createReporter(reporter) {
-	const drain = reporter.drain;
-	if (!drain) return {
-		name: reporter.name,
-		async report(result, context) {
-			await reporter.report(result, context);
-		}
-	};
-	const reports = [];
+	const reports = /* @__PURE__ */ new Set();
 	return {
 		name: reporter.name,
 		async report(result, context) {
-			reports.push(await reporter.report(result, context));
+			const report = await reporter.report(result, context);
+			reports.add(report);
 		},
 		async drain(context) {
-			await drain(context, reports);
-			reports.length = 0;
+			await reporter.drain?.(context, Array.from(reports));
+			reports.clear();
+		},
+		[Symbol.dispose]() {
+			reports.clear();
 		}
 	};
 }
@@ -2562,7 +2268,7 @@ const fileReporter = createReporter({
 			Date.now()
 		].filter(Boolean).join("-")}.log`;
 		const pathName = (0, node_path.resolve)(node_process.default.cwd(), ".kubb", baseName);
-		await require_memoryStorage.write(pathName, `${content}\n`);
+		await require_usingCtx.write(pathName, `${content}\n`);
 		console.error(`Debug log written to ${(0, node_path.relative)(node_process.default.cwd(), pathName)}`);
 	}
 });
@@ -2680,24 +2386,74 @@ function defineParser(parser) {
 	return parser;
 }
 //#endregion
-exports.AsyncEventEmitter = require_memoryStorage.AsyncEventEmitter;
+//#region src/storages/memoryStorage.ts
+/**
+* In-memory storage driver. Useful for testing and dry-run scenarios where
+* generated output should be captured without touching the filesystem.
+*
+* All data lives in a `Map` scoped to the storage instance and is discarded
+* when the instance is garbage-collected.
+*
+* @example
+* ```ts
+* import { memoryStorage } from '@kubb/core'
+* import { defineConfig } from 'kubb'
+*
+* export default defineConfig({
+*   input:  { path: './petStore.yaml' },
+*   output: { path: './src/gen' },
+*   storage: memoryStorage(),
+* })
+* ```
+*/
+const memoryStorage = createStorage(() => {
+	const store = /* @__PURE__ */ new Map();
+	return {
+		name: "memory",
+		async hasItem(key) {
+			return store.has(key);
+		},
+		async getItem(key) {
+			return store.get(key) ?? null;
+		},
+		async setItem(key, value) {
+			store.set(key, value);
+		},
+		async removeItem(key) {
+			store.delete(key);
+		},
+		async getKeys(base) {
+			const keys = [...store.keys()];
+			return base ? keys.filter((k) => k.startsWith(base)) : keys;
+		},
+		async clear(base) {
+			if (!base) {
+				store.clear();
+				return;
+			}
+			for (const key of store.keys()) if (key.startsWith(base)) store.delete(key);
+		}
+	};
+});
+//#endregion
+exports.AsyncEventEmitter = require_usingCtx.AsyncEventEmitter;
 exports.Diagnostics = Diagnostics;
 exports.KubbDriver = KubbDriver;
-exports.Url = Url;
+exports.Resolver = Resolver;
 exports.cliReporter = cliReporter;
 exports.createAdapter = createAdapter;
 exports.createKubb = createKubb;
 exports.createRenderer = createRenderer;
 exports.createReporter = createReporter;
-exports.createStorage = require_memoryStorage.createStorage;
+exports.createResolver = createResolver;
+exports.createStorage = createStorage;
 exports.defineGenerator = defineGenerator;
 exports.defineParser = defineParser;
 exports.definePlugin = definePlugin;
-exports.defineResolver = defineResolver;
 exports.fileReporter = fileReporter;
 exports.fsStorage = fsStorage;
 exports.jsonReporter = jsonReporter;
 exports.logLevel = logLevel;
-exports.memoryStorage = require_memoryStorage.memoryStorage;
+exports.memoryStorage = memoryStorage;
 
 //# sourceMappingURL=index.cjs.map