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

package/dist/shared/@outfitter/cli-6j9qynm8.js

@@ -0,0 +1,118 @@
+// @bun
+import {
+  INDICATORS,
+  getIndicator,
+  getProgressIndicator
+} from "./cli-p1m5dhrs.js";
+import {
+  demoSection,
+  demoSubsection
+} from "./cli-34fqr7bp.js";
+
+// packages/cli/src/demo/renderers/indicators.ts
+function renderIndicatorsDemo(config, _theme) {
+  const showCode = config.showCode ?? true;
+  const lines = [];
+  lines.push(demoSection("Indicators"));
+  lines.push("");
+  if (showCode) {
+    lines.push('import { getIndicator, getProgressIndicator, INDICATORS } from "@outfitter/cli/render";');
+    lines.push("");
+  }
+  lines.push("Semantic indicators with Unicode and ASCII fallback support.");
+  lines.push("");
+  lines.push(demoSubsection("Status"));
+  lines.push("");
+  for (const [name, indicator] of Object.entries(INDICATORS.status)) {
+    const colorInfo = indicator.color ? ` (${indicator.color})` : "";
+    lines.push(`  ${indicator.unicode}  ${name.padEnd(10)} \u2192 ${indicator.fallback}${colorInfo}`);
+  }
+  lines.push("");
+  if (showCode) {
+    lines.push('getIndicator("status", "success")  // ' + getIndicator("status", "success", true));
+    lines.push('getIndicator("status", "error")    // ' + getIndicator("status", "error", true));
+    lines.push("");
+  }
+  lines.push(demoSubsection("Markers"));
+  lines.push("");
+  const markerGroups = {
+    Circles: [
+      "circle",
+      "circleOutline",
+      "circleDotted",
+      "circleSmall",
+      "circleDot",
+      "circleDotOutline"
+    ],
+    Squares: ["square", "squareOutline", "squareSmall", "squareSmallOutline"],
+    Lozenges: ["lozenge", "lozengeOutline"],
+    Checkboxes: ["checkbox", "checkboxChecked", "checkboxCross"],
+    Pointers: ["pointer", "pointerSmall", "dash"]
+  };
+  for (const [groupName, names] of Object.entries(markerGroups)) {
+    lines.push(`  ${groupName}:`);
+    for (const name of names) {
+      const indicator = INDICATORS.marker[name];
+      if (indicator) {
+        lines.push(`    ${indicator.unicode}  ${name.padEnd(18)} \u2192 ${indicator.fallback}`);
+      }
+    }
+    lines.push("");
+  }
+  lines.push(demoSubsection("Progress"));
+  lines.push("");
+  lines.push("  Circle:     \u25CB \u25D4 \u25D1 \u25D5 \u25CF");
+  lines.push("  Vertical:   \u2581 \u2582 \u2583 \u2584 \u2585 \u2586 \u2587 \u2588");
+  lines.push("  Horizontal: \u258F \u258E \u258D \u258C \u258B \u258A \u2589 \u2588");
+  lines.push("  Shade:      \u2591 \u2592 \u2593");
+  lines.push("");
+  if (showCode) {
+    lines.push("// Get progress indicator by percentage:");
+    lines.push('getProgressIndicator("circle", 50, 100)      // ' + getProgressIndicator("circle", 50, 100, true));
+    lines.push('getProgressIndicator("vertical", 6, 8)      // ' + getProgressIndicator("vertical", 6, 8, true));
+    lines.push('getProgressIndicator("horizontal", 4, 8)    // ' + getProgressIndicator("horizontal", 4, 8, true));
+    lines.push('getProgressIndicator("shade", 100, 100)     // ' + getProgressIndicator("shade", 100, 100, true));
+    lines.push("");
+  }
+  lines.push(demoSubsection("Triangles"));
+  lines.push("");
+  const triangleGroups = {
+    Up: ["up", "upSmall", "upOutline"],
+    Down: ["down", "downSmall", "downOutline"],
+    Left: ["left", "leftSmall", "leftOutline"],
+    Right: ["right", "rightSmall", "rightOutline"]
+  };
+  for (const [groupName, names] of Object.entries(triangleGroups)) {
+    const indicators = names.map((n) => INDICATORS.triangle[n]?.unicode ?? "").join("  ");
+    lines.push(`  ${groupName.padEnd(6)} ${indicators}`);
+  }
+  lines.push("");
+  lines.push(demoSubsection("Special"));
+  lines.push("");
+  for (const [name, indicator] of Object.entries(INDICATORS.special)) {
+    lines.push(`  ${indicator.unicode}  ${name.padEnd(14)} \u2192 ${indicator.fallback}`);
+  }
+  lines.push("");
+  lines.push(demoSubsection("Directional"));
+  lines.push("");
+  for (const [name, indicator] of Object.entries(INDICATORS.directional)) {
+    lines.push(`  ${indicator.unicode}  ${name.padEnd(16)} \u2192 ${indicator.fallback}`);
+  }
+  lines.push("");
+  lines.push(demoSubsection("Math"));
+  lines.push("");
+  for (const [name, indicator] of Object.entries(INDICATORS.math)) {
+    lines.push(`  ${indicator.unicode}  ${name.padEnd(16)} \u2192 ${indicator.fallback}`);
+  }
+  lines.push("");
+  lines.push(demoSubsection("Usage"));
+  lines.push("");
+  lines.push("\u2022 getIndicator(category, name) \u2014 auto-detects Unicode support");
+  lines.push("\u2022 getProgressIndicator(style, current, max) \u2014 maps value to step");
+  lines.push("\u2022 INDICATORS[category][name] \u2014 direct access to unicode/fallback");
+  lines.push("\u2022 Status indicators include semantic color hints");
+  return lines.join(`
+`);
+}
+
+export { renderIndicatorsDemo };

