@kubb/core 4.34.0 → 4.35.0

package/dist/hooks.d.ts

@@ -1,5 +1,5 @@
 import { t as __name } from "./chunk--u3MIqq1.js";
-import { D as PluginManager, d as Plugin, p as PluginFactoryOptions } from "./types-DfjjJb2r.js";
+import { M as PluginManager, _ as PluginFactoryOptions, h as Plugin } from "./types-7DgxNmCG.js";
 import { KubbFile } from "@kubb/fabric-core/types";
 
 //#region src/hooks/useMode.d.ts

package/dist/index.cjs

@@ -3,16 +3,19 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 const require_chunk = require("./chunk-ByKO4r7w.cjs");
-let node_path = require("node:path");
-node_path = require_chunk.__toESM(node_path);
 let node_events = require("node:events");
 let node_util = require("node:util");
 let node_fs = require("node:fs");
 let node_fs_promises = require("node:fs/promises");
+let node_path = require("node:path");
+node_path = require_chunk.__toESM(node_path);
+let _kubb_ast = require("@kubb/ast");
 let _kubb_react_fabric = require("@kubb/react-fabric");
 let _kubb_react_fabric_parsers = require("@kubb/react-fabric/parsers");
 let _kubb_react_fabric_plugins = require("@kubb/react-fabric/plugins");
 let node_perf_hooks = require("node:perf_hooks");
+let fflate = require("fflate");
+let tinyexec = require("tinyexec");
 let node_process = require("node:process");
 let node_module = require("node:module");
 node_module = require_chunk.__toESM(node_module);
@@ -23,7 +26,6 @@ let empathic_package = require("empathic/package");
 empathic_package = require_chunk.__toESM(empathic_package);
 let semver = require("semver");
 let remeda = require("remeda");
-let tinyexec = require("tinyexec");
 //#region ../../internals/utils/dist/index.js
 /** Thrown when a plugin's configuration or input fails validation. */
 var ValidationPluginError = class extends Error {};
@@ -670,6 +672,9 @@ function defineConfig(config) {
 function isInputPath(config) {
 	return typeof config?.input === "object" && config.input !== null && "path" in config.input;
 }
+//#endregion
+//#region src/constants.ts
+const DEFAULT_STUDIO_URL = "https://studio.kubb.dev";
 const BARREL_FILENAME = "index.ts";
 const DEFAULT_BANNER = "simple";
 const DEFAULT_EXTENSION = { ".ts": ".ts" };
@@ -729,6 +734,50 @@ const formatters = {
 	}
 };
 //#endregion
