@stacksjs/cli 0.70.88 → 0.70.91

package/dist/parse.d.ts

@@ -0,0 +1,20 @@
+export declare function parseArgv(argv?: string[]): ParsedArgv;
+export declare function parseArgs(argv?: string[]): string[];
+export declare function parseOptions(options?: CliOptions): CliOptions;
+// interface BuddyOptions {
+//   dryRun?: boolean
+//   verbose?: boolean
+// }
+export declare function buddyOptions(options?: string[] | Record<string, any>): string;
+declare interface ParsedArgv {
+  args: string[]
+  options: {
+    [k: string]: string | boolean | number
+  }
+}
+declare interface CliOptions {
+  dryRun?: boolean
+  quiet?: boolean
+  verbose?: boolean
+  [k: string]: string | boolean | number | undefined
+}

package/dist/prompts.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Simple confirm prompt
+ */
+declare function confirm(options: ConfirmOptions | string): Promise<boolean>;
+/**
+ * Simple text prompt
+ */
+declare function text(options: TextOptions | string): Promise<string>;
+/**
+ * Simple select prompt (basic implementation)
+ */
+declare function select(options: SelectOptions): Promise<any>;
+/**
+ * Multiselect prompt (basic implementation)
+ */
+declare function multiselect(options: SelectOptions): Promise<any[]>;
+/**
+ * Password prompt (hidden input)
+ */
+declare function password(options: PasswordOptions | string): Promise<string>;
+export declare const prompts: {
+  text: typeof text;
+  confirm: typeof confirm;
+  select: typeof select;
+  multiselect: typeof multiselect;
+  password: typeof password
+};
+declare interface ConfirmOptions {
+  message: string
+  initial?: boolean
+}
+declare interface TextOptions {
+  message: string
+  initial?: string
+  placeholder?: string
+  validate?: (value: string) => boolean | string
+}
+declare interface PasswordOptions {
+  message: string
+  validate?: (value: string) => boolean | string
+}
+declare interface SelectOptions {
+  message: string
+  choices: Array<{ value: any, label: string }>
+  initial?: number
+}
+// Also export individual functions
+export { confirm, text, select, multiselect, password };

package/dist/run.d.ts

@@ -0,0 +1,63 @@
+import type { CliOptions, CommandError, Readable, Subprocess, Writable } from '@stacksjs/types';
+import type { Ok, Result } from '@stacksjs/error-handling';
+/**
+ * Run a command.
+ *
+ * @param command The command to run.
+ * @param options The options to pass to the command.
+ * @returns The result of the command.
+ * @example
+ * ```ts
+ * const result = await runCommand('ls')
+ *
+ * if (result.isErr)
+ *   console.error(result.error)
+ * else
+ *   console.log(result)
+ * ```
+ * @example
+ * ```ts
+ * const result = await runCommand('ls', { cwd: '/home' })
+ *
+ * if (result.isErr)
+ *   console.error(result.error)
+ * else
+ *   console.log(result)
+ * ```
+ */
+export declare function runCommand(command: string, options?: CliOptions): Promise<Result<Subprocess, CommandError>>;
+export declare function runProcess(command: string, options?: CliOptions): Promise<Result<Subprocess, CommandError>>;
+/**
+ * Run a command.
+ *
+ * @param command The command to run.
+ * @param options The options to pass to the command.
+ * @returns The result of the command.
+ * @example
+ * ```ts
+ * const result = runCommandSync('ls')
+ *
+ * if (result.isErr)
+ *   console.error(result.error)
+ * else
+ *   console.log(result)
+ * ```
+ * @example
+ * ```ts
+ * const result = runCommandSync('ls', { cwd: '/home' })
+ *
+ * if (result.isErr)
+ *   console.error(result.error)
+ * else
+ *   console.log(result)
+ * ```
+ */
+export declare function runCommandSync(command: string, options?: CliOptions): Promise<string>;
+/**
+ * Run many commands.
+ *
+ * @param commands The command to run.
+ * @param options The options to pass to the command.
+ * @returns The result of the command.
+ */
+export declare function runCommands(commands: string[], options?: CliOptions): Promise<Ok<Subprocess<Writable, Readable, Readable>, Error>[]>;

