{items.map((c, idx) => (
0 ? { borderTop: `1px solid ${colors.bgTertiary}` } : undefined}>
{/* ... */}
))}
```
方案 B 跟项目 token 体系（动态颜色）更兼容，方案 A 适合静态颜色。
---
## 4. `isomorphic-dompurify` + Turbopack 构建炸
### 现象
`'use client'` 组件用 `isomorphic-dompurify` sanitize HTML，`npm run build` 直接挂：
```
FATAL: An unexpected Turbopack error occurred.
TurbopackInternalError: NftJsonAsset: cannot handle filepath node:worker_threads
```
### 根因
`isomorphic-dompurify` 的 SSR 支持通过引入 `jsdom` 模拟 DOM。`jsdom` 依赖 Node 内置 `node:worker_threads`。**Turbopack（next 16.0.x）不处理 `node:` 协议导入**，构建直接 panic。
### 修法
`'use client'` 组件不需要"同构"——SSR 阶段不执行编辑器初始化。改用纯浏览器版 `dompurify`：
```bash
npm uninstall isomorphic-dompurify
npm install dompurify @types/dompurify
```
```ts
// 之前
import DOMPurify from 'isomorphic-dompurify';
// 之后（同样 API）
import DOMPurify from 'dompurify';
```
### 选择矩阵
| 场景 | 选择 |
|---|---|
| `'use client'` 组件 / 浏览器侧调用 | `dompurify`（纯浏览器版）|
| SSR / build-time sanitize / Node 脚本 | `sanitize-html` 或 server-side `dompurify` + `jsdom`（**注意 Turbopack 兼容**）|
| 需要"同构" + 已锁 Webpack（不 Turbopack）| `isomorphic-dompurify` 可用 |
---
## 5. 表单设计器新字段类型必改 4 处，少一处 schema 缺 `type`
### 现象
`frontend/src/features/forms/components/designer/types.ts` 的 `FieldType` 联合类型枚举 30+ 字段，但 `toJSONSchema()` 函数的 switch 只覆盖一部分。漏掉的字段（rating / serialNumber / address / region / cascade / signature / richtext）序列化时落入默认分支，**`fieldSchema.type` 始终 undefined**。前端 `FormFieldRenderer` 拿到 `type: undefined` 走 fallback 显示"不支持的字段类型: undefined"。
### 为什么是 trap
- TS 联合类型本身**不强制** switch 覆盖所有 case（除非用 `never` 兜底做 exhaustiveness check）
- 设计器里这些字段**有图标、能拖拽、能配置**——看起来"已实现"
- 后端 JSONB 不校验 schema，submit 照样落库
- 唯一暴露处是 renderer fallback 字符串
### 修复模式：新字段类型必改 4 处
实现一个新字段类型必须**4 层都改**：
1. **`toJSONSchema()` switch**（`types.ts ~815 行`）：emit `type` + 必要的 `format` / `x-*` 元数据
2. **`widgetMap`**（`types.ts ~1049 行`）：把 FieldType 映射到 `ui:widget` 字符串
3. **`parseFieldFromSchema()`**（`types.ts ~1242 行`）：反向识别 widget → FieldType，否则保存后再打开设计器会丢字段
4. **`FormFieldRenderer.tsx`**：根据 `type` + `widget` 加渲染分支
**漏第 3 步的症状**：设计器保存后再打开，原本 rating 字段变成 number、signature 变成 textarea。
### 防御建议
`toJSONSchema()` 的 default 分支加 exhaustiveness check：
```ts
default:
// 触发 TS error 当未覆盖的 FieldType 加入
const _exhaustive: never = field.type as never;
console.warn(`[toJSONSchema] unhandled field type: ${field.type}`);
```
或维护 `Record