@rlabs-inc/gemini-mcp 0.6.2 → 0.7.0

package/dist/cli/ui/colors.js

@@ -0,0 +1,106 @@
+/**
+ * Terminal Color Utilities
+ *
+ * Uses ANSI escape codes directly for zero dependencies.
+ * Respects NO_COLOR and FORCE_COLOR environment variables.
+ * Bun handles these natively in TTY detection.
+ */
+// ANSI escape codes
+const ESC = '\x1b[';
+const RESET = `${ESC}0m`;
+// Check if colors should be used
+function shouldUseColors() {
+    // NO_COLOR takes precedence (https://no-color.org/)
+    if (process.env.NO_COLOR !== undefined)
+        return false;
+    // FORCE_COLOR overrides TTY detection
+    if (process.env.FORCE_COLOR !== undefined)
+        return true;
+    // Check if stdout is a TTY
+    return process.stdout.isTTY ?? false;
+}
+const colorsEnabled = shouldUseColors();
+// Color function factory
+function createColor(code) {
+    return (text) => {
+        if (!colorsEnabled)
+            return text;
+        return `${ESC}${code}m${text}${RESET}`;
+    };
+}
+// Foreground colors
+export const black = createColor('30');
+export const red = createColor('31');
+export const green = createColor('32');
+export const yellow = createColor('33');
+export const blue = createColor('34');
+export const magenta = createColor('35');
+export const cyan = createColor('36');
+export const white = createColor('37');
+// Bright foreground colors
+export const brightBlack = createColor('90');
+export const brightRed = createColor('91');
+export const brightGreen = createColor('92');
+export const brightYellow = createColor('93');
+export const brightBlue = createColor('94');
+export const brightMagenta = createColor('95');
+export const brightCyan = createColor('96');
+export const brightWhite = createColor('97');
+// Background colors
+export const bgBlack = createColor('40');
+export const bgRed = createColor('41');
+export const bgGreen = createColor('42');
+export const bgYellow = createColor('43');
+export const bgBlue = createColor('44');
+export const bgMagenta = createColor('45');
+export const bgCyan = createColor('46');
+export const bgWhite = createColor('47');
+// Text styles
+export const bold = createColor('1');
+export const dim = createColor('2');
+export const italic = createColor('3');
+export const underline = createColor('4');
+export const inverse = createColor('7');
+export const strikethrough = createColor('9');
+// RGB color support (for themes)
+export function rgb(r, g, b) {
+    return (text) => {
+        if (!colorsEnabled)
+            return text;
+        return `${ESC}38;2;${r};${g};${b}m${text}${RESET}`;
+    };
+}
+export function bgRgb(r, g, b) {
+    return (text) => {
+        if (!colorsEnabled)
+            return text;
+        return `${ESC}48;2;${r};${g};${b}m${text}${RESET}`;
+    };
+}
+// 256 color support
+export function color256(code) {
+    return (text) => {
+        if (!colorsEnabled)
+            return text;
+        return `${ESC}38;5;${code}m${text}${RESET}`;
+    };
+}
+// Hex color support (convenience)
+export function hex(hexColor) {
+    const h = hexColor.replace('#', '');
+    const r = parseInt(h.substring(0, 2), 16);
+    const g = parseInt(h.substring(2, 4), 16);
+    const b = parseInt(h.substring(4, 6), 16);
+    return rgb(r, g, b);
+}
+// Utility exports
+export const colors = {
+    enabled: colorsEnabled,
+    reset: RESET,
+};
+// Chainable style builder
+export function style(...styles) {
+    return (text) => {
+        return styles.reduce((t, s) => s(t), text);
+    };
+}

package/dist/cli/ui/index.d.ts

@@ -0,0 +1,21 @@
+/**
+ * UI Components for Gemini CLI
+ *
+ * Beautiful, theme-aware terminal UI components.
+ */
+export * from './colors.js';
+export { getTheme, setTheme, t, themes } from './theme.js';
+export type { Theme } from './theme.js';
+export { Spinner, spinner, spinners } from './spinner.js';
+export type { SpinnerOptions } from './spinner.js';
+export { Progress, progress } from './progress.js';
+export type { ProgressOptions } from './progress.js';
+export { box, header, success, error, warning, info } from './box.js';
+export type { BoxOptions } from './box.js';
+export declare function print(message: string): void;
+export declare function printSuccess(message: string): void;
+export declare function printError(message: string): void;
+export declare function printWarning(message: string): void;
+export declare function printInfo(message: string): void;
+export declare function printMuted(message: string): void;
+export declare function nl(count?: number): void;

