@outfitter/tui 0.2.0

package/dist/shared/@outfitter/tui-34q2aenf.d.ts

@@ -0,0 +1,24 @@
+import { VisualTheme } from "./tui-8j1gbehy";
+/**
+* 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/tui/theme/presets";
+*
+* // Use rounded styling
+* const box = renderBox("Hello", { border: roundedTheme.border });
+* // ╭───────╮
+* // │ Hello │
+* // ╰───────╯
+* ```
+*/
+declare const roundedTheme: VisualTheme;
+export { roundedTheme };

package/dist/shared/@outfitter/tui-37hjcqhb.d.ts

@@ -0,0 +1,3 @@
+import { ANSI, applyColor, ColorName, createTheme, createTokens, resolveTokenColorEnabled, Theme, TokenOptions, Tokens } from "@outfitter/cli/colors";
+import { ANSI_REGEX, getStringWidth, padText, pluralize, slugify, stripAnsi, truncateText, wrapText } from "@outfitter/cli/text";
+export { ANSI, applyColor, ColorName, createTheme, createTokens, resolveTokenColorEnabled, Theme, TokenOptions, Tokens, ANSI_REGEX, getStringWidth, padText, pluralize, slugify, stripAnsi, truncateText, wrapText };

package/dist/shared/@outfitter/tui-3dyxg62j.d.ts

@@ -0,0 +1,97 @@
+/**
+* Tree rendering utilities.
+*
+* Renders hierarchical data as ASCII trees with box-drawing characters.
+*
+* @packageDocumentation
+*/
+/**
+* Available tree guide styles.
+*
+* - `single`: Standard Unicode box-drawing (default)
+* - `heavy`: Thick/bold box-drawing characters
+* - `double`: Double-line box-drawing characters
+* - `rounded`: Rounded corners (╰ instead of └)
+*/
+type TreeGuideStyle = "single" | "heavy" | "double" | "rounded";
+/**
+* Tree guide character sets for different visual styles.
+*/
+declare const TREE_GUIDES: Record<TreeGuideStyle, {
+	vertical: string;
+	fork: string;
+	end: string;
+}>;
+/**
+* Options for customizing tree rendering.
+*/
+interface TreeOptions {
+	/**
+	* Guide style for tree branches.
+	* @default "single"
+	*/
+	guide?: TreeGuideStyle;
+	/**
+	* Maximum depth to render (1 = root children only).
+	* @default undefined (unlimited)
+	*/
+	maxDepth?: number;
+	/**
+	* Custom function to render node labels.
+	* Receives the key, value, and current depth.
+	*
+	* @example
+	* ```typescript
+	* renderLabel: (key, value, depth) => {
+	*   if (value && typeof value === "object") {
+	*     return `📁 ${key}/`;
+	*   }
+	*   return `📄 ${key}`;
+	* }
+	* ```
+	*/
+	renderLabel?: (key: string, value: unknown, depth: number) => string;
+}
+/**
+* Renders hierarchical data as a tree with unicode box-drawing characters.
+*
+* Uses unicode characters for tree structure.
+* Nested objects are rendered as child nodes; leaf values (null, primitives)
+* are rendered as terminal nodes.
+*
+* @param tree - Hierarchical object to render
+* @param options - Customization options
+* @returns Formatted tree string with box-drawing characters
+*
+* @example
+* ```typescript
+* const tree = {
+*   src: {
+*     components: {
+*       Button: null,
+*       Input: null,
+*     },
+*     utils: null,
+*   },
+*   tests: null,
+* };
+*
+* console.log(renderTree(tree));
+* // ├── src
+* // │   ├── components
+* // │   │   ├── Button
+* // │   │   └── Input
+* // │   └── utils
+* // └── tests
+*
+* console.log(renderTree(tree, { guide: "rounded" }));
+* // ├── src
+* // │   ├── components
+* // │   │   ├── Button
+* // │   │   ╰── Input
+* // │   ╰── utils
+* // ╰── tests
+* ```
+*/
+declare function renderTree(tree: Record<string, unknown>, options?: TreeOptions): string;
+export { TreeGuideStyle, TREE_GUIDES, TreeOptions, renderTree };

package/dist/shared/@outfitter/tui-3kza6p9k.d.ts

