@kubb/core 5.0.0-alpha.6 → 5.0.0-alpha.7

package/dist/{PluginManager-vZodFEMe.d.ts → PluginDriver-Dma9KhLK.d.ts}

@@ -1,7 +1,7 @@
 import { t as __name } from "./chunk--u3MIqq1.js";
 import { EventEmitter } from "node:events";
-import { Fabric, KubbFile } from "@kubb/fabric-core/types";
 import { OperationNode, Printer, PrinterFactoryOptions, RootNode, SchemaNode } from "@kubb/ast/types";
+import { Fabric, KubbFile } from "@kubb/fabric-core/types";
 import { FabricReactNode } from "@kubb/react-fabric/types";
 
 //#region ../../internals/utils/dist/index.d.ts
@@ -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 `PluginManager' where we convert from `UserPlugin` to `Plugin`(used when calling `definePlugin`).
+   * Define a context that can be used by other plugins, see `PluginDriver' where we convert from `UserPlugin` to `Plugin`(used when calling `definePlugin`).
    */
   inject: (this: PluginContext<TOptions>, context: PluginContext<TOptions>) => TOptions['context'];
 };
@@ -836,7 +836,7 @@ type ResolveNameParams = {
 type PluginContext<TOptions extends PluginFactoryOptions = PluginFactoryOptions> = {
   fabric: Fabric;
   config: Config;
-  pluginManager: PluginManager;
+  driver: PluginDriver;
   /**
    * Only add when the file does not exist yet
    */
@@ -931,7 +931,7 @@ type Logger<TOptions extends LoggerOptions = LoggerOptions> = {
 };
 type UserLogger<TOptions extends LoggerOptions = LoggerOptions> = Omit<Logger<TOptions>, 'logLevel'>;
 //#endregion
-//#region src/PluginManager.d.ts
+//#region src/PluginDriver.d.ts
 type RequiredPluginLifecycle = Required<PluginLifecycle>;
 type Strategy = 'hookFirst' | 'hookForPlugin' | 'hookParallel' | 'hookSeq';
 type ParseResult<H extends PluginLifecycleHooks> = RequiredPluginLifecycle[H];
@@ -955,7 +955,7 @@ type GetFileOptions<TOptions = object> = {
   options?: TOptions;
 };
 declare function getMode(fileOrFolder: string | undefined | null): KubbFile.Mode;
-declare class PluginManager {
+declare class PluginDriver {
   #private;
   readonly config: Config;
   readonly options: Options;
@@ -1052,5 +1052,5 @@ declare class PluginManager {
   getPluginsByName(hookName: keyof PluginWithLifeCycle, pluginName: string): Plugin[];
 }
 //#endregion
-export { UserConfig as A, defineStorage as B, PluginParameter as C, ResolveNameParams as D, PrinterFactoryOptions as E, Generator as F, URLPath as G, linters as H, ReactGeneratorV2 as I, defineGenerator 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, PluginManager 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=PluginManager-vZodFEMe.d.ts.map
+export { UserConfig as A, defineStorage as B, PluginParameter as C, ResolveNameParams as D, PrinterFactoryOptions as E, Generator as F, URLPath as G, linters as H, ReactGeneratorV2 as I, defineGenerator 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-Dma9KhLK.d.ts.map

package/dist/hooks.cjs

@@ -1,27 +1,69 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-require("./chunk-ByKO4r7w.cjs");
+const require_chunk = require("./chunk-ByKO4r7w.cjs");
+let node_path = require("node:path");
+node_path = require_chunk.__toESM(node_path);
 let _kubb_react_fabric = require("@kubb/react-fabric");
 //#region src/hooks/useKubb.ts
+/**
+* Generates the default "Generated by Kubb" banner from node metadata.
+*/
+function buildDefaultBanner({ title, description, version, config }) {
+	try {
+		let source = "";
+		if (Array.isArray(config.input)) {
+			const first = config.input[0];
+			if (first && "path" in first) source = node_path.default.basename(first.path);
+		} else if ("path" in config.input) source = node_path.default.basename(config.input.path);
+		else if ("data" in config.input) source = "text content";
+		let banner = "/**\n* Generated by Kubb (https://kubb.dev/).\n* Do not edit manually.\n";
+		if (config.output.defaultBanner === "simple") {
+			banner += "*/\n";
+			return banner;
+		}
+		if (source) banner += `* Source: ${source}\n`;
+		if (title) banner += `* Title: ${title}\n`;
+		if (description) {
+			const formattedDescription = description.replace(/\n/gm, "\n* ");
+			banner += `* Description: ${formattedDescription}\n`;
+		}
+		if (version) banner += `* OpenAPI spec version: ${version}\n`;
+		banner += "*/\n";
+		return banner;
+	} catch (_error) {
+		return "/**\n* Generated by Kubb (https://kubb.dev/).\n* Do not edit manually.\n*/";
+	}
+}
 function useKubb() {
 	const { meta } = (0, _kubb_react_fabric.useFabric)();
+	const config = meta.driver.config;
 	const defaultPluginName = meta.plugin.name;
+	const output = meta.plugin.options?.output;
 	return {
 		plugin: meta.plugin,
 		mode: meta.mode,
-		config: meta.pluginManager.config,
-		getPluginByName: (pluginName = defaultPluginName) => meta.pluginManager.getPluginByName.call(meta.pluginManager, pluginName),
-		getFile: ({ pluginName = defaultPluginName, ...rest }) => meta.pluginManager.getFile.call(meta.pluginManager, {
+		config,
+		getPluginByName: (pluginName = defaultPluginName) => meta.driver.getPluginByName.call(meta.driver, pluginName),
+		getFile: ({ pluginName = defaultPluginName, ...rest }) => meta.driver.getFile.call(meta.driver, {
 			pluginName,
 			...rest
 		}),
-		resolveName: ({ pluginName = defaultPluginName, ...rest }) => meta.pluginManager.resolveName.call(meta.pluginManager, {
+		resolveName: ({ pluginName = defaultPluginName, ...rest }) => meta.driver.resolveName.call(meta.driver, {
 			pluginName,
 			...rest
 		}),
-		resolvePath: ({ pluginName = defaultPluginName, ...rest }) => meta.pluginManager.resolvePath.call(meta.pluginManager, {
+		resolvePath: ({ pluginName = defaultPluginName, ...rest }) => meta.driver.resolvePath.call(meta.driver, {
 			pluginName,
 			...rest
-		})
+		}),
+		resolveBanner: (node) => {
+			if (typeof output?.banner === "function") return output.banner(node);
+			if (typeof output?.banner === "string") return output.banner;
+			return buildDefaultBanner({ config });
+		},
+		resolveFooter: (node) => {
+			if (typeof output?.footer === "function") return output.footer(node);
+			if (typeof output?.footer === "string") return output.footer;
+		}
 	};
 }
 //#endregion
@@ -43,18 +85,18 @@ function usePlugin() {
 	return meta.plugin;
 }
 //#endregion
-//#region src/hooks/usePluginManager.ts
+//#region src/hooks/usePluginDriver.ts
 /**
 * @deprecated use `useKubb` instead
 */
-function usePluginManager() {
+function usePluginDriver() {
 	const { meta } = (0, _kubb_react_fabric.useFabric)();
-	return meta.pluginManager;
+	return meta.driver;
 }
 //#endregion
 exports.useKubb = useKubb;
 exports.useMode = useMode;
 exports.usePlugin = usePlugin;
-exports.usePluginManager = usePluginManager;
+exports.usePluginDriver = usePluginDriver;
 
 //# sourceMappingURL=hooks.cjs.map

package/dist/hooks.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"hooks.cjs","names":[],"sources":["../src/hooks/useKubb.ts","../src/hooks/useMode.ts","../src/hooks/usePlugin.ts","../src/hooks/usePluginManager.ts"],"sourcesContent":["import type { KubbFile } from '@kubb/fabric-core/types'\nimport { useFabric } from '@kubb/react-fabric'\nimport type { GetFileOptions, PluginManager } from '../PluginManager.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\nexport function useKubb<TOptions extends PluginFactoryOptions = PluginFactoryOptions>(): UseKubbReturn<TOptions> {\n  const { meta } = useFabric<{\n    plugin: Plugin<TOptions>\n    mode: KubbFile.Mode\n    pluginManager: PluginManager\n  }>()\n\n  const defaultPluginName = meta.plugin.name\n\n  return {\n    plugin: meta.plugin as Plugin<TOptions>,\n    mode: meta.mode,\n    config: meta.pluginManager.config,\n    getPluginByName: (pluginName = defaultPluginName) => meta.pluginManager.getPluginByName.call(meta.pluginManager, pluginName),\n    getFile: ({ pluginName = defaultPluginName, ...rest }) => meta.pluginManager.getFile.call(meta.pluginManager, { pluginName, ...rest }),\n    resolveName: ({ pluginName = defaultPluginName, ...rest }) => meta.pluginManager.resolveName.call(meta.pluginManager, { pluginName, ...rest }),\n    resolvePath: ({ pluginName = defaultPluginName, ...rest }) => meta.pluginManager.resolvePath.call(meta.pluginManager, { pluginName, ...rest }),\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 { PluginManager } from '../PluginManager.ts'\n\n/**\n * @deprecated use `useKubb` instead\n */\nexport function usePluginManager(): PluginManager {\n  const { meta } = useFabric<{ pluginManager: PluginManager }>()\n\n  return meta.pluginManager\n}\n"],"mappings":";;;;AAoCA,SAAgB,UAAiG;CAC/G,MAAM,EAAE,UAAA,GAAA,mBAAA,YAIJ;CAEJ,MAAM,oBAAoB,KAAK,OAAO;AAEtC,QAAO;EACL,QAAQ,KAAK;EACb,MAAM,KAAK;EACX,QAAQ,KAAK,cAAc;EAC3B,kBAAkB,aAAa,sBAAsB,KAAK,cAAc,gBAAgB,KAAK,KAAK,eAAe,WAAW;EAC5H,UAAU,EAAE,aAAa,mBAAmB,GAAG,WAAW,KAAK,cAAc,QAAQ,KAAK,KAAK,eAAe;GAAE;GAAY,GAAG;GAAM,CAAC;EACtI,cAAc,EAAE,aAAa,mBAAmB,GAAG,WAAW,KAAK,cAAc,YAAY,KAAK,KAAK,eAAe;GAAE;GAAY,GAAG;GAAM,CAAC;EAC9I,cAAc,EAAE,aAAa,mBAAmB,GAAG,WAAW,KAAK,cAAc,YAAY,KAAK,KAAK,eAAe;GAAE;GAAY,GAAG;GAAM,CAAC;EAC/I;;;;;;;AC/CH,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,mBAAkC;CAChD,MAAM,EAAE,UAAA,GAAA,mBAAA,YAAsD;AAE9D,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 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"}

package/dist/hooks.d.ts

@@ -1,5 +1,6 @@
 import { t as __name } from "./chunk--u3MIqq1.js";
-import { D as ResolveNameParams, O as ResolvePathParams, b as PluginFactoryOptions, c as Config, n as PluginManager, t as GetFileOptions, v as Plugin } from "./PluginManager-vZodFEMe.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-Dma9KhLK.js";
+import { RootNode } from "@kubb/ast/types";
 import { KubbFile } from "@kubb/fabric-core/types";
 
 //#region src/hooks/useKubb.d.ts
@@ -39,6 +40,16 @@ type UseKubbReturn<TOptions extends PluginFactoryOptions = PluginFactoryOptions>
   resolvePath: <TPathOptions = object>(params: Omit<ResolvePathParams<TPathOptions>, 'pluginName'> & {
     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.
+   */
+  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.
+   */
+  resolveFooter: (node: RootNode) => string | undefined;
 };
 declare function useKubb<TOptions extends PluginFactoryOptions = PluginFactoryOptions>(): UseKubbReturn<TOptions>;
 //#endregion
@@ -54,11 +65,11 @@ declare function useMode(): KubbFile.Mode;
  */
 declare function usePlugin<TOptions extends PluginFactoryOptions = PluginFactoryOptions>(): Plugin<TOptions>;
 //#endregion
-//#region src/hooks/usePluginManager.d.ts
+//#region src/hooks/usePluginDriver.d.ts
 /**
  * @deprecated use `useKubb` instead
  */
-declare function usePluginManager(): PluginManager;
+declare function usePluginDriver(): PluginDriver;
 //#endregion
-export { useKubb, useMode, usePlugin, usePluginManager };
+export { useKubb, useMode, usePlugin, usePluginDriver };
 //# sourceMappingURL=hooks.d.ts.map

package/dist/hooks.js

@@ -1,26 +1,67 @@
 import "./chunk--u3MIqq1.js";
+import path from "node:path";
 import { useFabric } from "@kubb/react-fabric";
 //#region src/hooks/useKubb.ts
+/**
+* Generates the default "Generated by Kubb" banner from node metadata.
+*/
+function buildDefaultBanner({ title, description, version, config }) {
+	try {
+		let source = "";
+		if (Array.isArray(config.input)) {
+			const first = config.input[0];
+			if (first && "path" in first) source = path.basename(first.path);
+		} else if ("path" in config.input) source = path.basename(config.input.path);
+		else if ("data" in config.input) source = "text content";
+		let banner = "/**\n* Generated by Kubb (https://kubb.dev/).\n* Do not edit manually.\n";
+		if (config.output.defaultBanner === "simple") {
+			banner += "*/\n";
+			return banner;
+		}
+		if (source) banner += `* Source: ${source}\n`;
+		if (title) banner += `* Title: ${title}\n`;
+		if (description) {
+			const formattedDescription = description.replace(/\n/gm, "\n* ");
+			banner += `* Description: ${formattedDescription}\n`;
+		}
+		if (version) banner += `* OpenAPI spec version: ${version}\n`;
+		banner += "*/\n";
+		return banner;
+	} catch (_error) {
+		return "/**\n* Generated by Kubb (https://kubb.dev/).\n* Do not edit manually.\n*/";
+	}
+}
 function useKubb() {
 	const { meta } = useFabric();
+	const config = meta.driver.config;
 	const defaultPluginName = meta.plugin.name;
+	const output = meta.plugin.options?.output;
 	return {
 		plugin: meta.plugin,
 		mode: meta.mode,
-		config: meta.pluginManager.config,
-		getPluginByName: (pluginName = defaultPluginName) => meta.pluginManager.getPluginByName.call(meta.pluginManager, pluginName),
-		getFile: ({ pluginName = defaultPluginName, ...rest }) => meta.pluginManager.getFile.call(meta.pluginManager, {
+		config,
+		getPluginByName: (pluginName = defaultPluginName) => meta.driver.getPluginByName.call(meta.driver, pluginName),
+		getFile: ({ pluginName = defaultPluginName, ...rest }) => meta.driver.getFile.call(meta.driver, {
 			pluginName,
 			...rest
 		}),
-		resolveName: ({ pluginName = defaultPluginName, ...rest }) => meta.pluginManager.resolveName.call(meta.pluginManager, {
+		resolveName: ({ pluginName = defaultPluginName, ...rest }) => meta.driver.resolveName.call(meta.driver, {
 			pluginName,
 			...rest
 		}),
-		resolvePath: ({ pluginName = defaultPluginName, ...rest }) => meta.pluginManager.resolvePath.call(meta.pluginManager, {
+		resolvePath: ({ pluginName = defaultPluginName, ...rest }) => meta.driver.resolvePath.call(meta.driver, {
 			pluginName,
 			...rest
-		})
+		}),
+		resolveBanner: (node) => {
+			if (typeof output?.banner === "function") return output.banner(node);
+			if (typeof output?.banner === "string") return output.banner;
+			return buildDefaultBanner({ config });
+		},
+		resolveFooter: (node) => {
+			if (typeof output?.footer === "function") return output.footer(node);
+			if (typeof output?.footer === "string") return output.footer;
+		}
 	};
 }
 //#endregion
@@ -42,15 +83,15 @@ function usePlugin() {
 	return meta.plugin;
 }
 //#endregion
-//#region src/hooks/usePluginManager.ts
+//#region src/hooks/usePluginDriver.ts
 /**
 * @deprecated use `useKubb` instead
 */
-function usePluginManager() {
+function usePluginDriver() {
 	const { meta } = useFabric();
-	return meta.pluginManager;
+	return meta.driver;
 }
 //#endregion
-export { useKubb, useMode, usePlugin, usePluginManager };
+export { useKubb, useMode, usePlugin, usePluginDriver };
 
 //# sourceMappingURL=hooks.js.map

package/dist/hooks.js.map

@@ -1 +1 @@
-{"version":3,"file":"hooks.js","names":[],"sources":["../src/hooks/useKubb.ts","../src/hooks/useMode.ts","../src/hooks/usePlugin.ts","../src/hooks/usePluginManager.ts"],"sourcesContent":["import type { KubbFile } from '@kubb/fabric-core/types'\nimport { useFabric } from '@kubb/react-fabric'\nimport type { GetFileOptions, PluginManager } from '../PluginManager.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\nexport function useKubb<TOptions extends PluginFactoryOptions = PluginFactoryOptions>(): UseKubbReturn<TOptions> {\n  const { meta } = useFabric<{\n    plugin: Plugin<TOptions>\n    mode: KubbFile.Mode\n    pluginManager: PluginManager\n  }>()\n\n  const defaultPluginName = meta.plugin.name\n\n  return {\n    plugin: meta.plugin as Plugin<TOptions>,\n    mode: meta.mode,\n    config: meta.pluginManager.config,\n    getPluginByName: (pluginName = defaultPluginName) => meta.pluginManager.getPluginByName.call(meta.pluginManager, pluginName),\n    getFile: ({ pluginName = defaultPluginName, ...rest }) => meta.pluginManager.getFile.call(meta.pluginManager, { pluginName, ...rest }),\n    resolveName: ({ pluginName = defaultPluginName, ...rest }) => meta.pluginManager.resolveName.call(meta.pluginManager, { pluginName, ...rest }),\n    resolvePath: ({ pluginName = defaultPluginName, ...rest }) => meta.pluginManager.resolvePath.call(meta.pluginManager, { pluginName, ...rest }),\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 { PluginManager } from '../PluginManager.ts'\n\n/**\n * @deprecated use `useKubb` instead\n */\nexport function usePluginManager(): PluginManager {\n  const { meta } = useFabric<{ pluginManager: PluginManager }>()\n\n  return meta.pluginManager\n}\n"],"mappings":";;;AAoCA,SAAgB,UAAiG;CAC/G,MAAM,EAAE,SAAS,WAIb;CAEJ,MAAM,oBAAoB,KAAK,OAAO;AAEtC,QAAO;EACL,QAAQ,KAAK;EACb,MAAM,KAAK;EACX,QAAQ,KAAK,cAAc;EAC3B,kBAAkB,aAAa,sBAAsB,KAAK,cAAc,gBAAgB,KAAK,KAAK,eAAe,WAAW;EAC5H,UAAU,EAAE,aAAa,mBAAmB,GAAG,WAAW,KAAK,cAAc,QAAQ,KAAK,KAAK,eAAe;GAAE;GAAY,GAAG;GAAM,CAAC;EACtI,cAAc,EAAE,aAAa,mBAAmB,GAAG,WAAW,KAAK,cAAc,YAAY,KAAK,KAAK,eAAe;GAAE;GAAY,GAAG;GAAM,CAAC;EAC9I,cAAc,EAAE,aAAa,mBAAmB,GAAG,WAAW,KAAK,cAAc,YAAY,KAAK,KAAK,eAAe;GAAE;GAAY,GAAG;GAAM,CAAC;EAC/I;;;;;;;AC/CH,SAAgB,UAAyB;CACvC,MAAM,EAAE,SAAS,WAAoC;AAErD,QAAO,KAAK;;;;;;;ACHd,SAAgB,YAA4F;CAC1G,MAAM,EAAE,SAAS,WAAyC;AAE1D,QAAO,KAAK;;;;;;;ACHd,SAAgB,mBAAkC;CAChD,MAAM,EAAE,SAAS,WAA6C;AAE9D,QAAO,KAAK"}
+{"version":3,"file":"hooks.js","names":[],"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,UAAS,KAAK,SAAS,MAAM,KAAK;aAE3B,UAAU,OAAO,MAC1B,UAAS,KAAK,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,SAAS,WAIb;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,SAAS,WAAoC;AAErD,QAAO,KAAK;;;;;;;ACHd,SAAgB,YAA4F;CAC1G,MAAM,EAAE,SAAS,WAAyC;AAE1D,QAAO,KAAK;;;;;;;ACHd,SAAgB,kBAAgC;CAC9C,MAAM,EAAE,SAAS,WAAqC;AAEtD,QAAO,KAAK"}