@outfitter/cli 0.1.0-rc.1 → 0.1.0-rc.3

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

@@ -0,0 +1,169 @@
+// @bun
+// packages/cli/src/render/indicators.ts
+var INDICATORS = {
+  status: {
+    success: { unicode: "\u2714", fallback: "[ok]", color: "green" },
+    error: { unicode: "\u2716", fallback: "[x]", color: "red" },
+    warning: { unicode: "\u26A0", fallback: "[!]", color: "yellow" },
+    info: { unicode: "\u2139", fallback: "[i]", color: "blue" }
+  },
+  marker: {
+    circle: { unicode: "\u25CF", fallback: "*" },
+    circleOutline: { unicode: "\u25CB", fallback: "o" },
+    circleDotted: { unicode: "\u25CC", fallback: "o" },
+    circleSmall: { unicode: "\u2022", fallback: "\xB7" },
+    circleDot: { unicode: "\u25C9", fallback: "(*)" },
+    circleDotOutline: { unicode: "\u25EF", fallback: "( )" },
+    square: { unicode: "\u25A0", fallback: "[#]" },
+    squareOutline: { unicode: "\u25A1", fallback: "[ ]" },
+    squareSmall: { unicode: "\u25FC", fallback: "[#]" },
+    squareSmallOutline: { unicode: "\u25FB", fallback: "[ ]" },
+    lozenge: { unicode: "\u25C6", fallback: "\u2666" },
+    lozengeOutline: { unicode: "\u25C7", fallback: "\u25CA" },
+    dash: { unicode: "\u2013", fallback: "-" },
+    pointer: { unicode: "\u276F", fallback: ">" },
+    pointerSmall: { unicode: "\u203A", fallback: ">" },
+    checkbox: { unicode: "\u2610", fallback: "[ ]" },
+    checkboxChecked: { unicode: "\u2611", fallback: "[x]" },
+    checkboxCross: { unicode: "\u2612", fallback: "[X]" }
+  },
+  progress: {
+    circleEmpty: { unicode: "\u25CB", fallback: "." },
+    circleQuarter: { unicode: "\u25D4", fallback: "o" },
+    circleHalf: { unicode: "\u25D1", fallback: "O" },
+    circleThree: { unicode: "\u25D5", fallback: "0" },
+    circleFull: { unicode: "\u25CF", fallback: "@" },
+    vertical1: { unicode: "\u2581", fallback: "_" },
+    vertical2: { unicode: "\u2582", fallback: "_" },
+    vertical3: { unicode: "\u2583", fallback: "=" },
+    vertical4: { unicode: "\u2584", fallback: "=" },
+    vertical5: { unicode: "\u2585", fallback: "#" },
+    vertical6: { unicode: "\u2586", fallback: "#" },
+    vertical7: { unicode: "\u2587", fallback: "#" },
+    verticalFull: { unicode: "\u2588", fallback: "#" },
+    horizontal1: { unicode: "\u258F", fallback: "|" },
+    horizontal2: { unicode: "\u258E", fallback: "|" },
+    horizontal3: { unicode: "\u258D", fallback: "|" },
+    horizontal4: { unicode: "\u258C", fallback: "|" },
+    horizontal5: { unicode: "\u258B", fallback: "|" },
+    horizontal6: { unicode: "\u258A", fallback: "|" },
+    horizontal7: { unicode: "\u2589", fallback: "|" },
+    horizontalFull: { unicode: "\u2588", fallback: "#" },
+    shadeLight: { unicode: "\u2591", fallback: "." },
+    shadeMedium: { unicode: "\u2592", fallback: ":" },
+    shadeDark: { unicode: "\u2593", fallback: "#" }
+  },
+  triangle: {
+    up: { unicode: "\u25B2", fallback: "^" },
+    upSmall: { unicode: "\u25B4", fallback: "^" },
+    upOutline: { unicode: "\u25B3", fallback: "^" },
+    down: { unicode: "\u25BC", fallback: "v" },
+    downSmall: { unicode: "\u25BE", fallback: "v" },
+    downOutline: { unicode: "\u25BD", fallback: "v" },
+    left: { unicode: "\u25C0", fallback: "<" },
+    leftSmall: { unicode: "\u25C2", fallback: "<" },
+    leftOutline: { unicode: "\u25C1", fallback: "<" },
+    right: { unicode: "\u25B6", fallback: ">" },
+    rightSmall: { unicode: "\u25B8", fallback: ">" },
+    rightOutline: { unicode: "\u25B7", fallback: ">" }
+  },
+  special: {
+    star: { unicode: "\u2605", fallback: "*" },
+    starOutline: { unicode: "\u2606", fallback: "*" },
+    heart: { unicode: "\u2665", fallback: "<3" },
+    heartOutline: { unicode: "\u2661", fallback: "<3" },
+    flag: { unicode: "\u2691", fallback: "[F]" },
+    flagOutline: { unicode: "\u2690", fallback: "[f]" },
+    gear: { unicode: "\u2699", fallback: "[*]" }
+  },
+  directional: {
+    arrowUp: { unicode: "\u2191", fallback: "^" },
+    arrowDown: { unicode: "\u2193", fallback: "v" },
+    arrowLeft: { unicode: "\u2190", fallback: "<-" },
+    arrowRight: { unicode: "\u2192", fallback: "->" },
+    arrowLeftRight: { unicode: "\u2194", fallback: "<->" },
+    arrowUpDown: { unicode: "\u2195", fallback: "^v" }
+  },
+  math: {
+    almostEqual: { unicode: "\u2248", fallback: "~=" },
+    notEqual: { unicode: "\u2260", fallback: "!=" },
+    lessOrEqual: { unicode: "\u2264", fallback: "<=" },
+    greaterOrEqual: { unicode: "\u2265", fallback: ">=" },
+    identical: { unicode: "\u2261", fallback: "===" },
+    infinity: { unicode: "\u221E", fallback: "inf" }
+  }
+};
+function isUnicodeSupported() {
+  if (process.env["CI"]) {
+    return true;
+  }
+  if (process.env["WT_SESSION"]) {
+    return true;
+  }
+  if (process.env["ConEmuTask"]) {
+    return true;
+  }
+  const term = process.env["TERM"] ?? "";
+  if (term === "xterm-256color" || term === "xterm" || term.includes("256color") || term.includes("truecolor")) {
+    return true;
+  }
+  const lang = process.env["LANG"] ?? process.env["LC_ALL"] ?? "";
+  if (lang.toLowerCase().includes("utf-8") || lang.toLowerCase().includes("utf8")) {
+    return true;
+  }
+  if (process.platform !== "win32") {
+    return true;
+  }
+  return false;
+}
+function getIndicator(category, name, forceUnicode) {
+  const indicator = INDICATORS[category][name];
+  if (!indicator) {
+    return "";
+  }
+  const useUnicode = forceUnicode ?? isUnicodeSupported();
+  return useUnicode ? indicator.unicode : indicator.fallback;
+}
+var PROGRESS_SEQUENCES = {
+  circle: [
+    "circleEmpty",
+    "circleQuarter",
+    "circleHalf",
+    "circleThree",
+    "circleFull"
+  ],
+  vertical: [
+    "vertical1",
+    "vertical2",
+    "vertical3",
+    "vertical4",
+    "vertical5",
+    "vertical6",
+    "vertical7",
+    "verticalFull"
+  ],
+  horizontal: [
+    "horizontal1",
+    "horizontal2",
+    "horizontal3",
+    "horizontal4",
+    "horizontal5",
+    "horizontal6",
+    "horizontal7",
+    "horizontalFull"
+  ],
+  shade: ["shadeLight", "shadeMedium", "shadeDark"]
+};
+function getProgressIndicator(style, current, max, forceUnicode) {
+  const sequence = PROGRESS_SEQUENCES[style];
+  const steps = sequence.length;
+  const ratio = max <= 0 ? 0 : Math.max(0, Math.min(1, current / max));
+  const index = Math.round(ratio * (steps - 1));
+  const name = sequence[index];
+  if (name === undefined) {
+    return "";
+  }
+  return getIndicator("progress", name, forceUnicode);
+}
+
+export { INDICATORS, isUnicodeSupported, getIndicator, getProgressIndicator };

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-qj83y5wj.d.ts

