@kubb/studio 5.12.3 → 5.12.5

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import { J as SnapshotUploadMetadata, R as PublishedSnapshot, a as AgentConnectInfo, c as AgentPermissions, f as ConfigEditOutcome, j as InstalledExtensions, s as AgentPermission, u as ConfigEdit } from "./protocol-WYICLbSg.cjs";
+import { Y as SnapshotUploadMetadata, a as AgentConnectInfo, c as AgentPermissions, f as ConfigEditOutcome, j as InstalledExtensions, s as AgentPermission, u as ConfigEdit, z as PublishedSnapshot } from "./protocol-C4loKcxw.cjs";
 import { Config, Hookable, KubbHooks } from "@kubb/core";
 //#region src/connect.d.ts
 /**

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { J as SnapshotUploadMetadata, R as PublishedSnapshot, a as AgentConnectInfo, c as AgentPermissions, f as ConfigEditOutcome, j as InstalledExtensions, s as AgentPermission, u as ConfigEdit } from "./protocol-WYICLbSg.js";
+import { Y as SnapshotUploadMetadata, a as AgentConnectInfo, c as AgentPermissions, f as ConfigEditOutcome, j as InstalledExtensions, s as AgentPermission, u as ConfigEdit, z as PublishedSnapshot } from "./protocol-C4loKcxw.js";
 import { Config, Hookable, KubbHooks } from "@kubb/core";
 //#region src/connect.d.ts
 /**

package/dist/index.js

@@ -31,12 +31,23 @@ import { gzipSync } from "node:zlib";
 *
 * When `pascal` is `true` the first word is also capitalized (PascalCase), otherwise only subsequent words are.
 */
