create-bubbles 0.1.26 → 0.1.28

package/template-vp-monorepo-react-nestjs/.spaces/04./347/225/214/351/235/242/344/270/216/344/270/273/351/242/230//345/233/275/351/231/205/345/214/226//346/265/213/350/257/225/350/257/201/346/215/256//345/214/205/345/217/221/345/270/203//346/243/200/346/237/245/347/273/223/346/236/234.json

@@ -0,0 +1,339 @@
+{
+  "status": "验证记录",
+  "date": "2026-10-09",
+  "environment": {
+    "node": "v24.21.0",
+    "platform": "win32",
+    "react": "19.3.0",
+    "reactDom": "19.3.0",
+    "vue": "3.5.42",
+    "dependencyResolution": {
+      "appRequireBase": "C:\\malei\\stu\\bubbles\\packages\\create-bubbles\\template-vp-monorepo-react-nestjs\\apps\\web\\package.json",
+      "vueRequireBase": "C:\\malei\\stu\\bubbles\\packages\\create-bubbles\\template-vp-monorepo-react-nestjs\\packages\\i18n\\vue\\package.json",
+      "happyDom": "C:\\malei\\stu\\bubbles\\packages\\create-bubbles\\template-vp-monorepo-react-nestjs\\node_modules\\.pnpm\\happy-dom@20.14.5\\node_modules\\happy-dom\\lib\\index.js",
+      "react": "C:\\malei\\stu\\bubbles\\packages\\create-bubbles\\template-vp-monorepo-react-nestjs\\node_modules\\.pnpm\\react@19.3.0\\node_modules\\react\\index.js",
+      "reactDomServer": "C:\\malei\\stu\\bubbles\\packages\\create-bubbles\\template-vp-monorepo-react-nestjs\\node_modules\\.pnpm\\react-dom@19.3.0_react@19.3.0\\node_modules\\react-dom\\server.node.js",
+      "reactDomClient": "C:\\malei\\stu\\bubbles\\packages\\create-bubbles\\template-vp-monorepo-react-nestjs\\node_modules\\.pnpm\\react-dom@19.3.0_react@19.3.0\\node_modules\\react-dom\\client.js",
+      "vue": "C:\\malei\\stu\\bubbles\\packages\\create-bubbles\\template-vp-monorepo-react-nestjs\\node_modules\\.pnpm\\vue@3.5.42_typescript@6.0.3\\node_modules\\vue\\index.js"
+    },
+    "pnpm": "12.10.1",
+    "vp": "1.1.0",
+    "vitePlus": "0.3.1"
+  },
+  "checks": [
+    {
+      "command": "vp run --filter '@bubblesjs/i18n-*' build",
+      "exitCode": 0,
+      "result": "四包构建成功；React 因源码变化重新构建，其余三个包命中任务缓存",
+      "rebuiltPackages": ["react"],
+      "cachedPackages": ["core", "vue", "cli"]
+    },
+    {
+      "command": "vp test run",
+      "workingDirectory": "packages/i18n/cli",
+      "exitCode": 0,
+      "testFiles": 6,
+      "tests": 71,
+      "note": "vp run 缓存通过后另执行包内测试确认",
+      "evidence": "../cli-扫描边界/当前复验.json"
+    },
+    {
+      "command": "vp check packages/i18n",
+      "exitCode": 1,
+      "output": "packages/i18n/cli/docs/excel-sync-plan.md (790ms)\npackages/i18n/cli/package.json (0ms)\npackages/i18n/cli/src/cli.ts (0ms)\npackages/i18n/cli/src/command.ts (1ms)\npackages/i18n/cli/src/config.ts (0ms)\npackages/i18n/cli/src/files.ts (0ms)\npackages/i18n/cli/src/index.ts (0ms)\npackages/i18n/cli/src/load-config.ts (0ms)\npackages/i18n/cli/src/report.ts (0ms)\npackages/i18n/cli/src/sync.ts (1ms)\npackages/i18n/cli/test/config.test.ts (0ms)\npackages/i18n/cli/test/load-config.test.ts (1ms)\npackages/i18n/cli/test/report.test.ts (0ms)\npackages/i18n/cli/test/sync.test.ts (0ms)\npackages/i18n/cli/test/temporary-directory.ts (0ms)\npackages/i18n/cli/tsconfig.json (1ms)\npackages/i18n/cli/vite.config.ts (1ms)\npackages/i18n/core/package.json (0ms)\npackages/i18n/core/src/format.ts (1ms)\npackages/i18n/core/src/i18n.ts (1ms)\npackages/i18n/core/src/index.ts (0ms)\npackages/i18n/core/src/storage.ts (1ms)\npackages/i18n/core/src/store.ts (1ms)\npackages/i18n/core/src/types.ts (0ms)\npackages/i18n/core/tsconfig.json (0ms)\npackages/i18n/core/vite.config.ts (1ms)\npackages/i18n/react/package.json (0ms)\npackages/i18n/react/src/index.tsx (0ms)\npackages/i18n/react/src/use-store.ts (0ms)\npackages/i18n/react/tsconfig.json (0ms)\npackages/i18n/react/vite.config.ts (0ms)\npackages/i18n/vue/package.json (0ms)\npackages/i18n/vue/src/index.ts (1ms)\npackages/i18n/vue/src/use-store.ts (0ms)\npackages/i18n/vue/tsconfig.json (0ms)\nerror: Formatting issues found\npackages/i18n/vue/vite.config.ts (0ms)\n\nFound formatting issues in 36 files (944ms, 24 threads). Run `vp check --fix` to fix them."
+    },
+    {
+      "command": "vp run --filter web test --run test/i18n-locale.spec.ts",
+      "exitCode": 0,
+      "output": "~/apps/web$ vp test --run test/i18n-locale.spec.ts\n\n    mode: test\n    VITE_PORT: 9999\n    VITE_API_AFFIX: /api\n    VITE_API_URL: undefined\n    \n\n RUN  v4.1.11 C:/malei/stu/bubbles/packages/create-bubbles/template-vp-monorepo-react-nestjs/apps/web\n\n ✓ test/i18n-locale.spec.ts (2 tests) 2ms\n\n Test Files  1 passed (1)\n      Tests  2 passed (2)\n   Start at  14:03:56\n   Duration  5.28s (transform 33ms, setup 0ms, import 5.11s, tests 2ms, environment 0ms)\n\n\n---\nvp run: web#test not cached because it modified its input. (Run `vp run --last-details` for full details)"
+    },
+    {
+      "command": "vp check --no-fmt packages/i18n",
+      "exitCode": 1,
+      "output": "x typescript(TS2584): Cannot find name 'console'. Do you need to change your target library? Try changing the 'lib' compiler option to include 'dom'.\n    ,-[packages/i18n/core/src/i18n.ts:41:11]\n 40 |         } catch (error) {\n 41 |           console.warn(`Failed to load locale file for ${nextLocale}:`, error)\n    :           ^^^^^^^\n 42 |         }\n    `----\n\n  x typescript(TS2584): Cannot find name 'console'. Do you need to change your target library? Try changing the 'lib' compiler option to include 'dom'.\n    ,-[packages/i18n/core/src/i18n.ts:74:5]\n 73 |   } catch (error) {\n 74 |     console.warn(`Failed to load locale file for ${locale}:`, error)\n    :     ^^^^^^^\n 75 |   }\nerror: Lint or type issues found\n    `----\n\nFound 2 errors and 0 warnings in 30 files (1.2s, 24 threads)"
+    },
+    {
+      "command": "vp check packages/i18n/react/src/use-store.ts",
+      "exitCode": 1,
+      "output": "packages/i18n/react/src/use-store.ts (0ms)\nerror: Formatting issues found\n\nFound formatting issues in 1 file (144ms, 24 threads). Run `vp check --fix` to fix them."
+    },
+    {
+      "command": "vp check --no-fmt packages/i18n/react/src/use-store.ts",
+      "exitCode": 0,
+      "output": "pass: Found no warnings, lint errors, or type errors in 1 file (329ms, 24 threads)"
+    },
+    {
+      "command": "node .spaces/04.界面与主题/国际化/工具/运行时发布检查.mjs",
+      "exitCode": 0,
+      "result": "具名和内联 React 对象 selector 各渲染两次、DOM 正确更新，无警告或异常；其他问题见运行时证据",
+      "evidence": "../运行时发布检查.json"
+    }
+  ],
+  "packageDryRuns": [
+    {
+      "packageName": "core",
+      "command": "pnpm pack --dry-run --json",
+      "exitCode": 0,
+      "result": {
+        "name": "@bubblesjs/i18n-core",
+        "version": "0.0.0",
+        "filename": "bubblesjs-i18n-core-0.0.0.tgz",
+        "files": [
+          {
+            "path": "package.json"
+          },
+          {
+            "path": "src/format.ts"
+          },
+          {
+            "path": "src/i18n.ts"
+          },
+          {
+            "path": "src/index.ts"
+          },
+          {
+            "path": "src/storage.ts"
+          },
+          {
+            "path": "src/store.ts"
+          },
+          {
+            "path": "src/types.ts"
+          },
+          {
+            "path": "tsconfig.json"
+          },
+          {
+            "path": "vite.config.ts"
+          }
+        ]
+      }
+    },
+    {
+      "packageName": "react",
+      "command": "pnpm pack --dry-run --json",
+      "exitCode": 0,
+      "result": {
+        "name": "@bubblesjs/i18n-react",
+        "version": "0.0.0",
+        "filename": "bubblesjs-i18n-react-0.0.0.tgz",
+        "files": [
+          {
+            "path": "package.json"
+          },
+          {
+            "path": "src/index.tsx"
+          },
+          {
+            "path": "src/use-store.ts"
+          },
+          {
+            "path": "tsconfig.json"
+          },
+          {
+            "path": "vite.config.ts"
+          }
+        ]
+      }
+    },
+    {
+      "packageName": "vue",
+      "command": "pnpm pack --dry-run --json",
+      "exitCode": 0,
+      "result": {
+        "name": "@bubblesjs/i18n-vue",
+        "version": "0.0.1",
+        "filename": "bubblesjs-i18n-vue-0.0.1.tgz",
+        "files": [
+          {
+            "path": "package.json"
+          },
+          {
+            "path": "src/index.ts"
+          },
+          {
+            "path": "src/use-store.ts"
+          },
+          {
+            "path": "tsconfig.json"
+          },
+          {
+            "path": "vite.config.ts"
+          }
+        ]
+      }
+    },
+    {
+      "packageName": "cli",
+      "command": "pnpm pack --dry-run --json",
+      "exitCode": 1,
+      "result": {
+        "error": {
+          "code": "ERR_PNPM_BIN_CRLF",
+          "message": "The bin file \"src/cli.ts\" has a shebang line ending with CRLF (\\r\\n)."
+        }
+      }
+    }
+  ],
+  "actualTarballs": [
+    {
+      "archive": "bubblesjs-i18n-core-0.0.0.tgz",
+      "sha256": "35AE07DFAA3C880AC36E01819E8DF58A58F9F913FB574744B1DF8DFB102E63FF",
+      "hasDist": false,
+      "private": true,
+      "entry": "./src/index.ts"
+    },
+    {
+      "archive": "bubblesjs-i18n-react-0.0.0.tgz",
+      "sha256": "E2040112B5E6B4693849DE438F029B64A7E6123EA15B47FA90EC1A29863AB27C",
+      "hasDist": false,
+      "private": true,
+      "entry": "./src/index.tsx"
+    },
+    {
+      "archive": "bubblesjs-i18n-vue-0.0.1.tgz",
+      "sha256": "E7D406D0254D645645E1B6FA823972394558FEBB59D3D9112A53D408C3CC5EAA",
+      "hasDist": false,
+      "private": true,
+      "entry": "./src/index.ts"
+    }
+  ],
+  "packageEvidence": "./产物复验.json",
+  "externalImports": [
+    {
+      "package": "@bubblesjs/i18n-core",
+      "command": "node --input-type=module --eval <dynamic import> @bubblesjs/i18n-core",
+      "exitCode": 1,
+      "result": {
+        "ok": false,
+        "code": "ERR_UNSUPPORTED_NODE_MODULES_TYPE_STRIPPING",
+        "message": "Stripping types is currently unsupported for files under node_modules, for \"file:///C:/Users/Administrator/AppData/Local/Temp/i18n-pack-consumer-4d1a55e25578428986678bb5029b4011/node_modules/@bubblesjs/i18n-core/src/index.ts\""
+      }
+    },
+    {
+      "package": "@bubblesjs/i18n-react",
+      "command": "node --input-type=module --eval <dynamic import> @bubblesjs/i18n-react",
+      "exitCode": 1,
+      "result": {
+        "ok": false,
+        "code": "ERR_UNKNOWN_FILE_EXTENSION",
+        "message": "Unknown file extension \".tsx\" for C:\\Users\\Administrator\\AppData\\Local\\Temp\\i18n-pack-consumer-4d1a55e25578428986678bb5029b4011\\node_modules\\@bubblesjs\\i18n-react\\src\\index.tsx"
+      }
+    },
+    {
+      "package": "@bubblesjs/i18n-vue",
+      "command": "node --input-type=module --eval <dynamic import> @bubblesjs/i18n-vue",
+      "exitCode": 1,
+      "result": {
+        "ok": false,
+        "code": "ERR_UNSUPPORTED_NODE_MODULES_TYPE_STRIPPING",
+        "message": "Stripping types is currently unsupported for files under node_modules, for \"file:///C:/Users/Administrator/AppData/Local/Temp/i18n-pack-consumer-4d1a55e25578428986678bb5029b4011/node_modules/@bubblesjs/i18n-vue/src/index.ts\""
+      }
+    }
+  ],
+  "runtimeChecks": {
+    "languageSwitchRace": {
+      "requestOrder": ["slow", "latest"],
+      "completionOrder": ["latest", "slow"],
+      "expectedLocale": "latest",
+      "actualLocale": "slow",
+      "actualTranslation": "Stale",
+      "problemReproduced": true
+    },
+    "instanceIsolation": {
+      "first": {
+        "locale": "en_US",
+        "translation": "Hello"
+      },
+      "second": {
+        "locale": "zh_CN",
+        "translation": "独立实例"
+      },
+      "passed": true
+    },
+    "prototypeMessageKeys": {
+      "values": [
+        {
+          "key": "constructor",
+          "expected": "constructor",
+          "actualType": "function",
+          "returnedString": false
+        },
+        {
+          "key": "toString",
+          "expected": "toString",
+          "actualType": "function",
+          "returnedString": false
+        }
+      ],
+      "interpolationError": {
+        "name": "TypeError",
+        "message": "message.replace is not a function"
+      },
+      "problemReproduced": true
+    },
+    "prototypeInterpolationKey": {
+      "expected": "Value: {toString}",
+      "actual": "Value: function toString() { [native code] }",
+      "problemReproduced": true
+    },
+    "shallowObjectKeys": {
+      "inputDescription": "{ first: undefined } 与 { second: undefined }",
+      "expected": false,
+      "actual": true,
+      "problemReproduced": true
+    },
+    "reactSSR": {
+      "expected": "完成服务端渲染",
+      "error": {
+        "name": "Error",
+        "message": "Missing getServerSnapshot, which is required for server-rendered content. Will revert to client rendering."
+      },
+      "problemReproduced": true
+    },
+    "reactObjectSelector": {
+      "expected": "稳定渲染，状态更新后 DOM 从 en_US 变为 zh_CN",
+      "selectorKind": "named",
+      "stateUpdates": 1,
+      "before": "en_US",
+      "after": "zh_CN",
+      "renderCount": 2,
+      "warnings": [],
+      "error": null,
+      "problemReproduced": false
+    },
+    "reactInlineObjectSelector": {
+      "expected": "稳定渲染，状态更新后 DOM 从 en_US 变为 zh_CN",
+      "selectorKind": "inline",
+      "stateUpdates": 1,
+      "before": "en_US",
+      "after": "zh_CN",
+      "renderCount": 2,
+      "warnings": [],
+      "error": null,
+      "problemReproduced": false
+    },
+    "vueProviderStoreReplacement": {
+      "before": "first",
+      "expectedAfter": "second",
+      "actualAfter": "first",
+      "problemReproduced": true
+    }
+  },
+  "supplementalReactStrictMode": {
+    "method": "补充只读脚本，使用当前 dist 及真实 React DOM；脚本未归档",
+    "inlineObjectSelector": true,
+    "renderCounts": [2, 4, 6, 8],
+    "domResults": ["first:1", "first:2", "updated:2", "second:3"],
+    "warnings": [],
+    "error": null
+  },
+  "historicalInstall": {
+    "date": "2026-10-08",
+    "command": "vp install --frozen-lockfile",
+    "exitCode": 0,
+    "note": "首次评估安装成功、锁文件未变化；本轮未重新安装"
+  },
+  "conclusion": "当前版本仍不宜直接发布；React 快照缓存及 CLI 边界注释已通过复验，打包、入口、core 类型错误及其他运行时缺陷仍需处理。",
+  "note": "未修改业务源码或 manifest，未执行远端发布。"
+}

