@outfitter/cli 0.1.0-rc.2 → 0.1.0

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

@@ -0,0 +1,25 @@
+// @bun
+import {
+  getTerminalWidth
+} from "./cli-671sxkhj.js";
+
+// packages/cli/src/render/separator.ts
+function renderSeparator(options) {
+  const style = options?.style ?? "\u2500";
+  const widthMode = options?.width ?? 40;
+  let width;
+  if (widthMode === "text") {
+    width = 40;
+  } else if (widthMode === "full") {
+    width = getTerminalWidth();
+  } else {
+    width = widthMode;
+  }
+  if (style.length === 2) {
+    const repetitions = Math.ceil(width / 2);
+    return style.repeat(repetitions).slice(0, width);
+  }
+  return style.repeat(width);
+}
+
+export { renderSeparator };

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

@@ -0,0 +1,22 @@
+// @bun
+// packages/cli/src/streaming/ansi.ts
+var ANSI = {
+  cursorUp: (n) => `\x1B[${n}A`,
+  cursorDown: (n) => `\x1B[${n}B`,
+  cursorRight: (n) => `\x1B[${n}C`,
+  cursorLeft: (n) => `\x1B[${n}D`,
+  cursorToStart: "\x1B[G",
+  clearLine: "\x1B[2K",
+  clearToEnd: "\x1B[0J",
+  clearToStart: "\x1B[1J",
+  clearScreen: "\x1B[2J",
+  hideCursor: "\x1B[?25l",
+  showCursor: "\x1B[?25h",
+  saveCursor: "\x1B[s",
+  restoreCursor: "\x1B[u",
+  carriageReturn: "\r",
+  newLine: `
+`
+};
+
+export { ANSI };

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

@@ -0,0 +1,20 @@
+// @bun
+import {
+  defaultTheme
+} from "./cli-cs45xd6q.js";
+
+// packages/cli/src/theme/context.ts
+function createThemedContext(options) {
+  const theme = options.theme ?? options.parent?.theme ?? defaultTheme;
+  const width = options.width ?? options.parent?.width ?? process.stdout.columns ?? 80;
+  return {
+    width,
+    theme,
+    ...options.parent && { parent: options.parent }
+  };
+}
+function getContextTheme(ctx) {
+  return ctx?.theme ?? defaultTheme;
+}
+
+export { createThemedContext, getContextTheme };

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

@@ -0,0 +1,62 @@
+// @bun
+import {
+  BORDER_STYLE_META,
+  getBorderStyles
+} from "./cli-kc84wmch.js";
+import {
+  demoSection
+} from "./cli-34fqr7bp.js";
+import {
+  BORDERS,
+  drawHorizontalLine,
+  init_borders
+} from "./cli-85fg2vr5.js";
+
+// packages/cli/src/demo/renderers/borders.ts
+init_borders();
+function renderBordersDemo(config, theme) {
+  const showCode = config.showCode ?? true;
+  const showDescriptions = config.showDescriptions ?? true;
+  const lines = [];
+  lines.push(demoSection("Border Styles"));
+  lines.push("");
+  if (showCode) {
+    lines.push('import { BORDERS, getBorderCharacters } from "@outfitter/cli/render";');
+    lines.push("");
+  }
+  const styles = getBorderStyles().filter((s) => s !== "none");
+  for (const style of styles) {
+    const meta = BORDER_STYLE_META[style];
+    const chars = BORDERS[style];
+    lines.push(`${meta.label.toUpperCase()} (${style})`);
+    if (showDescriptions) {
+      lines.push(theme.muted(meta.description));
+    }
+    lines.push("");
+    const width = 20;
+    lines.push(drawHorizontalLine(width, chars, "top"));
+    lines.push(`${chars.vertical}${" ".repeat(width)}${chars.vertical}`);
+    lines.push(`${chars.vertical}${"  Content here".padEnd(width)}${chars.vertical}`);
+    lines.push(`${chars.vertical}${" ".repeat(width)}${chars.vertical}`);
+    lines.push(drawHorizontalLine(width, chars, "bottom"));
+    lines.push("");
+  }
+  lines.push(demoSection("Characters Reference"));
+  lines.push("");
+  for (const style of styles) {
+    const chars = BORDERS[style];
+    const meta = BORDER_STYLE_META[style];
+    lines.push(`${meta.label}:`);
+    const charDisplay = [
+      `  Corners: ${chars.topLeft} ${chars.topRight} ${chars.bottomLeft} ${chars.bottomRight}`,
+      `  Lines: ${chars.horizontal} ${chars.vertical}`,
+      `  T's: ${chars.topT} ${chars.bottomT} ${chars.leftT} ${chars.rightT} Cross: ${chars.cross}`
+    ];
+    lines.push(...charDisplay);
+    lines.push("");
+  }
+  return lines.join(`
+`);
+}
+
+export { renderBordersDemo };

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

