@kubb/plugin-oas 4.18.4 → 4.19.0

package/dist/{SchemaMapper-CIs2VKvf.d.cts → SchemaMapper-DmB5NyNo.d.cts}

@@ -307,7 +307,7 @@ type Config<TInput = Input> = {
   input: TInput;
   output: {
     /**
-     * The path where all generated files will be exported.
+     * The path where all generated files receives exported.
      * This can be an absolute path or a path relative to the specified root option.
      */
     path: string;
@@ -322,41 +322,39 @@ type Config<TInput = Input> = {
     write?: boolean;
     /**
      * Specifies the formatting tool to be used.
-     * @default prettier
-     *
-     * Possible values:
-     * - 'auto': Automatically detects and uses biome or prettier (in that order of preference).
-     * - 'prettier': Uses Prettier for code formatting.
-     * - 'biome': Uses Biome for code formatting.
-     *
+     * - 'auto' automatically detects and uses biome or prettier (in that order of preference).
+     * - 'prettier' uses Prettier for code formatting.
+     * - 'biome' uses Biome for code formatting.
+     * - 'oxfmt' uses Oxfmt for code formatting.
+     * - false disables code formatting.
+     * @default 'prettier'
      */
     format?: 'auto' | 'prettier' | 'biome' | 'oxfmt' | false;
     /**
      * Specifies the linter that should be used to analyze the code.
-     * The accepted values indicate different linting tools.
-     *
-     * Possible values:
-     * - 'auto': Automatically detects and uses biome, oxlint, or eslint (in that order of preference).
-     * - 'eslint': Represents the use of ESLint, a widely used JavaScript linter.
-     * - 'biome': Represents the Biome linter, a modern tool for code scanning.
-     * - 'oxlint': Represents the Oxlint tool for linting purposes.
-     *
+     * - 'auto' automatically detects and uses biome, oxlint, or eslint (in that order of preference).
+     * - 'eslint' uses ESLint for linting.
+     * - 'biome' uses Biome for linting.
+     * - 'oxlint' uses Oxlint for linting.
+     * - false disables linting.
+     * @default 'auto'
      */
     lint?: 'auto' | 'eslint' | 'biome' | 'oxlint' | false;
     /**
-     * Override the extension to the generated imports and exports, by default each plugin will add an extension
+     * Overrides the extension for generated imports and exports. By default, each plugin adds an extension.
      * @default { '.ts': '.ts'}
      */
     extension?: Record<KubbFile.Extname, KubbFile.Extname | ''>;
     /**
-     * Specify how `index.ts` files should be created. You can also disable the generation of barrel files here. While each plugin has its own `barrelType` option, this setting controls the creation of the root barrel file, such as` src/gen/index.ts`.
+     * 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'
      */
     barrelType?: Exclude<BarrelType, 'propagate'> | false;
     /**
-     * Add a default banner to the beginning of every generated file. This makes it clear that the file was generated by Kubb.
-     * - 'simple': will only add banner with link to Kubb
-     * - 'full': will add source, title, description and the OpenAPI version used
+     * Adds a default banner to the start of every generated file indicating it was generated by Kubb.
+     * - 'simple' adds banner with link to Kubb.
+     * - 'full' adds source, title, description, and OpenAPI version.
+     * - false disables banner generation.
      * @default 'simple'
      */
     defaultBanner?: 'simple' | 'full' | false;
@@ -369,17 +367,17 @@ type Config<TInput = Input> = {
     override?: boolean;
   };
   /**
-   * An array of Kubb plugins that will be used in the generation.
+   * An array of Kubb plugins that used in the generation.
    * Each plugin may include additional configurable options(defined in the plugin itself).
-   * If a plugin depends on another plugin, an error will be returned if the required dependency is missing. See pre for more details.
+   * 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>;
   /**
-   * Hooks that will be called when a specific action is triggered in Kubb.
+   * Hooks triggered when a specific action occurs in Kubb.
    */
   hooks?: {
     /**
-     * Hook that will be triggered at the end of all executions.
+     * Hook that triggers at the end of all executions.
      * Useful for running Prettier or ESLint to format/lint your code.
      */
     done?: string | Array<string>;
@@ -408,7 +406,7 @@ TContext = any,
 TResolvePathOptions extends object = object> = {
   name: TName;
   /**
-   * Same behaviour like what has been done with `QueryKey` in `@tanstack/react-query`
+   * Same behavior like what has been done with `QueryKey` in `@tanstack/react-query`
    */
   key: PluginKey<TName | string>;
   options: TOptions;
@@ -429,12 +427,12 @@ type UserPlugin<TOptions extends PluginFactoryOptions = PluginFactoryOptions> =
    */
   options: TOptions['resolvedOptions'];
   /**
-   * Specifies the preceding plugins for the current plugin. You can pass an array of preceding plugin names, and the current plugin will be executed after these plugins.
+   * 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.
    */
   pre?: Array<string>;
   /**
-   * Specifies the succeeding plugins for the current plugin. You can pass an array of succeeding plugin names, and the current plugin will be executed before these plugins.
+   * Specifies the succeeding plugins for the current plugin. You can pass an array of succeeding plugin names, and the current plugin is executed before these plugins.
    */
   post?: Array<string>;
   inject?: (this: PluginContext<TOptions>, context: PluginContext<TOptions>) => TOptions['context'];
@@ -452,12 +450,12 @@ type Plugin<TOptions extends PluginFactoryOptions = PluginFactoryOptions> = {
    */
   key: TOptions['key'];
   /**
-   * Specifies the preceding plugins for the current plugin. You can pass an array of preceding plugin names, and the current plugin will be executed after these plugins.
+   * 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.
    */
   pre?: Array<string>;
   /**
-   * Specifies the succeeding plugins for the current plugin. You can pass an array of succeeding plugin names, and the current plugin will be executed before these plugins.
+   * Specifies the succeeding plugins for the current plugin. You can pass an array of succeeding plugin names, and the current plugin is executed before these plugins.
    */
   post?: Array<string>;
   /**
@@ -507,10 +505,12 @@ type ResolveNameParams = {
   name: string;
   pluginKey?: Plugin['key'];
   /**
-   * `file` will be used to customize the name of the created file(use of camelCase)
-   * `function` can be used to customize the exported functions(use of camelCase)
-   * `type` is a special type for TypeScript(use of PascalCase)
-   * `const` can be used for variables(use of camelCase)
+   * Specifies the type of entity being named.
+   * - 'file' customizes the name of the created file (uses camelCase).
+   * - 'function' customizes the exported function names (uses camelCase).
+   * - 'type' customizes TypeScript types (uses PascalCase).
+   * - 'const' customizes variable names (uses camelCase).
+   * @default undefined
    */
   type?: 'file' | 'function' | 'type' | 'const';
 };
@@ -565,11 +565,14 @@ type GroupContext = {
 };
 type Group = {
   /**
-   * Define a type where to group the files on
+   * 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 will be used for the file and name generation
+   * Return the name of a group based on the group name, this used for the file and name generation
    */
   name?: (context: GroupContext) => string;
 };
@@ -582,7 +585,7 @@ type SafeParseResult<H extends PluginLifecycleHooks, Result = ReturnType<ParseRe
   result: Result;
   plugin: Plugin;
 };
-type Options$1 = {
+type Options = {
   fabric: Fabric;
   events: AsyncEventEmitter<KubbEvents>;
   /**
@@ -600,8 +603,8 @@ type GetFileProps<TOptions = object> = {
 declare class PluginManager {
   #private;
   readonly config: Config;
-  readonly options: Options$1;
-  constructor(config: Config, options: Options$1);
+  readonly options: Options;
+  constructor(config: Config, options: Options);
   get events(): AsyncEventEmitter<KubbEvents>;
   getContext<TOptions extends PluginFactoryOptions>(plugin: Plugin<TOptions>): PluginContext<TOptions> & Record<string, any>;
   get plugins(): Array<Plugin>;
@@ -641,7 +644,7 @@ declare class PluginManager {
     parameters: PluginParameter<H>;
   }): Array<ReturnType<ParseResult<H>>> | null;
   /**
-   * First non-null result stops and will return it's value.
+   * Returns the first non-null result.
    */
   hookFirst<H extends PluginLifecycleHooks>({
     hookName,
@@ -653,7 +656,7 @@ declare class PluginManager {
     skipped?: ReadonlySet<Plugin> | null;
   }): Promise<SafeParseResult<H>>;
   /**
-   * First non-null result stops and will return it's value.
+   * Returns the first non-null result.
    */
   hookFirstSync<H extends PluginLifecycleHooks>({
     hookName,
@@ -665,15 +668,15 @@ declare class PluginManager {
     skipped?: ReadonlySet<Plugin> | null;
   }): SafeParseResult<H>;
   /**
-   * Run all plugins in parallel(order will be based on `this.plugin` and if `pre` or `post` is set).
+   * Runs all plugins in parallel based on `this.plugin` order and `pre`/`post` settings.
    */
-  hookParallel<H extends PluginLifecycleHooks, TOuput = void>({
+  hookParallel<H extends PluginLifecycleHooks, TOutput = void>({
     hookName,
     parameters
   }: {
     hookName: H;
     parameters?: Parameters<RequiredPluginLifecycle[H]> | undefined;
-  }): Promise<Awaited<TOuput>[]>;
+  }): Promise<Awaited<TOutput>[]>;
   /**
    * Chains plugins
    */
@@ -705,16 +708,21 @@ type Operation$1 = Operation;
 type DiscriminatorObject$1 = DiscriminatorObject;
 //#endregion
 //#region ../oas/src/Oas.d.ts
-type Options = {
+type OasOptions = {
   contentType?: contentType;
   discriminator?: 'strict' | 'inherit';
+  /**
+   * Resolve name collisions when schemas from different components share the same name (case-insensitive).
+   * @default false
+   */
+  collisionDetection?: boolean;
 };
 declare class Oas extends BaseOas {
   #private;
   document: Document;
   constructor(document: Document);
-  setOptions(options: Options): void;
-  get options(): Options;
+  setOptions(options: OasOptions): void;
+  get options(): OasOptions;
   get<T = unknown>($ref: string): T | null;
   getKey($ref: string): string | undefined;
   set($ref: string, value: unknown): false | undefined;
@@ -723,8 +731,20 @@ declare class Oas extends BaseOas {
   getResponseSchema(operation: Operation$1, statusCode: string | number): SchemaObject$1;
   getRequestSchema(operation: Operation$1): SchemaObject$1 | undefined;
   getParametersSchema(operation: Operation$1, inKey: 'path' | 'query' | 'header'): SchemaObject$1 | null;
-  valdiate(): Promise<oas_normalize_lib_types0.ValidationResult>;
+  validate(): Promise<oas_normalize_lib_types0.ValidationResult>;
   flattenSchema(schema: SchemaObject$1 | null): SchemaObject$1 | null;
+  /**
+   * Get schemas from OpenAPI components (schemas, responses, requestBodies).
+   * Returns schemas in dependency order along with name mapping for collision resolution.
+   */
+  getSchemas(options?: {
+    contentType?: contentType;
+    includes?: Array<'schemas' | 'responses' | 'requestBodies'>;
+    collisionDetection?: boolean;
+  }): {
+    schemas: Record<string, SchemaObject$1>;
+    nameMapping: Map<string, string>;
+  };
 }
 //#endregion
 //#region ../oas/src/utils.d.ts
@@ -846,8 +866,8 @@ type SchemaKeywordMapper = {
        */
       path: KubbFile.Path;
       /**
-       * When true `File.Import` will be used.
-       * When false a reference will be used inside the current file.
+       * When true `File.Import` is used.
+       * When false a reference is used inside the current file.
        */
       isImportable: boolean;
     };
@@ -1007,11 +1027,11 @@ type SchemaTree = {
   current: Schema;
   siblings: Schema[];
   /**
-   * this will be equal to the key of a property(object)
+   * this is equal to the key of a property(object)
    */
   name?: string;
 };
 declare function isKeyword<T extends Schema, K extends keyof SchemaKeywordMapper>(meta: T, keyword: K): meta is Extract<T, SchemaKeywordMapper[K]>;
 //#endregion
 export { __name as A, Plugin as C, AsyncEventEmitter as D, UserPluginWithLifeCycle as E, KubbEvents as O, Output as S, ResolveNameParams as T, contentType as _, SchemaMapper as a, Config as b, schemaKeywords as c, HttpMethod as d, OasTypes as f, SchemaObject$1 as g, Operation$1 as h, SchemaKeywordMapper as i, BaseGenerator as k, isOptional as l, OpenAPIV3_1 as m, SchemaKeyword as n, SchemaTree as o, OpenAPIV3 as p, SchemaKeywordBase as r, isKeyword as s, Schema as t, Oas as u, FileMetaBase as v, PluginFactoryOptions as w, Group as x, PluginManager as y };
-//# sourceMappingURL=SchemaMapper-CIs2VKvf.d.cts.map
+//# sourceMappingURL=SchemaMapper-DmB5NyNo.d.cts.map

package/dist/{createGenerator-Cj-sXgmn.d.cts → createGenerator-BF26dp_h.d.cts}

@@ -1,4 +1,4 @@
-import { A as __name, C as Plugin, D as AsyncEventEmitter, O as KubbEvents, S as Output, T as ResolveNameParams, _ as contentType, b as Config, d as HttpMethod, g as SchemaObject, h as Operation, i as SchemaKeywordMapper, k as BaseGenerator, t as Schema, u as Oas, v as FileMetaBase, w as PluginFactoryOptions, x as Group, y as PluginManager } from "./SchemaMapper-CIs2VKvf.cjs";
+import { A as __name, C as Plugin, D as AsyncEventEmitter, O as KubbEvents, S as Output, T as ResolveNameParams, _ as contentType, b as Config, d as HttpMethod, g as SchemaObject, h as Operation, i as SchemaKeywordMapper, k as BaseGenerator, t as Schema, u as Oas, v as FileMetaBase, w as PluginFactoryOptions, x as Group, y as PluginManager } from "./SchemaMapper-DmB5NyNo.cjs";
 import { KubbFile } from "@kubb/fabric-core/types";
 import { Fabric } from "@kubb/react-fabric";
 import { KubbNode } from "@kubb/react-fabric/types";
@@ -74,35 +74,55 @@ type Options = {
   /**
    * Which server to use from the array of `servers.url[serverIndex]`
    * @example
-   * - `0` will return `http://petstore.swagger.io/api`
-   * - `1` will return `http://localhost:3000`
+   * - `0` returns `http://petstore.swagger.io/api`
+   * - `1` returns `http://localhost:3000`
    */
   serverIndex?: number;
   /**
    * Define which contentType should be used.
-   * By default, the first JSON valid mediaType will be used
+   * By default, uses the first valid JSON media type.
    */
   contentType?: contentType;
   /**
    * Defines how the discriminator value should be interpreted during processing.
-   *
+   * - 'strict' uses the oneOf schemas as defined, without modification.
+   * - 'inherit' replaces the oneOf schema with the schema referenced by discriminator.mapping[key].
    * @default 'strict'
-   *
-   * @example
-   * - `inherit`: Replaces the `oneOf` schema with the schema referenced by `discriminator.mapping[key]`.
-   * - `strict`: Uses the `oneOf` schemas as defined, without modification.
-   *
    * @see https://github.com/kubb-labs/kubb/issues/1736
    */
   discriminator?: 'strict' | 'inherit';
   /**
-   * Override some behaviour of the Oas class instance, see '@kubb/oas'
+   * Override some behavior of the Oas class instance, see '@kubb/oas'
    */
   oasClass?: typeof Oas;
   /**
    * Define some generators next to the JSON generation
    */
   generators?: Array<Generator<PluginOas>>;
+  /**
+   * Resolve name collisions when schemas from different components share the same name (case-insensitive).
+   *
+   * When enabled, Kubb automatically detects and resolves collisions using intelligent suffixes:
+   * - Cross-component collisions: Adds semantic suffixes based on the component type (Schema/Response/Request)
+   * - Same-component collisions: Adds numeric suffixes (2, 3, ...) for case-insensitive duplicates
+   *
+   * When disabled (legacy behavior), collisions may result in duplicate files or overwrite issues.
+   *
+   * **Cross-component collision example:**
+   * If you have "Order" in both schemas and requestBodies:
+   * - With `collisionDetection: true`: Generates `OrderSchema.ts`, `OrderRequest.ts`
+   * - With `collisionDetection: false`: May generate duplicate `Order.ts` files
+   *
+   * **Same-component collision example:**
+   * If you have "Variant" and "variant" in schemas:
+   * - With `collisionDetection: true`: Generates `Variant.ts`, `Variant2.ts`
+   * - With `collisionDetection: false`: May overwrite or create duplicates
+   *
+   * @default false
+   * @see https://github.com/kubb-labs/kubb/issues/1999
+   * @note this will be the default in Kubb v5
+   */
+  collisionDetection?: boolean;
 };
 /**
  * `propertyName` is the ref name + resolved with the nameResolver
@@ -262,7 +282,7 @@ type SchemaGeneratorOptions = {
      */
     name?: (name: ResolveNameParams['name'], type?: ResolveNameParams['type']) => string;
     /**
-     * Receive schema and name(propertName) and return FakerMeta array
+     * Receive schema and name(propertyName) and return FakerMeta array
      * TODO TODO add docs
      * @beta
      */
@@ -355,4 +375,4 @@ type CoreGenerator<TOptions extends PluginFactoryOptions> = {
 declare function createGenerator<TOptions extends PluginFactoryOptions>(generator: UserGenerator<TOptions>): CoreGenerator<TOptions>;
 //#endregion
 export { Resolver as C, ResolvePathOptions as S, Options as _, createReactGenerator as a, Ref as b, SchemaGeneratorBuildOptions as c, OperationGenerator as d, OperationMethodResult as f, OperationSchemas as g, OperationSchema as h, ReactGenerator as i, SchemaGeneratorOptions as l, Include as m, createGenerator as n, GetSchemaGeneratorOptions as o, Exclude as p, Generator as r, SchemaGenerator as s, CoreGenerator as t, SchemaMethodResult as u, Override as v, FunctionParamsAST as w, Refs as x, PluginOas as y };
-//# sourceMappingURL=createGenerator-Cj-sXgmn.d.cts.map
+//# sourceMappingURL=createGenerator-BF26dp_h.d.cts.map

package/dist/{createGenerator-CZi_gpit.d.ts → createGenerator-DhGg_jH6.d.ts}

@@ -1,5 +1,5 @@
 import { t as __name } from "./chunk-iVr_oF3V.js";
-import { C as Plugin, D as AsyncEventEmitter, O as KubbEvents, S as Output, T as ResolveNameParams, _ as contentType, b as Config, d as HttpMethod, g as SchemaObject, h as Operation, i as SchemaKeywordMapper, k as BaseGenerator, t as Schema, u as Oas, v as FileMetaBase, w as PluginFactoryOptions, x as Group, y as PluginManager } from "./SchemaMapper-BBUBpcx-.js";
+import { C as Plugin, D as AsyncEventEmitter, O as KubbEvents, S as Output, T as ResolveNameParams, _ as contentType, b as Config, d as HttpMethod, g as SchemaObject, h as Operation, i as SchemaKeywordMapper, k as BaseGenerator, t as Schema, u as Oas, v as FileMetaBase, w as PluginFactoryOptions, x as Group, y as PluginManager } from "./SchemaMapper-DI2vHHE0.js";
 import { Fabric } from "@kubb/react-fabric";
 import { KubbFile } from "@kubb/fabric-core/types";
 import { KubbNode } from "@kubb/react-fabric/types";
@@ -75,35 +75,55 @@ type Options = {
   /**
    * Which server to use from the array of `servers.url[serverIndex]`
    * @example
-   * - `0` will return `http://petstore.swagger.io/api`
-   * - `1` will return `http://localhost:3000`
+   * - `0` returns `http://petstore.swagger.io/api`
+   * - `1` returns `http://localhost:3000`
    */
   serverIndex?: number;
   /**
    * Define which contentType should be used.
-   * By default, the first JSON valid mediaType will be used
+   * By default, uses the first valid JSON media type.
    */
   contentType?: contentType;
   /**
    * Defines how the discriminator value should be interpreted during processing.
-   *
+   * - 'strict' uses the oneOf schemas as defined, without modification.
+   * - 'inherit' replaces the oneOf schema with the schema referenced by discriminator.mapping[key].
    * @default 'strict'
-   *
-   * @example
-   * - `inherit`: Replaces the `oneOf` schema with the schema referenced by `discriminator.mapping[key]`.
-   * - `strict`: Uses the `oneOf` schemas as defined, without modification.
-   *
    * @see https://github.com/kubb-labs/kubb/issues/1736
    */
   discriminator?: 'strict' | 'inherit';
   /**
-   * Override some behaviour of the Oas class instance, see '@kubb/oas'
+   * Override some behavior of the Oas class instance, see '@kubb/oas'
    */
   oasClass?: typeof Oas;
   /**
    * Define some generators next to the JSON generation
    */
   generators?: Array<Generator<PluginOas>>;
+  /**
+   * Resolve name collisions when schemas from different components share the same name (case-insensitive).
+   *
+   * When enabled, Kubb automatically detects and resolves collisions using intelligent suffixes:
+   * - Cross-component collisions: Adds semantic suffixes based on the component type (Schema/Response/Request)
+   * - Same-component collisions: Adds numeric suffixes (2, 3, ...) for case-insensitive duplicates
+   *
+   * When disabled (legacy behavior), collisions may result in duplicate files or overwrite issues.
+   *
+   * **Cross-component collision example:**
+   * If you have "Order" in both schemas and requestBodies:
+   * - With `collisionDetection: true`: Generates `OrderSchema.ts`, `OrderRequest.ts`
+   * - With `collisionDetection: false`: May generate duplicate `Order.ts` files
+   *
+   * **Same-component collision example:**
+   * If you have "Variant" and "variant" in schemas:
+   * - With `collisionDetection: true`: Generates `Variant.ts`, `Variant2.ts`
+   * - With `collisionDetection: false`: May overwrite or create duplicates
+   *
+   * @default false
+   * @see https://github.com/kubb-labs/kubb/issues/1999
+   * @note this will be the default in Kubb v5
+   */
+  collisionDetection?: boolean;
 };
 /**
  * `propertyName` is the ref name + resolved with the nameResolver
@@ -263,7 +283,7 @@ type SchemaGeneratorOptions = {
      */
     name?: (name: ResolveNameParams['name'], type?: ResolveNameParams['type']) => string;
     /**
-     * Receive schema and name(propertName) and return FakerMeta array
+     * Receive schema and name(propertyName) and return FakerMeta array
      * TODO TODO add docs
      * @beta
      */
@@ -356,4 +376,4 @@ type CoreGenerator<TOptions extends PluginFactoryOptions> = {
 declare function createGenerator<TOptions extends PluginFactoryOptions>(generator: UserGenerator<TOptions>): CoreGenerator<TOptions>;
 //#endregion
 export { Resolver as C, ResolvePathOptions as S, Options as _, createReactGenerator as a, Ref as b, SchemaGeneratorBuildOptions as c, OperationGenerator as d, OperationMethodResult as f, OperationSchemas as g, OperationSchema as h, ReactGenerator as i, SchemaGeneratorOptions as l, Include as m, createGenerator as n, GetSchemaGeneratorOptions as o, Exclude as p, Generator as r, SchemaGenerator as s, CoreGenerator as t, SchemaMethodResult as u, Override as v, FunctionParamsAST as w, Refs as x, PluginOas as y };
-//# sourceMappingURL=createGenerator-CZi_gpit.d.ts.map
+//# sourceMappingURL=createGenerator-DhGg_jH6.d.ts.map

package/dist/generators.d.cts

@@ -1,5 +1,5 @@
-import { A as __name } from "./SchemaMapper-CIs2VKvf.cjs";
-import { a as createReactGenerator, n as createGenerator, r as Generator, t as CoreGenerator, y as PluginOas } from "./createGenerator-Cj-sXgmn.cjs";
+import { A as __name } from "./SchemaMapper-DmB5NyNo.cjs";
+import { a as createReactGenerator, n as createGenerator, r as Generator, t as CoreGenerator, y as PluginOas } from "./createGenerator-BF26dp_h.cjs";
 
 //#region src/generators/jsonGenerator.d.ts
 declare const jsonGenerator: CoreGenerator<PluginOas>;

package/dist/generators.d.ts

@@ -1,6 +1,6 @@
 import { t as __name } from "./chunk-iVr_oF3V.js";
-import "./SchemaMapper-BBUBpcx-.js";
-import { a as createReactGenerator, n as createGenerator, r as Generator, t as CoreGenerator, y as PluginOas } from "./createGenerator-CZi_gpit.js";
+import "./SchemaMapper-DI2vHHE0.js";
+import { a as createReactGenerator, n as createGenerator, r as Generator, t as CoreGenerator, y as PluginOas } from "./createGenerator-DhGg_jH6.js";
 
 //#region src/generators/jsonGenerator.d.ts
 declare const jsonGenerator: CoreGenerator<PluginOas>;

package/dist/getSchemaFactory-CBp1me72.cjs

@@ -0,0 +1,29 @@
+const require_chunk = require('./chunk-C1_xRkKa.cjs');
+let _kubb_oas = require("@kubb/oas");
+
+//#region src/utils/getSchemaFactory.ts
+/**
+* Creates a factory function that generates a versioned OpenAPI schema result.
+*
+* The returned function accepts an optional schema object and produces a {@link SchemaResult} containing the dereferenced schema and the OpenAPI version ('3.0' or '3.1').
+*
+* @returns A function that takes an optional schema and returns a versioned schema result.
+*/
+function getSchemaFactory(oas) {
+	return (schema) => {
+		const version = (0, _kubb_oas.isOpenApiV3_1Document)(oas.api) ? "3.1" : "3.0";
+		return {
+			schemaObject: oas.dereferenceWithRef(schema),
+			version
+		};
+	};
+}
+
+//#endregion
+Object.defineProperty(exports, 'getSchemaFactory', {
+  enumerable: true,
+  get: function () {
+    return getSchemaFactory;
+  }
+});
+//# sourceMappingURL=getSchemaFactory-CBp1me72.cjs.map

package/dist/getSchemaFactory-CBp1me72.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"getSchemaFactory-CBp1me72.cjs","names":[],"sources":["../src/utils/getSchemaFactory.ts"],"sourcesContent":["import type { Oas, OpenAPIV3, OpenAPIV3_1, SchemaObject } from '@kubb/oas'\nimport { isOpenApiV3_1Document } from '@kubb/oas'\n\n/**\n * Make it possible to narrow down the schema based on a specific version(3 or 3.1)\n */\ntype SchemaResult<TWithRef extends boolean = false> =\n  | {\n      schemaObject:\n        | ((TWithRef extends true ? OpenAPIV3.SchemaObject | OpenAPIV3.ReferenceObject : OpenAPIV3.SchemaObject) & {\n            nullable?: boolean\n            'x-nullable'?: boolean\n          })\n        | null\n      version: '3.0'\n    }\n  | {\n      schemaObject:\n        | ((TWithRef extends true ? OpenAPIV3_1.SchemaObject | OpenAPIV3_1.ReferenceObject : OpenAPIV3_1.SchemaObject) & {\n            nullable?: boolean\n            'x-nullable'?: boolean\n          })\n        | null\n      version: '3.1'\n    }\n\n/**\n * Creates a factory function that generates a versioned OpenAPI schema result.\n *\n * The returned function accepts an optional schema object and produces a {@link SchemaResult} containing the dereferenced schema and the OpenAPI version ('3.0' or '3.1').\n *\n * @returns A function that takes an optional schema and returns a versioned schema result.\n */\nexport function getSchemaFactory<TWithRef extends boolean = false>(oas: Oas): (schema: SchemaObject | null) => SchemaResult<TWithRef> {\n  return (schema: SchemaObject | null) => {\n    const version = isOpenApiV3_1Document(oas.api) ? '3.1' : '3.0'\n\n    return {\n      schemaObject: oas.dereferenceWithRef(schema),\n      version,\n    } as SchemaResult<TWithRef>\n  }\n}\n"],"mappings":";;;;;;;;;;;AAiCA,SAAgB,iBAAmD,KAAmE;AACpI,SAAQ,WAAgC;EACtC,MAAM,+CAAgC,IAAI,IAAI,GAAG,QAAQ;AAEzD,SAAO;GACL,cAAc,IAAI,mBAAmB,OAAO;GAC5C;GACD"}

package/dist/getSchemaFactory-DsoVRgxV.js

@@ -0,0 +1,24 @@
+import { t as __name } from "./chunk-iVr_oF3V.js";
+import { isOpenApiV3_1Document } from "@kubb/oas";
+
+//#region src/utils/getSchemaFactory.ts
+/**
+* Creates a factory function that generates a versioned OpenAPI schema result.
+*
+* The returned function accepts an optional schema object and produces a {@link SchemaResult} containing the dereferenced schema and the OpenAPI version ('3.0' or '3.1').
+*
+* @returns A function that takes an optional schema and returns a versioned schema result.
+*/
+function getSchemaFactory(oas) {
+	return (schema) => {
+		const version = isOpenApiV3_1Document(oas.api) ? "3.1" : "3.0";
+		return {
+			schemaObject: oas.dereferenceWithRef(schema),
+			version
+		};
+	};
+}
+
+//#endregion
+export { getSchemaFactory as t };
+//# sourceMappingURL=getSchemaFactory-DsoVRgxV.js.map

package/dist/getSchemaFactory-DsoVRgxV.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getSchemaFactory-DsoVRgxV.js","names":[],"sources":["../src/utils/getSchemaFactory.ts"],"sourcesContent":["import type { Oas, OpenAPIV3, OpenAPIV3_1, SchemaObject } from '@kubb/oas'\nimport { isOpenApiV3_1Document } from '@kubb/oas'\n\n/**\n * Make it possible to narrow down the schema based on a specific version(3 or 3.1)\n */\ntype SchemaResult<TWithRef extends boolean = false> =\n  | {\n      schemaObject:\n        | ((TWithRef extends true ? OpenAPIV3.SchemaObject | OpenAPIV3.ReferenceObject : OpenAPIV3.SchemaObject) & {\n            nullable?: boolean\n            'x-nullable'?: boolean\n          })\n        | null\n      version: '3.0'\n    }\n  | {\n      schemaObject:\n        | ((TWithRef extends true ? OpenAPIV3_1.SchemaObject | OpenAPIV3_1.ReferenceObject : OpenAPIV3_1.SchemaObject) & {\n            nullable?: boolean\n            'x-nullable'?: boolean\n          })\n        | null\n      version: '3.1'\n    }\n\n/**\n * Creates a factory function that generates a versioned OpenAPI schema result.\n *\n * The returned function accepts an optional schema object and produces a {@link SchemaResult} containing the dereferenced schema and the OpenAPI version ('3.0' or '3.1').\n *\n * @returns A function that takes an optional schema and returns a versioned schema result.\n */\nexport function getSchemaFactory<TWithRef extends boolean = false>(oas: Oas): (schema: SchemaObject | null) => SchemaResult<TWithRef> {\n  return (schema: SchemaObject | null) => {\n    const version = isOpenApiV3_1Document(oas.api) ? '3.1' : '3.0'\n\n    return {\n      schemaObject: oas.dereferenceWithRef(schema),\n      version,\n    } as SchemaResult<TWithRef>\n  }\n}\n"],"mappings":";;;;;;;;;;;AAiCA,SAAgB,iBAAmD,KAAmE;AACpI,SAAQ,WAAgC;EACtC,MAAM,UAAU,sBAAsB,IAAI,IAAI,GAAG,QAAQ;AAEzD,SAAO;GACL,cAAc,IAAI,mBAAmB,OAAO;GAC5C;GACD"}

package/dist/hooks.cjs

@@ -1,5 +1,5 @@
 const require_chunk = require('./chunk-C1_xRkKa.cjs');
-const require_SchemaGenerator = require('./SchemaGenerator-tDDCI3wi.cjs');
+const require_SchemaGenerator = require('./SchemaGenerator-DO3rrt_U.cjs');
 const require_SchemaMapper = require('./SchemaMapper-CzH82C7C.cjs');
 let _kubb_react_fabric = require("@kubb/react-fabric");
 let _kubb_core_hooks = require("@kubb/core/hooks");
@@ -13,7 +13,7 @@ function useOas() {
 //#endregion
 //#region src/hooks/useOperationManager.ts
 /**
-* `useOperationManager` will return some helper functions that can be used to get the operation file, get the operation name.
+* `useOperationManager` returns helper functions to get the operation file and operation name.
 */
 function useOperationManager(generator) {
 	const plugin = (0, _kubb_core_hooks.usePlugin)();
@@ -135,7 +135,7 @@ function useOperationManager(generator) {
 //#endregion
 //#region src/hooks/useSchemaManager.ts
 /**
-* `useSchemaManager` will return some helper functions that can be used to get the schema file, get the schema name.
+* `useSchemaManager` returns helper functions to get the schema file and schema name.
 */
 function useSchemaManager() {
 	const plugin = (0, _kubb_core_hooks.usePlugin)();

package/dist/hooks.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"hooks.cjs","names":["SchemaGenerator","schemaKeywords"],"sources":["../src/hooks/useOas.ts","../src/hooks/useOperationManager.ts","../src/hooks/useSchemaManager.ts"],"sourcesContent":["import type { Oas } from '@kubb/oas'\n\nimport { useApp } from '@kubb/react-fabric'\n\nexport function useOas(): Oas {\n  const { meta } = useApp<{ oas: Oas }>()\n\n  return meta.oas\n}\n","import type { FileMetaBase, Plugin, PluginFactoryOptions, ResolveNameParams } from '@kubb/core'\nimport { usePlugin, usePluginManager } from '@kubb/core/hooks'\nimport type { KubbFile } from '@kubb/fabric-core/types'\nimport type { Operation, Operation as OperationType } from '@kubb/oas'\nimport type { OperationGenerator } from '../OperationGenerator.ts'\nimport type { OperationSchemas } from '../types.ts'\n\ntype FileMeta = FileMetaBase & {\n  pluginKey: Plugin['key']\n  name: string\n  group?: {\n    tag?: string\n    path?: string\n  }\n}\n\nexport type SchemaNames = {\n  request: string | undefined\n  parameters: {\n    path: string | undefined\n    query: string | undefined\n    header: string | undefined\n  }\n  responses: { default?: string } & Record<number | string, string>\n  errors: Record<number | string, string>\n}\n\ntype UseOperationManagerResult = {\n  getName: (\n    operation: OperationType,\n    params: {\n      prefix?: string\n      suffix?: string\n      pluginKey?: Plugin['key']\n      type: ResolveNameParams['type']\n    },\n  ) => string\n  getFile: (\n    operation: OperationType,\n    params?: {\n      prefix?: string\n      suffix?: string\n      pluginKey?: Plugin['key']\n      extname?: KubbFile.Extname\n      group?: {\n        tag?: string\n        path?: string\n      }\n    },\n  ) => KubbFile.File<FileMeta>\n  groupSchemasByName: (\n    operation: OperationType,\n    params: {\n      pluginKey?: Plugin['key']\n      type: ResolveNameParams['type']\n    },\n  ) => SchemaNames\n  getSchemas: (operation: Operation, params?: { pluginKey?: Plugin['key']; type?: ResolveNameParams['type'] }) => OperationSchemas\n  getGroup: (operation: Operation) => FileMeta['group'] | undefined\n}\n\n/**\n * `useOperationManager` will return some helper functions that can be used to get the operation file, get the operation name.\n */\nexport function useOperationManager<TPluginOptions extends PluginFactoryOptions = PluginFactoryOptions>(\n  generator: Omit<OperationGenerator<TPluginOptions>, 'build'>,\n): UseOperationManagerResult {\n  const plugin = usePlugin()\n  const pluginManager = usePluginManager()\n\n  const getName: UseOperationManagerResult['getName'] = (operation, { prefix = '', suffix = '', pluginKey = plugin.key, type }) => {\n    return pluginManager.resolveName({\n      name: `${prefix} ${operation.getOperationId()} ${suffix}`,\n      pluginKey,\n      type,\n    })\n  }\n\n  const getGroup: UseOperationManagerResult['getGroup'] = (operation) => {\n    return {\n      tag: operation.getTags().at(0)?.name,\n      path: operation.path,\n    }\n  }\n\n  const getSchemas: UseOperationManagerResult['getSchemas'] = (operation, params) => {\n    if (!generator) {\n      throw new Error(`'generator' is not defined`)\n    }\n\n    return generator.getSchemas(operation, {\n      resolveName: (name) =>\n        pluginManager.resolveName({\n          name,\n          pluginKey: params?.pluginKey,\n          type: params?.type,\n        }),\n    })\n  }\n\n  const getFile: UseOperationManagerResult['getFile'] = (operation, { prefix, suffix, pluginKey = plugin.key, extname = '.ts' } = {}) => {\n    const name = getName(operation, { type: 'file', pluginKey, prefix, suffix })\n    const group = getGroup(operation)\n\n    const file = pluginManager.getFile({\n      name,\n      extname,\n      pluginKey,\n      options: { type: 'file', pluginKey, group },\n    })\n\n    return {\n      ...file,\n      meta: {\n        ...file.meta,\n        name,\n        pluginKey,\n        group,\n      },\n    }\n  }\n\n  const groupSchemasByName: UseOperationManagerResult['groupSchemasByName'] = (operation, { pluginKey = plugin.key, type }) => {\n    if (!generator) {\n      throw new Error(`'generator' is not defined`)\n    }\n\n    const schemas = generator.getSchemas(operation)\n\n    const errors = (schemas.errors || []).reduce(\n      (prev, acc) => {\n        if (!acc.statusCode) {\n          return prev\n        }\n\n        prev[acc.statusCode] = pluginManager.resolveName({\n          name: acc.name,\n          pluginKey,\n          type,\n        })\n\n        return prev\n      },\n      {} as Record<number, string>,\n    )\n\n    const responses = (schemas.responses || []).reduce(\n      (prev, acc) => {\n        if (!acc.statusCode) {\n          return prev\n        }\n\n        prev[acc.statusCode] = pluginManager.resolveName({\n          name: acc.name,\n          pluginKey,\n          type,\n        })\n\n        return prev\n      },\n      {} as Record<number, string>,\n    )\n\n    return {\n      request: schemas.request?.name\n        ? pluginManager.resolveName({\n            name: schemas.request.name,\n            pluginKey,\n            type,\n          })\n        : undefined,\n      parameters: {\n        path: schemas.pathParams?.name\n          ? pluginManager.resolveName({\n              name: schemas.pathParams.name,\n              pluginKey,\n              type,\n            })\n          : undefined,\n        query: schemas.queryParams?.name\n          ? pluginManager.resolveName({\n              name: schemas.queryParams.name,\n              pluginKey,\n              type,\n            })\n          : undefined,\n        header: schemas.headerParams?.name\n          ? pluginManager.resolveName({\n              name: schemas.headerParams.name,\n              pluginKey,\n              type,\n            })\n          : undefined,\n      },\n      responses: {\n        ...responses,\n        ['default']: pluginManager.resolveName({\n          name: schemas.response.name,\n          pluginKey,\n          type,\n        }),\n        ...errors,\n      },\n      errors,\n    }\n  }\n\n  return {\n    getName,\n    getFile,\n    getSchemas,\n    groupSchemasByName,\n    getGroup,\n  }\n}\n","import type { FileMetaBase, Plugin, ResolveNameParams } from '@kubb/core'\nimport { usePlugin, usePluginManager } from '@kubb/core/hooks'\nimport type { KubbFile } from '@kubb/fabric-core/types'\nimport { SchemaGenerator } from '../SchemaGenerator.ts'\nimport { type Schema, schemaKeywords } from '../SchemaMapper'\n\ntype FileMeta = FileMetaBase & {\n  pluginKey: Plugin['key']\n  name: string\n  group?: {\n    tag?: string\n    path?: string\n  }\n}\n\ntype UseSchemaManagerResult = {\n  getName: (name: string, params: { pluginKey?: Plugin['key']; type: ResolveNameParams['type'] }) => string\n  getFile: (\n    name: string,\n    params?: {\n      pluginKey?: Plugin['key']\n      mode?: KubbFile.Mode\n      extname?: KubbFile.Extname\n      group?: {\n        tag?: string\n        path?: string\n      }\n    },\n  ) => KubbFile.File<FileMeta>\n  getImports: (tree: Array<Schema>) => Array<KubbFile.Import>\n}\n\n/**\n * `useSchemaManager` will return some helper functions that can be used to get the schema file, get the schema name.\n */\nexport function useSchemaManager(): UseSchemaManagerResult {\n  const plugin = usePlugin()\n  const pluginManager = usePluginManager()\n\n  const getName: UseSchemaManagerResult['getName'] = (name, { pluginKey = plugin.key, type }) => {\n    return pluginManager.resolveName({\n      name,\n      pluginKey,\n      type,\n    })\n  }\n\n  const getFile: UseSchemaManagerResult['getFile'] = (name, { mode = 'split', pluginKey = plugin.key, extname = '.ts', group } = {}) => {\n    const resolvedName = mode === 'single' ? '' : getName(name, { type: 'file', pluginKey })\n\n    const file = pluginManager.getFile({\n      name: resolvedName,\n      extname,\n      pluginKey,\n      options: { type: 'file', pluginKey, group },\n    })\n\n    return {\n      ...file,\n      meta: {\n        ...file.meta,\n        name: resolvedName,\n        pluginKey,\n      },\n    }\n  }\n\n  const getImports: UseSchemaManagerResult['getImports'] = (tree) => {\n    const refs = SchemaGenerator.deepSearch(tree, schemaKeywords.ref)\n\n    return refs\n      ?.map((item) => {\n        if (!item.args.path || !item.args.isImportable) {\n          return undefined\n        }\n\n        return {\n          name: [item.args.name],\n          path: item.args.path,\n        }\n      })\n      .filter(Boolean)\n  }\n\n  return {\n    getName,\n    getFile,\n    getImports,\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"hooks.cjs","names":["SchemaGenerator","schemaKeywords"],"sources":["../src/hooks/useOas.ts","../src/hooks/useOperationManager.ts","../src/hooks/useSchemaManager.ts"],"sourcesContent":["import type { Oas } from '@kubb/oas'\n\nimport { useApp } from '@kubb/react-fabric'\n\nexport function useOas(): Oas {\n  const { meta } = useApp<{ oas: Oas }>()\n\n  return meta.oas\n}\n","import type { FileMetaBase, Plugin, PluginFactoryOptions, ResolveNameParams } from '@kubb/core'\nimport { usePlugin, usePluginManager } from '@kubb/core/hooks'\nimport type { KubbFile } from '@kubb/fabric-core/types'\nimport type { Operation, Operation as OperationType } from '@kubb/oas'\nimport type { OperationGenerator } from '../OperationGenerator.ts'\nimport type { OperationSchemas } from '../types.ts'\n\ntype FileMeta = FileMetaBase & {\n  pluginKey: Plugin['key']\n  name: string\n  group?: {\n    tag?: string\n    path?: string\n  }\n}\n\nexport type SchemaNames = {\n  request: string | undefined\n  parameters: {\n    path: string | undefined\n    query: string | undefined\n    header: string | undefined\n  }\n  responses: { default?: string } & Record<number | string, string>\n  errors: Record<number | string, string>\n}\n\ntype UseOperationManagerResult = {\n  getName: (\n    operation: OperationType,\n    params: {\n      prefix?: string\n      suffix?: string\n      pluginKey?: Plugin['key']\n      type: ResolveNameParams['type']\n    },\n  ) => string\n  getFile: (\n    operation: OperationType,\n    params?: {\n      prefix?: string\n      suffix?: string\n      pluginKey?: Plugin['key']\n      extname?: KubbFile.Extname\n      group?: {\n        tag?: string\n        path?: string\n      }\n    },\n  ) => KubbFile.File<FileMeta>\n  groupSchemasByName: (\n    operation: OperationType,\n    params: {\n      pluginKey?: Plugin['key']\n      type: ResolveNameParams['type']\n    },\n  ) => SchemaNames\n  getSchemas: (operation: Operation, params?: { pluginKey?: Plugin['key']; type?: ResolveNameParams['type'] }) => OperationSchemas\n  getGroup: (operation: Operation) => FileMeta['group'] | undefined\n}\n\n/**\n * `useOperationManager` returns helper functions to get the operation file and operation name.\n */\nexport function useOperationManager<TPluginOptions extends PluginFactoryOptions = PluginFactoryOptions>(\n  generator: Omit<OperationGenerator<TPluginOptions>, 'build'>,\n): UseOperationManagerResult {\n  const plugin = usePlugin()\n  const pluginManager = usePluginManager()\n\n  const getName: UseOperationManagerResult['getName'] = (operation, { prefix = '', suffix = '', pluginKey = plugin.key, type }) => {\n    return pluginManager.resolveName({\n      name: `${prefix} ${operation.getOperationId()} ${suffix}`,\n      pluginKey,\n      type,\n    })\n  }\n\n  const getGroup: UseOperationManagerResult['getGroup'] = (operation) => {\n    return {\n      tag: operation.getTags().at(0)?.name,\n      path: operation.path,\n    }\n  }\n\n  const getSchemas: UseOperationManagerResult['getSchemas'] = (operation, params) => {\n    if (!generator) {\n      throw new Error(`'generator' is not defined`)\n    }\n\n    return generator.getSchemas(operation, {\n      resolveName: (name) =>\n        pluginManager.resolveName({\n          name,\n          pluginKey: params?.pluginKey,\n          type: params?.type,\n        }),\n    })\n  }\n\n  const getFile: UseOperationManagerResult['getFile'] = (operation, { prefix, suffix, pluginKey = plugin.key, extname = '.ts' } = {}) => {\n    const name = getName(operation, { type: 'file', pluginKey, prefix, suffix })\n    const group = getGroup(operation)\n\n    const file = pluginManager.getFile({\n      name,\n      extname,\n      pluginKey,\n      options: { type: 'file', pluginKey, group },\n    })\n\n    return {\n      ...file,\n      meta: {\n        ...file.meta,\n        name,\n        pluginKey,\n        group,\n      },\n    }\n  }\n\n  const groupSchemasByName: UseOperationManagerResult['groupSchemasByName'] = (operation, { pluginKey = plugin.key, type }) => {\n    if (!generator) {\n      throw new Error(`'generator' is not defined`)\n    }\n\n    const schemas = generator.getSchemas(operation)\n\n    const errors = (schemas.errors || []).reduce(\n      (prev, acc) => {\n        if (!acc.statusCode) {\n          return prev\n        }\n\n        prev[acc.statusCode] = pluginManager.resolveName({\n          name: acc.name,\n          pluginKey,\n          type,\n        })\n\n        return prev\n      },\n      {} as Record<number, string>,\n    )\n\n    const responses = (schemas.responses || []).reduce(\n      (prev, acc) => {\n        if (!acc.statusCode) {\n          return prev\n        }\n\n        prev[acc.statusCode] = pluginManager.resolveName({\n          name: acc.name,\n          pluginKey,\n          type,\n        })\n\n        return prev\n      },\n      {} as Record<number, string>,\n    )\n\n    return {\n      request: schemas.request?.name\n        ? pluginManager.resolveName({\n            name: schemas.request.name,\n            pluginKey,\n            type,\n          })\n        : undefined,\n      parameters: {\n        path: schemas.pathParams?.name\n          ? pluginManager.resolveName({\n              name: schemas.pathParams.name,\n              pluginKey,\n              type,\n            })\n          : undefined,\n        query: schemas.queryParams?.name\n          ? pluginManager.resolveName({\n              name: schemas.queryParams.name,\n              pluginKey,\n              type,\n            })\n          : undefined,\n        header: schemas.headerParams?.name\n          ? pluginManager.resolveName({\n              name: schemas.headerParams.name,\n              pluginKey,\n              type,\n            })\n          : undefined,\n      },\n      responses: {\n        ...responses,\n        ['default']: pluginManager.resolveName({\n          name: schemas.response.name,\n          pluginKey,\n          type,\n        }),\n        ...errors,\n      },\n      errors,\n    }\n  }\n\n  return {\n    getName,\n    getFile,\n    getSchemas,\n    groupSchemasByName,\n    getGroup,\n  }\n}\n","import type { FileMetaBase, Plugin, ResolveNameParams } from '@kubb/core'\nimport { usePlugin, usePluginManager } from '@kubb/core/hooks'\nimport type { KubbFile } from '@kubb/fabric-core/types'\nimport { SchemaGenerator } from '../SchemaGenerator.ts'\nimport { type Schema, schemaKeywords } from '../SchemaMapper'\n\ntype FileMeta = FileMetaBase & {\n  pluginKey: Plugin['key']\n  name: string\n  group?: {\n    tag?: string\n    path?: string\n  }\n}\n\ntype UseSchemaManagerResult = {\n  getName: (name: string, params: { pluginKey?: Plugin['key']; type: ResolveNameParams['type'] }) => string\n  getFile: (\n    name: string,\n    params?: {\n      pluginKey?: Plugin['key']\n      mode?: KubbFile.Mode\n      extname?: KubbFile.Extname\n      group?: {\n        tag?: string\n        path?: string\n      }\n    },\n  ) => KubbFile.File<FileMeta>\n  getImports: (tree: Array<Schema>) => Array<KubbFile.Import>\n}\n\n/**\n * `useSchemaManager` returns helper functions to get the schema file and schema name.\n */\nexport function useSchemaManager(): UseSchemaManagerResult {\n  const plugin = usePlugin()\n  const pluginManager = usePluginManager()\n\n  const getName: UseSchemaManagerResult['getName'] = (name, { pluginKey = plugin.key, type }) => {\n    return pluginManager.resolveName({\n      name,\n      pluginKey,\n      type,\n    })\n  }\n\n  const getFile: UseSchemaManagerResult['getFile'] = (name, { mode = 'split', pluginKey = plugin.key, extname = '.ts', group } = {}) => {\n    const resolvedName = mode === 'single' ? '' : getName(name, { type: 'file', pluginKey })\n\n    const file = pluginManager.getFile({\n      name: resolvedName,\n      extname,\n      pluginKey,\n      options: { type: 'file', pluginKey, group },\n    })\n\n    return {\n      ...file,\n      meta: {\n        ...file.meta,\n        name: resolvedName,\n        pluginKey,\n      },\n    }\n  }\n\n  const getImports: UseSchemaManagerResult['getImports'] = (tree) => {\n    const refs = SchemaGenerator.deepSearch(tree, schemaKeywords.ref)\n\n    return refs\n      ?.map((item) => {\n        if (!item.args.path || !item.args.isImportable) {\n          return undefined\n        }\n\n        return {\n          name: [item.args.name],\n          path: item.args.path,\n        }\n      })\n      .filter(Boolean)\n  }\n\n  return {\n    getName,\n    getFile,\n    getImports,\n  }\n}\n"],"mappings":"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"}