cli-menu-kit 0.1.2 → 0.1.9

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

@@ -0,0 +1,30 @@
+/**
+ * Header component for CLI applications
+ * Displays ASCII art, title, description, version and URL
+ */
+/**
+ * Header configuration
+ */
+export interface HeaderConfig {
+    /** ASCII art lines (array of strings) */
+    asciiArt?: string[];
+    /** Application title */
+    title?: string;
+    /** Application description */
+    description?: string;
+    /** Version number */
+    version?: string;
+    /** Project URL */
+    url?: string;
+    /** Optional menu title (e.g., "请选择功能:") */
+    menuTitle?: string;
+    /** Box width (default: 60) */
+    boxWidth?: number;
+    /** Header color (default: cyan) */
+    color?: string;
+}
+/**
+ * Render a boxed header with ASCII art, title, and description
+ * @param config - Header configuration
+ */
+export declare function renderHeader(config: HeaderConfig): void;

package/dist/components/display/header.js

@@ -0,0 +1,56 @@
+"use strict";
+/**
+ * Header component for CLI applications
+ * Displays ASCII art, title, description, version and URL
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderHeader = renderHeader;
+const colors_js_1 = require("../../core/colors.js");
+const terminal_js_1 = require("../../core/terminal.js");
+/**
+ * Render a boxed header with ASCII art, title, and description
+ * @param config - Header configuration
+ */
+function renderHeader(config) {
+    const { asciiArt = [], title = '', description = '', version, url, menuTitle, boxWidth = 60, color = colors_js_1.colors.cyan } = config;
+    const boldColor = `${color}${colors_js_1.colors.bold}`;
+    // Top border
+    (0, terminal_js_1.writeLine)('');
+    (0, terminal_js_1.writeLine)(`${boldColor}╔${'═'.repeat(boxWidth - 2)}╗${colors_js_1.colors.reset}`);
+    // Empty line
+    (0, terminal_js_1.writeLine)(`${boldColor}║${' '.repeat(boxWidth - 2)}║${colors_js_1.colors.reset}`);
+    // ASCII art (left-aligned with 2 spaces padding)
+    if (asciiArt.length > 0) {
+        asciiArt.forEach(line => {
+            const paddedLine = `  ${line}`.padEnd(boxWidth - 2, ' ');
+            (0, terminal_js_1.writeLine)(`${boldColor}║${paddedLine}║${colors_js_1.colors.reset}`);
+        });
+        (0, terminal_js_1.writeLine)(`${boldColor}║${' '.repeat(boxWidth - 2)}║${colors_js_1.colors.reset}`);
+    }
+    // Title (left-aligned with 2 spaces padding)
+    if (title) {
+        const paddedTitle = `  ${title}`.padEnd(boxWidth - 2, ' ');
+        (0, terminal_js_1.writeLine)(`${boldColor}║${paddedTitle}║${colors_js_1.colors.reset}`);
+        (0, terminal_js_1.writeLine)(`${boldColor}║${' '.repeat(boxWidth - 2)}║${colors_js_1.colors.reset}`);
+    }
+    // Description (left-aligned with 2 spaces padding)
+    if (description) {
+        const paddedDesc = `  ${description}`.padEnd(boxWidth - 2, ' ');
+        (0, terminal_js_1.writeLine)(`${boldColor}║${paddedDesc}║${colors_js_1.colors.reset}`);
+        (0, terminal_js_1.writeLine)(`${boldColor}║${' '.repeat(boxWidth - 2)}║${colors_js_1.colors.reset}`);
+    }
+    // Bottom border
+    (0, terminal_js_1.writeLine)(`${boldColor}╚${'═'.repeat(boxWidth - 2)}╝${colors_js_1.colors.reset}`);
+    // Version and URL (outside the box, dimmed)
+    if (version || url) {
+        const versionText = version ? `Version: ${version}` : '';
+        const urlText = url || '';
+        const separator = version && url ? '  |  ' : '';
+        (0, terminal_js_1.writeLine)(`${colors_js_1.colors.dim}  ${versionText}${separator}${urlText}${colors_js_1.colors.reset}`);
+    }
+    (0, terminal_js_1.writeLine)('');
+    // Menu title (optional)
+    if (menuTitle) {
+        (0, terminal_js_1.writeLine)(`${color}  ${menuTitle}${colors_js_1.colors.reset}`);
+    }
+}

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