package/dist/shared/@outfitter/cli-6m988kh0.d.ts

@@ -0,0 +1,61 @@
+import { PartialVisualTheme, VisualTheme } from "./cli-s0kkx9m1";
+/**
+* Options for creating a visual theme.
+*/
+interface CreateVisualThemeOptions {
+	/**
+	* Base theme to extend from.
+	* Properties not overridden will be inherited from this theme.
+	* @default defaultTheme
+	*/
+	extends?: VisualTheme;
+	/**
+	* Properties to override on the base/extended theme.
+	* Supports partial overrides for nested objects (colors, spacing, markers).
+	*/
+	overrides?: PartialVisualTheme;
+}
+/**
+* Creates a visual theme by extending and/or overriding a base theme.
+*
+* This is the primary factory for creating custom themes. You can:
+* - Start from scratch (no options → defaultTheme)
+* - Extend an existing preset
+* - Override specific properties
+* - Combine extension and overrides
+*
+* When changing the `border` property, `borderChars` is automatically
+* updated to match the new border style.
+*
+* @param options - Configuration for theme creation
+* @returns A complete VisualTheme
+*
+* @example
+* ```typescript
+* // Start with defaults
+* const theme = createVisualTheme();
+*
+* // Extend a preset
+* const rounded = createVisualTheme({ extends: roundedTheme });
+*
+* // Override specific properties
+* const custom = createVisualTheme({
+*   overrides: {
+*     border: "double",
+*     colors: { success: "\x1b[38;5;82m" },
+*     spacing: { boxPadding: 2 }
+*   }
+* });
+*
+* // Extend and override
+* const brandTheme = createVisualTheme({
+*   extends: roundedTheme,
+*   overrides: {
+*     name: "brand",
+*     colors: { accent: "\x1b[38;5;39m" }
+*   }
+* });
+* ```
+*/
+declare function createVisualTheme(options?: CreateVisualThemeOptions): VisualTheme;
+export { CreateVisualThemeOptions, createVisualTheme };

package/dist/shared/@outfitter/cli-72kg550t.d.ts

