@icebreakers/monorepo 1.2.0 → 1.2.2

package/templates/apps/server/wrangler.jsonc

@@ -0,0 +1,18 @@
+{
+  "$schema": "./node_modules/wrangler/config-schema.json",
+  "name": "monorepo-service",
+  "compatibility_date": "2025-09-13",
+  "main": "./src/fetch-entry.ts",
+  "dev": {
+    "port": 8787
+  },
+  "routes": [
+    {
+      "custom_domain": true,
+      "pattern": "sls.monorepo.icebreaker.top"
+    }
+  ],
+  "observability": {
+    "enabled": true
+  }
+}

package/templates/apps/website/.vitepress/config.ts

@@ -0,0 +1,93 @@
+import Tailwindcss from '@tailwindcss/vite'
+import { defineConfig } from 'vitepress'
+import { withMermaid } from 'vitepress-plugin-mermaid'
+// https://vitepress.dev/reference/site-config
+export default withMermaid(defineConfig({
+  outDir: '../../dist',
+  title: 'icebreaker\'s monorepo',
+  description: 'icebreaker\'s monorepo. upgrade your monorepo',
+  themeConfig: {
+    // https://vitepress.dev/reference/default-theme-config
+    nav: [
+      { text: '使用手册', link: '/' },
+      { text: '一些思考', link: '/thinking' },
+    ],
+    socialLinks: [
+      { icon: 'github', link: 'https://github.com/sonofmagic/monorepo-template' },
+    ],
+    outline: {
+      label: '目录',
+      level: [2, 3],
+    },
+    logo: '/logo.jpg',
+    sidebar: {
+      '/': [
+        { text: '使用手册', link: '/' },
+        { text: '一些思考', link: 'thinking' },
+        {
+          text: 'npm 发包',
+          base: '/why/',
+          items: [
+            { text: '如何复用 js 代码', link: '/how-to-reuse-js-code' },
+            { text: 'JS 文件的各种后缀', link: '/js-cjs-mjs' },
+            { text: 'CJS和ESM关键字/全局变量对比', link: '/js-keywords' },
+            { text: '什么是 npm 包', link: '/what-is-npm-package' },
+            { text: '如何发布 npm 包', link: '/publish-basic-npm-package' },
+            {
+              text: '改进并发布现代 npm 包',
+              link: 'index',
+              base: 'why/modern/',
+              items: [
+                { text: 'package entry points 字段', link: '/package-entry-points' },
+                { text: '添加 DTS', link: '/dts' },
+                { text: 'ESM vs CJS', link: '/esm-vs-cjs' },
+                { text: '使用 TypeScript', link: '/typescript' },
+                { text: '使用打包器', link: '/bundlers' },
+              ],
+            },
+          ],
+        },
+        {
+          text: 'Monorepo',
+          base: '/monorepo/',
+          items: [
+            { text: '为什么往 monorepo 方向演进', link: '/' },
+            { text: '如何管理 monorepo', link: '/manage' },
+            { text: 'monorepo 发包生成变更日志', link: '/publish' },
+          ],
+        },
+        {
+          text: '相关的工具',
+          base: '/tools/',
+          items: [
+            { text: 'pnpm', link: '/pnpm' },
+            { text: 'turborepo', link: '/turborepo' },
+            { text: 'changeset', link: '/changeset' },
+            { text: 'husky', link: '/husky' },
+            { text: 'lint-staged', link: '/lint-staged' },
+            { text: 'renovate', link: '/renovate' },
+          ],
+        },
+      ],
+    },
+    editLink: {
+      pattern: 'https://github.com/sonofmagic/monorepo-template/edit/main/apps/website/:path',
+      text: '为此页提供修改建议',
+    },
+  },
+  vite: {
+    plugins: [
+      // @ts-ignore
+      Tailwindcss(),
+    ],
+    // server: {
+    //   hmr: {
+    //     overlay: false,
+    //   },
+    // },
+  },
+  mermaid: {
+
+  },
+}),
+)

package/templates/apps/website/.vitepress/theme/index.ts

@@ -0,0 +1,4 @@
+import DefaultTheme from 'vitepress/theme'
+import './tailwind.css'
+
+export default DefaultTheme

package/templates/apps/website/.vitepress/theme/tailwind.css

