@outfitter/tui 0.2.0

package/dist/shared/@outfitter/tui-c56sxcm8.d.ts

@@ -0,0 +1,87 @@
+import { Validator } from "./tui-8mypsnva";
+import { Result } from "better-result";
+/**
+* Error returned when user cancels a prompt.
+*/
+interface CancelledError {
+	type: "cancelled";
+	message: string;
+}
+/**
+* Creates a cancelled error.
+*/
+declare function createCancelledError(message?: string): CancelledError;
+/**
+* Options for text prompts.
+*/
+interface TextPromptOptions {
+	/** Prompt message to display */
+	message: string;
+	/** Placeholder text */
+	placeholder?: string;
+	/** Default value */
+	defaultValue?: string;
+	/** Validation function */
+	validate?: Validator;
+}
+/**
+* Options for password prompts.
+*/
+interface PasswordPromptOptions {
+	/** Prompt message to display */
+	message: string;
+	/** Validation function */
+	validate?: Validator;
+	/** Mask character (default: •) */
+	mask?: string;
+}
+/**
+* Options for select prompts.
+*/
+interface SelectPromptOptions<T> {
+	/** Prompt message to display */
+	message: string;
+	/** Available options */
+	options: Array<{
+		value: T;
+		label: string;
+		hint?: string;
+	}>;
+	/** Initial selected index */
+	initialValue?: T;
+	/** Maximum number of items to display at once */
+	pageSize?: number;
+}
+/**
+* Options for multi-select prompts.
+*/
+interface MultiSelectPromptOptions<T> {
+	/** Prompt message to display */
+	message: string;
+	/** Available options */
+	options: Array<{
+		value: T;
+		label: string;
+		hint?: string;
+	}>;
+	/** Initially selected values */
+	initialValues?: T[];
+	/** Require at least one selection */
+	required?: boolean;
+	/** Maximum number of items to display at once */
+	pageSize?: number;
+}
+/**
+* Options for confirm prompts.
+*/
+interface ConfirmPromptOptions {
+	/** Prompt message to display */
+	message: string;
+	/** Initial value */
+	initialValue?: boolean;
+}
+/**
+* Type alias for prompt results.
+*/
+type PromptResult<T> = Promise<Result<T, CancelledError>>;
+export { CancelledError, createCancelledError, TextPromptOptions, PasswordPromptOptions, SelectPromptOptions, MultiSelectPromptOptions, ConfirmPromptOptions, PromptResult };

package/dist/shared/@outfitter/tui-c6ft5w6q.d.ts

@@ -0,0 +1,91 @@
+/**
+* Spinner rendering utilities.
+*
+* Provides animated spinner frames for async operations with
+* multiple styles and graceful degradation for non-TTY contexts.
+*
+* @packageDocumentation
+*/
+/**
+* Available spinner animation styles.
+*
+* - `dots`: Braille dots animation (default, smooth)
+* - `line`: Classic ASCII spinner (-\|/)
+* - `arc`: Corner arc rotation
+* - `circle`: Half-filled circle rotation
+* - `bounce`: Bouncing dot (vertical)
+* - `ping`: Bouncing dot in brackets (horizontal)
+*/
+type SpinnerStyle = "dots" | "line" | "arc" | "circle" | "bounce" | "ping";
+/**
+* Spinner animation frame definition.
+*/
+interface SpinnerFrames {
+	/** Array of characters to cycle through */
+	frames: string[];
+	/** Milliseconds between frame changes */
+	interval: number;
+}
+/**
+* Predefined spinner animations.
+*
+* @example
+* ```typescript
+* const dotsSpinner = SPINNERS.dots;
+* console.log(dotsSpinner.frames[0]); // "⠋"
+* console.log(dotsSpinner.interval);  // 80
+* ```
+*/
+declare const SPINNERS: Record<SpinnerStyle, SpinnerFrames>;
+/**
+* Gets the spinner frame for a given elapsed time.
+*
+* Calculates which frame to display based on elapsed milliseconds
+* and the spinner's interval setting. Automatically wraps around
+* when the elapsed time exceeds a full cycle.
+*
+* @param style - The spinner style to use
+* @param elapsed - Elapsed time in milliseconds since spinner started
+* @returns The frame character to display
+*
+* @example
+* ```typescript
+* // Get frame at start
+* getSpinnerFrame("dots", 0); // "⠋"
+*
+* // Get frame after 160ms
+* getSpinnerFrame("dots", 160); // "⠹" (third frame)
+*
+* // Frames wrap around automatically
+* const fullCycle = SPINNERS.dots.interval * SPINNERS.dots.frames.length;
+* getSpinnerFrame("dots", fullCycle); // "⠋" (back to first)
+* ```
+*/
+declare function getSpinnerFrame(style: SpinnerStyle, elapsed: number): string;
+/**
+* Renders a static spinner frame with optional message.
+*
+* This is the non-interactive version for logging and non-TTY contexts.
+* For animated spinners, use the elapsed parameter with `getSpinnerFrame()`.
+*
+* @param style - The spinner style to use
+* @param message - Optional message to display after the spinner
+* @returns Formatted spinner string
+*
+* @example
+* ```typescript
+* // Simple spinner
+* console.log(renderSpinner("dots"));
+* // "⠋"
+*
+* // Spinner with message
+* console.log(renderSpinner("dots", "Loading..."));
+* // "⠋ Loading..."
+*
+* // For logs (non-TTY)
+* logger.info(renderSpinner("line", "Fetching data"));
+* // "- Fetching data"
+* ```
+*/
+declare function renderSpinner(style: SpinnerStyle, message?: string): string;
+export { SpinnerStyle, SpinnerFrames, SPINNERS, getSpinnerFrame, renderSpinner };

