@stacksjs/cli 0.64.6 → 0.65.0

package/dist/parse.d.ts

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

package/dist/run.d.ts

@@ -0,0 +1,63 @@
+import type { Ok, Result } from "@stacksjs/error-handling";
+import type { CliOptions, CommandError, Readable, Subprocess, Writable } from "@stacksjs/types";
+/**
+* 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/spinner.d.ts

@@ -0,0 +1,2 @@
+import ora from "ora";
+export declare const spinner: typeof ora;

package/dist/utils.d.ts

@@ -0,0 +1,5 @@
+import { type Collection } from "@stacksjs/collections";
+export { align, box, centerAlign, colorize, colors, getColor, leftAlign, rightAlign, stripAnsi } from "consola/utils";
+export * as kolorist from "kolorist";
+export { ansi256, ansi256Bg, bgBlack, bgBlue, bgCyan, bgGray, bgGreen, bgLightBlue, bgLightCyan, bgLightGray, bgLightGreen, bgLightMagenta, bgLightRed, bgLightYellow, bgMagenta, bgRed, bgWhite, bgYellow, black, blue, bold, cyan, dim, gray, green, hidden, inverse, italic, lightBlue, lightCyan, lightGray, lightGreen, lightMagenta, lightRed, lightYellow, link, magenta, red, reset, strikethrough, stripColors, trueColor, trueColorBg, underline, white, yellow } from "kolorist";
+export declare const quotes: Collection<string>;

package/package.json

@@ -1,9 +1,10 @@
 {
   "name": "@stacksjs/cli",
   "type": "module",
-  "version": "0.64.6",
+  "version": "0.65.0",
   "description": "TypeScript framework for CLI artisans. Build beautiful console apps with ease.",
   "author": "Chris Breuer",
+  "contributors": ["Chris Breuer <chris@stacksjs.org>"],
   "license": "MIT",
   "funding": "https://github.com/sponsors/chrisbbreuer",
   "homepage": "https://github.com/stacksjs/stacks/tree/main/storage/framework/core/cli#readme",
@@ -43,30 +44,24 @@
   },
   "module": "dist/index.js",
   "types": "dist/index.d.ts",
-  "contributors": [
-    "Chris Breuer <chris@stacksjs.org>"
-  ],
-  "files": [
-    "README.md",
-    "dist",
-    "src"
-  ],
+  "files": ["README.md", "dist", "src"],
   "scripts": {
-    "build": "bun --bun build.ts",
-    "typecheck": "bun --bun tsc --noEmit",
+    "build": "bun build.ts",
+    "typecheck": "bun tsc --noEmit",
+    "test": "bun test",
     "prepublishOnly": "bun run build"
   },
   "dependencies": {
     "@antfu/install-pkg": "^0.4.1",
     "@clack/core": "^0.3.4",
-    "@stacksjs/collections": "latest",
-    "@stacksjs/config": "latest",
-    "@stacksjs/error-handling": "latest",
-    "@stacksjs/logging": "latest",
-    "@stacksjs/path": "latest",
-    "@stacksjs/types": "latest",
-    "@stacksjs/utils": "latest",
-    "@stacksjs/validation": "latest",
+    "@stacksjs/collections": "0.64.6",
+    "@stacksjs/config": "0.64.6",
+    "@stacksjs/error-handling": "0.64.6",
+    "@stacksjs/logging": "0.64.6",
+    "@stacksjs/path": "0.64.6",
+    "@stacksjs/types": "0.64.6",
+    "@stacksjs/utils": "0.64.6",
+    "@stacksjs/validation": "0.64.6",
     "cac": "^6.7.14",
     "consola": "^3.2.3",
     "kolorist": "1.8.0",
@@ -74,7 +69,7 @@
     "prompts": "^2.4.2"
   },
   "devDependencies": {
-    "@stacksjs/development": "latest",
+    "@stacksjs/development": "0.64.6",
     "@types/prompts": "^2.4.9"
   }
 }

package/src/actions/install.ts

@@ -1,5 +1,4 @@
 import { installPackage as installPkg } from '@antfu/install-pkg'
-import type { ExecaReturnValue } from 'execa'
 
 interface InstallPackageOptions {
   cwd?: string
@@ -11,6 +10,8 @@ interface InstallPackageOptions {
   additionalArgs?: string[]
 }
 
+// TODO: improve return types here
+
 /**
  * Install an npm package.
  *
@@ -18,8 +19,9 @@ interface InstallPackageOptions {
  * @param options - The options to pass to the install.The options to pass to the install.
  * @returns The result of the install.
  */
