chore: lint update

Author: wkylin

README.md

@@ -361,6 +361,62 @@ Baize CLI 是一个轻量、规范且高效的前端项目脚手架工具，旨
 
 ## 🤝 Show your support
 
+---
+
+## ⚙️ CI / 部署
+
+本项目在 CI/部署 环境中支持可选的 Sentry 集成（用于上传 release 与 source maps），且在未配置上传凭证时会自动跳过以避免构建警告。
+
+- 目的：在需要时将 release/source maps 上传到 Sentry；在本地或未配置 token 时跳过上传，避免泄露凭证或出现不必要警告。
+- 关键环境变量：
+   - `SENTRY_AUTH_TOKEN` — Sentry API token（CI secrets），用于 `sentry-webpack-plugin` 上传 artifacts。
+   - `SENTRY_ORG` — Sentry 组织 slug。
+   - `SENTRY_PROJECT` — Sentry 项目 slug。
+   - `SENTRY_DSN` — 前端运行时使用的 DSN（可在部署时注入至运行时代码）。
+   - `SENTRY_TRACES_SAMPLE_RATE` — 可选，transactions 采样率（例如 `0.2`）。
+
+为什么会出现警告
+- `sentry-webpack-plugin` 在没有 `authToken` 时会打印警告并跳过上传；本仓库的 `webpack/webpack.prod.js` 已修改为：仅当 `SENTRY_AUTH_TOKEN` 存在时才注册该插件，否则构建继续并输出简短提示。
+
+GitHub Actions 示例
+
+```yaml
+name: Build
+on: [push]
+jobs:
+   build:
+      runs-on: ubuntu-latest
+      steps:
+         - uses: actions/checkout@v4
+         - name: Use Node.js
+            uses: actions/setup-node@v4
+            with:
+               node-version: '18'
+         - name: Install
+            run: npm ci
+         - name: Build (production)
+            env:
+               SENTRY_AUTH_TOKEN: ${{ secrets.SENTRY_AUTH_TOKEN }}
+               SENTRY_ORG: ${{ secrets.SENTRY_ORG }}
+               SENTRY_PROJECT: ${{ secrets.SENTRY_PROJECT }}
+               SENTRY_DSN: ${{ secrets.SENTRY_DSN }}
+               SENTRY_TRACES_SAMPLE_RATE: 0.2
+            run: npm run build:production
+```
+
+Vercel / Netlify
+- 在项目的 Environment Variables / Build settings 中添加 `SENTRY_AUTH_TOKEN`、`SENTRY_ORG`、`SENTRY_PROJECT` 和 `SENTRY_DSN`，部署时这些变量会注入到构建与运行时环境。
+
+本地开发
+- 不要在本地把 `SENTRY_AUTH_TOKEN` 写入源码或提交到仓库。可在本地 `.env` 或 CI 的 secrets 中临时添加 `SENTRY_DSN` 用于运行时错误上报测试，但将 `SENTRY_AUTH_TOKEN` 保持为空以跳过上传步骤。
+
+如何创建 `SENTRY_AUTH_TOKEN`
+- 前往 https://sentry.io/settings/<ORG>/api/，创建一个具有 `project:releases` 与 `org:read` 权限的 token，并把它存入 CI 的 secrets。
+
+注意
+- `SENTRY_DSN`（运行时）与 `SENTRY_AUTH_TOKEN`（CI 上传）用途不同，请勿混淆；本项目的运行时代码会优先使用 `process.env.SENTRY_DSN`，构建时的插件仅在 `SENTRY_AUTH_TOKEN` 存在时运行。
+
+
 <!-- Give a ⭐️ if this project helped you! -->
 
 If you like the project, give it a star ⭐️, it will be a great encouragement to me.

babel.config.js

@@ -2,12 +2,11 @@ const plugins = [
   ['@babel/plugin-syntax-dynamic-import'],
   ['@babel/plugin-proposal-decorators', { legacy: true }],
   ['@babel/plugin-transform-runtime'],
-  ['@babel/plugin-transform-modules-commonjs'],
   ['@babel/plugin-transform-object-rest-spread'],
   ['babel-plugin-react-compiler'],
 ]
 
