@mindbase/node-tools 1.1.0

package/src/clear/ui.js

@@ -0,0 +1,353 @@
+/**
+ * 清理工具 UI 模块
+ * 使用 prompts + chalk + cli-table3 + treeify 实现
+ */
+
+const prompts = require('prompts');
+const chalk = require('chalk');
+const Table = require('cli-table3');
+const treeify = require('treeify');
+const { enterAlternateScreen, exitAlternateScreen } = require('../common/ui/ansi.js');
+const { ScreenRenderer } = require('../common/ui/screen.js');
+const { PagedDisplay } = require('../common/ui/pagination.js');
+const { waitForAnyKey } = require('../common/ui/utils.js');
+const readline = require('readline');
+
+/**
+ * 格式化项目名称
+ */
+function formatItemName(item) {
+  const icon = item.type === 'dir' ? '📁' : '📄';
+  const coloredPath =
+    item.type === 'dir' ? chalk.cyan(item.relativePath) : chalk.white(item.relativePath);
+  return `${icon} ${coloredPath}`;
+}
+
+/**
+ * 等待导航按键（分页场景）
+ */
+function waitForNavigation() {
+  return new Promise((resolve) => {
+    readline.emitKeypressEvents(process.stdin);
+
+    if (process.stdin.isPaused()) {
+      process.stdin.resume();
+      process.stdin.setRawMode(true);
+    }
+
+    const handler = (_str, key) => {
+      if (key.name === 'n' || key.name === 'down' || key.name === 'pagedown') {
+        cleanup();
+        resolve('next');
+      } else if (key.name === 'p' || key.name === 'up' || key.name === 'pageup') {
+        cleanup();
+        resolve('prev');
+      } else if (key.name === 'return') {
+        cleanup();
+        resolve('confirm');
+      } else if ((key.name === 'c' && key.ctrl) || key.name === 'escape') {
+        cleanup();
+        resolve('exit');
+      }
+    };
+
+    const cleanup = () => {
+      process.stdin.removeListener('keypress', handler);
+      process.stdin.setRawMode(false);
+      process.stdin.pause();
+    };
+
+    process.stdin.on('keypress', handler);
+  });
+}
+
+/**
+ * 显示多选菜单
+ * @param {Array} items - 可选项数组
+ * @returns {Promise<Array>} 选中的项
+ */
+async function selectItems(items) {
+  if (items.length === 0) {
+    console.log(chalk.yellow('没有找到可清理的内容'));
+    return [];
+  }
+
+  // 进入备用屏幕
+  enterAlternateScreen();
+
+  // 创建渲染器
+  const renderer = new ScreenRenderer();
+
+  // 分页显示
+  const usePagination = items.length > 20;
+  const pageSize = 15;
+  let pagedDisplay = null;
+  let currentPageItems = items;
+
+  if (usePagination) {
+    pagedDisplay = new PagedDisplay(items, pageSize);
+    currentPageItems = pagedDisplay.getCurrentPage().items;
+  }
+
+  // 选中状态追踪（默认全选）
+  const selectedIndices = new Set(items.map((_, idx) => idx));
+
+  try {
+    // 主循环
+    while (true) {
+      // 渲染当前页面
+      const header = chalk.bold.white(
+        `找到 ${items.length} 个可清理的项目 (已选: ${selectedIndices.size})\n`
+      );
+
+      const hint = chalk.dim(
+        '↑↓ 移动 | 空格 选择 | Enter 确认' +
+          (usePagination ? ' | PageUp/PageDown/n/p 翻页' : '') +
+          ' | CTRL_C 退出\n'
+      );
+
+      // 构建选项列表
+      const choices = currentPageItems.map((item) => {
+        const globalIndex = items.indexOf(item);
+        return {
+          title: formatItemName(item),
+          value: globalIndex,
+          selected: selectedIndices.has(globalIndex),
+        };
+      });
+
+      // 使用 readline 实现自定义多选
+      const result = await customMultiselect(choices, selectedIndices, header + hint);
+
+      // 处理退出
+      if (result === 'exit') {
+        exitAlternateScreen();
+        return [];
+      }
+
+      // 更新选中状态
+      result.newSelections.forEach((idx) => selectedIndices.add(idx));
+      result.deselections.forEach((idx) => selectedIndices.delete(idx));
+
+      // 分页处理
+      if (usePagination) {
+        const navigation = await waitForNavigation();
+
+        if (navigation === 'next') {
+          pagedDisplay.nextPage();
+          currentPageItems = pagedDisplay.getCurrentPage().items;
+          renderer.clear();
+          continue;
+        } else if (navigation === 'prev') {
+          pagedDisplay.prevPage();
+          currentPageItems = pagedDisplay.getCurrentPage().items;
+          renderer.clear();
+          continue;
+        } else if (navigation === 'exit') {
+          exitAlternateScreen();
+          return [];
+        } else if (navigation === 'confirm') {
+          break;
+        }
+      } else {
+        break;
+      }
+    }
+
+    // 退出备用屏幕
+    exitAlternateScreen();
+
+    // 返回选中项目
+    return Array.from(selectedIndices).map((idx) => items[idx]);
+  } catch (error) {
+    exitAlternateScreen();
+    if (error === 'CTRL_C') {
+      return [];
+    }
+    throw error;
+  }
+}
+
+/**
+ * 自定义多选实现
+ */
+function customMultiselect(choices, currentSelected, titleText = '') {
+  return new Promise((resolve) => {
+    let currentIndex = 0;
+
+    // 显示选项
+    function display() {
+      console.clear();
+      if (titleText) {
+        console.log(titleText);
+      }
+      choices.forEach((choice, idx) => {
+        const isSelected = currentSelected.has(choice.value);
+        const isCurrent = idx === currentIndex;
+        const prefix = isCurrent ? '> ' : '  ';
+        const marker = isSelected ? '[x]' : '[ ]';
+        const color = isSelected ? chalk.green : chalk.gray;
+        console.log(prefix + marker + ' ' + color(choice.title));
+      });
+    }
+
+    display();
+
+    readline.emitKeypressEvents(process.stdin);
+    process.stdin.resume();
+    process.stdin.setRawMode(true);
+
+    const handler = (_str, key) => {
+      if (key.name === 'up') {
+        currentIndex = Math.max(0, currentIndex - 1);
+        display();
+      } else if (key.name === 'down') {
+        currentIndex = Math.min(choices.length - 1, currentIndex + 1);
+        display();
+      } else if (key.name === 'space') {
+        const value = choices[currentIndex].value;
+        if (currentSelected.has(value)) {
+          currentSelected.delete(value);
+        } else {
+          currentSelected.add(value);
+        }
+        display();
+      } else if (key.name === 'return') {
+        cleanup();
+        resolve({ newSelections: Array.from(currentSelected), deselections: [] });
+      } else if (key.name === 'c' && key.ctrl) {
+        cleanup();
+        resolve('exit');
+      } else if (key.name === 'escape') {
+        cleanup();
+        resolve('exit');
+      }
+    };
+
+    const cleanup = () => {
+      process.stdin.removeListener('keypress', handler);
+      process.stdin.setRawMode(false);
+      process.stdin.pause();
+    };
+
+    process.stdin.on('keypress', handler);
+  });
+}
+
+/**
+ * 显示删除预览
+ * @param {Array} items - 选中的项
+ * @returns {Promise<boolean>} 是否确认删除
+ */
+async function confirmDelete(items) {
+  if (items.length === 0) {
+    return false;
+  }
+
+  enterAlternateScreen();
+  const renderer = new ScreenRenderer();
+
+  try {
+    // 创建表格
+    const table = new Table({
+      head: [chalk.bold('类型'), chalk.bold('路径')],
+      colWidths: [10, 70],
+      wordWrap: true,
+    });
+
+    // 填充数据
+    items.forEach((item) => {
+      const icon =
+        item.type === 'dir' ? chalk.cyan('📁 目录') : chalk.white('📄 文件');
+      table.push([icon, item.relativePath]);
+    });
+
+    // 渲染预览
+    const header = chalk.bold.red(`\n即将删除以下 ${items.length} 项：\n`);
+    const content = header + table.toString();
+
+    renderer.render(content);
+
+    // 确认
+    const response = await prompts({
+      type: 'confirm',
+      name: 'confirm',
+      message: chalk.yellow('确认删除？'),
+      initial: false,
+    });
+
+    exitAlternateScreen();
+
+    return response.confirm === true;
+  } catch (error) {
+    exitAlternateScreen();
+    if (error === 'CTRL_C') {
+      return false;
+    }
+    throw error;
+  }
+}
+
+/**
+ * 显示删除结果
+ * @param {Object} stats - 删除统计
+ */
+async function showResult(stats) {
+  enterAlternateScreen();
+  const renderer = new ScreenRenderer();
+
+  try {
+    // 统计表格
+    const summaryTable = new Table({
+      colWidths: [20, 10],
+    });
+
+    summaryTable.push(
+      [chalk.white('总处理数'), chalk.bold(stats.success + stats.failed)],
+      [chalk.green('成功'), chalk.bold.green(stats.success)],
+      [chalk.red('失败'), chalk.bold.red(stats.failed)]
+    );
+
+    let content = chalk.bold.white('\n删除完成：\n\n') + summaryTable.toString();
+
+    // 失败详情
+    if (stats.failed > 0) {
+      const failedItems = stats.details.filter((d) => d.status === 'failed');
+
+      content += '\n\n' + chalk.bold.red('失败详情：\n');
+
+      // 使用 treeify 构建目录树
+      const tree = {};
+      failedItems.forEach((item) => {
+        const parts = item.relativePath.split(/[/\\]/);
+        let current = tree;
+
+        parts.forEach((part, idx) => {
+          if (!current[part]) {
+            current[part] = idx === parts.length - 1 ? null : {};
+          }
+          if (current[part] !== null) {
+            current = current[part];
+          }
+        });
+      });
+
+      content += '\n' + chalk.red(treeify.asTree(tree, true)) + '\n';
+    }
+
+    // 操作提示
+    content += '\n' + chalk.dim('按任意键继续...');
+
+    renderer.render(content);
+
+    // 等待按键
+    await waitForAnyKey();
+
+    exitAlternateScreen();
+  } catch (error) {
+    exitAlternateScreen();
+    throw error;
+  }
+}
+
+module.exports = { selectItems, confirmDelete, showResult };