-function toCamelOrPascal(text, pascal) {
+function convert(text, pascal) {
 	return text.trim().replace(/([a-z\d])([A-Z])/g, "$1 $2").replace(/([A-Z]+)([A-Z][a-z])/g, "$1 $2").replace(/(\d)([a-z])/g, "$1 $2").split(/[\s\-_./\\:]+/).filter(Boolean).map((word, i) => {
 		if (word.length > 1 && word === word.toUpperCase()) return word;
 		return (i === 0 && !pascal ? word.charAt(0).toLowerCase() : word.charAt(0).toUpperCase()) + word.slice(1);
 	}).join("").replace(/[^a-zA-Z0-9]/g, "");
 }
+const cache = /* @__PURE__ */ new Map();
+const cacheLimit = 1e4;
+function toCamelOrPascal(text, pascal) {
+	const key = `${pascal ? "P" : "c"}${text}`;
+	const cached = cache.get(key);
+	if (cached !== void 0) return cached;
+	const result = convert(text, pascal);
+	if (cache.size >= cacheLimit) cache.clear();
+	cache.set(key, result);
+	return result;
+}
 /**
 * Converts `text` to camelCase.
 *
@@ -202,7 +213,7 @@ function getElapsedMs(hrStart) {
 }
 //#endregion
 //#region package.json
-var version = "5.12.3";
+var version = "5.12.5";
 //#endregion
 //#region src/resolveConfig.ts
 /**
@@ -558,6 +569,44 @@ async function rebuildExtension({ disk, studioOptions, kind, extensions }) {
 		});
 	}))(mergeOptions(disk.options ?? {}, studioOptions));
 }
+/** The root `output` members Studio may set, with the values each takes. The rest, `path` and `postGenerate` among them, stay with the config file. */
+const OUTPUT_VALUES = {
+	barrel: (value) => value === false || isPlainObject(value) && Object.keys(value).length === 1 && (value.type === "named" || value.type === "all"),
+	format: (value) => value === false || [
+		"auto",
+		"prettier",
+		"biome",
+		"oxfmt"
+	].includes(value),
+	lint: (value) => value === false || [
+		"auto",
+		"eslint",
+		"biome",
+		"oxlint"
+	].includes(value),
+	clean: (value) => typeof value === "boolean",
+	defaultBanner: (value) => value === false || value === "simple" || value === "full"
+};
+/** Whether Studio may set the root `output` member `key`. */
+function isOutputKey(key) {
+	return Object.hasOwn(OUTPUT_VALUES, key);
+}
+/** Whether Studio may set the root `output` member `key` to `value`. */
+function isOutputValue({ key, value }) {
+	return isOutputKey(key) && OUTPUT_VALUES[key](value);
+}
+/** The members of `output` Studio may see and set. */
+function pickOutput(output) {
+	return Object.fromEntries(Object.entries(output).filter(([key]) => isOutputKey(key)));
+}
+/** Merges Studio's valid `output` overrides, with `null` unsetting a member. */
+function mergeOutput({ output, studio }) {
+	if (!isPlainObject(studio)) return output;
+	return mergeOptions(output, Object.fromEntries(Object.entries(studio).filter(([key, value]) => value === null ? isOutputKey(key) : isOutputValue({
+		key,
+		value
+	}))));
+}
 /**
 * Merges Studio-provided adapter option overrides into the disk config's adapter, see {@link rebuildExtension}.
 */
@@ -615,14 +664,16 @@ function invalidEdit(edit) {
 	if (typeof operation !== "string" || !OPERATIONS.has(operation)) return `unknown operation ${JSON.stringify(operation)}`;
 	if (config !== void 0 && typeof config !== "string" && !Number.isSafeInteger(config)) return "config must name an entry or give its index";
 	if (operation === ConfigEditOperation.SET_INPUT) return typeof input === "string" && input.trim() ? void 0 : "the edit names no input";
-	if (typeof plugin !== "string" || !plugin) return "the edit names no plugin";
+	const isOutput = operation === ConfigEditOperation.SET_OUTPUT || operation === ConfigEditOperation.REMOVE_OUTPUT;
+	if (!isOutput && (typeof plugin !== "string" || !plugin)) return "the edit names no plugin";
 	if (kind !== void 0 && (typeof kind !== "string" || !KINDS.has(kind))) return `unknown kind ${JSON.stringify(kind)}`;
 	if (kind !== void 0 && operation !== ConfigEditOperation.SET && operation !== ConfigEditOperation.REMOVE) return `${operation} edits the plugins array, so it takes no kind`;
-	if (operation === ConfigEditOperation.SET || operation === ConfigEditOperation.REMOVE) {
+	if (isOutput || operation === ConfigEditOperation.SET || operation === ConfigEditOperation.REMOVE) {
 		if (!Array.isArray(path) || !path.every((key) => typeof key === "string" && key)) return "path must be a list of option names";
 		if (!path.length) return "no option path given";
 		const unsafe = path.find((key) => !isSafeKey(key));
 		if (unsafe !== void 0) return `${unsafe} cannot be used as an option name`;
+		if (isOutput && !isOutputKey(path[0])) return `output.${path[0]} can only be changed in the config file`;
 	}
 }
 /** Where a node sits in the source text. */
@@ -923,9 +974,12 @@ function readPartial(node, prefix = []) {
 }
 /** The top-level options of a plugin call, each flagged with whether Studio may write it. */
 function readOptions(call) {
-	const entries = {};
 	const options = call.arguments[0];
-	if (options?.type !== "ObjectExpression") return entries;
+	return options?.type === "ObjectExpression" ? readObject(options) : {};
+}
+/** The members of an object literal, each flagged with whether Studio may write it. */
+function readObject(options) {
+	const entries = {};
 	for (const [index, entry] of options.properties.entries()) {
 		const key = memberKey(entry);
 		if (key === void 0 || !isSafeKey(key)) continue;
@@ -998,11 +1052,13 @@ function readConfig(source) {
 			});
 			const [adapter] = factoryCalls(mod, config, "adapter").map(toView);
 			const parsers = factoryCalls(mod, config, "parser").map(toView);
+			const output = outputObject(config);
 			return {
 				name: configName(config),
 				plugins,
 				...adapter && { adapter },
-				...parsers.length ? { parsers } : {}
+				...parsers.length ? { parsers } : {},
+				...!("reason" in output) && { output: pickOutput(readObject(output.object)) }
 			};
 		})
 	};
@@ -1051,6 +1107,16 @@ function applySet(source, call, path, value, quote) {
 		return { source: splice(source, closing, closing, printValue(nest(path, value), quote)) };
 	}
 	if (options.type !== "ObjectExpression") return { reason: "the factory was not called with an object literal" };