@@ -0,0 +1,53 @@
+import { OutputOptions } from "./cli-ttt7r0j7";
+/**
+* Output data to the console with automatic mode selection.
+*
+* Respects --json, --jsonl, --tree, --table flags automatically.
+* Defaults to human-friendly output when no flags are present.
+*
+* @param data - The data to output
+* @param options - Output configuration options
+*
+* @example
+* ```typescript
+* import { output } from "@outfitter/cli";
+*
+* // Basic usage - mode auto-detected from flags
+* output(results);
+*
+* // Force JSON mode
+* output(results, { mode: "json" });
+*
+* // Pretty-print JSON
+* output(results, { mode: "json", pretty: true });
+*
+* // Output to stderr
+* output(errors, { stream: process.stderr });
+*
+* // Await for large outputs (recommended)
+* await output(largeDataset, { mode: "jsonl" });
+* ```
+*/
+declare function output(data: unknown, options?: OutputOptions): Promise<void>;
+/**
+* Exit the process with an error message.
+*
+* Formats the error according to the current output mode (human or JSON)
+* and exits with an appropriate exit code.
+*
+* @param error - The error to display
+* @returns Never returns (exits the process)
+*
+* @example
+* ```typescript
+* import { exitWithError } from "@outfitter/cli";
+*
+* try {
+*   await riskyOperation();
+* } catch (error) {
+*   exitWithError(error instanceof Error ? error : new Error(String(error)));
+* }
+* ```
+*/
+declare function exitWithError(error: Error, options?: OutputOptions): never;
+export { output, exitWithError };

package/dist/shared/@outfitter/cli-74ba31gz.js

@@ -0,0 +1,134 @@
+// @bun
+import {
+  getThemeMethodsByCategory
+} from "./cli-kc84wmch.js";
+import {
+  getExample
+} from "./cli-xep6v2c0.js";
+import {
+  demoSection
+} from "./cli-34fqr7bp.js";
+import {
+  ANSI,
+  applyColor,
+  createTokens,
+  init_colors,
+  resolveTokenColorEnabled
+} from "./cli-9nbyj2bt.js";
+import {
+  hasNoColorEnv,
+  init_detection,
+  resolveForceColorEnv
+} from "./cli-d9ad0rqj.js";
+
+// packages/cli/src/demo/renderers/colors.ts
+init_colors();
+init_detection();
+function renderColorsDemo(config, theme) {
+  const showCode = config.showCode ?? true;
+  const tokens = createTokens();
+  const colorEnabled = resolveTokenColorEnabled();
+  const lines = [];
+  lines.push(demoSection("Theme Colors (createTheme)", { case: "none" }));
+  lines.push("");
+  if (showCode) {
+    lines.push('import { createTheme } from "@outfitter/cli/render";');
+    lines.push("const theme = createTheme();");
+    lines.push("");
+  }
+  const { semantic } = getThemeMethodsByCategory();
+  for (const method of semantic) {
+    const text = getExample(method, config.examples);
+    const fn = theme[method];
+    const output = fn(text);
+    const code = `theme.${method}("${text}")`;
+    lines.push(`${code.padEnd(42)} \u2192 ${output}`);
+  }
+  lines.push("");
+  lines.push(demoSection("Utility Methods"));
+  lines.push("");
+  const { utility } = getThemeMethodsByCategory();
+  for (const method of utility) {
+    const text = getExample(method, config.examples);
+    const fn = theme[method];
+    const output = fn(text);
+    const code = `theme.${method}("${text}")`;
+    lines.push(`${code.padEnd(42)} \u2192 ${output}`);
+  }
+  lines.push("");
+  lines.push(demoSection("Direct Colors (applyColor)", { case: "none" }));
+  lines.push("");
+  if (showCode) {
+    lines.push('import { applyColor } from "@outfitter/cli/render";');
+    lines.push("");
+  }
+  const colors = [
+    "green",
+    "yellow",
+    "red",
+    "blue",
+    "cyan",
+    "magenta",
+    "gray"
+  ];
+  for (const color of colors) {
+    const code = `applyColor("text", "${color}")`;
+    const output = applyColor("text", color);
+    lines.push(`${code.padEnd(32)} \u2192 ${output}`);
+  }
+  lines.push("");
+  lines.push(demoSection("Raw Tokens (createTokens)", { case: "none" }));
+  lines.push("");
+  if (showCode) {
+    lines.push('import { createTokens, ANSI } from "@outfitter/cli/render";');
+    lines.push("const t = createTokens();");
+    lines.push("");
+  }
+  const d = "$";
+  const tokenExamples = [
+    {
+      code: `\`${d}{t.success}Done${d}{ANSI.reset}\``,
+      token: tokens.success,
+      text: "Done"
+    },
+    {
+      code: `\`${d}{t.error}Fail${d}{ANSI.reset}\``,
+      token: tokens.error,
+      text: "Fail"
+    },
+    {
+      code: `\`${d}{t.warning}Warn${d}{ANSI.reset}\``,
+      token: tokens.warning,
+      text: "Warn"
+    },
+    {
+      code: `\`${d}{t.info}Info${d}{ANSI.reset}\``,
+      token: tokens.info,
+      text: "Info"
+    }
+  ];
+  for (const example of tokenExamples) {
+    const reset = example.token ? ANSI.reset : "";
+    const output = `${example.token}${example.text}${reset}`;
+    lines.push(`${example.code.padEnd(36)} \u2192 ${output}`);
+  }
+  lines.push("");
+  lines.push(demoSection("Environment"));
+  const noColor = hasNoColorEnv();
+  const forceColor = resolveForceColorEnv();
+  let forceColorDisplay;
+  if (forceColor === true) {
+    forceColorDisplay = theme.success("enabled");
+  } else if (forceColor === false) {
+    forceColorDisplay = theme.error("disabled");
+  } else {
+    forceColorDisplay = theme.muted("not set");
+  }
+  lines.push(`Colors: ${colorEnabled ? theme.success("enabled") : theme.muted("disabled")} ${theme.muted(colorEnabled ? "(TTY detected)" : "(non-TTY or NO_COLOR set)")}`);
+  lines.push(`NO_COLOR: ${noColor ? theme.warning("set") : theme.muted("not set")}`);
+  lines.push(`FORCE_COLOR: ${forceColorDisplay}`);
+  return lines.join(`
+`);
+}
+
+export { renderColorsDemo };

