cli-menu-kit 0.1.0

package/dist/components/menus/boolean-menu.d.ts

@@ -0,0 +1,11 @@
+/**
+ * BooleanMenu - Yes/No selection component
+ * Supports both horizontal and vertical orientations
+ */
+import { BooleanMenuConfig, BooleanMenuResult } from '../../types/menu.types.js';
+/**
+ * Show a boolean menu (yes/no selection)
+ * @param config - Menu configuration
+ * @returns Promise resolving to boolean result
+ */
+export declare function showBooleanMenu(config: BooleanMenuConfig): Promise<BooleanMenuResult>;

package/dist/components/menus/boolean-menu.js

@@ -0,0 +1,169 @@
+"use strict";
+/**
+ * BooleanMenu - Yes/No selection component
+ * Supports both horizontal and vertical orientations
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.showBooleanMenu = showBooleanMenu;
+const terminal_js_1 = require("../../core/terminal.js");
+const keyboard_js_1 = require("../../core/keyboard.js");
+const colors_js_1 = require("../../core/colors.js");
+/**
+ * Show a boolean menu (yes/no selection)
+ * @param config - Menu configuration
+ * @returns Promise resolving to boolean result
+ */
+async function showBooleanMenu(config) {
+    const { question, defaultValue = true, yesText = '是', noText = '否', orientation = 'horizontal', onExit } = config;
+    if (orientation === 'horizontal') {
+        return showBooleanMenuHorizontal(question, defaultValue, yesText, noText, onExit);
+    }
+    else {
+        return showBooleanMenuVertical(question, defaultValue, yesText, noText, onExit);
+    }
+}
+/**
+ * Show horizontal boolean menu (side by side)
+ */
+async function showBooleanMenuHorizontal(question, defaultValue, yesText, noText, onExit) {
+    const state = (0, terminal_js_1.initTerminal)();
+    let selected = defaultValue;
+    const render = () => {
+        (0, terminal_js_1.clearMenu)(state);
+        // Render question with options on same line
+        const yesOption = selected
+            ? `${colors_js_1.colors.cyan}${yesText}${colors_js_1.colors.reset}`
+            : `${colors_js_1.colors.dim}${yesText}${colors_js_1.colors.reset}`;
+        const noOption = !selected
+            ? `${colors_js_1.colors.cyan}${noText}${colors_js_1.colors.reset}`
+            : `${colors_js_1.colors.dim}${noText}${colors_js_1.colors.reset}`;
+        (0, terminal_js_1.writeLine)(`${colors_js_1.colors.yellow}?${colors_js_1.colors.reset} ${question} ${yesOption} | ${noOption}`);
+        state.renderedLines = 1;
+    };
+    // Initial render
+    render();
+    // Handle keyboard input
+    return new Promise((resolve) => {
+        const onData = (key) => {
+            // Handle Ctrl+C
+            if ((0, keyboard_js_1.isCtrlC)(key)) {
+                state.stdin.removeListener('data', onData);
+                (0, terminal_js_1.clearMenu)(state);
+                (0, terminal_js_1.restoreTerminal)(state);
+                if (onExit) {
+                    onExit();
+                }
+                else {
+                    console.log('\n👋 再见!');
+                }
+                process.exit(0);
+            }
+            // Handle Enter
+            if ((0, keyboard_js_1.isEnter)(key)) {
+                state.stdin.removeListener('data', onData);
+                (0, terminal_js_1.clearMenu)(state);
+                (0, terminal_js_1.restoreTerminal)(state);
+                resolve(selected);
+                return;
+            }
+            // Handle left/right arrows
+            if (key === keyboard_js_1.KEY_CODES.LEFT) {
+                selected = true;
+                render();
+                return;
+            }
+            if (key === keyboard_js_1.KEY_CODES.RIGHT) {
+                selected = false;
+                render();
+                return;
+            }
+            // Handle Y/N keys
+            const letter = (0, keyboard_js_1.normalizeLetter)(key);
+            if (letter === 'y') {
+                selected = true;
+                render();
+                return;
+            }
+            if (letter === 'n') {
+                selected = false;
+                render();
+                return;
+            }
+        };
+        state.stdin.on('data', onData);
+    });
+}
+/**
+ * Show vertical boolean menu (stacked)
+ */
+async function showBooleanMenuVertical(question, defaultValue, yesText, noText, onExit) {
+    const state = (0, terminal_js_1.initTerminal)();
+    let selected = defaultValue;
+    const render = () => {
+        (0, terminal_js_1.clearMenu)(state);
+        // Render question
+        (0, terminal_js_1.writeLine)(`${colors_js_1.colors.yellow}?${colors_js_1.colors.reset} ${question}`);
+        (0, terminal_js_1.writeLine)('');
+        // Render yes option
+        const yesCursor = selected ? `${colors_js_1.colors.cyan}❯ ${colors_js_1.colors.reset}` : '  ';
+        const yesColor = selected ? colors_js_1.colors.cyan : colors_js_1.colors.reset;
+        (0, terminal_js_1.writeLine)(`${yesCursor}${yesColor}${yesText}${colors_js_1.colors.reset}`);
+        // Render no option
+        const noCursor = !selected ? `${colors_js_1.colors.cyan}❯ ${colors_js_1.colors.reset}` : '  ';
+        const noColor = !selected ? colors_js_1.colors.cyan : colors_js_1.colors.reset;
+        (0, terminal_js_1.writeLine)(`${noCursor}${noColor}${noText}${colors_js_1.colors.reset}`);
+        state.renderedLines = 4;
+    };
+    // Initial render
+    render();
+    // Handle keyboard input
+    return new Promise((resolve) => {
+        const onData = (key) => {
+            // Handle Ctrl+C
+            if ((0, keyboard_js_1.isCtrlC)(key)) {
+                state.stdin.removeListener('data', onData);
+                (0, terminal_js_1.clearMenu)(state);
+                (0, terminal_js_1.restoreTerminal)(state);
+                if (onExit) {
+                    onExit();
+                }
+                else {
+                    console.log('\n👋 再见!');
+                }
+                process.exit(0);
+            }
+            // Handle Enter
+            if ((0, keyboard_js_1.isEnter)(key)) {
+                state.stdin.removeListener('data', onData);
+                (0, terminal_js_1.clearMenu)(state);
+                (0, terminal_js_1.restoreTerminal)(state);
+                resolve(selected);
+                return;
+            }
+            // Handle up/down arrows
+            if (key === keyboard_js_1.KEY_CODES.UP) {
+                selected = true;
+                render();
+                return;
+            }
+            if (key === keyboard_js_1.KEY_CODES.DOWN) {
+                selected = false;
+                render();
+                return;
+            }
+            // Handle Y/N keys
+            const letter = (0, keyboard_js_1.normalizeLetter)(key);
+            if (letter === 'y') {
+                selected = true;
+                render();
+                return;
+            }
+            if (letter === 'n') {
+                selected = false;
+                render();
+                return;
+            }
+        };
+        state.stdin.on('data', onData);
+    });
+}

