ci: add current package benchmark gate

Author: sonofmagic

.changeset/benchmark-published-baseline.md

@@ -0,0 +1,5 @@
+---
+"tailwindcss-config": patch
+---
+
+修复发布产物的 ESM 入口文件名与 `package.json` 导出声明不一致的问题，确保依赖已发布 `weapp-tailwindcss` 的 benchmark 工作区可以正确加载 Tailwind 配置工具包。

.github/workflows/benchmark.yml

@@ -0,0 +1,86 @@
+name: Benchmark
+
+on:
+  pull_request:
+    types: [opened, synchronize, reopened, ready_for_review]
+  push:
+    branches:
+      - main
+      - alpha
+      - beta
+      - rc
+      - next
+  workflow_dispatch:
+    inputs:
+      baseline:
+        description: npm 发布基线；auto 会按当前包版本推断 next/beta/rc/latest
+        required: false
+        default: auto
+      build_runs:
+        description: 每个项目的 build 采样次数
+        required: false
+        default: '3'
+      hmr_runs:
+        description: 每个项目的 HMR 采样次数
+        required: false
+        default: '5'
+      only:
+        description: 可选：只跑指定项目 key，多个 key 用逗号分隔
+        required: false
+        default: ''
+
+concurrency:
+  group: benchmark-${{ github.event.pull_request.number || github.ref }}
+  cancel-in-progress: true
+
+permissions:
+  contents: read
+
+jobs:
+  current-vs-published:
+    name: Current vs published weapp-tailwindcss
+    runs-on: ubuntu-latest
+    timeout-minutes: 180
+    env:
+      TURBO_TOKEN: ${{ secrets.TURBO_TOKEN }}
+      TURBO_TEAM: ${{ vars.TURBO_TEAM }}
+      WEAPP_TW_BENCH_BASELINE: ${{ github.event.inputs.baseline || 'auto' }}
+      BENCH_BUILD_RUNS: ${{ github.event.inputs.build_runs || '3' }}
+      BENCH_HMR_RUNS: ${{ github.event.inputs.hmr_runs || '5' }}
+      BENCH_ONLY: ${{ github.event.inputs.only || '' }}
+
+    steps:
+      - name: Check out code
+        uses: actions/checkout@v6
+        with:
+          fetch-depth: 2
+
+      - uses: pnpm/action-setup@v4
+
+      - name: Setup Node.js environment
+        uses: actions/setup-node@v6
+        with:
+          node-version: 22
+          cache: pnpm
+          cache-dependency-path: pnpm-lock.yaml
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+
+      - name: Run current vs published benchmark
+        run: >
+          pnpm bench:ci --
+          --build-runs "$BENCH_BUILD_RUNS"
+          --hmr-runs "$BENCH_HMR_RUNS"
+          --timeout 180000
+          --poll-interval 120
+          --only "$BENCH_ONLY"
+          --result-dir .tmp/benchmark-ci/result
+
+      - name: Upload benchmark artifacts
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: benchmark-current-vs-published
+          path: .tmp/benchmark-ci/result/**
+          if-no-files-found: error

benchmark/version-compare/scripts/ci-report.mjs

@@ -0,0 +1,111 @@
+function toNumber(value) {
+  return typeof value === 'number' && Number.isFinite(value) ? value : 0
+}
+
+function pct(from, to) {
+  return from ? ((to - from) / from) * 100 : 0
+}
+
+function fmtMs(value) {
+  return toNumber(value).toFixed(2)
+}
+
+function fmtPct(value) {
+  const n = toNumber(value)
+  return `${n >= 0 ? '+' : ''}${n.toFixed(2)}%`
+}
+
+function metric(row, kind) {
+  return toNumber(row?.summary?.[`${kind}Steady`]?.median ?? row?.summary?.[kind]?.median)
+}
+
+function average(values) {
+  return values.length ? values.reduce((sum, value) => sum + value, 0) / values.length : 0
+}
+
+function normalizePackageSpec(value) {
+  if (value.startsWith('weapp-tailwindcss@')) {
+    return value
+  }
+  return `weapp-tailwindcss@${value}`
+}
+
+export function buildSummary(raw, baselineLabel, currentLabel) {
+  const rows = raw.rows ?? []
+  const byKey = new Map(rows.map(row => [`${row.version}::${row.key}`, row]))
+  const currentRows = rows.filter(row => row.version === currentLabel)
+  const compares = currentRows.map((current) => {
+    const baseline = byKey.get(`${baselineLabel}::${current.key}`)
+    const baselineBuild = metric(baseline, 'build')
+    const currentBuild = metric(current, 'build')
+    const baselineHmr = metric(baseline, 'hmr')
+    const currentHmr = metric(current, 'hmr')
+    return {
+      key: current.key,
+      project: current.project,
+      baselineBuild,
+      currentBuild,
+      buildDeltaPct: pct(baselineBuild, currentBuild),
+      baselineHmr,
+      currentHmr,
+      hmrDeltaPct: pct(baselineHmr, currentHmr),
+      baselineError: baseline?.error,
+      currentError: current.error,
+    }
+  })
+  const errors = rows.filter(row => row.error).map(row => ({
+    version: row.version,
+    key: row.key,
+    error: row.error,
+  }))
+  const validCompares = compares.filter(item => !item.baselineError && !item.currentError)
+  return {
+    generatedAt: raw.generatedAt,
+    options: raw.options,
+    baseline: baselineLabel,
+    current: currentLabel,
+    compares,
+    errors,
+    averages: {
+      buildDeltaPct: average(validCompares.map(item => item.buildDeltaPct)),
+      hmrDeltaPct: average(validCompares.map(item => item.hmrDeltaPct)),
+    },
+  }
+}
+
+export function toMarkdown(summary, baselineSpec) {
+  const rows = summary.compares.map((item) => {
+    const note = [item.baselineError && 'baseline error', item.currentError && 'current error'].filter(Boolean).join(', ')
+    return `| ${item.key} | ${fmtMs(item.baselineBuild)} | ${fmtMs(item.currentBuild)} | ${fmtPct(item.buildDeltaPct)} | ${fmtMs(item.baselineHmr)} | ${fmtMs(item.currentHmr)} | ${fmtPct(item.hmrDeltaPct)} | ${note || '-'} |`
+  }).join('\n')
+  const errors = summary.errors.length
+    ? summary.errors.map(item => `- ${item.version} / ${item.key}: ${String(item.error).split('\n')[0]}`).join('\n')
+    : '- 无'
+
+  return `# weapp-tailwindcss 当前版本 vs 发布版本 Benchmark
+
+生成时间：${summary.generatedAt}
+
+## 基线
+
+- 当前版本：${summary.current}
+- 发布基线：${summary.baseline}（${normalizePackageSpec(baselineSpec)}）
+- 样本参数：build ${summary.options.buildRuns} 次，hmr ${summary.options.hmrRuns} 次，timeout ${summary.options.timeoutMs}ms
+
+## 汇总
+
+- Build 稳态中位数平均变化：${fmtPct(summary.averages.buildDeltaPct)}
+- HMR 稳态中位数平均变化：${fmtPct(summary.averages.hmrDeltaPct)}
+- 失败项：${summary.errors.length}
+
+## 项目矩阵
+
+| 项目 | Baseline Build(ms) | Current Build(ms) | Build 变化 | Baseline HMR(ms) | Current HMR(ms) | HMR 变化 | 备注 |
+| --- | ---: | ---: | ---: | ---: | ---: | ---: | --- |
+${rows}
+
+## 失败项
+
+${errors}
+`
+}