package/dist/shared/@outfitter/cli-7gnrb8cr.js

@@ -0,0 +1,214 @@
+// @bun
+import {
+  BORDER_STYLE_META,
+  getBorderStyles
+} from "./cli-kc84wmch.js";
+import {
+  getExample
+} from "./cli-xep6v2c0.js";
+import {
+  demoSection
+} from "./cli-34fqr7bp.js";
+import {
+  createBox,
+  init_box,
+  renderBox
+} from "./cli-vp88gxev.js";
+
+// packages/cli/src/demo/renderers/box.ts
+init_box();
+function renderBoxDemo(config, theme) {
+  const showCode = config.showCode ?? true;
+  const showDescriptions = config.showDescriptions ?? true;
+  const lines = [];
+  lines.push(demoSection("Basic Box"));
+  lines.push("");
+  if (showCode) {
+    lines.push('import { renderBox } from "@outfitter/cli/render";');
+    lines.push("");
+  }
+  const content = getExample("boxContent", config.examples);
+  if (showCode) {
+    lines.push(`renderBox("${content}")`);
+    lines.push("");
+  }
+  lines.push(renderBox(content));
+  lines.push("");
+  lines.push(demoSection("Box with Title"));
+  lines.push("");
+  const title = getExample("boxTitle", config.examples);
+  if (showCode) {
+    lines.push(`renderBox("${content}", { title: "${title}" })`);
+    lines.push("");
+  }
+  lines.push(renderBox(content, { title }));
+  lines.push("");
+  lines.push(demoSection("Border Styles"));
+  lines.push("");
+  const styles = getBorderStyles().filter((s) => s !== "none");
+  for (const style of styles) {
+    const meta = BORDER_STYLE_META[style];
+    lines.push(`${meta.label.toUpperCase()}`);
+    if (showDescriptions) {
+      lines.push(theme.muted(meta.description));
+    }
+    lines.push("");
+    lines.push(renderBox("Content", { border: style }));
+    lines.push("");
+  }
+  lines.push(demoSection("Alignment"));
+  lines.push("");
+  const alignments = [
+    "left",
+    "center",
+    "right"
+  ];
+  for (const align of alignments) {
+    if (showCode) {
+      lines.push(`renderBox("${align}", { width: 30, align: "${align}" })`);
+    }
+    lines.push(renderBox(align, { width: 30, align }));
+    lines.push("");
+  }
+  lines.push(demoSection("Multi-Line Content"));
+  lines.push("");
+  const multiLine = ["Line one", "Line two", "Line three"];
+  if (showCode) {
+    lines.push('renderBox(["Line one", "Line two", "Line three"])');
+    lines.push("");
+  }
+  lines.push(renderBox(multiLine));
+  lines.push("");
+  lines.push(demoSection("Sections with Dividers"));
+  lines.push("");
+  if (showDescriptions) {
+    lines.push(theme.muted("Use sections to separate content with internal dividers."));
+    lines.push("");
+  }
+  if (showCode) {
+    lines.push('renderBox("", {');
+    lines.push('  sections: ["Header", ["Line 1", "Line 2"], "Footer"],');
+    lines.push('  border: "rounded",');
+    lines.push("})");
+    lines.push("");
+  }
+  lines.push(renderBox("", {
+    sections: ["Header", ["Line 1", "Line 2"], "Footer"],
+    border: "rounded"
+  }));
+  lines.push("");
+  if (showDescriptions) {
+    lines.push(theme.muted("Example: Status panel with sections"));
+    lines.push("");
+  }
+  if (showCode) {
+    lines.push('renderBox("", {');
+    lines.push("  sections: [");
+    lines.push('    "System Status",');
+    lines.push('    ["CPU: 45%", "Memory: 2.1 GB", "Disk: 120 GB free"],');
+    lines.push('    "Updated: 2 min ago"');
+    lines.push("  ],");
+    lines.push('  border: "single",');
+    lines.push("  width: 30,");
+    lines.push("})");
+    lines.push("");
+  }
+  lines.push(renderBox("", {
+    sections: [
+      "System Status",
+      ["CPU: 45%", "Memory: 2.1 GB", "Disk: 120 GB free"],
+      "Updated: 2 min ago"
+    ],
+    border: "single",
+    width: 30
+  }));
+  lines.push("");
+  lines.push(demoSection("Partial Borders"));
+  lines.push("");
+  if (showDescriptions) {
+    lines.push(theme.muted("Control which borders to render with the borders option."));
+    lines.push("");
+  }
+  if (showCode) {
+    lines.push('renderBox("Top and bottom only", {');
+    lines.push("  borders: { top: true, bottom: true, left: false, right: false }");
+    lines.push("})");
+    lines.push("");
+  }
+  lines.push(renderBox("Top and bottom only", {
+    borders: { top: true, bottom: true, left: false, right: false }
+  }));
+  lines.push("");
+  if (showCode) {
+    lines.push('renderBox("Left and right only", {');
+    lines.push("  borders: { top: false, bottom: false, left: true, right: true }");
+    lines.push("})");
+    lines.push("");
+  }
+  lines.push(renderBox("Left and right only", {
+    borders: { top: false, bottom: false, left: true, right: true }
+  }));
+  lines.push("");
+  lines.push(demoSection("Margin"));
+  lines.push("");
+  if (showDescriptions) {
+    lines.push(theme.muted("Add spacing outside the box with margin."));
+    lines.push("");
+  }
+  if (showCode) {
+    lines.push('renderBox("With margin", { margin: { left: 4 } })');
+    lines.push("");
+  }
+  lines.push(renderBox("With margin", { margin: { left: 4 } }));
+  lines.push("");
+  lines.push(demoSection("Individual Padding"));
+  lines.push("");
+  if (showDescriptions) {
+    lines.push(theme.muted("Control padding per side with an object."));
+    lines.push("");
+  }
+  if (showCode) {
+    lines.push('renderBox("Custom padding", {');
+    lines.push("  padding: { top: 1, bottom: 1, left: 3, right: 1 }");
+    lines.push("})");
+    lines.push("");
+  }
+  lines.push(renderBox("Custom padding", {
+    padding: { top: 1, bottom: 1, left: 3, right: 1 }
+  }));
+  lines.push("");
+  lines.push(demoSection("Nested Boxes"));
+  lines.push("");
+  if (showDescriptions) {
+    lines.push(theme.muted("Use createBox() to create composable boxes with metadata."));
+    lines.push("");
+  }
+  if (showCode) {
+    lines.push('const inner = createBox("Inner content", { border: "rounded" });');
+    lines.push('const outer = createBox(inner, { border: "double", title: "Container" });');
+    lines.push("console.log(outer.output);");
+    lines.push("");
+  }
+  const inner = createBox("Inner content", { border: "rounded" });
+  const outer = createBox(inner, { border: "double", title: "Container" });
+  lines.push(outer.output);
+  lines.push("");
+  if (showDescriptions) {
+    lines.push(theme.muted("Boxes can be nested to any depth."));
+    lines.push("");
+  }
+  if (showCode) {
+    lines.push('const level1 = createBox("Core", { border: "single" });');
+    lines.push('const level2 = createBox(level1, { border: "rounded", title: "Middle" });');
+    lines.push('const level3 = createBox(level2, { border: "double", title: "Outer" });');
+    lines.push("");
+  }
+  const level1 = createBox("Core", { border: "single" });
+  const level2 = createBox(level1, { border: "rounded", title: "Middle" });
+  const level3 = createBox(level2, { border: "double", title: "Outer" });
+  lines.push(level3.output);
+  return lines.join(`
+`);
+}
+
+export { renderBoxDemo };

