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

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

@@ -0,0 +1,59 @@
+// @bun
+import {
+  BORDERS,
+  init_borders
+} from "./cli-85fg2vr5.js";
+import {
+  ANSI,
+  init_colors
+} from "./cli-9nbyj2bt.js";
+
+// packages/cli/src/theme/presets/default.ts
+init_borders();
+init_colors();
+var defaultTheme = {
+  name: "default",
+  border: "single",
+  borderChars: BORDERS.single,
+  treeGuide: "single",
+  delimiter: "bullet",
+  markers: {
+    default: { type: "indicator", category: "marker", name: "circleOutline" },
+    current: { type: "indicator", category: "marker", name: "circleDot" },
+    focused: { type: "indicator", category: "marker", name: "pointer" },
+    checked: { type: "indicator", category: "marker", name: "checkboxChecked" },
+    disabled: { type: "indicator", category: "marker", name: "dash" },
+    success: { type: "indicator", category: "status", name: "success" },
+    warning: { type: "indicator", category: "status", name: "warning" },
+    error: { type: "indicator", category: "status", name: "error" },
+    info: { type: "indicator", category: "status", name: "info" }
+  },
+  listBullet: { unicode: "\u2022", fallback: "-" },
+  checkbox: {
+    checked: { unicode: "\u2611", fallback: "[x]" },
+    unchecked: { unicode: "\u2610", fallback: "[ ]" }
+  },
+  colors: {
+    success: ANSI.green,
+    warning: ANSI.yellow,
+    error: ANSI.red,
+    info: ANSI.blue,
+    primary: "",
+    secondary: ANSI.gray,
+    muted: ANSI.dim,
+    accent: ANSI.cyan,
+    highlight: ANSI.bold,
+    link: `${ANSI.cyan}${ANSI.underline}`,
+    destructive: ANSI.brightRed,
+    subtle: `${ANSI.dim}${ANSI.gray}`
+  },
+  spacing: {
+    boxPadding: 1,
+    listIndent: 2,
+    stackGap: 0,
+    horizontalGap: 1
+  },
+  spinner: "dots"
+};
+
+export { defaultTheme };

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

@@ -0,0 +1,128 @@
+import { CaseMode, SeparatorStyle } from "./cli-6bztk73z";
+import { Theme } from "./cli-xsaheemc";
+/**
+* Options for creating a demo section.
+*/
+interface SectionOptions {
+	/** Separator character style (default: "─") */
+	separator?: SeparatorStyle;
+	/** Case transformation (default: "title") */
+	case?: CaseMode;
+}
+/**
+* Options for creating a subsection.
+*/
+interface SubsectionOptions {
+	/** Separator character style (default: "─") */
+	separator?: SeparatorStyle;
+	/** Case transformation (default: "title") */
+	case?: CaseMode;
+}
+/**
+* Creates a demo section heading.
+*
+* Sections are major divisions in a demo, rendered with title case text
+* and thin Unicode line separators by default.
+*
+* @param title - The section title
+* @param options - Optional rendering options
+* @returns Formatted section heading string
+*
+* @example
+* ```typescript
+* import { demoSection } from "@outfitter/cli/demo";
+*
+* console.log(demoSection("Theme Colors"));
+* // Theme Colors
+* // ────────────
+* ```
+*/
+declare function demoSection(title: string, options?: SectionOptions): string;
+/**
+* Creates a demo subsection heading.
+*
+* Subsections are minor divisions within a section, rendered with title case
+* text and thin Unicode line separators by default.
+*
+* @param title - The subsection title
+* @param options - Optional rendering options
+* @returns Formatted subsection heading string
+*
+* @example
+* ```typescript
+* import { demoSubsection } from "@outfitter/cli/demo";
+*
+* console.log(demoSubsection("Status"));
+* // Status
+* // ──────
+* ```
+*/
+declare function demoSubsection(title: string, options?: SubsectionOptions): string;
+/**
+* Creates a code block for demo sections.
+*
+* Code blocks are displayed when `showCode` is enabled and provide
+* usage examples for the primitives being demonstrated.
+*
+* @param lines - Lines of code to display
+* @param show - Whether to show the code block (default: true)
+* @returns Array of code lines, or empty array if hidden
+*
+* @example
+* ```typescript
+* import { codeBlock } from "@outfitter/cli/demo";
+*
+* const code = codeBlock([
+*   'import { renderBox } from "@outfitter/cli/render";',
+*   "",
+*   'renderBox("Hello")',
+* ], true);
+* ```
+*/
+declare function codeBlock(lines: string[], show?: boolean): string[];
+/**
+* Creates a description line styled with muted theme.
+*
+* Descriptions provide contextual information about a demo section
+* when `showDescriptions` is enabled.
+*
+* @param text - The description text
+* @param theme - Theme for styling
+* @param show - Whether to show the description (default: true)
+* @returns Array with styled description, or empty array if hidden
+*
+* @example
+* ```typescript
+* import { description } from "@outfitter/cli/demo";
+*
+* const desc = description(
+*   "Control padding per side with an object.",
+*   theme,
+*   true
+* );
+* ```
+*/
+declare function description(text: string, theme: Theme, show?: boolean): string[];
+/**
+* Joins demo content with vertical spacing.
+*
+* Wraps `joinVertical` with demo-appropriate defaults.
+*
+* @param blocks - Content blocks to join
+* @param gap - Lines of spacing between blocks (default: 1)
+* @returns Combined string with blocks stacked
+*
+* @example
+* ```typescript
+* import { demoSection, demoContent } from "@outfitter/cli/demo";
+*
+* const output = demoContent([
+*   demoSection("Colors"),
+*   "Color examples here...",
+*   demoSection("Borders"),
+*   "Border examples here...",
+* ]);
+* ```
+*/
+declare function demoContent(blocks: string[], gap?: number): string;
+export { SectionOptions, SubsectionOptions, demoSection, demoSubsection, codeBlock, description, demoContent };

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