@@ -6,3 +6,4 @@ export { renderSimpleHeader, renderAsciiHeader, createSimpleHeader, createAsciiH
 export { renderProgressIndicator, renderStageHeader, renderStageSeparator, createProgressIndicator, createStageHeader, createStageSeparator } from './progress.js';
 export { renderMessage, showSuccess, showError, showWarning, showInfo, showQuestion, createMessage } from './messages.js';
 export { renderSummaryTable, createSummaryTable, createSimpleSummary } from './summary.js';
+export { renderHeader, type HeaderConfig } from './header.js';

package/dist/components/display/index.js

@@ -4,7 +4,7 @@
  * Exports all display component functions
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-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 = void 0;
+exports.renderHeader = 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 = void 0;
 var headers_js_1 = require("./headers.js");
 Object.defineProperty(exports, "renderSimpleHeader", { enumerable: true, get: function () { return headers_js_1.renderSimpleHeader; } });
 Object.defineProperty(exports, "renderAsciiHeader", { enumerable: true, get: function () { return headers_js_1.renderAsciiHeader; } });
@@ -29,3 +29,5 @@ var summary_js_1 = require("./summary.js");
 Object.defineProperty(exports, "renderSummaryTable", { enumerable: true, get: function () { return summary_js_1.renderSummaryTable; } });
 Object.defineProperty(exports, "createSummaryTable", { enumerable: true, get: function () { return summary_js_1.createSummaryTable; } });
 Object.defineProperty(exports, "createSimpleSummary", { enumerable: true, get: function () { return summary_js_1.createSimpleSummary; } });
+var header_js_1 = require("./header.js");
+Object.defineProperty(exports, "renderHeader", { enumerable: true, get: function () { return header_js_1.renderHeader; } });

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

@@ -9,13 +9,32 @@ 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
  * @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;
+    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, onExit } = config;
+    // 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');
@@ -82,8 +101,8 @@ async function showCheckboxMenu(config) {
                 case 'input':
                     if (layout.visible.input) {
                         const selectedCount = selected.size;
-                        const displayValue = `${selectedCount} 项已选`;
-                        (0, renderer_js_1.renderInputPrompt)(prompt, displayValue);
+                        const displayValue = `${selectedCount} ${(0, registry_js_1.t)('menus.selectedCount')}`;
+                        (0, renderer_js_1.renderInputPrompt)(displayPrompt, displayValue);
                         lineCount++;
                     }
                     break;
@@ -100,8 +119,8 @@ async function showCheckboxMenu(config) {
                     });
                     break;
                 case 'hints':
-                    if (layout.visible.hints && hints.length > 0) {
-                        (0, renderer_js_1.renderHints)(hints);
+                    if (layout.visible.hints && displayHints.length > 0) {
+                        (0, renderer_js_1.renderHints)(displayHints);
                         lineCount++;
                     }
                     break;

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

@@ -10,13 +10,32 @@ 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");
+/**
+ * Generate hints based on menu configuration
+ */
+function generateHints(allowNumberKeys, allowLetterKeys) {
+    const hints = [(0, registry_js_1.t)('hints.arrows')];
+    if (allowNumberKeys) {
+        hints.push((0, registry_js_1.t)('hints.numbers'));
+    }
+    if (allowLetterKeys) {
+        hints.push((0, registry_js_1.t)('hints.letters'));
+    }
+    hints.push((0, registry_js_1.t)('hints.enter'));
+    return hints;
+}
 /**
  * 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;
+    const { options, title, prompt, hints, layout = layout_types_js_1.LAYOUT_PRESETS.MAIN_MENU, defaultIndex = 0, allowNumberKeys = true, allowLetterKeys = false, onExit } = config;
+    // Use i18n for default prompt if not provided
+    const displayPrompt = prompt || (0, registry_js_1.t)('menus.selectPrompt');
+    // Generate hints dynamically if not provided
+    const displayHints = hints || generateHints(allowNumberKeys, allowLetterKeys);
     // Validate options
     if (!options || options.length === 0) {
         throw new Error('RadioMenu requires at least one option');
@@ -92,11 +111,21 @@ async function showRadioMenu(config) {
                             (0, renderer_js_1.renderSectionLabel)(item.label);
                         }
                         else {
-                            // Extract number prefix if exists
-                            const match = item.value.match(/^(\d+)\.\s*/);
-                            const prefix = match ? '' : `${selectableIndices.indexOf(index) + 1}. `;
+                            // Check if option starts with a number or letter prefix
+                            const numberMatch = item.value.match(/^(\d+)\.\s*/);
+                            const letterMatch = item.value.match(/^([a-zA-Z])\.\s*/);
+                            // Don't add prefix if option already has number or letter prefix
+                            const prefix = (numberMatch || letterMatch) ? '' : `${selectableIndices.indexOf(index) + 1}. `;
+                            // Check if this is an Exit option (contains "Exit" or "Quit")
+                            const isExitOption = /\b(exit|quit)\b/i.test(item.value);
+                            const displayValue = isExitOption ? `${colors_js_1.colors.red}${item.value}${colors_js_1.colors.reset}` : item.value;
                             // For radio menus, don't show selection indicator (pass undefined instead of false)