package/template-vp-monorepo-react-nestjs/.spaces/04./347/225/214/351/235/242/344/270/216/344/270/273/351/242/230//345/233/275/351/231/205/345/214/226//346/265/213/350/257/225/350/257/201/346/215/256//350/277/220/350/241/214/346/227/266/345/217/221/345/270/203/346/243/200/346/237/245.json

@@ -0,0 +1,131 @@
+{
+  "assessmentDate": "2026-10-09",
+  "executedAtUtc": "2026-10-09T06:03:55.731Z",
+  "command": "node .spaces/04.界面与主题/国际化/工具/运行时发布检查.mjs",
+  "method": "直接导入当前 dist；使用真实 React SSR、React DOM、Vue 渲染器与 happy-dom；未安装依赖、未构建、未修改业务代码。",
+  "environment": {
+    "node": "v24.21.0",
+    "platform": "win32",
+    "react": "19.3.0",
+    "reactDom": "19.3.0",
+    "vue": "3.5.42",
+    "dependencyResolution": {
+      "appRequireBase": "C:\\malei\\stu\\bubbles\\packages\\create-bubbles\\template-vp-monorepo-react-nestjs\\apps\\web\\package.json",
+      "vueRequireBase": "C:\\malei\\stu\\bubbles\\packages\\create-bubbles\\template-vp-monorepo-react-nestjs\\packages\\i18n\\vue\\package.json",
+      "happyDom": "C:\\malei\\stu\\bubbles\\packages\\create-bubbles\\template-vp-monorepo-react-nestjs\\node_modules\\.pnpm\\happy-dom@20.14.5\\node_modules\\happy-dom\\lib\\index.js",
+      "react": "C:\\malei\\stu\\bubbles\\packages\\create-bubbles\\template-vp-monorepo-react-nestjs\\node_modules\\.pnpm\\react@19.3.0\\node_modules\\react\\index.js",
+      "reactDomServer": "C:\\malei\\stu\\bubbles\\packages\\create-bubbles\\template-vp-monorepo-react-nestjs\\node_modules\\.pnpm\\react-dom@19.3.0_react@19.3.0\\node_modules\\react-dom\\server.node.js",
+      "reactDomClient": "C:\\malei\\stu\\bubbles\\packages\\create-bubbles\\template-vp-monorepo-react-nestjs\\node_modules\\.pnpm\\react-dom@19.3.0_react@19.3.0\\node_modules\\react-dom\\client.js",
+      "vue": "C:\\malei\\stu\\bubbles\\packages\\create-bubbles\\template-vp-monorepo-react-nestjs\\node_modules\\.pnpm\\vue@3.5.42_typescript@6.0.3\\node_modules\\vue\\index.js"
+    }
+  },
+  "artifacts": {
+    "core": {
+      "path": "C:\\malei\\stu\\bubbles\\packages\\create-bubbles\\template-vp-monorepo-react-nestjs\\packages\\i18n\\core\\dist\\index.js",
+      "sha256": "35ab1d08457977da247fa8a364eaa4725bb09698b8165dee82073f935621b537"
+    },
+    "react": {
+      "path": "C:\\malei\\stu\\bubbles\\packages\\create-bubbles\\template-vp-monorepo-react-nestjs\\packages\\i18n\\react\\dist\\index.js",
+      "sha256": "2264549c0f9e3200f6b495be3f8ddec0d7718433b8f211c4b7180610212796cf"
+    },
+    "vue": {
+      "path": "C:\\malei\\stu\\bubbles\\packages\\create-bubbles\\template-vp-monorepo-react-nestjs\\packages\\i18n\\vue\\dist\\index.js",
+      "sha256": "00ce1e688be4bd99c52fb0da93cce178cb172cb929f25c3796648e021db256f1"
+    }
+  },
+  "checks": {
+    "languageSwitchRace": {
+      "requestOrder": [
+        "slow",
+        "latest"
+      ],
+      "completionOrder": [
+        "latest",
+        "slow"
+      ],
+      "expectedLocale": "latest",
+      "actualLocale": "slow",
+      "actualTranslation": "Stale",
+      "problemReproduced": true
+    },
+    "instanceIsolation": {
+      "first": {
+        "locale": "en_US",
+        "translation": "Hello"
+      },
+      "second": {
+        "locale": "zh_CN",
+        "translation": "独立实例"
+      },
+      "passed": true
+    },
+    "prototypeMessageKeys": {
+      "values": [
+        {
+          "key": "constructor",
+          "expected": "constructor",
+          "actualType": "function",
+          "returnedString": false
+        },
+        {
+          "key": "toString",
+          "expected": "toString",
+          "actualType": "function",
+          "returnedString": false
+        }
+      ],
+      "interpolationError": {
+        "name": "TypeError",
+        "message": "message.replace is not a function"
+      },
+      "problemReproduced": true
+    },
+    "prototypeInterpolationKey": {
+      "expected": "Value: {toString}",
+      "actual": "Value: function toString() { [native code] }",
+      "problemReproduced": true
+    },
+    "shallowObjectKeys": {
+      "inputDescription": "{ first: undefined } 与 { second: undefined }",
+      "expected": false,
+      "actual": true,
+      "problemReproduced": true
+    },
+    "reactSSR": {
+      "expected": "完成服务端渲染",
+      "error": {
+        "name": "Error",
+        "message": "Missing getServerSnapshot, which is required for server-rendered content. Will revert to client rendering."
+      },
+      "problemReproduced": true
+    },
+    "reactObjectSelector": {
+      "expected": "稳定渲染，状态更新后 DOM 从 en_US 变为 zh_CN",
+      "selectorKind": "named",
+      "stateUpdates": 1,
+      "before": "en_US",
+      "after": "zh_CN",
+      "renderCount": 2,
+      "warnings": [],
+      "error": null,
+      "problemReproduced": false
+    },
+    "reactInlineObjectSelector": {
+      "expected": "稳定渲染，状态更新后 DOM 从 en_US 变为 zh_CN",
+      "selectorKind": "inline",
+      "stateUpdates": 1,
+      "before": "en_US",
+      "after": "zh_CN",
+      "renderCount": 2,
+      "warnings": [],
+      "error": null,
+      "problemReproduced": false
+    },
+    "vueProviderStoreReplacement": {
+      "before": "first",
+      "expectedAfter": "second",
+      "actualAfter": "first",
+      "problemReproduced": true
+    }
+  }
+}

