cli-menu-kit 0.1.26 → 0.2.1

package/dist/components/inputs/number-input.js

@@ -8,13 +8,15 @@ exports.showNumberInput = showNumberInput;
 const terminal_js_1 = require("../../core/terminal.js");
 const keyboard_js_1 = require("../../core/keyboard.js");
 const colors_js_1 = require("../../core/colors.js");
+const registry_js_1 = require("../../i18n/registry.js");
 /**
  * Show a number input prompt
  * @param config - Input configuration
  * @returns Promise resolving to entered number
  */
 async function showNumberInput(config) {
-    const { prompt, defaultValue, min, max, allowDecimals = false, allowNegative = false, validate, errorMessage, onExit } = config;
+    const { lang: langInput, prompt, defaultValue, min, max, allowDecimals = false, allowNegative = false, validate, errorMessage, onExit, preserveOnExit = false } = config;
+    const lang = langInput ?? (0, registry_js_1.getCurrentLanguage)();
     const state = (0, terminal_js_1.initTerminal)();
     let inputValue = '';
     let errorMsg = '';
@@ -26,20 +28,21 @@ async function showNumberInput(config) {
         if (min !== undefined || max !== undefined) {
             const constraints = [];
             if (min !== undefined)
-                constraints.push(`最小: ${min}`);
+                constraints.push(`${(0, registry_js_1.t)('inputs.minValue')}: ${min}`);
             if (max !== undefined)
-                constraints.push(`最大: ${max}`);
-            promptLine += ` ${colors_js_1.colors.dim}(${constraints.join(', ')})${colors_js_1.colors.reset}`;
+                constraints.push(`${(0, registry_js_1.t)('inputs.maxValue')}: ${max}`);
+            promptLine += ` ${colors_js_1.uiColors.textSecondary}(${constraints.join(', ')})${colors_js_1.colors.reset}`;
         }
         if (defaultValue !== undefined && !inputValue) {
-            promptLine += ` ${colors_js_1.colors.dim}(默认: ${defaultValue})${colors_js_1.colors.reset}`;
+            const defaultLabel = lang === 'en' ? 'default' : (0, registry_js_1.t)('inputs.defaultValue');
+            promptLine += ` ${colors_js_1.uiColors.textSecondary}(${defaultLabel}: ${defaultValue})${colors_js_1.colors.reset}`;
         }
-        promptLine += `: ${colors_js_1.colors.cyan}${inputValue}_${colors_js_1.colors.reset}`;
+        promptLine += `: ${colors_js_1.uiColors.primary}${inputValue}_${colors_js_1.colors.reset}`;
         (0, terminal_js_1.writeLine)(promptLine);
         lineCount++;
         // Render error message if any
         if (errorMsg) {
-            (0, terminal_js_1.writeLine)(`  ${colors_js_1.colors.red}✗ ${errorMsg}${colors_js_1.colors.reset}`);
+            (0, terminal_js_1.writeLine)(`  ${colors_js_1.uiColors.error}✗ ${errorMsg}${colors_js_1.colors.reset}`);
             lineCount++;
         }
         state.renderedLines = lineCount;
@@ -52,13 +55,15 @@ async function showNumberInput(config) {
             // Handle Ctrl+C
             if ((0, keyboard_js_1.isCtrlC)(key)) {
                 state.stdin.removeListener('data', onData);
-                (0, terminal_js_1.clearMenu)(state);
+                if (!preserveOnExit) {
+                    (0, terminal_js_1.clearMenu)(state);
+                }
                 (0, terminal_js_1.restoreTerminal)(state);
                 if (onExit) {
                     onExit();
                 }
                 else {
-                    console.log('\n👋 再见!');
+                    console.log(`\n${(0, registry_js_1.t)('messages.goodbye')}`);
                 }
                 process.exit(0);
             }
@@ -67,7 +72,7 @@ async function showNumberInput(config) {
                 const finalValue = inputValue || (defaultValue !== undefined ? String(defaultValue) : '');
                 // Check if empty
                 if (!finalValue) {
-                    errorMsg = errorMessage || '请输入数字';
+                    errorMsg = errorMessage || (0, registry_js_1.t)('inputs.enterNumber');
                     render();
                     return;
                 }
@@ -75,19 +80,19 @@ async function showNumberInput(config) {
                 const num = allowDecimals ? parseFloat(finalValue) : parseInt(finalValue, 10);
                 // Check if valid number
                 if (isNaN(num)) {
-                    errorMsg = errorMessage || '输入必须是有效的数字';
+                    errorMsg = errorMessage || (0, registry_js_1.t)('inputs.invalidInput');
                     render();
                     return;
                 }
                 // Check min
                 if (min !== undefined && num < min) {
-                    errorMsg = errorMessage || `数字不能小于 ${min}`;
+                    errorMsg = errorMessage || `${(0, registry_js_1.t)('inputs.minValue')}: ${min}`;
                     render();
                     return;
                 }
                 // Check max
                 if (max !== undefined && num > max) {
-                    errorMsg = errorMessage || `数字不能大于 ${max}`;
+                    errorMsg = errorMessage || `${(0, registry_js_1.t)('inputs.maxValue')}: ${max}`;
                     render();
                     return;
                 }
@@ -95,7 +100,7 @@ async function showNumberInput(config) {
                 if (validate) {
                     const validationResult = validate(String(num));
                     if (validationResult !== true) {
-                        errorMsg = typeof validationResult === 'string' ? validationResult : (errorMessage || '输入无效');
+                        errorMsg = typeof validationResult === 'string' ? validationResult : (errorMessage || (0, registry_js_1.t)('inputs.invalidInput'));
                         render();
                         return;
                     }

package/dist/components/inputs/text-input.js

@@ -8,13 +8,36 @@ exports.showTextInput = showTextInput;
 const terminal_js_1 = require("../../core/terminal.js");
 const keyboard_js_1 = require("../../core/keyboard.js");
 const colors_js_1 = require("../../core/colors.js");
+const registry_js_1 = require("../../i18n/registry.js");
+/**
+ * Normalize a terminal data chunk to printable text.
+ * Supports bracketed paste and ignores control/escape sequences.
+ */
+function normalizeTextChunk(raw) {
+    if (!raw) {
+        return '';
+    }
+    let chunk = raw;
+    // Bracketed paste wrappers used by many terminals.
+    chunk = chunk.replace(/\x1b\[200~/g, '');
+    chunk = chunk.replace(/\x1b\[201~/g, '');
+    // Remove CSI escape sequences (arrows, function keys, etc.).
+    chunk = chunk.replace(/\x1b\[[0-9;?]*[ -/]*[@-~]/g, '');
+    // Remove remaining ESC-prefixed control bytes.
+    chunk = chunk.replace(/\x1b./g, '');
+    // Single-line input: strip CR/LF and other control chars.
+    chunk = chunk.replace(/[\r\n]/g, '');
+    chunk = chunk.replace(/[\x00-\x1F\x7F]/g, '');
+    return chunk;
+}
 /**
  * Show a text input prompt
  * @param config - Input configuration
  * @returns Promise resolving to entered text
  */
 async function showTextInput(config) {
-    const { prompt, defaultValue = '', placeholder, maxLength, minLength = 0, allowEmpty = false, validate, errorMessage, onExit } = config;
+    const { lang: langInput, prompt, defaultValue = '', placeholder, maxLength, minLength = 0, allowEmpty = false, validate, errorMessage, onExit, preserveOnExit = false } = config;
+    const lang = langInput ?? (0, registry_js_1.getCurrentLanguage)();
     const state = (0, terminal_js_1.initTerminal)();
     let inputValue = '';
     let errorMsg = '';
@@ -24,17 +47,18 @@ async function showTextInput(config) {
         // Render prompt with default value hint
         let promptLine = `  ${prompt}`;
         if (defaultValue && !inputValue) {
-            promptLine += ` ${colors_js_1.colors.dim}(默认: ${defaultValue})${colors_js_1.colors.reset}`;
+            const defaultLabel = lang === 'en' ? 'default' : (0, registry_js_1.t)('inputs.defaultValue');
+            promptLine += ` ${colors_js_1.uiColors.textSecondary}(${defaultLabel}: ${defaultValue})${colors_js_1.colors.reset}`;
         }
         if (placeholder && !inputValue) {
-            promptLine += ` ${colors_js_1.colors.dim}${placeholder}${colors_js_1.colors.reset}`;
+            promptLine += ` ${colors_js_1.uiColors.textSecondary}${placeholder}${colors_js_1.colors.reset}`;
         }
-        promptLine += `: ${colors_js_1.colors.cyan}${inputValue}_${colors_js_1.colors.reset}`;
+        promptLine += `: ${colors_js_1.uiColors.primary}${inputValue}_${colors_js_1.colors.reset}`;
         (0, terminal_js_1.writeLine)(promptLine);
         lineCount++;
         // Render error message if any
         if (errorMsg) {
-            (0, terminal_js_1.writeLine)(`  ${colors_js_1.colors.red}✗ ${errorMsg}${colors_js_1.colors.reset}`);
+            (0, terminal_js_1.writeLine)(`  ${colors_js_1.uiColors.error}✗ ${errorMsg}${colors_js_1.colors.reset}`);
             lineCount++;
         }
         state.renderedLines = lineCount;
@@ -47,13 +71,15 @@ async function showTextInput(config) {
             // Handle Ctrl+C
             if ((0, keyboard_js_1.isCtrlC)(key)) {
                 state.stdin.removeListener('data', onData);
-                (0, terminal_js_1.clearMenu)(state);
+                if (!preserveOnExit) {
+                    (0, terminal_js_1.clearMenu)(state);
+                }
                 (0, terminal_js_1.restoreTerminal)(state);
                 if (onExit) {
                     onExit();
                 }
                 else {
-                    console.log('\n👋 再见!');
+                    console.log(`\n${(0, registry_js_1.t)('messages.goodbye')}`);
                 }
                 process.exit(0);
             }
@@ -62,13 +88,13 @@ async function showTextInput(config) {
                 const finalValue = inputValue || defaultValue;
                 // Check if empty
                 if (!allowEmpty && !finalValue) {
-                    errorMsg = errorMessage || '输入不能为空';
+                    errorMsg = errorMessage || (0, registry_js_1.t)('inputs.cannotBeEmpty');
                     render();
                     return;
                 }
                 // Check min length
                 if (minLength && finalValue.length < minLength) {
-                    errorMsg = errorMessage || `输入长度不能少于 ${minLength} 个字符`;
+                    errorMsg = errorMessage || `${(0, registry_js_1.t)('inputs.minLength')}: ${minLength}`;
                     render();
                     return;
                 }
@@ -76,7 +102,7 @@ async function showTextInput(config) {
                 if (validate) {
                     const validationResult = validate(finalValue);
                     if (validationResult !== true) {
-                        errorMsg = typeof validationResult === 'string' ? validationResult : (errorMessage || '输入无效');
+                        errorMsg = typeof validationResult === 'string' ? validationResult : (errorMessage || (0, registry_js_1.t)('inputs.invalidInput'));
                         render();
                         return;
                     }
@@ -97,13 +123,24 @@ async function showTextInput(config) {
                 }
                 return;
             }
-            // Handle printable characters
-            if ((0, keyboard_js_1.isPrintable)(key)) {
+            // Handle single-key typing and multi-char paste chunks.
+            const chunk = (0, keyboard_js_1.isPrintable)(key) ? key : normalizeTextChunk(key);
+            if (chunk.length > 0) {
                 // Check max length
                 if (maxLength && inputValue.length >= maxLength) {
                     return;
                 }
-                inputValue += key;
+                let next = chunk;
+                if (maxLength) {
+                    const remaining = maxLength - inputValue.length;
+                    if (remaining <= 0) {
+                        return;
+                    }
+                    if (next.length > remaining) {
+                        next = next.slice(0, remaining);
+                    }
+                }
+                inputValue += next;
                 errorMsg = ''; // Clear error on edit
                 render();
                 return;

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

@@ -8,36 +8,43 @@ 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");
+const registry_js_1 = require("../../i18n/registry.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, preserveOnSelect = false } = config;
+    const { question, helperText, defaultValue = true, yesText = (0, registry_js_1.t)('menus.yes'), noText = (0, registry_js_1.t)('menus.no'), orientation = 'horizontal', onExit, preserveOnSelect = false } = config;
+    const preserveOnExit = config.preserveOnExit ?? preserveOnSelect;
     if (orientation === 'horizontal') {
-        return showBooleanMenuHorizontal(question, defaultValue, yesText, noText, onExit, preserveOnSelect);
+        return showBooleanMenuHorizontal(question, helperText, defaultValue, yesText, noText, onExit, preserveOnSelect, preserveOnExit);
     }
     else {
-        return showBooleanMenuVertical(question, defaultValue, yesText, noText, onExit, preserveOnSelect);
+        return showBooleanMenuVertical(question, helperText, defaultValue, yesText, noText, onExit, preserveOnSelect, preserveOnExit);
     }
 }
 /**
  * Show horizontal boolean menu (side by side)
  */
-async function showBooleanMenuHorizontal(question, defaultValue, yesText, noText, onExit, preserveOnSelect = false) {
+async function showBooleanMenuHorizontal(question, helperText, defaultValue, yesText, noText, onExit, preserveOnSelect = false, preserveOnExit = false) {
     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}`;
+            ? `${colors_js_1.uiColors.primary}${yesText}${colors_js_1.colors.reset}`
+            : `${colors_js_1.uiColors.textSecondary}${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}`);
+            ? `${colors_js_1.uiColors.primary}${noText}${colors_js_1.colors.reset}`
+            : `${colors_js_1.uiColors.textSecondary}${noText}${colors_js_1.colors.reset}`;
+        (0, terminal_js_1.writeLine)(`${colors_js_1.uiColors.warning}?${colors_js_1.colors.reset} ${question} ${yesOption} | ${noOption}`);
+        if (helperText && helperText.trim().length > 0) {
+            (0, terminal_js_1.writeLine)(`  ${colors_js_1.uiColors.textSecondary}${helperText}${colors_js_1.colors.reset}`);
+            state.renderedLines = 2;
+            return;
+        }
         state.renderedLines = 1;
     };
     // Initial render
@@ -48,13 +55,15 @@ async function showBooleanMenuHorizontal(question, defaultValue, yesText, noText
             // Handle Ctrl+C
             if ((0, keyboard_js_1.isCtrlC)(key)) {
                 state.stdin.removeListener('data', onData);
-                (0, terminal_js_1.clearMenu)(state);
+                if (!preserveOnExit) {
+                    (0, terminal_js_1.clearMenu)(state);
+                }
                 (0, terminal_js_1.restoreTerminal)(state);
                 if (onExit) {
                     onExit();
                 }
                 else {
-                    console.log('\n👋 再见!');
+                    console.log(`\n${(0, registry_js_1.t)('messages.goodbye')}`);
                 }
                 process.exit(0);
             }
@@ -98,23 +107,26 @@ async function showBooleanMenuHorizontal(question, defaultValue, yesText, noText
 /**
  * Show vertical boolean menu (stacked)
  */
-async function showBooleanMenuVertical(question, defaultValue, yesText, noText, onExit, preserveOnSelect = false) {
+async function showBooleanMenuVertical(question, helperText, defaultValue, yesText, noText, onExit, preserveOnSelect = false, preserveOnExit = false) {
     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)(`${colors_js_1.uiColors.warning}?${colors_js_1.colors.reset} ${question}`);
+        if (helperText && helperText.trim().length > 0) {
+            (0, terminal_js_1.writeLine)(`  ${colors_js_1.uiColors.textSecondary}${helperText}${colors_js_1.colors.reset}`);
+        }
         (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;
+        const yesCursor = selected ? `${colors_js_1.uiColors.cursor}❯ ${colors_js_1.colors.reset}` : '  ';
+        const yesColor = selected ? colors_js_1.uiColors.primary : colors_js_1.uiColors.textPrimary;
         (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;
+        const noCursor = !selected ? `${colors_js_1.uiColors.cursor}❯ ${colors_js_1.colors.reset}` : '  ';
+        const noColor = !selected ? colors_js_1.uiColors.primary : colors_js_1.uiColors.textPrimary;
         (0, terminal_js_1.writeLine)(`${noCursor}${noColor}${noText}${colors_js_1.colors.reset}`);
-        state.renderedLines = 4;
+        state.renderedLines = helperText && helperText.trim().length > 0 ? 5 : 4;
     };
     // Initial render
     render();
@@ -124,13 +136,15 @@ async function showBooleanMenuVertical(question, defaultValue, yesText, noText,
             // Handle Ctrl+C
             if ((0, keyboard_js_1.isCtrlC)(key)) {
                 state.stdin.removeListener('data', onData);
-                (0, terminal_js_1.clearMenu)(state);
+                if (!preserveOnExit) {
+                    (0, terminal_js_1.clearMenu)(state);
+                }
                 (0, terminal_js_1.restoreTerminal)(state);
                 if (onExit) {
                     onExit();
                 }
                 else {
-                    console.log('\n👋 再见!');
+                    console.log(`\n${(0, registry_js_1.t)('messages.goodbye')}`);
                 }
                 process.exit(0);
             }

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

@@ -6,6 +6,7 @@ import { CheckboxMenuConfig, CheckboxMenuResult } from '../../types/menu.types.j
 /**
  * Show a checkbox menu (multi-select)
  * @param config - Menu configuration
+ * @param hints - Optional hints to display at the bottom (for Page Layout use)
  * @returns Promise resolving to selected options
  */
-export declare function showCheckboxMenu(config: CheckboxMenuConfig): Promise<CheckboxMenuResult>;
+export declare function showCheckboxMenu(config: CheckboxMenuConfig, hints?: string[]): Promise<CheckboxMenuResult>;

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

@@ -5,36 +5,21 @@
  */
 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");
 const registry_js_1 = require("../../i18n/registry.js");
-/**
- * Generate hints based on menu configuration
- */
-function generateHints(allowSelectAll, allowInvert) {
-    const hints = [(0, registry_js_1.t)('hints.arrows'), (0, registry_js_1.t)('hints.space')];
-    if (allowSelectAll) {
-        hints.push((0, registry_js_1.t)('hints.selectAll'));
-    }
-    if (allowInvert) {
-        hints.push((0, registry_js_1.t)('hints.invert'));
-    }
-    hints.push((0, registry_js_1.t)('hints.enter'));
-    return hints;
-}
 /**
  * Show a checkbox menu (multi-select)
  * @param config - Menu configuration
+ * @param hints - Optional hints to display at the bottom (for Page Layout use)
  * @returns Promise resolving to selected options
  */
-async function showCheckboxMenu(config) {
-    const { options, title, prompt, hints, layout = { ...layout_types_js_1.LAYOUT_PRESETS.SUB_MENU, order: ['input', 'options', 'hints'] }, defaultSelected = [], minSelections = 0, maxSelections, allowSelectAll = true, allowInvert = true, separatorWidth = 30, onExit, preserveOnSelect = false } = config;
+async function showCheckboxMenu(config, hints) {
+    const { options, title, prompt, defaultSelected = [], minSelections = 0, maxSelections, allowSelectAll = true, allowInvert = true, separatorWidth = 30, onExit, preserveOnSelect = false } = config;
+    const preserveOnExit = config.preserveOnExit ?? preserveOnSelect;
     // Use i18n for default prompt if not provided
     const displayPrompt = prompt || (0, registry_js_1.t)('menus.multiSelectPrompt');
-    // Generate hints dynamically if not provided
-    const displayHints = hints || generateHints(allowSelectAll, allowInvert);
     // Validate options
     if (!options || options.length === 0) {
         throw new Error('CheckboxMenu requires at least one option');
@@ -89,49 +74,36 @@ async function showCheckboxMenu(config) {
     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, registry_js_1.t)('menus.selectedCount')}`;
-                        (0, renderer_js_1.renderInputPrompt)(displayPrompt, displayValue);
-                        lineCount++;
-                    }
-                    break;
-                case 'options':
-                    optionData.forEach((item, index) => {
-                        if (item.isSeparator) {
-                            // Render section label
-                            (0, renderer_js_1.renderSectionLabel)(item.label, separatorWidth);
-                        }
-                        else {
-                            (0, renderer_js_1.renderOption)(item.value, selected.has(index), index === cursorIndex);
-                        }
-                        lineCount++;
-                    });
-                    break;
-                case 'hints':
-                    if (layout.visible.hints && displayHints.length > 0) {
-                        (0, renderer_js_1.renderHints)(displayHints);
-                        lineCount++;
-                    }
-                    break;
+        // Render title if provided
+        if (title) {
+            (0, renderer_js_1.renderBlankLines)(1);
+            lineCount++;
+        }
+        // Render input prompt (show selected count)
+        const selectedCount = selected.size;
+        const displayValue = `${selectedCount} ${(0, registry_js_1.t)('menus.selectedCount')}`;
+        (0, renderer_js_1.renderInputPrompt)(displayPrompt, displayValue);
+        lineCount++;
+        (0, renderer_js_1.renderBlankLines)(1);
+        lineCount++;
+        // Render options
+        optionData.forEach((item, index) => {
+            if (item.isSeparator) {
+                // Render section label
+                (0, renderer_js_1.renderSectionLabel)(item.label, separatorWidth);
             }
-            // 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];
+            else {
+                (0, renderer_js_1.renderOption)(item.value, selected.has(index), index === cursorIndex);
             }
+            lineCount++;
         });
+        // Render hints if provided
+        if (hints && hints.length > 0) {
+            (0, renderer_js_1.renderBlankLines)(1);
+            lineCount++;
+            (0, renderer_js_1.renderHints)(hints);
+            lineCount += 1;
+        }
         state.renderedLines = lineCount;
     };
     // Initial render
@@ -142,13 +114,15 @@ async function showCheckboxMenu(config) {
             // Handle Ctrl+C
             if ((0, keyboard_js_1.isCtrlC)(key)) {
                 state.stdin.removeListener('data', onData);
-                (0, terminal_js_1.clearMenu)(state);
+                if (!preserveOnExit) {
+                    (0, terminal_js_1.clearMenu)(state);
+                }
                 (0, terminal_js_1.restoreTerminal)(state);
                 if (onExit) {
                     onExit();
                 }
                 else {
-                    console.log('\n👋 再见!');
+                    console.log(`\n${(0, registry_js_1.t)('messages.goodbye')}`);
                 }
                 process.exit(0);
             }

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

@@ -0,0 +1,12 @@
+/**
+ * CheckboxTableMenu - Multi-select menu with table display
+ * Combines checkbox selection with formatted table layout
+ */
+import { CheckboxTableMenuConfig, CheckboxTableMenuResult } from '../../types/menu.types.js';
+/**
+ * Show a checkbox table menu (multi-select with table display)
+ * @param config - Menu configuration
+ * @param hints - Optional hints to display at the bottom (for Page Layout use)
+ * @returns Promise resolving to selected rows
+ */
+export declare function showCheckboxTableMenu(config: CheckboxTableMenuConfig, hints?: string[]): Promise<CheckboxTableMenuResult>;