@kubb/core 5.0.0-beta.84 → 5.0.0-beta.86

package/dist/index.d.ts

@@ -1,97 +1,6 @@
 import { t as __name } from "./rolldown-runtime-C0LytTxp.js";
-import { $ as KubbPluginEndContext, A as KubbHookStartContext, At as logLevel, B as ParsedFile, C as KubbFilesProcessingEndContext, Ct as createStorage, D as KubbGenerationStartContext, Dt as ReporterName, E as KubbGenerationEndContext, Et as ReporterContext, F as KubbSuccessContext, Ft as AsyncEventEmitter, G as defineParser, H as Kubb, I as KubbWarnContext, J as defineGenerator, K as Generator, L as PossibleConfig, M as KubbInfoContext, Mt as AdapterFactoryOptions, N as KubbLifecycleStartContext, Nt as AdapterSource, O as KubbHookEndContext, Ot as UserReporter, P as KubbPluginsEndContext, Pt as createAdapter, Q as Include, R as UserConfig, S as KubbFileProcessingUpdate, St as Storage, T as KubbFilesProcessingUpdateContext, Tt as Reporter, U as createKubb, V as CreateKubbOptions, W as Parser, X as Exclude, Y as KubbDriver, Z as Group, _ as InputPath, _t as ResolverPathParams, a as DiagnosticLocation, at as OutputOptions, b as KubbDiagnosticContext, bt as RendererFactory, c as PerformanceDiagnostic, ct as PluginFactoryOptions, d as SerializedDiagnostic, dt as ResolveBannerContext, et as KubbPluginSetupContext, f as UpdateDiagnostic, ft as ResolveBannerFile, g as InputData, gt as ResolverFileParams, h as Config, ht as ResolverContext, i as DiagnosticKind, it as OutputMode, j as KubbHooks, jt as Adapter, k as KubbHookLineContext, kt as createReporter, l as ProblemCode, lt as definePlugin, m as CLIOptions, mt as Resolver, n as DiagnosticByCode, nt as NormalizedPlugin, o as DiagnosticSeverity, ot as Override, p as BuildOutput, pt as ResolveOptionsContext, q as GeneratorContext, r as DiagnosticDoc, rt as Output, s as Diagnostics, st as Plugin, t as Diagnostic, tt as KubbPluginStartContext, u as ProblemDiagnostic, ut as BannerMeta, v as KubbBuildEndContext, vt as defineResolver, w as KubbFilesProcessingStartContext, wt as GenerationResult, x as KubbErrorContext, xt as createRenderer, y as KubbBuildStartContext, yt as Renderer, z as FileProcessorHooks } from "./diagnostics-DuaXn2bT.js";
+import { $ as Include, A as KubbHookStartContext, At as UserReporter, B as Kubb, C as KubbFilesProcessingEndContext, Ct as createRenderer, D as KubbGenerationStartContext, Dt as Reporter, E as KubbGenerationEndContext, Et as GenerationResult, F as KubbSuccessContext, Ft as AdapterSource, G as KubbDriver, H as Generator, I as KubbWarnContext, It as createAdapter, J as Parser, K as FileManagerHooks, L as PossibleConfig, M as KubbInfoContext, Mt as logLevel, N as KubbLifecycleStartContext, Nt as Adapter, O as KubbHookEndContext, Ot as ReporterContext, P as KubbPluginsEndContext, Pt as AdapterFactoryOptions, Q as Group, R as UserConfig, S as KubbFileProcessingUpdate, St as RendererFactory, T as KubbFilesProcessingUpdateContext, Tt as createStorage, U as GeneratorContext, V as createKubb, W as defineGenerator, X as Exclude, Y as defineParser, Z as Filter, _ as InputPath, _t as ResolverDefault, a as DiagnosticLocation, at as OutputMode, b as KubbDiagnosticContext, bt as ResolverPathParams, c as PerformanceDiagnostic, ct as Plugin, d as SerializedDiagnostic, dt as BannerMeta, et as KubbPluginEndContext, f as UpdateDiagnostic, ft as ResolveBannerContext, g as InputData, gt as ResolverContext, h as Config, ht as Resolver, i as DiagnosticKind, it as Output, j as KubbHooks, jt as createReporter, k as KubbHookLineContext, kt as ReporterName, l as ProblemCode, lt as PluginFactoryOptions, m as CLIOptions, mt as ResolveOptionsContext, n as DiagnosticByCode, nt as KubbPluginStartContext, o as DiagnosticSeverity, ot as OutputOptions, p as BuildOutput, pt as ResolveBannerFile, q as Hookable, r as DiagnosticDoc, rt as NormalizedPlugin, s as Diagnostics, st as Override, t as Diagnostic, tt as KubbPluginSetupContext, u as ProblemDiagnostic, ut as definePlugin, v as KubbBuildEndContext, vt as ResolverFileParams, w as KubbFilesProcessingStartContext, wt as Storage, x as KubbErrorContext, xt as Renderer, y as KubbBuildStartContext, yt as ResolverPatch, z as CreateKubbOptions } from "./Diagnostics-aWJg-H2d.js";
 
