@outfitter/cli 0.3.0 → 0.4.1

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

@@ -1,300 +0,0 @@
-/**
-* A tree node for hierarchical data structures.
-*
-* @example
-* ```typescript
-* const tree: TreeNode = {
-*   name: "src",
-*   children: [
-*     { name: "index.ts", children: [] },
-*     { name: "utils", children: [{ name: "helpers.ts", children: [] }] },
-*   ],
-* };
-* ```
-*/
-interface TreeNode {
-	/** The name/label of this node */
-	name: string;
-	/** Child nodes (empty array for leaf nodes) */
-	children: TreeNode[];
-}
-/**
-* A collection of items, rendered as table (objects) or list (primitives).
-*
-* @example
-* ```typescript
-* // Table rendering (array of objects)
-* const users: Collection = {
-*   type: "collection",
-*   items: [{ name: "Alice", age: 30 }, { name: "Bob", age: 25 }],
-*   headers: { name: "Name", age: "Age" },
-* };
-*
-* // List rendering (array of primitives)
-* const tasks: Collection = {
-*   type: "collection",
-*   items: ["Task 1", "Task 2", "Task 3"],
-* };
-* ```
-*/
-interface Collection {
-	/** Discriminant for Collection type */
-	type: "collection";
-	/** Array of items to render */
-	items: unknown[];
-	/** Optional custom headers for table rendering */
-	headers?: Record<string, string>;
-}
-/**
-* A hierarchical tree structure.
-*
-* @example
-* ```typescript
-* const fileTree: Hierarchy = {
-*   type: "hierarchy",
-*   root: {
-*     name: "project",
-*     children: [
-*       { name: "src", children: [{ name: "index.ts", children: [] }] },
-*       { name: "package.json", children: [] },
-*     ],
-*   },
-* };
-* ```
-*/
-interface Hierarchy {
-	/** Discriminant for Hierarchy type */
-	type: "hierarchy";
-	/** Root node of the tree */
-	root: TreeNode;
-}
-/**
-* Key-value pairs for displaying configuration or metadata.
-*
-* @example
-* ```typescript
-* const config: KeyValue = {
-*   type: "keyvalue",
-*   entries: {
-*     name: "my-app",
-*     version: "1.0.0",
-*     debug: true,
-*   },
-* };
-* ```
-*/
-interface KeyValue {
-	/** Discriminant for KeyValue type */
-	type: "keyvalue";
-	/** Key-value entries to display */
-	entries: Record<string, unknown>;
-}
-/**
-* A resource with content in a specific format.
-*
-* @example
-* ```typescript
-* const jsonResource: Resource = {
-*   type: "resource",
-*   data: { name: "test", value: 42 },
-*   format: "json",
-* };
-*
-* const markdownResource: Resource = {
-*   type: "resource",
-*   data: "# Heading\n\nSome **bold** text",
-*   format: "markdown",
-* };
-* ```
-*/
-interface Resource {
-	/** Discriminant for Resource type */
-	type: "resource";
-	/** The content to render */
-	data: unknown;
-	/** Output format (defaults to "json") */
-	format?: "json" | "markdown" | "text";
-}
-/**
-* Discriminated union of all output shape types.
-*
-* Use the type guards {@link isCollection}, {@link isHierarchy},
-* {@link isKeyValue}, and {@link isResource} for type narrowing.
-*
-* @example
-* ```typescript
-* function processShape(shape: Shape) {
-*   if (isCollection(shape)) {
-*     console.log(`Collection with ${shape.items.length} items`);
-*   } else if (isHierarchy(shape)) {
-*     console.log(`Tree rooted at ${shape.root.name}`);
-*   }
-* }
-* ```
-*/
-type Shape = Collection | Hierarchy | KeyValue | Resource;
-/**
-* Options for the unified {@link render} function.
-*
-* @example
-* ```typescript
-* const options: RenderOptions = {
-*   width: 80,
-*   color: true,
-*   format: "json",
-* };
-* ```
-*/
-interface RenderOptions {
-	/** Maximum width for output (used by some renderers) */
-	width?: number;
-	/** Whether to use ANSI colors in output */
-	color?: boolean;
-	/** Force a specific output format, overriding auto-selection */
-	format?: "table" | "list" | "tree" | "json" | "text";
-}
-/**
-* Type guard for {@link Collection} shapes.
-*
-* @param shape - Shape to check
-* @returns `true` if the shape is a Collection
-*
-* @example
-* ```typescript
-* if (isCollection(shape)) {
-*   console.log(`Has ${shape.items.length} items`);
-* }
-* ```
-*/
-declare function isCollection(shape: Shape): shape is Collection;
-/**
-* Type guard for {@link Hierarchy} shapes.
-*
-* @param shape - Shape to check
-* @returns `true` if the shape is a Hierarchy
-*
-* @example
-* ```typescript
-* if (isHierarchy(shape)) {
-*   console.log(`Root: ${shape.root.name}`);
-* }
-* ```
-*/
-declare function isHierarchy(shape: Shape): shape is Hierarchy;
-/**
-* Type guard for {@link KeyValue} shapes.
-*
-* @param shape - Shape to check
-* @returns `true` if the shape is a KeyValue
-*
-* @example
-* ```typescript
-* if (isKeyValue(shape)) {
-*   console.log(`Keys: ${Object.keys(shape.entries).join(", ")}`);
-* }
-* ```
-*/
-declare function isKeyValue(shape: Shape): shape is KeyValue;
-/**
-* Type guard for {@link Resource} shapes.
-*
-* @param shape - Shape to check
-* @returns `true` if the shape is a Resource
-*
-* @example
-* ```typescript
-* if (isResource(shape)) {
-*   console.log(`Format: ${shape.format ?? "json"}`);
-* }
-* ```
-*/
-declare function isResource(shape: Shape): shape is Resource;
-/**
-* Converts a TreeNode to the Record format expected by renderTree.
-*/
-declare function treeNodeToRecord(node: TreeNode): Record<string, unknown>;
-/**
-* Checks if an item is a plain object (not null, not array, not primitive).
-*/
-declare function isPlainObject(item: unknown): item is Record<string, unknown>;
-/**
-* A function that renders a shape to a string.
-*
-* @typeParam S - The specific shape type this renderer handles
-*/
-type ShapeRenderer<S extends Shape = Shape> = (shape: S, options?: RenderOptions) => string;
-/**
-* Registers a custom renderer for a shape type.
-* Custom renderers take precedence over built-in renderers.
-*
-* @param shapeType - The shape type to register (e.g., "collection", "hierarchy")
-* @param renderer - The renderer function to use for this shape type
-*
-* @example
-* ```typescript
-* registerRenderer("collection", (shape, opts) => {
-*   return shape.items.map(item => `- ${item}`).join("\n");
-* });
-* ```
-*/
-declare function registerRenderer<S extends Shape>(shapeType: S["type"], renderer: ShapeRenderer<S>): void;
-/**
-* Removes a custom renderer, reverting to built-in behavior.
-*
-* @param shapeType - The shape type to unregister
-* @returns `true` if a renderer was removed, `false` if none existed
-*
-* @example
-* ```typescript
-* unregisterRenderer("collection"); // Reverts to built-in table/list rendering
-* ```
-*/
-declare function unregisterRenderer(shapeType: string): boolean;
-/**
-* Clears all custom renderers, reverting to built-in behavior.
-* Useful for testing to ensure clean state between tests.
-*
-* @example
-* ```typescript
-* afterEach(() => {
-*   clearRenderers();
-* });
-* ```
-*/
-declare function clearRenderers(): void;
-/**
-* Unified render function that auto-selects the appropriate renderer based on shape type.
-*
-* Auto-selection logic:
-* - **Collection**: Uses {@link renderTable} for object items, {@link renderList} for primitives
-* - **Hierarchy**: Uses {@link renderTree}
-* - **KeyValue**: Renders as formatted key-value pairs (JSON-like)
-* - **Resource**: Uses {@link renderJson}, {@link renderMarkdown}, or {@link renderText} based on format
-*
-* The `options.format` parameter can override auto-selection.
-*
-* @param shape - The shape to render
-* @param options - Rendering options
-* @returns Rendered string output
-*
-* @example
-* ```typescript
-* // Collection auto-selects table or list
-* render({ type: "collection", items: [{ name: "Alice" }] });
-* render({ type: "collection", items: ["item1", "item2"] });
-*
-* // Hierarchy uses tree rendering
-* render({ type: "hierarchy", root: { name: "src", children: [] } });
-*
-* // KeyValue renders formatted pairs
-* render({ type: "keyvalue", entries: { key: "value" } });
-*
-* // Resource respects format option
-* render({ type: "resource", data: obj, format: "json" });
-*
-* // Override with options.format
-* render({ type: "collection", items: [{ a: 1 }] }, { format: "json" });
-* ```
-*/
-declare function render(shape: Shape, options?: RenderOptions): string;
-export { TreeNode, Collection, Hierarchy, KeyValue, Resource, Shape, RenderOptions, isCollection, isHierarchy, isKeyValue, isResource, treeNodeToRecord, isPlainObject, ShapeRenderer, registerRenderer, unregisterRenderer, clearRenderers, render };

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

