@kubb/core 5.0.0-beta.7 → 5.0.0-beta.8

package/dist/mocks.js.map

@@ -1 +1 @@
-{"version":3,"file":"mocks.js","names":[],"sources":["../src/mocks.ts"],"sourcesContent":["import { resolve } from 'node:path'\nimport type { FileNode, OperationNode, SchemaNode, Visitor } from '@kubb/ast'\nimport { transform } from '@kubb/ast'\nimport { FileManager } from './FileManager.ts'\nimport { PluginDriver } from './PluginDriver.ts'\nimport { applyHookResult } from './renderNode.ts'\nimport type { Adapter, AdapterFactoryOptions, Config, Generator, GeneratorContext, NormalizedPlugin, PluginFactoryOptions } from './types.ts'\n\n/**\n\n * Creates a minimal `PluginDriver` mock for unit tests.\n */\nexport function createMockedPluginDriver(options: { name?: string; plugin?: NormalizedPlugin; config?: Config } = {}): PluginDriver {\n  return {\n    config: options?.config ?? {\n      root: '.',\n      output: {\n        path: './path',\n      },\n    },\n    getPlugin(_pluginName: string): NormalizedPlugin | undefined {\n      return options?.plugin\n    },\n    getResolver: (_pluginName: string) => options?.plugin?.resolver,\n    fileManager: new FileManager(),\n  } as unknown as PluginDriver\n}\n\n/**\n * Creates a minimal `Adapter` mock for unit tests.\n * `parse` returns an empty `InputNode` by default; override via `options.parse`.\n * `getImports` returns `[]` by default.\n */\nexport function createMockedAdapter<TOptions extends AdapterFactoryOptions = AdapterFactoryOptions>(\n  options: {\n    name?: TOptions['name']\n    resolvedOptions?: TOptions['resolvedOptions']\n    inputNode?: Adapter<TOptions>['inputNode']\n    parse?: Adapter<TOptions>['parse']\n    getImports?: Adapter<TOptions>['getImports']\n  } = {},\n): Adapter<TOptions> {\n  const inputNode = options.inputNode ?? null\n  return {\n    name: (options.name ?? 'oas') as TOptions['name'],\n    options: (options.resolvedOptions ?? {}) as TOptions['resolvedOptions'],\n    inputNode,\n    parse: options.parse ?? (async () => ({ kind: 'Input' as const, schemas: [], operations: [] })),\n    getImports: options.getImports ?? ((_node: SchemaNode, _resolve: (schemaName: string) => { name: string; path: string }) => []),\n  } as Adapter<TOptions>\n}\n\n/**\n * Creates a minimal plugin mock for unit tests.\n *\n * @example\n * `const plugin = createMockedPlugin<PluginTs>({ name: '@kubb/plugin-ts', options })`\n */\nexport function createMockedPlugin<TOptions extends PluginFactoryOptions = PluginFactoryOptions>(params: {\n  name: TOptions['name']\n  options: TOptions['resolvedOptions']\n  resolver?: TOptions['resolver']\n  transformer?: Visitor\n  dependencies?: Array<string>\n}): NormalizedPlugin<TOptions> {\n  return {\n    name: params.name,\n    options: params.options,\n    resolver: params.resolver,\n    transformer: params.transformer,\n    dependencies: params.dependencies,\n    hooks: {},\n  } as unknown as NormalizedPlugin<TOptions>\n}\n\ntype RenderGeneratorOptions<TOptions extends PluginFactoryOptions> = {\n  config: Config\n  adapter: Adapter\n  driver: PluginDriver\n  plugin: NormalizedPlugin<TOptions>\n  options: TOptions['resolvedOptions']\n  resolver: TOptions['resolver']\n}\n\nfunction createMockedPluginContext<TOptions extends PluginFactoryOptions>(opts: RenderGeneratorOptions<TOptions>): Omit<GeneratorContext<TOptions>, 'options'> {\n  const root = resolve(opts.config.root, opts.config.output.path)\n\n  return {\n    config: opts.config,\n    root,\n    getMode: (output: { path: string }) => PluginDriver.getMode(resolve(root, output.path)),\n    adapter: opts.adapter,\n    resolver: opts.resolver,\n    plugin: opts.plugin,\n    driver: opts.driver,\n    getResolver: (name: string) => opts.driver.getResolver(name),\n    inputNode: { kind: 'Input', schemas: [], operations: [] },\n    addFile: async (...files: Array<FileNode>) => opts.driver.fileManager.add(...files),\n    upsertFile: async (...files: Array<FileNode>) => opts.driver.fileManager.upsert(...files),\n    hooks: opts.driver.hooks ?? ({} as never),\n    warn: (msg: string) => console.warn(msg),\n    error: (msg: string) => console.error(msg),\n    info: (msg: string) => console.info(msg),\n    openInStudio: async () => {},\n  } as unknown as Omit<GeneratorContext<TOptions>, 'options'>\n}\n\n/**\n * Renders a generator's `schema` method in a test context.\n *\n * @example\n * ```ts\n * await renderGeneratorSchema(typeGenerator, node, { config, adapter, driver, plugin, options, resolver })\n * await matchFiles(driver.fileManager.files)\n * ```\n */\nexport async function renderGeneratorSchema<TOptions extends PluginFactoryOptions>(\n  generator: Generator<TOptions>,\n  node: SchemaNode,\n  opts: RenderGeneratorOptions<TOptions>,\n): Promise<void> {\n  if (!generator.schema) return\n  const context = createMockedPluginContext(opts)\n  const transformedNode = opts.plugin.transformer ? transform(node, opts.plugin.transformer) : node\n  const result = await generator.schema(transformedNode, {\n    ...context,\n    options: opts.options,\n  })\n  await applyHookResult(result, opts.driver, generator.renderer ?? undefined)\n}\n\n/**\n * Renders a generator's `operation` method in a test context.\n *\n * @example\n * ```ts\n * await renderGeneratorOperation(typeGenerator, node, { config, adapter, driver, plugin, options, resolver })\n * await matchFiles(driver.fileManager.files)\n * ```\n */\nexport async function renderGeneratorOperation<TOptions extends PluginFactoryOptions>(\n  generator: Generator<TOptions>,\n  node: OperationNode,\n  opts: RenderGeneratorOptions<TOptions>,\n): Promise<void> {\n  if (!generator.operation) return\n  const context = createMockedPluginContext(opts)\n  const transformedNode = opts.plugin.transformer ? transform(node, opts.plugin.transformer) : node\n  const result = await generator.operation(transformedNode, {\n    ...context,\n    options: opts.options,\n  })\n  await applyHookResult(result, opts.driver, generator.renderer ?? undefined)\n}\n\n/**\n * Renders a generator's `operations` method in a test context.\n *\n * @example\n * ```ts\n * await renderGeneratorOperations(classClientGenerator, nodes, { config, adapter, driver, plugin, options, resolver })\n * await matchFiles(driver.fileManager.files)\n * ```\n */\nexport async function renderGeneratorOperations<TOptions extends PluginFactoryOptions>(\n  generator: Generator<TOptions>,\n  nodes: Array<OperationNode>,\n  opts: RenderGeneratorOptions<TOptions>,\n): Promise<void> {\n  if (!generator.operations) return\n  const context = createMockedPluginContext(opts)\n  const transformedNodes = opts.plugin.transformer ? nodes.map((n) => transform(n, opts.plugin.transformer!)) : nodes\n  const result = await generator.operations(transformedNodes, {\n    ...context,\n    options: opts.options,\n  })\n  await applyHookResult(result, opts.driver, generator.renderer ?? undefined)\n}\n"],"mappings":"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"}
+{"version":3,"file":"mocks.js","names":[],"sources":["../src/mocks.ts"],"sourcesContent":["import { resolve } from 'node:path'\nimport type { FileNode, OperationNode, SchemaNode, Visitor } from '@kubb/ast'\nimport { transform } from '@kubb/ast'\nimport { FileManager } from './FileManager.ts'\nimport { applyHookResult, PluginDriver } from './PluginDriver.ts'\nimport type { Adapter, AdapterFactoryOptions, Config, Generator, GeneratorContext, NormalizedPlugin, PluginFactoryOptions } from './types.ts'\n\n/**\n\n * Creates a minimal `PluginDriver` mock for unit tests.\n */\nexport function createMockedPluginDriver(options: { name?: string; plugin?: NormalizedPlugin; config?: Config } = {}): PluginDriver {\n  return {\n    config: options?.config ?? {\n      root: '.',\n      output: {\n        path: './path',\n      },\n    },\n    getPlugin(_pluginName: string): NormalizedPlugin | undefined {\n      return options?.plugin\n    },\n    getResolver: (_pluginName: string) => options?.plugin?.resolver,\n    fileManager: new FileManager(),\n  } as unknown as PluginDriver\n}\n\n/**\n * Creates a minimal `Adapter` mock for unit tests.\n * `parse` returns an empty `InputNode` by default; override via `options.parse`.\n * `getImports` returns `[]` by default.\n */\nexport function createMockedAdapter<TOptions extends AdapterFactoryOptions = AdapterFactoryOptions>(\n  options: {\n    name?: TOptions['name']\n    resolvedOptions?: TOptions['resolvedOptions']\n    inputNode?: Adapter<TOptions>['inputNode']\n    parse?: Adapter<TOptions>['parse']\n    getImports?: Adapter<TOptions>['getImports']\n  } = {},\n): Adapter<TOptions> {\n  const inputNode = options.inputNode ?? null\n  return {\n    name: (options.name ?? 'oas') as TOptions['name'],\n    options: (options.resolvedOptions ?? {}) as TOptions['resolvedOptions'],\n    inputNode,\n    parse: options.parse ?? (async () => ({ kind: 'Input' as const, schemas: [], operations: [] })),\n    getImports: options.getImports ?? ((_node: SchemaNode, _resolve: (schemaName: string) => { name: string; path: string }) => []),\n  } as Adapter<TOptions>\n}\n\n/**\n * Creates a minimal plugin mock for unit tests.\n *\n * @example\n * `const plugin = createMockedPlugin<PluginTs>({ name: '@kubb/plugin-ts', options })`\n */\nexport function createMockedPlugin<TOptions extends PluginFactoryOptions = PluginFactoryOptions>(params: {\n  name: TOptions['name']\n  options: TOptions['resolvedOptions']\n  resolver?: TOptions['resolver']\n  transformer?: Visitor\n  dependencies?: Array<string>\n}): NormalizedPlugin<TOptions> {\n  return {\n    name: params.name,\n    options: params.options,\n    resolver: params.resolver,\n    transformer: params.transformer,\n    dependencies: params.dependencies,\n    hooks: {},\n  } as unknown as NormalizedPlugin<TOptions>\n}\n\ntype RenderGeneratorOptions<TOptions extends PluginFactoryOptions> = {\n  config: Config\n  adapter: Adapter\n  driver: PluginDriver\n  plugin: NormalizedPlugin<TOptions>\n  options: TOptions['resolvedOptions']\n  resolver: TOptions['resolver']\n}\n\nfunction createMockedPluginContext<TOptions extends PluginFactoryOptions>(opts: RenderGeneratorOptions<TOptions>): Omit<GeneratorContext<TOptions>, 'options'> {\n  const root = resolve(opts.config.root, opts.config.output.path)\n\n  return {\n    config: opts.config,\n    root,\n    getMode: (output: { path: string }) => PluginDriver.getMode(resolve(root, output.path)),\n    adapter: opts.adapter,\n    resolver: opts.resolver,\n    plugin: opts.plugin,\n    driver: opts.driver,\n    getResolver: (name: string) => opts.driver.getResolver(name),\n    inputNode: { kind: 'Input', schemas: [], operations: [] },\n    addFile: async (...files: Array<FileNode>) => opts.driver.fileManager.add(...files),\n    upsertFile: async (...files: Array<FileNode>) => opts.driver.fileManager.upsert(...files),\n    hooks: opts.driver.hooks ?? ({} as never),\n    warn: (msg: string) => console.warn(msg),\n    error: (msg: string) => console.error(msg),\n    info: (msg: string) => console.info(msg),\n    openInStudio: async () => {},\n  } as unknown as Omit<GeneratorContext<TOptions>, 'options'>\n}\n\n/**\n * Renders a generator's `schema` method in a test context.\n *\n * @example\n * ```ts\n * await renderGeneratorSchema(typeGenerator, node, { config, adapter, driver, plugin, options, resolver })\n * await matchFiles(driver.fileManager.files)\n * ```\n */\nexport async function renderGeneratorSchema<TOptions extends PluginFactoryOptions>(\n  generator: Generator<TOptions>,\n  node: SchemaNode,\n  opts: RenderGeneratorOptions<TOptions>,\n): Promise<void> {\n  if (!generator.schema) return\n  const context = createMockedPluginContext(opts)\n  const transformedNode = opts.plugin.transformer ? transform(node, opts.plugin.transformer) : node\n  const result = await generator.schema(transformedNode, {\n    ...context,\n    options: opts.options,\n  })\n  await applyHookResult(result, opts.driver, generator.renderer ?? undefined)\n}\n\n/**\n * Renders a generator's `operation` method in a test context.\n *\n * @example\n * ```ts\n * await renderGeneratorOperation(typeGenerator, node, { config, adapter, driver, plugin, options, resolver })\n * await matchFiles(driver.fileManager.files)\n * ```\n */\nexport async function renderGeneratorOperation<TOptions extends PluginFactoryOptions>(\n  generator: Generator<TOptions>,\n  node: OperationNode,\n  opts: RenderGeneratorOptions<TOptions>,\n): Promise<void> {\n  if (!generator.operation) return\n  const context = createMockedPluginContext(opts)\n  const transformedNode = opts.plugin.transformer ? transform(node, opts.plugin.transformer) : node\n  const result = await generator.operation(transformedNode, {\n    ...context,\n    options: opts.options,\n  })\n  await applyHookResult(result, opts.driver, generator.renderer ?? undefined)\n}\n\n/**\n * Renders a generator's `operations` method in a test context.\n *\n * @example\n * ```ts\n * await renderGeneratorOperations(classClientGenerator, nodes, { config, adapter, driver, plugin, options, resolver })\n * await matchFiles(driver.fileManager.files)\n * ```\n */\nexport async function renderGeneratorOperations<TOptions extends PluginFactoryOptions>(\n  generator: Generator<TOptions>,\n  nodes: Array<OperationNode>,\n  opts: RenderGeneratorOptions<TOptions>,\n): Promise<void> {\n  if (!generator.operations) return\n  const context = createMockedPluginContext(opts)\n  const transformedNodes = opts.plugin.transformer ? nodes.map((n) => transform(n, opts.plugin.transformer!)) : nodes\n  const result = await generator.operations(transformedNodes, {\n    ...context,\n    options: opts.options,\n  })\n  await applyHookResult(result, opts.driver, generator.renderer ?? undefined)\n}\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kubb/core",
-  "version": "5.0.0-beta.7",
+  "version": "5.0.0-beta.8",
   "description": "Core engine for Kubb's plugin-based code generation system. Provides the plugin driver, file manager, defineConfig, and build orchestration used by every Kubb plugin.",
   "keywords": [
     "code-generator",
@@ -58,15 +58,15 @@
   "dependencies": {
     "fflate": "^0.8.2",
     "tinyexec": "^1.1.2",
-    "@kubb/ast": "5.0.0-beta.7"
+    "@kubb/ast": "5.0.0-beta.8"
   },
   "devDependencies": {
     "p-limit": "^7.3.0",
     "@internals/utils": "0.0.0",
-    "@kubb/renderer-jsx": "5.0.0-beta.7"
+    "@kubb/renderer-jsx": "5.0.0-beta.8"
   },
   "peerDependencies": {
-    "@kubb/renderer-jsx": "5.0.0-beta.7"
+    "@kubb/renderer-jsx": "5.0.0-beta.8"
   },
   "size-limit": [
     {

package/src/PluginDriver.ts

@@ -1,14 +1,15 @@
-import { extname, resolve } from 'node:path'
+import { resolve } from 'node:path'
 import type { AsyncEventEmitter } from '@internals/utils'
 import type { FileNode, InputNode, OperationNode, SchemaNode } from '@kubb/ast'
 import { createFile } from '@kubb/ast'
 import { DEFAULT_STUDIO_URL } from './constants.ts'
 import type { Generator } from './defineGenerator.ts'
 import type { Plugin } from './definePlugin.ts'
+import { getMode } from './definePlugin.ts'
 import { defineResolver } from './defineResolver.ts'
 import { openInStudio as openInStudioFn } from './devtools.ts'
 import { FileManager } from './FileManager.ts'
-import { applyHookResult } from './renderNode.ts'
+import type { RendererFactory } from './createRenderer.ts'
 
 import type {
   Adapter,
@@ -46,10 +47,7 @@ export class PluginDriver {
    * ```
    */
   static getMode(fileOrFolder: string | undefined | null): 'single' | 'split' {
-    if (!fileOrFolder) {
-      return 'split'
-    }
-    return extname(fileOrFolder) ? 'single' : 'split'
+    return getMode(fileOrFolder)
   }
 
   /**
@@ -191,6 +189,7 @@ export class PluginDriver {
    */
   async emitSetupHooks(): Promise<void> {
     const noop = () => {}
+
     await this.hooks.emit('kubb:plugin:setup', {
       config: this.config,
       options: {},
@@ -302,7 +301,7 @@ export class PluginDriver {
       return existingResolver
     }
 
-    const resolver = defineResolver<PluginFactoryOptions>((_ctx) => ({
+    const resolver = defineResolver<PluginFactoryOptions>(() => ({
       name: 'default',
       pluginName,
     }))
@@ -424,3 +423,35 @@ export class PluginDriver {
     return plugin
   }
 }
+
+/**
+ * Handles the return value of a plugin AST hook or generator method.
+ *
+ * - Renderer output → rendered via the provided `rendererFactory` (e.g. JSX), files stored in `driver.fileManager`
+ * - `Array<FileNode>` → added directly into `driver.fileManager`
+ * - `void` / `null` / `undefined` → no-op (plugin handled it via `this.upsertFile`)
+ *
+ * Pass a `rendererFactory` (e.g. `jsxRenderer` from `@kubb/renderer-jsx`) when the result
+ * may be a renderer element. Generators that only return `Array<FileNode>` do not need one.
+ */
+export async function applyHookResult<TElement = unknown>(
+  result: TElement | Array<FileNode> | void,
+  driver: PluginDriver,
+  rendererFactory?: RendererFactory<TElement>,
+): Promise<void> {
+  if (!result) return
+
+  if (Array.isArray(result)) {
+    driver.fileManager.upsert(...(result as Array<FileNode>))
+    return
+  }
+
+  if (!rendererFactory) {
+    return
+  }
+
+  const renderer = rendererFactory()
+  await renderer.render(result)
+  driver.fileManager.upsert(...renderer.files)
+  renderer.unmount()
+}

package/src/createAdapter.ts

@@ -1,4 +1,80 @@
-import type { Adapter, AdapterFactoryOptions } from './types.ts'
+import type { PossiblePromise } from '@internals/utils'
+import type { ImportNode, InputNode, SchemaNode } from '@kubb/ast'
+
+/**
+ * Source data passed to an adapter's `parse` function.
+ * Mirrors the config input shape with paths resolved to absolute.
+ */
+export type AdapterSource = { type: 'path'; path: string } | { type: 'data'; data: string | unknown } | { type: 'paths'; paths: Array<string> }
+
+/**
+ * Generic type parameters for an adapter definition.
+ *
+ * - `TName` — unique identifier (e.g. `'oas'`, `'asyncapi'`)
+ * - `TOptions` — user-facing options passed to the adapter factory
+ * - `TResolvedOptions` — options after defaults applied
+ * - `TDocument` — type of the parsed source document
+ */
+export type AdapterFactoryOptions<
+  TName extends string = string,
+  TOptions extends object = object,
+  TResolvedOptions extends object = TOptions,
+  TDocument = unknown,
+> = {
+  name: TName
+  options: TOptions
+  resolvedOptions: TResolvedOptions
+  document: TDocument
+}
+
+/**
+ * Adapter that converts input files or data into an `InputNode`.
+ *
+ * Adapters parse different schema formats (OpenAPI, AsyncAPI, Drizzle, etc.) into Kubb's
+ * universal intermediate representation that all plugins consume.
+ *
+ * @example
+ * ```ts
+ * import { adapterOas } from '@kubb/adapter-oas'
+ *
+ * export default defineConfig({
+ *   adapter: adapterOas(),
+ *   input: { path: './openapi.yaml' },
+ *   plugins: [pluginTs(), pluginZod()],
+ * })
+ * ```
+ */
+export type Adapter<TOptions extends AdapterFactoryOptions = AdapterFactoryOptions> = {
+  /**
+   * Human-readable adapter identifier (e.g. `'oas'`, `'asyncapi'`).
+   */
+  name: TOptions['name']
+  /**
+   * Resolved adapter options after defaults have been applied.
+   */
+  options: TOptions['resolvedOptions']
+  /**
+   * Parsed source document after the first `parse()` call. `null` before parsing.
+   */
+  document: TOptions['document'] | null
+  inputNode: InputNode | null
+  /**
+   * Parse the source into a universal `InputNode`.
+   */
+  parse: (source: AdapterSource) => PossiblePromise<InputNode>
+  /**
+   * Extract `ImportNode` entries for a schema tree.
+   * Returns an empty array before the first `parse()` call.
+   *
+   * The `resolve` callback receives the collision-corrected schema name and must
+   * return `{ name, path }` for the import, or `undefined` to skip it.
+   */
+  getImports: (node: SchemaNode, resolve: (schemaName: string) => { name: string; path: string }) => Array<ImportNode>
+  /**
+   * Validate the document at the given path or URL.
+   */
+  validate: (input: string, options?: { throwOnError?: boolean }) => Promise<void>
+}
 
 type AdapterBuilder<T extends AdapterFactoryOptions> = (options: T['options']) => Adapter<T>