@kubb/core 5.0.0-beta.109 → 5.0.0-beta.110

package/dist/index.cjs

@@ -157,7 +157,7 @@ function randomCliColor(text) {
 /**
 * Docs major version, derived from the package version so the link tracks the published major.
 */
-const docsMajor = "5.0.0-beta.109".split(".")[0] ?? "5";
+const docsMajor = "5.0.0-beta.110".split(".")[0] ?? "5";
 /**
 * Builds a type guard that narrows a {@link Diagnostic} to the variant for `kind`. A diagnostic
 * with no `kind` is treated as a `problem`.
@@ -585,14 +585,18 @@ var Diagnostics = class Diagnostics {
 * Merges the `output.mode` default into the output config and validates the combination.
 * Throws `KUBB_INVALID_PLUGIN_OPTIONS` when `mode: 'file'` is paired with a `group` option,
 * since a single-file output has nothing to group.
+*
+* An omitted `mode` follows the shape of `path`: an extension means a single file, anything
+* else is a directory. Plugin defaults such as `path: 'types'` name a directory, so they
+* generate without the caller spelling out `mode`.
 */
 function normalizeOutput({ output, group, pluginName }) {
-	const mode = output.mode ?? "file";
+	const mode = output.mode ?? (node_path.default.extname(output.path) ? "file" : "directory");
 	if (mode === "file" && group) throw new Diagnostics.Error({
 		code: require_usingCtx.diagnosticCode.invalidPluginOptions,
 		severity: "error",
-		message: `Plugin "${pluginName}" sets \`output.mode: 'file'\` but also configures a \`group\` option.`,
-		help: "A single-file output has nothing to group. Remove the `group` option, or use `output.mode: 'directory'` to organize files into subdirectories.",
+		message: `Plugin "${pluginName}" resolves \`output.mode\` to 'file' but also configures a \`group\` option.`,
+		help: "A single-file output has nothing to group. Remove the `group` option, give `output.path` an extensionless directory name, or set `output.mode: 'directory'` explicitly.",
 		location: { kind: "config" },
 		plugin: pluginName
 	});