@outfitter/cli 0.1.0-rc.2 → 0.1.0

package/dist/shared/@outfitter/cli-b0tzqgnf.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/cli-b5c2k0d7.js

@@ -0,0 +1,39 @@
+// @bun
+// packages/cli/src/render/tree.ts
+var TREE_GUIDES = {
+  single: { vertical: "\u2502   ", fork: "\u251C\u2500\u2500 ", end: "\u2514\u2500\u2500 " },
+  heavy: { vertical: "\u2503   ", fork: "\u2523\u2501\u2501 ", end: "\u2517\u2501\u2501 " },
+  double: { vertical: "\u2551   ", fork: "\u2560\u2550\u2550 ", end: "\u255A\u2550\u2550 " },
+  rounded: { vertical: "\u2502   ", fork: "\u251C\u2500\u2500 ", end: "\u2570\u2500\u2500 " }
+};
+function renderTree(tree, options) {
+  const guide = TREE_GUIDES[options?.guide ?? "single"];
+  const maxDepth = options?.maxDepth;
+  const renderLabel = options?.renderLabel ?? ((key) => key);
+  const lines = [];
+  const renderNode = (key, value, prefix, isLast, depth) => {
+    if (maxDepth !== undefined && depth >= maxDepth) {
+      return;
+    }
+    const connector = isLast ? guide.end : guide.fork;
+    const label = renderLabel(key, value, depth);
+    lines.push(prefix + connector + label);
+    if (value !== null && typeof value === "object") {
+      const entries2 = Object.entries(value);
+      const childPrefix = prefix + (isLast ? "    " : guide.vertical);
+      entries2.forEach(([childKey, childValue], index) => {
+        const childIsLast = index === entries2.length - 1;
+        renderNode(childKey, childValue, childPrefix, childIsLast, depth + 1);
+      });
+    }
+  };
+  const entries = Object.entries(tree);
+  entries.forEach(([key, value], index) => {
+    const isLast = index === entries.length - 1;
+    renderNode(key, value, "", isLast, 0);
+  });
+  return lines.join(`
+`);
+}
+
+export { TREE_GUIDES, renderTree };

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

@@ -0,0 +1 @@
+// @bun

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

@@ -0,0 +1,23 @@
+// @bun
+import {
+  createCancelledError
+} from "./cli-8bwaw3pz.js";
+
+// packages/cli/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/cli-bf3vma4q.js

@@ -0,0 +1,61 @@
+// @bun
+import {
+  createCancelledError
+} from "./cli-8bwaw3pz.js";
+
+// packages/cli/src/prompt/select.ts
+import { isCancel, multiselect, select } from "@clack/prompts";
+import { Result } from "better-result";
+async function promptSelect(options) {
+  const clackOptions = options.options.map((opt) => {
+    const mapped = {
+      value: opt.value,
+      label: opt.label
+    };
+    if (opt.hint !== undefined) {
+      mapped.hint = opt.hint;
+    }
+    return mapped;
+  });
+  const selectOptions = {
+    message: options.message,
+    options: clackOptions
+  };
+  if (options.initialValue !== undefined) {
+    selectOptions.initialValue = options.initialValue;
+  }
+  const result = await select(selectOptions);
+  if (isCancel(result)) {
+    return Result.err(createCancelledError());
+  }
+  return Result.ok(result);
+}
+async function promptMultiSelect(options) {
+  const clackOptions = options.options.map((opt) => {
+    const mapped = {
+      value: opt.value,
+      label: opt.label
+    };
+    if (opt.hint !== undefined) {
+      mapped.hint = opt.hint;
+    }
+    return mapped;
+  });
+  const multiselectOptions = {
+    message: options.message,
+    options: clackOptions
+  };
+  if (options.initialValues !== undefined) {
+    multiselectOptions.initialValues = options.initialValues;
+  }
+  if (options.required !== undefined) {
+    multiselectOptions.required = options.required;
+  }
+  const result = await multiselect(multiselectOptions);
+  if (isCancel(result)) {
+    return Result.err(createCancelledError());
+  }
+  return Result.ok(result);
+}
+
+export { promptSelect, promptMultiSelect };

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

@@ -0,0 +1,53 @@
+/**
+* Minimal writable stream interface.
+*/
+interface WritableStream {
+	write(str: string): boolean;
+	isTTY?: boolean;
+}
+/**
+* Options for creating a stream writer.
+*/
+interface StreamWriterOptions {
+	/** Target stream (defaults to process.stdout) */
+	stream?: WritableStream;
+}
+/**
+* Interface for managing in-place terminal output.
+*/
+interface StreamWriter {
+	/** Write content (replaces current content) */
+	write(content: string): void;
+	/** Update content in place */
+	update(content: string): void;
+	/** Persist current content and move to new line */
+	persist(): void;
+	/** Clear current content */
+	clear(): void;
+}
+/**
+* Creates a stream writer for in-place terminal updates.
+*
+* The writer tracks the number of lines written and can update them in place.
+* In non-TTY mode, it falls back to simple line-by-line output.
+*
+* @param options - Writer configuration
+* @returns StreamWriter instance
+*
+* @example
+* ```typescript
+* import { createStreamWriter } from "@outfitter/cli/streaming";
+*
+* const writer = createStreamWriter();
+*
+* writer.write("Processing...");
+* // Do some work
+* writer.update("Processing... 50%");
+* // Do more work
+* writer.update("Processing... 100%");
+* writer.persist();
+* writer.write("Done!");
+* ```
+*/
+declare function createStreamWriter(options?: StreamWriterOptions): StreamWriter;
+export { WritableStream, StreamWriterOptions, StreamWriter, createStreamWriter };

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

