s3db.js 19.3.25 → 19.4.0

package/dist/cli/components/index.js

@@ -0,0 +1,12 @@
+/**
+ * S3DB CLI Components
+ *
+ * Re-exports all CLI UI components using tuiuiu.js
+ */
+// UI utilities and styles
+export { styles, c, tpl, red, green, yellow, cyan, gray, bold, dim, print, printError, printSuccess, printWarning, printInfo, printHeader, printSection, printKeyValue, printMuted, printTip, } from './ui.js';
+// Table component
+export { Table, renderTable, printTable } from './table.js';
+// Spinner component
+export { Spinner, createSpinner, spinner } from './spinner.js';
+//# sourceMappingURL=index.js.map

package/dist/cli/components/spinner.js

@@ -0,0 +1,153 @@
+/**
+ * S3DB CLI Spinner Component
+ *
+ * Simple animated spinner for CLI operations using tuiuiu spinner styles
+ */
+import { cyan, green, red, yellow } from 'tuiuiu.js/colors';
+const SPINNERS = {
+    dots: {
+        frames: ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'],
+        interval: 80,
+    },
+    line: {
+        frames: ['-', '\\', '|', '/'],
+        interval: 130,
+    },
+    arc: {
+        frames: ['◜', '◠', '◝', '◞', '◡', '◟'],
+        interval: 100,
+    },
+    circle: {
+        frames: ['◐', '◓', '◑', '◒'],
+        interval: 50,
+    },
+    bouncingBar: {
+        frames: [
+            '[    ]', '[=   ]', '[==  ]', '[=== ]', '[ ===]',
+            '[  ==]', '[   =]', '[    ]', '[   =]', '[  ==]',
+            '[ ===]', '[====]', '[=== ]', '[==  ]', '[=   ]',
+        ],
+        interval: 80,
+    },
+    aesthetic: {
+        frames: ['▰▱▱▱▱▱▱', '▰▰▱▱▱▱▱', '▰▰▰▱▱▱▱', '▰▰▰▰▱▱▱', '▰▰▰▰▰▱▱', '▰▰▰▰▰▰▱', '▰▰▰▰▰▰▰', '▰▱▱▱▱▱▱'],
+        interval: 80,
+    },
+    arrow: {
+        frames: ['▹▹▹▹▹', '▸▹▹▹▹', '▹▸▹▹▹', '▹▹▸▹▹', '▹▹▹▸▹', '▹▹▹▹▸'],
+        interval: 120,
+    },
+};
+/**
+ * CLI Spinner class for showing loading states
+ */
+export class Spinner {
+    _text;
+    style;
+    color;
+    frameIndex = 0;
+    timer = null;
+    stream;
+    isRunning = false;
+    constructor(options = {}) {
+        if (typeof options === 'string') {
+            options = { text: options };
+        }
+        this._text = options.text || 'Loading...';
+        this.style = options.style || 'dots';
+        this.color = options.color || cyan;
+        this.stream = process.stderr;
+    }
+    get text() {
+        return this._text;
+    }
+    set text(value) {
+        this._text = value;
+        if (this.isRunning) {
+            this.render();
+        }
+    }
+    get config() {
+        return SPINNERS[this.style];
+    }
+    get frame() {
+        return this.config.frames[this.frameIndex] ?? this.config.frames[0];
+    }
+    get isTTY() {
+        return this.stream.isTTY === true;
+    }
+    clearLine() {
+        if (this.isTTY) {
+            this.stream.clearLine(0);
+            this.stream.cursorTo(0);
+        }
+    }
+    render() {
+        if (!this.isTTY)
+            return;
+        const frame = this.color(this.frame);
+        this.clearLine();
+        this.stream.write(`${frame} ${this._text}`);
+    }
+    start(text) {
+        if (text)
+            this._text = text;
+        if (this.isRunning)
+            return this;
+        this.isRunning = true;
+        if (this.isTTY) {
+            this.render();
+            this.timer = setInterval(() => {
+                this.frameIndex = (this.frameIndex + 1) % this.config.frames.length;
+                this.render();
+            }, this.config.interval);
+        }
+        return this;
+    }
+    stop() {
+        if (this.timer) {
+            clearInterval(this.timer);
+            this.timer = null;
+        }
+        this.isRunning = false;
+        this.clearLine();
+        return this;
+    }
+    succeed(text) {
+        this.stop();
+        const message = text || this._text;
+        console.log(`${green('✓')} ${message}`);
+        return this;
+    }
+    fail(text) {
+        this.stop();
+        const message = text || this._text;
+        console.error(`${red('✗')} ${message}`);
+        return this;
+    }
+    warn(text) {
+        this.stop();
+        const message = text || this._text;
+        console.log(`${yellow('⚠')} ${message}`);
+        return this;
+    }
+    info(text) {
+        this.stop();
+        const message = text || this._text;
+        console.log(`${cyan('ℹ')} ${message}`);
+        return this;
+    }
+}
+/**
+ * Create a new spinner instance
+ */
+export function createSpinner(options) {
+    return new Spinner(options);
+}
+/**
+ * Convenience function to create and start a spinner
+ */
+export function spinner(text) {
+    return new Spinner({ text }).start();
+}
+//# sourceMappingURL=spinner.js.map