package/template-vp-monorepo-react-nestjs/.spaces/04./347/225/214/351/235/242/344/270/216/344/270/273/351/242/230//345/233/275/351/231/205/345/214/226//350/256/276/350/256/241/346/226/271/346/241/210.md

@@ -0,0 +1,37 @@
+# 前端国际化设计方案
+
+## 统一状态
+
+`@bubblesjs/i18n-core` store 是唯一语言状态源。`apps/web/src/i18n/config.ts` 集中维护应用 locale 及其适配标识，`ui-locale.ts` 将应用 locale 映射为：
+
+- antd 的 `Locale` 对象；
+- Pro Components 的 `IntlType`（`zhCNIntl` / `enUSIntl`）；
+- Day.js locale 标识（`zh-cn` / `en`）；
+- `<html lang>` 标识。
+
+## 渲染与副作用
+
+`App.tsx` 在渲染时将 antd locale 和 Pro `intl` 传入 Provider；在 locale 变化后的 effect 中设置 Day.js 全局 locale 和 `<html lang>`。这样静态组件配置会随 React 重新渲染，日期库的全局副作用也只在语言变化时执行。
+
+## 扩展约束
+
+新增语言时必须同时补充词条加载器、`APP_LOCALE_ADAPTERS`、antd locale 包、Pro Components intl 以及 Day.js locale 导入，并执行 `pnpm i18n:check` 与前端构建。
+
+## CLI 调用边界注释
+
+状态：已实现，依据 [需求文档](./需求文档.md) 的 CLI 调用边界注释支持要求；执行证据见 [测试报告](./测试报告.md)。
+
+扫描器在调用名后、左括号后和解析出的静态字符串后使用同一个内部方法跳过空白、`//` 行注释及 `/* ... */` 块注释。行注释以 LF、CR、U+2028 或 U+2029 结束，未闭合块注释视为未找到有效后续 token。原始源码不做预处理或删除，因此词条正文、转义和源码行列位置保持精确。
+
+字符串解析仍由原有逻辑处理；边界注释之后只接受既有引号、逗号或右括号，不放宽动态表达式限制。扫描器仍按文本扫描全文，保持注释或普通字符串内完整调用也会被提取的既有约定。
+
+## React selector 快照缓存
+
+状态：2026-10-09 验证通过。React hook 使用 `useMemo([store, selector])` 创建独立快照闭包，对同一 state 引用复用 selector 结果。具名和内联对象 selector 均稳定渲染，state 更新后 DOM 正确变化；这是快照稳定性修复，尚未提供跨 state 的选择结果相等比较，也未增加 SSR 快照。完整发布结论仍以 [发布评估](./发布评估.md) 为准。
+
+## 变更记录
+
+| 日期       | 摘要                                                      | 影响范围             | 原因                                    |
+| ---------- | --------------------------------------------------------- | -------------------- | --------------------------------------- |
+| 2026-10-08 | 实现调用边界跳过空白与注释，并支持 Unicode 行终止符的定位 | CLI 扫描器及源码位置 | 防止合法静态调用漏提取及 clean 误删译文 |
+| 2026-10-09 | 记录 React selector 快照缓存与当前版本发布复验范围        | React hook、发布检查 | 用户修改后重新检查发布准备情况          |

