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

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

@@ -1,6 +1,6 @@
 import { t as __name } from "./chunk--u3MIqq1.js";
 import { Node, OperationNode, Printer, PrinterFactoryOptions, RootNode, SchemaNode, Visitor } from "@kubb/ast/types";
-import { Fabric, KubbFile } from "@kubb/fabric-core/types";
+import { Fabric, FabricFile } from "@kubb/fabric-core/types";
 import { HttpMethod } from "@kubb/oas";
 import { FabricReactNode } from "@kubb/react-fabric/types";
 
@@ -242,14 +242,20 @@ type SchemaV2Props<TPlugin extends PluginFactoryOptions = PluginFactoryOptions>
   options: Plugin<TPlugin>['options'];
   node: SchemaNode;
 };
+/**
+ * Input shape for a core v2 async generator — lifecycle methods are optional.
+ */
 type UserCoreGeneratorV2<TPlugin extends PluginFactoryOptions> = {
   name: string;
   type: 'core';
   version?: '2';
-  operations?(props: OperationsV2Props<TPlugin>): Promise<Array<KubbFile.File>>;
-  operation?(props: OperationV2Props<TPlugin>): Promise<Array<KubbFile.File>>;
-  schema?(props: SchemaV2Props<TPlugin>): Promise<Array<KubbFile.File>>;
+  operations?(props: OperationsV2Props<TPlugin>): Promise<Array<FabricFile.File>>;
+  operation?(props: OperationV2Props<TPlugin>): Promise<Array<FabricFile.File>>;
+  schema?(props: SchemaV2Props<TPlugin>): Promise<Array<FabricFile.File>>;
 };
