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

package/dist/shared/@outfitter/cli-s0kkx9m1.d.ts

@@ -0,0 +1,164 @@
+import { IndicatorCategory } from "./cli-sx67mmfx";
+import { DelimiterName } from "./cli-hnpbqmc8";
+import { TreeGuideStyle } from "./cli-3b7ed3rm";
+import { SpinnerStyle } from "./cli-e5ms1y0x";
+import { BorderCharacters, BorderStyle } from "./cli-fakncnjp";
+/**
+* A glyph with unicode and ASCII fallback representations.
+*
+* Used for characters that may not be available in all terminals.
+* The appropriate character is selected at runtime based on terminal capability.
+*
+* @example
+* ```typescript
+* const bullet: GlyphPair = { unicode: "•", fallback: "*" };
+* const checkbox: GlyphPair = { unicode: "☑", fallback: "[x]" };
+* ```
+*/
+interface GlyphPair {
+	/** Unicode character for modern terminals */
+	unicode: string;
+	/** ASCII fallback for limited terminals */
+	fallback: string;
+}
+/**
+* Semantic states that can be mapped to visual markers.
+*
+* These represent the logical state of an item, which themes translate
+* to specific visual representations.
+*/
+type SemanticState = "default" | "current" | "focused" | "checked" | "disabled" | "success" | "warning" | "error" | "info";
+/**
+* Specification for how to render a semantic state marker.
+*
+* Can either reference an existing indicator from the INDICATORS registry,
+* or provide a custom glyph pair.
+*
+* @example
+* ```typescript
+* // Reference existing indicator
+* const successMarker: MarkerSpec = {
+*   type: "indicator",
+*   category: "status",
+*   name: "success"
+* };
+*
+* // Custom glyph
+* const starMarker: MarkerSpec = {
+*   type: "custom",
+*   glyph: { unicode: "★", fallback: "*" }
+* };
+* ```
+*/
+type MarkerSpec = {
+	type: "indicator";
+	category: IndicatorCategory;
+	name: string;
+} | {
+	type: "custom";
+	glyph: GlyphPair;
+};
+/**
+* Semantic color tokens as ANSI escape codes.
+*
+* Colors are stored as raw ANSI codes and can be empty strings
+* when colors are disabled.
+*/
+interface ThemeColors {
+	/** Green - success messages, completed items */
+	success: string;
+	/** Yellow - warnings, caution */
+	warning: string;
+	/** Red - errors, failures */
+	error: string;
+	/** Blue - informational messages */
+	info: string;
+	/** Default text color (typically empty string) */
+	primary: string;
+	/** Gray - secondary text */
+	secondary: string;
+	/** Dim - de-emphasized text */
+	muted: string;
+	/** Cyan - interactive elements, highlights */
+	accent: string;
+	/** Bold - strong emphasis */
+	highlight: string;
+	/** Cyan + underline - URLs, clickable references */
+	link: string;
+	/** Bright red - dangerous actions */
+	destructive: string;
+	/** Dim gray - less prominent than muted */
+	subtle: string;
+}
+/**
+* Default spacing values for various components.
+*/
+interface ThemeSpacing {
+	/** Default padding inside boxes (characters) */
+	boxPadding: number;
+	/** Indentation for nested list items (characters) */
+	listIndent: number;
+	/** Gap between items in vertical stacks (lines) */
+	stackGap: number;
+	/** Gap between items in horizontal stacks (characters) */
+	horizontalGap: number;
+}
+/**
+* Complete visual theme configuration.
+*
+* Consolidates all visual primitives (borders, delimiters, markers, guides,
+* colors) into a cohesive design system. Themes can be used as-is (presets)
+* or customized via {@link createVisualTheme}.
+*
+* @example
+* ```typescript
+* import { defaultTheme, roundedTheme, createVisualTheme } from "@outfitter/cli/theme";
+*
+* // Use a preset
+* const box = renderBox("Hello", { theme: roundedTheme });
+*
+* // Create a custom theme
+* const brandTheme = createVisualTheme({
+*   extends: roundedTheme,
+*   overrides: {
+*     colors: { accent: "\x1b[38;5;39m" },
+*     spacing: { boxPadding: 2 }
+*   }
+* });
+* ```
+*/
+interface VisualTheme {
+	/** Theme identifier */
+	name: string;
+	/** Border style preset name */
+	border: BorderStyle;
+	/** Derived border characters for the border style */
+	borderChars: BorderCharacters;
+	/** Tree guide style for hierarchical displays */
+	treeGuide: TreeGuideStyle;
+	/** Default delimiter for inline separators */
+	delimiter: DelimiterName;
+	/** Map of semantic states to marker specifications */
+	markers: Record<SemanticState, MarkerSpec>;
+	/** Default list bullet glyph */
+	listBullet: GlyphPair;
+	/** Checkbox glyphs for checked/unchecked states */
+	checkbox: {
+		checked: GlyphPair;
+		unchecked: GlyphPair;
+	};
+	/** Semantic color tokens */
+	colors: ThemeColors;
+	/** Default spacing values */
+	spacing: ThemeSpacing;
+	/** Default spinner animation style */
+	spinner: SpinnerStyle;
+}
+/**
+* Partial theme for overriding specific properties.
+*
+* Used by {@link createVisualTheme} to allow partial customization
+* while inheriting defaults.
+*/
+type PartialVisualTheme = { [K in keyof VisualTheme]? : K extends "colors" ? Partial<ThemeColors> : K extends "spacing" ? Partial<ThemeSpacing> : K extends "markers" ? Partial<Record<SemanticState, MarkerSpec>> : K extends "checkbox" ? Partial<VisualTheme["checkbox"]> : VisualTheme[K] };
+export { GlyphPair, SemanticState, MarkerSpec, ThemeColors, ThemeSpacing, VisualTheme, PartialVisualTheme };

