@icebreakers/monorepo 3.1.18 → 3.2.0

package/templates/apps/server/package.json

@@ -1,60 +0,0 @@
-{
-  "name": "@icebreakers/server",
-  "type": "module",
-  "version": "0.0.0",
-  "description": "tsup(esbuild) build package template",
-  "author": "ice breaker <1324318532@qq.com>",
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/sonofmagic/monorepo-template.git",
-    "directory": "apps/server"
-  },
-  "bugs": {
-    "url": "https://github.com/sonofmagic/monorepo-template/issues"
-  },
-  "keywords": [],
-  "sideEffects": false,
-  "exports": {
-    ".": "./src/index.ts",
-    "./router": "./src/trpc-router.ts",
-    "./config": "./src/config.ts"
-  },
-  "files": [
-    "dist"
-  ],
-  "scripts": {
-    "dev": "wrangler dev",
-    "node:build:watch": "tsup --watch --sourcemap",
-    "node:build": "tsup",
-    "node:dev": "tsx watch src/node-entry.ts",
-    "node:start": "node dist/node-entry.js",
-    "test": "vitest run",
-    "test:dev": "vitest",
-    "release": "pnpm publish",
-    "lint": "eslint .",
-    "lint:fix": "eslint . --fix",
-    "deploy": "wrangler deploy",
-    "cf-typegen": "wrangler types",
-    "postinstall": "pnpm cf-typegen"
-  },
-  "publishConfig": {
-    "exports": {
-      ".": {
-        "types": "./dist/index.d.ts",
-        "import": "./dist/index.js",
-        "require": "./dist/index.cjs"
-      }
-    },
-    "main": "./dist/index.cjs",
-    "module": "./dist/index.js",
-    "types": "./dist/index.d.ts"
-  },
-  "devDependencies": {
-    "@hono/node-server": "^1.19.9",
-    "consola": "^3.4.2",
-    "hono": "^4.11.4",
-    "wrangler": "^4.59.1",
-    "zod": "^4.3.5"
-  }
-}

package/templates/apps/server/src/app.ts