package/dist/components/menus/checkbox-menu.d.ts

@@ -0,0 +1,11 @@
+/**
+ * CheckboxMenu - Multi-select vertical menu component
+ * Allows user to select multiple options from a list
+ */
+import { CheckboxMenuConfig, CheckboxMenuResult } from '../../types/menu.types.js';
+/**
+ * Show a checkbox menu (multi-select)
+ * @param config - Menu configuration
+ * @returns Promise resolving to selected options
+ */
+export declare function showCheckboxMenu(config: CheckboxMenuConfig): Promise<CheckboxMenuResult>;

package/dist/components/menus/checkbox-menu.js

@@ -0,0 +1,161 @@
+"use strict";
+/**
+ * CheckboxMenu - Multi-select vertical menu component
+ * Allows user to select multiple options from a list
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.showCheckboxMenu = showCheckboxMenu;
+const layout_types_js_1 = require("../../types/layout.types.js");
+const terminal_js_1 = require("../../core/terminal.js");
+const keyboard_js_1 = require("../../core/keyboard.js");
+const renderer_js_1 = require("../../core/renderer.js");
+/**
+ * Show a checkbox menu (multi-select)
+ * @param config - Menu configuration
+ * @returns Promise resolving to selected options
+ */
+async function showCheckboxMenu(config) {
+    const { options, title, prompt = '空格选中/取消,回车确认', hints = ['↑↓ 方向键', '空格 选中/取消', 'A 全选', 'I 反选', '⏎ 确认'], layout = { ...layout_types_js_1.LAYOUT_PRESETS.SUB_MENU, order: ['input', 'options', 'hints'] }, defaultSelected = [], minSelections = 0, maxSelections, allowSelectAll = true, allowInvert = true, onExit } = config;
+    // Validate options
+    if (!options || options.length === 0) {
+        throw new Error('CheckboxMenu requires at least one option');
+    }
+    // Initialize state
+    let cursorIndex = 0;
+    const selected = new Set(defaultSelected);
+    const state = (0, terminal_js_1.initTerminal)();
+    // Extract option values
+    const optionValues = options.map(opt => typeof opt === 'string' ? opt : opt.label);
+    // Render function
+    const render = () => {
+        (0, terminal_js_1.clearMenu)(state);
+        let lineCount = 0;
+        // Render based on layout order
+        layout.order.forEach(element => {
+            // Add spacing before element
+            const spacingKey = `before${element.charAt(0).toUpperCase() + element.slice(1)}`;
+            if (layout.spacing?.[spacingKey]) {
+                (0, renderer_js_1.renderBlankLines)(layout.spacing[spacingKey]);
+                lineCount += layout.spacing[spacingKey];
+            }
+            switch (element) {
+                case 'input':
+                    if (layout.visible.input) {
+                        const selectedCount = selected.size;
+                        const displayValue = `${selectedCount} 项已选`;
+                        (0, renderer_js_1.renderInputPrompt)(prompt, displayValue);
+                        lineCount++;
+                    }
+                    break;
+                case 'options':
+                    optionValues.forEach((option, index) => {
+                        (0, renderer_js_1.renderOption)(option, selected.has(index), index === cursorIndex);
+                        lineCount++;
+                    });
+                    break;
+                case 'hints':
+                    if (layout.visible.hints && hints.length > 0) {
+                        (0, renderer_js_1.renderHints)(hints);
+                        lineCount++;
+                    }
+                    break;
+            }
+            // Add spacing after element
+            const afterSpacingKey = `after${element.charAt(0).toUpperCase() + element.slice(1)}`;
+            if (layout.spacing?.[afterSpacingKey]) {
+                (0, renderer_js_1.renderBlankLines)(layout.spacing[afterSpacingKey]);
+                lineCount += layout.spacing[afterSpacingKey];
+            }
+        });
+        state.renderedLines = lineCount;
+    };
+    // Initial render
+    render();
+    // Handle keyboard input
+    return new Promise((resolve) => {
+        const onData = (key) => {
+            // Handle Ctrl+C
+            if ((0, keyboard_js_1.isCtrlC)(key)) {
+                state.stdin.removeListener('data', onData);
+                (0, terminal_js_1.clearMenu)(state);
+                (0, terminal_js_1.restoreTerminal)(state);
+                if (onExit) {
+                    onExit();
+                }
+                else {
+                    console.log('\n👋 再见!');
+                }
+                process.exit(0);
+            }
+            // Handle Enter
+            if ((0, keyboard_js_1.isEnter)(key)) {
+                // Validate minimum selections
+                if (selected.size < minSelections) {
+                    // TODO: Show error message
+                    return;
+                }
+                state.stdin.removeListener('data', onData);
+                (0, terminal_js_1.clearMenu)(state);
+                (0, terminal_js_1.restoreTerminal)(state);
+                const indices = Array.from(selected).sort((a, b) => a - b);
+                const values = indices.map(i => {
+                    const option = options[i];
+                    return typeof option === 'string' ? option : option.value || option.label;
+                });
+                resolve({ indices, values });
+                return;
+            }
+            // Handle Space (toggle selection)
+            if ((0, keyboard_js_1.isSpace)(key)) {
+                if (selected.has(cursorIndex)) {
+                    selected.delete(cursorIndex);
+                }
+                else {
+                    // Check max selections
+                    if (!maxSelections || selected.size < maxSelections) {
+                        selected.add(cursorIndex);
+                    }
+                }
+                render();
+                return;
+            }
+            // Handle arrow keys
+            if (key === keyboard_js_1.KEY_CODES.UP) {
+                cursorIndex = cursorIndex > 0 ? cursorIndex - 1 : options.length - 1;
+                render();
+                return;
+            }
+            if (key === keyboard_js_1.KEY_CODES.DOWN) {
+                cursorIndex = cursorIndex < options.length - 1 ? cursorIndex + 1 : 0;
+                render();
+                return;
+            }
+            // Handle 'A' (select all)
+            if (allowSelectAll && (0, keyboard_js_1.normalizeLetter)(key) === 'a') {
+                if (!maxSelections || maxSelections >= options.length) {
+                    for (let i = 0; i < options.length; i++) {
+                        selected.add(i);
+                    }
+                    render();
+                }
+                return;
+            }
+            // Handle 'I' (invert selection)
+            if (allowInvert && (0, keyboard_js_1.normalizeLetter)(key) === 'i') {
+                const newSelected = new Set();
+                for (let i = 0; i < options.length; i++) {
+                    if (!selected.has(i)) {
+                        if (!maxSelections || newSelected.size < maxSelections) {
+                            newSelected.add(i);
+                        }
+                    }
+                }
+                selected.clear();
+                newSelected.forEach(i => selected.add(i));
+                render();
+                return;
+            }
+        };
+        state.stdin.on('data', onData);
+    });
+}

