@outfitter/cli 0.1.0-rc.1 → 0.1.0-rc.3

package/dist/types.d.ts

@@ -1,253 +1,2 @@
-import { Command } from "commander";
-import { CancelledError, ErrorCategory, ValidationError } from "@outfitter/contracts";
-import { Result } from "better-result";
-/**
-* Configuration for creating a CLI instance.
-*
-* @example
-* ```typescript
-* const config: CLIConfig = {
-*   name: "waymark",
-*   version: "1.0.0",
-*   description: "A note management CLI",
-* };
-* ```
-*/
-interface CLIConfig {
-	/** CLI name (used in help output and error messages) */
-	readonly name: string;
-	/** CLI version (displayed with --version) */
-	readonly version: string;
-	/** CLI description (displayed in help output) */
-	readonly description?: string;
-	/** Custom error handler */
-	readonly onError?: (error: Error) => void;
-	/** Custom exit handler (defaults to process.exit) */
-	readonly onExit?: (code: number) => never;
-}
-/**
-* CLI instance returned by createCLI.
-*/
-interface CLI {
-	/** Register a command with the CLI */
-	register(command: CommandBuilder | Command): this;
-	/** Parse arguments and execute the matched command */
-	parse(argv?: readonly string[]): Promise<void>;
-	/** Get the underlying Commander program */
-	readonly program: Command;
-}
-/**
-* Configuration for a single command.
-*/
-interface CommandConfig {
-	/** Command name and argument syntax (e.g., "list" or "get <id>") */
-	readonly name: string;
-	/** Command description */
-	readonly description?: string;
-	/** Command aliases */
-	readonly aliases?: readonly string[];
-	/** Whether to hide from help output */
-	readonly hidden?: boolean;
-}
-/**
-* Action function executed when a command is invoked.
-*
-* @typeParam TFlags - Type of parsed command flags
-*/
-type CommandAction<TFlags extends CommandFlags = CommandFlags> = (context: {
-	/** Parsed command-line arguments */
-	readonly args: readonly string[];
-	/** Parsed command flags */
-	readonly flags: TFlags;
-	/** Raw Commander command instance */
-	readonly command: Command;
-}) => Promise<void> | void;
-/**
-* Base type for command flags.
-* All flag types must extend this.
-*/
-type CommandFlags = Record<string, unknown>;
-/**
-* Builder interface for constructing commands fluently.
-*/
-interface CommandBuilder {
-	/** Set command description */
-	description(text: string): this;
-	/** Add a command option/flag */
-	option(flags: string, description: string, defaultValue?: unknown): this;
-	/** Add a required option */
-	requiredOption(flags: string, description: string, defaultValue?: unknown): this;
-	/** Add command aliases */
-	alias(alias: string): this;
-	/** Set the action handler */
-	action<TFlags extends CommandFlags = CommandFlags>(handler: CommandAction<TFlags>): this;
-	/** Build the underlying Commander command */
-	build(): Command;
-}
-/**
-* Available output modes for CLI commands.
-*/
-type OutputMode = "human" | "json" | "jsonl" | "tree" | "table";
-/**
-* Options for the output() function.
-*/
-interface OutputOptions {
-	/** Force a specific output mode (overrides flag detection) */
-	readonly mode?: OutputMode;
-	/** Stream to write to (defaults to stdout) */
-	readonly stream?: NodeJS.WritableStream;
-	/** Whether to pretty-print JSON output */
-	readonly pretty?: boolean;
-	/** Exit code to use after output (undefined = don't exit) */
-	readonly exitCode?: number;
-}
-/**
-* Options for collectIds() input utility.
-*
-* @example
-* ```typescript
-* const ids = await collectIds(args, {
-*   allowFile: true,   // @file expansion
-*   allowStdin: true,  // - reads from stdin
-* });
-* ```
-*/
-interface CollectIdsOptions {
-	/** Allow @file expansion (reads IDs from file) */
-	readonly allowFile?: boolean;
-	/** Allow glob patterns */
-	readonly allowGlob?: boolean;
-	/** Allow reading from stdin with "-" */
-	readonly allowStdin?: boolean;
-	/** Separator for comma-separated values */
-	readonly separator?: string;
-}
-/**
-* Options for expandFileArg() input utility.
-*/
-interface ExpandFileOptions {
-	/** Encoding for file reads (defaults to utf-8) */
-	readonly encoding?: BufferEncoding;
-	/** Maximum file size to read (in bytes) */
-	readonly maxSize?: number;
-	/** Whether to trim the file content */
-	readonly trim?: boolean;
-}
-/**
-* Options for parseGlob() input utility.
-*/
-interface ParseGlobOptions {
-	/** Current working directory for glob resolution */
-	readonly cwd?: string;
-	/** Whether to follow symlinks */
-	readonly followSymlinks?: boolean;
-	/** Patterns to exclude */
-	readonly ignore?: readonly string[];
-	/** Only match files (not directories) */
-	readonly onlyFiles?: boolean;
-	/** Only match directories (not files) */
-	readonly onlyDirectories?: boolean;
-}
-/**
-* Options for normalizeId().
-*/
-interface NormalizeIdOptions {
-	/** Whether to lowercase the ID */
-	readonly lowercase?: boolean;
-	/** Whether to trim whitespace */
-	readonly trim?: boolean;
-	/** Minimum length requirement */
-	readonly minLength?: number;
-	/** Maximum length requirement */
-	readonly maxLength?: number;
-	/** Pattern the ID must match */
-	readonly pattern?: RegExp;
-}
-/**
-* Options for confirmDestructive().
-*/
-interface ConfirmDestructiveOptions {
-	/** Message to display to the user */
-	readonly message: string;
-	/** Whether to bypass confirmation (e.g., --yes flag) */
-	readonly bypassFlag?: boolean;
-	/** Number of items affected (shown in confirmation) */
-	readonly itemCount?: number;
-}
-/**
-* Numeric or date range parsed from CLI input.
-*/
-type Range = NumericRange | DateRange;
-/**
-* Numeric range (e.g., "1-10").
-*/
-interface NumericRange {
-	readonly type: "number";
-	readonly min: number;
-	readonly max: number;
-}
-/**
-* Date range (e.g., "2024-01-01..2024-12-31").
-*/
-interface DateRange {
-	readonly type: "date";
-	readonly start: Date;
-	readonly end: Date;
-}
-/**
-* Filter expression parsed from CLI input.
-*/
-interface FilterExpression {
-	readonly field: string;
-	readonly value: string;
-	readonly operator?: "eq" | "ne" | "gt" | "lt" | "gte" | "lte" | "contains";
-}
-/**
-* Sort criteria parsed from CLI input.
-*/
-interface SortCriteria {
-	readonly field: string;
-	readonly direction: "asc" | "desc";
-}
-/**
-* Key-value pair parsed from CLI input.
-*/
-interface KeyValuePair {
-	readonly key: string;
-	readonly value: string;
-}
-/**
-* State for paginated command results.
-*/
-interface PaginationState {
-	/** Cursor for the next page */
-	readonly cursor: string;
-	/** Command that generated this state */
-	readonly command: string;
-	/** Context key for scoping pagination */
-	readonly context?: string;
-	/** Timestamp when state was created */
-	readonly timestamp: number;
-	/** Whether there are more results */
-	readonly hasMore: boolean;
-	/** Total count (if known) */
-	readonly total?: number;
-}
-/**
-* Options for cursor persistence operations.
-*/
-interface CursorOptions {
-	/** Command name for cursor scoping */
-	readonly command: string;
-	/** Context key for additional scoping */
-	readonly context?: string;
-	/** Tool name for XDG path resolution */
-	readonly toolName: string;
-	/** Maximum age in milliseconds before a cursor is treated as expired */
-	readonly maxAgeMs?: number;
-	/** Whether there are more results (defaults to true) */
-	readonly hasMore?: boolean;
-	/** Total count of results (if known) */
-	readonly total?: number;
-}
+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 };

