adspecs 0.1.19 → 0.1.21

package/src/lib/area-scanner.js

@@ -1,129 +1,129 @@
-'use strict';
-
-const fs = require('fs');
-const path = require('path');
-const { hasAnyFile } = require('./dir-utils');
-
-/**
- * 区域状态扫描
- *
- * 按模式扫描目标目录，返回各区域的存在状态，
- * 为冲突决策和计划摘要提供数据基础。
- */
-
-/**
- * 各区域的目录名映射
- */
-const AREA_DIRS = {
-  adspecs: '.adspecs',
-  docs: 'docs',
-  wiki: 'wiki',
-  webUi: 'web-ui',
-  service: 'service',
-  frontDemo: 'front-demo',
-};
-
-/**
- * 按模式返回需要处理的区域列表
- *
- * @param {string} mode - 初始化模式
- * @returns {string[]} 区域 key 列表
- */
-function getAreaListForMode(mode) {
-  switch (mode) {
-    case 'simple':
-      return ['adspecs', 'docs', 'wiki'];
-    case 'classic':
-      return ['adspecs', 'docs', 'wiki', 'frontDemo'];
-    case 'full':
-    case 'demo':
-      return ['adspecs', 'docs', 'wiki', 'webUi', 'service', 'frontDemo'];
-    default:
-      return ['adspecs', 'docs', 'wiki'];
-  }
-}
-
-/**
- * 按模式扫描目标目录，返回各区域存在状态
- *
- * @param {string} targetDir - 目标项目根目录
- * @param {string} mode - 初始化模式
- * @returns {object} 区域状态映射 { areaKey: { exists, hasFiles, dirName } }
- */
-function scanAreaStates(targetDir, mode) {
-  const areas = getAreaListForMode(mode);
-  const states = {};
-
-  for (const areaKey of areas) {
-    const dirName = AREA_DIRS[areaKey];
-    const fullPath = path.join(targetDir, dirName);
-    const exists = fs.existsSync(fullPath);
-
-    states[areaKey] = {
-      exists,
-      hasFiles: exists ? hasAnyFile(fullPath) : false,
-      dirName,
-    };
-  }
-
-  return states;
-}
-
-/**
- * 将区域 key 转换为中文显示名
- *
- * @param {string} areaKey
- * @returns {string}
- */
-function areaDisplayName(areaKey) {
-  const names = {
-    adspecs: '.adspecs',
-    docs: 'docs',
-    wiki: 'wiki',
-    webUi: 'web-ui',
-    service: 'service',
-    frontDemo: 'front-demo',
-  };
-  return names[areaKey] || areaKey;
-}
-
-/**
- * 将决策转换为中文描述
- *
- * @param {string} decision - create | recreate | update | skip
- * @returns {string}
- */
-function decisionLabel(decision) {
-  const labels = {
-    create: '创建',
-    recreate: '重新创建',
-    update: '更新',
-    skip: '跳过',
-  };
-  return labels[decision] || decision;
-}
-
-/**
- * 将决策转换为状态图标
- *
- * @param {string} decision
- * @returns {string}
- */
-function decisionIcon(decision) {
-  const icons = {
-    create: '✅',
-    recreate: '🔄',
-    update: '🔄',
-    skip: '⏭',
-  };
-  return icons[decision] || '❓';
-}
-
-module.exports = {
-  AREA_DIRS,
-  getAreaListForMode,
-  scanAreaStates,
-  areaDisplayName,
-  decisionLabel,
-  decisionIcon,
-};
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+const { hasAnyFile } = require('./dir-utils');
+
+/**
+ * 区域状态扫描
+ *
+ * 按模式扫描目标目录，返回各区域的存在状态，
+ * 为冲突决策和计划摘要提供数据基础。
+ */
+
+/**
+ * 各区域的目录名映射
+ */
+const AREA_DIRS = {
+  adspecs: '.adspecs',
+  docs: 'docs',
+  wiki: 'wiki',
+  webUi: 'web-ui',
+  service: 'service',
+  frontDemo: 'front-demo',
+};
+
+/**
+ * 按模式返回需要处理的区域列表
+ *
+ * @param {string} mode - 初始化模式
+ * @returns {string[]} 区域 key 列表
+ */
+function getAreaListForMode(mode) {
+  switch (mode) {
+    case 'simple':
+      return ['adspecs', 'docs', 'wiki'];
+    case 'classic':
+      return ['adspecs', 'docs', 'wiki', 'frontDemo'];
+    case 'full':
+    case 'demo':
+      return ['adspecs', 'docs', 'wiki', 'webUi', 'service', 'frontDemo'];
+    default:
+      return ['adspecs', 'docs', 'wiki'];
+  }
+}
+
+/**
+ * 按模式扫描目标目录，返回各区域存在状态
+ *
+ * @param {string} targetDir - 目标项目根目录
+ * @param {string} mode - 初始化模式
+ * @returns {object} 区域状态映射 { areaKey: { exists, hasFiles, dirName } }
+ */
+function scanAreaStates(targetDir, mode) {
+  const areas = getAreaListForMode(mode);
+  const states = {};
+
+  for (const areaKey of areas) {
+    const dirName = AREA_DIRS[areaKey];
+    const fullPath = path.join(targetDir, dirName);
+    const exists = fs.existsSync(fullPath);
+
+    states[areaKey] = {
+      exists,
+      hasFiles: exists ? hasAnyFile(fullPath) : false,
+      dirName,
+    };
+  }
+
+  return states;
+}
+
+/**
+ * 将区域 key 转换为中文显示名
+ *
+ * @param {string} areaKey
+ * @returns {string}
+ */
+function areaDisplayName(areaKey) {
+  const names = {
+    adspecs: '.adspecs',
+    docs: 'docs',
+    wiki: 'wiki',
+    webUi: 'web-ui',
+    service: 'service',
+    frontDemo: 'front-demo',
+  };
+  return names[areaKey] || areaKey;
+}
+
+/**
+ * 将决策转换为中文描述
+ *
+ * @param {string} decision - create | recreate | update | skip
+ * @returns {string}
+ */
+function decisionLabel(decision) {
+  const labels = {
+    create: '创建',
+    recreate: '重新创建',
+    update: '更新',
+    skip: '跳过',
+  };
+  return labels[decision] || decision;
+}
+
+/**
+ * 将决策转换为状态图标
+ *
+ * @param {string} decision
+ * @returns {string}
+ */
+function decisionIcon(decision) {
+  const icons = {
+    create: '✅',
+    recreate: '🔄',
+    update: '🔄',
+    skip: '⏭',
+  };
+  return icons[decision] || '❓';
+}
+
+module.exports = {
+  AREA_DIRS,
+  getAreaListForMode,
+  scanAreaStates,
+  areaDisplayName,
+  decisionLabel,
+  decisionIcon,
+};

