@kubb/adapter-oas 5.0.0-beta.109 → 5.0.0-beta.110

package/dist/index.cjs

@@ -413,11 +413,20 @@ async function readSource(sourcePath) {
 /**
 * Reads and parses one source file or URL referenced during bundling: YAML/JSON is parsed into an
 * object, Markdown is returned as-is (bundled inline rather than dereferenced).
+*
+* JSON is valid YAML, so `yaml`'s `parse` handles both, but its general-purpose parser (comments,
+* anchors, block scalars, multi-document streams) does much more work than `JSON.parse` needs to.
+* `JSON.parse` runs first and fails fast on the first non-JSON character, so a real YAML document
+* falls through to `parse` at negligible cost.
 */
 async function resolveSource(sourcePath) {
 	const data = await readSource(sourcePath);
 	if (sourcePath.toLowerCase().endsWith(".md")) return data;
-	return (0, yaml.parse)(data);
+	try {
+		return JSON.parse(data);
+	} catch {
+		return (0, yaml.parse)(data);
+	}
 }
 /**
 * Throws a coded `KUBB_INPUT_NOT_FOUND` diagnostic when a local input path does not exist.
@@ -438,6 +447,19 @@ async function assertInputExists(input) {
 //#endregion
 //#region src/load/normalize.ts
 /**
+* True when `node` contains a `$ref` pointing outside the current document (a relative path,
+* absolute path, or URL). An internal `#/...` fragment does not count.
+*
+* `Object.values` reads array elements and object property values alike, so the same recursion
+* walks both without a separate array branch.
+*/
+function hasExternalRef(node) {
+	if (!node || typeof node !== "object") return false;
+	const ref = node.$ref;
+	if (typeof ref === "string" && !ref.startsWith("#")) return true;
+	return Object.values(node).some(hasExternalRef);
+}
+/**
 * Bundles a multi-file OpenAPI document into a single document via `api-ref-bundler`.
 *
 * External file schemas are hoisted into named `components.schemas` entries, so a property
@@ -445,6 +467,11 @@ async function assertInputExists(input) {
 * can then emit a named type with an import instead of inlining the shape. Sources are read with
 * the Bun-aware `read` util for local YAML and JSON files, and with `fetch` for HTTP(S) URLs.
 *
+* A document with no `$ref` outside itself has nothing to bundle, so it skips `api-ref-bundler`
+* and returns as parsed. `bundle` only rewrites external refs into internal ones; on an
+* all-internal document it is a no-op that still walks the whole tree to confirm that, which
+* costs real time on a large spec.
+*
 * @example Local file
 * `const document = await bundleDocument('./openapi.yaml')`
 *
@@ -461,7 +488,8 @@ async function bundleDocument(pathOrUrl) {
 		cache.set(key, result);
 		return result;
 	};
-	await resolver(pathOrUrl);
+	const root = await resolver(pathOrUrl);
+	if (typeof root === "object" && root !== null && !hasExternalRef(root)) return root;
 	return await (0, api_ref_bundler.bundle)(pathOrUrl, resolver);
 }
 /**