@kubb/core 5.3.8 → 5.3.9

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { t as __name } from "./rolldown-runtime-C0LytTxp.js";
-import { $ as Plugin, A as GenerateResult, At as logLevel, B as defineParser, Bt as SerializedDiagnostic, C as KubbSuccessContext, Ct as GenerationResult, D as UserConfig, Dt as ReporterPluginFiles, E as PostGenerateCommand, Et as ReporterName, F as defineGenerator, Ft as DiagnosticSeverity, G as KubbPluginEndContext, Gt as AdapterSource, H as Filter, Ht as Hookable, I as NodeCache, It as Diagnostics, J as NormalizedPlugin, K as KubbPluginSetupContext, Kt as createAdapter, L as KubbDriver, Lt as PerformanceDiagnostic, M as createKubb, Mt as DiagnosticDoc, N as Generator, Nt as DiagnosticKind, O as CreateKubbOptions, Ot as UserReporter, P as GeneratorContext, Pt as DiagnosticLocation, Q as Override, R as FileManagerHooks, Rt as ProblemCode, S as KubbPluginsEndContext, St as createStorage, T as PossibleConfig, Tt as ReporterContext, U as Group, Ut as Adapter, V as Exclude, Vt as UpdateDiagnostic, W as Include, Wt as AdapterFactoryOptions, X as OutputMode, Y as Output, Z as OutputOptions, _ as KubbHookLineContext, _t as ResolverPathParams, a as KubbBuildEndContext, at as ResolveBannerContext, b as KubbInfoContext, bt as createRenderer, c as KubbErrorContext, ct as ResolveImportsOptions, d as KubbFilesProcessingStartContext, dt as Resolver, et as PluginFactoryOptions, f as KubbFilesProcessingUpdateContext, ft as ResolverDefault, g as KubbHookEndContext, gt as ResolverPatch, h as KubbGenerationSummaryContext, ht as ResolverFilePathParams, i as Input, it as BannerMeta, j as Kubb, jt as Diagnostic, k as GenerateOptions, kt as createReporter, l as KubbFileProcessingUpdate, lt as ResolveOptionsContext, m as KubbGenerationStartContext, mt as ResolverFileParams, n as CLIOptions, nt as ResolvePluginOptions, o as KubbBuildStartContext, ot as ResolveBannerFile, p as KubbGenerationEndContext, pt as ResolverFile, q as KubbPluginStartContext, r as Config, rt as definePlugin, s as KubbDiagnosticContext, st as ResolveFileOptions, t as BuildOutput, tt as PluginName, u as KubbFilesProcessingEndContext, ut as ResolvePathOptions, v as KubbHookStartContext, vt as Renderer, w as KubbWarnContext, wt as Reporter, x as KubbLifecycleStartContext, xt as Storage, y as KubbHooks, yt as RendererFactory, z as Parser, zt as ProblemDiagnostic } from "./types-Cw20YGzh.js";
+import { $ as OutputMode, A as SummaryRenderer, At as ReporterPluginFiles, B as KubbDriver, Bt as PerformanceDiagnostic, C as KubbSuccessContext, Ct as createRenderer, D as UserConfig, Dt as Reporter, E as PostGenerateCommand, Et as GenerationResult, F as createKubb, Ft as DiagnosticDoc, G as Filter, Gt as Hookable, H as Parser, Ht as ProblemDiagnostic, I as Generator, It as DiagnosticKind, J as KubbPluginEndContext, Jt as AdapterSource, K as Group, Kt as Adapter, L as GeneratorContext, Lt as DiagnosticLocation, M as GenerateOptions, Mt as createReporter, N as GenerateResult, Nt as logLevel, O as InputKind, Ot as ReporterContext, P as Kubb, Pt as Diagnostic, Q as Output, R as defineGenerator, Rt as DiagnosticSeverity, S as KubbPluginsEndContext, St as RendererFactory, T as PossibleConfig, Tt as createStorage, U as defineParser, Ut as SerializedDiagnostic, V as FileManagerHooks, Vt as ProblemCode, W as Exclude, Wt as UpdateDiagnostic, X as KubbPluginStartContext, Y as KubbPluginSetupContext, Yt as createAdapter, Z as NormalizedPlugin, _ as KubbHookLineContext, _t as ResolverFileParams, a as KubbBuildEndContext, at as ResolvePluginOptions, b as KubbInfoContext, bt as ResolverPathParams, c as KubbErrorContext, ct as ResolveBannerContext, d as KubbFilesProcessingStartContext, dt as ResolveImportsOptions, et as OutputOptions, f as KubbFilesProcessingUpdateContext, ft as ResolveOptionsContext, g as KubbHookEndContext, gt as ResolverFile, h as KubbGenerationSummaryContext, ht as ResolverDefault, i as Input, it as PluginName, j as CreateKubbOptions, jt as UserReporter, k as getInputKind, kt as ReporterName, l as KubbFileProcessingUpdate, lt as ResolveBannerFile, m as KubbGenerationStartContext, mt as Resolver, n as CLIOptions, nt as Plugin, o as KubbBuildStartContext, ot as definePlugin, p as KubbGenerationEndContext, pt as ResolvePathOptions, q as Include, qt as AdapterFactoryOptions, r as Config, rt as PluginFactoryOptions, s as KubbDiagnosticContext, st as BannerMeta, t as BuildOutput, tt as Override, u as KubbFilesProcessingEndContext, ut as ResolveFileOptions, v as KubbHookStartContext, vt as ResolverFilePathParams, w as KubbWarnContext, wt as Storage, x as KubbLifecycleStartContext, xt as Renderer, y as KubbHooks, yt as ResolverPatch, z as NodeCache, zt as Diagnostics } from "./types-DKzghz5i.js";
 //#region src/applyConfigDefaults.d.ts
 type ApplyConfigDefaultsOptions<TOutput> = {
   defaultAdapter: Adapter;
@@ -27,8 +27,23 @@ export declare function applyConfigDefaults<TOutput extends Config['output'] = C
 //#endregion
 //#region src/reporters/cliReporter.d.ts
 /**
- * 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.
+ * Builds a `cli` reporter that renders the {@link Report} for each config as it finishes.
+ * Suppressed at `silent`. The `verbose` level adds the per-plugin timings.
+ *
+ * Pass `render` to send the summary through output the host already owns, so it lands inside that
+ * host's grouping instead of alongside it. Omit it for the plain `console.log` writer.
+ *
+ * @example
+ * ```ts
+ * const reporter = createCliReporter({ render: (lines) => lines.forEach((line) => clack.log.message(line)) })
+ * ```
+ */
+export declare function createCliReporter({ render }?: {
+  render?: SummaryRenderer;
+}): Reporter;
+/**
+ * The default `cli` reporter, writing its summary straight to the console. Independent of the live
+ * logger view.
  */
 export declare const cliReporter: Reporter;
 //#endregion
@@ -118,25 +133,6 @@ type ResolverOptions<T extends PluginFactoryOptions> = Omit<T['resolver'], keyof
  */
 export declare function createResolver<T extends PluginFactoryOptions>(options: ResolverOptions<T>): T['resolver'];
 //#endregion
-//#region src/input.d.ts
-/**
- * What an `input` value points at, once Kubb has looked at it.
- *
- * - `file` is a local file path, absolute or relative to the config file.
- * - `url` is a remote document to fetch.
- * - `inline` is OpenAPI content held in the string itself (JSON or YAML).
- * - `object` is an already-parsed spec.
- */
-type InputKind = 'file' | 'url' | 'inline' | 'object';
-/**
- * Classifies an `input` value so callers branch on it once instead of repeating the checks.
- *
- * A non-string is a parsed spec (`object`). A string is `inline` when it holds OpenAPI content,
- * 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.
- */
-export declare function getInputKind(input: NonNullable<Input>): InputKind;
-//#endregion
 //#region src/storages/fsStorage.d.ts
 /**
  * Built-in filesystem storage driver.
@@ -190,5 +186,5 @@ export declare const fsStorage: (options?: Record<string, never> | undefined) =>
  */
 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, KubbGenerationSummaryContext, 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 ReporterPluginFiles, 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 };
