@kubb/core 5.12.7 → 5.13.0

package/dist/{Hookable-BRD9qP-V.js → Hookable-BR69O7aj.js}

@@ -3,7 +3,7 @@ import { satisfies } from "verkit";
 import { AsyncLocalStorage } from "node:async_hooks";
 import process$1 from "node:process";
 import { x } from "tinyexec";
-import { glob, mkdir, mkdtemp, readFile, rm, rm as rm$1, writeFile } from "node:fs/promises";
+import { access, glob, mkdir, mkdtemp, readFile, rm, rm as rm$1, writeFile } from "node:fs/promises";
 import path, { dirname, isAbsolute, join, relative, resolve, sep } from "node:path";
 import { existsSync as existsSync$1 } from "node:fs";
 import { stripVTControlCharacters, styleText } from "node:util";
@@ -19,7 +19,7 @@ var __name = (target, value) => __defProp(target, "name", {
 });
 //#endregion
 //#region package.json
-var version = "5.12.7";
+var version = "5.13.0";
 //#endregion
 //#region ../../internals/utils/src/casing.ts
 /**
@@ -102,20 +102,6 @@ function getErrorChain(error) {
 	return chain;
 }
 //#endregion
-//#region ../../internals/utils/src/jsonPointer.ts
-/**
-* Escapes a single JSON pointer reference token per RFC 6901 (`~` → `~0`, `/` → `~1`), so a
-* name holding those characters maps to a distinct pointer.
-*
-* @example
-* ```ts
-* escapePointerToken('/pets/{id}') // '~1pets~1{id}'
-* ```
-*/
-function escapePointerToken(token) {
-	return token.replaceAll("~", "~0").replaceAll("/", "~1");
-}
-//#endregion
 //#region ../../internals/utils/src/runtime.ts
 const isBun = typeof Bun !== "undefined";
 const isDeno = "Deno" in globalThis;
@@ -148,6 +134,21 @@ function detect() {
 //#endregion
 //#region ../../internals/utils/src/fs.ts
 /**
+* Resolves to `true` when the file or directory at `path` exists.
+* Uses `Bun.file().exists()` when running under Bun, `fs.access` otherwise.
+*
+* @example
+* ```ts
+* if (await exists('./kubb.config.ts')) {
+*   const content = await read('./kubb.config.ts')
+* }
+* ```
+*/
+async function exists(path) {
+	if (runtime.isBun) return Bun.file(path).exists();
+	return access(path).then(() => true, () => false);
+}
+/**
 * Reads the file at `path` as a UTF-8 string.
 * Uses `Bun.file().text()` when running under Bun, `fs.readFile` otherwise.
 *
@@ -1660,13 +1661,13 @@ var Resolver = class Resolver {
 		const resolveName = name ?? ((schemaName) => this.name(schemaName));
 		return collectImportedRefNames(node).map((schemaName) => ast.factory.createImport({
 			name: [resolveName(schemaName)],
-			path: this.file({
+			path: this.#resolveFilePath({
 				name: schemaName,
 				extname,
 				root,
 				output,
 				group
-			}).path
+			})
 		}));
 	}
 	/**
@@ -1825,19 +1826,13 @@ var Resolver = class Resolver {
 		});
 		return resolved;
 	}
-	/**
-	* Builds a `FileNode`. When `#filePath` (the resolver's `file.path`) is set it owns the whole
-	* path; otherwise the base name (from `#baseName`, the resolver's `file.baseName` or the
-	* built-in `toBaseName`) is placed by the `output.path`/`group` layout. The resolved file starts
-	* with empty `sources`, `imports`, and `exports`, which consumers populate separately.
-	*/
-	#resolveFile(options) {
-		const { name, extname, tag, path: groupPath, root, output, group } = options;
+	/** The absolute path `#resolveFile` places a file at. */
+	#resolveFilePath({ name, extname, tag, path: groupPath, root, output, group }) {
 		const baseName = this.#baseName({
 			name,
 			extname
 		});
