@mindbase/node-tools 1.1.0 → 1.3.7

package/src/clear/ui.js

@@ -3,14 +3,12 @@
  * 使用 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 { withScreenSession } = require('../common/ui/screen.js');
 const { PagedDisplay } = require('../common/ui/pagination.js');
-const { waitForAnyKey } = require('../common/ui/utils.js');
+const { waitForAnyKey, waitForConfirm, waitForNavigation } = require('../common/ui/utils.js');
+const { clean } = require('./cleaner.js');
 const readline = require('readline');
 
 /**
@@ -24,60 +22,12 @@ function formatItemName(item) {
 }
 
 /**
- * 等待导航按键（分页场景）
- */
-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);
-  });
-}
-
-/**
- * 显示多选菜单
+ * 内部：显示多选菜单（接收 renderer）
+ * @param {Object} renderer - 屏幕渲染器
  * @param {Array} items - 可选项数组
  * @returns {Promise<Array>} 选中的项
  */
-async function selectItems(items) {
-  if (items.length === 0) {
-    console.log(chalk.yellow('没有找到可清理的内容'));
-    return [];
-  }
-
-  // 进入备用屏幕
-  enterAlternateScreen();
-
-  // 创建渲染器
-  const renderer = new ScreenRenderer();
-
+async function selectItemsInternal(renderer, items) {
   // 分页显示
   const usePagination = items.length > 20;
   const pageSize = 15;
@@ -92,80 +42,83 @@ async function selectItems(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),
-        };
-      });
+  // 主循环
+  while (true) {
+    // 渲染当前页面
+    const header = chalk.bold.white(
+      `找到 ${items.length} 个可清理的项目 (已选: ${selectedIndices.size})\n`
+    );
 
-      // 使用 readline 实现自定义多选
-      const result = await customMultiselect(choices, selectedIndices, header + hint);
+    const hint = chalk.dim(
+      '↑↓ 移动 | 空格 选择 | Enter 确认' +
+        (usePagination ? ' | PageUp/PageDown/n/p 翻页' : '') +
+        ' | CTRL_C 退出\n'
+    );
 
-      // 处理退出
-      if (result === 'exit') {
-        exitAlternateScreen();
-        return [];
-      }
+    // 构建选项列表
+    const choices = currentPageItems.map((item) => {
+      const globalIndex = items.indexOf(item);
+      return {
+        title: formatItemName(item),
+        value: globalIndex,
+        selected: selectedIndices.has(globalIndex),
+      };
+    });
 
-      // 更新选中状态
-      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 {
+    // 使用 readline 实现自定义多选
+    const result = await customMultiselect(choices, selectedIndices, header + hint);
+
+    // 处理退出
+    if (result === 'exit') {
+      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') {
+        return [];
+      } else if (navigation === 'confirm') {
         break;
       }
+    } else {
+      break;
     }
+  }
 
-    // 退出备用屏幕
-    exitAlternateScreen();
+  // 返回选中项目
+  return Array.from(selectedIndices).map((idx) => items[idx]);
+}
 
-    // 返回选中项目
-    return Array.from(selectedIndices).map((idx) => items[idx]);
-  } catch (error) {
-    exitAlternateScreen();
-    if (error === 'CTRL_C') {
-      return [];
-    }
-    throw error;
+/**
+ * 显示多选菜单
+ * @param {Array} items - 可选项数组
+ * @returns {Promise<Array>} 选中的项
+ */
+async function selectItems(items) {
+  if (items.length === 0) {
+    console.log(chalk.yellow('没有找到可清理的内容'));
+    return [];
   }
+
+  return withScreenSession(async (renderer) => {
+    return await selectItemsInternal(renderer, items);
+  });
 }
 
 /**
@@ -235,119 +188,145 @@ function customMultiselect(choices, currentSelected, titleText = '') {
 }
 
 /**
- * 显示删除预览
+ * 内部：显示删除预览（接收 renderer）
+ * @param {Object} renderer - 屏幕渲染器
  * @param {Array} items - 选中的项
  * @returns {Promise<boolean>} 是否确认删除
  */
-async function confirmDelete(items) {
+async function confirmDeleteInternal(renderer, 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]);
-    });
+  // 构建简单列表
+  let content = chalk.bold.red(`\n即将删除以下 ${items.length} 项：\n\n`);
 