package/src/common/ui/ansi.js

@@ -0,0 +1,49 @@
+/**
+ * ANSI 转义序列常量
+ * 用于终端控制：备用屏幕、清屏、光标控制等
+ */
+
+module.exports = {
+  // 备用屏幕
+  ENTER_ALTERNATE_SCREEN: '\x1b[?1049h', // 进入备用屏幕
+  EXIT_ALTERNATE_SCREEN: '\x1b[?1049l',  // 退出备用屏幕
+
+  // 清屏
+  CLEAR_SCREEN: '\x1b[2J',    // 清除整个屏幕
+  CLEAR_LINE: '\x1b[K',       // 清除从光标到行尾
+  MOVE_CURSOR_HOME: '\x1b[H', // 移动光标到左上角
+
+  // 光标控制
+  HIDE_CURSOR: '\x1b[?25l',   // 隐藏光标
+  SHOW_CURSOR: '\x1b[?25h',   // 显示光标
+  SAVE_CURSOR: '\x1b[s',      // 保存光标位置
+  RESTORE_CURSOR: '\x1b[u',   // 恢复光标位置
+
+  // 滚动
+  DISABLE_SCROLL: '\x1b[?7l', // 禁用自动换行
+  ENABLE_SCROLL: '\x1b[?7h',  // 启用自动换行
+};
+
+/**
+ * 进入备用屏幕（清屏并保存原屏幕内容）
+ */
+function enterAlternateScreen() {
+  process.stdout.write('\x1b[?1049h'); // 进入备用屏幕
+  process.stdout.write('\x1b[2J');     // 清除屏幕
+  process.stdout.write('\x1b[H');      // 移动光标到左上角
+  process.stdout.write('\x1b[?25l');   // 隐藏光标
+}
+
+/**
+ * 退出备用屏幕（恢复原屏幕）
+ */
+function exitAlternateScreen() {
+  process.stdout.write('\x1b[?25h');   // 显示光标
+  process.stdout.write('\x1b[?1049l'); // 退出备用屏幕
+}
+
+module.exports = {
+  ...module.exports,
+  enterAlternateScreen,
+  exitAlternateScreen,
+};

