@chaoswise/intl 3.1.1 → 3.1.3

package/bin/scripts/verify.js

@@ -8,41 +8,14 @@ const transformAst = require('./util/transformAst');
 const log = require('./util/log');
 const file = require('./util/file');
 
-/**
- * verify: 检测当前工程输出文件中所有 intl.get('id') 的 id
- *   - pending  : 临时 key，存在于 relationKey.json（尚未执行 update 替换）
- *   - ok       : 已在本地 locale 文件中找到
- *   - missing  : 两处均找不到，属于"孤立 id"，运行时将无法解析
- *
- * 用法：
- *   chaoswise-intl verify          → 发现 missing 时 exit(1)（CI 门禁）
- *   chaoswise-intl verify --warn   → 仅警告，不 exit(1)
- */
-async function verify({ exitOnMissing = true } = {}) {
-  log.info('词条 id 校验中...');
-
-  const conf = getConf();
-  const files = targetOutputFiles(conf);
-
-  if (!files.length) {
-    log.warn('未找到需要扫描的文件，请检查 output 配置');
-    return;
-  }
-
-  // ── Step 1: 收集代码中所有原始 id（传入空对象，不触发替换也不写文件）──────
+// ── 公共：扫描并分类所有 id ────────────────────────────────────────────────────
+function scanIds(conf, files) {
   const info = transformAst('update', files, conf, {});
   const allIds = [...new Set(info.downloadIds.filter(Boolean))];
 
-  if (!allIds.length) {
-    log.success('未发现任何国际化 id，无需校验');
-    return;
-  }
-
-  // ── Step 2: 从 relationKey.json 获取待替换的临时 key 集合 ───────────────
   const relationKey = file.readJson('relationKey.json') || {};
   const pendingKeySet = new Set(Object.keys(relationKey));
 
-  // ── Step 3: 从本地 locale 文件获取已下载的合法 id 集合 ────────────────────
   const rootPath = process.cwd();
   const localeDir = path.resolve(rootPath, conf.localeOutput, 'locales');
   const localeFiles = glob.sync(`${localeDir}/*.json`);
@@ -56,7 +29,6 @@ async function verify({ exitOnMissing = true } = {}) {
     }
   });
 
-  // ── Step 4: 分类统计 ──────────────────────────────────────────────────────
   const pending = [];
   const missing = [];
   const ok = [];
@@ -71,27 +43,62 @@ async function verify({ exitOnMissing = true } = {}) {
     }
   }
 