package/dist/shared/@outfitter/tui-cq7za0cz.js

@@ -0,0 +1,62 @@
+// @bun
+import {
+  demoSection
+} from "./tui-733asbd8.js";
+import {
+  BORDER_STYLE_META,
+  getBorderStyles
+} from "./tui-nr580mbv.js";
+import {
+  BORDERS,
+  drawHorizontalLine,
+  init_borders
+} from "./tui-2pwhzg55.js";
+
+// packages/tui/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/tui/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/tui-dh15zwg0.js

@@ -0,0 +1,95 @@
+// @bun
+import {
+  ANSI
+} from "./tui-2wfat6jb.js";
+import {
+  getIndicator
+} from "./tui-pdwbbzwr.js";
+
+// packages/tui/src/streaming/spinner.ts
+var SPINNER_FRAMES = {
+  dots: ["\u280B", "\u2819", "\u2839", "\u2838", "\u283C", "\u2834", "\u2826", "\u2827", "\u2807", "\u280F"],
+  line: ["-", "\\", "|", "/"],
+  simple: ["\u25D0", "\u25D3", "\u25D1", "\u25D2"]
+};
+function createSpinner(message, options = {}) {
+  const stream = options.stream ?? process.stdout;
+  const isTTY = stream.isTTY ?? false;
+  const style = options.style ?? "dots";
+  const interval = options.interval ?? 80;
+  const frames = SPINNER_FRAMES[style];
+  let frameIndex = 0;
+  let currentMessage = message;
+  let timer = null;
+  let isRunning = false;
+  const render = () => {
+    if (!isTTY) {
+      return;
+    }
+    const frame = frames[frameIndex % frames.length];
+    stream.write(`${ANSI.carriageReturn}${ANSI.clearLine}${frame} ${currentMessage}`);
+    frameIndex++;
+  };
+  const start = () => {
+    if (isRunning)
+      return;
+    isRunning = true;
+    if (!isTTY) {
+      stream.write(`- ${currentMessage}
+`);
+      return;
+    }
+    stream.write(ANSI.hideCursor);
+    render();
+    timer = setInterval(render, interval);
+  };
+  const update = (newMessage) => {
+    currentMessage = newMessage;
+    if (!isTTY) {
+      stream.write(`- ${currentMessage}
+`);
+      return;
+    }
+    if (isRunning) {
+      render();
+    }
+  };
+  const stopWith = (symbol, finalMessage) => {
+    if (timer) {
+      clearInterval(timer);
+      timer = null;
+    }
+    const msg = finalMessage ?? currentMessage;
+    if (isTTY) {
+      stream.write(`${ANSI.carriageReturn}${ANSI.clearLine}${symbol} ${msg}
+`);
+      stream.write(ANSI.showCursor);
+    } else {
+      stream.write(`${symbol} ${msg}
+`);
+    }
+    isRunning = false;
+  };
+  const succeed = (finalMessage) => {
+    const symbol = getIndicator("status", "success", isTTY);
+    stopWith(symbol, finalMessage);
+  };
+  const fail = (finalMessage) => {
+    const symbol = getIndicator("status", "error", isTTY);
+    stopWith(symbol, finalMessage);
+  };
+  const stop = () => {
+    if (timer) {
+      clearInterval(timer);
+      timer = null;
+    }
+    if (isTTY && isRunning) {
+      stream.write(`${ANSI.carriageReturn}${ANSI.clearLine}`);
+      stream.write(ANSI.showCursor);
+    }
+    isRunning = false;
+  };
+  return { start, update, succeed, fail, stop };
+}
+
+export { createSpinner };