package/dist/shared/@outfitter/cli-snxj55n6.js

@@ -0,0 +1,43 @@
+// @bun
+import {
+  createCancelledError
+} from "./cli-8bwaw3pz.js";
+
+// packages/cli/src/prompt/text.ts
+import { isCancel, password, text } from "@clack/prompts";
+import { Result } from "better-result";
+async function promptText(options) {
+  const textOptions = {
+    message: options.message
+  };
+  if (options.placeholder !== undefined) {
+    textOptions.placeholder = options.placeholder;
+  }
+  if (options.defaultValue !== undefined) {
+    textOptions.defaultValue = options.defaultValue;
+  }
+  if (options.validate !== undefined) {
+    textOptions.validate = options.validate;
+  }
+  const result = await text(textOptions);
+  if (isCancel(result)) {
+    return Result.err(createCancelledError());
+  }
+  return Result.ok(result);
+}
+async function promptPassword(options) {
+  const passwordOptions = {
+    message: options.message,
+    mask: options.mask ?? "\u2022"
+  };
+  if (options.validate !== undefined) {
+    passwordOptions.validate = options.validate;
+  }
+  const result = await password(passwordOptions);
+  if (isCancel(result)) {
+    return Result.err(createCancelledError());
+  }
+  return Result.ok(result);
+}
+
+export { promptText, promptPassword };

package/dist/shared/@outfitter/cli-swwxvjvm.d.ts

@@ -0,0 +1,24 @@
+import { VisualTheme } from "./cli-s0kkx9m1";
+/**
+* Rounded visual theme.
+*
+* Features:
+* - Rounded box-drawing corners (╭─╮)
+* - Rounded tree guide style
+* - Softer visual aesthetic
+*
+* Inherits all other properties from {@link defaultTheme}.
+*
+* @example
+* ```typescript
+* import { roundedTheme } from "@outfitter/cli/theme/presets";
+*
+* // Use rounded styling
+* const box = renderBox("Hello", { border: roundedTheme.border });
+* // ╭───────╮
+* // │ Hello │
+* // ╰───────╯
+* ```
+*/
+declare const roundedTheme: VisualTheme;
+export { roundedTheme };

package/dist/shared/@outfitter/cli-sx67mmfx.d.ts

