@hypercli/ui 0.1.1

package/dist/components/selectPrompt.js

@@ -0,0 +1,206 @@
+/**
+ * SelectPrompt Component
+ *
+ * Prompts the user to select a single option from a list.
+ * Uses raw mode to capture keystrokes for arrow navigation.
+ * Falls back to numbered list input in non-TTY environments.
+ */
+import * as readline from "node:readline";
+import { getContext, styledText, symbol } from "../primitives/index.js";
+/**
+ * Formats the select question line.
+ * Returns: `? message` with `?` in accent color.
+ */
+export function formatSelectQuestion(message) {
+    const q = styledText("?", { color: "accent", bold: true });
+    return `${q} ${message}`;
+}
+/**
+ * Formats the submitted answer line.
+ * Returns: `checkmark message selected-label`.
+ */
+export function formatSelectAnswer(message, selectedLabel) {
+    const icon = styledText(symbol("success"), { color: "success" });
+    const label = styledText(selectedLabel, { dim: true });
+    return `${icon} ${message} ${label}`;
+}
+/**
+ * Renders the option list for display.
+ * Returns an array of formatted option lines.
+ */
+export function renderOptions(options, activeIndex, scrollOffset, maxVisible) {
+    const ctx = getContext();
+    const lines = [];
+    const visible = options.slice(scrollOffset, scrollOffset + maxVisible);
+    for (let i = 0; i < visible.length; i++) {
+        const option = visible[i];
+        const realIndex = scrollOffset + i;
+        const isActive = realIndex === activeIndex;
+        if (option.disabled) {
+            const pointer = "  ";
+            const label = styledText(option.label, { dim: true });
+            const disabled = styledText("(disabled)", { dim: true });
+            lines.push(`${pointer}${label} ${disabled}`);
+        }
+        else if (isActive) {
+            const pointer = styledText(symbol("pointer"), { color: "accent" });
+            const label = styledText(option.label, { color: "accent" });
+            const hint = option.hint ? ` ${styledText(option.hint, { dim: true })}` : "";
+            lines.push(`${pointer} ${label}${hint}`);
+        }
+        else {
+            const pointer = "  ";
+            lines.push(`${pointer}${option.label}`);
+        }
+    }
+    // Scroll indicators
+    if (scrollOffset > 0) {
+        const arrow = styledText(symbol("arrowUp"), { dim: true });
+        lines[0] = `${lines[0]}  ${arrow}`;
+    }
+    if (scrollOffset + maxVisible < options.length) {
+        const arrow = styledText(symbol("arrowDown"), { dim: true });
+        lines[lines.length - 1] = `${lines[lines.length - 1]}  ${arrow}`;
+    }
+    return lines;
+}
+/**
+ * Find the next non-disabled index in a direction.
+ */
+function findNextEnabled(options, from, direction) {
+    let index = from;
+    const len = options.length;
+    for (let attempts = 0; attempts < len; attempts++) {
+        index = (index + direction + len) % len;
+        if (!options[index].disabled)
+            return index;
+    }
+    return from; // All disabled, stay put
+}
+/**
+ * Prompts the user to select a single option from a list using arrow-key navigation.
+ * Falls back to numbered list input in non-TTY environments.
+ *
+ * @typeParam T - The value type of the selectable options.
+ * @param options - Select prompt configuration.
+ * @returns The value of the selected option.
+ */
+export function selectPrompt(options) {
+    const ctx = getContext();
+    const stream = process.stderr;
+    const maxVisible = options.maxVisible ?? 10;
+    const isTTY = !!process.stdin.isTTY;
+    // Find first non-disabled option
+    let activeIndex = options.options.findIndex((o) => !o.disabled);
+    if (activeIndex === -1) {
+        return Promise.reject(new Error("All options are disabled"));
+    }
+    let scrollOffset = 0;
+    function adjustScroll() {
+        if (activeIndex < scrollOffset) {
+            scrollOffset = activeIndex;
+        }
+        else if (activeIndex >= scrollOffset + maxVisible) {
+            scrollOffset = activeIndex - maxVisible + 1;
+        }
+    }
+    return new Promise((resolve, reject) => {
+        if (!isTTY) {
+            // Non-TTY: numbered list fallback
+            stream.write(`${options.message}\n`);
+            options.options.forEach((opt, i) => {
+                const disabled = opt.disabled ? " (disabled)" : "";
+                stream.write(`  ${i + 1}. ${opt.label}${disabled}\n`);
+            });
+            stream.write("Enter number: ");
+            const rl = readline.createInterface({
+                input: process.stdin,
+                terminal: false,
+            });
+            rl.once("line", (line) => {
+                rl.close();
+                const num = Number.parseInt(line.trim(), 10);
+                if (Number.isNaN(num) || num < 1 || num > options.options.length) {
+                    reject(new Error(`Invalid selection: "${line.trim()}"`));
+                    return;
+                }
+                const selected = options.options[num - 1];
+                if (selected.disabled) {
+                    reject(new Error(`Option "${selected.label}" is disabled`));
+                    return;
+                }
+                resolve(selected.value);
+            });
+            return;
+        }
+        // Interactive TTY mode with raw keypress handling
+        const question = formatSelectQuestion(options.message);
+        let renderedLines = 0;
+        function render() {
+            // Clear previously rendered lines
+            if (renderedLines > 0) {
+                for (let i = 0; i < renderedLines; i++) {
+                    stream.write("\x1b[A"); // move up
+                }
+                stream.write("\r\x1b[J"); // clear from cursor to end
+            }
+            adjustScroll();
+            const lines = renderOptions(options.options, activeIndex, scrollOffset, maxVisible);
+            stream.write(`${question}\n`);
+            for (const line of lines) {
+                stream.write(`${line}\n`);
+            }
+            renderedLines = lines.length + 1; // +1 for the question line
+        }
+        // Hide cursor
+        stream.write("\x1b[?25l");
+        render();
+        // Enable raw mode for keypress capture
+        process.stdin.setRawMode(true);
+        process.stdin.resume();
+        const onData = (data) => {
+            const key = data.toString();
+            // Ctrl+C
+            if (key === "\x03") {
+                cleanup();
+                stream.write("\x1b[?25h");
+                reject(new Error("Prompt cancelled"));
+                return;
+            }
+            // Enter
+            if (key === "\r" || key === "\n") {
+                cleanup();
+                // Clear the rendered options
+                if (renderedLines > 0) {
+                    for (let i = 0; i < renderedLines; i++) {
+                        stream.write("\x1b[A");
+                    }
+                    stream.write("\r\x1b[J");
+                }
+                const selected = options.options[activeIndex];
+                stream.write(`${formatSelectAnswer(options.message, selected.label)}\n`);
+                stream.write("\x1b[?25h");
+                resolve(selected.value);
+                return;
+            }
+            // Arrow keys (escape sequences)
+            if (key === "\x1b[A" || key === "k") {
+                // Up
+                activeIndex = findNextEnabled(options.options, activeIndex, -1);
+                render();
+            }
+            else if (key === "\x1b[B" || key === "j") {
+                // Down
+                activeIndex = findNextEnabled(options.options, activeIndex, 1);
+                render();
+            }
+        };
+        function cleanup() {
+            process.stdin.removeListener("data", onData);
+            process.stdin.setRawMode(false);
+            process.stdin.pause();
+        }
+        process.stdin.on("data", onData);
+    });
+}
+//# sourceMappingURL=selectPrompt.js.map

