cli-menu-kit 0.2.0 → 0.2.1

package/dist/components/display/summary.js

@@ -10,6 +10,58 @@ exports.createSimpleSummary = createSimpleSummary;
 const terminal_js_1 = require("../../core/terminal.js");
 const colors_js_1 = require("../../core/colors.js");
 const terminal_js_2 = require("../../core/terminal.js");
+function resolveColorSpec(spec) {
+    if (!spec) {
+        return '';
+    }
+    return spec
+        .split('+')
+        .map(part => {
+        const token = part.trim();
+        if (!token) {
+            return '';
+        }
+        const named = colors_js_1.colors[token];
+        if (named) {
+            return named;
+        }
+        // Accept raw ANSI sequences (e.g. values from getUIColors()).
+        if (/^\x1b\[[0-9;]*m$/.test(token)) {
+            return token;
+        }
+        return '';
+    })
+        .join('');
+}
+function splitLongToken(token, maxWidth) {
+    if (token.length <= maxWidth) {
+        return [token];
+    }
+    const chunks = [];
+    let rest = token;
+    const breakChars = ['/', '\\', '-', '_', '.'];
+    while (rest.length > maxWidth) {
+        let breakPos = -1;
+        for (const ch of breakChars) {
+            const idx = rest.lastIndexOf(ch, maxWidth - 1);
+            if (idx > breakPos) {
+                breakPos = idx;
+            }
+        }
+        if (breakPos <= 0) {
+            breakPos = maxWidth;
+        }
+        else {
+            breakPos += 1;
+        }
+        chunks.push(rest.slice(0, breakPos));
+        rest = rest.slice(breakPos);
+    }
+    if (rest.length > 0) {
+        chunks.push(rest);
+    }
+    return chunks;
+}
 /**
  * Wrap text to fit within a specific width, preserving ANSI color codes
  */
@@ -17,10 +69,15 @@ function wrapTextWithColors(text, maxWidth) {
     // Extract ANSI codes and plain text
     const ansiRegex = /\x1b\[[0-9;]*m/g;
     const plainText = text.replace(ansiRegex, '');
+    const hasAnsi = /\x1b\[[0-9;]*m/.test(text);
     // If plain text fits, return as-is
     if (plainText.length <= maxWidth) {
         return [text];
     }
+    // Fast path for plain text (no ANSI): support long token wrapping (e.g. file paths).
+    if (!hasAnsi) {
+        return wrapText(text, maxWidth);
+    }
     // Find all ANSI codes and their positions in the original text
     const codes = [];
     let match;
@@ -94,6 +151,16 @@ function wrapText(text, maxWidth) {
     const lines = [];
     let currentLine = '';
     for (const word of words) {
+        if (word.length > maxWidth) {
+            if (currentLine) {
+                lines.push(currentLine);
+                currentLine = '';
+            }
+            const chunks = splitLongToken(word, maxWidth);
+            lines.push(...chunks.slice(0, -1));
+            currentLine = chunks[chunks.length - 1] || '';
+            continue;
+        }
         const testLine = currentLine ? `${currentLine} ${word}` : word;
         if (testLine.length <= maxWidth) {
             currentLine = testLine;
@@ -136,12 +203,7 @@ function renderSummaryTable(config) {
     (0, terminal_js_1.writeLine)(`│${' '.repeat(boxWidth - 2)}│`);
     // Title if provided
     if (title) {
-        // Parse color configuration (supports "color" or "color+style" format)
-        let titleColor = '';
-        if (finalColors.title) {
-            const parts = finalColors.title.split('+');
-            titleColor = parts.map(part => colors_js_1.colors[part.trim()] || '').join('');
-        }
+        const titleColor = resolveColorSpec(finalColors.title);
         const resetColor = titleColor ? colors_js_1.colors.reset : '';
         let titleLine;
         let remainingSpace;
@@ -173,7 +235,7 @@ function renderSummaryTable(config) {
     sections.forEach((section, sectionIndex) => {
         // Section header if provided
         if (section.header) {
-            const headerColor = finalColors.sectionHeader ? colors_js_1.colors[finalColors.sectionHeader] || '' : '';
+            const headerColor = resolveColorSpec(finalColors.sectionHeader);
             const resetColor = headerColor ? colors_js_1.colors.reset : '';
             const headerLine = `  ${headerColor}${section.header}${resetColor}`;
             const remainingSpace = boxWidth - section.header.length - 4;
@@ -188,7 +250,7 @@ function renderSummaryTable(config) {
                 // Wrap the value (preserving colors if present)
                 const wrappedLines = wrapTextWithColors(item.value, valueMaxWidth);
                 // First line with key
-                const keyColor = finalColors.key ? colors_js_1.colors[finalColors.key] || '' : '';
+                const keyColor = resolveColorSpec(finalColors.key);
                 const keyResetColor = keyColor ? colors_js_1.colors.reset : '';
                 // wrappedLines already contain colors, don't add valueColor
                 const firstLine = `  ${keyColor}${item.key}:${keyResetColor}${' '.repeat(Math.max(1, keyPadding - item.key.length))}${wrappedLines[0]}`;
@@ -205,9 +267,9 @@ function renderSummaryTable(config) {
             }
             else {
                 // No wrapping needed
-                const keyColor = finalColors.key ? colors_js_1.colors[finalColors.key] || '' : '';
+                const keyColor = resolveColorSpec(finalColors.key);
                 const keyResetColor = keyColor ? colors_js_1.colors.reset : '';
-                const valueColor = finalColors.value ? colors_js_1.colors[finalColors.value] || '' : '';
+                const valueColor = resolveColorSpec(finalColors.value);
                 const valueResetColor = valueColor ? colors_js_1.colors.reset : '';
                 // Only wrap value with color if valueColor is set, otherwise preserve original colors in item.value
                 const coloredValue = valueColor ? `${valueColor}${item.value}${valueResetColor}` : item.value;

package/dist/components/display/table.d.ts

@@ -27,6 +27,8 @@ export interface TableConfig {
     showBorders?: boolean;
     /** Show header separator */
     showHeaderSeparator?: boolean;
+    /** Border color (ANSI escape code, e.g., '\x1b[2m' for dim/gray) */
+    borderColor?: string;
 }
 /**
  * Render table component

package/dist/components/display/table.js

@@ -12,10 +12,11 @@ const terminal_js_1 = require("../../core/terminal.js");
  * @param config - Table configuration
  */
 function renderTable(config) {
-    const { columns, data, showBorders = true, showHeaderSeparator = true } = config;
+    const { columns, data, showBorders = true, showHeaderSeparator = true, borderColor = '' } = config;
     if (columns.length === 0 || data.length === 0) {
         return;
     }
+    const resetColor = borderColor ? '\x1b[0m' : '';
     // Calculate column widths
     const columnWidths = columns.map((col, index) => {
         if (col.width)
@@ -28,7 +29,7 @@ function renderTable(config) {
     // Render top border
     if (showBorders) {
         const border = columnWidths.map(w => '─'.repeat(w)).join('┬');
-        (0, terminal_js_1.writeLine)(`┌${border}┐`);
+        (0, terminal_js_1.writeLine)(`${borderColor}┌${border}┐${resetColor}`);
     }
     // Render header
     const headerCells = columns.map((col, index) => {
@@ -37,7 +38,7 @@ function renderTable(config) {
         return alignText(col.header, width, align);
     });
     if (showBorders) {
-        (0, terminal_js_1.writeLine)(`│${headerCells.join('│')}│`);
+        (0, terminal_js_1.writeLine)(`${borderColor}│${resetColor}${headerCells.join(`${borderColor}│${resetColor}`)}${borderColor}│${resetColor}`);
     }
     else {
         (0, terminal_js_1.writeLine)(headerCells.join(' '));
@@ -46,7 +47,7 @@ function renderTable(config) {
     if (showHeaderSeparator) {
         if (showBorders) {
             const separator = columnWidths.map(w => '─'.repeat(w)).join('┼');
-            (0, terminal_js_1.writeLine)(`├${separator}┤`);
+            (0, terminal_js_1.writeLine)(`${borderColor}├${separator}┤${resetColor}`);
         }
         else {
             const separator = columnWidths.map(w => '─'.repeat(w)).join(' ');
@@ -62,7 +63,7 @@ function renderTable(config) {
             return alignText(value, width, align);
         });
         if (showBorders) {
-            (0, terminal_js_1.writeLine)(`│${cells.join('│')}│`);
+            (0, terminal_js_1.writeLine)(`${borderColor}│${resetColor}${cells.join(`${borderColor}│${resetColor}`)}${borderColor}│${resetColor}`);
         }
         else {
             (0, terminal_js_1.writeLine)(cells.join(' '));
@@ -71,7 +72,7 @@ function renderTable(config) {
     // Render bottom border
     if (showBorders) {
         const border = columnWidths.map(w => '─'.repeat(w)).join('┴');
-        (0, terminal_js_1.writeLine)(`└${border}┘`);
+        (0, terminal_js_1.writeLine)(`${borderColor}└${border}┘${resetColor}`);
     }
 }
 /**

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

@@ -9,13 +9,14 @@ 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");
+const registry_js_1 = require("../../i18n/registry.js");
 /**
  * Show a language selector
  * @param config - Selector configuration
  * @returns Promise resolving to selected language code
  */
 async function showLanguageSelector(config) {
-    const { languages, defaultLanguage, prompt = '选择语言 / Select Language', onExit } = config;
+    const { languages, defaultLanguage, prompt = 'Select Language', onExit, preserveOnExit = false } = config;
     // Validate languages
     if (!languages || languages.length === 0) {
         throw new Error('LanguageSelector requires at least one language');
@@ -33,7 +34,7 @@ async function showLanguageSelector(config) {
         (0, terminal_js_1.clearMenu)(state);
         let lineCount = 0;
         // Render header
-        (0, renderer_js_1.renderHeader)(`  ${prompt}`, colors_js_1.colors.cyan);
+        (0, renderer_js_1.renderHeader)(`  ${prompt}`, colors_js_1.uiColors.primary);
         lineCount++;
         (0, renderer_js_1.renderBlankLines)(1);
         lineCount++;
@@ -48,7 +49,7 @@ async function showLanguageSelector(config) {
         // Render hints
         (0, renderer_js_1.renderBlankLines)(1);
         lineCount++;
-        (0, renderer_js_1.renderHints)(['↑↓ 方向键', '1-9 输入序号', '⏎ 确认']);
+        (0, renderer_js_1.renderHints)([(0, registry_js_1.t)('hints.arrows'), (0, registry_js_1.t)('hints.numbers'), (0, registry_js_1.t)('hints.enter')]);
         lineCount++;
         state.renderedLines = lineCount;
     };
@@ -60,13 +61,15 @@ async function showLanguageSelector(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/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

@@ -15,30 +15,36 @@ const registry_js_1 = require("../../i18n/registry.js");
  * @returns Promise resolving to boolean result
  */
 async function showBooleanMenu(config) {
-    const { question, 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 { 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
@@ -49,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);
             }
@@ -99,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();
@@ -125,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.js

@@ -17,6 +17,7 @@ const registry_js_1 = require("../../i18n/registry.js");
  */
 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');
     // Validate options
@@ -113,13 +114,15 @@ async function showCheckboxMenu(config, hints) {
             // 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);
             }