+//#region src/devtools.ts
+/**
+* Encodes a `RootNode` as a compressed, URL-safe string.
+*
+* The JSON representation is deflate-compressed with {@link deflateSync} before
+* base64url encoding, which typically reduces payload size by 70–80 % and
+* keeps URLs well within browser and server path-length limits.
+*
+* Use {@link decodeAst} to reverse.
+*/
+function encodeAst(root) {
+	const compressed = (0, fflate.deflateSync)(new TextEncoder().encode(JSON.stringify(root)));
+	return Buffer.from(compressed).toString("base64url");
+}
+/**
+* Constructs the Kubb Studio URL for the given `RootNode`.
+* When `options.ast` is `true`, navigates to the AST inspector (`/ast`).
+* The `root` is encoded and attached as the `?root=` query parameter so Studio
+* can decode and render it without a round-trip to any server.
+*/
+function getStudioUrl(root, studioUrl, options = {}) {
+	return `${studioUrl.replace(/\/$/, "")}${options.ast ? "/ast" : ""}?root=${encodeAst(root)}`;
+}
+/**
+* Opens the Kubb Studio URL for the given `RootNode` in the default browser —
+*
+* Falls back to printing the URL if the browser cannot be launched.
+*/
+async function openInStudio(root, studioUrl, options = {}) {
+	const url = getStudioUrl(root, studioUrl, options);
+	const cmd = process.platform === "win32" ? "cmd" : process.platform === "darwin" ? "open" : "xdg-open";
+	const args = process.platform === "win32" ? [
+		"/c",
+		"start",
+		"",
+		url
+	] : [url];
+	try {
+		await (0, tinyexec.x)(cmd, args);
+	} catch {
+		console.log(`\n  ${url}\n`);
+	}
+}
+//#endregion
 //#region ../../node_modules/.pnpm/yocto-queue@1.2.2/node_modules/yocto-queue/index.js
 var Node = class {
 	value;
@@ -915,6 +964,12 @@ function getMode(fileOrFolder) {
 var PluginManager = class {
 	config;
 	options;
+	/**
+	* The universal `@kubb/ast` `RootNode` produced by the adapter, set by
+	* the build pipeline after the adapter's `parse()` resolves.
+	*/
+	rootNode = void 0;
+	#studioIsOpen = false;
 	#plugins = /* @__PURE__ */ new Set();
 	#usedPluginNames = {};
 	#promiseManager;
@@ -932,6 +987,7 @@ var PluginManager = class {
 	}
 	getContext(plugin) {
 		const plugins = [...this.#plugins];
+		const pluginManager = this;
 		const baseContext = {
 			fabric: this.options.fabric,
 			config: this.config,
@@ -944,6 +1000,17 @@ var PluginManager = class {
 			},
 			upsertFile: async (...files) => {
 				await this.options.fabric.upsertFile(...files);
+			},
+			get rootNode() {
+				return pluginManager.rootNode;
+			},
+			openInStudio(options) {
+				if (typeof pluginManager.config.devtools !== "object") throw new Error("Devtools must be an object");
+				if (!pluginManager.rootNode) throw new Error("RootNode is not defined, make sure you have set the parser in kubb.config.ts");
+				if (pluginManager.#studioIsOpen) return;
+				pluginManager.#studioIsOpen = true;
+				const studioUrl = pluginManager.config.devtools?.studioUrl ?? "https://studio.kubb.dev";
+				return openInStudio(pluginManager.rootNode, studioUrl, options);
 			}
 		};
 		const mergedExtras = {};
@@ -1301,7 +1368,7 @@ var PluginManager = class {
 };
 //#endregion
 //#region package.json
-var version = "4.34.0";
+var version = "4.35.0";
 //#endregion
 //#region src/utils/diagnostics.ts
 /**
@@ -1363,6 +1430,10 @@ async function setup(options) {
 			defaultBanner: DEFAULT_BANNER,
 			...userConfig.output
 		},
+		devtools: userConfig.devtools ? {
+			studioUrl: DEFAULT_STUDIO_URL,
+			...typeof userConfig.devtools === "boolean" ? {} : userConfig.devtools
+		} : void 0,
 		plugins: userConfig.plugins
 	};
 	if (definedConfig.output.clean) {
@@ -1409,14 +1480,31 @@ async function setup(options) {
 			`  • Barrel type: ${definedConfig.output.barrelType || "none"}`
 		]
 	});
+	const pluginManager = new PluginManager(definedConfig, {
+		fabric,
+		events,
+		concurrency: 15
+	});
+	if (definedConfig.adapter) {
+		const source = inputToAdapterSource(definedConfig);
+		await events.emit("debug", {
+			date: /* @__PURE__ */ new Date(),
+			logs: [`Running adapter: ${definedConfig.adapter.name}`]
+		});
+		pluginManager.rootNode = await definedConfig.adapter.parse(source);
+		await events.emit("debug", {
+			date: /* @__PURE__ */ new Date(),
+			logs: [
+				`✓ Adapter '${definedConfig.adapter.name}' resolved RootNode`,
+				`  • Schemas: ${pluginManager.rootNode.schemas.length}`,
+				`  • Operations: ${pluginManager.rootNode.operations.length}`
+			]
+		});
+	}
 	return {
 		events,
 		fabric,
-		pluginManager: new PluginManager(definedConfig, {
-			fabric,
-			events,
-			concurrency: 15
-		}),
+		pluginManager,
 		sources
 	};
 }
@@ -1571,6 +1659,44 @@ function buildBarrelExports({ barrelFiles, rootDir, existingExports, config, plu
 		});
 	});
 }
+/**
+* Maps the resolved `Config['input']` shape into an `AdapterSource` that
+* the adapter's `parse()` can consume.
+*/
+function inputToAdapterSource(config) {
+	if (Array.isArray(config.input)) return {
+		type: "paths",
+		paths: config.input.map((i) => (0, node_path.resolve)(config.root, i.path))
+	};
+	if ("data" in config.input) return {
+		type: "data",
+		data: config.input.data
+	};
+	return {
+		type: "path",
+		path: (0, node_path.resolve)(config.root, config.input.path)
+	};
+}
+//#endregion
+//#region src/defineAdapter.ts
+/**
+* Wraps an adapter builder to make the options parameter optional.
+*
+* @example
+* ```ts
+* export const adapterOas = defineAdapter<OasAdapter>((options) => {
+*   const { validate = true, dateType = 'string' } = options
+*   return {
+*     name: adapterOasName,
+*     options: { validate, dateType, ... },
+*     parse(source) { ... },
+*   }
+* })
+* ```
+*/
+function defineAdapter(build) {
+	return (options) => build(options ?? {});
+}
 //#endregion
 //#region src/defineLogger.ts
 function defineLogger(logger) {
@@ -2037,15 +2163,23 @@ async function detectLinter() {
 	]) if (await isLinterAvailable(linter)) return linter;
 }
 //#endregion
+exports.AsyncEventEmitter = AsyncEventEmitter;
 exports.FunctionParams = FunctionParams;
 exports.PackageManager = PackageManager;
 exports.PluginManager = PluginManager;
 exports.PromiseManager = PromiseManager;
 exports.build = build;
 exports.default = build;
+exports.defineAdapter = defineAdapter;
 exports.defineConfig = defineConfig;
 exports.defineLogger = defineLogger;
 exports.definePlugin = definePlugin;
+Object.defineProperty(exports, "definePrinter", {
+	enumerable: true,
+	get: function() {
+		return _kubb_ast.definePrinter;
+	}
+});
 exports.detectFormatter = detectFormatter;
 exports.detectLinter = detectLinter;
 exports.formatters = formatters;