@kubb/core 5.0.0-beta.94 → 5.0.0-beta.95

package/dist/index.d.ts

@@ -1,11 +1,11 @@
 import { t as __name } from "./rolldown-runtime-C0LytTxp.js";
-import { $ as ResolveBannerContext, A as Generator, At as ProblemCode, B as Include, C as KubbWarnContext, Ct as Diagnostic, D as CreateKubbOptions, Dt as DiagnosticSeverity, E as UserConfig, Et as DiagnosticLocation, F as Parser, Ft as Adapter, G as Output, H as KubbPluginSetupContext, I as defineParser, It as AdapterFactoryOptions, J as Override, K as OutputMode, L as Exclude, Lt as AdapterSource, M as defineGenerator, Mt as SerializedDiagnostic, N as KubbDriver, Nt as UpdateDiagnostic, O as Kubb, Ot as Diagnostics, P as FileManagerHooks, Pt as Hookable, Q as BannerMeta, R as Filter, Rt as createAdapter, S as KubbSuccessContext, St as logLevel, T as PostGenerateCommand, Tt as DiagnosticKind, U as KubbPluginStartContext, V as KubbPluginEndContext, W as NormalizedPlugin, X as PluginFactoryOptions, Y as Plugin, Z as definePlugin, _ as KubbHookStartContext, _t as Reporter, a as KubbBuildEndContext, at as ResolverDefault, b as KubbLifecycleStartContext, bt as UserReporter, c as KubbErrorContext, ct as ResolverFilePathParams, d as KubbFilesProcessingStartContext, dt as Renderer, et as ResolveBannerFile, f as KubbFilesProcessingUpdateContext, ft as RendererFactory, g as KubbHookLineContext, gt as GenerationResult, h as KubbHookEndContext, ht as createStorage, i as Input, it as Resolver, j as GeneratorContext, jt as ProblemDiagnostic, k as createKubb, kt as PerformanceDiagnostic, l as KubbFileProcessingUpdate, lt as ResolverPatch, m as KubbGenerationStartContext, mt as Storage, n as CLIOptions, nt as ResolveOptionsContext, o as KubbBuildStartContext, ot as ResolverFile, p as KubbGenerationEndContext, pt as createRenderer, q as OutputOptions, r as Config, rt as ResolvePathOptions, s as KubbDiagnosticContext, st as ResolverFileParams, t as BuildOutput, tt as ResolveFileOptions, u as KubbFilesProcessingEndContext, ut as ResolverPathParams, v as KubbHooks, vt as ReporterContext, w as PossibleConfig, wt as DiagnosticDoc, x as KubbPluginsEndContext, xt as createReporter, y as KubbInfoContext, yt as ReporterName, z as Group } from "./types-DF9c3DGO.js";
-
+import { $ as definePlugin, A as Generator, At as DiagnosticSeverity, B as Include, Bt as AdapterSource, C as KubbWarnContext, Ct as UserReporter, D as CreateKubbOptions, Dt as DiagnosticDoc, E as UserConfig, Et as Diagnostic, F as Parser, Ft as SerializedDiagnostic, G as Output, H as KubbPluginSetupContext, I as defineParser, It as UpdateDiagnostic, J as Override, K as OutputMode, L as Exclude, Lt as Hookable, M as defineGenerator, Mt as PerformanceDiagnostic, N as KubbDriver, Nt as ProblemCode, O as Kubb, Ot as DiagnosticKind, P as FileManagerHooks, Pt as ProblemDiagnostic, Q as ResolvePluginOptions, R as Filter, Rt as Adapter, S as KubbSuccessContext, St as ReporterName, T as PostGenerateCommand, Tt as logLevel, U as KubbPluginStartContext, V as KubbPluginEndContext, Vt as createAdapter, W as NormalizedPlugin, X as PluginFactoryOptions, Y as Plugin, Z as PluginName, _ as KubbHookStartContext, _t as Storage, a as KubbBuildEndContext, at as ResolveOptionsContext, b as KubbLifecycleStartContext, bt as Reporter, c as KubbErrorContext, ct as ResolverDefault, d as KubbFilesProcessingStartContext, dt as ResolverFilePathParams, et as BannerMeta, f as KubbFilesProcessingUpdateContext, ft as ResolverPatch, g as KubbHookLineContext, gt as createRenderer, h as KubbHookEndContext, ht as RendererFactory, i as Input, it as ResolveImportsOptions, j as GeneratorContext, jt as Diagnostics, k as createKubb, kt as DiagnosticLocation, l as KubbFileProcessingUpdate, lt as ResolverFile, m as KubbGenerationStartContext, mt as Renderer, n as CLIOptions, nt as ResolveBannerFile, o as KubbBuildStartContext, ot as ResolvePathOptions, p as KubbGenerationEndContext, pt as ResolverPathParams, q as OutputOptions, r as Config, rt as ResolveFileOptions, s as KubbDiagnosticContext, st as Resolver, t as BuildOutput, tt as ResolveBannerContext, u as KubbFilesProcessingEndContext, ut as ResolverFileParams, v as KubbHooks, vt as createStorage, w as PossibleConfig, wt as createReporter, x as KubbPluginsEndContext, xt as ReporterContext, y as KubbInfoContext, yt as GenerationResult, z as Group, zt as AdapterFactoryOptions } from "./types-Bl0feoGY.js";
 //#region src/applyConfigDefaults.d.ts
 type ApplyConfigDefaultsOptions<TOutput> = {
   defaultAdapter: Adapter;
   barrelPlugin: Plugin;
-  barrelPluginName: string; /** Output fields to fill in when the user's config leaves them unset. */
+  barrelPluginName: string;
+  /** Output fields to fill in when the user's config leaves them unset. */
   defaultOutput: Partial<TOutput>;
 };
 /**
@@ -19,12 +19,7 @@ declare function applyConfigDefaults<TOutput extends Config['output'] = Config['
   adapter?: Adapter;
   output: TOutput;
   plugins?: Array<Plugin>;
-}, {
-  defaultAdapter,
-  barrelPlugin,
-  barrelPluginName,
-  defaultOutput
-}: ApplyConfigDefaultsOptions<TOutput>): {
+}, { defaultAdapter, barrelPlugin, barrelPluginName, defaultOutput }: ApplyConfigDefaultsOptions<TOutput>): {
   adapter: Adapter;
   output: TOutput;
   plugins: Array<Plugin>;
@@ -188,5 +183,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, type BannerMeta, BuildOutput, CLIOptions, Config, type CreateKubbOptions, type Diagnostic, 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, Input, type InputKind, 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, PostGenerateCommand, type ProblemCode, type ProblemDiagnostic, type Renderer, type RendererFactory, type Reporter, type ReporterContext, type ReporterName, type ResolveBannerContext, type ResolveBannerFile, type ResolveFileOptions, type ResolveOptionsContext, type ResolvePathOptions, Resolver, type ResolverDefault, type ResolverFile, type ResolverFileParams, type ResolverFilePathParams, type ResolverPatch, type ResolverPathParams, type SerializedDiagnostic, type Storage, type UpdateDiagnostic, UserConfig, type UserReporter, applyConfigDefaults, cliReporter, createAdapter, createKubb, createRenderer, createReporter, createResolver, createStorage, defineGenerator, defineParser, definePlugin, fileReporter, fsStorage, getInputKind, jsonReporter, logLevel, memoryStorage };
+export { type Adapter, type AdapterFactoryOptions, type AdapterSource, type BannerMeta, BuildOutput, CLIOptions, Config, type CreateKubbOptions, type Diagnostic, 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, Input, type InputKind, 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, type PluginName, PossibleConfig, PostGenerateCommand, type ProblemCode, type ProblemDiagnostic, type Renderer, type RendererFactory, type Reporter, type ReporterContext, type ReporterName, 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 SerializedDiagnostic, type Storage, type UpdateDiagnostic, UserConfig, type UserReporter, applyConfigDefaults, cliReporter, createAdapter, createKubb, createRenderer, createReporter, createResolver, createStorage, defineGenerator, defineParser, definePlugin, fileReporter, fsStorage, getInputKind, jsonReporter, logLevel, memoryStorage };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -5,7 +5,7 @@ import { stripVTControlCharacters, styleText } from "node:util";
 import { hash } from "node:crypto";
 import { access, glob, readFile, rm } from "node:fs/promises";
 import path, { join, relative, resolve } from "node:path";
-import { ast, collectUsedSchemaNames, composeMacros, operationDef, schemaDef, transform } from "@kubb/ast";
+import { ast, collect, collectUsedSchemaNames, composeMacros, narrowSchema, operationDef, resolveRefName, schemaDef, transform } from "@kubb/ast";
 import process$1 from "node:process";
 //#region src/createAdapter.ts
 /**
@@ -31,7 +31,6 @@ import process$1 from "node:process";
 *     // Convert the source (path or inline data) into an InputNode.
 *     return ast.factory.createInput()
 *   },
-*   getImports: () => [],
 *   async validate() {
 *     // Throw here when the spec is invalid.
 *   },
@@ -190,7 +189,7 @@ function memoize(store, factory) {
 }
 //#endregion
 //#region package.json
-var version = "5.0.0-beta.94";
+var version = "5.0.0-beta.95";
 //#endregion
 //#region src/constants.ts
 /**
@@ -811,9 +810,9 @@ function toBaseName({ name, extname }) {
 /**
 * Base constraint for all plugin resolver objects.
 *
-* The built-in machinery lives under `default`. Generators call the top-level `name` and
-* `file`, and a plugin overrides them to set its conventions. Extend with top-level helpers
-* (`typeName`, …) and/or grouped namespaces (`query`, `schema`, …).
+* The built-in machinery lives under `default`. Generators call the top-level `name`, `file`,
+* and `imports`, and a plugin overrides `name` and `file` to set its conventions. Extend with
+* top-level helpers (`typeName`, …) and/or grouped namespaces (`query`, `schema`, …).
 *
 * @example Top-level helper
 * ```ts
@@ -871,6 +870,35 @@ var Resolver = class Resolver {
 		return this.#resolveFile(options);
 	}
 	/**
+	* Builds one `ImportNode` per unique schema referenced in the tree, in first-occurrence
+	* order. Each ref's target resolves through `resolveRefName`, so collision- or macro-renamed
+	* schemas (`targetName`) import the emitted name. Names and paths go through the top-level
+	* `name` and `file`, so import entries follow the plugin's conventions, and a per-call
+	* `name` override wins over both.
+	*/
+	imports(options) {
+		const { node, root, output, group, extname = ".ts", name } = options;
+		const resolveName = name ?? ((schemaName) => this.name(schemaName));
+		const seen = /* @__PURE__ */ new Set();
+		return collect(node, { schema: (schemaNode) => {
+			const schemaRef = narrowSchema(schemaNode, "ref");
+			if (!schemaRef?.ref) return null;
+			const schemaName = resolveRefName(schemaRef);
+			if (!schemaName || seen.has(schemaName)) return null;
+			seen.add(schemaName);
+			return ast.factory.createImport({
+				name: [resolveName(schemaName)],
+				path: this.file({
+					name: schemaName,
+					extname,
+					root,
+					output,
+					group
+				}).path
+			});
+		} });
+	}
+	/**
 	* Merges `override` over `base` and returns a new resolver with helpers re-bound. Top-level
 	* keys replace, and a namespace (or `file`) merges per method, so overriding `query.name`
 	* keeps the base `query.keyName`. Used when applying `setResolver` partial overrides. Reads a