@silvery/commander 0.6.0 → 0.6.1

package/README.md

@@ -12,44 +12,54 @@ npm install @silvery/commander
 import { Command, z } from "@silvery/commander"
 
 const program = new Command("deploy")
-  .description("Deploy to an environment")
+  .description("Deploy services to an environment")
   .version("1.0.0")
   .option("-e, --env <env>", "Target environment", z.enum(["dev", "staging", "prod"]))
+  .option("-f, --force", "Skip confirmation")
+  .option("-v, --verbose", "Verbose output")
+
+program
+  .command("start <service>")
+  .description("Start a service")
   .option("-p, --port <n>", "Port number", z.port)
   .option("-r, --retries <n>", "Retry count", z.int)
-  .option("--tags <t>", "Labels", z.csv)
-  .option("-f, --force", "Skip confirmation")
+  .action((service, opts) => {
+    /* ... */
+  })
+
+program
+  .command("stop <service>")
+  .description("Stop a running service")
+  .action((service) => {
+    /* ... */
+  })
+
+program
+  .command("status")
+  .description("Show service status")
+  .option("--json", "Output as JSON")
+  .action((opts) => {
+    /* ... */
+  })
 
 program.parse()
-const { env, port, retries, tags, force } = program.opts()
-//      │      │     │         │      └─ boolean | undefined
-//      │      │     │         └──────── string[]
-//      │      │     └────────────────── number
-//      │      └──────────────────────── number (1–65535)
-//      └─────────────────────────────── "dev" | "staging" | "prod"
+const { env, force, verbose } = program.opts()
+//      │     │       └─ boolean | undefined
+//      │     └────────── boolean | undefined
+//      └──────────────── "dev" | "staging" | "prod"
 ```
 
 With plain Commander, `opts()` returns `Record<string, any>` — every value is untyped. With `@silvery/commander`, each option's type is inferred from its schema: `z.port` produces `number`, `z.enum(...)` produces a union, `z.csv` produces `string[]`. Invalid values are rejected at parse time with clear error messages — not silently passed through as strings.
 
 [Zod](https://github.com/colinhacks/zod) is entirely optional — `z` is tree-shaken from your bundle if you don't import it. Without Zod, use the built-in types (`port`, `int`, `csv`) or plain Commander.
 
-<pre><code>$ deploy --help
-
-<b>Usage:</b> <span style="color:#56b6c2">deploy</span> <span style="color:#98c379">[options]</span>
-
-Deploy to an environment
+Help is auto-colorized — bold headings, green flags, cyan commands, dim descriptions:
 
-<b>Options:</b>
-  <span style="color:#98c379">-V, --version</span>      <span style="color:#888">output the version number</span>
-  <span style="color:#98c379">-e, --env &lt;env&gt;</span>    <span style="color:#888">Target environment</span>
-  <span style="color:#98c379">-p, --port &lt;n&gt;</span>     <span style="color:#888">Port number</span>
-  <span style="color:#98c379">-r, --retries &lt;n&gt;</span>  <span style="color:#888">Retry count</span>
-  <span style="color:#98c379">--tags &lt;t&gt;</span>         <span style="color:#888">Labels</span>
-  <span style="color:#98c379">-f, --force</span>        <span style="color:#888">Skip confirmation</span>
-  <span style="color:#98c379">-h, --help</span>         <span style="color:#888">display help for command</span>
-</code></pre>
+<p align="center">
+  <img src="help-output.svg" alt="Colorized help output" width="80%" />
+</p>
 
-Help is auto-colorized — bold headings, green flags, cyan commands, dim descriptions. Options with [Zod](https://github.com/colinhacks/zod) schemas or built-in types are validated at parse time with clear error messages.
+Options with [Zod](https://github.com/colinhacks/zod) schemas or built-in types are validated at parse time with clear error messages.
 
 ## What's included
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@silvery/commander",
-  "version": "0.6.0",
+  "version": "0.6.1",
   "description": "Colorized Commander.js help output using ANSI escape codes",
   "keywords": [
     "ansi",
@@ -29,16 +29,14 @@
     "access": "public"
   },
   "dependencies": {
+    "@silvery/ansi": ">=0.1.0",
+    "@silvery/style": ">=0.1.0",
     "commander": ">=12.0.0"
   },
   "peerDependencies": {
-    "@silvery/ansi": ">=0.1.0",
     "zod": ">=3.0.0"
   },
   "peerDependenciesMeta": {
-    "@silvery/ansi": {
-      "optional": true
-    },
     "zod": {
       "optional": true
     }

package/src/colorize.ts

@@ -6,8 +6,6 @@
  * or plain commander — accepts a minimal CommandLike interface so Commander
  * is a peer dependency, not a hard one.
  *
- * Zero dependencies — only raw ANSI escape codes.
- *
  * @example
  * ```ts
  * import { Command } from "@silvery/commander"
@@ -18,39 +16,27 @@
  * ```
  */
 
-// Raw ANSI escape codes — no framework dependencies.
+import { MODIFIERS, FG_COLORS } from "@silvery/style"
+import { detectColor } from "@silvery/ansi"
+
+// Derive ANSI escape sequences from @silvery/style constants.
 const RESET = "\x1b[0m"
-const BOLD = "\x1b[1m"
-const DIM = "\x1b[2m"
-const CYAN = "\x1b[36m"
-const GREEN = "\x1b[32m"
-const YELLOW = "\x1b[33m"
+const BOLD = `\x1b[${MODIFIERS.bold![0]}m`
+const DIM = `\x1b[${MODIFIERS.dim![0]}m`
+const CYAN = `\x1b[${FG_COLORS.cyan}m`
+const GREEN = `\x1b[${FG_COLORS.green}m`
+const YELLOW = `\x1b[${FG_COLORS.yellow}m`
 
 /**
  * Check if color output should be enabled.
- * Uses @silvery/ansi detectColor() if available, falls back to basic
- * NO_COLOR/FORCE_COLOR/isTTY checks.
+ * Uses @silvery/ansi detectColor() for full detection (respects NO_COLOR,
+ * FORCE_COLOR, TERM, etc.).
  */
 let _shouldColorize: boolean | undefined
 
 export function shouldColorize(): boolean {
   if (_shouldColorize !== undefined) return _shouldColorize
-
-  // Try @silvery/ansi for full detection (respects NO_COLOR, FORCE_COLOR, TERM, etc.)
-  try {
-    const { detectColor } = require("@silvery/ansi") as { detectColor: (stdout: NodeJS.WriteStream) => string | null }
-    _shouldColorize = detectColor(process.stdout) !== null
-  } catch {
-    // Fallback: basic NO_COLOR / FORCE_COLOR / isTTY checks
-    if (process.env.NO_COLOR !== undefined) {
-      _shouldColorize = false
-    } else if (process.env.FORCE_COLOR !== undefined) {
-      _shouldColorize = true
-    } else {
-      _shouldColorize = process.stdout?.isTTY ?? true
-    }
-  }
-
+  _shouldColorize = detectColor(process.stdout) !== null
   return _shouldColorize
 }