-    // 渲染预览
-    const header = chalk.bold.red(`\n即将删除以下 ${items.length} 项：\n`);
-    const content = header + table.toString();
+  items.forEach((item) => {
+    const icon = item.type === 'dir' ? '📁' : '📄';
+    const coloredPath =
+      item.type === 'dir' ? chalk.cyan(item.relativePath) : chalk.white(item.relativePath);
+    content += `  ${icon} ${coloredPath}\n`;
+  });
 
-    renderer.render(content);
+  // 操作提示
+  content += '\n' + chalk.dim('按 y/Enter 确认，n/Esc 取消...');
 
-    // 确认
-    const response = await prompts({
-      type: 'confirm',
-      name: 'confirm',
-      message: chalk.yellow('确认删除？'),
-      initial: false,
-    });
+  renderer.render(content);
 
-    exitAlternateScreen();
+  // 等待确认
+  return await waitForConfirm();
+}
 
-    return response.confirm === true;
-  } catch (error) {
-    exitAlternateScreen();
-    if (error === 'CTRL_C') {
-      return false;
-    }
-    throw error;
+/**
+ * 显示删除预览
+ * @param {Array} items - 选中的项
+ * @returns {Promise<boolean>} 是否确认删除
+ */
+async function confirmDelete(items) {
+  if (items.length === 0) {
+    return false;
   }
+
+  return withScreenSession(async (renderer) => {
+    return await confirmDeleteInternal(renderer, items);
+  });
 }
 
 /**
- * 显示删除结果
+ * 内部：显示删除结果（接收 renderer）
+ * @param {Object} renderer - 屏幕渲染器
  * @param {Object} stats - 删除统计
  */
-async function showResult(stats) {
-  enterAlternateScreen();
-  const renderer = new ScreenRenderer();
-
-  try {
-    // 统计表格
-    const summaryTable = new Table({
-      colWidths: [20, 10],
+async function showResultInternal(renderer, stats) {
+  const total = stats.success + stats.failed;
+  let content =
+    chalk.bold.white('\n删除完成\n\n') +
+    `  总处理数: ${chalk.bold(total)}\n` +
+    `  ${chalk.green('成功')}: ${chalk.bold.green(stats.success)}\n` +
+    `  ${chalk.red('失败')}: ${chalk.bold.red(stats.failed)}\n`;
+
+  // 失败详情
+  if (stats.failed > 0) {
+    const failedItems = stats.details.filter((d) => d.status === 'failed');
+
+    content += '\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];
+        }
+      });
     });
 
-    summaryTable.push(
-      [chalk.white('总处理数'), chalk.bold(stats.success + stats.failed)],
-      [chalk.green('成功'), chalk.bold.green(stats.success)],
-      [chalk.red('失败'), chalk.bold.red(stats.failed)]
-    );
+    content += '\n' + chalk.red(treeify.asTree(tree, true)) + '\n';
+  }
 
-    let content = chalk.bold.white('\n删除完成：\n\n') + summaryTable.toString();
+  // 操作提示
+  content += '\n' + chalk.dim('按任意键继续...');
 
-    // 失败详情
-    if (stats.failed > 0) {
-      const failedItems = stats.details.filter((d) => d.status === 'failed');
+  renderer.render(content);
 
-      content += '\n\n' + chalk.bold.red('失败详情：\n');
+  // 等待按键
+  await waitForAnyKey();
+}
 
-      // 使用 treeify 构建目录树
-      const tree = {};
-      failedItems.forEach((item) => {
-        const parts = item.relativePath.split(/[/\\]/);
-        let current = tree;
+/**
+ * 显示删除结果
+ * @param {Object} stats - 删除统计
+ */
+async function showResult(stats) {
+  await withScreenSession(async (renderer) => {
+    await showResultInternal(renderer, stats);
+  });
+}
 
-        parts.forEach((part, idx) => {
-          if (!current[part]) {
-            current[part] = idx === parts.length - 1 ? null : {};
-          }
-          if (current[part] !== null) {
-            current = current[part];
-          }
-        });
-      });
+/**
+ * 运行清理流程（全程备用屏幕）
+ * @param {string} targetPath - 目标路径
+ * @param {Array} items - 扫描到的项目
+ * @returns {Promise<Object|null>} 删除统计，取消时返回 null
+ */
+async function runCleanFlow(targetPath, items) {
+  return withScreenSession(async (renderer) => {
+    // 显示扫描信息
+    let content = chalk.bold.white(`扫描目录: ${targetPath}\n\n`);
+    content += `找到 ${chalk.bold(items.length)} 个可清理的项目\n\n`;
+    content += chalk.dim('按任意键继续...');
+    renderer.render(content);
+    await waitForAnyKey();
 
-      content += '\n' + chalk.red(treeify.asTree(tree, true)) + '\n';
+    // 选择项目
+    const selected = await selectItemsInternal(renderer, items);
+    if (selected.length === 0) {
+      renderer.render(chalk.yellow('\n未选择任何内容\n按任意键退出...'));
+      await waitForAnyKey();
+      return null;
     }
 
-    // 操作提示
-    content += '\n' + chalk.dim('按任意键继续...');
+    // 确认删除
+    const confirmed = await confirmDeleteInternal(renderer, selected);
+    if (!confirmed) {
+      return null;
+    }
 
-    renderer.render(content);
+    // 执行删除
+    renderer.render(chalk.bold('\n执行删除中...'));
+    const stats = clean(selected);
 
-    // 等待按键
-    await waitForAnyKey();
+    // 显示结果
+    await showResultInternal(renderer, stats);
 
-    exitAlternateScreen();
-  } catch (error) {
-    exitAlternateScreen();
-    throw error;
-  }
+    return stats;
+  });
 }
 