+	return setIn({
+		source,
+		options,
+		path,
+		value,
+		quote
+	});
+}
+/** Writes the literal `value` at `path` inside `options`, adding any intermediate object it needs. */
+function setIn({ source, options, path, value, quote }) {
 	const target = walk(options, path);
 	if ("reason" in target) return target;
 	if ("missing" in target) {
@@ -1068,6 +1134,34 @@ function applySetInput(source, config, input, quote) {
 	if (isShadowed(config, found.index)) return { reason: "a spread after input could override it" };
 	return { source: splice(source, rangeOf(found.member.value).start, rangeOf(found.member.value).end, value) };
 }
+/** The config's root `output` object literal, or why Studio cannot edit inside it. */
+function outputObject(config) {
+	const found = findMember(config, "output");
+	if (found?.member.type !== "ObjectProperty" || found.member.value.type !== "ObjectExpression") return { reason: "output is not an object literal" };
+	if (isShadowed(config, found.index)) return { reason: "a spread after output could override it" };
+	return { object: found.member.value };
+}
+/** Writes or drops a member of the config's root `output` object. */
+function applyOutputEdit({ source, config, edit, quote }) {
+	const output = outputObject(config);
+	if ("reason" in output) return output;
+	if (edit.operation === ConfigEditOperation.REMOVE_OUTPUT) return removeIn({
+		source,
+		options: output.object,
+		path: edit.path
+	});
+	if (!isOptionValue(edit.value) || !isOutputValue({
+		key: edit.path[0],
+		value: nest(edit.path.slice(1), edit.value)
+	})) return { reason: `the value is not one output.${edit.path[0]} takes` };
+	return setIn({
+		source,
+		options: output.object,
+		path: edit.path,
+		value: edit.value,
+		quote
+	});
+}
 /**
 * Deletes the option at `path`, falling the plugin back to its default for it. An option the file
 * does not set already has its default, so removing it changes nothing.
@@ -1076,6 +1170,14 @@ function applyRemove(source, call, path) {
 	const options = call.arguments[0];
 	if (!options) return { source };
 	if (options.type !== "ObjectExpression") return { reason: "the factory was not called with an object literal" };
+	return removeIn({
+		source,
+		options,
+		path
+	});
+}
+/** Deletes the member at `path` inside `options`. A path that is not there already holds its default. */
+function removeIn({ source, options, path }) {
 	const target = walk(options, path);
 	if ("reason" in target) return target;
 	if ("missing" in target) return { source };
@@ -1165,6 +1267,12 @@ function applyEdit({ source, edit, quote, extensions }) {
 	const config = findConfig(parsed);
 	if (!config) return { reason: `no config entry found for ${JSON.stringify(ref)}` };
 	if (edit.operation === ConfigEditOperation.SET_INPUT) return applySetInput(source, config, edit.input, quote);
+	if (edit.operation === ConfigEditOperation.SET_OUTPUT || edit.operation === ConfigEditOperation.REMOVE_OUTPUT) return applyOutputEdit({
+		source,
+		config,
+		edit,
+		quote
+	});
 	if (edit.operation === ConfigEditOperation.DISABLE_PLUGIN) {
 		const result = disablePlugin(source, parsed.mod, config, edit.plugin);
 		if (!("reason" in result) || !result.reason.includes("shares a line")) return result;
@@ -2364,6 +2472,10 @@ var Agent = class extends RpcTarget {
 				...config,
 				root,
 				input: checkout?.path ?? studioInput ?? config.input,
+				output: mergeOutput({
+					output: config.output,
+					studio: patch?.output
+				}),
 				storage: outputRoot ? stagingStorage({
 					root,
 					directory: outputRoot
@@ -2823,6 +2935,7 @@ function toEntryView(config, extensions) {
 		...config.name !== void 0 && { name: config.name },
 		...input !== void 0 && { input },
 		output: config.output.path,
+		outputOptions: toJSONOptions(pickOutput(config.output)),
 		plugins: config.plugins.map((plugin) => ({
 			name: toStudioName({
 				name: resolveMeta(plugin).name,