@icebreakers/monorepo-templates 1.2.1 → 1.3.0

package/templates/vitepress/zh/repoctl/workflows.md

@@ -110,6 +110,41 @@ repo ws ls --json --out reports/workspaces.json
 | 输出给脚本         | `--json --out <file>`                              |
 | 输出给人看并脱敏   | `--markdown --redact --out <file>`                 |
 
+## 文档 Worker
+
+repoctl 文档通过名为 `repoctl-docs` 的 Cloudflare Worker 部署。VitePress 只生成静态资产，Workers Static Assets 直接提供这些文件，因此不需要应用 handler，也不声明 `ASSETS` binding。
+
+### Workers Builds 配置
+
+| 配置项     | 值                                                      |
+| ---------- | ------------------------------------------------------- |
+| 仓库根目录 | 仓库根目录                                              |
+| 生产分支   | `main`                                                  |
+| 构建命令   | `pnpm --filter @icebreakers/website build`              |
+| 生产部署   | `pnpm --filter @icebreakers/website run deploy`         |
+| 非生产部署 | `pnpm --filter @icebreakers/website run deploy:preview` |
+
+构建命令会先校验双语页面，再由 VitePress 生成 `.vitepress/dist`。Worker 配置会为不存在的路由返回生成后的 `404.html`，并继续读取 `public/_redirects`，兼容旧的 `/en/*` 链接。
+
+### 预览、发布与回滚
+
+修改生产部署前，先完成本地验证：
+
+```bash
+pnpm --filter @icebreakers/website build
+pnpm --filter @icebreakers/website run deploy:dry-run
+pnpm --filter @icebreakers/website exec wrangler dev
+```
+
+非生产 Workers Builds 上传预览版本。验证通过后再执行生产部署。需要回滚时，先查看版本历史，再选择最近的稳定版本：
+
+```bash
+pnpm --filter @icebreakers/website exec wrangler versions list
+pnpm --filter @icebreakers/website exec wrangler rollback <VERSION_ID>
+```
+
+`repoctl.icebreaker.top` 是唯一 canonical custom domain。Cloudflare Redirect Rules 把 `repo.icebreaker.top/*` 和 `monorepo.icebreaker.top/*` 永久跳转到主域名，同时保留路径和查询参数。
+
 ## 下一步
 
 - 查所有参数：[命令速查](./commands.md)

package/templates/vitepress/zh/thinking.md

@@ -69,17 +69,20 @@
 
 此外，模板里还有许多为 `GitHub` 显示优化的 `md` 文档。
 
-## 部署
+## 文档部署
 
-文档网站通过 `netlify.toml` 配置部署在 `Netlify` 上。最初我使用的是 `Vercel`，但由于**国内**访问速度的原因，最终迁移到了 `Netlify`。
+文档是一个 VitePress 静态站点，以名为 `repoctl-docs` 的 Cloudflare Worker 发布。Workers Static Assets 直接托管 `.vitepress/dist`，同时处理自定义 404 页面和 `_redirects` 兼容规则。站点没有动态请求逻辑，因此不额外编写 Worker handler，也不声明 `ASSETS` binding。
 
-而且由于我是开源项目贡献者的原因，`Netlify` 为我 `免费` 提供了 `Pro` 版本的计划 (通常这需要 `$19/per member/month`)
+Cloudflare Workers Builds 从仓库根目录执行：
 
-感谢 `Netlify`! 爱你❤️😍。
+```bash
+pnpm --filter @icebreakers/website build
+pnpm --filter @icebreakers/website run deploy
+```
 
-如果看到这里的哥们，你也有一定影响力的开源项目，也可以通过下方的链接申请。
+非生产分支使用 `pnpm --filter @icebreakers/website run deploy:preview` 上传预览版本。生产发布前运行 `pnpm --filter @icebreakers/website run deploy:dry-run`，校验静态资产清单和 Wrangler 配置。需要回滚时，先用 `wrangler versions list` 确认版本，再执行 `wrangler rollback <VERSION_ID>`。
 
-https://www.netlify.com/legal/open-source-policy/
+唯一主域名是 `https://repoctl.icebreaker.top`。`repo.icebreaker.top` 和 `monorepo.icebreaker.top` 只作为兼容入口，由 Cloudflare 301 跳转到主域名，并保留原路径与查询参数。
 
 ## 总结
 

package/templates/vitepress/zh/why/examples/2.npm-basic-package/README.md

@@ -1 +1 @@
-https://repo.icebreaker.top/
+https://repoctl.icebreaker.top/

package/templates/vitepress/zh/why/examples/3.npm-basic-package/README.md

@@ -1 +1 @@
-https://repo.icebreaker.top/
+https://repoctl.icebreaker.top/

package/templates/vitepress/zh/why/index.md

@@ -1 +1,38 @@
-# 从 0 到 1 构建 monorepo
+# 包的演进
+
+一个可发布的 npm 包不只是源代码目录。消费者依赖它的运行时格式、类型声明、入口点、发布文件和兼容性承诺。这里按这些公开边界整理现代包的基础知识。
+
+## 先从消费者开始
+
+在选择打包器或模块格式前，先回答：
+
+- 消费者使用 ESM、CommonJS，还是两者都需要？
+- 包发布运行时代码、类型、CLI、配置预设还是资源？
+- 需要支持哪些 Node 版本？
+- 对外只暴露一个入口，还是需要明确的子路径？
+
+这些答案定义了包的边界。工具链应该实现边界，而不是替代边界决策。
+
+## 推荐目录
+
+```text
+src/          源代码
+dist/         生成的 ESM、CommonJS 与声明文件
+package.json  公开 metadata 与 exports 映射
+README.md     安装和使用契约
+```
+
+使用 `files` 控制发布内容，并在发布前执行 `npm pack --dry-run` 检查实际 tarball。
+
+## 专题
+
+- [ESM 与 CommonJS](./modern/esm-vs-cjs.md)
+- [类型声明](./modern/dts.md)
+- [包入口](./modern/package-entry-points.md)
+- [构建工具](./modern/bundlers.md)
+- [TypeScript](./modern/typescript.md)
+
+## 继续阅读
+
+- [什么是 npm 包](./what-is-npm-package.md)
+- [发布 npm 包](./publish-basic-npm-package.md)

package/templates/vue-lib/package.json

@@ -6,7 +6,7 @@
   "description": "Internal Vue library template shipped with repoctl",
   "author": "ice breaker <hi@sonofmagic.top>",
   "license": "ISC",
-  "homepage": "https://repo.icebreaker.top",
+  "homepage": "https://repoctl.icebreaker.top",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/sonofmagic/repoctl.git",

package/assets/netlify.toml

@@ -1,14 +0,0 @@
-[build]
-publish = "dist"
-command = "pnpm run build"
-
-[build.environment]
-NODE_VERSION = "22"
-
-[[redirects]]
-from = "/*"
-to = "/index.html"
-status = 200
-
-[context.deploy-preview]
-ignore = "exit 0"