@kubb/core 5.0.0-alpha.22 → 5.0.0-alpha.23

package/dist/{PluginDriver-DZdEyCoa.d.ts → PluginDriver-P920mak9.d.ts}

@@ -219,7 +219,9 @@ type OperationsV2Props<TPlugin extends PluginFactoryOptions = PluginFactoryOptio
   config: Config;
   plugin: Plugin<TPlugin>;
   adapter: Adapter;
+  driver: PluginDriver;
   options: Plugin<TPlugin>['options'];
+  resolver: TPlugin['resolver'];
   nodes: Array<OperationNode>;
 };
 /**
@@ -228,8 +230,10 @@ type OperationsV2Props<TPlugin extends PluginFactoryOptions = PluginFactoryOptio
 type OperationV2Props<TPlugin extends PluginFactoryOptions = PluginFactoryOptions> = {
   config: Config;
   adapter: Adapter;
+  driver: PluginDriver;
   plugin: Plugin<TPlugin>;
   options: Plugin<TPlugin>['options'];
+  resolver: TPlugin['resolver'];
   node: OperationNode;
 };
 /**
@@ -238,8 +242,10 @@ type OperationV2Props<TPlugin extends PluginFactoryOptions = PluginFactoryOption
 type SchemaV2Props<TPlugin extends PluginFactoryOptions = PluginFactoryOptions> = {
   config: Config;
   adapter: Adapter;
+  driver: PluginDriver;
   plugin: Plugin<TPlugin>;
   options: Plugin<TPlugin>['options'];
+  resolver: TPlugin['resolver'];
   node: SchemaNode;
 };
 /**
@@ -785,7 +791,7 @@ type Config<TInput = Input> = {
    * Each plugin may include additional configurable options(defined in the plugin itself).
    * If a plugin depends on another plugin, an error is returned if the required dependency is missing. See pre for more details.
    */
-  plugins?: Array<Plugin>;
+  plugins: Array<Plugin>;
   /**
    * Devtools configuration for Kubb Studio integration.
    */