-//#region ../../internals/utils/src/url.d.ts
-type URLObject = {
-  /**
-   * The resolved URL string (Express-style or template literal, depending on context).
-   */
-  url: string;
-  /**
-   * Extracted path parameters as a key-value map, or `null` when the path has none.
-   */
-  params: Record<string, string> | null;
-};
-/**
- * Supported identifier casing strategies for path parameters.
- */
-type PathCasing = 'camelcase';
-type TemplateOptions = {
-  /**
-   * Literal text prepended inside the template literal, e.g. a base URL.
-   */
-  prefix?: string | null;
-  /**
-   * Transform applied to each extracted parameter name before interpolation.
-   */
-  replacer?: (pathParam: string) => string;
-  /**
-   * Casing strategy applied to path parameter names.
-   */
-  casing?: PathCasing;
-};
-type ObjectOptions = {
-  /**
-   * Controls whether the `url` is rendered as an Express path or a template literal.
-   * @default 'path'
-   */
-  type?: 'path' | 'template';
-  /**
-   * Transform applied to each extracted parameter name.
-   */
-  replacer?: (pathParam: string) => string;
-  /**
-   * When `true`, the result is serialized to a string expression instead of a plain object.
-   */
-  stringify?: boolean;
-  /**
-   * Casing strategy applied to path parameter names.
-   */
-  casing?: PathCasing;
-};
-/**
- * Helpers for OpenAPI/Swagger paths, plus a thin wrapper over the native `URL`.
- */
-declare class Url {
-  /**
-   * Converts an OpenAPI/Swagger path to Express-style colon syntax.
-   *
-   * @example
-   * Url.toPath('/pet/{petId}') // '/pet/:petId'
-   */
-  static toPath(path: string): string;
-  /**
-   * Converts an OpenAPI/Swagger path to a TypeScript template literal string.
-   * `prefix` is prepended inside the literal, `replacer` transforms each parameter name,
-   * and `casing` controls parameter identifier casing.
-   *
-   * @example
-   * Url.toTemplateString('/pet/{petId}') // '`/pet/${petId}`'
-   *
-   * @example
-   * Url.toTemplateString('/pet/{petId}', { prefix: 'https://api' }) // '`https://api/pet/${petId}`'
-   */
-  static toTemplateString(path: string, {
-    prefix,
-    replacer,
-    casing
-  }?: TemplateOptions): string;
-  /**
-   * Returns the path and its extracted params as a structured `URLObject`, or as a stringified
-   * expression when `stringify` is set.
-   *
-   * @example
-   * Url.toObject('/pet/{petId}')
-   * // { url: '/pet/:petId', params: { petId: 'petId' } }
-   */
-  static toObject(path: string, {
-    type,
-    replacer,
-    stringify,
-    casing
-  }?: ObjectOptions): URLObject | string;
-}
-//#endregion
 //#region src/reporters/cliReporter.d.ts
 /**
  * The default `cli` reporter. Renders the {@link Report} for each config as it finishes, independent
@@ -107,7 +16,7 @@ declare const cliReporter: Reporter;
  * `## Timings` section. Selected with `--reporter file` (or `reporters: ['file']`).
  *
  * @note It captures the collected diagnostics once a config finishes, not the live
- * `kubb:info`/`kubb:plugin` event stream. Color is stripped so the file stays plain text even when
+ * `kubb:info`/`kubb:plugin` hook stream. Color is stripped so the file stays plain text even when
  * the run is attached to a TTY.
  */
 declare const fileReporter: Reporter;
@@ -122,6 +31,39 @@ declare const fileReporter: Reporter;
  */
 declare const jsonReporter: Reporter;
 //#endregion
+//#region src/createResolver.d.ts
+/**
+ * The plugin-specific resolver fields handed to `createResolver`. `name` and `file` fall
+ * back to the built-ins when omitted. Every method reaches sibling helpers through `this`,
+ * which `ThisType` types as the full resolver.
+ */
+type ResolverOptions<T extends PluginFactoryOptions> = Omit<T['resolver'], keyof Resolver> & {
+  pluginName: T['name'];
+  name?: T['resolver']['name'];
+  file?: T['resolver']['file'];
+} & ThisType<T['resolver']>;
+/**
+ * Defines a plugin resolver, the object that decides what every generated symbol and file
+ * path is called. Override the top-level `name` and `file` to set the plugin's conventions,
+ * and add your own naming helpers, top-level (`typeName`, …) or grouped in namespaces
+ * (`query`, `schema`, …). Every method reaches sibling helpers and the built-in machinery
+ * through `this.name`, `this.file`, and `this.default`.
+ *
+ * @example Custom identifier and file casing
+ * ```ts
+ * export const resolverTs = createResolver<PluginTs>({
+ *   pluginName: 'plugin-ts',
+ *   name(name) {
+ *     return ensureValidVarName(pascalCase(name))
+ *   },
+ *   file(params, context) {
+ *     return this.default.file({ ...params, resolveName: (name) => toFilePath(name, pascalCase) }, context)
+ *   },
+ * })
+ * ```
+ */
+declare function createResolver<T extends PluginFactoryOptions>(options: ResolverOptions<T>): T['resolver'];
+//#endregion
 //#region src/storages/fsStorage.d.ts
 /**
  * Built-in filesystem storage driver.
@@ -135,6 +77,8 @@ declare const jsonReporter: Reporter;
  * - the write is skipped when the file content is already identical
  * - missing parent directories are created automatically
  * - Bun's native file API is used when running under Bun
+ * - concurrent `setItem` calls are capped at {@link WRITE_CONCURRENCY} in flight, so a caller
+ *   can fire every file's write without pacing itself
  *
  * @example
  * ```ts
@@ -172,5 +116,5 @@ declare const fsStorage: (options?: Record<string, never> | undefined) => Storag
  */
 declare const memoryStorage: (options?: Record<string, never> | undefined) => Storage;
 //#endregion
