cli-menu-kit 0.1.0

package/dist/index.js

@@ -0,0 +1,104 @@
+"use strict";
+/**
+ * CLI Menu Kit - Main Entry Point
+ * A comprehensive, modular menu system for Node.js CLI applications
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.applyGradient = exports.createGradient = exports.colors = exports.getCurrentLanguageMap = exports.getAvailableLanguages = exports.registerLanguage = exports.t = exports.setLanguage = exports.getCurrentLanguage = exports.showCommandHelp = exports.getAvailableCommands = exports.handleCommand = exports.parseCommand = exports.isCommand = exports.clearCustomCommands = exports.unregisterCommand = exports.registerCommand = exports.createWizard = exports.runWizard = exports.createSimpleSummary = exports.createSummaryTable = exports.renderSummaryTable = exports.createMessage = exports.showQuestion = exports.showInfo = exports.showWarning = exports.showError = exports.showSuccess = exports.renderMessage = exports.createStageSeparator = exports.createStageHeader = exports.createProgressIndicator = exports.renderStageSeparator = exports.renderStageHeader = exports.renderProgressIndicator = exports.createAsciiHeader = exports.createSimpleHeader = exports.renderAsciiHeader = exports.renderSimpleHeader = exports.showModifyField = exports.showLanguageSelector = exports.showNumberInput = exports.showTextInput = exports.showBooleanMenu = exports.showCheckboxMenu = exports.showRadioMenu = exports.default = exports.wizard = exports.input = exports.menu = void 0;
+exports.LAYOUT_PRESETS = exports.KEY_CODES = exports.colorize = void 0;
+// Export unified API
+var api_js_1 = require("./api.js");
+Object.defineProperty(exports, "menu", { enumerable: true, get: function () { return api_js_1.menuAPI; } });
+Object.defineProperty(exports, "input", { enumerable: true, get: function () { return api_js_1.inputAPI; } });
+Object.defineProperty(exports, "wizard", { enumerable: true, get: function () { return api_js_1.wizardAPI; } });
+var api_js_2 = require("./api.js");
+Object.defineProperty(exports, "default", { enumerable: true, get: function () { return __importDefault(api_js_2).default; } });
+// Export menu components
+var index_js_1 = require("./components/menus/index.js");
+Object.defineProperty(exports, "showRadioMenu", { enumerable: true, get: function () { return index_js_1.showRadioMenu; } });
+Object.defineProperty(exports, "showCheckboxMenu", { enumerable: true, get: function () { return index_js_1.showCheckboxMenu; } });
+Object.defineProperty(exports, "showBooleanMenu", { enumerable: true, get: function () { return index_js_1.showBooleanMenu; } });
+// Export input components
+var index_js_2 = require("./components/inputs/index.js");
+Object.defineProperty(exports, "showTextInput", { enumerable: true, get: function () { return index_js_2.showTextInput; } });
+Object.defineProperty(exports, "showNumberInput", { enumerable: true, get: function () { return index_js_2.showNumberInput; } });
+Object.defineProperty(exports, "showLanguageSelector", { enumerable: true, get: function () { return index_js_2.showLanguageSelector; } });
+Object.defineProperty(exports, "showModifyField", { enumerable: true, get: function () { return index_js_2.showModifyField; } });
+// Export display components
+var index_js_3 = require("./components/display/index.js");
+Object.defineProperty(exports, "renderSimpleHeader", { enumerable: true, get: function () { return index_js_3.renderSimpleHeader; } });
+Object.defineProperty(exports, "renderAsciiHeader", { enumerable: true, get: function () { return index_js_3.renderAsciiHeader; } });
+Object.defineProperty(exports, "createSimpleHeader", { enumerable: true, get: function () { return index_js_3.createSimpleHeader; } });
+Object.defineProperty(exports, "createAsciiHeader", { enumerable: true, get: function () { return index_js_3.createAsciiHeader; } });
+Object.defineProperty(exports, "renderProgressIndicator", { enumerable: true, get: function () { return index_js_3.renderProgressIndicator; } });
+Object.defineProperty(exports, "renderStageHeader", { enumerable: true, get: function () { return index_js_3.renderStageHeader; } });
+Object.defineProperty(exports, "renderStageSeparator", { enumerable: true, get: function () { return index_js_3.renderStageSeparator; } });
+Object.defineProperty(exports, "createProgressIndicator", { enumerable: true, get: function () { return index_js_3.createProgressIndicator; } });
+Object.defineProperty(exports, "createStageHeader", { enumerable: true, get: function () { return index_js_3.createStageHeader; } });
+Object.defineProperty(exports, "createStageSeparator", { enumerable: true, get: function () { return index_js_3.createStageSeparator; } });
+Object.defineProperty(exports, "renderMessage", { enumerable: true, get: function () { return index_js_3.renderMessage; } });
+Object.defineProperty(exports, "showSuccess", { enumerable: true, get: function () { return index_js_3.showSuccess; } });
+Object.defineProperty(exports, "showError", { enumerable: true, get: function () { return index_js_3.showError; } });
+Object.defineProperty(exports, "showWarning", { enumerable: true, get: function () { return index_js_3.showWarning; } });
+Object.defineProperty(exports, "showInfo", { enumerable: true, get: function () { return index_js_3.showInfo; } });
+Object.defineProperty(exports, "showQuestion", { enumerable: true, get: function () { return index_js_3.showQuestion; } });
+Object.defineProperty(exports, "createMessage", { enumerable: true, get: function () { return index_js_3.createMessage; } });
+Object.defineProperty(exports, "renderSummaryTable", { enumerable: true, get: function () { return index_js_3.renderSummaryTable; } });
+Object.defineProperty(exports, "createSummaryTable", { enumerable: true, get: function () { return index_js_3.createSummaryTable; } });
+Object.defineProperty(exports, "createSimpleSummary", { enumerable: true, get: function () { return index_js_3.createSimpleSummary; } });
+// Export features
+var wizard_js_1 = require("./features/wizard.js");
+Object.defineProperty(exports, "runWizard", { enumerable: true, get: function () { return wizard_js_1.runWizard; } });
+Object.defineProperty(exports, "createWizard", { enumerable: true, get: function () { return wizard_js_1.createWizard; } });
+var commands_js_1 = require("./features/commands.js");
+Object.defineProperty(exports, "registerCommand", { enumerable: true, get: function () { return commands_js_1.registerCommand; } });
+Object.defineProperty(exports, "unregisterCommand", { enumerable: true, get: function () { return commands_js_1.unregisterCommand; } });
+Object.defineProperty(exports, "clearCustomCommands", { enumerable: true, get: function () { return commands_js_1.clearCustomCommands; } });
+Object.defineProperty(exports, "isCommand", { enumerable: true, get: function () { return commands_js_1.isCommand; } });
+Object.defineProperty(exports, "parseCommand", { enumerable: true, get: function () { return commands_js_1.parseCommand; } });
+Object.defineProperty(exports, "handleCommand", { enumerable: true, get: function () { return commands_js_1.handleCommand; } });
+Object.defineProperty(exports, "getAvailableCommands", { enumerable: true, get: function () { return commands_js_1.getAvailableCommands; } });
+Object.defineProperty(exports, "showCommandHelp", { enumerable: true, get: function () { return commands_js_1.showCommandHelp; } });
+// Export i18n
+var registry_js_1 = require("./i18n/registry.js");
+Object.defineProperty(exports, "getCurrentLanguage", { enumerable: true, get: function () { return registry_js_1.getCurrentLanguage; } });
+Object.defineProperty(exports, "setLanguage", { enumerable: true, get: function () { return registry_js_1.setLanguage; } });
+Object.defineProperty(exports, "t", { enumerable: true, get: function () { return registry_js_1.t; } });
+Object.defineProperty(exports, "registerLanguage", { enumerable: true, get: function () { return registry_js_1.registerLanguage; } });
+Object.defineProperty(exports, "getAvailableLanguages", { enumerable: true, get: function () { return registry_js_1.getAvailableLanguages; } });
+Object.defineProperty(exports, "getCurrentLanguageMap", { enumerable: true, get: function () { return registry_js_1.getCurrentLanguageMap; } });
+// Export core utilities (for advanced users)
+var colors_js_1 = require("./core/colors.js");
+Object.defineProperty(exports, "colors", { enumerable: true, get: function () { return colors_js_1.colors; } });
+Object.defineProperty(exports, "createGradient", { enumerable: true, get: function () { return colors_js_1.createGradient; } });
+Object.defineProperty(exports, "applyGradient", { enumerable: true, get: function () { return colors_js_1.applyGradient; } });
+Object.defineProperty(exports, "colorize", { enumerable: true, get: function () { return colors_js_1.colorize; } });
+var keyboard_js_1 = require("./core/keyboard.js");
+Object.defineProperty(exports, "KEY_CODES", { enumerable: true, get: function () { return keyboard_js_1.KEY_CODES; } });
+var layout_types_js_1 = require("./types/layout.types.js");
+Object.defineProperty(exports, "LAYOUT_PRESETS", { enumerable: true, get: function () { return layout_types_js_1.LAYOUT_PRESETS; } });
+// Legacy exports (for backward compatibility)
+__exportStar(require("./types"), exports);
+__exportStar(require("./components"), exports);
+__exportStar(require("./menu-core"), exports);
+__exportStar(require("./menu-single"), exports);
+__exportStar(require("./menu-multi"), exports);
+__exportStar(require("./input"), exports);
+__exportStar(require("./menu"), exports);

package/dist/input.d.ts

@@ -0,0 +1,40 @@
+/**
+ * CLI Menu Kit - Input Components
+ * Handles user input interactions
+ */
+export interface InputOptions {
+    lang?: 'zh' | 'en';
+    defaultValue?: string;
+    indent?: string;
+    validator?: (input: string) => boolean | string;
+}
+/**
+ * Ask for user text input with optional default value and validation
+ *
+ * @param prompt - Prompt text
+ * @param options - Input options
+ * @returns User input or default value
+ */
+export declare function askInput(prompt: string, options?: InputOptions): Promise<string>;
+/**
+ * Ask Yes/No question with interactive selection
+ *
+ * @param prompt - Question prompt
+ * @param options - Options
+ * @returns true for Yes, false for No
+ */
+export declare function askYesNo(prompt: string, options?: {
+    lang?: 'zh' | 'en';
+    defaultYes?: boolean;
+}): Promise<boolean>;
+/**
+ * Ask for number input with validation
+ *
+ * @param prompt - Prompt text
+ * @param options - Input options
+ * @returns Number input
+ */
+export declare function askNumber(prompt: string, options?: InputOptions & {
+    min?: number;
+    max?: number;
+}): Promise<number>;