package/dist/components/selectPrompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"selectPrompt.js","sourceRoot":"","sources":["../../src/components/selectPrompt.ts"],"names":[],"mappings":"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"}

package/dist/components/spinner.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Spinner Component
+ *
+ * An animated spinner indicator for indeterminate operations.
+ * Manages terminal output directly via process.stderr.write and cursor control.
+ * Gracefully degrades in non-TTY/CI environments to static line output.
+ */
+/** Options for creating a spinner. */
+export type SpinnerOptions = {
+    /** Initial spinner label text. */
+    text?: string;
+    /** Spinner animation style. Defaults to `'dots'`. */
+    style?: "dots" | "line" | "arc";
+    /** Output stream for spinner rendering. Defaults to `process.stderr`. */
+    stream?: NodeJS.WriteStream;
+};
+/** Handle for controlling a running spinner. */
+export type SpinnerHandle = {
+    /** Start the spinner animation, optionally setting the label text. */
+    start(text?: string): void;
+    /** Update the spinner label text. */
+    update(text: string): void;
+    /** Stop the spinner, optionally showing a final message. */
+    stop(finalText?: string): void;
+    /** Stop with a success icon and optional message. */
+    succeed(text?: string): void;
+    /** Stop with a failure icon and optional message. */
+    fail(text?: string): void;
+};
+/**
+ * Creates an animated spinner for indeterminate operations.
+ * Gracefully degrades to static output in non-TTY/CI environments.
+ *
+ * @param options - Spinner configuration.
+ * @returns A handle to control the spinner lifecycle.
+ */
+export declare function spinner(options?: SpinnerOptions): SpinnerHandle;
+//# sourceMappingURL=spinner.d.ts.map