@@ -0,0 +1,98 @@
+/**
+* Indicator primitives for CLI output.
+*
+* Provides status symbols, selection indicators, list bullets, and progress
+* markers with unicode and ASCII fallback support.
+*
+* @packageDocumentation
+*/
+/**
+* Categories of indicators available.
+*/
+type IndicatorCategory = "status" | "marker" | "progress" | "triangle" | "special" | "directional" | "math";
+/**
+* An indicator with unicode and fallback representations.
+*/
+interface IndicatorSet {
+	/** Unicode character for modern terminals */
+	unicode: string;
+	/** ASCII fallback for limited terminals */
+	fallback: string;
+	/** Optional semantic color name */
+	color?: string;
+}
+/**
+* All available indicators organized by category.
+*
+* @example
+* ```typescript
+* import { INDICATORS, getIndicator } from "@outfitter/cli/render";
+*
+* // Access directly
+* console.log(INDICATORS.status.success.unicode); // "✔"
+*
+* // Or use helper
+* console.log(getIndicator("status", "success")); // "✔" or "[ok]"
+* ```
+*/
+declare const INDICATORS: Record<IndicatorCategory, Record<string, IndicatorSet>>;
+/**
+* Detects if the terminal supports Unicode characters.
+*
+* Checks for:
+* - CI environments (usually support unicode)
+* - Windows Terminal / ConEmu
+* - TERM containing xterm/vt100
+* - Locale settings
+*
+* @returns true if unicode is likely supported
+*/
+declare function isUnicodeSupported(): boolean;
+/**
+* Gets an indicator character with automatic unicode/fallback selection.
+*
+* @param category - The indicator category
+* @param name - The indicator name within the category
+* @param forceUnicode - Override unicode detection (useful for testing)
+* @returns The appropriate character for the current terminal
+*
+* @example
+* ```typescript
+* // Automatic detection
+* console.log(getIndicator("status", "success"));
+*
+* // Force unicode
+* console.log(getIndicator("status", "success", true)); // "✔"
+*
+* // Force fallback
+* console.log(getIndicator("status", "success", false)); // "[ok]"
+* ```
+*/
+declare function getIndicator(category: IndicatorCategory, name: string, forceUnicode?: boolean): string;
+/**
+* Progress indicator styles.
+*/
+type ProgressStyle = "circle" | "vertical" | "horizontal" | "shade";
+/**
+* Gets a progress indicator based on current/max values.
+*
+* @param style - The progress style (circle, vertical, horizontal, shade)
+* @param current - Current progress value
+* @param max - Maximum progress value
+* @param forceUnicode - Override unicode detection
+* @returns The appropriate progress indicator character
+*
+* @example
+* ```typescript
+* // Circle progress at 50%
+* getProgressIndicator("circle", 50, 100); // "◑"
+*
+* // Vertical block at 75%
+* getProgressIndicator("vertical", 6, 8); // "▆"
+*
+* // Horizontal bar at 100%
+* getProgressIndicator("horizontal", 1, 1); // "█"
+* ```
+*/
+declare function getProgressIndicator(style: ProgressStyle, current: number, max: number, forceUnicode?: boolean): string;
+export { IndicatorCategory, IndicatorSet, INDICATORS, isUnicodeSupported, getIndicator, ProgressStyle, getProgressIndicator };

package/dist/shared/@outfitter/cli-tarpsa8a.js

@@ -0,0 +1,30 @@
+// @bun
+import {
+  defaultTheme
+} from "./cli-cs45xd6q.js";
+import {
+  BORDERS,
+  init_borders
+} from "./cli-85fg2vr5.js";
+
+// packages/cli/src/theme/presets/minimal.ts
+init_borders();
+var minimalTheme = {
+  ...defaultTheme,
+  name: "minimal",
+  border: "ascii",
+  borderChars: BORDERS.ascii,
+  treeGuide: "single",
+  delimiter: "bullet",
+  markers: {
+    ...defaultTheme.markers
+  },
+  listBullet: { unicode: "-", fallback: "-" },
+  checkbox: {
+    checked: { unicode: "[x]", fallback: "[x]" },
+    unchecked: { unicode: "[ ]", fallback: "[ ]" }
+  },
+  spinner: "line"
+};
+
+export { minimalTheme };

package/dist/shared/@outfitter/cli-thvzhjd1.js