-export async function installPackage(name: string, options?: InstallPackageOptions) {
-  if (options) return await installPkg(name, options)
+export async function installPackage(name: string, options?: InstallPackageOptions): Promise<any> {
+  if (options)
+    return await installPkg(name, options)
 
   return await installPkg(name, { silent: true })
 }
@@ -31,8 +33,9 @@ export async function installPackage(name: string, options?: InstallPackageOptio
  * @param options - The options to pass to the install.
  * @returns The result of the install.
  */
-export async function installStack(name: string, options?: InstallPackageOptions) {
-  if (options) return await installPkg(`@stacksjs/${name}`, options)
+export async function installStack(name: string, options?: InstallPackageOptions): Promise<any> {
+  if (options)
+    return await installPkg(`@stacksjs/${name}`, options)
 
   return await installPkg(`@stacksjs/${name}`, { silent: true })
 }

package/src/app.ts

@@ -1,16 +1,18 @@
+/* eslint-disable ts/no-use-before-define, regexp/no-useless-non-capturing-group, regexp/no-trivially-nested-quantifier, regexp/no-useless-quantifier, regexp/prefer-w,regexp/no-useless-escape */
+import process from 'node:process'
 // slightly modified version of @clack/prompts
 // many thanks to bombshell-dev for the original work
 import {
+  block,
   ConfirmPrompt,
   GroupMultiSelectPrompt,
+  isCancel,
   MultiSelectPrompt,
   PasswordPrompt,
   SelectKeyPrompt,
   SelectPrompt,
   type State,
   TextPrompt,
-  block,
-  isCancel,
 } from '@clack/core'
 import isUnicodeSupported from 'is-unicode-supported'
 import color from 'picocolors'
@@ -41,7 +43,7 @@ const S_CORNER_TOP_RIGHT = s('╮', '+')
 const S_CONNECT_LEFT = s('├', '+')
 const S_CORNER_BOTTOM_RIGHT = s('╯', '+')
 
-const symbol = (state: State) => {
+function symbol(state: State) {
   switch (state) {
     case 'initial':
     case 'active':
@@ -62,7 +64,7 @@ interface LimitOptionsParams<TOption> {
   style: (option: TOption, active: boolean) => string
 }
 
-const limitOptions = <TOption>(params: LimitOptionsParams<TOption>): string[] => {
+function limitOptions<TOption>(params: LimitOptionsParams<TOption>): string[] {
   const { cursor, options, style } = params
 
   const paramMaxItems = params.maxItems ?? Number.POSITIVE_INFINITY
@@ -73,7 +75,8 @@ const limitOptions = <TOption>(params: LimitOptionsParams<TOption>): string[] =>
 
   if (cursor >= slidingWindowLocation + maxItems - 3) {
     slidingWindowLocation = Math.max(Math.min(cursor - maxItems + 3, options.length - maxItems), 0)
-  } else if (cursor < slidingWindowLocation + 2) {
+  }
+  else if (cursor < slidingWindowLocation + 2) {
     slidingWindowLocation = Math.max(cursor - 2, 0)
   }
 
@@ -92,10 +95,9 @@ export interface TextOptions {
   placeholder?: string
   defaultValue?: string
   initialValue?: string
-  // biome-ignore lint/suspicious/noConfusingVoidType: originally shipped this
   validate?: (value: string) => string | void
 }
-export const text = (opts: TextOptions) => {
+export function text(opts: TextOptions) {
   return new TextPrompt({
     validate: opts.validate,
     placeholder: opts.placeholder,
@@ -129,10 +131,9 @@ export const text = (opts: TextOptions) => {
 export interface PasswordOptions {
   message: string
   mask?: string
-  // biome-ignore lint/suspicious/noConfusingVoidType: originally shipped this
   validate?: (value: string) => string | void
 }
-export const password = (opts: PasswordOptions) => {
+export function password(opts: PasswordOptions) {
   return new PasswordPrompt({
     validate: opts.validate,
     mask: opts.mask ?? S_PASSWORD_MASK,
@@ -165,7 +166,7 @@ export interface ConfirmOptions {
   inactive?: string
   initialValue?: boolean
 }
-export const confirm = (opts: ConfirmOptions) => {
+export function confirm(opts: ConfirmOptions) {
   const active = opts.active ?? 'Yes'
   const inactive = opts.inactive ?? 'No'
   return new ConfirmPrompt({
@@ -200,8 +201,8 @@ export const confirm = (opts: ConfirmOptions) => {
 type Primitive = Readonly<string | boolean | number>
 
 type Option<Value> = Value extends Primitive
-  ? { value: Value; label?: string; hint?: string }
-  : { value: Value; label: string; hint?: string }
+  ? { value: Value, label?: string, hint?: string }
+  : { value: Value, label: string, hint?: string }
 
 export interface SelectOptions<Value> {
   message: string
@@ -210,7 +211,7 @@ export interface SelectOptions<Value> {
   maxItems?: number
 }
 
-export const select = <Value>(opts: SelectOptions<Value>) => {
+export function select<Value>(opts: SelectOptions<Value>) {
   const opt = (option: Option<Value>, state: 'inactive' | 'active' | 'selected' | 'cancelled') => {
     const label = option.label ?? String(option.value)
     switch (state) {
@@ -233,10 +234,8 @@ export const select = <Value>(opts: SelectOptions<Value>) => {
 
       switch (this.state) {
         case 'submit':
-          // biome-ignore lint/style/noNonNullAssertion: will be set
           return `${title}${color.gray(S_BAR)}  ${opt(this.options[this.cursor]!, 'selected')}`
         case 'cancel':
-          // biome-ignore lint/style/noNonNullAssertion: will be set
           return `${title}${color.gray(S_BAR)}  ${opt(this.options[this.cursor]!, 'cancelled')}\n${color.gray(S_BAR)}`
         default: {
           return `${title}${color.cyan(S_BAR)}  ${limitOptions({
@@ -251,7 +250,7 @@ export const select = <Value>(opts: SelectOptions<Value>) => {
   }).prompt() as Promise<Value | symbol>
 }
 
-export const selectKey = <Value extends string>(opts: SelectOptions<Value>) => {
+export function selectKey<Value extends string>(opts: SelectOptions<Value>) {
   const opt = (option: Option<Value>, state: 'inactive' | 'active' | 'selected' | 'cancelled' = 'inactive') => {
     const label = option.label ?? String(option.value)
 
@@ -283,12 +282,10 @@ export const selectKey = <Value extends string>(opts: SelectOptions<Value>) => {
       switch (this.state) {
         case 'submit':
           return `${title}${color.gray(S_BAR)}  ${opt(
-            // biome-ignore lint/style/noNonNullAssertion: will be set
-            this.options.find((opt) => opt.value === this.value)!,
+            this.options.find(opt => opt.value === this.value)!,
             'selected',
           )}`
         case 'cancel':
-          // biome-ignore lint/style/noNonNullAssertion: will be set
           return `${title}${color.gray(S_BAR)}  ${opt(this.options[0]!, 'cancelled')}\n${color.gray(S_BAR)}`
         default: {
           return `${title}${color.cyan(S_BAR)}  ${this.options
@@ -308,7 +305,7 @@ export interface MultiSelectOptions<Value> {
   required?: boolean
   cursorAt?: Value
 }
-export const multiselect = <Value>(opts: MultiSelectOptions<Value>) => {
+export function multiselect<Value>(opts: MultiSelectOptions<Value>) {
   const opt = (
     option: Option<Value>,
     state: 'inactive' | 'active' | 'selected' | 'active-selected' | 'submitted' | 'cancelled',
@@ -344,7 +341,7 @@ export const multiselect = <Value>(opts: MultiSelectOptions<Value>) => {
     required: opts.required ?? true,
     cursorAt: opts.cursorAt,
     validate(selected: Value[]) {
-      if (this.required && selected.length === 0)
+      if (this.required && selected.length === 0) {
         return `Please select at least one option.\n${color.reset(
           color.dim(
             `Press ${color.gray(color.bgWhite(color.inverse(' space ')))} to select, ${color.gray(
@@ -352,6 +349,7 @@ export const multiselect = <Value>(opts: MultiSelectOptions<Value>) => {
             )} to submit`,
           ),
         )}`
+      }
     },
     render() {
       const title = `${color.gray(S_BAR)}\n${symbol(this.state)}  ${opts.message}\n`
@@ -372,14 +370,14 @@ export const multiselect = <Value>(opts: MultiSelectOptions<Value>) => {
           return `${title}${color.gray(S_BAR)}  ${
             this.options
               .filter(({ value }) => this.value.includes(value))
-              .map((option) => opt(option, 'submitted'))
+              .map(option => opt(option, 'submitted'))
               .join(color.dim(', ')) || color.dim('none')
           }`
         }
         case 'cancel': {
           const label = this.options
             .filter(({ value }) => this.value.includes(value))
-            .map((option) => opt(option, 'cancelled'))
+            .map(option => opt(option, 'cancelled'))
             .join(color.dim(', '))
           return `${title}${color.gray(S_BAR)}  ${label.trim() ? `${label}\n${color.gray(S_BAR)}` : ''}`
         }
@@ -419,7 +417,7 @@ export interface GroupMultiSelectOptions<Value> {
   required?: boolean
   cursorAt?: Value
 }
-export const groupMultiselect = <Value>(opts: GroupMultiSelectOptions<Value>) => {
+export function groupMultiselect<Value>(opts: GroupMultiSelectOptions<Value>) {
   const opt = (
     option: Option<Value>,
     state:
@@ -480,7 +478,7 @@ export const groupMultiselect = <Value>(opts: GroupMultiSelectOptions<Value>) =>
     required: opts.required ?? true,
     cursorAt: opts.cursorAt,
     validate(selected: Value[]) {
-      if (this.required && selected.length === 0)
+      if (this.required && selected.length === 0) {
         return `Please select at least one option.\n${color.reset(
           color.dim(
             `Press ${color.gray(color.bgWhite(color.inverse(' space ')))} to select, ${color.gray(
@@ -488,6 +486,7 @@ export const groupMultiselect = <Value>(opts: GroupMultiSelectOptions<Value>) =>
             )} to submit`,
           ),
         )}`
+      }
     },
     render() {
       const title = `${color.gray(S_BAR)}\n${symbol(this.state)}  ${opts.message}\n`
@@ -496,13 +495,13 @@ export const groupMultiselect = <Value>(opts: GroupMultiSelectOptions<Value>) =>
         case 'submit': {
           return `${title}${color.gray(S_BAR)}  ${this.options
             .filter(({ value }) => this.value.includes(value))
-            .map((option) => opt(option, 'submitted'))
+            .map(option => opt(option, 'submitted'))
             .join(color.dim(', '))}`
         }
         case 'cancel': {
           const label = this.options
             .filter(({ value }) => this.value.includes(value))
-            .map((option) => opt(option, 'cancelled'))
+            .map(option => opt(option, 'cancelled'))
             .join(color.dim(', '))
           return `${title}${color.gray(S_BAR)}  ${label.trim() ? `${label}\n${color.gray(S_BAR)}` : ''}`
         }
@@ -513,12 +512,11 @@ export const groupMultiselect = <Value>(opts: GroupMultiSelectOptions<Value>) =>
             .join('\n')
           return `${title}${color.yellow(S_BAR)}  ${this.options
             .map((option, i, options) => {
-              const selected =
-                this.value.includes(option.value) || (option.group === true && this.isGroupSelected(`${option.value}`))
+              const selected
+                = this.value.includes(option.value) || (option.group === true && this.isGroupSelected(`${option.value}`))
               const active = i === this.cursor
-              const groupActive =
-                // biome-ignore lint/style/noNonNullAssertion: will be set
-                !active && typeof option.group === 'string' && this.options[this.cursor]!.value === option.group
+              const groupActive
+                = !active && typeof option.group === 'string' && this.options[this.cursor]!.value === option.group
               if (groupActive) {
                 return opt(option, selected ? 'group-active-selected' : 'group-active', options)
               }
@@ -535,12 +533,11 @@ export const groupMultiselect = <Value>(opts: GroupMultiSelectOptions<Value>) =>
         default: {
           return `${title}${color.cyan(S_BAR)}  ${this.options
             .map((option, i, options) => {
-              const selected =
-                this.value.includes(option.value) || (option.group === true && this.isGroupSelected(`${option.value}`))
+              const selected
+                = this.value.includes(option.value) || (option.group === true && this.isGroupSelected(`${option.value}`))
               const active = i === this.cursor
-              const groupActive =
-                // biome-ignore lint/style/noNonNullAssertion: will be set
-                !active && typeof option.group === 'string' && this.options[this.cursor]!.value === option.group
+              const groupActive
+                = !active && typeof option.group === 'string' && this.options[this.cursor]!.value === option.group
               if (groupActive) {
                 return opt(option, selected ? 'group-active-selected' : 'group-active', options)
               }
@@ -563,11 +560,11 @@ export const groupMultiselect = <Value>(opts: GroupMultiSelectOptions<Value>) =>
 }
 
 const strip = (str: string) => str.replace(ansiRegex(), '')
-export const note = (message = '', title = '') => {
+export function note(message = '', title = ''): void {
   const lines = `\n${message}\n`.split('\n')
   const titleLen = strip(title).length
-  const len =
-    Math.max(
+  const len
+    = Math.max(
       lines.reduce((sum, ln) => {
         ln = strip(ln)
         return ln.length > sum ? ln.length : sum
@@ -575,7 +572,7 @@ export const note = (message = '', title = '') => {
       titleLen,
     ) + 2
   const msg = lines
-    .map((ln) => `${color.gray(S_BAR)}  ${color.dim(ln)}${' '.repeat(len - strip(ln).length)}${color.gray(S_BAR)}`)
+    .map(ln => `${color.gray(S_BAR)}  ${color.dim(ln)}${' '.repeat(len - strip(ln).length)}${color.gray(S_BAR)}`)
     .join('\n')
   process.stdout.write(
     `${color.gray(S_BAR)}\n${color.green(S_STEP_SUBMIT)}  ${color.reset(title)} ${color.gray(
@@ -584,19 +581,25 @@ export const note = (message = '', title = '') => {
   )
 }
 
-export const cancel = (message = '') => {
+export function cancel(message = ''): void {
   process.stdout.write(`${color.gray(S_BAR_END)}  ${color.red(message)}\n\n`)
 }
 
-export const intro = (title = '') => {
+export function intro(title = ''): void {
   process.stdout.write(`${color.gray(S_BAR_START)}  ${title}\n`)
 }
 
-export const outro = (message = '') => {
+export function outro(message = ''): void {
   process.stdout.write(`${color.gray(S_BAR)}\n${color.gray(S_BAR_END)}  ${message}\n\n`)
 }
 
-export const spinner = () => {
+interface Spinner {
+  start: (msg: string) => void
+  stop: (msg: string, code: number) => void
+  message: (msg: string) => void
+}
+
+export function spinner(): Spinner {
   const frames = unicode ? ['◒', '◐', '◓', '◑'] : ['•', 'o', 'O', '0']
   const delay = unicode ? 80 : 120
 
@@ -607,7 +610,8 @@ export const spinner = () => {
 
   const handleExit = (code: number) => {
     const msg = code > 1 ? 'Something went wrong' : 'Canceled'
-    if (isSpinnerActive) stop(msg, code)
+    if (isSpinnerActive)
+      stop(msg, code)
   }
 
   const errorEventHandler = () => handleExit(2)
@@ -633,15 +637,16 @@ export const spinner = () => {
   }
 
   const start = (msg = ''): void => {
-    let loop: ReturnType<typeof setInterval>
     isSpinnerActive = true
     unblock = block()
     _message = msg.replace(/\.+$/, '')
     process.stdout.write(`${color.gray(S_BAR)}\n`)
     let frameIndex = 0
     let dotsTimer = 0
+
     registerHooks()
-    loop = setInterval(() => {
+
+    setInterval(() => {
       const frame = color.magenta(frames[frameIndex])
       const loadingDots = '.'.repeat(Math.floor(dotsTimer)).slice(0, 3)
       process.stdout.write(cursor.move(-999, 0))
@@ -656,8 +661,8 @@ export const spinner = () => {
     _message = msg ?? _message
     isSpinnerActive = false
     clearInterval(loop as NodeJS.Timeout)
-    const step =
-      code === 0 ? color.green(S_STEP_SUBMIT) : code === 1 ? color.red(S_STEP_CANCEL) : color.red(S_STEP_ERROR)
+    const step
+      = code === 0 ? color.green(S_STEP_SUBMIT) : code === 1 ? color.red(S_STEP_CANCEL) : color.red(S_STEP_ERROR)
     process.stdout.write(cursor.move(-999, 0))
     process.stdout.write(erase.down(1))
     process.stdout.write(`${step}  ${_message}\n`)
@@ -669,11 +674,13 @@ export const spinner = () => {
     _message = msg ?? _message
   }
 
-  return {
+  const spinner = {
     start,
     stop,
     message,
   }
+
+  return spinner
 }
 
 // Adapted from https://github.com/chalk/ansi-regex
@@ -706,7 +713,6 @@ type Prettify<T> = {
 export type PromptGroup<T> = {
   [P in keyof T]: (opts: {
     results: Prettify<Partial<PromptGroupAwaitedReturn<Omit<T, P>>>>
-    // biome-ignore lint/suspicious/noConfusingVoidType: originally shipped this
   }) => void | Promise<T[P] | void>
 }
 
@@ -714,10 +720,7 @@ export type PromptGroup<T> = {
  * Define a group of prompts to be displayed
  * and return a results of objects within the group
  */
-export const group = async <T>(
-  prompts: PromptGroup<T>,
-  opts?: PromptGroupOptions<T>,
-): Promise<Prettify<PromptGroupAwaitedReturn<T>>> => {
+export async function group<T>(prompts: PromptGroup<T>, opts?: PromptGroupOptions<T>): Promise<Prettify<PromptGroupAwaitedReturn<T>>> {
   const results = {} as any
   const promptNames = Object.keys(prompts)
 
@@ -742,7 +745,7 @@ export const group = async <T>(
   return results
 }
 
-export type Task = {
+export interface Task {
   /**
    * Task title
    */
@@ -761,13 +764,14 @@ export type Task = {
 /**
  * Define a group of tasks to be executed
  */
-export const tasks = async (tasks: Task[]) => {
+export async function tasks(tasks: Task[]): Promise<void> {
   for (const task of tasks) {
-    if (task.enabled === false) continue
+    if (task.enabled === false)
+      continue
 
     const s = spinner()
     s.start(task.title)
     const result = await task.task(s.message)
-    s.stop(result || task.title)
+    s.stop(result || task.title, 0)
   }
 }

package/src/cli.ts

@@ -14,7 +14,7 @@ interface CliOptions {
   // description: string
 }
 
-export function cli(name?: string | CliOptions, options?: CliOptions) {
+export function cli(name?: string | CliOptions, options?: CliOptions): CAC {
   if (typeof name === 'object') {
     options = name
     name = options.name

package/src/command.ts

@@ -1,4 +1,5 @@
-import type { CliOptions } from '@stacksjs/types'
+import type { Result } from '@stacksjs/error-handling'
+import type { CliOptions, Readable, Subprocess, Writable } from '@stacksjs/types'
 import { runCommand } from './run'
 
 type CommandOptionTuple = [string, string, { default: boolean }]
@@ -37,11 +38,17 @@ export class Command {
 }
 
 export const command = {
-  run: async (command: string, options?: CliOptions) => {
+  run: async (
+    command: string,
+    options?: CliOptions,
+  ): Promise<Result<Subprocess<Writable, Readable, Readable>, Error>> => {
     return await runCommand(command, options)
   },
 
-  runSync: async (command: string, options?: CliOptions) => {
+  runSync: async (
+    command: string,
+    options?: CliOptions,
+  ): Promise<Result<Subprocess<Writable, Readable, Readable>, Error>> => {
     return await runCommand(command, options)
   },
 }

package/src/console.ts

@@ -1,4 +1,4 @@
 import { log } from '@stacksjs/logging'
 import prompts from 'prompts'
 
-export { prompts, log }
+export { log, prompts }