@@ -0,0 +1,71 @@
+import { BorderStyle } from "./cli-fakncnjp";
+/**
+* Configuration options for {@link renderTable}.
+*
+* @example
+* ```typescript
+* const options: TableOptions = {
+*   headers: { id: "ID", name: "Name" },
+*   columnWidths: { description: 20 },
+*   border: "rounded",
+* };
+* ```
+*/
+interface TableOptions {
+	/**
+	* Fixed column widths by key.
+	* If not specified, column width is calculated from content.
+	*/
+	columnWidths?: Record<string, number>;
+	/**
+	* Custom header labels by key.
+	* 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 a table with Unicode box-drawing borders.
+*
+* Automatically calculates column widths based on content unless
+* 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
+* @returns Formatted table string with borders
+*
+* @example
+* ```typescript
+* const table = renderTable(
+*   [
+*     { id: 1, name: "Alice", status: "Active" },
+*     { id: 2, name: "Bob", status: "Inactive" },
+*   ],
+*   {
+*     headers: { id: "ID", name: "Name" },
+*     columnWidths: { status: 10 },
+*   }
+* );
+*
+* console.log(table);
+* // ┌────┬───────┬──────────┐
+* // │ ID │ Name  │ status   │
+* // ├────┼───────┼──────────┤
+* // │ 1  │ Alice │ Active   │
+* // │ 2  │ Bob   │ Inactive │
+* // └────┴───────┴──────────┘
+* ```
+*/
+declare function renderTable(data: Record<string, unknown>[], options?: TableOptions): string;
+export { TableOptions, renderTable };

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