package/dist/signals.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Register or replace the cleanup for `name`. Returns a disposer that
+ * un-registers this specific cleanup; useful in tests to avoid leaking
+ * across spec files.
+ *
+ * @example
+ * ```ts
+ * import { onSignal } from '@stacksjs/cli'
+ *
+ * const dispose = onSignal('queue-worker', async () => {
+ *   await worker.drain()
+ * })
+ *
+ * // Later, if the worker stops on its own:
+ * dispose()
+ * ```
+ */
+export declare function onSignal(name: string, cleanup: () => void | Promise<void>): () => void;
+/**
+ * Drop a registered handler by name. Equivalent to invoking the disposer
+ * returned by `onSignal`, but useful when the disposer wasn't kept.
+ */
+export declare function offSignal(name: string): void;
+/**
+ * Snapshot of currently-registered handler names — primarily for tests
+ * that want to assert cleanup wiring is in place.
+ */
+export declare function listSignalHandlers(): string[];
+declare type Signal = 'SIGINT' | 'SIGTERM' | 'SIGHUP';

package/dist/spinner.d.ts

@@ -0,0 +1,17 @@
+export declare function spinner(message?: string): Spinner;
+/**
+ * Run an async operation with a spinner
+ */
+export declare function withSpinner<T>(message: string, operation: () => Promise<T>, options?: { successMessage?: string; failMessage?: string }): Promise<T>;
+/**
+ * Spinner utilities for CLI with reactive terminal output
+ */
+export declare interface Spinner {
+  start: (message?: string) => void
+  stop: (message?: string) => void
+  succeed: (message?: string) => void
+  fail: (message?: string) => void
+  update: (message: string) => void
+  text: string
+  isSpinning: boolean
+}

package/dist/utils.d.ts