package/dist/cli/ui/index.js

@@ -0,0 +1,42 @@
+/**
+ * UI Components for Gemini CLI
+ *
+ * Beautiful, theme-aware terminal UI components.
+ */
+// Colors
+export * from './colors.js';
+// Theme system
+export { getTheme, setTheme, t, themes } from './theme.js';
+// Components
+export { Spinner, spinner, spinners } from './spinner.js';
+export { Progress, progress } from './progress.js';
+export { box, header, success, error, warning, info } from './box.js';
+// Quick print helpers using theme
+import { getTheme } from './theme.js';
+export function print(message) {
+    console.log(message);
+}
+export function printSuccess(message) {
+    const theme = getTheme();
+    console.log(`${theme.colors.success(theme.symbols.success)} ${message}`);
+}
+export function printError(message) {
+    const theme = getTheme();
+    console.error(`${theme.colors.error(theme.symbols.error)} ${message}`);
+}
+export function printWarning(message) {
+    const theme = getTheme();
+    console.log(`${theme.colors.warning(theme.symbols.warning)} ${message}`);
+}
+export function printInfo(message) {
+    const theme = getTheme();
+    console.log(`${theme.colors.info(theme.symbols.info)} ${message}`);
+}
+export function printMuted(message) {
+    const theme = getTheme();
+    console.log(theme.colors.muted(message));
+}
+// Newline helper
+export function nl(count = 1) {
+    console.log('\n'.repeat(count - 1));
+}

package/dist/cli/ui/progress.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Progress Bar for CLI
+ *
+ * Animated progress indicators for long-running operations.
+ */
+export interface ProgressOptions {
+    total?: number;
+    width?: number;
+    complete?: string;
+    incomplete?: string;
+    head?: string;
+    showPercent?: boolean;
+    showEta?: boolean;
+    showValue?: boolean;
+}
+export declare class Progress {
+    private current;
+    private total;
+    private width;
+    private complete;
+    private incomplete;
+    private head;
+    private showPercent;
+    private showEta;
+    private showValue;
+    private startTime;
+    private stream;
+    private label;
+    constructor(options?: ProgressOptions);
+    start(label?: string): this;
+    update(value: number, label?: string): this;
+    increment(amount?: number): this;
+    private render;
+    done(message?: string): void;
+    fail(message?: string): void;
+}
+export declare function progress(options?: ProgressOptions): Progress;

package/dist/cli/ui/progress.js