@@ -0,0 +1,132 @@
+/**
+* List rendering utilities.
+*
+* Renders arrays as bullet lists with optional nesting and multiple styles.
+*
+* @packageDocumentation
+*/
+/**
+* Available list styles for {@link renderList}.
+*
+* - `dash`: Uses - character (default)
+* - `bullet`: Uses • character
+* - `number`: Uses 1. for top-level, a. for nested, i. for deeply nested
+* - `checkbox`: Uses ☐ for unchecked, ☑ for checked
+*/
+type ListStyle = "dash" | "bullet" | "number" | "checkbox";
+/**
+* Options for customizing list rendering.
+*
+* @example
+* ```typescript
+* // Numbered list with custom indent
+* renderList(items, { style: "number", indent: 4 });
+*
+* // Checkbox list with some items checked
+* renderList(items, { style: "checkbox", checked: new Set([1, 3]) });
+* ```
+*/
+interface ListOptions {
+	/**
+	* The list style to use.
+	* @default "dash"
+	*/
+	style?: ListStyle;
+	/**
+	* Indices of checked top-level items (0-indexed) for checkbox style.
+	* Only applies to top-level items. For nested items, use the
+	* `checked` property on {@link NestedListItem} instead.
+	*/
+	checked?: Set<number>;
+	/**
+	* Number of spaces per indentation level.
+	* @default 2
+	*/
+	indent?: number;
+}
+/**
+* A list item with optional nested children for {@link renderList}.
+*
+* @example
+* ```typescript
+* const item: NestedListItem = {
+*   text: "Parent item",
+*   children: ["Child 1", "Child 2"],
+* };
+*
+* // Checkbox item with checked state
+* const checkboxItem: NestedListItem = {
+*   text: "Completed task",
+*   checked: true,
+* };
+*
+* // Mixed styles: numbered parent with bullet children
+* const mixedItem: NestedListItem = {
+*   text: "Section 1",
+*   childStyle: "bullet",
+*   children: ["Unordered item A", "Unordered item B"],
+* };
+* ```
+*/
+interface NestedListItem {
+	/** The text content of this list item */
+	text: string;
+	/** Optional nested child items (strings or nested items) */
+	children?: Array<string | NestedListItem>;
+	/** Whether this item is checked (for checkbox style) */
+	checked?: boolean;
+	/** Override style for children (enables mixed numbered/bullet lists) */
+	childStyle?: ListStyle;
+}
+/**
+* A list item that can be either a simple string or a nested item with children.
+*
+* @example
+* ```typescript
+* const items: ListItem[] = [
+*   "Simple item",
+*   { text: "Parent", children: ["Child 1", "Child 2"] },
+* ];
+* ```
+*/
+type ListItem = string | NestedListItem;
+/**
+* Renders items as a list with optional nesting and multiple styles.
+*
+* Supports both simple string items and nested items with children.
+* The default style uses dash (-) characters.
+*
+* For numbered lists, child items are indented to align with the parent's
+* content (after the marker), creating proper visual hierarchy.
+*
+* @param items - Array of list items (strings or nested items)
+* @param options - Optional configuration for style, checked items, and indent
+* @returns Formatted list string
+*
+* @example
+* ```typescript
+* // Simple dash list (default)
+* console.log(renderList(["First", "Second", "Third"]));
+* // - First
+* // - Second
+* // - Third
+*
+* // Numbered list with nesting
+* console.log(renderList([
+*   { text: "First section", children: [
+*     { text: "Subsection A", children: ["Detail i", "Detail ii"] },
+*   ]},
+* ], { style: "number" }));
+* // 1. First section
+* //    a. Subsection A
+* //       i. Detail i
+* //       ii. Detail ii
+*
+* // Checkbox list
+* console.log(renderList(["Todo 1", "Todo 2"], { style: "checkbox", checked: new Set([1]) }));
+* // ☐ Todo 1
+* // ☑ Todo 2
+* ```
+*/
+declare function renderList(items: ListItem[], options?: ListOptions): string;
+export { ListStyle, ListOptions, NestedListItem, ListItem, renderList };

package/dist/shared/@outfitter/tui-43bnfxv9.js

@@ -0,0 +1,30 @@
+// @bun
+import {
+  init_box
+} from "./tui-t9vd88jr.js";
+import {
+  init_borders
+} from "./tui-2pwhzg55.js";
+
+// packages/tui/src/render/index.ts
+init_borders();
+init_box();
+import {
+  ANSI,
+  applyColor,
+  createTheme,
+  createTokens,
+  resolveTokenColorEnabled
+} from "@outfitter/cli/colors";
+import {
+  ANSI_REGEX,
+  getStringWidth,
+  padText,
+  pluralize,
+  slugify,
+  stripAnsi,
+  truncateText,
+  wrapText
+} from "@outfitter/cli/text";
+
+export { ANSI, applyColor, createTheme, createTokens, resolveTokenColorEnabled, ANSI_REGEX, getStringWidth, padText, pluralize, slugify, stripAnsi, truncateText, wrapText };

package/dist/shared/@outfitter/tui-4yz7jcyq.js

@@ -0,0 +1,214 @@
+// @bun
+import {
+  getExample
+} from "./tui-nprd7g0d.js";
+import {
+  demoSection
+} from "./tui-733asbd8.js";
+import {
+  BORDER_STYLE_META,
+  getBorderStyles
+} from "./tui-nr580mbv.js";
+import {
+  createBox,
+  init_box,
+  renderBox
+} from "./tui-t9vd88jr.js";
+
+// packages/tui/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/tui/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/tui-52ndmswq.js

