@kubb/core 5.0.0-alpha.8 → 5.0.0-alpha.9

package/dist/{PluginDriver-DRfJIbG1.d.ts → PluginDriver-BkFepPdm.d.ts}

@@ -1,6 +1,6 @@
 import { t as __name } from "./chunk--u3MIqq1.js";
 import { EventEmitter } from "node:events";
-import { OperationNode, Printer, PrinterFactoryOptions, RootNode, SchemaNode } from "@kubb/ast/types";
+import { Node, OperationNode, Printer, PrinterFactoryOptions, RootNode, SchemaNode } from "@kubb/ast/types";
 import { Fabric, KubbFile } from "@kubb/fabric-core/types";
 import { FabricReactNode } from "@kubb/react-fabric/types";
 
@@ -23,75 +23,6 @@ declare var AsyncEventEmitter: {
     removeAll(): void;
   };
 };
-/**
-* Parses and transforms an OpenAPI/Swagger path string into various URL formats.
-*
-* @example
-* const p = new URLPath('/pet/{petId}')
-* p.URL      // '/pet/:petId'
-* p.template // '`/pet/${petId}`'
-*/
-declare var URLPath: {
-  new (path: any, options?: {}): {
-    /** The raw OpenAPI/Swagger path string, e.g. `/pet/{petId}`. */path: any;
-    "__#private@#options": {}; /** Converts the OpenAPI path to Express-style colon syntax, e.g. `/pet/{petId}` → `/pet/:petId`. */
-    get URL(): any; /** Returns `true` when `path` is a fully-qualified URL (e.g. starts with `https://`). */
-    get isURL(): boolean;
-    /**
-    * Converts the OpenAPI path to a TypeScript template literal string.
-    *
-    * @example
-    * new URLPath('/pet/{petId}').template              // '`/pet/${petId}`'
-    * new URLPath('/account/monetary-accountID').template // '`/account/${monetaryAccountId}`'
-    */
-    get template(): string; /** Returns the path and its extracted params as a structured `URLObject`, or as a stringified expression when `stringify` is set. */
-    get object(): string | {
-      url: any;
-      params: {} | undefined;
-    }; /** Returns a map of path parameter names, or `undefined` when the path has no parameters. */
-    get params(): {} | undefined;
-    "__#private@#transformParam"(raw: any): any; /** Iterates over every `{param}` token in `path`, calling `fn` with the raw token and transformed name. */
-    "__#private@#eachParam"(fn: any): void;
-    toObject({
-      type,
-      replacer,
-      stringify
-    }?: {
-      type?: string | undefined;
-    }): string | {
-      url: any;
-      params: {} | undefined;
-    };
-    /**
-    * Converts the OpenAPI path to a TypeScript template literal string.
-    * An optional `replacer` can transform each extracted parameter name before interpolation.
-    *
-    * @example
-    * new URLPath('/pet/{petId}').toTemplateString() // '`/pet/${petId}`'
-    */
-    toTemplateString({
-      prefix,
-      replacer
-    }?: {
-      prefix?: string | undefined;
-    }): string;
-    /**
-    * Extracts all `{param}` segments from the path and returns them as a key-value map.
-    * An optional `replacer` transforms each parameter name in both key and value positions.
-    * Returns `undefined` when no path parameters are found.
-    */
-    getParams(replacer: any): {} | undefined; /** Converts the OpenAPI path to Express-style colon syntax, e.g. `/pet/{petId}` → `/pet/:petId`. */
-    toURLPath(): any;
-  };
-};
-/**
-* Serializes a primitive value to a JSON string literal, stripping any surrounding quote characters first.
-*
-* @example
-* stringify('hello')   // '"hello"'
-* stringify('"hello"') // '"hello"'
-*/
-declare function stringify(value: any): string;
 //#endregion
 //#region src/constants.d.ts
 declare const DEFAULT_STUDIO_URL: "https://studio.kubb.dev";
@@ -139,45 +70,45 @@ declare const formatters: {
 };
 //#endregion
 //#region src/createStorage.d.ts
-/**
- * Storage interface for persisting Kubb output.
- *
- * Keys are root-relative forward-slash paths (e.g. `src/gen/api/getPets.ts`).
- * Implement this interface to route generated files to any backend — filesystem,
- * S3, Redis, in-memory, etc.
- *
- * Use `createStorage` to create a typed storage driver.
- */
-interface DefineStorage {
-  /** Identifier used for logging and debugging (e.g. `'fs'`, `'s3'`). */
+type Storage = {
+  /**
+   * Identifier used for logging and debugging (e.g. `'fs'`, `'s3'`).
+   */
   readonly name: string;
-  /** Returns `true` when an entry for `key` exists in storage. */
+  /**
+   * Returns `true` when an entry for `key` exists in storage.
+   */
   hasItem(key: string): Promise<boolean>;
-  /** Returns the stored string value, or `null` when `key` does not exist. */
+  /**
+   * Returns the stored string value, or `null` when `key` does not exist.
+   */
   getItem(key: string): Promise<string | null>;
-  /** Persists `value` under `key`, creating any required structure. */
+  /**
+   * Persists `value` under `key`, creating any required structure.
+   */
   setItem(key: string, value: string): Promise<void>;
-  /** Removes the entry for `key`. No-ops when the key does not exist. */
+  /**
+   *  Removes the entry for `key`. No-ops when the key does not exist.
+   */
   removeItem(key: string): Promise<void>;
-  /** Returns all keys, optionally filtered to those starting with `base`. */
+  /**
+   * Returns all keys, optionally filtered to those starting with `base`.
+   */
   getKeys(base?: string): Promise<Array<string>>;
-  /** Removes all entries, optionally scoped to those starting with `base`. */
+  /**
+   * Removes all entries, optionally scoped to those starting with `base`.
+   */
   clear(base?: string): Promise<void>;
-  /** Optional teardown hook called after the build completes. */
+  /**
+   * Optional teardown hook called after the build completes.
+   */
   dispose?(): Promise<void>;
-}
+};
 /**
- * Wraps a storage builder so the `options` argument is optional, following the
- * same factory pattern as `createPlugin`, `createLogger`, and `createAdapter`.
- *
- * The builder receives the resolved options object and must return a
- * `DefineStorage`-compatible object that includes a `name` string.
+ * Creates a storage factory. Call the returned function with optional options to get the storage instance.
  *
  * @example
- * ```ts
- * import { createStorage } from '@kubb/core'
- *
- * export const memoryStorage = createStorage((_options) => {
+ * export const memoryStorage = createStorage(() => {
  *   const store = new Map<string, string>()
  *   return {
  *     name: 'memory',
@@ -185,40 +116,39 @@ interface DefineStorage {
  *     async getItem(key) { return store.get(key) ?? null },
  *     async setItem(key, value) { store.set(key, value) },
  *     async removeItem(key) { store.delete(key) },
- *     async getKeys() { return [...store.keys()] },
- *     async clear() { store.clear() },
+ *     async getKeys(base) {
+ *       const keys = [...store.keys()]
+ *       return base ? keys.filter((k) => k.startsWith(base)) : keys
+ *     },
+ *     async clear(base) { if (!base) store.clear() },
  *   }
  * })
- * ```
  */