@@ -1,94 +0,0 @@
-// @bun
-import {
-  renderTable
-} from "./cli-c8fqdaes.js";
-import {
-  BORDER_STYLE_META,
-  getBorderStyles
-} from "./cli-d8ahdd9d.js";
-import {
-  getExample
-} from "./cli-xep6v2c0.js";
-import {
-  demoSection
-} from "./cli-sam2sq50.js";
-
-// packages/cli/src/demo/renderers/table.ts
-function renderTableDemo(config, theme) {
-  const showCode = config.showCode ?? true;
-  const showDescriptions = config.showDescriptions ?? true;
-  const lines = [];
-  lines.push(demoSection("Basic Table"));
-  lines.push("");
-  if (showCode) {
-    lines.push('import { renderTable } from "@outfitter/cli/render";');
-    lines.push("");
-    lines.push("renderTable([");
-    lines.push('  { id: 1, name: "Alice", status: "Active" },');
-    lines.push('  { id: 2, name: "Bob", status: "Pending" },');
-    lines.push("])");
-    lines.push("");
-  }
-  const basicData = getExample("tableData", config.examples);
-  lines.push(renderTable(basicData));
-  lines.push("");
-  lines.push(demoSection("Custom Headers"));
-  lines.push("");
-  if (showCode) {
-    lines.push("renderTable(data, {");
-    lines.push('  headers: { id: "Task ID", name: "Assignee" }');
-    lines.push("})");
-    lines.push("");
-  }
-  lines.push(renderTable(basicData, {
-    headers: { id: "Task ID", name: "Assignee" }
-  }));
-  lines.push("");
-  lines.push(demoSection("Border Styles"));
-  lines.push("");
-  const styles = getBorderStyles().filter((s) => s !== "none");
-  const smallData = [
-    { id: 1, name: "Alice" },
-    { id: 2, name: "Bob" }
-  ];
-  for (const style of styles) {
-    const meta = BORDER_STYLE_META[style];
-    lines.push(`${meta.label.toUpperCase()} (border: "${style}")`);
-    if (showDescriptions) {
-      lines.push(theme.muted(meta.description));
-    }
-    lines.push("");
-    lines.push(renderTable(smallData, { border: style }));
-    lines.push("");
-  }
-  lines.push(demoSection("Compact Mode"));
-  lines.push("");
-  if (showCode) {
-    lines.push("renderTable(data, { compact: true })");
-    lines.push("");
-  }
-  lines.push(renderTable(smallData, { compact: true }));
-  lines.push("");
-  lines.push(theme.muted("Compact mode removes borders and uses space separators."));
-  lines.push("");
-  lines.push(demoSection("Wide Characters (CJK/Emoji)"));
-  lines.push("");
-  if (showCode) {
-    lines.push("renderTable([");
-    lines.push('  { id: 1, name: "\u5C71\u7530\u592A\u90CE", status: "\u5B8C\u4E86" },');
-    lines.push('  { id: 2, name: "Party \uD83C\uDF89", status: "\uD83D\uDE80" },');
-    lines.push("])");
-    lines.push("");
-  }
-  const wideData = [
-    { id: 1, name: "\u5C71\u7530\u592A\u90CE", status: "\u5B8C\u4E86" },
-    { id: 2, name: "Party \uD83C\uDF89", status: "\uD83D\uDE80" }
-  ];
-  lines.push(renderTable(wideData));
-  lines.push("");
-  lines.push(theme.muted("Uses Bun.stringWidth() for correct column alignment."));
-  return lines.join(`
-`);
-}
-
-export { renderTableDemo };

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

