cli-menu-kit 0.1.0

package/dist/components.js

@@ -0,0 +1,166 @@
+"use strict";
+/**
+ * CLI Menu Kit - UI Components
+ * Handles all display-related UI components
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.symbols = exports.theme = exports.colors = void 0;
+exports.formatSection = formatSection;
+exports.buildHint = buildHint;
+exports.showSubMenuTitle = showSubMenuTitle;
+exports.showProgress = showProgress;
+exports.showInfo = showInfo;
+exports.showSuccess = showSuccess;
+exports.showError = showError;
+exports.showWarning = showWarning;
+exports.showGoodbye = showGoodbye;
+exports.printHeader = printHeader;
+// ANSI Colors
+exports.colors = {
+    reset: '\x1b[0m',
+    red: '\x1b[31m',
+    green: '\x1b[32m',
+    yellow: '\x1b[33m',
+    blue: '\x1b[34m',
+    cyan: '\x1b[36m',
+    gray: '\x1b[90m',
+};
+// Additional color codes
+const colorCodes = {
+    bright: '\x1b[1m',
+    dim: '\x1b[2m',
+    magenta: '\x1b[35m',
+};
+// Theme colors
+exports.theme = {
+    active: `${colorCodes.bright}${exports.colors.cyan}`, // Selected item - bright cyan
+    primary: exports.colors.cyan, // Standard - cyan (numbers, separators)
+    title: exports.colors.reset, // Title - white (menu titles)
+    muted: exports.colors.gray, // Auxiliary - gray (descriptions, hints)
+    success: exports.colors.green, // Success - green
+    warning: exports.colors.yellow, // Warning - yellow
+    error: exports.colors.red, // Error - red
+};
+// Message symbols with colors
+exports.symbols = {
+    success: { icon: '✓', color: exports.colors.green },
+    error: { icon: 'x', color: exports.colors.red },
+    warning: { icon: '!', color: exports.colors.yellow },
+    info: { icon: 'ℹ', color: exports.colors.blue },
+};
+/**
+ * Format section title with separator
+ */
+function formatSection(text) {
+    const separator = '─'.repeat(10);
+    return `${separator} ${text} ${separator}`;
+}
+/**
+ * Build hint text for interactive menus
+ */
+function buildHint(keys, lang = 'zh') {
+    const hints = {
+        zh: {
+            arrows: `${exports.colors.reset}↑↓${exports.theme.muted} 方向键`,
+            space: `${exports.colors.reset}空格${exports.theme.muted} 选中/取消`,
+            number: `${exports.colors.reset}0-9${exports.theme.muted} 输入序号`,
+            letter: `${exports.colors.reset}字母${exports.theme.muted} 快捷键`,
+            all: `${exports.colors.reset}A${exports.theme.muted} 全选`,
+            invert: `${exports.colors.reset}I${exports.theme.muted} 反选`,
+            enter: `${exports.colors.reset}⏎${exports.theme.muted} 确认`,
+            esc: `${exports.colors.reset}Esc${exports.theme.muted} 退出`,
+        },
+        en: {
+            arrows: `${exports.colors.reset}↑↓${exports.theme.muted} Navigate`,
+            space: `${exports.colors.reset}Space${exports.theme.muted} Select`,
+            number: `${exports.colors.reset}0-9${exports.theme.muted} Type number`,
+            letter: `${exports.colors.reset}Letter${exports.theme.muted} Shortcut`,
+            all: `${exports.colors.reset}A${exports.theme.muted} All`,
+            invert: `${exports.colors.reset}I${exports.theme.muted} Invert`,
+            enter: `${exports.colors.reset}⏎${exports.theme.muted} Submit`,
+            esc: `${exports.colors.reset}Esc${exports.theme.muted} Exit`,
+        }
+    };
+    const langHints = hints[lang] || hints.zh;
+    const parts = keys.map(key => langHints[key]).filter(Boolean);
+    return parts.join(` ${exports.theme.muted}•${exports.colors.reset} `) + exports.colors.reset;
+}
+/**
+ * Show submenu title with section format
+ */
+function showSubMenuTitle(title, lang, indent = '  ') {
+    console.log();
+    console.log(`${indent}${exports.theme.primary}${formatSection(title)}${exports.colors.reset}`);
+    console.log();
+}
+/**
+ * Show progress indicator
+ */
+function showProgress(steps, currentStep, lang, indent = '  ') {
+    const progress = steps.map((step, index) => {
+        if (index <= currentStep) {
+            return `${exports.colors.reset}${step}${exports.colors.reset}`;
+        }
+        else {
+            return `${exports.theme.muted}${step}${exports.colors.reset}`;
+        }
+    }).join(` ${exports.theme.muted}→${exports.colors.reset} `);
+    console.log(`${indent}${progress}`);
+    console.log();
+}
+/**
+ * Show info message
+ */
+function showInfo(message, indent = '') {
+    console.log(`${indent}${exports.symbols.info.color}${exports.symbols.info.icon} ${message}${exports.colors.reset}`);
+}
+/**
+ * Show success message
+ */
+function showSuccess(message, indent = '') {
+    console.log(`${indent}${exports.symbols.success.color}${exports.symbols.success.icon} ${message}${exports.colors.reset}`);
+}
+/**
+ * Show error message
+ */
+function showError(message, indent = '') {
+    console.log(`${indent}${exports.symbols.error.color}${exports.symbols.error.icon} ${message}${exports.colors.reset}`);
+}
+/**
+ * Show warning message
+ */
+function showWarning(message, indent = '') {
+    console.log(`${indent}${exports.symbols.warning.color}${exports.symbols.warning.icon} ${message}${exports.colors.reset}`);
+}
+/**
+ * Show goodbye message
+ */
+function showGoodbye(lang = 'zh') {
+    console.log('\n');
+    const message = lang === 'zh'
+        ? '👋 感谢使用，再见！'
+        : '👋 Thank you for using CLI Menu Kit. Goodbye!';
+    console.log(`${exports.theme.active}${message}${exports.colors.reset}`);
+    console.log();
+}
+function printHeader(options) {
+    const { asciiArt, title, subtitle, version, github } = options;
+    const indent = '  ';
+    console.log(`${exports.theme.primary}${'═'.repeat(71)}${exports.colors.reset}`);
+    console.log();
+    asciiArt.forEach(line => {
+        console.log(`${indent}${exports.theme.active}${line}${exports.colors.reset}`);
+    });
+    console.log();
+    console.log(`${indent}${colorCodes.bright}${title}${exports.colors.reset}${subtitle ? `  ${exports.theme.muted}${subtitle}${exports.colors.reset}` : ''}`);
+    console.log();
+    console.log(`${exports.theme.primary}${'═'.repeat(71)}${exports.colors.reset}`);
+    console.log();
+    if (version || github) {
+        const versionText = version ? `${exports.theme.muted}Version: ${exports.colors.reset}${exports.theme.primary}${version}${exports.colors.reset}` : '';
+        const githubText = github ? `${exports.theme.primary}${github}${exports.colors.reset}` : '';
+        const separator = version && github ? `  ${exports.theme.muted}|${exports.colors.reset}  ` : '';
+        console.log(`${indent}${versionText}${separator}${githubText}`);
+        console.log();
+    }
+}