@@ -1,191 +0,0 @@
-import { Hono } from 'hono'
-
-interface ColorStop { color: string, position: number }
-
-const grads: ColorStop[][] = [
-  [
-    { color: '00000c', position: 0 },
-    { color: '00000c', position: 0 },
-  ],
-  [
-    { color: '020111', position: 85 },
-    { color: '191621', position: 100 },
-  ],
-  [
-    { color: '020111', position: 60 },
-    { color: '20202c', position: 100 },
-  ],
-  [
-    { color: '020111', position: 10 },
-    { color: '3a3a52', position: 100 },
-  ],
-  [
-    { color: '20202c', position: 0 },
-    { color: '515175', position: 100 },
-  ],
-  [
-    { color: '40405c', position: 0 },
-    { color: '6f71aa', position: 80 },
-    { color: '8a76ab', position: 100 },
-  ],
-  [
-    { color: '4a4969', position: 0 },
-    { color: '7072ab', position: 50 },
-    { color: 'cd82a0', position: 100 },
-  ],
-  [
-    { color: '757abf', position: 0 },
-    { color: '8583be', position: 60 },
-    { color: 'eab0d1', position: 100 },
-  ],
-  [
-    { color: '82addb', position: 0 },
-    { color: 'ebb2b1', position: 100 },
-  ],
-  [
-    { color: '94c5f8', position: 1 },
-    { color: 'a6e6ff', position: 70 },
-    { color: 'b1b5ea', position: 100 },
-  ],
-  [
-    { color: 'b7eaff', position: 0 },
-    { color: '94dfff', position: 100 },
-  ],
-  [
-    { color: '9be2fe', position: 0 },
-    { color: '67d1fb', position: 100 },
-  ],
-  [
-    { color: '90dffe', position: 0 },
-    { color: '38a3d1', position: 100 },
-  ],
-  [
-    { color: '57c1eb', position: 0 },
-    { color: '246fa8', position: 100 },
-  ],
-  [
-    { color: '2d91c2', position: 0 },
-    { color: '1e528e', position: 100 },
-  ],
-  [
-    { color: '2473ab', position: 0 },
-    { color: '1e528e', position: 70 },
-    { color: '5b7983', position: 100 },
-  ],
-  [
-    { color: '1e528e', position: 0 },
-    { color: '265889', position: 50 },
-    { color: '9da671', position: 100 },
-  ],
-  [
-    { color: '1e528e', position: 0 },
-    { color: '728a7c', position: 50 },
-    { color: 'e9ce5d', position: 100 },
-  ],
-  [
-    { color: '154277', position: 0 },
-    { color: '576e71', position: 30 },
-    { color: 'e1c45e', position: 70 },
-    { color: 'b26339', position: 100 },
-  ],
-  [
-    { color: '163C52', position: 0 },
-    { color: '4F4F47', position: 30 },
-    { color: 'C5752D', position: 60 },
-    { color: 'B7490F', position: 80 },
-    { color: '2F1107', position: 100 },
-  ],
-  [
-    { color: '071B26', position: 0 },
-    { color: '071B26', position: 30 },
-    { color: '8A3B12', position: 80 },
-    { color: '240E03', position: 100 },
-  ],
-  [
-    { color: '010A10', position: 30 },
-    { color: '59230B', position: 80 },
-    { color: '2F1107', position: 100 },
-  ],
-  [
-    { color: '090401', position: 50 },
-    { color: '4B1D06', position: 100 },
-  ],
-  [
-    { color: '00000c', position: 80 },
-    { color: '150800', position: 100 },
-  ],
-]
-
-// Convert hour to CSS gradient
-async function toCSSGradient(hour: number): Promise<string> {
-  let css = 'linear-gradient(to bottom,'
-  const data = grads[hour]
-  const len = data.length
-
-  for (let i = 0; i < len; i++) {
-    const item = data[i]
-    css += ` #${item.color} ${item.position}%`
-    if (i < len - 1) {
-      css += ','
-    }
-  }
-
-  return `${css})`
-}
-
-const app = new Hono()
-
-app.get('*', async (c) => {
-  const request = c.req.raw
-
-  // Base HTML style
-  let html_style = `
-    html{width:100vw; height:100vh;}
-    body{padding:0; margin:0 !important;height:100%;}
-    #container {
-      display: flex;
-      flex-direction:column;
-      align-items: center;
-      justify-content: center;
-      height: 100%;
-      color:white;
-      font-family:sans-serif;
-    }`
-
-  // Get timezone from Cloudflare request
-  const timezone: string = request.cf?.timezone as string || 'UTC'
-
-  // Get localized time
-  const localized_date = new Date(
-    new Date().toLocaleString('en-US', { timeZone: timezone }),
-  )
-
-  const hour = localized_date.getHours()
-  const minutes = localized_date.getMinutes()
-
-  // Generate HTML content
-  let html_content = `<h1>${hour}:${minutes}</h1>`
-  html_content += `<p>${timezone}<br/></p>`
-
-  // Add background gradient based on hour
-  html_style += `body{background:${await toCSSGradient(hour)};}`
-
-  // Complete HTML document
-  const html = `
-    <!DOCTYPE html>
-    <head>
-      <title>Geolocation: Customized Design</title>
-    </head>
-    <body>
-      <style>${html_style}</style>
-      <div id="container">
-        ${html_content}
-      </div>
-    </body>`
-
-  return c.html(html)
-})
-
-export {
-  app,
-}

package/templates/apps/server/src/config.ts

@@ -1 +0,0 @@
-export const port = 8787

package/templates/apps/server/src/fetch-entry.ts

@@ -1,5 +0,0 @@
-import { app } from './app'
-
-export default {
-  fetch: app.fetch,
-} satisfies ExportedHandler<Env>

package/templates/apps/server/src/node-entry.ts

@@ -1,13 +0,0 @@
-import { serve } from '@hono/node-server'
-import { consola } from 'consola'
-import { logger } from 'hono/logger'
-import { app } from './app'
-import { port } from './config'
-
-app.use(logger())
-serve({
-  fetch: app.fetch,
-  port,
-})
-
-consola.success(`Server listening on http://localhost:${port}`)

package/templates/apps/server/test/index.test.ts

