cli-menu-kit 0.1.26 → 0.2.0

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

@@ -0,0 +1,49 @@
+/**
+ * List Component
+ * Displays items in a list format with optional bullets/numbers
+ */
+/**
+ * List item configuration
+ */
+export interface ListItem {
+    /** Item text */
+    text: string;
+    /** Item indent level (0 = no indent) */
+    indent?: number;
+    /** Custom bullet/prefix */
+    bullet?: string;
+}
+/**
+ * List configuration
+ */
+export interface ListConfig {
+    /** List items */
+    items: (string | ListItem)[];
+    /** List style */
+    style?: 'bullet' | 'number' | 'none';
+    /** Custom bullet character (for bullet style) */
+    bulletChar?: string;
+    /** Indent size in spaces */
+    indentSize?: number;
+}
+/**
+ * Render list component
+ * @param config - List configuration
+ */
+export declare function renderList(config: ListConfig): void;
+/**
+ * Create list configuration (factory function)
+ */
+export declare function createList(items: (string | ListItem)[], options?: {
+    style?: 'bullet' | 'number' | 'none';
+    bulletChar?: string;
+    indentSize?: number;
+}): ListConfig;
+/**
+ * Create a simple bullet list
+ */
+export declare function createBulletList(items: string[]): ListConfig;
+/**
+ * Create a numbered list
+ */
+export declare function createNumberedList(items: string[]): ListConfig;

package/dist/components/display/list.js

@@ -0,0 +1,86 @@
+"use strict";
+/**
+ * List Component
+ * Displays items in a list format with optional bullets/numbers
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderList = renderList;
+exports.createList = createList;
+exports.createBulletList = createBulletList;
+exports.createNumberedList = createNumberedList;
+const terminal_js_1 = require("../../core/terminal.js");
+/**
+ * Render list component
+ * @param config - List configuration
+ */
+function renderList(config) {
+    const { items, style = 'bullet', bulletChar = '•', indentSize = 2 } = config;
+    if (items.length === 0) {
+        return;
+    }
+    items.forEach((item, index) => {
+        let text;
+        let indent;
+        let bullet;
+        // Parse item
+        if (typeof item === 'string') {
+            text = item;
+            indent = 0;
+            bullet = undefined;
+        }
+        else {
+            text = item.text;
+            indent = item.indent || 0;
+            bullet = item.bullet;
+        }
+        // Generate prefix based on style
+        let prefix;
+        if (bullet) {
+            // Custom bullet
+            prefix = bullet;
+        }
+        else {
+            switch (style) {
+                case 'number':
+                    prefix = `${index + 1}.`;
+                    break;
+                case 'bullet':
+                    prefix = bulletChar;
+                    break;
+                case 'none':
+                default:
+                    prefix = '';
+                    break;
+            }
+        }
+        // Build line with indent and prefix
+        const indentStr = ' '.repeat(indent * indentSize);
+        const line = prefix
+            ? `${indentStr}${prefix} ${text}`
+            : `${indentStr}${text}`;
+        (0, terminal_js_1.writeLine)(line);
+    });
+}
+/**
+ * Create list configuration (factory function)
+ */
+function createList(items, options) {
+    return {
+        items,
+        style: options?.style ?? 'bullet',
+        bulletChar: options?.bulletChar ?? '•',
+        indentSize: options?.indentSize ?? 2
+    };
+}
+/**
+ * Create a simple bullet list
+ */
+function createBulletList(items) {
+    return createList(items, { style: 'bullet' });
+}
+/**
+ * Create a numbered list
+ */
+function createNumberedList(items) {
+    return createList(items, { style: 'number' });
+}

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

@@ -0,0 +1,42 @@
+/**
+ * Table Component
+ * Displays data in a table format with headers and rows
+ */
+/**
+ * Table column configuration
+ */
+export interface TableColumn {
+    /** Column header */
+    header: string;
+    /** Column key in data object */
+    key: string;
+    /** Column width (optional, auto-calculated if not provided) */
+    width?: number;
+    /** Text alignment */
+    align?: 'left' | 'center' | 'right';
+}
+/**
+ * Table configuration
+ */
+export interface TableConfig {
+    /** Table columns */
+    columns: TableColumn[];
+    /** Table data rows */
+    data: Record<string, any>[];
+    /** Show table borders */
+    showBorders?: boolean;
+    /** Show header separator */
+    showHeaderSeparator?: boolean;
+}
+/**
+ * Render table component
+ * @param config - Table configuration
+ */
+export declare function renderTable(config: TableConfig): void;
+/**
+ * Create table configuration (factory function)
+ */
+export declare function createTable(columns: TableColumn[], data: Record<string, any>[], options?: {
+    showBorders?: boolean;
+    showHeaderSeparator?: boolean;
+}): TableConfig;