package/src/common/ui/pagination.js

@@ -0,0 +1,63 @@
+/**
+ * 分页显示
+ * 支持对大量数据进行分页展示
+ */
+
+class PagedDisplay {
+  /**
+   * @param {Array} items - 要分页的数据
+   * @param {number} pageSize - 每页显示数量
+   */
+  constructor(items, pageSize = 10) {
+    this.items = items;
+    this.pageSize = pageSize;
+    this.currentPage = 0;
+    this.totalPages = Math.ceil(items.length / pageSize);
+  }
+
+  /**
+   * 获取当前页数据
+   * @returns {Object} 包含当前页信息
+   */
+  getCurrentPage() {
+    const start = this.currentPage * this.pageSize;
+    const end = Math.min(start + this.pageSize, this.items.length);
+    return {
+      items: this.items.slice(start, end),
+      pageIndex: this.currentPage,
+      totalPages: this.totalPages,
+      hasNext: this.currentPage < this.totalPages - 1,
+      hasPrev: this.currentPage > 0,
+    };
+  }
+
+  /**
+   * 下一页
+   */
+  nextPage() {
+    if (this.currentPage < this.totalPages - 1) {
+      this.currentPage++;
+    }
+  }
+
+  /**
+   * 上一页
+   */
+  prevPage() {
+    if (this.currentPage > 0) {
+      this.currentPage--;
+    }
+  }
+
+  /**
+   * 跳转到指定页
+   * @param {number} page - 页码（从0开始）
+   */
+  jumpToPage(page) {
+    if (page >= 0 && page < this.totalPages) {
+      this.currentPage = page;
+    }
+  }
+}
+
+module.exports = { PagedDisplay };