package/dist/core/colors.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Color system for CLI Menu Kit
+ * Supports single colors and two-color gradients
+ */
+/**
+ * ANSI color codes
+ */
+export declare const colors: {
+    readonly reset: "\u001B[0m";
+    readonly black: "\u001B[30m";
+    readonly red: "\u001B[31m";
+    readonly green: "\u001B[32m";
+    readonly yellow: "\u001B[33m";
+    readonly blue: "\u001B[34m";
+    readonly magenta: "\u001B[35m";
+    readonly cyan: "\u001B[36m";
+    readonly white: "\u001B[37m";
+    readonly brightBlack: "\u001B[90m";
+    readonly brightRed: "\u001B[91m";
+    readonly brightGreen: "\u001B[92m";
+    readonly brightYellow: "\u001B[93m";
+    readonly brightBlue: "\u001B[94m";
+    readonly brightMagenta: "\u001B[95m";
+    readonly brightCyan: "\u001B[96m";
+    readonly brightWhite: "\u001B[97m";
+    readonly bgBlack: "\u001B[40m";
+    readonly bgRed: "\u001B[41m";
+    readonly bgGreen: "\u001B[42m";
+    readonly bgYellow: "\u001B[43m";
+    readonly bgBlue: "\u001B[44m";
+    readonly bgMagenta: "\u001B[45m";
+    readonly bgCyan: "\u001B[46m";
+    readonly bgWhite: "\u001B[47m";
+    readonly bold: "\u001B[1m";
+    readonly dim: "\u001B[2m";
+    readonly italic: "\u001B[3m";
+    readonly underline: "\u001B[4m";
+    readonly inverse: "\u001B[7m";
+    readonly hidden: "\u001B[8m";
+    readonly strikethrough: "\u001B[9m";
+};
+/**
+ * Create a gradient between two colors
+ * @param startColor - Starting ANSI color code
+ * @param endColor - Ending ANSI color code
+ * @param steps - Number of steps in the gradient
+ * @returns Array of ANSI color codes for each step
+ */
+export declare function createGradient(startColor: string, endColor: string, steps: number): string[];
+/**
+ * Apply gradient to text
+ * @param text - Text to colorize
+ * @param startColor - Starting color
+ * @param endColor - Ending color
+ * @returns Colorized text with gradient
+ */
+export declare function applyGradient(text: string, startColor: string, endColor: string): string;
+/**
+ * Apply single color to text
+ * @param text - Text to colorize
+ * @param color - ANSI color code
+ * @returns Colorized text
+ */
+export declare function colorize(text: string, color: string): string;