package/dist/types.js

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

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@outfitter/cli",
-  "description": "Typed CLI runtime with output contracts, input parsing, and pagination",
-  "version": "0.1.0-rc.1",
+  "description": "Typed CLI runtime with terminal detection, rendering, output contracts, and input parsing",
+  "version": "0.1.0-rc.3",
   "type": "module",
   "files": [
     "dist"
@@ -9,28 +9,220 @@
   "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"
       }
     },
-    "./types": {
+    "./render": {
       "import": {
-        "types": "./dist/types.d.ts",
-        "default": "./dist/types.js"
+        "types": "./dist/render/index.d.ts",
+        "default": "./dist/render/index.js"
       }
     },
-    ".": {
+    "./theme/presets": {
       "import": {
-        "types": "./dist/index.d.ts",
-        "default": "./dist/index.js"
+        "types": "./dist/theme/presets/index.d.ts",
+        "default": "./dist/theme/presets/index.js"
       }
     },
-    "./pagination": {
+    "./theme/presets/minimal": {
       "import": {
-        "types": "./dist/pagination.d.ts",
-        "default": "./dist/pagination.js"
+        "types": "./dist/theme/presets/minimal.d.ts",
+        "default": "./dist/theme/presets/minimal.js"
+      }
+    },
+    "./streaming": {
+      "import": {
+        "types": "./dist/streaming/index.d.ts",
+        "default": "./dist/streaming/index.js"
+      }
+    },
+    "./streaming/writer": {
+      "import": {
+        "types": "./dist/streaming/writer.d.ts",
+        "default": "./dist/streaming/writer.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"
+      }
+    },
+    "./box": {
+      "import": {
+        "types": "./dist/box/index.d.ts",
+        "default": "./dist/box/index.js"
+      }
+    },
+    "./theme/create": {
+      "import": {
+        "types": "./dist/theme/create.d.ts",
+        "default": "./dist/theme/create.js"
+      }
+    },
+    "./theme": {
+      "import": {
+        "types": "./dist/theme/index.d.ts",
+        "default": "./dist/theme/index.js"
+      }
+    },
+    "./theme/context": {
+      "import": {
+        "types": "./dist/theme/context.d.ts",
+        "default": "./dist/theme/context.js"
+      }
+    },
+    "./theme/resolve": {
+      "import": {
+        "types": "./dist/theme/resolve.d.ts",
+        "default": "./dist/theme/resolve.js"
+      }
+    },
+    "./theme/types": {
+      "import": {
+        "types": "./dist/theme/types.d.ts",
+        "default": "./dist/theme/types.js"
+      }
+    },
+    "./theme/presets/default": {
+      "import": {
+        "types": "./dist/theme/presets/default.d.ts",
+        "default": "./dist/theme/presets/default.js"
+      }
+    },
+    "./theme/presets/bold": {
+      "import": {
+        "types": "./dist/theme/presets/bold.d.ts",
+        "default": "./dist/theme/presets/bold.js"
+      }
+    },
+    "./theme/presets/rounded": {
+      "import": {
+        "types": "./dist/theme/presets/rounded.d.ts",
+        "default": "./dist/theme/presets/rounded.js"
+      }
+    },
+    "./prompt": {
+      "import": {
+        "types": "./dist/prompt/index.d.ts",
+        "default": "./dist/prompt/index.js"
+      }
+    },
+    "./prompt/text": {
+      "import": {
+        "types": "./dist/prompt/text.d.ts",
+        "default": "./dist/prompt/text.js"
+      }
+    },
+    "./prompt/confirm": {
+      "import": {
+        "types": "./dist/prompt/confirm.d.ts",
+        "default": "./dist/prompt/confirm.js"
+      }
+    },
+    "./prompt/group": {
+      "import": {
+        "types": "./dist/prompt/group.d.ts",
+        "default": "./dist/prompt/group.js"
+      }
+    },
+    "./prompt/types": {
+      "import": {
+        "types": "./dist/prompt/types.d.ts",
+        "default": "./dist/prompt/types.js"
+      }
+    },
+    "./colors": {
+      "import": {
+        "types": "./dist/colors/index.d.ts",
+        "default": "./dist/colors/index.js"
+      }
+    },
+    "./terminal/detection": {
+      "import": {
+        "types": "./dist/terminal/detection.d.ts",
+        "default": "./dist/terminal/detection.js"
+      }
+    },
+    "./terminal": {
+      "import": {
+        "types": "./dist/terminal/index.d.ts",
+        "default": "./dist/terminal/index.js"
+      }
+    },
+    "./tree": {
+      "import": {
+        "types": "./dist/tree/index.d.ts",
+        "default": "./dist/tree/index.js"
+      }
+    },
+    "./table": {
+      "import": {
+        "types": "./dist/table/index.d.ts",
+        "default": "./dist/table/index.js"
+      }
+    },
+    "./list": {
+      "import": {
+        "types": "./dist/list/index.d.ts",
+        "default": "./dist/list/index.js"
+      }
+    },
+    "./borders": {
+      "import": {
+        "types": "./dist/borders/index.d.ts",
+        "default": "./dist/borders/index.js"
+      }
+    },
+    "./preset/standard": {
+      "import": {
+        "types": "./dist/preset/standard.d.ts",
+        "default": "./dist/preset/standard.js"
+      }
+    },
+    "./preset/full": {
+      "import": {
+        "types": "./dist/preset/full.d.ts",
+        "default": "./dist/preset/full.js"
+      }
+    },
+    "./prompt/select": {
+      "import": {
+        "types": "./dist/prompt/select.d.ts",
+        "default": "./dist/prompt/select.js"
+      }
+    },
+    "./prompt/validators": {
+      "import": {
+        "types": "./dist/prompt/validators.d.ts",
+        "default": "./dist/prompt/validators.js"
+      }
+    },
+    "./demo/section": {
+      "import": {
+        "types": "./dist/demo/section.d.ts",
+        "default": "./dist/demo/section.js"
+      }
+    },
+    "./demo": {
+      "import": {
+        "types": "./dist/demo/index.d.ts",
+        "default": "./dist/demo/index.js"
+      }
+    },
+    "./output": {
+      "import": {
+        "types": "./dist/output.d.ts",
+        "default": "./dist/output.js"
       }
     },
     "./input": {
@@ -39,12 +231,24 @@
         "default": "./dist/input.js"
       }
     },
+    "./pagination": {
+      "import": {
+        "types": "./dist/pagination.d.ts",
+        "default": "./dist/pagination.js"
+      }
+    },
     "./actions": {
       "import": {
         "types": "./dist/actions.d.ts",
         "default": "./dist/actions.js"
       }
     },
+    "./types": {
+      "import": {
+        "types": "./dist/types.d.ts",
+        "default": "./dist/types.js"
+      }
+    },
     "./command": {
       "import": {
         "types": "./dist/command.d.ts",
@@ -55,7 +259,7 @@
   },
   "sideEffects": false,
   "scripts": {
-    "build": "bunup --filter @outfitter/cli",
+    "build": "cd ../.. && bunup --filter @outfitter/cli",
     "test": "bun test",
     "test:watch": "bun test --watch",
     "lint": "biome lint ./src",
@@ -65,13 +269,14 @@
   },
   "dependencies": {
     "@clack/prompts": "^0.11.0",
-    "@outfitter/contracts": "workspace:*",
-    "@outfitter/types": "workspace:*",
+    "@outfitter/config": "0.1.0-rc.3",
+    "@outfitter/contracts": "0.1.0-rc.2",
+    "@outfitter/types": "0.1.0-rc.3",
     "better-result": "^2.5.1",
     "commander": "^14.0.2"
   },
   "devDependencies": {
-    "@types/bun": "^1.3.6",
+    "@types/bun": "^1.3.7",
     "@types/node": "^25.0.10",
     "typescript": "^5.9.3"
   },
@@ -79,7 +284,7 @@
     "zod": "^4.3.5"
   },
   "engines": {
-    "bun": ">=1.3.6"
+    "bun": ">=1.3.7"
   },
   "publishConfig": {
     "access": "public"
@@ -95,6 +300,9 @@
     "commander",
     "typescript",
     "bun",
-    "outfitter"
+    "outfitter",
+    "terminal",
+    "colors",
+    "renderers"
   ]
 }

package/dist/shared/@outfitter/cli-4yy82cmp.js

@@ -1,20 +0,0 @@
-// @bun
-var __create = Object.create;
-var __getProtoOf = Object.getPrototypeOf;
-var __defProp = Object.defineProperty;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __toESM = (mod, isNodeMode, target) => {
-  target = mod != null ? __create(__getProtoOf(mod)) : {};
-  const to = isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target;
-  for (let key of __getOwnPropNames(mod))
-    if (!__hasOwnProp.call(to, key))
-      __defProp(to, key, {
-        get: () => mod[key],
-        enumerable: true
-      });
-  return to;
-};
-var __require = import.meta.require;
-
-export { __toESM, __require };