@@ -0,0 +1,24 @@
+import { VisualTheme } from "./cli-s0kkx9m1";
+/**
+* Bold visual theme.
+*
+* Features:
+* - Heavy/thick box-drawing borders (┏━┓)
+* - Heavy tree guide style
+* - Strong visual weight
+*
+* Inherits all other properties from {@link defaultTheme}.
+*
+* @example
+* ```typescript
+* import { boldTheme } from "@outfitter/cli/theme/presets";
+*
+* // Use bold styling
+* const box = renderBox("Hello", { border: boldTheme.border });
+* // ┏━━━━━━━┓
+* // ┃ Hello ┃
+* // ┗━━━━━━━┛
+* ```
+*/
+declare const boldTheme: VisualTheme;
+export { boldTheme };

package/dist/shared/@outfitter/{cli-2y3kxew8.d.ts → cli-qj83y5wj.d.ts}

@@ -1,3 +1,4 @@
+import { BorderStyle } from "./cli-fakncnjp";
 /**
 * Configuration options for {@link renderTable}.
 *
@@ -6,6 +7,7 @@
 * const options: TableOptions = {
 *   headers: { id: "ID", name: "Name" },
 *   columnWidths: { description: 20 },
+*   border: "rounded",
 * };
 * ```
 */
@@ -20,13 +22,24 @@ interface TableOptions {
 	* If not specified, the object key is used as the header.
 	*/
 	headers?: Record<string, string>;
+	/**
+	* Border style for the table.
+	* @default "single"
+	*/
+	border?: BorderStyle;
+	/**
+	* Compact mode removes all borders and uses space separators.
+	* When true, overrides the border option.
+	* @default false
+	*/
+	compact?: boolean;
 }
 /**
-* Renders an array of objects as an ASCII table with borders.
+* Renders an array of objects as a table with Unicode box-drawing borders.
 *
 * Automatically calculates column widths based on content unless
-* overridden in options. Supports custom header labels and
-* truncates cell content that exceeds column width.
+* overridden in options. Supports custom header labels, border styles,
+* and truncates cell content that exceeds column width.
 *
 * @param data - Array of objects to render as rows
 * @param options - Table rendering options
@@ -46,12 +59,12 @@ interface TableOptions {
 * );
 *
 * console.log(table);
-* // +----+-------+----------+
-* // | ID | Name  | status   |
-* // +----+-------+----------+
-* // | 1  | Alice | Active   |
-* // | 2  | Bob   | Inactive |
-* // +----+-------+----------+
+* // ┌────┬───────┬──────────┐
+* // │ ID │ Name  │ status   │
+* // ├────┼───────┼──────────┤
+* // │ 1  │ Alice │ Active   │
+* // │ 2  │ Bob   │ Inactive │
+* // └────┴───────┴──────────┘
 * ```
 */
 declare function renderTable(data: Record<string, unknown>[], options?: TableOptions): string;

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