package/src/lib/copier.js

@@ -1,104 +1,104 @@
-'use strict';
-
-const fs = require('fs');
-const path = require('path');
-
-/**
- * 复制过程中需要跳过的目录名
- * 这些目录通常不应出现在目标项目中（体积大 / 与版本控制冲突 / 运行时缓存）
- */
-const EXCLUDED_DIRS = new Set([
-  'node_modules',
-  '.git',
-  '.vite',
-  '.venv',
-  '__pycache__',
-  '.next',
-  'dist',
-  'build',
-]);
-
-/**
- * 递归复制目录，过滤掉不需要的大目录
- *
- * @param {string} src - 源目录绝对路径
- * @param {string} dest - 目标目录绝对路径（不存在会自动创建）
- * @param {object} [opts] - 选项
- * @param {Set<string>} [opts.exclude] - 额外要排除的目录名
- * @param {function} [opts.onProgress] - 进度回调 (filePath: string) => void
- * @returns {{ fileCount: number, skippedDirs: string[] }} 复制的文件数和被跳过的目录
- */
-function copyDirFiltered(src, dest, opts = {}) {
-  const exclude = opts.exclude || new Set();
-  const onProgress = opts.onProgress || (() => {});
-  const skippedDirs = [];
-
-  if (!fs.existsSync(src)) {
-    return { fileCount: 0, skippedDirs };
-  }
-
-  fs.mkdirSync(dest, { recursive: true });
-
-  let fileCount = 0;
-
-  function _copy(currentSrc, currentDest) {
-    const entries = fs.readdirSync(currentSrc, { withFileTypes: true });
-    for (const entry of entries) {
-      const srcPath = path.join(currentSrc, entry.name);
-      const destPath = path.join(currentDest, entry.name);
-
-      if (entry.isDirectory()) {
-        if (EXCLUDED_DIRS.has(entry.name) || exclude.has(entry.name)) {
-          skippedDirs.push(entry.name);
-          continue;
-        }
-        fs.mkdirSync(destPath, { recursive: true });
-        _copy(srcPath, destPath);
-      } else if (entry.isFile()) {
-        fs.copyFileSync(srcPath, destPath);
-        onProgress(destPath);
-        fileCount++;
-      }
-    }
-  }
-
-  _copy(src, dest);
-  return { fileCount, skippedDirs };
-}
-
-/**
- * 删除目录（如果存在）
- * @param {string} dirPath - 目录路径
- */
-function removeDir(dirPath) {
-  if (fs.existsSync(dirPath)) {
-    fs.rmSync(dirPath, { recursive: true, force: true });
-  }
-}
-
-/**
- * 统计目录下的文件数量
- * @param {string} dirPath - 目录路径
- * @returns {number}
- */
-function countFiles(dirPath) {
-  if (!fs.existsSync(dirPath)) return 0;
-  let count = 0;
-  const entries = fs.readdirSync(dirPath, { withFileTypes: true });
-  for (const entry of entries) {
-    const fullPath = path.join(dirPath, entry.name);
-    if (entry.isDirectory()) {
-      count += countFiles(fullPath);
-    } else if (entry.isFile()) {
-      count++;
-    }
-  }
-  return count;
-}
-
-module.exports = {
-  copyDirFiltered,
-  removeDir,
-  countFiles,
-  EXCLUDED_DIRS,
-};
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+
+/**
+ * 复制过程中需要跳过的目录名
+ * 这些目录通常不应出现在目标项目中（体积大 / 与版本控制冲突 / 运行时缓存）
+ */
+const EXCLUDED_DIRS = new Set([
+  'node_modules',
+  '.git',
+  '.vite',
+  '.venv',
+  '__pycache__',
+  '.next',
+  'dist',
+  'build',
+]);
+
+/**
+ * 递归复制目录，过滤掉不需要的大目录
+ *
+ * @param {string} src - 源目录绝对路径
+ * @param {string} dest - 目标目录绝对路径（不存在会自动创建）
+ * @param {object} [opts] - 选项
+ * @param {Set<string>} [opts.exclude] - 额外要排除的目录名
+ * @param {function} [opts.onProgress] - 进度回调 (filePath: string) => void
+ * @returns {{ fileCount: number, skippedDirs: string[] }} 复制的文件数和被跳过的目录
+ */
+function copyDirFiltered(src, dest, opts = {}) {
+  const exclude = opts.exclude || new Set();
+  const onProgress = opts.onProgress || (() => {});
+  const skippedDirs = [];
+
+  if (!fs.existsSync(src)) {
+    return { fileCount: 0, skippedDirs };
+  }
+
+  fs.mkdirSync(dest, { recursive: true });
+
+  let fileCount = 0;
+
+  function _copy(currentSrc, currentDest) {
+    const entries = fs.readdirSync(currentSrc, { withFileTypes: true });
+    for (const entry of entries) {
+      const srcPath = path.join(currentSrc, entry.name);
+      const destPath = path.join(currentDest, entry.name);
+
+      if (entry.isDirectory()) {
+        if (EXCLUDED_DIRS.has(entry.name) || exclude.has(entry.name)) {
+          skippedDirs.push(entry.name);
+          continue;
+        }
+        fs.mkdirSync(destPath, { recursive: true });
+        _copy(srcPath, destPath);
+      } else if (entry.isFile()) {
+        fs.copyFileSync(srcPath, destPath);
+        onProgress(destPath);
+        fileCount++;
+      }
+    }
+  }
+
+  _copy(src, dest);
+  return { fileCount, skippedDirs };
+}
+
+/**
+ * 删除目录（如果存在）
+ * @param {string} dirPath - 目录路径
+ */
+function removeDir(dirPath) {
+  if (fs.existsSync(dirPath)) {
+    fs.rmSync(dirPath, { recursive: true, force: true });
+  }
+}
+
+/**
+ * 统计目录下的文件数量
+ * @param {string} dirPath - 目录路径
+ * @returns {number}
+ */
+function countFiles(dirPath) {
+  if (!fs.existsSync(dirPath)) return 0;
+  let count = 0;
+  const entries = fs.readdirSync(dirPath, { withFileTypes: true });
+  for (const entry of entries) {
+    const fullPath = path.join(dirPath, entry.name);
+    if (entry.isDirectory()) {
+      count += countFiles(fullPath);
+    } else if (entry.isFile()) {
+      count++;
+    }
+  }
+  return count;
+}
+
+module.exports = {
+  copyDirFiltered,
+  removeDir,
+  countFiles,
+  EXCLUDED_DIRS,
+};