package/dist/components/display/table.js

@@ -0,0 +1,107 @@
+"use strict";
+/**
+ * Table Component
+ * Displays data in a table format with headers and rows
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderTable = renderTable;
+exports.createTable = createTable;
+const terminal_js_1 = require("../../core/terminal.js");
+/**
+ * Render table component
+ * @param config - Table configuration
+ */
+function renderTable(config) {
+    const { columns, data, showBorders = true, showHeaderSeparator = true } = config;
+    if (columns.length === 0 || data.length === 0) {
+        return;
+    }
+    // Calculate column widths
+    const columnWidths = columns.map((col, index) => {
+        if (col.width)
+            return col.width;
+        // Auto-calculate width based on header and data
+        const headerWidth = col.header.length;
+        const dataWidth = Math.max(...data.map(row => String(row[col.key] || '').length));
+        return Math.max(headerWidth, dataWidth) + 2; // +2 for padding
+    });
+    // Render top border
+    if (showBorders) {
+        const border = columnWidths.map(w => '─'.repeat(w)).join('┬');
+        (0, terminal_js_1.writeLine)(`┌${border}┐`);
+    }
+    // Render header
+    const headerCells = columns.map((col, index) => {
+        const width = columnWidths[index];
+        const align = col.align || 'left';
+        return alignText(col.header, width, align);
+    });
+    if (showBorders) {
+        (0, terminal_js_1.writeLine)(`│${headerCells.join('│')}│`);
+    }
+    else {
+        (0, terminal_js_1.writeLine)(headerCells.join(' '));
+    }
+    // Render header separator
+    if (showHeaderSeparator) {
+        if (showBorders) {
+            const separator = columnWidths.map(w => '─'.repeat(w)).join('┼');
+            (0, terminal_js_1.writeLine)(`├${separator}┤`);
+        }
+        else {
+            const separator = columnWidths.map(w => '─'.repeat(w)).join(' ');
+            (0, terminal_js_1.writeLine)(separator);
+        }
+    }
+    // Render data rows
+    data.forEach((row, rowIndex) => {
+        const cells = columns.map((col, colIndex) => {
+            const width = columnWidths[colIndex];
+            const align = col.align || 'left';
+            const value = String(row[col.key] || '');
+            return alignText(value, width, align);
+        });
+        if (showBorders) {
+            (0, terminal_js_1.writeLine)(`│${cells.join('│')}│`);
+        }
+        else {
+            (0, terminal_js_1.writeLine)(cells.join(' '));
+        }
+    });
+    // Render bottom border
+    if (showBorders) {
+        const border = columnWidths.map(w => '─'.repeat(w)).join('┴');
+        (0, terminal_js_1.writeLine)(`└${border}┘`);
+    }
+}
+/**
+ * Align text within a given width
+ */
+function alignText(text, width, align) {
+    const padding = width - text.length;
+    if (padding <= 0) {
+        return text.substring(0, width);
+    }
+    switch (align) {
+        case 'center':
+            const leftPad = Math.floor(padding / 2);
+            const rightPad = padding - leftPad;
+            return ' '.repeat(leftPad) + text + ' '.repeat(rightPad);
+        case 'right':
+            return ' '.repeat(padding) + text;
+        case 'left':
+        default:
+            return text + ' '.repeat(padding);
+    }
+}
+/**
+ * Create table configuration (factory function)
+ */
+function createTable(columns, data, options) {
+    return {
+        columns,
+        data,
+        showBorders: options?.showBorders ?? true,
+        showHeaderSeparator: options?.showHeaderSeparator ?? true
+    };
+}

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

@@ -8,13 +8,14 @@ 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, defaultValue = true, yesText = (0, registry_js_1.t)('menus.yes'), noText = (0, registry_js_1.t)('menus.no'), orientation = 'horizontal', onExit, preserveOnSelect = false } = config;
     if (orientation === 'horizontal') {
         return showBooleanMenuHorizontal(question, defaultValue, yesText, noText, onExit, preserveOnSelect);
     }

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,20 @@
  */
 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;
     // 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 +73,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

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>;