-export { type Adapter, type AdapterFactoryOptions, type AdapterSource, AsyncEventEmitter, type BannerMeta, BuildOutput, CLIOptions, Config, type CreateKubbOptions, type Diagnostic, type DiagnosticByCode, type DiagnosticDoc, type DiagnosticKind, type DiagnosticLocation, type DiagnosticSeverity, Diagnostics, type Exclude, type FileProcessorHooks, type GenerationResult, type Generator, type GeneratorContext, type Group, type Include, InputData, InputPath, type Kubb, KubbBuildEndContext, KubbBuildStartContext, KubbDiagnosticContext, KubbDriver, KubbErrorContext, KubbFileProcessingUpdate, KubbFilesProcessingEndContext, KubbFilesProcessingStartContext, KubbFilesProcessingUpdateContext, KubbGenerationEndContext, KubbGenerationStartContext, KubbHookEndContext, KubbHookLineContext, KubbHookStartContext, KubbHooks, KubbInfoContext, KubbLifecycleStartContext, type KubbPluginEndContext, type KubbPluginSetupContext, type KubbPluginStartContext, KubbPluginsEndContext, KubbSuccessContext, KubbWarnContext, type NormalizedPlugin, type Output, type OutputMode, type OutputOptions, type Override, type ParsedFile, type Parser, type PerformanceDiagnostic, type Plugin, type PluginFactoryOptions, PossibleConfig, type ProblemCode, type ProblemDiagnostic, type Renderer, type RendererFactory, type Reporter, type ReporterContext, type ReporterName, type ResolveBannerContext, type ResolveBannerFile, type ResolveOptionsContext, type Resolver, type ResolverContext, type ResolverFileParams, type ResolverPathParams, type SerializedDiagnostic, type Storage, type UpdateDiagnostic, Url, UserConfig, type UserReporter, cliReporter, createAdapter, createKubb, createRenderer, createReporter, createStorage, defineGenerator, defineParser, definePlugin, defineResolver, fileReporter, fsStorage, jsonReporter, logLevel, memoryStorage };
+export { type Adapter, type AdapterFactoryOptions, type AdapterSource, type BannerMeta, BuildOutput, CLIOptions, Config, type CreateKubbOptions, type Diagnostic, type DiagnosticByCode, type DiagnosticDoc, type DiagnosticKind, type DiagnosticLocation, type DiagnosticSeverity, Diagnostics, type Exclude, type FileManagerHooks, type Filter, type GenerationResult, type Generator, type GeneratorContext, type Group, Hookable, type Include, InputData, InputPath, type Kubb, KubbBuildEndContext, KubbBuildStartContext, KubbDiagnosticContext, KubbDriver, KubbErrorContext, KubbFileProcessingUpdate, KubbFilesProcessingEndContext, KubbFilesProcessingStartContext, KubbFilesProcessingUpdateContext, KubbGenerationEndContext, KubbGenerationStartContext, KubbHookEndContext, KubbHookLineContext, KubbHookStartContext, KubbHooks, KubbInfoContext, KubbLifecycleStartContext, type KubbPluginEndContext, type KubbPluginSetupContext, type KubbPluginStartContext, KubbPluginsEndContext, KubbSuccessContext, KubbWarnContext, type NormalizedPlugin, type Output, type OutputMode, type OutputOptions, type Override, type Parser, type PerformanceDiagnostic, type Plugin, type PluginFactoryOptions, PossibleConfig, type ProblemCode, type ProblemDiagnostic, type Renderer, type RendererFactory, type Reporter, type ReporterContext, type ReporterName, type ResolveBannerContext, type ResolveBannerFile, type ResolveOptionsContext, Resolver, type ResolverContext, type ResolverDefault, type ResolverFileParams, type ResolverPatch, type ResolverPathParams, type SerializedDiagnostic, type Storage, type UpdateDiagnostic, UserConfig, type UserReporter, cliReporter, createAdapter, createKubb, createRenderer, createReporter, createResolver, createStorage, defineGenerator, defineParser, definePlugin, fileReporter, fsStorage, jsonReporter, logLevel, memoryStorage };
 //# sourceMappingURL=index.d.ts.map