sv 0.12.7 → 0.12.8

package/dist/bin.mjs

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 import { f as program, l as from, r as detectPackageManager, u as Command } from "./package-manager-BYzDyeam.mjs";
-import { a as helpConfig, i as forwardExitCode, n as add, o as name, r as create, s as version } from "./engine-v9g2eGJ2.mjs";
+import { a as helpConfig, i as forwardExitCode, n as add, o as name, r as create, s as version } from "./engine-DUNH7ELq.mjs";
 import { color, resolveCommand } from "@sveltejs/sv-utils";
 import process from "node:process";
 import { execSync } from "node:child_process";
@@ -60,6 +60,7 @@ async function runMigrate(cwd$1, args) {
 console.log();
 program.name(name).version(version, "-v, --version").configureHelp(helpConfig);
 program.addCommand(create).addCommand(add).addCommand(migrate).addCommand(check);
+if (process.argv.includes("--help") || process.argv.includes("-h")) program.addHelpText("after", () => "\n" + create.helpInformation());
 program.parse();
 
 //#endregion

package/dist/{engine-v9g2eGJ2.mjs → engine-DUNH7ELq.mjs}

@@ -2742,7 +2742,7 @@ function getAddonDetails(id) {
 //#endregion
 //#region package.json
 var name = "sv";
-var version = "0.12.7";
+var version = "0.12.8";
 
 //#endregion
 //#region src/core/errors.ts
@@ -2796,8 +2796,57 @@ function formatDescription(arg) {
 	if (arg.argChoices !== void 0 && String(arg.argChoices)) output += color.dim(` (choices: ${arg.argChoices.join(", ")})`);
 	return output;
 }
+/**
+* Returns standard help sections and a formatItem helper.
+* Used by `add` and `create` custom `formatHelp` to avoid duplicating boilerplate.
+*/
+function getHelpSections(cmd, helper) {
+	const termWidth = helper.padWidth(cmd, helper);
+	const helpWidth = helper.helpWidth ?? 80;
+	function formatItem(term, description$1) {
+		return helper.formatItem(term, termWidth, description$1, helper);
+	}
+	const usage = [`${helper.styleTitle("Usage:")} ${helper.styleUsage(helper.commandUsage(cmd))}`, ""];
+	const descText = helper.commandDescription(cmd);
+	const description = descText.length > 0 ? [helper.boxWrap(helper.styleCommandDescription(descText), helpWidth), ""] : [];
+	const argItems = helper.visibleArguments(cmd).map((argument) => formatItem(helper.styleArgumentTerm(helper.argumentTerm(argument)), helper.styleArgumentDescription(helper.argumentDescription(argument))));
+	const arguments_ = argItems.length > 0 ? [
+		helper.styleTitle("Arguments:"),
+		...argItems,
+		""
+	] : [];
+	const optItems = helper.visibleOptions(cmd).map((option) => formatItem(helper.styleOptionTerm(helper.optionTerm(option)), helper.styleOptionDescription(helper.optionDescription(option))));
+	const options$8 = optItems.length > 0 ? [
+		helper.styleTitle("Options:"),
+		...optItems,
+		""
+	] : [];
+	const globalOptItems = helper.showGlobalOptions ? helper.visibleGlobalOptions(cmd).map((option) => formatItem(helper.styleOptionTerm(helper.optionTerm(option)), helper.styleOptionDescription(helper.optionDescription(option)))) : [];
+	const globalOptions = globalOptItems.length > 0 ? [
+		helper.styleTitle("Global Options:"),
+		...globalOptItems,
+		""
+	] : [];
+	const cmdItems = helper.visibleCommands(cmd).map((sub) => formatItem(helper.styleSubcommandTerm(helper.subcommandTerm(sub)), helper.styleSubcommandDescription(helper.subcommandDescription(sub))));
+	const commands = cmdItems.length > 0 ? [
+		helper.styleTitle("Commands:"),
+		...cmdItems,
+		""
+	] : [];
+	return {
+		formatItem,
+		styleTitle: helper.styleTitle.bind(helper),
+		usage,
+		description,
+		arguments: arguments_,
+		options: options$8,
+		globalOptions,
+		commands
+	};
+}
 async function runCommand(action) {
 	try {
+		console.log(color.hidden("HINT: Run \"sv --help\" to get the full list of commands, add-ons, and examples to one-shot and skip interactive prompts."));
 		Nt(`Welcome to the Svelte CLI! ${color.optional(`(v${version})`)}`);
 		const minimumVersion = "18.3.0";
 		if (isVersionUnsupportedBelow(process$1.versions.node, minimumVersion)) R.warn(`You are using Node.js ${color.error(process$1.versions.node)}, please upgrade to Node.js ${color.success(minimumVersion)} or higher.`);
@@ -5918,7 +5967,7 @@ const templateChoices = templates.map((t) => t.name);
 const langOption = new Option("--types <lang>", "add type checking").choices(langs);
 const templateOption = new Option("--template <type>", "template to scaffold").choices(templateChoices);
 const noAddonsOption = new Option("--no-add-ons", "do not prompt to add add-ons").conflicts("add");
-const addOption = new Option("--add <addon...>", "add-on to include").default([]);
+const addOption = new Option("--add <addon...>", "add-ons to include (see Add-Ons section below)").default([]);
 const noDownloadCheckOption = new Option("--no-download-check", "skip all download confirmation prompts");
 const noInstallOption = new Option("--no-install", "skip installing dependencies");
 const ProjectPathSchema = optional(string());
@@ -5932,7 +5981,32 @@ const OptionsSchema$1 = strictObject({
 	dirCheck: boolean(),
 	downloadCheck: boolean()
 });
-const create = new Command("create").description("scaffolds a new SvelteKit project").argument("[path]", "where the project will be created").addOption(templateOption).addOption(langOption).option("--no-types").addOption(noAddonsOption).addOption(addOption).addOption(noInstallOption).option("--from-playground <url>", "create a project from the svelte playground").option("--no-dir-check", "even if the folder is not empty, no prompt will be shown").addOption(noDownloadCheckOption).addOption(installOption).configureHelp(helpConfig).action((projectPath, opts) => {
+const create = new Command("create").description("Scaffold a new project (--add to include add-ons)").argument("[path]", "where the project will be created").addOption(templateOption).addOption(langOption).option("--no-types").addOption(noAddonsOption).addOption(addOption).addOption(noInstallOption).option("--from-playground <url>", "create a project from the svelte playground").option("--no-dir-check", "even if the folder is not empty, no prompt will be shown").addOption(noDownloadCheckOption).addOption(installOption).configureHelp({
+	...helpConfig,
+	formatHelp(cmd, helper) {
+		const s = getHelpSections(cmd, helper);
+		const addonSection = formatAddonHelpSection({
+			styleTitle: s.styleTitle,
+			formatItem: (term, desc) => s.formatItem(helper.styleArgumentTerm(term), helper.styleArgumentDescription(desc))
+		});
+		return [
+			...s.usage,
+			...s.description,
+			...s.arguments,
+			...s.options,
+			...addonSection,
+			s.styleTitle("Non-interactive usage:"),
+			"  Provide --template, --types, --add, and --install (or --no-install) to skip prompts entirely.",
+			"  Note: --add and --no-add-ons cannot be used together.",
+			"",
+			s.styleTitle("Examples:"),
+			"  sv create my-app --template minimal --types ts --add prettier eslint --install pnpm",
+			"  sv create my-app --template minimal --types ts --add prettier vitest=\"usages:unit\" tailwindcss=\"plugins:none\" --install pnpm",
+			"  sv create my-app --template minimal --types ts --add drizzle=\"database:postgresql+client:postgres.js\" --no-install",
+			""
+		].join("\n");
+	}
+}).action((projectPath, opts) => {
 	const cwd$1 = parse$1(ProjectPathSchema, projectPath);
 	const options$8 = parse$1(OptionsSchema$1, opts);
 	if (options$8.fromPlayground && !validatePlaygroundUrl(options$8.fromPlayground)) {
@@ -6270,58 +6344,25 @@ const defaultCwd = defaultPkgPath ? path.dirname(defaultPkgPath) : void 0;
 const add$1 = new Command("add").description("applies specified add-ons into a project").argument("[add-on...]", `add-ons to install`, (value, previous = []) => addonArgsHandler(previous, value)).option("-C, --cwd <path>", "path to working directory", defaultCwd).option("--no-git-check", "even if some files are dirty, no prompt will be shown").addOption(noDownloadCheckOption).addOption(noInstallOption).addOption(installOption).configureHelp({
 	...helpConfig,
 	formatHelp(cmd, helper) {
-		const termWidth = helper.padWidth(cmd, helper);
-		const helpWidth = helper.helpWidth ?? 80;
-		function callFormatItem(term, description) {
-			return helper.formatItem(term, termWidth, description, helper);
-		}
-		let output = [`${helper.styleTitle("Usage:")} ${helper.styleUsage(helper.commandUsage(cmd))}`, ""];
-		const commandDescription = helper.commandDescription(cmd);
-		if (commandDescription.length > 0) output = output.concat([helper.boxWrap(helper.styleCommandDescription(commandDescription), helpWidth), ""]);
-		const argumentList = helper.visibleArguments(cmd).map((argument) => {
-			return callFormatItem(helper.styleArgumentTerm(helper.argumentTerm(argument)), helper.styleArgumentDescription(helper.argumentDescription(argument)));
-		});
-		if (argumentList.length > 0) output = output.concat([
-			helper.styleTitle("Arguments:"),
-			...argumentList,
-			""
-		]);
-		const addonList = addonOptions.map((option) => {
-			const description = option.choices;
-			return callFormatItem(helper.styleArgumentTerm(option.id), helper.styleArgumentDescription(description));
+		const s = getHelpSections(cmd, helper);
+		const addonSection = formatAddonHelpSection({
+			styleTitle: s.styleTitle,
+			formatItem: (term, desc) => s.formatItem(helper.styleArgumentTerm(term), helper.styleArgumentDescription(desc))
 		});
-		if (addonList.length > 0) output = output.concat([
-			helper.styleTitle("Add-On Options:"),
-			...addonList,
+		return [
+			...s.usage,
+			...s.description,
+			...s.arguments,
+			...addonSection,
+			...s.options,
+			...s.globalOptions,
+			...s.commands,
+			s.styleTitle("Examples:"),
+			"  sv add prettier eslint",
+			"  sv add vitest=\"usages:unit\" tailwindcss=\"plugins:none\"",
+			"  sv add drizzle=\"database:postgresql+client:postgres.js+docker:yes\"",
 			""
-		]);
-		const optionList = helper.visibleOptions(cmd).map((option) => {
-			return callFormatItem(helper.styleOptionTerm(helper.optionTerm(option)), helper.styleOptionDescription(helper.optionDescription(option)));
-		});
-		if (optionList.length > 0) output = output.concat([
-			helper.styleTitle("Options:"),
-			...optionList,
-			""
-		]);
-		if (helper.showGlobalOptions) {
-			const globalOptionList = helper.visibleGlobalOptions(cmd).map((option) => {
-				return callFormatItem(helper.styleOptionTerm(helper.optionTerm(option)), helper.styleOptionDescription(helper.optionDescription(option)));
-			});
-			if (globalOptionList.length > 0) output = output.concat([
-				helper.styleTitle("Global Options:"),
-				...globalOptionList,
-				""
-			]);
-		}
-		const commandList = helper.visibleCommands(cmd).map((cmd$1) => {
-			return callFormatItem(helper.styleSubcommandTerm(helper.subcommandTerm(cmd$1)), helper.styleSubcommandDescription(helper.subcommandDescription(cmd$1)));
-		});
-		if (commandList.length > 0) output = output.concat([
-			helper.styleTitle("Commands:"),
-			...commandList,
-			""
-		]);
-		return output.join("\n");
+		].join("\n");
 	}
 }).action(async (addonInputs, opts) => {
 	if (opts.cwd === void 0) errorAndExit("Invalid workspace: Please verify that you are inside of a Svelte project. You can also specify the working directory with `--cwd <path>`");
@@ -6691,68 +6732,92 @@ function addonArgsHandler(acc, current) {
 	}
 	return acc;
 }
+function getOfficialAddonIds() {
+	return officialAddons.map((a) => a.id);
+}
 function getAddonOptionFlags() {
 	const options$8 = [];
 	for (const addon of officialAddons) {
 		const id = addon.id;
 		const details = getAddonDetails(id);
 		if (Object.values(details.options).length === 0) continue;
-		const { defaults, groups } = getOptionChoices(details);
-		const choices = Object.entries(groups).map(([group, choices$1]) => `${color.optional(`${group}:`)} ${color.dim(choices$1.join(", "))}`).join("\n");
-		const preset = defaults.join(", ") || "none";
+		const { groups, groupDefaults } = getOptionChoices(details);
+		const choices = Object.entries(groups).map(([group, choices$1]) => {
+			const defaults = groupDefaults[group];
+			const defaultStr = defaults === void 0 ? "" : defaults.length > 0 ? ` (default: ${defaults.join(", ")})` : " (default: none)";
+			return `${color.optional(`${group}:`)} ${color.dim(choices$1.join(", "))}${defaultStr}`;
+		}).join("\n");
 		options$8.push({
 			id,
-			choices,
-			preset
+			choices
 		});
 	}
 	return options$8;
 }
+/**
+* Shared addon help section used by `add --help`, `create --help`, and `sv --help`.
+* Returns formatted lines showing all addons, their options, and syntax examples.
+*/
+function formatAddonHelpSection(opts) {
+	const { styleTitle, formatItem } = opts;
+	const output = [];
+	const allIds = getOfficialAddonIds();
+	const withOptionsMap = new Map(addonOptions.map((o) => [o.id, o]));
+	const addonList = allIds.map((id) => {
+		const option = withOptionsMap.get(id);
+		if (!option) return formatItem(id, "(no options)");
+		return formatItem(id, option.choices);
+	});
+	if (addonList.length > 0) output.push(styleTitle("Add-Ons:"), ...addonList, "");
+	output.push(styleTitle("Add-On Syntax:"), "  <addon>                               add with defaults (may still prompt)", "  <addon>=<opt>:<val>                   set a single option", "  <addon>=<opt1>:<val1>+<opt2>:<val2>   set multiple options", "  <addon>=<opt>:none                    explicitly set no value (for multiselect)", "  To skip prompts, explicitly set ALL options (use defaults shown above).", "");
+	return output;
+}
 function getOptionChoices(details) {
 	const choices = [];
-	const defaults = [];
 	const groups = {};
+	const groupDefaults = {};
 	const options$8 = {};
 	for (const [id, question] of Object.entries(details.options)) {
 		let values = [];
 		const applyDefault = question.condition?.(options$8) !== false;
+		const groupId = question.group ?? id;
+		groupDefaults[groupId] ??= [];
 		if (question.type === "boolean") {
 			values = ["yes", `no`];
 			if (applyDefault) {
 				options$8[id] = question.default;
-				defaults.push(question.default ? values[0] : values[1]);
+				groupDefaults[groupId].push(question.default ? values[0] : values[1]);
 			}
 		}
 		if (question.type === "select") {
 			values = question.options.map((o) => o.value);
 			if (applyDefault) {
 				options$8[id] = question.default;
-				defaults.push(question.default);
+				groupDefaults[groupId].push(question.default);
 			}
 		}
 		if (question.type === "multiselect") {
 			values = question.options.map((o) => o.value);
 			if (applyDefault) {
 				options$8[id] = question.default;
-				defaults.push(...question.default);
+				groupDefaults[groupId].push(...question.default);
 			}
 		}
 		if (question.type === "string" || question.type === "number") {
 			values = ["<user-input>"];
 			if (applyDefault && question.default !== void 0) {
 				options$8[id] = question.default;
-				defaults.push(question.default.toString());
+				groupDefaults[groupId].push(question.default.toString());
 			}
 		}
 		choices.push(...values);
-		const groupId = question.group ?? id;
 		groups[groupId] ??= [];
 		groups[groupId].push(...values);
 	}
 	return {
 		choices,
-		defaults,
-		groups
+		groups,
+		groupDefaults
 	};
 }
 async function resolveNonOfficialAddons(refs, downloadCheck) {

package/dist/src/index.mjs

@@ -1,4 +1,4 @@
 import { p as create } from "../package-manager-BYzDyeam.mjs";
-import { c as officialAddons, l as defineAddon, t as add, u as defineAddonOptions } from "../engine-v9g2eGJ2.mjs";
+import { c as officialAddons, l as defineAddon, t as add, u as defineAddonOptions } from "../engine-DUNH7ELq.mjs";
 
 export { add, create, defineAddon, defineAddonOptions, officialAddons };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sv",
-  "version": "0.12.7",
+  "version": "0.12.8",
   "type": "module",
   "description": "A command line interface (CLI) for creating and maintaining Svelte applications",
   "license": "MIT",
@@ -25,7 +25,7 @@
     }
   },
   "dependencies": {
-    "@sveltejs/sv-utils": "0.0.2"
+    "@sveltejs/sv-utils": "0.0.3"
   },
   "devDependencies": {
     "@clack/prompts": "1.0.0",