package/dist/input.js

@@ -0,0 +1,211 @@
+"use strict";
+/**
+ * CLI Menu Kit - Input Components
+ * Handles user input interactions
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.askInput = askInput;
+exports.askYesNo = askYesNo;
+exports.askNumber = askNumber;
+const components_1 = require("./components");
+/**
+ * Ask for user text input with optional default value and validation
+ *
+ * @param prompt - Prompt text
+ * @param options - Input options
+ * @returns User input or default value
+ */
+async function askInput(prompt, options = {}) {
+    const { lang = 'zh', defaultValue = '', indent = '  ', validator } = options;
+    return new Promise((resolve) => {
+        const stdin = process.stdin;
+        const stdout = process.stdout;
+        // Show prompt with grayed default value hint
+        const promptLine = `${indent}${prompt}: `;
+        const defaultHint = defaultValue
+            ? `${components_1.theme.muted}(${lang === 'zh' ? '默认' : 'default'}: ${defaultValue})${components_1.colors.reset} `
+            : '';
+        stdout.write(promptLine);
+        stdout.write(defaultHint);
+        // Hide cursor to avoid visual artifacts
+        stdout.write('\x1b[?25l');
+        let input = '';
+        stdin.setRawMode(true);
+        stdin.resume();
+        stdin.setEncoding('utf8');
+        const onData = (key) => {
+            // Ctrl+C
+            if (key === '\u0003') {
+                stdin.setRawMode(false);
+                stdin.removeListener('data', onData);
+                // Clear current line
+                stdout.write('\r\x1b[K');
+                // Show cursor
+                stdout.write('\x1b[?25h');
+                // Show goodbye message
+                (0, components_1.showGoodbye)(lang);
+                process.exit(0);
+            }
+            // Enter
+            if (key === '\r' || key === '\n') {
+                const result = input.trim() || defaultValue;
+                // Validate if validator provided
+                if (validator) {
+                    const validationResult = validator(result);
+                    if (validationResult !== true) {
+                        // Show error and continue input
+                        const errorMsg = typeof validationResult === 'string'
+                            ? validationResult
+                            : (lang === 'zh' ? '输入无效' : 'Invalid input');
+                        stdout.write(`\n${indent}${components_1.colors.red}${errorMsg}${components_1.colors.reset}\n`);
+                        stdout.write(promptLine);
+                        stdout.write(defaultHint);
+                        stdout.write(' ');
+                        stdout.write(input);
+                        return;
+                    }
+                }
+                stdin.setRawMode(false);
+                stdin.removeListener('data', onData);
+                // Clear the entire input line
+                stdout.write('\r\x1b[K');
+                // Show cursor
+                stdout.write('\x1b[?25h');
+                resolve(result);
+                return;
+            }
+            // Backspace / Delete
+            if (key === '\u007F' || key === '\b') {
+                if (input.length > 0) {
+                    input = input.slice(0, -1);
+                    // Clear line and redraw
+                    stdout.write('\r\x1b[K');
+                    stdout.write(promptLine);
+                    stdout.write(defaultHint);
+                    stdout.write(' ');
+                    stdout.write(input);
+                }
+                return;
+            }
+            // Ignore escape sequences (arrow keys, etc.)
+            if (key.charCodeAt(0) === 27) {
+                return;
+            }
+            // Normal character input
+            if (key.charCodeAt(0) >= 32) {
+                input += key;
+                // Clear line and redraw to handle multi-byte characters properly
+                stdout.write('\r\x1b[K');
+                stdout.write(promptLine);
+                stdout.write(defaultHint);
+                stdout.write(' ');
+                stdout.write(input);
+            }
+        };
+        stdin.on('data', onData);
+    });
+}
+/**
+ * Ask Yes/No question with interactive selection
+ *
+ * @param prompt - Question prompt
+ * @param options - Options
+ * @returns true for Yes, false for No
+ */
+async function askYesNo(prompt, options = {}) {
+    const { lang = 'zh', defaultYes = true } = options;
+    const optionLabels = lang === 'zh' ? ['是', '否'] : ['Yes', 'No'];
+    return new Promise((resolve) => {
+        let selectedIndex = defaultYes ? 0 : 1;
+        const stdin = process.stdin;
+        stdin.setRawMode(true);
+        stdin.resume();
+        stdin.setEncoding('utf8');
+        // Hide cursor
+        process.stdout.write('\x1b[?25l');
+        const render = () => {
+            // Clear current line
+            process.stdout.write('\r\x1b[K');
+            // Render prompt with question symbol
+            process.stdout.write(`  ${components_1.symbols.warning.color}${components_1.symbols.warning.icon} ${components_1.colors.reset}${prompt} `);
+            // Render options
+            optionLabels.forEach((option, index) => {
+                const isSelected = index === selectedIndex;
+                if (isSelected) {
+                    process.stdout.write(`${components_1.theme.active}${option}${components_1.colors.reset}`);
+                }
+                else {
+                    process.stdout.write(`${components_1.theme.muted}${option}${components_1.colors.reset}`);
+                }
+                if (index < optionLabels.length - 1) {
+                    process.stdout.write(` ${components_1.theme.muted}|${components_1.colors.reset} `);
+                }
+            });
+        };
+        const cleanup = (result) => {
+            stdin.setRawMode(false);
+            stdin.removeListener('data', onKeyPress);
+            process.stdout.write('\r\x1b[K'); // Clear current line
+            process.stdout.write('\x1b[?25h'); // Show cursor
+            resolve(result);
+        };
+        const onKeyPress = (key) => {
+            if (key === '\u001b[C') { // Right arrow
+                selectedIndex = (selectedIndex + 1) % optionLabels.length;
+                render();
+            }
+            else if (key === '\u001b[D') { // Left arrow
+                selectedIndex = (selectedIndex - 1 + optionLabels.length) % optionLabels.length;
+                render();
+            }
+            else if (key === '\r') { // Enter
+                cleanup(selectedIndex === 0); // 0 = Yes/是, 1 = No/否
+            }
+            else if (key === '\u001b' || key === '\u001b[') { // Esc
+                cleanup(false); // Default to No on Esc
+            }
+            else if (key === '\u0003') { // Ctrl+C
+                stdin.setRawMode(false);
+                stdin.removeListener('data', onKeyPress);
+                // Clear current line
+                process.stdout.write('\r\x1b[K');
+                // Show cursor
+                process.stdout.write('\x1b[?25h');
+                // Show goodbye message
+                (0, components_1.showGoodbye)(lang);
+                process.exit(0);
+            }
+            else {
+                // Ignore all other keys - re-render to clear any echo
+                render();
+            }
+        };
+        stdin.on('data', onKeyPress);
+        render();
+    });
+}
+/**
+ * Ask for number input with validation
+ *
+ * @param prompt - Prompt text
+ * @param options - Input options
+ * @returns Number input
+ */
+async function askNumber(prompt, options = {}) {
+    const { lang = 'zh', min, max } = options;
+    const validator = (input) => {
+        const num = parseFloat(input);
+        if (isNaN(num)) {
+            return lang === 'zh' ? '请输入有效的数字' : 'Please enter a valid number';
+        }
+        if (min !== undefined && num < min) {
+            return lang === 'zh' ? `数字不能小于 ${min}` : `Number cannot be less than ${min}`;
+        }
+        if (max !== undefined && num > max) {
+            return lang === 'zh' ? `数字不能大于 ${max}` : `Number cannot be greater than ${max}`;
+        }
+        return true;
+    };
+    const result = await askInput(prompt, { ...options, validator });
+    return parseFloat(result);
+}