package/dist/cli/components/table.js

@@ -0,0 +1,157 @@
+/**
+ * S3DB CLI Table Component
+ *
+ * String-based table renderer for CLI output using tuiuiu border styles
+ */
+import { cyan, gray, bold } from 'tuiuiu.js/colors';
+const BORDERS = {
+    single: {
+        topLeft: '┌', topRight: '┐', bottomLeft: '└', bottomRight: '┘',
+        horizontal: '─', vertical: '│',
+        topMid: '┬', bottomMid: '┴', leftMid: '├', rightMid: '┤', midMid: '┼',
+    },
+    double: {
+        topLeft: '╔', topRight: '╗', bottomLeft: '╚', bottomRight: '╝',
+        horizontal: '═', vertical: '║',
+        topMid: '╦', bottomMid: '╩', leftMid: '╠', rightMid: '╣', midMid: '╬',
+    },
+    round: {
+        topLeft: '╭', topRight: '╮', bottomLeft: '╰', bottomRight: '╯',
+        horizontal: '─', vertical: '│',
+        topMid: '┬', bottomMid: '┴', leftMid: '├', rightMid: '┤', midMid: '┼',
+    },
+    bold: {
+        topLeft: '┏', topRight: '┓', bottomLeft: '┗', bottomRight: '┛',
+        horizontal: '━', vertical: '┃',
+        topMid: '┳', bottomMid: '┻', leftMid: '┣', rightMid: '┫', midMid: '╋',
+    },
+    ascii: {
+        topLeft: '+', topRight: '+', bottomLeft: '+', bottomRight: '+',
+        horizontal: '-', vertical: '|',
+        topMid: '+', bottomMid: '+', leftMid: '+', rightMid: '+', midMid: '+',
+    },
+    none: {
+        topLeft: '', topRight: '', bottomLeft: '', bottomRight: '',
+        horizontal: '', vertical: '',
+        topMid: '', bottomMid: '', leftMid: '', rightMid: '', midMid: '',
+    },
+};
+/**
+ * Calculate column widths based on content
+ */
+function calculateWidths(head, rows, maxWidth) {
+    const widths = head.map(h => String(h).length);
+    for (const row of rows) {
+        for (let i = 0; i < row.length; i++) {
+            const cellWidth = String(row[i] ?? '').length;
+            widths[i] = Math.max(widths[i] || 0, cellWidth);
+        }
+    }
+    if (maxWidth) {
+        return widths.map(w => Math.min(w, maxWidth));
+    }
+    return widths;
+}
+/**
+ * Pad a string to a specific width
+ */
+function pad(str, width) {
+    const s = String(str);
+    if (s.length >= width)
+        return s.slice(0, width);
+    return s + ' '.repeat(width - s.length);
+}
+/**
+ * Create a horizontal line
+ */
+function horizontalLine(widths, borders, left, mid, right, padding, borderColor) {
+    if (!left)
+        return '';
+    const parts = widths.map(w => borders.horizontal.repeat(w + padding * 2));
+    return borderColor(left + parts.join(mid) + right);
+}
+/**
+ * Create a data row
+ */
+function dataRow(cells, widths, borders, padding, borderColor, cellFormatter) {
+    const paddingStr = ' '.repeat(padding);
+    const formattedCells = cells.map((cell, i) => {
+        const value = cell ?? '';
+        const padded = pad(String(value), widths[i] || 0);
+        return cellFormatter ? cellFormatter(padded, i) : padded;
+    });
+    if (borders.vertical) {
+        return borderColor(borders.vertical) +
+            formattedCells.map(c => paddingStr + c + paddingStr).join(borderColor(borders.vertical)) +
+            borderColor(borders.vertical);
+    }
+    return formattedCells.join('  ');
+}
+/**
+ * Render a table to string
+ */
+export function renderTable(options) {
+    const { head, rows, borderStyle = 'single', headerColor = cyan, borderColor = gray, padding = 1, maxColWidth = 50, } = options;
+    const borders = BORDERS[borderStyle];
+    const widths = calculateWidths(head, rows, maxColWidth);
+    const lines = [];
+    // Top border
+    const topLine = horizontalLine(widths, borders, borders.topLeft, borders.topMid, borders.topRight, padding, borderColor);
+    if (topLine)
+        lines.push(topLine);
+    // Header row
+    const headerRow = dataRow(head, widths, borders, padding, borderColor, (cell) => bold(headerColor(cell)));
+    lines.push(headerRow);
+    // Header separator
+    const sepLine = horizontalLine(widths, borders, borders.leftMid, borders.midMid, borders.rightMid, padding, borderColor);
+    if (sepLine)
+        lines.push(sepLine);
+    // Data rows
+    for (const row of rows) {
+        lines.push(dataRow(row, widths, borders, padding, borderColor));
+    }
+    // Bottom border
+    const bottomLine = horizontalLine(widths, borders, borders.bottomLeft, borders.bottomMid, borders.bottomRight, padding, borderColor);
+    if (bottomLine)
+        lines.push(bottomLine);
+    return lines.join('\n');
+}
+/**
+ * Print a table directly to console
+ */
+export function printTable(options) {
+    console.log(renderTable(options));
+}
+/**
+ * Create a table instance for building incrementally
+ */
+export class Table {
+    head = [];
+    rows = [];
+    options;
+    constructor(options = {}) {
+        this.options = options;
+        if (options.head) {
+            this.head = options.head;
+        }
+    }
+    setHead(head) {
+        this.head = head;
+        return this;
+    }
+    push(row) {
+        this.rows.push(row);
+        return this;
+    }
+    toString() {
+        return renderTable({
+            head: this.head,
+            rows: this.rows,
+            ...this.options,
+        });
+    }
+    print() {
+        console.log(this.toString());
+    }
+}
+//# sourceMappingURL=table.js.map

