@outfitter/cli 0.1.0-rc.2 → 0.1.0

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

@@ -0,0 +1,93 @@
+import { VisualTheme } from "./cli-s0kkx9m1";
+import { LayoutContext } from "./cli-2g8bx1aq";
+/**
+* Layout context extended with theme information.
+*
+* Allows themes to cascade through component hierarchies. Children
+* inherit their parent's theme unless explicitly overridden.
+*
+* @example
+* ```typescript
+* import { createThemedContext, roundedTheme } from "@outfitter/cli/theme";
+*
+* // Create root context with theme
+* const ctx = createThemedContext({ theme: roundedTheme, width: 80 });
+*
+* // Child inherits theme from parent
+* const childCtx = createThemedContext({ width: 40, parent: ctx });
+* console.log(childCtx.theme.border); // "rounded" (inherited)
+*
+* // Child can override theme
+* const overrideCtx = createThemedContext({
+*   theme: boldTheme,
+*   width: 40,
+*   parent: ctx
+* });
+* console.log(overrideCtx.theme.border); // "heavy"
+* ```
+*/
+interface ThemedLayoutContext extends LayoutContext {
+	/** The visual theme for this context */
+	readonly theme: VisualTheme;
+}
+/**
+* Options for creating a themed layout context.
+*/
+interface ThemedContextOptions {
+	/** Visual theme (inherited from parent if not specified) */
+	theme?: VisualTheme;
+	/** Available width in characters */
+	width?: number;
+	/** Parent context for inheritance */
+	parent?: ThemedLayoutContext;
+}
+/**
+* Creates a themed layout context with cascading inheritance.
+*
+* Theme inheritance rules:
+* 1. Explicit theme → use it
+* 2. Parent exists → inherit parent's theme
+* 3. No theme or parent → use defaultTheme
+*
+* Width inheritance rules:
+* 1. Explicit width → use it
+* 2. Parent exists → inherit parent's width
+* 3. No width or parent → use terminal width (via getTerminalWidth)
+*
+* @param options - Context configuration
+* @returns A ThemedLayoutContext with resolved theme and width
+*
+* @example
+* ```typescript
+* // Root context with explicit theme and width
+* const root = createThemedContext({ theme: roundedTheme, width: 100 });
+*
+* // Child with inherited theme, explicit width
+* const child = createThemedContext({ width: 50, parent: root });
+*
+* // Nested child with overridden theme
+* const nested = createThemedContext({
+*   theme: boldTheme,
+*   parent: child
+* });
+* ```
+*/
+declare function createThemedContext(options: ThemedContextOptions): ThemedLayoutContext;
+/**
+* Gets the theme from a context, with fallback to defaultTheme.
+*
+* Useful when you have an optional context and need a theme.
+*
+* @param ctx - Optional themed context
+* @returns The context's theme or defaultTheme if no context
+*
+* @example
+* ```typescript
+* function renderComponent(ctx?: ThemedLayoutContext) {
+*   const theme = getContextTheme(ctx);
+*   // theme is always defined
+* }
+* ```
+*/
+declare function getContextTheme(ctx?: ThemedLayoutContext): VisualTheme;
+export { ThemedLayoutContext, ThemedContextOptions, createThemedContext, getContextTheme };

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

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

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

@@ -0,0 +1,48 @@
+// @bun
+import {
+  defaultTheme
+} from "./cli-cs45xd6q.js";
+import {
+  BORDERS,
+  init_borders
+} from "./cli-85fg2vr5.js";
+
+// packages/cli/src/theme/create.ts
+init_borders();
+function createVisualTheme(options) {
+  const base = options?.extends ?? defaultTheme;
+  const overrides = options?.overrides ?? {};
+  const border = overrides.border ?? base.border;
+  const borderChars = overrides.borderChars ?? (overrides.border ? BORDERS[overrides.border] : base.borderChars);
+  const colors = {
+    ...base.colors,
+    ...overrides.colors
+  };
+  const spacing = {
+    ...base.spacing,
+    ...overrides.spacing
+  };
+  const markers = {
+    ...base.markers,
+    ...overrides.markers
+  };
+  const checkbox = {
+    checked: overrides.checkbox?.checked ?? base.checkbox.checked,
+    unchecked: overrides.checkbox?.unchecked ?? base.checkbox.unchecked
+  };
+  return {
+    name: overrides.name ?? base.name,
+    border,
+    borderChars,
+    treeGuide: overrides.treeGuide ?? base.treeGuide,
+    delimiter: overrides.delimiter ?? base.delimiter,
+    markers,
+    listBullet: overrides.listBullet ?? base.listBullet,
+    checkbox,
+    colors,
+    spacing,
+    spinner: overrides.spinner ?? base.spinner
+  };
+}
+
+export { createVisualTheme };

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

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

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