@@ -1,14 +0,0 @@
-import { Hono } from 'hono'
-import { testClient } from 'hono/testing'
-
-describe('index', () => {
-  it('foo bar', async () => {
-    const app = new Hono().get('/search', c =>
-      c.json({ hello: 'world' }))
-    const res = await testClient(app).search.$get()
-
-    expect(await res.json()).toEqual({ hello: 'world' })
-
-    // expect(await res.json()).toEqual({ hello: 'world' })
-  })
-})

package/templates/apps/server/tsconfig.json

@@ -1,24 +0,0 @@
-{
-  "extends": "../../tsconfig.json",
-  "compilerOptions": {
-    "lib": [
-      "ES2022",
-      "WebWorker"
-    ],
-    "baseUrl": ".",
-    "paths": {
-      "@/*": [
-        "src/*"
-      ]
-    },
-    "types": [
-      "node",
-      "vitest/globals",
-      "./worker-configuration.d.ts"
-    ]
-  },
-  "include": [
-    "src",
-    "test"
-  ]
-}

package/templates/apps/server/tsup.config.ts

@@ -1,13 +0,0 @@
-import { defineConfig } from 'tsup'
-
-export default defineConfig({
-  entry: ['src/node-entry.ts'], // , 'src/cli.ts'],
-  shims: true,
-  format: ['esm'],
-  clean: true,
-  dts: false,
-  // https://github.com/egoist/tsup/pull/1056
-  // https://github.com/egoist/tsup/issues?q=cjsInterop
-  // cjsInterop: true,
-  // splitting: true,
-})

package/templates/apps/server/vitest.config.ts

@@ -1,15 +0,0 @@
-import path from 'node:path'
-import { defineProject } from 'vitest/config'
-
-export default defineProject({
-  test: {
-    alias: [
-      {
-        find: '@',
-        replacement: path.resolve(__dirname, './src'),
-      },
-    ],
-    globals: true,
-    testTimeout: 60_000,
-  },
-})

package/templates/apps/server/wrangler.jsonc

