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

package/dist/render/stack.d.ts

@@ -0,0 +1,3 @@
+import { BoxifyOptions, DEFAULT_STACK_THEME, DELIMITERS, DelimiterName, DelimiterSet, HStackOptions, ItemState, MarkerName, Renderable, StackBox, StackInput, StackItem, StackTheme, VStackMode, VStackOptions, boxify, createHStack, createVStack, getDelimiter, getMarker, hstack, isRenderable, unbox, vstack, vstackItem } from "../shared/@outfitter/cli-hnpbqmc8";
+import "../shared/@outfitter/cli-3b7ed3rm";
+export { vstackItem, vstack, unbox, isRenderable, hstack, getMarker, getDelimiter, createVStack, createHStack, boxify, VStackOptions, VStackMode, StackTheme, StackItem, StackInput, StackBox, Renderable, MarkerName, ItemState, HStackOptions, DelimiterSet, DelimiterName, DELIMITERS, DEFAULT_STACK_THEME, BoxifyOptions };

package/dist/render/stack.js

@@ -0,0 +1,38 @@
+// @bun
+import {
+  DEFAULT_STACK_THEME,
+  DELIMITERS,
+  boxify,
+  createHStack,
+  createVStack,
+  getDelimiter,
+  getMarker,
+  hstack,
+  isRenderable,
+  unbox,
+  vstack,
+  vstackItem
+} from "../shared/@outfitter/cli-1bghjef6.js";
+import"../shared/@outfitter/cli-b5c2k0d7.js";
+import"../shared/@outfitter/cli-p1m5dhrs.js";
+import"../shared/@outfitter/cli-671sxkhj.js";
+import"../shared/@outfitter/cli-vp88gxev.js";
+import"../shared/@outfitter/cli-jjemfdta.js";
+import"../shared/@outfitter/cli-85fg2vr5.js";
+import"../shared/@outfitter/cli-9nbyj2bt.js";
+import"../shared/@outfitter/cli-d9ad0rqj.js";
+import"../shared/@outfitter/cli-v1tzwxkt.js";
+export {
+  vstackItem,
+  vstack,
+  unbox,
+  isRenderable,
+  hstack,
+  getMarker,
+  getDelimiter,
+  createVStack,
+  createHStack,
+  boxify,
+  DELIMITERS,
+  DEFAULT_STACK_THEME
+};

package/dist/render/table.d.ts

@@ -0,0 +1,3 @@
+import { TableOptions, renderTable } from "../shared/@outfitter/cli-qj83y5wj";
+import "../shared/@outfitter/cli-fakncnjp";
+export { renderTable, TableOptions };

package/dist/render/table.js

@@ -0,0 +1,12 @@
+// @bun
+import {
+  renderTable
+} from "../shared/@outfitter/cli-an9j0h80.js";
+import"../shared/@outfitter/cli-jjemfdta.js";
+import"../shared/@outfitter/cli-85fg2vr5.js";
+import"../shared/@outfitter/cli-9nbyj2bt.js";
+import"../shared/@outfitter/cli-d9ad0rqj.js";
+import"../shared/@outfitter/cli-v1tzwxkt.js";
+export {
+  renderTable
+};

package/dist/render/text.d.ts

@@ -0,0 +1,2 @@
+import { ANSI_REGEX, getStringWidth, padText, pluralize, slugify, stripAnsi, truncateText, wrapText } from "../shared/@outfitter/cli-4cb5g831";
+export { wrapText, truncateText, stripAnsi, slugify, pluralize, padText, getStringWidth, ANSI_REGEX };

package/dist/render/text.js

@@ -0,0 +1,27 @@
+// @bun
+import {
+  ANSI_REGEX,
+  getStringWidth,
+  init_text,
+  padText,
+  pluralize,
+  slugify,
+  stripAnsi,
+  truncateText,
+  wrapText
+} from "../shared/@outfitter/cli-jjemfdta.js";
+import"../shared/@outfitter/cli-9nbyj2bt.js";
+import"../shared/@outfitter/cli-d9ad0rqj.js";
+import"../shared/@outfitter/cli-v1tzwxkt.js";
+init_text();
+
+export {
+  wrapText,
+  truncateText,
+  stripAnsi,
+  slugify,
+  pluralize,
+  padText,
+  getStringWidth,
+  ANSI_REGEX
+};

