@variablelab/vland 0.3.6 → 0.3.7

package/README.md

@@ -47,19 +47,21 @@ All templates target Node.js, use pnpm, and ship [`@rrlab/cli`](https://github.c
 
 ## Shell completion
 
-`vland` ships a `completion` subcommand that prints a shell-specific script. Add it to your shell rc file:
+`vland` ships a `completion` subcommand that prints a shell-specific script. Add a guarded eval to your shell rc file:
 
 ```sh
 # zsh — ~/.zshrc
-eval "$(vland completion zsh)"
+command -v vland >/dev/null 2>&1 && eval "$(vland completion zsh 2>/dev/null)"
 
 # bash — ~/.bashrc
-eval "$(vland completion bash)"
+command -v vland >/dev/null 2>&1 && eval "$(vland completion bash 2>/dev/null)"
 
 # fish — ~/.config/fish/config.fish
-vland completion fish | source
+command -v vland >/dev/null 2>&1; and vland completion fish 2>/dev/null | source
 ```
 
+The `command -v` guard skips the line when no `vland` is on `PATH`. The `2>/dev/null` covers a mise shim with no active version: it passes the guard, then fails on stderr. If completion doesn't load, run `vland completion zsh` by hand to see why.
+
 **Prerequisite:** the [`usage`](https://usage.jdx.dev) CLI must be on your `PATH` (it powers completion at runtime). Install via one of:
 
 ```sh

package/dist/cli.usage.kdl

@@ -1,11 +1,11 @@
 // @generated by @usage-spec/commander from Commander.js metadata
 name vland
 bin vland
-version "0.3.6"
+version "0.3.7"
 usage "[options] [command]"
 flag --usage help="print KDL spec for this CLI (https://kdl.dev)"
 cmd completion help="print shell completion script (usage)" {
-	long_help "Prints a shell completion script for vland. Add to your shell rc file:\n\n  bash: eval \"$(vland completion bash)\"\n  zsh:  eval \"$(vland completion zsh)\"\n  fish: vland completion fish | source"
+	long_help "Prints a shell completion script for vland. Add your shell's line to its rc file:\n\n    # bash — ~/.bashrc\n    command -v vland >/dev/null 2>&1 && eval \"$(vland completion bash 2>/dev/null)\"\n\n    # zsh — ~/.zshrc\n    command -v vland >/dev/null 2>&1 && eval \"$(vland completion zsh 2>/dev/null)\"\n\n    # fish — ~/.config/fish/config.fish\n    command -v vland >/dev/null 2>&1; and vland completion fish 2>/dev/null | source"
 	arg <shell> help="target shell" {
 		choices bash zsh fish
 	}

package/dist/run.mjs

@@ -56,11 +56,16 @@ const SHELLS = [
 	"fish"
 ];
 function createCompletionCommand() {
-	return createCommand("completion").summary(`print shell completion script (${TOOL_LABELS.USAGE})`).description(`Prints a shell completion script for vland. Add to your shell rc file:
+	return createCommand("completion").summary(`print shell completion script (${TOOL_LABELS.USAGE})`).description(`Prints a shell completion script for vland. Add your shell's line to its rc file:
 
-  bash: eval "$(vland completion bash)"
-  zsh:  eval "$(vland completion zsh)"
-  fish: vland completion fish | source`).addArgument(new Argument("<shell>", `target shell`).choices(SHELLS)).addHelpText("afterAll", `\nUnder the hood, this command uses ${TOOL_LABELS.USAGE} (https://usage.jdx.dev).
+    # bash — ~/.bashrc
+    command -v vland >/dev/null 2>&1 && eval "$(vland completion bash 2>/dev/null)"
+
+    # zsh — ~/.zshrc
+    command -v vland >/dev/null 2>&1 && eval "$(vland completion zsh 2>/dev/null)"
+
+    # fish — ~/.config/fish/config.fish
+    command -v vland >/dev/null 2>&1; and vland completion fish 2>/dev/null | source`).configureHelp({ helpWidth: Number.POSITIVE_INFINITY }).addArgument(new Argument("<shell>", `target shell`).choices(SHELLS)).addHelpText("afterAll", `\nUnder the hood, this command uses ${TOOL_LABELS.USAGE} (https://usage.jdx.dev).
 Make sure to have it installed and available in your PATH.`);
 }
 //#endregion

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@variablelab/vland",
-  "version": "0.3.6",
+  "version": "0.3.7",
   "description": "The CLI to init a new project in Variable Land",
   "homepage": "https://github.com/withvariablelab/dx/tree/main/vland/cli#readme",
   "bugs": {

package/src/program/commands/completion.ts

@@ -11,12 +11,21 @@ export function createCompletionCommand() {
   return createCommand("completion")
     .summary(`print shell completion script (${TOOL_LABELS.USAGE})`)
     .description(
-      `Prints a shell completion script for vland. Add to your shell rc file:
+      `Prints a shell completion script for vland. Add your shell's line to its rc file:
 
-  bash: eval "$(vland completion bash)"
-  zsh:  eval "$(vland completion zsh)"
-  fish: vland completion fish | source`,
+    # bash — ~/.bashrc
+    command -v vland >/dev/null 2>&1 && eval "$(vland completion bash 2>/dev/null)"
+
+    # zsh — ~/.zshrc
+    command -v vland >/dev/null 2>&1 && eval "$(vland completion zsh 2>/dev/null)"
+
+    # fish — ~/.config/fish/config.fish
+    command -v vland >/dev/null 2>&1; and vland completion fish 2>/dev/null | source`,
     )
+    .configureHelp({
+      // Commander hard-wraps help at the terminal width; a wrapped rc line breaks when pasted.
+      helpWidth: Number.POSITIVE_INFINITY,
+    })
     .addArgument(new Argument("<shell>", `target shell`).choices(SHELLS))
     .addHelpText(
       "afterAll",