@@ -0,0 +1,23 @@
+// @bun
+import {
+  createCancelledError
+} from "./tui-kcxv8txp.js";
+
+// packages/tui/src/prompt/confirm.ts
+import { confirm, isCancel } from "@clack/prompts";
+import { Result } from "better-result";
+async function promptConfirm(options) {
+  const confirmOptions = {
+    message: options.message
+  };
+  if (options.initialValue !== undefined) {
+    confirmOptions.initialValue = options.initialValue;
+  }
+  const result = await confirm(confirmOptions);
+  if (isCancel(result)) {
+    return Result.err(createCancelledError());
+  }
+  return Result.ok(result);
+}
+
+export { promptConfirm };

package/dist/shared/@outfitter/tui-53ms1ba4.d.ts

@@ -0,0 +1,41 @@
+import { PasswordPromptOptions, PromptResult, TextPromptOptions } from "./tui-c56sxcm8";
+/**
+* Prompts for text input with Result wrapping.
+*
+* @param options - Text prompt options
+* @returns Ok with value or Err with CancelledError
+*
+* @example
+* ```typescript
+* import { promptText } from "@outfitter/tui/prompt";
+*
+* const result = await promptText({
+*   message: "What is your name?",
+*   placeholder: "Enter your name",
+*   validate: (v) => v.length > 0 || "Name is required",
+* });
+*
+* if (result.isOk()) {
+*   console.log(`Hello, ${result.value}!`);
+* }
+* ```
+*/
+declare function promptText(options: TextPromptOptions): PromptResult<string>;
+/**
+* Prompts for password input with Result wrapping.
+*
+* @param options - Password prompt options
+* @returns Ok with value or Err with CancelledError
+*
+* @example
+* ```typescript
+* import { promptPassword } from "@outfitter/tui/prompt";
+*
+* const result = await promptPassword({
+*   message: "Enter your password:",
+*   validate: (v) => v.length >= 8 || "Password too short",
+* });
+* ```
+*/
+declare function promptPassword(options: PasswordPromptOptions): PromptResult<string>;
+export { promptText, promptPassword };

package/dist/shared/@outfitter/tui-5dsn6d6d.js

@@ -0,0 +1,86 @@
+// @bun
+// packages/tui/src/render/list.ts
+function toLetter(n) {
+  return String.fromCharCode(96 + n);
+}
+function toRoman(n) {
+  const numerals = [
+    [10, "x"],
+    [9, "ix"],
+    [5, "v"],
+    [4, "iv"],
+    [1, "i"]
+  ];
+  let result = "";
+  let remaining = n;
+  for (const [value, symbol] of numerals) {
+    while (remaining >= value) {
+      result += symbol;
+      remaining -= value;
+    }
+  }
+  return result;
+}
+function getMarker(style, depth, index, isChecked) {
+  switch (style) {
+    case "bullet":
+      return "\u2022";
+    case "dash":
+      return "-";
+    case "number":
+      if (depth === 0) {
+        return `${index + 1}.`;
+      }
+      if (depth === 1) {
+        return `${toLetter(index + 1)}.`;
+      }
+      return `${toRoman(index + 1)}.`;
+    case "checkbox":
+      return isChecked ? "\u2611" : "\u2610";
+    default: {
+      const _exhaustive = style;
+      return _exhaustive;
+    }
+  }
+}
+function renderList(items, options) {
+  const style = options?.style ?? "dash";
+  const checkedSet = options?.checked ?? new Set;
+  const baseIndent = options?.indent ?? 2;
+  const lines = [];
+  let _globalIndex = 0;
+  const renderItem = (item, currentIndent, depth, indexAtDepth, currentStyle) => {
+    const indentStr = " ".repeat(currentIndent);
+    const text = typeof item === "string" ? item : item.text;
+    let isChecked = false;
+    if (currentStyle === "checkbox") {
+      if (typeof item !== "string" && item.checked !== undefined) {
+        isChecked = item.checked;
+      } else if (depth === 0) {
+        isChecked = checkedSet.has(indexAtDepth);
+      }
+    }
+    const marker = getMarker(currentStyle, depth, indexAtDepth, isChecked);
+    lines.push(`${indentStr}${marker} ${text}`);
+    _globalIndex++;
+    if (typeof item !== "string" && item.children) {
+      const childStyle = typeof item !== "string" && item.childStyle ? item.childStyle : currentStyle;
+      const childIndent = currentStyle === "number" ? currentIndent + marker.length + 1 : currentIndent + baseIndent;
+      const childDepth = childStyle !== currentStyle ? 0 : depth + 1;
+      let childIndex = 0;
+      for (const child of item.children) {
+        renderItem(child, childIndent, childDepth, childIndex, childStyle);
+        childIndex++;
+      }
+    }
+  };
+  let topIndex = 0;
+  for (const item of items) {
+    renderItem(item, 0, 0, topIndex, style);
+    topIndex++;
+  }
+  return lines.join(`
+`);
+}
+
+export { renderList };