package/dist/core/colors.js

@@ -0,0 +1,139 @@
+"use strict";
+/**
+ * Color system for CLI Menu Kit
+ * Supports single colors and two-color gradients
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.colors = void 0;
+exports.createGradient = createGradient;
+exports.applyGradient = applyGradient;
+exports.colorize = colorize;
+/**
+ * ANSI color codes
+ */
+exports.colors = {
+    // Reset
+    reset: '\x1b[0m',
+    // Basic colors
+    black: '\x1b[30m',
+    red: '\x1b[31m',
+    green: '\x1b[32m',
+    yellow: '\x1b[33m',
+    blue: '\x1b[34m',
+    magenta: '\x1b[35m',
+    cyan: '\x1b[36m',
+    white: '\x1b[37m',
+    // Bright colors
+    brightBlack: '\x1b[90m',
+    brightRed: '\x1b[91m',
+    brightGreen: '\x1b[92m',
+    brightYellow: '\x1b[93m',
+    brightBlue: '\x1b[94m',
+    brightMagenta: '\x1b[95m',
+    brightCyan: '\x1b[96m',
+    brightWhite: '\x1b[97m',
+    // Background colors
+    bgBlack: '\x1b[40m',
+    bgRed: '\x1b[41m',
+    bgGreen: '\x1b[42m',
+    bgYellow: '\x1b[43m',
+    bgBlue: '\x1b[44m',
+    bgMagenta: '\x1b[45m',
+    bgCyan: '\x1b[46m',
+    bgWhite: '\x1b[47m',
+    // Styles
+    bold: '\x1b[1m',
+    dim: '\x1b[2m',
+    italic: '\x1b[3m',
+    underline: '\x1b[4m',
+    inverse: '\x1b[7m',
+    hidden: '\x1b[8m',
+    strikethrough: '\x1b[9m'
+};
+/**
+ * Parse ANSI color code to RGB values
+ * Supports basic 8 colors and bright variants
+ */
+function parseColorToRGB(colorCode) {
+    // Map of ANSI codes to approximate RGB values
+    const colorMap = {
+        '\x1b[30m': { r: 0, g: 0, b: 0 }, // black
+        '\x1b[31m': { r: 170, g: 0, b: 0 }, // red
+        '\x1b[32m': { r: 0, g: 170, b: 0 }, // green
+        '\x1b[33m': { r: 170, g: 85, b: 0 }, // yellow
+        '\x1b[34m': { r: 0, g: 0, b: 170 }, // blue
+        '\x1b[35m': { r: 170, g: 0, b: 170 }, // magenta
+        '\x1b[36m': { r: 0, g: 170, b: 170 }, // cyan
+        '\x1b[37m': { r: 170, g: 170, b: 170 }, // white
+        '\x1b[90m': { r: 85, g: 85, b: 85 }, // bright black
+        '\x1b[91m': { r: 255, g: 85, b: 85 }, // bright red
+        '\x1b[92m': { r: 85, g: 255, b: 85 }, // bright green
+        '\x1b[93m': { r: 255, g: 255, b: 85 }, // bright yellow
+        '\x1b[94m': { r: 85, g: 85, b: 255 }, // bright blue
+        '\x1b[95m': { r: 255, g: 85, b: 255 }, // bright magenta
+        '\x1b[96m': { r: 85, g: 255, b: 255 }, // bright cyan
+        '\x1b[97m': { r: 255, g: 255, b: 255 } // bright white
+    };
+    return colorMap[colorCode] || { r: 170, g: 170, b: 170 };
+}
+/**
+ * Convert RGB to ANSI 256-color code
+ */
+function rgbToAnsi256(r, g, b) {
+    // Use 256-color mode for better gradient quality
+    const code = 16 + 36 * Math.round(r / 255 * 5) + 6 * Math.round(g / 255 * 5) + Math.round(b / 255 * 5);
+    return `\x1b[38;5;${code}m`;
+}
+/**
+ * Interpolate between two RGB colors
+ */
+function interpolateRGB(color1, color2, factor) {
+    return {
+        r: Math.round(color1.r + (color2.r - color1.r) * factor),
+        g: Math.round(color1.g + (color2.g - color1.g) * factor),
+        b: Math.round(color1.b + (color2.b - color1.b) * factor)
+    };
+}
+/**
+ * Create a gradient between two colors
+ * @param startColor - Starting ANSI color code
+ * @param endColor - Ending ANSI color code
+ * @param steps - Number of steps in the gradient
+ * @returns Array of ANSI color codes for each step
+ */
+function createGradient(startColor, endColor, steps) {
+    if (steps <= 0)
+        return [];
+    if (steps === 1)
+        return [startColor];
+    const start = parseColorToRGB(startColor);
+    const end = parseColorToRGB(endColor);
+    const gradient = [];
+    for (let i = 0; i < steps; i++) {
+        const factor = i / (steps - 1);
+        const rgb = interpolateRGB(start, end, factor);
+        gradient.push(rgbToAnsi256(rgb.r, rgb.g, rgb.b));
+    }
+    return gradient;
+}
+/**
+ * Apply gradient to text
+ * @param text - Text to colorize
+ * @param startColor - Starting color
+ * @param endColor - Ending color
+ * @returns Colorized text with gradient
+ */
+function applyGradient(text, startColor, endColor) {
+    const chars = text.split('');
+    const gradient = createGradient(startColor, endColor, chars.length);
+    return chars.map((char, i) => `${gradient[i]}${char}`).join('') + exports.colors.reset;
+}
+/**
+ * Apply single color to text
+ * @param text - Text to colorize
+ * @param color - ANSI color code
+ * @returns Colorized text
+ */
+function colorize(text, color) {
+    return `${color}${text}${exports.colors.reset}`;
+}