-		const filePath = this.#filePath ? this.#resolveOverridePath(this.#filePath({
+		return this.#filePath ? this.#resolveOverridePath(this.#filePath({
 			baseName,
 			output
 		}), root) : this.#resolvePath({
@@ -1848,6 +1843,15 @@ var Resolver = class Resolver {
 			output,
 			group
 		});
+	}
+	/**
+	* Builds a `FileNode`. When `#filePath` (the resolver's `file.path`) is set it owns the whole
+	* path; otherwise the base name (from `#baseName`, the resolver's `file.baseName` or the
+	* built-in `toBaseName`) is placed by the `output.path`/`group` layout. The resolved file starts
+	* with empty `sources`, `imports`, and `exports`, which consumers populate separately.
+	*/
+	#resolveFile(options) {
+		const filePath = this.#resolveFilePath(options);
 		return ast.factory.createFile({
 			path: filePath,
 			baseName: path.basename(filePath),
@@ -2119,6 +2123,17 @@ function createProgress(files, config, hooks) {
 		if (updates.length) await hooks.callHook("kubb:files:processing:update", { files: updates });
 	};
 }
+/** Links each source without a pointer to the node its file was generated from. */
+function withPointer(files, pointer) {
+	if (!pointer) return files;
+	return files.map((file) => ({
+		...file,
+		sources: file.sources.map((source) => source.pointer ? source : {
+			...source,
+			pointer
+		})
+	}));
+}
 /**
 * In-memory file store for generated files, and the writer that turns them into source
 * strings on `storage`. Files sharing a `path` are merged (sources/imports/exports
@@ -2137,6 +2152,7 @@ var FileManager = class {
 	#cache = /* @__PURE__ */ new Map();
 	#pending = /* @__PURE__ */ new Set();
 	#sorted = null;
+	#merges = /* @__PURE__ */ new WeakSet();
 	add(...files) {
 		return this.#store(files, false);
 	}
@@ -2144,18 +2160,18 @@ var FileManager = class {
 		return this.#store(files, true);
 	}
 	/** Stores a generator result: a file array is upserted as is, an element renders through `renderer` first, falsy is a no-op. */
-	async dispatch({ result, renderer }) {
+	async dispatch({ result, renderer, pointer }) {
 		try {
 			var _usingCtx$1 = _usingCtx();
 			if (!result) return;
 			if (Array.isArray(result)) {
-				this.#defer(result);
+				this.#defer(withPointer(result, pointer));
 				return;
 			}
 			if (!renderer) return;
 			const instance = _usingCtx$1.u(renderer());
 			await instance.render(result);
-			this.#defer(instance.files);
+			this.#defer(withPointer(instance.files, pointer));
 		} catch (_) {
 			_usingCtx$1.e = _;
 		} finally {
@@ -2165,9 +2181,24 @@ var FileManager = class {
 	/** Upserts without normalizing: the raw merge waits in `#pending` until the file is read. */
 	#defer(files) {
 		for (const file of files) {
-			const existing = this.#cache.get(file.path);
-			this.#cache.set(file.path, existing ? mergeFile(existing, file) : file);
 			this.#pending.add(file.path);
+			const existing = this.#cache.get(file.path);
+			if (!existing) {
+				this.#cache.set(file.path, file);
+				continue;
+			}
+			if (!this.#merges.has(existing)) {
+				const merged = mergeFile(existing, file);
+				this.#merges.add(merged);
+				this.#cache.set(file.path, merged);
+				continue;
+			}
+			existing.banner = file.banner;
+			existing.footer = file.footer;
+			existing.copy = file.copy ?? existing.copy;
+			existing.sources.push(...file.sources);
+			existing.imports.push(...file.imports);
+			existing.exports.push(...file.exports);
 		}
 		if (files.length > 0) this.#sorted = null;
 	}
@@ -2346,24 +2377,23 @@ function assertPluginEntry(entry, index) {
 	});
 }
 /**
-* Where a generator crashed: a label naming the node and, when the node has one, a JSON pointer
-* to it. Built from the node fields so core stays adapter-agnostic.
+* Where a generator crashed: a label naming the node and, when the adapter set one, the node's
+* pointer into the input.
 */
 function getCrashSite(node) {
-	if (node.kind === "Schema") return node.name ? {
-		label: `schema "${node.name}"`,
-		location: {
+	if (node.kind === "Schema") return {
+		label: node.name ? `schema "${node.name}"` : "an inline schema",
+		location: node.pointer ? {
 			kind: "schema",
-			pointer: `#/components/schemas/${escapePointerToken(node.name)}`
-		}
-	} : { label: "an inline schema" };
-	if (!node.method || !node.path) return { label: `operation "${node.operationId}"` };
+			pointer: node.pointer
+		} : void 0
+	};
 	return {
-		label: `operation "${node.operationId}" (${node.method.toUpperCase()} ${node.path})`,
-		location: {
+		label: node.method && node.path ? `operation "${node.operationId}" (${node.method.toUpperCase()} ${node.path})` : `operation "${node.operationId}"`,
+		location: node.pointer ? {
 			kind: "operation",
-			pointer: `#/paths/${escapePointerToken(node.path)}/${node.method.toLowerCase()}`
-		}
+			pointer: node.pointer
+		} : void 0
 	};
 }
 var KubbDriver = class {
@@ -2651,6 +2681,7 @@ var KubbDriver = class {
 					hooks,
 					config
 				});
+				await this.adapter?.settle?.();
 				await hooks.callHook("kubb:build:end", {
 					files: this.fileManager.files,
 					config,
@@ -2658,6 +2689,7 @@ var KubbDriver = class {
 				});
 				return { diagnostics: Diagnostics.dedupe(diagnostics) };
 			} catch (caughtError) {
+				await this.adapter?.settle?.();
 				diagnostics.push(Diagnostics.from(caughtError));
 				return { diagnostics: Diagnostics.dedupe(diagnostics) };
 			}
@@ -2886,7 +2918,8 @@ var KubbDriver = class {
 			if (!(generator.match ? await generator.match(node, ctx) : true)) continue;
 			await this.fileManager.dispatch({
 				result: await generate(generator),
-				renderer: generator.renderer
+				renderer: generator.renderer,
+				pointer: node.pointer
 			});
 		}
 	}
@@ -3115,6 +3148,6 @@ var Hookable = class {
 	}
 };
 //#endregion
