20261007220117

code/g3soft-libs/pnpm-workspace.yaml

@@ -0,0 +1,30 @@
+packages:
+  - packages/*
+  - docs
+
+# 统一 vue / typescript 版本：各包写 "vue": "catalog:"，避免多版本漂移。
+catalog:
+  vue: ^3.5.41
+  typescript: ^5.9.0
+
+# pnpm 11 的构建脚本白名单（map 形式；v10 的 onlyBuiltDependencies 数组写法在 v11 已失效）。
+#   better-sqlite3 —— Docus 全文搜索（FTS5）依赖的原生模块，必须放行才能下载/编译二进制
+#   vue-demi       —— vue-docgen-api 的传递依赖，安装时要跑脚本切换 Vue 版本 shim
+#   esbuild        —— Nuxt / Vite 底层
+allowBuilds:
+  esbuild: true
+  better-sqlite3: true
+  vue-demi: true
+
+# 依赖严格隔离（不开启 shamefully-hoist / nodeLinker: hoisted）。
+#
+# 重要：docs 包把 nuxt 精确锁在 4.4.8，不要放宽到 ^4.4.8 或升级到 4.5+。
+# 原因见下表（@nuxt/vite-builder 是决定实际 Vite 版本的那个包）：
+#     4.4.8  → vite ^7.3.3   （Rollup 引擎，可用）
+#     4.5.0  → vite ^8.1.4   （Rolldown）
+#     4.6.0  → vite ^8.3.2   （Rolldown）
+# Vite 8 换成 Rolldown 后，在 Windows 下无法解析 Nitro 生成的
+# "file:///D:/..." 虚拟模块 import，会把 #nitro-internal-virtual/* 误判为外部依赖，
+# 导致 Nuxt 的 internal/manifest 与 internal/precomputed 都拿不到值，页面一律 500
+# （报错：Either manifest or precomputed data must be provided）。
+# Docus 官方 starter 声明的正是 nuxt ^4.4.8，所以锁 4.4.8 与 Docus 完全兼容。