package/dist/core/keyboard.d.ts

@@ -0,0 +1,124 @@
+/**
+ * Keyboard handling utilities for CLI Menu Kit
+ * Handles key detection and special key combinations
+ */
+/**
+ * Key codes for special keys
+ */
+export declare const KEY_CODES: {
+    readonly UP: "\u001B[A";
+    readonly DOWN: "\u001B[B";
+    readonly RIGHT: "\u001B[C";
+    readonly LEFT: "\u001B[D";
+    readonly ENTER: "\r";
+    readonly SPACE: " ";
+    readonly BACKSPACE: "";
+    readonly DELETE: "\u001B[3~";
+    readonly ESCAPE: "\u001B";
+    readonly TAB: "\t";
+    readonly CTRL_C: "\u0003";
+    readonly CTRL_D: "\u0004";
+    readonly CTRL_Z: "\u001A";
+    readonly CTRL_A: "\u0001";
+    readonly CTRL_E: "\u0005";
+    readonly CTRL_U: "\u0015";
+    readonly CTRL_K: "\v";
+    readonly CTRL_L: "\f";
+    readonly HOME: "\u001B[H";
+    readonly END: "\u001B[F";
+};
+/**
+ * Check if key is an arrow key
+ * @param key - Key input
+ * @returns True if arrow key
+ */
+export declare function isArrowKey(key: string): boolean;
+/**
+ * Check if key is a number key (0-9)
+ * @param key - Key input
+ * @returns True if number key
+ */
+export declare function isNumberKey(key: string): boolean;
+/**
+ * Check if key is a letter key (a-z, A-Z)
+ * @param key - Key input
+ * @returns True if letter key
+ */
+export declare function isLetterKey(key: string): boolean;
+/**
+ * Check if key is alphanumeric (0-9, a-z, A-Z)
+ * @param key - Key input
+ * @returns True if alphanumeric
+ */
+export declare function isAlphanumeric(key: string): boolean;
+/**
+ * Check if key is printable character
+ * @param key - Key input
+ * @returns True if printable
+ */
+export declare function isPrintable(key: string): boolean;
+/**
+ * Check if key is Ctrl+C
+ * @param key - Key input
+ * @returns True if Ctrl+C
+ */
+export declare function isCtrlC(key: string): boolean;
+/**
+ * Check if key is Enter
+ * @param key - Key input
+ * @returns True if Enter
+ */
+export declare function isEnter(key: string): boolean;
+/**
+ * Check if key is Space
+ * @param key - Key input
+ * @returns True if Space
+ */
+export declare function isSpace(key: string): boolean;
+/**
+ * Check if key is Backspace
+ * @param key - Key input
+ * @returns True if Backspace
+ */
+export declare function isBackspace(key: string): boolean;
+/**
+ * Check if key is Escape
+ * @param key - Key input
+ * @returns True if Escape
+ */
+export declare function isEscape(key: string): boolean;
+/**
+ * Parse number from key input
+ * @param key - Key input
+ * @returns Number or null if not a number
+ */
+export declare function parseNumber(key: string): number | null;
+/**
+ * Normalize letter key to lowercase
+ * @param key - Key input
+ * @returns Lowercase letter or original key
+ */
+export declare function normalizeLetter(key: string): string;
+/**
+ * Check if input is a command (starts with /)
+ * @param input - Input string
+ * @returns True if command
+ */
+export declare function isCommand(input: string): boolean;
+/**
+ * Parse command from input
+ * @param input - Input string
+ * @returns Command name (without /) or null
+ */
+export declare function parseCommand(input: string): string | null;
+/**
+ * Key event handler type
+ */
+export type KeyHandler = (key: string) => void;
+/**
+ * Create a keyboard listener
+ * @param stdin - Input stream
+ * @param handler - Key handler function
+ * @returns Cleanup function
+ */
+export declare function createKeyboardListener(stdin: NodeJS.ReadStream, handler: KeyHandler): () => void;