package/dist/shared/@outfitter/tui-esc46z2v.js

@@ -0,0 +1,20 @@
+// @bun
+import {
+  defaultTheme
+} from "./tui-0mpqnyc1.js";
+import {
+  BORDERS,
+  init_borders
+} from "./tui-2pwhzg55.js";
+
+// packages/tui/src/theme/presets/rounded.ts
+init_borders();
+var roundedTheme = {
+  ...defaultTheme,
+  name: "rounded",
+  border: "rounded",
+  borderChars: BORDERS.rounded,
+  treeGuide: "rounded"
+};
+
+export { roundedTheme };

package/dist/shared/@outfitter/tui-f1mj6h6p.d.ts

@@ -0,0 +1,2 @@
+import { ANSI, createTheme, Theme, Tokens } from "@outfitter/cli/colors";
+export { ANSI, createTheme, Theme, Tokens };

package/dist/shared/@outfitter/tui-gcpz529w.js

@@ -0,0 +1,122 @@
+// @bun
+import {
+  getExample
+} from "./tui-nprd7g0d.js";
+import {
+  demoSection
+} from "./tui-733asbd8.js";
+import {
+  TREE_GUIDES,
+  renderTree
+} from "./tui-kydbggmj.js";
+
+// packages/tui/src/demo/renderers/tree.ts
+function renderTreeDemo(config, _theme) {
+  const showCode = config.showCode ?? true;
+  const lines = [];
+  lines.push(demoSection("Basic Tree"));
+  lines.push("");
+  if (showCode) {
+    lines.push('import { renderTree } from "@outfitter/tui/tree";');
+    lines.push("");
+  }
+  const treeData = getExample("treeData", config.examples);
+  if (showCode) {
+    lines.push("renderTree({");
+    lines.push("  src: {");
+    lines.push("    components: { Button: null, Input: null },");
+    lines.push("    utils: null,");
+    lines.push("  },");
+    lines.push("  tests: null,");
+    lines.push("})");
+    lines.push("");
+  }
+  lines.push(renderTree(treeData));
+  lines.push("");
+  lines.push(demoSection("Guide Styles"));
+  lines.push("");
+  const guideDemo = {
+    root: {
+      child1: {
+        leaf: null
+      },
+      child2: null
+    }
+  };
+  const guideStyles = [
+    "single",
+    "rounded",
+    "heavy",
+    "double"
+  ];
+  for (const style of guideStyles) {
+    const guide = TREE_GUIDES[style];
+    lines.push(`${style.toUpperCase()} (fork: "${guide.fork.trim()}", end: "${guide.end.trim()}")`);
+    lines.push("");
+    lines.push(renderTree(guideDemo, { guide: style }));
+    lines.push("");
+  }
+  lines.push(demoSection("Max Depth"));
+  lines.push("");
+  const deepTree = {
+    level1: {
+      level2: {
+        level3: {
+          level4: null
+        }
+      }
+    }
+  };
+  if (showCode) {
+    lines.push("renderTree(tree, { maxDepth: 2 })");
+    lines.push("");
+  }
+  lines.push("Full tree:");
+  lines.push(renderTree(deepTree));
+  lines.push("");
+  lines.push("With maxDepth: 2:");
+  lines.push(renderTree(deepTree, { maxDepth: 2 }));
+  lines.push("");
+  lines.push(demoSection("Custom Labels"));
+  lines.push("");
+  const fileTree = {
+    src: {
+      "index.ts": null,
+      components: {
+        "Button.tsx": null
+      }
+    },
+    "package.json": null
+  };
+  if (showCode) {
+    lines.push("renderTree(tree, {");
+    lines.push("  renderLabel: (key, value) => {");
+    lines.push("    if (value && typeof value === 'object') {");
+    lines.push("      return `\uD83D\uDCC1 ${key}/`;");
+    lines.push("    }");
+    lines.push("    return `\uD83D\uDCC4 ${key}`;");
+    lines.push("  }");
+    lines.push("})");
+    lines.push("");
+  }
+  lines.push(renderTree(fileTree, {
+    renderLabel: (key, value) => {
+      if (value && typeof value === "object") {
+        return `\uD83D\uDCC1 ${key}/`;
+      }
+      return `\uD83D\uDCC4 ${key}`;
+    }
+  }));
+  lines.push("");
+  lines.push(demoSection("Usage Notes"));
+  lines.push("");
+  lines.push("\u2022 Objects become branches with children");
+  lines.push("\u2022 null values become leaf nodes (terminal)");
+  lines.push("\u2022 Use guide option to change visual style");
+  lines.push("\u2022 Use maxDepth to limit rendering depth");
+  lines.push("\u2022 Use renderLabel for custom node formatting");
+  return lines.join(`
+`);
+}
+
+export { renderTreeDemo };