+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, KubbGenerationSummaryContext, 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 ReporterPluginFiles, 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 SummaryRenderer, type UpdateDiagnostic, UserConfig, type UserReporter, createAdapter, createKubb, createRenderer, createReporter, createStorage, defineGenerator, defineParser, definePlugin, getInputKind, logLevel };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -125,7 +125,7 @@ function formatMs(ms) {
 /**
 * Docs major version, derived from the package version so the link tracks the published major.
 */
-const docsMajor = "5.3.8".split(".")[0] ?? "5";
+const docsMajor = "5.3.9".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`.
@@ -2406,36 +2406,6 @@ 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
@@ -2469,12 +2439,43 @@ function buildReport(result) {
 	};
 }
 //#endregion
-//#region src/reporters/cliReporter.ts
+//#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"
+];
 /**
-* Builds the vitest/jest-style summary for one {@link Report}: right-aligned dim labels with
-* `N passed (total)` counts, and a per-plugin `Timings` section when `showTimings`.
+* 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 buildSummaryLines(report, { showTimings }) {
+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/summary.ts
+/**
+* Formats the vitest/jest-style summary for one {@link Report}: right-aligned dim labels with
+* `N passed (total)` counts, and a per-plugin `Timings` section when `showTimings`. Pure, so a host
+* can render the same lines through whatever output it already owns.
+*/
+function formatSummary(report, { showTimings }) {
 	const { status, plugins, counts, filesCreated, durationMs, output, timings } = report;
 	const rows = [];
 	rows.push(["Plugins", status === "success" ? `${styleText("green", `${plugins.passed} passed`)} (${plugins.total})` : `${styleText("green", `${plugins.passed} passed`)} | ${styleText("red", `${plugins.failed.length} failed`)} (${plugins.total})`]);
@@ -2501,30 +2502,47 @@ function buildSummaryLines(report, { showTimings }) {
 	}
 	return lines;
 }
+//#endregion
+//#region src/reporters/cliReporter.ts
 /**
 * Renders the summary as plain `console.log` lines so it works in every CLI (no clack/TTY
 * dependency): a blank line, the config name colored by status, then the summary rows.
 */
-function renderSummary(lines, { title, status }) {
+const consoleRenderer = (lines, { title, status }) => {
 	console.log("");
 	if (title) console.log(styleText(status === "failed" ? "red" : "green", title));
 	for (const line of lines) console.log(line);
+};
+/**
+* Builds a `cli` reporter that renders the {@link Report} for each config as it finishes.
+* Suppressed at `silent`. The `verbose` level adds the per-plugin timings.
+*
+* Pass `render` to send the summary through output the host already owns, so it lands inside that
+* host's grouping instead of alongside it. Omit it for the plain `console.log` writer.
+*
+* @example
+* ```ts
+* const reporter = createCliReporter({ render: (lines) => lines.forEach((line) => clack.log.message(line)) })
+* ```
+*/
+function createCliReporter({ render = consoleRenderer } = {}) {
+	return createReporter({
+		name: "cli",
+		report(result, { logLevel: logLevel$1 }) {
+			if (logLevel$1 <= logLevel.silent) return;
+			const report = buildReport(result);
+			render(formatSummary(report, { showTimings: logLevel$1 >= logLevel.verbose }), {
+				title: report.name,
+				status: report.status
+			});
+		}
+	});
 }
 /**
-* 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.
+* The default `cli` reporter, writing its summary straight to the console. Independent of the live
+* logger view.
 */
-const cliReporter = createReporter({
-	name: "cli",
-	report(result, { logLevel: logLevel$1 }) {
-		if (logLevel$1 <= logLevel.silent) return;
-		const report = buildReport(result);
-		renderSummary(buildSummaryLines(report, { showTimings: logLevel$1 >= logLevel.verbose }), {
-			title: report.name,
-			status: report.status
-		});
-	}
-});
+const cliReporter = createCliReporter();
 //#endregion
 //#region src/reporters/fileReporter.ts
 /**
@@ -2812,6 +2830,6 @@ const memoryStorage = createStorage(() => {
 	};
 });
 //#endregion
-export { Diagnostics, Hookable, KubbDriver, Resolver, applyConfigDefaults, cliReporter, createAdapter, createKubb, createRenderer, createReporter, createResolver, createStorage, defineGenerator, defineParser, definePlugin, fileReporter, fsStorage, getInputKind, htmlReporter, jsonReporter, logLevel, memoryStorage };
+export { Diagnostics, Hookable, KubbDriver, Resolver, applyConfigDefaults, cliReporter, createAdapter, createCliReporter, createKubb, createRenderer, createReporter, createResolver, createStorage, defineGenerator, defineParser, definePlugin, fileReporter, fsStorage, getInputKind, htmlReporter, jsonReporter, logLevel, memoryStorage };
 
 //# sourceMappingURL=index.js.map