package/dist/render/tree.d.ts

@@ -0,0 +1,2 @@
+import { TREE_GUIDES, TreeGuideStyle, TreeOptions, renderTree } from "../shared/@outfitter/cli-3b7ed3rm";
+export { renderTree, TreeOptions, TreeGuideStyle, TREE_GUIDES };

package/dist/render/tree.js

@@ -0,0 +1,10 @@
+// @bun
+import {
+  TREE_GUIDES,
+  renderTree
+} from "../shared/@outfitter/cli-b5c2k0d7.js";
+import"../shared/@outfitter/cli-v1tzwxkt.js";
+export {
+  renderTree,
+  TREE_GUIDES
+};

package/dist/render/types.d.ts

@@ -0,0 +1,2 @@
+import { LayoutContext, WidthMode } from "../shared/@outfitter/cli-2g8bx1aq";
+export { WidthMode, LayoutContext };

package/dist/render/types.js

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

package/dist/shared/@outfitter/cli-0ggcy7fa.js

@@ -0,0 +1,20 @@
+// @bun
+import {
+  getIndicator,
+  isUnicodeSupported
+} from "./cli-p1m5dhrs.js";
+
+// packages/cli/src/theme/resolve.ts
+function resolveGlyph(glyph, forceUnicode) {
+  const useUnicode = forceUnicode ?? isUnicodeSupported();
+  return useUnicode ? glyph.unicode : glyph.fallback;
+}
+function resolveStateMarker(theme, state, forceUnicode) {
+  const markerSpec = theme.markers[state] ?? theme.markers.default;
+  if (markerSpec.type === "indicator") {
+    return getIndicator(markerSpec.category, markerSpec.name, forceUnicode);
+  }
+  return resolveGlyph(markerSpec.glyph, forceUnicode);
+}
+
+export { resolveGlyph, resolveStateMarker };

package/dist/shared/@outfitter/cli-0psys2vm.js

@@ -0,0 +1,7 @@
+// @bun
+import {
+  init_colors
+} from "./cli-9nbyj2bt.js";
+
+// packages/cli/src/colors/index.ts
+init_colors();

package/dist/shared/@outfitter/cli-1bghjef6.js