@@ -0,0 +1 @@
+@import 'tailwindcss';

package/templates/apps/website/index.md

@@ -0,0 +1,151 @@
+---
+layout: doc
+---
+
+# icebreaker's monorepo 模板
+
+## 功能特性
+
+- 强大的 `monorepo` 管理 (`pnpm` + `turborepo`)
+- 单元测试框架集成 (`vitest`)
+- 全部都是 `typescript`, 包括 `应用` `类库` 与 `cli` 工具
+- 代码规范与质量 (`eslint` + `@icebreakers/eslint-config` + `@icebreakers/stylelint-config`)
+- `git` 提交规范 (`husky` + `commitlint` + `lint-staged`)
+- `pnpm` `Dockerfile` 部署模板
+- `Github Action` 自动发布 `npm`, `github release` 包 (`changeset`)
+- 配置文件同步升级 `npx @icebreakers/monorepo@latest`
+
+## 如何使用？
+
+首先，访问本模板的 [Github 地址](https://github.com/sonofmagic/monorepo-template)，然后按照一下条件:
+
+- 有 `Github` 账号的，可以登录后，点击右上角的 `Use this template` 按钮
+
+- 没有 `Github` 账号的，可以点击 `Code` 按钮，把这个仓库的源码，或 `clone` 或下载到本地
+
+然后在根目录 (`pnpm-workspace.yaml` 所在的位置) 执行 `pnpm i` 去安装依赖
+
+> 要求 `Nodejs` >= 20，没有 `pnpm` 的，可以使用 `npm i -g pnpm` 来进行安装。
+>
+> 什么! 你不会连 [`Nodejs`](https://nodejs.org/en) 还没安装吧？
+
+## 使用步骤
+
+### 1. 清除不必要的代码
+
+执行 `pnpm script:clean` 命令，可以删去大部分的初始 `repo`，只保留一个 `@icebreakers/unbuild-template` 项目作为发包打包模板。
+
+`clean` 命令执行完成之后，再去执行 `pnpm i` 来更新 `pnpm-lock.yaml`, 并提交 `pnpm-lock.yaml` 文件来锁定 `npm` 包的版本。
+
+### 2. 初始化文件
+
+执行 `pnpm script:init` 命令，这个命令会批量修改你关联的配置文件，并生成一份新的 `README.md`
+
+## 模板包介绍
+
+默认模板被放在根目录的 `packages` 和 `apps` 这 `2` 个目录里面
+
+### packages 目录
+
+- `@icebreakers/tsup-template` - [`tsup`](https://www.npmjs.com/package/tsup) 打包的库模板
+- `@icebreakers/unbuild-template` - [`unbuild`](https://www.npmjs.com/package/unbuild) 打包的库模板
+- `@icebreakers/monorepo` - 本仓库的更新配置服务，可直接根目录执行 `npx @icebreakers/monorepo@latest` 执行远端 `cli` 命令，进行项目依赖升级同步
+- `@icebreakers/vue-lib-template` - [`vue3`](https://vuejs.org/) 组件库模板，使用 `vite` 打包
+
+### apps 目录
+
+- `@icebreakers/cli` - 使用 `typescript` 编写的 `cli` 程序模板
+- `@icebreakers/website` - 文档网站模板，使用 `vitepress` 搭建，也是 [monorepo.icebreaker.top](https://monorepo.icebreaker.top/) 的源代码
+- `@icebreakers/server` - 使用 `hono` 搭建的服务端模板，使用 `typescript` 编写
+- `@icebreakers/client` - `vue` 客户端模板
+
+## 更新包的依赖
+
+在根目录中执行 `pnpm up -rLi` 来进行包的交互式更新，下面是解释:
+
+- `-r` : `recursive` 递归选中所有 `repo`
+- `-L` : `latest` 更新到最新
+- `-i` : `interactive` 交互式
+
+## 配置自动发包
+
+本项目使用 [changesets](https://github.com/changesets/changesets) 进行包的发布和 `changelog` 的生成
+
+> [changesets](https://github.com/changesets/changesets) 的具体使用方式见它的文档
+
+在使用的时候，首先你需要做一些配置：
+
+1. 首先你需要安装 `Github App`: [changeset-bot](https://github.com/apps/changeset-bot)
+
+2. 然后，来到你复制这个模板仓库(`repo`), 上方里的 `Settings` Tab 页面，进行 2 个操作:
+
+### 1. 在 Github 进行 PR 和发包
+
+选择 `Code and automation` > `Actions` > `General`
+
+然后在右侧 `Workflow permissions` 下方选择: `Read and write permissions`
+
+然后选中 `Allow GitHub Actions to create and approve pull requests`
+
+最后，点击下方的保存按钮即可。
+
+这样 `changeset` 就有权限对你进行 `PR` 和代码版本更新了！
+
+### 2. 在 npm 发包
+
+选择 `Security` > `Secrets and variables` > `Actions`
+
+然后在右侧的 `Repository secrets` 设置你的 `NPM_TOKEN` 这个可以在你的 `npmjs.com` 账号中生成获取
+
+(假如你需要单元测试代码覆盖率，你需要设置 `CODECOV_TOKEN`)
+
+## eslint + stylelint 校验
+
+引用到的规则参考 `https://eslint.icebreaker.top/`
+
+[Github 地址](https://github.com/sonofmagic/eslint-config)
+
+## 内置脚本
+
+- `pnpm script:clean` 删去大部分的初始`repo`，只保留一个 `@icebreakers/bar` 项目作为发包打包模板
+- `pnpm script:init` 初始化一些 `package.json` 里的字段
+- `pnpm script:sync` 使用 `cnpm sync` 功能，把本地所有的包，同步到 [`npmmirror`](https://www.npmmirror.com/) 上，需要安装 `cnpm`
+- `pnpm script:mirror` 使用 `cnpm` binary mirror 功能，使用国内二进制下载地址 (使用 vscode 环境变量)
+
+## 创建新的项目
+
+在 `monorepo` 的任意位置，打开命令行，然后执行 `npx monorepo new` 即可进入交互模式创建一个空的类库，
+
+可通过传入 **可选**参数 `path` 进行修改, 比如 `npx monorepo new [path]`, 此时的目录就从 `foo` 变为了 `[path]`
+
+> 命令 `new` 的别名为 `create`, 也可以使用 `npx monorepo create` 来创建新的项目
+
+## 配置同步方式
+
+更新 `@icebreakers/monorepo` 到最新版本，然后
+
+在根目录下执行: `npx monorepo up`
+
+> 假如你想直接从远端获取，可以 `npx @icebreakers/monorepo@latest up`
+
+这个命令会把所有的文件从最新版本，对你本地进行覆盖，你可以从 `git` 暂存区把你不想要的文件剔除
+
+### 参数
+
+`npx monorepo up --raw`
+
+这个命令会从全部文件中去除 `Github` 相关的文件
+
+`npx monorepo up -i`
+
+这个命令会进行命令行选择模式，你可以在这里对想要复制的文件进行筛选
+
+`npx monorepo up -s`
+
+跳过文件的新增，只保留文件的修改
+
+---
+
+当然你可以同时使用这多个命令
+
+`npx monorepo up -i --raw`

package/templates/apps/website/monorepo/index.md

@@ -0,0 +1,68 @@
+# 为什么往 monorepo 方向演进
+
+Node.js 项目的 Git 仓库越来越倾向于采用 **Monorepo（单一代码库）** 的架构，主要原因是 **项目复杂度增加** 和 **团队协作需求提升**。
+
+往 monorepo 方向演进的核心在于，它能够让我们，更好的做代码拆分和依赖关系的管理
+
+## 集中管理多个模块的优势
+
+现代 Node.js 项目通常不再是单体应用，而是由多个模块、服务、包组成，例如：
+
+- 多个 npm 包（如 utils、core、api、cli）
+- 多个微服务（如 auth-service、user-service）
+- Web 与后端共存（如 frontend + backend）
+
+**Monorepo 优点：**
+
+| 特性                   | 说明                                                      |
+| ---------------------- | --------------------------------------------------------- |
+| **统一依赖管理**       | 所有模块共享依赖，减少版本冲突和冗余安装                  |
+| **统一构建与发布流程** | 可以使用工具（如 TurboRepo、Nx、Lerna）管理构建/测试/发布 |
+| **原子性提交**         | 一个提交可以跨多个模块进行变更，方便追踪问题              |
+| **简化跨模块协作**     | 不需要在不同仓库之间切换和发布，仅通过本地引用即可调试    |
+
+## 适配现代工具链的需求
+
+Monorepo 的流行也和一些工具链的成熟有关：
+
+- **Lerna** / **Nx** / **Turborepo**：支持模块依赖分析、并行任务执行、缓存等高级特性
+- **PNPM workspaces** / **Yarn workspaces** / **NPM workspaces**：简化依赖和 workspace 管理
+- **ESBuild、Vite、Babel** 等构建工具对 Monorepo 的支持逐渐增强
+
+## 对大型团队更友好
+
+在大型团队或企业中，Monorepo 可以带来更好的协作体验：
+
+- 易于规范代码风格和测试策略
+- DevOps 部署流程统一（CI/CD 更易维护）
+- 更容易进行全局重构（如重命名公共 API）
+
+## Facebook、Google 等大厂的示范效应
+
+大型公司（如 Google、Facebook、Uber、Airbnb）早期就在使用 Monorepo，逐渐被开源社区效仿：
+
+- React、Angular、NestJS 等大型 Node/TS 项目都采用 Monorepo
+- 社区也贡献了很多相关最佳实践和工具
+
+## 相比 Polyrepo（多个仓库）的问题
+
+| Polyrepo 问题    | 描述                                 |
+| ---------------- | ------------------------------------ |
+| 版本依赖管理复杂 | 多个仓库依赖版本不一致会导致兼容问题 |
+| 跨项目协作成本高 | 修改一个接口需改多个仓库并同步发布   |
+| 重复构建和发布   | 每个项目都要重复设置 CI/CD 流程      |
+| 脚本和工具重复   | 每个仓库需要重复维护脚本、配置等     |
+
+## 非常适合巨石项目拆分
+
+比如一个巨石项目，里面有 `500` 个直接依赖，可以通过把它改造成一个 `monorepo` 的方式，逐步的把依赖和逻辑拆出来，让每个包保持独立的最小化的依赖。
+
+拆分之后，这时候可能父项目最终有 `100` 个直接共享依赖，拆分出 `20` 个子包，每个包里只有 `20` 个依赖了, 这样依赖的可维护性就好很多。
+
+同时这样也方便进行多模块共同开发，和进行单元测试。
+
+假如做个比喻的话，这就像，你把原先拖成一块的项目，拆分成一个一个积木，然后把积木组合起来，这个项目就能跑了。而且其中的任意模块，都是可以单独替换和发包共享的。
+
+## 总结
+
+在项目小的时候，Polyrepo 管理简单清晰，但随着模块增多、团队扩大，**Monorepo 提供了更高效、可维护、标准化的开发体验**，这是它越来越被 Node.js 项目采用的核心原因。

package/templates/apps/website/monorepo/manage.md

@@ -0,0 +1,60 @@
+# 如何管理 monorepo
+
+我使用 `pnpm + turborepo` 来管理 `monorepo` 相较于传统做法（比如多个独立仓库或用 Yarn/NPM 管理 monorepo）有 **明显优势**，从性能、可维护性、协作效率到发布流程都有提升。下面是详细解释：
+
+## 核心优势一览
+
+### 1. **极快的依赖安装（pnpm 的硬链接 + 内容寻址）**
+
+- `pnpm` 使用内容寻址存储，多个项目间共享 node_modules 中的依赖，不重复安装。
+- 安装依赖速度远快于 `npm` / `yarn`，节省磁盘空间。
+
+### 2. **智能任务调度与缓存（turborepo）**
+
+- `turbo` 会缓存上一次的构建输出，**不变的包不会重复构建**，节省大量构建时间。
+- 类似于 Bazel、Nx 等构建系统，但配置简单，专注于 JavaScript/TypeScript 项目。
+
+### 3. **明确的依赖关系管理**
+
+- `pnpm` 强制使用严格的模块隔离，不允许“幽灵依赖”（hoist 下来的间接依赖）。
+- 每个包必须显式声明自己的依赖，减少运行时错误。
+
+### 4. **组件复用 + 原子包发布**
+
+- 各子包可单独开发、测试、构建，也可以发布到 NPM。
+- 例如一个 UI 组件库（`@my/ui`）被多个应用复用，改动只需维护一个位置。
+
+### 5. **团队协作更清晰**
+
+- 多人负责不同 app/package 时，统一 workspace 管理避免重复工作。
+- turbo 的 `--filter` 功能可以只运行特定 app/package 的任务，提高并行效率。
+
+### 6. **支持渐进迁移/扩展**
+
+- 可以从一个项目开始，逐步迁移其他项目到 monorepo。
+- 不强制结构，灵活适配大型或微服务项目。
+
+## 示例：构建时间对比（真实项目）
+
+| 构建系统               | 全量构建时间 | 增量构建时间 | 备注                                |
+| ---------------------- | ------------ | ------------ | ----------------------------------- |
+| 传统脚本               | 120s         | 120s         | 无缓存，每次都重建所有包            |
+| `turbo`                | 120s         | **5s**       | 使用缓存和依赖图优化任务调度        |
+| `turbo + remote cache` | 120s         | **2s**       | 跨机器缓存（如 Vercel/Turbo Cloud） |
+
+## 如果不用这套，你可能会遇到的问题
+
+| 问题                   | 结果                                             |
+| ---------------------- | ------------------------------------------------ |
+| 重复安装多个项目的依赖 | 时间长、磁盘大、CI 卡慢                          |
+| 每次都构建整个仓库     | 效率低，修改一个 utils 都重新构建全部            |
+| 依赖混乱、版本冲突     | 运行时报错难调试，容易出现「在我机器上可以」问题 |
+| 多仓库协作不方便       | 开发者切来切去，难以同步更新和版本发布           |
+
+## 总结
+
+**pnpm + turborepo 是现代 JS 项目的最佳实践之一，适用于微服务、组件库、多平台应用等复杂项目。**
+
+> 如果你关注的是：**构建速度、复用率、协作效率** —— 这套方案绝对是值得投入的。
+
+当然，这只是我自己的最佳实践，你也可以尝试其他的方案

package/templates/apps/website/monorepo/publish.md

@@ -0,0 +1,189 @@
+# monorepo 发包生成变更日志
+
+在 `monorepo` 中发包和生成变更日志是一项关键的工作。推荐的现代做法是使用 [`changesets`](https://github.com/changesets/changesets) 专为 **monorepo 包发布** 设计的开源工具。
+
+## changesets 是什么？
+
+`changesets` 是一款用于：
+
+- 记录每个变更的目的和版本影响
+- 自动生成变更日志（`CHANGELOG.md`）
+- 自动决定要发布哪些包，以及使用什么语义版本（`major` /`minor`/ `patch`）
+- 与 `CI/CD` 集成实现自动发布（支持 `GitHub Actions`）
+
+## 使用 changesets 的优势
+
+| 优势            | 说明                                                          |
+| --------------- | ------------------------------------------------------------- |
+| ✅ 精细控制     | 每次变更单独写一个 changeset 文件，明确说明影响的包和变更类型 |
+| 📦 支持多包     | 自动识别哪些包发生了变更，以及它们的依赖是否也需要发布        |
+| 🧾 自动生成日志 | 基于 changeset 文件生成结构清晰的 CHANGELOG.md                |
+| 🔄 自动升级版本 | 遵循 Semver 规范，自动处理包之间的依赖升级                    |
+| 🤖 CI/CD 集成   | 支持 GitHub Actions 自动创建版本 PR 并发布到 NPM              |
+
+## 如何在 monorepo 中使用 changesets（pnpm + turbo）
+
+### 1. 安装依赖
+
+```bash
+pnpm add -D @changesets/cli
+pnpm changeset init
+```
+
+会生成：
+
+```bash
+.changeset/         # 存放每次变更的 YAML 文件
+  └── cool-change.md
+```
+
+---
+
+### 2. 编写 changeset
+
+运行以下命令为一次变更创建记录：
+
+```bash
+pnpm changeset
+```
+
+交互式输入：
+
+- 选择受影响的包（多个）
+- 选择版本变更类型（patch / minor / major）
+- 输入 changelog 信息
+
+结果示例（`.changeset/awesome-change.md`）：
+
+```md
+---
+"@my/utils": minor
+"@my/ui": patch
+---
+
+feat: 新增时间工具；
+fix: 修复 UI 按钮颜色。
+```
+
+---
+
+### 3. 版本号升级 + changelog 生成
+
+在合并变更后，运行：
+
+```bash
+pnpm changeset version
+```
+
+它会：
+
+- 更新每个包的 `package.json` 版本号
+- 修改依赖包引用版本
+- 更新每个包的 `CHANGELOG.md`
+
+---
+
+### 4. 发布到 NPM
+
+```bash
+pnpm changeset publish
+```
+
+自动：
+
+- 发布已变更的包
+- 忽略未变更的包
+- 使用 monorepo 中正确的依赖版本
+
+---
+
+### 5. 配合 GitHub Actions 自动发布（可选）
+
+建议使用官方提供的 `create-release` GitHub Action：
+
+```yaml
+name: Release
+
+on:
+  push:
+    branches:
+      - main
+  workflow_dispatch:
+
+concurrency: ${{ github.workflow }}-${{ github.ref }}
+env:
+  HUSKY: 0
+
+permissions:
+  contents: write # to create release (changesets/action)
+  issues: write # to post issue comments (changesets/action)
+  pull-requests: write # to create pull request (changesets/action)
+  id-token: write # to use OpenID Connect token for provenance (changesets/action)
+
+jobs:
+  release:
+    name: Release
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout Repo
+        uses: actions/checkout@v4
+
+      - uses: pnpm/action-setup@v4
+
+      - name: Setup Node.js environment
+        uses: actions/setup-node@v4
+        with:
+          node-version: 22
+          cache: pnpm
+
+      - name: Install Dependencies
+        run: pnpm i
+
+      - name: Create Release Pull Request or Publish to npm
+        id: changesets
+        uses: changesets/action@v1
+        with:
+          # This expects you to have a script called release which does a build for your packages and calls changeset publish
+          publish: pnpm publish-packages
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
+          npm_config_registry: https://registry.npmjs.org
+```
+
+---
+
+## 与其他方案对比（如 lerna、手动脚本）
+
+| 功能          | `changesets`   | `lerna`       | 手动脚本 |
+| ------------- | -------------- | ------------- | -------- |
+| 多包发布支持  | ✅             | ✅            | ❌       |
+| 自动生成日志  | ✅             | ❌/部分支持   | ❌       |
+| 精确控制变更  | ✅（逐条记录） | ❌            | ❌       |
+| 现代化支持    | ✅（活跃维护） | 停滞/社区维护 | ❌       |
+| 与 CI/CD 集成 | ✅             | 部分复杂      | ❌       |
+
+---
+
+## 示例场景
+
+比如你在 monorepo 中改了 `@my/utils` 和 `@my/ui`，你可以：
+
+```bash
+pnpm changeset
+# 然后写明：utils 为 minor，ui 为 patch
+
+pnpm changeset version
+# 自动升级 utils 到 1.3.0，ui 到 0.1.2，并更新 changelog
+
+pnpm changeset publish
+# 发布到 npm
+```
+
+## 总结
+
+使用 `changesets`：
+
+- 是 monorepo 最推荐的发包 + changelog 方案
+- 搭配 `pnpm + turbo` 非常自然
+- 支持团队协作、自动化流程、语义化版本管理

package/templates/apps/website/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@icebreakers/website",
+  "type": "module",
+  "version": "0.0.0",
+  "description": "https://monorepo.icebreaker.top source code",
+  "author": "ice breaker <1324318532@qq.com>",
+  "homepage": "https://monorepo.icebreaker.top",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/sonofmagic/monorepo-template.git",
+    "directory": "apps/website"
+  },
+  "bugs": {
+    "url": "https://github.com/sonofmagic/monorepo-template/issues"
+  },
+  "keywords": [],
+  "scripts": {
+    "dev": "vitepress dev",
+    "build": "vitepress build",
+    "preview": "vitepress preview"
+  },
+  "devDependencies": {
+    "@braintree/sanitize-url": "^7.1.1",
+    "@tailwindcss/vite": "^4.1.13",
+    "cytoscape": "^3.33.1",
+    "cytoscape-cose-bilkent": "^4.1.0",
+    "dayjs": "^1.11.18",
+    "debug": "^4.4.3",
+    "mermaid": "^11.12.0",
+    "tailwindcss": "^4.1.13",
+    "vitepress": "^1.6.4",
+    "vitepress-plugin-mermaid": "^2.0.17"
+  }
+}