package/dist/core/keyboard.js

@@ -0,0 +1,185 @@
+"use strict";
+/**
+ * Keyboard handling utilities for CLI Menu Kit
+ * Handles key detection and special key combinations
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KEY_CODES = void 0;
+exports.isArrowKey = isArrowKey;
+exports.isNumberKey = isNumberKey;
+exports.isLetterKey = isLetterKey;
+exports.isAlphanumeric = isAlphanumeric;
+exports.isPrintable = isPrintable;
+exports.isCtrlC = isCtrlC;
+exports.isEnter = isEnter;
+exports.isSpace = isSpace;
+exports.isBackspace = isBackspace;
+exports.isEscape = isEscape;
+exports.parseNumber = parseNumber;
+exports.normalizeLetter = normalizeLetter;
+exports.isCommand = isCommand;
+exports.parseCommand = parseCommand;
+exports.createKeyboardListener = createKeyboardListener;
+/**
+ * Key codes for special keys
+ */
+exports.KEY_CODES = {
+    // Arrow keys
+    UP: '\x1b[A',
+    DOWN: '\x1b[B',
+    RIGHT: '\x1b[C',
+    LEFT: '\x1b[D',
+    // Control keys
+    ENTER: '\r',
+    SPACE: ' ',
+    BACKSPACE: '\x7f',
+    DELETE: '\x1b[3~',
+    ESCAPE: '\x1b',
+    TAB: '\t',
+    // Ctrl combinations
+    CTRL_C: '\x03',
+    CTRL_D: '\x04',
+    CTRL_Z: '\x1a',
+    CTRL_A: '\x01',
+    CTRL_E: '\x05',
+    CTRL_U: '\x15',
+    CTRL_K: '\x0b',
+    CTRL_L: '\x0c',
+    // Home/End
+    HOME: '\x1b[H',
+    END: '\x1b[F'
+};
+/**
+ * Check if key is an arrow key
+ * @param key - Key input
+ * @returns True if arrow key
+ */
+function isArrowKey(key) {
+    return key === exports.KEY_CODES.UP || key === exports.KEY_CODES.DOWN ||
+        key === exports.KEY_CODES.LEFT || key === exports.KEY_CODES.RIGHT;
+}
+/**
+ * Check if key is a number key (0-9)
+ * @param key - Key input
+ * @returns True if number key
+ */
+function isNumberKey(key) {
+    return /^[0-9]$/.test(key);
+}
+/**
+ * Check if key is a letter key (a-z, A-Z)
+ * @param key - Key input
+ * @returns True if letter key
+ */
+function isLetterKey(key) {
+    return /^[a-zA-Z]$/.test(key);
+}
+/**
+ * Check if key is alphanumeric (0-9, a-z, A-Z)
+ * @param key - Key input
+ * @returns True if alphanumeric
+ */
+function isAlphanumeric(key) {
+    return /^[0-9a-zA-Z]$/.test(key);
+}
+/**
+ * Check if key is printable character
+ * @param key - Key input
+ * @returns True if printable
+ */
+function isPrintable(key) {
+    return key.length === 1 && key >= ' ' && key <= '~';
+}
+/**
+ * Check if key is Ctrl+C
+ * @param key - Key input
+ * @returns True if Ctrl+C
+ */
+function isCtrlC(key) {
+    return key === exports.KEY_CODES.CTRL_C;
+}
+/**
+ * Check if key is Enter
+ * @param key - Key input
+ * @returns True if Enter
+ */
+function isEnter(key) {
+    return key === exports.KEY_CODES.ENTER || key === '\n';
+}
+/**
+ * Check if key is Space
+ * @param key - Key input
+ * @returns True if Space
+ */
+function isSpace(key) {
+    return key === exports.KEY_CODES.SPACE;
+}
+/**
+ * Check if key is Backspace
+ * @param key - Key input
+ * @returns True if Backspace
+ */
+function isBackspace(key) {
+    return key === exports.KEY_CODES.BACKSPACE || key === '\b';
+}
+/**
+ * Check if key is Escape
+ * @param key - Key input
+ * @returns True if Escape
+ */
+function isEscape(key) {
+    return key === exports.KEY_CODES.ESCAPE;
+}
+/**
+ * Parse number from key input
+ * @param key - Key input
+ * @returns Number or null if not a number
+ */
+function parseNumber(key) {
+    if (isNumberKey(key)) {
+        return parseInt(key, 10);
+    }
+    return null;
+}
+/**
+ * Normalize letter key to lowercase
+ * @param key - Key input
+ * @returns Lowercase letter or original key
+ */
+function normalizeLetter(key) {
+    if (isLetterKey(key)) {
+        return key.toLowerCase();
+    }
+    return key;
+}
+/**
+ * Check if input is a command (starts with /)
+ * @param input - Input string
+ * @returns True if command
+ */
+function isCommand(input) {
+    return input.startsWith('/');
+}
+/**
+ * Parse command from input
+ * @param input - Input string
+ * @returns Command name (without /) or null
+ */
+function parseCommand(input) {
+    if (isCommand(input)) {
+        return input.slice(1).toLowerCase();
+    }
+    return null;
+}
+/**
+ * Create a keyboard listener
+ * @param stdin - Input stream
+ * @param handler - Key handler function
+ * @returns Cleanup function
+ */
+function createKeyboardListener(stdin, handler) {
+    stdin.on('data', handler);
+    return () => {
+        stdin.removeListener('data', handler);
+    };
+}