@@ -0,0 +1,125 @@
+/**
+ * Progress Bar for CLI
+ *
+ * Animated progress indicators for long-running operations.
+ */
+import { getTheme } from './theme.js';
+export class Progress {
+    current = 0;
+    total;
+    width;
+    complete;
+    incomplete;
+    head;
+    showPercent;
+    showEta;
+    showValue;
+    startTime = Date.now();
+    stream = process.stderr;
+    label = '';
+    constructor(options = {}) {
+        const theme = getTheme();
+        this.total = options.total ?? 100;
+        this.width = options.width ?? 30;
+        this.complete = options.complete ?? '█';
+        this.incomplete = options.incomplete ?? '░';
+        this.head = options.head ?? '█';
+        this.showPercent = options.showPercent ?? true;
+        this.showEta = options.showEta ?? true;
+        this.showValue = options.showValue ?? false;
+    }
+    start(label) {
+        if (label)
+            this.label = label;
+        this.startTime = Date.now();
+        this.current = 0;
+        // Hide cursor
+        this.stream.write('\x1b[?25l');
+        this.render();
+        return this;
+    }
+    update(value, label) {
+        this.current = Math.min(value, this.total);
+        if (label)
+            this.label = label;
+        this.render();
+        return this;
+    }
+    increment(amount = 1) {
+        return this.update(this.current + amount);
+    }
+    render() {
+        const theme = getTheme();
+        const percent = this.current / this.total;
+        const completed = Math.floor(this.width * percent);
+        const remaining = this.width - completed;
+        // Build bar
+        let bar = '';
+        if (completed > 0) {
+            bar += theme.colors.primary(this.complete.repeat(completed - 1));
+            bar += theme.colors.highlight(this.head);
+        }
+        bar += theme.colors.muted(this.incomplete.repeat(remaining));
+        // Build status
+        const parts = [];
+        if (this.label) {
+            parts.push(this.label);
+        }
+        parts.push(bar);
+        if (this.showPercent) {
+            parts.push(theme.colors.text(`${Math.floor(percent * 100)}%`));
+        }
+        if (this.showValue) {
+            parts.push(theme.colors.muted(`(${this.current}/${this.total})`));
+        }
+        if (this.showEta && percent > 0 && percent < 1) {
+            const elapsed = (Date.now() - this.startTime) / 1000;
+            const estimatedTotal = elapsed / percent;
+            const eta = Math.ceil(estimatedTotal - elapsed);
+            parts.push(theme.colors.muted(`(${formatTime(eta)})`));
+        }
+        this.stream.write(`\r\x1b[K${parts.join(' ')}`);
+    }
+    done(message) {
+        const theme = getTheme();
+        this.current = this.total;
+        // Clear and show final state
+        this.stream.write('\r\x1b[K');
+        if (message) {
+            this.stream.write(`${theme.colors.success(theme.symbols.success)} ${message}\n`);
+        }
+        else {
+            const elapsed = (Date.now() - this.startTime) / 1000;
+            this.stream.write(`${theme.colors.success(theme.symbols.success)} ${this.label || 'Complete'} ` +
+                `${theme.colors.muted(`(${formatTime(elapsed)})`)}\n`);
+        }
+        // Show cursor
+        this.stream.write('\x1b[?25h');
+    }
+    fail(message) {
+        const theme = getTheme();
+        this.stream.write('\r\x1b[K');
+        this.stream.write(`${theme.colors.error(theme.symbols.error)} ${message || 'Failed'}\n`);
+        this.stream.write('\x1b[?25h');
+    }
+}
+// Format seconds to human readable
+function formatTime(seconds) {
+    if (seconds < 60) {
+        return `${Math.ceil(seconds)}s`;
+    }
+    else if (seconds < 3600) {
+        const mins = Math.floor(seconds / 60);
+        const secs = Math.ceil(seconds % 60);
+        return `${mins}m ${secs}s`;
+    }
+    else {
+        const hours = Math.floor(seconds / 3600);
+        const mins = Math.floor((seconds % 3600) / 60);
+        return `${hours}h ${mins}m`;
+    }
+}
+// Convenience function
+export function progress(options) {
+    return new Progress(options);
+}

package/dist/cli/ui/spinner.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Animated Spinner for CLI
+ *
+ * Beautiful loading indicators that work in any terminal.
+ */
+export interface SpinnerOptions {
+    text?: string;
+    color?: (text: string) => string;
+    frames?: string[];
+    interval?: number;
+}
+export declare class Spinner {
+    private text;
+    private color;
+    private frames;
+    private interval;
+    private currentFrame;
+    private timer;
+    private stream;
+    constructor(options?: SpinnerOptions);
+    start(text?: string): this;
+    private render;
+    update(text: string): this;
+    stop(): this;
+    success(text?: string): void;
+    error(text?: string): void;
+    warn(text?: string): void;
+    info(text?: string): void;
+    private stopWithSymbol;
+}
+export declare function spinner(options?: SpinnerOptions | string): Spinner;
+export declare const spinners: {
+    dots: string[];
+    line: string[];
+    circle: string[];
+    arc: string[];
+    pulse: string[];
+    bounce: string[];
+    arrows: string[];
+    moon: string[];
+    clock: string[];
+};

package/dist/cli/ui/spinner.js