@@ -0,0 +1,75 @@
+// @bun
+import {
+  __esm
+} from "./cli-v1tzwxkt.js";
+
+// packages/cli/src/terminal/detection.ts
+import { getEnvBoolean } from "@outfitter/config";
+function getEnvValue(key) {
+  return process.env[key];
+}
+function hasNoColorEnv() {
+  return getEnvValue("NO_COLOR") !== undefined;
+}
+function resolveForceColorEnv() {
+  const value = getEnvValue("FORCE_COLOR");
+  if (value === undefined) {
+    return;
+  }
+  if (value === "") {
+    return true;
+  }
+  const numeric = Number(value);
+  if (!Number.isNaN(numeric)) {
+    return numeric > 0;
+  }
+  return true;
+}
+function resolveColorEnv(options) {
+  const forced = resolveForceColorEnv();
+  const noColor = hasNoColorEnv();
+  if (options?.forceColorFirst) {
+    if (forced !== undefined) {
+      return forced;
+    }
+    if (noColor) {
+      return false;
+    }
+  } else {
+    if (noColor) {
+      return false;
+    }
+    if (forced !== undefined) {
+      return forced;
+    }
+  }
+  return;
+}
+function supportsColor(options) {
+  const env = resolveColorEnv();
+  if (env !== undefined) {
+    return env;
+  }
+  if (options?.isTTY !== undefined) {
+    return options.isTTY;
+  }
+  return process.stdout.isTTY ?? false;
+}
+function getTerminalWidth(options) {
+  const isTTY = options?.isTTY ?? process.stdout.isTTY ?? false;
+  if (!isTTY) {
+    return 80;
+  }
+  return process.stdout.columns ?? 80;
+}
+function isInteractive(options) {
+  const isCI = options?.isCI ?? getEnvBoolean("CI") === true;
+  if (isCI) {
+    return false;
+  }
+  const isTTY = options?.isTTY ?? process.stdout.isTTY ?? false;
+  return isTTY;
+}
+var init_detection = () => {};
+
+export { getEnvValue, hasNoColorEnv, resolveForceColorEnv, resolveColorEnv, supportsColor, getTerminalWidth, isInteractive, init_detection };

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

@@ -0,0 +1,61 @@
+// @bun
+import {
+  renderProgress
+} from "./cli-bc17qeh2.js";
+import {
+  demoSection
+} from "./cli-34fqr7bp.js";
+
+// packages/cli/src/demo/renderers/progress.ts
+function renderProgressDemo(config, _theme) {
+  const showCode = config.showCode ?? true;
+  const lines = [];
+  lines.push(demoSection("Basic Progress Bar"));
+  lines.push("");
+  if (showCode) {
+    lines.push('import { renderProgress } from "@outfitter/cli/render";');
+    lines.push("");
+  }
+  const percentages = [0, 25, 50, 75, 100];
+  for (const pct of percentages) {
+    const bar = renderProgress({ current: pct, total: 100 });
+    lines.push(`${pct.toString().padStart(3)}% ${bar}`);
+  }
+  lines.push("");
+  lines.push(demoSection("With Percentage Display"));
+  lines.push("");
+  if (showCode) {
+    lines.push("renderProgress({ current: 75, total: 100, showPercent: true })");
+    lines.push("");
+  }
+  lines.push(renderProgress({ current: 75, total: 100, showPercent: true }));
+  lines.push("");
+  lines.push(demoSection("Custom Width"));
+  lines.push("");
+  const widths = [10, 20, 30, 40];
+  for (const width of widths) {
+    if (showCode) {
+      lines.push(`renderProgress({ current: 50, total: 100, width: ${width} })`);
+    }
+    const bar = renderProgress({ current: 50, total: 100, width });
+    lines.push(`  ${bar}`);
+    lines.push("");
+  }
+  lines.push(demoSection("Edge Cases"));
+  lines.push("");
+  lines.push("Empty (0%):");
+  lines.push(`  ${renderProgress({ current: 0, total: 100 })}`);
+  lines.push("");
+  lines.push("Full (100%):");
+  lines.push(`  ${renderProgress({ current: 100, total: 100 })}`);
+  lines.push("");
+  lines.push("Over 100% (capped):");
+  lines.push(`  ${renderProgress({ current: 150, total: 100, showPercent: true })}`);
+  lines.push("");
+  lines.push("Negative (floored to 0%):");
+  lines.push(`  ${renderProgress({ current: -10, total: 100, showPercent: true })}`);
+  return lines.join(`
+`);
+}
+
+export { renderProgressDemo };

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