@@ -870,14 +876,6 @@ type Resolver = {
  * ```
  */
 type UserResolver = Omit<Resolver, 'default' | 'resolveOptions' | 'resolvePath' | 'resolveFile' | 'resolveBanner' | 'resolveFooter'>;
-/**
- * Base type for plugin builder objects.
- * Concrete plugin builder types extend this with their own schema-building helpers.
- * Use `defineBuilder` to define a builder object and export it alongside the plugin.
- */
-type Builder = {
-  name: string;
-};
 type PluginFactoryOptions<
 /**
  * Name to be used for the plugin.
@@ -903,19 +901,13 @@ 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,
-/**
- * Builder object that encapsulates the schema-building helpers used by this plugin.
- * Use `defineBuilder` to define the builder object and export it alongside the plugin.
- */
-TBuilder extends Builder = Builder> = {
+TResolver extends Resolver = Resolver> = {
   name: TName;
   options: TOptions;
   resolvedOptions: TResolvedOptions;
   context: TContext;
   resolvePathOptions: TResolvePathOptions;
   resolver: TResolver;
-  builder: TBuilder;
 };
 type UserPlugin<TOptions extends PluginFactoryOptions = PluginFactoryOptions> = {
   /**
@@ -928,6 +920,10 @@ type UserPlugin<TOptions extends PluginFactoryOptions = PluginFactoryOptions> =
    * Options set for a specific plugin(see kubb.config.js), passthrough of options.
    */
   options: TOptions['resolvedOptions'];
+  /**
+   * The resolver for this plugin, accessible via `driver.getPluginByName(name)?.resolver`.
+   */
+  resolver?: TOptions['resolver'];
   /**
    * Specifies the preceding plugins for the current plugin. You can pass an array of preceding plugin names, and the current plugin is executed after these plugins.
    * Can be used to validate dependent plugins.
@@ -960,6 +956,10 @@ type Plugin<TOptions extends PluginFactoryOptions = PluginFactoryOptions> = {
    * Options set for a specific plugin(see kubb.config.js), passthrough of options.
    */
   options: TOptions['resolvedOptions'];
+  /**
+   * The resolver for this plugin, accessible via `driver.getPluginByName(name)?.resolver`.
+   */
+  resolver: TOptions['resolver'];
   install: (this: PluginContext<TOptions>, context: PluginContext<TOptions>) => PossiblePromise<void>;
   /**
    * Defines a context that can be used by other plugins, see `PluginDriver` where we convert from `UserPlugin` to `Plugin` (used when calling `createPlugin`).
@@ -1018,6 +1018,7 @@ type PluginContext<TOptions extends PluginFactoryOptions = PluginFactoryOptions>
   fabric: Fabric;
   config: Config;
   driver: PluginDriver;
+  getPlugin: PluginDriver['getPlugin'];
   /**
    * Only add when the file does not exist yet
    */
@@ -1027,11 +1028,14 @@ type PluginContext<TOptions extends PluginFactoryOptions = PluginFactoryOptions>
    */
   upsertFile: (...file: Array<FabricFile.File>) => Promise<void>;
   events: AsyncEventEmitter<KubbEvents>;
-  mode: FabricFile.Mode;
   /**
    * Current plugin
    */
   plugin: Plugin<TOptions>;
+  /**
+   * Resolver for the current plugin. Shorthand for `plugin.resolver`.
+   */
+  resolver: TOptions['resolver'];
   /**
    * Opens the Kubb Studio URL for the current `rootNode` in the default browser.
    * Falls back to printing the URL if the browser cannot be launched.
@@ -1079,7 +1083,7 @@ type Output<_TOptions = unknown> = {
    */
   override?: boolean;
 };
-type Group = {
+type UserGroup = {
   /**
    * Defines the type where to group the files.
    * - 'tag' groups files by OpenAPI tags.
@@ -1094,6 +1098,21 @@ type Group = {
     group: string;
   }) => string;
 };
+type Group = {
+  /**
+   * Defines the type where to group the files.
+   * - 'tag' groups files by OpenAPI tags.
+   * - 'path' groups files by OpenAPI paths.
+   * @default undefined
+   */
+  type: 'tag' | 'path';
+  /**
+   * Return the name of a group based on the group name, this is used for the file and name generation.
+   */
+  name: (context: {
+    group: string;
+  }) => string;
+};
 type LoggerOptions = {
   /**
    * @default 3
@@ -1333,10 +1352,13 @@ declare class PluginDriver {
    */
   rootNode: RootNode | undefined;
   adapter: Adapter | undefined;
+  readonly plugins: Map<string, Plugin>;
   constructor(config: Config, options: Options);
   get events(): AsyncEventEmitter<KubbEvents>;
   getContext<TOptions extends PluginFactoryOptions>(plugin: Plugin<TOptions>): PluginContext<TOptions> & Record<string, unknown>;
-  get plugins(): Array<Plugin>;
+  /**
+   * @deprecated use resolvers context instead
+   */
   getFile<TOptions = object>({
     name,
     mode,
@@ -1346,7 +1368,13 @@ declare class PluginDriver {
   }: GetFileOptions<TOptions>): FabricFile.File<{
     pluginName: string;
   }>;
+  /**
+   * @deprecated use resolvers context instead
+   */
   resolvePath: <TOptions = object>(params: ResolvePathParams<TOptions>) => FabricFile.Path;
+  /**
+   * @deprecated use resolvers context instead
+   */
   resolveName: (params: ResolveNameParams) => string;
   /**
    * Run a specific hookName for plugin x.
@@ -1416,9 +1444,8 @@ declare class PluginDriver {
     hookName: H;
     parameters?: PluginParameter<H>;
   }): Promise<void>;
-  getPluginByName(pluginName: string): Plugin | undefined;
-  getPluginsByName(hookName: keyof PluginWithLifeCycle, pluginName: string): Plugin[];
+  getPlugin<TOptions extends PluginFactoryOptions = PluginFactoryOptions>(pluginName: string): Plugin<TOptions> | undefined;
 }
 //#endregion
-export { formatters as $, Printer as A, ResolverPathParams as B, PluginFactoryOptions as C, PluginWithLifeCycle as D, PluginParameter as E, ResolvePathOptions as F, UserResolver as G, UserLogger as H, ResolvePathParams as I, Generator as J, KubbEvents as K, Resolver as L, ResolveBannerContext as M, ResolveNameParams as N, Preset as O, ResolveOptionsContext as P, createStorage as Q, ResolverContext as R, PluginContext as S, PluginLifecycleHooks as T, UserPlugin as U, UserConfig as V, UserPluginWithLifeCycle as W, defineGenerator as X, ReactGeneratorV2 as Y, Storage as Z, LoggerContext as _, AdapterSource as a, Override as b, CompatibilityPreset as c, Exclude as d, linters as et, Group as f, Logger as g, InputPath as h, AdapterFactoryOptions as i, PrinterFactoryOptions as j, Presets as k, Config as l, InputData as m, getMode as n, PossiblePromise as nt, BarrelType as o, Include as p, CoreGeneratorV2 as q, Adapter as r, AsyncEventEmitter as rt, Builder as s, PluginDriver as t, logLevel as tt, DevtoolsOptions as u, LoggerOptions as v, PluginLifecycle as w, Plugin as x, Output as y, ResolverFileParams as z };
-//# sourceMappingURL=PluginDriver-DZdEyCoa.d.ts.map
+export { formatters as $, PrinterFactoryOptions as A, UserConfig as B, PluginLifecycle as C, Preset as D, PluginWithLifeCycle as E, ResolvePathParams as F, UserResolver as G, UserLogger as H, Resolver as I, Generator as J, KubbEvents as K, ResolverContext as L, ResolveNameParams as M, ResolveOptionsContext as N, Presets as O, ResolvePathOptions as P, createStorage as Q, ResolverFileParams as R, PluginFactoryOptions as S, PluginParameter as T, UserPlugin as U, UserGroup as V, UserPluginWithLifeCycle as W, defineGenerator as X, ReactGeneratorV2 as Y, Storage as Z, LoggerOptions as _, AdapterSource as a, Plugin as b, Config as c, Group as d, linters as et, Include as f, LoggerContext as g, Logger as h, AdapterFactoryOptions as i, ResolveBannerContext as j, Printer as k, DevtoolsOptions as l, InputPath as m, getMode as n, PossiblePromise as nt, BarrelType as o, InputData as p, CoreGeneratorV2 as q, Adapter as r, AsyncEventEmitter as rt, CompatibilityPreset as s, PluginDriver as t, logLevel as tt, Exclude as u, Output as v, PluginLifecycleHooks as w, PluginContext as x, Override as y, ResolverPathParams as z };
+//# sourceMappingURL=PluginDriver-P920mak9.d.ts.map

package/dist/hooks.cjs

@@ -3,9 +3,7 @@ require("./chunk-ByKO4r7w.cjs");
 let _kubb_react_fabric = require("@kubb/react-fabric");
 //#region src/hooks/useDriver.ts
 /**
-* Returns the `PluginDriver` instance from Fabric context.
-*
-* Use this inside React generator components to access the driver, config, and adapter.
+* @deprecated use `driver` from the generator component props instead
 */
 function useDriver() {
 	const { meta } = (0, _kubb_react_fabric.useFabric)();

package/dist/hooks.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"hooks.cjs","names":[],"sources":["../src/hooks/useDriver.ts","../src/hooks/useMode.ts","../src/hooks/usePlugin.ts"],"sourcesContent":["import { useFabric } from '@kubb/react-fabric'\nimport type { PluginDriver } from '../PluginDriver.ts'\n\n/**\n * Returns the `PluginDriver` instance from Fabric context.\n *\n * Use this inside React generator components to access the driver, config, and adapter.\n */\nexport function useDriver(): PluginDriver {\n  const { meta } = useFabric<{ driver: PluginDriver }>()\n\n  return meta.driver\n}\n","import type { FabricFile } from '@kubb/fabric-core/types'\nimport { useFabric } from '@kubb/react-fabric'\n\n/**\n * @deprecated use `mode` from the generator component props instead\n */\nexport function useMode(): FabricFile.Mode {\n  const { meta } = useFabric<{ mode: FabricFile.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 `plugin` from the generator component props 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"],"mappings":";;;;;;;;;AAQA,SAAgB,YAA0B;CACxC,MAAM,EAAE,UAAA,GAAA,mBAAA,YAA8C;AAEtD,QAAO,KAAK;;;;;;;ACLd,SAAgB,UAA2B;CACzC,MAAM,EAAE,UAAA,GAAA,mBAAA,YAA+C;AAEvD,QAAO,KAAK;;;;;;;ACHd,SAAgB,YAA4F;CAC1G,MAAM,EAAE,UAAA,GAAA,mBAAA,YAAkD;AAE1D,QAAO,KAAK"}
+{"version":3,"file":"hooks.cjs","names":[],"sources":["../src/hooks/useDriver.ts","../src/hooks/useMode.ts","../src/hooks/usePlugin.ts"],"sourcesContent":["import { useFabric } from '@kubb/react-fabric'\nimport type { PluginDriver } from '../PluginDriver.ts'\n\n/**\n * @deprecated use `driver` from the generator component props instead\n */\nexport function useDriver(): PluginDriver {\n  const { meta } = useFabric<{ driver: PluginDriver }>()\n\n  return meta.driver\n}\n","import type { FabricFile } from '@kubb/fabric-core/types'\nimport { useFabric } from '@kubb/react-fabric'\n\n/**\n * @deprecated use `mode` from the generator component props instead\n */\nexport function useMode(): FabricFile.Mode {\n  const { meta } = useFabric<{ mode: FabricFile.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 `plugin` from the generator component props 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"],"mappings":";;;;;;;AAMA,SAAgB,YAA0B;CACxC,MAAM,EAAE,UAAA,GAAA,mBAAA,YAA8C;AAEtD,QAAO,KAAK;;;;;;;ACHd,SAAgB,UAA2B;CACzC,MAAM,EAAE,UAAA,GAAA,mBAAA,YAA+C;AAEvD,QAAO,KAAK;;;;;;;ACHd,SAAgB,YAA4F;CAC1G,MAAM,EAAE,UAAA,GAAA,mBAAA,YAAkD;AAE1D,QAAO,KAAK"}

package/dist/hooks.d.ts

@@ -1,12 +1,10 @@
 import { t as __name } from "./chunk--u3MIqq1.js";
-import { C as PluginFactoryOptions, t as PluginDriver, x as Plugin } from "./PluginDriver-DZdEyCoa.js";
+import { S as PluginFactoryOptions, b as Plugin, t as PluginDriver } from "./PluginDriver-P920mak9.js";
 import { FabricFile } from "@kubb/fabric-core/types";
 
 //#region src/hooks/useDriver.d.ts
 /**
- * Returns the `PluginDriver` instance from Fabric context.
- *
- * Use this inside React generator components to access the driver, config, and adapter.
+ * @deprecated use `driver` from the generator component props instead
  */
 declare function useDriver(): PluginDriver;
 //#endregion

package/dist/hooks.js

@@ -2,9 +2,7 @@ import "./chunk--u3MIqq1.js";
 import { useFabric } from "@kubb/react-fabric";
 //#region src/hooks/useDriver.ts
 /**
-* Returns the `PluginDriver` instance from Fabric context.
-*
-* Use this inside React generator components to access the driver, config, and adapter.
+* @deprecated use `driver` from the generator component props instead
 */
 function useDriver() {
 	const { meta } = useFabric();

package/dist/hooks.js.map

@@ -1 +1 @@
-{"version":3,"file":"hooks.js","names":[],"sources":["../src/hooks/useDriver.ts","../src/hooks/useMode.ts","../src/hooks/usePlugin.ts"],"sourcesContent":["import { useFabric } from '@kubb/react-fabric'\nimport type { PluginDriver } from '../PluginDriver.ts'\n\n/**\n * Returns the `PluginDriver` instance from Fabric context.\n *\n * Use this inside React generator components to access the driver, config, and adapter.\n */\nexport function useDriver(): PluginDriver {\n  const { meta } = useFabric<{ driver: PluginDriver }>()\n\n  return meta.driver\n}\n","import type { FabricFile } from '@kubb/fabric-core/types'\nimport { useFabric } from '@kubb/react-fabric'\n\n/**\n * @deprecated use `mode` from the generator component props instead\n */\nexport function useMode(): FabricFile.Mode {\n  const { meta } = useFabric<{ mode: FabricFile.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 `plugin` from the generator component props 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"],"mappings":";;;;;;;;AAQA,SAAgB,YAA0B;CACxC,MAAM,EAAE,SAAS,WAAqC;AAEtD,QAAO,KAAK;;;;;;;ACLd,SAAgB,UAA2B;CACzC,MAAM,EAAE,SAAS,WAAsC;AAEvD,QAAO,KAAK;;;;;;;ACHd,SAAgB,YAA4F;CAC1G,MAAM,EAAE,SAAS,WAAyC;AAE1D,QAAO,KAAK"}
+{"version":3,"file":"hooks.js","names":[],"sources":["../src/hooks/useDriver.ts","../src/hooks/useMode.ts","../src/hooks/usePlugin.ts"],"sourcesContent":["import { useFabric } from '@kubb/react-fabric'\nimport type { PluginDriver } from '../PluginDriver.ts'\n\n/**\n * @deprecated use `driver` from the generator component props instead\n */\nexport function useDriver(): PluginDriver {\n  const { meta } = useFabric<{ driver: PluginDriver }>()\n\n  return meta.driver\n}\n","import type { FabricFile } from '@kubb/fabric-core/types'\nimport { useFabric } from '@kubb/react-fabric'\n\n/**\n * @deprecated use `mode` from the generator component props instead\n */\nexport function useMode(): FabricFile.Mode {\n  const { meta } = useFabric<{ mode: FabricFile.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 `plugin` from the generator component props 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"],"mappings":";;;;;;AAMA,SAAgB,YAA0B;CACxC,MAAM,EAAE,SAAS,WAAqC;AAEtD,QAAO,KAAK;;;;;;;ACHd,SAAgB,UAA2B;CACzC,MAAM,EAAE,SAAS,WAAsC;AAEvD,QAAO,KAAK;;;;;;;ACHd,SAAgB,YAA4F;CAC1G,MAAM,EAAE,SAAS,WAAyC;AAE1D,QAAO,KAAK"}