@kubb/core 5.0.0-beta.57 → 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-Bf2bC8lV.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,12 +1,14 @@
 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-B0W-w994.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";
-import { collectUsedSchemaNames, createFile, createStreamInput, operationDef, schemaDef, transform } from "@kubb/ast";
+import { operationDef, schemaDef, transform } from "@kubb/ast";
 import { AsyncLocalStorage } from "node:async_hooks";
+import * as factory from "@kubb/ast/factory";
+import { collectUsedSchemaNames } from "@kubb/ast/utils";
 import process$1 from "node:process";
 //#region ../../internals/utils/src/time.ts
 /**
@@ -571,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.
@@ -590,7 +591,7 @@ var Url = class Url {
 *   document: null,
 *   async parse(_source) {
 *     // Convert `source` (path or inline data) into an InputNode.
-*     return ast.createInput()
+*     return ast.factory.createInput()
 *   },
 *   getImports: () => [],
 *   async validate() {
@@ -605,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.57".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.
 *
@@ -1054,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>`
@@ -1207,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.
@@ -1309,7 +1309,7 @@ function defaultResolveFile({ name, extname, tag, path: groupPath }, context) {
 		tag,
 		path: groupPath
 	}, context);
-	return createFile({
+	return factory.createFile({
 		path: filePath,
 		baseName: path.basename(filePath),
 		meta: { pluginName: this.pluginName },
@@ -1445,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
@@ -1558,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;
@@ -1647,7 +1648,7 @@ var KubbDriver = class {
 	/**
 	* 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 `createStreamInput` so the dispatch loop
+	* Adapters with only `parse()` are wrapped via `factory.createInput({ stream: true })` so the dispatch loop
 	* stays stream-only.
 	*/
 	async #parseInput() {
@@ -1659,7 +1660,12 @@ var KubbDriver = class {
 			return;
 		}
 		const parsed = await adapter.parse(source);
-		this.inputNode = createStreamInput(arrayToAsyncIterable(parsed.schemas), arrayToAsyncIterable(parsed.operations), parsed.meta);
+		this.inputNode = factory.createInput({
+			stream: true,
+			schemas: arrayToAsyncIterable(parsed.schemas),
+			operations: arrayToAsyncIterable(parsed.operations),
+			meta: parsed.meta
+		});
 	}
 	/**
 	* Registers a hook-style plugin's lifecycle handlers on the shared `AsyncEventEmitter`.
@@ -1703,7 +1709,7 @@ var KubbDriver = class {
 						}
 					},
 					injectFile: (userFileNode) => {
-						this.fileManager.add(createFile(userFileNode));
+						this.fileManager.add(factory.createFile(userFileNode));
 					}
 				};
 				return hooks["kubb:plugin:setup"](pluginCtx);
@@ -1930,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
@@ -2670,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",
@@ -2792,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
@@ -2861,14 +2866,15 @@ function defineGenerator(generator) {
 *
 * @example
 * ```ts
-* import { defineParser, ast } from '@kubb/core'
+* import { defineParser } from '@kubb/core'
+* import { extractStringsFromNodes } from '@kubb/ast/utils'
 *
 * export const jsonParser = defineParser({
 *   name: 'json',
 *   extNames: ['.json'],
 *   parse(file) {
 *     return file.sources
-*       .map((source) => ast.extractStringsFromNodes(source.nodes ?? []))
+*       .map((source) => extractStringsFromNodes(source.nodes ?? []))
 *       .join('\n')
 *   },
 *   print(...nodes) {