@@ -0,0 +1,96 @@
+/**
+ * Animated Spinner for CLI
+ *
+ * Beautiful loading indicators that work in any terminal.
+ */
+import { getTheme } from './theme.js';
+export class Spinner {
+    text;
+    color;
+    frames;
+    interval;
+    currentFrame = 0;
+    timer = null;
+    stream = process.stderr;
+    constructor(options = {}) {
+        const theme = getTheme();
+        this.text = options.text ?? 'Loading...';
+        this.color = options.color ?? theme.colors.primary;
+        this.frames = options.frames ?? theme.symbols.spinner;
+        this.interval = options.interval ?? 80;
+    }
+    start(text) {
+        if (text)
+            this.text = text;
+        if (this.timer)
+            return this;
+        // Hide cursor
+        this.stream.write('\x1b[?25l');
+        this.timer = setInterval(() => {
+            this.render();
+            this.currentFrame = (this.currentFrame + 1) % this.frames.length;
+        }, this.interval);
+        return this;
+    }
+    render() {
+        // Clear line and write spinner
+        const frame = this.color(this.frames[this.currentFrame]);
+        this.stream.write(`\r${frame} ${this.text}`);
+    }
+    update(text) {
+        this.text = text;
+        return this;
+    }
+    stop() {
+        if (this.timer) {
+            clearInterval(this.timer);
+            this.timer = null;
+        }
+        // Clear line and show cursor
+        this.stream.write('\r\x1b[K\x1b[?25h');
+        return this;
+    }
+    success(text) {
+        this.stopWithSymbol('success', text);
+    }
+    error(text) {
+        this.stopWithSymbol('error', text);
+    }
+    warn(text) {
+        this.stopWithSymbol('warning', text);
+    }
+    info(text) {
+        this.stopWithSymbol('info', text);
+    }
+    stopWithSymbol(type, text) {
+        if (this.timer) {
+            clearInterval(this.timer);
+            this.timer = null;
+        }
+        const theme = getTheme();
+        const symbol = theme.symbols[type];
+        const color = theme.colors[type];
+        const message = text ?? this.text;
+        // Clear line, print result, show cursor
+        this.stream.write(`\r\x1b[K${color(symbol)} ${message}\n\x1b[?25h`);
+    }
+}
+// Convenience function
+export function spinner(options) {
+    if (typeof options === 'string') {
+        return new Spinner({ text: options });
+    }
+    return new Spinner(options);
+}
+// Pre-configured spinners for common operations
+export const spinners = {
+    dots: ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'],
+    line: ['-', '\\', '|', '/'],
+    circle: ['◐', '◓', '◑', '◒'],
+    arc: ['◜', '◠', '◝', '◞', '◡', '◟'],
+    pulse: ['█', '▓', '▒', '░', '▒', '▓'],
+    bounce: ['⠁', '⠂', '⠄', '⠂'],
+    arrows: ['←', '↖', '↑', '↗', '→', '↘', '↓', '↙'],
+    moon: ['🌑', '🌒', '🌓', '🌔', '🌕', '🌖', '🌗', '🌘'],
+    clock: ['🕐', '🕑', '🕒', '🕓', '🕔', '🕕', '🕖', '🕗', '🕘', '🕙', '🕚', '🕛'],
+};

package/dist/cli/ui/theme.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Theme System for Gemini CLI
+ *
+ * Provides beautiful, consistent styling across all CLI output.
+ * Default theme adapts to terminal colors.
+ */
+export interface Theme {
+    name: string;
+    colors: {
+        primary: (text: string) => string;
+        secondary: (text: string) => string;
+        success: (text: string) => string;
+        error: (text: string) => string;
+        warning: (text: string) => string;
+        info: (text: string) => string;
+        muted: (text: string) => string;
+        text: (text: string) => string;
+        highlight: (text: string) => string;
+    };
+    symbols: {
+        success: string;
+        error: string;
+        warning: string;
+        info: string;
+        spinner: string[];
+        arrow: string;
+        bullet: string;
+        pointer: string;
+        star: string;
+    };
+    box: {
+        topLeft: string;
+        topRight: string;
+        bottomLeft: string;
+        bottomRight: string;
+        horizontal: string;
+        vertical: string;
+    };
+}
+export declare const terminalTheme: Theme;
+export declare const neonTheme: Theme;
+export declare const minimalTheme: Theme;
+export declare const oceanTheme: Theme;
+export declare const forestTheme: Theme;
+export declare const themes: Record<string, Theme>;
+export declare function setTheme(themeName: string): void;
+export declare function getTheme(): Theme;
+export declare function t(): Theme;