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

package/src/types.ts

@@ -254,7 +254,7 @@ export 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.
    */
@@ -349,15 +349,6 @@ export type Resolver = {
  */
 export 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.
- */
-export type Builder = {
-  name: string
-}
-
 export type PluginFactoryOptions<
   /**
    * Name to be used for the plugin.
@@ -384,11 +375,6 @@ export type PluginFactoryOptions<
    * 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,
 > = {
   name: TName
   options: TOptions
@@ -396,7 +382,6 @@ export type PluginFactoryOptions<
   context: TContext
   resolvePathOptions: TResolvePathOptions
   resolver: TResolver
-  builder: TBuilder
 }
 
 export type UserPlugin<TOptions extends PluginFactoryOptions = PluginFactoryOptions> = {
@@ -410,6 +395,10 @@ export type UserPlugin<TOptions extends PluginFactoryOptions = PluginFactoryOpti
    * 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.
@@ -445,6 +434,10 @@ export 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>
   /**
@@ -516,6 +509,7 @@ export type PluginContext<TOptions extends PluginFactoryOptions = PluginFactoryO
   fabric: FabricType
   config: Config
   driver: PluginDriver
+  getPlugin: PluginDriver['getPlugin']
   /**
    * Only add when the file does not exist yet
    */
@@ -525,11 +519,14 @@ export type PluginContext<TOptions extends PluginFactoryOptions = PluginFactoryO
    */
   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.
@@ -583,7 +580,7 @@ export type Output<_TOptions = unknown> = {
   override?: boolean
 }
 
-export type Group = {
+export type UserGroup = {
   /**
    * Defines the type where to group the files.
    * - 'tag' groups files by OpenAPI tags.
@@ -597,6 +594,20 @@ export type Group = {
   name?: (context: { group: string }) => string
 }
 
+export 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
+}
+
 export type LoggerOptions = {
   /**
    * @default 3

package/src/utils/getConfigs.ts

@@ -12,5 +12,5 @@ export async function getConfigs(config: ConfigInput | UserConfig, args: CLIOpti
   const resolved = await (typeof config === 'function' ? config(args as CLIOptions) : config)
   const userConfigs = Array.isArray(resolved) ? resolved : [resolved]
 
-  return userConfigs.map((item) => ({ ...item }) as Config)
+  return userConfigs.map((item) => ({ plugins: [], ...item }) as Config)
 }

package/src/utils/getPreset.ts

@@ -5,11 +5,11 @@ import { mergeResolvers } from './mergeResolvers.ts'
 type GetPresetParams<TResolver extends Resolver> = {
   preset: CompatibilityPreset
   presets: Presets<TResolver>
-  resolvers: Array<TResolver>
+  resolvers?: Array<TResolver>
   /**
    * User-supplied generators to append after the preset's generators.
    */
-  generators: Array<Generator<any>>
+  generators?: Array<Generator<any>>
   transformers?: Array<Visitor>
 }
 
@@ -29,7 +29,7 @@ type GetPresetResult<TResolver extends Resolver> = {
  * - Combines preset generators with user-supplied generators; falls back to the `default` preset's generators when neither provides any.
  */
 export function getPreset<TResolver extends Resolver = Resolver>(params: GetPresetParams<TResolver>): GetPresetResult<TResolver> {
-  const { preset: presetName, presets, resolvers, transformers: userTransformers, generators: userGenerators } = params
+  const { preset: presetName, presets, resolvers = [], transformers: userTransformers = [], generators: userGenerators = [] } = params
   const [defaultResolver, ...userResolvers] = resolvers
   const preset = presets[presetName]
 

package/src/defineBuilder.ts

@@ -1,26 +0,0 @@
-import type { PluginFactoryOptions } from './types.ts'
-
-/**
- * Builder type for the plugin-specific builder fields.
- * `name` is required; all other methods are defined by the concrete plugin builder type.
- */
-type BuilderBuilder<T extends PluginFactoryOptions> = () => T['builder'] & ThisType<T['builder']>
-
-/**
- * Defines a builder for a plugin — a named collection of schema-building helpers that
- * can be exported alongside the plugin and imported by other plugins or generators.
- *
- * @example
- * export const builder = defineBuilder<PluginTs>(() => ({
- *   name: 'default',
- *   buildParamsSchema({ params, node, resolver }) {
- *     return createSchema({ type: 'object', properties: [] })
- *   },
- *   buildDataSchemaNode({ node, resolver }) {
- *     return createSchema({ type: 'object', properties: [] })
- *   },
- * }))
- */
-export function defineBuilder<T extends PluginFactoryOptions>(build: BuilderBuilder<T>): T['builder'] {
-  return build() as T['builder']
-}

package/src/definePreset.ts

@@ -1,27 +0,0 @@
-import type { Visitor } from '@kubb/ast/types'
-import type { Generator, Preset, Resolver } from './types.ts'
-
-/**
- * Creates a typed preset object that bundles a name, resolvers, optional
- * transformers, and optional generators — the building block for composable plugin presets.
- *
- * @example
- * import { definePreset } from '@kubb/core'
- * import { resolverTsLegacy } from '@kubb/plugin-ts'
- *
- * export const myPreset = definePreset('myPreset', { resolvers: [resolverTsLegacy] })
- *
- * @example
- * // With custom transformers
- * export const myPreset = definePreset('myPreset', { resolvers: [resolverTsLegacy], transformers: [myTransformer] })
- *
- * @example
- * // With generators
- * export const myPreset = definePreset('myPreset', { resolvers: [resolverTsLegacy], generators: [typeGeneratorLegacy] })
- */
-export function definePreset<TResolver extends Resolver = Resolver, TName extends string = string>(
-  name: TName,
-  { resolvers, transformers, generators }: { resolvers: Array<TResolver>; transformers?: Array<Visitor>; generators?: Array<Generator<any>> },
-): Preset<TResolver> & { name: TName } {
-  return { name, resolvers, transformers, generators }
-}