@kubb/core 5.11.4 → 5.11.5

package/dist/index.d.cts

@@ -321,6 +321,16 @@ type DiagnosticFormatOptions = {
    * @default 0
    */
   width?: number;
+  /**
+   * Where the diagnostic's pointer sits in the input file, when the host resolved it. Replaces the
+   * pointer on the `at` row, and an error's `human` layout draws `frame` under it.
+   */
+  position?: {
+    file: string;
+    line: number;
+    column: number;
+    frame?: Array<string>;
+  };
 };
 /**
  * A {@link Diagnostic} reduced to its JSON-safe fields plus a `docsUrl`, for
@@ -372,7 +382,7 @@ declare function serialize(diagnostic: Diagnostic): SerializedDiagnostic;
  * with `at`, `fix`, the first cause, and `Learn more` for an error, and one row for a warning.
  * `verbose` adds the full stack.
  */
-declare function format(diagnostic: Diagnostic, { audience, verbose, width }?: DiagnosticFormatOptions): Array<string>;
+declare function format(diagnostic: Diagnostic, { audience, verbose, width, position }?: DiagnosticFormatOptions): Array<string>;
 //#endregion
 //#region src/createReporter.d.ts
 /**
@@ -415,9 +425,28 @@ type GenerationResult = {
    */
   diagnostics: Array<Diagnostic>;
   /**
-   * Number of files written for this config.
+   * Number of generated files for this config, including unchanged files.
    */
   filesCreated: number;
+  /**
+   * Number of generated files whose content matches the previous output.
+   */
+  filesUnchanged?: number;
+  /**
+   * Changes compared with the output before this run, when the host collected them.
+   * Line totals include added and deleted files.
+   */
+  fileChanges?: {
+    added: number;
+    modified: number;
+    deleted: number;
+    linesAdded: number;
+    linesRemoved: number;
+  };
+  /**
+   * The result previews generation without writing output.
+   */
+  dryRun?: boolean;
   status: 'success' | 'failed';
   /**
    * `process.hrtime()` snapshot taken when this config started generating.
@@ -454,10 +483,10 @@ type Reporter = {
    */
   report: (result: GenerationResult, context: ReporterContext) => void | Promise<void>;
   /**
-   * Optional finalizer called once after the run's last config. The host wires it to
-   * `kubb:lifecycle:end`. {@link createReporter} closes it over the values that `report` returned.
+   * Runs once after the run's last config, on `kubb:lifecycle:end`. Only a reporter that collects
+   * its configs' reports into one document, such as `json`, has one.
    */
-  drain: (context: ReporterContext) => void | Promise<void>;
+  drain?: (context: ReporterContext) => void | Promise<void>;
   /**
    * Whether the host should collect files from `kubb:plugin:end` hooks.
    */
@@ -676,6 +705,19 @@ type OutputManifest = {
    */
   commit(): Promise<void>;
 };
+/**
+ * Loads the stored manifest, starting empty when it is missing, unreadable, or from an older
+ * version. `storage` holds the generated files, `cache` holds the manifest itself.
+ *
+ * @example
+ * ```ts
+ * const manifest = await createOutputManifest({ storage: config.storage, cache: cacheStorage({ root: config.root }) })
+ * ```
+ */
+export declare function createOutputManifest({ storage, cache }: {
+  storage: Storage;
+  cache: Storage;
+}): Promise<OutputManifest>;
 //#endregion
 //#region src/Hookable.d.ts
 /**
@@ -775,7 +817,7 @@ type WriteOptions = ParseOptions & {
    */
   manifest?: OutputManifest;
   /**
-   * Receives `kubb:files:processing:start`, `:update` (one batch, in input order) and `:end` for the write. `config` fills the update rows.
+   * Receives `kubb:files:processing:start`, `:update` (in input order, as files finish) and `:end` for the write. `config` fills the update rows.
    */
   hooks?: Hookable<KubbHooks>;
   config?: Config;
@@ -820,11 +862,12 @@ declare class FileManager {
    * Parses and writes every file through a bounded pool of workers. A small spec runs all its files
    * at once; a spec with thousands of files keeps at most {@link FILE_CONCURRENCY} parsed sources in
    * memory rather than holding every source, while still overlapping each file's write with the
-   * next file's parse. Files finish in whatever order they parse, so the update rows are sorted back
-   * into input order before `kubb:files:processing:update` fires once with the whole batch.
+   * next file's parse. Files finish in whatever order they parse, so each finished file flushes the
+   * run of finished files ahead of it as one `kubb:files:processing:update`, keeping rows in input order.
    *
    * A file the storage already holds is skipped, so a rebuild that generates identical output
-   * writes nothing and leaves every mtime where it was.
+   * writes nothing and leaves every mtime where it was. `kubb:files:processing:end` lists the
+   * skipped paths as `unchanged`.
    */
   write(files: Array<FileNode>, { storage, parsers, manifest, signal, hooks, config }: WriteOptions): Promise<void>;
 }
