@kubb/core 5.0.0-alpha.28 → 5.0.0-alpha.29

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { t as __name } from "./chunk--u3MIqq1.js";
-import { $ as createStorage, A as PrinterFactoryOptions, B as ResolverPathParams, C as PluginLifecycle, D as Preset, E as PluginWithLifeCycle, F as ResolvePathOptions, G as UserPluginWithLifeCycle, H as UserGroup, I as ResolvePathParams, J as CoreGeneratorV2, K as UserResolver, L as Resolver, M as ResolveBannerContext, N as ResolveNameParams, O as Presets, P as ResolveOptionsContext, Q as Storage, R as ResolverContext, S as PluginFactoryOptions, T as PluginParameter, U as UserLogger, V as UserConfig, W as UserPlugin, X as ReactGeneratorV2, Y as Generator, Z as defineGenerator, _ as LoggerOptions, a as AdapterSource, b as Plugin, c as Config, d as Group, et as formatters, f as Include, g as LoggerContext, h as Logger, i as AdapterFactoryOptions, it as AsyncEventEmitter, j as PrinterPartial, k as Printer, l as DevtoolsOptions, m as InputPath, n as getMode, nt as logLevel, o as BarrelType, p as InputData, q as KubbEvents, r as Adapter, rt as PossiblePromise, s as CompatibilityPreset, t as PluginDriver, tt as linters, u as Exclude, v as Output, w as PluginLifecycleHooks, x as PluginContext, y as Override, z as ResolverFileParams } from "./PluginDriver-B12z6KO-.js";
+import { $ as createStorage, A as PrinterFactoryOptions, B as ResolverPathParams, C as PluginLifecycle, D as Preset, E as PluginWithLifeCycle, F as ResolvePathOptions, G as UserPluginWithLifeCycle, H as UserGroup, I as ResolvePathParams, J as CoreGeneratorV2, K as UserResolver, L as Resolver, M as ResolveBannerContext, N as ResolveNameParams, O as Presets, P as ResolveOptionsContext, Q as Storage, R as ResolverContext, S as PluginFactoryOptions, T as PluginParameter, U as UserLogger, V as UserConfig, W as UserPlugin, X as ReactGeneratorV2, Y as Generator, Z as defineGenerator, _ as LoggerOptions, a as AdapterSource, b as Plugin, c as Config, d as Group, et as formatters, f as Include, g as LoggerContext, h as Logger, i as AdapterFactoryOptions, it as AsyncEventEmitter, j as PrinterPartial, k as Printer, l as DevtoolsOptions, m as InputPath, n as getMode, nt as logLevel, o as BarrelType, p as InputData, q as KubbEvents, r as Adapter, rt as PossiblePromise, s as CompatibilityPreset, t as PluginDriver, tt as linters, u as Exclude, v as Output, w as PluginLifecycleHooks, x as PluginContext, y as Override, z as ResolverFileParams } from "./PluginDriver-C6VX0skO.js";
 import { composeTransformers, definePrinter } from "@kubb/ast";
 import { Node, OperationNode, RootNode, SchemaNode, Visitor } from "@kubb/ast/types";
 import { Fabric, FabricFile } from "@kubb/fabric-core/types";