package/dist/menu-core.d.ts

@@ -0,0 +1,52 @@
+/**
+ * CLI Menu Kit - Core Utilities
+ * Shared rendering and terminal control functions
+ */
+/**
+ * Terminal control utilities
+ */
+export interface TerminalState {
+    stdin: NodeJS.ReadStream;
+    renderedLines: number;
+    isFirstRender: boolean;
+}
+export declare function setupTerminal(): TerminalState;
+export declare function cleanupTerminal(state: TerminalState, onData: (key: string) => void): void;
+export declare function moveCursorUp(state: TerminalState): void;
+/**
+ * Header rendering
+ */
+export declare function renderHeader(title: string | undefined): number;
+/**
+ * Option rendering for single-select menus
+ */
+export interface RenderOptionConfig {
+    index: number;
+    isSelected: boolean;
+    showNumber?: boolean;
+}
+export declare function renderSingleOption(option: string | {
+    label: string;
+    value?: any;
+}, config: RenderOptionConfig): void;
+/**
+ * Keyboard navigation helpers
+ */
+export declare function handleVerticalNavigation(key: string, currentIndex: number, maxIndex: number): number | null;
+export declare function handleNumberInput(key: string, maxNumber: number): number | null;
+export declare function handleLetterInput(key: string, options: Array<string | {
+    label: string;
+    value?: any;
+}>): number | null;
+/**
+ * Input prompt rendering
+ */
+export declare function renderInputPrompt(text: string, showCursor?: boolean): void;
+/**
+ * Hints rendering
+ */
+export declare function renderHints(hintText: string): number;
+/**
+ * Graceful exit with goodbye message
+ */
+export declare function exitWithGoodbye(state: TerminalState, onData: (key: string) => void, showGoodbyeFn: () => void): void;