-module.exports = { selectItems, confirmDelete, showResult };
+module.exports = { selectItems, confirmDelete, showResult, runCleanFlow };

package/src/common/ui/screen.js

@@ -3,7 +3,14 @@
  * 负责屏幕的清屏、重绘等操作
  */
 
-const { CLEAR_SCREEN, MOVE_CURSOR_HOME, SAVE_CURSOR, RESTORE_CURSOR } = require('./ansi.js');
+const {
+  CLEAR_SCREEN,
+  MOVE_CURSOR_HOME,
+  SAVE_CURSOR,
+  RESTORE_CURSOR,
+  enterAlternateScreen,
+  exitAlternateScreen
+} = require('./ansi.js');
 
 class ScreenRenderer {
   constructor() {
@@ -53,4 +60,21 @@ class ScreenRenderer {
   }
 }
 
-module.exports = { ScreenRenderer };
+/**
+ * 屏幕会话工厂函数
+ * 统一管理备用屏幕的生命周期
+ * @param {Function} fn - 在屏幕会话中执行的异步函数，接收 renderer 参数
+ * @returns {Promise<any>} fn 的返回值
+ */
+async function withScreenSession(fn) {
+  enterAlternateScreen();
+  const renderer = new ScreenRenderer();
+
+  try {
+    return await fn(renderer);
+  } finally {
+    exitAlternateScreen();
+  }
+}
+
+module.exports = { ScreenRenderer, withScreenSession };

package/src/common/ui/utils.js

@@ -74,7 +74,38 @@ function waitForNavigation() {
   });
 }
 
