@kubb/core 5.0.0-beta.58 → 5.0.0-beta.59

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { t as __name } from "./chunk-C0LytTxp.js";
-import { $ as KubbPluginSetupContext, A as KubbHookStartContext, At as Adapter, B as ParsedFile, C as KubbFilesProcessingEndContext, Ct as GenerationResult, D as KubbGenerationStartContext, Dt as UserReporter, E as KubbGenerationEndContext, Et as ReporterName, F as KubbSuccessContext, G as Generator, H as createKubb, I as KubbWarnContext, J as KubbDriver, K as GeneratorContext, L as PossibleConfig, M as KubbInfoContext, Mt as AdapterSource, N as KubbLifecycleStartContext, Nt as createAdapter, O as KubbHookEndContext, Ot as createReporter, P as KubbPluginsEndContext, Pt as AsyncEventEmitter, Q as KubbPluginEndContext, R as UserConfig, S as KubbFileProcessingUpdate, St as createStorage, T as KubbFilesProcessingUpdateContext, Tt as ReporterContext, U as Parser, V as Kubb, W as defineParser, X as Group, Y as Exclude, Z as Include, _ as InputPath, _t as defineResolver, a as DiagnosticLocation, at as Override, b as KubbDiagnosticContext, bt as createRenderer, c as PerformanceDiagnostic, ct as definePlugin, d as SerializedDiagnostic, dt as ResolveBannerFile, et as KubbPluginStartContext, f as UpdateDiagnostic, ft as ResolveOptionsContext, g as InputData, gt as ResolverPathParams, h as Config, ht as ResolverFileParams, i as DiagnosticKind, it as OutputOptions, j as KubbHooks, jt as AdapterFactoryOptions, k as KubbHookLineContext, kt as logLevel, l as ProblemCode, lt as BannerMeta, m as CLIOptions, mt as ResolverContext, n as DiagnosticByCode, nt as Output, o as DiagnosticSeverity, ot as Plugin, p as BuildOutput, pt as Resolver, q as defineGenerator, r as DiagnosticDoc, rt as OutputMode, s as Diagnostics, st as PluginFactoryOptions, t as Diagnostic, tt as NormalizedPlugin, u as ProblemDiagnostic, ut as ResolveBannerContext, v as KubbBuildEndContext, vt as Renderer, w as KubbFilesProcessingStartContext, wt as Reporter, x as KubbErrorContext, xt as Storage, y as KubbBuildStartContext, yt as RendererFactory, z as FileProcessorHooks } from "./diagnostics-BNcDERWL.js";
+import { $ as KubbPluginSetupContext, A as KubbHookStartContext, At as Adapter, B as ParsedFile, C as KubbFilesProcessingEndContext, Ct as GenerationResult, D as KubbGenerationStartContext, Dt as UserReporter, E as KubbGenerationEndContext, Et as ReporterName, F as KubbSuccessContext, G as Generator, H as createKubb, I as KubbWarnContext, J as KubbDriver, K as GeneratorContext, L as PossibleConfig, M as KubbInfoContext, Mt as AdapterSource, N as KubbLifecycleStartContext, Nt as createAdapter, O as KubbHookEndContext, Ot as createReporter, P as KubbPluginsEndContext, Pt as AsyncEventEmitter, Q as KubbPluginEndContext, R as UserConfig, S as KubbFileProcessingUpdate, St as createStorage, T as KubbFilesProcessingUpdateContext, Tt as ReporterContext, U as Parser, V as Kubb, W as defineParser, X as Group, Y as Exclude, Z as Include, _ as InputPath, _t as defineResolver, a as DiagnosticLocation, at as Override, b as KubbDiagnosticContext, bt as createRenderer, c as PerformanceDiagnostic, ct as definePlugin, d as SerializedDiagnostic, dt as ResolveBannerFile, et as KubbPluginStartContext, f as UpdateDiagnostic, ft as ResolveOptionsContext, g as InputData, gt as ResolverPathParams, h as Config, ht as ResolverFileParams, i as DiagnosticKind, it as OutputOptions, j as KubbHooks, jt as AdapterFactoryOptions, k as KubbHookLineContext, kt as logLevel, l as ProblemCode, lt as BannerMeta, m as CLIOptions, mt as ResolverContext, n as DiagnosticByCode, nt as Output, o as DiagnosticSeverity, ot as Plugin, p as BuildOutput, pt as Resolver, q as defineGenerator, r as DiagnosticDoc, rt as OutputMode, s as Diagnostics, st as PluginFactoryOptions, t as Diagnostic, tt as NormalizedPlugin, u as ProblemDiagnostic, ut as ResolveBannerContext, v as KubbBuildEndContext, vt as Renderer, w as KubbFilesProcessingStartContext, wt as Reporter, x as KubbErrorContext, xt as Storage, y as KubbBuildStartContext, yt as RendererFactory, z as FileProcessorHooks } from "./diagnostics-B-UZnFqP.js";
 import * as ast from "@kubb/ast";
 
 //#region ../../internals/utils/src/url.d.ts