@@ -0,0 +1,106 @@
+/**
+* Box-drawing border utilities.
+*
+* Provides border character sets and line drawing functions for tables, boxes, and panels.
+*
+* @packageDocumentation
+*/
+/**
+* Available border style presets.
+*
+* - `single`: Standard Unicode single-line borders (┌─┐)
+* - `double`: Double-line borders (╔═╗)
+* - `rounded`: Rounded corners with single lines (╭─╮)
+* - `heavy`: Thick/heavy borders (┏━┓)
+* - `ascii`: ASCII-only fallback (+, -, |)
+* - `none`: No borders (empty strings)
+*/
+type BorderStyle = "single" | "double" | "rounded" | "heavy" | "ascii" | "none";
+/**
+* Complete set of box-drawing characters for a border style.
+*
+* Includes corners, edges, and intersection characters for building
+* tables, boxes, and other bordered elements.
+*/
+interface BorderCharacters {
+	/** Top-left corner (e.g., ┌ ╔ ╭ ┏) */
+	topLeft: string;
+	/** Top-right corner (e.g., ┐ ╗ ╮ ┓) */
+	topRight: string;
+	/** Bottom-left corner (e.g., └ ╚ ╰ ┗) */
+	bottomLeft: string;
+	/** Bottom-right corner (e.g., ┘ ╝ ╯ ┛) */
+	bottomRight: string;
+	/** Horizontal line (e.g., ─ ═ ━) */
+	horizontal: string;
+	/** Vertical line (e.g., │ ║ ┃) */
+	vertical: string;
+	/** Top T-intersection for column separators (e.g., ┬ ╦ ┳) */
+	topT: string;
+	/** Bottom T-intersection for column separators (e.g., ┴ ╩ ┻) */
+	bottomT: string;
+	/** Left T-intersection for row separators (e.g., ├ ╠ ┣) */
+	leftT: string;
+	/** Right T-intersection for row separators (e.g., ┤ ╣ ┫) */
+	rightT: string;
+	/** Cross intersection for table cells (e.g., ┼ ╬ ╋) */
+	cross: string;
+}
+/**
+* Preset border character sets for each style.
+*
+* @example
+* ```typescript
+* import { BORDERS } from "@outfitter/cli";
+*
+* const single = BORDERS.single;
+* console.log(`${single.topLeft}${single.horizontal.repeat(10)}${single.topRight}`);
+* // Output: ┌──────────┐
+* ```
+*/
+declare const BORDERS: Record<BorderStyle, BorderCharacters>;
+/**
+* Returns the border character set for the given style.
+*
+* @param style - The border style preset
+* @returns The complete set of border characters
+*
+* @example
+* ```typescript
+* const chars = getBorderCharacters("rounded");
+* console.log(chars.topLeft); // ╭
+* console.log(chars.topRight); // ╮
+* ```
+*/
+declare function getBorderCharacters(style: BorderStyle): BorderCharacters;
+/**
+* Position of a horizontal line within a bordered element.
+*/
+type LinePosition = "top" | "middle" | "bottom";
+/**
+* Draws a horizontal line with the appropriate corner/intersection characters.
+*
+* Used for building table borders and box edges. Handles column intersections
+* when column widths are provided.
+*
+* @param width - Total width of the line content (excluding corners)
+* @param chars - Border character set to use
+* @param position - Position of line: "top", "middle", or "bottom"
+* @param columnWidths - Optional array of column widths for intersection placement
+* @returns The formatted horizontal line string
+*
+* @example
+* ```typescript
+* const chars = getBorderCharacters("single");
+*
+* // Simple line (no columns)
+* drawHorizontalLine(10, chars, "top");
+* // Returns: ┌──────────┐
+*
+* // Line with column intersections
+* drawHorizontalLine(14, chars, "middle", [5, 7]);
+* // Returns: ├─────┼───────┤
+* ```
+*/
+declare function drawHorizontalLine(width: number, chars: BorderCharacters, position: LinePosition, columnWidths?: number[]): string;
+export { BorderStyle, BorderCharacters, BORDERS, getBorderCharacters, LinePosition, drawHorizontalLine };

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