@@ -1,106 +0,0 @@
-/**
-* Box-drawing border utilities.
-*
-* Provides border character sets and line drawing functions for tables, boxes, and panels.
-*
-* @packageDocumentation
-*/
-/**
-* Available border style presets.
-*
-* - `single`: Standard Unicode single-line borders (┌─┐)
-* - `double`: Double-line borders (╔═╗)
-* - `rounded`: Rounded corners with single lines (╭─╮)
-* - `heavy`: Thick/heavy borders (┏━┓)
-* - `ascii`: ASCII-only fallback (+, -, |)
-* - `none`: No borders (empty strings)
-*/
-type BorderStyle = "single" | "double" | "rounded" | "heavy" | "ascii" | "none";
-/**
-* Complete set of box-drawing characters for a border style.
-*
-* Includes corners, edges, and intersection characters for building
-* tables, boxes, and other bordered elements.
-*/
-interface BorderCharacters {
-	/** Top-left corner (e.g., ┌ ╔ ╭ ┏) */
-	topLeft: string;
-	/** Top-right corner (e.g., ┐ ╗ ╮ ┓) */
-	topRight: string;
-	/** Bottom-left corner (e.g., └ ╚ ╰ ┗) */
-	bottomLeft: string;
-	/** Bottom-right corner (e.g., ┘ ╝ ╯ ┛) */
-	bottomRight: string;
-	/** Horizontal line (e.g., ─ ═ ━) */
-	horizontal: string;
-	/** Vertical line (e.g., │ ║ ┃) */
-	vertical: string;
-	/** Top T-intersection for column separators (e.g., ┬ ╦ ┳) */
-	topT: string;
-	/** Bottom T-intersection for column separators (e.g., ┴ ╩ ┻) */
-	bottomT: string;
-	/** Left T-intersection for row separators (e.g., ├ ╠ ┣) */
-	leftT: string;
-	/** Right T-intersection for row separators (e.g., ┤ ╣ ┫) */
-	rightT: string;
-	/** Cross intersection for table cells (e.g., ┼ ╬ ╋) */
-	cross: string;
-}
-/**
-* Preset border character sets for each style.
-*
-* @example
-* ```typescript
-* import { BORDERS } from "@outfitter/cli";
-*
-* const single = BORDERS.single;
-* console.log(`${single.topLeft}${single.horizontal.repeat(10)}${single.topRight}`);
-* // Output: ┌──────────┐
-* ```
-*/
-declare const BORDERS: Record<BorderStyle, BorderCharacters>;
-/**
-* Returns the border character set for the given style.
-*
-* @param style - The border style preset
-* @returns The complete set of border characters
-*
-* @example
-* ```typescript
-* const chars = getBorderCharacters("rounded");
-* console.log(chars.topLeft); // ╭
-* console.log(chars.topRight); // ╮
-* ```
-*/
-declare function getBorderCharacters(style: BorderStyle): BorderCharacters;
-/**
-* Position of a horizontal line within a bordered element.
-*/
-type LinePosition = "top" | "middle" | "bottom";
-/**
-* Draws a horizontal line with the appropriate corner/intersection characters.
-*
-* Used for building table borders and box edges. Handles column intersections
-* when column widths are provided.
-*
-* @param width - Total width of the line content (excluding corners)
-* @param chars - Border character set to use
-* @param position - Position of line: "top", "middle", or "bottom"
-* @param columnWidths - Optional array of column widths for intersection placement
-* @returns The formatted horizontal line string
-*
-* @example
-* ```typescript
-* const chars = getBorderCharacters("single");
-*
-* // Simple line (no columns)
-* drawHorizontalLine(10, chars, "top");
-* // Returns: ┌──────────┐
-*
-* // Line with column intersections
-* drawHorizontalLine(14, chars, "middle", [5, 7]);
-* // Returns: ├─────┼───────┤
-* ```
-*/
-declare function drawHorizontalLine(width: number, chars: BorderCharacters, position: LinePosition, columnWidths?: number[]): string;
-export { BorderStyle, BorderCharacters, BORDERS, getBorderCharacters, LinePosition, drawHorizontalLine };

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

