@kubb/core 5.0.0-alpha.9 → 5.0.0-beta.10

package/dist/mocks.cjs

@@ -0,0 +1,145 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_PluginDriver = require("./PluginDriver-Cu1Kj9S-.cjs");
+let node_path = require("node:path");
+let _kubb_ast = require("@kubb/ast");
+//#region src/mocks.ts
+/**
+
+* Creates a minimal `PluginDriver` mock for unit tests.
+*/
+function createMockedPluginDriver(options = {}) {
+	return {
+		config: options?.config ?? {
+			root: ".",
+			output: { path: "./path" }
+		},
+		getPlugin(_pluginName) {
+			return options?.plugin;
+		},
+		getResolver: (_pluginName) => options?.plugin?.resolver,
+		fileManager: new require_PluginDriver.FileManager()
+	};
+}
+/**
+* Creates a minimal `Adapter` mock for unit tests.
+* `parse` returns an empty `InputNode` by default; override via `options.parse`.
+* `getImports` returns `[]` by default.
+*/
+function createMockedAdapter(options = {}) {
+	const inputNode = options.inputNode ?? null;
+	return {
+		name: options.name ?? "oas",
+		options: options.resolvedOptions ?? {},
+		inputNode,
+		parse: options.parse ?? (async () => ({
+			kind: "Input",
+			schemas: [],
+			operations: []
+		})),
+		getImports: options.getImports ?? ((_node, _resolve) => [])
+	};
+}
+/**
+* Creates a minimal plugin mock for unit tests.
+*
+* @example
+* `const plugin = createMockedPlugin<PluginTs>({ name: '@kubb/plugin-ts', options })`
+*/
+function createMockedPlugin(params) {
+	return {
+		name: params.name,
+		options: params.options,
+		resolver: params.resolver,
+		transformer: params.transformer,
+		dependencies: params.dependencies,
+		hooks: {}
+	};
+}
+function createMockedPluginContext(opts) {
+	const root = (0, node_path.resolve)(opts.config.root, opts.config.output.path);
+	return {
+		config: opts.config,
+		root,
+		getMode: (output) => require_PluginDriver.PluginDriver.getMode((0, node_path.resolve)(root, output.path)),
+		adapter: opts.adapter,
+		resolver: opts.resolver,
+		plugin: opts.plugin,
+		driver: opts.driver,
+		getResolver: (name) => opts.driver.getResolver(name),
+		inputNode: {
+			kind: "Input",
+			schemas: [],
+			operations: []
+		},
+		addFile: async (...files) => opts.driver.fileManager.add(...files),
+		upsertFile: async (...files) => opts.driver.fileManager.upsert(...files),
+		hooks: opts.driver.hooks ?? {},
+		warn: (msg) => console.warn(msg),
+		error: (msg) => console.error(msg),
+		info: (msg) => console.info(msg),
+		openInStudio: async () => {}
+	};
+}
+/**
+* Renders a generator's `schema` method in a test context.
+*
+* @example
+* ```ts
+* await renderGeneratorSchema(typeGenerator, node, { config, adapter, driver, plugin, options, resolver })
+* await matchFiles(driver.fileManager.files)
+* ```
+*/
+async function renderGeneratorSchema(generator, node, opts) {
+	if (!generator.schema) return;
+	const context = createMockedPluginContext(opts);
+	const transformedNode = opts.plugin.transformer ? (0, _kubb_ast.transform)(node, opts.plugin.transformer) : node;
+	await require_PluginDriver.applyHookResult(await generator.schema(transformedNode, {
+		...context,
+		options: opts.options
+	}), opts.driver, generator.renderer ?? void 0);
+}
+/**
+* Renders a generator's `operation` method in a test context.
+*
+* @example
+* ```ts
+* await renderGeneratorOperation(typeGenerator, node, { config, adapter, driver, plugin, options, resolver })
+* await matchFiles(driver.fileManager.files)
+* ```
+*/
+async function renderGeneratorOperation(generator, node, opts) {
+	if (!generator.operation) return;
+	const context = createMockedPluginContext(opts);
+	const transformedNode = opts.plugin.transformer ? (0, _kubb_ast.transform)(node, opts.plugin.transformer) : node;
+	await require_PluginDriver.applyHookResult(await generator.operation(transformedNode, {
+		...context,
+		options: opts.options
+	}), opts.driver, generator.renderer ?? void 0);
+}
+/**
+* Renders a generator's `operations` method in a test context.
+*
+* @example
+* ```ts
+* await renderGeneratorOperations(classClientGenerator, nodes, { config, adapter, driver, plugin, options, resolver })
+* await matchFiles(driver.fileManager.files)
+* ```
+*/
+async function renderGeneratorOperations(generator, nodes, opts) {
+	if (!generator.operations) return;
+	const context = createMockedPluginContext(opts);
+	const transformedNodes = opts.plugin.transformer ? nodes.map((n) => (0, _kubb_ast.transform)(n, opts.plugin.transformer)) : nodes;
+	await require_PluginDriver.applyHookResult(await generator.operations(transformedNodes, {
+		...context,
+		options: opts.options
+	}), opts.driver, generator.renderer ?? void 0);
+}
+//#endregion
+exports.createMockedAdapter = createMockedAdapter;
+exports.createMockedPlugin = createMockedPlugin;
+exports.createMockedPluginDriver = createMockedPluginDriver;
+exports.renderGeneratorOperation = renderGeneratorOperation;
+exports.renderGeneratorOperations = renderGeneratorOperations;
+exports.renderGeneratorSchema = renderGeneratorSchema;
+
+//# sourceMappingURL=mocks.cjs.map