@@ -0,0 +1,91 @@
+/**
+* Spinner rendering utilities.
+*
+* Provides animated spinner frames for async operations with
+* multiple styles and graceful degradation for non-TTY contexts.
+*
+* @packageDocumentation
+*/
+/**
+* Available spinner animation styles.
+*
+* - `dots`: Braille dots animation (default, smooth)
+* - `line`: Classic ASCII spinner (-\|/)
+* - `arc`: Corner arc rotation
+* - `circle`: Half-filled circle rotation
+* - `bounce`: Bouncing dot (vertical)
+* - `ping`: Bouncing dot in brackets (horizontal)
+*/
+type SpinnerStyle = "dots" | "line" | "arc" | "circle" | "bounce" | "ping";
+/**
+* Spinner animation frame definition.
+*/
+interface SpinnerFrames {
+	/** Array of characters to cycle through */
+	frames: string[];
+	/** Milliseconds between frame changes */
+	interval: number;
+}
+/**
+* Predefined spinner animations.
+*
+* @example
+* ```typescript
+* const dotsSpinner = SPINNERS.dots;
+* console.log(dotsSpinner.frames[0]); // "⠋"
+* console.log(dotsSpinner.interval);  // 80
+* ```
+*/
+declare const SPINNERS: Record<SpinnerStyle, SpinnerFrames>;
+/**
+* Gets the spinner frame for a given elapsed time.
+*
+* Calculates which frame to display based on elapsed milliseconds
+* and the spinner's interval setting. Automatically wraps around
+* when the elapsed time exceeds a full cycle.
+*
+* @param style - The spinner style to use
+* @param elapsed - Elapsed time in milliseconds since spinner started
+* @returns The frame character to display
+*
+* @example
+* ```typescript
+* // Get frame at start
+* getSpinnerFrame("dots", 0); // "⠋"
+*
+* // Get frame after 160ms
+* getSpinnerFrame("dots", 160); // "⠹" (third frame)
+*
+* // Frames wrap around automatically
+* const fullCycle = SPINNERS.dots.interval * SPINNERS.dots.frames.length;
+* getSpinnerFrame("dots", fullCycle); // "⠋" (back to first)
+* ```
+*/
+declare function getSpinnerFrame(style: SpinnerStyle, elapsed: number): string;
+/**
+* Renders a static spinner frame with optional message.
+*
+* This is the non-interactive version for logging and non-TTY contexts.
+* For animated spinners, use the elapsed parameter with `getSpinnerFrame()`.
+*
+* @param style - The spinner style to use
+* @param message - Optional message to display after the spinner
+* @returns Formatted spinner string
+*
+* @example
+* ```typescript
+* // Simple spinner
+* console.log(renderSpinner("dots"));
+* // "⠋"
+*
+* // Spinner with message
+* console.log(renderSpinner("dots", "Loading..."));
+* // "⠋ Loading..."
+*
+* // For logs (non-TTY)
+* logger.info(renderSpinner("line", "Fetching data"));
+* // "- Fetching data"
+* ```
+*/
+declare function renderSpinner(style: SpinnerStyle, message?: string): string;
+export { SpinnerStyle, SpinnerFrames, SPINNERS, getSpinnerFrame, renderSpinner };

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-efy6jfcj.js

@@ -0,0 +1,52 @@
+// @bun
+// packages/cli/src/cli.ts
+import { Command } from "commander";
+function isCommanderHelp(error) {
+  return error.code === "commander.helpDisplayed" || error.code === "commander.version" || error.code === "commander.help";
+}
+function createCLI(config) {
+  const program = new Command;
+  program.name(config.name).version(config.version);
+  if (config.description) {
+    program.description(config.description);
+  }
+  const exit = config.onExit ?? ((code) => process.exit(code));
+  program.exitOverride((error) => {
+    if (isCommanderHelp(error)) {
+      exit(0);
+    }
+    if (config.onError) {
+      config.onError(error);
+    }
+    const exitCode = typeof error.exitCode === "number" && Number.isFinite(error.exitCode) ? error.exitCode : 1;
+    exit(exitCode);
+  });
+  const parse = async (argv) => {
+    try {
+      await program.parseAsync(argv ?? process.argv);
+    } catch (error) {
+      const err = error instanceof Error ? error : new Error(String(error));
+      if (config.onError) {
+        config.onError(err);
+      }
+      const errorExitCode = error.exitCode;
+      const exitCode = typeof errorExitCode === "number" ? errorExitCode : 1;
+      exit(exitCode);
+    }
+  };
+  const cli = {
+    program,
+    register: (builderOrCommand) => {
+      if ("build" in builderOrCommand) {
+        program.addCommand(builderOrCommand.build());
+      } else {
+        program.addCommand(builderOrCommand);
+      }
+      return cli;
+    },
+    parse
+  };
+  return cli;
+}
+
+export { createCLI };

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