@@ -0,0 +1,112 @@
+import { Theme } from "./cli-xsaheemc";
+/**
+* Available primitive types for demos.
+*/
+type PrimitiveId = "colors" | "borders" | "spinner" | "list" | "box" | "table" | "progress" | "tree" | "text" | "markdown" | "indicators";
+/**
+* Categorization for theme methods.
+*/
+type ThemeMethodCategory = "semantic" | "utility";
+/**
+* Metadata for a theme method.
+*/
+interface ThemeMethodMeta {
+	/** Method category (semantic or utility) */
+	category: ThemeMethodCategory;
+	/** Human-readable description */
+	description: string;
+	/** Default example text */
+	defaultExample: string;
+}
+/**
+* Metadata for a primitive variant (spinner styles, border styles, etc).
+*/
+interface VariantMeta<T extends string> {
+	/** The variant value */
+	value: T;
+	/** Human-readable label */
+	label: string;
+	/** Description of the variant */
+	description: string;
+}
+/**
+* Metadata describing a primitive for demo generation.
+*/
+interface PrimitiveMeta {
+	/** Primitive identifier */
+	id: PrimitiveId;
+	/** Human-readable name */
+	name: string;
+	/** Brief description */
+	description: string;
+	/** Import statement example */
+	importExample: string;
+}
+/**
+* Customizable example texts for demos.
+*
+* Keys correspond to theme method names and other example contexts.
+*/
+interface ExampleTexts {
+	success: string;
+	warning: string;
+	error: string;
+	info: string;
+	primary: string;
+	secondary: string;
+	muted: string;
+	accent: string;
+	highlight: string;
+	link: string;
+	destructive: string;
+	subtle: string;
+	bold: string;
+	italic: string;
+	underline: string;
+	dim: string;
+	boxContent: string;
+	boxTitle: string;
+	spinnerMessage: string;
+	progressLabel: string;
+	listItems: string[];
+	tableData: Record<string, unknown>[];
+	treeData: Record<string, unknown>;
+	markdownSample: string;
+}
+/**
+* Configuration for demo rendering.
+*/
+interface DemoConfig {
+	/**
+	* Override default example texts.
+	*/
+	examples?: Partial<ExampleTexts>;
+	/**
+	* Whether to show import statements.
+	* @default true
+	*/
+	showCode?: boolean;
+	/**
+	* Whether to show method/variant descriptions.
+	* @default true
+	*/
+	showDescriptions?: boolean;
+}
+/**
+* Function that renders a demo section for a primitive.
+*/
+type DemoRenderer = (config: DemoConfig, theme: Theme) => string;
+/**
+* Registry entry for a primitive demo.
+*/
+interface DemoRegistryEntry {
+	/** Primitive metadata */
+	meta: PrimitiveMeta;
+	/** Render function */
+	render: DemoRenderer;
+}
+/**
+* Checks if a string is a valid PrimitiveId.
+*/
+declare function isPrimitiveId(value: string): value is PrimitiveId;
+export { PrimitiveId, ThemeMethodCategory, ThemeMethodMeta, VariantMeta, PrimitiveMeta, ExampleTexts, DemoConfig, DemoRenderer, DemoRegistryEntry, isPrimitiveId };

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

@@ -0,0 +1,70 @@
+// @bun
+import {
+  renderMarkdown
+} from "./cli-afhjqmg3.js";
+import {
+  getExample
+} from "./cli-xep6v2c0.js";
+import {
+  demoSection
+} from "./cli-34fqr7bp.js";
+
+// packages/cli/src/demo/renderers/markdown.ts
+function renderMarkdownDemo(config, theme) {
+  const showCode = config.showCode ?? true;
+  const lines = [];
+  lines.push(demoSection("Markdown Rendering"));
+  lines.push("");
+  if (showCode) {
+    lines.push('import { renderMarkdown } from "@outfitter/cli/render";');
+    lines.push("");
+  }
+  const sample = getExample("markdownSample", config.examples);
+  lines.push("Input:");
+  lines.push(theme.muted("\u2500".repeat(40)));
+  for (const line of sample.split(`
+`)) {
+    lines.push(theme.muted(line));
+  }
+  lines.push(theme.muted("\u2500".repeat(40)));
+  lines.push("");
+  lines.push("Output:");
+  lines.push("\u2500".repeat(40));
+  lines.push(renderMarkdown(sample));
+  lines.push("\u2500".repeat(40));
+  lines.push("");
+  lines.push(demoSection("Supported Elements"));
+  lines.push("");
+  const elements = [
+    {
+      name: "Headings",
+      markdown: `# Heading 1
+## Heading 2`,
+      desc: "Rendered bold"
+    },
+    { name: "Bold", markdown: "**bold text**", desc: "Rendered bold" },
+    { name: "Italic", markdown: "*italic text*", desc: "Rendered italic" },
+    { name: "Inline code", markdown: "`code`", desc: "Rendered cyan" },
+    {
+      name: "Code block",
+      markdown: "```\ncode block\n```",
+      desc: "Rendered dim"
+    }
+  ];
+  for (const el of elements) {
+    lines.push(`${el.name}:`);
+    lines.push(theme.muted(`  ${el.desc}`));
+    lines.push(`  Input: ${el.markdown.replace(/\n/g, "\\n")}`);
+    lines.push(`  Output: ${renderMarkdown(el.markdown).replace(/\n/g, " ")}`);
+    lines.push("");
+  }
+  lines.push(demoSection("Color Support"));
+  lines.push("");
+  lines.push("\u2022 Colors applied when terminal supports ANSI");
+  lines.push("\u2022 Respects NO_COLOR environment variable");
+  lines.push("\u2022 Markdown syntax stripped when colors disabled");
+  return lines.join(`
+`);
+}
+
+export { renderMarkdownDemo };

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 };