@@ -0,0 +1,59 @@
+// @bun
+import {
+  BORDERS,
+  init_borders
+} from "./cli-85fg2vr5.js";
+import {
+  ANSI,
+  init_colors
+} from "./cli-9nbyj2bt.js";
+
+// packages/cli/src/theme/presets/default.ts
+init_borders();
+init_colors();
+var defaultTheme = {
+  name: "default",
+  border: "single",
+  borderChars: BORDERS.single,
+  treeGuide: "single",
+  delimiter: "bullet",
+  markers: {
+    default: { type: "indicator", category: "marker", name: "circleOutline" },
+    current: { type: "indicator", category: "marker", name: "circleDot" },
+    focused: { type: "indicator", category: "marker", name: "pointer" },
+    checked: { type: "indicator", category: "marker", name: "checkboxChecked" },
+    disabled: { type: "indicator", category: "marker", name: "dash" },
+    success: { type: "indicator", category: "status", name: "success" },
+    warning: { type: "indicator", category: "status", name: "warning" },
+    error: { type: "indicator", category: "status", name: "error" },
+    info: { type: "indicator", category: "status", name: "info" }
+  },
+  listBullet: { unicode: "\u2022", fallback: "-" },
+  checkbox: {
+    checked: { unicode: "\u2611", fallback: "[x]" },
+    unchecked: { unicode: "\u2610", fallback: "[ ]" }
+  },
+  colors: {
+    success: ANSI.green,
+    warning: ANSI.yellow,
+    error: ANSI.red,
+    info: ANSI.blue,
+    primary: "",
+    secondary: ANSI.gray,
+    muted: ANSI.dim,
+    accent: ANSI.cyan,
+    highlight: ANSI.bold,
+    link: `${ANSI.cyan}${ANSI.underline}`,
+    destructive: ANSI.brightRed,
+    subtle: `${ANSI.dim}${ANSI.gray}`
+  },
+  spacing: {
+    boxPadding: 1,
+    listIndent: 2,
+    stackGap: 0,
+    horizontalGap: 1
+  },
+  spinner: "dots"
+};
+
+export { defaultTheme };

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

@@ -0,0 +1,128 @@
+import { CaseMode, SeparatorStyle } from "./cli-6bztk73z";
+import { Theme } from "./cli-xsaheemc";
+/**
+* Options for creating a demo section.
+*/
+interface SectionOptions {
+	/** Separator character style (default: "─") */
+	separator?: SeparatorStyle;
+	/** Case transformation (default: "title") */
+	case?: CaseMode;
+}
+/**
+* Options for creating a subsection.
+*/
+interface SubsectionOptions {
+	/** Separator character style (default: "─") */
+	separator?: SeparatorStyle;
+	/** Case transformation (default: "title") */
+	case?: CaseMode;
+}
+/**
+* Creates a demo section heading.
+*
+* Sections are major divisions in a demo, rendered with title case text
+* and thin Unicode line separators by default.
+*
+* @param title - The section title
+* @param options - Optional rendering options
+* @returns Formatted section heading string
+*
+* @example
+* ```typescript
+* import { demoSection } from "@outfitter/cli/demo";
+*
+* console.log(demoSection("Theme Colors"));
+* // Theme Colors
+* // ────────────
+* ```
+*/
+declare function demoSection(title: string, options?: SectionOptions): string;
+/**
+* Creates a demo subsection heading.
+*
+* Subsections are minor divisions within a section, rendered with title case
+* text and thin Unicode line separators by default.
+*
+* @param title - The subsection title
+* @param options - Optional rendering options
+* @returns Formatted subsection heading string
+*
+* @example
+* ```typescript
+* import { demoSubsection } from "@outfitter/cli/demo";
+*
+* console.log(demoSubsection("Status"));
+* // Status
+* // ──────
+* ```
+*/
+declare function demoSubsection(title: string, options?: SubsectionOptions): string;
+/**
+* Creates a code block for demo sections.
+*
+* Code blocks are displayed when `showCode` is enabled and provide
+* usage examples for the primitives being demonstrated.
+*
+* @param lines - Lines of code to display
+* @param show - Whether to show the code block (default: true)
+* @returns Array of code lines, or empty array if hidden
+*
+* @example
+* ```typescript
+* import { codeBlock } from "@outfitter/cli/demo";
+*
+* const code = codeBlock([
+*   'import { renderBox } from "@outfitter/cli/render";',
+*   "",
+*   'renderBox("Hello")',
+* ], true);
+* ```
+*/
+declare function codeBlock(lines: string[], show?: boolean): string[];
+/**
+* Creates a description line styled with muted theme.
+*
+* Descriptions provide contextual information about a demo section
+* when `showDescriptions` is enabled.
+*
+* @param text - The description text
+* @param theme - Theme for styling
+* @param show - Whether to show the description (default: true)
+* @returns Array with styled description, or empty array if hidden
+*
+* @example
+* ```typescript
+* import { description } from "@outfitter/cli/demo";
+*
+* const desc = description(
+*   "Control padding per side with an object.",
+*   theme,
+*   true
+* );
+* ```
+*/
+declare function description(text: string, theme: Theme, show?: boolean): string[];
+/**
+* Joins demo content with vertical spacing.
+*
+* Wraps `joinVertical` with demo-appropriate defaults.
+*
+* @param blocks - Content blocks to join
+* @param gap - Lines of spacing between blocks (default: 1)
+* @returns Combined string with blocks stacked
+*
+* @example
+* ```typescript
+* import { demoSection, demoContent } from "@outfitter/cli/demo";
+*
+* const output = demoContent([
+*   demoSection("Colors"),
+*   "Color examples here...",
+*   demoSection("Borders"),
+*   "Border examples here...",
+* ]);
+* ```
+*/
+declare function demoContent(blocks: string[], gap?: number): string;
+export { SectionOptions, SubsectionOptions, demoSection, demoSubsection, codeBlock, description, demoContent };

