@kubb/core 5.0.0-beta.54 → 5.0.0-beta.55

package/dist/{diagnostics-D_LOtOCv.d.ts → diagnostics-Bf2bC8lV.d.ts}

@@ -1,11 +1,11 @@
 import { t as __name } from "./chunk-C0LytTxp.js";
-import { FileNode, HttpMethod, ImportNode, InputMeta, InputNode, InputStreamNode, Node, OperationNode, SchemaNode, UserFileNode, Visitor } from "@kubb/ast";
+import { FileNode, HttpMethod, ImportNode, InputMeta, InputNode, Node, OperationNode, SchemaNode, UserFileNode, Visitor } from "@kubb/ast";
 
 //#region ../../internals/utils/src/asyncEventEmitter.d.ts
 /**
  * A function that can be registered as an event listener, synchronous or async.
  */
-type AsyncListener<TArgs extends unknown[]> = (...args: TArgs) => void | Promise<void>;
+type AsyncListener<TArgs extends Array<unknown>> = (...args: TArgs) => void | Promise<void>;
 /**
  * Typed `EventEmitter` that awaits all async listeners before resolving.
  * Wraps Node's `EventEmitter` with full TypeScript event-map inference.
@@ -17,7 +17,7 @@ type AsyncListener<TArgs extends unknown[]> = (...args: TArgs) => void | Promise
  * await emitter.emit('build', 'petstore') // all listeners awaited
  * ```
  */