-module.exports = {
+export default {
   presets: [
     [
       '@babel/preset-env',

docs/SENTRY-CI.md

@@ -0,0 +1,55 @@
+**Sentry CI / Build Integration**
+
+这是仓库中针对 Sentry 在 CI 和生产构建中如何配置的说明（用于 `sentry-webpack-plugin` 和运行时代码）。
+
+- 目的：让构建在需要时上传 release / source maps 到 Sentry；在本地或未配置 token 时跳过上传以避免警告。
+- 关键环境变量：
+  - `SENTRY_AUTH_TOKEN` — Sentry API token，用于 `sentry-webpack-plugin` 上传 source maps / 创建 release（敏感，存为 CI secret）。
+  - `SENTRY_ORG` — Sentry 组织 slug（用于插件配置）。
+  - `SENTRY_PROJECT` — Sentry 项目 slug（用于插件配置）。
+  - `SENTRY_DSN` — 前端运行时使用的 DSN（可通过环境注入到运行时构建或在部署处注入）。
+  - `SENTRY_TRACES_SAMPLE_RATE` — 可选，采样率（例如 `0.2`）。
+
+为什么会出现警告
+- `sentry-webpack-plugin` 在没有 `authToken` 时会打印警告并不上传 source maps（这是正常的保护行为）。我们的 `webpack/webpack.prod.js` 已修改为：仅当 `SENTRY_AUTH_TOKEN` 存在时才注册该插件；否则构建继续并输出简短提示。
+
+示例：GitHub Actions
+```
+name: Build
+on: [push]
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Use Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '18'
+      - name: Install
+        run: npm ci
+      - name: Build (production)
+        env:
+          SENTRY_AUTH_TOKEN: ${{ secrets.SENTRY_AUTH_TOKEN }}
+          SENTRY_ORG: ${{ secrets.SENTRY_ORG }}
+          SENTRY_PROJECT: ${{ secrets.SENTRY_PROJECT }}
+          SENTRY_DSN: ${{ secrets.SENTRY_DSN }}
+          SENTRY_TRACES_SAMPLE_RATE: 0.2
+        run: npm run build:production
+```
+
+示例：Vercel / Netlify
+- 在项目的 Environment Variables / Build settings 中添加 `SENTRY_AUTH_TOKEN`、`SENTRY_ORG`、`SENTRY_PROJECT` 和 `SENTRY_DSN`。部署构建时这些变量会注入到构建环境。
+
+本地开发
+- 不要在本地把 token 写入源码。可在本地 `.env` 文件中临时添加 `SENTRY_DSN`（用于运行时代码），但不要添加 `SENTRY_AUTH_TOKEN`，这样本地构建将跳过上传。
+
+如何创建 `SENTRY_AUTH_TOKEN`
+- 前往 https://sentry.io/settings/<ORG>/api/，创建一个具有 `project:releases` 和 `org:read` 权限的 token。将该 token 存入 CI 的 secrets。
+
+注意
+- `SENTRY_DSN` 是前端运行时用来发送事件的 DSN；`SENTRY_AUTH_TOKEN` 是 CI 用来上传 artifacts（source maps / releases）的私密 token，两者用途不同，不要混淆。
+- 我们的 `src/utils/sentry/index.js` 会优先使用 `process.env.SENTRY_DSN`，并允许在运行时代码中通过环境变量或构建时间注入替换。
+
+如需我：
+- 可以把这段内容合并到 `README.md` 的“部署”或“CI”节；或创建更详细的 `docs/` 页面并添加示例 workflow（我可以代为修改）。

eslint-report.json

@@ -1,5 +1,5 @@
-const Router = require('koa-router')
-const { delay } = require('../utils/index')
+import Router from 'koa-router'
+import { delay } from '../utils/index.js'
 
 const user = new Router()
 
@@ -12,4 +12,4 @@ user.get('/api/user/list', async (ctx) => {
   ctx.body = [{ name: 'wkylin', sex: 'man', age: 18 }]
 })
 
-module.exports = user
+export default user

faker/app/index.js

@@ -1,22 +1,18 @@
-// import Koa from 'koa' package.json type: module
-// Within a package, the package.json "type" field defines how Node.js should interpret .js files. If a package.json file does not have a "type" field, .js files are treated as CommonJS.
-// A package.json "type" value of "module" tells Node.js to interpret .js files within that package as using ES module syntax.
-// https://demopark.github.io/koa-docs-Zh-CN
+// faker server (ESM)
+import Koa from 'koa'
+import Router from 'koa-router'
+import bodyParser from 'koa-bodyparser'
+import cors from '@koa/cors'
+import portfinder from 'portfinder'
 
-const Koa = require('koa')
-const Router = require('koa-router')
-const bodyParser = require('koa-bodyparser')
-const cors = require('@koa/cors')
-const portfinder = require('portfinder')
+import shops from './shops/index.js'
+import user from './app/index.js'
 
 const app = new Koa()
 const router = new Router()
 app.use(bodyParser())
 app.use(cors())
 
-const shops = require('./shops')
-const user = require('./app')
-
 router.use('/shops', shops.routes())
 router.use('/app', user.routes())
 

faker/index.js

@@ -1,5 +1,5 @@
-const Router = require('koa-router')
-const { Mock, Random } = require('../utils/index')
+import Router from 'koa-router'
+import { Mock, Random } from '../utils/index.js'
 
 const shops = new Router()
 
@@ -28,4 +28,4 @@ const handler = (ctx) => {
 shops.get('/', handler)
 shops.post('/', handler)
 
-module.exports = shops
+export default shops

faker/shops/index.js

@@ -2,4 +2,5 @@ const delay = (time) =>
   new Promise((resolve) => {
     setTimeout(() => resolve(), time)
   })
-module.exports = delay
+
+export default delay

faker/utils/delay.js

@@ -1,8 +1,4 @@
-const delay = require('./delay')
-const { Mock, Random } = require('./mock')
+import delay from './delay.js'
+import { Mock, Random } from './mock.js'
 
-module.exports = {
-  Mock,
-  Random,
-  delay,
-}
+export { Mock, Random, delay }

faker/utils/index.js

@@ -2,8 +2,9 @@
 // https://www.npmjs.com/package/faker
 // https://www.npmjs.com/package/better-mock
 
+import { createRequire } from 'module'
+const require = createRequire(import.meta.url)
 const Mock = require('better-mock')
-
 const { Random } = Mock
 Random.extend({
   mobile() {
@@ -16,7 +17,4 @@ Random.extend({
   },
 })
 
-module.exports = {
-  Mock,
-  Random,
-}
+export { Mock, Random }