-                            (0, renderer_js_1.renderOption)(item.value, undefined, index === selectedIndex, prefix);
+                            (0, renderer_js_1.renderOption)(displayValue, undefined, index === selectedIndex, prefix);
+                            // Add blank line after last item before next separator
+                            const nextIndex = index + 1;
+                            if (nextIndex < optionData.length && optionData[nextIndex].isSeparator) {
+                                (0, terminal_js_1.writeLine)('');
+                            }
                         }
                         lineCount++;
                     });
@@ -115,13 +144,13 @@ async function showRadioMenu(config) {
                                 displayValue = String(selectableIndices.indexOf(selectedIndex) + 1);
                             }
                         }
-                        (0, renderer_js_1.renderInputPrompt)(prompt, displayValue);
+                        (0, renderer_js_1.renderInputPrompt)(displayPrompt, displayValue);
                         lineCount++;
                     }
                     break;
                 case 'hints':
-                    if (layout.visible.hints && hints.length > 0) {
-                        (0, renderer_js_1.renderHints)(hints);
+                    if (layout.visible.hints && displayHints.length > 0) {
+                        (0, renderer_js_1.renderHints)(displayHints);
                         lineCount++;
                     }
                     break;

package/dist/core/renderer.js

@@ -80,7 +80,7 @@ function renderOption(text, isSelected, isHighlighted, prefix) {
  * @param showCursor - Whether to show cursor
  */
 function renderInputPrompt(prompt, value, showCursor = false) {
-    let line = `  ${colors_js_1.colors.dim}${prompt}${colors_js_1.colors.reset} `;
+    let line = `  ${prompt} `;
     if (value) {
         line += `${colors_js_1.colors.cyan}${value}${colors_js_1.colors.reset}`;
     }
@@ -96,7 +96,19 @@ function renderInputPrompt(prompt, value, showCursor = false) {
 function renderHints(hints) {
     if (hints.length === 0)
         return;
-    const hintLine = `  ${colors_js_1.colors.dim}${hints.join(' • ')}${colors_js_1.colors.reset}`;
+    // Format each hint: symbols/numbers in black, text in gray
+    const formattedHints = hints.map(hint => {
+        const parts = hint.split(' ');
+        if (parts.length >= 2) {
+            // First part (symbols/numbers) in normal color, rest in dim
+            const symbols = parts[0];
+            const text = parts.slice(1).join(' ');
+            return `${symbols} ${colors_js_1.colors.dim}${text}${colors_js_1.colors.reset}`;
+        }
+        // If no space, keep entire hint in dim
+        return `${colors_js_1.colors.dim}${hint}${colors_js_1.colors.reset}`;
+    });
+    const hintLine = `  ${formattedHints.join(' • ')}`;
     (0, terminal_js_1.writeLine)(hintLine);
 }
 /**
@@ -115,7 +127,15 @@ function renderSeparator(char = '─', width) {
  */
 function renderSectionLabel(label) {
     if (label) {
-        (0, terminal_js_1.writeLine)(`  ${colors_js_1.colors.dim}────── ${label} ──────${colors_js_1.colors.reset}`);
+        const totalWidth = 50; // Fixed total width for consistency
+        const padding = 2; // Spaces around label
+        const labelWithPadding = ` ${label} `;
+        const labelLength = labelWithPadding.length;
+        const dashesTotal = totalWidth - labelLength;
+        const dashesLeft = Math.floor(dashesTotal / 2);
+        const dashesRight = dashesTotal - dashesLeft;
+        const line = `  ${colors_js_1.colors.dim}${'─'.repeat(dashesLeft)}${labelWithPadding}${'─'.repeat(dashesRight)}${colors_js_1.colors.reset}`;
+        (0, terminal_js_1.writeLine)(line);
     }
     else {
         (0, terminal_js_1.writeLine)('');

package/dist/i18n/languages/en.js

@@ -16,10 +16,11 @@ exports.en = {
         space: 'Space Toggle',
         enter: '⏎ Confirm',
         numbers: '0-9 Number keys',
-        letters: 'A-Z Letter keys',
+        letters: 'Letter Shortcuts',
         selectAll: 'A Select all',
         invert: 'I Invert',
-        yesNo: 'Y/N Quick keys'
+        yesNo: 'Y/N Quick keys',
+        exit: 'Ctrl+C Exit'
     },
     messages: {
         success: 'Success',

package/dist/i18n/languages/zh.js

@@ -16,10 +16,11 @@ exports.zh = {
         space: '空格 选中/取消',
         enter: '⏎ 确认',
         numbers: '0-9 输入序号',
-        letters: 'A-Z 字母选择',
+        letters: '字母 快捷键',
         selectAll: 'A 全选',
         invert: 'I 反选',
-        yesNo: 'Y/N 快捷键'
+        yesNo: 'Y/N 快捷键',
+        exit: 'Ctrl+C 退出'
     },
     messages: {
         success: '成功',

package/dist/i18n/types.d.ts

@@ -24,6 +24,7 @@ export interface LanguageMap {
         selectAll: string;
         invert: string;
         yesNo: string;
+        exit: string;
     };
     messages: {
         success: string;

package/dist/index.d.ts

@@ -6,7 +6,7 @@ export { menuAPI as menu, inputAPI as input, wizardAPI as wizard } from './api.j
 export { default } from './api.js';
 export { showRadioMenu, showCheckboxMenu, showBooleanMenu } from './components/menus/index.js';
 export { showTextInput, showNumberInput, showLanguageSelector, showModifyField } from './components/inputs/index.js';
-export { renderSimpleHeader, renderAsciiHeader, createSimpleHeader, createAsciiHeader, renderProgressIndicator, renderStageHeader, renderStageSeparator, createProgressIndicator, createStageHeader, createStageSeparator, renderMessage, showSuccess, showError, showWarning, showInfo, showQuestion, createMessage, renderSummaryTable, createSummaryTable, createSimpleSummary } from './components/display/index.js';
+export { renderSimpleHeader, renderAsciiHeader, createSimpleHeader, createAsciiHeader, renderProgressIndicator, renderStageHeader, renderStageSeparator, createProgressIndicator, createStageHeader, createStageSeparator, renderMessage, showSuccess, showError, showWarning, showInfo, showQuestion, createMessage, renderSummaryTable, createSummaryTable, createSimpleSummary, renderHeader, type HeaderConfig } from './components/display/index.js';
 export { runWizard, createWizard, WizardConfig, WizardStep, WizardResult } from './features/wizard.js';
 export { registerCommand, unregisterCommand, clearCustomCommands, isCommand, parseCommand, handleCommand, getAvailableCommands, showCommandHelp } from './features/commands.js';
 export { getCurrentLanguage, setLanguage, t, registerLanguage, getAvailableLanguages, getCurrentLanguageMap } from './i18n/registry.js';

package/dist/index.js

@@ -21,8 +21,8 @@ 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;
+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.renderHeader = 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 = exports.applyGradient = 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; } });
@@ -63,6 +63,7 @@ Object.defineProperty(exports, "createMessage", { enumerable: true, get: functio
 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; } });
+Object.defineProperty(exports, "renderHeader", { enumerable: true, get: function () { return index_js_3.renderHeader; } });
 // Export features
 var wizard_js_1 = require("./features/wizard.js");
 Object.defineProperty(exports, "runWizard", { enumerable: true, get: function () { return wizard_js_1.runWizard; } });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cli-menu-kit",
-  "version": "0.1.2",
+  "version": "0.1.9",
   "description": "A lightweight, customizable CLI menu system with keyboard shortcuts and real-time rendering",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",