cli-menu-kit 0.1.26 → 0.2.1

package/dist/features/commands.js

@@ -14,40 +14,41 @@ exports.getAvailableCommands = getAvailableCommands;
 exports.showCommandHelp = showCommandHelp;
 const terminal_js_1 = require("../core/terminal.js");
 const colors_js_1 = require("../core/colors.js");
+const registry_js_1 = require("../i18n/registry.js");
 /**
  * Default command registry
  */
 const defaultCommands = {
     quit: {
         handler: () => {
-            (0, terminal_js_1.writeLine)('\n👋 再见!');
+            (0, terminal_js_1.writeLine)(`\n${(0, registry_js_1.t)('messages.goodbye')}`);
             process.exit(0);
         },
-        description: '退出应用程序'
+        descriptionKey: 'commands.quit'
     },
     help: {
         handler: () => {
-            (0, terminal_js_1.writeLine)('\n可用命令:');
-            Object.entries(defaultCommands).forEach(([cmd, { description }]) => {
-                (0, terminal_js_1.writeLine)(`  ${colors_js_1.colors.cyan}/${cmd}${colors_js_1.colors.reset} - ${description}`);
+            (0, terminal_js_1.writeLine)(`\n${(0, registry_js_1.t)('commands.availableCommands')}:`);
+            Object.entries(defaultCommands).forEach(([cmd, { descriptionKey }]) => {
+                (0, terminal_js_1.writeLine)(`  ${colors_js_1.uiColors.primary}/${cmd}${colors_js_1.colors.reset} - ${(0, registry_js_1.t)(descriptionKey)}`);
             });
             (0, terminal_js_1.writeLine)('');
             return false; // Don't exit, continue
         },
-        description: '显示帮助信息'
+        descriptionKey: 'commands.help'
     },
     clear: {
         handler: () => {
             (0, terminal_js_1.clearScreen)();
             return false; // Don't exit, continue
         },
-        description: '清除屏幕'
+        descriptionKey: 'commands.clear'
     },
     back: {
         handler: () => {
             return true; // Signal to go back
         },
-        description: '返回上一级菜单'
+        descriptionKey: 'commands.back'
     }
 };
 /**
@@ -61,7 +62,7 @@ let customCommands = {};
  * @param description - Command description
  */
 function registerCommand(command, handler, description) {
-    customCommands[command.toLowerCase()] = { handler, description };
+    customCommands[command.toLowerCase()] = { handler, descriptionKey: description };
 }
 /**
  * Unregister a custom command
@@ -120,8 +121,8 @@ function handleCommand(input) {
         return result === undefined ? false : result;
     }
     // Unknown command
-    (0, terminal_js_1.writeLine)(`${colors_js_1.colors.red}✗ 未知命令: /${command}${colors_js_1.colors.reset}`);
-    (0, terminal_js_1.writeLine)(`${colors_js_1.colors.dim}输入 /help 查看可用命令${colors_js_1.colors.reset}\n`);
+    (0, terminal_js_1.writeLine)(`${colors_js_1.uiColors.error}✗ ${(0, registry_js_1.t)('messages.unknownCommand')}: /${command}${colors_js_1.colors.reset}`);
+    (0, terminal_js_1.writeLine)(`${colors_js_1.uiColors.textSecondary}${(0, registry_js_1.t)('messages.helpPrompt')}${colors_js_1.colors.reset}\n`);
     return false;
 }
 /**
@@ -131,12 +132,12 @@ function handleCommand(input) {
 function getAvailableCommands() {
     const commands = [];
     // Add default commands
-    Object.entries(defaultCommands).forEach(([cmd, { description }]) => {
-        commands.push({ command: cmd, description });
+    Object.entries(defaultCommands).forEach(([cmd, { descriptionKey }]) => {
+        commands.push({ command: cmd, description: (0, registry_js_1.t)(descriptionKey) });
     });
     // Add custom commands
-    Object.entries(customCommands).forEach(([cmd, { description }]) => {
-        commands.push({ command: cmd, description });
+    Object.entries(customCommands).forEach(([cmd, { descriptionKey }]) => {
+        commands.push({ command: cmd, description: descriptionKey });
     });
     return commands;
 }
@@ -144,17 +145,17 @@ function getAvailableCommands() {
  * Show help for all commands
  */
 function showCommandHelp() {
-    (0, terminal_js_1.writeLine)('\n可用命令:');
+    (0, terminal_js_1.writeLine)(`\n${(0, registry_js_1.t)('commands.availableCommands')}:`);
     // Show default commands
-    (0, terminal_js_1.writeLine)(`\n${colors_js_1.colors.cyan}默认命令:${colors_js_1.colors.reset}`);
-    Object.entries(defaultCommands).forEach(([cmd, { description }]) => {
-        (0, terminal_js_1.writeLine)(`  ${colors_js_1.colors.cyan}/${cmd}${colors_js_1.colors.reset} - ${description}`);
+    (0, terminal_js_1.writeLine)(`\n${colors_js_1.uiColors.primary}${(0, registry_js_1.t)('commands.defaultCommands')}:${colors_js_1.colors.reset}`);
+    Object.entries(defaultCommands).forEach(([cmd, { descriptionKey }]) => {
+        (0, terminal_js_1.writeLine)(`  ${colors_js_1.uiColors.primary}/${cmd}${colors_js_1.colors.reset} - ${(0, registry_js_1.t)(descriptionKey)}`);
     });
     // Show custom commands if any
     if (Object.keys(customCommands).length > 0) {
-        (0, terminal_js_1.writeLine)(`\n${colors_js_1.colors.cyan}自定义命令:${colors_js_1.colors.reset}`);
-        Object.entries(customCommands).forEach(([cmd, { description }]) => {
-            (0, terminal_js_1.writeLine)(`  ${colors_js_1.colors.cyan}/${cmd}${colors_js_1.colors.reset} - ${description}`);
+        (0, terminal_js_1.writeLine)(`\n${colors_js_1.uiColors.primary}${(0, registry_js_1.t)('commands.customCommands')}:${colors_js_1.colors.reset}`);
+        Object.entries(customCommands).forEach(([cmd, { descriptionKey }]) => {
+            (0, terminal_js_1.writeLine)(`  ${colors_js_1.uiColors.primary}/${cmd}${colors_js_1.colors.reset} - ${descriptionKey}`);
         });
     }
     (0, terminal_js_1.writeLine)('');

package/dist/i18n/languages/en.js

@@ -9,7 +9,10 @@ exports.en = {
         selectPrompt: 'Enter option or use ↑↓ to select, press Enter to confirm',
         multiSelectPrompt: 'Space to toggle, Enter to confirm',
         confirmPrompt: 'Press Enter to confirm',
-        selectedCount: 'selected'
+        selectedCount: 'selected',
+        yes: 'Yes',
+        no: 'No',
+        scrollIndicator: 'Item {current}/{total} | ↑↓ Scroll for more'
     },
     hints: {
         arrows: '↑↓ Arrow keys',

package/dist/i18n/languages/zh.js

@@ -9,7 +9,10 @@ exports.zh = {
         selectPrompt: '输入选项或用↑↓选择,回车确认',
         multiSelectPrompt: '空格选中/取消,回车确认',
         confirmPrompt: '回车确认',
-        selectedCount: '项已选'
+        selectedCount: '项已选',
+        yes: '是',
+        no: '否',
+        scrollIndicator: '第 {current}/{total} 项 | ↑↓ 滚动查看更多'
     },
     hints: {
         arrows: '↑↓ 方向键',

package/dist/i18n/registry.d.ts

@@ -13,11 +13,12 @@ export declare function getCurrentLanguage(): LanguageCode;
  */
 export declare function setLanguage(lang: LanguageCode): void;
 /**
- * Get translation for a key path
+ * Get translation for a key path with optional parameter substitution
  * @param keyPath - Dot-separated key path (e.g., 'menus.selectPrompt')
- * @returns Translated string
+ * @param params - Optional parameters for string interpolation (e.g., { current: '1', total: '10' })
+ * @returns Translated string with parameters substituted
  */
-export declare function t(keyPath: string): string;
+export declare function t(keyPath: string, params?: Record<string, string>): string;
 /**
  * Register a new language
  * @param code - Language code

package/dist/i18n/registry.js

@@ -39,11 +39,12 @@ function setLanguage(lang) {
     registry.current = lang;
 }
 /**
- * Get translation for a key path
+ * Get translation for a key path with optional parameter substitution
  * @param keyPath - Dot-separated key path (e.g., 'menus.selectPrompt')
- * @returns Translated string
+ * @param params - Optional parameters for string interpolation (e.g., { current: '1', total: '10' })
+ * @returns Translated string with parameters substituted
  */
-function t(keyPath) {
+function t(keyPath, params) {
     const keys = keyPath.split('.');
     const langMap = registry.languages[registry.current];
     let value = langMap;
@@ -56,7 +57,14 @@ function t(keyPath) {
             return keyPath; // Return key path as fallback
         }
     }
-    return typeof value === 'string' ? value : keyPath;
+    let result = typeof value === 'string' ? value : keyPath;
+    // Substitute parameters if provided
+    if (params) {
+        for (const [key, val] of Object.entries(params)) {
+            result = result.replace(new RegExp(`\\{${key}\\}`, 'g'), val);
+        }
+    }
+    return result;
 }
 /**
  * Register a new language

package/dist/i18n/types.d.ts

@@ -14,6 +14,9 @@ export interface LanguageMap {
         multiSelectPrompt: string;
         confirmPrompt: string;
         selectedCount: string;
+        yes: string;
+        no: string;
+        scrollIndicator: string;
     };
     hints: {
         arrows: string;

package/dist/index.d.ts

@@ -4,20 +4,23 @@
  */
 export { menuAPI as menu, inputAPI as input, wizardAPI as wizard } from './api.js';
 export { default } from './api.js';
-export { showRadioMenu, showCheckboxMenu, showBooleanMenu } from './components/menus/index.js';
+export { renderPage, type PageLayoutConfig, type HeaderConfig as PageHeaderConfig, type MainAreaConfig, type FooterConfig } from './page-layout.js';
+export { createFullHeaderComponent, createSimpleHeaderComponent, createSectionHeaderComponent, createHintsComponent, createTableComponent, createListComponent, createSummaryTableComponent, createRadioMenuComponent, createInputPromptComponent } from './component-factories.js';
+export { showRadioMenu, showCheckboxMenu, showCheckboxTableMenu, showBooleanMenu } from './components/menus/index.js';
 export { showTextInput, showNumberInput, showLanguageSelector, showModifyField } from './components/inputs/index.js';
-export { renderSimpleHeader, renderSectionHeader, renderAsciiHeader, createSimpleHeader, createSectionHeader, 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 { renderSimpleHeader, renderSectionHeader, renderAsciiHeader, createSimpleHeader, createSectionHeader, createAsciiHeader, renderProgressIndicator, renderStageHeader, renderStageSeparator, createProgressIndicator, createStageHeader, createStageSeparator, renderProgressCheckmark, createProgressCheckmark, renderMessage, showSuccess, showError, showWarning, showInfo, showQuestion, createMessage, renderSummaryTable, createSummaryTable, createSimpleSummary, renderHeader, type HeaderConfig, renderHintsComponent, createHints, generateMenuHints, generateInputHints, HintTypes, type HintsConfig, renderTable, createTable, type TableConfig, type TableColumn, renderList, createList, createBulletList, createNumberedList, type ListConfig, type ListItem } 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';
+export { initConfig, getConfigManager, loadConfig, saveConfig, getConfig, setConfig, resetConfig, type UserConfig, type ConfigOptions } from './config/user-config.js';
+export { initLanguages, loadLanguagesFromFile, getLanguageManager, getSupportedLanguages, getLanguageConfig, getDefaultLanguage, getCLILanguageCode, type LanguageConfig, type LanguagesConfig } from './config/language-config.js';
 export { colors, uiColors, defaultUIColors, getUIColors, setUIColors, resetUIColors, createGradient, applyGradient, colorize } from './core/colors.js';
-export type { MenuLayout, LayoutElement, LayoutVisibility, LayoutSpacing } from './types/layout.types.js';
 export type { MenuOption, BaseMenuConfig, RadioMenuConfig, CheckboxMenuConfig, BooleanMenuConfig, RadioMenuResult, CheckboxMenuResult, BooleanMenuResult } from './types/menu.types.js';
 export type { BaseInputConfig, TextInputConfig, NumberInputConfig, LanguageSelectorConfig, ModifyFieldConfig, TextInputResult, NumberInputResult, LanguageSelectorResult, ModifyFieldResult } from './types/input.types.js';
 export type { HeaderType, SimpleHeaderConfig, AsciiHeaderConfig, ProgressConfig, MessageType, MessageConfig, SummaryTableConfig } from './types/display.types.js';
 export type { LanguageCode, LanguageMap, I18nRegistry } from './i18n/types.js';
 export { KEY_CODES } from './core/keyboard.js';
-export { LAYOUT_PRESETS } from './types/layout.types.js';
+export { calculateVirtualScroll, type VirtualScrollOptions, type VirtualScrollResult } from './core/virtual-scroll.js';
 export * from './types';
 export * from './components';
 export * from './menu-core';

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.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.createSectionHeader = exports.createSimpleHeader = exports.renderAsciiHeader = exports.renderSectionHeader = 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 = exports.createGradient = exports.resetUIColors = exports.setUIColors = exports.getUIColors = exports.defaultUIColors = exports.uiColors = exports.colors = void 0;
+exports.generateMenuHints = exports.createHints = exports.renderHintsComponent = exports.renderHeader = exports.createSimpleSummary = exports.createSummaryTable = exports.renderSummaryTable = exports.createMessage = exports.showQuestion = exports.showInfo = exports.showWarning = exports.showError = exports.showSuccess = exports.renderMessage = exports.createProgressCheckmark = exports.renderProgressCheckmark = exports.createStageSeparator = exports.createStageHeader = exports.createProgressIndicator = exports.renderStageSeparator = exports.renderStageHeader = exports.renderProgressIndicator = exports.createAsciiHeader = exports.createSectionHeader = exports.createSimpleHeader = exports.renderAsciiHeader = exports.renderSectionHeader = exports.renderSimpleHeader = exports.showModifyField = exports.showLanguageSelector = exports.showNumberInput = exports.showTextInput = exports.showBooleanMenu = exports.showCheckboxTableMenu = exports.showCheckboxMenu = exports.showRadioMenu = exports.createInputPromptComponent = exports.createRadioMenuComponent = exports.createSummaryTableComponent = exports.createListComponent = exports.createTableComponent = exports.createHintsComponent = exports.createSectionHeaderComponent = exports.createSimpleHeaderComponent = exports.createFullHeaderComponent = exports.renderPage = exports.default = exports.wizard = exports.input = exports.menu = void 0;
+exports.calculateVirtualScroll = exports.KEY_CODES = exports.colorize = exports.applyGradient = exports.createGradient = exports.resetUIColors = exports.setUIColors = exports.getUIColors = exports.defaultUIColors = exports.uiColors = exports.colors = exports.getCLILanguageCode = exports.getDefaultLanguage = exports.getLanguageConfig = exports.getSupportedLanguages = exports.getLanguageManager = exports.loadLanguagesFromFile = exports.initLanguages = exports.resetConfig = exports.setConfig = exports.getConfig = exports.saveConfig = exports.loadConfig = exports.getConfigManager = exports.initConfig = 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.createNumberedList = exports.createBulletList = exports.createList = exports.renderList = exports.createTable = exports.renderTable = exports.HintTypes = exports.generateInputHints = 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; } });
@@ -30,10 +30,25 @@ Object.defineProperty(exports, "input", { enumerable: true, get: function () { r
 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 Page Layout (Simple Configuration API)
+var page_layout_js_1 = require("./page-layout.js");
+Object.defineProperty(exports, "renderPage", { enumerable: true, get: function () { return page_layout_js_1.renderPage; } });
+// Export Component Factories (Legacy - for backward compatibility)
+var component_factories_js_1 = require("./component-factories.js");
+Object.defineProperty(exports, "createFullHeaderComponent", { enumerable: true, get: function () { return component_factories_js_1.createFullHeaderComponent; } });
+Object.defineProperty(exports, "createSimpleHeaderComponent", { enumerable: true, get: function () { return component_factories_js_1.createSimpleHeaderComponent; } });
+Object.defineProperty(exports, "createSectionHeaderComponent", { enumerable: true, get: function () { return component_factories_js_1.createSectionHeaderComponent; } });
+Object.defineProperty(exports, "createHintsComponent", { enumerable: true, get: function () { return component_factories_js_1.createHintsComponent; } });
+Object.defineProperty(exports, "createTableComponent", { enumerable: true, get: function () { return component_factories_js_1.createTableComponent; } });
+Object.defineProperty(exports, "createListComponent", { enumerable: true, get: function () { return component_factories_js_1.createListComponent; } });
+Object.defineProperty(exports, "createSummaryTableComponent", { enumerable: true, get: function () { return component_factories_js_1.createSummaryTableComponent; } });
+Object.defineProperty(exports, "createRadioMenuComponent", { enumerable: true, get: function () { return component_factories_js_1.createRadioMenuComponent; } });
+Object.defineProperty(exports, "createInputPromptComponent", { enumerable: true, get: function () { return component_factories_js_1.createInputPromptComponent; } });
 // 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, "showCheckboxTableMenu", { enumerable: true, get: function () { return index_js_1.showCheckboxTableMenu; } });
 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");
@@ -55,6 +70,8 @@ Object.defineProperty(exports, "renderStageSeparator", { enumerable: true, get:
 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, "renderProgressCheckmark", { enumerable: true, get: function () { return index_js_3.renderProgressCheckmark; } });
+Object.defineProperty(exports, "createProgressCheckmark", { enumerable: true, get: function () { return index_js_3.createProgressCheckmark; } });
 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; } });
@@ -66,6 +83,17 @@ Object.defineProperty(exports, "renderSummaryTable", { enumerable: true, get: fu
 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; } });
+Object.defineProperty(exports, "renderHintsComponent", { enumerable: true, get: function () { return index_js_3.renderHintsComponent; } });
+Object.defineProperty(exports, "createHints", { enumerable: true, get: function () { return index_js_3.createHints; } });
+Object.defineProperty(exports, "generateMenuHints", { enumerable: true, get: function () { return index_js_3.generateMenuHints; } });
+Object.defineProperty(exports, "generateInputHints", { enumerable: true, get: function () { return index_js_3.generateInputHints; } });
+Object.defineProperty(exports, "HintTypes", { enumerable: true, get: function () { return index_js_3.HintTypes; } });
+Object.defineProperty(exports, "renderTable", { enumerable: true, get: function () { return index_js_3.renderTable; } });
+Object.defineProperty(exports, "createTable", { enumerable: true, get: function () { return index_js_3.createTable; } });
+Object.defineProperty(exports, "renderList", { enumerable: true, get: function () { return index_js_3.renderList; } });
+Object.defineProperty(exports, "createList", { enumerable: true, get: function () { return index_js_3.createList; } });
+Object.defineProperty(exports, "createBulletList", { enumerable: true, get: function () { return index_js_3.createBulletList; } });
+Object.defineProperty(exports, "createNumberedList", { enumerable: true, get: function () { return index_js_3.createNumberedList; } });
 // Export features
 var wizard_js_1 = require("./features/wizard.js");
 Object.defineProperty(exports, "runWizard", { enumerable: true, get: function () { return wizard_js_1.runWizard; } });
@@ -87,6 +115,23 @@ Object.defineProperty(exports, "t", { enumerable: true, get: function () { retur
 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 configuration system
+var user_config_js_1 = require("./config/user-config.js");
+Object.defineProperty(exports, "initConfig", { enumerable: true, get: function () { return user_config_js_1.initConfig; } });
+Object.defineProperty(exports, "getConfigManager", { enumerable: true, get: function () { return user_config_js_1.getConfigManager; } });
+Object.defineProperty(exports, "loadConfig", { enumerable: true, get: function () { return user_config_js_1.loadConfig; } });
+Object.defineProperty(exports, "saveConfig", { enumerable: true, get: function () { return user_config_js_1.saveConfig; } });
+Object.defineProperty(exports, "getConfig", { enumerable: true, get: function () { return user_config_js_1.getConfig; } });
+Object.defineProperty(exports, "setConfig", { enumerable: true, get: function () { return user_config_js_1.setConfig; } });
+Object.defineProperty(exports, "resetConfig", { enumerable: true, get: function () { return user_config_js_1.resetConfig; } });
+var language_config_js_1 = require("./config/language-config.js");
+Object.defineProperty(exports, "initLanguages", { enumerable: true, get: function () { return language_config_js_1.initLanguages; } });
+Object.defineProperty(exports, "loadLanguagesFromFile", { enumerable: true, get: function () { return language_config_js_1.loadLanguagesFromFile; } });
+Object.defineProperty(exports, "getLanguageManager", { enumerable: true, get: function () { return language_config_js_1.getLanguageManager; } });
+Object.defineProperty(exports, "getSupportedLanguages", { enumerable: true, get: function () { return language_config_js_1.getSupportedLanguages; } });
+Object.defineProperty(exports, "getLanguageConfig", { enumerable: true, get: function () { return language_config_js_1.getLanguageConfig; } });
+Object.defineProperty(exports, "getDefaultLanguage", { enumerable: true, get: function () { return language_config_js_1.getDefaultLanguage; } });
+Object.defineProperty(exports, "getCLILanguageCode", { enumerable: true, get: function () { return language_config_js_1.getCLILanguageCode; } });
 // Export color configuration
 var colors_js_1 = require("./core/colors.js");
 Object.defineProperty(exports, "colors", { enumerable: true, get: function () { return colors_js_1.colors; } });
@@ -101,8 +146,8 @@ Object.defineProperty(exports, "colorize", { enumerable: true, get: function ()
 // Export core utilities (for advanced users)
 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; } });
+var virtual_scroll_js_1 = require("./core/virtual-scroll.js");
+Object.defineProperty(exports, "calculateVirtualScroll", { enumerable: true, get: function () { return virtual_scroll_js_1.calculateVirtualScroll; } });
 // Legacy exports (for backward compatibility)
 __exportStar(require("./types"), exports);
 __exportStar(require("./components"), exports);

package/dist/layout.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Page Layout System
+ * 通用页面布局：Header + Main Area + Footer
+ */
+/**
+ * Header 配置
+ */
+export interface HeaderConfig {
+    type: 'simple' | 'section' | 'none';
+    text?: string;
+    width?: number;
+}
+/**
+ * Main Area 配置
+ */
+export interface MainAreaConfig {
+    type: 'menu' | 'display' | 'interactive';
+    render: () => void | Promise<void>;
+}
+/**
+ * Footer 配置
+ */
+export interface FooterConfig {
+    menu?: {
+        options: string[];
+        allowLetterKeys?: boolean;
+        allowNumberKeys?: boolean;
+    };
+    input?: {
+        prompt: string;
+        defaultValue?: string;
+        allowEmpty?: boolean;
+    };
+    ask?: {
+        question: string;
+        defaultValue?: boolean;
+        horizontal?: boolean;
+    };
+    hints?: string[];
+}
+/**
+ * 完整页面布局配置
+ */
+export interface PageLayoutConfig {
+    header?: HeaderConfig;
+    mainArea: MainAreaConfig;
+    footer?: FooterConfig;
+}
+/**
+ * 渲染完整页面
+ *
+ * @example
+ * ```typescript
+ * const result = await renderPage({
+ *   header: { type: 'simple', text: 'My Page' },
+ *   mainArea: {
+ *     type: 'display',
+ *     render: () => console.log('Content')
+ *   },
+ *   footer: {
+ *     menu: { options: ['1. Save', 'b. Back'] },
+ *     hints: ['↑↓ Navigate  Enter Confirm']
+ *   }
+ * });
+ * ```
+ */
+export declare function renderPage(config: PageLayoutConfig): Promise<any>;

package/dist/layout.js

@@ -0,0 +1,86 @@
+"use strict";
+/**
+ * Page Layout System
+ * 通用页面布局：Header + Main Area + Footer
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderPage = renderPage;
+const api_js_1 = require("./api.js");
+const headers_js_1 = require("./components/display/headers.js");
+/**
+ * 渲染 Header
+ */
+function renderHeader(config) {
+    if (!config || config.type === 'none') {
+        return;
+    }
+    if (config.type === 'simple' && config.text) {
+        (0, headers_js_1.renderSimpleHeader)(config.text);
+    }
+    else if (config.type === 'section' && config.text) {
+        (0, headers_js_1.renderSectionHeader)(config.text, config.width || 50);
+    }
+}
+/**
+ * 渲染 Footer
+ * 返回用户的选择/输入结果
+ */
+async function renderFooter(config) {
+    if (!config) {
+        return null;
+    }
+    let result = null;
+    // 1. Menu (如果有)
+    if (config.menu) {
+        result = await api_js_1.menuAPI.radio({
+            options: config.menu.options,
+            allowLetterKeys: config.menu.allowLetterKeys ?? true,
+            allowNumberKeys: config.menu.allowNumberKeys ?? true,
+            hints: config.hints,
+            preserveOnSelect: true
+        });
+    }
+    // 2. Input (如果有)
+    else if (config.input) {
+        result = await api_js_1.inputAPI.text({
+            prompt: config.input.prompt,
+            defaultValue: config.input.defaultValue,
+            allowEmpty: config.input.allowEmpty ?? false
+        });
+    }
+    // 3. Ask (如果有 - 通常在 Menu 或 Input 之后)
+    if (config.ask) {
+        const askResult = config.ask.horizontal
+            ? await api_js_1.menuAPI.booleanH(config.ask.question, config.ask.defaultValue ?? false)
+            : await api_js_1.menuAPI.booleanV(config.ask.question, config.ask.defaultValue ?? false);
+        return { ...result, confirmed: askResult };
+    }
+    return result;
+}
+/**
+ * 渲染完整页面
+ *
+ * @example
+ * ```typescript
+ * const result = await renderPage({
+ *   header: { type: 'simple', text: 'My Page' },
+ *   mainArea: {
+ *     type: 'display',
+ *     render: () => console.log('Content')
+ *   },
+ *   footer: {
+ *     menu: { options: ['1. Save', 'b. Back'] },
+ *     hints: ['↑↓ Navigate  Enter Confirm']
+ *   }
+ * });
+ * ```
+ */
+async function renderPage(config) {
+    // 1. Render Header
+    renderHeader(config.header);
+    // 2. Render Main Area
+    await config.mainArea.render();
+    // 3. Render Footer
+    const footerResult = await renderFooter(config.footer);
+    return footerResult;
+}

package/dist/page-layout.d.ts

@@ -0,0 +1,123 @@
+/**
+ * Page Layout System - Simple Configuration API
+ * Architecture: Header + Main Area + Footer
+ *
+ * This is the simple, configuration-based API that users want.
+ * Just pass config objects, no need to create components manually.
+ */
+/**
+ * Header configuration
+ */
+export interface HeaderConfig {
+    type: 'simple' | 'section' | 'full' | 'none';
+    topBlankLines?: number;
+    text?: string;
+    width?: number;
+    asciiArt?: string[];
+    figletText?: string;
+    figletFont?: string;
+    figletSize?: 'small' | 'medium' | 'large';
+    figletScale?: number;
+    boxWidth?: number;
+    showBoxBorder?: boolean;
+    fillBox?: boolean;
+    fillBoxColor?: string;
+    fillBoxGradientStart?: string;
+    fillBoxGradientEnd?: string;
+    title?: string;
+    titleColor?: string;
+    titleGradientStart?: string;
+    titleGradientEnd?: string;
+    description?: string;
+    descriptionColor?: string;
+    descriptionGradientStart?: string;
+    descriptionGradientEnd?: string;
+    asciiArtColor?: string;
+    version?: string;
+    url?: string;
+    menuTitle?: string;
+    asciiArtGradientStart?: string;
+    asciiArtGradientEnd?: string;
+}
+/**
+ * Main Area configuration
+ */
+export interface MainAreaConfig {
+    type: 'menu' | 'display' | 'interactive';
+    menu?: {
+        options: any[];
+        allowLetterKeys?: boolean;
+        allowNumberKeys?: boolean;
+        preserveOnSelect?: boolean;
+        preserveOnExit?: boolean;
+        onExit?: () => void;
+    };
+    render?: () => void | Promise<void>;
+}
+/**
+ * Footer configuration
+ */
+export interface FooterConfig {
+    menu?: {
+        options: any[];
+        allowLetterKeys?: boolean;
+        allowNumberKeys?: boolean;
+        preserveOnSelect?: boolean;
+        preserveOnExit?: boolean;
+        onExit?: () => void;
+    };
+    ask?: {
+        question: string;
+        helperText?: string;
+        defaultValue?: boolean;
+        horizontal?: boolean;
+        preserveOnSelect?: boolean;
+        preserveOnExit?: boolean;
+        onExit?: () => void;
+    };
+    input?: {
+        prompt: string;
+        defaultValue?: string;
+        allowEmpty?: boolean;
+        lang?: 'zh' | 'en';
+        preserveOnExit?: boolean;
+        onExit?: () => void;
+    };
+    hints?: string[];
+}
+/**
+ * Complete page layout configuration
+ */
+export interface PageLayoutConfig {
+    header?: HeaderConfig;
+    mainArea: MainAreaConfig;
+    footer?: FooterConfig;
+}
+/**
+ * Render complete page with simple configuration API
+ *
+ * @example
+ * ```typescript
+ * const result = await renderPage({
+ *   header: {
+ *     type: 'full',
+ *     asciiArt: ['...'],
+ *     title: 'My App',
+ *     description: 'Description',
+ *     version: '1.0.0'
+ *   },
+ *   mainArea: {
+ *     type: 'menu',
+ *     menu: {
+ *       options: ['Option 1', 'Option 2'],
+ *       allowLetterKeys: true,
+ *       allowNumberKeys: true
+ *     }
+ *   },
+ *   footer: {
+ *     hints: ['↑↓ Navigate', 'Enter Confirm']
+ *   }
+ * });
+ * ```
+ */
+export declare function renderPage(config: PageLayoutConfig): Promise<any>;