package/dist/menu-core.js

@@ -0,0 +1,201 @@
+"use strict";
+/**
+ * CLI Menu Kit - Core Utilities
+ * Shared rendering and terminal control functions
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setupTerminal = setupTerminal;
+exports.cleanupTerminal = cleanupTerminal;
+exports.moveCursorUp = moveCursorUp;
+exports.renderHeader = renderHeader;
+exports.renderSingleOption = renderSingleOption;
+exports.handleVerticalNavigation = handleVerticalNavigation;
+exports.handleNumberInput = handleNumberInput;
+exports.handleLetterInput = handleLetterInput;
+exports.renderInputPrompt = renderInputPrompt;
+exports.renderHints = renderHints;
+exports.exitWithGoodbye = exitWithGoodbye;
+const components_1 = require("./components");
+function setupTerminal() {
+    const stdin = process.stdin;
+    stdin.setRawMode(true);
+    stdin.resume();
+    stdin.setEncoding('utf8');
+    // Hide cursor
+    process.stdout.write('\x1b[?25l');
+    return {
+        stdin,
+        renderedLines: 0,
+        isFirstRender: true
+    };
+}
+function cleanupTerminal(state, onData) {
+    state.stdin.setRawMode(false);
+    state.stdin.removeListener('data', onData);
+    // Clear rendered content
+    if (state.renderedLines > 0) {
+        process.stdout.write(`\x1b[${state.renderedLines}A`);
+        process.stdout.write('\x1b[J');
+    }
+    // Show cursor
+    process.stdout.write('\x1b[?25h');
+}
+function moveCursorUp(state) {
+    if (!state.isFirstRender && state.renderedLines > 0) {
+        process.stdout.write(`\x1b[${state.renderedLines}A`);
+    }
+}
+/**
+ * Header rendering
+ */
+function renderHeader(title) {
+    if (!title)
+        return 0;
+    const titleLines = title.split('\n');
+    titleLines.forEach(line => {
+        process.stdout.write('\x1b[2K\r');
+        console.log(`  ${components_1.theme.primary}${line}${components_1.colors.reset}`);
+    });
+    process.stdout.write('\x1b[2K');
+    console.log();
+    return titleLines.length + 1; // +1 for empty line
+}
+function renderSingleOption(option, config) {
+    const { index, isSelected, showNumber = true } = config;
+    process.stdout.write('\x1b[2K\r');
+    const prefix = isSelected ? `${components_1.theme.active}❯ ` : '  ';
+    const numColor = isSelected ? components_1.theme.active : components_1.theme.primary;
+    const titleColor = isSelected ? components_1.theme.active : components_1.theme.title;
+    if (typeof option === 'string') {
+        // Check if option already has number prefix
+        const numMatch = option.match(/^(\d+\.\s*)(.+)$/);
+        if (numMatch) {
+            const num = numMatch[1];
+            const rest = numMatch[2];
+            const descMatch = rest.match(/^([^-]+)(\s*-\s*.+)?$/);
+            if (descMatch && descMatch[2]) {
+                const title = descMatch[1];
+                const desc = descMatch[2];
+                console.log(`${prefix}${numColor}${num}${titleColor}${title}${components_1.theme.muted}${desc}${components_1.colors.reset}`);
+            }
+            else {
+                console.log(`${prefix}${numColor}${num}${titleColor}${rest}${components_1.colors.reset}`);
+            }
+        }
+        else {
+            // No number prefix, add one if showNumber is true
+            const match = option.match(/^([^-]+)(\s*-\s*.+)?$/);
+            if (match && match[2]) {
+                const title = match[1];
+                const desc = match[2];
+                const numPrefix = showNumber ? `${numColor}${index + 1}.${components_1.colors.reset} ` : '';
+                console.log(`${prefix}${numPrefix}${titleColor}${title}${components_1.theme.muted}${desc}${components_1.colors.reset}`);
+            }
+            else {
+                const numPrefix = showNumber ? `${numColor}${index + 1}.${components_1.colors.reset} ` : '';
+                console.log(`${prefix}${numPrefix}${titleColor}${option}${components_1.colors.reset}`);
+            }
+        }
+    }
+    else if (option.label) {
+        // Handle MenuOption objects
+        const match = option.label.match(/^([^.]+\.\s*)([^-]+)(\s*-\s*.+)?$/);
+        if (match) {
+            const num = match[1];
+            const title = match[2];
+            const desc = match[3] || '';
+            console.log(`${prefix}${numColor}${num}${titleColor}${title}${components_1.theme.muted}${desc}${components_1.colors.reset}`);
+        }
+        else {
+            const numPrefix = showNumber ? `${numColor}${index + 1}.${components_1.colors.reset} ` : '';
+            console.log(`${prefix}${numPrefix}${titleColor}${option.label}${components_1.colors.reset}`);
+        }
+    }
+}
+/**
+ * Keyboard navigation helpers
+ */
+function handleVerticalNavigation(key, currentIndex, maxIndex) {
+    if (key === '\u001b[A') {
+        // Up arrow
+        return currentIndex > 0 ? currentIndex - 1 : maxIndex;
+    }
+    else if (key === '\u001b[B') {
+        // Down arrow
+        return currentIndex < maxIndex ? currentIndex + 1 : 0;
+    }
+    return null;
+}
+function handleNumberInput(key, maxNumber) {
+    if (key.match(/^[0-9]$/)) {
+        const num = parseInt(key);
+        if (num >= 1 && num <= maxNumber) {
+            return num - 1; // Convert to 0-based index
+        }
+    }
+    return null;
+}
+function handleLetterInput(key, options) {
+    if (key.match(/^[a-zA-Z]$/)) {
+        const letter = key.toUpperCase();
+        for (let i = 0; i < options.length; i++) {
+            const option = options[i];
+            if (typeof option !== 'string' && option.label) {
+                const match = option.label.match(/^([A-Z])\./);
+                if (match && match[1] === letter) {
+                    return i;
+                }
+            }
+        }
+    }
+    return null;
+}
+/**
+ * Input prompt rendering
+ */
+function renderInputPrompt(text, showCursor = true) {
+    process.stdout.write('\x1b[2K');
+    console.log();
+    process.stdout.write('\x1b[2K\r');
+    process.stdout.write(`  ${components_1.theme.muted}${text}${components_1.colors.reset}`);
+    if (showCursor) {
+        process.stdout.write(`${components_1.theme.active}_${components_1.colors.reset}`);
+    }
+    console.log();
+}
+/**
+ * Hints rendering
+ */
+function renderHints(hintText) {
+    if (!hintText)
+        return 0;
+    process.stdout.write('\x1b[2K');
+    console.log();
+    const indent = '  ';
+    const indentedHint = hintText.split('\n').map(line => indent + line).join('\n');
+    const hintLinesArray = indentedHint.split('\n');
+    hintLinesArray.forEach(line => {
+        process.stdout.write('\x1b[2K\r');
+        console.log(line);
+    });
+    return 1 + hintLinesArray.length; // +1 for empty line before hints
+}
+/**
+ * Graceful exit with goodbye message
+ */
+function exitWithGoodbye(state, onData, showGoodbyeFn) {
+    // Clean up terminal
+    state.stdin.setRawMode(false);
+    state.stdin.removeListener('data', onData);
+    // Clear rendered content
+    if (state.renderedLines > 0) {
+        process.stdout.write(`\x1b[${state.renderedLines}A`);
+        process.stdout.write('\x1b[J');
+    }
+    // Show cursor
+    process.stdout.write('\x1b[?25h');
+    // Show goodbye message
+    showGoodbyeFn();
+    // Exit
+    process.exit(0);
+}

package/dist/menu-multi.d.ts

@@ -0,0 +1,21 @@
+/**
+ * CLI Menu Kit - Multi Select Menu
+ * Interactive multi-select menu with checkboxes
+ */
+import { MultiSelectConfig } from './types';
+/**
+ * Interactive multi-select menu with checkboxes
+ *
+ * Features:
+ * - Arrow keys (↑/↓) to navigate
+ * - Space to toggle selection
+ * - A to select all
+ * - I to invert selection
+ * - Enter to confirm
+ * - Shows ◉ for selected items, ○ for unselected items
+ *
+ * @param options - Menu options
+ * @param config - Configuration object
+ * @returns Array of selected indices
+ */
+export declare function selectMultiMenu(options: string[], config?: MultiSelectConfig): Promise<number[]>;