+/**
+ * Input shape for a React v2 generator — component methods are optional.
+ */
 type UserReactGeneratorV2<TPlugin extends PluginFactoryOptions> = {
   name: string;
   type: 'react';
@@ -258,14 +264,20 @@ type UserReactGeneratorV2<TPlugin extends PluginFactoryOptions> = {
   Operation?(props: OperationV2Props<TPlugin>): FabricReactNode;
   Schema?(props: SchemaV2Props<TPlugin>): FabricReactNode;
 };
+/**
+ * A fully resolved core v2 generator with `version: '2'` and guaranteed async lifecycle methods.
+ */
 type CoreGeneratorV2<TPlugin extends PluginFactoryOptions = PluginFactoryOptions> = {
   name: string;
   type: 'core';
   version: '2';
-  operations(props: OperationsV2Props<TPlugin>): Promise<Array<KubbFile.File>>;
-  operation(props: OperationV2Props<TPlugin>): Promise<Array<KubbFile.File>>;
-  schema(props: SchemaV2Props<TPlugin>): Promise<Array<KubbFile.File>>;
+  operations(props: OperationsV2Props<TPlugin>): Promise<Array<FabricFile.File>>;
+  operation(props: OperationV2Props<TPlugin>): Promise<Array<FabricFile.File>>;
+  schema(props: SchemaV2Props<TPlugin>): Promise<Array<FabricFile.File>>;
 };
+/**
+ * A fully resolved React v2 generator with `version: '2'` and guaranteed component methods.
+ */
 type ReactGeneratorV2<TPlugin extends PluginFactoryOptions = PluginFactoryOptions> = {
   name: string;
   type: 'react';
@@ -274,6 +286,9 @@ type ReactGeneratorV2<TPlugin extends PluginFactoryOptions = PluginFactoryOption
   Operation(props: OperationV2Props<TPlugin>): FabricReactNode;
   Schema(props: SchemaV2Props<TPlugin>): FabricReactNode;
 };
+/**
+ * Union of all v2 generator shapes accepted by the plugin system.
+ */
 type Generator<TPlugin extends PluginFactoryOptions = PluginFactoryOptions> = UserCoreGeneratorV2<TPlugin> | UserReactGeneratorV2<TPlugin>;
 /**
  * Defines a generator with no-op defaults for any omitted lifecycle methods.
@@ -368,7 +383,7 @@ 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<FabricFile.ResolvedFile>, sources: Map<FabricFile.Path, string>];
   /**
    * Emitted with a summary of the generation results.
    * Contains summary lines, title, and success status.
@@ -455,7 +470,7 @@ interface KubbEvents {
    * Emitted when file processing starts.
    * Contains the list of files to be processed.
    */
-  'files:processing:start': [files: Array<KubbFile.ResolvedFile>];
+  'files:processing:start': [files: Array<FabricFile.ResolvedFile>];
   /**
    * Emitted for each file being processed, providing progress updates.
    * Contains processed count, total count, percentage, and file details.
@@ -480,7 +495,7 @@ interface KubbEvents {
     /**
      * The file being processed.
      */
-    file: KubbFile.ResolvedFile;
+    file: FabricFile.ResolvedFile;
     /**
      * Kubb configuration (not present in Fabric).
      * Provides access to the current config during file processing.
@@ -491,7 +506,7 @@ interface KubbEvents {
    * Emitted when file processing completes.
    * Contains the list of processed files.
    */
-  'files:processing:end': [files: Array<KubbFile.ResolvedFile>];
+  'files:processing:end': [files: Array<FabricFile.ResolvedFile>];
   /**
    * Emitted when a plugin starts executing.
    */
@@ -635,7 +650,7 @@ type Adapter<TOptions extends AdapterFactoryOptions = AdapterFactoryOptions> = {
    */
   parse: (source: AdapterSource) => PossiblePromise<RootNode>;
   /**
-   * Extracts `KubbFile.Import` entries needed by a `SchemaNode` tree.
+   * Extracts `FabricFile.Import` entries needed by a `SchemaNode` tree.
    * Populated after the first `parse()` call. Returns an empty array before that.
    *
    * The `resolve` callback receives the collision-corrected schema name and must
@@ -644,7 +659,7 @@ type Adapter<TOptions extends AdapterFactoryOptions = AdapterFactoryOptions> = {
   getImports: (node: SchemaNode, resolve: (schemaName: string) => {
     name: string;
     path: string;
-  }) => Array<KubbFile.Import>;
+  }) => Array<FabricFile.Import>;
 };
 type BarrelType = 'all' | 'named' | 'propagate';
 type DevtoolsOptions = {
@@ -743,7 +758,7 @@ type Config<TInput = Input> = {
      * Overrides the extension for generated imports and exports. By default, each plugin adds an extension.
      * @default { '.ts': '.ts'}
      */
-    extension?: Record<KubbFile.Extname, KubbFile.Extname | ''>;
+    extension?: Record<FabricFile.Extname, FabricFile.Extname | ''>;
     /**
      * Configures how `index.ts` files are created, including disabling barrel file generation. Each plugin has its own `barrelType` option; this setting controls the root barrel file (e.g., `src/gen/index.ts`).
      * @default 'named'
@@ -792,13 +807,23 @@ type Config<TInput = Input> = {
     done?: string | Array<string>;
   };
 };
+/**
+ * A type/string-pattern filter used for `include`, `exclude`, and `override` matching.
+ */
 type PatternFilter = {
   type: string;
   pattern: string | RegExp;
 };
+/**
+ * A pattern filter paired with partial option overrides to apply when the pattern matches.
+ */
 type PatternOverride<TOptions> = PatternFilter & {
   options: Omit<Partial<TOptions>, 'override'>;
 };
+/**
+ * Context passed to `resolver.resolveOptions` to apply include/exclude/override filtering
+ * for a given operation or schema node.
+ */
 type ResolveOptionsContext<TOptions> = {
   options: TOptions;
   exclude?: Array<PatternFilter>;
@@ -825,8 +850,8 @@ type Resolver = {
   pluginName: Plugin['name'];
   default(name: ResolveNameParams['name'], type?: ResolveNameParams['type']): string;
   resolveOptions<TOptions>(node: Node, context: ResolveOptionsContext<TOptions>): TOptions | null;
-  resolvePath(params: ResolverPathParams, context: ResolverContext): KubbFile.Path;
-  resolveFile(params: ResolverFileParams, context: ResolverContext): KubbFile.File;
+  resolvePath(params: ResolverPathParams, context: ResolverContext): FabricFile.Path;
+  resolveFile(params: ResolverFileParams, context: ResolverContext): FabricFile.File;
   resolveBanner(node: RootNode | null, context: ResolveBannerContext): string | undefined;
   resolveFooter(node: RootNode | null, context: ResolveBannerContext): string | undefined;
 };
@@ -955,7 +980,7 @@ type PluginLifecycle<TOptions extends PluginFactoryOptions = PluginFactoryOption
    * @example ('./Pet.ts', './src/gen/') => '/src/gen/Pet.ts'
    * @deprecated this will be replaced by resolvers
    */
-  resolvePath?: (this: PluginContext<TOptions>, baseName: KubbFile.BaseName, mode?: KubbFile.Mode, options?: TOptions['resolvePathOptions']) => KubbFile.Path;
+  resolvePath?: (this: PluginContext<TOptions>, baseName: FabricFile.BaseName, mode?: FabricFile.Mode, options?: TOptions['resolvePathOptions']) => FabricFile.Path;
   /**
    * Resolve to a name based on a string.
    * Useful when converting to PascalCase or camelCase.
@@ -969,8 +994,8 @@ type PluginLifecycleHooks = keyof PluginLifecycle;
 type PluginParameter<H extends PluginLifecycleHooks> = Parameters<Required<PluginLifecycle>[H]>;
 type ResolvePathParams<TOptions = object> = {
   pluginName?: string;
-  baseName: KubbFile.BaseName;
-  mode?: KubbFile.Mode;
+  baseName: FabricFile.BaseName;
+  mode?: FabricFile.Mode;
   /**
    * Options to be passed to 'resolvePath' 3th parameter
    */
@@ -996,13 +1021,13 @@ type PluginContext<TOptions extends PluginFactoryOptions = PluginFactoryOptions>
   /**
    * Only add when the file does not exist yet
    */
-  addFile: (...file: Array<KubbFile.File>) => Promise<void>;
+  addFile: (...file: Array<FabricFile.File>) => Promise<void>;
   /**
    * merging multiple sources into the same output file
    */
-  upsertFile: (...file: Array<KubbFile.File>) => Promise<void>;
+  upsertFile: (...file: Array<FabricFile.File>) => Promise<void>;
   events: AsyncEventEmitter<KubbEvents>;
-  mode: KubbFile.Mode;
+  mode: FabricFile.Mode;
   /**
    * Current plugin
    */
@@ -1175,8 +1200,8 @@ type ResolvePathOptions = {
  * ```
  */
 type ResolverPathParams = {
-  baseName: KubbFile.BaseName;
-  pathMode?: KubbFile.Mode;
+  baseName: FabricFile.BaseName;
+  pathMode?: FabricFile.Mode;
   /**
    * Tag value used when `group.type === 'tag'`.
    */
@@ -1204,7 +1229,10 @@ type ResolverPathParams = {
 type ResolverContext = {
   root: string;
   output: Output;
-  group?: Group; /** Plugin name used to populate `meta.pluginName` on the resolved file. */
+  group?: Group;
+  /**
+   * Plugin name used to populate `meta.pluginName` on the resolved file.
+   */
   pluginName?: string;
 };
 /**
@@ -1224,8 +1252,14 @@ type ResolverContext = {
  */
 type ResolverFileParams = {
   name: string;
-  extname: KubbFile.Extname; /** Tag value used when `group.type === 'tag'`. */
-  tag?: string; /** Path value used when `group.type === 'path'`. */
+  extname: FabricFile.Extname;
+  /**
+   * Tag value used when `group.type === 'tag'`.
+   */
+  tag?: string;
+  /**
+   * Path value used when `group.type === 'path'`.
+   */
   path?: string;
 };
 /**
@@ -1247,6 +1281,14 @@ type ResolveBannerContext = {
 //#endregion
 //#region src/PluginDriver.d.ts
 type RequiredPluginLifecycle = Required<PluginLifecycle>;
+/**
+ * Hook dispatch strategy used by the `PluginDriver`.
+ *
+ * - `hookFirst` — stops at the first non-null result.
+ * - `hookForPlugin` — calls only the matching plugin.
+ * - `hookParallel` — calls all plugins concurrently.
+ * - `hookSeq` — calls all plugins in order, threading the result.
+ */
 type Strategy = 'hookFirst' | 'hookForPlugin' | 'hookParallel' | 'hookSeq';
 type ParseResult<H extends PluginLifecycleHooks> = RequiredPluginLifecycle[H];
 type SafeParseResult<H extends PluginLifecycleHooks, Result = ReturnType<ParseResult<H>>> = {
@@ -1261,14 +1303,26 @@ type Options = {
    */
   concurrency?: number;
 };
+/**
+ * Parameters accepted by `PluginDriver.getFile` to resolve a generated file descriptor.
+ */
 type GetFileOptions<TOptions = object> = {
   name: string;
-  mode?: KubbFile.Mode;
-  extname: KubbFile.Extname;
+  mode?: FabricFile.Mode;
+  extname: FabricFile.Extname;
   pluginName: string;
   options?: TOptions;
 };
-declare function getMode(fileOrFolder: string | undefined | null): KubbFile.Mode;
+/**
+ * Returns `'single'` when `fileOrFolder` has a file extension, `'split'` otherwise.
+ *
+ * @example
+ * ```ts
+ * getMode('src/gen/types.ts')  // 'single'
+ * getMode('src/gen/types')     // 'split'
+ * ```
+ */
+declare function getMode(fileOrFolder: string | undefined | null): FabricFile.Mode;
 declare class PluginDriver {
   #private;
   readonly config: Config;
@@ -1289,10 +1343,10 @@ declare class PluginDriver {
     extname,
     pluginName,
     options
-  }: GetFileOptions<TOptions>): KubbFile.File<{
+  }: GetFileOptions<TOptions>): FabricFile.File<{
     pluginName: string;
   }>;
-  resolvePath: <TOptions = object>(params: ResolvePathParams<TOptions>) => KubbFile.Path;
+  resolvePath: <TOptions = object>(params: ResolvePathParams<TOptions>) => FabricFile.Path;
   resolveName: (params: ResolveNameParams) => string;
   /**
    * Run a specific hookName for plugin x.
@@ -1367,4 +1421,4 @@ declare class PluginDriver {
 }
 //#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-CEQPafXV.d.ts.map
+//# sourceMappingURL=PluginDriver-DZdEyCoa.d.ts.map

package/dist/hooks.cjs

@@ -2,6 +2,11 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 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.
+*/
 function useDriver() {
 	const { meta } = (0, _kubb_react_fabric.useFabric)();
 	return meta.driver;

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\nexport function useDriver(): PluginDriver {\n  const { meta } = useFabric<{ driver: PluginDriver }>()\n\n  return meta.driver\n}\n","import type { KubbFile } 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(): 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 `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":";;;;AAGA,SAAgB,YAA0B;CACxC,MAAM,EAAE,UAAA,GAAA,mBAAA,YAA8C;AAEtD,QAAO,KAAK;;;;;;;ACAd,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"}
+{"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"}

package/dist/hooks.d.ts

@@ -1,15 +1,20 @@
 import { t as __name } from "./chunk--u3MIqq1.js";
-import { C as PluginFactoryOptions, t as PluginDriver, x as Plugin } from "./PluginDriver-CEQPafXV.js";
-import { KubbFile } from "@kubb/fabric-core/types";
+import { C as PluginFactoryOptions, t as PluginDriver, x as Plugin } from "./PluginDriver-DZdEyCoa.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.
+ */
 declare function useDriver(): PluginDriver;
 //#endregion
 //#region src/hooks/useMode.d.ts
 /**
  * @deprecated use `mode` from the generator component props instead
  */
-declare function useMode(): KubbFile.Mode;
+declare function useMode(): FabricFile.Mode;
 //#endregion
 //#region src/hooks/usePlugin.d.ts
 /**

package/dist/hooks.js

@@ -1,6 +1,11 @@
 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.
+*/
 function useDriver() {
 	const { meta } = useFabric();
 	return meta.driver;

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\nexport function useDriver(): PluginDriver {\n  const { meta } = useFabric<{ driver: PluginDriver }>()\n\n  return meta.driver\n}\n","import type { KubbFile } 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(): 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 `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":";;;AAGA,SAAgB,YAA0B;CACxC,MAAM,EAAE,SAAS,WAAqC;AAEtD,QAAO,KAAK;;;;;;;ACAd,SAAgB,UAAyB;CACvC,MAAM,EAAE,SAAS,WAAoC;AAErD,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 * 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"}

package/dist/index.cjs

@@ -971,6 +971,15 @@ function hookParallel(promises, concurrency = Number.POSITIVE_INFINITY) {
 }
 //#endregion
 //#region src/PluginDriver.ts
+/**
+* Returns `'single'` when `fileOrFolder` has a file extension, `'split'` otherwise.
+*
+* @example
+* ```ts
+* getMode('src/gen/types.ts')  // 'single'
+* getMode('src/gen/types')     // 'split'
+* ```
+*/
 function getMode(fileOrFolder) {
 	if (!fileOrFolder) return "split";
 	return (0, node_path.extname)(fileOrFolder) ? "single" : "split";
@@ -1469,7 +1478,7 @@ const fsStorage = createStorage(() => ({
 }));
 //#endregion
 //#region package.json
-var version = "5.0.0-alpha.21";
+var version = "5.0.0-alpha.22";
 //#endregion
 //#region src/utils/diagnostics.ts
 /**
@@ -2110,7 +2119,7 @@ function defaultResolvePath({ baseName, pathMode, tag, path: groupPath }, { root
 /**
 * Default file resolver used by `defineResolver`.
 *
-* Resolves a `KubbFile.File` by combining name resolution (`resolver.default`) with
+* Resolves a `FabricFile.File` by combining name resolution (`resolver.default`) with
 * path resolution (`resolver.resolvePath`). The resolved file always has empty
 * `sources`, `imports`, and `exports` arrays — consumers populate those separately.
 *
@@ -2246,7 +2255,7 @@ function defaultResolveFooter(node, { output }) {
 * - `default` — name casing strategy (camelCase / PascalCase)
 * - `resolveOptions` — include/exclude/override filtering
 * - `resolvePath` — output path computation
-* - `resolveFile` — full `KubbFile.File` construction
+* - `resolveFile` — full `FabricFile.File` construction
 *
 * Methods in the builder have access to `this` (the full resolver object), so they
 * can call other resolver methods without circular imports.
@@ -2533,7 +2542,7 @@ async function detectFormatter() {
 //#region src/utils/TreeNode.ts
 /**
 * Tree structure used to build per-directory barrel (`index.ts`) files from a
-* flat list of generated {@link KubbFile.File} entries.
+* flat list of generated {@link FabricFile.File} entries.
 *
 * Each node represents either a directory or a file within the output tree.
 * Use {@link TreeNode.build} to construct a root node from a file list, then
@@ -2575,24 +2584,39 @@ var TreeNode = class TreeNode {
 		this.#cachedLeaves = leaves;
 		return leaves;
 	}
+	/**
+	* Visits this node and every descendant in depth-first order.
+	*/
 	forEach(callback) {
 		if (typeof callback !== "function") throw new TypeError("forEach() callback must be a function");
 		callback(this);
 		for (const child of this.children) child.forEach(callback);
 		return this;
 	}
+	/**
+	* Finds the first leaf that satisfies `predicate`, or `undefined` when none match.
+	*/
 	findDeep(predicate) {
 		if (typeof predicate !== "function") throw new TypeError("find() predicate must be a function");
 		return this.leaves.find(predicate);
 	}
+	/**
+	* Calls `callback` for every leaf of this node.
+	*/
 	forEachDeep(callback) {
 		if (typeof callback !== "function") throw new TypeError("forEach() callback must be a function");
 		this.leaves.forEach(callback);
 	}
+	/**
+	* Returns all leaves that satisfy `callback`.
+	*/
 	filterDeep(callback) {
 		if (typeof callback !== "function") throw new TypeError("filter() callback must be a function");
 		return this.leaves.filter(callback);
 	}
+	/**
+	* Maps every leaf through `callback` and returns the resulting array.
+	*/
 	mapDeep(callback) {
 		if (typeof callback !== "function") throw new TypeError("map() callback must be a function");
 		return this.leaves.map(callback);
@@ -2765,7 +2789,15 @@ async function getConfigs(config, args) {
 //#endregion
 //#region src/utils/mergeResolvers.ts
 /**
-* Merges an array of resolvers into a single resolver. Later entries override earlier ones (last wins).
+* Merges an ordered list of resolvers into a single resolver by shallow-merging each entry left to right.
+*
+* Later entries win when keys conflict, so the last resolver in the list takes highest precedence.
+*
+* @example
+* ```ts
+* const resolver = mergeResolvers(resolverTs, resolverTsLegacy)
+* // resolverTsLegacy methods override resolverTs where they overlap
+* ```
 */
 function mergeResolvers(...resolvers) {
 	return resolvers.reduce((acc, curr) => ({