@kubb/core 5.0.0-alpha.36 → 5.0.0-alpha.39

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kubb/core",
-  "version": "5.0.0-alpha.36",
+  "version": "5.0.0-alpha.39",
   "description": "Core functionality for Kubb's plugin-based code generation system, providing the foundation for transforming OpenAPI specifications.",
   "keywords": [
     "typescript",
@@ -31,10 +31,6 @@
       "import": "./dist/index.js",
       "require": "./dist/index.cjs"
     },
-    "./hooks": {
-      "import": "./dist/hooks.js",
-      "require": "./dist/hooks.cjs"
-    },
     "./mocks": {
       "import": "./dist/mocks.js",
       "require": "./dist/mocks.cjs"
@@ -44,9 +40,6 @@
   "types": "./dist/index.d.ts",
   "typesVersions": {
     "*": {
-      "hooks": [
-        "./dist/hooks.d.ts"
-      ],
       "mocks": [
         "./dist/mocks.d.ts"
       ]
@@ -75,8 +68,8 @@
     "remeda": "^2.33.7",
     "semver": "^7.7.4",
     "tinyexec": "^1.1.1",
-    "@kubb/ast": "5.0.0-alpha.36",
-    "@kubb/renderer-jsx": "5.0.0-alpha.36"
+    "@kubb/ast": "5.0.0-alpha.39",
+    "@kubb/renderer-jsx": "5.0.0-alpha.39"
   },
   "devDependencies": {
     "@types/semver": "^7.7.1",
@@ -84,7 +77,7 @@
     "@internals/utils": "0.0.0"
   },
   "peerDependencies": {
-    "@kubb/renderer-jsx": "5.0.0-alpha.36"
+    "@kubb/renderer-jsx": "5.0.0-alpha.39"
   },
   "engines": {
     "node": ">=22"

package/src/PluginDriver.ts

@@ -73,21 +73,6 @@ export type GetFileOptions<TOptions = object> = {
   options?: TOptions
 }
 
-/**
- * Returns `'single'` when `fileOrFolder` has a file extension, `'split'` otherwise.
- *
- * @example
- * ```ts
- * getMode('src/gen/types.ts')  // 'single'
- * getMode('src/gen/types')     // 'split'
- * ```
- */
-export function getMode(fileOrFolder: string | undefined | null): 'single' | 'split' {
-  if (!fileOrFolder) {
-    return 'split'
-  }
-  return extname(fileOrFolder) ? 'single' : 'split'
-}
 
 const hookFirstNullCheck = (state: unknown) => !!(state as SafeParseResult<'resolveName'> | null)?.result
 
@@ -95,6 +80,22 @@ export class PluginDriver {
   readonly config: Config
   readonly options: Options
 
+  /**
+   * Returns `'single'` when `fileOrFolder` has a file extension, `'split'` otherwise.
+   *
+   * @example
+   * ```ts
+   * PluginDriver.getMode('src/gen/types.ts')  // 'single'
+   * PluginDriver.getMode('src/gen/types')     // 'split'
+   * ```
+   */
+  static getMode(fileOrFolder: string | undefined | null): 'single' | 'split' {
+    if (!fileOrFolder) {
+      return 'split'
+    }
+    return extname(fileOrFolder) ? 'single' : 'split'
+}
+
   /**
    * The universal `@kubb/ast` `InputNode` produced by the adapter, set by
    * the build pipeline after the adapter's `parse()` resolves.
@@ -301,7 +302,7 @@ export class PluginDriver {
    *
    * Call this method inside `addGenerator()` (in `kubb:plugin:setup`) to wire up a generator.
    */
-  registerGenerator(pluginName: string, gen: Generator<any>): void {
+  registerGenerator(pluginName: string, gen: Generator): void {
     const resolveRenderer = () => {
       const plugin = this.plugins.get(pluginName)
       return gen.renderer === null ? undefined : (gen.renderer ?? plugin?.renderer ?? this.config.renderer)
@@ -422,7 +423,7 @@ export class PluginDriver {
         return resolve(driver.config.root, driver.config.output.path)
       },
       getMode(output: { path: string }): 'single' | 'split' {
-        return getMode(resolve(driver.config.root, driver.config.output.path, output.path))
+        return PluginDriver.getMode(resolve(driver.config.root, driver.config.output.path, output.path))
       },
       hooks: driver.hooks,
       plugin,

package/src/constants.ts

@@ -49,52 +49,4 @@ export const logLevel = {
   debug: 5,
 } as const
 
-/**
- * CLI command descriptors for each supported linter.
- *
- * Each entry contains the executable `command`, an `args` factory that maps an
- * output path to the correct argument list, and an `errorMessage` shown when
- * the linter is not found.
- */
-export const linters = {
-  eslint: {
-    command: 'eslint',
-    args: (outputPath: string) => [outputPath, '--fix'],
-    errorMessage: 'Eslint not found',
-  },
-  biome: {
-    command: 'biome',
-    args: (outputPath: string) => ['lint', '--fix', outputPath],
-    errorMessage: 'Biome not found',
-  },
-  oxlint: {
-    command: 'oxlint',
-    args: (outputPath: string) => ['--fix', outputPath],
-    errorMessage: 'Oxlint not found',
-  },
-} as const
 
-/**
- * CLI command descriptors for each supported code formatter.
- *
- * Each entry contains the executable `command`, an `args` factory that maps an
- * output path to the correct argument list, and an `errorMessage` shown when
- * the formatter is not found.
- */
-export const formatters = {
-  prettier: {
-    command: 'prettier',
-    args: (outputPath: string) => ['--ignore-unknown', '--write', outputPath],
-    errorMessage: 'Prettier not found',
-  },
-  biome: {
-    command: 'biome',
-    args: (outputPath: string) => ['format', '--write', outputPath],
-    errorMessage: 'Biome not found',
-  },
-  oxfmt: {
-    command: 'oxfmt',
-    args: (outputPath: string) => [outputPath],
-    errorMessage: 'Oxfmt not found',
-  },
-} as const

package/src/createKubb.ts

@@ -187,7 +187,7 @@ async function runPluginAstHooks(plugin: Plugin, context: PluginContext): Promis
     throw new Error(`[${plugin.name}] No adapter found. Add an OAS adapter (e.g. pluginOas()) before this plugin in your Kubb config.`)
   }
 
-  function resolveRenderer(gen: Generator<any>): RendererFactory | undefined {
+  function resolveRenderer(gen: Generator): RendererFactory | undefined {
     return gen.renderer === null ? undefined : (gen.renderer ?? plugin.renderer ?? context.config.renderer)
   }
 

package/src/defineResolver.ts

@@ -2,7 +2,7 @@ import path from 'node:path'
 import { camelCase, pascalCase } from '@internals/utils'
 import type { FileNode, InputNode, Node, OperationNode, SchemaNode } from '@kubb/ast'
 import { createFile, isOperationNode, isSchemaNode } from '@kubb/ast'
-import { getMode } from './PluginDriver.ts'
+import { PluginDriver } from './PluginDriver.ts'
 import type {
   Config,
   PluginFactoryOptions,
@@ -195,7 +195,7 @@ export function defaultResolveOptions<TOptions>(
  * ```
  */
 export function defaultResolvePath({ baseName, pathMode, tag, path: groupPath }: ResolverPathParams, { root, output, group }: ResolverContext): string {
-  const mode = pathMode ?? getMode(path.resolve(root, output.path))
+  const mode = pathMode ?? PluginDriver.getMode(path.resolve(root, output.path))
 
   if (mode === 'single') {
     return path.resolve(root, output.path)
@@ -236,7 +236,7 @@ export function defaultResolvePath({ baseName, pathMode, tag, path: groupPath }:
  * ```
  */
 export function defaultResolveFile(this: Resolver, { name, extname, tag, path: groupPath }: ResolverFileParams, context: ResolverContext): FileNode {
-  const pathMode = getMode(path.resolve(context.root, context.output.path))
+  const pathMode = PluginDriver.getMode(path.resolve(context.root, context.output.path))
   const resolvedName = pathMode === 'single' ? '' : this.default(name, 'file')
   const baseName = `${resolvedName}${extname}` as FileNode['baseName']
   const filePath = this.resolvePath({ baseName, pathMode, tag, path: groupPath }, context)

package/src/index.ts

@@ -1,36 +1,19 @@
 export { AsyncEventEmitter, URLPath } from '@internals/utils'
 export * as ast from '@kubb/ast'
-export { composeTransformers, definePrinter } from '@kubb/ast'
-export { formatters, linters, logLevel } from './constants.ts'
+export { logLevel } from './constants.ts'
 export { createAdapter } from './createAdapter.ts'
 export { createKubb } from './createKubb.ts'
-export { createPlugin } from './createPlugin.ts'
 export { createRenderer } from './createRenderer.ts'
 export { createStorage } from './createStorage.ts'
 export { defineGenerator } from './defineGenerator.ts'
 export { defineLogger } from './defineLogger.ts'
 export { defineParser } from './defineParser.ts'
 export { definePlugin } from './definePlugin.ts'
-export {
-  buildDefaultBanner,
-  defaultResolveBanner,
-  defaultResolveFile,
-  defaultResolveFooter,
-  defaultResolveOptions,
-  defaultResolvePath,
-  defineResolver,
-} from './defineResolver.ts'
+export { defineResolver } from './defineResolver.ts'
 export { FileManager } from './FileManager.ts'
 export { FileProcessor } from './FileProcessor.ts'
-export { getMode, PluginDriver } from './PluginDriver.ts'
+export { PluginDriver } from './PluginDriver.ts'
 export { fsStorage } from './storages/fsStorage.ts'
 export { memoryStorage } from './storages/memoryStorage.ts'
 export * from './types.ts'
-export type { FunctionParamsAST } from './utils/FunctionParams.ts'
-export { detectFormatter } from './utils/formatters.ts'
-export { getBarrelFiles } from './utils/getBarrelFiles.ts'
-export type { Param, Params } from './utils/getFunctionParams.ts'
-export { createFunctionParams, FunctionParams, getFunctionParams } from './utils/getFunctionParams.ts'
 export { isInputPath } from './utils/isInputPath.ts'
-export { detectLinter } from './utils/linters.ts'
-export { satisfiesDependency } from './utils/packageJSON.ts'

package/src/mocks.ts

@@ -2,7 +2,7 @@ import { resolve } from 'node:path'
 import type { FileNode, OperationNode, SchemaNode, Visitor } from '@kubb/ast'
 import { transform } from '@kubb/ast'
 import { FileManager } from './FileManager.ts'
-import { getMode, type PluginDriver } from './PluginDriver.ts'
+import { PluginDriver } from './PluginDriver.ts'
 import { applyHookResult } from './renderNode.ts'
 import type {
   Adapter,
@@ -47,7 +47,7 @@ function pascalCase(text: string): string {
 /**
  * Creates a minimal `PluginDriver` mock suitable for unit tests.
  */
-export function createMockedPluginDriver(options: { name?: string; plugin?: Plugin<any>; config?: Config } = {}): PluginDriver {
+export function createMockedPluginDriver(options: { name?: string; plugin?: Plugin; config?: Config } = {}): PluginDriver {
   return {
     resolveName: (result: ResolveNameParams) => {
       if (result.type === 'file') {
@@ -162,7 +162,7 @@ function createMockedPluginContext<TOptions extends PluginFactoryOptions>(opts:
   return {
     config: opts.config,
     root,
-    getMode: (output: { path: string }) => getMode(resolve(root, output.path)),
+    getMode: (output: { path: string }) => PluginDriver.getMode(resolve(root, output.path)),
     adapter: opts.adapter,
     resolver: opts.resolver,
     plugin: opts.plugin,

package/src/storages/fsStorage.ts

@@ -4,6 +4,13 @@ import { join, resolve } from 'node:path'
 import { clean, write } from '@internals/utils'
 import { createStorage } from '../createStorage.ts'
 
+/**
+ * Detects the filesystem error used to indicate that a path does not exist.
+ */
+function isMissingPathError(error: unknown): error is NodeJS.ErrnoException {
+  return typeof error === 'object' && error !== null && 'code' in error && (error as NodeJS.ErrnoException).code === 'ENOENT'
+}
+
 /**
  * Built-in filesystem storage driver.
  *
@@ -33,15 +40,23 @@ export const fsStorage = createStorage(() => ({
     try {
       await access(resolve(key))
       return true
-    } catch {
-      return false
+    } catch (error) {
+      if (isMissingPathError(error)) {
+        return false
+      }
+
+      throw new Error(`Failed to access storage item "${key}"`, { cause: error as Error })
     }
   },
   async getItem(key: string) {
     try {
       return await readFile(resolve(key), 'utf8')
-    } catch {
-      return null
+    } catch (error) {
+      if (isMissingPathError(error)) {
+        return null
+      }
+
+      throw new Error(`Failed to read storage item "${key}"`, { cause: error as Error })
     }
   },
   async setItem(key: string, value: string) {
@@ -52,13 +67,18 @@ export const fsStorage = createStorage(() => ({
   },
   async getKeys(base?: string) {
     const keys: Array<string> = []
+    const resolvedBase = resolve(base ?? process.cwd())
 
     async function walk(dir: string, prefix: string): Promise<void> {
       let entries: Array<Dirent>
       try {
         entries = (await readdir(dir, { withFileTypes: true })) as Array<Dirent>
-      } catch {
-        return
+      } catch (error) {
+        if (isMissingPathError(error)) {
+          return
+        }
+
+        throw new Error(`Failed to list storage keys under "${resolvedBase}"`, { cause: error as Error })
       }
       for (const entry of entries) {
         const rel = prefix ? `${prefix}/${entry.name}` : entry.name
@@ -70,7 +90,7 @@ export const fsStorage = createStorage(() => ({
       }
     }
 
-    await walk(resolve(base ?? process.cwd()), '')
+    await walk(resolvedBase, '')
 
     return keys
   },

package/src/types.ts

@@ -435,7 +435,7 @@ export type UserPlugin<TOptions extends PluginFactoryOptions = PluginFactoryOpti
    * over `plugin.renderer`; set `renderer: null` on a generator to opt out of rendering even
    * when the plugin declares a renderer.
    */
-  generators?: Array<Generator<any>>
+  generators?: Array<Generator>
   /**
    * Specifies the plugins that the current plugin depends on. The current plugin is executed after all listed plugins.
    * An error is returned if any required dependency plugin is missing.
@@ -555,7 +555,7 @@ export type Plugin<TOptions extends PluginFactoryOptions = PluginFactoryOptions>
    * over `plugin.renderer`; set `renderer: null` on a generator to opt out of rendering even
    * when the plugin declares a renderer.
    */
-  generators?: Array<Generator<any>>
+  generators?: Array<Generator>
 
   buildStart: (this: PluginContext<TOptions>) => PossiblePromise<void>
   /**
@@ -696,7 +696,7 @@ export type PluginContext<TOptions extends PluginFactoryOptions = PluginFactoryO
   /**
    * Returns the output mode for the given output config.
    * Returns `'single'` when `output.path` has a file extension, `'split'` otherwise.
-   * Shorthand for `getMode(path.resolve(this.root, output.path))`.
+   * Shorthand for `PluginDriver.getMode(path.resolve(this.root, output.path))`.
    */
   getMode: (output: { path: string }) => 'single' | 'split'
   driver: PluginDriver
@@ -1148,14 +1148,6 @@ export type PossibleConfig<TCliOptions = undefined> =
   | PossiblePromise<Config | Config[]>
   | ((...args: [TCliOptions] extends [undefined] ? [] : [TCliOptions]) => PossiblePromise<Config | Config[]>)
 
-/**
- * All accepted forms of a Kubb configuration.
- * @deprecated
- * Kept for backward compatibility. Prefer `PossibleConfig<CLIOptions>` in new code.
- */
-export type ConfigInput = PossibleConfig<CLIOptions>
-
 export type { BuildOutput } from './createKubb.ts'
 export type { Parser } from './defineParser.ts'
-export type { FunctionParamsAST } from './utils/FunctionParams.ts'
 export type { FileMetaBase } from './utils/getBarrelFiles.ts'

package/src/utils/TreeNode.ts

@@ -1,6 +1,6 @@
 import path from 'node:path'
 import type { FileNode } from '@kubb/ast'
-import { getMode } from '../PluginDriver.ts'
+import { PluginDriver } from '../PluginDriver.ts'
 
 type BarrelData = {
   file?: FileNode
@@ -155,7 +155,7 @@ export class TreeNode {
         name: filteredTree.name,
         path: filteredTree.path,
         file: filteredTree.file,
-        type: getMode(filteredTree.path),
+        type: PluginDriver.getMode(filteredTree.path),
       })
 
       const recurse = (node: typeof treeNode, item: DirectoryTree) => {
@@ -163,7 +163,7 @@ export class TreeNode {
           name: item.name,
           path: item.path,
           file: item.file,
-          type: getMode(item.path),
+          type: PluginDriver.getMode(item.path),
         })
 
         if (item.children?.length) {

package/src/utils/executeStrategies.ts

@@ -82,19 +82,3 @@ export function hookParallel<TInput extends Array<PromiseFunc<TValue, null>>, TV
 
   return Promise.allSettled(tasks) as TOutput
 }
-
-/**
- * Execution strategy used when dispatching plugin hook calls.
- *  @deprecated
- */
-export type Strategy = 'seq' | 'first' | 'parallel'
-
-type StrategyOutputMap<TInput extends Array<PromiseFunc<TValue, null>>, TValue> = {
-  first: HookFirstOutput<TInput, TValue>
-  seq: SeqOutput<TInput, TValue>
-  parallel: HookParallelOutput<TInput, TValue>
-}
-/**
- *  @deprecated
- */
-export type StrategySwitch<TStrategy extends Strategy, TInput extends Array<PromiseFunc<TValue, null>>, TValue> = StrategyOutputMap<TInput, TValue>[TStrategy]