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

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

@@ -0,0 +1,85 @@
+// @bun
+import {
+  ANSI,
+  init_colors
+} from "./cli-9nbyj2bt.js";
+import {
+  __esm
+} from "./cli-v1tzwxkt.js";
+
+// packages/cli/src/render/text.ts
+function stripAnsi(text) {
+  return text.replace(ANSI_REGEX, "");
+}
+function getStringWidth(text) {
+  return Bun.stringWidth(text);
+}
+function wrapText(text, width) {
+  return Bun.wrapAnsi(text, width);
+}
+function truncateText(text, maxWidth) {
+  const visibleWidth = getStringWidth(text);
+  if (visibleWidth <= maxWidth) {
+    return text;
+  }
+  const ellipsis = "...";
+  const ellipsisWidth = 3;
+  const targetWidth = maxWidth - ellipsisWidth;
+  if (targetWidth <= 0) {
+    return ellipsis.slice(0, maxWidth);
+  }
+  const stripped = stripAnsi(text);
+  let result = "";
+  let currentWidth = 0;
+  let textIndex = 0;
+  let fullIndex = 0;
+  while (currentWidth < targetWidth && textIndex < stripped.length) {
+    while (fullIndex < text.length && text[fullIndex] === "\x1B") {
+      const match = text.slice(fullIndex).match(/^\x1b\[[0-9;]*m/);
+      if (match) {
+        result += match[0];
+        fullIndex += match[0].length;
+      } else {
+        break;
+      }
+    }
+    if (fullIndex < text.length) {
+      const char = text[fullIndex];
+      if (char !== undefined) {
+        const charWidth = Bun.stringWidth(char);
+        if (currentWidth + charWidth <= targetWidth) {
+          result += char;
+          currentWidth += charWidth;
+          textIndex++;
+          fullIndex++;
+        } else {
+          break;
+        }
+      }
+    }
+  }
+  const hasAnsi = result.includes("\x1B[");
+  return result + (hasAnsi ? ANSI.reset : "") + ellipsis;
+}
+function padText(text, width) {
+  const visibleWidth = getStringWidth(text);
+  const paddingNeeded = width - visibleWidth;
+  if (paddingNeeded <= 0) {
+    return text;
+  }
+  return text + " ".repeat(paddingNeeded);
+}
+function pluralize(count, singular, plural) {
+  const word = count === 1 ? singular : plural ?? `${singular}s`;
+  return `${count} ${word}`;
+}
+function slugify(text) {
+  return text.toLowerCase().replace(/&/g, "and").replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "");
+}
+var ANSI_REGEX;
+var init_text = __esm(() => {
+  init_colors();
+  ANSI_REGEX = /\x1b\[[0-9;]*m/g;
+});
+
+export { ANSI_REGEX, stripAnsi, getStringWidth, wrapText, truncateText, padText, pluralize, slugify, init_text };

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

@@ -0,0 +1,267 @@
+// @bun
+// packages/cli/src/demo/registry.ts
+var THEME_METHOD_META = {
+  success: {
+    category: "semantic",
+    description: "Green for success messages",
+    defaultExample: "Operation completed"
+  },
+  warning: {
+    category: "semantic",
+    description: "Yellow for warnings",
+    defaultExample: "Proceed with caution"
+  },
+  error: {
+    category: "semantic",
+    description: "Red for errors",
+    defaultExample: "Something went wrong"
+  },
+  info: {
+    category: "semantic",
+    description: "Blue for information",
+    defaultExample: "For your information"
+  },
+  primary: {
+    category: "semantic",
+    description: "Default text (no color)",
+    defaultExample: "Main content"
+  },
+  secondary: {
+    category: "semantic",
+    description: "Gray for secondary text",
+    defaultExample: "Supporting text"
+  },
+  muted: {
+    category: "semantic",
+    description: "Dim for de-emphasized text",
+    defaultExample: "(optional)"
+  },
+  accent: {
+    category: "semantic",
+    description: "Cyan for highlights",
+    defaultExample: "Highlighted item"
+  },
+  highlight: {
+    category: "semantic",
+    description: "Bold for emphasis",
+    defaultExample: "Important"
+  },
+  link: {
+    category: "semantic",
+    description: "Cyan + underline for URLs",
+    defaultExample: "https://example.com"
+  },
+  destructive: {
+    category: "semantic",
+    description: "Bright red for dangerous actions",
+    defaultExample: "Delete forever"
+  },
+  subtle: {
+    category: "semantic",
+    description: "Dim gray for fine print",
+    defaultExample: "Fine print"
+  },
+  bold: {
+    category: "utility",
+    description: "Bold styling",
+    defaultExample: "Strong emphasis"
+  },
+  italic: {
+    category: "utility",
+    description: "Italic styling",
+    defaultExample: "Subtle emphasis"
+  },
+  underline: {
+    category: "utility",
+    description: "Underline styling",
+    defaultExample: "Underlined text"
+  },
+  dim: {
+    category: "utility",
+    description: "Dim styling",
+    defaultExample: "De-emphasized"
+  }
+};
+function getThemeMethodsByCategory() {
+  const semantic = [];
+  const utility = [];
+  for (const [key, meta] of Object.entries(THEME_METHOD_META)) {
+    if (meta.category === "semantic") {
+      semantic.push(key);
+    } else {
+      utility.push(key);
+    }
+  }
+  return { semantic, utility };
+}
+var BORDER_STYLE_META = {
+  single: {
+    value: "single",
+    label: "Single",
+    description: "Standard Unicode single-line borders (\u250C\u2500\u2510)"
+  },
+  double: {
+    value: "double",
+    label: "Double",
+    description: "Double-line borders (\u2554\u2550\u2557)"
+  },
+  rounded: {
+    value: "rounded",
+    label: "Rounded",
+    description: "Rounded corners with single lines (\u256D\u2500\u256E)"
+  },
+  heavy: {
+    value: "heavy",
+    label: "Heavy",
+    description: "Thick/heavy borders (\u250F\u2501\u2513)"
+  },
+  ascii: {
+    value: "ascii",
+    label: "ASCII",
+    description: "ASCII-only fallback (+, -, |)"
+  },
+  none: {
+    value: "none",
+    label: "None",
+    description: "No borders (empty strings)"
+  }
+};
+function getBorderStyles() {
+  return Object.keys(BORDER_STYLE_META);
+}
+var SPINNER_STYLE_META = {
+  dots: {
+    value: "dots",
+    label: "Dots",
+    description: "Braille dots animation (default, smooth)"
+  },
+  line: {
+    value: "line",
+    label: "Line",
+    description: "Classic ASCII spinner (-\\|/)"
+  },
+  arc: {
+    value: "arc",
+    label: "Arc",
+    description: "Corner arc rotation"
+  },
+  circle: {
+    value: "circle",
+    label: "Circle",
+    description: "Half-filled circle rotation"
+  },
+  bounce: {
+    value: "bounce",
+    label: "Bounce",
+    description: "Bouncing dot (vertical)"
+  },
+  ping: {
+    value: "ping",
+    label: "Ping",
+    description: "Bouncing dot in brackets (horizontal)"
+  }
+};
+function getSpinnerStyles() {
+  return Object.keys(SPINNER_STYLE_META);
+}
+var LIST_STYLE_META = {
+  dash: {
+    value: "dash",
+    label: "Dash",
+    description: "Uses - character (default)"
+  },
+  bullet: {
+    value: "bullet",
+    label: "Bullet",
+    description: "Uses \u2022 character"
+  },
+  number: {
+    value: "number",
+    label: "Number",
+    description: "Uses 1. for top-level, a. for nested, i. for deeply nested"
+  },
+  checkbox: {
+    value: "checkbox",
+    label: "Checkbox",
+    description: "Uses \u2610 for unchecked, \u2611 for checked"
+  }
+};
+function getListStyles() {
+  return Object.keys(LIST_STYLE_META);
+}
+var PRIMITIVE_META = {
+  colors: {
+    id: "colors",
+    name: "Colors",
+    description: "Semantic color theme with ANSI support",
+    importExample: 'import { createTheme } from "@outfitter/cli/render";'
+  },
+  borders: {
+    id: "borders",
+    name: "Borders",
+    description: "Box-drawing character sets",
+    importExample: 'import { BORDERS, getBorderCharacters } from "@outfitter/cli/render";'
+  },
+  spinner: {
+    id: "spinner",
+    name: "Spinner",
+    description: "Animated spinners for async operations",
+    importExample: 'import { renderSpinner, SPINNERS } from "@outfitter/cli/render";'
+  },
+  list: {
+    id: "list",
+    name: "List",
+    description: "Bullet, numbered, and checkbox lists",
+    importExample: 'import { renderList } from "@outfitter/cli/render";'
+  },
+  box: {
+    id: "box",
+    name: "Box",
+    description: "Bordered panels with optional titles",
+    importExample: 'import { renderBox } from "@outfitter/cli/render";'
+  },
+  table: {
+    id: "table",
+    name: "Table",
+    description: "Unicode tables with multiple border styles",
+    importExample: 'import { renderTable } from "@outfitter/cli/render";'
+  },
+  progress: {
+    id: "progress",
+    name: "Progress",
+    description: "Progress bars with filled/empty segments",
+    importExample: 'import { renderProgress } from "@outfitter/cli/render";'
+  },
+  tree: {
+    id: "tree",
+    name: "Tree",
+    description: "Hierarchical tree rendering",
+    importExample: 'import { renderTree } from "@outfitter/cli/render";'
+  },
+  text: {
+    id: "text",
+    name: "Text",
+    description: "Text utilities (width, wrap, truncate, pad)",
+    importExample: 'import { getStringWidth, wrapText, truncateText, padText } from "@outfitter/cli/render";'
+  },
+  markdown: {
+    id: "markdown",
+    name: "Markdown",
+    description: "Markdown to terminal ANSI rendering",
+    importExample: 'import { renderMarkdown } from "@outfitter/cli/render";'
+  },
+  indicators: {
+    id: "indicators",
+    name: "Indicators",
+    description: "Status symbols, selection markers, and progress indicators",
+    importExample: 'import { getIndicator, INDICATORS } from "@outfitter/cli/render";'
+  }
+};
+function getPrimitiveIds() {
+  return Object.keys(PRIMITIVE_META);
+}
+function getPrimitiveMeta(id) {
+  return PRIMITIVE_META[id];
+}
+
+export { THEME_METHOD_META, getThemeMethodsByCategory, BORDER_STYLE_META, getBorderStyles, SPINNER_STYLE_META, getSpinnerStyles, LIST_STYLE_META, getListStyles, PRIMITIVE_META, getPrimitiveIds, getPrimitiveMeta };

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

@@ -0,0 +1,7 @@
+// @bun
+import {
+  init_borders
+} from "./cli-85fg2vr5.js";
+
+// packages/cli/src/borders/index.ts
+init_borders();

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

@@ -0,0 +1,34 @@
+import { CLI, CLIConfig } from "./cli-ttt7r0j7";
+/**
+* Create a new CLI instance with the given configuration.
+*
+* The CLI wraps Commander.js with typed helpers, output contract enforcement,
+* and pagination state management.
+*
+* @param config - CLI configuration options
+* @returns A CLI instance ready for command registration
+*
+* @example
+* ```typescript
+* import { createCLI, command, output } from "@outfitter/cli";
+*
+* const cli = createCLI({
+*   name: "waymark",
+*   version: "1.0.0",
+*   description: "A note management CLI",
+* });
+*
+* cli.register(
+*   command("list")
+*     .description("List all notes")
+*     .action(async () => {
+*       const notes = await getNotes();
+*       output(notes);
+*     })
+* );
+*
+* await cli.parse();
+* ```
+*/
+declare function createCLI(config: CLIConfig): CLI;
+export { createCLI };

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

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

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

@@ -0,0 +1,26 @@
+import { VisualTheme } from "./cli-s0kkx9m1";
+/**
+* Minimal visual theme.
+*
+* Features:
+* - ASCII-only borders (+, -, |)
+* - ASCII-safe list bullets and checkboxes
+* - Line spinner (ASCII-compatible)
+* - No unicode characters anywhere
+*
+* Use this theme when targeting terminals without unicode support
+* or when running in CI/log environments.
+*
+* @example
+* ```typescript
+* import { minimalTheme } from "@outfitter/cli/theme/presets";
+*
+* // Use ASCII-safe styling
+* const box = renderBox("Hello", { border: minimalTheme.border });
+* // +-------+
+* // | Hello |
+* // +-------+
+* ```
+*/
+declare const minimalTheme: VisualTheme;
+export { minimalTheme };

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

@@ -0,0 +1,19 @@
+// @bun
+// packages/cli/src/prompt/validators.ts
+var validators = {
+  required: (message = "Required") => (value) => value.length > 0 ? undefined : message,
+  minLength: (length, message) => (value) => value.length >= length ? undefined : message ?? `Minimum ${length} characters`,
+  maxLength: (length, message) => (value) => value.length <= length ? undefined : message ?? `Maximum ${length} characters`,
+  pattern: (regex, message) => (value) => regex.test(value) ? undefined : message,
+  email: (message = "Invalid email") => validators.pattern(/^[^\s@]+@[^\s@]+\.[^\s@]+$/, message),
+  compose: (...fns) => (value) => {
+    for (const fn of fns) {
+      const error = fn(value);
+      if (error)
+        return error;
+    }
+    return;
+  }
+};
+
+export { validators };

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

@@ -0,0 +1,51 @@
+// @bun
+// packages/cli/src/render/spinner.ts
+var SPINNERS = {
+  dots: {
+    frames: ["\u280B", "\u2819", "\u2839", "\u2838", "\u283C", "\u2834", "\u2826", "\u2827", "\u2807", "\u280F"],
+    interval: 80
+  },
+  line: {
+    frames: ["-", "\\", "|", "/"],
+    interval: 100
+  },
+  arc: {
+    frames: ["\u25DC", "\u25DD", "\u25DE", "\u25DF"],
+    interval: 100
+  },
+  circle: {
+    frames: ["\u25D0", "\u25D3", "\u25D1", "\u25D2"],
+    interval: 100
+  },
+  bounce: {
+    frames: ["\u2801", "\u2802", "\u2804", "\u2802"],
+    interval: 120
+  },
+  ping: {
+    frames: [
+      "(\u25CF    )",
+      "( \u25CF   )",
+      "(  \u25CF  )",
+      "(   \u25CF )",
+      "(    \u25CF)",
+      "(   \u25CF )",
+      "(  \u25CF  )",
+      "( \u25CF   )"
+    ],
+    interval: 80
+  }
+};
+function getSpinnerFrame(style, elapsed) {
+  const spinner = SPINNERS[style];
+  const frameIndex = Math.floor(elapsed / spinner.interval) % spinner.frames.length;
+  return spinner.frames[frameIndex] ?? spinner.frames[0] ?? "...";
+}
+function renderSpinner(style, message) {
+  const frame = getSpinnerFrame(style, 0);
+  if (message && message.length > 0) {
+    return `${frame} ${message}`;
+  }
+  return frame;
+}
+
+export { SPINNERS, getSpinnerFrame, renderSpinner };

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

@@ -0,0 +1,128 @@
+// @bun
+import {
+  demoSection
+} from "./cli-34fqr7bp.js";
+import {
+  getStringWidth,
+  init_text,
+  padText,
+  pluralize,
+  slugify,
+  truncateText,
+  wrapText
+} from "./cli-jjemfdta.js";
+
+// packages/cli/src/demo/renderers/text.ts
+init_text();
+function renderTextDemo(config, theme) {
+  const showCode = config.showCode ?? true;
+  const lines = [];
+  lines.push(demoSection("String Width"));
+  lines.push("");
+  if (showCode) {
+    lines.push('import { getStringWidth } from "@outfitter/cli/render";');
+    lines.push("");
+  }
+  const widthExamples = [
+    { text: "Hello", expected: 5 },
+    { text: "\u4F60\u597D", expected: 4 },
+    { text: "\uD83C\uDF89", expected: 2 },
+    { text: "\x1B[32mGreen\x1B[0m", expected: 5 }
+  ];
+  for (const ex of widthExamples) {
+    const width = getStringWidth(ex.text);
+    const display = ex.text.includes("\x1B") ? '"\\x1b[32mGreen\\x1b[0m"' : `"${ex.text}"`;
+    lines.push(`getStringWidth(${display.padEnd(24)}) \u2192 ${width}`);
+  }
+  lines.push("");
+  lines.push(theme.muted("Correctly handles CJK, emoji, and ANSI codes."));
+  lines.push("");
+  lines.push(demoSection("Text Wrapping"));
+  lines.push("");
+  if (showCode) {
+    lines.push('import { wrapText } from "@outfitter/cli/render";');
+    lines.push("");
+  }
+  const longText = "This is a long sentence that should be wrapped at the specified width.";
+  if (showCode) {
+    lines.push(`wrapText("${longText}", 30)`);
+    lines.push("");
+  }
+  lines.push("Result:");
+  const wrapped = wrapText(longText, 30);
+  for (const line of wrapped.split(`
+`)) {
+    lines.push(`  \u2502${line}\u2502`);
+  }
+  lines.push("");
+  lines.push(demoSection("Truncation"));
+  lines.push("");
+  if (showCode) {
+    lines.push('import { truncateText } from "@outfitter/cli/render";');
+    lines.push("");
+  }
+  const truncExamples = [
+    { text: "Hello World", width: 8 },
+    { text: "Short", width: 10 },
+    { text: "Very long text that will be truncated", width: 15 }
+  ];
+  for (const ex of truncExamples) {
+    const result = truncateText(ex.text, ex.width);
+    lines.push(`truncateText("${ex.text}", ${ex.width})`);
+    lines.push(`  \u2192 "${result}"`);
+    lines.push("");
+  }
+  lines.push(demoSection("Padding"));
+  lines.push("");
+  if (showCode) {
+    lines.push('import { padText } from "@outfitter/cli/render";');
+    lines.push("");
+  }
+  const padExamples = ["Hi", "Hello", "Greetings"];
+  for (const text of padExamples) {
+    const padded = padText(text, 15);
+    lines.push(`padText("${text}", 15) \u2192 "${padded}"`);
+  }
+  lines.push("");
+  lines.push(demoSection("Pluralize"));
+  lines.push("");
+  if (showCode) {
+    lines.push('import { pluralize } from "@outfitter/cli/render";');
+    lines.push("");
+  }
+  const pluralExamples = [
+    { count: 0, word: "item" },
+    { count: 1, word: "item" },
+    { count: 5, word: "item" },
+    { count: 1, word: "child", plural: "children" },
+    { count: 3, word: "child", plural: "children" }
+  ];
+  for (const ex of pluralExamples) {
+    const result = pluralize(ex.count, ex.word, ex.plural);
+    const code = ex.plural ? `pluralize(${ex.count}, "${ex.word}", "${ex.plural}")` : `pluralize(${ex.count}, "${ex.word}")`;
+    lines.push(`${code.padEnd(40)} \u2192 "${result}"`);
+  }
+  lines.push("");
+  lines.push(demoSection("Slugify"));
+  lines.push("");
+  if (showCode) {
+    lines.push('import { slugify } from "@outfitter/cli/render";');
+    lines.push("");
+  }
+  const slugExamples = [
+    "Hello World!",
+    "This & That",
+    "  Multiple   Spaces  ",
+    "CamelCase"
+  ];
+  for (const text of slugExamples) {
+    const result = slugify(text);
+    lines.push(`slugify("${text}")`);
+    lines.push(`  \u2192 "${result}"`);
+    lines.push("");
+  }
+  return lines.join(`
+`);
+}
+
+export { renderTextDemo };