package/dist/shared/@outfitter/{cli-jbj78ac5.js → cli-d9ad0rqj.js}

@@ -1,4 +1,8 @@
 // @bun
+import {
+  __esm
+} from "./cli-v1tzwxkt.js";
+
 // packages/cli/src/terminal/detection.ts
 import { getEnvBoolean } from "@outfitter/config";
 function getEnvValue(key) {
@@ -66,5 +70,6 @@ function isInteractive(options) {
   const isTTY = options?.isTTY ?? process.stdout.isTTY ?? false;
   return isTTY;
 }
+var init_detection = () => {};
 
-export { getEnvValue, hasNoColorEnv, resolveForceColorEnv, resolveColorEnv, supportsColor, getTerminalWidth, isInteractive };
+export { getEnvValue, hasNoColorEnv, resolveForceColorEnv, resolveColorEnv, supportsColor, getTerminalWidth, isInteractive, init_detection };

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

@@ -0,0 +1,61 @@
+// @bun
+import {
+  renderProgress
+} from "./cli-bc17qeh2.js";
+import {
+  demoSection
+} from "./cli-34fqr7bp.js";
+
+// packages/cli/src/demo/renderers/progress.ts
+function renderProgressDemo(config, _theme) {
+  const showCode = config.showCode ?? true;
+  const lines = [];
+  lines.push(demoSection("Basic Progress Bar"));
+  lines.push("");
+  if (showCode) {
+    lines.push('import { renderProgress } from "@outfitter/cli/render";');
+    lines.push("");
+  }
+  const percentages = [0, 25, 50, 75, 100];
+  for (const pct of percentages) {
+    const bar = renderProgress({ current: pct, total: 100 });
+    lines.push(`${pct.toString().padStart(3)}% ${bar}`);
+  }
+  lines.push("");
+  lines.push(demoSection("With Percentage Display"));
+  lines.push("");
+  if (showCode) {
+    lines.push("renderProgress({ current: 75, total: 100, showPercent: true })");
+    lines.push("");
+  }
+  lines.push(renderProgress({ current: 75, total: 100, showPercent: true }));
+  lines.push("");
+  lines.push(demoSection("Custom Width"));
+  lines.push("");
+  const widths = [10, 20, 30, 40];
+  for (const width of widths) {
+    if (showCode) {
+      lines.push(`renderProgress({ current: 50, total: 100, width: ${width} })`);
+    }
+    const bar = renderProgress({ current: 50, total: 100, width });
+    lines.push(`  ${bar}`);
+    lines.push("");
+  }
+  lines.push(demoSection("Edge Cases"));
+  lines.push("");
+  lines.push("Empty (0%):");
+  lines.push(`  ${renderProgress({ current: 0, total: 100 })}`);
+  lines.push("");
+  lines.push("Full (100%):");
+  lines.push(`  ${renderProgress({ current: 100, total: 100 })}`);
+  lines.push("");
+  lines.push("Over 100% (capped):");
+  lines.push(`  ${renderProgress({ current: 150, total: 100, showPercent: true })}`);
+  lines.push("");
+  lines.push("Negative (floored to 0%):");
+  lines.push(`  ${renderProgress({ current: -10, total: 100, showPercent: true })}`);
+  return lines.join(`
+`);
+}
+
+export { renderProgressDemo };

package/dist/shared/@outfitter/cli-e5ms1y0x.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 };