@@ -0,0 +1,94 @@
+// @bun
+import {
+  renderTable
+} from "./cli-an9j0h80.js";
+import {
+  BORDER_STYLE_META,
+  getBorderStyles
+} from "./cli-kc84wmch.js";
+import {
+  getExample
+} from "./cli-xep6v2c0.js";
+import {
+  demoSection
+} from "./cli-34fqr7bp.js";
+
+// packages/cli/src/demo/renderers/table.ts
+function renderTableDemo(config, theme) {
+  const showCode = config.showCode ?? true;
+  const showDescriptions = config.showDescriptions ?? true;
+  const lines = [];
+  lines.push(demoSection("Basic Table"));
+  lines.push("");
+  if (showCode) {
+    lines.push('import { renderTable } from "@outfitter/cli/render";');
+    lines.push("");
+    lines.push("renderTable([");
+    lines.push('  { id: 1, name: "Alice", status: "Active" },');
+    lines.push('  { id: 2, name: "Bob", status: "Pending" },');
+    lines.push("])");
+    lines.push("");
+  }
+  const basicData = getExample("tableData", config.examples);
+  lines.push(renderTable(basicData));
+  lines.push("");
+  lines.push(demoSection("Custom Headers"));
+  lines.push("");
+  if (showCode) {
+    lines.push("renderTable(data, {");
+    lines.push('  headers: { id: "Task ID", name: "Assignee" }');
+    lines.push("})");
+    lines.push("");
+  }
+  lines.push(renderTable(basicData, {
+    headers: { id: "Task ID", name: "Assignee" }
+  }));
+  lines.push("");
+  lines.push(demoSection("Border Styles"));
+  lines.push("");
+  const styles = getBorderStyles().filter((s) => s !== "none");
+  const smallData = [
+    { id: 1, name: "Alice" },
+    { id: 2, name: "Bob" }
+  ];
+  for (const style of styles) {
+    const meta = BORDER_STYLE_META[style];
+    lines.push(`${meta.label.toUpperCase()} (border: "${style}")`);
+    if (showDescriptions) {
+      lines.push(theme.muted(meta.description));
+    }
+    lines.push("");
+    lines.push(renderTable(smallData, { border: style }));
+    lines.push("");
+  }
+  lines.push(demoSection("Compact Mode"));
+  lines.push("");
+  if (showCode) {
+    lines.push("renderTable(data, { compact: true })");
+    lines.push("");
+  }
+  lines.push(renderTable(smallData, { compact: true }));
+  lines.push("");
+  lines.push(theme.muted("Compact mode removes borders and uses space separators."));
+  lines.push("");
+  lines.push(demoSection("Wide Characters (CJK/Emoji)"));
+  lines.push("");
+  if (showCode) {
+    lines.push("renderTable([");
+    lines.push('  { id: 1, name: "\u5C71\u7530\u592A\u90CE", status: "\u5B8C\u4E86" },');
+    lines.push('  { id: 2, name: "Party \uD83C\uDF89", status: "\uD83D\uDE80" },');
+    lines.push("])");
+    lines.push("");
+  }
+  const wideData = [
+    { id: 1, name: "\u5C71\u7530\u592A\u90CE", status: "\u5B8C\u4E86" },
+    { id: 2, name: "Party \uD83C\uDF89", status: "\uD83D\uDE80" }
+  ];
+  lines.push(renderTable(wideData));
+  lines.push("");
+  lines.push(theme.muted("Uses Bun.stringWidth() for correct column alignment."));
+  return lines.join(`
+`);
+}
+
+export { renderTableDemo };

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

@@ -0,0 +1,66 @@
+import { WritableStream } from "./cli-cf1xexgn";
+/**
+* Spinner frame sets.
+*/
+declare const SPINNER_FRAMES: {
+	readonly dots: readonly ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"];
+	readonly line: readonly ["-", "\\", "|", "/"];
+	readonly simple: readonly ["◐", "◓", "◑", "◒"];
+};
+/**
+* Available spinner styles.
+*/
+type SpinnerStyle = keyof typeof SPINNER_FRAMES;
+/**
+* Options for creating a spinner.
+*/
+interface SpinnerOptions {
+	/** Spinner style */
+	style?: SpinnerStyle;
+	/** Target stream */
+	stream?: WritableStream;
+	/** Frame interval in ms */
+	interval?: number;
+}
+/**
+* Spinner interface for animated progress indication.
+*/
+interface Spinner {
+	/** Start the spinner */
+	start(): void;
+	/** Update the spinner message */
+	update(message: string): void;
+	/** Stop with success state */
+	succeed(message?: string): void;
+	/** Stop with failure state */
+	fail(message?: string): void;
+	/** Stop the spinner */
+	stop(): void;
+}
+/**
+* Creates an animated spinner for indicating progress.
+*
+* In TTY mode, shows an animated spinner. In non-TTY mode,
+* falls back to static output.
+*
+* @param message - Initial spinner message
+* @param options - Spinner configuration
+* @returns Spinner instance
+*
+* @example
+* ```typescript
+* import { createSpinner } from "@outfitter/cli/streaming";
+*
+* const spinner = createSpinner("Installing dependencies");
+* spinner.start();
+*
+* try {
+*   await install();
+*   spinner.succeed("Dependencies installed");
+* } catch (error) {
+*   spinner.fail("Installation failed");
+* }
+* ```
+*/
+declare function createSpinner(message: string, options?: SpinnerOptions): Spinner;
+export { SpinnerStyle, SpinnerOptions, Spinner, createSpinner };