@@ -104,7 +104,7 @@ declare class Url {
 //#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.
+ * of the live logger view. Suppressed at `silent`. The `verbose` level adds the per-plugin timings.
  */
 declare const cliReporter: Reporter;
 //#endregion

package/dist/index.js

@@ -1,7 +1,7 @@
 import "./chunk-C0LytTxp.js";
-import { a as createStorage, c as camelCase, d as BuildError, f as getErrorMessage, i as FileManager, l as pascalCase, n as _usingCtx, o as OPERATION_FILTER_TYPES, r as FileProcessor, s as diagnosticCode, t as memoryStorage, u as AsyncEventEmitter } from "./memoryStorage-DZYKdzI6.js";
-import { hash } from "node:crypto";
+import { a as createStorage, c as camelCase, d as BuildError, f as getErrorMessage, i as FileManager, l as pascalCase, n as _usingCtx, o as OPERATION_FILTER_TYPES, r as FileProcessor, s as diagnosticCode, t as memoryStorage, u as AsyncEventEmitter } from "./memoryStorage-CWFzAz4o.js";
 import { stripVTControlCharacters, styleText } from "node:util";
+import { hash } from "node:crypto";
 import { access, glob, mkdir, readFile, rm, writeFile } from "node:fs/promises";
 import path, { dirname, join, relative, resolve } from "node:path";
 import * as ast from "@kubb/ast";
@@ -573,9 +573,8 @@ var Url = class Url {
 //#region src/createAdapter.ts
 /**
 * Defines a custom adapter that translates a spec format into Kubb's universal
-* AST. Use this when you need to consume GraphQL, gRPC, AsyncAPI, or another
-* domain-specific schema. Built-in adapters: `@kubb/adapter-oas` for
-* OpenAPI/Swagger documents.
+* 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.
@@ -607,9 +606,9 @@ function createAdapter(build) {
 //#endregion
 //#region src/diagnostics.ts
 /**
-* Docs major, derived from the package version so the link tracks the published major.
+* Docs major version, derived from the package version so the link tracks the published major.
 */
-const docsMajor = "5.0.0-beta.58".split(".")[0] ?? "5";
+const docsMajor = "5.0.0-beta.59".split(".")[0] ?? "5";
 /**
 * Narrows a {@link Diagnostic} to the variant for `code`, or `null` when it does not match.
 *
@@ -1056,8 +1055,7 @@ function normalizeOutput({ output, group, pluginName }) {
 }
 /**
 * Wraps a plugin factory and returns a function that accepts user options and
-* yields a fully typed `Plugin`. Lifecycle handlers go inside a single
-* `hooks` object (inspired by Astro integrations).
+* yields a typed `Plugin`. Lifecycle handlers go inside a single `hooks` object.
 *
 * Pass a `PluginFactoryOptions` type parameter to get a typed `ctx` inside
 * `kubb:plugin:setup`. Plugin names should follow the `plugin-<feature>`
@@ -1209,8 +1207,8 @@ function defaultResolveOptions(node, { options, exclude = [], include, override
 /**
 * 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
+* - `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.
@@ -1447,8 +1445,8 @@ function defaultResolveFooter(meta, { output, file }) {
 * - `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`,
-* which keeps custom rules small (`this.default(name, 'type')` to delegate).
+* 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')`.
 *
 * @example Basic resolver with naming helpers
 * ```ts
@@ -1560,7 +1558,8 @@ var KubbDriver = class {
 	config;
 	options;
 	/**
-	* The streaming `InputNode<true>` produced by the adapter.   * Always set after adapter setup, parse-only adapters are wrapped automatically.
+	* The streaming `InputNode<true>` produced by the adapter. Set after adapter setup.
+	* Parse-only adapters are wrapped automatically.
 	*/
 	inputNode = null;
 	adapter = null;
@@ -1937,7 +1936,7 @@ var KubbDriver = class {
 	*
 	* 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
+	* 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.
 	*
 	* When `entries` is empty or `this.inputNode` is `null`, every entry still gets a
@@ -2677,7 +2676,7 @@ function renderSummary(lines, { title, 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.
+* of the live logger view. Suppressed at `silent`. The `verbose` level adds the per-plugin timings.
 */
 const cliReporter = createReporter({
 	name: "cli",
@@ -2799,10 +2798,9 @@ const jsonReporter = createReporter({
 * (JSX, a template string, a tree of any shape) into `FileNode`s that get
 * written to disk.
 *
-* Use this to support output formats beyond JSX, for instance, a Handlebars
-* renderer, a string-template renderer, or a renderer that writes binary
-* files. Plugins and generators pick the renderer to use via the `renderer`
-* field on `defineGenerator`.
+* A renderer can target output formats beyond JSX, for instance a Handlebars
+* renderer or one that writes binary files. Plugins and generators pick the
+* renderer to use via the `renderer` field on `defineGenerator`.
 *
 * @example A minimal renderer that wraps a custom runtime
 * ```ts