@silvery/commander 0.8.0 → 0.8.2

package/src/index.ts

@@ -1,14 +0,0 @@
-// Enhanced Commander
-export { Command, type HelpSectionPosition, type HelpSectionContent } from "./command.ts"
-export { colorizeHelp, shouldColorize, type ColorizeHelpOptions, type CommandLike } from "./colorize.ts"
-
-// Re-export Commander's other classes
-export { Option, Argument, CommanderError, InvalidArgumentError, Help } from "commander"
-export type { OptionValues } from "commander"
-
-// Built-in types and Standard Schema
-export { int, uint, float, port, url, path, csv, json, bool, date, email, regex, intRange } from "./presets.ts"
-export type { CLIType, StandardSchemaV1 } from "./presets.ts"
-
-// Tree-shakeable: only evaluated if user imports z
-export { z } from "./z.ts"

package/src/plain.ts

@@ -1,22 +0,0 @@
-/**
- * Plain Commander — Standard Schema presets without auto-colorization.
- *
- * Exports the base Commander Command (no auto-colorized help) plus the
- * same typed option presets (int, uint, port, csv, intRange). Does NOT
- * import @silvery/ansi — zero styling overhead.
- *
- * For colorization, import `colorizeHelp` from `@silvery/commander` (main entry).
- *
- * @example
- * ```ts
- * import { Command, port, csv } from "@silvery/commander/plain"
- *
- * const program = new Command("myapp")
- *   .option("-p, --port <n>", "Port", port)
- *   .option("-e, --env <e>", "Env", ["dev", "staging", "prod"])
- * ```
- */
-
-export { Command } from "commander"
-export { int, uint, port, csv, intRange } from "./presets.ts"
-export type { StandardSchemaV1 } from "./presets.ts"

package/src/presets.ts