package/dist/components/spinner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spinner.d.ts","sourceRoot":"","sources":["../../src/components/spinner.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,sCAAsC;AACtC,MAAM,MAAM,cAAc,GAAG;IAC5B,kCAAkC;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qDAAqD;IACrD,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC;IAChC,yEAAyE;IACzE,MAAM,CAAC,EAAE,MAAM,CAAC,WAAW,CAAC;CAC5B,CAAC;AAEF,gDAAgD;AAChD,MAAM,MAAM,aAAa,GAAG;IAC3B,sEAAsE;IACtE,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,qCAAqC;IACrC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,4DAA4D;IAC5D,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,qDAAqD;IACrD,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,qDAAqD;IACrD,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,aAAa,CAgI/D"}

package/dist/components/spinner.js

@@ -0,0 +1,125 @@
+/**
+ * Spinner Component
+ *
+ * An animated spinner indicator for indeterminate operations.
+ * Manages terminal output directly via process.stderr.write and cursor control.
+ * Gracefully degrades in non-TTY/CI environments to static line output.
+ */
+import { getContext, styledText, symbol } from "../primitives/index.js";
+import { stripAnsi } from "../render/index.js";
+/**
+ * Creates an animated spinner for indeterminate operations.
+ * Gracefully degrades to static output in non-TTY/CI environments.
+ *
+ * @param options - Spinner configuration.
+ * @returns A handle to control the spinner lifecycle.
+ */
+export function spinner(options) {
+    const ctx = getContext();
+    const stream = options?.stream ?? process.stderr;
+    const style = options?.style ?? "dots";
+    let currentText = options?.text ?? "";
+    let frameIndex = 0;
+    let timer = null;
+    let startTime = null;
+    let running = false;
+    const spinnerKey = `spinner${style.charAt(0).toUpperCase()}${style.slice(1)}`;
+    const frames = ctx.tokens.motion[spinnerKey];
+    const interval = ctx.tokens.motion.spinnerInterval;
+    const isTTY = !!stream.isTTY;
+    const isInteractive = isTTY && !ctx.capabilities.isCI;
+    function clearLine() {
+        // Clear current line: move to column 0, clear to end of line
+        stream.write("\r\x1b[K");
+    }
+    function renderFrame() {
+        const frame = frames[frameIndex % frames.length];
+        frameIndex++;
+        clearLine();
+        const frameStyled = styledText(frame, { color: "accent" });
+        stream.write(`${frameStyled} ${currentText}`);
+    }
+    function formatDuration(ms) {
+        if (ms < 1000)
+            return `${ms}ms`;
+        const s = (ms / 1000).toFixed(1);
+        return `${s}s`;
+    }
+    const handle = {
+        start(text) {
+            if (running)
+                return;
+            running = true;
+            if (text !== undefined)
+                currentText = text;
+            startTime = Date.now();
+            if (!isInteractive) {
+                // Non-TTY/CI: static output
+                const prefix = ctx.capabilities.unicode ? symbol("running") : "[..]";
+                stream.write(`${prefix} ${currentText}\n`);
+                return;
+            }
+            // Hide cursor
+            stream.write("\x1b[?25l");
+            frameIndex = 0;
+            renderFrame();
+            timer = setInterval(renderFrame, interval);
+        },
+        update(text) {
+            currentText = text;
+            if (!isInteractive) {
+                const prefix = ctx.capabilities.unicode ? symbol("running") : "[..]";
+                stream.write(`${prefix} ${text}\n`);
+                return;
+            }
+            // Next renderFrame tick will pick up the new text
+        },
+        stop(finalText) {
+            if (!running)
+                return;
+            running = false;
+            if (timer) {
+                clearInterval(timer);
+                timer = null;
+            }
+            if (!isInteractive) {
+                if (finalText) {
+                    stream.write(`${finalText}\n`);
+                }
+                return;
+            }
+            clearLine();
+            if (finalText) {
+                stream.write(`${finalText}\n`);
+            }
+            // Show cursor
+            stream.write("\x1b[?25h");
+        },
+        succeed(text) {
+            const finalText = text ?? currentText;
+            const elapsed = startTime !== null ? Date.now() - startTime : 0;
+            const icon = styledText(symbol("success"), { color: "success" });
+            const duration = styledText(` ${formatDuration(elapsed)}`, { dim: true });
+            if (!isInteractive) {
+                const prefix = ctx.capabilities.unicode ? symbol("success") : "[OK]";
+                stream.write(`${prefix} ${finalText}${duration}\n`);
+                running = false;
+                return;
+            }
+            handle.stop(`${icon} ${finalText}${duration}`);
+        },
+        fail(text) {
+            const finalText = text ?? currentText;
+            const icon = styledText(symbol("error"), { color: "error" });
+            if (!isInteractive) {
+                const prefix = ctx.capabilities.unicode ? symbol("error") : "[FAIL]";
+                stream.write(`${prefix} ${finalText}\n`);
+                running = false;
+                return;
+            }
+            handle.stop(`${icon} ${finalText}`);
+        },
+    };
+    return handle;
+}
+//# sourceMappingURL=spinner.js.map