@@ -1,122 +0,0 @@
-// @bun
-import {
-  TREE_GUIDES,
-  renderTree
-} from "./cli-b5c2k0d7.js";
-import {
-  getExample
-} from "./cli-xep6v2c0.js";
-import {
-  demoSection
-} from "./cli-sam2sq50.js";
-
-// packages/cli/src/demo/renderers/tree.ts
-function renderTreeDemo(config, _theme) {
-  const showCode = config.showCode ?? true;
-  const lines = [];
-  lines.push(demoSection("Basic Tree"));
-  lines.push("");
-  if (showCode) {
-    lines.push('import { renderTree } from "@outfitter/cli/tree";');
-    lines.push("");
-  }
-  const treeData = getExample("treeData", config.examples);
-  if (showCode) {
-    lines.push("renderTree({");
-    lines.push("  src: {");
-    lines.push("    components: { Button: null, Input: null },");
-    lines.push("    utils: null,");
-    lines.push("  },");
-    lines.push("  tests: null,");
-    lines.push("})");
-    lines.push("");
-  }
-  lines.push(renderTree(treeData));
-  lines.push("");
-  lines.push(demoSection("Guide Styles"));
-  lines.push("");
-  const guideDemo = {
-    root: {
-      child1: {
-        leaf: null
-      },
-      child2: null
-    }
-  };
-  const guideStyles = [
-    "single",
-    "rounded",
-    "heavy",
-    "double"
-  ];
-  for (const style of guideStyles) {
-    const guide = TREE_GUIDES[style];
-    lines.push(`${style.toUpperCase()} (fork: "${guide.fork.trim()}", end: "${guide.end.trim()}")`);
-    lines.push("");
-    lines.push(renderTree(guideDemo, { guide: style }));
-    lines.push("");
-  }
-  lines.push(demoSection("Max Depth"));
-  lines.push("");
-  const deepTree = {
-    level1: {
-      level2: {
-        level3: {
-          level4: null
-        }
-      }
-    }
-  };
-  if (showCode) {
-    lines.push("renderTree(tree, { maxDepth: 2 })");
-    lines.push("");
-  }
-  lines.push("Full tree:");
-  lines.push(renderTree(deepTree));
-  lines.push("");
-  lines.push("With maxDepth: 2:");
-  lines.push(renderTree(deepTree, { maxDepth: 2 }));
-  lines.push("");
-  lines.push(demoSection("Custom Labels"));
-  lines.push("");
-  const fileTree = {
-    src: {
-      "index.ts": null,
-      components: {
-        "Button.tsx": null
-      }
-    },
-    "package.json": null
-  };
-  if (showCode) {
-    lines.push("renderTree(tree, {");
-    lines.push("  renderLabel: (key, value) => {");
-    lines.push("    if (value && typeof value === 'object') {");
-    lines.push("      return `\uD83D\uDCC1 ${key}/`;");
-    lines.push("    }");
-    lines.push("    return `\uD83D\uDCC4 ${key}`;");
-    lines.push("  }");
-    lines.push("})");
-    lines.push("");
-  }
-  lines.push(renderTree(fileTree, {
-    renderLabel: (key, value) => {
-      if (value && typeof value === "object") {
-        return `\uD83D\uDCC1 ${key}/`;
-      }
-      return `\uD83D\uDCC4 ${key}`;
-    }
-  }));
-  lines.push("");
-  lines.push(demoSection("Usage Notes"));
-  lines.push("");
-  lines.push("\u2022 Objects become branches with children");
-  lines.push("\u2022 null values become leaf nodes (terminal)");
-  lines.push("\u2022 Use guide option to change visual style");
-  lines.push("\u2022 Use maxDepth to limit rendering depth");
-  lines.push("\u2022 Use renderLabel for custom node formatting");
-  return lines.join(`
-`);
-}
-
-export { renderTreeDemo };

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