@@ -0,0 +1,352 @@
+// @bun
+import {
+  TREE_GUIDES
+} from "./cli-b5c2k0d7.js";
+import {
+  getIndicator,
+  isUnicodeSupported
+} from "./cli-p1m5dhrs.js";
+import {
+  joinHorizontal,
+  joinVertical
+} from "./cli-671sxkhj.js";
+import {
+  exports_box,
+  init_box,
+  renderBox
+} from "./cli-vp88gxev.js";
+import {
+  getStringWidth,
+  init_text
+} from "./cli-jjemfdta.js";
+import {
+  __toCommonJS
+} from "./cli-v1tzwxkt.js";
+
+// packages/cli/src/render/stack.ts
+init_box();
+init_text();
+var DELIMITERS = {
+  space: { unicode: " ", fallback: " " },
+  bullet: { unicode: "\u2022", fallback: "*" },
+  dot: { unicode: "\xB7", fallback: "." },
+  pipe: { unicode: "\u2502", fallback: "|" },
+  arrow: { unicode: "\u2192", fallback: "->" },
+  slash: { unicode: "/", fallback: "/" },
+  colon: { unicode: ":", fallback: ":" }
+};
+function getDelimiter(name, forceUnicode) {
+  const delimiter = DELIMITERS[name];
+  const useUnicode = forceUnicode ?? isUnicodeSupported();
+  return useUnicode ? delimiter.unicode : delimiter.fallback;
+}
+function getMarker(nameOrChar, forceUnicode) {
+  const knownMarkers = [
+    "circleDot",
+    "circleOutline",
+    "circle",
+    "checkbox",
+    "checkboxChecked",
+    "pointer",
+    "dash"
+  ];
+  if (knownMarkers.includes(nameOrChar)) {
+    return getIndicator("marker", nameOrChar, forceUnicode);
+  }
+  return nameOrChar;
+}
+var DEFAULT_STACK_THEME = {
+  markers: {
+    default: "circleOutline",
+    current: "circleDot",
+    focused: "pointer",
+    checked: "checkboxChecked",
+    disabled: "dash"
+  },
+  delimiter: "bullet",
+  guide: "single"
+};
+function isRenderable(value) {
+  return typeof value === "object" && value !== null && "output" in value && "width" in value && "height" in value && typeof value.output === "string" && typeof value.width === "number" && typeof value.height === "number";
+}
+function isDelimiterName(value) {
+  return value in DELIMITERS;
+}
+function resolveDelimiter(delimiter) {
+  if (delimiter === undefined) {
+    return getDelimiter("space");
+  }
+  if (isDelimiterName(delimiter)) {
+    return getDelimiter(delimiter);
+  }
+  return delimiter;
+}
+function normalizeItem(item) {
+  if (typeof item === "string") {
+    return { content: item };
+  }
+  if (isRenderable(item)) {
+    return { content: item.output };
+  }
+  return item;
+}
+function shouldShowMarker(item) {
+  return item.state !== undefined || item.marker !== undefined;
+}
+function resolveMarker(item, theme) {
+  if (!shouldShowMarker(item)) {
+    return { marker: "", show: false };
+  }
+  if (item.marker !== undefined) {
+    return { marker: getMarker(item.marker), show: true };
+  }
+  const state = item.state ?? "default";
+  const markerName = theme.markers[state];
+  return { marker: getMarker(markerName), show: true };
+}
+function getContentLines(content) {
+  if (typeof content === "string") {
+    return content.split(`
+`);
+  }
+  return content;
+}
+function applyStyle(content, style) {
+  return style ? style(content) : content;
+}
+function hstack(items, options) {
+  if (items.length === 0)
+    return "";
+  const normalizedItems = items.map(normalizeItem);
+  const delimiter = resolveDelimiter(options?.delimiter);
+  const gap = options?.gap ?? 0;
+  const align = options?.align ?? "top";
+  const gapStr = " ".repeat(gap);
+  const fullDelimiter = `${gapStr}${delimiter}${gapStr}`;
+  const contentStrings = normalizedItems.map((item) => {
+    const lines = getContentLines(item.content);
+    const styledLines = lines.map((line) => applyStyle(line, item.style));
+    return styledLines.join(`
+`);
+  });
+  const isMultiLine = contentStrings.some((s) => s.includes(`
+`));
+  if (!isMultiLine) {
+    return contentStrings.join(fullDelimiter);
+  }
+  const blocks = contentStrings.map((content, idx) => {
+    if (idx === contentStrings.length - 1) {
+      return content;
+    }
+    const lines = content.split(`
+`);
+    return lines.map((line) => line + fullDelimiter).join(`
+`);
+  });
+  return joinHorizontal(blocks, { gap: 0, align });
+}
+function createHStack(items, options) {
+  const output = hstack(items, options);
+  const lines = output.split(`
+`);
+  const width = Math.max(...lines.map(getStringWidth));
+  return {
+    output,
+    width,
+    height: lines.length
+  };
+}
+function vstackItem(header, body, options) {
+  const content = body && body.length > 0 ? [header, ...body] : [header];
+  const result = {
+    content,
+    state: options?.state ?? "default"
+  };
+  if (options?.marker !== undefined) {
+    result.marker = options.marker;
+  }
+  if (options?.compact !== undefined) {
+    result.compact = options.compact;
+  }
+  if (options?.style !== undefined) {
+    result.style = options.style;
+  }
+  return result;
+}
+var GUIDE_CHARS = {
+  single: "\u2502",
+  heavy: "\u2503",
+  double: "\u2551",
+  rounded: "\u2502"
+};
+function renderPlainMode(items, theme, gap) {
+  const lines = [];
+  for (const item of items) {
+    const { marker, show } = resolveMarker(item, theme);
+    const contentLines = getContentLines(item.content);
+    const prefix = show ? `${marker} ` : "";
+    const firstLine = contentLines[0];
+    if (firstLine !== undefined) {
+      const styled = applyStyle(firstLine, item.style);
+      lines.push(`${prefix}${styled}`);
+    }
+    const indent = show ? "  " : "";
+    for (let i = 1;i < contentLines.length; i++) {
+      const line = contentLines[i];
+      if (line !== undefined) {
+        const styled = applyStyle(line, item.style);
+        lines.push(`${indent}${styled}`);
+      }
+    }
+  }
+  return joinVertical(lines, { gap });
+}
+function renderGuideMode(items, theme, guideStyle) {
+  const lines = [];
+  const guideChar = GUIDE_CHARS[guideStyle];
+  for (let itemIdx = 0;itemIdx < items.length; itemIdx++) {
+    const item = items[itemIdx];
+    if (!item)
+      continue;
+    const { marker, show } = resolveMarker(item, theme);
+    const contentLines = getContentLines(item.content);
+    const isLastItem = itemIdx === items.length - 1;
+    const displayMarker = show ? marker : getMarker(theme.markers.default);
+    const firstLine = contentLines[0];
+    if (firstLine !== undefined) {
+      const styled = applyStyle(firstLine, item.style);
+      lines.push(`${displayMarker} ${styled}`);
+    }
+    for (let i = 1;i < contentLines.length; i++) {
+      const line = contentLines[i];
+      if (line !== undefined) {
+        const styled = applyStyle(line, item.style);
+        lines.push(`${guideChar} ${styled}`);
+      }
+    }
+    if (!isLastItem) {
+      lines.push(guideChar);
+    }
+  }
+  return lines.join(`
+`);
+}
+function renderTreeMode(items, guideStyle) {
+  const lines = [];
+  const guides = TREE_GUIDES[guideStyle];
+  for (let itemIdx = 0;itemIdx < items.length; itemIdx++) {
+    const item = items[itemIdx];
+    if (!item)
+      continue;
+    const contentLines = getContentLines(item.content);
+    const isLastItem = itemIdx === items.length - 1;
+    const connector = isLastItem ? guides.end : guides.fork;
+    const continuation = isLastItem ? "    " : guides.vertical;
+    const firstLine = contentLines[0];
+    if (firstLine !== undefined) {
+      const styled = applyStyle(firstLine, item.style);
+      lines.push(`${connector}${styled}`);
+    }
+    for (let i = 1;i < contentLines.length; i++) {
+      const line = contentLines[i];
+      if (line !== undefined) {
+        const styled = applyStyle(line, item.style);
+        lines.push(`${continuation}${styled}`);
+      }
+    }
+  }
+  return lines.join(`
+`);
+}
+function renderBoxedMode(items, gap) {
+  const boxes = [];
+  for (const item of items) {
+    const contentLines = getContentLines(item.content);
+    const styled = contentLines.map((line) => applyStyle(line, item.style));
+    boxes.push(renderBox(styled));
+  }
+  return joinVertical(boxes, { gap });
+}
+function renderCompactMode(items, theme) {
+  const lines = [];
+  for (const item of items) {
+    const { marker, show } = resolveMarker(item, theme);
+    const displayMarker = show ? marker : getMarker(theme.markers.default);
+    let displayText;
+    if (item.compact) {
+      displayText = item.compact;
+    } else {
+      const contentLines = getContentLines(item.content);
+      displayText = contentLines[0] ?? "";
+    }
+    const styled = applyStyle(displayText, item.style);
+    lines.push(`${displayMarker} ${styled}`);
+  }
+  return lines.join(`
+`);
+}
+function vstack(items, options) {
+  if (items.length === 0)
+    return "";
+  const normalizedItems = items.map(normalizeItem);
+  const mode = options?.mode ?? "guide";
+  const gap = options?.gap ?? 0;
+  const theme = {
+    ...DEFAULT_STACK_THEME,
+    ...options?.theme,
+    markers: {
+      ...DEFAULT_STACK_THEME.markers,
+      ...options?.theme?.markers
+    }
+  };
+  const guideStyle = options?.guide ?? theme.guide ?? "single";
+  switch (mode) {
+    case "plain":
+      return renderPlainMode(normalizedItems, theme, gap);
+    case "guide":
+      return renderGuideMode(normalizedItems, theme, guideStyle);
+    case "tree":
+      return renderTreeMode(normalizedItems, guideStyle);
+    case "boxed":
+      return renderBoxedMode(normalizedItems, gap);
+    case "compact":
+      return renderCompactMode(normalizedItems, theme);
+    default: {
+      const _exhaustive = mode;
+      return _exhaustive;
+    }
+  }
+}
+function createVStack(items, options) {
+  const output = vstack(items, options);
+  const lines = output.split(`
+`);
+  const width = Math.max(...lines.map(getStringWidth), 0);
+  return {
+    output,
+    width,
+    height: lines.length
+  };
+}
+function boxify(content, options) {
+  const { createBox: makeBox } = (init_box(), __toCommonJS(exports_box));
+  const boxContent = isRenderable(content) ? content.output : content;
+  const boxOptions = {
+    border: options?.border ?? "single"
+  };
+  if (options?.title !== undefined) {
+    boxOptions.title = options.title;
+  }
+  if (options?.padding !== undefined) {
+    boxOptions.padding = options.padding;
+  }
+  return makeBox(boxContent, boxOptions);
+}
+function unbox(content) {
+  if (isRenderable(content)) {
+    return content.output;
+  }
+  return content;
+}
+
+export { DELIMITERS, getDelimiter, getMarker, DEFAULT_STACK_THEME, isRenderable, hstack, createHStack, vstackItem, vstack, createVStack, boxify, unbox };