@@ -1,18 +0,0 @@
-{
-  "$schema": "./node_modules/wrangler/config-schema.json",
-  "name": "monorepo-service",
-  "compatibility_date": "2025-10-16",
-  "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

@@ -1,93 +0,0 @@
-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

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

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

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

package/templates/apps/website/gitignore

@@ -1 +0,0 @@
-.vitepress/cache

package/templates/apps/website/index.md

@@ -1,127 +0,0 @@
----
-layout: doc
----
-
-# icebreaker's monorepo 模板
-
-整套模板围绕 **pnpm + Turborepo + TypeScript** 打造，帮助团队快速落地一个可维护、可编排、可持续迭代的 `monorepo` 工程。这里我们把使用方式拆成几个核心模块，方便你按需查阅。
-
-## 核心能力
-
-- **工作区管理**：`pnpm` workspace + Turborepo 任务编排，内置缓存和过滤能力。
-- **全链路 TypeScript**：所有模板（应用、类库、CLI）均使用 TS，并自带基础测试脚手架（`vitest`）。
-- **质量与规范**：集成 `eslint`、`stylelint`、`husky`、`commitlint`、`lint-staged`，开箱即用。
-- **自动化发布**：`changesets` + GitHub Actions + Dockerfile 模板，实现语义化发版和部署。
-- **命令行助手**：`@icebreakers/monorepo` CLI 提供创建、同步、升级、镜像等常用命令，可通过 `monorepo.config.ts` 自定义行为。
-
-## 快速上手
-
-1. **拉取模板**：[GitHub](https://github.com/sonofmagic/monorepo-template) 右上角 `Use this template`，或克隆源码。
-2. **安装依赖**：在 `pnpm-workspace.yaml` 所在目录执行 `pnpm install`（需要 Node.js ≥ 20，推荐 `npm i -g pnpm`）。
-3. **可选清理**：直接运行 `npx -y @icebreakers/monorepo@latest clean` 远程执行清理，移除演示包后再执行 `pnpm install`（避免依赖本地构建 `monorepo`）；如已安装依赖，也可使用 `pnpm script:clean`。
-4. **初始化元数据**：`pnpm script:init` 会批量更新 `package.json`、`README.md` 等公共信息。
-
-## 仓库结构速览
-
-| 目录                        | 描述                             |
-| --------------------------- | -------------------------------- |
-| `apps/cli`                  | TypeScript 编写的 CLI 模板       |
-| `apps/client`               | Vue 3 + Vite 客户端示例          |
-| `apps/server`               | 基于 Hono 的服务端模板           |
-| `apps/website`              | VitePress 文档站（即本网站源码） |
-| `packages/tsup-template`    | 使用 `tsup` 打包的库模板         |
-| `packages/unbuild-template` | 使用 `unbuild` 打包的库模板      |
-| `packages/vue-lib-template` | Vue 组件库模板                   |
-| `packages/monorepo`         | CLI 及配置同步工具，支持独立升级 |
-
-## 常用脚本
-
-| 命令                 | 说明                                                |
-| -------------------- | --------------------------------------------------- |
-| `pnpm script:clean`  | 清理演示仓库，保留最小模板                          |
-| `pnpm script:init`   | 同步初始化 `package.json`、`README.md` 等基础信息   |
-| `pnpm script:sync`   | 使用 `cnpm` 同步所有包到 npmmirror（需预装 `cnpm`） |
-| `pnpm script:mirror` | 为 VS Code 终端写入国内镜像环境变量                 |
-
-更多脚本可在根目录 `package.json` 中查看，命令介绍详见 [工具区](./tools/turborepo.md)。
-
-## CLI 命令概览
-
-```bash
-npx monorepo new           # 创建子包/应用
-npx -y @icebreakers/monorepo@latest clean  # 远程清理已勾选的子项目，避免依赖本地构建
-npx monorepo sync          # 同步所有包到 npmmirror
-npx monorepo mirror        # 写入 VS Code 镜像配置
-npx monorepo up            # 从最新模板同步配置文件
-npx monorepo ai create     # 生成 Agentic 任务提示词模板（支持输出到文件，可用别名 ai new）
-```
-
-示例：`npx monorepo ai create -o agentic-task.md -f`，可直接生成 Markdown 模板并覆盖旧文件。默认会写入 `agentic/prompts/<timestamp>/prompt.md`，同时生成一个按时间排序的目录，并会提示你确认或修改目录名称，方便后续补充图片等素材；也可以用别名 `npx monorepo ai new`.
-
-多文件场景：
-
-- `npx monorepo ai create --name checkout` 自动落盘到 `agentic/prompts/checkout.md`（默认目录可改）。
-- `npx monorepo ai create --tasks agentic/tasks.json -f` 读取 JSON 数组批量生成，适合多人协作收口任务。
-
-所有命令都支持在 `monorepo.config.ts` 中覆写默认行为，例如新增模板、修改同步命令、跳过 README 初始化等。配置示例见下文和 [配置中心说明](./monorepo/manage.md#使用-monorepo-configts-定制命令行为)。
-
-## 自定义配置：`monorepo.config.ts`
-
-```ts
-import { defineMonorepoConfig } from '@icebreakers/monorepo'
-
-export default defineMonorepoConfig({
-  commands: {
-    ai: {
-      baseDir: 'agentic/custom-prompts',
-      format: 'json',
-      force: true,
-      tasksFile: 'agentic/tasks.json',
-    },
-    create: {
-      defaultTemplate: 'cli',
-      renameJson: true,
-    },
-    clean: {
-      autoConfirm: true,
-      ignorePackages: ['docs'],
-    },
-    upgrade: {
-      skipOverwrite: true,
-      targets: ['.github', 'monorepo.config.ts'],
-    },
-  },
-})
-```
-
-更多可配置项详见 [管理指南](./monorepo/manage.md)。
-
-## 依赖与版本升级
-
-```bash
-pnpm up -rLi
-```
-
-- `-r`：递归遍历所有 workspace
-- `-L`：升级到最新版本
-- `-i`：交互式选择（推荐查看差异后再确认）
-
-## 自动化发布
-
-模板默认集成 [`changesets`](https://github.com/changesets/changesets) 与推荐的 GitHub Actions 工作流：
-
-1. 安装 [changeset-bot](https://github.com/apps/changeset-bot)。
-2. 在仓库设置中开启 `Actions` 的 `Read and write permissions` 并勾选允许创建 PR。
-3. 在 `Repository secrets` 中配置 `NPM_TOKEN`（若需要 Codecov 也可配置 `CODECOV_TOKEN`）。
-4. 运行 `pnpm changeset`、`pnpm changeset version`、`pnpm changeset publish` 完成发布；或交由 CI 自动执行。
-
-具体操作指南参见 [发包流程](./monorepo/publish.md)。
-
-## 更多资源
-
-- [为什么选择 monorepo？](./monorepo/index.md)
-- [pnpm workspaces 与 Turborepo 组合的优势](./monorepo/manage.md)
-- [工具链介绍](./tools/turborepo.md)
-- [常见思考与 FAQ](./thinking.md)
-
-> 欢迎结合自己的业务场景对模板做进一步裁剪与扩展，建议在自定义后保留 `monorepo.config.ts` 以便集中管理命令默认值。

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

@@ -1,46 +0,0 @@
-# 为什么选择 Monorepo？
-
-随着项目复杂度提升，Node.js 团队越来越倾向于把多套服务、组件库、CLI 工具放在同一个仓库里。Monorepo 的核心价值在于 **集中管理依赖与流程**，从而让重构、协作、发布都更高效。
-
-## Monorepo 的主要收益
-
-| 维度     | 收益                                                               |
-| -------- | ------------------------------------------------------------------ |
-| 依赖管理 | `pnpm` 等工具会共享缓存、避免重复安装；严格依赖隔离杜绝“幽灵依赖”  |
-| 构建效率 | 借助 Turborepo 的缓存与依赖图，仅构建真正改动的包，CI 时间显著降低 |
-| 原子提交 | 一个提交即可跨多个模块同步改动，便于回滚与审计                     |
-| 协作体验 | 同一仓库统一配置、脚本与规范，减少跨项目跳转和环境差异             |
-| 可复用性 | 公共库、UI 组件、工具函数在 workspace 内即可本地引用并共享         |
-
-## 与 Polyrepo 的对比
-
-| Polyrepo 常见痛点                | Monorepo 的解决方式                                |
-| -------------------------------- | -------------------------------------------------- |
-| 每个仓库单独装依赖、重复维护脚本 | Workspace 共享依赖与脚本，一次配置多处使用         |
-| 同步多个仓库中的接口或配置       | 原子提交 + Turborepo 构建，修改一次即可全仓库生效  |
-| CI/CD 配置分散、发布流程冗长     | 基于 changesets 和统一仓库配置快速搭建自动化流水线 |
-| 大规模重构成本高                 | 搜索范围集中，易于批量修改、验证与回滚             |
-
-## 常见落地场景
-
-- **多端同仓**：Web、Server、CLI 共存，代码共享严格受控。
-- **组件库/工具链**：公共 API 与内部应用一起维护，避免版本漂移。
-- **微服务集成**：多个服务共享协议、类型定义，发布与部署流程统一。
-- **巨石拆分**：将原有大型项目拆成多个 package，逐步抽象并复用。
-
-## 迁移建议
-
-1. **先集中依赖**：把最常见的公共依赖和脚本统一到根目录，利用 `pnpm workspace` 管理版本。
-2. **逐步迁移模块**：按照业务领域或团队边界迁移子模块，保留原 CI 作为兜底。
-3. **引入构建缓存**：配置 Turborepo，使用 `turbo run <task> --filter=<scope>` 控制任务范围。
-4. **接入 changesets**：在迁移过程中就开始记录版本与变更，养成可发布的节奏。
-5. **通过 monorepo.config.ts 定制命令**：按团队习惯调整 `create` 模板、`clean` 行为、`upgrade` 目标等，提高可维护性。
-
-## 进一步阅读
-
-- [仓库管理实践](./manage.md) —— 如何将 pnpm + Turborepo + monorepo.config 协同使用。
-- [发包与变更日志](./publish.md) —— 使用 changesets 管理版本、自动化发布。
-- [工具专题](../tools/turborepo.md) —— 常用工具的配置与技巧。
-- [常见思考](../thinking.md) —— 关于模块拆分、包结构的经验分享。
-
-> Monorepo 不是银弹，但在需要大量复用、自动化、跨团队协作的场景下，它能显著提升工程效率。关键是配合合适的工具与规范，让拆分后的每个模块都有清晰的职责与边界。