-declare class AsyncEventEmitter<TEvents extends { [K in keyof TEvents]: unknown[] }> {
+declare class AsyncEventEmitter<TEvents extends { [K in keyof TEvents]: Array<unknown> }> {
   #private;
   /**
    * Maximum number of listeners per event before Node emits a memory-leak warning.
@@ -199,11 +199,11 @@ type Adapter<TOptions extends AdapterFactoryOptions = AdapterFactoryOptions> = {
   /**
    * Memory-efficient streaming variant of `parse()`.
    *
-   * Returns an `InputStreamNode` whose `schemas` and `operations` are `AsyncIterable`.
+   * Returns an `InputNode<true>` whose `schemas` and `operations` are `AsyncIterable`.
    * Each `for await` loop creates a fresh parse pass over the cached in-memory document.
    * No pre-built arrays are held in memory.
    */
-  stream?: (source: AdapterSource) => Promise<InputStreamNode>;
+  stream?: (source: AdapterSource) => Promise<InputNode<true>>;
 };
 type AdapterBuilder<T extends AdapterFactoryOptions> = (options: T['options']) => Adapter<T>;
 /**
@@ -238,83 +238,6 @@ type AdapterBuilder<T extends AdapterFactoryOptions> = (options: T['options']) =
  */
 declare function createAdapter<T extends AdapterFactoryOptions = AdapterFactoryOptions>(build: AdapterBuilder<T>): (options?: T['options']) => Adapter<T>;
 //#endregion
-//#region src/createCache.d.ts
-/**
- * A snapshot of a completed build: the final rendered source of every generated
- * file, keyed by its path relative to the output root. Restoring a snapshot writes
- * those sources straight to storage, skipping generation entirely.
- *
- * Paths are relative, not absolute, so the snapshot never depends on where the
- * project lives on disk.
- */
-type CachedSnapshot = {
-  /**
-   * Final source per output file, keyed by the path relative to
-   * `resolve(config.root, config.output.path)`.
-   */
-  files: Record<string, string>;
-};
-/**
- * Backend that stores build snapshots for incremental ("hot") rebuilds. When the
- * input fingerprint matches a stored key, Kubb restores the snapshot instead of
- * regenerating. Kubb ships with `fsCache` (local disk). Implement this interface to
- * back the cache with any other store.
- *
- * @see {@link createCache} to build a custom backend.
- */
-type Cache = {
-  /**
-   * Identifier used in logs and diagnostics (`'fs'`, `'memory'`).
-   */
-  readonly name: string;
-  /**
-   * Returns the snapshot stored under `key`, or `null` on a miss. A backend never
-   * throws on a miss or a transient failure. It returns `null` so the build falls
-   * through to regeneration.
-   */
-  restore(params: {
-    key: string;
-  }): Promise<CachedSnapshot | null>;
-  /**
-   * Stores `snapshot` under `key`. Only called after a successful build with no
-   * error diagnostics.
-   */
-  persist(params: {
-    key: string;
-    snapshot: CachedSnapshot;
-  }): Promise<void>;
-  /**
-   * Optional teardown called after the build. Use to flush buffers or close
-   * connections.
-   */
-  dispose?(): Promise<void>;
-};
-/**
- * Defines a custom cache backend. The builder receives user options and returns a
- * {@link Cache}. Reach for this when the filesystem backend doesn't fit, for
- * example to store snapshots in Redis or a database.
- *
- * @example In-memory cache (the built-in implementation)
- * ```ts
- * import { createCache } from '@kubb/core'
- *
- * export const memoryCache = createCache(() => {
- *   const store = new Map<string, CachedSnapshot>()
- *
- *   return {
- *     name: 'memory',
- *     async restore({ key }) {
- *       return store.get(key) ?? null
- *     },
- *     async persist({ key, snapshot }) {
- *       store.set(key, snapshot)
- *     },
- *   }
- * })
- * ```
- */
-declare function createCache<TOptions = Record<string, never>>(build: (options: TOptions) => Cache): (options?: TOptions) => Cache;
-//#endregion
 //#region src/constants.d.ts
 /**
  * Stable codes Kubb attaches to a `Diagnostic`. Each maps to a known failure mode
@@ -1406,10 +1329,9 @@ declare class KubbDriver {
   readonly config: Config;
   readonly options: Options;
   /**
-   * The streaming `InputStreamNode` produced by the adapter.
-   * Always set after adapter setup, parse-only adapters are wrapped automatically.
+   * The streaming `InputNode<true>` produced by the adapter.   * Always set after adapter setup, parse-only adapters are wrapped automatically.
    */
-  inputNode: InputStreamNode | null;
+  inputNode: InputNode<true> | null;
   adapter: Adapter | null;
   /**
    * Central file store for all generated files.
@@ -1774,47 +1696,6 @@ type Parser<TMeta extends object = object, TNode = unknown> = {
  */
 declare function defineParser<T extends Parser>(parser: T): T;
 //#endregion
-//#region src/caches/fsCache.d.ts
-/**
- * Options for {@link fsCache}.
- */
-type FsCacheOptions = {
-  /**
-   * Directory that holds the cache. Resolved against `process.cwd()` when relative.
-   *
-   * @default 'node_modules/.cache/kubb'
-   */
-  dir?: string;
-  /**
-   * Maximum number of build snapshots to keep. The least-recently-used entries are
-   * evicted once the cache grows past it.
-   *
-   * @default 50
-   */
-  maxEntries?: number;
-  /**
-   * Days a snapshot may go untouched before it is evicted.
-   *
-   * @default 7
-   */
-  ttlDays?: number;
-};
-/**
- * Local filesystem cache. Stores each build snapshot as content blobs plus an index,
- * tracked by a manifest under `node_modules/.cache/kubb/` (the Nx and Vitest
- * convention). Least-recently-used and expired entries are pruned on every persist.
- *
- * @example
- * ```ts
- * import { fsCache } from '@kubb/core'
- *
- * export default defineConfig({
- *   cache: fsCache(),
- * })
- * ```
- */
-declare const fsCache: (options?: FsCacheOptions | undefined) => Cache;
-//#endregion
 //#region src/createKubb.d.ts
 type CreateKubbOptions = {
   hooks?: AsyncEventEmitter<KubbHooks>;
@@ -2133,26 +2014,6 @@ type Config<TInput = Input> = {
    * @see {@link Storage} interface for implementing custom backends.
    */
   storage: Storage;
-  /**
-   * Incremental build cache. Kubb fingerprints the inputs (spec content, config, plugin options,
-   * versions) and, on an unchanged "hot" run, restores the previously generated output instead of
-   * regenerating it. Same idea as Nx's computation cache.
-   *
-   * `defineConfig` enables `fsCache()` (local disk under `node_modules/.cache/kubb`) by default.
-   * Pass another backend to change where snapshots live, or `false` to turn caching off. A bare
-   * `createKubb` leaves it off unless a cache is provided.
-   *
-   * @example
-   * ```ts
-   * import { fsCache } from '@kubb/core'
-   *
-   * cache: fsCache({ dir: '.kubb-cache' })
-   * cache: false
-   * ```
-   *
-   * @see {@link Cache} interface for implementing custom backends.
-   */
-  cache?: Cache;
   /**
    * Plugins that run during the build to generate code and transform the AST. Each one processes
    * the adapter's AST and can emit files for a different target (TypeScript, Zod, Faker). A plugin
@@ -2236,12 +2097,7 @@ type Config<TInput = Input> = {
  * })
  * ```
  */
-type UserConfig<TInput = Input> = Omit<Config<TInput>, 'root' | 'plugins' | 'parsers' | 'adapter' | 'storage' | 'reporters' | 'cache'> & {
-  /**
-   * Incremental build cache. Defaults to `fsCache()` (local disk). Pass another {@link Cache}
-   * backend, or `false` to turn caching off.
-   */
-  cache?: Cache | false;
+type UserConfig<TInput = Input> = Omit<Config<TInput>, 'root' | 'plugins' | 'parsers' | 'adapter' | 'storage' | 'reporters'> & {
   /**
    * Project root directory, absolute or relative to the config file location.
    * @default process.cwd()
@@ -2665,11 +2521,6 @@ type CLIOptions = {
    * Reporters selected on the CLI via `--reporter`, overriding `config.reporters`.
    */
   reporters?: Array<ReporterName>;
-  /**
-   * Turns off the incremental build cache for this run, forcing a full regeneration.
-   * Set by the `--no-cache` flag.
-   */
-  noCache?: boolean;
 };
 /**
  * All accepted forms of a Kubb configuration.
@@ -3065,5 +2916,5 @@ declare class Diagnostics {
   static formatLines(diagnostic: Diagnostic): Array<string>;
 }
 //#endregion
-export { Include as $, KubbHookStartContext as A, createReporter as At, ParsedFile as B, KubbFilesProcessingEndContext as C, Storage as Ct, KubbGenerationStartContext as D, ReporterContext as Dt, KubbGenerationEndContext as E, Reporter as Et, KubbSuccessContext as F, Adapter as Ft, Parser as G, createKubb as H, KubbWarnContext as I, AdapterFactoryOptions as It, GeneratorContext as J, defineParser as K, PossibleConfig as L, AdapterSource as Lt, KubbInfoContext as M, Cache as Mt, KubbLifecycleStartContext as N, CachedSnapshot as Nt, KubbHookEndContext as O, ReporterName as Ot, KubbPluginsEndContext as P, createCache as Pt, Group as Q, UserConfig as R, createAdapter as Rt, KubbFileProcessingUpdate as S, createRenderer as St, KubbFilesProcessingUpdateContext as T, GenerationResult as Tt, FsCacheOptions as U, Kubb$1 as V, fsCache as W, KubbDriver as X, defineGenerator as Y, Exclude$1 as Z, InputPath as _, ResolverFileParams as _t, DiagnosticLocation as a, OutputMode as at, KubbDiagnosticContext as b, Renderer as bt, PerformanceDiagnostic as c, Plugin as ct, SerializedDiagnostic as d, BannerMeta as dt, KubbPluginEndContext as et, UpdateDiagnostic as f, ResolveBannerContext as ft, InputData as g, ResolverContext as gt, Config as h, Resolver as ht, DiagnosticKind as i, Output as it, KubbHooks as j, logLevel as jt, KubbHookLineContext as k, UserReporter as kt, ProblemCode as l, PluginFactoryOptions as lt, CLIOptions as m, ResolveOptionsContext as mt, DiagnosticByCode as n, KubbPluginStartContext as nt, DiagnosticSeverity as o, OutputOptions as ot, BuildOutput as p, ResolveBannerFile as pt, Generator$1 as q, DiagnosticDoc as r, NormalizedPlugin as rt, Diagnostics as s, Override as st, Diagnostic as t, KubbPluginSetupContext as tt, ProblemDiagnostic as u, definePlugin as ut, KubbBuildEndContext as v, ResolverPathParams as vt, KubbFilesProcessingStartContext as w, createStorage as wt, KubbErrorContext as x, RendererFactory as xt, KubbBuildStartContext as y, defineResolver as yt, FileProcessorHooks as z, AsyncEventEmitter as zt };
-//# sourceMappingURL=diagnostics-D_LOtOCv.d.ts.map
+export { KubbPluginSetupContext as $, KubbHookStartContext as A, Adapter as At, ParsedFile as B, KubbFilesProcessingEndContext as C, GenerationResult as Ct, KubbGenerationStartContext as D, UserReporter as Dt, KubbGenerationEndContext as E, ReporterName as Et, KubbSuccessContext as F, Generator$1 as G, createKubb as H, KubbWarnContext as I, KubbDriver as J, GeneratorContext as K, PossibleConfig as L, KubbInfoContext as M, AdapterSource as Mt, KubbLifecycleStartContext as N, createAdapter as Nt, KubbHookEndContext as O, createReporter as Ot, KubbPluginsEndContext as P, AsyncEventEmitter as Pt, KubbPluginEndContext as Q, UserConfig as R, KubbFileProcessingUpdate as S, createStorage as St, KubbFilesProcessingUpdateContext as T, ReporterContext as Tt, Parser as U, Kubb$1 as V, defineParser as W, Group as X, Exclude$1 as Y, Include as Z, InputPath as _, defineResolver as _t, DiagnosticLocation as a, Override as at, KubbDiagnosticContext as b, createRenderer as bt, PerformanceDiagnostic as c, definePlugin as ct, SerializedDiagnostic as d, ResolveBannerFile as dt, KubbPluginStartContext as et, UpdateDiagnostic as f, ResolveOptionsContext as ft, InputData as g, ResolverPathParams as gt, Config as h, ResolverFileParams as ht, DiagnosticKind as i, OutputOptions as it, KubbHooks as j, AdapterFactoryOptions as jt, KubbHookLineContext as k, logLevel as kt, ProblemCode as l, BannerMeta as lt, CLIOptions as m, ResolverContext as mt, DiagnosticByCode as n, Output as nt, DiagnosticSeverity as o, Plugin as ot, BuildOutput as p, Resolver as pt, defineGenerator as q, DiagnosticDoc as r, OutputMode as rt, Diagnostics as s, PluginFactoryOptions as st, Diagnostic as t, NormalizedPlugin as tt, ProblemDiagnostic as u, ResolveBannerContext as ut, KubbBuildEndContext as v, Renderer as vt, KubbFilesProcessingStartContext as w, Reporter as wt, KubbErrorContext as x, Storage as xt, KubbBuildStartContext as y, RendererFactory as yt, FileProcessorHooks as z };
+//# sourceMappingURL=diagnostics-Bf2bC8lV.d.ts.map