package/dist/components/menus/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Menu components index
+ * Exports all menu component functions
+ */
+export { showRadioMenu } from './radio-menu.js';
+export { showCheckboxMenu } from './checkbox-menu.js';
+export { showBooleanMenu } from './boolean-menu.js';

package/dist/components/menus/index.js

@@ -0,0 +1,13 @@
+"use strict";
+/**
+ * Menu components index
+ * Exports all menu component functions
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.showBooleanMenu = exports.showCheckboxMenu = exports.showRadioMenu = void 0;
+var radio_menu_js_1 = require("./radio-menu.js");
+Object.defineProperty(exports, "showRadioMenu", { enumerable: true, get: function () { return radio_menu_js_1.showRadioMenu; } });
+var checkbox_menu_js_1 = require("./checkbox-menu.js");
+Object.defineProperty(exports, "showCheckboxMenu", { enumerable: true, get: function () { return checkbox_menu_js_1.showCheckboxMenu; } });
+var boolean_menu_js_1 = require("./boolean-menu.js");
+Object.defineProperty(exports, "showBooleanMenu", { enumerable: true, get: function () { return boolean_menu_js_1.showBooleanMenu; } });

package/dist/components/menus/radio-menu.d.ts

@@ -0,0 +1,11 @@
+/**
+ * RadioMenu - Single-select vertical menu component
+ * Allows user to select one option from a list
+ */
+import { RadioMenuConfig, RadioMenuResult } from '../../types/menu.types.js';
+/**
+ * Show a radio menu (single-select)
+ * @param config - Menu configuration
+ * @returns Promise resolving to selected option
+ */
+export declare function showRadioMenu(config: RadioMenuConfig): Promise<RadioMenuResult>;