-  // ── Step 5: 输出结果 ──────────────────────────────────────────────────────
+  return { allIds, pending, missing, ok };
+}
+
+// ── 公共：打印分类结果 ─────────────────────────────────────────────────────────
+function printResult({ allIds, pending, missing, ok }, files) {
   console.log('');
   log.info(`扫描到 ${allIds.length} 个唯一 id（文件数：${files.length}）`);
 
   if (ok.length) {
     log.success(`✓ ${ok.length} 个 id 已在本地 locale 文件中覆盖`);
   }
-
   if (pending.length) {
     log.warnToLog(`⚠ ${pending.length} 个临时 key 尚未执行 update 替换：`);
     pending.forEach(({ tempKey, realId }) => {
       log.warnToLog(`    ${tempKey}  →  ${realId}`);
     });
   }
-
   if (missing.length) {
-    log.error(`✗ ${missing.length} 个 id 在 relationKey.json 和本地 locale 文件中均不存在（孤立 id）：`);
+    log.error(`✗ ${missing.length} 个孤立 id（relationKey.json 和本地 locale 文件中均不存在）：`);
     missing.forEach((id) => log.error(`    ${id}`));
     console.log('');
     log.error('提示：孤立 id 可能是未上传到国际化平台、未执行 update 拉取，或已在平台删除的词条');
+  }
+}
+
+/**
+ * verify: 检测当前工程输出文件中所有 intl.get('id') 的 id
+ *   - pending  : 临时 key，存在于 relationKey.json（尚未执行 update 替换）
+ *   - ok       : 已在本地 locale 文件中找到
+ *   - missing  : 两处均找不到，属于"孤立 id"，运行时将无法解析
+ *
+ * 用法：
+ *   chaoswise-intl verify          → 发现 missing 时 exit(1)（CI 门禁）
+ *   chaoswise-intl verify --warn   → 仅警告，不 exit(1)
+ */
+async function verify({ exitOnMissing = true } = {}) {
+  log.info('词条 id 校验中...');
+
+  const conf = getConf();
+  const files = targetOutputFiles(conf);
 
+  if (!files.length) {
+    log.warnToLog('未找到需要扫描的文件，请检查 output 配置');
+    return;
+  }
+
+  const result = scanIds(conf, files);
+
+  if (!result.allIds.length) {
+    log.success('未发现任何国际化 id，无需校验');
+    return;
+  }
+
+  printResult(result, files);
+
+  if (result.missing.length) {
     if (exitOnMissing) {
       process.exit(1);
     }
@@ -101,4 +108,78 @@ async function verify({ exitOnMissing = true } = {}) {
   }
 }
 
+/**
+ * verifyFix: 将孤立 id 对应的 intl 调用降级回字符串字面量（downgrade 策略）
+ *
+ * 形态 A  intl.get('orphan-id').d('默认文案')  →  '默认文案'
+ * 形态 B  intl.get('orphan-id')               →  无法自动恢复，仅打印警告 + 行号
+ *
+ * 修复完成后重新扫描，确认无残留孤立 id。
+ *
+ * 用法：
+ *   chaoswise-intl verify fix
+ */
+async function verifyFix() {
+  log.info('孤立词条降级修复中...');
+
+  const conf = getConf();
+  const files = targetOutputFiles(conf);
+
+  if (!files.length) {
+    log.warnToLog('未找到需要扫描的文件，请检查 output 配置');
+    return;
+  }
+
+  // ── Step 1: 扫描，找出孤立 id ────────────────────────────────────────────
+  const { missing, allIds } = scanIds(conf, files);
+
+  if (!allIds.length) {
+    log.success('未发现任何国际化 id，无需处理');
+    return;
+  }
+
+  if (!missing.length) {
+    log.success('没有孤立 id，无需修复');
+    return;
+  }
+
+  log.info(`共 ${missing.length} 个孤立 id，开始降级处理...`);
+  missing.forEach((id) => log.warnToLog(`  - ${id}`));
+  console.log('');
+
+  // ── Step 2: 执行 downgrade AST 变换（写回文件）────────────────────────────
+  const missingIdSet = new Set(missing);
+  const noDefaultIds = []; // 形态B：无法自动恢复的裸 id
+
+  // transformAst 的 replaceWords 参数传入非空对象才触发写文件，
+  // downgrade visitor 通过 returns.missingIdSet / noDefaultIds 通信
+  transformAst('downgrade', files, conf, missingIdSet, noDefaultIds);
+
+  // ── Step 3: 打印形态 B 警告 ──────────────────────────────────────────────
+  if (noDefaultIds.length) {
+    console.log('');
+    log.warnToLog(`⚠ ${noDefaultIds.length} 处孤立 id 没有 .d() 默认文案，无法自动恢复，需手动处理：`);
+    noDefaultIds.forEach(({ id, loc }) => {
+      const locStr = loc ? `  (行 ${loc.start.line}，列 ${loc.start.column + 1})` : '';
+      log.warnToLog(`    ${id}${locStr}`);
+    });
+  }
+
+  // ── Step 4: 重新扫描，确认修复结果 ──────────────────────────────────────
+  console.log('');
+  log.info('修复完成，重新扫描验证...');
+  const after = scanIds(conf, files);
+  printResult(after, files);
+
+  if (!after.missing.length) {
+    console.log('');
+    log.success('★★★ 孤立 id 已全部降级，请执行 chaoswise-intl collect 重新国际化 ★★★');
+  } else {
+    console.log('');
+    log.error(`仍有 ${after.missing.length} 个孤立 id 未能自动修复（均为形态 B），请手动处理后重试`);
+    process.exit(1);
+  }
+}
+
 module.exports = verify;
+module.exports.fix = verifyFix;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chaoswise/intl",
-  "version": "3.1.1",
+  "version": "3.1.3",
   "author": "cloudwiser",
   "description": "intl",
   "main": "lib/index.js",