package/src/common/ui/screen.js

@@ -0,0 +1,56 @@
+/**
+ * 屏幕渲染器
+ * 负责屏幕的清屏、重绘等操作
+ */
+
+const { CLEAR_SCREEN, MOVE_CURSOR_HOME, SAVE_CURSOR, RESTORE_CURSOR } = require('./ansi.js');
+
+class ScreenRenderer {
+  constructor() {
+    this.lastRender = '';
+  }
+
+  /**
+   * 清除并重新渲染
+   * @param {string} content - 要渲染的内容
+   */
+  render(content) {
+    // 保存光标位置
+    process.stdout.write(SAVE_CURSOR);
+
+    // 移动到左上角
+    process.stdout.write(MOVE_CURSOR_HOME);
+
+    // 清除屏幕
+    process.stdout.write(CLEAR_SCREEN);
+
+    // 渲染新内容
+    process.stdout.write(content);
+
+    // 恢复光标
+    process.stdout.write(RESTORE_CURSOR);
+
+    this.lastRender = content;
+  }
+
+  /**
+   * 部分更新指定行
+   * @param {number} line - 行号（从1开始）
+   * @param {string} content - 新内容
+   */
+  updateLine(line, content) {
+    process.stdout.write(`\x1b[${line};0H`); // 移动到指定行
+    process.stdout.write('\x1b[K');          // 清除行
+    process.stdout.write(content);           // 写入新内容
+  }
+
+  /**
+   * 清空屏幕
+   */
+  clear() {
+    process.stdout.write(CLEAR_SCREEN);
+    process.stdout.write(MOVE_CURSOR_HOME);
+  }
+}
+
+module.exports = { ScreenRenderer };

package/src/common/ui/single-select.js