-declare function createStorage<TOptions = Record<string, never>>(build: (options: TOptions) => DefineStorage): (options?: TOptions) => DefineStorage;
+declare function createStorage<TOptions = Record<string, never>>(build: (options: TOptions) => Storage): (options?: TOptions) => Storage;
 //#endregion
 //#region src/Kubb.d.ts
-type DebugEvent = {
+type DebugInfo = {
   date: Date;
-  logs: string[];
+  logs: Array<string>;
   fileName?: string;
 };
-type ProgressStartMeta<H extends PluginLifecycleHooks = PluginLifecycleHooks> = {
+type HookProgress<H extends PluginLifecycleHooks = PluginLifecycleHooks> = {
   hookName: H;
   plugins: Array<Plugin>;
 };
-type ProgressStopMeta<H extends PluginLifecycleHooks = PluginLifecycleHooks> = {
-  hookName: H;
-};
-type ExecutingMeta<H extends PluginLifecycleHooks = PluginLifecycleHooks> = {
+type HookExecution<H extends PluginLifecycleHooks = PluginLifecycleHooks> = {
   strategy: Strategy;
   hookName: H;
   plugin: Plugin;
-  parameters?: unknown[] | undefined;
+  parameters?: Array<unknown>;
   output?: unknown;
 };
-type ExecutedMeta<H extends PluginLifecycleHooks = PluginLifecycleHooks> = {
+type HookResult<H extends PluginLifecycleHooks = PluginLifecycleHooks> = {
   duration: number;
   strategy: Strategy;
   hookName: H;
   plugin: Plugin;
-  parameters?: unknown[] | undefined;
+  parameters?: Array<unknown>;
   output?: unknown;
 };
 /**
@@ -227,7 +157,7 @@ type ExecutedMeta<H extends PluginLifecycleHooks = PluginLifecycleHooks> = {
  *
  * @example
  * ```typescript
- * import type { AsyncEventEmitter } from '@kubb/core'
+ * import type { AsyncEventEmitter } from '@internals/utils'
  * import type { KubbEvents } from '@kubb/core'
  *
  * const events: AsyncEventEmitter<KubbEvents> = new AsyncEventEmitter()
@@ -265,12 +195,12 @@ interface KubbEvents {
   /**
    * Emitted when code generation phase completes.
    */
-  'generation:end': [Config: Config, files: Array<KubbFile.ResolvedFile>, sources: Map<KubbFile.Path, string>];
+  'generation:end': [config: Config, files: Array<KubbFile.ResolvedFile>, sources: Map<KubbFile.Path, string>];
   /**
    * Emitted with a summary of the generation results.
    * Contains summary lines, title, and success status.
    */
-  'generation:summary': [Config: Config, {
+  'generation:summary': [config: Config, {
     failedPlugins: Set<{
       plugin: Plugin;
       error: Error;
@@ -278,7 +208,7 @@ interface KubbEvents {
     status: 'success' | 'failed';
     hrStart: [number, number];
     filesCreated: number;
-    pluginTimings?: Map<string, number>;
+    pluginTimings?: Map<Plugin['name'], number>;
   }];
   /**
    * Emitted when code formatting starts (e.g., running Biome or Prettier).
@@ -305,7 +235,7 @@ interface KubbEvents {
    */
   'hooks:end': [];
   /**
-   * Emitted when a single hook execution starts. (e.g., format or lint).
+   * Emitted when a single hook execution starts (e.g., format or lint).
    * The callback should be invoked when the command completes.
    */
   'hook:start': [{
@@ -347,7 +277,7 @@ interface KubbEvents {
    * Debug event for detailed logging.
    * Contains timestamp, log messages, and optional filename.
    */
-  debug: [meta: DebugEvent];
+  debug: [info: DebugInfo];
   /**
    * Emitted when file processing starts.
    * Contains the list of files to be processed.
@@ -358,10 +288,10 @@ interface KubbEvents {
    * Contains processed count, total count, percentage, and file details.
    */
   'file:processing:update': [{
-    /** Number of files processed so far */processed: number; /** Total number of files to process */
-    total: number; /** Processing percentage (0-100) */
-    percentage: number; /** Optional source identifier */
-    source?: string; /** The file being processed */
+    /** Number of files processed so far. */processed: number; /** Total number of files to process. */
+    total: number; /** Processing percentage (0–100). */
+    percentage: number; /** Optional source identifier. */
+    source?: string; /** The file being processed. */
     file: KubbFile.ResolvedFile;
     /**
      * Kubb configuration (not present in Fabric).
@@ -373,16 +303,16 @@ interface KubbEvents {
    * Emitted when file processing completes.
    * Contains the list of processed files.
    */
-  'files:processing:end': [files: KubbFile.ResolvedFile[]];
+  'files:processing:end': [files: Array<KubbFile.ResolvedFile>];
   /**
    * Emitted when a plugin starts executing.
    */
   'plugin:start': [plugin: Plugin];
   /**
    * Emitted when a plugin completes execution.
-   * Duration in ms
+   * Duration in ms.
    */
-  'plugin:end': [plugin: Plugin, meta: {
+  'plugin:end': [plugin: Plugin, result: {
     duration: number;
     success: boolean;
     error?: Error;
@@ -391,37 +321,48 @@ interface KubbEvents {
    * Emitted when plugin hook progress tracking starts.
    * Contains the hook name and list of plugins to execute.
    */
-  'plugins:hook:progress:start': [meta: ProgressStartMeta];
+  'plugins:hook:progress:start': [progress: HookProgress];
   /**
    * Emitted when plugin hook progress tracking ends.
    * Contains the hook name that completed.
    */
-  'plugins:hook:progress:end': [meta: ProgressStopMeta];
+  'plugins:hook:progress:end': [{
+    hookName: PluginLifecycleHooks;
+  }];
   /**
    * Emitted when a plugin hook starts processing.
    * Contains strategy, hook name, plugin, parameters, and output.
    */
-  'plugins:hook:processing:start': [meta: ExecutingMeta];
+  'plugins:hook:processing:start': [execution: HookExecution];
   /**
    * Emitted when a plugin hook completes processing.
    * Contains duration, strategy, hook name, plugin, parameters, and output.
    */
-  'plugins:hook:processing:end': [meta: ExecutedMeta];
+  'plugins:hook:processing:end': [result: HookResult];
 }
 //#endregion
-//#region src/createGenerator.d.ts
+//#region src/defineGenerator.d.ts
+/**
+ * Props for the `operations` lifecycle — receives all operation nodes at once.
+ */
 type OperationsV2Props<TPlugin extends PluginFactoryOptions = PluginFactoryOptions> = {
   config: Config;
   adapter: Adapter;
   options: Plugin<TPlugin>['options'];
   nodes: Array<OperationNode>;
 };
+/**
+ * Props for the `operation` lifecycle — receives a single operation node.
+ */
 type OperationV2Props<TPlugin extends PluginFactoryOptions = PluginFactoryOptions> = {
   config: Config;
   adapter: Adapter;
   options: Plugin<TPlugin>['options'];
   node: OperationNode;
 };
+/**
+ * Props for the `schema` lifecycle — receives a single schema node.
+ */
 type SchemaV2Props<TPlugin extends PluginFactoryOptions = PluginFactoryOptions> = {
   config: Config;
   adapter: Adapter;
@@ -461,8 +402,29 @@ type ReactGeneratorV2<TPlugin extends PluginFactoryOptions = PluginFactoryOption
   Schema(props: SchemaV2Props<TPlugin>): FabricReactNode;
 };
 type Generator<TPlugin extends PluginFactoryOptions = PluginFactoryOptions> = UserCoreGeneratorV2<TPlugin> | UserReactGeneratorV2<TPlugin>;
-declare function createGenerator<TPlugin extends PluginFactoryOptions = PluginFactoryOptions>(generator: UserReactGeneratorV2<TPlugin>): ReactGeneratorV2<TPlugin>;
-declare function createGenerator<TPlugin extends PluginFactoryOptions = PluginFactoryOptions>(generator: UserCoreGeneratorV2<TPlugin>): CoreGeneratorV2<TPlugin>;
+/**
+ * Defines a generator with no-op defaults for any omitted lifecycle methods.
+ * Works for both `core` (async file output) and `react` (JSX component) generators.
+ *
+ * @example
+ * // react generator
+ * export const typeGenerator = defineGenerator<PluginTs>({
+ *   name: 'typescript',
+ *   type: 'react',
+ *   Operation({ node, options }) { return <File>...</File> },
+ *   Schema({ node, options }) { return <File>...</File> },
+ * })
+ *
+ * @example
+ * // core generator
+ * export const myGenerator = defineGenerator<MyPlugin>({
+ *   name: 'my-generator',
+ *   type: 'core',
+ *   async operation({ node, options }) { return [{ path: '...', content: '...' }] },
+ * })
+ */
+declare function defineGenerator<TPlugin extends PluginFactoryOptions = PluginFactoryOptions>(generator: UserReactGeneratorV2<TPlugin>): ReactGeneratorV2<TPlugin>;
+declare function defineGenerator<TPlugin extends PluginFactoryOptions = PluginFactoryOptions>(generator: UserCoreGeneratorV2<TPlugin>): CoreGeneratorV2<TPlugin>;
 //#endregion
 //#region src/types.d.ts
 declare global {
@@ -627,16 +589,16 @@ type Config<TInput = Input> = {
     /**
      * Storage backend for generated files.
      * Defaults to `fsStorage()` — the built-in filesystem driver.
-     * Accepts any object implementing the {@link DefineStorage} interface.
+     * Accepts any object implementing the {@link Storage} interface.
      * Keys are root-relative paths (e.g. `src/gen/api/getPets.ts`).
      * @default fsStorage()
      * @example
      * ```ts
-     * import { createStorage, fsStorage } from '@kubb/core'
-     * storage: createStorage(fsStorage())
+     * import { memoryStorage } from '@kubb/core'
+     * storage: memoryStorage()
      * ```
      */
-    storage?: DefineStorage;
+    storage?: Storage;
     /**
      * Specifies the formatting tool to be used.
      * - 'auto' automatically detects and uses biome or prettier (in that order of preference).
@@ -710,6 +672,39 @@ type Config<TInput = Input> = {
     done?: string | Array<string>;
   };
 };
+type PatternFilter = {
+  type: string;
+  pattern: string | RegExp;
+};
+type PatternOverride<TOptions> = PatternFilter & {
+  options: Omit<Partial<TOptions>, 'override'>;
+};
+type ResolveOptionsContext<TOptions> = {
+  options: TOptions;
+  exclude?: Array<PatternFilter>;
+  include?: Array<PatternFilter>;
+  override?: Array<PatternOverride<TOptions>>;
+};
+/**
+ * Base constraint for all plugin resolver objects.
+ *
+ * `default` and `resolveOptions` are injected automatically by `defineResolver` — plugin
+ * authors may override them but never need to implement them from scratch.
+ * Concrete plugin resolver types extend this with their own helper methods.
+ */
+type Resolver = {
+  default(name: ResolveNameParams['name'], type?: ResolveNameParams['type']): string;
+  resolveOptions<TOptions>(node: Node, context: ResolveOptionsContext<TOptions>): TOptions | null;
+};
+/**
+ * The user-facing subset of a `Resolver` — everything except the methods injected by
+ * `defineResolver` (`default` and `resolveOptions`).
+ *
+ * When you pass a `UserResolver` to `defineResolver`, the standard `default` and
+ * `resolveOptions` implementations are injected automatically so plugin authors never
+ * need to define them by hand. Both can still be overridden by providing them explicitly.
+ */
+type UserResolver = Omit<Resolver, 'default' | 'resolveOptions'>;
 type PluginFactoryOptions<
 /**
  * Name to be used for the plugin.
@@ -730,14 +725,19 @@ TContext = unknown,
 /**
  * When calling `resolvePath` you can specify better types.
  */
-TResolvePathOptions extends object = object> = {
+TResolvePathOptions extends object = object,
+/**
+ * Resolver object that encapsulates the naming and path-resolution helpers used by this plugin.
+ * Use `defineResolver` to define the resolver object and export it alongside the plugin.
+ */
+TResolver extends Resolver = Resolver> = {
   name: TName;
   options: TOptions;
   resolvedOptions: TResolvedOptions;
   context: TContext;
   resolvePathOptions: TResolvePathOptions;
+  resolver: TResolver;
 };
-type GetPluginFactoryOptions<TPlugin extends UserPlugin> = TPlugin extends UserPlugin<infer X> ? X : never;
 type UserPlugin<TOptions extends PluginFactoryOptions = PluginFactoryOptions> = {
   /**
    * Unique name used for the plugin
@@ -761,7 +761,7 @@ type UserPlugin<TOptions extends PluginFactoryOptions = PluginFactoryOptions> =
   inject?: (this: PluginContext<TOptions>, context: PluginContext<TOptions>) => TOptions['context'];
 };
 type UserPluginWithLifeCycle<TOptions extends PluginFactoryOptions = PluginFactoryOptions> = UserPlugin<TOptions> & PluginLifecycle<TOptions>;
-type UnknownUserPlugin = UserPlugin<PluginFactoryOptions<any, any, any, any, any>>;
+type UnknownUserPlugin = UserPlugin<PluginFactoryOptions<string, object, object, unknown, object>>;
 type Plugin<TOptions extends PluginFactoryOptions = PluginFactoryOptions> = {
   /**
    * Unique name used for the plugin
@@ -783,7 +783,7 @@ type Plugin<TOptions extends PluginFactoryOptions = PluginFactoryOptions> = {
   options: TOptions['resolvedOptions'];
   install: (this: PluginContext<TOptions>, context: PluginContext<TOptions>) => PossiblePromise<void>;
   /**
-   * Define a context that can be used by other plugins, see `PluginDriver' where we convert from `UserPlugin` to `Plugin`(used when calling `createPlugin`).
+   * Defines a context that can be used by other plugins, see `PluginDriver` where we convert from `UserPlugin` to `Plugin` (used when calling `createPlugin`).
    */
   inject: (this: PluginContext<TOptions>, context: PluginContext<TOptions>) => TOptions['context'];
 };
@@ -898,9 +898,6 @@ type Output<TOptions> = {
    */
   override?: boolean;
 };
-type GroupContext = {
-  group: string;
-};
 type Group = {
   /**
    * Defines the type where to group the files.
@@ -910,9 +907,11 @@ type Group = {
    */
   type: 'tag' | 'path';
   /**
-   * Return the name of a group based on the group name, this used for the file and name generation
+   * Return the name of a group based on the group name, this is used for the file and name generation.
    */
-  name?: (context: GroupContext) => string;
+  name?: (context: {
+    group: string;
+  }) => string;
 };
 type LoggerOptions = {
   /**
@@ -923,13 +922,12 @@ type LoggerOptions = {
 /**
  * Shared context passed to all plugins, parsers, and Fabric internals.
  */
-interface LoggerContext extends AsyncEventEmitter<KubbEvents> {}
-type Install<TOptions = unknown> = (context: LoggerContext, options?: TOptions) => void | Promise<void>;
+type LoggerContext = AsyncEventEmitter<KubbEvents>;
 type Logger<TOptions extends LoggerOptions = LoggerOptions> = {
   name: string;
-  install: Install<TOptions>;
+  install: (context: LoggerContext, options?: TOptions) => void | Promise<void>;
 };
-type UserLogger<TOptions extends LoggerOptions = LoggerOptions> = Omit<Logger<TOptions>, 'logLevel'>;
+type UserLogger<TOptions extends LoggerOptions = LoggerOptions> = Logger<TOptions>;
 //#endregion
 //#region src/PluginDriver.d.ts
 type RequiredPluginLifecycle = Required<PluginLifecycle>;
@@ -1052,5 +1050,5 @@ declare class PluginDriver {
   getPluginsByName(hookName: keyof PluginWithLifeCycle, pluginName: string): Plugin[];
 }
 //#endregion
-export { UserConfig as A, createStorage as B, PluginParameter as C, ResolveNameParams as D, PrinterFactoryOptions as E, Generator as F, URLPath as G, linters as H, ReactGeneratorV2 as I, createGenerator as L, UserPlugin as M, UserPluginWithLifeCycle as N, ResolvePathParams as O, CoreGeneratorV2 as P, KubbEvents as R, PluginLifecycleHooks as S, Printer as T, logLevel as U, formatters as V, AsyncEventEmitter as W, Output as _, AdapterFactoryOptions as a, PluginFactoryOptions as b, Config as c, Group as d, InputData as f, LoggerOptions as g, LoggerContext as h, Adapter as i, UserLogger as j, UnknownUserPlugin as k, DevtoolsOptions as l, Logger as m, PluginDriver as n, AdapterSource as o, InputPath as p, getMode as r, BarrelType as s, GetFileOptions as t, GetPluginFactoryOptions as u, Plugin as v, PluginWithLifeCycle as w, PluginLifecycle as x, PluginContext as y, DefineStorage as z };
-//# sourceMappingURL=PluginDriver-DRfJIbG1.d.ts.map
+export { UserConfig as A, Storage as B, PluginWithLifeCycle as C, ResolveOptionsContext as D, ResolveNameParams as E, CoreGeneratorV2 as F, AsyncEventEmitter as G, formatters as H, Generator as I, ReactGeneratorV2 as L, UserPlugin as M, UserPluginWithLifeCycle as N, ResolvePathParams as O, UserResolver as P, defineGenerator as R, PluginParameter as S, PrinterFactoryOptions as T, linters as U, createStorage as V, logLevel as W, Plugin as _, AdapterFactoryOptions as a, PluginLifecycle as b, Config as c, InputData as d, InputPath as f, Output as g, LoggerOptions as h, Adapter as i, UserLogger as j, Resolver as k, DevtoolsOptions as l, LoggerContext as m, PluginDriver as n, AdapterSource as o, Logger as p, getMode as r, BarrelType as s, GetFileOptions as t, Group as u, PluginContext as v, Printer as w, PluginLifecycleHooks as x, PluginFactoryOptions as y, KubbEvents as z };
+//# sourceMappingURL=PluginDriver-BkFepPdm.d.ts.map

package/dist/hooks.cjs

@@ -56,12 +56,13 @@ function useKubb() {
 			...rest
 		}),
 		resolveBanner: (node) => {
-			if (typeof output?.banner === "function") return output.banner(node);
+			if (typeof output?.banner === "function") return node ? output.banner(node) : buildDefaultBanner({ config });
 			if (typeof output?.banner === "string") return output.banner;
+			if (config.output.defaultBanner === false) return;
 			return buildDefaultBanner({ config });
 		},
 		resolveFooter: (node) => {
-			if (typeof output?.footer === "function") return output.footer(node);
+			if (typeof output?.footer === "function") return node ? output.footer(node) : void 0;
 			if (typeof output?.footer === "string") return output.footer;
 		}
 	};

package/dist/hooks.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"hooks.cjs","names":["path"],"sources":["../src/hooks/useKubb.ts","../src/hooks/useMode.ts","../src/hooks/usePlugin.ts","../src/hooks/usePluginDriver.ts"],"sourcesContent":["import path from 'node:path'\nimport type { RootNode } from '@kubb/ast/types'\nimport type { KubbFile } from '@kubb/fabric-core/types'\nimport { useFabric } from '@kubb/react-fabric'\nimport type { GetFileOptions, PluginDriver } from '../PluginDriver.ts'\nimport type { Config, Plugin, PluginFactoryOptions, ResolveNameParams, ResolvePathParams } from '../types.ts'\n\ntype ResolvePathOptions = {\n  pluginName?: string\n  group?: {\n    tag?: string\n    path?: string\n  }\n  type?: ResolveNameParams['type']\n}\n\ntype UseKubbReturn<TOptions extends PluginFactoryOptions = PluginFactoryOptions> = {\n  plugin: Plugin<TOptions>\n  mode: KubbFile.Mode\n  config: Config\n  /**\n   * Returns the plugin whose `name` matches `pluginName`, defaulting to the current plugin.\n   */\n  getPluginByName: (pluginName?: string) => Plugin | undefined\n  /**\n   * Resolves a file reference, defaulting `pluginName` to the current plugin.\n   */\n  getFile: (params: Omit<GetFileOptions<ResolvePathOptions>, 'pluginName'> & { pluginName?: string }) => KubbFile.File<{ pluginName: string }>\n  /**\n   * Resolves a name, defaulting `pluginName` to the current plugin.\n   */\n  resolveName: (params: Omit<ResolveNameParams, 'pluginName'> & { pluginName?: string }) => string\n  /**\n   * Resolves a path, defaulting `pluginName` to the current plugin.\n   */\n  resolvePath: <TPathOptions = object>(params: Omit<ResolvePathParams<TPathOptions>, 'pluginName'> & { pluginName?: string }) => KubbFile.Path\n  /**\n   * Resolves the banner for the given node using the plugin's `output.banner` option.\n   * Returns a string when `output.banner` is a string or a function, `undefined` otherwise.\n   */\n  resolveBanner: (node: RootNode) => string | undefined\n  /**\n   * Resolves the footer for the given node using the plugin's `output.footer` option.\n   * Returns a string when `output.footer` is a string or a function, `undefined` otherwise.\n   */\n  resolveFooter: (node: RootNode) => string | undefined\n}\n\n/**\n * Generates the default \"Generated by Kubb\" banner from node metadata.\n */\nfunction buildDefaultBanner({ title, description, version, config }: { title?: string; description?: string; version?: string; config: Config }): string {\n  try {\n    let source = ''\n    if (Array.isArray(config.input)) {\n      const first = config.input[0]\n      if (first && 'path' in first) {\n        source = path.basename(first.path)\n      }\n    } else if ('path' in config.input) {\n      source = path.basename(config.input.path)\n    } else if ('data' in config.input) {\n      source = 'text content'\n    }\n\n    let banner = '/**\\n* Generated by Kubb (https://kubb.dev/).\\n* Do not edit manually.\\n'\n\n    if (config.output.defaultBanner === 'simple') {\n      banner += '*/\\n'\n      return banner\n    }\n\n    if (source) {\n      banner += `* Source: ${source}\\n`\n    }\n\n    if (title) {\n      banner += `* Title: ${title}\\n`\n    }\n\n    if (description) {\n      const formattedDescription = description.replace(/\\n/gm, '\\n* ')\n      banner += `* Description: ${formattedDescription}\\n`\n    }\n\n    if (version) {\n      banner += `* OpenAPI spec version: ${version}\\n`\n    }\n\n    banner += '*/\\n'\n    return banner\n  } catch (_error) {\n    return '/**\\n* Generated by Kubb (https://kubb.dev/).\\n* Do not edit manually.\\n*/'\n  }\n}\n\nexport function useKubb<TOptions extends PluginFactoryOptions = PluginFactoryOptions>(): UseKubbReturn<TOptions> {\n  const { meta } = useFabric<{\n    plugin: Plugin<TOptions>\n    mode: KubbFile.Mode\n    driver: PluginDriver\n  }>()\n\n  const config = meta.driver.config\n  const defaultPluginName = meta.plugin.name\n\n  const output = (\n    meta.plugin.options as { output?: { banner?: string | ((node: RootNode) => string); footer?: string | ((node: RootNode) => string) } } | undefined\n  )?.output\n\n  return {\n    plugin: meta.plugin as Plugin<TOptions>,\n    mode: meta.mode,\n    config,\n    getPluginByName: (pluginName = defaultPluginName) => meta.driver.getPluginByName.call(meta.driver, pluginName),\n    getFile: ({ pluginName = defaultPluginName, ...rest }) => meta.driver.getFile.call(meta.driver, { pluginName, ...rest }),\n    resolveName: ({ pluginName = defaultPluginName, ...rest }) => meta.driver.resolveName.call(meta.driver, { pluginName, ...rest }),\n    resolvePath: ({ pluginName = defaultPluginName, ...rest }) => meta.driver.resolvePath.call(meta.driver, { pluginName, ...rest }),\n    resolveBanner: (node: RootNode) => {\n      if (typeof output?.banner === 'function') {\n        return output.banner(node)\n      }\n      if (typeof output?.banner === 'string') {\n        return output.banner\n      }\n      return buildDefaultBanner({ config })\n    },\n    resolveFooter: (node: RootNode) => {\n      if (typeof output?.footer === 'function') {\n        return output.footer(node)\n      }\n      if (typeof output?.footer === 'string') {\n        return output.footer\n      }\n      return undefined\n    },\n  }\n}\n","import type { KubbFile } from '@kubb/fabric-core/types'\nimport { useFabric } from '@kubb/react-fabric'\n\n/**\n * @deprecated use `useKubb` instead\n */\nexport function useMode(): KubbFile.Mode {\n  const { meta } = useFabric<{ mode: KubbFile.Mode }>()\n\n  return meta.mode\n}\n","import { useFabric } from '@kubb/react-fabric'\nimport type { Plugin, PluginFactoryOptions } from '../types.ts'\n\n/**\n * @deprecated use useKubb instead\n */\nexport function usePlugin<TOptions extends PluginFactoryOptions = PluginFactoryOptions>(): Plugin<TOptions> {\n  const { meta } = useFabric<{ plugin: Plugin<TOptions> }>()\n\n  return meta.plugin\n}\n","import { useFabric } from '@kubb/react-fabric'\nimport type { PluginDriver } from '../PluginDriver.ts'\n\n/**\n * @deprecated use `useKubb` instead\n */\nexport function usePluginDriver(): PluginDriver {\n  const { meta } = useFabric<{ driver: PluginDriver }>()\n\n  return meta.driver\n}\n"],"mappings":";;;;;;;;;AAmDA,SAAS,mBAAmB,EAAE,OAAO,aAAa,SAAS,UAA8F;AACvJ,KAAI;EACF,IAAI,SAAS;AACb,MAAI,MAAM,QAAQ,OAAO,MAAM,EAAE;GAC/B,MAAM,QAAQ,OAAO,MAAM;AAC3B,OAAI,SAAS,UAAU,MACrB,UAASA,UAAAA,QAAK,SAAS,MAAM,KAAK;aAE3B,UAAU,OAAO,MAC1B,UAASA,UAAAA,QAAK,SAAS,OAAO,MAAM,KAAK;WAChC,UAAU,OAAO,MAC1B,UAAS;EAGX,IAAI,SAAS;AAEb,MAAI,OAAO,OAAO,kBAAkB,UAAU;AAC5C,aAAU;AACV,UAAO;;AAGT,MAAI,OACF,WAAU,aAAa,OAAO;AAGhC,MAAI,MACF,WAAU,YAAY,MAAM;AAG9B,MAAI,aAAa;GACf,MAAM,uBAAuB,YAAY,QAAQ,QAAQ,OAAO;AAChE,aAAU,kBAAkB,qBAAqB;;AAGnD,MAAI,QACF,WAAU,2BAA2B,QAAQ;AAG/C,YAAU;AACV,SAAO;UACA,QAAQ;AACf,SAAO;;;AAIX,SAAgB,UAAiG;CAC/G,MAAM,EAAE,UAAA,GAAA,mBAAA,YAIJ;CAEJ,MAAM,SAAS,KAAK,OAAO;CAC3B,MAAM,oBAAoB,KAAK,OAAO;CAEtC,MAAM,SACJ,KAAK,OAAO,SACX;AAEH,QAAO;EACL,QAAQ,KAAK;EACb,MAAM,KAAK;EACX;EACA,kBAAkB,aAAa,sBAAsB,KAAK,OAAO,gBAAgB,KAAK,KAAK,QAAQ,WAAW;EAC9G,UAAU,EAAE,aAAa,mBAAmB,GAAG,WAAW,KAAK,OAAO,QAAQ,KAAK,KAAK,QAAQ;GAAE;GAAY,GAAG;GAAM,CAAC;EACxH,cAAc,EAAE,aAAa,mBAAmB,GAAG,WAAW,KAAK,OAAO,YAAY,KAAK,KAAK,QAAQ;GAAE;GAAY,GAAG;GAAM,CAAC;EAChI,cAAc,EAAE,aAAa,mBAAmB,GAAG,WAAW,KAAK,OAAO,YAAY,KAAK,KAAK,QAAQ;GAAE;GAAY,GAAG;GAAM,CAAC;EAChI,gBAAgB,SAAmB;AACjC,OAAI,OAAO,QAAQ,WAAW,WAC5B,QAAO,OAAO,OAAO,KAAK;AAE5B,OAAI,OAAO,QAAQ,WAAW,SAC5B,QAAO,OAAO;AAEhB,UAAO,mBAAmB,EAAE,QAAQ,CAAC;;EAEvC,gBAAgB,SAAmB;AACjC,OAAI,OAAO,QAAQ,WAAW,WAC5B,QAAO,OAAO,OAAO,KAAK;AAE5B,OAAI,OAAO,QAAQ,WAAW,SAC5B,QAAO,OAAO;;EAInB;;;;;;;AClIH,SAAgB,UAAyB;CACvC,MAAM,EAAE,UAAA,GAAA,mBAAA,YAA6C;AAErD,QAAO,KAAK;;;;;;;ACHd,SAAgB,YAA4F;CAC1G,MAAM,EAAE,UAAA,GAAA,mBAAA,YAAkD;AAE1D,QAAO,KAAK;;;;;;;ACHd,SAAgB,kBAAgC;CAC9C,MAAM,EAAE,UAAA,GAAA,mBAAA,YAA8C;AAEtD,QAAO,KAAK"}
+{"version":3,"file":"hooks.cjs","names":["path"],"sources":["../src/hooks/useKubb.ts","../src/hooks/useMode.ts","../src/hooks/usePlugin.ts","../src/hooks/usePluginDriver.ts"],"sourcesContent":["import path from 'node:path'\nimport type { RootNode } from '@kubb/ast/types'\nimport type { KubbFile } from '@kubb/fabric-core/types'\nimport { useFabric } from '@kubb/react-fabric'\nimport type { GetFileOptions, PluginDriver } from '../PluginDriver.ts'\nimport type { Config, Plugin, PluginFactoryOptions, ResolveNameParams, ResolvePathParams } from '../types.ts'\n\ntype ResolvePathOptions = {\n  pluginName?: string\n  group?: {\n    tag?: string\n    path?: string\n  }\n  type?: ResolveNameParams['type']\n}\n\ntype UseKubbReturn<TOptions extends PluginFactoryOptions = PluginFactoryOptions> = {\n  plugin: Plugin<TOptions>\n  mode: KubbFile.Mode\n  config: Config\n  /**\n   * Returns the plugin whose `name` matches `pluginName`, defaulting to the current plugin.\n   */\n  getPluginByName: (pluginName?: string) => Plugin | undefined\n  /**\n   * Resolves a file reference, defaulting `pluginName` to the current plugin.\n   */\n  getFile: (params: Omit<GetFileOptions<ResolvePathOptions>, 'pluginName'> & { pluginName?: string }) => KubbFile.File<{ pluginName: string }>\n  /**\n   * Resolves a name, defaulting `pluginName` to the current plugin.\n   */\n  resolveName: (params: Omit<ResolveNameParams, 'pluginName'> & { pluginName?: string }) => string\n  /**\n   * Resolves a path, defaulting `pluginName` to the current plugin.\n   */\n  resolvePath: <TPathOptions = object>(params: Omit<ResolvePathParams<TPathOptions>, 'pluginName'> & { pluginName?: string }) => KubbFile.Path\n  /**\n   * Resolves the banner using the plugin's `output.banner` option.\n   * Falls back to the default \"Generated by Kubb\" banner when `output.banner` is unset.\n   * When `output.banner` is a function and no node is provided, returns the default banner.\n   */\n  resolveBanner: (node?: RootNode) => string | undefined\n  /**\n   * Resolves the footer using the plugin's `output.footer` option.\n   * Returns `undefined` when no footer is configured.\n   * When `output.footer` is a function and no node is provided, returns `undefined`.\n   */\n  resolveFooter: (node?: RootNode) => string | undefined\n}\n\n/**\n * Generates the default \"Generated by Kubb\" banner from node metadata.\n */\nfunction buildDefaultBanner({ title, description, version, config }: { title?: string; description?: string; version?: string; config: Config }): string {\n  try {\n    let source = ''\n    if (Array.isArray(config.input)) {\n      const first = config.input[0]\n      if (first && 'path' in first) {\n        source = path.basename(first.path)\n      }\n    } else if ('path' in config.input) {\n      source = path.basename(config.input.path)\n    } else if ('data' in config.input) {\n      source = 'text content'\n    }\n\n    let banner = '/**\\n* Generated by Kubb (https://kubb.dev/).\\n* Do not edit manually.\\n'\n\n    if (config.output.defaultBanner === 'simple') {\n      banner += '*/\\n'\n      return banner\n    }\n\n    if (source) {\n      banner += `* Source: ${source}\\n`\n    }\n\n    if (title) {\n      banner += `* Title: ${title}\\n`\n    }\n\n    if (description) {\n      const formattedDescription = description.replace(/\\n/gm, '\\n* ')\n      banner += `* Description: ${formattedDescription}\\n`\n    }\n\n    if (version) {\n      banner += `* OpenAPI spec version: ${version}\\n`\n    }\n\n    banner += '*/\\n'\n    return banner\n  } catch (_error) {\n    return '/**\\n* Generated by Kubb (https://kubb.dev/).\\n* Do not edit manually.\\n*/'\n  }\n}\n\nexport function useKubb<TOptions extends PluginFactoryOptions = PluginFactoryOptions>(): UseKubbReturn<TOptions> {\n  const { meta } = useFabric<{\n    plugin: Plugin<TOptions>\n    mode: KubbFile.Mode\n    driver: PluginDriver\n  }>()\n\n  const config = meta.driver.config\n  const defaultPluginName = meta.plugin.name\n\n  const output = (\n    meta.plugin.options as { output?: { banner?: string | ((node: RootNode) => string); footer?: string | ((node: RootNode) => string) } } | undefined\n  )?.output\n\n  return {\n    plugin: meta.plugin as Plugin<TOptions>,\n    mode: meta.mode,\n    config,\n    getPluginByName: (pluginName = defaultPluginName) => meta.driver.getPluginByName.call(meta.driver, pluginName),\n    getFile: ({ pluginName = defaultPluginName, ...rest }) => meta.driver.getFile.call(meta.driver, { pluginName, ...rest }),\n    resolveName: ({ pluginName = defaultPluginName, ...rest }) => meta.driver.resolveName.call(meta.driver, { pluginName, ...rest }),\n    resolvePath: ({ pluginName = defaultPluginName, ...rest }) => meta.driver.resolvePath.call(meta.driver, { pluginName, ...rest }),\n    resolveBanner: (node?: RootNode) => {\n      if (typeof output?.banner === 'function') {\n        return node ? output.banner(node) : buildDefaultBanner({ config })\n      }\n      if (typeof output?.banner === 'string') {\n        return output.banner\n      }\n      if (config.output.defaultBanner === false) {\n        return undefined\n      }\n      return buildDefaultBanner({ config })\n    },\n    resolveFooter: (node?: RootNode) => {\n      if (typeof output?.footer === 'function') {\n        return node ? output.footer(node) : undefined\n      }\n      if (typeof output?.footer === 'string') {\n        return output.footer\n      }\n      return undefined\n    },\n  }\n}\n","import type { KubbFile } from '@kubb/fabric-core/types'\nimport { useFabric } from '@kubb/react-fabric'\n\n/**\n * @deprecated use `useKubb` instead\n */\nexport function useMode(): KubbFile.Mode {\n  const { meta } = useFabric<{ mode: KubbFile.Mode }>()\n\n  return meta.mode\n}\n","import { useFabric } from '@kubb/react-fabric'\nimport type { Plugin, PluginFactoryOptions } from '../types.ts'\n\n/**\n * @deprecated use useKubb instead\n */\nexport function usePlugin<TOptions extends PluginFactoryOptions = PluginFactoryOptions>(): Plugin<TOptions> {\n  const { meta } = useFabric<{ plugin: Plugin<TOptions> }>()\n\n  return meta.plugin\n}\n","import { useFabric } from '@kubb/react-fabric'\nimport type { PluginDriver } from '../PluginDriver.ts'\n\n/**\n * @deprecated use `useKubb` instead\n */\nexport function usePluginDriver(): PluginDriver {\n  const { meta } = useFabric<{ driver: PluginDriver }>()\n\n  return meta.driver\n}\n"],"mappings":";;;;;;;;;AAqDA,SAAS,mBAAmB,EAAE,OAAO,aAAa,SAAS,UAA8F;AACvJ,KAAI;EACF,IAAI,SAAS;AACb,MAAI,MAAM,QAAQ,OAAO,MAAM,EAAE;GAC/B,MAAM,QAAQ,OAAO,MAAM;AAC3B,OAAI,SAAS,UAAU,MACrB,UAASA,UAAAA,QAAK,SAAS,MAAM,KAAK;aAE3B,UAAU,OAAO,MAC1B,UAASA,UAAAA,QAAK,SAAS,OAAO,MAAM,KAAK;WAChC,UAAU,OAAO,MAC1B,UAAS;EAGX,IAAI,SAAS;AAEb,MAAI,OAAO,OAAO,kBAAkB,UAAU;AAC5C,aAAU;AACV,UAAO;;AAGT,MAAI,OACF,WAAU,aAAa,OAAO;AAGhC,MAAI,MACF,WAAU,YAAY,MAAM;AAG9B,MAAI,aAAa;GACf,MAAM,uBAAuB,YAAY,QAAQ,QAAQ,OAAO;AAChE,aAAU,kBAAkB,qBAAqB;;AAGnD,MAAI,QACF,WAAU,2BAA2B,QAAQ;AAG/C,YAAU;AACV,SAAO;UACA,QAAQ;AACf,SAAO;;;AAIX,SAAgB,UAAiG;CAC/G,MAAM,EAAE,UAAA,GAAA,mBAAA,YAIJ;CAEJ,MAAM,SAAS,KAAK,OAAO;CAC3B,MAAM,oBAAoB,KAAK,OAAO;CAEtC,MAAM,SACJ,KAAK,OAAO,SACX;AAEH,QAAO;EACL,QAAQ,KAAK;EACb,MAAM,KAAK;EACX;EACA,kBAAkB,aAAa,sBAAsB,KAAK,OAAO,gBAAgB,KAAK,KAAK,QAAQ,WAAW;EAC9G,UAAU,EAAE,aAAa,mBAAmB,GAAG,WAAW,KAAK,OAAO,QAAQ,KAAK,KAAK,QAAQ;GAAE;GAAY,GAAG;GAAM,CAAC;EACxH,cAAc,EAAE,aAAa,mBAAmB,GAAG,WAAW,KAAK,OAAO,YAAY,KAAK,KAAK,QAAQ;GAAE;GAAY,GAAG;GAAM,CAAC;EAChI,cAAc,EAAE,aAAa,mBAAmB,GAAG,WAAW,KAAK,OAAO,YAAY,KAAK,KAAK,QAAQ;GAAE;GAAY,GAAG;GAAM,CAAC;EAChI,gBAAgB,SAAoB;AAClC,OAAI,OAAO,QAAQ,WAAW,WAC5B,QAAO,OAAO,OAAO,OAAO,KAAK,GAAG,mBAAmB,EAAE,QAAQ,CAAC;AAEpE,OAAI,OAAO,QAAQ,WAAW,SAC5B,QAAO,OAAO;AAEhB,OAAI,OAAO,OAAO,kBAAkB,MAClC;AAEF,UAAO,mBAAmB,EAAE,QAAQ,CAAC;;EAEvC,gBAAgB,SAAoB;AAClC,OAAI,OAAO,QAAQ,WAAW,WAC5B,QAAO,OAAO,OAAO,OAAO,KAAK,GAAG,KAAA;AAEtC,OAAI,OAAO,QAAQ,WAAW,SAC5B,QAAO,OAAO;;EAInB;;;;;;;ACvIH,SAAgB,UAAyB;CACvC,MAAM,EAAE,UAAA,GAAA,mBAAA,YAA6C;AAErD,QAAO,KAAK;;;;;;;ACHd,SAAgB,YAA4F;CAC1G,MAAM,EAAE,UAAA,GAAA,mBAAA,YAAkD;AAE1D,QAAO,KAAK;;;;;;;ACHd,SAAgB,kBAAgC;CAC9C,MAAM,EAAE,UAAA,GAAA,mBAAA,YAA8C;AAEtD,QAAO,KAAK"}

package/dist/hooks.d.ts

@@ -1,5 +1,5 @@
 import { t as __name } from "./chunk--u3MIqq1.js";
-import { D as ResolveNameParams, O as ResolvePathParams, b as PluginFactoryOptions, c as Config, n as PluginDriver, t as GetFileOptions, v as Plugin } from "./PluginDriver-DRfJIbG1.js";
+import { E as ResolveNameParams, O as ResolvePathParams, _ as Plugin, c as Config, n as PluginDriver, t as GetFileOptions, y as PluginFactoryOptions } from "./PluginDriver-BkFepPdm.js";
 import { RootNode } from "@kubb/ast/types";
 import { KubbFile } from "@kubb/fabric-core/types";
 
@@ -41,15 +41,17 @@ type UseKubbReturn<TOptions extends PluginFactoryOptions = PluginFactoryOptions>
     pluginName?: string;
   }) => KubbFile.Path;
   /**
-   * Resolves the banner for the given node using the plugin's `output.banner` option.
-   * Returns a string when `output.banner` is a string or a function, `undefined` otherwise.
+   * Resolves the banner using the plugin's `output.banner` option.
+   * Falls back to the default "Generated by Kubb" banner when `output.banner` is unset.
+   * When `output.banner` is a function and no node is provided, returns the default banner.
    */
-  resolveBanner: (node: RootNode) => string | undefined;
+  resolveBanner: (node?: RootNode) => string | undefined;
   /**
-   * Resolves the footer for the given node using the plugin's `output.footer` option.
-   * Returns a string when `output.footer` is a string or a function, `undefined` otherwise.
+   * Resolves the footer using the plugin's `output.footer` option.
+   * Returns `undefined` when no footer is configured.
+   * When `output.footer` is a function and no node is provided, returns `undefined`.
    */
-  resolveFooter: (node: RootNode) => string | undefined;
+  resolveFooter: (node?: RootNode) => string | undefined;
 };
 declare function useKubb<TOptions extends PluginFactoryOptions = PluginFactoryOptions>(): UseKubbReturn<TOptions>;
 //#endregion

package/dist/hooks.js

@@ -54,12 +54,13 @@ function useKubb() {
 			...rest
 		}),
 		resolveBanner: (node) => {
-			if (typeof output?.banner === "function") return output.banner(node);
+			if (typeof output?.banner === "function") return node ? output.banner(node) : buildDefaultBanner({ config });
 			if (typeof output?.banner === "string") return output.banner;
+			if (config.output.defaultBanner === false) return;
 			return buildDefaultBanner({ config });
 		},
 		resolveFooter: (node) => {
-			if (typeof output?.footer === "function") return output.footer(node);
+			if (typeof output?.footer === "function") return node ? output.footer(node) : void 0;
 			if (typeof output?.footer === "string") return output.footer;
 		}
 	};