@@ -1,66 +0,0 @@
-import { WritableStream } from "./cli-cf1xexgn";
-/**
-* Spinner frame sets.
-*/
-declare const SPINNER_FRAMES: {
-	readonly dots: readonly ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"];
-	readonly line: readonly ["-", "\\", "|", "/"];
-	readonly simple: readonly ["◐", "◓", "◑", "◒"];
-};
-/**
-* Available spinner styles.
-*/
-type SpinnerStyle = keyof typeof SPINNER_FRAMES;
-/**
-* Options for creating a spinner.
-*/
-interface SpinnerOptions {
-	/** Spinner style */
-	style?: SpinnerStyle;
-	/** Target stream */
-	stream?: WritableStream;
-	/** Frame interval in ms */
-	interval?: number;
-}
-/**
-* Spinner interface for animated progress indication.
-*/
-interface Spinner {
-	/** Start the spinner */
-	start(): void;
-	/** Update the spinner message */
-	update(message: string): void;
-	/** Stop with success state */
-	succeed(message?: string): void;
-	/** Stop with failure state */
-	fail(message?: string): void;
-	/** Stop the spinner */
-	stop(): void;
-}
-/**
-* Creates an animated spinner for indicating progress.
-*
-* In TTY mode, shows an animated spinner. In non-TTY mode,
-* falls back to static output.
-*
-* @param message - Initial spinner message
-* @param options - Spinner configuration
-* @returns Spinner instance
-*
-* @example
-* ```typescript
-* import { createSpinner } from "@outfitter/cli/streaming";
-*
-* const spinner = createSpinner("Installing dependencies");
-* spinner.start();
-*
-* try {
-*   await install();
-*   spinner.succeed("Dependencies installed");
-* } catch (error) {
-*   spinner.fail("Installation failed");
-* }
-* ```
-*/
-declare function createSpinner(message: string, options?: SpinnerOptions): Spinner;
-export { SpinnerStyle, SpinnerOptions, Spinner, createSpinner };