package/dist/mocks.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"mocks.cjs","names":["FileManager","PluginDriver","applyHookResult"],"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/dist/mocks.d.ts

@@ -0,0 +1,80 @@
+import { t as __name } from "./chunk--u3MIqq1.js";
+import { H as NormalizedPlugin, K as PluginFactoryOptions, P as PluginDriver, _t as AdapterFactoryOptions, gt as Adapter, j as Generator, r as Config } from "./createKubb-ALdb8lmq.js";
+import { OperationNode, SchemaNode, Visitor } from "@kubb/ast";
+
+//#region src/mocks.d.ts
+/**
+
+ * Creates a minimal `PluginDriver` mock for unit tests.
+ */
+declare function createMockedPluginDriver(options?: {
+  name?: string;
+  plugin?: NormalizedPlugin;
+  config?: Config;
+}): PluginDriver;
+/**
+ * Creates a minimal `Adapter` mock for unit tests.
+ * `parse` returns an empty `InputNode` by default; override via `options.parse`.
+ * `getImports` returns `[]` by default.
+ */
+declare function createMockedAdapter<TOptions extends AdapterFactoryOptions = AdapterFactoryOptions>(options?: {
+  name?: TOptions['name'];
+  resolvedOptions?: TOptions['resolvedOptions'];
+  inputNode?: Adapter<TOptions>['inputNode'];
+  parse?: Adapter<TOptions>['parse'];
+  getImports?: Adapter<TOptions>['getImports'];
+}): Adapter<TOptions>;
+/**
+ * Creates a minimal plugin mock for unit tests.
+ *
+ * @example
+ * `const plugin = createMockedPlugin<PluginTs>({ name: '@kubb/plugin-ts', options })`
+ */
+declare function createMockedPlugin<TOptions extends PluginFactoryOptions = PluginFactoryOptions>(params: {
+  name: TOptions['name'];
+  options: TOptions['resolvedOptions'];
+  resolver?: TOptions['resolver'];
+  transformer?: Visitor;
+  dependencies?: Array<string>;
+}): NormalizedPlugin<TOptions>;
+type RenderGeneratorOptions<TOptions extends PluginFactoryOptions> = {
+  config: Config;
+  adapter: Adapter;
+  driver: PluginDriver;
+  plugin: NormalizedPlugin<TOptions>;
+  options: TOptions['resolvedOptions'];
+  resolver: TOptions['resolver'];
+};
+/**
+ * Renders a generator's `schema` method in a test context.
+ *
+ * @example
+ * ```ts
+ * await renderGeneratorSchema(typeGenerator, node, { config, adapter, driver, plugin, options, resolver })
+ * await matchFiles(driver.fileManager.files)
+ * ```
+ */
+declare function renderGeneratorSchema<TOptions extends PluginFactoryOptions>(generator: Generator<TOptions>, node: SchemaNode, opts: RenderGeneratorOptions<TOptions>): Promise<void>;
+/**
+ * Renders a generator's `operation` method in a test context.
+ *
+ * @example
+ * ```ts
+ * await renderGeneratorOperation(typeGenerator, node, { config, adapter, driver, plugin, options, resolver })
+ * await matchFiles(driver.fileManager.files)
+ * ```
+ */
+declare function renderGeneratorOperation<TOptions extends PluginFactoryOptions>(generator: Generator<TOptions>, node: OperationNode, opts: RenderGeneratorOptions<TOptions>): Promise<void>;
+/**
+ * Renders a generator's `operations` method in a test context.
+ *
+ * @example
+ * ```ts
+ * await renderGeneratorOperations(classClientGenerator, nodes, { config, adapter, driver, plugin, options, resolver })
+ * await matchFiles(driver.fileManager.files)
+ * ```
+ */
+declare function renderGeneratorOperations<TOptions extends PluginFactoryOptions>(generator: Generator<TOptions>, nodes: Array<OperationNode>, opts: RenderGeneratorOptions<TOptions>): Promise<void>;
+//#endregion
+export { createMockedAdapter, createMockedPlugin, createMockedPluginDriver, renderGeneratorOperation, renderGeneratorOperations, renderGeneratorSchema };
+//# sourceMappingURL=mocks.d.ts.map

