cli-menu-kit 0.1.26 → 0.2.1

package/dist/api.d.ts

@@ -3,7 +3,7 @@
  * Provides a simple, consistent API for all components
  */
 import { WizardConfig, WizardResult } from './features/wizard.js';
-import { RadioMenuConfig, CheckboxMenuConfig, BooleanMenuConfig, RadioMenuResult, CheckboxMenuResult, BooleanMenuResult } from './types/menu.types.js';
+import { RadioMenuConfig, CheckboxMenuConfig, CheckboxTableMenuConfig, BooleanMenuConfig, RadioMenuResult, CheckboxMenuResult, CheckboxTableMenuResult, BooleanMenuResult } from './types/menu.types.js';
 import { TextInputConfig, NumberInputConfig, LanguageSelectorConfig, ModifyFieldConfig, TextInputResult, NumberInputResult, LanguageSelectorResult, ModifyFieldResult } from './types/input.types.js';
 /**
  * Unified menu API
@@ -12,15 +12,24 @@ export declare const menuAPI: {
     /**
      * Show a radio menu (single-select)
      * @param config - Menu configuration
+     * @param hints - Optional hints for Page Layout footer
      * @returns Promise resolving to selected option
      */
-    radio: (config: RadioMenuConfig) => Promise<RadioMenuResult>;
+    radio: (config: RadioMenuConfig, hints?: string[]) => Promise<RadioMenuResult>;
     /**
      * Show a checkbox menu (multi-select)
      * @param config - Menu configuration
+     * @param hints - Optional hints for Page Layout footer
      * @returns Promise resolving to selected options
      */
-    checkbox: (config: CheckboxMenuConfig) => Promise<CheckboxMenuResult>;
+    checkbox: (config: CheckboxMenuConfig, hints?: string[]) => Promise<CheckboxMenuResult>;
+    /**
+     * Show a checkbox table menu (multi-select with table display)
+     * @param config - Menu configuration
+     * @param hints - Optional hints for Page Layout footer
+     * @returns Promise resolving to selected rows
+     */
+    checkboxTable: (config: CheckboxTableMenuConfig, hints?: string[]) => Promise<CheckboxTableMenuResult>;
     /**
      * Show a boolean menu (yes/no)
      * @param config - Menu configuration
@@ -90,15 +99,24 @@ declare const _default: {
         /**
          * Show a radio menu (single-select)
          * @param config - Menu configuration
+         * @param hints - Optional hints for Page Layout footer
          * @returns Promise resolving to selected option
          */
-        radio: (config: RadioMenuConfig) => Promise<RadioMenuResult>;
+        radio: (config: RadioMenuConfig, hints?: string[]) => Promise<RadioMenuResult>;
         /**
          * Show a checkbox menu (multi-select)
          * @param config - Menu configuration
+         * @param hints - Optional hints for Page Layout footer
          * @returns Promise resolving to selected options
          */
-        checkbox: (config: CheckboxMenuConfig) => Promise<CheckboxMenuResult>;
+        checkbox: (config: CheckboxMenuConfig, hints?: string[]) => Promise<CheckboxMenuResult>;
+        /**
+         * Show a checkbox table menu (multi-select with table display)
+         * @param config - Menu configuration
+         * @param hints - Optional hints for Page Layout footer
+         * @returns Promise resolving to selected rows
+         */
+        checkboxTable: (config: CheckboxTableMenuConfig, hints?: string[]) => Promise<CheckboxTableMenuResult>;
         /**
          * Show a boolean menu (yes/no)
          * @param config - Menu configuration

package/dist/api.js

@@ -7,6 +7,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.wizardAPI = exports.inputAPI = exports.menuAPI = void 0;
 const radio_menu_js_1 = require("./components/menus/radio-menu.js");
 const checkbox_menu_js_1 = require("./components/menus/checkbox-menu.js");
+const checkbox_table_menu_js_1 = require("./components/menus/checkbox-table-menu.js");
 const boolean_menu_js_1 = require("./components/menus/boolean-menu.js");
 const text_input_js_1 = require("./components/inputs/text-input.js");
 const number_input_js_1 = require("./components/inputs/number-input.js");
@@ -20,18 +21,29 @@ exports.menuAPI = {
     /**
      * Show a radio menu (single-select)
      * @param config - Menu configuration
+     * @param hints - Optional hints for Page Layout footer
      * @returns Promise resolving to selected option
      */