package/dist/components/spinner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spinner.js","sourceRoot":"","sources":["../../src/components/spinner.ts"],"names":[],"mappings":"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"}

package/dist/components/statusList.d.ts

@@ -0,0 +1,22 @@
+/**
+ * statusList Component (Static)
+ *
+ * Renders a list of items with status icons and optional detail text.
+ */
+/** A single item in a status list. */
+export type StatusListItem = {
+    /** Display text for this item. */
+    text: string;
+    /** Current status, determining the icon and color. */
+    status: "pending" | "running" | "success" | "error" | "warning" | "skipped";
+    /** Optional detail text shown inline (if short) or on the next line (if long). */
+    detail?: string;
+};
+/**
+ * Renders a list of items with status-mapped icons and colors.
+ *
+ * @param items - The status list items to render.
+ * @returns The formatted status list as a multi-line string.
+ */
+export declare function statusList(items: StatusListItem[]): string;
+//# sourceMappingURL=statusList.d.ts.map

package/dist/components/statusList.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"statusList.d.ts","sourceRoot":"","sources":["../../src/components/statusList.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,sCAAsC;AACtC,MAAM,MAAM,cAAc,GAAG;IAC5B,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,sDAAsD;IACtD,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,GAAG,SAAS,CAAC;IAC5E,kFAAkF;IAClF,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAWF;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,cAAc,EAAE,GAAG,MAAM,CAyB1D"}

package/dist/components/statusList.js

@@ -0,0 +1,43 @@
+/**
+ * statusList Component (Static)
+ *
+ * Renders a list of items with status icons and optional detail text.
+ */
+import { getContext, indent, stack, styledText, symbol } from "../primitives/index.js";
+const STATUS_COLOR_MAP = {
+    success: "success",
+    error: "error",
+    warning: "warning",
+    running: "info",
+    pending: "fgMuted",
+    skipped: "fgMuted",
+};
+/**
+ * Renders a list of items with status-mapped icons and colors.
+ *
+ * @param items - The status list items to render.
+ * @returns The formatted status list as a multi-line string.
+ */
+export function statusList(items) {
+    const ctx = getContext();
+    const iconGap = " ".repeat(ctx.tokens.space.iconGap);
+    const lines = [];
+    for (const item of items) {
+        const icon = symbol(item.status);
+        const color = STATUS_COLOR_MAP[item.status];
+        const text = styledText(item.text, { color });
+        let line = icon + iconGap + text;
+        if (item.detail) {
+            // If detail is short (< 40 chars), show inline; otherwise on next line indented
+            if (item.detail.length < 40) {
+                line += ` ${styledText(`(${item.detail})`, { dim: true })}`;
+            }
+            else {
+                line += `\n${indent(styledText(item.detail, { dim: true }), 1)}`;
+            }
+        }
+        lines.push(line);
+    }
+    return stack(lines);
+}
+//# sourceMappingURL=statusList.js.map

