@outfitter/cli 0.1.0-rc.2 → 0.1.0

package/dist/shared/@outfitter/cli-7gnrb8cr.js

@@ -0,0 +1,214 @@
+// @bun
+import {
+  BORDER_STYLE_META,
+  getBorderStyles
+} from "./cli-kc84wmch.js";
+import {
+  getExample
+} from "./cli-xep6v2c0.js";
+import {
+  demoSection
+} from "./cli-34fqr7bp.js";
+import {
+  createBox,
+  init_box,
+  renderBox
+} from "./cli-vp88gxev.js";
+
+// packages/cli/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/cli/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/cli-7nm6edvh.d.ts

@@ -0,0 +1,17 @@
+import { ExampleTexts } from "./cli-qjfc3j11";
+/**
+* Default example texts used when no custom examples are provided.
+*
+* These defaults are generic enough to work for any CLI while still
+* being meaningful and demonstrative.
+*/
+declare const DEFAULT_EXAMPLES: ExampleTexts;
+/**
+* Resolves example text with custom overrides.
+*
+* @param key - The example text key
+* @param custom - Optional custom examples
+* @returns The example text (custom if provided, default otherwise)
+*/
+declare function getExample<K extends keyof ExampleTexts>(key: K, custom?: Partial<ExampleTexts>): ExampleTexts[K];
+export { DEFAULT_EXAMPLES, getExample };

package/dist/shared/@outfitter/cli-85fg2vr5.js

@@ -0,0 +1,123 @@
+// @bun
+import {
+  __esm
+} from "./cli-v1tzwxkt.js";
+
+// packages/cli/src/render/borders.ts
+function getBorderCharacters(style) {
+  return BORDERS[style];
+}
+function drawHorizontalLine(width, chars, position, columnWidths) {
+  if (!chars.horizontal) {
+    return "";
+  }
+  const positionChars = {
+    top: { left: chars.topLeft, right: chars.topRight, cross: chars.topT },
+    middle: { left: chars.leftT, right: chars.rightT, cross: chars.cross },
+    bottom: {
+      left: chars.bottomLeft,
+      right: chars.bottomRight,
+      cross: chars.bottomT
+    }
+  };
+  const { left, right, cross: intersection } = positionChars[position];
+  if (!columnWidths || columnWidths.length <= 1) {
+    return `${left}${chars.horizontal.repeat(width)}${right}`;
+  }
+  const columnsWidth = columnWidths.reduce((sum, w) => sum + w, 0);
+  const intersectionsWidth = columnWidths.length - 1;
+  const actualWidth = columnsWidth + intersectionsWidth;
+  const adjustedWidths = [...columnWidths];
+  if (actualWidth !== width && adjustedWidths.length > 0) {
+    const lastIndex = adjustedWidths.length - 1;
+    const lastWidth = adjustedWidths[lastIndex] ?? 0;
+    adjustedWidths[lastIndex] = Math.max(0, lastWidth + (width - actualWidth));
+  }
+  const segments = adjustedWidths.map((colWidth) => chars.horizontal.repeat(colWidth));
+  return `${left}${segments.join(intersection)}${right}`;
+}
+var BORDERS;
+var init_borders = __esm(() => {
+  BORDERS = {
+    single: {
+      topLeft: "\u250C",
+      topRight: "\u2510",
+      bottomLeft: "\u2514",
+      bottomRight: "\u2518",
+      horizontal: "\u2500",
+      vertical: "\u2502",
+      topT: "\u252C",
+      bottomT: "\u2534",
+      leftT: "\u251C",
+      rightT: "\u2524",
+      cross: "\u253C"
+    },
+    double: {
+      topLeft: "\u2554",
+      topRight: "\u2557",
+      bottomLeft: "\u255A",
+      bottomRight: "\u255D",
+      horizontal: "\u2550",
+      vertical: "\u2551",
+      topT: "\u2566",
+      bottomT: "\u2569",
+      leftT: "\u2560",
+      rightT: "\u2563",
+      cross: "\u256C"
+    },
+    rounded: {
+      topLeft: "\u256D",
+      topRight: "\u256E",
+      bottomLeft: "\u2570",
+      bottomRight: "\u256F",
+      horizontal: "\u2500",
+      vertical: "\u2502",
+      topT: "\u252C",
+      bottomT: "\u2534",
+      leftT: "\u251C",
+      rightT: "\u2524",
+      cross: "\u253C"
+    },
+    heavy: {
+      topLeft: "\u250F",
+      topRight: "\u2513",
+      bottomLeft: "\u2517",
+      bottomRight: "\u251B",
+      horizontal: "\u2501",
+      vertical: "\u2503",
+      topT: "\u2533",
+      bottomT: "\u253B",
+      leftT: "\u2523",
+      rightT: "\u252B",
+      cross: "\u254B"
+    },
+    ascii: {
+      topLeft: "+",
+      topRight: "+",
+      bottomLeft: "+",
+      bottomRight: "+",
+      horizontal: "-",
+      vertical: "|",
+      topT: "+",
+      bottomT: "+",
+      leftT: "+",
+      rightT: "+",
+      cross: "+"
+    },
+    none: {
+      topLeft: "",
+      topRight: "",
+      bottomLeft: "",
+      bottomRight: "",
+      horizontal: "",
+      vertical: "",
+      topT: "",
+      bottomT: "",
+      leftT: "",
+      rightT: "",
+      cross: ""
+    }
+  };
+});
+
+export { BORDERS, getBorderCharacters, drawHorizontalLine, init_borders };