package/dist/cli/components/ui.js

@@ -0,0 +1,99 @@
+/**
+ * S3DB CLI UI Components
+ *
+ * Uses tuiuiu.js for colors and styling
+ */
+import { c, tpl, compose, red, green, yellow, cyan, gray, bold, dim } from 'tuiuiu.js/colors';
+/**
+ * Pre-composed styles for consistent CLI output
+ */
+export const styles = {
+    // Status colors
+    error: compose(red, bold),
+    success: compose(green),
+    warning: compose(yellow),
+    info: compose(cyan),
+    muted: compose(gray, dim),
+    // Semantic styles
+    title: compose(cyan, bold),
+    label: compose(cyan),
+    value: (v) => String(v),
+    highlight: compose(bold),
+    // Icons with colors
+    checkmark: () => green('✓'),
+    cross: () => red('✗'),
+    arrow: () => cyan('→'),
+    bullet: () => gray('•'),
+};
+/**
+ * Chainable color API (re-export from tuiuiu)
+ */
+export { c, tpl };
+/**
+ * Simple functions for common cases
+ */
+export { red, green, yellow, cyan, gray, bold, dim };
+/**
+ * Print a styled message
+ */
+export function print(message) {
+    console.log(message);
+}
+/**
+ * Print an error message
+ */
+export function printError(message) {
+    console.error(styles.error(`Error: ${message}`));
+}
+/**
+ * Print a success message
+ */
+export function printSuccess(message) {
+    console.log(styles.success(`${styles.checkmark()} ${message}`));
+}
+/**
+ * Print a warning message
+ */
+export function printWarning(message) {
+    console.log(styles.warning(`⚠️  ${message}`));
+}
+/**
+ * Print an info message
+ */
+export function printInfo(message) {
+    console.log(styles.info(`ℹ️  ${message}`));
+}
+/**
+ * Print a header/title
+ */
+export function printHeader(title) {
+    console.log(styles.title(`\n${title}\n`));
+}
+/**
+ * Print a section header
+ */
+export function printSection(title) {
+    console.log(bold(title));
+}
+/**
+ * Print a key-value pair
+ */
+export function printKeyValue(key, value) {
+    const displayValue = typeof value === 'boolean'
+        ? (value ? green('✓') : red('✗'))
+        : String(value);
+    console.log(`  ${key}: ${displayValue}`);
+}
+/**
+ * Print a muted/gray message
+ */
+export function printMuted(message) {
+    console.log(styles.muted(message));
+}
+/**
+ * Print a tip/hint
+ */
+export function printTip(message) {
+    console.log(styles.muted(`💡 ${message}`));
+}
+//# sourceMappingURL=ui.js.map