@@ -476,13 +476,17 @@ declare function buildDefaultBanner({
 /**
  * Default banner resolver — returns the banner string for a generated file.
  *
- * - When `output.banner` is a function and `node` is provided, calls it with the node.
- * - When `output.banner` is a function and `node` is absent, falls back to the default Kubb banner.
+ * A user-supplied `output.banner` overrides the default Kubb "Generated by Kubb" notice.
+ * When no `output.banner` is set, the Kubb notice is used (including `title` and `version`
+ * from the OAS spec when a `node` is provided).
+ *
+ * - When `output.banner` is a function and `node` is provided, returns `output.banner(node)`.
+ * - When `output.banner` is a function and `node` is absent, falls back to the Kubb notice.
  * - When `output.banner` is a string, returns it directly.
  * - When `config.output.defaultBanner` is `false`, returns `undefined`.
- * - Otherwise returns the default "Generated by Kubb" banner.
+ * - Otherwise returns the Kubb "Generated by Kubb" notice.
  *
- * @example String banner
+ * @example String banner overrides default
  * ```ts
  * defaultResolveBanner(undefined, { output: { banner: '// my banner' }, config })
  * // → '// my banner'
@@ -494,7 +498,13 @@ declare function buildDefaultBanner({
  * // → '// v3.0.0'
  * ```
  *
- * @example Disabled banner
+ * @example No user banner — Kubb notice with OAS metadata
+ * ```ts
+ * defaultResolveBanner(rootNode, { config })
+ * // → '/** Generated by Kubb ... Title: Pet Store ... *\/'
+ * ```
+ *
+ * @example Disabled default banner
  * ```ts
  * defaultResolveBanner(undefined, { config: { output: { defaultBanner: false }, ...config } })
  * // → undefined

package/dist/index.js

@@ -1413,7 +1413,7 @@ const fsStorage = createStorage(() => ({
 }));
 //#endregion
 //#region package.json
-var version$1 = "5.0.0-alpha.28";
+var version$1 = "5.0.0-alpha.29";
 //#endregion
 //#region src/utils/diagnostics.ts
 /**
@@ -1874,6 +1874,7 @@ function matchesOperationPattern(node, type, pattern) {
 		case "operationId": return !!node.operationId.match(pattern);
 		case "path": return !!node.path.match(pattern);
 		case "method": return !!node.method.toLowerCase().match(pattern);
+		case "contentType": return !!node.requestBody?.contentType?.match(pattern);
 		default: return false;
 	}
 }
@@ -2074,13 +2075,17 @@ function buildDefaultBanner({ title, description, version, config }) {
 /**
 * Default banner resolver — returns the banner string for a generated file.
 *
-* - When `output.banner` is a function and `node` is provided, calls it with the node.
-* - When `output.banner` is a function and `node` is absent, falls back to the default Kubb banner.
+* A user-supplied `output.banner` overrides the default Kubb "Generated by Kubb" notice.
+* When no `output.banner` is set, the Kubb notice is used (including `title` and `version`
+* from the OAS spec when a `node` is provided).
+*
+* - When `output.banner` is a function and `node` is provided, returns `output.banner(node)`.
+* - When `output.banner` is a function and `node` is absent, falls back to the Kubb notice.
 * - When `output.banner` is a string, returns it directly.
 * - When `config.output.defaultBanner` is `false`, returns `undefined`.
-* - Otherwise returns the default "Generated by Kubb" banner.
+* - Otherwise returns the Kubb "Generated by Kubb" notice.
 *
-* @example String banner
+* @example String banner overrides default
 * ```ts
 * defaultResolveBanner(undefined, { output: { banner: '// my banner' }, config })
 * // → '// my banner'
@@ -2092,17 +2097,27 @@ function buildDefaultBanner({ title, description, version, config }) {
 * // → '// v3.0.0'
 * ```
 *
-* @example Disabled banner
+* @example No user banner — Kubb notice with OAS metadata
+* ```ts
+* defaultResolveBanner(rootNode, { config })
+* // → '/** Generated by Kubb ... Title: Pet Store ... *\/'
+* ```
+*
+* @example Disabled default banner
 * ```ts
 * defaultResolveBanner(undefined, { config: { output: { defaultBanner: false }, ...config } })
 * // → undefined
 * ```
 */
 function defaultResolveBanner(node, { output, config }) {
-	if (typeof output?.banner === "function") return node ? output.banner(node) : buildDefaultBanner({ config });
+	if (typeof output?.banner === "function") return output.banner(node);
 	if (typeof output?.banner === "string") return output.banner;
 	if (config.output.defaultBanner === false) return;
-	return buildDefaultBanner({ config });
+	return buildDefaultBanner({
+		title: node?.meta?.title,
+		version: node?.meta?.version,
+		config
+	});
 }
 /**
 * Default footer resolver — returns the footer string for a generated file.