+/**
+ * 等待确认按键
+ * @returns {Promise<boolean>} true=确认, false=取消
+ */
+function waitForConfirm() {
+  return new Promise((resolve) => {
+    readline.emitKeypressEvents(process.stdin);
+    process.stdin.resume();
+    process.stdin.setRawMode(true);
+
+    const handler = (str, key) => {
+      if (key.name === 'return' || str.toLowerCase() === 'y') {
+        cleanup();
+        resolve(true);
+      } else if (key.name === 'escape' || str.toLowerCase() === 'n') {
+        cleanup();
+        resolve(false);
+      }
+    };
+
+    const cleanup = () => {
+      process.stdin.removeListener('keypress', handler);
+      process.stdin.setRawMode(false);
+      process.stdin.pause();
+    };
+
+    process.stdin.on('keypress', handler);
+  });
+}
+
 module.exports = {
   waitForAnyKey,
   waitForNavigation,
+  waitForConfirm,
 };

package/src/git-log/ui.js

@@ -12,8 +12,7 @@ const readline = require('readline');
 
 // Common UI 模块
 const { singleSelect } = require('../common/ui/single-select.js');
-const { enterAlternateScreen, exitAlternateScreen } = require('../common/ui/ansi.js');
-const { ScreenRenderer } = require('../common/ui/screen.js');
+const { withScreenSession } = require('../common/ui/screen.js');
 const { PagedDisplay } = require('../common/ui/pagination.js');
 
 // 配置文件路径
@@ -266,10 +265,7 @@ async function displayLogs (logs, onRefilter) {
     return;
   }
 
-  enterAlternateScreen();
-  const renderer = new ScreenRenderer();
-
-  try {
+  await withScreenSession(async (renderer) => {
     // 创建分页显示（动态计算每页条数）
     const pageSize = calculateDynamicPageSize();
     const pagedDisplay = new PagedDisplay(logs, pageSize);
@@ -290,16 +286,13 @@ async function displayLogs (logs, onRefilter) {
       } else if (action === 'prev') {
         pagedDisplay.prevPage();
       } else if (action === 'refilter') {
-        exitAlternateScreen();
         onRefilter();
         return;
       } else if (action === 'exit') {
         break;
       }
     }
-  } finally {
-    exitAlternateScreen();
-  }
+  });
 }
 
 module.exports = {

package/src/publish/core/builder.js

@@ -0,0 +1,61 @@
+/**
+ * 构建执行模块
+ * 检测和执行构建脚本
+ */
+
+const { execaCommand } = require('execa');
+
+/**
+ * 检测构建脚本
+ * @param {Object} scripts - package.json 中的 scripts 对象
+ * @returns {string|null} 找到的构建脚本名，未找到返回 null
+ */
+function detectBuildScripts(scripts) {
+  // 按优先级检测构建脚本
+  const buildScriptNames = [
+    'build',
+    'compile',
+    'prebuild',
+    'prepublishOnly'
+  ];
+
+  for (const scriptName of buildScriptNames) {
+    if (scripts && scripts[scriptName]) {
+      return scriptName;
+    }
+  }
+
+  return null;
+}
+
+/**
+ * 执行构建脚本
+ * @param {string} pkgPath - 包路径
+ * @param {string} scriptName - 脚本名称
+ * @returns {Promise<Object>} 执行结果
+ */
+async function runBuild(pkgPath, scriptName) {
+  try {
+    const result = await execaCommand(`npm run ${scriptName}`, {
+      cwd: pkgPath,
+      stdout: 'inherit',
+      stderr: 'inherit'
+    });
+
+    return {
+      success: true,
+      exitCode: result.exitCode
+    };
+  } catch (error) {
+    return {
+      success: false,
+      error: error.message,
+      exitCode: error.exitCode
+    };
+  }
+}
+
+module.exports = {
+  detectBuildScripts,
+  runBuild
+};