mepcli 0.2.6 → 0.3.0

package/dist/base.d.ts

@@ -47,6 +47,11 @@ export declare abstract class Prompt<T, O> {
      * Render Method with Diffing (Virtual DOM for CLI).
      * Calculates new lines, compares with old lines, and updates only changed parts.
      */
+    /**
+     * Renders the current frame by clearing the previous output and writing the new content.
+     * This approach ("Move Up -> Erase Down -> Print") is more robust against artifacts
+     * than line-by-line diffing, especially when the number of lines changes (e.g., filtering).
+     */
     protected renderFrame(content: string): void;
     protected stripAnsi(str: string): string;
     protected truncate(str: string, width: number): string;

package/dist/base.js

@@ -93,170 +93,37 @@ class Prompt {
      * Render Method with Diffing (Virtual DOM for CLI).
      * Calculates new lines, compares with old lines, and updates only changed parts.
      */
+    /**
+     * Renders the current frame by clearing the previous output and writing the new content.
+     * This approach ("Move Up -> Erase Down -> Print") is more robust against artifacts
+     * than line-by-line diffing, especially when the number of lines changes (e.g., filtering).
+     */
     renderFrame(content) {
-        // Ensure lines are truncated to terminal width
         const width = this.stdout.columns || 80;
         const rawLines = content.split('\n');
-        // Truncate each line and prepare the new buffer
+        // Truncate each line to fit terminal width to avoid wrapping issues
         const newLines = rawLines.map(line => this.truncate(line, width));
-        // Cursor logic:
-        // We assume the cursor is currently at the END of the last rendered frame.
-        // But to diff, it's easier to always reset to the top of the frame first.
-        // 1. Move Cursor to Top of the Frame
+        // 1. Move cursor to the start of the current line
+        this.print(ansi_1.ANSI.CURSOR_LEFT);
+        // 2. Move cursor up to the top of the previously rendered frame
         if (this.lastRenderHeight > 0) {
-            this.print(`\x1b[${this.lastRenderHeight}A`); // Move up N lines
-            // Actually, if last height was 1 (just one line), we move up 1 line?
-            // "A\n" -> 2 lines. Cursor at bottom.
-            // If we move up, we are at top.
-            // Wait, if lastRenderHeight includes the "current line" which is usually empty if we printed with newlines?
-            // Let's stick to: we printed N lines. Cursor is at line N+1 (start).
-            // To go to line 1, we move up N lines.
-            this.print(`\x1b[${this.lastRenderHeight}A`);
+            // If the previous render had multiple lines, move up to the first line
+            if (this.lastRenderHeight > 1) {
+                this.print(`\x1b[${this.lastRenderHeight - 1}A`);
+            }
         }
-        this.print(ansi_1.ANSI.CURSOR_LEFT);
-        // 2. Diff and Render
-        // We iterate through newLines.
-        // For each line, check if it matches lastRenderLines[i].
+        // 3. Clear everything from the cursor down
+        // This ensures all previous content (including "ghost" lines) is removed
+        this.print(ansi_1.ANSI.ERASE_DOWN);
+        // 4. Print the new frame content
         for (let i = 0; i < newLines.length; i++) {
-            const newLine = newLines[i];
-            const oldLine = this.lastRenderLines[i];
-            if (newLine !== oldLine) {
-                // Move to this line if not already there?
-                // We are writing sequentially, so after writing line i-1 (or skipping it),
-                // the cursor might not be at the start of line i if we skipped.
-                // Strategy:
-                // If we skipped lines, we need to jump down.
-                // But simpler: just move cursor to line i relative to top.
-                // \x1b[<N>B moves down N lines.
-                // But we are processing sequentially.
-                // If we are at line 0 (Top).
-                // Process line 0. 
-                // If changed, write it + \n (or clear line + write).
-                // If unchanged, move cursor down 1 line.
-                // Wait, if we use \n at end of write, cursor moves down.
-                // If we skip writing, we must manually move down.
-                this.print(ansi_1.ANSI.ERASE_LINE); // Clear current line
-                this.print(newLine);
-            }
-            // Prepare for next line
+            this.print(newLines[i]);
+            // Add newline character between lines, but not after the last line
             if (i < newLines.length - 1) {
-                // If we wrote something, we are at end of line (maybe wrapped?).
-                // Since we truncate, we are not wrapped.
-                // But we didn't print \n yet if we just printed newLine.
-                // To move to next line start:
                 this.print('\n');
             }
         }
-        // 3. Clear remaining lines if new output is shorter
-        if (newLines.length < this.lastRenderLines.length) {
-            // We are at the last line of new output.
-            // BUG FIX: If the last line was unchanged, we skipped printing.
-            // The cursor is currently at the START of that line (or end of previous).
-            // We need to ensure we move to the NEXT line (or end of current) before clearing down.
-            // If we just finished loop `i = newLines.length - 1`, we are theoretically at the end of the content.
-            // However, since we might have skipped the last line, we need to be careful.
-            // Let's force move to the end of the visual content we just defined.
-            // Actually, simplest way: Just move cursor to start of line N (where N = newLines.length).
-            // Currently we are at line newLines.length - 1.
-            // We need to move down 1 line?
-            // If newLines has 1 line. Loop runs 0.
-            // If skipped, we are at start of line 0.
-            // We need to be at line 1 to clear from there down.
-            // But we didn't print \n.
-            // So: move cursor to (newLines.length) relative to top.
-            // We started at Top.
-            // We iterated newLines.
-            // We injected \n between lines.
-            // The cursor is implicitly tracking where we are.
-            // IF we skipped, we are physically at start of line `i`.
-            // We need to move over it.
-            // Fix: After the loop, explicitly move to the line AFTER the last line.
-            // Since we know where we started (Top), we can just jump to line `newLines.length`.
-            // But we are in relative movement land.
-            // Let's calculate where we *should* be: End of content.
-            // If we just rendered N lines, we want to be at line N+1 (conceptually) to clear below?
-            // Or just at the start of line N+1?
-            // If we have 2 lines. 
-            // Line 0. \n. Line 1.
-            // Cursor is at end of Line 1.
-            // If we skipped Line 1, cursor is at start of Line 1.
-            // We want to clear everything BELOW Line 1.
-            // So we should be at start of Line 2.
-            // Logic:
-            // 1. We are currently at the cursor position after processing `newLines`.
-            //    If last line was skipped, we are at start of last line.
-            //    If last line was written, we are at end of last line.
-            // 2. We want to erase from the line *following* the last valid line.
-            // We can just calculate the difference and move down if needed.
-            // But simpler: Move cursor to the conceptual "end" of the new frame.
-            // If we processed `newLines.length` lines.
-            // We want to be at row `newLines.length` (0-indexed) to start clearing?
-            // No, rows are 0 to N-1.
-            // We want to clear starting from row N.
-            // Since we can't easily query cursor pos, let's use the fact we reset to Top.
-            // We can move to row N relative to current? 
-            // Wait, `ERASE_DOWN` clears from cursor to end of screen.
-            // If we are at start of Line 1 (and it's valid), `ERASE_DOWN` deletes Line 1!
-            // So we MUST be past Line 1.
-            // If we skipped the last line, we must strictly move past it.
-            // How? `\x1b[1B` (Down).
-            // But we don't track if we skipped the last line explicitly outside the loop.
-            // Let's just track `currentLineIndex`.
-            // Alternate robust approach:
-            // After loop, we forcefully move cursor to `newLines.length` lines down from Top.
-            // We are currently at some unknown state (Start or End of last line).
-            // BUT we can just move UP to Top again and then move DOWN N lines.
-            // That feels safe.
-            // Reset to top of frame (which we are already inside/near).
-            // But we don't know exactly where we are relative to top anymore.
-            // Let's rely on the loop index.
-            // If loop finished, `i` was `newLines.length`.
-            // If `newLines.length > 0`.
-            // If we skipped the last line (index `len-1`), we are at start of it.
-            // If we wrote it, we are at end of it.
-            // If we skipped, we need `\x1b[1B`.
-            // If we wrote, we are at end. `ERASE_DOWN` from end of line clears rest of line + below.
-            // BUT we want to clear BELOW.
-            // `ERASE_DOWN` (J=0) clears from cursor to end of screen.
-            // If at end of line, it clears rest of that line (nothing) and lines below. Correct.
-            // So the issue is ONLY when we skipped the last line.
-            const lastLineIdx = newLines.length - 1;
-            if (lastLineIdx >= 0 && newLines[lastLineIdx] === this.lastRenderLines[lastLineIdx]) {
-                // We skipped the last line. Move down 1 line to ensure we don't delete it.
-                // Also move to start (CR) to be safe?
-                this.print('\n');
-                // Wait, \n moves down AND to start usually. 
-                // But strictly \n is Line Feed (Down). \r is Carriage Return (Left).
-                // Console usually treats \n as \r\n in cooked mode, but in raw mode?
-                // We are in raw mode.
-                // We likely need \r\n or explicit movement.
-                // Let's just use \x1b[1B (Down) and \r (Left).
-                // Actually, if we use `\n` in loop, we rely on it working.
-                // Let's assume `\x1b[1B` is safer for "just move down".
-                // But wait, if we are at start of line, `1B` puts us at start of next line.
-                // `ERASE_DOWN` there is perfect.
-                this.print('\x1b[1B');
-                this.print('\r'); // Move to start
-            }
-            else {
-                // We wrote the last line. We are at the end of it.
-                // `ERASE_DOWN` will clear lines below.
-                // BUT if we want to clear the REST of the screen cleanly starting from next line...
-                // It's mostly fine.
-                // However, there is a subtle case: 
-                // If we wrote the line, we are at the end of it.
-                // If we call ERASE_DOWN, it keeps current line intact (from cursor onwards, which is empty).
-                // And clears below.
-                // This is correct.
-                // EXCEPT: If the old screen had MORE lines, we want to clear them.
-                // If we are at end of Line N-1.
-                // Line N exists in old screen.
-                // ERASE_DOWN clears Line N etc.
-                // Correct.
-            }
-            this.print(ansi_1.ANSI.ERASE_DOWN);
-        }
-        // Update state
+        // 5. Update state for the next render cycle
         this.lastRenderLines = newLines;
         this.lastRenderHeight = newLines.length;
     }
@@ -272,10 +139,6 @@ class Prompt {
         // We iterate and sum width until we hit limit - 3
         let currentWidth = 0;
         let cutIndex = 0;
-        // We need to iterate by Code Point or Grapheme to be safe?
-        // Let's use simple char iteration for speed, but respect ANSI.
-        // Actually, reusing the logic from stringWidth might be best but 
-        // we need the index.
         let inAnsi = false;
         for (let i = 0; i < str.length; i++) {
             const code = str.charCodeAt(i);

package/dist/core.d.ts

@@ -9,8 +9,8 @@ export declare class MepCLI {
      */
     static spin<T>(message: string, taskPromise: Promise<T>): Promise<T>;
     static text(options: TextOptions): Promise<string>;
-    static select(options: SelectOptions): Promise<any>;
-    static checkbox(options: CheckboxOptions): Promise<any[]>;
+    static select<const V>(options: SelectOptions<V>): Promise<V>;
+    static checkbox<const V>(options: CheckboxOptions<V>): Promise<V[]>;
     static confirm(options: ConfirmOptions): Promise<boolean>;
     static password(options: TextOptions): Promise<string>;
     static number(options: NumberOptions): Promise<number>;
@@ -19,5 +19,5 @@ export declare class MepCLI {
     static slider(options: SliderOptions): Promise<number>;
     static date(options: DateOptions): Promise<Date>;
     static file(options: FileOptions): Promise<string>;
-    static multiSelect(options: MultiSelectOptions): Promise<any[]>;
+    static multiSelect<const V>(options: MultiSelectOptions<V>): Promise<V[]>;
 }

package/dist/core.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.MepCLI = void 0;
 const ansi_1 = require("./ansi");
 const theme_1 = require("./theme");
+const symbols_1 = require("./symbols");
 const text_1 = require("./prompts/text");
 const select_1 = require("./prompts/select");
 const checkbox_1 = require("./prompts/checkbox");
@@ -22,7 +23,7 @@ class MepCLI {
      * Shows a spinner while a promise is pending.
      */
     static async spin(message, taskPromise) {
-        const frames = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'];
+        const frames = symbols_1.symbols.spinner;
         let i = 0;
         process.stdout.write(ansi_1.ANSI.HIDE_CURSOR);
         const interval = setInterval(() => {
@@ -32,13 +33,13 @@ class MepCLI {
         try {
             const result = await taskPromise;
             clearInterval(interval);
-            process.stdout.write(`${ansi_1.ANSI.ERASE_LINE}${ansi_1.ANSI.CURSOR_LEFT}${MepCLI.theme.success}✔${ansi_1.ANSI.RESET} ${message}\n`);
+            process.stdout.write(`${ansi_1.ANSI.ERASE_LINE}${ansi_1.ANSI.CURSOR_LEFT}${MepCLI.theme.success}${symbols_1.symbols.tick}${ansi_1.ANSI.RESET} ${message}\n`);
             process.stdout.write(ansi_1.ANSI.SHOW_CURSOR);
             return result;
         }
         catch (error) {
             clearInterval(interval);
-            process.stdout.write(`${ansi_1.ANSI.ERASE_LINE}${ansi_1.ANSI.CURSOR_LEFT}${MepCLI.theme.error}✖${ansi_1.ANSI.RESET} ${message}\n`);
+            process.stdout.write(`${ansi_1.ANSI.ERASE_LINE}${ansi_1.ANSI.CURSOR_LEFT}${MepCLI.theme.error}${symbols_1.symbols.cross}${ansi_1.ANSI.RESET} ${message}\n`);
             process.stdout.write(ansi_1.ANSI.SHOW_CURSOR);
             throw error;
         }

package/dist/prompts/checkbox.d.ts

@@ -1,12 +1,12 @@
 import { Prompt } from '../base';
 import { CheckboxOptions } from '../types';
-export declare class CheckboxPrompt extends Prompt<any[], CheckboxOptions> {
+export declare class CheckboxPrompt<V> extends Prompt<any[], CheckboxOptions<V>> {
     private selectedIndex;
     private checkedState;
     private errorMsg;
     private scrollTop;
     private readonly pageSize;
-    constructor(options: CheckboxOptions);
+    constructor(options: CheckboxOptions<V>);
     protected render(firstRender: boolean): void;
     protected handleInput(char: string): void;
 }

package/dist/prompts/checkbox.js

@@ -4,6 +4,7 @@ exports.CheckboxPrompt = void 0;
 const ansi_1 = require("../ansi");
 const base_1 = require("../base");
 const theme_1 = require("../theme");
+const symbols_1 = require("../symbols");
 // --- Implementation: Checkbox Prompt ---
 class CheckboxPrompt extends base_1.Prompt {
     constructor(options) {
@@ -29,7 +30,7 @@ class CheckboxPrompt extends base_1.Prompt {
         }
         let output = '';
         // Header
-        const icon = this.errorMsg ? `${theme_1.theme.error}✖` : `${theme_1.theme.success}?`;
+        const icon = this.errorMsg ? `${theme_1.theme.error}${symbols_1.symbols.cross}` : `${theme_1.theme.success}?`;
         output += `${icon} ${ansi_1.ANSI.BOLD}${theme_1.theme.title}${this.options.message}${ansi_1.ANSI.RESET} ${theme_1.theme.muted}(Press <space> to select, <enter> to confirm)${ansi_1.ANSI.RESET}`;
         // List
         const choices = this.options.choices;
@@ -37,11 +38,11 @@ class CheckboxPrompt extends base_1.Prompt {
         visibleChoices.forEach((choice, index) => {
             const actualIndex = this.scrollTop + index;
             output += '\n'; // New line for each item
-            const cursor = actualIndex === this.selectedIndex ? `${theme_1.theme.main}❯${ansi_1.ANSI.RESET}` : ' ';
+            const cursor = actualIndex === this.selectedIndex ? `${theme_1.theme.main}${symbols_1.symbols.pointer}${ansi_1.ANSI.RESET}` : ' ';
             const isChecked = this.checkedState[actualIndex];
             const checkbox = isChecked
-                ? `${theme_1.theme.success}◉${ansi_1.ANSI.RESET}`
-                : `${theme_1.theme.muted}◯${ansi_1.ANSI.RESET}`;
+                ? `${theme_1.theme.success}${symbols_1.symbols.checked}${ansi_1.ANSI.RESET}`
+                : `${theme_1.theme.muted}${symbols_1.symbols.unchecked}${ansi_1.ANSI.RESET}`;
             const title = actualIndex === this.selectedIndex
                 ? `${theme_1.theme.main}${choice.title}${ansi_1.ANSI.RESET}`
                 : choice.title;

package/dist/prompts/date.js

@@ -4,6 +4,7 @@ exports.DatePrompt = void 0;
 const ansi_1 = require("../ansi");
 const base_1 = require("../base");
 const theme_1 = require("../theme");
+const symbols_1 = require("../symbols");
 // --- Implementation: Date Prompt ---
 class DatePrompt extends base_1.Prompt {
     constructor(options) {
@@ -26,7 +27,7 @@ class DatePrompt extends base_1.Prompt {
                 return `${theme_1.theme.main}${ansi_1.ANSI.UNDERLINE}${val}${ansi_1.ANSI.RESET}`;
             return val;
         });
-        const icon = this.errorMsg ? `${theme_1.theme.error}✖` : `${theme_1.theme.success}?`;
+        const icon = this.errorMsg ? `${theme_1.theme.error}${symbols_1.symbols.cross}` : `${theme_1.theme.success}?`;
         const dateStr = `${display[0]}-${display[1]}-${display[2]} ${display[3]}:${display[4]}`;
         let output = `${icon} ${ansi_1.ANSI.BOLD}${theme_1.theme.title}${this.options.message}${ansi_1.ANSI.RESET} ${dateStr} ${theme_1.theme.muted}(Use arrows or type)${ansi_1.ANSI.RESET}`;
         if (this.errorMsg) {

package/dist/prompts/file.js

@@ -37,6 +37,7 @@ exports.FilePrompt = void 0;
 const ansi_1 = require("../ansi");
 const base_1 = require("../base");
 const theme_1 = require("../theme");
+const symbols_1 = require("../symbols");
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
 // --- Implementation: File Prompt ---
@@ -96,7 +97,7 @@ class FilePrompt extends base_1.Prompt {
     }
     render(firstRender) {
         // Construct string
-        const icon = this.errorMsg ? `${theme_1.theme.error}✖` : `${theme_1.theme.success}?`;
+        const icon = this.errorMsg ? `${theme_1.theme.error}${symbols_1.symbols.cross}` : `${theme_1.theme.success}?`;
         let output = `${icon} ${ansi_1.ANSI.BOLD}${theme_1.theme.title}${this.options.message}${ansi_1.ANSI.RESET} ${this.input}`;
         // Suggestions
         if (this.suggestions.length > 0) {
@@ -107,7 +108,7 @@ class FilePrompt extends base_1.Prompt {
                 if (i > 0)
                     output += '\n';
                 if (i === this.selectedSuggestion) {
-                    output += `${theme_1.theme.main}❯ ${s}${ansi_1.ANSI.RESET}`;
+                    output += `${theme_1.theme.main}${symbols_1.symbols.pointer} ${s}${ansi_1.ANSI.RESET}`;
                 }
                 else {
                     output += `  ${s}`;

package/dist/prompts/list.js

@@ -4,6 +4,7 @@ exports.ListPrompt = void 0;
 const ansi_1 = require("../ansi");
 const base_1 = require("../base");
 const theme_1 = require("../theme");
+const symbols_1 = require("../symbols");
 // --- Implementation: List Prompt ---
 class ListPrompt extends base_1.Prompt {
     constructor(options) {
@@ -14,7 +15,7 @@ class ListPrompt extends base_1.Prompt {
     }
     render(firstRender) {
         // Prepare content
-        const icon = this.errorMsg ? `${theme_1.theme.error}✖` : `${theme_1.theme.success}?`;
+        const icon = this.errorMsg ? `${theme_1.theme.error}${symbols_1.symbols.cross}` : `${theme_1.theme.success}?`;
         let mainLine = `${icon} ${ansi_1.ANSI.BOLD}${theme_1.theme.title}${this.options.message}${ansi_1.ANSI.RESET} `;
         // Render Tags
         if (this.value.length > 0) {

package/dist/prompts/multi-select.d.ts

@@ -1,13 +1,13 @@
 import { Prompt } from '../base';
 import { MultiSelectOptions } from '../types';
-export declare class MultiSelectPrompt extends Prompt<any[], MultiSelectOptions> {
+export declare class MultiSelectPrompt<V> extends Prompt<any[], MultiSelectOptions<V>> {
     private selectedIndex;
     private checkedState;
     private searchBuffer;
     private scrollTop;
     private readonly pageSize;
     private errorMsg;
-    constructor(options: MultiSelectOptions);
+    constructor(options: MultiSelectOptions<V>);
     private getFilteredChoices;
     protected render(firstRender: boolean): void;
     protected handleInput(char: string): void;

package/dist/prompts/multi-select.js

@@ -4,6 +4,7 @@ exports.MultiSelectPrompt = void 0;
 const ansi_1 = require("../ansi");
 const base_1 = require("../base");
 const theme_1 = require("../theme");
+const symbols_1 = require("../symbols");
 // --- Implementation: MultiSelect Prompt ---
 class MultiSelectPrompt extends base_1.Prompt {
     constructor(options) {
@@ -36,7 +37,7 @@ class MultiSelectPrompt extends base_1.Prompt {
         if (this.scrollTop > choices.length - 1) {
             this.scrollTop = Math.max(0, choices.length - this.pageSize);
         }
-        const icon = this.errorMsg ? `${theme_1.theme.error}✖` : `${theme_1.theme.success}?`;
+        const icon = this.errorMsg ? `${theme_1.theme.error}${symbols_1.symbols.cross}` : `${theme_1.theme.success}?`;
         const searchStr = this.searchBuffer ? ` ${theme_1.theme.muted}(Filter: ${this.searchBuffer})${ansi_1.ANSI.RESET}` : '';
         output += `${icon} ${ansi_1.ANSI.BOLD}${theme_1.theme.title}${this.options.message}${ansi_1.ANSI.RESET}${searchStr}\n`;
         if (choices.length === 0) {
@@ -48,11 +49,11 @@ class MultiSelectPrompt extends base_1.Prompt {
                 if (index > 0)
                     output += '\n';
                 const actualIndex = this.scrollTop + index;
-                const cursor = actualIndex === this.selectedIndex ? `${theme_1.theme.main}❯${ansi_1.ANSI.RESET}` : ' ';
+                const cursor = actualIndex === this.selectedIndex ? `${theme_1.theme.main}${symbols_1.symbols.pointer}${ansi_1.ANSI.RESET}` : ' ';
                 const isChecked = this.checkedState[choice.originalIndex];
                 const checkbox = isChecked
-                    ? `${theme_1.theme.success}◉${ansi_1.ANSI.RESET}`
-                    : `${theme_1.theme.muted}◯${ansi_1.ANSI.RESET}`;
+                    ? `${theme_1.theme.success}${symbols_1.symbols.checked}${ansi_1.ANSI.RESET}`
+                    : `${theme_1.theme.muted}${symbols_1.symbols.unchecked}${ansi_1.ANSI.RESET}`;
                 output += `${cursor} ${checkbox} ${choice.title}`;
             });
         }

package/dist/prompts/number.js

@@ -4,6 +4,7 @@ exports.NumberPrompt = void 0;
 const ansi_1 = require("../ansi");
 const base_1 = require("../base");
 const theme_1 = require("../theme");
+const symbols_1 = require("../symbols");
 // --- Implementation: Number Prompt ---
 class NumberPrompt extends base_1.Prompt {
     constructor(options) {
@@ -18,7 +19,7 @@ class NumberPrompt extends base_1.Prompt {
     }
     render(firstRender) {
         // Prepare content
-        const icon = this.errorMsg ? `${theme_1.theme.error}✖` : `${theme_1.theme.success}?`;
+        const icon = this.errorMsg ? `${theme_1.theme.error}${symbols_1.symbols.cross}` : `${theme_1.theme.success}?`;
         // Prefix
         let output = `${icon} ${ansi_1.ANSI.BOLD}${theme_1.theme.title}${this.options.message}${ansi_1.ANSI.RESET} `;
         // Value

package/dist/prompts/select.d.ts

@@ -1,11 +1,11 @@
 import { Prompt } from '../base';
 import { SelectOptions } from '../types';
-export declare class SelectPrompt extends Prompt<any, SelectOptions> {
+export declare class SelectPrompt<V> extends Prompt<any, SelectOptions<V>> {
     private selectedIndex;
     private searchBuffer;
     private scrollTop;
     private readonly pageSize;
-    constructor(options: SelectOptions);
+    constructor(options: SelectOptions<V>);
     private isSeparator;
     private findNextSelectableIndex;
     private getFilteredChoices;

package/dist/prompts/select.js

@@ -4,6 +4,7 @@ exports.SelectPrompt = void 0;
 const ansi_1 = require("../ansi");
 const base_1 = require("../base");
 const theme_1 = require("../theme");
+const symbols_1 = require("../symbols");
 // --- Implementation: Select Prompt ---
 class SelectPrompt extends base_1.Prompt {
     constructor(options) {
@@ -80,11 +81,11 @@ class SelectPrompt extends base_1.Prompt {
                 if (index > 0)
                     output += '\n'; // Separator between items
                 if (this.isSeparator(choice)) {
-                    output += `  ${ansi_1.ANSI.DIM}${choice.text || '────────'}${ansi_1.ANSI.RESET}`;
+                    output += `  ${ansi_1.ANSI.DIM}${choice.text || symbols_1.symbols.line.repeat(8)}${ansi_1.ANSI.RESET}`;
                 }
                 else {
                     if (actualIndex === this.selectedIndex) {
-                        output += `${theme_1.theme.main}❯ ${choice.title}${ansi_1.ANSI.RESET}`;
+                        output += `${theme_1.theme.main}${symbols_1.symbols.pointer} ${choice.title}${ansi_1.ANSI.RESET}`;
                     }
                     else {
                         output += `  ${choice.title}`;

package/dist/prompts/slider.js

@@ -4,6 +4,7 @@ exports.SliderPrompt = void 0;
 const ansi_1 = require("../ansi");
 const base_1 = require("../base");
 const theme_1 = require("../theme");
+const symbols_1 = require("../symbols");
 // --- Implementation: Slider Prompt ---
 class SliderPrompt extends base_1.Prompt {
     constructor(options) {
@@ -20,7 +21,7 @@ class SliderPrompt extends base_1.Prompt {
             if (i === pos)
                 bar += `${theme_1.theme.main}O${ansi_1.ANSI.RESET}`;
             else
-                bar += '─';
+                bar += symbols_1.symbols.line;
         }
         const unit = this.options.unit || '';
         const output = `${theme_1.theme.success}?${ansi_1.ANSI.RESET} ${ansi_1.ANSI.BOLD}${theme_1.theme.title}${this.options.message}${ansi_1.ANSI.RESET} [${bar}] ${this.value}${unit}`;

package/dist/prompts/text.js

@@ -4,6 +4,7 @@ exports.TextPrompt = void 0;
 const ansi_1 = require("../ansi");
 const base_1 = require("../base");
 const theme_1 = require("../theme");
+const symbols_1 = require("../symbols");
 const utils_1 = require("../utils");
 // --- Implementation: Text Prompt ---
 class TextPrompt extends base_1.Prompt {
@@ -23,7 +24,7 @@ class TextPrompt extends base_1.Prompt {
         // Calculate available width
         const cols = process.stdout.columns || 80;
         // 1. Prepare Prompt Label
-        const icon = this.errorMsg ? `${theme_1.theme.error}✖` : `${theme_1.theme.success}?`;
+        const icon = this.errorMsg ? `${theme_1.theme.error}${symbols_1.symbols.cross}` : `${theme_1.theme.success}?`;
         const hint = this.options.multiline ? ` ${theme_1.theme.muted}(Press Ctrl+D to submit)${ansi_1.ANSI.RESET}` : '';
         const prefix = `${icon} ${ansi_1.ANSI.BOLD}${theme_1.theme.title}${this.options.message}${ansi_1.ANSI.RESET}${hint} `;
         // We need visual length of prefix to calculate available space for input on the first line

package/dist/symbols.d.ts

@@ -0,0 +1,17 @@
+export interface SymbolDefinition {
+    /** Used for success messages or valid states */
+    tick: string;
+    /** Used for error messages or invalid states */
+    cross: string;
+    /** Used to point to the current selection */
+    pointer: string;
+    /** Used for separators or sliders */
+    line: string;
+    /** Used for checked state in checkboxes/radio */
+    checked: string;
+    /** Used for unchecked state in checkboxes/radio */
+    unchecked: string;
+    /** Animation frames for the spinner */
+    spinner: string[];
+}
+export declare const symbols: SymbolDefinition;

package/dist/symbols.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.symbols = void 0;
+const utils_1 = require("./utils");
+const UnicodeSymbols = {
+    tick: '✔',
+    cross: '✖',
+    pointer: '❯',
+    line: '─',
+    checked: '◉',
+    unchecked: '◯',
+    spinner: ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏']
+};
+const AsciiSymbols = {
+    tick: '+',
+    cross: 'x',
+    pointer: '>',
+    line: '-',
+    checked: '[x]',
+    unchecked: '[ ]',
+    spinner: ['|', '/', '-', '\\']
+};
+const capabilities = (0, utils_1.detectCapabilities)();
+const useUnicode = capabilities.hasUnicode && process.env.MEP_NO_UNICODE !== '1';
+exports.symbols = useUnicode ? UnicodeSymbols : AsciiSymbols;

package/dist/types.d.ts

@@ -22,19 +22,19 @@ export interface Separator {
     separator: true;
     text?: string;
 }
-export interface SelectChoice {
+export interface SelectChoice<V> {
     title: string;
-    value: any;
+    value: V;
     description?: string;
 }
-export interface SelectOptions extends BaseOptions {
-    choices: (SelectChoice | Separator)[];
+export interface SelectOptions<V> extends BaseOptions {
+    choices: (SelectChoice<V> | Separator)[];
 }
-export interface CheckboxChoice extends SelectChoice {
+export interface CheckboxChoice<V> extends SelectChoice<V> {
     selected?: boolean;
 }
-export interface CheckboxOptions extends BaseOptions {
-    choices: CheckboxChoice[];
+export interface CheckboxOptions<V> extends BaseOptions {
+    choices: CheckboxChoice<V>[];
     min?: number;
     max?: number;
 }
@@ -75,5 +75,5 @@ export interface FileOptions extends BaseOptions {
     extensions?: string[];
     onlyDirectories?: boolean;
 }
-export interface MultiSelectOptions extends CheckboxOptions {
+export interface MultiSelectOptions<V> extends CheckboxOptions<V> {
 }

package/dist/utils.d.ts

@@ -4,7 +4,7 @@
 export declare function detectCapabilities(): {
     isCI: boolean;
     hasTrueColor: boolean;
-    hasUnicode: boolean;
+    hasUnicode: boolean | "";
 };
 /**
  * Strips ANSI escape codes from a string.

package/dist/utils.js

@@ -14,17 +14,45 @@ function detectCapabilities() {
     const isCI = !!env.CI;
     // Check for True Color support
     const hasTrueColor = env.COLORTERM === 'truecolor';
-    // Check for Unicode support
-    // Windows Terminal (WT_SESSION), VS Code (TERM_PROGRAM=vscode), or modern Linux terminals usually support it.
+    // Check if it is a TTY
+    const isTTY = process.stdout.isTTY;
     const isWindows = process.platform === 'win32';
-    const hasUnicode = !!env.WT_SESSION ||
-        env.TERM_PROGRAM === 'vscode' ||
-        env.TERM_PROGRAM === 'Apple_Terminal' ||
-        (!isWindows && env.LANG && env.LANG.toUpperCase().endsWith('UTF-8'));
+    // Logic detect Unicode xịn hơn
+    const isUnicodeSupported = () => {
+        // 1. Windows: Check specific environmental variables
+        if (isWindows) {
+            // Windows Terminal
+            if (env.WT_SESSION)
+                return true;
+            // VSCode terminal
+            if (env.TERM_PROGRAM === 'vscode')
+                return true;
+            // Modern terminals setting TERM (e.g. Alacritty, Git Bash, Cygwin)
+            if (env.TERM === 'xterm-256color' || env.TERM === 'alacritty')
+                return true;
+            // ConEmu / Cmder
+            if (env.ConEmuTask)
+                return true;
+            // CI on Windows typically supports Unicode.
+            if (isCI)
+                return true;
+            // Default cmd.exe / old powershell => False (ASCII)
+            return false;
+        }
+        // 2. Non-Windows (Linux/macOS)
+        if (env.TERM_PROGRAM === 'Apple_Terminal')
+            return true;
+        // Check if the LANG or LC_ALL variable contains UTF-8.
+        const lang = env.LANG || '';
+        const lcAll = env.LC_ALL || '';
+        return (lang && lang.toUpperCase().endsWith('UTF-8')) ||
+            (lcAll && lcAll.toUpperCase().endsWith('UTF-8'));
+    };
     return {
         isCI,
         hasTrueColor,
-        hasUnicode: hasUnicode || !isWindows // Assume non-windows has unicode by default if not strictly detected?
+        // Enable Unicode only if it's TTY and environment supports it.
+        hasUnicode: isTTY && isUnicodeSupported()
     };
 }
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mepcli",
-  "version": "0.2.6",
+  "version": "0.3.0",
   "description": "Zero-dependency, minimalist interactive CLI prompt for Node.js",
   "repository": {
     "type": "git",
@@ -30,8 +30,8 @@
   "author": "CodeTease",
   "license": "MIT",
   "devDependencies": {
-    "@types/node": "^20.19.27",
-    "ts-node": "^10.9.2",
-    "typescript": "^5.9.3"
+    "@types/node": "^22",
+    "ts-node": "^10",
+    "typescript": "^5"
   }
 }