@kubb/adapter-oas 5.11.4 → 5.11.5

package/dist/index.js

@@ -3,6 +3,7 @@ import { Diagnostics, ast, childName, enumPropName, extractRefName, macroDiscrim
 import { access, readFile } from "node:fs/promises";
 import { upgrade } from "@scalar/openapi-upgrader";
 import { bundle } from "api-ref-bundler";
+import * as yaml from "yaml";
 import { parse } from "yaml";
 //#endregion
 //#region kubb-extension.json
@@ -12,7 +13,7 @@ var compatibility = {
 };
 //#endregion
 //#region package.json
-var version = "5.11.4";
+var version = "5.11.5";
 //#endregion
 //#region src/constants.ts
 /**
@@ -2294,6 +2295,58 @@ function visit(node, pointer) {
 	if (node.type === "union" || node.type === "intersection" || node.type === "not") for (const [index, member] of (node.members ?? []).entries()) visit(member, `${pointer}/members/${index}`);
 }
 //#endregion
+//#region src/sourceLocator.ts
+const cache = /* @__PURE__ */ new Map();
+const toRange = ([start, end]) => ({
+	start,
+	end
+});
+const unescapeToken = (token) => token.replaceAll("~1", "/").replaceAll("~0", "~");
+/** Walks a JSON pointer through maps and sequences; the range is the last key or item it reached. */
+function findPointer(document, pointer) {
+	return pointer.replace(/^#/, "").split("/").slice(1).map(unescapeToken).reduce((at, token) => {
+		if (yaml.isMap(at?.node)) {
+			const pair = at.node.items.find((item) => yaml.isScalar(item.key) && String(item.key.value) === token);
+			return pair && yaml.isScalar(pair.key) && pair.key.range ? {
+				node: pair.value,
+				range: toRange(pair.key.range)
+			} : void 0;
+		}
+		if (yaml.isSeq(at?.node)) {
+			const item = at.node.items[Number(token)];
+			return yaml.isNode(item) && item.range ? {
+				node: item,
+				range: toRange(item.range)
+			} : void 0;
+		}
+	}, {
+		node: document.contents,
+		range: void 0
+	})?.range;
+}
+/** The first `$ref` whose value is `ref`. */
+function findRefUsage(document, ref) {
+	const found = [];
+	yaml.visit(document, { Pair(_, { key, value }) {
+		if (!yaml.isScalar(key) || key.value !== "$ref" || !yaml.isScalar(value) || value.value !== ref || !value.range) return;
+		found.push(toRange(value.range));
+		return yaml.visit.BREAK;
+	} });
+	return found[0];
+}
+/**
+* Maps OpenAPI JSON pointers and unresolved references to ranges in YAML or JSON source.
+*/
+const locate = (source, location) => {
+	if (!("pointer" in location)) return void 0;
+	if (!cache.has(source)) {
+		cache.clear();
+		cache.set(source, yaml.parseDocument(source));
+	}
+	const document = cache.get(source);
+	return findPointer(document, location.pointer) ?? ("ref" in location && location.ref ? findRefUsage(document, location.ref) : void 0);
+};
+//#endregion
 //#region src/adapter.ts
 /**
 * The `name` of `@kubb/adapter-oas`, used to identify this adapter in a Kubb config.
@@ -2448,6 +2501,7 @@ const adapterOas = defineExtension({
 			get document() {
 				return parsedDocument;
 			},
+			locate,
 			async validate(input, options) {
 				const document = await parseFromConfig({
 					type: "path",