@kubb/core 5.1.0 → 5.2.0

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { t as __name } from "./rolldown-runtime-C0LytTxp.js";
-import { $ as PluginFactoryOptions, A as Kubb, At as DiagnosticDoc, B as Exclude, Bt as Hookable, C as KubbWarnContext, Ct as Reporter, D as CreateKubbOptions, Dt as createReporter, E as UserConfig, Et as UserReporter, F as NodeCache, Ft as PerformanceDiagnostic, G as KubbPluginSetupContext, H as Group, Ht as AdapterFactoryOptions, I as KubbDriver, It as ProblemCode, J as Output, K as KubbPluginStartContext, L as FileManagerHooks, Lt as ProblemDiagnostic, M as Generator, Mt as DiagnosticLocation, N as GeneratorContext, Nt as DiagnosticSeverity, O as GenerateOptions, Ot as logLevel, P as defineGenerator, Pt as Diagnostics, Q as Plugin, R as Parser, Rt as SerializedDiagnostic, S as KubbSuccessContext, St as GenerationResult, T as PostGenerateCommand, Tt as ReporterName, U as Include, Ut as AdapterSource, V as Filter, Vt as Adapter, W as KubbPluginEndContext, Wt as createAdapter, X as OutputOptions, Y as OutputMode, Z as Override, _ as KubbHookStartContext, _t as Renderer, a as KubbBuildEndContext, at as ResolveBannerFile, b as KubbLifecycleStartContext, bt as Storage, c as KubbErrorContext, ct as ResolveOptionsContext, d as KubbFilesProcessingStartContext, dt as ResolverDefault, et as PluginName, f as KubbFilesProcessingUpdateContext, ft as ResolverFile, g as KubbHookLineContext, gt as ResolverPathParams, h as KubbHookEndContext, ht as ResolverPatch, i as Input, it as ResolveBannerContext, j as createKubb, jt as DiagnosticKind, k as GenerateResult, kt as Diagnostic, l as KubbFileProcessingUpdate, lt as ResolvePathOptions, m as KubbGenerationStartContext, mt as ResolverFilePathParams, n as CLIOptions, nt as definePlugin, o as KubbBuildStartContext, ot as ResolveFileOptions, p as KubbGenerationEndContext, pt as ResolverFileParams, q as NormalizedPlugin, r as Config, rt as BannerMeta, s as KubbDiagnosticContext, st as ResolveImportsOptions, t as BuildOutput, tt as ResolvePluginOptions, u as KubbFilesProcessingEndContext, ut as Resolver, v as KubbHooks, vt as RendererFactory, w as PossibleConfig, wt as ReporterContext, x as KubbPluginsEndContext, xt as createStorage, y as KubbInfoContext, yt as createRenderer, z as defineParser, zt as UpdateDiagnostic } from "./types-QndGMAwn.js";
+import { $ as PluginFactoryOptions, A as Kubb, At as DiagnosticDoc, B as Exclude, Bt as Hookable, C as KubbWarnContext, Ct as Reporter, D as CreateKubbOptions, Dt as createReporter, E as UserConfig, Et as UserReporter, F as NodeCache, Ft as PerformanceDiagnostic, G as KubbPluginSetupContext, H as Group, Ht as AdapterFactoryOptions, I as KubbDriver, It as ProblemCode, J as Output, K as KubbPluginStartContext, L as FileManagerHooks, Lt as ProblemDiagnostic, M as Generator, Mt as DiagnosticLocation, N as GeneratorContext, Nt as DiagnosticSeverity, O as GenerateOptions, Ot as logLevel, P as defineGenerator, Pt as Diagnostics, Q as Plugin, R as Parser, Rt as SerializedDiagnostic, S as KubbSuccessContext, St as GenerationResult, T as PostGenerateCommand, Tt as ReporterName, U as Include, Ut as AdapterSource, V as Filter, Vt as Adapter, W as KubbPluginEndContext, Wt as createAdapter, X as OutputOptions, Y as OutputMode, Z as Override, _ as KubbHookStartContext, _t as Renderer, a as KubbBuildEndContext, at as ResolveBannerFile, b as KubbLifecycleStartContext, bt as Storage, c as KubbErrorContext, ct as ResolveOptionsContext, d as KubbFilesProcessingStartContext, dt as ResolverDefault, et as PluginName, f as KubbFilesProcessingUpdateContext, ft as ResolverFile, g as KubbHookLineContext, gt as ResolverPathParams, h as KubbHookEndContext, ht as ResolverPatch, i as Input, it as ResolveBannerContext, j as createKubb, jt as DiagnosticKind, k as GenerateResult, kt as Diagnostic, l as KubbFileProcessingUpdate, lt as ResolvePathOptions, m as KubbGenerationStartContext, mt as ResolverFilePathParams, n as CLIOptions, nt as definePlugin, o as KubbBuildStartContext, ot as ResolveFileOptions, p as KubbGenerationEndContext, pt as ResolverFileParams, q as NormalizedPlugin, r as Config, rt as BannerMeta, s as KubbDiagnosticContext, st as ResolveImportsOptions, t as BuildOutput, tt as ResolvePluginOptions, u as KubbFilesProcessingEndContext, ut as Resolver, v as KubbHooks, vt as RendererFactory, w as PossibleConfig, wt as ReporterContext, x as KubbPluginsEndContext, xt as createStorage, y as KubbInfoContext, yt as createRenderer, z as defineParser, zt as UpdateDiagnostic } from "./types-D6fWCd9O.js";
 //#region src/applyConfigDefaults.d.ts
 type ApplyConfigDefaultsOptions<TOutput> = {
   defaultAdapter: Adapter;
@@ -15,7 +15,7 @@ type ApplyConfigDefaultsOptions<TOutput> = {
  * (`barrel` is a `@kubb/plugin-barrel` extension field core doesn't know about) and pass them in,
  * so `@kubb/core` doesn't need to depend on `@kubb/adapter-oas` or `@kubb/plugin-barrel`.
  */
-declare function applyConfigDefaults<TOutput extends Config['output'] = Config['output']>(config: {
+export declare function applyConfigDefaults<TOutput extends Config['output'] = Config['output']>(config: {
   adapter?: Adapter;
   output: TOutput;
   plugins?: Array<Plugin>;
@@ -30,7 +30,7 @@ declare function applyConfigDefaults<TOutput extends Config['output'] = Config['
  * The default `cli` reporter. Renders the {@link Report} for each config as it finishes, independent
  * of the live logger view. Suppressed at `silent`. The `verbose` level adds the per-plugin timings.
  */
-declare const cliReporter: Reporter;
+export declare const cliReporter: Reporter;
 //#endregion
 //#region src/reporters/fileReporter.d.ts
 /**
@@ -43,7 +43,7 @@ declare const cliReporter: Reporter;
  * `kubb:info`/`kubb:plugin` hook stream. Color is stripped so the file stays plain text even when
  * the run is attached to a TTY.
  */
-declare const fileReporter: Reporter;
+export declare const fileReporter: Reporter;
 //#endregion
 //#region src/reporters/jsonReporter.d.ts
 /**
@@ -53,7 +53,7 @@ declare const fileReporter: Reporter;
  * objects that would break `jq .`. The terminal reporter is suppressed while `json` is active so
  * stdout stays valid JSON.
  */
-declare const jsonReporter: Reporter;
+export declare const jsonReporter: Reporter;
 //#endregion
 //#region src/createResolver.d.ts
 /**
@@ -110,7 +110,7 @@ type ResolverOptions<T extends PluginFactoryOptions> = Omit<T['resolver'], keyof
  * })
  * ```
  */
-declare function createResolver<T extends PluginFactoryOptions>(options: ResolverOptions<T>): T['resolver'];
+export declare function createResolver<T extends PluginFactoryOptions>(options: ResolverOptions<T>): T['resolver'];
 //#endregion
 //#region src/input.d.ts
 /**
@@ -129,7 +129,7 @@ type InputKind = 'file' | 'url' | 'inline' | 'object';
  * meaning it starts with `{` or `[`, spans multiple lines, or opens with a YAML `openapi:` or
  * `swagger:` key. Otherwise a string is a `url` when it parses as one, or a `file` path.
  */
-declare function getInputKind(input: NonNullable<Input>): InputKind;
+export declare function getInputKind(input: NonNullable<Input>): InputKind;
 //#endregion
 //#region src/storages/fsStorage.d.ts
 /**
@@ -160,7 +160,7 @@ declare function getInputKind(input: NonNullable<Input>): InputKind;
  * })
  * ```
  */
-declare const fsStorage: (options?: Record<string, never> | undefined) => Storage;
+export declare const fsStorage: (options?: Record<string, never> | undefined) => Storage;
 //#endregion
 //#region src/storages/memoryStorage.d.ts
 /**
@@ -182,7 +182,7 @@ declare const fsStorage: (options?: Record<string, never> | undefined) => Storag
  * })
  * ```
  */
-declare const memoryStorage: (options?: Record<string, never> | undefined) => Storage;
+export declare const memoryStorage: (options?: Record<string, never> | undefined) => Storage;
 //#endregion
-export { type Adapter, type AdapterFactoryOptions, type AdapterSource, type BannerMeta, BuildOutput, CLIOptions, Config, type CreateKubbOptions, type Diagnostic, type DiagnosticDoc, type DiagnosticKind, type DiagnosticLocation, type DiagnosticSeverity, Diagnostics, type Exclude, type FileManagerHooks, type Filter, type GenerateOptions, type GenerateResult, type GenerationResult, type Generator, type GeneratorContext, type Group, Hookable, type Include, Input, type InputKind, type Kubb, KubbBuildEndContext, KubbBuildStartContext, KubbDiagnosticContext, KubbDriver, KubbErrorContext, KubbFileProcessingUpdate, KubbFilesProcessingEndContext, KubbFilesProcessingStartContext, KubbFilesProcessingUpdateContext, KubbGenerationEndContext, KubbGenerationStartContext, KubbHookEndContext, KubbHookLineContext, KubbHookStartContext, KubbHooks, KubbInfoContext, KubbLifecycleStartContext, type KubbPluginEndContext, type KubbPluginSetupContext, type KubbPluginStartContext, KubbPluginsEndContext, KubbSuccessContext, KubbWarnContext, type NodeCache, type NormalizedPlugin, type Output, type OutputMode, type OutputOptions, type Override, type Parser, type PerformanceDiagnostic, type Plugin, type PluginFactoryOptions, type PluginName, PossibleConfig, PostGenerateCommand, type ProblemCode, type ProblemDiagnostic, type Renderer, type RendererFactory, type Reporter, type ReporterContext, type ReporterName, type ResolveBannerContext, type ResolveBannerFile, type ResolveFileOptions, type ResolveImportsOptions, type ResolveOptionsContext, type ResolvePathOptions, type ResolvePluginOptions, Resolver, type ResolverDefault, type ResolverFile, type ResolverFileParams, type ResolverFilePathParams, type ResolverPatch, type ResolverPathParams, type SerializedDiagnostic, type Storage, type UpdateDiagnostic, UserConfig, type UserReporter, applyConfigDefaults, cliReporter, createAdapter, createKubb, createRenderer, createReporter, createResolver, createStorage, defineGenerator, defineParser, definePlugin, fileReporter, fsStorage, getInputKind, jsonReporter, logLevel, memoryStorage };
+export { type Adapter, type AdapterFactoryOptions, type AdapterSource, type BannerMeta, BuildOutput, CLIOptions, Config, type CreateKubbOptions, type Diagnostic, type DiagnosticDoc, type DiagnosticKind, type DiagnosticLocation, type DiagnosticSeverity, Diagnostics, type Exclude, type FileManagerHooks, type Filter, type GenerateOptions, type GenerateResult, type GenerationResult, type Generator, type GeneratorContext, type Group, Hookable, type Include, Input, type InputKind, type Kubb, KubbBuildEndContext, KubbBuildStartContext, KubbDiagnosticContext, KubbDriver, KubbErrorContext, KubbFileProcessingUpdate, KubbFilesProcessingEndContext, KubbFilesProcessingStartContext, KubbFilesProcessingUpdateContext, KubbGenerationEndContext, KubbGenerationStartContext, KubbHookEndContext, KubbHookLineContext, KubbHookStartContext, KubbHooks, KubbInfoContext, KubbLifecycleStartContext, type KubbPluginEndContext, type KubbPluginSetupContext, type KubbPluginStartContext, KubbPluginsEndContext, KubbSuccessContext, KubbWarnContext, type NodeCache, type NormalizedPlugin, type Output, type OutputMode, type OutputOptions, type Override, type Parser, type PerformanceDiagnostic, type Plugin, type PluginFactoryOptions, type PluginName, PossibleConfig, PostGenerateCommand, type ProblemCode, type ProblemDiagnostic, type Renderer, type RendererFactory, type Reporter, type ReporterContext, type ReporterName, type ResolveBannerContext, type ResolveBannerFile, type ResolveFileOptions, type ResolveImportsOptions, type ResolveOptionsContext, type ResolvePathOptions, type ResolvePluginOptions, Resolver, type ResolverDefault, type ResolverFile, type ResolverFileParams, type ResolverFilePathParams, type ResolverPatch, type ResolverPathParams, type SerializedDiagnostic, type Storage, type UpdateDiagnostic, UserConfig, type UserReporter, createAdapter, createKubb, createRenderer, createReporter, createStorage, defineGenerator, defineParser, definePlugin, logLevel };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -1,11 +1,11 @@
-import { t as __name } from "./rolldown-runtime-C0LytTxp.js";
-import { a as OPERATION_FILTER_TYPES, c as clean, d as toPosixPath, f as write, g as camelCase, h as toError, i as Hookable, l as isPathInside, m as getErrorMessage, n as createNodeCache, o as diagnosticCode, p as BuildError, r as FileManager, s as inParallel, t as _usingCtx, u as toFilePath } from "./usingCtx-2r6N3STL.js";
+import "./rolldown-runtime-C0LytTxp.js";
+import { a as OPERATION_FILTER_TYPES, c as clean, d as write, f as getErrorMessage, i as Hookable, l as isPathInside, m as camelCase, n as createNodeCache, o as diagnosticCode, p as toError, r as FileManager, s as inParallel, t as _usingCtx, u as toPosixPath } from "./usingCtx-xMZZh-09.js";
 import { AsyncLocalStorage } from "node:async_hooks";
 import { stripVTControlCharacters, styleText } from "node:util";
-import { createHash, hash } from "node:crypto";
 import { access, glob, readFile, rm } from "node:fs/promises";
 import path, { join, relative, resolve } from "node:path";
 import { ast, collectImportedRefNames, collectUsedSchemaNames, composeMacros, operationDef, schemaDef, transform } from "@kubb/ast";
+import { hash } from "node:crypto";
 import { existsSync } from "node:fs";
 import { tmpdir } from "node:os";
 import process$1 from "node:process";
@@ -96,66 +96,11 @@ function formatMs(ms) {
 	return `${Math.round(ms)}ms`;
 }
 //#endregion
-//#region ../../internals/utils/src/colors.ts
-/**
-* Parses a CSS hex color string (`#RGB`) into its RGB channels.
-* Falls back to `255` for any channel that cannot be parsed.
-*/
-function parseHex(color) {
-	const int = Number.parseInt(color.replace("#", ""), 16);
-	return Number.isNaN(int) ? {
-		r: 255,
-		g: 255,
-		b: 255
-	} : {
-		r: int >> 16 & 255,
-		g: int >> 8 & 255,
-		b: int & 255
-	};
-}
-/**
-* Returns a function that wraps a string in a 24-bit ANSI true-color escape sequence
-* for the given hex color.
-*/
-function hex(color) {
-	const { r, g, b } = parseHex(color);
-	return (text) => `\x1b[38;2;${r};${g};${b}m${text}\x1b[0m`;
-}
-hex("#F55A17"), hex("#F5A217"), hex("#F58517"), hex("#B45309"), hex("#FFFFFF"), hex("#adadc6"), hex("#FDA4AF");
-/**
-* ANSI color names used by {@link randomCliColor} for deterministic terminal coloring.
-*/
-const randomColors = [
-	"black",
-	"red",
-	"green",
-	"yellow",
-	"blue",
-	"white",
-	"magenta",
-	"cyan",
-	"gray"
-];
-/**
-* Wraps `text` in a deterministic ANSI color derived from the text's SHA-256 hash.
-*
-* @example
-* ```ts
-* randomCliColor('petstore') // '\x1b[33m' + 'petstore' + '\x1b[39m' (always the same color for 'petstore')
-* ```
-*/
-function randomCliColor(text) {
-	if (!text) return "";
-	const index = hash("sha256", text, "buffer").readUInt32BE(0) % randomColors.length;
-	const color = randomColors[index] ?? "white";
-	return styleText(color, text);
-}
-//#endregion
 //#region src/Diagnostics.ts
 /**
 * Docs major version, derived from the package version so the link tracks the published major.
 */
-const docsMajor = "5.1.0".split(".")[0] ?? "5";
+const docsMajor = "5.2.0".split(".")[0] ?? "5";
 /**
 * Builds a type guard that narrows a {@link Diagnostic} to the variant for `kind`. A diagnostic
 * with no `kind` is treated as a `problem`.
@@ -714,6 +659,29 @@ function isNamespace(value) {
 */
 const resolverOptions = Symbol.for("@kubb/core/resolver/options");
 /**
+* Builds a nested file path from a dotted name. Splits on dots that precede a letter
+* (so version numbers embedded in operationIds like `v2025.0` stay intact), camelCases
+* every earlier segment, applies `caseLast` to the final segment, and joins with `/`.
+*
+* Empty segments are dropped before joining. They arise when the name starts with a dot
+* followed by a letter (e.g. `..Schema` splits into `['..', 'Schema']` and `'..'` cases to
+* an empty string). Without this a leading `/` would form, which `path.resolve` reads as an
+* absolute path, letting generated files escape the configured output directory.
+*
+* @example Nested path from a dotted name
+* `toFilePath('pet.petId') // 'pet/petId'`
+*
+* @example PascalCase the final segment
+* `toFilePath('pet.Pet', pascalCase) // 'pet/Pet'`
+*
+* @example Suffix applied to the final segment only
+* `toFilePath('tag.tag', (part) => camelCase(part, { suffix: 'schema' })) // 'tag/tagSchema'`
+*/
+function toFilePath(name, caseLast = camelCase) {
+	const parts = name.split(/\.(?=[a-zA-Z])/);
+	return parts.map((part, i) => i === parts.length - 1 ? caseLast(part) : camelCase(part)).filter(Boolean).join("/");
+}
+/**
 * Built-in `file.baseName`: casts the identifier with `toFilePath` and appends the extension.
 */
 function toBaseName({ name, extname }) {
@@ -1860,10 +1828,6 @@ var KubbDriver = class {
 * Bumped when the stored shape changes, so an older cache is discarded instead of misread.
 */
 const VERSION = 1;
-function hash$1(value) {
-	return createHash("sha256").update(value).digest("hex");
-}
-__name(hash$1, "hash");
 const MANIFEST_KEY = "output-manifest.json";
 async function loadEntries({ cache }) {
 	try {
@@ -1893,10 +1857,10 @@ async function createOutputManifest({ storage, cache }) {
 		isUpToDate({ key, source, disk }) {
 			const entry = entries[key];
 			if (!entry) return false;
-			return entry.source === hash$1(source) && entry.output === hash$1(disk);
+			return entry.source === hash("sha256", source) && entry.output === hash("sha256", disk);
 		},
 		track({ key, source }) {
-			tracked.set(key, hash$1(source));
+			tracked.set(key, hash("sha256", source));
 		},
 		async commit() {
 			try {
@@ -1909,7 +1873,7 @@ async function createOutputManifest({ storage, cache }) {
 						if (stored === null) return;
 						next[key] = {
 							source,
-							output: hash$1(stored)
+							output: hash("sha256", stored)
 						};
 					}
 				});
@@ -2076,7 +2040,7 @@ const fsStorage = createStorage(() => {
 function resolveCacheDir(root) {
 	const nodeModules = join(root, "node_modules");
 	if (existsSync(nodeModules)) return join(nodeModules, ".cache", "kubb");
-	return join(tmpdir(), "kubb", createHash("sha256").update(root).digest("hex").slice(0, 16));
+	return join(tmpdir(), "kubb", hash("sha256", root).slice(0, 16));
 }
 /**
 * Filesystem storage for build caches rather than generated code. Keys are plain names resolved
@@ -2214,7 +2178,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 BuildError(`Build failed with ${errors.length} ${errors.length === 1 ? "error" : "errors"}`, { errors });
+			throw new AggregateError(errors, `Build failed with ${errors.length} ${errors.length === 1 ? "error" : "errors"}`);
 		}
 		return out;
 	}
@@ -2390,6 +2354,36 @@ function createReporter(reporter) {
 	};
 }
 //#endregion
+//#region src/reporters/colors.ts
+/**
+* ANSI color names used by {@link randomCliColor} for deterministic terminal coloring.
+*/
+const randomColors = [
+	"black",
+	"red",
+	"green",
+	"yellow",
+	"blue",
+	"white",
+	"magenta",
+	"cyan",
+	"gray"
+];
+/**
+* Wraps `text` in a deterministic ANSI color derived from the text's SHA-256 hash.
+*
+* @example
+* ```ts
+* randomCliColor('petstore') // '\x1b[33m' + 'petstore' + '\x1b[39m' (always the same color for 'petstore')
+* ```
+*/
+function randomCliColor(text) {
+	if (!text) return "";
+	const index = hash("sha256", text, "buffer").readUInt32BE(0) % randomColors.length;
+	const color = randomColors[index] ?? "white";
+	return styleText(color, text);
+}
+//#endregion
 //#region src/reporters/report.ts
 /**
 * Builds the normalized {@link Report} for one config from its {@link GenerationResult}. Splits the