package/dist/shared/@outfitter/cli-1kwbnt86.d.ts

@@ -0,0 +1,45 @@
+import { WidthMode } from "./cli-2g8bx1aq";
+/**
+* Width mode for separators.
+*
+* Separators only support "text", "full", and numeric widths.
+* Container-relative modes require context, which separators don't use.
+*/
+type SeparatorWidthMode = Extract<WidthMode, "text" | "full" | number>;
+/**
+* Separator style for dividers.
+* Single characters repeat to fill width.
+* Two-character patterns (like "- ") alternate to create dashed effect.
+*/
+type DividerStyle = "─" | "━" | "═" | "- " | "· ";
+/**
+* Options for rendering a separator.
+*/
+interface SeparatorOptions {
+	/** Separator style (default: "─") */
+	style?: DividerStyle;
+	/** Width mode (default: 40) */
+	width?: SeparatorWidthMode;
+}
+/**
+* Renders a horizontal separator line.
+*
+* @param options - Rendering options
+* @returns Formatted separator string
+*
+* @example
+* ```typescript
+* import { renderSeparator } from "@outfitter/cli/render";
+*
+* console.log(renderSeparator());
+* // ────────────────────────────────────────
+*
+* console.log(renderSeparator({ style: "━", width: 20 }));
+* // ━━━━━━━━━━━━━━━━━━━━
+*
+* console.log(renderSeparator({ style: "- ", width: 20 }));
+* // - - - - - - - - - -
+* ```
+*/
+declare function renderSeparator(options?: SeparatorOptions): string;
+export { DividerStyle, SeparatorOptions, renderSeparator };