package/dist/components/menus/radio-menu.js

@@ -0,0 +1,158 @@
+"use strict";
+/**
+ * RadioMenu - Single-select vertical menu component
+ * Allows user to select one option from a list
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.showRadioMenu = showRadioMenu;
+const layout_types_js_1 = require("../../types/layout.types.js");
+const terminal_js_1 = require("../../core/terminal.js");
+const keyboard_js_1 = require("../../core/keyboard.js");
+const renderer_js_1 = require("../../core/renderer.js");
+const colors_js_1 = require("../../core/colors.js");
+/**
+ * Show a radio menu (single-select)
+ * @param config - Menu configuration
+ * @returns Promise resolving to selected option
+ */
+async function showRadioMenu(config) {
+    const { options, title, prompt = '输入选项或用↑↓选择,回车确认', hints = ['↑↓ 方向键', '0-9 输入序号', '⏎ 确认'], layout = layout_types_js_1.LAYOUT_PRESETS.MAIN_MENU, defaultIndex = 0, allowNumberKeys = true, allowLetterKeys = false, onExit } = config;
+    // Validate options
+    if (!options || options.length === 0) {
+        throw new Error('RadioMenu requires at least one option');
+    }
+    // Initialize state
+    let selectedIndex = Math.max(0, Math.min(defaultIndex, options.length - 1));
+    const state = (0, terminal_js_1.initTerminal)();
+    // Extract option values
+    const optionValues = options.map(opt => typeof opt === 'string' ? opt : opt.label);
+    // Render function
+    const render = () => {
+        (0, terminal_js_1.clearMenu)(state);
+        let lineCount = 0;
+        // Render based on layout order
+        layout.order.forEach(element => {
+            // Add spacing before element
+            const spacingKey = `before${element.charAt(0).toUpperCase() + element.slice(1)}`;
+            if (layout.spacing?.[spacingKey]) {
+                (0, renderer_js_1.renderBlankLines)(layout.spacing[spacingKey]);
+                lineCount += layout.spacing[spacingKey];
+            }
+            switch (element) {
+                case 'header':
+                    if (layout.visible.header && title) {
+                        (0, renderer_js_1.renderHeader)(`  ${title}`, colors_js_1.colors.cyan);
+                        lineCount++;
+                    }
+                    break;
+                case 'options':
+                    optionValues.forEach((option, index) => {
+                        // Extract number prefix if exists
+                        const match = option.match(/^(\d+)\.\s*/);
+                        const prefix = match ? '' : `${index + 1}. `;
+                        (0, renderer_js_1.renderOption)(option, false, index === selectedIndex, prefix);
+                        lineCount++;
+                    });
+                    break;
+                case 'input':
+                    if (layout.visible.input) {
+                        // Calculate display value (current selection number)
+                        let displayValue = '';
+                        const currentOption = optionValues[selectedIndex];
+                        const match = currentOption?.match(/^([^.]+)\./);
+                        if (match) {
+                            displayValue = match[1];
+                        }
+                        else {
+                            displayValue = String(selectedIndex + 1);
+                        }
+                        (0, renderer_js_1.renderInputPrompt)(prompt, displayValue);
+                        lineCount++;
+                    }
+                    break;
+                case 'hints':
+                    if (layout.visible.hints && hints.length > 0) {
+                        (0, renderer_js_1.renderHints)(hints);
+                        lineCount++;
+                    }
+                    break;
+            }
+            // Add spacing after element
+            const afterSpacingKey = `after${element.charAt(0).toUpperCase() + element.slice(1)}`;
+            if (layout.spacing?.[afterSpacingKey]) {
+                (0, renderer_js_1.renderBlankLines)(layout.spacing[afterSpacingKey]);
+                lineCount += layout.spacing[afterSpacingKey];
+            }
+        });
+        state.renderedLines = lineCount;
+    };
+    // Initial render
+    render();
+    // Handle keyboard input
+    return new Promise((resolve) => {
+        const onData = (key) => {
+            // Handle Ctrl+C
+            if ((0, keyboard_js_1.isCtrlC)(key)) {
+                state.stdin.removeListener('data', onData);
+                (0, terminal_js_1.clearMenu)(state);
+                (0, terminal_js_1.restoreTerminal)(state);
+                if (onExit) {
+                    onExit();
+                }
+                else {
+                    console.log('\n👋 再见!');
+                }
+                process.exit(0);
+            }
+            // Handle Enter
+            if ((0, keyboard_js_1.isEnter)(key)) {
+                state.stdin.removeListener('data', onData);
+                (0, terminal_js_1.clearMenu)(state);
+                (0, terminal_js_1.restoreTerminal)(state);
+                const selectedOption = options[selectedIndex];
+                const value = typeof selectedOption === 'string'
+                    ? selectedOption
+                    : selectedOption.value || selectedOption.label;
+                resolve({
+                    index: selectedIndex,
+                    value
+                });
+                return;
+            }
+            // Handle arrow keys
+            if (key === keyboard_js_1.KEY_CODES.UP) {
+                selectedIndex = selectedIndex > 0 ? selectedIndex - 1 : options.length - 1;
+                render();
+                return;
+            }
+            if (key === keyboard_js_1.KEY_CODES.DOWN) {
+                selectedIndex = selectedIndex < options.length - 1 ? selectedIndex + 1 : 0;
+                render();
+                return;
+            }
+            // Handle number keys
+            if (allowNumberKeys && (0, keyboard_js_1.isNumberKey)(key)) {
+                const num = parseInt(key, 10);
+                if (num > 0 && num <= options.length) {
+                    selectedIndex = num - 1;
+                    render();
+                }
+                return;
+            }
+            // Handle letter keys
+            if (allowLetterKeys && (0, keyboard_js_1.isLetterKey)(key)) {
+                const letter = (0, keyboard_js_1.normalizeLetter)(key);
+                const index = optionValues.findIndex(opt => {
+                    const match = opt.match(/^([a-zA-Z])\./i);
+                    return match && match[1].toLowerCase() === letter;
+                });
+                if (index !== -1) {
+                    selectedIndex = index;
+                    render();
+                }
+                return;
+            }
+        };
+        state.stdin.on('data', onData);
+    });
+}