-    radio: (config) => {
-        return (0, radio_menu_js_1.showRadioMenu)(config);
+    radio: (config, hints) => {
+        return (0, radio_menu_js_1.showRadioMenu)(config, hints);
     },
     /**
      * Show a checkbox menu (multi-select)
      * @param config - Menu configuration
+     * @param hints - Optional hints for Page Layout footer
      * @returns Promise resolving to selected options
      */
-    checkbox: (config) => {
-        return (0, checkbox_menu_js_1.showCheckboxMenu)(config);
+    checkbox: (config, hints) => {
+        return (0, checkbox_menu_js_1.showCheckboxMenu)(config, hints);
+    },
+    /**
+     * Show a checkbox table menu (multi-select with table display)
+     * @param config - Menu configuration
+     * @param hints - Optional hints for Page Layout footer
+     * @returns Promise resolving to selected rows
+     */
+    checkboxTable: (config, hints) => {
+        return (0, checkbox_table_menu_js_1.showCheckboxTableMenu)(config, hints);
     },
     /**
      * Show a boolean menu (yes/no)

package/dist/component-factories.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Component Factories
+ *
+ * Factory functions to create common components
+ * These are helper functions to simplify component creation
+ *
+ * NOTE: These are legacy factories that need to be updated to return string arrays
+ * For now, they are kept for backward compatibility but will be deprecated
+ */
+import type { HeaderConfig } from './components/display/header.js';
+import type { TableConfig } from './components/display/table.js';
+import type { ListConfig } from './components/display/list.js';
+import type { SummaryTableConfig } from './types/display.types.js';
+import type { RadioMenuConfig } from './types/menu.types.js';
+/**
+ * Create a full header component (with ASCII art)
+ * LEGACY: Returns void, needs update to return string[]
+ */
+export declare function createFullHeaderComponent(config: HeaderConfig): any;
+/**
+ * Create a simple header component
+ * LEGACY: Returns void, needs update to return string[]
+ */
+export declare function createSimpleHeaderComponent(text: string): any;
+/**
+ * Create a section header component
+ * LEGACY: Returns void, needs update to return string[]
+ */
+export declare function createSectionHeaderComponent(text: string, width?: number): any;
+/**
+ * Create a hints component
+ * LEGACY: Returns void, needs update to return string[]
+ */
+export declare function createHintsComponent(hints: string[]): any;
+/**
+ * Create a table component
+ * LEGACY: Returns void, needs update to return string[]
+ */
+export declare function createTableComponent(config: TableConfig): any;
+/**
+ * Create a list component
+ * LEGACY: Returns void, needs update to return string[]
+ */
+export declare function createListComponent(config: ListConfig): any;
+/**
+ * Create a summary table component
+ * LEGACY: Returns void, needs update to return string[]
+ */
+export declare function createSummaryTableComponent(config: SummaryTableConfig): any;
+/**
+ * Export input prompt component creator
+ */
+export { createInputPromptComponent } from './components/display/input-prompt.js';
+/**
+ * Create an interactive menu component (radio menu)
+ * Separates rendering and interaction for proper Page Layout integration
+ * LEGACY: Needs update to use new architecture
+ */
+export declare function createRadioMenuComponent(config: RadioMenuConfig, onResult: (result: any) => void | Promise<void>): any;

package/dist/component-factories.js

@@ -0,0 +1,141 @@
+"use strict";
+/**
+ * Component Factories
+ *
+ * Factory functions to create common components
+ * These are helper functions to simplify component creation
+ *
+ * NOTE: These are legacy factories that need to be updated to return string arrays
+ * For now, they are kept for backward compatibility but will be deprecated
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createInputPromptComponent = void 0;
+exports.createFullHeaderComponent = createFullHeaderComponent;
+exports.createSimpleHeaderComponent = createSimpleHeaderComponent;
+exports.createSectionHeaderComponent = createSectionHeaderComponent;
+exports.createHintsComponent = createHintsComponent;
+exports.createTableComponent = createTableComponent;
+exports.createListComponent = createListComponent;
+exports.createSummaryTableComponent = createSummaryTableComponent;
+exports.createRadioMenuComponent = createRadioMenuComponent;
+const header_js_1 = require("./components/display/header.js");
+const headers_js_1 = require("./components/display/headers.js");
+const renderer_js_1 = require("./core/renderer.js");
+const table_js_1 = require("./components/display/table.js");
+const list_js_1 = require("./components/display/list.js");
+const summary_js_1 = require("./components/display/summary.js");
+const radio_menu_split_js_1 = require("./components/menus/radio-menu-split.js");
+/**
+ * Create a full header component (with ASCII art)
+ * LEGACY: Returns void, needs update to return string[]
+ */
+function createFullHeaderComponent(config) {
+    return {
+        type: 'full-header',
+        regionId: 'header',
+        render: () => (0, header_js_1.renderHeader)(config),
+        config
+    };
+}
+/**
+ * Create a simple header component
+ * LEGACY: Returns void, needs update to return string[]
+ */
+function createSimpleHeaderComponent(text) {
+    return {
+        type: 'simple-header',
+        regionId: 'header',
+        render: () => (0, headers_js_1.renderSimpleHeader)(text),
+        config: { text }
+    };
+}
+/**
+ * Create a section header component
+ * LEGACY: Returns void, needs update to return string[]
+ */
+function createSectionHeaderComponent(text, width) {
+    return {
+        type: 'section-header',
+        regionId: 'header',
+        render: () => (0, headers_js_1.renderSectionHeader)(text, width || 50),
+        config: { text, width }
+    };
+}
+/**
+ * Create a hints component
+ * LEGACY: Returns void, needs update to return string[]
+ */
+function createHintsComponent(hints) {
+    return {
+        type: 'hints',
+        regionId: 'footerHints',
+        render: () => (0, renderer_js_1.renderHints)(hints),
+        config: { hints }
+    };
+}
+/**
+ * Create a table component
+ * LEGACY: Returns void, needs update to return string[]
+ */
+function createTableComponent(config) {
+    return {
+        type: 'table',
+        regionId: 'main',
+        render: () => (0, table_js_1.renderTable)(config),
+        config
+    };
+}
+/**
+ * Create a list component
+ * LEGACY: Returns void, needs update to return string[]
+ */
+function createListComponent(config) {
+    return {
+        type: 'list',
+        regionId: 'main',
+        render: () => (0, list_js_1.renderList)(config),
+        config
+    };
+}
+/**
+ * Create a summary table component
+ * LEGACY: Returns void, needs update to return string[]
+ */
+function createSummaryTableComponent(config) {
+    return {
+        type: 'summary-table',
+        regionId: 'main',
+        render: () => (0, summary_js_1.renderSummaryTable)(config),
+        config
+    };
+}
+/**
+ * Export input prompt component creator
+ */
+var input_prompt_js_1 = require("./components/display/input-prompt.js");
+Object.defineProperty(exports, "createInputPromptComponent", { enumerable: true, get: function () { return input_prompt_js_1.createInputPromptComponent; } });
+/**
+ * Create an interactive menu component (radio menu)
+ * Separates rendering and interaction for proper Page Layout integration
+ * LEGACY: Needs update to use new architecture
+ */
+function createRadioMenuComponent(config, onResult) {
+    let menuState = null;
+    return {
+        type: 'radio-menu',
+        regionId: 'main',
+        render: () => {
+            // Render menu UI (non-blocking)
+            menuState = (0, radio_menu_split_js_1.renderRadioMenuUI)(config);
+        },
+        interact: async () => {
+            // Wait for user input (blocking)
+            if (!menuState) {
+                throw new Error('Menu must be rendered before interaction');
+            }
+            const result = await (0, radio_menu_split_js_1.waitForRadioMenuInput)(menuState);
+            await onResult(result);
+        },
+        config
+    };
+}

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

@@ -0,0 +1,13 @@
+/**
+ * Full Header Component - New Architecture Version
+ * Returns string arrays instead of writing to stdout
+ */
+import { Component } from '../../layout.js';
+export interface FullHeaderConfig {
+    asciiArt: string[];
+    title: string;
+    description?: string;
+    version?: string;
+    url?: string;
+}
+export declare function createFullHeaderComponentV2(config: FullHeaderConfig): Component;

package/dist/components/display/header-v2.js

@@ -0,0 +1,43 @@
+"use strict";
+/**
+ * Full Header Component - New Architecture Version
+ * Returns string arrays instead of writing to stdout
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createFullHeaderComponentV2 = createFullHeaderComponentV2;
+const colors_js_1 = require("../../core/colors.js");
+function createFullHeaderComponentV2(config) {
+    return {
+        type: 'full-header',
+        regionId: 'header',
+        render: (rect) => {
+            const lines = [];
+            // ASCII Art
+            config.asciiArt.forEach(line => {
+                lines.push(`${colors_js_1.colors.cyan}${line}${colors_js_1.colors.reset}`);
+            });
+            // Empty line
+            lines.push('');
+            // Title and description
+            const titleLine = config.version
+                ? `${colors_js_1.colors.bold}${config.title}${colors_js_1.colors.reset} ${colors_js_1.colors.dim}v${config.version}${colors_js_1.colors.reset}`
+                : `${colors_js_1.colors.bold}${config.title}${colors_js_1.colors.reset}`;
+            lines.push(titleLine);
+            if (config.description) {
+                lines.push(`${colors_js_1.colors.dim}${config.description}${colors_js_1.colors.reset}`);
+            }
+            if (config.url) {
+                lines.push(`${colors_js_1.colors.dim}${config.url}${colors_js_1.colors.reset}`);
+            }
+            // Separator
+            lines.push('');
+            lines.push(`${colors_js_1.colors.dim}${'─'.repeat(Math.min(rect.width, 80))}${colors_js_1.colors.reset}`);
+            // Fill remaining lines to match rect height
+            while (lines.length < rect.height) {
+                lines.push('');
+            }
+            return lines;
+        },
+        config
+    };
+}

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

@@ -2,16 +2,39 @@
  * Header component for CLI applications
  * Displays ASCII art, title, description, version and URL
  */
+type FigletSize = 'small' | 'medium' | 'large';
 /**
  * Header configuration
  */
 export interface HeaderConfig {
     /** ASCII art lines (array of strings) */
     asciiArt?: string[];
+    /** Generate ASCII art from figlet text (overrides asciiArt when provided) */
+    figletText?: string;
+    /** Figlet font name (raw figlet name, e.g. "ANSI Shadow", "Standard", "Block") */
+    figletFont?: string;
+    /** Figlet size preset (default: medium) */
+    figletSize?: FigletSize;
+    /** Scale figlet output (1-4, default: 1) */
+    figletScale?: number;
+    /** Optional vertical scale override (0.4-4) */
+    figletScaleY?: number;
     /** Application title */
     title?: string;
+    /** Optional explicit color for title line */
+    titleColor?: string;
+    /** Optional ANSI start color for title gradient */
+    titleGradientStart?: string;
+    /** Optional ANSI end color for title gradient */
+    titleGradientEnd?: string;
     /** Application description */
     description?: string;
+    /** Optional explicit color for description line */
+    descriptionColor?: string;
+    /** Optional ANSI start color for description gradient */
+    descriptionGradientStart?: string;
+    /** Optional ANSI end color for description gradient */
+    descriptionGradientEnd?: string;
     /** Version number */
     version?: string;
     /** Project URL */
@@ -20,11 +43,28 @@ export interface HeaderConfig {
     menuTitle?: string;
     /** Box width (default: 60) */
     boxWidth?: number;
+    /** Toggle outer border box (default: true) */
+    showBoxBorder?: boolean;
+    /** Fill header box content area background (default: false) */
+    fillBox?: boolean;
+    /** ANSI background color for box fill (default: bgBlack) */
+    fillBoxColor?: string;
+    /** Optional ANSI background gradient start color for box fill */
+    fillBoxGradientStart?: string;
+    /** Optional ANSI background gradient end color for box fill */
+    fillBoxGradientEnd?: string;
     /** Header color (default: cyan) */
     color?: string;
+    /** Optional explicit color for ASCII art/logo lines */
+    asciiArtColor?: string;
+    /** Optional ANSI start color for ASCII art gradient */
+    asciiArtGradientStart?: string;
+    /** Optional ANSI end color for ASCII art gradient */
+    asciiArtGradientEnd?: string;
 }
 /**
  * Render a boxed header with ASCII art, title, and description
  * @param config - Header configuration
  */
 export declare function renderHeader(config: HeaderConfig): void;
+export {};