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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kubb/core",
-  "version": "5.0.0-alpha.28",
+  "version": "5.0.0-alpha.29",
   "description": "Core functionality for Kubb's plugin-based code generation system, providing the foundation for transforming OpenAPI specifications.",
   "keywords": [
     "typescript",
@@ -71,7 +71,7 @@
     "remeda": "^2.33.7",
     "semver": "^7.7.4",
     "tinyexec": "^1.0.4",
-    "@kubb/ast": "5.0.0-alpha.28"
+    "@kubb/ast": "5.0.0-alpha.29"
   },
   "devDependencies": {
     "@types/semver": "^7.7.1",

package/src/defineResolver.ts

@@ -44,6 +44,8 @@ function matchesOperationPattern(node: OperationNode, type: string, pattern: str
       return !!node.path.match(pattern)
     case 'method':
       return !!(node.method.toLowerCase() as string).match(pattern)
+    case 'contentType':
+      return !!node.requestBody?.contentType?.match(pattern)
     default:
       return false
   }
@@ -316,13 +318,17 @@ export 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'
@@ -334,7 +340,13 @@ export 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
@@ -342,15 +354,18 @@ export function buildDefaultBanner({
  */
 export function defaultResolveBanner(node: RootNode | undefined, { output, config }: ResolveBannerContext): string | undefined {
   if (typeof output?.banner === 'function') {
-    return node ? output.banner(node) : buildDefaultBanner({ config })
+    return output.banner(node)
   }
+
   if (typeof output?.banner === 'string') {
     return output.banner
   }
+
   if (config.output.defaultBanner === false) {
     return undefined
   }
-  return buildDefaultBanner({ config })
+
+  return buildDefaultBanner({ title: node?.meta?.title, version: node?.meta?.version, config })
 }
 
 /**

package/src/types.ts

@@ -587,11 +587,11 @@ export type Output<_TOptions = unknown> = {
   /**
    * Add a banner text in the beginning of every file
    */
-  banner?: string | ((node: RootNode) => string)
+  banner?: string | ((node?: RootNode) => string)
   /**
    * Add a footer text in the beginning of every file
    */
-  footer?: string | ((node: RootNode) => string)
+  footer?: string | ((node?: RootNode) => string)
   /**
    * Whether to override existing external files if they already exist.
    * @default false