package/dist/components/statusList.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"statusList.js","sourceRoot":"","sources":["../../src/components/statusList.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAavF,MAAM,gBAAgB,GAAwD;IAC7E,OAAO,EAAE,SAAS;IAClB,KAAK,EAAE,OAAO;IACd,OAAO,EAAE,SAAS;IAClB,OAAO,EAAE,MAAM;IACf,OAAO,EAAE,SAAS;IAClB,OAAO,EAAE,SAAS;CAClB,CAAC;AAEF;;;;;GAKG;AACH,MAAM,UAAU,UAAU,CAAC,KAAuB;IACjD,MAAM,GAAG,GAAG,UAAU,EAAE,CAAC;IACzB,MAAM,OAAO,GAAG,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACrD,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QAC1B,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACjC,MAAM,KAAK,GAAG,gBAAgB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC5C,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QAE9C,IAAI,IAAI,GAAG,IAAI,GAAG,OAAO,GAAG,IAAI,CAAC;QAEjC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YACjB,gFAAgF;YAChF,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC;gBAC7B,IAAI,IAAI,IAAI,UAAU,CAAC,IAAI,IAAI,CAAC,MAAM,GAAG,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;YAC7D,CAAC;iBAAM,CAAC;gBACP,IAAI,IAAI,KAAK,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;YAClE,CAAC;QACF,CAAC;QAED,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAClB,CAAC;IAED,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC;AACrB,CAAC"}

package/dist/components/table.d.ts

@@ -0,0 +1,39 @@
+/**
+ * table Component
+ *
+ * Renders tabular data in multiple variants: minimal, borderless, grid, outer.
+ */
+/** Definition of a single table column. */
+export type TableColumn = {
+    /** Property key used to look up values in each data row. */
+    key: string;
+    /** Display header text. Defaults to the `key`. */
+    header?: string;
+    /** Cell text alignment. Defaults to `'left'`. */
+    align?: "left" | "right" | "center";
+    /** Fixed column width in characters, or `'auto'` to fit content. */
+    width?: number | "auto";
+    /** Maximum column width. Only effective when `truncate` is enabled. */
+    maxWidth?: number;
+    /** Whether to truncate cell text that exceeds `maxWidth`. */
+    truncate?: boolean;
+};
+/** Options for rendering a table. */
+export type TableOptions = {
+    /** Column definitions describing the table structure. */
+    columns: TableColumn[];
+    /** Row data as an array of records keyed by column `key`. */
+    data: Array<Record<string, unknown>>;
+    /** Table rendering variant. Defaults to `'minimal'`. */
+    variant?: "minimal" | "grid" | "borderless" | "outer";
+    /** Text to display when `data` is empty. Defaults to `''`. */
+    emptyText?: string;
+};
+/**
+ * Renders tabular data in aligned columns with multiple visual variants.
+ *
+ * @param options - Table configuration.
+ * @returns The formatted table as a multi-line string.
+ */
+export declare function table(options: TableOptions): string;
+//# sourceMappingURL=table.d.ts.map

package/dist/components/table.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"table.d.ts","sourceRoot":"","sources":["../../src/components/table.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,2CAA2C;AAC3C,MAAM,MAAM,WAAW,GAAG;IACzB,4DAA4D;IAC5D,GAAG,EAAE,MAAM,CAAC;IACZ,kDAAkD;IAClD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iDAAiD;IACjD,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;IACpC,oEAAoE;IACpE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,uEAAuE;IACvE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF,qCAAqC;AACrC,MAAM,MAAM,YAAY,GAAG;IAC1B,yDAAyD;IACzD,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,6DAA6D;IAC7D,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACrC,wDAAwD;IACxD,OAAO,CAAC,EAAE,SAAS,GAAG,MAAM,GAAG,YAAY,GAAG,OAAO,CAAC;IACtD,8DAA8D;IAC9D,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,CAmJnD"}

package/dist/components/table.js