package/dist/shared/@outfitter/cli-2g8bx1aq.d.ts

@@ -0,0 +1,50 @@
+/**
+* Shared types for render utilities.
+*
+* @packageDocumentation
+*/
+/**
+* Width mode for layout calculations.
+*
+* - `"text"` - Fit to text content (returns 0 to indicate no width constraint)
+* - `"full"` - Full terminal width
+* - `"container"` - Available container width (requires LayoutContext)
+* - `number` - Fixed character width
+* - `"${number}%"` - Percentage of container/terminal width
+*
+* @example
+* ```typescript
+* import { resolveWidth } from "@outfitter/cli/render";
+*
+* resolveWidth("full");        // → terminal width (e.g., 120)
+* resolveWidth(50);            // → 50
+* resolveWidth("50%");         // → half of terminal width
+* resolveWidth("container", ctx);  // → context width
+* ```
+*/
+type WidthMode = "text" | "full" | "container" | number | `${number}%`;
+/**
+* Layout context for container-aware width calculations.
+*
+* Provides width information to nested components so they can size
+* themselves relative to their container. Create contexts with
+* `createLayoutContext()` and pass them through component hierarchies.
+*
+* @example
+* ```typescript
+* import { createLayoutContext, resolveWidth } from "@outfitter/cli/render";
+*
+* const outerCtx = createLayoutContext({ width: 80, padding: 1 });
+* // outerCtx.width = 76 (80 - 4 overhead)
+*
+* const innerWidth = resolveWidth("50%", outerCtx);
+* // innerWidth = 38 (50% of 76)
+* ```
+*/
+interface LayoutContext {
+	/** Available content width in characters */
+	readonly width: number;
+	/** Parent context for chained calculations */
+	readonly parent?: LayoutContext;
+}
+export { WidthMode, LayoutContext };

