@kezh/my-custom-js-converter 1.5.1 → 1.6.1

package/core/config/index.js

@@ -25,6 +25,7 @@ function initConfig() {
         target: [""],
         settingDir: ".setting",
         customConfig: "config.js",
+        libs: [],
     };
     const curDir = __dirname;
     let baseDir = curDir.replace(/node_modules.*/g, "");

package/core/context/map_context.js

@@ -59,6 +59,56 @@ class MapContext {
             ? path_1.default.resolve(parentRootDir, srcPath)
             : srcPath;
     }
+    /**
+     * 补充缺失的依赖到 mod.map
+     * 在 self.dependencies 下新增该依赖（让 importMods 生成 require），
+     * 并新增独立的 mod 条目（让 getAbsoluteSrcPathByMod 拿到源文件路径）。
+     * methods 留空数组，后续 npx encode 会自动补全。
+     * @param depName - 依赖名（如 "drawer"）
+     * @param absoluteSrcPath - 依赖文件的绝对路径
+     */
+    appendMissingDep(depName, absoluteSrcPath) {
+        this.referenceDep(depName);
+        // map[depName] = { src: <相对 parentRootDir 的路径>, dependencies: {} }
+        const parentRootDir = (0, parent_path_1.getParentRootDir)();
+        const src = parentRootDir
+            ? path_1.default.relative(parentRootDir, absoluteSrcPath)
+            : absoluteSrcPath;
+        this.appendModMap(new map_config_1.Mod(src, new map_config_1.Dependencies()), false, depName);
+    }
+    /**
+     * 仅将已有 mod 条目引用到 self.dependencies（不新增/覆盖 mod 条目）。
+     * 用于 mod.map 中 mod 条目已存在（有 src）但未被 self 引用的情况：
+     * 只需让 importMods 生成 require、deleteModMethods 还原调用即可。
+     * @param depName - 依赖名（如 "drawer"）
+     */
+    referenceDep(depName) {
+        const selfMod = this.getMod("self");
+        if (selfMod) {
+            selfMod.dependencies[depName] = new map_config_1.Dependency([]);
+        }
+        else {
+            const mod = new map_config_1.Mod("", new map_config_1.Dependencies());
+            mod.dependencies[depName] = new map_config_1.Dependency([]);
+            this.appendModMap(mod, true);
+        }
+    }
+    /**
+     * 将当前 map 写入指定目录的 mod.map 文件
+     * @param outDir - 输出目录
+     */
+    writeToLocalDir(outDir) {
+        const outPath = path_1.default.join(outDir, MapContext.SAVE_FILE);
+        logger.info(`write map: ${outPath}`);
+        const json = JSON.stringify(this.map, null, 4);
+        try {
+            fs_1.default.accessSync(outDir);
+        }
+        catch (err) {
+            fs_1.default.mkdirSync(outDir);
+        }
+        fs_1.default.writeFileSync(outPath, json.replace(/\n/gm, os_1.EOL), "utf-8");
+    }
     static readFromLocal(inDir) {
         const inPath = path_1.default.join(inDir, MapContext.SAVE_FILE);
         logger.info(`read map: ${inPath}`);
@@ -82,16 +132,7 @@ class MapContext {
         this.writeToLocal();
     }
     writeToLocal() {
-        const outPath = path_1.default.join(this.outDir, MapContext.SAVE_FILE);
-        logger.info(`write map: ${outPath}`);
-        const json = JSON.stringify(this.map, null, 4);
-        try {
-            fs_1.default.accessSync(this.outDir);
-        }
-        catch (err) {
-            fs_1.default.mkdirSync(this.outDir);
-        }
-        fs_1.default.writeFileSync(outPath, json.replace(/\n/gm, os_1.EOL), "utf-8");
+        this.writeToLocalDir(this.outDir);
     }
     buildMapContext(inPath, entry, root) {
         const srcAst = (0, ast_1.parseSrcAst)(inPath);

package/core/decode/index.js

@@ -21,12 +21,14 @@ const fs_1 = __importDefault(require("fs"));
 const os_1 = require("os");
 const path_1 = __importDefault(require("path"));
 const prettier_1 = __importDefault(require("prettier"));
+const readline_1 = __importDefault(require("readline"));
 const config_1 = require("../config");
 const map_context_1 = require("../context/map_context");
 const scanf_1 = require("../scanf");
 const ast_1 = require("../util/ast");
 const version_1 = require("../util/version");
 const logger_1 = require("../util/logger");
+const parent_path_1 = require("../util/parent_path");
 const logger = (0, logger_1.createLogger)("decode");
 (function decoding(config) {
     return __awaiter(this, void 0, void 0, function* () {
@@ -35,15 +37,35 @@ const logger = (0, logger_1.createLogger)("decode");
         logger.info(`目标目录: ${targetDirs.join(", ")}`);
         const codeFiles = (0, scanf_1.scanfCodeFiles)(targetDirs, config.decode.file);
         logger.info(`找到 ${codeFiles.length} 个编码文件 (${config.decode.file})`);
+        // 解析 libs 目录（用于补充缺失依赖）
+        const rootDir = (0, parent_path_1.getParentRootDir)() || config.baseDir;
+        const libDirs = (0, scanf_1.resolveLibDirs)(config.libs, config.baseDir, rootDir);
+        if (libDirs.length) {
+            logger.info(`依赖库搜索目录: ${libDirs.join(", ")}`);
+        }
+        const conflicts = [];
         for (let i = 0; i < codeFiles.length; i++) {
             const inPath = codeFiles[i];
             const outPath = path_1.default.join(path_1.default.dirname(inPath), config.decode.output);
             const settingDir = path_1.default.join(path_1.default.dirname(inPath), config.settingDir);
             logger.step(`解码处理 [${i + 1}/${codeFiles.length}]`);
             logger.info(`源文件: ${inPath}`);
-            yield decoding$0(inPath, outPath, config, settingDir);
+            yield decoding$0(inPath, outPath, config, settingDir, libDirs, conflicts);
             logger.info(`输出: ${outPath}`);
         }
+        // 批处理结束后处理重名冲突
+        if (conflicts.length) {
+            logger.step("处理重名依赖冲突");
+            const conflictFiles = yield resolveConflicts(conflicts, config);
+            // 重新 decode 已解决冲突的文件
+            for (const inPath of conflictFiles) {
+                const outPath = path_1.default.join(path_1.default.dirname(inPath), config.decode.output);
+                const settingDir = path_1.default.join(path_1.default.dirname(inPath), config.settingDir);
+                logger.step(`重新解码: ${inPath}`);
+                yield decoding$0(inPath, outPath, config, settingDir, libDirs, []);
+                logger.info(`输出: ${outPath}`);
+            }
+        }
         logger.step("完成");
         logger.info(`共处理 ${codeFiles.length} 个文件`);
     });
@@ -54,10 +76,12 @@ const logger = (0, logger_1.createLogger)("decode");
  * @param outPath - 输入文件路径
  * @param config - 配置
  * @param settingDir - setting目录路径
+ * @param libDirs - 依赖库搜索目录（绝对路径）
+ * @param conflicts - 重名冲突收集列表（传入 null/空数组表示不记录冲突，如重跑时）
  */
-function decoding$0(inPath, outPath, config, settingDir) {
+function decoding$0(inPath, outPath, config, settingDir, libDirs, conflicts) {
     return __awaiter(this, void 0, void 0, function* () {
-        const mapContext = map_context_1.MapContext.readFromLocal(path_1.default.join(path_1.default.dirname(inPath), config.settingDir));
+        const mapContext = map_context_1.MapContext.readFromLocal(settingDir);
         let src = fs_1.default.readFileSync(inPath, {
             encoding: "utf-8"
         });
@@ -66,6 +90,12 @@ function decoding$0(inPath, outPath, config, settingDir) {
         if (!core_1.types.isNode(srcAst)) {
             return;
         }
+        // 补充缺失依赖：从 coded.js 提取未知 __{mod} 后缀，在 libs 目录搜索文件
+        const supplemented = supplementMissingDeps(srcAst, mapContext, libDirs, inPath, conflicts);
+        if (supplemented) {
+            // 有补充则先写回 mod.map，确保后续 importMods/deleteModMethods 能用到
+            mapContext.writeToLocalDir(settingDir);
+        }
         (0, ast_1.importMods)(path_1.default.dirname(outPath), srcAst, mapContext, config.encode.useAlias);
         (0, ast_1.deleteModMethods)(srcAst, mapContext);
         // 从onFormReady方法中提取版本日志并移除
@@ -82,6 +112,129 @@ function decoding$0(inPath, outPath, config, settingDir) {
         fs_1.default.writeFileSync(outPath, dist, "utf-8");
     });
 }
+/**
+ * 补充缺失依赖到 mapContext
+ * 扫描 coded.js 中未知的 __{mod} 后缀，在 libs 目录搜索对应文件并补充到 mod.map。
+ * @returns 是否有补充（需要写回 mod.map）
+ */
+function supplementMissingDeps(srcAst, mapContext, libDirs, inPath, conflicts) {
+    if (!libDirs.length) {
+        return false;
+    }
+    // 收集已知依赖名：所有 mod 的 dependencies 的并集。
+    // 注意判定标准必须与 deleteModMethods 一致——一个 __{mod} 后缀能被还原，
+    // 当且仅当 mod 出现在某个 mod 的 dependencies 中（而非仅仅是 mod 名存在于 map）。
+    // 否则 mod 条目存在但未被任何 mod 引用时（如 self.dependencies 缺少该依赖），
+    // 调用既不会还原也不会 require，需识别为"未知"并补充到 self.dependencies。
+    const knownDeps = new Set();
+    mapContext.getModNames().forEach((modName) => {
+        mapContext.getDependencyNameByMod(modName).forEach((dep) => knownDeps.add(dep));
+    });
+    const unknownDeps = (0, ast_1.getUnknownDepNames)(srcAst, knownDeps);
+    if (!unknownDeps.length) {
+        return false;
+    }
+    let supplemented = false;
+    unknownDeps.forEach((depName) => {
+        // 若 mod.map 已有该 mod 条目且 src 有效，只需补到 self.dependencies 即可，
+        // 无需重新搜索 libs（避免重名冲突和不必要的 src 覆盖）。
+        const existingSrc = mapContext.getSrcPathByMod(depName);
+        if (existingSrc) {
+            mapContext.referenceDep(depName);
+            logger.info(`补充依赖引用: ${depName}（复用已有 src: ${existingSrc}）`);
+            supplemented = true;
+            return;
+        }
+        const candidates = (0, scanf_1.scanfLibMod)(libDirs, depName);
+        if (candidates.length === 0) {
+            logger.warn(`未找到依赖文件: ${depName}（在 libs 目录中无匹配）`);
+        }
+        else if (candidates.length === 1) {
+            mapContext.appendMissingDep(depName, candidates[0]);
+            logger.info(`补充依赖: ${depName} -> ${candidates[0]}`);
+            supplemented = true;
+        }
+        else {
+            conflicts.push({ inPath, depName, candidates });
+            logger.warn(`依赖重名: ${depName}，找到 ${candidates.length} 个候选，稍后处理`);
+        }
+    });
+    return supplemented;
+}
+/**
+ * 交互式解决重名依赖冲突
+ * 逐个让用户选择依赖文件，更新对应 mod.map。
+ * @returns 需要重新 decode 的文件路径列表（去重）
+ */
+function resolveConflicts(conflicts, config) {
+    return __awaiter(this, void 0, void 0, function* () {
+        // 按 inPath 分组
+        const byFile = new Map();
+        conflicts.forEach((c) => {
+            if (!byFile.has(c.inPath)) {
+                byFile.set(c.inPath, []);
+            }
+            byFile.get(c.inPath).push(c);
+        });
+        const redecodeFiles = [];
+        for (const [inPath, fileConflicts] of byFile) {
+            const settingDir = path_1.default.join(path_1.default.dirname(inPath), config.settingDir);
+            const mapContext = map_context_1.MapContext.readFromLocal(settingDir);
+            let resolved = false;
+            logger.info(`文件: ${inPath}`);
+            for (const { depName, candidates } of fileConflicts) {
+                const choice = yield askConflictChoice(depName, candidates);
+                if (choice === null) {
+                    // 用户跳过
+                    logger.warn(`跳过依赖: ${depName}`);
+                    continue;
+                }
+                mapContext.appendMissingDep(depName, candidates[choice]);
+                logger.info(`已选择: ${depName} -> ${candidates[choice]}`);
+                resolved = true;
+            }
+            if (resolved) {
+                mapContext.writeToLocalDir(settingDir);
+                if (!redecodeFiles.includes(inPath)) {
+                    redecodeFiles.push(inPath);
+                }
+            }
+        }
+        return redecodeFiles;
+    });
+}
+/**
+ * 交互式询问用户选择重名依赖的候选文件
+ * @returns 选择的候选序号，null 表示跳过
+ */
+function askConflictChoice(depName, candidates) {
+    return new Promise((resolve) => {
+        const rl = readline_1.default.createInterface({
+            input: process.stdin,
+            output: process.stdout
+        });
+        console.log(`\n  依赖 "${depName}" 找到 ${candidates.length} 个候选文件:`);
+        candidates.forEach((c, i) => {
+            console.log(`    [${i + 1}] ${c}`);
+        });
+        console.log(`    [s] 跳过该依赖`);
+        rl.question(`  请选择 [1-${candidates.length} / s]: `, (answer) => {
+            rl.close();
+            const trimmed = answer.trim().toLowerCase();
+            if (trimmed === "s") {
+                resolve(null);
+                return;
+            }
+            const num = parseInt(trimmed, 10);
+            if (isNaN(num) || num < 1 || num > candidates.length) {
+                logger.warn(`无效输入，已跳过: ${depName}`);
+                resolve(null);
+                return;
+            }
+            resolve(num - 1);
+        });
+    });
+}
 /**
  * 从onFormReady方法中提取版本日志并移除，将版本号写入version文件
  * @param srcAst - 源码AST

package/core/scanf/index.js

@@ -5,6 +5,8 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.scanfCodeFiles = scanfCodeFiles;
 exports.scanfCodeDirs = scanfCodeDirs;
+exports.resolveLibDirs = resolveLibDirs;
+exports.scanfLibMod = scanfLibMod;
 exports.scanfRequieMod = scanfRequieMod;
 const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
@@ -46,6 +48,75 @@ function scanfCodeDirs(baseDir, targetDirs) {
     const dirs = new Set(targetDirs);
     return [...dirs].map((dir) => `${path_1.default.join(baseDir, dir.replace(/\/|\\/, path_1.default.sep))}`);
 }
+/**
+ * 将 libs 配置解析为绝对路径数组
+ * 支持 "@/util" 别名路径（@ 代表项目根目录 rootDir）和 "util" 相对 baseDir 路径
+ * @param libs - libs 配置数组
+ * @param baseDir - 基础目录（相对路径的基准）
+ * @param rootDir - 项目根目录（@ 别名的基准，未提供时 @ 路径会被跳过并警告）
+ * @returns 绝对路径数组
+ */
+function resolveLibDirs(libs, baseDir, rootDir) {
+    return libs
+        .map((lib) => {
+        if (lib.startsWith("@/") || lib.startsWith("@\\")) {
+            if (!rootDir) {
+                logger.warn(`@ 别名路径需要 rootDir，已跳过: ${lib}`);
+                return "";
+            }
+            const sub = lib.replace(/^@[/\\]/, "");
+            return path_1.default.join(rootDir.replace(/[\\/]$/, ""), sub);
+        }
+        return path_1.default.join(baseDir, lib.replace(/\/|\\/, path_1.default.sep));
+    })
+        .filter((dir) => dir !== "");
+}
+/**
+ * 在 libs 目录下搜索依赖模块文件
+ * 查找 modName.js（文件）和 modName/index.js（目录下入口）
+ * @param libDirs - 已解析的绝对路径目录数组
+ * @param modName - 依赖模块名（如 "drawer"）
+ * @returns 所有匹配的绝对路径数组
+ */
+function scanfLibMod(libDirs, modName) {
+    const results = [];
+    const seen = new Set();
+    libDirs.forEach((libDir) => {
+        if (!fs_1.default.existsSync(libDir)) {
+            return;
+        }
+        // 1. libDir/modName.js
+        const filePath = path_1.default.join(libDir, `${modName}.js`);
+        if (fs_1.default.existsSync(filePath) && !seen.has(filePath)) {
+            seen.add(filePath);
+            results.push(filePath);
+        }
+        // 2. libDir/modName/index.js（modName 为子目录）
+        const subDir = path_1.default.join(libDir, modName);
+        if (fs_1.default.existsSync(subDir) && fs_1.default.statSync(subDir).isDirectory()) {
+            const indexFile = path_1.default.join(subDir, "index.js");
+            if (fs_1.default.existsSync(indexFile) && !seen.has(indexFile)) {
+                seen.add(indexFile);
+                results.push(indexFile);
+            }
+        }
+        // 3. 递归搜索子目录（通用方法可能嵌套在子目录下）
+        const subDirs = fs_1.default
+            .readdirSync(libDir, { withFileTypes: true })
+            .filter((d) => d.isDirectory())
+            .map((d) => path_1.default.join(libDir, d.name));
+        subDirs.forEach((sub) => {
+            const nested = scanfLibMod([sub], modName);
+            nested.forEach((p) => {
+                if (!seen.has(p)) {
+                    seen.add(p);
+                    results.push(p);
+                }
+            });
+        });
+    });
+    return results;
+}
 /**
  * 扫描引入路径
  * require('../../util')

package/core/util/ast.js

@@ -15,6 +15,7 @@ exports.getDependentMethodNames = getDependentMethodNames;
 exports.importMods = importMods;
 exports.deleteModMethods = deleteModMethods;
 exports.getInlineMethodsByMethodName = getInlineMethodsByMethodName;
+exports.getUnknownDepNames = getUnknownDepNames;
 const fs_1 = __importDefault(require("fs"));
 const parser_1 = require("@babel/parser");
 const traverse_1 = __importDefault(require("@babel/traverse"));
@@ -455,3 +456,39 @@ function getInlineMethodsByMethodName(srcAst, entry, methodName, useMethodNameMa
     });
     return [...inlineMethods];
 }
+/**
+ * 从 coded.js 的 AST 中提取未知的依赖名（__{mod} 后缀中的 mod）
+ * 扫描 ObjectMethod 的 key 和 MemberExpression 的 property，提取 xxx__yyy 中的 yyy，
+ * 排除已知依赖名（mod.map 中已有的依赖）。
+ * @param srcAst - 源码AST
+ * @param knownDeps - 已知依赖名集合
+ * @returns 未知依赖名数组（去重）
+ */
+function getUnknownDepNames(srcAst, knownDeps) {
+    const depNames = new Set();
+    const collect = (name) => {
+        const split = name.split("__");
+        if (split.length < 2) {
+            return;
+        }
+        // 取最后一段作为依赖名（与 deleteModMethods 的解析逻辑一致）
+        const depName = split[split.length - 1];
+        if (!depName || knownDeps.has(depName)) {
+            return;
+        }
+        depNames.add(depName);
+    };
+    (0, traverse_1.default)(srcAst, {
+        ObjectMethod(path) {
+            if (core_1.types.isIdentifier(path.node.key)) {
+                collect(path.node.key.name);
+            }
+        },
+        MemberExpression(path) {
+            if (core_1.types.isIdentifier(path.node.property)) {
+                collect(path.node.property.name);
+            }
+        }
+    });
+    return [...depNames];
+}

package/package.json

@@ -1,42 +1,46 @@
-{
-  "name": "@kezh/my-custom-js-converter",
-  "version": "1.5.1",
-  "description": "自定义代码转换器",
-  "main": "index.js",
-  "bin": {
-    "encode": "core/encode/index.js",
-    "decode": "core/decode/index.js"
-  },
-  "scripts": {
-    "build": "npx tsc --build",
-    "test": "npm run build && node test/run_tests.js",
-    "test:manual": "npm run build && node test/manual_review.js"
-  },
-  "engines": {
-    "node": ">=24.15.0"
-  },
-  "author": "shahow",
-  "license": "MIT",
-  "keywords": [
-    "babel"
-  ],
-  "dependencies": {
-    "@babel/cli": "^7.29.7",
-    "@babel/core": "^7.29.7",
-    "@babel/generator": "^7.29.7",
-    "@babel/parser": "^7.29.7",
-    "@babel/traverse": "^7.29.7",
-    "@babel/types": "^7.29.7",
-    "prettier": "^3.8.4"
-  },
-  "devDependencies": {
-    "@types/babel__core": "^7.20.5",
-    "@types/babel__generator": "^7.27.0",
-    "@types/babel__traverse": "^7.28.0",
-    "@types/node": "^25.9.3",
-    "typescript": "^6.0.3"
-  },
-  "volta": {
-    "node": "24.15.0"
-  }
-}
+{
+  "name": "@kezh/my-custom-js-converter",
+  "version": "1.6.1",
+  "description": "自定义代码转换器",
+  "main": "index.js",
+  "files": [
+    "core/**/*.js",
+    "README.md"
+  ],
+  "bin": {
+    "encode": "core/encode/index.js",
+    "decode": "core/decode/index.js"
+  },
+  "scripts": {
+    "build": "npx tsc --build",
+    "test": "npm run build && node test/run_tests.js",
+    "test:manual": "npm run build && node test/manual_review.js"
+  },
+  "engines": {
+    "node": ">=24.15.0"
+  },
+  "author": "shahow",
+  "license": "MIT",
+  "keywords": [
+    "babel"
+  ],
+  "dependencies": {
+    "@babel/cli": "^7.29.7",
+    "@babel/core": "^7.29.7",
+    "@babel/generator": "^7.29.7",
+    "@babel/parser": "^7.29.7",
+    "@babel/traverse": "^7.29.7",
+    "@babel/types": "^7.29.7",
+    "prettier": "^3.8.4"
+  },
+  "devDependencies": {
+    "@types/babel__core": "^7.20.5",
+    "@types/babel__generator": "^7.27.0",
+    "@types/babel__traverse": "^7.28.0",
+    "@types/node": "^25.9.3",
+    "typescript": "^6.0.3"
+  },
+  "volta": {
+    "node": "24.15.0"
+  }
+}

package/.claude/plan.md

@@ -1,65 +0,0 @@
-# 日志优化方案
-
-## 现状问题
-
-1. **格式不统一** — 有的用 `=>` 分隔，有的直接打印数组，风格混乱
-2. **缺少层级结构** — 所有日志平铺输出，无法区分步骤/阶段
-3. **信息不完整** — `scanf dirs => ` 和数组分两行打印，`the map is not found!` 没有上下文
-4. **缺少状态标识** — 没有成功/失败/警告等视觉区分
-5. **中英混杂** — `路径不存在[...]忽略` vs `scanf dirs` vs `the map is not found!`
-6. **缺少汇总** — 处理完成后没有统计摘要
-
-## 优化方案
-
-### 1. 新建 `src/util/logger.ts` — 统一日志工具
-
-```typescript
-export function createLogger(scope: string) {
-  return {
-    info(msg: string)  { console.log(`[${scope}] ✔ ${msg}`); },
-    warn(msg: string)  { console.log(`[${scope}] ⚠ ${msg}`); },
-    error(msg: string) { console.log(`[${scope}] ✖ ${msg}`); },
-    step(title: string) {
-      console.log(`\n[${scope}] ── ${title} ${'─'.repeat(Math.max(0, 50 - title.length))}`);
-    },
-  };
-}
-```
-
-简洁、无外部依赖、终端友好。
-
-### 2. 日志对照表
-
-| 原始 | 优化后 |
-|---|---|
-| `console.log("scanf dirs => ")` + `console.log(targetDirs)` | `logger.info('scanf dirs: ' + targetDirs.join(', '))` |
-| `console.log(\`scanf file => ${inPath}\`)` | `logger.info(\`scanf file: ${inPath}\`)` |
-| `console.log(\`output file => ${outPath}\`)` | `logger.info(\`output: ${outPath}\`)` |
-| `console.log(\`output => ${outPath}\`)` | `logger.info(\`output: ${outPath}\`)` |
-| `console.log(\`input map => ${inPath}\`)` | `logger.info(\`read map: ${inPath}\`)` |
-| `console.log("the map is not found!")` | `logger.warn('map file not found')` |
-| `console.log(\`output map => ${outPath}\`)` | `logger.info(\`write map: ${outPath}\`)` |
-| `console.log(\`not found entry => ${entry}\`)` | `logger.warn(\`entry not found: ${entry}\`)` |
-| `console.log(\`路径不存在[${dirPath}]忽略\`)` | `logger.warn(\`dir not found, skipping: ${dirPath}\`)` |
-| `console.log(\`ignore module => ${item.id.name}\`)` | `logger.info(\`ignore module: ${item.id.name}\`)` |
-
-### 3. 增加步骤分隔和汇总
-
-**encode** 流程增加：
-- 步骤标题：扫描目录 → 查找文件 → 编码处理
-- 汇总：处理文件数、方法总数、版本号
-
-**decode** 流程增加：
-- 步骤标题：扫描目录 → 查找文件 → 解码处理
-- 汇总：处理文件数
-
-### 4. 修改文件清单
-
-| 文件 | 变更 |
-|---|---|
-| `src/util/logger.ts` | **新建** — 日志工具模块 |
-| `src/encode/index.ts` | 替换 4 处 console.log，增加步骤和汇总 |
-| `src/decode/index.ts` | 替换 4 处 console.log，增加步骤和汇总 |
-| `src/context/map_context.ts` | 替换 3 处 console.log |
-| `src/scanf/index.ts` | 替换 1 处 console.log |
-| `src/util/ast.ts` | 替换 1 处 console.log |

package/CLAUDE.md

@@ -1,50 +0,0 @@
-# CLAUDE.md
-
-This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
-
-## Project Overview
-
-`@kezh/my-custom-js-converter` is a Babel-based JavaScript code transformer that **encodes** (flattens) and **decodes** (restores) CommonJS module structures. It takes JavaScript files that use `require()` + object-oriented patterns and flattens them into a single object with renamed methods, then can reverse the process.
-
-## Build & Run
-
-```bash
-pnpm install          # install dependencies
-pnpm build            # compile TypeScript (npx tsc --build)
-```
-
-The compiled output goes to `core/` (gitignored). Source is in `src/`.
-
-Two CLI entry points (declared in `package.json` bin):
-- `encode` → `core/encode/index.js` — flattens modules into a single file
-- `decode` → `core/decode/index.js` — restores the original module structure
-
-No test framework is configured.
-
-## Architecture
-
-### Data Flow
-
-**Encode**: Scan target dirs → find entry JS files → build dependency map (`MapContext`) → extract & rename methods from all modules → output single flattened file + `mod.map`
-
-**Decode**: Read `mod.map` → read encoded file → re-insert `require` statements → remove inlined dependency methods → restore original method names → output restored file
-
-### Key Modules
-
-- **`src/config/`** — Configuration loading. `MainConfig` defines encode/decode settings (entry object name, file names, ignore list). Reads `config.json` from the parent project root when installed as a dependency.
-- **`src/context/map_context.ts`** — Core orchestration. `MapContext` builds a dependency graph by recursively walking `require()` calls, then performs **filtering** (removing invalid method references) and **tree-shaking** (removing unused methods). Serializes to `mod.map` JSON file.
-- **`src/util/ast.ts`** — All Babel AST manipulation: parsing, traversing, extracting object methods, renaming methods (appending `__modName` suffix), generating import statements, and reversing the renaming during decode.
-- **`src/scanf/`** — File system scanning: finding target files by name, resolving `require()` paths (handles both `dir/index.js` and `file.js` patterns).
-- **`src/util/parent_path.ts`** — Detects whether the tool is running inside `node_modules/` and resolves the parent project root.
-
-### Encoding Convention
-
-Methods from dependency modules are renamed with a `__modName` suffix (e.g., `helperMethod` becomes `helperMethod__util`). `this.method()` calls in the root module stay as-is; in dependency modules, `this.method()` becomes `this.method__modName()`. The decode step reverses this convention.
-
-### Configuration
-
-When used as a dependency, the tool reads `config.json` from the parent project's root. Default config:
-- `encode.file`: `"index.js"`, `encode.output`: `"coded.js"`, `encode.entry`: `"customEvent"`
-- `decode.file`: `"coded.js"`, `decode.output`: `"decoded.js"`, `decode.mount`: `"customEvent"`
-- `settingDir`: `".setting"` (where `mod.map` is stored)
-- `target`: directories to scan relative to `baseDir`