@kubb/core 5.0.0-alpha.54 → 5.0.0-alpha.56

package/dist/index.js

@@ -1,10 +1,10 @@
 import { t as __name } from "./chunk--u3MIqq1.js";
-import { c as DEFAULT_EXTENSION, d as camelCase, i as defineResolver, l as DEFAULT_STUDIO_URL, n as applyHookResult, o as BARREL_FILENAME, r as FileManager, s as DEFAULT_BANNER, t as PluginDriver, u as logLevel } from "./PluginDriver-BU7faPiI.js";
+import { a as DEFAULT_BANNER, c as logLevel, i as defineResolver, l as camelCase, n as applyHookResult, o as DEFAULT_EXTENSION, r as FileManager, s as DEFAULT_STUDIO_URL, t as PluginDriver } from "./PluginDriver-Cn9cRX4m.js";
 import { EventEmitter } from "node:events";
 import { access, mkdir, readFile, readdir, rm, writeFile } from "node:fs/promises";
-import path, { dirname, join, posix, resolve } from "node:path";
+import { dirname, join, resolve } from "node:path";
 import * as ast from "@kubb/ast";
-import { createExport, createFile, createSource, extractStringsFromNodes, transform, walk } from "@kubb/ast";
+import { extractStringsFromNodes, transform, walk } from "@kubb/ast";
 import { version } from "node:process";
 //#region ../../internals/utils/src/errors.ts
 /**
@@ -181,29 +181,6 @@ function formatMs(ms) {
 //#endregion
 //#region ../../internals/utils/src/fs.ts
 /**
-* Converts all backslashes to forward slashes.
-* Extended-length Windows paths (`\\?\...`) are left unchanged.
-*/
-function toSlash(p) {
-	if (p.startsWith("\\\\?\\")) return p;
-	return p.replaceAll("\\", "/");
-}
-/**
-* Returns the relative path from `rootDir` to `filePath`, always using forward slashes
-* and prefixed with `./` when not already traversing upward.
-*
-* @example
-* ```ts
-* getRelativePath('/src/components', '/src/components/Button.tsx') // './Button.tsx'
-* getRelativePath('/src/components', '/src/utils/helpers.ts')      // '../utils/helpers.ts'
-* ```
-*/
-function getRelativePath(rootDir, filePath) {
-	if (!rootDir || !filePath) throw new Error(`Root and file should be filled in when retrieving the relativePath, ${rootDir || ""} ${filePath || ""}`);
-	const relativePath = posix.relative(toSlash(rootDir), toSlash(filePath));
-	return relativePath.startsWith("../") ? relativePath : `./${relativePath}`;
-}
-/**
 * Resolves to `true` when the file or directory at `path` exists.
 * Uses `Bun.file().exists()` when running under Bun, `fs.access` otherwise.
 *
@@ -737,7 +714,7 @@ const fsStorage = createStorage(() => ({
 }));
 //#endregion
 //#region package.json
-var version$1 = "5.0.0-alpha.54";
+var version$1 = "5.0.0-alpha.56";
 //#endregion
 //#region src/utils/diagnostics.ts
 /**
@@ -756,239 +733,6 @@ function getDiagnosticInfo() {
 	};
 }
 //#endregion
-//#region src/utils/TreeNode.ts
-/**
-* Tree structure used to build per-directory barrel (`index.ts`) files from a
-* flat list of generated {@link FileNode} entries.
-*
-* Each node represents either a directory or a file within the output tree.
-* Use {@link TreeNode.build} to construct a root node from a file list, then
-* traverse with {@link TreeNode.forEach}, {@link TreeNode.leaves}, or the
-* `*Deep` helpers.
-*/
-var TreeNode = class TreeNode {
-	data;
-	parent;
-	children = [];
-	#cachedLeaves = void 0;
-	constructor(data, parent) {
-		this.data = data;
-		this.parent = parent;
-	}
-	addChild(data) {
-		const child = new TreeNode(data, this);
-		if (!this.children) this.children = [];
-		this.children.push(child);
-		return child;
-	}
-	/**
-	* Returns the root ancestor of this node, walking up via `parent` links.
-	*/
-	get root() {
-		if (!this.parent) return this;
-		return this.parent.root;
-	}
-	/**
-	* Returns all leaf descendants (nodes with no children) of this node.
-	*
-	* Results are cached after the first traversal.
-	*/
-	get leaves() {
-		if (!this.children || this.children.length === 0) return [this];
-		if (this.#cachedLeaves) return this.#cachedLeaves;
-		const leaves = [];
-		for (const child of this.children) leaves.push(...child.leaves);
-		this.#cachedLeaves = leaves;
-		return leaves;
-	}
-	/**
-	* Visits this node and every descendant in depth-first order.
-	*/
-	forEach(callback) {
-		if (typeof callback !== "function") throw new TypeError("forEach() callback must be a function");
-		callback(this);
-		for (const child of this.children) child.forEach(callback);
-		return this;
-	}
-	/**
-	* Finds the first leaf that satisfies `predicate`, or `undefined` when none match.
-	*/
-	findDeep(predicate) {
-		if (typeof predicate !== "function") throw new TypeError("find() predicate must be a function");
-		return this.leaves.find(predicate);
-	}
-	/**
-	* Calls `callback` for every leaf of this node.
-	*/
-	forEachDeep(callback) {
-		if (typeof callback !== "function") throw new TypeError("forEach() callback must be a function");
-		this.leaves.forEach(callback);
-	}
-	/**
-	* Returns all leaves that satisfy `callback`.
-	*/
-	filterDeep(callback) {
-		if (typeof callback !== "function") throw new TypeError("filter() callback must be a function");
-		return this.leaves.filter(callback);
-	}
-	/**
-	* Maps every leaf through `callback` and returns the resulting array.
-	*/
-	mapDeep(callback) {
-		if (typeof callback !== "function") throw new TypeError("map() callback must be a function");
-		return this.leaves.map(callback);
-	}
-	/**
-	* Builds a {@link TreeNode} tree from a flat list of files.
-	*
-	* - Filters to files under `root` (when provided) and skips `.json` files.
-	* - Returns `null` when no files match.
-	*/
-	static build(files, root) {
-		try {
-			const filteredTree = buildDirectoryTree(files, root);
-			if (!filteredTree) return null;
-			const treeNode = new TreeNode({
-				name: filteredTree.name,
-				path: filteredTree.path,
-				file: filteredTree.file,
-				type: PluginDriver.getMode(filteredTree.path)
-			});
-			const recurse = (node, item) => {
-				const subNode = node.addChild({
-					name: item.name,
-					path: item.path,
-					file: item.file,
-					type: PluginDriver.getMode(item.path)
-				});
-				if (item.children?.length) item.children?.forEach((child) => {
-					recurse(subNode, child);
-				});
-			};
-			filteredTree.children?.forEach((child) => {
-				recurse(treeNode, child);
-			});
-			return treeNode;
-		} catch (error) {
-			throw new Error("Something went wrong with creating barrel files with the TreeNode class", { cause: error });
-		}
-	}
-};
-const normalizePath = (p) => p.replaceAll("\\", "/");
-function buildDirectoryTree(files, rootFolder = "") {
-	const normalizedRootFolder = normalizePath(rootFolder);
-	const rootPrefix = normalizedRootFolder.endsWith("/") ? normalizedRootFolder : `${normalizedRootFolder}/`;
-	const filteredFiles = files.filter((file) => {
-		const normalizedFilePath = normalizePath(file.path);
-		return rootFolder ? normalizedFilePath.startsWith(rootPrefix) && !normalizedFilePath.endsWith(".json") : !normalizedFilePath.endsWith(".json");
-	});
-	if (filteredFiles.length === 0) return null;
-	const root = {
-		name: rootFolder || "",
-		path: rootFolder || "",
-		children: []
-	};
-	filteredFiles.forEach((file) => {
-		const parts = file.path.slice(rootFolder.length).split("/").filter(Boolean);
-		let currentLevel = root.children;
-		let currentPath = normalizePath(rootFolder);
-		parts.forEach((part, index) => {
-			currentPath = path.posix.join(currentPath, part);
-			let existingNode = currentLevel.find((node) => node.name === part);
-			if (!existingNode) {
-				if (index === parts.length - 1) existingNode = {
-					name: part,
-					file,
-					path: currentPath
-				};
-				else existingNode = {
-					name: part,
-					path: currentPath,
-					children: []
-				};
-				currentLevel.push(existingNode);
-			}
-			if (!existingNode.file) currentLevel = existingNode.children;
-		});
-	});
-	return root;
-}
-//#endregion
-//#region src/utils/getBarrelFiles.ts
-function getBarrelFilesByRoot(root, files) {
-	const cachedFiles = /* @__PURE__ */ new Map();
-	TreeNode.build(files, root)?.forEach((treeNode) => {
-		if (!treeNode?.children || !treeNode.parent?.data.path) return;
-		const barrelFile = createFile({
-			path: join(treeNode.parent?.data.path, BARREL_FILENAME),
-			baseName: BARREL_FILENAME,
-			exports: [],
-			imports: [],
-			sources: []
-		});
-		const previousBarrelFile = cachedFiles.get(barrelFile.path);
-		treeNode.leaves.forEach((item) => {
-			if (!item.data.name) return;
-			(item.data.file?.sources || []).forEach((source) => {
-				if (!item.data.file?.path || !source.isIndexable || !source.name) return;
-				if (previousBarrelFile?.sources.some((item) => item.name === source.name && item.isTypeOnly === source.isTypeOnly)) return;
-				barrelFile.exports.push(createExport({
-					name: [source.name],
-					path: getRelativePath(treeNode.parent?.data.path, item.data.path),
-					isTypeOnly: source.isTypeOnly
-				}));
-				barrelFile.sources.push(createSource({
-					name: source.name,
-					isTypeOnly: source.isTypeOnly,
-					isExportable: false,
-					isIndexable: false
-				}));
-			});
-		});
-		if (previousBarrelFile) {
-			previousBarrelFile.sources.push(...barrelFile.sources);
-			previousBarrelFile.exports.push(...barrelFile.exports);
-		} else cachedFiles.set(barrelFile.path, barrelFile);
-	});
-	return [...cachedFiles.values()];
-}
-function trimExtName(text) {
-	const dotIndex = text.lastIndexOf(".");
-	if (dotIndex > 0 && !text.includes("/", dotIndex)) return text.slice(0, dotIndex);
-	return text;
-}
-/**
-* Generates `index.ts` barrel files for all directories under `root/output.path`.
-*
-* - Returns an empty array when `type` is falsy or `'propagate'`.
-* - Skips generation when the output path itself ends with `index` (already a barrel).
-* - When `type` is `'all'`, strips named exports so every re-export becomes a wildcard (`export * from`).
-* - Attaches `meta` to each barrel file for downstream plugin identification.
-*/
-async function getBarrelFiles(files, { type, meta = {}, root, output }) {
-	if (!type || type === "propagate") return [];
-	const pathToBuildFrom = join(root, output.path);
-	if (trimExtName(pathToBuildFrom).endsWith("index")) return [];
-	const barrelFiles = getBarrelFilesByRoot(pathToBuildFrom, files);
-	if (type === "all") return barrelFiles.map((file) => {
-		return {
-			...file,
-			exports: file.exports.map((exportItem) => {
-				return {
-					...exportItem,
-					name: void 0
-				};
-			})
-		};
-	});
-	return barrelFiles.map((indexFile) => {
-		return {
-			...indexFile,
-			meta
-		};
-	});
-}
-//#endregion
 //#region src/utils/isInputPath.ts
 function isInputPath(config) {
 	return typeof config?.input === "object" && config.input !== null && "path" in config.input;
@@ -1038,7 +782,6 @@ async function setup(userConfig, options = {}) {
 		adapter: userConfig.adapter,
 		output: {
 			write: true,
-			barrelType: "named",
 			extension: DEFAULT_EXTENSION,
 			defaultBanner: DEFAULT_BANNER,
 			...userConfig.output
@@ -1058,6 +801,7 @@ async function setup(userConfig, options = {}) {
 		await storage?.clear(resolve(config.root, config.output.path));
 	}
 	const driver = new PluginDriver(config, { hooks });
+	for (const middleware of config.middleware ?? []) middleware.install(hooks);
 	const adapter = config.adapter;
 	if (!adapter) throw new Error("No adapter configured. Please provide an adapter in your kubb.config.ts.");
 	const source = inputToAdapterSource(config);
@@ -1166,13 +910,15 @@ async function safeBuild(setupResult) {
 			config,
 			adapter: driver.adapter,
 			inputNode: driver.inputNode,
-			getPlugin: driver.getPlugin.bind(driver)
+			getPlugin: driver.getPlugin.bind(driver),
+			get files() {
+				return driver.fileManager.files;
+			},
+			upsertFile: (...files) => driver.fileManager.upsert(...files)
 		});
 		for (const plugin of driver.plugins.values()) {
 			const context = driver.getContext(plugin);
 			const hrStart = process.hrtime();
-			const { output } = plugin.options ?? {};
-			const root = resolve(config.root, config.output.path);
 			try {
 				const timestamp = /* @__PURE__ */ new Date();
 				await hooks.emit("kubb:plugin:start", { plugin });
@@ -1181,15 +927,6 @@ async function safeBuild(setupResult) {
 					logs: ["Starting plugin...", `  • Plugin Name: ${plugin.name}`]
 				});
 				if (plugin.generators?.length || driver.hasRegisteredGenerators(plugin.name)) await runPluginAstHooks(plugin, context);
-				if (output) {
-					const barrelFiles = await getBarrelFiles(driver.fileManager.files, {
-						type: output.barrelType ?? "named",
-						root,
-						output,
-						meta: { pluginName: plugin.name }
-					});
-					await context.upsertFile(...barrelFiles);
-				}
 				const duration = getElapsedMs(hrStart);
 				pluginTimings.set(plugin.name, duration);
 				await hooks.emit("kubb:plugin:end", {
@@ -1227,45 +964,13 @@ async function safeBuild(setupResult) {
 				});
 			}
 		}
-		if (config.output.barrelType) {
-			const rootPath = resolve(resolve(config.root), config.output.path, BARREL_FILENAME);
-			const rootDir = dirname(rootPath);
-			await hooks.emit("kubb:debug", {
-				date: /* @__PURE__ */ new Date(),
-				logs: [
-					"Generating barrel file",
-					`  • Type: ${config.output.barrelType}`,
-					`  • Path: ${rootPath}`
-				]
-			});
-			const barrelFiles = driver.fileManager.files.filter((file) => {
-				return file.sources.some((source) => source.isIndexable);
-			});
-			await hooks.emit("kubb:debug", {
-				date: /* @__PURE__ */ new Date(),
-				logs: [`Found ${barrelFiles.length} indexable files for barrel export`]
-			});
-			const existingBarrel = driver.fileManager.files.find((f) => f.path === rootPath);
-			const rootFile = createFile({
-				path: rootPath,
-				baseName: BARREL_FILENAME,
-				exports: buildBarrelExports({
-					barrelFiles,
-					rootDir,
-					existingExports: new Set(existingBarrel?.exports?.flatMap((e) => Array.isArray(e.name) ? e.name : [e.name]).filter((n) => Boolean(n)) ?? []),
-					config,
-					driver
-				}).map((e) => createExport(e)),
-				sources: [],
-				imports: [],
-				meta: {}
-			});
-			driver.fileManager.upsert(rootFile);
-			await hooks.emit("kubb:debug", {
-				date: /* @__PURE__ */ new Date(),
-				logs: [`✓ Generated barrel file (${rootFile.exports?.length || 0} exports)`]
-			});
-		}
+		await hooks.emit("kubb:plugins:end", {
+			config,
+			get files() {
+				return driver.fileManager.files;
+			},
+			upsertFile: (...files) => driver.fileManager.upsert(...files)
+		});
 		const files = driver.fileManager.files;
 		const parsersMap = /* @__PURE__ */ new Map();
 		for (const parser of config.parsers) if (parser.extNames) for (const extname of parser.extNames) parsersMap.set(extname, parser);
@@ -1343,26 +1048,6 @@ async function build(setupResult) {
 		sources
 	};
 }
-function buildBarrelExports({ barrelFiles, rootDir, existingExports, config, driver }) {
-	const pluginNameMap = /* @__PURE__ */ new Map();
-	for (const plugin of driver.plugins.values()) pluginNameMap.set(plugin.name, plugin);
-	return barrelFiles.flatMap((file) => {
-		const containsOnlyTypes = file.sources?.every((source) => source.isTypeOnly);
-		return (file.sources ?? []).flatMap((source) => {
-			if (!file.path || !source.isIndexable) return [];
-			const meta = file.meta;
-			const pluginOptions = (meta?.pluginName ? pluginNameMap.get(meta.pluginName) : void 0)?.options;
-			if (!pluginOptions || pluginOptions.output?.barrelType === false) return [];
-			const exportName = config.output.barrelType === "all" ? void 0 : source.name ? [source.name] : void 0;
-			if (exportName?.some((n) => existingExports.has(n))) return [];
-			return [createExport({
-				name: exportName,
-				path: getRelativePath(rootDir, file.path),
-				isTypeOnly: config.output.barrelType === "all" ? containsOnlyTypes : source.isTypeOnly
-			})];
-		});
-	});
-}
 function inputToAdapterSource(config) {
 	if (Array.isArray(config.input)) return {
 		type: "paths",
@@ -1491,6 +1176,28 @@ function defineLogger(logger) {
 	return logger;
 }
 //#endregion
+//#region src/defineMiddleware.ts
+/**
+* Identity factory for middleware.
+* Returns the middleware object unchanged but provides a typed entry-point
+* to define middleware with proper inference.
+*
+* @example
+* ```ts
+* export const myMiddleware = defineMiddleware({
+*   name: 'my-middleware',
+*   install(hooks) {
+*     hooks.on('kubb:build:end', ({ files }) => {
+*       console.log(`Build complete with ${files.length} files`)
+*     })
+*   },
+* })
+* ```
+*/
+function defineMiddleware(middleware) {
+	return middleware;
+}
+//#endregion
 //#region src/defineParser.ts
 /**
 * Defines a parser with type safety.
@@ -1593,6 +1300,6 @@ const memoryStorage = createStorage(() => {
 	};
 });
 //#endregion
-export { AsyncEventEmitter, FileManager, FileProcessor, PluginDriver, URLPath, ast, createAdapter, createKubb, createRenderer, createStorage, defineGenerator, defineLogger, defineParser, definePlugin, defineResolver, fsStorage, isInputPath, logLevel, memoryStorage };
+export { AsyncEventEmitter, FileManager, FileProcessor, PluginDriver, URLPath, ast, createAdapter, createKubb, createRenderer, createStorage, defineGenerator, defineLogger, defineMiddleware, defineParser, definePlugin, defineResolver, fsStorage, isInputPath, logLevel, memoryStorage };
 
 //# sourceMappingURL=index.js.map