package/dist/shared/@outfitter/cli-33e97cjs.d.ts

@@ -0,0 +1,42 @@
+/**
+* JSON and text rendering utilities.
+*
+* Simple renderers for JSON and plain text output.
+*
+* @packageDocumentation
+*/
+/**
+* Renders data as pretty-printed JSON.
+*
+* Uses `JSON.stringify` with 2-space indentation.
+* Suitable for displaying structured data in terminal output.
+*
+* @param data - Data to render as JSON
+* @returns Pretty-printed JSON string
+*
+* @example
+* ```typescript
+* console.log(renderJson({ name: "test", value: 42 }));
+* // {
+* //   "name": "test",
+* //   "value": 42
+* // }
+* ```
+*/
+declare function renderJson(data: unknown): string;
+/**
+* Renders plain text unchanged.
+*
+* This is a pass-through function that returns the input text as-is.
+* Useful as a placeholder or for consistent API across render functions.
+*
+* @param text - Text to render
+* @returns The input text unchanged
+*
+* @example
+* ```typescript
+* renderText("Hello, World!"); // "Hello, World!"
+* ```
+*/
+declare function renderText(text: string): string;
+export { renderJson, renderText };

package/dist/shared/@outfitter/cli-34fqr7bp.js

@@ -0,0 +1,37 @@
+// @bun
+import {
+  renderHeading
+} from "./cli-xvqtqjxk.js";
+import {
+  joinVertical
+} from "./cli-671sxkhj.js";
+
+// packages/cli/src/demo/section.ts
+function demoSection(title, options) {
+  return renderHeading(title, {
+    separator: options?.separator ?? "\u2500",
+    case: options?.case ?? "title"
+  });
+}
+function demoSubsection(title, options) {
+  return renderHeading(title, {
+    separator: options?.separator ?? "\u2500",
+    case: options?.case ?? "title"
+  });
+}
+function codeBlock(lines, show = true) {
+  if (!show)
+    return [];
+  return lines;
+}
+function description(text, theme, show = true) {
+  if (!show)
+    return [];
+  return [theme.muted(text)];
+}
+function demoContent(blocks, gap = 1) {
+  const filtered = blocks.filter((b) => b !== "");
+  return joinVertical(filtered, { gap });
+}
+
+export { demoSection, demoSubsection, codeBlock, description, demoContent };