@@ -0,0 +1,132 @@
+/**
+ * table Component
+ *
+ * Renders tabular data in multiple variants: minimal, borderless, grid, outer.
+ */
+import { getContext, styledText } from "../primitives/index.js";
+import { ansiPad, ansiTruncate, stringWidth } from "../render/index.js";
+/**
+ * Renders tabular data in aligned columns with multiple visual variants.
+ *
+ * @param options - Table configuration.
+ * @returns The formatted table as a multi-line string.
+ */
+export function table(options) {
+    const ctx = getContext();
+    const variant = options.variant ?? "minimal";
+    const gutter = ctx.tokens.space.gutter;
+    const chars = ctx.tokens.border.chars;
+    const columns = options.columns;
+    const data = options.data;
+    // Handle empty data
+    if (data.length === 0) {
+        return options.emptyText ?? "";
+    }
+    // Convert data to cell strings
+    const cellData = data.map((row) => columns.map((col) => {
+        const val = row[col.key];
+        return val === null || val === undefined ? "" : String(val);
+    }));
+    // Calculate column widths
+    const colWidths = columns.map((col, i) => {
+        if (typeof col.width === "number")
+            return col.width;
+        // Auto: max of header width and all data widths
+        let max = stringWidth(col.header ?? col.key);
+        for (const row of cellData) {
+            const w = stringWidth(row[i]);
+            if (w > max)
+                max = w;
+        }
+        if (col.maxWidth && max > col.maxWidth) {
+            max = col.maxWidth;
+        }
+        return max;
+    });
+    // Format cell content (truncate + align)
+    function formatCell(text, colIndex) {
+        const col = columns[colIndex];
+        const width = colWidths[colIndex];
+        let result = text;
+        if (col.truncate && col.maxWidth) {
+            const currentW = stringWidth(result);
+            if (currentW > width) {
+                result = ansiTruncate(result, width, ctx.tokens.symbol.ellipsis);
+            }
+        }
+        return ansiPad(result, width, col.align ?? "left");
+    }
+    // Build header cells
+    const headerCells = columns.map((col, i) => {
+        const headerText = col.header ?? col.key;
+        const formatted = ansiPad(headerText, colWidths[i], col.align ?? "left");
+        return styledText(formatted, { bold: true });
+    });
+    // Build data rows
+    const dataRows = cellData.map((row) => row.map((cell, i) => formatCell(cell, i)));
+    const lines = [];
+    const gutterStr = " ".repeat(gutter);
+    if (variant === "minimal") {
+        lines.push(headerCells.join(gutterStr));
+        // Divider under headers
+        const dividerParts = colWidths.map((w) => chars.horizontal.repeat(w));
+        lines.push(dividerParts.join(gutterStr));
+        for (const row of dataRows) {
+            lines.push(row.join(gutterStr));
+        }
+    }
+    else if (variant === "borderless") {
+        lines.push(headerCells.join(gutterStr));
+        for (const row of dataRows) {
+            lines.push(row.join(gutterStr));
+        }
+    }
+    else if (variant === "grid") {
+        const sep = chars.vertical;
+        const innerWidth = colWidths.reduce((s, w) => s + w, 0) + (columns.length - 1) * 3; // " | " between columns
+        // Top border
+        const topParts = colWidths.map((w) => chars.horizontal.repeat(w));
+        lines.push(chars.topLeft +
+            topParts.join(chars.horizontal + chars.teeDown + chars.horizontal) +
+            chars.topRight);
+        // Header row
+        lines.push(`${sep} ${headerCells.join(` ${sep} `)} ${sep}`);
+        // Header divider
+        const hDivParts = colWidths.map((w) => chars.horizontal.repeat(w));
+        lines.push(chars.teeRight +
+            hDivParts.join(chars.horizontal + chars.cross + chars.horizontal) +
+            chars.teeLeft);
+        // Data rows with dividers between them
+        for (let i = 0; i < dataRows.length; i++) {
+            lines.push(`${sep} ${dataRows[i].join(` ${sep} `)} ${sep}`);
+            if (i < dataRows.length - 1) {
+                lines.push(chars.teeRight +
+                    hDivParts.join(chars.horizontal + chars.cross + chars.horizontal) +
+                    chars.teeLeft);
+            }
+        }
+        // Bottom border
+        lines.push(chars.bottomLeft +
+            topParts.join(chars.horizontal + chars.teeUp + chars.horizontal) +
+            chars.bottomRight);
+    }
+    else if (variant === "outer") {
+        const sep = chars.vertical;
+        // Top border
+        const topParts = colWidths.map((w) => chars.horizontal.repeat(w));
+        const innerHWidth = colWidths.reduce((s, w) => s + w, 0) + (columns.length - 1) * gutter;
+        lines.push(chars.topLeft + chars.horizontal.repeat(innerHWidth + 2) + chars.topRight);
+        // Header row
+        lines.push(`${sep} ${headerCells.join(gutterStr)} ${sep}`);
+        // Header divider
+        lines.push(`${sep} ${colWidths.map((w) => chars.horizontal.repeat(w)).join(gutterStr)} ${sep}`);
+        // Data rows
+        for (const row of dataRows) {
+            lines.push(`${sep} ${row.join(gutterStr)} ${sep}`);
+        }
+        // Bottom border
+        lines.push(chars.bottomLeft + chars.horizontal.repeat(innerHWidth + 2) + chars.bottomRight);
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=table.js.map