@outfitter/cli 0.3.0 → 0.4.1

package/dist/shared/@outfitter/{cli-5g6rkv3d.js → cli-rk9zagkm.js}

@@ -1,14 +1,31 @@
 // @bun
 import {
-  init_detection,
   resolveColorEnv,
   supportsColor
-} from "./cli-d9ad0rqj.js";
-import {
-  __esm
-} from "./cli-v1tzwxkt.js";
+} from "./cli-jbj78ac5.js";
 
-// packages/cli/src/render/colors.ts
+// packages/cli/src/colors/colors.ts
+var ANSI = {
+  reset: "\x1B[0m",
+  bold: "\x1B[1m",
+  dim: "\x1B[2m",
+  italic: "\x1B[3m",
+  underline: "\x1B[4m",
+  inverse: "\x1B[7m",
+  green: "\x1B[32m",
+  yellow: "\x1B[33m",
+  red: "\x1B[31m",
+  blue: "\x1B[34m",
+  cyan: "\x1B[36m",
+  magenta: "\x1B[35m",
+  white: "\x1B[37m",
+  gray: "\x1B[90m",
+  brightCyan: "\x1B[96m",
+  brightRed: "\x1B[91m",
+  brightYellow: "\x1B[93m",
+  brightGreen: "\x1B[92m",
+  brightBlue: "\x1B[94m"
+};
 function createTheme() {
   const colorEnabled = supportsColor();
   const colorFn = (ansiCode) => (text) => {
@@ -103,30 +120,5 @@ function applyColor(text, color) {
   const ansiCode = ANSI[color];
   return `${ansiCode}${text}${ANSI.reset}`;
 }
-var ANSI;
-var init_colors = __esm(() => {
-  init_detection();
-  ANSI = {
-    reset: "\x1B[0m",
-    bold: "\x1B[1m",
-    dim: "\x1B[2m",
-    italic: "\x1B[3m",
-    underline: "\x1B[4m",
-    inverse: "\x1B[7m",
-    green: "\x1B[32m",
-    yellow: "\x1B[33m",
-    red: "\x1B[31m",
-    blue: "\x1B[34m",
-    cyan: "\x1B[36m",
-    magenta: "\x1B[35m",
-    white: "\x1B[37m",
-    gray: "\x1B[90m",
-    brightCyan: "\x1B[96m",
-    brightRed: "\x1B[91m",
-    brightYellow: "\x1B[93m",
-    brightGreen: "\x1B[92m",
-    brightBlue: "\x1B[94m"
-  };
-});
 
-export { ANSI, createTheme, resolveTokenColorEnabled, createTokens, applyColor, init_colors };
+export { ANSI, createTheme, resolveTokenColorEnabled, createTokens, applyColor };

package/dist/shared/@outfitter/{cli-4h4rpdra.js → cli-zahqsaby.js}

@@ -6,33 +6,55 @@ function isCommanderHelp(error) {
 }
 function createCLI(config) {
   const program = new Command;
+  let bridgedJsonEnvPrevious;
+  let bridgedJsonEnvActive = false;
+  const restoreJsonEnvBridge = () => {
+    if (!bridgedJsonEnvActive) {
+      return;
+    }
+    if (bridgedJsonEnvPrevious === undefined) {
+      process.env["OUTFITTER_JSON"] = undefined;
+    } else {
+      process.env["OUTFITTER_JSON"] = bridgedJsonEnvPrevious;
+    }
+    bridgedJsonEnvPrevious = undefined;
+    bridgedJsonEnvActive = false;
+  };
   program.name(config.name).version(config.version);
   if (config.description) {
     program.description(config.description);
   }
   program.option("--json", "Output as JSON", false);
-  const exit = config.onExit ?? ((code) => process.exit(code));
-  program.exitOverride((error) => {
-    if (isCommanderHelp(error)) {
-      exit(0);
+  program.hook("preAction", (thisCommand) => {
+    const allOpts = thisCommand.optsWithGlobals();
+    if (allOpts["json"] && !bridgedJsonEnvActive) {
+      bridgedJsonEnvPrevious = process.env["OUTFITTER_JSON"];
+      process.env["OUTFITTER_JSON"] = "1";
+      bridgedJsonEnvActive = true;
     }
-    if (config.onError) {
-      config.onError(error);
-    }
-    const exitCode = typeof error.exitCode === "number" && Number.isFinite(error.exitCode) ? error.exitCode : 1;
-    exit(exitCode);
   });
+  program.hook("postAction", () => {
+    restoreJsonEnvBridge();
+  });
+  const exit = config.onExit ?? ((code) => void process.exit(code));
+  program.exitOverride();
   const parse = async (argv) => {
     try {
       await program.parseAsync(argv ?? process.argv);
     } catch (error) {
       const err = error instanceof Error ? error : new Error(String(error));
+      if (isCommanderHelp(err)) {
+        await exit(0);
+        return;
+      }
       if (config.onError) {
         config.onError(err);
       }
       const errorExitCode = error.exitCode;
       const exitCode = typeof errorExitCode === "number" ? errorExitCode : 1;
-      exit(exitCode);
+      await exit(exitCode);
+    } finally {
+      restoreJsonEnvBridge();
     }
   };
   const cli = {

package/dist/terminal/detection.js

@@ -3,15 +3,11 @@ import {
   getEnvValue,
   getTerminalWidth,
   hasNoColorEnv,
-  init_detection,
   isInteractive,
   resolveColorEnv,
   resolveForceColorEnv,
   supportsColor
-} from "../shared/@outfitter/cli-d9ad0rqj.js";
-import"../shared/@outfitter/cli-v1tzwxkt.js";
-init_detection();
-
+} from "../shared/@outfitter/cli-jbj78ac5.js";
 export {
   supportsColor,
   resolveForceColorEnv,

package/dist/terminal/index.js

@@ -3,16 +3,11 @@ import {
   getEnvValue,
   getTerminalWidth,
   hasNoColorEnv,
-  init_detection,
   isInteractive,
   resolveColorEnv,
   resolveForceColorEnv,
   supportsColor
-} from "../shared/@outfitter/cli-d9ad0rqj.js";
-import"../shared/@outfitter/cli-v1tzwxkt.js";
-
-// packages/cli/src/terminal/index.ts
-init_detection();
+} from "../shared/@outfitter/cli-jbj78ac5.js";
 export {
   supportsColor,
   resolveForceColorEnv,

package/dist/{shared/@outfitter/cli-4cb5g831.d.ts → text.d.ts}

@@ -144,4 +144,4 @@ declare function pluralize(count: number, singular: string, plural?: string): st
 * ```
 */
 declare function slugify(text: string): string;
-export { ANSI_REGEX, stripAnsi, getStringWidth, wrapText, truncateText, padText, pluralize, slugify };
+export { wrapText, truncateText, stripAnsi, slugify, pluralize, padText, getStringWidth, ANSI_REGEX };

package/dist/{shared/@outfitter/cli-mwxsh3sr.js → text.js}

@@ -1,13 +1,11 @@
 // @bun
 import {
-  ANSI,
-  init_colors
-} from "./cli-5g6rkv3d.js";
-import {
-  __esm
-} from "./cli-v1tzwxkt.js";
+  ANSI
+} from "./shared/@outfitter/cli-rk9zagkm.js";
+import"./shared/@outfitter/cli-jbj78ac5.js";
 
-// packages/cli/src/render/text.ts
+// packages/cli/src/text.ts
+var ANSI_REGEX = /\x1b\[[0-9;]*m/g;
 function stripAnsi(text) {
   return text.replace(ANSI_REGEX, "");
 }
@@ -76,10 +74,13 @@ function pluralize(count, singular, plural) {
 function slugify(text) {
   return text.toLowerCase().replace(/&/g, "and").replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "");
 }
-var ANSI_REGEX;
-var init_text = __esm(() => {
-  init_colors();
-  ANSI_REGEX = /\x1b\[[0-9;]*m/g;
-});
-
-export { ANSI_REGEX, stripAnsi, getStringWidth, wrapText, truncateText, padText, pluralize, slugify, init_text };
+export {
+  wrapText,
+  truncateText,
+  stripAnsi,
+  slugify,
+  pluralize,
+  padText,
+  getStringWidth,
+  ANSI_REGEX
+};

package/dist/types.d.ts

@@ -1,2 +1,2 @@
-import { CLI, CLIConfig, CancelledError, CollectIdsOptions, CommandAction, CommandBuilder, CommandConfig, CommandFlags, ConfirmDestructiveOptions, CursorOptions, DateRange, ErrorCategory, ExpandFileOptions, FilterExpression, KeyValuePair, NormalizeIdOptions, NumericRange, OutputMode, OutputOptions, PaginationState, ParseGlobOptions, Range, Result, SortCriteria, ValidationError } from "./shared/@outfitter/cli-ttt7r0j7";
-export { ValidationError, SortCriteria, Result, Range, ParseGlobOptions, PaginationState, OutputOptions, OutputMode, NumericRange, NormalizeIdOptions, KeyValuePair, FilterExpression, ExpandFileOptions, ErrorCategory, DateRange, CursorOptions, ConfirmDestructiveOptions, CommandFlags, CommandConfig, CommandBuilder, CommandAction, CollectIdsOptions, CancelledError, CLIConfig, CLI };
+import { CLI, CLIConfig, CancelledError, CollectIdsOptions, ColorFlags, ColorMode, CommandAction, CommandBuilder, CommandConfig, CommandFlags, ComposedPreset, CursorOptions, DateRange, ErrorCategory, ExecutionFlags, ExecutionPresetConfig, ExpandFileOptions, FilterExpression, FlagPreset, FlagPresetConfig, InteractionFlags, KeyValuePair, NormalizeIdOptions, NumericRange, OutputMode, OutputOptions, PaginationFlags, PaginationPresetConfig, PaginationState, ParseGlobOptions, ProjectionFlags, Range, Result, SortCriteria, StrictFlags, TimeWindowFlags, TimeWindowPresetConfig, ValidationError, VerbConfig, VerbFamily } from "./shared/@outfitter/cli-md9347gn";
+export { VerbFamily, VerbConfig, ValidationError, TimeWindowPresetConfig, TimeWindowFlags, StrictFlags, SortCriteria, Result, Range, ProjectionFlags, ParseGlobOptions, PaginationState, PaginationPresetConfig, PaginationFlags, OutputOptions, OutputMode, NumericRange, NormalizeIdOptions, KeyValuePair, InteractionFlags, FlagPresetConfig, FlagPreset, FilterExpression, ExpandFileOptions, ExecutionPresetConfig, ExecutionFlags, ErrorCategory, DateRange, CursorOptions, ComposedPreset, CommandFlags, CommandConfig, CommandBuilder, CommandAction, ColorMode, ColorFlags, CollectIdsOptions, CancelledError, CLIConfig, CLI };

package/dist/types.js

@@ -1,6 +1,4 @@
 // @bun
-import"./shared/@outfitter/cli-v1tzwxkt.js";
-
 // packages/cli/src/types.ts
 import {
   CancelledError,

package/dist/verbs.d.ts

@@ -0,0 +1,50 @@
+import { CommandBuilder, VerbConfig, VerbFamily } from "./shared/@outfitter/cli-md9347gn";
+/**
+* Built-in verb families with standard primary verbs and aliases.
+*
+* These follow POSIX and modern CLI conventions:
+* - `create` / `new` — Create a new resource
+* - `modify` / `edit` / `update` — Modify an existing resource
+* - `remove` / `delete` / `rm` — Remove a resource
+* - `list` / `ls` — List resources
+* - `show` / `get` / `view` — Show resource details
+*/
+declare const VERB_FAMILIES: Readonly<Record<string, VerbFamily>>;
+/**
+* Resolve a verb family with optional project-level config overrides.
+*
+* @param family - Name of the verb family (e.g., "create", "modify")
+* @param config - Optional overrides for primary verb, aliases, etc.
+* @returns Resolved verb name and aliases
+*
+* @example
+* ```typescript
+* resolveVerb("modify"); // { name: "modify", aliases: ["edit", "update"] }
+* resolveVerb("modify", { primary: "edit" }); // { name: "edit", aliases: ["update"] }
+* resolveVerb("remove", { aliases: false }); // { name: "remove", aliases: [] }
+* ```
+*/
+declare function resolveVerb(family: string, config?: VerbConfig): {
+	name: string;
+	aliases: string[];
+};
+/**
+* Apply verb conventions to a CommandBuilder.
+*
+* Adds aliases from the resolved verb family to the command builder.
+*
+* @param builder - CommandBuilder to apply aliases to
+* @param family - Name of the verb family
+* @param config - Optional overrides
+* @returns The builder for chaining
+*
+* @example
+* ```typescript
+* const cmd = command("remove <id>")
+*   .description("Remove a resource");
+* applyVerb(cmd, "remove");
+* // Adds aliases: "delete", "rm"
+* ```
+*/
+declare function applyVerb(builder: CommandBuilder, family: string, config?: VerbConfig): CommandBuilder;
+export { resolveVerb, applyVerb, VERB_FAMILIES };

package/dist/verbs.js

@@ -0,0 +1,61 @@
+// @bun
+// packages/cli/src/verbs.ts
+var VERB_FAMILIES = {
+  create: {
+    primary: "create",
+    aliases: ["new"],
+    description: "Create a new resource"
+  },
+  modify: {
+    primary: "modify",
+    aliases: ["edit", "update"],
+    description: "Modify a resource"
+  },
+  remove: {
+    primary: "remove",
+    aliases: ["delete", "rm"],
+    description: "Remove a resource"
+  },
+  list: {
+    primary: "list",
+    aliases: ["ls"],
+    description: "List resources"
+  },
+  show: {
+    primary: "show",
+    aliases: ["get", "view"],
+    description: "Show details"
+  }
+};
+function resolveVerb(family, config) {
+  const def = VERB_FAMILIES[family];
+  if (!Object.hasOwn(VERB_FAMILIES, family) || def === undefined) {
+    throw new Error(`Unknown verb family: "${family}"`);
+  }
+  const name = config?.primary ?? def.primary;
+  if (config?.aliases === false) {
+    return { name, aliases: [] };
+  }
+  let aliases = [...def.aliases].filter((a) => a !== name);
+  if (config?.extraAliases) {
+    aliases.push(...config.extraAliases);
+  }
+  if (config?.excludeAliases) {
+    const exclude = new Set(config.excludeAliases);
+    aliases = aliases.filter((a) => !exclude.has(a));
+  }
+  aliases = [...new Set(aliases)];
+  return { name, aliases };
+}
+function applyVerb(builder, family, config) {
+  const { aliases } = resolveVerb(family, config);
+  for (const alias of aliases) {
+    builder.alias(alias);
+  }
+  return builder;
+}
+export {
+  resolveVerb,
+  applyVerb,
+  VERB_FAMILIES
+};

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@outfitter/cli",
   "description": "Typed CLI runtime with terminal detection, rendering, output contracts, and input parsing",
-  "version": "0.3.0",
+  "version": "0.4.1",
   "type": "module",
   "files": [
     "dist"
@@ -9,58 +9,65 @@
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "exports": {
-    "./output": {
+    ".": {
       "import": {
-        "types": "./dist/output.d.ts",
-        "default": "./dist/output.js"
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
       }
     },
-    "./demo": {
+    "./actions": {
       "import": {
-        "types": "./dist/demo/index.d.ts",
-        "default": "./dist/demo/index.js"
+        "types": "./dist/actions.d.ts",
+        "default": "./dist/actions.js"
       }
     },
-    "./borders": {
+    "./colors": {
+      "import": {
+        "types": "./dist/colors/index.d.ts",
+        "default": "./dist/colors/index.js"
+      }
+    },
+    "./command": {
       "import": {
-        "types": "./dist/borders/index.d.ts",
-        "default": "./dist/borders/index.js"
+        "types": "./dist/command.d.ts",
+        "default": "./dist/command.js"
       }
     },
-    "./preset/full": {
+    "./completion": {
       "import": {
-        "types": "./dist/preset/full.d.ts",
-        "default": "./dist/preset/full.js"
+        "types": "./dist/completion.d.ts",
+        "default": "./dist/completion.js"
       }
     },
-    "./preset/standard": {
+    "./flags": {
       "import": {
-        "types": "./dist/preset/standard.d.ts",
-        "default": "./dist/preset/standard.js"
+        "types": "./dist/flags.d.ts",
+        "default": "./dist/flags.js"
       }
     },
-    "./box": {
+    "./input": {
       "import": {
-        "types": "./dist/box/index.d.ts",
-        "default": "./dist/box/index.js"
+        "types": "./dist/input.d.ts",
+        "default": "./dist/input.js"
       }
     },
-    "./tree": {
+    "./output": {
       "import": {
-        "types": "./dist/tree/index.d.ts",
-        "default": "./dist/tree/index.js"
+        "types": "./dist/output.d.ts",
+        "default": "./dist/output.js"
       }
     },
-    "./demo/section": {
+    "./package.json": "./package.json",
+    "./pagination": {
       "import": {
-        "types": "./dist/demo/section.d.ts",
-        "default": "./dist/demo/section.js"
+        "types": "./dist/pagination.d.ts",
+        "default": "./dist/pagination.js"
       }
     },
-    "./render": {
+    "./query": {
       "import": {
-        "types": "./dist/render/index.d.ts",
-        "default": "./dist/render/index.js"
+        "types": "./dist/query.d.ts",
+        "default": "./dist/query.js"
       }
     },
     "./terminal": {
@@ -75,160 +82,10 @@
         "default": "./dist/terminal/detection.js"
       }
     },
-    "./prompt/text": {
-      "import": {
-        "types": "./dist/prompt/text.d.ts",
-        "default": "./dist/prompt/text.js"
-      }
-    },
-    "./prompt/types": {
+    "./text": {
       "import": {
-        "types": "./dist/prompt/types.d.ts",
-        "default": "./dist/prompt/types.js"
-      }
-    },
-    "./prompt/validators": {
-      "import": {
-        "types": "./dist/prompt/validators.d.ts",
-        "default": "./dist/prompt/validators.js"
-      }
-    },
-    "./prompt": {
-      "import": {
-        "types": "./dist/prompt/index.d.ts",
-        "default": "./dist/prompt/index.js"
-      }
-    },
-    "./streaming/spinner": {
-      "import": {
-        "types": "./dist/streaming/spinner.d.ts",
-        "default": "./dist/streaming/spinner.js"
-      }
-    },
-    "./streaming/ansi": {
-      "import": {
-        "types": "./dist/streaming/ansi.d.ts",
-        "default": "./dist/streaming/ansi.js"
-      }
-    },
-    "./streaming/writer": {
-      "import": {
-        "types": "./dist/streaming/writer.d.ts",
-        "default": "./dist/streaming/writer.js"
-      }
-    },
-    "./streaming": {
-      "import": {
-        "types": "./dist/streaming/index.d.ts",
-        "default": "./dist/streaming/index.js"
-      }
-    },
-    "./theme/presets/rounded": {
-      "import": {
-        "types": "./dist/theme/presets/rounded.d.ts",
-        "default": "./dist/theme/presets/rounded.js"
-      }
-    },
-    "./theme/presets/bold": {
-      "import": {
-        "types": "./dist/theme/presets/bold.d.ts",
-        "default": "./dist/theme/presets/bold.js"
-      }
-    },
-    "./theme/presets/minimal": {
-      "import": {
-        "types": "./dist/theme/presets/minimal.d.ts",
-        "default": "./dist/theme/presets/minimal.js"
-      }
-    },
-    "./theme/presets/default": {
-      "import": {
-        "types": "./dist/theme/presets/default.d.ts",
-        "default": "./dist/theme/presets/default.js"
-      }
-    },
-    "./theme/presets": {
-      "import": {
-        "types": "./dist/theme/presets/index.d.ts",
-        "default": "./dist/theme/presets/index.js"
-      }
-    },
-    "./prompt/confirm": {
-      "import": {
-        "types": "./dist/prompt/confirm.d.ts",
-        "default": "./dist/prompt/confirm.js"
-      }
-    },
-    "./prompt/select": {
-      "import": {
-        "types": "./dist/prompt/select.d.ts",
-        "default": "./dist/prompt/select.js"
-      }
-    },
-    "./prompt/group": {
-      "import": {
-        "types": "./dist/prompt/group.d.ts",
-        "default": "./dist/prompt/group.js"
-      }
-    },
-    "./list": {
-      "import": {
-        "types": "./dist/list/index.d.ts",
-        "default": "./dist/list/index.js"
-      }
-    },
-    "./colors": {
-      "import": {
-        "types": "./dist/colors/index.d.ts",
-        "default": "./dist/colors/index.js"
-      }
-    },
-    "./table": {
-      "import": {
-        "types": "./dist/table/index.d.ts",
-        "default": "./dist/table/index.js"
-      }
-    },
-    "./theme/context": {
-      "import": {
-        "types": "./dist/theme/context.d.ts",
-        "default": "./dist/theme/context.js"
-      }
-    },
-    "./theme/types": {
-      "import": {
-        "types": "./dist/theme/types.d.ts",
-        "default": "./dist/theme/types.js"
-      }
-    },
-    "./theme": {
-      "import": {
-        "types": "./dist/theme/index.d.ts",
-        "default": "./dist/theme/index.js"
-      }
-    },
-    "./theme/create": {
-      "import": {
-        "types": "./dist/theme/create.d.ts",
-        "default": "./dist/theme/create.js"
-      }
-    },
-    "./theme/resolve": {
-      "import": {
-        "types": "./dist/theme/resolve.d.ts",
-        "default": "./dist/theme/resolve.js"
-      }
-    },
-    "./pagination": {
-      "import": {
-        "types": "./dist/pagination.d.ts",
-        "default": "./dist/pagination.js"
-      }
-    },
-    "./input": {
-      "import": {
-        "types": "./dist/input.d.ts",
-        "default": "./dist/input.js"
+        "types": "./dist/text.d.ts",
+        "default": "./dist/text.js"
       }
     },
     "./types": {
@@ -237,25 +94,12 @@
         "default": "./dist/types.js"
       }
     },
-    "./actions": {
+    "./verbs": {
       "import": {
-        "types": "./dist/actions.d.ts",
-        "default": "./dist/actions.js"
+        "types": "./dist/verbs.d.ts",
+        "default": "./dist/verbs.js"
       }
-    },
-    ".": {
-      "import": {
-        "types": "./dist/index.d.ts",
-        "default": "./dist/index.js"
-      }
-    },
-    "./command": {
-      "import": {
-        "types": "./dist/command.d.ts",
-        "default": "./dist/command.js"
-      }
-    },
-    "./package.json": "./package.json"
+    }
   },
   "sideEffects": false,
   "scripts": {
@@ -269,20 +113,22 @@
   },
   "dependencies": {
     "@clack/prompts": "^0.11.0",
-    "@outfitter/config": "0.3.0",
-    "@outfitter/contracts": "0.2.0",
-    "@outfitter/types": "0.2.0",
     "better-result": "^2.5.1",
     "commander": "^14.0.2"
   },
+  "peerDependencies": {
+    "@outfitter/config": ">=0.3.0",
+    "@outfitter/contracts": ">=0.2.0",
+    "@outfitter/types": ">=0.2.0",
+    "zod": "^4.3.5"
+  },
   "devDependencies": {
+    "@outfitter/config": "0.3.1",
+    "@outfitter/contracts": "0.3.0",
     "@types/bun": "^1.3.7",
     "@types/node": "^25.0.10",
     "typescript": "^5.9.3"
   },
-  "peerDependencies": {
-    "zod": "^4.3.5"
-  },
   "engines": {
     "bun": ">=1.3.7"
   },

package/dist/borders/index.d.ts

@@ -1,3 +0,0 @@
-import "../shared/@outfitter/cli-w7w7ta31";
-import { BORDERS, BorderCharacters, BorderStyle, LinePosition, drawHorizontalLine, getBorderCharacters } from "../shared/@outfitter/cli-fakncnjp";
-export { getBorderCharacters, drawHorizontalLine, LinePosition, BorderStyle, BorderCharacters, BORDERS };