package/template-vp-monorepo-react-nestjs/.spaces/04./347/225/214/351/235/242/344/270/216/344/270/273/351/242/230//345/233/275/351/231/205/345/214/226//351/234/200/346/261/202/346/226/207/346/241/243.md

@@ -0,0 +1,42 @@
+# 前端国际化需求
+
+## 目标
+
+应用语言切换必须由同一份 locale 状态驱动，确保业务词条、Ant Design、Ant Design Pro Components、Day.js 以及文档语言属性同步变化。
+
+## 范围
+
+- 当前支持 `zh_CN`（简体中文）和 `en_US`（English）。
+- 切换结果继续由现有 i18n store 持久化。
+- Ant Design 组件文案、Pro Components 内置文案和 Day.js 日期/相对时间格式必须与当前语言一致。
+- 浏览器 `<html lang>` 必须同步更新。
+
+## 验收标准
+
+1. 初始语言、持久化语言和运行时切换均使用同一 locale 状态。
+2. 切换到英文后，antd、Pro Components、Day.js 和 `<html lang>` 均使用英文配置；切回中文后恢复中文配置。
+3. 新增语言时只需扩展集中式映射，并能明确补充对应组件库和 Day.js locale。
+
+## 独立包发布评估
+
+- 状态：2026-10-09 复验完成；CLI 注释提取及 React 对象 selector 缓存均已验证通过，四包构建成功，但发布入口、实际 tarball、CLI 打包、core 类型检查及剩余运行时缺陷仍阻止直接发布。此次仅检查发布准备情况，未修改业务实现或执行发布。
+- 范围：`packages/i18n/` 下的 core、React、Vue、CLI 四个包。
+- 验收：检查包边界、公开入口、构建与类型产物、依赖转换、包外消费及已有测试，区分发布阻塞与后续增强建议。
+- 评估结果与执行证据归档于 [发布评估](./发布评估.md)。
+
+## CLI 调用边界注释支持
+
+- 状态：已实现；CLI 71 个测试、构建及修改文件的格式、lint、类型检查通过。
+- 范围：保留文本扫描方式，在调用名与左括号之间、左括号与静态字符串之间、静态字符串与逗号或右括号之间，将空白、行注释和块注释作为可跳过的分隔内容。
+- 字符串内部的注释符号属于词条正文，必须原样保留；注释后仍是动态表达式时继续忽略。
+- 保留既有行为：注释或普通字符串内出现完整静态 `tr()` 调用时仍会提取。
+- 验收：带边界注释的静态调用能被提取；未闭合块注释不匹配；行列位置正确；`sync --clean` 保留对应已有翻译，只删除真正未使用的词条。
+
+## 变更记录
+
+| 日期       | 变更摘要                                                                   | 影响范围                           | 原因                                       |
+| ---------- | -------------------------------------------------------------------------- | ---------------------------------- | ------------------------------------------ |
+| 2026-09-19 | 明确应用 locale 必须同时驱动 antd、Pro Components、Day.js 与 `<html lang>` | React Web 全局入口与 locale 配置   | 补充国际化联动要求                         |
+| 2026-10-08 | 增加 i18n 独立包发布可行性评估范围                                         | i18n 四个包的发布准备情况          | 检查当前方案是否可以作为包发布；本次仅评估 |
+| 2026-10-08 | 补充 CLI 调用边界注释支持与清理回归验收                                    | CLI 扫描器、同步清理、扫描规则说明 | 修复合法静态调用带注释时漏提取的问题       |
+| 2026-10-09 | 重新验证当前版本的独立发布准备情况，重点复验 React selector 快照缓存       | i18n 四包、发布评估与执行证据      | 用户修改后要求再次确认能否发布             |