package/dist/components.d.ts

@@ -0,0 +1,55 @@
+/**
+ * CLI Menu Kit - UI Components
+ * Handles all display-related UI components
+ */
+import { Colors, Theme, Symbols, HintKey } from './types';
+export declare const colors: Colors;
+export declare const theme: Theme;
+export declare const symbols: Symbols;
+/**
+ * Format section title with separator
+ */
+export declare function formatSection(text: string): string;
+/**
+ * Build hint text for interactive menus
+ */
+export declare function buildHint(keys: HintKey[], lang?: 'zh' | 'en'): string;
+/**
+ * Show submenu title with section format
+ */
+export declare function showSubMenuTitle(title: string, lang: 'zh' | 'en', indent?: string): void;
+/**
+ * Show progress indicator
+ */
+export declare function showProgress(steps: string[], currentStep: number, lang: 'zh' | 'en', indent?: string): void;
+/**
+ * Show info message
+ */
+export declare function showInfo(message: string, indent?: string): void;
+/**
+ * Show success message
+ */
+export declare function showSuccess(message: string, indent?: string): void;
+/**
+ * Show error message
+ */
+export declare function showError(message: string, indent?: string): void;
+/**
+ * Show warning message
+ */
+export declare function showWarning(message: string, indent?: string): void;
+/**
+ * Show goodbye message
+ */
+export declare function showGoodbye(lang?: 'zh' | 'en'): void;
+/**
+ * Print header with ASCII art
+ */
+export interface HeaderOptions {
+    asciiArt: string[];
+    title: string;
+    subtitle?: string;
+    version?: string;
+    github?: string;
+}
+export declare function printHeader(options: HeaderOptions): void;