@kubb/core 5.0.0-alpha.53 → 5.0.0-alpha.55

package/dist/index.cjs

@@ -1,9 +1,8 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_PluginDriver = require("./PluginDriver-DUJnMDK5.cjs");
+const require_PluginDriver = require("./PluginDriver-6bHJKAZ6.cjs");
 let node_events = require("node:events");
 let node_fs_promises = require("node:fs/promises");
 let node_path = require("node:path");
-node_path = require_PluginDriver.__toESM(node_path, 1);
 let _kubb_ast = require("@kubb/ast");
 _kubb_ast = require_PluginDriver.__toESM(_kubb_ast, 1);
 let node_process = require("node:process");
@@ -182,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 = node_path.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.
 *
@@ -735,7 +711,7 @@ const fsStorage = createStorage(() => ({
 }));
 //#endregion
 //#region package.json
-var version = "5.0.0-alpha.53";
+var version = "5.0.0-alpha.55";
 //#endregion
 //#region src/utils/diagnostics.ts
 /**
@@ -754,239 +730,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: require_PluginDriver.PluginDriver.getMode(filteredTree.path)
-			});
-			const recurse = (node, item) => {
-				const subNode = node.addChild({
-					name: item.name,
-					path: item.path,
-					file: item.file,
-					type: require_PluginDriver.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 = node_path.default.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 = (0, _kubb_ast.createFile)({
-			path: (0, node_path.join)(treeNode.parent?.data.path, require_PluginDriver.BARREL_FILENAME),
-			baseName: require_PluginDriver.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((0, _kubb_ast.createExport)({
-					name: [source.name],
-					path: getRelativePath(treeNode.parent?.data.path, item.data.path),
-					isTypeOnly: source.isTypeOnly
-				}));
-				barrelFile.sources.push((0, _kubb_ast.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 = (0, node_path.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;
@@ -1036,7 +779,6 @@ async function setup(userConfig, options = {}) {
 		adapter: userConfig.adapter,
 		output: {
 			write: true,
-			barrelType: "named",
 			extension: require_PluginDriver.DEFAULT_EXTENSION,
 			defaultBanner: require_PluginDriver.DEFAULT_BANNER,
 			...userConfig.output
@@ -1056,6 +798,7 @@ async function setup(userConfig, options = {}) {
 		await storage?.clear((0, node_path.resolve)(config.root, config.output.path));
 	}
 	const driver = new require_PluginDriver.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);
@@ -1164,13 +907,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 = (0, node_path.resolve)(config.root, config.output.path);
 			try {
 				const timestamp = /* @__PURE__ */ new Date();
 				await hooks.emit("kubb:plugin:start", { plugin });
@@ -1179,15 +924,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", {
@@ -1225,45 +961,6 @@ async function safeBuild(setupResult) {
 				});
 			}
 		}
-		if (config.output.barrelType) {
-			const rootPath = (0, node_path.resolve)((0, node_path.resolve)(config.root), config.output.path, require_PluginDriver.BARREL_FILENAME);
-			const rootDir = (0, node_path.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 = (0, _kubb_ast.createFile)({
-				path: rootPath,
-				baseName: require_PluginDriver.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) => (0, _kubb_ast.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)`]
-			});
-		}
 		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);
@@ -1341,26 +1038,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 [(0, _kubb_ast.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",
@@ -1489,6 +1166,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.
@@ -1608,6 +1307,7 @@ exports.createRenderer = createRenderer;
 exports.createStorage = createStorage;
 exports.defineGenerator = defineGenerator;
 exports.defineLogger = defineLogger;
+exports.defineMiddleware = defineMiddleware;
 exports.defineParser = defineParser;
 exports.definePlugin = definePlugin;
 exports.defineResolver = require_PluginDriver.defineResolver;