@@ -0,0 +1,137 @@
+export declare function stripAnsi(text: string): string;
+export declare function ansi256(code: number): ColorFn;
+export declare function ansi256Bg(code: number): ColorFn;
+export declare function trueColor(r: number, g: number, b: number): ColorFn;
+export declare function trueColorBg(r: number, g: number, b: number): ColorFn;
+export declare function link(url: string): ColorFn;
+export declare function link(text: ColorInput, url: string): string;
+export declare function getColor(colorName: string): ColorFn;
+export declare function colorize(text: ColorInput, colorOrFn: ColorLike): string;
+declare function supportsColor(): boolean;
+export declare function align(text: string, width?: number, alignMode?: Alignment): string;
+export declare function align(text: string, options?: AlignOptions): string;
+export declare function leftAlign(text: string, width?: number): string;
+export declare function rightAlign(text: string, width?: number): string;
+export declare function centerAlign(text: string, width?: number): string;
+export declare function box(text: string, options?: BoxOptions): string;
+export declare const stripColors: typeof stripAnsi;
+export declare const black: ColorFn;
+export declare const red: ColorFn;
+export declare const green: ColorFn;
+export declare const yellow: ColorFn;
+export declare const blue: ColorFn;
+export declare const magenta: ColorFn;
+export declare const cyan: ColorFn;
+export declare const white: ColorFn;
+export declare const gray: ColorFn;
+export declare const lightRed: ColorFn;
+export declare const lightGreen: ColorFn;
+export declare const lightYellow: ColorFn;
+export declare const lightBlue: ColorFn;
+export declare const lightMagenta: ColorFn;
+export declare const lightCyan: ColorFn;
+export declare const lightGray: ColorFn;
+export declare const bgBlack: ColorFn;
+export declare const bgRed: ColorFn;
+export declare const bgGreen: ColorFn;
+export declare const bgYellow: ColorFn;
+export declare const bgBlue: ColorFn;
+export declare const bgMagenta: ColorFn;
+export declare const bgCyan: ColorFn;
+export declare const bgWhite: ColorFn;
+export declare const bgGray: ColorFn;
+export declare const bgLightRed: ColorFn;
+export declare const bgLightGreen: ColorFn;
+export declare const bgLightYellow: ColorFn;
+export declare const bgLightBlue: ColorFn;
+export declare const bgLightMagenta: ColorFn;
+export declare const bgLightCyan: ColorFn;
+export declare const bgLightGray: ColorFn;
+export declare const bold: ColorFn;
+export declare const dim: ColorFn;
+export declare const italic: ColorFn;
+export declare const underline: ColorFn;
+export declare const inverse: ColorFn;
+export declare const hidden: ColorFn;
+export declare const strikethrough: ColorFn;
+export declare const reset: ColorFn;
+export declare const colors: ColorsApi;
+export declare const kolorist: KoloristApi;
+export declare const quotes: any;
+declare interface AlignOptions {
+  width?: number
+  align?: Alignment
+  padChar?: string
+}
+declare interface BoxOptions {
+  align?: Alignment
+  borderColor?: ColorLike
+  borderStyle?: 'single' | 'double' | 'round'
+  margin?: number
+  padding?: number
+  title?: string
+}
+declare type ColorInput = string | number;
+declare type ColorFn = (_text: ColorInput) => string;
+declare type ColorLike = ColorFn | string;
+declare type Alignment = 'left' | 'center' | 'right';
+declare type NamedColorMap = {
+  black: ColorFn
+  red: ColorFn
+  green: ColorFn
+  yellow: ColorFn
+  blue: ColorFn
+  magenta: ColorFn
+  cyan: ColorFn
+  white: ColorFn
+  gray: ColorFn
+
+  lightRed: ColorFn
+  lightGreen: ColorFn
+  lightYellow: ColorFn
+  lightBlue: ColorFn
+  lightMagenta: ColorFn
+  lightCyan: ColorFn
+  lightGray: ColorFn
+
+  bgBlack: ColorFn
+  bgRed: ColorFn
+  bgGreen: ColorFn
+  bgYellow: ColorFn
+  bgBlue: ColorFn
+  bgMagenta: ColorFn
+  bgCyan: ColorFn
+  bgWhite: ColorFn
+  bgGray: ColorFn
+
+  bgLightRed: ColorFn
+  bgLightGreen: ColorFn
+  bgLightYellow: ColorFn
+  bgLightBlue: ColorFn
+  bgLightMagenta: ColorFn
+  bgLightCyan: ColorFn
+  bgLightGray: ColorFn
+
+  bold: ColorFn
+  dim: ColorFn
+  italic: ColorFn
+  underline: ColorFn
+  inverse: ColorFn
+  hidden: ColorFn
+  strikethrough: ColorFn
+  reset: ColorFn
+}
+declare type ColorsApi = NamedColorMap & {
+  ansi256: typeof ansi256
+  ansi256Bg: typeof ansi256Bg
+  trueColor: typeof trueColor
+  trueColorBg: typeof trueColorBg
+  link: typeof link
+  stripColors: typeof stripColors
+}
+declare type KoloristApi = ColorsApi & {
+  grey: ColorFn
+  lightGrey: ColorFn
+  bgLightGrey: ColorFn
+  supportsColor: () => boolean
+}

package/package.json

@@ -2,7 +2,7 @@
   "name": "@stacksjs/cli",
   "type": "module",
   "sideEffects": false,
-  "version": "0.70.88",
+  "version": "0.70.91",
   "description": "TypeScript framework for CLI artisans. Build beautiful console apps with ease.",
   "author": "Chris Breuer",
   "contributors": [
@@ -66,14 +66,14 @@
     "@stacksjs/clapp": "^0.2.8"
   },
   "devDependencies": {
-    "@stacksjs/collections": "0.70.88",
-    "@stacksjs/config": "0.70.88",
+    "@stacksjs/collections": "0.70.91",
+    "@stacksjs/config": "0.70.91",
     "better-dx": "^0.2.16",
-    "@stacksjs/error-handling": "0.70.88",
-    "@stacksjs/logging": "0.70.88",
-    "@stacksjs/path": "0.70.88",
-    "@stacksjs/types": "0.70.88",
-    "@stacksjs/utils": "0.70.88",
-    "@stacksjs/validation": "0.70.88"
+    "@stacksjs/error-handling": "0.70.91",
+    "@stacksjs/logging": "0.70.91",
+    "@stacksjs/path": "0.70.91",
+    "@stacksjs/types": "0.70.91",
+    "@stacksjs/utils": "0.70.91",
+    "@stacksjs/validation": "0.70.91"
   }
 }