package/dist/shared/@outfitter/tui-gqsdhmk9.d.ts

@@ -0,0 +1,42 @@
+/**
+* JSON and text rendering utilities.
+*
+* Simple renderers for JSON and plain text output.
+*
+* @packageDocumentation
+*/
+/**
+* Renders data as pretty-printed JSON.
+*
+* Uses `JSON.stringify` with 2-space indentation.
+* Suitable for displaying structured data in terminal output.
+*
+* @param data - Data to render as JSON
+* @returns Pretty-printed JSON string
+*
+* @example
+* ```typescript
+* console.log(renderJson({ name: "test", value: 42 }));
+* // {
+* //   "name": "test",
+* //   "value": 42
+* // }
+* ```
+*/
+declare function renderJson(data: unknown): string;
+/**
+* Renders plain text unchanged.
+*
+* This is a pass-through function that returns the input text as-is.
+* Useful as a placeholder or for consistent API across render functions.
+*
+* @param text - Text to render
+* @returns The input text unchanged
+*
+* @example
+* ```typescript
+* renderText("Hello, World!"); // "Hello, World!"
+* ```
+*/
+declare function renderText(text: string): string;
+export { renderJson, renderText };

package/dist/shared/@outfitter/tui-hescagw2.js

@@ -0,0 +1,32 @@
+// @bun
+var __defProp = Object.defineProperty;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __moduleCache = /* @__PURE__ */ new WeakMap;
+var __toCommonJS = (from) => {
+  var entry = __moduleCache.get(from), desc;
+  if (entry)
+    return entry;
+  entry = __defProp({}, "__esModule", { value: true });
+  if (from && typeof from === "object" || typeof from === "function")
+    __getOwnPropNames(from).map((key) => !__hasOwnProp.call(entry, key) && __defProp(entry, key, {
+      get: () => from[key],
+      enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+    }));
+  __moduleCache.set(from, entry);
+  return entry;
+};
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {
+      get: all[name],
+      enumerable: true,
+      configurable: true,
+      set: (newValue) => all[name] = () => newValue
+    });
+};
+var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
+var __require = import.meta.require;
+
+export { __toCommonJS, __export, __esm, __require };

package/dist/shared/@outfitter/tui-j2kd7eej.js

@@ -0,0 +1,126 @@
+// @bun
+import {
+  getExample
+} from "./tui-nprd7g0d.js";
+import {
+  demoSection
+} from "./tui-733asbd8.js";
+import {
+  LIST_STYLE_META,
+  getListStyles
+} from "./tui-nr580mbv.js";
+import {
+  renderList
+} from "./tui-5dsn6d6d.js";
+
+// packages/tui/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/tui/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/tui-j3bkjt2g.js

@@ -0,0 +1,7 @@
+// @bun
+import {
+  init_box
+} from "./tui-t9vd88jr.js";
+
+// packages/tui/src/box/index.ts
+init_box();

package/dist/shared/@outfitter/tui-jnn9d8cd.js

@@ -0,0 +1,8 @@
+// @bun
+// packages/tui/src/preset/standard.ts
+import {
+  ANSI,
+  createTheme
+} from "@outfitter/cli/colors";
+
+export { ANSI, createTheme };