@@ -1,186 +0,0 @@
-/**
- * Built-in CLI types — Standard Schema v1 validators for common CLI argument patterns.
- *
- * Zero dependencies — validation is manual, no Zod/Valibot/ArkType required.
- * Each type implements Standard Schema v1 for interop with any schema library,
- * plus standalone `.parse()` and `.safeParse()` convenience methods.
- *
- * @example
- * ```ts
- * import { Command, port, csv } from "@silvery/commander"
- *
- * new Command("deploy")
- *   .option("-p, --port <n>", "Port", port)           // number (1-65535)
- *   .option("-r, --retries <n>", "Retries", int)      // number (integer)
- *   .option("--tags <t>", "Tags", csv)                // string[]
- *   .option("-e, --env <e>", "Env", ["dev", "staging", "prod"])
- *
- * // Standalone usage (outside Commander)
- * port.parse("3000")       // 3000
- * port.safeParse("abc")    // { success: false, issues: [{ message: "..." }] }
- * ```
- */
-
-/**
- * Standard Schema v1 interface — the universal schema interop protocol.
- * Supports any schema library that implements Standard Schema (Zod >=3.24,
- * Valibot >=1.0, ArkType >=2.0, etc.).
- *
- * Inlined to avoid any dependency on @standard-schema/spec.
- * See: https://github.com/standard-schema/standard-schema
- */
-export interface StandardSchemaV1<T = unknown> {
-  readonly "~standard": {
-    readonly version: 1
-    readonly vendor: string
-    readonly validate: (
-      value: unknown,
-    ) => { value: T } | { issues: ReadonlyArray<{ message: string; path?: ReadonlyArray<unknown> }> }
-  }
-}
-
-/** A Standard Schema v1 CLI type with standalone parse/safeParse methods. */
-export interface CLIType<T> extends StandardSchemaV1<T> {
-  /** Parse and validate a value, throwing on failure. */
-  parse(value: unknown): T
-  /** Parse and validate a value, returning a result object. */
-  safeParse(value: unknown): { success: true; value: T } | { success: false; issues: Array<{ message: string }> }
-}
-
-function createType<T>(vendor: string, validate: (value: unknown) => T): CLIType<T> {
-  const schema: CLIType<T> = {
-    "~standard": {
-      version: 1,
-      vendor,
-      validate: (value) => {
-        try {
-          return { value: validate(value) }
-        } catch (e: any) {
-          return { issues: [{ message: e.message }] }
-        }
-      },
-    },
-    parse(value: unknown): T {
-      const result = schema["~standard"].validate(value)
-      if ("issues" in result) throw new Error(result.issues[0]?.message ?? "Validation failed")
-      return result.value
-    },
-    safeParse(value: unknown) {
-      const result = schema["~standard"].validate(value)
-      if ("issues" in result) return { success: false as const, issues: [...result.issues] }
-      return { success: true as const, value: result.value }
-    },
-  }
-  return schema
-}
-
-const VENDOR = "@silvery/commander"
-
-/** Integer (coerced from string). */
-export const int = createType<number>(VENDOR, (v) => {
-  const s = String(v).trim()
-  if (s === "") throw new Error(`Expected integer, got "${v}"`)
-  const n = Number(s)
-  if (!Number.isInteger(n)) throw new Error(`Expected integer, got "${v}"`)
-  return n
-})
-
-/** Unsigned integer (>= 0, coerced from string). */
-export const uint = createType<number>(VENDOR, (v) => {
-  const s = String(v).trim()
-  if (s === "") throw new Error(`Expected unsigned integer (>= 0), got "${v}"`)
-  const n = Number(s)
-  if (!Number.isInteger(n) || n < 0) throw new Error(`Expected unsigned integer (>= 0), got "${v}"`)
-  return n
-})
-
-/** Float (coerced from string). */
-export const float = createType<number>(VENDOR, (v) => {
-  const s = String(v).trim()
-  if (s === "" || s === "NaN") throw new Error(`Expected number, got "${v}"`)
-  const n = Number(s)
-  if (Number.isNaN(n)) throw new Error(`Expected number, got "${v}"`)
-  return n
-})
-
-/** Port number (1-65535). */
-export const port = createType<number>(VENDOR, (v) => {
-  const n = Number(v)
-  if (!Number.isInteger(n) || n < 1 || n > 65535) throw new Error(`Expected port (1-65535), got "${v}"`)
-  return n
-})
-
-/** URL (validated via URL constructor). */
-export const url = createType<string>(VENDOR, (v) => {
-  const s = String(v)
-  try {
-    new URL(s)
-    return s
-  } catch {
-    throw new Error(`Expected valid URL, got "${v}"`)
-  }
-})
-
-/** File path (non-empty string). */
-export const path = createType<string>(VENDOR, (v) => {
-  const s = String(v)
-  if (!s) throw new Error("Expected non-empty path")
-  return s
-})
-
-/** Comma-separated values to string[]. */
-export const csv = createType<string[]>(VENDOR, (v) => {
-  return String(v)
-    .split(",")
-    .map((s) => s.trim())
-    .filter(Boolean)
-})
-
-/** JSON string to parsed value. */
-export const json = createType<unknown>(VENDOR, (v) => {
-  try {
-    return JSON.parse(String(v))
-  } catch {
-    throw new Error(`Expected valid JSON, got "${v}"`)
-  }
-})
-
-/** Boolean string ("true"/"false"/"1"/"0"/"yes"/"no"). */
-export const bool = createType<boolean>(VENDOR, (v) => {
-  const s = String(v).toLowerCase()
-  if (["true", "1", "yes", "y"].includes(s)) return true
-  if (["false", "0", "no", "n"].includes(s)) return false
-  throw new Error(`Expected boolean (true/false/yes/no/1/0), got "${v}"`)
-})
-
-/** Date string to Date object. */
-export const date = createType<Date>(VENDOR, (v) => {
-  const d = new Date(String(v))
-  if (isNaN(d.getTime())) throw new Error(`Expected valid date, got "${v}"`)
-  return d
-})
-
-/** Email address (basic validation). */
-export const email = createType<string>(VENDOR, (v) => {
-  const s = String(v)
-  if (!s.includes("@") || !s.includes(".")) throw new Error(`Expected email address, got "${v}"`)
-  return s
-})
-
-/** Regex pattern string to RegExp. */
-export const regex = createType<RegExp>(VENDOR, (v) => {
-  try {
-    return new RegExp(String(v))
-  } catch {
-    throw new Error(`Expected valid regex, got "${v}"`)
-  }
-})
-
-/** Integer with min/max bounds (factory). */
-export function intRange(min: number, max: number): CLIType<number> {
-  return createType<number>(VENDOR, (v) => {
-    const n = Number(v)
-    if (!Number.isInteger(n) || n < min || n > max) throw new Error(`Expected integer ${min}-${max}, got "${v}"`)
-    return n
-  })
-}

package/src/z.ts

@@ -1,44 +0,0 @@
-/**
- * Extended Zod object with CLI types.
- *
- * Spreads all of Zod's exports and adds CLI-specific schemas.
- * Tree-shakeable -- only evaluated if user imports `z`.
- *
- * @example
- * ```ts
- * import { z, Command } from "@silvery/commander"
- *
- * new Command("deploy")
- *   .option("-p, --port <n>", "Port", z.port)
- *   .option("--tags <t>", "Tags", z.csv)
- *   .option("-e, --env <e>", "Env", ["dev", "staging", "prod"])
- *
- * program.parse()
- * ```
- */
-
-import * as zod from "zod"
-
-export const z = {
-  ...zod,
-  // CLI types (built on Zod schemas)
-  port: zod.coerce.number().int().min(1).max(65535),
-  int: zod.coerce.number().int(),
-  uint: zod.coerce.number().int().min(0),
-  float: zod.coerce.number(),
-  csv: zod.string().transform((v: string) =>
-    v
-      .split(",")
-      .map((s: string) => s.trim())
-      .filter(Boolean),
-  ),
-  url: zod.string().url(),
-  path: zod.string().min(1),
-  email: zod.string().email(),
-  date: zod.coerce.date(),
-  json: zod.string().transform((v: string) => JSON.parse(v)),
-  bool: zod
-    .enum(["true", "false", "1", "0", "yes", "no", "y", "n"] as const)
-    .transform((v: string) => ["true", "1", "yes", "y"].includes(v)),
-  intRange: (min: number, max: number) => zod.coerce.number().int().min(min).max(max),
-}