-export { formatMs as A, toError as B, useConfig as C, defineExtension as D, checkCompatibility as E, listFiles as F, __name as H, read as I, rm$1 as L, inParallel as M, existsSync$1 as N, resolveMeta as O, isPathInside as P, write as R, tryUseKubb as S, useOptions as T, camelCase as V, kubbContext as _, FileManager as a, setOptions as b, Resolver as c, isPublicAddress as d, assertPluginOption as f, injectFile as g, addMacro as h, createNodeCache as i, getElapsedMs as j, Diagnostics as k, getInputKind as l, addGenerator as m, KubbDriver as n, _usingCtx as o, definePlugin as p, pluginNotFoundError as r, createResolver as s, Hookable as t, checkoutGitInput as u, requirePlugin as v, useKubb as w, setResolver as x, setMacros as y, writeRaw as z };
+export { formatMs as A, writeRaw as B, useConfig as C, defineExtension as D, checkCompatibility as E, isPathInside as F, camelCase as H, listFiles as I, read as L, inParallel as M, exists as N, resolveMeta as O, existsSync$1 as P, rm$1 as R, tryUseKubb as S, useOptions as T, __name as U, toError as V, kubbContext as _, FileManager as a, setOptions as b, Resolver as c, isPublicAddress as d, assertPluginOption as f, injectFile as g, addMacro as h, createNodeCache as i, getElapsedMs as j, Diagnostics as k, getInputKind as l, addGenerator as m, KubbDriver as n, _usingCtx as o, definePlugin as p, pluginNotFoundError as r, createResolver as s, Hookable as t, checkoutGitInput as u, requirePlugin as v, useKubb as w, setResolver as x, setMacros as y, write as z };
 
-//# sourceMappingURL=Hookable-BRD9qP-V.js.map
+//# sourceMappingURL=Hookable-BR69O7aj.js.map