@@ -0,0 +1,80 @@
+/**
+ * 通用单选菜单组件
+ * 使用 readline 原生键盘处理
+ */
+
+const readline = require('readline');
+const chalk = require('chalk');
+
+/**
+ * 单选菜单
+ * @param {Array} items - 选项数组 [{title, value}]
+ * @param {Object} options - 配置项
+ * @param {string} options.title - 标题
+ * @param {string} options.hint - 提示文本
+ * @returns {Promise<any>} 选中的 value，退出时返回 null
+ */
+function singleSelect(items, options = {}) {
+  return new Promise((resolve) => {
+    if (items.length === 0) {
+      resolve(null);
+      return;
+    }
+
+    let currentIndex = 0;
+
+    // 显示选项
+    function display() {
+      console.clear();
+      if (options.title) {
+        console.log(options.title);
+        console.log('');
+      }
+      items.forEach((item, idx) => {
+        const isCurrent = idx === currentIndex;
+        const prefix = isCurrent ? '> ' : '  ';
+        const color = isCurrent ? chalk.green : chalk.gray;
+        console.log(prefix + color(item.title));
+      });
+      if (options.hint) {
+        console.log('');
+        console.log(chalk.dim(options.hint));
+      }
+    }
+
+    display();
+
+    readline.emitKeypressEvents(process.stdin);
+    process.stdin.resume();
+    process.stdin.setRawMode(true);
+
+    const handler = (_str, key) => {
+      if (key.name === 'up') {
+        currentIndex = Math.max(0, currentIndex - 1);
+        display();
+      } else if (key.name === 'down') {
+        currentIndex = Math.min(items.length - 1, currentIndex + 1);
+        display();
+      } else if (key.name === 'return') {
+        cleanup();
+        resolve(items[currentIndex].value);
+      } else if (key.name === 'c' && key.ctrl) {
+        cleanup();
+        resolve(null);
+      } else if (key.name === 'escape') {
+        cleanup();
+        resolve(null);
+      }
+    };
+
+    const cleanup = () => {
+      process.stdin.removeListener('keypress', handler);
+      process.stdin.setRawMode(false);
+      process.stdin.pause();
+    };
+
+    process.stdin.on('keypress', handler);
+  });
+}
+
+module.exports = { singleSelect };

package/src/common/ui/utils.js

@@ -0,0 +1,80 @@
+/**
+ * 通用 UI 辅助函数
+ */
+
+const readline = require('readline');
+
+/**
+ * 等待任意按键
+ * @returns {Promise<void>}
+ */
+function waitForAnyKey() {
+  return new Promise((resolve) => {
+    readline.emitKeypressEvents(process.stdin);
+
+    if (process.stdin.isPaused()) {
+      process.stdin.resume();
+      process.stdin.setRawMode(true);
+    }
+
+    const handler = () => {
+      cleanup();
+      resolve();
+    };
+
+    const cleanup = () => {
+      process.stdin.removeListener('keypress', handler);
+      process.stdin.setRawMode(false);
+      process.stdin.pause();
+    };
+
+    process.stdin.once('keypress', handler);
+  });
+}
+
+/**
+ * 等待导航按键（用于分页场景）
+ * @returns {Promise<string>} 返回按键类型: 'next', 'prev', 'confirm', 'exit'
+ */
+function waitForNavigation() {
+  return new Promise((resolve) => {
+    readline.emitKeypressEvents(process.stdin);
+
+    if (process.stdin.isPaused()) {
+      process.stdin.resume();
+      process.stdin.setRawMode(true);
+    }
+
+    const handler = (str, key) => {
+      if (key.name === 'n') {
+        cleanup();
+        resolve('next');
+      } else if (key.name === 'p') {
+        cleanup();
+        resolve('prev');
+      } else if (key.name === 'return') {
+        cleanup();
+        resolve('confirm');
+      } else if (key.name === 'c' && key.ctrl) {
+        cleanup();
+        resolve('exit');
+      } else if (key.name === 'escape') {
+        cleanup();
+        resolve('exit');
+      }
+    };
+
+    const cleanup = () => {
+      process.stdin.removeListener('keypress', handler);
+      process.stdin.setRawMode(false);
+      process.stdin.pause();
+    };
+
+    process.stdin.on('keypress', handler);
+  });
+}
+
+module.exports = {
+  waitForAnyKey,
+  waitForNavigation,
+};