package/dist/shared/@outfitter/cli-8a8xrzhy.js

@@ -0,0 +1,20 @@
+// @bun
+import {
+  defaultTheme
+} from "./cli-cs45xd6q.js";
+import {
+  BORDERS,
+  init_borders
+} from "./cli-85fg2vr5.js";
+
+// packages/cli/src/theme/presets/bold.ts
+init_borders();
+var boldTheme = {
+  ...defaultTheme,
+  name: "bold",
+  border: "heavy",
+  borderChars: BORDERS.heavy,
+  treeGuide: "heavy"
+};
+
+export { boldTheme };

package/dist/shared/@outfitter/cli-8bwaw3pz.js

@@ -0,0 +1,7 @@
+// @bun
+// packages/cli/src/prompt/types.ts
+function createCancelledError(message = "User cancelled") {
+  return { type: "cancelled", message };
+}
+
+export { createCancelledError };

package/dist/shared/@outfitter/cli-8rx4g3s5.d.ts

@@ -0,0 +1,41 @@
+import { PasswordPromptOptions, PromptResult, TextPromptOptions } from "./cli-3f12z5kf";
+/**
+* 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/cli/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/cli/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/cli-8xsmsbbd.d.ts

@@ -0,0 +1,223 @@
+import { BorderStyle } from "./cli-fakncnjp";
+/**
+* Text alignment options for box content.
+*/
+type BoxAlign = "left" | "center" | "right";
+/**
+* Options for customizing box rendering.
+*
+* @example
+* ```typescript
+* // Box with title and rounded corners
+* renderBox("Content", {
+*   title: "Status",
+*   border: "rounded",
+*   padding: 1,
+* });
+*
+* // Fixed-width centered box
+* renderBox("Centered", {
+*   width: 40,
+*   align: "center",
+* });
+* ```
+*/
+/**
+* Spacing configuration for individual sides.
+*/
+interface BoxSpacing {
+	top?: number;
+	right?: number;
+	bottom?: number;
+	left?: number;
+}
+/**
+* Border visibility configuration for individual sides.
+*/
+interface BoxBorders {
+	top?: boolean;
+	right?: boolean;
+	bottom?: boolean;
+	left?: boolean;
+}
+interface BoxOptions {
+	/**
+	* Border style to use.
+	* @default "single"
+	*/
+	border?: BorderStyle;
+	/**
+	* Control which borders to render.
+	* @default { top: true, right: true, bottom: true, left: true }
+	*/
+	borders?: BoxBorders;
+	/**
+	* Internal padding (spaces between border and content).
+	* Can be a single number for all sides or an object for individual sides.
+	* @default 1
+	*/
+	padding?: number | BoxSpacing;
+	/**
+	* External margin (spacing outside the box).
+	* Can be a single number for all sides or an object for individual sides.
+	*/
+	margin?: number | BoxSpacing;
+	/**
+	* Fixed width for the box. If not specified, auto-fits to content.
+	*/
+	width?: number;
+	/**
+	* Optional title to display in the top border.
+	*/
+	title?: string;
+	/**
+	* Content alignment within the box.
+	* @default "left"
+	*/
+	align?: BoxAlign;
+	/**
+	* Content sections separated by internal dividers.
+	* Each section can be a string or string[].
+	* When provided, takes precedence over the content parameter.
+	*
+	* @example
+	* ```typescript
+	* renderBox("", {
+	*   sections: [
+	*     "Header",
+	*     ["Line 1", "Line 2"],
+	*     "Footer"
+	*   ],
+	*   border: "single"
+	* });
+	* // ┌─────────────────┐
+	* // │ Header          │
+	* // ├─────────────────┤
+	* // │ Line 1          │
+	* // │ Line 2          │
+	* // ├─────────────────┤
+	* // │ Footer          │
+	* // └─────────────────┘
+	* ```
+	*/
+	sections?: Array<string | string[]>;
+}
+/**
+* A rendered box with metadata for composition.
+*/
+interface Box {
+	/** Rendered string representation */
+	readonly output: string;
+	/** Width in characters */
+	readonly width: number;
+	/** Height in lines */
+	readonly height: number;
+}
+/**
+* Content that can be rendered inside a box.
+* - string: Plain text content
+* - string[]: Multi-line content
+* - Box: Nested box (rendered string with metadata)
+*/
+type BoxContent = string | string[] | Box;
+/**
+* Normalized spacing with all four sides defined.
+*/
+interface NormalizedSpacing {
+	top: number;
+	right: number;
+	bottom: number;
+	left: number;
+}
+/**
+* Normalized borders with all four sides defined.
+*/
+interface NormalizedBorders {
+	top: boolean;
+	right: boolean;
+	bottom: boolean;
+	left: boolean;
+}
+/**
+* Normalizes padding input to have all four sides.
+* For backward compatibility, when padding is a number it only applies to horizontal (left/right).
+* When padding is an object, all sides can be specified.
+*/
+declare function normalizePadding(padding: number | BoxSpacing | undefined, defaultValue: number): NormalizedSpacing;
+/**
+* Normalizes margin input to have all four sides.
+* When margin is a number, it applies to all sides.
+*/
+declare function normalizeMargin(margin: number | BoxSpacing | undefined, defaultValue: number): NormalizedSpacing;
+/**
+* Normalizes borders input to have all four sides.
+*/
+declare function normalizeBorders(borders: BoxBorders | undefined): NormalizedBorders;
+/**
+* Renders content within a bordered panel.
+*
+* Creates a box with Unicode borders around the content. Supports multiple
+* border styles, titles, padding, and alignment options.
+*
+* @param content - The content to render (string or array of strings)
+* @param options - Optional configuration for border style, padding, etc.
+* @returns Formatted box string
+*
+* @example
+* ```typescript
+* // Simple box
+* console.log(renderBox("Hello, world!"));
+* // ┌───────────────┐
+* // │ Hello, world! │
+* // └───────────────┘
+*
+* // Box with title
+* console.log(renderBox("All systems go", { title: "Status" }));
+* // ┌─ Status ──────┐
+* // │ All systems go │
+* // └────────────────┘
+*
+* // Rounded box with padding
+* console.log(renderBox(["Line 1", "Line 2"], {
+*   border: "rounded",
+*   padding: 2,
+* }));
+* // ╭──────────────╮
+* // │              │
+* // │  Line 1      │
+* // │  Line 2      │
+* // │              │
+* // ╰──────────────╯
+* ```
+*/
+declare function renderBox(content: string | string[], options?: BoxOptions): string;
+/**
+* Creates a Box object that can be composed with other boxes.
+*
+* Unlike `renderBox` which returns a string, `createBox` returns a Box object
+* with metadata (width, height) that enables nested composition.
+*
+* @param content - The content to render (string, string[], Box, or array of mixed)
+* @param options - Optional configuration for border style, padding, etc.
+* @returns Box object with output, width, and height
+*
+* @example
+* ```typescript
+* // Simple box
+* const box = createBox("Hello");
+* console.log(box.output);
+* console.log(`Width: ${box.width}, Height: ${box.height}`);
+*
+* // Nested boxes
+* const inner = createBox("Inner", { border: "rounded" });
+* const outer = createBox(inner, { border: "double", title: "Container" });
+* console.log(outer.output);
+* // ╔═ Container ═══════════════╗
+* // ║ ╭───────────────────────╮ ║
+* // ║ │ Inner                 │ ║
+* // ║ ╰───────────────────────╯ ║
+* // ╚═══════════════════════════╝
+* ```
+*/
+declare function createBox(content: BoxContent | BoxContent[], options?: BoxOptions): Box;
+export { BoxAlign, BoxSpacing, BoxBorders, BoxOptions, Box, BoxContent, NormalizedSpacing, NormalizedBorders, normalizePadding, normalizeMargin, normalizeBorders, renderBox, createBox };