package/dist/mocks.js

@@ -0,0 +1,140 @@
+import "./chunk--u3MIqq1.js";
+import { n as applyHookResult, r as FileManager, t as PluginDriver } from "./PluginDriver-D8Z0Htid.js";
+import { resolve } from "node:path";
+import { transform } from "@kubb/ast";
+//#region src/mocks.ts
+/**
+
+* Creates a minimal `PluginDriver` mock for unit tests.
+*/
+function createMockedPluginDriver(options = {}) {
+	return {
+		config: options?.config ?? {
+			root: ".",
+			output: { path: "./path" }
+		},
+		getPlugin(_pluginName) {
+			return options?.plugin;
+		},
+		getResolver: (_pluginName) => options?.plugin?.resolver,
+		fileManager: new FileManager()
+	};
+}
+/**
+* Creates a minimal `Adapter` mock for unit tests.
+* `parse` returns an empty `InputNode` by default; override via `options.parse`.
+* `getImports` returns `[]` by default.
+*/
+function createMockedAdapter(options = {}) {
+	const inputNode = options.inputNode ?? null;
+	return {
+		name: options.name ?? "oas",
+		options: options.resolvedOptions ?? {},
+		inputNode,
+		parse: options.parse ?? (async () => ({
+			kind: "Input",
+			schemas: [],
+			operations: []
+		})),
+		getImports: options.getImports ?? ((_node, _resolve) => [])
+	};
+}
+/**
+* Creates a minimal plugin mock for unit tests.
+*
+* @example
+* `const plugin = createMockedPlugin<PluginTs>({ name: '@kubb/plugin-ts', options })`
+*/
+function createMockedPlugin(params) {
+	return {
+		name: params.name,
+		options: params.options,
+		resolver: params.resolver,
+		transformer: params.transformer,
+		dependencies: params.dependencies,
+		hooks: {}
+	};
+}
+function createMockedPluginContext(opts) {
+	const root = resolve(opts.config.root, opts.config.output.path);
+	return {
+		config: opts.config,
+		root,
+		getMode: (output) => PluginDriver.getMode(resolve(root, output.path)),
+		adapter: opts.adapter,
+		resolver: opts.resolver,
+		plugin: opts.plugin,
+		driver: opts.driver,
+		getResolver: (name) => opts.driver.getResolver(name),
+		inputNode: {
+			kind: "Input",
+			schemas: [],
+			operations: []
+		},
+		addFile: async (...files) => opts.driver.fileManager.add(...files),
+		upsertFile: async (...files) => opts.driver.fileManager.upsert(...files),
+		hooks: opts.driver.hooks ?? {},
+		warn: (msg) => console.warn(msg),
+		error: (msg) => console.error(msg),
+		info: (msg) => console.info(msg),
+		openInStudio: async () => {}
+	};
+}
+/**
+* Renders a generator's `schema` method in a test context.
+*
+* @example
+* ```ts
+* await renderGeneratorSchema(typeGenerator, node, { config, adapter, driver, plugin, options, resolver })
+* await matchFiles(driver.fileManager.files)
+* ```
+*/
+async function renderGeneratorSchema(generator, node, opts) {
+	if (!generator.schema) return;
+	const context = createMockedPluginContext(opts);
+	const transformedNode = opts.plugin.transformer ? transform(node, opts.plugin.transformer) : node;
+	await applyHookResult(await generator.schema(transformedNode, {
+		...context,
+		options: opts.options
+	}), opts.driver, generator.renderer ?? void 0);
+}
+/**
+* Renders a generator's `operation` method in a test context.
+*
+* @example
+* ```ts
+* await renderGeneratorOperation(typeGenerator, node, { config, adapter, driver, plugin, options, resolver })
+* await matchFiles(driver.fileManager.files)
+* ```
+*/
+async function renderGeneratorOperation(generator, node, opts) {
+	if (!generator.operation) return;
+	const context = createMockedPluginContext(opts);
+	const transformedNode = opts.plugin.transformer ? transform(node, opts.plugin.transformer) : node;
+	await applyHookResult(await generator.operation(transformedNode, {
+		...context,
+		options: opts.options
+	}), opts.driver, generator.renderer ?? void 0);
+}
+/**
+* Renders a generator's `operations` method in a test context.
+*
+* @example
+* ```ts
+* await renderGeneratorOperations(classClientGenerator, nodes, { config, adapter, driver, plugin, options, resolver })
+* await matchFiles(driver.fileManager.files)
+* ```
+*/
+async function renderGeneratorOperations(generator, nodes, opts) {
+	if (!generator.operations) return;
+	const context = createMockedPluginContext(opts);
+	const transformedNodes = opts.plugin.transformer ? nodes.map((n) => transform(n, opts.plugin.transformer)) : nodes;
+	await applyHookResult(await generator.operations(transformedNodes, {
+		...context,
+		options: opts.options
+	}), opts.driver, generator.renderer ?? void 0);
+}
+//#endregion
+export { createMockedAdapter, createMockedPlugin, createMockedPluginDriver, renderGeneratorOperation, renderGeneratorOperations, renderGeneratorSchema };
+
+//# sourceMappingURL=mocks.js.map