@@ -0,0 +1,126 @@
+// @bun
+import {
+  renderList
+} from "./cli-xg5y5fhk.js";
+import {
+  LIST_STYLE_META,
+  getListStyles
+} from "./cli-kc84wmch.js";
+import {
+  getExample
+} from "./cli-xep6v2c0.js";
+import {
+  demoSection
+} from "./cli-34fqr7bp.js";
+
+// packages/cli/src/demo/renderers/list.ts
+function renderListDemo(config, theme) {
+  const showCode = config.showCode ?? true;
+  const showDescriptions = config.showDescriptions ?? true;
+  const lines = [];
+  lines.push(demoSection("List Styles"));
+  lines.push("");
+  if (showCode) {
+    lines.push('import { renderList } from "@outfitter/cli/render";');
+    lines.push("");
+  }
+  const items = getExample("listItems", config.examples);
+  const styles = getListStyles();
+  for (const style of styles) {
+    const meta = LIST_STYLE_META[style];
+    lines.push(`${meta.label.toUpperCase()} STYLE`);
+    if (showDescriptions) {
+      lines.push(theme.muted(meta.description));
+    }
+    lines.push("");
+    if (showCode) {
+      lines.push(`renderList(items, { style: "${style}" })`);
+      lines.push("");
+    }
+    if (style === "checkbox") {
+      const output = renderList(items, {
+        style,
+        checked: new Set([1])
+      });
+      lines.push(output);
+    } else {
+      const output = renderList(items, { style });
+      lines.push(output);
+    }
+    lines.push("");
+  }
+  lines.push(demoSection("Nested Lists"));
+  lines.push("");
+  const nestedItems = [
+    "Top level item",
+    {
+      text: "Parent with children",
+      children: ["Child one", "Child two"]
+    },
+    "Another top level"
+  ];
+  if (showCode) {
+    lines.push("renderList([");
+    lines.push('  "Top level item",');
+    lines.push('  { text: "Parent with children", children: ["Child one", "Child two"] },');
+    lines.push('  "Another top level",');
+    lines.push("])");
+    lines.push("");
+  }
+  lines.push(renderList(nestedItems));
+  lines.push("");
+  lines.push(demoSection("Numbered with Nesting"));
+  lines.push("");
+  const numberedNested = [
+    {
+      text: "First section",
+      children: [
+        {
+          text: "Subsection A",
+          children: ["Detail i", "Detail ii"]
+        },
+        "Subsection B"
+      ]
+    },
+    "Second section"
+  ];
+  if (showCode) {
+    lines.push('renderList(items, { style: "number" })');
+    lines.push("");
+  }
+  lines.push(renderList(numberedNested, { style: "number" }));
+  lines.push("");
+  lines.push(demoSection("Mixed Styles"));
+  lines.push("");
+  if (showDescriptions) {
+    lines.push(theme.muted("Use childStyle to override style for children"));
+    lines.push("");
+  }
+  const mixedItems = [
+    {
+      text: "Requirements",
+      childStyle: "bullet",
+      children: ["Must be fast", "Must be reliable"]
+    },
+    {
+      text: "Tasks",
+      childStyle: "checkbox",
+      children: [
+        { text: "Write tests", checked: true },
+        { text: "Deploy to prod", checked: false }
+      ]
+    }
+  ];
+  if (showCode) {
+    lines.push("renderList([");
+    lines.push('  { text: "Requirements", childStyle: "bullet", children: [...] },');
+    lines.push('  { text: "Tasks", childStyle: "checkbox", children: [...] },');
+    lines.push('], { style: "number" })');
+    lines.push("");
+  }
+  lines.push(renderList(mixedItems, { style: "number" }));
+  return lines.join(`
+`);
+}
+
+export { renderListDemo };

package/dist/shared/@outfitter/cli-tqewy503.d.ts

@@ -0,0 +1,36 @@
+import { CancelledError, PromptResult } from "./cli-3f12z5kf";
+import { Result } from "better-result";
+/**
+* A step in a prompt group.
+*/
+type PromptStep<T> = () => PromptResult<T>;
+/**
+* Collects multiple prompts into a single result object.
+*
+* If any prompt is cancelled, the entire group fails with CancelledError.
+*
+* @param steps - Object of named prompt steps
+* @returns Ok with collected values or Err with CancelledError
+*
+* @example
+* ```typescript
+* import { promptGroup, promptText, promptSelect } from "@outfitter/cli/prompt";
+*
+* const result = await promptGroup({
+*   name: () => promptText({ message: "Name:" }),
+*   role: () => promptSelect({
+*     message: "Role:",
+*     options: [
+*       { value: "admin", label: "Admin" },
+*       { value: "user", label: "User" },
+*     ],
+*   }),
+* });
+*
+* if (result.isOk()) {
+*   console.log(`Creating ${result.value.role}: ${result.value.name}`);
+* }
+* ```
+*/
+declare function promptGroup<T extends Record<string, unknown>>(steps: { [K in keyof T] : PromptStep<T[K]> }): Promise<Result<T, CancelledError>>;
+export { PromptStep, promptGroup };