@@ -1369,6 +1412,13 @@ export type KubbBuildStartContext = FilesContext & {
    * To observe individual schemas and operations use the `kubb:generate:schema` / `kubb:generate:operation` hooks.
    */
   meta: InputMeta | undefined;
+  /**
+   * How many schemas and operations the parsed document holds, the totals for a progress display.
+   */
+  nodeCounts: {
+    schemas: number;
+    operations: number;
+  };
   /**
    * Looks up a registered plugin by name, typed by the plugin registry.
    */
@@ -1520,6 +1570,10 @@ export type KubbFilesProcessingEndContext = {
    * All files that were serialized in this batch.
    */
   files: Array<FileNode>;
+  /**
+   * Paths of the files the storage already held with the same content, so they were not written.
+   */
+  unchanged: Array<string>;
 };
 export type KubbHookStartContext = {
   /**
@@ -1757,7 +1811,7 @@ type Diagnostic = ProblemDiagnostic | PerformanceDiagnostic | UpdateDiagnostic;
  * Static helpers for working with {@link Diagnostic}s, plus the run-scoped sink
  * that lets deep code report a diagnostic without threading a callback.
  *
- * The sink lives in a single `AsyncLocalStorage` in the `@kubb/core` bundle.
+ * The sink lives in a single `AsyncLocalStorage` on `globalThis`, shared by every copy of `@kubb/core`.
  * `Diagnostics.scope` activates it for a run, so anything inside that run (the
  * adapter parse, a generator) reports through `Diagnostics.report` and lands
  * in the same run.
@@ -3097,9 +3151,11 @@ type Adapter<TOptions extends AdapterFactoryOptions = AdapterFactoryOptions> = {
   name: TOptions['name'];
   meta?: ExtensionMeta<TOptions['name']>;
   /**
-   * Resolved adapter options after defaults have been applied.
+   * The options the adapter was created with, before `setup` applied defaults, as a plugin keeps its
+   * own. Kubb Studio merges its overrides onto these, so a default derived from another option, such
+   * as `emptySchemaType` from `unknownType`, follows a change to it.
    */
-  options: TOptions['resolvedOptions'];
+  options: TOptions['options'];
   /**
    * Parsed source document after the first `parse()` call. `null` before parsing.
    */
@@ -3121,6 +3177,13 @@ type Adapter<TOptions extends AdapterFactoryOptions = AdapterFactoryOptions> = {
   validate: (input: string, options?: {
     throwOnError?: boolean;
   }) => Promise<void>;
+  /**
+   * Zero-based UTF-16 offsets of a diagnostic in `source` for a code frame, `end` exclusive; `undefined` when it cannot be found.
+   */
+  locate?: (source: string, location: DiagnosticLocation) => {
+    start: number;
+    end: number;
+  } | undefined;
 };
 /**
  * The object passed to `defineExtension` with `kind: 'adapter'`.
@@ -3353,9 +3416,7 @@ export declare function createKubb(userConfig: UserConfig, options?: CreateKubbO
 //#endregion
 //#region src/reporters/summary.d.ts
 /**
- * Writes a finished summary. The `cli` reporter formats the lines and hands them to one of these,
- * so the caller decides where they land: plain `console.log` by default, or the active logger's own
- * output when a host installs one.
+ * Writes the summary through the host's output, or plain console lines by default.
  */
 type SummaryRenderer = (lines: ReadonlyArray<string>, meta: {
   title: string;
@@ -3768,5 +3829,5 @@ export declare function readInstalledPackages({ root, packages, resolveFrom }: {
   resolveFrom?: Array<string>;
 }): Promise<Array<InstalledPackage>>;
 //#endregion
-export type { Adapter, AdapterDefinition, AdapterFactory, AdapterFactoryOptions, AdapterSource, BannerMeta, CreateKubbOptions, Diagnostic, DiagnosticDoc, DiagnosticFormatOptions, DiagnosticKind, DiagnosticLocation, DiagnosticSeverity, Exclude$1 as Exclude, ExtensionDependencies, ExtensionDependency, ExtensionDependencyRecord, ExtensionFactory, ExtensionKind, ExtensionManifest, ExtensionManifestOption, ExtensionMeta, Filter, GenerateOptions, GenerateResult, GenerationResult, Generator, GeneratorContext, Group, HookResult, Include, InputKind, InstalledPackage, JSONValue, Kubb$1 as Kubb, KubbPluginEndContext, KubbPluginSetupContext, KubbPluginStartContext, NodeCache, NormalizedPlugin, Output, OutputMode, OutputOptions, Override, Parser, ParserDefinition, ParserFactory, PerformanceDiagnostic, Plugin, PluginDefinition, PluginFactory, PluginName, PluginType, ProblemCode, ProblemDiagnostic, RegistryArtifact, RegistryDetail, RegistryEntry, RegistryGuide, RegistryIndex, Renderer, RendererFactory, Reporter, ReporterContext, ReporterName, ReporterPluginFiles, ResolveBannerContext, ResolveBannerFile, ResolveFileOptions, ResolveImportsOptions, ResolveOptionsContext, ResolvePathOptions, ResolvePluginOptions, ResolverDefault, ResolverFile, ResolverFileParams, ResolverFilePathParams, ResolverPatch, ResolverPathParams, RunHookOptions, RunOutputPassesOptions, SerializedDiagnostic, Storage, SummaryRenderer, UpdateDiagnostic, UserReporter };
+export type { Adapter, AdapterDefinition, AdapterFactory, AdapterFactoryOptions, AdapterSource, BannerMeta, CreateKubbOptions, Diagnostic, DiagnosticDoc, DiagnosticFormatOptions, DiagnosticKind, DiagnosticLocation, DiagnosticSeverity, Exclude$1 as Exclude, ExtensionDependencies, ExtensionDependency, ExtensionDependencyRecord, ExtensionFactory, ExtensionKind, ExtensionManifest, ExtensionManifestOption, ExtensionMeta, Filter, GenerateOptions, GenerateResult, GenerationResult, Generator, GeneratorContext, Group, HookResult, Include, InputKind, InstalledPackage, JSONValue, Kubb$1 as Kubb, KubbPluginEndContext, KubbPluginSetupContext, KubbPluginStartContext, NodeCache, NormalizedPlugin, Output, OutputManifest, OutputMode, OutputOptions, Override, Parser, ParserDefinition, ParserFactory, PerformanceDiagnostic, Plugin, PluginDefinition, PluginFactory, PluginName, PluginType, ProblemCode, ProblemDiagnostic, RegistryArtifact, RegistryDetail, RegistryEntry, RegistryGuide, RegistryIndex, Renderer, RendererFactory, Reporter, ReporterContext, ReporterName, ReporterPluginFiles, ResolveBannerContext, ResolveBannerFile, ResolveFileOptions, ResolveImportsOptions, ResolveOptionsContext, ResolvePathOptions, ResolvePluginOptions, ResolverDefault, ResolverFile, ResolverFileParams, ResolverFilePathParams, ResolverPatch, ResolverPathParams, RunHookOptions, RunOutputPassesOptions, SerializedDiagnostic, Storage, SummaryRenderer, UpdateDiagnostic, UserReporter };
 //# sourceMappingURL=index.d.cts.map

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { $ as NodeCache, $t as ReporterPluginFiles, A as PluginFactory, At as KubbInfoContext, B as ResolveImportsOptions, Bt as RunHookOptions, C as NormalizedPlugin, Ct as KubbGenerationEndContext, D as Override, Dt as KubbHookLineContext, E as OutputOptions, Et as KubbHookEndContext, F as definePlugin, Ft as KubbWarnContext, G as ResolverFile, Gt as RendererFactory, H as ResolvePathOptions, Ht as KubbDriver, I as BannerMeta, It as PossibleConfig, J as ResolverPatch, Jt as createStorage, K as ResolverFileParams, Kt as createRenderer, L as ResolveBannerContext, Lt as PostGenerateCommand, M as PluginType, Mt as KubbMessageContext, N as ResolvePluginOptions, Nt as KubbPluginsEndContext, O as Plugin, Ot as KubbHookStartContext, P as assertPluginOption, Pt as KubbSuccessContext, Q as defineGenerator, Qt as ReporterName, R as ResolveBannerFile, Rt as UserConfig, S as KubbPluginStartContext, St as KubbFilesProcessingUpdateContext, T as OutputMode, Tt as KubbGenerationSummaryContext, U as Resolver, Ut as Hookable, V as ResolveOptionsContext, Vt as runHook, W as ResolverDefault, Wt as Renderer, X as Generator, Xt as Reporter, Y as ResolverPathParams, Yt as GenerationResult, Z as GeneratorContext, Zt as ReporterContext, _ as Filter, _t as KubbDiagnosticContext, a as AdapterSource, an as Parser, at as Diagnostics, b as KubbPluginEndContext, bt as KubbFilesProcessingEndContext, c as ExtensionDependency, cn as defineParser, ct as ProblemDiagnostic, d as ExtensionKind, dt as CLIOptions, en as UserReporter, et as Diagnostic, f as ExtensionMeta, ft as Config, g as Exclude, gt as KubbBuildStartContext, h as resolveMeta, ht as KubbBuildEndContext, i as AdapterFactoryOptions, in as SerializedDiagnostic, it as DiagnosticSeverity, j as PluginName, jt as KubbLifecycleStartContext, k as PluginDefinition, kt as KubbHooks, l as ExtensionDependencyRecord, lt as UpdateDiagnostic, m as defineExtension, mt as Input, n as AdapterDefinition, nn as logLevel, nt as DiagnosticKind, o as createAdapter, on as ParserDefinition, ot as PerformanceDiagnostic, p as checkCompatibility, pt as FilesContext, q as ResolverFilePathParams, qt as Storage, r as AdapterFactory, rn as DiagnosticFormatOptions, rt as DiagnosticLocation, s as ExtensionDependencies, sn as ParserFactory, st as ProblemCode, t as Adapter, tn as createReporter, tt as DiagnosticDoc, u as ExtensionFactory, ut as BuildOutput, v as Group, vt as KubbErrorContext, w as Output, wt as KubbGenerationStartContext, x as KubbPluginSetupContext, xt as KubbFilesProcessingStartContext, y as Include, yt as KubbFileProcessingUpdate, z as ResolveFileOptions, zt as HookResult } from "./createAdapter-D6osJ_0O.js";
+import { $ as NodeCache, $t as ReporterContext, A as PluginFactory, At as KubbInfoContext, B as ResolveImportsOptions, Bt as RunHookOptions, C as NormalizedPlugin, Ct as KubbGenerationEndContext, D as Override, Dt as KubbHookLineContext, E as OutputOptions, Et as KubbHookEndContext, F as definePlugin, Ft as KubbWarnContext, G as ResolverFile, Gt as createOutputManifest, H as ResolvePathOptions, Ht as KubbDriver, I as BannerMeta, It as PossibleConfig, J as ResolverPatch, Jt as createRenderer, K as ResolverFileParams, Kt as Renderer, L as ResolveBannerContext, Lt as PostGenerateCommand, M as PluginType, Mt as KubbMessageContext, N as ResolvePluginOptions, Nt as KubbPluginsEndContext, O as Plugin, Ot as KubbHookStartContext, P as assertPluginOption, Pt as KubbSuccessContext, Q as defineGenerator, Qt as Reporter, R as ResolveBannerFile, Rt as UserConfig, S as KubbPluginStartContext, St as KubbFilesProcessingUpdateContext, T as OutputMode, Tt as KubbGenerationSummaryContext, U as Resolver, Ut as Hookable, V as ResolveOptionsContext, Vt as runHook, W as ResolverDefault, Wt as OutputManifest, X as Generator, Xt as createStorage, Y as ResolverPathParams, Yt as Storage, Z as GeneratorContext, Zt as GenerationResult, _ as Filter, _t as KubbDiagnosticContext, a as AdapterSource, an as DiagnosticFormatOptions, at as Diagnostics, b as KubbPluginEndContext, bt as KubbFilesProcessingEndContext, c as ExtensionDependency, cn as ParserDefinition, ct as ProblemDiagnostic, d as ExtensionKind, dt as CLIOptions, en as ReporterName, et as Diagnostic, f as ExtensionMeta, ft as Config, g as Exclude, gt as KubbBuildStartContext, h as resolveMeta, ht as KubbBuildEndContext, i as AdapterFactoryOptions, in as logLevel, it as DiagnosticSeverity, j as PluginName, jt as KubbLifecycleStartContext, k as PluginDefinition, kt as KubbHooks, l as ExtensionDependencyRecord, ln as ParserFactory, lt as UpdateDiagnostic, m as defineExtension, mt as Input, n as AdapterDefinition, nn as UserReporter, nt as DiagnosticKind, o as createAdapter, on as SerializedDiagnostic, ot as PerformanceDiagnostic, p as checkCompatibility, pt as FilesContext, q as ResolverFilePathParams, qt as RendererFactory, r as AdapterFactory, rn as createReporter, rt as DiagnosticLocation, s as ExtensionDependencies, sn as Parser, st as ProblemCode, t as Adapter, tn as ReporterPluginFiles, tt as DiagnosticDoc, u as ExtensionFactory, un as defineParser, ut as BuildOutput, v as Group, vt as KubbErrorContext, w as Output, wt as KubbGenerationStartContext, x as KubbPluginSetupContext, xt as KubbFilesProcessingStartContext, y as Include, yt as KubbFileProcessingUpdate, z as ResolveFileOptions, zt as HookResult } from "./createAdapter-DtX_MKL-.js";
 import { FileNode, Macro, UserFileNode } from "@kubb/ast";
 import { AsyncLocalStorage } from "node:async_hooks";
 //#region src/composables.d.ts
@@ -201,9 +201,7 @@ export declare function createKubb(userConfig: UserConfig, options?: CreateKubbO
 //#endregion
 //#region src/reporters/summary.d.ts
 /**
- * Writes a finished summary. The `cli` reporter formats the lines and hands them to one of these,
- * so the caller decides where they land: plain `console.log` by default, or the active logger's own
- * output when a host installs one.
+ * Writes the summary through the host's output, or plain console lines by default.
  */
 type SummaryRenderer = (lines: ReadonlyArray<string>, meta: {
   title: string;
@@ -616,5 +614,5 @@ export declare function readInstalledPackages({ root, packages, resolveFrom }: {
   resolveFrom?: Array<string>;
 }): Promise<Array<InstalledPackage>>;
 //#endregion
-export { type Adapter, type AdapterDefinition, type AdapterFactory, type AdapterFactoryOptions, type AdapterSource, type BannerMeta, BuildOutput, CLIOptions, Config, type CreateKubbOptions, type Diagnostic, type DiagnosticDoc, type DiagnosticFormatOptions, type DiagnosticKind, type DiagnosticLocation, type DiagnosticSeverity, Diagnostics, type Exclude, type ExtensionDependencies, type ExtensionDependency, type ExtensionDependencyRecord, type ExtensionFactory, type ExtensionKind, type ExtensionManifest, type ExtensionManifestOption, type ExtensionMeta, FilesContext, type Filter, type GenerateOptions, type GenerateResult, type GenerationResult, type Generator, type GeneratorContext, type Group, type HookResult, Hookable, type Include, Input, type InputKind, type InstalledPackage, type JSONValue, type Kubb, KubbBuildEndContext, KubbBuildStartContext, KubbDiagnosticContext, KubbDriver, KubbErrorContext, KubbFileProcessingUpdate, KubbFilesProcessingEndContext, KubbFilesProcessingStartContext, KubbFilesProcessingUpdateContext, KubbGenerationEndContext, KubbGenerationStartContext, KubbGenerationSummaryContext, KubbHookEndContext, KubbHookLineContext, KubbHookStartContext, KubbHooks, KubbInfoContext, KubbLifecycleStartContext, KubbMessageContext, type KubbPluginEndContext, type KubbPluginSetupContext, type KubbPluginStartContext, KubbPluginsEndContext, KubbSuccessContext, KubbWarnContext, type NodeCache, type NormalizedPlugin, type Output, type OutputMode, type OutputOptions, type Override, type Parser, type ParserDefinition, type ParserFactory, type PerformanceDiagnostic, type Plugin, type PluginDefinition, type PluginFactory, type PluginName, type PluginType, PossibleConfig, PostGenerateCommand, type ProblemCode, type ProblemDiagnostic, type RegistryArtifact, type RegistryDetail, type RegistryEntry, type RegistryGuide, type RegistryIndex, 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 RunHookOptions, type RunOutputPassesOptions, type SerializedDiagnostic, type Storage, type SummaryRenderer, type UpdateDiagnostic, UserConfig, type UserReporter, assertPluginOption, checkCompatibility, createAdapter, createRenderer, createReporter, createStorage, defineExtension, defineGenerator, defineParser, definePlugin, logLevel, resolveMeta, runHook };
+export { type Adapter, type AdapterDefinition, type AdapterFactory, type AdapterFactoryOptions, type AdapterSource, type BannerMeta, BuildOutput, CLIOptions, Config, type CreateKubbOptions, type Diagnostic, type DiagnosticDoc, type DiagnosticFormatOptions, type DiagnosticKind, type DiagnosticLocation, type DiagnosticSeverity, Diagnostics, type Exclude, type ExtensionDependencies, type ExtensionDependency, type ExtensionDependencyRecord, type ExtensionFactory, type ExtensionKind, type ExtensionManifest, type ExtensionManifestOption, type ExtensionMeta, FilesContext, type Filter, type GenerateOptions, type GenerateResult, type GenerationResult, type Generator, type GeneratorContext, type Group, type HookResult, Hookable, type Include, Input, type InputKind, type InstalledPackage, type JSONValue, type Kubb, KubbBuildEndContext, KubbBuildStartContext, KubbDiagnosticContext, KubbDriver, KubbErrorContext, KubbFileProcessingUpdate, KubbFilesProcessingEndContext, KubbFilesProcessingStartContext, KubbFilesProcessingUpdateContext, KubbGenerationEndContext, KubbGenerationStartContext, KubbGenerationSummaryContext, KubbHookEndContext, KubbHookLineContext, KubbHookStartContext, KubbHooks, KubbInfoContext, KubbLifecycleStartContext, KubbMessageContext, type KubbPluginEndContext, type KubbPluginSetupContext, type KubbPluginStartContext, KubbPluginsEndContext, KubbSuccessContext, KubbWarnContext, type NodeCache, type NormalizedPlugin, type Output, type OutputManifest, type OutputMode, type OutputOptions, type Override, type Parser, type ParserDefinition, type ParserFactory, type PerformanceDiagnostic, type Plugin, type PluginDefinition, type PluginFactory, type PluginName, type PluginType, PossibleConfig, PostGenerateCommand, type ProblemCode, type ProblemDiagnostic, type RegistryArtifact, type RegistryDetail, type RegistryEntry, type RegistryGuide, type RegistryIndex, 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 RunHookOptions, type RunOutputPassesOptions, type SerializedDiagnostic, type Storage, type SummaryRenderer, type UpdateDiagnostic, UserConfig, type UserReporter, assertPluginOption, checkCompatibility, createAdapter, createOutputManifest, createRenderer, createReporter, createStorage, defineExtension, defineGenerator, defineParser, definePlugin, logLevel, resolveMeta, runHook };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -1,10 +1,10 @@
-import { A as inParallel, C as useOptions, D as Diagnostics, E as resolveMeta, F as rm, I as write, L as writeRaw, M as isPathInside, N as listFiles, O as formatMs, P as read, R as toError, S as useKubb, T as defineExtension, _ as setMacros, b as tryUseKubb, c as Resolver, d as definePlugin, f as addGenerator, g as requirePlugin, h as kubbContext, j as existsSync$1, k as getElapsedMs, l as getInputKind, m as injectFile, n as KubbDriver, o as _usingCtx, p as addMacro, s as createResolver, t as Hookable, u as assertPluginOption, v as setOptions, w as checkCompatibility, x as useConfig, y as setResolver } from "./Hookable-C2bwJUE5.js";
+import { A as inParallel, C as useOptions, D as Diagnostics, E as resolveMeta, F as rm, I as write, L as writeRaw, M as isPathInside, N as listFiles, O as formatMs, P as read, R as toError, S as useKubb, T as defineExtension, _ as setMacros, b as tryUseKubb, c as Resolver, d as definePlugin, f as addGenerator, g as requirePlugin, h as kubbContext, j as existsSync$1, k as getElapsedMs, l as getInputKind, m as injectFile, n as KubbDriver, o as _usingCtx, p as addMacro, s as createResolver, t as Hookable, u as assertPluginOption, v as setOptions, w as checkCompatibility, x as useConfig, y as setResolver } from "./Hookable-7Kv_oj72.js";
 import { createRequire } from "node:module";
 import { isValid } from "verkit";
 import process$1 from "node:process";
 import { x } from "tinyexec";
 import { readFile } from "node:fs/promises";
-import path, { join, relative, resolve } from "node:path";
+import path, { isAbsolute, join, relative, resolve } from "node:path";
 import { chmodSync, existsSync, mkdirSync } from "node:fs";
 import { stripVTControlCharacters, styleText } from "node:util";
 import { hash, randomUUID } from "node:crypto";
@@ -845,17 +845,23 @@ const logLevel = {
 * ```
 */
 function createReporter(reporter) {
+	const { name, needsPluginFiles, drain } = reporter;
+	if (!drain) return {
+		name,
+		needsPluginFiles,
+		async report(result, context) {
+			await reporter.report(result, context);
+		}
+	};
 	const reports = [];
 	return {
-		name: reporter.name,
-		needsPluginFiles: reporter.needsPluginFiles,
+		name,
+		needsPluginFiles,
 		async report(result, context) {
-			const report = await reporter.report(result, context);
-			if (reporter.drain) reports.push(report);
+			reports.push(await reporter.report(result, context));
 		},
 		async drain(context) {
-			await reporter.drain?.(context, [...reports]);
-			reports.length = 0;
+			await drain(context, reports.splice(0));
 		}
 	};
 }
@@ -867,7 +873,7 @@ function createReporter(reporter) {
 * counts, so every reporter renders the same data.
 */
 function buildReport(result) {
-	const { config, diagnostics, filesCreated, status, hrStart } = result;
+	const { config, diagnostics, filesCreated, filesUnchanged = 0, status, hrStart } = result;
 	const failed = Diagnostics.failedPlugins(diagnostics);
 	const total = config.plugins?.length ?? 0;
 	const counts = Diagnostics.count(diagnostics);
@@ -886,6 +892,9 @@ function buildReport(result) {
 		},
 		counts,
 		filesCreated,
+		filesUnchanged,
+		fileChanges: result.fileChanges,
+		dryRun: result.dryRun,
 		durationMs: getElapsedMs(hrStart),
 		output: resolve(config.root, config.output.path),
 		timings,
@@ -895,39 +904,48 @@ function buildReport(result) {
 //#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.
+* Puts the outcome first, followed by file counts, labeled plugin results, and the output path.
+* Hosts that collect file changes get a compact diff section. Verbose output adds plugin timings.
 */
 function formatSummary(report, { showTimings }) {
-	const { status, plugins, counts, filesCreated, durationMs, output, timings } = report;
-	const rows = [];
+	const { status, plugins, counts, filesCreated, filesUnchanged, fileChanges, dryRun, durationMs, output, timings } = report;
+	const failed = status === "failed";
+	const successTone = counts.warnings ? "yellow" : "green";
+	const tone = failed ? "red" : successTone;
+	const title = (() => {
+		if (failed) return "✗ Generation failed";
+		if (dryRun) return "◇ Dry run complete";
+		if (counts.warnings) return "✓ Generation complete with warnings";
+		if (filesCreated > 0 && filesCreated === filesUnchanged) return "✓ Already up to date";
+		return "✓ Generation complete";
+	})();
+	const separator = styleText("dim", " · ");
+	const generated = Math.max(0, filesCreated - filesUnchanged);
+	const fileLabel = `${generated} ${generated === 1 ? "file" : "files"} ${dryRun ? "planned" : "generated"}`;
+	const lines = [
+		`${styleText(tone, title)}  ${styleText("dim", formatMs(durationMs))}`,
+		"",
+		`  ${styleText(generated ? "bold" : "dim", fileLabel)}${filesUnchanged ? separator + styleText("dim", `${filesUnchanged} unchanged`) : ""}`
+	];
 	const notRun = plugins.total - plugins.passed - plugins.failed.length;
-	rows.push(["Plugins", status === "success" ? `${styleText("green", `${plugins.passed} passed`)} (${plugins.total})` : [
-		styleText("green", `${plugins.passed} passed`),
-		styleText("red", `${plugins.failed.length} failed`),
+	const pluginCounts = [
+		plugins.passed > 0 ? styleText("green", `${plugins.passed} passed`) : void 0,
+		plugins.failed.length > 0 ? styleText("red", `${plugins.failed.length} failed`) : void 0,
 		notRun > 0 ? styleText("dim", `${notRun} not run`) : void 0
-	].filter(Boolean).join(" | ") + ` (${plugins.total})`]);
-	if (status === "failed" && plugins.failed.length > 0) rows.push(["Failed", plugins.failed.map((name) => styleText("red", name)).join(", ")]);
-	if (counts.errors > 0 || counts.warnings > 0) {
-		const issues = [counts.errors > 0 ? styleText("red", `${counts.errors} ${counts.errors === 1 ? "error" : "errors"}`) : void 0, counts.warnings > 0 ? styleText("yellow", `${counts.warnings} ${counts.warnings === 1 ? "warning" : "warnings"}`) : void 0].filter(Boolean).join(" | ");
-		rows.push(["Issues", issues]);
-	}
-	rows.push(["Files", `${styleText("green", String(filesCreated))} generated`]);
-	rows.push(["Duration", styleText("green", formatMs(durationMs))]);
-	rows.push(["Output", output]);
-	const labelWidth = Math.max(...rows.map(([label]) => label.length), timings.length > 0 ? 7 : 0);
-	const lines = rows.map(([label, value]) => `${styleText("dim", label.padStart(labelWidth))}  ${value}`);
+	].filter(Boolean);
+	lines.push(`  ${styleText("dim", "Plugins")}  ${pluginCounts.join(separator) || styleText("dim", "none configured")}`);
+	if (plugins.failed.length) lines.push(`  ${styleText("dim", "Failed plugins")}  ${styleText("red", plugins.failed.join(", "))}`);
+	const issues = [counts.errors > 0 ? styleText("red", `${counts.errors} ${counts.errors === 1 ? "error" : "errors"}`) : void 0, counts.warnings > 0 ? styleText("yellow", `${counts.warnings} ${counts.warnings === 1 ? "warning" : "warnings"}`) : void 0].filter(Boolean);
+	if (issues.length) lines.push(`  ${styleText("dim", "Issues")}   ${issues.join(separator)}`);
+	const destination = relative(process.cwd(), output);
+	const displayPath = destination.startsWith("..") || isAbsolute(destination) ? output : `./${destination}`;
+	lines.push(`  ${styleText("dim", failed || dryRun ? "Target" : "Output")}   ${styleText(failed ? "dim" : "cyan", displayPath)}`);
+	if (dryRun) lines.push(`  ${styleText("dim", "Nothing was written.")}`);
+	if (fileChanges) lines.push("", styleText("bold", dryRun ? "Planned file changes" : "File changes"), `  ${styleText(fileChanges.added ? "green" : "dim", `${fileChanges.added} added`)}${separator}${styleText(fileChanges.modified ? "yellow" : "dim", `${fileChanges.modified} modified`)}${separator}${styleText(fileChanges.deleted ? "red" : "dim", `${fileChanges.deleted} deleted`)}`, `  ${styleText("dim", "Lines")}  ${styleText(fileChanges.linesAdded ? "green" : "dim", `+${fileChanges.linesAdded}`)} ${styleText(fileChanges.linesRemoved ? "red" : "dim", `−${fileChanges.linesRemoved}`)}`);
 	if (showTimings && timings.length > 0) {
-		const nameWidth = Math.max(0, ...timings.map((timing) => timing.plugin.length));
-		const indent = " ".repeat(labelWidth + 2);
-		lines.push(styleText("dim", "Timings".padStart(labelWidth)));
-		for (const timing of timings) {
-			const timeStr = formatMs(timing.durationMs);
-			const barLength = Math.min(Math.ceil(timing.durationMs / 100), 10);
-			const bar = styleText("dim", "█".repeat(barLength));
-			lines.push(`${indent}${styleText("dim", "•")} ${timing.plugin.padEnd(nameWidth)} ${bar} ${timeStr}`);
-		}
+		const nameWidth = Math.max(...timings.map((timing) => timing.plugin.length));
+		lines.push("", styleText("dim", "Plugin timings"));
+		for (const timing of timings) lines.push(`  ${timing.plugin.padEnd(nameWidth)}  ${styleText("dim", formatMs(timing.durationMs))}`);
 	}
 	return lines;
 }
@@ -1366,6 +1384,6 @@ async function readInstalledPackages({ root, packages = [], resolveFrom = [] })
 	}));
 }
 //#endregion
-export { Diagnostics, Hookable, KubbDriver, Resolver, addGenerator, addMacro, assertPluginOption, cacheStorage, checkCompatibility, cliReporter, createAdapter, createCliReporter, createKubb, createRenderer, createReporter, createResolver, createStorage, defineExtension, defineGenerator, defineParser, definePlugin, fileReporter, fsStorage, getInputKind, htmlReporter, injectFile, isExtensionManifest, isPackageName, isRegistryEntry, jsonReporter, kubbContext, kubbStorage, logLevel, manifestProblems, memoryStorage, readInstalledPackages, requirePlugin, resolveCacheDir, resolveKubbDir, resolveMeta, runHook, runOutputPasses, setMacros, setOptions, setResolver, tryUseKubb, useConfig, useKubb, useOptions };
+export { Diagnostics, Hookable, KubbDriver, Resolver, addGenerator, addMacro, assertPluginOption, cacheStorage, checkCompatibility, cliReporter, createAdapter, createCliReporter, createKubb, createOutputManifest, createRenderer, createReporter, createResolver, createStorage, defineExtension, defineGenerator, defineParser, definePlugin, fileReporter, fsStorage, getInputKind, htmlReporter, injectFile, isExtensionManifest, isPackageName, isRegistryEntry, jsonReporter, kubbContext, kubbStorage, logLevel, manifestProblems, memoryStorage, readInstalledPackages, requirePlugin, resolveCacheDir, resolveKubbDir, resolveMeta, runHook, runOutputPasses, setMacros, setOptions, setResolver, tryUseKubb, useConfig, useKubb, useOptions };
 
 //# sourceMappingURL=index.js.map