package/dist/shared/@outfitter/cli-7na6p4fs.d.ts

@@ -0,0 +1,59 @@
+/**
+* Progress bar rendering utilities.
+*
+* Renders progress bars with filled and empty segments.
+*
+* @packageDocumentation
+*/
+/**
+* Configuration options for {@link renderProgress}.
+*
+* @example
+* ```typescript
+* const options: ProgressOptions = {
+*   current: 75,
+*   total: 100,
+*   width: 20,
+*   showPercent: true,
+* };
+* // Renders: [###############.....] 75%
+* ```
+*/
+interface ProgressOptions {
+	/** Current progress value */
+	current: number;
+	/** Total value (100% when current equals total) */
+	total: number;
+	/** Width of the progress bar in characters (default: 20) */
+	width?: number;
+	/** Whether to show percentage after the bar (default: false) */
+	showPercent?: boolean;
+}
+/**
+* Renders a progress bar with filled and empty segments.
+*
+* Uses unicode block characters: filled segments, empty segments.
+* Optionally displays percentage after the bar.
+*
+* Handles edge cases:
+* - `total <= 0`: Returns empty bar with 0%
+* - `current > total`: Caps at 100%
+* - `current < 0`: Floors at 0%
+*
+* @param options - Progress bar configuration
+* @returns Formatted progress bar string
+*
+* @example
+* ```typescript
+* renderProgress({ current: 50, total: 100 });
+* // [##########..........]
+*
+* renderProgress({ current: 75, total: 100, showPercent: true });
+* // [###############.....] 75%
+*
+* renderProgress({ current: 30, total: 100, width: 10 });
+* // [###.......]
+* ```
+*/
+declare function renderProgress(options: ProgressOptions): string;
+export { ProgressOptions, renderProgress };

package/dist/shared/@outfitter/cli-7nm6edvh.d.ts

@@ -0,0 +1,17 @@
+import { ExampleTexts } from "./cli-qjfc3j11";
+/**
+* Default example texts used when no custom examples are provided.
+*
+* These defaults are generic enough to work for any CLI while still
+* being meaningful and demonstrative.
+*/
+declare const DEFAULT_EXAMPLES: ExampleTexts;
+/**
+* Resolves example text with custom overrides.
+*
+* @param key - The example text key
+* @param custom - Optional custom examples
+* @returns The example text (custom if provided, default otherwise)
+*/
+declare function getExample<K extends keyof ExampleTexts>(key: K, custom?: Partial<ExampleTexts>): ExampleTexts[K];
+export { DEFAULT_EXAMPLES, getExample };