package/dist/mocks.js.map

@@ -0,0 +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 { 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,50 +1,22 @@
 {
   "name": "@kubb/core",
-  "version": "5.0.0-alpha.9",
-  "description": "Core functionality for Kubb's plugin-based code generation system, providing the foundation for transforming OpenAPI specifications.",
+  "version": "5.0.0-beta.10",
+  "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": [
-    "typescript",
-    "plugins",
-    "plugin-system",
-    "plugin-framework",
     "code-generator",
     "codegen",
-    "ast",
-    "file-system",
+    "kubb",
     "openapi",
-    "swagger",
-    "oas",
-    "core-library",
-    "kubb"
+    "plugin-system",
+    "typescript"
   ],
+  "license": "MIT",
+  "author": "stijnvanhulle",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/kubb-labs/kubb.git",
     "directory": "packages/core"
   },
-  "license": "MIT",
-  "author": "stijnvanhulle",
-  "sideEffects": false,
-  "type": "module",
-  "exports": {
-    ".": {
-      "import": "./dist/index.js",
-      "require": "./dist/index.cjs"
-    },
-    "./hooks": {
-      "import": "./dist/hooks.js",
-      "require": "./dist/hooks.cjs"
-    },
-    "./package.json": "./package.json"
-  },
-  "types": "./dist/index.d.ts",
-  "typesVersions": {
-    "*": {
-      "hooks": [
-        "./dist/hooks.d.ts"
-      ]
-    }
-  },
   "files": [
     "src",
     "schemas",
@@ -56,41 +28,56 @@
     "!/**/__tests__/**",
     "!/**/__snapshots__/**"
   ],
-  "size-limit": [
-    {
-      "path": "./dist/*.js",
-      "limit": "510 KiB",
-      "gzip": true
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "typesVersions": {
+    "*": {
+      "mocks": [
+        "./dist/mocks.d.ts"
+      ]
     }
-  ],
+  },
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./mocks": {
+      "import": "./dist/mocks.js",
+      "require": "./dist/mocks.cjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
   "dependencies": {
-    "@kubb/fabric-core": "0.14.0",
-    "@kubb/react-fabric": "0.14.0",
-    "empathic": "^2.0.0",
     "fflate": "^0.8.2",
-    "remeda": "^2.33.6",
-    "semver": "^7.7.4",
-    "tinyexec": "^1.0.4",
-    "@kubb/ast": "5.0.0-alpha.9"
+    "tinyexec": "^1.1.2",
+    "@kubb/ast": "5.0.0-beta.10"
   },
   "devDependencies": {
-    "@types/semver": "^7.7.1",
     "p-limit": "^7.3.0",
-    "@internals/utils": "0.0.0"
+    "@internals/utils": "0.0.0",
+    "@kubb/renderer-jsx": "5.0.0-beta.10"
   },
   "peerDependencies": {
-    "@kubb/fabric-core": "0.14.0",
-    "@kubb/react-fabric": "0.14.0"
+    "@kubb/renderer-jsx": "5.0.0-beta.10"
   },
+  "size-limit": [
+    {
+      "path": "./dist/*.js",
+      "limit": "510 KiB",
+      "gzip": true
+    }
+  ],
   "engines": {
     "node": ">=22"
   },
-  "publishConfig": {
-    "access": "public",
-    "registry": "https://registry.npmjs.org/"
-  },
-  "main": "./dist/index.cjs",
-  "module": "./dist/index.js",
   "inlinedDependencies": {
     "p-limit": "7.3.0",
     "yocto-queue": "1.2.2"
@@ -98,8 +85,8 @@
   "scripts": {
     "build": "tsdown && size-limit",
     "clean": "npx rimraf ./dist",
-    "lint": "bun biome lint .",
-    "lint:fix": "bun biome lint --fix --unsafe .",
+    "lint": "oxlint .",
+    "lint:fix": "oxlint --fix .",
     "release": "pnpm publish --no-git-check",
     "release:canary": "bash ../../.github/canary.sh && node ../../scripts/build.js canary && pnpm publish --no-git-check",
     "start": "tsdown --watch",

package/src/FileManager.ts

@@ -0,0 +1,115 @@
+import type { FileNode } from '@kubb/ast'
+import { createFile } from '@kubb/ast'
+
+function mergeFile<TMeta extends object = object>(a: FileNode<TMeta>, b: FileNode<TMeta>): FileNode<TMeta> {
+  return {
+    ...a,
+    // Incoming file (b) takes precedence for banner/footer so that barrel files,
+    // which never carry a banner, can clear banners set by plugin-generated files
+    // at the same path.
+    banner: b.banner,
+    footer: b.footer,
+    sources: [...(a.sources || []), ...(b.sources || [])],
+    imports: [...(a.imports || []), ...(b.imports || [])],
+    exports: [...(a.exports || []), ...(b.exports || [])],
+  }
+}
+
+/**
+ * Collapses a list of files so that duplicates sharing the same `path` are merged
+ * in arrival order. Keeps the original order of first occurrence.
+ */
+function mergeFilesByPath(files: ReadonlyArray<FileNode>): Map<string, FileNode> {
+  const merged = new Map<string, FileNode>()
+  for (const file of files) {
+    const existing = merged.get(file.path)
+    merged.set(file.path, existing ? mergeFile(existing, file) : file)
+  }
+  return merged
+}
+
+/**
+ * In-memory file store for generated files.
+ *
+ * Files with the same `path` are merged — sources, imports, and exports are concatenated.
+ * The `files` getter returns all stored files sorted by path length (shortest first).
+ *
+ * @example
+ * ```ts
+ * import { FileManager } from '@kubb/core'
+ *
+ * const manager = new FileManager()
+ * manager.upsert(myFile)
+ * console.log(manager.files) // all stored files
+ * ```
+ */
+export class FileManager {
+  readonly #cache = new Map<string, FileNode>()
+  #filesCache: Array<FileNode> | null = null
+
+  /**
+   * Adds one or more files. Incoming files with the same path are merged
+   * (sources/imports/exports concatenated), but existing cache entries are
+   * replaced — use {@link upsert} when you want to merge into the cache too.
+   */
+  add(...files: Array<FileNode>): Array<FileNode> {
+    return this.#store(files, false)
+  }
+
+  /**
+   * Adds or merges one or more files.
+   * If a file with the same path already exists in the cache, its
+   * sources/imports/exports are merged into the incoming file.
+   */
+  upsert(...files: Array<FileNode>): Array<FileNode> {
+    return this.#store(files, true)
+  }
+
+  #store(files: ReadonlyArray<FileNode>, mergeExisting: boolean): Array<FileNode> {
+    const resolvedFiles: Array<FileNode> = []
+    for (const file of mergeFilesByPath(files).values()) {
+      const existing = mergeExisting ? this.#cache.get(file.path) : undefined
+      const resolvedFile = createFile(existing ? mergeFile(existing, file) : file)
+      this.#cache.set(resolvedFile.path, resolvedFile)
+      resolvedFiles.push(resolvedFile)
+    }
+    this.#filesCache = null
+    return resolvedFiles
+  }
+
+  getByPath(path: string): FileNode | null {
+    return this.#cache.get(path) ?? null
+  }
+
+  deleteByPath(path: string): void {
+    this.#cache.delete(path)
+    this.#filesCache = null
+  }
+
+  clear(): void {
+    this.#cache.clear()
+    this.#filesCache = null
+  }
+
+  /**
+   * All stored files, sorted by path length (shorter paths first).
+   */
+  get files(): Array<FileNode> {
+    if (this.#filesCache) {
+      return this.#filesCache
+    }
+
+    this.#filesCache = [...this.#cache.values()].sort((a, b) => {
+      const lenDiff = a.path.length - b.path.length
+      if (lenDiff !== 0) return lenDiff
+      // Within the same length bucket, index.ts barrel files go last so other
+      // files are always processed before their barrel file.
+      const aIsIndex = a.path.endsWith('/index.ts') || a.path === 'index.ts'
+      const bIsIndex = b.path.endsWith('/index.ts') || b.path === 'index.ts'
+      if (aIsIndex && !bIsIndex) return 1
+      if (!aIsIndex && bIsIndex) return -1
+      return 0
+    })
+    return this.#filesCache
+  }
+}