commit 72352657491d4c60d535402d91917de060adc638
Author: fanhongcai <fanhongcai@bbitcn.net>
Date:   Sat Aug 15 15:27:02 2026 +0800

    init: F9智慧缫丝系统 - 后端(server) + 主前端(web) + 打印设计器(openprint) 首次提交

diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..e5f8403
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,32 @@
+# ===== 敏感文件 =====
+token.txt
+*.token
+zk_out.json
+
+# ===== 运行时缓存 =====
+f9mes_cache.db
+*.db
+
+# ===== 本地工具 / 临时 =====
+.playwright-cli/
+
+# ===== Node =====
+node_modules/
+dist/
+dist-ssr/
+*.local
+
+# ===== .NET =====
+bin/
+obj/
+*.user
+
+# ===== 日志 =====
+*.log
+logs/
+
+# ===== 系统 =====
+.DS_Store
+Thumbs.db
+.idea/
+.vscode/
diff --git a/AI开发日志/2026-08-15.md b/AI开发日志/2026-08-15.md
new file mode 100644
index 0000000..8240959
--- /dev/null
+++ b/AI开发日志/2026-08-15.md
@@ -0,0 +1,135 @@
+# F9 智慧缫丝系统 —— CodeBuddy 持续工作存档
+
+> 本文件为 CodeBuddy 开发日志归档（每日一份），归档日期：2026-08-15。
+> 新对话开始后：先读本文件 + `功能清单` + `项目说明`，按「任务状态」继续推进，无需重新调研。
+
+最后更新：2026-08-15
+
+---
+
+## 一、任务状态总览（按用户约定的优先级 1→2→3）
+
+| 序号 | 任务 | 状态 | 说明 |
+|---|---|---|---|
+| 1 | 通用打印接入主前端 | 🔄 **进行中（方案已定，代码未写）** | 三步：后端取行数据接口 → openprint 外部打印模式 → web 打印按钮 |
+| 2 | 简易工作流（采购/领料审批闭环） | ⏳ 待做 | 4 张表已有，缺服务+API+前端审批 UI |
+| 3 | 专业业务逻辑（自动定级/能耗分摊/成本盈亏/断料预警） | ⏳ 待做 | 依赖任务 1/2 部分能力 |
+
+已完成的里程碑：
+- ✅ 动态 CRUD 体系（后端 EntityCatalog + CrudService + DataController，前端 CrudPage + table-map 配置驱动）
+- ✅ openprint 打印设计器全链路（模板设计→数据源内省→预览/打印，推 PDF 到本地客户端）
+- ✅ 工作台接真实数据（WorkBenchController + workbench/index.vue 重写）
+
+---
+
+## 二、项目架构速查
+
+### 2.1 三端结构
+| 端 | 目录 | 技术栈 | 端口 | 说明 |
+|---|---|---|---|---|
+| PC 前端 | `web/` | Vue3 + Element Plus + ECharts + Pinia | vite dev 5173 | 代理 `/api` → localhost:5136 |
+| 后端 | `server/` | .NET 10 + FreeSql (v3.5.311) | 5136 | MySQL 云库 `f9web`（116.198.221.105） |
+| 打印设计器 | `openprint/` | Vue3 + Naive UI + Vite | 5227 | 对接 F9 的 `PrintApiController`，推 PDF(base64) 到本地客户端 `127.0.0.1:18888` |
+| 电视大屏 / 小程序 | — | — | — | 未开始（按项目说明先完成 PC 端） |
+
+### 2.2 后端关键约定
+- **表命名**：模块前缀 + 下划线，如 `CRM_Customer`、`RawMaterial_Instock`、`Common_Workflow`、`RepCenter_ReportDesign`；实体类同前缀，如 `RawMaterial_Instock`。
+- **默认字段**：`id`、`flag`（0=删除，>0 有效，<0 无效，-1=作废）、`addtime`、`adder`、`updatetime`、`updater`、`memo`。
+- **序列化**：`Program.cs` 全局 CamelCase + 忽略 null（即 C# 属性 `OrderNo` → JSON `orderNo`）。
+- **响应信封**：普通 API 用 `ApiResult`；**`PrintApiController`（`api/print`）返回裸 JSON** `{items,total}`（openprint 的 http-client 已按此解析，主前端 axios 也可透传）。
+- **动态查询**：`DataController` 用 `EntityCatalog`（表名→实体 Type 反射映射）+ `CrudService<T>` 泛型反射调用，`GetList/GetById/Add/Update/Delete` 等通用接口。
+- **工作流表**（已有，未做服务）：`Common_Workflow`（流程定义）/ `Common_WorkflowNode`（节点）/ `Common_WorkflowInstance`（实例）/ `Common_WorkflowTask`（任务，`Status==0` 待办、`UserId` 当前处理人）。
+
+### 2.3 web 前端关键约定
+- **Token 存储**：localStorage key = **`f9mes_token`**（`web/src/stores/user.js` 的 `TOKEN_KEY`）。
+- **API 封装**：`web/src/api/request.js`（axios 拦截器注入 Bearer）；`web/src/api/index.js` 集中导出（含已新增的 `getWorkBenchSummary`）。
+- **配置驱动 CRUD**：`web/src/config/table-map.js` 定义每张表的列/表单配置，`web/src/components/CrudPage.vue` 是通用页面组件，菜单由 `InitDataService` 生成。
+
+### 2.4 openprint 关键约定
+- **对接开关**：`openprint/src/main.ts` 仅当配置 `VITE_OPENPRINT_API_BASE` 时才切换云端仓库（HttpRepository/HttpDataSource）；`.env` 中配 `VITE_OPENPRINT_API_BASE` + `VITE_OPENPRINT_API_TOKEN`。
+- **HttpClient token**：构造时静态传入（`http-client.ts` 的 `HttpOptions.token`），**构造后不可变**；若改运行时 token 需改构造时机或加 setter。
+- **绑定 Path 约定**：后端 `PrintService.BuildFields` 生成 `Path = "{TableId}.{PropName}"`（如 `RawMaterial_Instock.OrderNo`）；openprint 的 `expression.ts`/`data-binder.ts` 按路径取值。**注意**：序列化后 JSON 为 camelCase，而 Path 是 PascalCase，取值器需兼容（大小写不敏感取 key 或按 camelCase 注入）。
+- **打印出口**：`PrintDialog.vue` 的 `doPrint()`：`store.buildTemplate()` + `buildPreviewData(dsStore.activeFields)` → `buildPrintPayload({template, data})` → 推本地客户端（POST `/print`，`127.0.0.1:18888`）。**当前用假数据**，是接入真实数据的关键改造点。
+- **数据源内省**：`PrintApiController` 的 `data-sources`/`fields` 由 `PrintService` 按实体类前缀分组（ModuleNames 字典），字段缓存 TTL 10 分钟。
+
+---
+
+## 三、任务 1：通用打印接入主前端（进行中）
+
+### 3.1 目标
+表单通用打印：主前端任意 CRUD 列表 → 选中一行 → 选打印模板 → 打开 openprint 用**该行真实数据**打印（针式/A4 均支持，设计器已具备）。
+
+### 3.2 已锁定的三步方案（代码未写，按序实施）
+
+**Step A — 后端：取行数据接口**
+- 位置：`PrintApiController.cs` 新增（或新 controller），路由建议 `GET api/print/data/{table}/{id}`。
+- 实现：基于 `EntityCatalog` 动态取实体 Type → FreeSql 按 `id` 查询单行 → 输出结构匹配绑定 Path：`{ "<TableId>": { "<camelCaseProp>": value, ... } }`（如 `{ "rawMaterial_Instock": { "orderNo": "...", ... } }` 或 PascalCase 表名，需与 PrintService.BuildFields 生成的 Path 前缀一致，建议直接复用 BuildFields 的 TableId）。
+- 返回裸 JSON（同 PrintApiController 风格，走 openprint http-client 的 json() 直接拿对象）。
+
+**Step B — openprint：外部打印模式**
+- 解析 URL 参数：`?print=1&template=<templateId>&table=<tableId>&row=<rowId>&token=<token>`。
+- 启动流程（main.ts 或 App.vue）：检测 `print=1` 时 → 用 URL 的 token（或 localStorage）替换 HttpClient 的 token → 加载模板（designer store `loadTemplate`）→ 调 `api/print/data/{table}/{row}` 拉真实数据 → 注入到 dataSource store 供 `doPrint` 使用（如新增 `externalData` 状态，`PrintDialog.doPrint()` 优先用它替代 `buildPreviewData`）→ 自动打开打印弹窗。
+- 注意：`designer.ts` 有 `loadTemplate({id,name,data})`/`buildTemplate()`/`setRepository()`/`restoreLastTemplate()`；`dataSource.ts` 的 `activeFields` 决定字段列表；只读模式下应隐藏设计工具栏（TopToolbar 需加 `readonly`/`external` 模式判断）。
+- token：主前端 web 存于 localStorage `f9mes_token`，openprint 与 web 同源部署时可直接读；跨端口时用 URL 传 token 更稳（注意 URL 长度与泄露，内网 MES 可接受）。
+
+**Step C — web：CrudPage 打印按钮**
+- `CrudPage.vue` 工具栏加「打印」按钮（选中一行时可用）→ 弹窗列出该表可用模板（调 `api/print/templates` 按 `tableId` 过滤）→ 确认后 `window.open` openprint 打印 URL：`http://localhost:5227/?print=1&template={id}&table={tableName}&row={rowId}&token={token}`。
+- 需要后端提供"按表过滤模板"的能力（`PrintApiController.templates` 若支持 tableId 查询则直接用，否则加参数）。
+
+### 3.3 关键文件清单
+- 后端：`server/src/F9MES.Api/Controllers/PrintApiController.cs`、`server/src/F9MES.Application/Print/PrintService.cs`、`server/src/F9MES.Api/Common/EntityCatalog.cs`、`server/src/F9MES.Api/Controllers/DataController.cs`
+- openprint：`src/main.ts`、`src/App.vue`、`src/config/backend.ts`、`src/repository/http-client.ts`（token 构造点）、`src/design/stores/designer.ts`（loadTemplate）、`src/design/stores/dataSource.ts`、`src/design/modals/PrintDialog.vue`（doPrint）、`src/design/toolbar/TopToolbar.vue`（showPrint 挂载）、`src/design/preview/preview-data.ts`（buildPreviewData）、`src/core/layout-engine/expression.ts` + `data-binder.ts`（取值）
+- web：`src/components/CrudPage.vue`、`src/api/index.js`、`src/config/table-map.js`、`src/stores/user.js`（token）
+
+---
+
+## 四、任务 2：简易工作流（待做）
+
+- 现状：4 张表（Common_Workflow/Node/Instance/Task）已有，`WorkBenchController` 已统计 `Common_WorkflowTask`（Status==0 && UserId==当前用户）为待办。
+- 要做：
+  1. 后端：工作流服务（流程定义 CRUD、节点配置、发起实例、提交/审批/驳回/撤回流转）、API（建议 `api/workflow/...`）。
+  2. 前端：审批中心页面（我的待办、我发起的、流程配置）；在采购单、领料申请等表单接审批。
+  3. 关联：任务 1 打印对审批单据同样适用。
+
+---
+
+## 五、任务 3：专业业务逻辑（待做）
+
+按优先级从高到低建议：
+1. **断料预警**（原料库存超期/不足，工作台预警列表已预留位置）
+2. **自动定级**（Lims 检验数据 → 调用定级标准自动判定生丝等级，标准表需先建/已有则复用）
+3. **能耗分摊**（Enms 抄表 → 按投料量/产量/机台时长分摊到庄口 → 推成本）
+4. **成本盈亏**（BizBoss 生产成本分摊 + 分庄口盈亏统计）
+
+---
+
+## 六、工程实践与坑位（必读）
+
+1. **编译锁定**：后端进程运行时 DLL 被锁，`dotnet build` 会报 MSB3027/MSB3021 → 用 `dotnet build -o build_tmp` 验证编译，完成后删临时目录；**改动后端必须重启服务才生效**。
+2. **FreeSql 陷阱**：非空 DateTime 没有 `.HasValue`；空集合时 `.Where(x => ids.Contains(...))` 会生成非法 SQL，需先 `if (list.Count > 0)` 守卫。
+3. **JSON 大小写**：后端全局 camelCase，openprint 绑定 Path 是 PascalCase，取值需兼容。
+4. **openprint 是独立应用**：改动它用 `npm run dev`（端口 5227）独立调试；主前端 web 是 vite dev（5173）。
+5. 数据库连接（项目说明）：MySQL `116.198.221.105` 库 `f9web` 用户 `f9web`；阿里云 OSS（bbit-f9-web）；天气用 Open-Meteo。
+6. 项目要求：类/文件命名带模块前缀、各模块类放各自文件夹、公共类放 Common；界面 MES 风格、高可配置、表单必须支持打印、表单带简易工作流。
+
+---
+
+## 七、本轮对话已完成的工作（2026-08 中旬）
+
+### 7.1 工作台真实数据（已完成 ✅）
+- 新增 `server/src/F9MES.Api/Controllers/WorkBenchController.cs`：`GET api/workbench/summary`，聚合统计卡（今日产丝=ProHou_Daily.OutputWeight 合计、在线机组=ProQian_Machine 启用且运行、待办=工单+工作流待办、预警数）+ 近 30 天趋势 + 庄口占比 + 待办列表（工单/审批）+ 预警列表。
+- `web/src/api/index.js`：新增 `getWorkBenchSummary`。
+- `web/src/views/workbench/index.vue`：重写，4 统计卡/趋势折线/庄口占比饼图/待办与预警列表全部接真实数据，无数据时占位，保留天气+快捷入口。
+- 已用 `-o build_tmp` 验证编译通过；**需重启后端生效**。
+
+### 7.2 openprint 全链路调研（已完成，结论见第三节）
+已通读：PrintApiController / PrintService / EntityCatalog / DataController / http-repo / http-datasource / http-client / backend.ts / main.ts / App.vue / TopToolbar / PrintDialog / designer store / dataSource store / preview-data / expression / data-binder / CrudPage / table-map / request.js / user store / 两端 vite 配置。结论已沉淀到第三节。
+
+---
+
+## 八、下一步行动（新对话从这里开始）
+
+1. 先读本文件 + `功能清单` + `项目说明`（若工作区未加载）。
+2. 按 **3.2 的 Step A → B → C** 依次实施任务 1（打印接入），每步完成后用 `dotnet build -o build_tmp` / `npm run build` 验证，openprint 与 web 可分别 `npm run dev` 联调。
+3. 完成后再推进任务 2（简易工作流）。
+4. 任何大改动前更新本文件「最后更新」日期与任务状态。
diff --git a/openprint/.gitignore b/openprint/.gitignore
new file mode 100644
index 0000000..368517d
--- /dev/null
+++ b/openprint/.gitignore
@@ -0,0 +1,41 @@
+# Logs
+logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+lerna-debug.log*
+
+node_modules
+.DS_Store
+dist
+dist-ssr
+coverage
+*.local
+参考资料
+.workbuddy
+# Editor directories and files
+.vscode/*
+!.vscode/extensions.json
+.idea
+*.suo
+*.ntvs*
+*.njsproj
+*.sln
+*.sw?
+.vscode
+*.tsbuildinfo
+docs
+.eslintcache
+website
+
+# Cypress
+/cypress/videos/
+/cypress/screenshots/
+
+# Vitest
+__screenshots__/
+
+# Vite
+*.timestamp-*-*.mjs
diff --git a/openprint/.prettierrc.json b/openprint/.prettierrc.json
new file mode 100644
index 0000000..29a2402
--- /dev/null
+++ b/openprint/.prettierrc.json
@@ -0,0 +1,6 @@
+{
+  "$schema": "https://json.schemastore.org/prettierrc",
+  "semi": false,
+  "singleQuote": true,
+  "printWidth": 100
+}
diff --git a/openprint/README.md b/openprint/README.md
new file mode 100644
index 0000000..e68d9fc
--- /dev/null
+++ b/openprint/README.md
@@ -0,0 +1,477 @@
+<p align="center">
+  <img src="screenshots/logo.png" width="120" alt="OpenPrint Logo" />
+</p>
+
+<h1 align="center">OpenPrint</h1>
+
+<p align="center">
+  <strong>开源 Web 打印设计器 · AI 驱动 · 跨平台</strong>
+</p>
+
+<p align="center">
+  <a href="https://github.com/your-repo/open-print/stargazers"><img src="https://img.shields.io/github/stars/your-repo/open-print?style=flat-square&logo=github" alt="Stars" /></a>
+  <a href="https://github.com/your-repo/open-print/releases"><img src="https://img.shields.io/github/v/release/your-repo/open-print?style=flat-square&logo=github" alt="Release" /></a>
+  <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue?style=flat-square" alt="License" /></a>
+  <a href="https://vuejs.org/"><img src="https://img.shields.io/badge/Vue_3-4FC08D?style=flat-square&logo=vue.js&logoColor=white" alt="Vue 3" /></a>
+  <a href="https://www.typescriptlang.org/"><img src="https://img.shields.io/badge/TypeScript-3178C6?style=flat-square&logo=typescript&logoColor=white" alt="TypeScript" /></a>
+  <a href="https://github.com/fabricjs/fabric.js"><img src="https://img.shields.io/badge/Fabric.js-7.x-blue?style=flat-square" alt="Fabric.js" /></a>
+  <a href="https://www.npmjs.com/package/openprint26"><img src="https://img.shields.io/npm/v/openprint26?style=flat-square&logo=npm&logoColor=white" alt="npm" /></a>
+</p>
+
+<p align="center">
+  <a href="#features">功能特性</a> ·
+  <a href="#quick-start">快速开始</a> ·
+  <a href="#ai-assistant">AI 助手</a> ·
+  <a href="#architecture">架构</a> ·
+  <a href="#deploy">部署</a> ·
+  <a href="#faq">FAQ</a>
+</p>
+<br />
+
+**OpenPrint** 是一款开源、零后端依赖的 Web 打印模板可视化设计器。它让用户通过拖拽即可设计快递面单、发票、标签、报表等打印模板，支持 AI 一句话生成、云打印、C++ 桌面客户端静默打印，3 分钟即可对接 ERP 系统。
+
+> 纯前端架构，无需服务器，无需数据库，一个浏览器即可运行。
+
+![设计器界面](screenshots/designer-overview.png)
+*所见即所得的打印模板设计器，拖拽控件、实时预览*
+
+---
+
+## 目录
+
+- [核心亮点](#核心亮点)
+- [功能特性](#功能特性)
+- [快速开始](#快速开始)
+- [AI 助手](#ai-助手)
+- [技术架构](#技术架构)
+- [项目结构](#项目结构)
+- [部署](#部署)
+- [桌面客户端](#桌面客户端)
+- [ERP 对接](#erp-对接)
+- [FAQ](#faq)
+- [贡献指南](#贡献指南)
+- [许可证](#许可证)
+
+---
+
+## 核心亮点
+
+### 🤖 AI 一句话生成模板
+
+告别手动拖拽，直接描述需求即可生成专业打印模板。支持快递面单、物流标签、仓储单据、零售小票等多种场景。
+
+![AI 助手](screenshots/ai-assistant.png)
+*AI 自然语言生成打印模板，一句话完成面单设计*
+
+```
+用户输入："帮我生成一张快递面单，含收件人、寄件人和运单号条码"
+AI 输出： 自动创建模板 → 布局文本控件 → 添加条码 → 一键使用
+```
+
+### ☁️ 云打印
+
+跨地域多门店远程打印，模板统一管理。浏览器直接打印，免装驱动。云端打印队列，断线自动重试，权限管控，打印日志审计。
+
+![云打印](screenshots/cloud-print.jpg)
+*多门店远程打印，模板统一管理，打印队列监控*
+
+### 📊 Web 报表设计
+
+分组表、交叉表、主从表等多级报表结构，支持求和/平均/计数等汇总函数，嵌入柱状图/折线图/饼图，条件格式高亮数据预警，多数据源拼接。
+
+![报表设计](screenshots/report-design.png)
+*分组报表、交叉表、图表，满足复杂数据展示需求*
+
+---
+
+## 功能特性
+
+### 设计器
+
+| 功能 | 说明 |
+|------|------|
+| **控件库** | 文本、图片、矩形、圆形、线条、条码、二维码、表格、富文本、图表 10 种控件 |
+| **拖拽设计** | 所见即所得，自由拖拽 + 吸附对齐 + 标尺辅助 |
+| **多页支持** | 多页设计，每页独立页眉页脚，页间距可调 |
+| **数据绑定** | 支持 JSON / CSV / API 数据源，Mustache 表达式绑定 |
+| **主题切换** | 深色/浅色主题，一键切换 |
+| **模板管理** | 本地存储，模板导入/导出，模板市场 |
+| **实时预览** | 预览数据绑定效果，分页预览 |
+| **导出** | PDF / JPG / SVG / HTML 多格式导出 |
+
+### 打印与对接
+
+- **Web 直接打印** — 浏览器调用系统打印对话框
+- **桌面静默打印** — 配套 C++ Qt 客户端，零弹窗打印
+- **云打印** — 远程门店打印，打印队列管理
+- **ERP 对接** — HTTP API 对接，3 分钟接入
+
+### 技术栈
+
+![Vue 3](https://img.shields.io/badge/Vue_3-4FC08D?style=flat-square&logo=vue.js&logoColor=white)
+![TypeScript](https://img.shields.io/badge/TypeScript-3178C6?style=flat-square&logo=typescript&logoColor=white)
+![Fabric.js](https://img.shields.io/badge/Fabric.js-7.x-blue?style=flat-square)
+![Pinia](https://img.shields.io/badge/Pinia-FFD859?style=flat-square&logo=pinia&logoColor=black)
+![Vite](https://img.shields.io/badge/Vite-646CFF?style=flat-square&logo=vite&logoColor=white)
+![Vitest](https://img.shields.io/badge/Vitest-6E9F18?style=flat-square&logo=vitest&logoColor=white)
+![Naive UI](https://img.shields.io/badge/Naive_UI-2E7D32?style=flat-square)
+![UnoCSS](https://img.shields.io/badge/UnoCSS-333333?style=flat-square&logo=unocss&logoColor=white)
+
+---
+
+## 快速开始
+
+### npm 安装（推荐）
+
+```bash
+# npm
+npm i openprint26
+
+# pnpm
+pnpm add openprint26
+
+# yarn
+yarn add openprint26
+```
+
+#### 在项目中使用
+
+```ts
+import { createApp } from 'vue'
+import OpenPrint from 'openprint26'
+import 'openprint26/dist/style.css'
+
+const app = createApp(App)
+app.use(OpenPrint)
+app.mount('#app')
+```
+
+```vue
+<template>
+  <OpenPrintDesigner />
+</template>
+```
+
+### 从源码运行
+
+```bash
+# 克隆仓库
+git clone https://gitee.com/haiming236/openprint.git
+cd open-print
+
+# 安装依赖
+pnpm install
+
+# 启动开发服务器
+pnpm dev
+
+# 构建生产版本
+pnpm build
+
+# 预览生产构建
+pnpm preview
+```
+
+### 环境要求
+
+- Node.js >= 22.18.0
+- pnpm >= 9.x
+
+### 在线演示
+
+访问 [https://openprint.yy360.space](https://openprint.yy360.space) 在线体验设计器。
+
+---
+
+## AI 助手
+
+OpenPrint 内置 AI 助手，支持自然语言生成打印模板。
+
+### 使用方式
+
+1. **新建模板** — 输入需求描述，AI 自动生成完整模板
+2. **修改当前模板** — 选中控件，让 AI 调整布局或样式
+3. **字段接地** — 自动识别数据字段并绑定到模板控件
+
+### 技术原理
+
+- 基于 LLM 解析用户意图，输出结构化模板描述
+- 内部规范引擎将描述转换为 Fabric.js 控件配置
+- 支持上下文感知，可在已有模板上增量修改
+
+### 支持的场景
+
+- 快递面单（顺丰、京东、邮政等格式）
+- 物流标签（运单号、目的地、重量）
+- 仓储单据（入库单、出库单、盘点单）
+- 零售小票（收银小票、退换货单）
+- 发票（增值税发票、收据）
+- 自定义报表
+
+---
+
+## 技术架构
+
+```
+┌─────────────────────────────────────────────────────────────────┐
+│                       浏览器（Vue 3 SPA）                        │
+│                                                                 │
+│  ┌──────────┐  ┌──────────┐  ┌──────────┐  ┌───────────────┐  │
+│  │ 控制面板  │  │ 属性面板  │  │ 图层面板  │  │  数据源面板   │  │
+│  └────┬─────┘  └────┬─────┘  └────┬─────┘  └──────┬────────┘  │
+│       └──────────────┴─────────────┴───────────────┘           │
+│                           │                                    │
+│  ┌──────────────────────────────────────────────────────────┐  │
+│  │                    Fabric.js Canvas                       │  │
+│  │  文本 │ 图片 │ 条码 │ 二维码 │ 表格 │ 图表 │ 矩形 │ 圆形 │  │
+│  └──────────────────────────────────────────────────────────┘  │
+│                           │                                    │
+│  ┌──────────────────────────────────────────────────────────┐  │
+│  │                    排版引擎 (Layout Engine)               │  │
+│  │  数据绑定 │ 表达式计算 │ 分页引擎 │ 表格引擎 │ 分组引擎  │  │
+│  └──────────────────────────────────────────────────────────┘  │
+│                           │                                    │
+│  ┌──────────────────────────────────────────────────────────┐  │
+│  │                    渲染引擎 (Renderer)                    │  │
+│  │  HTML渲染 │ PDF导出 │ JPG导出 │ SVG导出 │ 头部渲染     │  │
+│  └──────────────────────────────────────────────────────────┘  │
+└─────────────────────────────────────────────────────────────────┘
+                             │
+                    ┌────────┴────────┐
+                    ▼                 ▼
+           ┌──────────────┐  ┌──────────────┐
+           │ C++ Qt 客户端 │  │ 云打印服务    │
+           │ 静默打印      │  │ 远程打印      │
+           │ 本地打印机    │  │ 队列管理      │
+           └──────────────┘  └──────────────┘
+```
+
+### 核心模块
+
+| 模块 | 路径 | 说明 |
+|------|------|------|
+| **设计器** | `src/design/` | Canvas 设计器、控件系统、面板、工具栏 |
+| **排版引擎** | `src/core/layout-engine/` | 数据绑定、分页、表格、分组、表达式 |
+| **渲染引擎** | `src/core/renderer-html/` | HTML 渲染、CSS 生成、富文本渲染 |
+| **导出引擎** | `src/core/export-engine/` | PDF、JPG、SVG 导出 |
+| **AI 助手** | `src/ai/` | AI 生成模板、上下文管理 |
+| **控件库** | `src/design/canvas/controls/` | 10 种 Fabric.js 控件 |
+
+---
+
+## 项目结构
+
+```
+open-print/
+├── src/
+│   ├── ai/                        # AI 助手（生成/规范化/客户端）
+│   ├── core/                      # 核心引擎
+│   │   ├── layout-engine/         # 排版引擎（数据绑定/分页/表格/分组）
+│   │   ├── renderer-html/         # HTML 渲染器
+│   │   ├── export-engine/         # 导出引擎（PDF/JPG/SVG）
+│   │   ├── chartkit/              # 图表渲染（柱状图/折线图/饼图）
+│   │   ├── fonts/                 # 字体加载与管理
+│   │   ├── headless/              # 无头渲染
+│   │   ├── spec/                  # 模板规范与校验
+│   │   └── sdk/                   # SDK 封装
+│   ├── design/                    # 设计器界面
+│   │   ├── canvas/                # Canvas 画布 & 控件
+│   │   ├── panels/                # 属性/图层/数据源面板
+│   │   ├── preview/               # 预览面板
+│   │   ├── toolbar/               # 顶部工具栏
+│   │   ├── modals/                # 模态框（导入/导出/设置）
+│   │   └── stores/                # Pinia 状态管理
+│   ├── repository/                # 数据仓库（本地/HTTP/模拟）
+│   ├── types/                     # TypeScript 类型定义
+│   ├── config/                    # 配置（打印设置/AI 设置）
+│   ├── theme/                     # 主题系统
+│   └── utils/                     # 工具函数
+├── website/                       # 宣传官网
+├── dist/                          # 构建输出
+├── public/                        # 静态资源
+└── docs/                          # 文档
+```
+
+---
+
+## 部署
+
+### 静态部署
+
+构建产物为纯静态文件，可部署到任何 HTTP 服务器：
+
+```bash
+pnpm build
+# 将 dist/ 目录部署到 Nginx / Apache / Vercel / Netlify 等
+```
+
+### Nginx 配置示例
+
+```nginx
+server {
+    listen 80;
+    server_name your-domain.com;
+    root /path/to/open-print/dist;
+    index index.html;
+
+    location / {
+        try_files $uri $uri/ /index.html;
+    }
+}
+```
+
+### Docker 部署
+
+```dockerfile
+FROM nginx:alpine
+COPY dist/ /usr/share/nginx/html
+COPY nginx.conf /etc/nginx/conf.d/default.conf
+EXPOSE 80
+```
+
+---
+
+## 桌面客户端
+
+OpenPrint 提供配套的 **C++ Qt 桌面打印客户端**，支持：
+
+- **静默打印** — 接收设计器模板，直接发送到本地打印机，零弹窗
+- **批量打印** — 支持 CSV/JSON 数据批量渲染与打印
+- **本地打印机管理** — 获取打印机列表、状态监控
+- **HTTP 接口** — 通过 REST API 接收打印任务
+- **跨平台** — Windows / Linux / macOS
+
+![桌面客户端](screenshots/desktop-client.jpg)
+*C++ Qt 桌面客户端，静默打印，批量处理*
+
+### 技术栈
+
+![C++](https://img.shields.io/badge/C++-17-00599C?style=flat-square&logo=cplusplus&logoColor=white)
+![Qt](https://img.shields.io/badge/Qt-6.x-41CD52?style=flat-square&logo=qt&logoColor=white)
+![CMake](https://img.shields.io/badge/CMake-064F8C?style=flat-square&logo=cmake&logoColor=white)
+
+---
+
+## ERP 对接
+
+OpenPrint 提供标准 HTTP API，3 分钟即可完成 ERP 对接：
+
+### 对接流程
+
+1. **设计模板** — 在 Web 设计器中拖拽生成打印模板
+2. **导出模板文件** — 导出 `.json` 模板文件
+3. **API 对接** — ERP 系统通过 HTTP 推送数据 + 模板 ID，触发打印
+
+![ERP 对接](screenshots/erp-integration.jpg)
+*标准 HTTP API 对接，3 分钟接入 ERP 系统*
+
+### API 示例
+
+```http
+POST /api/print
+Content-Type: application/json
+
+{
+  "template_id": "waybill-001",
+  "data": {
+    "sender_name": "张三",
+    "sender_phone": "13800138000",
+    "receiver_name": "李四",
+    "receiver_address": "北京市朝阳区..."
+  },
+  "printer": "local-printer-01",
+  "copies": 1
+}
+```
+
+---
+
+## FAQ
+
+### 如何安装 OpenPrint？
+
+```bash
+npm i openprint26
+```
+
+详细用法见 [快速开始](#快速开始) 章节。
+
+### OpenPrint 需要后端服务吗？
+
+不需要。OpenPrint 是纯前端应用，零后端依赖。模板存储在浏览器本地（IndexedDB），AI 功能通过直接调用 LLM API 实现。如需对接打印机或 ERP，可部署可选的桌面客户端。
+
+### 支持哪些浏览器？
+
+Chrome / Edge / Firefox / Safari 等现代浏览器。推荐使用 Chromium 内核浏览器以获得最佳体验。
+
+### 如何自定义字体？
+
+将字体文件（`.ttf` / `.woff2`）放入 `public/fonts/` 目录，并在 `src/core/fonts/catalog.ts` 中注册即可。
+
+### 支持批量打印吗？
+
+支持。通过 CSV/JSON 数据源 + 模板引擎，可批量生成多页文档并导出或打印。桌面客户端支持批量静默打印。
+
+### 如何导出模板与他人分享？
+
+使用模板导出功能导出 `.json` 文件，其他人可通过导入功能加载使用。也支持 URL 编码分享（零后端）。
+
+---
+
+## 贡献指南
+
+欢迎贡献代码、提交 Issue 或建议！
+
+### 开发流程
+
+1. Fork 本仓库
+2. 创建特性分支 (`git checkout -b feature/amazing-feature`)
+3. 提交更改 (`git commit -m 'feat: add amazing feature'`)
+4. 推送到分支 (`git push origin feature/amazing-feature`)
+5. 提交 Pull Request
+
+### 提交规范
+
+本项目使用 [Conventional Commits](https://www.conventionalcommits.org/) 规范：
+
+- `feat:` 新功能
+- `fix:` 修复
+- `docs:` 文档变更
+- `refactor:` 重构
+- `test:` 测试
+- `chore:` 构建/工具变更
+
+### 开发命令
+
+```bash
+# 运行测试
+pnpm vitest
+
+# 类型检查
+pnpm type-check
+
+# 格式化代码
+pnpm format
+
+# 代码覆盖率
+pnpm vitest --coverage
+```
+
+---
+
+## 许可证
+
+[GPL3.0 License](LICENSE)
+
+Copyright (c) 2025 OpenPrint
+
+---
+
+<p align="center">
+  <b>OpenPrint</b> — 让打印变得简单高效
+</p>
+<p align="center">
+  <a href="https://github.com/haiming236/openprint">GitHub</a> ·
+  <a href="https://gitee.com/haiming236/openprint">Gitee</a> ·
+  <a href="https://openprint.yy360.space">在线演示</a>
+</p>
diff --git a/openprint/env.d.ts b/openprint/env.d.ts
new file mode 100644
index 0000000..1c055af
--- /dev/null
+++ b/openprint/env.d.ts
@@ -0,0 +1,12 @@
+/// <reference types="vite/client" />
+
+interface ImportMetaEnv {
+  /** 后端基地址，如 https://print.example.com；配置后设计器切云端仓库（§4） */
+  readonly VITE_OPENPRINT_API_BASE?: string
+  /** 可选：Bearer 鉴权 token */
+  readonly VITE_OPENPRINT_API_TOKEN?: string
+}
+
+interface ImportMeta {
+  readonly env: ImportMetaEnv
+}
diff --git a/openprint/index.html b/openprint/index.html
new file mode 100644
index 0000000..47809f8
--- /dev/null
+++ b/openprint/index.html
@@ -0,0 +1,13 @@
+<!DOCTYPE html>
+<html lang="zh-CN">
+  <head>
+    <meta charset="UTF-8">
+    <link rel="icon" href="/favicon.ico">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>OpenPrint 设计器</title>
+  </head>
+  <body>
+    <div id="app"></div>
+    <script type="module" src="/src/main.ts"></script>
+  </body>
+</html>
diff --git a/openprint/overview.md b/openprint/overview.md
new file mode 100644
index 0000000..975bd12
--- /dev/null
+++ b/openprint/overview.md
@@ -0,0 +1,140 @@
+# OpenPrint 图表三修：矢量 PDF + 饼图空白 + 标签对齐
+
+> 承接上轮「原生 SVG 图表组件」（chartkit + PrintChart + ChartViewLayer + data-binder 接入 + ChartProps）。本轮修复/增强三件事。
+
+## 1. PDF 图表走矢量（svg2pdf）
+**之前**：整页 HTML 经 `foreignObject` 栅格化成 PNG 再 `addImage` → 图表是位图，放大发虚。
+**现在**：混合矢量导出（`src/core/export-engine/export-pdf.ts`）
+- 每页先 `stripCharts(page)` 剥离 chart 控件 → 栅格化（文本/表格位图底图）→ `addImage` 作背景；
+- 再遍历该页 chart 节点，用 `svg2pdf` 把其 SVG 以**矢量**注入 jsPDF 对应 mm 盒（`x/y/width/height`）。
+- **思源宋体矢量文本**：`/fonts/SourceHanSerifCN-Regular.ttf`（1.0M 子集）注册进 jsPDF 为 `SourceHanSerifCN`；chartkit 三个渲染器 SVG 根 `font-family` 改为 `'SourceHanSerifCN','PingFang SC',...` 优先。
+- **三重兜底**：图表旋转 → 整页退回全栅格化；单图 svg2pdf 失败 → 该图单独栅格化兜底；字体加载失败 → 整页退回全栅格化。非图表页行为不变。
+
+## 2. 饼图中间空白（bug 修复）
+**根因**：`chartkit/core.ts` 的 `arcPath` 实心饼画成 `M start A end Z`（圆弧+弦 = 圆缺段），楔形不到圆心 → 中间空白。
+**修复**：实心饼改为 `M cx cy L start A end Z`（真正到达圆心的楔形）；环形保持外弧+内弧环形扇区；360° 整圆特例用两段半圆弧。新增回归测试：饼图 path 必须含圆心坐标。
+
+## 3. 标签默认对齐（功能）
+- `ChartOptions` 新增 `labelAlign?: 'left' | 'center' | 'right'`，**默认 `left`**（解决"下面的标签默认都居中"）。
+- `chartkit/core.ts` 新增 `legendStartX` / `xAxisLabelPos` 两个 helper：`bar/line` 的 x 轴类目标签、`bar/line/pie` 的图例均按 `labelAlign` 对齐（图例居中/右对齐按单行总宽偏移）。
+- `ChartProps.vue` 外观区新增「标签对齐」下拉（左 / 中 / 右）。
+
+## 验证结果
+- `vue-tsc --build`：**0 错误**
+- `vitest`：**249 测全绿**（chartkit 11 + 原有 238）
+- `vite build`：**成功**（`pdf` chunk 因并入 svg2pdf.js 由 400→487kB，属动态加载导出包，无害）
+- `vite` dev server：HTTP 200
+
+## ⚠️ 验证缺口（需在真实浏览器确认）
+svg2pdf 的矢量渲染、中文 TTF 注入、旋转页回退逻辑**无法在本环境（happy-dom）验证**——`export-pdf.spec.ts` 只 mock 栅格化层以验证 jsPDF 装配。请用户在 Chromium 中实际导出含图表的 PDF，确认：
+1. 图表在 PDF 中随缩放保持清晰（矢量）；
+2. 中文标签正常显示（非方块/空白）；
+3. 含旋转图表的页面正确回退为位图且不丢图。
+
+---
+
+# 导出/打印空白纸修复
+
+## 问题
+用户反馈：导出 PDF、推送本地打印都是空白纸。
+
+## 根因
+`src/core/renderer-html/css-generator.ts` 的 `tableCss()` 里有一段 CSS 注释包含未转义的 `<table>` 字符串：
+
+```css
+/* ---------- 表格样式预设（Excel 式快速切换；class 由渲染端挂在 <table> 上） ---------- */
+```
+
+导出/打印时，整页 CSS 被塞进 SVG 的 `<style>` 元素中。XML 解析器把注释里的 `<table>` 当成真实的 HTML 开标签，随后遇到 `</style>` 时抛出：
+
+```
+Opening and ending tag mismatch: table line 180 and style
+```
+
+整张 SVG 无法作为 `<img>` 加载，`rasterize.ts` 的 `svgToCanvas` 触发超时/错误兜底，返回**白底空 canvas**，最终 PDF / 打印推送都是白纸。
+
+## 修复
+将注释改为无尖括号的描述：
+
+```css
+/* ---------- 表格样式预设（Excel 式快速切换；class 由渲染端挂在 table 元素上） ---------- */
+```
+
+改动仅一行：`src/core/renderer-html/css-generator.ts`。
+
+## 验证
+- 用真实 Chromium 无头复现修复前：`<img>` 加载 SVG `onerror`，canvas/iframe 空白。
+- 修复后：真实 Chromium 截图显示小票内容完整；`pageToImageBlob` JPEG blob 约 77KB；`documentToPdf` 底层栅格化路径恢复。
+- `vue-tsc --build`：0 错误。
+- `vitest run`：253 passed（31 文件）。
+
+---
+
+# 导出/打印「模糊」修复
+
+## 问题
+空白纸修好后，用户反馈：导出 PDF、本地打印都**模糊**，"之前的版本很清晰"。
+
+## 根因
+`src/core/export-engine/rasterize.ts` 的 `svgToCanvas` 走的是「**低分渲染 + drawImage 插值放大**」：
+
+1. `buildPageSvg` 生成的 SVG 宽高是 96dpi 像素值（58mm 小票仅 **220×454 px**）；
+2. `svgToCanvas` 把这个低分 SVG 渲染成位图 img，再 `drawImage` **放大**到 `×scale` 的 canvas。
+
+`drawImage` 放大只是**像素插值**，不产生任何新细节 —— 文字在 220px 宽上光栅化后被拉伸，边缘发虚。这就是模糊的根源（JPEG 有损进一步放大这种感觉）。
+
+> 关键认知：两种做法的 canvas 尺寸完全相同（都是 440×908），区别只在**内容来源**（插值 vs 原生）。所以单看尺寸测不出来，必须真实浏览器看文字边缘。
+
+## 修复
+新增 `scaleSvgViewport()`：**加载前**把 SVG 根节点的 `width/height` 直接 `×scale`（`viewBox` 不动）。这样 foreignObject 内容以高分辨率**原生渲染**成位图，img 本身就是高分图；canvas 尺寸 = img 尺寸、`drawImage(img, 0, 0)` 不再缩放插值。
+
+改动：`src/core/export-engine/rasterize.ts`（`svgToCanvas` + 新增 `scaleSvgViewport`）。
+
+## scale 决策（保持不变 = 2）
+对照 `scale=2`（76KB / 192dpi）vs `scale=3`（138KB / 288dpi）：修复后两者文字都清晰、差异很小。故**保持 `scale=2` 默认**——清晰度足够且体积友好，不为提 scale 让体积反弹。需要更高清晰度时 `documentToPdf(result,{scale:3})` / 推送 `buildPrintPayload(req,{scale:3})` 可调。
+
+## 验证
+- 真实 Chromium 对照：修复前文字边缘锯齿毛糙，修复后平滑锐利。
+- 真实导出 PDF（`documentToPdf` scale=2 jpeg）落盘 **81301 B**；`pdftoppm` 按 **300 DPI** 渲染后，小票标题/地址/电话/明细/合计全部清晰锐利（见 `临时/pdf-300dpi渲染.png`、`临时/export-test-清晰版.pdf`）。
+- `vue-tsc --build`：0 错误；`vitest run`：253 passed（31 文件）。
+
+---
+
+# 导出/打印清晰度策略：PNG 无损 + 默认最高清 + 移除清晰度选择器
+
+## 问题
+模糊修复后，用户实测仍觉得不如之前清晰；复盘认为「底图从 PNG 切到 JPEG」是主因，要求：
+- 换回 **PNG 无损底图**；
+- 导出/打印默认**最高清**，不要再让用户选清晰度。
+
+## 决策
+1. **底图默认从 JPEG 改回 PNG（无损）**
+   - `export-pdf.ts`、`export-engine/index.ts`、`print-client/payload.ts`、`rasterize.ts` 的默认 `imageType` 统一改为 `'png'`。
+   - 思源宋体仍以 data-URI 内联；PNG 底图对中文/细线/条码边缘无 DCT 伪影。
+2. **默认 scale 从 2（192dpi）提到 3（288dpi·最高清）**
+   - PDF 导出、打印推送、底层 `pageToImageBlob` 的默认 scale 全部提到 `3`。
+   - 程序/headless 仍可传 `scale: 2/4` 覆盖；只是不再暴露 UI 选择。
+3. **移除导出弹窗的「清晰度」选择器**
+   - `ExportDialog.vue` 删除 `scale` ref、`scaleOptions`、`NSelect` 行，以及 `onExport` 里的 `scale` 参数；用户不再面对清晰度选择。
+
+## 文件改动
+- `src/core/export-engine/export-pdf.ts`：默认 `scale=3`、`imageType='png'`；注释更新。
+- `src/core/export-engine/index.ts`：默认 `scale=3`、`pdfImageType='png'`；注释更新。
+- `src/core/export-engine/rasterize.ts`：`pageToImageBlob` 默认 `scale=3`。
+- `src/core/print-client/payload.ts`：默认 `scale=3`、`imageType='png'`。
+- `src/core/print-client/client.ts`、`src/design/modals/PrintDialog.vue`：注释同步为 PNG 无损。
+- `src/design/toolbar/ExportDialog.vue`：移除「清晰度」选择器及 `NSelect` 导入。
+
+## 验证
+- `vue-tsc --build`：**0 错误**
+- `vitest run`：**253 passed（31 文件）**
+- 真实 Chromium 导出：
+  - 收银小票（58mm）默认 PNG scale=3 导出 PDF：**2.57 MB**；
+  - 用 `pdftoppm -r 300` 打印级渲染后文字/条码全部锐利（见 `临时/receipt-300dpi-png-scale3.png`）。
+  - 量化对比（同页同 scale=3）：PNG 拉普拉斯高频能量 / JPEG ≈ **0.998**，说明清晰度的主要决定因素是前一轮的「高分原生渲染」修复；PNG 在此基础上彻底消除 JPEG 的 DCT 块伪影，与「最清晰」目标一致。
+
+## 体积提示
+- PNG 无损清晰度最高，但体积显著大于 JPEG：
+  - 收银小票 PNG scale=3 ≈ 2.6 MB；
+  - 销售出库单/数据报表类 A4 页 PNG scale=3 可达 **20+ MB/页**。
+- 若本地打印客户端对 base64 载荷敏感，可在调用点显式传 `scale: 2` 或 `imageType: 'jpeg'`。
diff --git a/openprint/package-lock.json b/openprint/package-lock.json
new file mode 100644
index 0000000..7d16c99
--- /dev/null
+++ b/openprint/package-lock.json
@@ -0,0 +1,9088 @@
+{
+  "name": "openprint26",
+  "version": "0.0.0",
+  "lockfileVersion": 3,
+  "requires": true,
+  "packages": {
+    "": {
+      "name": "openprint26",
+      "version": "0.0.0",
+      "dependencies": {
+        "@bwip-js/generic": "^4.11.2",
+        "@codemirror/lang-json": "^6.0.2",
+        "@tiptap/extension-font-family": "^3.29.2",
+        "@tiptap/extension-text-style": "^3.29.2",
+        "@tiptap/pm": "^3.29.2",
+        "@tiptap/starter-kit": "^3.29.2",
+        "@tiptap/vue-3": "^3.29.2",
+        "@vueuse/core": "^14.4.0",
+        "ajv": "^8.20.0",
+        "codemirror": "^6.0.2",
+        "dompurify": "^3.4.13",
+        "fabric": "^7.4.0",
+        "json-schema-to-ts": "^3.1.1",
+        "jspdf": "^4.2.1",
+        "mustache": "^4.2.0",
+        "opentype.js": "^2.0.0",
+        "pinia": "^4.0.2",
+        "qrcode": "^1.5.4",
+        "stylis": "^4.4.0",
+        "svg2pdf.js": "^2.7.0",
+        "vue": "^3.5.40",
+        "vue-codemirror6": "^1.6.1",
+        "xlsx": "^0.18.5"
+      },
+      "devDependencies": {
+        "@iconify-json/carbon": "^1.2.25",
+        "@tsconfig/node24": "^24.0.4",
+        "@types/node": "^24.13.3",
+        "@types/qrcode": "^1.5.6",
+        "@vitejs/plugin-vue": "^6.0.8",
+        "@vitest/coverage-v8": "^3.2.4",
+        "@vue/tsconfig": "^0.9.1",
+        "happy-dom": "^20.11.2",
+        "naive-ui": "^2.44.1",
+        "npm-run-all2": "^9.0.2",
+        "prettier": "3.9.5",
+        "typescript": "~6.0.0",
+        "unocss": "^66.7.5",
+        "vite": "^8.1.5",
+        "vite-plugin-vue-devtools": "^8.1.5",
+        "vitest": "^3.2.4",
+        "vue-tsc": "^3.3.7"
+      },
+      "engines": {
+        "node": "^22.18.0 || >=24.12.0"
+      }
+    },
+    "node_modules/@ampproject/remapping": {
+      "version": "2.3.0",
+      "resolved": "https://registry.npmjs.org/@ampproject/remapping/-/remapping-2.3.0.tgz",
+      "integrity": "sha512-30iZtAPgz+LTIYoeivqYo853f02jBYSd5uGnGpkFV0M3xOt9aN73erkgYAmZU43x4VfqcnLxW9Kpg3R5LC4YYw==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@jridgewell/gen-mapping": "^0.3.5",
+        "@jridgewell/trace-mapping": "^0.3.24"
+      },
+      "engines": {
+        "node": ">=6.0.0"
+      }
+    },
+    "node_modules/@antfu/install-pkg": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/@antfu/install-pkg/-/install-pkg-1.1.0.tgz",
+      "integrity": "sha512-MGQsmw10ZyI+EJo45CdSER4zEb+p31LpDAFp2Z3gkSd1yqVZGi0Ebx++YTEMonJy4oChEMLsxZ64j8FH6sSqtQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "package-manager-detector": "^1.3.0",
+        "tinyexec": "^1.0.1"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/antfu"
+      }
+    },
+    "node_modules/@asamuzakjp/css-color": {
+      "version": "3.2.0",
+      "resolved": "https://registry.npmjs.org/@asamuzakjp/css-color/-/css-color-3.2.0.tgz",
+      "integrity": "sha512-K1A6z8tS3XsmCMM86xoWdn7Fkdn9m6RSVtocUrJYIwZnFVkng/PvkEoWtOWmP+Scc6saYWHWZYbndEEXxl24jw==",
+      "license": "MIT",
+      "optional": true,
+      "dependencies": {
+        "@csstools/css-calc": "^2.1.3",
+        "@csstools/css-color-parser": "^3.0.9",
+        "@csstools/css-parser-algorithms": "^3.0.4",
+        "@csstools/css-tokenizer": "^3.0.3",
+        "lru-cache": "^10.4.3"
+      }
+    },
+    "node_modules/@babel/code-frame": {
+      "version": "7.29.7",
+      "resolved": "https://registry.npmjs.org/@babel/code-frame/-/code-frame-7.29.7.tgz",
+      "integrity": "sha512-Aup7aUOfpbAUg2ROOJN6Iw5f9DMBlzu0mIkm/malLQFN/YQgO48wCj0Kxa3sEHJvPVFg7siR+qRInwXd2qhQKw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/helper-validator-identifier": "^7.29.7",
+        "js-tokens": "^4.0.0",
+        "picocolors": "^1.1.1"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      }
+    },
+    "node_modules/@babel/code-frame/node_modules/js-tokens": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/js-tokens/-/js-tokens-4.0.0.tgz",
+      "integrity": "sha512-RdJUflcE3cUzKiMqQgsCu06FPu9UdIJO0beYbPhHN4k6apgJtifcoCtT9bcxOpYBtpD2kCM6Sbzg4CausW/PKQ==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/@babel/compat-data": {
+      "version": "7.29.7",
+      "resolved": "https://registry.npmjs.org/@babel/compat-data/-/compat-data-7.29.7.tgz",
+      "integrity": "sha512-locTkQyKvwIEgBzVrn8693ebc97F2U8ZHjbXwDXJ5Fn2TCpNwTlKcaKLkdHop5c/icOFE7qt7Q9JC5hnKNa6Gg==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=6.9.0"
+      }
+    },
+    "node_modules/@babel/core": {
+      "version": "7.29.7",
+      "resolved": "https://registry.npmjs.org/@babel/core/-/core-7.29.7.tgz",
+      "integrity": "sha512-RgHBCvtjbOK2gXSNBNIkNoEc9qoVEtau3hj8gEqKQuL3HZAibKarWFEI3Lfm6EYKkLalOh8eSrj9b+ch9H/VBA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/code-frame": "^7.29.7",
+        "@babel/generator": "^7.29.7",
+        "@babel/helper-compilation-targets": "^7.29.7",
+        "@babel/helper-module-transforms": "^7.29.7",
+        "@babel/helpers": "^7.29.7",
+        "@babel/parser": "^7.29.7",
+        "@babel/template": "^7.29.7",
+        "@babel/traverse": "^7.29.7",
+        "@babel/types": "^7.29.7",
+        "@jridgewell/remapping": "^2.3.5",
+        "convert-source-map": "^2.0.0",
+        "debug": "^4.1.0",
+        "gensync": "^1.0.0-beta.2",
+        "json5": "^2.2.3",
+        "semver": "^6.3.1"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/babel"
+      }
+    },
+    "node_modules/@babel/core/node_modules/semver": {
+      "version": "6.3.1",
+      "resolved": "https://registry.npmjs.org/semver/-/semver-6.3.1.tgz",
+      "integrity": "sha512-BR7VvDCVHO+q2xBEWskxS6DJE1qRnb7DxzUrogb71CWoSficBxYsiAGd+Kl0mmq/MprG9yArRkyrQxTO6XjMzA==",
+      "dev": true,
+      "license": "ISC",
+      "bin": {
+        "semver": "bin/semver.js"
+      }
+    },
+    "node_modules/@babel/generator": {
+      "version": "7.29.8",
+      "resolved": "https://registry.npmjs.org/@babel/generator/-/generator-7.29.8.tgz",
+      "integrity": "sha512-gZbepsdh3WDtgZKWL+vTPh71LSBrm/Y4/QDZBVCcYfmeTEEuoOYwlSy+G1StfJg+/Zy550u/3TATbm7qDbbMtg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/parser": "^7.29.8",
+        "@babel/types": "^7.29.8",
+        "@jridgewell/gen-mapping": "^0.3.12",
+        "@jridgewell/trace-mapping": "^0.3.28",
+        "jsesc": "^3.0.2"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      }
+    },
+    "node_modules/@babel/helper-annotate-as-pure": {
+      "version": "7.29.7",
+      "resolved": "https://registry.npmjs.org/@babel/helper-annotate-as-pure/-/helper-annotate-as-pure-7.29.7.tgz",
+      "integrity": "sha512-OoK6239jHPuSQOoS0kfTVKn0b/rVTk0seKq4Gd2UMLtmOVLjDC0ki3e+c90Trqv2gMfvJFqkiljrr568+qddiw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/types": "^7.29.7"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      }
+    },
+    "node_modules/@babel/helper-compilation-targets": {
+      "version": "7.29.7",
+      "resolved": "https://registry.npmjs.org/@babel/helper-compilation-targets/-/helper-compilation-targets-7.29.7.tgz",
+      "integrity": "sha512-wem6WaBj4NaVYVdNhLPPVacES6ZJ+KBBfSkTMD3YZxbP3rm3Di85tJU5ljaUNhaOynt+Aj0xruhYuzQBt8n71g==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/compat-data": "^7.29.7",
+        "@babel/helper-validator-option": "^7.29.7",
+        "browserslist": "^4.24.0",
+        "lru-cache": "^5.1.1",
+        "semver": "^6.3.1"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      }
+    },
+    "node_modules/@babel/helper-compilation-targets/node_modules/lru-cache": {
+      "version": "5.1.1",
+      "resolved": "https://registry.npmjs.org/lru-cache/-/lru-cache-5.1.1.tgz",
+      "integrity": "sha512-KpNARQA3Iwv+jTA0utUVVbrh+Jlrr1Fv0e56GGzAFOXN7dk/FviaDW8LHmK52DlcH4WP2n6gI8vN1aesBFgo9w==",
+      "dev": true,
+      "license": "ISC",
+      "dependencies": {
+        "yallist": "^3.0.2"
+      }
+    },
+    "node_modules/@babel/helper-compilation-targets/node_modules/semver": {
+      "version": "6.3.1",
+      "resolved": "https://registry.npmjs.org/semver/-/semver-6.3.1.tgz",
+      "integrity": "sha512-BR7VvDCVHO+q2xBEWskxS6DJE1qRnb7DxzUrogb71CWoSficBxYsiAGd+Kl0mmq/MprG9yArRkyrQxTO6XjMzA==",
+      "dev": true,
+      "license": "ISC",
+      "bin": {
+        "semver": "bin/semver.js"
+      }
+    },
+    "node_modules/@babel/helper-create-class-features-plugin": {
+      "version": "7.29.7",
+      "resolved": "https://registry.npmjs.org/@babel/helper-create-class-features-plugin/-/helper-create-class-features-plugin-7.29.7.tgz",
+      "integrity": "sha512-IY3ZD9Tmooqr3TUhc3DUWxiuo8xx1DWLhd5M7hQ+ZWJamqM2BbalrBJb2MisSLoYorOj75U03qULCxQTY9r3hg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/helper-annotate-as-pure": "^7.29.7",
+        "@babel/helper-member-expression-to-functions": "^7.29.7",
+        "@babel/helper-optimise-call-expression": "^7.29.7",
+        "@babel/helper-replace-supers": "^7.29.7",
+        "@babel/helper-skip-transparent-expression-wrappers": "^7.29.7",
+        "@babel/traverse": "^7.29.7",
+        "semver": "^6.3.1"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      },
+      "peerDependencies": {
+        "@babel/core": "^7.0.0"
+      }
+    },
+    "node_modules/@babel/helper-create-class-features-plugin/node_modules/semver": {
+      "version": "6.3.1",
+      "resolved": "https://registry.npmjs.org/semver/-/semver-6.3.1.tgz",
+      "integrity": "sha512-BR7VvDCVHO+q2xBEWskxS6DJE1qRnb7DxzUrogb71CWoSficBxYsiAGd+Kl0mmq/MprG9yArRkyrQxTO6XjMzA==",
+      "dev": true,
+      "license": "ISC",
+      "bin": {
+        "semver": "bin/semver.js"
+      }
+    },
+    "node_modules/@babel/helper-globals": {
+      "version": "7.29.7",
+      "resolved": "https://registry.npmjs.org/@babel/helper-globals/-/helper-globals-7.29.7.tgz",
+      "integrity": "sha512-3nQVUAtvkKH9zahfWgw96Jc/uFOmjACE1kQz82E2lqWmHBgjzbNlsC22nuQTfahmWeQtTq5nQ/4Nnd2A1wj4zA==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=6.9.0"
+      }
+    },
+    "node_modules/@babel/helper-member-expression-to-functions": {
+      "version": "7.29.7",
+      "resolved": "https://registry.npmjs.org/@babel/helper-member-expression-to-functions/-/helper-member-expression-to-functions-7.29.7.tgz",
+      "integrity": "sha512-j+7JYmk1JYDtACIGj0QJqqWZjoUpMoEikQGADMaHgCMCSDqd2+P32rfcibUNrGOMWrlzK1WJBdxrB3JJQZwWtg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/traverse": "^7.29.7",
+        "@babel/types": "^7.29.7"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      }
+    },
+    "node_modules/@babel/helper-module-imports": {
+      "version": "7.29.7",
+      "resolved": "https://registry.npmjs.org/@babel/helper-module-imports/-/helper-module-imports-7.29.7.tgz",
+      "integrity": "sha512-ejHwrQQYcm9xnTivShn2IDOlIzInN34AXskvq9QicvCtEzq1Vzclu/tKF8Jq1Cg8JG2GL6/EmjgsCT7lXepE3g==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/traverse": "^7.29.7",
+        "@babel/types": "^7.29.7"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      }
+    },
+    "node_modules/@babel/helper-module-transforms": {
+      "version": "7.29.7",
+      "resolved": "https://registry.npmjs.org/@babel/helper-module-transforms/-/helper-module-transforms-7.29.7.tgz",
+      "integrity": "sha512-UPUVSyXbOh627KiCIGQSgwWzGeBKLkaJ9PJEdrngIwMSzxLR4jS4+f1f1jb7VzBbg8nFLaYotvVPFCTqdrmTAg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/helper-module-imports": "^7.29.7",
+        "@babel/helper-validator-identifier": "^7.29.7",
+        "@babel/traverse": "^7.29.7"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      },
+      "peerDependencies": {
+        "@babel/core": "^7.0.0"
+      }
+    },
+    "node_modules/@babel/helper-optimise-call-expression": {
+      "version": "7.29.7",
+      "resolved": "https://registry.npmjs.org/@babel/helper-optimise-call-expression/-/helper-optimise-call-expression-7.29.7.tgz",
+      "integrity": "sha512-+kmGVjcT9RGYzoDwdwEqEvGgKe3BYq+O1iGzjFubaNgZHwYHP6lsF2Yghf4kEuv9BV7tYDZ913aBW9am6YKong==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/types": "^7.29.7"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      }
+    },
+    "node_modules/@babel/helper-plugin-utils": {
+      "version": "7.29.7",
+      "resolved": "https://registry.npmjs.org/@babel/helper-plugin-utils/-/helper-plugin-utils-7.29.7.tgz",
+      "integrity": "sha512-G7sHYigPY17oO5SYWnfD/0MTBwVR781S/JI643e/JhUYgVgWE/61SoW3NH9KWUKyKq5LVh3npif99Wkt6j86Jw==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=6.9.0"
+      }
+    },
+    "node_modules/@babel/helper-replace-supers": {
+      "version": "7.29.7",
+      "resolved": "https://registry.npmjs.org/@babel/helper-replace-supers/-/helper-replace-supers-7.29.7.tgz",
+      "integrity": "sha512-atfGXWSeCiF4DnKZIfmJfQRkSw9b9gNNXR1kqKjbhG4pGYCOnkp8OcTB8E3NXjBu8NpheSnOeNKz8KT7UNFTmQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/helper-member-expression-to-functions": "^7.29.7",
+        "@babel/helper-optimise-call-expression": "^7.29.7",
+        "@babel/traverse": "^7.29.7"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      },
+      "peerDependencies": {
+        "@babel/core": "^7.0.0"
+      }
+    },
+    "node_modules/@babel/helper-skip-transparent-expression-wrappers": {
+      "version": "7.29.7",
+      "resolved": "https://registry.npmjs.org/@babel/helper-skip-transparent-expression-wrappers/-/helper-skip-transparent-expression-wrappers-7.29.7.tgz",
+      "integrity": "sha512-brcMGQaVzIeUb+6/bs1Av0f8YuNNjKY2JyvfRCsFuFsdKccEQ5Ges2y74D74NZ1Rz8lKJ9ksJkfqwQFJ/iNEyQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/traverse": "^7.29.7",
+        "@babel/types": "^7.29.7"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      }
+    },
+    "node_modules/@babel/helper-string-parser": {
+      "version": "7.29.7",
+      "resolved": "https://registry.npmjs.org/@babel/helper-string-parser/-/helper-string-parser-7.29.7.tgz",
+      "integrity": "sha512-Pb5ijPrZ89GDH8223L4UP8i6QApWxs04RbPQJTeWDV0/keR2E36MeKnyr6LYmUUvqRRI+Iv87SuF1W6ErINzYw==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=6.9.0"
+      }
+    },
+    "node_modules/@babel/helper-validator-identifier": {
+      "version": "7.29.7",
+      "resolved": "https://registry.npmjs.org/@babel/helper-validator-identifier/-/helper-validator-identifier-7.29.7.tgz",
+      "integrity": "sha512-qehxGkRj55h/ff8EMaJ+cYhyaKlHIxqYDn682wQD7RNp9UujOQsHog2uS0r2vzr4pW+sXf90NeeayjcNaX3fFg==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=6.9.0"
+      }
+    },
+    "node_modules/@babel/helper-validator-option": {
+      "version": "7.29.7",
+      "resolved": "https://registry.npmjs.org/@babel/helper-validator-option/-/helper-validator-option-7.29.7.tgz",
+      "integrity": "sha512-N9ZErrD+yW5geCDtBqnOoxmR8+tNKiGuxKlDpuJxfsqpa2dFcexaziGAE/qoHLiDDreVNMupxGmSoNlyvsA3gw==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=6.9.0"
+      }
+    },
+    "node_modules/@babel/helpers": {
+      "version": "7.29.7",
+      "resolved": "https://registry.npmjs.org/@babel/helpers/-/helpers-7.29.7.tgz",
+      "integrity": "sha512-1k2lAGRMfHTcwuNYcCNUmaUffmQv8KWMfh2iJUUeRlwlwH4FdNG7mfPI10NPfLHJFThE4Tyr4mv7kTNZOiPuBg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/template": "^7.29.7",
+        "@babel/types": "^7.29.7"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      }
+    },
+    "node_modules/@babel/parser": {
+      "version": "7.29.8",
+      "resolved": "https://registry.npmjs.org/@babel/parser/-/parser-7.29.8.tgz",
+      "integrity": "sha512-E8lTAYNB1KW+FH+VGJuZM1ioAx2E6oVlvQFRrf5P8ZZmsiJXYAD9vTFV7yyEURNzgh1dFqMZuO6tUwcARbqFCA==",
+      "license": "MIT",
+      "dependencies": {
+        "@babel/types": "^7.29.8"
+      },
+      "bin": {
+        "parser": "bin/babel-parser.js"
+      },
+      "engines": {
+        "node": ">=6.0.0"
+      }
+    },
+    "node_modules/@babel/plugin-proposal-decorators": {
+      "version": "7.29.7",
+      "resolved": "https://registry.npmjs.org/@babel/plugin-proposal-decorators/-/plugin-proposal-decorators-7.29.7.tgz",
+      "integrity": "sha512-EtU0Hi3GvrTqD56xKmZvV/uCXK2ZbwVNPNLAquVItcAZpUhkXwWlo3Fmj0c2LxgSf2I8IDULeAepwNP1OefLXg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/helper-create-class-features-plugin": "^7.29.7",
+        "@babel/helper-plugin-utils": "^7.29.7",
+        "@babel/plugin-syntax-decorators": "^7.29.7"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      },
+      "peerDependencies": {
+        "@babel/core": "^7.0.0-0"
+      }
+    },
+    "node_modules/@babel/plugin-syntax-decorators": {
+      "version": "7.29.7",
+      "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-decorators/-/plugin-syntax-decorators-7.29.7.tgz",
+      "integrity": "sha512-9MTTLbF39X6sqM92JPEsoI7++26hjZvzkxKZy64aMhWLH2mPkJ/Q3AV4QLmls3R14FpSpkOwQQfUh962JGQxxg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/helper-plugin-utils": "^7.29.7"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      },
+      "peerDependencies": {
+        "@babel/core": "^7.0.0-0"
+      }
+    },
+    "node_modules/@babel/plugin-syntax-import-attributes": {
+      "version": "7.29.7",
+      "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-import-attributes/-/plugin-syntax-import-attributes-7.29.7.tgz",
+      "integrity": "sha512-zGYcYfq/WmZ4V+kBIXQon9dSSc8ircGZqw9ZaNhhGj9nZkeBu1jHLBDQqYYi5WA9uawvA2sIMbry2nCFhf5Djg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/helper-plugin-utils": "^7.29.7"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      },
+      "peerDependencies": {
+        "@babel/core": "^7.0.0-0"
+      }
+    },
+    "node_modules/@babel/plugin-syntax-import-meta": {
+      "version": "7.10.4",
+      "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-import-meta/-/plugin-syntax-import-meta-7.10.4.tgz",
+      "integrity": "sha512-Yqfm+XDx0+Prh3VSeEQCPU81yC+JWZ2pDPFSS4ZdpfZhp4MkFMaDC1UqseovEKwSUpnIL7+vK+Clp7bfh0iD7g==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/helper-plugin-utils": "^7.10.4"
+      },
+      "peerDependencies": {
+        "@babel/core": "^7.0.0-0"
+      }
+    },
+    "node_modules/@babel/plugin-syntax-jsx": {
+      "version": "7.29.7",
+      "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-jsx/-/plugin-syntax-jsx-7.29.7.tgz",
+      "integrity": "sha512-TSu8+mHCoEaaCDEZ0I3+6mvTBYR4PCxQwf2z9/r5Tbztv6NaLR3B9thGTTxX2WGuGHJqRiAbKPeGTJ5XWXVg6A==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/helper-plugin-utils": "^7.29.7"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      },
+      "peerDependencies": {
+        "@babel/core": "^7.0.0-0"
+      }
+    },
+    "node_modules/@babel/plugin-syntax-typescript": {
+      "version": "7.29.7",
+      "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-typescript/-/plugin-syntax-typescript-7.29.7.tgz",
+      "integrity": "sha512-ngr+82Sh0xMz25TPCZi+nC2iTzjfCdWS2ONXTp/PtSCHCgaCNBpdMqgvJ2ccdLlClVZ7sisIgB914j/JFe+RZA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/helper-plugin-utils": "^7.29.7"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      },
+      "peerDependencies": {
+        "@babel/core": "^7.0.0-0"
+      }
+    },
+    "node_modules/@babel/plugin-transform-typescript": {
+      "version": "7.29.7",
+      "resolved": "https://registry.npmjs.org/@babel/plugin-transform-typescript/-/plugin-transform-typescript-7.29.7.tgz",
+      "integrity": "sha512-jK52h8LaLc7JarhQV2ofeFMts4H7vnOXnqZNA6fYglBTZewRBE51KWt3BUltW1P+KoPsYkHoJeXePuz4zo2LMw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/helper-annotate-as-pure": "^7.29.7",
+        "@babel/helper-create-class-features-plugin": "^7.29.7",
+        "@babel/helper-plugin-utils": "^7.29.7",
+        "@babel/helper-skip-transparent-expression-wrappers": "^7.29.7",
+        "@babel/plugin-syntax-typescript": "^7.29.7"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      },
+      "peerDependencies": {
+        "@babel/core": "^7.0.0-0"
+      }
+    },
+    "node_modules/@babel/runtime": {
+      "version": "7.29.7",
+      "resolved": "https://registry.npmjs.org/@babel/runtime/-/runtime-7.29.7.tgz",
+      "integrity": "sha512-Nq8OhGWiZIZGV6hLHoyAKLLcJihP/xFeBMGJoUrxTX2psI8dCifzLhZISFb+VWS3wFMRDmCGw5R+dOySCqPLhw==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=6.9.0"
+      }
+    },
+    "node_modules/@babel/template": {
+      "version": "7.29.7",
+      "resolved": "https://registry.npmjs.org/@babel/template/-/template-7.29.7.tgz",
+      "integrity": "sha512-puq+Gf35oI24FeN11LkoUQFqv9uwNeWpxXZi/Ji3rRIoKAzKnxRaZ+Gkj0vKS9ZCiTESfng1N9LyOyXvo+m+Gg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/code-frame": "^7.29.7",
+        "@babel/parser": "^7.29.7",
+        "@babel/types": "^7.29.7"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      }
+    },
+    "node_modules/@babel/traverse": {
+      "version": "7.29.8",
+      "resolved": "https://registry.npmjs.org/@babel/traverse/-/traverse-7.29.8.tgz",
+      "integrity": "sha512-I5z7H3bf/41ktsNVLtpN0wAa336HkqIHQ5BuPLEhTkt1jVSyZpeNKIzTgEWmlxjdg81R0IgUCcaE+Ok3NvrfZg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/code-frame": "^7.29.7",
+        "@babel/generator": "^7.29.8",
+        "@babel/helper-globals": "^7.29.7",
+        "@babel/parser": "^7.29.8",
+        "@babel/template": "^7.29.7",
+        "@babel/types": "^7.29.8",
+        "debug": "^4.3.1"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      }
+    },
+    "node_modules/@babel/types": {
+      "version": "7.29.8",
+      "resolved": "https://registry.npmjs.org/@babel/types/-/types-7.29.8.tgz",
+      "integrity": "sha512-Vj1jF3cPfxg7OAfoI7QnVKLoILlm2JF9pnVHrX8qx7AHMiYWT+NDAA7jChlNgRS4WTLc/fD1lXLmPixluj+3Gg==",
+      "license": "MIT",
+      "dependencies": {
+        "@babel/helper-string-parser": "^7.29.7",
+        "@babel/helper-validator-identifier": "^7.29.7"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      }
+    },
+    "node_modules/@bcoe/v8-coverage": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/@bcoe/v8-coverage/-/v8-coverage-1.0.2.tgz",
+      "integrity": "sha512-6zABk/ECA/QYSCQ1NGiVwwbQerUCZ+TQbp64Q3AgmfNvurHH0j8TtXa1qbShXA6qqkpAj4V5W8pP6mLe1mcMqA==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@bwip-js/generic": {
+      "version": "4.11.2",
+      "resolved": "https://registry.npmjs.org/@bwip-js/generic/-/generic-4.11.2.tgz",
+      "integrity": "sha512-NSBGrja1Md/alQyGnJ96YJYvhxsqzV1ZhIxOsADvIo3s0PGYDISvxxcGDVwLXvWWU+38dcfFNFED47Owzjewzw==",
+      "license": "MIT"
+    },
+    "node_modules/@codemirror/autocomplete": {
+      "version": "6.20.3",
+      "resolved": "https://registry.npmjs.org/@codemirror/autocomplete/-/autocomplete-6.20.3.tgz",
+      "integrity": "sha512-tlosUqb+3BbxCxZdu4tKeRghPFC+QM7q4X5YhKV2eCmPG+1r2F3f4AaSz5sCrFqUtX4Jh20VFTKecl16MgiV9g==",
+      "license": "MIT",
+      "dependencies": {
+        "@codemirror/language": "^6.0.0",
+        "@codemirror/state": "^6.0.0",
+        "@codemirror/view": "^6.17.0",
+        "@lezer/common": "^1.0.0"
+      }
+    },
+    "node_modules/@codemirror/commands": {
+      "version": "6.10.4",
+      "resolved": "https://registry.npmjs.org/@codemirror/commands/-/commands-6.10.4.tgz",
+      "integrity": "sha512-Ryk9y9T0FFVF0cUGhAknveAyUOl/A1qReTFi+qPKtOh2Z9F4AUBz3XOrYD4ZEgZirdugVzHvd/2/Wcwy5OliTg==",
+      "license": "MIT",
+      "dependencies": {
+        "@codemirror/language": "^6.0.0",
+        "@codemirror/state": "^6.7.0",
+        "@codemirror/view": "^6.27.0",
+        "@lezer/common": "^1.1.0"
+      }
+    },
+    "node_modules/@codemirror/lang-json": {
+      "version": "6.0.2",
+      "resolved": "https://registry.npmjs.org/@codemirror/lang-json/-/lang-json-6.0.2.tgz",
+      "integrity": "sha512-x2OtO+AvwEHrEwR0FyyPtfDUiloG3rnVTSZV1W8UteaLL8/MajQd8DpvUb2YVzC+/T18aSDv0H9mu+xw0EStoQ==",
+      "license": "MIT",
+      "dependencies": {
+        "@codemirror/language": "^6.0.0",
+        "@lezer/json": "^1.0.0"
+      }
+    },
+    "node_modules/@codemirror/language": {
+      "version": "6.12.4",
+      "resolved": "https://registry.npmjs.org/@codemirror/language/-/language-6.12.4.tgz",
+      "integrity": "sha512-1q4PaT+o6PbgpkJt4Q8Fv5XJxTy4FUZ4MWETtyiDw3J0Pyr9E2vqcKL+k9wcvjNTIsauxvE7OfmWj3FRPHQ76A==",
+      "license": "MIT",
+      "dependencies": {
+        "@codemirror/state": "^6.0.0",
+        "@codemirror/view": "^6.23.0",
+        "@lezer/common": "^1.5.0",
+        "@lezer/highlight": "^1.0.0",
+        "@lezer/lr": "^1.0.0",
+        "style-mod": "^4.0.0"
+      }
+    },
+    "node_modules/@codemirror/lint": {
+      "version": "6.9.7",
+      "resolved": "https://registry.npmjs.org/@codemirror/lint/-/lint-6.9.7.tgz",
+      "integrity": "sha512-28/+iWLYxKxsvGYhSYL7zaCZqLz5+FFFDq9tVsvGv9kv8RY4fFAchJ5WX9M3YrrRlTIsECjsXPqeNgnSmNP2dg==",
+      "license": "MIT",
+      "dependencies": {
+        "@codemirror/state": "^6.0.0",
+        "@codemirror/view": "^6.42.0",
+        "crelt": "^1.0.5"
+      }
+    },
+    "node_modules/@codemirror/search": {
+      "version": "6.7.1",
+      "resolved": "https://registry.npmjs.org/@codemirror/search/-/search-6.7.1.tgz",
+      "integrity": "sha512-uMe5UO6PamJtSHrXhhHOzSX3ReWtiJrva6GnPMwSOrZtiExb5X5eExhr2OUZQVvdxPsKpY3Ro2mFbQadpPWmHA==",
+      "license": "MIT",
+      "dependencies": {
+        "@codemirror/state": "^6.0.0",
+        "@codemirror/view": "^6.37.0",
+        "crelt": "^1.0.5"
+      }
+    },
+    "node_modules/@codemirror/state": {
+      "version": "6.7.1",
+      "resolved": "https://registry.npmjs.org/@codemirror/state/-/state-6.7.1.tgz",
+      "integrity": "sha512-9QzNDgE4EYDnAHfrTlR2lwiPciiOymLtwKK+8yHQzCc7GXhAP9xdEbEJFy2IWB1j9UGUl9BsgMmTo/ImA02T7A==",
+      "license": "MIT",
+      "dependencies": {
+        "@marijn/find-cluster-break": "^1.0.0"
+      }
+    },
+    "node_modules/@codemirror/view": {
+      "version": "6.43.8",
+      "resolved": "https://registry.npmjs.org/@codemirror/view/-/view-6.43.8.tgz",
+      "integrity": "sha512-qtItTDssZ/5GFfi94hrILu9j/VUeFPDPkhovEfmWFj2ipTxnzPB8DdHgfbb8HYTzLTYhrndKmyQxXUz/PDLenw==",
+      "license": "MIT",
+      "dependencies": {
+        "@codemirror/state": "^6.7.0",
+        "crelt": "^1.0.6",
+        "style-mod": "^4.1.0",
+        "w3c-keyname": "^2.2.4"
+      }
+    },
+    "node_modules/@css-render/plugin-bem": {
+      "version": "0.15.14",
+      "resolved": "https://registry.npmjs.org/@css-render/plugin-bem/-/plugin-bem-0.15.14.tgz",
+      "integrity": "sha512-QK513CJ7yEQxm/P3EwsI+d+ha8kSOcjGvD6SevM41neEMxdULE+18iuQK6tEChAWMOQNQPLG/Rw3Khb69r5neg==",
+      "dev": true,
+      "license": "MIT",
+      "peerDependencies": {
+        "css-render": "~0.15.14"
+      }
+    },
+    "node_modules/@css-render/vue3-ssr": {
+      "version": "0.15.14",
+      "resolved": "https://registry.npmjs.org/@css-render/vue3-ssr/-/vue3-ssr-0.15.14.tgz",
+      "integrity": "sha512-//8027GSbxE9n3QlD73xFY6z4ZbHbvrOVB7AO6hsmrEzGbg+h2A09HboUyDgu+xsmj7JnvJD39Irt+2D0+iV8g==",
+      "dev": true,
+      "license": "MIT",
+      "peerDependencies": {
+        "vue": "^3.0.11"
+      }
+    },
+    "node_modules/@csstools/color-helpers": {
+      "version": "5.1.0",
+      "resolved": "https://registry.npmjs.org/@csstools/color-helpers/-/color-helpers-5.1.0.tgz",
+      "integrity": "sha512-S11EXWJyy0Mz5SYvRmY8nJYTFFd1LCNV+7cXyAgQtOOuzb4EsgfqDufL+9esx72/eLhsRdGZwaldu/h+E4t4BA==",
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/csstools"
+        },
+        {
+          "type": "opencollective",
+          "url": "https://opencollective.com/csstools"
+        }
+      ],
+      "license": "MIT-0",
+      "optional": true,
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@csstools/css-calc": {
+      "version": "2.1.4",
+      "resolved": "https://registry.npmjs.org/@csstools/css-calc/-/css-calc-2.1.4.tgz",
+      "integrity": "sha512-3N8oaj+0juUw/1H3YwmDDJXCgTB1gKU6Hc/bB502u9zR0q2vd786XJH9QfrKIEgFlZmhZiq6epXl4rHqhzsIgQ==",
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/csstools"
+        },
+        {
+          "type": "opencollective",
+          "url": "https://opencollective.com/csstools"
+        }
+      ],
+      "license": "MIT",
+      "optional": true,
+      "engines": {
+        "node": ">=18"
+      },
+      "peerDependencies": {
+        "@csstools/css-parser-algorithms": "^3.0.5",
+        "@csstools/css-tokenizer": "^3.0.4"
+      }
+    },
+    "node_modules/@csstools/css-color-parser": {
+      "version": "3.1.0",
+      "resolved": "https://registry.npmjs.org/@csstools/css-color-parser/-/css-color-parser-3.1.0.tgz",
+      "integrity": "sha512-nbtKwh3a6xNVIp/VRuXV64yTKnb1IjTAEEh3irzS+HkKjAOYLTGNb9pmVNntZ8iVBHcWDA2Dof0QtPgFI1BaTA==",
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/csstools"
+        },
+        {
+          "type": "opencollective",
+          "url": "https://opencollective.com/csstools"
+        }
+      ],
+      "license": "MIT",
+      "optional": true,
+      "dependencies": {
+        "@csstools/color-helpers": "^5.1.0",
+        "@csstools/css-calc": "^2.1.4"
+      },
+      "engines": {
+        "node": ">=18"
+      },
+      "peerDependencies": {
+        "@csstools/css-parser-algorithms": "^3.0.5",
+        "@csstools/css-tokenizer": "^3.0.4"
+      }
+    },
+    "node_modules/@csstools/css-parser-algorithms": {
+      "version": "3.0.5",
+      "resolved": "https://registry.npmjs.org/@csstools/css-parser-algorithms/-/css-parser-algorithms-3.0.5.tgz",
+      "integrity": "sha512-DaDeUkXZKjdGhgYaHNJTV9pV7Y9B3b644jCLs9Upc3VeNGg6LWARAT6O+Q+/COo+2gg/bM5rhpMAtf70WqfBdQ==",
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/csstools"
+        },
+        {
+          "type": "opencollective",
+          "url": "https://opencollective.com/csstools"
+        }
+      ],
+      "license": "MIT",
+      "optional": true,
+      "engines": {
+        "node": ">=18"
+      },
+      "peerDependencies": {
+        "@csstools/css-tokenizer": "^3.0.4"
+      }
+    },
+    "node_modules/@csstools/css-tokenizer": {
+      "version": "3.0.4",
+      "resolved": "https://registry.npmjs.org/@csstools/css-tokenizer/-/css-tokenizer-3.0.4.tgz",
+      "integrity": "sha512-Vd/9EVDiu6PPJt9yAh6roZP6El1xHrdvIVGjyBsHR0RYwNHgL7FJPyIIW4fANJNG6FtyZfvlRPpFI4ZM/lubvw==",
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/csstools"
+        },
+        {
+          "type": "opencollective",
+          "url": "https://opencollective.com/csstools"
+        }
+      ],
+      "license": "MIT",
+      "optional": true,
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@emnapi/core": {
+      "version": "1.10.0",
+      "resolved": "https://registry.npmjs.org/@emnapi/core/-/core-1.10.0.tgz",
+      "integrity": "sha512-yq6OkJ4p82CAfPl0u9mQebQHKPJkY7WrIuk205cTYnYe+k2Z8YBh11FrbRG/H6ihirqcacOgl2BIO8oyMQLeXw==",
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "dependencies": {
+        "@emnapi/wasi-threads": "1.2.1",
+        "tslib": "^2.4.0"
+      }
+    },
+    "node_modules/@emnapi/runtime": {
+      "version": "1.10.0",
+      "resolved": "https://registry.npmjs.org/@emnapi/runtime/-/runtime-1.10.0.tgz",
+      "integrity": "sha512-ewvYlk86xUoGI0zQRNq/mC+16R1QeDlKQy21Ki3oSYXNgLb45GV1P6A0M+/s6nyCuNDqe5VpaY84BzXGwVbwFA==",
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "dependencies": {
+        "tslib": "^2.4.0"
+      }
+    },
+    "node_modules/@emnapi/wasi-threads": {
+      "version": "1.2.1",
+      "resolved": "https://registry.npmjs.org/@emnapi/wasi-threads/-/wasi-threads-1.2.1.tgz",
+      "integrity": "sha512-uTII7OYF+/Mes/MrcIOYp5yOtSMLBWSIoLPpcgwipoiKbli6k322tcoFsxoIIxPDqW01SQGAgko4EzZi2BNv2w==",
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "dependencies": {
+        "tslib": "^2.4.0"
+      }
+    },
+    "node_modules/@emotion/hash": {
+      "version": "0.8.0",
+      "resolved": "https://registry.npmjs.org/@emotion/hash/-/hash-0.8.0.tgz",
+      "integrity": "sha512-kBJtf7PH6aWwZ6fka3zQ0p6SBYzx4fl1LoZXE2RrnYST9Xljm7WfKJrU4g/Xr3Beg72MLrp1AWNUmuYJTL7Cow==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/@esbuild/aix-ppc64": {
+      "version": "0.28.1",
+      "resolved": "https://registry.npmjs.org/@esbuild/aix-ppc64/-/aix-ppc64-0.28.1.tgz",
+      "integrity": "sha512-Svl7tq8k/08+p6CXPpRjQ1fKX+1odH/BQbb48fV6fj3CWHhsoIOoY87w1oHXm0qEpkIK3ZfVgp0hed3XBXzXMQ==",
+      "cpu": [
+        "ppc64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "aix"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/android-arm": {
+      "version": "0.28.1",
+      "resolved": "https://registry.npmjs.org/@esbuild/android-arm/-/android-arm-0.28.1.tgz",
+      "integrity": "sha512-0k2F129Xdio1TdJfzJ8sy1Q47vUD2NnwdhiAf7drUN1EBTfPf4hsFCtmMgu/6m8JSzsBrlmVjudMBQqOfG8usQ==",
+      "cpu": [
+        "arm"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "android"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/android-arm64": {
+      "version": "0.28.1",
+      "resolved": "https://registry.npmjs.org/@esbuild/android-arm64/-/android-arm64-0.28.1.tgz",
+      "integrity": "sha512-34EGEbCIAgosYz6goLcopX6Mo7NyGv9tfwEM2/7Ce2VcVRk568iSvniGWcUXIy7wEDR1wzolcxcriFVrWYcwBg==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "android"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/android-x64": {
+      "version": "0.28.1",
+      "resolved": "https://registry.npmjs.org/@esbuild/android-x64/-/android-x64-0.28.1.tgz",
+      "integrity": "sha512-dbwY7ltSMDWsRatcRpCnES4F+im88OCUgGZjy52shC7GqHRE/cYlxNbB4Z4UpJswpcc4Qxd2oE/ufM0p61IKng==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "android"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/darwin-arm64": {
+      "version": "0.28.1",
+      "resolved": "https://registry.npmjs.org/@esbuild/darwin-arm64/-/darwin-arm64-0.28.1.tgz",
+      "integrity": "sha512-TZbWkQY7kvTAXbXUT7uVACR5cMHsDiSz9z7ZKAX/RTq/WJEk3QyRr0wZpNhBDX+/0CtdqUIJlOiodQcta6tY3Q==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "darwin"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/darwin-x64": {
+      "version": "0.28.1",
+      "resolved": "https://registry.npmjs.org/@esbuild/darwin-x64/-/darwin-x64-0.28.1.tgz",
+      "integrity": "sha512-zfdzgK9ACBNZLI/CyHTOx81SyNbM6YXn7rxSgX97VjyiPl9W1i4Ka4fgKECEoFCKGpvBj5qArWIGgQjOwkgskQ==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "darwin"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/freebsd-arm64": {
+      "version": "0.28.1",
+      "resolved": "https://registry.npmjs.org/@esbuild/freebsd-arm64/-/freebsd-arm64-0.28.1.tgz",
+      "integrity": "sha512-wG2EA8ENdEI0qhkSZMjfqrdY+ziCYCPMmtZjjIwOmXFjmyzEHn+UUxk5of+SYsjtfs3VpnlC7QLzSI5hY/rOAw==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "freebsd"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/freebsd-x64": {
+      "version": "0.28.1",
+      "resolved": "https://registry.npmjs.org/@esbuild/freebsd-x64/-/freebsd-x64-0.28.1.tgz",
+      "integrity": "sha512-i7dZ9vQgnvSCzi/rYCXNgtF/U+eKZNJBzu3eTQbRgHnM7tNSizLOkRFAl3qzVc/Op/u5YkHHa4pf/3DOYHthLQ==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "freebsd"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/linux-arm": {
+      "version": "0.28.1",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-arm/-/linux-arm-0.28.1.tgz",
+      "integrity": "sha512-qVXBOHQS+d5Y722GwJzJUtOLlX7km3CraOaGormF1pDtPd2C/l1SHRPgjLunLGe51Sh5YYWKMFDyV4SxgMQYTQ==",
+      "cpu": [
+        "arm"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/linux-arm64": {
+      "version": "0.28.1",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-arm64/-/linux-arm64-0.28.1.tgz",
+      "integrity": "sha512-yHs+0uc8+nvEAfAfxrWQKK5peSNzBc4PegcMO0EJ2hT71uA7vB8Ihg2e77R2P7SG5uYjPbHlLLmve4LLLRCf0g==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/linux-ia32": {
+      "version": "0.28.1",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-ia32/-/linux-ia32-0.28.1.tgz",
+      "integrity": "sha512-d1z4ZuP0ajrfz/FhGT4vv278rX8KnPPJx8i5+AtK7TYbx9Le9F1hyzurZpkEyjkGa9dUGhQow4C1NmeGvqxN2w==",
+      "cpu": [
+        "ia32"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/linux-loong64": {
+      "version": "0.28.1",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-loong64/-/linux-loong64-0.28.1.tgz",
+      "integrity": "sha512-M5sRjUVZrkm1OAPR3dlOYzNmN+loZKGVi1VUQGrwuqLcbR6qeAz+famMhjASeH3YVKvZz+zT1jlh/keC3Rj/lg==",
+      "cpu": [
+        "loong64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/linux-mips64el": {
+      "version": "0.28.1",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-mips64el/-/linux-mips64el-0.28.1.tgz",
+      "integrity": "sha512-mRObBZeHh2OxcBFPWE/FjylkRgZdYuiTR3vaTozquCGOH14iP9oN4x4Ge81CoIDYQrXmIxpFumJBu5MtZpnQJQ==",
+      "cpu": [
+        "mips64el"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/linux-ppc64": {
+      "version": "0.28.1",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-ppc64/-/linux-ppc64-0.28.1.tgz",
+      "integrity": "sha512-slScBsMAb3GFDcdrCgLwZtPYRoH2H/youv10QiZyRjmsP48fznoveWytSgCI/R0ZcUgpc0ZhIUEx6LHts8yrfQ==",
+      "cpu": [
+        "ppc64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/linux-riscv64": {
+      "version": "0.28.1",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-riscv64/-/linux-riscv64-0.28.1.tgz",
+      "integrity": "sha512-kw0owk1o0GFETUJyW0jc0G4Yzs0BHZn0JDZ8JRT088vjJYX777BAs1fDGxAC+q831qOs2DTC96mNsG2opdfyyQ==",
+      "cpu": [
+        "riscv64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/linux-s390x": {
+      "version": "0.28.1",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-s390x/-/linux-s390x-0.28.1.tgz",
+      "integrity": "sha512-/lAIjX8aYFRByhh6L5rYtPEDRqa9de/4V/juOXcta5frjvzXO4/sqEtyytse0g3zZFuWu5cDN0MkLz2qRDD2Ag==",
+      "cpu": [
+        "s390x"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/linux-x64": {
+      "version": "0.28.1",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-x64/-/linux-x64-0.28.1.tgz",
+      "integrity": "sha512-u/anNYF2mmVOEDwLtnQ1wOr3EZ9sTNGLWrsYGYwHWzGA3Si84IOkHXlbWTD1NB+9/1lcnweYKO54uhxZydNzfA==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/netbsd-arm64": {
+      "version": "0.28.1",
+      "resolved": "https://registry.npmjs.org/@esbuild/netbsd-arm64/-/netbsd-arm64-0.28.1.tgz",
+      "integrity": "sha512-oks0DYbLwWMmaakTsCb+zL4E+aHRVLom9IJZOAthMQEPiQmydXHkziYEsGYRx0uNV/IjEKGAV941JzH02pflqw==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "netbsd"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/netbsd-x64": {
+      "version": "0.28.1",
+      "resolved": "https://registry.npmjs.org/@esbuild/netbsd-x64/-/netbsd-x64-0.28.1.tgz",
+      "integrity": "sha512-aeL6lAnN89Hz43Mlh1G8ARasbuoYvSITDEx0tHh5b7jJnHcssqgjy9Yx430GDpmCa6OyrKoS0aNRjKundRizGg==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "netbsd"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/openbsd-arm64": {
+      "version": "0.28.1",
+      "resolved": "https://registry.npmjs.org/@esbuild/openbsd-arm64/-/openbsd-arm64-0.28.1.tgz",
+      "integrity": "sha512-MEFJe5C3R8pwXdZ5Y21oo6m7ePiS0d9pWucn99O/wvyJZChoIQKrQDxKrGeW8F5+T0okTHesAmDeiHDTIq0V/Q==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "openbsd"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/openbsd-x64": {
+      "version": "0.28.1",
+      "resolved": "https://registry.npmjs.org/@esbuild/openbsd-x64/-/openbsd-x64-0.28.1.tgz",
+      "integrity": "sha512-i/ZLIOafE0Z8cI/XANJAixoJL/uRAoS2xOA3rb0xN+KK0K177cMAsQYkzHtBrtMXAKuAc7HGgcWiZ/sRC1Nxgw==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "openbsd"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/openharmony-arm64": {
+      "version": "0.28.1",
+      "resolved": "https://registry.npmjs.org/@esbuild/openharmony-arm64/-/openharmony-arm64-0.28.1.tgz",
+      "integrity": "sha512-ge+Z7EXFNt2BO1oAMsVpiQ8EwndV9i1xXerAeTIK7AtPs3bKFXQM7nlRxDSIUIMeueR1CNXxqztLzdNeReKBJg==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "openharmony"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/sunos-x64": {
+      "version": "0.28.1",
+      "resolved": "https://registry.npmjs.org/@esbuild/sunos-x64/-/sunos-x64-0.28.1.tgz",
+      "integrity": "sha512-BEjgtECkL3vY+SaSQ6nzVfiALUeFxpawyp8Jmf5PtYhf1Ug40N1h/hxlhts+f1FvSvarEigdxS3BlSMI2PJLcQ==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "sunos"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/win32-arm64": {
+      "version": "0.28.1",
+      "resolved": "https://registry.npmjs.org/@esbuild/win32-arm64/-/win32-arm64-0.28.1.tgz",
+      "integrity": "sha512-lCv9eK/H6ZJWbE7bh2nw54CZ9M2nupBxJcTsdk/QQnWkdSjKGuxmmH8/GWrlT1eMmZfn4dGcCjRte397WqfQXA==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/win32-ia32": {
+      "version": "0.28.1",
+      "resolved": "https://registry.npmjs.org/@esbuild/win32-ia32/-/win32-ia32-0.28.1.tgz",
+      "integrity": "sha512-zvb/mB2bSCoJOpoCBgYKKpX6YM6mJBlBUVUtVj41DlZJVEB6/0CKlRYxP5wWl1C1ILiCoAU5wZZ4q1P3qeS6Eg==",
+      "cpu": [
+        "ia32"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/win32-x64": {
+      "version": "0.28.1",
+      "resolved": "https://registry.npmjs.org/@esbuild/win32-x64/-/win32-x64-0.28.1.tgz",
+      "integrity": "sha512-bm4Mowrv+GXMlpWX++EcXw/iLyd1o3+bJkC2DkWXYVvgZCqD/bSj9ctZeAMC3cIxgjRVR2Dufaiu4YPxr5gW1A==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@floating-ui/core": {
+      "version": "1.8.0",
+      "resolved": "https://registry.npmjs.org/@floating-ui/core/-/core-1.8.0.tgz",
+      "integrity": "sha512-0CIZ5itps/8x7BG8dEIhs53BvCUH2PCoogtakwRTut+Arm58sJooJ0AuZhLw2HJYIR5cMLNPBSS728sPho2khQ==",
+      "license": "MIT",
+      "dependencies": {
+        "@floating-ui/utils": "^0.2.12"
+      }
+    },
+    "node_modules/@floating-ui/dom": {
+      "version": "1.8.0",
+      "resolved": "https://registry.npmjs.org/@floating-ui/dom/-/dom-1.8.0.tgz",
+      "integrity": "sha512-yXSrzeHZBTZadLOlfyhCkJHNeLJnHRnRInwdZ40L7ZiaAtrBwoYlsDrX3v5zB1Utk7CLfzcOVnVVWoXEky7Ceg==",
+      "license": "MIT",
+      "dependencies": {
+        "@floating-ui/core": "^1.8.0",
+        "@floating-ui/utils": "^0.2.12"
+      }
+    },
+    "node_modules/@floating-ui/utils": {
+      "version": "0.2.12",
+      "resolved": "https://registry.npmjs.org/@floating-ui/utils/-/utils-0.2.12.tgz",
+      "integrity": "sha512-HpCo8tmWzLVad5s2d19EhAz5zqrrQ6s69qd6moPMQvkOuSwDT1YgRfWSVuc4ennqrgv3OHppiOGMQ7oC13yIww==",
+      "license": "MIT"
+    },
+    "node_modules/@iconify-json/carbon": {
+      "version": "1.2.25",
+      "resolved": "https://registry.npmjs.org/@iconify-json/carbon/-/carbon-1.2.25.tgz",
+      "integrity": "sha512-7GLgXnmi47Skh8DcPPiP8U3vgm3rOVziEe+flCdG/kwiVaeb649U3Eqt/ej4f3NvlZK8BrOxpR3xQlWFLZYblQ==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@iconify/types": "*"
+      }
+    },
+    "node_modules/@iconify/types": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/@iconify/types/-/types-2.0.0.tgz",
+      "integrity": "sha512-+wluvCrRhXrhyOmRDJ3q8mux9JkKy5SJ/v8ol2tu4FVjyYvtEzkc/3pK15ET6RKg4b4w4BmTk1+gsCUhf21Ykg==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/@iconify/utils": {
+      "version": "3.1.4",
+      "resolved": "https://registry.npmjs.org/@iconify/utils/-/utils-3.1.4.tgz",
+      "integrity": "sha512-b1S7B1k9ohZ+iNTi2ATxbRYG9fTrJmUT0rc46bvVnNxqNRGW7dyo/vRREwyniI5IRN2RSJHDcm+s3BjWrSAjHw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@antfu/install-pkg": "^1.1.0",
+        "@iconify/types": "^2.0.0",
+        "import-meta-resolve": "^4.2.0"
+      }
+    },
+    "node_modules/@isaacs/cliui": {
+      "version": "8.0.2",
+      "resolved": "https://registry.npmjs.org/@isaacs/cliui/-/cliui-8.0.2.tgz",
+      "integrity": "sha512-O8jcjabXaleOG9DQ0+ARXWZBTfnP4WNAqzuiJK7ll44AmxGKv/J2M4TPjxjY3znBCfvBXFzucm1twdyFybFqEA==",
+      "dev": true,
+      "license": "ISC",
+      "dependencies": {
+        "string-width": "^5.1.2",
+        "string-width-cjs": "npm:string-width@^4.2.0",
+        "strip-ansi": "^7.0.1",
+        "strip-ansi-cjs": "npm:strip-ansi@^6.0.1",
+        "wrap-ansi": "^8.1.0",
+        "wrap-ansi-cjs": "npm:wrap-ansi@^7.0.0"
+      },
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "node_modules/@istanbuljs/schema": {
+      "version": "0.1.6",
+      "resolved": "https://registry.npmjs.org/@istanbuljs/schema/-/schema-0.1.6.tgz",
+      "integrity": "sha512-+Sg6GCR/wy1oSmQDFq4LQDAhm3ETKnorxN+y5nbLULOR3P0c14f2Wurzj3/xqPXtasLFfHd5iRFQ7AJt4KH2cw==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/@jridgewell/gen-mapping": {
+      "version": "0.3.13",
+      "resolved": "https://registry.npmjs.org/@jridgewell/gen-mapping/-/gen-mapping-0.3.13.tgz",
+      "integrity": "sha512-2kkt/7niJ6MgEPxF0bYdQ6etZaA+fQvDcLKckhy1yIQOzaoKjBBjSj63/aLVjYE3qhRt5dvM+uUyfCg6UKCBbA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@jridgewell/sourcemap-codec": "^1.5.0",
+        "@jridgewell/trace-mapping": "^0.3.24"
+      }
+    },
+    "node_modules/@jridgewell/remapping": {
+      "version": "2.3.5",
+      "resolved": "https://registry.npmjs.org/@jridgewell/remapping/-/remapping-2.3.5.tgz",
+      "integrity": "sha512-LI9u/+laYG4Ds1TDKSJW2YPrIlcVYOwi2fUC6xB43lueCjgxV4lffOCZCtYFiH6TNOX+tQKXx97T4IKHbhyHEQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@jridgewell/gen-mapping": "^0.3.5",
+        "@jridgewell/trace-mapping": "^0.3.24"
+      }
+    },
+    "node_modules/@jridgewell/resolve-uri": {
+      "version": "3.1.2",
+      "resolved": "https://registry.npmjs.org/@jridgewell/resolve-uri/-/resolve-uri-3.1.2.tgz",
+      "integrity": "sha512-bRISgCIjP20/tbWSPWMEi54QVPRZExkuD9lJL+UIxUKtwVJA8wW1Trb1jMs1RFXo1CBTNZ/5hpC9QvmKWdopKw==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=6.0.0"
+      }
+    },
+    "node_modules/@jridgewell/sourcemap-codec": {
+      "version": "1.5.5",
+      "resolved": "https://registry.npmjs.org/@jridgewell/sourcemap-codec/-/sourcemap-codec-1.5.5.tgz",
+      "integrity": "sha512-cYQ9310grqxueWbl+WuIUIaiUaDcj7WOq5fVhEljNVgRfOUhY9fy2zTvfoqWsnebh8Sl70VScFbICvJnLKB0Og==",
+      "license": "MIT"
+    },
+    "node_modules/@jridgewell/trace-mapping": {
+      "version": "0.3.31",
+      "resolved": "https://registry.npmjs.org/@jridgewell/trace-mapping/-/trace-mapping-0.3.31.tgz",
+      "integrity": "sha512-zzNR+SdQSDJzc8joaeP8QQoCQr8NuYx2dIIytl1QeBEZHJ9uW6hebsrYgbz8hJwUQao3TWCMtmfV8Nu1twOLAw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@jridgewell/resolve-uri": "^3.1.0",
+        "@jridgewell/sourcemap-codec": "^1.4.14"
+      }
+    },
+    "node_modules/@juggle/resize-observer": {
+      "version": "3.4.0",
+      "resolved": "https://registry.npmjs.org/@juggle/resize-observer/-/resize-observer-3.4.0.tgz",
+      "integrity": "sha512-dfLbk+PwWvFzSxwk3n5ySL0hfBog779o8h68wK/7/APo/7cgyWp5jcXockbxdk5kFRkbeXWm4Fbi9FrdN381sA==",
+      "dev": true,
+      "license": "Apache-2.0"
+    },
+    "node_modules/@lezer/common": {
+      "version": "1.5.2",
+      "resolved": "https://registry.npmjs.org/@lezer/common/-/common-1.5.2.tgz",
+      "integrity": "sha512-sxQE460fPZyU3sdc8lafxiPwJHBzZRy/udNFynGQky1SePYBdhkBl1kOagA9uT3pxR8K09bOrmTUqA9wb/PjSQ==",
+      "license": "MIT"
+    },
+    "node_modules/@lezer/highlight": {
+      "version": "1.2.3",
+      "resolved": "https://registry.npmjs.org/@lezer/highlight/-/highlight-1.2.3.tgz",
+      "integrity": "sha512-qXdH7UqTvGfdVBINrgKhDsVTJTxactNNxLk7+UMwZhU13lMHaOBlJe9Vqp907ya56Y3+ed2tlqzys7jDkTmW0g==",
+      "license": "MIT",
+      "dependencies": {
+        "@lezer/common": "^1.3.0"
+      }
+    },
+    "node_modules/@lezer/json": {
+      "version": "1.0.3",
+      "resolved": "https://registry.npmjs.org/@lezer/json/-/json-1.0.3.tgz",
+      "integrity": "sha512-BP9KzdF9Y35PDpv04r0VeSTKDeox5vVr3efE7eBbx3r4s3oNLfunchejZhjArmeieBH+nVOpgIiBJpEAv8ilqQ==",
+      "license": "MIT",
+      "dependencies": {
+        "@lezer/common": "^1.2.0",
+        "@lezer/highlight": "^1.0.0",
+        "@lezer/lr": "^1.0.0"
+      }
+    },
+    "node_modules/@lezer/lr": {
+      "version": "1.4.10",
+      "resolved": "https://registry.npmjs.org/@lezer/lr/-/lr-1.4.10.tgz",
+      "integrity": "sha512-rnCpTIBafOx4mRp43xOxDJbFipJm/c0cia/V5TiGlhmMa+wsSdoGmUN3w5Bqrks/09Q/D4tNAmWaT8p6NRi77A==",
+      "license": "MIT",
+      "dependencies": {
+        "@lezer/common": "^1.0.0"
+      }
+    },
+    "node_modules/@marijn/find-cluster-break": {
+      "version": "1.0.3",
+      "resolved": "https://registry.npmjs.org/@marijn/find-cluster-break/-/find-cluster-break-1.0.3.tgz",
+      "integrity": "sha512-FY+MKLBoTsLNJF/eLWaOsXGdz6uh3Iu1axjPf6TUq92IYumcTcXWHoS747JARLkcdlJ/Waiaxc5wQfFO8jC6NA==",
+      "license": "MIT"
+    },
+    "node_modules/@napi-rs/lzma-linux-x64-gnu": {
+      "version": "1.5.1",
+      "resolved": "https://registry.npmjs.org/@napi-rs/lzma-linux-x64-gnu/-/lzma-linux-x64-gnu-1.5.1.tgz",
+      "integrity": "sha512-oTXEIha4SsuXdTA4Iyskj0kpdx2yVXdhd75c2v3xGrHFfVMsbhTPZU/nMPL4sWKo4pBHm3aucLaqGlF696dTyQ==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": "^22.20 || ^24.12 || >=25"
+      }
+    },
+    "node_modules/@napi-rs/wasm-runtime": {
+      "version": "1.2.2",
+      "resolved": "https://registry.npmjs.org/@napi-rs/wasm-runtime/-/wasm-runtime-1.2.2.tgz",
+      "integrity": "sha512-JfB4kuJQjaoHuCTseIINHtHWeJnvgEcxjwA5t/Y00ZgaOO1Crz3fjT/p8kT28zA/Caz7oiUMn3d6H2yOVCVwuw==",
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "dependencies": {
+        "@tybys/wasm-util": "^0.10.3"
+      },
+      "engines": {
+        "node": "^20.19.0 || ^22.13.0 || >=23.5.0"
+      },
+      "funding": {
+        "type": "github",
+        "url": "https://github.com/sponsors/Brooooooklyn"
+      },
+      "peerDependencies": {
+        "@emnapi/core": "^1.7.1 || ^2.0.0-alpha.3",
+        "@emnapi/runtime": "^1.7.1 || ^2.0.0-alpha.3"
+      }
+    },
+    "node_modules/@oxc-parser/binding-android-arm-eabi": {
+      "version": "0.131.0",
+      "resolved": "https://registry.npmjs.org/@oxc-parser/binding-android-arm-eabi/-/binding-android-arm-eabi-0.131.0.tgz",
+      "integrity": "sha512-t2xicr9pfzkSRYx5aPqZqlLaayIwJTqgQ81Jor31Xep2nGyL2Aq3d0K5wOfeR7VevaSdxaS9dzSQP9xDwn8fDg==",
+      "cpu": [
+        "arm"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "android"
+      ],
+      "engines": {
+        "node": "^20.19.0 || >=22.12.0"
+      }
+    },
+    "node_modules/@oxc-parser/binding-android-arm64": {
+      "version": "0.131.0",
+      "resolved": "https://registry.npmjs.org/@oxc-parser/binding-android-arm64/-/binding-android-arm64-0.131.0.tgz",
+      "integrity": "sha512-nlGIod6gw75x1aEDgLS+srj+JRGY0HHm9MI9YgzE/B64l6d6+H3MSP9NOgp0+HTg8tp4vV9rVfgQGgd+TfVZcA==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "android"
+      ],
+      "engines": {
+        "node": "^20.19.0 || >=22.12.0"
+      }
+    },
+    "node_modules/@oxc-parser/binding-darwin-arm64": {
+      "version": "0.131.0",
+      "resolved": "https://registry.npmjs.org/@oxc-parser/binding-darwin-arm64/-/binding-darwin-arm64-0.131.0.tgz",
+      "integrity": "sha512-jukuV6xe5RbQKFo7QD34NDCLDZp4PSOm8rmckhNdH/60ymG5zXbDzGBEyc+nTkuLQNama2aSGCt+CPfpjNTqyw==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "darwin"
+      ],
+      "engines": {
+        "node": "^20.19.0 || >=22.12.0"
+      }
+    },
+    "node_modules/@oxc-parser/binding-darwin-x64": {
+      "version": "0.131.0",
+      "resolved": "https://registry.npmjs.org/@oxc-parser/binding-darwin-x64/-/binding-darwin-x64-0.131.0.tgz",
+      "integrity": "sha512-g3JOo4khe9rslHm5WYaVDWb0HS/M1MLR3I9S8560MkKIcC96VQY00QjOlsuRyfSj/JDXj8i9T7ryPO2RidiXVg==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "darwin"
+      ],
+      "engines": {
+        "node": "^20.19.0 || >=22.12.0"
+      }
+    },
+    "node_modules/@oxc-parser/binding-freebsd-x64": {
+      "version": "0.131.0",
+      "resolved": "https://registry.npmjs.org/@oxc-parser/binding-freebsd-x64/-/binding-freebsd-x64-0.131.0.tgz",
+      "integrity": "sha512-1hziITDTxjMePnX+dR9ocVT+EuZkQ8wm4FPAbmbEiKG+Phbo73J1ZnPAA6Y/aGsWF3McOFnQuZIktAFwalkfJQ==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "freebsd"
+      ],
+      "engines": {
+        "node": "^20.19.0 || >=22.12.0"
+      }
+    },
+    "node_modules/@oxc-parser/binding-linux-arm-gnueabihf": {
+      "version": "0.131.0",
+      "resolved": "https://registry.npmjs.org/@oxc-parser/binding-linux-arm-gnueabihf/-/binding-linux-arm-gnueabihf-0.131.0.tgz",
+      "integrity": "sha512-9uRxfXwyKG9+MwmGQBo2ncPNwZH5HTmCETFM2WiuDBNDCW4NC5ttSQkwCAMrTAWgwMzVBH1CP8pM0v7nebCWXQ==",
+      "cpu": [
+        "arm"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": "^20.19.0 || >=22.12.0"
+      }
+    },
+    "node_modules/@oxc-parser/binding-linux-arm-musleabihf": {
+      "version": "0.131.0",
+      "resolved": "https://registry.npmjs.org/@oxc-parser/binding-linux-arm-musleabihf/-/binding-linux-arm-musleabihf-0.131.0.tgz",
+      "integrity": "sha512-mgbLvzRShXOLBdWGInf08Af4q+pfj1xD8hSgLClDZ9of/BXkB6+LIhTH7fihiDUipqB3yoSkKBWaZ3Ejlf5Yag==",
+      "cpu": [
+        "arm"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": "^20.19.0 || >=22.12.0"
+      }
+    },
+    "node_modules/@oxc-parser/binding-linux-arm64-gnu": {
+      "version": "0.131.0",
+      "resolved": "https://registry.npmjs.org/@oxc-parser/binding-linux-arm64-gnu/-/binding-linux-arm64-gnu-0.131.0.tgz",
+      "integrity": "sha512-OPT8++4aN6j2GJ8+3IZHS/byXoZP4aSBn+FoG6rgBJ2fKwPKXWF3MqrFMNW7NKHM28FLY579xYLxJSfgobEqPA==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": "^20.19.0 || >=22.12.0"
+      }
+    },
+    "node_modules/@oxc-parser/binding-linux-arm64-musl": {
+      "version": "0.131.0",
+      "resolved": "https://registry.npmjs.org/@oxc-parser/binding-linux-arm64-musl/-/binding-linux-arm64-musl-0.131.0.tgz",
+      "integrity": "sha512-vtPiwmfVTAXzaxDKsOXG+LwgRAA7WEnaeHzhS5z0GE89gAK18KSXnly7Z6saXXq6L3dVMyK44uoTI03zKxrpmw==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": "^20.19.0 || >=22.12.0"
+      }
+    },
+    "node_modules/@oxc-parser/binding-linux-ppc64-gnu": {
+      "version": "0.131.0",
+      "resolved": "https://registry.npmjs.org/@oxc-parser/binding-linux-ppc64-gnu/-/binding-linux-ppc64-gnu-0.131.0.tgz",
+      "integrity": "sha512-8AW8L7w5cGHSdZPcyZX2yR0+GUODsT15rbRjfdD54rv6DMbtuEB19ysLOpKJlRGfH6UNYNpCHaU1uJWgTWf1/w==",
+      "cpu": [
+        "ppc64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": "^20.19.0 || >=22.12.0"
+      }
+    },
+    "node_modules/@oxc-parser/binding-linux-riscv64-gnu": {
+      "version": "0.131.0",
+      "resolved": "https://registry.npmjs.org/@oxc-parser/binding-linux-riscv64-gnu/-/binding-linux-riscv64-gnu-0.131.0.tgz",
+      "integrity": "sha512-vvpjkjEOUsPcsYf8evE4MO3aGx9+3wodXEBOicGNnOwTuAik8eBONNkgSdhkGsAblQmfVHJyanRnpxglddTXIA==",
+      "cpu": [
+        "riscv64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": "^20.19.0 || >=22.12.0"
+      }
+    },
+    "node_modules/@oxc-parser/binding-linux-riscv64-musl": {
+      "version": "0.131.0",
+      "resolved": "https://registry.npmjs.org/@oxc-parser/binding-linux-riscv64-musl/-/binding-linux-riscv64-musl-0.131.0.tgz",
+      "integrity": "sha512-AqmcNC3fClXX+fxQ6VGEN1667xVFiRBkY0CZmDMSiaeFUsv1+UkBPYYi48IUKcA9/ivvoKNRzQl2I4//kT9F/w==",
+      "cpu": [
+        "riscv64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": "^20.19.0 || >=22.12.0"
+      }
+    },
+    "node_modules/@oxc-parser/binding-linux-s390x-gnu": {
+      "version": "0.131.0",
+      "resolved": "https://registry.npmjs.org/@oxc-parser/binding-linux-s390x-gnu/-/binding-linux-s390x-gnu-0.131.0.tgz",
+      "integrity": "sha512-7d3jOMKy7RSQCcDLIci+ySll2FgsOMl/GiRux4q2JNv0zg4EdhFISa9idvrdN/HEUIQQJNg6dmveUeJl2YErGA==",
+      "cpu": [
+        "s390x"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": "^20.19.0 || >=22.12.0"
+      }
+    },
+    "node_modules/@oxc-parser/binding-linux-x64-gnu": {
+      "version": "0.131.0",
+      "resolved": "https://registry.npmjs.org/@oxc-parser/binding-linux-x64-gnu/-/binding-linux-x64-gnu-0.131.0.tgz",
+      "integrity": "sha512-JHK/h95qVqVQ+ITER837kcTdwBDFpFaNnOTYGCP0zdUSX/mLKC7tXOoyrTb6vG7iRPwGlcgBil3v2IjYw1FqJA==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": "^20.19.0 || >=22.12.0"
+      }
+    },
+    "node_modules/@oxc-parser/binding-linux-x64-musl": {
+      "version": "0.131.0",
+      "resolved": "https://registry.npmjs.org/@oxc-parser/binding-linux-x64-musl/-/binding-linux-x64-musl-0.131.0.tgz",
+      "integrity": "sha512-b2BO82O8azXAyf7EUgOPKu145nWypbNyk07HbU09fkzhm9lEA5oPvaN/M8Nlo7tOErVTa2WOgS4QbOnxAPXdDQ==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": "^20.19.0 || >=22.12.0"
+      }
+    },
+    "node_modules/@oxc-parser/binding-openharmony-arm64": {
+      "version": "0.131.0",
+      "resolved": "https://registry.npmjs.org/@oxc-parser/binding-openharmony-arm64/-/binding-openharmony-arm64-0.131.0.tgz",
+      "integrity": "sha512-GHO9glZaX7LkX/OGfluEPf1yjg+ehiFbUdowbX6uNWOQhmwKWU4m4+nZ9FJkrHNKuxyI1KKertMdGjVKCApKWA==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "openharmony"
+      ],
+      "engines": {
+        "node": "^20.19.0 || >=22.12.0"
+      }
+    },
+    "node_modules/@oxc-parser/binding-wasm32-wasi": {
+      "version": "0.131.0",
+      "resolved": "https://registry.npmjs.org/@oxc-parser/binding-wasm32-wasi/-/binding-wasm32-wasi-0.131.0.tgz",
+      "integrity": "sha512-3SkikPaEFoih1N83qLVEDLRLeY4nYsf6JT9SnWiMCQ5lGQdKup6bEuKCqkRiG9dD1IIaFeYz9RjlciPmYoFIWA==",
+      "cpu": [
+        "wasm32"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "dependencies": {
+        "@emnapi/core": "1.10.0",
+        "@emnapi/runtime": "1.10.0",
+        "@napi-rs/wasm-runtime": "^1.1.4"
+      },
+      "engines": {
+        "node": "^20.19.0 || >=22.12.0"
+      }
+    },
+    "node_modules/@oxc-parser/binding-win32-arm64-msvc": {
+      "version": "0.131.0",
+      "resolved": "https://registry.npmjs.org/@oxc-parser/binding-win32-arm64-msvc/-/binding-win32-arm64-msvc-0.131.0.tgz",
+      "integrity": "sha512-Os5bEhryeA2jkH+ZrnZyAC1EP5gs+X4YB1Fjqml7UPD5kU7ecsK1MPEVMfCrdt/GDNpDbavYXiOXOdyJ5b3OPw==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ],
+      "engines": {
+        "node": "^20.19.0 || >=22.12.0"
+      }
+    },
+    "node_modules/@oxc-parser/binding-win32-ia32-msvc": {
+      "version": "0.131.0",
+      "resolved": "https://registry.npmjs.org/@oxc-parser/binding-win32-ia32-msvc/-/binding-win32-ia32-msvc-0.131.0.tgz",
+      "integrity": "sha512-m+jNz9EuF0NXoiptc6B9h5yompZQVW/a5MJeOu5zojfH5yWk82tvF2ccrHkfhgtrS9h9DD5l1Qv8dWlfY7Nz8g==",
+      "cpu": [
+        "ia32"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ],
+      "engines": {
+        "node": "^20.19.0 || >=22.12.0"
+      }
+    },
+    "node_modules/@oxc-parser/binding-win32-x64-msvc": {
+      "version": "0.131.0",
+      "resolved": "https://registry.npmjs.org/@oxc-parser/binding-win32-x64-msvc/-/binding-win32-x64-msvc-0.131.0.tgz",
+      "integrity": "sha512-o14Hk8dAyiEUMFEWEgmAwFZvBt1RzAYLM3xeQ+5315JXgVYhoemivgYcbYVRbsFkS71ShMGlAFE0kPnr460rww==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ],
+      "engines": {
+        "node": "^20.19.0 || >=22.12.0"
+      }
+    },
+    "node_modules/@oxc-project/types": {
+      "version": "0.131.0",
+      "resolved": "https://registry.npmjs.org/@oxc-project/types/-/types-0.131.0.tgz",
+      "integrity": "sha512-PgnWDfV0h+b16XNKbXU7Daib/BFSt/J2mEzfYIBu6JB/wNdlU+kVYXCkGA1A9fWkTbOgbjh4e6NhPeQOYvFhEA==",
+      "dev": true,
+      "license": "MIT",
+      "funding": {
+        "url": "https://github.com/sponsors/Boshen"
+      }
+    },
+    "node_modules/@pkgjs/parseargs": {
+      "version": "0.11.0",
+      "resolved": "https://registry.npmjs.org/@pkgjs/parseargs/-/parseargs-0.11.0.tgz",
+      "integrity": "sha512-+1VkjdD0QBLPodGrJUeqarH8VAIvQODIbwh9XpP5Syisf7YoQgsJKPNFoqqLQlu+VQ/tVSshMR6loPMn8U+dPg==",
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "engines": {
+        "node": ">=14"
+      }
+    },
+    "node_modules/@polka/url": {
+      "version": "1.0.0-next.29",
+      "resolved": "https://registry.npmjs.org/@polka/url/-/url-1.0.0-next.29.tgz",
+      "integrity": "sha512-wwQAWhWSuHaag8c4q/KN/vCoeOJYshAIvMQwD4GpSb3OiZklFfvAgmj0VCBBImRpuF/aFgIRzllXlVX93Jevww==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/@quansync/fs": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/@quansync/fs/-/fs-1.0.0.tgz",
+      "integrity": "sha512-4TJ3DFtlf1L5LDMaM6CanJ/0lckGNtJcMjQ1NAV6zDmA0tEHKZtxNKin8EgPaVX1YzljbxckyT2tJrpQKAtngQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "quansync": "^1.0.0"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sxzz"
+      }
+    },
+    "node_modules/@rolldown/binding-android-arm64": {
+      "version": "1.2.3",
+      "resolved": "https://registry.npmjs.org/@rolldown/binding-android-arm64/-/binding-android-arm64-1.2.3.tgz",
+      "integrity": "sha512-zrJtHDcaZJ1Fp7xf4hNl+7seH9Cn/N5TwLYkhgXREtBwAd/jaqW3uqeHxpDugJLVICWg4eW44kOQEGJ1r6jCGw==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "android"
+      ],
+      "engines": {
+        "node": "^20.19.0 || >=22.12.0"
+      }
+    },
+    "node_modules/@rolldown/binding-darwin-arm64": {
+      "version": "1.2.3",
+      "resolved": "https://registry.npmjs.org/@rolldown/binding-darwin-arm64/-/binding-darwin-arm64-1.2.3.tgz",
+      "integrity": "sha512-ieIiibVCp0tX7TLu2cafoNPv8wJyYi01ekXpbf8q2j7F4rGAhhXb/eQh7ge9DRBY78GwmRQtvjZDux7EDbA8kA==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "darwin"
+      ],
+      "engines": {
+        "node": "^20.19.0 || >=22.12.0"
+      }
+    },
+    "node_modules/@rolldown/binding-darwin-x64": {
+      "version": "1.2.3",
+      "resolved": "https://registry.npmjs.org/@rolldown/binding-darwin-x64/-/binding-darwin-x64-1.2.3.tgz",
+      "integrity": "sha512-Zh9tCon19eDXJoihx0rqKhMUlMYqzwj3aPsSuHmI4RWZh62dWUL+DJN4C5YQya5TcQBJU/Fe8+rY0jhXTQITqA==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "darwin"
+      ],
+      "engines": {
+        "node": "^20.19.0 || >=22.12.0"
+      }
+    },
+    "node_modules/@rolldown/binding-freebsd-x64": {
+      "version": "1.2.3",
+      "resolved": "https://registry.npmjs.org/@rolldown/binding-freebsd-x64/-/binding-freebsd-x64-1.2.3.tgz",
+      "integrity": "sha512-nGbJWewA1wrXXZiQhjAT5rhibGfns5ZNkDVqxsO6zJ3f3YvpoDNNmGMSbbhLuXKjNScaBJVOAboztAWVespQMg==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "freebsd"
+      ],
+      "engines": {
+        "node": "^20.19.0 || >=22.12.0"
+      }
+    },
+    "node_modules/@rolldown/binding-linux-arm-gnueabihf": {
+      "version": "1.2.3",
+      "resolved": "https://registry.npmjs.org/@rolldown/binding-linux-arm-gnueabihf/-/binding-linux-arm-gnueabihf-1.2.3.tgz",
+      "integrity": "sha512-QNniJr5Kml0kDEB98jiDOJjXNroxIIi0IXIbdYzY26Xt1pVbeP62+KnoIZLwirOymX/0jDk/2gI/bNUv7A7OIw==",
+      "cpu": [
+        "arm"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": "^20.19.0 || >=22.12.0"
+      }
+    },
+    "node_modules/@rolldown/binding-linux-arm64-gnu": {
+      "version": "1.2.3",
+      "resolved": "https://registry.npmjs.org/@rolldown/binding-linux-arm64-gnu/-/binding-linux-arm64-gnu-1.2.3.tgz",
+      "integrity": "sha512-TkqEAcmmvH3I/q4114NB4RVt6241Dao48pF45uLcFGrwAaIn0iITgTAKP/dLjbN0R4buJjGb91+UHSoFmpgIWw==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": "^20.19.0 || >=22.12.0"
+      }
+    },
+    "node_modules/@rolldown/binding-linux-arm64-musl": {
+      "version": "1.2.3",
+      "resolved": "https://registry.npmjs.org/@rolldown/binding-linux-arm64-musl/-/binding-linux-arm64-musl-1.2.3.tgz",
+      "integrity": "sha512-NHqjnxpsndf4MPymxteFAWHHfkTL8HjWh1KB7z23ofZ6QO2euONuxDXjat69dKZRALnGypg8k8SsK8vZJoXv1Q==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": "^20.19.0 || >=22.12.0"
+      }
+    },
+    "node_modules/@rolldown/binding-linux-ppc64-gnu": {
+      "version": "1.2.3",
+      "resolved": "https://registry.npmjs.org/@rolldown/binding-linux-ppc64-gnu/-/binding-linux-ppc64-gnu-1.2.3.tgz",
+      "integrity": "sha512-6tbrbwfz5GB9DQ4Jwo6hy9v+vR31xZlvzZ6n5Xut6Hhx5PvrA9q/HsK8KMaYQp063iqZGXwNvZtYNLD7EM/x0w==",
+      "cpu": [
+        "ppc64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": "^20.19.0 || >=22.12.0"
+      }
+    },
+    "node_modules/@rolldown/binding-linux-s390x-gnu": {
+      "version": "1.2.3",
+      "resolved": "https://registry.npmjs.org/@rolldown/binding-linux-s390x-gnu/-/binding-linux-s390x-gnu-1.2.3.tgz",
+      "integrity": "sha512-oyuXxXmoZHjXC917IAPFAAv4wWAa0cM9afk8nx1+9/jNNOX1uPf8yDA6p7G0RypOfw/X0PQt5IfoquY1um+zSg==",
+      "cpu": [
+        "s390x"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": "^20.19.0 || >=22.12.0"
+      }
+    },
+    "node_modules/@rolldown/binding-linux-x64-gnu": {
+      "version": "1.2.3",
+      "resolved": "https://registry.npmjs.org/@rolldown/binding-linux-x64-gnu/-/binding-linux-x64-gnu-1.2.3.tgz",
+      "integrity": "sha512-TytMwF2KVGqP2tgd0I1OY0PAv78dZRAYcF5ssDzjM34SUXCED3uXvSd5+lHoC0bTD6eEdFz7LdQNCO1y0oVk9w==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": "^20.19.0 || >=22.12.0"
+      }
+    },
+    "node_modules/@rolldown/binding-linux-x64-musl": {
+      "version": "1.2.3",
+      "resolved": "https://registry.npmjs.org/@rolldown/binding-linux-x64-musl/-/binding-linux-x64-musl-1.2.3.tgz",
+      "integrity": "sha512-/E9m3qstrJFVPoULV25mVQblSNExY2+kBsYe4sy0Tn0yOOgJ8wZbZt3KnRbF/XeU2Gl1STKUQnDNTqhIE5MD4A==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": "^20.19.0 || >=22.12.0"
+      }
+    },
+    "node_modules/@rolldown/binding-openharmony-arm64": {
+      "version": "1.2.3",
+      "resolved": "https://registry.npmjs.org/@rolldown/binding-openharmony-arm64/-/binding-openharmony-arm64-1.2.3.tgz",
+      "integrity": "sha512-Kr0OcsoQI816i6HOl3vFHpd1K0eZyh76zgfj4c1nTyaTsd5r2Mj1lwM4R90y/qaCfmTn9eHy0SKwi98eitRxug==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "openharmony"
+      ],
+      "engines": {
+        "node": "^20.19.0 || >=22.12.0"
+      }
+    },
+    "node_modules/@rolldown/binding-win32-arm64-msvc": {
+      "version": "1.2.3",
+      "resolved": "https://registry.npmjs.org/@rolldown/binding-win32-arm64-msvc/-/binding-win32-arm64-msvc-1.2.3.tgz",
+      "integrity": "sha512-hOtMwTqnME+/gJcH/PCZ0wn0zPUjiWOgkHpxbSJpfGKMezHltx1S7/k1SitzVa7Ww2cqrDDaFbZEhcJZO8o+Jw==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ],
+      "engines": {
+        "node": "^20.19.0 || >=22.12.0"
+      }
+    },
+    "node_modules/@rolldown/binding-win32-x64-msvc": {
+      "version": "1.2.3",
+      "resolved": "https://registry.npmjs.org/@rolldown/binding-win32-x64-msvc/-/binding-win32-x64-msvc-1.2.3.tgz",
+      "integrity": "sha512-ekcqMMkI2PlhYnfzQnB/cEdYUVVJViWvoUyLrbzgDoi3Snfc1mVBwdnc306ufA5ejy8JSPjT2RlW1nQSjW7efg==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ],
+      "engines": {
+        "node": "^20.19.0 || >=22.12.0"
+      }
+    },
+    "node_modules/@rolldown/pluginutils": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/@rolldown/pluginutils/-/pluginutils-1.0.1.tgz",
+      "integrity": "sha512-2j9bGt5Jh8hj+vPtgzPtl72j0yRxHAyumoo6TNfAjsLB04UtpSvPbPcDcBMxz7n+9CYB0c1GxQFxYRg2jimqGw==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/@rollup/rollup-android-arm-eabi": {
+      "version": "4.62.4",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-android-arm-eabi/-/rollup-android-arm-eabi-4.62.4.tgz",
+      "integrity": "sha512-RrPokAb7dmbxFoeO3TloqHyOjgye8RkBhSqmp4aJMIex4c9r46ZstPnleDQOq1t46VOVjwIuwNogIqbodV1Vvg==",
+      "cpu": [
+        "arm"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "android"
+      ]
+    },
+    "node_modules/@rollup/rollup-android-arm64": {
+      "version": "4.62.4",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-android-arm64/-/rollup-android-arm64-4.62.4.tgz",
+      "integrity": "sha512-JKuJc+pnpks2pjy7L/N3v/cAkZxYlnmuZoD840ldbMI5KDbC4iO9NKwPKYdjYFCMAIIlBzYSFHxIJVYzRo2/8A==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "android"
+      ]
+    },
+    "node_modules/@rollup/rollup-darwin-arm64": {
+      "version": "4.62.4",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-darwin-arm64/-/rollup-darwin-arm64-4.62.4.tgz",
+      "integrity": "sha512-krw5uS2STmvJ02x0uTXHbqQNuz+9eZ1iw+qXk9dmW2gvV4jV7O2hEoOnuhFrpOPiel1mBFtqbxYZZtC46hXLOw==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "darwin"
+      ]
+    },
+    "node_modules/@rollup/rollup-darwin-x64": {
+      "version": "4.62.4",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-darwin-x64/-/rollup-darwin-x64-4.62.4.tgz",
+      "integrity": "sha512-wsTxtgApb4PrOsNJIm0FZ1h3WvCC+k9uxLJ4ad75hgoS4NiRes2SoJFlDAyMwiUY8IssDqGcHbXuN0sx1tfF1A==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "darwin"
+      ]
+    },
+    "node_modules/@rollup/rollup-freebsd-arm64": {
+      "version": "4.62.4",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-freebsd-arm64/-/rollup-freebsd-arm64-4.62.4.tgz",
+      "integrity": "sha512-GUOnQlyZe3yAXhWOtOMsn5Qkrv5E5mZXa0thbARWi5Ei2szlVXJFQhddZ4HbAzh8q92w5twp+CQvs/eFanz9YQ==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "freebsd"
+      ]
+    },
+    "node_modules/@rollup/rollup-freebsd-x64": {
+      "version": "4.62.4",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-freebsd-x64/-/rollup-freebsd-x64-4.62.4.tgz",
+      "integrity": "sha512-/Y7f3QuxjzPKsjA/rfEDa3+0vXqyjmJ50Ln8dPpCmWkKTrUoWHG1cWhTqaAMLob2m2nESWuC7yGrREz019Ztqg==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "freebsd"
+      ]
+    },
+    "node_modules/@rollup/rollup-linux-arm-gnueabihf": {
+      "version": "4.62.4",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm-gnueabihf/-/rollup-linux-arm-gnueabihf-4.62.4.tgz",
+      "integrity": "sha512-81wiiX3v7aqy+T+bT61TJ78yJjRquqFFTTbAPt08imfQQzkPIW8t6aJbkTagtCCrXMNc9D66+geqlK7ydLPNqA==",
+      "cpu": [
+        "arm"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@rollup/rollup-linux-arm-musleabihf": {
+      "version": "4.62.4",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm-musleabihf/-/rollup-linux-arm-musleabihf-4.62.4.tgz",
+      "integrity": "sha512-9kmDIvNZqdoHOBZgNtpTBeLWYO/LVipM3H/j62P8848/l/VPEQL6N3uxU9pvP1oZAsXyC2MEnFP3ovRjo7WYNQ==",
+      "cpu": [
+        "arm"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@rollup/rollup-linux-arm64-gnu": {
+      "version": "4.62.4",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm64-gnu/-/rollup-linux-arm64-gnu-4.62.4.tgz",
+      "integrity": "sha512-CcnXHWnXg69g+DX5VWL3FHts3qMRN2uVEHX+BZvGLdd07/gXkn3ePjYtO1LDJvxkGKVHMclKBRa1QUTH+6toYQ==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@rollup/rollup-linux-arm64-musl": {
+      "version": "4.62.4",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm64-musl/-/rollup-linux-arm64-musl-4.62.4.tgz",
+      "integrity": "sha512-iFOibiHnTRuhrWLlRsOQFdZJJIa7S8OwkneJr4ocALP16u5yk6lWLINFwhHaEqBFMsKDUZofLkGos7+CPzGB3g==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@rollup/rollup-linux-loong64-gnu": {
+      "version": "4.62.4",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-loong64-gnu/-/rollup-linux-loong64-gnu-4.62.4.tgz",
+      "integrity": "sha512-XnWYMI7euHlb5a871xPja+Gm7DRCFU+FGRrtS2sMq9N8FvqtpagUy6gD4YOemC5MRk9xbh8+jYMEJbigFQwsgA==",
+      "cpu": [
+        "loong64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@rollup/rollup-linux-loong64-musl": {
+      "version": "4.62.4",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-loong64-musl/-/rollup-linux-loong64-musl-4.62.4.tgz",
+      "integrity": "sha512-qGDAlO0U8xedCcsdRm9oaoQY8DAx/QT7uIxJWhCdx0ceIWX783UC9QSYkdpzAe29wNiVfp24+bZdQmn49o45SQ==",
+      "cpu": [
+        "loong64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@rollup/rollup-linux-ppc64-gnu": {
+      "version": "4.62.4",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-ppc64-gnu/-/rollup-linux-ppc64-gnu-4.62.4.tgz",
+      "integrity": "sha512-ru4H6ezD7ysA5EiEK6qkkaEb4modH8CTej6kUy/gQi20u3kB3G7Zn8snXXkeJSCOFKG/rbPPtM/+9Wgas1961w==",
+      "cpu": [
+        "ppc64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@rollup/rollup-linux-ppc64-musl": {
+      "version": "4.62.4",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-ppc64-musl/-/rollup-linux-ppc64-musl-4.62.4.tgz",
+      "integrity": "sha512-2W4MO5WQVJnbJaZdvDb9rhBDuFU1nKIepPFpJUBsTh2k1YY2g+ODViaWuyOAjQ5cOP7NvrvLzt3wvHOoiAvc7w==",
+      "cpu": [
+        "ppc64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@rollup/rollup-linux-riscv64-gnu": {
+      "version": "4.62.4",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-riscv64-gnu/-/rollup-linux-riscv64-gnu-4.62.4.tgz",
+      "integrity": "sha512-+fxjfuoAmVMCYV5QyjoIpu0cp5DOiOTeqYFk1AVaxGr+/ravWLX89XfQmptsoWcaVy/TGf2hexzbUOrCQIL1CQ==",
+      "cpu": [
+        "riscv64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@rollup/rollup-linux-riscv64-musl": {
+      "version": "4.62.4",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-riscv64-musl/-/rollup-linux-riscv64-musl-4.62.4.tgz",
+      "integrity": "sha512-jTn8JfHGL4djjFxPuM06LmNUJDsst2jeVlsd9OmIH6zc5sC9K6rIuO4YajXatLUpBmBKl6b35ro1QZocLi+tcA==",
+      "cpu": [
+        "riscv64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@rollup/rollup-linux-s390x-gnu": {
+      "version": "4.62.4",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-s390x-gnu/-/rollup-linux-s390x-gnu-4.62.4.tgz",
+      "integrity": "sha512-oCJCJL4pXsoDcP2QZ+JVlPTIRc6266zsIaeJJsWImmF7HO0W8nb6HuSgZlMWxJwaPf8ehbSw8yo0EUw925hKsA==",
+      "cpu": [
+        "s390x"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@rollup/rollup-linux-x64-gnu": {
+      "version": "4.62.4",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-x64-gnu/-/rollup-linux-x64-gnu-4.62.4.tgz",
+      "integrity": "sha512-W69hukhZ3KKNRCaMIEzKvcFye42hh0FE1+YoYaf5+Ikacuftoco6yO/xouz0hc5d5W/s3yBro5jRiuEE/Q5vUw==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@rollup/rollup-linux-x64-musl": {
+      "version": "4.62.4",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-x64-musl/-/rollup-linux-x64-musl-4.62.4.tgz",
+      "integrity": "sha512-qiXbGG2jkjXhzXpsFZSR2Xpb8DN/UaxYsbb/STbuR/6fpaDgRmmaq1B/LmtF2wQFOFOSsK2jdE0RZ3a0zHn4QA==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@rollup/rollup-openbsd-x64": {
+      "version": "4.62.4",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-openbsd-x64/-/rollup-openbsd-x64-4.62.4.tgz",
+      "integrity": "sha512-nWeM//hxv8mIo6jD7Hu4o48DVmV9pbV6gsKaWU+4NFyqHoPKwrkRiZGLKUhOBk8qNmDmpwFtPKg80Bo/Tn4xiQ==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "openbsd"
+      ]
+    },
+    "node_modules/@rollup/rollup-openharmony-arm64": {
+      "version": "4.62.4",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-openharmony-arm64/-/rollup-openharmony-arm64-4.62.4.tgz",
+      "integrity": "sha512-s62SQ/vgsRSvMwDkOEfTqfgASF0f26ZNaQuTA6Aok5lrikf89yI2W0gFHvZb2Jpgc6N8JnOKZgCK2iciO3CsxQ==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "openharmony"
+      ]
+    },
+    "node_modules/@rollup/rollup-win32-arm64-msvc": {
+      "version": "4.62.4",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-arm64-msvc/-/rollup-win32-arm64-msvc-4.62.4.tgz",
+      "integrity": "sha512-J6wGf8TVGbXJq+HH+ttTvrcfNKPbuZecV6KT1B8I18BC5IURUh5kl4Yl5OEP5eFIUoI5BWxCsyYMhFsDx8kekw==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ]
+    },
+    "node_modules/@rollup/rollup-win32-ia32-msvc": {
+      "version": "4.62.4",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-ia32-msvc/-/rollup-win32-ia32-msvc-4.62.4.tgz",
+      "integrity": "sha512-zmfrQd/0wu6oJs8Vq8KwY/YtsKSsLtKe/HwAP4Wqy8LhWjeT55fHRAkOhYQ12wI3ayS4Tt12d5CDRD7N96SAYQ==",
+      "cpu": [
+        "ia32"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ]
+    },
+    "node_modules/@rollup/rollup-win32-x64-gnu": {
+      "version": "4.62.4",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-x64-gnu/-/rollup-win32-x64-gnu-4.62.4.tgz",
+      "integrity": "sha512-qPzHqdj9rfUD+w79dtE07zi/kFwKyCJqplp5K5ygeLTp7jLpAoc16OAH39HSmRC9UpozaecsleI8uAdEj6v2yw==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ]
+    },
+    "node_modules/@rollup/rollup-win32-x64-msvc": {
+      "version": "4.62.4",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-x64-msvc/-/rollup-win32-x64-msvc-4.62.4.tgz",
+      "integrity": "sha512-zD6NdeWEByGE9QF9vCrlJ5YQB4oq9q91kPZS37Jwj5hOkvR1lTBSpsKhKDw4IJtbQ35LsTS1HD9DZYGKIshU1Q==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ]
+    },
+    "node_modules/@tiptap/core": {
+      "version": "3.29.2",
+      "resolved": "https://registry.npmjs.org/@tiptap/core/-/core-3.29.2.tgz",
+      "integrity": "sha512-oKUkiPUB7noilVYxI9lNzUD4rX17sHub+PYjMfHMWHG9A3nvIy+FdePIVIIhThKWF7ijhr3eIqHY51Bn+GAFtw==",
+      "license": "MIT",
+      "funding": {
+        "type": "github",
+        "url": "https://github.com/sponsors/ueberdosis"
+      },
+      "peerDependencies": {
+        "@tiptap/pm": "3.29.2"
+      }
+    },
+    "node_modules/@tiptap/extension-blockquote": {
+      "version": "3.29.2",
+      "resolved": "https://registry.npmjs.org/@tiptap/extension-blockquote/-/extension-blockquote-3.29.2.tgz",
+      "integrity": "sha512-ca4OzKDh0yaxg2+Z56bC2QnWsNsFp2YMRfVig1PDXyMVFMNJpLcnhxgq/9btn+xYAlYrj8RymOeCTYREOR6Zjg==",
+      "license": "MIT",
+      "funding": {
+        "type": "github",
+        "url": "https://github.com/sponsors/ueberdosis"
+      },
+      "peerDependencies": {
+        "@tiptap/core": "3.29.2",
+        "@tiptap/pm": "3.29.2"
+      }
+    },
+    "node_modules/@tiptap/extension-bold": {
+      "version": "3.29.2",
+      "resolved": "https://registry.npmjs.org/@tiptap/extension-bold/-/extension-bold-3.29.2.tgz",
+      "integrity": "sha512-elYbGxJsYnBb4leqrcjdIJuiG380BcOgN+UUzvOv+qEjfGVzHodFOMBl3qnmD6urYHNu5/qQK2S0qSSRXKCLNQ==",
+      "license": "MIT",
+      "funding": {
+        "type": "github",
+        "url": "https://github.com/sponsors/ueberdosis"
+      },
+      "peerDependencies": {
+        "@tiptap/core": "3.29.2"
+      }
+    },
+    "node_modules/@tiptap/extension-bubble-menu": {
+      "version": "3.29.2",
+      "resolved": "https://registry.npmjs.org/@tiptap/extension-bubble-menu/-/extension-bubble-menu-3.29.2.tgz",
+      "integrity": "sha512-kzcWarcpr031rZu+R3Hzut5uxb3Qj/xxMDEYZIQ3uiq1yb5vEMXj8/SIyWautk6Nu8Rr1leV3rGdR4NzhzyFAA==",
+      "license": "MIT",
+      "optional": true,
+      "dependencies": {
+        "@floating-ui/dom": "^1.0.0"
+      },
+      "funding": {
+        "type": "github",
+        "url": "https://github.com/sponsors/ueberdosis"
+      },
+      "peerDependencies": {
+        "@tiptap/core": "3.29.2",
+        "@tiptap/pm": "3.29.2"
+      }
+    },
+    "node_modules/@tiptap/extension-bullet-list": {
+      "version": "3.29.2",
+      "resolved": "https://registry.npmjs.org/@tiptap/extension-bullet-list/-/extension-bullet-list-3.29.2.tgz",
+      "integrity": "sha512-3bWcCUPbCHv0XttlMdnAtXLNYWx2pblByMgxmGsaP9FU0QnslGXty6A6gHCqI33ygRg1vrA6U5Wtpwbi5aKu5g==",
+      "license": "MIT",
+      "funding": {
+        "type": "github",
+        "url": "https://github.com/sponsors/ueberdosis"
+      },
+      "peerDependencies": {
+        "@tiptap/extension-list": "3.29.2"
+      }
+    },
+    "node_modules/@tiptap/extension-code": {
+      "version": "3.29.2",
+      "resolved": "https://registry.npmjs.org/@tiptap/extension-code/-/extension-code-3.29.2.tgz",
+      "integrity": "sha512-c6W5UGuB7WNLpYocsgRzpO2OOTI4QjaI9jjHRMuty9z+s9DtaYM/HrRLNwVh6MopkHb+i/89Wkv8gCS34fftig==",
+      "license": "MIT",
+      "funding": {
+        "type": "github",
+        "url": "https://github.com/sponsors/ueberdosis"
+      },
+      "peerDependencies": {
+        "@tiptap/core": "3.29.2"
+      }
+    },
+    "node_modules/@tiptap/extension-code-block": {
+      "version": "3.29.2",
+      "resolved": "https://registry.npmjs.org/@tiptap/extension-code-block/-/extension-code-block-3.29.2.tgz",
+      "integrity": "sha512-w153ct8g6dLiPTdXQ6SOIMxX4SEo5Q50AmjdEEEcJ7ZcYUcde/ScSskLHfOYmyt5ZFAiyEwr121+pux+p3/oAQ==",
+      "license": "MIT",
+      "funding": {
+        "type": "github",
+        "url": "https://github.com/sponsors/ueberdosis"
+      },
+      "peerDependencies": {
+        "@tiptap/core": "3.29.2",
+        "@tiptap/pm": "3.29.2"
+      }
+    },
+    "node_modules/@tiptap/extension-document": {
+      "version": "3.29.2",
+      "resolved": "https://registry.npmjs.org/@tiptap/extension-document/-/extension-document-3.29.2.tgz",
+      "integrity": "sha512-YUamvefLnsqu6124GavVTI7nqcFlQJ12ROB0oSwG69eSBZYNjg1tIs05LFrBxkwf4Xgqd6YzfJ9+FeG428RvzQ==",
+      "license": "MIT",
+      "funding": {
+        "type": "github",
+        "url": "https://github.com/sponsors/ueberdosis"
+      },
+      "peerDependencies": {
+        "@tiptap/core": "3.29.2"
+      }
+    },
+    "node_modules/@tiptap/extension-dropcursor": {
+      "version": "3.29.2",
+      "resolved": "https://registry.npmjs.org/@tiptap/extension-dropcursor/-/extension-dropcursor-3.29.2.tgz",
+      "integrity": "sha512-KKno7cU9r1HdR48CRrsDu69/1UjZdoslq/UcE+Kx+tdhAv/aljXMkRSNzGMrBNOBDmHRgS1+58zm21WQWdQzwA==",
+      "license": "MIT",
+      "funding": {
+        "type": "github",
+        "url": "https://github.com/sponsors/ueberdosis"
+      },
+      "peerDependencies": {
+        "@tiptap/extensions": "3.29.2"
+      }
+    },
+    "node_modules/@tiptap/extension-floating-menu": {
+      "version": "3.29.2",
+      "resolved": "https://registry.npmjs.org/@tiptap/extension-floating-menu/-/extension-floating-menu-3.29.2.tgz",
+      "integrity": "sha512-CBTq4Xs5aGWr65uFCIkKBms796OhmirWf/ax//iJ4fl9IfwqjwFuc2vQs9PmuwpKn9ctDHo2sMTtvyeCvIt5LQ==",
+      "license": "MIT",
+      "optional": true,
+      "funding": {
+        "type": "github",
+        "url": "https://github.com/sponsors/ueberdosis"
+      },
+      "peerDependencies": {
+        "@floating-ui/dom": "^1.0.0",
+        "@tiptap/core": "3.29.2",
+        "@tiptap/pm": "3.29.2"
+      }
+    },
+    "node_modules/@tiptap/extension-font-family": {
+      "version": "3.29.2",
+      "resolved": "https://registry.npmjs.org/@tiptap/extension-font-family/-/extension-font-family-3.29.2.tgz",
+      "integrity": "sha512-HDq9+V8LbDFH1aQRH5Au0pmoDQ7bfa/C/k50a9mujzmA/PE7mLQkduUFfyDdiN4L60p7TVJAOJaN/loGC8PDxA==",
+      "license": "MIT",
+      "funding": {
+        "type": "github",
+        "url": "https://github.com/sponsors/ueberdosis"
+      },
+      "peerDependencies": {
+        "@tiptap/extension-text-style": "3.29.2"
+      }
+    },
+    "node_modules/@tiptap/extension-gapcursor": {
+      "version": "3.29.2",
+      "resolved": "https://registry.npmjs.org/@tiptap/extension-gapcursor/-/extension-gapcursor-3.29.2.tgz",
+      "integrity": "sha512-8Q39UR4/Tit759IeW9xZIe3NMwN11GsuA3FLheDyyGn7RrW02HD3HhUDlazE54Ki4HoosjFmChPlN4Ik2ubdRQ==",
+      "license": "MIT",
+      "funding": {
+        "type": "github",
+        "url": "https://github.com/sponsors/ueberdosis"
+      },
+      "peerDependencies": {
+        "@tiptap/extensions": "3.29.2"
+      }
+    },
+    "node_modules/@tiptap/extension-hard-break": {
+      "version": "3.29.2",
+      "resolved": "https://registry.npmjs.org/@tiptap/extension-hard-break/-/extension-hard-break-3.29.2.tgz",
+      "integrity": "sha512-eUW3LN3fq8rXnjEUeI3D2QONYdLsU3yYQm4jxlErs2h4cfwrFjgf19VSUFVmm6LrFbbQ0OnDVPeVLL6iOwDw2w==",
+      "license": "MIT",
+      "funding": {
+        "type": "github",
+        "url": "https://github.com/sponsors/ueberdosis"
+      },
+      "peerDependencies": {
+        "@tiptap/core": "3.29.2"
+      }
+    },
+    "node_modules/@tiptap/extension-heading": {
+      "version": "3.29.2",
+      "resolved": "https://registry.npmjs.org/@tiptap/extension-heading/-/extension-heading-3.29.2.tgz",
+      "integrity": "sha512-6W4aIy70Mh7BNlbG9zZ5FBLhJhU2UUEzgZJ/jwYSCcB30o8McLxJSEjhtoHiX8R78Ah2/JzBGvIe5olZlbeE4A==",
+      "license": "MIT",
+      "funding": {
+        "type": "github",
+        "url": "https://github.com/sponsors/ueberdosis"
+      },
+      "peerDependencies": {
+        "@tiptap/core": "3.29.2"
+      }
+    },
+    "node_modules/@tiptap/extension-horizontal-rule": {
+      "version": "3.29.2",
+      "resolved": "https://registry.npmjs.org/@tiptap/extension-horizontal-rule/-/extension-horizontal-rule-3.29.2.tgz",
+      "integrity": "sha512-8/ZPzbB9X85Mc9/7xVLZupQKBr2UVcQTGr512xtqMW+XkCQRHCph46tRo828YE13IMWI5fWn/FaNCqXG9cULSw==",
+      "license": "MIT",
+      "funding": {
+        "type": "github",
+        "url": "https://github.com/sponsors/ueberdosis"
+      },
+      "peerDependencies": {
+        "@tiptap/core": "3.29.2",
+        "@tiptap/pm": "3.29.2"
+      }
+    },
+    "node_modules/@tiptap/extension-italic": {
+      "version": "3.29.2",
+      "resolved": "https://registry.npmjs.org/@tiptap/extension-italic/-/extension-italic-3.29.2.tgz",
+      "integrity": "sha512-iH63V/5wsaMnY4Jz0+meaAGhaec4AiOzOduzl6ZZr5IyGhZ1kthyW84ELt0dyLI3hNceAUhaNWc+I7+vX0aoXA==",
+      "license": "MIT",
+      "funding": {
+        "type": "github",
+        "url": "https://github.com/sponsors/ueberdosis"
+      },
+      "peerDependencies": {
+        "@tiptap/core": "3.29.2"
+      }
+    },
+    "node_modules/@tiptap/extension-link": {
+      "version": "3.29.2",
+      "resolved": "https://registry.npmjs.org/@tiptap/extension-link/-/extension-link-3.29.2.tgz",
+      "integrity": "sha512-DcVer5SqrexKCEP6Ip1UPxJUMvcRCCItSv0wxoGytanrimBh2smvcg6X0DWnjlsi5H0updhyl+atYCmmQXUIXA==",
+      "license": "MIT",
+      "dependencies": {
+        "linkifyjs": "^4.3.3"
+      },
+      "funding": {
+        "type": "github",
+        "url": "https://github.com/sponsors/ueberdosis"
+      },
+      "peerDependencies": {
+        "@tiptap/core": "3.29.2",
+        "@tiptap/pm": "3.29.2"
+      }
+    },
+    "node_modules/@tiptap/extension-list": {
+      "version": "3.29.2",
+      "resolved": "https://registry.npmjs.org/@tiptap/extension-list/-/extension-list-3.29.2.tgz",
+      "integrity": "sha512-WPZ9BHAPT6QeIm1vdVkuoOWvy9a8/EZeJwV2VhU8LXyTAttvzyj4rsbbHyJWvYWlUSTt/QF2AZ2zhKo7u1w3/A==",
+      "license": "MIT",
+      "funding": {
+        "type": "github",
+        "url": "https://github.com/sponsors/ueberdosis"
+      },
+      "peerDependencies": {
+        "@tiptap/core": "3.29.2",
+        "@tiptap/pm": "3.29.2"
+      }
+    },
+    "node_modules/@tiptap/extension-list-item": {
+      "version": "3.29.2",
+      "resolved": "https://registry.npmjs.org/@tiptap/extension-list-item/-/extension-list-item-3.29.2.tgz",
+      "integrity": "sha512-s8vBVHHFT0Qpu7CzAZ7S1kYmSiVaDvUNvMNcZUWnxj6VPfiwmx0eXd9FsjePrRCMoM5tFmPnhFTHDxY3D/eZeQ==",
+      "license": "MIT",
+      "funding": {
+        "type": "github",
+        "url": "https://github.com/sponsors/ueberdosis"
+      },
+      "peerDependencies": {
+        "@tiptap/extension-list": "3.29.2"
+      }
+    },
+    "node_modules/@tiptap/extension-list-keymap": {
+      "version": "3.29.2",
+      "resolved": "https://registry.npmjs.org/@tiptap/extension-list-keymap/-/extension-list-keymap-3.29.2.tgz",
+      "integrity": "sha512-R+3k8OLnxdCH7Xy9ieOwUt5m2Je74u8mikothGmsYVO2Zyq48fIbmZ+X6RBPCu7DBOI2FIUhHEFbKQeDWvDNmA==",
+      "license": "MIT",
+      "funding": {
+        "type": "github",
+        "url": "https://github.com/sponsors/ueberdosis"
+      },
+      "peerDependencies": {
+        "@tiptap/extension-list": "3.29.2"
+      }
+    },
+    "node_modules/@tiptap/extension-ordered-list": {
+      "version": "3.29.2",
+      "resolved": "https://registry.npmjs.org/@tiptap/extension-ordered-list/-/extension-ordered-list-3.29.2.tgz",
+      "integrity": "sha512-ndCunC+UsYOpkOtL7vGnDz21UNa45WUlcO9wMT1fbuYow2QnRhsuMlCWENXI52YPPARWuQ0RDgN7q6TaxPERBg==",
+      "license": "MIT",
+      "funding": {
+        "type": "github",
+        "url": "https://github.com/sponsors/ueberdosis"
+      },
+      "peerDependencies": {
+        "@tiptap/extension-list": "3.29.2"
+      }
+    },
+    "node_modules/@tiptap/extension-paragraph": {
+      "version": "3.29.2",
+      "resolved": "https://registry.npmjs.org/@tiptap/extension-paragraph/-/extension-paragraph-3.29.2.tgz",
+      "integrity": "sha512-7qJj5YTr11vvjNgjDN1ypOfwTovc0QOCYcit/rskeuVgnmQZOZQzC/BbyKLLG7UGnpRLemU/mEGbW9pAqjAXkQ==",
+      "license": "MIT",
+      "funding": {
+        "type": "github",
+        "url": "https://github.com/sponsors/ueberdosis"
+      },
+      "peerDependencies": {
+        "@tiptap/core": "3.29.2"
+      }
+    },
+    "node_modules/@tiptap/extension-strike": {
+      "version": "3.29.2",
+      "resolved": "https://registry.npmjs.org/@tiptap/extension-strike/-/extension-strike-3.29.2.tgz",
+      "integrity": "sha512-aEvLAbddUQZ+FukCreV3q4G2HfNI+odE7E9U+wbq6XsSWKyo8/pDu1muz+TFKNre4blSMOQ3JQmw5UeHDKy+fg==",
+      "license": "MIT",
+      "funding": {
+        "type": "github",
+        "url": "https://github.com/sponsors/ueberdosis"
+      },
+      "peerDependencies": {
+        "@tiptap/core": "3.29.2"
+      }
+    },
+    "node_modules/@tiptap/extension-text": {
+      "version": "3.29.2",
+      "resolved": "https://registry.npmjs.org/@tiptap/extension-text/-/extension-text-3.29.2.tgz",
+      "integrity": "sha512-Ubko45JWWHe8glBt2PiGNF8hcbys/JNalFhiR7Y1X4iOOtAxAKJJxh3+eq+//NTlGuBPdWGp7zw8EEUp7anjKA==",
+      "license": "MIT",
+      "funding": {
+        "type": "github",
+        "url": "https://github.com/sponsors/ueberdosis"
+      },
+      "peerDependencies": {
+        "@tiptap/core": "3.29.2"
+      }
+    },
+    "node_modules/@tiptap/extension-text-style": {
+      "version": "3.29.2",
+      "resolved": "https://registry.npmjs.org/@tiptap/extension-text-style/-/extension-text-style-3.29.2.tgz",
+      "integrity": "sha512-aQad9V9ROaEi3hE4g5z9wQ6lv5FSnzlnWFMVJxRjNlwXgm7H0fymxb4rGfca+pAwYkiRwpKYh1LatpJw2ECQAA==",
+      "license": "MIT",
+      "funding": {
+        "type": "github",
+        "url": "https://github.com/sponsors/ueberdosis"
+      },
+      "peerDependencies": {
+        "@tiptap/core": "3.29.2"
+      }
+    },
+    "node_modules/@tiptap/extension-underline": {
+      "version": "3.29.2",
+      "resolved": "https://registry.npmjs.org/@tiptap/extension-underline/-/extension-underline-3.29.2.tgz",
+      "integrity": "sha512-K7XwH/xS/5AIREWQ00VTEf/W5U0olp7j6wwit7cdd/8nHv6h6AGr1+iEApHKoLXWQZLfGQKzJlT9W61LAl+fHA==",
+      "license": "MIT",
+      "funding": {
+        "type": "github",
+        "url": "https://github.com/sponsors/ueberdosis"
+      },
+      "peerDependencies": {
+        "@tiptap/core": "3.29.2"
+      }
+    },
+    "node_modules/@tiptap/extensions": {
+      "version": "3.29.2",
+      "resolved": "https://registry.npmjs.org/@tiptap/extensions/-/extensions-3.29.2.tgz",
+      "integrity": "sha512-BCz+FCAChSYtUe4BFj97HEO+nSK+J7GxbJgZG4Hg7DT/gI+hRyeNndU8efiQAx3WGdzsFi3UxRpcF1tTQM7iMQ==",
+      "license": "MIT",
+      "funding": {
+        "type": "github",
+        "url": "https://github.com/sponsors/ueberdosis"
+      },
+      "peerDependencies": {
+        "@tiptap/core": "3.29.2",
+        "@tiptap/pm": "3.29.2"
+      }
+    },
+    "node_modules/@tiptap/pm": {
+      "version": "3.29.2",
+      "resolved": "https://registry.npmjs.org/@tiptap/pm/-/pm-3.29.2.tgz",
+      "integrity": "sha512-GCOme7xHaS+DSoaA4CDcAD3l6JyBlvZhvCyfsy2Vp6j8tEoBkZWio7soYVosmlyn7zq8/64VeFZP5s47yfG7fQ==",
+      "license": "MIT",
+      "dependencies": {
+        "prosemirror-changeset": "^2.4.1",
+        "prosemirror-commands": "^1.7.1",
+        "prosemirror-dropcursor": "^1.8.2",
+        "prosemirror-gapcursor": "^1.4.1",
+        "prosemirror-history": "^1.5.0",
+        "prosemirror-inputrules": "^1.5.1",
+        "prosemirror-keymap": "^1.2.3",
+        "prosemirror-model": "^1.25.11",
+        "prosemirror-schema-list": "^1.5.1",
+        "prosemirror-state": "^1.4.4",
+        "prosemirror-tables": "^1.8.5",
+        "prosemirror-transform": "^1.12.0",
+        "prosemirror-view": "^1.41.9"
+      },
+      "funding": {
+        "type": "github",
+        "url": "https://github.com/sponsors/ueberdosis"
+      }
+    },
+    "node_modules/@tiptap/starter-kit": {
+      "version": "3.29.2",
+      "resolved": "https://registry.npmjs.org/@tiptap/starter-kit/-/starter-kit-3.29.2.tgz",
+      "integrity": "sha512-oTu0tysiqk4zgjEtxRHjAQgxUKaAevZwueOWwSWubHdokqp7SpcbE5n9USJv89HKuTUDm3GjnQH6q8HNn/2DsA==",
+      "license": "MIT",
+      "dependencies": {
+        "@tiptap/core": "^3.29.2",
+        "@tiptap/extension-blockquote": "^3.29.2",
+        "@tiptap/extension-bold": "^3.29.2",
+        "@tiptap/extension-bullet-list": "^3.29.2",
+        "@tiptap/extension-code": "^3.29.2",
+        "@tiptap/extension-code-block": "^3.29.2",
+        "@tiptap/extension-document": "^3.29.2",
+        "@tiptap/extension-dropcursor": "^3.29.2",
+        "@tiptap/extension-gapcursor": "^3.29.2",
+        "@tiptap/extension-hard-break": "^3.29.2",
+        "@tiptap/extension-heading": "^3.29.2",
+        "@tiptap/extension-horizontal-rule": "^3.29.2",
+        "@tiptap/extension-italic": "^3.29.2",
+        "@tiptap/extension-link": "^3.29.2",
+        "@tiptap/extension-list": "^3.29.2",
+        "@tiptap/extension-list-item": "^3.29.2",
+        "@tiptap/extension-list-keymap": "^3.29.2",
+        "@tiptap/extension-ordered-list": "^3.29.2",
+        "@tiptap/extension-paragraph": "^3.29.2",
+        "@tiptap/extension-strike": "^3.29.2",
+        "@tiptap/extension-text": "^3.29.2",
+        "@tiptap/extension-underline": "^3.29.2",
+        "@tiptap/extensions": "^3.29.2",
+        "@tiptap/pm": "^3.29.2"
+      },
+      "funding": {
+        "type": "github",
+        "url": "https://github.com/sponsors/ueberdosis"
+      }
+    },
+    "node_modules/@tiptap/vue-3": {
+      "version": "3.29.2",
+      "resolved": "https://registry.npmjs.org/@tiptap/vue-3/-/vue-3-3.29.2.tgz",
+      "integrity": "sha512-rLX+V+HXbsVlk+My8mslvbnbVXZiQZHYtbOiRgxugsqZ9SK1mr1FpgZ/ZNcotJAjecT8FJmPa45ccDnVu66eGA==",
+      "license": "MIT",
+      "funding": {
+        "type": "github",
+        "url": "https://github.com/sponsors/ueberdosis"
+      },
+      "optionalDependencies": {
+        "@tiptap/extension-bubble-menu": "^3.29.2",
+        "@tiptap/extension-floating-menu": "^3.29.2"
+      },
+      "peerDependencies": {
+        "@floating-ui/dom": "^1.0.0",
+        "@tiptap/core": "3.29.2",
+        "@tiptap/pm": "3.29.2",
+        "vue": "^3.0.0"
+      }
+    },
+    "node_modules/@tsconfig/node24": {
+      "version": "24.0.4",
+      "resolved": "https://registry.npmjs.org/@tsconfig/node24/-/node24-24.0.4.tgz",
+      "integrity": "sha512-2A933l5P5oCbv6qSxHs7ckKwobs8BDAe9SJ/Xr2Hy+nDlwmLE1GhFh/g/vXGRZWgxBg9nX/5piDtHR9Dkw/XuA==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/@tybys/wasm-util": {
+      "version": "0.10.3",
+      "resolved": "https://registry.npmjs.org/@tybys/wasm-util/-/wasm-util-0.10.3.tgz",
+      "integrity": "sha512-F3fo1MYrRJYL3zER0OUOmkutjr1Vp23m7OsSgp7nq4SP6OqX6C/56XFIPAl5bt3zaBRjmW7SGz3u/6LwFpYcOg==",
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "dependencies": {
+        "tslib": "^2.4.0"
+      }
+    },
+    "node_modules/@types/chai": {
+      "version": "5.2.3",
+      "resolved": "https://registry.npmjs.org/@types/chai/-/chai-5.2.3.tgz",
+      "integrity": "sha512-Mw558oeA9fFbv65/y4mHtXDs9bPnFMZAL/jxdPFUpOHHIXX91mcgEHbS5Lahr+pwZFR8A7GQleRWeI6cGFC2UA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@types/deep-eql": "*",
+        "assertion-error": "^2.0.1"
+      }
+    },
+    "node_modules/@types/deep-eql": {
+      "version": "4.0.2",
+      "resolved": "https://registry.npmjs.org/@types/deep-eql/-/deep-eql-4.0.2.tgz",
+      "integrity": "sha512-c9h9dVVMigMPc4bwTvC5dxqtqJZwQPePsWjPlpSOnojbor6pGqdk541lfA7AqFQr5pB1BRdq0juY9db81BwyFw==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/@types/estree": {
+      "version": "1.0.9",
+      "resolved": "https://registry.npmjs.org/@types/estree/-/estree-1.0.9.tgz",
+      "integrity": "sha512-GhdPgy1el4/ImP05X05Uw4cw2/M93BCUmnEvWZNStlCzEKME4Fkk+YpoA5OiHNQmoS7Cafb8Xa3Pya8m1Qrzeg==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/@types/lodash": {
+      "version": "4.17.25",
+      "resolved": "https://registry.npmjs.org/@types/lodash/-/lodash-4.17.25.tgz",
+      "integrity": "sha512-+K1NIO8I+F9/wNulfVvu23QYd0Pe9/OCqRrim4NoYIf1VoEDL90Ve4ClzpyqBLc7NpGGWRvYNCKZ1BE/Jpf8dQ==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/@types/lodash-es": {
+      "version": "4.17.12",
+      "resolved": "https://registry.npmjs.org/@types/lodash-es/-/lodash-es-4.17.12.tgz",
+      "integrity": "sha512-0NgftHUcV4v34VhXm8QBSftKVXtbkBG3ViCjs6+eJ5a6y6Mi/jiFGPc1sC7QK+9BFhWrURE3EOggmWaSxL9OzQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@types/lodash": "*"
+      }
+    },
+    "node_modules/@types/node": {
+      "version": "24.13.3",
+      "resolved": "https://registry.npmjs.org/@types/node/-/node-24.13.3.tgz",
+      "integrity": "sha512-Dh8vAsV36ig5wa9OX4pXvMc9D3Veibfw2wix0CUwYODLD8nkj9UsLjASr49nPg+2eKzxhBV+v7L8pXvT4e639Q==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "undici-types": "~7.18.0"
+      }
+    },
+    "node_modules/@types/pako": {
+      "version": "2.0.4",
+      "resolved": "https://registry.npmjs.org/@types/pako/-/pako-2.0.4.tgz",
+      "integrity": "sha512-VWDCbrLeVXJM9fihYodcLiIv0ku+AlOa/TQ1SvYOaBuyrSKgEcro95LJyIsJ4vSo6BXIxOKxiJAat04CmST9Fw==",
+      "license": "MIT"
+    },
+    "node_modules/@types/qrcode": {
+      "version": "1.5.6",
+      "resolved": "https://registry.npmjs.org/@types/qrcode/-/qrcode-1.5.6.tgz",
+      "integrity": "sha512-te7NQcV2BOvdj2b1hCAHzAoMNuj65kNBMz0KBaxM6c3VGBOhU0dURQKOtH8CFNI/dsKkwlv32p26qYQTWoB5bw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@types/node": "*"
+      }
+    },
+    "node_modules/@types/raf": {
+      "version": "3.4.3",
+      "resolved": "https://registry.npmjs.org/@types/raf/-/raf-3.4.3.tgz",
+      "integrity": "sha512-c4YAvMedbPZ5tEyxzQdMoOhhJ4RD3rngZIdwC2/qDN3d7JpEhB6fiBRKVY1lg5B7Wk+uPBjn5f39j1/2MY1oOw==",
+      "license": "MIT",
+      "optional": true
+    },
+    "node_modules/@types/trusted-types": {
+      "version": "2.0.7",
+      "resolved": "https://registry.npmjs.org/@types/trusted-types/-/trusted-types-2.0.7.tgz",
+      "integrity": "sha512-ScaPdn1dQczgbl0QFTeTOmVHFULt394XJgOQNoyVhZ6r2vLnMLJfBPd53SB52T/3G36VI1/g2MZaX0cwDuXsfw==",
+      "license": "MIT",
+      "optional": true
+    },
+    "node_modules/@types/web-bluetooth": {
+      "version": "0.0.21",
+      "resolved": "https://registry.npmjs.org/@types/web-bluetooth/-/web-bluetooth-0.0.21.tgz",
+      "integrity": "sha512-oIQLCGWtcFZy2JW77j9k8nHzAOpqMHLQejDA48XXMWH6tjCQHz5RCFz1bzsmROyL6PUm+LLnUiI4BCn221inxA==",
+      "license": "MIT"
+    },
+    "node_modules/@types/whatwg-mimetype": {
+      "version": "3.0.2",
+      "resolved": "https://registry.npmjs.org/@types/whatwg-mimetype/-/whatwg-mimetype-3.0.2.tgz",
+      "integrity": "sha512-c2AKvDT8ToxLIOUlN51gTiHXflsfIFisS4pO7pDPoKouJCESkhZnEy623gwP9laCy5lnLDAw1vAzu2vM2YLOrA==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/@types/ws": {
+      "version": "8.18.1",
+      "resolved": "https://registry.npmjs.org/@types/ws/-/ws-8.18.1.tgz",
+      "integrity": "sha512-ThVF6DCVhA8kUGy+aazFQ4kXQ7E1Ty7A3ypFOe0IcJV8O/M511G99AW24irKrW56Wt44yG9+ij8FaqoBGkuBXg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@types/node": "*"
+      }
+    },
+    "node_modules/@unocss/cli": {
+      "version": "66.7.5",
+      "resolved": "https://registry.npmjs.org/@unocss/cli/-/cli-66.7.5.tgz",
+      "integrity": "sha512-fgWkECRn2LGVo9sEpmjk/KJ3NSKUDitaZCNrJcEYM93DG+ELriTHcL+VWBlF4rcZf9fdGlq1nKbbRHUZirFCHQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@jridgewell/remapping": "^2.3.5",
+        "@unocss/config": "66.7.5",
+        "@unocss/core": "66.7.5",
+        "@unocss/preset-wind3": "66.7.5",
+        "@unocss/preset-wind4": "66.7.5",
+        "@unocss/transformer-directives": "66.7.5",
+        "cac": "^7.0.0",
+        "chokidar": "^5.0.0",
+        "colorette": "^2.0.20",
+        "consola": "^3.4.2",
+        "magic-string": "^0.30.21",
+        "pathe": "^2.0.3",
+        "perfect-debounce": "^2.1.0",
+        "tinyglobby": "^0.2.17",
+        "unplugin-utils": "^0.3.1"
+      },
+      "bin": {
+        "unocss": "bin/unocss.mjs"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/antfu"
+      }
+    },
+    "node_modules/@unocss/config": {
+      "version": "66.7.5",
+      "resolved": "https://registry.npmjs.org/@unocss/config/-/config-66.7.5.tgz",
+      "integrity": "sha512-dkPl9glhEahJ+Xoja5ZseKKnH+vZaeaKQzg8b0otcKcPPNrHQgu1nu3QgfeOjnXOGrjZIotHwUeVtt4ZA2Skgg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@unocss/core": "66.7.5",
+        "colorette": "^2.0.20",
+        "consola": "^3.4.2",
+        "unconfig": "^7.5.0"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/antfu"
+      }
+    },
+    "node_modules/@unocss/core": {
+      "version": "66.7.5",
+      "resolved": "https://registry.npmjs.org/@unocss/core/-/core-66.7.5.tgz",
+      "integrity": "sha512-UdJb8MiMywcau8QrWEVgUAz0kvoFHyR+sACwYCgmBh/BpKJGyR/zw/Ys3wvysbm0f+i/20VGBex/QQxYVlzdyQ==",
+      "dev": true,
+      "license": "MIT",
+      "funding": {
+        "url": "https://github.com/sponsors/antfu"
+      }
+    },
+    "node_modules/@unocss/extractor-arbitrary-variants": {
+      "version": "66.7.5",
+      "resolved": "https://registry.npmjs.org/@unocss/extractor-arbitrary-variants/-/extractor-arbitrary-variants-66.7.5.tgz",
+      "integrity": "sha512-5zOkbnLIJc8E749qNjLXfPHl3FdHloop12h706/ojr6idK4ix0KLm43R//uLnphixCehdHJRuHnavnM4C/kQbA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@unocss/core": "66.7.5"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/antfu"
+      }
+    },
+    "node_modules/@unocss/inspector": {
+      "version": "66.7.5",
+      "resolved": "https://registry.npmjs.org/@unocss/inspector/-/inspector-66.7.5.tgz",
+      "integrity": "sha512-WmTJMnj8bmRxvw/wGeShmL2eEHr2/L0BdGTXSxhfzwcO8y5XZEbBmVciLcM7pqaTXQ6JY4+KnITrDUf1urjZxQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@unocss/core": "66.7.5",
+        "@unocss/rule-utils": "66.7.5",
+        "colorette": "^2.0.20",
+        "gzip-size": "^6.0.0",
+        "sirv": "^3.0.2"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/antfu"
+      }
+    },
+    "node_modules/@unocss/preset-attributify": {
+      "version": "66.7.5",
+      "resolved": "https://registry.npmjs.org/@unocss/preset-attributify/-/preset-attributify-66.7.5.tgz",
+      "integrity": "sha512-1Oi1Cp81pqYJwG3h4+OlP5A0FKyaa07MFBXaXc4Yr3faiTbsI8SKj2TqnZCb+NQvBsEqslEd+jKXGZ3lKzCVOQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@unocss/core": "66.7.5"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/antfu"
+      }
+    },
+    "node_modules/@unocss/preset-icons": {
+      "version": "66.7.5",
+      "resolved": "https://registry.npmjs.org/@unocss/preset-icons/-/preset-icons-66.7.5.tgz",
+      "integrity": "sha512-ZsxadWnGGtHdANTikuMnjkQaT1qwUFJHZBF4fzVsPMnUiiKGs8rzXukwM9w3Gi9ontM7nbG2FYi9clWETSlpFg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@iconify/utils": "^3.1.3",
+        "@unocss/core": "66.7.5",
+        "ofetch": "^1.5.1"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/antfu"
+      }
+    },
+    "node_modules/@unocss/preset-mini": {
+      "version": "66.7.5",
+      "resolved": "https://registry.npmjs.org/@unocss/preset-mini/-/preset-mini-66.7.5.tgz",
+      "integrity": "sha512-o37TSl4ecT0dKu+3/TYuTYht75h82SEwDNl476m9ve0KW4Pv1O2tT/9TWd7N5cutEpySr8/YtjMwtWBD+drxBg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@unocss/core": "66.7.5",
+        "@unocss/extractor-arbitrary-variants": "66.7.5",
+        "@unocss/rule-utils": "66.7.5"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/antfu"
+      }
+    },
+    "node_modules/@unocss/preset-tagify": {
+      "version": "66.7.5",
+      "resolved": "https://registry.npmjs.org/@unocss/preset-tagify/-/preset-tagify-66.7.5.tgz",
+      "integrity": "sha512-/8YB1tXVi+WmNKPhsCdtO1xnQKEkshSnWDp6AbvVP3f6qOF7adlMYpAt3kpWCoVUBsfOQ06ZQlnfricMjObyoQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@unocss/core": "66.7.5"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/antfu"
+      }
+    },
+    "node_modules/@unocss/preset-typography": {
+      "version": "66.7.5",
+      "resolved": "https://registry.npmjs.org/@unocss/preset-typography/-/preset-typography-66.7.5.tgz",
+      "integrity": "sha512-2dxC8LT9KYa29UZT4muDFl7DbIXvKktTfeSMbUGMdZKbHcuMtKSP2U52wti1PL5I9duqp4v+8G33EeVutGTUaQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@unocss/core": "66.7.5",
+        "@unocss/rule-utils": "66.7.5"
+      }
+    },
+    "node_modules/@unocss/preset-uno": {
+      "version": "66.7.5",
+      "resolved": "https://registry.npmjs.org/@unocss/preset-uno/-/preset-uno-66.7.5.tgz",
+      "integrity": "sha512-zaUlYgNngbt50fZA/LbtsEnmPKojPqeiXCyUUiKQMv2uJQhncR32xhLZXVQ+TJD7hlfZ+6FAqlco1NIiAcub9w==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@unocss/core": "66.7.5",
+        "@unocss/preset-wind3": "66.7.5"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/antfu"
+      }
+    },
+    "node_modules/@unocss/preset-web-fonts": {
+      "version": "66.7.5",
+      "resolved": "https://registry.npmjs.org/@unocss/preset-web-fonts/-/preset-web-fonts-66.7.5.tgz",
+      "integrity": "sha512-OLLTK7kswdSu51qxEm6O+AehecgCfS08Ivqo+280lKzFW7V1jXr5okeJ1ty+85oHCprJqzcD9iG1khxNRLomcA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@unocss/core": "66.7.5",
+        "ofetch": "^1.5.1"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/antfu"
+      }
+    },
+    "node_modules/@unocss/preset-wind": {
+      "version": "66.7.5",
+      "resolved": "https://registry.npmjs.org/@unocss/preset-wind/-/preset-wind-66.7.5.tgz",
+      "integrity": "sha512-LVKgGr0A9Lc7F85xGXrrb71DDXMlHGA8bcj/Kht8BCsuRdBZadNbLlnv5qnSJiHYhi3/blzcgVoaeRor6L9yNA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@unocss/core": "66.7.5",
+        "@unocss/preset-wind3": "66.7.5"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/antfu"
+      }
+    },
+    "node_modules/@unocss/preset-wind3": {
+      "version": "66.7.5",
+      "resolved": "https://registry.npmjs.org/@unocss/preset-wind3/-/preset-wind3-66.7.5.tgz",
+      "integrity": "sha512-atFe/7Qein+oMdyZs0hEo+3EjV99Av2LVxDbzpCungxIfbS3TnQt70EIuHXMPNCVWLYwrMV+/P1n9Ntb0E3mow==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@unocss/core": "66.7.5",
+        "@unocss/preset-mini": "66.7.5",
+        "@unocss/rule-utils": "66.7.5"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/antfu"
+      }
+    },
+    "node_modules/@unocss/preset-wind4": {
+      "version": "66.7.5",
+      "resolved": "https://registry.npmjs.org/@unocss/preset-wind4/-/preset-wind4-66.7.5.tgz",
+      "integrity": "sha512-n3jIvQv8x1jXpmWfvNFBIqHNARki4mKZXfxAA31gekpXsRRTg16u1+yC1+PBBJgoEDFEnnmKnG7EZP88S8LVXA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@unocss/core": "66.7.5",
+        "@unocss/extractor-arbitrary-variants": "66.7.5",
+        "@unocss/rule-utils": "66.7.5"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/antfu"
+      }
+    },
+    "node_modules/@unocss/rule-utils": {
+      "version": "66.7.5",
+      "resolved": "https://registry.npmjs.org/@unocss/rule-utils/-/rule-utils-66.7.5.tgz",
+      "integrity": "sha512-/AKHBRF6ZOexE3EDDv8ZEYh40P5e2Eha41IYUbE1wjigW7++ssmvimSTdufJzZvU5DGP++E3B3WEsFPprZMjAg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@unocss/core": "66.7.5",
+        "magic-string": "^0.30.21"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/antfu"
+      }
+    },
+    "node_modules/@unocss/transformer-attributify-jsx": {
+      "version": "66.7.5",
+      "resolved": "https://registry.npmjs.org/@unocss/transformer-attributify-jsx/-/transformer-attributify-jsx-66.7.5.tgz",
+      "integrity": "sha512-r8qDwNSt0eGSwWws3xsuIHb3PZYR2embFdYoE67hD/xlYgLjX1uPy/HUlGCSSh4uLc4vVYjurr0Oq5xF/B8YiA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@unocss/core": "66.7.5",
+        "oxc-parser": "^0.131.0",
+        "oxc-walker": "^0.7.0"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/antfu"
+      }
+    },
+    "node_modules/@unocss/transformer-compile-class": {
+      "version": "66.7.5",
+      "resolved": "https://registry.npmjs.org/@unocss/transformer-compile-class/-/transformer-compile-class-66.7.5.tgz",
+      "integrity": "sha512-KuECgsGF7tGe808vIvKViEjI0UCUgYgneJfK+/TWBkjC7s8dLVaUtJzzcP9/r6OfGlgyn/x1YTdRqTaCENa7Xg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@unocss/core": "66.7.5"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/antfu"
+      }
+    },
+    "node_modules/@unocss/transformer-directives": {
+      "version": "66.7.5",
+      "resolved": "https://registry.npmjs.org/@unocss/transformer-directives/-/transformer-directives-66.7.5.tgz",
+      "integrity": "sha512-VMJApXXOwlDubkW+cNMmOkfxLefFupJr+yU23gGYUB2NPsuVltc8H5CDM0gfVebpeL5CUW05evxzEAk2wsju+Q==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@unocss/core": "66.7.5",
+        "@unocss/rule-utils": "66.7.5",
+        "css-tree": "^3.2.1"
+      }
+    },
+    "node_modules/@unocss/transformer-variant-group": {
+      "version": "66.7.5",
+      "resolved": "https://registry.npmjs.org/@unocss/transformer-variant-group/-/transformer-variant-group-66.7.5.tgz",
+      "integrity": "sha512-iDmP3mM8J+IxuQf5Uh33zsi528xnGxTpKRJ0c+LCrqBTTkR2tZr4aCzNmJ0g29Js2yEOsyNXRRc8BNTuvgn0AA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@unocss/core": "66.7.5"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/antfu"
+      }
+    },
+    "node_modules/@unocss/vite": {
+      "version": "66.7.5",
+      "resolved": "https://registry.npmjs.org/@unocss/vite/-/vite-66.7.5.tgz",
+      "integrity": "sha512-1z1TBCNJCR2WzjPtjzmCHr8rtzXHosMjLdsCNe6Mzsfwiw044gzzLVuiEZO9vIjkI50lvQ+gIOxOiVQG0hGAeA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@jridgewell/remapping": "^2.3.5",
+        "@unocss/config": "66.7.5",
+        "@unocss/core": "66.7.5",
+        "@unocss/inspector": "66.7.5",
+        "chokidar": "^5.0.0",
+        "magic-string": "^0.30.21",
+        "pathe": "^2.0.3",
+        "tinyglobby": "^0.2.17",
+        "unplugin-utils": "^0.3.1"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/antfu"
+      },
+      "peerDependencies": {
+        "vite": "^5.0.0-0 || ^6.0.0-0 || ^7.0.0-0 || ^8.0.0-0"
+      }
+    },
+    "node_modules/@vitejs/plugin-vue": {
+      "version": "6.0.8",
+      "resolved": "https://registry.npmjs.org/@vitejs/plugin-vue/-/plugin-vue-6.0.8.tgz",
+      "integrity": "sha512-0ZjgOg7oO6farnNGup7yvoM/YXZV84OZxHAwtflItNa/6zzQyVb5LNxyea3FEKEX2XlagIKzrlH7wwxkKgtiew==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@rolldown/pluginutils": "^1.0.1"
+      },
+      "engines": {
+        "node": "^20.19.0 || >=22.12.0"
+      },
+      "peerDependencies": {
+        "vite": "^5.0.0 || ^6.0.0 || ^7.0.0 || ^8.0.0",
+        "vue": "^3.2.25"
+      }
+    },
+    "node_modules/@vitest/coverage-v8": {
+      "version": "3.2.4",
+      "resolved": "https://registry.npmjs.org/@vitest/coverage-v8/-/coverage-v8-3.2.4.tgz",
+      "integrity": "sha512-EyF9SXU6kS5Ku/U82E259WSnvg6c8KTjppUncuNdm5QHpe17mwREHnjDzozC8x9MZ0xfBUFSaLkRv4TMA75ALQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@ampproject/remapping": "^2.3.0",
+        "@bcoe/v8-coverage": "^1.0.2",
+        "ast-v8-to-istanbul": "^0.3.3",
+        "debug": "^4.4.1",
+        "istanbul-lib-coverage": "^3.2.2",
+        "istanbul-lib-report": "^3.0.1",
+        "istanbul-lib-source-maps": "^5.0.6",
+        "istanbul-reports": "^3.1.7",
+        "magic-string": "^0.30.17",
+        "magicast": "^0.3.5",
+        "std-env": "^3.9.0",
+        "test-exclude": "^7.0.1",
+        "tinyrainbow": "^2.0.0"
+      },
+      "funding": {
+        "url": "https://opencollective.com/vitest"
+      },
+      "peerDependencies": {
+        "@vitest/browser": "3.2.4",
+        "vitest": "3.2.4"
+      },
+      "peerDependenciesMeta": {
+        "@vitest/browser": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/@vitest/expect": {
+      "version": "3.2.4",
+      "resolved": "https://registry.npmjs.org/@vitest/expect/-/expect-3.2.4.tgz",
+      "integrity": "sha512-Io0yyORnB6sikFlt8QW5K7slY4OjqNX9jmJQ02QDda8lyM6B5oNgVWoSoKPac8/kgnCUzuHQKrSLtu/uOqqrig==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@types/chai": "^5.2.2",
+        "@vitest/spy": "3.2.4",
+        "@vitest/utils": "3.2.4",
+        "chai": "^5.2.0",
+        "tinyrainbow": "^2.0.0"
+      },
+      "funding": {
+        "url": "https://opencollective.com/vitest"
+      }
+    },
+    "node_modules/@vitest/pretty-format": {
+      "version": "3.2.7",
+      "resolved": "https://registry.npmjs.org/@vitest/pretty-format/-/pretty-format-3.2.7.tgz",
+      "integrity": "sha512-KUHlwqVu0sRlhCdyPdQ/wBoTfRahjUky1MubOmYw9fWfIZy1gNoHpuaaQBPAaMaVYdQYHJLurzj8ECCj5OwTqA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "tinyrainbow": "^2.0.0"
+      },
+      "funding": {
+        "url": "https://opencollective.com/vitest"
+      }
+    },
+    "node_modules/@vitest/runner": {
+      "version": "3.2.4",
+      "resolved": "https://registry.npmjs.org/@vitest/runner/-/runner-3.2.4.tgz",
+      "integrity": "sha512-oukfKT9Mk41LreEW09vt45f8wx7DordoWUZMYdY/cyAk7w5TWkTRCNZYF7sX7n2wB7jyGAl74OxgwhPgKaqDMQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@vitest/utils": "3.2.4",
+        "pathe": "^2.0.3",
+        "strip-literal": "^3.0.0"
+      },
+      "funding": {
+        "url": "https://opencollective.com/vitest"
+      }
+    },
+    "node_modules/@vitest/snapshot": {
+      "version": "3.2.4",
+      "resolved": "https://registry.npmjs.org/@vitest/snapshot/-/snapshot-3.2.4.tgz",
+      "integrity": "sha512-dEYtS7qQP2CjU27QBC5oUOxLE/v5eLkGqPE0ZKEIDGMs4vKWe7IjgLOeauHsR0D5YuuycGRO5oSRXnwnmA78fQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@vitest/pretty-format": "3.2.4",
+        "magic-string": "^0.30.17",
+        "pathe": "^2.0.3"
+      },
+      "funding": {
+        "url": "https://opencollective.com/vitest"
+      }
+    },
+    "node_modules/@vitest/snapshot/node_modules/@vitest/pretty-format": {
+      "version": "3.2.4",
+      "resolved": "https://registry.npmjs.org/@vitest/pretty-format/-/pretty-format-3.2.4.tgz",
+      "integrity": "sha512-IVNZik8IVRJRTr9fxlitMKeJeXFFFN0JaB9PHPGQ8NKQbGpfjlTx9zO4RefN8gp7eqjNy8nyK3NZmBzOPeIxtA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "tinyrainbow": "^2.0.0"
+      },
+      "funding": {
+        "url": "https://opencollective.com/vitest"
+      }
+    },
+    "node_modules/@vitest/spy": {
+      "version": "3.2.4",
+      "resolved": "https://registry.npmjs.org/@vitest/spy/-/spy-3.2.4.tgz",
+      "integrity": "sha512-vAfasCOe6AIK70iP5UD11Ac4siNUNJ9i/9PZ3NKx07sG6sUxeag1LWdNrMWeKKYBLlzuK+Gn65Yd5nyL6ds+nw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "tinyspy": "^4.0.3"
+      },
+      "funding": {
+        "url": "https://opencollective.com/vitest"
+      }
+    },
+    "node_modules/@vitest/utils": {
+      "version": "3.2.4",
+      "resolved": "https://registry.npmjs.org/@vitest/utils/-/utils-3.2.4.tgz",
+      "integrity": "sha512-fB2V0JFrQSMsCo9HiSq3Ezpdv4iYaXRG1Sx8edX3MwxfyNn83mKiGzOcH+Fkxt4MHxr3y42fQi1oeAInqgX2QA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@vitest/pretty-format": "3.2.4",
+        "loupe": "^3.1.4",
+        "tinyrainbow": "^2.0.0"
+      },
+      "funding": {
+        "url": "https://opencollective.com/vitest"
+      }
+    },
+    "node_modules/@vitest/utils/node_modules/@vitest/pretty-format": {
+      "version": "3.2.4",
+      "resolved": "https://registry.npmjs.org/@vitest/pretty-format/-/pretty-format-3.2.4.tgz",
+      "integrity": "sha512-IVNZik8IVRJRTr9fxlitMKeJeXFFFN0JaB9PHPGQ8NKQbGpfjlTx9zO4RefN8gp7eqjNy8nyK3NZmBzOPeIxtA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "tinyrainbow": "^2.0.0"
+      },
+      "funding": {
+        "url": "https://opencollective.com/vitest"
+      }
+    },
+    "node_modules/@volar/language-core": {
+      "version": "2.4.28",
+      "resolved": "https://registry.npmjs.org/@volar/language-core/-/language-core-2.4.28.tgz",
+      "integrity": "sha512-w4qhIJ8ZSitgLAkVay6AbcnC7gP3glYM3fYwKV3srj8m494E3xtrCv6E+bWviiK/8hs6e6t1ij1s2Endql7vzQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@volar/source-map": "2.4.28"
+      }
+    },
+    "node_modules/@volar/source-map": {
+      "version": "2.4.28",
+      "resolved": "https://registry.npmjs.org/@volar/source-map/-/source-map-2.4.28.tgz",
+      "integrity": "sha512-yX2BDBqJkRXfKw8my8VarTyjv48QwxdJtvRgUpNE5erCsgEUdI2DsLbpa+rOQVAJYshY99szEcRDmyHbF10ggQ==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/@volar/typescript": {
+      "version": "2.4.28",
+      "resolved": "https://registry.npmjs.org/@volar/typescript/-/typescript-2.4.28.tgz",
+      "integrity": "sha512-Ja6yvWrbis2QtN4ClAKreeUZPVYMARDYZl9LMEv1iQ1QdepB6wn0jTRxA9MftYmYa4DQ4k/DaSZpFPUfxl8giw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@volar/language-core": "2.4.28",
+        "path-browserify": "^1.0.1",
+        "vscode-uri": "^3.0.8"
+      }
+    },
+    "node_modules/@vue/babel-helper-vue-transform-on": {
+      "version": "1.5.0",
+      "resolved": "https://registry.npmjs.org/@vue/babel-helper-vue-transform-on/-/babel-helper-vue-transform-on-1.5.0.tgz",
+      "integrity": "sha512-0dAYkerNhhHutHZ34JtTl2czVQHUNWv6xEbkdF5W+Yrv5pCWsqjeORdOgbtW2I9gWlt+wBmVn+ttqN9ZxR5tzA==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/@vue/babel-plugin-jsx": {
+      "version": "1.5.0",
+      "resolved": "https://registry.npmjs.org/@vue/babel-plugin-jsx/-/babel-plugin-jsx-1.5.0.tgz",
+      "integrity": "sha512-mneBhw1oOqCd2247O0Yw/mRwC9jIGACAJUlawkmMBiNmL4dGA2eMzuNZVNqOUfYTa6vqmND4CtOPzmEEEqLKFw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/helper-module-imports": "^7.27.1",
+        "@babel/helper-plugin-utils": "^7.27.1",
+        "@babel/plugin-syntax-jsx": "^7.27.1",
+        "@babel/template": "^7.27.2",
+        "@babel/traverse": "^7.28.0",
+        "@babel/types": "^7.28.2",
+        "@vue/babel-helper-vue-transform-on": "1.5.0",
+        "@vue/babel-plugin-resolve-type": "1.5.0",
+        "@vue/shared": "^3.5.18"
+      },
+      "peerDependencies": {
+        "@babel/core": "^7.0.0-0"
+      },
+      "peerDependenciesMeta": {
+        "@babel/core": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/@vue/babel-plugin-resolve-type": {
+      "version": "1.5.0",
+      "resolved": "https://registry.npmjs.org/@vue/babel-plugin-resolve-type/-/babel-plugin-resolve-type-1.5.0.tgz",
+      "integrity": "sha512-Wm/60o+53JwJODm4Knz47dxJnLDJ9FnKnGZJbUUf8nQRAtt6P+undLUAVU3Ha33LxOJe6IPoifRQ6F/0RrU31w==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/code-frame": "^7.27.1",
+        "@babel/helper-module-imports": "^7.27.1",
+        "@babel/helper-plugin-utils": "^7.27.1",
+        "@babel/parser": "^7.28.0",
+        "@vue/compiler-sfc": "^3.5.18"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sxzz"
+      },
+      "peerDependencies": {
+        "@babel/core": "^7.0.0-0"
+      }
+    },
+    "node_modules/@vue/compiler-core": {
+      "version": "3.5.41",
+      "resolved": "https://registry.npmjs.org/@vue/compiler-core/-/compiler-core-3.5.41.tgz",
+      "integrity": "sha512-q0Xtv/F9w2YO/7htQhtiL+Ev2WCJbe5N2hc+XfgyKkEKqWpSxknmT8QOuGdEKNdjPq0c3F7rNpFkTo3Kfrm7pg==",
+      "license": "MIT",
+      "dependencies": {
+        "@babel/parser": "^7.29.8",
+        "@vue/shared": "3.5.41",
+        "entities": "^7.0.1",
+        "estree-walker": "^2.0.2",
+        "source-map-js": "^1.2.1"
+      }
+    },
+    "node_modules/@vue/compiler-core/node_modules/estree-walker": {
+      "version": "2.0.2",
+      "resolved": "https://registry.npmjs.org/estree-walker/-/estree-walker-2.0.2.tgz",
+      "integrity": "sha512-Rfkk/Mp/DL7JVje3u18FxFujQlTNR2q6QfMSMB7AvCBx91NGj/ba3kCfza0f6dVDbw7YlRf/nDrn7pQrCCyQ/w==",
+      "license": "MIT"
+    },
+    "node_modules/@vue/compiler-dom": {
+      "version": "3.5.41",
+      "resolved": "https://registry.npmjs.org/@vue/compiler-dom/-/compiler-dom-3.5.41.tgz",
+      "integrity": "sha512-oKacVfNglLvGjnS6BXOlGL7EyG2h8X03pqXCjzotRZUaXGjbrTJUnVAQjrCqUnS+lyu31nwQjZY/d817GmCnfw==",
+      "license": "MIT",
+      "dependencies": {
+        "@vue/compiler-core": "3.5.41",
+        "@vue/shared": "3.5.41"
+      }
+    },
+    "node_modules/@vue/compiler-sfc": {
+      "version": "3.5.41",
+      "resolved": "https://registry.npmjs.org/@vue/compiler-sfc/-/compiler-sfc-3.5.41.tgz",
+      "integrity": "sha512-XJhip7R2wy6vX3knCxdZN4KracFaZUef58s1KYewqluedHIJaPIVfXoYT7MF1F8nCvv6k8bWWxDC8opMkg1VTQ==",
+      "license": "MIT",
+      "dependencies": {
+        "@babel/parser": "^7.29.8",
+        "@vue/compiler-core": "3.5.41",
+        "@vue/compiler-dom": "3.5.41",
+        "@vue/compiler-ssr": "3.5.41",
+        "@vue/shared": "3.5.41",
+        "estree-walker": "^2.0.2",
+        "magic-string": "^0.30.21",
+        "postcss": "^8.5.19",
+        "source-map-js": "^1.2.1"
+      }
+    },
+    "node_modules/@vue/compiler-sfc/node_modules/estree-walker": {
+      "version": "2.0.2",
+      "resolved": "https://registry.npmjs.org/estree-walker/-/estree-walker-2.0.2.tgz",
+      "integrity": "sha512-Rfkk/Mp/DL7JVje3u18FxFujQlTNR2q6QfMSMB7AvCBx91NGj/ba3kCfza0f6dVDbw7YlRf/nDrn7pQrCCyQ/w==",
+      "license": "MIT"
+    },
+    "node_modules/@vue/compiler-ssr": {
+      "version": "3.5.41",
+      "resolved": "https://registry.npmjs.org/@vue/compiler-ssr/-/compiler-ssr-3.5.41.tgz",
+      "integrity": "sha512-U3v5OejKEGqOI0Wy0+Sz7hGuIFZHA4LSXzrNM3IMIeDyJEBBfTpX26n3SDgToRpP2bLc9FfI2j/kSgcJ8Emq5A==",
+      "license": "MIT",
+      "dependencies": {
+        "@vue/compiler-dom": "3.5.41",
+        "@vue/shared": "3.5.41"
+      }
+    },
+    "node_modules/@vue/devtools-api": {
+      "version": "8.2.1",
+      "resolved": "https://registry.npmjs.org/@vue/devtools-api/-/devtools-api-8.2.1.tgz",
+      "integrity": "sha512-6u4vXBlIBAC1wMplIZgpyPn7uh/s4Bf6F5bMzvLv+EdJ0aHs/+4B7Ygv864EStQSjRbsRzTko/kUG1A1IejQ3A==",
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "@vue/devtools-kit": "^8.2.1"
+      }
+    },
+    "node_modules/@vue/devtools-core": {
+      "version": "8.2.1",
+      "resolved": "https://registry.npmjs.org/@vue/devtools-core/-/devtools-core-8.2.1.tgz",
+      "integrity": "sha512-s/VfAY9oDTb/kFEWmy461jaFde2MIV1RO/gi1vwM+PAZBZ/Pc2Ndu3BNBdZUze8QDUuyYvElbEEGA83syjJfzA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@vue/devtools-kit": "^8.2.1",
+        "@vue/devtools-shared": "^8.2.1"
+      },
+      "peerDependencies": {
+        "vue": "^3.0.0"
+      }
+    },
+    "node_modules/@vue/devtools-kit": {
+      "version": "8.2.1",
+      "resolved": "https://registry.npmjs.org/@vue/devtools-kit/-/devtools-kit-8.2.1.tgz",
+      "integrity": "sha512-FIGIuq3AWReEpbAHY/cRGeHDfI0qOb8OCQ3YjbEAX04uaxIDbGc9rhkbVcG7rnfHPXE3RsU5KrWOu9V/okd8AQ==",
+      "license": "MIT",
+      "dependencies": {
+        "@vue/devtools-shared": "^8.2.1",
+        "birpc": "^2.6.1",
+        "hookable": "^5.5.3",
+        "perfect-debounce": "^2.0.0"
+      }
+    },
+    "node_modules/@vue/devtools-shared": {
+      "version": "8.2.1",
+      "resolved": "https://registry.npmjs.org/@vue/devtools-shared/-/devtools-shared-8.2.1.tgz",
+      "integrity": "sha512-Fkac7lUdGReh6pVOi3AYPRGe82LQqRmAfThW7RRligOAP0ZA/Z1z9XLHDM9dv34pV2HRc79DK8uKPeG2fLnA/g==",
+      "license": "MIT"
+    },
+    "node_modules/@vue/language-core": {
+      "version": "3.3.9",
+      "resolved": "https://registry.npmjs.org/@vue/language-core/-/language-core-3.3.9.tgz",
+      "integrity": "sha512-in/68oAa4BCtVY6n/nkuhLIkV8DHYd2UivedJ6cMZ6UYtlq9jaoaSNUBHYCVO44z3nKg7MdE5OBoHKt5SxeBKQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@volar/language-core": "2.4.28",
+        "@vue/compiler-dom": "^3.5.0",
+        "@vue/shared": "^3.5.0",
+        "alien-signals": "^3.2.1",
+        "muggle-string": "^0.4.1",
+        "path-browserify": "^1.0.1",
+        "picomatch": "^4.0.4"
+      }
+    },
+    "node_modules/@vue/reactivity": {
+      "version": "3.5.41",
+      "resolved": "https://registry.npmjs.org/@vue/reactivity/-/reactivity-3.5.41.tgz",
+      "integrity": "sha512-rznsqKM0np0x18EjzF8x88MpEhdNsffbvFbckLL5+oUKz1BxAImEmO7J1ArRYSyo6aQaVoBDp7jEkT91OOxydA==",
+      "license": "MIT",
+      "dependencies": {
+        "@vue/shared": "3.5.41"
+      }
+    },
+    "node_modules/@vue/runtime-core": {
+      "version": "3.5.41",
+      "resolved": "https://registry.npmjs.org/@vue/runtime-core/-/runtime-core-3.5.41.tgz",
+      "integrity": "sha512-Vcry58hiAKwGen9Z1jUZE0feFsNArPCMOImYI8el48A9Idf6DuQYD0U05zZIF2Iad1hGhPSvcbBbAOhNr55fhg==",
+      "license": "MIT",
+      "dependencies": {
+        "@vue/reactivity": "3.5.41",
+        "@vue/shared": "3.5.41"
+      }
+    },
+    "node_modules/@vue/runtime-dom": {
+      "version": "3.5.41",
+      "resolved": "https://registry.npmjs.org/@vue/runtime-dom/-/runtime-dom-3.5.41.tgz",
+      "integrity": "sha512-3vVBahVBS9+U6cmXBLyb8nE6/yYo4J/CGI9eVFs3KiMc0YHuudwKyShTD65jtJy/L9PUUxNAFu4cj4LiJ0UFbw==",
+      "license": "MIT",
+      "dependencies": {
+        "@vue/reactivity": "3.5.41",
+        "@vue/runtime-core": "3.5.41",
+        "@vue/shared": "3.5.41",
+        "csstype": "^3.2.3"
+      }
+    },
+    "node_modules/@vue/server-renderer": {
+      "version": "3.5.41",
+      "resolved": "https://registry.npmjs.org/@vue/server-renderer/-/server-renderer-3.5.41.tgz",
+      "integrity": "sha512-n6hx/pNFfbD6SuyeuMVkvqox8bwf/ET9JlA/kAz/imw8sw++wkqKe2mHX5KutjPpbKE4Z56yTHszoOjGMI9igQ==",
+      "license": "MIT",
+      "dependencies": {
+        "@vue/compiler-ssr": "3.5.41",
+        "@vue/runtime-dom": "3.5.41",
+        "@vue/shared": "3.5.41"
+      }
+    },
+    "node_modules/@vue/shared": {
+      "version": "3.5.41",
+      "resolved": "https://registry.npmjs.org/@vue/shared/-/shared-3.5.41.tgz",
+      "integrity": "sha512-IOnwSCma8j+9xJT6b8H0dEYidC80NsYmNMlZxRsukYcSoGaDBohog5hDxzeUXdFeGWFA++vWvxqOmrr96VlqMA==",
+      "license": "MIT"
+    },
+    "node_modules/@vue/tsconfig": {
+      "version": "0.9.1",
+      "resolved": "https://registry.npmjs.org/@vue/tsconfig/-/tsconfig-0.9.1.tgz",
+      "integrity": "sha512-buvjm+9NzLCJL29KY1j1991YYJ5e6275OiK+G4jtmfIb+z4POywbdm0wXusT9adVWqe0xqg70TbI7+mRx4uU9w==",
+      "dev": true,
+      "license": "MIT",
+      "peerDependencies": {
+        "typescript": ">= 5.8",
+        "vue": "^3.4.0"
+      },
+      "peerDependenciesMeta": {
+        "typescript": {
+          "optional": true
+        },
+        "vue": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/@vueuse/core": {
+      "version": "14.4.0",
+      "resolved": "https://registry.npmjs.org/@vueuse/core/-/core-14.4.0.tgz",
+      "integrity": "sha512-X4WHz1HlCzCBoYXesUkifzzWBAcZgXG8Fi5iNPQg/epdzOB3gu8Fawj3hvuwYR1nGcXGnvxwYYcUC/71++svtQ==",
+      "license": "MIT",
+      "dependencies": {
+        "@types/web-bluetooth": "^0.0.21",
+        "@vueuse/metadata": "14.4.0",
+        "@vueuse/shared": "14.4.0"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/antfu"
+      },
+      "peerDependencies": {
+        "vue": "^3.5.0"
+      }
+    },
+    "node_modules/@vueuse/metadata": {
+      "version": "14.4.0",
+      "resolved": "https://registry.npmjs.org/@vueuse/metadata/-/metadata-14.4.0.tgz",
+      "integrity": "sha512-swx/255R6JyHZFJhx845iz5CRWDZdCfvkZOpACWc5+c5WHcG24mv8gUT1WIdFQaHt6dq79rvILd9QnCWiyVm9g==",
+      "license": "MIT",
+      "funding": {
+        "url": "https://github.com/sponsors/antfu"
+      }
+    },
+    "node_modules/@vueuse/shared": {
+      "version": "14.4.0",
+      "resolved": "https://registry.npmjs.org/@vueuse/shared/-/shared-14.4.0.tgz",
+      "integrity": "sha512-JRgY90Sz8DDtPMsaDflvPMp9xYk69JZAmbuDvAquUVXKr2gEjqtzGNTTthLfckH0BzBqvnu31gb4a8TGLRe79g==",
+      "license": "MIT",
+      "funding": {
+        "url": "https://github.com/sponsors/antfu"
+      },
+      "peerDependencies": {
+        "vue": "^3.5.0"
+      }
+    },
+    "node_modules/acorn": {
+      "version": "8.18.0",
+      "resolved": "https://registry.npmjs.org/acorn/-/acorn-8.18.0.tgz",
+      "integrity": "sha512-lGq+9yr1/GuAWaVYIHRjvvySG5/4VfKIvC8EWxStPdcDh/Ka7FG3twP6v4d5BkravUilhIAsG4Qj83t02LWUPQ==",
+      "dev": true,
+      "license": "MIT",
+      "bin": {
+        "acorn": "bin/acorn"
+      },
+      "engines": {
+        "node": ">=0.4.0"
+      }
+    },
+    "node_modules/adler-32": {
+      "version": "1.3.1",
+      "resolved": "https://registry.npmjs.org/adler-32/-/adler-32-1.3.1.tgz",
+      "integrity": "sha512-ynZ4w/nUUv5rrsR8UUGoe1VC9hZj6V5hU9Qw1HlMDJGEJw5S7TfTErWTjMys6M7vr0YWcPqs3qAr4ss0nDfP+A==",
+      "license": "Apache-2.0",
+      "engines": {
+        "node": ">=0.8"
+      }
+    },
+    "node_modules/agent-base": {
+      "version": "7.1.4",
+      "resolved": "https://registry.npmjs.org/agent-base/-/agent-base-7.1.4.tgz",
+      "integrity": "sha512-MnA+YT8fwfJPgBx3m60MNqakm30XOkyIoH1y6huTQvC0PwZG7ki8NacLBcrPbNoo8vEZy7Jpuk7+jMO+CUovTQ==",
+      "license": "MIT",
+      "optional": true,
+      "engines": {
+        "node": ">= 14"
+      }
+    },
+    "node_modules/ajv": {
+      "version": "8.20.0",
+      "resolved": "https://registry.npmjs.org/ajv/-/ajv-8.20.0.tgz",
+      "integrity": "sha512-Thbli+OlOj+iMPYFBVBfJ3OmCAnaSyNn4M1vz9T6Gka5Jt9ba/HIR56joy65tY6kx/FCF5VXNB819Y7/GUrBGA==",
+      "license": "MIT",
+      "dependencies": {
+        "fast-deep-equal": "^3.1.3",
+        "fast-uri": "^3.0.1",
+        "json-schema-traverse": "^1.0.0",
+        "require-from-string": "^2.0.2"
+      },
+      "funding": {
+        "type": "github",
+        "url": "https://github.com/sponsors/epoberezkin"
+      }
+    },
+    "node_modules/alien-signals": {
+      "version": "3.2.1",
+      "resolved": "https://registry.npmjs.org/alien-signals/-/alien-signals-3.2.1.tgz",
+      "integrity": "sha512-I8FjmltrfnDFoZedi5CG8DghVYNhzb/Ijluz7tCSJH0xpd0484Kowhbb1XDYOxfJpU1p5wnM2X54dA+IfGyD1g==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/ansi-regex": {
+      "version": "6.2.2",
+      "resolved": "https://registry.npmjs.org/ansi-regex/-/ansi-regex-6.2.2.tgz",
+      "integrity": "sha512-Bq3SmSpyFHaWjPk8If9yc6svM8c56dB5BAtW4Qbw5jHTwwXXcTLoRMkpDJp6VL0XzlWaCHTXrkFURMYmD0sLqg==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=12"
+      },
+      "funding": {
+        "url": "https://github.com/chalk/ansi-regex?sponsor=1"
+      }
+    },
+    "node_modules/ansi-styles": {
+      "version": "7.0.0",
+      "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-7.0.0.tgz",
+      "integrity": "sha512-kKvt3m4uwzqL0wlkPd09CmljPJGOZZ4D0fP65sqFSvPkMRKhNi+74MgIJ5QxE6SxqB4t4KyUFGg8+n5zjo6hew==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=22"
+      },
+      "funding": {
+        "url": "https://github.com/chalk/ansi-styles?sponsor=1"
+      }
+    },
+    "node_modules/ansis": {
+      "version": "4.3.1",
+      "resolved": "https://registry.npmjs.org/ansis/-/ansis-4.3.1.tgz",
+      "integrity": "sha512-BJ8/l4R5LRE7hW9WdSuGYrLSHi2ynxeFpDFbH0K/CgNeY/tyhk+vO6TYxXC5r5CpUhNVX310xzPsN/H9lCdfOA==",
+      "dev": true,
+      "license": "ISC",
+      "engines": {
+        "node": ">=14"
+      }
+    },
+    "node_modules/assertion-error": {
+      "version": "2.0.1",
+      "resolved": "https://registry.npmjs.org/assertion-error/-/assertion-error-2.0.1.tgz",
+      "integrity": "sha512-Izi8RQcffqCeNVgFigKli1ssklIbpHnCYc6AknXGYoB6grJqyeby7jv12JUQgmTAnIDnbck1uxksT4dzN3PWBA==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "node_modules/ast-v8-to-istanbul": {
+      "version": "0.3.12",
+      "resolved": "https://registry.npmjs.org/ast-v8-to-istanbul/-/ast-v8-to-istanbul-0.3.12.tgz",
+      "integrity": "sha512-BRRC8VRZY2R4Z4lFIL35MwNXmwVqBityvOIwETtsCSwvjl0IdgFsy9NhdaA6j74nUdtJJlIypeRhpDam19Wq3g==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@jridgewell/trace-mapping": "^0.3.31",
+        "estree-walker": "^3.0.3",
+        "js-tokens": "^10.0.0"
+      }
+    },
+    "node_modules/async-validator": {
+      "version": "4.2.5",
+      "resolved": "https://registry.npmjs.org/async-validator/-/async-validator-4.2.5.tgz",
+      "integrity": "sha512-7HhHjtERjqlNbZtqNqy2rckN/SpOOlmDliet+lP7k+eKZEjPk3DgyeU9lIXLdeLz0uBbbVp+9Qdow9wJWgwwfg==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/balanced-match": {
+      "version": "4.0.4",
+      "resolved": "https://registry.npmjs.org/balanced-match/-/balanced-match-4.0.4.tgz",
+      "integrity": "sha512-BLrgEcRTwX2o6gGxGOCNyMvGSp35YofuYzw9h1IMTRmKqttAZZVU67bdb9Pr2vUHA8+j3i2tJfjO6C6+4myGTA==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": "18 || 20 || >=22"
+      }
+    },
+    "node_modules/base64-arraybuffer": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/base64-arraybuffer/-/base64-arraybuffer-1.0.2.tgz",
+      "integrity": "sha512-I3yl4r9QB5ZRY3XuJVEPfc2XhZO6YweFPI+UovAzn+8/hb3oJ6lnysaFcjVpkCPfVWFUDvoZ8kmVDP7WyRtYtQ==",
+      "license": "MIT",
+      "optional": true,
+      "engines": {
+        "node": ">= 0.6.0"
+      }
+    },
+    "node_modules/base64-js": {
+      "version": "1.5.1",
+      "resolved": "https://registry.npmjs.org/base64-js/-/base64-js-1.5.1.tgz",
+      "integrity": "sha512-AKpaYlHn8t4SVbOHCy+b5+KKgvR4vrsD8vbvrbiQJps7fKDTkjkDry6ji0rUJjC0kzbNePLwzxq8iypo41qeWA==",
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/feross"
+        },
+        {
+          "type": "patreon",
+          "url": "https://www.patreon.com/feross"
+        },
+        {
+          "type": "consulting",
+          "url": "https://feross.org/support"
+        }
+      ],
+      "license": "MIT",
+      "optional": true
+    },
+    "node_modules/baseline-browser-mapping": {
+      "version": "2.11.12",
+      "resolved": "https://registry.npmjs.org/baseline-browser-mapping/-/baseline-browser-mapping-2.11.12.tgz",
+      "integrity": "sha512-r7WnVImvVCeFpf2DOXfy41aPWzeNg3H/A2X4dKmy1QL0MSyyk/e7z8ihJ3N6Nn2PsdhkVlqnEfnUE4a05P2aTA==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "bin": {
+        "baseline-browser-mapping": "dist/cli.cjs"
+      },
+      "engines": {
+        "node": ">=6.0.0"
+      }
+    },
+    "node_modules/birpc": {
+      "version": "2.9.0",
+      "resolved": "https://registry.npmjs.org/birpc/-/birpc-2.9.0.tgz",
+      "integrity": "sha512-KrayHS5pBi69Xi9JmvoqrIgYGDkD6mcSe/i6YKi3w5kekCLzrX4+nawcXqrj2tIp50Kw/mT/s3p+GVK0A0sKxw==",
+      "license": "MIT",
+      "funding": {
+        "url": "https://github.com/sponsors/antfu"
+      }
+    },
+    "node_modules/bl": {
+      "version": "4.1.0",
+      "resolved": "https://registry.npmjs.org/bl/-/bl-4.1.0.tgz",
+      "integrity": "sha512-1W07cM9gS6DcLperZfFSj+bWLtaPGSOHWhPiGzXmvVJbRLdG82sH/Kn8EtW1VqWVA54AKf2h5k5BbnIbwF3h6w==",
+      "license": "MIT",
+      "optional": true,
+      "dependencies": {
+        "buffer": "^5.5.0",
+        "inherits": "^2.0.4",
+        "readable-stream": "^3.4.0"
+      }
+    },
+    "node_modules/brace-expansion": {
+      "version": "5.0.9",
+      "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-5.0.9.tgz",
+      "integrity": "sha512-ScQ4IuvIEF1TMlP7Zt+vjJ//9zlPb2SDcxWxM3bk8s6t6GGdJ7KO1dCcTidOPJKePW30LE/2cT7wCyPho9/Wxg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "balanced-match": "^4.0.2"
+      },
+      "engines": {
+        "node": "20 || >=22"
+      }
+    },
+    "node_modules/browserslist": {
+      "version": "4.28.7",
+      "resolved": "https://registry.npmjs.org/browserslist/-/browserslist-4.28.7.tgz",
+      "integrity": "sha512-JxV13hNrFxqjOc8alRbq9dK1MM79NEXYpma2B2J4wAtpWS5zIEIKqWPGCl7N4o7Uc7B7itylh7SuDujATRyyTw==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "opencollective",
+          "url": "https://opencollective.com/browserslist"
+        },
+        {
+          "type": "tidelift",
+          "url": "https://tidelift.com/funding/github/npm/browserslist"
+        },
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/ai"
+        }
+      ],
+      "license": "MIT",
+      "dependencies": {
+        "baseline-browser-mapping": "^2.10.44",
+        "caniuse-lite": "^1.0.30001806",
+        "electron-to-chromium": "^1.5.393",
+        "node-releases": "^2.0.51",
+        "update-browserslist-db": "^1.2.3"
+      },
+      "bin": {
+        "browserslist": "cli.js"
+      },
+      "engines": {
+        "node": "^6 || ^7 || ^8 || ^9 || ^10 || ^11 || ^12 || >=13.7"
+      }
+    },
+    "node_modules/buffer": {
+      "version": "5.7.1",
+      "resolved": "https://registry.npmjs.org/buffer/-/buffer-5.7.1.tgz",
+      "integrity": "sha512-EHcyIPBQ4BSGlvjB16k5KgAJ27CIsHY/2JBmCRReo48y9rQ3MaUzWX3KVlBa4U7MyX02HdVj0K7C3WaB3ju7FQ==",
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/feross"
+        },
+        {
+          "type": "patreon",
+          "url": "https://www.patreon.com/feross"
+        },
+        {
+          "type": "consulting",
+          "url": "https://feross.org/support"
+        }
+      ],
+      "license": "MIT",
+      "optional": true,
+      "dependencies": {
+        "base64-js": "^1.3.1",
+        "ieee754": "^1.1.13"
+      }
+    },
+    "node_modules/buffer-image-size": {
+      "version": "0.6.4",
+      "resolved": "https://registry.npmjs.org/buffer-image-size/-/buffer-image-size-0.6.4.tgz",
+      "integrity": "sha512-nEh+kZOPY1w+gcCMobZ6ETUp9WfibndnosbpwB1iJk/8Gt5ZF2bhS6+B6bPYz424KtwsR6Rflc3tCz1/ghX2dQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@types/node": "*"
+      },
+      "engines": {
+        "node": ">=4.0"
+      }
+    },
+    "node_modules/bundle-name": {
+      "version": "4.1.0",
+      "resolved": "https://registry.npmjs.org/bundle-name/-/bundle-name-4.1.0.tgz",
+      "integrity": "sha512-tjwM5exMg6BGRI+kNmTntNsvdZS1X8BFYS6tnJ2hdH0kVxM6/eVZ2xy+FqStSWvYmtfFMDLIxurorHwDKfDz5Q==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "run-applescript": "^7.0.0"
+      },
+      "engines": {
+        "node": ">=18"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/cac": {
+      "version": "7.0.0",
+      "resolved": "https://registry.npmjs.org/cac/-/cac-7.0.0.tgz",
+      "integrity": "sha512-tixWYgm5ZoOD+3g6UTea91eow5z6AAHaho3g0V9CNSNb45gM8SmflpAc+GRd1InC4AqN/07Unrgp56Y94N9hJQ==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=20.19.0"
+      }
+    },
+    "node_modules/camelcase": {
+      "version": "5.3.1",
+      "resolved": "https://registry.npmjs.org/camelcase/-/camelcase-5.3.1.tgz",
+      "integrity": "sha512-L28STB170nwWS63UjtlEOE3dldQApaJXZkOI1uMFfzf3rRuPegHaHesyee+YxQ+W6SvRDQV6UrdOdRiR153wJg==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=6"
+      }
+    },
+    "node_modules/caniuse-lite": {
+      "version": "1.0.30001809",
+      "resolved": "https://registry.npmjs.org/caniuse-lite/-/caniuse-lite-1.0.30001809.tgz",
+      "integrity": "sha512-xxWVywk6a6Arlk+hymeycyn/VgqEfLDxupvhH/xiY5SJ/18kmi9o6MiO320DCUzypORHLtvh0I4i04tUhCNHNQ==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "opencollective",
+          "url": "https://opencollective.com/browserslist"
+        },
+        {
+          "type": "tidelift",
+          "url": "https://tidelift.com/funding/github/npm/caniuse-lite"
+        },
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/ai"
+        }
+      ],
+      "license": "CC-BY-4.0"
+    },
+    "node_modules/canvas": {
+      "version": "3.2.3",
+      "resolved": "https://registry.npmjs.org/canvas/-/canvas-3.2.3.tgz",
+      "integrity": "sha512-PzE5nJZPz72YUAfo8oTp0u3fqqY7IzlTubneAihqDYAUcBk7ryeCmBbdJBEdaH0bptSOe2VT2Zwcb3UaFyaSWw==",
+      "hasInstallScript": true,
+      "license": "MIT",
+      "optional": true,
+      "dependencies": {
+        "node-addon-api": "^7.0.0",
+        "prebuild-install": "^7.1.3"
+      },
+      "engines": {
+        "node": "^18.12.0 || >= 20.9.0"
+      }
+    },
+    "node_modules/canvg": {
+      "version": "3.0.11",
+      "resolved": "https://registry.npmjs.org/canvg/-/canvg-3.0.11.tgz",
+      "integrity": "sha512-5ON+q7jCTgMp9cjpu4Jo6XbvfYwSB2Ow3kzHKfIyJfaCAOHLbdKPQqGKgfED/R5B+3TFFfe8pegYA+b423SRyA==",
+      "license": "MIT",
+      "optional": true,
+      "dependencies": {
+        "@babel/runtime": "^7.12.5",
+        "@types/raf": "^3.4.0",
+        "core-js": "^3.8.3",
+        "raf": "^3.4.1",
+        "regenerator-runtime": "^0.13.7",
+        "rgbcolor": "^1.0.1",
+        "stackblur-canvas": "^2.0.0",
+        "svg-pathdata": "^6.0.3"
+      },
+      "engines": {
+        "node": ">=10.0.0"
+      }
+    },
+    "node_modules/cfb": {
+      "version": "1.2.2",
+      "resolved": "https://registry.npmjs.org/cfb/-/cfb-1.2.2.tgz",
+      "integrity": "sha512-KfdUZsSOw19/ObEWasvBP/Ac4reZvAGauZhs6S/gqNhXhI7cKwvlH7ulj+dOEYnca4bm4SGo8C1bTAQvnTjgQA==",
+      "license": "Apache-2.0",
+      "dependencies": {
+        "adler-32": "~1.3.0",
+        "crc-32": "~1.2.0"
+      },
+      "engines": {
+        "node": ">=0.8"
+      }
+    },
+    "node_modules/chai": {
+      "version": "5.3.3",
+      "resolved": "https://registry.npmjs.org/chai/-/chai-5.3.3.tgz",
+      "integrity": "sha512-4zNhdJD/iOjSH0A05ea+Ke6MU5mmpQcbQsSOkgdaUMJ9zTlDTD/GYlwohmIE2u0gaxHYiVHEn1Fw9mZ/ktJWgw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "assertion-error": "^2.0.1",
+        "check-error": "^2.1.1",
+        "deep-eql": "^5.0.1",
+        "loupe": "^3.1.0",
+        "pathval": "^2.0.0"
+      },
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/check-error": {
+      "version": "2.1.3",
+      "resolved": "https://registry.npmjs.org/check-error/-/check-error-2.1.3.tgz",
+      "integrity": "sha512-PAJdDJusoxnwm1VwW07VWwUN1sl7smmC3OKggvndJFadxxDRyFJBX/ggnu/KE4kQAB7a3Dp8f/YXC1FlUprWmA==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">= 16"
+      }
+    },
+    "node_modules/chokidar": {
+      "version": "5.0.0",
+      "resolved": "https://registry.npmjs.org/chokidar/-/chokidar-5.0.0.tgz",
+      "integrity": "sha512-TQMmc3w+5AxjpL8iIiwebF73dRDF4fBIieAqGn9RGCWaEVwQ6Fb2cGe31Yns0RRIzii5goJ1Y7xbMwo1TxMplw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "readdirp": "^5.0.0"
+      },
+      "engines": {
+        "node": ">= 20.19.0"
+      },
+      "funding": {
+        "url": "https://paulmillr.com/funding/"
+      }
+    },
+    "node_modules/chownr": {
+      "version": "1.1.4",
+      "resolved": "https://registry.npmjs.org/chownr/-/chownr-1.1.4.tgz",
+      "integrity": "sha512-jJ0bqzaylmJtVnNgzTeSOs8DPavpbYgEr/b0YL8/2GO3xJEhInFmhKMUnEJQjZumK7KXGFhUy89PrsJWlakBVg==",
+      "license": "ISC",
+      "optional": true
+    },
+    "node_modules/cliui": {
+      "version": "6.0.0",
+      "resolved": "https://registry.npmjs.org/cliui/-/cliui-6.0.0.tgz",
+      "integrity": "sha512-t6wbgtoCXvAzst7QgXxJYqPt0usEfbgQdftEPbLL/cvv6HPE5VgvqCuAIDR0NgU52ds6rFwqrgakNLrHEjCbrQ==",
+      "license": "ISC",
+      "dependencies": {
+        "string-width": "^4.2.0",
+        "strip-ansi": "^6.0.0",
+        "wrap-ansi": "^6.2.0"
+      }
+    },
+    "node_modules/cliui/node_modules/ansi-regex": {
+      "version": "5.0.1",
+      "resolved": "https://registry.npmjs.org/ansi-regex/-/ansi-regex-5.0.1.tgz",
+      "integrity": "sha512-quJQXlTSUGL2LH9SUXo8VwsY4soanhgo6LNSm84E1LBcE8s3O0wpdiRzyR9z/ZZJMlMWv37qOOb9pdJlMUEKFQ==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/cliui/node_modules/ansi-styles": {
+      "version": "4.3.0",
+      "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-4.3.0.tgz",
+      "integrity": "sha512-zbB9rCJAT1rbjiVDb2hqKFHNYLxgtk8NURxZ3IZwD3F6NtxbXZQCnnSi1Lkx+IDohdPlFp222wVALIheZJQSEg==",
+      "license": "MIT",
+      "dependencies": {
+        "color-convert": "^2.0.1"
+      },
+      "engines": {
+        "node": ">=8"
+      },
+      "funding": {
+        "url": "https://github.com/chalk/ansi-styles?sponsor=1"
+      }
+    },
+    "node_modules/cliui/node_modules/emoji-regex": {
+      "version": "8.0.0",
+      "resolved": "https://registry.npmjs.org/emoji-regex/-/emoji-regex-8.0.0.tgz",
+      "integrity": "sha512-MSjYzcWNOA0ewAHpz0MxpYFvwg6yjy1NG3xteoqz644VCo/RPgnr1/GGt+ic3iJTzQ8Eu3TdM14SawnVUmGE6A==",
+      "license": "MIT"
+    },
+    "node_modules/cliui/node_modules/string-width": {
+      "version": "4.2.3",
+      "resolved": "https://registry.npmjs.org/string-width/-/string-width-4.2.3.tgz",
+      "integrity": "sha512-wKyQRQpjJ0sIp62ErSZdGsjMJWsap5oRNihHhu6G7JVO/9jIB6UyevL+tXuOqrng8j/cxKTWyWUwvSTriiZz/g==",
+      "license": "MIT",
+      "dependencies": {
+        "emoji-regex": "^8.0.0",
+        "is-fullwidth-code-point": "^3.0.0",
+        "strip-ansi": "^6.0.1"
+      },
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/cliui/node_modules/strip-ansi": {
+      "version": "6.0.1",
+      "resolved": "https://registry.npmjs.org/strip-ansi/-/strip-ansi-6.0.1.tgz",
+      "integrity": "sha512-Y38VPSHcqkFrCpFnQ9vuSXmquuv5oXOKpGeT6aGrr3o3Gc9AlVa6JBfUSOCnbxGGZF+/0ooI7KrPuUSztUdU5A==",
+      "license": "MIT",
+      "dependencies": {
+        "ansi-regex": "^5.0.1"
+      },
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/cliui/node_modules/wrap-ansi": {
+      "version": "6.2.0",
+      "resolved": "https://registry.npmjs.org/wrap-ansi/-/wrap-ansi-6.2.0.tgz",
+      "integrity": "sha512-r6lPcBGxZXlIcymEu7InxDMhdW0KDxpLgoFLcguasxCaJ/SOIZwINatK9KY/tf+ZrlywOKU0UDj3ATXUBfxJXA==",
+      "license": "MIT",
+      "dependencies": {
+        "ansi-styles": "^4.0.0",
+        "string-width": "^4.1.0",
+        "strip-ansi": "^6.0.0"
+      },
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/codemirror": {
+      "version": "6.0.2",
+      "resolved": "https://registry.npmjs.org/codemirror/-/codemirror-6.0.2.tgz",
+      "integrity": "sha512-VhydHotNW5w1UGK0Qj96BwSk/Zqbp9WbnyK2W/eVMv4QyF41INRGpjUhFJY7/uDNuudSc33a/PKr4iDqRduvHw==",
+      "license": "MIT",
+      "dependencies": {
+        "@codemirror/autocomplete": "^6.0.0",
+        "@codemirror/commands": "^6.0.0",
+        "@codemirror/language": "^6.0.0",
+        "@codemirror/lint": "^6.0.0",
+        "@codemirror/search": "^6.0.0",
+        "@codemirror/state": "^6.0.0",
+        "@codemirror/view": "^6.0.0"
+      }
+    },
+    "node_modules/codepage": {
+      "version": "1.15.0",
+      "resolved": "https://registry.npmjs.org/codepage/-/codepage-1.15.0.tgz",
+      "integrity": "sha512-3g6NUTPd/YtuuGrhMnOMRjFc+LJw/bnMp3+0r/Wcz3IXUuCosKRJvMphm5+Q+bvTVGcJJuRvVLuYba+WojaFaA==",
+      "license": "Apache-2.0",
+      "engines": {
+        "node": ">=0.8"
+      }
+    },
+    "node_modules/color-convert": {
+      "version": "2.0.1",
+      "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-2.0.1.tgz",
+      "integrity": "sha512-RRECPsj7iu/xb5oKYcsFHSppFNnsj/52OVTRKb4zP5onXwVF3zVmmToNcOfGC+CRDpfK/U584fMg38ZHCaElKQ==",
+      "license": "MIT",
+      "dependencies": {
+        "color-name": "~1.1.4"
+      },
+      "engines": {
+        "node": ">=7.0.0"
+      }
+    },
+    "node_modules/color-name": {
+      "version": "1.1.4",
+      "resolved": "https://registry.npmjs.org/color-name/-/color-name-1.1.4.tgz",
+      "integrity": "sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA==",
+      "license": "MIT"
+    },
+    "node_modules/colorette": {
+      "version": "2.0.20",
+      "resolved": "https://registry.npmjs.org/colorette/-/colorette-2.0.20.tgz",
+      "integrity": "sha512-IfEDxwoWIjkeXL1eXcDiow4UbKjhLdq6/EuSVR9GMN7KVH3r9gQ83e73hsz1Nd1T3ijd5xv1wcWRYO+D6kCI2w==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/confbox": {
+      "version": "0.1.8",
+      "resolved": "https://registry.npmjs.org/confbox/-/confbox-0.1.8.tgz",
+      "integrity": "sha512-RMtmw0iFkeR4YV+fUOSucriAQNb9g8zFR52MWCtl+cCZOFRNL6zeB395vPzFhEjjn4fMxXudmELnl/KF/WrK6w==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/consola": {
+      "version": "3.4.2",
+      "resolved": "https://registry.npmjs.org/consola/-/consola-3.4.2.tgz",
+      "integrity": "sha512-5IKcdX0nnYavi6G7TtOhwkYzyjfJlatbjMjuLSfE2kYT5pMDOilZ4OvMhi637CcDICTmz3wARPoyhqyX1Y+XvA==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": "^14.18.0 || >=16.10.0"
+      }
+    },
+    "node_modules/convert-source-map": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/convert-source-map/-/convert-source-map-2.0.0.tgz",
+      "integrity": "sha512-Kvp459HrV2FEJ1CAsi1Ku+MY3kasH19TFykTz2xWmMeq6bk2NU3XXvfJ+Q61m0xktWwt+1HSYf3JZsTms3aRJg==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/core-js": {
+      "version": "3.50.0",
+      "resolved": "https://registry.npmjs.org/core-js/-/core-js-3.50.0.tgz",
+      "integrity": "sha512-BRWgOLKkFeCgRudR6zrs8p9XJZcE14grzKMMssoYrk6krtuEZ7MTKPIY5RzOnqsEKIR9kst7wNzphttraT+Yqw==",
+      "hasInstallScript": true,
+      "license": "MIT",
+      "optional": true,
+      "engines": {
+        "node": "*"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/core-js"
+      }
+    },
+    "node_modules/crc-32": {
+      "version": "1.2.2",
+      "resolved": "https://registry.npmjs.org/crc-32/-/crc-32-1.2.2.tgz",
+      "integrity": "sha512-ROmzCKrTnOwybPcJApAA6WBWij23HVfGVNKqqrZpuyZOHqK2CwHSvpGuyt/UNNvaIjEd8X5IFGp4Mh+Ie1IHJQ==",
+      "license": "Apache-2.0",
+      "bin": {
+        "crc32": "bin/crc32.njs"
+      },
+      "engines": {
+        "node": ">=0.8"
+      }
+    },
+    "node_modules/crelt": {
+      "version": "1.0.7",
+      "resolved": "https://registry.npmjs.org/crelt/-/crelt-1.0.7.tgz",
+      "integrity": "sha512-aK6BbWfhf4U/wCcLHKPJl/xa6VkVstRaPywWtMKGwuOLc/wZTyQYuoxgvZnNsBvv7Kg3YTBQYYBCggcviQczuA==",
+      "license": "MIT"
+    },
+    "node_modules/cross-spawn": {
+      "version": "7.0.6",
+      "resolved": "https://registry.npmjs.org/cross-spawn/-/cross-spawn-7.0.6.tgz",
+      "integrity": "sha512-uV2QOWP2nWzsy2aMp8aRibhi9dlzF5Hgh5SHaB9OiTGEyDTiJJyx0uy51QXdyWbtAHNua4XJzUKca3OzKUd3vA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "path-key": "^3.1.0",
+        "shebang-command": "^2.0.0",
+        "which": "^2.0.1"
+      },
+      "engines": {
+        "node": ">= 8"
+      }
+    },
+    "node_modules/cross-spawn/node_modules/isexe": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/isexe/-/isexe-2.0.0.tgz",
+      "integrity": "sha512-RHxMLp9lnKHGHRng9QFhRCMbYAcVpn69smSGcq3f36xjgVVWThj4qqLbTLlq7Ssj8B+fIQ1EuCEGI2lKsyQeIw==",
+      "dev": true,
+      "license": "ISC"
+    },
+    "node_modules/cross-spawn/node_modules/which": {
+      "version": "2.0.2",
+      "resolved": "https://registry.npmjs.org/which/-/which-2.0.2.tgz",
+      "integrity": "sha512-BLI3Tl1TW3Pvl70l3yq3Y64i+awpwXqsGBYWkkqMtnbXgrMD+yj7rhW0kuEDxzJaYXGjEW5ogapKNMEKNMjibA==",
+      "dev": true,
+      "license": "ISC",
+      "dependencies": {
+        "isexe": "^2.0.0"
+      },
+      "bin": {
+        "node-which": "bin/node-which"
+      },
+      "engines": {
+        "node": ">= 8"
+      }
+    },
+    "node_modules/css-line-break": {
+      "version": "2.1.0",
+      "resolved": "https://registry.npmjs.org/css-line-break/-/css-line-break-2.1.0.tgz",
+      "integrity": "sha512-FHcKFCZcAha3LwfVBhCQbW2nCNbkZXn7KVUJcsT5/P8YmfsVja0FMPJr0B903j/E69HUphKiV9iQArX8SDYA4w==",
+      "license": "MIT",
+      "optional": true,
+      "dependencies": {
+        "utrie": "^1.0.2"
+      }
+    },
+    "node_modules/css-render": {
+      "version": "0.15.14",
+      "resolved": "https://registry.npmjs.org/css-render/-/css-render-0.15.14.tgz",
+      "integrity": "sha512-9nF4PdUle+5ta4W5SyZdLCCmFd37uVimSjg1evcTqKJCyvCEEj12WKzOSBNak6r4im4J4iYXKH1OWpUV5LBYFg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@emotion/hash": "~0.8.0",
+        "csstype": "~3.0.5"
+      }
+    },
+    "node_modules/css-render/node_modules/csstype": {
+      "version": "3.0.11",
+      "resolved": "https://registry.npmjs.org/csstype/-/csstype-3.0.11.tgz",
+      "integrity": "sha512-sa6P2wJ+CAbgyy4KFssIb/JNMLxFvKF1pCYCSXS8ZMuqZnMsrxqI2E5sPyoTpxoPU/gVZMzr2zjOfg8GIZOMsw==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/css-tree": {
+      "version": "3.2.1",
+      "resolved": "https://registry.npmjs.org/css-tree/-/css-tree-3.2.1.tgz",
+      "integrity": "sha512-X7sjQzceUhu1u7Y/ylrRZFU2FS6LRiFVp6rKLPg23y3x3c3DOKAwuXGDp+PAGjh6CSnCjYeAul8pcT8bAl+lSA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "mdn-data": "2.27.1",
+        "source-map-js": "^1.2.1"
+      },
+      "engines": {
+        "node": "^10 || ^12.20.0 || ^14.13.0 || >=15.0.0"
+      }
+    },
+    "node_modules/cssesc": {
+      "version": "3.0.0",
+      "resolved": "https://registry.npmjs.org/cssesc/-/cssesc-3.0.0.tgz",
+      "integrity": "sha512-/Tb/JcjK111nNScGob5MNtsntNM1aCNUDipB/TkwZFhyDrrE47SOx/18wF2bbjgc3ZzCSKW1T5nt5EbFoAz/Vg==",
+      "license": "MIT",
+      "bin": {
+        "cssesc": "bin/cssesc"
+      },
+      "engines": {
+        "node": ">=4"
+      }
+    },
+    "node_modules/cssstyle": {
+      "version": "4.6.0",
+      "resolved": "https://registry.npmjs.org/cssstyle/-/cssstyle-4.6.0.tgz",
+      "integrity": "sha512-2z+rWdzbbSZv6/rhtvzvqeZQHrBaqgogqt85sqFNbabZOuFbCVFb8kPeEtZjiKkbrm395irpNKiYeFeLiQnFPg==",
+      "license": "MIT",
+      "optional": true,
+      "dependencies": {
+        "@asamuzakjp/css-color": "^3.2.0",
+        "rrweb-cssom": "^0.8.0"
+      },
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/csstype": {
+      "version": "3.2.3",
+      "resolved": "https://registry.npmjs.org/csstype/-/csstype-3.2.3.tgz",
+      "integrity": "sha512-z1HGKcYy2xA8AGQfwrn0PAy+PB7X/GSj3UVJW9qKyn43xWa+gl5nXmU4qqLMRzWVLFC8KusUX8T/0kCiOYpAIQ==",
+      "license": "MIT"
+    },
+    "node_modules/data-urls": {
+      "version": "5.0.0",
+      "resolved": "https://registry.npmjs.org/data-urls/-/data-urls-5.0.0.tgz",
+      "integrity": "sha512-ZYP5VBHshaDAiVZxjbRVcFJpc+4xGgT0bK3vzy1HLN8jTO975HEbuYzZJcHoQEY5K1a0z8YayJkyVETa08eNTg==",
+      "license": "MIT",
+      "optional": true,
+      "dependencies": {
+        "whatwg-mimetype": "^4.0.0",
+        "whatwg-url": "^14.0.0"
+      },
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/data-urls/node_modules/whatwg-mimetype": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/whatwg-mimetype/-/whatwg-mimetype-4.0.0.tgz",
+      "integrity": "sha512-QaKxh0eNIi2mE9p2vEdzfagOKHCcj1pJ56EEHGQOVxp8r9/iszLUUV7v89x9O1p/T+NlTM5W7jW6+cz4Fq1YVg==",
+      "license": "MIT",
+      "optional": true,
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/date-fns": {
+      "version": "4.4.0",
+      "resolved": "https://registry.npmjs.org/date-fns/-/date-fns-4.4.0.tgz",
+      "integrity": "sha512-+1UMbeh68lH1SegH83CGWwpb6OHHbpSgr3+s5Eww5M4CAgswBpoWS0AjTOfEJ33HiYKz1hdj/KTFprzXHmq/6w==",
+      "dev": true,
+      "license": "MIT",
+      "funding": {
+        "type": "github",
+        "url": "https://github.com/sponsors/kossnocorp"
+      }
+    },
+    "node_modules/date-fns-tz": {
+      "version": "3.2.0",
+      "resolved": "https://registry.npmjs.org/date-fns-tz/-/date-fns-tz-3.2.0.tgz",
+      "integrity": "sha512-sg8HqoTEulcbbbVXeg84u5UnlsQa8GS5QXMqjjYIhS4abEVVKIUwe0/l/UhrZdKaL/W5eWZNlbTeEIiOXTcsBQ==",
+      "dev": true,
+      "license": "MIT",
+      "peerDependencies": {
+        "date-fns": "^3.0.0 || ^4.0.0"
+      }
+    },
+    "node_modules/debug": {
+      "version": "4.4.3",
+      "resolved": "https://registry.npmjs.org/debug/-/debug-4.4.3.tgz",
+      "integrity": "sha512-RGwwWnwQvkVfavKVt22FGLw+xYSdzARwm0ru6DhTVA3umU5hZc28V3kO4stgYryrTlLpuvgI9GiijltAjNbcqA==",
+      "devOptional": true,
+      "license": "MIT",
+      "dependencies": {
+        "ms": "^2.1.3"
+      },
+      "engines": {
+        "node": ">=6.0"
+      },
+      "peerDependenciesMeta": {
+        "supports-color": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/decamelize": {
+      "version": "1.2.0",
+      "resolved": "https://registry.npmjs.org/decamelize/-/decamelize-1.2.0.tgz",
+      "integrity": "sha512-z2S+W9X73hAUUki+N+9Za2lBlun89zigOyGrsax+KUQ6wKW4ZoWpEYBkGhQjwAjjDCkWxhY0VKEhk8wzY7F5cA==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/decimal.js": {
+      "version": "10.6.0",
+      "resolved": "https://registry.npmjs.org/decimal.js/-/decimal.js-10.6.0.tgz",
+      "integrity": "sha512-YpgQiITW3JXGntzdUmyUR1V812Hn8T1YVXhCu+wO3OpS4eU9l4YdD3qjyiKdV6mvV29zapkMeD390UVEf2lkUg==",
+      "license": "MIT",
+      "optional": true
+    },
+    "node_modules/decompress-response": {
+      "version": "6.0.0",
+      "resolved": "https://registry.npmjs.org/decompress-response/-/decompress-response-6.0.0.tgz",
+      "integrity": "sha512-aW35yZM6Bb/4oJlZncMH2LCoZtJXTRxES17vE3hoRiowU2kWHaJKFkSBDnDR+cm9J+9QhXmREyIfv0pji9ejCQ==",
+      "license": "MIT",
+      "optional": true,
+      "dependencies": {
+        "mimic-response": "^3.1.0"
+      },
+      "engines": {
+        "node": ">=10"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/deep-eql": {
+      "version": "5.0.2",
+      "resolved": "https://registry.npmjs.org/deep-eql/-/deep-eql-5.0.2.tgz",
+      "integrity": "sha512-h5k/5U50IJJFpzfL6nO9jaaumfjO/f2NjK/oYB2Djzm4p9L+3T9qWpZqZ2hAbLPuuYq9wrU08WQyBTL5GbPk5Q==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=6"
+      }
+    },
+    "node_modules/deep-extend": {
+      "version": "0.6.0",
+      "resolved": "https://registry.npmjs.org/deep-extend/-/deep-extend-0.6.0.tgz",
+      "integrity": "sha512-LOHxIOaPYdHlJRtCQfDIVZtfw/ufM8+rVj649RIHzcm/vGwQRXFt6OPqIFWsm2XEMrNIEtWR64sY1LEKD2vAOA==",
+      "license": "MIT",
+      "optional": true,
+      "engines": {
+        "node": ">=4.0.0"
+      }
+    },
+    "node_modules/default-browser": {
+      "version": "5.5.0",
+      "resolved": "https://registry.npmjs.org/default-browser/-/default-browser-5.5.0.tgz",
+      "integrity": "sha512-H9LMLr5zwIbSxrmvikGuI/5KGhZ8E2zH3stkMgM5LpOWDutGM2JZaj460Udnf1a+946zc7YBgrqEWwbk7zHvGw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "bundle-name": "^4.1.0",
+        "default-browser-id": "^5.0.0"
+      },
+      "engines": {
+        "node": ">=18"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/default-browser-id": {
+      "version": "5.0.1",
+      "resolved": "https://registry.npmjs.org/default-browser-id/-/default-browser-id-5.0.1.tgz",
+      "integrity": "sha512-x1VCxdX4t+8wVfd1so/9w+vQ4vx7lKd2Qp5tDRutErwmR85OgmfX7RlLRMWafRMY7hbEiXIbudNrjOAPa/hL8Q==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=18"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/define-lazy-prop": {
+      "version": "3.0.0",
+      "resolved": "https://registry.npmjs.org/define-lazy-prop/-/define-lazy-prop-3.0.0.tgz",
+      "integrity": "sha512-N+MeXYoqr3pOgn8xfyRPREN7gHakLYjhsHhWGT3fWAiL4IkAt0iDw14QiiEm2bE30c5XX5q0FtAA3CK5f9/BUg==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=12"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/defu": {
+      "version": "6.1.7",
+      "resolved": "https://registry.npmjs.org/defu/-/defu-6.1.7.tgz",
+      "integrity": "sha512-7z22QmUWiQ/2d0KkdYmANbRUVABpZ9SNYyH5vx6PZ+nE5bcC0l7uFvEfHlyld/HcGBFTL536ClDt3DEcSlEJAQ==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/destr": {
+      "version": "2.0.5",
+      "resolved": "https://registry.npmjs.org/destr/-/destr-2.0.5.tgz",
+      "integrity": "sha512-ugFTXCtDZunbzasqBxrK93Ik/DRYsO6S/fedkWEMKqt04xZ4csmnmwGDBAb07QWNaGMAmnTIemsYZCksjATwsA==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/detect-libc": {
+      "version": "2.1.2",
+      "resolved": "https://registry.npmjs.org/detect-libc/-/detect-libc-2.1.2.tgz",
+      "integrity": "sha512-Btj2BOOO83o3WyH59e8MgXsxEQVcarkUOpEYrubB0urwnN10yQ364rsiByU11nZlqWYZm05i/of7io4mzihBtQ==",
+      "devOptional": true,
+      "license": "Apache-2.0",
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/dijkstrajs": {
+      "version": "1.0.3",
+      "resolved": "https://registry.npmjs.org/dijkstrajs/-/dijkstrajs-1.0.3.tgz",
+      "integrity": "sha512-qiSlmBq9+BCdCA/L46dw8Uy93mloxsPSbwnm5yrKn2vMPiy8KyAskTF6zuV/j5BMsmOGZDPs7KjU+mjb670kfA==",
+      "license": "MIT"
+    },
+    "node_modules/dompurify": {
+      "version": "3.4.13",
+      "resolved": "https://registry.npmjs.org/dompurify/-/dompurify-3.4.13.tgz",
+      "integrity": "sha512-2vmYIoqjze2d+kakP8S/nS5shfsl587kzwEjcGlTdiksUVgFHnFCsLYDVj/JNqJVOQZGSYBTmuycv0PodwmnMQ==",
+      "license": "(MPL-2.0 OR Apache-2.0)",
+      "optionalDependencies": {
+        "@types/trusted-types": "^2.0.7"
+      }
+    },
+    "node_modules/duplexer": {
+      "version": "0.1.2",
+      "resolved": "https://registry.npmjs.org/duplexer/-/duplexer-0.1.2.tgz",
+      "integrity": "sha512-jtD6YG370ZCIi/9GTaJKQxWTZD045+4R4hTk/x1UyoqadyJ9x9CgSi1RlVDQF8U2sxLLSnFkCaMihqljHIWgMg==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/eastasianwidth": {
+      "version": "0.2.0",
+      "resolved": "https://registry.npmjs.org/eastasianwidth/-/eastasianwidth-0.2.0.tgz",
+      "integrity": "sha512-I88TYZWc9XiYHRQ4/3c5rjjfgkjhLyW2luGIheGERbNQ6OY7yTybanSpDXZa8y7VUP9YmDcYa+eyq4ca7iLqWA==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/electron-to-chromium": {
+      "version": "1.5.402",
+      "resolved": "https://registry.npmjs.org/electron-to-chromium/-/electron-to-chromium-1.5.402.tgz",
+      "integrity": "sha512-/oOpMaPT6Yg+6/1XQhyIPlzgj7Ye9zf+nNM2Uh6OcE2G2oNptWazFa+qB2Pdqqbsc9KnIDzgAntoYN0dbwOXwA==",
+      "dev": true,
+      "license": "ISC"
+    },
+    "node_modules/emoji-regex": {
+      "version": "9.2.2",
+      "resolved": "https://registry.npmjs.org/emoji-regex/-/emoji-regex-9.2.2.tgz",
+      "integrity": "sha512-L18DaJsXSUk2+42pv8mLs5jJT2hqFkFE4j21wOmgbUqsZ2hL72NsUU785g9RXgo3s0ZNgVl42TiHp3ZtOv/Vyg==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/end-of-stream": {
+      "version": "1.4.5",
+      "resolved": "https://registry.npmjs.org/end-of-stream/-/end-of-stream-1.4.5.tgz",
+      "integrity": "sha512-ooEGc6HP26xXq/N+GCGOT0JKCLDGrq2bQUZrQ7gyrJiZANJ/8YDTxTpQBXGMn+WbIQXNVpyWymm7KYVICQnyOg==",
+      "license": "MIT",
+      "optional": true,
+      "dependencies": {
+        "once": "^1.4.0"
+      }
+    },
+    "node_modules/entities": {
+      "version": "7.0.1",
+      "resolved": "https://registry.npmjs.org/entities/-/entities-7.0.1.tgz",
+      "integrity": "sha512-TWrgLOFUQTH994YUyl1yT4uyavY5nNB5muff+RtWaqNVCAK408b5ZnnbNAUEWLTCpum9w6arT70i1XdQ4UeOPA==",
+      "license": "BSD-2-Clause",
+      "engines": {
+        "node": ">=0.12"
+      },
+      "funding": {
+        "url": "https://github.com/fb55/entities?sponsor=1"
+      }
+    },
+    "node_modules/error-stack-parser-es": {
+      "version": "1.0.5",
+      "resolved": "https://registry.npmjs.org/error-stack-parser-es/-/error-stack-parser-es-1.0.5.tgz",
+      "integrity": "sha512-5qucVt2XcuGMcEGgWI7i+yZpmpByQ8J1lHhcL7PwqCwu9FPP3VUXzT4ltHe5i2z9dePwEHcDVOAfSnHsOlCXRA==",
+      "dev": true,
+      "license": "MIT",
+      "funding": {
+        "url": "https://github.com/sponsors/antfu"
+      }
+    },
+    "node_modules/es-module-lexer": {
+      "version": "1.7.0",
+      "resolved": "https://registry.npmjs.org/es-module-lexer/-/es-module-lexer-1.7.0.tgz",
+      "integrity": "sha512-jEQoCwk8hyb2AZziIOLhDqpm5+2ww5uIE6lkO/6jcOCusfk6LhMHpXXfBLXTZ7Ydyt0j4VoUQv6uGNYbdW+kBA==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/esbuild": {
+      "version": "0.28.1",
+      "resolved": "https://registry.npmjs.org/esbuild/-/esbuild-0.28.1.tgz",
+      "integrity": "sha512-HrJrvZv5ayxBzPfwphOoNzkzOIIlifzk0KJrGK2c8R4+LKpMtpYLQeUdjnwjWv/LZlkH2laZk+4w78pi99D4Vw==",
+      "dev": true,
+      "hasInstallScript": true,
+      "license": "MIT",
+      "bin": {
+        "esbuild": "bin/esbuild"
+      },
+      "engines": {
+        "node": ">=18"
+      },
+      "optionalDependencies": {
+        "@esbuild/aix-ppc64": "0.28.1",
+        "@esbuild/android-arm": "0.28.1",
+        "@esbuild/android-arm64": "0.28.1",
+        "@esbuild/android-x64": "0.28.1",
+        "@esbuild/darwin-arm64": "0.28.1",
+        "@esbuild/darwin-x64": "0.28.1",
+        "@esbuild/freebsd-arm64": "0.28.1",
+        "@esbuild/freebsd-x64": "0.28.1",
+        "@esbuild/linux-arm": "0.28.1",
+        "@esbuild/linux-arm64": "0.28.1",
+        "@esbuild/linux-ia32": "0.28.1",
+        "@esbuild/linux-loong64": "0.28.1",
+        "@esbuild/linux-mips64el": "0.28.1",
+        "@esbuild/linux-ppc64": "0.28.1",
+        "@esbuild/linux-riscv64": "0.28.1",
+        "@esbuild/linux-s390x": "0.28.1",
+        "@esbuild/linux-x64": "0.28.1",
+        "@esbuild/netbsd-arm64": "0.28.1",
+        "@esbuild/netbsd-x64": "0.28.1",
+        "@esbuild/openbsd-arm64": "0.28.1",
+        "@esbuild/openbsd-x64": "0.28.1",
+        "@esbuild/openharmony-arm64": "0.28.1",
+        "@esbuild/sunos-x64": "0.28.1",
+        "@esbuild/win32-arm64": "0.28.1",
+        "@esbuild/win32-ia32": "0.28.1",
+        "@esbuild/win32-x64": "0.28.1"
+      }
+    },
+    "node_modules/escalade": {
+      "version": "3.2.0",
+      "resolved": "https://registry.npmjs.org/escalade/-/escalade-3.2.0.tgz",
+      "integrity": "sha512-WUj2qlxaQtO4g6Pq5c29GTcWGDyd8itL8zTlipgECz3JesAiiOKotd8JU6otB3PACgG6xkJUyVhboMS+bje/jA==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=6"
+      }
+    },
+    "node_modules/estree-walker": {
+      "version": "3.0.3",
+      "resolved": "https://registry.npmjs.org/estree-walker/-/estree-walker-3.0.3.tgz",
+      "integrity": "sha512-7RUKfXgSMMkzt6ZuXmqapOurLGPPfgj6l9uRZ7lRGolvk0y2yocc35LdcxKC5PQZdn2DMqioAQ2NoWcrTKmm6g==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@types/estree": "^1.0.0"
+      }
+    },
+    "node_modules/evtd": {
+      "version": "0.2.4",
+      "resolved": "https://registry.npmjs.org/evtd/-/evtd-0.2.4.tgz",
+      "integrity": "sha512-qaeGN5bx63s/AXgQo8gj6fBkxge+OoLddLniox5qtLAEY5HSnuSlISXVPxnSae1dWblvTh4/HoMIB+mbMsvZzw==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/expand-template": {
+      "version": "2.0.3",
+      "resolved": "https://registry.npmjs.org/expand-template/-/expand-template-2.0.3.tgz",
+      "integrity": "sha512-XYfuKMvj4O35f/pOXLObndIRvyQ+/+6AhODh+OKWj9S9498pHHn/IMszH+gt0fBCRWMNfk1ZSp5x3AifmnI2vg==",
+      "license": "(MIT OR WTFPL)",
+      "optional": true,
+      "engines": {
+        "node": ">=6"
+      }
+    },
+    "node_modules/expect-type": {
+      "version": "1.4.0",
+      "resolved": "https://registry.npmjs.org/expect-type/-/expect-type-1.4.0.tgz",
+      "integrity": "sha512-KfYbmpRm0VbLjEvVa9yGwCi9GI34xvi7A/HXYWQO65CSD2u3MczUJSuwXKFIxlGsgBQizV9q5J9NHj4VG0n+pA==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "engines": {
+        "node": ">=12.0.0"
+      }
+    },
+    "node_modules/fabric": {
+      "version": "7.4.0",
+      "resolved": "https://registry.npmjs.org/fabric/-/fabric-7.4.0.tgz",
+      "integrity": "sha512-NalYDc3eifTl1C33zryQwpH6+XA/2ClxQrH9vkASkZw3tbkRmorpikhYMmxhUTmi7O3e9ODz0vOT8qfaCh9IVA==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=20.0.0"
+      },
+      "optionalDependencies": {
+        "canvas": "^3.2.0",
+        "jsdom": "^26.1.0"
+      }
+    },
+    "node_modules/fast-deep-equal": {
+      "version": "3.1.3",
+      "resolved": "https://registry.npmjs.org/fast-deep-equal/-/fast-deep-equal-3.1.3.tgz",
+      "integrity": "sha512-f3qQ9oQy9j2AhBe/H9VC91wLmKBCCU/gDOnKNAYG5hswO7BLKj09Hc5HYNz9cGI++xlpDCIgDaitVs03ATR84Q==",
+      "license": "MIT"
+    },
+    "node_modules/fast-png": {
+      "version": "6.4.0",
+      "resolved": "https://registry.npmjs.org/fast-png/-/fast-png-6.4.0.tgz",
+      "integrity": "sha512-kAqZq1TlgBjZcLr5mcN6NP5Rv4V2f22z00c3g8vRrwkcqjerx7BEhPbOnWCPqaHUl2XWQBJQvOT/FQhdMT7X/Q==",
+      "license": "MIT",
+      "dependencies": {
+        "@types/pako": "^2.0.3",
+        "iobuffer": "^5.3.2",
+        "pako": "^2.1.0"
+      }
+    },
+    "node_modules/fast-uri": {
+      "version": "3.1.5",
+      "resolved": "https://registry.npmjs.org/fast-uri/-/fast-uri-3.1.5.tgz",
+      "integrity": "sha512-gHwA1O9LDIcKunMKhObS/HimwtehO1nPUECKAu5TpKgaO19fcWEl4bliWe1jWxVFvIXztJjjQ4L8XQ1EU9f7Jw==",
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/fastify"
+        },
+        {
+          "type": "opencollective",
+          "url": "https://opencollective.com/fastify"
+        }
+      ],
+      "license": "BSD-3-Clause"
+    },
+    "node_modules/fdir": {
+      "version": "6.5.0",
+      "resolved": "https://registry.npmjs.org/fdir/-/fdir-6.5.0.tgz",
+      "integrity": "sha512-tIbYtZbucOs0BRGqPJkshJUYdL+SDH7dVM8gjy+ERp3WAUjLEFJE+02kanyHtwjWOnwrKYBiwAmM0p4kLJAnXg==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=12.0.0"
+      },
+      "peerDependencies": {
+        "picomatch": "^3 || ^4"
+      },
+      "peerDependenciesMeta": {
+        "picomatch": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/fflate": {
+      "version": "0.8.3",
+      "resolved": "https://registry.npmjs.org/fflate/-/fflate-0.8.3.tgz",
+      "integrity": "sha512-tbZNuJrLwGUp3zshBtdy4W+ORxZuIh8a5ilyIEQDC5rY1f3U20JMry0Ll3WBzU58EZKsEuJFXhb5gwv8CsPvgA==",
+      "license": "MIT"
+    },
+    "node_modules/find-up": {
+      "version": "4.1.0",
+      "resolved": "https://registry.npmjs.org/find-up/-/find-up-4.1.0.tgz",
+      "integrity": "sha512-PpOwAdQ/YlXQ2vj8a3h8IipDuYRi3wceVQQGYWxNINccq40Anw7BlsEXCMbt1Zt+OLA6Fq9suIpIWD0OsnISlw==",
+      "license": "MIT",
+      "dependencies": {
+        "locate-path": "^5.0.0",
+        "path-exists": "^4.0.0"
+      },
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/font-family-papandreou": {
+      "version": "0.2.0-patch2",
+      "resolved": "https://registry.npmjs.org/font-family-papandreou/-/font-family-papandreou-0.2.0-patch2.tgz",
+      "integrity": "sha512-l/YiRdBSH/eWv6OF3sLGkwErL+n0MqCICi9mppTZBOCL5vixWGDqCYvRcuxB2h7RGCTzaTKOHT2caHvCXQPRlw==",
+      "license": "MIT"
+    },
+    "node_modules/foreground-child": {
+      "version": "3.3.1",
+      "resolved": "https://registry.npmjs.org/foreground-child/-/foreground-child-3.3.1.tgz",
+      "integrity": "sha512-gIXjKqtFuWEgzFRJA9WCQeSJLZDjgJUOMCMzxtvFq/37KojM1BFGufqsCy0r4qSQmYLsZYMeyRqzIWOMup03sw==",
+      "dev": true,
+      "license": "ISC",
+      "dependencies": {
+        "cross-spawn": "^7.0.6",
+        "signal-exit": "^4.0.1"
+      },
+      "engines": {
+        "node": ">=14"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/isaacs"
+      }
+    },
+    "node_modules/frac": {
+      "version": "1.1.2",
+      "resolved": "https://registry.npmjs.org/frac/-/frac-1.1.2.tgz",
+      "integrity": "sha512-w/XBfkibaTl3YDqASwfDUqkna4Z2p9cFSr1aHDt0WoMTECnRfBOv2WArlZILlqgWlmdIlALXGpM2AOhEk5W3IA==",
+      "license": "Apache-2.0",
+      "engines": {
+        "node": ">=0.8"
+      }
+    },
+    "node_modules/fs-constants": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/fs-constants/-/fs-constants-1.0.0.tgz",
+      "integrity": "sha512-y6OAwoSIf7FyjMIv94u+b5rdheZEjzR63GTyZJm5qh4Bi+2YgwLCcI/fPFZkL5PSixOt6ZNKm+w+Hfp/Bciwow==",
+      "license": "MIT",
+      "optional": true
+    },
+    "node_modules/fsevents": {
+      "version": "2.3.3",
+      "resolved": "https://registry.npmjs.org/fsevents/-/fsevents-2.3.3.tgz",
+      "integrity": "sha512-5xoDfX+fL7faATnagmWPpbFtwh/R77WmMMqqHGS65C3vvB0YHrgF+B1YmZ3441tMj5n63k0212XNoJwzlhffQw==",
+      "dev": true,
+      "hasInstallScript": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "darwin"
+      ],
+      "engines": {
+        "node": "^8.16.0 || ^10.6.0 || >=11.0.0"
+      }
+    },
+    "node_modules/gensync": {
+      "version": "1.0.0-beta.2",
+      "resolved": "https://registry.npmjs.org/gensync/-/gensync-1.0.0-beta.2.tgz",
+      "integrity": "sha512-3hN7NaskYvMDLQY55gnW3NQ+mesEAepTqlg+VEbj7zzqEMBVNhzcGYYeqFo/TlYz6eQiFcp1HcsCZO+nGgS8zg==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=6.9.0"
+      }
+    },
+    "node_modules/get-caller-file": {
+      "version": "2.0.5",
+      "resolved": "https://registry.npmjs.org/get-caller-file/-/get-caller-file-2.0.5.tgz",
+      "integrity": "sha512-DyFP3BM/3YHTQOCUL/w0OZHR0lpKeGrxotcHWcqNEdnltqFwXVfhEBQ94eIo34AfQpo0rGki4cyIiftY06h2Fg==",
+      "license": "ISC",
+      "engines": {
+        "node": "6.* || 8.* || >= 10.*"
+      }
+    },
+    "node_modules/github-from-package": {
+      "version": "0.0.0",
+      "resolved": "https://registry.npmjs.org/github-from-package/-/github-from-package-0.0.0.tgz",
+      "integrity": "sha512-SyHy3T1v2NUXn29OsWdxmK6RwHD+vkj3v8en8AOBZ1wBQ/hCAQ5bAQTD02kW4W9tUp/3Qh6J8r9EvntiyCmOOw==",
+      "license": "MIT",
+      "optional": true
+    },
+    "node_modules/glob": {
+      "version": "10.5.0",
+      "resolved": "https://registry.npmjs.org/glob/-/glob-10.5.0.tgz",
+      "integrity": "sha512-DfXN8DfhJ7NH3Oe7cFmu3NCu1wKbkReJ8TorzSAFbSKrlNaQSKfIzqYqVY8zlbs2NLBbWpRiU52GX2PbaBVNkg==",
+      "deprecated": "Old versions of glob are not supported, and contain widely publicized security vulnerabilities, which have been fixed in the current version. Please update. Support for old versions may be purchased (at exorbitant rates) by contacting i@izs.me",
+      "dev": true,
+      "license": "ISC",
+      "dependencies": {
+        "foreground-child": "^3.1.0",
+        "jackspeak": "^3.1.2",
+        "minimatch": "^9.0.4",
+        "minipass": "^7.1.2",
+        "package-json-from-dist": "^1.0.0",
+        "path-scurry": "^1.11.1"
+      },
+      "bin": {
+        "glob": "dist/esm/bin.mjs"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/isaacs"
+      }
+    },
+    "node_modules/glob/node_modules/balanced-match": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/balanced-match/-/balanced-match-1.0.2.tgz",
+      "integrity": "sha512-3oSeUO0TMV67hN1AmbXsK4yaqU7tjiHlbxRDZOpH0KW9+CeX4bRAaX0Anxt0tx2MrpRpWwQaPwIlISEJhYU5Pw==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/glob/node_modules/brace-expansion": {
+      "version": "2.1.4",
+      "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-2.1.4.tgz",
+      "integrity": "sha512-hGfVzPxthbf3+2yjg/RBs60cB0FhqBS/zvdV/4wn4/BmN0bNMMHPc4V/BbFieqf1TKAGGAHnY4eSjajCl0f2Xg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "balanced-match": "^1.0.0"
+      }
+    },
+    "node_modules/glob/node_modules/minimatch": {
+      "version": "9.0.9",
+      "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-9.0.9.tgz",
+      "integrity": "sha512-OBwBN9AL4dqmETlpS2zasx+vTeWclWzkblfZk7KTA5j3jeOONz/tRCnZomUyvNg83wL5Zv9Ss6HMJXAgL8R2Yg==",
+      "dev": true,
+      "license": "ISC",
+      "dependencies": {
+        "brace-expansion": "^2.0.2"
+      },
+      "engines": {
+        "node": ">=16 || 14 >=14.17"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/isaacs"
+      }
+    },
+    "node_modules/gzip-size": {
+      "version": "6.0.0",
+      "resolved": "https://registry.npmjs.org/gzip-size/-/gzip-size-6.0.0.tgz",
+      "integrity": "sha512-ax7ZYomf6jqPTQ4+XCpUGyXKHk5WweS+e05MBO4/y3WJ5RkmPXNKvX+bx1behVILVwr6JSQvZAku021CHPXG3Q==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "duplexer": "^0.1.2"
+      },
+      "engines": {
+        "node": ">=10"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/happy-dom": {
+      "version": "20.11.2",
+      "resolved": "https://registry.npmjs.org/happy-dom/-/happy-dom-20.11.2.tgz",
+      "integrity": "sha512-7MB+bJLkxu3SowAfBJbjW+c55kNz5tkR45gu2qzrxznezhLeN5YIlJbwUgSzlGc+qWoZ8Ykg71H5ezz69xixrw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@types/node": ">=20.0.0",
+        "@types/whatwg-mimetype": "^3.0.2",
+        "@types/ws": "^8.18.1",
+        "buffer-image-size": "^0.6.4",
+        "entities": "^7.0.1",
+        "whatwg-mimetype": "^3.0.0",
+        "ws": "^8.21.0"
+      },
+      "engines": {
+        "node": ">=20.0.0"
+      }
+    },
+    "node_modules/has-flag": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-4.0.0.tgz",
+      "integrity": "sha512-EykJT/Q1KjTWctppgIAgfSO0tKVuZUjhgMr17kqTumMl6Afv3EISleU7qZUzoXDFTAHTDC4NOoG/ZxU3EvlMPQ==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/highlight.js": {
+      "version": "11.11.1",
+      "resolved": "https://registry.npmjs.org/highlight.js/-/highlight.js-11.11.1.tgz",
+      "integrity": "sha512-Xwwo44whKBVCYoliBQwaPvtd/2tYFkRQtXDWj1nackaV2JPXx3L0+Jvd8/qCJ2p+ML0/XVkJ2q+Mr+UVdpJK5w==",
+      "dev": true,
+      "license": "BSD-3-Clause",
+      "engines": {
+        "node": ">=12.0.0"
+      }
+    },
+    "node_modules/hookable": {
+      "version": "5.5.3",
+      "resolved": "https://registry.npmjs.org/hookable/-/hookable-5.5.3.tgz",
+      "integrity": "sha512-Yc+BQe8SvoXH1643Qez1zqLRmbA5rCL+sSmk6TVos0LWVfNIB7PGncdlId77WzLGSIB5KaWgTaNTs2lNVEI6VQ==",
+      "license": "MIT"
+    },
+    "node_modules/html-encoding-sniffer": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/html-encoding-sniffer/-/html-encoding-sniffer-4.0.0.tgz",
+      "integrity": "sha512-Y22oTqIU4uuPgEemfz7NDJz6OeKf12Lsu+QC+s3BVpda64lTiMYCyGwg5ki4vFxkMwQdeZDl2adZoqUgdFuTgQ==",
+      "license": "MIT",
+      "optional": true,
+      "dependencies": {
+        "whatwg-encoding": "^3.1.1"
+      },
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/html-escaper": {
+      "version": "2.0.2",
+      "resolved": "https://registry.npmjs.org/html-escaper/-/html-escaper-2.0.2.tgz",
+      "integrity": "sha512-H2iMtd0I4Mt5eYiapRdIDjp+XzelXQ0tFE4JS7YFwFevXXMmOp9myNrUvCg0D6ws8iqkRPBfKHgbwig1SmlLfg==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/html2canvas": {
+      "version": "1.4.1",
+      "resolved": "https://registry.npmjs.org/html2canvas/-/html2canvas-1.4.1.tgz",
+      "integrity": "sha512-fPU6BHNpsyIhr8yyMpTLLxAbkaK8ArIBcmZIRiBLiDhjeqvXolaEmDGmELFuX9I4xDcaKKcJl+TKZLqruBbmWA==",
+      "license": "MIT",
+      "optional": true,
+      "dependencies": {
+        "css-line-break": "^2.1.0",
+        "text-segmentation": "^1.0.3"
+      },
+      "engines": {
+        "node": ">=8.0.0"
+      }
+    },
+    "node_modules/http-proxy-agent": {
+      "version": "7.0.2",
+      "resolved": "https://registry.npmjs.org/http-proxy-agent/-/http-proxy-agent-7.0.2.tgz",
+      "integrity": "sha512-T1gkAiYYDWYx3V5Bmyu7HcfcvL7mUrTWiM6yOfa3PIphViJ/gFPbvidQ+veqSOHci/PxBcDabeUNCzpOODJZig==",
+      "license": "MIT",
+      "optional": true,
+      "dependencies": {
+        "agent-base": "^7.1.0",
+        "debug": "^4.3.4"
+      },
+      "engines": {
+        "node": ">= 14"
+      }
+    },
+    "node_modules/https-proxy-agent": {
+      "version": "7.0.6",
+      "resolved": "https://registry.npmjs.org/https-proxy-agent/-/https-proxy-agent-7.0.6.tgz",
+      "integrity": "sha512-vK9P5/iUfdl95AI+JVyUuIcVtd4ofvtrOr3HNtM2yxC9bnMbEdp3x01OhQNnjb8IJYi38VlTE3mBXwcfvywuSw==",
+      "license": "MIT",
+      "optional": true,
+      "dependencies": {
+        "agent-base": "^7.1.2",
+        "debug": "4"
+      },
+      "engines": {
+        "node": ">= 14"
+      }
+    },
+    "node_modules/iconv-lite": {
+      "version": "0.6.3",
+      "resolved": "https://registry.npmjs.org/iconv-lite/-/iconv-lite-0.6.3.tgz",
+      "integrity": "sha512-4fCk79wshMdzMp2rH06qWrJE4iolqLhCUH+OiuIgU++RB0+94NlDL81atO7GX55uUKueo0txHNtvEyI6D7WdMw==",
+      "license": "MIT",
+      "optional": true,
+      "dependencies": {
+        "safer-buffer": ">= 2.1.2 < 3.0.0"
+      },
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/ieee754": {
+      "version": "1.2.1",
+      "resolved": "https://registry.npmjs.org/ieee754/-/ieee754-1.2.1.tgz",
+      "integrity": "sha512-dcyqhDvX1C46lXZcVqCpK+FtMRQVdIMN6/Df5js2zouUsqG7I6sFxitIC+7KYK29KdXOLHdu9zL4sFnoVQnqaA==",
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/feross"
+        },
+        {
+          "type": "patreon",
+          "url": "https://www.patreon.com/feross"
+        },
+        {
+          "type": "consulting",
+          "url": "https://feross.org/support"
+        }
+      ],
+      "license": "BSD-3-Clause",
+      "optional": true
+    },
+    "node_modules/import-meta-resolve": {
+      "version": "4.2.0",
+      "resolved": "https://registry.npmjs.org/import-meta-resolve/-/import-meta-resolve-4.2.0.tgz",
+      "integrity": "sha512-Iqv2fzaTQN28s/FwZAoFq0ZSs/7hMAHJVX+w8PZl3cY19Pxk6jFFalxQoIfW2826i/fDLXv8IiEZRIT0lDuWcg==",
+      "dev": true,
+      "license": "MIT",
+      "funding": {
+        "type": "github",
+        "url": "https://github.com/sponsors/wooorm"
+      }
+    },
+    "node_modules/inherits": {
+      "version": "2.0.4",
+      "resolved": "https://registry.npmjs.org/inherits/-/inherits-2.0.4.tgz",
+      "integrity": "sha512-k/vGaX4/Yla3WzyMCvTQOXYeIHvqOKtnqBduzTHpzpQZzAskKMhZ2K+EnBiSM9zGSoIFeMpXKxa4dYeZIQqewQ==",
+      "license": "ISC",
+      "optional": true
+    },
+    "node_modules/ini": {
+      "version": "1.3.8",
+      "resolved": "https://registry.npmjs.org/ini/-/ini-1.3.8.tgz",
+      "integrity": "sha512-JV/yugV2uzW5iMRSiZAyDtQd+nxtUnjeLt0acNdw98kKLrvuRVyB80tsREOE7yvGVgalhZ6RNXCmEHkUKBKxew==",
+      "license": "ISC",
+      "optional": true
+    },
+    "node_modules/iobuffer": {
+      "version": "5.4.0",
+      "resolved": "https://registry.npmjs.org/iobuffer/-/iobuffer-5.4.0.tgz",
+      "integrity": "sha512-DRebOWuqDvxunfkNJAlc3IzWIPD5xVxwUNbHr7xKB8E6aLJxIPfNX3CoMJghcFjpv6RWQsrcJbghtEwSPoJqMA==",
+      "license": "MIT"
+    },
+    "node_modules/is-docker": {
+      "version": "3.0.0",
+      "resolved": "https://registry.npmjs.org/is-docker/-/is-docker-3.0.0.tgz",
+      "integrity": "sha512-eljcgEDlEns/7AXFosB5K/2nCM4P7FQPkGc/DWLy5rmFEWvZayGrik1d9/QIY5nJ4f9YsVvBkA6kJpHn9rISdQ==",
+      "dev": true,
+      "license": "MIT",
+      "bin": {
+        "is-docker": "cli.js"
+      },
+      "engines": {
+        "node": "^12.20.0 || ^14.13.1 || >=16.0.0"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/is-fullwidth-code-point": {
+      "version": "3.0.0",
+      "resolved": "https://registry.npmjs.org/is-fullwidth-code-point/-/is-fullwidth-code-point-3.0.0.tgz",
+      "integrity": "sha512-zymm5+u+sCsSWyD9qNaejV3DFvhCKclKdizYaJUuHA83RLjb7nSuGnddCHGv0hk+KY7BMAlsWeK4Ueg6EV6XQg==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/is-in-ssh": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/is-in-ssh/-/is-in-ssh-1.0.0.tgz",
+      "integrity": "sha512-jYa6Q9rH90kR1vKB6NM7qqd1mge3Fx4Dhw5TVlK1MUBqhEOuCagrEHMevNuCcbECmXZ0ThXkRm+Ymr51HwEPAw==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=20"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/is-inside-container": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/is-inside-container/-/is-inside-container-1.0.0.tgz",
+      "integrity": "sha512-KIYLCCJghfHZxqjYBE7rEy0OBuTd5xCHS7tHVgvCLkx7StIoaxwNW3hCALgEUjFfeRk+MG/Qxmp/vtETEF3tRA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "is-docker": "^3.0.0"
+      },
+      "bin": {
+        "is-inside-container": "cli.js"
+      },
+      "engines": {
+        "node": ">=14.16"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/is-potential-custom-element-name": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/is-potential-custom-element-name/-/is-potential-custom-element-name-1.0.1.tgz",
+      "integrity": "sha512-bCYeRA2rVibKZd+s2625gGnGF/t7DSqDs4dP7CrLA1m7jKWz6pps0LpYLJN8Q64HtmPKJ1hrN3nzPNKFEKOUiQ==",
+      "license": "MIT",
+      "optional": true
+    },
+    "node_modules/is-wsl": {
+      "version": "3.1.1",
+      "resolved": "https://registry.npmjs.org/is-wsl/-/is-wsl-3.1.1.tgz",
+      "integrity": "sha512-e6rvdUCiQCAuumZslxRJWR/Doq4VpPR82kqclvcS0efgt430SlGIk05vdCN58+VrzgtIcfNODjozVielycD4Sw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "is-inside-container": "^1.0.0"
+      },
+      "engines": {
+        "node": ">=16"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/isexe": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/isexe/-/isexe-4.0.0.tgz",
+      "integrity": "sha512-FFUtZMpoZ8RqHS3XeXEmHWLA4thH+ZxCv2lOiPIn1Xc7CxrqhWzNSDzD+/chS/zbYezmiwWLdQC09JdQKmthOw==",
+      "dev": true,
+      "license": "BlueOak-1.0.0",
+      "engines": {
+        "node": ">=20"
+      }
+    },
+    "node_modules/istanbul-lib-coverage": {
+      "version": "3.2.2",
+      "resolved": "https://registry.npmjs.org/istanbul-lib-coverage/-/istanbul-lib-coverage-3.2.2.tgz",
+      "integrity": "sha512-O8dpsF+r0WV/8MNRKfnmrtCWhuKjxrq2w+jpzBL5UZKTi2LeVWnWOmWRxFlesJONmc+wLAGvKQZEOanko0LFTg==",
+      "dev": true,
+      "license": "BSD-3-Clause",
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/istanbul-lib-report": {
+      "version": "3.0.1",
+      "resolved": "https://registry.npmjs.org/istanbul-lib-report/-/istanbul-lib-report-3.0.1.tgz",
+      "integrity": "sha512-GCfE1mtsHGOELCU8e/Z7YWzpmybrx/+dSTfLrvY8qRmaY6zXTKWn6WQIjaAFw069icm6GVMNkgu0NzI4iPZUNw==",
+      "dev": true,
+      "license": "BSD-3-Clause",
+      "dependencies": {
+        "istanbul-lib-coverage": "^3.0.0",
+        "make-dir": "^4.0.0",
+        "supports-color": "^7.1.0"
+      },
+      "engines": {
+        "node": ">=10"
+      }
+    },
+    "node_modules/istanbul-lib-source-maps": {
+      "version": "5.0.6",
+      "resolved": "https://registry.npmjs.org/istanbul-lib-source-maps/-/istanbul-lib-source-maps-5.0.6.tgz",
+      "integrity": "sha512-yg2d+Em4KizZC5niWhQaIomgf5WlL4vOOjZ5xGCmF8SnPE/mDWWXgvRExdcpCgh9lLRRa1/fSYp2ymmbJ1pI+A==",
+      "dev": true,
+      "license": "BSD-3-Clause",
+      "dependencies": {
+        "@jridgewell/trace-mapping": "^0.3.23",
+        "debug": "^4.1.1",
+        "istanbul-lib-coverage": "^3.0.0"
+      },
+      "engines": {
+        "node": ">=10"
+      }
+    },
+    "node_modules/istanbul-reports": {
+      "version": "3.2.0",
+      "resolved": "https://registry.npmjs.org/istanbul-reports/-/istanbul-reports-3.2.0.tgz",
+      "integrity": "sha512-HGYWWS/ehqTV3xN10i23tkPkpH46MLCIMFNCaaKNavAXTF1RkqxawEPtnjnGZ6XKSInBKkiOA5BKS+aZiY3AvA==",
+      "dev": true,
+      "license": "BSD-3-Clause",
+      "dependencies": {
+        "html-escaper": "^2.0.0",
+        "istanbul-lib-report": "^3.0.0"
+      },
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/jackspeak": {
+      "version": "3.4.3",
+      "resolved": "https://registry.npmjs.org/jackspeak/-/jackspeak-3.4.3.tgz",
+      "integrity": "sha512-OGlZQpz2yfahA/Rd1Y8Cd9SIEsqvXkLVoSw/cgwhnhFMDbsQFeZYoJJ7bIZBS9BcamUW96asq/npPWugM+RQBw==",
+      "dev": true,
+      "license": "BlueOak-1.0.0",
+      "dependencies": {
+        "@isaacs/cliui": "^8.0.2"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/isaacs"
+      },
+      "optionalDependencies": {
+        "@pkgjs/parseargs": "^0.11.0"
+      }
+    },
+    "node_modules/jiti": {
+      "version": "2.7.0",
+      "resolved": "https://registry.npmjs.org/jiti/-/jiti-2.7.0.tgz",
+      "integrity": "sha512-AC/7JofJvZGrrneWNaEnJeOLUx+JlGt7tNa0wZiRPT4MY1wmfKjt2+6O2p2uz2+skll8OZZmJMNqeke7kKbNgQ==",
+      "dev": true,
+      "license": "MIT",
+      "bin": {
+        "jiti": "lib/jiti-cli.mjs"
+      }
+    },
+    "node_modules/js-tokens": {
+      "version": "10.0.0",
+      "resolved": "https://registry.npmjs.org/js-tokens/-/js-tokens-10.0.0.tgz",
+      "integrity": "sha512-lM/UBzQmfJRo9ABXbPWemivdCW8V2G8FHaHdypQaIy523snUjog0W71ayWXTjiR+ixeMyVHN2XcpnTd/liPg/Q==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/jsdom": {
+      "version": "26.1.0",
+      "resolved": "https://registry.npmjs.org/jsdom/-/jsdom-26.1.0.tgz",
+      "integrity": "sha512-Cvc9WUhxSMEo4McES3P7oK3QaXldCfNWp7pl2NNeiIFlCoLr3kfq9kb1fxftiwk1FLV7CvpvDfonxtzUDeSOPg==",
+      "license": "MIT",
+      "optional": true,
+      "dependencies": {
+        "cssstyle": "^4.2.1",
+        "data-urls": "^5.0.0",
+        "decimal.js": "^10.5.0",
+        "html-encoding-sniffer": "^4.0.0",
+        "http-proxy-agent": "^7.0.2",
+        "https-proxy-agent": "^7.0.6",
+        "is-potential-custom-element-name": "^1.0.1",
+        "nwsapi": "^2.2.16",
+        "parse5": "^7.2.1",
+        "rrweb-cssom": "^0.8.0",
+        "saxes": "^6.0.0",
+        "symbol-tree": "^3.2.4",
+        "tough-cookie": "^5.1.1",
+        "w3c-xmlserializer": "^5.0.0",
+        "webidl-conversions": "^7.0.0",
+        "whatwg-encoding": "^3.1.1",
+        "whatwg-mimetype": "^4.0.0",
+        "whatwg-url": "^14.1.1",
+        "ws": "^8.18.0",
+        "xml-name-validator": "^5.0.0"
+      },
+      "engines": {
+        "node": ">=18"
+      },
+      "peerDependencies": {
+        "canvas": "^3.0.0"
+      },
+      "peerDependenciesMeta": {
+        "canvas": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/jsdom/node_modules/whatwg-mimetype": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/whatwg-mimetype/-/whatwg-mimetype-4.0.0.tgz",
+      "integrity": "sha512-QaKxh0eNIi2mE9p2vEdzfagOKHCcj1pJ56EEHGQOVxp8r9/iszLUUV7v89x9O1p/T+NlTM5W7jW6+cz4Fq1YVg==",
+      "license": "MIT",
+      "optional": true,
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/jsesc": {
+      "version": "3.1.0",
+      "resolved": "https://registry.npmjs.org/jsesc/-/jsesc-3.1.0.tgz",
+      "integrity": "sha512-/sM3dO2FOzXjKQhJuo0Q173wf2KOo8t4I8vHy6lF9poUp7bKT0/NHE8fPX23PwfhnykfqnC2xRxOnVw5XuGIaA==",
+      "dev": true,
+      "license": "MIT",
+      "bin": {
+        "jsesc": "bin/jsesc"
+      },
+      "engines": {
+        "node": ">=6"
+      }
+    },
+    "node_modules/json-parse-even-better-errors": {
+      "version": "6.0.0",
+      "resolved": "https://registry.npmjs.org/json-parse-even-better-errors/-/json-parse-even-better-errors-6.0.0.tgz",
+      "integrity": "sha512-2/8adwnK1/+Fdjyts4r6wSpfANWw8zdNhU9U/Llk59c6O+DjSisPWPykwoL8gZmocP9Dy64S7oie2g+Mia123A==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": "^22.22.2 || ^24.15.0 || >=26.0.0"
+      }
+    },
+    "node_modules/json-schema-to-ts": {
+      "version": "3.1.1",
+      "resolved": "https://registry.npmjs.org/json-schema-to-ts/-/json-schema-to-ts-3.1.1.tgz",
+      "integrity": "sha512-+DWg8jCJG2TEnpy7kOm/7/AxaYoaRbjVB4LFZLySZlWn8exGs3A4OLJR966cVvU26N7X9TWxl+Jsw7dzAqKT6g==",
+      "license": "MIT",
+      "dependencies": {
+        "@babel/runtime": "^7.18.3",
+        "ts-algebra": "^2.0.0"
+      },
+      "engines": {
+        "node": ">=16"
+      }
+    },
+    "node_modules/json-schema-traverse": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/json-schema-traverse/-/json-schema-traverse-1.0.0.tgz",
+      "integrity": "sha512-NM8/P9n3XjXhIZn1lLhkFaACTOURQXjWhV4BA/RnOv8xvgqtqpAX9IO4mRQxSx1Rlo4tqzeqb0sOlruaOy3dug==",
+      "license": "MIT"
+    },
+    "node_modules/json5": {
+      "version": "2.2.3",
+      "resolved": "https://registry.npmjs.org/json5/-/json5-2.2.3.tgz",
+      "integrity": "sha512-XmOWe7eyHYH14cLdVPoyg+GOH3rYX++KpzrylJwSW98t3Nk+U8XOl8FWKOgwtzdb8lXGf6zYwDUzeHMWfxasyg==",
+      "dev": true,
+      "license": "MIT",
+      "bin": {
+        "json5": "lib/cli.js"
+      },
+      "engines": {
+        "node": ">=6"
+      }
+    },
+    "node_modules/jspdf": {
+      "version": "4.2.1",
+      "resolved": "https://registry.npmjs.org/jspdf/-/jspdf-4.2.1.tgz",
+      "integrity": "sha512-YyAXyvnmjTbR4bHQRLzex3CuINCDlQnBqoSYyjJwTP2x9jDLuKDzy7aKUl0hgx3uhcl7xzg32agn5vlie6HIlQ==",
+      "license": "MIT",
+      "dependencies": {
+        "@babel/runtime": "^7.28.6",
+        "fast-png": "^6.2.0",
+        "fflate": "^0.8.1"
+      },
+      "optionalDependencies": {
+        "canvg": "^3.0.11",
+        "core-js": "^3.6.0",
+        "dompurify": "^3.3.1",
+        "html2canvas": "^1.0.0-rc.5"
+      }
+    },
+    "node_modules/kolorist": {
+      "version": "1.8.0",
+      "resolved": "https://registry.npmjs.org/kolorist/-/kolorist-1.8.0.tgz",
+      "integrity": "sha512-Y+60/zizpJ3HRH8DCss+q95yr6145JXZo46OTpFvDZWLfRCE4qChOyk1b26nMaNpfHHgxagk9dXT5OP0Tfe+dQ==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/lightningcss": {
+      "version": "1.33.0",
+      "resolved": "https://registry.npmjs.org/lightningcss/-/lightningcss-1.33.0.tgz",
+      "integrity": "sha512-WkUDrojuJs0xkgGf2udWxa3yGBRxPtxUkB79i6aCZLRgc7PM8fZe9TosfPDcvEpQZbuFASnHYmRLBLUbmLOIIA==",
+      "dev": true,
+      "license": "MPL-2.0",
+      "dependencies": {
+        "detect-libc": "^2.0.3"
+      },
+      "engines": {
+        "node": ">= 12.0.0"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/parcel"
+      },
+      "optionalDependencies": {
+        "lightningcss-android-arm64": "1.33.0",
+        "lightningcss-darwin-arm64": "1.33.0",
+        "lightningcss-darwin-x64": "1.33.0",
+        "lightningcss-freebsd-x64": "1.33.0",
+        "lightningcss-linux-arm-gnueabihf": "1.33.0",
+        "lightningcss-linux-arm64-gnu": "1.33.0",
+        "lightningcss-linux-arm64-musl": "1.33.0",
+        "lightningcss-linux-x64-gnu": "1.33.0",
+        "lightningcss-linux-x64-musl": "1.33.0",
+        "lightningcss-win32-arm64-msvc": "1.33.0",
+        "lightningcss-win32-x64-msvc": "1.33.0"
+      }
+    },
+    "node_modules/lightningcss-android-arm64": {
+      "version": "1.33.0",
+      "resolved": "https://registry.npmjs.org/lightningcss-android-arm64/-/lightningcss-android-arm64-1.33.0.tgz",
+      "integrity": "sha512-gEpRTalKdosp4Bb8qWtc2iOgE5SeIHlpS1up9bFq2wAyYhl1UdTObYiHe98zEM9SQvSoqQZ1IQD0JNpg3Ml5pg==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MPL-2.0",
+      "optional": true,
+      "os": [
+        "android"
+      ],
+      "engines": {
+        "node": ">= 12.0.0"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/parcel"
+      }
+    },
+    "node_modules/lightningcss-darwin-arm64": {
+      "version": "1.33.0",
+      "resolved": "https://registry.npmjs.org/lightningcss-darwin-arm64/-/lightningcss-darwin-arm64-1.33.0.tgz",
+      "integrity": "sha512-Sciaz8eenNTKn9b3t7+xr0ipTp9YxKQY4npwQ3mrRuL0BAVHBLyZxofhaKBAVtzmtRZ/zTyo0/to4B1uWG/Djg==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MPL-2.0",
+      "optional": true,
+      "os": [
+        "darwin"
+      ],
+      "engines": {
+        "node": ">= 12.0.0"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/parcel"
+      }
+    },
+    "node_modules/lightningcss-darwin-x64": {
+      "version": "1.33.0",
+      "resolved": "https://registry.npmjs.org/lightningcss-darwin-x64/-/lightningcss-darwin-x64-1.33.0.tgz",
+      "integrity": "sha512-Z5UPAxzrjlWNNyGy6i65cJzzvgJ5D3T6wMvs+gWpY9d7qRhANrxqAp6LhxIgZhWEw18RfJTGcRxjuLIBr+m8XQ==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MPL-2.0",
+      "optional": true,
+      "os": [
+        "darwin"
+      ],
+      "engines": {
+        "node": ">= 12.0.0"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/parcel"
+      }
+    },
+    "node_modules/lightningcss-freebsd-x64": {
+      "version": "1.33.0",
+      "resolved": "https://registry.npmjs.org/lightningcss-freebsd-x64/-/lightningcss-freebsd-x64-1.33.0.tgz",
+      "integrity": "sha512-QQM/Ti/hQajJwCY+RiWuCZ9sdtI/XQk7nDK5vC8kkdwixezOlDgvDx7+RT+QjK6FcFT4MpsuoBnHIo/O3StRRg==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MPL-2.0",
+      "optional": true,
+      "os": [
+        "freebsd"
+      ],
+      "engines": {
+        "node": ">= 12.0.0"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/parcel"
+      }
+    },
+    "node_modules/lightningcss-linux-arm-gnueabihf": {
+      "version": "1.33.0",
+      "resolved": "https://registry.npmjs.org/lightningcss-linux-arm-gnueabihf/-/lightningcss-linux-arm-gnueabihf-1.33.0.tgz",
+      "integrity": "sha512-N7FVBe6iS24MlM6R/4RBTxGhQheZGs7tiQ9U32UtF75NzP5Q7xWPRqLBCKxlRQRk3rY1jCIPLzx7WzOhuUIRLQ==",
+      "cpu": [
+        "arm"
+      ],
+      "dev": true,
+      "license": "MPL-2.0",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">= 12.0.0"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/parcel"
+      }
+    },
+    "node_modules/lightningcss-linux-arm64-gnu": {
+      "version": "1.33.0",
+      "resolved": "https://registry.npmjs.org/lightningcss-linux-arm64-gnu/-/lightningcss-linux-arm64-gnu-1.33.0.tgz",
+      "integrity": "sha512-j2v/itmy4HlNxlc6voKXYgBqNi0Ng2LShg4z7GufpEgs05P+2suBVyi9I6YHq5uoVFx9ETin3eCEhLVyXGQnKg==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MPL-2.0",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">= 12.0.0"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/parcel"
+      }
+    },
+    "node_modules/lightningcss-linux-arm64-musl": {
+      "version": "1.33.0",
+      "resolved": "https://registry.npmjs.org/lightningcss-linux-arm64-musl/-/lightningcss-linux-arm64-musl-1.33.0.tgz",
+      "integrity": "sha512-yiO5ROMuYQgXbC60yjZU5CYSFZGKXL0HFATXt9mHJn1+zW55oCtMI9NfcVhYLMFDL7gV7oBPon/EmMMGg2OvtQ==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MPL-2.0",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">= 12.0.0"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/parcel"
+      }
+    },
+    "node_modules/lightningcss-linux-x64-gnu": {
+      "version": "1.33.0",
+      "resolved": "https://registry.npmjs.org/lightningcss-linux-x64-gnu/-/lightningcss-linux-x64-gnu-1.33.0.tgz",
+      "integrity": "sha512-ar+Ju7LmcN0Jo4FpL4hpFybwNG9/3A/Br5KW2n2jyODg3MEZXaDYADdemoNS+BDNfMgKvylJLj4S5tyRActuAg==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MPL-2.0",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">= 12.0.0"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/parcel"
+      }
+    },
+    "node_modules/lightningcss-linux-x64-musl": {
+      "version": "1.33.0",
+      "resolved": "https://registry.npmjs.org/lightningcss-linux-x64-musl/-/lightningcss-linux-x64-musl-1.33.0.tgz",
+      "integrity": "sha512-RYiYbkokw0trfKqqzfF55lginwEPrD3OJDfTuJzFs1MK6iFnDenaz1fqLLtX4ITG3OktJQXOeTaw1awrBAlZPw==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MPL-2.0",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">= 12.0.0"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/parcel"
+      }
+    },
+    "node_modules/lightningcss-win32-arm64-msvc": {
+      "version": "1.33.0",
+      "resolved": "https://registry.npmjs.org/lightningcss-win32-arm64-msvc/-/lightningcss-win32-arm64-msvc-1.33.0.tgz",
+      "integrity": "sha512-1K+MPfLSFVpphzpdbfkhlWk6wBrTObBzS2T6db10PNOZgR9GoVsAWzwNyuhUYYbTp23j+4RrncfujZ4uAzXvwA==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MPL-2.0",
+      "optional": true,
+      "os": [
+        "win32"
+      ],
+      "engines": {
+        "node": ">= 12.0.0"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/parcel"
+      }
+    },
+    "node_modules/lightningcss-win32-x64-msvc": {
+      "version": "1.33.0",
+      "resolved": "https://registry.npmjs.org/lightningcss-win32-x64-msvc/-/lightningcss-win32-x64-msvc-1.33.0.tgz",
+      "integrity": "sha512-OlEICDx/Xl0FqSp4bry8zFnCvGpig3Gl4gCquvYwHuqJKEC1+n9NgDniFvqHGmMv1ZkqDJrDqKKSykTDX+ehuA==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MPL-2.0",
+      "optional": true,
+      "os": [
+        "win32"
+      ],
+      "engines": {
+        "node": ">= 12.0.0"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/parcel"
+      }
+    },
+    "node_modules/linkifyjs": {
+      "version": "4.3.3",
+      "resolved": "https://registry.npmjs.org/linkifyjs/-/linkifyjs-4.3.3.tgz",
+      "integrity": "sha512-P8aEP5U/D1/IlTY2OeYsErdwh9bGuLE30NcXtKEjgdHcahveQoQwM2yZNsioQHsWFz0P7KKudisbrzCgR0sDHg==",
+      "license": "MIT"
+    },
+    "node_modules/locate-path": {
+      "version": "5.0.0",
+      "resolved": "https://registry.npmjs.org/locate-path/-/locate-path-5.0.0.tgz",
+      "integrity": "sha512-t7hw9pI+WvuwNJXwk5zVHpyhIqzg2qTlklJOf0mVxGSbe3Fp2VieZcduNYjaLDoy6p9uGpQEGWG87WpMKlNq8g==",
+      "license": "MIT",
+      "dependencies": {
+        "p-locate": "^4.1.0"
+      },
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/lodash": {
+      "version": "4.18.1",
+      "resolved": "https://registry.npmjs.org/lodash/-/lodash-4.18.1.tgz",
+      "integrity": "sha512-dMInicTPVE8d1e5otfwmmjlxkZoUpiVLwyeTdUsi/Caj/gfzzblBcCE5sRHV/AsjuCmxWrte2TNGSYuCeCq+0Q==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/lodash-es": {
+      "version": "4.18.1",
+      "resolved": "https://registry.npmjs.org/lodash-es/-/lodash-es-4.18.1.tgz",
+      "integrity": "sha512-J8xewKD/Gk22OZbhpOVSwcs60zhd95ESDwezOFuA3/099925PdHJ7OFHNTGtajL3AlZkykD32HykiMo+BIBI8A==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/loupe": {
+      "version": "3.2.1",
+      "resolved": "https://registry.npmjs.org/loupe/-/loupe-3.2.1.tgz",
+      "integrity": "sha512-CdzqowRJCeLU72bHvWqwRBBlLcMEtIvGrlvef74kMnV2AolS9Y8xUv1I0U/MNAWMhBlKIoyuEgoJ0t/bbwHbLQ==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/lru-cache": {
+      "version": "10.4.3",
+      "resolved": "https://registry.npmjs.org/lru-cache/-/lru-cache-10.4.3.tgz",
+      "integrity": "sha512-JNAzZcXrCt42VGLuYz0zfAzDfAvJWW6AfYlDBQyDV5DClI2m5sAmK+OIO7s59XfsRsWHp02jAJrRadPRGTt6SQ==",
+      "devOptional": true,
+      "license": "ISC"
+    },
+    "node_modules/magic-regexp": {
+      "version": "0.10.0",
+      "resolved": "https://registry.npmjs.org/magic-regexp/-/magic-regexp-0.10.0.tgz",
+      "integrity": "sha512-Uly1Bu4lO1hwHUW0CQeSWuRtzCMNO00CmXtS8N6fyvB3B979GOEEeAkiTUDsmbYLAbvpUS/Kt5c4ibosAzVyVg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "estree-walker": "^3.0.3",
+        "magic-string": "^0.30.12",
+        "mlly": "^1.7.2",
+        "regexp-tree": "^0.1.27",
+        "type-level-regexp": "~0.1.17",
+        "ufo": "^1.5.4",
+        "unplugin": "^2.0.0"
+      }
+    },
+    "node_modules/magic-string": {
+      "version": "0.30.21",
+      "resolved": "https://registry.npmjs.org/magic-string/-/magic-string-0.30.21.tgz",
+      "integrity": "sha512-vd2F4YUyEXKGcLHoq+TEyCjxueSeHnFxyyjNp80yg0XV4vUhnDer/lvvlqM/arB5bXQN5K2/3oinyCRyx8T2CQ==",
+      "license": "MIT",
+      "dependencies": {
+        "@jridgewell/sourcemap-codec": "^1.5.5"
+      }
+    },
+    "node_modules/magicast": {
+      "version": "0.3.5",
+      "resolved": "https://registry.npmjs.org/magicast/-/magicast-0.3.5.tgz",
+      "integrity": "sha512-L0WhttDl+2BOsybvEOLK7fW3UA0OQ0IQ2d6Zl2x/a6vVRs3bAY0ECOSHHeL5jD+SbOpOCUEi0y1DgHEn9Qn1AQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/parser": "^7.25.4",
+        "@babel/types": "^7.25.4",
+        "source-map-js": "^1.2.0"
+      }
+    },
+    "node_modules/make-dir": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/make-dir/-/make-dir-4.0.0.tgz",
+      "integrity": "sha512-hXdUTZYIVOt1Ex//jAQi+wTZZpUpwBj/0QsOzqegb3rGMMeJiSEu5xLHnYfBrRV4RH2+OCSOO95Is/7x1WJ4bw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "semver": "^7.5.3"
+      },
+      "engines": {
+        "node": ">=10"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/mdn-data": {
+      "version": "2.27.1",
+      "resolved": "https://registry.npmjs.org/mdn-data/-/mdn-data-2.27.1.tgz",
+      "integrity": "sha512-9Yubnt3e8A0OKwxYSXyhLymGW4sCufcLG6VdiDdUGVkPhpqLxlvP5vl1983gQjJl3tqbrM731mjaZaP68AgosQ==",
+      "dev": true,
+      "license": "CC0-1.0"
+    },
+    "node_modules/memorystream": {
+      "version": "0.3.1",
+      "resolved": "https://registry.npmjs.org/memorystream/-/memorystream-0.3.1.tgz",
+      "integrity": "sha512-S3UwM3yj5mtUSEfP41UZmt/0SCoVYUcU1rkXv+BQ5Ig8ndL4sPoJNBUJERafdPb5jjHJGuMgytgKvKIf58XNBw==",
+      "dev": true,
+      "engines": {
+        "node": ">= 0.10.0"
+      }
+    },
+    "node_modules/mimic-response": {
+      "version": "3.1.0",
+      "resolved": "https://registry.npmjs.org/mimic-response/-/mimic-response-3.1.0.tgz",
+      "integrity": "sha512-z0yWI+4FDrrweS8Zmt4Ej5HdJmky15+L2e6Wgn3+iK5fWzb6T3fhNFq2+MeTRb064c6Wr4N/wv0DzQTjNzHNGQ==",
+      "license": "MIT",
+      "optional": true,
+      "engines": {
+        "node": ">=10"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/minimatch": {
+      "version": "10.2.6",
+      "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-10.2.6.tgz",
+      "integrity": "sha512-vpLQEs+VLCr1nU0BXS07maYoFwlDAH0gngQuuttxIwutDFEMHq2blX+8vpgxDdK3J1PwjCJiep77OitTZ4Ll1A==",
+      "dev": true,
+      "license": "BlueOak-1.0.0",
+      "dependencies": {
+        "brace-expansion": "^5.0.8"
+      },
+      "engines": {
+        "node": "18 || 20 || >=22"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/isaacs"
+      }
+    },
+    "node_modules/minimist": {
+      "version": "1.2.8",
+      "resolved": "https://registry.npmjs.org/minimist/-/minimist-1.2.8.tgz",
+      "integrity": "sha512-2yyAR8qBkN3YuheJanUpWC5U3bb5osDywNB8RzDVlDwDHbocAJveqqj1u8+SVD7jkWT4yvsHCpWqqWqAxb0zCA==",
+      "license": "MIT",
+      "optional": true,
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/minipass": {
+      "version": "7.1.3",
+      "resolved": "https://registry.npmjs.org/minipass/-/minipass-7.1.3.tgz",
+      "integrity": "sha512-tEBHqDnIoM/1rXME1zgka9g6Q2lcoCkxHLuc7ODJ5BxbP5d4c2Z5cGgtXAku59200Cx7diuHTOYfSBD8n6mm8A==",
+      "dev": true,
+      "license": "BlueOak-1.0.0",
+      "engines": {
+        "node": ">=16 || 14 >=14.17"
+      }
+    },
+    "node_modules/mkdirp-classic": {
+      "version": "0.5.3",
+      "resolved": "https://registry.npmjs.org/mkdirp-classic/-/mkdirp-classic-0.5.3.tgz",
+      "integrity": "sha512-gKLcREMhtuZRwRAfqP3RFW+TK4JqApVBtOIftVgjuABpAtpxhPGaDcfvbhNvD0B8iD1oUr/txX35NjcaY6Ns/A==",
+      "license": "MIT",
+      "optional": true
+    },
+    "node_modules/mlly": {
+      "version": "1.8.2",
+      "resolved": "https://registry.npmjs.org/mlly/-/mlly-1.8.2.tgz",
+      "integrity": "sha512-d+ObxMQFmbt10sretNDytwt85VrbkhhUA/JBGm1MPaWJ65Cl4wOgLaB1NYvJSZ0Ef03MMEU/0xpPMXUIQ29UfA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "acorn": "^8.16.0",
+        "pathe": "^2.0.3",
+        "pkg-types": "^1.3.1",
+        "ufo": "^1.6.3"
+      }
+    },
+    "node_modules/mrmime": {
+      "version": "2.0.1",
+      "resolved": "https://registry.npmjs.org/mrmime/-/mrmime-2.0.1.tgz",
+      "integrity": "sha512-Y3wQdFg2Va6etvQ5I82yUhGdsKrcYox6p7FfL1LbK2J4V01F9TGlepTIhnK24t7koZibmg82KGglhA1XK5IsLQ==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=10"
+      }
+    },
+    "node_modules/ms": {
+      "version": "2.1.3",
+      "resolved": "https://registry.npmjs.org/ms/-/ms-2.1.3.tgz",
+      "integrity": "sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA==",
+      "devOptional": true,
+      "license": "MIT"
+    },
+    "node_modules/muggle-string": {
+      "version": "0.4.1",
+      "resolved": "https://registry.npmjs.org/muggle-string/-/muggle-string-0.4.1.tgz",
+      "integrity": "sha512-VNTrAak/KhO2i8dqqnqnAHOa3cYBwXEZe9h+D5h/1ZqFSTEFHdM65lR7RoIqq3tBBYavsOXV84NoHXZ0AkPyqQ==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/mustache": {
+      "version": "4.2.0",
+      "resolved": "https://registry.npmjs.org/mustache/-/mustache-4.2.0.tgz",
+      "integrity": "sha512-71ippSywq5Yb7/tVYyGbkBggbU8H3u5Rz56fH60jGFgr8uHwxs+aSKeqmluIVzM0m0kB7xQjKS6qPfd0b2ZoqQ==",
+      "license": "MIT",
+      "bin": {
+        "mustache": "bin/mustache"
+      }
+    },
+    "node_modules/naive-ui": {
+      "version": "2.44.1",
+      "resolved": "https://registry.npmjs.org/naive-ui/-/naive-ui-2.44.1.tgz",
+      "integrity": "sha512-reo8Esw0p58liZwbUutC7meW24Xbn3EwNv91zReWKm2W4JPu+zfgJRn/F7aO0BFmvN+h2brA2M5lRvYqLq4kuA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@css-render/plugin-bem": "^0.15.14",
+        "@css-render/vue3-ssr": "^0.15.14",
+        "@types/lodash": "^4.17.20",
+        "@types/lodash-es": "^4.17.12",
+        "async-validator": "^4.2.5",
+        "css-render": "^0.15.14",
+        "csstype": "^3.1.3",
+        "date-fns": "^4.1.0",
+        "date-fns-tz": "^3.2.0",
+        "evtd": "^0.2.4",
+        "highlight.js": "^11.8.0",
+        "lodash": "^4.17.21",
+        "lodash-es": "^4.17.21",
+        "seemly": "^0.3.10",
+        "treemate": "^0.3.11",
+        "vdirs": "^0.1.8",
+        "vooks": "^0.2.12",
+        "vueuc": "^0.4.65"
+      },
+      "engines": {
+        "node": ">=20"
+      },
+      "peerDependencies": {
+        "vue": "^3.0.0"
+      }
+    },
+    "node_modules/nanoid": {
+      "version": "3.3.18",
+      "resolved": "https://registry.npmjs.org/nanoid/-/nanoid-3.3.18.tgz",
+      "integrity": "sha512-DTg4MJbGMWkfi6VZFdNt2/caMbQy4Ou+Op/hJQvGEWcnVfoA1QA+xzRKAzw9jD6+GVOOeYr/mIcuDSdug6F6+w==",
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/ai"
+        }
+      ],
+      "license": "MIT",
+      "bin": {
+        "nanoid": "bin/nanoid.cjs"
+      },
+      "engines": {
+        "node": "^10 || ^12 || ^13.7 || ^14 || >=15.0.1"
+      }
+    },
+    "node_modules/napi-build-utils": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/napi-build-utils/-/napi-build-utils-2.0.0.tgz",
+      "integrity": "sha512-GEbrYkbfF7MoNaoh2iGG84Mnf/WZfB0GdGEsM8wz7Expx/LlWf5U8t9nvJKXSp3qr5IsEbK04cBGhol/KwOsWA==",
+      "license": "MIT",
+      "optional": true
+    },
+    "node_modules/node-abi": {
+      "version": "3.94.0",
+      "resolved": "https://registry.npmjs.org/node-abi/-/node-abi-3.94.0.tgz",
+      "integrity": "sha512-W5ZNO5KRPB5TkYmGVD9F6YqhsglXJzE6etpbmT+f6EQElhiX/UTG551cnsRGvLG3fyZEg9HwaDmNmj5nwJ4z9g==",
+      "license": "MIT",
+      "optional": true,
+      "dependencies": {
+        "semver": "^7.3.5"
+      },
+      "engines": {
+        "node": ">=10"
+      }
+    },
+    "node_modules/node-addon-api": {
+      "version": "7.1.1",
+      "resolved": "https://registry.npmjs.org/node-addon-api/-/node-addon-api-7.1.1.tgz",
+      "integrity": "sha512-5m3bsyrjFWE1xf7nz7YXdN4udnVtXK6/Yfgn5qnahL6bCkf2yKt4k3nuTKAtT4r3IG8JNR2ncsIMdZuAzJjHQQ==",
+      "license": "MIT",
+      "optional": true
+    },
+    "node_modules/node-fetch-native": {
+      "version": "1.6.7",
+      "resolved": "https://registry.npmjs.org/node-fetch-native/-/node-fetch-native-1.6.7.tgz",
+      "integrity": "sha512-g9yhqoedzIUm0nTnTqAQvueMPVOuIY16bqgAJJC8XOOubYFNwz6IER9qs0Gq2Xd0+CecCKFjtdDTMA4u4xG06Q==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/node-releases": {
+      "version": "2.0.53",
+      "resolved": "https://registry.npmjs.org/node-releases/-/node-releases-2.0.53.tgz",
+      "integrity": "sha512-D9UOmYG3UH1V+ENW56t5QXBwJw1YEY18ruVeus89Rw+SyIgjPkCO84bRzO3uNIYosJbNwiabWVn48o3uJLjxFQ==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/nostics": {
+      "version": "1.2.0",
+      "resolved": "https://registry.npmjs.org/nostics/-/nostics-1.2.0.tgz",
+      "integrity": "sha512-FGqEfhQjrvo1lL8KFifdTQiNwwQHJxC1jtYE1Rc54qF/jxONUNL+kC9gS1krX8Q65PgrQ5fCqH/I4NhWBvdSqg==",
+      "license": "MIT"
+    },
+    "node_modules/npm-normalize-package-bin": {
+      "version": "6.0.0",
+      "resolved": "https://registry.npmjs.org/npm-normalize-package-bin/-/npm-normalize-package-bin-6.0.0.tgz",
+      "integrity": "sha512-tdt4aFn9QamlhdN3HV2D2ccpBwO5/fyjjbXUxYA6uBjyekMZcZvDq0aSj9t5Jo+tih6AYFnt/cuIRn9013e0Uw==",
+      "dev": true,
+      "license": "ISC",
+      "engines": {
+        "node": "^22.22.2 || ^24.15.0 || >=26.0.0"
+      }
+    },
+    "node_modules/npm-run-all2": {
+      "version": "9.0.3",
+      "resolved": "https://registry.npmjs.org/npm-run-all2/-/npm-run-all2-9.0.3.tgz",
+      "integrity": "sha512-BQAEdU1PtYc48qYRdghW2BVTQT3VqWCoFQmO87NlM1h1PYwMCKQpUWaNyB20V26caNzFsXQDfyOdznLlHCih6g==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "ansi-styles": "^7.0.0",
+        "cross-spawn": "^7.0.6",
+        "memorystream": "^0.3.1",
+        "picomatch": "^4.0.2",
+        "pidtree": "^1.0.0",
+        "read-package-json-fast": "^6.0.0",
+        "shell-quote": "^1.8.4",
+        "which": "^7.0.0"
+      },
+      "bin": {
+        "npm-run-all": "bin/npm-run-all/index.js",
+        "npm-run-all2": "bin/npm-run-all/index.js",
+        "run-p": "bin/run-p/index.js",
+        "run-s": "bin/run-s/index.js"
+      },
+      "engines": {
+        "node": "^22.22.2 || ^24.15.0 || >=26.0.0",
+        "npm": ">= 10"
+      }
+    },
+    "node_modules/nwsapi": {
+      "version": "2.2.24",
+      "resolved": "https://registry.npmjs.org/nwsapi/-/nwsapi-2.2.24.tgz",
+      "integrity": "sha512-7YRhZ3jS45LwmSCT4b2sVFHt/WuovaktDU07QrtOBY2PXskss5a9jfmR9jptyumwXST+rFjrmppMY1KT/yn35A==",
+      "license": "MIT",
+      "optional": true
+    },
+    "node_modules/obug": {
+      "version": "2.1.4",
+      "resolved": "https://registry.npmjs.org/obug/-/obug-2.1.4.tgz",
+      "integrity": "sha512-4a+OsYv9UktOJKE+l1A4OufDgdRF9PifWj+tJnHURo/P+WOxpG4GzUFL9qCalmWauao6ogiG+QvnCovwPoyAWA==",
+      "dev": true,
+      "funding": [
+        "https://github.com/sponsors/sxzz",
+        "https://opencollective.com/debug"
+      ],
+      "license": "MIT",
+      "engines": {
+        "node": ">=12.20.0"
+      }
+    },
+    "node_modules/ofetch": {
+      "version": "1.5.1",
+      "resolved": "https://registry.npmjs.org/ofetch/-/ofetch-1.5.1.tgz",
+      "integrity": "sha512-2W4oUZlVaqAPAil6FUg/difl6YhqhUR7x2eZY4bQCko22UXg3hptq9KLQdqFClV+Wu85UX7hNtdGTngi/1BxcA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "destr": "^2.0.5",
+        "node-fetch-native": "^1.6.7",
+        "ufo": "^1.6.1"
+      }
+    },
+    "node_modules/ohash": {
+      "version": "2.0.11",
+      "resolved": "https://registry.npmjs.org/ohash/-/ohash-2.0.11.tgz",
+      "integrity": "sha512-RdR9FQrFwNBNXAr4GixM8YaRZRJ5PUWbKYbE5eOsrwAjJW0q2REGcf79oYPsLyskQCZG1PLN+S/K1V00joZAoQ==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/once": {
+      "version": "1.4.0",
+      "resolved": "https://registry.npmjs.org/once/-/once-1.4.0.tgz",
+      "integrity": "sha512-lNaJgI+2Q5URQBkccEKHTQOPaXdUxnZZElQTZY0MFUAuaEqe1E+Nyvgdz/aIyNi6Z9MzO5dv1H8n58/GELp3+w==",
+      "license": "ISC",
+      "optional": true,
+      "dependencies": {
+        "wrappy": "1"
+      }
+    },
+    "node_modules/open": {
+      "version": "11.0.0",
+      "resolved": "https://registry.npmjs.org/open/-/open-11.0.0.tgz",
+      "integrity": "sha512-smsWv2LzFjP03xmvFoJ331ss6h+jixfA4UUV/Bsiyuu4YJPfN+FIQGOIiv4w9/+MoHkfkJ22UIaQWRVFRfH6Vw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "default-browser": "^5.4.0",
+        "define-lazy-prop": "^3.0.0",
+        "is-in-ssh": "^1.0.0",
+        "is-inside-container": "^1.0.0",
+        "powershell-utils": "^0.1.0",
+        "wsl-utils": "^0.3.0"
+      },
+      "engines": {
+        "node": ">=20"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/opentype.js": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/opentype.js/-/opentype.js-2.0.0.tgz",
+      "integrity": "sha512-kCyjv6xdDY1W/jLWZ/L3QhhTlKUqDZMQ5+Jdlw12b3dXkKNpYBqqlMMj0YDQPShWFTMwgZI1hG14kN3XUDSg/A==",
+      "license": "MIT",
+      "bin": {
+        "ot": "bin/ot"
+      }
+    },
+    "node_modules/orderedmap": {
+      "version": "2.1.1",
+      "resolved": "https://registry.npmjs.org/orderedmap/-/orderedmap-2.1.1.tgz",
+      "integrity": "sha512-TvAWxi0nDe1j/rtMcWcIj94+Ffe6n7zhow33h40SKxmsmozs6dz/e+EajymfoFcHd7sxNn8yHM8839uixMOV6g==",
+      "license": "MIT"
+    },
+    "node_modules/oxc-parser": {
+      "version": "0.131.0",
+      "resolved": "https://registry.npmjs.org/oxc-parser/-/oxc-parser-0.131.0.tgz",
+      "integrity": "sha512-SJ3/7ZPbgie8dr5Z9BI/M51zZbpXba+hRSG0MDzVwMW5CRQg2fjYE0jHGlLX4eeiibGgC/mzoDFKSDHwVZEHRQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@oxc-project/types": "^0.131.0"
+      },
+      "engines": {
+        "node": "^20.19.0 || >=22.12.0"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/Boshen"
+      },
+      "optionalDependencies": {
+        "@oxc-parser/binding-android-arm-eabi": "0.131.0",
+        "@oxc-parser/binding-android-arm64": "0.131.0",
+        "@oxc-parser/binding-darwin-arm64": "0.131.0",
+        "@oxc-parser/binding-darwin-x64": "0.131.0",
+        "@oxc-parser/binding-freebsd-x64": "0.131.0",
+        "@oxc-parser/binding-linux-arm-gnueabihf": "0.131.0",
+        "@oxc-parser/binding-linux-arm-musleabihf": "0.131.0",
+        "@oxc-parser/binding-linux-arm64-gnu": "0.131.0",
+        "@oxc-parser/binding-linux-arm64-musl": "0.131.0",
+        "@oxc-parser/binding-linux-ppc64-gnu": "0.131.0",
+        "@oxc-parser/binding-linux-riscv64-gnu": "0.131.0",
+        "@oxc-parser/binding-linux-riscv64-musl": "0.131.0",
+        "@oxc-parser/binding-linux-s390x-gnu": "0.131.0",
+        "@oxc-parser/binding-linux-x64-gnu": "0.131.0",
+        "@oxc-parser/binding-linux-x64-musl": "0.131.0",
+        "@oxc-parser/binding-openharmony-arm64": "0.131.0",
+        "@oxc-parser/binding-wasm32-wasi": "0.131.0",
+        "@oxc-parser/binding-win32-arm64-msvc": "0.131.0",
+        "@oxc-parser/binding-win32-ia32-msvc": "0.131.0",
+        "@oxc-parser/binding-win32-x64-msvc": "0.131.0"
+      }
+    },
+    "node_modules/oxc-walker": {
+      "version": "0.7.0",
+      "resolved": "https://registry.npmjs.org/oxc-walker/-/oxc-walker-0.7.0.tgz",
+      "integrity": "sha512-54B4KUhrzbzc4sKvKwVYm7E2PgeROpGba0/2nlNZMqfDyca+yOor5IMb4WLGBatGDT0nkzYdYuzylg7n3YfB7A==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "magic-regexp": "^0.10.0"
+      },
+      "peerDependencies": {
+        "oxc-parser": ">=0.98.0"
+      }
+    },
+    "node_modules/p-limit": {
+      "version": "2.3.0",
+      "resolved": "https://registry.npmjs.org/p-limit/-/p-limit-2.3.0.tgz",
+      "integrity": "sha512-//88mFWSJx8lxCzwdAABTJL2MyWB12+eIY7MDL2SqLmAkeKU9qxRvWuSyTjm3FUmpBEMuFfckAIqEaVGUDxb6w==",
+      "license": "MIT",
+      "dependencies": {
+        "p-try": "^2.0.0"
+      },
+      "engines": {
+        "node": ">=6"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/p-locate": {
+      "version": "4.1.0",
+      "resolved": "https://registry.npmjs.org/p-locate/-/p-locate-4.1.0.tgz",
+      "integrity": "sha512-R79ZZ/0wAxKGu3oYMlz8jy/kbhsNrS7SKZ7PxEHBgJ5+F2mtFW2fK2cOtBh1cHYkQsbzFV7I+EoRKe6Yt0oK7A==",
+      "license": "MIT",
+      "dependencies": {
+        "p-limit": "^2.2.0"
+      },
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/p-try": {
+      "version": "2.2.0",
+      "resolved": "https://registry.npmjs.org/p-try/-/p-try-2.2.0.tgz",
+      "integrity": "sha512-R4nPAVTAU0B9D35/Gk3uJf/7XYbQcyohSKdvAxIRSNghFl4e71hVoGnBNQz9cWaXxO2I10KTC+3jMdvvoKw6dQ==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=6"
+      }
+    },
+    "node_modules/package-json-from-dist": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/package-json-from-dist/-/package-json-from-dist-1.0.1.tgz",
+      "integrity": "sha512-UEZIS3/by4OC8vL3P2dTXRETpebLI2NiI5vIrjaD/5UtrkFX/tNbwjTSRAGC/+7CAo2pIcBaRgWmcBBHcsaCIw==",
+      "dev": true,
+      "license": "BlueOak-1.0.0"
+    },
+    "node_modules/package-manager-detector": {
+      "version": "1.8.0",
+      "resolved": "https://registry.npmjs.org/package-manager-detector/-/package-manager-detector-1.8.0.tgz",
+      "integrity": "sha512-yQA4H19AmPEoMUeavPMDIe1higySl/gH/yaQrkT/s07Qp+7pp2hYz30N3z2l5BkjVkF9Ow6o0wjJamm2y7Sn0A==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/pako": {
+      "version": "2.2.0",
+      "resolved": "https://registry.npmjs.org/pako/-/pako-2.2.0.tgz",
+      "integrity": "sha512-zJq6RP/5q+TO2OpFV3FHzlPnFjmkb7Nc99a5SNjJE+uu/PkpChs+NIZSSzbBoD+6kjiISXjfYdwj1ZRQ81dz/w==",
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/puzrin"
+        },
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/nodeca"
+        }
+      ],
+      "license": "(MIT AND Zlib)"
+    },
+    "node_modules/parse5": {
+      "version": "7.3.0",
+      "resolved": "https://registry.npmjs.org/parse5/-/parse5-7.3.0.tgz",
+      "integrity": "sha512-IInvU7fabl34qmi9gY8XOVxhYyMyuH2xUNpb2q8/Y+7552KlejkRvqvD19nMoUW/uQGGbqNpA6Tufu5FL5BZgw==",
+      "license": "MIT",
+      "optional": true,
+      "dependencies": {
+        "entities": "^6.0.0"
+      },
+      "funding": {
+        "url": "https://github.com/inikulin/parse5?sponsor=1"
+      }
+    },
+    "node_modules/parse5/node_modules/entities": {
+      "version": "6.0.1",
+      "resolved": "https://registry.npmjs.org/entities/-/entities-6.0.1.tgz",
+      "integrity": "sha512-aN97NXWF6AWBTahfVOIrB/NShkzi5H7F9r1s9mD3cDj4Ko5f2qhhVoYMibXF7GlLveb/D2ioWay8lxI97Ven3g==",
+      "license": "BSD-2-Clause",
+      "optional": true,
+      "engines": {
+        "node": ">=0.12"
+      },
+      "funding": {
+        "url": "https://github.com/fb55/entities?sponsor=1"
+      }
+    },
+    "node_modules/path-browserify": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/path-browserify/-/path-browserify-1.0.1.tgz",
+      "integrity": "sha512-b7uo2UCUOYZcnF/3ID0lulOJi/bafxa1xPe7ZPsammBSpjSWQkjNxlt635YGS2MiR9GjvuXCtz2emr3jbsz98g==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/path-exists": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/path-exists/-/path-exists-4.0.0.tgz",
+      "integrity": "sha512-ak9Qy5Q7jYb2Wwcey5Fpvg2KoAc/ZIhLSLOSBmRmygPsGwkVVt0fZa0qrtMz+m6tJTAHfZQ8FnmB4MG4LWy7/w==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/path-key": {
+      "version": "3.1.1",
+      "resolved": "https://registry.npmjs.org/path-key/-/path-key-3.1.1.tgz",
+      "integrity": "sha512-ojmeN0qd+y0jszEtoY48r0Peq5dwMEkIlCOu6Q5f41lfkswXuKtYrhgoTpLnyIcHm24Uhqx+5Tqm2InSwLhE6Q==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/path-scurry": {
+      "version": "1.11.1",
+      "resolved": "https://registry.npmjs.org/path-scurry/-/path-scurry-1.11.1.tgz",
+      "integrity": "sha512-Xa4Nw17FS9ApQFJ9umLiJS4orGjm7ZzwUrwamcGQuHSzDyth9boKDaycYdDcZDuqYATXw4HFXgaqWTctW/v1HA==",
+      "dev": true,
+      "license": "BlueOak-1.0.0",
+      "dependencies": {
+        "lru-cache": "^10.2.0",
+        "minipass": "^5.0.0 || ^6.0.2 || ^7.0.0"
+      },
+      "engines": {
+        "node": ">=16 || 14 >=14.18"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/isaacs"
+      }
+    },
+    "node_modules/pathe": {
+      "version": "2.0.3",
+      "resolved": "https://registry.npmjs.org/pathe/-/pathe-2.0.3.tgz",
+      "integrity": "sha512-WUjGcAqP1gQacoQe+OBJsFA7Ld4DyXuUIjZ5cc75cLHvJ7dtNsTugphxIADwspS+AraAUePCKrSVtPLFj/F88w==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/pathval": {
+      "version": "2.0.1",
+      "resolved": "https://registry.npmjs.org/pathval/-/pathval-2.0.1.tgz",
+      "integrity": "sha512-//nshmD55c46FuFw26xV/xFAaB5HF9Xdap7HJBBnrKdAd6/GxDBaNA1870O79+9ueg61cZLSVc+OaFlfmObYVQ==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">= 14.16"
+      }
+    },
+    "node_modules/perfect-debounce": {
+      "version": "2.1.0",
+      "resolved": "https://registry.npmjs.org/perfect-debounce/-/perfect-debounce-2.1.0.tgz",
+      "integrity": "sha512-LjgdTytVFXeUgtHZr9WYViYSM/g8MkcTPYDlPa3cDqMirHjKiSZPYd6DoL7pK8AJQr+uWkQvCjHNdiMqsrJs+g==",
+      "license": "MIT"
+    },
+    "node_modules/performance-now": {
+      "version": "2.1.0",
+      "resolved": "https://registry.npmjs.org/performance-now/-/performance-now-2.1.0.tgz",
+      "integrity": "sha512-7EAHlyLHI56VEIdK57uwHdHKIaAGbnXPiw0yWbarQZOKaKpvUIgW0jWRVLiatnM+XXlSwsanIBH/hzGMJulMow==",
+      "license": "MIT",
+      "optional": true
+    },
+    "node_modules/picocolors": {
+      "version": "1.1.1",
+      "resolved": "https://registry.npmjs.org/picocolors/-/picocolors-1.1.1.tgz",
+      "integrity": "sha512-xceH2snhtb5M9liqDsmEw56le376mTZkEX/jEb/RxNFyegNul7eNslCXP9FDj/Lcu0X8KEyMceP2ntpaHrDEVA==",
+      "license": "ISC"
+    },
+    "node_modules/picomatch": {
+      "version": "4.0.5",
+      "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-4.0.5.tgz",
+      "integrity": "sha512-RvwwcruNjI1ncT5xRakeyS9Lf8lcItv34KD+aif+VH9kduAyfYBipGh12274xtenIPZ119/R9BdTBa8gAwSh0A==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=12"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/jonschlinkert"
+      }
+    },
+    "node_modules/pidtree": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/pidtree/-/pidtree-1.0.0.tgz",
+      "integrity": "sha512-avfAvjB9Dd0wdj3rjJX//yS+G79OO0KrS5pJHFJENjYGX6N4SMgEDBBI/yFy0lloOYSaC6XQxzpOAMPfSYFV/Q==",
+      "dev": true,
+      "license": "MIT",
+      "bin": {
+        "pidtree": "bin/pidtree.js"
+      },
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/pinia": {
+      "version": "4.0.2",
+      "resolved": "https://registry.npmjs.org/pinia/-/pinia-4.0.2.tgz",
+      "integrity": "sha512-yKVVA7bSj5oRZFp/Ab9wLlmyb5gPUYEiIm4ryiWTe/xe7PtkRdMVOp1X1ggvq0c6Uj7Q0Du1HnV2mtAwM0Ks1g==",
+      "license": "MIT",
+      "dependencies": {
+        "nostics": "^1.1.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/posva"
+      },
+      "peerDependencies": {
+        "@vue/devtools-api": "^8.1.5",
+        "typescript": ">=5.6.0",
+        "vue": "^3.5.11"
+      },
+      "peerDependenciesMeta": {
+        "@vue/devtools-api": {
+          "optional": false
+        },
+        "typescript": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/pkg-types": {
+      "version": "1.3.1",
+      "resolved": "https://registry.npmjs.org/pkg-types/-/pkg-types-1.3.1.tgz",
+      "integrity": "sha512-/Jm5M4RvtBFVkKWRu2BLUTNP8/M2a+UwuAX+ae4770q1qVGtfjG+WTCupoZixokjmHiry8uI+dlY8KXYV5HVVQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "confbox": "^0.1.8",
+        "mlly": "^1.7.4",
+        "pathe": "^2.0.1"
+      }
+    },
+    "node_modules/pngjs": {
+      "version": "5.0.0",
+      "resolved": "https://registry.npmjs.org/pngjs/-/pngjs-5.0.0.tgz",
+      "integrity": "sha512-40QW5YalBNfQo5yRYmiw7Yz6TKKVr3h6970B2YE+3fQpsWcrbj1PzJgxeJ19DRQjhMbKPIuMY8rFaXc8moolVw==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=10.13.0"
+      }
+    },
+    "node_modules/postcss": {
+      "version": "8.5.26",
+      "resolved": "https://registry.npmjs.org/postcss/-/postcss-8.5.26.tgz",
+      "integrity": "sha512-u82N74LFzG8ca+dD8puPnplTXoGH4fTPpVGuIbt36G3qvNlkvfD0lEAZSxaly3KX8TS/L1A1gsCEmvKmBcVbkQ==",
+      "funding": [
+        {
+          "type": "opencollective",
+          "url": "https://opencollective.com/postcss/"
+        },
+        {
+          "type": "tidelift",
+          "url": "https://tidelift.com/funding/github/npm/postcss"
+        },
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/ai"
+        }
+      ],
+      "license": "MIT",
+      "dependencies": {
+        "nanoid": "^3.3.17",
+        "picocolors": "^1.1.1",
+        "source-map-js": "^1.2.1"
+      },
+      "engines": {
+        "node": "^10 || ^12 || >=14"
+      }
+    },
+    "node_modules/powershell-utils": {
+      "version": "0.1.0",
+      "resolved": "https://registry.npmjs.org/powershell-utils/-/powershell-utils-0.1.0.tgz",
+      "integrity": "sha512-dM0jVuXJPsDN6DvRpea484tCUaMiXWjuCn++HGTqUWzGDjv5tZkEZldAJ/UMlqRYGFrD/etByo4/xOuC/snX2A==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=20"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/prebuild-install": {
+      "version": "7.1.3",
+      "resolved": "https://registry.npmjs.org/prebuild-install/-/prebuild-install-7.1.3.tgz",
+      "integrity": "sha512-8Mf2cbV7x1cXPUILADGI3wuhfqWvtiLA1iclTDbFRZkgRQS0NqsPZphna9V+HyTEadheuPmjaJMsbzKQFOzLug==",
+      "deprecated": "No longer maintained. Please contact the author of the relevant native addon; alternatives are available.",
+      "license": "MIT",
+      "optional": true,
+      "dependencies": {
+        "detect-libc": "^2.0.0",
+        "expand-template": "^2.0.3",
+        "github-from-package": "0.0.0",
+        "minimist": "^1.2.3",
+        "mkdirp-classic": "^0.5.3",
+        "napi-build-utils": "^2.0.0",
+        "node-abi": "^3.3.0",
+        "pump": "^3.0.0",
+        "rc": "^1.2.7",
+        "simple-get": "^4.0.0",
+        "tar-fs": "^2.0.0",
+        "tunnel-agent": "^0.6.0"
+      },
+      "bin": {
+        "prebuild-install": "bin.js"
+      },
+      "engines": {
+        "node": ">=10"
+      }
+    },
+    "node_modules/prettier": {
+      "version": "3.9.5",
+      "resolved": "https://registry.npmjs.org/prettier/-/prettier-3.9.5.tgz",
+      "integrity": "sha512-/FVl766LpUfB5vXgCYOYa0MeV/441Ia99AeICQIQFTY/Nw0roZwULcXpku5i1/m5kt/baz+s4Zogspd839HSMg==",
+      "dev": true,
+      "license": "MIT",
+      "bin": {
+        "prettier": "bin/prettier.cjs"
+      },
+      "engines": {
+        "node": ">=14"
+      },
+      "funding": {
+        "url": "https://github.com/prettier/prettier?sponsor=1"
+      }
+    },
+    "node_modules/prosemirror-changeset": {
+      "version": "2.4.1",
+      "resolved": "https://registry.npmjs.org/prosemirror-changeset/-/prosemirror-changeset-2.4.1.tgz",
+      "integrity": "sha512-96WBLhOaYhJ+kPhLg3uW359Tz6I/MfcrQfL4EGv4SrcqKEMC1gmoGrXHecPE8eOwTVCJ4IwgfzM8fFad25wNfw==",
+      "license": "MIT",
+      "dependencies": {
+        "prosemirror-transform": "^1.0.0"
+      }
+    },
+    "node_modules/prosemirror-commands": {
+      "version": "1.7.2",
+      "resolved": "https://registry.npmjs.org/prosemirror-commands/-/prosemirror-commands-1.7.2.tgz",
+      "integrity": "sha512-q6Q6szxqdu9Xd6EcdKsqXghu5nQdZTpB4Q9yd04WRc7/jt763e/rT60Owh0L1GYY+T46o5rD+9lEN36dZS43tw==",
+      "license": "MIT",
+      "dependencies": {
+        "prosemirror-model": "^1.0.0",
+        "prosemirror-state": "^1.0.0",
+        "prosemirror-transform": "^1.10.2"
+      }
+    },
+    "node_modules/prosemirror-dropcursor": {
+      "version": "1.8.3",
+      "resolved": "https://registry.npmjs.org/prosemirror-dropcursor/-/prosemirror-dropcursor-1.8.3.tgz",
+      "integrity": "sha512-FoYbsJR8gK+DGlqhNoE29Loa38eIZPzQRIb1VMaDNBoo4OLP6vVof/jR8qFY/6XvUd6Dhug8MDCHl2a/h8RTfQ==",
+      "license": "MIT",
+      "dependencies": {
+        "prosemirror-state": "^1.0.0",
+        "prosemirror-transform": "^1.1.0",
+        "prosemirror-view": "^1.1.0"
+      }
+    },
+    "node_modules/prosemirror-gapcursor": {
+      "version": "1.4.1",
+      "resolved": "https://registry.npmjs.org/prosemirror-gapcursor/-/prosemirror-gapcursor-1.4.1.tgz",
+      "integrity": "sha512-pMdYaEnjNMSwl11yjEGtgTmLkR08m/Vl+Jj443167p9eB3HVQKhYCc4gmHVDsLPODfZfjr/MmirsdyZziXbQKw==",
+      "license": "MIT",
+      "dependencies": {
+        "prosemirror-keymap": "^1.0.0",
+        "prosemirror-model": "^1.0.0",
+        "prosemirror-state": "^1.0.0",
+        "prosemirror-view": "^1.0.0"
+      }
+    },
+    "node_modules/prosemirror-history": {
+      "version": "1.5.0",
+      "resolved": "https://registry.npmjs.org/prosemirror-history/-/prosemirror-history-1.5.0.tgz",
+      "integrity": "sha512-zlzTiH01eKA55UAf1MEjtssJeHnGxO0j4K4Dpx+gnmX9n+SHNlDqI2oO1Kv1iPN5B1dm5fsljCfqKF9nFL6HRg==",
+      "license": "MIT",
+      "dependencies": {
+        "prosemirror-state": "^1.2.2",
+        "prosemirror-transform": "^1.0.0",
+        "prosemirror-view": "^1.31.0",
+        "rope-sequence": "^1.3.0"
+      }
+    },
+    "node_modules/prosemirror-inputrules": {
+      "version": "1.5.1",
+      "resolved": "https://registry.npmjs.org/prosemirror-inputrules/-/prosemirror-inputrules-1.5.1.tgz",
+      "integrity": "sha512-7wj4uMjKaXWAQ1CDgxNzNtR9AlsuwzHfdFH1ygEHA2KHF2DOEaXl1CJfNPAKCg9qNEh4rum975QLaCiQPyY6Fw==",
+      "license": "MIT",
+      "dependencies": {
+        "prosemirror-state": "^1.0.0",
+        "prosemirror-transform": "^1.0.0"
+      }
+    },
+    "node_modules/prosemirror-keymap": {
+      "version": "1.2.3",
+      "resolved": "https://registry.npmjs.org/prosemirror-keymap/-/prosemirror-keymap-1.2.3.tgz",
+      "integrity": "sha512-4HucRlpiLd1IPQQXNqeo81BGtkY8Ai5smHhKW9jjPKRc2wQIxksg7Hl1tTI2IfT2B/LgX6bfYvXxEpJl7aKYKw==",
+      "license": "MIT",
+      "dependencies": {
+        "prosemirror-state": "^1.0.0",
+        "w3c-keyname": "^2.2.0"
+      }
+    },
+    "node_modules/prosemirror-model": {
+      "version": "1.25.11",
+      "resolved": "https://registry.npmjs.org/prosemirror-model/-/prosemirror-model-1.25.11.tgz",
+      "integrity": "sha512-QWg9RhnpLlogAmp3p96uEFrE5txQpFynd4vhBAELkwgOCWQs/X0yCzB3/hrHqiPwf91RG5KyWq6553zs9JqIOQ==",
+      "license": "MIT",
+      "dependencies": {
+        "orderedmap": "^2.0.0"
+      }
+    },
+    "node_modules/prosemirror-schema-list": {
+      "version": "1.5.1",
+      "resolved": "https://registry.npmjs.org/prosemirror-schema-list/-/prosemirror-schema-list-1.5.1.tgz",
+      "integrity": "sha512-927lFx/uwyQaGwJxLWCZRkjXG0p48KpMj6ueoYiu4JX05GGuGcgzAy62dfiV8eFZftgyBUvLx76RsMe20fJl+Q==",
+      "license": "MIT",
+      "dependencies": {
+        "prosemirror-model": "^1.0.0",
+        "prosemirror-state": "^1.0.0",
+        "prosemirror-transform": "^1.7.3"
+      }
+    },
+    "node_modules/prosemirror-state": {
+      "version": "1.4.4",
+      "resolved": "https://registry.npmjs.org/prosemirror-state/-/prosemirror-state-1.4.4.tgz",
+      "integrity": "sha512-6jiYHH2CIGbCfnxdHbXZ12gySFY/fz/ulZE333G6bPqIZ4F+TXo9ifiR86nAHpWnfoNjOb3o5ESi7J8Uz1jXHw==",
+      "license": "MIT",
+      "dependencies": {
+        "prosemirror-model": "^1.0.0",
+        "prosemirror-transform": "^1.0.0",
+        "prosemirror-view": "^1.27.0"
+      }
+    },
+    "node_modules/prosemirror-tables": {
+      "version": "1.8.5",
+      "resolved": "https://registry.npmjs.org/prosemirror-tables/-/prosemirror-tables-1.8.5.tgz",
+      "integrity": "sha512-V/0cDCsHKHe/tfWkeCmthNUcEp1IVO3p6vwN8XtwE9PZQLAZJigbw3QoraAdfJPir4NKJtNvOB8oYGKRl+t0Dw==",
+      "license": "MIT",
+      "dependencies": {
+        "prosemirror-keymap": "^1.2.3",
+        "prosemirror-model": "^1.25.4",
+        "prosemirror-state": "^1.4.4",
+        "prosemirror-transform": "^1.10.5",
+        "prosemirror-view": "^1.41.4"
+      }
+    },
+    "node_modules/prosemirror-transform": {
+      "version": "1.12.0",
+      "resolved": "https://registry.npmjs.org/prosemirror-transform/-/prosemirror-transform-1.12.0.tgz",
+      "integrity": "sha512-GxboyN4AMIsoHNtz5uf2r2Ru551i5hWeCMD6E2Ib4Eogqoub0NflniaBPVQ4MrGE5yZ8JV9tUHg9qcZTTrcN4w==",
+      "license": "MIT",
+      "dependencies": {
+        "prosemirror-model": "^1.21.0"
+      }
+    },
+    "node_modules/prosemirror-view": {
+      "version": "1.42.2",
+      "resolved": "https://registry.npmjs.org/prosemirror-view/-/prosemirror-view-1.42.2.tgz",
+      "integrity": "sha512-Pdg0l5kXm8aLDquFAnQFTCITg0q44sLqBlHlpsVLD9segdOao8TOfQdAhCrCXyVgPSRr6UDDROOIWA3bIrN9YQ==",
+      "license": "MIT",
+      "dependencies": {
+        "prosemirror-model": "^1.25.8",
+        "prosemirror-state": "^1.0.0",
+        "prosemirror-transform": "^1.1.0"
+      }
+    },
+    "node_modules/pump": {
+      "version": "3.0.4",
+      "resolved": "https://registry.npmjs.org/pump/-/pump-3.0.4.tgz",
+      "integrity": "sha512-VS7sjc6KR7e1ukRFhQSY5LM2uBWAUPiOPa/A3mkKmiMwSmRFUITt0xuj+/lesgnCv+dPIEYlkzrcyXgquIHMcA==",
+      "license": "MIT",
+      "optional": true,
+      "dependencies": {
+        "end-of-stream": "^1.1.0",
+        "once": "^1.3.1"
+      }
+    },
+    "node_modules/punycode": {
+      "version": "2.3.1",
+      "resolved": "https://registry.npmjs.org/punycode/-/punycode-2.3.1.tgz",
+      "integrity": "sha512-vYt7UD1U9Wg6138shLtLOvdAu+8DsC/ilFtEVHcH+wydcSpNE20AfSOduf6MkRFahL5FY7X1oU7nKVZFtfq8Fg==",
+      "license": "MIT",
+      "optional": true,
+      "engines": {
+        "node": ">=6"
+      }
+    },
+    "node_modules/qrcode": {
+      "version": "1.5.4",
+      "resolved": "https://registry.npmjs.org/qrcode/-/qrcode-1.5.4.tgz",
+      "integrity": "sha512-1ca71Zgiu6ORjHqFBDpnSMTR2ReToX4l1Au1VFLyVeBTFavzQnv5JxMFr3ukHVKpSrSA2MCk0lNJSykjUfz7Zg==",
+      "license": "MIT",
+      "dependencies": {
+        "dijkstrajs": "^1.0.1",
+        "pngjs": "^5.0.0",
+        "yargs": "^15.3.1"
+      },
+      "bin": {
+        "qrcode": "bin/qrcode"
+      },
+      "engines": {
+        "node": ">=10.13.0"
+      }
+    },
+    "node_modules/quansync": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/quansync/-/quansync-1.0.0.tgz",
+      "integrity": "sha512-5xZacEEufv3HSTPQuchrvV6soaiACMFnq1H8wkVioctoH3TRha9Sz66lOxRwPK/qZj7HPiSveih9yAyh98gvqA==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "individual",
+          "url": "https://github.com/sponsors/antfu"
+        },
+        {
+          "type": "individual",
+          "url": "https://github.com/sponsors/sxzz"
+        }
+      ],
+      "license": "MIT"
+    },
+    "node_modules/raf": {
+      "version": "3.4.1",
+      "resolved": "https://registry.npmjs.org/raf/-/raf-3.4.1.tgz",
+      "integrity": "sha512-Sq4CW4QhwOHE8ucn6J34MqtZCeWFP2aQSmrlroYgqAV1PjStIhJXxYuTgUIfkEk7zTLjmIjLmU5q+fbD1NnOJA==",
+      "license": "MIT",
+      "optional": true,
+      "dependencies": {
+        "performance-now": "^2.1.0"
+      }
+    },
+    "node_modules/rc": {
+      "version": "1.2.8",
+      "resolved": "https://registry.npmjs.org/rc/-/rc-1.2.8.tgz",
+      "integrity": "sha512-y3bGgqKj3QBdxLbLkomlohkvsA8gdAiUQlSBJnBhfn+BPxg4bc62d8TcBW15wavDfgexCgccckhcZvywyQYPOw==",
+      "license": "(BSD-2-Clause OR MIT OR Apache-2.0)",
+      "optional": true,
+      "dependencies": {
+        "deep-extend": "^0.6.0",
+        "ini": "~1.3.0",
+        "minimist": "^1.2.0",
+        "strip-json-comments": "~2.0.1"
+      },
+      "bin": {
+        "rc": "cli.js"
+      }
+    },
+    "node_modules/read-package-json-fast": {
+      "version": "6.0.0",
+      "resolved": "https://registry.npmjs.org/read-package-json-fast/-/read-package-json-fast-6.0.0.tgz",
+      "integrity": "sha512-PNaGjoCnw9DBA2Kl8D+8po957z778q/HOPuY2u3Bkw/JO3eC8MDx7jn/PgMtSgpcBbs+6UOjDbwReGpXmRvs0g==",
+      "dev": true,
+      "license": "ISC",
+      "dependencies": {
+        "json-parse-even-better-errors": "^6.0.0",
+        "npm-normalize-package-bin": "^6.0.0"
+      },
+      "engines": {
+        "node": "^22.22.2 || ^24.15.0 || >=26.0.0"
+      }
+    },
+    "node_modules/readable-stream": {
+      "version": "3.6.2",
+      "resolved": "https://registry.npmjs.org/readable-stream/-/readable-stream-3.6.2.tgz",
+      "integrity": "sha512-9u/sniCrY3D5WdsERHzHE4G2YCXqoG5FTHUiCC4SIbr6XcLZBY05ya9EKjYek9O5xOAwjGq+1JdGBAS7Q9ScoA==",
+      "license": "MIT",
+      "optional": true,
+      "dependencies": {
+        "inherits": "^2.0.3",
+        "string_decoder": "^1.1.1",
+        "util-deprecate": "^1.0.1"
+      },
+      "engines": {
+        "node": ">= 6"
+      }
+    },
+    "node_modules/readdirp": {
+      "version": "5.1.1",
+      "resolved": "https://registry.npmjs.org/readdirp/-/readdirp-5.1.1.tgz",
+      "integrity": "sha512-Kko+Y5XQ6fM+Ce3dq3m9YGxnacYZYl9cA1wZjaF3Vbry2L3i1qVg8+CAgNPsXRArPMUMCaOR7oa9Nqntc43JKA==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">= 20.19.0"
+      },
+      "funding": {
+        "type": "individual",
+        "url": "https://paulmillr.com/funding/"
+      }
+    },
+    "node_modules/regenerator-runtime": {
+      "version": "0.13.11",
+      "resolved": "https://registry.npmjs.org/regenerator-runtime/-/regenerator-runtime-0.13.11.tgz",
+      "integrity": "sha512-kY1AZVr2Ra+t+piVaJ4gxaFaReZVH40AKNo7UCX6W+dEwBo/2oZJzqfuN1qLq1oL45o56cPaTXELwrTh8Fpggg==",
+      "license": "MIT",
+      "optional": true
+    },
+    "node_modules/regexp-tree": {
+      "version": "0.1.27",
+      "resolved": "https://registry.npmjs.org/regexp-tree/-/regexp-tree-0.1.27.tgz",
+      "integrity": "sha512-iETxpjK6YoRWJG5o6hXLwvjYAoW+FEZn9os0PD/b6AP6xQwsa/Y7lCVgIixBbUPMfhu+i2LtdeAqVTgGlQarfA==",
+      "dev": true,
+      "license": "MIT",
+      "bin": {
+        "regexp-tree": "bin/regexp-tree"
+      }
+    },
+    "node_modules/require-directory": {
+      "version": "2.1.1",
+      "resolved": "https://registry.npmjs.org/require-directory/-/require-directory-2.1.1.tgz",
+      "integrity": "sha512-fGxEI7+wsG9xrvdjsrlmL22OMTTiHRwAMroiEeMgq8gzoLC/PQr7RsRDSTLUg/bZAZtF+TVIkHc6/4RIKrui+Q==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/require-from-string": {
+      "version": "2.0.2",
+      "resolved": "https://registry.npmjs.org/require-from-string/-/require-from-string-2.0.2.tgz",
+      "integrity": "sha512-Xf0nWe6RseziFMu+Ap9biiUbmplq6S9/p+7w7YXP/JBHhrUDDUhwa+vANyubuqfZWTveU//DYVGsDG7RKL/vEw==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/require-main-filename": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/require-main-filename/-/require-main-filename-2.0.0.tgz",
+      "integrity": "sha512-NKN5kMDylKuldxYLSUfrbo5Tuzh4hd+2E8NPPX02mZtn1VuREQToYe/ZdlJy+J3uCpfaiGF05e7B8W0iXbQHmg==",
+      "license": "ISC"
+    },
+    "node_modules/rgbcolor": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/rgbcolor/-/rgbcolor-1.0.1.tgz",
+      "integrity": "sha512-9aZLIrhRaD97sgVhtJOW6ckOEh6/GnvQtdVNfdZ6s67+3/XwLS9lBcQYzEEhYVeUowN7pRzMLsyGhK2i/xvWbw==",
+      "license": "MIT OR SEE LICENSE IN FEEL-FREE.md",
+      "optional": true,
+      "engines": {
+        "node": ">= 0.8.15"
+      }
+    },
+    "node_modules/rolldown": {
+      "version": "1.2.3",
+      "resolved": "https://registry.npmjs.org/rolldown/-/rolldown-1.2.3.tgz",
+      "integrity": "sha512-rn9wpmxplLf7NLNyCk9FyWh3FM43DbY8jOzCdEPzH7uflhTftRbCEpqi6Ly2osgoU8OwObtmavMbWLaWy4LX7A==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@oxc-project/types": "=0.143.0",
+        "@rolldown/pluginutils": "^1.0.0"
+      },
+      "bin": {
+        "rolldown": "bin/cli.mjs"
+      },
+      "engines": {
+        "node": "^20.19.0 || >=22.12.0"
+      },
+      "optionalDependencies": {
+        "@rolldown/binding-android-arm64": "1.2.3",
+        "@rolldown/binding-darwin-arm64": "1.2.3",
+        "@rolldown/binding-darwin-x64": "1.2.3",
+        "@rolldown/binding-freebsd-x64": "1.2.3",
+        "@rolldown/binding-linux-arm-gnueabihf": "1.2.3",
+        "@rolldown/binding-linux-arm64-gnu": "1.2.3",
+        "@rolldown/binding-linux-arm64-musl": "1.2.3",
+        "@rolldown/binding-linux-ppc64-gnu": "1.2.3",
+        "@rolldown/binding-linux-s390x-gnu": "1.2.3",
+        "@rolldown/binding-linux-x64-gnu": "1.2.3",
+        "@rolldown/binding-linux-x64-musl": "1.2.3",
+        "@rolldown/binding-openharmony-arm64": "1.2.3",
+        "@rolldown/binding-win32-arm64-msvc": "1.2.3",
+        "@rolldown/binding-win32-x64-msvc": "1.2.3"
+      }
+    },
+    "node_modules/rolldown/node_modules/@oxc-project/types": {
+      "version": "0.143.0",
+      "resolved": "https://registry.npmjs.org/@oxc-project/types/-/types-0.143.0.tgz",
+      "integrity": "sha512-u6JZdLBTLotrNC9Vd6vPssINdzcCzleKAH6EJKImQb7GtYvX5keN2dxkoK44stCc4tffE6QQRtZTXVSzsLUlWA==",
+      "dev": true,
+      "license": "MIT",
+      "funding": {
+        "url": "https://github.com/sponsors/Boshen"
+      }
+    },
+    "node_modules/rollup": {
+      "version": "4.62.4",
+      "resolved": "https://registry.npmjs.org/rollup/-/rollup-4.62.4.tgz",
+      "integrity": "sha512-RXOqwaPsBGjMNMa4sQjDjHieHEZDFoj/Rdr46l2MU5DfEs16wHJPC2RPTPHWhNl+M3aI472LLqFkFKut4SblOg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@types/estree": "1.0.9"
+      },
+      "bin": {
+        "rollup": "dist/bin/rollup"
+      },
+      "engines": {
+        "node": ">=18.0.0",
+        "npm": ">=8.0.0"
+      },
+      "optionalDependencies": {
+        "@napi-rs/lzma-linux-x64-gnu": "1.5.1",
+        "@rollup/rollup-android-arm-eabi": "4.62.4",
+        "@rollup/rollup-android-arm64": "4.62.4",
+        "@rollup/rollup-darwin-arm64": "4.62.4",
+        "@rollup/rollup-darwin-x64": "4.62.4",
+        "@rollup/rollup-freebsd-arm64": "4.62.4",
+        "@rollup/rollup-freebsd-x64": "4.62.4",
+        "@rollup/rollup-linux-arm-gnueabihf": "4.62.4",
+        "@rollup/rollup-linux-arm-musleabihf": "4.62.4",
+        "@rollup/rollup-linux-arm64-gnu": "4.62.4",
+        "@rollup/rollup-linux-arm64-musl": "4.62.4",
+        "@rollup/rollup-linux-loong64-gnu": "4.62.4",
+        "@rollup/rollup-linux-loong64-musl": "4.62.4",
+        "@rollup/rollup-linux-ppc64-gnu": "4.62.4",
+        "@rollup/rollup-linux-ppc64-musl": "4.62.4",
+        "@rollup/rollup-linux-riscv64-gnu": "4.62.4",
+        "@rollup/rollup-linux-riscv64-musl": "4.62.4",
+        "@rollup/rollup-linux-s390x-gnu": "4.62.4",
+        "@rollup/rollup-linux-x64-gnu": "4.62.4",
+        "@rollup/rollup-linux-x64-musl": "4.62.4",
+        "@rollup/rollup-openbsd-x64": "4.62.4",
+        "@rollup/rollup-openharmony-arm64": "4.62.4",
+        "@rollup/rollup-win32-arm64-msvc": "4.62.4",
+        "@rollup/rollup-win32-ia32-msvc": "4.62.4",
+        "@rollup/rollup-win32-x64-gnu": "4.62.4",
+        "@rollup/rollup-win32-x64-msvc": "4.62.4",
+        "fsevents": "~2.3.2"
+      }
+    },
+    "node_modules/rope-sequence": {
+      "version": "1.3.4",
+      "resolved": "https://registry.npmjs.org/rope-sequence/-/rope-sequence-1.3.4.tgz",
+      "integrity": "sha512-UT5EDe2cu2E/6O4igUr5PSFs23nvvukicWHx6GnOPlHAiiYbzNuCRQCuiUdHJQcqKalLKlrYJnjY0ySGsXNQXQ==",
+      "license": "MIT"
+    },
+    "node_modules/rrweb-cssom": {
+      "version": "0.8.0",
+      "resolved": "https://registry.npmjs.org/rrweb-cssom/-/rrweb-cssom-0.8.0.tgz",
+      "integrity": "sha512-guoltQEx+9aMf2gDZ0s62EcV8lsXR+0w8915TC3ITdn2YueuNjdAYh/levpU9nFaoChh9RUS5ZdQMrKfVEN9tw==",
+      "license": "MIT",
+      "optional": true
+    },
+    "node_modules/run-applescript": {
+      "version": "7.1.0",
+      "resolved": "https://registry.npmjs.org/run-applescript/-/run-applescript-7.1.0.tgz",
+      "integrity": "sha512-DPe5pVFaAsinSaV6QjQ6gdiedWDcRCbUuiQfQa2wmWV7+xC9bGulGI8+TdRmoFkAPaBXk8CrAbnlY2ISniJ47Q==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=18"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/safe-buffer": {
+      "version": "5.2.1",
+      "resolved": "https://registry.npmjs.org/safe-buffer/-/safe-buffer-5.2.1.tgz",
+      "integrity": "sha512-rp3So07KcdmmKbGvgaNxQSJr7bGVSVk5S9Eq1F+ppbRo70+YeaDxkw5Dd8NPN+GD6bjnYm2VuPuCXmpuYvmCXQ==",
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/feross"
+        },
+        {
+          "type": "patreon",
+          "url": "https://www.patreon.com/feross"
+        },
+        {
+          "type": "consulting",
+          "url": "https://feross.org/support"
+        }
+      ],
+      "license": "MIT",
+      "optional": true
+    },
+    "node_modules/safer-buffer": {
+      "version": "2.1.2",
+      "resolved": "https://registry.npmjs.org/safer-buffer/-/safer-buffer-2.1.2.tgz",
+      "integrity": "sha512-YZo3K82SD7Riyi0E1EQPojLz7kpepnSQI9IyPbHHg1XXXevb5dJI7tpyN2ADxGcQbHG7vcyRHk0cbwqcQriUtg==",
+      "license": "MIT",
+      "optional": true
+    },
+    "node_modules/saxes": {
+      "version": "6.0.0",
+      "resolved": "https://registry.npmjs.org/saxes/-/saxes-6.0.0.tgz",
+      "integrity": "sha512-xAg7SOnEhrm5zI3puOOKyy1OMcMlIJZYNJY7xLBwSze0UjhPLnWfj2GF2EpT0jmzaJKIWKHLsaSSajf35bcYnA==",
+      "license": "ISC",
+      "optional": true,
+      "dependencies": {
+        "xmlchars": "^2.2.0"
+      },
+      "engines": {
+        "node": ">=v12.22.7"
+      }
+    },
+    "node_modules/seemly": {
+      "version": "0.3.10",
+      "resolved": "https://registry.npmjs.org/seemly/-/seemly-0.3.10.tgz",
+      "integrity": "sha512-2+SMxtG1PcsL0uyhkumlOU6Qo9TAQ/WyH7tthnPIOQB05/12jz9naq6GZ6iZ6ApVsO3rr2gsnTf3++OV63kE1Q==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/semver": {
+      "version": "7.8.5",
+      "resolved": "https://registry.npmjs.org/semver/-/semver-7.8.5.tgz",
+      "integrity": "sha512-Y7/KDsb8LjooZpwaqGyulO6DQlksgCncchHGk+sZIY4SBvUocMBEFH5Ur1fI4dV+Jvl0w6cjvucaIi40puRioA==",
+      "devOptional": true,
+      "license": "ISC",
+      "bin": {
+        "semver": "bin/semver.js"
+      },
+      "engines": {
+        "node": ">=10"
+      }
+    },
+    "node_modules/set-blocking": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/set-blocking/-/set-blocking-2.0.0.tgz",
+      "integrity": "sha512-KiKBS8AnWGEyLzofFfmvKwpdPzqiy16LvQfK3yv/fVH7Bj13/wl3JSR1J+rfgRE9q7xUJK4qvgS8raSOeLUehw==",
+      "license": "ISC"
+    },
+    "node_modules/shebang-command": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/shebang-command/-/shebang-command-2.0.0.tgz",
+      "integrity": "sha512-kHxr2zZpYtdmrN1qDjrrX/Z1rR1kG8Dx+gkpK1G4eXmvXswmcE1hTWBWYUzlraYw1/yZp6YuDY77YtvbN0dmDA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "shebang-regex": "^3.0.0"
+      },
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/shebang-regex": {
+      "version": "3.0.0",
+      "resolved": "https://registry.npmjs.org/shebang-regex/-/shebang-regex-3.0.0.tgz",
+      "integrity": "sha512-7++dFhtcx3353uBaq8DDR4NuxBetBzC7ZQOhmTQInHEd6bSrXdiEyzCvG07Z44UYdLShWUyXt5M/yhz8ekcb1A==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/shell-quote": {
+      "version": "1.10.0",
+      "resolved": "https://registry.npmjs.org/shell-quote/-/shell-quote-1.10.0.tgz",
+      "integrity": "sha512-w1aiOKwKuRgtwAReIIj89puqg+I7GvX4IbLrvmhXbzQsj1+Zwi4VO3+fa6ZF91TWSjIxoEkKnMeHcLEODK5ZXA==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/siginfo": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/siginfo/-/siginfo-2.0.0.tgz",
+      "integrity": "sha512-ybx0WO1/8bSBLEWXZvEd7gMW3Sn3JFlW3TvX1nREbDLRNQNaeNN8WK0meBwPdAaOI7TtRRRJn/Es1zhrrCHu7g==",
+      "dev": true,
+      "license": "ISC"
+    },
+    "node_modules/signal-exit": {
+      "version": "4.1.0",
+      "resolved": "https://registry.npmjs.org/signal-exit/-/signal-exit-4.1.0.tgz",
+      "integrity": "sha512-bzyZ1e88w9O1iNJbKnOlvYTrWPDl46O1bG0D3XInv+9tkPrxrN8jUUTiFlDkkmKWgn1M6CfIA13SuGqOa9Korw==",
+      "dev": true,
+      "license": "ISC",
+      "engines": {
+        "node": ">=14"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/isaacs"
+      }
+    },
+    "node_modules/simple-concat": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/simple-concat/-/simple-concat-1.0.1.tgz",
+      "integrity": "sha512-cSFtAPtRhljv69IK0hTVZQ+OfE9nePi/rtJmw5UjHeVyVroEqJXP1sFztKUy1qU+xvz3u/sfYJLa947b7nAN2Q==",
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/feross"
+        },
+        {
+          "type": "patreon",
+          "url": "https://www.patreon.com/feross"
+        },
+        {
+          "type": "consulting",
+          "url": "https://feross.org/support"
+        }
+      ],
+      "license": "MIT",
+      "optional": true
+    },
+    "node_modules/simple-get": {
+      "version": "4.0.1",
+      "resolved": "https://registry.npmjs.org/simple-get/-/simple-get-4.0.1.tgz",
+      "integrity": "sha512-brv7p5WgH0jmQJr1ZDDfKDOSeWWg+OVypG99A/5vYGPqJ6pxiaHLy8nxtFjBA7oMa01ebA9gfh1uMCFqOuXxvA==",
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/feross"
+        },
+        {
+          "type": "patreon",
+          "url": "https://www.patreon.com/feross"
+        },
+        {
+          "type": "consulting",
+          "url": "https://feross.org/support"
+        }
+      ],
+      "license": "MIT",
+      "optional": true,
+      "dependencies": {
+        "decompress-response": "^6.0.0",
+        "once": "^1.3.1",
+        "simple-concat": "^1.0.0"
+      }
+    },
+    "node_modules/sirv": {
+      "version": "3.0.2",
+      "resolved": "https://registry.npmjs.org/sirv/-/sirv-3.0.2.tgz",
+      "integrity": "sha512-2wcC/oGxHis/BoHkkPwldgiPSYcpZK3JU28WoMVv55yHJgcZ8rlXvuG9iZggz+sU1d4bRgIGASwyWqjxu3FM0g==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@polka/url": "^1.0.0-next.24",
+        "mrmime": "^2.0.0",
+        "totalist": "^3.0.0"
+      },
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/source-map-js": {
+      "version": "1.2.1",
+      "resolved": "https://registry.npmjs.org/source-map-js/-/source-map-js-1.2.1.tgz",
+      "integrity": "sha512-UXWMKhLOwVKb728IUtQPXxfYU+usdybtUrK/8uGE8CQMvrhOpwvzDBwj0QhSL7MQc7vIsISBG8VQ8+IDQxpfQA==",
+      "license": "BSD-3-Clause",
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/specificity": {
+      "version": "0.4.1",
+      "resolved": "https://registry.npmjs.org/specificity/-/specificity-0.4.1.tgz",
+      "integrity": "sha512-1klA3Gi5PD1Wv9Q0wUoOQN1IWAuPu0D1U03ThXTr0cJ20+/iq2tHSDnK7Kk/0LXJ1ztUB2/1Os0wKmfyNgUQfg==",
+      "license": "MIT",
+      "bin": {
+        "specificity": "bin/specificity"
+      }
+    },
+    "node_modules/ssf": {
+      "version": "0.11.2",
+      "resolved": "https://registry.npmjs.org/ssf/-/ssf-0.11.2.tgz",
+      "integrity": "sha512-+idbmIXoYET47hH+d7dfm2epdOMUDjqcB4648sTZ+t2JwoyBFL/insLfB/racrDmsKB3diwsDA696pZMieAC5g==",
+      "license": "Apache-2.0",
+      "dependencies": {
+        "frac": "~1.1.2"
+      },
+      "engines": {
+        "node": ">=0.8"
+      }
+    },
+    "node_modules/stackback": {
+      "version": "0.0.2",
+      "resolved": "https://registry.npmjs.org/stackback/-/stackback-0.0.2.tgz",
+      "integrity": "sha512-1XMJE5fQo1jGH6Y/7ebnwPOBEkIEnT4QF32d5R1+VXdXveM0IBMJt8zfaxX1P3QhVwrYe+576+jkANtSS2mBbw==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/stackblur-canvas": {
+      "version": "2.7.0",
+      "resolved": "https://registry.npmjs.org/stackblur-canvas/-/stackblur-canvas-2.7.0.tgz",
+      "integrity": "sha512-yf7OENo23AGJhBriGx0QivY5JP6Y1HbrrDI6WLt6C5auYZXlQrheoY8hD4ibekFKz1HOfE48Ww8kMWMnJD/zcQ==",
+      "license": "MIT",
+      "optional": true,
+      "engines": {
+        "node": ">=0.1.14"
+      }
+    },
+    "node_modules/std-env": {
+      "version": "3.10.0",
+      "resolved": "https://registry.npmjs.org/std-env/-/std-env-3.10.0.tgz",
+      "integrity": "sha512-5GS12FdOZNliM5mAOxFRg7Ir0pWz8MdpYm6AY6VPkGpbA7ZzmbzNcBJQ0GPvvyWgcY7QAhCgf9Uy89I03faLkg==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/string_decoder": {
+      "version": "1.3.0",
+      "resolved": "https://registry.npmjs.org/string_decoder/-/string_decoder-1.3.0.tgz",
+      "integrity": "sha512-hkRX8U1WjJFd8LsDJ2yQ/wWWxaopEsABU1XfkM8A+j0+85JAGppt16cr1Whg6KIbb4okU6Mql6BOj+uup/wKeA==",
+      "license": "MIT",
+      "optional": true,
+      "dependencies": {
+        "safe-buffer": "~5.2.0"
+      }
+    },
+    "node_modules/string-width": {
+      "version": "5.1.2",
+      "resolved": "https://registry.npmjs.org/string-width/-/string-width-5.1.2.tgz",
+      "integrity": "sha512-HnLOCR3vjcY8beoNLtcjZ5/nxn2afmME6lhrDrebokqMap+XbeW8n9TXpPDOqdGK5qcI3oT0GKTW6wC7EMiVqA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "eastasianwidth": "^0.2.0",
+        "emoji-regex": "^9.2.2",
+        "strip-ansi": "^7.0.1"
+      },
+      "engines": {
+        "node": ">=12"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/string-width-cjs": {
+      "name": "string-width",
+      "version": "4.2.3",
+      "resolved": "https://registry.npmjs.org/string-width/-/string-width-4.2.3.tgz",
+      "integrity": "sha512-wKyQRQpjJ0sIp62ErSZdGsjMJWsap5oRNihHhu6G7JVO/9jIB6UyevL+tXuOqrng8j/cxKTWyWUwvSTriiZz/g==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "emoji-regex": "^8.0.0",
+        "is-fullwidth-code-point": "^3.0.0",
+        "strip-ansi": "^6.0.1"
+      },
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/string-width-cjs/node_modules/ansi-regex": {
+      "version": "5.0.1",
+      "resolved": "https://registry.npmjs.org/ansi-regex/-/ansi-regex-5.0.1.tgz",
+      "integrity": "sha512-quJQXlTSUGL2LH9SUXo8VwsY4soanhgo6LNSm84E1LBcE8s3O0wpdiRzyR9z/ZZJMlMWv37qOOb9pdJlMUEKFQ==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/string-width-cjs/node_modules/emoji-regex": {
+      "version": "8.0.0",
+      "resolved": "https://registry.npmjs.org/emoji-regex/-/emoji-regex-8.0.0.tgz",
+      "integrity": "sha512-MSjYzcWNOA0ewAHpz0MxpYFvwg6yjy1NG3xteoqz644VCo/RPgnr1/GGt+ic3iJTzQ8Eu3TdM14SawnVUmGE6A==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/string-width-cjs/node_modules/strip-ansi": {
+      "version": "6.0.1",
+      "resolved": "https://registry.npmjs.org/strip-ansi/-/strip-ansi-6.0.1.tgz",
+      "integrity": "sha512-Y38VPSHcqkFrCpFnQ9vuSXmquuv5oXOKpGeT6aGrr3o3Gc9AlVa6JBfUSOCnbxGGZF+/0ooI7KrPuUSztUdU5A==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "ansi-regex": "^5.0.1"
+      },
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/strip-ansi": {
+      "version": "7.2.0",
+      "resolved": "https://registry.npmjs.org/strip-ansi/-/strip-ansi-7.2.0.tgz",
+      "integrity": "sha512-yDPMNjp4WyfYBkHnjIRLfca1i6KMyGCtsVgoKe/z1+6vukgaENdgGBZt+ZmKPc4gavvEZ5OgHfHdrazhgNyG7w==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "ansi-regex": "^6.2.2"
+      },
+      "engines": {
+        "node": ">=12"
+      },
+      "funding": {
+        "url": "https://github.com/chalk/strip-ansi?sponsor=1"
+      }
+    },
+    "node_modules/strip-ansi-cjs": {
+      "name": "strip-ansi",
+      "version": "6.0.1",
+      "resolved": "https://registry.npmjs.org/strip-ansi/-/strip-ansi-6.0.1.tgz",
+      "integrity": "sha512-Y38VPSHcqkFrCpFnQ9vuSXmquuv5oXOKpGeT6aGrr3o3Gc9AlVa6JBfUSOCnbxGGZF+/0ooI7KrPuUSztUdU5A==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "ansi-regex": "^5.0.1"
+      },
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/strip-ansi-cjs/node_modules/ansi-regex": {
+      "version": "5.0.1",
+      "resolved": "https://registry.npmjs.org/ansi-regex/-/ansi-regex-5.0.1.tgz",
+      "integrity": "sha512-quJQXlTSUGL2LH9SUXo8VwsY4soanhgo6LNSm84E1LBcE8s3O0wpdiRzyR9z/ZZJMlMWv37qOOb9pdJlMUEKFQ==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/strip-json-comments": {
+      "version": "2.0.1",
+      "resolved": "https://registry.npmjs.org/strip-json-comments/-/strip-json-comments-2.0.1.tgz",
+      "integrity": "sha512-4gB8na07fecVVkOI6Rs4e7T6NOTki5EmL7TUduTs6bu3EdnSycntVJ4re8kgZA+wx9IueI2Y11bfbgwtzuE0KQ==",
+      "license": "MIT",
+      "optional": true,
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/strip-literal": {
+      "version": "3.1.0",
+      "resolved": "https://registry.npmjs.org/strip-literal/-/strip-literal-3.1.0.tgz",
+      "integrity": "sha512-8r3mkIM/2+PpjHoOtiAW8Rg3jJLHaV7xPwG+YRGrv6FP0wwk/toTpATxWYOW0BKdWwl82VT2tFYi5DlROa0Mxg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "js-tokens": "^9.0.1"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/antfu"
+      }
+    },
+    "node_modules/strip-literal/node_modules/js-tokens": {
+      "version": "9.0.1",
+      "resolved": "https://registry.npmjs.org/js-tokens/-/js-tokens-9.0.1.tgz",
+      "integrity": "sha512-mxa9E9ITFOt0ban3j6L5MpjwegGz6lBQmM1IJkWeBZGcMxto50+eWdjC/52xDbS2vy0k7vIMK0Fe2wfL9OQSpQ==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/style-mod": {
+      "version": "4.1.3",
+      "resolved": "https://registry.npmjs.org/style-mod/-/style-mod-4.1.3.tgz",
+      "integrity": "sha512-i/n8VsZydrugj3Iuzll8+x/00GH2vnYsk1eomD8QiRrSAeW6ItbCQDtfXCeJHd0iwiNagqjQkvpvREEPtW3IoQ==",
+      "license": "MIT"
+    },
+    "node_modules/stylis": {
+      "version": "4.4.0",
+      "resolved": "https://registry.npmjs.org/stylis/-/stylis-4.4.0.tgz",
+      "integrity": "sha512-5Z9ZpRzfuH6l/UAvCPAPUo3665Nk2wLaZU3x+TLHKVzIz33+sbJqbtrYoC3KD4/uVOr2Zp+L0LySezP9OHV9yA==",
+      "license": "MIT"
+    },
+    "node_modules/supports-color": {
+      "version": "7.2.0",
+      "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-7.2.0.tgz",
+      "integrity": "sha512-qpCAvRl9stuOHveKsn7HncJRvv501qIacKzQlO/+Lwxc9+0q2wLyv4Dfvt80/DPn2pqOBsJdDiogXGR9+OvwRw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "has-flag": "^4.0.0"
+      },
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/svg-pathdata": {
+      "version": "6.0.3",
+      "resolved": "https://registry.npmjs.org/svg-pathdata/-/svg-pathdata-6.0.3.tgz",
+      "integrity": "sha512-qsjeeq5YjBZ5eMdFuUa4ZosMLxgr5RZ+F+Y1OrDhuOCEInRMA3x74XdBtggJcj9kOeInz0WE+LgCPDkZFlBYJw==",
+      "license": "MIT",
+      "optional": true,
+      "engines": {
+        "node": ">=12.0.0"
+      }
+    },
+    "node_modules/svg2pdf.js": {
+      "version": "2.7.0",
+      "resolved": "https://registry.npmjs.org/svg2pdf.js/-/svg2pdf.js-2.7.0.tgz",
+      "integrity": "sha512-nXK4Wx28H0KtOktanm5nsphl1KMEoLNMelAT/776qxPAj9DshwYcqgdpKuBnY1nrcYOriQFHVQLE4tIag+aDJA==",
+      "license": "MIT",
+      "dependencies": {
+        "cssesc": "^3.0.0",
+        "font-family-papandreou": "^0.2.0-patch1",
+        "specificity": "^0.4.1",
+        "svgpath": "^2.3.0"
+      },
+      "peerDependencies": {
+        "jspdf": "^4.0.0 || ^3.0.0 || ^2.0.0"
+      }
+    },
+    "node_modules/svgpath": {
+      "version": "2.6.0",
+      "resolved": "https://registry.npmjs.org/svgpath/-/svgpath-2.6.0.tgz",
+      "integrity": "sha512-OIWR6bKzXvdXYyO4DK/UWa1VA1JeKq8E+0ug2DG98Y/vOmMpfZNj+TIG988HjfYSqtcy/hFOtZq/n/j5GSESNg==",
+      "license": "MIT",
+      "funding": {
+        "url": "https://github.com/fontello/svg2ttf?sponsor=1"
+      }
+    },
+    "node_modules/symbol-tree": {
+      "version": "3.2.4",
+      "resolved": "https://registry.npmjs.org/symbol-tree/-/symbol-tree-3.2.4.tgz",
+      "integrity": "sha512-9QNk5KwDF+Bvz+PyObkmSYjI5ksVUYtjW7AU22r2NKcfLJcXp96hkDWU3+XndOsUb+AQ9QhfzfCT2O+CNWT5Tw==",
+      "license": "MIT",
+      "optional": true
+    },
+    "node_modules/tar-fs": {
+      "version": "2.1.5",
+      "resolved": "https://registry.npmjs.org/tar-fs/-/tar-fs-2.1.5.tgz",
+      "integrity": "sha512-OboTd8mmMhZDNPV+UjQcK9yKAatXu2aJ+r1w4im1Otd4M4fl2hwvdoXUxIYHFTHWK/3y3FarBP70v3vwmGlOxw==",
+      "license": "MIT",
+      "optional": true,
+      "dependencies": {
+        "chownr": "^1.1.1",
+        "mkdirp-classic": "^0.5.2",
+        "pump": "^3.0.0",
+        "tar-stream": "^2.1.4"
+      }
+    },
+    "node_modules/tar-stream": {
+      "version": "2.2.0",
+      "resolved": "https://registry.npmjs.org/tar-stream/-/tar-stream-2.2.0.tgz",
+      "integrity": "sha512-ujeqbceABgwMZxEJnk2HDY2DlnUZ+9oEcb1KzTVfYHio0UE6dG71n60d8D2I4qNvleWrrXpmjpt7vZeF1LnMZQ==",
+      "license": "MIT",
+      "optional": true,
+      "dependencies": {
+        "bl": "^4.0.3",
+        "end-of-stream": "^1.4.1",
+        "fs-constants": "^1.0.0",
+        "inherits": "^2.0.3",
+        "readable-stream": "^3.1.1"
+      },
+      "engines": {
+        "node": ">=6"
+      }
+    },
+    "node_modules/test-exclude": {
+      "version": "7.0.2",
+      "resolved": "https://registry.npmjs.org/test-exclude/-/test-exclude-7.0.2.tgz",
+      "integrity": "sha512-u9E6A+ZDYdp7a4WnarkXPZOx8Ilz46+kby6p1yZ8zsGTz9gYa6FIS7lj2oezzNKmtdyyJNNmmXDppga5GB7kSw==",
+      "dev": true,
+      "license": "ISC",
+      "dependencies": {
+        "@istanbuljs/schema": "^0.1.2",
+        "glob": "^10.4.1",
+        "minimatch": "^10.2.2"
+      },
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/text-segmentation": {
+      "version": "1.0.3",
+      "resolved": "https://registry.npmjs.org/text-segmentation/-/text-segmentation-1.0.3.tgz",
+      "integrity": "sha512-iOiPUo/BGnZ6+54OsWxZidGCsdU8YbE4PSpdPinp7DeMtUJNJBoJ/ouUSTJjHkh1KntHaltHl/gDs2FC4i5+Nw==",
+      "license": "MIT",
+      "optional": true,
+      "dependencies": {
+        "utrie": "^1.0.2"
+      }
+    },
+    "node_modules/tinybench": {
+      "version": "2.9.0",
+      "resolved": "https://registry.npmjs.org/tinybench/-/tinybench-2.9.0.tgz",
+      "integrity": "sha512-0+DUvqWMValLmha6lr4kD8iAMK1HzV0/aKnCtWb9v9641TnP/MFb7Pc2bxoxQjTXAErryXVgUOfv2YqNllqGeg==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/tinyexec": {
+      "version": "1.3.0",
+      "resolved": "https://registry.npmjs.org/tinyexec/-/tinyexec-1.3.0.tgz",
+      "integrity": "sha512-QKAl9m8gWWGHV8jZcPeym6j+XULi6tOf1mT83WYJ4Lk2ytW/uwAWkrP0uFsdoYMdueVJ0qs26wZ+23xeB4ibNQ==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/tinyglobby": {
+      "version": "0.2.17",
+      "resolved": "https://registry.npmjs.org/tinyglobby/-/tinyglobby-0.2.17.tgz",
+      "integrity": "sha512-wXR/dYpcqKmfWpEdZjiKJOwCNFndD0DMnrW/cYjVGttEkBfVgcLFHoNrlj47mjOVic9yyNu65alsgF4NQyTa2g==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "fdir": "^6.5.0",
+        "picomatch": "^4.0.4"
+      },
+      "engines": {
+        "node": ">=12.0.0"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/SuperchupuDev"
+      }
+    },
+    "node_modules/tinypool": {
+      "version": "1.1.1",
+      "resolved": "https://registry.npmjs.org/tinypool/-/tinypool-1.1.1.tgz",
+      "integrity": "sha512-Zba82s87IFq9A9XmjiX5uZA/ARWDrB03OHlq+Vw1fSdt0I+4/Kutwy8BP4Y/y/aORMo61FQ0vIb5j44vSo5Pkg==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": "^18.0.0 || >=20.0.0"
+      }
+    },
+    "node_modules/tinyrainbow": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/tinyrainbow/-/tinyrainbow-2.0.0.tgz",
+      "integrity": "sha512-op4nsTR47R6p0vMUUoYl/a+ljLFVtlfaXkLQmqfLR1qHma1h/ysYk4hEXZ880bf2CYgTskvTa/e196Vd5dDQXw==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=14.0.0"
+      }
+    },
+    "node_modules/tinyspy": {
+      "version": "4.0.4",
+      "resolved": "https://registry.npmjs.org/tinyspy/-/tinyspy-4.0.4.tgz",
+      "integrity": "sha512-azl+t0z7pw/z958Gy9svOTuzqIk6xq+NSheJzn5MMWtWTFywIacg2wUlzKFGtt3cthx0r2SxMK0yzJOR0IES7Q==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=14.0.0"
+      }
+    },
+    "node_modules/tldts": {
+      "version": "6.1.86",
+      "resolved": "https://registry.npmjs.org/tldts/-/tldts-6.1.86.tgz",
+      "integrity": "sha512-WMi/OQ2axVTf/ykqCQgXiIct+mSQDFdH2fkwhPwgEwvJ1kSzZRiinb0zF2Xb8u4+OqPChmyI6MEu4EezNJz+FQ==",
+      "license": "MIT",
+      "optional": true,
+      "dependencies": {
+        "tldts-core": "^6.1.86"
+      },
+      "bin": {
+        "tldts": "bin/cli.js"
+      }
+    },
+    "node_modules/tldts-core": {
+      "version": "6.1.86",
+      "resolved": "https://registry.npmjs.org/tldts-core/-/tldts-core-6.1.86.tgz",
+      "integrity": "sha512-Je6p7pkk+KMzMv2XXKmAE3McmolOQFdxkKw0R8EYNr7sELW46JqnNeTX8ybPiQgvg1ymCoF8LXs5fzFaZvJPTA==",
+      "license": "MIT",
+      "optional": true
+    },
+    "node_modules/totalist": {
+      "version": "3.0.1",
+      "resolved": "https://registry.npmjs.org/totalist/-/totalist-3.0.1.tgz",
+      "integrity": "sha512-sf4i37nQ2LBx4m3wB74y+ubopq6W/dIzXg0FDGjsYnZHVa1Da8FH853wlL2gtUhg+xJXjfk3kUZS3BRoQeoQBQ==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=6"
+      }
+    },
+    "node_modules/tough-cookie": {
+      "version": "5.1.2",
+      "resolved": "https://registry.npmjs.org/tough-cookie/-/tough-cookie-5.1.2.tgz",
+      "integrity": "sha512-FVDYdxtnj0G6Qm/DhNPSb8Ju59ULcup3tuJxkFb5K8Bv2pUXILbf0xZWU8PX8Ov19OXljbUyveOFwRMwkXzO+A==",
+      "license": "BSD-3-Clause",
+      "optional": true,
+      "dependencies": {
+        "tldts": "^6.1.32"
+      },
+      "engines": {
+        "node": ">=16"
+      }
+    },
+    "node_modules/tr46": {
+      "version": "5.1.1",
+      "resolved": "https://registry.npmjs.org/tr46/-/tr46-5.1.1.tgz",
+      "integrity": "sha512-hdF5ZgjTqgAntKkklYw0R03MG2x/bSzTtkxmIRw/sTNV8YXsCJ1tfLAX23lhxhHJlEf3CRCOCGGWw3vI3GaSPw==",
+      "license": "MIT",
+      "optional": true,
+      "dependencies": {
+        "punycode": "^2.3.1"
+      },
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/treemate": {
+      "version": "0.3.11",
+      "resolved": "https://registry.npmjs.org/treemate/-/treemate-0.3.11.tgz",
+      "integrity": "sha512-M8RGFoKtZ8dF+iwJfAJTOH/SM4KluKOKRJpjCMhI8bG3qB74zrFoArKZ62ll0Fr3mqkMJiQOmWYkdYgDeITYQg==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/ts-algebra": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/ts-algebra/-/ts-algebra-2.0.0.tgz",
+      "integrity": "sha512-FPAhNPFMrkwz76P7cdjdmiShwMynZYN6SgOujD1urY4oNm80Ou9oMdmbR45LotcKOXoy7wSmHkRFE6Mxbrhefw==",
+      "license": "MIT"
+    },
+    "node_modules/tslib": {
+      "version": "2.8.1",
+      "resolved": "https://registry.npmjs.org/tslib/-/tslib-2.8.1.tgz",
+      "integrity": "sha512-oJFu94HQb+KVduSUQL7wnpmqnfmLsOA/nAh6b6EH0wCEoK0/mPeXU6c3wKDV83MkOuHPRHtSXKKU99IBazS/2w==",
+      "dev": true,
+      "license": "0BSD",
+      "optional": true
+    },
+    "node_modules/tunnel-agent": {
+      "version": "0.6.0",
+      "resolved": "https://registry.npmjs.org/tunnel-agent/-/tunnel-agent-0.6.0.tgz",
+      "integrity": "sha512-McnNiV1l8RYeY8tBgEpuodCC1mLUdbSN+CYBL7kJsJNInOP8UjDDEwdk6Mw60vdLLrr5NHKZhMAOSrR2NZuQ+w==",
+      "license": "Apache-2.0",
+      "optional": true,
+      "dependencies": {
+        "safe-buffer": "^5.0.1"
+      },
+      "engines": {
+        "node": "*"
+      }
+    },
+    "node_modules/type-level-regexp": {
+      "version": "0.1.17",
+      "resolved": "https://registry.npmjs.org/type-level-regexp/-/type-level-regexp-0.1.17.tgz",
+      "integrity": "sha512-wTk4DH3cxwk196uGLK/E9pE45aLfeKJacKmcEgEOA/q5dnPGNxXt0cfYdFxb57L+sEpf1oJH4Dnx/pnRcku9jg==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/typescript": {
+      "version": "6.0.3",
+      "resolved": "https://registry.npmjs.org/typescript/-/typescript-6.0.3.tgz",
+      "integrity": "sha512-y2TvuxSZPDyQakkFRPZHKFm+KKVqIisdg9/CZwm9ftvKXLP8NRWj38/ODjNbr43SsoXqNuAisEf1GdCxqWcdBw==",
+      "devOptional": true,
+      "license": "Apache-2.0",
+      "bin": {
+        "tsc": "bin/tsc",
+        "tsserver": "bin/tsserver"
+      },
+      "engines": {
+        "node": ">=14.17"
+      }
+    },
+    "node_modules/ufo": {
+      "version": "1.6.4",
+      "resolved": "https://registry.npmjs.org/ufo/-/ufo-1.6.4.tgz",
+      "integrity": "sha512-JFNbkD1Svwe0KvGi8GOeLcP4kAWQ609twvCdcHxq1oSL8svv39ZuSvajcD8B+5D0eL4+s1Is2D/O6KN3qcTeRA==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/unconfig": {
+      "version": "7.5.0",
+      "resolved": "https://registry.npmjs.org/unconfig/-/unconfig-7.5.0.tgz",
+      "integrity": "sha512-oi8Qy2JV4D3UQ0PsopR28CzdQ3S/5A1zwsUwp/rosSbfhJ5z7b90bIyTwi/F7hCLD4SGcZVjDzd4XoUQcEanvA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@quansync/fs": "^1.0.0",
+        "defu": "^6.1.4",
+        "jiti": "^2.6.1",
+        "quansync": "^1.0.0",
+        "unconfig-core": "7.5.0"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/antfu"
+      }
+    },
+    "node_modules/unconfig-core": {
+      "version": "7.5.0",
+      "resolved": "https://registry.npmjs.org/unconfig-core/-/unconfig-core-7.5.0.tgz",
+      "integrity": "sha512-Su3FauozOGP44ZmKdHy2oE6LPjk51M/TRRjHv2HNCWiDvfvCoxC2lno6jevMA91MYAdCdwP05QnWdWpSbncX/w==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@quansync/fs": "^1.0.0",
+        "quansync": "^1.0.0"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/antfu"
+      }
+    },
+    "node_modules/undici-types": {
+      "version": "7.18.2",
+      "resolved": "https://registry.npmjs.org/undici-types/-/undici-types-7.18.2.tgz",
+      "integrity": "sha512-AsuCzffGHJybSaRrmr5eHr81mwJU3kjw6M+uprWvCXiNeN9SOGwQ3Jn8jb8m3Z6izVgknn1R0FTCEAP2QrLY/w==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/unocss": {
+      "version": "66.7.5",
+      "resolved": "https://registry.npmjs.org/unocss/-/unocss-66.7.5.tgz",
+      "integrity": "sha512-nAdmU8TwnQoiLnQjZ6Hm1GmHy9lTexKsAZNEJtZnxN9wyFRc1eLjQgmh9r7UEGxBQMQLD8OZOgmk5HpwObbh0Q==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@unocss/cli": "66.7.5",
+        "@unocss/core": "66.7.5",
+        "@unocss/preset-attributify": "66.7.5",
+        "@unocss/preset-icons": "66.7.5",
+        "@unocss/preset-mini": "66.7.5",
+        "@unocss/preset-tagify": "66.7.5",
+        "@unocss/preset-typography": "66.7.5",
+        "@unocss/preset-uno": "66.7.5",
+        "@unocss/preset-web-fonts": "66.7.5",
+        "@unocss/preset-wind": "66.7.5",
+        "@unocss/preset-wind3": "66.7.5",
+        "@unocss/preset-wind4": "66.7.5",
+        "@unocss/transformer-attributify-jsx": "66.7.5",
+        "@unocss/transformer-compile-class": "66.7.5",
+        "@unocss/transformer-directives": "66.7.5",
+        "@unocss/transformer-variant-group": "66.7.5",
+        "@unocss/vite": "66.7.5"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/antfu"
+      },
+      "peerDependencies": {
+        "@unocss/astro": "66.7.5",
+        "@unocss/postcss": "66.7.5",
+        "@unocss/webpack": "66.7.5"
+      },
+      "peerDependenciesMeta": {
+        "@unocss/astro": {
+          "optional": true
+        },
+        "@unocss/postcss": {
+          "optional": true
+        },
+        "@unocss/webpack": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/unplugin": {
+      "version": "2.3.11",
+      "resolved": "https://registry.npmjs.org/unplugin/-/unplugin-2.3.11.tgz",
+      "integrity": "sha512-5uKD0nqiYVzlmCRs01Fhs2BdkEgBS3SAVP6ndrBsuK42iC2+JHyxM05Rm9G8+5mkmRtzMZGY8Ct5+mliZxU/Ww==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@jridgewell/remapping": "^2.3.5",
+        "acorn": "^8.15.0",
+        "picomatch": "^4.0.3",
+        "webpack-virtual-modules": "^0.6.2"
+      },
+      "engines": {
+        "node": ">=18.12.0"
+      }
+    },
+    "node_modules/unplugin-utils": {
+      "version": "0.3.2",
+      "resolved": "https://registry.npmjs.org/unplugin-utils/-/unplugin-utils-0.3.2.tgz",
+      "integrity": "sha512-xVToRh2CTmLk2HnEG7ac4rl1MJTT3RFkpS8B++/SnB0kXvuaavD+n3m/vrzyWQOdJNSZQACnbz01pnppbwV5BA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "pathe": "^2.0.3",
+        "picomatch": "^4.0.4"
+      },
+      "engines": {
+        "node": ">=20.19.0"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sxzz"
+      }
+    },
+    "node_modules/update-browserslist-db": {
+      "version": "1.3.0",
+      "resolved": "https://registry.npmjs.org/update-browserslist-db/-/update-browserslist-db-1.3.0.tgz",
+      "integrity": "sha512-x/M6q3w4Ybp91CNaS4S69UnliqR3BzRpOT6LWbksjth0S/+jhfaPJsWjt/TewpT8j9eLIojUf5jr29WextHroA==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "opencollective",
+          "url": "https://opencollective.com/browserslist"
+        },
+        {
+          "type": "tidelift",
+          "url": "https://tidelift.com/funding/github/npm/browserslist"
+        },
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/ai"
+        }
+      ],
+      "license": "MIT",
+      "dependencies": {
+        "escalade": "^3.2.0",
+        "picocolors": "^1.1.1"
+      },
+      "bin": {
+        "update-browserslist-db": "cli.js"
+      },
+      "peerDependencies": {
+        "browserslist": ">= 4.21.0"
+      }
+    },
+    "node_modules/util-deprecate": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/util-deprecate/-/util-deprecate-1.0.2.tgz",
+      "integrity": "sha512-EPD5q1uXyFxJpCrLnCc1nHnq3gOa6DZBocAIiI2TaSCA7VCJ1UJDMagCzIkXNsUYfD1daK//LTEQ8xiIbrHtcw==",
+      "license": "MIT",
+      "optional": true
+    },
+    "node_modules/utrie": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/utrie/-/utrie-1.0.2.tgz",
+      "integrity": "sha512-1MLa5ouZiOmQzUbjbu9VmjLzn1QLXBhwpUa7kdLUQK+KQ5KA9I1vk5U4YHe/X2Ch7PYnJfWuWT+VbuxbGwljhw==",
+      "license": "MIT",
+      "optional": true,
+      "dependencies": {
+        "base64-arraybuffer": "^1.0.2"
+      }
+    },
+    "node_modules/vdirs": {
+      "version": "0.1.8",
+      "resolved": "https://registry.npmjs.org/vdirs/-/vdirs-0.1.8.tgz",
+      "integrity": "sha512-H9V1zGRLQZg9b+GdMk8MXDN2Lva0zx72MPahDKc30v+DtwKjfyOSXWRIX4t2mhDubM1H09gPhWeth/BJWPHGUw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "evtd": "^0.2.2"
+      },
+      "peerDependencies": {
+        "vue": "^3.0.11"
+      }
+    },
+    "node_modules/vite": {
+      "version": "8.2.1",
+      "resolved": "https://registry.npmjs.org/vite/-/vite-8.2.1.tgz",
+      "integrity": "sha512-EU/eS7BH3XROHh2YnBefjM6DBKA6ZeMZEYQbj7NLWg5wHYlhB8B/Mayd5XsgWq+NFYccDOTemRpdETWR6Ka/lw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "lightningcss": "^1.33.0",
+        "picomatch": "^4.0.5",
+        "postcss": "^8.5.25",
+        "rolldown": "~1.2.1",
+        "tinyglobby": "^0.2.17"
+      },
+      "bin": {
+        "vite": "bin/vite.js"
+      },
+      "engines": {
+        "node": "^20.19.0 || >=22.12.0"
+      },
+      "funding": {
+        "url": "https://github.com/vitejs/vite?sponsor=1"
+      },
+      "optionalDependencies": {
+        "fsevents": "~2.3.3"
+      },
+      "peerDependencies": {
+        "@types/node": "^20.19.0 || >=22.12.0",
+        "@vitejs/devtools": "^0.4.0",
+        "esbuild": "^0.27.0 || ^0.28.0",
+        "jiti": ">=1.21.0",
+        "less": "^4.0.0",
+        "sass": "^1.70.0",
+        "sass-embedded": "^1.70.0",
+        "stylus": ">=0.54.8",
+        "sugarss": "^5.0.0",
+        "terser": "^5.16.0",
+        "tsx": "^4.8.1",
+        "yaml": "^2.4.2"
+      },
+      "peerDependenciesMeta": {
+        "@types/node": {
+          "optional": true
+        },
+        "@vitejs/devtools": {
+          "optional": true
+        },
+        "esbuild": {
+          "optional": true
+        },
+        "jiti": {
+          "optional": true
+        },
+        "less": {
+          "optional": true
+        },
+        "sass": {
+          "optional": true
+        },
+        "sass-embedded": {
+          "optional": true
+        },
+        "stylus": {
+          "optional": true
+        },
+        "sugarss": {
+          "optional": true
+        },
+        "terser": {
+          "optional": true
+        },
+        "tsx": {
+          "optional": true
+        },
+        "yaml": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/vite-dev-rpc": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/vite-dev-rpc/-/vite-dev-rpc-2.0.0.tgz",
+      "integrity": "sha512-yKwbTwdHKSD2k/aGqyWpPHepo45OQc8lH3/6IfT4ZqeKE26ooKvi4WIEKzqWav8v+9Is8u1k8q54hvOmqASazA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "birpc": "^4.0.0",
+        "vite-hot-client": "^2.2.0"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/antfu"
+      },
+      "peerDependencies": {
+        "vite": "^2.9.0 || ^3.0.0-0 || ^4.0.0-0 || ^5.0.0-0 || ^6.0.1 || ^7.0.0-0 || ^8.0.0"
+      }
+    },
+    "node_modules/vite-dev-rpc/node_modules/birpc": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/birpc/-/birpc-4.0.0.tgz",
+      "integrity": "sha512-LShSxJP0KTmd101b6DRyGBj57LZxSDYWKitQNW/mi8GRMvZb078Uf9+pveax1DrVL89vm7mWe+TovdI/UDOuPw==",
+      "dev": true,
+      "license": "MIT",
+      "funding": {
+        "url": "https://github.com/sponsors/antfu"
+      }
+    },
+    "node_modules/vite-hot-client": {
+      "version": "2.2.0",
+      "resolved": "https://registry.npmjs.org/vite-hot-client/-/vite-hot-client-2.2.0.tgz",
+      "integrity": "sha512-76Zs9zrHbH7M7wqeyooGQKdX+yg0pQ0xuQ1PbFp4z5a0Lzn2e5IPFoCswnmqZ4GiwqB4Jo3WcDAMO9jARTJl8w==",
+      "dev": true,
+      "license": "MIT",
+      "funding": {
+        "url": "https://github.com/sponsors/antfu"
+      },
+      "peerDependencies": {
+        "vite": "^2.6.0 || ^3.0.0 || ^4.0.0 || ^5.0.0-0 || ^6.0.0-0 || ^7.0.0-0 || ^8.0.0"
+      }
+    },
+    "node_modules/vite-node": {
+      "version": "3.2.4",
+      "resolved": "https://registry.npmjs.org/vite-node/-/vite-node-3.2.4.tgz",
+      "integrity": "sha512-EbKSKh+bh1E1IFxeO0pg1n4dvoOTt0UDiXMd/qn++r98+jPO1xtJilvXldeuQ8giIB5IkpjCgMleHMNEsGH6pg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "cac": "^6.7.14",
+        "debug": "^4.4.1",
+        "es-module-lexer": "^1.7.0",
+        "pathe": "^2.0.3",
+        "vite": "^5.0.0 || ^6.0.0 || ^7.0.0-0"
+      },
+      "bin": {
+        "vite-node": "vite-node.mjs"
+      },
+      "engines": {
+        "node": "^18.0.0 || ^20.0.0 || >=22.0.0"
+      },
+      "funding": {
+        "url": "https://opencollective.com/vitest"
+      }
+    },
+    "node_modules/vite-node/node_modules/cac": {
+      "version": "6.7.14",
+      "resolved": "https://registry.npmjs.org/cac/-/cac-6.7.14.tgz",
+      "integrity": "sha512-b6Ilus+c3RrdDk+JhLKUAQfzzgLEPy6wcXqS7f/xe1EETvsDP6GORG7SFuOs6cID5YkqchW/LXZbX5bc8j7ZcQ==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/vite-node/node_modules/vite": {
+      "version": "7.3.6",
+      "resolved": "https://registry.npmjs.org/vite/-/vite-7.3.6.tgz",
+      "integrity": "sha512-4XP60spRGjSZFf1qYH+dJIkK2znL3zQfl9KkOV9MkkRR/3Dls0dxaBsQPTloEc5BLXWPL9vsOxopxyKoMmDueg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "esbuild": "^0.27.0 || ^0.28.0",
+        "fdir": "^6.5.0",
+        "picomatch": "^4.0.3",
+        "postcss": "^8.5.6",
+        "rollup": "^4.43.0",
+        "tinyglobby": "^0.2.15"
+      },
+      "bin": {
+        "vite": "bin/vite.js"
+      },
+      "engines": {
+        "node": "^20.19.0 || >=22.12.0"
+      },
+      "funding": {
+        "url": "https://github.com/vitejs/vite?sponsor=1"
+      },
+      "optionalDependencies": {
+        "fsevents": "~2.3.3"
+      },
+      "peerDependencies": {
+        "@types/node": "^20.19.0 || >=22.12.0",
+        "jiti": ">=1.21.0",
+        "less": "^4.0.0",
+        "lightningcss": "^1.21.0",
+        "sass": "^1.70.0",
+        "sass-embedded": "^1.70.0",
+        "stylus": ">=0.54.8",
+        "sugarss": "^5.0.0",
+        "terser": "^5.16.0",
+        "tsx": "^4.8.1",
+        "yaml": "^2.4.2"
+      },
+      "peerDependenciesMeta": {
+        "@types/node": {
+          "optional": true
+        },
+        "jiti": {
+          "optional": true
+        },
+        "less": {
+          "optional": true
+        },
+        "lightningcss": {
+          "optional": true
+        },
+        "sass": {
+          "optional": true
+        },
+        "sass-embedded": {
+          "optional": true
+        },
+        "stylus": {
+          "optional": true
+        },
+        "sugarss": {
+          "optional": true
+        },
+        "terser": {
+          "optional": true
+        },
+        "tsx": {
+          "optional": true
+        },
+        "yaml": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/vite-plugin-inspect": {
+      "version": "11.4.1",
+      "resolved": "https://registry.npmjs.org/vite-plugin-inspect/-/vite-plugin-inspect-11.4.1.tgz",
+      "integrity": "sha512-ShOFe2PURXGvRS5OrgmOLZOCwDTD7dEBVt0tMpFPKb9AsvqXKCRGM8QgKrUbRbJYFXScHvDPpGRd28rYidC0tA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "ansis": "^4.3.0",
+        "error-stack-parser-es": "^1.0.5",
+        "obug": "^2.1.1",
+        "ohash": "^2.0.11",
+        "open": "^11.0.0",
+        "perfect-debounce": "^2.1.0",
+        "sirv": "^3.0.2",
+        "unplugin-utils": "^0.3.1",
+        "vite-dev-rpc": "^2.0.0"
+      },
+      "engines": {
+        "node": ">=14"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/antfu"
+      },
+      "peerDependencies": {
+        "vite": "^6.0.0 || ^7.0.0-0 || ^8.0.0-0"
+      },
+      "peerDependenciesMeta": {
+        "@nuxt/kit": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/vite-plugin-vue-devtools": {
+      "version": "8.2.1",
+      "resolved": "https://registry.npmjs.org/vite-plugin-vue-devtools/-/vite-plugin-vue-devtools-8.2.1.tgz",
+      "integrity": "sha512-5JLxXWWCo5lJMw16/xVeNvJ8k2zLwZPf1vITLzya/2IePrCBeGe/p/iAokgXHZpEi39fcYtPXmO8SaKeXmqCAA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@vue/devtools-core": "^8.2.1",
+        "@vue/devtools-kit": "^8.2.1",
+        "@vue/devtools-shared": "^8.2.1",
+        "sirv": "^3.0.2",
+        "vite-plugin-inspect": "^11.3.3",
+        "vite-plugin-vue-inspector": "^6.0.0"
+      },
+      "engines": {
+        "node": ">=v14.21.3"
+      },
+      "peerDependencies": {
+        "vite": "^6.0.0 || ^7.0.0 || ^8.0.0"
+      }
+    },
+    "node_modules/vite-plugin-vue-inspector": {
+      "version": "6.0.0",
+      "resolved": "https://registry.npmjs.org/vite-plugin-vue-inspector/-/vite-plugin-vue-inspector-6.0.0.tgz",
+      "integrity": "sha512-OpyITJLgZNibxlrik1EmRtvXHDjLRxNPsWkGFTERZs2LgMEdG4W0WoFt5GIgp3a3jRou+eJR8U1zOBk/XQgEbw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/core": "^7.23.0",
+        "@babel/plugin-proposal-decorators": "^7.23.0",
+        "@babel/plugin-syntax-import-attributes": "^7.22.5",
+        "@babel/plugin-syntax-import-meta": "^7.10.4",
+        "@babel/plugin-transform-typescript": "^7.22.15",
+        "@vue/babel-plugin-jsx": "^1.1.5",
+        "@vue/compiler-dom": "^3.3.4",
+        "kolorist": "^1.8.0",
+        "magic-string": "^0.30.4"
+      },
+      "peerDependencies": {
+        "vite": "^3.0.0 || ^4.0.0 || ^5.0.0 || ^6.0.0 || ^7.0.0 || ^8.0.0"
+      }
+    },
+    "node_modules/vitest": {
+      "version": "3.2.4",
+      "resolved": "https://registry.npmjs.org/vitest/-/vitest-3.2.4.tgz",
+      "integrity": "sha512-LUCP5ev3GURDysTWiP47wRRUpLKMOfPh+yKTx3kVIEiu5KOMeqzpnYNsKyOoVrULivR8tLcks4+lga33Whn90A==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@types/chai": "^5.2.2",
+        "@vitest/expect": "3.2.4",
+        "@vitest/mocker": "3.2.4",
+        "@vitest/pretty-format": "^3.2.4",
+        "@vitest/runner": "3.2.4",
+        "@vitest/snapshot": "3.2.4",
+        "@vitest/spy": "3.2.4",
+        "@vitest/utils": "3.2.4",
+        "chai": "^5.2.0",
+        "debug": "^4.4.1",
+        "expect-type": "^1.2.1",
+        "magic-string": "^0.30.17",
+        "pathe": "^2.0.3",
+        "picomatch": "^4.0.2",
+        "std-env": "^3.9.0",
+        "tinybench": "^2.9.0",
+        "tinyexec": "^0.3.2",
+        "tinyglobby": "^0.2.14",
+        "tinypool": "^1.1.1",
+        "tinyrainbow": "^2.0.0",
+        "vite": "^5.0.0 || ^6.0.0 || ^7.0.0-0",
+        "vite-node": "3.2.4",
+        "why-is-node-running": "^2.3.0"
+      },
+      "bin": {
+        "vitest": "vitest.mjs"
+      },
+      "engines": {
+        "node": "^18.0.0 || ^20.0.0 || >=22.0.0"
+      },
+      "funding": {
+        "url": "https://opencollective.com/vitest"
+      },
+      "peerDependencies": {
+        "@edge-runtime/vm": "*",
+        "@types/debug": "^4.1.12",
+        "@types/node": "^18.0.0 || ^20.0.0 || >=22.0.0",
+        "@vitest/browser": "3.2.4",
+        "@vitest/ui": "3.2.4",
+        "happy-dom": "*",
+        "jsdom": "*"
+      },
+      "peerDependenciesMeta": {
+        "@edge-runtime/vm": {
+          "optional": true
+        },
+        "@types/debug": {
+          "optional": true
+        },
+        "@types/node": {
+          "optional": true
+        },
+        "@vitest/browser": {
+          "optional": true
+        },
+        "@vitest/ui": {
+          "optional": true
+        },
+        "happy-dom": {
+          "optional": true
+        },
+        "jsdom": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/vitest/node_modules/@vitest/mocker": {
+      "version": "3.2.4",
+      "resolved": "https://registry.npmjs.org/@vitest/mocker/-/mocker-3.2.4.tgz",
+      "integrity": "sha512-46ryTE9RZO/rfDd7pEqFl7etuyzekzEhUbTW3BvmeO/BcCMEgq59BKhek3dXDWgAj4oMK6OZi+vRr1wPW6qjEQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@vitest/spy": "3.2.4",
+        "estree-walker": "^3.0.3",
+        "magic-string": "^0.30.17"
+      },
+      "funding": {
+        "url": "https://opencollective.com/vitest"
+      },
+      "peerDependencies": {
+        "msw": "^2.4.9",
+        "vite": "^5.0.0 || ^6.0.0 || ^7.0.0-0"
+      },
+      "peerDependenciesMeta": {
+        "msw": {
+          "optional": true
+        },
+        "vite": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/vitest/node_modules/tinyexec": {
+      "version": "0.3.2",
+      "resolved": "https://registry.npmjs.org/tinyexec/-/tinyexec-0.3.2.tgz",
+      "integrity": "sha512-KQQR9yN7R5+OSwaK0XQoj22pwHoTlgYqmUscPYoknOoWCWfj/5/ABTMRi69FrKU5ffPVh5QcFikpWJI/P1ocHA==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/vitest/node_modules/vite": {
+      "version": "7.3.6",
+      "resolved": "https://registry.npmjs.org/vite/-/vite-7.3.6.tgz",
+      "integrity": "sha512-4XP60spRGjSZFf1qYH+dJIkK2znL3zQfl9KkOV9MkkRR/3Dls0dxaBsQPTloEc5BLXWPL9vsOxopxyKoMmDueg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "esbuild": "^0.27.0 || ^0.28.0",
+        "fdir": "^6.5.0",
+        "picomatch": "^4.0.3",
+        "postcss": "^8.5.6",
+        "rollup": "^4.43.0",
+        "tinyglobby": "^0.2.15"
+      },
+      "bin": {
+        "vite": "bin/vite.js"
+      },
+      "engines": {
+        "node": "^20.19.0 || >=22.12.0"
+      },
+      "funding": {
+        "url": "https://github.com/vitejs/vite?sponsor=1"
+      },
+      "optionalDependencies": {
+        "fsevents": "~2.3.3"
+      },
+      "peerDependencies": {
+        "@types/node": "^20.19.0 || >=22.12.0",
+        "jiti": ">=1.21.0",
+        "less": "^4.0.0",
+        "lightningcss": "^1.21.0",
+        "sass": "^1.70.0",
+        "sass-embedded": "^1.70.0",
+        "stylus": ">=0.54.8",
+        "sugarss": "^5.0.0",
+        "terser": "^5.16.0",
+        "tsx": "^4.8.1",
+        "yaml": "^2.4.2"
+      },
+      "peerDependenciesMeta": {
+        "@types/node": {
+          "optional": true
+        },
+        "jiti": {
+          "optional": true
+        },
+        "less": {
+          "optional": true
+        },
+        "lightningcss": {
+          "optional": true
+        },
+        "sass": {
+          "optional": true
+        },
+        "sass-embedded": {
+          "optional": true
+        },
+        "stylus": {
+          "optional": true
+        },
+        "sugarss": {
+          "optional": true
+        },
+        "terser": {
+          "optional": true
+        },
+        "tsx": {
+          "optional": true
+        },
+        "yaml": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/vooks": {
+      "version": "0.2.12",
+      "resolved": "https://registry.npmjs.org/vooks/-/vooks-0.2.12.tgz",
+      "integrity": "sha512-iox0I3RZzxtKlcgYaStQYKEzWWGAduMmq+jS7OrNdQo1FgGfPMubGL3uGHOU9n97NIvfFDBGnpSvkWyb/NSn/Q==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "evtd": "^0.2.2"
+      },
+      "peerDependencies": {
+        "vue": "^3.0.0"
+      }
+    },
+    "node_modules/vscode-uri": {
+      "version": "3.1.0",
+      "resolved": "https://registry.npmjs.org/vscode-uri/-/vscode-uri-3.1.0.tgz",
+      "integrity": "sha512-/BpdSx+yCQGnCvecbyXdxHDkuk55/G3xwnC0GqY4gmQ3j+A+g8kzzgB4Nk/SINjqn6+waqw3EgbVF2QKExkRxQ==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/vue": {
+      "version": "3.5.41",
+      "resolved": "https://registry.npmjs.org/vue/-/vue-3.5.41.tgz",
+      "integrity": "sha512-2laE0p+aK+/AOPG/XL/WepOs/GlK755LJ1XECi9kDUrz1FKNw8rb2Xzlw9JS1rqEV55nb0ttsKxVlTCcd+R5cg==",
+      "license": "MIT",
+      "dependencies": {
+        "@vue/compiler-dom": "3.5.41",
+        "@vue/compiler-sfc": "3.5.41",
+        "@vue/runtime-dom": "3.5.41",
+        "@vue/server-renderer": "3.5.41",
+        "@vue/shared": "3.5.41"
+      },
+      "peerDependencies": {
+        "typescript": "*"
+      },
+      "peerDependenciesMeta": {
+        "typescript": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/vue-codemirror6": {
+      "version": "1.6.1",
+      "resolved": "https://registry.npmjs.org/vue-codemirror6/-/vue-codemirror6-1.6.1.tgz",
+      "integrity": "sha512-0Ue6nWy055UKP/6LkT0I7nW5SRSFJ+3mokwBdHePQsj11T02mrg3A0jtHyBqH23nRHQFxd3NKw63sZJ1ygo5dA==",
+      "license": "MIT",
+      "dependencies": {
+        "vue-demi": "latest"
+      },
+      "engines": {
+        "node": "^22.18.0 || >=24.12.0"
+      },
+      "peerDependencies": {
+        "@codemirror/autocomplete": "^6.0.0",
+        "@codemirror/commands": "^6.0.0",
+        "@codemirror/language": "^6.0.0",
+        "@codemirror/lint": "^6.0.0",
+        "@codemirror/search": "^6.0.0",
+        "@codemirror/state": "^6.0.0",
+        "@codemirror/view": "^6.0.0",
+        "codemirror": "^6.0.0",
+        "style-mod": "^4.0.0",
+        "vue": "^2.7.14 || ^3.3.4"
+      }
+    },
+    "node_modules/vue-demi": {
+      "version": "0.14.10",
+      "resolved": "https://registry.npmjs.org/vue-demi/-/vue-demi-0.14.10.tgz",
+      "integrity": "sha512-nMZBOwuzabUO0nLgIcc6rycZEebF6eeUfaiQx9+WSk8e29IbLvPU9feI6tqW4kTo3hvoYAJkMh8n8D0fuISphg==",
+      "hasInstallScript": true,
+      "license": "MIT",
+      "bin": {
+        "vue-demi-fix": "bin/vue-demi-fix.js",
+        "vue-demi-switch": "bin/vue-demi-switch.js"
+      },
+      "engines": {
+        "node": ">=12"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/antfu"
+      },
+      "peerDependencies": {
+        "@vue/composition-api": "^1.0.0-rc.1",
+        "vue": "^3.0.0-0 || ^2.6.0"
+      },
+      "peerDependenciesMeta": {
+        "@vue/composition-api": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/vue-tsc": {
+      "version": "3.3.9",
+      "resolved": "https://registry.npmjs.org/vue-tsc/-/vue-tsc-3.3.9.tgz",
+      "integrity": "sha512-TS3Y1ux/IRoE8OCP2PpACAeOseuIs0UvWrcr7u+w3PmfY+SlCfEf8zjrBgnQksHUgLpthi5vHlffcQTQTdPBZA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@volar/typescript": "2.4.28",
+        "@vue/language-core": "3.3.9"
+      },
+      "bin": {
+        "vue-tsc": "bin/vue-tsc.js"
+      },
+      "peerDependencies": {
+        "typescript": ">=5.0.0"
+      }
+    },
+    "node_modules/vueuc": {
+      "version": "0.4.65",
+      "resolved": "https://registry.npmjs.org/vueuc/-/vueuc-0.4.65.tgz",
+      "integrity": "sha512-lXuMl+8gsBmruudfxnMF9HW4be8rFziylXFu1VHVNbLVhRTXXV4njvpRuJapD/8q+oFEMSfQMH16E/85VoWRyQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@css-render/vue3-ssr": "^0.15.10",
+        "@juggle/resize-observer": "^3.3.1",
+        "css-render": "^0.15.10",
+        "evtd": "^0.2.4",
+        "seemly": "^0.3.6",
+        "vdirs": "^0.1.4",
+        "vooks": "^0.2.4"
+      },
+      "peerDependencies": {
+        "vue": "^3.0.11"
+      }
+    },
+    "node_modules/w3c-keyname": {
+      "version": "2.2.8",
+      "resolved": "https://registry.npmjs.org/w3c-keyname/-/w3c-keyname-2.2.8.tgz",
+      "integrity": "sha512-dpojBhNsCNN7T82Tm7k26A6G9ML3NkhDsnw9n/eoxSRlVBB4CEtIQ/KTCLI2Fwf3ataSXRhYFkQi3SlnFwPvPQ==",
+      "license": "MIT"
+    },
+    "node_modules/w3c-xmlserializer": {
+      "version": "5.0.0",
+      "resolved": "https://registry.npmjs.org/w3c-xmlserializer/-/w3c-xmlserializer-5.0.0.tgz",
+      "integrity": "sha512-o8qghlI8NZHU1lLPrpi2+Uq7abh4GGPpYANlalzWxyWteJOCsr/P+oPBA49TOLu5FTZO4d3F9MnWJfiMo4BkmA==",
+      "license": "MIT",
+      "optional": true,
+      "dependencies": {
+        "xml-name-validator": "^5.0.0"
+      },
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/webidl-conversions": {
+      "version": "7.0.0",
+      "resolved": "https://registry.npmjs.org/webidl-conversions/-/webidl-conversions-7.0.0.tgz",
+      "integrity": "sha512-VwddBukDzu71offAQR975unBIGqfKZpM+8ZX6ySk8nYhVoo5CYaZyzt3YBvYtRtO+aoGlqxPg/B87NGVZ/fu6g==",
+      "license": "BSD-2-Clause",
+      "optional": true,
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "node_modules/webpack-virtual-modules": {
+      "version": "0.6.2",
+      "resolved": "https://registry.npmjs.org/webpack-virtual-modules/-/webpack-virtual-modules-0.6.2.tgz",
+      "integrity": "sha512-66/V2i5hQanC51vBQKPH4aI8NMAcBW59FVBs+rC7eGHupMyfn34q7rZIE+ETlJ+XTevqfUhVVBgSUNSW2flEUQ==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/whatwg-encoding": {
+      "version": "3.1.1",
+      "resolved": "https://registry.npmjs.org/whatwg-encoding/-/whatwg-encoding-3.1.1.tgz",
+      "integrity": "sha512-6qN4hJdMwfYBtE3YBTTHhoeuUrDBPZmbQaxWAqSALV/MeEnR5z1xd8UKud2RAkFoPkmB+hli1TZSnyi84xz1vQ==",
+      "deprecated": "Use @exodus/bytes instead for a more spec-conformant and faster implementation",
+      "license": "MIT",
+      "optional": true,
+      "dependencies": {
+        "iconv-lite": "0.6.3"
+      },
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/whatwg-mimetype": {
+      "version": "3.0.0",
+      "resolved": "https://registry.npmjs.org/whatwg-mimetype/-/whatwg-mimetype-3.0.0.tgz",
+      "integrity": "sha512-nt+N2dzIutVRxARx1nghPKGv1xHikU7HKdfafKkLNLindmPU/ch3U31NOCGGA/dmPcmb1VlofO0vnKAcsm0o/Q==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "node_modules/whatwg-url": {
+      "version": "14.2.0",
+      "resolved": "https://registry.npmjs.org/whatwg-url/-/whatwg-url-14.2.0.tgz",
+      "integrity": "sha512-De72GdQZzNTUBBChsXueQUnPKDkg/5A5zp7pFDuQAj5UFoENpiACU0wlCvzpAGnTkj++ihpKwKyYewn/XNUbKw==",
+      "license": "MIT",
+      "optional": true,
+      "dependencies": {
+        "tr46": "^5.1.0",
+        "webidl-conversions": "^7.0.0"
+      },
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/which": {
+      "version": "7.0.0",
+      "resolved": "https://registry.npmjs.org/which/-/which-7.0.0.tgz",
+      "integrity": "sha512-RancgH2dmbLdHl6LRhEqvklWMgl/Hdnun0Y90KhBOLkMefg8Qa7/Zel8Sm+8HEcP6DEjzsWzpkuBQEZok58isA==",
+      "dev": true,
+      "license": "ISC",
+      "dependencies": {
+        "isexe": "^4.0.0"
+      },
+      "bin": {
+        "node-which": "bin/which.js"
+      },
+      "engines": {
+        "node": "^22.22.2 || ^24.15.0 || >=26.0.0"
+      }
+    },
+    "node_modules/which-module": {
+      "version": "2.0.1",
+      "resolved": "https://registry.npmjs.org/which-module/-/which-module-2.0.1.tgz",
+      "integrity": "sha512-iBdZ57RDvnOR9AGBhML2vFZf7h8vmBjhoaZqODJBFWHVtKkDmKuHai3cx5PgVMrX5YDNp27AofYbAwctSS+vhQ==",
+      "license": "ISC"
+    },
+    "node_modules/why-is-node-running": {
+      "version": "2.3.0",
+      "resolved": "https://registry.npmjs.org/why-is-node-running/-/why-is-node-running-2.3.0.tgz",
+      "integrity": "sha512-hUrmaWBdVDcxvYqnyh09zunKzROWjbZTiNy8dBEjkS7ehEDQibXJ7XvlmtbwuTclUiIyN+CyXQD4Vmko8fNm8w==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "siginfo": "^2.0.0",
+        "stackback": "0.0.2"
+      },
+      "bin": {
+        "why-is-node-running": "cli.js"
+      },
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/wmf": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/wmf/-/wmf-1.0.2.tgz",
+      "integrity": "sha512-/p9K7bEh0Dj6WbXg4JG0xvLQmIadrner1bi45VMJTfnbVHsc7yIajZyoSoK60/dtVBs12Fm6WkUI5/3WAVsNMw==",
+      "license": "Apache-2.0",
+      "engines": {
+        "node": ">=0.8"
+      }
+    },
+    "node_modules/word": {
+      "version": "0.3.0",
+      "resolved": "https://registry.npmjs.org/word/-/word-0.3.0.tgz",
+      "integrity": "sha512-OELeY0Q61OXpdUfTp+oweA/vtLVg5VDOXh+3he3PNzLGG/y0oylSOC1xRVj0+l4vQ3tj/bB1HVHv1ocXkQceFA==",
+      "license": "Apache-2.0",
+      "engines": {
+        "node": ">=0.8"
+      }
+    },
+    "node_modules/wrap-ansi": {
+      "version": "8.1.0",
+      "resolved": "https://registry.npmjs.org/wrap-ansi/-/wrap-ansi-8.1.0.tgz",
+      "integrity": "sha512-si7QWI6zUMq56bESFvagtmzMdGOtoxfR+Sez11Mobfc7tm+VkUckk9bW2UeffTGVUbOksxmSw0AA2gs8g71NCQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "ansi-styles": "^6.1.0",
+        "string-width": "^5.0.1",
+        "strip-ansi": "^7.0.1"
+      },
+      "engines": {
+        "node": ">=12"
+      },
+      "funding": {
+        "url": "https://github.com/chalk/wrap-ansi?sponsor=1"
+      }
+    },
+    "node_modules/wrap-ansi-cjs": {
+      "name": "wrap-ansi",
+      "version": "7.0.0",
+      "resolved": "https://registry.npmjs.org/wrap-ansi/-/wrap-ansi-7.0.0.tgz",
+      "integrity": "sha512-YVGIj2kamLSTxw6NsZjoBxfSwsn0ycdesmc4p+Q21c5zPuZ1pl+NfxVdxPtdHvmNVOQ6XSYG4AUtyt/Fi7D16Q==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "ansi-styles": "^4.0.0",
+        "string-width": "^4.1.0",
+        "strip-ansi": "^6.0.0"
+      },
+      "engines": {
+        "node": ">=10"
+      },
+      "funding": {
+        "url": "https://github.com/chalk/wrap-ansi?sponsor=1"
+      }
+    },
+    "node_modules/wrap-ansi-cjs/node_modules/ansi-regex": {
+      "version": "5.0.1",
+      "resolved": "https://registry.npmjs.org/ansi-regex/-/ansi-regex-5.0.1.tgz",
+      "integrity": "sha512-quJQXlTSUGL2LH9SUXo8VwsY4soanhgo6LNSm84E1LBcE8s3O0wpdiRzyR9z/ZZJMlMWv37qOOb9pdJlMUEKFQ==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/wrap-ansi-cjs/node_modules/ansi-styles": {
+      "version": "4.3.0",
+      "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-4.3.0.tgz",
+      "integrity": "sha512-zbB9rCJAT1rbjiVDb2hqKFHNYLxgtk8NURxZ3IZwD3F6NtxbXZQCnnSi1Lkx+IDohdPlFp222wVALIheZJQSEg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "color-convert": "^2.0.1"
+      },
+      "engines": {
+        "node": ">=8"
+      },
+      "funding": {
+        "url": "https://github.com/chalk/ansi-styles?sponsor=1"
+      }
+    },
+    "node_modules/wrap-ansi-cjs/node_modules/emoji-regex": {
+      "version": "8.0.0",
+      "resolved": "https://registry.npmjs.org/emoji-regex/-/emoji-regex-8.0.0.tgz",
+      "integrity": "sha512-MSjYzcWNOA0ewAHpz0MxpYFvwg6yjy1NG3xteoqz644VCo/RPgnr1/GGt+ic3iJTzQ8Eu3TdM14SawnVUmGE6A==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/wrap-ansi-cjs/node_modules/string-width": {
+      "version": "4.2.3",
+      "resolved": "https://registry.npmjs.org/string-width/-/string-width-4.2.3.tgz",
+      "integrity": "sha512-wKyQRQpjJ0sIp62ErSZdGsjMJWsap5oRNihHhu6G7JVO/9jIB6UyevL+tXuOqrng8j/cxKTWyWUwvSTriiZz/g==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "emoji-regex": "^8.0.0",
+        "is-fullwidth-code-point": "^3.0.0",
+        "strip-ansi": "^6.0.1"
+      },
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/wrap-ansi-cjs/node_modules/strip-ansi": {
+      "version": "6.0.1",
+      "resolved": "https://registry.npmjs.org/strip-ansi/-/strip-ansi-6.0.1.tgz",
+      "integrity": "sha512-Y38VPSHcqkFrCpFnQ9vuSXmquuv5oXOKpGeT6aGrr3o3Gc9AlVa6JBfUSOCnbxGGZF+/0ooI7KrPuUSztUdU5A==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "ansi-regex": "^5.0.1"
+      },
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/wrap-ansi/node_modules/ansi-styles": {
+      "version": "6.2.3",
+      "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-6.2.3.tgz",
+      "integrity": "sha512-4Dj6M28JB+oAH8kFkTLUo+a2jwOFkuqb3yucU0CANcRRUbxS0cP0nZYCGjcc3BNXwRIsUVmDGgzawme7zvJHvg==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=12"
+      },
+      "funding": {
+        "url": "https://github.com/chalk/ansi-styles?sponsor=1"
+      }
+    },
+    "node_modules/wrappy": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/wrappy/-/wrappy-1.0.2.tgz",
+      "integrity": "sha512-l4Sp/DRseor9wL6EvV2+TuQn63dMkPjZ/sp9XkghTEbV9KlPS1xUsZ3u7/IQO4wxtcFB4bgpQPRcR3QCvezPcQ==",
+      "license": "ISC",
+      "optional": true
+    },
+    "node_modules/ws": {
+      "version": "8.21.3",
+      "resolved": "https://registry.npmjs.org/ws/-/ws-8.21.3.tgz",
+      "integrity": "sha512-201TZ/kPWxoPr/OKWjquZR1SWKXcvxdH+e1xrx89b3YbmzLMFCLfnaG1HFIgWzJOEWZ7MvpK++odZufgYR50Rw==",
+      "devOptional": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=10.0.0"
+      },
+      "peerDependencies": {
+        "bufferutil": "^4.0.1",
+        "utf-8-validate": ">=5.0.2"
+      },
+      "peerDependenciesMeta": {
+        "bufferutil": {
+          "optional": true
+        },
+        "utf-8-validate": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/wsl-utils": {
+      "version": "0.3.1",
+      "resolved": "https://registry.npmjs.org/wsl-utils/-/wsl-utils-0.3.1.tgz",
+      "integrity": "sha512-g/eziiSUNBSsdDJtCLB8bdYEUMj4jR7AGeUo96p/3dTafgjHhpF4RiCFPiRILwjQoDXx5MqkBr4fwWtR3Ky4Wg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "is-wsl": "^3.1.0",
+        "powershell-utils": "^0.1.0"
+      },
+      "engines": {
+        "node": ">=20"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/xlsx": {
+      "version": "0.18.5",
+      "resolved": "https://registry.npmjs.org/xlsx/-/xlsx-0.18.5.tgz",
+      "integrity": "sha512-dmg3LCjBPHZnQp5/F/+nnTa+miPJxUXB6vtk42YjBBKayDNagxGEeIdWApkYPOf3Z3pm3k62Knjzp7lMeTEtFQ==",
+      "license": "Apache-2.0",
+      "dependencies": {
+        "adler-32": "~1.3.0",
+        "cfb": "~1.2.1",
+        "codepage": "~1.15.0",
+        "crc-32": "~1.2.1",
+        "ssf": "~0.11.2",
+        "wmf": "~1.0.1",
+        "word": "~0.3.0"
+      },
+      "bin": {
+        "xlsx": "bin/xlsx.njs"
+      },
+      "engines": {
+        "node": ">=0.8"
+      }
+    },
+    "node_modules/xml-name-validator": {
+      "version": "5.0.0",
+      "resolved": "https://registry.npmjs.org/xml-name-validator/-/xml-name-validator-5.0.0.tgz",
+      "integrity": "sha512-EvGK8EJ3DhaHfbRlETOWAS5pO9MZITeauHKJyb8wyajUfQUenkIg2MvLDTZ4T/TgIcm3HU0TFBgWWboAZ30UHg==",
+      "license": "Apache-2.0",
+      "optional": true,
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/xmlchars": {
+      "version": "2.2.0",
+      "resolved": "https://registry.npmjs.org/xmlchars/-/xmlchars-2.2.0.tgz",
+      "integrity": "sha512-JZnDKK8B0RCDw84FNdDAIpZK+JuJw+s7Lz8nksI7SIuU3UXJJslUthsi+uWBUYOwPFwW7W7PRLRfUKpxjtjFCw==",
+      "license": "MIT",
+      "optional": true
+    },
+    "node_modules/y18n": {
+      "version": "4.0.3",
+      "resolved": "https://registry.npmjs.org/y18n/-/y18n-4.0.3.tgz",
+      "integrity": "sha512-JKhqTOwSrqNA1NY5lSztJ1GrBiUodLMmIZuLiDaMRJ+itFd+ABVE8XBjOvIWL+rSqNDC74LCSFmlb/U4UZ4hJQ==",
+      "license": "ISC"
+    },
+    "node_modules/yallist": {
+      "version": "3.1.1",
+      "resolved": "https://registry.npmjs.org/yallist/-/yallist-3.1.1.tgz",
+      "integrity": "sha512-a4UGQaWPH59mOXUYnAG2ewncQS4i4F43Tv3JoAM+s2VDAmS9NsK8GpDMLrCHPksFT7h3K6TOoUNn2pb7RoXx4g==",
+      "dev": true,
+      "license": "ISC"
+    },
+    "node_modules/yargs": {
+      "version": "15.4.1",
+      "resolved": "https://registry.npmjs.org/yargs/-/yargs-15.4.1.tgz",
+      "integrity": "sha512-aePbxDmcYW++PaqBsJ+HYUFwCdv4LVvdnhBy78E57PIor8/OVvhMrADFFEDh8DHDFRv/O9i3lPhsENjO7QX0+A==",
+      "license": "MIT",
+      "dependencies": {
+        "cliui": "^6.0.0",
+        "decamelize": "^1.2.0",
+        "find-up": "^4.1.0",
+        "get-caller-file": "^2.0.1",
+        "require-directory": "^2.1.1",
+        "require-main-filename": "^2.0.0",
+        "set-blocking": "^2.0.0",
+        "string-width": "^4.2.0",
+        "which-module": "^2.0.0",
+        "y18n": "^4.0.0",
+        "yargs-parser": "^18.1.2"
+      },
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/yargs-parser": {
+      "version": "18.1.3",
+      "resolved": "https://registry.npmjs.org/yargs-parser/-/yargs-parser-18.1.3.tgz",
+      "integrity": "sha512-o50j0JeToy/4K6OZcaQmW6lyXXKhq7csREXcDwk2omFPJEwUNOVtJKvmDr9EI1fAJZUyZcRF7kxGBWmRXudrCQ==",
+      "license": "ISC",
+      "dependencies": {
+        "camelcase": "^5.0.0",
+        "decamelize": "^1.2.0"
+      },
+      "engines": {
+        "node": ">=6"
+      }
+    },
+    "node_modules/yargs/node_modules/ansi-regex": {
+      "version": "5.0.1",
+      "resolved": "https://registry.npmjs.org/ansi-regex/-/ansi-regex-5.0.1.tgz",
+      "integrity": "sha512-quJQXlTSUGL2LH9SUXo8VwsY4soanhgo6LNSm84E1LBcE8s3O0wpdiRzyR9z/ZZJMlMWv37qOOb9pdJlMUEKFQ==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/yargs/node_modules/emoji-regex": {
+      "version": "8.0.0",
+      "resolved": "https://registry.npmjs.org/emoji-regex/-/emoji-regex-8.0.0.tgz",
+      "integrity": "sha512-MSjYzcWNOA0ewAHpz0MxpYFvwg6yjy1NG3xteoqz644VCo/RPgnr1/GGt+ic3iJTzQ8Eu3TdM14SawnVUmGE6A==",
+      "license": "MIT"
+    },
+    "node_modules/yargs/node_modules/string-width": {
+      "version": "4.2.3",
+      "resolved": "https://registry.npmjs.org/string-width/-/string-width-4.2.3.tgz",
+      "integrity": "sha512-wKyQRQpjJ0sIp62ErSZdGsjMJWsap5oRNihHhu6G7JVO/9jIB6UyevL+tXuOqrng8j/cxKTWyWUwvSTriiZz/g==",
+      "license": "MIT",
+      "dependencies": {
+        "emoji-regex": "^8.0.0",
+        "is-fullwidth-code-point": "^3.0.0",
+        "strip-ansi": "^6.0.1"
+      },
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/yargs/node_modules/strip-ansi": {
+      "version": "6.0.1",
+      "resolved": "https://registry.npmjs.org/strip-ansi/-/strip-ansi-6.0.1.tgz",
+      "integrity": "sha512-Y38VPSHcqkFrCpFnQ9vuSXmquuv5oXOKpGeT6aGrr3o3Gc9AlVa6JBfUSOCnbxGGZF+/0ooI7KrPuUSztUdU5A==",
+      "license": "MIT",
+      "dependencies": {
+        "ansi-regex": "^5.0.1"
+      },
+      "engines": {
+        "node": ">=8"
+      }
+    }
+  }
+}
diff --git a/openprint/package.json b/openprint/package.json
new file mode 100644
index 0000000..d32428c
--- /dev/null
+++ b/openprint/package.json
@@ -0,0 +1,61 @@
+{
+  "name": "openprint26",
+  "version": "0.0.0",
+  "private": false,
+  "type": "module",
+  "scripts": {
+    "dev": "vite",
+    "build": "run-p type-check \"build-only {@}\" --",
+    "preview": "vite preview",
+    "build-only": "vite build",
+    "type-check": "vue-tsc --build",
+    "format": "prettier --write --experimental-cli src/"
+  },
+  "dependencies": {
+    "@bwip-js/generic": "^4.11.2",
+    "@codemirror/lang-json": "^6.0.2",
+    "@tiptap/extension-font-family": "^3.29.2",
+    "@tiptap/extension-text-style": "^3.29.2",
+    "@tiptap/pm": "^3.29.2",
+    "@tiptap/starter-kit": "^3.29.2",
+    "@tiptap/vue-3": "^3.29.2",
+    "@vueuse/core": "^14.4.0",
+    "ajv": "^8.20.0",
+    "codemirror": "^6.0.2",
+    "dompurify": "^3.4.13",
+    "fabric": "^7.4.0",
+    "json-schema-to-ts": "^3.1.1",
+    "jspdf": "^4.2.1",
+    "mustache": "^4.2.0",
+    "opentype.js": "^2.0.0",
+    "pinia": "^4.0.2",
+    "qrcode": "^1.5.4",
+    "stylis": "^4.4.0",
+    "svg2pdf.js": "^2.7.0",
+    "vue": "^3.5.40",
+    "vue-codemirror6": "^1.6.1",
+    "xlsx": "^0.18.5"
+  },
+  "devDependencies": {
+    "@iconify-json/carbon": "^1.2.25",
+    "@tsconfig/node24": "^24.0.4",
+    "@types/node": "^24.13.3",
+    "@types/qrcode": "^1.5.6",
+    "@vitejs/plugin-vue": "^6.0.8",
+    "@vitest/coverage-v8": "^3.2.4",
+    "@vue/tsconfig": "^0.9.1",
+    "happy-dom": "^20.11.2",
+    "naive-ui": "^2.44.1",
+    "npm-run-all2": "^9.0.2",
+    "prettier": "3.9.5",
+    "typescript": "~6.0.0",
+    "unocss": "^66.7.5",
+    "vite": "^8.1.5",
+    "vite-plugin-vue-devtools": "^8.1.5",
+    "vitest": "^3.2.4",
+    "vue-tsc": "^3.3.7"
+  },
+  "engines": {
+    "node": "^22.18.0 || >=24.12.0"
+  }
+}
diff --git a/openprint/pnpm-lock.yaml b/openprint/pnpm-lock.yaml
new file mode 100644
index 0000000..6c7f910
--- /dev/null
+++ b/openprint/pnpm-lock.yaml
@@ -0,0 +1,5852 @@
+lockfileVersion: '9.0'
+
+settings:
+  autoInstallPeers: true
+  excludeLinksFromLockfile: false
+
+importers:
+
+  .:
+    dependencies:
+      '@bwip-js/generic':
+        specifier: ^4.11.2
+        version: 4.11.2
+      '@codemirror/lang-json':
+        specifier: ^6.0.2
+        version: 6.0.2
+      '@tiptap/extension-font-family':
+        specifier: ^3.29.2
+        version: 3.29.2(@tiptap/extension-text-style@3.29.2(@tiptap/core@3.29.2(@tiptap/pm@3.29.2)))
+      '@tiptap/extension-text-style':
+        specifier: ^3.29.2
+        version: 3.29.2(@tiptap/core@3.29.2(@tiptap/pm@3.29.2))
+      '@tiptap/pm':
+        specifier: ^3.29.2
+        version: 3.29.2
+      '@tiptap/starter-kit':
+        specifier: ^3.29.2
+        version: 3.29.2
+      '@tiptap/vue-3':
+        specifier: ^3.29.2
+        version: 3.29.2(@floating-ui/dom@1.8.0)(@tiptap/core@3.29.2(@tiptap/pm@3.29.2))(@tiptap/pm@3.29.2)(vue@3.5.41(typescript@6.0.3))
+      '@vueuse/core':
+        specifier: ^14.4.0
+        version: 14.4.0(vue@3.5.41(typescript@6.0.3))
+      ajv:
+        specifier: ^8.20.0
+        version: 8.20.0
+      codemirror:
+        specifier: ^6.0.2
+        version: 6.0.2
+      dompurify:
+        specifier: ^3.4.13
+        version: 3.4.13
+      fabric:
+        specifier: ^7.4.0
+        version: 7.4.0
+      json-schema-to-ts:
+        specifier: ^3.1.1
+        version: 3.1.1
+      jspdf:
+        specifier: ^4.2.1
+        version: 4.2.1
+      mustache:
+        specifier: ^4.2.0
+        version: 4.2.0
+      opentype.js:
+        specifier: ^2.0.0
+        version: 2.0.0
+      pinia:
+        specifier: ^4.0.2
+        version: 4.0.2(@vue/devtools-api@8.2.1)(typescript@6.0.3)(vue@3.5.41(typescript@6.0.3))
+      qrcode:
+        specifier: ^1.5.4
+        version: 1.5.4
+      stylis:
+        specifier: ^4.4.0
+        version: 4.4.0
+      svg2pdf.js:
+        specifier: ^2.7.0
+        version: 2.7.0(jspdf@4.2.1)
+      vue:
+        specifier: ^3.5.40
+        version: 3.5.41(typescript@6.0.3)
+      vue-codemirror6:
+        specifier: ^1.6.1
+        version: 1.6.1(@codemirror/autocomplete@6.20.3)(@codemirror/commands@6.10.4)(@codemirror/language@6.12.4)(@codemirror/lint@6.9.7)(@codemirror/search@6.7.1)(@codemirror/state@6.7.1)(@codemirror/view@6.43.8)(codemirror@6.0.2)(style-mod@4.1.3)(vue@3.5.41(typescript@6.0.3))
+      xlsx:
+        specifier: ^0.18.5
+        version: 0.18.5
+    devDependencies:
+      '@iconify-json/carbon':
+        specifier: ^1.2.25
+        version: 1.2.25
+      '@tsconfig/node24':
+        specifier: ^24.0.4
+        version: 24.0.4
+      '@types/node':
+        specifier: ^24.13.3
+        version: 24.13.3
+      '@types/qrcode':
+        specifier: ^1.5.6
+        version: 1.5.6
+      '@vitejs/plugin-vue':
+        specifier: ^6.0.8
+        version: 6.0.8(vite@8.2.0(@types/node@24.13.3)(esbuild@0.28.2)(jiti@2.7.0)(yaml@2.9.0))(vue@3.5.41(typescript@6.0.3))
+      '@vitest/coverage-v8':
+        specifier: ^3.2.4
+        version: 3.2.7(vitest@3.2.7(@types/node@24.13.3)(happy-dom@20.11.2)(jiti@2.7.0)(jsdom@26.1.0(canvas@3.2.3))(lightningcss@1.33.0)(yaml@2.9.0))
+      '@vue/tsconfig':
+        specifier: ^0.9.1
+        version: 0.9.1(typescript@6.0.3)(vue@3.5.41(typescript@6.0.3))
+      happy-dom:
+        specifier: ^20.11.2
+        version: 20.11.2
+      naive-ui:
+        specifier: ^2.44.1
+        version: 2.44.1(vue@3.5.41(typescript@6.0.3))
+      npm-run-all2:
+        specifier: ^9.0.2
+        version: 9.0.3
+      prettier:
+        specifier: 3.9.5
+        version: 3.9.5
+      typescript:
+        specifier: ~6.0.0
+        version: 6.0.3
+      unocss:
+        specifier: ^66.7.5
+        version: 66.7.5(vite@8.2.0(@types/node@24.13.3)(esbuild@0.28.2)(jiti@2.7.0)(yaml@2.9.0))
+      vite:
+        specifier: ^8.1.5
+        version: 8.2.0(@types/node@24.13.3)(esbuild@0.28.2)(jiti@2.7.0)(yaml@2.9.0)
+      vite-plugin-vue-devtools:
+        specifier: ^8.1.5
+        version: 8.2.1(vite@8.2.0(@types/node@24.13.3)(esbuild@0.28.2)(jiti@2.7.0)(yaml@2.9.0))(vue@3.5.41(typescript@6.0.3))
+      vitest:
+        specifier: ^3.2.4
+        version: 3.2.7(@types/node@24.13.3)(happy-dom@20.11.2)(jiti@2.7.0)(jsdom@26.1.0(canvas@3.2.3))(lightningcss@1.33.0)(yaml@2.9.0)
+      vue-tsc:
+        specifier: ^3.3.7
+        version: 3.3.9(typescript@6.0.3)
+
+packages:
+
+  '@ampproject/remapping@2.3.0':
+    resolution: {integrity: sha512-30iZtAPgz+LTIYoeivqYo853f02jBYSd5uGnGpkFV0M3xOt9aN73erkgYAmZU43x4VfqcnLxW9Kpg3R5LC4YYw==}
+    engines: {node: '>=6.0.0'}
+
+  '@antfu/install-pkg@1.1.0':
+    resolution: {integrity: sha512-MGQsmw10ZyI+EJo45CdSER4zEb+p31LpDAFp2Z3gkSd1yqVZGi0Ebx++YTEMonJy4oChEMLsxZ64j8FH6sSqtQ==}
+
+  '@asamuzakjp/css-color@3.2.0':
+    resolution: {integrity: sha512-K1A6z8tS3XsmCMM86xoWdn7Fkdn9m6RSVtocUrJYIwZnFVkng/PvkEoWtOWmP+Scc6saYWHWZYbndEEXxl24jw==}
+
+  '@babel/code-frame@7.29.7':
+    resolution: {integrity: sha512-Aup7aUOfpbAUg2ROOJN6Iw5f9DMBlzu0mIkm/malLQFN/YQgO48wCj0Kxa3sEHJvPVFg7siR+qRInwXd2qhQKw==, tarball: https://registry.npmmirror.com/@babel/code-frame/-/code-frame-7.29.7.tgz}
+    engines: {node: '>=6.9.0'}
+
+  '@babel/compat-data@7.29.7':
+    resolution: {integrity: sha512-locTkQyKvwIEgBzVrn8693ebc97F2U8ZHjbXwDXJ5Fn2TCpNwTlKcaKLkdHop5c/icOFE7qt7Q9JC5hnKNa6Gg==, tarball: https://registry.npmmirror.com/@babel/compat-data/-/compat-data-7.29.7.tgz}
+    engines: {node: '>=6.9.0'}
+
+  '@babel/core@7.29.7':
+    resolution: {integrity: sha512-RgHBCvtjbOK2gXSNBNIkNoEc9qoVEtau3hj8gEqKQuL3HZAibKarWFEI3Lfm6EYKkLalOh8eSrj9b+ch9H/VBA==, tarball: https://registry.npmmirror.com/@babel/core/-/core-7.29.7.tgz}
+    engines: {node: '>=6.9.0'}
+
+  '@babel/generator@7.29.8':
+    resolution: {integrity: sha512-gZbepsdh3WDtgZKWL+vTPh71LSBrm/Y4/QDZBVCcYfmeTEEuoOYwlSy+G1StfJg+/Zy550u/3TATbm7qDbbMtg==, tarball: https://registry.npmmirror.com/@babel/generator/-/generator-7.29.8.tgz}
+    engines: {node: '>=6.9.0'}
+
+  '@babel/helper-annotate-as-pure@7.29.7':
+    resolution: {integrity: sha512-OoK6239jHPuSQOoS0kfTVKn0b/rVTk0seKq4Gd2UMLtmOVLjDC0ki3e+c90Trqv2gMfvJFqkiljrr568+qddiw==, tarball: https://registry.npmmirror.com/@babel/helper-annotate-as-pure/-/helper-annotate-as-pure-7.29.7.tgz}
+    engines: {node: '>=6.9.0'}
+
+  '@babel/helper-compilation-targets@7.29.7':
+    resolution: {integrity: sha512-wem6WaBj4NaVYVdNhLPPVacES6ZJ+KBBfSkTMD3YZxbP3rm3Di85tJU5ljaUNhaOynt+Aj0xruhYuzQBt8n71g==, tarball: https://registry.npmmirror.com/@babel/helper-compilation-targets/-/helper-compilation-targets-7.29.7.tgz}
+    engines: {node: '>=6.9.0'}
+
+  '@babel/helper-create-class-features-plugin@7.29.7':
+    resolution: {integrity: sha512-IY3ZD9Tmooqr3TUhc3DUWxiuo8xx1DWLhd5M7hQ+ZWJamqM2BbalrBJb2MisSLoYorOj75U03qULCxQTY9r3hg==, tarball: https://registry.npmmirror.com/@babel/helper-create-class-features-plugin/-/helper-create-class-features-plugin-7.29.7.tgz}
+    engines: {node: '>=6.9.0'}
+    peerDependencies:
+      '@babel/core': ^7.0.0
+
+  '@babel/helper-globals@7.29.7':
+    resolution: {integrity: sha512-3nQVUAtvkKH9zahfWgw96Jc/uFOmjACE1kQz82E2lqWmHBgjzbNlsC22nuQTfahmWeQtTq5nQ/4Nnd2A1wj4zA==, tarball: https://registry.npmmirror.com/@babel/helper-globals/-/helper-globals-7.29.7.tgz}
+    engines: {node: '>=6.9.0'}
+
+  '@babel/helper-member-expression-to-functions@7.29.7':
+    resolution: {integrity: sha512-j+7JYmk1JYDtACIGj0QJqqWZjoUpMoEikQGADMaHgCMCSDqd2+P32rfcibUNrGOMWrlzK1WJBdxrB3JJQZwWtg==, tarball: https://registry.npmmirror.com/@babel/helper-member-expression-to-functions/-/helper-member-expression-to-functions-7.29.7.tgz}
+    engines: {node: '>=6.9.0'}
+
+  '@babel/helper-module-imports@7.29.7':
+    resolution: {integrity: sha512-ejHwrQQYcm9xnTivShn2IDOlIzInN34AXskvq9QicvCtEzq1Vzclu/tKF8Jq1Cg8JG2GL6/EmjgsCT7lXepE3g==, tarball: https://registry.npmmirror.com/@babel/helper-module-imports/-/helper-module-imports-7.29.7.tgz}
+    engines: {node: '>=6.9.0'}
+
+  '@babel/helper-module-transforms@7.29.7':
+    resolution: {integrity: sha512-UPUVSyXbOh627KiCIGQSgwWzGeBKLkaJ9PJEdrngIwMSzxLR4jS4+f1f1jb7VzBbg8nFLaYotvVPFCTqdrmTAg==, tarball: https://registry.npmmirror.com/@babel/helper-module-transforms/-/helper-module-transforms-7.29.7.tgz}
+    engines: {node: '>=6.9.0'}
+    peerDependencies:
+      '@babel/core': ^7.0.0
+
+  '@babel/helper-optimise-call-expression@7.29.7':
+    resolution: {integrity: sha512-+kmGVjcT9RGYzoDwdwEqEvGgKe3BYq+O1iGzjFubaNgZHwYHP6lsF2Yghf4kEuv9BV7tYDZ913aBW9am6YKong==, tarball: https://registry.npmmirror.com/@babel/helper-optimise-call-expression/-/helper-optimise-call-expression-7.29.7.tgz}
+    engines: {node: '>=6.9.0'}
+
+  '@babel/helper-plugin-utils@7.29.7':
+    resolution: {integrity: sha512-G7sHYigPY17oO5SYWnfD/0MTBwVR781S/JI643e/JhUYgVgWE/61SoW3NH9KWUKyKq5LVh3npif99Wkt6j86Jw==, tarball: https://registry.npmmirror.com/@babel/helper-plugin-utils/-/helper-plugin-utils-7.29.7.tgz}
+    engines: {node: '>=6.9.0'}
+
+  '@babel/helper-replace-supers@7.29.7':
+    resolution: {integrity: sha512-atfGXWSeCiF4DnKZIfmJfQRkSw9b9gNNXR1kqKjbhG4pGYCOnkp8OcTB8E3NXjBu8NpheSnOeNKz8KT7UNFTmQ==, tarball: https://registry.npmmirror.com/@babel/helper-replace-supers/-/helper-replace-supers-7.29.7.tgz}
+    engines: {node: '>=6.9.0'}
+    peerDependencies:
+      '@babel/core': ^7.0.0
+
+  '@babel/helper-skip-transparent-expression-wrappers@7.29.7':
+    resolution: {integrity: sha512-brcMGQaVzIeUb+6/bs1Av0f8YuNNjKY2JyvfRCsFuFsdKccEQ5Ges2y74D74NZ1Rz8lKJ9ksJkfqwQFJ/iNEyQ==, tarball: https://registry.npmmirror.com/@babel/helper-skip-transparent-expression-wrappers/-/helper-skip-transparent-expression-wrappers-7.29.7.tgz}
+    engines: {node: '>=6.9.0'}
+
+  '@babel/helper-string-parser@7.29.7':
+    resolution: {integrity: sha512-Pb5ijPrZ89GDH8223L4UP8i6QApWxs04RbPQJTeWDV0/keR2E36MeKnyr6LYmUUvqRRI+Iv87SuF1W6ErINzYw==, tarball: https://registry.npmmirror.com/@babel/helper-string-parser/-/helper-string-parser-7.29.7.tgz}
+    engines: {node: '>=6.9.0'}
+
+  '@babel/helper-validator-identifier@7.29.7':
+    resolution: {integrity: sha512-qehxGkRj55h/ff8EMaJ+cYhyaKlHIxqYDn682wQD7RNp9UujOQsHog2uS0r2vzr4pW+sXf90NeeayjcNaX3fFg==, tarball: https://registry.npmmirror.com/@babel/helper-validator-identifier/-/helper-validator-identifier-7.29.7.tgz}
+    engines: {node: '>=6.9.0'}
+
+  '@babel/helper-validator-option@7.29.7':
+    resolution: {integrity: sha512-N9ZErrD+yW5geCDtBqnOoxmR8+tNKiGuxKlDpuJxfsqpa2dFcexaziGAE/qoHLiDDreVNMupxGmSoNlyvsA3gw==, tarball: https://registry.npmmirror.com/@babel/helper-validator-option/-/helper-validator-option-7.29.7.tgz}
+    engines: {node: '>=6.9.0'}
+
+  '@babel/helpers@7.29.7':
+    resolution: {integrity: sha512-1k2lAGRMfHTcwuNYcCNUmaUffmQv8KWMfh2iJUUeRlwlwH4FdNG7mfPI10NPfLHJFThE4Tyr4mv7kTNZOiPuBg==, tarball: https://registry.npmmirror.com/@babel/helpers/-/helpers-7.29.7.tgz}
+    engines: {node: '>=6.9.0'}
+
+  '@babel/parser@7.29.8':
+    resolution: {integrity: sha512-E8lTAYNB1KW+FH+VGJuZM1ioAx2E6oVlvQFRrf5P8ZZmsiJXYAD9vTFV7yyEURNzgh1dFqMZuO6tUwcARbqFCA==, tarball: https://registry.npmmirror.com/@babel/parser/-/parser-7.29.8.tgz}
+    engines: {node: '>=6.0.0'}
+    hasBin: true
+
+  '@babel/plugin-proposal-decorators@7.29.7':
+    resolution: {integrity: sha512-EtU0Hi3GvrTqD56xKmZvV/uCXK2ZbwVNPNLAquVItcAZpUhkXwWlo3Fmj0c2LxgSf2I8IDULeAepwNP1OefLXg==, tarball: https://registry.npmmirror.com/@babel/plugin-proposal-decorators/-/plugin-proposal-decorators-7.29.7.tgz}
+    engines: {node: '>=6.9.0'}
+    peerDependencies:
+      '@babel/core': ^7.0.0-0
+
+  '@babel/plugin-syntax-decorators@7.29.7':
+    resolution: {integrity: sha512-9MTTLbF39X6sqM92JPEsoI7++26hjZvzkxKZy64aMhWLH2mPkJ/Q3AV4QLmls3R14FpSpkOwQQfUh962JGQxxg==, tarball: https://registry.npmmirror.com/@babel/plugin-syntax-decorators/-/plugin-syntax-decorators-7.29.7.tgz}
+    engines: {node: '>=6.9.0'}
+    peerDependencies:
+      '@babel/core': ^7.0.0-0
+
+  '@babel/plugin-syntax-import-attributes@7.29.7':
+    resolution: {integrity: sha512-zGYcYfq/WmZ4V+kBIXQon9dSSc8ircGZqw9ZaNhhGj9nZkeBu1jHLBDQqYYi5WA9uawvA2sIMbry2nCFhf5Djg==, tarball: https://registry.npmmirror.com/@babel/plugin-syntax-import-attributes/-/plugin-syntax-import-attributes-7.29.7.tgz}
+    engines: {node: '>=6.9.0'}
+    peerDependencies:
+      '@babel/core': ^7.0.0-0
+
+  '@babel/plugin-syntax-import-meta@7.10.4':
+    resolution: {integrity: sha512-Yqfm+XDx0+Prh3VSeEQCPU81yC+JWZ2pDPFSS4ZdpfZhp4MkFMaDC1UqseovEKwSUpnIL7+vK+Clp7bfh0iD7g==, tarball: https://registry.npmmirror.com/@babel/plugin-syntax-import-meta/-/plugin-syntax-import-meta-7.10.4.tgz}
+    peerDependencies:
+      '@babel/core': ^7.0.0-0
+
+  '@babel/plugin-syntax-jsx@7.29.7':
+    resolution: {integrity: sha512-TSu8+mHCoEaaCDEZ0I3+6mvTBYR4PCxQwf2z9/r5Tbztv6NaLR3B9thGTTxX2WGuGHJqRiAbKPeGTJ5XWXVg6A==, tarball: https://registry.npmmirror.com/@babel/plugin-syntax-jsx/-/plugin-syntax-jsx-7.29.7.tgz}
+    engines: {node: '>=6.9.0'}
+    peerDependencies:
+      '@babel/core': ^7.0.0-0
+
+  '@babel/plugin-syntax-typescript@7.29.7':
+    resolution: {integrity: sha512-ngr+82Sh0xMz25TPCZi+nC2iTzjfCdWS2ONXTp/PtSCHCgaCNBpdMqgvJ2ccdLlClVZ7sisIgB914j/JFe+RZA==, tarball: https://registry.npmmirror.com/@babel/plugin-syntax-typescript/-/plugin-syntax-typescript-7.29.7.tgz}
+    engines: {node: '>=6.9.0'}
+    peerDependencies:
+      '@babel/core': ^7.0.0-0
+
+  '@babel/plugin-transform-typescript@7.29.7':
+    resolution: {integrity: sha512-jK52h8LaLc7JarhQV2ofeFMts4H7vnOXnqZNA6fYglBTZewRBE51KWt3BUltW1P+KoPsYkHoJeXePuz4zo2LMw==, tarball: https://registry.npmmirror.com/@babel/plugin-transform-typescript/-/plugin-transform-typescript-7.29.7.tgz}
+    engines: {node: '>=6.9.0'}
+    peerDependencies:
+      '@babel/core': ^7.0.0-0
+
+  '@babel/runtime@7.29.7':
+    resolution: {integrity: sha512-Nq8OhGWiZIZGV6hLHoyAKLLcJihP/xFeBMGJoUrxTX2psI8dCifzLhZISFb+VWS3wFMRDmCGw5R+dOySCqPLhw==}
+    engines: {node: '>=6.9.0'}
+
+  '@babel/template@7.29.7':
+    resolution: {integrity: sha512-puq+Gf35oI24FeN11LkoUQFqv9uwNeWpxXZi/Ji3rRIoKAzKnxRaZ+Gkj0vKS9ZCiTESfng1N9LyOyXvo+m+Gg==, tarball: https://registry.npmmirror.com/@babel/template/-/template-7.29.7.tgz}
+    engines: {node: '>=6.9.0'}
+
+  '@babel/traverse@7.29.8':
+    resolution: {integrity: sha512-I5z7H3bf/41ktsNVLtpN0wAa336HkqIHQ5BuPLEhTkt1jVSyZpeNKIzTgEWmlxjdg81R0IgUCcaE+Ok3NvrfZg==, tarball: https://registry.npmmirror.com/@babel/traverse/-/traverse-7.29.8.tgz}
+    engines: {node: '>=6.9.0'}
+
+  '@babel/types@7.29.8':
+    resolution: {integrity: sha512-Vj1jF3cPfxg7OAfoI7QnVKLoILlm2JF9pnVHrX8qx7AHMiYWT+NDAA7jChlNgRS4WTLc/fD1lXLmPixluj+3Gg==, tarball: https://registry.npmmirror.com/@babel/types/-/types-7.29.8.tgz}
+    engines: {node: '>=6.9.0'}
+
+  '@bcoe/v8-coverage@1.0.2':
+    resolution: {integrity: sha512-6zABk/ECA/QYSCQ1NGiVwwbQerUCZ+TQbp64Q3AgmfNvurHH0j8TtXa1qbShXA6qqkpAj4V5W8pP6mLe1mcMqA==}
+    engines: {node: '>=18'}
+
+  '@bwip-js/generic@4.11.2':
+    resolution: {integrity: sha512-NSBGrja1Md/alQyGnJ96YJYvhxsqzV1ZhIxOsADvIo3s0PGYDISvxxcGDVwLXvWWU+38dcfFNFED47Owzjewzw==, tarball: https://registry.npmmirror.com/@bwip-js/generic/-/generic-4.11.2.tgz}
+
+  '@codemirror/autocomplete@6.20.3':
+    resolution: {integrity: sha512-tlosUqb+3BbxCxZdu4tKeRghPFC+QM7q4X5YhKV2eCmPG+1r2F3f4AaSz5sCrFqUtX4Jh20VFTKecl16MgiV9g==}
+
+  '@codemirror/commands@6.10.4':
+    resolution: {integrity: sha512-Ryk9y9T0FFVF0cUGhAknveAyUOl/A1qReTFi+qPKtOh2Z9F4AUBz3XOrYD4ZEgZirdugVzHvd/2/Wcwy5OliTg==}
+
+  '@codemirror/lang-json@6.0.2':
+    resolution: {integrity: sha512-x2OtO+AvwEHrEwR0FyyPtfDUiloG3rnVTSZV1W8UteaLL8/MajQd8DpvUb2YVzC+/T18aSDv0H9mu+xw0EStoQ==}
+
+  '@codemirror/language@6.12.4':
+    resolution: {integrity: sha512-1q4PaT+o6PbgpkJt4Q8Fv5XJxTy4FUZ4MWETtyiDw3J0Pyr9E2vqcKL+k9wcvjNTIsauxvE7OfmWj3FRPHQ76A==}
+
+  '@codemirror/lint@6.9.7':
+    resolution: {integrity: sha512-28/+iWLYxKxsvGYhSYL7zaCZqLz5+FFFDq9tVsvGv9kv8RY4fFAchJ5WX9M3YrrRlTIsECjsXPqeNgnSmNP2dg==}
+
+  '@codemirror/search@6.7.1':
+    resolution: {integrity: sha512-uMe5UO6PamJtSHrXhhHOzSX3ReWtiJrva6GnPMwSOrZtiExb5X5eExhr2OUZQVvdxPsKpY3Ro2mFbQadpPWmHA==}
+
+  '@codemirror/state@6.7.1':
+    resolution: {integrity: sha512-9QzNDgE4EYDnAHfrTlR2lwiPciiOymLtwKK+8yHQzCc7GXhAP9xdEbEJFy2IWB1j9UGUl9BsgMmTo/ImA02T7A==}
+
+  '@codemirror/view@6.43.8':
+    resolution: {integrity: sha512-qtItTDssZ/5GFfi94hrILu9j/VUeFPDPkhovEfmWFj2ipTxnzPB8DdHgfbb8HYTzLTYhrndKmyQxXUz/PDLenw==}
+
+  '@css-render/plugin-bem@0.15.14':
+    resolution: {integrity: sha512-QK513CJ7yEQxm/P3EwsI+d+ha8kSOcjGvD6SevM41neEMxdULE+18iuQK6tEChAWMOQNQPLG/Rw3Khb69r5neg==, tarball: https://registry.npmmirror.com/@css-render/plugin-bem/-/plugin-bem-0.15.14.tgz}
+    peerDependencies:
+      css-render: ~0.15.14
+
+  '@css-render/vue3-ssr@0.15.14':
+    resolution: {integrity: sha512-//8027GSbxE9n3QlD73xFY6z4ZbHbvrOVB7AO6hsmrEzGbg+h2A09HboUyDgu+xsmj7JnvJD39Irt+2D0+iV8g==, tarball: https://registry.npmmirror.com/@css-render/vue3-ssr/-/vue3-ssr-0.15.14.tgz}
+    peerDependencies:
+      vue: ^3.0.11
+
+  '@csstools/color-helpers@5.1.0':
+    resolution: {integrity: sha512-S11EXWJyy0Mz5SYvRmY8nJYTFFd1LCNV+7cXyAgQtOOuzb4EsgfqDufL+9esx72/eLhsRdGZwaldu/h+E4t4BA==}
+    engines: {node: '>=18'}
+
+  '@csstools/css-calc@2.1.4':
+    resolution: {integrity: sha512-3N8oaj+0juUw/1H3YwmDDJXCgTB1gKU6Hc/bB502u9zR0q2vd786XJH9QfrKIEgFlZmhZiq6epXl4rHqhzsIgQ==}
+    engines: {node: '>=18'}
+    peerDependencies:
+      '@csstools/css-parser-algorithms': ^3.0.5
+      '@csstools/css-tokenizer': ^3.0.4
+
+  '@csstools/css-color-parser@3.1.0':
+    resolution: {integrity: sha512-nbtKwh3a6xNVIp/VRuXV64yTKnb1IjTAEEh3irzS+HkKjAOYLTGNb9pmVNntZ8iVBHcWDA2Dof0QtPgFI1BaTA==}
+    engines: {node: '>=18'}
+    peerDependencies:
+      '@csstools/css-parser-algorithms': ^3.0.5
+      '@csstools/css-tokenizer': ^3.0.4
+
+  '@csstools/css-parser-algorithms@3.0.5':
+    resolution: {integrity: sha512-DaDeUkXZKjdGhgYaHNJTV9pV7Y9B3b644jCLs9Upc3VeNGg6LWARAT6O+Q+/COo+2gg/bM5rhpMAtf70WqfBdQ==}
+    engines: {node: '>=18'}
+    peerDependencies:
+      '@csstools/css-tokenizer': ^3.0.4
+
+  '@csstools/css-tokenizer@3.0.4':
+    resolution: {integrity: sha512-Vd/9EVDiu6PPJt9yAh6roZP6El1xHrdvIVGjyBsHR0RYwNHgL7FJPyIIW4fANJNG6FtyZfvlRPpFI4ZM/lubvw==}
+    engines: {node: '>=18'}
+
+  '@emnapi/core@1.10.0':
+    resolution: {integrity: sha512-yq6OkJ4p82CAfPl0u9mQebQHKPJkY7WrIuk205cTYnYe+k2Z8YBh11FrbRG/H6ihirqcacOgl2BIO8oyMQLeXw==}
+
+  '@emnapi/runtime@1.10.0':
+    resolution: {integrity: sha512-ewvYlk86xUoGI0zQRNq/mC+16R1QeDlKQy21Ki3oSYXNgLb45GV1P6A0M+/s6nyCuNDqe5VpaY84BzXGwVbwFA==}
+
+  '@emnapi/wasi-threads@1.2.1':
+    resolution: {integrity: sha512-uTII7OYF+/Mes/MrcIOYp5yOtSMLBWSIoLPpcgwipoiKbli6k322tcoFsxoIIxPDqW01SQGAgko4EzZi2BNv2w==}
+
+  '@emotion/hash@0.8.0':
+    resolution: {integrity: sha512-kBJtf7PH6aWwZ6fka3zQ0p6SBYzx4fl1LoZXE2RrnYST9Xljm7WfKJrU4g/Xr3Beg72MLrp1AWNUmuYJTL7Cow==, tarball: https://registry.npmmirror.com/@emotion/hash/-/hash-0.8.0.tgz}
+
+  '@esbuild/aix-ppc64@0.28.2':
+    resolution: {integrity: sha512-XExcO+dvLKvVtNTibSTBej1NCAbaGhWn9Ww1ZPx80qsahhPFe/8jgWP0IchNe0F3HwkU7n8ejhH8bjonqht8mQ==}
+    engines: {node: '>=18'}
+    cpu: [ppc64]
+    os: [aix]
+
+  '@esbuild/android-arm64@0.28.2':
+    resolution: {integrity: sha512-5YfKeeI8qWfBZIX+u2xZC3Zlb3Os/gLS2sbEKM+I4ZOcsWmHS2WLysCcQZDAFRslDUU5Oiq44gf6PYN1vGwG5A==}
+    engines: {node: '>=18'}
+    cpu: [arm64]
+    os: [android]
+
+  '@esbuild/android-arm@0.28.2':
+    resolution: {integrity: sha512-kXXoiPVVGQcnIYGOeaovwOURpniDBpSq4A03qkQ+BMQqtGG6HYap3xne9C1O1yo4TR3qxlCX5IqqmX6fFo2Lqg==}
+    engines: {node: '>=18'}
+    cpu: [arm]
+    os: [android]
+
+  '@esbuild/android-x64@0.28.2':
+    resolution: {integrity: sha512-O387ite7SzUyCcy3JQX4P4bLtEA7bLLkx+esve5JHnyYfNTxcVpXZo9jhdB0lTKN44gztELTdU7nS8Nr16Fs1Q==}
+    engines: {node: '>=18'}
+    cpu: [x64]
+    os: [android]
+
+  '@esbuild/darwin-arm64@0.28.2':
+    resolution: {integrity: sha512-n4KqkOQrraxHJcgjM1RvwbigfQKIKJVpM7xp+KsxiyUSrRdIXnt73VhrPAx0fV44hgfmIVKjxMN9J1t5jySVkw==}
+    engines: {node: '>=18'}
+    cpu: [arm64]
+    os: [darwin]
+
+  '@esbuild/darwin-x64@0.28.2':
+    resolution: {integrity: sha512-uq6suIWYP37qzGddBKPw5QEQPi6HiLGsO7UmkpfyaYNQ3D+rN6w6WfwH+nuqcGXWvawGwxOEroO4YGnFh95azw==}
+    engines: {node: '>=18'}
+    cpu: [x64]
+    os: [darwin]
+
+  '@esbuild/freebsd-arm64@0.28.2':
+    resolution: {integrity: sha512-n+I0BTSRIoy+d6RPKnEVwql5UwBJolytvY4mAOIEJorKlqgPII8ix6slVVrfZ5Tnj7glIZvloylbB/EJPMWEXw==}
+    engines: {node: '>=18'}
+    cpu: [arm64]
+    os: [freebsd]
+
+  '@esbuild/freebsd-x64@0.28.2':
+    resolution: {integrity: sha512-78XJTJkvPs0kz2w61301PJjXl4g7q3JqiYMZ/M/yVI73EHBrCRTgkhu9oqG7vPqq+a/yadEW8aD+agKlk5xrmg==}
+    engines: {node: '>=18'}
+    cpu: [x64]
+    os: [freebsd]
+
+  '@esbuild/linux-arm64@0.28.2':
+    resolution: {integrity: sha512-pW4AC0P3it8c7do9MVM4p51FzHzdM/TZrerurgRcHJ2WTa1VQ1CIq18xncfpBJw4ojkiZZrKW2yIBWBP92j6Ug==}
+    engines: {node: '>=18'}
+    cpu: [arm64]
+    os: [linux]
+
+  '@esbuild/linux-arm@0.28.2':
+    resolution: {integrity: sha512-XlDnu2q5yoqems+xay6wSAcg9DDD7K9RLKZEBOMZm3ckNpJBvOX20tSfby8KfrrhINDyv9V2YVZKY/SpoGJI8w==}
+    engines: {node: '>=18'}
+    cpu: [arm]
+    os: [linux]
+
+  '@esbuild/linux-ia32@0.28.2':
+    resolution: {integrity: sha512-CYbnj78HsIeA+DhgUKgFCfvNsTHFhMMrinUrMZpDXJXKN8T3XViTZ/+wtHeVxEWY8ewSzTFN+nRmSwO2tZaLUQ==}
+    engines: {node: '>=18'}
+    cpu: [ia32]
+    os: [linux]
+
+  '@esbuild/linux-loong64@0.28.2':
+    resolution: {integrity: sha512-buwkd8nsph4R+ajRvw0qM5Hja/TXQow3ptzWO2EbG/cqcIkHloRrdlBtQlshyYGTNFvfkfJ5tpPLVkY4DtsPfQ==}
+    engines: {node: '>=18'}
+    cpu: [loong64]
+    os: [linux]
+
+  '@esbuild/linux-mips64el@0.28.2':
+    resolution: {integrity: sha512-ZVykbDyk7519VwiNb9Lcj9m8XM6v5V9uKPvrEMkkEedVewf+0itkhahp4HDpgERXhwLRpWFypsGbG/J8s0QjJA==}
+    engines: {node: '>=18'}
+    cpu: [mips64el]
+    os: [linux]
+
+  '@esbuild/linux-ppc64@0.28.2':
+    resolution: {integrity: sha512-CAXl+Dtd9UUuJd8pKKdwh6MLm3MUMiqMPmhZ3tTSXPqfyQ3vDl6R5hZdZ/kYojK4ofXtdfSv1tFq8XzWx3heNQ==}
+    engines: {node: '>=18'}
+    cpu: [ppc64]
+    os: [linux]
+
+  '@esbuild/linux-riscv64@0.28.2':
+    resolution: {integrity: sha512-GeXCej4IQtU1B+QlDV8W/RRvbzI3O/Stss+/bCXv4lZls5WGRtu2a+3JkA3i4qIUlMXpcHebWpF8AkJhATowuA==}
+    engines: {node: '>=18'}
+    cpu: [riscv64]
+    os: [linux]
+
+  '@esbuild/linux-s390x@0.28.2':
+    resolution: {integrity: sha512-3H1weTYZPxt/WOhByszQZybS9w5lKzUn1FDMsgEChbHWQwHYQQRfBxgCcZvPhjHfKyJjIievvMmEUawJrdY9Dg==}
+    engines: {node: '>=18'}
+    cpu: [s390x]
+    os: [linux]
+
+  '@esbuild/linux-x64@0.28.2':
+    resolution: {integrity: sha512-4xTZr1FUmSoQW4XIWmit3tzQrUTZM+N3P0XV8xROKYF50XfI7xeO90+1bZvNwxIufQ9hDQVRJH5YhgPVF8A/HQ==}
+    engines: {node: '>=18'}
+    cpu: [x64]
+    os: [linux]
+
+  '@esbuild/netbsd-arm64@0.28.2':
+    resolution: {integrity: sha512-sSATRjPeDBg3pdgHoQfoYBob11Kk1FGa9lui5RIHZCoCkJa9QKlvl3/vKz2usCmYYjs7ymJR/2Nnsqe+Hjt5nw==}
+    engines: {node: '>=18'}
+    cpu: [arm64]
+    os: [netbsd]
+
+  '@esbuild/netbsd-x64@0.28.2':
+    resolution: {integrity: sha512-lqnzCV+mM0gIADaKihiCg6ifgfU2L3h5E33rNQBN1Y4MaVGnzryzmvvf7UHxprpQdE8hpqLolJ9Rl+SkIRDpyw==}
+    engines: {node: '>=18'}
+    cpu: [x64]
+    os: [netbsd]
+
+  '@esbuild/openbsd-arm64@0.28.2':
+    resolution: {integrity: sha512-AL2qJILH7lNjrDmCQDvdxMfAUIv8KMNZOvrwAQ8i8//ntL9FflhOyMJ8OZSMBb8/AWXe3/5v5S20y3zCoZWKoQ==}
+    engines: {node: '>=18'}
+    cpu: [arm64]
+    os: [openbsd]
+
+  '@esbuild/openbsd-x64@0.28.2':
+    resolution: {integrity: sha512-QtiuPytchRyC4rwUKhexJdQKvDuZ6hWloi3igqPQNUJCS1/v9EiO3UTOXR6A3FoMo4fnAKbWJdqaIwhOzh8qEw==}
+    engines: {node: '>=18'}
+    cpu: [x64]
+    os: [openbsd]
+
+  '@esbuild/openharmony-arm64@0.28.2':
+    resolution: {integrity: sha512-WkhYDmpTjLvGlScA1rwjRUmhl4k8oXR3cIbtqWmELgU/dFeHHlEllxDvdWcNJV9rbzCexB5vz8gtNewWLgCT7Q==}
+    engines: {node: '>=18'}
+    cpu: [arm64]
+    os: [openharmony]
+
+  '@esbuild/sunos-x64@0.28.2':
+    resolution: {integrity: sha512-GPMSkTOtMnv2U2F8gxe4Io6qmVs+YKyp832Etqqxr0hFngmXQ3rzwytelm3GIn7T4VviRUlf3sOgBOiTdvaf7g==}
+    engines: {node: '>=18'}
+    cpu: [x64]
+    os: [sunos]
+
+  '@esbuild/win32-arm64@0.28.2':
+    resolution: {integrity: sha512-PIhhEkE9uPBleRBrQEJpUn7MBnibZzbGzYWPmY3x+YoVg/95zbjB4CxPPOQ8l5tYYM4mMaCthF8/1DIfBQQyWQ==}
+    engines: {node: '>=18'}
+    cpu: [arm64]
+    os: [win32]
+
+  '@esbuild/win32-ia32@0.28.2':
+    resolution: {integrity: sha512-YmJbfTlvU7Sdn9BB+4PRES4oB6pxgS37MAONj+hBr/cpXS1aBPKXxNnDbu+QCWPj0o9dgyxeq79g6c5P8KeuYA==}
+    engines: {node: '>=18'}
+    cpu: [ia32]
+    os: [win32]
+
+  '@esbuild/win32-x64@0.28.2':
+    resolution: {integrity: sha512-5ebpxr3nWMzrL/rnUI755Jkuee0bHL/Gq0WTF9lvcpv73wAp5eu8MfBUgWK9bhWvZjj7yX8etf/8tI8Ney695g==}
+    engines: {node: '>=18'}
+    cpu: [x64]
+    os: [win32]
+
+  '@floating-ui/core@1.8.0':
+    resolution: {integrity: sha512-0CIZ5itps/8x7BG8dEIhs53BvCUH2PCoogtakwRTut+Arm58sJooJ0AuZhLw2HJYIR5cMLNPBSS728sPho2khQ==}
+
+  '@floating-ui/dom@1.8.0':
+    resolution: {integrity: sha512-yXSrzeHZBTZadLOlfyhCkJHNeLJnHRnRInwdZ40L7ZiaAtrBwoYlsDrX3v5zB1Utk7CLfzcOVnVVWoXEky7Ceg==}
+
+  '@floating-ui/utils@0.2.12':
+    resolution: {integrity: sha512-HpCo8tmWzLVad5s2d19EhAz5zqrrQ6s69qd6moPMQvkOuSwDT1YgRfWSVuc4ennqrgv3OHppiOGMQ7oC13yIww==}
+
+  '@iconify-json/carbon@1.2.25':
+    resolution: {integrity: sha512-7GLgXnmi47Skh8DcPPiP8U3vgm3rOVziEe+flCdG/kwiVaeb649U3Eqt/ej4f3NvlZK8BrOxpR3xQlWFLZYblQ==}
+
+  '@iconify/types@2.0.0':
+    resolution: {integrity: sha512-+wluvCrRhXrhyOmRDJ3q8mux9JkKy5SJ/v8ol2tu4FVjyYvtEzkc/3pK15ET6RKg4b4w4BmTk1+gsCUhf21Ykg==}
+
+  '@iconify/utils@3.1.4':
+    resolution: {integrity: sha512-b1S7B1k9ohZ+iNTi2ATxbRYG9fTrJmUT0rc46bvVnNxqNRGW7dyo/vRREwyniI5IRN2RSJHDcm+s3BjWrSAjHw==}
+
+  '@isaacs/cliui@8.0.2':
+    resolution: {integrity: sha512-O8jcjabXaleOG9DQ0+ARXWZBTfnP4WNAqzuiJK7ll44AmxGKv/J2M4TPjxjY3znBCfvBXFzucm1twdyFybFqEA==}
+    engines: {node: '>=12'}
+
+  '@istanbuljs/schema@0.1.6':
+    resolution: {integrity: sha512-+Sg6GCR/wy1oSmQDFq4LQDAhm3ETKnorxN+y5nbLULOR3P0c14f2Wurzj3/xqPXtasLFfHd5iRFQ7AJt4KH2cw==}
+    engines: {node: '>=8'}
+
+  '@jridgewell/gen-mapping@0.3.13':
+    resolution: {integrity: sha512-2kkt/7niJ6MgEPxF0bYdQ6etZaA+fQvDcLKckhy1yIQOzaoKjBBjSj63/aLVjYE3qhRt5dvM+uUyfCg6UKCBbA==, tarball: https://registry.npmmirror.com/@jridgewell/gen-mapping/-/gen-mapping-0.3.13.tgz}
+
+  '@jridgewell/remapping@2.3.5':
+    resolution: {integrity: sha512-LI9u/+laYG4Ds1TDKSJW2YPrIlcVYOwi2fUC6xB43lueCjgxV4lffOCZCtYFiH6TNOX+tQKXx97T4IKHbhyHEQ==, tarball: https://registry.npmmirror.com/@jridgewell/remapping/-/remapping-2.3.5.tgz}
+
+  '@jridgewell/resolve-uri@3.1.2':
+    resolution: {integrity: sha512-bRISgCIjP20/tbWSPWMEi54QVPRZExkuD9lJL+UIxUKtwVJA8wW1Trb1jMs1RFXo1CBTNZ/5hpC9QvmKWdopKw==, tarball: https://registry.npmmirror.com/@jridgewell/resolve-uri/-/resolve-uri-3.1.2.tgz}
+    engines: {node: '>=6.0.0'}
+
+  '@jridgewell/sourcemap-codec@1.5.5':
+    resolution: {integrity: sha512-cYQ9310grqxueWbl+WuIUIaiUaDcj7WOq5fVhEljNVgRfOUhY9fy2zTvfoqWsnebh8Sl70VScFbICvJnLKB0Og==, tarball: https://registry.npmmirror.com/@jridgewell/sourcemap-codec/-/sourcemap-codec-1.5.5.tgz}
+
+  '@jridgewell/trace-mapping@0.3.31':
+    resolution: {integrity: sha512-zzNR+SdQSDJzc8joaeP8QQoCQr8NuYx2dIIytl1QeBEZHJ9uW6hebsrYgbz8hJwUQao3TWCMtmfV8Nu1twOLAw==, tarball: https://registry.npmmirror.com/@jridgewell/trace-mapping/-/trace-mapping-0.3.31.tgz}
+
+  '@juggle/resize-observer@3.4.0':
+    resolution: {integrity: sha512-dfLbk+PwWvFzSxwk3n5ySL0hfBog779o8h68wK/7/APo/7cgyWp5jcXockbxdk5kFRkbeXWm4Fbi9FrdN381sA==, tarball: https://registry.npmmirror.com/@juggle/resize-observer/-/resize-observer-3.4.0.tgz}
+
+  '@lezer/common@1.5.2':
+    resolution: {integrity: sha512-sxQE460fPZyU3sdc8lafxiPwJHBzZRy/udNFynGQky1SePYBdhkBl1kOagA9uT3pxR8K09bOrmTUqA9wb/PjSQ==}
+
+  '@lezer/highlight@1.2.3':
+    resolution: {integrity: sha512-qXdH7UqTvGfdVBINrgKhDsVTJTxactNNxLk7+UMwZhU13lMHaOBlJe9Vqp907ya56Y3+ed2tlqzys7jDkTmW0g==}
+
+  '@lezer/json@1.0.3':
+    resolution: {integrity: sha512-BP9KzdF9Y35PDpv04r0VeSTKDeox5vVr3efE7eBbx3r4s3oNLfunchejZhjArmeieBH+nVOpgIiBJpEAv8ilqQ==}
+
+  '@lezer/lr@1.4.10':
+    resolution: {integrity: sha512-rnCpTIBafOx4mRp43xOxDJbFipJm/c0cia/V5TiGlhmMa+wsSdoGmUN3w5Bqrks/09Q/D4tNAmWaT8p6NRi77A==}
+
+  '@marijn/find-cluster-break@1.0.3':
+    resolution: {integrity: sha512-FY+MKLBoTsLNJF/eLWaOsXGdz6uh3Iu1axjPf6TUq92IYumcTcXWHoS747JARLkcdlJ/Waiaxc5wQfFO8jC6NA==}
+
+  '@napi-rs/lzma-linux-x64-gnu@1.5.1':
+    resolution: {integrity: sha512-oTXEIha4SsuXdTA4Iyskj0kpdx2yVXdhd75c2v3xGrHFfVMsbhTPZU/nMPL4sWKo4pBHm3aucLaqGlF696dTyQ==}
+    engines: {node: ^22.20 || ^24.12 || >=25}
+    cpu: [x64]
+    os: [linux]
+
+  '@napi-rs/wasm-runtime@1.2.2':
+    resolution: {integrity: sha512-JfB4kuJQjaoHuCTseIINHtHWeJnvgEcxjwA5t/Y00ZgaOO1Crz3fjT/p8kT28zA/Caz7oiUMn3d6H2yOVCVwuw==}
+    engines: {node: ^20.19.0 || ^22.13.0 || >=23.5.0}
+    peerDependencies:
+      '@emnapi/core': ^1.7.1 || ^2.0.0-alpha.3
+      '@emnapi/runtime': ^1.7.1 || ^2.0.0-alpha.3
+
+  '@oxc-parser/binding-android-arm-eabi@0.131.0':
+    resolution: {integrity: sha512-t2xicr9pfzkSRYx5aPqZqlLaayIwJTqgQ81Jor31Xep2nGyL2Aq3d0K5wOfeR7VevaSdxaS9dzSQP9xDwn8fDg==}
+    engines: {node: ^20.19.0 || >=22.12.0}
+    cpu: [arm]
+    os: [android]
+
+  '@oxc-parser/binding-android-arm64@0.131.0':
+    resolution: {integrity: sha512-nlGIod6gw75x1aEDgLS+srj+JRGY0HHm9MI9YgzE/B64l6d6+H3MSP9NOgp0+HTg8tp4vV9rVfgQGgd+TfVZcA==}
+    engines: {node: ^20.19.0 || >=22.12.0}
+    cpu: [arm64]
+    os: [android]
+
+  '@oxc-parser/binding-darwin-arm64@0.131.0':
+    resolution: {integrity: sha512-jukuV6xe5RbQKFo7QD34NDCLDZp4PSOm8rmckhNdH/60ymG5zXbDzGBEyc+nTkuLQNama2aSGCt+CPfpjNTqyw==}
+    engines: {node: ^20.19.0 || >=22.12.0}
+    cpu: [arm64]
+    os: [darwin]
+
+  '@oxc-parser/binding-darwin-x64@0.131.0':
+    resolution: {integrity: sha512-g3JOo4khe9rslHm5WYaVDWb0HS/M1MLR3I9S8560MkKIcC96VQY00QjOlsuRyfSj/JDXj8i9T7ryPO2RidiXVg==}
+    engines: {node: ^20.19.0 || >=22.12.0}
+    cpu: [x64]
+    os: [darwin]
+
+  '@oxc-parser/binding-freebsd-x64@0.131.0':
+    resolution: {integrity: sha512-1hziITDTxjMePnX+dR9ocVT+EuZkQ8wm4FPAbmbEiKG+Phbo73J1ZnPAA6Y/aGsWF3McOFnQuZIktAFwalkfJQ==}
+    engines: {node: ^20.19.0 || >=22.12.0}
+    cpu: [x64]
+    os: [freebsd]
+
+  '@oxc-parser/binding-linux-arm-gnueabihf@0.131.0':
+    resolution: {integrity: sha512-9uRxfXwyKG9+MwmGQBo2ncPNwZH5HTmCETFM2WiuDBNDCW4NC5ttSQkwCAMrTAWgwMzVBH1CP8pM0v7nebCWXQ==}
+    engines: {node: ^20.19.0 || >=22.12.0}
+    cpu: [arm]
+    os: [linux]
+
+  '@oxc-parser/binding-linux-arm-musleabihf@0.131.0':
+    resolution: {integrity: sha512-mgbLvzRShXOLBdWGInf08Af4q+pfj1xD8hSgLClDZ9of/BXkB6+LIhTH7fihiDUipqB3yoSkKBWaZ3Ejlf5Yag==}
+    engines: {node: ^20.19.0 || >=22.12.0}
+    cpu: [arm]
+    os: [linux]
+
+  '@oxc-parser/binding-linux-arm64-gnu@0.131.0':
+    resolution: {integrity: sha512-OPT8++4aN6j2GJ8+3IZHS/byXoZP4aSBn+FoG6rgBJ2fKwPKXWF3MqrFMNW7NKHM28FLY579xYLxJSfgobEqPA==}
+    engines: {node: ^20.19.0 || >=22.12.0}
+    cpu: [arm64]
+    os: [linux]
+
+  '@oxc-parser/binding-linux-arm64-musl@0.131.0':
+    resolution: {integrity: sha512-vtPiwmfVTAXzaxDKsOXG+LwgRAA7WEnaeHzhS5z0GE89gAK18KSXnly7Z6saXXq6L3dVMyK44uoTI03zKxrpmw==}
+    engines: {node: ^20.19.0 || >=22.12.0}
+    cpu: [arm64]
+    os: [linux]
+
+  '@oxc-parser/binding-linux-ppc64-gnu@0.131.0':
+    resolution: {integrity: sha512-8AW8L7w5cGHSdZPcyZX2yR0+GUODsT15rbRjfdD54rv6DMbtuEB19ysLOpKJlRGfH6UNYNpCHaU1uJWgTWf1/w==}
+    engines: {node: ^20.19.0 || >=22.12.0}
+    cpu: [ppc64]
+    os: [linux]
+
+  '@oxc-parser/binding-linux-riscv64-gnu@0.131.0':
+    resolution: {integrity: sha512-vvpjkjEOUsPcsYf8evE4MO3aGx9+3wodXEBOicGNnOwTuAik8eBONNkgSdhkGsAblQmfVHJyanRnpxglddTXIA==}
+    engines: {node: ^20.19.0 || >=22.12.0}
+    cpu: [riscv64]
+    os: [linux]
+
+  '@oxc-parser/binding-linux-riscv64-musl@0.131.0':
+    resolution: {integrity: sha512-AqmcNC3fClXX+fxQ6VGEN1667xVFiRBkY0CZmDMSiaeFUsv1+UkBPYYi48IUKcA9/ivvoKNRzQl2I4//kT9F/w==}
+    engines: {node: ^20.19.0 || >=22.12.0}
+    cpu: [riscv64]
+    os: [linux]
+
+  '@oxc-parser/binding-linux-s390x-gnu@0.131.0':
+    resolution: {integrity: sha512-7d3jOMKy7RSQCcDLIci+ySll2FgsOMl/GiRux4q2JNv0zg4EdhFISa9idvrdN/HEUIQQJNg6dmveUeJl2YErGA==}
+    engines: {node: ^20.19.0 || >=22.12.0}
+    cpu: [s390x]
+    os: [linux]
+
+  '@oxc-parser/binding-linux-x64-gnu@0.131.0':
+    resolution: {integrity: sha512-JHK/h95qVqVQ+ITER837kcTdwBDFpFaNnOTYGCP0zdUSX/mLKC7tXOoyrTb6vG7iRPwGlcgBil3v2IjYw1FqJA==}
+    engines: {node: ^20.19.0 || >=22.12.0}
+    cpu: [x64]
+    os: [linux]
+
+  '@oxc-parser/binding-linux-x64-musl@0.131.0':
+    resolution: {integrity: sha512-b2BO82O8azXAyf7EUgOPKu145nWypbNyk07HbU09fkzhm9lEA5oPvaN/M8Nlo7tOErVTa2WOgS4QbOnxAPXdDQ==}
+    engines: {node: ^20.19.0 || >=22.12.0}
+    cpu: [x64]
+    os: [linux]
+
+  '@oxc-parser/binding-openharmony-arm64@0.131.0':
+    resolution: {integrity: sha512-GHO9glZaX7LkX/OGfluEPf1yjg+ehiFbUdowbX6uNWOQhmwKWU4m4+nZ9FJkrHNKuxyI1KKertMdGjVKCApKWA==}
+    engines: {node: ^20.19.0 || >=22.12.0}
+    cpu: [arm64]
+    os: [openharmony]
+
+  '@oxc-parser/binding-wasm32-wasi@0.131.0':
+    resolution: {integrity: sha512-3SkikPaEFoih1N83qLVEDLRLeY4nYsf6JT9SnWiMCQ5lGQdKup6bEuKCqkRiG9dD1IIaFeYz9RjlciPmYoFIWA==}
+    engines: {node: ^20.19.0 || >=22.12.0}
+    cpu: [wasm32]
+
+  '@oxc-parser/binding-win32-arm64-msvc@0.131.0':
+    resolution: {integrity: sha512-Os5bEhryeA2jkH+ZrnZyAC1EP5gs+X4YB1Fjqml7UPD5kU7ecsK1MPEVMfCrdt/GDNpDbavYXiOXOdyJ5b3OPw==}
+    engines: {node: ^20.19.0 || >=22.12.0}
+    cpu: [arm64]
+    os: [win32]
+
+  '@oxc-parser/binding-win32-ia32-msvc@0.131.0':
+    resolution: {integrity: sha512-m+jNz9EuF0NXoiptc6B9h5yompZQVW/a5MJeOu5zojfH5yWk82tvF2ccrHkfhgtrS9h9DD5l1Qv8dWlfY7Nz8g==}
+    engines: {node: ^20.19.0 || >=22.12.0}
+    cpu: [ia32]
+    os: [win32]
+
+  '@oxc-parser/binding-win32-x64-msvc@0.131.0':
+    resolution: {integrity: sha512-o14Hk8dAyiEUMFEWEgmAwFZvBt1RzAYLM3xeQ+5315JXgVYhoemivgYcbYVRbsFkS71ShMGlAFE0kPnr460rww==}
+    engines: {node: ^20.19.0 || >=22.12.0}
+    cpu: [x64]
+    os: [win32]
+
+  '@oxc-project/types@0.131.0':
+    resolution: {integrity: sha512-PgnWDfV0h+b16XNKbXU7Daib/BFSt/J2mEzfYIBu6JB/wNdlU+kVYXCkGA1A9fWkTbOgbjh4e6NhPeQOYvFhEA==}
+
+  '@oxc-project/types@0.143.0':
+    resolution: {integrity: sha512-u6JZdLBTLotrNC9Vd6vPssINdzcCzleKAH6EJKImQb7GtYvX5keN2dxkoK44stCc4tffE6QQRtZTXVSzsLUlWA==, tarball: https://registry.npmmirror.com/@oxc-project/types/-/types-0.143.0.tgz}
+
+  '@pkgjs/parseargs@0.11.0':
+    resolution: {integrity: sha512-+1VkjdD0QBLPodGrJUeqarH8VAIvQODIbwh9XpP5Syisf7YoQgsJKPNFoqqLQlu+VQ/tVSshMR6loPMn8U+dPg==}
+    engines: {node: '>=14'}
+
+  '@polka/url@1.0.0-next.29':
+    resolution: {integrity: sha512-wwQAWhWSuHaag8c4q/KN/vCoeOJYshAIvMQwD4GpSb3OiZklFfvAgmj0VCBBImRpuF/aFgIRzllXlVX93Jevww==, tarball: https://registry.npmmirror.com/@polka/url/-/url-1.0.0-next.29.tgz}
+
+  '@quansync/fs@1.0.0':
+    resolution: {integrity: sha512-4TJ3DFtlf1L5LDMaM6CanJ/0lckGNtJcMjQ1NAV6zDmA0tEHKZtxNKin8EgPaVX1YzljbxckyT2tJrpQKAtngQ==}
+
+  '@rolldown/binding-android-arm64@1.2.3':
+    resolution: {integrity: sha512-zrJtHDcaZJ1Fp7xf4hNl+7seH9Cn/N5TwLYkhgXREtBwAd/jaqW3uqeHxpDugJLVICWg4eW44kOQEGJ1r6jCGw==}
+    engines: {node: ^20.19.0 || >=22.12.0}
+    cpu: [arm64]
+    os: [android]
+
+  '@rolldown/binding-darwin-arm64@1.2.3':
+    resolution: {integrity: sha512-ieIiibVCp0tX7TLu2cafoNPv8wJyYi01ekXpbf8q2j7F4rGAhhXb/eQh7ge9DRBY78GwmRQtvjZDux7EDbA8kA==}
+    engines: {node: ^20.19.0 || >=22.12.0}
+    cpu: [arm64]
+    os: [darwin]
+
+  '@rolldown/binding-darwin-x64@1.2.3':
+    resolution: {integrity: sha512-Zh9tCon19eDXJoihx0rqKhMUlMYqzwj3aPsSuHmI4RWZh62dWUL+DJN4C5YQya5TcQBJU/Fe8+rY0jhXTQITqA==}
+    engines: {node: ^20.19.0 || >=22.12.0}
+    cpu: [x64]
+    os: [darwin]
+
+  '@rolldown/binding-freebsd-x64@1.2.3':
+    resolution: {integrity: sha512-nGbJWewA1wrXXZiQhjAT5rhibGfns5ZNkDVqxsO6zJ3f3YvpoDNNmGMSbbhLuXKjNScaBJVOAboztAWVespQMg==}
+    engines: {node: ^20.19.0 || >=22.12.0}
+    cpu: [x64]
+    os: [freebsd]
+
+  '@rolldown/binding-linux-arm-gnueabihf@1.2.3':
+    resolution: {integrity: sha512-QNniJr5Kml0kDEB98jiDOJjXNroxIIi0IXIbdYzY26Xt1pVbeP62+KnoIZLwirOymX/0jDk/2gI/bNUv7A7OIw==}
+    engines: {node: ^20.19.0 || >=22.12.0}
+    cpu: [arm]
+    os: [linux]
+
+  '@rolldown/binding-linux-arm64-gnu@1.2.3':
+    resolution: {integrity: sha512-TkqEAcmmvH3I/q4114NB4RVt6241Dao48pF45uLcFGrwAaIn0iITgTAKP/dLjbN0R4buJjGb91+UHSoFmpgIWw==}
+    engines: {node: ^20.19.0 || >=22.12.0}
+    cpu: [arm64]
+    os: [linux]
+
+  '@rolldown/binding-linux-arm64-musl@1.2.3':
+    resolution: {integrity: sha512-NHqjnxpsndf4MPymxteFAWHHfkTL8HjWh1KB7z23ofZ6QO2euONuxDXjat69dKZRALnGypg8k8SsK8vZJoXv1Q==}
+    engines: {node: ^20.19.0 || >=22.12.0}
+    cpu: [arm64]
+    os: [linux]
+
+  '@rolldown/binding-linux-ppc64-gnu@1.2.3':
+    resolution: {integrity: sha512-6tbrbwfz5GB9DQ4Jwo6hy9v+vR31xZlvzZ6n5Xut6Hhx5PvrA9q/HsK8KMaYQp063iqZGXwNvZtYNLD7EM/x0w==}
+    engines: {node: ^20.19.0 || >=22.12.0}
+    cpu: [ppc64]
+    os: [linux]
+
+  '@rolldown/binding-linux-s390x-gnu@1.2.3':
+    resolution: {integrity: sha512-oyuXxXmoZHjXC917IAPFAAv4wWAa0cM9afk8nx1+9/jNNOX1uPf8yDA6p7G0RypOfw/X0PQt5IfoquY1um+zSg==}
+    engines: {node: ^20.19.0 || >=22.12.0}
+    cpu: [s390x]
+    os: [linux]
+
+  '@rolldown/binding-linux-x64-gnu@1.2.3':
+    resolution: {integrity: sha512-TytMwF2KVGqP2tgd0I1OY0PAv78dZRAYcF5ssDzjM34SUXCED3uXvSd5+lHoC0bTD6eEdFz7LdQNCO1y0oVk9w==}
+    engines: {node: ^20.19.0 || >=22.12.0}
+    cpu: [x64]
+    os: [linux]
+
+  '@rolldown/binding-linux-x64-musl@1.2.3':
+    resolution: {integrity: sha512-/E9m3qstrJFVPoULV25mVQblSNExY2+kBsYe4sy0Tn0yOOgJ8wZbZt3KnRbF/XeU2Gl1STKUQnDNTqhIE5MD4A==}
+    engines: {node: ^20.19.0 || >=22.12.0}
+    cpu: [x64]
+    os: [linux]
+
+  '@rolldown/binding-openharmony-arm64@1.2.3':
+    resolution: {integrity: sha512-Kr0OcsoQI816i6HOl3vFHpd1K0eZyh76zgfj4c1nTyaTsd5r2Mj1lwM4R90y/qaCfmTn9eHy0SKwi98eitRxug==}
+    engines: {node: ^20.19.0 || >=22.12.0}
+    cpu: [arm64]
+    os: [openharmony]
+
+  '@rolldown/binding-win32-arm64-msvc@1.2.3':
+    resolution: {integrity: sha512-hOtMwTqnME+/gJcH/PCZ0wn0zPUjiWOgkHpxbSJpfGKMezHltx1S7/k1SitzVa7Ww2cqrDDaFbZEhcJZO8o+Jw==}
+    engines: {node: ^20.19.0 || >=22.12.0}
+    cpu: [arm64]
+    os: [win32]
+
+  '@rolldown/binding-win32-x64-msvc@1.2.3':
+    resolution: {integrity: sha512-ekcqMMkI2PlhYnfzQnB/cEdYUVVJViWvoUyLrbzgDoi3Snfc1mVBwdnc306ufA5ejy8JSPjT2RlW1nQSjW7efg==}
+    engines: {node: ^20.19.0 || >=22.12.0}
+    cpu: [x64]
+    os: [win32]
+
+  '@rolldown/pluginutils@1.0.1':
+    resolution: {integrity: sha512-2j9bGt5Jh8hj+vPtgzPtl72j0yRxHAyumoo6TNfAjsLB04UtpSvPbPcDcBMxz7n+9CYB0c1GxQFxYRg2jimqGw==, tarball: https://registry.npmmirror.com/@rolldown/pluginutils/-/pluginutils-1.0.1.tgz}
+
+  '@rollup/rollup-android-arm-eabi@4.62.4':
+    resolution: {integrity: sha512-RrPokAb7dmbxFoeO3TloqHyOjgye8RkBhSqmp4aJMIex4c9r46ZstPnleDQOq1t46VOVjwIuwNogIqbodV1Vvg==}
+    cpu: [arm]
+    os: [android]
+
+  '@rollup/rollup-android-arm64@4.62.4':
+    resolution: {integrity: sha512-JKuJc+pnpks2pjy7L/N3v/cAkZxYlnmuZoD840ldbMI5KDbC4iO9NKwPKYdjYFCMAIIlBzYSFHxIJVYzRo2/8A==}
+    cpu: [arm64]
+    os: [android]
+
+  '@rollup/rollup-darwin-arm64@4.62.4':
+    resolution: {integrity: sha512-krw5uS2STmvJ02x0uTXHbqQNuz+9eZ1iw+qXk9dmW2gvV4jV7O2hEoOnuhFrpOPiel1mBFtqbxYZZtC46hXLOw==}
+    cpu: [arm64]
+    os: [darwin]
+
+  '@rollup/rollup-darwin-x64@4.62.4':
+    resolution: {integrity: sha512-wsTxtgApb4PrOsNJIm0FZ1h3WvCC+k9uxLJ4ad75hgoS4NiRes2SoJFlDAyMwiUY8IssDqGcHbXuN0sx1tfF1A==}
+    cpu: [x64]
+    os: [darwin]
+
+  '@rollup/rollup-freebsd-arm64@4.62.4':
+    resolution: {integrity: sha512-GUOnQlyZe3yAXhWOtOMsn5Qkrv5E5mZXa0thbARWi5Ei2szlVXJFQhddZ4HbAzh8q92w5twp+CQvs/eFanz9YQ==}
+    cpu: [arm64]
+    os: [freebsd]
+
+  '@rollup/rollup-freebsd-x64@4.62.4':
+    resolution: {integrity: sha512-/Y7f3QuxjzPKsjA/rfEDa3+0vXqyjmJ50Ln8dPpCmWkKTrUoWHG1cWhTqaAMLob2m2nESWuC7yGrREz019Ztqg==}
+    cpu: [x64]
+    os: [freebsd]
+
+  '@rollup/rollup-linux-arm-gnueabihf@4.62.4':
+    resolution: {integrity: sha512-81wiiX3v7aqy+T+bT61TJ78yJjRquqFFTTbAPt08imfQQzkPIW8t6aJbkTagtCCrXMNc9D66+geqlK7ydLPNqA==}
+    cpu: [arm]
+    os: [linux]
+
+  '@rollup/rollup-linux-arm-musleabihf@4.62.4':
+    resolution: {integrity: sha512-9kmDIvNZqdoHOBZgNtpTBeLWYO/LVipM3H/j62P8848/l/VPEQL6N3uxU9pvP1oZAsXyC2MEnFP3ovRjo7WYNQ==}
+    cpu: [arm]
+    os: [linux]
+
+  '@rollup/rollup-linux-arm64-gnu@4.62.4':
+    resolution: {integrity: sha512-CcnXHWnXg69g+DX5VWL3FHts3qMRN2uVEHX+BZvGLdd07/gXkn3ePjYtO1LDJvxkGKVHMclKBRa1QUTH+6toYQ==}
+    cpu: [arm64]
+    os: [linux]
+
+  '@rollup/rollup-linux-arm64-musl@4.62.4':
+    resolution: {integrity: sha512-iFOibiHnTRuhrWLlRsOQFdZJJIa7S8OwkneJr4ocALP16u5yk6lWLINFwhHaEqBFMsKDUZofLkGos7+CPzGB3g==}
+    cpu: [arm64]
+    os: [linux]
+
+  '@rollup/rollup-linux-loong64-gnu@4.62.4':
+    resolution: {integrity: sha512-XnWYMI7euHlb5a871xPja+Gm7DRCFU+FGRrtS2sMq9N8FvqtpagUy6gD4YOemC5MRk9xbh8+jYMEJbigFQwsgA==}
+    cpu: [loong64]
+    os: [linux]
+
+  '@rollup/rollup-linux-loong64-musl@4.62.4':
+    resolution: {integrity: sha512-qGDAlO0U8xedCcsdRm9oaoQY8DAx/QT7uIxJWhCdx0ceIWX783UC9QSYkdpzAe29wNiVfp24+bZdQmn49o45SQ==}
+    cpu: [loong64]
+    os: [linux]
+
+  '@rollup/rollup-linux-ppc64-gnu@4.62.4':
+    resolution: {integrity: sha512-ru4H6ezD7ysA5EiEK6qkkaEb4modH8CTej6kUy/gQi20u3kB3G7Zn8snXXkeJSCOFKG/rbPPtM/+9Wgas1961w==}
+    cpu: [ppc64]
+    os: [linux]
+
+  '@rollup/rollup-linux-ppc64-musl@4.62.4':
+    resolution: {integrity: sha512-2W4MO5WQVJnbJaZdvDb9rhBDuFU1nKIepPFpJUBsTh2k1YY2g+ODViaWuyOAjQ5cOP7NvrvLzt3wvHOoiAvc7w==}
+    cpu: [ppc64]
+    os: [linux]
+
+  '@rollup/rollup-linux-riscv64-gnu@4.62.4':
+    resolution: {integrity: sha512-+fxjfuoAmVMCYV5QyjoIpu0cp5DOiOTeqYFk1AVaxGr+/ravWLX89XfQmptsoWcaVy/TGf2hexzbUOrCQIL1CQ==}
+    cpu: [riscv64]
+    os: [linux]
+
+  '@rollup/rollup-linux-riscv64-musl@4.62.4':
+    resolution: {integrity: sha512-jTn8JfHGL4djjFxPuM06LmNUJDsst2jeVlsd9OmIH6zc5sC9K6rIuO4YajXatLUpBmBKl6b35ro1QZocLi+tcA==}
+    cpu: [riscv64]
+    os: [linux]
+
+  '@rollup/rollup-linux-s390x-gnu@4.62.4':
+    resolution: {integrity: sha512-oCJCJL4pXsoDcP2QZ+JVlPTIRc6266zsIaeJJsWImmF7HO0W8nb6HuSgZlMWxJwaPf8ehbSw8yo0EUw925hKsA==}
+    cpu: [s390x]
+    os: [linux]
+
+  '@rollup/rollup-linux-x64-gnu@4.62.4':
+    resolution: {integrity: sha512-W69hukhZ3KKNRCaMIEzKvcFye42hh0FE1+YoYaf5+Ikacuftoco6yO/xouz0hc5d5W/s3yBro5jRiuEE/Q5vUw==}
+    cpu: [x64]
+    os: [linux]
+
+  '@rollup/rollup-linux-x64-musl@4.62.4':
+    resolution: {integrity: sha512-qiXbGG2jkjXhzXpsFZSR2Xpb8DN/UaxYsbb/STbuR/6fpaDgRmmaq1B/LmtF2wQFOFOSsK2jdE0RZ3a0zHn4QA==}
+    cpu: [x64]
+    os: [linux]
+
+  '@rollup/rollup-openbsd-x64@4.62.4':
+    resolution: {integrity: sha512-nWeM//hxv8mIo6jD7Hu4o48DVmV9pbV6gsKaWU+4NFyqHoPKwrkRiZGLKUhOBk8qNmDmpwFtPKg80Bo/Tn4xiQ==}
+    cpu: [x64]
+    os: [openbsd]
+
+  '@rollup/rollup-openharmony-arm64@4.62.4':
+    resolution: {integrity: sha512-s62SQ/vgsRSvMwDkOEfTqfgASF0f26ZNaQuTA6Aok5lrikf89yI2W0gFHvZb2Jpgc6N8JnOKZgCK2iciO3CsxQ==}
+    cpu: [arm64]
+    os: [openharmony]
+
+  '@rollup/rollup-win32-arm64-msvc@4.62.4':
+    resolution: {integrity: sha512-J6wGf8TVGbXJq+HH+ttTvrcfNKPbuZecV6KT1B8I18BC5IURUh5kl4Yl5OEP5eFIUoI5BWxCsyYMhFsDx8kekw==}
+    cpu: [arm64]
+    os: [win32]
+
+  '@rollup/rollup-win32-ia32-msvc@4.62.4':
+    resolution: {integrity: sha512-zmfrQd/0wu6oJs8Vq8KwY/YtsKSsLtKe/HwAP4Wqy8LhWjeT55fHRAkOhYQ12wI3ayS4Tt12d5CDRD7N96SAYQ==}
+    cpu: [ia32]
+    os: [win32]
+
+  '@rollup/rollup-win32-x64-gnu@4.62.4':
+    resolution: {integrity: sha512-qPzHqdj9rfUD+w79dtE07zi/kFwKyCJqplp5K5ygeLTp7jLpAoc16OAH39HSmRC9UpozaecsleI8uAdEj6v2yw==}
+    cpu: [x64]
+    os: [win32]
+
+  '@rollup/rollup-win32-x64-msvc@4.62.4':
+    resolution: {integrity: sha512-zD6NdeWEByGE9QF9vCrlJ5YQB4oq9q91kPZS37Jwj5hOkvR1lTBSpsKhKDw4IJtbQ35LsTS1HD9DZYGKIshU1Q==}
+    cpu: [x64]
+    os: [win32]
+
+  '@tiptap/core@3.29.2':
+    resolution: {integrity: sha512-oKUkiPUB7noilVYxI9lNzUD4rX17sHub+PYjMfHMWHG9A3nvIy+FdePIVIIhThKWF7ijhr3eIqHY51Bn+GAFtw==}
+    peerDependencies:
+      '@tiptap/pm': 3.29.2
+
+  '@tiptap/extension-blockquote@3.29.2':
+    resolution: {integrity: sha512-ca4OzKDh0yaxg2+Z56bC2QnWsNsFp2YMRfVig1PDXyMVFMNJpLcnhxgq/9btn+xYAlYrj8RymOeCTYREOR6Zjg==}
+    peerDependencies:
+      '@tiptap/core': 3.29.2
+      '@tiptap/pm': 3.29.2
+
+  '@tiptap/extension-bold@3.29.2':
+    resolution: {integrity: sha512-elYbGxJsYnBb4leqrcjdIJuiG380BcOgN+UUzvOv+qEjfGVzHodFOMBl3qnmD6urYHNu5/qQK2S0qSSRXKCLNQ==}
+    peerDependencies:
+      '@tiptap/core': 3.29.2
+
+  '@tiptap/extension-bubble-menu@3.29.2':
+    resolution: {integrity: sha512-kzcWarcpr031rZu+R3Hzut5uxb3Qj/xxMDEYZIQ3uiq1yb5vEMXj8/SIyWautk6Nu8Rr1leV3rGdR4NzhzyFAA==}
+    peerDependencies:
+      '@tiptap/core': 3.29.2
+      '@tiptap/pm': 3.29.2
+
+  '@tiptap/extension-bullet-list@3.29.2':
+    resolution: {integrity: sha512-3bWcCUPbCHv0XttlMdnAtXLNYWx2pblByMgxmGsaP9FU0QnslGXty6A6gHCqI33ygRg1vrA6U5Wtpwbi5aKu5g==}
+    peerDependencies:
+      '@tiptap/extension-list': 3.29.2
+
+  '@tiptap/extension-code-block@3.29.2':
+    resolution: {integrity: sha512-w153ct8g6dLiPTdXQ6SOIMxX4SEo5Q50AmjdEEEcJ7ZcYUcde/ScSskLHfOYmyt5ZFAiyEwr121+pux+p3/oAQ==}
+    peerDependencies:
+      '@tiptap/core': 3.29.2
+      '@tiptap/pm': 3.29.2
+
+  '@tiptap/extension-code@3.29.2':
+    resolution: {integrity: sha512-c6W5UGuB7WNLpYocsgRzpO2OOTI4QjaI9jjHRMuty9z+s9DtaYM/HrRLNwVh6MopkHb+i/89Wkv8gCS34fftig==}
+    peerDependencies:
+      '@tiptap/core': 3.29.2
+
+  '@tiptap/extension-document@3.29.2':
+    resolution: {integrity: sha512-YUamvefLnsqu6124GavVTI7nqcFlQJ12ROB0oSwG69eSBZYNjg1tIs05LFrBxkwf4Xgqd6YzfJ9+FeG428RvzQ==}
+    peerDependencies:
+      '@tiptap/core': 3.29.2
+
+  '@tiptap/extension-dropcursor@3.29.2':
+    resolution: {integrity: sha512-KKno7cU9r1HdR48CRrsDu69/1UjZdoslq/UcE+Kx+tdhAv/aljXMkRSNzGMrBNOBDmHRgS1+58zm21WQWdQzwA==}
+    peerDependencies:
+      '@tiptap/extensions': 3.29.2
+
+  '@tiptap/extension-floating-menu@3.29.2':
+    resolution: {integrity: sha512-CBTq4Xs5aGWr65uFCIkKBms796OhmirWf/ax//iJ4fl9IfwqjwFuc2vQs9PmuwpKn9ctDHo2sMTtvyeCvIt5LQ==}
+    peerDependencies:
+      '@floating-ui/dom': ^1.0.0
+      '@tiptap/core': 3.29.2
+      '@tiptap/pm': 3.29.2
+
+  '@tiptap/extension-font-family@3.29.2':
+    resolution: {integrity: sha512-HDq9+V8LbDFH1aQRH5Au0pmoDQ7bfa/C/k50a9mujzmA/PE7mLQkduUFfyDdiN4L60p7TVJAOJaN/loGC8PDxA==}
+    peerDependencies:
+      '@tiptap/extension-text-style': 3.29.2
+
+  '@tiptap/extension-gapcursor@3.29.2':
+    resolution: {integrity: sha512-8Q39UR4/Tit759IeW9xZIe3NMwN11GsuA3FLheDyyGn7RrW02HD3HhUDlazE54Ki4HoosjFmChPlN4Ik2ubdRQ==}
+    peerDependencies:
+      '@tiptap/extensions': 3.29.2
+
+  '@tiptap/extension-hard-break@3.29.2':
+    resolution: {integrity: sha512-eUW3LN3fq8rXnjEUeI3D2QONYdLsU3yYQm4jxlErs2h4cfwrFjgf19VSUFVmm6LrFbbQ0OnDVPeVLL6iOwDw2w==}
+    peerDependencies:
+      '@tiptap/core': 3.29.2
+
+  '@tiptap/extension-heading@3.29.2':
+    resolution: {integrity: sha512-6W4aIy70Mh7BNlbG9zZ5FBLhJhU2UUEzgZJ/jwYSCcB30o8McLxJSEjhtoHiX8R78Ah2/JzBGvIe5olZlbeE4A==}
+    peerDependencies:
+      '@tiptap/core': 3.29.2
+
+  '@tiptap/extension-horizontal-rule@3.29.2':
+    resolution: {integrity: sha512-8/ZPzbB9X85Mc9/7xVLZupQKBr2UVcQTGr512xtqMW+XkCQRHCph46tRo828YE13IMWI5fWn/FaNCqXG9cULSw==}
+    peerDependencies:
+      '@tiptap/core': 3.29.2
+      '@tiptap/pm': 3.29.2
+
+  '@tiptap/extension-italic@3.29.2':
+    resolution: {integrity: sha512-iH63V/5wsaMnY4Jz0+meaAGhaec4AiOzOduzl6ZZr5IyGhZ1kthyW84ELt0dyLI3hNceAUhaNWc+I7+vX0aoXA==}
+    peerDependencies:
+      '@tiptap/core': 3.29.2
+
+  '@tiptap/extension-link@3.29.2':
+    resolution: {integrity: sha512-DcVer5SqrexKCEP6Ip1UPxJUMvcRCCItSv0wxoGytanrimBh2smvcg6X0DWnjlsi5H0updhyl+atYCmmQXUIXA==}
+    peerDependencies:
+      '@tiptap/core': 3.29.2
+      '@tiptap/pm': 3.29.2
+
+  '@tiptap/extension-list-item@3.29.2':
+    resolution: {integrity: sha512-s8vBVHHFT0Qpu7CzAZ7S1kYmSiVaDvUNvMNcZUWnxj6VPfiwmx0eXd9FsjePrRCMoM5tFmPnhFTHDxY3D/eZeQ==}
+    peerDependencies:
+      '@tiptap/extension-list': 3.29.2
+
+  '@tiptap/extension-list-keymap@3.29.2':
+    resolution: {integrity: sha512-R+3k8OLnxdCH7Xy9ieOwUt5m2Je74u8mikothGmsYVO2Zyq48fIbmZ+X6RBPCu7DBOI2FIUhHEFbKQeDWvDNmA==}
+    peerDependencies:
+      '@tiptap/extension-list': 3.29.2
+
+  '@tiptap/extension-list@3.29.2':
+    resolution: {integrity: sha512-WPZ9BHAPT6QeIm1vdVkuoOWvy9a8/EZeJwV2VhU8LXyTAttvzyj4rsbbHyJWvYWlUSTt/QF2AZ2zhKo7u1w3/A==}
+    peerDependencies:
+      '@tiptap/core': 3.29.2
+      '@tiptap/pm': 3.29.2
+
+  '@tiptap/extension-ordered-list@3.29.2':
+    resolution: {integrity: sha512-ndCunC+UsYOpkOtL7vGnDz21UNa45WUlcO9wMT1fbuYow2QnRhsuMlCWENXI52YPPARWuQ0RDgN7q6TaxPERBg==}
+    peerDependencies:
+      '@tiptap/extension-list': 3.29.2
+
+  '@tiptap/extension-paragraph@3.29.2':
+    resolution: {integrity: sha512-7qJj5YTr11vvjNgjDN1ypOfwTovc0QOCYcit/rskeuVgnmQZOZQzC/BbyKLLG7UGnpRLemU/mEGbW9pAqjAXkQ==}
+    peerDependencies:
+      '@tiptap/core': 3.29.2
+
+  '@tiptap/extension-strike@3.29.2':
+    resolution: {integrity: sha512-aEvLAbddUQZ+FukCreV3q4G2HfNI+odE7E9U+wbq6XsSWKyo8/pDu1muz+TFKNre4blSMOQ3JQmw5UeHDKy+fg==}
+    peerDependencies:
+      '@tiptap/core': 3.29.2
+
+  '@tiptap/extension-text-style@3.29.2':
+    resolution: {integrity: sha512-aQad9V9ROaEi3hE4g5z9wQ6lv5FSnzlnWFMVJxRjNlwXgm7H0fymxb4rGfca+pAwYkiRwpKYh1LatpJw2ECQAA==}
+    peerDependencies:
+      '@tiptap/core': 3.29.2
+
+  '@tiptap/extension-text@3.29.2':
+    resolution: {integrity: sha512-Ubko45JWWHe8glBt2PiGNF8hcbys/JNalFhiR7Y1X4iOOtAxAKJJxh3+eq+//NTlGuBPdWGp7zw8EEUp7anjKA==}
+    peerDependencies:
+      '@tiptap/core': 3.29.2
+
+  '@tiptap/extension-underline@3.29.2':
+    resolution: {integrity: sha512-K7XwH/xS/5AIREWQ00VTEf/W5U0olp7j6wwit7cdd/8nHv6h6AGr1+iEApHKoLXWQZLfGQKzJlT9W61LAl+fHA==}
+    peerDependencies:
+      '@tiptap/core': 3.29.2
+
+  '@tiptap/extensions@3.29.2':
+    resolution: {integrity: sha512-BCz+FCAChSYtUe4BFj97HEO+nSK+J7GxbJgZG4Hg7DT/gI+hRyeNndU8efiQAx3WGdzsFi3UxRpcF1tTQM7iMQ==}
+    peerDependencies:
+      '@tiptap/core': 3.29.2
+      '@tiptap/pm': 3.29.2
+
+  '@tiptap/pm@3.29.2':
+    resolution: {integrity: sha512-GCOme7xHaS+DSoaA4CDcAD3l6JyBlvZhvCyfsy2Vp6j8tEoBkZWio7soYVosmlyn7zq8/64VeFZP5s47yfG7fQ==}
+
+  '@tiptap/starter-kit@3.29.2':
+    resolution: {integrity: sha512-oTu0tysiqk4zgjEtxRHjAQgxUKaAevZwueOWwSWubHdokqp7SpcbE5n9USJv89HKuTUDm3GjnQH6q8HNn/2DsA==}
+
+  '@tiptap/vue-3@3.29.2':
+    resolution: {integrity: sha512-rLX+V+HXbsVlk+My8mslvbnbVXZiQZHYtbOiRgxugsqZ9SK1mr1FpgZ/ZNcotJAjecT8FJmPa45ccDnVu66eGA==}
+    peerDependencies:
+      '@floating-ui/dom': ^1.0.0
+      '@tiptap/core': 3.29.2
+      '@tiptap/pm': 3.29.2
+      vue: ^3.0.0
+
+  '@tsconfig/node24@24.0.4':
+    resolution: {integrity: sha512-2A933l5P5oCbv6qSxHs7ckKwobs8BDAe9SJ/Xr2Hy+nDlwmLE1GhFh/g/vXGRZWgxBg9nX/5piDtHR9Dkw/XuA==, tarball: https://registry.npmmirror.com/@tsconfig/node24/-/node24-24.0.4.tgz}
+
+  '@tybys/wasm-util@0.10.3':
+    resolution: {integrity: sha512-F3fo1MYrRJYL3zER0OUOmkutjr1Vp23m7OsSgp7nq4SP6OqX6C/56XFIPAl5bt3zaBRjmW7SGz3u/6LwFpYcOg==}
+
+  '@types/chai@5.2.3':
+    resolution: {integrity: sha512-Mw558oeA9fFbv65/y4mHtXDs9bPnFMZAL/jxdPFUpOHHIXX91mcgEHbS5Lahr+pwZFR8A7GQleRWeI6cGFC2UA==}
+
+  '@types/deep-eql@4.0.2':
+    resolution: {integrity: sha512-c9h9dVVMigMPc4bwTvC5dxqtqJZwQPePsWjPlpSOnojbor6pGqdk541lfA7AqFQr5pB1BRdq0juY9db81BwyFw==}
+
+  '@types/estree@1.0.9':
+    resolution: {integrity: sha512-GhdPgy1el4/ImP05X05Uw4cw2/M93BCUmnEvWZNStlCzEKME4Fkk+YpoA5OiHNQmoS7Cafb8Xa3Pya8m1Qrzeg==}
+
+  '@types/lodash-es@4.17.12':
+    resolution: {integrity: sha512-0NgftHUcV4v34VhXm8QBSftKVXtbkBG3ViCjs6+eJ5a6y6Mi/jiFGPc1sC7QK+9BFhWrURE3EOggmWaSxL9OzQ==, tarball: https://registry.npmmirror.com/@types/lodash-es/-/lodash-es-4.17.12.tgz}
+
+  '@types/lodash@4.17.25':
+    resolution: {integrity: sha512-+K1NIO8I+F9/wNulfVvu23QYd0Pe9/OCqRrim4NoYIf1VoEDL90Ve4ClzpyqBLc7NpGGWRvYNCKZ1BE/Jpf8dQ==, tarball: https://registry.npmmirror.com/@types/lodash/-/lodash-4.17.25.tgz}
+
+  '@types/node@24.13.3':
+    resolution: {integrity: sha512-Dh8vAsV36ig5wa9OX4pXvMc9D3Veibfw2wix0CUwYODLD8nkj9UsLjASr49nPg+2eKzxhBV+v7L8pXvT4e639Q==, tarball: https://registry.npmmirror.com/@types/node/-/node-24.13.3.tgz}
+
+  '@types/pako@2.0.4':
+    resolution: {integrity: sha512-VWDCbrLeVXJM9fihYodcLiIv0ku+AlOa/TQ1SvYOaBuyrSKgEcro95LJyIsJ4vSo6BXIxOKxiJAat04CmST9Fw==}
+
+  '@types/qrcode@1.5.6':
+    resolution: {integrity: sha512-te7NQcV2BOvdj2b1hCAHzAoMNuj65kNBMz0KBaxM6c3VGBOhU0dURQKOtH8CFNI/dsKkwlv32p26qYQTWoB5bw==}
+
+  '@types/raf@3.4.3':
+    resolution: {integrity: sha512-c4YAvMedbPZ5tEyxzQdMoOhhJ4RD3rngZIdwC2/qDN3d7JpEhB6fiBRKVY1lg5B7Wk+uPBjn5f39j1/2MY1oOw==}
+
+  '@types/trusted-types@2.0.7':
+    resolution: {integrity: sha512-ScaPdn1dQczgbl0QFTeTOmVHFULt394XJgOQNoyVhZ6r2vLnMLJfBPd53SB52T/3G36VI1/g2MZaX0cwDuXsfw==}
+
+  '@types/web-bluetooth@0.0.21':
+    resolution: {integrity: sha512-oIQLCGWtcFZy2JW77j9k8nHzAOpqMHLQejDA48XXMWH6tjCQHz5RCFz1bzsmROyL6PUm+LLnUiI4BCn221inxA==}
+
+  '@types/whatwg-mimetype@3.0.2':
+    resolution: {integrity: sha512-c2AKvDT8ToxLIOUlN51gTiHXflsfIFisS4pO7pDPoKouJCESkhZnEy623gwP9laCy5lnLDAw1vAzu2vM2YLOrA==}
+
+  '@types/ws@8.18.1':
+    resolution: {integrity: sha512-ThVF6DCVhA8kUGy+aazFQ4kXQ7E1Ty7A3ypFOe0IcJV8O/M511G99AW24irKrW56Wt44yG9+ij8FaqoBGkuBXg==}
+
+  '@unocss/cli@66.7.5':
+    resolution: {integrity: sha512-fgWkECRn2LGVo9sEpmjk/KJ3NSKUDitaZCNrJcEYM93DG+ELriTHcL+VWBlF4rcZf9fdGlq1nKbbRHUZirFCHQ==}
+    hasBin: true
+
+  '@unocss/config@66.7.5':
+    resolution: {integrity: sha512-dkPl9glhEahJ+Xoja5ZseKKnH+vZaeaKQzg8b0otcKcPPNrHQgu1nu3QgfeOjnXOGrjZIotHwUeVtt4ZA2Skgg==}
+
+  '@unocss/core@66.7.5':
+    resolution: {integrity: sha512-UdJb8MiMywcau8QrWEVgUAz0kvoFHyR+sACwYCgmBh/BpKJGyR/zw/Ys3wvysbm0f+i/20VGBex/QQxYVlzdyQ==}
+
+  '@unocss/extractor-arbitrary-variants@66.7.5':
+    resolution: {integrity: sha512-5zOkbnLIJc8E749qNjLXfPHl3FdHloop12h706/ojr6idK4ix0KLm43R//uLnphixCehdHJRuHnavnM4C/kQbA==}
+
+  '@unocss/inspector@66.7.5':
+    resolution: {integrity: sha512-WmTJMnj8bmRxvw/wGeShmL2eEHr2/L0BdGTXSxhfzwcO8y5XZEbBmVciLcM7pqaTXQ6JY4+KnITrDUf1urjZxQ==}
+
+  '@unocss/preset-attributify@66.7.5':
+    resolution: {integrity: sha512-1Oi1Cp81pqYJwG3h4+OlP5A0FKyaa07MFBXaXc4Yr3faiTbsI8SKj2TqnZCb+NQvBsEqslEd+jKXGZ3lKzCVOQ==}
+
+  '@unocss/preset-icons@66.7.5':
+    resolution: {integrity: sha512-ZsxadWnGGtHdANTikuMnjkQaT1qwUFJHZBF4fzVsPMnUiiKGs8rzXukwM9w3Gi9ontM7nbG2FYi9clWETSlpFg==}
+
+  '@unocss/preset-mini@66.7.5':
+    resolution: {integrity: sha512-o37TSl4ecT0dKu+3/TYuTYht75h82SEwDNl476m9ve0KW4Pv1O2tT/9TWd7N5cutEpySr8/YtjMwtWBD+drxBg==}
+
+  '@unocss/preset-tagify@66.7.5':
+    resolution: {integrity: sha512-/8YB1tXVi+WmNKPhsCdtO1xnQKEkshSnWDp6AbvVP3f6qOF7adlMYpAt3kpWCoVUBsfOQ06ZQlnfricMjObyoQ==}
+
+  '@unocss/preset-typography@66.7.5':
+    resolution: {integrity: sha512-2dxC8LT9KYa29UZT4muDFl7DbIXvKktTfeSMbUGMdZKbHcuMtKSP2U52wti1PL5I9duqp4v+8G33EeVutGTUaQ==}
+
+  '@unocss/preset-uno@66.7.5':
+    resolution: {integrity: sha512-zaUlYgNngbt50fZA/LbtsEnmPKojPqeiXCyUUiKQMv2uJQhncR32xhLZXVQ+TJD7hlfZ+6FAqlco1NIiAcub9w==}
+
+  '@unocss/preset-web-fonts@66.7.5':
+    resolution: {integrity: sha512-OLLTK7kswdSu51qxEm6O+AehecgCfS08Ivqo+280lKzFW7V1jXr5okeJ1ty+85oHCprJqzcD9iG1khxNRLomcA==}
+
+  '@unocss/preset-wind3@66.7.5':
+    resolution: {integrity: sha512-atFe/7Qein+oMdyZs0hEo+3EjV99Av2LVxDbzpCungxIfbS3TnQt70EIuHXMPNCVWLYwrMV+/P1n9Ntb0E3mow==}
+
+  '@unocss/preset-wind4@66.7.5':
+    resolution: {integrity: sha512-n3jIvQv8x1jXpmWfvNFBIqHNARki4mKZXfxAA31gekpXsRRTg16u1+yC1+PBBJgoEDFEnnmKnG7EZP88S8LVXA==}
+
+  '@unocss/preset-wind@66.7.5':
+    resolution: {integrity: sha512-LVKgGr0A9Lc7F85xGXrrb71DDXMlHGA8bcj/Kht8BCsuRdBZadNbLlnv5qnSJiHYhi3/blzcgVoaeRor6L9yNA==}
+
+  '@unocss/rule-utils@66.7.5':
+    resolution: {integrity: sha512-/AKHBRF6ZOexE3EDDv8ZEYh40P5e2Eha41IYUbE1wjigW7++ssmvimSTdufJzZvU5DGP++E3B3WEsFPprZMjAg==}
+
+  '@unocss/transformer-attributify-jsx@66.7.5':
+    resolution: {integrity: sha512-r8qDwNSt0eGSwWws3xsuIHb3PZYR2embFdYoE67hD/xlYgLjX1uPy/HUlGCSSh4uLc4vVYjurr0Oq5xF/B8YiA==}
+
+  '@unocss/transformer-compile-class@66.7.5':
+    resolution: {integrity: sha512-KuECgsGF7tGe808vIvKViEjI0UCUgYgneJfK+/TWBkjC7s8dLVaUtJzzcP9/r6OfGlgyn/x1YTdRqTaCENa7Xg==}
+
+  '@unocss/transformer-directives@66.7.5':
+    resolution: {integrity: sha512-VMJApXXOwlDubkW+cNMmOkfxLefFupJr+yU23gGYUB2NPsuVltc8H5CDM0gfVebpeL5CUW05evxzEAk2wsju+Q==}
+
+  '@unocss/transformer-variant-group@66.7.5':
+    resolution: {integrity: sha512-iDmP3mM8J+IxuQf5Uh33zsi528xnGxTpKRJ0c+LCrqBTTkR2tZr4aCzNmJ0g29Js2yEOsyNXRRc8BNTuvgn0AA==}
+
+  '@unocss/vite@66.7.5':
+    resolution: {integrity: sha512-1z1TBCNJCR2WzjPtjzmCHr8rtzXHosMjLdsCNe6Mzsfwiw044gzzLVuiEZO9vIjkI50lvQ+gIOxOiVQG0hGAeA==}
+    peerDependencies:
+      vite: ^5.0.0-0 || ^6.0.0-0 || ^7.0.0-0 || ^8.0.0-0
+
+  '@vitejs/plugin-vue@6.0.8':
+    resolution: {integrity: sha512-0ZjgOg7oO6farnNGup7yvoM/YXZV84OZxHAwtflItNa/6zzQyVb5LNxyea3FEKEX2XlagIKzrlH7wwxkKgtiew==, tarball: https://registry.npmmirror.com/@vitejs/plugin-vue/-/plugin-vue-6.0.8.tgz}
+    engines: {node: ^20.19.0 || >=22.12.0}
+    peerDependencies:
+      vite: ^5.0.0 || ^6.0.0 || ^7.0.0 || ^8.0.0
+      vue: ^3.2.25
+
+  '@vitest/coverage-v8@3.2.7':
+    resolution: {integrity: sha512-NEGWJS2XNu2PfRLQwOO3CTKj1tTETxNBdk454vDxVBhxJYhPaA/eS0nAI0c+1El1P7a60z8+i+ZrQoGESweGKg==}
+    peerDependencies:
+      '@vitest/browser': 3.2.7
+      vitest: 3.2.7
+    peerDependenciesMeta:
+      '@vitest/browser':
+        optional: true
+
+  '@vitest/expect@3.2.7':
+    resolution: {integrity: sha512-E8eBXaKibuvH2pSZErOjdVb5vF4PbKYcrnluBTYxEk1l/VhhwZg1kZQsdtjq+CsF5CFydf2Rdkz7jDHKSisi3w==}
+
+  '@vitest/mocker@3.2.7':
+    resolution: {integrity: sha512-Trr0hYO9CM3Wj6ksWHRhK9IZpIY6wTMO5u/MqXurMxT57sWBaOPEtP3Oq60ihZuh5JsiagKfz95OcxdEP6dBrA==}
+    peerDependencies:
+      msw: ^2.4.9
+      vite: ^5.0.0 || ^6.0.0 || ^7.0.0-0
+    peerDependenciesMeta:
+      msw:
+        optional: true
+      vite:
+        optional: true
+
+  '@vitest/pretty-format@3.2.7':
+    resolution: {integrity: sha512-KUHlwqVu0sRlhCdyPdQ/wBoTfRahjUky1MubOmYw9fWfIZy1gNoHpuaaQBPAaMaVYdQYHJLurzj8ECCj5OwTqA==}
+
+  '@vitest/runner@3.2.7':
+    resolution: {integrity: sha512-sB9y4ovltoQP+WaUPwmSxO9WIg9Ig694Di5PalVPsYHklAdE027mehpWF2SQSVq+k6sFgaivbTjTJwZLSHbedA==}
+
+  '@vitest/snapshot@3.2.7':
+    resolution: {integrity: sha512-7C+MwShwtBSI5Buwoyg3s/iY1eHL9PKAf+O1wVh/TdnjXUtkoL/9YQtre90i4MtNXM6edP1wJ2zOBpfCyhIS7g==}
+
+  '@vitest/spy@3.2.7':
+    resolution: {integrity: sha512-Q2eQGI6d2L/hBtZ0qNuKcAGid68XK6cv1xsoaIma6PaJhHPoqcEJhYpXZ/5myCMqkNgtP6UKuBhbc0nHKnrkuQ==}
+
+  '@vitest/utils@3.2.7':
+    resolution: {integrity: sha512-x6BDOd7dyo3PFLY3I9/HJ25X/6OurhGXk2/B9gOZNPF7XDVjeBK4k01lQE5uvDpbuheErh91qYuE1E2OEjK3Rw==}
+
+  '@volar/language-core@2.4.28':
+    resolution: {integrity: sha512-w4qhIJ8ZSitgLAkVay6AbcnC7gP3glYM3fYwKV3srj8m494E3xtrCv6E+bWviiK/8hs6e6t1ij1s2Endql7vzQ==, tarball: https://registry.npmmirror.com/@volar/language-core/-/language-core-2.4.28.tgz}
+
+  '@volar/source-map@2.4.28':
+    resolution: {integrity: sha512-yX2BDBqJkRXfKw8my8VarTyjv48QwxdJtvRgUpNE5erCsgEUdI2DsLbpa+rOQVAJYshY99szEcRDmyHbF10ggQ==, tarball: https://registry.npmmirror.com/@volar/source-map/-/source-map-2.4.28.tgz}
+
+  '@volar/typescript@2.4.28':
+    resolution: {integrity: sha512-Ja6yvWrbis2QtN4ClAKreeUZPVYMARDYZl9LMEv1iQ1QdepB6wn0jTRxA9MftYmYa4DQ4k/DaSZpFPUfxl8giw==, tarball: https://registry.npmmirror.com/@volar/typescript/-/typescript-2.4.28.tgz}
+
+  '@vue/babel-helper-vue-transform-on@1.5.0':
+    resolution: {integrity: sha512-0dAYkerNhhHutHZ34JtTl2czVQHUNWv6xEbkdF5W+Yrv5pCWsqjeORdOgbtW2I9gWlt+wBmVn+ttqN9ZxR5tzA==, tarball: https://registry.npmmirror.com/@vue/babel-helper-vue-transform-on/-/babel-helper-vue-transform-on-1.5.0.tgz}
+
+  '@vue/babel-plugin-jsx@1.5.0':
+    resolution: {integrity: sha512-mneBhw1oOqCd2247O0Yw/mRwC9jIGACAJUlawkmMBiNmL4dGA2eMzuNZVNqOUfYTa6vqmND4CtOPzmEEEqLKFw==, tarball: https://registry.npmmirror.com/@vue/babel-plugin-jsx/-/babel-plugin-jsx-1.5.0.tgz}
+    peerDependencies:
+      '@babel/core': ^7.0.0-0
+    peerDependenciesMeta:
+      '@babel/core':
+        optional: true
+
+  '@vue/babel-plugin-resolve-type@1.5.0':
+    resolution: {integrity: sha512-Wm/60o+53JwJODm4Knz47dxJnLDJ9FnKnGZJbUUf8nQRAtt6P+undLUAVU3Ha33LxOJe6IPoifRQ6F/0RrU31w==, tarball: https://registry.npmmirror.com/@vue/babel-plugin-resolve-type/-/babel-plugin-resolve-type-1.5.0.tgz}
+    peerDependencies:
+      '@babel/core': ^7.0.0-0
+
+  '@vue/compiler-core@3.5.41':
+    resolution: {integrity: sha512-q0Xtv/F9w2YO/7htQhtiL+Ev2WCJbe5N2hc+XfgyKkEKqWpSxknmT8QOuGdEKNdjPq0c3F7rNpFkTo3Kfrm7pg==, tarball: https://registry.npmmirror.com/@vue/compiler-core/-/compiler-core-3.5.41.tgz}
+
+  '@vue/compiler-dom@3.5.41':
+    resolution: {integrity: sha512-oKacVfNglLvGjnS6BXOlGL7EyG2h8X03pqXCjzotRZUaXGjbrTJUnVAQjrCqUnS+lyu31nwQjZY/d817GmCnfw==, tarball: https://registry.npmmirror.com/@vue/compiler-dom/-/compiler-dom-3.5.41.tgz}
+
+  '@vue/compiler-sfc@3.5.41':
+    resolution: {integrity: sha512-XJhip7R2wy6vX3knCxdZN4KracFaZUef58s1KYewqluedHIJaPIVfXoYT7MF1F8nCvv6k8bWWxDC8opMkg1VTQ==, tarball: https://registry.npmmirror.com/@vue/compiler-sfc/-/compiler-sfc-3.5.41.tgz}
+
+  '@vue/compiler-ssr@3.5.41':
+    resolution: {integrity: sha512-U3v5OejKEGqOI0Wy0+Sz7hGuIFZHA4LSXzrNM3IMIeDyJEBBfTpX26n3SDgToRpP2bLc9FfI2j/kSgcJ8Emq5A==, tarball: https://registry.npmmirror.com/@vue/compiler-ssr/-/compiler-ssr-3.5.41.tgz}
+
+  '@vue/devtools-api@8.2.1':
+    resolution: {integrity: sha512-6u4vXBlIBAC1wMplIZgpyPn7uh/s4Bf6F5bMzvLv+EdJ0aHs/+4B7Ygv864EStQSjRbsRzTko/kUG1A1IejQ3A==}
+
+  '@vue/devtools-core@8.2.1':
+    resolution: {integrity: sha512-s/VfAY9oDTb/kFEWmy461jaFde2MIV1RO/gi1vwM+PAZBZ/Pc2Ndu3BNBdZUze8QDUuyYvElbEEGA83syjJfzA==, tarball: https://registry.npmmirror.com/@vue/devtools-core/-/devtools-core-8.2.1.tgz}
+    peerDependencies:
+      vue: ^3.0.0
+
+  '@vue/devtools-kit@8.2.1':
+    resolution: {integrity: sha512-FIGIuq3AWReEpbAHY/cRGeHDfI0qOb8OCQ3YjbEAX04uaxIDbGc9rhkbVcG7rnfHPXE3RsU5KrWOu9V/okd8AQ==, tarball: https://registry.npmmirror.com/@vue/devtools-kit/-/devtools-kit-8.2.1.tgz}
+
+  '@vue/devtools-shared@8.2.1':
+    resolution: {integrity: sha512-Fkac7lUdGReh6pVOi3AYPRGe82LQqRmAfThW7RRligOAP0ZA/Z1z9XLHDM9dv34pV2HRc79DK8uKPeG2fLnA/g==, tarball: https://registry.npmmirror.com/@vue/devtools-shared/-/devtools-shared-8.2.1.tgz}
+
+  '@vue/language-core@3.3.9':
+    resolution: {integrity: sha512-in/68oAa4BCtVY6n/nkuhLIkV8DHYd2UivedJ6cMZ6UYtlq9jaoaSNUBHYCVO44z3nKg7MdE5OBoHKt5SxeBKQ==, tarball: https://registry.npmmirror.com/@vue/language-core/-/language-core-3.3.9.tgz}
+
+  '@vue/reactivity@3.5.41':
+    resolution: {integrity: sha512-rznsqKM0np0x18EjzF8x88MpEhdNsffbvFbckLL5+oUKz1BxAImEmO7J1ArRYSyo6aQaVoBDp7jEkT91OOxydA==, tarball: https://registry.npmmirror.com/@vue/reactivity/-/reactivity-3.5.41.tgz}
+
+  '@vue/runtime-core@3.5.41':
+    resolution: {integrity: sha512-Vcry58hiAKwGen9Z1jUZE0feFsNArPCMOImYI8el48A9Idf6DuQYD0U05zZIF2Iad1hGhPSvcbBbAOhNr55fhg==, tarball: https://registry.npmmirror.com/@vue/runtime-core/-/runtime-core-3.5.41.tgz}
+
+  '@vue/runtime-dom@3.5.41':
+    resolution: {integrity: sha512-3vVBahVBS9+U6cmXBLyb8nE6/yYo4J/CGI9eVFs3KiMc0YHuudwKyShTD65jtJy/L9PUUxNAFu4cj4LiJ0UFbw==, tarball: https://registry.npmmirror.com/@vue/runtime-dom/-/runtime-dom-3.5.41.tgz}
+
+  '@vue/server-renderer@3.5.41':
+    resolution: {integrity: sha512-n6hx/pNFfbD6SuyeuMVkvqox8bwf/ET9JlA/kAz/imw8sw++wkqKe2mHX5KutjPpbKE4Z56yTHszoOjGMI9igQ==, tarball: https://registry.npmmirror.com/@vue/server-renderer/-/server-renderer-3.5.41.tgz}
+
+  '@vue/shared@3.5.41':
+    resolution: {integrity: sha512-IOnwSCma8j+9xJT6b8H0dEYidC80NsYmNMlZxRsukYcSoGaDBohog5hDxzeUXdFeGWFA++vWvxqOmrr96VlqMA==, tarball: https://registry.npmmirror.com/@vue/shared/-/shared-3.5.41.tgz}
+
+  '@vue/tsconfig@0.9.1':
+    resolution: {integrity: sha512-buvjm+9NzLCJL29KY1j1991YYJ5e6275OiK+G4jtmfIb+z4POywbdm0wXusT9adVWqe0xqg70TbI7+mRx4uU9w==, tarball: https://registry.npmmirror.com/@vue/tsconfig/-/tsconfig-0.9.1.tgz}
+    peerDependencies:
+      typescript: '>= 5.8'
+      vue: ^3.4.0
+    peerDependenciesMeta:
+      typescript:
+        optional: true
+      vue:
+        optional: true
+
+  '@vueuse/core@14.4.0':
+    resolution: {integrity: sha512-X4WHz1HlCzCBoYXesUkifzzWBAcZgXG8Fi5iNPQg/epdzOB3gu8Fawj3hvuwYR1nGcXGnvxwYYcUC/71++svtQ==}
+    peerDependencies:
+      vue: ^3.5.0
+
+  '@vueuse/metadata@14.4.0':
+    resolution: {integrity: sha512-swx/255R6JyHZFJhx845iz5CRWDZdCfvkZOpACWc5+c5WHcG24mv8gUT1WIdFQaHt6dq79rvILd9QnCWiyVm9g==}
+
+  '@vueuse/shared@14.4.0':
+    resolution: {integrity: sha512-JRgY90Sz8DDtPMsaDflvPMp9xYk69JZAmbuDvAquUVXKr2gEjqtzGNTTthLfckH0BzBqvnu31gb4a8TGLRe79g==}
+    peerDependencies:
+      vue: ^3.5.0
+
+  acorn@8.18.0:
+    resolution: {integrity: sha512-lGq+9yr1/GuAWaVYIHRjvvySG5/4VfKIvC8EWxStPdcDh/Ka7FG3twP6v4d5BkravUilhIAsG4Qj83t02LWUPQ==, tarball: https://registry.npmmirror.com/acorn/-/acorn-8.18.0.tgz}
+    engines: {node: '>=0.4.0'}
+    hasBin: true
+
+  adler-32@1.3.1:
+    resolution: {integrity: sha512-ynZ4w/nUUv5rrsR8UUGoe1VC9hZj6V5hU9Qw1HlMDJGEJw5S7TfTErWTjMys6M7vr0YWcPqs3qAr4ss0nDfP+A==}
+    engines: {node: '>=0.8'}
+
+  agent-base@7.1.4:
+    resolution: {integrity: sha512-MnA+YT8fwfJPgBx3m60MNqakm30XOkyIoH1y6huTQvC0PwZG7ki8NacLBcrPbNoo8vEZy7Jpuk7+jMO+CUovTQ==}
+    engines: {node: '>= 14'}
+
+  ajv@8.20.0:
+    resolution: {integrity: sha512-Thbli+OlOj+iMPYFBVBfJ3OmCAnaSyNn4M1vz9T6Gka5Jt9ba/HIR56joy65tY6kx/FCF5VXNB819Y7/GUrBGA==}
+
+  alien-signals@3.2.1:
+    resolution: {integrity: sha512-I8FjmltrfnDFoZedi5CG8DghVYNhzb/Ijluz7tCSJH0xpd0484Kowhbb1XDYOxfJpU1p5wnM2X54dA+IfGyD1g==, tarball: https://registry.npmmirror.com/alien-signals/-/alien-signals-3.2.1.tgz}
+
+  ansi-regex@5.0.1:
+    resolution: {integrity: sha512-quJQXlTSUGL2LH9SUXo8VwsY4soanhgo6LNSm84E1LBcE8s3O0wpdiRzyR9z/ZZJMlMWv37qOOb9pdJlMUEKFQ==}
+    engines: {node: '>=8'}
+
+  ansi-regex@6.2.2:
+    resolution: {integrity: sha512-Bq3SmSpyFHaWjPk8If9yc6svM8c56dB5BAtW4Qbw5jHTwwXXcTLoRMkpDJp6VL0XzlWaCHTXrkFURMYmD0sLqg==}
+    engines: {node: '>=12'}
+
+  ansi-styles@4.3.0:
+    resolution: {integrity: sha512-zbB9rCJAT1rbjiVDb2hqKFHNYLxgtk8NURxZ3IZwD3F6NtxbXZQCnnSi1Lkx+IDohdPlFp222wVALIheZJQSEg==}
+    engines: {node: '>=8'}
+
+  ansi-styles@6.2.3:
+    resolution: {integrity: sha512-4Dj6M28JB+oAH8kFkTLUo+a2jwOFkuqb3yucU0CANcRRUbxS0cP0nZYCGjcc3BNXwRIsUVmDGgzawme7zvJHvg==}
+    engines: {node: '>=12'}
+
+  ansi-styles@7.0.0:
+    resolution: {integrity: sha512-kKvt3m4uwzqL0wlkPd09CmljPJGOZZ4D0fP65sqFSvPkMRKhNi+74MgIJ5QxE6SxqB4t4KyUFGg8+n5zjo6hew==, tarball: https://registry.npmmirror.com/ansi-styles/-/ansi-styles-7.0.0.tgz}
+    engines: {node: '>=22'}
+
+  ansis@4.3.1:
+    resolution: {integrity: sha512-BJ8/l4R5LRE7hW9WdSuGYrLSHi2ynxeFpDFbH0K/CgNeY/tyhk+vO6TYxXC5r5CpUhNVX310xzPsN/H9lCdfOA==, tarball: https://registry.npmmirror.com/ansis/-/ansis-4.3.1.tgz}
+    engines: {node: '>=14'}
+
+  assertion-error@2.0.1:
+    resolution: {integrity: sha512-Izi8RQcffqCeNVgFigKli1ssklIbpHnCYc6AknXGYoB6grJqyeby7jv12JUQgmTAnIDnbck1uxksT4dzN3PWBA==}
+    engines: {node: '>=12'}
+
+  ast-v8-to-istanbul@0.3.12:
+    resolution: {integrity: sha512-BRRC8VRZY2R4Z4lFIL35MwNXmwVqBityvOIwETtsCSwvjl0IdgFsy9NhdaA6j74nUdtJJlIypeRhpDam19Wq3g==}
+
+  async-validator@4.2.5:
+    resolution: {integrity: sha512-7HhHjtERjqlNbZtqNqy2rckN/SpOOlmDliet+lP7k+eKZEjPk3DgyeU9lIXLdeLz0uBbbVp+9Qdow9wJWgwwfg==, tarball: https://registry.npmmirror.com/async-validator/-/async-validator-4.2.5.tgz}
+
+  balanced-match@1.0.2:
+    resolution: {integrity: sha512-3oSeUO0TMV67hN1AmbXsK4yaqU7tjiHlbxRDZOpH0KW9+CeX4bRAaX0Anxt0tx2MrpRpWwQaPwIlISEJhYU5Pw==}
+
+  balanced-match@4.0.4:
+    resolution: {integrity: sha512-BLrgEcRTwX2o6gGxGOCNyMvGSp35YofuYzw9h1IMTRmKqttAZZVU67bdb9Pr2vUHA8+j3i2tJfjO6C6+4myGTA==}
+    engines: {node: 18 || 20 || >=22}
+
+  base64-arraybuffer@1.0.2:
+    resolution: {integrity: sha512-I3yl4r9QB5ZRY3XuJVEPfc2XhZO6YweFPI+UovAzn+8/hb3oJ6lnysaFcjVpkCPfVWFUDvoZ8kmVDP7WyRtYtQ==}
+    engines: {node: '>= 0.6.0'}
+
+  base64-js@1.5.1:
+    resolution: {integrity: sha512-AKpaYlHn8t4SVbOHCy+b5+KKgvR4vrsD8vbvrbiQJps7fKDTkjkDry6ji0rUJjC0kzbNePLwzxq8iypo41qeWA==}
+
+  baseline-browser-mapping@2.11.12:
+    resolution: {integrity: sha512-r7WnVImvVCeFpf2DOXfy41aPWzeNg3H/A2X4dKmy1QL0MSyyk/e7z8ihJ3N6Nn2PsdhkVlqnEfnUE4a05P2aTA==, tarball: https://registry.npmmirror.com/baseline-browser-mapping/-/baseline-browser-mapping-2.11.12.tgz}
+    engines: {node: '>=6.0.0'}
+    hasBin: true
+
+  birpc@2.9.0:
+    resolution: {integrity: sha512-KrayHS5pBi69Xi9JmvoqrIgYGDkD6mcSe/i6YKi3w5kekCLzrX4+nawcXqrj2tIp50Kw/mT/s3p+GVK0A0sKxw==, tarball: https://registry.npmmirror.com/birpc/-/birpc-2.9.0.tgz}
+
+  birpc@4.0.0:
+    resolution: {integrity: sha512-LShSxJP0KTmd101b6DRyGBj57LZxSDYWKitQNW/mi8GRMvZb078Uf9+pveax1DrVL89vm7mWe+TovdI/UDOuPw==, tarball: https://registry.npmmirror.com/birpc/-/birpc-4.0.0.tgz}
+
+  bl@4.1.0:
+    resolution: {integrity: sha512-1W07cM9gS6DcLperZfFSj+bWLtaPGSOHWhPiGzXmvVJbRLdG82sH/Kn8EtW1VqWVA54AKf2h5k5BbnIbwF3h6w==}
+
+  brace-expansion@2.1.4:
+    resolution: {integrity: sha512-hGfVzPxthbf3+2yjg/RBs60cB0FhqBS/zvdV/4wn4/BmN0bNMMHPc4V/BbFieqf1TKAGGAHnY4eSjajCl0f2Xg==}
+
+  brace-expansion@5.0.9:
+    resolution: {integrity: sha512-ScQ4IuvIEF1TMlP7Zt+vjJ//9zlPb2SDcxWxM3bk8s6t6GGdJ7KO1dCcTidOPJKePW30LE/2cT7wCyPho9/Wxg==}
+    engines: {node: 20 || >=22}
+
+  browserslist@4.28.7:
+    resolution: {integrity: sha512-JxV13hNrFxqjOc8alRbq9dK1MM79NEXYpma2B2J4wAtpWS5zIEIKqWPGCl7N4o7Uc7B7itylh7SuDujATRyyTw==, tarball: https://registry.npmmirror.com/browserslist/-/browserslist-4.28.7.tgz}
+    engines: {node: ^6 || ^7 || ^8 || ^9 || ^10 || ^11 || ^12 || >=13.7}
+    hasBin: true
+
+  buffer-image-size@0.6.4:
+    resolution: {integrity: sha512-nEh+kZOPY1w+gcCMobZ6ETUp9WfibndnosbpwB1iJk/8Gt5ZF2bhS6+B6bPYz424KtwsR6Rflc3tCz1/ghX2dQ==}
+    engines: {node: '>=4.0'}
+
+  buffer@5.7.1:
+    resolution: {integrity: sha512-EHcyIPBQ4BSGlvjB16k5KgAJ27CIsHY/2JBmCRReo48y9rQ3MaUzWX3KVlBa4U7MyX02HdVj0K7C3WaB3ju7FQ==}
+
+  bundle-name@4.1.0:
+    resolution: {integrity: sha512-tjwM5exMg6BGRI+kNmTntNsvdZS1X8BFYS6tnJ2hdH0kVxM6/eVZ2xy+FqStSWvYmtfFMDLIxurorHwDKfDz5Q==, tarball: https://registry.npmmirror.com/bundle-name/-/bundle-name-4.1.0.tgz}
+    engines: {node: '>=18'}
+
+  cac@6.7.14:
+    resolution: {integrity: sha512-b6Ilus+c3RrdDk+JhLKUAQfzzgLEPy6wcXqS7f/xe1EETvsDP6GORG7SFuOs6cID5YkqchW/LXZbX5bc8j7ZcQ==}
+    engines: {node: '>=8'}
+
+  cac@7.0.0:
+    resolution: {integrity: sha512-tixWYgm5ZoOD+3g6UTea91eow5z6AAHaho3g0V9CNSNb45gM8SmflpAc+GRd1InC4AqN/07Unrgp56Y94N9hJQ==}
+    engines: {node: '>=20.19.0'}
+
+  camelcase@5.3.1:
+    resolution: {integrity: sha512-L28STB170nwWS63UjtlEOE3dldQApaJXZkOI1uMFfzf3rRuPegHaHesyee+YxQ+W6SvRDQV6UrdOdRiR153wJg==}
+    engines: {node: '>=6'}
+
+  caniuse-lite@1.0.30001806:
+    resolution: {integrity: sha512-72Cuvd95zbSYPKq6Fhg8eDJRlzgWDf7/mtoZv6Qe/DYNCEBdNxoA3+rZAU2ZhGCpZlns3EssFavaZomckT5Uuw==, tarball: https://registry.npmmirror.com/caniuse-lite/-/caniuse-lite-1.0.30001806.tgz}
+
+  canvas@3.2.3:
+    resolution: {integrity: sha512-PzE5nJZPz72YUAfo8oTp0u3fqqY7IzlTubneAihqDYAUcBk7ryeCmBbdJBEdaH0bptSOe2VT2Zwcb3UaFyaSWw==}
+    engines: {node: ^18.12.0 || >= 20.9.0}
+
+  canvg@3.0.11:
+    resolution: {integrity: sha512-5ON+q7jCTgMp9cjpu4Jo6XbvfYwSB2Ow3kzHKfIyJfaCAOHLbdKPQqGKgfED/R5B+3TFFfe8pegYA+b423SRyA==}
+    engines: {node: '>=10.0.0'}
+
+  cfb@1.2.2:
+    resolution: {integrity: sha512-KfdUZsSOw19/ObEWasvBP/Ac4reZvAGauZhs6S/gqNhXhI7cKwvlH7ulj+dOEYnca4bm4SGo8C1bTAQvnTjgQA==}
+    engines: {node: '>=0.8'}
+
+  chai@5.3.3:
+    resolution: {integrity: sha512-4zNhdJD/iOjSH0A05ea+Ke6MU5mmpQcbQsSOkgdaUMJ9zTlDTD/GYlwohmIE2u0gaxHYiVHEn1Fw9mZ/ktJWgw==}
+    engines: {node: '>=18'}
+
+  check-error@2.1.3:
+    resolution: {integrity: sha512-PAJdDJusoxnwm1VwW07VWwUN1sl7smmC3OKggvndJFadxxDRyFJBX/ggnu/KE4kQAB7a3Dp8f/YXC1FlUprWmA==}
+    engines: {node: '>= 16'}
+
+  chokidar@5.0.0:
+    resolution: {integrity: sha512-TQMmc3w+5AxjpL8iIiwebF73dRDF4fBIieAqGn9RGCWaEVwQ6Fb2cGe31Yns0RRIzii5goJ1Y7xbMwo1TxMplw==, tarball: https://registry.npmmirror.com/chokidar/-/chokidar-5.0.0.tgz}
+    engines: {node: '>= 20.19.0'}
+
+  chownr@1.1.4:
+    resolution: {integrity: sha512-jJ0bqzaylmJtVnNgzTeSOs8DPavpbYgEr/b0YL8/2GO3xJEhInFmhKMUnEJQjZumK7KXGFhUy89PrsJWlakBVg==}
+
+  cliui@6.0.0:
+    resolution: {integrity: sha512-t6wbgtoCXvAzst7QgXxJYqPt0usEfbgQdftEPbLL/cvv6HPE5VgvqCuAIDR0NgU52ds6rFwqrgakNLrHEjCbrQ==}
+
+  codemirror@6.0.2:
+    resolution: {integrity: sha512-VhydHotNW5w1UGK0Qj96BwSk/Zqbp9WbnyK2W/eVMv4QyF41INRGpjUhFJY7/uDNuudSc33a/PKr4iDqRduvHw==}
+
+  codepage@1.15.0:
+    resolution: {integrity: sha512-3g6NUTPd/YtuuGrhMnOMRjFc+LJw/bnMp3+0r/Wcz3IXUuCosKRJvMphm5+Q+bvTVGcJJuRvVLuYba+WojaFaA==}
+    engines: {node: '>=0.8'}
+
+  color-convert@2.0.1:
+    resolution: {integrity: sha512-RRECPsj7iu/xb5oKYcsFHSppFNnsj/52OVTRKb4zP5onXwVF3zVmmToNcOfGC+CRDpfK/U584fMg38ZHCaElKQ==}
+    engines: {node: '>=7.0.0'}
+
+  color-name@1.1.4:
+    resolution: {integrity: sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA==}
+
+  colorette@2.0.20:
+    resolution: {integrity: sha512-IfEDxwoWIjkeXL1eXcDiow4UbKjhLdq6/EuSVR9GMN7KVH3r9gQ83e73hsz1Nd1T3ijd5xv1wcWRYO+D6kCI2w==}
+
+  confbox@0.1.8:
+    resolution: {integrity: sha512-RMtmw0iFkeR4YV+fUOSucriAQNb9g8zFR52MWCtl+cCZOFRNL6zeB395vPzFhEjjn4fMxXudmELnl/KF/WrK6w==, tarball: https://registry.npmmirror.com/confbox/-/confbox-0.1.8.tgz}
+
+  consola@3.4.2:
+    resolution: {integrity: sha512-5IKcdX0nnYavi6G7TtOhwkYzyjfJlatbjMjuLSfE2kYT5pMDOilZ4OvMhi637CcDICTmz3wARPoyhqyX1Y+XvA==}
+    engines: {node: ^14.18.0 || >=16.10.0}
+
+  convert-source-map@2.0.0:
+    resolution: {integrity: sha512-Kvp459HrV2FEJ1CAsi1Ku+MY3kasH19TFykTz2xWmMeq6bk2NU3XXvfJ+Q61m0xktWwt+1HSYf3JZsTms3aRJg==, tarball: https://registry.npmmirror.com/convert-source-map/-/convert-source-map-2.0.0.tgz}
+
+  core-js@3.50.0:
+    resolution: {integrity: sha512-BRWgOLKkFeCgRudR6zrs8p9XJZcE14grzKMMssoYrk6krtuEZ7MTKPIY5RzOnqsEKIR9kst7wNzphttraT+Yqw==}
+
+  crc-32@1.2.2:
+    resolution: {integrity: sha512-ROmzCKrTnOwybPcJApAA6WBWij23HVfGVNKqqrZpuyZOHqK2CwHSvpGuyt/UNNvaIjEd8X5IFGp4Mh+Ie1IHJQ==}
+    engines: {node: '>=0.8'}
+    hasBin: true
+
+  crelt@1.0.7:
+    resolution: {integrity: sha512-aK6BbWfhf4U/wCcLHKPJl/xa6VkVstRaPywWtMKGwuOLc/wZTyQYuoxgvZnNsBvv7Kg3YTBQYYBCggcviQczuA==}
+
+  cross-spawn@7.0.6:
+    resolution: {integrity: sha512-uV2QOWP2nWzsy2aMp8aRibhi9dlzF5Hgh5SHaB9OiTGEyDTiJJyx0uy51QXdyWbtAHNua4XJzUKca3OzKUd3vA==, tarball: https://registry.npmmirror.com/cross-spawn/-/cross-spawn-7.0.6.tgz}
+    engines: {node: '>= 8'}
+
+  css-line-break@2.1.0:
+    resolution: {integrity: sha512-FHcKFCZcAha3LwfVBhCQbW2nCNbkZXn7KVUJcsT5/P8YmfsVja0FMPJr0B903j/E69HUphKiV9iQArX8SDYA4w==}
+
+  css-render@0.15.14:
+    resolution: {integrity: sha512-9nF4PdUle+5ta4W5SyZdLCCmFd37uVimSjg1evcTqKJCyvCEEj12WKzOSBNak6r4im4J4iYXKH1OWpUV5LBYFg==, tarball: https://registry.npmmirror.com/css-render/-/css-render-0.15.14.tgz}
+
+  css-tree@3.2.1:
+    resolution: {integrity: sha512-X7sjQzceUhu1u7Y/ylrRZFU2FS6LRiFVp6rKLPg23y3x3c3DOKAwuXGDp+PAGjh6CSnCjYeAul8pcT8bAl+lSA==}
+    engines: {node: ^10 || ^12.20.0 || ^14.13.0 || >=15.0.0}
+
+  cssesc@3.0.0:
+    resolution: {integrity: sha512-/Tb/JcjK111nNScGob5MNtsntNM1aCNUDipB/TkwZFhyDrrE47SOx/18wF2bbjgc3ZzCSKW1T5nt5EbFoAz/Vg==}
+    engines: {node: '>=4'}
+    hasBin: true
+
+  cssstyle@4.6.0:
+    resolution: {integrity: sha512-2z+rWdzbbSZv6/rhtvzvqeZQHrBaqgogqt85sqFNbabZOuFbCVFb8kPeEtZjiKkbrm395irpNKiYeFeLiQnFPg==}
+    engines: {node: '>=18'}
+
+  csstype@3.0.11:
+    resolution: {integrity: sha512-sa6P2wJ+CAbgyy4KFssIb/JNMLxFvKF1pCYCSXS8ZMuqZnMsrxqI2E5sPyoTpxoPU/gVZMzr2zjOfg8GIZOMsw==, tarball: https://registry.npmmirror.com/csstype/-/csstype-3.0.11.tgz}
+
+  csstype@3.2.3:
+    resolution: {integrity: sha512-z1HGKcYy2xA8AGQfwrn0PAy+PB7X/GSj3UVJW9qKyn43xWa+gl5nXmU4qqLMRzWVLFC8KusUX8T/0kCiOYpAIQ==, tarball: https://registry.npmmirror.com/csstype/-/csstype-3.2.3.tgz}
+
+  data-urls@5.0.0:
+    resolution: {integrity: sha512-ZYP5VBHshaDAiVZxjbRVcFJpc+4xGgT0bK3vzy1HLN8jTO975HEbuYzZJcHoQEY5K1a0z8YayJkyVETa08eNTg==}
+    engines: {node: '>=18'}
+
+  date-fns-tz@3.2.0:
+    resolution: {integrity: sha512-sg8HqoTEulcbbbVXeg84u5UnlsQa8GS5QXMqjjYIhS4abEVVKIUwe0/l/UhrZdKaL/W5eWZNlbTeEIiOXTcsBQ==, tarball: https://registry.npmmirror.com/date-fns-tz/-/date-fns-tz-3.2.0.tgz}
+    peerDependencies:
+      date-fns: ^3.0.0 || ^4.0.0
+
+  date-fns@4.4.0:
+    resolution: {integrity: sha512-+1UMbeh68lH1SegH83CGWwpb6OHHbpSgr3+s5Eww5M4CAgswBpoWS0AjTOfEJ33HiYKz1hdj/KTFprzXHmq/6w==, tarball: https://registry.npmmirror.com/date-fns/-/date-fns-4.4.0.tgz}
+
+  debug@4.4.3:
+    resolution: {integrity: sha512-RGwwWnwQvkVfavKVt22FGLw+xYSdzARwm0ru6DhTVA3umU5hZc28V3kO4stgYryrTlLpuvgI9GiijltAjNbcqA==}
+    engines: {node: '>=6.0'}
+    peerDependencies:
+      supports-color: '*'
+    peerDependenciesMeta:
+      supports-color:
+        optional: true
+
+  decamelize@1.2.0:
+    resolution: {integrity: sha512-z2S+W9X73hAUUki+N+9Za2lBlun89zigOyGrsax+KUQ6wKW4ZoWpEYBkGhQjwAjjDCkWxhY0VKEhk8wzY7F5cA==}
+    engines: {node: '>=0.10.0'}
+
+  decimal.js@10.6.0:
+    resolution: {integrity: sha512-YpgQiITW3JXGntzdUmyUR1V812Hn8T1YVXhCu+wO3OpS4eU9l4YdD3qjyiKdV6mvV29zapkMeD390UVEf2lkUg==}
+
+  decompress-response@6.0.0:
+    resolution: {integrity: sha512-aW35yZM6Bb/4oJlZncMH2LCoZtJXTRxES17vE3hoRiowU2kWHaJKFkSBDnDR+cm9J+9QhXmREyIfv0pji9ejCQ==}
+    engines: {node: '>=10'}
+
+  deep-eql@5.0.2:
+    resolution: {integrity: sha512-h5k/5U50IJJFpzfL6nO9jaaumfjO/f2NjK/oYB2Djzm4p9L+3T9qWpZqZ2hAbLPuuYq9wrU08WQyBTL5GbPk5Q==}
+    engines: {node: '>=6'}
+
+  deep-extend@0.6.0:
+    resolution: {integrity: sha512-LOHxIOaPYdHlJRtCQfDIVZtfw/ufM8+rVj649RIHzcm/vGwQRXFt6OPqIFWsm2XEMrNIEtWR64sY1LEKD2vAOA==}
+    engines: {node: '>=4.0.0'}
+
+  default-browser-id@5.0.1:
+    resolution: {integrity: sha512-x1VCxdX4t+8wVfd1so/9w+vQ4vx7lKd2Qp5tDRutErwmR85OgmfX7RlLRMWafRMY7hbEiXIbudNrjOAPa/hL8Q==, tarball: https://registry.npmmirror.com/default-browser-id/-/default-browser-id-5.0.1.tgz}
+    engines: {node: '>=18'}
+
+  default-browser@5.5.0:
+    resolution: {integrity: sha512-H9LMLr5zwIbSxrmvikGuI/5KGhZ8E2zH3stkMgM5LpOWDutGM2JZaj460Udnf1a+946zc7YBgrqEWwbk7zHvGw==, tarball: https://registry.npmmirror.com/default-browser/-/default-browser-5.5.0.tgz}
+    engines: {node: '>=18'}
+
+  define-lazy-prop@3.0.0:
+    resolution: {integrity: sha512-N+MeXYoqr3pOgn8xfyRPREN7gHakLYjhsHhWGT3fWAiL4IkAt0iDw14QiiEm2bE30c5XX5q0FtAA3CK5f9/BUg==, tarball: https://registry.npmmirror.com/define-lazy-prop/-/define-lazy-prop-3.0.0.tgz}
+    engines: {node: '>=12'}
+
+  defu@6.1.7:
+    resolution: {integrity: sha512-7z22QmUWiQ/2d0KkdYmANbRUVABpZ9SNYyH5vx6PZ+nE5bcC0l7uFvEfHlyld/HcGBFTL536ClDt3DEcSlEJAQ==}
+
+  destr@2.0.5:
+    resolution: {integrity: sha512-ugFTXCtDZunbzasqBxrK93Ik/DRYsO6S/fedkWEMKqt04xZ4csmnmwGDBAb07QWNaGMAmnTIemsYZCksjATwsA==}
+
+  detect-libc@2.1.2:
+    resolution: {integrity: sha512-Btj2BOOO83o3WyH59e8MgXsxEQVcarkUOpEYrubB0urwnN10yQ364rsiByU11nZlqWYZm05i/of7io4mzihBtQ==, tarball: https://registry.npmmirror.com/detect-libc/-/detect-libc-2.1.2.tgz}
+    engines: {node: '>=8'}
+
+  dijkstrajs@1.0.3:
+    resolution: {integrity: sha512-qiSlmBq9+BCdCA/L46dw8Uy93mloxsPSbwnm5yrKn2vMPiy8KyAskTF6zuV/j5BMsmOGZDPs7KjU+mjb670kfA==}
+
+  dompurify@3.4.13:
+    resolution: {integrity: sha512-2vmYIoqjze2d+kakP8S/nS5shfsl587kzwEjcGlTdiksUVgFHnFCsLYDVj/JNqJVOQZGSYBTmuycv0PodwmnMQ==}
+
+  duplexer@0.1.2:
+    resolution: {integrity: sha512-jtD6YG370ZCIi/9GTaJKQxWTZD045+4R4hTk/x1UyoqadyJ9x9CgSi1RlVDQF8U2sxLLSnFkCaMihqljHIWgMg==}
+
+  eastasianwidth@0.2.0:
+    resolution: {integrity: sha512-I88TYZWc9XiYHRQ4/3c5rjjfgkjhLyW2luGIheGERbNQ6OY7yTybanSpDXZa8y7VUP9YmDcYa+eyq4ca7iLqWA==}
+
+  electron-to-chromium@1.5.401:
+    resolution: {integrity: sha512-H6ViHN68nGYlChEvlIU67fn8O2/tpbWQPwck98yaJmh+08LSvHiydzDQ6oXNccLU3kNRVIRS9A4mA7CG+i6fLQ==, tarball: https://registry.npmmirror.com/electron-to-chromium/-/electron-to-chromium-1.5.401.tgz}
+
+  emoji-regex@8.0.0:
+    resolution: {integrity: sha512-MSjYzcWNOA0ewAHpz0MxpYFvwg6yjy1NG3xteoqz644VCo/RPgnr1/GGt+ic3iJTzQ8Eu3TdM14SawnVUmGE6A==}
+
+  emoji-regex@9.2.2:
+    resolution: {integrity: sha512-L18DaJsXSUk2+42pv8mLs5jJT2hqFkFE4j21wOmgbUqsZ2hL72NsUU785g9RXgo3s0ZNgVl42TiHp3ZtOv/Vyg==}
+
+  end-of-stream@1.4.5:
+    resolution: {integrity: sha512-ooEGc6HP26xXq/N+GCGOT0JKCLDGrq2bQUZrQ7gyrJiZANJ/8YDTxTpQBXGMn+WbIQXNVpyWymm7KYVICQnyOg==}
+
+  entities@6.0.1:
+    resolution: {integrity: sha512-aN97NXWF6AWBTahfVOIrB/NShkzi5H7F9r1s9mD3cDj4Ko5f2qhhVoYMibXF7GlLveb/D2ioWay8lxI97Ven3g==}
+    engines: {node: '>=0.12'}
+
+  entities@7.0.1:
+    resolution: {integrity: sha512-TWrgLOFUQTH994YUyl1yT4uyavY5nNB5muff+RtWaqNVCAK408b5ZnnbNAUEWLTCpum9w6arT70i1XdQ4UeOPA==, tarball: https://registry.npmmirror.com/entities/-/entities-7.0.1.tgz}
+    engines: {node: '>=0.12'}
+
+  error-stack-parser-es@1.0.5:
+    resolution: {integrity: sha512-5qucVt2XcuGMcEGgWI7i+yZpmpByQ8J1lHhcL7PwqCwu9FPP3VUXzT4ltHe5i2z9dePwEHcDVOAfSnHsOlCXRA==, tarball: https://registry.npmmirror.com/error-stack-parser-es/-/error-stack-parser-es-1.0.5.tgz}
+
+  es-module-lexer@1.7.0:
+    resolution: {integrity: sha512-jEQoCwk8hyb2AZziIOLhDqpm5+2ww5uIE6lkO/6jcOCusfk6LhMHpXXfBLXTZ7Ydyt0j4VoUQv6uGNYbdW+kBA==}
+
+  esbuild@0.28.2:
+    resolution: {integrity: sha512-HKVLS8dvII+xoKW9kmqxbRKrnWEXfJJr/FZhhJmiqIB0e053QNYFqOBouTMO/k5sID4MvCiUCvv8b9M4h32wIA==}
+    engines: {node: '>=18'}
+    hasBin: true
+
+  escalade@3.2.0:
+    resolution: {integrity: sha512-WUj2qlxaQtO4g6Pq5c29GTcWGDyd8itL8zTlipgECz3JesAiiOKotd8JU6otB3PACgG6xkJUyVhboMS+bje/jA==, tarball: https://registry.npmmirror.com/escalade/-/escalade-3.2.0.tgz}
+    engines: {node: '>=6'}
+
+  estree-walker@2.0.2:
+    resolution: {integrity: sha512-Rfkk/Mp/DL7JVje3u18FxFujQlTNR2q6QfMSMB7AvCBx91NGj/ba3kCfza0f6dVDbw7YlRf/nDrn7pQrCCyQ/w==, tarball: https://registry.npmmirror.com/estree-walker/-/estree-walker-2.0.2.tgz}
+
+  estree-walker@3.0.3:
+    resolution: {integrity: sha512-7RUKfXgSMMkzt6ZuXmqapOurLGPPfgj6l9uRZ7lRGolvk0y2yocc35LdcxKC5PQZdn2DMqioAQ2NoWcrTKmm6g==}
+
+  evtd@0.2.4:
+    resolution: {integrity: sha512-qaeGN5bx63s/AXgQo8gj6fBkxge+OoLddLniox5qtLAEY5HSnuSlISXVPxnSae1dWblvTh4/HoMIB+mbMsvZzw==, tarball: https://registry.npmmirror.com/evtd/-/evtd-0.2.4.tgz}
+
+  expand-template@2.0.3:
+    resolution: {integrity: sha512-XYfuKMvj4O35f/pOXLObndIRvyQ+/+6AhODh+OKWj9S9498pHHn/IMszH+gt0fBCRWMNfk1ZSp5x3AifmnI2vg==}
+    engines: {node: '>=6'}
+
+  expect-type@1.4.0:
+    resolution: {integrity: sha512-KfYbmpRm0VbLjEvVa9yGwCi9GI34xvi7A/HXYWQO65CSD2u3MczUJSuwXKFIxlGsgBQizV9q5J9NHj4VG0n+pA==}
+    engines: {node: '>=12.0.0'}
+
+  fabric@7.4.0:
+    resolution: {integrity: sha512-NalYDc3eifTl1C33zryQwpH6+XA/2ClxQrH9vkASkZw3tbkRmorpikhYMmxhUTmi7O3e9ODz0vOT8qfaCh9IVA==}
+    engines: {node: '>=20.0.0'}
+
+  fast-deep-equal@3.1.3:
+    resolution: {integrity: sha512-f3qQ9oQy9j2AhBe/H9VC91wLmKBCCU/gDOnKNAYG5hswO7BLKj09Hc5HYNz9cGI++xlpDCIgDaitVs03ATR84Q==}
+
+  fast-png@6.4.0:
+    resolution: {integrity: sha512-kAqZq1TlgBjZcLr5mcN6NP5Rv4V2f22z00c3g8vRrwkcqjerx7BEhPbOnWCPqaHUl2XWQBJQvOT/FQhdMT7X/Q==}
+
+  fast-uri@3.1.5:
+    resolution: {integrity: sha512-gHwA1O9LDIcKunMKhObS/HimwtehO1nPUECKAu5TpKgaO19fcWEl4bliWe1jWxVFvIXztJjjQ4L8XQ1EU9f7Jw==}
+
+  fdir@6.5.0:
+    resolution: {integrity: sha512-tIbYtZbucOs0BRGqPJkshJUYdL+SDH7dVM8gjy+ERp3WAUjLEFJE+02kanyHtwjWOnwrKYBiwAmM0p4kLJAnXg==, tarball: https://registry.npmmirror.com/fdir/-/fdir-6.5.0.tgz}
+    engines: {node: '>=12.0.0'}
+    peerDependencies:
+      picomatch: ^3 || ^4
+    peerDependenciesMeta:
+      picomatch:
+        optional: true
+
+  fflate@0.8.3:
+    resolution: {integrity: sha512-tbZNuJrLwGUp3zshBtdy4W+ORxZuIh8a5ilyIEQDC5rY1f3U20JMry0Ll3WBzU58EZKsEuJFXhb5gwv8CsPvgA==}
+
+  find-up@4.1.0:
+    resolution: {integrity: sha512-PpOwAdQ/YlXQ2vj8a3h8IipDuYRi3wceVQQGYWxNINccq40Anw7BlsEXCMbt1Zt+OLA6Fq9suIpIWD0OsnISlw==}
+    engines: {node: '>=8'}
+
+  font-family-papandreou@0.2.0-patch2:
+    resolution: {integrity: sha512-l/YiRdBSH/eWv6OF3sLGkwErL+n0MqCICi9mppTZBOCL5vixWGDqCYvRcuxB2h7RGCTzaTKOHT2caHvCXQPRlw==}
+
+  foreground-child@3.3.1:
+    resolution: {integrity: sha512-gIXjKqtFuWEgzFRJA9WCQeSJLZDjgJUOMCMzxtvFq/37KojM1BFGufqsCy0r4qSQmYLsZYMeyRqzIWOMup03sw==}
+    engines: {node: '>=14'}
+
+  frac@1.1.2:
+    resolution: {integrity: sha512-w/XBfkibaTl3YDqASwfDUqkna4Z2p9cFSr1aHDt0WoMTECnRfBOv2WArlZILlqgWlmdIlALXGpM2AOhEk5W3IA==}
+    engines: {node: '>=0.8'}
+
+  fs-constants@1.0.0:
+    resolution: {integrity: sha512-y6OAwoSIf7FyjMIv94u+b5rdheZEjzR63GTyZJm5qh4Bi+2YgwLCcI/fPFZkL5PSixOt6ZNKm+w+Hfp/Bciwow==}
+
+  fsevents@2.3.3:
+    resolution: {integrity: sha512-5xoDfX+fL7faATnagmWPpbFtwh/R77WmMMqqHGS65C3vvB0YHrgF+B1YmZ3441tMj5n63k0212XNoJwzlhffQw==}
+    engines: {node: ^8.16.0 || ^10.6.0 || >=11.0.0}
+    os: [darwin]
+
+  gensync@1.0.0-beta.2:
+    resolution: {integrity: sha512-3hN7NaskYvMDLQY55gnW3NQ+mesEAepTqlg+VEbj7zzqEMBVNhzcGYYeqFo/TlYz6eQiFcp1HcsCZO+nGgS8zg==, tarball: https://registry.npmmirror.com/gensync/-/gensync-1.0.0-beta.2.tgz}
+    engines: {node: '>=6.9.0'}
+
+  get-caller-file@2.0.5:
+    resolution: {integrity: sha512-DyFP3BM/3YHTQOCUL/w0OZHR0lpKeGrxotcHWcqNEdnltqFwXVfhEBQ94eIo34AfQpo0rGki4cyIiftY06h2Fg==}
+    engines: {node: 6.* || 8.* || >= 10.*}
+
+  github-from-package@0.0.0:
+    resolution: {integrity: sha512-SyHy3T1v2NUXn29OsWdxmK6RwHD+vkj3v8en8AOBZ1wBQ/hCAQ5bAQTD02kW4W9tUp/3Qh6J8r9EvntiyCmOOw==}
+
+  glob@10.5.0:
+    resolution: {integrity: sha512-DfXN8DfhJ7NH3Oe7cFmu3NCu1wKbkReJ8TorzSAFbSKrlNaQSKfIzqYqVY8zlbs2NLBbWpRiU52GX2PbaBVNkg==}
+    deprecated: Old versions of glob are not supported, and contain widely publicized security vulnerabilities, which have been fixed in the current version. Please update. Support for old versions may be purchased (at exorbitant rates) by contacting i@izs.me
+    hasBin: true
+
+  gzip-size@6.0.0:
+    resolution: {integrity: sha512-ax7ZYomf6jqPTQ4+XCpUGyXKHk5WweS+e05MBO4/y3WJ5RkmPXNKvX+bx1behVILVwr6JSQvZAku021CHPXG3Q==}
+    engines: {node: '>=10'}
+
+  happy-dom@20.11.2:
+    resolution: {integrity: sha512-7MB+bJLkxu3SowAfBJbjW+c55kNz5tkR45gu2qzrxznezhLeN5YIlJbwUgSzlGc+qWoZ8Ykg71H5ezz69xixrw==}
+    engines: {node: '>=20.0.0'}
+
+  has-flag@4.0.0:
+    resolution: {integrity: sha512-EykJT/Q1KjTWctppgIAgfSO0tKVuZUjhgMr17kqTumMl6Afv3EISleU7qZUzoXDFTAHTDC4NOoG/ZxU3EvlMPQ==}
+    engines: {node: '>=8'}
+
+  highlight.js@11.11.1:
+    resolution: {integrity: sha512-Xwwo44whKBVCYoliBQwaPvtd/2tYFkRQtXDWj1nackaV2JPXx3L0+Jvd8/qCJ2p+ML0/XVkJ2q+Mr+UVdpJK5w==, tarball: https://registry.npmmirror.com/highlight.js/-/highlight.js-11.11.1.tgz}
+    engines: {node: '>=12.0.0'}
+
+  hookable@5.5.3:
+    resolution: {integrity: sha512-Yc+BQe8SvoXH1643Qez1zqLRmbA5rCL+sSmk6TVos0LWVfNIB7PGncdlId77WzLGSIB5KaWgTaNTs2lNVEI6VQ==, tarball: https://registry.npmmirror.com/hookable/-/hookable-5.5.3.tgz}
+
+  html-encoding-sniffer@4.0.0:
+    resolution: {integrity: sha512-Y22oTqIU4uuPgEemfz7NDJz6OeKf12Lsu+QC+s3BVpda64lTiMYCyGwg5ki4vFxkMwQdeZDl2adZoqUgdFuTgQ==}
+    engines: {node: '>=18'}
+
+  html-escaper@2.0.2:
+    resolution: {integrity: sha512-H2iMtd0I4Mt5eYiapRdIDjp+XzelXQ0tFE4JS7YFwFevXXMmOp9myNrUvCg0D6ws8iqkRPBfKHgbwig1SmlLfg==}
+
+  html2canvas@1.4.1:
+    resolution: {integrity: sha512-fPU6BHNpsyIhr8yyMpTLLxAbkaK8ArIBcmZIRiBLiDhjeqvXolaEmDGmELFuX9I4xDcaKKcJl+TKZLqruBbmWA==}
+    engines: {node: '>=8.0.0'}
+
+  http-proxy-agent@7.0.2:
+    resolution: {integrity: sha512-T1gkAiYYDWYx3V5Bmyu7HcfcvL7mUrTWiM6yOfa3PIphViJ/gFPbvidQ+veqSOHci/PxBcDabeUNCzpOODJZig==}
+    engines: {node: '>= 14'}
+
+  https-proxy-agent@7.0.6:
+    resolution: {integrity: sha512-vK9P5/iUfdl95AI+JVyUuIcVtd4ofvtrOr3HNtM2yxC9bnMbEdp3x01OhQNnjb8IJYi38VlTE3mBXwcfvywuSw==}
+    engines: {node: '>= 14'}
+
+  iconv-lite@0.6.3:
+    resolution: {integrity: sha512-4fCk79wshMdzMp2rH06qWrJE4iolqLhCUH+OiuIgU++RB0+94NlDL81atO7GX55uUKueo0txHNtvEyI6D7WdMw==}
+    engines: {node: '>=0.10.0'}
+
+  ieee754@1.2.1:
+    resolution: {integrity: sha512-dcyqhDvX1C46lXZcVqCpK+FtMRQVdIMN6/Df5js2zouUsqG7I6sFxitIC+7KYK29KdXOLHdu9zL4sFnoVQnqaA==}
+
+  import-meta-resolve@4.2.0:
+    resolution: {integrity: sha512-Iqv2fzaTQN28s/FwZAoFq0ZSs/7hMAHJVX+w8PZl3cY19Pxk6jFFalxQoIfW2826i/fDLXv8IiEZRIT0lDuWcg==}
+
+  inherits@2.0.4:
+    resolution: {integrity: sha512-k/vGaX4/Yla3WzyMCvTQOXYeIHvqOKtnqBduzTHpzpQZzAskKMhZ2K+EnBiSM9zGSoIFeMpXKxa4dYeZIQqewQ==}
+
+  ini@1.3.8:
+    resolution: {integrity: sha512-JV/yugV2uzW5iMRSiZAyDtQd+nxtUnjeLt0acNdw98kKLrvuRVyB80tsREOE7yvGVgalhZ6RNXCmEHkUKBKxew==}
+
+  iobuffer@5.4.0:
+    resolution: {integrity: sha512-DRebOWuqDvxunfkNJAlc3IzWIPD5xVxwUNbHr7xKB8E6aLJxIPfNX3CoMJghcFjpv6RWQsrcJbghtEwSPoJqMA==}
+
+  is-docker@3.0.0:
+    resolution: {integrity: sha512-eljcgEDlEns/7AXFosB5K/2nCM4P7FQPkGc/DWLy5rmFEWvZayGrik1d9/QIY5nJ4f9YsVvBkA6kJpHn9rISdQ==, tarball: https://registry.npmmirror.com/is-docker/-/is-docker-3.0.0.tgz}
+    engines: {node: ^12.20.0 || ^14.13.1 || >=16.0.0}
+    hasBin: true
+
+  is-fullwidth-code-point@3.0.0:
+    resolution: {integrity: sha512-zymm5+u+sCsSWyD9qNaejV3DFvhCKclKdizYaJUuHA83RLjb7nSuGnddCHGv0hk+KY7BMAlsWeK4Ueg6EV6XQg==}
+    engines: {node: '>=8'}
+
+  is-in-ssh@1.0.0:
+    resolution: {integrity: sha512-jYa6Q9rH90kR1vKB6NM7qqd1mge3Fx4Dhw5TVlK1MUBqhEOuCagrEHMevNuCcbECmXZ0ThXkRm+Ymr51HwEPAw==, tarball: https://registry.npmmirror.com/is-in-ssh/-/is-in-ssh-1.0.0.tgz}
+    engines: {node: '>=20'}
+
+  is-inside-container@1.0.0:
+    resolution: {integrity: sha512-KIYLCCJghfHZxqjYBE7rEy0OBuTd5xCHS7tHVgvCLkx7StIoaxwNW3hCALgEUjFfeRk+MG/Qxmp/vtETEF3tRA==, tarball: https://registry.npmmirror.com/is-inside-container/-/is-inside-container-1.0.0.tgz}
+    engines: {node: '>=14.16'}
+    hasBin: true
+
+  is-potential-custom-element-name@1.0.1:
+    resolution: {integrity: sha512-bCYeRA2rVibKZd+s2625gGnGF/t7DSqDs4dP7CrLA1m7jKWz6pps0LpYLJN8Q64HtmPKJ1hrN3nzPNKFEKOUiQ==}
+
+  is-wsl@3.1.1:
+    resolution: {integrity: sha512-e6rvdUCiQCAuumZslxRJWR/Doq4VpPR82kqclvcS0efgt430SlGIk05vdCN58+VrzgtIcfNODjozVielycD4Sw==, tarball: https://registry.npmmirror.com/is-wsl/-/is-wsl-3.1.1.tgz}
+    engines: {node: '>=16'}
+
+  isexe@2.0.0:
+    resolution: {integrity: sha512-RHxMLp9lnKHGHRng9QFhRCMbYAcVpn69smSGcq3f36xjgVVWThj4qqLbTLlq7Ssj8B+fIQ1EuCEGI2lKsyQeIw==, tarball: https://registry.npmmirror.com/isexe/-/isexe-2.0.0.tgz}
+
+  isexe@4.0.0:
+    resolution: {integrity: sha512-FFUtZMpoZ8RqHS3XeXEmHWLA4thH+ZxCv2lOiPIn1Xc7CxrqhWzNSDzD+/chS/zbYezmiwWLdQC09JdQKmthOw==, tarball: https://registry.npmmirror.com/isexe/-/isexe-4.0.0.tgz}
+    engines: {node: '>=20'}
+
+  istanbul-lib-coverage@3.2.2:
+    resolution: {integrity: sha512-O8dpsF+r0WV/8MNRKfnmrtCWhuKjxrq2w+jpzBL5UZKTi2LeVWnWOmWRxFlesJONmc+wLAGvKQZEOanko0LFTg==}
+    engines: {node: '>=8'}
+
+  istanbul-lib-report@3.0.1:
+    resolution: {integrity: sha512-GCfE1mtsHGOELCU8e/Z7YWzpmybrx/+dSTfLrvY8qRmaY6zXTKWn6WQIjaAFw069icm6GVMNkgu0NzI4iPZUNw==}
+    engines: {node: '>=10'}
+
+  istanbul-lib-source-maps@5.0.6:
+    resolution: {integrity: sha512-yg2d+Em4KizZC5niWhQaIomgf5WlL4vOOjZ5xGCmF8SnPE/mDWWXgvRExdcpCgh9lLRRa1/fSYp2ymmbJ1pI+A==}
+    engines: {node: '>=10'}
+
+  istanbul-reports@3.2.0:
+    resolution: {integrity: sha512-HGYWWS/ehqTV3xN10i23tkPkpH46MLCIMFNCaaKNavAXTF1RkqxawEPtnjnGZ6XKSInBKkiOA5BKS+aZiY3AvA==}
+    engines: {node: '>=8'}
+
+  jackspeak@3.4.3:
+    resolution: {integrity: sha512-OGlZQpz2yfahA/Rd1Y8Cd9SIEsqvXkLVoSw/cgwhnhFMDbsQFeZYoJJ7bIZBS9BcamUW96asq/npPWugM+RQBw==}
+
+  jiti@2.7.0:
+    resolution: {integrity: sha512-AC/7JofJvZGrrneWNaEnJeOLUx+JlGt7tNa0wZiRPT4MY1wmfKjt2+6O2p2uz2+skll8OZZmJMNqeke7kKbNgQ==}
+    hasBin: true
+
+  js-tokens@10.0.0:
+    resolution: {integrity: sha512-lM/UBzQmfJRo9ABXbPWemivdCW8V2G8FHaHdypQaIy523snUjog0W71ayWXTjiR+ixeMyVHN2XcpnTd/liPg/Q==}
+
+  js-tokens@4.0.0:
+    resolution: {integrity: sha512-RdJUflcE3cUzKiMqQgsCu06FPu9UdIJO0beYbPhHN4k6apgJtifcoCtT9bcxOpYBtpD2kCM6Sbzg4CausW/PKQ==, tarball: https://registry.npmmirror.com/js-tokens/-/js-tokens-4.0.0.tgz}
+
+  js-tokens@9.0.1:
+    resolution: {integrity: sha512-mxa9E9ITFOt0ban3j6L5MpjwegGz6lBQmM1IJkWeBZGcMxto50+eWdjC/52xDbS2vy0k7vIMK0Fe2wfL9OQSpQ==}
+
+  jsdom@26.1.0:
+    resolution: {integrity: sha512-Cvc9WUhxSMEo4McES3P7oK3QaXldCfNWp7pl2NNeiIFlCoLr3kfq9kb1fxftiwk1FLV7CvpvDfonxtzUDeSOPg==}
+    engines: {node: '>=18'}
+    peerDependencies:
+      canvas: ^3.0.0
+    peerDependenciesMeta:
+      canvas:
+        optional: true
+
+  jsesc@3.1.0:
+    resolution: {integrity: sha512-/sM3dO2FOzXjKQhJuo0Q173wf2KOo8t4I8vHy6lF9poUp7bKT0/NHE8fPX23PwfhnykfqnC2xRxOnVw5XuGIaA==, tarball: https://registry.npmmirror.com/jsesc/-/jsesc-3.1.0.tgz}
+    engines: {node: '>=6'}
+    hasBin: true
+
+  json-parse-even-better-errors@6.0.0:
+    resolution: {integrity: sha512-2/8adwnK1/+Fdjyts4r6wSpfANWw8zdNhU9U/Llk59c6O+DjSisPWPykwoL8gZmocP9Dy64S7oie2g+Mia123A==, tarball: https://registry.npmmirror.com/json-parse-even-better-errors/-/json-parse-even-better-errors-6.0.0.tgz}
+    engines: {node: ^22.22.2 || ^24.15.0 || >=26.0.0}
+
+  json-schema-to-ts@3.1.1:
+    resolution: {integrity: sha512-+DWg8jCJG2TEnpy7kOm/7/AxaYoaRbjVB4LFZLySZlWn8exGs3A4OLJR966cVvU26N7X9TWxl+Jsw7dzAqKT6g==}
+    engines: {node: '>=16'}
+
+  json-schema-traverse@1.0.0:
+    resolution: {integrity: sha512-NM8/P9n3XjXhIZn1lLhkFaACTOURQXjWhV4BA/RnOv8xvgqtqpAX9IO4mRQxSx1Rlo4tqzeqb0sOlruaOy3dug==}
+
+  json5@2.2.3:
+    resolution: {integrity: sha512-XmOWe7eyHYH14cLdVPoyg+GOH3rYX++KpzrylJwSW98t3Nk+U8XOl8FWKOgwtzdb8lXGf6zYwDUzeHMWfxasyg==, tarball: https://registry.npmmirror.com/json5/-/json5-2.2.3.tgz}
+    engines: {node: '>=6'}
+    hasBin: true
+
+  jspdf@4.2.1:
+    resolution: {integrity: sha512-YyAXyvnmjTbR4bHQRLzex3CuINCDlQnBqoSYyjJwTP2x9jDLuKDzy7aKUl0hgx3uhcl7xzg32agn5vlie6HIlQ==}
+
+  kolorist@1.8.0:
+    resolution: {integrity: sha512-Y+60/zizpJ3HRH8DCss+q95yr6145JXZo46OTpFvDZWLfRCE4qChOyk1b26nMaNpfHHgxagk9dXT5OP0Tfe+dQ==, tarball: https://registry.npmmirror.com/kolorist/-/kolorist-1.8.0.tgz}
+
+  lightningcss-android-arm64@1.33.0:
+    resolution: {integrity: sha512-gEpRTalKdosp4Bb8qWtc2iOgE5SeIHlpS1up9bFq2wAyYhl1UdTObYiHe98zEM9SQvSoqQZ1IQD0JNpg3Ml5pg==}
+    engines: {node: '>= 12.0.0'}
+    cpu: [arm64]
+    os: [android]
+
+  lightningcss-darwin-arm64@1.33.0:
+    resolution: {integrity: sha512-Sciaz8eenNTKn9b3t7+xr0ipTp9YxKQY4npwQ3mrRuL0BAVHBLyZxofhaKBAVtzmtRZ/zTyo0/to4B1uWG/Djg==}
+    engines: {node: '>= 12.0.0'}
+    cpu: [arm64]
+    os: [darwin]
+
+  lightningcss-darwin-x64@1.33.0:
+    resolution: {integrity: sha512-Z5UPAxzrjlWNNyGy6i65cJzzvgJ5D3T6wMvs+gWpY9d7qRhANrxqAp6LhxIgZhWEw18RfJTGcRxjuLIBr+m8XQ==}
+    engines: {node: '>= 12.0.0'}
+    cpu: [x64]
+    os: [darwin]
+
+  lightningcss-freebsd-x64@1.33.0:
+    resolution: {integrity: sha512-QQM/Ti/hQajJwCY+RiWuCZ9sdtI/XQk7nDK5vC8kkdwixezOlDgvDx7+RT+QjK6FcFT4MpsuoBnHIo/O3StRRg==}
+    engines: {node: '>= 12.0.0'}
+    cpu: [x64]
+    os: [freebsd]
+
+  lightningcss-linux-arm-gnueabihf@1.33.0:
+    resolution: {integrity: sha512-N7FVBe6iS24MlM6R/4RBTxGhQheZGs7tiQ9U32UtF75NzP5Q7xWPRqLBCKxlRQRk3rY1jCIPLzx7WzOhuUIRLQ==}
+    engines: {node: '>= 12.0.0'}
+    cpu: [arm]
+    os: [linux]
+
+  lightningcss-linux-arm64-gnu@1.33.0:
+    resolution: {integrity: sha512-j2v/itmy4HlNxlc6voKXYgBqNi0Ng2LShg4z7GufpEgs05P+2suBVyi9I6YHq5uoVFx9ETin3eCEhLVyXGQnKg==}
+    engines: {node: '>= 12.0.0'}
+    cpu: [arm64]
+    os: [linux]
+
+  lightningcss-linux-arm64-musl@1.33.0:
+    resolution: {integrity: sha512-yiO5ROMuYQgXbC60yjZU5CYSFZGKXL0HFATXt9mHJn1+zW55oCtMI9NfcVhYLMFDL7gV7oBPon/EmMMGg2OvtQ==}
+    engines: {node: '>= 12.0.0'}
+    cpu: [arm64]
+    os: [linux]
+
+  lightningcss-linux-x64-gnu@1.33.0:
+    resolution: {integrity: sha512-ar+Ju7LmcN0Jo4FpL4hpFybwNG9/3A/Br5KW2n2jyODg3MEZXaDYADdemoNS+BDNfMgKvylJLj4S5tyRActuAg==}
+    engines: {node: '>= 12.0.0'}
+    cpu: [x64]
+    os: [linux]
+
+  lightningcss-linux-x64-musl@1.33.0:
+    resolution: {integrity: sha512-RYiYbkokw0trfKqqzfF55lginwEPrD3OJDfTuJzFs1MK6iFnDenaz1fqLLtX4ITG3OktJQXOeTaw1awrBAlZPw==}
+    engines: {node: '>= 12.0.0'}
+    cpu: [x64]
+    os: [linux]
+
+  lightningcss-win32-arm64-msvc@1.33.0:
+    resolution: {integrity: sha512-1K+MPfLSFVpphzpdbfkhlWk6wBrTObBzS2T6db10PNOZgR9GoVsAWzwNyuhUYYbTp23j+4RrncfujZ4uAzXvwA==}
+    engines: {node: '>= 12.0.0'}
+    cpu: [arm64]
+    os: [win32]
+
+  lightningcss-win32-x64-msvc@1.33.0:
+    resolution: {integrity: sha512-OlEICDx/Xl0FqSp4bry8zFnCvGpig3Gl4gCquvYwHuqJKEC1+n9NgDniFvqHGmMv1ZkqDJrDqKKSykTDX+ehuA==}
+    engines: {node: '>= 12.0.0'}
+    cpu: [x64]
+    os: [win32]
+
+  lightningcss@1.33.0:
+    resolution: {integrity: sha512-WkUDrojuJs0xkgGf2udWxa3yGBRxPtxUkB79i6aCZLRgc7PM8fZe9TosfPDcvEpQZbuFASnHYmRLBLUbmLOIIA==, tarball: https://registry.npmmirror.com/lightningcss/-/lightningcss-1.33.0.tgz}
+    engines: {node: '>= 12.0.0'}
+
+  linkifyjs@4.3.3:
+    resolution: {integrity: sha512-P8aEP5U/D1/IlTY2OeYsErdwh9bGuLE30NcXtKEjgdHcahveQoQwM2yZNsioQHsWFz0P7KKudisbrzCgR0sDHg==}
+
+  locate-path@5.0.0:
+    resolution: {integrity: sha512-t7hw9pI+WvuwNJXwk5zVHpyhIqzg2qTlklJOf0mVxGSbe3Fp2VieZcduNYjaLDoy6p9uGpQEGWG87WpMKlNq8g==}
+    engines: {node: '>=8'}
+
+  lodash-es@4.18.1:
+    resolution: {integrity: sha512-J8xewKD/Gk22OZbhpOVSwcs60zhd95ESDwezOFuA3/099925PdHJ7OFHNTGtajL3AlZkykD32HykiMo+BIBI8A==, tarball: https://registry.npmmirror.com/lodash-es/-/lodash-es-4.18.1.tgz}
+
+  lodash@4.18.1:
+    resolution: {integrity: sha512-dMInicTPVE8d1e5otfwmmjlxkZoUpiVLwyeTdUsi/Caj/gfzzblBcCE5sRHV/AsjuCmxWrte2TNGSYuCeCq+0Q==, tarball: https://registry.npmmirror.com/lodash/-/lodash-4.18.1.tgz}
+
+  loupe@3.2.1:
+    resolution: {integrity: sha512-CdzqowRJCeLU72bHvWqwRBBlLcMEtIvGrlvef74kMnV2AolS9Y8xUv1I0U/MNAWMhBlKIoyuEgoJ0t/bbwHbLQ==}
+
+  lru-cache@10.4.3:
+    resolution: {integrity: sha512-JNAzZcXrCt42VGLuYz0zfAzDfAvJWW6AfYlDBQyDV5DClI2m5sAmK+OIO7s59XfsRsWHp02jAJrRadPRGTt6SQ==}
+
+  lru-cache@5.1.1:
+    resolution: {integrity: sha512-KpNARQA3Iwv+jTA0utUVVbrh+Jlrr1Fv0e56GGzAFOXN7dk/FviaDW8LHmK52DlcH4WP2n6gI8vN1aesBFgo9w==, tarball: https://registry.npmmirror.com/lru-cache/-/lru-cache-5.1.1.tgz}
+
+  magic-regexp@0.10.0:
+    resolution: {integrity: sha512-Uly1Bu4lO1hwHUW0CQeSWuRtzCMNO00CmXtS8N6fyvB3B979GOEEeAkiTUDsmbYLAbvpUS/Kt5c4ibosAzVyVg==}
+
+  magic-string@0.30.21:
+    resolution: {integrity: sha512-vd2F4YUyEXKGcLHoq+TEyCjxueSeHnFxyyjNp80yg0XV4vUhnDer/lvvlqM/arB5bXQN5K2/3oinyCRyx8T2CQ==}
+
+  magicast@0.3.5:
+    resolution: {integrity: sha512-L0WhttDl+2BOsybvEOLK7fW3UA0OQ0IQ2d6Zl2x/a6vVRs3bAY0ECOSHHeL5jD+SbOpOCUEi0y1DgHEn9Qn1AQ==}
+
+  make-dir@4.0.0:
+    resolution: {integrity: sha512-hXdUTZYIVOt1Ex//jAQi+wTZZpUpwBj/0QsOzqegb3rGMMeJiSEu5xLHnYfBrRV4RH2+OCSOO95Is/7x1WJ4bw==}
+    engines: {node: '>=10'}
+
+  mdn-data@2.27.1:
+    resolution: {integrity: sha512-9Yubnt3e8A0OKwxYSXyhLymGW4sCufcLG6VdiDdUGVkPhpqLxlvP5vl1983gQjJl3tqbrM731mjaZaP68AgosQ==}
+
+  memorystream@0.3.1:
+    resolution: {integrity: sha512-S3UwM3yj5mtUSEfP41UZmt/0SCoVYUcU1rkXv+BQ5Ig8ndL4sPoJNBUJERafdPb5jjHJGuMgytgKvKIf58XNBw==, tarball: https://registry.npmmirror.com/memorystream/-/memorystream-0.3.1.tgz}
+    engines: {node: '>= 0.10.0'}
+
+  mimic-response@3.1.0:
+    resolution: {integrity: sha512-z0yWI+4FDrrweS8Zmt4Ej5HdJmky15+L2e6Wgn3+iK5fWzb6T3fhNFq2+MeTRb064c6Wr4N/wv0DzQTjNzHNGQ==}
+    engines: {node: '>=10'}
+
+  minimatch@10.2.6:
+    resolution: {integrity: sha512-vpLQEs+VLCr1nU0BXS07maYoFwlDAH0gngQuuttxIwutDFEMHq2blX+8vpgxDdK3J1PwjCJiep77OitTZ4Ll1A==}
+    engines: {node: 18 || 20 || >=22}
+
+  minimatch@9.0.9:
+    resolution: {integrity: sha512-OBwBN9AL4dqmETlpS2zasx+vTeWclWzkblfZk7KTA5j3jeOONz/tRCnZomUyvNg83wL5Zv9Ss6HMJXAgL8R2Yg==}
+    engines: {node: '>=16 || 14 >=14.17'}
+
+  minimist@1.2.8:
+    resolution: {integrity: sha512-2yyAR8qBkN3YuheJanUpWC5U3bb5osDywNB8RzDVlDwDHbocAJveqqj1u8+SVD7jkWT4yvsHCpWqqWqAxb0zCA==}
+
+  minipass@7.1.3:
+    resolution: {integrity: sha512-tEBHqDnIoM/1rXME1zgka9g6Q2lcoCkxHLuc7ODJ5BxbP5d4c2Z5cGgtXAku59200Cx7diuHTOYfSBD8n6mm8A==}
+    engines: {node: '>=16 || 14 >=14.17'}
+
+  mkdirp-classic@0.5.3:
+    resolution: {integrity: sha512-gKLcREMhtuZRwRAfqP3RFW+TK4JqApVBtOIftVgjuABpAtpxhPGaDcfvbhNvD0B8iD1oUr/txX35NjcaY6Ns/A==}
+
+  mlly@1.8.2:
+    resolution: {integrity: sha512-d+ObxMQFmbt10sretNDytwt85VrbkhhUA/JBGm1MPaWJ65Cl4wOgLaB1NYvJSZ0Ef03MMEU/0xpPMXUIQ29UfA==, tarball: https://registry.npmmirror.com/mlly/-/mlly-1.8.2.tgz}
+
+  mrmime@2.0.1:
+    resolution: {integrity: sha512-Y3wQdFg2Va6etvQ5I82yUhGdsKrcYox6p7FfL1LbK2J4V01F9TGlepTIhnK24t7koZibmg82KGglhA1XK5IsLQ==, tarball: https://registry.npmmirror.com/mrmime/-/mrmime-2.0.1.tgz}
+    engines: {node: '>=10'}
+
+  ms@2.1.3:
+    resolution: {integrity: sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA==}
+
+  muggle-string@0.4.1:
+    resolution: {integrity: sha512-VNTrAak/KhO2i8dqqnqnAHOa3cYBwXEZe9h+D5h/1ZqFSTEFHdM65lR7RoIqq3tBBYavsOXV84NoHXZ0AkPyqQ==, tarball: https://registry.npmmirror.com/muggle-string/-/muggle-string-0.4.1.tgz}
+
+  mustache@4.2.0:
+    resolution: {integrity: sha512-71ippSywq5Yb7/tVYyGbkBggbU8H3u5Rz56fH60jGFgr8uHwxs+aSKeqmluIVzM0m0kB7xQjKS6qPfd0b2ZoqQ==}
+    hasBin: true
+
+  naive-ui@2.44.1:
+    resolution: {integrity: sha512-reo8Esw0p58liZwbUutC7meW24Xbn3EwNv91zReWKm2W4JPu+zfgJRn/F7aO0BFmvN+h2brA2M5lRvYqLq4kuA==, tarball: https://registry.npmmirror.com/naive-ui/-/naive-ui-2.44.1.tgz}
+    engines: {node: '>=20'}
+    peerDependencies:
+      vue: ^3.0.0
+
+  nanoid@3.3.17:
+    resolution: {integrity: sha512-xQLf0A3HOMlgHq0n247/LRuAOYmB7dXJ/DvAxGvsSBij45XtBSmQycu+F8ODbHwns/XyFZagyL1+J0Offw1E0g==, tarball: https://registry.npmmirror.com/nanoid/-/nanoid-3.3.17.tgz}
+    engines: {node: ^10 || ^12 || ^13.7 || ^14 || >=15.0.1}
+    hasBin: true
+
+  napi-build-utils@2.0.0:
+    resolution: {integrity: sha512-GEbrYkbfF7MoNaoh2iGG84Mnf/WZfB0GdGEsM8wz7Expx/LlWf5U8t9nvJKXSp3qr5IsEbK04cBGhol/KwOsWA==}
+
+  node-abi@3.94.0:
+    resolution: {integrity: sha512-W5ZNO5KRPB5TkYmGVD9F6YqhsglXJzE6etpbmT+f6EQElhiX/UTG551cnsRGvLG3fyZEg9HwaDmNmj5nwJ4z9g==}
+    engines: {node: '>=10'}
+
+  node-addon-api@7.1.1:
+    resolution: {integrity: sha512-5m3bsyrjFWE1xf7nz7YXdN4udnVtXK6/Yfgn5qnahL6bCkf2yKt4k3nuTKAtT4r3IG8JNR2ncsIMdZuAzJjHQQ==}
+
+  node-fetch-native@1.6.7:
+    resolution: {integrity: sha512-g9yhqoedzIUm0nTnTqAQvueMPVOuIY16bqgAJJC8XOOubYFNwz6IER9qs0Gq2Xd0+CecCKFjtdDTMA4u4xG06Q==}
+
+  node-releases@2.0.52:
+    resolution: {integrity: sha512-MRlTqhAfoMx/4mhEbPo3Hi02g9LJZaJkka69V6h67Cb1gjrAG0jsTE4CZX1eptNx+VCAwJmfpnDIF4P0Nh1A7A==, tarball: https://registry.npmmirror.com/node-releases/-/node-releases-2.0.52.tgz}
+    engines: {node: '>=18'}
+
+  nostics@1.2.0:
+    resolution: {integrity: sha512-FGqEfhQjrvo1lL8KFifdTQiNwwQHJxC1jtYE1Rc54qF/jxONUNL+kC9gS1krX8Q65PgrQ5fCqH/I4NhWBvdSqg==, tarball: https://registry.npmmirror.com/nostics/-/nostics-1.2.0.tgz}
+
+  npm-normalize-package-bin@6.0.0:
+    resolution: {integrity: sha512-tdt4aFn9QamlhdN3HV2D2ccpBwO5/fyjjbXUxYA6uBjyekMZcZvDq0aSj9t5Jo+tih6AYFnt/cuIRn9013e0Uw==, tarball: https://registry.npmmirror.com/npm-normalize-package-bin/-/npm-normalize-package-bin-6.0.0.tgz}
+    engines: {node: ^22.22.2 || ^24.15.0 || >=26.0.0}
+
+  npm-run-all2@9.0.3:
+    resolution: {integrity: sha512-BQAEdU1PtYc48qYRdghW2BVTQT3VqWCoFQmO87NlM1h1PYwMCKQpUWaNyB20V26caNzFsXQDfyOdznLlHCih6g==, tarball: https://registry.npmmirror.com/npm-run-all2/-/npm-run-all2-9.0.3.tgz}
+    engines: {node: ^22.22.2 || ^24.15.0 || >=26.0.0, npm: '>= 10'}
+    hasBin: true
+
+  nwsapi@2.2.24:
+    resolution: {integrity: sha512-7YRhZ3jS45LwmSCT4b2sVFHt/WuovaktDU07QrtOBY2PXskss5a9jfmR9jptyumwXST+rFjrmppMY1KT/yn35A==}
+
+  obug@2.1.4:
+    resolution: {integrity: sha512-4a+OsYv9UktOJKE+l1A4OufDgdRF9PifWj+tJnHURo/P+WOxpG4GzUFL9qCalmWauao6ogiG+QvnCovwPoyAWA==, tarball: https://registry.npmmirror.com/obug/-/obug-2.1.4.tgz}
+    engines: {node: '>=12.20.0'}
+
+  ofetch@1.5.1:
+    resolution: {integrity: sha512-2W4oUZlVaqAPAil6FUg/difl6YhqhUR7x2eZY4bQCko22UXg3hptq9KLQdqFClV+Wu85UX7hNtdGTngi/1BxcA==}
+
+  ohash@2.0.11:
+    resolution: {integrity: sha512-RdR9FQrFwNBNXAr4GixM8YaRZRJ5PUWbKYbE5eOsrwAjJW0q2REGcf79oYPsLyskQCZG1PLN+S/K1V00joZAoQ==, tarball: https://registry.npmmirror.com/ohash/-/ohash-2.0.11.tgz}
+
+  once@1.4.0:
+    resolution: {integrity: sha512-lNaJgI+2Q5URQBkccEKHTQOPaXdUxnZZElQTZY0MFUAuaEqe1E+Nyvgdz/aIyNi6Z9MzO5dv1H8n58/GELp3+w==}
+
+  open@11.0.0:
+    resolution: {integrity: sha512-smsWv2LzFjP03xmvFoJ331ss6h+jixfA4UUV/Bsiyuu4YJPfN+FIQGOIiv4w9/+MoHkfkJ22UIaQWRVFRfH6Vw==, tarball: https://registry.npmmirror.com/open/-/open-11.0.0.tgz}
+    engines: {node: '>=20'}
+
+  opentype.js@2.0.0:
+    resolution: {integrity: sha512-kCyjv6xdDY1W/jLWZ/L3QhhTlKUqDZMQ5+Jdlw12b3dXkKNpYBqqlMMj0YDQPShWFTMwgZI1hG14kN3XUDSg/A==}
+    hasBin: true
+
+  orderedmap@2.1.1:
+    resolution: {integrity: sha512-TvAWxi0nDe1j/rtMcWcIj94+Ffe6n7zhow33h40SKxmsmozs6dz/e+EajymfoFcHd7sxNn8yHM8839uixMOV6g==}
+
+  oxc-parser@0.131.0:
+    resolution: {integrity: sha512-SJ3/7ZPbgie8dr5Z9BI/M51zZbpXba+hRSG0MDzVwMW5CRQg2fjYE0jHGlLX4eeiibGgC/mzoDFKSDHwVZEHRQ==}
+    engines: {node: ^20.19.0 || >=22.12.0}
+
+  oxc-walker@0.7.0:
+    resolution: {integrity: sha512-54B4KUhrzbzc4sKvKwVYm7E2PgeROpGba0/2nlNZMqfDyca+yOor5IMb4WLGBatGDT0nkzYdYuzylg7n3YfB7A==}
+    peerDependencies:
+      oxc-parser: '>=0.98.0'
+
+  p-limit@2.3.0:
+    resolution: {integrity: sha512-//88mFWSJx8lxCzwdAABTJL2MyWB12+eIY7MDL2SqLmAkeKU9qxRvWuSyTjm3FUmpBEMuFfckAIqEaVGUDxb6w==}
+    engines: {node: '>=6'}
+
+  p-locate@4.1.0:
+    resolution: {integrity: sha512-R79ZZ/0wAxKGu3oYMlz8jy/kbhsNrS7SKZ7PxEHBgJ5+F2mtFW2fK2cOtBh1cHYkQsbzFV7I+EoRKe6Yt0oK7A==}
+    engines: {node: '>=8'}
+
+  p-try@2.2.0:
+    resolution: {integrity: sha512-R4nPAVTAU0B9D35/Gk3uJf/7XYbQcyohSKdvAxIRSNghFl4e71hVoGnBNQz9cWaXxO2I10KTC+3jMdvvoKw6dQ==}
+    engines: {node: '>=6'}
+
+  package-json-from-dist@1.0.1:
+    resolution: {integrity: sha512-UEZIS3/by4OC8vL3P2dTXRETpebLI2NiI5vIrjaD/5UtrkFX/tNbwjTSRAGC/+7CAo2pIcBaRgWmcBBHcsaCIw==}
+
+  package-manager-detector@1.8.0:
+    resolution: {integrity: sha512-yQA4H19AmPEoMUeavPMDIe1higySl/gH/yaQrkT/s07Qp+7pp2hYz30N3z2l5BkjVkF9Ow6o0wjJamm2y7Sn0A==}
+
+  pako@2.2.0:
+    resolution: {integrity: sha512-zJq6RP/5q+TO2OpFV3FHzlPnFjmkb7Nc99a5SNjJE+uu/PkpChs+NIZSSzbBoD+6kjiISXjfYdwj1ZRQ81dz/w==}
+
+  parse5@7.3.0:
+    resolution: {integrity: sha512-IInvU7fabl34qmi9gY8XOVxhYyMyuH2xUNpb2q8/Y+7552KlejkRvqvD19nMoUW/uQGGbqNpA6Tufu5FL5BZgw==}
+
+  path-browserify@1.0.1:
+    resolution: {integrity: sha512-b7uo2UCUOYZcnF/3ID0lulOJi/bafxa1xPe7ZPsammBSpjSWQkjNxlt635YGS2MiR9GjvuXCtz2emr3jbsz98g==, tarball: https://registry.npmmirror.com/path-browserify/-/path-browserify-1.0.1.tgz}
+
+  path-exists@4.0.0:
+    resolution: {integrity: sha512-ak9Qy5Q7jYb2Wwcey5Fpvg2KoAc/ZIhLSLOSBmRmygPsGwkVVt0fZa0qrtMz+m6tJTAHfZQ8FnmB4MG4LWy7/w==}
+    engines: {node: '>=8'}
+
+  path-key@3.1.1:
+    resolution: {integrity: sha512-ojmeN0qd+y0jszEtoY48r0Peq5dwMEkIlCOu6Q5f41lfkswXuKtYrhgoTpLnyIcHm24Uhqx+5Tqm2InSwLhE6Q==, tarball: https://registry.npmmirror.com/path-key/-/path-key-3.1.1.tgz}
+    engines: {node: '>=8'}
+
+  path-scurry@1.11.1:
+    resolution: {integrity: sha512-Xa4Nw17FS9ApQFJ9umLiJS4orGjm7ZzwUrwamcGQuHSzDyth9boKDaycYdDcZDuqYATXw4HFXgaqWTctW/v1HA==}
+    engines: {node: '>=16 || 14 >=14.18'}
+
+  pathe@2.0.3:
+    resolution: {integrity: sha512-WUjGcAqP1gQacoQe+OBJsFA7Ld4DyXuUIjZ5cc75cLHvJ7dtNsTugphxIADwspS+AraAUePCKrSVtPLFj/F88w==}
+
+  pathval@2.0.1:
+    resolution: {integrity: sha512-//nshmD55c46FuFw26xV/xFAaB5HF9Xdap7HJBBnrKdAd6/GxDBaNA1870O79+9ueg61cZLSVc+OaFlfmObYVQ==}
+    engines: {node: '>= 14.16'}
+
+  perfect-debounce@2.1.0:
+    resolution: {integrity: sha512-LjgdTytVFXeUgtHZr9WYViYSM/g8MkcTPYDlPa3cDqMirHjKiSZPYd6DoL7pK8AJQr+uWkQvCjHNdiMqsrJs+g==, tarball: https://registry.npmmirror.com/perfect-debounce/-/perfect-debounce-2.1.0.tgz}
+
+  performance-now@2.1.0:
+    resolution: {integrity: sha512-7EAHlyLHI56VEIdK57uwHdHKIaAGbnXPiw0yWbarQZOKaKpvUIgW0jWRVLiatnM+XXlSwsanIBH/hzGMJulMow==}
+
+  picocolors@1.1.1:
+    resolution: {integrity: sha512-xceH2snhtb5M9liqDsmEw56le376mTZkEX/jEb/RxNFyegNul7eNslCXP9FDj/Lcu0X8KEyMceP2ntpaHrDEVA==, tarball: https://registry.npmmirror.com/picocolors/-/picocolors-1.1.1.tgz}
+
+  picomatch@4.0.5:
+    resolution: {integrity: sha512-RvwwcruNjI1ncT5xRakeyS9Lf8lcItv34KD+aif+VH9kduAyfYBipGh12274xtenIPZ119/R9BdTBa8gAwSh0A==, tarball: https://registry.npmmirror.com/picomatch/-/picomatch-4.0.5.tgz}
+    engines: {node: '>=12'}
+
+  pidtree@1.0.0:
+    resolution: {integrity: sha512-avfAvjB9Dd0wdj3rjJX//yS+G79OO0KrS5pJHFJENjYGX6N4SMgEDBBI/yFy0lloOYSaC6XQxzpOAMPfSYFV/Q==, tarball: https://registry.npmmirror.com/pidtree/-/pidtree-1.0.0.tgz}
+    engines: {node: '>=18'}
+    hasBin: true
+
+  pinia@4.0.2:
+    resolution: {integrity: sha512-yKVVA7bSj5oRZFp/Ab9wLlmyb5gPUYEiIm4ryiWTe/xe7PtkRdMVOp1X1ggvq0c6Uj7Q0Du1HnV2mtAwM0Ks1g==, tarball: https://registry.npmmirror.com/pinia/-/pinia-4.0.2.tgz}
+    peerDependencies:
+      '@vue/devtools-api': ^8.1.5
+      typescript: '>=5.6.0'
+      vue: ^3.5.11
+    peerDependenciesMeta:
+      typescript:
+        optional: true
+
+  pkg-types@1.3.1:
+    resolution: {integrity: sha512-/Jm5M4RvtBFVkKWRu2BLUTNP8/M2a+UwuAX+ae4770q1qVGtfjG+WTCupoZixokjmHiry8uI+dlY8KXYV5HVVQ==, tarball: https://registry.npmmirror.com/pkg-types/-/pkg-types-1.3.1.tgz}
+
+  pngjs@5.0.0:
+    resolution: {integrity: sha512-40QW5YalBNfQo5yRYmiw7Yz6TKKVr3h6970B2YE+3fQpsWcrbj1PzJgxeJ19DRQjhMbKPIuMY8rFaXc8moolVw==}
+    engines: {node: '>=10.13.0'}
+
+  postcss@8.5.25:
+    resolution: {integrity: sha512-DTPx3RWSSnWyzLxQnlH0rJP+EW5ekl16ZU4/psbIhA0e53kJfdgaN5vKM+xP7yJtXVu+nfdVFmlgFDEKAe4Pyw==, tarball: https://registry.npmmirror.com/postcss/-/postcss-8.5.25.tgz}
+    engines: {node: ^10 || ^12 || >=14}
+
+  powershell-utils@0.1.0:
+    resolution: {integrity: sha512-dM0jVuXJPsDN6DvRpea484tCUaMiXWjuCn++HGTqUWzGDjv5tZkEZldAJ/UMlqRYGFrD/etByo4/xOuC/snX2A==, tarball: https://registry.npmmirror.com/powershell-utils/-/powershell-utils-0.1.0.tgz}
+    engines: {node: '>=20'}
+
+  prebuild-install@7.1.3:
+    resolution: {integrity: sha512-8Mf2cbV7x1cXPUILADGI3wuhfqWvtiLA1iclTDbFRZkgRQS0NqsPZphna9V+HyTEadheuPmjaJMsbzKQFOzLug==}
+    engines: {node: '>=10'}
+    deprecated: No longer maintained. Please contact the author of the relevant native addon; alternatives are available.
+    hasBin: true
+
+  prettier@3.9.5:
+    resolution: {integrity: sha512-/FVl766LpUfB5vXgCYOYa0MeV/441Ia99AeICQIQFTY/Nw0roZwULcXpku5i1/m5kt/baz+s4Zogspd839HSMg==, tarball: https://registry.npmmirror.com/prettier/-/prettier-3.9.5.tgz}
+    engines: {node: '>=14'}
+    hasBin: true
+
+  prosemirror-changeset@2.4.1:
+    resolution: {integrity: sha512-96WBLhOaYhJ+kPhLg3uW359Tz6I/MfcrQfL4EGv4SrcqKEMC1gmoGrXHecPE8eOwTVCJ4IwgfzM8fFad25wNfw==}
+
+  prosemirror-commands@1.7.2:
+    resolution: {integrity: sha512-q6Q6szxqdu9Xd6EcdKsqXghu5nQdZTpB4Q9yd04WRc7/jt763e/rT60Owh0L1GYY+T46o5rD+9lEN36dZS43tw==}
+
+  prosemirror-dropcursor@1.8.3:
+    resolution: {integrity: sha512-FoYbsJR8gK+DGlqhNoE29Loa38eIZPzQRIb1VMaDNBoo4OLP6vVof/jR8qFY/6XvUd6Dhug8MDCHl2a/h8RTfQ==}
+
+  prosemirror-gapcursor@1.4.1:
+    resolution: {integrity: sha512-pMdYaEnjNMSwl11yjEGtgTmLkR08m/Vl+Jj443167p9eB3HVQKhYCc4gmHVDsLPODfZfjr/MmirsdyZziXbQKw==}
+
+  prosemirror-history@1.5.0:
+    resolution: {integrity: sha512-zlzTiH01eKA55UAf1MEjtssJeHnGxO0j4K4Dpx+gnmX9n+SHNlDqI2oO1Kv1iPN5B1dm5fsljCfqKF9nFL6HRg==}
+
+  prosemirror-inputrules@1.5.1:
+    resolution: {integrity: sha512-7wj4uMjKaXWAQ1CDgxNzNtR9AlsuwzHfdFH1ygEHA2KHF2DOEaXl1CJfNPAKCg9qNEh4rum975QLaCiQPyY6Fw==}
+
+  prosemirror-keymap@1.2.3:
+    resolution: {integrity: sha512-4HucRlpiLd1IPQQXNqeo81BGtkY8Ai5smHhKW9jjPKRc2wQIxksg7Hl1tTI2IfT2B/LgX6bfYvXxEpJl7aKYKw==}
+
+  prosemirror-model@1.25.11:
+    resolution: {integrity: sha512-QWg9RhnpLlogAmp3p96uEFrE5txQpFynd4vhBAELkwgOCWQs/X0yCzB3/hrHqiPwf91RG5KyWq6553zs9JqIOQ==}
+
+  prosemirror-schema-list@1.5.1:
+    resolution: {integrity: sha512-927lFx/uwyQaGwJxLWCZRkjXG0p48KpMj6ueoYiu4JX05GGuGcgzAy62dfiV8eFZftgyBUvLx76RsMe20fJl+Q==}
+
+  prosemirror-state@1.4.4:
+    resolution: {integrity: sha512-6jiYHH2CIGbCfnxdHbXZ12gySFY/fz/ulZE333G6bPqIZ4F+TXo9ifiR86nAHpWnfoNjOb3o5ESi7J8Uz1jXHw==}
+
+  prosemirror-tables@1.8.5:
+    resolution: {integrity: sha512-V/0cDCsHKHe/tfWkeCmthNUcEp1IVO3p6vwN8XtwE9PZQLAZJigbw3QoraAdfJPir4NKJtNvOB8oYGKRl+t0Dw==}
+
+  prosemirror-transform@1.12.0:
+    resolution: {integrity: sha512-GxboyN4AMIsoHNtz5uf2r2Ru551i5hWeCMD6E2Ib4Eogqoub0NflniaBPVQ4MrGE5yZ8JV9tUHg9qcZTTrcN4w==}
+
+  prosemirror-view@1.42.2:
+    resolution: {integrity: sha512-Pdg0l5kXm8aLDquFAnQFTCITg0q44sLqBlHlpsVLD9segdOao8TOfQdAhCrCXyVgPSRr6UDDROOIWA3bIrN9YQ==}
+
+  pump@3.0.4:
+    resolution: {integrity: sha512-VS7sjc6KR7e1ukRFhQSY5LM2uBWAUPiOPa/A3mkKmiMwSmRFUITt0xuj+/lesgnCv+dPIEYlkzrcyXgquIHMcA==}
+
+  punycode@2.3.1:
+    resolution: {integrity: sha512-vYt7UD1U9Wg6138shLtLOvdAu+8DsC/ilFtEVHcH+wydcSpNE20AfSOduf6MkRFahL5FY7X1oU7nKVZFtfq8Fg==}
+    engines: {node: '>=6'}
+
+  qrcode@1.5.4:
+    resolution: {integrity: sha512-1ca71Zgiu6ORjHqFBDpnSMTR2ReToX4l1Au1VFLyVeBTFavzQnv5JxMFr3ukHVKpSrSA2MCk0lNJSykjUfz7Zg==}
+    engines: {node: '>=10.13.0'}
+    hasBin: true
+
+  quansync@1.0.0:
+    resolution: {integrity: sha512-5xZacEEufv3HSTPQuchrvV6soaiACMFnq1H8wkVioctoH3TRha9Sz66lOxRwPK/qZj7HPiSveih9yAyh98gvqA==}
+
+  raf@3.4.1:
+    resolution: {integrity: sha512-Sq4CW4QhwOHE8ucn6J34MqtZCeWFP2aQSmrlroYgqAV1PjStIhJXxYuTgUIfkEk7zTLjmIjLmU5q+fbD1NnOJA==}
+
+  rc@1.2.8:
+    resolution: {integrity: sha512-y3bGgqKj3QBdxLbLkomlohkvsA8gdAiUQlSBJnBhfn+BPxg4bc62d8TcBW15wavDfgexCgccckhcZvywyQYPOw==}
+    hasBin: true
+
+  read-package-json-fast@6.0.0:
+    resolution: {integrity: sha512-PNaGjoCnw9DBA2Kl8D+8po957z778q/HOPuY2u3Bkw/JO3eC8MDx7jn/PgMtSgpcBbs+6UOjDbwReGpXmRvs0g==, tarball: https://registry.npmmirror.com/read-package-json-fast/-/read-package-json-fast-6.0.0.tgz}
+    engines: {node: ^22.22.2 || ^24.15.0 || >=26.0.0}
+
+  readable-stream@3.6.2:
+    resolution: {integrity: sha512-9u/sniCrY3D5WdsERHzHE4G2YCXqoG5FTHUiCC4SIbr6XcLZBY05ya9EKjYek9O5xOAwjGq+1JdGBAS7Q9ScoA==}
+    engines: {node: '>= 6'}
+
+  readdirp@5.0.0:
+    resolution: {integrity: sha512-9u/XQ1pvrQtYyMpZe7DXKv2p5CNvyVwzUB6uhLAnQwHMSgKMBR62lc7AHljaeteeHXn11XTAaLLUVZYVZyuRBQ==, tarball: https://registry.npmmirror.com/readdirp/-/readdirp-5.0.0.tgz}
+    engines: {node: '>= 20.19.0'}
+
+  regenerator-runtime@0.13.11:
+    resolution: {integrity: sha512-kY1AZVr2Ra+t+piVaJ4gxaFaReZVH40AKNo7UCX6W+dEwBo/2oZJzqfuN1qLq1oL45o56cPaTXELwrTh8Fpggg==}
+
+  regexp-tree@0.1.27:
+    resolution: {integrity: sha512-iETxpjK6YoRWJG5o6hXLwvjYAoW+FEZn9os0PD/b6AP6xQwsa/Y7lCVgIixBbUPMfhu+i2LtdeAqVTgGlQarfA==}
+    hasBin: true
+
+  require-directory@2.1.1:
+    resolution: {integrity: sha512-fGxEI7+wsG9xrvdjsrlmL22OMTTiHRwAMroiEeMgq8gzoLC/PQr7RsRDSTLUg/bZAZtF+TVIkHc6/4RIKrui+Q==}
+    engines: {node: '>=0.10.0'}
+
+  require-from-string@2.0.2:
+    resolution: {integrity: sha512-Xf0nWe6RseziFMu+Ap9biiUbmplq6S9/p+7w7YXP/JBHhrUDDUhwa+vANyubuqfZWTveU//DYVGsDG7RKL/vEw==}
+    engines: {node: '>=0.10.0'}
+
+  require-main-filename@2.0.0:
+    resolution: {integrity: sha512-NKN5kMDylKuldxYLSUfrbo5Tuzh4hd+2E8NPPX02mZtn1VuREQToYe/ZdlJy+J3uCpfaiGF05e7B8W0iXbQHmg==}
+
+  rgbcolor@1.0.1:
+    resolution: {integrity: sha512-9aZLIrhRaD97sgVhtJOW6ckOEh6/GnvQtdVNfdZ6s67+3/XwLS9lBcQYzEEhYVeUowN7pRzMLsyGhK2i/xvWbw==}
+    engines: {node: '>= 0.8.15'}
+
+  rolldown@1.2.3:
+    resolution: {integrity: sha512-rn9wpmxplLf7NLNyCk9FyWh3FM43DbY8jOzCdEPzH7uflhTftRbCEpqi6Ly2osgoU8OwObtmavMbWLaWy4LX7A==, tarball: https://registry.npmmirror.com/rolldown/-/rolldown-1.2.3.tgz}
+    engines: {node: ^20.19.0 || >=22.12.0}
+    hasBin: true
+
+  rollup@4.62.4:
+    resolution: {integrity: sha512-RXOqwaPsBGjMNMa4sQjDjHieHEZDFoj/Rdr46l2MU5DfEs16wHJPC2RPTPHWhNl+M3aI472LLqFkFKut4SblOg==}
+    engines: {node: '>=18.0.0', npm: '>=8.0.0'}
+    hasBin: true
+
+  rope-sequence@1.3.4:
+    resolution: {integrity: sha512-UT5EDe2cu2E/6O4igUr5PSFs23nvvukicWHx6GnOPlHAiiYbzNuCRQCuiUdHJQcqKalLKlrYJnjY0ySGsXNQXQ==}
+
+  rrweb-cssom@0.8.0:
+    resolution: {integrity: sha512-guoltQEx+9aMf2gDZ0s62EcV8lsXR+0w8915TC3ITdn2YueuNjdAYh/levpU9nFaoChh9RUS5ZdQMrKfVEN9tw==}
+
+  run-applescript@7.1.0:
+    resolution: {integrity: sha512-DPe5pVFaAsinSaV6QjQ6gdiedWDcRCbUuiQfQa2wmWV7+xC9bGulGI8+TdRmoFkAPaBXk8CrAbnlY2ISniJ47Q==, tarball: https://registry.npmmirror.com/run-applescript/-/run-applescript-7.1.0.tgz}
+    engines: {node: '>=18'}
+
+  safe-buffer@5.2.1:
+    resolution: {integrity: sha512-rp3So07KcdmmKbGvgaNxQSJr7bGVSVk5S9Eq1F+ppbRo70+YeaDxkw5Dd8NPN+GD6bjnYm2VuPuCXmpuYvmCXQ==}
+
+  safer-buffer@2.1.2:
+    resolution: {integrity: sha512-YZo3K82SD7Riyi0E1EQPojLz7kpepnSQI9IyPbHHg1XXXevb5dJI7tpyN2ADxGcQbHG7vcyRHk0cbwqcQriUtg==}
+
+  saxes@6.0.0:
+    resolution: {integrity: sha512-xAg7SOnEhrm5zI3puOOKyy1OMcMlIJZYNJY7xLBwSze0UjhPLnWfj2GF2EpT0jmzaJKIWKHLsaSSajf35bcYnA==}
+    engines: {node: '>=v12.22.7'}
+
+  seemly@0.3.10:
+    resolution: {integrity: sha512-2+SMxtG1PcsL0uyhkumlOU6Qo9TAQ/WyH7tthnPIOQB05/12jz9naq6GZ6iZ6ApVsO3rr2gsnTf3++OV63kE1Q==, tarball: https://registry.npmmirror.com/seemly/-/seemly-0.3.10.tgz}
+
+  semver@6.3.1:
+    resolution: {integrity: sha512-BR7VvDCVHO+q2xBEWskxS6DJE1qRnb7DxzUrogb71CWoSficBxYsiAGd+Kl0mmq/MprG9yArRkyrQxTO6XjMzA==, tarball: https://registry.npmmirror.com/semver/-/semver-6.3.1.tgz}
+    hasBin: true
+
+  semver@7.8.5:
+    resolution: {integrity: sha512-Y7/KDsb8LjooZpwaqGyulO6DQlksgCncchHGk+sZIY4SBvUocMBEFH5Ur1fI4dV+Jvl0w6cjvucaIi40puRioA==}
+    engines: {node: '>=10'}
+    hasBin: true
+
+  set-blocking@2.0.0:
+    resolution: {integrity: sha512-KiKBS8AnWGEyLzofFfmvKwpdPzqiy16LvQfK3yv/fVH7Bj13/wl3JSR1J+rfgRE9q7xUJK4qvgS8raSOeLUehw==}
+
+  shebang-command@2.0.0:
+    resolution: {integrity: sha512-kHxr2zZpYtdmrN1qDjrrX/Z1rR1kG8Dx+gkpK1G4eXmvXswmcE1hTWBWYUzlraYw1/yZp6YuDY77YtvbN0dmDA==, tarball: https://registry.npmmirror.com/shebang-command/-/shebang-command-2.0.0.tgz}
+    engines: {node: '>=8'}
+
+  shebang-regex@3.0.0:
+    resolution: {integrity: sha512-7++dFhtcx3353uBaq8DDR4NuxBetBzC7ZQOhmTQInHEd6bSrXdiEyzCvG07Z44UYdLShWUyXt5M/yhz8ekcb1A==, tarball: https://registry.npmmirror.com/shebang-regex/-/shebang-regex-3.0.0.tgz}
+    engines: {node: '>=8'}
+
+  shell-quote@1.10.0:
+    resolution: {integrity: sha512-w1aiOKwKuRgtwAReIIj89puqg+I7GvX4IbLrvmhXbzQsj1+Zwi4VO3+fa6ZF91TWSjIxoEkKnMeHcLEODK5ZXA==, tarball: https://registry.npmmirror.com/shell-quote/-/shell-quote-1.10.0.tgz}
+    engines: {node: '>= 0.4'}
+
+  siginfo@2.0.0:
+    resolution: {integrity: sha512-ybx0WO1/8bSBLEWXZvEd7gMW3Sn3JFlW3TvX1nREbDLRNQNaeNN8WK0meBwPdAaOI7TtRRRJn/Es1zhrrCHu7g==}
+
+  signal-exit@4.1.0:
+    resolution: {integrity: sha512-bzyZ1e88w9O1iNJbKnOlvYTrWPDl46O1bG0D3XInv+9tkPrxrN8jUUTiFlDkkmKWgn1M6CfIA13SuGqOa9Korw==}
+    engines: {node: '>=14'}
+
+  simple-concat@1.0.1:
+    resolution: {integrity: sha512-cSFtAPtRhljv69IK0hTVZQ+OfE9nePi/rtJmw5UjHeVyVroEqJXP1sFztKUy1qU+xvz3u/sfYJLa947b7nAN2Q==}
+
+  simple-get@4.0.1:
+    resolution: {integrity: sha512-brv7p5WgH0jmQJr1ZDDfKDOSeWWg+OVypG99A/5vYGPqJ6pxiaHLy8nxtFjBA7oMa01ebA9gfh1uMCFqOuXxvA==}
+
+  sirv@3.0.2:
+    resolution: {integrity: sha512-2wcC/oGxHis/BoHkkPwldgiPSYcpZK3JU28WoMVv55yHJgcZ8rlXvuG9iZggz+sU1d4bRgIGASwyWqjxu3FM0g==, tarball: https://registry.npmmirror.com/sirv/-/sirv-3.0.2.tgz}
+    engines: {node: '>=18'}
+
+  source-map-js@1.2.1:
+    resolution: {integrity: sha512-UXWMKhLOwVKb728IUtQPXxfYU+usdybtUrK/8uGE8CQMvrhOpwvzDBwj0QhSL7MQc7vIsISBG8VQ8+IDQxpfQA==, tarball: https://registry.npmmirror.com/source-map-js/-/source-map-js-1.2.1.tgz}
+    engines: {node: '>=0.10.0'}
+
+  specificity@0.4.1:
+    resolution: {integrity: sha512-1klA3Gi5PD1Wv9Q0wUoOQN1IWAuPu0D1U03ThXTr0cJ20+/iq2tHSDnK7Kk/0LXJ1ztUB2/1Os0wKmfyNgUQfg==}
+    hasBin: true
+
+  ssf@0.11.2:
+    resolution: {integrity: sha512-+idbmIXoYET47hH+d7dfm2epdOMUDjqcB4648sTZ+t2JwoyBFL/insLfB/racrDmsKB3diwsDA696pZMieAC5g==}
+    engines: {node: '>=0.8'}
+
+  stackback@0.0.2:
+    resolution: {integrity: sha512-1XMJE5fQo1jGH6Y/7ebnwPOBEkIEnT4QF32d5R1+VXdXveM0IBMJt8zfaxX1P3QhVwrYe+576+jkANtSS2mBbw==}
+
+  stackblur-canvas@2.7.0:
+    resolution: {integrity: sha512-yf7OENo23AGJhBriGx0QivY5JP6Y1HbrrDI6WLt6C5auYZXlQrheoY8hD4ibekFKz1HOfE48Ww8kMWMnJD/zcQ==}
+    engines: {node: '>=0.1.14'}
+
+  std-env@3.10.0:
+    resolution: {integrity: sha512-5GS12FdOZNliM5mAOxFRg7Ir0pWz8MdpYm6AY6VPkGpbA7ZzmbzNcBJQ0GPvvyWgcY7QAhCgf9Uy89I03faLkg==}
+
+  string-width@4.2.3:
+    resolution: {integrity: sha512-wKyQRQpjJ0sIp62ErSZdGsjMJWsap5oRNihHhu6G7JVO/9jIB6UyevL+tXuOqrng8j/cxKTWyWUwvSTriiZz/g==}
+    engines: {node: '>=8'}
+
+  string-width@5.1.2:
+    resolution: {integrity: sha512-HnLOCR3vjcY8beoNLtcjZ5/nxn2afmME6lhrDrebokqMap+XbeW8n9TXpPDOqdGK5qcI3oT0GKTW6wC7EMiVqA==}
+    engines: {node: '>=12'}
+
+  string_decoder@1.3.0:
+    resolution: {integrity: sha512-hkRX8U1WjJFd8LsDJ2yQ/wWWxaopEsABU1XfkM8A+j0+85JAGppt16cr1Whg6KIbb4okU6Mql6BOj+uup/wKeA==}
+
+  strip-ansi@6.0.1:
+    resolution: {integrity: sha512-Y38VPSHcqkFrCpFnQ9vuSXmquuv5oXOKpGeT6aGrr3o3Gc9AlVa6JBfUSOCnbxGGZF+/0ooI7KrPuUSztUdU5A==}
+    engines: {node: '>=8'}
+
+  strip-ansi@7.2.0:
+    resolution: {integrity: sha512-yDPMNjp4WyfYBkHnjIRLfca1i6KMyGCtsVgoKe/z1+6vukgaENdgGBZt+ZmKPc4gavvEZ5OgHfHdrazhgNyG7w==}
+    engines: {node: '>=12'}
+
+  strip-json-comments@2.0.1:
+    resolution: {integrity: sha512-4gB8na07fecVVkOI6Rs4e7T6NOTki5EmL7TUduTs6bu3EdnSycntVJ4re8kgZA+wx9IueI2Y11bfbgwtzuE0KQ==}
+    engines: {node: '>=0.10.0'}
+
+  strip-literal@3.1.0:
+    resolution: {integrity: sha512-8r3mkIM/2+PpjHoOtiAW8Rg3jJLHaV7xPwG+YRGrv6FP0wwk/toTpATxWYOW0BKdWwl82VT2tFYi5DlROa0Mxg==}
+
+  style-mod@4.1.3:
+    resolution: {integrity: sha512-i/n8VsZydrugj3Iuzll8+x/00GH2vnYsk1eomD8QiRrSAeW6ItbCQDtfXCeJHd0iwiNagqjQkvpvREEPtW3IoQ==}
+
+  stylis@4.4.0:
+    resolution: {integrity: sha512-5Z9ZpRzfuH6l/UAvCPAPUo3665Nk2wLaZU3x+TLHKVzIz33+sbJqbtrYoC3KD4/uVOr2Zp+L0LySezP9OHV9yA==}
+
+  supports-color@7.2.0:
+    resolution: {integrity: sha512-qpCAvRl9stuOHveKsn7HncJRvv501qIacKzQlO/+Lwxc9+0q2wLyv4Dfvt80/DPn2pqOBsJdDiogXGR9+OvwRw==}
+    engines: {node: '>=8'}
+
+  svg-pathdata@6.0.3:
+    resolution: {integrity: sha512-qsjeeq5YjBZ5eMdFuUa4ZosMLxgr5RZ+F+Y1OrDhuOCEInRMA3x74XdBtggJcj9kOeInz0WE+LgCPDkZFlBYJw==}
+    engines: {node: '>=12.0.0'}
+
+  svg2pdf.js@2.7.0:
+    resolution: {integrity: sha512-nXK4Wx28H0KtOktanm5nsphl1KMEoLNMelAT/776qxPAj9DshwYcqgdpKuBnY1nrcYOriQFHVQLE4tIag+aDJA==}
+    peerDependencies:
+      jspdf: ^4.0.0 || ^3.0.0 || ^2.0.0
+
+  svgpath@2.6.0:
+    resolution: {integrity: sha512-OIWR6bKzXvdXYyO4DK/UWa1VA1JeKq8E+0ug2DG98Y/vOmMpfZNj+TIG988HjfYSqtcy/hFOtZq/n/j5GSESNg==}
+
+  symbol-tree@3.2.4:
+    resolution: {integrity: sha512-9QNk5KwDF+Bvz+PyObkmSYjI5ksVUYtjW7AU22r2NKcfLJcXp96hkDWU3+XndOsUb+AQ9QhfzfCT2O+CNWT5Tw==}
+
+  tar-fs@2.1.5:
+    resolution: {integrity: sha512-OboTd8mmMhZDNPV+UjQcK9yKAatXu2aJ+r1w4im1Otd4M4fl2hwvdoXUxIYHFTHWK/3y3FarBP70v3vwmGlOxw==}
+
+  tar-stream@2.2.0:
+    resolution: {integrity: sha512-ujeqbceABgwMZxEJnk2HDY2DlnUZ+9oEcb1KzTVfYHio0UE6dG71n60d8D2I4qNvleWrrXpmjpt7vZeF1LnMZQ==}
+    engines: {node: '>=6'}
+
+  test-exclude@7.0.2:
+    resolution: {integrity: sha512-u9E6A+ZDYdp7a4WnarkXPZOx8Ilz46+kby6p1yZ8zsGTz9gYa6FIS7lj2oezzNKmtdyyJNNmmXDppga5GB7kSw==}
+    engines: {node: '>=18'}
+
+  text-segmentation@1.0.3:
+    resolution: {integrity: sha512-iOiPUo/BGnZ6+54OsWxZidGCsdU8YbE4PSpdPinp7DeMtUJNJBoJ/ouUSTJjHkh1KntHaltHl/gDs2FC4i5+Nw==}
+
+  tinybench@2.9.0:
+    resolution: {integrity: sha512-0+DUvqWMValLmha6lr4kD8iAMK1HzV0/aKnCtWb9v9641TnP/MFb7Pc2bxoxQjTXAErryXVgUOfv2YqNllqGeg==}
+
+  tinyexec@0.3.2:
+    resolution: {integrity: sha512-KQQR9yN7R5+OSwaK0XQoj22pwHoTlgYqmUscPYoknOoWCWfj/5/ABTMRi69FrKU5ffPVh5QcFikpWJI/P1ocHA==}
+
+  tinyexec@1.3.0:
+    resolution: {integrity: sha512-QKAl9m8gWWGHV8jZcPeym6j+XULi6tOf1mT83WYJ4Lk2ytW/uwAWkrP0uFsdoYMdueVJ0qs26wZ+23xeB4ibNQ==}
+    engines: {node: '>=18'}
+
+  tinyglobby@0.2.17:
+    resolution: {integrity: sha512-wXR/dYpcqKmfWpEdZjiKJOwCNFndD0DMnrW/cYjVGttEkBfVgcLFHoNrlj47mjOVic9yyNu65alsgF4NQyTa2g==, tarball: https://registry.npmmirror.com/tinyglobby/-/tinyglobby-0.2.17.tgz}
+    engines: {node: '>=12.0.0'}
+
+  tinypool@1.1.1:
+    resolution: {integrity: sha512-Zba82s87IFq9A9XmjiX5uZA/ARWDrB03OHlq+Vw1fSdt0I+4/Kutwy8BP4Y/y/aORMo61FQ0vIb5j44vSo5Pkg==}
+    engines: {node: ^18.0.0 || >=20.0.0}
+
+  tinyrainbow@2.0.0:
+    resolution: {integrity: sha512-op4nsTR47R6p0vMUUoYl/a+ljLFVtlfaXkLQmqfLR1qHma1h/ysYk4hEXZ880bf2CYgTskvTa/e196Vd5dDQXw==}
+    engines: {node: '>=14.0.0'}
+
+  tinyspy@4.0.4:
+    resolution: {integrity: sha512-azl+t0z7pw/z958Gy9svOTuzqIk6xq+NSheJzn5MMWtWTFywIacg2wUlzKFGtt3cthx0r2SxMK0yzJOR0IES7Q==}
+    engines: {node: '>=14.0.0'}
+
+  tldts-core@6.1.86:
+    resolution: {integrity: sha512-Je6p7pkk+KMzMv2XXKmAE3McmolOQFdxkKw0R8EYNr7sELW46JqnNeTX8ybPiQgvg1ymCoF8LXs5fzFaZvJPTA==}
+
+  tldts@6.1.86:
+    resolution: {integrity: sha512-WMi/OQ2axVTf/ykqCQgXiIct+mSQDFdH2fkwhPwgEwvJ1kSzZRiinb0zF2Xb8u4+OqPChmyI6MEu4EezNJz+FQ==}
+    hasBin: true
+
+  totalist@3.0.1:
+    resolution: {integrity: sha512-sf4i37nQ2LBx4m3wB74y+ubopq6W/dIzXg0FDGjsYnZHVa1Da8FH853wlL2gtUhg+xJXjfk3kUZS3BRoQeoQBQ==, tarball: https://registry.npmmirror.com/totalist/-/totalist-3.0.1.tgz}
+    engines: {node: '>=6'}
+
+  tough-cookie@5.1.2:
+    resolution: {integrity: sha512-FVDYdxtnj0G6Qm/DhNPSb8Ju59ULcup3tuJxkFb5K8Bv2pUXILbf0xZWU8PX8Ov19OXljbUyveOFwRMwkXzO+A==}
+    engines: {node: '>=16'}
+
+  tr46@5.1.1:
+    resolution: {integrity: sha512-hdF5ZgjTqgAntKkklYw0R03MG2x/bSzTtkxmIRw/sTNV8YXsCJ1tfLAX23lhxhHJlEf3CRCOCGGWw3vI3GaSPw==}
+    engines: {node: '>=18'}
+
+  treemate@0.3.11:
+    resolution: {integrity: sha512-M8RGFoKtZ8dF+iwJfAJTOH/SM4KluKOKRJpjCMhI8bG3qB74zrFoArKZ62ll0Fr3mqkMJiQOmWYkdYgDeITYQg==, tarball: https://registry.npmmirror.com/treemate/-/treemate-0.3.11.tgz}
+
+  ts-algebra@2.0.0:
+    resolution: {integrity: sha512-FPAhNPFMrkwz76P7cdjdmiShwMynZYN6SgOujD1urY4oNm80Ou9oMdmbR45LotcKOXoy7wSmHkRFE6Mxbrhefw==}
+
+  tslib@2.8.1:
+    resolution: {integrity: sha512-oJFu94HQb+KVduSUQL7wnpmqnfmLsOA/nAh6b6EH0wCEoK0/mPeXU6c3wKDV83MkOuHPRHtSXKKU99IBazS/2w==}
+
+  tunnel-agent@0.6.0:
+    resolution: {integrity: sha512-McnNiV1l8RYeY8tBgEpuodCC1mLUdbSN+CYBL7kJsJNInOP8UjDDEwdk6Mw60vdLLrr5NHKZhMAOSrR2NZuQ+w==}
+
+  type-level-regexp@0.1.17:
+    resolution: {integrity: sha512-wTk4DH3cxwk196uGLK/E9pE45aLfeKJacKmcEgEOA/q5dnPGNxXt0cfYdFxb57L+sEpf1oJH4Dnx/pnRcku9jg==}
+
+  typescript@6.0.3:
+    resolution: {integrity: sha512-y2TvuxSZPDyQakkFRPZHKFm+KKVqIisdg9/CZwm9ftvKXLP8NRWj38/ODjNbr43SsoXqNuAisEf1GdCxqWcdBw==, tarball: https://registry.npmmirror.com/typescript/-/typescript-6.0.3.tgz}
+    engines: {node: '>=14.17'}
+    hasBin: true
+
+  ufo@1.6.4:
+    resolution: {integrity: sha512-JFNbkD1Svwe0KvGi8GOeLcP4kAWQ609twvCdcHxq1oSL8svv39ZuSvajcD8B+5D0eL4+s1Is2D/O6KN3qcTeRA==, tarball: https://registry.npmmirror.com/ufo/-/ufo-1.6.4.tgz}
+
+  unconfig-core@7.5.0:
+    resolution: {integrity: sha512-Su3FauozOGP44ZmKdHy2oE6LPjk51M/TRRjHv2HNCWiDvfvCoxC2lno6jevMA91MYAdCdwP05QnWdWpSbncX/w==}
+
+  unconfig@7.5.0:
+    resolution: {integrity: sha512-oi8Qy2JV4D3UQ0PsopR28CzdQ3S/5A1zwsUwp/rosSbfhJ5z7b90bIyTwi/F7hCLD4SGcZVjDzd4XoUQcEanvA==}
+
+  undici-types@7.18.2:
+    resolution: {integrity: sha512-AsuCzffGHJybSaRrmr5eHr81mwJU3kjw6M+uprWvCXiNeN9SOGwQ3Jn8jb8m3Z6izVgknn1R0FTCEAP2QrLY/w==, tarball: https://registry.npmmirror.com/undici-types/-/undici-types-7.18.2.tgz}
+
+  unocss@66.7.5:
+    resolution: {integrity: sha512-nAdmU8TwnQoiLnQjZ6Hm1GmHy9lTexKsAZNEJtZnxN9wyFRc1eLjQgmh9r7UEGxBQMQLD8OZOgmk5HpwObbh0Q==}
+    peerDependencies:
+      '@unocss/astro': 66.7.5
+      '@unocss/postcss': 66.7.5
+      '@unocss/webpack': 66.7.5
+    peerDependenciesMeta:
+      '@unocss/astro':
+        optional: true
+      '@unocss/postcss':
+        optional: true
+      '@unocss/webpack':
+        optional: true
+
+  unplugin-utils@0.3.2:
+    resolution: {integrity: sha512-xVToRh2CTmLk2HnEG7ac4rl1MJTT3RFkpS8B++/SnB0kXvuaavD+n3m/vrzyWQOdJNSZQACnbz01pnppbwV5BA==, tarball: https://registry.npmmirror.com/unplugin-utils/-/unplugin-utils-0.3.2.tgz}
+    engines: {node: '>=20.19.0'}
+
+  unplugin@2.3.11:
+    resolution: {integrity: sha512-5uKD0nqiYVzlmCRs01Fhs2BdkEgBS3SAVP6ndrBsuK42iC2+JHyxM05Rm9G8+5mkmRtzMZGY8Ct5+mliZxU/Ww==}
+    engines: {node: '>=18.12.0'}
+
+  update-browserslist-db@1.2.3:
+    resolution: {integrity: sha512-Js0m9cx+qOgDxo0eMiFGEueWztz+d4+M3rGlmKPT+T4IS/jP4ylw3Nwpu6cpTTP8R1MAC1kF4VbdLt3ARf209w==, tarball: https://registry.npmmirror.com/update-browserslist-db/-/update-browserslist-db-1.2.3.tgz}
+    hasBin: true
+    peerDependencies:
+      browserslist: '>= 4.21.0'
+
+  util-deprecate@1.0.2:
+    resolution: {integrity: sha512-EPD5q1uXyFxJpCrLnCc1nHnq3gOa6DZBocAIiI2TaSCA7VCJ1UJDMagCzIkXNsUYfD1daK//LTEQ8xiIbrHtcw==}
+
+  utrie@1.0.2:
+    resolution: {integrity: sha512-1MLa5ouZiOmQzUbjbu9VmjLzn1QLXBhwpUa7kdLUQK+KQ5KA9I1vk5U4YHe/X2Ch7PYnJfWuWT+VbuxbGwljhw==}
+
+  vdirs@0.1.8:
+    resolution: {integrity: sha512-H9V1zGRLQZg9b+GdMk8MXDN2Lva0zx72MPahDKc30v+DtwKjfyOSXWRIX4t2mhDubM1H09gPhWeth/BJWPHGUw==, tarball: https://registry.npmmirror.com/vdirs/-/vdirs-0.1.8.tgz}
+    peerDependencies:
+      vue: ^3.0.11
+
+  vite-dev-rpc@2.0.0:
+    resolution: {integrity: sha512-yKwbTwdHKSD2k/aGqyWpPHepo45OQc8lH3/6IfT4ZqeKE26ooKvi4WIEKzqWav8v+9Is8u1k8q54hvOmqASazA==, tarball: https://registry.npmmirror.com/vite-dev-rpc/-/vite-dev-rpc-2.0.0.tgz}
+    peerDependencies:
+      vite: ^2.9.0 || ^3.0.0-0 || ^4.0.0-0 || ^5.0.0-0 || ^6.0.1 || ^7.0.0-0 || ^8.0.0
+
+  vite-hot-client@2.2.0:
+    resolution: {integrity: sha512-76Zs9zrHbH7M7wqeyooGQKdX+yg0pQ0xuQ1PbFp4z5a0Lzn2e5IPFoCswnmqZ4GiwqB4Jo3WcDAMO9jARTJl8w==, tarball: https://registry.npmmirror.com/vite-hot-client/-/vite-hot-client-2.2.0.tgz}
+    peerDependencies:
+      vite: ^2.6.0 || ^3.0.0 || ^4.0.0 || ^5.0.0-0 || ^6.0.0-0 || ^7.0.0-0 || ^8.0.0
+
+  vite-node@3.2.4:
+    resolution: {integrity: sha512-EbKSKh+bh1E1IFxeO0pg1n4dvoOTt0UDiXMd/qn++r98+jPO1xtJilvXldeuQ8giIB5IkpjCgMleHMNEsGH6pg==}
+    engines: {node: ^18.0.0 || ^20.0.0 || >=22.0.0}
+    hasBin: true
+
+  vite-plugin-inspect@11.4.1:
+    resolution: {integrity: sha512-ShOFe2PURXGvRS5OrgmOLZOCwDTD7dEBVt0tMpFPKb9AsvqXKCRGM8QgKrUbRbJYFXScHvDPpGRd28rYidC0tA==, tarball: https://registry.npmmirror.com/vite-plugin-inspect/-/vite-plugin-inspect-11.4.1.tgz}
+    engines: {node: '>=14'}
+    peerDependencies:
+      '@nuxt/kit': '*'
+      vite: ^6.0.0 || ^7.0.0-0 || ^8.0.0-0
+    peerDependenciesMeta:
+      '@nuxt/kit':
+        optional: true
+
+  vite-plugin-vue-devtools@8.2.1:
+    resolution: {integrity: sha512-5JLxXWWCo5lJMw16/xVeNvJ8k2zLwZPf1vITLzya/2IePrCBeGe/p/iAokgXHZpEi39fcYtPXmO8SaKeXmqCAA==, tarball: https://registry.npmmirror.com/vite-plugin-vue-devtools/-/vite-plugin-vue-devtools-8.2.1.tgz}
+    engines: {node: '>=v14.21.3'}
+    peerDependencies:
+      vite: ^6.0.0 || ^7.0.0 || ^8.0.0
+
+  vite-plugin-vue-inspector@6.0.0:
+    resolution: {integrity: sha512-OpyITJLgZNibxlrik1EmRtvXHDjLRxNPsWkGFTERZs2LgMEdG4W0WoFt5GIgp3a3jRou+eJR8U1zOBk/XQgEbw==, tarball: https://registry.npmmirror.com/vite-plugin-vue-inspector/-/vite-plugin-vue-inspector-6.0.0.tgz}
+    peerDependencies:
+      vite: ^3.0.0 || ^4.0.0 || ^5.0.0 || ^6.0.0 || ^7.0.0 || ^8.0.0
+
+  vite@7.3.6:
+    resolution: {integrity: sha512-4XP60spRGjSZFf1qYH+dJIkK2znL3zQfl9KkOV9MkkRR/3Dls0dxaBsQPTloEc5BLXWPL9vsOxopxyKoMmDueg==}
+    engines: {node: ^20.19.0 || >=22.12.0}
+    hasBin: true
+    peerDependencies:
+      '@types/node': ^20.19.0 || >=22.12.0
+      jiti: '>=1.21.0'
+      less: ^4.0.0
+      lightningcss: ^1.21.0
+      sass: ^1.70.0
+      sass-embedded: ^1.70.0
+      stylus: '>=0.54.8'
+      sugarss: ^5.0.0
+      terser: ^5.16.0
+      tsx: ^4.8.1
+      yaml: ^2.4.2
+    peerDependenciesMeta:
+      '@types/node':
+        optional: true
+      jiti:
+        optional: true
+      less:
+        optional: true
+      lightningcss:
+        optional: true
+      sass:
+        optional: true
+      sass-embedded:
+        optional: true
+      stylus:
+        optional: true
+      sugarss:
+        optional: true
+      terser:
+        optional: true
+      tsx:
+        optional: true
+      yaml:
+        optional: true
+
+  vite@8.2.0:
+    resolution: {integrity: sha512-pn+CFpM0lwDeKwmOq1ZaBK/9sjorZcgqxki6MbY/jPEVd9vichIlmlD4HmQ5wdP5EgqQCFRaACBxMC7uEGc6lQ==, tarball: https://registry.npmmirror.com/vite/-/vite-8.2.0.tgz}
+    engines: {node: ^20.19.0 || >=22.12.0}
+    hasBin: true
+    peerDependencies:
+      '@types/node': ^20.19.0 || >=22.12.0
+      '@vitejs/devtools': ^0.4.0
+      esbuild: ^0.27.0 || ^0.28.0
+      jiti: '>=1.21.0'
+      less: ^4.0.0
+      sass: ^1.70.0
+      sass-embedded: ^1.70.0
+      stylus: '>=0.54.8'
+      sugarss: ^5.0.0
+      terser: ^5.16.0
+      tsx: ^4.8.1
+      yaml: ^2.4.2
+    peerDependenciesMeta:
+      '@types/node':
+        optional: true
+      '@vitejs/devtools':
+        optional: true
+      esbuild:
+        optional: true
+      jiti:
+        optional: true
+      less:
+        optional: true
+      sass:
+        optional: true
+      sass-embedded:
+        optional: true
+      stylus:
+        optional: true
+      sugarss:
+        optional: true
+      terser:
+        optional: true
+      tsx:
+        optional: true
+      yaml:
+        optional: true
+
+  vitest@3.2.7:
+    resolution: {integrity: sha512-KrxIJ62Fd89gfysR4WotlgZABiz2dqFPgqGzX7s+CwsqLFomRH7777ZcrOD6+WVAh7khPQP41A+BKbpcJFrdEg==}
+    engines: {node: ^18.0.0 || ^20.0.0 || >=22.0.0}
+    hasBin: true
+    peerDependencies:
+      '@edge-runtime/vm': '*'
+      '@types/debug': ^4.1.12
+      '@types/node': ^18.0.0 || ^20.0.0 || >=22.0.0
+      '@vitest/browser': 3.2.7
+      '@vitest/ui': 3.2.7
+      happy-dom: '*'
+      jsdom: '*'
+    peerDependenciesMeta:
+      '@edge-runtime/vm':
+        optional: true
+      '@types/debug':
+        optional: true
+      '@types/node':
+        optional: true
+      '@vitest/browser':
+        optional: true
+      '@vitest/ui':
+        optional: true
+      happy-dom:
+        optional: true
+      jsdom:
+        optional: true
+
+  vooks@0.2.12:
+    resolution: {integrity: sha512-iox0I3RZzxtKlcgYaStQYKEzWWGAduMmq+jS7OrNdQo1FgGfPMubGL3uGHOU9n97NIvfFDBGnpSvkWyb/NSn/Q==, tarball: https://registry.npmmirror.com/vooks/-/vooks-0.2.12.tgz}
+    peerDependencies:
+      vue: ^3.0.0
+
+  vscode-uri@3.1.0:
+    resolution: {integrity: sha512-/BpdSx+yCQGnCvecbyXdxHDkuk55/G3xwnC0GqY4gmQ3j+A+g8kzzgB4Nk/SINjqn6+waqw3EgbVF2QKExkRxQ==, tarball: https://registry.npmmirror.com/vscode-uri/-/vscode-uri-3.1.0.tgz}
+
+  vue-codemirror6@1.6.1:
+    resolution: {integrity: sha512-0Ue6nWy055UKP/6LkT0I7nW5SRSFJ+3mokwBdHePQsj11T02mrg3A0jtHyBqH23nRHQFxd3NKw63sZJ1ygo5dA==}
+    engines: {node: ^22.18.0 || >=24.12.0}
+    peerDependencies:
+      '@codemirror/autocomplete': ^6.0.0
+      '@codemirror/commands': ^6.0.0
+      '@codemirror/language': ^6.0.0
+      '@codemirror/lint': ^6.0.0
+      '@codemirror/search': ^6.0.0
+      '@codemirror/state': ^6.0.0
+      '@codemirror/view': ^6.0.0
+      codemirror: ^6.0.0
+      style-mod: ^4.0.0
+      vue: ^2.7.14 || ^3.3.4
+
+  vue-demi@0.14.10:
+    resolution: {integrity: sha512-nMZBOwuzabUO0nLgIcc6rycZEebF6eeUfaiQx9+WSk8e29IbLvPU9feI6tqW4kTo3hvoYAJkMh8n8D0fuISphg==}
+    engines: {node: '>=12'}
+    hasBin: true
+    peerDependencies:
+      '@vue/composition-api': ^1.0.0-rc.1
+      vue: ^3.0.0-0 || ^2.6.0
+    peerDependenciesMeta:
+      '@vue/composition-api':
+        optional: true
+
+  vue-tsc@3.3.9:
+    resolution: {integrity: sha512-TS3Y1ux/IRoE8OCP2PpACAeOseuIs0UvWrcr7u+w3PmfY+SlCfEf8zjrBgnQksHUgLpthi5vHlffcQTQTdPBZA==, tarball: https://registry.npmmirror.com/vue-tsc/-/vue-tsc-3.3.9.tgz}
+    hasBin: true
+    peerDependencies:
+      typescript: '>=5.0.0'
+
+  vue@3.5.41:
+    resolution: {integrity: sha512-2laE0p+aK+/AOPG/XL/WepOs/GlK755LJ1XECi9kDUrz1FKNw8rb2Xzlw9JS1rqEV55nb0ttsKxVlTCcd+R5cg==, tarball: https://registry.npmmirror.com/vue/-/vue-3.5.41.tgz}
+    peerDependencies:
+      typescript: '*'
+    peerDependenciesMeta:
+      typescript:
+        optional: true
+
+  vueuc@0.4.65:
+    resolution: {integrity: sha512-lXuMl+8gsBmruudfxnMF9HW4be8rFziylXFu1VHVNbLVhRTXXV4njvpRuJapD/8q+oFEMSfQMH16E/85VoWRyQ==, tarball: https://registry.npmmirror.com/vueuc/-/vueuc-0.4.65.tgz}
+    peerDependencies:
+      vue: ^3.0.11
+
+  w3c-keyname@2.2.8:
+    resolution: {integrity: sha512-dpojBhNsCNN7T82Tm7k26A6G9ML3NkhDsnw9n/eoxSRlVBB4CEtIQ/KTCLI2Fwf3ataSXRhYFkQi3SlnFwPvPQ==}
+
+  w3c-xmlserializer@5.0.0:
+    resolution: {integrity: sha512-o8qghlI8NZHU1lLPrpi2+Uq7abh4GGPpYANlalzWxyWteJOCsr/P+oPBA49TOLu5FTZO4d3F9MnWJfiMo4BkmA==}
+    engines: {node: '>=18'}
+
+  webidl-conversions@7.0.0:
+    resolution: {integrity: sha512-VwddBukDzu71offAQR975unBIGqfKZpM+8ZX6ySk8nYhVoo5CYaZyzt3YBvYtRtO+aoGlqxPg/B87NGVZ/fu6g==}
+    engines: {node: '>=12'}
+
+  webpack-virtual-modules@0.6.2:
+    resolution: {integrity: sha512-66/V2i5hQanC51vBQKPH4aI8NMAcBW59FVBs+rC7eGHupMyfn34q7rZIE+ETlJ+XTevqfUhVVBgSUNSW2flEUQ==, tarball: https://registry.npmmirror.com/webpack-virtual-modules/-/webpack-virtual-modules-0.6.2.tgz}
+
+  whatwg-encoding@3.1.1:
+    resolution: {integrity: sha512-6qN4hJdMwfYBtE3YBTTHhoeuUrDBPZmbQaxWAqSALV/MeEnR5z1xd8UKud2RAkFoPkmB+hli1TZSnyi84xz1vQ==}
+    engines: {node: '>=18'}
+    deprecated: Use @exodus/bytes instead for a more spec-conformant and faster implementation
+
+  whatwg-mimetype@3.0.0:
+    resolution: {integrity: sha512-nt+N2dzIutVRxARx1nghPKGv1xHikU7HKdfafKkLNLindmPU/ch3U31NOCGGA/dmPcmb1VlofO0vnKAcsm0o/Q==}
+    engines: {node: '>=12'}
+
+  whatwg-mimetype@4.0.0:
+    resolution: {integrity: sha512-QaKxh0eNIi2mE9p2vEdzfagOKHCcj1pJ56EEHGQOVxp8r9/iszLUUV7v89x9O1p/T+NlTM5W7jW6+cz4Fq1YVg==}
+    engines: {node: '>=18'}
+
+  whatwg-url@14.2.0:
+    resolution: {integrity: sha512-De72GdQZzNTUBBChsXueQUnPKDkg/5A5zp7pFDuQAj5UFoENpiACU0wlCvzpAGnTkj++ihpKwKyYewn/XNUbKw==}
+    engines: {node: '>=18'}
+
+  which-module@2.0.1:
+    resolution: {integrity: sha512-iBdZ57RDvnOR9AGBhML2vFZf7h8vmBjhoaZqODJBFWHVtKkDmKuHai3cx5PgVMrX5YDNp27AofYbAwctSS+vhQ==}
+
+  which@2.0.2:
+    resolution: {integrity: sha512-BLI3Tl1TW3Pvl70l3yq3Y64i+awpwXqsGBYWkkqMtnbXgrMD+yj7rhW0kuEDxzJaYXGjEW5ogapKNMEKNMjibA==, tarball: https://registry.npmmirror.com/which/-/which-2.0.2.tgz}
+    engines: {node: '>= 8'}
+    hasBin: true
+
+  which@7.0.0:
+    resolution: {integrity: sha512-RancgH2dmbLdHl6LRhEqvklWMgl/Hdnun0Y90KhBOLkMefg8Qa7/Zel8Sm+8HEcP6DEjzsWzpkuBQEZok58isA==, tarball: https://registry.npmmirror.com/which/-/which-7.0.0.tgz}
+    engines: {node: ^22.22.2 || ^24.15.0 || >=26.0.0}
+    hasBin: true
+
+  why-is-node-running@2.3.0:
+    resolution: {integrity: sha512-hUrmaWBdVDcxvYqnyh09zunKzROWjbZTiNy8dBEjkS7ehEDQibXJ7XvlmtbwuTclUiIyN+CyXQD4Vmko8fNm8w==}
+    engines: {node: '>=8'}
+    hasBin: true
+
+  wmf@1.0.2:
+    resolution: {integrity: sha512-/p9K7bEh0Dj6WbXg4JG0xvLQmIadrner1bi45VMJTfnbVHsc7yIajZyoSoK60/dtVBs12Fm6WkUI5/3WAVsNMw==}
+    engines: {node: '>=0.8'}
+
+  word@0.3.0:
+    resolution: {integrity: sha512-OELeY0Q61OXpdUfTp+oweA/vtLVg5VDOXh+3he3PNzLGG/y0oylSOC1xRVj0+l4vQ3tj/bB1HVHv1ocXkQceFA==}
+    engines: {node: '>=0.8'}
+
+  wrap-ansi@6.2.0:
+    resolution: {integrity: sha512-r6lPcBGxZXlIcymEu7InxDMhdW0KDxpLgoFLcguasxCaJ/SOIZwINatK9KY/tf+ZrlywOKU0UDj3ATXUBfxJXA==}
+    engines: {node: '>=8'}
+
+  wrap-ansi@7.0.0:
+    resolution: {integrity: sha512-YVGIj2kamLSTxw6NsZjoBxfSwsn0ycdesmc4p+Q21c5zPuZ1pl+NfxVdxPtdHvmNVOQ6XSYG4AUtyt/Fi7D16Q==}
+    engines: {node: '>=10'}
+
+  wrap-ansi@8.1.0:
+    resolution: {integrity: sha512-si7QWI6zUMq56bESFvagtmzMdGOtoxfR+Sez11Mobfc7tm+VkUckk9bW2UeffTGVUbOksxmSw0AA2gs8g71NCQ==}
+    engines: {node: '>=12'}
+
+  wrappy@1.0.2:
+    resolution: {integrity: sha512-l4Sp/DRseor9wL6EvV2+TuQn63dMkPjZ/sp9XkghTEbV9KlPS1xUsZ3u7/IQO4wxtcFB4bgpQPRcR3QCvezPcQ==}
+
+  ws@8.21.2:
+    resolution: {integrity: sha512-54dMVAo4WIe6SKy3vBgN+9bJZqqQ8IMRevAkOLQALhi49qkkQDQfWdAZ8KQlXiEabw88ARXXdUrlvtbKQX+aKw==}
+    engines: {node: '>=10.0.0'}
+    peerDependencies:
+      bufferutil: ^4.0.1
+      utf-8-validate: '>=5.0.2'
+    peerDependenciesMeta:
+      bufferutil:
+        optional: true
+      utf-8-validate:
+        optional: true
+
+  wsl-utils@0.3.1:
+    resolution: {integrity: sha512-g/eziiSUNBSsdDJtCLB8bdYEUMj4jR7AGeUo96p/3dTafgjHhpF4RiCFPiRILwjQoDXx5MqkBr4fwWtR3Ky4Wg==, tarball: https://registry.npmmirror.com/wsl-utils/-/wsl-utils-0.3.1.tgz}
+    engines: {node: '>=20'}
+
+  xlsx@0.18.5:
+    resolution: {integrity: sha512-dmg3LCjBPHZnQp5/F/+nnTa+miPJxUXB6vtk42YjBBKayDNagxGEeIdWApkYPOf3Z3pm3k62Knjzp7lMeTEtFQ==}
+    engines: {node: '>=0.8'}
+    hasBin: true
+
+  xml-name-validator@5.0.0:
+    resolution: {integrity: sha512-EvGK8EJ3DhaHfbRlETOWAS5pO9MZITeauHKJyb8wyajUfQUenkIg2MvLDTZ4T/TgIcm3HU0TFBgWWboAZ30UHg==}
+    engines: {node: '>=18'}
+
+  xmlchars@2.2.0:
+    resolution: {integrity: sha512-JZnDKK8B0RCDw84FNdDAIpZK+JuJw+s7Lz8nksI7SIuU3UXJJslUthsi+uWBUYOwPFwW7W7PRLRfUKpxjtjFCw==}
+
+  y18n@4.0.3:
+    resolution: {integrity: sha512-JKhqTOwSrqNA1NY5lSztJ1GrBiUodLMmIZuLiDaMRJ+itFd+ABVE8XBjOvIWL+rSqNDC74LCSFmlb/U4UZ4hJQ==}
+
+  yallist@3.1.1:
+    resolution: {integrity: sha512-a4UGQaWPH59mOXUYnAG2ewncQS4i4F43Tv3JoAM+s2VDAmS9NsK8GpDMLrCHPksFT7h3K6TOoUNn2pb7RoXx4g==, tarball: https://registry.npmmirror.com/yallist/-/yallist-3.1.1.tgz}
+
+  yaml@2.9.0:
+    resolution: {integrity: sha512-2AvhNX3mb8zd6Zy7INTtSpl1F15HW6Wnqj0srWlkKLcpYl/gMIMJiyuGq2KeI2YFxUPjdlB+3Lc10seMLtL4cA==}
+    engines: {node: '>= 14.6'}
+    hasBin: true
+
+  yargs-parser@18.1.3:
+    resolution: {integrity: sha512-o50j0JeToy/4K6OZcaQmW6lyXXKhq7csREXcDwk2omFPJEwUNOVtJKvmDr9EI1fAJZUyZcRF7kxGBWmRXudrCQ==}
+    engines: {node: '>=6'}
+
+  yargs@15.4.1:
+    resolution: {integrity: sha512-aePbxDmcYW++PaqBsJ+HYUFwCdv4LVvdnhBy78E57PIor8/OVvhMrADFFEDh8DHDFRv/O9i3lPhsENjO7QX0+A==}
+    engines: {node: '>=8'}
+
+snapshots:
+
+  '@ampproject/remapping@2.3.0':
+    dependencies:
+      '@jridgewell/gen-mapping': 0.3.13
+      '@jridgewell/trace-mapping': 0.3.31
+
+  '@antfu/install-pkg@1.1.0':
+    dependencies:
+      package-manager-detector: 1.8.0
+      tinyexec: 1.3.0
+
+  '@asamuzakjp/css-color@3.2.0':
+    dependencies:
+      '@csstools/css-calc': 2.1.4(@csstools/css-parser-algorithms@3.0.5(@csstools/css-tokenizer@3.0.4))(@csstools/css-tokenizer@3.0.4)
+      '@csstools/css-color-parser': 3.1.0(@csstools/css-parser-algorithms@3.0.5(@csstools/css-tokenizer@3.0.4))(@csstools/css-tokenizer@3.0.4)
+      '@csstools/css-parser-algorithms': 3.0.5(@csstools/css-tokenizer@3.0.4)
+      '@csstools/css-tokenizer': 3.0.4
+      lru-cache: 10.4.3
+    optional: true
+
+  '@babel/code-frame@7.29.7':
+    dependencies:
+      '@babel/helper-validator-identifier': 7.29.7
+      js-tokens: 4.0.0
+      picocolors: 1.1.1
+
+  '@babel/compat-data@7.29.7': {}
+
+  '@babel/core@7.29.7':
+    dependencies:
+      '@babel/code-frame': 7.29.7
+      '@babel/generator': 7.29.8
+      '@babel/helper-compilation-targets': 7.29.7
+      '@babel/helper-module-transforms': 7.29.7(@babel/core@7.29.7)
+      '@babel/helpers': 7.29.7
+      '@babel/parser': 7.29.8
+      '@babel/template': 7.29.7
+      '@babel/traverse': 7.29.8
+      '@babel/types': 7.29.8
+      '@jridgewell/remapping': 2.3.5
+      convert-source-map: 2.0.0
+      debug: 4.4.3
+      gensync: 1.0.0-beta.2
+      json5: 2.2.3
+      semver: 6.3.1
+    transitivePeerDependencies:
+      - supports-color
+
+  '@babel/generator@7.29.8':
+    dependencies:
+      '@babel/parser': 7.29.8
+      '@babel/types': 7.29.8
+      '@jridgewell/gen-mapping': 0.3.13
+      '@jridgewell/trace-mapping': 0.3.31
+      jsesc: 3.1.0
+
+  '@babel/helper-annotate-as-pure@7.29.7':
+    dependencies:
+      '@babel/types': 7.29.8
+
+  '@babel/helper-compilation-targets@7.29.7':
+    dependencies:
+      '@babel/compat-data': 7.29.7
+      '@babel/helper-validator-option': 7.29.7
+      browserslist: 4.28.7
+      lru-cache: 5.1.1
+      semver: 6.3.1
+
+  '@babel/helper-create-class-features-plugin@7.29.7(@babel/core@7.29.7)':
+    dependencies:
+      '@babel/core': 7.29.7
+      '@babel/helper-annotate-as-pure': 7.29.7
+      '@babel/helper-member-expression-to-functions': 7.29.7
+      '@babel/helper-optimise-call-expression': 7.29.7
+      '@babel/helper-replace-supers': 7.29.7(@babel/core@7.29.7)
+      '@babel/helper-skip-transparent-expression-wrappers': 7.29.7
+      '@babel/traverse': 7.29.8
+      semver: 6.3.1
+    transitivePeerDependencies:
+      - supports-color
+
+  '@babel/helper-globals@7.29.7': {}
+
+  '@babel/helper-member-expression-to-functions@7.29.7':
+    dependencies:
+      '@babel/traverse': 7.29.8
+      '@babel/types': 7.29.8
+    transitivePeerDependencies:
+      - supports-color
+
+  '@babel/helper-module-imports@7.29.7':
+    dependencies:
+      '@babel/traverse': 7.29.8
+      '@babel/types': 7.29.8
+    transitivePeerDependencies:
+      - supports-color
+
+  '@babel/helper-module-transforms@7.29.7(@babel/core@7.29.7)':
+    dependencies:
+      '@babel/core': 7.29.7
+      '@babel/helper-module-imports': 7.29.7
+      '@babel/helper-validator-identifier': 7.29.7
+      '@babel/traverse': 7.29.8
+    transitivePeerDependencies:
+      - supports-color
+
+  '@babel/helper-optimise-call-expression@7.29.7':
+    dependencies:
+      '@babel/types': 7.29.8
+
+  '@babel/helper-plugin-utils@7.29.7': {}
+
+  '@babel/helper-replace-supers@7.29.7(@babel/core@7.29.7)':
+    dependencies:
+      '@babel/core': 7.29.7
+      '@babel/helper-member-expression-to-functions': 7.29.7
+      '@babel/helper-optimise-call-expression': 7.29.7
+      '@babel/traverse': 7.29.8
+    transitivePeerDependencies:
+      - supports-color
+
+  '@babel/helper-skip-transparent-expression-wrappers@7.29.7':
+    dependencies:
+      '@babel/traverse': 7.29.8
+      '@babel/types': 7.29.8
+    transitivePeerDependencies:
+      - supports-color
+
+  '@babel/helper-string-parser@7.29.7': {}
+
+  '@babel/helper-validator-identifier@7.29.7': {}
+
+  '@babel/helper-validator-option@7.29.7': {}
+
+  '@babel/helpers@7.29.7':
+    dependencies:
+      '@babel/template': 7.29.7
+      '@babel/types': 7.29.8
+
+  '@babel/parser@7.29.8':
+    dependencies:
+      '@babel/types': 7.29.8
+
+  '@babel/plugin-proposal-decorators@7.29.7(@babel/core@7.29.7)':
+    dependencies:
+      '@babel/core': 7.29.7
+      '@babel/helper-create-class-features-plugin': 7.29.7(@babel/core@7.29.7)
+      '@babel/helper-plugin-utils': 7.29.7
+      '@babel/plugin-syntax-decorators': 7.29.7(@babel/core@7.29.7)
+    transitivePeerDependencies:
+      - supports-color
+
+  '@babel/plugin-syntax-decorators@7.29.7(@babel/core@7.29.7)':
+    dependencies:
+      '@babel/core': 7.29.7
+      '@babel/helper-plugin-utils': 7.29.7
+
+  '@babel/plugin-syntax-import-attributes@7.29.7(@babel/core@7.29.7)':
+    dependencies:
+      '@babel/core': 7.29.7
+      '@babel/helper-plugin-utils': 7.29.7
+
+  '@babel/plugin-syntax-import-meta@7.10.4(@babel/core@7.29.7)':
+    dependencies:
+      '@babel/core': 7.29.7
+      '@babel/helper-plugin-utils': 7.29.7
+
+  '@babel/plugin-syntax-jsx@7.29.7(@babel/core@7.29.7)':
+    dependencies:
+      '@babel/core': 7.29.7
+      '@babel/helper-plugin-utils': 7.29.7
+
+  '@babel/plugin-syntax-typescript@7.29.7(@babel/core@7.29.7)':
+    dependencies:
+      '@babel/core': 7.29.7
+      '@babel/helper-plugin-utils': 7.29.7
+
+  '@babel/plugin-transform-typescript@7.29.7(@babel/core@7.29.7)':
+    dependencies:
+      '@babel/core': 7.29.7
+      '@babel/helper-annotate-as-pure': 7.29.7
+      '@babel/helper-create-class-features-plugin': 7.29.7(@babel/core@7.29.7)
+      '@babel/helper-plugin-utils': 7.29.7
+      '@babel/helper-skip-transparent-expression-wrappers': 7.29.7
+      '@babel/plugin-syntax-typescript': 7.29.7(@babel/core@7.29.7)
+    transitivePeerDependencies:
+      - supports-color
+
+  '@babel/runtime@7.29.7': {}
+
+  '@babel/template@7.29.7':
+    dependencies:
+      '@babel/code-frame': 7.29.7
+      '@babel/parser': 7.29.8
+      '@babel/types': 7.29.8
+
+  '@babel/traverse@7.29.8':
+    dependencies:
+      '@babel/code-frame': 7.29.7
+      '@babel/generator': 7.29.8
+      '@babel/helper-globals': 7.29.7
+      '@babel/parser': 7.29.8
+      '@babel/template': 7.29.7
+      '@babel/types': 7.29.8
+      debug: 4.4.3
+    transitivePeerDependencies:
+      - supports-color
+
+  '@babel/types@7.29.8':
+    dependencies:
+      '@babel/helper-string-parser': 7.29.7
+      '@babel/helper-validator-identifier': 7.29.7
+
+  '@bcoe/v8-coverage@1.0.2': {}
+
+  '@bwip-js/generic@4.11.2': {}
+
+  '@codemirror/autocomplete@6.20.3':
+    dependencies:
+      '@codemirror/language': 6.12.4
+      '@codemirror/state': 6.7.1
+      '@codemirror/view': 6.43.8
+      '@lezer/common': 1.5.2
+
+  '@codemirror/commands@6.10.4':
+    dependencies:
+      '@codemirror/language': 6.12.4
+      '@codemirror/state': 6.7.1
+      '@codemirror/view': 6.43.8
+      '@lezer/common': 1.5.2
+
+  '@codemirror/lang-json@6.0.2':
+    dependencies:
+      '@codemirror/language': 6.12.4
+      '@lezer/json': 1.0.3
+
+  '@codemirror/language@6.12.4':
+    dependencies:
+      '@codemirror/state': 6.7.1
+      '@codemirror/view': 6.43.8
+      '@lezer/common': 1.5.2
+      '@lezer/highlight': 1.2.3
+      '@lezer/lr': 1.4.10
+      style-mod: 4.1.3
+
+  '@codemirror/lint@6.9.7':
+    dependencies:
+      '@codemirror/state': 6.7.1
+      '@codemirror/view': 6.43.8
+      crelt: 1.0.7
+
+  '@codemirror/search@6.7.1':
+    dependencies:
+      '@codemirror/state': 6.7.1
+      '@codemirror/view': 6.43.8
+      crelt: 1.0.7
+
+  '@codemirror/state@6.7.1':
+    dependencies:
+      '@marijn/find-cluster-break': 1.0.3
+
+  '@codemirror/view@6.43.8':
+    dependencies:
+      '@codemirror/state': 6.7.1
+      crelt: 1.0.7
+      style-mod: 4.1.3
+      w3c-keyname: 2.2.8
+
+  '@css-render/plugin-bem@0.15.14(css-render@0.15.14)':
+    dependencies:
+      css-render: 0.15.14
+
+  '@css-render/vue3-ssr@0.15.14(vue@3.5.41(typescript@6.0.3))':
+    dependencies:
+      vue: 3.5.41(typescript@6.0.3)
+
+  '@csstools/color-helpers@5.1.0':
+    optional: true
+
+  '@csstools/css-calc@2.1.4(@csstools/css-parser-algorithms@3.0.5(@csstools/css-tokenizer@3.0.4))(@csstools/css-tokenizer@3.0.4)':
+    dependencies:
+      '@csstools/css-parser-algorithms': 3.0.5(@csstools/css-tokenizer@3.0.4)
+      '@csstools/css-tokenizer': 3.0.4
+    optional: true
+
+  '@csstools/css-color-parser@3.1.0(@csstools/css-parser-algorithms@3.0.5(@csstools/css-tokenizer@3.0.4))(@csstools/css-tokenizer@3.0.4)':
+    dependencies:
+      '@csstools/color-helpers': 5.1.0
+      '@csstools/css-calc': 2.1.4(@csstools/css-parser-algorithms@3.0.5(@csstools/css-tokenizer@3.0.4))(@csstools/css-tokenizer@3.0.4)
+      '@csstools/css-parser-algorithms': 3.0.5(@csstools/css-tokenizer@3.0.4)
+      '@csstools/css-tokenizer': 3.0.4
+    optional: true
+
+  '@csstools/css-parser-algorithms@3.0.5(@csstools/css-tokenizer@3.0.4)':
+    dependencies:
+      '@csstools/css-tokenizer': 3.0.4
+    optional: true
+
+  '@csstools/css-tokenizer@3.0.4':
+    optional: true
+
+  '@emnapi/core@1.10.0':
+    dependencies:
+      '@emnapi/wasi-threads': 1.2.1
+      tslib: 2.8.1
+    optional: true
+
+  '@emnapi/runtime@1.10.0':
+    dependencies:
+      tslib: 2.8.1
+    optional: true
+
+  '@emnapi/wasi-threads@1.2.1':
+    dependencies:
+      tslib: 2.8.1
+    optional: true
+
+  '@emotion/hash@0.8.0': {}
+
+  '@esbuild/aix-ppc64@0.28.2':
+    optional: true
+
+  '@esbuild/android-arm64@0.28.2':
+    optional: true
+
+  '@esbuild/android-arm@0.28.2':
+    optional: true
+
+  '@esbuild/android-x64@0.28.2':
+    optional: true
+
+  '@esbuild/darwin-arm64@0.28.2':
+    optional: true
+
+  '@esbuild/darwin-x64@0.28.2':
+    optional: true
+
+  '@esbuild/freebsd-arm64@0.28.2':
+    optional: true
+
+  '@esbuild/freebsd-x64@0.28.2':
+    optional: true
+
+  '@esbuild/linux-arm64@0.28.2':
+    optional: true
+
+  '@esbuild/linux-arm@0.28.2':
+    optional: true
+
+  '@esbuild/linux-ia32@0.28.2':
+    optional: true
+
+  '@esbuild/linux-loong64@0.28.2':
+    optional: true
+
+  '@esbuild/linux-mips64el@0.28.2':
+    optional: true
+
+  '@esbuild/linux-ppc64@0.28.2':
+    optional: true
+
+  '@esbuild/linux-riscv64@0.28.2':
+    optional: true
+
+  '@esbuild/linux-s390x@0.28.2':
+    optional: true
+
+  '@esbuild/linux-x64@0.28.2':
+    optional: true
+
+  '@esbuild/netbsd-arm64@0.28.2':
+    optional: true
+
+  '@esbuild/netbsd-x64@0.28.2':
+    optional: true
+
+  '@esbuild/openbsd-arm64@0.28.2':
+    optional: true
+
+  '@esbuild/openbsd-x64@0.28.2':
+    optional: true
+
+  '@esbuild/openharmony-arm64@0.28.2':
+    optional: true
+
+  '@esbuild/sunos-x64@0.28.2':
+    optional: true
+
+  '@esbuild/win32-arm64@0.28.2':
+    optional: true
+
+  '@esbuild/win32-ia32@0.28.2':
+    optional: true
+
+  '@esbuild/win32-x64@0.28.2':
+    optional: true
+
+  '@floating-ui/core@1.8.0':
+    dependencies:
+      '@floating-ui/utils': 0.2.12
+
+  '@floating-ui/dom@1.8.0':
+    dependencies:
+      '@floating-ui/core': 1.8.0
+      '@floating-ui/utils': 0.2.12
+
+  '@floating-ui/utils@0.2.12': {}
+
+  '@iconify-json/carbon@1.2.25':
+    dependencies:
+      '@iconify/types': 2.0.0
+
+  '@iconify/types@2.0.0': {}
+
+  '@iconify/utils@3.1.4':
+    dependencies:
+      '@antfu/install-pkg': 1.1.0
+      '@iconify/types': 2.0.0
+      import-meta-resolve: 4.2.0
+
+  '@isaacs/cliui@8.0.2':
+    dependencies:
+      string-width: 5.1.2
+      string-width-cjs: string-width@4.2.3
+      strip-ansi: 7.2.0
+      strip-ansi-cjs: strip-ansi@6.0.1
+      wrap-ansi: 8.1.0
+      wrap-ansi-cjs: wrap-ansi@7.0.0
+
+  '@istanbuljs/schema@0.1.6': {}
+
+  '@jridgewell/gen-mapping@0.3.13':
+    dependencies:
+      '@jridgewell/sourcemap-codec': 1.5.5
+      '@jridgewell/trace-mapping': 0.3.31
+
+  '@jridgewell/remapping@2.3.5':
+    dependencies:
+      '@jridgewell/gen-mapping': 0.3.13
+      '@jridgewell/trace-mapping': 0.3.31
+
+  '@jridgewell/resolve-uri@3.1.2': {}
+
+  '@jridgewell/sourcemap-codec@1.5.5': {}
+
+  '@jridgewell/trace-mapping@0.3.31':
+    dependencies:
+      '@jridgewell/resolve-uri': 3.1.2
+      '@jridgewell/sourcemap-codec': 1.5.5
+
+  '@juggle/resize-observer@3.4.0': {}
+
+  '@lezer/common@1.5.2': {}
+
+  '@lezer/highlight@1.2.3':
+    dependencies:
+      '@lezer/common': 1.5.2
+
+  '@lezer/json@1.0.3':
+    dependencies:
+      '@lezer/common': 1.5.2
+      '@lezer/highlight': 1.2.3
+      '@lezer/lr': 1.4.10
+
+  '@lezer/lr@1.4.10':
+    dependencies:
+      '@lezer/common': 1.5.2
+
+  '@marijn/find-cluster-break@1.0.3': {}
+
+  '@napi-rs/lzma-linux-x64-gnu@1.5.1':
+    optional: true
+
+  '@napi-rs/wasm-runtime@1.2.2(@emnapi/core@1.10.0)(@emnapi/runtime@1.10.0)':
+    dependencies:
+      '@emnapi/core': 1.10.0
+      '@emnapi/runtime': 1.10.0
+      '@tybys/wasm-util': 0.10.3
+    optional: true
+
+  '@oxc-parser/binding-android-arm-eabi@0.131.0':
+    optional: true
+
+  '@oxc-parser/binding-android-arm64@0.131.0':
+    optional: true
+
+  '@oxc-parser/binding-darwin-arm64@0.131.0':
+    optional: true
+
+  '@oxc-parser/binding-darwin-x64@0.131.0':
+    optional: true
+
+  '@oxc-parser/binding-freebsd-x64@0.131.0':
+    optional: true
+
+  '@oxc-parser/binding-linux-arm-gnueabihf@0.131.0':
+    optional: true
+
+  '@oxc-parser/binding-linux-arm-musleabihf@0.131.0':
+    optional: true
+
+  '@oxc-parser/binding-linux-arm64-gnu@0.131.0':
+    optional: true
+
+  '@oxc-parser/binding-linux-arm64-musl@0.131.0':
+    optional: true
+
+  '@oxc-parser/binding-linux-ppc64-gnu@0.131.0':
+    optional: true
+
+  '@oxc-parser/binding-linux-riscv64-gnu@0.131.0':
+    optional: true
+
+  '@oxc-parser/binding-linux-riscv64-musl@0.131.0':
+    optional: true
+
+  '@oxc-parser/binding-linux-s390x-gnu@0.131.0':
+    optional: true
+
+  '@oxc-parser/binding-linux-x64-gnu@0.131.0':
+    optional: true
+
+  '@oxc-parser/binding-linux-x64-musl@0.131.0':
+    optional: true
+
+  '@oxc-parser/binding-openharmony-arm64@0.131.0':
+    optional: true
+
+  '@oxc-parser/binding-wasm32-wasi@0.131.0':
+    dependencies:
+      '@emnapi/core': 1.10.0
+      '@emnapi/runtime': 1.10.0
+      '@napi-rs/wasm-runtime': 1.2.2(@emnapi/core@1.10.0)(@emnapi/runtime@1.10.0)
+    optional: true
+
+  '@oxc-parser/binding-win32-arm64-msvc@0.131.0':
+    optional: true
+
+  '@oxc-parser/binding-win32-ia32-msvc@0.131.0':
+    optional: true
+
+  '@oxc-parser/binding-win32-x64-msvc@0.131.0':
+    optional: true
+
+  '@oxc-project/types@0.131.0': {}
+
+  '@oxc-project/types@0.143.0': {}
+
+  '@pkgjs/parseargs@0.11.0':
+    optional: true
+
+  '@polka/url@1.0.0-next.29': {}
+
+  '@quansync/fs@1.0.0':
+    dependencies:
+      quansync: 1.0.0
+
+  '@rolldown/binding-android-arm64@1.2.3':
+    optional: true
+
+  '@rolldown/binding-darwin-arm64@1.2.3':
+    optional: true
+
+  '@rolldown/binding-darwin-x64@1.2.3':
+    optional: true
+
+  '@rolldown/binding-freebsd-x64@1.2.3':
+    optional: true
+
+  '@rolldown/binding-linux-arm-gnueabihf@1.2.3':
+    optional: true
+
+  '@rolldown/binding-linux-arm64-gnu@1.2.3':
+    optional: true
+
+  '@rolldown/binding-linux-arm64-musl@1.2.3':
+    optional: true
+
+  '@rolldown/binding-linux-ppc64-gnu@1.2.3':
+    optional: true
+
+  '@rolldown/binding-linux-s390x-gnu@1.2.3':
+    optional: true
+
+  '@rolldown/binding-linux-x64-gnu@1.2.3':
+    optional: true
+
+  '@rolldown/binding-linux-x64-musl@1.2.3':
+    optional: true
+
+  '@rolldown/binding-openharmony-arm64@1.2.3':
+    optional: true
+
+  '@rolldown/binding-win32-arm64-msvc@1.2.3':
+    optional: true
+
+  '@rolldown/binding-win32-x64-msvc@1.2.3':
+    optional: true
+
+  '@rolldown/pluginutils@1.0.1': {}
+
+  '@rollup/rollup-android-arm-eabi@4.62.4':
+    optional: true
+
+  '@rollup/rollup-android-arm64@4.62.4':
+    optional: true
+
+  '@rollup/rollup-darwin-arm64@4.62.4':
+    optional: true
+
+  '@rollup/rollup-darwin-x64@4.62.4':
+    optional: true
+
+  '@rollup/rollup-freebsd-arm64@4.62.4':
+    optional: true
+
+  '@rollup/rollup-freebsd-x64@4.62.4':
+    optional: true
+
+  '@rollup/rollup-linux-arm-gnueabihf@4.62.4':
+    optional: true
+
+  '@rollup/rollup-linux-arm-musleabihf@4.62.4':
+    optional: true
+
+  '@rollup/rollup-linux-arm64-gnu@4.62.4':
+    optional: true
+
+  '@rollup/rollup-linux-arm64-musl@4.62.4':
+    optional: true
+
+  '@rollup/rollup-linux-loong64-gnu@4.62.4':
+    optional: true
+
+  '@rollup/rollup-linux-loong64-musl@4.62.4':
+    optional: true
+
+  '@rollup/rollup-linux-ppc64-gnu@4.62.4':
+    optional: true
+
+  '@rollup/rollup-linux-ppc64-musl@4.62.4':
+    optional: true
+
+  '@rollup/rollup-linux-riscv64-gnu@4.62.4':
+    optional: true
+
+  '@rollup/rollup-linux-riscv64-musl@4.62.4':
+    optional: true
+
+  '@rollup/rollup-linux-s390x-gnu@4.62.4':
+    optional: true
+
+  '@rollup/rollup-linux-x64-gnu@4.62.4':
+    optional: true
+
+  '@rollup/rollup-linux-x64-musl@4.62.4':
+    optional: true
+
+  '@rollup/rollup-openbsd-x64@4.62.4':
+    optional: true
+
+  '@rollup/rollup-openharmony-arm64@4.62.4':
+    optional: true
+
+  '@rollup/rollup-win32-arm64-msvc@4.62.4':
+    optional: true
+
+  '@rollup/rollup-win32-ia32-msvc@4.62.4':
+    optional: true
+
+  '@rollup/rollup-win32-x64-gnu@4.62.4':
+    optional: true
+
+  '@rollup/rollup-win32-x64-msvc@4.62.4':
+    optional: true
+
+  '@tiptap/core@3.29.2(@tiptap/pm@3.29.2)':
+    dependencies:
+      '@tiptap/pm': 3.29.2
+
+  '@tiptap/extension-blockquote@3.29.2(@tiptap/core@3.29.2(@tiptap/pm@3.29.2))(@tiptap/pm@3.29.2)':
+    dependencies:
+      '@tiptap/core': 3.29.2(@tiptap/pm@3.29.2)
+      '@tiptap/pm': 3.29.2
+
+  '@tiptap/extension-bold@3.29.2(@tiptap/core@3.29.2(@tiptap/pm@3.29.2))':
+    dependencies:
+      '@tiptap/core': 3.29.2(@tiptap/pm@3.29.2)
+
+  '@tiptap/extension-bubble-menu@3.29.2(@tiptap/core@3.29.2(@tiptap/pm@3.29.2))(@tiptap/pm@3.29.2)':
+    dependencies:
+      '@floating-ui/dom': 1.8.0
+      '@tiptap/core': 3.29.2(@tiptap/pm@3.29.2)
+      '@tiptap/pm': 3.29.2
+    optional: true
+
+  '@tiptap/extension-bullet-list@3.29.2(@tiptap/extension-list@3.29.2(@tiptap/core@3.29.2(@tiptap/pm@3.29.2))(@tiptap/pm@3.29.2))':
+    dependencies:
+      '@tiptap/extension-list': 3.29.2(@tiptap/core@3.29.2(@tiptap/pm@3.29.2))(@tiptap/pm@3.29.2)
+
+  '@tiptap/extension-code-block@3.29.2(@tiptap/core@3.29.2(@tiptap/pm@3.29.2))(@tiptap/pm@3.29.2)':
+    dependencies:
+      '@tiptap/core': 3.29.2(@tiptap/pm@3.29.2)
+      '@tiptap/pm': 3.29.2
+
+  '@tiptap/extension-code@3.29.2(@tiptap/core@3.29.2(@tiptap/pm@3.29.2))':
+    dependencies:
+      '@tiptap/core': 3.29.2(@tiptap/pm@3.29.2)
+
+  '@tiptap/extension-document@3.29.2(@tiptap/core@3.29.2(@tiptap/pm@3.29.2))':
+    dependencies:
+      '@tiptap/core': 3.29.2(@tiptap/pm@3.29.2)
+
+  '@tiptap/extension-dropcursor@3.29.2(@tiptap/extensions@3.29.2(@tiptap/core@3.29.2(@tiptap/pm@3.29.2))(@tiptap/pm@3.29.2))':
+    dependencies:
+      '@tiptap/extensions': 3.29.2(@tiptap/core@3.29.2(@tiptap/pm@3.29.2))(@tiptap/pm@3.29.2)
+
+  '@tiptap/extension-floating-menu@3.29.2(@floating-ui/dom@1.8.0)(@tiptap/core@3.29.2(@tiptap/pm@3.29.2))(@tiptap/pm@3.29.2)':
+    dependencies:
+      '@floating-ui/dom': 1.8.0
+      '@tiptap/core': 3.29.2(@tiptap/pm@3.29.2)
+      '@tiptap/pm': 3.29.2
+    optional: true
+
+  '@tiptap/extension-font-family@3.29.2(@tiptap/extension-text-style@3.29.2(@tiptap/core@3.29.2(@tiptap/pm@3.29.2)))':
+    dependencies:
+      '@tiptap/extension-text-style': 3.29.2(@tiptap/core@3.29.2(@tiptap/pm@3.29.2))
+
+  '@tiptap/extension-gapcursor@3.29.2(@tiptap/extensions@3.29.2(@tiptap/core@3.29.2(@tiptap/pm@3.29.2))(@tiptap/pm@3.29.2))':
+    dependencies:
+      '@tiptap/extensions': 3.29.2(@tiptap/core@3.29.2(@tiptap/pm@3.29.2))(@tiptap/pm@3.29.2)
+
+  '@tiptap/extension-hard-break@3.29.2(@tiptap/core@3.29.2(@tiptap/pm@3.29.2))':
+    dependencies:
+      '@tiptap/core': 3.29.2(@tiptap/pm@3.29.2)
+
+  '@tiptap/extension-heading@3.29.2(@tiptap/core@3.29.2(@tiptap/pm@3.29.2))':
+    dependencies:
+      '@tiptap/core': 3.29.2(@tiptap/pm@3.29.2)
+
+  '@tiptap/extension-horizontal-rule@3.29.2(@tiptap/core@3.29.2(@tiptap/pm@3.29.2))(@tiptap/pm@3.29.2)':
+    dependencies:
+      '@tiptap/core': 3.29.2(@tiptap/pm@3.29.2)
+      '@tiptap/pm': 3.29.2
+
+  '@tiptap/extension-italic@3.29.2(@tiptap/core@3.29.2(@tiptap/pm@3.29.2))':
+    dependencies:
+      '@tiptap/core': 3.29.2(@tiptap/pm@3.29.2)
+
+  '@tiptap/extension-link@3.29.2(@tiptap/core@3.29.2(@tiptap/pm@3.29.2))(@tiptap/pm@3.29.2)':
+    dependencies:
+      '@tiptap/core': 3.29.2(@tiptap/pm@3.29.2)
+      '@tiptap/pm': 3.29.2
+      linkifyjs: 4.3.3
+
+  '@tiptap/extension-list-item@3.29.2(@tiptap/extension-list@3.29.2(@tiptap/core@3.29.2(@tiptap/pm@3.29.2))(@tiptap/pm@3.29.2))':
+    dependencies:
+      '@tiptap/extension-list': 3.29.2(@tiptap/core@3.29.2(@tiptap/pm@3.29.2))(@tiptap/pm@3.29.2)
+
+  '@tiptap/extension-list-keymap@3.29.2(@tiptap/extension-list@3.29.2(@tiptap/core@3.29.2(@tiptap/pm@3.29.2))(@tiptap/pm@3.29.2))':
+    dependencies:
+      '@tiptap/extension-list': 3.29.2(@tiptap/core@3.29.2(@tiptap/pm@3.29.2))(@tiptap/pm@3.29.2)
+
+  '@tiptap/extension-list@3.29.2(@tiptap/core@3.29.2(@tiptap/pm@3.29.2))(@tiptap/pm@3.29.2)':
+    dependencies:
+      '@tiptap/core': 3.29.2(@tiptap/pm@3.29.2)
+      '@tiptap/pm': 3.29.2
+
+  '@tiptap/extension-ordered-list@3.29.2(@tiptap/extension-list@3.29.2(@tiptap/core@3.29.2(@tiptap/pm@3.29.2))(@tiptap/pm@3.29.2))':
+    dependencies:
+      '@tiptap/extension-list': 3.29.2(@tiptap/core@3.29.2(@tiptap/pm@3.29.2))(@tiptap/pm@3.29.2)
+
+  '@tiptap/extension-paragraph@3.29.2(@tiptap/core@3.29.2(@tiptap/pm@3.29.2))':
+    dependencies:
+      '@tiptap/core': 3.29.2(@tiptap/pm@3.29.2)
+
+  '@tiptap/extension-strike@3.29.2(@tiptap/core@3.29.2(@tiptap/pm@3.29.2))':
+    dependencies:
+      '@tiptap/core': 3.29.2(@tiptap/pm@3.29.2)
+
+  '@tiptap/extension-text-style@3.29.2(@tiptap/core@3.29.2(@tiptap/pm@3.29.2))':
+    dependencies:
+      '@tiptap/core': 3.29.2(@tiptap/pm@3.29.2)
+
+  '@tiptap/extension-text@3.29.2(@tiptap/core@3.29.2(@tiptap/pm@3.29.2))':
+    dependencies:
+      '@tiptap/core': 3.29.2(@tiptap/pm@3.29.2)
+
+  '@tiptap/extension-underline@3.29.2(@tiptap/core@3.29.2(@tiptap/pm@3.29.2))':
+    dependencies:
+      '@tiptap/core': 3.29.2(@tiptap/pm@3.29.2)
+
+  '@tiptap/extensions@3.29.2(@tiptap/core@3.29.2(@tiptap/pm@3.29.2))(@tiptap/pm@3.29.2)':
+    dependencies:
+      '@tiptap/core': 3.29.2(@tiptap/pm@3.29.2)
+      '@tiptap/pm': 3.29.2
+
+  '@tiptap/pm@3.29.2':
+    dependencies:
+      prosemirror-changeset: 2.4.1
+      prosemirror-commands: 1.7.2
+      prosemirror-dropcursor: 1.8.3
+      prosemirror-gapcursor: 1.4.1
+      prosemirror-history: 1.5.0
+      prosemirror-inputrules: 1.5.1
+      prosemirror-keymap: 1.2.3
+      prosemirror-model: 1.25.11
+      prosemirror-schema-list: 1.5.1
+      prosemirror-state: 1.4.4
+      prosemirror-tables: 1.8.5
+      prosemirror-transform: 1.12.0
+      prosemirror-view: 1.42.2
+
+  '@tiptap/starter-kit@3.29.2':
+    dependencies:
+      '@tiptap/core': 3.29.2(@tiptap/pm@3.29.2)
+      '@tiptap/extension-blockquote': 3.29.2(@tiptap/core@3.29.2(@tiptap/pm@3.29.2))(@tiptap/pm@3.29.2)
+      '@tiptap/extension-bold': 3.29.2(@tiptap/core@3.29.2(@tiptap/pm@3.29.2))
+      '@tiptap/extension-bullet-list': 3.29.2(@tiptap/extension-list@3.29.2(@tiptap/core@3.29.2(@tiptap/pm@3.29.2))(@tiptap/pm@3.29.2))
+      '@tiptap/extension-code': 3.29.2(@tiptap/core@3.29.2(@tiptap/pm@3.29.2))
+      '@tiptap/extension-code-block': 3.29.2(@tiptap/core@3.29.2(@tiptap/pm@3.29.2))(@tiptap/pm@3.29.2)
+      '@tiptap/extension-document': 3.29.2(@tiptap/core@3.29.2(@tiptap/pm@3.29.2))
+      '@tiptap/extension-dropcursor': 3.29.2(@tiptap/extensions@3.29.2(@tiptap/core@3.29.2(@tiptap/pm@3.29.2))(@tiptap/pm@3.29.2))
+      '@tiptap/extension-gapcursor': 3.29.2(@tiptap/extensions@3.29.2(@tiptap/core@3.29.2(@tiptap/pm@3.29.2))(@tiptap/pm@3.29.2))
+      '@tiptap/extension-hard-break': 3.29.2(@tiptap/core@3.29.2(@tiptap/pm@3.29.2))
+      '@tiptap/extension-heading': 3.29.2(@tiptap/core@3.29.2(@tiptap/pm@3.29.2))
+      '@tiptap/extension-horizontal-rule': 3.29.2(@tiptap/core@3.29.2(@tiptap/pm@3.29.2))(@tiptap/pm@3.29.2)
+      '@tiptap/extension-italic': 3.29.2(@tiptap/core@3.29.2(@tiptap/pm@3.29.2))
+      '@tiptap/extension-link': 3.29.2(@tiptap/core@3.29.2(@tiptap/pm@3.29.2))(@tiptap/pm@3.29.2)
+      '@tiptap/extension-list': 3.29.2(@tiptap/core@3.29.2(@tiptap/pm@3.29.2))(@tiptap/pm@3.29.2)
+      '@tiptap/extension-list-item': 3.29.2(@tiptap/extension-list@3.29.2(@tiptap/core@3.29.2(@tiptap/pm@3.29.2))(@tiptap/pm@3.29.2))
+      '@tiptap/extension-list-keymap': 3.29.2(@tiptap/extension-list@3.29.2(@tiptap/core@3.29.2(@tiptap/pm@3.29.2))(@tiptap/pm@3.29.2))
+      '@tiptap/extension-ordered-list': 3.29.2(@tiptap/extension-list@3.29.2(@tiptap/core@3.29.2(@tiptap/pm@3.29.2))(@tiptap/pm@3.29.2))
+      '@tiptap/extension-paragraph': 3.29.2(@tiptap/core@3.29.2(@tiptap/pm@3.29.2))
+      '@tiptap/extension-strike': 3.29.2(@tiptap/core@3.29.2(@tiptap/pm@3.29.2))
+      '@tiptap/extension-text': 3.29.2(@tiptap/core@3.29.2(@tiptap/pm@3.29.2))
+      '@tiptap/extension-underline': 3.29.2(@tiptap/core@3.29.2(@tiptap/pm@3.29.2))
+      '@tiptap/extensions': 3.29.2(@tiptap/core@3.29.2(@tiptap/pm@3.29.2))(@tiptap/pm@3.29.2)
+      '@tiptap/pm': 3.29.2
+
+  '@tiptap/vue-3@3.29.2(@floating-ui/dom@1.8.0)(@tiptap/core@3.29.2(@tiptap/pm@3.29.2))(@tiptap/pm@3.29.2)(vue@3.5.41(typescript@6.0.3))':
+    dependencies:
+      '@floating-ui/dom': 1.8.0
+      '@tiptap/core': 3.29.2(@tiptap/pm@3.29.2)
+      '@tiptap/pm': 3.29.2
+      vue: 3.5.41(typescript@6.0.3)
+    optionalDependencies:
+      '@tiptap/extension-bubble-menu': 3.29.2(@tiptap/core@3.29.2(@tiptap/pm@3.29.2))(@tiptap/pm@3.29.2)
+      '@tiptap/extension-floating-menu': 3.29.2(@floating-ui/dom@1.8.0)(@tiptap/core@3.29.2(@tiptap/pm@3.29.2))(@tiptap/pm@3.29.2)
+
+  '@tsconfig/node24@24.0.4': {}
+
+  '@tybys/wasm-util@0.10.3':
+    dependencies:
+      tslib: 2.8.1
+    optional: true
+
+  '@types/chai@5.2.3':
+    dependencies:
+      '@types/deep-eql': 4.0.2
+      assertion-error: 2.0.1
+
+  '@types/deep-eql@4.0.2': {}
+
+  '@types/estree@1.0.9': {}
+
+  '@types/lodash-es@4.17.12':
+    dependencies:
+      '@types/lodash': 4.17.25
+
+  '@types/lodash@4.17.25': {}
+
+  '@types/node@24.13.3':
+    dependencies:
+      undici-types: 7.18.2
+
+  '@types/pako@2.0.4': {}
+
+  '@types/qrcode@1.5.6':
+    dependencies:
+      '@types/node': 24.13.3
+
+  '@types/raf@3.4.3':
+    optional: true
+
+  '@types/trusted-types@2.0.7':
+    optional: true
+
+  '@types/web-bluetooth@0.0.21': {}
+
+  '@types/whatwg-mimetype@3.0.2': {}
+
+  '@types/ws@8.18.1':
+    dependencies:
+      '@types/node': 24.13.3
+
+  '@unocss/cli@66.7.5':
+    dependencies:
+      '@jridgewell/remapping': 2.3.5
+      '@unocss/config': 66.7.5
+      '@unocss/core': 66.7.5
+      '@unocss/preset-wind3': 66.7.5
+      '@unocss/preset-wind4': 66.7.5
+      '@unocss/transformer-directives': 66.7.5
+      cac: 7.0.0
+      chokidar: 5.0.0
+      colorette: 2.0.20
+      consola: 3.4.2
+      magic-string: 0.30.21
+      pathe: 2.0.3
+      perfect-debounce: 2.1.0
+      tinyglobby: 0.2.17
+      unplugin-utils: 0.3.2
+
+  '@unocss/config@66.7.5':
+    dependencies:
+      '@unocss/core': 66.7.5
+      colorette: 2.0.20
+      consola: 3.4.2
+      unconfig: 7.5.0
+
+  '@unocss/core@66.7.5': {}
+
+  '@unocss/extractor-arbitrary-variants@66.7.5':
+    dependencies:
+      '@unocss/core': 66.7.5
+
+  '@unocss/inspector@66.7.5':
+    dependencies:
+      '@unocss/core': 66.7.5
+      '@unocss/rule-utils': 66.7.5
+      colorette: 2.0.20
+      gzip-size: 6.0.0
+      sirv: 3.0.2
+
+  '@unocss/preset-attributify@66.7.5':
+    dependencies:
+      '@unocss/core': 66.7.5
+
+  '@unocss/preset-icons@66.7.5':
+    dependencies:
+      '@iconify/utils': 3.1.4
+      '@unocss/core': 66.7.5
+      ofetch: 1.5.1
+
+  '@unocss/preset-mini@66.7.5':
+    dependencies:
+      '@unocss/core': 66.7.5
+      '@unocss/extractor-arbitrary-variants': 66.7.5
+      '@unocss/rule-utils': 66.7.5
+
+  '@unocss/preset-tagify@66.7.5':
+    dependencies:
+      '@unocss/core': 66.7.5
+
+  '@unocss/preset-typography@66.7.5':
+    dependencies:
+      '@unocss/core': 66.7.5
+      '@unocss/rule-utils': 66.7.5
+
+  '@unocss/preset-uno@66.7.5':
+    dependencies:
+      '@unocss/core': 66.7.5
+      '@unocss/preset-wind3': 66.7.5
+
+  '@unocss/preset-web-fonts@66.7.5':
+    dependencies:
+      '@unocss/core': 66.7.5
+      ofetch: 1.5.1
+
+  '@unocss/preset-wind3@66.7.5':
+    dependencies:
+      '@unocss/core': 66.7.5
+      '@unocss/preset-mini': 66.7.5
+      '@unocss/rule-utils': 66.7.5
+
+  '@unocss/preset-wind4@66.7.5':
+    dependencies:
+      '@unocss/core': 66.7.5
+      '@unocss/extractor-arbitrary-variants': 66.7.5
+      '@unocss/rule-utils': 66.7.5
+
+  '@unocss/preset-wind@66.7.5':
+    dependencies:
+      '@unocss/core': 66.7.5
+      '@unocss/preset-wind3': 66.7.5
+
+  '@unocss/rule-utils@66.7.5':
+    dependencies:
+      '@unocss/core': 66.7.5
+      magic-string: 0.30.21
+
+  '@unocss/transformer-attributify-jsx@66.7.5':
+    dependencies:
+      '@unocss/core': 66.7.5
+      oxc-parser: 0.131.0
+      oxc-walker: 0.7.0(oxc-parser@0.131.0)
+
+  '@unocss/transformer-compile-class@66.7.5':
+    dependencies:
+      '@unocss/core': 66.7.5
+
+  '@unocss/transformer-directives@66.7.5':
+    dependencies:
+      '@unocss/core': 66.7.5
+      '@unocss/rule-utils': 66.7.5
+      css-tree: 3.2.1
+
+  '@unocss/transformer-variant-group@66.7.5':
+    dependencies:
+      '@unocss/core': 66.7.5
+
+  '@unocss/vite@66.7.5(vite@8.2.0(@types/node@24.13.3)(esbuild@0.28.2)(jiti@2.7.0)(yaml@2.9.0))':
+    dependencies:
+      '@jridgewell/remapping': 2.3.5
+      '@unocss/config': 66.7.5
+      '@unocss/core': 66.7.5
+      '@unocss/inspector': 66.7.5
+      chokidar: 5.0.0
+      magic-string: 0.30.21
+      pathe: 2.0.3
+      tinyglobby: 0.2.17
+      unplugin-utils: 0.3.2
+      vite: 8.2.0(@types/node@24.13.3)(esbuild@0.28.2)(jiti@2.7.0)(yaml@2.9.0)
+
+  '@vitejs/plugin-vue@6.0.8(vite@8.2.0(@types/node@24.13.3)(esbuild@0.28.2)(jiti@2.7.0)(yaml@2.9.0))(vue@3.5.41(typescript@6.0.3))':
+    dependencies:
+      '@rolldown/pluginutils': 1.0.1
+      vite: 8.2.0(@types/node@24.13.3)(esbuild@0.28.2)(jiti@2.7.0)(yaml@2.9.0)
+      vue: 3.5.41(typescript@6.0.3)
+
+  '@vitest/coverage-v8@3.2.7(vitest@3.2.7(@types/node@24.13.3)(happy-dom@20.11.2)(jiti@2.7.0)(jsdom@26.1.0(canvas@3.2.3))(lightningcss@1.33.0)(yaml@2.9.0))':
+    dependencies:
+      '@ampproject/remapping': 2.3.0
+      '@bcoe/v8-coverage': 1.0.2
+      ast-v8-to-istanbul: 0.3.12
+      debug: 4.4.3
+      istanbul-lib-coverage: 3.2.2
+      istanbul-lib-report: 3.0.1
+      istanbul-lib-source-maps: 5.0.6
+      istanbul-reports: 3.2.0
+      magic-string: 0.30.21
+      magicast: 0.3.5
+      std-env: 3.10.0
+      test-exclude: 7.0.2
+      tinyrainbow: 2.0.0
+      vitest: 3.2.7(@types/node@24.13.3)(happy-dom@20.11.2)(jiti@2.7.0)(jsdom@26.1.0(canvas@3.2.3))(lightningcss@1.33.0)(yaml@2.9.0)
+    transitivePeerDependencies:
+      - supports-color
+
+  '@vitest/expect@3.2.7':
+    dependencies:
+      '@types/chai': 5.2.3
+      '@vitest/spy': 3.2.7
+      '@vitest/utils': 3.2.7
+      chai: 5.3.3
+      tinyrainbow: 2.0.0
+
+  '@vitest/mocker@3.2.7(vite@7.3.6(@types/node@24.13.3)(jiti@2.7.0)(lightningcss@1.33.0)(yaml@2.9.0))':
+    dependencies:
+      '@vitest/spy': 3.2.7
+      estree-walker: 3.0.3
+      magic-string: 0.30.21
+    optionalDependencies:
+      vite: 7.3.6(@types/node@24.13.3)(jiti@2.7.0)(lightningcss@1.33.0)(yaml@2.9.0)
+
+  '@vitest/pretty-format@3.2.7':
+    dependencies:
+      tinyrainbow: 2.0.0
+
+  '@vitest/runner@3.2.7':
+    dependencies:
+      '@vitest/utils': 3.2.7
+      pathe: 2.0.3
+      strip-literal: 3.1.0
+
+  '@vitest/snapshot@3.2.7':
+    dependencies:
+      '@vitest/pretty-format': 3.2.7
+      magic-string: 0.30.21
+      pathe: 2.0.3
+
+  '@vitest/spy@3.2.7':
+    dependencies:
+      tinyspy: 4.0.4
+
+  '@vitest/utils@3.2.7':
+    dependencies:
+      '@vitest/pretty-format': 3.2.7
+      loupe: 3.2.1
+      tinyrainbow: 2.0.0
+
+  '@volar/language-core@2.4.28':
+    dependencies:
+      '@volar/source-map': 2.4.28
+
+  '@volar/source-map@2.4.28': {}
+
+  '@volar/typescript@2.4.28':
+    dependencies:
+      '@volar/language-core': 2.4.28
+      path-browserify: 1.0.1
+      vscode-uri: 3.1.0
+
+  '@vue/babel-helper-vue-transform-on@1.5.0': {}
+
+  '@vue/babel-plugin-jsx@1.5.0(@babel/core@7.29.7)':
+    dependencies:
+      '@babel/helper-module-imports': 7.29.7
+      '@babel/helper-plugin-utils': 7.29.7
+      '@babel/plugin-syntax-jsx': 7.29.7(@babel/core@7.29.7)
+      '@babel/template': 7.29.7
+      '@babel/traverse': 7.29.8
+      '@babel/types': 7.29.8
+      '@vue/babel-helper-vue-transform-on': 1.5.0
+      '@vue/babel-plugin-resolve-type': 1.5.0(@babel/core@7.29.7)
+      '@vue/shared': 3.5.41
+    optionalDependencies:
+      '@babel/core': 7.29.7
+    transitivePeerDependencies:
+      - supports-color
+
+  '@vue/babel-plugin-resolve-type@1.5.0(@babel/core@7.29.7)':
+    dependencies:
+      '@babel/code-frame': 7.29.7
+      '@babel/core': 7.29.7
+      '@babel/helper-module-imports': 7.29.7
+      '@babel/helper-plugin-utils': 7.29.7
+      '@babel/parser': 7.29.8
+      '@vue/compiler-sfc': 3.5.41
+    transitivePeerDependencies:
+      - supports-color
+
+  '@vue/compiler-core@3.5.41':
+    dependencies:
+      '@babel/parser': 7.29.8
+      '@vue/shared': 3.5.41
+      entities: 7.0.1
+      estree-walker: 2.0.2
+      source-map-js: 1.2.1
+
+  '@vue/compiler-dom@3.5.41':
+    dependencies:
+      '@vue/compiler-core': 3.5.41
+      '@vue/shared': 3.5.41
+
+  '@vue/compiler-sfc@3.5.41':
+    dependencies:
+      '@babel/parser': 7.29.8
+      '@vue/compiler-core': 3.5.41
+      '@vue/compiler-dom': 3.5.41
+      '@vue/compiler-ssr': 3.5.41
+      '@vue/shared': 3.5.41
+      estree-walker: 2.0.2
+      magic-string: 0.30.21
+      postcss: 8.5.25
+      source-map-js: 1.2.1
+
+  '@vue/compiler-ssr@3.5.41':
+    dependencies:
+      '@vue/compiler-dom': 3.5.41
+      '@vue/shared': 3.5.41
+
+  '@vue/devtools-api@8.2.1':
+    dependencies:
+      '@vue/devtools-kit': 8.2.1
+
+  '@vue/devtools-core@8.2.1(vue@3.5.41(typescript@6.0.3))':
+    dependencies:
+      '@vue/devtools-kit': 8.2.1
+      '@vue/devtools-shared': 8.2.1
+      vue: 3.5.41(typescript@6.0.3)
+
+  '@vue/devtools-kit@8.2.1':
+    dependencies:
+      '@vue/devtools-shared': 8.2.1
+      birpc: 2.9.0
+      hookable: 5.5.3
+      perfect-debounce: 2.1.0
+
+  '@vue/devtools-shared@8.2.1': {}
+
+  '@vue/language-core@3.3.9':
+    dependencies:
+      '@volar/language-core': 2.4.28
+      '@vue/compiler-dom': 3.5.41
+      '@vue/shared': 3.5.41
+      alien-signals: 3.2.1
+      muggle-string: 0.4.1
+      path-browserify: 1.0.1
+      picomatch: 4.0.5
+
+  '@vue/reactivity@3.5.41':
+    dependencies:
+      '@vue/shared': 3.5.41
+
+  '@vue/runtime-core@3.5.41':
+    dependencies:
+      '@vue/reactivity': 3.5.41
+      '@vue/shared': 3.5.41
+
+  '@vue/runtime-dom@3.5.41':
+    dependencies:
+      '@vue/reactivity': 3.5.41
+      '@vue/runtime-core': 3.5.41
+      '@vue/shared': 3.5.41
+      csstype: 3.2.3
+
+  '@vue/server-renderer@3.5.41':
+    dependencies:
+      '@vue/compiler-ssr': 3.5.41
+      '@vue/runtime-dom': 3.5.41
+      '@vue/shared': 3.5.41
+
+  '@vue/shared@3.5.41': {}
+
+  '@vue/tsconfig@0.9.1(typescript@6.0.3)(vue@3.5.41(typescript@6.0.3))':
+    optionalDependencies:
+      typescript: 6.0.3
+      vue: 3.5.41(typescript@6.0.3)
+
+  '@vueuse/core@14.4.0(vue@3.5.41(typescript@6.0.3))':
+    dependencies:
+      '@types/web-bluetooth': 0.0.21
+      '@vueuse/metadata': 14.4.0
+      '@vueuse/shared': 14.4.0(vue@3.5.41(typescript@6.0.3))
+      vue: 3.5.41(typescript@6.0.3)
+
+  '@vueuse/metadata@14.4.0': {}
+
+  '@vueuse/shared@14.4.0(vue@3.5.41(typescript@6.0.3))':
+    dependencies:
+      vue: 3.5.41(typescript@6.0.3)
+
+  acorn@8.18.0: {}
+
+  adler-32@1.3.1: {}
+
+  agent-base@7.1.4:
+    optional: true
+
+  ajv@8.20.0:
+    dependencies:
+      fast-deep-equal: 3.1.3
+      fast-uri: 3.1.5
+      json-schema-traverse: 1.0.0
+      require-from-string: 2.0.2
+
+  alien-signals@3.2.1: {}
+
+  ansi-regex@5.0.1: {}
+
+  ansi-regex@6.2.2: {}
+
+  ansi-styles@4.3.0:
+    dependencies:
+      color-convert: 2.0.1
+
+  ansi-styles@6.2.3: {}
+
+  ansi-styles@7.0.0: {}
+
+  ansis@4.3.1: {}
+
+  assertion-error@2.0.1: {}
+
+  ast-v8-to-istanbul@0.3.12:
+    dependencies:
+      '@jridgewell/trace-mapping': 0.3.31
+      estree-walker: 3.0.3
+      js-tokens: 10.0.0
+
+  async-validator@4.2.5: {}
+
+  balanced-match@1.0.2: {}
+
+  balanced-match@4.0.4: {}
+
+  base64-arraybuffer@1.0.2:
+    optional: true
+
+  base64-js@1.5.1:
+    optional: true
+
+  baseline-browser-mapping@2.11.12: {}
+
+  birpc@2.9.0: {}
+
+  birpc@4.0.0: {}
+
+  bl@4.1.0:
+    dependencies:
+      buffer: 5.7.1
+      inherits: 2.0.4
+      readable-stream: 3.6.2
+    optional: true
+
+  brace-expansion@2.1.4:
+    dependencies:
+      balanced-match: 1.0.2
+
+  brace-expansion@5.0.9:
+    dependencies:
+      balanced-match: 4.0.4
+
+  browserslist@4.28.7:
+    dependencies:
+      baseline-browser-mapping: 2.11.12
+      caniuse-lite: 1.0.30001806
+      electron-to-chromium: 1.5.401
+      node-releases: 2.0.52
+      update-browserslist-db: 1.2.3(browserslist@4.28.7)
+
+  buffer-image-size@0.6.4:
+    dependencies:
+      '@types/node': 24.13.3
+
+  buffer@5.7.1:
+    dependencies:
+      base64-js: 1.5.1
+      ieee754: 1.2.1
+    optional: true
+
+  bundle-name@4.1.0:
+    dependencies:
+      run-applescript: 7.1.0
+
+  cac@6.7.14: {}
+
+  cac@7.0.0: {}
+
+  camelcase@5.3.1: {}
+
+  caniuse-lite@1.0.30001806: {}
+
+  canvas@3.2.3:
+    dependencies:
+      node-addon-api: 7.1.1
+      prebuild-install: 7.1.3
+    optional: true
+
+  canvg@3.0.11:
+    dependencies:
+      '@babel/runtime': 7.29.7
+      '@types/raf': 3.4.3
+      core-js: 3.50.0
+      raf: 3.4.1
+      regenerator-runtime: 0.13.11
+      rgbcolor: 1.0.1
+      stackblur-canvas: 2.7.0
+      svg-pathdata: 6.0.3
+    optional: true
+
+  cfb@1.2.2:
+    dependencies:
+      adler-32: 1.3.1
+      crc-32: 1.2.2
+
+  chai@5.3.3:
+    dependencies:
+      assertion-error: 2.0.1
+      check-error: 2.1.3
+      deep-eql: 5.0.2
+      loupe: 3.2.1
+      pathval: 2.0.1
+
+  check-error@2.1.3: {}
+
+  chokidar@5.0.0:
+    dependencies:
+      readdirp: 5.0.0
+
+  chownr@1.1.4:
+    optional: true
+
+  cliui@6.0.0:
+    dependencies:
+      string-width: 4.2.3
+      strip-ansi: 6.0.1
+      wrap-ansi: 6.2.0
+
+  codemirror@6.0.2:
+    dependencies:
+      '@codemirror/autocomplete': 6.20.3
+      '@codemirror/commands': 6.10.4
+      '@codemirror/language': 6.12.4
+      '@codemirror/lint': 6.9.7
+      '@codemirror/search': 6.7.1
+      '@codemirror/state': 6.7.1
+      '@codemirror/view': 6.43.8
+
+  codepage@1.15.0: {}
+
+  color-convert@2.0.1:
+    dependencies:
+      color-name: 1.1.4
+
+  color-name@1.1.4: {}
+
+  colorette@2.0.20: {}
+
+  confbox@0.1.8: {}
+
+  consola@3.4.2: {}
+
+  convert-source-map@2.0.0: {}
+
+  core-js@3.50.0:
+    optional: true
+
+  crc-32@1.2.2: {}
+
+  crelt@1.0.7: {}
+
+  cross-spawn@7.0.6:
+    dependencies:
+      path-key: 3.1.1
+      shebang-command: 2.0.0
+      which: 2.0.2
+
+  css-line-break@2.1.0:
+    dependencies:
+      utrie: 1.0.2
+    optional: true
+
+  css-render@0.15.14:
+    dependencies:
+      '@emotion/hash': 0.8.0
+      csstype: 3.0.11
+
+  css-tree@3.2.1:
+    dependencies:
+      mdn-data: 2.27.1
+      source-map-js: 1.2.1
+
+  cssesc@3.0.0: {}
+
+  cssstyle@4.6.0:
+    dependencies:
+      '@asamuzakjp/css-color': 3.2.0
+      rrweb-cssom: 0.8.0
+    optional: true
+
+  csstype@3.0.11: {}
+
+  csstype@3.2.3: {}
+
+  data-urls@5.0.0:
+    dependencies:
+      whatwg-mimetype: 4.0.0
+      whatwg-url: 14.2.0
+    optional: true
+
+  date-fns-tz@3.2.0(date-fns@4.4.0):
+    dependencies:
+      date-fns: 4.4.0
+
+  date-fns@4.4.0: {}
+
+  debug@4.4.3:
+    dependencies:
+      ms: 2.1.3
+
+  decamelize@1.2.0: {}
+
+  decimal.js@10.6.0:
+    optional: true
+
+  decompress-response@6.0.0:
+    dependencies:
+      mimic-response: 3.1.0
+    optional: true
+
+  deep-eql@5.0.2: {}
+
+  deep-extend@0.6.0:
+    optional: true
+
+  default-browser-id@5.0.1: {}
+
+  default-browser@5.5.0:
+    dependencies:
+      bundle-name: 4.1.0
+      default-browser-id: 5.0.1
+
+  define-lazy-prop@3.0.0: {}
+
+  defu@6.1.7: {}
+
+  destr@2.0.5: {}
+
+  detect-libc@2.1.2: {}
+
+  dijkstrajs@1.0.3: {}
+
+  dompurify@3.4.13:
+    optionalDependencies:
+      '@types/trusted-types': 2.0.7
+
+  duplexer@0.1.2: {}
+
+  eastasianwidth@0.2.0: {}
+
+  electron-to-chromium@1.5.401: {}
+
+  emoji-regex@8.0.0: {}
+
+  emoji-regex@9.2.2: {}
+
+  end-of-stream@1.4.5:
+    dependencies:
+      once: 1.4.0
+    optional: true
+
+  entities@6.0.1:
+    optional: true
+
+  entities@7.0.1: {}
+
+  error-stack-parser-es@1.0.5: {}
+
+  es-module-lexer@1.7.0: {}
+
+  esbuild@0.28.2:
+    optionalDependencies:
+      '@esbuild/aix-ppc64': 0.28.2
+      '@esbuild/android-arm': 0.28.2
+      '@esbuild/android-arm64': 0.28.2
+      '@esbuild/android-x64': 0.28.2
+      '@esbuild/darwin-arm64': 0.28.2
+      '@esbuild/darwin-x64': 0.28.2
+      '@esbuild/freebsd-arm64': 0.28.2
+      '@esbuild/freebsd-x64': 0.28.2
+      '@esbuild/linux-arm': 0.28.2
+      '@esbuild/linux-arm64': 0.28.2
+      '@esbuild/linux-ia32': 0.28.2
+      '@esbuild/linux-loong64': 0.28.2
+      '@esbuild/linux-mips64el': 0.28.2
+      '@esbuild/linux-ppc64': 0.28.2
+      '@esbuild/linux-riscv64': 0.28.2
+      '@esbuild/linux-s390x': 0.28.2
+      '@esbuild/linux-x64': 0.28.2
+      '@esbuild/netbsd-arm64': 0.28.2
+      '@esbuild/netbsd-x64': 0.28.2
+      '@esbuild/openbsd-arm64': 0.28.2
+      '@esbuild/openbsd-x64': 0.28.2
+      '@esbuild/openharmony-arm64': 0.28.2
+      '@esbuild/sunos-x64': 0.28.2
+      '@esbuild/win32-arm64': 0.28.2
+      '@esbuild/win32-ia32': 0.28.2
+      '@esbuild/win32-x64': 0.28.2
+
+  escalade@3.2.0: {}
+
+  estree-walker@2.0.2: {}
+
+  estree-walker@3.0.3:
+    dependencies:
+      '@types/estree': 1.0.9
+
+  evtd@0.2.4: {}
+
+  expand-template@2.0.3:
+    optional: true
+
+  expect-type@1.4.0: {}
+
+  fabric@7.4.0:
+    optionalDependencies:
+      canvas: 3.2.3
+      jsdom: 26.1.0(canvas@3.2.3)
+    transitivePeerDependencies:
+      - bufferutil
+      - supports-color
+      - utf-8-validate
+
+  fast-deep-equal@3.1.3: {}
+
+  fast-png@6.4.0:
+    dependencies:
+      '@types/pako': 2.0.4
+      iobuffer: 5.4.0
+      pako: 2.2.0
+
+  fast-uri@3.1.5: {}
+
+  fdir@6.5.0(picomatch@4.0.5):
+    optionalDependencies:
+      picomatch: 4.0.5
+
+  fflate@0.8.3: {}
+
+  find-up@4.1.0:
+    dependencies:
+      locate-path: 5.0.0
+      path-exists: 4.0.0
+
+  font-family-papandreou@0.2.0-patch2: {}
+
+  foreground-child@3.3.1:
+    dependencies:
+      cross-spawn: 7.0.6
+      signal-exit: 4.1.0
+
+  frac@1.1.2: {}
+
+  fs-constants@1.0.0:
+    optional: true
+
+  fsevents@2.3.3:
+    optional: true
+
+  gensync@1.0.0-beta.2: {}
+
+  get-caller-file@2.0.5: {}
+
+  github-from-package@0.0.0:
+    optional: true
+
+  glob@10.5.0:
+    dependencies:
+      foreground-child: 3.3.1
+      jackspeak: 3.4.3
+      minimatch: 9.0.9
+      minipass: 7.1.3
+      package-json-from-dist: 1.0.1
+      path-scurry: 1.11.1
+
+  gzip-size@6.0.0:
+    dependencies:
+      duplexer: 0.1.2
+
+  happy-dom@20.11.2:
+    dependencies:
+      '@types/node': 24.13.3
+      '@types/whatwg-mimetype': 3.0.2
+      '@types/ws': 8.18.1
+      buffer-image-size: 0.6.4
+      entities: 7.0.1
+      whatwg-mimetype: 3.0.0
+      ws: 8.21.2
+    transitivePeerDependencies:
+      - bufferutil
+      - utf-8-validate
+
+  has-flag@4.0.0: {}
+
+  highlight.js@11.11.1: {}
+
+  hookable@5.5.3: {}
+
+  html-encoding-sniffer@4.0.0:
+    dependencies:
+      whatwg-encoding: 3.1.1
+    optional: true
+
+  html-escaper@2.0.2: {}
+
+  html2canvas@1.4.1:
+    dependencies:
+      css-line-break: 2.1.0
+      text-segmentation: 1.0.3
+    optional: true
+
+  http-proxy-agent@7.0.2:
+    dependencies:
+      agent-base: 7.1.4
+      debug: 4.4.3
+    transitivePeerDependencies:
+      - supports-color
+    optional: true
+
+  https-proxy-agent@7.0.6:
+    dependencies:
+      agent-base: 7.1.4
+      debug: 4.4.3
+    transitivePeerDependencies:
+      - supports-color
+    optional: true
+
+  iconv-lite@0.6.3:
+    dependencies:
+      safer-buffer: 2.1.2
+    optional: true
+
+  ieee754@1.2.1:
+    optional: true
+
+  import-meta-resolve@4.2.0: {}
+
+  inherits@2.0.4:
+    optional: true
+
+  ini@1.3.8:
+    optional: true
+
+  iobuffer@5.4.0: {}
+
+  is-docker@3.0.0: {}
+
+  is-fullwidth-code-point@3.0.0: {}
+
+  is-in-ssh@1.0.0: {}
+
+  is-inside-container@1.0.0:
+    dependencies:
+      is-docker: 3.0.0
+
+  is-potential-custom-element-name@1.0.1:
+    optional: true
+
+  is-wsl@3.1.1:
+    dependencies:
+      is-inside-container: 1.0.0
+
+  isexe@2.0.0: {}
+
+  isexe@4.0.0: {}
+
+  istanbul-lib-coverage@3.2.2: {}
+
+  istanbul-lib-report@3.0.1:
+    dependencies:
+      istanbul-lib-coverage: 3.2.2
+      make-dir: 4.0.0
+      supports-color: 7.2.0
+
+  istanbul-lib-source-maps@5.0.6:
+    dependencies:
+      '@jridgewell/trace-mapping': 0.3.31
+      debug: 4.4.3
+      istanbul-lib-coverage: 3.2.2
+    transitivePeerDependencies:
+      - supports-color
+
+  istanbul-reports@3.2.0:
+    dependencies:
+      html-escaper: 2.0.2
+      istanbul-lib-report: 3.0.1
+
+  jackspeak@3.4.3:
+    dependencies:
+      '@isaacs/cliui': 8.0.2
+    optionalDependencies:
+      '@pkgjs/parseargs': 0.11.0
+
+  jiti@2.7.0: {}
+
+  js-tokens@10.0.0: {}
+
+  js-tokens@4.0.0: {}
+
+  js-tokens@9.0.1: {}
+
+  jsdom@26.1.0(canvas@3.2.3):
+    dependencies:
+      cssstyle: 4.6.0
+      data-urls: 5.0.0
+      decimal.js: 10.6.0
+      html-encoding-sniffer: 4.0.0
+      http-proxy-agent: 7.0.2
+      https-proxy-agent: 7.0.6
+      is-potential-custom-element-name: 1.0.1
+      nwsapi: 2.2.24
+      parse5: 7.3.0
+      rrweb-cssom: 0.8.0
+      saxes: 6.0.0
+      symbol-tree: 3.2.4
+      tough-cookie: 5.1.2
+      w3c-xmlserializer: 5.0.0
+      webidl-conversions: 7.0.0
+      whatwg-encoding: 3.1.1
+      whatwg-mimetype: 4.0.0
+      whatwg-url: 14.2.0
+      ws: 8.21.2
+      xml-name-validator: 5.0.0
+    optionalDependencies:
+      canvas: 3.2.3
+    transitivePeerDependencies:
+      - bufferutil
+      - supports-color
+      - utf-8-validate
+    optional: true
+
+  jsesc@3.1.0: {}
+
+  json-parse-even-better-errors@6.0.0: {}
+
+  json-schema-to-ts@3.1.1:
+    dependencies:
+      '@babel/runtime': 7.29.7
+      ts-algebra: 2.0.0
+
+  json-schema-traverse@1.0.0: {}
+
+  json5@2.2.3: {}
+
+  jspdf@4.2.1:
+    dependencies:
+      '@babel/runtime': 7.29.7
+      fast-png: 6.4.0
+      fflate: 0.8.3
+    optionalDependencies:
+      canvg: 3.0.11
+      core-js: 3.50.0
+      dompurify: 3.4.13
+      html2canvas: 1.4.1
+
+  kolorist@1.8.0: {}
+
+  lightningcss-android-arm64@1.33.0:
+    optional: true
+
+  lightningcss-darwin-arm64@1.33.0:
+    optional: true
+
+  lightningcss-darwin-x64@1.33.0:
+    optional: true
+
+  lightningcss-freebsd-x64@1.33.0:
+    optional: true
+
+  lightningcss-linux-arm-gnueabihf@1.33.0:
+    optional: true
+
+  lightningcss-linux-arm64-gnu@1.33.0:
+    optional: true
+
+  lightningcss-linux-arm64-musl@1.33.0:
+    optional: true
+
+  lightningcss-linux-x64-gnu@1.33.0:
+    optional: true
+
+  lightningcss-linux-x64-musl@1.33.0:
+    optional: true
+
+  lightningcss-win32-arm64-msvc@1.33.0:
+    optional: true
+
+  lightningcss-win32-x64-msvc@1.33.0:
+    optional: true
+
+  lightningcss@1.33.0:
+    dependencies:
+      detect-libc: 2.1.2
+    optionalDependencies:
+      lightningcss-android-arm64: 1.33.0
+      lightningcss-darwin-arm64: 1.33.0
+      lightningcss-darwin-x64: 1.33.0
+      lightningcss-freebsd-x64: 1.33.0
+      lightningcss-linux-arm-gnueabihf: 1.33.0
+      lightningcss-linux-arm64-gnu: 1.33.0
+      lightningcss-linux-arm64-musl: 1.33.0
+      lightningcss-linux-x64-gnu: 1.33.0
+      lightningcss-linux-x64-musl: 1.33.0
+      lightningcss-win32-arm64-msvc: 1.33.0
+      lightningcss-win32-x64-msvc: 1.33.0
+
+  linkifyjs@4.3.3: {}
+
+  locate-path@5.0.0:
+    dependencies:
+      p-locate: 4.1.0
+
+  lodash-es@4.18.1: {}
+
+  lodash@4.18.1: {}
+
+  loupe@3.2.1: {}
+
+  lru-cache@10.4.3: {}
+
+  lru-cache@5.1.1:
+    dependencies:
+      yallist: 3.1.1
+
+  magic-regexp@0.10.0:
+    dependencies:
+      estree-walker: 3.0.3
+      magic-string: 0.30.21
+      mlly: 1.8.2
+      regexp-tree: 0.1.27
+      type-level-regexp: 0.1.17
+      ufo: 1.6.4
+      unplugin: 2.3.11
+
+  magic-string@0.30.21:
+    dependencies:
+      '@jridgewell/sourcemap-codec': 1.5.5
+
+  magicast@0.3.5:
+    dependencies:
+      '@babel/parser': 7.29.8
+      '@babel/types': 7.29.8
+      source-map-js: 1.2.1
+
+  make-dir@4.0.0:
+    dependencies:
+      semver: 7.8.5
+
+  mdn-data@2.27.1: {}
+
+  memorystream@0.3.1: {}
+
+  mimic-response@3.1.0:
+    optional: true
+
+  minimatch@10.2.6:
+    dependencies:
+      brace-expansion: 5.0.9
+
+  minimatch@9.0.9:
+    dependencies:
+      brace-expansion: 2.1.4
+
+  minimist@1.2.8:
+    optional: true
+
+  minipass@7.1.3: {}
+
+  mkdirp-classic@0.5.3:
+    optional: true
+
+  mlly@1.8.2:
+    dependencies:
+      acorn: 8.18.0
+      pathe: 2.0.3
+      pkg-types: 1.3.1
+      ufo: 1.6.4
+
+  mrmime@2.0.1: {}
+
+  ms@2.1.3: {}
+
+  muggle-string@0.4.1: {}
+
+  mustache@4.2.0: {}
+
+  naive-ui@2.44.1(vue@3.5.41(typescript@6.0.3)):
+    dependencies:
+      '@css-render/plugin-bem': 0.15.14(css-render@0.15.14)
+      '@css-render/vue3-ssr': 0.15.14(vue@3.5.41(typescript@6.0.3))
+      '@types/lodash': 4.17.25
+      '@types/lodash-es': 4.17.12
+      async-validator: 4.2.5
+      css-render: 0.15.14
+      csstype: 3.2.3
+      date-fns: 4.4.0
+      date-fns-tz: 3.2.0(date-fns@4.4.0)
+      evtd: 0.2.4
+      highlight.js: 11.11.1
+      lodash: 4.18.1
+      lodash-es: 4.18.1
+      seemly: 0.3.10
+      treemate: 0.3.11
+      vdirs: 0.1.8(vue@3.5.41(typescript@6.0.3))
+      vooks: 0.2.12(vue@3.5.41(typescript@6.0.3))
+      vue: 3.5.41(typescript@6.0.3)
+      vueuc: 0.4.65(vue@3.5.41(typescript@6.0.3))
+
+  nanoid@3.3.17: {}
+
+  napi-build-utils@2.0.0:
+    optional: true
+
+  node-abi@3.94.0:
+    dependencies:
+      semver: 7.8.5
+    optional: true
+
+  node-addon-api@7.1.1:
+    optional: true
+
+  node-fetch-native@1.6.7: {}
+
+  node-releases@2.0.52: {}
+
+  nostics@1.2.0: {}
+
+  npm-normalize-package-bin@6.0.0: {}
+
+  npm-run-all2@9.0.3:
+    dependencies:
+      ansi-styles: 7.0.0
+      cross-spawn: 7.0.6
+      memorystream: 0.3.1
+      picomatch: 4.0.5
+      pidtree: 1.0.0
+      read-package-json-fast: 6.0.0
+      shell-quote: 1.10.0
+      which: 7.0.0
+
+  nwsapi@2.2.24:
+    optional: true
+
+  obug@2.1.4: {}
+
+  ofetch@1.5.1:
+    dependencies:
+      destr: 2.0.5
+      node-fetch-native: 1.6.7
+      ufo: 1.6.4
+
+  ohash@2.0.11: {}
+
+  once@1.4.0:
+    dependencies:
+      wrappy: 1.0.2
+    optional: true
+
+  open@11.0.0:
+    dependencies:
+      default-browser: 5.5.0
+      define-lazy-prop: 3.0.0
+      is-in-ssh: 1.0.0
+      is-inside-container: 1.0.0
+      powershell-utils: 0.1.0
+      wsl-utils: 0.3.1
+
+  opentype.js@2.0.0: {}
+
+  orderedmap@2.1.1: {}
+
+  oxc-parser@0.131.0:
+    dependencies:
+      '@oxc-project/types': 0.131.0
+    optionalDependencies:
+      '@oxc-parser/binding-android-arm-eabi': 0.131.0
+      '@oxc-parser/binding-android-arm64': 0.131.0
+      '@oxc-parser/binding-darwin-arm64': 0.131.0
+      '@oxc-parser/binding-darwin-x64': 0.131.0
+      '@oxc-parser/binding-freebsd-x64': 0.131.0
+      '@oxc-parser/binding-linux-arm-gnueabihf': 0.131.0
+      '@oxc-parser/binding-linux-arm-musleabihf': 0.131.0
+      '@oxc-parser/binding-linux-arm64-gnu': 0.131.0
+      '@oxc-parser/binding-linux-arm64-musl': 0.131.0
+      '@oxc-parser/binding-linux-ppc64-gnu': 0.131.0
+      '@oxc-parser/binding-linux-riscv64-gnu': 0.131.0
+      '@oxc-parser/binding-linux-riscv64-musl': 0.131.0
+      '@oxc-parser/binding-linux-s390x-gnu': 0.131.0
+      '@oxc-parser/binding-linux-x64-gnu': 0.131.0
+      '@oxc-parser/binding-linux-x64-musl': 0.131.0
+      '@oxc-parser/binding-openharmony-arm64': 0.131.0
+      '@oxc-parser/binding-wasm32-wasi': 0.131.0
+      '@oxc-parser/binding-win32-arm64-msvc': 0.131.0
+      '@oxc-parser/binding-win32-ia32-msvc': 0.131.0
+      '@oxc-parser/binding-win32-x64-msvc': 0.131.0
+
+  oxc-walker@0.7.0(oxc-parser@0.131.0):
+    dependencies:
+      magic-regexp: 0.10.0
+      oxc-parser: 0.131.0
+
+  p-limit@2.3.0:
+    dependencies:
+      p-try: 2.2.0
+
+  p-locate@4.1.0:
+    dependencies:
+      p-limit: 2.3.0
+
+  p-try@2.2.0: {}
+
+  package-json-from-dist@1.0.1: {}
+
+  package-manager-detector@1.8.0: {}
+
+  pako@2.2.0: {}
+
+  parse5@7.3.0:
+    dependencies:
+      entities: 6.0.1
+    optional: true
+
+  path-browserify@1.0.1: {}
+
+  path-exists@4.0.0: {}
+
+  path-key@3.1.1: {}
+
+  path-scurry@1.11.1:
+    dependencies:
+      lru-cache: 10.4.3
+      minipass: 7.1.3
+
+  pathe@2.0.3: {}
+
+  pathval@2.0.1: {}
+
+  perfect-debounce@2.1.0: {}
+
+  performance-now@2.1.0:
+    optional: true
+
+  picocolors@1.1.1: {}
+
+  picomatch@4.0.5: {}
+
+  pidtree@1.0.0: {}
+
+  pinia@4.0.2(@vue/devtools-api@8.2.1)(typescript@6.0.3)(vue@3.5.41(typescript@6.0.3)):
+    dependencies:
+      '@vue/devtools-api': 8.2.1
+      nostics: 1.2.0
+      vue: 3.5.41(typescript@6.0.3)
+    optionalDependencies:
+      typescript: 6.0.3
+
+  pkg-types@1.3.1:
+    dependencies:
+      confbox: 0.1.8
+      mlly: 1.8.2
+      pathe: 2.0.3
+
+  pngjs@5.0.0: {}
+
+  postcss@8.5.25:
+    dependencies:
+      nanoid: 3.3.17
+      picocolors: 1.1.1
+      source-map-js: 1.2.1
+
+  powershell-utils@0.1.0: {}
+
+  prebuild-install@7.1.3:
+    dependencies:
+      detect-libc: 2.1.2
+      expand-template: 2.0.3
+      github-from-package: 0.0.0
+      minimist: 1.2.8
+      mkdirp-classic: 0.5.3
+      napi-build-utils: 2.0.0
+      node-abi: 3.94.0
+      pump: 3.0.4
+      rc: 1.2.8
+      simple-get: 4.0.1
+      tar-fs: 2.1.5
+      tunnel-agent: 0.6.0
+    optional: true
+
+  prettier@3.9.5: {}
+
+  prosemirror-changeset@2.4.1:
+    dependencies:
+      prosemirror-transform: 1.12.0
+
+  prosemirror-commands@1.7.2:
+    dependencies:
+      prosemirror-model: 1.25.11
+      prosemirror-state: 1.4.4
+      prosemirror-transform: 1.12.0
+
+  prosemirror-dropcursor@1.8.3:
+    dependencies:
+      prosemirror-state: 1.4.4
+      prosemirror-transform: 1.12.0
+      prosemirror-view: 1.42.2
+
+  prosemirror-gapcursor@1.4.1:
+    dependencies:
+      prosemirror-keymap: 1.2.3
+      prosemirror-model: 1.25.11
+      prosemirror-state: 1.4.4
+      prosemirror-view: 1.42.2
+
+  prosemirror-history@1.5.0:
+    dependencies:
+      prosemirror-state: 1.4.4
+      prosemirror-transform: 1.12.0
+      prosemirror-view: 1.42.2
+      rope-sequence: 1.3.4
+
+  prosemirror-inputrules@1.5.1:
+    dependencies:
+      prosemirror-state: 1.4.4
+      prosemirror-transform: 1.12.0
+
+  prosemirror-keymap@1.2.3:
+    dependencies:
+      prosemirror-state: 1.4.4
+      w3c-keyname: 2.2.8
+
+  prosemirror-model@1.25.11:
+    dependencies:
+      orderedmap: 2.1.1
+
+  prosemirror-schema-list@1.5.1:
+    dependencies:
+      prosemirror-model: 1.25.11
+      prosemirror-state: 1.4.4
+      prosemirror-transform: 1.12.0
+
+  prosemirror-state@1.4.4:
+    dependencies:
+      prosemirror-model: 1.25.11
+      prosemirror-transform: 1.12.0
+      prosemirror-view: 1.42.2
+
+  prosemirror-tables@1.8.5:
+    dependencies:
+      prosemirror-keymap: 1.2.3
+      prosemirror-model: 1.25.11
+      prosemirror-state: 1.4.4
+      prosemirror-transform: 1.12.0
+      prosemirror-view: 1.42.2
+
+  prosemirror-transform@1.12.0:
+    dependencies:
+      prosemirror-model: 1.25.11
+
+  prosemirror-view@1.42.2:
+    dependencies:
+      prosemirror-model: 1.25.11
+      prosemirror-state: 1.4.4
+      prosemirror-transform: 1.12.0
+
+  pump@3.0.4:
+    dependencies:
+      end-of-stream: 1.4.5
+      once: 1.4.0
+    optional: true
+
+  punycode@2.3.1:
+    optional: true
+
+  qrcode@1.5.4:
+    dependencies:
+      dijkstrajs: 1.0.3
+      pngjs: 5.0.0
+      yargs: 15.4.1
+
+  quansync@1.0.0: {}
+
+  raf@3.4.1:
+    dependencies:
+      performance-now: 2.1.0
+    optional: true
+
+  rc@1.2.8:
+    dependencies:
+      deep-extend: 0.6.0
+      ini: 1.3.8
+      minimist: 1.2.8
+      strip-json-comments: 2.0.1
+    optional: true
+
+  read-package-json-fast@6.0.0:
+    dependencies:
+      json-parse-even-better-errors: 6.0.0
+      npm-normalize-package-bin: 6.0.0
+
+  readable-stream@3.6.2:
+    dependencies:
+      inherits: 2.0.4
+      string_decoder: 1.3.0
+      util-deprecate: 1.0.2
+    optional: true
+
+  readdirp@5.0.0: {}
+
+  regenerator-runtime@0.13.11:
+    optional: true
+
+  regexp-tree@0.1.27: {}
+
+  require-directory@2.1.1: {}
+
+  require-from-string@2.0.2: {}
+
+  require-main-filename@2.0.0: {}
+
+  rgbcolor@1.0.1:
+    optional: true
+
+  rolldown@1.2.3:
+    dependencies:
+      '@oxc-project/types': 0.143.0
+      '@rolldown/pluginutils': 1.0.1
+    optionalDependencies:
+      '@rolldown/binding-android-arm64': 1.2.3
+      '@rolldown/binding-darwin-arm64': 1.2.3
+      '@rolldown/binding-darwin-x64': 1.2.3
+      '@rolldown/binding-freebsd-x64': 1.2.3
+      '@rolldown/binding-linux-arm-gnueabihf': 1.2.3
+      '@rolldown/binding-linux-arm64-gnu': 1.2.3
+      '@rolldown/binding-linux-arm64-musl': 1.2.3
+      '@rolldown/binding-linux-ppc64-gnu': 1.2.3
+      '@rolldown/binding-linux-s390x-gnu': 1.2.3
+      '@rolldown/binding-linux-x64-gnu': 1.2.3
+      '@rolldown/binding-linux-x64-musl': 1.2.3
+      '@rolldown/binding-openharmony-arm64': 1.2.3
+      '@rolldown/binding-win32-arm64-msvc': 1.2.3
+      '@rolldown/binding-win32-x64-msvc': 1.2.3
+
+  rollup@4.62.4:
+    dependencies:
+      '@types/estree': 1.0.9
+    optionalDependencies:
+      '@napi-rs/lzma-linux-x64-gnu': 1.5.1
+      '@rollup/rollup-android-arm-eabi': 4.62.4
+      '@rollup/rollup-android-arm64': 4.62.4
+      '@rollup/rollup-darwin-arm64': 4.62.4
+      '@rollup/rollup-darwin-x64': 4.62.4
+      '@rollup/rollup-freebsd-arm64': 4.62.4
+      '@rollup/rollup-freebsd-x64': 4.62.4
+      '@rollup/rollup-linux-arm-gnueabihf': 4.62.4
+      '@rollup/rollup-linux-arm-musleabihf': 4.62.4
+      '@rollup/rollup-linux-arm64-gnu': 4.62.4
+      '@rollup/rollup-linux-arm64-musl': 4.62.4
+      '@rollup/rollup-linux-loong64-gnu': 4.62.4
+      '@rollup/rollup-linux-loong64-musl': 4.62.4
+      '@rollup/rollup-linux-ppc64-gnu': 4.62.4
+      '@rollup/rollup-linux-ppc64-musl': 4.62.4
+      '@rollup/rollup-linux-riscv64-gnu': 4.62.4
+      '@rollup/rollup-linux-riscv64-musl': 4.62.4
+      '@rollup/rollup-linux-s390x-gnu': 4.62.4
+      '@rollup/rollup-linux-x64-gnu': 4.62.4
+      '@rollup/rollup-linux-x64-musl': 4.62.4
+      '@rollup/rollup-openbsd-x64': 4.62.4
+      '@rollup/rollup-openharmony-arm64': 4.62.4
+      '@rollup/rollup-win32-arm64-msvc': 4.62.4
+      '@rollup/rollup-win32-ia32-msvc': 4.62.4
+      '@rollup/rollup-win32-x64-gnu': 4.62.4
+      '@rollup/rollup-win32-x64-msvc': 4.62.4
+      fsevents: 2.3.3
+
+  rope-sequence@1.3.4: {}
+
+  rrweb-cssom@0.8.0:
+    optional: true
+
+  run-applescript@7.1.0: {}
+
+  safe-buffer@5.2.1:
+    optional: true
+
+  safer-buffer@2.1.2:
+    optional: true
+
+  saxes@6.0.0:
+    dependencies:
+      xmlchars: 2.2.0
+    optional: true
+
+  seemly@0.3.10: {}
+
+  semver@6.3.1: {}
+
+  semver@7.8.5: {}
+
+  set-blocking@2.0.0: {}
+
+  shebang-command@2.0.0:
+    dependencies:
+      shebang-regex: 3.0.0
+
+  shebang-regex@3.0.0: {}
+
+  shell-quote@1.10.0: {}
+
+  siginfo@2.0.0: {}
+
+  signal-exit@4.1.0: {}
+
+  simple-concat@1.0.1:
+    optional: true
+
+  simple-get@4.0.1:
+    dependencies:
+      decompress-response: 6.0.0
+      once: 1.4.0
+      simple-concat: 1.0.1
+    optional: true
+
+  sirv@3.0.2:
+    dependencies:
+      '@polka/url': 1.0.0-next.29
+      mrmime: 2.0.1
+      totalist: 3.0.1
+
+  source-map-js@1.2.1: {}
+
+  specificity@0.4.1: {}
+
+  ssf@0.11.2:
+    dependencies:
+      frac: 1.1.2
+
+  stackback@0.0.2: {}
+
+  stackblur-canvas@2.7.0:
+    optional: true
+
+  std-env@3.10.0: {}
+
+  string-width@4.2.3:
+    dependencies:
+      emoji-regex: 8.0.0
+      is-fullwidth-code-point: 3.0.0
+      strip-ansi: 6.0.1
+
+  string-width@5.1.2:
+    dependencies:
+      eastasianwidth: 0.2.0
+      emoji-regex: 9.2.2
+      strip-ansi: 7.2.0
+
+  string_decoder@1.3.0:
+    dependencies:
+      safe-buffer: 5.2.1
+    optional: true
+
+  strip-ansi@6.0.1:
+    dependencies:
+      ansi-regex: 5.0.1
+
+  strip-ansi@7.2.0:
+    dependencies:
+      ansi-regex: 6.2.2
+
+  strip-json-comments@2.0.1:
+    optional: true
+
+  strip-literal@3.1.0:
+    dependencies:
+      js-tokens: 9.0.1
+
+  style-mod@4.1.3: {}
+
+  stylis@4.4.0: {}
+
+  supports-color@7.2.0:
+    dependencies:
+      has-flag: 4.0.0
+
+  svg-pathdata@6.0.3:
+    optional: true
+
+  svg2pdf.js@2.7.0(jspdf@4.2.1):
+    dependencies:
+      cssesc: 3.0.0
+      font-family-papandreou: 0.2.0-patch2
+      jspdf: 4.2.1
+      specificity: 0.4.1
+      svgpath: 2.6.0
+
+  svgpath@2.6.0: {}
+
+  symbol-tree@3.2.4:
+    optional: true
+
+  tar-fs@2.1.5:
+    dependencies:
+      chownr: 1.1.4
+      mkdirp-classic: 0.5.3
+      pump: 3.0.4
+      tar-stream: 2.2.0
+    optional: true
+
+  tar-stream@2.2.0:
+    dependencies:
+      bl: 4.1.0
+      end-of-stream: 1.4.5
+      fs-constants: 1.0.0
+      inherits: 2.0.4
+      readable-stream: 3.6.2
+    optional: true
+
+  test-exclude@7.0.2:
+    dependencies:
+      '@istanbuljs/schema': 0.1.6
+      glob: 10.5.0
+      minimatch: 10.2.6
+
+  text-segmentation@1.0.3:
+    dependencies:
+      utrie: 1.0.2
+    optional: true
+
+  tinybench@2.9.0: {}
+
+  tinyexec@0.3.2: {}
+
+  tinyexec@1.3.0: {}
+
+  tinyglobby@0.2.17:
+    dependencies:
+      fdir: 6.5.0(picomatch@4.0.5)
+      picomatch: 4.0.5
+
+  tinypool@1.1.1: {}
+
+  tinyrainbow@2.0.0: {}
+
+  tinyspy@4.0.4: {}
+
+  tldts-core@6.1.86:
+    optional: true
+
+  tldts@6.1.86:
+    dependencies:
+      tldts-core: 6.1.86
+    optional: true
+
+  totalist@3.0.1: {}
+
+  tough-cookie@5.1.2:
+    dependencies:
+      tldts: 6.1.86
+    optional: true
+
+  tr46@5.1.1:
+    dependencies:
+      punycode: 2.3.1
+    optional: true
+
+  treemate@0.3.11: {}
+
+  ts-algebra@2.0.0: {}
+
+  tslib@2.8.1:
+    optional: true
+
+  tunnel-agent@0.6.0:
+    dependencies:
+      safe-buffer: 5.2.1
+    optional: true
+
+  type-level-regexp@0.1.17: {}
+
+  typescript@6.0.3: {}
+
+  ufo@1.6.4: {}
+
+  unconfig-core@7.5.0:
+    dependencies:
+      '@quansync/fs': 1.0.0
+      quansync: 1.0.0
+
+  unconfig@7.5.0:
+    dependencies:
+      '@quansync/fs': 1.0.0
+      defu: 6.1.7
+      jiti: 2.7.0
+      quansync: 1.0.0
+      unconfig-core: 7.5.0
+
+  undici-types@7.18.2: {}
+
+  unocss@66.7.5(vite@8.2.0(@types/node@24.13.3)(esbuild@0.28.2)(jiti@2.7.0)(yaml@2.9.0)):
+    dependencies:
+      '@unocss/cli': 66.7.5
+      '@unocss/core': 66.7.5
+      '@unocss/preset-attributify': 66.7.5
+      '@unocss/preset-icons': 66.7.5
+      '@unocss/preset-mini': 66.7.5
+      '@unocss/preset-tagify': 66.7.5
+      '@unocss/preset-typography': 66.7.5
+      '@unocss/preset-uno': 66.7.5
+      '@unocss/preset-web-fonts': 66.7.5
+      '@unocss/preset-wind': 66.7.5
+      '@unocss/preset-wind3': 66.7.5
+      '@unocss/preset-wind4': 66.7.5
+      '@unocss/transformer-attributify-jsx': 66.7.5
+      '@unocss/transformer-compile-class': 66.7.5
+      '@unocss/transformer-directives': 66.7.5
+      '@unocss/transformer-variant-group': 66.7.5
+      '@unocss/vite': 66.7.5(vite@8.2.0(@types/node@24.13.3)(esbuild@0.28.2)(jiti@2.7.0)(yaml@2.9.0))
+    transitivePeerDependencies:
+      - vite
+
+  unplugin-utils@0.3.2:
+    dependencies:
+      pathe: 2.0.3
+      picomatch: 4.0.5
+
+  unplugin@2.3.11:
+    dependencies:
+      '@jridgewell/remapping': 2.3.5
+      acorn: 8.18.0
+      picomatch: 4.0.5
+      webpack-virtual-modules: 0.6.2
+
+  update-browserslist-db@1.2.3(browserslist@4.28.7):
+    dependencies:
+      browserslist: 4.28.7
+      escalade: 3.2.0
+      picocolors: 1.1.1
+
+  util-deprecate@1.0.2:
+    optional: true
+
+  utrie@1.0.2:
+    dependencies:
+      base64-arraybuffer: 1.0.2
+    optional: true
+
+  vdirs@0.1.8(vue@3.5.41(typescript@6.0.3)):
+    dependencies:
+      evtd: 0.2.4
+      vue: 3.5.41(typescript@6.0.3)
+
+  vite-dev-rpc@2.0.0(vite@8.2.0(@types/node@24.13.3)(esbuild@0.28.2)(jiti@2.7.0)(yaml@2.9.0)):
+    dependencies:
+      birpc: 4.0.0
+      vite: 8.2.0(@types/node@24.13.3)(esbuild@0.28.2)(jiti@2.7.0)(yaml@2.9.0)
+      vite-hot-client: 2.2.0(vite@8.2.0(@types/node@24.13.3)(esbuild@0.28.2)(jiti@2.7.0)(yaml@2.9.0))
+
+  vite-hot-client@2.2.0(vite@8.2.0(@types/node@24.13.3)(esbuild@0.28.2)(jiti@2.7.0)(yaml@2.9.0)):
+    dependencies:
+      vite: 8.2.0(@types/node@24.13.3)(esbuild@0.28.2)(jiti@2.7.0)(yaml@2.9.0)
+
+  vite-node@3.2.4(@types/node@24.13.3)(jiti@2.7.0)(lightningcss@1.33.0)(yaml@2.9.0):
+    dependencies:
+      cac: 6.7.14
+      debug: 4.4.3
+      es-module-lexer: 1.7.0
+      pathe: 2.0.3
+      vite: 7.3.6(@types/node@24.13.3)(jiti@2.7.0)(lightningcss@1.33.0)(yaml@2.9.0)
+    transitivePeerDependencies:
+      - '@types/node'
+      - jiti
+      - less
+      - lightningcss
+      - sass
+      - sass-embedded
+      - stylus
+      - sugarss
+      - supports-color
+      - terser
+      - tsx
+      - yaml
+
+  vite-plugin-inspect@11.4.1(vite@8.2.0(@types/node@24.13.3)(esbuild@0.28.2)(jiti@2.7.0)(yaml@2.9.0)):
+    dependencies:
+      ansis: 4.3.1
+      error-stack-parser-es: 1.0.5
+      obug: 2.1.4
+      ohash: 2.0.11
+      open: 11.0.0
+      perfect-debounce: 2.1.0
+      sirv: 3.0.2
+      unplugin-utils: 0.3.2
+      vite: 8.2.0(@types/node@24.13.3)(esbuild@0.28.2)(jiti@2.7.0)(yaml@2.9.0)
+      vite-dev-rpc: 2.0.0(vite@8.2.0(@types/node@24.13.3)(esbuild@0.28.2)(jiti@2.7.0)(yaml@2.9.0))
+
+  vite-plugin-vue-devtools@8.2.1(vite@8.2.0(@types/node@24.13.3)(esbuild@0.28.2)(jiti@2.7.0)(yaml@2.9.0))(vue@3.5.41(typescript@6.0.3)):
+    dependencies:
+      '@vue/devtools-core': 8.2.1(vue@3.5.41(typescript@6.0.3))
+      '@vue/devtools-kit': 8.2.1
+      '@vue/devtools-shared': 8.2.1
+      sirv: 3.0.2
+      vite: 8.2.0(@types/node@24.13.3)(esbuild@0.28.2)(jiti@2.7.0)(yaml@2.9.0)
+      vite-plugin-inspect: 11.4.1(vite@8.2.0(@types/node@24.13.3)(esbuild@0.28.2)(jiti@2.7.0)(yaml@2.9.0))
+      vite-plugin-vue-inspector: 6.0.0(vite@8.2.0(@types/node@24.13.3)(esbuild@0.28.2)(jiti@2.7.0)(yaml@2.9.0))
+    transitivePeerDependencies:
+      - '@nuxt/kit'
+      - supports-color
+      - vue
+
+  vite-plugin-vue-inspector@6.0.0(vite@8.2.0(@types/node@24.13.3)(esbuild@0.28.2)(jiti@2.7.0)(yaml@2.9.0)):
+    dependencies:
+      '@babel/core': 7.29.7
+      '@babel/plugin-proposal-decorators': 7.29.7(@babel/core@7.29.7)
+      '@babel/plugin-syntax-import-attributes': 7.29.7(@babel/core@7.29.7)
+      '@babel/plugin-syntax-import-meta': 7.10.4(@babel/core@7.29.7)
+      '@babel/plugin-transform-typescript': 7.29.7(@babel/core@7.29.7)
+      '@vue/babel-plugin-jsx': 1.5.0(@babel/core@7.29.7)
+      '@vue/compiler-dom': 3.5.41
+      kolorist: 1.8.0
+      magic-string: 0.30.21
+      vite: 8.2.0(@types/node@24.13.3)(esbuild@0.28.2)(jiti@2.7.0)(yaml@2.9.0)
+    transitivePeerDependencies:
+      - supports-color
+
+  vite@7.3.6(@types/node@24.13.3)(jiti@2.7.0)(lightningcss@1.33.0)(yaml@2.9.0):
+    dependencies:
+      esbuild: 0.28.2
+      fdir: 6.5.0(picomatch@4.0.5)
+      picomatch: 4.0.5
+      postcss: 8.5.25
+      rollup: 4.62.4
+      tinyglobby: 0.2.17
+    optionalDependencies:
+      '@types/node': 24.13.3
+      fsevents: 2.3.3
+      jiti: 2.7.0
+      lightningcss: 1.33.0
+      yaml: 2.9.0
+
+  vite@8.2.0(@types/node@24.13.3)(esbuild@0.28.2)(jiti@2.7.0)(yaml@2.9.0):
+    dependencies:
+      lightningcss: 1.33.0
+      picomatch: 4.0.5
+      postcss: 8.5.25
+      rolldown: 1.2.3
+      tinyglobby: 0.2.17
+    optionalDependencies:
+      '@types/node': 24.13.3
+      esbuild: 0.28.2
+      fsevents: 2.3.3
+      jiti: 2.7.0
+      yaml: 2.9.0
+
+  vitest@3.2.7(@types/node@24.13.3)(happy-dom@20.11.2)(jiti@2.7.0)(jsdom@26.1.0(canvas@3.2.3))(lightningcss@1.33.0)(yaml@2.9.0):
+    dependencies:
+      '@types/chai': 5.2.3
+      '@vitest/expect': 3.2.7
+      '@vitest/mocker': 3.2.7(vite@7.3.6(@types/node@24.13.3)(jiti@2.7.0)(lightningcss@1.33.0)(yaml@2.9.0))
+      '@vitest/pretty-format': 3.2.7
+      '@vitest/runner': 3.2.7
+      '@vitest/snapshot': 3.2.7
+      '@vitest/spy': 3.2.7
+      '@vitest/utils': 3.2.7
+      chai: 5.3.3
+      debug: 4.4.3
+      expect-type: 1.4.0
+      magic-string: 0.30.21
+      pathe: 2.0.3
+      picomatch: 4.0.5
+      std-env: 3.10.0
+      tinybench: 2.9.0
+      tinyexec: 0.3.2
+      tinyglobby: 0.2.17
+      tinypool: 1.1.1
+      tinyrainbow: 2.0.0
+      vite: 7.3.6(@types/node@24.13.3)(jiti@2.7.0)(lightningcss@1.33.0)(yaml@2.9.0)
+      vite-node: 3.2.4(@types/node@24.13.3)(jiti@2.7.0)(lightningcss@1.33.0)(yaml@2.9.0)
+      why-is-node-running: 2.3.0
+    optionalDependencies:
+      '@types/node': 24.13.3
+      happy-dom: 20.11.2
+      jsdom: 26.1.0(canvas@3.2.3)
+    transitivePeerDependencies:
+      - jiti
+      - less
+      - lightningcss
+      - msw
+      - sass
+      - sass-embedded
+      - stylus
+      - sugarss
+      - supports-color
+      - terser
+      - tsx
+      - yaml
+
+  vooks@0.2.12(vue@3.5.41(typescript@6.0.3)):
+    dependencies:
+      evtd: 0.2.4
+      vue: 3.5.41(typescript@6.0.3)
+
+  vscode-uri@3.1.0: {}
+
+  vue-codemirror6@1.6.1(@codemirror/autocomplete@6.20.3)(@codemirror/commands@6.10.4)(@codemirror/language@6.12.4)(@codemirror/lint@6.9.7)(@codemirror/search@6.7.1)(@codemirror/state@6.7.1)(@codemirror/view@6.43.8)(codemirror@6.0.2)(style-mod@4.1.3)(vue@3.5.41(typescript@6.0.3)):
+    dependencies:
+      '@codemirror/autocomplete': 6.20.3
+      '@codemirror/commands': 6.10.4
+      '@codemirror/language': 6.12.4
+      '@codemirror/lint': 6.9.7
+      '@codemirror/search': 6.7.1
+      '@codemirror/state': 6.7.1
+      '@codemirror/view': 6.43.8
+      codemirror: 6.0.2
+      style-mod: 4.1.3
+      vue: 3.5.41(typescript@6.0.3)
+      vue-demi: 0.14.10(vue@3.5.41(typescript@6.0.3))
+    transitivePeerDependencies:
+      - '@vue/composition-api'
+
+  vue-demi@0.14.10(vue@3.5.41(typescript@6.0.3)):
+    dependencies:
+      vue: 3.5.41(typescript@6.0.3)
+
+  vue-tsc@3.3.9(typescript@6.0.3):
+    dependencies:
+      '@volar/typescript': 2.4.28
+      '@vue/language-core': 3.3.9
+      typescript: 6.0.3
+
+  vue@3.5.41(typescript@6.0.3):
+    dependencies:
+      '@vue/compiler-dom': 3.5.41
+      '@vue/compiler-sfc': 3.5.41
+      '@vue/runtime-dom': 3.5.41
+      '@vue/server-renderer': 3.5.41
+      '@vue/shared': 3.5.41
+    optionalDependencies:
+      typescript: 6.0.3
+
+  vueuc@0.4.65(vue@3.5.41(typescript@6.0.3)):
+    dependencies:
+      '@css-render/vue3-ssr': 0.15.14(vue@3.5.41(typescript@6.0.3))
+      '@juggle/resize-observer': 3.4.0
+      css-render: 0.15.14
+      evtd: 0.2.4
+      seemly: 0.3.10
+      vdirs: 0.1.8(vue@3.5.41(typescript@6.0.3))
+      vooks: 0.2.12(vue@3.5.41(typescript@6.0.3))
+      vue: 3.5.41(typescript@6.0.3)
+
+  w3c-keyname@2.2.8: {}
+
+  w3c-xmlserializer@5.0.0:
+    dependencies:
+      xml-name-validator: 5.0.0
+    optional: true
+
+  webidl-conversions@7.0.0:
+    optional: true
+
+  webpack-virtual-modules@0.6.2: {}
+
+  whatwg-encoding@3.1.1:
+    dependencies:
+      iconv-lite: 0.6.3
+    optional: true
+
+  whatwg-mimetype@3.0.0: {}
+
+  whatwg-mimetype@4.0.0:
+    optional: true
+
+  whatwg-url@14.2.0:
+    dependencies:
+      tr46: 5.1.1
+      webidl-conversions: 7.0.0
+    optional: true
+
+  which-module@2.0.1: {}
+
+  which@2.0.2:
+    dependencies:
+      isexe: 2.0.0
+
+  which@7.0.0:
+    dependencies:
+      isexe: 4.0.0
+
+  why-is-node-running@2.3.0:
+    dependencies:
+      siginfo: 2.0.0
+      stackback: 0.0.2
+
+  wmf@1.0.2: {}
+
+  word@0.3.0: {}
+
+  wrap-ansi@6.2.0:
+    dependencies:
+      ansi-styles: 4.3.0
+      string-width: 4.2.3
+      strip-ansi: 6.0.1
+
+  wrap-ansi@7.0.0:
+    dependencies:
+      ansi-styles: 4.3.0
+      string-width: 4.2.3
+      strip-ansi: 6.0.1
+
+  wrap-ansi@8.1.0:
+    dependencies:
+      ansi-styles: 6.2.3
+      string-width: 5.1.2
+      strip-ansi: 7.2.0
+
+  wrappy@1.0.2:
+    optional: true
+
+  ws@8.21.2: {}
+
+  wsl-utils@0.3.1:
+    dependencies:
+      is-wsl: 3.1.1
+      powershell-utils: 0.1.0
+
+  xlsx@0.18.5:
+    dependencies:
+      adler-32: 1.3.1
+      cfb: 1.2.2
+      codepage: 1.15.0
+      crc-32: 1.2.2
+      ssf: 0.11.2
+      wmf: 1.0.2
+      word: 0.3.0
+
+  xml-name-validator@5.0.0:
+    optional: true
+
+  xmlchars@2.2.0:
+    optional: true
+
+  y18n@4.0.3: {}
+
+  yallist@3.1.1: {}
+
+  yaml@2.9.0:
+    optional: true
+
+  yargs-parser@18.1.3:
+    dependencies:
+      camelcase: 5.3.1
+      decamelize: 1.2.0
+
+  yargs@15.4.1:
+    dependencies:
+      cliui: 6.0.0
+      decamelize: 1.2.0
+      find-up: 4.1.0
+      get-caller-file: 2.0.5
+      require-directory: 2.1.1
+      require-main-filename: 2.0.0
+      set-blocking: 2.0.0
+      string-width: 4.2.3
+      which-module: 2.0.1
+      y18n: 4.0.3
+      yargs-parser: 18.1.3
diff --git a/openprint/pnpm-workspace.yaml b/openprint/pnpm-workspace.yaml
new file mode 100644
index 0000000..1417f8a
--- /dev/null
+++ b/openprint/pnpm-workspace.yaml
@@ -0,0 +1,4 @@
+onlyBuiltDependencies:
+  - canvas
+  - core-js
+  - vue-demi
diff --git a/openprint/public/favicon.ico b/openprint/public/favicon.ico
new file mode 100644
index 0000000..41bdade
Binary files /dev/null and b/openprint/public/favicon.ico differ
diff --git a/openprint/public/fonts/ChillKai.woff2 b/openprint/public/fonts/ChillKai.woff2
new file mode 100644
index 0000000..40d6f8d
Binary files /dev/null and b/openprint/public/fonts/ChillKai.woff2 differ
diff --git a/openprint/public/fonts/HedvigLettersSans-Regular.woff2 b/openprint/public/fonts/HedvigLettersSans-Regular.woff2
new file mode 100644
index 0000000..9e589e6
Binary files /dev/null and b/openprint/public/fonts/HedvigLettersSans-Regular.woff2 differ
diff --git a/openprint/public/fonts/LiberationSerif-Bold.woff2 b/openprint/public/fonts/LiberationSerif-Bold.woff2
new file mode 100644
index 0000000..067d104
Binary files /dev/null and b/openprint/public/fonts/LiberationSerif-Bold.woff2 differ
diff --git a/openprint/public/fonts/LiberationSerif-Italic.woff2 b/openprint/public/fonts/LiberationSerif-Italic.woff2
new file mode 100644
index 0000000..4993810
Binary files /dev/null and b/openprint/public/fonts/LiberationSerif-Italic.woff2 differ
diff --git a/openprint/public/fonts/LiberationSerif-Regular.woff2 b/openprint/public/fonts/LiberationSerif-Regular.woff2
new file mode 100644
index 0000000..0bdbc23
Binary files /dev/null and b/openprint/public/fonts/LiberationSerif-Regular.woff2 differ
diff --git a/openprint/public/fonts/SourceHanSansCN-Normal.woff2 b/openprint/public/fonts/SourceHanSansCN-Normal.woff2
new file mode 100644
index 0000000..682b928
Binary files /dev/null and b/openprint/public/fonts/SourceHanSansCN-Normal.woff2 differ
diff --git a/openprint/public/fonts/SourceHanSerifCN-Regular.ttf b/openprint/public/fonts/SourceHanSerifCN-Regular.ttf
new file mode 100644
index 0000000..b5a828d
Binary files /dev/null and b/openprint/public/fonts/SourceHanSerifCN-Regular.ttf differ
diff --git a/openprint/screenshots/README.md b/openprint/screenshots/README.md
new file mode 100644
index 0000000..4d6d6df
--- /dev/null
+++ b/openprint/screenshots/README.md
@@ -0,0 +1,12 @@
+# 截图素材
+
+将以下截图文件放入此目录，替换 README 中的配图：
+
+| 文件 | 说明 | 建议尺寸 |
+|------|------|----------|
+| `designer-overview.png` | 设计器界面全貌，展示控件库 + 画布 + 属性面板 | 1920×1080 |
+| `ai-assistant.png` | AI 助手聊天窗口 + 生成的面单模板 | 1200×800 |
+| `cloud-print.png` | 云打印架构拓扑图 | 1200×800 |
+| `report-design.png` | 报表设计效果（表格 + 图表） | 1200×800 |
+| `desktop-client.png` | C++ Qt 桌面客户端界面 | 1200×800 |
+| `erp-integration.png` | ERP 对接流程示意图 | 1200×800 |
\ No newline at end of file
diff --git a/openprint/screenshots/ai-assistant.png b/openprint/screenshots/ai-assistant.png
new file mode 100644
index 0000000..ef87363
Binary files /dev/null and b/openprint/screenshots/ai-assistant.png differ
diff --git a/openprint/screenshots/cloud-print.jpg b/openprint/screenshots/cloud-print.jpg
new file mode 100644
index 0000000..9b739ab
Binary files /dev/null and b/openprint/screenshots/cloud-print.jpg differ
diff --git a/openprint/screenshots/designer-overview.png b/openprint/screenshots/designer-overview.png
new file mode 100644
index 0000000..e5f0d62
Binary files /dev/null and b/openprint/screenshots/designer-overview.png differ
diff --git a/openprint/screenshots/desktop-client.jpg b/openprint/screenshots/desktop-client.jpg
new file mode 100644
index 0000000..ad07a3a
Binary files /dev/null and b/openprint/screenshots/desktop-client.jpg differ
diff --git a/openprint/screenshots/erp-integration.jpg b/openprint/screenshots/erp-integration.jpg
new file mode 100644
index 0000000..9704b23
Binary files /dev/null and b/openprint/screenshots/erp-integration.jpg differ
diff --git a/openprint/screenshots/logo.png b/openprint/screenshots/logo.png
new file mode 100644
index 0000000..243b966
Binary files /dev/null and b/openprint/screenshots/logo.png differ
diff --git a/openprint/screenshots/report-design.png b/openprint/screenshots/report-design.png
new file mode 100644
index 0000000..38ba268
Binary files /dev/null and b/openprint/screenshots/report-design.png differ
diff --git a/openprint/src/App.vue b/openprint/src/App.vue
new file mode 100644
index 0000000..be71e3a
--- /dev/null
+++ b/openprint/src/App.vue
@@ -0,0 +1,60 @@
+<script setup lang="ts">
+/**
+ * App —— 顶层三栏布局壳（《实施指南》§5.5 + UI 参考图）
+ * 深/亮双主题：
+ *   - NConfigProvider.theme = light ? null : darkTheme
+ *   - NConfigProvider.themeOverrides = lightThemeOverrides / darkThemeOverrides
+ *   - NGlobalStyle 同步 common.bodyColor / textColor 到 document.body
+ *   - html.dark 类由 ui store 负责同步（主题闭环：ui store = 唯一真相源）
+ */
+import { computed } from 'vue'
+import { NConfigProvider, NDialogProvider, NGlobalStyle, NMessageProvider, darkTheme, zhCN, dateZhCN } from 'naive-ui'
+import TopToolbar from '@/design/toolbar/TopToolbar.vue'
+import LeftPanel from '@/design/panels/LeftPanel.vue'
+import RightPanel from '@/design/panels/RightPanel.vue'
+import CanvasStage from '@/design/canvas/CanvasStage.vue'
+import { useUiStore } from '@/design/stores/ui'
+import { darkThemeOverrides, lightThemeOverrides } from '@/theme/naive-theme'
+
+const uiStore = useUiStore()
+
+const isDark = computed(() => uiStore.effectiveTheme === 'dark')
+const naiveTheme = computed(() => (isDark.value ? darkTheme : null))
+const themeOverrides = computed(() => (isDark.value ? darkThemeOverrides : lightThemeOverrides))
+</script>
+
+<template>
+  <NConfigProvider :theme="naiveTheme" :theme-overrides="themeOverrides" :locale="zhCN" :date-locale="dateZhCN">
+    <NGlobalStyle />
+    <NMessageProvider>
+      <NDialogProvider>
+        <div class="flex h-full flex-col">
+          <TopToolbar />
+
+          <div class="flex min-h-0 flex-1">
+            <!-- 左侧组件库面板（组件/数据源/图层 三 tab 自含，无需额外侧边导航栏） -->
+            <aside class="w-250px flex-shrink-0 border-r border-brand-border bg-brand-surface">
+              <LeftPanel />
+            </aside>
+
+            <!-- 中央画布 -->
+            <main class="min-w-0 flex-1 bg-brand-bg">
+              <CanvasStage />
+            </main>
+
+            <!-- 右侧属性面板 -->
+            <aside
+              v-if="uiStore.rightPanelVisible"
+              class="w-300px flex-shrink-0 border-l border-brand-border bg-brand-surface"
+            >
+              <RightPanel />
+            </aside>
+          </div>
+        </div>
+      </NDialogProvider>
+    </NMessageProvider>
+  </NConfigProvider>
+</template>
+
+<style scoped>
+</style>
diff --git a/openprint/src/ai/ai.spec.ts b/openprint/src/ai/ai.spec.ts
new file mode 100644
index 0000000..b8d9a38
--- /dev/null
+++ b/openprint/src/ai/ai.spec.ts
@@ -0,0 +1,113 @@
+import { describe, it, expect } from 'vitest'
+import { extractJson } from './generate'
+import { normalizeTemplate } from './normalize'
+import { validateTemplate } from '@/core/spec/validator'
+
+describe('AI 核心：JSON 提取', () => {
+  it('从 ```json 代码块提取', () => {
+    const text = '说明一下：\n```json\n{"version":"1.0.0","document":{"type":"report"}}\n```'
+    const r = extractJson(text) as Record<string, unknown>
+    expect(r.version).toBe('1.0.0')
+  })
+
+  it('从纯 JSON 提取', () => {
+    const r = extractJson('{"a":1}') as Record<string, unknown>
+    expect(r.a).toBe(1)
+  })
+
+  it('从夹带散文的文本中提取首尾花括号', () => {
+    const text = '好的，这是模板：{"document":{"type":"report","sections":[{"type":"body","components":[]}]}} 请查收'
+    const r = extractJson(text) as Record<string, unknown>
+    expect((r.document as Record<string, unknown>).type).toBe('report')
+  })
+
+  it('无 JSON 返回 null', () => {
+    expect(extractJson('没有模板')).toBeNull()
+  })
+})
+
+describe('AI 核心：归一化 + 协议校验', () => {
+  it('补齐缺省字段并产出可通过校验的模板', () => {
+    const raw = {
+      document: {
+        page: { width: 100, height: 150, orientation: 'portrait' },
+        sections: [
+          {
+            type: 'body',
+            components: [
+              { type: 'text', left: 0, top: 0, width: 84, height: 12, value: '标题' },
+            ],
+          },
+        ],
+      },
+    }
+    const tpl = normalizeTemplate(raw)
+    expect(tpl.version).toBe('1.0.0')
+    expect(tpl.document.type).toBe('report')
+    // 缺省 unit 应为 mm，margin 应有默认值
+    expect(tpl.document.page.unit).toBe('mm')
+    expect(tpl.document.page.margin.top).toBeGreaterThanOrEqual(0)
+    // 控件被自动补 id
+    const body = tpl.document.sections.find((s) => s.type === 'body')!
+    expect(body.components![0]!.id).toBeTruthy()
+
+    const result = validateTemplate(tpl)
+    expect(result.valid).toBe(true)
+  })
+
+  it('横向页（width>height）推导 orientation', () => {
+    const tpl = normalizeTemplate({
+      document: {
+        page: { width: 297, height: 210 },
+        sections: [{ type: 'body', components: [] }],
+      },
+    })
+    expect(tpl.document.page.orientation).toBe('landscape')
+  })
+
+  it('坐标纠偏：page-origin 输出被还原为 content-relative', () => {
+    const raw = {
+      document: {
+        page: { width: 100, height: 150, margin: { top: 8, bottom: 8, left: 8, right: 8 } },
+        sections: [
+          {
+            type: 'body',
+            components: [
+              { type: 'text', left: 8, top: 8, width: 84, height: 12, value: '标题' },
+              { type: 'text', left: 8, top: 30, width: 84, height: 8, value: '正文' },
+            ],
+          },
+        ],
+      },
+    }
+    const tpl = normalizeTemplate(raw)
+    const body = tpl.document.sections.find((s) => s.type === 'body')!
+    // 双轴最小坐标命中 margin(8) → 统一减去页边距，消除整页右移
+    expect(body.components![0]!.left).toBe(0)
+    expect(body.components![0]!.top).toBe(0)
+    expect(body.components![1]!.top).toBeCloseTo(22, 6)
+    const result = validateTemplate(tpl)
+    expect(result.valid).toBe(true)
+  })
+
+  it('坐标纠偏：正确 content-relative 模板不应被误伤', () => {
+    const raw = {
+      document: {
+        page: { width: 100, height: 150, margin: { top: 8, bottom: 8, left: 8, right: 8 } },
+        sections: [
+          {
+            type: 'body',
+            components: [
+              { type: 'text', left: 0, top: 0, width: 84, height: 12, value: '标题' },
+              { type: 'text', left: 10, top: 20, width: 74, height: 8, value: '正文' },
+            ],
+          },
+        ],
+      },
+    }
+    const tpl = normalizeTemplate(raw)
+    const body = tpl.document.sections.find((s) => s.type === 'body')!
+    expect(body.components![0]!.left).toBe(0)
+    expect(body.components![1]!.left).toBe(10) // 保持原值，未被偏移
+  })
+})
diff --git a/openprint/src/ai/client.ts b/openprint/src/ai/client.ts
new file mode 100644
index 0000000..ad5ddd5
--- /dev/null
+++ b/openprint/src/ai/client.ts
@@ -0,0 +1,150 @@
+/**
+ * AI 客户端 —— 纯前端直连 OpenAI 兼容 /chat/completions（SSE 流式）。
+ * 不依赖任何后端；baseURL / apiKey / model 全部由用户在前端设置里提供。
+ */
+
+export interface ChatMessage {
+  role: 'system' | 'user' | 'assistant'
+  content: string
+}
+
+export interface StreamOptions {
+  baseURL: string
+  apiKey: string
+  model: string
+  messages: ChatMessage[]
+  onToken: (delta: string) => void
+  signal?: AbortSignal
+}
+
+/** LLM 调用错误（携带 HTTP 状态码，便于前端给出友好提示） */
+export class AiRequestError extends Error {
+  status: number
+  constructor(status: number, message: string) {
+    super(message)
+    this.name = 'AiRequestError'
+    this.status = status
+  }
+}
+
+function friendlyError(status: number, body: string): string {
+  if (status === 401) return 'API Key 无效或已过期，请检查设置中的 Key。'
+  if (status === 404) return '接口地址不正确（请确认 baseURL 含 /v1 且路径为 /chat/completions）。'
+  if (status === 429) return '请求过于频繁或额度不足（429）。'
+  if (status >= 500) return `模型服务异常（HTTP ${status}）。`
+  // 跨域 / 网络层：fetch 抛 TypeError，没有 status
+  const lower = body.toLowerCase()
+  if (lower.includes('cors') || lower.includes('cross-origin')) {
+    return '跨域(CORS)被拦截：浏览器直连该地址受限。可将 baseURL 改为你自己的代理（如 Cloudflare Worker / Vercel Edge），或在支持浏览器直连的模型服务上使用。'
+  }
+  return body ? `请求失败（HTTP ${status}）：${body.slice(0, 200)}` : `请求失败（HTTP ${status}）`
+}
+
+/**
+ * 流式对话（SSE）。逐 token 回调 onToken，最终返回完整文本。
+ * 兼容 OpenAI / DeepSeek / 通义 等 OpenAI 格式（data: {choices:[{delta:{content}}]}）。
+ */
+export async function streamChat(opts: StreamOptions): Promise<string> {
+  const url = `${opts.baseURL.replace(/\/+$/, '')}/chat/completions`
+
+  let res: Response
+  try {
+    res = await fetch(url, {
+      method: 'POST',
+      headers: {
+        'Content-Type': 'application/json',
+        Authorization: `Bearer ${opts.apiKey}`,
+      },
+      body: JSON.stringify({
+        model: opts.model,
+        messages: opts.messages,
+        stream: true,
+        temperature: 0.6,
+      }),
+      signal: opts.signal,
+    })
+  } catch (e) {
+    // 网络层错误（含 CORS）：fetch 抛 TypeError，无 status
+    const reason = e instanceof Error ? e.message : String(e)
+    if (reason.toLowerCase().includes('cors') || reason.toLowerCase().includes('cross-origin')) {
+      throw new AiRequestError(
+        0,
+        '跨域(CORS)被拦截：浏览器直连该地址受限。可将 baseURL 改为你自己的代理（如 Cloudflare Worker / Vercel Edge），或在支持浏览器直连的模型服务上使用。',
+      )
+    }
+    if (e instanceof DOMException && e.name === 'AbortError') throw e
+    throw new AiRequestError(0, `无法连接模型服务：${reason}`)
+  }
+
+  if (!res.ok) {
+    const txt = await res.text().catch(() => '')
+    throw new AiRequestError(res.status, friendlyError(res.status, txt))
+  }
+
+  if (!res.body) {
+    throw new AiRequestError(0, '响应缺少流式数据体。')
+  }
+
+  const reader = res.body.getReader()
+  const decoder = new TextDecoder()
+  let full = ''
+  let buffer = ''
+
+  try {
+    while (true) {
+      const { done, value } = await reader.read()
+      if (done) break
+      buffer += decoder.decode(value, { stream: true })
+
+      let nl: number
+      while ((nl = buffer.indexOf('\n')) >= 0) {
+        const line = buffer.slice(0, nl).trim()
+        buffer = buffer.slice(nl + 1)
+        if (!line || line.startsWith(':')) continue
+        if (line === 'data: [DONE]') continue
+        if (!line.startsWith('data:')) continue
+        const payload = line.slice(5).trim()
+        if (!payload) continue
+        try {
+          const obj = JSON.parse(payload)
+          const delta: string | undefined = obj.choices?.[0]?.delta?.content
+          if (delta) {
+            full += delta
+            opts.onToken(delta)
+          }
+        } catch {
+          // 忽略不完整的分片
+        }
+      }
+    }
+  } finally {
+    // 确保 reader 被释放（中断时也清理）
+    try {
+      await reader.cancel()
+    } catch {
+      /* noop */
+    }
+  }
+
+  // 兜底：部分 OpenAI 兼容端点忽略 stream:true，直接返回单次 JSON（choices[0].message.content）。
+  // 这种情况下上面没有触发 onToken，这里做一次补偿，保证仍能解析出模板文本。
+  if (!full) {
+    const trimmed = buffer.trim()
+    if (trimmed.startsWith('{') || trimmed.startsWith('[')) {
+      try {
+        const obj = JSON.parse(trimmed) as {
+          choices?: Array<{ message?: { content?: string }; text?: string }>
+        }
+        const content = obj.choices?.[0]?.message?.content ?? obj.choices?.[0]?.text
+        if (content) {
+          full = content
+          opts.onToken(content)
+        }
+      } catch {
+        /* 不是纯 JSON，忽略 */
+      }
+    }
+  }
+
+  return full
+}
diff --git a/openprint/src/ai/generate.ts b/openprint/src/ai/generate.ts
new file mode 100644
index 0000000..ceca61e
--- /dev/null
+++ b/openprint/src/ai/generate.ts
@@ -0,0 +1,165 @@
+/**
+ * AI 生成编排 —— 组装提示词 → 流式调用 → 解析 JSON → 归一化 → 校验/修复。
+ * 纯前端、一次性问答；不落库，结果由调用方决定如何应用。
+ */
+import type { AnyControl } from '@/types/control'
+import type { TemplateData } from '@/types/template'
+import { validateTemplate } from '@/core/spec/validator'
+import { streamChat, AiRequestError } from './client'
+import { buildSystemPrompt, buildUserPrompt, getFewShot } from './schema'
+import { normalizeControl, normalizeTemplate } from './normalize'
+import type { AiSettings } from '@/config/ai-settings'
+
+export interface GenerateRequest {
+  prompt: string
+  /** 基于当前模板修改时传入 */
+  currentTemplate?: TemplateData<AnyControl>
+  /** 仅针对画布中选中的控件改写（C 功能）：传入这些控件的协议 JSON */
+  selectedControls?: AnyControl[]
+  /** 数据字段接地（可选） */
+  datasourceFields?: string[]
+  settings: AiSettings
+  onToken?: (delta: string) => void
+  signal?: AbortSignal
+}
+
+export interface GenerateResult {
+  ok: boolean
+  data?: TemplateData<AnyControl>
+  /** 选区改写模式：返回的新控件集合（用于替换原选中控件） */
+  controls?: AnyControl[]
+  error?: string
+  /** 模型原始输出（用于调试 / 展示） */
+  raw?: string
+}
+
+/** 从模型文本中提取 JSON（兼容 ```json 代码块 / 纯 JSON / 首尾花括号） */
+export function extractJson(text: string): unknown | null {
+  const trimmed = text.trim()
+  if (!trimmed) return null
+
+  // 1) 直接可解析
+  try {
+    return JSON.parse(trimmed)
+  } catch {
+    /* fallthrough */
+  }
+
+  // 2) ```json ... ``` 代码块
+  const fence = trimmed.match(/```(?:json)?\s*([\s\S]*?)```/i)
+  if (fence?.[1]) {
+    try {
+      return JSON.parse(fence[1].trim())
+    } catch {
+      /* fallthrough */
+    }
+  }
+
+  // 3) 第一个 { 到最后一个 }
+  const first = trimmed.indexOf('{')
+  const last = trimmed.lastIndexOf('}')
+  if (first >= 0 && last > first) {
+    try {
+      return JSON.parse(trimmed.slice(first, last + 1))
+    } catch {
+      /* fallthrough */
+    }
+  }
+  return null
+}
+
+function fmtError(e: unknown): string {
+  if (e instanceof AiRequestError) return e.message
+  if (e instanceof DOMException && e.name === 'AbortError') return '已取消生成。'
+  return e instanceof Error ? e.message : '未知错误'
+}
+
+/**
+ * 生成模板。
+ * - 普通 / 基于当前模板改：返回完整 TemplateData，失败时最多把校验错误回传模型重试一次。
+ * - 选区改写（selectedControls）：模型返回控件数组，归一化后返回 controls。
+ */
+export async function generateTemplate(req: GenerateRequest): Promise<GenerateResult> {
+  const messages = [
+    { role: 'system' as const, content: buildSystemPrompt() },
+    ...getFewShot(),
+    { role: 'user' as const, content: buildUserPrompt(req) },
+  ]
+
+  // —— 选区改写模式：期望模型返回控件数组 ——
+  if (req.selectedControls && req.selectedControls.length) {
+    let raw = ''
+    try {
+      raw = await streamChat({
+        baseURL: req.settings.baseURL,
+        apiKey: req.settings.apiKey,
+        model: req.settings.model,
+        messages,
+        onToken: (d) => req.onToken?.(d),
+        signal: req.signal,
+      })
+    } catch (e) {
+      return { ok: false, error: fmtError(e), raw }
+    }
+    const json = extractJson(raw)
+    const arr = Array.isArray(json) ? json : []
+    const controls = arr
+      .map((c) => (typeof c === 'object' && c ? normalizeControl(c as Record<string, unknown>) : null))
+      .filter((c): c is AnyControl => c !== null)
+    if (!controls.length) {
+      return { ok: false, error: '模型未返回有效的控件 JSON（应为控件数组）。', raw }
+    }
+    return { ok: true, controls, raw }
+  }
+
+  // —— 完整模板模式 ——
+  let raw = ''
+  const MAX_ATTEMPTS = 2
+  for (let attempt = 0; attempt < MAX_ATTEMPTS; attempt++) {
+    try {
+      raw = await streamChat({
+        baseURL: req.settings.baseURL,
+        apiKey: req.settings.apiKey,
+        model: req.settings.model,
+        messages,
+        onToken: (d) => req.onToken?.(d),
+        signal: req.signal,
+      })
+    } catch (e) {
+      return { ok: false, error: fmtError(e), raw }
+    }
+
+    const json = extractJson(raw)
+    if (!json) {
+      return { ok: false, error: '模型未返回有效的模板 JSON。', raw }
+    }
+
+    const normalized = normalizeTemplate(json)
+    const result = validateTemplate(normalized)
+    if (result.valid) {
+      return { ok: true, data: normalized, raw }
+    }
+
+    // 重试：把校验错误反馈给模型
+    if (attempt < MAX_ATTEMPTS - 1) {
+      const issues = result.issues
+        .map((i) => `${i.path || '/'}：${i.message}`)
+        .join('；')
+      messages.push({ role: 'assistant', content: raw })
+      messages.push({
+        role: 'user',
+        content: `你的输出未通过模板协议校验，请修正后只输出正确 JSON。错误：${issues}`,
+      })
+      raw = ''
+      continue
+    }
+    return {
+      ok: false,
+      error: `模板校验失败：${result.issues
+        .map((i) => `${i.path || '/'}: ${i.message}`)
+        .join('；')}`,
+      raw,
+    }
+  }
+  return { ok: false, error: '生成失败（超出重试次数）。', raw }
+}
diff --git a/openprint/src/ai/normalize.ts b/openprint/src/ai/normalize.ts
new file mode 100644
index 0000000..60772ee
--- /dev/null
+++ b/openprint/src/ai/normalize.ts
@@ -0,0 +1,133 @@
+/**
+ * AI 输出归一化 —— 把模型返回的「接近协议」的 JSON 修成可通过校验的 TemplateData。
+ * 设计器 loadTemplate 也会兜底缺 id，这里提前补齐让校验更稳。
+ */
+import type { AnyControl, ControlType } from '@/types/control'
+import type { TemplateData } from '@/types/template'
+
+const VALID_TYPES: ControlType[] = [
+  'text',
+  'image',
+  'table',
+  'barcode',
+  'qrcode',
+  'richtext',
+  'rect',
+  'line',
+  'zone',
+]
+
+function genId(prefix = 'ctrl'): string {
+  return `${prefix}_${Math.random().toString(36).slice(2, 10)}`
+}
+
+function num(v: unknown, fallback: number): number {
+  return typeof v === 'number' && Number.isFinite(v) ? v : fallback
+}
+
+function round1(v: number): number {
+  return Math.round(v * 10) / 10
+}
+
+export function normalizeControl(raw: Record<string, unknown>): AnyControl | null {
+  const type = raw.type as ControlType
+  if (!VALID_TYPES.includes(type)) return null
+  const base = {
+    id: typeof raw.id === 'string' && raw.id ? raw.id : genId(type),
+    type,
+    left: round1(num(raw.left, 0)),
+    top: round1(num(raw.top, 0)),
+    width: round1(Math.max(num(raw.width, 10), 1)),
+    height: round1(Math.max(num(raw.height, 6), 1)),
+  }
+  const extra: Record<string, unknown> = { ...raw }
+  delete extra.id
+  delete extra.type
+  delete extra.left
+  delete extra.top
+  delete extra.width
+  delete extra.height
+  return { ...base, ...extra } as AnyControl
+}
+
+function normalizeSection(raw: Record<string, unknown>): Record<string, unknown> | null {
+  const type = raw.type
+  if (type !== 'header' && type !== 'body' && type !== 'footer') return null
+  const components = Array.isArray(raw.components)
+    ? (raw.components as Record<string, unknown>[])
+        .map(normalizeControl)
+        .filter((c): c is AnyControl => c !== null)
+    : []
+  return {
+    type,
+    ...(type !== 'body' ? { height: num(raw.height, 20) } : {}),
+    repeat: raw.repeat === false ? false : true,
+    components,
+  }
+}
+
+/** 归一化整份模板 */
+export function normalizeTemplate(raw: unknown): TemplateData<AnyControl> {
+  const obj = (raw && typeof raw === 'object' ? raw : {}) as Record<string, unknown>
+  const doc = (obj.document && typeof obj.document === 'object'
+    ? obj.document
+    : {}) as Record<string, unknown>
+  const page = (doc.page && typeof doc.page === 'object' ? doc.page : {}) as Record<string, unknown>
+  const sectionsRaw = Array.isArray(doc.sections) ? (doc.sections as Record<string, unknown>[]) : []
+
+  const sections = sectionsRaw
+    .map(normalizeSection)
+    .filter((s): s is Record<string, unknown> => s !== null)
+
+  // 至少保证有一个 body
+  if (!sections.some((s) => s.type === 'body')) {
+    sections.push({ type: 'body', components: [] })
+  }
+
+  // —— 坐标纠偏：把「相对页面(page-origin)」的 AI 输出还原为「相对内容区(content-relative)」 ——
+  // 触发条件：某节内控件的最小 left 接近 margin.left 且最小 top 接近 margin.top（即模型把页边距也算进了坐标）。
+  // 此时统一减去页边距，避免整页内容向右下偏移一个 margin。正确生成的模板 minLeft/minTop≈0，不会触发。
+  const ml = num((page.margin as Record<string, unknown>)?.left, 10)
+  const mt = num((page.margin as Record<string, unknown>)?.top, 10)
+  const EPS = 2
+  for (const section of sections) {
+    const comps = (section.components as AnyControl[] | undefined) ?? []
+    if (!comps.length) continue
+    const minLeft = Math.min(...comps.map((c) => c.left))
+    const minTop = Math.min(...comps.map((c) => c.top))
+    if (minLeft > 1 && Math.abs(minLeft - ml) <= EPS && minTop > 1 && Math.abs(minTop - mt) <= EPS) {
+      for (const c of comps) {
+        c.left = round1(c.left - ml)
+        c.top = round1(c.top - mt)
+      }
+    }
+  }
+
+  const width = num(page.width, 210)
+  const height = num(page.height, 297)
+
+  const normalized: TemplateData<AnyControl> = {
+    version: typeof obj.version === 'string' ? obj.version : '1.0.0',
+    document: {
+      type: 'report',
+      page: {
+        width,
+        height,
+        unit: page.unit === 'in' || page.unit === 'pt' ? page.unit : 'mm',
+        orientation:
+          page.orientation === 'landscape' || width > height ? 'landscape' : 'portrait',
+        margin: {
+          top: num((page.margin as Record<string, unknown>)?.top, 10),
+          bottom: num((page.margin as Record<string, unknown>)?.bottom, 10),
+          left: num((page.margin as Record<string, unknown>)?.left, 10),
+          right: num((page.margin as Record<string, unknown>)?.right, 10),
+        },
+        ...(typeof page.backgroundColor === 'string'
+          ? { backgroundColor: page.backgroundColor }
+          : {}),
+      },
+      sections: sections as unknown as TemplateData<AnyControl>['document']['sections'],
+    },
+  }
+  return normalized
+}
diff --git a/openprint/src/ai/schema.ts b/openprint/src/ai/schema.ts
new file mode 100644
index 0000000..4b0269f
--- /dev/null
+++ b/openprint/src/ai/schema.ts
@@ -0,0 +1,155 @@
+/**
+ * AI 助手 —— 前端预设的提示词与 few-shot 示例（无后端、纯常量）。
+ *
+ * 协议要点（节选自项目《OpenPrint-设计方案》§5）：
+ *   TemplateData = { version, document }
+ *   document = { type:'report', page, sections:[...] }
+ *   page = { width, height, unit:'mm', orientation:'portrait'|'landscape',
+ *            margin:{top,bottom,left,right}, backgroundColor?, watermark? }
+ *   section = { type:'header'|'body'|'footer', height?, repeat?, components:[...] }
+ *   component 公共：{ id?, type, left, top, width, height, angle?, printable?, ... }
+ *   坐标系：mm。⚠️ left/top 是相对「内容区（页边距内侧）左上角」的偏移，渲染器会自动叠加页边距——你不要再算 margin 进去。
+ */
+
+const PROTOCOL_SUMMARY = `你是 OpenPrint 打印模板设计助手。根据用户用中文描述的排版需求，生成一份「打印模板」JSON。
+
+模板协议（必须遵守）：
+- 顶层：{ "version": "1.0.0", "document": { "type": "report", "page": {...}, "sections": [...] } }
+- page：{ "width": 数字, "height": 数字, "unit": "mm", "orientation": "portrait"|"landscape", "margin": { "top": 数字, "bottom": 数字, "left": 数字, "right": 数字 }, "backgroundColor"?: "#ffffff" }。横向时 width > height。常用纸张：A4 纵向 210×297、A4 横向 297×210、A5 纵向 148×210。
+- sections：数组。必须且只能有一个 type:"body"；可选 type:"header" / "footer"（页眉页脚，带 height）。
+- 控件通用字段：type 必填；left/top/width/height 必填（单位 mm，原点 = 内容区左上角，即已扣除页边距）；id 可省略（系统自动补）。
+- 控件类型与要点：
+  · text：静态文字用 value；如需绑数据用 binding（字段路径）或 expression（如 "{{order.total}}"）。style 可选：{ fontSize(pt), fill(hex), fontWeight:'bold', textAlign:'left'|'center'|'right', lineHeight }。
+  · image：{ value:{ mode:'url'|'binding', content } }，fit 可选。
+  · table：columns:[{ title, field?, width, align? }]，options 可选（borders/zebra 等），dataSource 留空表示布局网格。
+  · barcode：{ value, format:'CODE128'|'EAN13'..., showText? }；qrcode：{ value, errorLevel? }。
+  · rect / line：{ fill?, stroke?, strokeWidth?, cornerRadius? }。
+  · richtext：{ value: "<p>HTML</p>" }（仅可信静态内容）。
+
+设计原则：
+- 间距与对齐要规整（建议控件左/右贴边留白一致，关键元素水平居中）。
+- 坐标铁律：left/top 是相对「内容区（页边距内侧）左上角」的 mm，渲染器会再叠加页边距，所以你写的坐标【不要包含 margin】。给定页面 width/height 与 margin 后，内容区宽 = width - margin.left - margin.right、高 = height - margin.top - margin.bottom；占满整行写 left:0, width:内容区宽，水平居中配合 style.textAlign:'center'。严禁出现 left 等于 margin.left、top 等于 margin.top 这类把页边距算进坐标的写法。
+- 只输出「一段简要中文说明（不超过 3 句）」+ 一个 \`\`\`json 代码块包裹的完整模板。不要输出其他内容。
+- 不依赖真实数据：文字用静态 value；除非用户明确给出字段，否则不要写 binding。
+- 颜色用 hex（如 #1677ff、#333333）或 rgba。`
+
+const FEW_SHOT: Array<{ role: 'user' | 'assistant'; content: string }> = [
+  {
+    role: 'user',
+    content: '做一个竖向快递面单，100×150mm，上方标题"快递面单"，中间收件人姓名电话和地址，底部一个条码和右下角一个二维码。',
+  },
+  {
+    role: 'assistant',
+    content: `好的，已生成 100×150mm 的竖向快递面单：标题居中、收件信息分区、底部条码 + 右下角二维码。
+（坐标均为相对内容区：页面 100×150、四周 margin=8，内容区宽 = 100-8-8 = 84）
+
+\`\`\`json
+{
+  "version": "1.0.0",
+  "document": {
+    "type": "report",
+    "page": {
+      "width": 100, "height": 150, "unit": "mm", "orientation": "portrait",
+      "margin": { "top": 8, "bottom": 8, "left": 8, "right": 8 },
+      "backgroundColor": "#ffffff"
+    },
+    "sections": [
+      {
+        "type": "body",
+        "components": [
+          { "type": "text", "left": 0, "top": 2, "width": 84, "height": 12, "value": "快递面单", "style": { "fontSize": 20, "fontWeight": "bold", "textAlign": "center" } },
+          { "type": "text", "left": 0, "top": 18, "width": 84, "height": 8, "value": "收件人：张三　13800000000", "style": { "fontSize": 11 } },
+          { "type": "text", "left": 0, "top": 30, "width": 84, "height": 30, "value": "地址：广东省深圳市南山区科技园路 1 号 XX 大厦 10 层", "style": { "fontSize": 11 } },
+          { "type": "text", "left": 0, "top": 64, "width": 84, "height": 8, "value": "托寄物：文件　到付", "style": { "fontSize": 11, "fill": "#555555" } },
+          { "type": "barcode", "left": 0, "top": 78, "width": 84, "height": 22, "value": "SF1234567890", "format": "CODE128", "showText": true },
+          { "type": "qrcode", "left": 52, "top": 104, "width": 32, "height": 28, "value": "https://example.com/order/SF1234567890" },
+          { "type": "text", "left": 0, "top": 104, "width": 48, "height": 28, "value": "请于签收前核对信息", "style": { "fontSize": 10, "fill": "#888888" } }
+        ]
+      }
+    ]
+  }
+}
+\`\`\``,
+  },
+  {
+    role: 'user',
+    content: '做一个横向会员卡，90×54mm，左侧品牌名和会员等级，右侧会员姓名和大号卡号，底部一条分割线。',
+  },
+  {
+    role: 'assistant',
+    content: `已生成 90×54mm 横向会员卡：左侧品牌与等级、右侧姓名与卡号、底部分割线。
+（坐标相对内容区：页面 90×54、四周 margin=6，内容区宽 = 90-6-6 = 78）
+
+\`\`\`json
+{
+  "version": "1.0.0",
+  "document": {
+    "type": "report",
+    "page": {
+      "width": 90, "height": 54, "unit": "mm", "orientation": "landscape",
+      "margin": { "top": 6, "bottom": 6, "left": 6, "right": 6 },
+      "backgroundColor": "#0c447c"
+    },
+    "sections": [
+      {
+        "type": "body",
+        "components": [
+          { "type": "text", "left": 0, "top": 4, "width": 40, "height": 10, "value": "STAR 会员", "style": { "fontSize": 16, "fontWeight": "bold", "fill": "#ffffff" } },
+          { "type": "text", "left": 0, "top": 18, "width": 40, "height": 8, "value": "钻石会员", "style": { "fontSize": 11, "fill": "#9fc3ff" } },
+          { "type": "text", "left": 46, "top": 6, "width": 32, "height": 10, "value": "李雷", "style": { "fontSize": 15, "fontWeight": "bold", "fill": "#ffffff", "textAlign": "right" } },
+          { "type": "text", "left": 46, "top": 20, "width": 32, "height": 10, "value": "NO. 8821 0043", "style": { "fontSize": 14, "fill": "#ffffff", "textAlign": "right", "letterSpacing": 1 } },
+          { "type": "line", "left": 0, "top": 34, "width": 78, "height": 0.4, "stroke": "#ffffff", "strokeWidth": 0.4 }
+        ]
+      }
+    ]
+  }
+}
+\`\`\``,
+  },
+]
+
+/** 组装 system 提示词 */
+export function buildSystemPrompt(): string {
+  return PROTOCOL_SUMMARY
+}
+
+/** 组装用户提示词（支持「基于当前模板修改」「仅选中控件改写」「数据字段接地」） */
+export function buildUserPrompt(opts: {
+  prompt: string
+  currentTemplate?: unknown
+  selectedControls?: unknown[]
+  datasourceFields?: string[]
+}): string {
+  const parts: string[] = []
+  if (opts.datasourceFields && opts.datasourceFields.length) {
+    parts.push(`可用数据字段（如用户要求绑定真实数据，请优先使用这些路径）：\n${opts.datasourceFields.join('、')}\n`)
+  }
+  if (opts.selectedControls && opts.selectedControls.length) {
+    parts.push(
+      `下面是一组「用户当前选中的控件」（坐标 left/top 是相对内容区左上角的 mm）。\n` +
+        `请按需求改写这些选中控件并【只输出一个控件 JSON 数组】，要求：\n` +
+        `· 必须保留每个原控件的 id（用于原位替换），不要改变其 type；\n` +
+        `· 可调整 left/top/width/height/value/style 等，实现重排、对齐、换风格、统一间距等；\n` +
+        `· 可新增控件（给新的唯一 id，type 合法），也可删除某些选中控件（不输出即可）；\n` +
+        `· 坐标仍是相对内容区（已扣除页边距），不要再加 margin；\n` +
+        `· 只输出控件数组，不要包装成完整模板。\n` +
+        '```json\n' +
+        JSON.stringify(opts.selectedControls, null, 2) +
+        '\n```',
+    )
+  } else if (opts.currentTemplate) {
+    parts.push(
+      `请在下面这份「当前模板 JSON」的基础上按需求修改，输出完整的新模板（不要只输出 diff）：\n` +
+        '```json\n' +
+        JSON.stringify(opts.currentTemplate, null, 2) +
+        '\n```',
+    )
+  }
+  parts.push(`需求：${opts.prompt}`)
+  return parts.join('\n\n')
+}
+
+/** few-shot 示例（user/assistant 成对） */
+export function getFewShot(): Array<{ role: 'user' | 'assistant'; content: string }> {
+  return FEW_SHOT
+}
diff --git a/openprint/src/assets/logo.png b/openprint/src/assets/logo.png
new file mode 100644
index 0000000..9bf2017
Binary files /dev/null and b/openprint/src/assets/logo.png differ
diff --git a/openprint/src/assets/main.css b/openprint/src/assets/main.css
new file mode 100644
index 0000000..9c91254
--- /dev/null
+++ b/openprint/src/assets/main.css
@@ -0,0 +1,59 @@
+:root {
+  /* 旧变量保留（对齐文档，但品牌变量统一在 theme/brand.css 中） */
+  --brand-primary: #1677ff;
+  --brand-dark: #111827;
+  --brand-bg: #f5f7fa;
+  --brand-border: #e5e7eb;
+}
+
+html,
+body,
+#app {
+  height: 100%;
+  margin: 0;
+  padding: 0;
+}
+
+/* naive-ui Provider 会在 #app 下包一层无样式 div，补齐高度链 */
+#app > div {
+  height: 100%;
+}
+
+body {
+  font-family:
+    Inter,
+    'Source Han Sans CN',
+    'PingFang SC',
+    'Microsoft YaHei',
+    system-ui,
+    -apple-system,
+    sans-serif;
+  -webkit-font-smoothing: antialiased;
+  -moz-osx-font-smoothing: grayscale;
+  background: var(--brand-bg);
+  color: var(--brand-text-1);
+  overflow: hidden;
+}
+
+/* html.dark 下 body 由 NGlobalStyle 同步 bodyColor；这里加一个过渡让切换更顺 */
+* {
+  transition:
+    background-color 0.2s ease,
+    color 0.2s ease,
+    border-color 0.2s ease,
+    box-shadow 0.2s ease;
+}
+/* 画布/标尺/控件本身不需要过渡，否则拖拽有拖影 */
+canvas,
+svg,
+svg *,
+.fabric-canvas,
+canvas * {
+  transition: none !important;
+}
+
+/* NInputNumber 内部 input 默认左对齐；button-placement="both" 时左右按钮挤压空间，
+   统一居中更美观。覆盖内部 .n-input__input-el（naive-ui 无 textAlign prop）。 */
+.n-input-number .n-input__input-el {
+  text-align: center;
+}
diff --git a/openprint/src/config/ai-settings.ts b/openprint/src/config/ai-settings.ts
new file mode 100644
index 0000000..a820d47
--- /dev/null
+++ b/openprint/src/config/ai-settings.ts
@@ -0,0 +1,79 @@
+/**
+ * AI 助手配置 —— 纯前端、零后端、存本地（localStorage）。
+ * 走 OpenAI 兼容 /chat/completions 协议：用户自己填 地址 / Key / 模型 ID。
+ * 与 print-settings.ts 同套路（window.localStorage + 固定 STORAGE_KEY）。
+ */
+export interface AiSettings {
+  /** OpenAI 兼容的 baseURL，需含 /v1（如 https://api.openai.com/v1） */
+  baseURL: string
+  /** 用户自己的 API Key（明文存本地，仅本地单用户场景） */
+  apiKey: string
+  /** 模型 ID，如 gpt-4o-mini / deepseek-chat / qwen-plus */
+  model: string
+  /** 是否已启用 AI 助手 */
+  enabled: boolean
+}
+
+/** 常见 provider 预设（点击即填，用户仍可自行改地址） */
+export interface AiProviderPreset {
+  label: string
+  baseURL: string
+  model: string
+}
+
+export const AI_PROVIDER_PRESETS: AiProviderPreset[] = [
+  { label: 'OpenAI', baseURL: 'https://api.openai.com/v1', model: 'gpt-4o-mini' },
+  { label: 'DeepSeek', baseURL: 'https://api.deepseek.com/v1', model: 'deepseek-chat' },
+  { label: '通义千问', baseURL: 'https://dashscope.aliyuncs.com/compatible-mode/v1', model: 'qwen-plus' },
+  { label: 'Moonshot', baseURL: 'https://api.moonshot.cn/v1', model: 'moonshot-v1-8k' },
+  { label: '自定义', baseURL: '', model: '' },
+]
+
+const STORAGE_KEY = 'openprint:ai:config'
+
+const DEFAULT_AI_SETTINGS: AiSettings = {
+  baseURL: 'https://api.openai.com/v1',
+  apiKey: '',
+  model: 'gpt-4o-mini',
+  enabled: false,
+}
+
+function safeRead(): AiSettings {
+  if (typeof window === 'undefined') return { ...DEFAULT_AI_SETTINGS }
+  try {
+    const raw = window.localStorage.getItem(STORAGE_KEY)
+    if (!raw) return { ...DEFAULT_AI_SETTINGS }
+    const parsed = JSON.parse(raw) as Partial<AiSettings>
+    return {
+      baseURL: typeof parsed.baseURL === 'string' ? parsed.baseURL : DEFAULT_AI_SETTINGS.baseURL,
+      apiKey: typeof parsed.apiKey === 'string' ? parsed.apiKey : '',
+      model: typeof parsed.model === 'string' ? parsed.model : DEFAULT_AI_SETTINGS.model,
+      enabled: !!parsed.enabled,
+    }
+  } catch {
+    return { ...DEFAULT_AI_SETTINGS }
+  }
+}
+
+function safeWrite(v: AiSettings): void {
+  if (typeof window === 'undefined') return
+  try {
+    window.localStorage.setItem(STORAGE_KEY, JSON.stringify(v))
+  } catch {
+    /* noop */
+  }
+}
+
+export function readAiSettings(): AiSettings {
+  return safeRead()
+}
+
+export function writeAiSettings(v: AiSettings): void {
+  safeWrite(v)
+}
+
+/** 是否已具备发起请求的最低配置 */
+export function isAiConfigured(): boolean {
+  const s = safeRead()
+  return s.enabled && !!s.baseURL.trim() && !!s.apiKey.trim() && !!s.model.trim()
+}
diff --git a/openprint/src/config/backend.ts b/openprint/src/config/backend.ts
new file mode 100644
index 0000000..912f4a3
--- /dev/null
+++ b/openprint/src/config/backend.ts
@@ -0,0 +1,36 @@
+/**
+ * 后端对接配置开关 —— 《后端对接规范》§4
+ *
+ * 铁律（2026-08-08 主任定）：未配置后端接口时，全部走本地存储（模板）/ Mock（数据源），
+ * 一切功能不受影响。只有显式配置了 `VITE_OPENPRINT_API_BASE` 才切换为云端仓库。
+ *
+ * 配置方式（项目根目录 .env）：
+ *   VITE_OPENPRINT_API_BASE=https://print.example.com
+ *   VITE_OPENPRINT_API_TOKEN=  # 可选，Bearer 鉴权
+ *
+ * 基地址会被当作前缀拼接：`/api/print/templates` → `https://print.example.com/api/print/templates`
+ */
+import type { HttpOptions } from '@/repository/http-client'
+
+const API_BASE = (import.meta.env.VITE_OPENPRINT_API_BASE ?? '').trim()
+const API_TOKEN = (import.meta.env.VITE_OPENPRINT_API_TOKEN ?? '').trim()
+
+export interface BackendConfig {
+  mode: 'cloud'
+  options: HttpOptions
+}
+
+/** 是否已配置后端（决定走云端仓库还是本地/Mock） */
+export const isBackendConfigured = API_BASE.length > 0
+
+/** 读取后端配置；未配置返回 null（调用方据此保持本地/Mock） */
+export function getBackendConfig(): BackendConfig | null {
+  if (!API_BASE) return null
+  return {
+    mode: 'cloud',
+    options: {
+      baseUrl: API_BASE,
+      token: API_TOKEN.length > 0 ? API_TOKEN : undefined,
+    },
+  }
+}
diff --git a/openprint/src/config/print-settings.spec.ts b/openprint/src/config/print-settings.spec.ts
new file mode 100644
index 0000000..8d828f6
--- /dev/null
+++ b/openprint/src/config/print-settings.spec.ts
@@ -0,0 +1,48 @@
+import { beforeEach, describe, expect, it } from 'vitest'
+import {
+  DEFAULT_PRINT_SETTINGS,
+  readPrintSettings,
+  writePrintSettings,
+  PRINT_SETTINGS_KEY,
+} from '@/config/print-settings'
+
+describe('print-settings —— 打印设置读写', () => {
+  beforeEach(() => {
+    window.localStorage.clear()
+  })
+
+  it('无存储时返回默认值', () => {
+    expect(readPrintSettings()).toEqual(DEFAULT_PRINT_SETTINGS)
+  })
+
+  it('写入后可读回', () => {
+    const s = {
+      local: {
+        method: 'silent' as const,
+        silent: { host: '192.168.1.10', port: 9122 },
+        copies: 3,
+        closeAfterPrint: false,
+      },
+      remote: { enabled: true, host: 'http://10.0.0.8', port: 9200, printer: 'HP-1' },
+    }
+    writePrintSettings(s)
+    expect(readPrintSettings()).toEqual(s)
+  })
+
+  it('损坏 JSON 回退默认值', () => {
+    window.localStorage.setItem(PRINT_SETTINGS_KEY, '{oops')
+    expect(readPrintSettings()).toEqual(DEFAULT_PRINT_SETTINGS)
+  })
+
+  it('部分配置深度合并（新增字段有默认值）', () => {
+    window.localStorage.setItem(
+      PRINT_SETTINGS_KEY,
+      JSON.stringify({ local: { method: 'silent' } }),
+    )
+    const s = readPrintSettings()
+    expect(s.local.method).toBe('silent')
+    expect(s.local.copies).toBe(DEFAULT_PRINT_SETTINGS.local.copies)
+    expect(s.local.silent).toEqual({ host: '127.0.0.1', port: 18888 })
+    expect(s.remote.enabled).toBe(false)
+  })
+})
diff --git a/openprint/src/config/print-settings.ts b/openprint/src/config/print-settings.ts
new file mode 100644
index 0000000..b587d4f
--- /dev/null
+++ b/openprint/src/config/print-settings.ts
@@ -0,0 +1,87 @@
+/**
+ * 打印设置 —— 本地打印 / 远程云打印 配置（全局设置，localStorage 持久化）
+ * 主任铁律：无后端全链路可用 —— 设置只存本地，绝不依赖后端。
+ */
+
+export interface LocalPrintConfig {
+  /** 打印方式：browser=浏览器打印对话框 / silent=客户端静默打印（需本地客户端服务） */
+  method: 'browser' | 'silent'
+  /**
+   * 本地打印客户端连接地址。
+   * 同时也是 /health、/printers、/print 三个接口的基地址来源，
+   * 解析优先级见 `@/config/printer` 的 resolvePrinterBaseUrl()。
+   */
+  silent: {
+    /** 客户端所在主机 IP（默认本机回环 127.0.0.1） */
+    host: string
+    /** 客户端服务端口（默认 18888） */
+    port: number
+  }
+  /** 副本数 */
+  copies: number
+  /** 打印完成后自动关闭预览窗口 */
+  closeAfterPrint: boolean
+}
+
+export interface RemotePrintConfig {
+  /** 是否启用远程云打印 */
+  enabled: boolean
+  /** 云打印服务地址（如 http://localhost 或 https://print.example.com） */
+  host: string
+  /** 服务端口 */
+  port: number
+  /** 目标打印机名（可选，留空使用服务默认打印机） */
+  printer: string
+}
+
+export interface PrintSettings {
+  local: LocalPrintConfig
+  remote: RemotePrintConfig
+}
+
+export const PRINT_SETTINGS_KEY = 'openprint:print-settings'
+
+export const DEFAULT_PRINT_SETTINGS: PrintSettings = {
+  local: {
+    method: 'browser',
+    silent: { host: '127.0.0.1', port: 18888 },
+    copies: 1,
+    closeAfterPrint: true,
+  },
+  remote: { enabled: false, host: 'http://localhost', port: 9100, printer: '' },
+}
+
+/** 读取设置（损坏/缺失时回退默认值，深度合并保证新字段有默认） */
+export function readPrintSettings(): PrintSettings {
+  if (typeof window === 'undefined') return DEFAULT_PRINT_SETTINGS
+  try {
+    const raw = window.localStorage.getItem(PRINT_SETTINGS_KEY)
+    if (!raw) return DEFAULT_PRINT_SETTINGS
+    const parsed = JSON.parse(raw) as Partial<PrintSettings>
+    return {
+      local: {
+        ...DEFAULT_PRINT_SETTINGS.local,
+        ...(parsed.local ?? {}),
+        silent: {
+          ...DEFAULT_PRINT_SETTINGS.local.silent,
+          ...(parsed.local?.silent ?? {}),
+        },
+      },
+      remote: {
+        ...DEFAULT_PRINT_SETTINGS.remote,
+        ...(parsed.remote ?? {}),
+      },
+    }
+  } catch {
+    return DEFAULT_PRINT_SETTINGS
+  }
+}
+
+export function writePrintSettings(settings: PrintSettings): void {
+  if (typeof window === 'undefined') return
+  try {
+    window.localStorage.setItem(PRINT_SETTINGS_KEY, JSON.stringify(settings))
+  } catch {
+    /* 存储不可用时静默失败（如隐私模式） */
+  }
+}
diff --git a/openprint/src/config/printer.ts b/openprint/src/config/printer.ts
new file mode 100644
index 0000000..9d6faf3
--- /dev/null
+++ b/openprint/src/config/printer.ts
@@ -0,0 +1,81 @@
+/**
+ * 打印客户端服务地址解析 —— 端口/地址覆盖的唯一出口
+ *
+ * 出厂默认：http://127.0.0.1:18888
+ *
+ * 覆盖优先级（高 → 低）：
+ *   1. 用户在「设置 → 本地打印」里填的 IP/端口（localStorage `openprint:print-settings`）
+ *   2. 出厂默认 http://127.0.0.1:18888
+ *
+ * 客户端已支持局域网打印：手填局域网地址（如 http://192.168.1.20:19000）即可直接推送，
+ * 手填地址优先级最高。
+ *
+ * 主任铁律：无后端全链路可用 —— 这里只读本地存储与构建期常量，绝不请求任何后端。
+ */
+import { DEFAULT_PRINTER_BASE_URL } from '@/core/print-client'
+import { PRINT_SETTINGS_KEY } from './print-settings'
+
+/** 地址来源，UI 用于提示用户当前生效的是哪一层配置 */
+export type PrinterBaseSource = 'settings' | 'default'
+
+/** 出厂默认，供 UI 占位/重置使用 */
+export const FACTORY_PRINTER_BASE_URL = DEFAULT_PRINTER_BASE_URL
+export const FACTORY_PRINTER_HOST = '127.0.0.1'
+export const FACTORY_PRINTER_PORT = 18888
+
+/** 补全协议 + 去掉尾部斜杠 */
+export function normalizePrinterBase(input: string): string {
+  const raw = input.trim().replace(/\/+$/, '')
+  if (!raw) return ''
+  return /^https?:\/\//i.test(raw) ? raw : `http://${raw}`
+}
+
+/** host + port → 基地址。host 可带协议（http://x）或只写 IP/域名 */
+export function buildPrinterBase(host: string, port: number): string {
+  const base = normalizePrinterBase(host)
+  if (!base) return ''
+  // host 里已经自带端口就不再拼（如用户填了 "127.0.0.1:18888"）
+  if (/:\d+$/.test(base)) return base
+  const p = Number.isFinite(port) && port > 0 ? Math.floor(port) : FACTORY_PRINTER_PORT
+  return `${base}:${p}`
+}
+
+/**
+ * 读取用户在设置里显式配置的端点。
+ * 只有 localStorage 里确实存在 local.silent.host/port 才算「用户配置过」，
+ * 否则返回 null 让位给环境变量。
+ */
+export function readStoredPrinterEndpoint(): { host: string; port: number } | null {
+  if (typeof window === 'undefined') return null
+  try {
+    const raw = window.localStorage.getItem(PRINT_SETTINGS_KEY)
+    if (!raw) return null
+    const parsed = JSON.parse(raw) as {
+      local?: { silent?: { host?: unknown; port?: unknown } }
+    }
+    const silent = parsed?.local?.silent
+    if (!silent) return null
+    const host = typeof silent.host === 'string' ? silent.host.trim() : ''
+    const port = typeof silent.port === 'number' ? silent.port : Number(silent.port)
+    if (!host || !Number.isFinite(port) || port <= 0) return null
+    return { host, port: Math.floor(port) }
+  } catch {
+    return null
+  }
+}
+
+/** 当前生效的打印客户端基地址 */
+export function resolvePrinterBaseUrl(): string {
+  const stored = readStoredPrinterEndpoint()
+  if (stored) {
+    const base = buildPrinterBase(stored.host, stored.port)
+    if (base) return base
+  }
+  return FACTORY_PRINTER_BASE_URL
+}
+
+/** 当前地址来自哪一层配置（UI 提示用） */
+export function resolvePrinterBaseSource(): PrinterBaseSource {
+  if (readStoredPrinterEndpoint()) return 'settings'
+  return 'default'
+}
diff --git a/openprint/src/core/__tests__/cjk-measurer.ts b/openprint/src/core/__tests__/cjk-measurer.ts
new file mode 100644
index 0000000..b387b83
--- /dev/null
+++ b/openprint/src/core/__tests__/cjk-measurer.ts
@@ -0,0 +1,34 @@
+import type { TextMeasureOptions, TextMeasurer } from '@/core/layout-engine/measure'
+
+/**
+ * 测试用确定性 CJK 估算测量器。
+ *
+ * 不依赖任何 DOM（happy-dom 不实现真实 CSS 布局），用字符宽度估算，
+ * 保证分页单测在 CI / node 下结果稳定、可复现。
+ * 估算规则：CJK 字符 ≈ 1em 宽，ASCII ≈ 0.6em 宽；行高 = lineHeight × fontSize(pt→mm)。
+ */
+export function createCjkMeasurer(): TextMeasurer {
+  return {
+    measure(text: string, o: TextMeasureOptions) {
+      const fsMm = (o.fontSize * 25.4) / 72 // pt → mm
+      const lineH = (o.lineHeight ?? 1.35) * fsMm
+      const charW = fsMm // CJK 近似 1em
+      const asciiW = fsMm * 0.6
+      const lines = text.split('\n')
+      let totalH = 0
+      let lineCount = 0
+      for (const ln of lines) {
+        let w = 0
+        for (const ch of ln) w += /[\x00-\xff]/.test(ch) ? asciiW : charW
+        const wrapped =
+          o.widthMm > 0 && o.wrap !== false ? Math.max(1, Math.ceil(w / o.widthMm)) : 1
+        totalH += wrapped * lineH
+        lineCount += wrapped
+      }
+      return { heightMm: totalH, lines: lineCount }
+    },
+    dispose() {
+      /* 无资源可释放 */
+    },
+  }
+}
diff --git a/openprint/src/core/chartkit/bar.ts b/openprint/src/core/chartkit/bar.ts
new file mode 100644
index 0000000..3df37d9
--- /dev/null
+++ b/openprint/src/core/chartkit/bar.ts
@@ -0,0 +1,126 @@
+/**
+ * chartkit/bar —— 垂直分组条形图（零依赖 SVG）
+ *
+ * 输出一串 <rect>（按序列分组并排）+ 坐标轴 + 可选网格 + 图例 + 数据标签。
+ * 全部用逻辑坐标（viewBox），实际尺寸由外层容器缩放，矢量清晰。
+ */
+import { escapeXml, fmt, niceMax, seriesColor, truncate, legendStartX } from './core'
+import type { ChartModel } from './types'
+
+export function renderBar(model: ChartModel): string {
+  const opt = model.options ?? {}
+  const W = opt.width ?? 480
+  const H = opt.height ?? 320
+  const title = opt.title
+  const showAxis = opt.showAxis ?? true
+  const showGrid = opt.showGrid ?? true
+  const showLegend = opt.showLegend ?? model.series.length > 1
+  const valueLabel = opt.valueLabel ?? false
+
+  const legendH = showLegend ? 22 : 0
+  const titleH = title ? 22 : 0
+  const mTop = 10 + titleH
+  const mRight = 16
+  const mBottom = (showAxis ? 42 : 22) + legendH
+  const mLeft = showAxis ? 44 : 16
+
+  const px0 = mLeft
+  const py0 = mTop
+  const px1 = W - mRight
+  const py1 = H - mBottom
+  const plotW = Math.max(1, px1 - px0)
+  const plotH = Math.max(1, py1 - py0)
+
+  const cats = model.categories.length
+    ? model.categories
+    : (model.series[0]?.data ?? []).map((_, i) => String(i + 1))
+  const n = cats.length
+
+  const allVals: number[] = []
+  for (const s of model.series) for (const v of s.data) if (isFinite(v)) allVals.push(v)
+  if (model.series.length === 0 || n === 0 || allVals.length === 0) {
+    return placeholder(W, H, '暂无数据')
+  }
+
+  const yMax = niceMax(Math.max(0, ...allVals))
+  const band = plotW / Math.max(1, n)
+  const inner = band * 0.74
+  const sCount = model.series.length
+  const barW = inner / Math.max(1, sCount)
+
+  const parts: string[] = []
+  parts.push(`<svg xmlns="http://www.w3.org/2000/svg" width="100%" height="100%" viewBox="0 0 ${W} ${H}" preserveAspectRatio="xMidYMid meet" font-family="'SourceHanSerifCN', 'PingFang SC', 'Microsoft YaHei', sans-serif">`)
+
+  if (title) {
+    parts.push(`<text x="${W / 2}" y="${16}" text-anchor="middle" font-size="13" font-weight="600" fill="#1f2329">${escapeXml(title)}</text>`)
+  }
+
+  // 网格 + y 轴刻度
+  if (showAxis) {
+    const ticks = 4
+    for (let i = 0; i <= ticks; i++) {
+      const v = (yMax / ticks) * i
+      const y = py1 - (v / yMax) * plotH
+      if (showGrid && i > 0) {
+        parts.push(`<line x1="${px0}" y1="${y.toFixed(1)}" x2="${px1}" y2="${y.toFixed(1)}" stroke="#EEEEEE" stroke-width="1"/>`)
+      }
+      parts.push(`<text x="${px0 - 6}" y="${(y + 3).toFixed(1)}" text-anchor="end" font-size="11" fill="#000000">${fmt(v)}</text>`)
+    }
+    // 基线
+    parts.push(`<line x1="${px0}" y1="${py1}" x2="${px1}" y2="${py1}" stroke="#cccccc" stroke-width="1"/>`)
+  }
+
+  // 柱体
+  for (let c = 0; c < n; c++) {
+    const cx = px0 + band * (c + 0.5)
+    const groupX0 = cx - inner / 2
+    for (let s = 0; s < sCount; s++) {
+      const val = model.series[s]!.data[c] ?? 0
+      if (!isFinite(val)) continue
+      const h = (Math.max(0, val) / yMax) * plotH
+      const x = groupX0 + s * barW
+      const y = py1 - h
+      const color = seriesColor(model.series[s]!, s, opt)
+      parts.push(`<rect x="${x.toFixed(1)}" y="${y.toFixed(1)}" width="${(barW * 0.9).toFixed(1)}" height="${Math.max(0, h).toFixed(1)}" fill="${color}" rx="1.5"/>`)
+      if (valueLabel && h > 0) {
+        parts.push(`<text x="${(x + barW * 0.45).toFixed(1)}" y="${(y - 4).toFixed(1)}" text-anchor="middle" font-size="10" fill="#000000">${fmt(val)}</text>`)
+      }
+    }
+    // x 轴标签：始终以类目为基准居中于对应条带正下方，并与图表留一点间距
+    if (showAxis) {
+      parts.push(`<text x="${cx.toFixed(1)}" y="${(py1 + 18).toFixed(1)}" text-anchor="middle" font-size="10" fill="#5a6068">${escapeXml(truncate(String(cats[c] ?? '')))}</text>`)
+    }
+  }
+
+  // 图例
+  if (showLegend) {
+    const align = opt.labelAlign ?? 'center'
+    let totalW = 0
+    for (let s = 0; s < sCount; s++) {
+      const name = model.series[s]!.name || `系列${s + 1}`
+      totalW += 16 + name.length * 12 + 18
+    }
+    const startX = legendStartX(align, W, totalW, px0)
+    let lx = startX
+    let ly = py1 + (showAxis ? 40 : 16)
+    for (let s = 0; s < sCount; s++) {
+      const name = model.series[s]!.name || `系列${s + 1}`
+      const color = seriesColor(model.series[s]!, s, opt)
+      const itemW = 16 + name.length * 12 + 18
+      if (lx + itemW > W - 8 && lx > startX) {
+        lx = startX
+        ly += 16
+      }
+      parts.push(`<rect x="${lx}" y="${ly - 9}" width="11" height="11" rx="2" fill="${color}"/>`)
+      parts.push(`<text x="${lx + 15}" y="${ly}" font-size="11" fill="#000000">${escapeXml(truncate(name, 10))}</text>`)
+      lx += itemW
+    }
+  }
+
+  parts.push('</svg>')
+  return parts.join('')
+}
+
+function placeholder(W: number, H: number, text: string): string {
+  return `<svg xmlns="http://www.w3.org/2000/svg" width="100%" height="100%" viewBox="0 0 ${W} ${H}" preserveAspectRatio="xMidYMid meet"><text x="${W / 2}" y="${H / 2}" text-anchor="middle" font-size="13" fill="#bbbbbb">${escapeXml(text)}</text></svg>`
+}
diff --git a/openprint/src/core/chartkit/chartkit.spec.ts b/openprint/src/core/chartkit/chartkit.spec.ts
new file mode 100644
index 0000000..10f8149
--- /dev/null
+++ b/openprint/src/core/chartkit/chartkit.spec.ts
@@ -0,0 +1,136 @@
+import { describe, it, expect } from 'vitest'
+import {
+  renderChartSvg,
+  chartControlToModel,
+  renderChartControl,
+  DEFAULT_PALETTE,
+} from './index'
+import type { ChartModel } from './types'
+
+const barModel: ChartModel = {
+  kind: 'bar',
+  categories: ['一月', '二月', '三月'],
+  series: [
+    { name: '销量', data: [12, 19, 8] },
+    { name: '退货', data: [3, 5, 2] },
+  ],
+}
+
+const lineModel: ChartModel = {
+  kind: 'line',
+  categories: ['周一', '周二', '周三'],
+  series: [{ name: '温度', data: [20, 25, 22] }],
+}
+
+const pieModel: ChartModel = {
+  kind: 'pie',
+  categories: ['苹果', '香蕉', '橙子'],
+  series: [{ name: '销量', data: [10, 20, 30] }],
+}
+
+function count(haystack: string, needle: string): number {
+  return haystack.split(needle).length - 1
+}
+
+describe('chartkit · 产出结构', () => {
+  it('三种图表都返回以 <svg 开头、以 </svg> 结尾的可缩放 SVG', () => {
+    for (const m of [barModel, lineModel, pieModel]) {
+      const svg = renderChartSvg(m)
+      expect(svg.startsWith('<svg')).toBe(true)
+      expect(svg.trimEnd().endsWith('</svg>')).toBe(true)
+      expect(svg).toContain('viewBox="0 0')
+      expect(svg).toContain('width="100%"')
+    }
+  })
+
+  it('bar 为每个(序列×类目)生成一个 <rect>', () => {
+    const svg = renderChartSvg(barModel)
+    // 2 序列 × 3 类目 = 6 根柱（柱体 rx=1.5，区别于图例色块 rx=2）
+    expect(count(svg, 'rx="1.5"')).toBe(6)
+  })
+
+  it('line 含一条折线路径 + 每个点一个圆点', () => {
+    const svg = renderChartSvg(lineModel)
+    expect(count(svg, '<circle')).toBe(3)
+    expect(svg).toContain('<path')
+  })
+
+  it('pie 为每个正数扇区生成一个 <path>', () => {
+    const svg = renderChartSvg(pieModel)
+    expect(count(svg, '<path')).toBe(3)
+    // 百分比标签
+    expect(svg).toContain('%')
+  })
+
+  it('pie 环形(donut) 每个扇区的 path 含内外两段弧(共 2 个 A 命令)', () => {
+    const normal = renderChartSvg(pieModel)
+    const donut = renderChartSvg({ ...pieModel, options: { donut: true } })
+    // 3 个扇区：普通每个 1 段弧；环形每个 2 段弧（外圈+内圈）
+    expect(count(normal, ' A ')).toBe(3)
+    expect(count(donut, ' A ')).toBe(6)
+  })
+
+  it('饼图实心扇区必须到达圆心(修复"中间空白")', () => {
+    const normal = renderChartSvg(pieModel)
+    const donut = renderChartSvg({ ...pieModel, options: { donut: true } })
+    // 默认 480×320 无标题无环形：圆心 (240,148)，楔形路径应以 "M 240.00 148.00" 起笔
+    expect(normal).toContain('M 240.00 148.00')
+    // 环形是环段，不应从圆心起笔
+    expect(donut).not.toContain('M 240.00 148.00')
+  })
+})
+
+describe('chartkit · 空/异常数据兜底', () => {
+  it('空数据渲染占位提示，不抛错', () => {
+    const svg = renderChartSvg({ kind: 'bar', categories: [], series: [] })
+    expect(svg).toContain('暂无数据')
+  })
+
+  it('饼图总量为 0 时不画扇区', () => {
+    const svg = renderChartSvg({ kind: 'pie', categories: ['a', 'b'], series: [{ name: 's', data: [0, 0] }] })
+    expect(svg).toContain('暂无数据')
+  })
+})
+
+describe('chartkit · 文本转义', () => {
+  it('标题中的 & < > 被转义，不会破坏 SVG 结构', () => {
+    const svg = renderChartSvg({ ...barModel, options: { title: 'A & B <C> "D"' } })
+    expect(svg).not.toContain('A & B')
+    expect(svg).toContain('A &amp; B &lt;C&gt;')
+  })
+})
+
+describe('chartkit · ChartControl 映射', () => {
+  it('chartControlToModel 补齐缺省并过滤非有限值', () => {
+    const m = chartControlToModel({
+      type: 'chart',
+      id: 'c1',
+      kind: 'line',
+      left: 0,
+      top: 0,
+      width: 60,
+      height: 40,
+      categories: ['x', 'y'],
+      series: [{ name: 's', data: [1, NaN, 3] }],
+    })
+    expect(m.kind).toBe('line')
+    expect(m.series[0]!.data).toEqual([1, 3])
+    expect(m.categories).toEqual(['x', 'y'])
+  })
+
+  it('renderChartControl 从协议对象直接出 SVG', () => {
+    const svg = renderChartControl({
+      type: 'chart',
+      id: 'c2',
+      kind: 'pie',
+      left: 0,
+      top: 0,
+      width: 50,
+      height: 50,
+      categories: ['a', 'b'],
+      series: [{ name: 's', data: [1, 2] }],
+    })
+    expect(svg).toContain('<svg')
+    expect(DEFAULT_PALETTE.length).toBeGreaterThan(0)
+  })
+})
diff --git a/openprint/src/core/chartkit/core.ts b/openprint/src/core/chartkit/core.ts
new file mode 100644
index 0000000..7896d06
--- /dev/null
+++ b/openprint/src/core/chartkit/core.ts
@@ -0,0 +1,119 @@
+/**
+ * chartkit/core —— 纯几何/文本工具（零依赖）
+ *
+ * 所有生成器共用的小工具：转义、数值格式化、线性刻度取整、饼图弧线路径。
+ * 不依赖任何外部库，也不依赖 DOM（可在 Node / 测试环境跑）。
+ */
+import { DEFAULT_PALETTE, type ChartOptions, type ChartSeries } from './types'
+
+/** XML/HTML 文本转义（防止类目/标题里的 & < > 破坏 SVG 结构） */
+export function escapeXml(s: string): string {
+  return String(s)
+    .replace(/&/g, '&amp;')
+    .replace(/</g, '&lt;')
+    .replace(/>/g, '&gt;')
+    .replace(/"/g, '&quot;')
+    .replace(/'/g, '&apos;')
+}
+
+/** 数值格式化：整数去小数，小数保留最多 2 位 */
+export function fmt(n: number): string {
+  if (!isFinite(n)) return ''
+  const r = Math.round(n * 100) / 100
+  return Number.isInteger(r) ? String(r) : String(r)
+}
+
+/**
+ * 计算「好看」的坐标轴上限：取数据最大值，向上取整到 1/2/5×10ⁿ 量级。
+ * 例如 max=73 → 80；max=250 → 300；max=0 → 1。
+ */
+export function niceMax(max: number): number {
+  if (max <= 0) return 1
+  const exp = Math.floor(Math.log10(max))
+  const base = Math.pow(10, exp)
+  const frac = max / base
+  let nice: number
+  if (frac <= 1) nice = 1
+  else if (frac <= 2) nice = 2
+  else if (frac <= 5) nice = 5
+  else nice = 10
+  return nice * base
+}
+
+/** 取序列颜色：显式 color 优先，否则按调色板顺序取 */
+export function seriesColor(series: ChartSeries, index: number, options?: ChartOptions): string {
+  if (series.color) return series.color
+  const palette = options?.palette ?? DEFAULT_PALETTE
+  return palette[index % palette.length]!
+}
+
+/**
+ * 极坐标 → 笛卡尔坐标。angleDeg 以「12 点方向为 0°、顺时针递增」表示，
+ * 与饼图扇区习惯一致。
+ */
+export function polar(cx: number, cy: number, r: number, angleDeg: number): { x: number; y: number } {
+  const theta = ((angleDeg - 90) * Math.PI) / 180
+  return { x: cx + r * Math.cos(theta), y: cy + r * Math.sin(theta) }
+}
+
+/**
+ * 饼图扇区路径（支持环形 donut）。
+ * @param startAngle 起始角（度，顺时针从 12 点起）
+ * @param endAngle   结束角（度）
+ * @param rInner     内半径（donut>0 时 >0）
+ */
+export function arcPath(
+  cx: number,
+  cy: number,
+  rOuter: number,
+  startAngle: number,
+  endAngle: number,
+  rInner = 0,
+): string {
+  const largeArc = endAngle - startAngle > 180 ? 1 : 0
+  // 整圆特例：单扇区 360° 用两段半圆弧画，否则 A 命令会因起止点重合而失效
+  if (endAngle - startAngle >= 359.999) {
+    const top = polar(cx, cy, rOuter, 0)
+    const bottom = polar(cx, cy, rOuter, 180)
+    let d = `M ${cx.toFixed(2)} ${cy.toFixed(2)} L ${top.x.toFixed(2)} ${top.y.toFixed(2)} A ${rOuter} ${rOuter} 0 1 1 ${bottom.x.toFixed(2)} ${bottom.y.toFixed(2)} A ${rOuter} ${rOuter} 0 1 1 ${top.x.toFixed(2)} ${top.y.toFixed(2)} Z`
+    if (rInner > 0) {
+      const itop = polar(cx, cy, rInner, 0)
+      const ibottom = polar(cx, cy, rInner, 180)
+      d += ` M ${cx.toFixed(2)} ${cy.toFixed(2)} L ${itop.x.toFixed(2)} ${itop.y.toFixed(2)} A ${rInner} ${rInner} 0 1 0 ${ibottom.x.toFixed(2)} ${ibottom.y.toFixed(2)} A ${rInner} ${rInner} 0 1 0 ${itop.x.toFixed(2)} ${itop.y.toFixed(2)} Z`
+    }
+    return d
+  }
+  const start = polar(cx, cy, rOuter, startAngle)
+  const end = polar(cx, cy, rOuter, endAngle)
+  // 环形：外弧(顺时针) + 内弧(逆时针) 组成闭合环段（不连圆心）
+  if (rInner > 0) {
+    const iStart = polar(cx, cy, rInner, startAngle)
+    const iEnd = polar(cx, cy, rInner, endAngle)
+    return (
+      `M ${start.x.toFixed(2)} ${start.y.toFixed(2)} A ${rOuter} ${rOuter} 0 ${largeArc} 1 ${end.x.toFixed(2)} ${end.y.toFixed(2)}` +
+      ` L ${iEnd.x.toFixed(2)} ${iEnd.y.toFixed(2)} A ${rInner} ${rInner} 0 ${largeArc} 0 ${iStart.x.toFixed(2)} ${iStart.y.toFixed(2)} Z`
+    )
+  }
+  // 实心饼：圆心 → 外起点 → 弧 → 圆心，形成真正到达圆心的楔形（修复"中间空白"）
+  return `M ${cx.toFixed(2)} ${cy.toFixed(2)} L ${start.x.toFixed(2)} ${start.y.toFixed(2)} A ${rOuter} ${rOuter} 0 ${largeArc} 1 ${end.x.toFixed(2)} ${end.y.toFixed(2)} Z`
+}
+
+/** 截断过长标签（设计期/运行期共用） */
+export function truncate(s: string, max = 12): string {
+  return s.length > max ? s.slice(0, max - 1) + '…' : s
+}
+
+/**
+ * 图例整体起始 x：left 直接用 leftPad；center/right 按单行总宽偏移。
+ * 单行假设（多数图例一行放得下）；若实际换行，仍从 startX 起排，整体观感一致。
+ */
+export function legendStartX(
+  align: 'left' | 'center' | 'right' | undefined,
+  W: number,
+  totalW: number,
+  leftPad: number,
+): number {
+  if (align === 'center') return Math.max(leftPad, (W - totalW) / 2)
+  if (align === 'right') return Math.max(leftPad, W - totalW - 8)
+  return leftPad
+}
diff --git a/openprint/src/core/chartkit/index.ts b/openprint/src/core/chartkit/index.ts
new file mode 100644
index 0000000..b67a24d
--- /dev/null
+++ b/openprint/src/core/chartkit/index.ts
@@ -0,0 +1,54 @@
+/**
+ * chartkit/index —— 对外统一入口
+ *
+ * - `renderChartSvg(model)`：纯函数，ChartModel → 可缩放 SVG 字符串。
+ * - `chartControlToModel(control)`：把设计器里的 ChartControl 协议对象转成 ChartModel
+ *   （补默认值、剔除非法字段），供设计期 overlay 与运行期导出共用。
+ * - `renderChartControl(control)`：一步到位，从 ChartControl 直接出 SVG 字符串。
+ *
+ * 整个模块零依赖、不碰 DOM，可在 Node / 测试环境运行。
+ */
+import type { ChartControl } from '../../types/control'
+import type { ChartKind, ChartModel, ChartSeries } from './types'
+import { renderBar } from './bar'
+import { renderLine } from './line'
+import { renderPie } from './pie'
+
+export type { ChartKind, ChartModel, ChartSeries, ChartOptions } from './types'
+export { DEFAULT_PALETTE } from './types'
+export { renderBar } from './bar'
+export { renderLine } from './line'
+export { renderPie } from './pie'
+
+export function renderChartSvg(model: ChartModel): string {
+  switch (model.kind) {
+    case 'bar':
+      return renderBar(model)
+    case 'line':
+      return renderLine(model)
+    case 'pie':
+      return renderPie(model)
+    default:
+      return ''
+  }
+}
+
+/** ChartControl（协议）→ ChartModel（渲染器输入），补齐缺省值 */
+export function chartControlToModel(c: ChartControl): ChartModel {
+  const series: ChartSeries[] = (c.series ?? []).map((s) => ({
+    name: s.name ?? '',
+    data: Array.isArray(s.data) ? s.data.filter((v) => typeof v === 'number' && isFinite(v)) : [],
+    color: s.color,
+  }))
+  return {
+    kind: c.kind,
+    categories: Array.isArray(c.categories) ? c.categories.map(String) : [],
+    series,
+    options: c.options,
+  }
+}
+
+/** 一步到位：ChartControl → 可缩放 SVG 字符串 */
+export function renderChartControl(control: ChartControl): string {
+  return renderChartSvg(chartControlToModel(control))
+}
diff --git a/openprint/src/core/chartkit/line.ts b/openprint/src/core/chartkit/line.ts
new file mode 100644
index 0000000..315657c
--- /dev/null
+++ b/openprint/src/core/chartkit/line.ts
@@ -0,0 +1,164 @@
+/**
+ * chartkit/line —— 折线图（零依赖 SVG）
+ *
+ * 多序列折线 + 坐标轴 + 可选网格 + 图例 + 数据标签。
+ * 支持 smooth（Catmull-Rom 平滑曲线）与 area（折线下方面积填充）。
+ */
+import { escapeXml, fmt, niceMax, seriesColor, truncate, legendStartX } from './core'
+import type { ChartModel } from './types'
+
+interface Pt { x: number; y: number }
+
+function smoothPath(pts: Pt[]): string {
+  if (pts.length < 2) return pts.length ? `M ${pts[0]!.x.toFixed(1)} ${pts[0]!.y.toFixed(1)}` : ''
+  let d = `M ${pts[0]!.x.toFixed(1)} ${pts[0]!.y.toFixed(1)}`
+  const t = 1 / 6
+  for (let i = 0; i < pts.length - 1; i++) {
+    const p0 = pts[i - 1] ?? pts[i]!
+    const p1 = pts[i]!
+    const p2 = pts[i + 1]!
+    const p3 = pts[i + 2] ?? p2
+    const c1x = p1.x + (p2.x - p0.x) * t
+    const c1y = p1.y + (p2.y - p0.y) * t
+    const c2x = p2.x - (p3.x - p1.x) * t
+    const c2y = p2.y - (p3.y - p1.y) * t
+    d += ` C ${c1x.toFixed(1)} ${c1y.toFixed(1)}, ${c2x.toFixed(1)} ${c2y.toFixed(1)}, ${p2.x.toFixed(1)} ${p2.y.toFixed(1)}`
+  }
+  return d
+}
+
+export function renderLine(model: ChartModel): string {
+  const opt = model.options ?? {}
+  const W = opt.width ?? 480
+  const H = opt.height ?? 320
+  const title = opt.title
+  const showAxis = opt.showAxis ?? true
+  const showGrid = opt.showGrid ?? true
+  const showLegend = opt.showLegend ?? model.series.length > 1
+  const valueLabel = opt.valueLabel ?? false
+  const smooth = opt.smooth ?? false
+  const area = opt.area ?? false
+
+  const legendH = showLegend ? 22 : 0
+  const titleH = title ? 22 : 0
+  const mTop = 10 + titleH
+  const mRight = 16
+  const mBottom = (showAxis ? 42 : 22) + legendH
+  const mLeft = showAxis ? 44 : 16
+
+  const px0 = mLeft
+  const py0 = mTop
+  const px1 = W - mRight
+  const py1 = H - mBottom
+  const plotW = Math.max(1, px1 - px0)
+  const plotH = Math.max(1, py1 - py0)
+
+  const cats = model.categories.length
+    ? model.categories
+    : (model.series[0]?.data ?? []).map((_, i) => String(i + 1))
+  const n = cats.length
+
+  const allVals: number[] = []
+  for (const s of model.series) for (const v of s.data) if (isFinite(v)) allVals.push(v)
+  if (model.series.length === 0 || n === 0 || allVals.length === 0) {
+    return placeholder(W, H, '暂无数据')
+  }
+
+  const yMax = niceMax(Math.max(0, ...allVals))
+  const band = plotW / Math.max(1, n)
+
+  // 预计算每序列的每个点
+  const seriesPts = model.series.map((s, si) => {
+    const color = seriesColor(s, si, opt)
+    const pts: Pt[] = []
+    for (let c = 0; c < n; c++) {
+      const val = s.data[c] ?? 0
+      const x = n > 1 ? px0 + band * (c + 0.5) : (px0 + px1) / 2
+      const y = py1 - (Math.max(0, val) / yMax) * plotH
+      pts.push({ x, y })
+    }
+    return { color, pts, name: s.name }
+  })
+
+  const parts: string[] = []
+  parts.push(`<svg xmlns="http://www.w3.org/2000/svg" width="100%" height="100%" viewBox="0 0 ${W} ${H}" preserveAspectRatio="xMidYMid meet" font-family="'SourceHanSerifCN', 'PingFang SC', 'Microsoft YaHei', sans-serif">`)
+
+  if (title) {
+    parts.push(`<text x="${W / 2}" y="${16}" text-anchor="middle" font-size="13" font-weight="600" fill="#1f2329">${escapeXml(title)}</text>`)
+  }
+
+  if (showAxis) {
+    const ticks = 4
+    for (let i = 0; i <= ticks; i++) {
+      const v = (yMax / ticks) * i
+      const y = py1 - (v / yMax) * plotH
+      if (showGrid && i > 0) {
+        parts.push(`<line x1="${px0}" y1="${y.toFixed(1)}" x2="${px1}" y2="${y.toFixed(1)}" stroke="#EEEEEE" stroke-width="1"/>`)
+      }
+      parts.push(`<text x="${px0 - 6}" y="${(y + 3).toFixed(1)}" text-anchor="end" font-size="11" fill="#000000">${fmt(v)}</text>`)
+    }
+    parts.push(`<line x1="${px0}" y1="${py0}" x2="${px0}" y2="${py1}" stroke="#cccccc" stroke-width="1"/>`)
+    parts.push(`<line x1="${px0}" y1="${py1}" x2="${px1}" y2="${py1}" stroke="#cccccc" stroke-width="1"/>`)
+    for (let c = 0; c < n; c++) {
+      const x = px0 + band * (c + 0.5)
+      // x 轴类目标签：始终以类目为基准居中于对应点正下方，并与图表留一点间距
+      parts.push(`<text x="${x.toFixed(1)}" y="${(py1 + 18).toFixed(1)}" text-anchor="middle" font-size="10" fill="#5a6068">${escapeXml(truncate(String(cats[c] ?? '')))}</text>`)
+    }
+  }
+
+  for (const sp of seriesPts) {
+    if (area && sp.pts.length > 1) {
+      let d = smooth ? smoothPath(sp.pts) : `M ${sp.pts.map((p) => `${p.x.toFixed(1)} ${p.y.toFixed(1)}`).join(' L ')}`
+      const last = sp.pts[sp.pts.length - 1]!
+      const first = sp.pts[0]!
+      d += ` L ${last.x.toFixed(1)} ${py1} L ${first.x.toFixed(1)} ${py1} Z`
+      parts.push(`<path d="${d}" fill="${sp.color}" fill-opacity="0.15"/>`)
+    }
+    const lineD = smooth ? smoothPath(sp.pts) : (sp.pts.length ? `M ${sp.pts.map((p) => `${p.x.toFixed(1)} ${p.y.toFixed(1)}`).join(' L ')}` : '')
+    if (lineD) parts.push(`<path d="${lineD}" fill="none" stroke="${sp.color}" stroke-width="2" stroke-linejoin="round" stroke-linecap="round"/>`)
+    for (const p of sp.pts) {
+      parts.push(`<circle cx="${p.x.toFixed(1)}" cy="${p.y.toFixed(1)}" r="2.5" fill="#ffffff" stroke="${sp.color}" stroke-width="1.6"/>`)
+    }
+  }
+  if (valueLabel) {
+    for (let si = 0; si < seriesPts.length; si++) {
+      const sp = seriesPts[si]!
+      const series = model.series[si]!
+      for (let c = 0; c < sp.pts.length; c++) {
+        const v = series.data[c] ?? 0
+        parts.push(`<text x="${sp.pts[c]!.x.toFixed(1)}" y="${(sp.pts[c]!.y - 6).toFixed(1)}" text-anchor="middle" font-size="10" fill="#000000">${fmt(v)}</text>`)
+      }
+    }
+  }
+
+  if (showLegend) {
+    const align = opt.labelAlign ?? 'center'
+    let totalW = 0
+    for (let s = 0; s < seriesPts.length; s++) {
+      const name = seriesPts[s]!.name || `系列${s + 1}`
+      totalW += 16 + name.length * 12 + 18
+    }
+    const startX = legendStartX(align, W, totalW, px0)
+    let lx = startX
+    let ly = py1 + (showAxis ? 40 : 16)
+    for (let s = 0; s < seriesPts.length; s++) {
+      const name = seriesPts[s]!.name || `系列${s + 1}`
+      const color = seriesPts[s]!.color
+      const itemW = 16 + name.length * 12 + 18
+      if (lx + itemW > W - 8 && lx > startX) {
+        lx = startX
+        ly += 16
+      }
+      parts.push(`<rect x="${lx}" y="${ly - 9}" width="11" height="11" rx="2" fill="${color}"/>`)
+      parts.push(`<text x="${lx + 15}" y="${ly}" font-size="11" fill="#000000">${escapeXml(truncate(name, 10))}</text>`)
+      lx += itemW
+    }
+  }
+
+  parts.push('</svg>')
+  return parts.join('')
+}
+
+function placeholder(W: number, H: number, text: string): string {
+  return `<svg xmlns="http://www.w3.org/2000/svg" width="100%" height="100%" viewBox="0 0 ${W} ${H}" preserveAspectRatio="xMidYMid meet"><text x="${W / 2}" y="${H / 2}" text-anchor="middle" font-size="13" fill="#bbbbbb">${escapeXml(text)}</text></svg>`
+}
diff --git a/openprint/src/core/chartkit/pie.ts b/openprint/src/core/chartkit/pie.ts
new file mode 100644
index 0000000..3fe9cfd
--- /dev/null
+++ b/openprint/src/core/chartkit/pie.ts
@@ -0,0 +1,100 @@
+/**
+ * chartkit/pie —— 饼图 / 环形图（零依赖 SVG）
+ *
+ * 用 arcPath 画每个扇区（或环形），标签显示类目+百分比，底部可选图例。
+ * 饼图通常只用 series[0]（每个数据点 = 一个扇区）。
+ */
+import { arcPath, escapeXml, seriesColor, truncate, legendStartX } from './core'
+import { DEFAULT_PALETTE } from './types'
+import type { ChartModel } from './types'
+
+export function renderPie(model: ChartModel): string {
+  const opt = model.options ?? {}
+  const W = opt.width ?? 480
+  const H = opt.height ?? 320
+  const title = opt.title
+  const showLegend = opt.showLegend ?? true
+  const donut = opt.donut ?? false
+  const valueLabel = opt.valueLabel ?? true
+
+  const legendH = showLegend ? 24 : 0
+  const titleH = title ? 22 : 0
+
+  const cats = model.categories.length
+    ? model.categories
+    : (model.series[0]?.data ?? []).map((_, i) => `类目${i + 1}`)
+  const data = (model.series[0]?.data ?? []).filter((v) => isFinite(v))
+  const total = data.reduce((a, b) => a + Math.max(0, b), 0)
+  if (data.length === 0 || total <= 0) {
+    return placeholder(W, H, '暂无数据')
+  }
+
+  const cx = W / 2
+  const cy = titleH + (H - titleH - legendH) / 2
+  const rOuter = (Math.min(W * 0.82, H - titleH - legendH) / 2) * 0.92
+  const rInner = donut ? rOuter * 0.56 : 0
+
+  const palette = opt.palette ?? DEFAULT_PALETTE
+  const parts: string[] = []
+  parts.push(`<svg xmlns="http://www.w3.org/2000/svg" width="100%" height="100%" viewBox="0 0 ${W} ${H}" preserveAspectRatio="xMidYMid meet" font-family="'SourceHanSerifCN', 'PingFang SC', 'Microsoft YaHei', sans-serif">`)
+
+  if (title) {
+    parts.push(`<text x="${W / 2}" y="${16}" text-anchor="middle" font-size="13" font-weight="600" fill="#1f2329">${escapeXml(title)}</text>`)
+  }
+
+  let angle = 0
+  for (let i = 0; i < data.length; i++) {
+    const v = Math.max(0, data[i]!)
+    if (v <= 0) continue
+    const sweep = (v / total) * 360
+    const start = angle
+    const end = angle + sweep
+    angle = end
+    const color = seriesColor({ name: cats[i] ?? '', data: [] }, i, opt)
+    parts.push(`<path d="${arcPath(cx, cy, rOuter, start, end, rInner)}" fill="${color}" stroke="#ffffff" stroke-width="1"/>`)
+    // 百分比标签
+    if (valueLabel && sweep > 12) {
+      const mid = (start + end) / 2
+      const lr = donut ? (rOuter + rInner) / 2 : rOuter * 0.62
+      const p = polarL(lr, mid)
+      const pct = ((v / total) * 100).toFixed(0) + '%'
+      parts.push(`<text x="${p.x.toFixed(1)}" y="${(p.y + 3).toFixed(1)}" text-anchor="middle" font-size="11" fill="#ffffff" font-weight="600">${pct}</text>`)
+    }
+  }
+
+  if (showLegend) {
+    const align = opt.labelAlign ?? 'center'
+    let totalW = 0
+    for (let i = 0; i < data.length; i++) {
+      const name = cats[i] ?? `类目${i + 1}`
+      totalW += 16 + name.length * 12 + 18
+    }
+    const startX = legendStartX(align, W, totalW, 12)
+    let lx = startX
+    let ly = H - legendH + 12
+    for (let i = 0; i < data.length; i++) {
+      const name = cats[i] ?? `类目${i + 1}`
+      const color = seriesColor({ name, data: [] }, i, opt)
+      const itemW = 16 + name.length * 12 + 18
+      if (lx + itemW > W - 8 && lx > startX) {
+        lx = startX
+        ly += 16
+      }
+      parts.push(`<rect x="${lx}" y="${ly - 9}" width="11" height="11" rx="2" fill="${color}"/>`)
+      parts.push(`<text x="${lx + 15}" y="${ly}" font-size="11" fill="#000000">${escapeXml(truncate(name, 10))}</text>`)
+      lx += itemW
+    }
+  }
+
+  parts.push('</svg>')
+  return parts.join('')
+
+  function polarL(r: number, angleDeg: number) {
+    const theta = ((angleDeg - 90) * Math.PI) / 180
+    return { x: cx + r * Math.cos(theta), y: cy + r * Math.sin(theta) }
+  }
+}
+
+function placeholder(W: number, H: number, text: string): string {
+  return `<svg xmlns="http://www.w3.org/2000/svg" width="100%" height="100%" viewBox="0 0 ${W} ${H}" preserveAspectRatio="xMidYMid meet"><text x="${W / 2}" y="${H / 2}" text-anchor="middle" font-size="13" fill="#bbbbbb">${escapeXml(text)}</text></svg>`
+}
diff --git a/openprint/src/core/chartkit/types.ts b/openprint/src/core/chartkit/types.ts
new file mode 100644
index 0000000..00430d9
--- /dev/null
+++ b/openprint/src/core/chartkit/types.ts
@@ -0,0 +1,72 @@
+/**
+ * chartkit —— OpenPrint 原生 SVG 图表组件（零依赖）
+ *
+ * 设计目标（见《OpenPrint-设计方案》图表控件提案）：
+ * - 打印设计器要的是**矢量**，不是 Canvas 位图。图表用纯 SVG 路径绘制，
+ *   导出 PDF/SVG 时整条链路都是矢量，任意缩放都清晰，且零运行时依赖。
+ * - 本模块是**纯函数 + 零依赖**的：输入 ChartModel，输出一段可缩放的 `<svg>` 字符串。
+ *   设计期 overlay 与运行期导出共用同一份产物，保证"设计即打印"。
+ *
+ * 支持的图表类型（v1）：条形图 bar / 折线图 line / 饼图 pie。
+ * 数据模型与渲染解耦，后续扩展（横向条形、面积、环形、堆叠等）只需加一个生成器。
+ */
+
+export type ChartKind = 'bar' | 'line' | 'pie'
+
+/** 一条数据序列（折线/条形的一组柱；饼图通常只用 series[0]） */
+export interface ChartSeries {
+  name: string
+  /** 与 ChartModel.categories 一一对应 */
+  data: number[]
+  /** 可选覆盖色；缺省走调色板 */
+  color?: string
+}
+
+/** 图表下方标签（x 轴类目 / 图例）的水平对齐方式 */
+export type ChartLabelAlign = 'left' | 'center' | 'right'
+
+export interface ChartOptions {
+  /** SVG 逻辑尺寸（px，仅决定 viewBox 比例；实际渲染按容器缩放）。默认 480×320 */
+  width?: number
+  height?: number
+  /** 图表主标题（绘制在顶部居中） */
+  title?: string
+  /** 显示图例（多序列时建议开） */
+  showLegend?: boolean
+  /** 显示坐标轴（条形/折线生效；饼图忽略） */
+  showAxis?: boolean
+  /** 显示网格线（条形/折线生效） */
+  showGrid?: boolean
+  /** 调色板（序列缺色时按顺序取） */
+  palette?: string[]
+  /** 折线是否平滑曲线 */
+  smooth?: boolean
+  /** 折线下方填充面积 */
+  area?: boolean
+  /** 饼图环形（中心镂空） */
+  donut?: boolean
+  /** 数据标签（柱顶数值 / 饼图百分比） */
+  valueLabel?: boolean
+  /** 下方标签（x 轴类目 / 图例）水平对齐，默认 left */
+  labelAlign?: ChartLabelAlign
+}
+
+export interface ChartModel {
+  kind: ChartKind
+  /** 类目轴标签（条形/折线为 x 轴；饼图为扇区名） */
+  categories: string[]
+  series: ChartSeries[]
+  options?: ChartOptions
+}
+
+/** 默认调色板（参考 AntV / ECharts 经典商务色，打印对比度足够） */
+export const DEFAULT_PALETTE = [
+  '#5B8FF9',
+  '#5AD8A6',
+  '#5D7092',
+  '#F6BD16',
+  '#E8684A',
+  '#6DC8EC',
+  '#9270CA',
+  '#FF9D4D',
+]
diff --git a/openprint/src/core/export-engine/chart-svg-to-path.ts b/openprint/src/core/export-engine/chart-svg-to-path.ts
new file mode 100644
index 0000000..c48bd70
--- /dev/null
+++ b/openprint/src/core/export-engine/chart-svg-to-path.ts
@@ -0,0 +1,85 @@
+/**
+ * chart-svg-to-path —— 把图表 SVG 里的 <text> 转成矢量 <path> 字形轮廓
+ *
+ * 背景：jsPDF 只能内嵌 TrueType(glyf) 字体，无法内嵌 CFF/OpenType 字体；
+ * 思源宋体 .ttf 实为 CFF，jsPDF 内嵌会静默失败 → 矢量图表中文标签变空白。
+ * 解决：在导出 PDF 的矢量路径里，用 opentype.js 把每个字形展开为 path，
+ * 文本即成为与字体无关的矢量轮廓，svg2pdf 直接画 path，中文不再丢。
+ *
+ * 仅 export-pdf 的图表矢量路径按需动态调用，不进主包、不影响设计期/预览。
+ */
+const SERIF_TTF_URL = '/fonts/SourceHanSerifCN-Regular.ttf'
+
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+let fontPromise: Promise<any> | null = null
+
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+async function loadFont(): Promise<any | null> {
+  if (!fontPromise) {
+    fontPromise = (async () => {
+      try {
+        const res = await fetch(SERIF_TTF_URL)
+        if (!res.ok) return null
+        const buf = await res.arrayBuffer()
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const ot: any = await import('opentype.js')
+        const parse = ot.parse ?? ot.default?.parse ?? ot.default
+        return parse(buf)
+      } catch {
+        return null
+      }
+    })()
+  }
+  return fontPromise
+}
+
+/**
+ * 把图表 SVG 字符串里的所有 <text> 替换为字形轮廓 <path>。
+ * 字体加载失败/解析异常时原样返回（交给 svg2pdf，最坏情况该页走栅格兜底）。
+ */
+export async function outlineChartSvgText(svg: string): Promise<string> {
+  const font = await loadFont()
+  if (!font) return svg
+
+  const doc = new DOMParser().parseFromString(svg, 'image/svg+xml')
+  const svgEl = doc.documentElement
+  if (!svgEl || svgEl.nodeName.toLowerCase() !== 'svg') return svg
+
+  const texts = Array.from(svgEl.getElementsByTagName('text'))
+  for (const t of texts) {
+    const text = t.textContent ?? ''
+    if (!text) {
+      t.remove()
+      continue
+    }
+    const x = parseFloat(t.getAttribute('x') ?? '0') || 0
+    const y = parseFloat(t.getAttribute('y') ?? '0') || 0
+    const fontSize = parseFloat(t.getAttribute('font-size') ?? '10') || 10
+    const fill = t.getAttribute('fill') || '#000000'
+    const anchor = (t.getAttribute('text-anchor') || 'start').toLowerCase()
+
+    const scale = fontSize / font.unitsPerEm
+    const total = font.getAdvanceWidth(text, fontSize)
+    let startX = x
+    if (anchor === 'middle') startX = x - total / 2
+    else if (anchor === 'end') startX = x - total
+
+    const ds: string[] = []
+    let cursor = startX
+    for (const ch of text) {
+      const g = font.charToGlyph(ch)
+      if (!g) continue
+      const gp = g.getPath(cursor, y, fontSize)
+      const d = gp.toPathData(2)
+      if (d && d.trim()) ds.push(d)
+      cursor += (g.advanceWidth || 0) * scale
+    }
+
+    const path = doc.createElementNS('http://www.w3.org/2000/svg', 'path')
+    path.setAttribute('d', ds.join(' '))
+    path.setAttribute('fill', fill)
+    if (t.parentNode) t.parentNode.replaceChild(path, t)
+  }
+
+  return new XMLSerializer().serializeToString(svgEl)
+}
diff --git a/openprint/src/core/export-engine/export-image.ts b/openprint/src/core/export-engine/export-image.ts
new file mode 100644
index 0000000..7c3f385
--- /dev/null
+++ b/openprint/src/core/export-engine/export-image.ts
@@ -0,0 +1,13 @@
+/**
+ * 位图导出（JPG）—— 基于 rasterize 的单页位图
+ */
+import type { LayoutResult } from '@/core/layout-engine/types'
+import { pageToImageBlob, type PageImageOptions } from './rasterize'
+
+export function pageToJpg(
+  result: LayoutResult,
+  index: number,
+  opts: PageImageOptions = {},
+): Promise<Blob> {
+  return pageToImageBlob(result, index, { type: 'image/jpeg', ...opts })
+}
diff --git a/openprint/src/core/export-engine/export-pdf.spec.ts b/openprint/src/core/export-engine/export-pdf.spec.ts
new file mode 100644
index 0000000..e8594e8
--- /dev/null
+++ b/openprint/src/core/export-engine/export-pdf.spec.ts
@@ -0,0 +1,53 @@
+import { describe, expect, it, vi } from 'vitest'
+
+// 真实环境无法在 happy-dom 中栅格化 SVG foreignObject，也不应让 jsPDF 读本地文件。
+// 这里 mock 栅格化下层 + Blob→dataURL，只验证 documentToPdf 的 jsPDF 装配。
+// （写死思源宋体的内联逻辑在 export-pdf.ts 内由 PDF_FONTS 常量体现，随代码审查保证。）
+vi.mock('@/core/export-engine/rasterize', () => ({
+  pageToImageBlob: vi.fn(async () => {
+    const b64 =
+      'iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk+M9QDwADhgGAWjR9awAAAABJRU5ErkJggg=='
+    const bin = atob(b64)
+    const bytes = new Uint8Array(bin.length)
+    for (let i = 0; i < bin.length; i++) bytes[i] = bin.charCodeAt(i)
+    return new Blob([bytes], { type: 'image/png' })
+  }),
+}))
+
+vi.mock('@/core/export-engine/util', () => ({
+  blobToDataURL: vi.fn(async () => {
+    // 直接返回合法 PNG data URI，避开 happy-dom 的 FileReader/fs-read 限制
+    return 'data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk+M9QDwADhgGAWjR9awAAAABJRU5ErkJggg=='
+  }),
+}))
+
+import { documentToPdf } from '@/core/export-engine/export-pdf'
+import { layout } from '@/core/layout-engine/pagination-engine'
+import { createDemoTemplate } from '@/repository/mock/data/demo-template'
+import { createCjkMeasurer } from '@/core/__tests__/cjk-measurer'
+
+function makeData(rows: number): Record<string, unknown> {
+  const items = Array.from({ length: rows }, (_, i) => {
+    const qty = (i % 5) + 1
+    return {
+      productCode: `P${String(i + 1).padStart(4, '0')}`,
+      productName: `商品${i + 1}`,
+      spec: '规格A',
+      unit: '件',
+      qty,
+      price: 10,
+      amount: qty * 10,
+    }
+  })
+  return { order: { orderNo: 'SO-001' }, customer: { name: '客户' }, items }
+}
+
+describe('documentToPdf —— 位图 PDF 装配（jsPDF）', () => {
+  it('多页模板产出单文件多页 PDF blob', async () => {
+    const result = await layout(createDemoTemplate(), makeData(30), { measurer: createCjkMeasurer() })
+    const blob = await documentToPdf(result, { scale: 2 })
+    expect(blob).toBeInstanceOf(Blob)
+    expect(blob.type).toBe('application/pdf')
+    expect(blob.size).toBeGreaterThan(0)
+  })
+})
diff --git a/openprint/src/core/export-engine/export-pdf.ts b/openprint/src/core/export-engine/export-pdf.ts
new file mode 100644
index 0000000..1b6429b
--- /dev/null
+++ b/openprint/src/core/export-engine/export-pdf.ts
@@ -0,0 +1,208 @@
+/**
+ * PDF 导出 —— jsPDF 动态 import（不进主包）
+ *
+ * ## 位图底图默认 PNG（无损 · 最清晰）
+ * 早期为压体积改过 JPEG，但纯文字/线条在白底上即使 quality=1 也会被 8×8 DCT
+ * 引入极轻环状伪影，300dpi 打印放大后边缘发虚、不如 PNG 锐利。
+ * 现回归 PNG（无损）：以体积换清晰度，导出/打印文字边缘真正锐利。
+ * 体积敏感场景可传 `imageType: 'jpeg'`，但默认走 PNG 保清晰。
+ *
+ * ## 图表走矢量（svg2pdf）
+ * 设计器一切以 SVG 为真相源。为让图表在 PDF 里达到「印刷级矢量」：
+ * 1. 每页先**剥离 chart 控件** → 栅格化（文本/表格位图底图）→ addImage 作背景；
+ * 2. 再遍历该页 chart 节点，把 SVG 里的 `<text>` 用 opentype.js 展开为**矢量字形轮廓**，
+ *    再用 `svg2pdf` 把其 SVG 以**矢量**注入 jsPDF 对应 mm 盒；
+ *    （关键：jsPDF 只能内嵌 TrueType 字体、无法内嵌 CFF/OpenType，而思源宋体恰为 CFF，
+ *     直接注册会静默失败导致中文标签空白——转轮廓后文字与字体完全解耦，中文必现。）
+ *
+ * 兜底：
+ * - 图表被旋转 → 整页退回旧的全栅格化（旋转在矢量叠加里不易对齐）；
+ * - 单个图表矢量失败/字形展开失败 → 该图表单独栅格化后叠加（图表保持 PNG 以保边缘锐利）；
+ * - 整页矢量叠加彻底失败 → 整页退回全栅格化（仍是位图，但保证有图）。
+ *
+ * 非图表页（无 chart 控件）仍走原全栅格化位图路径，行为与旧版一致。
+ */
+import type { LayoutResult, LayoutPage, PlacedNode, PlacedControl } from '@/core/layout-engine/types'
+import { pageToImageBlob, buildPageSvg, svgToCanvas } from './rasterize'
+import { embedFontsInSvg, type FontFaceDef } from './fonts'
+import type { PageDecoration } from '@/types/template'
+import { blobToDataURL } from './util'
+import { mmv } from '@/core/renderer-html/css-generator'
+import { outlineChartSvgText } from './chart-svg-to-path'
+
+/** 思源宋体 —— 位图底图（含非图表文本）内联字体，保证中文衬线效果 */
+const PDF_FONTS: FontFaceDef[] = [
+  { family: '思源宋体', src: '/fonts/SourceHanSerifCN-Regular.ttf', weight: 400 },
+]
+
+export interface PdfOptions {
+  /** 高清倍率，1=96dpi / 2=192dpi / 3=288dpi（默认·最高清），可传 4 更锐 */
+  scale?: number
+  /** 页面装饰（背景色 + 水印），使 PDF 与预览一致 */
+  pageDecoration?: PageDecoration
+  /**
+   * 位图底图的压缩格式（默认 `'png'`，无损最清晰）：
+   * - `'png'`：无损，文字/线条边缘真正锐利，打印推荐；体积较大（纯文字页 ~10+ MB）。
+   * - `'jpeg'`：体积小（~1-2 MB），仅体积敏感场景使用，清晰度略逊于 PNG。
+   * 图表矢量叠加路径不受影响（图表本身走 svg2pdf 矢量注入）。
+   */
+  imageType?: 'jpeg' | 'png'
+}
+
+/** 把 PdfOptions 的 imageType 解析成 canvas.toBlob 的 MIME 与 addImage 的格式名 */
+function imgSpec(imageType: 'jpeg' | 'png'): { mime: 'image/jpeg' | 'image/png'; addImageFmt: 'JPEG' | 'PNG' } {
+  return imageType === 'png'
+    ? { mime: 'image/png', addImageFmt: 'PNG' }
+    : { mime: 'image/jpeg', addImageFmt: 'JPEG' }
+}
+
+function isChartNode(n: PlacedNode): n is PlacedControl {
+  return n.kind === 'control' && (n as PlacedControl).control.type === 'chart'
+}
+
+/** 返回去掉所有 chart 控件后的页面副本（不影响原对象） */
+function stripCharts(page: LayoutPage): LayoutPage {
+  const f = <T extends PlacedNode>(nodes: T[]): T[] => nodes.filter((n) => !isChartNode(n)) as T[]
+  return { ...page, header: f(page.header), body: f(page.body), footer: f(page.footer) }
+}
+
+interface ChartBox {
+  left: number
+  top: number
+  width: number
+  height: number
+  angle: number
+  svg: string
+}
+
+/** 收集页面内所有 chart 控件（含其 mm 盒与 SVG） */
+function chartsOf(page: LayoutPage): ChartBox[] {
+  const out: ChartBox[] = []
+  for (const sec of [page.header, page.body, page.footer]) {
+    for (const n of sec) {
+      if (!isChartNode(n)) continue
+      const c = n as PlacedControl
+      if (c.content.kind !== 'svg') continue
+      out.push({
+        left: n.left,
+        top: n.top,
+        width: n.width,
+        height: n.height,
+        angle: n.angle ?? 0,
+        svg: c.content.svg,
+      })
+    }
+  }
+  return out
+}
+
+/** 单图表栅格化（svg2pdf 失败时的兜底，保证不丢图） */
+async function rasterizeChart(chartSvg: string, wMm: number, hMm: number, scale: number): Promise<string> {
+  const inner = `<div style="width:${mmv(wMm)};height:${mmv(hMm)};overflow:hidden">${chartSvg}</div>`
+  let svg = buildPageSvg(inner, '', wMm, hMm)
+  svg = await embedFontsInSvg(svg, PDF_FONTS)
+  const canvas = await svgToCanvas(svg, scale, '#ffffff')
+  const blob = await new Promise<Blob | null>((resolve) => canvas.toBlob((b) => resolve(b), 'image/png'))
+  if (!blob) throw new Error('图表栅格化失败')
+  return blobToDataURL(blob)
+}
+
+/** SVG 字符串 → 挂到 DOM 的 SVGSVGElement（svg2pdf 需要真实节点以读取几何） */
+function svgElementFromString(str: string): SVGSVGElement {
+  const doc = new DOMParser().parseFromString(str, 'image/svg+xml')
+  return doc.documentElement as unknown as SVGSVGElement
+}
+
+export async function documentToPdf(result: LayoutResult, opts: PdfOptions = {}): Promise<Blob> {
+  const mod = await import('jspdf')
+  const JsPDF = (mod as unknown as { jsPDF?: typeof mod.default; default: typeof mod.default }).jsPDF ?? mod.default
+  const { pageWidth: w, pageHeight: h } = result.metrics
+  const orientation = w > h ? 'landscape' : 'portrait'
+  const scale = opts.scale ?? 3
+  const imageType: 'jpeg' | 'png' = opts.imageType ?? 'png'
+  const { addImageFmt } = imgSpec(imageType)
+
+  const doc = new JsPDF({ unit: 'mm', format: [w, h], orientation })
+
+  for (let i = 0; i < result.pages.length; i++) {
+    if (i > 0) doc.addPage([w, h], orientation)
+
+    const page = result.pages[i]!
+    const charts = chartsOf(page)
+    // 有图表且该页图表都未旋转 → 走矢量；否则全栅格化（含图表）
+    const useVector = charts.length > 0 && charts.every((c) => c.angle === 0)
+
+    if (!useVector) {
+      const dataUrl = await rasterizePageFull(result, i, scale, opts.pageDecoration, imageType)
+      doc.addImage(dataUrl, addImageFmt, 0, 0, w, h)
+      continue
+    }
+
+    // 矢量路径：先栅格化"剥掉图表"的底图，再把图表以矢量叠加（文字已转轮廓，无需内嵌字体）
+    const strippedResult: LayoutResult = {
+      ...result,
+      pages: result.pages.map((p, idx) => (idx === i ? stripCharts(p) : p)),
+    }
+    const baseUrl = await rasterizePageFull(strippedResult, i, scale, opts.pageDecoration, imageType)
+    doc.addImage(baseUrl, addImageFmt, 0, 0, w, h)
+
+    let allVectorOk = true
+    for (const ch of charts) {
+      try {
+        // 字形转轮廓：把 <text> 展开为矢量 path，避免 jsPDF 无法内嵌 CFF 字体导致中文空白
+        const outlinedSvg = await outlineChartSvgText(ch.svg)
+        const el = svgElementFromString(outlinedSvg)
+        el.style.position = 'absolute'
+        el.style.left = '-99999px'
+        el.style.top = '0'
+        document.body.appendChild(el)
+        try {
+          const { svg2pdf } = await import('svg2pdf.js')
+          await svg2pdf(el, doc, { x: ch.left, y: ch.top, width: ch.width, height: ch.height })
+        } finally {
+          document.body.removeChild(el)
+        }
+      } catch {
+        // 该图表矢量失败 → 单独栅格化兜底（图表保持 PNG 以保边缘锐利，体积可控）
+        try {
+          const img = await rasterizeChart(ch.svg, ch.width, ch.height, scale)
+          doc.addImage(img, 'PNG', ch.left, ch.top, ch.width, ch.height)
+        } catch {
+          allVectorOk = false
+        }
+      }
+    }
+
+    // 兜底：若整页矢量叠加彻底失败，重渲染该页（含图表）作位图背景
+    if (!allVectorOk) {
+      // 当前页已 addImage 了"剥图底图"，需替换为含图表的整页位图。
+      // 顺序处理下最后一页动作即本页，删除后重建即可，不影响其它页。
+      const pageCount = doc.getNumberOfPages()
+      doc.deletePage(pageCount)
+      doc.addPage([w, h], orientation)
+      const fallback = await rasterizePageFull(result, i, scale, opts.pageDecoration, imageType)
+      doc.addImage(fallback, addImageFmt, 0, 0, w, h)
+    }
+  }
+
+  return doc.output('blob')
+}
+
+/** 整页栅格化（含图表），封装原 pageToImageBlob 调用 */
+async function rasterizePageFull(
+  result: LayoutResult,
+  index: number,
+  scale: number,
+  pageDecoration: PageDecoration | undefined,
+  imageType: 'jpeg' | 'png',
+): Promise<string> {
+  const { mime } = imgSpec(imageType)
+  const blob = await pageToImageBlob(result, index, {
+    type: mime,
+    scale,
+    background: pageDecoration?.backgroundColor ?? '#ffffff',
+    fonts: PDF_FONTS,
+    pageDecoration,
+  })
+  return blobToDataURL(blob)
+}
diff --git a/openprint/src/core/export-engine/export-svg.spec.ts b/openprint/src/core/export-engine/export-svg.spec.ts
new file mode 100644
index 0000000..e6b0ad2
--- /dev/null
+++ b/openprint/src/core/export-engine/export-svg.spec.ts
@@ -0,0 +1,43 @@
+import { describe, expect, it } from 'vitest'
+
+import { layout } from '@/core/layout-engine/pagination-engine'
+import { documentToSvgString } from '@/core/export-engine/export-svg'
+import { mmToPx } from '@/core/units'
+import { createDemoTemplate } from '@/repository/mock/data/demo-template'
+import { createCjkMeasurer } from '@/core/__tests__/cjk-measurer'
+
+function makeData(rows: number): Record<string, unknown> {
+  const items = Array.from({ length: rows }, (_, i) => {
+    const qty = (i % 5) + 1
+    const price = 10 + (i % 9)
+    return {
+      productCode: `P${String(i + 1).padStart(4, '0')}`,
+      productName: `商品${i + 1}`,
+      spec: '规格A',
+      unit: '件',
+      qty,
+      price,
+      amount: qty * price,
+    }
+  })
+  return { order: { orderNo: 'SO-001' }, customer: { name: '客户' }, items }
+}
+
+describe('documentToSvgString —— 多页矢量 SVG', () => {
+  it('产出多页堆叠合法 SVG（foreignObject + 中文 + 精确像素）', async () => {
+    const template = createDemoTemplate()
+    const result = await layout(template, makeData(30), { measurer: createCjkMeasurer() })
+    const svg = await documentToSvgString(result)
+
+    expect(svg).toContain('<foreignObject')
+    // 多页 → 多个嵌套 <svg x=...>
+    expect((svg.match(/<svg x=/g) || []).length).toBe(result.pages.length)
+
+    // 像素尺寸 794×1123（210×297mm × 3.7795 ≈ 793.8/1122.7 → 794/1123）
+    const w = Math.round(mmToPx(210))
+    expect(w).toBe(794)
+    expect(svg).toContain(`width="${w}"`)
+
+    expect(svg).toContain('销售出库单')
+  })
+})
diff --git a/openprint/src/core/export-engine/export-svg.ts b/openprint/src/core/export-engine/export-svg.ts
new file mode 100644
index 0000000..6e0eef3
--- /dev/null
+++ b/openprint/src/core/export-engine/export-svg.ts
@@ -0,0 +1,50 @@
+/**
+ * SVG 矢量导出 —— 把多页 HTML 直接包进嵌套 <svg><foreignObject>
+ *
+ * 产物是单文件、多页纵向堆叠的 SVG（每页一个 `<svg x y>`），
+ * 浏览器 / Inkscape / 矢量软件都能打开，且因为是同一份 HTML+CSS，
+ * 与预览、PDF、打印视觉完全一致。
+ */
+import { mmToPx } from '@/core/units'
+import { renderPage, generateCss } from '@/core/renderer-html'
+import type { LayoutResult } from '@/core/layout-engine/types'
+import type { PageDecoration } from '@/types/template'
+import { toXmlSafe } from './rasterize'
+import { embedFontsInSvg, type FontFaceDef } from './fonts'
+
+export async function documentToSvgString(
+  result: LayoutResult,
+  fonts?: FontFaceDef[],
+  pageDecoration?: PageDecoration,
+): Promise<string> {
+  const { pageWidth, pageHeight } = result.metrics
+  const w = Math.max(1, Math.ceil(mmToPx(pageWidth)))
+  const h = Math.max(1, Math.ceil(mmToPx(pageHeight)))
+  const css = generateCss(result.metrics, { screen: false, pageDecoration })
+
+  const pages = result.pages
+    .map((page, i) => {
+      const safe = toXmlSafe(renderPage(page, pageDecoration?.watermark))
+      const inner =
+        `<div xmlns="http://www.w3.org/1999/xhtml">` +
+        `<style>${css}</style>` +
+        `<div class="op-doc"><div class="op-page-wrap">${safe}</div></div>` +
+        `</div>`
+      return (
+        `<svg x="0" y="${i * h}" width="${w}" height="${h}">` +
+        `<foreignObject x="0" y="0" width="${w}" height="${h}">${inner}</foreignObject>` +
+        `</svg>`
+      )
+    })
+    .join('\n')
+
+  const totalH = h * result.pages.length
+  let svg = (
+    `<svg xmlns="http://www.w3.org/2000/svg" width="${w}" height="${totalH}" viewBox="0 0 ${w} ${totalH}">` +
+    `<rect x="0" y="0" width="${w}" height="${totalH}" fill="#ffffff"/>` +
+    pages +
+    `</svg>`
+  )
+  if (fonts?.length) svg = await embedFontsInSvg(svg, fonts)
+  return svg
+}
diff --git a/openprint/src/core/export-engine/fonts.ts b/openprint/src/core/export-engine/fonts.ts
new file mode 100644
index 0000000..17e135d
--- /dev/null
+++ b/openprint/src/core/export-engine/fonts.ts
@@ -0,0 +1,103 @@
+/**
+ * 字体嵌入工具 —— 让栅格化产物（PNG / JPG / PDF）与矢量 SVG / 无头打印 HTML 也能用上「自定义字体」。
+ *
+ * ## 为什么需要它
+ * - 预览 / 浏览器打印：字体由主文档或 iframe 的 `@font-face` 提供，正常生效。
+ * - 但 PNG/JPG/PDF 走 `SVG <foreignObject>` 光栅化，而 `<img>` 加载的 SVG 是**隔离上下文**，
+ *   看不到父文档的 `@font-face`，只能用系统字体（PingFang SC / 系统 sans-serif 兜底）。
+ *   若模板指定了「思源宋体」等自定义字体，栅格化产物会丢字体。
+ * - 解法：把字体以 `@font-face(data-URI)` 直接写进 SVG / HTML 本身，隔离上下文也能用。
+ *
+ * 仅当 `fonts` 显式传入才做网络读取（同源本地字体），默认不联网，符合零网络铁律。
+ */
+export interface FontFaceDef {
+  /** 字体族名，必须与模板 CSS 中的 font-family 一致 */
+  family: string
+  /** 同源字体文件 URL（.woff2 / .ttf / .otf / .woff） */
+  src: string
+  weight?: string | number
+  style?: string
+}
+
+function fontFormat(src: string): string {
+  const ext = (src.split('?')[0] ?? '').split('.').pop()?.toLowerCase()
+  if (ext === 'ttf') return 'truetype'
+  if (ext === 'otf') return 'opentype'
+  if (ext === 'woff2') return 'woff2'
+  if (ext === 'eot') return 'embedded-opentype'
+  return 'woff'
+}
+
+function fontMime(src: string): string {
+  const ext = (src.split('?')[0] ?? '').split('.').pop()?.toLowerCase()
+  if (ext === 'ttf') return 'font/ttf'
+  if (ext === 'otf') return 'font/otf'
+  if (ext === 'eot') return 'application/vnd.ms-fontobject'
+  if (ext === 'woff') return 'font/woff'
+  return 'font/woff2'
+}
+
+async function fetchFontDataUri(src: string): Promise<string> {
+  const res = await fetch(src)
+  if (!res.ok) throw new Error(`字体加载失败 ${src}: ${res.status}`)
+  const buf = await res.arrayBuffer()
+  const bytes = new Uint8Array(buf)
+  let bin = ''
+  const chunk = 0x8000
+  for (let i = 0; i < bytes.length; i += chunk) {
+    bin += String.fromCharCode(...bytes.subarray(i, i + chunk))
+  }
+  return `data:${fontMime(src)};base64,${btoa(bin)}`
+}
+
+function buildFontFaceCss(defs: FontFaceDef[], dataUris: string[]): string {
+  return defs
+    .map(
+      (d, i) =>
+        `@font-face{font-family:"${d.family}";src:url(${dataUris[i]}) format("${fontFormat(
+          d.src,
+        )}");font-weight:${d.weight ?? 'normal'};font-style:${d.style ?? 'normal'};}`,
+    )
+    .join('')
+}
+
+const XHTML_DIV = '<div xmlns="http://www.w3.org/1999/xhtml">'
+
+/** 把字体以 data-URI @font-face 嵌进 SVG（每个 xhtml div 顶部）—— 供 rasterize / SVG 矢量导出使用
+ * 单个字体加载失败（文件缺失 / 网络异常）时跳过该字体，走系统字体兜底，不阻塞导出。 */
+export async function embedFontsInSvg(svg: string, defs: FontFaceDef[]): Promise<string> {
+  if (!defs.length) return svg
+  const pairs = await Promise.all(
+    defs.map(async (d) => {
+      try {
+        return { d, uri: await fetchFontDataUri(d.src) }
+      } catch {
+        return null
+      }
+    }),
+  )
+  const ok = pairs.filter((p): p is { d: FontFaceDef; uri: string } => p !== null)
+  if (!ok.length) return svg
+  const css = `<style>${buildFontFaceCss(ok.map((p) => p.d), ok.map((p) => p.uri))}</style>`
+  return svg.split(XHTML_DIV).join(`${XHTML_DIV}${css}`)
+}
+
+/** 把字体以 data-URI @font-face 嵌进 HTML <head> —— 供无头静默打印文档使用
+ * 单个字体加载失败（文件缺失 / 网络异常）时跳过该字体，走系统字体兜底，不阻塞打印。 */
+export async function embedFontsInHtml(html: string, defs: FontFaceDef[]): Promise<string> {
+  if (!defs.length) return html
+  const pairs = await Promise.all(
+    defs.map(async (d) => {
+      try {
+        return { d, uri: await fetchFontDataUri(d.src) }
+      } catch {
+        return null
+      }
+    }),
+  )
+  const ok = pairs.filter((p): p is { d: FontFaceDef; uri: string } => p !== null)
+  if (!ok.length) return html
+  const style = `<style>${buildFontFaceCss(ok.map((p) => p.d), ok.map((p) => p.uri))}</style>`
+  if (html.includes('</head>')) return html.replace('</head>', `${style}</head>`)
+  return `${style}${html}`
+}
diff --git a/openprint/src/core/export-engine/index.ts b/openprint/src/core/export-engine/index.ts
new file mode 100644
index 0000000..6a49705
--- /dev/null
+++ b/openprint/src/core/export-engine/index.ts
@@ -0,0 +1,98 @@
+/**
+ * Export Engine —— 三格式导出（PDF / JPG / SVG）
+ *
+ * 纯 TypeScript、零框架依赖（与 designer-vue 解耦，headless 阶段可直接复用）。
+ * 真相来源统一是 `sdk.render()` 的 HTML 产物，因此：
+ *   - 预览 = 打印 = 导出 三者视觉一致
+ *   - 支持数据绑定 + 超长表格分页 + 中文（系统字体）
+ *
+ * 导出语义：
+ * - PDF：单文件、多页（位图 PDF，思源宋体内联）
+ * - JPG：每页一个文件（多页时按 `name-1.jpg` 命名）
+ * - SVG：单文件、多页纵向堆叠（矢量，含 foreignObject）
+ */
+import type { RenderRequest } from '@/core/sdk'
+import { render } from '@/core/sdk'
+import type { LayoutResult } from '@/core/layout-engine/types'
+import { documentToPdf } from './export-pdf'
+import { documentToSvgString } from './export-svg'
+import { pageToJpg } from './export-image'
+import { downloadBlob } from './util'
+import type { FontFaceDef } from './fonts'
+
+export type { FontFaceDef } from './fonts'
+
+export type ExportFormat = 'pdf' | 'jpg' | 'svg'
+
+export interface ExportOptions {
+  /** 高清倍率 1/2/3（默认 3·288dpi·最高清），可传 4 更锐 */
+  scale?: number
+  /** 文件名（不含扩展名）；多页 JPG 会追加 -页码 */
+  filename?: string
+  /** 位图背景色，默认白 */
+  background?: string
+  /** 自定义字体（同源 URL），嵌入 JPG/SVG 栅格化产物使导出不丢字体 */
+  fonts?: FontFaceDef[]
+  /**
+   * PDF 位图底图压缩格式（仅 PDF 导出生效，默认 `'png'` 无损最清晰）：
+   * - `'png'`：无损，文字/线条边缘锐利，打印推荐；
+   * - `'jpeg'`：体积小，仅体积敏感场景。
+   */
+  pdfImageType?: 'jpeg' | 'png'
+}
+
+export interface ExportOutcome {
+  blobs: Blob[]
+  filenames: string[]
+  mime: string
+}
+
+/**
+ * 渲染 + 导出一站式入口。PDF/SVG 单文件多页，JPG 每页一个文件。
+ * 调用方逐一下载即可。
+ */
+export async function exportDocument(
+  request: RenderRequest,
+  format: ExportFormat,
+  options: ExportOptions = {},
+): Promise<ExportOutcome> {
+  const res = await render(request)
+  const result: LayoutResult = res.result
+  const name = (options.filename ?? 'openprint-document').trim() || 'openprint-document'
+  const scale = options.scale ?? 3
+  const bg = options.background ?? '#ffffff'
+  // 页面装饰（背景色 + 水印）统一来自渲染请求 output，三格式导出共享
+  const deco = request.output?.pageDecoration
+
+  if (format === 'pdf') {
+    const blob = await documentToPdf(result, {
+      scale,
+      imageType: options.pdfImageType ?? 'png',
+      pageDecoration: deco,
+    })
+    return { blobs: [blob], filenames: [`${name}.pdf`], mime: 'application/pdf' }
+  }
+
+  if (format === 'svg') {
+    const svg = await documentToSvgString(result, options.fonts, deco)
+    const blob = new Blob([svg], { type: 'image/svg+xml;charset=utf-8' })
+    return { blobs: [blob], filenames: [`${name}.svg`], mime: 'image/svg+xml' }
+  }
+
+  // JPG：每页一个文件
+  const blobs = await Promise.all(
+    result.pages.map((_, i) =>
+      pageToJpg(result, i, { scale, background: bg, fonts: options.fonts, pageDecoration: deco }),
+    ),
+  )
+  const filenames = blobs.map((_, i) =>
+    blobs.length > 1 ? `${name}-${i + 1}.jpg` : `${name}.jpg`,
+  )
+  return { blobs, filenames, mime: 'image/jpeg' }
+}
+
+export { downloadBlob, pageToJpg, documentToSvgString, documentToPdf }
+export type { RenderRequest } from '@/core/sdk'
+export type { LayoutResult } from '@/core/layout-engine/types'
+export type { PdfOptions as ExportPdfOptions } from './export-pdf'
+export type { PageImageOptions } from './rasterize'
diff --git a/openprint/src/core/export-engine/rasterize.spec.ts b/openprint/src/core/export-engine/rasterize.spec.ts
new file mode 100644
index 0000000..44bd4f0
--- /dev/null
+++ b/openprint/src/core/export-engine/rasterize.spec.ts
@@ -0,0 +1,105 @@
+import { afterEach, describe, expect, it, vi } from 'vitest'
+
+import { inlinePageImages, toXmlSafe } from '@/core/export-engine/rasterize'
+
+describe('toXmlSafe —— HTML→XML 安全（foreignObject 光栅化前置）', () => {
+  it('void 标签补自闭合', () => {
+    expect(toXmlSafe('<img src="x.png">')).toBe('<img src="x.png" />')
+    expect(toXmlSafe('<br>')).toBe('<br />')
+    expect(toXmlSafe('<col style="width:10mm">')).toBe('<col style="width:10mm" />')
+    expect(toXmlSafe('<hr>')).toBe('<hr />')
+    expect(toXmlSafe('<input type="text">')).toBe('<input type="text" />')
+  })
+
+  it('已自闭合的 void 标签保持单一斜杠', () => {
+    // 带属性的自闭合：补成标准 " />" 形式
+    expect(toXmlSafe('<img src="a"/>')).toBe('<img src="a" />')
+    // 无属性的自闭合（如 <br/>）正则不触碰，原样保留也是正确的 XML
+    expect(toXmlSafe('<br/>')).toBe('<br/>')
+  })
+
+  it('内嵌 <svg> 缺命名空间时补上', () => {
+    expect(toXmlSafe('<svg>')).toBe('<svg xmlns="http://www.w3.org/2000/svg">')
+    expect(toXmlSafe('<svg viewBox="0 0 1 1">')).toBe(
+      '<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1 1">',
+    )
+  })
+
+  it('已带命名空间的 <svg> 不再重复补', () => {
+    const src = '<svg xmlns="http://www.w3.org/2000/svg"><rect/></svg>'
+    expect(toXmlSafe(src)).toBe(src)
+  })
+
+  it('普通标签与文本不受影响', () => {
+    expect(toXmlSafe('<div class="op-page">你好<span>世界</span></div>')).toBe(
+      '<div class="op-page">你好<span>世界</span></div>',
+    )
+  })
+})
+
+describe('inlinePageImages —— 外部图片内联（防 canvas taint）', () => {
+  afterEach(() => {
+    vi.restoreAllMocks()
+  })
+
+  const png = Uint8Array.from([0x89, 0x50, 0x4e, 0x47])
+  const stubFetch = (mime = 'image/png') =>
+    vi.stubGlobal(
+      'fetch',
+      vi.fn(async () => ({
+        ok: true,
+        headers: { get: () => mime },
+        arrayBuffer: async () => png.buffer,
+      })),
+    )
+
+  it('无图片时原样返回', async () => {
+    const html = '<div class="op-text">hello</div>'
+    expect(await inlinePageImages(html)).toBe(html)
+  })
+
+  it('外部图片 src 被替换为 data URI（btoa 可用环境）', async () => {
+    stubFetch()
+    const out = await inlinePageImages('<img src="http://example.com/a.png" />')
+    expect(out).toContain('data:image/png;base64,')
+    expect(out).not.toContain('http://example.com')
+  })
+
+  it('单引号 src 的 <img> 同样被内联（此前漏网导致 canvas taint）', async () => {
+    stubFetch()
+    const out = await inlinePageImages("<img src='http://example.com/b.png' />")
+    expect(out).toContain('data:image/png;base64,')
+    expect(out).not.toContain('http://example.com')
+  })
+
+  it('CSS url(...) 背景图被内联', async () => {
+    stubFetch()
+    const out = await inlinePageImages('<div style="background:url(http://example.com/bg.png)"></div>')
+    expect(out).toContain('data:image/png;base64,')
+    expect(out).not.toContain('http://example.com')
+  })
+
+  it('SVG <image href> 被内联', async () => {
+    stubFetch()
+    const out = await inlinePageImages('<svg><image href="http://example.com/logo.png" /></svg>')
+    expect(out).toContain('data:image/png;base64,')
+    expect(out).not.toContain('http://example.com')
+  })
+
+  it('加载失败的图片降级为透明占位，不阻塞导出', async () => {
+    vi.stubGlobal('fetch', vi.fn(async () => ({ ok: false, status: 404 })))
+    const out = await inlinePageImages('<img src="/missing.png" />')
+    expect(out).toContain('data:image/png;base64,')
+    expect(out).not.toContain('/missing.png')
+  })
+
+  it('data URI 图片保持原样（不重复内联）', async () => {
+    const html = '<img src="data:image/png;base64,AAA" />'
+    expect(await inlinePageImages(html)).toBe(html)
+  })
+
+  it('data URI 的 CSS url 保持原样', async () => {
+    const html = '<div style="background:url(data:image/png;base64,AAA)"></div>'
+    expect(await inlinePageImages(html)).toBe(html)
+  })
+})
diff --git a/openprint/src/core/export-engine/rasterize.ts b/openprint/src/core/export-engine/rasterize.ts
new file mode 100644
index 0000000..b920ca3
--- /dev/null
+++ b/openprint/src/core/export-engine/rasterize.ts
@@ -0,0 +1,280 @@
+/**
+ * 栅格化工具 —— 把单页渲染 HTML 变成位图
+ *
+ * ## 为什么用 SVG <foreignObject>
+ *
+ * 设计器/渲染引擎的"真相来源"是 `render()` 产出的 HTML/CSS（§2 单一真相源）。
+ * 要把 HTML 变成 PNG/JPG，浏览器原生只有两条路：
+ * 1. html2canvas 之类的库（要新依赖，且零网络铁律下不想引）
+ * 2. 把 HTML 塞进 SVG 的 `<foreignObject>`，再交给 `<img>`/`canvas` 光栅化
+ *
+ * 这里走第 2 条：纯浏览器 API、零依赖、中文靠系统字体（PingFang SC / 思源）渲染。
+ *
+ * ## 已知边界
+ * - `<foreignObject>` 在 Chromium / Firefox 用 `<img src=svg>` 光栅化是支持的；
+ *   Safari 出于安全限制**不支持** img 里的 foreignObject，需要换 html2canvas 才能覆盖。
+ *   当前目标浏览器为 Chromium 内核，足够。
+ * - 内嵌资源必须同源或 data URI（本设计器图片已走 data URI，条码/二维码是内联 SVG）。
+ */
+import { mmToPx } from '@/core/units'
+import { renderPage, generateCss } from '@/core/renderer-html'
+import type { LayoutResult } from '@/core/layout-engine/types'
+import type { PageDecoration } from '@/types/template'
+import { embedFontsInSvg, type FontFaceDef } from './fonts'
+
+/** HTML 转 XML 安全的 void 标签集合（foreignObject 走 XML 解析，未闭合会整页渲染失败） */
+const VOID_TAGS = new Set([
+  'area', 'base', 'br', 'col', 'embed', 'hr', 'img', 'input', 'link',
+  'meta', 'param', 'source', 'track', 'wbr',
+])
+
+/**
+ * 把渲染产物里可能出现的不规范 HTML 修成 XML 安全：
+ * - void 标签补自闭合 `/>`
+ * - 内嵌 `<svg>` 确保带 SVG 命名空间（否则 XHTML 命名空间下不渲染）
+ */
+export function toXmlSafe(html: string): string {
+  const fixed = html.replace(
+    /<([a-zA-Z][\w-]*)((?:\s+[^<>]*?)?)\s*>/g,
+    (m, tag: string, attrs: string) => {
+      const t = tag.toLowerCase()
+      if (VOID_TAGS.has(t)) {
+        const clean = attrs.replace(/\/\s*$/, '')
+        return `<${t}${clean} />`
+      }
+      return m
+    },
+  )
+  // 给缺命名空间的内嵌 svg 补上（负向预查：后面到 > 之间不含 xmlns= 才补）
+  return fixed.replace(/<svg(?![^>]*\bxmlns=)/g, '<svg xmlns="http://www.w3.org/2000/svg"')
+}
+
+/** 单页 HTML + 样式 → 可直接光栅化的 SVG 字符串 */
+export function buildPageSvg(
+  pageHtml: string,
+  css: string,
+  pageWidthMm: number,
+  pageHeightMm: number,
+): string {
+  const w = Math.max(1, Math.ceil(mmToPx(pageWidthMm)))
+  const h = Math.max(1, Math.ceil(mmToPx(pageHeightMm)))
+  const safe = toXmlSafe(pageHtml)
+  const inner =
+    `<div xmlns="http://www.w3.org/1999/xhtml">` +
+    `<style>${css}</style>` +
+    `<div class="op-doc"><div class="op-page-wrap">${safe}</div></div>` +
+    `</div>`
+  return (
+    `<svg xmlns="http://www.w3.org/2000/svg" width="${w}" height="${h}" viewBox="0 0 ${w} ${h}">` +
+    `<foreignObject x="0" y="0" width="${w}" height="${h}">${inner}</foreignObject>` +
+    `</svg>`
+  )
+}
+
+/** SVG 光栅化超时（ms）：部分环境对 <foreignObject> 支持差 / onload 永不触发，
+ * 超时则降级返回白底空 canvas，不让单页失败拖垮整份导出。 */
+const SVG_RASTER_TIMEOUT = 4000
+
+function loadImage(src: string): Promise<HTMLImageElement> {
+  return new Promise((resolve, reject) => {
+    const img = new Image()
+    let done = false
+    const timer = setTimeout(() => {
+      if (done) return
+      done = true
+      reject(new Error('SVG 光栅化超时（环境不支持 foreignObject 或资源跨域）'))
+    }, SVG_RASTER_TIMEOUT)
+    img.onload = () => {
+      if (done) return
+      done = true
+      clearTimeout(timer)
+      resolve(img)
+    }
+    img.onerror = () => {
+      if (done) return
+      done = true
+      clearTimeout(timer)
+      reject(new Error('SVG 光栅化失败（浏览器不支持 foreignObject 或资源跨域）'))
+    }
+    img.src = src
+  })
+}
+
+/** SVG 字符串 → 高清 canvas（scale 倍图，填白底避免透明）。超时/失败时降级白底空 canvas
+ *
+ * ## 为什么用 data: URL 而不是 blob: URL（血泪教训，勿改回）
+ * Chromium 安全策略：经 `blob:` URL 加载的、含 `<foreignObject>` 的 SVG 会被判定为
+ * 「来源不纯净」，drawImage 后 canvas 被污染，toBlob/toDataURL 抛
+ * "Tainted canvases may not be exported"。同一 SVG 改用 `data:` URL 加载则不污染。
+ * （实测对照：blob+FO=TAINTED，blob+纯矢量=clean，data+FO=clean，data+纯矢量=clean）
+ */
+/** 把 SVG 根节点的显示宽高放大 scale 倍（viewBox 不变），让 foreignObject 以高分原生渲染，
+ * 而不是低分渲染后再插值放大 —— 这是打印/导出文字清晰的关键。
+ * 血泪：低分 SVG 渲染成位图后再 drawImage 放大 = 只是像素插值，文字发虚；
+ * 放大 SVG 的 width/height（viewBox 不动）则内容矢量重排到高分画布，边缘锐利。 */
+function scaleSvgViewport(svg: string, scale: number): string {
+  if (!Number.isFinite(scale) || scale === 1) return svg
+  return svg.replace(
+    /<svg([^>]*?)\bwidth="([\d.]+)"([^>]*?)\bheight="([\d.]+)"/,
+    (m, p1: string, w: string, p2: string, h: string) =>
+      `<svg${p1}width="${Math.round(parseFloat(w) * scale)}"${p2}height="${Math.round(parseFloat(h) * scale)}"`,
+  )
+}
+
+export async function svgToCanvas(svg: string, scale: number, bg: string): Promise<HTMLCanvasElement> {
+  // 先放大 SVG 显示尺寸，再加载：img 本身就是高分位图，canvas 无需再插值放大
+  const scaled = scaleSvgViewport(svg, scale)
+  const url = 'data:image/svg+xml;charset=utf-8,' + encodeURIComponent(scaled)
+  // fallback 尺寸从放大后的 SVG 宽高推导（取不到再用 A4×scale 兜底）
+  const dim = scaled.match(/<svg[^>]*\bwidth="([\d.]+)"[^>]*\bheight="([\d.]+)"/)
+  const cw = Math.max(1, Math.round(dim ? parseFloat(dim[1]!) : 794 * scale))
+  const ch = Math.max(1, Math.round(dim ? parseFloat(dim[2]!) : 1123 * scale))
+  const fallback = (): HTMLCanvasElement => {
+    const canvas = document.createElement('canvas')
+    canvas.width = cw
+    canvas.height = ch
+    const ctx = canvas.getContext('2d')
+    if (ctx) {
+      ctx.fillStyle = bg
+      ctx.fillRect(0, 0, cw, ch)
+    }
+    return canvas
+  }
+  try {
+    const img = await loadImage(url)
+    const canvas = document.createElement('canvas')
+    // img.width/height 已是高分目标尺寸，drawImage 原样铺绘，不再缩放插值
+    canvas.width = Math.max(1, img.width)
+    canvas.height = Math.max(1, img.height)
+    const ctx = canvas.getContext('2d')
+    if (!ctx) return fallback()
+    ctx.fillStyle = bg
+    ctx.fillRect(0, 0, canvas.width, canvas.height)
+    ctx.drawImage(img, 0, 0)
+    return canvas
+  } catch {
+    // 环境不支持 foreignObject 光栅化（如 happy-dom）→ 降级白底空 canvas，不阻塞导出
+    return fallback()
+  }
+}
+
+export interface PageImageOptions {
+  scale?: number
+  background?: string
+  type?: 'image/png' | 'image/jpeg'
+  /**
+   * JPEG 编码质量 0-1，默认 **1（最高清）**。
+   * 注：quality=1 比 0.92 体积大约 30-60%，但仍是 PNG 的零头；
+   * 对票据/报表这类对清晰度敏感的打印件值得。
+   */
+  quality?: number
+  /** 自定义字体（同源 URL），嵌入 SVG 使栅格化产物不丢字体 */
+  fonts?: FontFaceDef[]
+  /** 页面装饰（背景色 + 水印），使导出与预览一致 */
+  pageDecoration?: PageDecoration
+}
+
+/* ------------------------- 图片内联（防 canvas taint） ------------------------- */
+
+/** 1×1 透明 PNG，外部图片加载失败时的降级占位（避免整页导出失败） */
+const TRANSPARENT_PNG =
+  'data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk+M9QDwADhgGAWjR9awAAAABJRU5ErkJggg=='
+
+/** <img> 的 src（双引号或单引号） */
+const IMG_SRC_RE = /<img\b[^>]*?\bsrc=(["'])([^"']*)\1/gi
+/** CSS url(...) 引用（background / @font-face 等，仅图片类会被内联） */
+const CSS_URL_RE = /url\(\s*(["']?)([^"')]+)\1\s*\)/gi
+/** SVG <image> 的 href / xlink:href */
+const SVG_IMAGE_RE = /<image\b[^>]*?\b(?:xlink:)?href=(["'])([^"']*)\1/gi
+
+async function fetchAsDataUri(src: string): Promise<{ uri: string; mime: string }> {
+  const res = await fetch(src)
+  if (!res.ok) throw new Error(`资源加载失败 ${src}: ${res.status}`)
+  const bytes = new Uint8Array(await res.arrayBuffer())
+  const mime = res.headers.get('content-type')?.split(';')[0]?.trim() || 'image/png'
+  let bin = ''
+  const chunk = 0x8000
+  for (let i = 0; i < bytes.length; i += chunk) {
+    bin += String.fromCharCode(...bytes.subarray(i, i + chunk))
+  }
+  return { uri: `data:${mime};base64,${btoa(bin)}`, mime }
+}
+
+/** 收集页面 HTML 里所有外部资源引用（img src / CSS url / SVG image href） */
+function collectExternalSrcs(html: string): Set<string> {
+  const srcs = new Set<string>()
+  const add = (src: string | undefined) => {
+    const s = (src ?? '').trim()
+    if (!s || /^data:/i.test(s) || /^#/.test(s) || /^blob:/i.test(s)) return
+    srcs.add(s)
+  }
+  for (const m of html.matchAll(IMG_SRC_RE)) add(m[2])
+  for (const m of html.matchAll(CSS_URL_RE)) add(m[2])
+  for (const m of html.matchAll(SVG_IMAGE_RE)) add(m[2])
+  return srcs
+}
+
+/**
+ * 把页面 HTML 里所有外部图片（http / 相对路径）内联成 data URI。
+ * 否则 SVG <foreignObject> 加载跨域图片会污染 canvas，toBlob 抛
+ * "Tainted canvases may not be exported"。失败/跨域图片降级为透明占位，不阻塞导出。
+ */
+export async function inlinePageImages(html: string): Promise<string> {
+  const srcs = collectExternalSrcs(html)
+  if (!srcs.size) return html
+
+  const resolved = new Map<string, string>()
+  await Promise.all(
+    [...srcs].map(async (src) => {
+      try {
+        const { uri } = await fetchAsDataUri(src)
+        resolved.set(src, uri)
+      } catch {
+        resolved.set(src, TRANSPARENT_PNG)
+      }
+    }),
+  )
+
+  // 替换 <img src>（双/单引号）
+  let out = html.replace(IMG_SRC_RE, (tag, quote: string, src: string) => {
+    const uri = resolved.get(src.trim())
+    return uri ? tag.replace(`src=${quote}${src}${quote}`, `src=${quote}${uri}${quote}`) : tag
+  })
+  // 替换 CSS url(...)
+  out = out.replace(CSS_URL_RE, (tag, quote: string, src: string) => {
+    const uri = resolved.get(src.trim())
+    return uri ? `url(${quote}${uri}${quote})` : tag
+  })
+  // 替换 SVG <image href / xlink:href>
+  out = out.replace(SVG_IMAGE_RE, (tag, quote: string, src: string) => {
+    const uri = resolved.get(src.trim())
+    return uri ? tag.replace(/href=(["'])[^"']*\1/i, `href=${quote}${uri}${quote}`) : tag
+  })
+  return out
+}
+
+/** 把某一页渲染成位图 Blob（PNG / JPG 共用） */
+export async function pageToImageBlob(
+  result: LayoutResult,
+  index: number,
+  opts: PageImageOptions = {},
+): Promise<Blob> {
+  const page = result.pages[index]
+  if (!page) throw new Error(`页码越界：${index}`)
+  const deco = opts.pageDecoration
+  const css = generateCss(result.metrics, { screen: false, pageDecoration: deco })
+  // 先内联图片为 data URI，再进 SVG 栅格化 —— 防止外部图污染 canvas 导致 toBlob 失败
+  const pageHtml = await inlinePageImages(renderPage(page, deco?.watermark))
+  let svg = buildPageSvg(pageHtml, css, result.metrics.pageWidth, result.metrics.pageHeight)
+  if (opts.fonts?.length) svg = await embedFontsInSvg(svg, opts.fonts)
+  const canvas = await svgToCanvas(svg, opts.scale ?? 3, opts.background ?? '#ffffff')
+  const type = opts.type ?? 'image/png'
+  const quality = type === 'image/jpeg' ? opts.quality ?? 1 : undefined
+  return new Promise((resolve, reject) => {
+    canvas.toBlob(
+      (b) => (b ? resolve(b) : reject(new Error('canvas.toBlob 失败'))),
+      type,
+      quality,
+    )
+  })
+}
diff --git a/openprint/src/core/export-engine/util.ts b/openprint/src/core/export-engine/util.ts
new file mode 100644
index 0000000..7c8b774
--- /dev/null
+++ b/openprint/src/core/export-engine/util.ts
@@ -0,0 +1,25 @@
+/**
+ * 浏览器侧小工具：Blob → dataURL、触发下载
+ */
+
+export function blobToDataURL(blob: Blob): Promise<string> {
+  return new Promise((resolve, reject) => {
+    const reader = new FileReader()
+    reader.onload = () => resolve(reader.result as string)
+    reader.onerror = () => reject(new Error('FileReader 读取失败'))
+    reader.readAsDataURL(blob)
+  })
+}
+
+/** 触发浏览器下载（单文件） */
+export function downloadBlob(blob: Blob, filename: string): void {
+  const url = URL.createObjectURL(blob)
+  const a = document.createElement('a')
+  a.href = url
+  a.download = filename
+  document.body.appendChild(a)
+  a.click()
+  a.remove()
+  // 延迟回收，确保下载已触发
+  setTimeout(() => URL.revokeObjectURL(url), 1500)
+}
diff --git a/openprint/src/core/fonts/catalog.ts b/openprint/src/core/fonts/catalog.ts
new file mode 100644
index 0000000..b2e1a7b
--- /dev/null
+++ b/openprint/src/core/fonts/catalog.ts
@@ -0,0 +1,79 @@
+/**
+ * 字体注册中心（《设计方案》§11.6 @open-print/fonts registry）
+ *
+ * 内置字体清单：font-family 名 → 字体文件（public/fonts/ 同源静态资源，零网络铁律）。
+ * 命名与 `参考资料/fonts/fonts.txt` 一致：
+ * - HedvigLettersSans-Regular.woff2 → Hedvig Letters Sans
+ * - LiberationSerif-{Regular,Bold,Italic}.woff2 → Liberation Serif（一个族，三种字重/字形）
+ * - SourceHanSansCN-Normal.woff2 → 思源黑体
+ * - SourceHanSerifCN-Regular.ttf → 思源宋体
+ * - ChillKai.woff2 → 寒蝉正楷体
+ */
+
+export interface FontFaceEntry {
+  /** 同源字体文件 URL（相对 public 根；浏览器/位图栅格化用，woff2 优先） */
+  src: string
+  weight?: number
+  style?: 'normal' | 'italic'
+}
+
+export interface FontFamilyDef {
+  /** 字体族名（模板 style.fontFamily / CSS font-family 用这个名字） */
+  family: string
+  /** 展示名（属性面板下拉用） */
+  label: string
+  /** 优先级（属性面板排序） */
+  order: number
+  faces: FontFaceEntry[]
+}
+
+/** 内置字体清单（顺序即面板展示顺序；woff2 供浏览器显示与位图 PDF 栅格化内联） */
+export const FONT_CATALOG: FontFamilyDef[] = [
+  {
+    family: '思源黑体',
+    label: '思源黑体',
+    order: 1,
+    faces: [{ src: '/fonts/SourceHanSansCN-Normal.woff2', weight: 400 }],
+  },
+  {
+    family: '思源宋体',
+    label: '思源宋体',
+    order: 2,
+    faces: [{ src: '/fonts/SourceHanSerifCN-Regular.ttf', weight: 400 }],
+  },
+  {
+    family: '寒蝉正楷体',
+    label: '寒蝉正楷体',
+    order: 3,
+    faces: [{ src: '/fonts/ChillKai.woff2', weight: 400 }],
+  },
+  {
+    family: 'Liberation Serif',
+    label: 'Liberation Serif',
+    order: 4,
+    faces: [
+      { src: '/fonts/LiberationSerif-Regular.woff2', weight: 400 },
+      { src: '/fonts/LiberationSerif-Bold.woff2', weight: 700 },
+      { src: '/fonts/LiberationSerif-Italic.woff2', weight: 400, style: 'italic' },
+    ],
+  },
+  {
+    family: 'Hedvig Letters Sans',
+    label: 'Hedvig Letters Sans',
+    order: 5,
+    faces: [{ src: '/fonts/HedvigLettersSans-Regular.woff2', weight: 400 }],
+  },
+]
+
+/** 按字体族名查找（模板 style.fontFamily 可能存家族名，如 "思源黑体"） */
+export function findFontFamily(family: string | undefined): FontFamilyDef | undefined {
+  if (!family) return undefined
+  const name = (family.replace(/^"|"$/g, '').split(',')[0] ?? '').trim()
+  return FONT_CATALOG.find((f) => f.family === name)
+}
+
+/** 字体文件相对 public 根 → 绝对 URL（预览 iframe 注入用；浏览器环境） */
+export function fontUrl(src: string): string {
+  if (typeof window === 'undefined') return src
+  return new URL(src, window.location.origin).href
+}
diff --git a/openprint/src/core/fonts/fonts.spec.ts b/openprint/src/core/fonts/fonts.spec.ts
new file mode 100644
index 0000000..9859286
--- /dev/null
+++ b/openprint/src/core/fonts/fonts.spec.ts
@@ -0,0 +1,56 @@
+import { describe, expect, it } from 'vitest'
+import { FONT_CATALOG, findFontFamily } from '@/core/fonts/catalog'
+import { builtinFontFaceCss, templateUsedFonts } from '@/core/fonts/loader'
+import type { TemplateData } from '@/types/template'
+import type { AnyControl } from '@/types/control'
+
+describe('fonts —— 内置字体包', () => {
+  it('目录覆盖参考资料 fonts.txt 全部字体族', () => {
+    const families = FONT_CATALOG.map((f) => f.family)
+    // fonts.txt 定义的名称（中文名/拉丁名）
+    expect(families).toContain('思源黑体')
+    expect(families).toContain('思源宋体')
+    expect(families).toContain('寒蝉正楷体')
+    expect(families).toContain('Liberation Serif')
+    expect(families).toContain('Hedvig Letters Sans')
+    // Liberation Serif 一个族包含 3 个字重/字形
+    const lib = FONT_CATALOG.find((f) => f.family === 'Liberation Serif')
+    expect(lib?.faces.length).toBe(3)
+  })
+
+  it('builtinFontFaceCss 生成合法 @font-face 且含 format', () => {
+    const css = builtinFontFaceCss('http://localhost:5173')
+    expect(css).toContain('@font-face')
+    expect(css).toContain('font-family:"思源黑体"')
+    expect(css).toContain('format("woff2")')
+    expect(css).toContain('format("truetype")') // 思源宋体 ttf
+    expect(css).toContain('http://localhost:5173/fonts/SourceHanSansCN-Normal.woff2')
+  })
+
+  it('templateUsedFonts 只提取模板实际用到的字体族', () => {
+    const tpl: TemplateData<AnyControl> = {
+      version: '1.0',
+      document: {
+        type: 'report',
+        page: { width: 210, height: 297, unit: 'mm', orientation: 'portrait', margin: { top: 10, right: 10, bottom: 10, left: 10 } },
+        sections: [
+          {
+            type: 'body',
+            components: [
+              { id: 't1', type: 'text', left: 0, top: 0, width: 50, height: 8, value: 'x', style: { fontFamily: '思源黑体' }, printable: true },
+              { id: 't2', type: 'text', left: 0, top: 10, width: 50, height: 8, value: 'y', printable: true },
+            ],
+          },
+        ],
+      },
+    }
+    const used = templateUsedFonts(tpl)
+    expect(used.map((f) => f.family)).toEqual(['思源黑体'])
+  })
+
+  it('findFontFamily 容错带引号的族名', () => {
+    expect(findFontFamily('"思源宋体"')?.family).toBe('思源宋体')
+    expect(findFontFamily('思源黑体, sans-serif')?.family).toBe('思源黑体')
+    expect(findFontFamily(undefined)).toBeUndefined()
+  })
+})
diff --git a/openprint/src/core/fonts/loader.ts b/openprint/src/core/fonts/loader.ts
new file mode 100644
index 0000000..1f8d5ea
--- /dev/null
+++ b/openprint/src/core/fonts/loader.ts
@@ -0,0 +1,101 @@
+/**
+ * 字体本地加载（《设计方案》§11.6 @open-print/fonts loader）
+ *
+ * - `loadBuiltinFonts()`：用 FontFace API 把内置字体注册到浏览器（设计期画布/预览生效），
+ *   字体文件来自 public/fonts/ 同源静态资源，零网络依赖。
+ * - `builtinFontFaceCss(baseUrl)`：生成 @font-face CSS（预览 iframe 注入用）。
+ * - `templateUsedFonts(template)`：提取模板文本控件实际用到的字体族（供导出内联）。
+ */
+import { FONT_CATALOG, findFontFamily, type FontFamilyDef } from './catalog'
+import type { TemplateData } from '@/types/template'
+import type { AnyControl, TextControl } from '@/types/control'
+import type { FontFaceDef } from '@/core/export-engine/fonts'
+
+/** 浏览器环境是否可用 FontFace API */
+function canUseFontFace(): boolean {
+  return typeof window !== 'undefined' && typeof (window as unknown as { FontFace?: unknown }).FontFace !== 'undefined'
+}
+
+/** 把内置字体注册到 document.fonts（浏览器）；resolve 后返回已加载的族名列表 */
+export async function loadBuiltinFonts(defs: FontFamilyDef[] = FONT_CATALOG): Promise<string[]> {
+  if (!canUseFontFace() || typeof document === 'undefined' || typeof window === 'undefined') return []
+  const FontFaceCtor = (
+    window as unknown as {
+      FontFace?: new (family: string, source: string | ArrayBuffer, descriptors?: FontFaceDescriptors) => FontFace
+    }
+  ).FontFace
+  if (!FontFaceCtor) return []
+  const loaded: string[] = []
+  const tasks: Promise<void>[] = []
+  for (const def of defs) {
+    for (const face of def.faces) {
+      try {
+        const fontFace = new FontFaceCtor(
+          def.family,
+          `url(${new URL(face.src, window.location.origin).href})`,
+          {
+            weight: String(face.weight ?? 'normal'),
+            style: face.style ?? 'normal',
+          },
+        )
+        tasks.push(
+          fontFace.load().then(() => {
+            document.fonts.add(fontFace)
+            if (!loaded.includes(def.family)) loaded.push(def.family)
+          }),
+        )
+      } catch {
+        /* 单字体失败不阻塞整体 */
+      }
+    }
+  }
+  await Promise.allSettled(tasks)
+  return loaded
+}
+
+/** 生成内置字体的 @font-face CSS 块（baseUrl 用于拼字体绝对/相对路径） */
+export function builtinFontFaceCss(baseUrl: string): string {
+  return FONT_CATALOG.map((def) =>
+    def.faces
+      .map((face) => {
+        const src = face.src.startsWith('/') ? `${baseUrl.replace(/\/+$/, '')}${face.src}` : face.src
+        const ext = src.split('?')[0]?.split('.').pop()?.toLowerCase()
+        const format = ext === 'ttf' ? 'truetype' : ext === 'otf' ? 'opentype' : ext === 'woff' ? 'woff' : 'woff2'
+        return (
+          `@font-face{font-family:"${def.family}";` +
+          `src:url(${src}) format("${format}");` +
+          `font-weight:${face.weight ?? 'normal'};font-style:${face.style ?? 'normal'};}`
+        )
+      })
+      .join(''),
+  ).join('')
+}
+
+/** 提取模板中实际用到的内置字体族（供导出/无头打印内联，避免全量内联） */
+export function templateUsedFonts(template: TemplateData<AnyControl>): FontFamilyDef[] {
+  const used = new Set<string>()
+  const walk = (comps: AnyControl[]): void => {
+    for (const c of comps) {
+      if (c.type === 'text') {
+        const family = (c as TextControl).style?.fontFamily
+        const def = findFontFamily(family)
+        if (def) used.add(def.family)
+      }
+      if (c.type === 'zone') walk(c.children)
+    }
+  }
+  for (const section of template.document.sections) walk(section.components as AnyControl[])
+  return FONT_CATALOG.filter((f) => used.has(f.family))
+}
+
+/** 转为导出引擎的 FontFaceDef（data-URI 内联用） */
+export function toExportFontDefs(defs: FontFamilyDef[]): FontFaceDef[] {
+  return defs.flatMap((def) =>
+    def.faces.map((face) => ({
+      family: def.family,
+      src: face.src,
+      weight: face.weight,
+      style: face.style,
+    })),
+  )
+}
diff --git a/openprint/src/core/headless/createHeadless.ts b/openprint/src/core/headless/createHeadless.ts
new file mode 100644
index 0000000..1cec6a6
--- /dev/null
+++ b/openprint/src/core/headless/createHeadless.ts
@@ -0,0 +1,192 @@
+/**
+ * Headless 无头静默模式 —— 《OpenPrint-实施指南》Phase 9 / 《设计方案》§19.4.4
+ *
+ * ## 定位
+ * `createHeadless({ repository, dataSource, fonts })` 是一个**零 UI、不挂载任何可见 DOM** 的
+ * 编程式渲染/导出/打印入口。它直接复用 `sdk.render()` + `export-engine`，
+ * 因此与「设计器预览」「浏览器打印」三者视觉完全一致（同一份 HTML/CSS 真相源）。
+ *
+ * ## 与 Vue 解耦
+ * 本文件是纯 TypeScript，不 import 任何 Vue / designer-vue 代码，
+ * 可直接被使用者的脚本、Node 参考渲染器或自动化测试调用。
+ *
+ * ## 零隐藏 DOM 的保证
+ * - 不往页面挂载任何隐藏预览节点（对比：设计器预览面板用独立 iframe）。
+ * - `print()` 仅在打印瞬间创建一个 0 尺寸 iframe、注入 srcdoc、调用 `print()`，
+ *   打印完成（或用户取消）后立即移除，页面不留残留 DOM。
+ * - 导出走 canvas/Blob，完全在内存与离屏 canvas 中完成。
+ */
+import { render as sdkRender, type RenderRequest, type RenderResponse } from '@/core/sdk'
+import { renderHtml } from '@/core/renderer-html'
+import {
+  exportDocument,
+  type ExportFormat,
+  type ExportOptions,
+  type ExportOutcome,
+  type FontFaceDef,
+} from '@/core/export-engine'
+import { embedFontsInHtml, loadFonts } from './loader'
+import type { TemplateRepository } from '@/repository/types'
+import type { TemplateData } from '@/types/template'
+import type { AnyControl } from '@/types/control'
+
+export interface HeadlessOptions {
+  /** 模板仓库（取模板用）。不传则 `buildRequest` 抛错，但 `render/exportXxx` 仍可手动传 template。 */
+  repository?: TemplateRepository
+  /** 数据源仓库（保留位，当前用于约定签名；自动合成数据由调用方用 buildPreviewData 组合）。 */
+  dataSource?: unknown
+  /** 同源自定义字体，导出 / 打印时嵌入，避免栅格化丢字体。 */
+  fonts?: FontFaceDef[]
+}
+
+/** 渲染/导出请求：模板 + 可选数据（未给数据则由调用方保证模板无 dataSource 依赖） */
+export interface HeadlessRequest {
+  template: TemplateData<AnyControl>
+  data?: Record<string, unknown>
+  layout?: RenderRequest['layout']
+  output?: RenderRequest['output']
+}
+
+export interface HeadlessExportOptions {
+  /** 高清倍率 1/2/3，默认 2 */
+  scale?: number
+  /** 文件名（不含扩展名） */
+  filename?: string
+  /** 位图背景色，默认白 */
+  background?: string
+}
+
+export interface HeadlessInstance {
+  /** 仅排版，返回 HTML 产物 + 页面模型 + 告警 */
+  render(req: HeadlessRequest): Promise<RenderResponse>
+  /** 导出 PDF（单文件多页，思源宋体写死内联） */
+  exportPdf(req: HeadlessRequest, opts?: HeadlessExportOptions): Promise<ExportOutcome>
+  /** 导出 JPG（多页每页一个文件） */
+  exportJpg(req: HeadlessRequest, opts?: HeadlessExportOptions): Promise<ExportOutcome>
+  /** 导出 SVG（单文件多页纵向堆叠矢量） */
+  exportSvg(req: HeadlessRequest, opts?: HeadlessExportOptions): Promise<ExportOutcome>
+  /** 静默浏览器打印（弹出系统打印对话框，零 UI 残留） */
+  print(req: HeadlessRequest): Promise<void>
+  /** 按模板 id 从 repository 取出模板，组装成 RenderRequest（默认 output.screen=false） */
+  buildRequest(templateId: string, data?: Record<string, unknown>): Promise<RenderRequest>
+  /** 释放资源（反注册字体等） */
+  dispose(): void
+}
+
+export function createHeadless(options: HeadlessOptions = {}): HeadlessInstance {
+  const fonts = options.fonts ?? []
+  let teardownFonts: (() => void) | null = null
+
+  // 浏览器环境：把字体注册到文档，供同源预览/打印使用
+  if (fonts.length && typeof document !== 'undefined') {
+    loadFonts(fonts)
+      .then((t) => {
+        teardownFonts = t
+      })
+      .catch(() => {
+        /* 字体加载失败不影响其余功能，栅格化会走系统字体兜底 */
+      })
+  }
+
+  const toRequest = (req: HeadlessRequest): RenderRequest => ({
+    template: req.template,
+    data: req.data,
+    layout: req.layout,
+    output: { screen: false, ...req.output },
+  })
+
+  async function buildRequest(templateId: string, data?: Record<string, unknown>): Promise<RenderRequest> {
+    if (!options.repository) throw new Error('createHeadless 未配置 repository，无法按 id 取模板')
+    const rec = await options.repository.get(templateId)
+    if (!rec) throw new Error(`模板不存在：${templateId}`)
+    return { template: rec.data, data, output: { screen: false } }
+  }
+
+  async function render(req: HeadlessRequest): Promise<RenderResponse> {
+    return sdkRender(toRequest(req))
+  }
+
+  async function exportFormat(
+    req: HeadlessRequest,
+    format: ExportFormat,
+    opts?: HeadlessExportOptions,
+  ): Promise<ExportOutcome> {
+    const expOpts: ExportOptions = {
+      fonts,
+      scale: opts?.scale,
+      filename: opts?.filename,
+      background: opts?.background,
+    }
+    return exportDocument(toRequest(req), format, expOpts)
+  }
+
+  async function print(req: HeadlessRequest): Promise<void> {
+    const res = await render(toRequest(req))
+    const pageDecoration = toRequest(req).output?.pageDecoration
+    let html = renderHtml(res.result, { screen: false, pageDecoration })
+    if (fonts.length) html = await embedFontsInHtml(html, fonts)
+    await silentPrint(html)
+  }
+
+  function dispose(): void {
+    if (teardownFonts) {
+      try {
+        teardownFonts()
+      } catch {
+        /* noop */
+      }
+      teardownFonts = null
+    }
+  }
+
+  return {
+    render,
+    exportPdf: (r, o) => exportFormat(r, 'pdf', o),
+    exportJpg: (r, o) => exportFormat(r, 'jpg', o),
+    exportSvg: (r, o) => exportFormat(r, 'svg', o),
+    print,
+    buildRequest,
+    dispose,
+  }
+}
+
+/** 静默打印：瞬态 0 尺寸 iframe + srcdoc + window.print()，完成后立即移除 */
+function silentPrint(html: string): Promise<void> {
+  return new Promise((resolve, reject) => {
+    if (typeof document === 'undefined') {
+      reject(new Error('silentPrint 需要浏览器环境'))
+      return
+    }
+    const iframe = document.createElement('iframe')
+    iframe.setAttribute('aria-hidden', 'true')
+    iframe.style.cssText = 'position:fixed;right:0;bottom:0;width:0;height:0;border:0;'
+    let removed = false
+    const cleanup = () => {
+      if (removed) return
+      removed = true
+      setTimeout(() => iframe.remove(), 300)
+    }
+    iframe.onload = () => {
+      const cw = iframe.contentWindow
+      if (!cw) {
+        cleanup()
+        reject(new Error('iframe 无 contentWindow'))
+        return
+      }
+      // onafterprint 在用户确认打印或取消时都会触发
+      cw.onafterprint = () => {
+        cleanup()
+        resolve()
+      }
+      try {
+        cw.focus()
+        cw.print()
+      } catch (e) {
+        cleanup()
+        reject(e instanceof Error ? e : new Error(String(e)))
+      }
+    }
+    document.body.appendChild(iframe)
+    iframe.srcdoc = html
+  })
+}
diff --git a/openprint/src/core/headless/headless.spec.ts b/openprint/src/core/headless/headless.spec.ts
new file mode 100644
index 0000000..80fb1bb
--- /dev/null
+++ b/openprint/src/core/headless/headless.spec.ts
@@ -0,0 +1,33 @@
+import { describe, expect, it } from 'vitest'
+
+import { createHeadless } from '@/core/headless'
+import { createDemoTemplate } from '@/repository/mock/data/demo-template'
+import { createCjkMeasurer } from '@/core/__tests__/cjk-measurer'
+
+function makeData(rows: number): Record<string, unknown> {
+  const items = Array.from({ length: rows }, (_, i) => ({
+    productCode: `P${i + 1}`,
+    productName: `商品${i + 1}`,
+    qty: (i % 5) + 1,
+    price: 10,
+    amount: ((i % 5) + 1) * 10,
+  }))
+  return { order: { orderNo: 'SO-001' }, items }
+}
+
+describe('createHeadless —— 无头静默模式', () => {
+  const measurer = createCjkMeasurer()
+
+  it('render 复用 sdk 产出多页 HTML（零 UI 残留）', async () => {
+    const hl = createHeadless({ fonts: [] })
+    const res = await hl.render({ template: createDemoTemplate(), data: makeData(30), layout: { measurer } })
+    expect(res.pages).toBeGreaterThanOrEqual(2)
+    hl.dispose()
+  })
+
+  it('buildRequest 未配置 repository 时抛错（契约边界）', async () => {
+    const hl = createHeadless({ fonts: [] })
+    await expect(hl.buildRequest('missing')).rejects.toThrow()
+    hl.dispose()
+  })
+})
diff --git a/openprint/src/core/headless/index.ts b/openprint/src/core/headless/index.ts
new file mode 100644
index 0000000..a41d498
--- /dev/null
+++ b/openprint/src/core/headless/index.ts
@@ -0,0 +1,21 @@
+/**
+ * Headless 无头模式入口 —— 汇总导出
+ *
+ * 用法：
+ * ```ts
+ * import { createHeadless } from '@/core/headless'
+ * const headless = createHeadless({ repository, dataSource, fonts })
+ * const { blobs, filenames } = await headless.exportPdf({ template, data }, { scale: 2 })
+ * blobs.forEach((b, i) => downloadBlob(b, filenames[i]))
+ * headless.dispose()
+ * ```
+ */
+export { createHeadless } from './createHeadless'
+export type {
+  HeadlessOptions,
+  HeadlessRequest,
+  HeadlessInstance,
+  HeadlessExportOptions,
+} from './createHeadless'
+export { loadFonts, embedFontsInSvg, embedFontsInHtml } from './loader'
+export type { FontFaceDef } from '@/core/export-engine/fonts'
diff --git a/openprint/src/core/headless/loader.ts b/openprint/src/core/headless/loader.ts
new file mode 100644
index 0000000..4318aac
--- /dev/null
+++ b/openprint/src/core/headless/loader.ts
@@ -0,0 +1,34 @@
+/**
+ * Headless 字体加载器
+ *
+ * - re-export `export-engine/fonts` 的嵌字工具（让栅格化 / 打印文档用上自定义字体）
+ * - `loadFonts`：用 FontFace API 把同源字体注册到**当前文档**，
+ *   供设计器预览 / 浏览器打印的同源文档（iframe srcdoc）使用。
+ *
+ * 注意：`loadFonts` 注册的是「文档级」字体，预览/打印文档只要同源就能用；
+ * 而栅格化（SVG `<img>`）是隔离上下文，必须用 `embedFontsInSvg` 把字体写进 SVG 本身。
+ */
+export {
+  type FontFaceDef,
+  embedFontsInSvg,
+  embedFontsInHtml,
+} from '@/core/export-engine/fonts'
+
+/** 把同源字体注册到当前文档（供同源预览 / 打印使用）。返回反注册函数。 */
+export async function loadFonts(defs: import('@/core/export-engine/fonts').FontFaceDef[]): Promise<() => void> {
+  if (typeof document === 'undefined' || !('fonts' in document)) return () => {}
+  const fontsApi = (document as unknown as { fonts: { add(f: FontFace): void; delete(f: FontFace): void } }).fonts
+  const faces: FontFace[] = []
+  for (const d of defs) {
+    const ff = new FontFace(d.family, `url(${d.src})`, {
+      weight: d.weight !== undefined ? String(d.weight) : 'normal',
+      style: d.style ?? 'normal',
+    })
+    await ff.load()
+    fontsApi.add(ff)
+    faces.push(ff)
+  }
+  return () => {
+    for (const ff of faces) fontsApi.delete(ff)
+  }
+}
diff --git a/openprint/src/core/layout-engine/aggregate.spec.ts b/openprint/src/core/layout-engine/aggregate.spec.ts
new file mode 100644
index 0000000..2cea3af
--- /dev/null
+++ b/openprint/src/core/layout-engine/aggregate.spec.ts
@@ -0,0 +1,388 @@
+import { describe, expect, it } from 'vitest'
+
+import {
+  aggValueForRows,
+  columnAggregatable,
+  footerKindOf,
+  formatAggNumber,
+  isAggToken,
+  parseAggToken,
+  stripItems,
+  toChineseCapitalRMB,
+} from '@/core/layout-engine/aggregate'
+import { buildTableModel, sliceTable } from '@/core/layout-engine/table-engine'
+import {
+  buildDesignGrid,
+  insertTableColumn,
+  insertTableRow,
+  rowRoleLabel,
+  seedSummaryTail,
+} from '@/core/layout-engine/table-cells'
+import type { TableCell, TableColumn, TableControl } from '@/types/control'
+import type { EvalContext } from './types'
+import { createCjkMeasurer } from '@/core/__tests__/cjk-measurer'
+
+/* ============================ 纯函数 ============================ */
+
+describe('parseAggToken / isAggToken', () => {
+  it('识别各类聚合 token', () => {
+    expect(parseAggToken('{{#pageSum}}')).toBe('pageSum')
+    expect(parseAggToken('{{#totalSum}}')).toBe('totalSum')
+    expect(parseAggToken('{{#pageCap}}')).toBe('pageCap')
+    expect(parseAggToken('{{#totalCap}}')).toBe('totalCap')
+    expect(parseAggToken('{{#pageAvg}}')).toBe('pageAvg')
+    expect(parseAggToken('{{ #totalCount }}')).toBe('totalCount')
+  })
+  it('非 token 返回 null', () => {
+    expect(parseAggToken('{{item.qty}}')).toBeNull()
+    expect(parseAggToken('本页合计')).toBeNull()
+    expect(parseAggToken('{{order.total}}')).toBeNull()
+    expect(isAggToken('{{#totalSum}}')).toBe(true)
+    expect(isAggToken('总量')).toBe(false)
+  })
+  it('footerKindOf 归类', () => {
+    expect(footerKindOf('pageSum')).toBe('pageSubtotal')
+    expect(footerKindOf('totalSum')).toBe('grandTotal')
+    expect(footerKindOf('totalCap')).toBe('capital')
+    expect(footerKindOf(null)).toBe('static')
+  })
+})
+
+describe('stripItems', () => {
+  it('去除 items[]. 前缀', () => {
+    expect(stripItems('items[].amount')).toBe('amount')
+    expect(stripItems('order.no')).toBe('order.no')
+    expect(stripItems(undefined)).toBe('')
+  })
+})
+
+describe('aggValueForRows', () => {
+  const rows = [
+    { qty: 2, price: 3 },
+    { qty: 3, price: 4 },
+  ]
+  it('求和', () => {
+    expect(aggValueForRows('totalSum', rows, 'qty')).toBe(5)
+    expect(aggValueForRows('pageSum', rows, 'price')).toBe(7)
+  })
+  it('平均', () => {
+    expect(aggValueForRows('totalAvg', rows, 'price')).toBe(3.5)
+  })
+  it('计数', () => {
+    expect(aggValueForRows('totalCount', rows, 'qty')).toBe(2)
+  })
+})
+
+describe('formatAggNumber', () => {
+  it('整数不带小数，小数保留两位并加千分位', () => {
+    expect(formatAggNumber(18)).toBe('18')
+    expect(formatAggNumber(22650)).toBe('22,650')
+    expect(formatAggNumber(18.5)).toBe('18.50')
+    expect(formatAggNumber(1234567.5)).toBe('1,234,567.50')
+  })
+})
+
+describe('toChineseCapitalRMB', () => {
+  it('整数大写', () => {
+    expect(toChineseCapitalRMB(22650)).toBe('贰万贰仟陆佰伍拾元整')
+    expect(toChineseCapitalRMB(18)).toBe('壹拾捌元整')
+    expect(toChineseCapitalRMB(100)).toBe('壹佰元整')
+    expect(toChineseCapitalRMB(1000000)).toBe('壹佰万元整')
+  })
+  it('小数（角/分）', () => {
+    expect(toChineseCapitalRMB(100.05)).toBe('壹佰元零伍分')
+    expect(toChineseCapitalRMB(100.5)).toBe('壹佰元伍角')
+    expect(toChineseCapitalRMB(0.05)).toBe('伍分')
+  })
+  it('零与负数', () => {
+    expect(toChineseCapitalRMB(0)).toBe('零元整')
+    expect(toChineseCapitalRMB(-22650)).toBe('负贰万贰仟陆佰伍拾元整')
+  })
+})
+
+describe('columnAggregatable', () => {
+  it('显式 aggregate 优先', () => {
+    expect(columnAggregatable({ title: 'x', field: 'a', width: 10, aggregate: false }, undefined)).toBe(false)
+    expect(columnAggregatable({ title: 'x', field: 'a', width: 10, aggregate: true }, undefined)).toBe(true)
+  })
+  it('按数据首行采样推断数值列', () => {
+    const col = { title: '金额', field: 'items[].amount', width: 10 }
+    expect(columnAggregatable(col, { amount: 5 })).toBe(true)
+    expect(columnAggregatable(col, { amount: 'abc' })).toBe(false)
+    expect(columnAggregatable({ title: '名称', field: 'items[].name', width: 10 }, { name: 'x' })).toBe(false)
+  })
+})
+
+/* ====================== 引擎：尾行聚合集成 ====================== */
+
+function mkTailTable(): TableControl {
+  const columns: TableColumn[] = [
+    { title: '序号', expression: '{{rowIndex + 1}}', width: 15, align: 'center' },
+    { title: '名称', field: 'items[].name', width: 60 },
+    { title: '数量', field: 'items[].qty', width: 25, align: 'right', aggregate: true },
+    { title: '单价', field: 'items[].price', width: 30, align: 'right', aggregate: true },
+    { title: '金额', field: 'items[].amount', width: 30, align: 'right', aggregate: true },
+  ]
+  const cells: TableCell[][] = [
+    [
+      { text: '序号' },
+      { text: '名称' },
+      { text: '数量' },
+      { text: '单价' },
+      { text: '金额' },
+    ],
+    [
+      { expression: '{{rowIndex + 1}}' },
+      { field: 'items[].name' },
+      { field: 'items[].qty' },
+      { field: 'items[].price' },
+      { field: 'items[].amount' },
+    ],
+    [
+      { text: '本页合计', style: { bold: true } },
+      {},
+      { text: '{{#pageSum}}', style: { bold: true, align: 'right' } },
+      { text: '{{#pageSum}}', style: { bold: true, align: 'right' } },
+      { text: '{{#pageSum}}', style: { bold: true, align: 'right' } },
+    ],
+    [
+      { text: '总计', style: { bold: true } },
+      {},
+      { text: '{{#totalSum}}', style: { bold: true, align: 'right' } },
+      { text: '{{#totalSum}}', style: { bold: true, align: 'right' } },
+      { text: '{{#totalSum}}', style: { bold: true, align: 'right' } },
+    ],
+    [
+      { text: '大写金额', style: { bold: true } },
+      {},
+      {},
+      {},
+      { text: '{{#totalCap}}', style: { bold: true } },
+    ],
+  ]
+  const data = [
+    { name: 'a', qty: 1, price: 10, amount: 10 },
+    { name: 'b', qty: 2, price: 10, amount: 20 },
+    { name: 'c', qty: 3, price: 10, amount: 30 },
+    { name: 'd', qty: 4, price: 10, amount: 40 },
+    { name: 'e', qty: 5, price: 10, amount: 50 },
+  ]
+  return {
+    id: 't',
+    type: 'table',
+    left: 0,
+    top: 0,
+    width: 160,
+    height: 60,
+    columns,
+    cells,
+    headerRows: 1,
+    staticRows: 3,
+    data,
+    options: { repeatHeader: true, repeatFooter: true, pageRows: 'auto', borders: 'all' },
+  }
+}
+
+function aggCellText(footer: { cells: { text?: string }[] }, col: number): string {
+  return footer.cells[col]?.text ?? ''
+}
+
+describe('buildTableModel —— 尾行聚合结构', () => {
+  const measurer = createCjkMeasurer()
+  const ctx: EvalContext = { data: { items: [] } }
+  const model = buildTableModel({ control: mkTailTable(), ctx, measurer, widthMm: 160, heightMm: 60 })
+
+  it('尾行被识别为 pageSubtotal / grandTotal / capital', () => {
+    expect(model.footerRows).toHaveLength(3)
+    expect(model.footerRows[0]!.footerKind).toBe('pageSubtotal')
+    expect(model.footerRows[1]!.footerKind).toBe('grandTotal')
+    expect(model.footerRows[2]!.footerKind).toBe('capital')
+  })
+
+  it('数值列 token 被标记 isAgg + aggField，字符串列不计算', () => {
+    const pageRow = model.footerRows[0]!
+    // 数量列（index2）应为聚合单元格
+    expect(pageRow.cells[2]!.isAgg).toBe(true)
+    expect(pageRow.cells[2]!.aggField).toBe('qty')
+    expect(pageRow.cells[2]!.tokenKind).toBe('pageSum')
+    // 名称列（index1）无 token
+    expect(pageRow.cells[1]!.isAgg).toBeFalsy()
+    expect(pageRow.cells[1]!.text).toBe('')
+  })
+
+  it('单页切片：本页合计=总计=全量，大写金额为整表总计', () => {
+    const slice = sliceTable(model, { avail: 1000, start: 0 })
+    expect(slice.isLast).toBe(true)
+    const f = slice.footerRows
+    expect(f).toHaveLength(3)
+    // 数量：1+2+3+4+5=15
+    expect(aggCellText(f[0]!, 2)).toBe('15')
+    expect(aggCellText(f[1]!, 2)).toBe('15')
+    // 金额：10+20+30+40+50=150
+    expect(aggCellText(f[0]!, 4)).toBe('150')
+    expect(aggCellText(f[1]!, 4)).toBe('150')
+    // 大写金额 = 壹佰伍拾元整
+    expect(aggCellText(f[2]!, 4)).toBe('壹佰伍拾元整')
+  })
+})
+
+describe('sliceTable —— 强制分页时本页合计逐页、总计仅末页', () => {
+  const measurer = createCjkMeasurer()
+  const ctx: EvalContext = { data: { items: [] } }
+  const control: TableControl = { ...mkTailTable(), options: { repeatHeader: true, repeatFooter: true, pageRows: 2, borders: 'all' } }
+  const model = buildTableModel({ control, ctx, measurer, widthMm: 160, heightMm: 60 })
+
+  it('第 1 页（非末页）只有本页合计，不含总计/大写', () => {
+    const s1 = sliceTable(model, { avail: 1000, start: 0 })
+    expect(s1.isLast).toBe(false)
+    // 本页合计 = 前 2 行：数量 1+2=3，金额 10+20=30
+    expect(aggCellText(s1.footerRows[0]!, 2)).toBe('3')
+    expect(aggCellText(s1.footerRows[0]!, 4)).toBe('30')
+    // 末页专属行不出现
+    expect(s1.footerRows.find((r) => r.footerKind === 'grandTotal')).toBeUndefined()
+    expect(s1.footerRows.find((r) => r.footerKind === 'capital')).toBeUndefined()
+  })
+
+  it('末页同时含本页合计、总计与大写金额', () => {
+    // 5 行 / 每页 2 → 第 3 页（start=4）为末页，仅 1 行
+    const s3 = sliceTable(model, { avail: 1000, start: 4 })
+    expect(s3.isLast).toBe(true)
+    expect(s3.footerRows.find((r) => r.footerKind === 'grandTotal')).toBeTruthy()
+    expect(s3.footerRows.find((r) => r.footerKind === 'capital')).toBeTruthy()
+    // 末页本页合计 = 第 5 行：数量 5，金额 50
+    expect(aggCellText(s3.footerRows[0]!, 2)).toBe('5')
+    expect(aggCellText(s3.footerRows[0]!, 4)).toBe('50')
+    // 总计仍为全量 15 / 150
+    const grand = s3.footerRows.find((r) => r.footerKind === 'grandTotal')!
+    expect(aggCellText(grand, 2)).toBe('15')
+    expect(aggCellText(grand, 4)).toBe('150')
+    // 大写金额取整表金额总计
+    const cap = s3.footerRows.find((r) => r.footerKind === 'capital')!
+    expect(aggCellText(cap, 4)).toBe('壹佰伍拾元整')
+  })
+})
+
+/* ====================== seedSummaryTail / 行角色 ====================== */
+
+describe('seedSummaryTail', () => {
+  it('自动植入三行尾结构并标记数值列 aggregate', () => {
+    const base: TableControl = {
+      id: 't',
+      type: 'table',
+      left: 0,
+      top: 0,
+      width: 160,
+      height: 60,
+      columns: [
+        { title: '名称', field: 'items[].name', width: 60 },
+        { title: '数量', field: 'items[].qty', width: 25, align: 'right' },
+        { title: '金额', field: 'items[].amount', width: 30, align: 'right' },
+      ],
+      headerRows: 1,
+      data: [
+        { name: 'a', qty: 1, amount: 10 },
+        { name: 'b', qty: 2, amount: 20 },
+      ],
+      options: { repeatHeader: true, repeatFooter: true, pageRows: 'auto', borders: 'all' },
+    }
+    const seeded = seedSummaryTail(base)
+    const grid = buildDesignGrid(seeded)
+    expect(grid.rowCount).toBe(5) // 1 表头 + 1 数据 + 3 尾
+    // 金额列（index2）被标记 aggregate
+    expect(seeded.columns[2]!.aggregate).toBe(true)
+    // 尾行含 token
+    const lastRows = grid.cells.slice(grid.headerRows + 1)
+    expect(lastRows.some((r) => r.some((c) => c.text === '{{#pageSum}}'))).toBe(true)
+    expect(lastRows.some((r) => r.some((c) => c.text === '{{#totalCap}}'))).toBe(true)
+  })
+
+  it('幂等：已植入则不重复', () => {
+    const base: TableControl = {
+      id: 't',
+      type: 'table',
+      left: 0,
+      top: 0,
+      width: 160,
+      height: 60,
+      columns: [
+        { title: '名称', field: 'items[].name', width: 60 },
+        { title: '金额', field: 'items[].amount', width: 30, align: 'right' },
+      ],
+      headerRows: 1,
+      data: [{ name: 'a', amount: 1 }],
+      options: { pageRows: 'auto' },
+    }
+    const once = seedSummaryTail(base)
+    const twice = seedSummaryTail(once)
+    expect(buildDesignGrid(twice).rowCount).toBe(buildDesignGrid(once).rowCount)
+  })
+})
+
+describe('rowRoleLabel', () => {
+  it('聚合尾行返回正确角色名', () => {
+    const seeded = seedSummaryTail({
+      id: 't',
+      type: 'table',
+      left: 0,
+      top: 0,
+      width: 160,
+      height: 60,
+      columns: [
+        { title: '名称', field: 'items[].name', width: 60 },
+        { title: '金额', field: 'items[].amount', width: 30, align: 'right' },
+      ],
+      headerRows: 1,
+      data: [{ name: 'a', amount: 1 }],
+      options: { pageRows: 'auto' },
+    })
+    const grid = buildDesignGrid(seeded)
+    expect(rowRoleLabel(grid, 0)).toBe('标题行')
+    expect(rowRoleLabel(grid, 1)).toBe('数据行')
+    // 尾行：本页合计 / 总计 / 大写金额
+    expect(rowRoleLabel(grid, 2)).toBe('本页合计行')
+    expect(rowRoleLabel(grid, 3)).toBe('总计行')
+    expect(rowRoleLabel(grid, 4)).toBe('大写金额行')
+  })
+})
+
+describe('insertTableRow / insertTableColumn', () => {
+  it('插入行后行数+1，数据表维持单数据样例行', () => {
+    const base: TableControl = {
+      id: 't',
+      type: 'table',
+      left: 0,
+      top: 0,
+      width: 160,
+      height: 60,
+      columns: [{ title: 'A', field: 'items[].a', width: 30 }],
+      headerRows: 1,
+      data: [{ a: 1 }],
+      options: { pageRows: 'auto' },
+    }
+    const seeded = seedSummaryTail(base) // 5 行
+    const withRow = insertTableRow(seeded, 3) // 在第 3 行（本页合计）上方插入
+    const grid = buildDesignGrid(withRow)
+    expect(grid.rowCount).toBe(6)
+    expect(grid.staticRows).toBe(4)
+  })
+
+  it('插入列后列数+1，每行单元格同步扩展', () => {
+    const base: TableControl = {
+      id: 't',
+      type: 'table',
+      left: 0,
+      top: 0,
+      width: 160,
+      height: 60,
+      columns: [{ title: 'A', field: 'items[].a', width: 30 }],
+      headerRows: 1,
+      data: [{ a: 1 }],
+      options: { pageRows: 'auto' },
+    }
+    const withCol = insertTableColumn(base, 1) // 在列 1 左侧插入
+    expect(withCol.columns).toHaveLength(2)
+    const grid = buildDesignGrid(withCol)
+    expect(grid.colCount).toBe(2)
+    expect(grid.cells.every((r) => r.length === 2)).toBe(true)
+  })
+})
diff --git a/openprint/src/core/layout-engine/aggregate.ts b/openprint/src/core/layout-engine/aggregate.ts
new file mode 100644
index 0000000..9f1af23
--- /dev/null
+++ b/openprint/src/core/layout-engine/aggregate.ts
@@ -0,0 +1,212 @@
+/**
+ * aggregate —— 表格尾行（本页合计 / 总计 / 大写金额）聚合引擎（纯函数，可测）
+ *
+ * 设计要点（与用户需求对齐）：
+ * - 表格默认结构 = 标题行 + 数据行 + 本页合计行 + 总计行 + 大写金额行。
+ * - 尾行的「计算单元格」用约定表达式占位：
+ *   - `{{#pageSum}}`  本页合计（每页只算本页数据行）
+ *   - `{{#totalSum}}` 总计（整表所有数据行，仅末页出现）
+ *   - `{{#pageCap}}`  本页合计大写金额
+ *   - `{{#totalCap}}` 总计大写金额（如 贰万贰仟陆佰伍拾元整，仅末页出现）
+ *   - 另有 `{{#pageAvg}}`/`{{#totalAvg}}`/`{{#pageCount}}`/`{{#totalCount}}` 可用。
+ * - 单元格里凡不是聚合 token 的 `{{}}` 视为普通插值；完全不含 `{{}}` 的字面量视为静态文本。
+ * - 哪一列需要合计：由列字段类型（或数据行首行采样）判断，非数值列（字符串等）不计算。
+ * - 合计整数不带小数、小数保留两位；大写金额按人民币大写规则转换。
+ */
+import type { TableColumn } from '@/types/control'
+
+/* -------------------------------- Token 解析 -------------------------------- */
+
+export type AggKind =
+  | 'pageSum'
+  | 'totalSum'
+  | 'pageAvg'
+  | 'totalAvg'
+  | 'pageCount'
+  | 'totalCount'
+  | 'pageCap'
+  | 'totalCap'
+
+/** 解析单元格文本是否为聚合 token；返回具体类型或 null */
+export function parseAggToken(text: string | undefined): AggKind | null {
+  if (!text) return null
+  const m = /^\{\{\s*#(pageSum|totalSum|pageAvg|totalAvg|pageCount|totalCount|pageCap|totalCap)\s*\}\}$/.exec(
+    text.trim(),
+  )
+  return m ? (m[1] as AggKind) : null
+}
+
+/** 该文本是否为聚合 token */
+export function isAggToken(text: string | undefined): boolean {
+  return parseAggToken(text) !== null
+}
+
+/** token 所在的尾行类别 */
+export type FooterKind = 'pageSubtotal' | 'grandTotal' | 'capital' | 'static'
+
+export function footerKindOf(kind: AggKind | null): FooterKind {
+  if (kind === 'pageCap' || kind === 'totalCap') return 'capital'
+  if (kind === 'totalSum' || kind === 'totalAvg' || kind === 'totalCount') return 'grandTotal'
+  if (kind === 'pageSum' || kind === 'pageAvg' || kind === 'pageCount') return 'pageSubtotal'
+  return 'static'
+}
+
+/* -------------------------------- 字段工具 -------------------------------- */
+
+/** 去 `items[].` 前缀，得到数据行字段键（items[].amount → amount） */
+export function stripItems(field: string | undefined): string {
+  if (!field) return ''
+  return field.includes('[].') ? field.slice(field.indexOf('[].') + 3) : field
+}
+
+function toNum(v: unknown): number {
+  if (typeof v === 'number') return v
+  if (v === null || v === undefined || v === '') return 0
+  const n = Number(v)
+  return Number.isNaN(n) ? 0 : n
+}
+
+/* -------------------------------- 聚合求值 -------------------------------- */
+
+export function sumField(rows: Array<Record<string, unknown>>, field: string): number {
+  let s = 0
+  for (const r of rows) s += toNum(r[field])
+  return s
+}
+
+export function avgField(rows: Array<Record<string, unknown>>, field: string): number {
+  return rows.length ? sumField(rows, field) / rows.length : 0
+}
+
+/** 按 token 类别，对给定数据行集合在 field 上求值 */
+export function aggValueForRows(
+  kind: AggKind,
+  rows: Array<Record<string, unknown>>,
+  field: string,
+): number {
+  switch (kind) {
+    case 'pageSum':
+    case 'totalSum':
+      return sumField(rows, field)
+    case 'pageAvg':
+    case 'totalAvg':
+      return avgField(rows, field)
+    case 'pageCount':
+    case 'totalCount':
+      return rows.length
+    default:
+      return 0
+  }
+}
+
+/**
+ * 聚合数值显示：整数不带小数（默认整数计算），小数保留两位，统一加千分位。
+ * 对齐 table-engine 的 formatAggregate 行为；字符串等非数值列不计算（调用方应已跳过）。
+ */
+export function formatAggNumber(v: number): string {
+  const fixed = Number.isInteger(v) ? v.toFixed(0) : v.toFixed(2)
+  const [int = '0', dec] = fixed.split('.')
+  const sign = int.startsWith('-') ? '-' : ''
+  const grouped = (sign ? int.slice(1) : int).replace(/\B(?=(\d{3})+(?!\d))/g, ',')
+  return sign + grouped + (dec ? `.${dec}` : '')
+}
+
+/* ------------------------------ 大写人民币转换 ------------------------------ */
+
+const DIGITS = ['零', '壹', '贰', '叁', '肆', '伍', '陆', '柒', '捌', '玖']
+const SMALL_UNITS = ['', '拾', '佰', '仟']
+// 每 4 位一组的大单位：个 / 万 / 亿 / 兆
+const GROUP_UNITS = ['', '万', '亿', '兆']
+
+/** 0..9999 → 中文（不含组单位），并返回本组是否含非零位 */
+function groupToChinese(num: number): { text: string; hasNonZero: boolean } {
+  const s = String(num).padStart(4, '0')
+  let result = ''
+  let zero = false
+  let hasNonZero = false
+  for (let i = 0; i < 4; i++) {
+    const d = Number(s[i])
+    if (d === 0) {
+      zero = true
+    } else {
+      if (zero && result) result += DIGITS[0]
+      result += (DIGITS[d] ?? '') + (SMALL_UNITS[3 - i] ?? '')
+      zero = false
+      hasNonZero = true
+    }
+  }
+  return { text: result, hasNonZero }
+}
+
+/** 非负整数 → 中文数字（正确处理 万/亿 分组与组间零） */
+function integerToChinese(n: number): string {
+  if (n === 0) return DIGITS[0] ?? '零'
+  if (n < 0) return '负' + integerToChinese(-n)
+  // 按 4 位拆组（高位在前）
+  const groups: number[] = []
+  let rem = Math.floor(n)
+  while (rem > 0) {
+    groups.unshift(rem % 10000)
+    rem = Math.floor(rem / 10000)
+  }
+  let result = ''
+  for (let g = 0; g < groups.length; g++) {
+    const { text, hasNonZero } = groupToChinese(groups[g] ?? 0)
+    if (hasNonZero) {
+      result += text + (GROUP_UNITS[groups.length - 1 - g] ?? '')
+    } else if (g < groups.length - 1 && result && !result.endsWith(DIGITS[0] ?? '零')) {
+      // 整组为 0（且非最低组）→ 在高位与低位之间补一个"零"连接
+      result += DIGITS[0] ?? '零'
+    }
+  }
+  return result
+}
+
+/**
+ * 金额 → 中文大写人民币（如 22650 → 贰万贰仟陆佰伍拾元整）。
+ * - 支持整数与两位小数（角/分），第三位小数四舍五入。
+ * - 负数加「负」前缀；零金额返回「零元整」。
+ */
+export function toChineseCapitalRMB(input: number): string {
+  if (!Number.isFinite(input)) return ''
+  const negative = input < 0
+  const amount = Math.abs(Math.round(input * 100) / 100)
+  if (amount === 0) return '零元整'
+
+  const intPart = Math.floor(amount)
+  const decPart = Math.round((amount - intPart) * 100) // 0..99
+  const jiao = Math.floor(decPart / 10)
+  const fen = decPart % 10
+
+  let result = ''
+  if (intPart > 0) result += integerToChinese(intPart) + '元'
+  if (jiao === 0 && fen === 0) {
+    result += '整'
+  } else {
+    if (jiao > 0) result += (DIGITS[jiao] ?? '') + '角'
+    else if (intPart > 0) result += DIGITS[0] ?? '零' // 元后零角（如 100.05 → 壹佰元零伍分）
+    if (fen > 0) result += (DIGITS[fen] ?? '') + '分'
+  }
+  return (negative ? '负' : '') + result
+}
+
+/* ------------------------------ 列聚合判定 ------------------------------ */
+
+/**
+ * 某列是否参与聚合（计算合计）。
+ * - 显式 `aggregate:false` → 不参与。
+ * - 显式 `aggregate:true` 或 `'sum'`/`'avg'`/`'count'` → 参与。
+ * - 否则按数据首行采样推断：列字段在数据行里出现数值则参与（字符串等类型不计算）。
+ */
+export function columnAggregatable(
+  col: TableColumn | undefined,
+  sample: Record<string, unknown> | undefined,
+): boolean {
+  if (!col) return false
+  if (col.aggregate === false) return false
+  if (col.aggregate === true || col.aggregate === 'sum' || col.aggregate === 'avg' || col.aggregate === 'count')
+    return true
+  const key = stripItems(col.field)
+  if (key && sample && typeof sample[key] === 'number') return true
+  return false
+}
diff --git a/openprint/src/core/layout-engine/cell-format.spec.ts b/openprint/src/core/layout-engine/cell-format.spec.ts
new file mode 100644
index 0000000..4d91b7e
--- /dev/null
+++ b/openprint/src/core/layout-engine/cell-format.spec.ts
@@ -0,0 +1,67 @@
+import { describe, expect, it } from 'vitest'
+import { formatCellValue } from './expression'
+import type { CellFormat } from '@/types/control'
+
+describe('formatCellValue —— 单元格数据格式', () => {
+  it('undefined / none / text 回落默认 stringify', () => {
+    expect(formatCellValue(123, undefined)).toBe('123')
+    expect(formatCellValue(123, { kind: 'none' })).toBe('123')
+    expect(formatCellValue(123, { kind: 'text' })).toBe('123')
+    expect(formatCellValue(null, undefined)).toBe('')
+  })
+
+  it('date：按模板输出（年-月-日 / 年月日 / 美式）', () => {
+    const d = new Date(2026, 7, 11) // 2026-08-11（本地，稳定）
+    expect(formatCellValue(d, { kind: 'date', pattern: 'YYYY-MM-DD' })).toBe('2026-08-11')
+    expect(formatCellValue(d, { kind: 'date', pattern: 'YYYY年MM月DD日' })).toBe('2026年08月11日')
+    expect(formatCellValue(d, { kind: 'date', pattern: 'MM/DD/YYYY' })).toBe('08/11/2026')
+  })
+
+  it('date：带时间模板', () => {
+    const d = new Date(2026, 7, 11, 14, 30)
+    expect(formatCellValue(d, { kind: 'date', pattern: 'YYYY-MM-DD HH:mm' })).toBe('2026-08-11 14:30')
+  })
+
+  it('date：默认模板为 YYYY-MM-DD', () => {
+    const d = new Date(2026, 7, 11)
+    expect(formatCellValue(d, { kind: 'date' })).toBe('2026-08-11')
+  })
+
+  it('int：默认带千分位；thousands=false 不分组', () => {
+    expect(formatCellValue(1234567, { kind: 'int' })).toBe('1,234,567')
+    expect(formatCellValue(1234567, { kind: 'int', thousands: false })).toBe('1234567')
+    expect(formatCellValue(0, { kind: 'int' })).toBe('0')
+  })
+
+  it('decimal：按 digits 截断；千分位可关', () => {
+    expect(formatCellValue(1234.567, { kind: 'decimal', digits: 2 })).toBe('1,234.57')
+    expect(formatCellValue(1234.5, { kind: 'decimal', digits: 0 })).toBe('1,235')
+    expect(formatCellValue(1234.567, { kind: 'decimal', digits: 2, thousands: false })).toBe('1234.57')
+  })
+
+  it('currency：符号 + 千分位 + 小数位', () => {
+    expect(formatCellValue(12800.5, { kind: 'currency' })).toBe('¥12,800.50')
+    expect(formatCellValue(1200.5, { kind: 'currency', code: 'USD' })).toBe('$1,200.50')
+    expect(formatCellValue(9.9, { kind: 'currency', code: 'EUR', digits: 1 })).toBe('€9.9')
+  })
+
+  it('percent：数值 ×100 加 %', () => {
+    expect(formatCellValue(0.125, { kind: 'percent' })).toBe('12.50%')
+    expect(formatCellValue(0.125, { kind: 'percent', digits: 1 })).toBe('12.5%')
+    expect(formatCellValue(1, { kind: 'percent' })).toBe('100.00%')
+  })
+
+  it('digits 越界被收敛到 [0,6]', () => {
+    expect(formatCellValue(1.23456789, { kind: 'decimal', digits: 99 })).toBe('1.234568')
+    expect(formatCellValue(1.23456789, { kind: 'decimal', digits: -5 })).toBe('1')
+  })
+
+  it('非数字输入按 0 处理（与引擎 toNum 一致）', () => {
+    expect(formatCellValue('abc', { kind: 'int' })).toBe('0')
+    expect(formatCellValue('', { kind: 'decimal' })).toBe('0.00')
+  })
+})
+
+/** 类型守卫：确保 CellFormat 联合在编译期被消费（防止误删成员） */
+const _kinds: CellFormat['kind'][] = ['none', 'text', 'date', 'int', 'decimal', 'currency', 'percent']
+void _kinds
diff --git a/openprint/src/core/layout-engine/data-binder.spec.ts b/openprint/src/core/layout-engine/data-binder.spec.ts
new file mode 100644
index 0000000..0080692
--- /dev/null
+++ b/openprint/src/core/layout-engine/data-binder.spec.ts
@@ -0,0 +1,79 @@
+import { describe, expect, it } from 'vitest'
+import { resolveTextValue, resolveControlContent } from './data-binder'
+import type { TextControl } from '@/types/control'
+import type { EvalContext } from './types'
+
+function text(partial: Partial<TextControl>): TextControl {
+  return { id: 't1', type: 'text', left: 0, top: 0, width: 50, height: 10, ...partial }
+}
+
+describe('resolveTextValue —— 文本控件格式化', () => {
+  const ctx: EvalContext = { data: { order: { date: '2026-08-11', total: 12800.5, qty: 1234.5, rate: 0.125 } } }
+
+  it('无 format 时回落默认 stringify', () => {
+    const r = resolveTextValue(text({ binding: 'order.total' }), ctx)
+    expect(r.text).toBe('12800.5')
+  })
+
+  it('日期格式', () => {
+    const r = resolveTextValue(
+      text({ binding: 'order.date', format: { kind: 'date', pattern: 'YYYY年MM月DD日' } }),
+      ctx,
+    )
+    expect(r.text).toBe('2026年08月11日')
+  })
+
+  it('整数 + 千分位', () => {
+    const r = resolveTextValue(
+      text({ binding: 'order.qty', format: { kind: 'int', thousands: true } }),
+      ctx,
+    )
+    expect(r.text).toBe('1,235')
+  })
+
+  it('小数 + 千分位', () => {
+    const r = resolveTextValue(
+      text({ binding: 'order.total', format: { kind: 'decimal', digits: 2, thousands: true } }),
+      ctx,
+    )
+    expect(r.text).toBe('12,800.50')
+  })
+
+  it('货币', () => {
+    const r = resolveTextValue(
+      text({ binding: 'order.total', format: { kind: 'currency', code: 'USD', digits: 2, thousands: true } }),
+      ctx,
+    )
+    expect(r.text).toBe('$12,800.50')
+  })
+
+  it('百分比', () => {
+    const r = resolveTextValue(
+      text({ binding: 'order.rate', format: { kind: 'percent', digits: 1 } }),
+      ctx,
+    )
+    expect(r.text).toBe('12.5%')
+  })
+
+  it('expression 模式不被 format 影响（过滤器优先）', () => {
+    const r = resolveTextValue(
+      text({ expression: '{{order.total | currency:\'CNY\'}}', format: { kind: 'int' } }),
+      ctx,
+    )
+    expect(r.text).toContain('12,800.50')
+  })
+})
+
+describe('resolveControlContent —— 文本格式贯穿渲染', () => {
+  const ctx: EvalContext = { data: { order: { date: '2026-08-11' } } }
+
+  it('绑定字段按 format 输出（走 content 解析总入口）', async () => {
+    const { content, warnings } = await resolveControlContent(
+      text({ id: 't2', binding: 'order.date', format: { kind: 'date', pattern: 'MM/DD/YYYY' } }),
+      ctx,
+    )
+    expect(content.kind).toBe('text')
+    if (content.kind === 'text') expect(content.text).toBe('08/11/2026')
+    expect(warnings).toEqual([])
+  })
+})
diff --git a/openprint/src/core/layout-engine/data-binder.ts b/openprint/src/core/layout-engine/data-binder.ts
new file mode 100644
index 0000000..b5ec747
--- /dev/null
+++ b/openprint/src/core/layout-engine/data-binder.ts
@@ -0,0 +1,248 @@
+/**
+ * DataBinder —— 控件 + 数据 → 渲染就绪内容
+ * 真理源：《OpenPrint-设计方案.md》§5.2 / §5.4a（printable）/ §5.6（visibleIf）/ §5.7 / §5.8
+ *
+ * 职责边界：
+ * - 只负责"内容是什么"，不负责"放在哪一页"（那是 pagination-engine 的事）
+ * - 所有异步资源（二维码 SVG）在此解析完成，后续渲染全同步
+ * - 条码/二维码统一输出 **SVG 矢量**（§5.7）：打印用位图会糊，扫码枪可能读不出
+ */
+import * as BwipJs from '@bwip-js/generic'
+import DOMPurify from 'dompurify'
+import QRCode from 'qrcode'
+
+import type {
+  AnyControl,
+  BarcodeControl,
+  ChartControl,
+  ImageControl,
+  QrcodeControl,
+  RichTextControl,
+  TextControl,
+} from '@/types/control'
+import { interpolate, evaluateVisible, resolveBinding, stringifyValue, formatCellValue } from './expression'
+import type { EvalContext, ResolvedContent, RenderWarning } from './types'
+import { renderChartControl } from '@/core/chartkit'
+
+/* ------------------------------ 可见性判定 ------------------------------ */
+
+/**
+ * 渲染期是否输出该控件。
+ * §5.4a：`printable:false` 渲染时跳过，但**设计画布仍可编辑**（所以只在这里过滤）。
+ */
+export function isControlPrintable(control: AnyControl, ctx: EvalContext): boolean {
+  if (control.printable === false) return false
+  return evaluateVisible(control.visibleIf, ctx)
+}
+
+/* -------------------------------- 文本 -------------------------------- */
+
+/**
+ * 文本取值优先级：expression > binding > value。
+ * 注意 `value` 里也允许写 `{{}}`（用户在属性面板静态文本里手打变量是常见操作），
+ * 所以静态文本同样过一遍插值。
+ */
+export function resolveTextValue(
+  control: TextControl,
+  ctx: EvalContext,
+): { text: string; errors: string[] } {
+  if (control.expression) return interpolate(control.expression, ctx)
+  if (control.binding) {
+    // binding 模式：按控件 format 格式化（expression 模式请用 {{field | date:'...'}} 过滤器）
+    const raw = resolveBinding(control.binding, ctx)
+    return { text: formatCellValue(raw, control.format), errors: [] }
+  }
+  return interpolate(control.value ?? '', ctx)
+}
+
+/* -------------------------------- 图片 -------------------------------- */
+
+function resolveImageSrc(control: ImageControl, ctx: EvalContext): string {
+  const v = control.value
+  if (!v || !v.content) return ''
+  switch (v.mode) {
+    case 'binding': {
+      const raw = resolveBinding(v.content, ctx)
+      return raw === null || raw === undefined ? '' : String(raw)
+    }
+    case 'inline':
+    case 'url':
+    case 'asset':
+    default:
+      return v.content
+  }
+}
+
+/* ------------------------------ 条码 / 二维码 ----------------------------- */
+
+function resolveCodeText(control: BarcodeControl | QrcodeControl, ctx: EvalContext): string {
+  if (control.binding) {
+    const v = resolveBinding(control.binding, ctx)
+    if (v !== null && v !== undefined && v !== '') return String(v)
+  }
+  if (control.value) return interpolate(control.value, ctx).text
+  // 既没 binding 也没 value：设计画布兜底示例码，预览同样兜底，避免空白
+  return control.type === 'qrcode' ? 'https://openprint.dev' : '0123456789'
+}
+
+/**
+ * 让 SVG 自适应控件尺寸：去掉固定 width/height，保留 viewBox 由外层容器缩放。
+ * bwip-js / qrcode 输出的 SVG 都带写死的 width/height，直接嵌入会溢出控件框。
+ */
+function makeSvgResponsive(svg: string): string {
+  return svg
+    .replace(/<svg([^>]*?)\swidth="[^"]*"/i, '<svg$1')
+    .replace(/<svg([^>]*?)\sheight="[^"]*"/i, '<svg$1')
+    .replace(/<svg\b/i, '<svg preserveAspectRatio="xMidYMid meet" width="100%" height="100%"')
+}
+
+function renderBarcodeSvg(control: BarcodeControl, text: string): string {
+  // 与设计画布 barcode-draw.ts 保持一致：按控件几何反算条码条高度，让文字行不被压扁
+  const controlHeightMM = control.height ?? 30
+  const barHeightMM = Math.max(2, controlHeightMM * 0.6)
+  const paddingMM = Math.max(0.5, controlHeightMM * 0.04)
+  const svg = BwipJs.toSVG({
+    bcid: (control.format ?? 'code128').toLowerCase(),
+    text,
+    scale: 2,
+    height: barHeightMM,
+    paddingtop: paddingMM,
+    paddingbottom: paddingMM,
+    includetext: control.showText ?? false,
+    textxalign: 'center',
+    textsize: 12,
+  })
+  return makeSvgResponsive(svg)
+}
+
+async function renderQrcodeSvg(control: QrcodeControl, text: string): Promise<string> {
+  const svg = await QRCode.toString(text, {
+    type: 'svg',
+    errorCorrectionLevel: control.errorLevel ?? 'M',
+    margin: 0,
+  })
+  return makeSvgResponsive(svg)
+}
+
+/* ------------------------------- 富文本消毒 ------------------------------ */
+
+/** §11.2：Renderer 输出前必须对绑定内容消毒，防模板注入 XSS */
+function sanitizeRichText(html: string): string {
+  return DOMPurify.sanitize(html, { USE_PROFILES: { html: true } })
+}
+
+/* ------------------------------ 内容解析总入口 ----------------------------- */
+
+export interface ResolvedControlContent {
+  content: ResolvedContent
+  warnings: RenderWarning[]
+}
+
+/**
+ * 把单个控件解析为渲染就绪内容。
+ * 任何失败都降级为 placeholder + warning —— **绝不静默丢内容**，
+ * 否则用户拿到一张缺字段的单据却毫不知情，这在 ERP 场景是事故。
+ */
+export async function resolveControlContent(
+  control: AnyControl,
+  ctx: EvalContext,
+): Promise<ResolvedControlContent> {
+  const warnings: RenderWarning[] = []
+
+  switch (control.type) {
+    case 'text': {
+      const { text, errors } = resolveTextValue(control, ctx)
+      for (const message of errors) {
+        warnings.push({ code: 'EXPRESSION_ERROR', message, controlId: control.id })
+      }
+      if (!text && control.binding) {
+        warnings.push({
+          code: 'BINDING_MISSING',
+          message: `字段 "${control.binding}" 在数据中为空`,
+          controlId: control.id,
+        })
+      }
+      return { content: { kind: 'text', text }, warnings }
+    }
+
+    case 'richtext': {
+      const raw = (control as RichTextControl).value ?? ''
+      const { text, errors } = interpolate(raw, ctx)
+      for (const message of errors) {
+        warnings.push({ code: 'EXPRESSION_ERROR', message, controlId: control.id })
+      }
+      return { content: { kind: 'html', html: sanitizeRichText(text) }, warnings }
+    }
+
+    case 'image': {
+      const src = resolveImageSrc(control, ctx)
+      if (!src) {
+        warnings.push({
+          code: 'IMAGE_UNRESOLVED',
+          message: '图片来源为空',
+          controlId: control.id,
+        })
+        return { content: { kind: 'placeholder', label: '图片' }, warnings }
+      }
+      return { content: { kind: 'image', src }, warnings }
+    }
+
+    case 'barcode': {
+      const text = resolveCodeText(control, ctx)
+      if (!text) {
+        warnings.push({ code: 'BARCODE_FAILED', message: '条码内容为空', controlId: control.id })
+        return { content: { kind: 'placeholder', label: '条码' }, warnings }
+      }
+      try {
+        return { content: { kind: 'svg', svg: renderBarcodeSvg(control, text) }, warnings }
+      } catch (e) {
+        warnings.push({
+          code: 'BARCODE_FAILED',
+          message: `条码生成失败（${control.format ?? 'code128'}）：${e instanceof Error ? e.message : String(e)}`,
+          controlId: control.id,
+        })
+        return { content: { kind: 'placeholder', label: '条码' }, warnings }
+      }
+    }
+
+    case 'qrcode': {
+      const text = resolveCodeText(control, ctx)
+      if (!text) {
+        warnings.push({ code: 'BARCODE_FAILED', message: '二维码内容为空', controlId: control.id })
+        return { content: { kind: 'placeholder', label: '二维码' }, warnings }
+      }
+      try {
+        return { content: { kind: 'svg', svg: await renderQrcodeSvg(control, text) }, warnings }
+      } catch (e) {
+        warnings.push({
+          code: 'BARCODE_FAILED',
+          message: `二维码生成失败：${e instanceof Error ? e.message : String(e)}`,
+          controlId: control.id,
+        })
+        return { content: { kind: 'placeholder', label: '二维码' }, warnings }
+      }
+    }
+
+    case 'rect':
+    case 'line':
+      return { content: { kind: 'shape' }, warnings }
+
+    case 'chart': {
+      // 原生 SVG 图表（零依赖）：与条码同理走矢量 svg，打印不糊。
+      try {
+        return { content: { kind: 'svg', svg: renderChartControl(control as ChartControl) }, warnings }
+      } catch (e) {
+        warnings.push({
+          code: 'CHART_FAILED',
+          message: `图表生成失败：${e instanceof Error ? e.message : String(e)}`,
+          controlId: control.id,
+        })
+        return { content: { kind: 'placeholder', label: '图表' }, warnings }
+      }
+    }
+
+    default:
+      // table / zone 不走这里（由 table-engine / pagination-engine 处理）
+      return { content: { kind: 'placeholder', label: control.type }, warnings }
+  }
+}
diff --git a/openprint/src/core/layout-engine/expression.spec.ts b/openprint/src/core/layout-engine/expression.spec.ts
new file mode 100644
index 0000000..2a6e0ed
--- /dev/null
+++ b/openprint/src/core/layout-engine/expression.spec.ts
@@ -0,0 +1,77 @@
+import { describe, expect, it } from 'vitest'
+
+import {
+  evaluate,
+  evaluateVisible,
+  interpolate,
+  resolveBinding,
+} from '@/core/layout-engine/expression'
+
+// EvalContext 必须有 data 字段；测试里无变量时用 { data: {} }
+
+
+describe('expression 安全表达式引擎', () => {
+  it('基础算术与优先级', () => {
+    expect(evaluate('1 + 2 * 3', { data: {} })).toBe(7)
+    expect(evaluate('(1 + 2) * 3', { data: {} })).toBe(9)
+    expect(evaluate('10 / 4', { data: {} })).toBe(2.5)
+  })
+
+  it('字符串拼接', () => {
+    expect(evaluate('"a" + "b"', { data: {} })).toBe('ab')
+    expect(evaluate('"x" + 1', { data: {} })).toBe('x1')
+  })
+
+  it('比较与逻辑', () => {
+    expect(evaluate('3 > 2', { data: {} })).toBe(true)
+    expect(evaluate('true && false', { data: {} })).toBe(false)
+    expect(evaluate('true || false', { data: {} })).toBe(true)
+    expect(evaluate('!false', { data: {} })).toBe(true)
+  })
+
+  it('变量从 ctx.data 取值', () => {
+    expect(evaluate('x * 2', { data: { x: 5 } })).toBe(10)
+    expect(evaluate('a + b', { data: { a: 2, b: 3 } })).toBe(5)
+  })
+
+  it('过滤器（经 interpolate 解析 {{ }} 管道）', () => {
+    expect(interpolate('{{name | upper}}', { data: { name: 'abc' } }).text).toBe('ABC')
+    expect(interpolate('{{name | lower}}', { data: { name: 'ABC' } }).text).toBe('abc')
+    expect(interpolate('{{v | number:0}}', { data: { v: 1234.5 } }).text).toBe('1,235')
+    expect(interpolate('{{amount | currency}}', { data: { amount: 12800.5 } }).text).toContain('12,800.50')
+    expect(interpolate('{{v | default:"无"}}', { data: { v: '' } }).text).toBe('无')
+    expect(interpolate('{{n | padStart:3}}', { data: { n: 7 } }).text).toBe('007')
+  })
+
+  it('resolveBinding 按路径取值', () => {
+    expect(resolveBinding('a.b', { data: { a: { b: 1 } } })).toBe(1)
+  })
+
+  it('interpolate 替换 {{ }}', () => {
+    expect(interpolate('{{x}}岁', { data: { x: 18 } }).text).toBe('18岁')
+    expect(interpolate('单价{{price|currency}}', { data: { price: 9.9 } }).text).toContain('9.90')
+    expect(interpolate('无占位', { data: {} }).text).toBe('无占位')
+  })
+
+  it('evaluateVisible 条件渲染', () => {
+    expect(evaluateVisible('', { data: {} })).toBe(true)
+    expect(evaluateVisible('  ', { data: {} })).toBe(true)
+    expect(evaluateVisible('false', { data: {} })).toBe(false)
+    expect(evaluateVisible('x > 3', { data: { x: 5 } })).toBe(true)
+    expect(evaluateVisible('x > 3', { data: { x: 1 } })).toBe(false)
+  })
+
+  // —— 安全边界：绝不能执行任意 JS ——
+  it('拒绝 eval / new Function / import 等代码注入', () => {
+    expect(() => evaluate('eval("x")', { data: {} })).toThrow()
+    expect(() => evaluate('new Function("return 1")', { data: {} })).toThrow()
+    expect(() => evaluate('import("x")', { data: {} })).toThrow()
+    expect(() => evaluate('window.location', { data: {} })).not.toThrow() // 读取未定义变量返回 undefined，而非执行
+    expect(evaluate('window.location', { data: {} })).toBeUndefined()
+  })
+
+  it('语法错误抛出', () => {
+    expect(() => evaluate('1 +', { data: {} })).toThrow()
+    expect(() => evaluate('@#$', { data: {} })).toThrow()
+  })
+})
diff --git a/openprint/src/core/layout-engine/expression.ts b/openprint/src/core/layout-engine/expression.ts
new file mode 100644
index 0000000..5740315
--- /dev/null
+++ b/openprint/src/core/layout-engine/expression.ts
@@ -0,0 +1,751 @@
+/**
+ * 表达式引擎 —— 绑定取值 / 插值 / 条件渲染的统一入口
+ * 真理源：《OpenPrint-设计方案.md》§5.3（表达式文本）、§5.6（条件渲染）、§5.4（列 expression）
+ *
+ * ## 为什么不用 mustache？
+ * §11.2 建议用 mustache 做 `resolveBinding()`，但 mustache 是**逻辑无关**模板引擎：
+ * 它无法求值 `{{rowIndex + 1}}`、`{{row.price * row.qty}}`（§5.4 列表达式的原文示例），
+ * 也不支持 `{{order.total | currency:'CNY'}}` 的过滤器语法（§5.3 原文示例）。
+ * 而 `new Function` / `eval` 方案在 ERP 场景不可接受（模板可能来自不可信的第三方设计者，
+ * 且企业环境常配 CSP `script-src` 白名单，eval 直接被拦）。
+ *
+ * 因此这里实现一个**受限安全求值器**：
+ * - 纯 Pratt 解析 + 树求值，无 new Function / eval / with
+ * - 白名单运算符，无函数调用、无属性赋值、无原型访问（__proto__ / constructor 被拒）
+ * - 只读取传入的 EvalContext，够不到全局对象
+ * 覆盖面严格 ⊇ mustache 的用途，且顺带解决 visibleIf，一个引擎服务三处。
+ */
+import type { EvalContext } from './types'
+import type { CellFormat } from '@/types/control'
+
+/* ================================ 词法分析 ================================ */
+
+type TokenType = 'num' | 'str' | 'ident' | 'op' | 'eof'
+
+interface Token {
+  type: TokenType
+  value: string
+  pos: number
+}
+
+/** 多字符运算符按长度降序，保证 `===` 不被切成 `==` + `=` */
+const OPERATORS = [
+  '===',
+  '!==',
+  '==',
+  '!=',
+  '>=',
+  '<=',
+  '&&',
+  '||',
+  '??',
+  '+',
+  '-',
+  '*',
+  '/',
+  '%',
+  '>',
+  '<',
+  '!',
+  '?',
+  ':',
+  '(',
+  ')',
+  '[',
+  ']',
+  '.',
+  ',',
+]
+
+function tokenize(src: string): Token[] {
+  const tokens: Token[] = []
+  let i = 0
+  while (i < src.length) {
+    const ch = src[i]!
+
+    // 空白
+    if (/\s/.test(ch)) {
+      i++
+      continue
+    }
+
+    // 字符串字面量（单/双引号，支持反斜杠转义）
+    if (ch === "'" || ch === '"') {
+      const quote = ch
+      let out = ''
+      let j = i + 1
+      while (j < src.length && src[j] !== quote) {
+        if (src[j] === '\\' && j + 1 < src.length) {
+          out += src[j + 1]
+          j += 2
+        } else {
+          out += src[j]
+          j++
+        }
+      }
+      tokens.push({ type: 'str', value: out, pos: i })
+      i = j + 1
+      continue
+    }
+
+    // 数字（含小数）
+    if (/[0-9]/.test(ch) || (ch === '.' && /[0-9]/.test(src[i + 1] ?? ''))) {
+      let j = i
+      while (j < src.length && /[0-9.]/.test(src[j]!)) j++
+      tokens.push({ type: 'num', value: src.slice(i, j), pos: i })
+      i = j
+      continue
+    }
+
+    // 标识符（含中文字段名，ERP 里很常见）
+    if (/[A-Za-z_$\u4e00-\u9fa5]/.test(ch)) {
+      let j = i
+      while (j < src.length && /[A-Za-z0-9_$\u4e00-\u9fa5]/.test(src[j]!)) j++
+      tokens.push({ type: 'ident', value: src.slice(i, j), pos: i })
+      i = j
+      continue
+    }
+
+    // 运算符
+    const op = OPERATORS.find((o) => src.startsWith(o, i))
+    if (op) {
+      tokens.push({ type: 'op', value: op, pos: i })
+      i += op.length
+      continue
+    }
+
+    throw new Error(`表达式非法字符 "${ch}"（位置 ${i}）`)
+  }
+  tokens.push({ type: 'eof', value: '', pos: i })
+  return tokens
+}
+
+/* ================================ 语法分析 ================================ */
+
+type Node =
+  | { t: 'lit'; v: unknown }
+  | { t: 'path'; segs: Array<string | Node> }
+  | { t: 'un'; op: string; a: Node }
+  | { t: 'bin'; op: string; a: Node; b: Node }
+  | { t: 'cond'; c: Node; a: Node; b: Node }
+
+/** 二元运算符优先级（数字越大结合越紧） */
+const BIN_PREC: Record<string, number> = {
+  '??': 1,
+  '||': 2,
+  '&&': 3,
+  '===': 4,
+  '!==': 4,
+  '==': 4,
+  '!=': 4,
+  '<': 5,
+  '<=': 5,
+  '>': 5,
+  '>=': 5,
+  '+': 6,
+  '-': 6,
+  '*': 7,
+  '/': 7,
+  '%': 7,
+}
+
+/** 禁止访问的属性名 —— 防原型链逃逸 */
+const FORBIDDEN_KEYS = new Set(['__proto__', 'constructor', 'prototype'])
+
+class Parser {
+  private pos = 0
+  constructor(private readonly tokens: Token[]) {}
+
+  private peek(): Token {
+    return this.tokens[this.pos]!
+  }
+
+  private next(): Token {
+    return this.tokens[this.pos++]!
+  }
+
+  private eat(value: string): boolean {
+    if (this.peek().type === 'op' && this.peek().value === value) {
+      this.pos++
+      return true
+    }
+    return false
+  }
+
+  private expect(value: string): void {
+    if (!this.eat(value)) {
+      throw new Error(`表达式缺少 "${value}"（位置 ${this.peek().pos}）`)
+    }
+  }
+
+  parse(): Node {
+    const node = this.parseTernary()
+    if (this.peek().type !== 'eof') {
+      throw new Error(`表达式多余内容 "${this.peek().value}"`)
+    }
+    return node
+  }
+
+  /** 三元（右结合，优先级最低） */
+  private parseTernary(): Node {
+    const cond = this.parseBinary(0)
+    if (this.eat('?')) {
+      const a = this.parseTernary()
+      this.expect(':')
+      const b = this.parseTernary()
+      return { t: 'cond', c: cond, a, b }
+    }
+    return cond
+  }
+
+  /** 优先级爬升 */
+  private parseBinary(minPrec: number): Node {
+    let left = this.parseUnary()
+    for (;;) {
+      const tok = this.peek()
+      if (tok.type !== 'op') break
+      const prec = BIN_PREC[tok.value]
+      if (prec === undefined || prec < minPrec) break
+      this.next()
+      const right = this.parseBinary(prec + 1) // 全部左结合
+      left = { t: 'bin', op: tok.value, a: left, b: right }
+    }
+    return left
+  }
+
+  private parseUnary(): Node {
+    const tok = this.peek()
+    if (tok.type === 'op' && (tok.value === '!' || tok.value === '-' || tok.value === '+')) {
+      this.next()
+      return { t: 'un', op: tok.value, a: this.parseUnary() }
+    }
+    return this.parsePrimary()
+  }
+
+  private parsePrimary(): Node {
+    const tok = this.next()
+
+    if (tok.type === 'num') return { t: 'lit', v: Number(tok.value) }
+    if (tok.type === 'str') return { t: 'lit', v: tok.value }
+
+    if (tok.type === 'op' && tok.value === '(') {
+      const node = this.parseTernary()
+      this.expect(')')
+      return node
+    }
+
+    if (tok.type === 'ident') {
+      if (tok.value === 'true') return { t: 'lit', v: true }
+      if (tok.value === 'false') return { t: 'lit', v: false }
+      if (tok.value === 'null') return { t: 'lit', v: null }
+      if (tok.value === 'undefined') return { t: 'lit', v: undefined }
+      return this.parsePath(tok.value)
+    }
+
+    throw new Error(`表达式意外符号 "${tok.value}"（位置 ${tok.pos}）`)
+  }
+
+  /** 路径：a.b[0].c，以及协议里的数组标记 a[] */
+  private parsePath(head: string): Node {
+    const segs: Array<string | Node> = [head]
+    for (;;) {
+      if (this.eat('.')) {
+        const tok = this.next()
+        if (tok.type !== 'ident' && tok.type !== 'num') {
+          throw new Error(`路径 "." 后应为字段名（位置 ${tok.pos}）`)
+        }
+        segs.push(tok.value)
+        continue
+      }
+      if (this.eat('[')) {
+        // `items[]` —— 协议里表示"该数组本身"，跳过不产生下标段
+        if (this.eat(']')) continue
+        const idx = this.parseTernary()
+        this.expect(']')
+        segs.push(idx)
+        continue
+      }
+      break
+    }
+    return { t: 'path', segs }
+  }
+}
+
+/* ================================= 求值 ================================= */
+
+function looseEqual(a: unknown, b: unknown): boolean {
+  // 避免 eslint eqeqeq；语义等价于 ==（仅做数字/字符串宽松比较）
+  if (a === b) return true
+  if (a === null || a === undefined || b === null || b === undefined) {
+    return (a === null || a === undefined) && (b === null || b === undefined)
+  }
+  if (typeof a === 'number' || typeof b === 'number') return Number(a) === Number(b)
+  return String(a) === String(b)
+}
+
+function toNum(v: unknown): number {
+  if (typeof v === 'number') return v
+  if (v === null || v === undefined || v === '') return 0
+  const n = Number(v)
+  return Number.isNaN(n) ? 0 : n
+}
+
+function isTruthy(v: unknown): boolean {
+  if (Array.isArray(v)) return v.length > 0
+  return Boolean(v)
+}
+
+function readProp(obj: unknown, key: string): unknown {
+  if (obj === null || obj === undefined) return undefined
+  if (FORBIDDEN_KEYS.has(key)) return undefined
+  if (typeof obj !== 'object' && typeof obj !== 'string') return undefined
+  // 数组的 length 允许；字符串的 length 允许
+  return (obj as Record<string, unknown>)[key]
+}
+
+function evalNode(node: Node, ctx: EvalContext, scope?: Record<string, unknown>): unknown {
+  switch (node.t) {
+    case 'lit':
+      return node.v
+
+    case 'path': {
+      const [head, ...rest] = node.segs as [string, ...Array<string | Node>]
+      let cur: unknown = resolveRoot(head, ctx, scope)
+      for (const seg of rest) {
+        if (cur === null || cur === undefined) return undefined
+        const key = typeof seg === 'string' ? seg : String(evalNode(seg, ctx, scope))
+        cur = readProp(cur, key)
+      }
+      return cur
+    }
+
+    case 'un': {
+      const v = evalNode(node.a, ctx)
+      if (node.op === '!') return !isTruthy(v)
+      if (node.op === '-') return -toNum(v)
+      return toNum(v)
+    }
+
+    case 'cond':
+      return isTruthy(evalNode(node.c, ctx)) ? evalNode(node.a, ctx) : evalNode(node.b, ctx)
+
+    case 'bin': {
+      // 短路运算符先处理
+      if (node.op === '&&') {
+        const a = evalNode(node.a, ctx, scope)
+        return isTruthy(a) ? evalNode(node.b, ctx, scope) : a
+      }
+      if (node.op === '||') {
+        const a = evalNode(node.a, ctx, scope)
+        return isTruthy(a) ? a : evalNode(node.b, ctx, scope)
+      }
+      if (node.op === '??') {
+        const a = evalNode(node.a, ctx, scope)
+        return a === null || a === undefined ? evalNode(node.b, ctx, scope) : a
+      }
+
+      const a = evalNode(node.a, ctx, scope)
+      const b = evalNode(node.b, ctx, scope)
+      switch (node.op) {
+        case '+':
+          // 任一侧为字符串则拼接，符合直觉（"单号-" + order.no）
+          if (typeof a === 'string' || typeof b === 'string') return String(a ?? '') + String(b ?? '')
+          return toNum(a) + toNum(b)
+        case '-':
+          return toNum(a) - toNum(b)
+        case '*':
+          return toNum(a) * toNum(b)
+        case '/': {
+          const d = toNum(b)
+          return d === 0 ? 0 : toNum(a) / d
+        }
+        case '%': {
+          const d = toNum(b)
+          return d === 0 ? 0 : toNum(a) % d
+        }
+        case '===':
+          return a === b
+        case '!==':
+          return a !== b
+        case '==':
+          return looseEqual(a, b)
+        case '!=':
+          return !looseEqual(a, b)
+        case '<':
+          return toNum(a) < toNum(b)
+        case '<=':
+          return toNum(a) <= toNum(b)
+        case '>':
+          return toNum(a) > toNum(b)
+        case '>=':
+          return toNum(a) >= toNum(b)
+        default:
+          throw new Error(`不支持的运算符 "${node.op}"`)
+      }
+    }
+  }
+}
+
+/**
+ * 路径根解析。约定（与字段树 path 对齐）：
+ * - `data`  → 数据根（§5.6 的 `data.vip === true`）
+ * - `row`   → 当前行；`rowIndex` → 行号；`page` / `pages` → 页码变量
+ * - 其他标识符 → 先在 row 里找（表格单元格里 `qty` 即 `row.qty`），再退到数据根
+ */
+function resolveRoot(head: string, ctx: EvalContext, scope?: Record<string, unknown>): unknown {
+  // 自定义作用域（如合计表达式里的 sum/avg/rows/allRows）优先于数据根解析
+  if (scope && head in scope) return readProp(scope, head)
+  switch (head) {
+    case 'data':
+      return ctx.data
+    case 'row':
+      return ctx.row
+    case 'rowIndex':
+      return ctx.rowIndex ?? 0
+    // 页码变量的多种别名，模板设计者不必记忆唯一写法
+    case 'page':
+    case 'pageNo':
+    case 'pageNumber':
+      return ctx.page ?? 1
+    case 'pages':
+    case 'pageCount':
+    case 'totalPages':
+      return ctx.pages ?? 1
+    default:
+      if (ctx.row && head in (ctx.row as object)) return readProp(ctx.row, head)
+      return readProp(ctx.data, head)
+  }
+}
+
+/* =============================== 编译缓存 =============================== */
+
+const astCache = new Map<string, Node | Error>()
+
+function compile(src: string): Node {
+  const hit = astCache.get(src)
+  if (hit instanceof Error) throw hit
+  if (hit) return hit
+  try {
+    const ast = new Parser(tokenize(src)).parse()
+    astCache.set(src, ast)
+    return ast
+  } catch (e) {
+    const err = e instanceof Error ? e : new Error(String(e))
+    astCache.set(src, err)
+    throw err
+  }
+}
+
+/**
+ * 求值单个表达式（不含 {{}}）。失败时抛错，由调用方转 warning。
+ * @param scope 可选额外作用域（如自定义合计里的 sum/avg/rows/allRows），标识符解析时优先于数据根。
+ */
+export function evaluate(src: string, ctx: EvalContext, scope?: Record<string, unknown>): unknown {
+  return evalNode(compile(src), ctx, scope)
+}
+
+/** 条件渲染判定（§5.6）。表达式为空视为可见；求值失败**保守可见**，避免静默丢内容。 */
+export function evaluateVisible(src: string | undefined, ctx: EvalContext): boolean {
+  if (!src || !src.trim()) return true
+  try {
+    return isTruthy(evaluate(src, ctx))
+  } catch {
+    return true
+  }
+}
+
+/* ================================ 过滤器 ================================ */
+
+export type Filter = (value: unknown, ...args: unknown[]) => string
+
+const CURRENCY_SYMBOL: Record<string, string> = {
+  CNY: '¥',
+  RMB: '¥',
+  USD: '$',
+  EUR: '€',
+  GBP: '£',
+  JPY: '¥',
+  HKD: 'HK$',
+}
+
+function groupThousands(fixed: string): string {
+  const [int = '0', dec] = fixed.split('.')
+  const sign = int.startsWith('-') ? '-' : ''
+  const digits = sign ? int.slice(1) : int
+  const grouped = digits.replace(/\B(?=(\d{3})+(?!\d))/g, ',')
+  return sign + grouped + (dec ? `.${dec}` : '')
+}
+
+function pad2(n: number): string {
+  return String(n).padStart(2, '0')
+}
+
+function formatDate(value: unknown, pattern = 'YYYY-MM-DD'): string {
+  if (value === null || value === undefined || value === '') return ''
+  const d = value instanceof Date ? value : new Date(String(value))
+  if (Number.isNaN(d.getTime())) return String(value)
+  const map: Record<string, string> = {
+    YYYY: String(d.getFullYear()),
+    MM: pad2(d.getMonth() + 1),
+    DD: pad2(d.getDate()),
+    HH: pad2(d.getHours()),
+    mm: pad2(d.getMinutes()),
+    ss: pad2(d.getSeconds()),
+  }
+  return pattern.replace(/YYYY|MM|DD|HH|mm|ss/g, (k) => map[k] ?? k)
+}
+
+export const FILTERS: Record<string, Filter> = {
+  /** {{ order.total | currency:'CNY' }} → ¥12,800.50 */
+  currency(value, code = 'CNY', digits = 2) {
+    const symbol = CURRENCY_SYMBOL[String(code).toUpperCase()] ?? ''
+    return symbol + groupThousands(toNum(value).toFixed(toNum(digits)))
+  },
+  /** {{ items[].qty | number:0 }} → 1,234 */
+  number(value, digits = 2) {
+    return groupThousands(toNum(value).toFixed(toNum(digits)))
+  },
+  /** 不加千分位的定点小数 */
+  fixed(value, digits = 2) {
+    return toNum(value).toFixed(toNum(digits))
+  },
+  /** {{ order.rate | percent:1 }} → 12.5% */
+  percent(value, digits = 2) {
+    return `${(toNum(value) * 100).toFixed(toNum(digits))}%`
+  },
+  /** {{ order.orderDate | date:'YYYY年MM月DD日' }} */
+  date(value, pattern = 'YYYY-MM-DD') {
+    return formatDate(value, String(pattern))
+  },
+  upper(value) {
+    return String(value ?? '').toUpperCase()
+  },
+  lower(value) {
+    return String(value ?? '').toLowerCase()
+  },
+  /** 空值兜底：{{ customer.memo | default:'无' }} */
+  default(value, fallback = '') {
+    const empty = value === null || value === undefined || value === ''
+    return empty ? String(fallback) : String(value)
+  },
+  /** 超长截断：{{ productName | truncate:10 }} */
+  truncate(value, len = 20, suffix = '…') {
+    const s = String(value ?? '')
+    const n = toNum(len)
+    return s.length > n ? s.slice(0, n) + String(suffix) : s
+  },
+  /** 补零：{{ seq | padStart:3 }} → 007 */
+  padStart(value, len = 2, fill = '0') {
+    return String(value ?? '').padStart(toNum(len), String(fill))
+  },
+}
+
+/* ============================== 单元格数据格式 ============================== */
+
+/** 小数位收敛到 [0, 6]，避免 digits 乱填导致 toFixed 抛错 */
+function clampDigits(d: unknown): number {
+  const n = typeof d === 'number' ? d : Number(d)
+  if (!Number.isFinite(n)) return 2
+  return Math.min(6, Math.max(0, Math.trunc(n)))
+}
+
+/**
+ * 按 CellFormat 把原始值格式化为显示字符串。
+ * 复用 date/number/currency 的同一套底层工具（formatDate / groupThousands / CURRENCY_SYMBOL），
+ * 与 `{{field | date:'...' }}` 过滤器输出完全一致 —— UI 选择即等价于手写对应过滤器。
+ * fmt 为 undefined / kind='none'/'text' 时回落默认 stringify（保持原行为）。
+ */
+export function formatCellValue(raw: unknown, fmt?: CellFormat | null): string {
+  if (!fmt || fmt.kind === 'none' || fmt.kind === 'text') return stringifyValue(raw)
+  const n = toNum(raw)
+  switch (fmt.kind) {
+    case 'date':
+      return formatDate(raw, fmt.pattern ?? 'YYYY-MM-DD')
+    case 'int': {
+      const s = n.toFixed(0)
+      return fmt.thousands === false ? s : groupThousands(s)
+    }
+    case 'decimal': {
+      const s = n.toFixed(clampDigits(fmt.digits ?? 2))
+      return fmt.thousands === false ? s : groupThousands(s)
+    }
+    case 'currency': {
+      const sym = CURRENCY_SYMBOL[String(fmt.code ?? 'CNY').toUpperCase()] ?? ''
+      const s = n.toFixed(clampDigits(fmt.digits ?? 2))
+      return sym + (fmt.thousands === false ? s : groupThousands(s))
+    }
+    case 'percent':
+      return `${(n * 100).toFixed(clampDigits(fmt.digits ?? 2))}%`
+    default:
+      return stringifyValue(raw)
+  }
+}
+
+/* ============================== 插值（{{}}） ============================== */
+
+/**
+ * 按单竖线切分过滤器管道，需跳过：
+ * - 字符串字面量内的 `|`
+ * - 逻辑或 `||`
+ */
+function splitPipes(src: string): string[] {
+  const parts: string[] = []
+  let buf = ''
+  let quote: string | null = null
+  for (let i = 0; i < src.length; i++) {
+    const ch = src[i]!
+    if (quote) {
+      buf += ch
+      if (ch === '\\' && i + 1 < src.length) {
+        buf += src[i + 1]
+        i++
+      } else if (ch === quote) {
+        quote = null
+      }
+      continue
+    }
+    if (ch === "'" || ch === '"') {
+      quote = ch
+      buf += ch
+      continue
+    }
+    if (ch === '|') {
+      if (src[i + 1] === '|') {
+        buf += '||'
+        i++
+        continue
+      }
+      parts.push(buf)
+      buf = ''
+      continue
+    }
+    buf += ch
+  }
+  parts.push(buf)
+  return parts
+}
+
+/** 解析 `filterName:arg1,arg2`，参数走同一套求值器（可用字面量与路径） */
+function applyFilter(spec: string, value: unknown, ctx: EvalContext): string {
+  const trimmed = spec.trim()
+  const colon = trimmed.indexOf(':')
+  const name = (colon === -1 ? trimmed : trimmed.slice(0, colon)).trim()
+  const filter = FILTERS[name]
+  if (!filter) throw new Error(`未知过滤器 "${name}"`)
+
+  let args: unknown[] = []
+  if (colon !== -1) {
+    const argSrc = trimmed.slice(colon + 1)
+    args = splitArgs(argSrc).map((a) => evaluate(a, ctx))
+  }
+  return filter(value, ...args)
+}
+
+/** 按逗号切分过滤器参数，跳过字符串与括号内的逗号 */
+function splitArgs(src: string): string[] {
+  const out: string[] = []
+  let buf = ''
+  let quote: string | null = null
+  let depth = 0
+  for (let i = 0; i < src.length; i++) {
+    const ch = src[i]!
+    if (quote) {
+      buf += ch
+      if (ch === '\\' && i + 1 < src.length) {
+        buf += src[i + 1]
+        i++
+      } else if (ch === quote) quote = null
+      continue
+    }
+    if (ch === "'" || ch === '"') {
+      quote = ch
+      buf += ch
+      continue
+    }
+    if (ch === '(' || ch === '[') depth++
+    if (ch === ')' || ch === ']') depth--
+    if (ch === ',' && depth === 0) {
+      out.push(buf)
+      buf = ''
+      continue
+    }
+    buf += ch
+  }
+  if (buf.trim()) out.push(buf)
+  return out
+}
+
+/** 值 → 显示字符串的默认规则（数字保留原样，null/undefined 显示空） */
+export function stringifyValue(v: unknown): string {
+  if (v === null || v === undefined) return ''
+  if (typeof v === 'number') return Number.isInteger(v) ? String(v) : String(v)
+  if (typeof v === 'boolean') return v ? '是' : '否'
+  if (v instanceof Date) return formatDate(v)
+  if (typeof v === 'object') return JSON.stringify(v)
+  return String(v)
+}
+
+export interface InterpolateResult {
+  text: string
+  /** 求值失败的片段（转 warning，不打断渲染） */
+  errors: string[]
+}
+
+/**
+ * 插值：把 `{{ expr | filter:arg }}` 替换为求值结果（§5.3）。
+ * 非 `{{}}` 部分原样保留；单个片段求值失败时输出空串并记录错误。
+ */
+export function interpolate(template: string, ctx: EvalContext): InterpolateResult {
+  const errors: string[] = []
+  if (!template.includes('{{')) return { text: template, errors }
+
+  const text = template.replace(/\{\{([\s\S]*?)\}\}/g, (_m, raw: string) => {
+    const body = raw.trim()
+    if (!body) return ''
+    try {
+      const [exprSrc, ...filterSpecs] = splitPipes(body)
+      let value: unknown = evaluate((exprSrc ?? '').trim(), ctx)
+      if (filterSpecs.length === 0) return stringifyValue(value)
+      let out = ''
+      for (let i = 0; i < filterSpecs.length; i++) {
+        out = applyFilter(filterSpecs[i]!, value, ctx)
+        value = out
+      }
+      return out
+    } catch (e) {
+      errors.push(`{{${body}}}：${e instanceof Error ? e.message : String(e)}`)
+      return ''
+    }
+  })
+
+  return { text, errors }
+}
+
+/**
+ * 绑定路径取值（§5.2 的 `binding` 字段）。
+ * 字段树给出的路径形如 `items[].qty`，其中 `[]` 由解析器忽略，
+ * 因此在行上下文中 `items[].qty` 与 `qty` 等价 —— 用户从字段树直接拖入即可用。
+ */
+export function resolveBinding(path: string, ctx: EvalContext): unknown {
+  if (!path) return undefined
+  // 行上下文里优先按"去前缀"解释：items[].qty → qty
+  if (ctx.row) {
+    const tail = path.includes('[].') ? path.slice(path.indexOf('[].') + 3) : path
+    try {
+      const v = evaluate(tail, { ...ctx })
+      if (v !== undefined) return v
+    } catch {
+      /* 落到全局解析 */
+    }
+  }
+  try {
+    return evaluate(path, ctx)
+  } catch {
+    return undefined
+  }
+}
+
+/** 测试/调试用：清空 AST 缓存 */
+export function __clearExpressionCache(): void {
+  astCache.clear()
+}
diff --git a/openprint/src/core/layout-engine/group-engine.spec.ts b/openprint/src/core/layout-engine/group-engine.spec.ts
new file mode 100644
index 0000000..f2a8607
--- /dev/null
+++ b/openprint/src/core/layout-engine/group-engine.spec.ts
@@ -0,0 +1,91 @@
+import { describe, expect, it } from 'vitest'
+
+import { computeAggregates, subtotalLabel } from './group-engine'
+import type { TableControl } from '@/types/control'
+
+const COLS_WITH_AMOUNT = [{ field: 'amount', title: '金额', width: 30 }]
+
+describe('computeAggregates —— 自定义合计（type=custom）', () => {
+  it('字段专属表达式：引用预计算的 sum', () => {
+    const control = {
+      columns: COLS_WITH_AMOUNT,
+      options: {
+        summaryRow: {
+          type: 'custom' as const,
+          fields: ['amount'],
+          expressions: { amount: 'sum.amount * 2' },
+        },
+      },
+    } as unknown as TableControl
+    const out = computeAggregates([{ amount: 10 }, { amount: 20 }], control)
+    expect(out.amount).toBe(60) // (10+20)*2
+  })
+
+  it('无专属表达式时回退到 summaryRow.expression', () => {
+    const control = {
+      columns: COLS_WITH_AMOUNT,
+      options: {
+        summaryRow: { type: 'custom' as const, fields: ['amount'], expression: 'sum.amount + 5' },
+      },
+    } as unknown as TableControl
+    const out = computeAggregates([{ amount: 10 }, { amount: 20 }], control)
+    expect(out.amount).toBe(35) // 30+5
+  })
+
+  it('avg 作用域可用', () => {
+    const control = {
+      columns: COLS_WITH_AMOUNT,
+      options: {
+        summaryRow: { type: 'custom' as const, fields: ['amount'], expressions: { amount: 'avg.amount' } },
+      },
+    } as unknown as TableControl
+    const out = computeAggregates([{ amount: 10 }, { amount: 20 }, { amount: 30 }], control)
+    expect(out.amount).toBe(20)
+  })
+
+  it('作用域含 rows / allRows（分组内行 / 整表行）', () => {
+    const control = {
+      columns: COLS_WITH_AMOUNT,
+      options: {
+        summaryRow: {
+          type: 'custom' as const,
+          fields: ['amount'],
+          expressions: { amount: 'rows.length * 10 + allRows.length' },
+        },
+      },
+    } as unknown as TableControl
+    // 当前分组 2 行，整表 3 行 → 2*10 + 3 = 23
+    const out = computeAggregates(
+      [{ amount: 1 }, { amount: 2 }],
+      control,
+      [{ amount: 1 }, { amount: 2 }, { amount: 3 }],
+    )
+    expect(out.amount).toBe(23)
+  })
+
+  it('无聚合列时把单表达式结果落入占位键 __total__', () => {
+    const control = {
+      columns: COLS_WITH_AMOUNT,
+      options: {
+        summaryRow: { type: 'custom' as const, fields: [], expression: 'sum.amount + 1' },
+      },
+    } as unknown as TableControl
+    const out = computeAggregates([{ amount: 9 }], control)
+    expect(out.__total__).toBe(10)
+  })
+})
+
+describe('subtotalLabel —— 模板替换', () => {
+  it('默认「${key} 小计」', () => {
+    const control = { columns: [], options: {} } as unknown as TableControl
+    expect(subtotalLabel(control, 'A组')).toBe('A组 小计')
+  })
+
+  it('自定义模板替换 ${key}', () => {
+    const control = {
+      columns: [],
+      options: { summaryRow: { subtotalLabel: '${key} 分组小计' } },
+    } as unknown as TableControl
+    expect(subtotalLabel(control, '甲')).toBe('甲 分组小计')
+  })
+})
diff --git a/openprint/src/core/layout-engine/group-engine.ts b/openprint/src/core/layout-engine/group-engine.ts
new file mode 100644
index 0000000..0fcc020
--- /dev/null
+++ b/openprint/src/core/layout-engine/group-engine.ts
@@ -0,0 +1,213 @@
+/**
+ * GroupEngine —— 分组与统计
+ * 真理源：《OpenPrint-设计方案.md》§5.5（分组统计）、§5.4（summaryRow）
+ *
+ * 产物是「行计划」(RowPlan[])：一个把 组头 / 数据行 / 小计 / 总计 编排好的线性序列。
+ * 之所以先出行计划再交给 TableEngine 测量，是为了让"分组语义"和"高度/分页"彻底解耦：
+ * 分页时只需按 RowPlan 顺序切，不必再理解分组结构。
+ */
+import type { TableControl } from '@/types/control'
+import { evaluate, resolveBinding, stringifyValue } from './expression'
+import type { EvalContext, RenderRowKind } from './types'
+
+export type RowPlanKind = Extract<RenderRowKind, 'data' | 'group' | 'subtotal' | 'summary'>
+
+export interface RowPlan {
+  kind: RowPlanKind
+  /** data 行的原始数据对象 */
+  row?: Record<string, unknown>
+  /** 在原始数组中的下标（斑马纹/序号用，跨分组连续） */
+  dataIndex?: number
+  /** group 行的分组标题 / subtotal|summary 行的标签 */
+  label?: string
+  /** 聚合结果：字段名 → 数值（供 subtotal / summary 行按列填值） */
+  aggregates?: Record<string, number>
+}
+
+/* -------------------------------- 聚合 -------------------------------- */
+
+function toNumber(v: unknown): number {
+  if (typeof v === 'number') return v
+  if (v === null || v === undefined || v === '') return 0
+  const n = Number(v)
+  return Number.isNaN(n) ? 0 : n
+}
+
+/** 从行对象里按字段名取值，兼容 `items[].amount` 这类带前缀的路径 */
+function readField(row: Record<string, unknown>, field: string): unknown {
+  if (field in row) return row[field]
+  const tail = field.includes('[].') ? field.slice(field.indexOf('[].') + 3) : field
+  if (tail in row) return row[tail]
+  // 支持 a.b 嵌套
+  return tail.split('.').reduce<unknown>((acc, k) => {
+    if (acc === null || acc === undefined || typeof acc !== 'object') return undefined
+    return (acc as Record<string, unknown>)[k]
+  }, row)
+}
+
+export function aggregate(
+  rows: Array<Record<string, unknown>>,
+  type: 'sum' | 'count',
+  field: string,
+): number {
+  if (type === 'count') return rows.length
+  return rows.reduce((sum, r) => sum + toNumber(readField(r, field)), 0)
+}
+
+/**
+ * 计算一批行在若干字段上的聚合值。
+ * 字段清单来自 `control.summary` 与 `options.summaryRow.fields` 的并集。
+ * @param allRows 整表（跨分组）行，供 type='custom' 的表达式引用 `allRows`。
+ */
+export function computeAggregates(
+  rows: Array<Record<string, unknown>>,
+  control: TableControl,
+  allRows?: Array<Record<string, unknown>>,
+): Record<string, number> {
+  const out: Record<string, number> = {}
+
+  for (const s of control.summary ?? []) {
+    out[s.field] = aggregate(rows, s.type, s.field)
+  }
+
+  const sr = control.options?.summaryRow
+  if (!sr || sr.type === 'custom') {
+    // custom 类型在下方单独处理（sr 为 undefined 时也不走 sum/count 分支）
+  } else {
+    for (const f of sr.fields ?? []) {
+      out[f] = aggregate(rows, sr.type, f)
+    }
+    return out
+  }
+
+  if (!sr) return out
+
+  // ── type='custom'：用自定义表达式求值，作用域含预计算的 sum/avg 与原始行 ──
+  const sum: Record<string, number> = {}
+  const avg: Record<string, number> = {}
+  for (const col of control.columns ?? []) {
+    const f = col.field
+    if (f) {
+      sum[f] = aggregate(rows, 'sum', f)
+      avg[f] = rows.length ? sum[f] / rows.length : 0
+    }
+  }
+  const scope = { sum, avg, rows, allRows: allRows ?? rows }
+  const fields = sr.fields ?? []
+  const evalCtx: EvalContext = { data: {} }
+  if (fields.length === 0) {
+    // 无聚合列：把单表达式结果放进占位列（渲染时标签列之前呈现）
+    try {
+      out['__total__'] = toNumber(evaluate(sr.expression ?? '0', evalCtx, scope))
+    } catch {
+      /* 表达式错误时静默留 0，由调用方 warning 兜底 */
+    }
+  }
+  for (const f of fields) {
+    const expr = sr.expressions?.[f] ?? sr.expression ?? '0'
+    try {
+      out[f] = toNumber(evaluate(expr, evalCtx, scope))
+    } catch {
+      out[f] = 0
+    }
+  }
+  return out
+}
+
+/** 是否配置了任何合计行 */
+export function hasSummaryRow(control: TableControl): boolean {
+  const sr = control.options?.summaryRow
+  if (sr) return true
+  return (control.summary?.length ?? 0) > 0
+}
+
+/** 合计行标签（默认「合计」） */
+export function summaryLabel(control: TableControl): string {
+  return control.options?.summaryRow?.label ?? control.summary?.[0]?.label ?? '合计'
+}
+
+/** 分组小计标签（默认「${key} 小计」，`${key}` 替换为分组值） */
+export function subtotalLabel(control: TableControl, key: string): string {
+  const tpl = control.options?.summaryRow?.subtotalLabel
+  return tpl ? tpl.replace(/\$\{key\}/g, key) : `${key} 小计`
+}
+
+/* ------------------------------- 空行判定 ------------------------------- */
+
+/** §5.4 skipEmptyRows：一行里所有被引用字段都为空则视为空行 */
+export function isEmptyRow(row: Record<string, unknown>, fields: string[]): boolean {
+  if (fields.length === 0) return false
+  return fields.every((f) => {
+    const v = readField(row, f)
+    return v === null || v === undefined || v === ''
+  })
+}
+
+/* ------------------------------ 行计划编排 ------------------------------ */
+
+export interface PlanOptions {
+  control: TableControl
+  rows: Array<Record<string, unknown>>
+  ctx: EvalContext
+}
+
+/**
+ * 生成行计划。
+ *
+ * 无 groupBy：`[data, data, ..., summary?]`
+ * 有 groupBy：`[group, data..., subtotal, group, data..., subtotal, ..., summary?]`
+ *
+ * 分组保持**首次出现顺序**（不重排），符合 ERP 单据"按录入顺序打印"的预期。
+ */
+export function planRows({ control, rows, ctx }: PlanOptions): RowPlan[] {
+  const plans: RowPlan[] = []
+  const groupBy = control.groupBy?.trim()
+
+  if (!groupBy) {
+    rows.forEach((row, i) => plans.push({ kind: 'data', row, dataIndex: i }))
+  } else {
+    const buckets = new Map<string, Array<{ row: Record<string, unknown>; index: number }>>()
+    rows.forEach((row, i) => {
+      const raw = resolveBinding(groupBy, { ...ctx, row, rowIndex: i })
+      const key = stringifyValue(raw)
+      const list = buckets.get(key)
+      if (list) list.push({ row, index: i })
+      else buckets.set(key, [{ row, index: i }])
+    })
+
+    for (const [key, items] of buckets) {
+      plans.push({ kind: 'group', label: key || '（未分组）' })
+      for (const { row, index } of items) {
+        plans.push({ kind: 'data', row, dataIndex: index })
+      }
+      if (hasSummaryRow(control)) {
+        plans.push({
+          kind: 'subtotal',
+          label: subtotalLabel(control, key || '（未分组）'),
+          aggregates: computeAggregates(
+            items.map((i) => i.row),
+            control,
+            rows,
+          ),
+        })
+      }
+    }
+  }
+
+  return plans
+}
+
+/** 全表总计行（渲染为表尾，参与 repeatFooter 逻辑） */
+export function buildSummaryPlan(
+  rows: Array<Record<string, unknown>>,
+  control: TableControl,
+): RowPlan | null {
+  if (!hasSummaryRow(control)) return null
+  return {
+    kind: 'summary',
+    label: summaryLabel(control),
+    aggregates: computeAggregates(rows, control, rows),
+  }
+}
+
+export { readField }
diff --git a/openprint/src/core/layout-engine/header-footer.ts b/openprint/src/core/layout-engine/header-footer.ts
new file mode 100644
index 0000000..1278a65
--- /dev/null
+++ b/openprint/src/core/layout-engine/header-footer.ts
@@ -0,0 +1,117 @@
+/**
+ * HeaderFooterEngine + 页面度量
+ * 真理源：《OpenPrint-设计方案.md》§5.1（sections）、§5.13（orientation 交换）、§5.14（ZoneControl）、§7.2（每页注入）
+ *
+ * 两件事：
+ * 1. computePageMetrics —— 把协议里的纸张定义换算成引擎唯一的尺寸真理源（全 mm）
+ * 2. buildSectionControls —— 把 header/footer 的子组件解析成每页可复用的已定位控件
+ *
+ * 页码变量在**每页单独求值**（`{{page}} / {{pages}}`），所以页眉页脚不能只解析一次就复用，
+ * 必须按页重算 —— 这是"第 X 页 / 共 Y 页"能正确输出的关键。
+ */
+import type { AnyControl } from '@/types/control'
+import type { PageSetup, Section } from '@/types/template'
+import { toMm } from '@/core/units'
+import { isControlPrintable, resolveControlContent } from './data-binder'
+import type { EvalContext, PageMetrics, PlacedControl, RenderWarning } from './types'
+
+/* ------------------------------- 页面度量 ------------------------------- */
+
+/**
+ * 计算一页的可用区域。
+ * 【约定】PageSetup.width/height 是**物理尺寸**（实际打印宽高，横向时宽>高），
+ * orientation 仅是派生标志（设计器面板切换方向时已交换宽高）。
+ * 这里**不再**按 orientation 交换 —— 与设计器 setPage、导出 export-pdf（w>h 判定）同口径。
+ */
+export function computePageMetrics(
+  page: PageSetup,
+  headerSection?: Section<AnyControl>,
+  footerSection?: Section<AnyControl>,
+): PageMetrics {
+  const unit = page.unit
+  const pageWidth = toMm(page.width, unit)
+  const pageHeight = toMm(page.height, unit)
+
+  const margin = {
+    top: toMm(page.margin?.top ?? 0, unit),
+    right: toMm(page.margin?.right ?? 0, unit),
+    bottom: toMm(page.margin?.bottom ?? 0, unit),
+    left: toMm(page.margin?.left ?? 0, unit),
+  }
+
+  const contentWidth = Math.max(0, pageWidth - margin.left - margin.right)
+  const contentHeight = Math.max(0, pageHeight - margin.top - margin.bottom)
+
+  const headerHeight = headerSection ? toMm(headerSection.height ?? 0, unit) : 0
+  const footerHeight = footerSection ? toMm(footerSection.height ?? 0, unit) : 0
+  const bodyHeight = Math.max(0, contentHeight - headerHeight - footerHeight)
+
+  return {
+    pageWidth,
+    pageHeight,
+    margin,
+    contentWidth,
+    contentHeight,
+    headerHeight,
+    footerHeight,
+    bodyHeight,
+  }
+}
+
+/* ------------------------------ 区块控件构建 ----------------------------- */
+
+/**
+ * 把一个 section 的子组件解析成已定位控件。
+ * 坐标已经是相对区块左上角（设计器序列化时保证），这里原样透传。
+ */
+export async function buildSectionControls(
+  components: AnyControl[] | undefined,
+  ctx: EvalContext,
+  unit: PageSetup['unit'],
+): Promise<{ controls: PlacedControl[]; warnings: RenderWarning[] }> {
+  const controls: PlacedControl[] = []
+  const warnings: RenderWarning[] = []
+  if (!components?.length) return { controls, warnings }
+
+  for (const control of components) {
+    // zone 不应出现在 section.components 里（设计器已拆平），保险起见跳过
+    if (control.type === 'zone') continue
+    if (!isControlPrintable(control, ctx)) continue
+
+    const { content, warnings: w } = await resolveControlContent(control, ctx)
+    warnings.push(...w)
+    controls.push({
+      kind: 'control',
+      id: control.id,
+      left: toMm(control.left, unit),
+      top: toMm(control.top, unit),
+      width: toMm(control.width, unit),
+      height: toMm(control.height, unit),
+      angle: control.angle,
+      content,
+      control,
+    })
+  }
+
+  return { controls, warnings }
+}
+
+/* ------------------------------- 出现规则 ------------------------------- */
+
+/**
+ * 区块是否在该页出现。
+ * §5.1：`repeat` 默认 true（每页重复）。repeat=false 时按业界惯例：
+ * - 页眉只出现在**首页**（封面式抬头）
+ * - 页脚只出现在**末页**（签章/合计式收尾）
+ */
+export function shouldRenderSection(
+  section: Section<AnyControl> | undefined,
+  type: 'header' | 'footer',
+  pageIndex: number,
+  totalPages: number,
+): boolean {
+  if (!section) return false
+  const repeat = section.repeat ?? true
+  if (repeat) return true
+  return type === 'header' ? pageIndex === 0 : pageIndex === totalPages - 1
+}
diff --git a/openprint/src/core/layout-engine/measure.ts b/openprint/src/core/layout-engine/measure.ts
new file mode 100644
index 0000000..aef6224
--- /dev/null
+++ b/openprint/src/core/layout-engine/measure.ts
@@ -0,0 +1,231 @@
+/**
+ * 文本测量 —— 分页精度的关键模块
+ * 真理源：《OpenPrint-设计方案.md》§11.3
+ *
+ * | 环境 | 方案 | 精度 |
+ * |---|---|---|
+ * | 浏览器 | 真实 DOM 排版（本文件 DomMeasurer） | 像素精确，与最终打印一致 |
+ * | 无 DOM | CJK 感知估算（EstimateMeasurer） | 近似，仅作兜底 |
+ *
+ * §11.3 特别警告：**不要用 jsdom 估算** —— jsdom 不实现 CSS 布局引擎，
+ * getBoundingClientRect 永远返回 0，任何基于它的测量都是假精度。
+ * 因此这里的兜底走字符宽度估算，而不是假装有 DOM。
+ */
+import { mmToPx, ptToPx, pxToMm } from '@/core/units'
+
+export interface TextMeasureOptions {
+  /** 字号（pt，协议单位） */
+  fontSize: number
+  fontFamily?: string
+  fontWeight?: 'normal' | 'bold'
+  /** 行高倍率（默认 1.35，贴近打印排版习惯） */
+  lineHeight?: number
+  /** 字间距（pt） */
+  letterSpacing?: number
+  /** 可用宽度（mm）；<=0 表示不换行 */
+  widthMm: number
+  /** 是否允许自动换行（默认 true） */
+  wrap?: boolean
+}
+
+export interface TextMeasureResult {
+  /** 文本占用高度（mm） */
+  heightMm: number
+  /** 实际折行数 */
+  lines: number
+}
+
+export interface TextMeasurer {
+  measure(text: string, options: TextMeasureOptions): TextMeasureResult
+  /** 释放底层资源（DOM 节点等） */
+  dispose(): void
+}
+
+export const DEFAULT_FONT_FAMILY =
+  '"Microsoft YaHei", "PingFang SC", "Hiragino Sans GB", "Source Han Sans SC", sans-serif'
+export const DEFAULT_LINE_HEIGHT = 1.35
+
+function cacheKey(text: string, o: TextMeasureOptions): string {
+  return [
+    text,
+    o.fontSize,
+    o.fontFamily ?? '',
+    o.fontWeight ?? 'normal',
+    o.lineHeight ?? DEFAULT_LINE_HEIGHT,
+    o.letterSpacing ?? 0,
+    Math.round(o.widthMm * 100),
+    o.wrap === false ? 0 : 1,
+  ].join('|')
+}
+
+/* ============================ 浏览器：真实 DOM ============================ */
+
+/**
+ * 用一个离屏隐藏容器做真实排版测量。
+ *
+ * 关键点：
+ * - 用 `visibility:hidden` + 绝对定位移出视口，**不能用 `display:none`**（不排版，高度恒 0）
+ * - `contain: layout size style` 让浏览器把它当独立布局单元，避免污染主文档回流
+ * - `white-space: pre-wrap` + `word-break: break-word` 与渲染器输出的 CSS 严格一致，
+ *   否则"测量用一套规则、渲染用另一套"会导致分页错位
+ */
+class DomMeasurer implements TextMeasurer {
+  private host: HTMLDivElement
+  private cache = new Map<string, TextMeasureResult>()
+
+  constructor() {
+    const host = document.createElement('div')
+    host.setAttribute('aria-hidden', 'true')
+    host.dataset.openprint = 'measure'
+    Object.assign(host.style, {
+      position: 'absolute',
+      left: '-99999px',
+      top: '0',
+      visibility: 'hidden',
+      pointerEvents: 'none',
+      contain: 'layout size style',
+      padding: '0',
+      margin: '0',
+      border: '0',
+    } satisfies Partial<CSSStyleDeclaration>)
+    document.body.appendChild(host)
+    this.host = host
+  }
+
+  measure(text: string, options: TextMeasureOptions): TextMeasureResult {
+    const key = cacheKey(text, options)
+    const hit = this.cache.get(key)
+    if (hit) return hit
+
+    const lineHeight = options.lineHeight ?? DEFAULT_LINE_HEIGHT
+    const fontPx = ptToPx(options.fontSize)
+    const el = this.host
+
+    el.style.fontSize = `${fontPx}px`
+    el.style.fontFamily = options.fontFamily || DEFAULT_FONT_FAMILY
+    el.style.fontWeight = options.fontWeight ?? 'normal'
+    el.style.lineHeight = String(lineHeight)
+    el.style.letterSpacing = options.letterSpacing ? `${ptToPx(options.letterSpacing)}px` : 'normal'
+
+    if (options.wrap === false || options.widthMm <= 0) {
+      el.style.width = 'auto'
+      el.style.whiteSpace = 'pre'
+    } else {
+      el.style.width = `${mmToPx(options.widthMm)}px`
+      el.style.whiteSpace = 'pre-wrap'
+      el.style.wordBreak = 'break-word'
+      el.style.overflowWrap = 'break-word'
+    }
+
+    // 空串也要占一行高度，否则空单元格会把行压扁
+    el.textContent = text === '' ? '\u00A0' : text
+
+    const heightPx = el.getBoundingClientRect().height
+    const singleLinePx = fontPx * lineHeight
+    const result: TextMeasureResult = {
+      heightMm: pxToMm(heightPx),
+      lines: Math.max(1, Math.round(heightPx / Math.max(1, singleLinePx))),
+    }
+
+    // 缓存上限，避免超长表格把内存吃满
+    if (this.cache.size > 5000) this.cache.clear()
+    this.cache.set(key, result)
+    return result
+  }
+
+  dispose(): void {
+    this.cache.clear()
+    this.host.remove()
+  }
+}
+
+/* ============================== 无 DOM 兜底 ============================== */
+
+/**
+ * 字符宽度估算：CJK / 全角按 1em，ASCII 按 0.5em（等宽近似）。
+ * 精度不如 DOM，但至少不会像 jsdom 那样返回 0。
+ */
+class EstimateMeasurer implements TextMeasurer {
+  private cache = new Map<string, TextMeasureResult>()
+
+  private static charWidthEm(ch: string): number {
+    const code = ch.codePointAt(0) ?? 0
+    // CJK 统一表意文字 / 全角标点 / 假名 / 韩文
+    if (
+      (code >= 0x1100 && code <= 0x115f) ||
+      (code >= 0x2e80 && code <= 0xa4cf) ||
+      (code >= 0xac00 && code <= 0xd7a3) ||
+      (code >= 0xf900 && code <= 0xfaff) ||
+      (code >= 0xfe30 && code <= 0xfe6f) ||
+      (code >= 0xff00 && code <= 0xff60) ||
+      (code >= 0xffe0 && code <= 0xffe6)
+    ) {
+      return 1
+    }
+    return 0.5
+  }
+
+  measure(text: string, options: TextMeasureOptions): TextMeasureResult {
+    const key = cacheKey(text, options)
+    const hit = this.cache.get(key)
+    if (hit) return hit
+
+    const lineHeight = options.lineHeight ?? DEFAULT_LINE_HEIGHT
+    const fontPx = ptToPx(options.fontSize)
+    const letterPx = options.letterSpacing ? ptToPx(options.letterSpacing) : 0
+    const availPx = options.wrap === false || options.widthMm <= 0 ? Infinity : mmToPx(options.widthMm)
+
+    let lines = 1
+    let cursor = 0
+    for (const ch of text) {
+      if (ch === '\n') {
+        lines++
+        cursor = 0
+        continue
+      }
+      const w = EstimateMeasurer.charWidthEm(ch) * fontPx + letterPx
+      if (cursor + w > availPx && cursor > 0) {
+        lines++
+        cursor = w
+      } else {
+        cursor += w
+      }
+    }
+
+    const result: TextMeasureResult = {
+      heightMm: pxToMm(lines * fontPx * lineHeight),
+      lines,
+    }
+    if (this.cache.size > 5000) this.cache.clear()
+    this.cache.set(key, result)
+    return result
+  }
+
+  dispose(): void {
+    this.cache.clear()
+  }
+}
+
+/* ================================ 工厂 ================================ */
+
+let shared: TextMeasurer | null = null
+
+/** 创建测量器：有 DOM 走真实排版，无 DOM 走估算 */
+export function createMeasurer(): TextMeasurer {
+  const hasDom = typeof document !== 'undefined' && typeof document.body !== 'undefined'
+  return hasDom ? new DomMeasurer() : new EstimateMeasurer()
+}
+
+/**
+ * 全局共享测量器（复用 DOM 节点 + 缓存，多次渲染成本近似 0）。
+ * 渲染流程用这个；单测想要干净环境时自行 createMeasurer()。
+ */
+export function getSharedMeasurer(): TextMeasurer {
+  if (!shared) shared = createMeasurer()
+  return shared
+}
+
+export function disposeSharedMeasurer(): void {
+  shared?.dispose()
+  shared = null
+}
diff --git a/openprint/src/core/layout-engine/pagination-engine.spec.ts b/openprint/src/core/layout-engine/pagination-engine.spec.ts
new file mode 100644
index 0000000..529b295
--- /dev/null
+++ b/openprint/src/core/layout-engine/pagination-engine.spec.ts
@@ -0,0 +1,57 @@
+import { describe, expect, it } from 'vitest'
+
+import { layout } from '@/core/layout-engine/pagination-engine'
+import { renderHtml } from '@/core/renderer-html'
+import { createDemoTemplate } from '@/repository/mock/data/demo-template'
+import { createCjkMeasurer } from '@/core/__tests__/cjk-measurer'
+
+function makeData(rows: number): Record<string, unknown> {
+  const items = Array.from({ length: rows }, (_, i) => {
+    const qty = (i % 5) + 1
+    const price = 10 + (i % 9)
+    return {
+      productCode: `P${String(i + 1).padStart(4, '0')}`,
+      productName: `商品${i + 1}`,
+      spec: '规格A',
+      unit: '件',
+      qty,
+      price,
+      amount: qty * price,
+    }
+  })
+  return {
+    order: { orderNo: 'SO-2026-0001', orderDate: '2026-08-08' },
+    customer: { name: '演示客户' },
+    items,
+  }
+}
+
+describe('layout 分页引擎（集成 demo 模板）', () => {
+  const template = createDemoTemplate()
+  const measurer = createCjkMeasurer()
+
+  for (const rows of [30, 80]) {
+    it(`明细 ${rows} 行 → 多页，页眉页脚每页重复，合计仅末页`, async () => {
+      const result = await layout(template, makeData(rows), { measurer })
+      const pages = result.pages.length
+      expect(pages).toBeGreaterThanOrEqual(2)
+
+      const html = renderHtml(result, { screen: false })
+      // 样式表不参与计数
+      const body = html.replace(/<style[\s\S]*?<\/style>/g, '')
+
+      // 页眉页脚每页重复
+      expect((body.match(/op-section op-header/g) || []).length).toBe(pages)
+      expect((body.match(/op-section op-footer/g) || []).length).toBe(pages)
+
+      // 表格按页切片：每页一个 <table>
+      expect((body.match(/op-node op-table/g) || []).length).toBe(pages)
+
+      // 合计行仅一次（末页）
+      expect((body.match(/is-summary/g) || []).length).toBe(1)
+
+      // 零告警（数据完整、绑定可达）
+      expect(result.warnings.length).toBe(0)
+    })
+  }
+})
diff --git a/openprint/src/core/layout-engine/pagination-engine.ts b/openprint/src/core/layout-engine/pagination-engine.ts
new file mode 100644
index 0000000..04632e0
--- /dev/null
+++ b/openprint/src/core/layout-engine/pagination-engine.ts
@@ -0,0 +1,572 @@
+/**
+ * PaginationEngine —— 分页算法主流程
+ * 真理源：《OpenPrint-设计方案.md》§7.2（分页算法流程）、§7.4（难点清单）、§8.1（二维排版，非流式）
+ *
+ * ## 分页模型：绝对定位 + 单表流动
+ *
+ * OpenPrint 是**二维排版工具，不是网页编辑器**（§8.1）：正文控件都是相对区块左上角的
+ * 绝对定位盒子，本身不参与文档流。真正会"长高"的只有绑定了数据源的表格。
+ * 因此分页的语义是：
+ *
+ * ```
+ *  ┌── 表格上方控件（单据头：单号/客户/日期）  → 仅第 1 页
+ *  ├── 明细表格                              → 按行切片流过 N 页
+ *  └── 表格下方控件（单据尾：合计/签章）        → 仅最后一页，随表格实际高度下移
+ * ```
+ *
+ * 这正是 ERP 单据的真实结构，也是金蝶/帆软等报表工具的一致做法。
+ * 每页重复的内容（公司抬头、页码）交给 header/footer 区块（§5.14），不在正文里解决。
+ *
+ * 无表格时退化为「按位置切页」：控件按 top 落在第几个 bodyHeight 区间就进第几页，
+ * 保证超长静态模板也不会被截断。
+ */
+import type { AnyControl, TableControl } from '@/types/control'
+import type { PageSetup, Section, TemplateData } from '@/types/template'
+import { toMm } from '@/core/units'
+import { isControlPrintable, resolveControlContent } from './data-binder'
+import {
+  buildSectionControls,
+  computePageMetrics,
+  shouldRenderSection,
+} from './header-footer'
+import { getSharedMeasurer, type TextMeasurer } from './measure'
+import {
+  buildTableModel,
+  minStartHeight,
+  sliceTable,
+  totalTableHeight,
+  type TableModel,
+} from './table-engine'
+import { isDataTable } from './table-cells'
+import {
+  MAX_PAGES,
+  type EvalContext,
+  type LayoutPage,
+  type LayoutResult,
+  type PageMetrics,
+  type PlacedControl,
+  type PlacedNode,
+  type PlacedTable,
+  type RenderWarning,
+} from './types'
+
+/** 几何比较容差（mm），消除序列化四舍五入带来的边界抖动 */
+const EPS = 0.5
+
+export interface LayoutOptions {
+  /** 自定义文本测量器（默认用共享的 DOM 测量器） */
+  measurer?: TextMeasurer
+  /** 最大页数保护 */
+  maxPages?: number
+}
+
+/* ------------------------------ 正文结构分析 ------------------------------ */
+
+interface BodyPlan {
+  /** 驱动分页的流式表格（绑定了数据源） */
+  flowTable: TableControl | null
+  /** 表格上方控件 → 第 1 页 */
+  above: AnyControl[]
+  /** 与表格垂直重叠的控件 → 第 1 页原位 */
+  overlap: AnyControl[]
+  /** 表格下方控件 → 末页，随表格高度下移 */
+  below: AnyControl[]
+}
+
+function analyzeBody(components: AnyControl[], unit: PageSetup['unit']): {
+  plan: BodyPlan
+  warnings: RenderWarning[]
+} {
+  const warnings: RenderWarning[] = []
+  const tables = components.filter(
+    (c): c is TableControl => c.type === 'table' && isDataTable(c),
+  )
+
+  if (tables.length > 1) {
+    warnings.push({
+      code: 'CONTENT_OVERFLOW',
+      message: `正文存在 ${tables.length} 个数据表格，仅第一个（${tables[0]!.id}）参与分页流动，其余按静态控件渲染`,
+      controlId: tables[1]!.id,
+    })
+  }
+
+  const flowTable = tables[0] ?? null
+  if (!flowTable) {
+    return { plan: { flowTable: null, above: components, overlap: [], below: [] }, warnings }
+  }
+
+  const tTop = toMm(flowTable.top, unit)
+  const tBottom = tTop + toMm(flowTable.height, unit)
+
+  const above: AnyControl[] = []
+  const overlap: AnyControl[] = []
+  const below: AnyControl[] = []
+
+  for (const c of components) {
+    if (c.id === flowTable.id) continue
+    const top = toMm(c.top, unit)
+    const bottom = top + toMm(c.height, unit)
+    if (bottom <= tTop + EPS) above.push(c)
+    else if (top >= tBottom - EPS) below.push(c)
+    else overlap.push(c)
+  }
+
+  return { plan: { flowTable, above, overlap, below }, warnings }
+}
+
+/* ------------------------------- 控件定位 ------------------------------- */
+
+async function placeControls(
+  components: AnyControl[],
+  ctx: EvalContext,
+  unit: PageSetup['unit'],
+  topShift = 0,
+): Promise<{ placed: PlacedControl[]; warnings: RenderWarning[] }> {
+  const placed: PlacedControl[] = []
+  const warnings: RenderWarning[] = []
+
+  for (const control of components) {
+    if (control.type === 'zone') continue
+    if (!isControlPrintable(control, ctx)) continue
+
+    // 静态表格（布局网格 / 非流动表格）在这里整体渲染
+    if (control.type === 'table') continue
+
+    const { content, warnings: w } = await resolveControlContent(control, ctx)
+    warnings.push(...w)
+    placed.push({
+      kind: 'control',
+      id: control.id,
+      left: toMm(control.left, unit),
+      top: toMm(control.top, unit) + topShift,
+      width: toMm(control.width, unit),
+      height: toMm(control.height, unit),
+      angle: control.angle,
+      content,
+      control,
+    })
+  }
+
+  return { placed, warnings }
+}
+
+/** 静态表格（无数据源或非首个数据表格）整表渲染，不参与分页 */
+function placeStaticTables(
+  components: AnyControl[],
+  flowTableId: string | null,
+  ctx: EvalContext,
+  unit: PageSetup['unit'],
+  measurer: TextMeasurer,
+  topShift = 0,
+): { placed: PlacedTable[]; warnings: RenderWarning[] } {
+  const placed: PlacedTable[] = []
+  const warnings: RenderWarning[] = []
+
+  for (const control of components) {
+    if (control.type !== 'table' || control.id === flowTableId) continue
+    if (!isControlPrintable(control, ctx)) continue
+
+    const widthMm = toMm(control.width, unit)
+    const heightMm = toMm(control.height, unit)
+    const model = buildTableModel({ control, ctx, measurer, widthMm, heightMm })
+    warnings.push(...model.warnings)
+    placed.push({
+      kind: 'table',
+      id: control.id,
+      left: toMm(control.left, unit),
+      top: toMm(control.top, unit) + topShift,
+      width: widthMm,
+      height: Math.max(heightMm, totalTableHeight(model)),
+      control,
+      columns: model.columns,
+      columnWidths: model.columnWidths,
+      headerRows: model.headerRows,
+      rows: model.rows,
+      footerRows: model.footerRows,
+      isLastSlice: true,
+    })
+  }
+
+  return { placed, warnings }
+}
+
+/* -------------------------------- 分页骨架 ------------------------------- */
+
+/** 表格切片在各页上的落位结果（尚未解析上下方控件） */
+interface TableSkeleton {
+  /** 每页一个切片；空数组表示表格无内容 */
+  slices: Array<{ table: PlacedTable; pageIndex: number }>
+  /** 表格实际占用的页数 */
+  pageCount: number
+  /** 末页上表格的实际底边（mm，相对正文区顶） */
+  lastBottom: number
+  warnings: RenderWarning[]
+}
+
+function paginateFlowTable(
+  model: TableModel,
+  tableLeft: number,
+  tableWidth: number,
+  tableTop: number,
+  metrics: PageMetrics,
+  reserveBelow: number,
+  maxPages: number,
+): TableSkeleton {
+  const warnings: RenderWarning[] = []
+  const slices: TableSkeleton['slices'] = []
+  const keepTogether = model.control.options?.keepTogether ?? false
+
+  // keepTogether：首页放不下"表头 + 1 行 + 表尾"就整体下移到第 2 页（§7.4）
+  let firstPageIndex = 0
+  let firstTop = tableTop
+  if (keepTogether && metrics.bodyHeight - tableTop < minStartHeight(model)) {
+    firstPageIndex = 1
+    firstTop = 0
+  }
+
+  let start = 0
+  let pageIndex = firstPageIndex
+  let lastBottom = firstTop
+  let guard = 0
+
+  for (;;) {
+    if (++guard > maxPages) {
+      warnings.push({
+        code: 'PAGE_LIMIT_REACHED',
+        message: `分页超过 ${maxPages} 页保护上限，已截断`,
+        controlId: model.control.id,
+      })
+      break
+    }
+
+    const topOnPage = pageIndex === firstPageIndex ? firstTop : 0
+    const availFull = Math.max(0, metrics.bodyHeight - topOnPage)
+
+    // 先试"为下方控件预留空间"的窄预算；能一次放完，说明这就是末页
+    let slice = null as ReturnType<typeof sliceTable> | null
+    if (reserveBelow > 0 && availFull - reserveBelow > 0) {
+      const trial = sliceTable(model, { avail: availFull - reserveBelow, start })
+      if (trial.isLast) slice = trial
+    }
+    if (!slice) {
+      slice = sliceTable(model, { avail: availFull, start })
+      // 用满预算才放完 → 下方控件挤不下，让它们独占下一页
+      if (slice.isLast && reserveBelow > 0 && availFull - slice.height < reserveBelow) {
+        slice = { ...slice, isLast: false }
+      }
+    }
+
+    warnings.push(...slice.warnings)
+
+    // 跳过完全为空的尾片（上一页已放完全部数据行）：否则会渲染出一个空表 + 多余合计行
+    const isEmptySlice =
+      slice.rows.length === 0 && slice.headerRows.length === 0 && slice.footerRows.length === 0
+    if (!isEmptySlice) {
+      slices.push({
+        table: {
+          kind: 'table',
+          id: model.control.id,
+          left: tableLeft,
+          top: topOnPage,
+          width: tableWidth,
+          height: slice.height,
+          control: model.control,
+          columns: model.columns,
+          columnWidths: model.columnWidths,
+          headerRows: slice.headerRows,
+          rows: slice.rows,
+          footerRows: slice.footerRows,
+          isLastSlice: slice.isLast,
+        },
+        pageIndex,
+      })
+    }
+
+    lastBottom = topOnPage + slice.height
+
+    if (slice.isLast) break
+    if (slice.nextStart === start && slice.rows.length === 0) {
+      // 没有任何前进 → 防死循环
+      warnings.push({
+        code: 'CONTENT_OVERFLOW',
+        message: '表格可用高度不足以容纳任何一行，已终止分页',
+        controlId: model.control.id,
+      })
+      break
+    }
+
+    start = slice.nextStart
+    pageIndex++
+  }
+
+  return {
+    slices,
+    pageCount: pageIndex + 1,
+    lastBottom,
+    warnings,
+  }
+}
+
+/* ================================ 主入口 ================================ */
+
+export async function layout(
+  template: TemplateData<AnyControl>,
+  data: Record<string, unknown>,
+  options: LayoutOptions = {},
+): Promise<LayoutResult> {
+  const measurer = options.measurer ?? getSharedMeasurer()
+  const maxPages = options.maxPages ?? MAX_PAGES
+  const warnings: RenderWarning[] = []
+
+  const doc = template.document
+  const unit = doc.page.unit
+  const sections = doc.sections ?? []
+  const headerSection = sections.find((s) => s.type === 'header') as Section<AnyControl> | undefined
+  const footerSection = sections.find((s) => s.type === 'footer') as Section<AnyControl> | undefined
+  const bodySection = sections.find((s) => s.type === 'body') as Section<AnyControl> | undefined
+
+  const metrics = computePageMetrics(doc.page, headerSection, footerSection)
+  const baseCtx: EvalContext = { data }
+
+  const bodyComponents = bodySection?.components ?? []
+  const { plan, warnings: planWarnings } = analyzeBody(bodyComponents, unit)
+  warnings.push(...planWarnings)
+
+  /* ── 情况 A：无流式表格 → 按位置切页 ── */
+  if (!plan.flowTable) {
+    const staticPages = await layoutStaticOnly(
+      plan.above,
+      baseCtx,
+      unit,
+      metrics,
+      measurer,
+      maxPages,
+      warnings,
+    )
+    const pages = await buildPages(
+      staticPages.length,
+      new Map(staticPages.map((p, i) => [i, p])),
+      headerSection,
+      footerSection,
+      baseCtx,
+      unit,
+      warnings,
+    )
+    return { pages, metrics, page: doc.page, warnings: dedupeWarnings(warnings) }
+  }
+
+  /* ── 情况 B：有流式表格 ── */
+  const table = plan.flowTable
+  const tableTop = toMm(table.top, unit)
+  const tableLeft = toMm(table.left, unit)
+  const tableWidth = toMm(table.width, unit)
+  const tableBottom = tableTop + toMm(table.height, unit)
+
+  const model = buildTableModel({
+    control: table,
+    ctx: baseCtx,
+    measurer,
+    widthMm: tableWidth,
+    heightMm: toMm(table.height, unit),
+  })
+  warnings.push(...model.warnings)
+
+  // 下方控件相对表格底边的偏移量与所需高度
+  const belowOffsets = plan.below.map((c) => ({
+    control: c,
+    delta: toMm(c.top, unit) - tableBottom,
+  }))
+  const reserveBelow = belowOffsets.reduce(
+    (max, b) => Math.max(max, b.delta + toMm(b.control.height, unit)),
+    0,
+  )
+
+  const skeleton = paginateFlowTable(
+    model,
+    tableLeft,
+    tableWidth,
+    tableTop,
+    metrics,
+    reserveBelow,
+    maxPages,
+  )
+  warnings.push(...skeleton.warnings)
+
+  const tableLastPage = skeleton.slices.at(-1)?.pageIndex ?? 0
+  // 下方控件放得下就跟在末片后面，否则独占新的一页（top 从 0 起）
+  const belowFitsOnTablePage = skeleton.lastBottom + reserveBelow <= metrics.bodyHeight + EPS
+  const belowPageIndex = belowFitsOnTablePage ? tableLastPage : tableLastPage + 1
+  const belowBaseTop = belowFitsOnTablePage ? skeleton.lastBottom : 0
+
+  const totalPages = Math.max(1, Math.max(tableLastPage, belowPageIndex) + 1)
+  const lastPageNo = totalPages
+
+  /* ── 组装每页正文 ── */
+  const bodyByPage = new Map<number, PlacedNode[]>()
+  const pushNode = (pageIndex: number, node: PlacedNode): void => {
+    const list = bodyByPage.get(pageIndex)
+    if (list) list.push(node)
+    else bodyByPage.set(pageIndex, [node])
+  }
+
+  for (const { table: slice, pageIndex } of skeleton.slices) pushNode(pageIndex, slice)
+
+  // 第 1 页：表格上方 + 重叠控件 + 静态表格
+  const firstCtx: EvalContext = { ...baseCtx, page: 1, pages: totalPages }
+  const firstControls = await placeControls([...plan.above, ...plan.overlap], firstCtx, unit)
+  warnings.push(...firstControls.warnings)
+  for (const c of firstControls.placed) pushNode(0, c)
+
+  const staticTables = placeStaticTables(
+    [...plan.above, ...plan.overlap],
+    table.id,
+    firstCtx,
+    unit,
+    measurer,
+  )
+  warnings.push(...staticTables.warnings)
+  for (const t of staticTables.placed) pushNode(0, t)
+
+  // 末页：表格下方控件，按表格实际底边下移
+  if (plan.below.length > 0) {
+    const belowCtx: EvalContext = { ...baseCtx, page: lastPageNo, pages: totalPages }
+    for (const { control, delta } of belowOffsets) {
+      if (control.type === 'zone') continue
+      if (!isControlPrintable(control, belowCtx)) continue
+      if (control.type === 'table') continue
+      const { content, warnings: w } = await resolveControlContent(control, belowCtx)
+      warnings.push(...w)
+      pushNode(belowPageIndex, {
+        kind: 'control',
+        id: control.id,
+        left: toMm(control.left, unit),
+        top: belowBaseTop + delta,
+        width: toMm(control.width, unit),
+        height: toMm(control.height, unit),
+        angle: control.angle,
+        content,
+        control,
+      })
+    }
+
+    const belowStatic = placeStaticTables(
+      plan.below,
+      table.id,
+      { ...baseCtx, page: lastPageNo, pages: totalPages },
+      unit,
+      measurer,
+      belowBaseTop - tableBottom,
+    )
+    warnings.push(...belowStatic.warnings)
+    for (const t of belowStatic.placed) pushNode(belowPageIndex, t)
+  }
+
+  /* ── 注入页眉页脚 ── */
+  const pages = await buildPages(
+    totalPages,
+    bodyByPage,
+    headerSection,
+    footerSection,
+    baseCtx,
+    unit,
+    warnings,
+  )
+
+  return { pages, metrics, page: doc.page, warnings: dedupeWarnings(warnings) }
+}
+
+/* ---------------------------- 无表格：按位置切页 ---------------------------- */
+
+/**
+ * 无流式表格时的退化策略：控件按 top 落在第几个 bodyHeight 区间就进第几页。
+ * 返回「每页的正文节点数组」，页眉页脚由调用方统一注入。
+ */
+async function layoutStaticOnly(
+  components: AnyControl[],
+  baseCtx: EvalContext,
+  unit: PageSetup['unit'],
+  metrics: PageMetrics,
+  measurer: TextMeasurer,
+  maxPages: number,
+  warnings: RenderWarning[],
+): Promise<PlacedNode[][]> {
+  const bodyH = Math.max(1, metrics.bodyHeight)
+
+  // 控件按 top 落在第几个 bodyHeight 区间就进第几页
+  let maxPageIndex = 0
+  const buckets = new Map<number, AnyControl[]>()
+  for (const c of components) {
+    const idx = Math.max(0, Math.min(maxPages - 1, Math.floor(toMm(c.top, unit) / bodyH)))
+    maxPageIndex = Math.max(maxPageIndex, idx)
+    const list = buckets.get(idx)
+    if (list) list.push(c)
+    else buckets.set(idx, [c])
+  }
+
+  const totalPages = maxPageIndex + 1
+  const bodyByPage = new Map<number, PlacedNode[]>()
+
+  for (const [idx, list] of buckets) {
+    const ctx: EvalContext = { ...baseCtx, page: idx + 1, pages: totalPages }
+    const shift = -idx * bodyH
+    const { placed, warnings: w } = await placeControls(list, ctx, unit, shift)
+    warnings.push(...w)
+    const tables = placeStaticTables(list, null, ctx, unit, measurer, shift)
+    warnings.push(...tables.warnings)
+    bodyByPage.set(idx, [...placed, ...tables.placed])
+  }
+
+  return Array.from({ length: totalPages }, (_, i) => bodyByPage.get(i) ?? [])
+}
+
+/* ------------------------------ 页眉页脚注入 ------------------------------ */
+
+async function buildPages(
+  totalPages: number,
+  bodyByPage: Map<number, PlacedNode[]>,
+  headerSection: Section<AnyControl> | undefined,
+  footerSection: Section<AnyControl> | undefined,
+  baseCtx: EvalContext,
+  unit: PageSetup['unit'],
+  warnings: RenderWarning[],
+): Promise<LayoutPage[]> {
+  const pages: LayoutPage[] = []
+
+  for (let i = 0; i < totalPages; i++) {
+    // 页码变量按页求值 —— "第 X 页 / 共 Y 页" 正确的前提
+    const pageCtx: EvalContext = { ...baseCtx, page: i + 1, pages: totalPages }
+
+    let header: PlacedControl[] = []
+    if (shouldRenderSection(headerSection, 'header', i, totalPages)) {
+      const r = await buildSectionControls(headerSection?.components, pageCtx, unit)
+      warnings.push(...r.warnings)
+      header = r.controls
+    }
+
+    let footer: PlacedControl[] = []
+    if (shouldRenderSection(footerSection, 'footer', i, totalPages)) {
+      const r = await buildSectionControls(footerSection?.components, pageCtx, unit)
+      warnings.push(...r.warnings)
+      footer = r.controls
+    }
+
+    pages.push({ index: i, pageNo: i + 1, header, body: bodyByPage.get(i) ?? [], footer })
+  }
+
+  return pages
+}
+
+/* -------------------------------- 工具 -------------------------------- */
+
+/** 同一条告警可能在多页重复产生（页眉每页解析一次），这里按 code+message+controlId 去重 */
+function dedupeWarnings(list: RenderWarning[]): RenderWarning[] {
+  const seen = new Set<string>()
+  const out: RenderWarning[] = []
+  for (const w of list) {
+    const key = `${w.code}|${w.controlId ?? ''}|${w.message}`
+    if (seen.has(key)) continue
+    seen.add(key)
+    out.push(w)
+  }
+  return out
+}
diff --git a/openprint/src/core/layout-engine/table-cells.spec.ts b/openprint/src/core/layout-engine/table-cells.spec.ts
new file mode 100644
index 0000000..f282526
--- /dev/null
+++ b/openprint/src/core/layout-engine/table-cells.spec.ts
@@ -0,0 +1,422 @@
+/**
+ * 设计期单元格网格模型单测（table-cells.ts）
+ *
+ * 覆盖：有/无 cells 的回落、buildDesignGrid 行语义、ensureCells 物化、
+ * patchCellText（表头/静态/数据样例行语义）、patchCellStyle（合并/清除）、
+ * setCellSpan（横向合并 + 吞格清空）、resolveCellStyle 优先级、normalizeCellRows、designRowInfo。
+ */
+import { describe, expect, it } from 'vitest'
+import type { TableCell, TableControl } from '@/types/control'
+import {
+  addTableColumn,
+  buildDesignGrid,
+  computeSpanLayout,
+  designRowInfo,
+  ensureCells,
+  moveTableColumn,
+  normalizeCellRows,
+  patchCell,
+  patchCellStyle,
+  patchCellText,
+  removeTableColumn,
+  removeTableRow,
+  resolveCellStyle,
+  setCellRowSpan,
+  setCellSpan,
+  setGridRows,
+} from './table-cells'
+
+function baseTable(over: Partial<TableControl> = {}): TableControl {
+  return {
+    id: 't1',
+    type: 'table',
+    left: 0,
+    top: 0,
+    width: 180,
+    height: 60,
+    columns: [
+      { title: '序号', expression: '{{rowIndex + 1}}', width: 15, align: 'center', headerAlign: 'center' },
+      { title: '名称', field: 'name', width: 60 },
+      { title: '数量', field: 'qty', width: 25, align: 'right', headerAlign: 'center' },
+    ],
+    options: { borders: 'all', verticalAlign: 'middle' },
+    ...over,
+  }
+}
+
+describe('buildDesignGrid', () => {
+  it('数据表无 cells：由列配置瞬时推导 表头+数据样例行+静态尾行', () => {
+    const g = buildDesignGrid(baseTable({ dataSource: 'items', staticRows: 1 }))
+    expect(g.isData).toBe(true)
+    expect(g.headerRows).toBe(1)
+    expect(g.rowCount).toBe(1 + 1 + 1) // header + data template + 1 static
+    expect(g.colCount).toBe(3)
+    // 表头第 1 行：文本=列标题、加粗、对齐跟随 headerAlign
+    expect(g.cells[0]![0]!.text).toBe('序号')
+    expect(g.cells[0]![0]!.style?.bold).toBe(true)
+    expect(g.cells[0]![0]!.style?.align).toBe('center')
+    // 数据样例行第 2 行：带 field（来自列配置的 field）
+    expect(g.cells[1]![1]!.field).toBe('name')
+    expect(g.cells[1]![2]!.field).toBe('qty')
+    // 静态尾行：空
+    expect(g.cells[2]![0]).toEqual({})
+  })
+
+  it('布局网格（无 dataSource）无 cells：行数取 designRows（含表头）', () => {
+    const g = buildDesignGrid(baseTable({ designRows: 4 }))
+    expect(g.isData).toBe(false)
+    expect(g.headerRows).toBe(1) // 列有标题 → 自动补 1 行表头
+    expect(g.rowCount).toBe(5) // 1 表头 + 4 正文
+    expect(g.colCount).toBe(3)
+    expect(g.cells.every((r) => r.length === 3)).toBe(true)
+  })
+
+  it('已有 cells：按语义行数归一化（列数补齐到当前列数）', () => {
+    const cells = [
+      [{ text: 'A' }, { text: 'B' }, { text: 'C' }, { text: '多余列应被丢弃' }],
+      [{ text: 'x' }, { text: 'y' }, { text: 'z' }],
+    ]
+    const g = buildDesignGrid(baseTable({ dataSource: 'items', cells, staticRows: 0 }))
+    expect(g.rowCount).toBe(2) // header(1) + data(1) + 0
+    expect(g.colCount).toBe(3)
+    expect(g.cells[0]![3]).toBeUndefined()
+    expect(g.cells[0]![0]!.text).toBe('A')
+  })
+
+  it('列数为 0 时兜底为 1 列，不崩溃', () => {
+    const g = buildDesignGrid(baseTable({ columns: [] }))
+    expect(g.colCount).toBe(1)
+    expect(g.rowCount).toBeGreaterThan(0)
+  })
+})
+
+describe('ensureCells', () => {
+  it('无 cells 时物化出完整网格并带上语义行数', () => {
+    const next = ensureCells(baseTable({ dataSource: 'items', staticRows: 1 }))
+    expect(next.cells).toBeDefined()
+    expect(next.cells!.length).toBe(3)
+    expect(next.headerRows).toBe(1)
+    expect(next.staticRows).toBe(1)
+    expect(next.designRows).toBe(0)
+  })
+
+  it('已存在且尺寸匹配则返回结构（不重建，保持既有内容）', () => {
+    const cells = [
+      [{ text: 'H1' }, { text: 'H2' }, { text: 'H3' }],
+      [{ field: 'a' }, { field: 'b' }, { field: 'c' }],
+    ]
+    const orig = baseTable({ dataSource: 'items', cells, staticRows: 0 })
+    const next = ensureCells(orig)
+    expect(next.cells).toBe(cells)
+    expect(next.headerRows).toBe(1)
+  })
+})
+
+describe('patchCellText 行语义', () => {
+  it('表头/静态行：写 text 字面量', () => {
+    const t = baseTable({ dataSource: 'items', staticRows: 1 })
+    const next = patchCellText(t, 0, 0, '序号X') // 表头行
+    expect(next.cells![0]![0]!.text).toBe('序号X')
+  })
+
+  it('静态尾行：写 text 字面量', () => {
+    const t = baseTable({ dataSource: 'items', staticRows: 1 })
+    const next = patchCellText(t, 2, 0, '合计') // 静态行
+    expect(next.cells![2]![0]!.text).toBe('合计')
+  })
+
+  it('数据样例行：与当前占位符一致 → 原样返回（不固化占位符）', () => {
+    const t = baseTable({ dataSource: 'items' })
+    const next = patchCellText(t, 1, 1, '{{item.name}}')
+    expect(next).toBe(t)
+  })
+
+  it('数据样例行：纯字段引用回写为 field', () => {
+    const t = baseTable({ dataSource: 'items' })
+    const next = patchCellText(t, 1, 1, '{{item.amount}}')
+    expect(next.cells![1]![1]!.field).toBe('amount')
+    expect(next.cells![1]![1]!.expression).toBeUndefined()
+  })
+
+  it('数据样例行：含表达式 → 写 expression 并清 field', () => {
+    const t = baseTable({ dataSource: 'items' })
+    const next = patchCellText(t, 1, 2, '{{row.price * row.qty}}')
+    expect(next.cells![1]![2]!.expression).toBe('{{row.price * row.qty}}')
+    expect(next.cells![1]![2]!.field).toBeUndefined()
+  })
+
+  it('数据样例行：清空 → 同时清 expression 与 field', () => {
+    const t = baseTable({ dataSource: 'items' })
+    const next = patchCellText(t, 1, 1, '')
+    expect(next.cells![1]![1]!.expression).toBeUndefined()
+    expect(next.cells![1]![1]!.field).toBeUndefined()
+  })
+})
+
+describe('patchCellStyle / resolveCellStyle', () => {
+  it('resolveCellStyle 优先级：单元格 > 列 > 表格默认', () => {
+    const t = baseTable({
+      options: { defaultCellStyle: { align: 'left', color: '#000' } },
+      columns: [{ title: 'A', width: 10, style: { align: 'center', color: '#f00' } }],
+    })
+    const resolved = resolveCellStyle(t, t.columns[0], { style: { align: 'right', bold: true } })
+    expect(resolved.align).toBe('right') // 单元格覆盖
+    expect(resolved.color).toBe('#f00') // 列兜底
+    expect(resolved.bold).toBe(true)
+  })
+
+  it('patchCellStyle 合并并覆盖传入键；undefined 表示清除', () => {
+    let t = baseTable({ dataSource: 'items' })
+    t = patchCellStyle(t, 0, 0, { bold: true, color: '#ff0000' })
+    expect(t.cells![0]![0]!.style?.bold).toBe(true)
+    expect(t.cells![0]![0]!.style?.color).toBe('#ff0000')
+    t = patchCellStyle(t, 0, 0, { color: undefined })
+    expect(t.cells![0]![0]!.style?.bold).toBe(true)
+    expect(t.cells![0]![0]!.style?.color).toBeUndefined()
+  })
+})
+
+describe('setCellSpan 横向合并', () => {
+  it('本格 colSpan=n，被吞格清空（保留矩阵规整）', () => {
+    const t = baseTable({ dataSource: 'items' })
+    const next = setCellSpan(t, 1, 0, 2) // 数据样例行第0列合并2列
+    expect(next.cells![1]![0]!.colSpan).toBe(2)
+    expect(next.cells![1]![1]!.text).toBeUndefined()
+    expect(next.cells![1]![1]!.field).toBeUndefined()
+    expect(next.cells![1]![1]!.colSpan).toBeUndefined()
+  })
+
+  it('合并数越界自动夹紧到剩余列数', () => {
+    const t = baseTable({ dataSource: 'items' })
+    const next = setCellSpan(t, 1, 1, 99) // 剩 2 列（c=1,2）
+    expect(next.cells![1]![1]!.colSpan).toBe(2)
+  })
+})
+
+describe('designRowInfo', () => {
+  it('数据表行语义正确', () => {
+    const g = buildDesignGrid(baseTable({ dataSource: 'items', staticRows: 1 }))
+    expect(designRowInfo(g, 0).kind).toBe('header')
+    expect(designRowInfo(g, 1).kind).toBe('data')
+    expect(designRowInfo(g, 1).isDataTemplate).toBe(true)
+    expect(designRowInfo(g, 2).kind).toBe('static')
+  })
+
+  it('布局网格：第 0 行为表头，其余为 static', () => {
+    const g = buildDesignGrid(baseTable({ designRows: 3 }))
+    expect(designRowInfo(g, 0).kind).toBe('header')
+    expect(designRowInfo(g, 1).kind).toBe('static')
+    expect(designRowInfo(g, 2).kind).toBe('static')
+  })
+})
+
+describe('normalizeCellRows', () => {
+  it('行/列不足补空、超出截断', () => {
+    const out = normalizeCellRows([[{ text: 'a' }], [{ text: 'b' }, { text: 'c' }]], 3, 2)
+    expect(out.length).toBe(3)
+    expect(out[0]!.length).toBe(2)
+    expect(out[0]![0]!.text).toBe('a')
+    expect(out[0]![1]).toEqual({})
+    expect(out[1]![1]!.text).toBe('c')
+  })
+})
+
+describe('patchCell 不可变更新', () => {
+  it('返回新控件且只改目标格', () => {
+    const t = baseTable({ dataSource: 'items' })
+    const next = patchCell(t, 0, 0, { text: '改' })
+    expect(next).not.toBe(t)
+    expect(next.cells![0]![0]!.text).toBe('改')
+    expect(t.cells).toBeUndefined()
+  })
+})
+
+describe('网格结构变更（#100）', () => {
+  it('setGridRows 布局网格增正文行：保留已有内容并按目标维度补空', () => {
+    const t = ensureCells(baseTable({ designRows: 2 }))
+    t.cells![0]![0] = { text: 'H' }
+    t.cells![1]![1] = { text: 'B' }
+    const next = setGridRows(t, { designRows: 4 })
+    expect(next.headerRows).toBe(1)
+    expect(next.designRows).toBe(4)
+    expect(next.cells!.length).toBe(5) // 1 表头 + 4 正文
+    expect(next.cells![0]![0]!.text).toBe('H') // 表头保留
+    expect(next.cells![1]![1]!.text).toBe('B') // 正文保留
+    expect(next.cells![4]![0]).toEqual({}) // 新补空行
+  })
+
+  it('setGridRows 数据表增静态尾行', () => {
+    const t = ensureCells(baseTable({ dataSource: 'items', staticRows: 0 }))
+    const next = setGridRows(t, { staticRows: 2 })
+    expect(next.staticRows).toBe(2)
+    expect(next.cells!.length).toBe(4) // 1 表头 + 1 数据样例 + 2 尾
+    expect(Boolean(next.dataSource?.trim())).toBe(true)
+  })
+
+  it('setGridRows 改表头行数：新增表头行用列标题兜底', () => {
+    const t = baseTable({ designRows: 2 })
+    const next = setGridRows(t, { headerRows: 2 })
+    expect(next.headerRows).toBe(2)
+    expect(next.cells!.length).toBe(4) // 2 表头 + 2 正文
+    expect(next.cells![1]![0]!.text).toBe('序号') // 新表头行取列标题
+  })
+
+  it('setGridRows 减行数：截断尾部（保留前面内容）', () => {
+    const t = ensureCells(baseTable({ designRows: 5 }))
+    t.cells![0]![0] = { text: 'H' }
+    const next = setGridRows(t, { designRows: 2 })
+    expect(next.cells!.length).toBe(3) // 1 表头 + 2 正文
+    expect(next.cells![0]![0]!.text).toBe('H')
+  })
+
+  it('addTableColumn：列与每行单元格同步增加，新列表头默认填标题', () => {
+    const t = ensureCells(baseTable({ designRows: 2 }))
+    const next = addTableColumn(t, { title: '新列', width: 20 })
+    expect(next.columns.length).toBe(4)
+    expect(next.cells!.every((r) => r.length === 4)).toBe(true)
+    expect(next.cells![0]![3]!.text).toBe('新列') // 表头新列取标题
+  })
+
+  it('removeTableColumn：删除指定列（含对应单元格），至少留 1 列', () => {
+    const t = ensureCells(baseTable({ designRows: 2 }))
+    t.cells![0]![1] = { text: 'B-col1' }
+    const next = removeTableColumn(t, 1)
+    expect(next.columns.length).toBe(2)
+    expect(next.cells!.every((r) => r.length === 2)).toBe(true)
+    expect(next.columns[0]!.title).toBe('序号')
+    expect(next.columns[1]!.title).toBe('数量') // 原第 2 列（数量）左移
+    expect(next.cells![0]![1]!.text).toBe('数量') // 单元格同步左移
+  })
+
+  it('removeTableColumn：最后一列不可删', () => {
+    const t = baseTable({ columns: [{ title: 'only', width: 10 }] })
+    const next = removeTableColumn(t, 0)
+    expect(next.columns.length).toBe(1)
+  })
+
+  it('removeTableRow：删除指定行（含对应单元格），至少留 1 行', () => {
+    const t = ensureCells(baseTable({ designRows: 3 }))
+    t.cells![2]![0] = { text: '第三行' }
+    const next = removeTableRow(t, 2)
+    const grid = buildDesignGrid(next)
+    expect(grid.rowCount).toBe(3) // 4 行 - 1
+    expect(grid.designRows).toBe(2)
+    expect(grid.cells.some((r) => r[0]?.text === '第三行')).toBe(false)
+    expect(grid.cells[1]![0]?.text).toBeUndefined() // 第 2 行未受影响
+  })
+
+  it('removeTableRow：删表头行时 headerRows 减一', () => {
+    const t = ensureCells(baseTable({ designRows: 2 }))
+    const next = removeTableRow(t, 0)
+    expect(buildDesignGrid(next).headerRows).toBe(0)
+    expect(buildDesignGrid(next).rowCount).toBe(2)
+  })
+
+  it('removeTableRow：数据表的数据样例行（唯一 body 行）不可删', () => {
+    const t = ensureCells(baseTable({ dataSource: 'items', staticRows: 1 }))
+    const next = removeTableRow(t, 1) // 第 1 行是数据样例行（headerRows=1）
+    expect(next).toBe(t) // 不变
+  })
+
+  it('removeTableRow：单行表格不可删', () => {
+    const t = ensureCells(baseTable({ height: 8, headerRows: 0, designRows: 0, columns: [{ title: '', width: 10 }] }))
+    expect(buildDesignGrid(t).rowCount).toBe(1)
+    const next = removeTableRow(t, 0)
+    expect(next).toBe(t)
+  })
+
+  it('moveTableColumn：左右搬动列与单元格', () => {
+    const t = ensureCells(baseTable({ designRows: 2 }))
+    const next = moveTableColumn(t, 0, 2)
+    expect(next.columns[2]!.title).toBe('序号')
+    expect(next.cells![0]![2]!.text).toBe('序号') // 单元格同列位置搬动
+    expect(next.cells![0]![0]!.text).toBe('名称')
+  })
+})
+
+describe('computeSpanLayout 合并布局', () => {
+  // 构造 cells 矩阵的便捷函数：rows 是「每行每列的对象字面量」二维数组
+  const mk = (rows: Array<Array<Partial<{ colSpan: number; rowSpan: number }>>>): TableCell[][] =>
+    rows.map((r) => r.map((c) => ({ ...c })))
+
+  it('无合并：全部 skip=false、跨度=1', () => {
+    const cells = mk([
+      [{}, {}],
+      [{}, {}],
+    ])
+    const layout = computeSpanLayout(cells, 2, 2)
+    expect(layout.every((r) => r.every((s) => !s.skip && s.colSpan === 1 && s.rowSpan === 1))).toBe(true)
+  })
+
+  it('横向合并：锚点 colSpan=2，右侧被吞', () => {
+    const cells = mk([
+      [{ colSpan: 2 }, {}],
+      [{}, {}],
+    ])
+    const layout = computeSpanLayout(cells, 2, 2)
+    expect(layout[0]![0]!.colSpan).toBe(2)
+    expect(layout[0]![0]!.skip).toBe(false)
+    expect(layout[0]![1]!.skip).toBe(true) // 被横向吞掉
+    expect(layout[1]![1]!.skip).toBe(false) // 下一行不受同行跨列影响
+  })
+
+  it('纵向合并：锚点 rowSpan=2，下方同列被吞', () => {
+    const cells = mk([
+      [{ rowSpan: 2 }, {}],
+      [{}, {}],
+    ])
+    const layout = computeSpanLayout(cells, 2, 2)
+    expect(layout[0]![0]!.rowSpan).toBe(2)
+    expect(layout[1]![0]!.skip).toBe(true) // 被纵向吞掉
+    expect(layout[0]![1]!.skip).toBe(false)
+    expect(layout[1]![1]!.skip).toBe(false)
+  })
+
+  it('跨列 + 跨行组合：2×2 块，其余三格均被吞', () => {
+    const cells = mk([
+      [{ colSpan: 2, rowSpan: 2 }, {}],
+      [{}, {}],
+    ])
+    const layout = computeSpanLayout(cells, 2, 2)
+    expect(layout[0]![0]!.colSpan).toBe(2)
+    expect(layout[0]![0]!.rowSpan).toBe(2)
+    expect(layout[0]![1]!.skip).toBe(true)
+    expect(layout[1]![0]!.skip).toBe(true)
+    expect(layout[1]![1]!.skip).toBe(true)
+  })
+
+  it('越界收敛：rowSpan 超出网格底边被截断', () => {
+    const cells = mk([
+      [{ rowSpan: 9 }, {}],
+      [{}, {}],
+    ])
+    const layout = computeSpanLayout(cells, 2, 2)
+    expect(layout[0]![0]!.rowSpan).toBe(2) // 只剩 2 行，截断为 2
+    expect(layout[1]![0]!.skip).toBe(true)
+  })
+})
+
+describe('setCellRowSpan 纵向合并', () => {
+  it('rowSpan=2：本格写 rowSpan，下方同列清空', () => {
+    const t = ensureCells(baseTable({ designRows: 3 }))
+    const next = setCellRowSpan(t, 0, 0, 2)
+    expect(next.cells![0]![0]!.rowSpan).toBe(2)
+    expect(next.cells![1]![0]!.text).toBeUndefined()
+    expect(next.cells![1]![0]!.field).toBeUndefined()
+    expect(next.cells![2]![0]!.rowSpan).toBeUndefined() // 只吞 2 行
+  })
+
+  it('rowSpan=1：清除合并', () => {
+    const t = ensureCells(baseTable({ designRows: 3 }))
+    const merged = setCellRowSpan(t, 0, 0, 2)
+    const cleared = setCellRowSpan(merged, 0, 0, 1)
+    expect(cleared.cells![0]![0]!.rowSpan).toBeUndefined()
+  })
+
+  it('越界 rowSpan 收敛到网格底边', () => {
+    const t = ensureCells(baseTable({ designRows: 2 })) // 共 1 表头 + 2 正文 = 3 行
+    const next = setCellRowSpan(t, 0, 0, 99)
+    expect(next.cells![0]![0]!.rowSpan).toBe(3) // 从第 0 行到底边共 3 行
+    expect(next.cells![2]![0]!.rowSpan).toBeUndefined()
+  })
+})
diff --git a/openprint/src/core/layout-engine/table-cells.ts b/openprint/src/core/layout-engine/table-cells.ts
new file mode 100644
index 0000000..f9567c7
--- /dev/null
+++ b/openprint/src/core/layout-engine/table-cells.ts
@@ -0,0 +1,728 @@
+/**
+ * table-cells —— 表格设计期单元格网格模型（纯函数，可测）
+ *
+ * 把"列驱动 + 数据源"的传统表格，叠加一层**设计期可编辑的单元格网格**，
+ * 使得双击任意单元格即可填写文字 / 绑定字段 / 调字体 / 填色，
+ * 同时**完全兼容**未设置 cells 的旧模板（回落到列驱动渲染）。
+ *
+ * 行语义（designRowInfo）：
+ * - 数据表（有 dataSource）：前 headerRows 行为表头；第 headerRows 行为"数据样例行"（模板，
+ *   编辑它 = 编辑该列所有数据行）；其后 staticRows 行为静态尾行（合计 / 备注）。
+ *   可视行与 cells 行 1:1 对应（cells 长度 = headerRows + 1 + staticRows）。
+ * - 布局网格（无 dataSource）：前 headerRows 行为表头（由列标题推导），其后 designRows 行为
+ *   静态内容（cells 长度 = headerRows + designRows）。
+ *
+ * ⚠️ `designRows` 语义 = **正文行数（不含表头）**；可视行总数一律取 `grid.rowCount`。
+ */
+import type { TableCell, TableCellStyle, TableColumn, TableControl } from '@/types/control'
+import { isAggToken, parseAggToken, stripItems } from './aggregate'
+
+export const DEFAULT_HEADER_ROWS = 1
+
+export type DesignRowKind = 'header' | 'data' | 'static'
+
+/**
+ * 单个单元格的合并布局结果（由 computeSpanLayout 统一计算）。
+ * - skip=true：该格被左/上某个合并格吞掉，渲染时跳过（矩阵仍留位保持规整）。
+ * - colSpan / rowSpan：本格实际生效的合并跨度（已收敛到网格边界）。
+ */
+export interface CellSpan {
+  skip: boolean
+  colSpan: number
+  rowSpan: number
+}
+
+export interface DesignRowInfo {
+  kind: DesignRowKind
+  /** 在 control.cells 中的行下标（数据表与可视行 1:1） */
+  cellRow: number
+  /** 是否为数据表的数据样例行（编辑影响整列） */
+  isDataTemplate: boolean
+}
+
+export interface DesignGrid {
+  isData: boolean
+  headerRows: number
+  staticRows: number
+  /** 布局网格的正文行数（不含表头）；数据表恒为 0 */
+  designRows: number
+  /** 可视行总数（含表头 / 数据样例行 / 静态尾行） */
+  rowCount: number
+  colCount: number
+  cells: TableCell[][]
+}
+
+/** 该表格是否数据表（绑定了数据源数组，或自带内嵌 data 行） */
+export function isDataTable(control: TableControl): boolean {
+  return (
+    Boolean(control.dataSource?.trim()) ||
+    (Array.isArray(control.data) && control.data.length > 0)
+  )
+}
+
+/**
+ * 表头行数。
+ * 未显式设置时：**有任一列标题 → 1 行，否则 0 行**（数据表 / 布局网格同一规则），
+ * 与运行期旧版 `columns.some(c => c.title)` 判定一致，保证老模板打印结果不变。
+ */
+export function headerRowsOf(control: TableControl): number {
+  if (typeof control.headerRows === 'number') return Math.max(0, control.headerRows)
+  return (control.columns ?? []).some((c) => c.title) ? DEFAULT_HEADER_ROWS : 0
+}
+
+export function staticRowsOf(control: TableControl): number {
+  return isDataTable(control) ? Math.max(0, control.staticRows ?? 0) : 0
+}
+
+function emptyRow(colCount: number): TableCell[] {
+  return Array.from({ length: colCount }, () => ({}))
+}
+
+/** 从列配置推导单元格（用于无 cells 时的瞬时渲染 / 首次初始化） */
+function cellFromColumn(col: TableColumn, role: 'header' | 'data'): TableCell {
+  if (role === 'header') {
+    return {
+      text: col.title,
+      style: {
+        backgroundColor: col.headerBackgroundColor,
+        // 与运行期 table-engine 表头默认一致：headerAlign → align → center
+        align: col.headerAlign ?? col.align ?? 'center',
+        bold: true,
+      },
+    }
+  }
+  return {
+    field: col.field,
+    expression: col.expression,
+    style: {
+      backgroundColor: col.cellBackgroundColor,
+      align: col.align,
+      ...(col.style ?? {}),
+    },
+  }
+}
+
+/**
+ * 布局网格的正文行数（不含表头）。
+ * 真理源优先级：已物化的 cells 行数 > 显式 designRows > 按控件高度推算。
+ * （以 cells 为先，才不会在改了表头行数后把用户已填的行挤掉。）
+ */
+function layoutBodyRows(control: TableControl, headerRows: number): number {
+  if (control.cells && control.cells.length > 0) {
+    return Math.max(1, control.cells.length - headerRows)
+  }
+  if (typeof control.designRows === 'number' && control.designRows > 0) return control.designRows
+  const rowH = Math.max(4, control.options?.rowHeight ?? 8)
+  const bodyH = Math.max(0, control.height - headerRows * rowH)
+  return Math.max(1, Math.floor(bodyH / rowH) || 1)
+}
+
+/** 该单元格是否"从未被写过内容"（用于表头兜底判定；显式清空写入的 `text: ''` 不算空） */
+function isBlankCell(cell: TableCell | undefined): boolean {
+  return !cell || (cell.text === undefined && !cell.field && !cell.expression)
+}
+
+/**
+ * 计算设计期网格（不修改入参）。
+ * - 若 control.cells 存在：归一化其行数 / 列数后使用；整行空白的表头行用列标题兜底
+ *   （用户改了列标题却看不到，比"尊重空表头"更反直觉）。
+ * - 否则：由列配置瞬时推导。
+ *   - 数据表 = headerRows 行表头 + 1 行数据样例 + staticRows 行静态尾行
+ *   - 布局网格 = headerRows 行表头 + designRows 行静态正文
+ */
+export function buildDesignGrid(control: TableControl): DesignGrid {
+  const cols = control.columns ?? []
+  const colCount = Math.max(1, cols.length)
+  const data = isDataTable(control)
+  const headerRows = headerRowsOf(control)
+  const staticRows = staticRowsOf(control)
+  const bodyRows = data ? 1 : layoutBodyRows(control, headerRows)
+  const rowCount = headerRows + bodyRows + staticRows
+
+  // 由列配置推导的"标准网格"，同时充当已有 cells 的兜底来源
+  const derived = normalizeCellRows(
+    [
+      ...Array.from({ length: headerRows }, () => cols.map((c) => cellFromColumn(c, 'header'))),
+      ...(data
+        ? [cols.map((c) => cellFromColumn(c, 'data'))]
+        : Array.from({ length: bodyRows }, () => emptyRow(colCount))),
+      ...Array.from({ length: staticRows }, () => emptyRow(colCount)),
+    ],
+    rowCount,
+    colCount,
+  )
+
+  let cells = derived
+  if (control.cells && control.cells.length > 0) {
+    cells = normalizeCellRows(control.cells, rowCount, colCount)
+    for (let r = 0; r < headerRows; r++) {
+      if (cells[r]!.every(isBlankCell)) cells[r] = derived[r]!
+    }
+  }
+
+  return {
+    isData: data,
+    headerRows,
+    staticRows,
+    designRows: data ? 0 : bodyRows,
+    rowCount,
+    colCount,
+    cells,
+  }
+}
+
+/**
+ * 设计期各可视行的行高（mm）—— **设计画布与运行期布局网格共用**，是"所见即所得"的根：
+ * 表头按 8mm/行 分配（最多占 32% 高度），剩余高度由正文行均分，合计恰好 = 控件高度。
+ *
+ * @param heightMm 控件高度（mm）。协议单位非 mm 时由调用方换算后传入。
+ */
+export function designRowHeights(control: TableControl, heightMm?: number): number[] {
+  const grid = buildDesignGrid(control)
+  const totalH = Math.max(1, heightMm ?? control.height)
+  const headerRows = grid.headerRows
+  const bodyCount = Math.max(1, grid.rowCount - headerRows)
+  const headerShare = Math.min(totalH * 0.32, headerRows * 8)
+  const headerRowH = headerRows > 0 ? headerShare / headerRows : 0
+  const bodyH = Math.max(4, (totalH - headerShare) / bodyCount)
+  const out: number[] = []
+  for (let r = 0; r < grid.rowCount; r++) out.push(r < headerRows ? headerRowH : bodyH)
+  return out
+}
+
+/** 把任意 cells 矩阵归一化为 rowCount × colCount（不足补空、超出截断） */
+export function normalizeCellRows(
+  cells: TableCell[][],
+  rowCount: number,
+  colCount: number,
+): TableCell[][] {
+  const out: TableCell[][] = []
+  for (let r = 0; r < rowCount; r++) {
+    const src = cells[r] ?? []
+    const row: TableCell[] = []
+    for (let c = 0; c < colCount; c++) {
+      row.push(src[c] ? { ...src[c] } : {})
+    }
+    out.push(row)
+  }
+  return out
+}
+
+/** 给定可视行号，返回其语义（表头 / 数据样例行 / 静态尾行） */
+export function designRowInfo(grid: DesignGrid, r: number): DesignRowInfo {
+  if (!grid.isData) {
+    return { kind: r < grid.headerRows ? 'header' : 'static', cellRow: r, isDataTemplate: false }
+  }
+  if (r < grid.headerRows) return { kind: 'header', cellRow: r, isDataTemplate: false }
+  if (r === grid.headerRows) return { kind: 'data', cellRow: r, isDataTemplate: true }
+  return { kind: 'static', cellRow: r, isDataTemplate: false }
+}
+
+/**
+ * 设计期行角色名（双击编辑时显示在首列左侧，帮助用户识别当前所在行）。
+ * 聚合尾行按单元格 token 判定：大写金额 / 总计 / 本页合计。
+ */
+export function rowRoleLabel(grid: DesignGrid, r: number): string {
+  const info = designRowInfo(grid, r)
+  if (info.kind === 'header') return grid.headerRows > 1 ? `标题行 ${r + 1}` : '标题行'
+  if (info.isDataTemplate) return '数据行'
+  const row = grid.cells[r] ?? []
+  const tokens = row.map((c) => parseAggToken(c.text))
+  if (tokens.some((t) => t === 'pageCap' || t === 'totalCap')) return '大写金额行'
+  if (tokens.some((t) => t === 'totalSum' || t === 'totalAvg' || t === 'totalCount')) return '总计行'
+  if (tokens.some((t) => t === 'pageSum' || t === 'pageAvg' || t === 'pageCount')) return '本页合计行'
+  // 其余非表头、非聚合 token 的行（数据样例行 / 备注 / 签字栏等）统一叫"数据行"
+  return '数据行'
+}
+
+/**
+ * 物化 cells 到控件（首次双击编辑或列数变化时调用）。
+ * 返回带完整 cells 的新控件；若已存在且长度匹配则原样返回。
+ */
+export function ensureCells(control: TableControl): TableControl {
+  const grid = buildDesignGrid(control)
+  const headerRows = grid.headerRows
+  const staticRows = grid.staticRows
+  const designRows = grid.designRows
+  const existing = control.cells
+  const matches =
+    existing &&
+    existing.length === grid.rowCount &&
+    existing.every((row) => row.length === grid.colCount)
+  if (matches) {
+    return { ...control, headerRows, staticRows, designRows }
+  }
+  return {
+    ...control,
+    headerRows,
+    staticRows,
+    designRows,
+    cells: grid.cells,
+  }
+}
+
+/** 浅合并单元格样式：later 覆盖 former 的已定义字段 */
+export function mergeCellStyle(...parts: Array<TableCellStyle | undefined>): TableCellStyle {
+  const out: TableCellStyle = {}
+  for (const p of parts) {
+    if (!p) continue
+    for (const [k, v] of Object.entries(p)) {
+      if (v !== undefined && v !== null) (out as Record<string, unknown>)[k] = v
+    }
+  }
+  return out
+}
+
+/** 取某单元格最终样式（表格默认 → 列样式 → 单元格样式） */
+export function resolveCellStyle(
+  control: TableControl,
+  column: TableColumn | undefined,
+  cell: TableCell | undefined,
+): TableCellStyle {
+  return mergeCellStyle(control.options?.defaultCellStyle, column?.style, cell?.style)
+}
+
+/**
+ * 按行语义取单元格最终样式。
+ * 表头行**不吃 `column.style`** —— 列样式是给数据单元格用的，套到表头上会让
+ * "把某列数据调成红色"顺带把标题也染红，与直觉相悖。设计期与运行期共用本函数。
+ */
+export function resolveCellStyleFor(
+  control: TableControl,
+  column: TableColumn | undefined,
+  cell: TableCell | undefined,
+  kind: DesignRowKind,
+): TableCellStyle {
+  return resolveCellStyle(control, kind === 'header' ? undefined : column, cell)
+}
+
+/** 不可变更新某单元格（合并 patch），返回新控件 */
+export function patchCell(
+  control: TableControl,
+  r: number,
+  c: number,
+  patch: Partial<TableCell>,
+): TableControl {
+  const grid = buildDesignGrid(control)
+  const next = grid.cells.map((row, ri) =>
+    ri === r ? row.map((cell, ci) => (ci === c ? { ...cell, ...patch } : cell)) : row,
+  )
+  return {
+    ...control,
+    cells: next,
+    headerRows: grid.headerRows,
+    staticRows: grid.staticRows,
+    designRows: grid.designRows,
+  }
+}
+
+/* ----------------------------- 网格结构变更 ----------------------------- */
+
+/**
+ * 设定表格的语义行数并物化 cells（保留已有内容，按需补空 / 截断）。
+ * 同时回写 headerRows / designRows / staticRows 元数据，使与设计期网格 1:1 对齐。
+ *
+ * 参数按控件类型生效：
+ * - 布局网格（无 dataSource）：designRows = 正文行数；staticRows 恒为 0。
+ * - 数据表：固定 1 行数据样例行（模板），staticRows = 静态尾行（备注 / 签字栏）。
+ * 未传的维度沿用当前值，便于只改某一维。
+ *
+ * ⚠️ 不能走 ensureCells：它按"cells 长度优先推导 designRows"，会无视显式 designRows。
+ * 这里以"目标维度"为准直接归一 cells。
+ */
+export function setGridRows(
+  control: TableControl,
+  rows: { headerRows?: number; designRows?: number; staticRows?: number },
+): TableControl {
+  const headerRows = Math.max(0, rows.headerRows ?? headerRowsOf(control))
+  const isData = isDataTable(control)
+  const staticRows = isData ? Math.max(0, rows.staticRows ?? staticRowsOf(control)) : 0
+  const designRows = isData ? 0 : Math.max(0, rows.designRows ?? layoutBodyRows(control, headerRows))
+  const colCount = Math.max(1, control.columns?.length ?? 0)
+  const rowCount = headerRows + (isData ? 1 : designRows) + staticRows
+
+  // 已有 cells → 按目标维度直接归一（保留内容）；无 cells → 先按新语义推导再取
+  const base =
+    control.cells && control.cells.length > 0
+      ? control.cells
+      : buildDesignGrid({ ...control, headerRows, designRows, staticRows }).cells
+  const cells = normalizeCellRows(base, rowCount, colCount)
+  return { ...control, headerRows, designRows, staticRows, cells }
+}
+
+/** 在列尾追加一列（并同步扩展每行的单元格）；返回新控件 */
+export function addTableColumn(control: TableControl, col?: Partial<TableColumn>): TableControl {
+  const idx = control.columns?.length ?? 0
+  const newCol: TableColumn = {
+    title: col?.title ?? `列${idx + 1}`,
+    field: col?.field,
+    expression: col?.expression,
+    width: col?.width ?? 30,
+    align: col?.align,
+    headerAlign: col?.headerAlign,
+    cellBackgroundColor: col?.cellBackgroundColor,
+    headerBackgroundColor: col?.headerBackgroundColor,
+    cellPadding: col?.cellPadding,
+    style: col?.style,
+  }
+  const grid = buildDesignGrid(control) // 当前规范矩阵
+  const cells = grid.cells.map((row, r) => {
+    const row2 = [...row, {}]
+    // 新列表头单元格默认填入列标题（与设计期"列标题推导表头"一致）
+    if (r < grid.headerRows && newCol.title) row2[row2.length - 1] = { text: newCol.title }
+    return row2
+  })
+  return {
+    ...control,
+    columns: [...(control.columns ?? []), newCol],
+    cells,
+    headerRows: grid.headerRows,
+    staticRows: grid.staticRows,
+    designRows: grid.designRows,
+  }
+}
+
+/** 删除指定列（并同步裁剪每行的对应单元格）；至少保留 1 列 */
+export function removeTableColumn(control: TableControl, index: number): TableControl {
+  const cols = control.columns ?? []
+  if (cols.length <= 1 || index < 0 || index >= cols.length) return control
+  const grid = buildDesignGrid(control) // 当前规范矩阵
+  const cells = grid.cells.map((row) => row.filter((_, i) => i !== index))
+  return {
+    ...control,
+    columns: cols.filter((_, i) => i !== index),
+    cells,
+    headerRows: grid.headerRows,
+    staticRows: grid.staticRows,
+    designRows: grid.designRows,
+  }
+}
+
+/** 删除指定行（同步裁剪该行单元格）；至少保留 1 行 */
+export function removeTableRow(control: TableControl, index: number): TableControl {
+  const grid = buildDesignGrid(control)
+  if (index < 0 || index >= grid.rowCount || grid.rowCount <= 1) return control
+  // 数据表的"数据样例行"（唯一 body 行）不可删除，否则破坏逐行渲染模型
+  if (grid.isData && index === grid.headerRows) return control
+  const cells = grid.cells.filter((_, r) => r !== index)
+  let { headerRows, staticRows, designRows } = grid
+  if (index < headerRows) headerRows -= 1
+  else if (grid.isData) staticRows = Math.max(0, staticRows - 1)
+  else designRows = Math.max(0, designRows - 1)
+  return { ...control, headerRows, staticRows, designRows, cells }
+}
+
+/** 列左右移动（上移 / 下移到相邻位置）；同时搬动每行的对应单元格 */
+export function moveTableColumn(control: TableControl, from: number, to: number): TableControl {
+  const cols = control.columns ?? []
+  if (from < 0 || from >= cols.length || to < 0 || to >= cols.length || from === to) return control
+  const grid = buildDesignGrid(control) // 当前规范矩阵
+  const cells = grid.cells.map((row) => {
+    const r = [...row]
+    const [cell] = r.splice(from, 1)
+    r.splice(to, 0, cell!)
+    return r
+  })
+  const movedCols = [...cols]
+  const [col] = movedCols.splice(from, 1)
+  movedCols.splice(to, 0, col!)
+  return {
+    ...control,
+    columns: movedCols,
+    cells,
+    headerRows: grid.headerRows,
+    staticRows: grid.staticRows,
+    designRows: grid.designRows,
+  }
+}
+
+/**
+ * 单元格文本写回（把"用户在 DOM 里敲的字"翻译成协议语义）：
+ * - 表头 / 静态行：写 `text`（纯字面量）
+ * - 数据样例行：写 `expression`（模板串——含 `{{}}` 则运行期插值，纯文字则原样输出），
+ *   并清空 `field`，避免 field/expression 双写时语义打架
+ *
+ * 若文本与"当前占位符"完全一致，视为未改动，直接返回原控件（避免把占位符固化成表达式）。
+ */
+export function patchCellText(
+  control: TableControl,
+  r: number,
+  c: number,
+  raw: string,
+): TableControl {
+  const grid = buildDesignGrid(control)
+  const info = designRowInfo(grid, r)
+  const text = raw.replace(/\u00a0/g, ' ').trim()
+  const cell = grid.cells[r]?.[c] ?? {}
+  const col = control.columns[c]
+
+  if (info.isDataTemplate) {
+    // 占位符显示与 table-design-render 的 fieldPlaceholder 严格对齐，确保"未改动即不写回"
+    const fieldPh = (f: string): string => (f.includes('[]') ? `{{${f}}}` : `{{item.${f}}}`)
+    const current = cell.expression
+      ?? (cell.field ? fieldPh(cell.field) : col?.field ? fieldPh(col.field) : '')
+    if (text === current) return control
+    if (!text) return patchCell(control, r, c, { expression: undefined, field: undefined })
+    // "{{item.xxx}}" 单一普通字段引用 → 回写为 field，保持模型最简
+    const single = /^\{\{\s*item\.([A-Za-z0-9_$.]+)\s*\}\}$/.exec(text)
+    if (single) return patchCell(control, r, c, { field: single[1], expression: undefined })
+    // "{{items[].xxx}}" 含数组标记的单一字段引用 → 同样回写为 field（运行期 resolveBinding 会去前缀取值）
+    const singleArr = /^\{\{\s*([A-Za-z0-9_$\u4e00-\u9fa5][A-Za-z0-9_$\u4e00-\u9fa5.\[\]]*\[\]\.[A-Za-z0-9_$\u4e00-\u9fa5.\[\]]*)\s*\}\}$/.exec(text)
+    if (singleArr) return patchCell(control, r, c, { field: singleArr[1], expression: undefined })
+    return patchCell(control, r, c, { expression: text, field: undefined })
+  }
+
+  if ((cell.text ?? '') === text) return control
+  return patchCell(control, r, c, { text })
+}
+
+/** 不可变合并某单元格样式（只覆盖传入的键，undefined 表示"清除该项"） */
+export function patchCellStyle(
+  control: TableControl,
+  r: number,
+  c: number,
+  style: TableCellStyle,
+): TableControl {
+  const grid = buildDesignGrid(control)
+  const current = grid.cells[r]?.[c]?.style ?? {}
+  const merged: TableCellStyle = { ...current }
+  for (const [k, v] of Object.entries(style)) {
+    if (v === undefined) delete (merged as Record<string, unknown>)[k]
+    else (merged as Record<string, unknown>)[k] = v
+  }
+  return patchCell(control, r, c, { style: merged })
+}
+
+/**
+ * 设置单元格横向合并跨度。
+ * 合并 = 本格 colSpan=n，被吞掉的右侧格清空（渲染时按 span 跳过，模型仍留位保证矩阵规整）。
+ */
+export function setCellSpan(control: TableControl, r: number, c: number, span: number): TableControl {
+  const grid = buildDesignGrid(control)
+  const max = grid.colCount - c
+  const n = Math.max(1, Math.min(Math.floor(span), max))
+  let next = patchCell(control, r, c, { colSpan: n > 1 ? n : undefined })
+  for (let i = 1; i < n; i++) {
+    next = patchCell(next, r, c + i, { text: undefined, field: undefined, expression: undefined, colSpan: undefined })
+  }
+  return next
+}
+
+/**
+ * 设置单元格纵向合并跨度。
+ * 合并 = 本格 rowSpan=m，被吞掉的下方同列格清空（渲染时按 span 跳过，模型仍留位保持矩阵规整）。
+ * 超界自动收敛到网格底边，故改行数 / 删行不会产生非法合并。
+ */
+export function setCellRowSpan(control: TableControl, r: number, c: number, span: number): TableControl {
+  const grid = buildDesignGrid(control)
+  const max = grid.rowCount - r
+  const n = Math.max(1, Math.min(Math.floor(span), max))
+  let next = patchCell(control, r, c, { rowSpan: n > 1 ? n : undefined })
+  for (let k = 1; k < n; k++) {
+    next = patchCell(next, r + k, c, {
+      text: undefined,
+      field: undefined,
+      expression: undefined,
+      colSpan: undefined,
+      rowSpan: undefined,
+    })
+  }
+  return next
+}
+
+/**
+ * 统一计算整张网格的合并布局（colSpan + rowSpan 一起算），供设计 overlay 与运行期引擎共用。
+ *
+ * 规则：
+ * - 跨列：本格 colSpan=n → 同行右侧 n-1 格被跳过（同一行内）。
+ * - 跨行：本格 rowSpan=m → 下方 m-1 行同列（及所跨各列）被跳过。
+ * - 两种跨度可同时作用于同一锚点格（形成 2×N / N×2 / N×M 的合并块）。
+ * - 所有跨度超界自动收敛到网格边界，因此改行数 / 删列 / 移动列都不会产生非法合并或丢列。
+ *
+ * 返回与 cells 同形的矩阵：skip=true 的格由相邻锚点合并，渲染端据此决定"是否输出该 td"。
+ */
+export function computeSpanLayout(
+  cells: TableCell[][],
+  rowCount: number,
+  colCount: number,
+): CellSpan[][] {
+  const out: CellSpan[][] = Array.from({ length: rowCount }, () =>
+    Array.from({ length: colCount }, () => ({ skip: false, colSpan: 1, rowSpan: 1 }) as CellSpan),
+  )
+  // carry[c] = 进入当前行时，第 c 列仍被上方某个 rowspan 占用的剩余行数（>0 表示该格需跳过）
+  const carry = new Array<number>(colCount).fill(0)
+  for (let r = 0; r < rowCount; r++) {
+    const curCarry = carry.slice()
+    const nextCarry = carry.map((v) => Math.max(0, v - 1))
+    let c = 0
+    while (c < colCount) {
+      if (curCarry[c]! > 0) {
+        out[r]![c]!.skip = true
+        c++
+        continue
+      }
+      const cell = cells[r]?.[c] ?? {}
+      const cs = Math.max(1, Math.min(Math.floor(cell.colSpan ?? 1), colCount - c))
+      const rs = Math.max(1, Math.min(Math.floor(cell.rowSpan ?? 1), rowCount - r))
+      out[r]![c]!.colSpan = cs
+      out[r]![c]!.rowSpan = rs
+      if (cs > 1) {
+        // 同一行被横向吞掉的格，标记 skip（矩阵自我完备：skip=true 即"不作为独立 td 输出"）
+        for (let k = 1; k < cs; k++) out[r]![c + k]!.skip = true
+      }
+      if (rs > 1) {
+        // 被跨的每一列在后续行都被占用（含跨列覆盖到的列）
+        for (let k = 0; k < cs; k++) nextCarry[c + k] = Math.max(nextCarry[c + k]!, rs - 1)
+      }
+      c += cs
+    }
+    carry.length = 0
+    carry.push(...nextCarry)
+  }
+  return out
+}
+
+/** 不可变更新某列（数据表数据样例行编辑 = 编辑整列） */
+export function patchColumnStyle(
+  control: TableControl,
+  c: number,
+  style: TableCellStyle,
+): TableControl {
+  const cols = control.columns.map((col, ci) =>
+    ci === c ? { ...col, style: { ...(col.style ?? {}), ...style } } : col,
+  )
+  return { ...control, columns: cols }
+}
+
+/* ----------------------------- 行 / 列插入 ----------------------------- */
+
+/**
+ * 在 `atRow` 处插入一空行（原行下移）。
+ * - 布局网格：直接插入正文区，designRows+1。
+ * - 数据表：数据样例行固定在 headerRows，任何插入都落在静态尾行区（避免破坏"单数据样例行"不变量），
+ *   故 atRow 被收敛到 headerRows+1 之后；staticRows+1。
+ */
+export function insertTableRow(control: TableControl, atRow: number): TableControl {
+  const grid = buildDesignGrid(control)
+  const colCount = grid.colCount
+  const cells = grid.cells.map((row) => row.map((c) => ({ ...c })))
+  const newRow: TableCell[] = Array.from({ length: colCount }, () => ({}))
+  let insertAt = atRow
+  let headerRows = grid.headerRows
+  let designRows = grid.designRows
+  let staticRows = grid.staticRows
+  if (grid.isData) {
+    const minStatic = grid.headerRows + 1
+    insertAt = Math.max(minStatic, atRow)
+    staticRows += 1
+  } else {
+    designRows += 1
+  }
+  cells.splice(insertAt, 0, newRow)
+  return { ...control, headerRows, designRows, staticRows, cells }
+}
+
+/** 在 `atCol` 处插入一空列（原列右移），同步扩展表头与每行的单元格 */
+export function insertTableColumn(control: TableControl, atCol: number): TableControl {
+  const grid = buildDesignGrid(control)
+  const cells = grid.cells.map((row) => {
+    const r = [...row]
+    r.splice(atCol, 0, {})
+    return r
+  })
+  const idx = (control.columns?.length ?? 0) + 1
+  const newCol: TableColumn = {
+    title: `列${idx}`,
+    width: 30,
+    align: 'left',
+    headerAlign: 'center',
+  }
+  const cols = [...(control.columns ?? [])]
+  cols.splice(atCol, 0, newCol)
+  return {
+    ...control,
+    columns: cols,
+    cells,
+    headerRows: grid.headerRows,
+    staticRows: grid.staticRows,
+    designRows: grid.designRows,
+  }
+}
+
+/* ----------------------------- 默认尾行结构 ----------------------------- */
+
+export interface SeedTailOptions {
+  /** 参与合计（数值）的列索引；不传则从数据首行采样 / 列 aggregate 标记推断 */
+  numericColumns?: number[]
+  /** 大写金额取哪列的总计（主金额列索引）；不传取最后一个数值列 */
+  moneyColumn?: number
+  /** 是否植入"大写金额"行（默认 true）。初始化默认表格可传 false，只留本页合计 + 总计两行 */
+  capital?: boolean
+}
+
+/**
+ * 植入"本页合计 / 总计 / 大写金额"三行尾结构（学习金蝶等 ERP 单据设计）：
+ * - 数值列（数量 / 单价 / 金额…）尾格写入聚合 token：本页合计=`{{#pageSum}}`、总计=`{{#totalSum}}`、大写金额=`{{#totalCap}}`；
+ * - 第一列写入行名标签（本页合计 / 总计 / 大写金额），让用户一眼识别；
+ * - 非数值列（名称 / 备注等字符串）尾格留空，不参与计算；
+ * - 数值列自动标记 `aggregate:true`，参与尾行聚合。
+ *
+ * 幂等：若已存在任意聚合 token 尾行则不重复植入。
+ */
+export function seedSummaryTail(control: TableControl, opts: SeedTailOptions = {}): TableControl {
+  const grid = buildDesignGrid(control)
+  // 已植入尾行则不重复：识别聚合 token 或首列的尾行标签（单列表格 token 落在首列，故需同时识别标签）
+  const tailLabels = new Set(['本页合计', '总计', '大写金额'])
+  const seeded = grid.cells.slice(grid.headerRows + 1).some(
+    (row) =>
+      row.some((c) => isAggToken(c.text)) ||
+      (row[0] != null && tailLabels.has(row[0]!.text ?? '')),
+  )
+  if (seeded) return control
+  const cols = control.columns ?? []
+  const colCount = grid.colCount
+
+  // 数值列判定
+  const numeric = new Set<number>(opts.numericColumns ?? [])
+  if (opts.numericColumns === undefined) {
+    const sample = Array.isArray(control.data) && control.data.length ? (control.data[0] as Record<string, unknown>) : undefined
+    cols.forEach((c, i) => {
+      const key = stripItems(c.field)
+      if (c.aggregate === true || c.aggregate === 'sum' || c.aggregate === 'avg' || c.aggregate === 'count') {
+        numeric.add(i)
+      } else if (key && sample && typeof sample[key] === 'number') {
+        numeric.add(i)
+      }
+    })
+  }
+  const money = opts.moneyColumn ?? [...numeric].sort((a, b) => b - a)[0] ?? -1
+
+  const makeRow = (label: string, token: string | null): TableCell[] =>
+    Array.from({ length: colCount }, (_, c) => {
+      if (c === 0) return { text: label, style: { bold: true, align: 'left' } }
+      if (token && numeric.has(c)) return { text: token, style: { bold: true, align: 'right' } }
+      return {}
+    })
+  const pageRow = makeRow('本页合计', '{{#pageSum}}')
+  const totalRow = makeRow('总计', '{{#totalSum}}')
+  const withCap = opts.capital ?? true
+  const capRow: TableCell[] = Array.from({ length: colCount }, (_, c) => {
+    if (c === 0) return { text: '大写金额', style: { bold: true, align: 'left' } }
+    if (c === money) return { text: '{{#totalCap}}', style: { bold: true, align: 'left' } }
+    return {}
+  })
+
+  // 数值列标记 aggregate:true
+  const newCols = cols.map((c, i) => (numeric.has(i) ? { ...c, aggregate: true as const } : c))
+
+  const tailRows = withCap ? [pageRow, totalRow, capRow] : [pageRow, totalRow]
+  const cells = [...grid.cells, ...tailRows]
+  return {
+    ...control,
+    columns: newCols,
+    cells,
+    headerRows: grid.headerRows,
+    staticRows: grid.staticRows + tailRows.length,
+    designRows: grid.designRows,
+  }
+}
diff --git a/openprint/src/core/layout-engine/table-engine.spec.ts b/openprint/src/core/layout-engine/table-engine.spec.ts
new file mode 100644
index 0000000..0b9c4a4
--- /dev/null
+++ b/openprint/src/core/layout-engine/table-engine.spec.ts
@@ -0,0 +1,497 @@
+import { describe, expect, it } from 'vitest'
+
+import {
+  buildTableModel,
+  normalizeColumnWidths,
+  sliceTable,
+} from '@/core/layout-engine/table-engine'
+import { isDataTable } from '@/core/layout-engine/table-cells'
+import type { TableColumn, TableControl } from '@/types/control'
+import type { EvalContext } from './types'
+import { createCjkMeasurer } from '@/core/__tests__/cjk-measurer'
+
+type Model = ReturnType<typeof buildTableModel>
+
+describe('normalizeColumnWidths —— 列宽归一化', () => {
+  it('按比例缩放使列宽和 = totalWidth', () => {
+    const cols: TableColumn[] = [
+      { title: 'A', field: 'a', width: 10 },
+      { title: 'B', field: 'b', width: 20 },
+    ]
+    const out = normalizeColumnWidths(cols, 30)
+    expect(out).toEqual([10, 20])
+    expect(out.reduce((s, w) => s + w, 0)).toBeCloseTo(30, 6)
+  })
+
+  it('全部为 0 时均分', () => {
+    const cols: TableColumn[] = [{ title: 'A', field: 'a', width: 0 }, { title: 'B', field: 'b', width: 0 }]
+    const out = normalizeColumnWidths(cols, 10)
+    expect(out[0]).toBeCloseTo(5, 6)
+    expect(out[1]).toBeCloseTo(5, 6)
+  })
+
+  it('含 0 宽列时保持 0，其余按比例', () => {
+    const cols: TableColumn[] = [
+      { title: 'A', field: 'a', width: 2 },
+      { title: 'B', field: 'b', width: 0 },
+      { title: 'C', field: 'c', width: 2 },
+    ]
+    const out = normalizeColumnWidths(cols, 8)
+    expect(out[0]).toBeCloseTo(4, 6)
+    expect(out[1]).toBe(0)
+    expect(out[2]).toBeCloseTo(4, 6)
+    expect(out.reduce((s, w) => s + w, 0)).toBeCloseTo(8, 6)
+  })
+})
+
+describe('buildTableModel —— 表格建模', () => {
+  const measurer = createCjkMeasurer()
+  const control = {
+    id: 'tbl',
+    type: 'table',
+    left: 0,
+    top: 0,
+    width: 100,
+    height: 50,
+    dataSource: 'items',
+    columns: [
+      { field: 'name', title: '名称', width: 60, align: 'left' },
+      { field: 'qty', title: '数量', width: 40, align: 'right' },
+    ],
+    options: { repeatHeader: true },
+  } as unknown as Parameters<typeof buildTableModel>[0]['control']
+
+  it('根据 dataSource 生成与数据等量的数据行', () => {
+    const ctx = { data: { items: [{ name: 'A', qty: 1 }, { name: 'B', qty: 2 }, { name: 'C', qty: 3 }] } }
+    const model = buildTableModel({ control, ctx, measurer, widthMm: 100, heightMm: 50 })
+    expect(model.rows.length).toBe(3)
+    expect(model.columnWidths.length).toBe(2)
+    expect(model.columnWidths.reduce((s, w) => s + w, 0)).toBeCloseTo(100, 6)
+    expect(model.headerRows.length).toBeGreaterThan(0)
+    expect(model.isLayoutGrid).toBe(false)
+  })
+
+  it('无数据源时退化为布局网格（固定行数）', () => {
+    const grid = { ...control, dataSource: '' } as unknown as Parameters<typeof buildTableModel>[0]['control']
+    const model = buildTableModel({ control: grid, ctx: { data: {} }, measurer, widthMm: 100, heightMm: 50 })
+    expect(model.isLayoutGrid).toBe(true)
+    expect(model.rows.length).toBeGreaterThan(0)
+  })
+
+  /** 取出第一条数据行的第 col 列渲染文本 */
+  function dataCellText(ctrl: Parameters<typeof buildTableModel>[0]['control'], ctx: EvalContext, col: number): string {
+    const model = buildTableModel({ control: ctrl, ctx, measurer, widthMm: 100, heightMm: 50 })
+    const row = model.rows.find((r) => r.kind === 'data')
+    if (!row) throw new Error('no data row')
+    return (row.cells[col] as { text: string }).text
+  }
+
+  it('列格式 decimal：数字按小数位+千分位渲染', () => {
+    const c = {
+      ...control,
+      columns: [{ field: 'price', title: '单价', width: 40, align: 'right', format: { kind: 'decimal', digits: 2 } }],
+    } as unknown as Parameters<typeof buildTableModel>[0]['control']
+    expect(dataCellText(c, { data: { items: [{ price: 1234.5 }] } }, 0)).toBe('1,234.50')
+  })
+
+  it('列格式 currency：带币种符号', () => {
+    const c = {
+      ...control,
+      columns: [{ field: 'amount', title: '金额', width: 40, align: 'right', format: { kind: 'currency', code: 'CNY' } }],
+    } as unknown as Parameters<typeof buildTableModel>[0]['control']
+    expect(dataCellText(c, { data: { items: [{ amount: 9999.9 }] } }, 0)).toBe('¥9,999.90')
+  })
+
+  it('单元格 format 覆盖列 format', () => {
+    const c = {
+      ...control,
+      columns: [{ field: 'qty', title: '数量', width: 40, align: 'right', format: { kind: 'decimal', digits: 2 } }],
+      cells: [
+        [{ text: '数量' }],
+        [{ field: 'qty', format: { kind: 'int' } }],
+      ],
+    } as unknown as Parameters<typeof buildTableModel>[0]['control']
+    expect(dataCellText(c, { data: { items: [{ qty: 1234.5 }] } }, 0)).toBe('1,235')
+  })
+
+  it('表头/静态行绑定 cell.field 应解析主表标量（回归：staticCellText 曾忽略 field）', () => {
+    const c = {
+      ...control,
+      dataSource: '',
+      headerRows: 1,
+      staticRows: 1,
+      cells: [
+        [{ field: 'order.no' }, { text: '数量' }],
+        [{ field: 'order.total' }, { text: '' }],
+      ],
+    } as unknown as Parameters<typeof buildTableModel>[0]['control']
+    const ctx = { data: { order: { no: 'NO-001', total: 5 } } }
+    const model = buildTableModel({ control: c, ctx, measurer, widthMm: 100, heightMm: 50 })
+    // 表头单元格：绑定 order.no → 解析出主表标量（修复前为空）
+    expect(model.headerRows[0]!.cells[0]!.text).toBe('NO-001')
+    // 静态尾行单元格：绑定 order.total → 解析出 5
+    const staticRow = model.rows.find((r) => r.kind === 'static')
+    expect(staticRow).toBeTruthy()
+    expect(staticRow!.cells[0]!.text).toBe('5')
+  })
+})
+
+describe('sliceTable —— 分页切片（含空尾片回归）', () => {
+  function mkModel(rowCount: number): Model {
+    return {
+      control: { id: 't', type: 'table', options: { repeatHeader: true, repeatFooter: false } } as Model['control'],
+      columns: [],
+      columnWidths: [],
+      headerRows: [{ kind: 'header', height: 8, cells: [] }],
+      rows: Array.from({ length: rowCount }, (_, i) => ({
+        kind: 'data',
+        height: 8,
+        dataIndex: i,
+        cells: [],
+      })) as Model['rows'],
+      footerRows: [{ kind: 'summary', height: 8, cells: [{ text: '合计', align: 'left' }] }],
+      dataRows: [],
+      warnings: [],
+      isLayoutGrid: false,
+    } as Model
+  }
+
+  it('从 start=0 切片：取全部行，末片挂合计行', () => {
+    const model = mkModel(3)
+    const slice = sliceTable(model, { avail: 100, start: 0 })
+    expect(slice.rows.length).toBe(3)
+    expect(slice.footerRows.length).toBeGreaterThan(0) // 末片 + 空间充足 → 合计行
+    expect(slice.isLast).toBe(true)
+    expect(slice.nextStart).toBe(3)
+  })
+
+  it('空尾片（start 越界）不挂合计行，也不产出多余数据行', () => {
+    const model = mkModel(3)
+    const slice = sliceTable(model, { avail: 100, start: 3 })
+    expect(slice.rows.length).toBe(0) // 关键回归：不再渲染第二个空表
+    expect(slice.footerRows.length).toBe(0) // 关键回归：空尾片不再挂合计
+    expect(slice.isLast).toBe(true)
+    expect(slice.nextStart).toBe(3)
+  })
+
+  it('空间不足时本页少放，nextStart 后移', () => {
+    const model = mkModel(5)
+    // 每页能放 2 行（header 8 + 2*8 = 24 ≤ avail 24；第 3 行 8 会使 32 > 24）
+    const slice = sliceTable(model, { avail: 24, start: 0 })
+    expect(slice.rows.length).toBe(2)
+    expect(slice.nextStart).toBe(2)
+    expect(slice.isLast).toBe(false)
+  })
+})
+
+/* ----------------------- 合计行（options.summaryRow） ----------------------- */
+
+function mkSummaryControl(opts: TableControl['options']): Parameters<typeof buildTableModel>[0]['control'] {
+  return {
+    id: 'tbl',
+    type: 'table',
+    left: 0,
+    top: 0,
+    width: 100,
+    height: 50,
+    dataSource: 'items',
+    columns: [
+      { field: 'name', title: '名称', width: 60, align: 'left' },
+      { field: 'qty', title: '数量', width: 40, align: 'right' },
+    ],
+    options: opts,
+  } as unknown as Parameters<typeof buildTableModel>[0]['control']
+}
+
+describe('buildTableModel —— 合计行（options.summaryRow）', () => {
+  const measurer = createCjkMeasurer()
+
+  it('求和：表尾合计行在聚合列显示总和，首列显示标签', () => {
+    const ctx = { data: { items: [{ name: 'A', qty: 1 }, { name: 'B', qty: 2 }, { name: 'C', qty: 3 }] } }
+    const model = buildTableModel({
+      control: mkSummaryControl({ summaryRow: { type: 'sum', fields: ['qty'], label: '合计' } }),
+      ctx,
+      measurer,
+      widthMm: 100,
+      heightMm: 50,
+    })
+    expect(model.footerRows.length).toBe(1)
+    const row = model.footerRows[0]!
+    expect(row.kind).toBe('summary')
+    expect(row.cells[0]!.text).toBe('合计')
+    const qtyCell = row.cells.find((c) => c.text === '6')
+    expect(qtyCell).toBeTruthy()
+    expect(qtyCell!.bold).toBe(true)
+    expect(qtyCell!.align).toBe('right')
+  })
+
+  it('计数：聚合列显示数据总行数', () => {
+    const ctx = { data: { items: [{ name: 'A', qty: 1 }, { name: 'B', qty: 2 }, { name: 'C', qty: 3 }] } }
+    const model = buildTableModel({
+      control: mkSummaryControl({ summaryRow: { type: 'count', fields: ['qty'], label: '合计' } }),
+      ctx,
+      measurer,
+      widthMm: 100,
+      heightMm: 50,
+    })
+    const row = model.footerRows[0]!
+    expect(row.cells.find((c) => c.text === '3')).toBeTruthy()
+  })
+
+  it('未配置合计行时不生成表尾', () => {
+    const ctx = { data: { items: [{ name: 'A', qty: 1 }] } }
+    const model = buildTableModel({
+      control: mkSummaryControl({}),
+      ctx,
+      measurer,
+      widthMm: 100,
+      heightMm: 50,
+    })
+    expect(model.footerRows.length).toBe(0)
+  })
+})
+
+describe('buildTableModel —— 分组小计（groupBy + summaryRow）', () => {
+  const measurer = createCjkMeasurer()
+  const control = {
+    id: 'tbl',
+    type: 'table',
+    left: 0,
+    top: 0,
+    width: 100,
+    height: 50,
+    dataSource: 'items',
+    groupBy: 'cat',
+    columns: [
+      { field: 'name', title: '名称', width: 60, align: 'left' },
+      { field: 'qty', title: '数量', width: 40, align: 'right' },
+    ],
+    options: { summaryRow: { type: 'sum', fields: ['qty'], label: '合计' } },
+  } as unknown as Parameters<typeof buildTableModel>[0]['control']
+
+  it('按分组字段生成组头 + 每组小计 + 末尾总计', () => {
+    const ctx = {
+      data: {
+        items: [
+          { name: 'A', qty: 1, cat: 'x' },
+          { name: 'B', qty: 2, cat: 'x' },
+          { name: 'C', qty: 3, cat: 'y' },
+        ],
+      },
+    }
+    const model = buildTableModel({ control, ctx, measurer, widthMm: 100, heightMm: 50 })
+    expect(model.rows.some((r) => r.kind === 'group')).toBe(true)
+    const subs = model.rows.filter((r) => r.kind === 'subtotal')
+    expect(subs.length).toBe(2)
+    // 每组内求和：x=1+2=3，y=3，均显示 3
+    expect(subs.every((s) => s.cells.find((c) => c.text === '3'))).toBe(true)
+    // 末尾总计 = 1+2+3 = 6
+    const total = model.footerRows.find((r) => r.kind === 'summary')
+    expect(total?.cells.find((c) => c.text === '6')).toBeTruthy()
+  })
+
+  it('分组小计应用自定义标签与样式', () => {
+    const ctx = {
+      data: {
+        items: [
+          { name: 'A', qty: 1, cat: 'x' },
+          { name: 'B', qty: 2, cat: 'x' },
+        ],
+      },
+    }
+    const model = buildTableModel({
+      control: {
+        id: 'tbl',
+        type: 'table',
+        left: 0,
+        top: 0,
+        width: 100,
+        height: 50,
+        dataSource: 'items',
+        groupBy: 'cat',
+        columns: [
+          { field: 'name', title: '名称', width: 60, align: 'left' },
+          { field: 'qty', title: '数量', width: 40, align: 'right' },
+        ],
+        options: {
+          summaryRow: {
+            type: 'sum',
+            fields: ['qty'],
+            label: '总计',
+            subtotalLabel: '${key} 分组小计',
+            subtotalStyle: { bold: true, backgroundColor: '#EEF3FF', color: '#c00' },
+          },
+        },
+      } as unknown as Parameters<typeof buildTableModel>[0]['control'],
+      ctx,
+      measurer,
+      widthMm: 100,
+      heightMm: 50,
+    })
+    const subs = model.rows.filter((r) => r.kind === 'subtotal')
+    expect(subs.length).toBe(1)
+    expect(subs[0]!.cells[0]!.text).toBe('x 分组小计')
+    // 整行套用 subtotalStyle（标签格也应带颜色）
+    expect(subs[0]!.cells[0]!.color).toBe('#c00')
+    expect(subs[0]!.cells[0]!.background).toBe('#EEF3FF')
+    // 聚合列显示本组求和 1+2=3
+    expect(subs[0]!.cells.find((c) => c.text === '3')).toBeTruthy()
+  })
+
+  it('自定义合计表达式在表尾生效（footer 显示求值结果）', () => {
+    const ctx = { data: { items: [{ name: 'A', amount: 10 }, { name: 'B', amount: 20 }] } }
+    const model = buildTableModel({
+      control: {
+        id: 'tbl',
+        type: 'table',
+        left: 0,
+        top: 0,
+        width: 100,
+        height: 50,
+        dataSource: 'items',
+        // 首列为非聚合列（放标签），第二列为聚合列（放自定义求值结果）
+        columns: [
+          { field: 'name', title: '名称', width: 60, align: 'left' },
+          { field: 'amount', title: '金额', width: 40, align: 'right' },
+        ],
+        options: {
+          summaryRow: {
+            type: 'custom',
+            fields: ['amount'],
+            label: '自定义合计',
+            expression: 'sum.amount + 5',
+          },
+        },
+      } as unknown as Parameters<typeof buildTableModel>[0]['control'],
+      ctx,
+      measurer,
+      widthMm: 100,
+      heightMm: 50,
+    })
+    expect(model.footerRows.length).toBe(1)
+    const row = model.footerRows[0]!
+    expect(row.kind).toBe('summary')
+    expect(row.cells[0]!.text).toBe('自定义合计')
+    // 聚合列显示 (10+20) + 5 = 35
+    expect(row.cells.find((c) => c.text === '35')).toBeTruthy()
+  })
+})
+
+describe('rowSpan 纵向合并渲染', () => {
+  const measurer = createCjkMeasurer()
+
+  it('布局网格：纵向合并时下方被吞单元格不进 cells，锚点带 rowSpan', () => {
+    const control = {
+      id: 'tbl',
+      type: 'table',
+      left: 0,
+      top: 0,
+      width: 100,
+      height: 40,
+      columns: [
+        { title: 'A', width: 50 },
+        { title: 'B', width: 50 },
+      ],
+      headerRows: 0,
+      designRows: 2,
+      cells: [
+        [
+          { rowSpan: 2, text: '合并' },
+          { text: '右1' },
+        ],
+        [
+          { text: '下左' },
+          { text: '下右' },
+        ],
+      ],
+      options: {},
+    } as unknown as TableControl
+
+    const model = buildTableModel({ control, ctx: { data: {} }, measurer, widthMm: 100, heightMm: 40 })
+    expect(model.isLayoutGrid).toBe(true)
+    // 第 0 行：锚点(合并, rowSpan=2) + 右1 → 2 个单元格
+    expect(model.rows[0]!.cells.length).toBe(2)
+    expect(model.rows[0]!.cells[0]!.rowSpan).toBe(2)
+    // 第 1 行：被吞的"下左"不出现，只剩"下右" → 1 个单元格
+    expect(model.rows[1]!.cells.length).toBe(1)
+    expect(model.rows[1]!.cells[0]!.text).toBe('下右')
+  })
+
+  it('数据行模板的 rowSpan 被强制为 1（不跨记录）', () => {
+    const control = {
+      id: 'tbl',
+      type: 'table',
+      left: 0,
+      top: 0,
+      width: 100,
+      height: 60,
+      dataSource: 'items',
+      columns: [
+        { field: 'name', title: '名称', width: 50 },
+        { field: 'qty', title: '数量', width: 50 },
+      ],
+      cells: [
+        [{ text: '名称' }, { text: '数量' }],
+        [{ rowSpan: 2, field: 'name' }, { field: 'qty' }],
+      ],
+      options: {},
+    } as unknown as TableControl
+
+    const ctx = { data: { items: [{ name: 'A', qty: 1 }, { name: 'B', qty: 2 }] } }
+    const model = buildTableModel({ control, ctx, measurer, widthMm: 100, heightMm: 60 })
+    // 每条数据行的首格不应带 rowSpan（避免跨记录合并）
+    expect(model.rows.every((r) => r.cells[0]!.rowSpan === undefined)).toBe(true)
+  })
+})
+
+describe('buildTableModel —— 内嵌 data（与 dataSource 字段解耦）', () => {
+  const measurer = createCjkMeasurer()
+
+  it('无 dataSource、带 data 时按内嵌数据生成数据行并解析字段', () => {
+    const control = {
+      id: 'tbl',
+      type: 'table',
+      left: 0,
+      top: 0,
+      width: 100,
+      height: 50,
+      // 注意：这里刻意不设置 dataSource
+      columns: [
+        { title: '名称', field: 'items[].name', width: 50 },
+        { title: '数量', field: 'items[].qty', width: 50 },
+      ],
+      headerRows: 1,
+      data: [
+        { name: 'A', qty: 1 },
+        { name: 'B', qty: 2 },
+      ],
+      options: { pageRows: 'auto', repeatHeader: true, borders: 'all' },
+    } as unknown as TableControl
+
+    // 全局 ctx 里没有任何 items，证明数据完全来自 control.data
+    const ctx = { data: {} } as unknown as EvalContext
+    const model = buildTableModel({ control, ctx, measurer, widthMm: 100, heightMm: 50 })
+    expect(model.rows).toHaveLength(2)
+    expect(model.rows[0]!.cells[0]!.text).toBe('A')
+    expect(model.rows[1]!.cells[1]!.text).toBe('2')
+    // 表头来自 columns.title
+    expect(model.headerRows[0]!.cells[0]!.text).toBe('名称')
+  })
+
+  it('isDataTable 对内嵌 data 返回 true（供 analyzeBody 识别为分页流表）', () => {
+    const withData = {
+      id: 't',
+      type: 'table',
+      columns: [],
+      data: [{ a: 1 }],
+    } as unknown as TableControl
+    expect(isDataTable(withData)).toBe(true)
+    const empty = {
+      id: 't2',
+      type: 'table',
+      columns: [],
+      data: [],
+    } as unknown as TableControl
+    expect(isDataTable(empty)).toBe(false)
+  })
+})
diff --git a/openprint/src/core/layout-engine/table-engine.ts b/openprint/src/core/layout-engine/table-engine.ts
new file mode 100644
index 0000000..f223917
--- /dev/null
+++ b/openprint/src/core/layout-engine/table-engine.ts
@@ -0,0 +1,839 @@
+/**
+ * TableEngine —— 动态表格建模与切片分页
+ * 真理源：《OpenPrint-设计方案.md》§5.4（表格统一设计）、§7.4（难点清单）
+ *
+ * 覆盖 §7.4 难点：
+ * | 难点 | 实现位置 |
+ * |---|---|
+ * | 动态表格分页 / 表头重复 | sliceTable() 的 repeatHeader 分支 |
+ * | 每页行数控制 pageRows | sliceTable() 的 forcedRows |
+ * | 行内文本测量 rowHeightMode:'auto' | measureRowHeight() |
+ * | keepTogether 起始不足整体下移 | minStartHeight()（由 pagination-engine 调用） |
+ * | 合计/表尾 repeatFooter | sliceTable() 的 footer 预算 |
+ * | 空行 / 空表 skipEmptyRows | buildTableModel() |
+ * | 多单合并 mergeSheets | resolveRows() |
+ *
+ * 分两步：**建模**（一次性算完所有行与高度）→ **切片**（按页可用高度取行）。
+ * 这样分页只是纯几何切割，不再触碰数据语义，逻辑可测且不会走样。
+ *
+ * ## 内容真理源 = 设计期单元格网格（方案 A）
+ *
+ * 建模不再直接读列配置，而是统一经 `buildDesignGrid(control)`：
+ * 表头行、数据样例行（模板）、静态尾行都来自同一份 `cells` 网格 —— 设计画布画的是它、
+ * 打印吃的也是它，字体/颜色/对齐/合并因此天然一致（真·所见即所得）。
+ * 未设置 `cells` 的老模板由 `buildDesignGrid` 从列配置瞬时推导，行为与旧版逐字节等价。
+ */
+import type { HAlign, TableCell, TableCellStyle, TableColumn, TableControl } from '@/types/control'
+import { FILTERS, interpolate, resolveBinding, stringifyValue, formatCellValue } from './expression'
+import {
+  aggValueForRows,
+  columnAggregatable,
+  formatAggNumber,
+  isAggToken,
+  parseAggToken,
+  stripItems,
+  toChineseCapitalRMB,
+  type FooterKind,
+} from './aggregate'
+import {
+  buildDesignGrid,
+  computeSpanLayout,
+  designRowHeights,
+  isDataTable,
+  resolveCellStyleFor,
+  type CellSpan,
+  type DesignRowKind,
+} from './table-cells'
+import {
+  buildSummaryPlan,
+  isEmptyRow,
+  planRows,
+  readField,
+  summaryLabel,
+  type RowPlan,
+} from './group-engine'
+import type { TextMeasurer } from './measure'
+import type { EvalContext, RenderCell, RenderRow, RenderWarning } from './types'
+
+/* ------------------------------- 排版常数 ------------------------------- */
+
+/** 表格文字字号（pt）—— 与设计画布 PrintTable 的 9pt 保持一致，确保"所见即所得" */
+export const TABLE_FONT_SIZE = 9
+/**
+ * 单元格水平内边距（mm）。
+ * 说明：协议注释写的默认 4mm 若同时用作垂直内边距会让行高凭空多出 8mm，
+ * 对 ERP 密集表格不可用；这里把 cellPadding 解释为**水平内缩**（业界报表工具通用语义），
+ * 垂直方向由 CELL_PADDING_Y 单独控制。
+ */
+export const DEFAULT_CELL_PADDING = 2
+/** 单元格垂直内边距（mm，上下各一份） */
+export const CELL_PADDING_Y = 1.2
+/** 最小行高（mm），防止空行被压成一条线 */
+export const MIN_ROW_HEIGHT = 6
+/** 表头行相对数据行的高度系数 */
+export const HEADER_ROW_FACTOR = 1
+
+/* -------------------------------- 模型 -------------------------------- */
+
+export interface TableModel {
+  control: TableControl
+  columns: TableColumn[]
+  /** 归一化后的各列实际宽度（mm，合计 = 控件宽度） */
+  columnWidths: number[]
+  /** 表头行（支持多行；无表头时为空数组） */
+  headerRows: RenderRow[]
+  /** 数据 + 组头 + 小计行（按打印顺序） */
+  rows: RenderRow[]
+  /** 表尾块：聚合尾行（本页合计/总计/大写金额）+ 设计期静态尾行（备注 / 签字栏） */
+  footerRows: RenderRow[]
+  /** 解析后的全表数据行（供切片期重算合计；尾行聚合的真理源） */
+  dataRows: Array<Record<string, unknown>>
+  warnings: RenderWarning[]
+  /** 是否为布局网格（无 dataSource 的空白表格，§5.4） */
+  isLayoutGrid: boolean
+}
+
+/** 行高累加（表头 / 表尾块） */
+export function sumRowHeights(rows: RenderRow[]): number {
+  return rows.reduce((s, r) => s + r.height, 0)
+}
+
+/* ------------------------------ 数据行解析 ------------------------------ */
+
+function asRecord(v: unknown): Record<string, unknown> | null {
+  return v !== null && typeof v === 'object' && !Array.isArray(v)
+    ? (v as Record<string, unknown>)
+    : null
+}
+
+/**
+ * 取出表格的数据行。
+ * mergeSheets（§9.2.1a 多单合并）：dataSource 解析出的若干数组会被**扁平拼接**成一条连续行流，
+ * 使多张单据一次连续打印，而不是各自起新页。
+ */
+function resolveRows(
+  control: TableControl,
+  ctx: EvalContext,
+  warnings: RenderWarning[],
+): Array<Record<string, unknown>> {
+  const path = control.dataSource?.trim()
+  if (path) {
+    const raw = resolveBinding(path, ctx)
+    if (raw === null || raw === undefined) {
+      warnings.push({
+        code: 'DATASOURCE_EMPTY',
+        message: `表格数据源 "${path}" 在数据中不存在`,
+        controlId: control.id,
+      })
+      return []
+    }
+
+    if (!Array.isArray(raw)) {
+      warnings.push({
+        code: 'DATASOURCE_NOT_ARRAY',
+        message: `表格数据源 "${path}" 不是数组（实际为 ${typeof raw}）`,
+        controlId: control.id,
+      })
+      return []
+    }
+
+    const merge = control.options?.mergeSheets ?? false
+    const out: Array<Record<string, unknown>> = []
+    for (const item of raw) {
+      if (Array.isArray(item)) {
+        // 多单合并：嵌套数组扁平化；未开启合并时忽略嵌套数组（避免打出乱序内容）
+        if (merge) {
+          for (const sub of item) {
+            const rec = asRecord(sub)
+            if (rec) out.push(rec)
+          }
+        }
+        continue
+      }
+      const rec = asRecord(item)
+      if (rec) out.push(rec)
+    }
+
+    if (out.length === 0) {
+      warnings.push({
+        code: 'DATASOURCE_EMPTY',
+        message: `表格数据源 "${path}" 为空数组`,
+        controlId: control.id,
+      })
+    }
+    return out
+  }
+
+  // 表格自带内嵌数据（导入数据场景）：与 dataSource 字段解耦，直接作为数据行
+  if (Array.isArray(control.data) && control.data.length > 0) {
+    const out: Array<Record<string, unknown>> = []
+    for (const item of control.data) {
+      const rec = asRecord(item)
+      if (rec) out.push(rec)
+    }
+    return out
+  }
+
+  return []
+}
+
+/* ------------------------------- 列宽归一化 ------------------------------ */
+
+/** 把列的相对宽度按控件实际宽度等比归一，保证列宽之和 === 表格宽度 */
+export function normalizeColumnWidths(columns: TableColumn[], totalWidth: number): number[] {
+  const sum = columns.reduce((s, c) => s + (c.width > 0 ? c.width : 0), 0)
+  if (sum <= 0) {
+    const even = totalWidth / Math.max(1, columns.length)
+    return columns.map(() => even)
+  }
+  return columns.map((c) => ((c.width > 0 ? c.width : 0) / sum) * totalWidth)
+}
+
+/* ------------------------------- 单元格取值 ------------------------------ */
+
+function interp(src: string, ctx: EvalContext, errors: string[]): string {
+  const r = interpolate(src, ctx)
+  errors.push(...r.errors)
+  return r.text
+}
+
+/**
+ * 数据行单元格取值。优先级：单元格 expression > 单元格 field > 单元格固定文字 > 列 expression > 列 field。
+ * （单元格未设置任何内容时回落到列配置，既兼容老模板，也让"新增列"立刻可用。）
+ */
+function dataCellText(
+  cell: TableCell,
+  col: TableColumn | undefined,
+  ctx: EvalContext,
+  errors: string[],
+): string {
+  if (cell.expression) return interp(cell.expression, ctx, errors)
+  if (cell.field) return formatCellValue(resolveBinding(cell.field, ctx), cell.format ?? col?.format)
+  if (cell.text !== undefined) return interp(cell.text, ctx, errors)
+  if (col?.expression) return interp(col.expression, ctx, errors)
+  if (col?.field) return formatCellValue(resolveBinding(col.field, ctx), col?.format)
+  return ''
+}
+
+/**
+ * 表头 / 静态行取值。优先级与数据行对齐：单元格 expression > 单元格 field > 单元格字面量 > 列 field。
+ * - 支持 {{}} 插值（如"合计：{{order.total}}"、"第 {{page}} 页"）；
+ * - 也支持字段绑定（order.no）：经 resolveBinding 解析主表标量字段；
+ * - 无任何标记的字面量文字原样输出（即"普通文本"约定）。
+ */
+function staticCellText(
+  cell: TableCell,
+  col: TableColumn | undefined,
+  fallback: string,
+  ctx: EvalContext,
+  errors: string[],
+): string {
+  if (cell.expression) return interp(cell.expression, ctx, errors)
+  if (cell.field) return formatCellValue(resolveBinding(cell.field, ctx), cell.format ?? col?.format)
+  if (cell.text !== undefined) return interp(cell.text, ctx, errors)
+  if (col?.field) return formatCellValue(resolveBinding(col.field, ctx), col?.format)
+  if (!fallback) return ''
+  return interp(fallback, ctx, errors)
+}
+
+/** 聚合值显示：整数不带小数，小数保留两位，统一加千分位 */
+function formatAggregate(v: number): string {
+  return Number.isInteger(v) ? FILTERS.number!(v, 0) : FILTERS.number!(v, 2)
+}
+
+/* ---------------------------- 单元格 → 渲染单元格 --------------------------- */
+
+/** 与 cells[] 一一对应的几何（含 colSpan 合并后的宽度），供行高测量使用 */
+interface RowGeometry {
+  widths: number[]
+  pads: number[]
+}
+
+interface BuiltRow {
+  cells: RenderCell[]
+  geo: RowGeometry
+}
+
+/** 把设计期样式盖到渲染单元格上（只覆盖显式设置过的项，未设置的保留 kind 默认值） */
+function applyCellStyle(
+  base: RenderCell,
+  control: TableControl,
+  col: TableColumn | undefined,
+  cell: TableCell,
+  kind: DesignRowKind,
+): RenderCell {
+  const s = resolveCellStyleFor(control, col, cell, kind)
+  const out: RenderCell = { ...base }
+  if (s.align) out.align = s.align
+  if (s.backgroundColor) out.background = s.backgroundColor
+  if (s.bold !== undefined) out.bold = s.bold
+  if (s.fontSize !== undefined) out.fontSize = s.fontSize
+  if (s.fontFamily) out.fontFamily = s.fontFamily
+  if (s.italic !== undefined) out.italic = s.italic
+  if (s.underline !== undefined) out.underline = s.underline
+  if (s.color) out.color = s.color
+  if (s.valign) out.valign = s.valign
+  if (s.diagonal) out.diagonal = s.diagonal
+  return out
+}
+
+/**
+ * 摊平一行设计期单元格：处理 colSpan / rowSpan（合并宽度、跳过被吞掉的格），
+ * 同时产出与渲染单元格对齐的宽度 / 内边距数组，让行高测量吃到真实可用宽度。
+ *
+ * @param spanRow 本行各列的合并布局（computeSpanLayout 已算好）：skip=true 的格被上方/左侧
+ *   合并吞掉，这里直接跳过；colSpan/rowSpan 作为本格的有效跨度。
+ */
+function layoutDesignRow(
+  rowCells: TableCell[],
+  spanRow: CellSpan[],
+  columns: TableColumn[],
+  columnWidths: number[],
+  colCount: number,
+  make: (cell: TableCell, col: TableColumn | undefined, colIndex: number) => RenderCell,
+): BuiltRow {
+  const cells: RenderCell[] = []
+  const widths: number[] = []
+  const pads: number[] = []
+  let c = 0
+  while (c < colCount) {
+    if (spanRow[c]?.skip) {
+      c++
+      continue
+    }
+    const cell = rowCells[c] ?? {}
+    const span = Math.max(1, spanRow[c]!.colSpan)
+    const col = columns[c]
+    let w = 0
+    for (let k = 0; k < span; k++) w += columnWidths[c + k] ?? 0
+    const rc = make(cell, col, c)
+    if (span > 1) rc.colSpan = span
+    if (spanRow[c]!.rowSpan > 1) rc.rowSpan = spanRow[c]!.rowSpan
+    cells.push(rc)
+    widths.push(w)
+    pads.push(col?.cellPadding ?? DEFAULT_CELL_PADDING)
+    c += span
+  }
+  return { cells, geo: { widths, pads } }
+}
+
+/* -------------------------------- 行高测量 ------------------------------- */
+
+function measureRowHeight(
+  { cells, geo }: BuiltRow,
+  control: TableControl,
+  measurer: TextMeasurer,
+): number {
+  const mode = control.options?.rowHeightMode ?? 'auto'
+  if (mode === 'fixed') {
+    return Math.max(MIN_ROW_HEIGHT, control.options?.rowHeight ?? 8)
+  }
+
+  let maxH = 0
+  for (let i = 0; i < cells.length; i++) {
+    const cell = cells[i]!
+    const avail = Math.max(1, (geo.widths[i] ?? 0) - (geo.pads[i] ?? DEFAULT_CELL_PADDING) * 2)
+    const { heightMm } = measurer.measure(cell.text ?? '', {
+      fontSize: cell.fontSize ?? TABLE_FONT_SIZE,
+      fontWeight: cell.bold ? 'bold' : 'normal',
+      widthMm: avail,
+    })
+    if (heightMm > maxH) maxH = heightMm
+  }
+  return Math.max(MIN_ROW_HEIGHT, maxH + CELL_PADDING_Y * 2)
+}
+
+/* -------------------------------- 建模 -------------------------------- */
+
+export interface BuildTableOptions {
+  control: TableControl
+  ctx: EvalContext
+  measurer: TextMeasurer
+  /**
+   * 表格宽度（mm）。协议 page.unit 可能是 in/pt，而测量器只认 mm，
+   * 因此调用方必须把换算后的值传进来；缺省时按 control.width 已是 mm 处理。
+   */
+  widthMm?: number
+  /** 表格高度（mm），仅布局网格算行数时用到 */
+  heightMm?: number
+}
+
+export function buildTableModel({
+  control,
+  ctx,
+  measurer,
+  widthMm,
+  heightMm,
+}: BuildTableOptions): TableModel {
+  const warnings: RenderWarning[] = []
+  const columns = control.columns ?? []
+  const tableWidth = widthMm ?? control.width
+  const tableHeight = heightMm ?? control.height
+  const columnWidths = normalizeColumnWidths(columns, tableWidth)
+  const errors: string[] = []
+
+  // 设计期网格 = 内容与样式的唯一真理源（无 cells 的老模板由列配置瞬时推导）
+  const grid = buildDesignGrid(control)
+  const colCount = grid.colCount
+  // 整张网格的合并布局（colSpan + rowSpan 一起算，设计 overlay 与运行期引擎共用同一份）
+  const spanLayout = computeSpanLayout(grid.cells, grid.rowCount, colCount)
+
+  const buildRowFrom = (
+    rowCells: TableCell[],
+    spanRow: CellSpan[],
+    make: (cell: TableCell, col: TableColumn | undefined, colIndex: number) => RenderCell,
+  ): BuiltRow => layoutDesignRow(rowCells, spanRow, columns, columnWidths, colCount, make)
+
+  /* ── 表头行（支持多行表头） ── */
+  const headerRows: RenderRow[] = []
+  for (let r = 0; r < grid.headerRows; r++) {
+    const built = buildRowFrom(grid.cells[r] ?? [], spanLayout[r]!, (cell, col) =>
+      applyCellStyle(
+        {
+          text: staticCellText(cell, col, col?.title ?? '', ctx, errors),
+          align: col?.headerAlign ?? col?.align ?? 'center',
+          background: col?.headerBackgroundColor,
+          bold: true,
+        },
+        control,
+        col,
+        cell,
+        'header',
+      ),
+    )
+    headerRows.push({
+      kind: 'header',
+      height: measureRowHeight(built, control, measurer) * HEADER_ROW_FACTOR,
+      cells: built.cells,
+    })
+  }
+
+  /** 静态行（布局网格正文 / 数据表静态尾行）：字面量 + 全局插值 */
+  const buildStaticRow = (rowCells: TableCell[], height: number | undefined, spanRow: CellSpan[]): RenderRow => {
+    const built = buildRowFrom(rowCells, spanRow, (cell, col) =>
+      applyCellStyle(
+        { text: staticCellText(cell, col, '', ctx, errors), align: col?.align ?? 'left' },
+        control,
+        col,
+        cell,
+        'static',
+      ),
+    )
+    return {
+      kind: 'static',
+      height: height ?? measureRowHeight(built, control, measurer),
+      cells: built.cells,
+    }
+  }
+
+  const flushErrors = (): void => {
+    for (const message of new Set(errors)) {
+      warnings.push({ code: 'EXPRESSION_ERROR', message, controlId: control.id })
+    }
+  }
+
+  /* ── 布局网格：无数据源，行高与设计画布逐行对齐（§5.4） ── */
+  const isLayoutGrid = !isDataTable(control)
+  if (isLayoutGrid) {
+    // 与设计期共用 designRowHeights：画布上是几毫米，打印就是几毫米
+    const heights = designRowHeights(control, tableHeight)
+    headerRows.forEach((row, i) => {
+      row.height = heights[i] ?? row.height
+    })
+    const rows: RenderRow[] = []
+    for (let r = grid.headerRows; r < grid.rowCount; r++) {
+      rows.push(buildStaticRow(grid.cells[r] ?? [], heights[r], spanLayout[r]!))
+    }
+    flushErrors()
+    return { control, columns, columnWidths, headerRows, rows, footerRows: [], dataRows: [], warnings, isLayoutGrid: true }
+  }
+
+  /* ── 数据行 ── */
+  let dataRows = resolveRows(control, ctx, warnings)
+
+  if (control.options?.skipEmptyRows) {
+    const fields = columns.map((c) => c.field).filter((f): f is string => Boolean(f))
+    dataRows = dataRows.filter((r) => !isEmptyRow(r, fields))
+  }
+
+  const plans = planRows({ control, rows: dataRows, ctx })
+
+  /** 与列 1:1 对齐的行（组头 / 小计 / 合计）的测量几何 */
+  const columnGeo: RowGeometry = {
+    widths: columnWidths,
+    pads: columns.map((c) => c.cellPadding ?? DEFAULT_CELL_PADDING),
+  }
+
+  // 数据样例行（模板）：决定每个数据行的取值方式与单元格样式
+  const template = grid.cells[grid.headerRows] ?? []
+  // 数据行由运行期逐条生成，跨行会跨越不同记录，语义不成立 → 强制模板行 rowSpan=1（colSpan 保留）
+  const templateSpan: CellSpan[] = spanLayout[grid.headerRows]!.map((s) => ({ ...s, rowSpan: 1 }))
+
+  const rows: RenderRow[] = plans.map((plan) => buildRow(plan))
+
+  function buildRow(plan: RowPlan): RenderRow {
+    if (plan.kind === 'group') {
+      const text = plan.label ?? ''
+      const cells: RenderCell[] = [
+        { text, align: 'left', colSpan: colCount, bold: true, background: '#F5F7FA' },
+      ]
+      return {
+        kind: 'group',
+        height: measureRowHeight(
+          { cells, geo: { widths: [tableWidth], pads: [columnGeo.pads[0] ?? DEFAULT_CELL_PADDING] } },
+          control,
+          measurer,
+        ),
+        cells,
+      }
+    }
+
+    if (plan.kind === 'subtotal' || plan.kind === 'summary') {
+      const style =
+        plan.kind === 'subtotal' ? control.options?.summaryRow?.subtotalStyle : undefined
+      const cells = buildAggregateCells(plan.label ?? '小计', plan.aggregates ?? {}, style)
+      return {
+        kind: plan.kind,
+        height: measureRowHeight({ cells, geo: columnGeo }, control, measurer),
+        cells,
+      }
+    }
+
+    // 数据行：内容与样式都由"数据样例行"模板驱动（含 colSpan 合并；rowSpan 强制为 1）
+    const rowCtx: EvalContext = { ...ctx, row: plan.row, rowIndex: plan.dataIndex ?? 0 }
+    const built = buildRowFrom(template, templateSpan, (cell, col) =>
+      applyCellStyle(
+        {
+          text: dataCellText(cell, col, rowCtx, errors),
+          align: col?.align ?? 'left',
+          background: col?.cellBackgroundColor,
+        },
+        control,
+        col,
+        cell,
+        'data',
+      ),
+    )
+    return {
+      kind: 'data',
+      dataIndex: plan.dataIndex,
+      height: measureRowHeight(built, control, measurer),
+      cells: built.cells,
+    }
+  }
+
+  /**
+   * 合计行按列填值：第一列放标签，配置了聚合的列放数值，其余留空。
+   * 若第一列本身就是聚合列，则标签退到"无处可放"，此时把标签并入该列前缀。
+   * @param style 可选样式覆盖（如分组小计行自定义样式），只覆盖显式设置的项。
+   */
+  function buildAggregateCells(
+    label: string,
+    agg: Record<string, number>,
+    style?: TableCellStyle,
+  ): RenderCell[] {
+    const applyStyle = (cell: RenderCell): RenderCell => {
+      if (!style) return cell
+      const out: RenderCell = { ...cell }
+      if (style.bold !== undefined) out.bold = style.bold
+      if (style.italic !== undefined) out.italic = style.italic
+      if (style.underline !== undefined) out.underline = style.underline
+      if (style.fontSize !== undefined) out.fontSize = style.fontSize
+      if (style.fontFamily) out.fontFamily = style.fontFamily
+      if (style.color) out.color = style.color
+      if (style.backgroundColor) out.background = style.backgroundColor
+      if (style.align) out.align = style.align
+      if (style.valign) out.valign = style.valign
+      return out
+    }
+
+    const cells: RenderCell[] = columns.map((c, i) => {
+      const field = c.field
+      const hit =
+        field !== undefined && (field in agg ? field : stripPrefix(field) in agg ? stripPrefix(field) : null)
+      if (hit) {
+        return applyStyle({
+          text: formatAggregate(agg[hit] ?? 0),
+          align: c.align ?? 'right',
+          bold: true,
+        })
+      }
+      return applyStyle({
+        text: i === 0 ? label : '',
+        align: i === 0 ? 'left' : (c.align ?? 'left'),
+        bold: true,
+      })
+    })
+    if (cells.length === 0) {
+      cells.push(applyStyle({ text: label, align: 'left', bold: true, colSpan: 1 }))
+    }
+    return cells
+  }
+
+  function stripPrefix(field: string): string {
+    return field.includes('[].') ? field.slice(field.indexOf('[].') + 3) : field
+  }
+
+  /* ── 表尾块：聚合尾行（本页合计 / 总计 / 大写金额）+ 设计期静态尾行 ── */
+
+  /**
+   * 构建一行表尾（语义尾行）。若该静态行含聚合 token，则按列字段类型判断是否需要计算：
+   * - 数值列 → 标记 isAgg + aggField，渲染期由切片器按本页/总计重算；
+   * - 非数值列（字符串等）→ 不计算，渲染为空占位。
+   * 首列的行名标签（"本页合计"/"总计"/"大写金额"）按普通静态文本处理。
+   */
+  function buildFooterRow(rowCells: TableCell[], spanRow: CellSpan[]): RenderRow {
+    const tokens = rowCells.map((c) => parseAggToken(c.text))
+    const hasToken = tokens.some((t) => t !== null)
+    let fk: FooterKind = 'static'
+    if (hasToken) {
+      if (tokens.some((t) => t === 'pageCap' || t === 'totalCap')) fk = 'capital'
+      else if (tokens.some((t) => t === 'totalSum' || t === 'totalAvg' || t === 'totalCount'))
+        fk = 'grandTotal'
+      else fk = 'pageSubtotal'
+    }
+    const built = buildRowFrom(rowCells, spanRow, (cell, col) => {
+      const tk = parseAggToken(cell.text)
+      if (tk) {
+        const field = stripItems(col?.field)
+        const numeric = columnAggregatable(col, dataRows[0])
+        if (numeric && field) {
+          return applyCellStyle(
+            {
+              text: '',
+              align: col?.align ?? 'right',
+              bold: true,
+              isAgg: true,
+              tokenKind: tk,
+              aggField: field,
+            },
+            control,
+            col,
+            cell,
+            'static',
+          )
+        }
+        // 非数值列：聚合 token 不参与计算，留空
+        return applyCellStyle(
+          { text: '', align: col?.align ?? 'left', bold: true },
+          control,
+          col,
+          cell,
+          'static',
+        )
+      }
+      return applyCellStyle(
+        { text: staticCellText(cell, col, '', ctx, errors), align: col?.align ?? 'left' },
+        control,
+        col,
+        cell,
+        'static',
+      )
+    })
+    return {
+      kind: fk === 'static' ? 'static' : fk === 'pageSubtotal' ? 'subtotal' : 'summary',
+      footerKind: fk,
+      height: measureRowHeight(built, control, measurer),
+      cells: built.cells,
+    }
+  }
+
+  const footerRows: RenderRow[] = []
+  const summaryPlan = buildSummaryPlan(dataRows, control)
+  if (summaryPlan) {
+    const cells = buildAggregateCells(summaryLabel(control), summaryPlan.aggregates ?? {})
+    footerRows.push({
+      kind: 'summary',
+      footerKind: 'static',
+      height: measureRowHeight({ cells, geo: columnGeo }, control, measurer),
+      cells,
+    })
+  }
+  const sample = dataRows[0]
+  for (let r = grid.headerRows + 1; r < grid.rowCount; r++) {
+    footerRows.push(buildFooterRow(grid.cells[r] ?? [], spanLayout[r]!))
+  }
+
+  flushErrors()
+
+  return { control, columns, columnWidths, headerRows, rows, footerRows, dataRows, warnings, isLayoutGrid: false }
+}
+
+/* -------------------------------- 切片 -------------------------------- */
+
+export interface SliceRequest {
+  /** 本页分配给表格的可用高度（mm） */
+  avail: number
+  /** 从 model.rows 的第几行开始 */
+  start: number
+}
+
+export interface SliceResult {
+  headerRows: RenderRow[]
+  rows: RenderRow[]
+  footerRows: RenderRow[]
+  /** 下一片起始下标 */
+  nextStart: number
+  /** 本片实际占高（mm） */
+  height: number
+  isLast: boolean
+  warnings: RenderWarning[]
+}
+
+/** 表格在一页上至少要占的高度（表头 + 1 行 + 表尾），用于 keepTogether 判定 */
+export function minStartHeight(model: TableModel): number {
+  const h = sumRowHeights(model.headerRows)
+  const firstRow = model.rows[0]?.height ?? MIN_ROW_HEIGHT
+  const footer = sumRowHeights(model.footerRows)
+  return h + firstRow + footer
+}
+
+/**
+ * 从 start 位置切出一页能放下的内容。
+ *
+ * 预算顺序：可用高 −（表头）−（表尾）= 数据行预算。
+ * 表尾是否占预算取决于 repeatFooter：
+ * - repeatFooter !== false → 每页都有表尾，恒占预算
+ * - repeatFooter === false → 只有末片有表尾，先按"无表尾"试算，
+ *   若恰好切到最后一行，再回头检查表尾能否塞下，塞不下就吐出若干行留到下一页
+ */
+export function sliceTable(model: TableModel, req: SliceRequest): SliceResult {
+  const warnings: RenderWarning[] = []
+  const opts = model.control.options ?? {}
+  const isFirst = req.start === 0
+
+  const repeatHeader = opts.repeatHeader ?? true
+  const repeatFooter = opts.repeatFooter ?? true
+
+  const headerRows = isFirst || repeatHeader ? model.headerRows : []
+  const headerH = sumRowHeights(headerRows)
+  // 尾行按"是否每页都出现"拆分预算，避免非末页为总计/大写行预留留白：
+  // - 每页固定：本页合计 + 静态尾行（repeatFooter 时）
+  // - 仅末页：总计 + 大写金额 + 静态尾行（repeatFooter 关时）
+  const pageFooterH = model.footerRows
+    .filter((f) => f.footerKind === 'pageSubtotal' || (f.footerKind === 'static' && repeatFooter))
+    .reduce((s, r) => s + r.height, 0)
+  const lastFooterH = model.footerRows
+    .filter(
+      (f) =>
+        f.footerKind === 'grandTotal' ||
+        f.footerKind === 'capital' ||
+        (f.footerKind === 'static' && !repeatFooter),
+    )
+    .reduce((s, r) => s + r.height, 0)
+
+  // 固定每页行数（pageRows 为数字时强制分页）
+  const forcedRows =
+    typeof opts.pageRows === 'number' && opts.pageRows > 0 ? Math.floor(opts.pageRows) : null
+
+  let budget = req.avail - headerH - pageFooterH
+
+  // 把尾行模板按当前切片重算（本页合计用本页数据行；总计/大写用全表数据行，仅末页）
+  function resolveTailRow(fr: RenderRow, rows: Array<Record<string, unknown>>): RenderRow {
+    const cells: RenderCell[] = fr.cells.map((cell) => {
+      if (!cell.isAgg || !cell.aggField || !cell.tokenKind) return cell
+      const text =
+        cell.tokenKind === 'totalCap' || cell.tokenKind === 'pageCap'
+          ? toChineseCapitalRMB(aggValueForRows('totalSum', rows, cell.aggField))
+          : formatAggNumber(aggValueForRows(cell.tokenKind, rows, cell.aggField))
+      return { ...cell, text }
+    })
+    return { ...fr, cells }
+  }
+
+  function resolveFooterRows(
+    pickedDataRows: Array<Record<string, unknown>>,
+    last: boolean,
+  ): RenderRow[] {
+    const out: RenderRow[] = []
+    for (const fr of model.footerRows) {
+      const fk = fr.footerKind
+      if (fk === 'pageSubtotal') {
+        out.push(resolveTailRow(fr, pickedDataRows))
+      } else if (fk === 'grandTotal' || fk === 'capital') {
+        if (last) out.push(resolveTailRow(fr, model.dataRows))
+      } else if (repeatFooter || last) {
+        out.push(fr)
+      }
+    }
+    return out
+  }
+
+  const picked: RenderRow[] = []
+  let used = 0
+  let i = req.start
+
+  while (i < model.rows.length) {
+    const row = model.rows[i]!
+    if (forcedRows !== null && picked.length >= forcedRows) break
+
+    if (used + row.height > budget) {
+      // 一行都放不下：强制放一行，避免无限循环（并告警）
+      if (picked.length === 0) {
+        if (row.height > req.avail) {
+          warnings.push({
+            code: 'ROW_TOO_TALL',
+            message: `第 ${(row.dataIndex ?? i) + 1} 行高度 ${row.height.toFixed(1)}mm 超过整页可用高度，已强制放置`,
+            controlId: model.control.id,
+          })
+        }
+        picked.push(row)
+        used += row.height
+        i++
+      }
+      break
+    }
+
+    picked.push(row)
+    used += row.height
+    i++
+  }
+
+  let isLast = i >= model.rows.length
+  let footerRows: RenderRow[] = []
+
+  // 仅当本片确有数据行时才挂表尾；否则空尾片（上一页已放完全部行）会渲染出多余的合计
+  if (model.footerRows.length > 0 && picked.length > 0) {
+    // 本片涉及的数据行（映射回原始数据，供本页合计重算）
+    const pickedDataRows = picked
+      .filter((r) => r.kind === 'data' && r.dataIndex !== undefined)
+      .map((r) => model.dataRows[r.dataIndex!]!)
+      .filter(Boolean)
+
+    if (isLast) {
+      // 末页需额外容纳总计 / 大写金额行：放不下则把数据行让给下一页
+      while (picked.length > 0 && headerH + used + pageFooterH + lastFooterH > req.avail) {
+        const removed = picked.pop()!
+        used -= removed.height
+        i--
+      }
+      if (headerH + used + pageFooterH + lastFooterH <= req.avail || picked.length === 0) {
+        footerRows = resolveFooterRows(pickedDataRows, true)
+      } else {
+        isLast = false
+        footerRows = resolveFooterRows(pickedDataRows, false)
+      }
+    } else {
+      footerRows = resolveFooterRows(pickedDataRows, false)
+    }
+  }
+
+  isLast = isLast && i >= model.rows.length
+
+  return {
+    headerRows,
+    rows: picked,
+    footerRows,
+    nextStart: i,
+    height: headerH + used + sumRowHeights(footerRows),
+    isLast,
+    warnings,
+  }
+}
+
+/** 表格全部内容一次性排开的总高度（用于判断是否需要分页） */
+export function totalTableHeight(model: TableModel): number {
+  return sumRowHeights(model.headerRows) + sumRowHeights(model.rows) + sumRowHeights(model.footerRows)
+}
+
+export type { HAlign }
diff --git a/openprint/src/core/layout-engine/types.ts b/openprint/src/core/layout-engine/types.ts
new file mode 100644
index 0000000..c8f1b13
--- /dev/null
+++ b/openprint/src/core/layout-engine/types.ts
@@ -0,0 +1,192 @@
+/**
+ * Layout Engine 内部页面模型 —— 《OpenPrint-设计方案.md》§7.3 的类型化扩展
+ *
+ * 设计要点：
+ * 1. 引擎内部一律用 **mm** 参与排版（协议层 in/pt 在入口换算，见 core/units.ts）。
+ * 2. 输出是「已定位、已绑定、已测量」的纯数据，不含任何 DOM / Fabric 依赖，
+ *    因此 renderer-html 可被替换为 renderer-svg / renderer-pdf 而无需改引擎。
+ * 3. 坐标系：PlacedNode.left/top 相对**所属 section 左上角**（与协议一致）。
+ */
+import type { AnyControl, HAlign, TableColumn, TableControl } from '@/types/control'
+import type { PageSetup } from '@/types/template'
+
+/* -------------------------------- 几何 -------------------------------- */
+
+/** 矩形盒（mm） */
+export interface Box {
+  left: number
+  top: number
+  width: number
+  height: number
+}
+
+/* ------------------------------ 渲染就绪内容 ------------------------------ */
+
+/**
+ * 控件绑定数据后的「渲染就绪内容」。
+ * 到这一步所有异步资源（二维码/条码 SVG）已解析完成，渲染器只做字符串拼装。
+ */
+export type ResolvedContent =
+  | { kind: 'text'; text: string }
+  /** 富文本：已经过 DOMPurify 消毒的 HTML */
+  | { kind: 'html'; html: string }
+  | { kind: 'image'; src: string }
+  /** 条码 / 二维码矢量输出（打印必须矢量，位图会糊） */
+  | { kind: 'svg'; svg: string }
+  /** 纯形状（矩形 / 线条），样式由 control 决定 */
+  | { kind: 'shape' }
+  /** 解析失败的占位（渲染为虚线框 + 提示文字，不静默吞掉） */
+  | { kind: 'placeholder'; label: string }
+
+/* ------------------------------- 已定位节点 ------------------------------- */
+
+export interface PlacedControl extends Box {
+  kind: 'control'
+  id: string
+  angle?: number
+  content: ResolvedContent
+  /** 原始控件，渲染器据此取样式（fill/stroke/fontSize…） */
+  control: AnyControl
+}
+
+/**
+ * 表格行类型：决定样式（加粗/底色）与分页时能否被切开。
+ * `static` = 设计期填写的静态行（布局网格正文行、数据表静态尾行如备注/签字栏）。
+ */
+export type RenderRowKind = 'header' | 'data' | 'group' | 'subtotal' | 'summary' | 'static'
+
+export interface RenderCell {
+  text: string
+  align: HAlign
+  /** 跨列（组头行 / 合计行用） */
+  colSpan?: number
+  /** 跨行（表头 / 静态 / 布局网格单元格合并用） */
+  rowSpan?: number
+  background?: string
+  bold?: boolean
+  /** 字号（pt） */
+  fontSize?: number
+  fontFamily?: string
+  italic?: boolean
+  underline?: boolean
+  color?: string
+  valign?: 'top' | 'middle' | 'bottom'
+  /** 单元格斜线（课表角标等）：none / down(左上→右下) / up(左下→右上) */
+  diagonal?: 'none' | 'down' | 'up'
+  /** 尾行聚合：该单元格是否为聚合 token（{{#totalSum}} 等） */
+  isAgg?: boolean
+  /** 聚合 token 类型（isAgg 为真时有效） */
+  tokenKind?: import('./aggregate').AggKind
+  /** 聚合对应的数据字段键（已去 items[]. 前缀）；isAgg 为真时有效 */
+  aggField?: string
+}
+
+export interface RenderRow {
+  kind: RenderRowKind
+  /** 行高（mm），已由 TableEngine 测量 */
+  height: number
+  cells: RenderCell[]
+  /** 数据行在原数组中的下标（供 striped 斑马纹判定） */
+  dataIndex?: number
+  /** 表尾块内语义：本页合计 / 总计 / 大写金额 / 静态尾行（仅 footerRows 有意义） */
+  footerKind?: 'pageSubtotal' | 'grandTotal' | 'capital' | 'static'
+}
+
+/** 表格在某一页上的切片 */
+export interface PlacedTable extends Box {
+  kind: 'table'
+  id: string
+  control: TableControl
+  columns: TableColumn[]
+  /** 归一化后的各列实际宽度（mm，合计 === 表格宽度），渲染器直接用，不再二次推算 */
+  columnWidths: number[]
+  /** 本页表头（可多行；repeatHeader=false 时仅首片有值） */
+  headerRows: RenderRow[]
+  /** 本页数据行切片 */
+  rows: RenderRow[]
+  /** 本页表尾块：合计行 + 静态尾行（repeatFooter=false 时仅末片有值） */
+  footerRows: RenderRow[]
+  /** 是否为该表格的最后一片（渲染器可据此决定收口边框） */
+  isLastSlice: boolean
+}
+
+export type PlacedNode = PlacedControl | PlacedTable
+
+/* --------------------------------- 页 --------------------------------- */
+
+export interface LayoutPage {
+  /** 0-based 索引 */
+  index: number
+  /** 1-based 页码（页码变量 {{page}} 的值） */
+  pageNo: number
+  header: PlacedControl[]
+  body: PlacedNode[]
+  footer: PlacedControl[]
+}
+
+/* -------------------------------- 页面度量 ------------------------------- */
+
+/**
+ * 一页的实际可用区域（全部 mm，width/height 为物理尺寸，横向时宽>高）。
+ * 这是分页算法的唯一尺寸真理源。
+ */
+export interface PageMetrics {
+  /** 纸张实际宽高（物理尺寸，不随 orientation 再交换） */
+  pageWidth: number
+  pageHeight: number
+  margin: { top: number; right: number; bottom: number; left: number }
+  /** 页边距内的内容区宽度 */
+  contentWidth: number
+  /** 页边距内的内容区高度（含页眉页脚） */
+  contentHeight: number
+  headerHeight: number
+  footerHeight: number
+  /** 正文可用高度 = contentHeight - headerHeight - footerHeight */
+  bodyHeight: number
+}
+
+/* -------------------------------- 警告 -------------------------------- */
+
+export type WarningCode =
+  | 'BINDING_MISSING' // 绑定路径在数据中不存在
+  | 'EXPRESSION_ERROR' // 表达式求值失败
+  | 'DATASOURCE_NOT_ARRAY' // 表格 dataSource 不是数组
+  | 'DATASOURCE_EMPTY' // 表格数据为空
+  | 'CONTENT_OVERFLOW' // 内容超出可用高度被截断
+  | 'IMAGE_UNRESOLVED' // 图片无法解析
+  | 'BARCODE_FAILED' // 条码/二维码生成失败
+  | 'CHART_FAILED' // 图表 SVG 生成失败
+  | 'PAGE_LIMIT_REACHED' // 触发最大页数保护
+  | 'ROW_TOO_TALL' // 单行高于整页可用高度
+
+export interface RenderWarning {
+  code: WarningCode
+  message: string
+  controlId?: string
+}
+
+/* ------------------------------- 引擎产物 ------------------------------- */
+
+export interface LayoutResult {
+  pages: LayoutPage[]
+  metrics: PageMetrics
+  page: PageSetup
+  warnings: RenderWarning[]
+}
+
+/** 求值上下文：数据根 + 行上下文 + 页码变量 */
+export interface EvalContext {
+  /** 业务数据根对象 */
+  data: Record<string, unknown>
+  /** 当前行（表格单元格求值时注入） */
+  row?: Record<string, unknown>
+  /** 当前行下标（0-based） */
+  rowIndex?: number
+  /** 当前页码（1-based） */
+  page?: number
+  /** 总页数 */
+  pages?: number
+}
+
+/** 分页保护上限：防止死循环 / 恶意数据把浏览器打爆 */
+export const MAX_PAGES = 500
diff --git a/openprint/src/core/print-client/client.ts b/openprint/src/core/print-client/client.ts
new file mode 100644
index 0000000..4091f3c
--- /dev/null
+++ b/openprint/src/core/print-client/client.ts
@@ -0,0 +1,210 @@
+/**
+ * 本地打印机客户端 HTTP 客户端 —— 纯 TypeScript，零框架依赖
+ *
+ * 所有方法都显式接收 baseUrl（由 `@/config/printer` 解析），
+ * 便于 headless / 单测直接注入，不隐式读全局配置。
+ */
+import {
+  PrintClientError,
+  type PrinterHealth,
+  type PrinterInfo,
+  type PrinterListResponse,
+  type PrintJobRequest,
+  type PrintJobResponse,
+} from './types'
+
+/** 出厂默认地址（用户未配置时使用） */
+export const DEFAULT_PRINTER_BASE_URL = 'http://127.0.0.1:18888'
+
+/** 探测类请求默认超时（ms）—— 本机服务，短超时快速失败 */
+export const PROBE_TIMEOUT_MS = 3000
+
+/** 提交打印任务默认超时（ms）—— 大文档 base64 传输留足时间 */
+export const SUBMIT_TIMEOUT_MS = 30000
+
+/** 去掉尾部斜杠，拼接路径 */
+function joinUrl(base: string, path: string): string {
+  return `${base.replace(/\/+$/, '')}${path}`
+}
+
+/**
+ * 带超时 + 错误分类的 fetch。
+ * 用手工 AbortController 而非 AbortSignal.timeout，才能区分「超时」与「连不上」。
+ */
+async function request<T>(
+  url: string,
+  init: RequestInit,
+  timeoutMs: number,
+): Promise<T> {
+  const ctrl = new AbortController()
+  let timedOut = false
+  const timer = setTimeout(() => {
+    timedOut = true
+    ctrl.abort()
+  }, timeoutMs)
+
+  let res: Response
+  try {
+    res = await fetch(url, { ...init, signal: ctrl.signal })
+  } catch {
+    if (timedOut) {
+      throw new PrintClientError('timeout', `请求超时（${timeoutMs}ms）：${url}`)
+    }
+    throw new PrintClientError('network', `无法连接打印客户端：${url}`)
+  } finally {
+    clearTimeout(timer)
+  }
+
+  if (!res.ok) {
+    throw new PrintClientError('http', `HTTP ${res.status} ${res.statusText}`, res.status)
+  }
+
+  let json: unknown
+  try {
+    json = await res.json()
+  } catch {
+    throw new PrintClientError('parse', '响应不是合法 JSON')
+  }
+  if (json === null || typeof json !== 'object') {
+    throw new PrintClientError('parse', '响应结构异常')
+  }
+  return json as T
+}
+
+/* ------------------------------ GET /health ------------------------------ */
+
+/**
+ * 健康检查。成功返回服务版本、打印机数量、运行时长。
+ * @throws PrintClientError 连接失败 / 超时 / ok:false
+ */
+export async function checkHealth(
+  baseUrl: string = DEFAULT_PRINTER_BASE_URL,
+  timeoutMs: number = PROBE_TIMEOUT_MS,
+): Promise<PrinterHealth> {
+  const data = await request<Partial<PrinterHealth>>(
+    joinUrl(baseUrl, '/health'),
+    { method: 'GET', headers: { Accept: 'application/json' } },
+    timeoutMs,
+  )
+  if (data.ok !== true) {
+    throw new PrintClientError('service', '打印客户端报告服务异常（ok=false）')
+  }
+  return {
+    app: data.app ?? 'Unknown',
+    ok: true,
+    printers: typeof data.printers === 'number' ? data.printers : 0,
+    time: data.time ?? '',
+    uptimeSec: typeof data.uptimeSec === 'number' ? data.uptimeSec : 0,
+    version: data.version ?? '',
+  }
+}
+
+/* ------------------------------ GET /printers ------------------------------ */
+
+/** 单台打印机字段归一化（服务端字段缺失时给安全默认，避免 UI 崩） */
+function normalizePrinter(raw: Partial<PrinterInfo>, index: number): PrinterInfo {
+  return {
+    driver: raw.driver ?? '',
+    isDefault: raw.isDefault === true,
+    isOnline: raw.isOnline !== false,
+    kind: raw.kind === 'virtual' || raw.kind === 'ticket' ? raw.kind : 'common',
+    maxDpi: typeof raw.maxDpi === 'number' ? raw.maxDpi : 0,
+    name: raw.name ?? `未命名打印机 ${index + 1}`,
+    status: raw.status === 'error' ? 'error' : 'idle',
+    supportsColor: raw.supportsColor === true,
+    supportsDuplex: raw.supportsDuplex === true,
+    trays: Array.isArray(raw.trays) ? raw.trays.filter((t): t is string => typeof t === 'string') : [],
+  }
+}
+
+/**
+ * 获取打印机列表。
+ * 注意：**以 `printers` 数组长度为准**，服务端的 `count` 字段仅供参考（实测可能不一致）。
+ */
+export async function listPrinters(
+  baseUrl: string = DEFAULT_PRINTER_BASE_URL,
+  timeoutMs: number = PROBE_TIMEOUT_MS,
+): Promise<PrinterInfo[]> {
+  const data = await request<Partial<PrinterListResponse>>(
+    joinUrl(baseUrl, '/printers'),
+    { method: 'GET', headers: { Accept: 'application/json' } },
+    timeoutMs,
+  )
+  if (data.ok === false) {
+    throw new PrintClientError('service', '打印客户端未能枚举打印机')
+  }
+  if (!Array.isArray(data.printers)) {
+    throw new PrintClientError('parse', '响应缺少 printers 数组')
+  }
+  return data.printers.map((p, i) => normalizePrinter(p ?? {}, i))
+}
+
+/* ------------------------------ 任务号生成 ------------------------------ */
+
+/**
+ * 生成打印任务号（Web 端生成，随请求下发给本地客户端）。
+ * 格式：`MMDD`（今日月日，如 0813）+ 6 位随机数字，共 10 位。
+ * 例：`0813` + `482913` → `0813482913`。
+ * @param now 可选，默认当前时间（便于单测注入）
+ */
+export function generateJobId(now: Date = new Date()): string {
+  const mm = String(now.getMonth() + 1).padStart(2, '0')
+  const dd = String(now.getDate()).padStart(2, '0')
+  const rand = String(Math.floor(Math.random() * 1_000_000)).padStart(6, '0')
+  return `${mm}${dd}${rand}`
+}
+
+/* ------------------------------ POST /print ------------------------------ */
+
+/**
+ * 提交打印任务。
+ * 载荷约定（见《打印机数据交互文档》）：
+ * - **统一** `format:'pdf'`，`encoding:'base64'`，content 为 PDF base64（无 data: 前缀）。
+ *   PDF 内部位图底图默认 PNG（无损·最高清），文字/线条边缘真正锐利，打印推荐。
+ *   本地客户端用 `QPrinter` 打印位图 PDF。
+ * - `'svg'` 已废弃（Qt QSvgRenderer 不支持 foreignObject/HTML/CSS），类型保留仅作向后兼容。
+ * - `job.jobId` 由 Web 端生成（generateJobId）；服务端若回传自己的 jobId 则以服务端为准。
+ */
+export async function submitPrintJob(
+  job: PrintJobRequest,
+  baseUrl: string = DEFAULT_PRINTER_BASE_URL,
+  timeoutMs: number = SUBMIT_TIMEOUT_MS,
+): Promise<PrintJobResponse> {
+  const data = await request<Partial<PrintJobResponse>>(
+    joinUrl(baseUrl, '/print'),
+    {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json', Accept: 'application/json' },
+      body: JSON.stringify(job),
+    },
+    timeoutMs,
+  )
+  if (data.ok !== true) {
+    throw new PrintClientError('service', data.message || '打印客户端拒绝了本次任务')
+  }
+  return { ok: true, jobId: data.jobId ?? job.jobId, message: data.message }
+}
+
+/* ------------------------------ 工具 ------------------------------ */
+
+/**
+ * Blob → base64（不含 `data:*;base64,` 前缀）。
+ * 用于把 PDF 二进制转成可 JSON 传输的字符串。
+ */
+export function blobToBase64(blob: Blob): Promise<string> {
+  return new Promise((resolve, reject) => {
+    const reader = new FileReader()
+    reader.onerror = () => reject(new Error('读取导出文件失败'))
+    reader.onload = () => {
+      const result = String(reader.result ?? '')
+      const comma = result.indexOf(',')
+      resolve(comma >= 0 ? result.slice(comma + 1) : result)
+    }
+    reader.readAsDataURL(blob)
+  })
+}
+
+/** Blob → utf8 文本（用于 SVG 载荷） */
+export function blobToText(blob: Blob): Promise<string> {
+  return blob.text()
+}
diff --git a/openprint/src/core/print-client/index.ts b/openprint/src/core/print-client/index.ts
new file mode 100644
index 0000000..6badd01
--- /dev/null
+++ b/openprint/src/core/print-client/index.ts
@@ -0,0 +1,42 @@
+/**
+ * 本地打印机客户端服务层入口
+ *
+ * 用法：
+ * ```ts
+ * import { checkHealth, listPrinters, submitPrintJob } from '@/core/print-client'
+ * import { resolvePrinterBaseUrl } from '@/config/printer'
+ *
+ * const base = resolvePrinterBaseUrl()
+ * const health = await checkHealth(base)
+ * const printers = await listPrinters(base)
+ * ```
+ */
+export {
+  DEFAULT_PRINTER_BASE_URL,
+  PROBE_TIMEOUT_MS,
+  SUBMIT_TIMEOUT_MS,
+  checkHealth,
+  listPrinters,
+  submitPrintJob,
+  generateJobId,
+  blobToBase64,
+  blobToText,
+} from './client'
+
+export { PrintClientError, describePrintError } from './types'
+
+export { buildPrintPayload, formatPayloadSize } from './payload'
+export type { PrintPayload, BuildPrintPayloadOptions } from './payload'
+
+export type {
+  PrinterHealth,
+  PrinterInfo,
+  PrinterKind,
+  PrinterState,
+  PrinterListResponse,
+  PrintPayloadFormat,
+  PrintPayloadEncoding,
+  PrintJobRequest,
+  PrintJobResponse,
+  PrintClientErrorCode,
+} from './types'
diff --git a/openprint/src/core/print-client/payload.ts b/openprint/src/core/print-client/payload.ts
new file mode 100644
index 0000000..2591d9e
--- /dev/null
+++ b/openprint/src/core/print-client/payload.ts
@@ -0,0 +1,79 @@
+/**
+ * 打印载荷构建 —— 模板 + 数据 → 推送给本地打印客户端的文档内容
+ *
+ * 推送格式规则（2026-08-13 最终定案）：
+ * - **统一推 PDF（base64）**，不论单页或多页。
+ *
+ * 演进历程：
+ * - 早期单页走 SVG 原文 → Qt `QSvgRenderer` 不解析 foreignObject/HTML/CSS，打不出内容（已废弃）。
+ * - 中间试过单页走 JPG → 但 JPG 是单张位图、没有页面尺寸/DPI 元数据，不如 PDF 适合打印；
+ *   且用户希望打印格式统一便于客户端处理。最终回到统一 PDF。
+ *
+ * 清晰度优先：PDF 内部位图底图默认 **PNG（无损·最高清）**，文字/线条边缘真正锐利，
+ * 打印推荐。体积较大（纯文字页 ~10+ MB）；体积敏感场景可传 `imageType: 'jpeg'`。
+ */
+import type { RenderRequest } from '@/core/sdk'
+import { renderDocument } from '@/core/sdk'
+import { documentToPdf } from '@/core/export-engine'
+import { blobToBase64 } from './client'
+
+export interface PrintPayload {
+  /** 载荷格式：恒为 pdf */
+  format: 'pdf'
+  /** 载荷编码：恒为 base64 */
+  encoding: 'base64'
+  /** PDF 的 base64 字符串（不含 data: 前缀） */
+  content: string
+  /** 总页数 */
+  pages: number
+  /** 载荷字符长度（UI 展示体积用） */
+  bytes: number
+}
+
+export interface BuildPrintPayloadOptions {
+  /** 位图倍率，默认 3（288dpi·最高清）；要更锐可传 4 */
+  scale?: number
+  /**
+   * 多页 PDF 的位图底图压缩格式（默认 `'png'`，无损最清晰）：
+   * - `'png'`：无损，文字/线条边缘锐利，打印推荐；
+   * - `'jpeg'`：体积小，仅体积敏感场景。
+   */
+  imageType?: 'jpeg' | 'png'
+}
+
+/**
+ * 构建推送载荷（统一 PDF-base64）。
+ *
+ * 不论单页或多页，都先 `renderDocument()` → `documentToPdf()`（浏览器内用 Chromium
+ * 栅格化 foreignObject 内容成位图底图，默认 PNG 无损最高清）→ `blobToBase64()`。
+ * 本地客户端拿到的就是可直接 `QPrinter` 打印的 PDF 字节流。
+ */
+export async function buildPrintPayload(
+  request: RenderRequest,
+  options: BuildPrintPayloadOptions = {},
+): Promise<PrintPayload> {
+  const result = await renderDocument(request)
+  const pages = result.pages.length
+  const deco = request.output?.pageDecoration
+
+  const blob = await documentToPdf(result, {
+    scale: options.scale ?? 3,
+    imageType: options.imageType ?? 'png',
+    pageDecoration: deco,
+  })
+  const base64 = await blobToBase64(blob)
+  return {
+    format: 'pdf',
+    encoding: 'base64',
+    content: base64,
+    pages: Math.max(pages, 1),
+    bytes: base64.length,
+  }
+}
+
+/** 人类可读体积（UI 提示用） */
+export function formatPayloadSize(bytes: number): string {
+  if (bytes < 1024) return `${bytes} B`
+  if (bytes < 1024 * 1024) return `${(bytes / 1024).toFixed(1)} KB`
+  return `${(bytes / 1024 / 1024).toFixed(2)} MB`
+}
diff --git a/openprint/src/core/print-client/print-client.spec.ts b/openprint/src/core/print-client/print-client.spec.ts
new file mode 100644
index 0000000..ea897ca
--- /dev/null
+++ b/openprint/src/core/print-client/print-client.spec.ts
@@ -0,0 +1,25 @@
+import { describe, it, expect } from 'vitest'
+import { generateJobId } from './client'
+
+describe('generateJobId', () => {
+  it('格式为 MMDD + 6 位随机，共 10 位数字', () => {
+    const id = generateJobId(new Date('2026-08-13T10:00:00'))
+    expect(id).toHaveLength(10)
+    expect(id).toMatch(/^\d{10}$/)
+    // 今日 08-13 → 前缀 0813
+    expect(id.startsWith('0813')).toBe(true)
+  })
+
+  it('随机尾段为 6 位（不足前补 0）', () => {
+    const id = generateJobId(new Date('2026-01-05T00:00:00'))
+    expect(id.startsWith('0105')).toBe(true)
+    expect(id.slice(4)).toMatch(/^\d{6}$/)
+  })
+
+  it('多次调用尾段大概率不同', () => {
+    const seen = new Set<string>()
+    for (let i = 0; i < 50; i++) seen.add(generateJobId().slice(4))
+    // 50 次抽样几乎必然出现碰撞以外的情况；极端碰撞属概率事件，放宽到 >=49 唯一
+    expect(seen.size).toBeGreaterThanOrEqual(49)
+  })
+})
diff --git a/openprint/src/core/print-client/types.ts b/openprint/src/core/print-client/types.ts
new file mode 100644
index 0000000..345e655
--- /dev/null
+++ b/openprint/src/core/print-client/types.ts
@@ -0,0 +1,160 @@
+/**
+ * 本地打印机客户端服务 —— 协议类型
+ *
+ * 对接本机常驻的打印客户端（默认 http://127.0.0.1:18888），提供：
+ *   GET  /health   服务健康与版本
+ *   GET  /printers 打印机列表
+ *   POST /print    提交打印任务（单页 SVG / 多页 PDF-base64）
+ *
+ * 主任铁律：无后端全链路可用 —— 客户端不可达时设计器一切功能照常，只是不能推送打印。
+ */
+
+/* ------------------------------ /health ------------------------------ */
+
+/** GET /health 响应体 */
+export interface PrinterHealth {
+  /** 客户端应用名，如 "OpenPrint" */
+  app: string
+  /** 服务是否正常 */
+  ok: boolean
+  /** 当前可用打印机数量 */
+  printers: number
+  /** 服务端时间（ISO 字符串） */
+  time: string
+  /** 已运行秒数 */
+  uptimeSec: number
+  /** 客户端版本号 */
+  version: string
+}
+
+/* ------------------------------ /printers ------------------------------ */
+
+/** 打印机类型：虚拟打印机 / 普通打印机 / 票据打印机 */
+export type PrinterKind = 'virtual' | 'common' | 'ticket'
+
+/** 打印机运行状态 */
+export type PrinterState = 'idle' | 'error'
+
+/** 单台打印机描述 */
+export interface PrinterInfo {
+  /** 驱动名 */
+  driver: string
+  /** 是否系统默认打印机 */
+  isDefault: boolean
+  /** 是否在线 */
+  isOnline: boolean
+  /** 打印机类型 */
+  kind: PrinterKind
+  /** 最大分辨率（DPI） */
+  maxDpi: number
+  /** 打印机名（提交任务时的唯一标识） */
+  name: string
+  /** 运行状态 */
+  status: PrinterState
+  /** 是否支持彩色 */
+  supportsColor: boolean
+  /** 是否支持双面 */
+  supportsDuplex: boolean
+  /** 纸盒列表 */
+  trays: string[]
+}
+
+/** GET /printers 响应体 */
+export interface PrinterListResponse {
+  /** 服务端声明的数量（可能与 printers.length 不一致，以数组为准） */
+  count: number
+  ok: boolean
+  printers: PrinterInfo[]
+}
+
+/* ------------------------------ /print ------------------------------ */
+
+/**
+ * 推送载荷格式。
+ * **2026-08-13 最终定案**：统一推 `'pdf'`（base64）。
+ * - 单页/多页都走浏览器栅格化的位图 PDF，本地客户端 `QPrinter` 打印无兼容性问题。
+ * - `'svg'` 保留在枚举里仅供向后兼容（已废弃：Qt QSvgRenderer 不解析 foreignObject/HTML）。
+ */
+export type PrintPayloadFormat = 'svg' | 'pdf'
+
+/** 载荷编码：jpg/pdf 用 base64；utf8 仅供向后兼容（对应已废弃的 SVG 原文路径） */
+export type PrintPayloadEncoding = 'utf8' | 'base64'
+
+/** POST /print 请求体 */
+export interface PrintJobRequest {
+  /** 任务号：由 Web 端生成（MMDD + 6 位随机，共 10 位）；服务端若回传则以其为准，否则沿用此值 */
+  jobId?: string
+  /** 任务名（用于打印队列显示） */
+  taskName: string
+  /** 目标打印机名（取自 /printers 的 name；留空由客户端用系统默认） */
+  printer: string
+  /** 载荷格式 */
+  format: PrintPayloadFormat
+  /** 载荷编码 */
+  encoding: PrintPayloadEncoding
+  /** 文档内容：pdf=PDF base64（不含 data: 前缀）；svg=XML 原文（已废弃） */
+  content: string
+  /** 文档总页数 */
+  pages: number
+  /** 打印份数 */
+  copies: number
+  /** 纸张方向 */
+  orientation: 'portrait' | 'landscape'
+  /** 是否双面 */
+  duplex: boolean
+  /** 是否彩色（false = 黑白） */
+  color: boolean
+}
+
+/** POST /print 响应体 */
+export interface PrintJobResponse {
+  ok: boolean
+  /** 客户端队列任务 ID */
+  jobId?: string
+  /** 服务端消息（失败原因等） */
+  message?: string
+}
+
+/* ------------------------------ 错误 ------------------------------ */
+
+/**
+ * 错误分类：
+ * - `timeout`  请求超时（客户端未响应）
+ * - `network`  连接失败（服务未启动 / 端口不通 / CORS 拦截）
+ * - `http`     HTTP 非 2xx
+ * - `parse`    响应不是合法 JSON 或字段缺失
+ * - `service`  服务端返回 ok:false
+ */
+export type PrintClientErrorCode = 'timeout' | 'network' | 'http' | 'parse' | 'service'
+
+/** 打印客户端统一错误 */
+export class PrintClientError extends Error {
+  readonly code: PrintClientErrorCode
+  readonly status?: number
+
+  constructor(code: PrintClientErrorCode, message: string, status?: number) {
+    super(message)
+    this.name = 'PrintClientError'
+    this.code = code
+    this.status = status
+  }
+}
+
+/** 把任意异常转成人话（用于 UI 提示） */
+export function describePrintError(err: unknown): string {
+  if (err instanceof PrintClientError) {
+    switch (err.code) {
+      case 'timeout':
+        return '打印客户端响应超时，请确认服务未卡死'
+      case 'network':
+        return '无法连接打印客户端，请确认本机打印服务已启动'
+      case 'http':
+        return `打印客户端返回错误（HTTP ${err.status ?? '?'}）`
+      case 'parse':
+        return '打印客户端返回数据格式异常'
+      case 'service':
+        return err.message || '打印客户端拒绝了本次请求'
+    }
+  }
+  return err instanceof Error ? err.message : String(err)
+}
diff --git a/openprint/src/core/renderer-html/css-generator.spec.ts b/openprint/src/core/renderer-html/css-generator.spec.ts
new file mode 100644
index 0000000..4483e0d
--- /dev/null
+++ b/openprint/src/core/renderer-html/css-generator.spec.ts
@@ -0,0 +1,53 @@
+import { describe, expect, it } from 'vitest'
+
+import { generateCss, mmv } from '@/core/renderer-html/css-generator'
+import { renderDocument } from '@/core/sdk'
+import { createDemoTemplate } from '@/repository/mock/data/demo-template'
+import { createCjkMeasurer } from '@/core/__tests__/cjk-measurer'
+
+function makeData(rows: number): Record<string, unknown> {
+  const items = Array.from({ length: rows }, (_, i) => ({
+    productCode: `P${i + 1}`,
+    productName: `商品${i + 1}`,
+    qty: (i % 5) + 1,
+    price: 10,
+    amount: ((i % 5) + 1) * 10,
+  }))
+  return { order: { orderNo: 'SO-001' }, items }
+}
+
+describe('generateCss —— 动态样式生成', () => {
+  const measurer = createCjkMeasurer()
+
+  async function css(opts: Parameters<typeof generateCss>[1]) {
+    const result = await renderDocument({ template: createDemoTemplate(), data: makeData(10), layout: { measurer } })
+    return generateCss(result.metrics, opts)
+  }
+
+  it('默认输出含 @page 与页面尺寸', async () => {
+    const out = await css({})
+    expect(out).toContain('@page')
+    expect(out).toContain('mm')
+  })
+
+  it('screen 模式注入 --op-scale 缩放变量', async () => {
+    const out = await css({ screen: true, scale: 2 })
+    expect(out).toContain('--op-scale: 2')
+  })
+
+  it('screen:false 时 --op-scale 强制为 1（导出/打印不缩放）', async () => {
+    const out = await css({ screen: false })
+    expect(out).toContain('--op-scale: 1')
+    expect(out).not.toContain('--op-scale: 2')
+  })
+
+  it('extraCss 追加到样式表', async () => {
+    const out = await css({ extraCss: '.x{color:red}' })
+    expect(out).toContain('.x{color:red}')
+  })
+
+  it('mmv 格式化毫米值', () => {
+    expect(mmv(10)).toBe('10mm')
+    expect(mmv(0)).toBe('0mm')
+  })
+})
diff --git a/openprint/src/core/renderer-html/css-generator.ts b/openprint/src/core/renderer-html/css-generator.ts
new file mode 100644
index 0000000..3e336eb
--- /dev/null
+++ b/openprint/src/core/renderer-html/css-generator.ts
@@ -0,0 +1,372 @@
+/**
+ * CSS 生成器 —— 《OpenPrint-设计方案.md》§5.11（打印样式）/ §7.3（渲染产物）
+ *
+ * ## 为什么 CSS 要按模板动态生成
+ *
+ * `@page { size: … }` 的纸张尺寸不能用 CSS 变量（浏览器在解析 `@page` 时不做变量替换），
+ * 必须把 mm 字面量写死进去。所以每个模板都要生成一份专属样式表。
+ *
+ * ## 与测量器的强耦合约定（改这里必须同步改 measure.ts）
+ *
+ * 分页高度是 DomMeasurer 用 `font-size / font-family / line-height / white-space` 量出来的。
+ * 渲染时若用另一套字体或行高，实际高度就会和分页假设对不上，表现为**末行被裁**或**页尾空一大块**。
+ * 因此表格单元格的字体三件套在这里直接复用 measure.ts / table-engine.ts 的导出常量，
+ * 而不是重新写一遍字面量。
+ */
+import { DEFAULT_FONT_FAMILY, DEFAULT_LINE_HEIGHT } from '@/core/layout-engine/measure'
+import {
+  CELL_PADDING_Y,
+  DEFAULT_CELL_PADDING,
+  TABLE_FONT_SIZE,
+} from '@/core/layout-engine/table-engine'
+import type { PageMetrics } from '@/core/layout-engine/types'
+import type { PageDecoration } from '@/types/template'
+
+/** 设计画布文本控件的默认值（PrintText.styleToFabric），渲染端必须一致才能所见即所得 */
+export const TEXT_DEFAULT_FONT_SIZE = 12
+export const TEXT_DEFAULT_FONT_FAMILY = '"Source Han Sans CN", "PingFang SC", sans-serif'
+export const TEXT_DEFAULT_LINE_HEIGHT = 1.16
+export const TEXT_DEFAULT_COLOR = '#000000'
+
+/** 表格视觉（与设计画布 PrintTable 一致） */
+export const TABLE_BORDER_COLOR = '#333333'
+export const TABLE_TEXT_COLOR = '#1f2329'
+export const TABLE_HEADER_BG = '#F5F7FA'
+/** 通用斑马纹底（原 #FAFAFA 太浅，调深为浅蓝，对比更明显） */
+export const TABLE_STRIPE_BG = '#DCE6F4'
+/** 斑马纹·蓝（交替行更深蓝） */
+export const TS_ZEBRA_BLUE_BG = '#C2D4EE'
+/** 斑马纹·灰（中性灰交替） */
+export const TS_ZEBRA_GRAY_BG = '#E4E7EB'
+/** 隔列着色底 */
+export const TS_BANDED_BG = '#EEF2F8'
+/** 绿色表头底 */
+export const TABLE_HEADER_GREEN = '#1F9D57'
+/** 单元格斜线颜色（与表格边框同色） */
+export const TABLE_DIAGONAL_COLOR = '#333333'
+
+/**
+ * 单元格斜线背景（课表角标等）。
+ * 返回可直接拼进 inline style 的「完整声明片段」：
+ * `background-image:url(...); background-repeat:no-repeat; background-size:100% 100%`。
+ * 无斜线返回空串。
+ *
+ * 同时被设计画布（table-design-render）与运行期（html-renderer）复用，保证两端一致。
+ *
+ * 用 SVG <line> data URI 而非 linear-gradient 模拟：SVG 有原生抗锯齿，
+ * 在非整数像素边界不会产生渐变法常见的锯齿毛刺，清晰度大幅提升。
+ *
+ * ⚠️ 关键：background-image 默认 `background-repeat:repeat`，
+ * 会把 100×100 的 SVG 平铺满整个单元格 —— 这正是「显示成好几根线」的根因。
+ * 必须显式 `no-repeat` + `background-size:100% 100%`，让它只画一条、
+ * 且 viewBox 经 preserveAspectRatio=none 精确填满任意宽高比的单元格。
+ *
+ * SVG 内部用双引号；整体经 base64 编码后用单引号包裹 url('...')。
+ * base64 不会产生引号，彻底避免与 HTML attribute 的引号冲突。
+ */
+export function diagonalBackground(
+  dir: 'none' | 'down' | 'up' | undefined | null,
+): string {
+  if (!dir || dir === 'none') return ''
+  const c = TABLE_DIAGONAL_COLOR
+  // down: 左上角(0,0)→右下角(100,100)；up: 左下角(0,100)→右上角(100,0)
+  const y1 = dir === 'up' ? '100' : '0'
+  const y2 = dir === 'up' ? '0' : '100'
+  const svg = `<svg xmlns="http://www.w3.org/2000/svg" width="100" height="100" viewBox="0 0 100 100" preserveAspectRatio="none"><line x1="0" y1="${y1}" x2="100" y2="${y2}" stroke="${c}" stroke-width="1.5"/></svg>`
+  const b64 = typeof btoa === 'function' ? btoa(svg) : Buffer.from(svg, 'utf-8').toString('base64')
+  const url = `url('data:image/svg+xml;base64,${b64}')`
+  // no-repeat + 100% 100%：只画一条、且精确铺满单元格（见函数注释 ⚠️）
+  return `background-image:${url};background-repeat:no-repeat;background-size:100% 100%`
+}
+
+export interface CssOptions {
+  /**
+   * 屏幕预览模式：给页面加投影、页间距、灰底。
+   * 导出 HTML / 无头打印时置 false，避免把预览装饰烤进产物。
+   */
+  screen?: boolean
+  /** 预览缩放比（仅 screen 生效，打印时强制 1） */
+  scale?: number
+  /** 追加的用户自定义 CSS */
+  extraCss?: string
+  /** 页面装饰（背景色 + 水印），来自模板 pageSetup */
+  pageDecoration?: PageDecoration
+}
+
+/** mm 数值格式化：保留 3 位小数并去掉尾随 0，避免 "12.340000000000001mm" 这种噪声 */
+export function mmv(n: number): string {
+  const v = Math.round((Number.isFinite(n) ? n : 0) * 1000) / 1000
+  return `${v}mm`
+}
+
+/**
+ * 表格样式块（运行期打印 与 设计期 HTML overlay 共用的唯一真理源）。
+ *
+ * 方案 A 的关键：设计画布上的表格 overlay 与最终打印产物必须由**同一份 CSS** 驱动，
+ * 否则"所见"与"所印"会随时间漂移。设计期通过 `scope` 前缀把这份规则限制在 overlay 容器内。
+ *
+ * @param scope 作用域选择器前缀（如 `.op-table-overlay `）；留空 = 全局（打印产物）
+ */
+export function tableCss(scope = ''): string {
+  const s = scope ? `${scope} ` : ''
+  return `
+${s}.op-table {
+  /* 用 separate + border-spacing:0 + box-sizing:border-box，让外框落在表格盒"内"侧：
+     collapse 模式下外框横跨边缘，被 overlay 的 overflow:hidden 切掉右/下边，
+     表现为"需拖一下才看得到边框"；separate 方案使四边始终完整可见（设计/打印一致）。 */
+  border-collapse: separate;
+  border-spacing: 0;
+  box-sizing: border-box;
+  table-layout: fixed;
+  /* 字体三件套必须与 DomMeasurer 完全一致，否则分页高度会失真 */
+  font-family: ${DEFAULT_FONT_FAMILY};
+  font-size: ${TABLE_FONT_SIZE}pt;
+  line-height: ${DEFAULT_LINE_HEIGHT};
+  color: ${TABLE_TEXT_COLOR};
+}
+
+${s}.op-table td,
+${s}.op-table th {
+  padding: ${mmv(CELL_PADDING_Y)} ${mmv(DEFAULT_CELL_PADDING)};
+  overflow: hidden;
+  white-space: pre-wrap;
+  word-break: break-word;
+  overflow-wrap: break-word;
+  font-weight: normal;
+  text-align: left;
+  vertical-align: middle;
+}
+
+/* 垂直对齐：vertical-align 不可继承，只能按表加类下发到每个 td */
+${s}.op-table.va-top td { vertical-align: top; }
+${s}.op-table.va-middle td { vertical-align: middle; }
+${s}.op-table.va-bottom td { vertical-align: bottom; }
+
+${s}.op-table tr.is-header td { font-weight: bold; }
+${s}.op-table tr.is-group td { background: ${TABLE_HEADER_BG}; font-weight: bold; }
+${s}.op-table tr.is-subtotal td,
+${s}.op-table tr.is-summary td { font-weight: bold; }
+${s}.op-table tr.is-striped td { background: ${TABLE_STRIPE_BG}; }
+/* 静态行（布局网格正文 / 数据表备注尾行）：默认无强调样式，
+   单元格视觉以内联样式为准（与设计期 overlay 同一套 resolveCellStyleFor 取值） */
+${s}.op-table tr.is-static td { /* 占位：保持类名与设计期对齐，避免样式遗漏 */ }
+
+/* ---------- 表格样式预设（Excel 式快速切换；class 由渲染端挂在 table 元素上） ---------- */
+/* 默认（none）：仅表头加粗，无任何背景色（含标题行）。无需规则，class 仅作占位。 */
+
+/* 表头高亮：表头浅灰底 */
+${s}.op-table.ts-header tr.is-header td { background: ${TABLE_HEADER_BG}; }
+
+/* 斑马纹（单双变色条纹，浅蓝交替，对比更明显） */
+${s}.op-table.ts-zebra tr.is-header td { background: ${TABLE_HEADER_BG}; }
+${s}.op-table.ts-zebra tbody tr:not(.is-header):nth-child(even) td { background: ${TABLE_STRIPE_BG}; }
+
+/* 斑马纹·蓝（交替行更深蓝） */
+${s}.op-table.ts-zebra-blue tr.is-header td { background: ${TABLE_HEADER_BG}; }
+${s}.op-table.ts-zebra-blue tbody tr:not(.is-header):nth-child(even) td { background: ${TS_ZEBRA_BLUE_BG}; }
+
+/* 斑马纹·灰（中性灰交替） */
+${s}.op-table.ts-zebra-gray tr.is-header td { background: ${TABLE_HEADER_BG}; }
+${s}.op-table.ts-zebra-gray tbody tr:not(.is-header):nth-child(even) td { background: ${TS_ZEBRA_GRAY_BG}; }
+
+/* 绿色表头（绿底白字） */
+${s}.op-table.ts-header-green tr.is-header td { background: ${TABLE_HEADER_GREEN}; color: #ffffff; }
+
+/* 隔列着色（奇偶列交替底） */
+${s}.op-table.ts-banded-cols tr > *:nth-child(even) { background: ${TS_BANDED_BG}; }
+
+/* 三段式：表头高亮 + 合计 / 总计行强调底（设计期聚合尾行已对齐 is-subtotal/is-summary 类） */
+${s}.op-table.ts-three-segment tr.is-header td { background: ${TABLE_HEADER_BG}; }
+${s}.op-table.ts-three-segment tr.is-subtotal td,
+${s}.op-table.ts-three-segment tr.is-summary td { background: #EBF2FF; }
+
+/* 深底表头：深蓝底白字 */
+${s}.op-table.ts-header-dark tr.is-header td { background: #2F54EB; color: #ffffff; }
+
+/* 课表：全网格 + 表头淡底高亮（角标斜线由单元格 diagonal 控制） */
+${s}.op-table.ts-timetable tr.is-header td { background: ${TABLE_HEADER_BG}; }
+
+/* 边框模式：每格画上/左边框，末行补下、末列补右 → 外框落在盒内、不被裁切 */
+${s}.op-table.b-all td { border-top: 0.2mm solid var(--op-table-border); border-left: 0.2mm solid var(--op-table-border); }
+${s}.op-table.b-all tr:last-child td { border-bottom: 0.2mm solid var(--op-table-border); }
+${s}.op-table.b-all td:last-child { border-right: 0.2mm solid var(--op-table-border); }
+${s}.op-table.b-horizontal td { border-top: 0.2mm solid var(--op-table-border); }
+${s}.op-table.b-horizontal tr:last-child td { border-bottom: 0.2mm solid var(--op-table-border); }
+${s}.op-table.b-outline { border: 0.2mm solid var(--op-table-border); }
+${s}.op-table.b-none td { border: 0; }
+/* 三线表：顶线 + 表头底线 + 底线，无内部横线、无竖线（建模报告 / 财务报表常用） */
+${s}.op-table.b-three-line { border-top: 0.2mm solid var(--op-table-border); border-bottom: 0.2mm solid var(--op-table-border); }
+${s}.op-table.b-three-line tr.is-header:last-child td { border-bottom: 0.2mm solid var(--op-table-border); }
+`
+}
+
+export function generateCss(metrics: PageMetrics, options: CssOptions = {}): string {
+  const screen = options.screen ?? true
+  const scale = options.scale ?? 1
+  const pageBg = options.pageDecoration?.backgroundColor ?? '#ffffff'
+  const { pageWidth, pageHeight, margin, contentWidth, contentHeight } = metrics
+
+  return `
+/* ============ OpenPrint 渲染样式（自动生成，勿手改） ============ */
+:root {
+  --op-page-w: ${mmv(pageWidth)};
+  --op-page-h: ${mmv(pageHeight)};
+  --op-scale: ${screen ? scale : 1};
+  --op-table-border: ${TABLE_BORDER_COLOR};
+}
+
+* { box-sizing: border-box; }
+
+html, body {
+  margin: 0;
+  padding: 0;
+  background: ${screen ? '#f0f2f5' : '#ffffff'};
+  /* 让底色/斑马纹在打印时不被浏览器"省墨"策略抹掉 */
+  -webkit-print-color-adjust: exact;
+  print-color-adjust: exact;
+}
+
+.op-doc {
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  ${screen ? 'gap: 10mm; padding: 10mm 0;' : ''}
+}
+
+/* 缩放外壳：transform 不占布局空间，靠外壳撑出滚动区域 */
+.op-page-wrap {
+  width: calc(var(--op-page-w) * var(--op-scale));
+  height: calc(var(--op-page-h) * var(--op-scale));
+  flex: none;
+}
+
+.op-page {
+  position: relative;
+  width: var(--op-page-w);
+  height: var(--op-page-h);
+  overflow: hidden;
+  background: ${pageBg};
+  transform: scale(var(--op-scale));
+  transform-origin: top left;
+  ${screen ? 'box-shadow: 0 1px 6px rgba(0, 0, 0, 0.12);' : ''}
+}
+
+/* 水印装饰层：绝对铺满页面、不拦截事件、置于内容之下 */
+.op-watermark {
+  position: absolute;
+  inset: 0;
+  overflow: hidden;
+  pointer-events: none;
+  z-index: 0;
+}
+.op-watermark.op-wm-single {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+}
+.op-wm-single > span {
+  position: absolute;
+  left: 50%;
+  top: 50%;
+  transform: translate(-50%, -50%);
+  white-space: nowrap;
+}
+
+/* 页边距内的内容盒；页眉/正文/页脚在其中垂直分区 */
+.op-content {
+  position: absolute;
+  left: ${mmv(margin.left)};
+  top: ${mmv(margin.top)};
+  width: ${mmv(contentWidth)};
+  height: ${mmv(contentHeight)};
+}
+
+.op-section {
+  position: absolute;
+  left: 0;
+  width: 100%;
+  overflow: hidden;
+}
+.op-header { top: 0; height: ${mmv(metrics.headerHeight)}; }
+.op-body   { top: ${mmv(metrics.headerHeight)}; height: ${mmv(metrics.bodyHeight)}; }
+.op-footer { top: ${mmv(metrics.headerHeight + metrics.bodyHeight)}; height: ${mmv(metrics.footerHeight)}; }
+
+/* -------------------------------- 控件 -------------------------------- */
+
+.op-node {
+  position: absolute;
+  transform-origin: left top;
+}
+
+.op-text {
+  overflow: hidden;
+  white-space: pre-wrap;
+  word-break: break-word;
+  overflow-wrap: break-word;
+  font-family: ${TEXT_DEFAULT_FONT_FAMILY};
+  font-size: ${TEXT_DEFAULT_FONT_SIZE}pt;
+  line-height: ${TEXT_DEFAULT_LINE_HEIGHT};
+  color: ${TEXT_DEFAULT_COLOR};
+}
+
+.op-richtext {
+  overflow: hidden;
+  font-family: ${TEXT_DEFAULT_FONT_FAMILY};
+  font-size: ${TEXT_DEFAULT_FONT_SIZE}pt;
+  line-height: 1.5;
+  color: ${TEXT_DEFAULT_COLOR};
+}
+.op-richtext > *:first-child { margin-top: 0; }
+.op-richtext > *:last-child { margin-bottom: 0; }
+.op-richtext img { max-width: 100%; }
+
+.op-image { display: block; }
+.op-image > img { display: block; width: 100%; height: 100%; }
+
+/* 条码 / 二维码：SVG 矢量填满控件框 */
+.op-code > svg { display: block; width: 100%; height: 100%; }
+
+.op-line > span {
+  position: absolute;
+  display: block;
+}
+
+/* 解析失败占位：必须看得见，避免用户拿到"少了一块"的单据而不自知 */
+.op-placeholder {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  border: 1px dashed #c0c4cc;
+  color: #a8abb2;
+  font-family: ${TEXT_DEFAULT_FONT_FAMILY};
+  font-size: 8pt;
+  overflow: hidden;
+}
+
+/* -------------------------------- 表格 -------------------------------- */
+${tableCss()}
+/* ------------------------------ 打印覆盖 ------------------------------ */
+
+@page {
+  size: ${mmv(pageWidth)} ${mmv(pageHeight)};
+  margin: 0;
+}
+
+@media print {
+  html, body { background: #ffffff; }
+  .op-doc { gap: 0; padding: 0; }
+  .op-page-wrap { width: auto; height: auto; }
+  .op-page {
+    transform: none;
+    box-shadow: none;
+    break-after: page;
+    page-break-after: always;
+  }
+  /* 末页不再换页，否则会多打一张空白纸 */
+  .op-page-wrap:last-child .op-page {
+    break-after: auto;
+    page-break-after: auto;
+  }
+}
+${options.extraCss ? `\n/* ---- 自定义样式 ---- */\n${options.extraCss}\n` : ''}`.trim()
+}
diff --git a/openprint/src/core/renderer-html/html-renderer.ts b/openprint/src/core/renderer-html/html-renderer.ts
new file mode 100644
index 0000000..da8dd06
--- /dev/null
+++ b/openprint/src/core/renderer-html/html-renderer.ts
@@ -0,0 +1,392 @@
+/**
+ * HTML 渲染器 —— LayoutPage[] → 可打印 HTML
+ * 真理源：《OpenPrint-设计方案.md》§5.11（打印样式）、§7.3（渲染产物）、§11.2（注入防护）
+ *
+ * ## 定位模型
+ *
+ * 引擎已经把一切算成 mm 绝对坐标，渲染器只做「数据 → 字符串」的机械翻译：
+ * 不做换行、不做测量、不做条件判断。任何在这里出现的排版逻辑都意味着
+ * 「测量用一套规则、渲染用另一套」，最终表现为分页错位——所以这里刻意保持"笨"。
+ *
+ * ## 注入防护（§11.2）
+ *
+ * - 文本 / 属性值一律 escape
+ * - richtext 在 data-binder 里已过 DOMPurify，这里直接注入
+ * - 条码 SVG 来自 bwip-js / qrcode 生成器，文本已被库转义
+ * - 图片 src 过 URL 协议白名单，挡掉 `javascript:` 一类的伪协议
+ */
+import type {
+  ImageControl,
+  LineControl,
+  RectControl,
+  TextControl,
+} from '@/types/control'
+import type {
+  LayoutPage,
+  LayoutResult,
+  PlacedControl,
+  PlacedTable,
+  PlacedNode,
+  RenderRow,
+} from '@/core/layout-engine/types'
+import type { WatermarkConfig } from '@/types/template'
+import {
+  generateCss,
+  mmv,
+  diagonalBackground,
+  TEXT_DEFAULT_COLOR,
+  TEXT_DEFAULT_FONT_FAMILY,
+  TEXT_DEFAULT_FONT_SIZE,
+  TEXT_DEFAULT_LINE_HEIGHT,
+  type CssOptions,
+} from './css-generator'
+import { MM_TO_PX } from '@/utils/constants'
+
+/* -------------------------------- 转义 -------------------------------- */
+
+const HTML_ESCAPE: Record<string, string> = {
+  '&': '&amp;',
+  '<': '&lt;',
+  '>': '&gt;',
+  '"': '&quot;',
+  "'": '&#39;',
+}
+
+export function escapeHtml(v: unknown): string {
+  return String(v ?? '').replace(/[&<>"']/g, (c) => HTML_ESCAPE[c] ?? c)
+}
+
+/** CSS 值消毒：挡掉 `;` `{}` 与 url(javascript:) 之类的样式注入 */
+function cssValue(v: unknown): string {
+  return String(v ?? '')
+    .replace(/[;{}<>]/g, '')
+    .replace(/expression\s*\(/gi, '')
+    .replace(/url\s*\(\s*['"]?\s*javascript:/gi, 'url(')
+    .trim()
+}
+
+/** 图片地址协议白名单 */
+function safeSrc(src: string): string {
+  const s = src.trim()
+  if (/^(data:image\/|https?:|blob:|\/|\.\/|\.\.\/)/i.test(s)) return s
+  // 相对路径（不含协议）也放行
+  if (!/^[a-z][a-z0-9+.-]*:/i.test(s)) return s
+  return ''
+}
+
+function styleAttr(pairs: Array<string | false | null | undefined>): string {
+  const s = pairs.filter(Boolean).join(';')
+  return s ? ` style="${escapeHtml(s)}"` : ''
+}
+
+/* ------------------------------ 节点几何 ------------------------------ */
+
+function boxStyles(node: PlacedNode): string[] {
+  const out = [
+    `left:${mmv(node.left)}`,
+    `top:${mmv(node.top)}`,
+    `width:${mmv(node.width)}`,
+    `height:${mmv(node.height)}`,
+  ]
+  const angle = node.kind === 'control' ? node.angle : undefined
+  if (angle) out.push(`transform:rotate(${Math.round(angle * 100) / 100}deg)`)
+  return out
+}
+
+/* -------------------------------- 控件 -------------------------------- */
+
+function renderText(node: PlacedControl, text: string): string {
+  const s = (node.control as TextControl).style ?? {}
+  const style = [
+    ...boxStyles(node),
+    `font-size:${s.fontSize ?? TEXT_DEFAULT_FONT_SIZE}pt`,
+    `color:${cssValue(s.fill ?? TEXT_DEFAULT_COLOR)}`,
+    `font-family:${cssValue(s.fontFamily ?? TEXT_DEFAULT_FONT_FAMILY)}`,
+    `font-weight:${s.fontWeight === 'bold' ? 'bold' : 'normal'}`,
+    `font-style:${s.fontStyle === 'italic' ? 'italic' : 'normal'}`,
+    `text-decoration:${s.textDecoration === 'underline' ? 'underline' : 'none'}`,
+    `text-align:${s.textAlign ?? 'left'}`,
+    `line-height:${s.lineHeight ?? TEXT_DEFAULT_LINE_HEIGHT}`,
+    s.letterSpacing ? `letter-spacing:${s.letterSpacing}pt` : null,
+  ]
+  return `<div class="op-node op-text" data-id="${escapeHtml(node.id)}"${styleAttr(style)}>${escapeHtml(text)}</div>`
+}
+
+function renderImage(node: PlacedControl, src: string): string {
+  const c = node.control as ImageControl
+  const url = safeSrc(src)
+  if (!url) return renderPlaceholder(node, '图片')
+  const radius = c.cornerRadius ? `border-radius:${c.cornerRadius}px` : null
+  const imgStyle = [`object-fit:${c.fit ?? 'contain'}`, radius]
+  return (
+    `<div class="op-node op-image" data-id="${escapeHtml(node.id)}"${styleAttr(boxStyles(node))}>` +
+    `<img src="${escapeHtml(url)}" alt=""${styleAttr(imgStyle)}></div>`
+  )
+}
+
+function renderCode(node: PlacedControl, svg: string): string {
+  // svg 由 bwip-js / qrcode 生成，内容已由库自身转义
+  return `<div class="op-node op-code" data-id="${escapeHtml(node.id)}"${styleAttr(boxStyles(node))}>${svg}</div>`
+}
+
+function renderRichText(node: PlacedControl, html: string): string {
+  // html 已在 data-binder 中经 DOMPurify 消毒
+  return `<div class="op-node op-richtext" data-id="${escapeHtml(node.id)}"${styleAttr(boxStyles(node))}>${html}</div>`
+}
+
+function renderShape(node: PlacedControl): string {
+  const c = node.control
+  if (c.type === 'line') {
+    const line = c as LineControl
+    const stroke = cssValue(line.stroke ?? '#000000')
+    const sw = line.strokeWidth ?? 1
+    const dash = line.strokeDashArray?.length ? 'dashed' : 'solid'
+    // 协议只存外接框，宽>=高视为水平线（与 PrintLine 的 MVP 约定一致）
+    const horizontal = node.height <= node.width
+    const inner = horizontal
+      ? `left:0;right:0;top:50%;transform:translateY(-50%);border-top:${sw}px ${dash} ${stroke}`
+      : `top:0;bottom:0;left:50%;transform:translateX(-50%);border-left:${sw}px ${dash} ${stroke}`
+    return (
+      `<div class="op-node op-line" data-id="${escapeHtml(node.id)}"${styleAttr(boxStyles(node))}>` +
+      `<span${styleAttr([inner])}></span></div>`
+    )
+  }
+
+  const rect = c as RectControl
+  const fill = rect.fill && rect.fill !== 'transparent' ? cssValue(rect.fill) : 'transparent'
+  const sw = rect.strokeWidth ?? 1
+  const isCircle = rect.shape === 'circle'
+
+  // 圆角：优先四角独立值，其次统一 cornerRadius，最后无圆角
+  let radiusStyle: string | null = null
+  if (isCircle) {
+    radiusStyle = 'border-radius:50%'
+  } else if (
+    rect.cornerRadiusTL != null ||
+    rect.cornerRadiusTR != null ||
+    rect.cornerRadiusBR != null ||
+    rect.cornerRadiusBL != null
+  ) {
+    const cr = rect.cornerRadius ?? 0
+    const tl = rect.cornerRadiusTL ?? cr
+    const tr = rect.cornerRadiusTR ?? cr
+    const br = rect.cornerRadiusBR ?? cr
+    const bl = rect.cornerRadiusBL ?? cr
+    radiusStyle = `border-radius:${tl}px ${tr}px ${br}px ${bl}px`
+  } else if (rect.cornerRadius) {
+    radiusStyle = `border-radius:${rect.cornerRadius}px`
+  }
+
+  const style = [
+    ...boxStyles(node),
+    `background:${fill}`,
+    sw > 0 ? `border:${sw}px solid ${cssValue(rect.stroke ?? '#000000')}` : 'border:0',
+    radiusStyle,
+    // 虚线：画布侧走 Fabric setLineDash，导出侧用 border-style 近似
+    rect.strokeDashArray?.length ? 'border-style:dashed' : null,
+  ]
+  return `<div class="op-node ${isCircle ? 'op-circle' : 'op-rect'}" data-id="${escapeHtml(node.id)}"${styleAttr(style)}></div>`
+}
+
+function renderPlaceholder(node: PlacedControl, label: string): string {
+  return (
+    `<div class="op-node op-placeholder" data-id="${escapeHtml(node.id)}"${styleAttr(boxStyles(node))}>` +
+    `${escapeHtml(label)}</div>`
+  )
+}
+
+function renderControl(node: PlacedControl): string {
+  switch (node.content.kind) {
+    case 'text':
+      return renderText(node, node.content.text)
+    case 'html':
+      return renderRichText(node, node.content.html)
+    case 'image':
+      return renderImage(node, node.content.src)
+    case 'svg':
+      return renderCode(node, node.content.svg)
+    case 'shape':
+      return renderShape(node)
+    case 'placeholder':
+      return renderPlaceholder(node, node.content.label)
+    default:
+      return ''
+  }
+}
+
+/* -------------------------------- 表格 -------------------------------- */
+
+const ROW_CLASS: Record<RenderRow['kind'], string> = {
+  header: 'is-header',
+  data: 'is-data',
+  group: 'is-group',
+  subtotal: 'is-subtotal',
+  summary: 'is-summary',
+  static: 'is-static',
+}
+
+/**
+ * 输出单元格完整样式。
+ * 只写**显式设置过**的属性，其余交给 `tableCss()` 的类规则兜底 —— 设计期 overlay
+ * （table-design-render.ts）走的是同一套取舍，两端因此像素级一致。
+ */
+function renderRow(row: RenderRow, striped: boolean): string {
+  const cls = [ROW_CLASS[row.kind]]
+  if (striped && row.kind === 'data' && (row.dataIndex ?? 0) % 2 === 1) cls.push('is-striped')
+
+  const cells = row.cells
+    .map((cell) => {
+      const style = [
+        `text-align:${cell.align ?? 'left'}`,
+        cell.background ? `background-color:${cssValue(cell.background)}` : null,
+        cell.bold !== undefined ? `font-weight:${cell.bold ? 'bold' : 'normal'}` : null,
+        cell.fontSize ? `font-size:${cell.fontSize}pt` : null,
+        cell.fontFamily ? `font-family:${cssValue(cell.fontFamily)}` : null,
+        cell.italic !== undefined ? `font-style:${cell.italic ? 'italic' : 'normal'}` : null,
+        cell.underline !== undefined
+          ? `text-decoration:${cell.underline ? 'underline' : 'none'}`
+          : null,
+        cell.color ? `color:${cssValue(cell.color)}` : null,
+        cell.valign ? `vertical-align:${cell.valign}` : null,
+        cell.diagonal ? diagonalBackground(cell.diagonal) : null,
+      ]
+      const span = cell.colSpan && cell.colSpan > 1 ? ` colspan="${cell.colSpan}"` : ''
+      const rspan = cell.rowSpan && cell.rowSpan > 1 ? ` rowspan="${cell.rowSpan}"` : ''
+      return `<td${span}${rspan}${styleAttr(style)}>${escapeHtml(cell.text) || '<br>'}</td>`
+    })
+    .join('')
+
+  return `<tr class="${cls.join(' ')}" style="height:${mmv(row.height)}">${cells}</tr>`
+}
+
+function renderTable(node: PlacedTable): string {
+  const opts = node.control.options ?? {}
+  const borders = opts.borders ?? 'all'
+  const striped = opts.striped ?? false
+  const va = opts.verticalAlign ?? 'middle'
+  const tableStyle = opts.tableStyle ?? 'none'
+
+  const cols = node.columnWidths
+    .map((w) => `<col style="width:${mmv(w)}">`)
+    .join('')
+
+  const body: string[] = []
+  for (const row of node.headerRows) body.push(renderRow(row, false))
+  for (const row of node.rows) body.push(renderRow(row, striped))
+  for (const row of node.footerRows) body.push(renderRow(row, false))
+
+  const style = [
+    `left:${mmv(node.left)}`,
+    `top:${mmv(node.top)}`,
+    `width:${mmv(node.width)}`,
+  ]
+
+  return (
+    `<table class="op-node op-table b-${borders} va-${va} ts-${tableStyle}" data-id="${escapeHtml(node.id)}"` +
+    `${styleAttr(style)}><colgroup>${cols}</colgroup><tbody>${body.join('')}</tbody></table>`
+  )
+}
+
+function renderNode(node: PlacedNode): string {
+  return node.kind === 'table' ? renderTable(node) : renderControl(node)
+}
+
+/* --------------------------------- 页 --------------------------------- */
+
+function renderSection(cls: string, nodes: PlacedNode[]): string {
+  if (nodes.length === 0) return `<div class="op-section ${cls}"></div>`
+  return `<div class="op-section ${cls}">${nodes.map(renderNode).join('')}</div>`
+}
+
+/**
+ * 生成水印装饰层 HTML。
+ * - 居中单个：flex 居中 + 绝对定位旋转 span
+ * - 全页平铺：用单个旋转水印瓦片生成的 SVG 作 background-image（repeat）
+ * 文本已 escape，颜色经 cssValue 消毒。
+ */
+function renderWatermark(wm: WatermarkConfig): string {
+  if (!wm.enabled) return ''
+  const color = cssValue(wm.color) || '#cccccc'
+  const size = Math.max(1, wm.fontSize)
+  const rot = Number.isFinite(wm.rotation) ? wm.rotation : 0
+  const text = escapeHtml(wm.text || '')
+
+  if (!wm.tile) {
+    const span = `<span style="transform:translate(-50%,-50%) rotate(${rot}deg);color:${color};font-size:${mmv(size)};font-family:${TEXT_DEFAULT_FONT_FAMILY};font-weight:bold;opacity:0.9">${text}</span>`
+    return `<div class="op-watermark op-wm-single">${span}</div>`
+  }
+
+  // 平铺：瓦片尺寸（mm）随字号放大，瓦片内绘制旋转文本
+  const spacingMm = Math.max(size * 2.6, 14)
+  const tilePx = Math.max(1, Math.ceil(spacingMm * (MM_TO_PX)))
+  const fontSizePx = Math.max(1, size) * MM_TO_PX
+  const svg =
+    `<svg xmlns="http://www.w3.org/2000/svg" width="${tilePx}" height="${tilePx}">` +
+    `<text x="50%" y="50%" fill="${color}" font-size="${fontSizePx}" font-family='${TEXT_DEFAULT_FONT_FAMILY}' ` +
+    `font-weight="bold" text-anchor="middle" dominant-baseline="middle" ` +
+    `transform="rotate(${rot} ${tilePx / 2} ${tilePx / 2})">${escapeHtml(wm.text || '')}</text>` +
+    `</svg>`
+  const uri = `data:image/svg+xml,${encodeURIComponent(svg)}`
+  const style = `background-image:url('${uri}');background-repeat:repeat;background-size:${mmv(spacingMm)} ${mmv(spacingMm)};`
+  return `<div class="op-watermark op-wm-tile" style="${style}"></div>`
+}
+
+export function renderPage(page: LayoutPage, watermark?: WatermarkConfig | null): string {
+  const wm = watermark ? renderWatermark(watermark) : ''
+  return (
+    `<div class="op-page-wrap"><div class="op-page" data-page="${page.pageNo}">` +
+    wm +
+    `<div class="op-content">` +
+    renderSection('op-header', page.header) +
+    renderSection('op-body', page.body) +
+    renderSection('op-footer', page.footer) +
+    `</div></div></div>`
+  )
+}
+
+/* ------------------------------- 文档装配 ------------------------------ */
+
+export interface RenderHtmlOptions extends CssOptions {
+  /** 生成完整 HTML 文档（含 head/style）；false 时只返回 `.op-doc` 片段 */
+  fullDocument?: boolean
+  /** 文档标题（打印时可能作为默认文件名） */
+  title?: string
+  /** 打印后自动关闭窗口（无头/新窗口打印场景用） */
+  autoPrint?: boolean
+}
+
+/** 只输出内容片段（宿主页面自行注入样式时用） */
+export function renderFragment(result: LayoutResult, watermark?: WatermarkConfig | null): string {
+  return `<div class="op-doc">${result.pages.map((p) => renderPage(p, watermark)).join('')}</div>`
+}
+
+/** 输出完整可独立打开 / 打印的 HTML 文档 */
+export function renderHtml(result: LayoutResult, options: RenderHtmlOptions = {}): string {
+  const css = generateCss(result.metrics, options)
+  const fragment = renderFragment(result, options.pageDecoration?.watermark)
+
+  if (options.fullDocument === false) return fragment
+
+  const autoPrint = options.autoPrint
+    ? '<script>window.addEventListener("load",function(){window.focus();window.print()})</script>'
+    : ''
+
+  return `<!DOCTYPE html>
+<html lang="zh-CN">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+<title>${escapeHtml(options.title ?? 'OpenPrint')}</title>
+<style>${css}</style>
+</head>
+<body>
+${fragment}
+${autoPrint}
+</body>
+</html>`
+}
+
+/** 供预览面板单独取样式用（iframe 里换缩放不必重算 HTML） */
+export function renderStyle(result: LayoutResult, options: CssOptions = {}): string {
+  return generateCss(result.metrics, options)
+}
diff --git a/openprint/src/core/renderer-html/index.ts b/openprint/src/core/renderer-html/index.ts
new file mode 100644
index 0000000..13c5ea3
--- /dev/null
+++ b/openprint/src/core/renderer-html/index.ts
@@ -0,0 +1,10 @@
+/** renderer-html 对外出口 */
+export {
+  escapeHtml,
+  renderFragment,
+  renderHtml,
+  renderPage,
+  renderStyle,
+  type RenderHtmlOptions,
+} from './html-renderer'
+export { generateCss, mmv, type CssOptions } from './css-generator'
diff --git a/openprint/src/core/renderer-html/renderer-html.spec.ts b/openprint/src/core/renderer-html/renderer-html.spec.ts
new file mode 100644
index 0000000..5394c07
--- /dev/null
+++ b/openprint/src/core/renderer-html/renderer-html.spec.ts
@@ -0,0 +1,117 @@
+import { describe, expect, it } from 'vitest'
+
+import { layout } from '@/core/layout-engine/pagination-engine'
+import { renderHtml, renderPage, renderStyle } from '@/core/renderer-html'
+import { createDemoTemplate } from '@/repository/mock/data/demo-template'
+import { createCjkMeasurer } from '@/core/__tests__/cjk-measurer'
+import type { RectControl } from '@/types/control'
+import type { LayoutPage, PlacedControl } from '@/core/layout-engine/types'
+
+function rectControl(overrides: Partial<RectControl>): RectControl {
+  return {
+    id: 'r1',
+    type: 'rect',
+    left: 0,
+    top: 0,
+    width: 40,
+    height: 25,
+    ...overrides,
+  }
+}
+
+function makeData(rows: number): Record<string, unknown> {
+  const items = Array.from({ length: rows }, (_, i) => {
+    const qty = (i % 5) + 1
+    const price = 10 + (i % 9)
+    return {
+      productCode: `P${String(i + 1).padStart(4, '0')}`,
+      productName: `商品${i + 1}`,
+      spec: '规格A',
+      unit: '件',
+      qty,
+      price,
+      amount: qty * price,
+    }
+  })
+  return { order: { orderNo: 'SO-001' }, customer: { name: '客户' }, items }
+}
+
+describe('renderer-html —— HTML 输出', () => {
+  const template = createDemoTemplate()
+  const measurer = createCjkMeasurer()
+
+  it('renderHtml 输出多页文档结构', async () => {
+    const result = await layout(template, makeData(30), { measurer })
+    const html = renderHtml(result, { screen: false })
+    expect(html).toContain('op-doc')
+    expect(html).toContain('op-page')
+    expect(html).toContain('op-page-wrap')
+    expect(html).toContain('销售出库单')
+  })
+
+  it('renderStyle 注入打印分页样式', async () => {
+    const result = await layout(template, makeData(10), { measurer })
+    const style = renderStyle(result, { screen: false })
+    expect(style).toContain('@page')
+    expect(style).toContain('break-after')
+  })
+
+  describe('renderShape —— 形状样式', () => {
+    /** 用一个只含单个形状控件的页面直接喂给 renderPage 验证 CSS 输出 */
+    function renderShapeHtml(c: RectControl): string {
+      const node: PlacedControl = {
+        kind: 'control',
+        id: c.id,
+        left: c.left,
+        top: c.top,
+        width: c.width,
+        height: c.height,
+        content: { kind: 'shape' },
+        control: c,
+      }
+      const page: LayoutPage = {
+        index: 0,
+        pageNo: 1,
+        header: [],
+        body: [node],
+        footer: [],
+      }
+      return renderPage(page)
+    }
+
+    it('四角独立圆角输出四值 border-radius', () => {
+      const html = renderShapeHtml(
+        rectControl({ cornerRadiusTL: 5, cornerRadiusTR: 10, cornerRadiusBR: 15, cornerRadiusBL: 20 }),
+      )
+      expect(html).toContain('border-radius:5px 10px 15px 20px')
+    })
+
+    it('仅设置部分角时，未设置角回落到统一 cornerRadius', () => {
+      const html = renderShapeHtml(rectControl({ cornerRadius: 8, cornerRadiusTR: 30 }))
+      // TR=30 覆盖统一值，其余三角=8
+      expect(html).toContain('border-radius:8px 30px 8px 8px')
+    })
+
+    it('统一 cornerRadius 输出单值 border-radius', () => {
+      const html = renderShapeHtml(rectControl({ cornerRadius: 8 }))
+      expect(html).toContain('border-radius:8px')
+      expect(html).not.toContain('8px 8px 8px 8px')
+    })
+
+    it('虚线模式输出 border-style:dashed', () => {
+      const html = renderShapeHtml(rectControl({ strokeDashArray: [6, 4] }))
+      expect(html).toContain('border-style:dashed')
+    })
+
+    it('圆形（正方形外接框）输出 border-radius:50%', () => {
+      const html = renderShapeHtml(rectControl({ shape: 'circle', width: 40, height: 40 }))
+      expect(html).toContain('border-radius:50%')
+      expect(html).toContain('op-circle')
+    })
+
+    it('圆形宽高不等时为椭圆（仍用 border-radius:50%，CSS 自动椭圆化）', () => {
+      const html = renderShapeHtml(rectControl({ shape: 'circle', width: 60, height: 30 }))
+      expect(html).toContain('border-radius:50%')
+    })
+  })
+})
diff --git a/openprint/src/core/renderer-html/richtext.spec.ts b/openprint/src/core/renderer-html/richtext.spec.ts
new file mode 100644
index 0000000..cd1f431
--- /dev/null
+++ b/openprint/src/core/renderer-html/richtext.spec.ts
@@ -0,0 +1,64 @@
+import { describe, expect, it } from 'vitest'
+
+import { resolveControlContent } from '@/core/layout-engine/data-binder'
+import { renderPage } from '@/core/renderer-html/html-renderer'
+import type { RichTextControl } from '@/types/control'
+import type { EvalContext, LayoutPage } from '@/core/layout-engine/types'
+
+/** 构造最小富文本控件 */
+function makeRichText(value: string, id = 'rt-1'): RichTextControl {
+  return { id, type: 'richtext', left: 0, top: 0, width: 80, height: 24, value }
+}
+
+describe('richtext —— 数据绑定 + 渲染链路', () => {
+  const ctx: EvalContext = { data: {}, row: undefined, page: 2, pages: 5 }
+
+  it('resolveControlContent 插值 {{page}}/{{pages}} 页码变量', async () => {
+    const res = await resolveControlContent(
+      makeRichText('<p>第 {{page}} 页 / 共 {{pages}} 页</p>'),
+      ctx,
+    )
+    expect(res.content.kind).toBe('html')
+    if (res.content.kind === 'html') {
+      expect(res.content.html).toContain('第 2 页 / 共 5 页')
+    }
+  })
+
+  // 注：happy-dom 环境 DOMPurify 的标签解析与真实浏览器不同（如 <h3>/<script> 处理异常）；
+  // 这里只断言文本内容，确保「插值 → 消毒 → html 内容」管线跑通。标签级行为由真实浏览器保证。
+  it('resolveControlContent 消毒管线保留文本内容', async () => {
+    const res = await resolveControlContent(
+      makeRichText('<h3>标题</h3><p><strong>加粗</strong> & 正文</p>'),
+      ctx,
+    )
+    if (res.content.kind === 'html') {
+      expect(res.content.html).toContain('加粗')
+      expect(res.content.html).toContain('正文')
+    }
+  })
+
+  it('renderPage 输出 op-richtext 且保留 HTML 结构', () => {
+    const page: LayoutPage = {
+      index: 0,
+      pageNo: 1,
+      header: [],
+      footer: [],
+      body: [
+        {
+          kind: 'control',
+          id: 'rt-1',
+          left: 10,
+          top: 10,
+          width: 80,
+          height: 24,
+          control: makeRichText('<h3>标题</h3><p><strong>加粗</strong></p>'),
+          content: { kind: 'html', html: '<h3>标题</h3><p><strong>加粗</strong></p>' },
+        },
+      ],
+    }
+    const html = renderPage(page)
+    expect(html).toContain('op-richtext')
+    expect(html).toContain('<h3>标题</h3>')
+    expect(html).toContain('<strong>加粗</strong>')
+  })
+})
diff --git a/openprint/src/core/sdk/index.ts b/openprint/src/core/sdk/index.ts
new file mode 100644
index 0000000..3b3e30e
--- /dev/null
+++ b/openprint/src/core/sdk/index.ts
@@ -0,0 +1,71 @@
+/**
+ * OpenPrint SDK —— 对外唯一渲染契约
+ * 真理源：《OpenPrint-设计方案.md》§6.4
+ *
+ * 设计器、导出器、无头服务、第三方接入都只调这里，不直接碰 layout-engine / renderer-html。
+ * 这样内部三层（分页 → 渲染 → 输出）随时可换实现（SVG / PDF renderer）而不破坏调用方。
+ *
+ * ```ts
+ * const { html, pages, warnings } = await render({ template, data })
+ * ```
+ */
+import type { AnyControl } from '@/types/control'
+import type { TemplateData } from '@/types/template'
+import { layout, type LayoutOptions } from '@/core/layout-engine/pagination-engine'
+import type { LayoutResult, RenderWarning } from '@/core/layout-engine/types'
+import { disposeSharedMeasurer } from '@/core/layout-engine/measure'
+import { renderHtml, type RenderHtmlOptions } from '@/core/renderer-html'
+
+export interface RenderRequest {
+  /** 模板协议对象（designer store 的 buildTemplate() 产物） */
+  template: TemplateData<AnyControl>
+  /** 业务数据；表格 dataSource 从这里按路径取数组 */
+  data?: Record<string, unknown>
+  /** 排版选项（自定义测量器 / 页数上限） */
+  layout?: LayoutOptions
+  /** 输出选项（屏幕预览装饰 / 缩放 / 完整文档） */
+  output?: RenderHtmlOptions
+}
+
+export interface RenderResponse {
+  /** 可直接写入 iframe / 落盘 / 送打印的 HTML */
+  html: string
+  /** 总页数 */
+  pages: number
+  /** 渲染告警（绑定缺失、数据源非数组、内容溢出…），UI 应当展示而非吞掉 */
+  warnings: RenderWarning[]
+  /** 内部排版产物，供导出器复用（避免二次分页） */
+  result: LayoutResult
+}
+
+/**
+ * 模板 + 数据 → 多页 HTML。
+ *
+ * 注意：这是**异步**的。二维码走 `qrcode.toString()` 的 Promise API，
+ * 且未来图片预加载也要在这一层完成，所以契约从一开始就定成 async，避免后续破坏性变更。
+ */
+export async function render(request: RenderRequest): Promise<RenderResponse> {
+  const result = await renderDocument(request)
+  const html = renderHtml(result, request.output)
+  return {
+    html,
+    pages: result.pages.length,
+    warnings: result.warnings,
+    result,
+  }
+}
+
+/** 只做排版不出 HTML —— PDF / 图片导出器直接消费页面模型 */
+export async function renderDocument(request: RenderRequest): Promise<LayoutResult> {
+  return layout(request.template, request.data ?? {}, request.layout ?? {})
+}
+
+/**
+ * 释放共享测量器持有的离屏 DOM 节点。
+ * 长期运行的 SPA 不需要调用（复用缓存收益更大）；单测或页面卸载时清一下更干净。
+ */
+export function dispose(): void {
+  disposeSharedMeasurer()
+}
+
+export type { LayoutOptions, LayoutResult, RenderWarning, RenderHtmlOptions }
diff --git a/openprint/src/core/sdk/sdk.spec.ts b/openprint/src/core/sdk/sdk.spec.ts
new file mode 100644
index 0000000..5b3b4c7
--- /dev/null
+++ b/openprint/src/core/sdk/sdk.spec.ts
@@ -0,0 +1,48 @@
+import { describe, expect, it } from 'vitest'
+
+import { dispose, render, renderDocument } from '@/core/sdk'
+import { createDemoTemplate } from '@/repository/mock/data/demo-template'
+import { createCjkMeasurer } from '@/core/__tests__/cjk-measurer'
+
+function makeData(rows: number): Record<string, unknown> {
+  const items = Array.from({ length: rows }, (_, i) => {
+    const qty = (i % 5) + 1
+    const price = 10 + (i % 9)
+    return {
+      productCode: `P${String(i + 1).padStart(4, '0')}`,
+      productName: `商品${i + 1}`,
+      spec: '规格A',
+      unit: '件',
+      qty,
+      price,
+      amount: qty * price,
+    }
+  })
+  return { order: { orderNo: 'SO-001' }, customer: { name: '客户' }, items }
+}
+
+describe('sdk.render —— 对外渲染契约 §6.4', () => {
+  const measurer = createCjkMeasurer()
+
+  it('render 返回 html / pages / result / warnings，且多页', async () => {
+    const res = await render({ template: createDemoTemplate(), data: makeData(30), layout: { measurer } })
+    expect(typeof res.html).toBe('string')
+    expect(res.html.length).toBeGreaterThan(0)
+    expect(res.pages).toBeGreaterThanOrEqual(2)
+    expect(res.result.pages.length).toBe(res.pages)
+    expect(Array.isArray(res.warnings)).toBe(true)
+  })
+
+  it('renderDocument 只排版，产出页面模型', async () => {
+    const result = await renderDocument({
+      template: createDemoTemplate(),
+      data: makeData(10),
+      layout: { measurer },
+    })
+    expect(result.pages.length).toBeGreaterThanOrEqual(1)
+  })
+
+  it('dispose 释放共享测量器，不抛', () => {
+    expect(() => dispose()).not.toThrow()
+  })
+})
diff --git a/openprint/src/core/spec/template.schema.json b/openprint/src/core/spec/template.schema.json
new file mode 100644
index 0000000..82184c2
--- /dev/null
+++ b/openprint/src/core/spec/template.schema.json
@@ -0,0 +1,182 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://open-print.dev/template.schema.json",
+  "title": "OpenPrint Template",
+  "description": "OpenPrint 模板协议（《设计方案》§5）：Document → Page → Section → Component",
+  "type": "object",
+  "required": ["version", "document"],
+  "additionalProperties": true,
+  "properties": {
+    "version": { "type": "string" },
+    "document": {
+      "type": "object",
+      "required": ["type", "page", "sections"],
+      "properties": {
+        "type": { "const": "report" },
+        "page": {
+          "type": "object",
+          "required": ["width", "height", "unit", "orientation", "margin"],
+          "properties": {
+            "width": { "type": "number", "exclusiveMinimum": 0 },
+            "height": { "type": "number", "exclusiveMinimum": 0 },
+            "unit": { "enum": ["mm", "in", "pt"] },
+            "orientation": { "enum": ["portrait", "landscape"] },
+            "backgroundColor": { "type": "string" },
+            "minPages": { "type": "integer", "minimum": 0 },
+            "watermark": {
+              "type": "object",
+              "required": ["enabled", "text", "color", "fontSize", "rotation", "tile"],
+              "properties": {
+                "enabled": { "type": "boolean" },
+                "text": { "type": "string" },
+                "color": { "type": "string" },
+                "fontSize": { "type": "number", "exclusiveMinimum": 0 },
+                "rotation": { "type": "number" },
+                "tile": { "type": "boolean" }
+              },
+              "additionalProperties": false
+            },
+            "margin": {
+              "type": "object",
+              "required": ["top", "bottom", "left", "right"],
+              "properties": {
+                "top": { "type": "number", "minimum": 0 },
+                "bottom": { "type": "number", "minimum": 0 },
+                "left": { "type": "number", "minimum": 0 },
+                "right": { "type": "number", "minimum": 0 }
+              },
+              "additionalProperties": false
+            }
+          },
+          "additionalProperties": false
+        },
+        "sections": {
+          "type": "array",
+          "minItems": 1,
+          "items": { "$ref": "#/definitions/section" }
+        }
+      },
+      "additionalProperties": true
+    }
+  },
+  "definitions": {
+    "section": {
+      "type": "object",
+      "required": ["type", "components"],
+      "properties": {
+        "type": { "enum": ["header", "body", "footer"] },
+        "height": { "type": "number", "exclusiveMinimum": 0 },
+        "repeat": { "type": "boolean" },
+        "components": {
+          "type": "array",
+          "items": { "$ref": "#/definitions/component" }
+        }
+      },
+      "additionalProperties": true
+    },
+    "component": {
+      "type": "object",
+      "required": ["type"],
+      "properties": {
+        "id": { "type": "string" },
+        "type": {
+          "enum": ["text", "image", "table", "barcode", "qrcode", "richtext", "rect", "line", "chart"]
+        },
+        "left": { "type": "number" },
+        "top": { "type": "number" },
+        "width": { "type": "number" },
+        "height": { "type": "number" },
+        "angle": { "type": "number" },
+        "printable": { "type": "boolean" },
+        "visibleIf": { "type": "string" },
+        "locked": { "type": "boolean" },
+        "name": { "type": "string" },
+        "binding": { "type": "string" },
+        "expression": { "type": "string" },
+        "value": {},
+        "style": {
+          "type": "object",
+          "properties": {
+            "fontSize": { "type": "number", "exclusiveMinimum": 0 },
+            "fill": { "type": "string" },
+            "fontFamily": { "type": "string" },
+            "fontWeight": { "enum": ["normal", "bold"] },
+            "fontStyle": { "enum": ["normal", "italic"] },
+            "textDecoration": { "enum": ["none", "underline"] },
+            "textAlign": { "enum": ["left", "center", "right"] },
+            "lineHeight": { "type": "number", "exclusiveMinimum": 0 },
+            "letterSpacing": { "type": "number" }
+          },
+          "additionalProperties": true
+        },
+        "dataSource": { "type": "string" },
+        "columns": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "required": ["title", "width"],
+            "properties": {
+              "title": { "type": "string" },
+              "field": { "type": "string" },
+              "expression": { "type": "string" },
+              "width": { "type": "number", "exclusiveMinimum": 0 },
+              "align": { "enum": ["left", "center", "right"] },
+              "headerAlign": { "enum": ["left", "center", "right"] },
+              "cellBackgroundColor": { "type": "string" },
+              "headerBackgroundColor": { "type": "string" },
+              "cellPadding": { "type": "number", "minimum": 0 }
+            },
+            "additionalProperties": true
+          }
+        },
+        "options": {
+          "type": "object",
+          "properties": {
+            "repeatHeader": { "type": "boolean" },
+            "repeatFooter": { "type": "boolean" },
+            "pageRows": { "anyOf": [{ "type": "number", "minimum": 1 }, { "const": "auto" }] },
+            "rowHeightMode": { "enum": ["auto", "fixed"] },
+            "rowHeight": { "type": "number", "exclusiveMinimum": 0 },
+            "keepTogether": { "type": "boolean" },
+            "skipEmptyRows": { "type": "boolean" },
+            "mergeSheets": { "type": "boolean" },
+            "striped": { "type": "boolean" },
+            "verticalAlign": { "enum": ["top", "middle", "bottom"] },
+            "borders": { "enum": ["all", "none", "horizontal", "outline"] }
+          },
+          "additionalProperties": true
+        },
+        "format": { "type": "string" },
+        "showText": { "type": "boolean" },
+        "errorLevel": { "enum": ["L", "M", "Q", "H"] },
+        "fit": { "enum": ["contain", "cover", "fill", "none"] },
+        "cornerRadius": { "type": "number", "minimum": 0 },
+        "cornerRadiusTL": { "type": "number", "minimum": 0 },
+        "cornerRadiusTR": { "type": "number", "minimum": 0 },
+        "cornerRadiusBR": { "type": "number", "minimum": 0 },
+        "cornerRadiusBL": { "type": "number", "minimum": 0 },
+        "fill": { "type": "string" },
+        "stroke": { "type": "string" },
+        "strokeWidth": { "type": "number", "minimum": 0 },
+        "strokeDashArray": { "type": "array", "items": { "type": "number" } },
+        "groupBy": { "type": "string" },
+        "kind": { "enum": ["bar", "line", "pie"] },
+        "categories": { "type": "array", "items": { "type": "string" } },
+        "series": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "name": { "type": "string" },
+              "data": { "type": "array", "items": { "type": "number" } },
+              "color": { "type": "string" }
+            },
+            "additionalProperties": true
+          }
+        },
+        "options": { "type": "object", "additionalProperties": true }
+      },
+      "additionalProperties": true
+    }
+  }
+}
diff --git a/openprint/src/core/spec/validator.spec.ts b/openprint/src/core/spec/validator.spec.ts
new file mode 100644
index 0000000..d73c47d
--- /dev/null
+++ b/openprint/src/core/spec/validator.spec.ts
@@ -0,0 +1,61 @@
+import { describe, expect, it } from 'vitest'
+
+import { assertTemplate } from '@/core/spec/validator'
+import type { TemplateData } from '@/types/template'
+
+describe('template 协议：常驻辅助线字段', () => {
+  const base = {
+    version: '1.0',
+    document: {
+      type: 'report' as const,
+      page: {
+        width: 210,
+        height: 297,
+        unit: 'mm' as const,
+        orientation: 'portrait' as const,
+        margin: { top: 10, bottom: 10, left: 10, right: 10 },
+      },
+      sections: [
+        {
+          type: 'body' as const,
+          components: [
+            {
+              id: 'r1',
+              type: 'rect' as const,
+              left: 10,
+              top: 10,
+              width: 40,
+              height: 25,
+            },
+          ],
+        },
+      ],
+    },
+  }
+
+  it('允许控件带 showGuides 字段', () => {
+    const t = {
+      ...base,
+      document: {
+        ...base.document,
+        sections: [
+          {
+            type: 'body' as const,
+            components: [
+              {
+                id: 'r1',
+                type: 'rect' as const,
+                left: 10,
+                top: 10,
+                width: 40,
+                height: 25,
+                showGuides: true,
+              },
+            ],
+          },
+        ],
+      },
+    } as unknown as TemplateData
+    expect(() => assertTemplate(t)).not.toThrow()
+  })
+})
diff --git a/openprint/src/core/spec/validator.ts b/openprint/src/core/spec/validator.ts
new file mode 100644
index 0000000..5362cd1
--- /dev/null
+++ b/openprint/src/core/spec/validator.ts
@@ -0,0 +1,54 @@
+/**
+ * template.json 协议校验（AJV）
+ * 加载模板时调用；校验失败抛出带可读信息的 TemplateValidationError。
+ */
+import Ajv from 'ajv'
+import type { ErrorObject, ValidateFunction } from 'ajv'
+import schema from './template.schema.json'
+
+const ajv = new Ajv({ allErrors: true, strict: false })
+
+// JSON Schema 与 TS 类型保持松散对应（schema 允许 additionalProperties 扩展）
+const validateFn = ajv.compile(schema) as ValidateFunction
+
+export interface ValidationIssue {
+  path: string
+  message: string
+}
+
+export class TemplateValidationError extends Error {
+  readonly issues: ValidationIssue[]
+
+  constructor(issues: ValidationIssue[]) {
+    super(
+      'template.json 协议校验失败：\n' +
+        issues.map((i) => `  - ${i.path || '/'}: ${i.message}`).join('\n'),
+    )
+    this.name = 'TemplateValidationError'
+    this.issues = issues
+  }
+}
+
+function toIssues(errors: ErrorObject[] | null | undefined): ValidationIssue[] {
+  return (errors ?? []).map((e) => ({
+    path: e.instancePath,
+    message: e.message ?? '未知错误',
+  }))
+}
+
+export interface ValidateResult {
+  valid: boolean
+  issues: ValidationIssue[]
+}
+
+/** 校验模板，返回结果（不抛异常） */
+export function validateTemplate(template: unknown): ValidateResult {
+  const valid = validateFn(template)
+  return { valid: !!valid, issues: valid ? [] : toIssues(validateFn.errors) }
+}
+
+/** 校验模板，失败抛 TemplateValidationError */
+export function assertTemplate(template: unknown): asserts template is import('@/types/template').TemplateData {
+  const result = validateTemplate(template)
+  if (!result.valid) throw new TemplateValidationError(result.issues)
+}
diff --git a/openprint/src/core/units.spec.ts b/openprint/src/core/units.spec.ts
new file mode 100644
index 0000000..976bf5d
--- /dev/null
+++ b/openprint/src/core/units.spec.ts
@@ -0,0 +1,50 @@
+import { describe, expect, it } from 'vitest'
+
+import {
+  MM_PER_PT,
+  PX_PER_MM,
+  fromMm,
+  mmToPx,
+  mmToPt,
+  ptToMm,
+  ptToPx,
+  pxToMm,
+  toMm,
+} from '@/core/units'
+
+describe('units 坐标换算', () => {
+  it('mmToPx：10mm ≈ 37.795px（96dpi）', () => {
+    expect(mmToPx(10)).toBeCloseTo(37.795, 2)
+  })
+
+  it('mmToPx / pxToMm 往返一致', () => {
+    expect(pxToMm(mmToPx(10))).toBeCloseTo(10, 4)
+    expect(mmToPx(pxToMm(100))).toBeCloseTo(100, 4)
+  })
+
+  it('英寸与毫米互换：1in = 25.4mm', () => {
+    expect(toMm(1, 'in')).toBeCloseTo(25.4, 6)
+    expect(fromMm(25.4, 'in')).toBeCloseTo(1, 6)
+  })
+
+  it('点(pt)与毫米：72pt = 25.4mm', () => {
+    expect(mmToPt(25.4)).toBeCloseTo(72, 4)
+    expect(ptToMm(72)).toBeCloseTo(25.4, 4)
+    expect(toMm(72, 'pt')).toBeCloseTo(25.4, 4)
+    expect(fromMm(25.4, 'pt')).toBeCloseTo(72, 4)
+  })
+
+  it('ptToPx：72pt = 96px（CSS 标准）', () => {
+    expect(ptToPx(72)).toBeCloseTo(96, 4)
+  })
+
+  it('px 与 mm 互转（px 是 CSS 内部单位，toMm 不接收 px 源单位，故直接测 mmToPx/pxToMm）', () => {
+    expect(mmToPx(pxToMm(96))).toBeCloseTo(96, 4)
+    expect(pxToMm(mmToPx(25.4))).toBeCloseTo(25.4, 4)
+  })
+
+  it('导出常量与推导一致', () => {
+    expect(PX_PER_MM).toBeCloseTo(96 / 25.4, 4)
+    expect(MM_PER_PT).toBeCloseTo(25.4 / 72, 4)
+  })
+})
diff --git a/openprint/src/core/units.ts b/openprint/src/core/units.ts
new file mode 100644
index 0000000..07e57e2
--- /dev/null
+++ b/openprint/src/core/units.ts
@@ -0,0 +1,48 @@
+/**
+ * 单位换算 —— 三层坐标单一换算入口
+ * 真理源：《OpenPrint-设计方案.md》§11.5（锁定精确常数，不要用近似值）
+ *
+ * 三层坐标：协议层（mm/in/pt）⇄ 画布层（CSS px @96dpi）⇄ 缩放层（px × zoom）
+ * 本文件只负责前两层；zoom 由画布层处理（mmToPx(...) * zoom）。
+ */
+
+export const MM_PER_INCH = 25.4 // 精确
+export const PT_PER_INCH = 72 // 精确（PostScript 标准）
+export const PX_PER_INCH = 96 // CSS 标准
+export const MM_PER_PT = MM_PER_INCH / PT_PER_INCH // 0.3527...
+export const MM_PER_PX = MM_PER_INCH / PX_PER_INCH // 0.2645...
+export const PT_PER_MM = PT_PER_INCH / MM_PER_INCH // 2.834...
+export const PX_PER_MM = PX_PER_INCH / MM_PER_INCH // 3.779...
+
+export const mmToPx = (mm: number): number => mm / MM_PER_PX
+export const pxToMm = (px: number): number => px * MM_PER_PX
+export const mmToPt = (mm: number): number => mm / MM_PER_PT
+export const ptToMm = (pt: number): number => pt * MM_PER_PT
+export const ptToPx = (pt: number): number => mmToPx(ptToMm(pt))
+export const pxToPt = (px: number): number => mmToPt(pxToMm(px))
+
+import type { PageUnit } from '@/types/template'
+
+/** 任意协议单位 → mm（Renderer 内部统一 mm 参与排版） */
+export function toMm(value: number, unit: PageUnit): number {
+  switch (unit) {
+    case 'mm':
+      return value
+    case 'in':
+      return value * MM_PER_INCH
+    case 'pt':
+      return ptToMm(value)
+  }
+}
+
+/** mm → 任意协议单位 */
+export function fromMm(mm: number, unit: PageUnit): number {
+  switch (unit) {
+    case 'mm':
+      return mm
+    case 'in':
+      return mm / MM_PER_INCH
+    case 'pt':
+      return mmToPt(mm)
+  }
+}
diff --git a/openprint/src/design/ai/AiAssistantPanel.vue b/openprint/src/design/ai/AiAssistantPanel.vue
new file mode 100644
index 0000000..3e74277
--- /dev/null
+++ b/openprint/src/design/ai/AiAssistantPanel.vue
@@ -0,0 +1,751 @@
+<script setup lang="ts">
+/**
+ * AiAssistantPanel —— 纯前端 AI 设计助手对话面板（右侧抽屉）。
+ * 一次性问答、零后端；配置来自本地（ai-settings）。生成的模板可直接「应用到画布」。
+ */
+import { computed, nextTick, ref, watch } from 'vue'
+import { NButton, NDrawer, NDrawerContent, NInput, useDialog, useMessage } from 'naive-ui'
+import { useDesignerStore } from '@/design/stores/designer'
+import { isAiConfigured, readAiSettings } from '@/config/ai-settings'
+import { generateTemplate } from '@/ai/generate'
+import type { TemplateData } from '@/types/template'
+import type { AnyControl } from '@/types/control'
+import { createDemoTemplate } from '@/repository/mock/data/demo-template'
+
+const props = defineProps<{ show: boolean }>()
+const emit = defineEmits<{
+  (e: 'update:show', v: boolean): void
+  (e: 'open-settings'): void
+}>()
+
+const store = useDesignerStore()
+const message = useMessage()
+const dialog = useDialog()
+
+interface ChatMsg {
+  id: number
+  role: 'user' | 'assistant'
+  text: string
+  template?: TemplateData<AnyControl>
+  /** 选区改写模式：AI 返回的替换控件集合 */
+  controls?: AnyControl[]
+  error?: string
+  streaming?: boolean
+}
+
+const messages = ref<ChatMsg[]>([])
+const input = ref('')
+const mode = ref<'create' | 'modify' | 'selected'>('create')
+const dsOpen = ref(false)
+const dsFields = ref('')
+const streaming = ref(false)
+const bodyRef = ref<HTMLElement | null>(null)
+const abortRef = ref<AbortController | null>(null)
+let seq = 0
+let lastPrompt = ''
+/** 选区改写模式：发起请求时锁定的选中控件 id，用于回包时定位替换目标 */
+let lockedSelectedIds: string[] = []
+
+/** 画布当前选中的正文控件（仅 body 控件，用于 C 选区改写） */
+const selectedControls = computed<AnyControl[]>(() =>
+  store.selectedIds
+    .map((id) => store.controls.find((c) => c.id === id))
+    .filter((c): c is AnyControl => !!c),
+)
+const hasSelection = computed(() => selectedControls.value.length > 0)
+// 渐进呈现用的定时器句柄（流式或缓冲端点都走同一套打字动画）
+let revealTimer: ReturnType<typeof setInterval> | 0 = 0
+
+const configured = computed(() => isAiConfigured())
+const currentTemplate = computed<TemplateData<AnyControl> | undefined>(() =>
+  mode.value === 'modify' ? (store.buildTemplate() as TemplateData<AnyControl>) : undefined,
+)
+const canSend = computed(() => configured.value && !!input.value.trim() && !streaming.value)
+
+const examples = [
+  '生成一个竖向快递面单，100×150mm，标题居中，含收件人信息和条码二维码',
+  '做一个 A4 销售发票，顶部公司信息，中间客户与商品表格，底部合计',
+  '做一个横向会员卡，90×54mm，左侧品牌、右侧会员姓名和卡号',
+]
+
+function scrollToBottom(): void {
+  nextTick(() => {
+    const el = bodyRef.value
+    if (el) el.scrollTop = el.scrollHeight
+  })
+}
+
+function controlCount(tpl?: TemplateData<AnyControl>): number {
+  if (!tpl) return 0
+  return tpl.document.sections.reduce(
+    (n, s) => n + (s.components?.length ?? 0),
+    0,
+  )
+}
+function pageSize(tpl?: TemplateData<AnyControl>): string {
+  if (!tpl) return ''
+  const p = tpl.document.page
+  return `${p.width}×${p.height} ${p.unit}`
+}
+
+async function run(prompt: string): Promise<void> {
+  if (!prompt.trim() || !configured.value || streaming.value) return
+  // 选区丢失时回退到「新建」，避免误生成整份模板
+  if (mode.value === 'selected' && !hasSelection.value) mode.value = 'create'
+  lastPrompt = prompt.trim()
+  messages.value.push({ id: ++seq, role: 'user', text: lastPrompt })
+  const assistant: ChatMsg = { id: ++seq, role: 'assistant', text: '', streaming: true }
+  messages.value.push(assistant)
+  streaming.value = true
+  scrollToBottom()
+
+  const abort = new AbortController()
+  abortRef.value = abort
+
+  // 渐进式「打字」呈现：onToken 把增量放进缓冲，由定时器按固定节奏逐段刷到可见文本。
+  // 关键：即使中转/代理把 SSE 缓冲成一块（一次性吐出），也保证至少 1.6s 的可见逐字动画，
+  // 不会出现「卡一下整段蹦出」；真流式端点则近乎实时跟随。
+  const revealBuf = { q: '' }
+  const REVEAL_MIN_MS = 1600
+  const REVEAL_TICK_MS = 24
+  const revealTick = (): void => {
+    if (revealBuf.q.length) {
+      const totalTicks = Math.max(1, Math.round(REVEAL_MIN_MS / REVEAL_TICK_MS))
+      const step = Math.max(1, Math.ceil(revealBuf.q.length / totalTicks))
+      assistant.text += revealBuf.q.slice(0, step)
+      revealBuf.q = revealBuf.q.slice(step)
+      scrollToBottom()
+    }
+    if (!revealBuf.q.length && !streaming.value) {
+      if (revealTimer) {
+        clearInterval(revealTimer)
+        revealTimer = 0
+      }
+    }
+  }
+  revealTimer = setInterval(revealTick, REVEAL_TICK_MS)
+
+  const res = await generateTemplate({
+    prompt: lastPrompt,
+    currentTemplate: currentTemplate.value,
+    selectedControls: mode.value === 'selected' ? selectedControls.value : undefined,
+    datasourceFields: dsOpen.value
+      ? dsFields.value
+          .split(/[，,\n]/)
+          .map((s) => s.trim())
+          .filter(Boolean)
+      : undefined,
+    settings: readAiSettings(),
+    signal: abort.signal,
+    onToken: (d) => {
+      revealBuf.q += d
+    },
+  })
+
+  assistant.streaming = false
+  if (res.ok && res.data) {
+    assistant.template = res.data
+  } else if (res.ok && res.controls) {
+    assistant.controls = res.controls
+    lockedSelectedIds = mode.value === 'selected' ? [...store.selectedIds] : []
+  } else {
+    assistant.error = res.error || '生成失败，请重试。'
+  }
+  streaming.value = false
+  abortRef.value = null
+  // 残留缓冲交给上面的 tick 收尾（streaming=false 后会把 buf 排空再停）
+  scrollToBottom()
+}
+
+function send(): void {
+  if (!canSend.value) return
+  void run(input.value)
+  input.value = ''
+}
+
+function sendWith(text: string): void {
+  if (streaming.value || !configured.value) return
+  void run(text)
+}
+
+function stop(): void {
+  abortRef.value?.abort()
+  streaming.value = false
+  if (revealTimer) {
+    clearInterval(revealTimer)
+    revealTimer = 0
+  }
+}
+
+function clearChat(): void {
+  if (!messages.value.length) return
+  dialog.warning({
+    title: '清空聊天记录',
+    content: '确定要清空当前对话吗？此操作不可撤销，但已应用到画布的模板不会受影响。',
+    positiveText: '清空',
+    negativeText: '取消',
+    onPositiveClick: () => {
+      abortRef.value?.abort()
+      if (revealTimer) {
+        clearInterval(revealTimer)
+        revealTimer = 0
+      }
+      streaming.value = false
+      messages.value = []
+      lastPrompt = ''
+    },
+  })
+}
+
+function retryLast(): void {
+  if (!lastPrompt) return
+  void run(lastPrompt)
+}
+
+function applyTemplate(tpl: TemplateData<AnyControl>): void {
+  store.loadTemplate({
+    id: `ai-${Date.now()}`,
+    name: 'AI 生成模板',
+    data: tpl,
+  })
+  message.success('已应用到画布，可在编辑器中继续调整')
+  emit('update:show', false)
+}
+
+/** C：把 AI 返回的控件集合替换掉原选中控件（原位改 id 的，新增的加进来，消失的删掉） */
+function applySelected(controls: AnyControl[]): void {
+  const targetIds = new Set(lockedSelectedIds)
+  const returnedIds = new Set(controls.map((c) => c.id))
+  let added = 0
+  let changed = 0
+  for (const ctrl of controls) {
+    if (targetIds.has(ctrl.id)) {
+      // 原位替换：保留 id/type，合并其余字段
+      store.updateControl(ctrl.id, ctrl)
+      changed++
+    } else {
+      // 新增控件：携带原几何 addControlOfType 会保留 left/top/width/height
+      store.addControlOfType(ctrl.type, { leftMm: ctrl.left, topMm: ctrl.top }, ctrl)
+      added++
+    }
+  }
+  // 选中集合里被 AI 删掉的控件：移除
+  let removed = 0
+  for (const id of targetIds) {
+    if (!returnedIds.has(id)) {
+      store.removeControl(id)
+      removed++
+    }
+  }
+  const parts = [
+    changed ? `改 ${changed}` : '',
+    added ? `加 ${added}` : '',
+    removed ? `删 ${removed}` : '',
+  ]
+    .filter(Boolean)
+    .join(' / ')
+  message.success(`已应用到选中控件（${parts || '无变化'}），可在编辑器中继续微调`)
+  emit('update:show', false)
+}
+
+function tryDemo(): void {
+  store.loadTemplate({
+    id: 'ai-demo',
+    name: 'AI 示例模板',
+    data: createDemoTemplate(),
+  })
+  message.success('已载入示例模板（无需配置即可体验）')
+  emit('update:show', false)
+}
+
+function onInputKey(e: KeyboardEvent): void {
+  if (e.key === 'Enter' && (e.metaKey || e.ctrlKey)) {
+    e.preventDefault()
+    send()
+  }
+}
+
+watch(
+  () => props.show,
+  (v) => {
+    if (v) scrollToBottom()
+  },
+)
+</script>
+
+<template>
+  <NDrawer
+    :show="props.show"
+    :width="440"
+    placement="right"
+    @update:show="(v: boolean) => emit('update:show', v)"
+  >
+    <NDrawerContent :native-scrollbar="false" :body-content-style="{ padding: 0 }">
+      <template #header>
+        <div class="ai-header">
+          <div class="ai-header-icon"><div class="i-carbon-ai-status text-20px" /></div>
+          <div class="ai-header-text">
+            <div class="ai-header-title">AI 设计助手</div>
+            <div class="ai-header-sub">用一句话生成精美打印模板</div>
+          </div>
+          <NButton
+            quaternary
+            size="small"
+            class="ai-clear-btn"
+            :disabled="!messages.length"
+            @click="clearChat"
+          >
+            <div class="i-carbon-trash-can text-15px" />
+            <span>清空</span>
+          </NButton>
+        </div>
+      </template>
+
+      <!-- 对话区 -->
+      <div ref="bodyRef" class="ai-body">
+        <!-- 空状态 -->
+        <div v-if="messages.length === 0" class="ai-empty">
+          <div class="ai-empty-icon"><div class="i-carbon-ai-status text-40px" /></div>
+          <div class="ai-empty-title">想设计点什么？</div>
+          <div class="ai-empty-desc">描述你想要的排版，我会直接画出模板布局。</div>
+          <div class="ai-chips">
+            <button
+              v-for="ex in examples"
+              :key="ex"
+              class="ai-chip"
+              :disabled="!configured"
+              @click="sendWith(ex)"
+            >
+              {{ ex }}
+            </button>
+          </div>
+        </div>
+
+        <!-- 消息流 -->
+        <div v-for="m in messages" :key="m.id" class="ai-row" :class="m.role">
+          <div v-if="m.role === 'assistant'" class="ai-avatar"><div class="i-carbon-ai-status" /></div>
+          <div class="ai-bubble" :class="m.role">
+            <template v-if="m.role === 'user'">{{ m.text }}</template>
+            <template v-else>
+              <!-- 流式/思考中 -->
+              <div v-if="m.streaming && !m.text" class="ai-typing">
+                <span></span><span></span><span></span>
+              </div>
+              <div v-else class="ai-md">{{ m.text }}</div>
+
+              <!-- 模板预览卡 -->
+              <div v-if="m.template" class="ai-tpl-card">
+                <div class="ai-tpl-head">
+                  <div class="i-carbon-document text-16px" />
+                  <span>模板已生成</span>
+                  <span class="ai-tpl-meta">{{ pageSize(m.template) }} · {{ controlCount(m.template) }} 个控件</span>
+                </div>
+                <div class="ai-tpl-actions">
+                  <NButton size="small" type="primary" @click="applyTemplate(m.template!)">应用到画布</NButton>
+                  <NButton size="small" tertiary @click="retryLast">重新生成</NButton>
+                </div>
+              </div>
+
+              <!-- 选区改写结果卡 -->
+              <div v-if="m.controls" class="ai-tpl-card">
+                <div class="ai-tpl-head">
+                  <div class="i-carbon-warning-alt text-16px" />
+                  <span>已生成选中部分</span>
+                  <span class="ai-tpl-meta">{{ m.controls.length }} 个控件</span>
+                </div>
+                <div class="ai-tpl-actions">
+                  <NButton size="small" type="primary" @click="applySelected(m.controls!)">替换选中控件</NButton>
+                  <NButton size="small" tertiary @click="retryLast">重新生成</NButton>
+                </div>
+              </div>
+
+              <div v-if="m.error" class="ai-error">
+                <div class="i-carbon-warning-alt text-14px" />
+                <span>{{ m.error }}</span>
+              </div>
+            </template>
+          </div>
+        </div>
+      </div>
+
+      <!-- 底部输入区 -->
+      <template #footer>
+        <div class="ai-footer">
+          <div v-if="!configured" class="ai-notice">
+            <div class="ai-notice-text">尚未配置 AI：在设置里填入模型地址 / Key / 模型 ID 后即可对话。</div>
+            <div class="ai-notice-actions">
+              <NButton size="small" type="primary" @click="emit('open-settings')">去设置</NButton>
+              <NButton size="small" tertiary @click="tryDemo">试用示例</NButton>
+            </div>
+          </div>
+
+          <div v-else class="ai-compose">
+            <div class="ai-mode">
+              <button class="ai-mode-btn" :class="{ active: mode === 'create' }" @click="mode = 'create'">
+                新建
+              </button>
+              <button class="ai-mode-btn" :class="{ active: mode === 'modify' }" @click="mode = 'modify'">
+                基于当前模板改
+              </button>
+              <button
+                v-if="hasSelection"
+                class="ai-mode-btn"
+                :class="{ active: mode === 'selected' }"
+                @click="mode = 'selected'"
+              >
+                选中部分
+                <span class="ai-mode-count">{{ selectedControls.length }}</span>
+              </button>
+              <button class="ai-ds-btn" :class="{ active: dsOpen }" @click="dsOpen = !dsOpen">
+                <div class="i-carbon-data-base text-13px" /> 数据字段
+              </button>
+            </div>
+            <div v-if="mode === 'selected' && hasSelection" class="ai-sel-hint">
+              将只改写画布上选中的 {{ selectedControls.length }} 个控件（重排 / 对齐 / 换风格）。
+            </div>
+
+            <div v-if="dsOpen" class="ai-ds-box">
+              <NInput
+                v-model:value="dsFields"
+                type="textarea"
+                size="small"
+                :autosize="{ minRows: 2, maxRows: 4 }"
+                placeholder="可选：填数据字段名，用逗号分隔（如 customer.name, order.total），让绑定指向真实字段"
+              />
+            </div>
+
+            <div class="ai-input-row">
+              <NInput
+                v-model:value="input"
+                type="textarea"
+                size="small"
+                :autosize="{ minRows: 1, maxRows: 4 }"
+                placeholder="描述你想要的模板，例如：做一个 A4 收货单，顶部公司名，中间表格…"
+                @keydown="onInputKey"
+              />
+              <NButton
+                v-if="!streaming"
+                type="primary"
+                :disabled="!canSend"
+                @click="send"
+              >
+                <template #icon><div class="i-carbon-send text-15px" /></template>
+                发送
+              </NButton>
+              <NButton v-else type="error" @click="stop">
+                <template #icon><div class="i-carbon-stop-filled text-14px" /></template>
+                停止
+              </NButton>
+            </div>
+            <div class="ai-hint">Enter 发送 · ⌘/Ctrl + Enter 也可 · 生成内容建议在编辑器中二次微调</div>
+          </div>
+        </div>
+      </template>
+    </NDrawerContent>
+  </NDrawer>
+</template>
+
+<style scoped>
+.ai-header {
+  display: flex;
+  align-items: center;
+  gap: 12px;
+  width: 100%;
+}
+.ai-clear-btn {
+  margin-left: auto;
+  color: var(--brand-text-3, #8a919f);
+}
+.ai-clear-btn:hover:not(:disabled) {
+  color: #d4380d;
+}
+.ai-header-icon {
+  width: 36px;
+  height: 36px;
+  border-radius: 10px;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  color: #fff;
+  background: linear-gradient(135deg, var(--brand-primary, #1677ff), #6aa6ff);
+}
+.ai-header-title {
+  font-size: 15px;
+  font-weight: 600;
+  margin-bottom: 5px;
+  color: var(--brand-text-1, #1f2329);
+}
+.ai-header-sub {
+  font-size: 12px;
+  color: var(--brand-text-3, #8a919f);
+}
+
+.ai-body {
+  height: 100%;
+  overflow-y: auto;
+  padding: 16px;
+  display: flex;
+  flex-direction: column;
+  gap: 14px;
+  /* 统一的聊天表面底色：与白色气泡形成对比，避免「只有提问才变色、上下不一致」的观感 */
+  background: var(--brand-chat-bg, linear-gradient(180deg, #eef2f7 0%, #f5f8fc 100%));
+}
+
+/* 空状态 */
+.ai-empty {
+  margin: auto;
+  text-align: center;
+  max-width: 320px;
+}
+.ai-empty-icon {
+  color: var(--brand-primary, #1677ff);
+  opacity: 0.85;
+}
+.ai-empty-title {
+  margin-top: 8px;
+  font-size: 16px;
+  font-weight: 600;
+  color: var(--brand-text-1, #1f2329);
+}
+.ai-empty-desc {
+  margin-top: 4px;
+  font-size: 13px;
+  color: var(--brand-text-3, #8a919f);
+}
+.ai-chips {
+  margin-top: 16px;
+  display: flex;
+  flex-direction: column;
+  gap: 8px;
+}
+.ai-chip {
+  text-align: left;
+  padding: 10px 12px;
+  border-radius: 10px;
+  border: 1px solid var(--brand-border, #e5e6eb);
+  background: var(--brand-surface, #fff);
+  color: var(--brand-text-2, #4e5969);
+  font-size: 12.5px;
+  line-height: 1.4;
+  cursor: pointer;
+  transition:
+    border-color 0.15s,
+    color 0.15s,
+    transform 0.1s;
+}
+.ai-chip:hover:not(:disabled) {
+  border-color: var(--brand-primary, #1677ff);
+  color: var(--brand-primary, #1677ff);
+}
+.ai-chip:active:not(:disabled) {
+  transform: scale(0.99);
+}
+.ai-chip:disabled {
+  opacity: 0.5;
+  cursor: not-allowed;
+}
+
+/* 消息行 */
+.ai-row {
+  display: flex;
+  gap: 8px;
+  max-width: 100%;
+}
+.ai-row.user {
+  justify-content: flex-end;
+}
+.ai-avatar {
+  flex-shrink: 0;
+  width: 26px;
+  height: 26px;
+  border-radius: 8px;
+  background: var(--brand-primary, #1677ff);
+  color: #fff;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  font-size: 14px;
+}
+.ai-bubble {
+  border-radius: 12px;
+  padding: 10px 12px;
+  font-size: 13px;
+  line-height: 1.6;
+  white-space: pre-wrap;
+  word-break: break-word;
+  max-width: 86%;
+}
+.ai-bubble.user {
+  background: var(--brand-primary, #1677ff);
+  color: #fff;
+  border-bottom-right-radius: 4px;
+}
+.ai-bubble.assistant {
+  background: var(--brand-surface, #fff);
+  color: var(--brand-text-1, #1f2329);
+  border: 1px solid var(--brand-border, #e5e6eb);
+  border-bottom-left-radius: 4px;
+}
+.ai-md {
+  font-family: var(--font-mono, monospace);
+  font-size: 12.5px;
+}
+
+/* 打字指示器 */
+.ai-typing {
+  display: inline-flex;
+  gap: 4px;
+  align-items: center;
+  height: 18px;
+}
+.ai-typing span {
+  width: 6px;
+  height: 6px;
+  border-radius: 50%;
+  background: var(--brand-text-3, #b0b6c0);
+  animation: ai-blink 1.2s infinite ease-in-out;
+}
+.ai-typing span:nth-child(2) {
+  animation-delay: 0.2s;
+}
+.ai-typing span:nth-child(3) {
+  animation-delay: 0.4s;
+}
+@keyframes ai-blink {
+  0%,
+  60%,
+  100% {
+    opacity: 0.25;
+    transform: translateY(0);
+  }
+  30% {
+    opacity: 1;
+    transform: translateY(-3px);
+  }
+}
+
+/* 模板卡 */
+.ai-tpl-card {
+  margin-top: 10px;
+  border: 1px solid var(--brand-border, #e5e6eb);
+  border-radius: 10px;
+  overflow: hidden;
+  background: var(--brand-surface, #fff);
+}
+.ai-tpl-head {
+  display: flex;
+  align-items: center;
+  gap: 6px;
+  padding: 8px 10px;
+  background: rgba(22, 119, 255, 0.06);
+  color: var(--brand-text-1, #1f2329);
+  font-size: 13px;
+  font-weight: 500;
+}
+.ai-tpl-meta {
+  margin-left: auto;
+  font-weight: 400;
+  font-size: 11.5px;
+  color: var(--brand-text-3, #8a919f);
+}
+.ai-tpl-actions {
+  display: flex;
+  gap: 8px;
+  padding: 10px;
+}
+
+.ai-error {
+  margin-top: 8px;
+  display: flex;
+  align-items: center;
+  gap: 6px;
+  color: #d4380d;
+  font-size: 12.5px;
+}
+
+/* 底部 */
+.ai-footer {
+  border-top: 1px solid var(--brand-border, #e5e6eb);
+  background: var(--brand-surface, #fff);
+}
+.ai-notice {
+  padding: 12px 14px;
+}
+.ai-notice-text {
+  font-size: 12.5px;
+  color: var(--brand-text-2, #4e5969);
+  margin-bottom: 8px;
+}
+.ai-notice-actions {
+  display: flex;
+  gap: 8px;
+}
+.ai-compose {
+  padding: 12px 14px 10px;
+}
+.ai-mode {
+  display: flex;
+  align-items: center;
+  gap: 6px;
+  margin-bottom: 8px;
+}
+.ai-mode-btn,
+.ai-ds-btn {
+  display: inline-flex;
+  align-items: center;
+  gap: 4px;
+  padding: 4px 10px;
+  font-size: 12px;
+  border-radius: 999px;
+  border: 1px solid var(--brand-border, #e5e6eb);
+  background: var(--brand-surface, #fff);
+  color: var(--brand-text-2, #4e5969);
+  cursor: pointer;
+  transition:
+    border-color 0.15s,
+    color 0.15s,
+    background 0.15s;
+}
+.ai-mode-btn.active {
+  border-color: var(--brand-primary, #1677ff);
+  color: var(--brand-primary, #1677ff);
+  background: rgba(22, 119, 255, 0.08);
+}
+.ai-mode-count {
+  margin-left: 4px;
+  min-width: 16px;
+  padding: 0 4px;
+  height: 16px;
+  line-height: 16px;
+  text-align: center;
+  font-size: 11px;
+  border-radius: 8px;
+  background: var(--brand-primary, #1677ff);
+  color: #fff;
+}
+.ai-sel-hint {
+  margin: -2px 0 6px;
+  font-size: 11.5px;
+  color: var(--brand-text-3, #8a919f);
+}
+.ai-ds-btn.active {
+  border-color: var(--brand-primary, #1677ff);
+  color: var(--brand-primary, #1677ff);
+}
+.ai-ds-box {
+  margin-bottom: 8px;
+}
+.ai-input-row {
+  display: flex;
+  gap: 8px;
+  align-items: flex-end;
+}
+.ai-input-row :deep(.n-input) {
+  flex: 1;
+}
+.ai-hint {
+  margin-top: 6px;
+  font-size: 11px;
+  color: var(--brand-text-3, #a9aeb8);
+}
+</style>
diff --git a/openprint/src/design/canvas/CanvasDesigner.ts b/openprint/src/design/canvas/CanvasDesigner.ts
new file mode 100644
index 0000000..a3b9e2c
--- /dev/null
+++ b/openprint/src/design/canvas/CanvasDesigner.ts
@@ -0,0 +1,873 @@
+/**
+ * CanvasDesigner —— Fabric 画布内核
+ *
+ * 职责：画布初始化 / 页面（A4 白纸）/ 缩放平移 / 控件增删改 / 选中事件 / 序列化。
+ * 坐标约定（《标尺与辅助系统》§4.3）：
+ * - 页面左上角 = 画布坐标 (0,0)，zoom=1 时 1mm = MM_TO_PX px
+ * - 居中/平移/缩放全部走 viewportTransform，标尺层直接读 vt[4]/vt[5] + zoom
+ * - 协议层坐标：body 控件相对"页边距内容区"左上角；zone 子控件相对色带左上角（§5.14.2）
+ */
+import { Canvas, Rect, Line, Point, FabricObject, Text, Pattern, type TPointerEventInfo } from 'fabric'
+import type { AnyControl, ZoneControl } from '@/types/control'
+import type { PageSetup, WatermarkConfig } from '@/types/template'
+import { MM_TO_PX, ZOOM_MAX, ZOOM_MIN } from '@/utils/constants'
+import { toMm } from '@/core/units'
+import { createFabricControl, isPrintObject, PrintText, PrintZone, type IPrintObject } from './controls'
+import { SmartGuides } from './guides/SmartGuides'
+import { PrintTable } from './controls/PrintTable'
+import { ensureCells } from '@/core/layout-engine/table-cells'
+import { computeGridLayout, hitTestCell } from './table-design-render'
+import { computePhysicalPageCount } from './page-geometry'
+import { pageGapPx, modelTopToCanvasY, canvasYToModelTop } from './page-gap'
+import type { TableControl } from '@/types/control'
+
+export interface ViewportState {
+  zoom: number
+  offsetX: number
+  offsetY: number
+}
+
+export interface CanvasDesignerEvents {
+  /** 选中变化（controlId 列表；空数组 = 取消选中） */
+  onSelectionChange?: (ids: string[]) => void
+  /** 控件几何/属性被画布交互修改（拖拽/缩放手柄结束） */
+  onObjectModified?: (control: AnyControl) => void
+  /** 视口变化（缩放/平移），驱动标尺重绘 */
+  onViewportChange?: (vp: ViewportState) => void
+  /** 双击表格单元格进入编辑：返回物化了 cells 的控件与命中行列 */
+  onCellEdit?: (info: { controlId: string; control: AnyControl; row: number; col: number }) => void
+  /**
+   * 画布变换心跳：对象拖拽/缩放/旋转或视口变化时触发。
+   * 表格 HTML overlay 靠它重算定位（不走 store 直连，避免 store ↔ 画布循环依赖）。
+   */
+  onTransformTick?: () => void
+  /** 物理页数变化（内容推导或手动分页触发），驱动右侧页面面板刷新 */
+  onPageCountChange?: (count: number) => void
+}
+
+type PrintFabricObject = FabricObject & IPrintObject
+
+export class CanvasDesigner {
+  canvas!: Canvas
+  /** 页面尺寸（mm，内部统一换算） */
+  pageWidthMm = 210
+  pageHeightMm = 297
+  marginMm = { top: 10, bottom: 10, left: 10, right: 10 }
+
+  private pageRect!: Rect
+  /** 第 2..N 页白色背景（与 pageRect 同款，按 stride 堆叠） */
+  private extraPageRects: Rect[] = []
+  /** 每页内容区参考线（蓝色虚线矩形，非交互、不导出） */
+  private pageGuides: Rect[] = []
+  /** 每页内容区底部的分页虚线（红色，与渲染 floor(top/bodyH) 落页边界一致） */
+  private pageBreaks: Line[] = []
+  /** 分页线标签（"分页"）与每页页码标签（"第 N 页"） */
+  private pageLabels: Text[] = []
+  /** 当前文档物理页数 = max(内容推导页数, 手动分页 minPages)，最小 1 */
+  private pageCount = 1
+  /** 手动分页下限：用户「加页/减页」调整；0 = 完全由内容推导 */
+  private minPages = 0
+  /**
+   * 页间视觉间距（px，仅设计态）：上下两页之间留白，便于分辨页边界。
+   * 只作用在画布坐标（模型 mm 保持 flush，导出/渲染不变）。
+   */
+  private readonly PAGE_GAP_PX = 24
+  private smartGuides?: SmartGuides
+  /** 水印装饰层（非交互、不导出、不进序列化），随页面尺寸/配置重建 */
+  private watermarkObjs: FabricObject[] = []
+  private lastWatermark?: WatermarkConfig
+  private events: CanvasDesignerEvents = {}
+  private spacePanning = false
+  /** 用户手动缩放后置 true，窗口 resize 不再自动 refit */
+  private userZoomed = false
+
+  /** 初始化画布。container 决定画布像素尺寸（ ResizeObserver 自适应） */
+  init(el: HTMLCanvasElement, container: HTMLElement, events: CanvasDesignerEvents = {}): void {
+    this.events = events
+    // Fabric 7 默认 origin 为 center——全局改回 left/top，协议坐标语义保持一致
+    FabricObject.ownDefaults.originX = 'left'
+    FabricObject.ownDefaults.originY = 'top'
+    this.canvas = new Canvas(el, {
+      width: container.clientWidth,
+      height: container.clientHeight,
+      backgroundColor: '#e8eaed',
+      preserveObjectStacking: true,
+      selection: true,
+      stopContextMenu: true,
+      fireRightClick: true,
+    })
+
+    this.buildPage()
+    this.fitToContainer(container)
+    this.bindEvents()
+
+    this.smartGuides = new SmartGuides(this.canvas, () => this.pageRect, () => this.marginMm)
+
+    new ResizeObserver(() => {
+      this.canvas.setDimensions({
+        width: container.clientWidth,
+        height: container.clientHeight,
+      })
+      // 布局稳定前（面板展开/窗口调整）保持适配；用户手动缩放后不再打扰
+      if (!this.userZoomed) this.fitToContainer(container)
+      this.canvas.requestRenderAll()
+      this.emitViewport()
+    }).observe(container)
+  }
+
+  dispose(): void {
+    window.removeEventListener('keydown', this.onKeyDown)
+    window.removeEventListener('keyup', this.onKeyUp)
+    this.smartGuides?.dispose()
+    void this.canvas.dispose()
+  }
+
+  /* -------------------------------- 页面 -------------------------------- */
+
+  private buildPage(): void {
+    this.pageRect = new Rect({
+      left: 0,
+      top: 0,
+      width: this.pageWidthMm * MM_TO_PX,
+      height: this.pageHeightMm * MM_TO_PX,
+      fill: this.lastPageBackground || '#ffffff',
+      selectable: false,
+      evented: false,
+      hoverCursor: 'default',
+      shadow: '0 2px 12px rgba(0,0,0,0.15)',
+      // 标记：序列化/选中时排除
+      excludeFromExport: true,
+    } as never)
+    ;(this.pageRect as unknown as { isPageRect: boolean }).isPageRect = true
+    this.canvas.add(this.pageRect)
+    this.pageRect.canvas = this.canvas
+    // 首次构建后按当前内容推导页数并铺好分页线 / 参考线 / 页码
+    this.rebuildPages()
+  }
+
+  /** 记忆最近一次背景色（buildPage 首帧用） */
+  private lastPageBackground = '#ffffff'
+
+  /* ------------------------ 页间留白（模型 mm 与画布 px 换算） ------------------------ */
+  // 复用 page-gap.ts 纯函数，避免实现与 page-gap.spec.ts 测试逻辑分叉（单一真相来源）。
+
+  /** 模型 top(mm, flush) 所在页索引 → 该页之前的累计页间距(px) */
+  private gapPx(topMm: number): number {
+    return pageGapPx(topMm, this.pageHeightMm, this.PAGE_GAP_PX)
+  }
+
+  /** 模型 top(mm, flush) → 画布绝对 y(px)：页边距 + 页内偏移 + 累计页间距 */
+  private modelTopToY(topMm: number): number {
+    return modelTopToCanvasY(topMm, this.marginMm.top * MM_TO_PX, this.pageHeightMm, this.PAGE_GAP_PX)
+  }
+
+  /** 画布绝对 y(px) → 模型 top(mm, flush)：反解累计页间距（近页边界最多迭代 2 次收敛） */
+  private yToModelTop(y: number): number {
+    return canvasYToModelTop(y, this.marginMm.top * MM_TO_PX, this.pageHeightMm, this.PAGE_GAP_PX)
+  }
+
+  /* -------------------------------- 页面 -------------------------------- */
+
+  /**
+   * 由正文控件最低底部推导物理页数：floor(maxBottomMm / pageHeightMm) + 1。
+   * 与渲染端 layoutStaticOnly 的 `floor(top/bodyH)` 落页口径一致（body 控件按
+   * marginTop + top 绝对定位，越过内容区底部即落入下一页）。
+   */
+  private computeContentPageCount(): number {
+    let maxBottomMm = 0
+    for (const obj of this.getPrintObjects()) {
+      if (obj instanceof PrintZone) continue
+      // 模型 mm（flush）口径：先反解页间距再算底部，与渲染/导出一致
+      const topMm = this.yToModelTop(obj.top ?? 0)
+      const bottom = topMm + obj.getScaledHeight() / MM_TO_PX
+      if (bottom > maxBottomMm) maxBottomMm = bottom
+    }
+    return computePhysicalPageCount(maxBottomMm, this.pageHeightMm)
+  }
+
+  /** 有效物理页数 = max(内容推导, 手动分页下限)，最小 1 */
+  private computePageCount(): number {
+    return Math.max(this.minPages, this.computeContentPageCount())
+  }
+
+  /** 内容推导页数（不含手动分页），供 store 的「加页」计算 */
+  get contentPageCount(): number {
+    return this.computeContentPageCount()
+  }
+
+  /** 当前有效物理页数 */
+  get effectivePageCount(): number {
+    return this.pageCount
+  }
+
+  /** 手动分页下限（0 = 完全由内容推导） */
+  get manualPageCount(): number {
+    return this.minPages
+  }
+
+  /** 设置手动分页下限并重建页面视觉 */
+  setManualPageCount(n: number): void {
+    this.minPages = Math.max(0, Math.floor(n) || 0)
+    this.rebuildPages()
+  }
+
+  /**
+   * 依据正文控件布局重建多页视觉：第 2..N 页白色背景、每页内容区参考线、
+   * 内容区底部的分页虚线 + 「分页」标签、每页「第 N 页」页码标签。
+   * 背景/参考线/分页线全部排在控件下方（控件 bringToFront），避免遮挡正文。
+   */
+  private rebuildPages(): void {
+    const count = Math.max(1, this.computePageCount())
+    const changed = count !== this.pageCount
+    this.pageCount = count
+    const stale = [
+      ...this.extraPageRects,
+      ...this.pageGuides,
+      ...this.pageBreaks,
+      ...this.pageLabels,
+    ]
+    for (const o of stale) this.canvas.remove(o)
+    this.extraPageRects = []
+    this.pageGuides = []
+    this.pageBreaks = []
+    this.pageLabels = []
+
+    const pageW = this.pageWidthMm * MM_TO_PX
+    const pageH = this.pageHeightMm * MM_TO_PX
+    const stride = pageH + this.PAGE_GAP_PX
+    const ml = this.marginMm.left * MM_TO_PX
+    const mt = this.marginMm.top * MM_TO_PX
+    const mr = this.marginMm.right * MM_TO_PX
+    const mb = this.marginMm.bottom * MM_TO_PX
+    const bodyH = Math.max(1, pageH - mt - mb)
+    const contentW = Math.max(1, pageW - ml - mr)
+    const bg = this.lastPageBackground || '#ffffff'
+
+    // 第 2..N 页背景（按 stride 堆叠，带阴影）
+    for (let i = 1; i < count; i++) {
+      const r = new Rect({
+        left: 0,
+        top: i * stride,
+        width: pageW,
+        height: pageH,
+        fill: bg,
+        selectable: false,
+        evented: false,
+        hoverCursor: 'default',
+        shadow: '0 2px 12px rgba(0,0,0,0.15)',
+        excludeFromExport: true,
+        objectCaching: false,
+      } as never)
+      ;(r as unknown as { isPageRect: boolean }).isPageRect = true
+      this.canvas.add(r)
+      this.extraPageRects.push(r)
+    }
+
+    // 每页内容区参考线（蓝色虚线）
+    for (let i = 0; i < count; i++) {
+      const g = new Rect({
+        left: ml,
+        top: i * stride + mt,
+        width: contentW,
+        height: bodyH,
+        fill: '',
+        stroke: '#1677ff',
+        strokeWidth: 1,
+        strokeDashArray: [4, 3],
+        selectable: false,
+        evented: false,
+        hoverCursor: 'default',
+        excludeFromExport: true,
+        objectCaching: false,
+      } as never)
+      ;(g as unknown as { isMarginGuide: boolean }).isMarginGuide = true
+      this.canvas.add(g)
+      this.pageGuides.push(g)
+    }
+
+    // 每页内容区底部的分页虚线（最后一页不画），并标注「分页」
+    for (let i = 0; i < count - 1; i++) {
+      const y = i * stride + mt + bodyH
+      const line = new Line([ml, y, ml + contentW, y], {
+        stroke: '#f5222d',
+        strokeWidth: 1,
+        strokeDashArray: [6, 4],
+        selectable: false,
+        evented: false,
+        excludeFromExport: true,
+        objectCaching: false,
+      } as never)
+      this.canvas.add(line)
+      this.pageBreaks.push(line)
+      const tag = new Text('分页', {
+        left: ml + 4,
+        top: y - 13,
+        fontSize: 9,
+        fill: '#f5222d',
+        selectable: false,
+        evented: false,
+        excludeFromExport: true,
+      } as never)
+      this.canvas.add(tag)
+      this.pageLabels.push(tag)
+    }
+
+    // 每页页码标签（左上角）
+    for (let i = 0; i < count; i++) {
+      const lbl = new Text(`第 ${i + 1} 页`, {
+        left: ml + 4,
+        top: i * stride + 4,
+        fontSize: 9,
+        fill: '#999999',
+        selectable: false,
+        evented: false,
+        excludeFromExport: true,
+      } as never)
+      this.canvas.add(lbl)
+      this.pageLabels.push(lbl)
+    }
+
+    // 【层级修复】背景/参考线/分页线全部排在正文控件之下，杜绝「第二页盖住控件」
+    for (const obj of this.getPrintObjects()) this.canvas.bringObjectToFront(obj)
+
+    this.canvas.requestRenderAll()
+    if (changed) this.events.onPageCountChange?.(count)
+  }
+
+  /** 正文控件布局变化后由外部调用，重算页数与分页线 */
+  refreshPages(): void {
+    this.rebuildPages()
+  }
+
+  /** 显示/隐藏页边距参考线（影响全部页） */
+  setMarginGuidesVisible(visible: boolean): void {
+    for (const g of this.pageGuides) g.visible = visible
+    this.canvas.requestRenderAll()
+  }
+
+  /**
+   * 应用页面设置。
+   * 【约定】PageSetup.width/height 一律是**物理尺寸**（实际打印宽高，横向时宽>高），
+   * orientation 仅是派生标志（UI 用）。方向切换由面板在改 width/height 时完成，
+   * 这里**不再**按 orientation 二次交换 —— 否则横向页会被换回纵向（旧 bug）。
+   * 渲染端 computePageMetrics / 导出 export-pdf 同口径（w>h 判定），全链路所见即所得。
+   */
+  setPage(setup: PageSetup): void {
+    this.pageWidthMm = toMm(setup.width, setup.unit)
+    this.pageHeightMm = toMm(setup.height, setup.unit)
+    this.marginMm = {
+      top: toMm(setup.margin.top, setup.unit),
+      bottom: toMm(setup.margin.bottom, setup.unit),
+      left: toMm(setup.margin.left, setup.unit),
+      right: toMm(setup.margin.right, setup.unit),
+    }
+    this.minPages = setup.minPages ?? 0
+    this.pageRect.set({
+      width: this.pageWidthMm * MM_TO_PX,
+      height: this.pageHeightMm * MM_TO_PX,
+      fill: this.lastPageBackground || '#ffffff',
+    })
+    // 页面尺寸变化：重建全部页视觉（背景/参考线/分页线/页码）后再注入水印
+    this.rebuildPages()
+    for (const z of this.getZones()) z.relayout(this.pageWidthMm, this.pageHeightMm)
+    this.syncWatermark()
+    this.canvas.requestRenderAll()
+  }
+
+  /** 设置画布页面背景色（不导出、随模板持久化）；同步填充所有页 */
+  setPageBackground(color: string): void {
+    this.lastPageBackground = color || '#ffffff'
+    this.pageRect.set({ fill: this.lastPageBackground })
+    for (const r of this.extraPageRects) r.set({ fill: this.lastPageBackground })
+    this.canvas.requestRenderAll()
+  }
+
+  /** 设置画布水印（enabled=false 时清空；tile=全页平铺 / 否则居中单个） */
+  setWatermark(cfg: WatermarkConfig | undefined): void {
+    this.lastWatermark = cfg && cfg.enabled ? cfg : undefined
+    this.syncWatermark()
+  }
+
+  /** 重建水印装饰层：先清旧对象，再按配置绘制 */
+  private syncWatermark(): void {
+    for (const o of this.watermarkObjs) this.canvas.remove(o)
+    this.watermarkObjs = []
+    const cfg = this.lastWatermark
+    if (!cfg) {
+      this.canvas.requestRenderAll()
+      return
+    }
+
+    const pageWpx = this.pageWidthMm * MM_TO_PX
+    const pageHpx = this.pageHeightMm * MM_TO_PX
+    const fontSizePx = Math.max(1, cfg.fontSize) * MM_TO_PX
+    const fontFamily = '"Source Han Sans CN", "PingFang SC", sans-serif'
+
+    if (cfg.tile) {
+      // 全页平铺：用离屏 canvas 生成单个旋转水印瓦片，作为 pageRect 之上的 Pattern
+      const spacingMm = Math.max(cfg.fontSize * 2.6, 14)
+      const tilePx = Math.max(1, Math.ceil(spacingMm * MM_TO_PX))
+      const tile = document.createElement('canvas')
+      tile.width = tilePx
+      tile.height = tilePx
+      const ctx = tile.getContext('2d')
+      if (ctx) {
+        ctx.clearRect(0, 0, tilePx, tilePx)
+        ctx.translate(tilePx / 2, tilePx / 2)
+        ctx.rotate((cfg.rotation * Math.PI) / 180)
+        ctx.fillStyle = cfg.color
+        ctx.font = `${fontSizePx}px ${fontFamily}`
+        ctx.textAlign = 'center'
+        ctx.textBaseline = 'middle'
+        ctx.fillText(cfg.text || '', 0, 0)
+      }
+      const pattern = new Pattern({ source: tile, repeat: 'repeat' })
+      const rect = new Rect({
+        left: 0,
+        top: 0,
+        width: pageWpx,
+        height: pageHpx,
+        fill: pattern as unknown as string,
+        selectable: false,
+        evented: false,
+        excludeFromExport: true,
+        objectCaching: false,
+      } as never)
+      ;(rect as unknown as { isWatermark: boolean }).isWatermark = true
+      this.canvas.insertAt(1, rect)
+      this.watermarkObjs.push(rect)
+    } else {
+      // 居中单个
+      const text = new Text(cfg.text || ' ', {
+        left: pageWpx / 2,
+        top: pageHpx / 2,
+        originX: 'center',
+        originY: 'center',
+        fontSize: fontSizePx,
+        fill: cfg.color,
+        fontFamily,
+        angle: cfg.rotation,
+        selectable: false,
+        evented: false,
+        excludeFromExport: true,
+      } as never)
+      ;(text as unknown as { isWatermark: boolean }).isWatermark = true
+      this.canvas.insertAt(1, text)
+      this.watermarkObjs.push(text)
+    }
+
+    this.canvas.requestRenderAll()
+  }
+
+  /** 页边距内容区左上角（画布 px）—— body 控件协议坐标的原点 */
+  get contentOriginPx(): { x: number; y: number } {
+    return { x: this.marginMm.left * MM_TO_PX, y: this.marginMm.top * MM_TO_PX }
+  }
+
+  /* ------------------------------- 控件 CRUD ------------------------------ */
+
+  getPrintObjects(): PrintFabricObject[] {
+    return this.canvas.getObjects().filter(isPrintObject) as PrintFabricObject[]
+  }
+
+  getControlById(id: string): PrintFabricObject | undefined {
+    return this.getPrintObjects().find((o) => o.controlId === id)
+  }
+
+  getZones(): PrintZone[] {
+    return this.getPrintObjects().filter((o): o is PrintZone => o instanceof PrintZone)
+  }
+
+  hasZone(zone: 'header' | 'footer'): boolean {
+    return this.getZones().some((z) => z.zone === zone)
+  }
+
+  addControl(
+    control: AnyControl,
+    opts: { select?: boolean; zoneHostId?: string } = {},
+  ): void {
+    const obj = createFabricControl(control, {
+      widthMm: this.pageWidthMm,
+      heightMm: this.pageHeightMm,
+    })
+    // 协议坐标（相对内容区/所属色带）→ 画布绝对坐标
+    this.applySectionOrigin(obj, control, opts.zoneHostId)
+    // 镜像「常驻辅助线」开关到 Fabric 对象，供 SmartGuides 读取
+    ;(obj as unknown as { showGuides: boolean }).showGuides = control.showGuides ?? false
+    this.canvas.add(obj)
+    if (opts.select ?? true) this.canvas.setActiveObject(obj)
+    this.refreshPages()
+    this.canvas.requestRenderAll()
+  }
+
+  /** 清空全部控件（保留页面矩形），加载模板前调用 */
+  clearControls(): void {
+    for (const obj of this.getPrintObjects()) this.canvas.remove(obj)
+    this.canvas.discardActiveObject()
+    this.refreshPages()
+    this.canvas.requestRenderAll()
+  }
+
+  /** body 控件加内容区偏移（含页间距）；zone 子控件加所属色带偏移（MVP：按几何中心归属） */
+  private applySectionOrigin(
+    obj: PrintFabricObject,
+    control: AnyControl,
+    zoneHostId?: string,
+  ): void {
+    if (control.type === 'zone') return
+    if (zoneHostId) {
+      const host = this.getControlById(zoneHostId)
+      if (host) {
+        // zone 子控件：相对色带左上角，无页间距
+        obj.set({
+          left: (Number.isFinite(obj.left) ? obj.left! : 0) + (host.left ?? 0),
+          top: (Number.isFinite(obj.top) ? obj.top! : 0) + (host.top ?? 0),
+        })
+      }
+    } else {
+      // body 控件：obj.top 此刻是 mm→px（相对页顶），modelTopToY 叠加内容区偏移与页间距
+      obj.set({
+        left: (Number.isFinite(obj.left) ? obj.left! : 0) + this.contentOriginPx.x,
+        top: this.modelTopToY((obj.top ?? 0) / MM_TO_PX),
+      })
+    }
+    obj.setCoords()
+  }
+
+  updateControl(control: AnyControl): void {
+    const obj = this.getControlById(control.id)
+    if (!obj) return
+    if (control.type !== 'zone') {
+      // 几何同步：协议 mm（相对内容区/所属色带）→ 画布绝对 px（含页间距）
+      const origin = this.originFor(obj)
+      obj.set({
+        left: origin.x + control.left * MM_TO_PX,
+        top: origin.y + control.top * MM_TO_PX + (obj instanceof PrintZone ? 0 : this.gapPx(control.top)),
+        angle: control.angle ?? 0,
+      })
+      if (obj instanceof PrintText) {
+        // 文本框：直接改宽度重排文字，不缩放字形
+        obj.set({ width: control.width * MM_TO_PX, scaleX: 1, scaleY: 1 })
+      } else if (obj.width && obj.height) {
+        // 其余控件：按目标尺寸等比缩放（Group/Line/位图均适用）
+        obj.set({
+          scaleX: (control.width * MM_TO_PX) / obj.width,
+          scaleY: (control.height * MM_TO_PX) / obj.height,
+        })
+      }
+      obj.setCoords()
+    }
+    ;(obj as IPrintObject).applyControlProps(control)
+    // 同步「常驻辅助线」开关到 Fabric 对象（控制面板实时切换即生效）
+    ;(obj as unknown as { showGuides: boolean }).showGuides = control.showGuides ?? false
+    this.refreshPages()
+    this.canvas.requestRenderAll()
+  }
+
+  /** 几何中心落在哪个色带内（§5.14.2 子控件坐标相对色带左上角） */
+  private hostZoneOf(obj: PrintFabricObject): PrintZone | undefined {
+    if (obj instanceof PrintZone) return undefined
+    const center = obj.getCenterPoint()
+    return this.getZones().find((z) => {
+      const b = z.getBoundingRect()
+      return (
+        center.x >= b.left && center.x <= b.left + b.width && center.y >= b.top && center.y <= b.top + b.height
+      )
+    })
+  }
+
+  /** 对象协议坐标原点：zone 子控件用色带左上角，其余用页边距内容区左上角 */
+  private originFor(obj: PrintFabricObject): { x: number; y: number } {
+    const host = this.hostZoneOf(obj)
+    if (host) return { x: host.left ?? 0, y: host.top ?? 0 }
+    return this.contentOriginPx
+  }
+
+  /**
+   * 读取 Fabric 对象为**协议控件**。
+   *
+   * 【重要】`obj.toControl()` 返回的 left/top 是 **Fabric 绝对画布坐标**，
+   * 而协议层 / store 模型一律是「相对内容区（或所属色带）左上角」的 mm。
+   * 任何要把画布状态写回 store 的路径都必须走本方法归一化，否则 `updateControl()`
+   * 会再叠加一次 origin，导致控件每次操作都向右下平移一个页边距。
+   */
+  readControl(obj: PrintFabricObject): AnyControl {
+    const control = obj.toControl()
+    if (obj instanceof PrintZone || control.type === 'zone') return control
+    const host = this.hostZoneOf(obj)
+    const origin = host ? { x: host.left ?? 0, y: host.top ?? 0 } : this.contentOriginPx
+    const abs = (v: number | undefined): number => (typeof v === 'number' && Number.isFinite(v) ? v : 0)
+    const rel = (v: number, o: number): number => Math.round(((v - o) / MM_TO_PX) * 100) / 100
+    const left = rel(abs(obj.left), origin.x)
+    // body 控件反解页间距（zone 子控件相对色带，间距恒为 0）
+    const top = host ? rel(abs(obj.top), origin.y) : Math.round(this.yToModelTop(abs(obj.top)) * 100) / 100
+    // 色带子控件不允许溢出到色带上方/左侧
+    control.left = host ? Math.max(0, left) : left
+    control.top = host ? Math.max(0, top) : top
+    return control
+  }
+
+  removeControl(id: string): void {
+    const obj = this.getControlById(id)
+    if (!obj) return
+    this.canvas.remove(obj)
+    this.canvas.discardActiveObject()
+    this.refreshPages()
+    this.canvas.requestRenderAll()
+  }
+
+  setActiveControl(id: string | null): void {
+    if (!id) {
+      this.canvas.discardActiveObject()
+    } else {
+      const obj = this.getControlById(id)
+      if (obj) this.canvas.setActiveObject(obj)
+    }
+    this.canvas.requestRenderAll()
+  }
+
+  /* ------------------------------- 序列化 -------------------------------- */
+
+  /**
+   * 导出当前画布为协议组件列表。
+   * zone 子控件归属判定：几何中心落在色带内（§5.14.2 子组件坐标相对色带左上角）。
+   */
+  serialize(): { body: AnyControl[]; zones: ZoneControl[] } {
+    const zones = this.getZones()
+    const zoneControls: ZoneControl[] = zones.map((z) => z.toControl())
+    const body: AnyControl[] = []
+
+    for (const obj of this.getPrintObjects()) {
+      if (obj instanceof PrintZone) continue
+      // readControl 已把几何归一化到「相对色带 / 相对内容区」
+      const control = this.readControl(obj)
+      const host = this.hostZoneOf(obj)
+      if (host) {
+        const zc = zoneControls.find((z) => z.zone === host.zone)
+        zc?.children.push(control)
+      } else {
+        body.push(control)
+      }
+    }
+    return { body, zones: zoneControls }
+  }
+
+  /* ------------------------------- 缩放平移 ------------------------------- */
+
+  get zoom(): number {
+    return this.canvas?.getZoom() ?? 1
+  }
+
+  setZoom(zoom: number, center?: Point): void {
+    this.userZoomed = true
+    const z = Math.min(ZOOM_MAX, Math.max(ZOOM_MIN, zoom))
+    const point =
+      center ?? new Point(this.canvas.getWidth() / 2, this.canvas.getHeight() / 2)
+    this.canvas.zoomToPoint(point, z)
+    this.emitViewport()
+  }
+
+  zoomIn(): void {
+    this.setZoom(this.zoom + 0.25)
+  }
+
+  zoomOut(): void {
+    this.setZoom(this.zoom - 0.25)
+  }
+
+  /** 适配容器：按页宽适配（上限 200%），文档可整页容纳则垂直居中，否则顶部对齐以便向下滚动翻页 */
+  fitToContainer(container: HTMLElement): void {
+    const pageW = this.pageWidthMm * MM_TO_PX
+    const stride = this.pageHeightMm * MM_TO_PX + this.PAGE_GAP_PX
+    const docH = this.pageCount * stride
+    const zoom = Math.min((container.clientWidth - 96) / pageW, 2)
+    const vt = this.canvas.viewportTransform
+    vt[0] = vt[3] = zoom
+    vt[4] = (container.clientWidth - pageW * zoom) / 2
+    const usedH = docH * zoom
+    vt[5] = usedH <= container.clientHeight - 96 ? Math.max(48, (container.clientHeight - usedH) / 2) : 48
+    this.canvas.setViewportTransform(vt)
+    this.canvas.requestRenderAll()
+    this.emitViewport()
+  }
+
+  /** 滚动视口使第 index 页（0 起）顶部对齐到视口上方（顶部留 48px） */
+  scrollToPage(index: number): void {
+    const stride = (this.pageHeightMm * MM_TO_PX + this.PAGE_GAP_PX) * this.zoom
+    const vt = this.canvas.viewportTransform
+    const viewH = this.canvas.getHeight()
+    const docH = this.pageCount * stride
+    const topY = Math.max(0, Math.min(index, this.pageCount - 1)) * stride
+    let y = 48 - topY
+    // 约束：不滚出文档顶部 / 底部
+    const maxY = 48
+    const minY = Math.min(maxY, viewH - docH - 48)
+    vt[5] = Math.max(Math.min(y, maxY), minY)
+    this.canvas.setViewportTransform(vt)
+    this.canvas.requestRenderAll()
+    this.emitViewport()
+  }
+
+  getViewportState(): ViewportState {
+    const vt = this.canvas.viewportTransform
+    return { zoom: this.zoom, offsetX: vt[4] ?? 0, offsetY: vt[5] ?? 0 }
+  }
+
+  private emitViewport(): void {
+    this.events.onViewportChange?.(this.getViewportState())
+    // 视口变化同样需要驱动表格 HTML overlay 重定位
+    this.events.onTransformTick?.()
+  }
+
+  /* -------------------------------- 事件 -------------------------------- */
+
+  private bindEvents(): void {
+    const c = this.canvas
+
+    const emitSelection = () => {
+      const active = c.getActiveObjects().filter(isPrintObject) as PrintFabricObject[]
+      this.events.onSelectionChange?.(active.map((o) => o.controlId))
+    }
+    c.on('selection:created', emitSelection)
+    c.on('selection:updated', emitSelection)
+    c.on('selection:cleared', () => this.events.onSelectionChange?.([]))
+
+    // 对象变换 / 视口变化 → 驱动表格 HTML overlay 重定位
+    const bump = () => this.events.onTransformTick?.()
+    c.on('object:moving', bump)
+    c.on('object:scaling', bump)
+    c.on('object:rotating', bump)
+    c.on('object:modified', bump)
+    c.on('object:added', bump)
+    c.on('object:removed', bump)
+
+    // 双击单元格：进入原生 contenteditable 编辑（方案 A）
+    c.on('mouse:dblclick', (opt) => {
+      const target = opt.target
+      if (!(target instanceof PrintTable)) return
+      // 必须用 readControl（相对坐标），直接 toControl() 会把绝对坐标写进 store 导致漂移
+      const control = this.readControl(target) as TableControl
+      const ensured = ensureCells(control)
+      // 场景坐标 → 控件局部坐标（先平移到左上角原点，再反向旋转，最后归一化）
+      const dx = opt.scenePoint.x - (target.left ?? 0)
+      const dy = opt.scenePoint.y - (target.top ?? 0)
+      const rad = (-(target.angle ?? 0) * Math.PI) / 180
+      const localX = dx * Math.cos(rad) - dy * Math.sin(rad)
+      const localY = dx * Math.sin(rad) + dy * Math.cos(rad)
+      const hit = hitTestCell(
+        computeGridLayout(ensured),
+        localX / Math.max(1e-6, target.getScaledWidth()),
+        localY / Math.max(1e-6, target.getScaledHeight()),
+      )
+      if (!hit) return
+      this.events.onCellEdit?.({ controlId: target.controlId, control: ensured, row: hit.row, col: hit.col })
+    })
+
+    c.on('object:modified', (e) => {
+      const obj = e.target
+      if (!obj || !isPrintObject(obj)) return
+      if (obj instanceof PrintZone) {
+        // zone 只允许改高度：把位置吸附回页顶/页底
+        obj.relayout(this.pageWidthMm, this.pageHeightMm)
+      }
+      // 位图类控件缩放结束后按新尺寸重渲染，保证清晰
+      const regenerable = obj as Partial<{ regenerate: () => void }>
+      if (typeof regenerable.regenerate === 'function' && !(obj instanceof PrintZone)) {
+        const scaledW = obj.getScaledWidth()
+        const scaledH = obj.getScaledHeight()
+        obj.set({ width: scaledW, height: scaledH, scaleX: 1, scaleY: 1 })
+        regenerable.regenerate()
+      }
+      this.events.onObjectModified?.(this.readControl(obj))
+      // 移动/缩放结束后正文布局可能跨页，刷新页数与分页线
+      this.refreshPages()
+    })
+
+    // Ctrl/Cmd + 滚轮缩放；普通滚轮 = 垂直平移；Shift+滚轮 = 水平平移
+    c.on('mouse:wheel', (opt: TPointerEventInfo<WheelEvent>) => {
+      const e = opt.e
+      e.preventDefault()
+      e.stopPropagation()
+      const vt = c.viewportTransform
+      if (e.ctrlKey || e.metaKey) {
+        const delta = e.deltaY
+        const zoom = this.zoom * 0.999 ** delta
+        this.setZoom(zoom, new Point(e.offsetX, e.offsetY))
+      } else {
+        if (e.shiftKey) {
+          vt[4] = (vt[4] ?? 0) - e.deltaY
+        } else {
+          vt[5] = (vt[5] ?? 0) - e.deltaY
+          vt[4] = (vt[4] ?? 0) - e.deltaX
+        }
+        c.setViewportTransform(vt)
+        c.requestRenderAll()
+        this.emitViewport()
+      }
+    })
+
+    // 空格 + 拖拽 = 平移
+    c.on('mouse:down', (opt) => {
+      if (this.spacePanning) {
+        const e = opt.e as MouseEvent
+        c.selection = false
+        c.defaultCursor = 'grab'
+        let lastX = e.clientX
+        let lastY = e.clientY
+        const move = (ev: MouseEvent) => {
+          const vt = c.viewportTransform
+          vt[4] = (vt[4] ?? 0) + (ev.clientX - lastX)
+          vt[5] = (vt[5] ?? 0) + (ev.clientY - lastY)
+          lastX = ev.clientX
+          lastY = ev.clientY
+          c.setViewportTransform(vt)
+          c.requestRenderAll()
+          this.emitViewport()
+        }
+        const up = () => {
+          window.removeEventListener('mousemove', move)
+          window.removeEventListener('mouseup', up)
+          c.selection = true
+          c.defaultCursor = 'default'
+        }
+        window.addEventListener('mousemove', move)
+        window.addEventListener('mouseup', up)
+      }
+    })
+
+    window.addEventListener('keydown', this.onKeyDown)
+    window.addEventListener('keyup', this.onKeyUp)
+  }
+
+  private onKeyDown = (e: KeyboardEvent): void => {
+    if (e.code === 'Space' && !this.isEditingText()) {
+      this.spacePanning = true
+      e.preventDefault()
+    }
+  }
+
+  private onKeyUp = (e: KeyboardEvent): void => {
+    if (e.code === 'Space') this.spacePanning = false
+  }
+
+  private isEditingText(): boolean {
+    const active = this.canvas.getActiveObject() as unknown as { isEditing?: boolean } | undefined
+    return !!active?.isEditing
+  }
+
+  /* ----------------------------- 网格控制 ------------------------------ */
+
+  setGridSize(sizeMm: number): void {
+    if (this.smartGuides) this.smartGuides.config.gridSizeMm = sizeMm
+  }
+
+  setGridColor(color: string): void {
+    if (this.smartGuides) this.smartGuides.config.gridColor = color
+    this.canvas.requestRenderAll()
+  }
+
+  setGridVisible(visible: boolean): void {
+    if (this.smartGuides) this.smartGuides.config.gridVisible = visible
+    this.canvas.requestRenderAll()
+  }
+}
diff --git a/openprint/src/design/canvas/CanvasStage.vue b/openprint/src/design/canvas/CanvasStage.vue
new file mode 100644
index 0000000..0edf1ea
--- /dev/null
+++ b/openprint/src/design/canvas/CanvasStage.vue
@@ -0,0 +1,109 @@
+<script setup lang="ts">
+/**
+ * CanvasStage —— 画布舞台：Fabric canvas + 标尺覆盖层 + 拖放接收
+ * DOM 结构遵循《标尺与辅助系统》§3.2：根元素 .canvas-stage，
+ * Fabric canvas 与 RulerOverlay 同级，标尺层 pointer-events:none。
+ */
+import { onBeforeUnmount, onMounted, ref, watch } from 'vue'
+import { useDesignerStore } from '@/design/stores/designer'
+import { useUiStore } from '@/design/stores/ui'
+import { useDragAdd } from '@/design/hooks/useDragAdd'
+import { useHotkey } from '@/design/hooks/useHotkey'
+import { loadBuiltinFonts } from '@/core/fonts/loader'
+import RulerOverlay from './rulers/RulerOverlay.vue'
+import TableViewLayer from './TableViewLayer.vue'
+import ChartViewLayer from './ChartViewLayer.vue'
+import { RULER_THICK } from '@/utils/constants'
+
+const store = useDesignerStore()
+const uiStore = useUiStore()
+
+const stageRef = ref<HTMLElement | null>(null)
+const canvasHostRef = ref<HTMLElement | null>(null)
+const canvasElRef = ref<HTMLCanvasElement | null>(null)
+const stageWidth = ref(0)
+const stageHeight = ref(0)
+/** 画布内核挂载就绪后再渲染表格 HTML overlay，避免 attachCanvas 前 getObjects() 取不到对象 */
+const canvasReady = ref(false)
+
+useDragAdd(canvasHostRef)
+useHotkey()
+
+// 页边距参考线显隐随 ui 开关联动（画布挂载后才生效）
+watch(
+  () => uiStore.showMarginGuides,
+  (v) => store.designer?.setMarginGuidesVisible(v),
+)
+
+// 网格显隐/间距/颜色随 gridConfig 联动（仅视觉参考，不吸附元素）
+watch(
+  () => store.gridConfig.visible,
+  (visible) => store.designer?.setGridVisible(visible),
+)
+watch(
+  () => store.gridConfig.sizeMm,
+  (sizeMm) => store.designer?.setGridSize(sizeMm),
+)
+watch(
+  () => store.gridConfig.color,
+  (color) => store.designer?.setGridColor(color),
+)
+
+let resizeObserver: ResizeObserver | null = null
+
+onMounted(() => {
+  if (!canvasElRef.value || !canvasHostRef.value || !stageRef.value) return
+  const host = canvasHostRef.value
+  stageWidth.value = host.clientWidth
+  stageHeight.value = host.clientHeight
+  store.attachCanvas(canvasElRef.value, host)
+  canvasReady.value = true
+  // 初始同步页边距参考线显隐开关
+  store.designer?.setMarginGuidesVisible(uiStore.showMarginGuides)
+  // 初始同步网格（视觉 + 间距 + 颜色；网格不吸附元素）
+  store.designer?.setGridVisible(store.gridConfig.visible)
+  store.designer?.setGridSize(store.gridConfig.sizeMm)
+  store.designer?.setGridColor(store.gridConfig.color)
+  // 内置字体（思源黑体/宋体/楷体等）注册到 document.fonts，加载完成后刷新画布让 Fabric 生效
+  void loadBuiltinFonts().then(() => {
+    document.fonts?.ready.then(() => store.designer?.canvas.requestRenderAll()).catch(() => undefined)
+  })
+  // 启动恢复：本地存储有上次保存的模板则加载（无后端全链路可用）
+  void store.restoreLastTemplate()
+  // dev 调试句柄
+  if (import.meta.env.DEV) {
+    ;(window as unknown as { __op: unknown }).__op = store
+  }
+
+  resizeObserver = new ResizeObserver(() => {
+    stageWidth.value = host.clientWidth
+    stageHeight.value = host.clientHeight
+  })
+  resizeObserver.observe(host)
+})
+
+onBeforeUnmount(() => {
+  resizeObserver?.disconnect()
+  store.detachCanvas()
+})
+</script>
+
+<template>
+  <div ref="stageRef" class="canvas-stage relative h-full w-full overflow-hidden bg-[#e8eaed]">
+    <!-- Fabric canvas 宿主（留出标尺厚度） -->
+    <div
+      ref="canvasHostRef"
+      class="absolute"
+      :style="{ top: `${RULER_THICK}px`, left: `${RULER_THICK}px`, right: '0', bottom: '0' }"
+    >
+      <canvas ref="canvasElRef" />
+      <!-- 表格 HTML overlay（方案 A）：与 Fabric 节点同步，平时不拦截指针 -->
+      <TableViewLayer v-if="canvasReady" />
+      <!-- 图表 SVG overlay（方案 A）：同上，原生 SVG 矢量覆盖 -->
+      <ChartViewLayer v-if="canvasReady" />
+    </div>
+
+    <!-- 标尺覆盖层（只看不拦截事件） -->
+    <RulerOverlay v-if="stageWidth > 0" :stage-width="stageWidth" :stage-height="stageHeight" />
+  </div>
+</template>
diff --git a/openprint/src/design/canvas/CellToolbar.vue b/openprint/src/design/canvas/CellToolbar.vue
new file mode 100644
index 0000000..ab876ba
--- /dev/null
+++ b/openprint/src/design/canvas/CellToolbar.vue
@@ -0,0 +1,620 @@
+<script setup lang="ts">
+/**
+ * CellToolbar —— 单元格浮动工具栏（方案 A）
+ *
+ * 双击进入单元格后浮在其上方，提供 ERP 报表最常用的单元格级能力：
+ * 字段绑定 / 字体族 / 字号 / 加粗斜体下划线 / 水平垂直对齐 / 文字色 / 填充色 / 横向合并 / 清除样式。
+ *
+ * 本组件**不直接改 store**：所有动作算出「新的表格控件」后 emit('apply')，
+ * 由 TableViewLayer 统一写回并刷新 overlay —— 保持单一写入口，撤销栈干净。
+ */
+import { computed } from 'vue'
+import {
+  NButton,
+  NButtonGroup,
+  NColorPicker,
+  NDivider,
+  NInput,
+  NInputNumber,
+  NSwitch,
+  NSelect,
+  NTooltip,
+} from 'naive-ui'
+import type { TableCell, TableCellStyle, TableControl, CellFormat, CellFormatKind } from '@/types/control'
+import {
+  buildDesignGrid,
+  insertTableColumn,
+  insertTableRow,
+  patchCell,
+  patchCellStyle,
+  removeTableColumn,
+  removeTableRow,
+  resolveCellStyle,
+  rowRoleLabel,
+  setCellRowSpan,
+  setCellSpan,
+} from '@/core/layout-engine/table-cells'
+import { FONT_CATALOG } from '@/core/fonts/catalog'
+import { useDataSourceStore } from '@/design/stores/dataSource'
+import {
+  formatKindOptions,
+  datePatternOptions,
+  currencyCodeOptions,
+  makeFormat,
+  needsPattern,
+  needsDigits,
+  needsCode,
+  supportsThousands,
+} from '@/design/format-options'
+
+const props = defineProps<{
+  control: TableControl
+  row: number
+  col: number
+  /** 行语义：header=表头 / data=数据样例行（影响整列）/ static=静态行 */
+  rowKind: 'header' | 'data' | 'static'
+  x: number
+  y: number
+}>()
+
+const emit = defineEmits<{
+  (e: 'apply', next: TableControl): void
+  (e: 'close'): void
+}>()
+
+const ds = useDataSourceStore()
+
+const grid = computed(() => buildDesignGrid(props.control))
+const cell = computed<TableCell>(() => grid.value.cells[props.row]?.[props.col] ?? {})
+const column = computed(() => props.control.columns[props.col])
+const style = computed<TableCellStyle>(() => resolveCellStyle(props.control, column.value, cell.value))
+
+const fontOptions = [
+  { label: '默认', value: '' },
+  ...FONT_CATALOG.map((f) => ({ label: f.label, value: f.family })),
+]
+
+/**
+ * 可绑定字段：
+ * - 数据样例行 → 明细表（数组）字段，运行期按行迭代
+ * - 表头 / 静态行 → 主表标量字段
+ */
+const fieldOptions = computed(() => {
+  const isDetail = props.rowKind === 'data'
+  const tables = ds.activeSource?.tables ?? []
+  const arrayTableIds = new Set(tables.filter((t) => t.isArray).map((t) => t.id))
+  const list = ds.flatFields.filter((f) => {
+    const inArray = f.tableId ? arrayTableIds.has(f.tableId) : f.path.includes('[]')
+    return isDetail ? inArray : !inArray
+  })
+  return [
+    { label: '（不绑定）', value: '' },
+    ...list.map((f) => ({ label: `${f.label}  ·  ${f.path}`, value: f.path })),
+  ]
+})
+
+/** 从单元格 expression（形如 {{order.no}}）反解出字段路径，用于下拉回显 */
+function fieldFromExpression(expr: string | undefined): string | undefined {
+  if (!expr) return undefined
+  const m = /^\{\{\s*([A-Za-z0-9_$.[\]]+)\s*\}\}$/.exec(expr.trim())
+  return m ? m[1] : undefined
+}
+
+const currentField = computed(
+  () =>
+    cell.value.field ??
+    fieldFromExpression(cell.value.expression) ??
+    (props.rowKind === 'data' ? (column.value?.field ?? '') : ''),
+)
+
+/** 仅绑定了字段/表达式的单元格才需要格式（纯静态文字格式无意义） */
+const canFormat = computed(
+  () =>
+    Boolean(cell.value.field || cell.value.expression) ||
+    (props.rowKind === 'data' && Boolean(column.value?.field || column.value?.expression)),
+)
+
+/** 生效中的格式（单元格优先，回落列默认） */
+const cellFormat = computed<CellFormat | undefined>(() => cell.value.format ?? column.value?.format)
+
+/* --------------------------------- 动作 -------------------------------- */
+
+function applyStyle(patch: TableCellStyle): void {
+  emit('apply', patchCellStyle(props.control, props.row, props.col, patch))
+}
+
+function toggle(key: 'bold' | 'italic' | 'underline'): void {
+  applyStyle({ [key]: !style.value[key] } as TableCellStyle)
+}
+
+/**
+ * 绑定字段。
+ * - 数据样例行：写 `field`（保留字段树给的 items[]. 前缀，运行期由 resolveBinding 去前缀逐行迭代）。
+ * - 表头 / 静态行：写 `{{path}}` 表达式 —— 与"动态数据用 {{path}}、否则纯文本"约定一致，渲染走插值。
+ * 字段绑定与自由表达式互斥，避免运行期语义打架。
+ */
+function bindField(path: string | null): void {
+  if (!path) {
+    // 解绑：清除字段与表达式，回落到原文字
+    emit(
+      'apply',
+      patchCell(props.control, props.row, props.col, {
+        field: undefined,
+        expression: undefined,
+        text: cell.value.text,
+      }),
+    )
+    return
+  }
+  if (props.rowKind === 'data') {
+    emit(
+      'apply',
+      patchCell(props.control, props.row, props.col, {
+        field: path,
+        expression: undefined,
+        text: undefined,
+      }),
+    )
+  } else {
+    emit(
+      'apply',
+      patchCell(props.control, props.row, props.col, {
+        expression: `{{${path}}}`,
+        field: undefined,
+        text: undefined,
+      }),
+    )
+  }
+}
+
+const spanMax = computed(() => grid.value.colCount - props.col)
+const currentSpan = computed(() => Math.min(cell.value.colSpan ?? 1, spanMax.value))
+
+function setSpan(n: number | null): void {
+  emit('apply', setCellSpan(props.control, props.row, props.col, n ?? 1))
+}
+
+/**
+ * 纵向合并（rowSpan）。
+ * 仅表头 / 静态 / 布局网格行生效：数据行由运行期逐条生成，跨行会跨越不同记录，语义不成立，
+ * 故数据样例行（rowKind==='data'）禁用该项，与表格引擎的"模板行强制 rowSpan=1"一致。
+ */
+const canRowSpan = computed(() => props.rowKind !== 'data')
+const rowSpanMax = computed(() => grid.value.rowCount - props.row)
+const currentRowSpan = computed(() => Math.min(cell.value.rowSpan ?? 1, rowSpanMax.value))
+
+function setRowSpan(n: number | null): void {
+  if (!canRowSpan.value) return
+  emit('apply', setCellRowSpan(props.control, props.row, props.col, n ?? 1))
+}
+
+function clearStyle(): void {
+  emit('apply', patchCell(props.control, props.row, props.col, { style: undefined }))
+}
+
+/** 单元格斜线（课表角标等）：无 / 左上→右下 / 左下→右上 */
+const diagOptions = [
+  { label: '无', value: 'none' },
+  { label: '↘ 右下', value: 'down' },
+  { label: '↗ 右上', value: 'up' },
+]
+const currentDiagonal = computed<'none' | 'down' | 'up'>(() => cell.value.style?.diagonal ?? 'none')
+function setDiagonal(v: 'none' | 'down' | 'up'): void {
+  applyStyle({ diagonal: v === 'none' ? undefined : v })
+}
+
+function applyFormat(fmt: CellFormat | undefined): void {
+  // kind='none' 视为清除，避免脏字段
+  emit('apply', patchCell(props.control, props.row, props.col, { format: fmt && fmt.kind !== 'none' ? fmt : undefined }))
+}
+
+function isPresetDatePattern(p?: string): boolean {
+  return Boolean(p && datePatternOptions.some((o) => o.value !== '__custom__' && o.value === p))
+}
+
+/** 行角色名（标题行 / 数据行 / 本页合计行 / 总计行 / 大写金额行），用于工具栏标签 */
+const roleLabel = computed(() => {
+  if (props.rowKind === 'data') return '数据行（影响整列）'
+  return rowRoleLabel(buildDesignGrid(props.control), props.row)
+})
+
+/* --------------------------------- 行列插入 -------------------------------- */
+
+function insertRowAbove(): void {
+  emit('apply', insertTableRow(props.control, props.row))
+}
+
+function insertRowBelow(): void {
+  emit('apply', insertTableRow(props.control, props.row + 1))
+}
+
+function insertColLeft(): void {
+  emit('apply', insertTableColumn(props.control, props.col))
+}
+
+function insertColRight(): void {
+  emit('apply', insertTableColumn(props.control, props.col + 1))
+}
+
+/** 删除本行 / 本列（数据表的数据样例行不可删，由 canDeleteRow 收敛） */
+const canDeleteRow = computed(
+  () => props.rowKind !== 'data' && grid.value.rowCount > 1,
+)
+const canDeleteCol = computed(() => grid.value.colCount > 1)
+
+function deleteRow(): void {
+  emit('apply', removeTableRow(props.control, props.row))
+}
+
+function deleteCol(): void {
+  emit('apply', removeTableColumn(props.control, props.col))
+}
+</script>
+
+<template>
+  <div
+    class="op-cell-toolbar"
+    :style="{ left: `${x}px`, top: `${y}px` }"
+    @mousedown.stop
+    @dblclick.stop
+  >
+    <div class="op-cell-toolbar__inner">
+      <!-- 第一行：字段绑定 / 字体 / 字形 / 对齐 -->
+      <div class="op-cell-toolbar__row">
+        <span class="op-cell-toolbar__tag">{{ roleLabel }}</span>
+
+        <NSelect
+          size="tiny"
+          class="w-24"
+          :value="currentField"
+          :options="fieldOptions"
+          filterable
+          placeholder="绑定字段"
+          @update:value="bindField"
+        />
+
+        <NDivider vertical />
+
+        <NSelect
+          size="tiny"
+          class="w-24"
+          :value="style.fontFamily ?? ''"
+          :options="fontOptions"
+          @update:value="(v: string) => applyStyle({ fontFamily: v || undefined })"
+        />
+        <NInputNumber
+          size="tiny"
+          class="w-18"
+          button-placement="both"
+          :value="style.fontSize ?? null"
+          :min="5"
+          :max="72"
+          :step="1"
+          placeholder="9"
+          @update:value="(v: number | null) => applyStyle({ fontSize: v ?? undefined })"
+        />
+
+        <NButtonGroup size="tiny">
+          <NTooltip trigger="hover">
+            <template #trigger>
+              <NButton :type="style.bold ? 'primary' : 'default'" @click="toggle('bold')">
+                <span class="font-bold">B</span>
+              </NButton>
+            </template>
+            加粗
+          </NTooltip>
+          <NTooltip trigger="hover">
+            <template #trigger>
+              <NButton :type="style.italic ? 'primary' : 'default'" @click="toggle('italic')">
+                <span class="italic font-serif">I</span>
+              </NButton>
+            </template>
+            斜体
+          </NTooltip>
+          <NTooltip trigger="hover">
+            <template #trigger>
+              <NButton :type="style.underline ? 'primary' : 'default'" @click="toggle('underline')">
+                <span class="underline">U</span>
+              </NButton>
+            </template>
+            下划线
+          </NTooltip>
+        </NButtonGroup>
+
+        <NButtonGroup size="tiny">
+          <NTooltip
+            v-for="a in (['left', 'center', 'right'] as const)"
+            :key="a"
+            trigger="hover"
+          >
+            <template #trigger>
+              <NButton
+                :type="style.align === a ? 'primary' : 'default'"
+                @click="applyStyle({ align: a })"
+              >
+                <span :class="`i-carbon-text-align-${a}`" />
+              </NButton>
+            </template>
+            {{ { left: '左对齐', center: '居中', right: '右对齐' }[a] }}
+          </NTooltip>
+        </NButtonGroup>
+
+        <NButtonGroup size="tiny">
+          <NTooltip
+            v-for="v in (['top', 'middle', 'bottom'] as const)"
+            :key="v"
+            trigger="hover"
+          >
+            <template #trigger>
+              <NButton
+                :type="style.valign === v ? 'primary' : 'default'"
+                @click="applyStyle({ valign: v })"
+              >
+                <span :class="`i-carbon-align-vertical-${v === 'middle' ? 'center' : v}`" />
+              </NButton>
+            </template>
+            {{ { top: '顶端对齐', middle: '垂直居中', bottom: '底端对齐' }[v] }}
+          </NTooltip>
+        </NButtonGroup>
+      </div>
+
+      <!-- 第二行：文字色 / 填充色 / 合并 / 清除 -->
+      <div class="op-cell-toolbar__row">
+        <!-- 文字颜色：自定义触发器 + to=false 让面板留在工具栏内，避免点选时工具栏被收起 -->
+        <NColorPicker
+          :value="style.color ?? '#1f2329'"
+          :show-alpha="false"
+          :modes="['hex']"
+          :to="false"
+          size="small"
+          @update:value="(v: string) => applyStyle({ color: v || undefined })"
+        >
+          <template #trigger="{ value, onClick, ref: triggerRef }">
+            <NButton :ref="triggerRef" size="tiny" quaternary title="文字颜色" @click="onClick">
+              <span class="i-carbon-text-color" />
+              <span class="op-cell-toolbar__swatch" :style="{ background: value || '#1f2329' }" />
+            </NButton>
+          </template>
+        </NColorPicker>
+
+        <!-- 填充颜色（含清除） -->
+        <NColorPicker
+          :value="style.backgroundColor ?? '#ffffff'"
+          :show-alpha="false"
+          :modes="['hex']"
+          :to="false"
+          size="small"
+          @update:value="(v: string) => applyStyle({ backgroundColor: v || undefined })"
+        >
+          <template #trigger="{ value, onClick, ref: triggerRef }">
+            <NButton :ref="triggerRef" size="tiny" quaternary title="填充颜色" @click="onClick">
+              <span class="i-carbon-paint-brush" />
+              <span
+                class="op-cell-toolbar__swatch"
+                :style="{ background: value || 'transparent' }"
+              />
+            </NButton>
+          </template>
+        </NColorPicker>
+        <NButton size="tiny" quaternary title="清除填充" @click="applyStyle({ backgroundColor: undefined })">
+          <span class="i-carbon-clean" />
+        </NButton>
+
+        <NTooltip trigger="hover">
+          <template #trigger>
+            <NSelect
+              size="tiny"
+              style="width: 92px"
+              :value="currentDiagonal"
+              :options="diagOptions"
+              @update:value="setDiagonal"
+            />
+          </template>
+          单元格斜线（课表角标）：无 / ↘左上→右下 / ↗左下→右上
+        </NTooltip>
+
+        <NDivider vertical />
+
+        <NTooltip trigger="hover">
+          <template #trigger>
+            <NInputNumber
+              size="tiny"
+              class="w-20"
+              button-placement="both"
+              :value="currentSpan"
+              :min="1"
+              :max="spanMax"
+              :step="1"
+              @update:value="setSpan"
+            />
+          </template>
+          横向合并列数
+        </NTooltip>
+
+        <NTooltip trigger="hover">
+          <template #trigger>
+            <NInputNumber
+              size="tiny"
+              class="w-20"
+              :value="currentRowSpan"
+              button-placement="both"
+              :min="1"
+              :max="rowSpanMax"
+              :step="1"
+              :disabled="!canRowSpan"
+              @update:value="setRowSpan"
+            />
+          </template>
+          纵向合并行数（数据行不跨行）
+        </NTooltip>
+
+        <NDivider vertical />
+
+        <NTooltip trigger="hover">
+          <template #trigger>
+            <NButton size="tiny" quaternary @click="clearStyle">
+              <span class="i-carbon-clean" />
+            </NButton>
+          </template>
+          清除本格样式
+        </NTooltip>
+
+        <NDivider vertical />
+
+        <span class="op-cell-toolbar__tag">行列</span>
+        <NTooltip trigger="hover">
+          <template #trigger>
+            <NButton size="tiny" quaternary title="上方插入行" @click="insertRowAbove">
+              <span class="i-carbon-arrow-up" />
+            </NButton>
+          </template>
+          上方插入行
+        </NTooltip>
+        <NTooltip trigger="hover">
+          <template #trigger>
+            <NButton size="tiny" quaternary title="下方插入行" @click="insertRowBelow">
+              <span class="i-carbon-arrow-down" />
+            </NButton>
+          </template>
+          下方插入行
+        </NTooltip>
+        <NTooltip trigger="hover">
+          <template #trigger>
+            <NButton size="tiny" quaternary title="左侧插入列" @click="insertColLeft">
+              <span class="i-carbon-arrow-left" />
+            </NButton>
+          </template>
+          左侧插入列
+        </NTooltip>
+        <NTooltip trigger="hover">
+          <template #trigger>
+            <NButton size="tiny" quaternary title="右侧插入列" @click="insertColRight">
+              <span class="i-carbon-arrow-right" />
+            </NButton>
+          </template>
+          右侧插入列
+        </NTooltip>
+
+        <NDivider vertical />
+
+        <NTooltip trigger="hover">
+          <template #trigger>
+            <NButton size="tiny" quaternary :disabled="!canDeleteRow" title="删除本行" @click="deleteRow">
+              <span class="i-carbon-trash-can" />
+            </NButton>
+          </template>
+          删除本行
+        </NTooltip>
+        <NTooltip trigger="hover">
+          <template #trigger>
+            <NButton size="tiny" quaternary :disabled="!canDeleteCol" title="删除本列" @click="deleteCol">
+              <span class="i-carbon-trash-can" />
+            </NButton>
+          </template>
+          删除本列
+        </NTooltip>
+
+        <NButton size="tiny" quaternary @click="emit('close')">
+          <span class="i-carbon-close" />
+        </NButton>
+      </div>
+
+      <!-- 第三行：数据格式（仅绑定字段的单元格） -->
+      <div v-if="canFormat" class="op-cell-toolbar__row op-cell-toolbar__format">
+        <span class="op-cell-toolbar__tag">格式</span>
+        <NSelect
+          size="tiny"
+          class="w-24"
+          :value="cellFormat?.kind ?? 'none'"
+          :options="formatKindOptions"
+          @update:value="(k: CellFormatKind) => applyFormat(k === 'none' ? undefined : makeFormat(k))"
+        />
+        <template v-if="cellFormat && cellFormat.kind !== 'none'">
+          <NSelect
+            v-if="needsPattern(cellFormat.kind)"
+            size="tiny"
+            class="w-30"
+            :value="isPresetDatePattern(cellFormat.pattern) ? cellFormat.pattern : '__custom__'"
+            :options="datePatternOptions"
+            @update:value="(v: string) => { if (v !== '__custom__') applyFormat({ ...cellFormat!, pattern: v }) }"
+          />
+          <NInput
+            v-if="needsPattern(cellFormat.kind) && !isPresetDatePattern(cellFormat.pattern)"
+            size="tiny"
+            class="w-30"
+            :value="cellFormat.pattern"
+            placeholder="如 YYYY年MM月DD日"
+            @update:value="(v: string) => applyFormat({ ...cellFormat!, pattern: v || 'YYYY-MM-DD' })"
+          />
+          <NInputNumber
+            v-if="needsDigits(cellFormat.kind)"
+            size="tiny"
+            class="w-16"
+            button-placement="both"
+            :value="cellFormat.digits ?? (cellFormat.kind === 'int' ? 0 : 2)"
+            :min="0"
+            :max="6"
+            @update:value="(v: number | null) => applyFormat({ ...cellFormat!, digits: v ?? 0 })"
+          />
+          <NSelect
+            v-if="needsCode(cellFormat.kind)"
+            size="tiny"
+            class="w-20"
+            :value="cellFormat.code ?? 'CNY'"
+            :options="currencyCodeOptions"
+            @update:value="(v: string) => applyFormat({ ...cellFormat!, code: v })"
+          />
+          <NSwitch
+            v-if="supportsThousands(cellFormat.kind)"
+            size="small"
+            :value="cellFormat.thousands ?? true"
+            @update:value="(v: boolean) => applyFormat({ ...cellFormat!, thousands: v })"
+          />
+        </template>
+      </div>
+    </div>
+  </div>
+</template>
+
+<style scoped>
+.op-cell-toolbar {
+  position: absolute;
+  transform: translateY(-100%) translateY(-8px);
+  pointer-events: auto;
+  z-index: 30;
+}
+
+.op-cell-toolbar__inner {
+  display: flex;
+  flex-direction: column;
+  gap: 4px;
+  padding: 4px 6px;
+  border-radius: 6px;
+  background: var(--brand-surface, #ffffff);
+  border: 1px solid var(--brand-border, #e5e6eb);
+  box-shadow: 0 4px 16px rgba(0, 0, 0, 0.12);
+  max-width: 92vw;
+}
+
+.op-cell-toolbar__row {
+  display: flex;
+  align-items: center;
+  flex-wrap: wrap;
+  gap: 4px;
+}
+
+.op-cell-toolbar__tag {
+  font-size: 11px;
+  color: var(--brand-text-secondary, #86909c);
+  padding-right: 2px;
+}
+
+.op-cell-toolbar__swatch {
+  display: inline-block;
+  width: 12px;
+  height: 12px;
+  border-radius: 2px;
+  border: 1px solid rgba(0, 0, 0, 0.15);
+  vertical-align: middle;
+}
+</style>
diff --git a/openprint/src/design/canvas/ChartViewLayer.vue b/openprint/src/design/canvas/ChartViewLayer.vue
new file mode 100644
index 0000000..b6f28f6
--- /dev/null
+++ b/openprint/src/design/canvas/ChartViewLayer.vue
@@ -0,0 +1,116 @@
+<script setup lang="ts">
+/**
+ * ChartViewLayer —— 图表 HTML/SVG overlay（方案 A 的载体）
+ *
+ * 与 TableViewLayer 同构：设计期图表**不**由 Fabric 画位图，而是用 chartkit 生成的
+ * 原生 SVG 绝对定位覆盖在画布上，transform 与 Fabric 节点 + 视口实时同步。
+ * SVG 字符串由 chartkit 生成，设计期与运行期导出共用同一份产物（设计即打印）。
+ *
+ * 图表数据由右侧属性面板编辑（而非单元格内联编辑），所以本层：
+ * - 平时整层 `pointer-events:none`，点击照旧落到 Fabric（选中 / 拖拽 / 缩放不受影响）
+ * - 不做 contenteditable / 工具栏，只负责把 SVG 画到位
+ */
+import { computed, ref } from 'vue'
+import { useDesignerStore } from '@/design/stores/designer'
+import { PrintChart } from './controls/PrintChart'
+import { renderChartControl } from '@/core/chartkit'
+import type { AnyControl, ChartControl } from '@/types/control'
+import { MM_TO_PX } from '@/utils/constants'
+
+const store = useDesignerStore()
+const layerRef = ref<HTMLElement | null>(null)
+
+interface OverlayItem {
+  id: string
+  x: number
+  y: number
+  zoom: number
+  angle: number
+  widthMm: number
+  heightMm: number
+  svg: string
+}
+
+/** 从 store 模型里取图表控件（overlay 渲染的数据真相源） */
+function controlById(id: string): ChartControl | undefined {
+  const flat: AnyControl[] = [...store.controls, ...store.zones.flatMap((z) => z.children)]
+  const hit = flat.find((c) => c.id === id)
+  return hit?.type === 'chart' ? (hit as ChartControl) : undefined
+}
+
+/**
+ * 每个图表一项：几何取自 Fabric 对象（拖拽/缩放实时），内容取自 store 模型。
+ * canvasTick 是显式依赖 —— Fabric 对象不是响应式的，靠画布事件驱动重算。
+ */
+const items = computed<OverlayItem[]>(() => {
+  void store.canvasTick
+  void store.controls
+  void store.zones
+  const d = store.designer
+  if (!d?.canvas) return []
+  const vt = d.canvas.viewportTransform
+  const zoom = vt[0] ?? 1
+  const offsetX = vt[4] ?? 0
+  const offsetY = vt[5] ?? 0
+  const out: OverlayItem[] = []
+  for (const obj of d.canvas.getObjects()) {
+    if (!(obj instanceof PrintChart)) continue
+    if (obj.visible === false) continue
+    const control = controlById(obj.controlId) ?? obj.toControl()
+    out.push({
+      id: obj.controlId,
+      x: (obj.left ?? 0) * zoom + offsetX,
+      y: (obj.top ?? 0) * zoom + offsetY,
+      zoom,
+      angle: obj.angle ?? 0,
+      widthMm: obj.getScaledWidth() / MM_TO_PX,
+      heightMm: obj.getScaledHeight() / MM_TO_PX,
+      svg: renderChartControl(control),
+    })
+  }
+  return out
+})
+
+function itemStyle(it: OverlayItem): Record<string, string> {
+  return {
+    transform: `translate(${it.x}px, ${it.y}px) rotate(${it.angle}deg) scale(${it.zoom})`,
+    width: `${it.widthMm}mm`,
+    height: `${it.heightMm}mm`,
+  }
+}
+</script>
+
+<template>
+  <div ref="layerRef" class="op-chart-overlay absolute inset-0 overflow-hidden">
+    <div
+      v-for="it in items"
+      :key="it.id"
+      class="op-chart-overlay__item"
+      :data-chart-id="it.id"
+      :style="itemStyle(it)"
+      v-html="it.svg"
+    />
+  </div>
+</template>
+
+<style scoped>
+.op-chart-overlay {
+  /* 平时完全透明于鼠标：所有交互照旧交给 Fabric */
+  pointer-events: none;
+}
+
+.op-chart-overlay__item {
+  position: absolute;
+  left: 0;
+  top: 0;
+  transform-origin: 0 0;
+  overflow: hidden;
+}
+
+/* SVG 填满宿主框，矢量随容器缩放清晰 */
+.op-chart-overlay__item :deep(svg) {
+  display: block;
+  width: 100%;
+  height: 100%;
+}
+</style>
diff --git a/openprint/src/design/canvas/TableViewLayer.vue b/openprint/src/design/canvas/TableViewLayer.vue
new file mode 100644
index 0000000..d91f946
--- /dev/null
+++ b/openprint/src/design/canvas/TableViewLayer.vue
@@ -0,0 +1,498 @@
+<script setup lang="ts">
+/**
+ * TableViewLayer —— 表格 HTML overlay（方案 A 的载体）
+ *
+ * 设计期表格不再由 Fabric 画位图，而是用**真 DOM 表格**绝对定位覆盖在画布上，
+ * transform 与 Fabric 节点（left/top/scale/angle）+ 视口（zoom/offset）实时同步。
+ * 由于渲染 HTML 与运行期 html-renderer 同构、CSS 来自同一个 `tableCss()`，
+ * 所以「设计所见」= 「打印所得」，且浏览器原生白送文本编辑 / 选区 / 键盘 / Excel 粘贴。
+ *
+ * 交互契约（关键）：
+ * - 平时整层 `pointer-events:none`，所有点击照旧落到 Fabric（选中 / 拖拽 / 缩放不受影响）
+ * - 双击表格 → Fabric 命中单元格 → store.editingCell 置位 → **仅该表**开启 pointer-events
+ *   与 contenteditable，进入单元格编辑；Esc / 点击别处退出
+ * - 编辑期间冻结该表 HTML（不因 store 变化重渲染），避免光标被吞
+ */
+import { computed, nextTick, onBeforeUnmount, onMounted, ref, watch } from 'vue'
+import { useDesignerStore } from '@/design/stores/designer'
+import { PrintTable } from './controls/PrintTable'
+import { renderTableGridHtml } from './table-design-render'
+import { tableCss } from '@/core/renderer-html/css-generator'
+import { buildDesignGrid, designRowInfo, patchCellText, rowRoleLabel } from '@/core/layout-engine/table-cells'
+import type { AnyControl, TableControl } from '@/types/control'
+import { MM_TO_PX } from '@/utils/constants'
+import CellToolbar from './CellToolbar.vue'
+
+const store = useDesignerStore()
+
+const layerRef = ref<HTMLElement | null>(null)
+/** 编辑中表格的冻结 HTML：编辑期间不随 store 重渲染，保护光标 */
+const frozenHtml = ref<string>('')
+const toolbarPos = ref<{ x: number; y: number } | null>(null)
+
+interface OverlayItem {
+  id: string
+  x: number
+  y: number
+  zoom: number
+  angle: number
+  widthMm: number
+  heightMm: number
+  html: string
+}
+
+const editingId = computed(() => store.editingCell?.controlId ?? null)
+
+/** 编辑行首列左侧的角色名标签（标题行 / 数据行 / 本页合计行 / 总计行 / 大写金额行）位置与文案 */
+const rowLabelPos = ref<{ x: number; y: number } | null>(null)
+const editingRowLabel = computed(() => {
+  const control = editingControl.value
+  const e = store.editingCell
+  if (!control || !e) return ''
+  return rowRoleLabel(buildDesignGrid(control), e.row)
+})
+
+/** 从 store 模型里取表格控件（overlay 写回的目标） */
+function controlById(id: string): TableControl | undefined {
+  const flat: AnyControl[] = [
+    ...store.controls,
+    ...store.zones.flatMap((z) => z.children),
+  ]
+  const hit = flat.find((c) => c.id === id)
+  return hit?.type === 'table' ? (hit as TableControl) : undefined
+}
+
+/**
+ * 每个表格一项：几何取自 Fabric 对象（拖拽/缩放过程中实时），内容取自 toControl()。
+ * canvasTick 是显式依赖 —— Fabric 对象不是响应式的，靠画布事件驱动重算。
+ */
+const items = computed<OverlayItem[]>(() => {
+  void store.canvasTick
+  void store.controls
+  void store.zones
+  const d = store.designer
+  if (!d?.canvas) return []
+  const vt = d.canvas.viewportTransform
+  const zoom = vt[0] ?? 1
+  const offsetX = vt[4] ?? 0
+  const offsetY = vt[5] ?? 0
+  const out: OverlayItem[] = []
+  for (const obj of d.canvas.getObjects()) {
+    if (!(obj instanceof PrintTable)) continue
+    if (obj.visible === false) continue
+    // 内容真相取自 store 模型（几何才从 Fabric 实时读），避免两边不同步
+    const control = controlById(obj.controlId) ?? obj.toControl()
+    out.push({
+      id: obj.controlId,
+      x: (obj.left ?? 0) * zoom + offsetX,
+      y: (obj.top ?? 0) * zoom + offsetY,
+      zoom,
+      angle: obj.angle ?? 0,
+      widthMm: obj.getScaledWidth() / MM_TO_PX,
+      heightMm: obj.getScaledHeight() / MM_TO_PX,
+      html:
+        obj.controlId === editingId.value && frozenHtml.value
+          ? frozenHtml.value
+          : renderTableGridHtml(control),
+    })
+  }
+  return out
+})
+
+function itemStyle(it: OverlayItem): Record<string, string> {
+  return {
+    // 先平移到节点屏幕坐标，再按节点角度旋转，最后套视口缩放 —— 顺序与 Fabric 完全一致
+    transform: `translate(${it.x}px, ${it.y}px) rotate(${it.angle}deg) scale(${it.zoom})`,
+    width: `${it.widthMm}mm`,
+    height: `${it.heightMm}mm`,
+  }
+}
+
+/* ------------------------------ 样式注入 ------------------------------ */
+
+// 与打印产物共用同一份表格 CSS（tableCss），只是限定在 overlay 作用域内
+const STYLE_ID = 'op-table-overlay-css'
+onMounted(() => {
+  if (document.getElementById(STYLE_ID)) return
+  const el = document.createElement('style')
+  el.id = STYLE_ID
+  el.textContent = tableCss('.op-table-overlay')
+  document.head.appendChild(el)
+})
+
+/* ------------------------------ 编辑会话 ------------------------------ */
+
+function wrapperOf(id: string): HTMLElement | null {
+  return layerRef.value?.querySelector<HTMLElement>(`[data-table-id="${CSS.escape(id)}"]`) ?? null
+}
+
+function tdOf(id: string, row: number, col: number): HTMLElement | null {
+  return wrapperOf(id)?.querySelector<HTMLElement>(`td[data-row="${row}"][data-col="${col}"]`) ?? null
+}
+
+function selectAll(el: HTMLElement): void {
+  const range = document.createRange()
+  range.selectNodeContents(el)
+  const sel = window.getSelection()
+  sel?.removeAllRanges()
+  sel?.addRange(range)
+}
+
+/** 会话开始：冻结 HTML → 开 contenteditable → 聚焦目标单元格并全选 */
+watch(
+  () => editingId.value,
+  async (id) => {
+    if (!id) {
+      frozenHtml.value = ''
+      toolbarPos.value = null
+      rowLabelPos.value = null
+      return
+    }
+    const control = controlById(id)
+    frozenHtml.value = control ? renderTableGridHtml(control) : ''
+    await nextTick()
+    enableEditing(id)
+    focusCell()
+  },
+)
+
+/** 编辑目标单元格变化（Tab / 点击别的格子）→ 移动工具栏 */
+watch(() => [store.editingCell?.row, store.editingCell?.col], () => void nextTick(syncToolbarPos))
+watch(() => store.canvasTick, () => syncToolbarPos())
+
+function enableEditing(id: string): void {
+  const wrap = wrapperOf(id)
+  if (!wrap) return
+  for (const td of wrap.querySelectorAll('td')) {
+    td.setAttribute('contenteditable', 'true')
+    td.setAttribute('spellcheck', 'false')
+  }
+}
+
+async function focusCell(): Promise<void> {
+  const e = store.editingCell
+  if (!e) return
+  await nextTick()
+  const td = tdOf(e.controlId, e.row, e.col)
+  if (!td) return
+  td.focus({ preventScroll: true })
+  selectAll(td)
+  syncToolbarPos()
+}
+
+function syncToolbarPos(): void {
+  const e = store.editingCell
+  const root = layerRef.value
+  if (!e || !root) {
+    toolbarPos.value = null
+    return
+  }
+  const td = tdOf(e.controlId, e.row, e.col)
+  if (!td) {
+    toolbarPos.value = null
+    return
+  }
+  const a = td.getBoundingClientRect()
+  const b = root.getBoundingClientRect()
+  toolbarPos.value = { x: a.left - b.left, y: a.top - b.top }
+  // 行名标签：锚定到当前行首列左侧
+  const firstTd = tdOf(e.controlId, e.row, 0)
+  if (firstTd) {
+    const fa = firstTd.getBoundingClientRect()
+    rowLabelPos.value = { x: fa.left - b.left, y: fa.top - b.top }
+  } else {
+    rowLabelPos.value = null
+  }
+}
+
+/* ------------------------------ 内容写回 ------------------------------ */
+
+/** 把某个 td 的文本提交到模型（未变化则不入撤销栈） */
+function commitTd(td: HTMLElement): void {
+  const id = td.closest<HTMLElement>('[data-table-id]')?.dataset.tableId
+  if (!id) return
+  const control = controlById(id)
+  if (!control) return
+  const row = Number(td.dataset.row)
+  const col = Number(td.dataset.col)
+  if (!Number.isFinite(row) || !Number.isFinite(col)) return
+  const next = patchCellText(control, row, col, td.innerText)
+  if (next === control) return
+  store.updateControl(id, next)
+}
+
+function onFocusIn(e: FocusEvent): void {
+  const td = (e.target as HTMLElement | null)?.closest<HTMLElement>('td[data-row]')
+  const id = td?.closest<HTMLElement>('[data-table-id]')?.dataset.tableId
+  if (!td || !id) return
+  store.openCellEditor(id, Number(td.dataset.row), Number(td.dataset.col))
+  void nextTick(syncToolbarPos)
+}
+
+function onFocusOut(e: FocusEvent): void {
+  const td = (e.target as HTMLElement | null)?.closest<HTMLElement>('td[data-row]')
+  if (td) commitTd(td)
+}
+
+/** Tab / Enter 的下一个目标单元格（跨行回绕，越界返回 null） */
+function nextCell(control: TableControl, row: number, col: number, dir: 1 | -1): { row: number; col: number } | null {
+  const grid = buildDesignGrid(control)
+  let r = row
+  let c = col + dir
+  if (c >= grid.colCount) {
+    c = 0
+    r += 1
+  } else if (c < 0) {
+    c = grid.colCount - 1
+    r -= 1
+  }
+  if (r < 0 || r >= grid.rowCount) return null
+  return { row: r, col: c }
+}
+
+async function moveTo(id: string, row: number, col: number): Promise<void> {
+  store.openCellEditor(id, row, col)
+  await nextTick()
+  const td = tdOf(id, row, col)
+  if (td) {
+    td.focus({ preventScroll: true })
+    selectAll(td)
+  }
+  syncToolbarPos()
+}
+
+function onKeyDown(e: KeyboardEvent): void {
+  const td = (e.target as HTMLElement | null)?.closest<HTMLElement>('td[data-row]')
+  const id = td?.closest<HTMLElement>('[data-table-id]')?.dataset.tableId
+  if (!td || !id) return
+
+  if (e.key === 'Escape') {
+    e.preventDefault()
+    e.stopPropagation()
+    commitTd(td)
+    exitEditing()
+    return
+  }
+  if (e.key === 'Tab') {
+    e.preventDefault()
+    commitTd(td)
+    const control = controlById(id)
+    if (!control) return
+    const to = nextCell(control, Number(td.dataset.row), Number(td.dataset.col), e.shiftKey ? -1 : 1)
+    if (to) void moveTo(id, to.row, to.col)
+    return
+  }
+  if (e.key === 'Enter' && !e.shiftKey) {
+    // Excel 习惯：回车提交并下移一行；末行则结束编辑
+    e.preventDefault()
+    commitTd(td)
+    const control = controlById(id)
+    if (!control) return
+    const grid = buildDesignGrid(control)
+    const r = Number(td.dataset.row) + 1
+    if (r < grid.rowCount) void moveTo(id, r, Number(td.dataset.col))
+    else exitEditing()
+  }
+}
+
+/** 粘贴：一律纯文本；含制表符/换行时按 Excel 语义铺到多个单元格 */
+function onPaste(e: ClipboardEvent): void {
+  const td = (e.target as HTMLElement | null)?.closest<HTMLElement>('td[data-row]')
+  const id = td?.closest<HTMLElement>('[data-table-id]')?.dataset.tableId
+  if (!td || !id) return
+  const text = e.clipboardData?.getData('text/plain') ?? ''
+  e.preventDefault()
+  if (!text) return
+
+  const matrix = text.replace(/\r\n?/g, '\n').replace(/\n$/, '').split('\n').map((line) => line.split('\t'))
+  if (matrix.length === 1 && matrix[0]!.length === 1) {
+    document.execCommand('insertText', false, matrix[0]![0]!)
+    return
+  }
+
+  const control = controlById(id)
+  if (!control) return
+  const grid = buildDesignGrid(control)
+  const baseRow = Number(td.dataset.row)
+  const baseCol = Number(td.dataset.col)
+  let next: TableControl = control
+  matrix.forEach((line, dr) => {
+    line.forEach((value, dc) => {
+      const r = baseRow + dr
+      const c = baseCol + dc
+      if (r >= grid.rowCount || c >= grid.colCount) return
+      next = patchCellText(next, r, c, value)
+    })
+  })
+  if (next !== control) {
+    store.updateControl(id, next)
+    refreshFrozen(id)
+  }
+}
+
+/* ------------------------------ 会话收尾 ------------------------------ */
+
+function exitEditing(): void {
+  const e = store.editingCell
+  if (e) {
+    const td = tdOf(e.controlId, e.row, e.col)
+    if (td) commitTd(td)
+  }
+  ;(document.activeElement as HTMLElement | null)?.blur?.()
+  store.closeCellEditor()
+}
+
+/** 工具栏改样式后重放 HTML（保留编辑态与焦点） */
+async function refreshFrozen(id: string): Promise<void> {
+  const control = controlById(id)
+  if (!control) return
+  frozenHtml.value = renderTableGridHtml(control)
+  await nextTick()
+  enableEditing(id)
+  void focusCell()
+}
+
+/**
+ * naive-ui 的浮层（下拉菜单 / 取色器 / 弹层）会被 teleport 到 body，
+ * 不在 overlay 内。点击它们时若走 onDocMouseDown 的"点外面就关闭"逻辑，
+ * 会在选项真正生效前就销毁工具栏，导致下拉交互（如单元格斜线）"点了没反应"。
+ * 因此对这类 teleport 浮层内的 mousedown 一律豁免，不结束编辑。
+ */
+const NAIVE_TELEPORT_SELECTOR =
+  '.n-base-select-menu, .n-color-picker, .n-popover, .n-dropdown-menu, .n-base-select, ' +
+  '.n-tooltip, .n-modal, .n-drawer, .n-message, .n-notification, .n-dialog, [class*="n-base-select"]'
+
+function isNaiveTeleportTarget(target: Node | null): boolean {
+  if (!target) return false
+  if (!(target instanceof Element)) {
+    const parent = target.parentElement
+    return parent ? isNaiveTeleportTarget(parent) : false
+  }
+  return Boolean(target.closest(NAIVE_TELEPORT_SELECTOR))
+}
+
+function onDocMouseDown(e: MouseEvent): void {
+  if (!store.editingCell) return
+  const target = e.target as Node | null
+  if (target && layerRef.value?.contains(target)) return
+  // naive-ui 浮层可能 teleport 到 body，点击它们不结束编辑
+  if (isNaiveTeleportTarget(target)) return
+  exitEditing()
+}
+
+onMounted(() => document.addEventListener('mousedown', onDocMouseDown, true))
+onBeforeUnmount(() => document.removeEventListener('mousedown', onDocMouseDown, true))
+
+/* ------------------------------ 工具栏动作 ------------------------------ */
+
+function onToolbarApply(next: TableControl): void {
+  const id = store.editingCell?.controlId
+  if (!id) return
+  store.updateControl(id, next)
+  void refreshFrozen(id)
+}
+
+const editingControl = computed<TableControl | null>(() => {
+  const id = editingId.value
+  return id ? (controlById(id) ?? null) : null
+})
+
+/** 当前编辑格的行语义（表头 / 数据样例 / 静态），工具栏据此调整可用项 */
+const editingRowKind = computed(() => {
+  const control = editingControl.value
+  const e = store.editingCell
+  if (!control || !e) return null
+  return designRowInfo(buildDesignGrid(control), e.row)
+})
+</script>
+
+<template>
+  <div
+    ref="layerRef"
+    class="op-table-overlay absolute inset-0 overflow-hidden"
+    @focusin="onFocusIn"
+    @focusout="onFocusOut"
+    @keydown="onKeyDown"
+    @paste="onPaste"
+  >
+    <div
+      v-for="it in items"
+      :key="it.id"
+      class="op-table-overlay__item"
+      :class="{ 'is-editing': it.id === editingId }"
+      :data-table-id="it.id"
+      :style="itemStyle(it)"
+      v-html="it.html"
+    />
+
+    <div
+      v-if="editingControl && store.editingCell && rowLabelPos"
+      class="op-row-label"
+      :style="{ left: `${rowLabelPos.x}px`, top: `${rowLabelPos.y}px` }"
+    >
+      {{ editingRowLabel }}
+    </div>
+
+    <CellToolbar
+      v-if="editingControl && store.editingCell && toolbarPos"
+      :control="editingControl"
+      :row="store.editingCell.row"
+      :col="store.editingCell.col"
+      :row-kind="editingRowKind?.kind ?? 'static'"
+      :x="toolbarPos.x"
+      :y="toolbarPos.y"
+      @apply="onToolbarApply"
+      @close="exitEditing"
+    />
+  </div>
+</template>
+
+<style scoped>
+.op-table-overlay {
+  /* 平时完全透明于鼠标：所有交互照旧交给 Fabric */
+  pointer-events: none;
+  /* 与打印产物同名的边框色变量，供 tableCss 注入的规则取用 */
+  --op-table-border: #333333;
+}
+
+.op-table-overlay__item {
+  position: absolute;
+  left: 0;
+  top: 0;
+  transform-origin: 0 0;
+  overflow: hidden;
+}
+
+.op-table-overlay__item.is-editing {
+  pointer-events: auto;
+  outline: 1px solid var(--brand-primary, #1677ff);
+  outline-offset: 1px;
+}
+
+/* v-html 内容不受 scoped 影响，需用 :deep 穿透 */
+.op-table-overlay__item :deep(table) {
+  margin: 0;
+}
+
+.op-table-overlay__item.is-editing :deep(td:focus) {
+  outline: 2px solid var(--brand-primary, #1677ff);
+  outline-offset: -2px;
+  background-color: rgba(22, 119, 255, 0.06);
+}
+
+/* 双击编辑时，首列左侧行角色名标签（标题行/数据行/本页合计行/总计行/大写金额行） */
+.op-row-label {
+  position: absolute;
+  transform: translateX(calc(-100% - 6px));
+  pointer-events: none;
+  font-size: 11px;
+  line-height: 1.4;
+  color: var(--brand-primary, #1677ff);
+  background: rgba(22, 119, 255, 0.1);
+  border: 1px solid var(--brand-primary, #1677ff);
+  border-radius: 4px;
+  padding: 1px 6px;
+  white-space: nowrap;
+  z-index: 29;
+}
+</style>
diff --git a/openprint/src/design/canvas/barcode-draw.ts b/openprint/src/design/canvas/barcode-draw.ts
new file mode 100644
index 0000000..9e20073
--- /dev/null
+++ b/openprint/src/design/canvas/barcode-draw.ts
@@ -0,0 +1,78 @@
+/**
+ * @bwip-js/generic → Canvas 2D 适配器
+ *
+ * 改用官方 toSVG() 生成条码（含人眼可读数字的人体化矢量路径，无字体依赖），
+ * 再栅格化到离屏 canvas 供 Fabric 显示。
+ * 原先的手写 CanvasDrawing 适配器对人眼可读文字的测量/绘制有缺陷，
+ * 导致画布上条码下方的数字不显示（预览走 toSVG 正常，故仅画布有此问题）。
+ */
+import * as BwipJs from '@bwip-js/generic'
+
+export interface BarcodeDrawOptions {
+  /** bwip-js bcid，如 code128 / ean13 */
+  format?: string
+  text: string
+  showText?: boolean
+  /** 条码条本身高度（mm）。bwip-js 的 height 选项只管条码条，不含文字行 */
+  barHeightMM?: number
+  /** 上下留白（mm），给文字行呼吸空间，避免贴边 */
+  paddingMM?: number
+}
+
+/** 把 bwip-js 的 SVG 字符串栅格化到离屏 canvas（人眼可读数字以矢量路径渲染，天然可见） */
+function svgToCanvas(svg: string): Promise<HTMLCanvasElement> {
+  return new Promise((resolve, reject) => {
+    const img = new Image()
+    const url = 'data:image/svg+xml;charset=utf-8,' + encodeURIComponent(svg)
+    img.onload = () => {
+      const w = img.naturalWidth || parseSvgSize(svg, 'width')
+      const h = img.naturalHeight || parseSvgSize(svg, 'height')
+      const canvas = document.createElement('canvas')
+      canvas.width = Math.max(1, w)
+      canvas.height = Math.max(1, h)
+      const ctx = canvas.getContext('2d')
+      if (!ctx) return reject(new Error('no 2d context'))
+      ctx.drawImage(img, 0, 0, canvas.width, canvas.height)
+      resolve(canvas)
+    }
+    img.onerror = () => reject(new Error('barcode svg decode failed'))
+    img.src = url
+  })
+}
+
+/** SVG 未带 width/height 时从 viewBox 兜底解析 */
+function parseSvgSize(svg: string, attr: 'width' | 'height'): number {
+  const vb = /viewBox="0 0 (\d+) (\d+)"/.exec(svg)
+  if (vb) return Number(vb[attr === 'width' ? 1 : 2]) || 1
+  const m = new RegExp(`${attr}="(\\d+)"`).exec(svg)
+  return m ? Number(m[1]) || 1 : 1
+}
+
+/**
+ * 渲染条码到离屏 canvas（失败返回 null，由调用方降级为占位）
+ *
+ * 关键：barHeightMM + paddingMM 让 bwip-js 直接按目标几何渲染，
+ * canvas 自然尺寸 ≈ 控件尺寸，调用方 scaleY ≈ 1，文字行不再被压扁。
+ * （原先只用 scale:3 生成自然尺寸位图，再被调用方 Y 方向压缩，导致文字看不见。）
+ */
+export async function drawBarcode(options: BarcodeDrawOptions): Promise<HTMLCanvasElement | null> {
+  try {
+    const barHeight = options.barHeightMM ?? 10
+    const padding = options.paddingMM ?? 2
+    const svg = BwipJs.toSVG({
+      bcid: (options.format ?? 'code128').toLowerCase(),
+      text: options.text || '0123456789',
+      scale: 2,
+      height: barHeight,
+      paddingtop: padding,
+      paddingbottom: padding,
+      includetext: options.showText ?? false,
+      textxalign: 'center',
+      // BWIPP textsize（单位 point，默认 9），调到 12 让人眼可读数字更醒目
+      textsize: 12,
+    })
+    return await svgToCanvas(svg)
+  } catch {
+    return null
+  }
+}
diff --git a/openprint/src/design/canvas/controls/PrintBarcode.ts b/openprint/src/design/canvas/controls/PrintBarcode.ts
new file mode 100644
index 0000000..497886a
--- /dev/null
+++ b/openprint/src/design/canvas/controls/PrintBarcode.ts
@@ -0,0 +1,105 @@
+/**
+ * PrintBarcode —— 条形码控件（§5.7，bwip-js 离屏渲染）
+ * 设计期用绑定路径占位文本渲染，运行期由渲染引擎注入真实值。
+ */
+import { FabricImage } from 'fabric'
+import type { BarcodeControl } from '@/types/control'
+import { mm, px, readBaseGeometry, type IPrintObject } from './PrintObject'
+import { drawBarcode } from '../barcode-draw'
+
+export class PrintBarcode extends FabricImage implements IPrintObject {
+  controlId: string
+  controlType = 'barcode' as const
+  zoneId?: string
+  printable = true
+  visibleIf?: string
+  controlName?: string
+
+  binding?: string
+  textValue?: string
+  format = 'CODE128'
+  showText = true
+
+  constructor(control: BarcodeControl) {
+    super(document.createElement('canvas'), {
+      left: mm(control.left),
+      top: mm(control.top),
+      angle: control.angle ?? 0,
+      lockMovementX: control.locked,
+      lockMovementY: control.locked,
+    })
+    this.controlId = control.id
+    this.binding = control.binding
+    this.textValue = control.value
+    this.format = control.format ?? 'CODE128'
+    this.showText = control.showText ?? true
+    this.printable = control.printable ?? true
+    this.visibleIf = control.visibleIf
+    this.controlName = control.name
+    // 初始尺寸（未缩放），regenerate 会按它换算 scale
+    this.set({ width: mm(control.width), height: mm(control.height) })
+    void this.regenerate()
+  }
+
+  /** 重新渲染条码位图，并按控件宽高缩放显示 */
+  async regenerate(): Promise<void> {
+    const w = this.width || 1
+    const h = this.height || 1
+    const text = this.textValue ?? (this.binding ? `{{${this.binding}}}` : '0123456789')
+    // 绑定占位符含中文/大括号无法编码，设计期用示例码代替
+    const encodable = /[{}\u4e00-\u9fa5]/.test(text) ? 'DEMO123456' : text
+    // 按控件几何反算条码条高度（mm）：条码条占 60%，剩 40% 留给文字行（textsize=12）+ 上下留白。
+    // 这样 bwip-js 直接按目标尺寸渲染，canvas 自然高度 ≈ 控件高度，scaleY ≈ 1，文字不被压扁。
+    const controlHeightMM = px(h)
+    const barHeightMM = Math.max(2, controlHeightMM * 0.6)
+    const paddingMM = Math.max(0.5, controlHeightMM * 0.04)
+    const canvas = await drawBarcode({
+      format: this.format,
+      text: encodable,
+      showText: this.showText,
+      barHeightMM,
+      paddingMM,
+    })
+    if (canvas) {
+      this.setElement(canvas)
+      // 宽度独立缩放填满控件；高度按 canvas 自然尺寸缩放（已接近控件高度，scaleY ≈ 1）。
+      // 不再强行 Y 方向压缩，避免文字行被挤没。
+      this.set({ scaleX: w / canvas.width, scaleY: h / canvas.height })
+    }
+    this.setCoords()
+    this.canvas?.requestRenderAll()
+  }
+
+  toControl(): BarcodeControl {
+    return {
+      ...readBaseGeometry(this),
+      type: 'barcode',
+      binding: this.binding,
+      value: this.textValue,
+      format: this.format,
+      showText: this.showText,
+      printable: this.printable,
+      visibleIf: this.visibleIf,
+      name: this.controlName,
+    }
+  }
+
+  applyControlProps(control: BarcodeControl): void {
+    this.binding = control.binding
+    this.textValue = control.value
+    this.format = control.format ?? 'CODE128'
+    this.showText = control.showText ?? true
+    this.printable = control.printable ?? true
+    this.visibleIf = control.visibleIf
+    this.controlName = control.name
+    this.set({
+      lockMovementX: control.locked,
+      lockMovementY: control.locked,
+      scaleX: 1,
+      scaleY: 1,
+      width: mm(control.width),
+      height: mm(control.height),
+    })
+    void this.regenerate()
+  }
+}
diff --git a/openprint/src/design/canvas/controls/PrintChart.ts b/openprint/src/design/canvas/controls/PrintChart.ts
new file mode 100644
index 0000000..ef6ee64
--- /dev/null
+++ b/openprint/src/design/canvas/controls/PrintChart.ts
@@ -0,0 +1,113 @@
+/**
+ * PrintChart —— 图表控件（《设计方案》图表控件提案）
+ *
+ * 与 PrintTable 同属【方案 A】：**视觉**完全交给 HTML overlay（ChartViewLayer.vue），
+ * 本 Fabric 对象退化为「透明宿主」——只承担选中 / 拖拽 / 缩放手柄 / 层级 / 序列化，
+ * 位图上仅画一圈极淡虚线轮廓作为兜底。SVG 矢量由 chartkit 生成，
+ * 设计期与运行期导出共用同一份产物（设计即打印）。
+ */
+import { FabricImage } from 'fabric'
+import type { ChartControl } from '@/types/control'
+import { mm, readBaseGeometry, type IPrintObject } from './PrintObject'
+
+/** overlay 兜底轮廓色（极淡，正常情况下被 overlay 的真实图表完全覆盖） */
+const GHOST_COLOR = 'rgba(120,130,145,0.35)'
+
+export class PrintChart extends FabricImage implements IPrintObject {
+  controlId: string
+  controlType = 'chart' as const
+  zoneId?: string
+  printable = true
+  visibleIf?: string
+  controlName?: string
+
+  kind: ChartControl['kind']
+  categories: string[]
+  series: ChartControl['series']
+  options: ChartControl['options']
+
+  /** true = 视觉交给 HTML overlay，位图只画兜底轮廓 */
+  htmlPreview = true
+
+  constructor(control: ChartControl) {
+    super(document.createElement('canvas'), {
+      left: mm(control.left),
+      top: mm(control.top),
+      angle: control.angle ?? 0,
+      lockMovementX: control.locked,
+      lockMovementY: control.locked,
+    })
+    this.controlId = control.id
+    this.kind = control.kind
+    this.categories = control.categories ?? []
+    this.series = control.series ?? []
+    this.options = control.options
+    this.printable = control.printable ?? true
+    this.visibleIf = control.visibleIf
+    this.controlName = control.name
+    this.set({ width: mm(control.width), height: mm(control.height) })
+    this.regenerate()
+  }
+
+  /** 重绘设计期预览（2x 分辨率保证缩放清晰） */
+  regenerate(): void {
+    const w = Math.max(this.width || 1, 10)
+    const h = Math.max(this.height || 1, 10)
+    const ratio = 2
+    const canvas = document.createElement('canvas')
+    canvas.width = Math.ceil(w * ratio)
+    canvas.height = Math.ceil(h * ratio)
+    const ctx = canvas.getContext('2d')!
+    ctx.scale(ratio, ratio)
+    this.drawGhost(ctx, w, h)
+    // setElement 会重置 width/height 为位图像素尺寸，缩放须在 setElement 之后按新尺寸计算
+    this.setElement(canvas)
+    this.set({ scaleX: w / canvas.width, scaleY: h / canvas.height })
+    this.setCoords()
+    this.canvas?.requestRenderAll()
+  }
+
+  /** overlay 模式：透明底 + 一圈极淡虚线，保证控件"存在感"且不与 overlay 抢像素 */
+  private drawGhost(ctx: CanvasRenderingContext2D, w: number, h: number): void {
+    ctx.clearRect(0, 0, w, h)
+    ctx.strokeStyle = GHOST_COLOR
+    ctx.lineWidth = 0.5
+    ctx.setLineDash([3, 3])
+    ctx.strokeRect(0.5, 0.5, w - 1, h - 1)
+    ctx.setLineDash([])
+  }
+
+  toControl(): ChartControl {
+    return {
+      ...readBaseGeometry(this),
+      id: this.controlId,
+      type: 'chart',
+      kind: this.kind,
+      categories: this.categories,
+      series: this.series,
+      options: this.options,
+      printable: this.printable,
+      visibleIf: this.visibleIf,
+      name: this.controlName,
+    }
+  }
+
+  applyControlProps(control: ChartControl): void {
+    this.kind = control.kind
+    this.categories = control.categories ?? []
+    this.series = control.series ?? []
+    this.options = control.options
+    this.printable = control.printable ?? true
+    this.visibleIf = control.visibleIf
+    this.controlName = control.name
+    this.set({
+      lockMovementX: control.locked,
+      lockMovementY: control.locked,
+      scaleX: 1,
+      scaleY: 1,
+      width: mm(control.width),
+      height: mm(control.height),
+    })
+    this.regenerate()
+  }
+}
diff --git a/openprint/src/design/canvas/controls/PrintCircle.ts b/openprint/src/design/canvas/controls/PrintCircle.ts
new file mode 100644
index 0000000..28f0d7a
--- /dev/null
+++ b/openprint/src/design/canvas/controls/PrintCircle.ts
@@ -0,0 +1,68 @@
+/**
+ * PrintCircle —— 圆形控件（复用 rect 协议模型，shape:'circle' 时以 Ellipse 渲染）
+ */
+import { Ellipse } from 'fabric'
+import type { RectControl } from '@/types/control'
+import { mm, readBaseGeometry, type IPrintObject } from './PrintObject'
+
+export class PrintCircle extends Ellipse implements IPrintObject {
+  controlId: string
+  controlType = 'rect' as const
+  zoneId?: string
+  printable = true
+  visibleIf?: string
+  controlName?: string
+
+  constructor(control: RectControl) {
+    super({
+      left: mm(control.left),
+      top: mm(control.top),
+      rx: mm(control.width) / 2,
+      ry: mm(control.height) / 2,
+      angle: control.angle ?? 0,
+      fill: control.fill ?? 'transparent',
+      stroke: control.stroke ?? '#000000',
+      strokeWidth: control.strokeWidth ?? 1,
+      strokeDashArray: control.strokeDashArray ?? undefined,
+      lockMovementX: control.locked,
+      lockMovementY: control.locked,
+    })
+    this.controlId = control.id
+    this.printable = control.printable ?? true
+    this.visibleIf = control.visibleIf
+    this.controlName = control.name
+  }
+
+  toControl(): RectControl {
+    return {
+      ...readBaseGeometry(this),
+      type: 'rect',
+      shape: 'circle',
+      fill: typeof this.fill === 'string' ? this.fill : undefined,
+      stroke: typeof this.stroke === 'string' ? this.stroke : undefined,
+      strokeWidth: this.strokeWidth,
+      strokeDashArray: this.strokeDashArray as number[] | undefined,
+      printable: this.printable,
+      visibleIf: this.visibleIf,
+      name: this.controlName,
+    }
+  }
+
+  applyControlProps(control: RectControl): void {
+    this.set({
+      rx: mm(control.width) / 2,
+      ry: mm(control.height) / 2,
+      fill: control.fill ?? 'transparent',
+      stroke: control.stroke ?? '#000000',
+      strokeWidth: control.strokeWidth ?? 1,
+      strokeDashArray: control.strokeDashArray ?? undefined,
+      lockMovementX: control.locked,
+      lockMovementY: control.locked,
+    })
+    this.printable = control.printable ?? true
+    this.visibleIf = control.visibleIf
+    this.controlName = control.name
+    this.setCoords()
+    this.canvas?.requestRenderAll()
+  }
+}
diff --git a/openprint/src/design/canvas/controls/PrintImage.ts b/openprint/src/design/canvas/controls/PrintImage.ts
new file mode 100644
index 0000000..aa5233e
--- /dev/null
+++ b/openprint/src/design/canvas/controls/PrintImage.ts
@@ -0,0 +1,140 @@
+/**
+ * PrintImage —— 图片控件（《设计方案》§5.8）
+ * inline/url/asset/binding 四种来源；无图时显示占位框。
+ */
+import { FabricImage, Rect, Group, Textbox, LayoutManager, FixedLayout } from 'fabric'
+import type { ImageControl } from '@/types/control'
+import { mm, readBaseGeometry, type IPrintObject } from './PrintObject'
+
+/**
+ * 图片控件用 Group 承载：底层是 Rect 占位框，加载成功后替换为 FabricImage。
+ * Group 方案对 "加载成功/失败/占位" 三态最稳。
+ */
+export class PrintImage extends Group implements IPrintObject {
+  controlId: string
+  controlType = 'image' as const
+  zoneId?: string
+  printable = true
+  visibleIf?: string
+  controlName?: string
+
+  value?: ImageControl['value']
+  fit: NonNullable<ImageControl['fit']> = 'contain'
+  cornerRadius?: number
+  /** 控件原始几何（mm），loadImage 时 Group width/height 失真的兜底 */
+  private _controlWidth = 0
+  private _controlHeight = 0
+
+  constructor(control: ImageControl) {
+    const w = mm(control.width)
+    const h = mm(control.height)
+    const placeholder = new Rect({
+      width: w,
+      height: h,
+      left: -w / 2,
+      top: -h / 2,
+      fill: 'rgba(22,119,255,0.06)',
+      stroke: '#c0c4cc',
+      strokeDashArray: [4, 3],
+      strokeWidth: 1,
+      rx: control.cornerRadius ?? 0,
+      ry: control.cornerRadius ?? 0,
+    })
+    const label = new Textbox(control.value?.mode === 'binding' ? `{{${control.value.content}}}` : '图片', {
+      left: -w / 2,
+      top: -8,
+      width: w,
+      fontSize: 11,
+      fill: '#909399',
+      textAlign: 'center',
+      selectable: false,
+      evented: false,
+    })
+    super([placeholder, label], {
+      left: mm(control.left),
+      top: mm(control.top),
+      angle: control.angle ?? 0,
+      lockMovementX: control.locked,
+      lockMovementY: control.locked,
+      // Group 默认 origin 是 center，与 Rect 默认 left/top 不同——统一用 left/top
+      originX: 'left',
+      originY: 'top',
+      // FixedLayout：add/remove 子对象时不重算 left/top，避免上传图片后控件跳位
+      layoutManager: new LayoutManager(new FixedLayout()),
+    })
+    this.controlId = control.id
+    this.value = control.value
+    this.fit = control.fit ?? 'contain'
+    this.cornerRadius = control.cornerRadius
+    this.printable = control.printable ?? true
+    this.visibleIf = control.visibleIf
+    this.controlName = control.name
+    this._controlWidth = control.width
+    this._controlHeight = control.height
+    // 从模板恢复时若已有图片内容，立即加载
+    void this.loadImage()
+  }
+
+  /** 异步加载真实图片替换占位（inline/url 来源；binding 设计期保持占位） */
+  async loadImage(): Promise<void> {
+    if (!this.value || this.value.mode === 'binding' || !this.value.content) return
+    // data: URL 不需要 crossOrigin；外部 URL 设 anonymous 避免画布污染
+    const isDataUrl = this.value.content.startsWith('data:')
+    const loadOpts = isDataUrl ? {} : { crossOrigin: 'anonymous' as const }
+    try {
+      const img = await FabricImage.fromURL(this.value.content, loadOpts)
+      // Group 的 width/height 可能在子对象变化后失真，用控件原始几何兜底
+      const w = this.width || mm(this._controlWidth)
+      const h = this.height || mm(this._controlHeight)
+      img.set({
+        left: -w / 2,
+        top: -h / 2,
+        originX: 'left',
+        originY: 'top',
+        scaleX: w / (img.width || w),
+        scaleY: h / (img.height || h),
+      })
+      this.remove(...this.getObjects())
+      this.add(img)
+      // Group.add 触发 enterGroup 会 inverse transform 子对象坐标，
+      // FixedLayout 下不再有 commitLayout 修正，需手动复位
+      img.set({ left: -w / 2, top: -h / 2 })
+      this.set({ width: w, height: h })
+      this.setCoords()
+      this.canvas?.requestRenderAll()
+    } catch {
+      // 加载失败保持占位框，不阻断设计器
+    }
+  }
+
+  toControl(): ImageControl {
+    return {
+      ...readBaseGeometry(this),
+      type: 'image',
+      value: this.value,
+      fit: this.fit,
+      cornerRadius: this.cornerRadius,
+      printable: this.printable,
+      visibleIf: this.visibleIf,
+      name: this.controlName,
+    }
+  }
+
+  applyControlProps(control: ImageControl): void {
+    this.value = control.value
+    this.fit = control.fit ?? 'contain'
+    this.cornerRadius = control.cornerRadius
+    this.printable = control.printable ?? true
+    this.visibleIf = control.visibleIf
+    this.controlName = control.name
+    this._controlWidth = control.width
+    this._controlHeight = control.height
+    this.set({
+      lockMovementX: control.locked,
+      lockMovementY: control.locked,
+    })
+    void this.loadImage()
+    this.setCoords()
+    this.canvas?.requestRenderAll()
+  }
+}
diff --git a/openprint/src/design/canvas/controls/PrintLine.ts b/openprint/src/design/canvas/controls/PrintLine.ts
new file mode 100644
index 0000000..433126d
--- /dev/null
+++ b/openprint/src/design/canvas/controls/PrintLine.ts
@@ -0,0 +1,67 @@
+/**
+ * PrintLine —— 线条控件
+ * Fabric Line 用 x1/y1/x2/y2 四点 + left/top 定位；
+ * 协议层只存外接框（left/top/width/height），MVP 仅支持水平/垂直线。
+ */
+import { Line } from 'fabric'
+import type { LineControl } from '@/types/control'
+import { mm, readBaseGeometry, type IPrintObject } from './PrintObject'
+
+export class PrintLine extends Line implements IPrintObject {
+  controlId: string
+  controlType = 'line' as const
+  zoneId?: string
+  printable = true
+  visibleIf?: string
+  controlName?: string
+
+  constructor(control: LineControl) {
+    // 水平线：width 有效、height≈0；垂直线反之（MVP）
+    const w = mm(control.width)
+    const h = mm(control.height)
+    const horizontal = h <= 1
+    super([0, 0, horizontal ? w : 0, horizontal ? 0 : h], {
+      left: mm(control.left),
+      top: mm(control.top),
+      angle: control.angle ?? 0,
+      stroke: control.stroke ?? '#000000',
+      strokeWidth: control.strokeWidth ?? 1,
+      strokeDashArray: control.strokeDashArray,
+      lockMovementX: control.locked,
+      lockMovementY: control.locked,
+    })
+    this.controlId = control.id
+    this.printable = control.printable ?? true
+    this.visibleIf = control.visibleIf
+    this.controlName = control.name
+  }
+
+  toControl(): LineControl {
+    const geo = readBaseGeometry(this)
+    return {
+      ...geo,
+      type: 'line',
+      stroke: typeof this.stroke === 'string' ? this.stroke : undefined,
+      strokeWidth: this.strokeWidth,
+      strokeDashArray: this.strokeDashArray ?? undefined,
+      printable: this.printable,
+      visibleIf: this.visibleIf,
+      name: this.controlName,
+    }
+  }
+
+  applyControlProps(control: LineControl): void {
+    this.set({
+      stroke: control.stroke ?? '#000000',
+      strokeWidth: control.strokeWidth ?? 1,
+      strokeDashArray: control.strokeDashArray,
+      lockMovementX: control.locked,
+      lockMovementY: control.locked,
+    })
+    this.printable = control.printable ?? true
+    this.visibleIf = control.visibleIf
+    this.controlName = control.name
+    this.setCoords()
+    this.canvas?.requestRenderAll()
+  }
+}
diff --git a/openprint/src/design/canvas/controls/PrintObject.ts b/openprint/src/design/canvas/controls/PrintObject.ts
new file mode 100644
index 0000000..98d30ae
--- /dev/null
+++ b/openprint/src/design/canvas/controls/PrintObject.ts
@@ -0,0 +1,66 @@
+/**
+ * PrintObject —— 所有打印控件的公共契约
+ *
+ * 设计约定（《设计方案》§8.1.2）：
+ * - 每个控件是 Fabric 子类，实例上挂 `controlId` 与 `controlType`
+ * - `toControl()` 把 Fabric 对象序列化回协议模型（px → mm 由这里统一换算）
+ * - 属性面板通过 `applyControlProps(control)` 把模型写回 Fabric 对象
+ *
+ * 坐标：协议层 mm（相对 Section 左上角）⇄ 画布层 px（MM_TO_PX，zoom=1）。
+ */
+import type { FabricObject } from 'fabric'
+import type { AnyControl, ControlType } from '@/types/control'
+import { MM_TO_PX } from '@/utils/constants'
+
+/** 所有打印控件实例都实现的接口 */
+export interface IPrintObject {
+  controlId: string
+  controlType: ControlType
+  /** 所属区域：body 或某个 zone 的 controlId */
+  zoneId?: string
+  toControl(): AnyControl
+  // 参数声明为 AnyControl（方法双变允许各子类收窄为自己的控件类型）
+  applyControlProps(control: AnyControl): void
+}
+
+export function isPrintObject(obj: unknown): obj is FabricObject & IPrintObject {
+  return (
+    typeof obj === 'object' &&
+    obj !== null &&
+    'controlId' in obj &&
+    'controlType' in obj &&
+    typeof (obj as IPrintObject).toControl === 'function'
+  )
+}
+
+/* ------------------------------ 几何换算 helpers ------------------------------ */
+
+export const mm = (v: number): number => v * MM_TO_PX
+export const px = (v: number): number => v / MM_TO_PX
+
+/**
+ * 读取对象的公共几何（px → mm），返回 ControlBase 的几何部分。
+ *
+ * 【坐标系警告】这里的 left/top 是 **Fabric 绝对画布坐标**（页面左上角为原点），
+ * 而协议层 / store 模型用的是「相对页边距内容区（或所属色带）左上角」。
+ * 因此 `toControl()` 的结果 **不可直接写回 store**，必须先经
+ * `CanvasDesigner.readControl(obj)` 归一化，否则 `updateControl()` 会再叠加
+ * 一次 origin，控件每次操作都向右下平移一个页边距。
+ */
+export function readBaseGeometry(obj: FabricObject & IPrintObject) {
+  // 兜底：fabric 对象的几何在异常时序下可能为 NaN/undefined（如 viewport 未就绪时
+  // 创建的对象），`?? 0` 对 NaN 无效，必须用 Number.isFinite 收敛，否则序列化回协议的
+  // left/top 带 NaN，写回 store 后 NInputNumber 会渲染删除线。
+  const r1 = (n: number): number => Math.round(n * 10) / 10
+  const num = (v: unknown): number => (typeof v === 'number' && Number.isFinite(v) ? v : 0)
+  return {
+    id: obj.controlId,
+    left: r1(px(num(obj.left))),
+    top: r1(px(num(obj.top))),
+    width: r1(px(num(obj.getScaledWidth()))),
+    height: r1(px(num(obj.getScaledHeight()))),
+    angle: num(obj.angle),
+  }
+}
+
+export const round2 = (n: number): number => Math.round(n * 100) / 100
diff --git a/openprint/src/design/canvas/controls/PrintQrcode.ts b/openprint/src/design/canvas/controls/PrintQrcode.ts
new file mode 100644
index 0000000..56b70c2
--- /dev/null
+++ b/openprint/src/design/canvas/controls/PrintQrcode.ts
@@ -0,0 +1,91 @@
+/**
+ * PrintQrcode —— 二维码控件（§5.7，qrcode 库离屏渲染）
+ */
+import { FabricImage } from 'fabric'
+import QRCode from 'qrcode'
+import type { QrcodeControl } from '@/types/control'
+import { mm, readBaseGeometry, type IPrintObject } from './PrintObject'
+
+export class PrintQrcode extends FabricImage implements IPrintObject {
+  controlId: string
+  controlType = 'qrcode' as const
+  zoneId?: string
+  printable = true
+  visibleIf?: string
+  controlName?: string
+
+  binding?: string
+  textValue?: string
+  errorLevel: 'L' | 'M' | 'Q' | 'H' = 'M'
+
+  constructor(control: QrcodeControl) {
+    super(document.createElement('canvas'), {
+      left: mm(control.left),
+      top: mm(control.top),
+      angle: control.angle ?? 0,
+      lockMovementX: control.locked,
+      lockMovementY: control.locked,
+    })
+    this.controlId = control.id
+    this.binding = control.binding
+    this.textValue = control.value
+    this.errorLevel = control.errorLevel ?? 'M'
+    this.printable = control.printable ?? true
+    this.visibleIf = control.visibleIf
+    this.controlName = control.name
+    this.set({ width: mm(control.width), height: mm(control.height) })
+    void this.regenerate()
+  }
+
+  async regenerate(): Promise<void> {
+    // 目标显示尺寸（逻辑 px）；setElement 会重置 width/height，先保存
+    const targetW = this.getScaledWidth() || 1
+    const targetH = this.getScaledHeight() || 1
+    const text = this.textValue ?? (this.binding ? `{{${this.binding}}}` : 'https://open-print.dev')
+    const canvas = document.createElement('canvas')
+    try {
+      await QRCode.toCanvas(canvas, text, {
+        width: Math.ceil(Math.max(targetW, targetH) * 2), // 2x 渲染保证缩放清晰
+        margin: 1,
+        errorCorrectionLevel: this.errorLevel,
+      })
+      this.setElement(canvas)
+      this.set({ scaleX: targetW / canvas.width, scaleY: targetH / canvas.height })
+    } catch {
+      // 内容过长等异常：保持空白占位
+    }
+    this.setCoords()
+    this.canvas?.requestRenderAll()
+  }
+
+  toControl(): QrcodeControl {
+    return {
+      ...readBaseGeometry(this),
+      type: 'qrcode',
+      binding: this.binding,
+      value: this.textValue,
+      errorLevel: this.errorLevel,
+      printable: this.printable,
+      visibleIf: this.visibleIf,
+      name: this.controlName,
+    }
+  }
+
+  applyControlProps(control: QrcodeControl): void {
+    this.binding = control.binding
+    this.textValue = control.value
+    this.errorLevel = control.errorLevel ?? 'M'
+    this.printable = control.printable ?? true
+    this.visibleIf = control.visibleIf
+    this.controlName = control.name
+    this.set({
+      lockMovementX: control.locked,
+      lockMovementY: control.locked,
+      scaleX: 1,
+      scaleY: 1,
+      width: mm(control.width),
+      height: mm(control.height),
+    })
+    void this.regenerate()
+  }
+}
diff --git a/openprint/src/design/canvas/controls/PrintRect.spec.ts b/openprint/src/design/canvas/controls/PrintRect.spec.ts
new file mode 100644
index 0000000..2af8fdc
--- /dev/null
+++ b/openprint/src/design/canvas/controls/PrintRect.spec.ts
@@ -0,0 +1,83 @@
+/**
+ * PrintRect 四角独立圆角路径几何验证。
+ *
+ * 用 node-canvas 直接执行 traceRoundRectPath（与 Fabric _render 的绘制约定一致：
+ * ctx 已平移到对象中心，坐标范围 -w/2 ~ w/2），抽样四角像素透明度，
+ * 确认「某角有半径、其余为 0」时只有该角被圆角化、其余保持直角。
+ */
+import { describe, expect, it } from 'vitest'
+import { createCanvas } from 'canvas'
+import { traceRoundRectPath } from './PrintRect'
+
+interface Corner {
+  /** 抽样点（相对对象左上角，单位 px），取靠近外缘但不在圆角切线内的位置 */
+  sampleX: number
+  sampleY: number
+}
+
+function renderAndSample(
+  w: number,
+  h: number,
+  tl: number,
+  tr: number,
+  br: number,
+  bl: number,
+): Record<'TL' | 'TR' | 'BR' | 'BL', boolean> {
+  const pad = 40
+  const cw = w + pad * 2
+  const ch = h + pad * 2
+  const canvas = createCanvas(cw, ch)
+  const ctx = canvas.getContext('2d')!
+  ctx.translate(cw / 2, ch / 2) // 模拟 Fabric 把原点移到对象中心
+  traceRoundRectPath(ctx as unknown as CanvasRenderingContext2D, w, h, tl, tr, br, bl)
+  ctx.fillStyle = '#000000'
+  ctx.fill()
+
+  const img = ctx.getImageData(0, 0, cw, ch)!.data
+  const alphaAt = (x: number, y: number): boolean => {
+    const idx = (Math.round(y) * cw + Math.round(x)) * 4 + 3
+    return (img[idx] ?? 0) > 10 // 不透明 = 属于形状内部
+  }
+
+  // 各角取样点：紧贴外缘、但位于「该角若有大圆角就会被切掉」的位置
+  const samples: Record<'TL' | 'TR' | 'BR' | 'BL', Corner> = {
+    TL: { sampleX: pad + 4, sampleY: pad + 4 },
+    TR: { sampleX: pad + w - 4, sampleY: pad + 4 },
+    BR: { sampleX: pad + w - 4, sampleY: pad + h - 4 },
+    BL: { sampleX: pad + 4, sampleY: pad + h - 4 },
+  }
+  const out = {} as Record<'TL' | 'TR' | 'BR' | 'BL', boolean>
+  for (const k of Object.keys(samples) as Array<keyof typeof samples>) {
+    out[k] = alphaAt(samples[k].sampleX, samples[k].sampleY)
+  }
+  return out
+}
+
+describe('PrintRect —— 四角独立圆角路径几何', () => {
+  const W = 160
+  const H = 100
+
+  it('仅左上角有半径时，只有 TL 被圆角化（取样点为透明）', () => {
+    const r = renderAndSample(W, H, 40, 0, 0, 0)
+    expect(r.TL).toBe(false) // 左上被切成圆角 → 角点透明
+    expect(r.TR).toBe(true) // 其余直角 → 角点不透明
+    expect(r.BR).toBe(true)
+    expect(r.BL).toBe(true)
+  })
+
+  it('四角全 0 时为标准直角矩形（四角均不透明）', () => {
+    const r = renderAndSample(W, H, 0, 0, 0, 0)
+    expect(r.TL && r.TR && r.BR && r.BL).toBe(true)
+  })
+
+  it('四角均设大半径时为全圆角（四角均透明）', () => {
+    const r = renderAndSample(W, H, 30, 30, 30, 30)
+    expect(r.TL && r.TR && r.BR && r.BL).toBe(false)
+  })
+
+  it('半径上限被夹紧到短边一半，不溢出（超大半径下四角仍正常）', () => {
+    const r = renderAndSample(W, H, 999, 999, 999, 999)
+    // 短边=H=100 → 上限 50；四角应被夹紧为圆角但形状完整
+    expect(r.TL && r.TR && r.BR && r.BL).toBe(false)
+  })
+})
diff --git a/openprint/src/design/canvas/controls/PrintRect.ts b/openprint/src/design/canvas/controls/PrintRect.ts
new file mode 100644
index 0000000..321ce30
--- /dev/null
+++ b/openprint/src/design/canvas/controls/PrintRect.ts
@@ -0,0 +1,152 @@
+/**
+ * PrintRect —— 矩形控件
+ *
+ * 圆角走「四角独立半径」绘制：Fabric 原生 Rect 仅支持统一 rx/ry，
+ * 这里重写 `_render`，用 arcTo 画出四角各自独立的圆角矩形路径，
+ * 单位 px（与协议 cornerRadius* 一致）。
+ */
+import { Rect } from 'fabric'
+import type { RectControl } from '@/types/control'
+import { mm, px, readBaseGeometry, type IPrintObject } from './PrintObject'
+
+/**
+ * 以对象中心为原点绘制四角独立圆角的矩形路径。
+ * ctx 进入时已被 Fabric 平移到对象中心（坐标范围 -w/2 ~ w/2），
+ * 半径单位为对象本地像素（drawing space，未乘 scaleX/scaleY）。
+ */
+export function traceRoundRectPath(
+  ctx: CanvasRenderingContext2D,
+  w: number,
+  h: number,
+  tl: number,
+  tr: number,
+  br: number,
+  bl: number,
+): void {
+  const x = -w / 2
+  const y = -h / 2
+  // 单角半径上限取短边一半，避免相邻圆角重叠产生扭曲
+  const maxR = Math.min(w, h) / 2
+  const clamp = (r: number): number => Math.max(0, Math.min(Math.round(r), maxR))
+  const a = clamp(tl)
+  const b = clamp(tr)
+  const c = clamp(br)
+  const d = clamp(bl)
+  ctx.beginPath()
+  ctx.moveTo(x + a, y)
+  ctx.lineTo(x + w - b, y)
+  if (b > 0) ctx.arcTo(x + w, y, x + w, y + b, b)
+  ctx.lineTo(x + w, y + h - c)
+  if (c > 0) ctx.arcTo(x + w, y + h, x + w - c, y + h, c)
+  ctx.lineTo(x + d, y + h)
+  if (d > 0) ctx.arcTo(x, y + h, x, y + h - d, d)
+  ctx.lineTo(x, y + a)
+  if (a > 0) ctx.arcTo(x, y, x + a, y, a)
+  ctx.closePath()
+}
+
+export class PrintRect extends Rect implements IPrintObject {
+  controlId: string
+  controlType = 'rect' as const
+  zoneId?: string
+  printable = true
+  visibleIf?: string
+  controlName?: string
+
+  /** 四角独立圆角（px），绘制时优先于 rx/ry */
+  cornerRadiusTL = 0
+  cornerRadiusTR = 0
+  cornerRadiusBR = 0
+  cornerRadiusBL = 0
+  /** 统一圆角（px），四角独立值统一回落基准 */
+  cornerRadius = 0
+
+  constructor(control: RectControl) {
+    const cr = control.cornerRadius ?? 0
+    super({
+      left: mm(control.left),
+      top: mm(control.top),
+      width: mm(control.width),
+      height: mm(control.height),
+      angle: control.angle ?? 0,
+      fill: control.fill ?? 'transparent',
+      stroke: control.stroke ?? '#000000',
+      strokeWidth: control.strokeWidth ?? 1,
+      rx: cr,
+      ry: cr,
+      strokeDashArray: control.strokeDashArray ?? undefined,
+      lockMovementX: control.locked,
+      lockMovementY: control.locked,
+    })
+    this.controlId = control.id
+    this.printable = control.printable ?? true
+    this.visibleIf = control.visibleIf
+    this.controlName = control.name
+    this.cornerRadiusTL = control.cornerRadiusTL ?? cr
+    this.cornerRadiusTR = control.cornerRadiusTR ?? cr
+    this.cornerRadiusBR = control.cornerRadiusBR ?? cr
+    this.cornerRadiusBL = control.cornerRadiusBL ?? cr
+    this.cornerRadius = cr
+  }
+
+  /** 四角独立圆角路径绘制（覆盖 Fabric 原生统一 rx/ry） */
+  _render(ctx: CanvasRenderingContext2D): void {
+    traceRoundRectPath(
+      ctx,
+      this.width,
+      this.height,
+      this.cornerRadiusTL,
+      this.cornerRadiusTR,
+      this.cornerRadiusBR,
+      this.cornerRadiusBL,
+    )
+    this._renderFill(ctx)
+    this._renderStroke(ctx)
+  }
+
+  toControl(): RectControl {
+    const cr = this.cornerRadius ?? 0
+    const out: RectControl = {
+      ...readBaseGeometry(this),
+      type: 'rect',
+      fill: typeof this.fill === 'string' ? this.fill : undefined,
+      stroke: typeof this.stroke === 'string' ? this.stroke : undefined,
+      strokeWidth: this.strokeWidth,
+      cornerRadius: cr || undefined,
+      strokeDashArray: this.strokeDashArray as number[] | undefined,
+      printable: this.printable,
+      visibleIf: this.visibleIf,
+      name: this.controlName,
+    }
+    // 仅当某角与统一值不一致时才落盘为独立覆盖值，保持 JSON 干净
+    if (this.cornerRadiusTL !== cr) out.cornerRadiusTL = this.cornerRadiusTL || undefined
+    if (this.cornerRadiusTR !== cr) out.cornerRadiusTR = this.cornerRadiusTR || undefined
+    if (this.cornerRadiusBR !== cr) out.cornerRadiusBR = this.cornerRadiusBR || undefined
+    if (this.cornerRadiusBL !== cr) out.cornerRadiusBL = this.cornerRadiusBL || undefined
+    return out
+  }
+
+  applyControlProps(control: RectControl): void {
+    const cr = control.cornerRadius ?? 0
+    this.cornerRadiusTL = control.cornerRadiusTL ?? cr
+    this.cornerRadiusTR = control.cornerRadiusTR ?? cr
+    this.cornerRadiusBR = control.cornerRadiusBR ?? cr
+    this.cornerRadiusBL = control.cornerRadiusBL ?? cr
+    this.cornerRadius = cr
+    this.set({
+      fill: control.fill ?? 'transparent',
+      stroke: control.stroke ?? '#000000',
+      strokeWidth: control.strokeWidth ?? 1,
+      rx: cr,
+      ry: cr,
+      strokeDashArray: control.strokeDashArray ?? undefined,
+      lockMovementX: control.locked,
+      lockMovementY: control.locked,
+    })
+    this.printable = control.printable ?? true
+    this.visibleIf = control.visibleIf
+    this.controlName = control.name
+    this.setCoords()
+    this.canvas?.requestRenderAll()
+  }
+}
diff --git a/openprint/src/design/canvas/controls/PrintRichText.ts b/openprint/src/design/canvas/controls/PrintRichText.ts
new file mode 100644
index 0000000..aef31ce
--- /dev/null
+++ b/openprint/src/design/canvas/controls/PrintRichText.ts
@@ -0,0 +1,149 @@
+/**
+ * PrintRichText —— 富文本控件（§5.8）
+ *
+ * 设计期显示：把富文本 HTML 消毒后包进 SVG `<foreignObject>`，
+ * 再栅格化成位图给 FabricImage 显示（与导出引擎同一技术路线，Chromium 限定）。
+ * 渲染期（预览/导出/打印）走 data-binder → html-renderer 的 `kind:'html'` 链路，
+ * 本类只负责画布上的"所见即所得"预览。
+ */
+import { FabricImage } from 'fabric'
+import DOMPurify from 'dompurify'
+import type { RichTextControl } from '@/types/control'
+import { mm, readBaseGeometry, type IPrintObject } from './PrintObject'
+import { toXmlSafe, svgToCanvas } from '@/core/export-engine/rasterize'
+
+/** 设计期默认字号（px，foreignObject 内继承） */
+const DESIGN_FONT_PX = 14
+
+export class PrintRichText extends FabricImage implements IPrintObject {
+  controlId: string
+  controlType = 'richtext' as const
+  zoneId?: string
+  printable = true
+  visibleIf?: string
+  controlName?: string
+
+  /** 富文本 HTML（协议字段 value） */
+  htmlValue?: string
+
+  /** 渲染序号：连续输入时只应用最新一次栅格化结果，防止旧结果覆盖新内容 */
+  private renderSeq = 0
+
+  constructor(control: RichTextControl) {
+    super(document.createElement('canvas'), {
+      left: mm(control.left),
+      top: mm(control.top),
+      angle: control.angle ?? 0,
+      lockMovementX: control.locked,
+      lockMovementY: control.locked,
+    })
+    this.controlId = control.id
+    this.htmlValue = control.value
+    this.printable = control.printable ?? true
+    this.visibleIf = control.visibleIf
+    this.controlName = control.name
+    // 初始尺寸（未缩放），regenerate 会按它换算 scale
+    this.set({ width: mm(control.width), height: mm(control.height) })
+    void this.regenerate()
+  }
+
+  /** 重新栅格化富文本位图，并按控件宽高缩放显示 */
+  async regenerate(): Promise<void> {
+    const w = this.width || 1
+    const h = this.height || 1
+    const seq = ++this.renderSeq
+    const canvas = await renderRichTextToCanvas(this.htmlValue ?? '', w, h)
+    if (seq !== this.renderSeq) return // 已有更新的渲染，丢弃过期结果
+    if (canvas) {
+      this.setElement(canvas)
+      this.set({ scaleX: w / canvas.width, scaleY: h / canvas.height })
+    }
+    this.setCoords()
+    this.canvas?.requestRenderAll()
+  }
+
+  toControl(): RichTextControl {
+    return {
+      ...readBaseGeometry(this),
+      type: 'richtext',
+      value: this.htmlValue,
+      printable: this.printable,
+      visibleIf: this.visibleIf,
+      locked: this.lockMovementX && this.lockMovementY ? true : undefined,
+      name: this.controlName,
+    }
+  }
+
+  applyControlProps(control: RichTextControl): void {
+    this.htmlValue = control.value
+    this.printable = control.printable ?? true
+    this.visibleIf = control.visibleIf
+    this.controlName = control.name
+    this.set({
+      lockMovementX: control.locked,
+      lockMovementY: control.locked,
+      scaleX: 1,
+      scaleY: 1,
+      width: mm(control.width),
+      height: mm(control.height),
+    })
+    void this.regenerate()
+  }
+}
+
+/* ------------------------------ 位图渲染 helpers ------------------------------ */
+
+/** 富文本 HTML → 设计期位图 canvas（失败降级为纯文本占位） */
+async function renderRichTextToCanvas(
+  html: string,
+  w: number,
+  h: number,
+): Promise<HTMLCanvasElement | null> {
+  try {
+    // 画布预览同样必须消毒（防模板注入），渲染期有 data-binder 二次消毒
+    const safe = toXmlSafe(DOMPurify.sanitize(html || '', { USE_PROFILES: { html: true } }))
+    const svg =
+      `<svg xmlns="http://www.w3.org/2000/svg" width="${Math.ceil(w)}" height="${Math.ceil(h)}">` +
+      `<foreignObject x="0" y="0" width="100%" height="100%">` +
+      `<div xmlns="http://www.w3.org/1999/xhtml" style="width:100%;height:100%;overflow:hidden;` +
+      `box-sizing:border-box;margin:0;padding:0;font:${DESIGN_FONT_PX}px system-ui,-apple-system,'PingFang SC','Microsoft YaHei',sans-serif;color:#000">` +
+      `${safe}</div></foreignObject></svg>`
+    return await svgToCanvas(svg, 1, '#ffffff')
+  } catch {
+    return drawFallback(stripHtml(html), w, h)
+  }
+}
+
+/** 降级占位：白底 + 纯文本（SVG 光栅化失败时保证画布上仍能看到内容） */
+function drawFallback(text: string, w: number, h: number): HTMLCanvasElement {
+  const canvas = document.createElement('canvas')
+  canvas.width = Math.max(1, Math.ceil(w))
+  canvas.height = Math.max(1, Math.ceil(h))
+  const ctx = canvas.getContext('2d')
+  if (!ctx) return canvas
+  ctx.fillStyle = '#ffffff'
+  ctx.fillRect(0, 0, canvas.width, canvas.height)
+  ctx.fillStyle = '#000000'
+  ctx.font = `${DESIGN_FONT_PX}px system-ui, sans-serif`
+  const lines = (text || '富文本').split('\n')
+  const maxLines = Math.max(1, Math.floor(canvas.height / (DESIGN_FONT_PX + 4)))
+  const step = DESIGN_FONT_PX + 4
+  for (let i = 0; i < Math.min(lines.length, maxLines); i++) {
+    ctx.fillText((lines[i] ?? '').slice(0, 80), 4, 4 + i * step)
+  }
+  return canvas
+}
+
+/** 剥标签 + 解码实体的纯文本提取（仅用于降级显示） */
+function stripHtml(html: string): string {
+  return String(html ?? '')
+    .replace(/<[^>]*>/g, '')
+    .replace(/&nbsp;/gi, ' ')
+    .replace(/&amp;/gi, '&')
+    .replace(/&lt;/gi, '<')
+    .replace(/&gt;/gi, '>')
+    .replace(/&quot;/gi, '"')
+    .replace(/&#39;/gi, "'")
+    .replace(/\s+/g, ' ')
+    .trim()
+}
diff --git a/openprint/src/design/canvas/controls/PrintTable.ts b/openprint/src/design/canvas/controls/PrintTable.ts
new file mode 100644
index 0000000..af65257
--- /dev/null
+++ b/openprint/src/design/canvas/controls/PrintTable.ts
@@ -0,0 +1,231 @@
+/**
+ * PrintTable —— 表格控件（《设计方案》§5.4）
+ *
+ * 【方案 A】表格的**视觉**由 HTML overlay（TableViewLayer.vue + table-design-render.ts）负责，
+ * 与运行期 html-renderer 共用同一套类名与样式语义，做到设计即打印、零漂移。
+ * 本 Fabric 对象退化为「透明宿主」：只承担选中 / 拖拽 / 缩放手柄 / 层级 / 序列化，
+ * 位图上仅画一圈极淡的虚线轮廓，作为 overlay 未就绪时的兜底提示。
+ *
+ * 若把 `htmlPreview` 置为 false（单测 / 降级），则回落到旧的 Fabric 2D 预览。
+ */
+import { FabricImage } from 'fabric'
+import type { TableCell, TableControl, TableColumn } from '@/types/control'
+import { mm, readBaseGeometry, type IPrintObject } from './PrintObject'
+import { ptToPx } from '@/core/units'
+
+const BORDER_COLOR = '#333333'
+const HEADER_BG = '#F5F7FA'
+const TEXT_COLOR = '#1f2329'
+const PLACEHOLDER_COLOR = '#606266'
+/** overlay 兜底轮廓色（极淡，正常情况下被 overlay 的真实边框完全覆盖） */
+const GHOST_COLOR = 'rgba(120,130,145,0.35)'
+
+export class PrintTable extends FabricImage implements IPrintObject {
+  controlId: string
+  controlType = 'table' as const
+  zoneId?: string
+  printable = true
+  visibleIf?: string
+  controlName?: string
+
+  dataSource?: string
+  /** 内嵌数据行（导入数据场景；与 dataSource 解耦，运行期直接作为表格数据） */
+  data?: Array<Record<string, unknown>>
+  columns: TableColumn[]
+  options: TableControl['options']
+
+  /** 设计期单元格网格（方案 A：双击可编辑的内容与样式载体） */
+  cells?: TableCell[][]
+  headerRows?: number
+  staticRows?: number
+  designRows?: number
+
+  /** true = 视觉交给 HTML overlay，位图只画兜底轮廓 */
+  htmlPreview = true
+
+  constructor(control: TableControl) {
+    super(document.createElement('canvas'), {
+      left: mm(control.left),
+      top: mm(control.top),
+      angle: control.angle ?? 0,
+      lockMovementX: control.locked,
+      lockMovementY: control.locked,
+    })
+    this.controlId = control.id
+    this.dataSource = control.dataSource
+    this.data = control.data
+    this.columns = control.columns
+    this.options = control.options
+    this.cells = control.cells
+    this.headerRows = control.headerRows
+    this.staticRows = control.staticRows
+    this.designRows = control.designRows
+    this.printable = control.printable ?? true
+    this.visibleIf = control.visibleIf
+    this.controlName = control.name
+    this.set({ width: mm(control.width), height: mm(control.height) })
+    this.regenerate()
+  }
+
+  /** 重绘设计期预览（2x 分辨率保证缩放清晰） */
+  regenerate(): void {
+    const w = Math.max(this.width || 1, 10)
+    const h = Math.max(this.height || 1, 10)
+    const ratio = 2
+    const canvas = document.createElement('canvas')
+    canvas.width = Math.ceil(w * ratio)
+    canvas.height = Math.ceil(h * ratio)
+    const ctx = canvas.getContext('2d')!
+    ctx.scale(ratio, ratio)
+
+    if (this.htmlPreview) {
+      this.drawGhost(ctx, w, h)
+    } else {
+      this.drawLegacyPreview(ctx, w, h, ratio)
+    }
+
+    // 注意：setElement 会把 width/height 重置为位图像素尺寸，缩放必须在 setElement 之后按新尺寸计算
+    this.setElement(canvas)
+    this.set({ scaleX: w / canvas.width, scaleY: h / canvas.height })
+    this.setCoords()
+    this.canvas?.requestRenderAll()
+  }
+
+  /** overlay 模式：透明底 + 一圈极淡虚线，保证控件"存在感"且不与 overlay 抢像素 */
+  private drawGhost(ctx: CanvasRenderingContext2D, w: number, h: number): void {
+    ctx.clearRect(0, 0, w, h)
+    ctx.strokeStyle = GHOST_COLOR
+    ctx.lineWidth = 0.5
+    ctx.setLineDash([3, 3])
+    ctx.strokeRect(0.5, 0.5, w - 1, h - 1)
+    ctx.setLineDash([])
+  }
+
+  /** 旧版 Fabric 2D 预览（降级路径，行为与方案 A 之前一致） */
+  private drawLegacyPreview(ctx: CanvasRenderingContext2D, w: number, h: number, ratio: number): void {
+    ctx.fillStyle = '#ffffff'
+    ctx.fillRect(0, 0, w, h)
+
+    const headerH = Math.min(28, h * 0.3)
+    const dataRowH = Math.min(24, (h - headerH) / 4)
+    const fontSize = ptToPx(9)
+
+    // 列宽按比例分配（协议列宽是 mm，控件宽是 px，归一化即可）
+    const totalColMm = this.columns.reduce((s, c) => s + c.width, 0) || 1
+    const colXs: number[] = [0]
+    for (const col of this.columns) {
+      colXs.push(colXs[colXs.length - 1]! + (col.width / totalColMm) * w)
+    }
+
+    // 表头
+    ctx.fillStyle = HEADER_BG
+    ctx.fillRect(0, 0, w, headerH)
+    ctx.font = `bold ${fontSize}px "Source Han Sans CN", "PingFang SC", sans-serif`
+    ctx.fillStyle = TEXT_COLOR
+    ctx.textBaseline = 'middle'
+    this.columns.forEach((col, i) => {
+      const x0 = colXs[i]!
+      const cw = colXs[i + 1]! - x0
+      ctx.save()
+      ctx.beginPath()
+      ctx.rect(x0, 0, cw, headerH)
+      ctx.clip()
+      const tx = col.headerAlign === 'center' || (!col.headerAlign && col.align === 'center')
+        ? x0 + cw / 2
+        : col.headerAlign === 'right' || (!col.headerAlign && col.align === 'right')
+          ? x0 + cw - 4
+          : x0 + 4
+      ctx.textAlign = col.headerAlign ?? col.align ?? 'left'
+      ctx.fillText(col.title || '　', tx, headerH / 2)
+      ctx.restore()
+    })
+
+    // 示例数据行（绑定字段占位符）
+    ctx.font = `${fontSize}px "Source Han Sans CN", "PingFang SC", sans-serif`
+    this.columns.forEach((col, i) => {
+      const x0 = colXs[i]!
+      const cw = colXs[i + 1]! - x0
+      const cellText = col.expression ?? (col.field ? `{{item.${col.field}}}` : '')
+      if (!cellText) return
+      ctx.save()
+      ctx.beginPath()
+      ctx.rect(x0, headerH, cw, dataRowH)
+      ctx.clip()
+      ctx.fillStyle = PLACEHOLDER_COLOR
+      ctx.textAlign = col.align ?? 'left'
+      const tx = col.align === 'center' ? x0 + cw / 2 : col.align === 'right' ? x0 + cw - 4 : x0 + 4
+      ctx.fillText(cellText, tx, headerH + dataRowH / 2)
+      ctx.restore()
+    })
+
+    // 边框线
+    const borders = this.options?.borders ?? 'all'
+    ctx.strokeStyle = BORDER_COLOR
+    ctx.lineWidth = 1 / ratio > 0.5 ? 1 : 0.75
+    if (borders !== 'none') {
+      ctx.strokeRect(0.5, 0.5, w - 1, h - 1)
+      ctx.beginPath()
+      ctx.moveTo(0, headerH)
+      ctx.lineTo(w, headerH)
+      ctx.stroke()
+      if (borders === 'all') {
+        for (let i = 1; i < colXs.length - 1; i++) {
+          ctx.beginPath()
+          ctx.moveTo(colXs[i]!, 0)
+          ctx.lineTo(colXs[i]!, h)
+          ctx.stroke()
+        }
+        for (let r = 1; r <= 2; r++) {
+          const y = headerH + dataRowH * r
+          if (y < h) {
+            ctx.beginPath()
+            ctx.moveTo(0, y)
+            ctx.lineTo(w, y)
+            ctx.stroke()
+          }
+        }
+      }
+    }
+  }
+
+  toControl(): TableControl {
+    return {
+      ...readBaseGeometry(this),
+      type: 'table',
+      dataSource: this.dataSource,
+      data: this.data,
+      columns: this.columns,
+      options: this.options,
+      cells: this.cells,
+      headerRows: this.headerRows,
+      staticRows: this.staticRows,
+      designRows: this.designRows,
+      printable: this.printable,
+      visibleIf: this.visibleIf,
+      name: this.controlName,
+    }
+  }
+
+  applyControlProps(control: TableControl): void {
+    this.dataSource = control.dataSource
+    this.data = control.data
+    this.columns = control.columns
+    this.options = control.options
+    this.cells = control.cells
+    this.headerRows = control.headerRows
+    this.staticRows = control.staticRows
+    this.designRows = control.designRows
+    this.printable = control.printable ?? true
+    this.visibleIf = control.visibleIf
+    this.controlName = control.name
+    this.set({
+      lockMovementX: control.locked,
+      lockMovementY: control.locked,
+      scaleX: 1,
+      scaleY: 1,
+      width: mm(control.width),
+      height: mm(control.height),
+    })
+    this.regenerate()
+  }
+}
diff --git a/openprint/src/design/canvas/controls/PrintText.ts b/openprint/src/design/canvas/controls/PrintText.ts
new file mode 100644
index 0000000..d83e72e
--- /dev/null
+++ b/openprint/src/design/canvas/controls/PrintText.ts
@@ -0,0 +1,111 @@
+/**
+ * PrintText —— 文本控件（《设计方案》§5.2 / §5.3）
+ * 基于 fabric.Textbox：对齐/字体/颜色均为原生属性。
+ * 字号协议层是 pt，Fabric 用 px，此处统一换算。
+ */
+import { Textbox } from 'fabric'
+import type { TextControl, TextStyle } from '@/types/control'
+import { ptToPx, pxToPt } from '@/core/units'
+import { mm, px, readBaseGeometry, round2, type IPrintObject } from './PrintObject'
+
+export class PrintText extends Textbox implements IPrintObject {
+  controlId: string
+  controlType = 'text' as const
+  zoneId?: string
+
+  /** 协议 extras（设计期保留，显示文本只是占位） */
+  binding?: string
+  expression?: string
+  controlFormat?: TextControl['format']
+  printable = true
+  visibleIf?: string
+  controlName?: string
+
+  constructor(control: TextControl) {
+    super(displayText(control), {
+      left: mm(control.left),
+      top: mm(control.top),
+      width: mm(control.width),
+      angle: control.angle ?? 0,
+      ...styleToFabric(control.style),
+      lockMovementX: control.locked,
+      lockMovementY: control.locked,
+    })
+    this.controlId = control.id
+    this.zoneId = undefined
+    this.binding = control.binding
+    this.expression = control.expression
+    this.controlFormat = control.format
+    this.printable = control.printable ?? true
+    this.visibleIf = control.visibleIf
+    this.controlName = control.name
+  }
+
+  /** 序列化回协议模型（px → mm / px → pt） */
+  toControl(): TextControl {
+    return {
+      ...readBaseGeometry(this),
+      type: 'text',
+      value: this.binding || this.expression ? undefined : this.text,
+      binding: this.binding,
+      expression: this.expression,
+      format: this.controlFormat,
+      printable: this.printable,
+      visibleIf: this.visibleIf,
+      locked: this.lockMovementX && this.lockMovementY ? true : undefined,
+      name: this.controlName,
+      style: {
+        fontSize: round2(pxToPt(this.fontSize)),
+        fill: typeof this.fill === 'string' ? this.fill : undefined,
+        fontFamily: this.fontFamily,
+        fontWeight: (this.fontWeight as 'normal' | 'bold') || undefined,
+        fontStyle: this.fontStyle === 'italic' ? 'italic' : undefined,
+        textDecoration: this.underline ? 'underline' : undefined,
+        textAlign: (this.textAlign as TextStyle['textAlign']) || undefined,
+        lineHeight: this.lineHeight,
+        letterSpacing: this.charSpacing ? round2(pxToPt(this.charSpacing / 1000 * this.fontSize)) : undefined,
+      },
+    }
+  }
+
+  /** 属性面板编辑后回写（不触发 object:modified） */
+  applyControlProps(control: TextControl): void {
+    this.set({
+      ...styleToFabric(control.style),
+      lockMovementX: control.locked,
+      lockMovementY: control.locked,
+    })
+    this.binding = control.binding
+    this.expression = control.expression
+    this.controlFormat = control.format
+    this.printable = control.printable ?? true
+    this.visibleIf = control.visibleIf
+    this.controlName = control.name
+    this.text = displayText(control)
+    // 非绑定文本允许直接改内容尺寸
+    if (control.width) this.set('width', mm(control.width))
+    this.setCoords()
+    this.canvas?.requestRenderAll()
+  }
+}
+
+/** 设计期显示文本：绑定/表达式显示占位符，静态文本显示本体 */
+function displayText(control: TextControl): string {
+  if (control.expression) return control.expression
+  if (control.binding) return `{{${control.binding}}}`
+  return control.value ?? '文本'
+}
+
+function styleToFabric(style?: TextStyle) {
+  return {
+    fontSize: ptToPx(style?.fontSize ?? 12),
+    fill: style?.fill ?? '#000000',
+    fontFamily: style?.fontFamily ?? 'Source Han Sans CN, PingFang SC, sans-serif',
+    fontWeight: style?.fontWeight ?? 'normal',
+    fontStyle: style?.fontStyle ?? 'normal',
+    underline: style?.textDecoration === 'underline',
+    textAlign: style?.textAlign ?? 'left',
+    lineHeight: style?.lineHeight ?? 1.16,
+    charSpacing: style?.letterSpacing ? (style.letterSpacing / (style.fontSize ?? 12)) * 1000 : 0,
+  }
+}
diff --git a/openprint/src/design/canvas/controls/PrintZone.ts b/openprint/src/design/canvas/controls/PrintZone.ts
new file mode 100644
index 0000000..cd202e9
--- /dev/null
+++ b/openprint/src/design/canvas/controls/PrintZone.ts
@@ -0,0 +1,107 @@
+/**
+ * PrintZone —— 页眉/页脚区域控件（《设计方案》§5.14）
+ *
+ * 画布表现：一条横向锁定色带（页顶或页底），
+ * - 自身不可移动/旋转（位置由页顶/页底固定）
+ * - 仅保留内边缘一个 resize 手柄改高度（header=下边缘 mb，footer=上边缘 mt）
+ * - 单例：每页最多一个 header + 一个 footer（由 CanvasDesigner.addZone 保证）
+ * - 序列化目标是 sections[header/footer]，不进 body.components
+ */
+import { Rect } from 'fabric'
+import type { ZoneControl } from '@/types/control'
+import { mm, px, round2, type IPrintObject } from './PrintObject'
+
+export class PrintZone extends Rect implements IPrintObject {
+  controlId: string
+  controlType = 'zone' as const
+
+  zone: 'header' | 'footer'
+  repeat = true
+
+  constructor(control: ZoneControl, pageWidthMm: number, pageHeightMm: number) {
+    const h = mm(control.zoneHeight)
+    super({
+      left: 0,
+      top: control.zone === 'header' ? 0 : mm(pageHeightMm) - h,
+      width: mm(pageWidthMm),
+      height: h,
+      fill: control.zone === 'header' ? 'rgba(22,119,255,0.05)' : 'rgba(22,119,255,0.04)',
+      stroke: 'rgba(22,119,255,0.45)',
+      strokeWidth: 1,
+      strokeDashArray: [6, 3],
+      // 位置锁定：不可移动/旋转/横拉
+      lockMovementX: true,
+      lockMovementY: true,
+      lockRotation: true,
+      hasControls: true,
+      hasBorders: true,
+      selectable: true,
+    })
+    this.controlId = control.id
+    this.zone = control.zone
+    this.repeat = control.repeat ?? true
+    this.restrictControls()
+  }
+
+  /** 只留内边缘手柄：header 用底部中点(mb)，footer 用顶部中点(mt) */
+  private restrictControls(): void {
+    const edge = this.zone === 'header' ? 'mb' : 'mt'
+    const controls = { ...this.controls }
+    for (const key of Object.keys(controls)) {
+      if (key !== edge) {
+        // 其余手柄禁用
+        // eslint-disable-next-line @typescript-eslint/no-dynamic-delete
+        delete controls[key]
+      }
+    }
+    this.controls = controls
+  }
+
+  /** 页面尺寸变化时由 CanvasDesigner 调用，重贴页顶/页底 */
+  relayout(pageWidthMm: number, pageHeightMm: number): void {
+    const h = this.height * this.scaleY
+    this.set({
+      left: 0,
+      width: mm(pageWidthMm),
+      scaleX: 1,
+      scaleY: 1,
+      height: h,
+      top: this.zone === 'header' ? 0 : mm(pageHeightMm) - h,
+    })
+    this.setCoords()
+  }
+
+  get zoneHeightMm(): number {
+    return round2(px(this.height * this.scaleY))
+  }
+
+  toControl(): ZoneControl {
+    return {
+      id: this.controlId,
+      type: 'zone',
+      zone: this.zone,
+      left: 0,
+      top: 0,
+      width: round2(px(this.getScaledWidth())),
+      height: this.zoneHeightMm,
+      zoneHeight: this.zoneHeightMm,
+      repeat: this.repeat,
+      printable: true,
+      children: [], // 子组件由 CanvasDesigner.serialize 按几何归属填充
+    }
+  }
+
+  applyControlProps(control: ZoneControl): void {
+    this.repeat = control.repeat ?? true
+    if (control.zoneHeight && control.zoneHeight !== this.zoneHeightMm) {
+      const pageH = this.canvas ? px(this.canvas.getHeight()) : 0
+      this.set({
+        scaleY: 1,
+        height: mm(control.zoneHeight),
+        top: this.zone === 'header' ? 0 : mm(pageH) - mm(control.zoneHeight),
+      })
+      this.setCoords()
+    }
+    this.canvas?.requestRenderAll()
+  }
+}
diff --git a/openprint/src/design/canvas/controls/index.ts b/openprint/src/design/canvas/controls/index.ts
new file mode 100644
index 0000000..9ed1661
--- /dev/null
+++ b/openprint/src/design/canvas/controls/index.ts
@@ -0,0 +1,83 @@
+/**
+ * 控件注册表：协议模型 → Fabric 对象 的统一工厂
+ */
+import type { FabricObject } from 'fabric'
+import type { AnyControl } from '@/types/control'
+import { PrintText } from './PrintText'
+import { PrintRect } from './PrintRect'
+import { PrintCircle } from './PrintCircle'
+import { PrintLine } from './PrintLine'
+import { PrintImage } from './PrintImage'
+import { PrintBarcode } from './PrintBarcode'
+import { PrintQrcode } from './PrintQrcode'
+import { PrintTable } from './PrintTable'
+import { PrintZone } from './PrintZone'
+import { PrintRichText } from './PrintRichText'
+import { PrintChart } from './PrintChart'
+import type { IPrintObject } from './PrintObject'
+
+export {
+  PrintText,
+  PrintRect,
+  PrintCircle,
+  PrintLine,
+  PrintImage,
+  PrintBarcode,
+  PrintQrcode,
+  PrintTable,
+  PrintZone,
+  PrintRichText,
+  PrintChart,
+}
+export { isPrintObject, type IPrintObject } from './PrintObject'
+
+export interface PageSizeMm {
+  widthMm: number
+  heightMm: number
+}
+
+/** 由协议模型创建 Fabric 控件对象 */
+export function createFabricControl(
+  control: AnyControl,
+  page: PageSizeMm,
+): FabricObject & IPrintObject {
+  switch (control.type) {
+    case 'text':
+      return new PrintText(control)
+    case 'rect':
+      return control.shape === 'circle' ? new PrintCircle(control) : new PrintRect(control)
+    case 'line':
+      return new PrintLine(control)
+    case 'image': {
+      const obj = new PrintImage(control)
+      void obj.loadImage()
+      return obj
+    }
+    case 'barcode':
+      return new PrintBarcode(control)
+    case 'qrcode':
+      return new PrintQrcode(control)
+    case 'table':
+      return new PrintTable(control)
+    case 'chart':
+      return new PrintChart(control)
+    case 'zone':
+      return new PrintZone(control, page.widthMm, page.heightMm)
+    case 'richtext':
+      return new PrintRichText(control)
+  }
+}
+
+/** 控件类型的中文名（图层/面板显示用） */
+export const CONTROL_TYPE_LABEL: Record<string, string> = {
+  text: '文本',
+  image: '图片',
+  table: '表格',
+  barcode: '条码',
+  qrcode: '二维码',
+  rect: '矩形',
+  line: '线条',
+  richtext: '富文本',
+  zone: '区域',
+  chart: '图表',
+}
diff --git a/openprint/src/design/canvas/guides/SmartGuides.ts b/openprint/src/design/canvas/guides/SmartGuides.ts
new file mode 100644
index 0000000..a50bd8f
--- /dev/null
+++ b/openprint/src/design/canvas/guides/SmartGuides.ts
@@ -0,0 +1,583 @@
+/**
+ * SmartGuides —— 智能吸附对齐线（增强版）
+ *
+ * 拖拽控件时与其他控件/页面/页边距的边缘、中心对齐吸附，
+ * 四边同时检测，命中后在 contextTop 上画参考线。
+ * Shift 按住时临时禁用吸附。
+ *
+ * 渲染内容：
+ * 1. 蓝色虚线边界辅助线 —— 沿元素上下左右 4 条边横穿整个画布，对齐标尺
+ * 2. 红色实线 —— 边缘/中心吸附命中线（Figma 红粉）
+ * 3. 绿色标签 —— 吸附间距（mm 数值）
+ * 4. 灰色标签 —— 元素实时坐标（mm）
+ */
+import type { Canvas, FabricObject, Rect } from 'fabric'
+import { MM_TO_PX, DEFAULT_SNAP_THRESHOLD, RULER_THICK } from '@/utils/constants'
+import { isPrintObject } from '../controls'
+import { rulerBand } from '../rulers/rulerHighlight'
+
+const SNAP_PX = DEFAULT_SNAP_THRESHOLD * MM_TO_PX
+
+/** 配色方案：
+ *  蓝   = 元素边界辅助线（用户指定）
+ *  玫红 = 吸附命中（与边界线区分）
+ *  翠绿 = 距离标签
+ *  灰   = 实时坐标信息
+ *  护眼绿底白字药丸 = 辅助线端点坐标读数
+ */
+const COLOR_BOUNDING = '#378ADD'
+const COLOR_SNAP = '#F43F5E'
+const COLOR_DISTANCE = '#10B981'
+const COLOR_POSITION = '#AFB4BD'
+/** 药丸底色（护眼绿，白字；不透明保证浅/深色画布均清晰） */
+const CHIP_BG = '#3FA776'
+const CHIP_BORDER = 'rgba(255,255,255,0.45)'
+const CHIP_FG = '#FFFFFF'
+
+/* ------------------------------------------------------------------ */
+/*  类型定义                                                           */
+/* ------------------------------------------------------------------ */
+
+interface SnapCandidate {
+  value: number
+  orientation: 'v' | 'h'
+  source: 'page' | 'margin' | 'element'
+}
+
+interface SnapResult {
+  line: number
+  orientation: 'v' | 'h'
+  source: 'page' | 'margin' | 'element'
+  /** 命中的吸附候选值 */
+  candidateValue: number
+  /** 目标边的原始值 */
+  targetValue: number
+}
+
+interface MarginMm {
+  top: number
+  bottom: number
+  left: number
+  right: number
+}
+
+export interface SmartGuidesConfig {
+  /** 网格尺寸（mm） */
+  gridSizeMm: number
+  /** 视觉网格线开关（仅作参考、不强绑定元素） */
+  gridVisible: boolean
+  /** 视觉网格线颜色（rgba / hex） */
+  gridColor: string
+}
+
+/* ------------------------------------------------------------------ */
+/*  SmartGuides                                                        */
+/* ------------------------------------------------------------------ */
+
+export class SmartGuides {
+  private canvas: Canvas
+  private getPage: () => Rect
+  private getMarginMm: () => MarginMm
+  private snapResults: SnapResult[] = []
+  private movingTarget: FabricObject | null = null
+  private shiftHeld = false
+  private lastSnapV: SnapResult | null = null
+  private lastSnapH: SnapResult | null = null
+
+  /** 网格配置（由 CanvasDesigner 通过 setter 控制；仅视觉参考，不吸附） */
+  config: SmartGuidesConfig = {
+    gridSizeMm: 5,
+    gridVisible: false,
+    gridColor: 'rgba(120,130,145,0.5)',
+  }
+
+  /* ---------- 事件处理 ---------- */
+
+  private onMoving = (e: { target?: FabricObject }) => {
+    const target = e.target
+    if (!target) {
+      this.movingTarget = null
+      this.snapResults = []
+      rulerBand.value = null
+      return
+    }
+    this.movingTarget = target
+    if (!this.shiftHeld) this.snap(target)
+    this.syncBand(target)
+  }
+
+  /** 缩放时也同步标尺高亮带（不改辅助线，只反映尺寸变化） */
+  private onScaling = (e: { target?: FabricObject }) => {
+    const target = e.target
+    if (target) this.syncBand(target)
+  }
+
+  /** 选中/切换选中：把高亮带对准当前活动元素 */
+  private onSelection = () => {
+    const obj = this.canvas.getActiveObject()
+    if (obj && isPrintObject(obj)) this.syncBand(obj)
+    else rulerBand.value = null
+  }
+
+  private onSelectionCleared = () => {
+    rulerBand.value = null
+  }
+
+  /** 把元素的包围盒（画布逻辑 px）写入标尺高亮带；非法尺寸则清除 */
+  private syncBand(target: FabricObject): void {
+    const b = target.getBoundingRect()
+    if (b.width > 0 && b.height > 0) {
+      rulerBand.value = { left: b.left, top: b.top, width: b.width, height: b.height }
+    } else {
+      rulerBand.value = null
+    }
+  }
+
+  private onUp = () => {
+    this.movingTarget = null
+    this.snapResults = []
+    // 注意：不清空 rulerBand —— 拖拽结束后元素仍处于选中态，高亮带保留反映其位置/尺寸
+    this.canvas.requestRenderAll()
+  }
+
+  private onAfterRender = (opt: { ctx: CanvasRenderingContext2D }) => {
+    // 网格始终可见（独立于拖拽）
+    this.drawGrid(opt.ctx)
+    // 拖拽时覆盖吸附辅助线（网格上叠加）
+    if (this.movingTarget) {
+      this.draw(opt.ctx)
+    }
+    // 常驻辅助线：开启 showGuides 的控件始终显示（与拖拽状态无关）
+    this.drawPersistent(opt.ctx)
+  }
+
+  private onKey = (e: KeyboardEvent) => {
+    if (e.key === 'Shift') this.shiftHeld = e.type === 'keydown'
+  }
+
+  /* ---------- 生命周期 ---------- */
+
+  constructor(
+    canvas: Canvas,
+    getPage: () => Rect,
+    getMarginMm: () => MarginMm,
+  ) {
+    this.canvas = canvas
+    this.getPage = getPage
+    this.getMarginMm = getMarginMm
+
+    canvas.on('object:moving', this.onMoving)
+    canvas.on('object:scaling', this.onScaling)
+    canvas.on('mouse:up', this.onUp)
+    canvas.on('selection:created', this.onSelection)
+    canvas.on('selection:updated', this.onSelection)
+    canvas.on('selection:cleared', this.onSelectionCleared)
+    canvas.on('after:render', this.onAfterRender)
+    window.addEventListener('keydown', this.onKey)
+    window.addEventListener('keyup', this.onKey)
+  }
+
+  dispose(): void {
+    this.canvas.off('object:moving', this.onMoving)
+    this.canvas.off('object:scaling', this.onScaling)
+    this.canvas.off('mouse:up', this.onUp)
+    this.canvas.off('selection:created', this.onSelection)
+    this.canvas.off('selection:updated', this.onSelection)
+    this.canvas.off('selection:cleared', this.onSelectionCleared)
+    this.canvas.off('after:render', this.onAfterRender)
+    window.removeEventListener('keydown', this.onKey)
+    window.removeEventListener('keyup', this.onKey)
+  }
+
+  /* ---------- 候选集收集 ---------- */
+
+  private collectCandidates(skip: FabricObject): SnapCandidate[] {
+    const page = this.getPage()
+    const margin = this.getMarginMm()
+    const pw = page.width
+    const ph = page.height
+    const ml = margin.left * MM_TO_PX
+    const mr = (210 - margin.right) * MM_TO_PX
+    const mt = margin.top * MM_TO_PX
+    const mb = (297 - margin.bottom) * MM_TO_PX
+    const results: SnapCandidate[] = []
+
+    // 1. 页面边缘 + 中心（始终存在于未命名候选列表中）
+    const addV = (value: number, source: SnapCandidate['source']) => results.push({ value, orientation: 'v', source })
+    const addH = (value: number, source: SnapCandidate['source']) => results.push({ value, orientation: 'h', source })
+
+    // 页面
+    addV(0, 'page'); addV(pw / 2, 'page'); addV(pw, 'page')
+    addH(0, 'page'); addH(ph / 2, 'page'); addH(ph, 'page')
+
+    // 页边距（内边界）
+    addV(ml, 'margin'); addV(mr, 'margin')
+    addH(mt, 'margin'); addH(mb, 'margin')
+    // 页边距中心
+    addV(ml + (mr - ml) / 2, 'margin')
+    addH(mt + (mb - mt) / 2, 'margin')
+
+    // 2. 其他控件
+    for (const obj of this.canvas.getObjects()) {
+      if (obj === skip || obj === page || !isPrintObject(obj)) continue
+      const b = obj.getBoundingRect()
+      if (b.width === 0 && b.height === 0) continue
+      addV(b.left, 'element')
+      addV(b.left + b.width / 2, 'element')
+      addV(b.left + b.width, 'element')
+      addH(b.top, 'element')
+      addH(b.top + b.height / 2, 'element')
+      addH(b.top + b.height, 'element')
+    }
+
+    return results
+  }
+
+  /* ---------- 吸附计算 ---------- */
+
+  private snap(target: FabricObject): void {
+    const b = target.getBoundingRect()
+    if (b.width === 0 && b.height === 0) { this.snapResults = []; return }
+
+    const candidates = this.collectCandidates(target)
+    const vCands = candidates.filter((c) => c.orientation === 'v')
+    const hCands = candidates.filter((c) => c.orientation === 'h')
+
+    // 目标六条参考位置
+    const vTargets = [
+      { key: 'left',    value: b.left },
+      { key: 'centerX', value: b.left + b.width / 2 },
+      { key: 'right',   value: b.left + b.width },
+    ]
+    const hTargets = [
+      { key: 'top',     value: b.top },
+      { key: 'centerY', value: b.top + b.height / 2 },
+      { key: 'bottom',  value: b.top + b.height },
+    ]
+
+    this.snapResults = []
+
+    // --- 记录所有命中（用于渲染辅助线） ---
+    for (const t of vTargets) {
+      for (const c of vCands) {
+        if (Math.abs(c.value - t.value) <= SNAP_PX) {
+          this.snapResults.push({
+            line: c.value,
+            orientation: 'v',
+            source: c.source,
+            candidateValue: c.value,
+            targetValue: t.value,
+          })
+        }
+      }
+    }
+    for (const t of hTargets) {
+      for (const c of hCands) {
+        if (Math.abs(c.value - t.value) <= SNAP_PX) {
+          this.snapResults.push({
+            line: c.value,
+            orientation: 'h',
+            source: c.source,
+            candidateValue: c.value,
+            targetValue: t.value,
+          })
+        }
+      }
+    }
+
+    // --- 取最佳吸附线应用位置修正（候选线吸附；网格仅作参考、不强绑定） ---
+    let bestV: SnapResult | null = null
+    let bestVDist = Infinity
+    for (const t of vTargets) {
+      for (const c of vCands) {
+        const dist = Math.abs(c.value - t.value)
+        if (dist <= SNAP_PX && dist < bestVDist) {
+          bestVDist = dist
+          bestV = {
+            line: c.value,
+            orientation: 'v',
+            source: c.source,
+            candidateValue: c.value,
+            targetValue: t.value,
+          }
+        }
+      }
+    }
+    let bestH: SnapResult | null = null
+    let bestHDist = Infinity
+    for (const t of hTargets) {
+      for (const c of hCands) {
+        const dist = Math.abs(c.value - t.value)
+        if (dist <= SNAP_PX && dist < bestHDist) {
+          bestHDist = dist
+          bestH = {
+            line: c.value,
+            orientation: 'h',
+            source: c.source,
+            candidateValue: c.value,
+            targetValue: t.value,
+          }
+        }
+      }
+    }
+
+    if (bestV) {
+      const delta = bestV.candidateValue - bestV.targetValue
+      target.set('left', (target.left ?? 0) + delta)
+      target.setCoords()
+    }
+    if (bestH) {
+      const delta = bestH.candidateValue - bestH.targetValue
+      target.set('top', (target.top ?? 0) + delta)
+      target.setCoords()
+    }
+
+    this.lastSnapV = bestV
+    this.lastSnapH = bestH
+  }
+
+  /* ---------- 渲染 ---------- */
+
+  private draw(ctx: CanvasRenderingContext2D): void {
+    const target = this.movingTarget
+    if (!target) return
+
+    const vt = this.canvas.viewportTransform!
+    const zoom = this.canvas.getZoom()
+    const b = target.getBoundingRect()
+
+    // 画布可视范围（逻辑坐标）：含页面外的灰色区域。
+    // 元素拖出模板（A4）范围时，辅助线也贯穿整个画布、跟着出去。
+    const cw = this.canvas.getWidth()
+    const ch = this.canvas.getHeight()
+    const viewX0 = -vt[4] / vt[0]
+    const viewX1 = (cw - vt[4]) / vt[0]
+    const viewY0 = -vt[5] / vt[3]
+    const viewY1 = (ch - vt[5]) / vt[3]
+
+    ctx.save()
+    // 应用视口变换，后续坐标都是画布逻辑坐标
+    ctx.transform(vt[0], vt[1], vt[2], vt[3], vt[4], vt[5])
+
+    // 反锯齿
+    ctx.imageSmoothingEnabled = false
+
+    // --- 1. 蓝色虚线边界辅助线：沿元素上下左右 4 条边，横穿整个可视画布（含页面外） ---
+    this.drawBoundary(ctx, b, viewX0, viewX1, viewY0, viewY1, zoom)
+
+    // --- 2. 红色实线：吸附命中线（贯穿可视画布） ---
+    // 去重（同一位置可能有多条记录）
+    const drawn = new Set<string>()
+    ctx.strokeStyle = COLOR_SNAP
+    ctx.lineWidth = 1.5 / zoom
+    for (const r of this.snapResults) {
+      const key = `${r.orientation}:${r.line.toFixed(3)}`
+      if (drawn.has(key)) continue
+      drawn.add(key)
+
+      ctx.beginPath()
+      if (r.orientation === 'v') {
+        ctx.moveTo(r.line, viewY0); ctx.lineTo(r.line, viewY1)
+      } else {
+        ctx.moveTo(viewX0, r.line); ctx.lineTo(viewX1, r.line)
+      }
+      ctx.stroke()
+    }
+
+    // --- 3. 绿色距离标签（吸附间距 mm） ---
+    const fontScale = 1 / zoom
+    ctx.fillStyle = COLOR_DISTANCE
+    ctx.font = `${Math.max(10, 11 * fontScale)}px "Inter", "PingFang SC", sans-serif`
+
+    const labelDrawn = new Set<string>()
+    for (const r of this.snapResults) {
+      const distMm = r.candidateValue - r.targetValue
+      const absDist = (Math.abs(distMm) / MM_TO_PX).toFixed(1)
+      const lk = `${r.orientation}:${r.line.toFixed(3)}:${absDist}`
+      if (labelDrawn.has(lk)) continue
+      labelDrawn.add(lk)
+
+      let lx: number, ly: number
+      if (r.orientation === 'v') {
+        lx = r.line + 4 / zoom
+        ly = b.top - 4 / zoom
+      } else {
+        lx = b.left - 4 / zoom
+        ly = r.line - 4 / zoom
+      }
+      // 确保标签在画布可见范围内
+      lx = Math.max(4 / zoom, Math.min(viewX1 - 60 / zoom, lx))
+      ly = Math.max(8 / zoom, Math.min(viewY1, ly))
+      ctx.fillText(`${absDist} mm`, lx, ly)
+    }
+
+    // --- 4. 元素实时坐标（左上角） ---
+    const xMm = (b.left / MM_TO_PX).toFixed(1)
+    const yMm = (b.top / MM_TO_PX).toFixed(1)
+    ctx.fillStyle = COLOR_POSITION
+    ctx.font = `${Math.max(9, 10 * fontScale)}px "Inter", "PingFang SC", sans-serif`
+    const posLabelX = b.left + 3 / zoom
+    const posLabelY = b.top - 5 / zoom
+    ctx.fillText(`X:${xMm} Y:${yMm}`, Math.max(0, posLabelX), Math.max(10 / zoom, posLabelY))
+
+    // --- 5. 辅助线端点坐标标签（对齐标尺位置，mm） ---
+    this.drawChips(ctx, b, viewX0, viewX1, viewY0, viewY1, zoom)
+
+    ctx.restore()
+  }
+
+  /** 蓝色虚线边界辅助线：沿元素上下左右 4 条边，横穿整个可视画布（含页面外） */
+  private drawBoundary(
+    ctx: CanvasRenderingContext2D,
+    b: { left: number; top: number; width: number; height: number },
+    viewX0: number, viewX1: number, viewY0: number, viewY1: number,
+    zoom: number,
+  ): void {
+    const x0 = b.left
+    const x1 = b.left + b.width
+    const y0 = b.top
+    const y1 = b.top + b.height
+    ctx.strokeStyle = COLOR_BOUNDING
+    ctx.lineWidth = 1 / zoom
+    ctx.setLineDash([4 / zoom, 3 / zoom])
+    ctx.beginPath()
+    // 顶/底边水平线（横穿整画布，对齐水平标尺）
+    ctx.moveTo(viewX0, y0); ctx.lineTo(viewX1, y0)
+    ctx.moveTo(viewX0, y1); ctx.lineTo(viewX1, y1)
+    // 左/右边竖直线（竖穿整画布，对齐垂直标尺）
+    ctx.moveTo(x0, viewY0); ctx.lineTo(x0, viewY1)
+    ctx.moveTo(x1, viewY0); ctx.lineTo(x1, viewY1)
+    ctx.stroke()
+    ctx.setLineDash([])
+  }
+
+  /** 辅助线端点坐标标签（靠近标尺那一头，mm） */
+  private drawChips(
+    ctx: CanvasRenderingContext2D,
+    b: { left: number; top: number; width: number; height: number },
+    viewX0: number, viewX1: number, viewY0: number, viewY1: number,
+    zoom: number,
+  ): void {
+    const x0 = b.left
+    const x1 = b.left + b.width
+    const y0 = b.top
+    const y1 = b.top + b.height
+    // 放在「靠近标尺那一头」，但必须越过 RulerOverlay 覆盖层（左垂直标尺 / 顶水平标尺各 RULER_THICK px），
+    // 否则文字会被标尺 DOM 遮住看不见。各偏移 RULER_THICK+4px 正好落在标尺外侧的画布可见区。
+    const clampY = (v: number) => Math.max(viewY0 + (RULER_THICK + 6) / zoom, Math.min(viewY1 - 6 / zoom, v))
+    const clampX = (v: number) => Math.max(viewX0 + (RULER_THICK + 6) / zoom, Math.min(viewX1 - 6 / zoom, v))
+    // 水平线（顶/底）显示 Y，贴在左端、标尺外侧
+    this.drawChip(ctx, `Y ${(y0 / MM_TO_PX).toFixed(1)}`, viewX0 + (RULER_THICK + 4) / zoom, clampY(y0), zoom, CHIP_BG, CHIP_BORDER, CHIP_FG)
+    this.drawChip(ctx, `Y ${(y1 / MM_TO_PX).toFixed(1)}`, viewX0 + (RULER_THICK + 4) / zoom, clampY(y1), zoom, CHIP_BG, CHIP_BORDER, CHIP_FG)
+    // 竖直线（左/右）显示 X，贴在顶端、标尺外侧
+    this.drawChip(ctx, `X ${(x0 / MM_TO_PX).toFixed(1)}`, clampX(x0), viewY0 + (RULER_THICK + 4) / zoom, zoom, CHIP_BG, CHIP_BORDER, CHIP_FG)
+    this.drawChip(ctx, `X ${(x1 / MM_TO_PX).toFixed(1)}`, clampX(x1), viewY0 + (RULER_THICK + 4) / zoom, zoom, CHIP_BG, CHIP_BORDER, CHIP_FG)
+  }
+
+  /** 常驻辅助线：遍历开启 showGuides 的控件，始终绘制其 4 条边界线 + 坐标标签（不限于拖拽时） */
+  private drawPersistent(ctx: CanvasRenderingContext2D): void {
+    const movingId = this.movingTarget ? (this.movingTarget as unknown as { controlId?: string }).controlId : undefined
+    const vt = this.canvas.viewportTransform!
+    const zoom = this.canvas.getZoom()
+    const cw = this.canvas.getWidth()
+    const ch = this.canvas.getHeight()
+    const viewX0 = -vt[4] / vt[0]
+    const viewX1 = (cw - vt[4]) / vt[0]
+    const viewY0 = -vt[5] / vt[3]
+    const viewY1 = (ch - vt[5]) / vt[3]
+
+    for (const obj of this.canvas.getObjects()) {
+      if (!isPrintObject(obj)) continue
+      if ((obj as unknown as { showGuides?: boolean }).showGuides !== true) continue
+      if ((obj as unknown as { controlId?: string }).controlId === movingId) continue // 拖拽中由 draw() 处理，避免重绘
+      const b = obj.getBoundingRect()
+      if (b.width === 0 && b.height === 0) continue
+      ctx.save()
+      ctx.transform(vt[0], vt[1], vt[2], vt[3], vt[4], vt[5])
+      ctx.imageSmoothingEnabled = false
+      this.drawBoundary(ctx, b, viewX0, viewX1, viewY0, viewY1, zoom)
+      this.drawChips(ctx, b, viewX0, viewX1, viewY0, viewY1, zoom)
+      ctx.restore()
+    }
+  }
+
+  /** 网格视觉线绘制（零依赖，内联到 draw 前调用） */
+  private drawGrid(ctx: CanvasRenderingContext2D): void {
+    if (!this.config.gridVisible) return
+    const vt = this.canvas.viewportTransform!
+    const zoom = this.canvas.getZoom()
+    if (zoom < 0.3) return // 太小不绘，否则糊成一片
+    const page = this.getPage()
+    const step = this.config.gridSizeMm * MM_TO_PX
+
+    ctx.save()
+    ctx.transform(vt[0], vt[1], vt[2], vt[3], vt[4], vt[5])
+    ctx.strokeStyle = this.config.gridColor
+    ctx.lineWidth = 0.5 / zoom
+    ctx.beginPath()
+    for (let x = 0; x <= page.width; x += step) {
+      ctx.moveTo(x, 0)
+      ctx.lineTo(x, page.height)
+    }
+    for (let y = 0; y <= page.height; y += step) {
+      ctx.moveTo(0, y)
+      ctx.lineTo(page.width, y)
+    }
+    ctx.stroke()
+    ctx.restore()
+  }
+
+  /** 圆角矩形路径（Canvas2D 无原生 roundRect 兼容写法） */
+  private roundRectPath(
+    ctx: CanvasRenderingContext2D,
+    x: number,
+    y: number,
+    w: number,
+    h: number,
+    r: number,
+  ): void {
+    ctx.moveTo(x + r, y)
+    ctx.arcTo(x + w, y, x + w, y + h, r)
+    ctx.arcTo(x + w, y + h, x, y + h, r)
+    ctx.arcTo(x, y + h, x, y, r)
+    ctx.arcTo(x, y, x + w, y, r)
+    ctx.closePath()
+  }
+
+  /** 小药丸标签：不透明深色底 + 浅色描边 + 白字，用于辅助线端点显示标尺坐标（mm）。
+   *  不透明底色保证在浅色页面与深色画布上都清晰可读；浅描边让药丸边缘在深色背景中也能被分辨。 */
+  private drawChip(
+    ctx: CanvasRenderingContext2D,
+    text: string,
+    x: number,
+    y: number,
+    zoom: number,
+    bg: string,
+    border: string,
+    fg: string,
+  ): void {
+    ctx.save()
+    ctx.font = `600 ${Math.max(10, 11 / zoom)}px "Inter", "PingFang SC", sans-serif`
+    ctx.textBaseline = 'middle'
+    const padX = 4 / zoom
+    const h = (11 / zoom) + (4 / zoom)
+    const w = ctx.measureText(text).width + padX * 2
+    const top = y - h / 2
+    const radius = 3 / zoom
+
+    // 不透明底色
+    ctx.beginPath()
+    this.roundRectPath(ctx, x, top, w, h, radius)
+    ctx.fillStyle = bg
+    ctx.fill()
+    // 浅色描边，确保深色背景下药丸边缘可见
+    ctx.lineWidth = 1 / zoom
+    ctx.strokeStyle = border
+    ctx.stroke()
+
+    // 文字
+    ctx.fillStyle = fg
+    ctx.fillText(text, x + padX, y)
+    ctx.restore()
+  }
+}
diff --git a/openprint/src/design/canvas/page-gap.spec.ts b/openprint/src/design/canvas/page-gap.spec.ts
new file mode 100644
index 0000000..97c1996
--- /dev/null
+++ b/openprint/src/design/canvas/page-gap.spec.ts
@@ -0,0 +1,52 @@
+import { describe, it, expect } from 'vitest'
+import { pageGapPx, modelTopToCanvasY, canvasYToModelTop } from './page-gap'
+import { MM_TO_PX } from '@/utils/constants'
+
+const GAP = 24
+const A4_MM = 297
+const MARGIN_TOP_PX = 10 * MM_TO_PX
+
+describe('pageGapPx —— 页索引 → 累计间距', () => {
+  it('首页/负值/零页高 → 0', () => {
+    expect(pageGapPx(0, A4_MM, GAP)).toBe(0)
+    expect(pageGapPx(100, A4_MM, GAP)).toBe(0)
+    expect(pageGapPx(-10, A4_MM, GAP)).toBe(0)
+    expect(pageGapPx(500, 0, GAP)).toBe(0)
+  })
+
+  it('第 2 页起每页累加一个间距', () => {
+    expect(pageGapPx(300, A4_MM, GAP)).toBe(GAP)
+    expect(pageGapPx(600, A4_MM, GAP)).toBe(GAP * 2)
+    expect(pageGapPx(900, A4_MM, GAP)).toBe(GAP * 3)
+  })
+})
+
+describe('modelTopToCanvasY / canvasYToModelTop —— 正反互换', () => {
+  it('第 1 页控件往返不漂移', () => {
+    for (const topMm of [0, 5, 100, 296.5]) {
+      const y = modelTopToCanvasY(topMm, MARGIN_TOP_PX, A4_MM, GAP)
+      expect(canvasYToModelTop(y, MARGIN_TOP_PX, A4_MM, GAP)).toBeCloseTo(topMm, 6)
+    }
+  })
+
+  it('第 2 页控件含累计间距且往返不漂移', () => {
+    const topMm = 300
+    const y = modelTopToCanvasY(topMm, MARGIN_TOP_PX, A4_MM, GAP)
+    // 第 2 页内容区顶 = (297 + 24) + 页边距，300mm 应在第 2 页内偏下 3mm
+    expect(y).toBeCloseTo(MARGIN_TOP_PX + 300 * MM_TO_PX + GAP, 6)
+    expect(canvasYToModelTop(y, MARGIN_TOP_PX, A4_MM, GAP)).toBeCloseTo(topMm, 6)
+  })
+
+  it('第 3 页控件往返不漂移（两层间距）', () => {
+    const topMm = 610
+    const y = modelTopToCanvasY(topMm, MARGIN_TOP_PX, A4_MM, GAP)
+    expect(canvasYToModelTop(y, MARGIN_TOP_PX, A4_MM, GAP)).toBeCloseTo(topMm, 6)
+  })
+
+  it('页边界附近往返不漂移（迭代收敛）', () => {
+    for (const topMm of [296.9, 297.1, 593.9, 594.2]) {
+      const y = modelTopToCanvasY(topMm, MARGIN_TOP_PX, A4_MM, GAP)
+      expect(canvasYToModelTop(y, MARGIN_TOP_PX, A4_MM, GAP)).toBeCloseTo(topMm, 6)
+    }
+  })
+})
diff --git a/openprint/src/design/canvas/page-gap.ts b/openprint/src/design/canvas/page-gap.ts
new file mode 100644
index 0000000..1a0d7b3
--- /dev/null
+++ b/openprint/src/design/canvas/page-gap.ts
@@ -0,0 +1,43 @@
+/**
+ * 画布页间留白几何纯函数（设计态专用）。
+ *
+ * 模型 mm 保持 flush（与渲染/导出一致），页间距只叠加在画布 px 坐标上：
+ * - 页 1 顶部 = 页边距；页 i+1 顶部 = i × (页高 + 间距) + 页边距
+ * - 正文控件绝对 y = 页边距 + topMm×PX + 累计页间距（按所在页索引）
+ */
+import { MM_TO_PX } from '@/utils/constants'
+
+/** 模型 top(mm, flush) 所在页索引 → 该页之前的累计页间距(px)；首页恒为 0 */
+export function pageGapPx(topMm: number, pageHeightMm: number, gapPx: number): number {
+  if (topMm <= 0 || pageHeightMm <= 0) return 0
+  const i = Math.floor(topMm / pageHeightMm)
+  return i > 0 ? i * gapPx : 0
+}
+
+/** 模型 top(mm, flush) → 画布绝对 y(px)：页边距 + 页内偏移 + 累计页间距 */
+export function modelTopToCanvasY(
+  topMm: number,
+  marginTopPx: number,
+  pageHeightMm: number,
+  gapPx: number,
+): number {
+  return marginTopPx + topMm * MM_TO_PX + pageGapPx(topMm, pageHeightMm, gapPx)
+}
+
+/** 画布绝对 y(px) → 模型 top(mm, flush)：反解累计页间距（近页边界最多迭代 2 次收敛） */
+export function canvasYToModelTop(
+  y: number,
+  marginTopPx: number,
+  pageHeightMm: number,
+  gapPx: number,
+): number {
+  const y0 = y - marginTopPx
+  let topMm = y0 / MM_TO_PX
+  let gap = pageGapPx(topMm, pageHeightMm, gapPx)
+  if (gap > 0) {
+    topMm = (y0 - gap) / MM_TO_PX
+    const gap2 = pageGapPx(topMm, pageHeightMm, gapPx)
+    if (gap2 !== gap) topMm = (y0 - gap2) / MM_TO_PX
+  }
+  return topMm
+}
diff --git a/openprint/src/design/canvas/page-geometry.spec.ts b/openprint/src/design/canvas/page-geometry.spec.ts
new file mode 100644
index 0000000..64a0b2a
--- /dev/null
+++ b/openprint/src/design/canvas/page-geometry.spec.ts
@@ -0,0 +1,30 @@
+import { describe, it, expect } from 'vitest'
+import { computePhysicalPageCount } from './page-geometry'
+
+describe('computePhysicalPageCount', () => {
+  const A4 = 297
+
+  it('无内容时至少 1 页', () => {
+    expect(computePhysicalPageCount(0, A4)).toBe(1)
+    expect(computePhysicalPageCount(-50, A4)).toBe(1)
+  })
+
+  it('内容落在第 1 页内 → 1 页', () => {
+    expect(computePhysicalPageCount(100, A4)).toBe(1)
+    expect(computePhysicalPageCount(296, A4)).toBe(1)
+  })
+
+  it('内容越过第 1 页底部 → 第 2 页', () => {
+    expect(computePhysicalPageCount(298, A4)).toBe(2)
+    expect(computePhysicalPageCount(400, A4)).toBe(2)
+  })
+
+  it('内容延伸到第 3 页', () => {
+    expect(computePhysicalPageCount(594, A4)).toBe(3)
+    expect(computePhysicalPageCount(800, A4)).toBe(3)
+  })
+
+  it('页高为 0 时安全返回 1', () => {
+    expect(computePhysicalPageCount(500, 0)).toBe(1)
+  })
+})
diff --git a/openprint/src/design/canvas/page-geometry.ts b/openprint/src/design/canvas/page-geometry.ts
new file mode 100644
index 0000000..9168d37
--- /dev/null
+++ b/openprint/src/design/canvas/page-geometry.ts
@@ -0,0 +1,11 @@
+/**
+ * 画布多页几何纯函数（与渲染端 layoutStaticOnly 的落页口径一致）。
+ *
+ * 正文控件按 `marginTop + top` 绝对定位（top 为相对内容区 mm），
+ * 越过内容区底部即落入下一页。物理页数 = floor(maxBottomMm / pageHeightMm) + 1。
+ */
+export function computePhysicalPageCount(maxBottomMm: number, pageHeightMm: number): number {
+  if (pageHeightMm <= 0) return 1
+  if (maxBottomMm <= 0) return 1
+  return Math.max(1, Math.floor(maxBottomMm / pageHeightMm) + 1)
+}
diff --git a/openprint/src/design/canvas/rulers/RulerOverlay.vue b/openprint/src/design/canvas/rulers/RulerOverlay.vue
new file mode 100644
index 0000000..a77b6b1
--- /dev/null
+++ b/openprint/src/design/canvas/rulers/RulerOverlay.vue
@@ -0,0 +1,211 @@
+<script setup lang="ts">
+/**
+ * RulerOverlay —— SVG 标尺覆盖层
+ *
+ * 水平（顶）+ 垂直（左）标尺，mm 刻度自适应缩放密度。
+ * 监听 CanvasDesigner.onViewportChange 驱动重绘，
+ * 坐标遵循 页面左上角=(0,0) + 1mm=MM_TO_PX px 的约定。
+ *
+ * CanvasStage 已预留 RULER_THICK(20px) 给标尺，画布向右下偏移。
+ */
+import { computed } from 'vue'
+import { useDesignerStore } from '@/design/stores/designer'
+import { useUiStore } from '@/design/stores/ui'
+import { MM_TO_PX, RULER_THICK, RULER_PALETTE_LIGHT, RULER_PALETTE_DARK } from '@/utils/constants'
+import { rulerBand } from './rulerHighlight'
+
+interface Tick {
+  coord: number
+  major: boolean
+  label: string | null
+}
+
+const props = defineProps<{
+  stageWidth: number
+  stageHeight: number
+}>()
+
+const store = useDesignerStore()
+const uiStore = useUiStore()
+
+const palette = computed(() =>
+  uiStore.effectiveTheme === 'dark' ? RULER_PALETTE_DARK : RULER_PALETTE_LIGHT,
+)
+
+/* ---------- 刻度密度选择 ---------- */
+
+function tickStep(zoom: number): number {
+  if (zoom >= 2) return 1
+  if (zoom >= 1) return 5
+  if (zoom >= 0.5) return 10
+  return 20
+}
+
+/* ---------- 水平标尺刻度 ---------- */
+
+const hTicks = computed<Tick[]>(() => {
+  const vp = store.viewport
+  const zoom = vp.zoom
+  const offsetX = vp.offsetX + RULER_THICK // 画布在 stage 内右移 20px
+  const w = props.stageWidth
+  const step = tickStep(zoom)
+
+  // 可见 canvas mm 范围
+  const startMm = Math.floor((-offsetX) / (MM_TO_PX * zoom))
+  const endMm = Math.ceil((-offsetX + w) / (MM_TO_PX * zoom))
+  const start = Math.floor(startMm / step) * step
+
+  const ticks: Tick[] = []
+  for (let mm = start; mm <= endMm; mm += step) {
+    const x = mm * MM_TO_PX * zoom + offsetX
+    if (x < RULER_THICK || x > w) continue
+    ticks.push({ coord: x, major: true, label: String(mm) })
+  }
+  return ticks
+})
+
+/* ---------- 垂直标尺刻度 ---------- */
+
+const vTicks = computed<Tick[]>(() => {
+  const vp = store.viewport
+  const zoom = vp.zoom
+  const offsetY = vp.offsetY + RULER_THICK
+  const h = props.stageHeight
+  const step = tickStep(zoom)
+
+  const startMm = Math.floor((-offsetY) / (MM_TO_PX * zoom))
+  const endMm = Math.ceil((-offsetY + h) / (MM_TO_PX * zoom))
+  const start = Math.floor(startMm / step) * step
+
+  const ticks: Tick[] = []
+  for (let mm = start; mm <= endMm; mm += step) {
+    const y = mm * MM_TO_PX * zoom + offsetY
+    if (y < RULER_THICK || y > h) continue
+    ticks.push({ coord: y, major: true, label: String(mm) })
+  }
+  return ticks
+})
+
+/* ---------- 选中/拖拽元素在标尺上的高亮带 ---------- */
+
+const band = computed(() => {
+  const hb = rulerBand.value
+  if (!hb) return null
+  const vp = store.viewport
+  const zoom = vp.zoom
+  const offsetX = vp.offsetX + RULER_THICK
+  const offsetY = vp.offsetY + RULER_THICK
+  const x1 = hb.left * zoom + offsetX
+  const x2 = (hb.left + hb.width) * zoom + offsetX
+  const y1 = hb.top * zoom + offsetY
+  const y2 = (hb.top + hb.height) * zoom + offsetY
+  return {
+    x1, x2, y1, y2,
+    /** 顶标尺带宽度（px） */
+    wPx: x2 - x1,
+    /** 左标尺带高度（px） */
+    hPx: y2 - y1,
+    /** 元素宽度（mm） */
+    widthMm: hb.width / MM_TO_PX,
+    /** 元素高度（mm） */
+    heightMm: hb.height / MM_TO_PX,
+    /** 左标尺高度标签的旋转中心 y */
+    hLabelCy: (y1 + y2) / 2,
+  }
+})
+</script>
+
+<template>
+  <div
+    class="pointer-events-none absolute inset-0 select-none"
+    :style="{ zIndex: 10 }"
+  >
+    <svg :width="stageWidth" :height="stageHeight" class="block">
+      <!-- 水平标尺背景 -->
+      <rect
+        x="0" y="0"
+        :width="stageWidth" :height="RULER_THICK"
+        :fill="palette.bgColor"
+      />
+      <!-- 水平标尺刻度线 -->
+      <line
+        v-for="t in hTicks" :key="'h' + t.coord"
+        :x1="t.coord" :y1="t.coord % 2 === 0 ? 10 : 14"
+        :x2="t.coord" :y2="RULER_THICK"
+        :stroke="palette.tickColor"
+        stroke-width="1"
+      />
+      <!-- 水平标尺文字 -->
+      <text
+        v-for="t in hTicks.filter(t => t.label)" :key="'ht' + t.coord"
+        :x="t.coord + 2"
+        :y="RULER_THICK - 5"
+        :fill="palette.labelColor"
+        font-size="10"
+        font-family="Inter, PingFang SC, sans-serif"
+      >{{ t.label }}</text>
+
+      <!-- 垂直标尺背景 -->
+      <rect
+        x="0" y="0"
+        :width="RULER_THICK" :height="stageHeight"
+        :fill="palette.bgColor"
+      />
+      <!-- 垂直标尺刻度线 -->
+      <line
+        v-for="t in vTicks" :key="'v' + t.coord"
+        :y1="t.coord" :x1="t.coord % 2 === 0 ? 10 : 14"
+        :y2="t.coord" :x2="RULER_THICK"
+        :stroke="palette.tickColor"
+        stroke-width="1"
+      />
+      <!-- 垂直标尺文字 -->
+      <text
+        v-for="t in vTicks.filter(t => t.label)" :key="'vt' + t.coord"
+        :y="t.coord + 8"
+        :x="3"
+        :fill="palette.labelColor"
+        font-size="9"
+        font-family="Inter, PingFang SC, sans-serif"
+        transform-origin="0 0"
+      >{{ t.label }}</text>
+
+      <!-- 选中/拖拽元素高亮带：顶标尺带=宽度，左标尺带=高度，随移动丝滑滑动 -->
+      <template v-if="band">
+        <rect
+          :x="band.x1" y="0"
+          :width="Math.max(0, band.wPx)" :height="RULER_THICK"
+          :fill="palette.bandColor" :stroke="palette.bandBorder" stroke-width="1"
+        />
+        <rect
+          x="0" :y="band.y1"
+          :width="RULER_THICK" :height="Math.max(0, band.hPx)"
+          :fill="palette.bandColor" :stroke="palette.bandBorder" stroke-width="1"
+        />
+        <!-- 宽度标签（顶标尺带中央，px 足够宽才显示） -->
+        <text
+          v-if="band.wPx >= 26"
+          :x="(band.x1 + band.x2) / 2" :y="RULER_THICK - 6"
+          :fill="palette.bandText" font-size="10" text-anchor="middle"
+          font-family="Inter, PingFang SC, sans-serif"
+        >{{ band.widthMm.toFixed(1) }}</text>
+        <!-- 高度标签（左标尺带中央，竖排；px 足够高才显示） -->
+        <text
+          v-if="band.hPx >= 26"
+          :x="RULER_THICK / 2" :y="band.hLabelCy"
+          :fill="palette.bandText" font-size="10" text-anchor="middle"
+          :transform="`rotate(-90 ${RULER_THICK / 2} ${band.hLabelCy})`"
+          font-family="Inter, PingFang SC, sans-serif"
+        >{{ band.heightMm.toFixed(1) }}</text>
+      </template>
+
+      <!-- 角标（标尺交叉的方角） -->
+      <rect
+        x="0" y="0"
+        :width="RULER_THICK" :height="RULER_THICK"
+        :fill="palette.bgColor"
+        stroke="transparent"
+      />
+    </svg>
+  </div>
+</template>
diff --git a/openprint/src/design/canvas/rulers/rulerHighlight.ts b/openprint/src/design/canvas/rulers/rulerHighlight.ts
new file mode 100644
index 0000000..bce7062
--- /dev/null
+++ b/openprint/src/design/canvas/rulers/rulerHighlight.ts
@@ -0,0 +1,24 @@
+/**
+ * rulerHighlight —— 标尺高亮带共享状态
+ *
+ * SmartGuides 在 object:moving / object:scaling / selection 事件里，
+ * 把「当前选中/拖拽元素的包围盒（画布逻辑 px = 页面 px，未含缩放/平移）」
+ * 写入这个模块级 ref；RulerOverlay 读取后按 viewport 映射成标尺上的彩色高亮带
+ * （顶标尺带 = 元素宽度，左标尺带 = 元素高度），随组件移动丝滑滑动。
+ *
+ * 用模块级 ref 而非 Pinia store，是为了避免把画布引擎模块与组件 store 耦合。
+ */
+import { ref } from 'vue'
+
+export interface RulerBand {
+  /** 左边缘（画布逻辑 px） */
+  left: number
+  /** 上边缘（画布逻辑 px） */
+  top: number
+  /** 宽（画布逻辑 px） */
+  width: number
+  /** 高（画布逻辑 px） */
+  height: number
+}
+
+export const rulerBand = ref<RulerBand | null>(null)
diff --git a/openprint/src/design/canvas/table-design-render.spec.ts b/openprint/src/design/canvas/table-design-render.spec.ts
new file mode 100644
index 0000000..c3536c0
--- /dev/null
+++ b/openprint/src/design/canvas/table-design-render.spec.ts
@@ -0,0 +1,172 @@
+/**
+ * 设计期表格 HTML 渲染单测（table-design-render.ts）
+ *
+ * 覆盖：renderTableGridHtml 标记（data-row/data-col、类名、占位符、纵向合并）、
+ * gridColXs / gridRowHeights / computeGridLayout 几何、hitTestCell 命中测试。
+ * 重点确保"设计所见"与运行期类名一致，且无 cells 的旧模板能正常回落。
+ */
+import { describe, expect, it } from 'vitest'
+import type { TableControl } from '@/types/control'
+import {
+  computeGridLayout,
+  gridColXs,
+  gridRowHeights,
+  hitTestCell,
+  renderTableGridHtml,
+} from './table-design-render'
+import { seedSummaryTail } from '@/core/layout-engine/table-cells'
+
+function baseTable(over: Partial<TableControl> = {}): TableControl {
+  return {
+    id: 't1',
+    type: 'table',
+    left: 0,
+    top: 0,
+    width: 180,
+    height: 60,
+    columns: [
+      { title: '序号', expression: '{{rowIndex + 1}}', width: 15, align: 'center', headerAlign: 'center' },
+      { title: '名称', field: 'name', width: 60 },
+      { title: '数量', field: 'qty', width: 25, align: 'right', headerAlign: 'center' },
+    ],
+    options: { borders: 'all', verticalAlign: 'middle' },
+    ...over,
+  }
+}
+
+describe('renderTableGridHtml', () => {
+  it('数据表：输出表格根类 op-table + 运行期同款修饰类', () => {
+    const html = renderTableGridHtml(baseTable({ dataSource: 'items', staticRows: 1 }))
+    expect(html).toContain('class="op-node op-table b-all va-middle ts-none"')
+    expect(html).toContain('table-layout:fixed')
+  })
+
+  it('边框修复：不再内联 border-collapse:collapse（否则被 overlay overflow:hidden 切掉右/下边）', () => {
+    const html = renderTableGridHtml(baseTable({ dataSource: 'items' }))
+    expect(html).not.toContain('border-collapse:collapse')
+    // 外框走 tableCss 的 separate + 末行/末列补边，四边始终完整
+    expect(html).toContain('table-layout:fixed')
+  })
+
+  it('样式预设：默认 none 挂 ts-none，指定后挂对应类', () => {
+    const def = renderTableGridHtml(baseTable({ dataSource: 'items', options: { borders: 'all', verticalAlign: 'middle' } }))
+    expect(def).toContain('ts-none')
+    const zebra = renderTableGridHtml(baseTable({ dataSource: 'items', options: { borders: 'all', verticalAlign: 'middle', tableStyle: 'zebra' } }))
+    expect(zebra).toContain('ts-zebra')
+  })
+
+  it('聚合尾行对齐运行期类名：本页合计→is-subtotal，总计/大写金额→is-summary', () => {
+    const t = seedSummaryTail(
+      baseTable({
+        dataSource: 'items',
+        columns: [
+          { title: '名称', field: 'items[].name', width: 60 },
+          { title: '数量', field: 'items[].qty', width: 25, align: 'right', headerAlign: 'center' },
+        ],
+        data: [{ name: 'A', qty: 2 }],
+      }),
+      { numericColumns: [1], moneyColumn: 1, capital: true },
+    )
+    const html = renderTableGridHtml(t)
+    expect(html).toContain('is-subtotal')
+    expect(html).toContain('is-summary')
+  })
+
+  it('每个 td 带 data-row/data-col，便于 overlay 编辑写回', () => {
+    const html = renderTableGridHtml(baseTable({ dataSource: 'items' }))
+    expect(html).toContain('data-row="0"')
+    expect(html).toContain('data-col="2"')
+  })
+
+  it('行类与语义匹配：表头 / 数据样例行 / 静态', () => {
+    const html = renderTableGridHtml(baseTable({ dataSource: 'items', staticRows: 1 }))
+    expect(html).toContain('class="is-header"')
+    expect(html).toContain('class="is-data is-template"')
+    expect(html).toContain('class="is-static"')
+  })
+
+  it('绑定的数据样例行：渲染为字段占位符而非空', () => {
+    const html = renderTableGridHtml(baseTable({ dataSource: 'items' }))
+    expect(html).toContain('{{item.name}}')
+    expect(html).toContain('{{item.qty}}')
+    // 表头占位符走 expression
+    expect(html).toContain('{{rowIndex + 1}}')
+  })
+
+  it('静态文字行：原样输出字面量', () => {
+    const cells = [
+      [{ text: '列1' }, { text: '列2' }, { text: '列3' }],
+      [{ field: 'a' }, { field: 'b' }, { field: 'c' }],
+      [{ text: '合计：' }, {}, {}],
+    ]
+    const html = renderTableGridHtml(baseTable({ dataSource: 'items', cells, staticRows: 1 }))
+    expect(html).toContain('合计：')
+    expect(html).toContain('列1')
+  })
+
+  it('空单元格输出 <br> 占位，避免高度塌陷', () => {
+    // 布局网格（无 dataSource）多数静态格为空 → 输出 <br>
+    const html = renderTableGridHtml(baseTable({ designRows: 3 }))
+    expect(html).toContain('<br>')
+  })
+
+  it('横向合并：输出 colspan 属性', () => {
+    const t = baseTable({ dataSource: 'items' })
+    const cells = [
+      [{ text: 'H' }, { text: '' }, { text: '' }],
+      [{ field: 'a', colSpan: 2 }, { text: '' }, { field: 'c' }],
+    ]
+    const html = renderTableGridHtml({ ...t, cells, staticRows: 0 })
+    expect(html).toContain('colspan="2"')
+  })
+})
+
+describe('几何布局', () => {
+  it('gridColXs：长度 colCount+1，末值=表格宽，单调递增', () => {
+    const xs = gridColXs(baseTable({ dataSource: 'items' }))
+    expect(xs.length).toBe(4)
+    expect(xs[0]).toBe(0)
+    expect(xs[3]).toBe(180)
+    expect(xs[1]! < xs[2]!).toBe(true)
+  })
+
+  it('gridRowHeights：返回 rowCount 个正值', () => {
+    const hs = gridRowHeights(baseTable({ dataSource: 'items', staticRows: 1 }))
+    expect(hs.length).toBe(3)
+    expect(hs.every((h) => h > 0)).toBe(true)
+  })
+
+  it('computeGridLayout：汇总 colXs/rowYs/rowCount/colCount', () => {
+    const g = computeGridLayout(baseTable({ dataSource: 'items', staticRows: 1 }))
+    expect(g.colCount).toBe(3)
+    expect(g.rowCount).toBe(3)
+    expect(g.colXs.length).toBe(4)
+    expect(g.rowYs.length).toBe(4)
+    expect(g.rowYs[0]).toBe(0)
+  })
+})
+
+describe('hitTestCell', () => {
+  const layout = computeGridLayout(baseTable({ dataSource: 'items', staticRows: 1 }))
+
+  it('左上角命中第 0 行第 0 列', () => {
+    expect(hitTestCell(layout, 0.01, 0.01)).toEqual({ row: 0, col: 0 })
+  })
+
+  it('右下角命中末行末列', () => {
+    const hit = hitTestCell(layout, 0.99, 0.99)
+    expect(hit).toEqual({ row: layout.rowCount - 1, col: layout.colCount - 1 })
+  })
+
+  it('越界（frac 超出 [0,1]）返回 null', () => {
+    expect(hitTestCell(layout, -0.1, 0.5)).toBeNull()
+    expect(hitTestCell(layout, 0.5, 1.2)).toBeNull()
+  })
+
+  it('落在第 2 列区间命中 col=1', () => {
+    // colXs 近似 [0, ~25, ~136, 180]，中间点应落第 1 列
+    const x = (layout.colXs[1]! + layout.colXs[2]!) / 2 / layout.colXs[3]!
+    const hit = hitTestCell(layout, x, 0.01)
+    expect(hit?.col).toBe(1)
+  })
+})
diff --git a/openprint/src/design/canvas/table-design-render.ts b/openprint/src/design/canvas/table-design-render.ts
new file mode 100644
index 0000000..bc1076b
--- /dev/null
+++ b/openprint/src/design/canvas/table-design-render.ts
@@ -0,0 +1,194 @@
+/**
+ * table-design-render —— 设计期表格 HTML 渲染（方案 A：与运行期共用渲染语义）
+ *
+ * 设计期表格以 HTML overlay 呈现（绝对定位、transform 同步 Fabric 节点 + 视口），
+ * 由本模块产出的 HTML 与运行期 html-renderer 使用同一套样式类 / 内联样式键，
+ * 从而做到"设计即打印"的真·所见即所得；双击单元格即可原生 contenteditable 编辑。
+ *
+ * 所有几何以 mm 表达（CSS 原生支持 mm 单位），由调用方统一做 zoom/scale 变换。
+ */
+import type { TableCell, TableControl, TableColumn } from '@/types/control'
+import {
+  buildDesignGrid,
+  computeSpanLayout,
+  designRowHeights,
+  resolveCellStyleFor,
+  type DesignRowKind,
+} from '@/core/layout-engine/table-cells'
+import { isAggToken, parseAggToken } from '@/core/layout-engine/aggregate'
+import { normalizeColumnWidths } from '@/core/layout-engine/table-engine'
+import { diagonalBackground } from '@/core/renderer-html/css-generator'
+
+const PLACEHOLDER = '#9aa0a6'
+
+/**
+ * 各可视行的行高（mm），与渲染、命中测试共用。
+ * 实现下沉到 core（designRowHeights），**运行期布局网格用的是同一份算法** —— 这样
+ * 空白表格在画布上什么样，打印出来就是什么样。
+ */
+export function gridRowHeights(control: TableControl): number[] {
+  return designRowHeights(control)
+}
+
+/** 列累计 x（mm，长度 colCount+1，末值 = 表格宽） */
+export function gridColXs(control: TableControl): number[] {
+  const widths = normalizeColumnWidths(control.columns, control.width)
+  const xs = [0]
+  for (const w of widths) xs.push(xs[xs.length - 1]! + w)
+  return xs
+}
+
+export interface GridLayout {
+  colXs: number[]
+  rowYs: number[]
+  rowCount: number
+  colCount: number
+}
+
+/** 设计期网格布局（mm），供渲染与双击命中测试共用 */
+export function computeGridLayout(control: TableControl): GridLayout {
+  const grid = buildDesignGrid(control)
+  const colXs = gridColXs(control)
+  const rowHs = gridRowHeights(control)
+  const rowYs = [0]
+  for (const h of rowHs) rowYs.push(rowYs[rowYs.length - 1]! + h)
+  return { colXs, rowYs, rowCount: grid.rowCount, colCount: grid.colCount }
+}
+
+/** 计算双击点命中的单元格（fraction ∈ [0,1]） */
+export function hitTestCell(
+  layout: GridLayout,
+  fracX: number,
+  fracY: number,
+): { row: number; col: number } | null {
+  if (fracX < 0 || fracX > 1 || fracY < 0 || fracY > 1) return null
+  const x = fracX * layout.colXs[layout.colXs.length - 1]!
+  const y = fracY * layout.rowYs[layout.rowYs.length - 1]!
+  let col = 0
+  for (let c = 1; c < layout.colXs.length; c++) {
+    if (x <= layout.colXs[c]!) { col = c - 1; break }
+    col = c - 1
+  }
+  let row = 0
+  for (let r = 1; r < layout.rowYs.length; r++) {
+    if (y <= layout.rowYs[r]!) { row = r - 1; break }
+    row = r - 1
+  }
+  return { row, col }
+}
+
+function esc(s: string): string {
+  return s.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;')
+}
+
+/** 字段 → 占位符显示：含数组标记（items[].name）直接用路径，避免 {{item.items[].name}} 冗余前缀 */
+function fieldPlaceholder(field: string): string {
+  return field.includes('[]') ? `{{${field}}}` : `{{item.${field}}}`
+}
+
+function placeholderOf(cell: TableCell, col: TableColumn | undefined): string {
+  if (cell.expression) return cell.expression
+  if (cell.field) return fieldPlaceholder(cell.field)
+  if (col?.expression) return col.expression
+  if (col?.field) return fieldPlaceholder(col.field)
+  return ''
+}
+
+/**
+ * 单元格内联样式。
+ * 只输出**显式设置过**的属性，未设置的交给 css-generator 的 `.op-table` 类规则兜底
+ * （例如表头加粗、va-* 垂直对齐），保证设计期与运行期视觉一致。
+ */
+function cellStyle(
+  control: TableControl,
+  cell: TableCell,
+  col: TableColumn | undefined,
+  placeholder: boolean,
+  kind: DesignRowKind,
+): string {
+  const s = resolveCellStyleFor(control, col, cell, kind)
+  const parts: string[] = []
+  if (s.fontSize) parts.push(`font-size:${s.fontSize}pt`)
+  if (s.fontFamily) parts.push(`font-family:${s.fontFamily}`)
+  if (s.bold !== undefined) parts.push(`font-weight:${s.bold ? 'bold' : 'normal'}`)
+  if (s.italic !== undefined) parts.push(`font-style:${s.italic ? 'italic' : 'normal'}`)
+  if (s.underline !== undefined) parts.push(`text-decoration:${s.underline ? 'underline' : 'none'}`)
+  if (s.align) parts.push(`text-align:${s.align}`)
+  if (s.valign) parts.push(`vertical-align:${s.valign}`)
+  if (s.backgroundColor) parts.push(`background-color:${s.backgroundColor}`)
+  if (s.diagonal) parts.push(diagonalBackground(s.diagonal))
+  if (placeholder) parts.push(`color:${PLACEHOLDER}`)
+  else if (s.color) parts.push(`color:${s.color}`)
+  return parts.join(';')
+}
+
+/**
+ * 渲染设计期表格 HTML（表头 / 数据样例行 / 静态尾行）。
+ *
+ * 类名与运行期 html-renderer 完全一致（op-table / b-* / va-* / is-header / is-data），
+ * 因此同一份 CSS 即可驱动两端 —— 这正是"设计即打印"的根。
+ * 每个 td 带 `data-row` / `data-col`，供 overlay 做 DOM 级单元格定位与编辑写回。
+ */
+export function renderTableGridHtml(control: TableControl): string {
+  const grid = buildDesignGrid(control)
+  const opts = control.options ?? {}
+  const borders = opts.borders ?? 'all'
+  const va = opts.verticalAlign ?? 'middle'
+  const colXs = gridColXs(control)
+  const colWs = colXs.slice(1).map((_, i) => colXs[i + 1]! - colXs[i]!)
+  const rowHs = gridRowHeights(control)
+  // 合并布局（colSpan + rowSpan 一起算），与设计期渲染、运行期引擎共用同一份结果
+  const spanLayout = computeSpanLayout(grid.cells, grid.rowCount, grid.colCount)
+
+  const cols = colWs.map((w) => `<col style="width:${w}mm">`).join('')
+  const rows: string[] = []
+
+  for (let r = 0; r < grid.rowCount; r++) {
+    const isHeaderRow = r < grid.headerRows
+    const isDataRow = grid.isData && r === grid.headerRows
+    const kind: DesignRowKind = isHeaderRow ? 'header' : isDataRow ? 'data' : 'static'
+    const spanRow = spanLayout[r]!
+    const cells: string[] = []
+    let c = 0
+    while (c < grid.colCount) {
+      if (spanRow[c]!.skip) {
+        c++
+        continue
+      }
+      const cell = grid.cells[r]?.[c] ?? {}
+      const col = control.columns[c]
+      const span = spanRow[c]!.colSpan
+      const rspan = spanRow[c]!.rowSpan
+      const isAgg = isAggToken(cell.text)
+      const bound = Boolean(cell.field || cell.expression || (isDataRow && col?.field) || (isDataRow && col?.expression))
+      // 聚合 token（{{#totalSum}} 等）按占位符着色显示，提示用户这是动态计算单元格
+      const placeholder = bound || isAgg
+      const text = bound ? placeholderOf(cell, col) : (cell.text ?? '')
+      const style = cellStyle(control, cell, col, placeholder, kind)
+      const spanAttr = span > 1 ? ` colspan="${span}"` : ''
+      const rspanAttr = rspan > 1 ? ` rowspan="${rspan}"` : ''
+      const tdClass = isAgg ? ' is-agg' : ''
+      const styleAttr = style ? ` style="${style}"` : ''
+      cells.push(
+        `<td data-row="${r}" data-col="${c}"${spanAttr}${rspanAttr}${tdClass ? ` class="${tdClass}"` : ''}${styleAttr}>${esc(text) || '<br>'}</td>`,
+      )
+      c += span
+    }
+    const rh = rowHs[r]
+    let cls = isDataRow ? 'is-data is-template' : isHeaderRow ? 'is-header' : 'is-static'
+    // 聚合尾行（本页合计/总计/大写金额）对齐运行期 is-subtotal/is-summary 类，保证样式预设两端一致
+    if (!isHeaderRow && !isDataRow) {
+      const tokens = (grid.cells[r] ?? []).map((c) => parseAggToken(c.text))
+      if (tokens.some((t) => t === 'pageSum' || t === 'pageAvg' || t === 'pageCount')) cls = 'is-subtotal'
+      else if (tokens.some((t) => t === 'totalSum' || t === 'totalAvg' || t === 'totalCount' || t === 'pageCap' || t === 'totalCap')) cls = 'is-summary'
+    }
+    rows.push(`<tr class="${cls}" style="height:${rh}mm">${cells.join('')}</tr>`)
+  }
+
+  const tableStyle = opts.tableStyle ?? 'none'
+  return (
+    `<table class="op-node op-table b-${borders} va-${va} ts-${tableStyle}" ` +
+    `style="width:${control.width}mm;height:${control.height}mm;table-layout:fixed">` +
+    `<colgroup>${cols}</colgroup><tbody>${rows.join('')}</tbody></table>`
+  )
+}
diff --git a/openprint/src/design/canvas/table-style-presets.ts b/openprint/src/design/canvas/table-style-presets.ts
new file mode 100644
index 0000000..4a17e02
--- /dev/null
+++ b/openprint/src/design/canvas/table-style-presets.ts
@@ -0,0 +1,45 @@
+/**
+ * 表格样式预设元数据 —— 设计期「样式库」弹窗与属性面板共用的唯一真相源。
+ *
+ * 每个预设对应 css-generator.ts 里的一组 `.op-table.ts-<key>` 规则；
+ * 渲染端（table-design-render.ts / html-renderer.ts）把同名 class 挂在 <table> 上，
+ * 因此画布、预览、PDF、样式库预览四端视觉完全一致。
+ *
+ * 预设不只是"配色"——`borders` 可捆绑边框框线方案（如三线表 / 外框 / 全网格），
+ * 点击即同时套用配色与框线，类似 Excel 把"表格样式"与"框线"打包切换。
+ */
+import type { TableStylePreset } from '@/types/control'
+
+export interface TableStyleMeta {
+  /** 对应 <table> 上的 ts-<key> class 与 TableOptions.tableStyle 取值 */
+  key: TableStylePreset
+  /** 展示名（按钮 / 卡片标题） */
+  label: string
+  /** 一句话描述，帮助快速区分相近样式 */
+  desc: string
+  /** 可选：捆绑的边框框线方案；不填则只改配色、保留当前边框 */
+  borders?: 'all' | 'none' | 'horizontal' | 'outline' | 'three-line'
+}
+
+/** Excel 式表格样式库（按"从简到繁 / 配色 → 框线"排列） */
+export const TABLE_STYLE_PRESETS: TableStyleMeta[] = [
+  { key: 'none', label: '无样式', desc: '仅边框 + 表头加粗，无任何背景' },
+  { key: 'header', label: '表头高亮', desc: '浅灰表头' },
+  { key: 'header-dark', label: '深蓝表头', desc: '深蓝底白字' },
+  { key: 'header-green', label: '绿色表头', desc: '绿底白字' },
+  { key: 'zebra', label: '斑马纹', desc: '浅蓝交替行' },
+  { key: 'zebra-blue', label: '蓝纹', desc: '深蓝交替行' },
+  { key: 'zebra-gray', label: '灰纹', desc: '灰色交替行' },
+  { key: 'three-segment', label: '三段式', desc: '表头 + 合计强调' },
+  { key: 'banded-cols', label: '隔列着色', desc: '奇偶列交替底' },
+  // —— 框线类（配色 + 边框打包） ——
+  { key: 'grid', label: '全网格', desc: '全框线 + 无配色', borders: 'all' },
+  { key: 'minimal', label: '极简外框', desc: '仅外框、无内线', borders: 'outline' },
+  { key: 'report', label: '三线表', desc: '顶/表头底/底线，无内线（报表风）', borders: 'three-line' },
+  { key: 'timetable', label: '课表', desc: '全网格 + 表头高亮（角标斜线见单元格）', borders: 'all' },
+]
+
+/** 预设 key → 展示名（未知值回落「无样式」） */
+export function tableStyleLabel(key: TableStylePreset | undefined | null): string {
+  return TABLE_STYLE_PRESETS.find((p) => p.key === key)?.label ?? '无样式'
+}
diff --git a/openprint/src/design/canvas/zoom.ts b/openprint/src/design/canvas/zoom.ts
new file mode 100644
index 0000000..72ef524
--- /dev/null
+++ b/openprint/src/design/canvas/zoom.ts
@@ -0,0 +1,15 @@
+/**
+ * 缩放工具函数（CanvasDesigner 的纯函数部分，供工具栏/快捷键复用）
+ */
+import { ZOOM_MAX, ZOOM_MIN, ZOOM_STEP } from '@/utils/constants'
+
+export const clampZoom = (z: number): number => Math.min(ZOOM_MAX, Math.max(ZOOM_MIN, z))
+
+export const nextZoomIn = (z: number): number => clampZoom(Math.round((z + ZOOM_STEP) * 100) / 100)
+export const nextZoomOut = (z: number): number => clampZoom(Math.round((z - ZOOM_STEP) * 100) / 100)
+
+/** 缩放百分比显示（100% / 125% ...） */
+export const zoomLabel = (z: number): string => `${Math.round(z * 100)}%`
+
+/** 常用缩放下拉档位 */
+export const ZOOM_PRESETS = [0.25, 0.5, 0.75, 1, 1.5, 2, 3, 4] as const
diff --git a/openprint/src/design/composables/useConfirm.ts b/openprint/src/design/composables/useConfirm.ts
new file mode 100644
index 0000000..0560213
--- /dev/null
+++ b/openprint/src/design/composables/useConfirm.ts
@@ -0,0 +1,48 @@
+/**
+ * useConfirm —— 统一的「确认」弹窗（应用内系统弹窗）
+ *
+ * 取代浏览器原生 window.confirm / window.alert：
+ *   - 原生 confirm 是浏览器 Chrome 级别的 UI，与项目主题/设计语言割裂，且阻塞线程；
+ *   - 本封装基于 naive-ui 的 NDialogProvider（App.vue 已挂载 <NDialogProvider>），
+ *     弹窗随亮/暗主题自适应，文案与按钮可定制，体验一致。
+ *
+ * 用法（必须在组件 <script setup> 顶层调用，useDialog 依赖 inject 只能在此处取 provider）：
+ *   const { confirm } = useConfirm()
+ *   async function onUse() {
+ *     if (store.dirty && !(await confirm('将覆盖未保存的改动，确定继续？'))) return
+ *     ...
+ *   }
+ *
+ * confirm() 返回 Promise<boolean>：点「确定」resolve(true)，点「取消」/关闭/点遮罩 resolve(false)。
+ * Promise 的 resolve 幂等，重复触发不会翻转结果。
+ */
+import { useDialog } from 'naive-ui'
+
+export interface ConfirmOptions {
+  /** 弹窗标题，默认「确认操作」 */
+  title?: string
+  /** 确定按钮文案，默认「确定」 */
+  positiveText?: string
+  /** 取消按钮文案，默认「取消」 */
+  negativeText?: string
+}
+
+export function useConfirm() {
+  const dialog = useDialog()
+
+  function confirm(message: string, opts: ConfirmOptions = {}): Promise<boolean> {
+    return new Promise<boolean>((resolve) => {
+      dialog.warning({
+        title: opts.title ?? '确认操作',
+        content: message,
+        positiveText: opts.positiveText ?? '确定',
+        negativeText: opts.negativeText ?? '取消',
+        onPositiveClick: () => resolve(true),
+        onNegativeClick: () => resolve(false),
+        onClose: () => resolve(false),
+      })
+    })
+  }
+
+  return { confirm }
+}
diff --git a/openprint/src/design/composables/usePrinterProbe.ts b/openprint/src/design/composables/usePrinterProbe.ts
new file mode 100644
index 0000000..de62dcb
--- /dev/null
+++ b/openprint/src/design/composables/usePrinterProbe.ts
@@ -0,0 +1,109 @@
+/**
+ * 打印客户端探测状态 —— 模块级单例，顶栏状态灯与打印弹窗共用一份
+ *
+ * 为什么做成单例：
+ * - 顶栏打印按钮要常驻显示连接状态；打印弹窗打开时也要拿打印机列表。
+ *   两处各自请求会重复打扰本机服务，也会出现状态不同步（顶栏红点 / 弹窗已连接）。
+ * - 这里用模块级 ref 共享，一次探测两处同时更新；并发调用合并为同一个 inflight Promise。
+ */
+import { computed, ref } from 'vue'
+import {
+  checkHealth,
+  describePrintError,
+  listPrinters,
+  type PrinterHealth,
+  type PrinterInfo,
+} from '@/core/print-client'
+import { resolvePrinterBaseUrl } from '@/config/printer'
+
+/** idle=从未探测 / checking=探测中 / connected=已连接 / disconnected=不可达 */
+export type PrinterProbeState = 'idle' | 'checking' | 'connected' | 'disconnected'
+
+const state = ref<PrinterProbeState>('idle')
+const health = ref<PrinterHealth | null>(null)
+const printers = ref<PrinterInfo[]>([])
+const errorText = ref('')
+const baseUrl = ref(resolvePrinterBaseUrl())
+const checkedAt = ref(0)
+
+let inflight: Promise<boolean> | null = null
+
+/** 在线且可用的打印机（离线的仍在列表里，只是不可选） */
+const onlinePrinters = computed(() => printers.value.filter((p) => p.isOnline))
+
+/** 默认打印机（服务端标记 isDefault，否则取第一台在线的） */
+const defaultPrinter = computed<PrinterInfo | null>(
+  () => printers.value.find((p) => p.isDefault) ?? onlinePrinters.value[0] ?? printers.value[0] ?? null,
+)
+
+/** 一句话状态描述（顶栏 tooltip / 弹窗提示复用） */
+const summary = computed(() => {
+  switch (state.value) {
+    case 'idle':
+      return '打印客户端：未检测'
+    case 'checking':
+      return '正在检测打印客户端…'
+    case 'connected': {
+      const h = health.value
+      const v = h?.version ? ` v${h.version}` : ''
+      return `打印客户端已连接（${h?.app ?? 'OpenPrint'}${v} · ${printers.value.length} 台打印机）`
+    }
+    case 'disconnected':
+      return `打印客户端不可达：${errorText.value || '未知原因'}`
+  }
+})
+
+/**
+ * 执行一次探测：/health 判活 → /printers 取列表。
+ * 并发调用共享同一次请求；返回是否连接成功。
+ */
+async function probe(): Promise<boolean> {
+  if (inflight) return inflight
+  state.value = 'checking'
+  errorText.value = ''
+  const base = resolvePrinterBaseUrl()
+  baseUrl.value = base
+
+  inflight = (async () => {
+    try {
+      health.value = await checkHealth(base)
+      printers.value = await listPrinters(base)
+      state.value = 'connected'
+      return true
+    } catch (e) {
+      health.value = null
+      printers.value = []
+      errorText.value = describePrintError(e)
+      state.value = 'disconnected'
+      return false
+    } finally {
+      checkedAt.value = Date.now()
+      inflight = null
+    }
+  })()
+
+  return inflight
+}
+
+/** 距上次探测超过 ttl（默认 15s）才重新探测，避免频繁打扰本机服务 */
+async function probeIfStale(ttlMs = 15000): Promise<boolean> {
+  if (state.value === 'connected' && Date.now() - checkedAt.value < ttlMs) return true
+  if (state.value === 'checking' && inflight) return inflight
+  return probe()
+}
+
+export function usePrinterProbe() {
+  return {
+    state,
+    health,
+    printers,
+    onlinePrinters,
+    defaultPrinter,
+    errorText,
+    baseUrl,
+    checkedAt,
+    summary,
+    probe,
+    probeIfStale,
+  }
+}
diff --git a/openprint/src/design/format-options.ts b/openprint/src/design/format-options.ts
new file mode 100644
index 0000000..8396cf7
--- /dev/null
+++ b/openprint/src/design/format-options.ts
@@ -0,0 +1,78 @@
+/**
+ * 单元格数据格式 —— 属性面板 / 单元格工具栏共用的 UI 选项与默认值。
+ * 类型定义见 src/types/control.ts 的 CellFormat / CellFormatKind；
+ * 实际格式化由 core/layout-engine/expression.ts 的 formatCellValue 完成（与 `{{field | date:'...'}}` 过滤器等价）。
+ */
+import type { CellFormat, CellFormatKind } from '@/types/control'
+
+/** 格式类型下拉选项 */
+export const formatKindOptions: Array<{ label: string; value: CellFormatKind }> = [
+  { label: '默认（不格式化）', value: 'none' },
+  { label: '文本', value: 'text' },
+  { label: '日期', value: 'date' },
+  { label: '整数', value: 'int' },
+  { label: '小数', value: 'decimal' },
+  { label: '货币', value: 'currency' },
+  { label: '百分比', value: 'percent' },
+]
+
+/** 日期模板预设（pattern 即 formatDate 的模板语法） */
+export const datePatternOptions: Array<{ label: string; value: string }> = [
+  { label: '2026-08-11（年-月-日）', value: 'YYYY-MM-DD' },
+  { label: '2026/08/11（年/月/日）', value: 'YYYY/MM/DD' },
+  { label: '2026年08月11日', value: 'YYYY年MM月DD日' },
+  { label: '08/11/2026（美式 月/日/年）', value: 'MM/DD/YYYY' },
+  { label: '11/08/2026（欧式 日/月/年）', value: 'DD/MM/YYYY' },
+  { label: '2026-08-11 14:30（带时间）', value: 'YYYY-MM-DD HH:mm' },
+  { label: '自定义…', value: '__custom__' },
+]
+
+/** 货币代码选项（与 expression.ts 的 CURRENCY_SYMBOL 对应） */
+export const currencyCodeOptions: Array<{ label: string; value: string }> = [
+  { label: '人民币 CNY（¥）', value: 'CNY' },
+  { label: '美元 USD（$）', value: 'USD' },
+  { label: '欧元 EUR（€）', value: 'EUR' },
+  { label: '英镑 GBP（£）', value: 'GBP' },
+  { label: '港币 HKD（HK$）', value: 'HKD' },
+  { label: '日元 JPY（¥）', value: 'JPY' },
+]
+
+/** 按类型生成该种类的默认格式（用户第一次选择某类型时套用） */
+export function makeFormat(kind: CellFormatKind): CellFormat {
+  switch (kind) {
+    case 'date':
+      return { kind, pattern: 'YYYY-MM-DD' }
+    case 'int':
+      return { kind, thousands: true }
+    case 'decimal':
+      return { kind, digits: 2, thousands: true }
+    case 'currency':
+      return { kind, code: 'CNY', digits: 2, thousands: true }
+    case 'percent':
+      return { kind, digits: 2 }
+    case 'none':
+    case 'text':
+    default:
+      return { kind: 'none' }
+  }
+}
+
+export function needsPattern(kind: CellFormatKind | undefined): boolean {
+  return kind === 'date'
+}
+export function needsDigits(kind: CellFormatKind | undefined): boolean {
+  return kind === 'int' || kind === 'decimal' || kind === 'currency' || kind === 'percent'
+}
+export function needsCode(kind: CellFormatKind | undefined): boolean {
+  return kind === 'currency'
+}
+export function supportsThousands(kind: CellFormatKind | undefined): boolean {
+  return kind === 'int' || kind === 'decimal' || kind === 'currency'
+}
+
+/** 由数据源字段类型推荐一个默认格式类型（仅作 UI 提示，不直接落库） */
+export function suggestKindByFieldType(type: string | undefined): CellFormatKind | null {
+  if (type === 'date') return 'date'
+  if (type === 'number') return 'decimal'
+  return null
+}
diff --git a/openprint/src/design/hooks/useDragAdd.ts b/openprint/src/design/hooks/useDragAdd.ts
new file mode 100644
index 0000000..07c3377
--- /dev/null
+++ b/openprint/src/design/hooks/useDragAdd.ts
@@ -0,0 +1,94 @@
+/**
+ * useDragAdd —— 从控件库拖入画布生成控件
+ *
+ * 交互：控件库卡片 draggable → dragstart 写入控件类型 →
+ * 画布容器 dragover 允许放置 → drop 时把 client 坐标换算为
+ * 相对页边距内容区（或页眉/页脚区域）的 mm 坐标，调用 store.addControlOfType。
+ */
+import { onBeforeUnmount, onMounted, type Ref } from 'vue'
+import type { AnyControl, ControlType } from '@/types/control'
+import { useDesignerStore } from '@/design/stores/designer'
+import { MM_TO_PX } from '@/utils/constants'
+
+export const DRAG_TYPE_KEY = 'application/x-openprint-control'
+
+/** 拖拽时携带的额外初始属性（如圆形 shape），同标签页内拖拽为同步过程，用模块级变量传递 */
+let pendingInit: Partial<AnyControl> | undefined
+
+/** 控件库侧：卡片 dragstart 调用；init 允许注入额外初始属性 */
+export function startControlDrag(e: DragEvent, type: ControlType, init?: Partial<AnyControl>): void {
+  e.dataTransfer?.setData(DRAG_TYPE_KEY, type)
+  pendingInit = init
+  if (e.dataTransfer) e.dataTransfer.effectAllowed = 'copy'
+}
+
+/** 画布侧：挂载到画布容器，处理 drop */
+export function useDragAdd(stageRef: Ref<HTMLElement | null>): void {
+  const store = useDesignerStore()
+
+  const onDragOver = (e: DragEvent) => {
+    if (e.dataTransfer?.types.includes(DRAG_TYPE_KEY)) {
+      e.preventDefault()
+      e.dataTransfer.dropEffect = 'copy'
+    }
+  }
+
+  const onDrop = (e: DragEvent) => {
+    const type = e.dataTransfer?.getData(DRAG_TYPE_KEY) as ControlType | ''
+    if (!type || !stageRef.value) return
+    e.preventDefault()
+
+    const init = pendingInit
+    pendingInit = undefined
+
+    const rect = stageRef.value.getBoundingClientRect()
+    const vp = store.viewport
+    const d = store.designer
+    if (!d) return
+
+    // client px → 画布 mm（相对页面左上角）
+    const canvasX = e.clientX - rect.left
+    const canvasY = e.clientY - rect.top
+    const pageMmX = (canvasX - vp.offsetX) / (MM_TO_PX * vp.zoom)
+    const pageMmY = (canvasY - vp.offsetY) / (MM_TO_PX * vp.zoom)
+
+    // 检测是否拖入页眉/页脚区域
+    let zoneHostId: string | undefined
+    let origin = { x: d.marginMm.left, y: d.marginMm.top }
+
+    for (const z of d.getZones()) {
+      const b = z.getBoundingRect()
+      // 将 zone 画布坐标转为 stage-container px
+      const zLeft = b.left * vp.zoom + vp.offsetX
+      const zRight = (b.left + b.width) * vp.zoom + vp.offsetX
+      const zTop = b.top * vp.zoom + vp.offsetY
+      const zBottom = (b.top + b.height) * vp.zoom + vp.offsetY
+      if (canvasX >= zLeft && canvasX <= zRight && canvasY >= zTop && canvasY <= zBottom) {
+        zoneHostId = z.controlId
+        // 相对色带左上角（mm）
+        origin = { x: b.left / MM_TO_PX, y: b.top / MM_TO_PX }
+        break
+      }
+    }
+
+    store.addControlOfType(
+      type,
+      {
+        leftMm: pageMmX - origin.x,
+        topMm: pageMmY - origin.y,
+      },
+      init,
+      zoneHostId,
+    )
+  }
+
+  onMounted(() => {
+    stageRef.value?.addEventListener('dragover', onDragOver)
+    stageRef.value?.addEventListener('drop', onDrop)
+  })
+
+  onBeforeUnmount(() => {
+    stageRef.value?.removeEventListener('dragover', onDragOver)
+    stageRef.value?.removeEventListener('drop', onDrop)
+  })
+}
\ No newline at end of file
diff --git a/openprint/src/design/hooks/useHotkey.ts b/openprint/src/design/hooks/useHotkey.ts
new file mode 100644
index 0000000..fc8e359
--- /dev/null
+++ b/openprint/src/design/hooks/useHotkey.ts
@@ -0,0 +1,70 @@
+/**
+ * useHotkey —— 全局快捷键（删除/复制/撤销/重做/取消选中）
+ * 安装在 CanvasStage，仅在画布可见时生效。
+ */
+import { onBeforeUnmount, onMounted } from 'vue'
+import { useDesignerStore } from '@/design/stores/designer'
+import type { AnyControl } from '@/types/control'
+import { genId } from '@/utils/id'
+
+const MAC = /Mac|iPhone|iPad/.test(navigator.platform)
+
+export function useHotkey(): void {
+  const store = useDesignerStore()
+
+  function onKeyDown(e: KeyboardEvent): void {
+    // 忽略输入框内按键
+    if (
+      (e.target as HTMLElement)?.tagName === 'INPUT' ||
+      (e.target as HTMLElement)?.tagName === 'TEXTAREA' ||
+      (e.target as HTMLElement)?.isContentEditable
+    )
+      return
+
+    const mod = MAC ? e.metaKey : e.ctrlKey
+
+    // Ctrl/Cmd + Z = 撤销
+    if (mod && !e.shiftKey && e.key === 'z') {
+      e.preventDefault()
+      store.undo()
+      return
+    }
+    // Ctrl/Cmd + Shift + Z or Ctrl+Y = 重做
+    if ((mod && e.shiftKey && e.key === 'z') || (mod && e.key === 'y')) {
+      e.preventDefault()
+      store.redo()
+      return
+    }
+    // Delete / Backspace = 删除选中控件
+    if ((e.key === 'Delete' || e.key === 'Backspace') && store.selectedIds.length > 0) {
+      e.preventDefault()
+      for (const id of store.selectedIds) {
+        store.removeControl(id)
+      }
+      return
+    }
+    // Ctrl/Cmd + D = 复制选中控件（偏右下 10mm）
+    if (mod && e.key === 'd' && store.selectedIds.length > 0) {
+      e.preventDefault()
+      for (const id of store.selectedIds) {
+        const src = store.controls.find((c) => c.id === id) ?? store.zones.find((z) => z.id === id || z.children.some((c) => c.id === id))
+        if (!src || src.type === 'zone') continue // zone 不复制
+        const clone: AnyControl = JSON.parse(JSON.stringify(src))
+        clone.id = genId()
+        clone.left += 10
+        clone.top += 10
+        store.controls.push(clone)
+        store.designer?.addControl(clone)
+      }
+      return
+    }
+    // Escape = 取消选中
+    if (e.key === 'Escape') {
+      store.selectControl(null)
+      return
+    }
+  }
+
+  onMounted(() => window.addEventListener('keydown', onKeyDown))
+  onBeforeUnmount(() => window.removeEventListener('keydown', onKeyDown))
+}
diff --git a/openprint/src/design/modals/DataImportModal.vue b/openprint/src/design/modals/DataImportModal.vue
new file mode 100644
index 0000000..5204ac1
--- /dev/null
+++ b/openprint/src/design/modals/DataImportModal.vue
@@ -0,0 +1,344 @@
+<script setup lang="ts">
+/**
+ * DataImportModal —— 顶部「导入数据」入口弹窗
+ *
+ * 流程：选文件（CSV / JSON / Excel）→ 解析 → 预览（首行为标题、表头悬浮 × 直接删列、行可删）
+ * → 确认后由 designer.importTable 在画布生成「内嵌数据表格」（自动居中、自动分页）。
+ * 数据直接长进表格控件（control.data），与 dataSource 字段绑定解耦。
+ */
+import { computed, ref } from 'vue'
+import { NButton, NCheckbox, NModal, NSpin, NText, useMessage } from 'naive-ui'
+import { useDesignerStore } from '@/design/stores/designer'
+import { parseDataFile, type ImportColumn, type ParsedData } from '@/design/utils/data-import'
+
+const props = defineProps<{ show: boolean }>()
+const emit = defineEmits<{ (e: 'update:show', value: boolean): void }>()
+
+const store = useDesignerStore()
+const message = useMessage()
+
+const fileInput = ref<HTMLInputElement | null>(null)
+const parsed = ref<ParsedData | null>(null)
+const sourceName = ref('')
+/** 当前保留的列（删列即从此数组 splice，不可恢复，需重新选文件才能找回） */
+const columns = ref<ImportColumn[]>([])
+const deletedRows = ref<Set<number>>(new Set())
+const loading = ref(false)
+const error = ref('')
+
+/** 预览最多渲染的行数（其余行仍会完整导入，只是不全部渲染到 DOM） */
+const PREVIEW_ROWS = 200
+
+/** 预览里展示的行：剔除已删行，最多 PREVIEW_ROWS 条（保留原始下标用于删行映射） */
+const previewRows = computed<Array<{ index: number; cells: string[] }>>(() => {
+  if (!parsed.value) return []
+  const cols = columns.value
+  const out: Array<{ index: number; cells: string[] }> = []
+  parsed.value.rows.forEach((row, i) => {
+    if (deletedRows.value.has(i)) return
+    if (out.length >= PREVIEW_ROWS) return
+    out.push({ index: i, cells: cols.map((c) => String(row[c.key] ?? '')) })
+  })
+  return out
+})
+
+const stats = computed(() => {
+  if (!parsed.value) return ''
+  const totalRows = parsed.value.rows.length - deletedRows.value.size
+  return `${columns.value.length} 列 · ${totalRows} 行${
+    deletedRows.value.size ? `（已删 ${deletedRows.value.size} 行）` : ''
+  }`
+})
+
+const modalTitle = computed(() =>
+  parsed.value ? `导入数据 · ${sourceName.value}` : '导入数据',
+)
+
+function triggerFile(): void {
+  fileInput.value?.click()
+}
+
+async function onFileChange(e: Event): Promise<void> {
+  const target = e.target as HTMLInputElement
+  const file = target.files?.[0]
+  target.value = '' // 允许重复选同一文件
+  if (!file) return
+  loading.value = true
+  error.value = ''
+  try {
+    const data = await parseDataFile(file)
+    parsed.value = data
+    sourceName.value = data.sourceName
+    columns.value = data.columns.map((c) => ({ ...c }))
+    deletedRows.value = new Set()
+  } catch (err) {
+    error.value = err instanceof Error ? err.message : String(err)
+    parsed.value = null
+  } finally {
+    loading.value = false
+  }
+}
+
+/** 表头 × ：直接删除该列（splice，不可恢复；要找回需重新选文件） */
+function removeColumn(key: string): void {
+  columns.value = columns.value.filter((c) => c.key !== key)
+}
+
+function toggleRow(index: number, keep: boolean): void {
+  const next = new Set(deletedRows.value)
+  if (keep) next.delete(index)
+  else next.add(index)
+  deletedRows.value = next
+}
+
+function setAllRows(keep: boolean): void {
+  deletedRows.value = keep
+    ? new Set()
+    : new Set(parsed.value ? parsed.value.rows.map((_, i) => i) : [])
+}
+
+function confirmImport(): void {
+  if (!parsed.value) return
+  const cols = columns.value
+  if (cols.length === 0) {
+    message.error('至少保留一列')
+    return
+  }
+  const records = parsed.value.rows
+    .map((row, i) => ({ row, i }))
+    .filter(({ i }) => !deletedRows.value.has(i))
+    .map(({ row }) => {
+      const o: Record<string, unknown> = {}
+      for (const c of cols) o[c.key] = row[c.key] ?? ''
+      return o
+    })
+  store.importTable({
+    columns: cols.map((c) => ({ key: c.key, title: c.title })),
+    records,
+    sourceName: sourceName.value,
+  })
+  message.success(`已导入 ${records.length} 行 / ${cols.length} 列，自动生成居中的分页表格`)
+  close()
+}
+
+function close(): void {
+  emit('update:show', false)
+  parsed.value = null
+  sourceName.value = ''
+  columns.value = []
+  deletedRows.value = new Set()
+  error.value = ''
+}
+</script>
+
+<template>
+  <NModal
+    :show="props.show"
+    preset="card"
+    display-directive="if"
+    :title="modalTitle"
+    :mask-closable="false"
+    style="width: 880px; max-width: 94vw"
+    @update:show="emit('update:show', $event)"
+  >
+    <div class="flex flex-col gap-4">
+      <!-- 文件选择 -->
+      <div v-if="!parsed" class="flex flex-col items-center gap-3 py-8">
+        <NButton type="primary" size="large" @click="triggerFile">
+          <div class="i-carbon-document-import mr-1 text-16px" />
+          选择文件（CSV / JSON / Excel）
+        </NButton>
+        <NText depth="3" class="text-12px">
+          支持 .csv / .json / .xlsx / .xls，第一行作为列标题，表名取自文件名
+        </NText>
+        <NSpin v-if="loading" />
+        <NText v-if="error" type="error" class="text-12px">{{ error }}</NText>
+        <input
+          ref="fileInput"
+          type="file"
+          accept=".csv,.json,.xlsx,.xls"
+          style="display: none"
+          @change="onFileChange"
+        />
+      </div>
+
+      <!-- 预览与编辑 -->
+      <template v-else>
+        <!-- 顶部信息条 -->
+        <div class="flex items-center justify-between">
+          <div class="flex items-center gap-2">
+            <div class="i-carbon-document text-16px" />
+            <NText class="text-13px font-medium">{{ sourceName }}</NText>
+            <NText depth="3" class="text-12px">{{ stats }}</NText>
+          </div>
+          <NButton size="small" tertiary @click="triggerFile">重新选择</NButton>
+        </div>
+
+        <!-- 数据预览：固定显示区，上下左右滚动；表头悬浮 × 直接删列 -->
+        <div class="flex flex-col gap-2">
+          <div class="flex items-center justify-between">
+            <NText depth="2" class="text-12px">
+              数据预览（表头悬浮显示 × 可删除该列；勾选行可删除；仅渲染前 {{ PREVIEW_ROWS }} 行，其余行仍会完整导入）
+            </NText>
+            <div class="flex gap-2">
+              <NButton size="tiny" tertiary @click="setAllRows(true)">保留全部行</NButton>
+              <NButton size="tiny" tertiary @click="setAllRows(false)">删除全部行</NButton>
+            </div>
+          </div>
+          <div class="preview-scroll">
+            <table class="import-preview-table">
+              <thead>
+                <tr>
+                  <th class="row-check-col"></th>
+                  <th v-for="c in columns" :key="c.key" class="col-th">
+                    <input
+                      class="th-title-input"
+                      :value="c.title"
+                      :title="c.title"
+                      @input="(e: Event) => (c.title = (e.target as HTMLInputElement).value)"
+                    />
+                    <button
+                      type="button"
+                      class="th-del"
+                      title="删除该列"
+                      @click="removeColumn(c.key)"
+                    >
+                      <div class="i-carbon-close" />
+                    </button>
+                  </th>
+                </tr>
+              </thead>
+              <tbody>
+                <tr v-for="row in previewRows" :key="row.index">
+                  <td class="row-check-col">
+                    <NCheckbox
+                      :checked="!deletedRows.has(row.index)"
+                      @update:checked="(v: boolean) => toggleRow(row.index, v)"
+                    />
+                  </td>
+                  <td v-for="(cell, ci) in row.cells" :key="ci" :title="cell">{{ cell }}</td>
+                </tr>
+                <tr v-if="previewRows.length === 0">
+                  <td :colspan="columns.length + 1" class="text-center op-60 text-12px py-3">
+                    没有可显示的行（可能已全部删除）
+                  </td>
+                </tr>
+              </tbody>
+            </table>
+          </div>
+        </div>
+      </template>
+    </div>
+
+    <template #footer>
+      <div class="flex justify-end gap-2">
+        <NButton size="small" @click="close">取消</NButton>
+        <NButton v-if="parsed" size="small" type="primary" @click="confirmImport">确认导入</NButton>
+      </div>
+    </template>
+  </NModal>
+</template>
+
+<style scoped>
+/* 数据预览：固定合适显示区域，原生双向滚动（表头吸顶） */
+.preview-scroll {
+  height: 340px;
+  overflow: auto;
+  border: 1px solid var(--brand-border, #e5e7eb);
+  border-radius: 6px;
+  scrollbar-width: thin;
+}
+.preview-scroll::-webkit-scrollbar {
+  width: 10px;
+  height: 10px;
+}
+.preview-scroll::-webkit-scrollbar-thumb {
+  background: var(--brand-border, #d4d6d9);
+  border-radius: 6px;
+}
+.preview-scroll::-webkit-scrollbar-thumb:hover {
+  background: var(--brand-text-3, #b0b3b8);
+}
+
+.import-preview-table {
+  border-collapse: collapse;
+  font-size: 12px;
+  min-width: 100%;
+}
+.import-preview-table th,
+.import-preview-table td {
+  border: 1px solid var(--brand-border, #eceef1);
+  padding: 4px 10px;
+  text-align: left;
+  white-space: nowrap;
+  max-width: 240px;
+  overflow: hidden;
+  text-overflow: ellipsis;
+}
+.import-preview-table thead th {
+  position: sticky;
+  top: 0;
+  z-index: 1;
+  background: var(--brand-bg-hover, #f5f6f7);
+  font-weight: 600;
+  white-space: nowrap;
+}
+.import-preview-table .row-check-col {
+  width: 44px;
+  min-width: 44px;
+  text-align: center;
+}
+.import-preview-table tbody tr:hover {
+  background: var(--brand-bg-hover, rgba(128, 128, 128, 0.08));
+}
+
+/* 表头列：标题可编辑 + 悬浮显示删除按钮 */
+.col-th {
+  position: relative;
+  padding-right: 22px !important;
+}
+.th-title-input {
+  width: 100%;
+  min-width: 48px;
+  border: none;
+  outline: none;
+  background: transparent;
+  font: inherit;
+  font-weight: 600;
+  color: var(--brand-text-1, #111827);
+  padding: 0;
+  cursor: text;
+}
+.th-title-input:focus {
+  outline: 1px solid var(--brand, #2563eb);
+  border-radius: 2px;
+}
+.th-del {
+  position: absolute;
+  top: 50%;
+  right: 4px;
+  transform: translateY(-50%);
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  width: 16px;
+  height: 16px;
+  border: none;
+  border-radius: 4px;
+  background: transparent;
+  color: var(--brand-text-3, #6b7280);
+  cursor: pointer;
+  font-size: 13px;
+  line-height: 1;
+  opacity: 0;
+  transition: opacity 0.12s, background 0.12s, color 0.12s;
+}
+.col-th:hover .th-del,
+.th-del:focus-visible {
+  opacity: 1;
+}
+.th-del:hover {
+  background: var(--brand-danger, #ef4444);
+  color: #fff;
+}
+</style>
diff --git a/openprint/src/design/modals/JsonViewerModal.vue b/openprint/src/design/modals/JsonViewerModal.vue
new file mode 100644
index 0000000..b158d2f
--- /dev/null
+++ b/openprint/src/design/modals/JsonViewerModal.vue
@@ -0,0 +1,224 @@
+<script setup lang="ts">
+/**
+ * JsonViewerModal —— 当前画布 JSON 数据查看器（只读 CodeMirror 6 + JSON 语法高亮）
+ * 数据源：store.buildTemplate() 的序列化结果。
+ * 直接使用 CodeMirror 6 底层 API（EditorView + EditorState），
+ * 不依赖 vue-codemirror6 包装组件（存在 Vue 3 Options/Composition ref 绑定不兼容的问题）。
+ * 暗/亮主题通过 EditorView.theme() 自定义（无需 @codemirror/theme-one-dark 额外依赖）。
+ */
+import { computed, nextTick, ref, watch } from 'vue'
+import { NButton, NModal, useMessage } from 'naive-ui'
+import { json as jsonLang } from '@codemirror/lang-json'
+import { EditorView } from '@codemirror/view'
+import { EditorState } from '@codemirror/state'
+import { HighlightStyle, syntaxHighlighting } from '@codemirror/language'
+import { tags as t } from '@lezer/highlight'
+import { basicSetup } from 'codemirror'
+import { useDesignerStore } from '@/design/stores/designer'
+import { useUiStore } from '@/design/stores/ui'
+
+const props = defineProps<{ show: boolean }>()
+const emit = defineEmits<{ (e: 'update:show', v: boolean): void }>()
+
+const store = useDesignerStore()
+const uiStore = useUiStore()
+const message = useMessage()
+
+const isDark = computed(() => uiStore.effectiveTheme === 'dark')
+
+/** CodeMirror 容器 DOM ref */
+const editorContainerRef = ref<HTMLElement | null>(null)
+/** CodeMirror EditorView 实例 */
+let editorView: EditorView | null = null
+
+/** 暗色主题（Catppuccin Mocha 配色）—— 编辑器外观 + 语法高亮 */
+const darkTheme = EditorView.theme({
+  '&': { backgroundColor: '#1e1e2e', color: '#cdd6f4' },
+  '.cm-content': {
+    caretColor: '#89b4fa',
+    fontFamily: "'JetBrains Mono', 'Fira Code', monospace",
+    fontSize: '13px',
+  },
+  '.cm-gutters': {
+    backgroundColor: '#181825',
+    color: '#45475a',
+    borderRight: '1px solid #313244',
+  },
+  '.cm-activeLine': { backgroundColor: 'rgba(89, 89, 120, 0.2)' },
+  '.cm-activeLineGutter': { backgroundColor: 'rgba(89, 89, 120, 0.3)', color: '#bac2de' },
+  '&.cm-focused .cm-selectionBackground, .cm-selectionBackground': {
+    backgroundColor: 'rgba(89, 89, 120, 0.4)',
+  },
+})
+
+const darkHighlightStyle = HighlightStyle.define([
+  { tag: t.string, color: '#a6e3a1' },
+  { tag: t.number, color: '#fab387' },
+  { tag: t.bool, color: '#f38ba8' },
+  { tag: t.null, color: '#f38ba8' },
+  { tag: t.propertyName, color: '#89b4fa' },
+  { tag: t.keyword, color: '#cba6f7' },
+  { tag: t.comment, color: '#6c7086', fontStyle: 'italic' },
+  { tag: t.punctuation, color: '#9399b2' },
+  { tag: t.separator, color: '#9399b2' },
+  { tag: t.bracket, color: '#9399b2' },
+])
+
+/** 亮色主题 */
+const lightTheme = EditorView.theme({
+  '&': { backgroundColor: '#ffffff', color: '#333333' },
+  '.cm-content': {
+    caretColor: '#1677ff',
+    fontFamily: "'JetBrains Mono', 'Fira Code', monospace",
+    fontSize: '13px',
+  },
+  '.cm-gutters': {
+    backgroundColor: '#fafafa',
+    color: '#bbb',
+    borderRight: '1px solid #eee',
+  },
+  '.cm-activeLine': { backgroundColor: 'rgba(22, 119, 255, 0.06)' },
+  '.cm-activeLineGutter': { backgroundColor: 'rgba(22, 119, 255, 0.1)', color: '#666' },
+  '&.cm-focused .cm-selectionBackground, .cm-selectionBackground': {
+    backgroundColor: 'rgba(22, 119, 255, 0.15)',
+  },
+})
+
+const lightHighlightStyle = HighlightStyle.define([
+  { tag: t.string, color: '#0b7a5f' },
+  { tag: t.number, color: '#c4531c' },
+  { tag: t.bool, color: '#d6336c' },
+  { tag: t.null, color: '#d6336c' },
+  { tag: t.propertyName, color: '#1677ff' },
+  { tag: t.keyword, color: '#7c3aed' },
+  { tag: t.comment, color: '#999', fontStyle: 'italic' },
+  { tag: t.punctuation, color: '#666' },
+  { tag: t.separator, color: '#666' },
+  { tag: t.bracket, color: '#666' },
+])
+
+/** 构建 CodeMirror extensions */
+function buildExtensions(jsonText: string): ReturnType<typeof EditorState.create> {
+  const dark = isDark.value
+  return EditorState.create({
+    doc: jsonText,
+    extensions: [
+      basicSetup,
+      jsonLang(),
+      syntaxHighlighting(dark ? darkHighlightStyle : lightHighlightStyle),
+      EditorView.editable.of(false),
+      EditorState.readOnly.of(true),
+      dark ? darkTheme : lightTheme,
+      EditorView.lineWrapping,
+    ],
+  })
+}
+
+/** 创建/重建编辑器（直接使用 DOM API 查找容器，避免 Vue template ref 时序问题） */
+async function createEditor(jsonText: string): Promise<void> {
+  // NModal display-directive=if 下容器在动画后才可见
+  // 用 DOM 查询而非 template ref 确保拿到真实元素
+  let container: HTMLElement | null = null
+  let attempts = 0
+  while (!container && attempts < 20) {
+    container = document.querySelector('.json-viewer-body')
+    if (!container) await nextTick()
+    // 给 NModal 动画一点时间
+    if (!container) await new Promise((r) => setTimeout(r, 50))
+    attempts++
+  }
+  if (!container) return
+  destroyEditor()
+  editorView = new EditorView({
+    state: buildExtensions(jsonText),
+    parent: container,
+  })
+}
+
+function destroyEditor(): void {
+  if (editorView) {
+    editorView.destroy()
+    editorView = null
+  }
+}
+
+/** 弹窗打开时：序列化 JSON → 等待 DOM 更新 → 创建编辑器 */
+watch(
+  () => props.show,
+  async (open) => {
+    if (open) {
+      await nextTick()
+      let jsonText: string
+      try {
+        const data = store.buildTemplate()
+        jsonText = JSON.stringify(data, null, 2)
+      } catch (e) {
+        jsonText = `// 序列化失败：${e instanceof Error ? e.message : String(e)}`
+      }
+      await createEditor(jsonText)
+    } else {
+      destroyEditor()
+    }
+  },
+)
+
+function close(): void {
+  emit('update:show', false)
+}
+
+/** 复制 JSON 到剪贴板，提示成功并关闭面板 */
+async function copyJson(): Promise<void> {
+  if (!editorView) return
+  try {
+    const text = editorView.state.doc.toString()
+    await navigator.clipboard.writeText(text)
+    message.success('已复制到剪贴板')
+    close()
+  } catch {
+    message.error('复制失败，请手动选择文本复制')
+  }
+}
+</script>
+
+<template>
+  <NModal
+    :show="props.show"
+    preset="card"
+    title="画布 JSON 数据"
+    style="width: 760px; max-width: 94vw"
+    :mask-closable="true"
+    display-directive="if"
+    @update:show="emit('update:show', $event)"
+  >
+    <div ref="editorContainerRef" class="json-viewer-body" />
+    <template #footer>
+      <div class="flex justify-end gap-2">
+        <NButton size="small" @click="copyJson">
+          <template #icon>
+            <div class="i-carbon-copy text-14px" />
+          </template>
+          复制 JSON
+        </NButton>
+        <NButton size="small" @click="close">关闭</NButton>
+      </div>
+    </template>
+  </NModal>
+</template>
+
+<style scoped>
+.json-viewer-body {
+  height: 480px;
+  border: 1px solid var(--brand-border);
+  border-radius: 8px;
+  overflow: hidden;
+}
+.json-viewer-body :deep(.cm-editor) {
+  height: 100%;
+}
+.json-viewer-body :deep(.cm-scroller) {
+  overflow: auto;
+}
+.json-viewer-body :deep(.cm-editor.cm-focused) {
+  outline: none;
+}
+</style>
diff --git a/openprint/src/design/modals/PrintDialog.vue b/openprint/src/design/modals/PrintDialog.vue
new file mode 100644
index 0000000..34ddaa5
--- /dev/null
+++ b/openprint/src/design/modals/PrintDialog.vue
@@ -0,0 +1,635 @@
+<script setup lang="ts">
+/**
+ * PrintDialog —— 打印配置弹窗
+ *
+ * 本机客户端模式对接本地打印服务（默认 http://127.0.0.1:18888，地址可在设置里覆盖）：
+ *   GET  /health   判活 + 版本
+ *   GET  /printers 打印机列表（能力/状态/纸盒）
+ *   POST /print    推送任务
+ *
+ * 推送格式（2026-08-13 最终定案）：**统一推 PDF（base64）**。
+ * PDF 内部位图底图默认 PNG（无损·最高清），文字/线条边缘真正锐利，打印推荐。
+ * 本地客户端用 `QPrinter` 打印位图 PDF。
+ * 演进：SVG（Qt 不支持 foreignObject，废弃）→ 统一 PDF（最终）。
+ * 载荷由 `buildPrintPayload()` 统一构建，与预览/导出共用同一条 render 链路，保证三者一致。
+ *
+ * 主任铁律：无后端全链路可用 —— 客户端不可达时只是不能出纸，设计器功能不受影响。
+ */
+import { computed, ref, watch } from 'vue'
+import {
+  NButton,
+  NInputNumber,
+  NModal,
+  NRadioButton,
+  NRadioGroup,
+  NSelect,
+  NSpin,
+  NTag,
+  NText,
+  NTooltip,
+  useMessage,
+} from 'naive-ui'
+import { useDesignerStore } from '@/design/stores/designer'
+import { useDataSourceStore } from '@/design/stores/dataSource'
+import { buildPreviewData } from '@/design/preview/preview-data'
+import { usePrinterProbe } from '@/design/composables/usePrinterProbe'
+import {
+  buildPrintPayload,
+  describePrintError,
+  formatPayloadSize,
+  generateJobId,
+  submitPrintJob,
+  type PrinterInfo,
+} from '@/core/print-client'
+
+const props = defineProps<{ show: boolean }>()
+const emit = defineEmits<{ (e: 'update:show', v: boolean): void }>()
+
+const store = useDesignerStore()
+const dsStore = useDataSourceStore()
+const message = useMessage()
+
+/* ------------------------------ 打印模式 ------------------------------ */
+type PrintTarget = 'local' | 'cloud'
+const target = ref<PrintTarget>('local')
+
+/* ------------------------------ 本机客户端探测（共享单例） ------------------------------ */
+const {
+  state: probeState,
+  health: probeHealth,
+  printers: localPrinters,
+  defaultPrinter,
+  errorText: probeError,
+  baseUrl: printerBase,
+  probe: runProbe,
+} = usePrinterProbe()
+
+/* ------------------------------ 云打印探测 ------------------------------ */
+type PrinterStatus = 'checking' | 'connected' | 'disconnected'
+const cloudStatus = ref<PrinterStatus>('checking')
+const cloudPrinters = ref<Array<{ label: string; value: string }>>([])
+const cloudError = ref('')
+
+/* ------------------------------ 统一状态 ------------------------------ */
+const printerStatus = computed<PrinterStatus>(() => {
+  if (target.value === 'cloud') return cloudStatus.value
+  switch (probeState.value) {
+    case 'connected':
+      return localPrinters.value.length > 0 ? 'connected' : 'disconnected'
+    case 'disconnected':
+      return 'disconnected'
+    default:
+      return 'checking'
+  }
+})
+
+const isConnected = computed(() => printerStatus.value === 'connected')
+/** 未连接时禁用下方所有配置选项（参考可看但不可选） */
+const formDisabled = computed(() => !isConnected.value)
+
+const statusTagText = computed(() => {
+  switch (printerStatus.value) {
+    case 'checking':
+      return '检测中…'
+    case 'connected':
+      return target.value === 'local'
+        ? `已连接 · ${localPrinters.value.length} 台打印机`
+        : '已连接云打印服务'
+    case 'disconnected':
+      return target.value === 'local' ? '客户端不可达' : '无法连接云打印服务'
+  }
+})
+
+const statusTagType = computed(() => {
+  switch (printerStatus.value) {
+    case 'checking':
+      return 'warning' as const
+    case 'connected':
+      return 'success' as const
+    case 'disconnected':
+      return 'error' as const
+  }
+})
+
+/** 未连接时的详细原因 */
+const disconnectedTip = computed(() => {
+  if (target.value === 'cloud') {
+    return cloudError.value || '无法连接云打印服务。请检查服务地址和端口配置（设置 → 远程云打印）。'
+  }
+  if (probeState.value === 'connected' && localPrinters.value.length === 0) {
+    return `已连上客户端（${printerBase.value}），但未枚举到任何打印机，请检查系统打印机安装情况。`
+  }
+  return `${probeError.value || '无法连接本机打印客户端'}。当前地址 ${printerBase.value}，可在「设置 → 本地打印」修改 IP / 端口。`
+})
+
+/* ------------------------------ 打印机列表 ------------------------------ */
+const KIND_LABEL: Record<PrinterInfo['kind'], string> = {
+  virtual: '虚拟',
+  common: '普通',
+  ticket: '票据',
+}
+
+const selectedPrinter = ref<string>('')
+
+const printerOptions = computed(() => {
+  if (target.value === 'cloud') return cloudPrinters.value
+  return localPrinters.value.map((p) => ({
+    label: `${p.name}${p.isDefault ? ' · 默认' : ''}${p.isOnline ? '' : '（离线）'}`,
+    value: p.name,
+    disabled: !p.isOnline,
+  }))
+})
+
+/** 当前选中的本机打印机详情 */
+const currentPrinter = computed<PrinterInfo | null>(() => {
+  if (target.value !== 'local') return null
+  return localPrinters.value.find((p) => p.name === selectedPrinter.value) ?? null
+})
+
+/** 选中打印机后自动收敛不支持的能力（不支持双面 → 强制单面） */
+watch(currentPrinter, (p) => {
+  if (!p) return
+  if (!p.supportsDuplex) duplex.value = 'single'
+  if (!p.supportsColor) color.value = 'grayscale'
+})
+
+/* ------------------------------ 打印任务名 ------------------------------ */
+type NamingMode = 'filename' | 'random'
+const namingMode = ref<NamingMode>('filename')
+const randomSeed = ref(0)
+
+const taskName = computed(() => {
+  if (namingMode.value === 'filename') {
+    return store.templateName || '未命名模板'
+  }
+  void randomSeed.value // 依赖种子：每次打开弹窗换一个新随机名
+  const ts = Date.now().toString(36).slice(-6)
+  const rand = Math.random().toString(36).slice(2, 6)
+  return `Print-${ts}-${rand}`
+})
+
+/* ------------------------------ 打印参数 ------------------------------ */
+const copies = ref(1)
+type Orientation = 'portrait' | 'landscape'
+const orientation = ref<Orientation>('portrait')
+type Duplex = 'single' | 'double'
+const duplex = ref<Duplex>('single')
+type ColorMode = 'color' | 'grayscale'
+const color = ref<ColorMode>('grayscale')
+
+/* ------------------------------ 探测 ------------------------------ */
+
+/** 本机：走共享探测单例 */
+async function detectLocalPrinters(): Promise<void> {
+  await runProbe()
+  const def = defaultPrinter.value
+  if (def && !localPrinters.value.some((p) => p.name === selectedPrinter.value)) {
+    selectedPrinter.value = def.name
+  }
+}
+
+/** 云打印探测：从 print-settings 读配置，尝试连接远程打印服务获取打印机列表。 */
+async function detectCloudPrinters(): Promise<void> {
+  cloudStatus.value = 'checking'
+  cloudPrinters.value = []
+  cloudError.value = ''
+
+  const settings = readCloudSettings()
+  if (!settings.host) {
+    cloudStatus.value = 'disconnected'
+    return
+  }
+
+  const url = `${settings.host.replace(/\/+$/, '')}:${settings.port}/api/printers`
+  try {
+    const res = await fetch(url, { method: 'GET', signal: AbortSignal.timeout(5000) })
+    if (!res.ok) throw new Error(`HTTP ${res.status}`)
+    const data = (await res.json()) as Array<{ id: string; name: string }>
+    if (data && data.length > 0) {
+      cloudPrinters.value = data.map((p) => ({ label: p.name, value: p.id }))
+      selectedPrinter.value = cloudPrinters.value[0]?.value || ''
+      cloudStatus.value = 'connected'
+    } else {
+      cloudError.value = '云打印服务未返回任何打印机'
+      cloudStatus.value = 'disconnected'
+    }
+  } catch (e) {
+    cloudError.value = `无法连接 ${url}（${e instanceof Error ? e.message : String(e)}）`
+    cloudStatus.value = 'disconnected'
+  }
+}
+
+/** 从 localStorage 读云打印配置（复用 config/print-settings.ts 结构） */
+function readCloudSettings(): { host: string; port: number } {
+  try {
+    const raw = localStorage.getItem('openprint:print-settings')
+    if (raw) {
+      const parsed = JSON.parse(raw)
+      return {
+        host: parsed?.remote?.host || 'http://localhost',
+        port: parsed?.remote?.port || 9100,
+      }
+    }
+  } catch {
+    // ignore
+  }
+  return { host: 'http://localhost', port: 9100 }
+}
+
+/** 重置为默认值 */
+function resetDefaults(): void {
+  copies.value = 1
+  orientation.value = 'portrait'
+  duplex.value = 'single'
+  color.value = 'grayscale'
+  namingMode.value = 'filename'
+  randomSeed.value += 1
+}
+
+/* ------------------------------ 生命周期 ------------------------------ */
+
+watch(target, (val) => {
+  if (val === 'local') void detectLocalPrinters()
+  else void detectCloudPrinters()
+})
+
+watch(
+  () => props.show,
+  (open) => {
+    if (!open) return
+    resetDefaults()
+    if (target.value === 'local') void detectLocalPrinters()
+    else void detectCloudPrinters()
+  },
+)
+
+/** 刷新打印机列表 */
+function refreshPrinters(): void {
+  if (target.value === 'local') void detectLocalPrinters()
+  else void detectCloudPrinters()
+}
+
+/* ------------------------------ 推送打印 ------------------------------ */
+
+const printing = ref(false)
+const printingHint = ref('')
+
+async function doPrint(): Promise<void> {
+  if (!isConnected.value) {
+    message.warning('打印机未连接，无法打印')
+    return
+  }
+  if (target.value === 'cloud') {
+    message.info('云打印推送尚未接入，请切换到「本机客户端」')
+    return
+  }
+  if (printing.value) return
+
+  printing.value = true
+  try {
+    printingHint.value = '正在排版渲染…'
+    const template = store.buildTemplate()
+    const data = buildPreviewData(dsStore.activeFields)
+    const payload = await buildPrintPayload({
+      template,
+      data,
+      output: {
+        pageDecoration: {
+          backgroundColor: store.pageSetup.backgroundColor ?? '#ffffff',
+          watermark: store.pageSetup.watermark,
+        },
+      },
+    })
+
+    printingHint.value = `正在推送 ${payload.format.toUpperCase()}（${payload.pages} 页 · ${formatPayloadSize(payload.bytes)}）…`
+    const res = await submitPrintJob(
+      {
+        jobId: generateJobId(),
+        taskName: taskName.value,
+        printer: selectedPrinter.value,
+        format: payload.format,
+        encoding: payload.encoding,
+        content: payload.content,
+        pages: payload.pages,
+        copies: copies.value,
+        orientation: orientation.value,
+        duplex: duplex.value === 'double',
+        color: color.value === 'color',
+      },
+      printerBase.value,
+    )
+
+    const job = res.jobId ? ` · 任务号 ${res.jobId}` : ''
+    message.success(
+      `已推送到「${selectedPrinter.value}」：${payload.pages} 页 · ${payload.format.toUpperCase()} · ${formatPayloadSize(payload.bytes)} · ${copies.value} 份${job}`,
+    )
+    emit('update:show', false)
+  } catch (e) {
+    message.error(`推送失败：${describePrintError(e)}`)
+  } finally {
+    printing.value = false
+    printingHint.value = ''
+  }
+}
+
+function close(): void {
+  emit('update:show', false)
+}
+</script>
+
+<template>
+  <NModal
+    :show="props.show"
+    preset="card"
+    title="打印"
+    style="width: 560px; max-width: 94vw"
+    :mask-closable="false"
+    @update:show="emit('update:show', $event)"
+  >
+    <!-- 打印目标切换 -->
+    <div class="print-target-bar">
+      <NRadioGroup v-model:value="target" class="print-target-group">
+        <NRadioButton value="local">
+          <div class="i-carbon-printer mr-1 inline-block text-14px align-middle" />
+          本机客户端
+        </NRadioButton>
+        <NRadioButton value="cloud">
+          <div class="i-carbon-cloud mr-1 inline-block text-14px align-middle" />
+          云打印
+        </NRadioButton>
+      </NRadioGroup>
+
+      <!-- 连接状态 -->
+      <div class="flex items-center gap-2">
+        <NSpin v-if="printerStatus === 'checking'" :size="14" />
+        <NTag :type="statusTagType" size="small" round>{{ statusTagText }}</NTag>
+        <NTooltip>
+          <template #trigger>
+            <NButton quaternary size="tiny" @click="refreshPrinters">
+              <div class="i-carbon-renew text-14px" />
+            </NButton>
+          </template>
+          重新检测打印机
+        </NTooltip>
+      </div>
+    </div>
+
+    <!-- 服务地址（本机模式） -->
+    <div v-if="target === 'local'" class="print-base-line">
+      <div class="i-carbon-plug text-13px" />
+      <span>服务地址 {{ printerBase }}</span>
+      <span v-if="probeHealth" class="op-70">
+        · {{ probeHealth.app }} v{{ probeHealth.version }}
+      </span>
+    </div>
+
+    <!-- 未连接提示 -->
+    <div v-if="!isConnected && printerStatus !== 'checking'" class="print-disconnected-tip">
+      <div class="i-carbon-warning text-16px" style="color: var(--brand-danger, #ef4444)" />
+      <NText depth="3" class="text-12px">{{ disconnectedTip }}</NText>
+    </div>
+
+    <!-- 打印配置区域 -->
+    <div class="print-form" :class="{ 'is-disabled': formDisabled }">
+      <!-- 打印机选择 -->
+      <div class="print-field">
+        <div class="print-field-label">打印机</div>
+        <div class="flex-1">
+          <NSelect
+            v-model:value="selectedPrinter"
+            :options="printerOptions"
+            size="small"
+            :disabled="formDisabled"
+            :placeholder="isConnected ? '选择打印机' : '未连接'"
+            style="width: 100%"
+          />
+          <!-- 打印机能力详情 -->
+          <div v-if="currentPrinter" class="printer-meta">
+            <NTag size="tiny" round :type="currentPrinter.status === 'idle' ? 'success' : 'error'">
+              {{ currentPrinter.status === 'idle' ? '空闲' : '异常' }}
+            </NTag>
+            <NTag size="tiny" round>{{ KIND_LABEL[currentPrinter.kind] }}</NTag>
+            <NTag size="tiny" round>{{ currentPrinter.maxDpi }} DPI</NTag>
+            <NTag size="tiny" round :type="currentPrinter.supportsColor ? 'info' : 'default'">
+              {{ currentPrinter.supportsColor ? '支持彩色' : '仅黑白' }}
+            </NTag>
+            <NTag size="tiny" round :type="currentPrinter.supportsDuplex ? 'info' : 'default'">
+              {{ currentPrinter.supportsDuplex ? '支持双面' : '仅单面' }}
+            </NTag>
+            <NTag v-if="currentPrinter.trays.length" size="tiny" round>
+              纸盒：{{ currentPrinter.trays.join(' / ') }}
+            </NTag>
+          </div>
+          <div v-if="currentPrinter?.driver" class="printer-driver">
+            驱动：{{ currentPrinter.driver }}
+          </div>
+        </div>
+      </div>
+
+      <!-- 打印任务名 -->
+      <div class="print-field">
+        <div class="print-field-label">任务名称</div>
+        <div class="print-name-bar">
+          <NRadioGroup v-model:value="namingMode" size="small" :disabled="formDisabled">
+            <NRadioButton value="filename">文件名</NRadioButton>
+            <NRadioButton value="random">随机</NRadioButton>
+          </NRadioGroup>
+          <div class="print-name-preview">{{ taskName }}</div>
+        </div>
+      </div>
+
+      <!-- 打印份数 -->
+      <div class="print-field">
+        <div class="print-field-label">打印份数</div>
+        <NInputNumber
+          v-model:value="copies"
+          size="small"
+          :min="1"
+          :max="99"
+          button-placement="both"
+          :disabled="formDisabled"
+          style="width: 100px"
+        />
+      </div>
+
+      <!-- 方向 -->
+      <div class="print-field">
+        <div class="print-field-label">方向</div>
+        <NRadioGroup v-model:value="orientation" size="small" :disabled="formDisabled">
+          <NRadioButton value="portrait">
+            <div class="i-carbon-document-blank mr-1 inline-block text-14px align-middle" />
+            纵向
+          </NRadioButton>
+          <NRadioButton value="landscape">
+            <div class="i-carbon-document-horizontal mr-1 inline-block text-14px align-middle" />
+            横向
+          </NRadioButton>
+        </NRadioGroup>
+      </div>
+
+      <!-- 单面/双面 -->
+      <div class="print-field">
+        <div class="print-field-label">双面打印</div>
+        <NRadioGroup
+          v-model:value="duplex"
+          size="small"
+          :disabled="formDisabled || currentPrinter?.supportsDuplex === false"
+        >
+          <NRadioButton value="single">单面</NRadioButton>
+          <NRadioButton value="double">双面</NRadioButton>
+        </NRadioGroup>
+      </div>
+
+      <!-- 颜色 -->
+      <div class="print-field">
+        <div class="print-field-label">颜色</div>
+        <NRadioGroup
+          v-model:value="color"
+          size="small"
+          :disabled="formDisabled || currentPrinter?.supportsColor === false"
+        >
+          <NRadioButton value="grayscale">
+            <div class="i-carbon-contrast mr-1 inline-block text-14px align-middle" />
+            黑白
+          </NRadioButton>
+          <NRadioButton value="color">
+            <div class="i-carbon-color-palette mr-1 inline-block text-14px align-middle" />
+            彩色
+          </NRadioButton>
+        </NRadioGroup>
+      </div>
+    </div>
+
+    <!-- 推送格式说明 -->
+    <div class="print-format-note">
+      <div class="i-carbon-information text-13px" />
+      <span>推送规则：所有文档统一转 <b>PDF（base64）</b> 推送，本地客户端用 QPrinter 直接打印。</span>
+    </div>
+
+    <template #footer>
+      <div class="flex items-center justify-between">
+        <NText depth="3" class="text-12px">{{ printingHint }}</NText>
+        <div class="flex justify-end gap-2">
+          <NButton size="small" :disabled="printing" @click="close">取消</NButton>
+          <NButton
+            size="small"
+            type="primary"
+            :loading="printing"
+            :disabled="!isConnected || printing"
+            @click="doPrint"
+          >
+            <template #icon>
+              <div class="i-carbon-printer text-14px" />
+            </template>
+            打印
+          </NButton>
+        </div>
+      </div>
+    </template>
+  </NModal>
+</template>
+
+<style scoped>
+.print-target-bar {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  margin-bottom: 10px;
+}
+
+.print-target-group :deep(.n-radio-button) {
+  --n-button-color: var(--brand-surface);
+}
+
+.print-base-line {
+  display: flex;
+  align-items: center;
+  gap: 6px;
+  margin-bottom: 12px;
+  font-size: 12px;
+  color: var(--brand-text-3, var(--brand-text-2));
+  font-family: monospace;
+}
+
+.print-disconnected-tip {
+  display: flex;
+  align-items: flex-start;
+  gap: 8px;
+  padding: 8px 12px;
+  margin-bottom: 16px;
+  border-radius: 8px;
+  background: rgba(239, 68, 68, 0.08);
+  border: 1px solid rgba(239, 68, 68, 0.2);
+}
+
+.print-form {
+  display: flex;
+  flex-direction: column;
+  gap: 16px;
+}
+
+.print-form.is-disabled {
+  opacity: 0.5;
+  pointer-events: none;
+}
+
+.print-field {
+  display: flex;
+  align-items: flex-start;
+  gap: 16px;
+}
+
+.print-field-label {
+  width: 72px;
+  flex-shrink: 0;
+  font-size: 13px;
+  color: var(--brand-text-2);
+  line-height: 28px;
+}
+
+.printer-meta {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 4px;
+  margin-top: 6px;
+}
+
+.printer-driver {
+  margin-top: 4px;
+  font-size: 12px;
+  color: var(--brand-text-3, var(--brand-text-2));
+  opacity: 0.8;
+}
+
+.print-name-bar {
+  display: flex;
+  align-items: center;
+  gap: 12px;
+  flex: 1;
+}
+
+.print-name-preview {
+  font-size: 13px;
+  color: var(--brand-text-1);
+  font-family: monospace;
+  padding: 2px 8px;
+  border-radius: 4px;
+  background: var(--brand-surface);
+  white-space: nowrap;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  max-width: 240px;
+}
+
+.print-format-note {
+  display: flex;
+  align-items: center;
+  gap: 6px;
+  margin-top: 16px;
+  padding: 8px 12px;
+  border-radius: 8px;
+  background: var(--brand-surface);
+  font-size: 12px;
+  color: var(--brand-text-2);
+}
+</style>
diff --git a/openprint/src/design/modals/SettingsModal.vue b/openprint/src/design/modals/SettingsModal.vue
new file mode 100644
index 0000000..531b112
--- /dev/null
+++ b/openprint/src/design/modals/SettingsModal.vue
@@ -0,0 +1,534 @@
+<script setup lang="ts">
+/**
+ * SettingsModal —— 全局设置弹窗（naive-ui Modal + 左侧功能栏 + 右侧配置区）
+ * 目前两个配置页：本地打印 / 远程云打印（配置存 localStorage，见 config/print-settings.ts）。
+ */
+import { computed, ref, watch } from 'vue'
+import {
+  NButton,
+  NInput,
+  NInputNumber,
+  NModal,
+  NSelect,
+  NSwitch,
+  NTag,
+  NText,
+  useMessage,
+} from 'naive-ui'
+import {
+  DEFAULT_PRINT_SETTINGS,
+  readPrintSettings,
+  writePrintSettings,
+  type PrintSettings,
+} from '@/config/print-settings'
+import {
+  buildPrinterBase,
+  FACTORY_PRINTER_BASE_URL,
+} from '@/config/printer'
+import { checkHealth, listPrinters, describePrintError } from '@/core/print-client'
+import {
+  readAiSettings,
+  writeAiSettings,
+  AI_PROVIDER_PRESETS,
+  type AiSettings,
+} from '@/config/ai-settings'
+
+const props = defineProps<{ show: boolean }>()
+const emit = defineEmits<{ (e: 'update:show', v: boolean): void }>()
+
+const message = useMessage()
+
+/* ------------------------------ 功能栏 ------------------------------ */
+
+type NavKey = 'local' | 'remote' | 'ai' | 'feedback'
+const activeKey = ref<NavKey>('local')
+
+const NAV_ITEMS: Array<{ key: NavKey; label: string; icon: string; desc: string }> = [
+  { key: 'local', label: '本地打印', icon: 'i-carbon-printer', desc: '浏览器直接打印 / 静默后台打印' },
+  { key: 'remote', label: '远程云打印', icon: 'i-carbon-cloud-upload', desc: '通过远程打印服务出纸' },
+  { key: 'ai', label: 'AI 助手', icon: 'i-carbon-ai-status', desc: '用自然语言生成打印模板' },
+  { key: 'feedback', label: '功能反馈', icon: 'i-carbon-chat', desc: '改进建议 / 新功能需求' },
+]
+
+/* ------------------------------ 配置模型 ------------------------------ */
+
+const settings = ref<PrintSettings>(readPrintSettings())
+
+watch(
+  settings,
+  (v) => writePrintSettings(v),
+  { deep: true },
+)
+
+/* ------------------------------ AI 助手配置 ------------------------------ */
+
+const ai = ref<AiSettings>(readAiSettings())
+
+watch(
+  ai,
+  (v) => writeAiSettings(v),
+  { deep: true },
+)
+
+function applyPreset(p: { baseURL: string; model: string }): void {
+  ai.value.baseURL = p.baseURL
+  ai.value.model = p.model
+}
+
+function resetAll(): void {
+  settings.value = structuredClone(DEFAULT_PRINT_SETTINGS)
+  message.success('已恢复默认设置')
+}
+
+function close(): void {
+  emit('update:show', false)
+}
+
+/* --------------------------- 远程连接测试 --------------------------- */
+
+const testing = ref(false)
+async function testRemote(): Promise<void> {
+  const { host, port, enabled } = settings.value.remote
+  if (!enabled) {
+    message.warning('请先开启「启用远程云打印」')
+    return
+  }
+  const url = `${host.replace(/\/+$/, '')}:${port}/`
+  testing.value = true
+  try {
+    // 主动连接探测：用户手动触发，不受"零网络依赖"约束
+    const res = await fetch(url, { method: 'GET', signal: AbortSignal.timeout(5000) })
+    message.success(`服务可达（HTTP ${res.status}）`)
+  } catch (e) {
+    const reason = e instanceof Error && e.name === 'TimeoutError' ? '连接超时' : '无法连接'
+    message.warning(`${reason}：${url}（请确认服务已启动，或存在 CORS 限制）`)
+  } finally {
+    testing.value = false
+  }
+}
+
+/* --------------------------- 本地打印客户端连接测试 --------------------------- */
+
+/** 当前设置面板里填出来的基地址（实时预览，未保存也能看到） */
+const localBase = computed(() =>
+  buildPrinterBase(settings.value.local.silent.host, settings.value.local.silent.port),
+)
+
+const testingLocal = ref(false)
+type LocalTest = { ok: boolean; text: string }
+const localTestResult = ref<LocalTest | null>(null)
+
+/** 自测本地打印客户端：/health 拿版本 → /printers 拿数量 */
+async function testLocalClient(): Promise<void> {
+  const base = localBase.value || FACTORY_PRINTER_BASE_URL
+  testingLocal.value = true
+  localTestResult.value = null
+  try {
+    const health = await checkHealth(base)
+    let count = health.printers
+    try {
+      count = (await listPrinters(base)).length
+    } catch {
+      /* 打印机枚举失败不影响健康判定，沿用 health.printers */
+    }
+    localTestResult.value = {
+      ok: true,
+      text: `连接正常 · ${health.app} v${health.version} · ${count} 台打印机`,
+    }
+    message.success(`打印客户端已连接（${count} 台打印机）`)
+  } catch (e) {
+    const reason = describePrintError(e)
+    localTestResult.value = { ok: false, text: `${reason}（${base}）` }
+    message.warning(reason)
+  } finally {
+    testingLocal.value = false
+  }
+}
+
+/** 恢复出厂地址 127.0.0.1:18888 */
+function resetLocalEndpoint(): void {
+  settings.value.local.silent.host = '127.0.0.1'
+  settings.value.local.silent.port = 18888
+  localTestResult.value = null
+  message.success('已恢复出厂地址 127.0.0.1:18888')
+}
+
+/** 客户端下载占位：Windows 静默打印客户端发布后在此挂真实下载链接 */
+function onDownloadClient(): void {
+  message.info('Windows 静默打印客户端即将发布，敬请期待')
+}
+
+/* ------------------------------ 功能反馈 ------------------------------ */
+
+const FEEDBACK_EMAIL = 'haiming236@outlook.com'
+const FEEDBACK_WECHAT = 'wmcxsj'
+const feedbackText = ref('')
+const feedbackContact = ref('')
+
+/** 通过邮件提交反馈（纯前端 mailto，无需后端） */
+function sendFeedbackMail(): void {
+  const text = feedbackText.value.trim()
+  if (!text) {
+    message.warning('请先填写反馈内容')
+    return
+  }
+  const contact = feedbackContact.value.trim()
+  const body = `${text}${contact ? `\n\n—— 联系方式：${contact}` : ''}`
+  const subject = encodeURIComponent('OpenPrint 功能反馈')
+  window.location.href = `mailto:${FEEDBACK_EMAIL}?subject=${subject}&body=${encodeURIComponent(body)}`
+  feedbackText.value = ''
+  feedbackContact.value = ''
+  message.success('已打开邮件客户端，请发送反馈（收件人已预填）')
+}
+
+function copyToClipboard(value: string, label: string): void {
+  navigator.clipboard?.writeText(value).then(
+    () => message.success(`已复制${label}：${value}`),
+    () => message.error('复制失败，请手动复制'),
+  )
+}
+</script>
+
+<template>
+  <NModal
+    :show="props.show"
+    preset="card"
+    title="设置"
+    style="width: 640px; max-width: 94vw"
+    :mask-closable="false"
+    @update:show="emit('update:show', $event)"
+  >
+    <div class="flex h-400px gap-4">
+      <!-- 左侧功能栏 -->
+      <div class="w-150px flex-shrink-0 border-r border-brand-border pr-3">
+        <div
+          v-for="item in NAV_ITEMS"
+          :key="item.key"
+          class="settings-nav-item"
+          :class="{ 'is-active': activeKey === item.key }"
+          @click="activeKey = item.key"
+        >
+          <div :class="item.icon" class="text-16px" />
+          <span class="text-13px">{{ item.label }}</span>
+        </div>
+      </div>
+
+      <!-- 右侧配置区 -->
+      <div class="min-w-0 flex-1 overflow-y-auto">
+        <!-- 本地打印 -->
+        <div v-if="activeKey === 'local'" class="flex flex-col gap-4">
+          <div>
+            <div class="config-title">打印方式</div>
+            <NSelect
+              v-model:value="settings.local.method"
+              size="small"
+              :options="[
+                { label: '浏览器直接打印（弹出打印对话框）', value: 'browser' },
+                { label: '客户端打印（静默打印，自动出纸）', value: 'silent' },
+              ]"
+            />
+            <NText depth="3" class="block text-12px mt-1">
+              直接打印使用浏览器内置打印对话框；客户端打印自动出纸，无需手动确认。
+            </NText>
+          </div>
+
+          <!-- 打印客户端服务地址（/health · /printers · /print 共用） -->
+          <div class="rounded-8px border border-brand-border bg-brand-surface p-3">
+            <div class="mb-2 flex items-center justify-between">
+              <div class="config-title" style="margin-bottom: 0">打印客户端服务地址</div>
+              <NButton text size="tiny" @click="resetLocalEndpoint">恢复出厂 18888</NButton>
+            </div>
+            <div class="grid grid-cols-2 gap-3">
+              <div>
+                <div class="config-label">客户端 IP 地址</div>
+                <NInput
+                  v-model:value="settings.local.silent.host"
+                  size="small"
+                  placeholder="127.0.0.1"
+                />
+              </div>
+              <div>
+                <div class="config-label">端口</div>
+                <NInputNumber
+                  v-model:value="settings.local.silent.port"
+                  size="small"
+                  :min="1"
+                  :max="65535"
+                  placeholder="18888"
+                  style="width: 100%"
+                />
+              </div>
+            </div>
+
+            <div class="mt-2 flex items-center gap-2">
+              <NButton size="small" secondary :loading="testingLocal" @click="testLocalClient">
+                <template #icon>
+                  <div class="i-carbon-plug text-14px" />
+                </template>
+                测试连接
+              </NButton>
+              <NTag v-if="localTestResult" size="small" round :type="localTestResult.ok ? 'success' : 'error'">
+                {{ localTestResult.text }}
+              </NTag>
+            </div>
+
+            <NText depth="3" class="block text-12px mt-2">
+              当前生效：<b>{{ localBase || FACTORY_PRINTER_BASE_URL }}</b>
+              —— 打印机探测（/health、/printers）与任务推送（/print）都走这个地址。
+            </NText>
+            <NText depth="3" class="block text-12px mt-1">
+              出厂默认 {{ FACTORY_PRINTER_BASE_URL }}；可手动改为局域网地址（客户端已支持局域网打印），
+              手动填写的地址优先级最高。
+            </NText>
+          </div>
+
+          <!-- 客户端静默打印：安装包下载 -->
+          <div v-if="settings.local.method === 'silent'">
+            <NButton size="small" secondary @click="onDownloadClient">
+              <template #icon>
+                <div class="i-carbon-download text-14px" />
+              </template>
+              下载客户端
+            </NButton>
+            <NText depth="3" class="block text-12px mt-1">Windows 客户端安装包即将提供下载。</NText>
+          </div>
+
+          <div class="flex items-center justify-between">
+            <span class="config-label">副本数</span>
+            <NInputNumber
+              v-model:value="settings.local.copies"
+              size="small"
+               button-placement="both"
+              :min="1"
+              :max="99"
+              style="width: 120px"
+            />
+          </div>
+
+          <div class="flex items-center justify-between">
+            <div>
+              <div class="config-label">打印后关闭预览窗口</div>
+              <NText depth="3" class="text-12px">打印完成后自动关闭预览面板</NText>
+            </div>
+            <NSwitch v-model:value="settings.local.closeAfterPrint" />
+          </div>
+        </div>
+
+        <!-- 远程云打印 -->
+        <div v-else-if="activeKey === 'remote'" class="flex flex-col gap-4">
+          <div class="flex items-center justify-between">
+            <div>
+              <div class="config-label">启用远程云打印</div>
+              <NText depth="3" class="text-12px">通过远程打印服务把文档发送到指定打印机</NText>
+            </div>
+            <NSwitch v-model:value="settings.remote.enabled" />
+          </div>
+
+          <div class="grid grid-cols-1 gap-3">
+            <div>
+              <div class="config-label">服务地址</div>
+              <NInput
+                v-model:value="settings.remote.host"
+                size="small"
+                placeholder="http://127.0.0.1"
+                :disabled="!settings.remote.enabled"
+              />
+            </div>
+            <div class="flex gap-3">
+              <div class="w-130px">
+                <div class="config-label">端口</div>
+                <NInputNumber
+                  v-model:value="settings.remote.port"
+                  size="small"
+                   button-placement="both"
+                  :min="1"
+                  :max="65535"
+                  style="width: 100%"
+                  :disabled="!settings.remote.enabled"
+                />
+              </div>
+              <div class="flex-1">
+                <div class="config-label">打印机名（可选）</div>
+                <NInput
+                  v-model:value="settings.remote.printer"
+                  size="small"
+                  placeholder="留空使用服务默认打印机"
+                  :disabled="!settings.remote.enabled"
+                />
+              </div>
+            </div>
+          </div>
+
+          <div>
+            <NButton
+              size="small"
+              secondary
+              :loading="testing"
+              :disabled="!settings.remote.enabled"
+              @click="testRemote"
+            >
+              测试连接
+            </NButton>
+          </div>
+        </div>
+
+        <!-- AI 助手 -->
+        <div v-else-if="activeKey === 'ai'" class="flex flex-col gap-4">
+          <div class="rounded-8px border border-brand-border bg-brand-surface p-3">
+            <div class="config-title mb-1">AI 助手（纯前端直连，零后端）</div>
+            <NText depth="3" class="block text-12px">
+              配置你自己的大模型服务（OpenAI 兼容格式）。Key 仅保存在本机浏览器，不会上传服务器。
+            </NText>
+            <div class="ai-presets mt-2 flex flex-wrap gap-2">
+              <NButton
+                v-for="p in AI_PROVIDER_PRESETS"
+                :key="p.label"
+                size="tiny"
+                secondary
+                @click="applyPreset(p)"
+              >
+                {{ p.label }}
+              </NButton>
+            </div>
+          </div>
+
+          <div class="flex items-center justify-between">
+            <div>
+              <div class="config-label">启用 AI 助手</div>
+              <NText depth="3" class="text-12px">关闭后顶部 AI 入口与对话将不可用</NText>
+            </div>
+            <NSwitch v-model:value="ai.enabled" />
+          </div>
+
+          <div>
+            <div class="config-label">接口地址（baseURL）</div>
+            <NInput
+              v-model:value="ai.baseURL"
+              size="small"
+              placeholder="https://api.openai.com/v1"
+            />
+            <NText depth="3" class="block text-12px mt-1">
+              需含 /v1；若浏览器提示跨域(CORS)，请改为你自己的代理地址。
+            </NText>
+          </div>
+
+          <div>
+            <div class="config-label">API Key</div>
+            <NInput
+              v-model:value="ai.apiKey"
+              size="small"
+              type="password"
+              placeholder="sk-..."
+              show-password-on="click"
+            />
+          </div>
+
+          <div>
+            <div class="config-label">模型 ID</div>
+            <NInput v-model:value="ai.model" size="small" placeholder="gpt-4o-mini" />
+          </div>
+        </div>
+
+      <!-- 功能反馈 -->
+      <div v-else-if="activeKey === 'feedback'" class="flex flex-col gap-4">
+        <div class="rounded-8px border border-brand-border bg-brand-surface p-3">
+          <div class="config-title mb-1">功能反馈 / 需求建议</div>
+          <NText depth="3" class="block text-12px">
+            欢迎对本系统的设计或功能提出改进意见，或告诉我们你需要的全新功能。提交后会通过你的邮件客户端发送，
+            也可直接通过下方联系方式联系我。
+          </NText>
+        </div>
+
+        <div>
+          <div class="config-label">反馈内容 / 新功能需求</div>
+          <NInput
+            v-model:value="feedbackText"
+            type="textarea"
+            size="small"
+            :autosize="{ minRows: 5, maxRows: 12 }"
+            placeholder="例如：希望表格支持跨页重复标题、或增加某类单据模板……"
+          />
+        </div>
+
+        <div>
+          <div class="config-label">联系方式（可选，邮箱 / 微信皆可）</div>
+          <NInput
+            v-model:value="feedbackContact"
+            size="small"
+            placeholder="方便我们回复你，如微信 wmcxsj"
+          />
+        </div>
+
+        <div class="flex items-center gap-2">
+          <NButton size="small" type="primary" @click="sendFeedbackMail">
+            <template #icon>
+              <div class="i-carbon-email text-14px" />
+            </template>
+            发送邮件反馈
+          </NButton>
+          <NButton size="small" secondary @click="copyToClipboard(FEEDBACK_EMAIL, '邮箱')">
+            复制邮箱
+          </NButton>
+          <NButton size="small" secondary @click="copyToClipboard(FEEDBACK_WECHAT, '微信号')">
+            复制微信
+          </NButton>
+        </div>
+
+        <div class="rounded-8px border border-brand-border p-3">
+          <div class="config-label mb-1">直接联系</div>
+          <div class="text-13px leading-6">
+            邮箱：<b>{{ FEEDBACK_EMAIL }}</b>
+            <NButton text size="tiny" class="ml-1" @click="copyToClipboard(FEEDBACK_EMAIL, '邮箱')">复制</NButton>
+          </div>
+          <div class="text-13px leading-6">
+            微信：<b>{{ FEEDBACK_WECHAT }}</b>
+            <NButton text size="tiny" class="ml-1" @click="copyToClipboard(FEEDBACK_WECHAT, '微信号')">复制</NButton>
+          </div>
+        </div>
+      </div>
+      </div>
+    </div>
+
+    <template #footer>
+      <div class="flex items-center justify-between">
+        <NButton size="small" quaternary @click="resetAll">恢复默认</NButton>
+        <div class="flex gap-2">
+          <NButton size="small" @click="close">取消</NButton>
+          <NButton size="small" type="primary" @click="close">完成</NButton>
+        </div>
+      </div>
+    </template>
+  </NModal>
+</template>
+
+<style scoped>
+.config-title {
+  margin-bottom: 6px;
+  font-size: 13px;
+  color: var(--brand-text-1);
+}
+.config-label {
+  font-size: 13px;
+  color: var(--brand-text-2);
+}
+.settings-nav-item {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  padding: 9px 12px;
+  margin-bottom: 2px;
+  border-radius: 8px;
+  cursor: pointer;
+  color: var(--brand-text-2);
+  transition:
+    background 0.15s,
+    color 0.15s;
+}
+.settings-nav-item:hover {
+  background: var(--brand-surface-hover, rgba(128, 128, 128, 0.08));
+}
+.settings-nav-item.is-active {
+  background: rgba(22, 119, 255, 0.12);
+  color: var(--brand-primary);
+}
+</style>
diff --git a/openprint/src/design/modals/TableStylePickerModal.vue b/openprint/src/design/modals/TableStylePickerModal.vue
new file mode 100644
index 0000000..2358b20
--- /dev/null
+++ b/openprint/src/design/modals/TableStylePickerModal.vue
@@ -0,0 +1,185 @@
+<script setup lang="ts">
+/**
+ * TableStylePickerModal —— 表格「样式库」预览弹窗（Excel 式快速切换）。
+ *
+ * 不再是下拉框盲选：以网格卡片展示每种预设的**真实渲染效果**（与设计画布 / 预览 / PDF
+ * 同一份 `.op-table` CSS），点击卡片即应用并关闭。预设元信息来自 table-style-presets.ts。
+ */
+import { computed, onBeforeUnmount, onMounted } from 'vue'
+import { NButton, NModal, NText } from 'naive-ui'
+import type { TableStylePreset } from '@/types/control'
+import { tableCss } from '@/core/renderer-html/css-generator'
+import { TABLE_STYLE_PRESETS } from '@/design/canvas/table-style-presets'
+
+const props = defineProps<{
+  show: boolean
+  /** 当前已选预设（用于高亮） */
+  current?: TableStylePreset
+}>()
+
+const emit = defineEmits<{
+  (e: 'update:show', value: boolean): void
+  (e: 'select', key: TableStylePreset): void
+}>()
+
+/** 预览样例行（与渲染端同构：is-header / is-data / is-summary 类驱动预设视觉效果） */
+const SAMPLE_ROWS = `
+  <tr class="is-header"><td>产品</td><td>数量</td><td>金额</td></tr>
+  <tr class="is-data"><td>商品 A</td><td>12</td><td>240.00</td></tr>
+  <tr class="is-data"><td>商品 B</td><td>8</td><td>160.00</td></tr>
+  <tr class="is-data"><td>商品 C</td><td>5</td><td>90.00</td></tr>
+  <tr class="is-summary"><td>合计</td><td>25</td><td>490.00</td></tr>`
+
+/** 为某个预设生成一张可点击的预览表 HTML（无用户输入，v-html 安全） */
+function previewHtml(key: TableStylePreset): string {
+  const borders = TABLE_STYLE_PRESETS.find((p) => p.key === key)?.borders ?? 'all'
+  return (
+    `<table class="op-table b-${borders} va-middle ts-${key}">` +
+    `<colgroup><col style="width:42%"><col style="width:20%"><col style="width:38%"></colgroup>` +
+    `<tbody>${SAMPLE_ROWS}</tbody></table>`
+  )
+}
+
+/** 全局注入 .op-table 规则，使弹窗内的预览表（不在 .op-table-overlay 内）正确着色 */
+const STYLE_ID = 'op-style-gallery-css'
+function injectGlobalTableCss(): void {
+  if (document.getElementById(STYLE_ID)) return
+  const el = document.createElement('style')
+  el.id = STYLE_ID
+  el.textContent = tableCss()
+  document.head.appendChild(el)
+}
+function removeGlobalTableCss(): void {
+  document.getElementById(STYLE_ID)?.remove()
+}
+
+onMounted(injectGlobalTableCss)
+onBeforeUnmount(removeGlobalTableCss)
+
+const presets = computed(() => TABLE_STYLE_PRESETS)
+
+function pick(key: TableStylePreset): void {
+  emit('select', key)
+  emit('update:show', false)
+}
+function close(): void {
+  emit('update:show', false)
+}
+</script>
+
+<template>
+  <NModal
+    :show="props.show"
+    preset="card"
+    display-directive="if"
+    title="表格样式库"
+    :mask-closable="false"
+    style="width: 720px; max-width: 94vw"
+    @update:show="emit('update:show', $event)"
+  >
+    <NText depth="3" class="text-12px">
+      点击任意样式即可套用，画布 / 预览 / 导出效果与此预览完全一致（类似 Excel 表格样式快速切换）。
+    </NText>
+
+    <div class="ts-gallery">
+      <button
+        v-for="p in presets"
+        :key="p.key"
+        type="button"
+        class="style-card"
+        :class="{ 'is-selected': p.key === props.current }"
+        @click="pick(p.key)"
+      >
+        <div class="style-preview" v-html="previewHtml(p.key)" />
+        <div class="style-meta">
+          <span class="style-label">{{ p.label }}</span>
+          <span class="i-carbon-checkmark-outline style-check" />
+        </div>
+        <div class="style-desc">{{ p.desc }}</div>
+      </button>
+    </div>
+
+    <template #footer>
+      <div class="flex justify-end">
+        <NButton size="small" @click="close">取消</NButton>
+      </div>
+    </template>
+  </NModal>
+</template>
+
+<style scoped>
+.ts-gallery {
+  margin-top: 12px;
+  display: grid;
+  grid-template-columns: repeat(auto-fill, minmax(150px, 1fr));
+  gap: 12px;
+  max-height: 62vh;
+  overflow: auto;
+  padding: 2px;
+}
+
+.style-card {
+  display: flex;
+  flex-direction: column;
+  gap: 6px;
+  padding: 8px;
+  border: 1px solid #e5e6eb;
+  border-radius: 8px;
+  background: #fff;
+  cursor: pointer;
+  text-align: left;
+  font: inherit;
+  color: inherit;
+  transition: border-color 0.15s, box-shadow 0.15s, transform 0.05s;
+}
+.style-card:hover {
+  border-color: #2f54eb;
+  box-shadow: 0 2px 10px rgba(47, 84, 235, 0.12);
+}
+.style-card:active {
+  transform: translateY(1px);
+}
+.style-card.is-selected {
+  border: 2px solid #2f54eb;
+  background: #f5f8ff;
+  padding: 7px;
+}
+
+.style-preview {
+  border: 1px solid #eee;
+  border-radius: 4px;
+  overflow: hidden;
+  background: #fff;
+}
+/* 预览表压缩内边距 / 字号，使缩略图紧凑且不溢出卡片 */
+.style-preview :deep(.op-table) {
+  width: 100%;
+  font-size: 9px;
+}
+.style-preview :deep(.op-table td) {
+  padding: 2px 4px;
+}
+
+.style-meta {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+}
+.style-label {
+  font-size: 13px;
+  font-weight: 600;
+}
+.style-check {
+  font-size: 15px;
+  color: #2f54eb;
+  opacity: 0;
+}
+.style-card.is-selected .style-check {
+  opacity: 1;
+}
+.style-desc {
+  font-size: 11px;
+  color: #8a8f99;
+  line-height: 1.3;
+}
+</style>
diff --git a/openprint/src/design/modals/TemplateMarket.vue b/openprint/src/design/modals/TemplateMarket.vue
new file mode 100644
index 0000000..8abdd6e
--- /dev/null
+++ b/openprint/src/design/modals/TemplateMarket.vue
@@ -0,0 +1,212 @@
+<script setup lang="ts">
+/**
+ * TemplateMarket —— 模板市场弹窗（TopToolbar「模板市场」入口）
+ * 左侧分类 + 右侧模板卡片网格；点击「使用」直接加载到画布（dirty 时确认）。
+ */
+import { computed, ref } from 'vue'
+import { NButton, NEmpty, NInput, NModal, NText, useMessage } from 'naive-ui'
+import { useDesignerStore } from '@/design/stores/designer'
+import { useConfirm } from '@/design/composables/useConfirm'
+import {
+  MARKET_CATEGORY_LABEL,
+  MARKET_TEMPLATES,
+  type MarketCategory,
+  type MarketTemplate,
+} from '@/repository/mock/data/market-templates'
+
+const props = defineProps<{ show: boolean }>()
+const emit = defineEmits<{ (e: 'update:show', v: boolean): void }>()
+
+const store = useDesignerStore()
+const message = useMessage()
+const { confirm } = useConfirm()
+
+type Filter = 'all' | MarketCategory
+const activeFilter = ref<Filter>('all')
+const keyword = ref('')
+
+const CATEGORY_ICON: Record<MarketCategory, string> = {
+  invoice: 'i-carbon-document',
+  report: 'i-carbon-analytics',
+  receipt: 'i-carbon-receipt',
+  thermal: 'i-carbon-document-horizontal',
+  label: 'i-carbon-tag',
+}
+
+const filtered = computed(() => {
+  const kw = keyword.value.trim()
+  return MARKET_TEMPLATES.filter((t) => {
+    if (activeFilter.value !== 'all' && t.category !== activeFilter.value) return false
+    if (kw && !`${t.name}${t.desc}`.toLowerCase().includes(kw.toLowerCase())) return false
+    return true
+  })
+})
+
+async function useTemplate(tpl: MarketTemplate): Promise<void> {
+  if (store.dirty && !(await confirm(`使用「${tpl.name}」将覆盖当前未保存的改动。确定继续？`))) return
+  store.loadTemplate({ id: tpl.id, name: tpl.name, data: tpl.build() })
+  emit('update:show', false)
+  message.success(`已载入模板：${tpl.name}`)
+}
+
+function close(): void {
+  emit('update:show', false)
+}
+</script>
+
+<template>
+  <NModal
+    :show="props.show"
+    preset="card"
+    title="模板市场"
+    style="width: 780px; max-width: 94vw"
+    @update:show="emit('update:show', $event)"
+  >
+    <div class="flex h-480px gap-4">
+      <!-- 左侧分类 -->
+      <div class="w-130px flex-shrink-0 border-r border-brand-border pr-3">
+        <div
+          class="market-cat-item"
+          :class="{ 'is-active': activeFilter === 'all' }"
+          @click="activeFilter = 'all'"
+        >
+          <div class="i-carbon-template text-16px" />
+          <span class="text-13px">全部</span>
+          <span class="market-count">{{ MARKET_TEMPLATES.length }}</span>
+        </div>
+        <div
+          v-for="(label, key) in MARKET_CATEGORY_LABEL"
+          :key="key"
+          class="market-cat-item"
+          :class="{ 'is-active': activeFilter === key }"
+          @click="activeFilter = key"
+        >
+          <div :class="CATEGORY_ICON[key]" class="text-16px" />
+          <span class="text-13px">{{ label }}</span>
+          <span class="market-count">{{ MARKET_TEMPLATES.filter((t) => t.category === key).length }}</span>
+        </div>
+      </div>
+
+      <!-- 右侧模板卡片 -->
+      <div class="flex min-w-0 flex-1 flex-col">
+        <div class="mb-2">
+          <NInput v-model:value="keyword" size="small" placeholder="搜索模板名称 / 描述" clearable />
+        </div>
+        <div class="min-h-0 flex-1 overflow-y-auto">
+          <NEmpty v-if="filtered.length === 0" description="没有匹配的模板" class="mt-16" />
+          <div v-else class="grid grid-cols-2 gap-3 pr-1">
+            <div v-for="tpl in filtered" :key="tpl.id" class="market-card">
+              <!-- 迷你纸张缩略示意 -->
+              <div class="flex items-center gap-3">
+                <div class="mini-paper flex-shrink-0" :style="miniBox(tpl)">
+                  <div class="mini-line" style="width: 70%" />
+                  <div class="mini-line" style="width: 55%" />
+                  <div class="mini-line" style="width: 80%" />
+                </div>
+                <div class="min-w-0 flex-1">
+                  <div class="flex items-center gap-1.5">
+                    <div :class="CATEGORY_ICON[tpl.category]" class="text-13px text-brand-text-3" />
+                    <span class="truncate text-13px font-medium">{{ tpl.name }}</span>
+                  </div>
+                  <NText depth="3" class="block text-11px mt-0.5">{{ tpl.sizeLabel }}</NText>
+                </div>
+              </div>
+              <NText depth="3" class="block text-12px leading-4 mt-2 market-desc">{{ tpl.desc }}</NText>
+              <div class="mt-2">
+                <NButton size="tiny" type="primary" secondary @click="useTemplate(tpl)">使用</NButton>
+              </div>
+            </div>
+          </div>
+        </div>
+      </div>
+    </div>
+
+    <template #footer>
+      <div class="flex items-center justify-between">
+        <NText depth="3" class="text-12px">共 {{ MARKET_TEMPLATES.length }} 个预设模板，点击「使用」直接载入画布</NText>
+        <NButton size="small" @click="close">关闭</NButton>
+      </div>
+    </template>
+  </NModal>
+</template>
+
+<script lang="ts">
+import type { CSSProperties } from 'vue'
+
+/** 按纸张宽高比生成迷你缩略矩形（fit 52×64 盒） */
+function aspect(wMm: number, hMm: number, maxW = 52, maxH = 64): { w: number; h: number } {
+  const scale = Math.min(maxW / wMm, maxH / hMm)
+  return { w: Math.max(24, Math.round(wMm * scale)), h: Math.max(16, Math.round(hMm * scale)) }
+}
+
+/** 计算迷你纸张尺寸（直接用条目上的纸张宽高，避免渲染时重建模板） */
+function miniBox(tpl: MarketTemplate): CSSProperties {
+  const size = aspect(tpl.pageW, tpl.pageH)
+  return { width: `${size.w}px`, height: `${size.h}px` }
+}
+</script>
+
+<style scoped>
+.market-cat-item {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  padding: 9px 10px;
+  margin-bottom: 2px;
+  border-radius: 8px;
+  cursor: pointer;
+  color: var(--brand-text-2);
+  transition:
+    background 0.15s,
+    color 0.15s;
+}
+.market-cat-item:hover {
+  background: var(--brand-surface-hover, rgba(128, 128, 128, 0.08));
+}
+.market-cat-item.is-active {
+  background: rgba(22, 119, 255, 0.12);
+  color: var(--brand-primary);
+}
+.market-count {
+  margin-left: auto;
+  font-size: 11px;
+  color: var(--brand-text-3);
+}
+.market-card {
+  display: flex;
+  flex-direction: column;
+  padding: 12px;
+  border: 1px solid var(--brand-border);
+  border-radius: 10px;
+  background: var(--brand-surface);
+  transition:
+    border-color 0.15s,
+    box-shadow 0.15s;
+}
+.market-card:hover {
+  border-color: var(--brand-primary);
+  box-shadow: 0 2px 8px rgba(22, 119, 255, 0.12);
+}
+.market-desc {
+  display: -webkit-box;
+  -webkit-line-clamp: 2;
+  -webkit-box-orient: vertical;
+  overflow: hidden;
+}
+/* 迷你纸张：淡蓝描边 + 三条示意线 */
+.mini-paper {
+  border: 1px solid #b9d2ff;
+  border-radius: 2px;
+  background: #f6f9ff;
+  padding: 3px;
+  display: flex;
+  flex-direction: column;
+  justify-content: center;
+  gap: 3px;
+}
+.mini-line {
+  height: 2px;
+  border-radius: 1px;
+  background: #c3d6ff;
+}
+</style>
diff --git a/openprint/src/design/modals/TemplateModal.vue b/openprint/src/design/modals/TemplateModal.vue
new file mode 100644
index 0000000..7253ee8
--- /dev/null
+++ b/openprint/src/design/modals/TemplateModal.vue
@@ -0,0 +1,210 @@
+<script setup lang="ts">
+/**
+ * TemplateModal —— 模板管理器（Phase 6）
+ *
+ * 列表 / 打开 / 复制 / 删除 / 新建。直接走 designer store 的 repository（本地或云端同接口）。
+ * 权限（editable/deletable）由 repository 决定：本地恒 true，云端来自后端 permissions。
+ */
+import { computed, ref, watch } from 'vue'
+import {
+  NButton,
+  NEmpty,
+  NModal,
+  NPopconfirm,
+  NScrollbar,
+  NSpin,
+  NTag,
+  NText,
+  useMessage,
+} from 'naive-ui'
+import { useDesignerStore } from '@/design/stores/designer'
+import type { TemplateSummary } from '@/repository/types'
+import { useConfirm } from '@/design/composables/useConfirm'
+
+const props = defineProps<{ show: boolean }>()
+const emit = defineEmits<{ 'update:show': [value: boolean] }>()
+
+const store = useDesignerStore()
+const message = useMessage()
+const { confirm } = useConfirm()
+
+const items = ref<TemplateSummary[]>([])
+const loading = ref(false)
+const error = ref<string | null>(null)
+const busyId = ref<string | null>(null)
+
+async function refresh(): Promise<void> {
+  loading.value = true
+  error.value = null
+  try {
+    items.value = await store.repository.list()
+  } catch (e) {
+    error.value = e instanceof Error ? e.message : String(e)
+    items.value = []
+  } finally {
+    loading.value = false
+  }
+}
+
+watch(
+  () => props.show,
+  (v) => {
+    if (v) void refresh()
+  },
+)
+
+const sortedItems = computed(() =>
+  [...items.value].sort((a, b) => (b.updatedAt ?? '').localeCompare(a.updatedAt ?? '')),
+)
+
+function close(): void {
+  emit('update:show', false)
+}
+
+async function openTemplate(rec: TemplateSummary): Promise<void> {
+  busyId.value = rec.id
+  try {
+    const full = await store.repository.get(rec.id)
+    if (!full) {
+      message.error('模板不存在或已删除')
+      void refresh()
+      return
+    }
+    store.loadTemplate(full)
+    message.success(`已打开：${full.name}`)
+    close()
+  } catch (e) {
+    message.error(`打开失败：${e instanceof Error ? e.message : String(e)}`)
+  } finally {
+    busyId.value = null
+  }
+}
+
+async function copyTemplate(rec: TemplateSummary): Promise<void> {
+  busyId.value = rec.id
+  try {
+    const full = await store.repository.get(rec.id)
+    if (!full) {
+      message.error('模板不存在或已删除')
+      void refresh()
+      return
+    }
+    // 加载为当前画布，再另存为（清空 id → create 新记录）
+    store.loadTemplate(full)
+    await store.saveTemplateAs(`${full.name} 副本`)
+    message.success(`已复制为：${full.name} 副本`)
+    void refresh()
+  } catch (e) {
+    message.error(`复制失败：${e instanceof Error ? e.message : String(e)}`)
+  } finally {
+    busyId.value = null
+  }
+}
+
+async function deleteTemplate(rec: TemplateSummary): Promise<void> {
+  busyId.value = rec.id
+  try {
+    await store.repository.remove(rec.id)
+    if (store.currentTemplateId === rec.id) store.newBlankTemplate()
+    message.success(`已删除：${rec.name}`)
+    void refresh()
+  } catch (e) {
+    message.error(`删除失败：${e instanceof Error ? e.message : String(e)}`)
+  } finally {
+    busyId.value = null
+  }
+}
+
+async function createNew(): Promise<void> {
+  if (store.dirty && !(await confirm('当前模板有未保存改动，新建将清空画布。确定继续？'))) return
+  store.newBlankTemplate()
+  message.success('已新建空白模板')
+  close()
+}
+</script>
+
+<template>
+  <NModal
+    :show="show"
+    preset="card"
+    title="模板管理"
+    style="width: 640px; max-width: 92vw"
+    @update:show="(v: boolean) => emit('update:show', v)"
+  >
+    <template #header-extra>
+      <NButton size="small" type="primary" @click="createNew">
+        <div class="i-carbon-add mr-1" />
+        新建空白模板
+      </NButton>
+    </template>
+
+    <NSpin :show="loading">
+      <div v-if="error" class="mb-3 rounded bg-red-50 px-3 py-2 text-13px text-red-500">
+        加载失败：{{ error }}
+      </div>
+
+      <NEmpty v-if="!loading && sortedItems.length === 0" description="暂无模板" class="py-8">
+        <template #extra>
+          <NButton size="small" @click="createNew">新建空白模板</NButton>
+        </template>
+      </NEmpty>
+
+      <NScrollbar v-else style="max-height: 56vh">
+        <div class="flex flex-col gap-2">
+          <div
+            v-for="rec in sortedItems"
+            :key="rec.id"
+            class="flex items-center justify-between rounded-lg border border-brand-border px-3 py-2.5 transition-colors hover:border-brand-primary"
+          >
+            <div class="min-w-0 flex-1">
+              <div class="flex items-center gap-2">
+                <span class="truncate text-14px font-medium">{{ rec.name }}</span>
+                <NTag v-if="!rec.editable" size="tiny" type="warning" :bordered="false">只读</NTag>
+              </div>
+              <NText depth="3" class="text-11px">
+                {{ rec.id }}
+                <span v-if="rec.updatedAt" class="ml-2">更新于 {{ rec.updatedAt }}</span>
+              </NText>
+            </div>
+
+            <div class="flex items-center gap-1">
+              <NButton
+                size="small"
+                :disabled="busyId !== null"
+                @click="openTemplate(rec)"
+              >
+                <div class="i-carbon-launch mr-1" />
+                打开
+              </NButton>
+              <NButton
+                size="small"
+                :disabled="busyId !== null || !rec.editable"
+                @click="copyTemplate(rec)"
+              >
+                <div class="i-carbon-copy-file mr-1" />
+                复制
+              </NButton>
+              <NPopconfirm
+                :disabled="!rec.deletable"
+                @positive-click="deleteTemplate(rec)"
+              >
+                <template #trigger>
+                  <NButton
+                    size="small"
+                    type="error"
+                    ghost
+                    :disabled="busyId !== null || !rec.deletable"
+                  >
+                    <div class="i-carbon-trash-can mr-1" />
+                    删除
+                  </NButton>
+                </template>
+                确定删除「{{ rec.name }}」？此操作不可恢复。
+              </NPopconfirm>
+            </div>
+          </div>
+        </div>
+      </NScrollbar>
+    </NSpin>
+  </NModal>
+</template>
diff --git a/openprint/src/design/panels/ControlLibrary.vue b/openprint/src/design/panels/ControlLibrary.vue
new file mode 100644
index 0000000..6471287
--- /dev/null
+++ b/openprint/src/design/panels/ControlLibrary.vue
@@ -0,0 +1,191 @@
+<script setup lang="ts">
+/**
+ * ControlLibrary —— 可拖拽控件源（控件库面板）
+ * 卡片可拖拽入画布；页眉/页脚为点击插入（单例）；未开放的类型置灰。
+ */
+import { computed, ref } from 'vue'
+import { NInput } from 'naive-ui'
+import type { AnyControl, ControlType } from '@/types/control'
+import { startControlDrag } from '@/design/hooks/useDragAdd'
+import { useDesignerStore } from '@/design/stores/designer'
+
+interface ControlItem {
+  type:
+    | ControlType
+    | 'zone-header'
+    | 'zone-footer'
+    | 'pageno'
+    | 'pagebreak'
+    | 'condblock'
+    | 'datablock'
+    | 'circle'
+  label: string
+  icon: string
+  disabled?: boolean
+  /** 拖入/插入时的初始属性补丁（如圆形 shape） */
+  init?: Partial<AnyControl>
+}
+
+interface Category {
+  name: string
+  items: ControlItem[]
+}
+
+const store = useDesignerStore()
+const keyword = ref('')
+
+const categories: Category[] = [
+  {
+    name: '常用组件',
+    items: [
+      { type: 'text', label: '文本', icon: 'i-carbon-letter-tt' },
+      { type: 'image', label: '图片', icon: 'i-carbon-image' },
+      { type: 'barcode', label: '条码', icon: 'i-carbon-barcode' },
+      { type: 'qrcode', label: '二维码', icon: 'i-carbon-qr-code' },
+      { type: 'rect', label: '矩形', icon: 'i-carbon-square-outline' },
+      { type: 'circle', label: '圆形', icon: 'i-carbon-circle-dash', init: { shape: 'circle' } },
+      { type: 'line', label: '线条', icon: 'i-carbon-subtract' },
+      { type: 'table', label: '表格', icon: 'i-carbon-grid' },
+    ],
+  },
+  {
+    name: '布局组件',
+    items: [
+      { type: 'zone-header', label: '页眉', icon: 'i-carbon-row' },
+      { type: 'zone-footer', label: '页脚', icon: 'i-carbon-row' },
+      { type: 'pageno', label: '页码', icon: 'i-carbon-page-number' },
+    ],
+  },
+  {
+    name: '高级组件',
+    items: [
+      { type: 'richtext', label: '富文本', icon: 'i-carbon-text-annotation-toggle' },
+    ],
+  },
+  {
+    name: '图表组件',
+    items: [
+      { type: 'chart', label: '条形图', icon: 'i-carbon-chart-bar', init: { kind: 'bar' as const } },
+      { type: 'chart', label: '折线图', icon: 'i-carbon-chart-line', init: { kind: 'line' as const } },
+      { type: 'chart', label: '饼图', icon: 'i-carbon-chart-pie', init: { kind: 'pie' as const } },
+    ],
+  },
+  {
+    name: '业务组件',
+    items: [
+      { type: 'pagebreak', label: '分页符', icon: 'i-carbon-document-horizontal', disabled: true },
+      { type: 'condblock', label: '条件块', icon: 'i-carbon-branch', disabled: true },
+      { type: 'datablock', label: '数据块', icon: 'i-carbon-cube', disabled: true },
+    ],
+  },
+]
+
+const filtered = computed(() => {
+  const kw = keyword.value.trim()
+  if (!kw) return categories
+  return categories
+    .map((c) => ({ ...c, items: c.items.filter((i) => i.label.includes(kw)) }))
+    .filter((c) => c.items.length > 0)
+})
+
+function onDragStart(e: DragEvent, item: ControlItem): void {
+  if (item.disabled) return
+  // 圆形/页码复用已有类型：圆形=rect+shape 补丁；页码=text+{{page}} 内容
+  let dragType: ControlType
+  if (item.type === 'zone-header' || item.type === 'zone-footer') {
+    dragType = 'zone'
+  } else if (item.type === 'circle') {
+    dragType = 'rect'
+  } else if (item.type === 'pageno') {
+    dragType = 'text'
+  } else {
+    dragType = item.type as ControlType
+  }
+  const init: Partial<AnyControl> | undefined =
+    item.type === 'pageno' ? { value: '{{page}}', name: '页码' } : item.type === 'zone-header'
+      ? { zone: 'header' as const }
+      : item.type === 'zone-footer'
+        ? { zone: 'footer' as const }
+        : item.init
+  startControlDrag(e, dragType, init)
+}
+
+function onClick(item: ControlItem): void {
+  if (item.disabled) return
+  if (item.type === 'zone-header') store.addZone('header')
+  else if (item.type === 'zone-footer') store.addZone('footer')
+  else if (item.type === 'circle') {
+    // 圆形点击插入到内容区默认位置（复用 rect 类型 + shape 补丁）
+    store.addControlOfType('rect', { leftMm: 60, topMm: 60 }, { shape: 'circle' })
+  } else if (item.type === 'pageno') {
+    // 页码 = 文本控件 + {{page}} 页码变量（分页引擎每页注入）
+    store.addControlOfType('text', { leftMm: 60, topMm: 60 }, { value: '{{page}}', name: '页码' })
+  } else if (item.type === 'richtext') {
+    store.addControlOfType('richtext', { leftMm: 60, topMm: 60 })
+  } else if (item.type === 'chart') {
+    // 图表：点击插入到内容区默认位置（条形/折线/饼图由 init.kind 决定）
+    store.addControlOfType('chart', { leftMm: 60, topMm: 60 }, item.init)
+  }
+}
+</script>
+
+<template>
+  <div class="flex h-full flex-col">
+    <div class="p-2">
+      <NInput v-model:value="keyword" size="small" placeholder="搜索组件" clearable />
+    </div>
+    <div class="flex-1 overflow-y-auto px-2 pb-2">
+      <div v-for="cat in filtered" :key="cat.name" class="mb-3">
+        <div class="mb-1.5 text-12px text-brand-text-3">{{ cat.name }}</div>
+        <div class="grid grid-cols-3 gap-1.5">
+          <div
+            v-for="item in cat.items"
+            :key="item.type"
+            class="control-card"
+            :class="{ 'is-disabled': item.disabled }"
+            :draggable="!item.disabled"
+            @dragstart="onDragStart($event, item)"
+            @click="onClick(item)"
+          >
+            <div :class="item.icon" class="text-18px" />
+            <div class="mt-1 text-12px">{{ item.label }}</div>
+          </div>
+        </div>
+      </div>
+    </div>
+  </div>
+</template>
+
+<style scoped>
+.control-card {
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  justify-content: center;
+  padding: 10px 4px;
+  border: 1px solid var(--brand-border);
+  border-radius: 8px;
+  background: var(--brand-surface);
+  cursor: grab;
+  color: var(--brand-text-2);
+  transition:
+    border-color 0.15s,
+    color 0.15s,
+    box-shadow 0.15s;
+  user-select: none;
+}
+.control-card:hover {
+  border-color: var(--brand-primary);
+  color: var(--brand-primary);
+  box-shadow: 0 1px 4px rgba(22, 119, 255, 0.15);
+}
+.control-card.is-disabled {
+  opacity: 0.4;
+  cursor: not-allowed;
+}
+.control-card.is-disabled:hover {
+  border-color: var(--brand-border);
+  color: var(--brand-text-2);
+  box-shadow: none;
+}
+</style>
diff --git a/openprint/src/design/panels/DataSourceTree.vue b/openprint/src/design/panels/DataSourceTree.vue
new file mode 100644
index 0000000..a463813
--- /dev/null
+++ b/openprint/src/design/panels/DataSourceTree.vue
@@ -0,0 +1,139 @@
+<script setup lang="ts">
+/**
+ * DataSourceTree —— 数据源字段树（《设计方案》§19.4.3a 第五节）
+ *
+ * 金蝶式树形：数据源 → 子表 → 分组/字段。
+ * 字段可拖绑（占位），支持搜索过滤、手动刷新。
+ */
+import { computed, onMounted, ref } from 'vue'
+import { NButton, NInput, NSelect, NSpace, NTooltip, NSpin } from 'naive-ui'
+import { useDataSourceStore } from '@/design/stores/dataSource'
+
+const store = useDataSourceStore()
+const keyword = ref('')
+
+const sourceOptions = computed(() =>
+  store.sources.map((s) => ({ label: s.name, value: s.id })),
+)
+
+const filteredGroups = computed(() => {
+  const kw = keyword.value.trim().toLowerCase()
+  if (!kw) return store.fieldTree
+  return store.fieldTree
+    .map((t) => ({
+      table: t.table,
+      fields: t.fields.filter(
+        (f) => f.label.toLowerCase().includes(kw) || f.path.toLowerCase().includes(kw),
+      ),
+    }))
+    .filter((t) => t.fields.length > 0)
+})
+
+onMounted(() => {
+  void store.init()
+})
+
+const typeColor = (type: string): string => {
+  switch (type) {
+    case 'number':
+      return 'text-blue-500'
+    case 'date':
+      return 'text-green-500'
+    case 'image':
+      return 'text-purple-500'
+    default:
+      return 'text-brand-text-3'
+  }
+}
+
+const typeLabel = (type: string): string => {
+  switch (type) {
+    case 'number':
+      return 'N'
+    case 'date':
+      return 'D'
+    case 'boolean':
+      return 'B'
+    case 'image':
+      return 'I'
+    default:
+      return 'S'
+  }
+}
+</script>
+
+<template>
+  <div class="flex h-full flex-col">
+    <div class="border-b border-brand-border px-3 py-2">
+      <div class="text-12px text-brand-text-3">数据源</div>
+      <NSelect
+        size="small"
+        :value="store.activeSourceId"
+        :options="sourceOptions"
+        @update:value="store.selectSource($event)"
+      />
+    </div>
+
+    <div class="flex items-center gap-1 p-2">
+      <NInput v-model:value="keyword" size="small" placeholder="搜索字段" clearable />
+      <NTooltip>
+        <template #trigger>
+          <NButton size="small" quaternary @click="store.refreshFields()">
+            <div class="i-carbon-renew text-14px" />
+          </NButton>
+        </template>
+        刷新字段
+      </NTooltip>
+    </div>
+
+    <NSpin :show="store.loading" class="flex-1">
+      <div class="overflow-y-auto p-2 pt-0">
+        <div v-for="group in filteredGroups" :key="group.table.id" class="mb-3">
+          <div class="mb-1 flex items-center gap-1 text-11px font-medium text-brand-text-3">
+            <div class="i-carbon-data-table text-12px" />
+            {{ group.table.name }}
+            <span v-if="group.table.isArray" class="text-brand-primary">[]</span>
+          </div>
+          <div
+            v-for="field in group.fields"
+            :key="field.path"
+            class="field-item group"
+            draggable="true"
+            @dragstart="(e: DragEvent) => {
+              e.dataTransfer?.setData('application/x-openprint-binding', field.path)
+            }"
+          >
+            <span class="flex-1 truncate text-12px">
+              {{ field.label }}
+              <span v-if="field.custom" class="ml-1 inline-block rounded bg-blue-50 px-1 text-9px text-blue-500">
+                自定义
+              </span>
+            </span>
+            <span class="text-9px" :class="typeColor(field.type)">
+              {{ typeLabel(field.type) }}
+            </span>
+            <span class="ml-1 truncate text-9px text-brand-text-3">{{ field.path }}</span>
+          </div>
+        </div>
+        <div v-if="filteredGroups.length === 0" class="py-4 text-center text-12px text-brand-text-3">
+          暂无字段
+        </div>
+      </div>
+    </NSpin>
+  </div>
+</template>
+
+<style scoped>
+.field-item {
+  display: flex;
+  align-items: center;
+  gap: 4px;
+  padding: 3px 8px;
+  border-radius: 6px;
+  cursor: grab;
+  transition: background 0.15s;
+}
+.field-item:hover {
+  background: color-mix(in srgb, var(--brand-primary) 6%, transparent);
+}
+</style>
diff --git a/openprint/src/design/panels/LayerPanel.vue b/openprint/src/design/panels/LayerPanel.vue
new file mode 100644
index 0000000..b269854
--- /dev/null
+++ b/openprint/src/design/panels/LayerPanel.vue
@@ -0,0 +1,92 @@
+<script setup lang="ts">
+/**
+ * LayerPanel —— 图层面板：展示画布控件列表（z-order，可选中/删除）
+ */
+import { computed } from 'vue'
+import { NButton, NScrollbar } from 'naive-ui'
+import { useDesignerStore } from '@/design/stores/designer'
+import { CONTROL_TYPE_LABEL } from '@/design/canvas/controls'
+
+const store = useDesignerStore()
+
+/** 按画布 z-order 排列（body + zones + zone children） */
+const layers = computed(() => {
+  // 从 designer 对象获取实际顺序（Fabric objects 有固有 z-index）
+  const objs = store.designer?.getPrintObjects() ?? []
+  const ids = objs.map((o) => o.controlId)
+  const all: Array<{ id: string; type: string; name: string }> = []
+  const seen = new Set<string>()
+  for (const id of ids) {
+    if (seen.has(id)) continue
+    seen.add(id)
+    const c = store.controls.find((x) => x.id === id) ??
+      store.zones.find((x) => x.id === id || x.children.some((ch) => ch.id === id))
+    let entry: { id: string; type: string; name: string } | undefined
+    if (store.zones.find((x) => x.id === id)) {
+      const z = store.zones.find((x) => x.id === id)!
+      entry = { id: z.id, type: 'zone', name: z.zone === 'header' ? '页眉区域' : '页脚区域' }
+    } else if (store.controls.find((x) => x.id === id)) {
+      const c = store.controls.find((x) => x.id === id)!
+      entry = { id: c.id, type: c.type, name: c.name ?? CONTROL_TYPE_LABEL[c.type] ?? c.type }
+    } else {
+      // zone child
+      for (const z of store.zones) {
+        const child = z.children.find((ch) => ch.id === id)
+        if (child) {
+          entry = { id: child.id, type: child.type, name: child.name ?? (CONTROL_TYPE_LABEL[child.type] ?? child.type) }
+          break
+        }
+      }
+    }
+    if (entry) all.push(entry)
+  }
+  return all
+})
+</script>
+
+<template>
+  <div class="flex h-full flex-col">
+    <div class="border-b border-brand-border px-3 py-2 text-12px text-brand-text-3">
+      图层（{{ layers.length }} 项）
+    </div>
+    <NScrollbar class="flex-1">
+      <div class="p-1">
+        <div
+          v-for="layer in layers"
+          :key="layer.id"
+          class="layer-item group"
+          :class="{ selected: store.selectedIds.includes(layer.id) }"
+          @click="store.selectControl(layer.id)"
+        >
+          <span class="truncate text-12px">{{ layer.name }}</span>
+          <NButton
+            text
+            size="tiny"
+            class="opacity-0 group-hover:opacity-100"
+            @click.stop="store.removeControl(layer.id)"
+          >
+            <div class="i-carbon-close text-12px text-brand-text-3" />
+          </NButton>
+        </div>
+      </div>
+    </NScrollbar>
+  </div>
+</template>
+
+<style scoped>
+.layer-item {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  padding: 4px 8px;
+  border-radius: 6px;
+  cursor: pointer;
+  color: var(--brand-text-2);
+  transition: background 0.15s;
+}
+.layer-item:hover,
+.layer-item.selected {
+  background: color-mix(in srgb, var(--brand-primary) 8%, transparent);
+  color: var(--brand-primary);
+}
+</style>
diff --git a/openprint/src/design/panels/LeftPanel.vue b/openprint/src/design/panels/LeftPanel.vue
new file mode 100644
index 0000000..654f473
--- /dev/null
+++ b/openprint/src/design/panels/LeftPanel.vue
@@ -0,0 +1,28 @@
+<script setup lang="ts">
+/**
+ * LeftPanel —— 左栏容器：组件库 / 数据源树 / 批量数据 / 图层
+ */
+import { NTabs, NTabPane } from 'naive-ui'
+import ControlLibrary from './ControlLibrary.vue'
+import DataSourceTree from './DataSourceTree.vue'
+import LayerPanel from './LayerPanel.vue'
+import { useUiStore } from '@/design/stores/ui'
+
+const ui = useUiStore()
+</script>
+
+<template>
+  <div class="flex h-full flex-col bg-brand-surface">
+    <NTabs v-model:value="ui.leftTab" type="segment" size="small" class="flex-1 px-2" animated>
+      <NTabPane name="components" tab="组件">
+        <ControlLibrary />
+      </NTabPane>
+      <NTabPane name="datasource" tab="数据源">
+        <DataSourceTree />
+      </NTabPane>
+      <NTabPane name="layers" tab="图层">
+        <LayerPanel />
+      </NTabPane>
+    </NTabs>
+  </div>
+</template>
diff --git a/openprint/src/design/panels/RightPanel.vue b/openprint/src/design/panels/RightPanel.vue
new file mode 100644
index 0000000..1cfc68e
--- /dev/null
+++ b/openprint/src/design/panels/RightPanel.vue
@@ -0,0 +1,365 @@
+<script setup lang="ts">
+/**
+ * RightPanel —— 右栏属性面板
+ * 选中控件 → 通用属性 + 类型属性；无选中 → 页面设置（纸张预设 / 方向 / 边距）。
+ * 样式与事件本就分散在各控件 Props 与协议层，故不再设独立 tab。
+ */
+import { computed, ref, type Component } from 'vue'
+import {
+  NSelect,
+  NInputNumber,
+  NEmpty,
+  NText,
+  NColorPicker,
+  NSwitch,
+  NInput,
+  NButton,
+} from 'naive-ui'
+import { useDesignerStore, DEFAULT_WATERMARK } from '@/design/stores/designer'
+import type { WatermarkConfig } from '@/types/template'
+import CommonProps from '@/design/panels/props/CommonProps.vue'
+import TextProps from '@/design/panels/props/TextProps.vue'
+import TableProps from '@/design/panels/props/TableProps.vue'
+import ImageProps from '@/design/panels/props/ImageProps.vue'
+import ZoneProps from '@/design/panels/props/ZoneProps.vue'
+import CodeProps from '@/design/panels/props/CodeProps.vue'
+import ShapeProps from '@/design/panels/props/ShapeProps.vue'
+import RichTextProps from '@/design/panels/props/RichTextProps.vue'
+import ChartProps from '@/design/panels/props/ChartProps.vue'
+
+const store = useDesignerStore()
+const control = computed(() => store.selectedControl)
+
+const propsComponent = computed<Component | null>(() => {
+  switch (control.value?.type) {
+    case 'text':
+      return TextProps
+    case 'table':
+      return TableProps
+    case 'image':
+      return ImageProps
+    case 'zone':
+      return ZoneProps
+    case 'barcode':
+    case 'qrcode':
+      return CodeProps
+    case 'rect':
+    case 'line':
+      return ShapeProps
+    case 'richtext':
+      return RichTextProps
+    case 'chart':
+      return ChartProps
+    default:
+      return null
+  }
+})
+
+/** 当前选中预设（自定义时回退到 custom） */
+const selectedPreset = ref<string>('a4')
+
+const PAPER_PRESETS = [
+  { label: 'A4（210 × 297 mm）', value: 'a4', width: 210, height: 297 },
+  { label: 'A5（148 × 210 mm）', value: 'a5', width: 148, height: 210 },
+  { label: 'A6（105 × 148 mm）', value: 'a6', width: 105, height: 148 },
+  { label: '热敏 58mm（58 × 297 mm）', value: 'thermal58', width: 58, height: 297 },
+  { label: '热敏 80mm（80 × 297 mm）', value: 'thermal80', width: 80, height: 297 },
+  { label: '小票（80 × 150 mm）', value: 'receipt', width: 80, height: 150 },
+  { label: '自定义', value: 'custom', width: 210, height: 297 },
+]
+
+function setPaper(preset: string): void {
+  selectedPreset.value = preset
+  if (preset === 'custom') return
+  const p = PAPER_PRESETS.find((x) => x.value === preset)
+  if (!p) return
+  store.pageSetup.width = p.width
+  store.pageSetup.height = p.height
+  store.pageSetup.orientation = p.width <= p.height ? 'portrait' : 'landscape'
+  store.designer?.setPage(store.pageSetup)
+}
+
+function setMargin(side: 'top' | 'bottom' | 'left' | 'right', v: number | null): void {
+  store.pageSetup.margin[side] = v ?? 0
+  store.designer?.setPage(store.pageSetup)
+}
+
+function setOrientation(v: 'portrait' | 'landscape'): void {
+  const { width, height } = store.pageSetup
+  // 方向切换时交换宽高，保证语义一致
+  if ((v === 'landscape') !== width > height) {
+    store.pageSetup.width = height
+    store.pageSetup.height = width
+  }
+  store.pageSetup.orientation = v
+  store.designer?.setPage(store.pageSetup)
+}
+
+function setCustomSize(side: 'width' | 'height', v: number | null): void {
+  store.pageSetup[side] = v ?? 0
+  store.pageSetup.orientation = (store.pageSetup.width ?? 0) <= (store.pageSetup.height ?? 0) ? 'portrait' : 'landscape'
+  store.designer?.setPage(store.pageSetup)
+}
+
+/* ------------------------------ 页面外观 ------------------------------ */
+
+function setBackground(c: string): void {
+  store.pageSetup.backgroundColor = c
+  store.applyPageDecoration()
+}
+
+function setWatermark(patch: Partial<WatermarkConfig>): void {
+  const base = store.pageSetup.watermark ?? { ...DEFAULT_WATERMARK }
+  store.pageSetup.watermark = { ...base, ...patch }
+  store.applyPageDecoration()
+}
+
+const watermark = computed<WatermarkConfig>(() => store.pageSetup.watermark ?? { ...DEFAULT_WATERMARK })
+</script>
+
+<template>
+  <div class="flex h-full flex-col bg-brand-surface">
+    <div class="flex items-center justify-between border-b border-brand-border px-3 py-2">
+      <span class="text-13px font-medium">属性</span>
+    </div>
+
+    <div class="flex-1 overflow-y-auto">
+      <!-- 画布网格设置（运行时视图状态，辅助设计，不持久化；常驻顶部，始终可见） -->
+      <div class="props-section">
+        <div class="props-title">画布网格</div>
+        <div class="props-row">
+          <span class="props-label">显示网格</span>
+          <NSwitch
+            size="small"
+            :value="store.gridConfig.visible"
+            @update:value="store.setGrid({ visible: $event })"
+          />
+        </div>
+        <div class="props-row">
+          <span class="props-label" style="min-width: 56px">间距(mm)</span>
+          <NInputNumber
+            size="small"
+            button-placement="both"
+            :value="store.gridConfig.sizeMm"
+            :min="1"
+            :step="1"
+            style="width: 100px"
+            @update:value="store.setGrid({ sizeMm: $event ?? 5 })"
+          />
+        </div>
+        <div class="props-row">
+          <span class="props-label" style="min-width: 56px">颜色</span>
+          <div style="width: 100px">
+            <NColorPicker
+              size="small"
+              :modes="['hex']"
+              :show-alpha="true"
+              :value="store.gridConfig.color"
+              :disabled="!store.gridConfig.visible"
+              @update:value="store.setGrid({ color: $event })"
+            />
+          </div>
+        </div>
+      </div>
+
+      <!-- 页面外观（背景色 + 水印；随模板持久化；常驻顶部，始终可见） -->
+      <div class="props-section">
+        <div class="props-title">页面外观</div>
+        <div class="props-row">
+          <span class="props-label">页面背景</span>
+          <div style="width: 100px">
+            <NColorPicker
+              size="small"
+              :modes="['hex']"
+              :show-alpha="true"
+              :value="store.pageSetup.backgroundColor ?? '#ffffff'"
+              @update:value="setBackground($event)"
+            />
+          </div>
+        </div>
+
+        <div class="props-row" style="margin-top: 4px">
+          <span class="props-label">水印</span>
+          <NSwitch
+            size="small"
+            :value="watermark.enabled"
+            @update:value="setWatermark({ enabled: $event })"
+          />
+        </div>
+
+        <template v-if="watermark.enabled">
+          <div class="props-row" style="margin-top: 4px">
+            <span class="props-label" style="min-width: 56px">文本</span>
+            <NInput
+              size="small"
+              :value="watermark.text"
+              style="width: 160px"
+              @update:value="setWatermark({ text: $event })"
+            />
+          </div>
+          <div class="props-row">
+            <span class="props-label" style="min-width: 56px">颜色</span>
+            <div style="width: 100px">
+              <NColorPicker
+                size="small"
+                :modes="['hex']"
+                :show-alpha="true"
+                :value="watermark.color"
+                @update:value="setWatermark({ color: $event })"
+              />
+            </div>
+          </div>
+          <div class="props-row">
+            <span class="props-label" style="min-width: 56px">字号(mm)</span>
+            <NInputNumber
+              size="small"
+              button-placement="both"
+              :value="watermark.fontSize"
+              :min="1"
+              :step="1"
+              style="width: 100px"
+              @update:value="setWatermark({ fontSize: $event ?? 16 })"
+            />
+          </div>
+          <div class="props-row">
+            <span class="props-label" style="min-width: 56px">角度(°)</span>
+            <NInputNumber
+              size="small"
+              button-placement="both"
+              :value="watermark.rotation"
+              :step="1"
+              style="width: 100px"
+              @update:value="setWatermark({ rotation: $event ?? 45 })"
+            />
+          </div>
+          <div class="props-row">
+            <span class="props-label">全页平铺</span>
+            <NSwitch
+              size="small"
+              :value="watermark.tile"
+              @update:value="setWatermark({ tile: $event })"
+            />
+          </div>
+        </template>
+      </div>
+
+      <!-- 选中控件：通用 + 类型属性 -->
+      <template v-if="control">
+        <component :is="propsComponent" v-if="propsComponent" />
+        <CommonProps />
+      </template>
+
+      <!-- 无选中：页面设置 -->
+      <div v-else class="props-section">
+        <div class="props-title">页面设置</div>
+
+        <!-- 手动分页：加页 / 减页 + 物理页数 -->
+        <div class="props-row">
+          <span class="props-label" style="min-width: 56px">分页</span>
+          <div class="flex items-center gap-2">
+            <NButton size="tiny" quaternary circle :disabled="store.pageCount <= 1" @click="store.removePage()">
+              −
+            </NButton>
+            <span class="text-12px">共 {{ store.pageCount }} 页</span>
+            <NButton size="tiny" quaternary circle @click="store.addPage()">＋</NButton>
+          </div>
+        </div>
+
+        <!-- 页码导航：点击跳转到对应页（属性面板调整的是该页参数，全局共享纸张设置） -->
+        <div class="flex flex-wrap gap-1 pt-1 pb-2">
+          <button
+            v-for="i in store.pageCount"
+            :key="i"
+            type="button"
+            class="page-chip"
+            :class="{ 'page-chip-active': store.activePage === i - 1 }"
+            @click="store.goToPage(i - 1)"
+          >
+            第 {{ i }} 页
+          </button>
+        </div>
+
+        <div class="props-row">
+          <span class="props-label" style="min-width: 56px">纸张</span>
+          <NSelect size="small" :options="PAPER_PRESETS" :value="selectedPreset" @update:value="setPaper" />
+        </div>
+
+        <!-- 自定义：显示可编辑宽高 -->
+        <div v-if="selectedPreset === 'custom'" class="grid grid-cols-2 gap-2">
+          <div class="props-row">
+            <span class="props-label">宽</span>
+            <NInputNumber size="small" button-placement="both" :value="store.pageSetup.width" :min="1" @update:value="setCustomSize('width', $event)" />
+          </div>
+          <div class="props-row">
+            <span class="props-label">高</span>
+            <NInputNumber size="small" button-placement="both" :value="store.pageSetup.height" :min="1" @update:value="setCustomSize('height', $event)" />
+          </div>
+        </div>
+
+        <div class="props-row">
+          <span class="props-label" style="min-width: 56px">方向</span>
+          <NSelect
+            size="small"
+            :value="store.pageSetup.orientation"
+            :options="[
+              { label: '纵向', value: 'portrait' },
+              { label: '横向', value: 'landscape' },
+            ]"
+            @update:value="setOrientation"
+          />
+        </div>
+
+        <!-- 边距调整：实时反映到画布参考线（画布上的蓝色虚线即内容区） -->
+        <div class="props-row" style="margin-top: 4px">
+          <span class="props-label" style="min-width: 56px">页边距</span>
+        </div>
+        <div class="grid grid-cols-2 gap-2">
+          <div class="props-row">
+            <span class="props-label">上</span>
+            <NInputNumber size="small" button-placement="both" :value="store.pageSetup.margin.top" :min="0" @update:value="setMargin('top', $event)" />
+          </div>
+          <div class="props-row">
+            <span class="props-label">下</span>
+            <NInputNumber size="small" button-placement="both" :value="store.pageSetup.margin.bottom" :min="0" @update:value="setMargin('bottom', $event)" />
+          </div>
+          <div class="props-row">
+            <span class="props-label">左</span>
+            <NInputNumber size="small" button-placement="both" :value="store.pageSetup.margin.left" :min="0" @update:value="setMargin('left', $event)" />
+          </div>
+          <div class="props-row">
+            <span class="props-label">右</span>
+            <NInputNumber size="small" button-placement="both" :value="store.pageSetup.margin.right" :min="0" @update:value="setMargin('right', $event)" />
+          </div>
+        </div>
+
+        <NEmpty description="在画布上选中控件以编辑属性" class="mt-8" size="small" />
+      </div>
+    </div>
+  </div>
+</template>
+
+<style scoped>
+.page-chip {
+  padding: 1px 8px;
+  font-size: 12px;
+  line-height: 20px;
+  color: var(--brand-text-secondary);
+  background: transparent;
+  border: 1px solid var(--brand-border);
+  border-radius: 10px;
+  cursor: pointer;
+  transition:
+    color 0.15s,
+    border-color 0.15s,
+    background-color 0.15s;
+}
+.page-chip:hover {
+  color: var(--brand-primary);
+  border-color: var(--brand-primary);
+}
+.page-chip-active {
+  color: #fff;
+  background: var(--brand-primary);
+  border-color: var(--brand-primary);
+}
+</style>
diff --git a/openprint/src/design/panels/props/BindingEditor.vue b/openprint/src/design/panels/props/BindingEditor.vue
new file mode 100644
index 0000000..95cb898
--- /dev/null
+++ b/openprint/src/design/panels/props/BindingEditor.vue
@@ -0,0 +1,45 @@
+<script setup lang="ts">
+/**
+ * BindingEditor —— 字段绑定编辑器（点选 path，非手敲）
+ * Phase 5：接 dataSource store 的扁平字段列表，替换 Phase 3 的硬编码 MOCK_FIELDS。
+ */
+import { computed } from 'vue'
+import { NSelect } from 'naive-ui'
+import { useDataSourceStore } from '@/design/stores/dataSource'
+
+const props = defineProps<{
+  value?: string
+  placeholder?: string
+}>()
+
+const emit = defineEmits<{
+  'update:value': [value: string | undefined]
+}>()
+
+const dsStore = useDataSourceStore()
+
+const options = computed(() => {
+  return dsStore.flatFields.map((f) => ({
+    label: `${f.label}（${f.path}）`,
+    value: f.path,
+  }))
+})
+
+const innerValue = computed({
+  get: () => props.value ?? null,
+  set: (v: string | null) => emit('update:value', v ?? undefined),
+})
+</script>
+
+<template>
+  <NSelect
+    v-model:value="innerValue"
+    :options="options"
+    size="small"
+    filterable
+    tag
+    clearable
+    :placeholder="placeholder ?? '选择或输入绑定字段'"
+    :loading="dsStore.loading"
+  />
+</template>
diff --git a/openprint/src/design/panels/props/ChartProps.vue b/openprint/src/design/panels/props/ChartProps.vue
new file mode 100644
index 0000000..0cc062c
--- /dev/null
+++ b/openprint/src/design/panels/props/ChartProps.vue
@@ -0,0 +1,261 @@
+<script setup lang="ts">
+/**
+ * ChartProps —— 图表控件属性面板
+ *
+ * 编辑：图表类型（条形/折线/饼图）、标题、类目、序列（名称/颜色/数值）、外观选项。
+ * 数据为纯前端手工录入（与表格的「数据源绑定」解耦，v1 先不做绑定）。
+ * 所有改动经 store.updateControl 写入，触发 store.canvasTick → ChartViewLayer 实时重绘。
+ */
+import { computed } from 'vue'
+import { NInput, NInputNumber, NColorPicker, NSwitch, NSelect, NButton } from 'naive-ui'
+import type { ChartControl } from '@/types/control'
+import { useDesignerStore } from '@/design/stores/designer'
+import { DEFAULT_PALETTE } from '@/core/chartkit'
+
+const store = useDesignerStore()
+const control = computed(() => store.selectedControl as ChartControl | null)
+
+function patch(p: Record<string, unknown>): void {
+  if (control.value) store.updateControl(control.value.id, p)
+}
+
+function patchOption(key: string, value: unknown): void {
+  if (!control.value) return
+  patch({ options: { ...control.value.options, [key]: value } })
+}
+
+const kind = computed({
+  get: () => control.value?.kind ?? 'bar',
+  set: (v: 'bar' | 'line' | 'pie') => patch({ kind: v }),
+})
+
+const title = computed({
+  get: () => control.value?.options?.title ?? '',
+  set: (v: string) => patchOption('title', v || undefined),
+})
+
+const isLine = computed(() => kind.value === 'line')
+const isPie = computed(() => kind.value === 'pie')
+
+/* ------------------------------- 类目编辑 ------------------------------- */
+const categoriesText = computed({
+  get: () => (control.value?.categories ?? []).join('\n'),
+  set: (v: string) => {
+    const cats = v.split('\n').map((s) => s.trim())
+    // 同步把各序列数据长度对齐到新类目数，避免错位
+    const series = (control.value?.series ?? []).map((s) => ({
+      ...s,
+      data: cats.map((_, i) => s.data[i] ?? 0),
+    }))
+    patch({ categories: cats, series })
+  },
+})
+
+/* ------------------------------- 序列编辑 ------------------------------- */
+const series = computed(() => control.value?.series ?? [])
+
+function seriesName(i: number): string {
+  return series.value[i]?.name ?? ''
+}
+function setSeriesName(i: number, v: string): void {
+  const next = series.value.map((s, idx) => (idx === i ? { ...s, name: v } : s))
+  patch({ series: next })
+}
+function seriesColor(i: number): string {
+  return series.value[i]?.color ?? DEFAULT_PALETTE[i % DEFAULT_PALETTE.length]!
+}
+function setSeriesColor(i: number, v: string): void {
+  const next = series.value.map((s, idx) => (idx === i ? { ...s, color: v } : s))
+  patch({ series: next })
+}
+function seriesDataText(i: number): string {
+  return (series.value[i]?.data ?? []).join('\n')
+}
+function setSeriesData(i: number, raw: string): void {
+  const cats = control.value?.categories ?? []
+  const nums = raw
+    .split('\n')
+    .map((s) => s.trim())
+    .filter((s) => s !== '')
+    .map(Number)
+  const aligned = cats.map((_, idx) => (Number.isFinite(nums[idx]) ? nums[idx]! : 0))
+  const next = series.value.map((s, idx) => (idx === i ? { ...s, data: aligned } : s))
+  patch({ series: next })
+}
+function addSeries(): void {
+  const cats = control.value?.categories ?? []
+  const next = [
+    ...series.value,
+    { name: `系列${series.value.length + 1}`, data: cats.map(() => 0), color: DEFAULT_PALETTE[series.value.length % DEFAULT_PALETTE.length] },
+  ]
+  patch({ series: next })
+}
+function removeSeries(i: number): void {
+  if (series.value.length <= 1) return
+  patch({ series: series.value.filter((_, idx) => idx !== i) })
+}
+
+/* ------------------------------- 外观开关 ------------------------------- */
+const showLegend = computed({
+  get: () => control.value?.options?.showLegend ?? series.value.length > 1,
+  set: (v: boolean) => patchOption('showLegend', v),
+})
+const showAxis = computed({
+  get: () => control.value?.options?.showAxis ?? true,
+  set: (v: boolean) => patchOption('showAxis', v),
+})
+const showGrid = computed({
+  get: () => control.value?.options?.showGrid ?? true,
+  set: (v: boolean) => patchOption('showGrid', v),
+})
+const valueLabel = computed({
+  get: () => control.value?.options?.valueLabel ?? false,
+  set: (v: boolean) => patchOption('valueLabel', v),
+})
+const labelAlign = computed({
+  get: () => control.value?.options?.labelAlign ?? 'center',
+  set: (v: 'left' | 'center' | 'right') => patchOption('labelAlign', v),
+})
+const smooth = computed({
+  get: () => control.value?.options?.smooth ?? false,
+  set: (v: boolean) => patchOption('smooth', v),
+})
+const area = computed({
+  get: () => control.value?.options?.area ?? false,
+  set: (v: boolean) => patchOption('area', v),
+})
+const donut = computed({
+  get: () => control.value?.options?.donut ?? false,
+  set: (v: boolean) => patchOption('donut', v),
+})
+</script>
+
+<template>
+  <div v-if="control" class="props-section">
+    <div class="props-title">图表类型</div>
+    <div class="props-row">
+      <span class="props-label">类型</span>
+      <NSelect
+        size="small"
+        :value="kind"
+        :options="[
+          { label: '条形图', value: 'bar' },
+          { label: '折线图', value: 'line' },
+          { label: '饼图', value: 'pie' },
+        ]"
+        @update:value="kind = $event"
+      />
+    </div>
+
+    <div class="props-row">
+      <span class="props-label">标题</span>
+      <NInput size="small" :value="title" placeholder="图表标题" @update:value="title = $event" />
+    </div>
+
+    <div class="props-title">类目</div>
+    <div class="props-row">
+      <span class="props-label">类目</span>
+      <NInput
+        size="small"
+        type="textarea"
+        :autosize="{ minRows: 2, maxRows: 6 }"
+        :value="categoriesText"
+        placeholder="每行一个类目（x 轴标签 / 扇区名）"
+        @update:value="categoriesText = $event"
+      />
+    </div>
+
+    <div class="props-title">
+      数据序列
+      <NButton size="tiny" secondary type="primary" class="ml-auto" @click="addSeries">+ 序列</NButton>
+    </div>
+    <div v-for="(s, i) in series" :key="i" class="chart-series">
+      <div class="props-row">
+        <span class="props-label">名称</span>
+        <NInput size="small" :value="seriesName(i)" @update:value="(v: string) => setSeriesName(i, v)" />
+        <NColorPicker
+          size="small"
+          :modes="['hex']"
+          :value="seriesColor(i)"
+          @update:value="(v: string) => setSeriesColor(i, v)"
+        />
+        <NButton
+          v-if="series.length > 1"
+          size="tiny"
+          quaternary
+          type="error"
+          @click="removeSeries(i)"
+        >
+          删
+        </NButton>
+      </div>
+      <div class="props-row">
+        <span class="props-label">数值</span>
+        <NInput
+          size="small"
+          type="textarea"
+          :autosize="{ minRows: 2, maxRows: 6 }"
+          :value="seriesDataText(i)"
+          :placeholder="isPie ? '每行一个扇区数值' : '每行一个数值（与类目对应）'"
+          @update:value="(v: string) => setSeriesData(i, v)"
+        />
+      </div>
+    </div>
+
+    <div class="props-title">外观</div>
+    <div v-if="!isPie" class="props-row">
+      <span class="props-label">坐标轴</span>
+      <NSwitch size="small" :value="showAxis" @update:value="showAxis = $event" />
+    </div>
+    <div v-if="!isPie" class="props-row">
+      <span class="props-label">网格线</span>
+      <NSwitch size="small" :value="showGrid" @update:value="showGrid = $event" />
+    </div>
+    <div class="props-row">
+      <span class="props-label">图例</span>
+      <NSwitch size="small" :value="showLegend" @update:value="showLegend = $event" />
+    </div>
+    <div class="props-row">
+      <span class="props-label">数据标签</span>
+      <NSwitch size="small" :value="valueLabel" @update:value="valueLabel = $event" />
+    </div>
+    <div class="props-row">
+      <span class="props-label">图例对齐</span>
+      <NSelect
+        size="small"
+        :value="labelAlign"
+        :options="[
+          { label: '左对齐', value: 'left' },
+          { label: '居中', value: 'center' },
+          { label: '右对齐', value: 'right' },
+        ]"
+        @update:value="labelAlign = $event"
+      />
+    </div>
+    <div v-if="isLine" class="props-row">
+      <span class="props-label">平滑曲线</span>
+      <NSwitch size="small" :value="smooth" @update:value="smooth = $event" />
+    </div>
+    <div v-if="isLine" class="props-row">
+      <span class="props-label">面积填充</span>
+      <NSwitch size="small" :value="area" @update:value="area = $event" />
+    </div>
+    <div v-if="isPie" class="props-row">
+      <span class="props-label">环形</span>
+      <NSwitch size="small" :value="donut" @update:value="donut = $event" />
+    </div>
+  </div>
+</template>
+
+<style scoped>
+.chart-series {
+  border: 1px dashed var(--brand-border);
+  border-radius: 8px;
+  padding: 6px 8px;
+  margin-bottom: 8px;
+  background: var(--brand-surface);
+}
+.ml-auto {
+  margin-left: auto;
+}
+</style>
diff --git a/openprint/src/design/panels/props/CodeProps.vue b/openprint/src/design/panels/props/CodeProps.vue
new file mode 100644
index 0000000..5c76685
--- /dev/null
+++ b/openprint/src/design/panels/props/CodeProps.vue
@@ -0,0 +1,100 @@
+<script setup lang="ts">
+/**
+ * CodeProps —— 条码 / 二维码控件属性（§5.7）
+ */
+import { computed } from 'vue'
+import { NInput, NSelect, NSwitch } from 'naive-ui'
+import type { BarcodeControl, QrcodeControl } from '@/types/control'
+import { useDesignerStore } from '@/design/stores/designer'
+import BindingEditor from './BindingEditor.vue'
+
+const store = useDesignerStore()
+const control = computed(() => store.selectedControl as BarcodeControl | QrcodeControl | null)
+const isBarcode = computed(() => control.value?.type === 'barcode')
+
+function patch(p: Record<string, unknown>): void {
+  if (control.value) store.updateControl(control.value.id, p)
+}
+
+const contentMode = computed({
+  get: () => (control.value?.binding ? 'binding' : 'static'),
+  set: (m: string) => {
+    if (m === 'binding') patch({ binding: 'order.orderNo', value: undefined })
+    else patch({ binding: undefined, value: control.value?.value ?? '0123456789' })
+  },
+})
+
+const barcodeFormats = [
+  { label: 'CODE128', value: 'CODE128' },
+  { label: 'EAN-13', value: 'EAN13' },
+  { label: 'EAN-8', value: 'EAN8' },
+  { label: 'CODE39', value: 'CODE39' },
+  { label: 'ITF-14', value: 'ITF14' },
+  { label: 'UPC-A', value: 'UPCA' },
+]
+</script>
+
+<template>
+  <div v-if="control" class="props-section">
+    <div class="props-title">{{ isBarcode ? '条码设置' : '二维码设置' }}</div>
+
+    <div class="props-row">
+      <span class="props-label">内容</span>
+      <NSelect
+        v-model:value="contentMode"
+        size="small"
+        :options="[
+          { label: '静态内容', value: 'static' },
+          { label: '绑定字段', value: 'binding' },
+        ]"
+      />
+    </div>
+
+    <div v-if="contentMode === 'static'" class="props-row">
+      <NInput
+        size="small"
+        :value="control.value ?? ''"
+        placeholder="编码内容"
+        @update:value="patch({ value: $event || undefined })"
+      />
+    </div>
+    <div v-else class="props-row">
+      <BindingEditor :value="control.binding" @update:value="patch({ binding: $event })" />
+    </div>
+
+    <template v-if="isBarcode">
+      <div class="props-row">
+        <span class="props-label">格式</span>
+        <NSelect
+          size="small"
+          :value="(control as BarcodeControl).format ?? 'CODE128'"
+          :options="barcodeFormats"
+          @update:value="patch({ format: $event })"
+        />
+      </div>
+      <div class="props-row">
+        <span class="props-label">显示文字</span>
+        <NSwitch
+          size="small"
+          :value="(control as BarcodeControl).showText ?? true"
+          @update:value="patch({ showText: $event })"
+        />
+      </div>
+    </template>
+
+    <div v-else class="props-row">
+      <span class="props-label">纠错级</span>
+      <NSelect
+        size="small"
+        :value="(control as QrcodeControl).errorLevel ?? 'M'"
+        :options="[
+          { label: 'L（7%）', value: 'L' },
+          { label: 'M（15%）', value: 'M' },
+          { label: 'Q（25%）', value: 'Q' },
+          { label: 'H（30%）', value: 'H' },
+        ]"
+        @update:value="patch({ errorLevel: $event })"
+      />
+    </div>
+  </div>
+</template>
diff --git a/openprint/src/design/panels/props/CommonProps.vue b/openprint/src/design/panels/props/CommonProps.vue
new file mode 100644
index 0000000..e1434e2
--- /dev/null
+++ b/openprint/src/design/panels/props/CommonProps.vue
@@ -0,0 +1,154 @@
+<script setup lang="ts">
+/**
+ * CommonProps —— 所有控件通用属性：名称 / 几何 / 旋转 / 锁定 / 打印开关（§5.4a）
+ * 几何单位 mm（协议层），编辑即同步画布。
+ */
+import { computed } from 'vue'
+import { NInput, NInputNumber, NSwitch } from 'naive-ui'
+import { useDesignerStore } from '@/design/stores/designer'
+
+const store = useDesignerStore()
+const control = computed(() => store.selectedControl)
+
+function patch(p: Record<string, unknown>): void {
+  if (control.value) store.updateControl(control.value.id, p)
+}
+
+const isZone = computed(() => control.value?.type === 'zone')
+</script>
+
+<template>
+  <div v-if="control" class="props-section">
+    <div class="props-title">通用</div>
+
+    <div class="props-row">
+      <span class="props-label">名称</span>
+      <NInput
+        size="small"
+        :value="control.name ?? ''"
+        placeholder="图层名称"
+        @update:value="patch({ name: $event || undefined })"
+      />
+    </div>
+
+    <template v-if="!isZone">
+      <div class="grid grid-cols-2 gap-2">
+        <div class="props-row">
+          <span class="props-label">X</span>
+          <NInputNumber
+            size="small"
+            button-placement="both"
+            :value="Number.isFinite(control.left) ? control.left : 0"
+            :precision="1"
+            :step="0.1"
+            @update:value="patch({ left: $event ?? 0 })"
+          />
+        </div>
+        <div class="props-row">
+          <span class="props-label">Y</span>
+          <NInputNumber
+            size="small"
+            button-placement="both"
+            :value="Number.isFinite(control.top) ? control.top : 0"
+            :precision="1"
+            :step="0.1"
+            @update:value="patch({ top: $event ?? 0 })"
+          />
+        </div>
+        <div class="props-row">
+          <span class="props-label">宽</span>
+          <NInputNumber
+            size="small"
+            button-placement="both"
+            :value="Number.isFinite(control.width) ? control.width : 0"
+            :precision="1"
+            :min="0"
+            @update:value="patch({ width: $event ?? 0 })"
+          />
+        </div>
+        <div class="props-row">
+          <span class="props-label">高</span>
+          <NInputNumber
+            size="small"
+            button-placement="both"
+            :value="Number.isFinite(control.height) ? control.height : 0"
+            :precision="1"
+            :min="0"
+            @update:value="patch({ height: $event ?? 0 })"
+          />
+        </div>
+      </div>
+
+      <div class="props-row">
+        <span class="props-label">旋转</span>
+        <NInputNumber
+          size="small"
+          button-placement="both"
+          :value="control.angle ?? 0"
+          :min="-360"
+          :max="360"
+          style="width: 100px"
+          @update:value="patch({ angle: $event ?? 0 })"
+        />
+      </div>
+
+      <div class="props-row">
+        <span class="props-label">锁定</span>
+        <NSwitch
+          size="small"
+          :value="control.locked ?? false"
+          @update:value="patch({ locked: $event || undefined })"
+        />
+      </div>
+    </template>
+
+    <div class="props-row">
+      <span class="props-label">打印此元素</span>
+      <NSwitch
+        size="small"
+        :value="control.printable ?? true"
+        @update:value="patch({ printable: $event })"
+      />
+    </div>
+
+    <div class="props-row">
+      <span class="props-label">常驻辅助线</span>
+      <NSwitch
+        size="small"
+        :value="control.showGuides ?? false"
+        @update:value="patch({ showGuides: $event || undefined })"
+      />
+    </div>
+  </div>
+</template>
+
+<style>
+.props-section {
+  padding: 10px 12px;
+  border-bottom: 1px solid var(--brand-border);
+}
+.props-title {
+  font-size: 12px;
+  color: var(--brand-text-3);
+  margin-bottom: 8px;
+  text-transform: none;
+}
+.props-row {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  margin-bottom: 8px;
+}
+.props-label {
+  font-size: 12px;
+  color: var(--brand-text-2);
+  flex-shrink: 0;
+  min-width: 28px;
+}
+.props-tip {
+  font-size: 11px;
+  line-height: 1.5;
+  color: var(--brand-text-3);
+  margin: -2px 0 8px;
+}
+</style>
diff --git a/openprint/src/design/panels/props/ImageProps.vue b/openprint/src/design/panels/props/ImageProps.vue
new file mode 100644
index 0000000..bb7c9bf
--- /dev/null
+++ b/openprint/src/design/panels/props/ImageProps.vue
@@ -0,0 +1,105 @@
+<script setup lang="ts">
+/**
+ * ImageProps —— 图片控件属性（§5.8）
+ * inline 上传转 Base64 / url 外链 / binding 绑定字段（asset 后续接资源目录）
+ */
+import { computed } from 'vue'
+import { NInput, NInputNumber, NSelect, NButton, NUpload, type UploadCustomRequestOptions } from 'naive-ui'
+import type { ImageControl, ImageValueMode } from '@/types/control'
+import { useDesignerStore } from '@/design/stores/designer'
+import BindingEditor from './BindingEditor.vue'
+
+const store = useDesignerStore()
+const control = computed(() => store.selectedControl as ImageControl | null)
+
+function patch(p: Record<string, unknown>): void {
+  if (control.value) store.updateControl(control.value.id, p)
+}
+
+const mode = computed({
+  get: (): ImageValueMode => control.value?.value?.mode ?? 'inline',
+  set: (m: ImageValueMode) => {
+    patch({ value: { mode: m, content: '' } })
+  },
+})
+
+function patchContent(content: string): void {
+  if (!control.value) return
+  patch({ value: { mode: mode.value, content } })
+}
+
+/** 上传 → Base64 inline（§5.8 默认来源，自包含离线可用） */
+function onUpload({ file }: UploadCustomRequestOptions): void {
+  const raw = file.file
+  if (!raw) return
+  const reader = new FileReader()
+  reader.onload = () => {
+    patchContent(reader.result as string)
+  }
+  reader.readAsDataURL(raw)
+}
+</script>
+
+<template>
+  <div v-if="control" class="props-section">
+    <div class="props-title">图片来源</div>
+
+    <div class="props-row">
+      <span class="props-label">方式</span>
+      <NSelect
+        v-model:value="mode"
+        size="small"
+        :options="[
+          { label: '上传图片', value: 'inline' },
+          { label: '图片 URL', value: 'url' },
+          { label: '绑定字段', value: 'binding' },
+        ]"
+      />
+    </div>
+
+    <div v-if="mode === 'inline'" class="props-row">
+      <NUpload :show-file-list="false" accept="image/*" :custom-request="onUpload">
+        <NButton size="small" dashed block>选择图片（转 Base64 内联）</NButton>
+      </NUpload>
+    </div>
+    <div v-else-if="mode === 'url'" class="props-row">
+      <NInput
+        size="small"
+        :value="control.value?.content ?? ''"
+        placeholder="https://…"
+        @update:value="patchContent"
+      />
+    </div>
+    <div v-else class="props-row">
+      <BindingEditor :value="control.value?.content" @update:value="patchContent($event ?? '')" />
+    </div>
+  </div>
+
+  <div v-if="control" class="props-section">
+    <div class="props-title">显示</div>
+    <div class="props-row">
+      <span class="props-label">填充</span>
+      <NSelect
+        size="small"
+        :value="control.fit ?? 'contain'"
+        :options="[
+          { label: '包含 contain', value: 'contain' },
+          { label: '覆盖 cover', value: 'cover' },
+          { label: '拉伸 fill', value: 'fill' },
+          { label: '原始 none', value: 'none' },
+        ]"
+        @update:value="patch({ fit: $event })"
+      />
+    </div>
+    <div class="props-row">
+      <span class="props-label">圆角</span>
+      <NInputNumber
+        size="small"
+        button-placement="both"
+        :value="control.cornerRadius ?? 0"
+        :min="0"
+        @update:value="patch({ cornerRadius: $event ?? 0 })"
+      />
+    </div>
+  </div>
+</template>
diff --git a/openprint/src/design/panels/props/RichTextEditor.vue b/openprint/src/design/panels/props/RichTextEditor.vue
new file mode 100644
index 0000000..e4c9527
--- /dev/null
+++ b/openprint/src/design/panels/props/RichTextEditor.vue
@@ -0,0 +1,236 @@
+<script setup lang="ts">
+/**
+ * RichTextEditor —— 富文本编辑器（tiptap v3 + StarterKit + 字体扩展，懒加载）
+ * 由 RichTextProps 通过 defineAsyncComponent 引入，未选中富文本时不加载 tiptap。
+ */
+import { onBeforeUnmount, ref, watch } from 'vue'
+import { NButton, NSelect } from 'naive-ui'
+import { Editor, EditorContent } from '@tiptap/vue-3'
+import StarterKit from '@tiptap/starter-kit'
+import { TextStyle } from '@tiptap/extension-text-style'
+import { FontFamily } from '@tiptap/extension-font-family'
+import { FONT_CATALOG } from '@/core/fonts/catalog'
+
+const props = defineProps<{ modelValue?: string }>()
+const emit = defineEmits<{ (e: 'update:modelValue', v: string): void }>()
+
+const editor = new Editor({
+  extensions: [StarterKit, TextStyle, FontFamily],
+  content: props.modelValue ?? '',
+  onUpdate: ({ editor }) => emit('update:modelValue', editor.getHTML()),
+})
+
+/** 外部改动（撤销/加载模板/重置）→ 回写编辑器；emitUpdate:false 避免触发 onUpdate 死循环 */
+watch(
+  () => props.modelValue,
+  (v) => {
+    if (editor && v !== editor.getHTML()) {
+      editor.commands.setContent(v ?? '', { emitUpdate: false })
+    }
+  },
+)
+
+onBeforeUnmount(() => {
+  editor.destroy()
+})
+
+/* ------------------------------ 字体选择 ------------------------------ */
+
+/** 编辑器当前字体族（textStyle mark 上） */
+const currentFont = ref('')
+const refreshFont = (): void => {
+  currentFont.value = (editor.getAttributes('textStyle').fontFamily as string | undefined) ?? ''
+}
+editor.on('selectionUpdate', refreshFont)
+editor.on('transaction', refreshFont)
+watch(
+  () => props.modelValue,
+  () => refreshFont(),
+)
+
+const FONT_OPTIONS = [
+  { label: '系统默认', value: '' },
+  ...FONT_CATALOG.map((f) => ({ label: f.label, value: f.family })),
+]
+
+function onFontChange(family: string): void {
+  if (!family) {
+    editor.chain().focus().unsetFontFamily().run()
+  } else {
+    editor.chain().focus().setFontFamily(family).run()
+  }
+  refreshFont()
+}
+
+type ToolButton = {
+  key: string
+  label?: string
+  icon?: string
+  title: string
+  active: () => boolean
+  run: () => void
+}
+
+const tools: ToolButton[] = [
+  {
+    key: 'bold',
+    icon: 'i-carbon-text-bold',
+    title: '加粗',
+    active: () => editor.isActive('bold'),
+    run: () => editor.chain().focus().toggleBold().run(),
+  },
+  {
+    key: 'italic',
+    icon: 'i-carbon-text-italic',
+    title: '斜体',
+    active: () => editor.isActive('italic'),
+    run: () => editor.chain().focus().toggleItalic().run(),
+  },
+  {
+    key: 'underline',
+    icon: 'i-carbon-text-underline',
+    title: '下划线',
+    active: () => editor.isActive('underline'),
+    run: () => editor.chain().focus().toggleUnderline().run(),
+  },
+  {
+    key: 'h2',
+    label: 'H2',
+    title: '二级标题',
+    active: () => editor.isActive('heading', { level: 2 }),
+    run: () => editor.chain().focus().toggleHeading({ level: 2 }).run(),
+  },
+  {
+    key: 'h3',
+    label: 'H3',
+    title: '三级标题',
+    active: () => editor.isActive('heading', { level: 3 }),
+    run: () => editor.chain().focus().toggleHeading({ level: 3 }).run(),
+  },
+  {
+    key: 'ul',
+    icon: 'i-carbon-list-bulleted',
+    title: '无序列表',
+    active: () => editor.isActive('bulletList'),
+    run: () => editor.chain().focus().toggleBulletList().run(),
+  },
+  {
+    key: 'ol',
+    icon: 'i-carbon-list-numbered',
+    title: '有序列表',
+    active: () => editor.isActive('orderedList'),
+    run: () => editor.chain().focus().toggleOrderedList().run(),
+  },
+  {
+    key: 'blockquote',
+    label: '❝',
+    title: '引用',
+    active: () => editor.isActive('blockquote'),
+    run: () => editor.chain().focus().toggleBlockquote().run(),
+  },
+  {
+    key: 'undo',
+    icon: 'i-carbon-undo',
+    title: '撤销',
+    active: () => false,
+    run: () => editor.chain().focus().undo().run(),
+  },
+  {
+    key: 'redo',
+    icon: 'i-carbon-redo',
+    title: '重做',
+    active: () => false,
+    run: () => editor.chain().focus().redo().run(),
+  },
+]
+</script>
+
+<template>
+  <div class="rt-editor">
+    <div class="rt-toolbar">
+      <NSelect
+        size="tiny"
+        :value="currentFont"
+        :options="FONT_OPTIONS"
+        class="rt-font-select"
+        placeholder="字体"
+        @update:value="onFontChange"
+      />
+      <NButton
+        v-for="t in tools"
+        :key="t.key"
+        size="tiny"
+        quaternary
+        :type="t.active() ? 'primary' : 'default'"
+        :title="t.title"
+        @click="t.run()"
+      >
+        <div v-if="t.icon" :class="t.icon" class="text-13px" />
+        <span v-else class="text-12px font-bold">{{ t.label }}</span>
+      </NButton>
+    </div>
+    <div class="rt-body">
+      <EditorContent :editor="editor" class="rt-content" />
+    </div>
+  </div>
+</template>
+
+<style scoped>
+.rt-editor {
+  display: flex;
+  flex-direction: column;
+  gap: 6px;
+}
+.rt-toolbar {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 2px;
+  align-items: center;
+}
+.rt-font-select {
+  width: 108px;
+  margin-right: 4px;
+}
+.rt-body {
+  border: 1px solid var(--brand-border);
+  border-radius: 6px;
+  background: var(--brand-surface);
+}
+.rt-body:focus-within {
+  border-color: var(--brand-primary);
+}
+/* tiptap 内部 DOM 无 scoped 属性，需 :deep 命中 */
+.rt-content :deep(.tiptap) {
+  min-height: 160px;
+  max-height: 260px;
+  overflow-y: auto;
+  padding: 8px 10px;
+  outline: none;
+  font-size: 13px;
+  line-height: 1.6;
+  color: var(--brand-text-1);
+}
+.rt-content :deep(.tiptap p) {
+  margin: 0.4em 0;
+}
+.rt-content :deep(.tiptap h1),
+.rt-content :deep(.tiptap h2),
+.rt-content :deep(.tiptap h3) {
+  margin: 0.5em 0 0.3em;
+  font-weight: 600;
+}
+.rt-content :deep(.tiptap ul),
+.rt-content :deep(.tiptap ol) {
+  padding-left: 1.4em;
+  margin: 0.4em 0;
+}
+.rt-content :deep(.tiptap blockquote) {
+  margin: 0.4em 0;
+  padding-left: 0.8em;
+  border-left: 3px solid var(--brand-border);
+  color: var(--brand-text-3);
+}
+.rt-content :deep(.tiptap:focus) {
+  outline: none;
+}
+</style>
diff --git a/openprint/src/design/panels/props/RichTextProps.vue b/openprint/src/design/panels/props/RichTextProps.vue
new file mode 100644
index 0000000..dfa403b
--- /dev/null
+++ b/openprint/src/design/panels/props/RichTextProps.vue
@@ -0,0 +1,56 @@
+<script setup lang="ts">
+/**
+ * RichTextProps —— 富文本控件属性（§5.8）
+ * tiptap 编辑器通过 defineAsyncComponent 懒加载，避免拖入/浏览时加载重型依赖。
+ */
+import { computed, defineAsyncComponent } from 'vue'
+import { NInputNumber } from 'naive-ui'
+import type { RichTextControl } from '@/types/control'
+import { useDesignerStore } from '@/design/stores/designer'
+
+const RichTextEditor = defineAsyncComponent(() => import('./RichTextEditor.vue'))
+
+const store = useDesignerStore()
+const control = computed(() => store.selectedControl as RichTextControl | null)
+
+function patch(p: Record<string, unknown>): void {
+  if (control.value) store.updateControl(control.value.id, p)
+}
+</script>
+
+<template>
+  <div v-if="control" class="props-section">
+    <div class="props-title">内容</div>
+    <div class="mb-1 text-11px text-brand-text-3">在此输入富文本，画布实时预览</div>
+    <RichTextEditor
+      :model-value="control.value ?? ''"
+      @update:model-value="patch({ value: $event })"
+    />
+  </div>
+
+  <div v-if="control" class="props-section">
+    <div class="props-title">尺寸</div>
+    <div class="grid grid-cols-2 gap-2">
+      <div class="props-row">
+        <span class="props-label">宽</span>
+        <NInputNumber
+          size="small"
+          button-placement="both"
+          :value="control.width"
+          :min="1"
+          @update:value="patch({ width: $event ?? control.width })"
+        />
+      </div>
+      <div class="props-row">
+        <span class="props-label">高</span>
+        <NInputNumber
+          size="small"
+          button-placement="both"
+          :value="control.height"
+          :min="1"
+          @update:value="patch({ height: $event ?? control.height })"
+        />
+      </div>
+    </div>
+  </div>
+</template>
diff --git a/openprint/src/design/panels/props/ShapeProps.vue b/openprint/src/design/panels/props/ShapeProps.vue
new file mode 100644
index 0000000..1aa20c7
--- /dev/null
+++ b/openprint/src/design/panels/props/ShapeProps.vue
@@ -0,0 +1,201 @@
+<script setup lang="ts">
+/**
+ * ShapeProps —— 矩形 / 圆形 / 线条控件属性
+ */
+import { computed } from 'vue'
+import { NInputNumber, NColorPicker, NSwitch, NSelect, NButton } from 'naive-ui'
+import type { LineControl, RectControl } from '@/types/control'
+import { useDesignerStore } from '@/design/stores/designer'
+
+const store = useDesignerStore()
+const control = computed(() => store.selectedControl as RectControl | LineControl | null)
+const isRect = computed(() => control.value?.type === 'rect')
+const isCircle = computed(() => isRect.value && (control.value as RectControl)?.shape === 'circle')
+
+function patch(p: Record<string, unknown>): void {
+  if (control.value) store.updateControl(control.value.id, p)
+}
+
+const dashed = computed({
+  get: () => !!((control.value as LineControl | RectControl | null)?.strokeDashArray?.length),
+  set: (v: boolean) => patch({ strokeDashArray: v ? [6, 4] : undefined }),
+})
+
+/* ----------------------------- 圆角（四角独立） ----------------------------- */
+
+const baseRadius = computed(() => (control.value as RectControl)?.cornerRadius ?? 0)
+const radiusTL = computed(() => (control.value as RectControl)?.cornerRadiusTL ?? baseRadius.value)
+const radiusTR = computed(() => (control.value as RectControl)?.cornerRadiusTR ?? baseRadius.value)
+const radiusBR = computed(() => (control.value as RectControl)?.cornerRadiusBR ?? baseRadius.value)
+const radiusBL = computed(() => (control.value as RectControl)?.cornerRadiusBL ?? baseRadius.value)
+
+/** 统一圆角：设定后清空四角独立覆盖，使其回落到统一值 */
+function onUnifiedRadius(v: number | null): void {
+  patch({
+    cornerRadius: v ?? 0,
+    cornerRadiusTL: undefined,
+    cornerRadiusTR: undefined,
+    cornerRadiusBR: undefined,
+    cornerRadiusBL: undefined,
+  })
+}
+
+function onCornerRadius(side: 'TL' | 'TR' | 'BR' | 'BL', v: number | null): void {
+  patch({ [`cornerRadius${side}`]: v ?? 0 })
+}
+
+/** 矩形⇄圆形切换：切到圆形时强制正方形（正圆），切回矩形保留尺寸 */
+function onShapeChange(v: 'rect' | 'circle'): void {
+  const c = control.value as RectControl
+  if (v === 'circle') {
+    const size = Math.max(c.width ?? 0, c.height ?? 0)
+    patch({ shape: 'circle', cornerRadius: 0, width: size, height: size })
+  } else {
+    patch({ shape: 'rect', cornerRadius: c.cornerRadius ?? 0 })
+  }
+}
+
+/** 圆形：一键还原为正圆（取当前长边为直径） */
+function makePerfectCircle(): void {
+  const c = control.value as RectControl
+  const size = Math.max(c.width ?? 0, c.height ?? 0)
+  patch({ width: size, height: size })
+}
+</script>
+
+<template>
+  <div v-if="control" class="props-section">
+    <div class="props-title">{{ isCircle ? '圆形样式' : isRect ? '矩形样式' : '线条样式' }}</div>
+
+    <!-- 形状切换（仅 rect 类型可切换矩形/圆形） -->
+    <div v-if="isRect" class="props-row">
+      <span class="props-label">形状</span>
+      <NSelect
+        size="small"
+        :value="(control as RectControl).shape ?? 'rect'"
+        :options="[
+          { label: '矩形', value: 'rect' },
+          { label: '圆形', value: 'circle' },
+        ]"
+        @update:value="onShapeChange"
+      />
+    </div>
+
+    <div v-if="isRect" class="props-row">
+      <span class="props-label">填充</span>
+      <NColorPicker
+        size="small"
+        :modes="['hex']"
+        :value="(control as RectControl).fill ?? ''"
+        :swatches="['transparent', '#FFFFFF', '#F5F7FA', '#1677FF', '#000000']"
+        @update:value="patch({ fill: $event })"
+      />
+    </div>
+
+    <div class="props-row">
+      <span class="props-label">描边</span>
+      <NColorPicker
+        size="small"
+        :modes="['hex']"
+        :value="control.stroke ?? '#000000'"
+        :swatches="['#000000', '#333333', '#999999', '#E5E7EB', '#1677FF', '#F5222D']"
+        @update:value="patch({ stroke: $event })"
+      />
+    </div>
+
+    <div class="props-row">
+      <span class="props-label">线宽</span>
+      <NInputNumber
+        size="small"
+        button-placement="both"
+        :value="control.strokeWidth ?? 1"
+        :min="0"
+        :max="20"
+        :precision="1"
+        @update:value="patch({ strokeWidth: $event ?? 1 })"
+      />
+    </div>
+
+    <!-- 统一圆角（仅矩形；圆形本身为正圆/椭圆，无圆角概念） -->
+    <div v-if="isRect && !isCircle" class="props-row">
+      <span class="props-label">圆角</span>
+      <NInputNumber
+        size="small"
+        button-placement="both"
+        :value="(control as RectControl).cornerRadius ?? 0"
+        :min="0"
+        @update:value="onUnifiedRadius"
+      />
+    </div>
+
+    <!-- 四角独立弧度（仅矩形） -->
+    <div v-if="isRect && !isCircle" class="props-sub">
+      <div class="props-sub-title">四角弧度（px）</div>
+      <div class="grid grid-cols-2 gap-2">
+        <div class="props-row">
+          <span class="props-label">左上</span>
+          <NInputNumber
+            size="small"
+            button-placement="both"
+            :value="radiusTL"
+            :min="0"
+            @update:value="(v: number | null) => onCornerRadius('TL', v)"
+          />
+        </div>
+        <div class="props-row">
+          <span class="props-label">右上</span>
+          <NInputNumber
+            size="small"
+            button-placement="both"
+            :value="radiusTR"
+            :min="0"
+            @update:value="(v: number | null) => onCornerRadius('TR', v)"
+          />
+        </div>
+        <div class="props-row">
+          <span class="props-label">左下</span>
+          <NInputNumber
+            size="small"
+            button-placement="both"
+            :value="radiusBL"
+            :min="0"
+            @update:value="(v: number | null) => onCornerRadius('BL', v)"
+          />
+        </div>
+        <div class="props-row">
+          <span class="props-label">右下</span>
+          <NInputNumber
+            size="small"
+            button-placement="both"
+            :value="radiusBR"
+            :min="0"
+            @update:value="(v: number | null) => onCornerRadius('BR', v)"
+          />
+        </div>
+      </div>
+    </div>
+
+    <!-- 圆形：一键还原正圆 -->
+    <div v-if="isCircle" class="props-row">
+      <span class="props-label">正圆</span>
+      <NButton size="small" @click="makePerfectCircle">还原为正圆</NButton>
+    </div>
+
+    <!-- 虚线开关（矩形、圆形、线条都支持） -->
+    <div class="props-row">
+      <span class="props-label">虚线</span>
+      <NSwitch size="small" :value="dashed" @update:value="dashed = $event" />
+    </div>
+  </div>
+</template>
+
+<style scoped>
+.props-sub {
+  margin: 4px 0 8px;
+}
+.props-sub-title {
+  font-size: 11px;
+  color: var(--brand-text-3);
+  margin-bottom: 6px;
+}
+</style>
diff --git a/openprint/src/design/panels/props/TableProps.vue b/openprint/src/design/panels/props/TableProps.vue
new file mode 100644
index 0000000..7864f7e
--- /dev/null
+++ b/openprint/src/design/panels/props/TableProps.vue
@@ -0,0 +1,797 @@
+<script setup lang="ts">
+/**
+ * TableProps —— 表格控件属性（§5.4）
+ * 核心 3 开关置顶（repeatHeader / repeatFooter / pageRows），进阶折叠。
+ *
+ * #100 网格管理：表头/正文/静态尾行数 stepper、列增删与左右移动、表格默认单元格样式、列单元格样式。
+ * 所有网格变更走 table-cells.ts 的纯函数（setGridRows / addTableColumn / removeTableColumn / moveTableColumn），
+ * 保证 cells 矩阵与 headerRows/designRows/staticRows 元数据始终一致。
+ */
+import { computed, ref } from 'vue'
+import {
+  NAutoComplete,
+  NButton,
+  NInput,
+  NInputNumber,
+  NSelect,
+  NSwitch,
+  NColorPicker,
+  NCollapse,
+  NCollapseItem,
+} from 'naive-ui'
+import type { TableColumn, TableControl, TableOptions, TableCellStyle, CellFormat, CellFormatKind, TableStylePreset } from '@/types/control'
+import { useDesignerStore } from '@/design/stores/designer'
+import { useDataSourceStore } from '@/design/stores/dataSource'
+import {
+  addTableColumn,
+  moveTableColumn,
+  removeTableColumn,
+  setGridRows,
+} from '@/core/layout-engine/table-cells'
+import {
+  formatKindOptions,
+  datePatternOptions,
+  currencyCodeOptions,
+  makeFormat,
+  needsPattern,
+  needsDigits,
+  needsCode,
+  supportsThousands,
+} from '@/design/format-options'
+import { tableStyleLabel, TABLE_STYLE_PRESETS } from '@/design/canvas/table-style-presets'
+import TableStylePickerModal from '@/design/modals/TableStylePickerModal.vue'
+import BindingEditor from './BindingEditor.vue'
+
+const store = useDesignerStore()
+const control = computed(() => store.selectedControl as TableControl | null)
+const isData = computed(() => Boolean(control.value?.dataSource?.trim()))
+
+function patch(p: Record<string, unknown>): void {
+  if (control.value) store.updateControl(control.value.id, p)
+}
+
+function patchOptions(p: Partial<TableOptions>): void {
+  if (!control.value) return
+  const next: Record<string, unknown> = { ...control.value.options, ...p }
+  // 清理被显式置 undefined 的键（如关闭合计行时 summaryRow:undefined），避免脏字段残留
+  for (const k of Object.keys(next)) if (next[k] === undefined) delete next[k]
+  patch({ options: next as unknown as TableOptions })
+}
+
+function patchColumn(index: number, p: Partial<TableColumn>): void {
+  if (!control.value) return
+  const columns = control.value.columns.map((c, i) => (i === index ? { ...c, ...p } : c))
+  patch({ columns })
+}
+
+/**
+ * 列字段下拉选项：与左侧数据源联动。
+ * 数据表的列字段应是「数组（明细）字段」——路径含 `items[].`，运行期按行迭代取值。
+ * 自由文本仍允许（用户可手填任意路径），故用 NAutoComplete 而非 NSelect。
+ */
+const columnFieldOptions = computed(() => {
+  const list = ds.flatFields.filter((f) => f.path.includes('[]'))
+  return [
+    { label: '（不绑定）', value: '' },
+    ...list.map((f) => ({
+      label: `${f.label}  ·  ${f.path}`,
+      value: f.path,
+    })),
+  ]
+})
+
+/** 列是否参与尾行合计（本页合计 / 总计） */
+function setColumnAggregate(index: number, on: boolean): void {
+  patchColumn(index, { aggregate: on ? true : false })
+}
+
+/** 应用一个返回"新控件"的网格纯函数（保持类型/ID 不变） */
+function applyGrid(fn: (c: TableControl) => TableControl): void {
+  const c = control.value
+  if (!c) return
+  store.updateControl(c.id, fn(c))
+}
+
+/* ----------------------------- 网格结构（行） ----------------------------- */
+
+function setHeaderRows(v: number | null): void {
+  applyGrid((c) => setGridRows(c, { headerRows: v ?? 0 }))
+}
+function setDesignRows(v: number | null): void {
+  applyGrid((c) => setGridRows(c, { designRows: v ?? 0 }))
+}
+function setStaticRows(v: number | null): void {
+  applyGrid((c) => setGridRows(c, { staticRows: v ?? 0 }))
+}
+
+/* ------------------------------- 列管理 ------------------------------- */
+
+function addColumn(): void {
+  applyGrid((c) => addTableColumn(c))
+}
+function removeColumn(index: number): void {
+  applyGrid((c) => removeTableColumn(c, index))
+}
+function moveColumn(index: number, dir: -1 | 1): void {
+  applyGrid((c) => moveTableColumn(c, index, index + dir))
+}
+
+/* ------------------------------ 样式编辑 ------------------------------ */
+
+const alignOptions = [
+  { label: '左', value: 'left' },
+  { label: '中', value: 'center' },
+  { label: '右', value: 'right' },
+]
+
+/** 当前表格样式预设（用于「样式库」弹窗选中高亮与按钮文案） */
+const currentStyle = computed<TableStylePreset>(
+  () => (control.value?.options?.tableStyle ?? 'none') as TableStylePreset,
+)
+const pickerShow = ref(false)
+function pickStyle(key: TableStylePreset): void {
+  const meta = TABLE_STYLE_PRESETS.find((p) => p.key === key)
+  // 预设若捆绑了边框方案，则配色 + 框线一并套用；否则只改配色、保留当前边框
+  patchOptions(meta?.borders ? { tableStyle: key, borders: meta.borders } : { tableStyle: key })
+}
+const valignOptions = [
+  { label: '顶部', value: 'top' },
+  { label: '居中', value: 'middle' },
+  { label: '底部', value: 'bottom' },
+]
+
+/** 合并补丁并清理"被清空"的项（null / 空串），避免脏样式残留 */
+function mergeClean(cur: Record<string, unknown>, p: Record<string, unknown>): Record<string, unknown> {
+  const next = { ...cur, ...p }
+  for (const k of Object.keys(next)) {
+    if (next[k] === null || next[k] === '') delete next[k]
+  }
+  return next
+}
+
+function patchDefaultStyle(p: Record<string, unknown>): void {
+  if (!control.value) return
+  const cur = (control.value.options?.defaultCellStyle ?? {}) as Record<string, unknown>
+  patchOptions({ defaultCellStyle: mergeClean(cur, p) as unknown as TableCellStyle })
+}
+
+function patchColumnStyle(index: number, p: Record<string, unknown>): void {
+  if (!control.value) return
+  const cur = (control.value.columns[index]?.style ?? {}) as Record<string, unknown>
+  patchColumn(index, { style: mergeClean(cur, p) as unknown as TableCellStyle })
+}
+
+/* ------------------------------ 列数据格式 ------------------------------ */
+
+/** 写回列格式：kind='none' 视为清除（删字段，保持模型干净） */
+function patchColumnFormat(index: number, fmt: CellFormat | undefined): void {
+  patchColumn(index, { format: fmt && fmt.kind !== 'none' ? fmt : undefined })
+}
+
+/** 数据源字段类型查表（按完整 path），用于给出"字段类型"提示 */
+const fieldTypeMap = computed(() => {
+  const m = new Map<string, string>()
+  for (const f of ds.flatFields) m.set(f.path, f.type)
+  return m
+})
+function fieldTypeOf(path?: string): string | undefined {
+  return path ? fieldTypeMap.value.get(path) : undefined
+}
+function isPresetDatePattern(p?: string): boolean {
+  return Boolean(p && datePatternOptions.some((o) => o.value !== '__custom__' && o.value === p))
+}
+
+/* --------------------------- 数据源 store（合计/分组字段枚举） --------------------------- */
+const ds = useDataSourceStore()
+
+/* ------------------------------ 合计行（总计） ------------------------------ */
+
+const summary = computed(() => control.value?.options?.summaryRow ?? null)
+const hasSummary = computed(() => summary.value !== null)
+
+/** 开关合计行：开启时给一个兜底配置，关闭时清空 summaryRow 与遗留的 summary[]（单真相源） */
+function toggleSummary(on: boolean): void {
+  if (!control.value) return
+  if (on) {
+    patchOptions({ summaryRow: { type: 'sum', fields: [], label: '合计' } })
+    patch({ summary: undefined })
+  } else {
+    patchOptions({ summaryRow: undefined })
+    patch({ summary: undefined })
+  }
+}
+
+function patchSummary(p: Partial<NonNullable<TableControl['options']>['summaryRow']>): void {
+  if (!control.value) return
+  const cur = summary.value ?? { type: 'sum' as const, fields: [] as string[], label: '合计' }
+  patchOptions({ summaryRow: { ...cur, ...p } })
+  patch({ summary: undefined })
+}
+
+/** 自定义合计：编辑某字段的专属表达式（expressions[field]） */
+function patchSummaryExpr(field: string, expr: string | null): void {
+  if (!control.value) return
+  const cur = summary.value ?? { type: 'custom' as const, fields: [], label: '合计' }
+  const expressions = { ...(cur.expressions ?? {}) }
+  if (expr && expr.trim()) expressions[field] = expr
+  else delete expressions[field]
+  patchOptions({ summaryRow: { ...cur, type: 'custom', expressions } })
+  patch({ summary: undefined })
+}
+
+/** 自定义合计：兜底单表达式（无聚合列时生效） */
+function patchSummaryFallbackExpr(expr: string | null): void {
+  if (!control.value) return
+  const cur = summary.value ?? { type: 'custom' as const, fields: [], label: '合计' }
+  patchOptions({ summaryRow: { ...cur, type: 'custom', expression: expr || undefined } })
+  patch({ summary: undefined })
+}
+
+/** 分组小计标签模板（${key} 占位分组值） */
+function patchSubtotalLabel(v: string | null): void {
+  patchSummary({ subtotalLabel: v || undefined })
+}
+
+/** 聚合列选项：取"已绑定字段的列"，其值须与列 field 一致引擎才能按列落位 */
+const summaryFieldOptions = computed(() =>
+  (control.value?.columns ?? [])
+    .filter((c) => c.field)
+    .map((c) => ({ label: `${c.title || c.field} · ${c.field}`, value: c.field! })),
+)
+
+/* ------------------------------ 分组统计 ------------------------------ */
+
+/** 分组字段选项：取明细（数组）表的字段，value 用裸字段名（与运行期列 field 约定一致） */
+const groupFieldOptions = computed(() => {
+  const tables = ds.activeSource?.tables ?? []
+  const arrayIds = new Set(tables.filter((t) => t.isArray).map((t) => t.id))
+  return ds.flatFields
+    .filter((f) => (f.tableId ? arrayIds.has(f.tableId) : f.path.includes('[]')))
+    .map((f) => {
+      const tail = f.path.includes('[].') ? f.path.slice(f.path.indexOf('[].') + 3) : f.path
+      return { label: `${f.label} · ${f.path}`, value: tail }
+    })
+})
+
+function patchGroupBy(v: string | null): void {
+  patch({ groupBy: v || undefined })
+}
+</script>
+
+<template>
+  <div v-if="control" class="props-section">
+    <div class="props-title">数据设置</div>
+    <div class="props-row">
+      <span class="props-label">数据源</span>
+      <BindingEditor
+        :value="control.dataSource"
+        placeholder="留空 = 空白表格"
+        @update:value="patch({ dataSource: $event })"
+      />
+    </div>
+  </div>
+
+  <div v-if="control" class="props-section">
+    <div class="props-title">核心开关</div>
+    <div class="props-row">
+      <span class="props-label" style="min-width: 88px">每页打印标题行</span>
+      <NSwitch
+        size="small"
+        :value="control.options?.repeatHeader ?? true"
+        @update:value="patchOptions({ repeatHeader: $event })"
+      />
+    </div>
+    <div class="props-row">
+      <span class="props-label" style="min-width: 88px">每页打印合计行</span>
+      <NSwitch
+        size="small"
+        :value="control.options?.repeatFooter ?? true"
+        @update:value="patchOptions({ repeatFooter: $event })"
+      />
+    </div>
+    <div class="props-row">
+      <span class="props-label" style="min-width: 88px">每页行数</span>
+      <NInputNumber
+        size="small"
+        button-placement="both"
+        :value="control.options?.pageRows === 'auto' || control.options?.pageRows === undefined ? null : control.options.pageRows"
+        :min="1"
+        placeholder="auto"
+        clearable
+        @update:value="patchOptions({ pageRows: $event ?? 'auto' })"
+      />
+    </div>
+  </div>
+
+  <div v-if="control && isData" class="props-section">
+    <div class="props-title">合计行（总计）</div>
+    <div class="props-row">
+      <span class="props-label" style="min-width: 88px">显示合计行</span>
+      <NSwitch size="small" :value="hasSummary" @update:value="toggleSummary" />
+    </div>
+    <template v-if="hasSummary">
+      <div class="props-row">
+        <span class="props-label" style="min-width: 88px">统计方式</span>
+        <NSelect
+          size="small"
+          :value="summary?.type ?? 'sum'"
+          :options="[
+            { label: '求和', value: 'sum' },
+            { label: '计数', value: 'count' },
+            { label: '自定义表达式', value: 'custom' },
+          ]"
+          @update:value="patchSummary({ type: $event })"
+        />
+      </div>
+      <div class="props-row">
+        <span class="props-label" style="min-width: 88px">聚合列</span>
+        <NSelect
+          size="small"
+          multiple
+          :value="summary?.fields ?? []"
+          :options="summaryFieldOptions"
+          placeholder="选择参与统计的列"
+          @update:value="patchSummary({ fields: $event })"
+        />
+      </div>
+      <div class="props-row">
+        <span class="props-label" style="min-width: 88px">合计标签</span>
+        <NInput
+          size="small"
+          :value="summary?.label ?? '合计'"
+          placeholder="合计"
+          @update:value="patchSummary({ label: $event || '合计' })"
+        />
+      </div>
+      <template v-if="summary?.type === 'custom'">
+        <div class="props-tip">
+          自定义表达式作用域：<code>sum.字段</code> / <code>avg.字段</code>（按列预聚合）、<code>rows</code>（当前分组行）、<code>allRows</code>（整表行）。
+          先在上方「聚合列」选要显示结果的列，再为每列填表达式。例如 <code>sum.amount - sum.discount</code>。
+        </div>
+        <div v-for="f in summary?.fields ?? []" :key="f" class="props-row">
+          <span class="props-label" style="min-width: 88px">{{ f }} 表达式</span>
+          <NInput
+            size="small"
+            :value="summary?.expressions?.[f] ?? ''"
+            placeholder="如 sum.amount"
+            @update:value="patchSummaryExpr(f, $event)"
+          />
+        </div>
+        <div class="props-row">
+          <span class="props-label" style="min-width: 88px">兜底表达式</span>
+          <NInput
+            size="small"
+            :value="summary?.expression ?? ''"
+            placeholder="无聚合列时生效"
+            @update:value="patchSummaryFallbackExpr($event)"
+          />
+        </div>
+      </template>
+      <div class="props-tip">合计行固定在表尾；开启「每页打印合计行」后可每页重复。聚合列显示数值，其余列留空。</div>
+    </template>
+  </div>
+
+  <div v-if="control && isData" class="props-section">
+    <div class="props-title">分组统计</div>
+    <div class="props-row">
+      <span class="props-label" style="min-width: 88px">分组字段</span>
+      <NSelect
+        size="small"
+        clearable
+        filterable
+        :value="control.groupBy ?? null"
+        :options="groupFieldOptions"
+        placeholder="不分组"
+        @update:value="patchGroupBy"
+      />
+    </div>
+    <div class="props-tip">
+      按该字段分组打印；同时开启「合计行」后，<b>每个分组自动生成小计行</b>，末尾再附总计。
+    </div>
+    <template v-if="control.groupBy && hasSummary">
+      <div class="props-row">
+        <span class="props-label" style="min-width: 88px">小计标签</span>
+        <NInput
+          size="small"
+          :value="summary?.subtotalLabel ?? ''"
+          placeholder="${key} 小计"
+          @update:value="patchSubtotalLabel($event)"
+        />
+      </div>
+      <div class="props-tip"><code>${key}</code> 会被替换为分组值。例如 <code>类别合计</code> 或 <code>${key} 小计</code>。</div>
+      <div class="props-row">
+        <span class="props-label" style="min-width: 88px">小计加粗</span>
+        <NSwitch
+          size="small"
+          :value="summary?.subtotalStyle?.bold ?? true"
+          @update:value="patchSummary({ subtotalStyle: { ...(summary?.subtotalStyle ?? {}), bold: $event } })"
+        />
+      </div>
+      <div class="props-row">
+        <span class="props-label" style="min-width: 88px">小计字色</span>
+        <NColorPicker
+          size="small"
+          :modes="['hex']"
+          :value="summary?.subtotalStyle?.color"
+          :show-alpha="false"
+          @update:value="patchSummary({ subtotalStyle: { ...(summary?.subtotalStyle ?? {}), color: $event } })"
+        />
+      </div>
+    </template>
+  </div>
+
+  <div v-if="control" class="props-section">
+    <div class="props-title">表格样式</div>
+    <div class="props-row">
+      <span class="props-label" style="min-width: 88px">样式预设</span>
+      <span
+        class="props-link"
+        style="cursor: pointer"
+        @click="pickerShow = true"
+      >{{ tableStyleLabel(currentStyle) }}</span>
+      <NButton size="tiny" quaternary circle title="打开表格样式库" @click="pickerShow = true">
+        <span class="i-carbon-table" />
+      </NButton>
+    </div>
+    <div class="props-tip">
+      点击打开「表格样式库」，可预览每种样式并直接点选套用（类似 Excel 表格样式快速切换）。默认「无」仅显示边框与表头加粗，无任何背景色（含标题行）。
+    </div>
+    <TableStylePickerModal v-model:show="pickerShow" :current="currentStyle" @select="pickStyle" />
+  </div>
+
+  <div v-if="control" class="props-section">
+    <div class="props-title">网格结构</div>
+    <div class="props-row">
+      <span class="props-label" style="min-width: 88px">表头行数</span>
+      <NInputNumber
+        size="small"
+        button-placement="both"
+        :value="control.headerRows ?? (control.columns.some((c) => c.title) ? 1 : 0)"
+        :min="0"
+        :max="10"
+        @update:value="setHeaderRows($event)"
+      />
+    </div>
+    <template v-if="!isData">
+      <div class="props-row">
+        <span class="props-label" style="min-width: 88px">正文行数</span>
+        <NInputNumber
+          size="small"
+          button-placement="both"
+          :value="control.designRows ?? 0"
+          :min="0"
+          :max="100"
+          @update:value="setDesignRows($event)"
+        />
+      </div>
+      <div class="props-tip">布局网格：双击单元格可填写静态内容（表头 / 正文）。</div>
+    </template>
+    <template v-else>
+      <div class="props-row">
+        <span class="props-label" style="min-width: 88px">固定尾行</span>
+        <NInputNumber
+          size="small"
+          button-placement="both"
+          :value="control.staticRows ?? 0"
+          :min="0"
+          :max="20"
+          @update:value="setStaticRows($event)"
+        />
+      </div>
+      <div class="props-tip">数据表：固定尾行用于备注 / 签字栏等；合计行由「高级选项」配置。</div>
+    </template>
+  </div>
+
+  <div v-if="control" class="props-section">
+    <div class="props-title">列配置（{{ control.columns.length }} 列）</div>
+    <div v-for="(col, i) in control.columns" :key="i" class="mb-2 rounded border border-brand-border p-2">
+      <div class="mb-1.5 flex items-center justify-between">
+        <span class="text-12px text-gray-500">列 {{ i + 1 }}</span>
+        <div class="flex items-center gap-1">
+          <NButton text size="tiny" :disabled="i === 0" title="左移" @click="moveColumn(i, -1)">←</NButton>
+          <NButton text size="tiny" :disabled="i === control.columns.length - 1" title="右移" @click="moveColumn(i, 1)">→</NButton>
+          <NButton text size="tiny" type="error" :disabled="control.columns.length <= 1" @click="removeColumn(i)">
+            删除
+          </NButton>
+        </div>
+      </div>
+      <div class="props-row">
+        <span class="props-label">标题</span>
+        <NInput size="small" :value="col.title" @update:value="patchColumn(i, { title: $event })" />
+      </div>
+      <div class="props-row">
+        <span class="props-label">字段</span>
+        <NAutoComplete
+          size="small"
+          :value="col.field ?? ''"
+          :options="columnFieldOptions"
+          placeholder="选择或输入字段，如 items[].qty"
+          @update:value="patchColumn(i, { field: $event || undefined })"
+        />
+      </div>
+      <div class="props-row">
+        <span class="props-label">参与合计</span>
+        <NSwitch
+          size="small"
+          :value="col.aggregate === true || col.aggregate === 'sum' || col.aggregate === 'avg' || col.aggregate === 'count'"
+          @update:value="(v: boolean) => setColumnAggregate(i, v)"
+        />
+      </div>
+      <div class="grid grid-cols-2 gap-2">
+        <div class="props-row">
+          <span class="props-label">宽</span>
+          <NInputNumber
+            size="small"
+            button-placement="both"
+            :value="col.width"
+            :min="5"
+            @update:value="patchColumn(i, { width: $event ?? 30 })"
+          />
+        </div>
+        <div class="props-row">
+          <span class="props-label">对齐</span>
+          <NSelect
+            size="small"
+            :value="col.align ?? 'left'"
+            :options="alignOptions"
+            @update:value="patchColumn(i, { align: $event })"
+          />
+        </div>
+      </div>
+
+      <div class="mt-1.5 border-t border-brand-border pt-1.5">
+        <div class="mb-1 text-12px text-gray-500">数据格式</div>
+        <div class="props-row">
+          <span class="props-label">类型</span>
+          <NSelect
+            size="small"
+            :value="col.format?.kind ?? 'none'"
+            :options="formatKindOptions"
+            @update:value="(k: CellFormatKind) => patchColumnFormat(i, k === 'none' ? undefined : makeFormat(k))"
+          />
+        </div>
+        <template v-if="col.format && col.format.kind !== 'none'">
+          <div v-if="needsPattern(col.format.kind)" class="props-row">
+            <span class="props-label">日期模板</span>
+            <NSelect
+              size="small"
+              :value="isPresetDatePattern(col.format.pattern) ? col.format.pattern : '__custom__'"
+              :options="datePatternOptions"
+              @update:value="(v: string) => { if (v !== '__custom__') patchColumnFormat(i, { ...col.format!, pattern: v }) }"
+            />
+          </div>
+          <div v-if="needsPattern(col.format.kind) && !isPresetDatePattern(col.format.pattern)" class="props-row">
+            <span class="props-label">自定义</span>
+            <NInput
+              size="small"
+              :value="col.format.pattern"
+              placeholder="如 YYYY年MM月DD日"
+              @update:value="(v: string) => patchColumnFormat(i, { ...col.format!, pattern: v || 'YYYY-MM-DD' })"
+            />
+          </div>
+          <div v-if="needsDigits(col.format.kind)" class="props-row">
+            <span class="props-label">小数位</span>
+            <NInputNumber
+              size="small"
+              button-placement="both"
+              :value="col.format.digits ?? (col.format.kind === 'int' ? 0 : 2)"
+              :min="0"
+              :max="6"
+              @update:value="(v: number | null) => patchColumnFormat(i, { ...col.format!, digits: v ?? 0 })"
+            />
+          </div>
+          <div v-if="needsCode(col.format.kind)" class="props-row">
+            <span class="props-label">币种</span>
+            <NSelect
+              size="small"
+              :value="col.format.code ?? 'CNY'"
+              :options="currencyCodeOptions"
+              @update:value="(v: string) => patchColumnFormat(i, { ...col.format!, code: v })"
+            />
+          </div>
+          <div v-if="supportsThousands(col.format.kind)" class="props-row">
+            <span class="props-label">千分位</span>
+            <NSwitch
+              size="small"
+              :value="col.format.thousands ?? true"
+              @update:value="(v: boolean) => patchColumnFormat(i, { ...col.format!, thousands: v })"
+            />
+          </div>
+          <div v-if="fieldTypeOf(col.field)" class="props-tip">
+            绑定的字段类型为 <b>{{ fieldTypeOf(col.field) === 'date' ? '日期' : '数值' }}</b>，建议相应选择日期 / 数值格式。
+          </div>
+        </template>
+      </div>
+      <NCollapse class="mt-1">
+        <NCollapseItem title="单元格样式" name="col-style">
+          <div class="grid grid-cols-2 gap-2">
+            <div class="props-row">
+              <span class="props-label">加粗</span>
+              <NSwitch size="small" :value="col.style?.bold ?? false" @update:value="patchColumnStyle(i, { bold: $event })" />
+            </div>
+            <div class="props-row">
+              <span class="props-label">字色</span>
+              <NColorPicker
+                size="small"
+                :modes="['hex']"
+                :value="col.style?.color"
+                :show-alpha="false"
+                @update:value="patchColumnStyle(i, { color: $event })"
+              />
+            </div>
+            <div class="props-row">
+              <span class="props-label">单元格底</span>
+              <NColorPicker
+                size="small"
+                :modes="['hex']"
+                :value="col.cellBackgroundColor"
+                :show-alpha="true"
+                @update:value="patchColumn(i, { cellBackgroundColor: $event || undefined })"
+              />
+            </div>
+            <div class="props-row">
+              <span class="props-label">表头底</span>
+              <NColorPicker
+                size="small"
+                :modes="['hex']"
+                :value="col.headerBackgroundColor"
+                :show-alpha="true"
+                @update:value="patchColumn(i, { headerBackgroundColor: $event || undefined })"
+              />
+            </div>
+          </div>
+        </NCollapseItem>
+      </NCollapse>
+    </div>
+    <NButton size="small" dashed block @click="addColumn">+ 添加列</NButton>
+  </div>
+
+  <div v-if="control" class="props-section">
+    <div class="props-title">默认单元格样式</div>
+    <div class="props-tip">整表默认样式，可被列样式 / 单元格样式覆盖。</div>
+    <div class="grid grid-cols-2 gap-2">
+      <div class="props-row">
+        <span class="props-label">字号(pt)</span>
+        <NInputNumber
+          size="small"
+          button-placement="both"
+          :value="control.options?.defaultCellStyle?.fontSize ?? null"
+          :min="6"
+          :max="72"
+          placeholder="继承"
+          clearable
+          @update:value="patchDefaultStyle({ fontSize: $event })"
+        />
+      </div>
+      <div class="props-row">
+        <span class="props-label">对齐</span>
+        <NSelect
+          size="small"
+          :value="control.options?.defaultCellStyle?.align ?? 'left'"
+          :options="alignOptions"
+          @update:value="patchDefaultStyle({ align: $event })"
+        />
+      </div>
+      <div class="props-row">
+        <span class="props-label">垂直对齐</span>
+        <NSelect
+          size="small"
+          :value="control.options?.defaultCellStyle?.valign ?? 'middle'"
+          :options="valignOptions"
+          @update:value="patchDefaultStyle({ valign: $event })"
+        />
+      </div>
+      <div class="props-row">
+        <span class="props-label">字色</span>
+        <NColorPicker
+          size="small"
+          :modes="['hex']"
+          :value="control.options?.defaultCellStyle?.color"
+          :show-alpha="false"
+          @update:value="patchDefaultStyle({ color: $event })"
+        />
+      </div>
+      <div class="props-row">
+        <span class="props-label">背景</span>
+        <NColorPicker
+          size="small"
+          :modes="['hex']"
+          :value="control.options?.defaultCellStyle?.backgroundColor"
+          :show-alpha="true"
+          @update:value="patchDefaultStyle({ backgroundColor: $event })"
+        />
+      </div>
+    </div>
+    <div class="mt-1 grid grid-cols-3 gap-2">
+      <div class="props-row">
+        <span class="props-label">加粗</span>
+        <NSwitch size="small" :value="control.options?.defaultCellStyle?.bold ?? false" @update:value="patchDefaultStyle({ bold: $event })" />
+      </div>
+      <div class="props-row">
+        <span class="props-label">斜体</span>
+        <NSwitch size="small" :value="control.options?.defaultCellStyle?.italic ?? false" @update:value="patchDefaultStyle({ italic: $event })" />
+      </div>
+      <div class="props-row">
+        <span class="props-label">下划线</span>
+        <NSwitch size="small" :value="control.options?.defaultCellStyle?.underline ?? false" @update:value="patchDefaultStyle({ underline: $event })" />
+      </div>
+    </div>
+  </div>
+
+  <div v-if="control" class="props-section">
+    <NCollapse>
+      <NCollapseItem title="高级选项" name="advanced">
+        <div class="props-row">
+          <span class="props-label" style="min-width: 88px">行高模式</span>
+          <NSelect
+            size="small"
+            :value="control.options?.rowHeightMode ?? 'auto'"
+            :options="[
+              { label: '自动（内容撑开）', value: 'auto' },
+              { label: '固定行高', value: 'fixed' },
+            ]"
+            @update:value="patchOptions({ rowHeightMode: $event })"
+          />
+        </div>
+        <div v-if="control.options?.rowHeightMode === 'fixed'" class="props-row">
+          <span class="props-label" style="min-width: 88px">行高 (mm)</span>
+          <NInputNumber
+            size="small"
+            button-placement="both"
+            :value="control.options?.rowHeight ?? 8"
+            :min="2"
+            :precision="1"
+            @update:value="patchOptions({ rowHeight: $event ?? 8 })"
+          />
+        </div>
+        <div class="props-row">
+          <span class="props-label" style="min-width: 88px">整行跨页换页</span>
+          <NSwitch
+            size="small"
+            :value="control.options?.keepTogether ?? false"
+            @update:value="patchOptions({ keepTogether: $event })"
+          />
+        </div>
+        <div class="props-row">
+          <span class="props-label" style="min-width: 88px">跳过空行</span>
+          <NSwitch
+            size="small"
+            :value="control.options?.skipEmptyRows ?? false"
+            @update:value="patchOptions({ skipEmptyRows: $event })"
+          />
+        </div>
+        <div class="props-row">
+          <span class="props-label" style="min-width: 88px">斑马纹</span>
+          <NSwitch
+            size="small"
+            :value="control.options?.striped ?? false"
+            @update:value="patchOptions({ striped: $event })"
+          />
+        </div>
+        <div class="props-row">
+          <span class="props-label" style="min-width: 88px">垂直对齐</span>
+          <NSelect
+            size="small"
+            :value="control.options?.verticalAlign ?? 'middle'"
+            :options="valignOptions"
+            @update:value="patchOptions({ verticalAlign: $event })"
+          />
+        </div>
+        <div class="props-row">
+          <span class="props-label" style="min-width: 88px, 88px">边框</span>
+          <NSelect
+            size="small"
+            :value="control.options?.borders ?? 'all'"
+            :options="[
+              { label: '全部', value: 'all' },
+              { label: '仅横线', value: 'horizontal' },
+              { label: '仅外框', value: 'outline' },
+              { label: '无', value: 'none' },
+            ]"
+            @update:value="patchOptions({ borders: $event })"
+          />
+        </div>
+      </NCollapseItem>
+    </NCollapse>
+  </div>
+</template>
diff --git a/openprint/src/design/panels/props/TextProps.vue b/openprint/src/design/panels/props/TextProps.vue
new file mode 100644
index 0000000..2dcd3e7
--- /dev/null
+++ b/openprint/src/design/panels/props/TextProps.vue
@@ -0,0 +1,312 @@
+<script setup lang="ts">
+/**
+ * TextProps —— 文本控件属性（§5.2/§5.3）：内容（静态/绑定/表达式）+ 排版样式
+ */
+import { computed } from 'vue'
+import {
+  NInput,
+  NInputNumber,
+  NSelect,
+  NColorPicker,
+  NRadioGroup,
+  NRadioButton,
+  NButton,
+} from 'naive-ui'
+import type { CellFormat, CellFormatKind, TextControl, TextStyle } from '@/types/control'
+import { useDesignerStore } from '@/design/stores/designer'
+import { useDataSourceStore } from '@/design/stores/dataSource'
+import { FONT_CATALOG } from '@/core/fonts/catalog'
+import BindingEditor from './BindingEditor.vue'
+import {
+  formatKindOptions,
+  datePatternOptions,
+  currencyCodeOptions,
+  makeFormat,
+  needsPattern,
+  needsDigits,
+  needsCode,
+  supportsThousands,
+  suggestKindByFieldType,
+} from '@/design/format-options'
+
+const store = useDesignerStore()
+const control = computed(() => store.selectedControl as TextControl | null)
+const ds = useDataSourceStore()
+
+/** 内置字体下拉选项（空值 = 系统默认） */
+const fontOptions = [
+  { label: '系统默认', value: '' },
+  ...FONT_CATALOG.map((f) => ({ label: f.label, value: f.family })),
+]
+
+function patch(p: Record<string, unknown>): void {
+  if (control.value) store.updateControl(control.value.id, p)
+}
+
+function patchStyle(p: Partial<TextStyle>): void {
+  if (!control.value) return
+  patch({ style: { ...control.value.style, ...p } })
+}
+
+/** B / I / U 三键：加粗 / 斜体 / 下划线（切换式） */
+const isBold = computed(() => (control.value?.style?.fontWeight ?? 'normal') === 'bold')
+const isItalic = computed(() => (control.value?.style?.fontStyle ?? 'normal') === 'italic')
+const isUnderline = computed(() => (control.value?.style?.textDecoration ?? 'none') === 'underline')
+function toggleBold(): void {
+  patchStyle({ fontWeight: isBold.value ? 'normal' : 'bold' })
+}
+function toggleItalic(): void {
+  patchStyle({ fontStyle: isItalic.value ? 'normal' : 'italic' })
+}
+function toggleUnderline(): void {
+  patchStyle({ textDecoration: isUnderline.value ? 'none' : 'underline' })
+}
+
+/** 内容模式：静态文本 / 字段绑定 / 表达式（三选一） */
+const contentMode = computed({
+  get: () =>
+    control.value?.expression ? 'expression' : control.value?.binding ? 'binding' : 'static',
+  set: (mode: string) => {
+    if (!control.value) return
+    if (mode === 'static') patch({ binding: undefined, expression: undefined })
+    else if (mode === 'binding')
+      patch({ binding: control.value.binding ?? 'order.orderNo', expression: undefined })
+    else patch({ expression: control.value.expression ?? '{{order.total}}', binding: undefined })
+  },
+})
+
+/* -------------------------------- 数据格式 -------------------------------- */
+/* 仅绑定模式生效：expression 模式请用 {{field | date:'...'}} 过滤器，不在此重复设置。 */
+
+const textFormat = computed<CellFormat>(() => control.value?.format ?? { kind: 'none' })
+
+/** 绑定字段在数据源里的类型（用于提示选哪种格式） */
+const boundFieldType = computed(() => {
+  const path = control.value?.binding
+  if (!path) return undefined
+  const f = ds.flatFields.find((x) => x.path === path)
+  return f?.type
+})
+const formatHint = computed(() => {
+  const k = suggestKindByFieldType(boundFieldType.value)
+  if (k === 'date') return '绑定的字段为「日期」类型，建议选择日期格式。'
+  if (k === 'decimal') return '绑定的字段为「数值」类型，建议选择整数 / 小数 / 货币格式。'
+  return ''
+})
+
+function patchFormat(fmt: CellFormat): void {
+  patch({ format: fmt.kind === 'none' ? undefined : fmt })
+}
+function setFormatKind(kind: CellFormatKind): void {
+  if (kind === 'none') {
+    patch({ format: undefined })
+    return
+  }
+  // 第一次选择某类型：套用该类型默认格式，避免半成品
+  const cur = control.value?.format
+  patchFormat(cur && cur.kind === kind ? cur : makeFormat(kind))
+}
+function isPresetDatePattern(p?: string): boolean {
+  return Boolean(p && datePatternOptions.some((o) => o.value !== '__custom__' && o.value === p))
+}
+</script>
+
+<template>
+  <div v-if="control" class="props-section">
+    <div class="props-title">内容设置</div>
+
+    <div class="props-row">
+      <span class="props-label">类型</span>
+      <NRadioGroup v-model:value="contentMode" size="small">
+        <NRadioButton value="static">静态</NRadioButton>
+        <NRadioButton value="binding">绑定</NRadioButton>
+        <NRadioButton value="expression">表达式</NRadioButton>
+      </NRadioGroup>
+    </div>
+
+    <div v-if="contentMode === 'static'" class="props-row">
+      <NInput
+        type="textarea"
+        size="small"
+        :autosize="{ minRows: 3, maxRows: 4 }"
+        :value="control.value ?? ''"
+        placeholder="文本内容"
+        @update:value="patch({ value: $event })"
+      />
+    </div>
+    <div v-else-if="contentMode === 'binding'" class="props-row">
+      <BindingEditor :value="control.binding" @update:value="patch({ binding: $event })" />
+    </div>
+    <div v-if="contentMode === 'binding'" class="props-section">
+      <div class="props-title">数据格式</div>
+
+      <div v-if="formatHint" class="props-tip">{{ formatHint }}</div>
+
+      <div class="props-row">
+        <span class="props-label">类型</span>
+        <NSelect
+          size="small"
+          :value="textFormat.kind"
+          :options="formatKindOptions"
+          @update:value="setFormatKind"
+        />
+      </div>
+
+      <div v-if="needsPattern(textFormat.kind)" class="props-row">
+        <span class="props-label">日期模板</span>
+        <NSelect
+          size="small"
+          :value="isPresetDatePattern(textFormat.pattern) ? textFormat.pattern : '__custom__'"
+          :options="datePatternOptions"
+          @update:value="
+            (v: string) => {
+              if (v !== '__custom__') patchFormat({ ...textFormat, kind: 'date', pattern: v })
+            }
+          "
+        />
+      </div>
+      <div v-if="needsPattern(textFormat.kind) && !isPresetDatePattern(textFormat.pattern)" class="props-row">
+        <span class="props-label">自定义</span>
+        <NInput
+          size="small"
+          :value="textFormat.pattern ?? 'YYYY-MM-DD'"
+          placeholder="YYYY-MM-DD HH:mm"
+          @update:value="(v: string) => patchFormat({ ...textFormat, kind: 'date', pattern: v || 'YYYY-MM-DD' })"
+        />
+      </div>
+
+      <div v-if="needsDigits(textFormat.kind)" class="props-row">
+        <span class="props-label">小数位</span>
+        <NInputNumber
+          size="small"
+          button-placement="both"
+          :value="textFormat.digits ?? 2"
+          :min="0"
+          :max="6"
+          :precision="0"
+          @update:value="(v: number | null) => patchFormat({ ...textFormat, digits: v ?? 0 })"
+        />
+      </div>
+
+      <div v-if="needsCode(textFormat.kind)" class="props-row">
+        <span class="props-label">币种</span>
+        <NSelect
+          size="small"
+          :value="textFormat.code ?? 'CNY'"
+          :options="currencyCodeOptions"
+          @update:value="(v: string) => patchFormat({ ...textFormat, kind: 'currency', code: v })"
+        />
+      </div>
+
+      <div v-if="supportsThousands(textFormat.kind)" class="props-row">
+        <span class="props-label">千分位</span>
+        <NRadioGroup
+          size="small"
+          :value="textFormat.thousands === false ? 'off' : 'on'"
+          @update:value="(v: string) => patchFormat({ ...textFormat, thousands: v === 'on' })"
+        >
+          <NRadioButton value="on">开</NRadioButton>
+          <NRadioButton value="off">关</NRadioButton>
+        </NRadioGroup>
+      </div>
+
+      <NButton size="tiny" quaternary @click="patch({ format: undefined })">清除格式</NButton>
+    </div>
+    <div v-else class="props-row">
+      <NInput
+        size="small"
+        :value="control.expression ?? ''"
+        placeholder="{{order.total | currency:'CNY'}}"
+        @update:value="patch({ expression: $event || undefined })"
+      />
+    </div>
+  </div>
+
+  <div v-if="control" class="props-section">
+    <div class="props-title">排版设置</div>
+
+    <div class="grid grid-cols-2 gap-2">
+      <div class="props-row">
+        <span class="props-label">字号</span>
+        <NInputNumber
+          size="small"
+          button-placement="both"
+          :value="control.style?.fontSize ?? 12"
+          :min="6"
+          :max="72"
+          :precision="1"
+          @update:value="patchStyle({ fontSize: $event ?? 12 })"
+        />
+      </div>
+      <div class="props-row">
+        <span class="props-label">行高</span>
+        <NInputNumber
+          size="small"
+          button-placement="both"
+          :value="control.style?.lineHeight ?? 1.16"
+          :min="0.8"
+          :max="4"
+          :step="0.05"
+          :precision="2"
+          @update:value="patchStyle({ lineHeight: $event ?? 1.16 })"
+        />
+      </div>
+    </div>
+
+    <div class="props-row">
+      <span class="props-label">样式</span>
+      <div class="flex items-center gap-1">
+        <NButton size="small" :type="isBold ? 'primary' : 'default'" title="加粗" @click="toggleBold"><b>B</b></NButton>
+        <NButton size="small" :type="isItalic ? 'primary' : 'default'" title="斜体" @click="toggleItalic"><i>I</i></NButton>
+        <NButton size="small" :type="isUnderline ? 'primary' : 'default'" title="下划线" @click="toggleUnderline"><u>U</u></NButton>
+      </div>
+    </div>
+
+    <div class="props-row">
+      <span class="props-label">对齐</span>
+      <NRadioGroup
+        size="small"
+        :value="control.style?.textAlign ?? 'left'"
+        @update:value="patchStyle({ textAlign: $event })"
+      >
+        <NRadioButton value="left">左</NRadioButton>
+        <NRadioButton value="center">中</NRadioButton>
+        <NRadioButton value="right">右</NRadioButton>
+      </NRadioGroup>
+    </div>
+
+    <div class="props-row">
+      <span class="props-label">字体</span>
+      <NSelect
+        size="small"
+        :value="control.style?.fontFamily ?? ''"
+        :options="fontOptions"
+        placeholder="系统默认"
+        @update:value="patchStyle({ fontFamily: $event || undefined })"
+      />
+    </div>
+
+    <div class="props-row">
+      <span class="props-label">颜色</span>
+      <NColorPicker
+        size="small"
+        :modes="['hex']"
+        :value="control.style?.fill ?? '#000000'"
+        :swatches="['#000000', '#333333', '#666666', '#999999', '#1677FF', '#F5222D']"
+        @update:value="patchStyle({ fill: $event })"
+      />
+    </div>
+
+    <div class="props-row">
+      <span class="props-label">字距</span>
+      <NInputNumber
+        size="small"
+        button-placement="both"
+        :value="control.style?.letterSpacing ?? 0"
+        :step="0.5"
+        :precision="1"
+        @update:value="patchStyle({ letterSpacing: $event ?? 0 })"
+      />
+    </div>
+  </div>
+</template>
diff --git a/openprint/src/design/panels/props/ZoneProps.vue b/openprint/src/design/panels/props/ZoneProps.vue
new file mode 100644
index 0000000..60441e1
--- /dev/null
+++ b/openprint/src/design/panels/props/ZoneProps.vue
@@ -0,0 +1,50 @@
+<script setup lang="ts">
+/**
+ * ZoneProps —— 页眉/页脚区域控件属性（§5.14.3）：高度 / 每页重复
+ * 页码变量 {{page}} / {{pageTotal}} 仅在 zone 内文本生效（渲染期注入）。
+ */
+import { computed } from 'vue'
+import { NInputNumber, NSwitch, NAlert } from 'naive-ui'
+import type { ZoneControl } from '@/types/control'
+import { useDesignerStore } from '@/design/stores/designer'
+
+const store = useDesignerStore()
+const control = computed(() => store.selectedControl as ZoneControl | null)
+
+function patch(p: Record<string, unknown>): void {
+  if (control.value) store.updateControl(control.value.id, p)
+}
+</script>
+
+<template>
+  <div v-if="control" class="props-section">
+    <div class="props-title">{{ control.zone === 'header' ? '页眉区域' : '页脚区域' }}</div>
+
+    <div class="props-row">
+      <span class="props-label" style="min-width: 72px">高度 (mm)</span>
+      <NInputNumber
+        size="small"
+        button-placement="both"
+        :value="control.zoneHeight"
+        :min="5"
+        :max="80"
+        :precision="1"
+        @update:value="patch({ zoneHeight: $event ?? 20, height: $event ?? 20 })"
+      />
+    </div>
+
+    <div class="props-row">
+      <span class="props-label" style="min-width: 72px">每页重复</span>
+      <NSwitch
+        size="small"
+        :value="control.repeat ?? true"
+        @update:value="patch({ repeat: $event })"
+      />
+    </div>
+
+    <NAlert type="info" :bordered="false" class="text-12px">
+      区域内文本支持页码变量：<code v-text="'{{page}}'" /> / <code v-text="'{{pageTotal}}'" />，渲染时自动注入。
+      直接把控件拖入色带即可成为子组件。
+    </NAlert>
+  </div>
+</template>
diff --git a/openprint/src/design/preview/PreviewPanel.vue b/openprint/src/design/preview/PreviewPanel.vue
new file mode 100644
index 0000000..84f58ad
--- /dev/null
+++ b/openprint/src/design/preview/PreviewPanel.vue
@@ -0,0 +1,416 @@
+<script setup lang="ts">
+/**
+ * PreviewPanel —— 多页打印预览（Phase 7 验收出口）
+ *
+ * ## 为什么用 iframe 而不是直接挂 DOM
+ *
+ * 渲染产物自带一整套 `@page` / `html,body` / `.op-*` 全局样式，直接注入设计器页面会：
+ * 1. 被设计器的 reset / unocss 规则污染，预览和最终打印对不上（预览就失去意义）
+ * 2. 反过来把 `@page`、`print-color-adjust` 泄漏给设计器，Ctrl+P 时打出画布
+ *
+ * iframe 用 `srcdoc` 装载，同源可访问 contentDocument，
+ * 因此缩放（改 CSS 变量）和翻页（滚动定位）都不必重新渲染 HTML。
+ *
+ * ## 打印一致性
+ *
+ * 打印走 `iframe.contentWindow.print()`，打的就是预览的同一份 DOM 与同一份 CSS，
+ * 从机制上保证「预览 = 打印」，而不是靠两套代码去"对齐"。
+ */
+import { computed, nextTick, ref, watch } from 'vue'
+import {
+  NButton,
+  NPopover,
+  NModal,
+  NSelect,
+  NSpin,
+  NTooltip,
+  useMessage,
+} from 'naive-ui'
+import { render } from '@/core/sdk'
+import type { RenderWarning } from '@/core/layout-engine/types'
+import { mmToPx } from '@/core/units'
+import { builtinFontFaceCss } from '@/core/fonts/loader'
+import { useDataSourceStore } from '@/design/stores/dataSource'
+import { useDesignerStore } from '@/design/stores/designer'
+import { buildPreviewData } from './preview-data'
+
+const props = defineProps<{ show: boolean }>()
+const emit = defineEmits<{ (e: 'update:show', value: boolean): void }>()
+
+const store = useDesignerStore()
+const dsStore = useDataSourceStore()
+const message = useMessage()
+
+const iframeRef = ref<HTMLIFrameElement | null>(null)
+const scrollHostRef = ref<HTMLElement | null>(null)
+
+const html = ref('')
+const rendering = ref(false)
+const errorText = ref('')
+const warnings = ref<RenderWarning[]>([])
+const totalPages = ref(0)
+const currentPage = ref(1)
+const pageWidthMm = ref(210)
+
+const scale = ref(0.5)
+
+const ZOOM_OPTIONS = [
+  { label: '适应宽度', value: 0 },
+  { label: '50%', value: 0.5 },
+  { label: '75%', value: 0.75 },
+  { label: '100%', value: 1 },
+  { label: '125%', value: 1.25 },
+  { label: '150%', value: 1.5 },
+]
+
+const warningCount = computed(() => warnings.value.length)
+
+const WARNING_LABEL: Record<RenderWarning['code'], string> = {
+  BINDING_MISSING: '字段缺失',
+  EXPRESSION_ERROR: '表达式错误',
+  DATASOURCE_NOT_ARRAY: '数据源非数组',
+  DATASOURCE_EMPTY: '数据为空',
+  CONTENT_OVERFLOW: '内容溢出',
+  IMAGE_UNRESOLVED: '图片未解析',
+  BARCODE_FAILED: '条码失败',
+  CHART_FAILED: '图表失败',
+  PAGE_LIMIT_REACHED: '触达页数上限',
+  ROW_TOO_TALL: '行高超页',
+}
+
+/* ------------------------------- 渲染 ------------------------------- */
+
+async function doRender(): Promise<void> {
+  rendering.value = true
+  errorText.value = ''
+  try {
+    const template = store.buildTemplate()
+    const data = buildPreviewData(dsStore.activeFields)
+
+    const res = await render({
+      template,
+      data,
+      output: {
+        screen: true,
+        scale: 1,
+        title: store.templateName,
+        pageDecoration: {
+          backgroundColor: store.pageSetup.backgroundColor ?? '#ffffff',
+          watermark: store.pageSetup.watermark,
+        },
+      },
+    })
+
+    html.value = res.html
+    warnings.value = res.warnings
+    totalPages.value = res.pages
+    pageWidthMm.value = res.result.metrics.pageWidth
+    currentPage.value = 1
+
+    await nextTick()
+    // srcdoc 换了内容要等 load 才能拿到 contentDocument，交给 onIframeLoad 收尾
+  } catch (e) {
+    errorText.value = e instanceof Error ? e.message : String(e)
+    html.value = ''
+    totalPages.value = 0
+  } finally {
+    rendering.value = false
+  }
+}
+
+/* ------------------------------- 缩放 ------------------------------- */
+
+function applyScale(): void {
+  const doc = iframeRef.value?.contentDocument
+  if (!doc) return
+  doc.documentElement.style.setProperty('--op-scale', String(scale.value))
+}
+
+/** 适应宽度：按可视宽度反推缩放比（留 40px 给滚动条与留白） */
+function fitWidth(): void {
+  const host = iframeRef.value
+  if (!host) return
+  const avail = host.clientWidth - 40
+  const pagePx = mmToPx(pageWidthMm.value)
+  if (avail > 0 && pagePx > 0) scale.value = Math.max(0.2, Math.round((avail / pagePx) * 100) / 100)
+}
+
+function onZoomSelect(v: number): void {
+  if (v === 0) fitWidth()
+  else scale.value = v
+}
+
+watch(scale, applyScale)
+
+/* ------------------------------- 翻页 ------------------------------- */
+
+function pageEls(): HTMLElement[] {
+  const doc = iframeRef.value?.contentDocument
+  if (!doc) return []
+  return Array.from(doc.querySelectorAll<HTMLElement>('.op-page-wrap'))
+}
+
+function gotoPage(n: number): void {
+  const target = Math.min(Math.max(1, n), Math.max(1, totalPages.value))
+  const el = pageEls()[target - 1]
+  if (!el) return
+  el.scrollIntoView({ behavior: 'smooth', block: 'start' })
+  currentPage.value = target
+}
+
+function syncCurrentPage(): void {
+  const win = iframeRef.value?.contentWindow
+  if (!win) return
+  const top = win.scrollY + 60
+  const els = pageEls()
+  let idx = 0
+  for (let i = 0; i < els.length; i++) {
+    if (els[i]!.offsetTop <= top) idx = i
+    else break
+  }
+  currentPage.value = idx + 1
+}
+
+function onIframeLoad(): void {
+  applyScale()
+  injectFonts()
+  const win = iframeRef.value?.contentWindow
+  win?.addEventListener('scroll', syncCurrentPage, { passive: true })
+}
+
+/** 向 iframe head 注入内置字体 @font-face（绝对 URL，srcdoc 内可加载同源 /fonts/） */
+function injectFonts(): void {
+  const doc = iframeRef.value?.contentDocument
+  if (!doc || typeof window === 'undefined') return
+  if (doc.getElementById('op-fonts')) return
+  const style = doc.createElement('style')
+  style.id = 'op-fonts'
+  style.textContent = builtinFontFaceCss(window.location.origin)
+  doc.head.appendChild(style)
+}
+
+/* ------------------------------- 打印 ------------------------------- */
+
+function doPrint(): void {
+  const win = iframeRef.value?.contentWindow
+  if (!win) {
+    message.warning('预览尚未就绪')
+    return
+  }
+  // 打印时强制 1:1，否则浏览器会把预览缩放一起打进去
+  const doc = iframeRef.value?.contentDocument
+  doc?.documentElement.style.setProperty('--op-scale', '1')
+  win.focus()
+  win.print()
+  applyScale()
+}
+
+/* ------------------------------- 生命周期 ------------------------------- */
+
+watch(
+  () => props.show,
+  (v) => {
+    if (v) void doRender()
+  },
+)
+
+function close(): void {
+  emit('update:show', false)
+}
+</script>
+
+<template>
+  <NModal
+    :show="props.show"
+    display-directive="if"
+    :mask-closable="false"
+    transform-origin="center"
+    @update:show="emit('update:show', $event)"
+  >
+    <div class="preview-shell">
+      <!-- 工具条 -->
+      <header class="preview-bar">
+        <div class="flex items-center gap-2">
+          <div class="i-carbon-document-preliminary text-16px" />
+          <span class="text-14px font-medium">打印预览</span>
+          <span class="text-12px op-60">{{ store.templateName }}</span>
+        </div>
+
+        <div class="flex items-center gap-2">
+          <!-- 翻页 -->
+          <NButton
+            quaternary
+            size="small"
+            :disabled="currentPage <= 1"
+            @click="gotoPage(currentPage - 1)"
+          >
+            <div class="i-carbon-chevron-up text-14px" />
+          </NButton>
+          <span class="text-12px tabular-nums">
+            第 {{ currentPage }} / {{ totalPages || 1 }} 页
+          </span>
+          <NButton
+            quaternary
+            size="small"
+            :disabled="currentPage >= totalPages"
+            @click="gotoPage(currentPage + 1)"
+          >
+            <div class="i-carbon-chevron-down text-14px" />
+          </NButton>
+
+          <div class="bar-sep" />
+
+          <!-- 缩放 -->
+          <NSelect
+            :value="scale"
+            :options="ZOOM_OPTIONS"
+            size="small"
+            style="width: 108px"
+            :consistent-menu-width="false"
+            @update:value="onZoomSelect"
+          />
+
+          <div class="bar-sep" />
+
+          <!-- 告警 -->
+          <NPopover v-if="warningCount" placement="bottom-end" trigger="click">
+            <template #trigger>
+              <NButton quaternary size="small" type="warning">
+                <div class="i-carbon-warning-alt mr-1 text-14px" />
+                {{ warningCount }} 条告警
+              </NButton>
+            </template>
+            <div class="warn-list">
+              <div v-for="(w, i) in warnings" :key="i" class="warn-item">
+                <span class="warn-code">{{ WARNING_LABEL[w.code] ?? w.code }}</span>
+                <span class="warn-msg">{{ w.message }}</span>
+              </div>
+            </div>
+          </NPopover>
+
+          <NButton size="small" @click="doRender">
+            <div class="i-carbon-renew mr-1 text-14px" />
+            重新渲染
+          </NButton>
+          <NButton size="small" type="primary" :disabled="!totalPages" @click="doPrint">
+            <div class="i-carbon-printer mr-1 text-14px" />
+            打印
+          </NButton>
+          <NButton quaternary size="small" @click="close">
+            <div class="i-carbon-close text-16px" />
+          </NButton>
+        </div>
+      </header>
+
+      <!-- 预览区 -->
+      <div ref="scrollHostRef" class="preview-body">
+        <NSpin :show="rendering" class="h-full">
+          <div v-if="errorText" class="preview-error">
+            <div class="i-carbon-warning-alt mb-2 text-28px" />
+            <div class="text-14px font-medium">渲染失败</div>
+            <div class="mt-1 max-w-560px text-12px op-70">{{ errorText }}</div>
+          </div>
+          <iframe
+            v-else
+            ref="iframeRef"
+            class="preview-frame"
+            title="打印预览"
+            sandbox="allow-same-origin allow-modals"
+            :srcdoc="html"
+            @load="onIframeLoad"
+          />
+        </NSpin>
+      </div>
+    </div>
+  </NModal>
+</template>
+
+<style scoped>
+.preview-shell {
+  display: flex;
+  flex-direction: column;
+  width: 880px;
+  max-width: 94vw;
+  height: 88vh;
+  overflow: hidden;
+  border-radius: 10px;
+  background: var(--brand-surface);
+  box-shadow: 0 20px 60px -10px rgba(0, 0, 0, 0.35);
+}
+
+.preview-bar {
+  display: flex;
+  height: 48px;
+  flex: none;
+  align-items: center;
+  justify-content: space-between;
+  gap: 12px;
+  border-bottom: 1px solid var(--brand-border);
+  padding: 0 12px;
+  color: var(--brand-text-1);
+}
+
+.bar-sep {
+  width: 1px;
+  height: 18px;
+  background: var(--brand-border);
+}
+
+.preview-body {
+  position: relative;
+  min-height: 0;
+  flex: 1;
+  background: var(--brand-bg);
+}
+
+.preview-frame {
+  display: block;
+  width: 100%;
+  height: 100%;
+  border: 0;
+}
+
+.preview-error {
+  display: flex;
+  height: 100%;
+  flex-direction: column;
+  align-items: center;
+  justify-content: center;
+  color: var(--brand-text-2);
+  text-align: center;
+}
+
+.warn-list {
+  display: flex;
+  max-height: 320px;
+  max-width: 460px;
+  flex-direction: column;
+  gap: 6px;
+  overflow: auto;
+}
+
+.warn-item {
+  display: flex;
+  gap: 8px;
+  font-size: 12px;
+  line-height: 1.5;
+}
+
+.warn-code {
+  flex: none;
+  border-radius: 4px;
+  background: rgba(240, 160, 32, 0.16);
+  padding: 0 6px;
+  color: #e08a00;
+}
+
+.warn-msg {
+  color: var(--brand-text-2);
+  word-break: break-all;
+}
+
+:deep(.n-spin-container),
+:deep(.n-spin-content) {
+  height: 100%;
+}
+</style>
diff --git a/openprint/src/design/preview/preview-data.spec.ts b/openprint/src/design/preview/preview-data.spec.ts
new file mode 100644
index 0000000..221edd5
--- /dev/null
+++ b/openprint/src/design/preview/preview-data.spec.ts
@@ -0,0 +1,48 @@
+import { describe, expect, it } from 'vitest'
+
+import type { FieldDef } from '@/types/datasource'
+import { buildPreviewData } from '@/design/preview/preview-data'
+
+const FIELDS: FieldDef[] = [
+  { path: 'order.orderNo', label: '单号', type: 'string', sample: 'SO-001' },
+  { path: 'customer.name', label: '客户', type: 'string', sample: '客户甲' },
+  { path: 'items[].productCode', label: '编码', type: 'string', sample: 'P001' },
+  { path: 'items[].productName', label: '名称', type: 'string', sample: '商品' },
+  { path: 'items[].qty', label: '数量', type: 'number', sample: 5 },
+  { path: 'items[].price', label: '单价', type: 'number', sample: 10 },
+  { path: 'items[].amount', label: '金额', type: 'number', sample: 50 },
+]
+
+describe('buildPreviewData —— 预览数据合成', () => {
+  it('按 rows 展开明细数组', () => {
+    const data = buildPreviewData(FIELDS, { rows: 3 })
+    expect(Array.isArray(data.items)).toBe(true)
+    expect((data.items as unknown[]).length).toBe(3)
+  })
+
+  it('金额自洽：amount = qty × price', () => {
+    const data = buildPreviewData(FIELDS, { rows: 5 })
+    const items = data.items as Array<Record<string, number>>
+    for (const row of items) {
+      expect(Number(row.amount)).toBeCloseTo(Number(row.qty) * Number(row.price), 2)
+    }
+  })
+
+  it('编码类字段按行号变化，肉眼可辨分页边界', () => {
+    const data = buildPreviewData(FIELDS, { rows: 3 })
+    const items = data.items as Array<Record<string, string>>
+    expect(items[0]!.productCode).toContain('001')
+    expect(items[1]!.productCode).toContain('002')
+    expect(items[2]!.productCode).toContain('003')
+  })
+
+  it('顶层字段按 path 嵌套写入', () => {
+    const data = buildPreviewData(FIELDS, { rows: 1 })
+    expect((data.order as Record<string, unknown>).orderNo).toBe('SO-001')
+    expect((data.customer as Record<string, unknown>).name).toBe('客户甲')
+  })
+
+  it('字段为空返回 {}', () => {
+    expect(buildPreviewData([], { rows: 3 })).toEqual({})
+  })
+})
diff --git a/openprint/src/design/preview/preview-data.ts b/openprint/src/design/preview/preview-data.ts
new file mode 100644
index 0000000..2cd0517
--- /dev/null
+++ b/openprint/src/design/preview/preview-data.ts
@@ -0,0 +1,110 @@
+/**
+ * 预览数据构造 —— 用数据源字段的 `sample` 值合成一份可预览的业务数据
+ *
+ * 为什么不直接写死 SALES_ORDER_SAMPLE：
+ * 换成后端数据源（createDataSourceHttp）后字段清单是动态的，写死样例就废了。
+ * FieldDef.sample 是协议里既有的约定，按它反推数据结构才能对任意数据源通用。
+ *
+ * 明细字段路径形如 `items[].qty`，这里会展开成 `items: [{qty}, {qty}, …]`，
+ * 行数由调用方指定 —— 把行数调大就能验证分页（这也是预览面板"明细行数"输入框的用途）。
+ */
+import type { FieldDef } from '@/types/datasource'
+
+/** 序号类字段：值直接用行号，方便肉眼核对分页边界 */
+const SEQ_RE = /^(seq|index|no|rowno|序号)$/i
+/** 编码类字段：拼上行号，让每行看起来不一样 */
+const CODE_RE = /(code|no|sn|编码|编号|单号)$/i
+
+function setPath(target: Record<string, unknown>, path: string, value: unknown): void {
+  const keys = path.split('.').filter(Boolean)
+  let cur = target
+  for (let i = 0; i < keys.length - 1; i++) {
+    const k = keys[i]!
+    const next = cur[k]
+    if (next === null || typeof next !== 'object' || Array.isArray(next)) {
+      cur[k] = {}
+    }
+    cur = cur[k] as Record<string, unknown>
+  }
+  const last = keys.at(-1)
+  if (last) cur[last] = value
+}
+
+function pad(n: number, width = 3): string {
+  return String(n).padStart(width, '0')
+}
+
+/** 按行号给样例值加变化，避免整张表每行完全一样看不出分页 */
+function varyValue(field: FieldDef, leaf: string, rowIndex: number): unknown {
+  const sample = field.sample
+
+  if (SEQ_RE.test(leaf)) return rowIndex + 1
+
+  if (typeof sample === 'number') {
+    // 在样例值上下浮动 ±20%，保留两位；整数字段仍返回整数
+    const factor = 1 + ((rowIndex % 5) - 2) * 0.1
+    const v = sample * factor
+    return Number.isInteger(sample) ? Math.max(1, Math.round(v)) : Math.round(v * 100) / 100
+  }
+
+  if (typeof sample === 'boolean') return rowIndex % 2 === 0
+  if (sample === null || sample === undefined || sample === '') return ''
+
+  const text = String(sample)
+  if (CODE_RE.test(leaf)) return `${text}-${pad(rowIndex + 1)}`
+  return text
+}
+
+export interface PreviewDataOptions {
+  /** 明细数组行数（默认 30，足以在 A4 上撑出多页） */
+  rows?: number
+}
+
+/**
+ * 字段清单 → 预览数据对象。
+ * 字段为空时返回 `{}`，渲染器会给出 DATASOURCE_EMPTY 告警而不是静默出空白页。
+ */
+export function buildPreviewData(
+  fields: FieldDef[],
+  options: PreviewDataOptions = {},
+): Record<string, unknown> {
+  const rowCount = Math.max(0, Math.floor(options.rows ?? 30))
+  const data: Record<string, unknown> = {}
+
+  /** 数组路径 → 该数组下的叶子字段 */
+  const arrays = new Map<string, Array<{ leaf: string; field: FieldDef }>>()
+
+  for (const field of fields) {
+    if (field.hidden) continue
+    const marker = field.path.indexOf('[]')
+    if (marker < 0) {
+      setPath(data, field.path, field.sample ?? '')
+      continue
+    }
+    const arrayPath = field.path.slice(0, marker)
+    // `items[].qty` → leaf 'qty'；`items[]` 自身（无叶子）跳过
+    const leaf = field.path.slice(marker + 2).replace(/^\./, '')
+    if (!leaf) continue
+    const list = arrays.get(arrayPath)
+    if (list) list.push({ leaf, field })
+    else arrays.set(arrayPath, [{ leaf, field }])
+  }
+
+  for (const [arrayPath, leaves] of arrays) {
+    const rows: Array<Record<string, unknown>> = []
+    for (let i = 0; i < rowCount; i++) {
+      const row: Record<string, unknown> = {}
+      for (const { leaf, field } of leaves) setPath(row, leaf, varyValue(field, leaf, i))
+      // 金额 = 数量 × 单价：让合计行的数字自洽，否则一眼假
+      const qty = row.qty
+      const price = row.price
+      if (typeof qty === 'number' && typeof price === 'number' && 'amount' in row) {
+        row.amount = Math.round(qty * price * 100) / 100
+      }
+      rows.push(row)
+    }
+    setPath(data, arrayPath, rows)
+  }
+
+  return data
+}
diff --git a/openprint/src/design/stores/dataSource.ts b/openprint/src/design/stores/dataSource.ts
new file mode 100644
index 0000000..d8a960f
--- /dev/null
+++ b/openprint/src/design/stores/dataSource.ts
@@ -0,0 +1,113 @@
+/**
+ * dataSource store —— 字段缓存 + 手动刷新（§19.4.3a 第六节）
+ *
+ * 设计器加载时拉一次字段并缓存（TTL 10 分钟），用户可手动刷新。
+ * 未注入真实 DataSourceRepository 时自动回退到 createMockDataSource（开箱即用）。
+ */
+import { defineStore } from 'pinia'
+import { computed, ref, shallowRef } from 'vue'
+import type { DataSourceRepository, DataSourceMeta, FieldDef, TableMeta } from '@/types/datasource'
+import { createMockDataSource } from '@/repository/mock/mock-datasource'
+
+const CACHE_TTL = 10 * 60 * 1000 // 10 分钟
+
+interface CacheEntry {
+  fields: FieldDef[]
+  fetchedAt: number
+}
+
+export const useDataSourceStore = defineStore('dataSource', () => {
+  const _repo = shallowRef<DataSourceRepository>(createMockDataSource())
+  const sources = ref<DataSourceMeta[]>([])
+  const activeSourceId = ref<string>('sale_order') // 当前选中数据源
+  const fieldCache = ref<Map<string, CacheEntry>>(new Map())
+  const loading = ref(false)
+
+  const activeSource = computed(() => sources.value.find((s) => s.id === activeSourceId.value) ?? null)
+  const activeFields = computed(() => fieldCache.value.get(activeSourceId.value)?.fields ?? [])
+  /** 按 tableId+group 分组后的树形字段（DataSourceTree 渲染用） */
+  const fieldTree = computed(() => {
+    const fields = activeFields.value.filter((f) => !f.hidden)
+    const tables = activeSource.value?.tables ?? []
+    const byTable: Record<string, FieldDef[]> = {}
+    for (const t of tables) byTable[t.id] = []
+    for (const f of fields) {
+      const tid = f.tableId ?? ''
+      ;(byTable[tid] ??= []).push(f)
+    }
+    return tables.map((t) => ({
+      table: t,
+      fields: (byTable[t.id] ?? []).sort((a, b) => (a.sort ?? 0) - (b.sort ?? 0)),
+    }))
+  })
+
+  /** 扁平字段列表（供 BindingEditor 下拉） */
+  const flatFields = computed(() =>
+    activeFields.value
+      .filter((f) => !f.hidden)
+      .sort((a, b) => (a.sort ?? 0) - (b.sort ?? 0))
+  )
+
+  /* ---------- 操作 ---------- */
+
+  /** 注入后端仓库（Phase 6：createDataSourceHttp）；不传则保持 Mock */
+  function setRepository(repo: DataSourceRepository): void {
+    _repo.value = repo
+    fieldCache.value.clear()
+  }
+
+  async function fetchSources(): Promise<void> {
+    sources.value = await _repo.value.listSources()
+    if (!sources.value.find((s) => s.id === activeSourceId.value)) {
+      activeSourceId.value = sources.value[0]?.id ?? ''
+    }
+  }
+
+  async function fetchFields(forceRefresh = false): Promise<void> {
+    const id = activeSourceId.value
+    if (!id) return
+    const cached = fieldCache.value.get(id)
+    const fresh = cached && Date.now() - cached.fetchedAt < CACHE_TTL
+    if (fresh && !forceRefresh) return
+
+    loading.value = true
+    try {
+      const fields = await _repo.value.getFields(id)
+      fieldCache.value.set(id, { fields, fetchedAt: Date.now() })
+    } finally {
+      loading.value = false
+    }
+  }
+
+  /** 初始化：拉数据源列表 + 默认源字段（canvas 挂载时调用） */
+  async function init(): Promise<void> {
+    await fetchSources()
+    await fetchFields()
+  }
+
+  /** 用户手动刷新 */
+  async function refreshFields(): Promise<void> {
+    await fetchFields(true)
+  }
+
+  function selectSource(id: string): void {
+    activeSourceId.value = id
+    void fetchFields()
+  }
+
+  return {
+    sources,
+    activeSourceId,
+    activeSource,
+    activeFields,
+    fieldTree,
+    flatFields,
+    loading,
+    setRepository,
+    init,
+    fetchSources,
+    fetchFields,
+    refreshFields,
+    selectSource,
+  }
+})
diff --git a/openprint/src/design/stores/designer.ts b/openprint/src/design/stores/designer.ts
new file mode 100644
index 0000000..14a3a5e
--- /dev/null
+++ b/openprint/src/design/stores/designer.ts
@@ -0,0 +1,885 @@
+/**
+ * designer store —— 当前模板 / 选中控件 / 画布状态（《实施指南》Phase 4 先行版）
+ *
+ * 数据流：
+ * - 画布交互（拖拽/缩放手柄）→ CanvasDesigner 事件 → 更新本 store 的模型
+ * - 属性面板编辑 → 本 store 更新模型 → 同步回 CanvasDesigner
+ * - 模型坐标单位 = mm（协议层），画布层 px 换算由 CanvasDesigner 负责
+ */
+import { defineStore } from 'pinia'
+import { computed, ref, shallowRef } from 'vue'
+import type {
+  AnyControl,
+  ControlType,
+  RectControl,
+  TableColumn,
+  TableControl,
+  ZoneControl,
+} from '@/types/control'
+import type { GridConfig, PageSetup, TemplateData, WatermarkConfig } from '@/types/template'
+import { CanvasDesigner, type ViewportState } from '@/design/canvas/CanvasDesigner'
+import { createLocalRepository } from '@/repository/local-repo'
+import type { TemplateRepository } from '@/repository/types'
+import { assertTemplate } from '@/core/spec/validator'
+import { genId } from '@/utils/id'
+import { useHistoryStore } from './history'
+import { type ImportColumn } from '@/design/utils/data-import'
+import { seedSummaryTail } from '@/core/layout-engine/table-cells'
+
+/** 水印默认配置（开启后居中单个、45°、浅灰） */
+export const DEFAULT_WATERMARK: WatermarkConfig = {
+  enabled: false,
+  text: 'OpenPrint',
+  color: '#cccccc',
+  fontSize: 16,
+  rotation: 45,
+  tile: false,
+}
+
+/** A4 纵向默认页面（§5.13 预设只活在 UI，协议存精确数字） */
+const DEFAULT_PAGE: PageSetup = {
+  width: 210,
+  height: 297,
+  unit: 'mm',
+  orientation: 'portrait',
+  margin: { top: 10, bottom: 10, left: 10, right: 10 },
+  backgroundColor: '#ffffff',
+  watermark: { ...DEFAULT_WATERMARK },
+}
+
+/** 画布网格默认配置（运行时视图状态，辅助设计，不持久化） */
+const DEFAULT_GRID: GridConfig = { visible: false, sizeMm: 5, color: '#78829180' }
+
+export const useDesignerStore = defineStore('designer', () => {
+  /* ------------------------------- 状态 ------------------------------- */
+  const templateName = ref('销售出库单模板')
+  const pageSetup = ref<PageSetup>({ ...DEFAULT_PAGE })
+  /** body 区控件模型（zone 子控件在 zones[].children 内） */
+  const controls = ref<AnyControl[]>([])
+  const zones = ref<ZoneControl[]>([])
+  const selectedIds = ref<string[]>([])
+  const dirty = ref(false)
+  const lastSavedAt = ref<string | null>(null)
+
+  /** 手动分页下限：物理页数至少为 N（0 = 完全由内容推导；随模板持久化） */
+  const minPages = ref(0)
+  /** 当前有效物理页数（由画布推导后同步，右侧页面面板展示/导航用） */
+  const pageCount = ref(1)
+  /** 当前查看的页码（0 起，页码导航 chips 高亮用） */
+  const activePage = ref(0)
+
+  /** 画布内核（非响应式，避免深度代理 Fabric 对象） */
+  const designer = shallowRef<CanvasDesigner | null>(null)
+  const viewport = ref<ViewportState>({ zoom: 1, offsetX: 0, offsetY: 0 })
+
+  /**
+   * 模板仓库：未配置后端时默认 localStorage（主任 2026-08-08 定：
+   * 一切编辑纯本地，仅手动保存才持久化；后端 http-repo 经 setRepository 注入）。
+   */
+  const repository = shallowRef<TemplateRepository>(createLocalRepository())
+  /** 当前模板在仓库中的 id（未保存过 = null） */
+  const currentTemplateId = ref<string | null>(null)
+  /** 持久化模式：local=本地存储 / cloud=云端（顶栏徽标 + 保存提示用） */
+  const backendMode = ref<'local' | 'cloud'>('local')
+  /** 画布网格配置（运行时视图状态，辅助设计，不持久化） */
+  const gridConfig = ref<GridConfig>({ ...DEFAULT_GRID })
+
+  /**
+   * 当前正在双击编辑的单元格（方案 A：HTML overlay 原生 contenteditable 编辑）。
+   * 为 null 时表示无编辑。
+   */
+  const editingCell = ref<{ controlId: string; row: number; col: number } | null>(null)
+  /** 画布变换版本号：Fabric 对象移动/缩放/旋转或视口变化时自增，驱动 overlay 重算定位 */
+  const canvasTick = ref(0)
+
+  function openCellEditor(controlId: string, row: number, col: number): void {
+    editingCell.value = { controlId, row, col }
+  }
+  function closeCellEditor(): void {
+    editingCell.value = null
+  }
+  function bumpCanvasTick(): void {
+    canvasTick.value++
+  }
+
+  /* ------------------------------ computed ----------------------------- */
+  const selectedControl = computed<AnyControl | null>(() => {
+    const id = selectedIds.value[0]
+    if (!id) return null
+    return findControl(id) ?? null
+  })
+
+  const saveStateText = computed(() =>
+    dirty.value ? '未保存' : lastSavedAt.value ? `已保存 ${lastSavedAt.value}` : '已保存',
+  )
+
+  /* ------------------------------- 查找 -------------------------------- */
+
+  function findControl(id: string): AnyControl | undefined {
+    const inBody = controls.value.find((c) => c.id === id)
+    if (inBody) return inBody
+    for (const z of zones.value) {
+      if (z.id === id) return z
+      const child = z.children.find((c) => c.id === id)
+      if (child) return child
+    }
+    return undefined
+  }
+
+  function replaceControl(updated: AnyControl): void {
+    const i = controls.value.findIndex((c) => c.id === updated.id)
+    if (i >= 0) {
+      controls.value[i] = updated
+      return
+    }
+    for (const z of zones.value) {
+      if (z.id === updated.id && updated.type === 'zone') {
+        const zi = zones.value.findIndex((x) => x.id === z.id)
+        zones.value[zi] = updated as ZoneControl
+        return
+      }
+      const ci = z.children.findIndex((c) => c.id === updated.id)
+      if (ci >= 0) {
+        z.children[ci] = updated
+        return
+      }
+    }
+  }
+
+  /* ----------------------------- 画布挂载 ------------------------------ */
+
+  function attachCanvas(el: HTMLCanvasElement, container: HTMLElement): void {
+    const d = new CanvasDesigner()
+    d.init(el, container, {
+      onSelectionChange: (ids) => {
+        selectedIds.value = ids
+        // 选中切走 → 退出单元格编辑，避免 overlay 抢走画布指针
+        if (editingCell.value && !ids.includes(editingCell.value.controlId)) closeCellEditor()
+      },
+      onObjectModified: (newControl) => {
+        const old = findControl(newControl.id)
+        replaceControl(newControl)
+        if (old) {
+          const history = useHistoryStore()
+          history.push({
+            undo: () => {
+              replaceControl(old)
+              designer.value?.updateControl(old)
+            },
+            redo: () => {
+              replaceControl(newControl)
+              designer.value?.updateControl(newControl)
+            },
+            description: `移动/缩放 ${newControl.type}`,
+          })
+        }
+        dirty.value = true
+      },
+      onViewportChange: (vp) => {
+        viewport.value = vp
+      },
+      onTransformTick: () => {
+        canvasTick.value++
+      },
+      onPageCountChange: (count) => {
+        pageCount.value = count
+        if (activePage.value >= count) activePage.value = Math.max(0, count - 1)
+      },
+      onCellEdit: (info) => {
+        // 物化 cells 网格（旧模板首次编辑时自动迁移）：派生数据，不入撤销栈、不标脏
+        updateControlSilent(info.controlId, info.control as AnyControl)
+        openCellEditor(info.controlId, info.row, info.col)
+      },
+    })
+    d.setPage(pageSetup.value)
+    designer.value = d
+    viewport.value = d.getViewportState()
+    pageCount.value = d.effectivePageCount
+    d.setPageBackground(pageSetup.value.backgroundColor ?? '#ffffff')
+    d.setWatermark(pageSetup.value.watermark)
+  }
+
+  function detachCanvas(): void {
+    designer.value?.dispose()
+    designer.value = null
+  }
+
+  /* ----------------------------- 控件操作 ------------------------------ */
+
+  /** 从控件库拖入：在给定位置（相对内容区 mm）创建控件；init 允许控件库注入额外初始属性（如圆形 shape） */
+  function addControlOfType(
+    type: ControlType,
+    at: { leftMm: number; topMm: number },
+    init?: Partial<AnyControl>,
+    zoneHostId?: string,
+  ): void {
+    const base = createDefaultControl(type, at)
+    if (!base) return
+    const control = init ? ({ ...base, ...init } as AnyControl) : base
+    // 圆形默认正圆：确保外接框为正方形（宽=高），避免默认矩形尺寸导致椭圆
+    if (control.type === 'rect' && (control as RectControl).shape === 'circle') {
+      const r = control as RectControl
+      if (r.width !== r.height) {
+        const size = Math.max(r.width, r.height)
+        r.width = size
+        r.height = size
+      }
+    }
+    if (control.type === 'zone') {
+      // 拖入页眉/页脚区域控件本身
+      if (zones.value.some((z) => z.zone === control.zone)) {
+        selectControl(zones.value.find((z) => z.zone === control.zone)!.id)
+        return
+      }
+      zones.value.push(control)
+      designer.value?.addControl(control)
+    } else if (zoneHostId) {
+      // 拖入页眉/页脚区域内的子控件
+      const host = zones.value.find((z) => z.id === zoneHostId)
+      if (host) {
+        host.children.push(control)
+        designer.value?.addControl(control, { zoneHostId })
+      } else {
+        // zone 已不存在，降级到 body
+        controls.value.push(control)
+        designer.value?.addControl(control)
+      }
+    } else {
+      controls.value.push(control)
+      designer.value?.addControl(control)
+    }
+    // 撤销 = 删除此控件
+    const history = useHistoryStore()
+    const createdId = control.id
+    const hostId = zoneHostId
+    history.push({
+      undo: () => removeControl(createdId),
+      redo: () => {
+        const c = findControl(createdId) ?? control
+        if (!findControl(createdId)) {
+          if (c.type === 'zone') zones.value.push(c as ZoneControl)
+          else if (hostId) {
+            const host = zones.value.find((z) => z.id === hostId)
+            host?.children.push(c)
+          } else controls.value.push(c)
+        }
+        designer.value?.addControl(c, { zoneHostId: hostId })
+      },
+      description: `添加 ${control.type}`,
+    })
+    dirty.value = true
+  }
+
+  /**
+   * 导入数据 → 在画布生成一张「内嵌数据表格」。
+   *
+   * 表格以 `control.data` 携带解析后的记录行（与 dataSource 字段绑定彻底解耦），
+   * 渲染期由引擎自动分页（flow table）。表格按内容区宽度自适应居中、表头重复、整表边框。
+   * 行/列的去留与标题改名已在导入弹窗中确定，这里只负责落地成控件。
+   */
+  function importTable(payload: {
+    columns: ImportColumn[]
+    records: Array<Record<string, unknown>>
+    sourceName?: string
+  }): void {
+    const ps = pageSetup.value
+    const m = ps.margin
+    const contentWidth = Math.max(40, Math.round((ps.width - m.left - m.right) * 10) / 10)
+    const left = Math.round(m.left * 10) / 10
+    const top = Math.round(m.top * 10) / 10
+    const n = Math.max(1, payload.columns.length)
+    const colWidth = Math.round((contentWidth / n) * 10) / 10
+
+    const id = genId()
+    const columns: TableColumn[] = payload.columns.map((c) => ({
+      title: c.title || c.key,
+      // 内嵌数据行经 resolveRows 落入 ctx.row，列 field 用 items[]. 前缀即可逐行取值
+      field: `items[].${c.key}`,
+      width: colWidth,
+      headerAlign: 'center',
+    }))
+    const control: TableControl = {
+      id,
+      type: 'table',
+      left,
+      top,
+      width: contentWidth,
+      height: 60,
+      printable: true,
+      columns,
+      headerRows: 1,
+      data: payload.records,
+      options: {
+        repeatHeader: true,
+        repeatFooter: true,
+        pageRows: 'auto',
+        borders: 'all',
+        verticalAlign: 'middle',
+        // 默认单元格居中（与初始化表格一致）
+        defaultCellStyle: { align: 'center' },
+      },
+    }
+
+    // 植入「本页合计 / 总计 / 大写金额」尾行：按首行采样推断数值列，金额取最后一个数值列
+    const sample = payload.records[0] ?? {}
+    const numericColumns = payload.columns
+      .map((c, i) => (typeof sample[c.key] === 'number' ? i : -1))
+      .filter((i) => i >= 0)
+    const moneyColumn =
+      numericColumns.find((i) => /金额|总额|合计|钱|amt|total|amount|price|sum/i.test(payload.columns[i]!.key)) ??
+      numericColumns[numericColumns.length - 1]
+    const tableControl = seedSummaryTail(control, { numericColumns, moneyColumn })
+    controls.value.push(tableControl)
+    designer.value?.addControl(tableControl)
+    const history = useHistoryStore()
+    history.push({
+      undo: () => removeControl(id),
+      redo: () => {
+        if (!findControl(id)) {
+          controls.value.push(tableControl)
+          designer.value?.addControl(tableControl)
+        }
+      },
+      description: `导入数据表（${payload.sourceName ?? '数据'}）`,
+    })
+    dirty.value = true
+    selectControl(id)
+  }
+
+  /** 插入页眉/页脚区域控件（§5.14：单例，重复点击聚焦已有色带） */
+  function addZone(zone: 'header' | 'footer'): void {
+    const existing = zones.value.find((z) => z.zone === zone)
+    if (existing) {
+      selectControl(existing.id)
+      return
+    }
+    const control: ZoneControl = {
+      id: genId('zone'),
+      type: 'zone',
+      zone,
+      left: 0,
+      top: 0,
+      width: pageSetup.value.width,
+      height: zone === 'header' ? 20 : 14,
+      zoneHeight: zone === 'header' ? 20 : 14,
+      repeat: true,
+      printable: true,
+      children: [],
+    }
+    zones.value.push(control)
+    designer.value?.addControl(control)
+    // 撤销 = 删除 zone
+    const history = useHistoryStore()
+    const zoneId = control.id
+    history.push({
+      undo: () => removeControl(zoneId),
+      redo: () => {
+        if (!zones.value.some((z) => z.id === zoneId)) zones.value.push(control)
+        designer.value?.addControl(control)
+      },
+      description: `添加${zone === 'header' ? '页眉' : '页脚'}`,
+    })
+    dirty.value = true
+  }
+
+  /** 属性面板编辑：更新模型并同步画布 */
+  function updateControl(id: string, patch: Partial<AnyControl>): void {
+    const current = findControl(id)
+    if (!current) return
+    const old = JSON.parse(JSON.stringify(current)) as AnyControl // 深拷贝旧状态
+    const merged = { ...current, ...patch, id: current.id, type: current.type } as AnyControl
+    replaceControl(merged)
+    designer.value?.updateControl(merged)
+    const history = useHistoryStore()
+    history.push({
+      undo: () => {
+        replaceControl(old)
+        designer.value?.updateControl(old)
+        if (selectedIds.value.includes(id)) selectedIds.value = [id]
+      },
+      redo: () => {
+        replaceControl(merged)
+        designer.value?.updateControl(merged)
+      },
+      description: `编辑 ${current.type}`,
+    })
+    dirty.value = true
+  }
+
+  /**
+   * 静默更新：只同步模型与画布，**不入撤销栈、不标脏**。
+   * 仅用于派生数据物化（如首次双击表格时把列配置展开成 cells 网格），
+   * 用户可感知的编辑一律走 updateControl。
+   */
+  function updateControlSilent(id: string, patch: Partial<AnyControl>): void {
+    const current = findControl(id)
+    if (!current) return
+    const merged = { ...current, ...patch, id: current.id, type: current.type } as AnyControl
+    replaceControl(merged)
+    designer.value?.updateControl(merged)
+  }
+
+  function removeControl(id: string): void {
+    const current = findControl(id)
+    if (!current) return
+    if (editingCell.value?.controlId === id) closeCellEditor()
+    const old = JSON.parse(JSON.stringify(current)) as AnyControl
+    let zoneHostId: string | undefined
+    const i = controls.value.findIndex((c) => c.id === id)
+    if (i >= 0) controls.value.splice(i, 1)
+    else {
+      for (const z of zones.value) {
+        const ci = z.children.findIndex((c) => c.id === id)
+        if (ci >= 0) { zoneHostId = z.id; z.children.splice(ci, 1); break }
+      }
+      const zi = zones.value.findIndex((z) => z.id === id)
+      if (zi >= 0) zones.value.splice(zi, 1)
+    }
+    designer.value?.removeControl(id)
+    if (selectedIds.value.includes(id)) selectedIds.value = []
+    const history = useHistoryStore()
+    // 撤销 = 重新添加（含 zone 宿主归属）
+    const hostId = zoneHostId
+    history.push({
+      undo: () => {
+        if (old.type === 'zone') zones.value.push(old as ZoneControl)
+        else controls.value.push(old)
+        designer.value?.addControl(old, { zoneHostId: hostId })
+      },
+      redo: () => {
+        const idx = controls.value.findIndex((c) => c.id === id)
+        if (idx >= 0) controls.value.splice(idx, 1)
+        designer.value?.removeControl(id)
+      },
+      description: `删除 ${current.type}`,
+    })
+    dirty.value = true
+  }
+
+  function selectControl(id: string | null): void {
+    selectedIds.value = id ? [id] : []
+    designer.value?.setActiveControl(id)
+  }
+
+  /* ----------------------------- 保存/加载 ----------------------------- */
+
+  /** 从画布序列化出完整 template.json（协议结构） */
+  function buildTemplate(): TemplateData<AnyControl> {
+    const synced = designer.value?.serialize()
+    if (synced) {
+      controls.value = synced.body
+      zones.value = synced.zones
+    }
+    const sections: TemplateData<AnyControl>['document']['sections'] = []
+    const header = zones.value.find((z) => z.zone === 'header')
+    const footer = zones.value.find((z) => z.zone === 'footer')
+    if (header) {
+      sections.push({
+        type: 'header',
+        height: header.zoneHeight,
+        repeat: header.repeat ?? true,
+        components: header.children,
+      })
+    }
+    sections.push({ type: 'body', components: controls.value })
+    if (footer) {
+      sections.push({
+        type: 'footer',
+        height: footer.zoneHeight,
+        repeat: footer.repeat ?? true,
+        components: footer.children,
+      })
+    }
+    return {
+      version: '1.0',
+      document: {
+        type: 'report',
+        page: { ...pageSetup.value, minPages: minPages.value || undefined },
+        sections,
+      },
+    }
+  }
+
+  function markSaved(): void {
+    dirty.value = false
+    lastSavedAt.value = new Date().toLocaleTimeString('zh-CN', { hour12: false })
+  }
+
+  /** 注入后端仓库（Phase 6：createHttpRepository）；mode 标记持久化模式（默认 cloud） */
+  function setRepository(repo: TemplateRepository, mode: 'local' | 'cloud' = 'cloud'): void {
+    repository.value = repo
+    backendMode.value = mode
+  }
+
+  /** 设置画布网格（开关 / 间距）。仅运行时视图状态，应用到 SmartGuides；不标记 dirty、不持久化 */
+  function setGrid(patch: Partial<GridConfig>): void {
+    const next = { ...gridConfig.value, ...patch }
+    if (next.sizeMm <= 0) next.sizeMm = DEFAULT_GRID.sizeMm
+    gridConfig.value = next
+    const d = designer.value
+    if (d) {
+      d.setGridVisible(next.visible)
+      d.setGridSize(next.sizeMm)
+      d.setGridColor(next.color)
+    }
+  }
+
+  /**
+   * 应用页面装饰（背景色 + 水印）到画布，并标记 dirty（随模板持久化）。
+   * 右栏「页面外观」各组控件改完即调此方法即时预览。
+   */
+  function applyPageDecoration(): void {
+    const d = designer.value
+    if (d) {
+      d.setPageBackground(pageSetup.value.backgroundColor ?? '#ffffff')
+      d.setWatermark(pageSetup.value.watermark)
+    }
+    dirty.value = true
+  }
+
+  /* ----------------------------- 手动分页 ----------------------------- */
+
+  /** 设置手动分页下限（floor，最小 0）并同步画布 */
+  function setMinPages(n: number): void {
+    const v = Math.max(0, Math.floor(Number.isFinite(n) ? n : 0) || 0)
+    minPages.value = v
+    designer.value?.setManualPageCount(v)
+  }
+
+  /** 加一页：物理页数 +1（minPages = max(内容推导, 当前下限) + 1） */
+  function addPage(): void {
+    const d = designer.value
+    const content = d?.contentPageCount ?? 1
+    setMinPages(Math.max(minPages.value, content) + 1)
+  }
+
+  /** 减一页：手动下限 -1（内容推导页数仍会兜底，不会少于内容所需页数） */
+  function removePage(): void {
+    setMinPages(Math.max(0, minPages.value - 1))
+  }
+
+  /** 跳转到第 index 页（0 起）：滚动画布视口并把页码高亮 */
+  function goToPage(index: number): void {
+    const i = Math.max(0, Math.min(index, pageCount.value - 1))
+    activePage.value = i
+    designer.value?.scrollToPage(i)
+  }
+
+  /** 新建空白模板：清空画布与模型，currentTemplateId 归零（保存时走 create） */
+  function newBlankTemplate(): void {
+    closeCellEditor()
+    currentTemplateId.value = null
+    templateName.value = '未命名模板'
+    pageSetup.value = { ...DEFAULT_PAGE }
+    gridConfig.value = { ...DEFAULT_GRID }
+    controls.value = []
+    zones.value = []
+    selectedIds.value = []
+    minPages.value = 0
+    pageCount.value = 1
+    activePage.value = 0
+    designer.value?.clearControls()
+    designer.value?.setGridVisible(false)
+    designer.value?.setGridSize(DEFAULT_GRID.sizeMm)
+    designer.value?.setGridColor(DEFAULT_GRID.color)
+    designer.value?.setPage(pageSetup.value)
+    designer.value?.setManualPageCount(0)
+    designer.value?.setPageBackground(pageSetup.value.backgroundColor ?? '#ffffff')
+    designer.value?.setWatermark(pageSetup.value.watermark)
+    useHistoryStore().clear()
+    dirty.value = false
+    lastSavedAt.value = null
+  }
+
+  /** 另存为：以新名称创建一份新模板（不清空当前画布，仅复制持久化） */
+  async function saveTemplateAs(name: string): Promise<{ ok: boolean; error?: string }> {
+    templateName.value = name
+    currentTemplateId.value = null
+    return saveTemplate()
+  }
+
+  /**
+   * 手动保存：序列化 → 协议校验 → 写入仓库（唯一会触发持久化的入口）。
+   * 已保存过 = update，首次 = create。
+   */
+  async function saveTemplate(): Promise<{ ok: boolean; error?: string }> {
+    try {
+      if (!templateName.value.trim()) templateName.value = '未命名模板'
+      const template = buildTemplate()
+      assertTemplate(template)
+      if (currentTemplateId.value) {
+        await repository.value.update(currentTemplateId.value, {
+          name: templateName.value,
+          data: template,
+        })
+      } else {
+        const record = await repository.value.create({
+          name: templateName.value,
+          editable: true,
+          deletable: true,
+          data: template,
+        })
+        currentTemplateId.value = record.id
+      }
+      markSaved()
+      return { ok: true }
+    } catch (err) {
+      return { ok: false, error: err instanceof Error ? err.message : String(err) }
+    }
+  }
+
+  /** 加载模板到画布（启动恢复 / 打开模板共用） */
+  function loadTemplate(record: { id: string; name: string; data: TemplateData<AnyControl> }): void {
+    const d = designer.value
+    if (!d) return
+    assertTemplate(record.data)
+    closeCellEditor()
+    const doc = record.data.document
+
+    currentTemplateId.value = record.id
+    templateName.value = record.name
+    // 保留默认背景/水印，旧模板缺字段时自动回退
+    pageSetup.value = {
+      ...DEFAULT_PAGE,
+      ...doc.page,
+      backgroundColor: doc.page.backgroundColor ?? DEFAULT_PAGE.backgroundColor,
+      watermark: doc.page.watermark ?? { ...DEFAULT_WATERMARK },
+    }
+    minPages.value = doc.page.minPages ?? 0
+    d.setPage(doc.page)
+    d.setManualPageCount(minPages.value)
+    d.setPageBackground(pageSetup.value.backgroundColor ?? '#ffffff')
+    d.setWatermark(pageSetup.value.watermark)
+    d.clearControls()
+    pageCount.value = d.effectivePageCount
+    activePage.value = 0
+
+    zones.value = []
+    controls.value = []
+
+    // 先建 zone（子控件需要宿主坐标）
+    for (const section of doc.sections) {
+      if (section.type === 'header' || section.type === 'footer') {
+        const zone: ZoneControl = {
+          id: genId('zone'),
+          type: 'zone',
+          zone: section.type,
+          left: 0,
+          top: 0,
+          width: doc.page.width,
+          height: section.height ?? 20,
+          zoneHeight: section.height ?? 20,
+          repeat: section.repeat ?? true,
+          printable: true,
+          children: [],
+        }
+        zones.value.push(zone)
+        d.addControl(zone, { select: false })
+      }
+    }
+    // 再装 body 与 zone 子控件
+    for (const section of doc.sections) {
+      if (section.type === 'body') {
+        for (const c of section.components) {
+          const control = { ...c, id: c.id || genId() }
+          controls.value.push(control)
+          d.addControl(control, { select: false })
+        }
+      } else {
+        const host = zones.value.find((z) => z.zone === section.type)
+        for (const c of section.components) {
+          const control = { ...c, id: c.id || genId() }
+          host?.children.push(control)
+          d.addControl(control, { select: false, zoneHostId: host?.id })
+        }
+      }
+    }
+    dirty.value = false
+    selectedIds.value = []
+    useHistoryStore().clear()
+  }
+  async function restoreLastTemplate(): Promise<boolean> {
+    try {
+      const list = await repository.value.list()
+      const latest = [...list].sort((a, b) =>
+        (b.updatedAt ?? '').localeCompare(a.updatedAt ?? ''),
+      )[0]
+      if (!latest) return false
+      const record = await repository.value.get(latest.id)
+      if (!record) return false
+      loadTemplate(record)
+      markSaved()
+      return true
+    } catch {
+      return false
+    }
+  }
+
+  /* ------------------------------ 缩放代理 ------------------------------ */
+
+  function setZoom(z: number): void {
+    designer.value?.setZoom(z)
+  }
+
+  function fitCanvas(): void {
+    const container = document.querySelector<HTMLElement>('.canvas-stage')
+    if (container) designer.value?.fitToContainer(container)
+  }
+
+  return {
+    templateName,
+    pageSetup,
+    controls,
+    zones,
+    selectedIds,
+    selectedControl,
+    dirty,
+    lastSavedAt,
+    saveStateText,
+    designer,
+    viewport,
+    repository,
+    backendMode,
+    gridConfig,
+    editingCell,
+    canvasTick,
+    minPages,
+    pageCount,
+    activePage,
+    setMinPages,
+    addPage,
+    removePage,
+    goToPage,
+    openCellEditor,
+    closeCellEditor,
+    bumpCanvasTick,
+    setGrid,
+    attachCanvas,
+    detachCanvas,
+    addControlOfType,
+    importTable,
+    addZone,
+    updateControl,
+    updateControlSilent,
+    removeControl,
+    selectControl,
+    buildTemplate,
+    markSaved,
+    currentTemplateId,
+    setRepository,
+    newBlankTemplate,
+    saveTemplateAs,
+    saveTemplate,
+    loadTemplate,
+    restoreLastTemplate,
+    applyPageDecoration,
+    setZoom,
+    fitCanvas,
+
+    // 撤销/重做委托
+    undo: () => useHistoryStore().undo(),
+    redo: () => useHistoryStore().redo(),
+    canUndo: computed(() => useHistoryStore().canUndo),
+    canRedo: computed(() => useHistoryStore().canRedo),
+  }
+})
+
+/* --------------------------- 默认控件工厂 --------------------------- */
+
+function createDefaultControl(
+  type: ControlType,
+  at: { leftMm: number; topMm: number },
+): AnyControl | null {
+  const id = genId()
+  // 坐标兜底：at.leftMm/topMm 可能因上游时序（如拖拽时 viewport 未就绪）为 NaN/undefined，
+  // Math.max(0, Math.round(NaN*100)/100) 会得到 NaN，写进 store 后 NInputNumber 会渲染删除线。
+  // 这里强制收敛为有限数字，保证几何字段永远是有效数字。
+  const safeMm = (v: unknown): number => {
+    // 坐标统一收敛到 0.1mm（与属性面板 precision=1、step=0.1 一致）。
+    // 关键：Naive UI 的 NInputNumber 设了 step 后会校验值是否为 step 网格（0.1 整数倍），
+    // 非倍数会被判 displayedValueInvalid 并画删除线。任意坐标（如 139.82）必须 snap 到
+    // 0.1 倍数，否则 XY 一进画布就显示删除线（这就是“默认划横线”的真因，与 NaN 无关）。
+    const n = Math.round((typeof v === 'number' && Number.isFinite(v) ? v : 0) * 10) / 10
+    return n < 0 ? 0 : n
+  }
+  const base = {
+    id,
+    left: safeMm(at.leftMm),
+    top: safeMm(at.topMm),
+    printable: true,
+  }
+  switch (type) {
+    case 'text':
+      return { ...base, type, width: 50, height: 8, value: '文本', style: { fontSize: 12 } }
+    case 'image':
+      return { ...base, type, width: 40, height: 25, value: { mode: 'inline', content: '' }, fit: 'contain' }
+    case 'table':
+      return seedSummaryTail(
+        {
+          ...base,
+          type,
+          width: 180,
+          height: 60,
+          columns: [
+            { title: '序号', expression: '{{rowIndex + 1}}', width: 15, align: 'center', headerAlign: 'center' },
+            { title: '名称', field: 'items[].name', width: 60 },
+            { title: '数量', field: 'items[].qty', width: 25, headerAlign: 'center' },
+            { title: '单价', field: 'items[].price', width: 30, headerAlign: 'center' },
+            { title: '金额', field: 'items[].amount', width: 30, headerAlign: 'center' },
+          ],
+          // 自带示例数据：预览 / 打印即可看到填充内容与自动计算的小计
+          data: [
+            { name: '示例商品 A', qty: 2, price: 12.5, amount: 25 },
+            { name: '示例商品 B', qty: 1, price: 36, amount: 36 },
+            { name: '示例商品 C', qty: 5, price: 8, amount: 40 },
+          ],
+          // 默认单元格居中（defaultCellStyle 兜底，列/单元格显式对齐仍可覆盖）
+          options: {
+            repeatHeader: true,
+            repeatFooter: true,
+            pageRows: 'auto',
+            borders: 'all',
+            verticalAlign: 'middle',
+            defaultCellStyle: { align: 'center' },
+          },
+        },
+        // 默认植入完整「本页合计 + 总计 + 大写金额」三行尾结构
+        { numericColumns: [2, 3, 4], moneyColumn: 4, capital: true },
+      )
+    case 'barcode':
+      // 高度 30mm ≈ 113px：足够容纳 bwip-js 条码条（约 21mm）+ 文字行 + 上下留白，
+      // 避免默认 15mm 时文字行被 scaleY 压扁到看不见。
+      return { ...base, type, width: 60, height: 30, format: 'CODE128', showText: true }
+    case 'qrcode':
+      return { ...base, type, width: 25, height: 25, errorLevel: 'M' }
+    case 'rect':
+      return { ...base, type, width: 40, height: 25, fill: 'transparent', stroke: '#000000', strokeWidth: 1 }
+    case 'line':
+      return { ...base, type, width: 60, height: 0, stroke: '#000000', strokeWidth: 1 }
+    case 'zone':
+      // zone 由面板显式指定 header/footer，拖入默认 header
+      return { ...base, type, width: 210, height: 20, zone: 'header', zoneHeight: 20, repeat: true, children: [] }
+    case 'richtext':
+      return {
+        ...base,
+        type,
+        width: 80,
+        height: 24,
+        value: '<h3>标题</h3><p>在这里输入<strong>富文本</strong>内容，支持列表、加粗等排版。</p>',
+      }
+    case 'chart':
+      return {
+        ...base,
+        type,
+        width: 90,
+        height: 60,
+        kind: 'bar',
+        categories: ['一月', '二月', '三月', '四月'],
+        series: [
+          { name: '销量', data: [120, 200, 150, 80] },
+          { name: '退货', data: [20, 35, 15, 10] },
+        ],
+        options: { showAxis: true, showGrid: true, showLegend: true, valueLabel: false },
+      }
+  }
+}
diff --git a/openprint/src/design/stores/history.ts b/openprint/src/design/stores/history.ts
new file mode 100644
index 0000000..97c51e7
--- /dev/null
+++ b/openprint/src/design/stores/history.ts
@@ -0,0 +1,97 @@
+/**
+ * history store —— undo/redo 命令栈（《实施指南》Phase 4）
+ *
+ * 命令模式：每次编辑操作（add/remove/update）记录 undo/redo 逆操作；
+ * 撤销 = 回到上一个历史状态；重做 = 前进一步。
+ *
+ * 铁律（主任 2026-08-08）：
+ * - 历史栈纯内存，不持久化（持久化只有手动"保存模板"一个入口）
+ * - loadTemplate / restoreLastTemplate 时清空历史栈（全新工作会话）
+ */
+import { defineStore } from 'pinia'
+import { ref, computed } from 'vue'
+
+export interface HistoryCommand {
+  /** 逆操作（撤销：回到操作前的状态） */
+  undo: () => void
+  /** 重做：回到操作后的状态 */
+  redo: () => void
+  /** 描述（调试/未来状态栏显示用） */
+  description: string
+}
+
+export const useHistoryStore = defineStore('history', () => {
+  const undoStack = ref<HistoryCommand[]>([])
+  const redoStack = ref<HistoryCommand[]>([])
+  const _enabled = ref(true)
+
+  const canUndo = computed(() => undoStack.value.length > 0)
+  const canRedo = computed(() => redoStack.value.length > 0)
+
+  /** 当前批次内合并模式（同一控件连续位置变更不撑爆栈） */
+  let batch: HistoryCommand[] | null = null
+
+  function push(cmd: HistoryCommand): void {
+    if (!_enabled.value) return
+    if (batch) {
+      batch.push(cmd)
+      return
+    }
+    undoStack.value.push(cmd)
+    redoStack.value = []
+    // 防止无限增长（保留最近 200 步）
+    if (undoStack.value.length > 200) undoStack.value.shift()
+  }
+
+  /** 开启批处理：所有 push 合并为一步 undo（用于连续拖拽自动归并） */
+  function beginBatch(): void {
+    batch = []
+  }
+
+  function endBatch(description = '批量编辑'): void {
+    if (!batch || batch.length === 0) {
+      batch = null
+      return
+    }
+    const cmds = batch
+    undoStack.value.push({
+      undo: () => cmds.slice().reverse().forEach((c) => c.undo()),
+      redo: () => cmds.forEach((c) => c.redo()),
+      description,
+    })
+    redoStack.value = []
+    batch = null
+  }
+
+  function undo(): void {
+    const cmd = undoStack.value.pop()
+    if (!cmd) return
+    _enabled.value = false
+    try {
+      cmd.undo()
+      redoStack.value.push(cmd)
+    } finally {
+      _enabled.value = true
+    }
+  }
+
+  function redo(): void {
+    const cmd = redoStack.value.pop()
+    if (!cmd) return
+    _enabled.value = false
+    try {
+      cmd.redo()
+      undoStack.value.push(cmd)
+    } finally {
+      _enabled.value = true
+    }
+  }
+
+  function clear(): void {
+    undoStack.value = []
+    redoStack.value = []
+    batch = null
+  }
+
+  return { undoStack, canUndo, canRedo, push, beginBatch, endBatch, undo, redo, clear }
+})
diff --git a/openprint/src/design/stores/ui.ts b/openprint/src/design/stores/ui.ts
new file mode 100644
index 0000000..d7ff9c2
--- /dev/null
+++ b/openprint/src/design/stores/ui.ts
@@ -0,0 +1,138 @@
+/**
+ * ui store —— 缩放 / 主题 / 面板开关 / 语言
+ *
+ * 主题闭环（主任定：一个主题源，同时控制 naive-ui darkTheme + CSS 变量 + body .dark 类）：
+ *   themePreference = 'light' | 'dark' | 'system'（用户选择，持久化）
+ *   effectiveTheme  = 'light' | 'dark'（解析 system 后的实际主题）
+ *   toggleTheme()   = light <-> dark（一键切换）
+ *   applyTheme()    = document.documentElement 同步 .dark 类，body 颜色由 NGlobalStyle 管理
+ */
+import { defineStore } from 'pinia'
+import { computed, ref, watch } from 'vue'
+
+const STORAGE_KEY = 'openprint:ui:theme'
+
+type ThemePreference = 'light' | 'dark' | 'system'
+export type EffectiveTheme = 'light' | 'dark'
+
+function readPreference(): ThemePreference {
+  if (typeof window === 'undefined') return 'system'
+  try {
+    const v = window.localStorage.getItem(STORAGE_KEY)
+    return (v === 'light' || v === 'dark' || v === 'system') ? v : 'system'
+  } catch {
+    return 'system'
+  }
+}
+
+function writePreference(v: ThemePreference): void {
+  if (typeof window === 'undefined') return
+  try {
+    window.localStorage.setItem(STORAGE_KEY, v)
+  } catch {
+    /* noop */
+  }
+}
+
+function systemIsDark(): boolean {
+  if (typeof window === 'undefined' || !window.matchMedia) return false
+  return window.matchMedia('(prefers-color-scheme: dark)').matches
+}
+
+export const useUiStore = defineStore('ui', () => {
+  /** 用户偏好（持久化） */
+  const themePreference = ref<ThemePreference>(readPreference())
+  /** 系统暗色（只读实时值） */
+  const systemDark = ref(systemIsDark())
+
+  /** 左侧面板当前 Tab：components / layers / datasource */
+  const leftTab = ref<'components' | 'layers' | 'datasource'>('components')
+  /** 右侧面板开关 */
+  const rightPanelVisible = ref(true)
+  /** 打印预览弹窗开关（顶部工具栏与批量数据面板共用） */
+  const previewOpen = ref(false)
+  /** 导出弹窗开关（顶部工具栏与批量数据面板共用） */
+  const exportOpen = ref(false)
+  /** 语言 */
+  const locale = ref<'zh-CN' | 'en-US'>('zh-CN')
+  /** 画布上是否显示页边距内容区参考线（蓝色虚线） */
+  const showMarginGuides = ref(true)
+  function toggleMarginGuides(): void {
+    showMarginGuides.value = !showMarginGuides.value
+  }
+
+  /** 实际生效主题（system 下解析出的 light/dark） */
+  const effectiveTheme = computed<EffectiveTheme>(() =>
+    themePreference.value === 'system'
+      ? systemDark.value ? 'dark' : 'light'
+      : themePreference.value,
+  )
+
+  /** 兼容旧代码直接读 theme */
+  const theme = computed<EffectiveTheme>(() => effectiveTheme.value)
+
+  function applyDomTheme(): void {
+    if (typeof document === 'undefined') return
+    const root = document.documentElement
+    const isDark = effectiveTheme.value === 'dark'
+    root.classList.toggle('dark', isDark)
+    root.style.colorScheme = isDark ? 'dark' : 'light'
+  }
+
+  function setPreference(v: ThemePreference): void {
+    themePreference.value = v
+    writePreference(v)
+  }
+
+  /** 一键切换：light <-> dark；system 的话切到 dark，再按 light/dark 互切 */
+  function toggleTheme(): void {
+    if (themePreference.value === 'system') {
+      setPreference(systemDark.value ? 'light' : 'dark')
+      return
+    }
+    setPreference(themePreference.value === 'light' ? 'dark' : 'light')
+  }
+
+  /* ------------------------------ 监听系统主题变化 ----------------------------- */
+
+  let mql: MediaQueryList | null = null
+  function onSystemChange(e: MediaQueryListEvent): void {
+    systemDark.value = e.matches
+  }
+  function bindSystemListener(): void {
+    if (typeof window === 'undefined' || !window.matchMedia) return
+    if (mql) return
+    mql = window.matchMedia('(prefers-color-scheme: dark)')
+    systemDark.value = mql.matches
+    mql.addEventListener?.('change', onSystemChange)
+  }
+
+  /* --------------------------------- 同步 DOM 类 -------------------------------- */
+
+  watch(
+    effectiveTheme,
+    () => {
+      applyDomTheme()
+    },
+    { immediate: true },
+  )
+
+  bindSystemListener()
+
+  return {
+    // theme
+    themePreference,
+    effectiveTheme,
+    theme,
+    setPreference,
+    toggleTheme,
+    // others
+    leftTab,
+    rightPanelVisible,
+    previewOpen,
+    exportOpen,
+    locale,
+    showMarginGuides,
+    toggleMarginGuides,
+  }
+})
diff --git a/openprint/src/design/toolbar/ExportDialog.vue b/openprint/src/design/toolbar/ExportDialog.vue
new file mode 100644
index 0000000..32e95f2
--- /dev/null
+++ b/openprint/src/design/toolbar/ExportDialog.vue
@@ -0,0 +1,200 @@
+<script setup lang="ts">
+/**
+ * ExportDialog —— 三格式导出（PDF / JPG / SVG）
+ *
+ * 与预览共用同一份数据合成逻辑（buildTemplate + buildPreviewData），
+ * 导出引擎统一以 render() 的 HTML 产物为真相来源，保证「预览 = 导出 = 打印」。
+ *
+ * 导出语义（见 core/export-engine）：
+ * - PDF：单文件多页，思源宋体写死内联
+ * - JPG：每页一个文件（多页时 name-1.jpg / name-2.jpg ...）
+ * - SVG：单文件多页纵向堆叠（矢量，含 foreignObject）
+ */
+import { ref } from 'vue'
+import {
+  NButton,
+  NInput,
+  NInputNumber,
+  NModal,
+  NRadio,
+  NRadioGroup,
+  useMessage,
+} from 'naive-ui'
+import { exportDocument, downloadBlob, type ExportFormat } from '@/core/export-engine'
+import { useDesignerStore } from '@/design/stores/designer'
+import { useDataSourceStore } from '@/design/stores/dataSource'
+import { buildPreviewData } from '@/design/preview/preview-data'
+
+const props = defineProps<{ show: boolean }>()
+const emit = defineEmits<{ (e: 'update:show', value: boolean): void }>()
+
+const store = useDesignerStore()
+const dsStore = useDataSourceStore()
+const message = useMessage()
+
+const format = ref<ExportFormat>('pdf')
+const rowCount = ref(30)
+const filename = ref('销售出库单')
+const exporting = ref(false)
+
+const formatOptions = [
+  { label: 'PDF（单文件 · 多页）', value: 'pdf' },
+  { label: 'JPG（每页一张）', value: 'jpg' },
+  { label: 'SVG（矢量 · 单文件多页）', value: 'svg' },
+]
+
+function close(): void {
+  emit('update:show', false)
+}
+
+async function onExport(): Promise<void> {
+  if (exporting.value) return
+  exporting.value = true
+  try {
+    const template = store.buildTemplate()
+    const data = buildPreviewData(dsStore.activeFields, { rows: rowCount.value })
+    const res = await exportDocument(
+      {
+        template,
+        data,
+        output: {
+          pageDecoration: {
+            backgroundColor: store.pageSetup.backgroundColor ?? '#ffffff',
+            watermark: store.pageSetup.watermark,
+          },
+        },
+      },
+      format.value,
+      { filename: filename.value.trim() || 'openprint-document' },
+    )
+    res.blobs.forEach((b, i) => downloadBlob(b, res.filenames[i]!))
+    message.success(`已导出 ${res.blobs.length} 个文件（${res.filenames[0]} 等）`)
+    close()
+  } catch (e) {
+    message.error(`导出失败：${e instanceof Error ? e.message : String(e)}`)
+  } finally {
+    exporting.value = false
+  }
+}
+</script>
+
+<template>
+  <NModal
+    :show="props.show"
+    display-directive="if"
+    :mask-closable="!exporting"
+    transform-origin="center"
+    @update:show="emit('update:show', $event)"
+  >
+    <div class="export-shell">
+      <header class="export-head">
+        <div class="i-carbon-download text-16px" />
+        <span class="text-14px font-medium">导出文档</span>
+        <span class="text-12px op-60">PDF · JPG · SVG · 与预览/打印一致</span>
+      </header>
+
+      <div class="export-body">
+        <!-- 格式 -->
+        <div class="row">
+          <span class="row-label">格式</span>
+          <NRadioGroup v-model:value="format" class="flex-1">
+            <div class="flex flex-wrap gap-2">
+              <NRadio v-for="o in formatOptions" :key="o.value" :value="o.value" :label="o.label" />
+            </div>
+          </NRadioGroup>
+        </div>
+
+        <!-- 明细行数（验证多页导出） -->
+        <div class="row">
+          <span class="row-label">明细行数</span>
+          <NInputNumber
+            v-model:value="rowCount"
+            size="small"
+            button-placement="both"
+            :min="0"
+            :max="500"
+            :step="10"
+            style="width: 160px"
+          />
+          <span class="text-12px op-60">调大可验证跨页导出</span>
+        </div>
+
+        <!-- 文件名 -->
+        <div class="row">
+          <span class="row-label">文件名</span>
+          <NInput v-model:value="filename" size="small" placeholder="openprint-document" class="flex-1" />
+        </div>
+
+        <p class="hint">
+          JPG 多页时每页导出为独立文件（<code>name-1.jpg</code> …）；PDF / SVG 为单文件多页。
+        </p>
+      </div>
+
+      <footer class="export-foot">
+        <NButton size="small" :disabled="exporting" @click="close">取消</NButton>
+        <NButton size="small" type="primary" :loading="exporting" @click="onExport">
+          <div class="i-carbon-download mr-1 text-14px" />
+          导出
+        </NButton>
+      </footer>
+    </div>
+  </NModal>
+</template>
+
+<style scoped>
+.export-shell {
+  display: flex;
+  flex-direction: column;
+  width: 460px;
+  max-width: 92vw;
+  border-radius: 10px;
+  background: var(--brand-surface);
+  box-shadow: 0 20px 60px -10px rgba(0, 0, 0, 0.35);
+  overflow: hidden;
+}
+.export-head {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  padding: 14px 16px;
+  border-bottom: 1px solid var(--brand-border);
+  color: var(--brand-text-1);
+}
+.export-body {
+  display: flex;
+  flex-direction: column;
+  gap: 14px;
+  padding: 16px;
+  color: var(--brand-text-1);
+}
+.row {
+  display: flex;
+  align-items: center;
+  gap: 12px;
+}
+.row-label {
+  flex: none;
+  width: 64px;
+  font-size: 13px;
+  color: var(--brand-text-2);
+}
+.hint {
+  margin: 0;
+  font-size: 12px;
+  line-height: 1.6;
+  color: var(--brand-text-2);
+}
+.hint code {
+  font-family: ui-monospace, SFMono-Regular, Menlo, monospace;
+  background: var(--brand-bg);
+  padding: 0 4px;
+  border-radius: 3px;
+}
+.export-foot {
+  display: flex;
+  justify-content: flex-end;
+  gap: 10px;
+  padding: 12px 16px;
+  border-top: 1px solid var(--brand-border);
+}
+</style>
diff --git a/openprint/src/design/toolbar/TopToolbar.vue b/openprint/src/design/toolbar/TopToolbar.vue
new file mode 100644
index 0000000..fc7bcef
--- /dev/null
+++ b/openprint/src/design/toolbar/TopToolbar.vue
@@ -0,0 +1,925 @@
+<script setup lang="ts">
+/**
+ * TopToolbar —— 顶部工具栏（56px，亮/暗主题用 var(--brand-nav-*) 自适应跟随主题）
+ * 左：Logo / 产品名 / 版本 / 文件菜单 / 后端模式徽标；中：模板名 + 保存状态；
+ * 右：撤销重做 / 预览 / 保存 / 导出 / 主题切换 / 设置 / 头像。
+ */
+import { computed, nextTick, onBeforeUnmount, onMounted, ref } from 'vue'
+import {
+  NButton,
+  NDropdown,
+  NIcon,
+  NInput,
+  NModal,
+  NText,
+  NTooltip,
+  useMessage,
+  type DropdownOption,
+} from 'naive-ui'
+import { useDesignerStore } from '@/design/stores/designer'
+import { useUiStore } from '@/design/stores/ui'
+import TemplateModal from '@/design/modals/TemplateModal.vue'
+import SettingsModal from '@/design/modals/SettingsModal.vue'
+import TemplateMarket from '@/design/modals/TemplateMarket.vue'
+import DataImportModal from '@/design/modals/DataImportModal.vue'
+import JsonViewerModal from '@/design/modals/JsonViewerModal.vue'
+import PrintDialog from '@/design/modals/PrintDialog.vue'
+import PreviewPanel from '@/design/preview/PreviewPanel.vue'
+import ExportDialog from '@/design/toolbar/ExportDialog.vue'
+import AiAssistantPanel from '@/design/ai/AiAssistantPanel.vue'
+import { useConfirm } from '@/design/composables/useConfirm'
+import { usePrinterProbe } from '@/design/composables/usePrinterProbe'
+import { createDemoTemplate, DEMO_TEMPLATE_NAME } from '@/repository/mock/data/demo-template'
+import { exportTemplateFile, importTemplateFile } from '@/design/utils/template-file'
+import { validateTemplate } from '@/core/spec/validator'
+
+const store = useDesignerStore()
+const uiStore = useUiStore()
+const message = useMessage()
+const { confirm } = useConfirm()
+
+const showTplModal = ref(false)
+const showSaveAs = ref(false)
+const showSettings = ref(false)
+const showMarket = ref(false)
+const showDataImport = ref(false)
+const showJson = ref(false)
+const showPrint = ref(false)
+const showAi = ref(false)
+const showNewTemplate = ref(false)
+const newTemplateName = ref('')
+const saveAsName = ref('')
+/** 中间模板名输入框，可随时改名 */
+const templateNameRef = ref<{ focus: () => void; select?: () => void } | null>(null)
+
+/** 快捷键指南弹窗 */
+const showShortcuts = ref(false)
+const IS_MAC = /Mac|iPhone|iPad/.test(navigator.platform)
+/** 可手动切换的查看平台；默认跟随当前系统 */
+const platform = ref<'mac' | 'win'>(IS_MAC ? 'mac' : 'win')
+const MOD = computed(() => (platform.value === 'mac' ? '⌘' : 'Ctrl'))
+const platformLabel = computed(() => (platform.value === 'mac' ? 'macOS' : 'Windows / Linux'))
+
+/** 快捷键数据随所选平台重算（MOD 取自当前平台） */
+const shortcutGroups = computed(() => [
+  {
+    title: '通用操作',
+    items: [
+      { keys: [MOD.value, 'Z'], desc: '撤销' },
+      { keys: [MOD.value, 'Shift', 'Z'], desc: '重做', hint: `或 ${MOD.value} + Y` },
+      { keys: ['Delete'], desc: '删除选中控件', hint: '或 Backspace' },
+      { keys: [MOD.value, 'D'], desc: '复制选中控件（向右下偏移 10mm）' },
+      { keys: ['Esc'], desc: '取消选中' },
+    ],
+  },
+  {
+    title: '画布视图',
+    items: [
+      { keys: ['Space', '拖拽'], desc: '按住空格拖拽平移画布' },
+      { keys: [MOD.value, '滚轮'], desc: '缩放画布' },
+      { keys: ['滚轮'], desc: '垂直平移；Shift + 滚轮水平平移' },
+    ],
+  },
+  {
+    title: '表格单元格编辑（双击表格进入）',
+    items: [
+      { keys: ['Enter'], desc: '提交并下移一行' },
+      { keys: ['Tab'], desc: '跳到下一单元格', hint: 'Shift + Tab 上一格' },
+      { keys: ['Esc'], desc: '提交并退出编辑' },
+    ],
+  },
+])
+
+function isTypingTarget(t: EventTarget | null): boolean {
+  const el = t as HTMLElement | null
+  return !!el && (el.tagName === 'INPUT' || el.tagName === 'TEXTAREA' || el.isContentEditable)
+}
+
+/** 按 ? 也能打开快捷键指南（输入框内不触发） */
+function onHelpKey(e: KeyboardEvent): void {
+  if (e.key === '?' && !isTypingTarget(e.target)) {
+    e.preventDefault()
+    showShortcuts.value = true
+  }
+}
+
+onMounted(() => window.addEventListener('keydown', onHelpKey))
+onBeforeUnmount(() => window.removeEventListener('keydown', onHelpKey))
+
+/* --------------------------- 打印机连接自测 --------------------------- */
+
+const {
+  state: printerState,
+  printers: printerList,
+  health: printerHealth,
+  errorText: printerError,
+  baseUrl: printerBase,
+  probe: runPrinterProbe,
+  probeIfStale: runPrinterProbeIfStale,
+} = usePrinterProbe()
+
+/** 状态灯颜色：绿=已连接 / 红=不可达 / 黄=检测中 / 灰=未检测 */
+const printerDotClass = computed(() => `is-${printerState.value}`)
+
+/** 悬停提示：版本 + 打印机数量 / 失败原因 */
+const printerTooltip = computed(() => {
+  switch (printerState.value) {
+    case 'connected':
+      return `打印 · 客户端已连接（${printerHealth.value?.app ?? 'OpenPrint'} v${
+        printerHealth.value?.version ?? '?'
+      } · ${printerList.value.length} 台打印机）`
+    case 'checking':
+      return '打印 · 正在检测打印客户端…'
+    case 'disconnected':
+      return `打印 · 客户端不可达：${printerError.value}（${printerBase.value}）`
+    default:
+      return `打印 · 点击自测客户端连接（${printerBase.value}）`
+  }
+})
+
+/** 启动后静默自测一次，让状态灯有初值（失败不打扰用户） */
+onMounted(() => {
+  void runPrinterProbeIfStale()
+})
+
+/** 点击打印按钮：先自测连接状态，再打开打印弹窗 */
+async function onPrintClick(): Promise<void> {
+  showPrint.value = true
+  const ok = await runPrinterProbe()
+  if (ok) {
+    message.success(
+      `打印客户端已连接：${printerHealth.value?.app ?? 'OpenPrint'} v${
+        printerHealth.value?.version ?? '?'
+      } · ${printerList.value.length} 台打印机`,
+    )
+  } else {
+    message.warning(`打印客户端不可达：${printerError.value}`)
+  }
+}
+
+function onTemplateName(v: string): void {
+  store.templateName = v
+  store.dirty = true
+}
+
+const isDark = computed(() => uiStore.effectiveTheme === 'dark')
+
+const fileMenuOptions: DropdownOption[] = [
+  { label: '新建空白模板', key: 'new' },
+  { label: '打开模板...', key: 'open' },
+  { type: 'divider', key: 'd1' },
+  { label: '载入示例模板', key: 'demo' },
+  { type: 'divider', key: 'd2' },
+  { label: '导入模板...', key: 'importTpl' },
+  { label: '导出模板...', key: 'exportTpl' },
+  { type: 'divider', key: 'd3' },
+  { label: '保存', key: 'save' },
+  { label: '另存为...', key: 'saveAs' },
+]
+
+const themeOptions: DropdownOption[] = [
+  {
+    label: '浅色',
+    key: 'light',
+    icon: () => h(NIcon, null, { default: () => h(IconSun) }),
+  },
+  {
+    label: '深色',
+    key: 'dark',
+    icon: () => h(NIcon, null, { default: () => h(IconMoon) }),
+  },
+  {
+    label: '跟随系统',
+    key: 'system',
+    icon: () => h(NIcon, null, { default: () => h(IconAuto) }),
+  },
+]
+
+async function onSave(): Promise<void> {
+  // 唯一持久化入口（主任定：编辑纯本地，手动保存才写存储；无后端走 localStorage）
+  const result = await store.saveTemplate()
+  if (result.ok) {
+    message.success(store.backendMode === 'cloud' ? '模板已保存到云端' : '模板已保存到本地存储')
+  } else {
+    message.error(`保存失败：${result.error}`)
+  }
+}
+
+async function onFileSelect(key: string): Promise<void> {
+  if (key === 'new') {
+    if (store.dirty && !(await confirm('当前模板有未保存改动，新建将清空画布。确定继续？'))) return
+    // 先弹窗让用户输入模板名称
+    newTemplateName.value = '未命名模板'
+    showNewTemplate.value = true
+  } else if (key === 'open') {
+    showTplModal.value = true
+  } else if (key === 'save') {
+    void onSave()
+  } else if (key === 'saveAs') {
+    saveAsName.value = `${store.templateName} 副本`
+    showSaveAs.value = true
+  } else if (key === 'demo') {
+    if (store.dirty && !(await confirm('载入示例模板将覆盖当前未保存的改动。确定继续？'))) return
+    store.loadTemplate({ id: 'demo', name: DEMO_TEMPLATE_NAME, data: createDemoTemplate() })
+    message.success(`已载入示例：${DEMO_TEMPLATE_NAME}`)
+  } else if (key === 'importTpl') {
+    void onImportTemplate()
+  } else if (key === 'exportTpl') {
+    onExportTemplate()
+  }
+}
+
+/** B：导出当前画布模板为 .json 文件 */
+function onExportTemplate(): void {
+  const data = store.buildTemplate()
+  const res = validateTemplate(data)
+  if (!res.valid) {
+    message.error(`模板校验未通过，无法导出：${res.issues.map((i) => i.message).join('；')}`)
+    return
+  }
+  exportTemplateFile(data, store.templateName)
+  message.success(`已导出：${store.templateName}.json`)
+}
+
+/** B：从 .json 文件导入模板并载入画布 */
+async function onImportTemplate(): Promise<void> {
+  const data = await importTemplateFile()
+  if (!data) {
+    message.warning('未选择文件或文件读取失败')
+    return
+  }
+  const res = validateTemplate(data)
+  if (!res.valid) {
+    message.error(`文件不是有效的模板：${res.issues.map((i) => i.message).join('；')}`)
+    return
+  }
+  if (store.dirty && !(await confirm('导入将覆盖当前未保存的改动。确定继续？'))) return
+  const name = (data as { name?: string }).name || store.templateName || '导入的模板'
+  store.loadTemplate({ id: `import-${Date.now()}`, name, data })
+  message.success(`已导入：${name}`)
+}
+
+/** 确认新建模板：创建空白模板并设置用户输入的名称 */
+function confirmNewTemplate(): void {
+  const name = newTemplateName.value.trim()
+  if (!name) {
+    message.warning('请输入模板名称')
+    return
+  }
+  showNewTemplate.value = false
+  store.newBlankTemplate()
+  store.templateName = name
+  store.dirty = false
+  message.success(`已新建：${name}`)
+}
+
+function onThemeSelect(key: string): void {
+  if (key === 'light' || key === 'dark' || key === 'system') {
+    uiStore.setPreference(key)
+    message.success(
+      key === 'system' ? '已切换：跟随系统' : key === 'dark' ? '已切换：深色主题' : '已切换：浅色主题',
+    )
+  }
+}
+
+/** 一键切换（☀ ↔ 🌙）：忽略 system，直接 light/dark 翻转 */
+function onToggleTheme(): void {
+  uiStore.toggleTheme()
+}
+
+async function confirmSaveAs(): Promise<void> {
+  const name = saveAsName.value.trim()
+  if (!name) {
+    message.warning('请输入模板名称')
+    return
+  }
+  showSaveAs.value = false
+  const result = await store.saveTemplateAs(name)
+  if (result.ok) message.success(`已另存为：${name}`)
+  else message.error(`另存为失败：${result.error}`)
+}
+
+function onPreview(): void {
+  uiStore.previewOpen = true
+}
+
+function onExport(): void {
+  uiStore.exportOpen = true
+}
+</script>
+
+<script lang="ts">
+import { h, type Component } from 'vue'
+/** 图标本地函数，避免多一层 import 噪音 */
+const IconSun: Component = () =>
+  h('div', { class: 'i-carbon-sun text-16px' })
+const IconMoon: Component = () =>
+  h('div', { class: 'i-carbon-moon text-16px' })
+const IconAuto: Component = () =>
+  h('div', { class: 'i-carbon-screen text-16px' })
+const IconChevronDown: Component = () =>
+  h('div', { class: 'i-carbon-chevron-down text-12px' })
+</script>
+
+<template>
+  <header
+    class="toolbar-root flex h-56px items-center justify-between px-4"
+    :class="isDark ? 'dark' : 'light'"
+  >
+    <!-- 左：品牌 + 文件菜单 + 后端模式徽标 -->
+    <div class="flex items-center gap-3">
+      <div class="logo-circle">
+        <img src="@/assets/logo.png" alt="OpenPrint" class="logo-img" />
+      </div>
+      <span class="product-name">OpenPrint 设计器</span>
+      <span class="version-tag">V1.0.0</span>
+
+      <NDropdown :options="fileMenuOptions" @select="onFileSelect">
+        <span class="file-menu-trigger">
+          <span>文件</span>
+          <span class="ml-1 inline-flex items-center">
+            <n-icon size="14"><IconChevronDown /></n-icon>
+          </span>
+        </span>
+      </NDropdown>
+
+      <!-- 模板市场 -->
+      <NButton
+        size="small"
+        ghost
+        class="toolbar-ghost-btn"
+        style="margin-left: 8px"
+        @click="showMarket = true"
+      >
+        <div class="i-carbon-store mr-1 text-14px" />
+        模板市场
+      </NButton>
+
+      <!-- 导入数据 -->
+      <NButton
+        size="small"
+        ghost
+        class="toolbar-ghost-btn"
+        style="margin-left: 8px"
+        @click="showDataImport = true"
+      >
+        <div class="i-carbon-table mr-1 text-14px" />
+        导入数据
+      </NButton>
+
+      <NTooltip>
+        <template #trigger>
+          <span
+            class="backend-tag"
+            :class="store.backendMode === 'cloud' ? 'is-cloud' : 'is-local'"
+          >
+            <div :class="store.backendMode === 'cloud' ? 'i-carbon-cloud' : 'i-carbon-document'" />
+            {{ store.backendMode === 'cloud' ? '云端' : '本地存储' }}
+          </span>
+        </template>
+        {{
+          store.backendMode === 'cloud'
+            ? '已接入后端接口（VITE_OPENPRINT_API_BASE）'
+            : '未配置后端，使用本地存储 / 内置 Mock 数据源（主任铁律）'
+        }}
+      </NTooltip>
+    </div>
+
+    <!-- 中：模板名（可随时编辑） -->
+    <div class="flex min-w-180px items-center">
+      <NInput
+        ref="templateNameRef"
+        size="small"
+        :value="store.templateName"
+        placeholder="请输入模板名称"
+        :bordered="false"
+        class="tpl-name-input"
+        @update:value="onTemplateName"
+      />
+    </div>
+
+    <!-- 右：操作区 -->
+    <div class="flex items-center gap-2">
+      <!-- 撤销 -->
+      <NTooltip>
+        <template #trigger>
+          <NButton
+            quaternary
+            size="small"
+            class="toolbar-icon-btn"
+            :disabled="!store.canUndo"
+            @click="store.undo()"
+          >
+            <div class="i-carbon-undo text-16px" />
+          </NButton>
+        </template>
+        撤销（Ctrl+Z）
+      </NTooltip>
+      <!-- 重做 -->
+      <NTooltip>
+        <template #trigger>
+          <NButton
+            quaternary
+            size="small"
+            class="toolbar-icon-btn"
+            :disabled="!store.canRedo"
+            @click="store.redo()"
+          >
+            <div class="i-carbon-redo text-16px" />
+          </NButton>
+        </template>
+        重做（Ctrl+Shift+Z）
+      </NTooltip>
+
+      <div class="toolbar-sep" />
+
+      <!-- 主题一键切换（☀ / 🌙） -->
+      <NTooltip>
+        <template #trigger>
+          <NButton quaternary size="small" class="toolbar-icon-btn" @click="onToggleTheme">
+            <div v-if="isDark" class="i-carbon-sun text-16px" />
+            <div v-else class="i-carbon-moon text-16px" />
+          </NButton>
+        </template>
+        切换主题：{{ isDark ? '当前深色，点击切浅色' : '当前浅色，点击切深色' }}
+      </NTooltip>
+
+      <!-- 主题菜单（浅/深/跟随系统） -->
+      <NDropdown :options="themeOptions" @select="onThemeSelect" trigger="click">
+        <NButton quaternary size="small" class="toolbar-icon-btn">
+          <n-icon size="16">
+            <IconChevronDown />
+          </n-icon>
+        </NButton>
+      </NDropdown>
+
+      <div class="toolbar-sep" />
+
+      <!-- 页边距参考线开关 -->
+      <NTooltip>
+        <template #trigger>
+          <NButton
+            quaternary
+            size="small"
+            class="toolbar-icon-btn"
+            :type="uiStore.showMarginGuides ? 'primary' : 'default'"
+            @click="uiStore.toggleMarginGuides()"
+          >
+            <div class="i-carbon-grid text-16px" />
+          </NButton>
+        </template>
+        页边距参考线：{{ uiStore.showMarginGuides ? '显示中' : '已隐藏' }}
+      </NTooltip>
+
+      <div class="toolbar-sep" />
+
+      <NButton size="small" ghost class="toolbar-ghost-btn" @click="onPreview">预览</NButton>
+      <NButton size="small" type="primary" @click="onSave">保存</NButton>
+      <NButton size="small" ghost class="toolbar-ghost-btn" @click="onExport">导出</NButton>
+
+      <!-- 打印按钮（右上角状态灯：绿=已连接 / 红=不可达 / 黄=检测中 / 灰=未检测） -->
+      <NTooltip>
+        <template #trigger>
+          <NButton
+            quaternary
+            size="small"
+            class="toolbar-icon-btn printer-btn"
+            @click="onPrintClick"
+          >
+            <div class="i-carbon-printer text-16px" />
+            <span class="printer-dot" :class="printerDotClass" />
+          </NButton>
+        </template>
+        {{ printerTooltip }}
+      </NTooltip>
+
+      <!-- JSON 查看 -->
+      <NTooltip>
+        <template #trigger>
+          <NButton quaternary size="small" class="toolbar-icon-btn" @click="showJson = true">
+            <div class="i-carbon-code text-16px" />
+          </NButton>
+        </template>
+        查看画布 JSON
+      </NTooltip>
+
+      <!-- 快捷键指南 -->
+      <NTooltip>
+        <template #trigger>
+          <NButton quaternary size="small" class="toolbar-icon-btn" @click="showShortcuts = true">
+            <div class="i-carbon-keyboard text-16px" />
+          </NButton>
+        </template>
+        快捷键指南（?）
+      </NTooltip>
+
+      <!-- AI 设计助手 -->
+      <NTooltip>
+        <template #trigger>
+          <NButton quaternary size="small" class="toolbar-icon-btn" @click="showAi = true">
+            <div class="i-carbon-ai-status text-16px" />
+          </NButton>
+        </template>
+        AI 设计助手
+      </NTooltip>
+
+      <div class="toolbar-sep" />
+
+      <NButton quaternary size="small" class="toolbar-icon-btn" @click="showSettings = true">
+        <div class="i-carbon-settings text-16px" />
+      </NButton>
+    </div>
+
+    <!-- 模板管理弹窗 -->
+    <TemplateModal v-model:show="showTplModal" />
+
+    <!-- 全局设置弹窗（本地打印 / 远程云打印） -->
+    <SettingsModal v-model:show="showSettings" />
+
+    <!-- 模板市场弹窗 -->
+    <TemplateMarket v-model:show="showMarket" />
+
+    <!-- 导入数据弹窗 -->
+    <DataImportModal v-model:show="showDataImport" />
+
+    <!-- 多页预览面板 -->
+    <PreviewPanel v-model:show="uiStore.previewOpen" />
+
+    <!-- 四格式导出对话框 -->
+    <ExportDialog v-model:show="uiStore.exportOpen" />
+
+    <!-- JSON 数据查看器 -->
+    <JsonViewerModal v-model:show="showJson" />
+
+    <!-- 打印对话框 -->
+    <PrintDialog v-model:show="showPrint" />
+
+    <!-- AI 设计助手面板 -->
+    <AiAssistantPanel v-model:show="showAi" @open-settings="showSettings = true" />
+
+    <!-- 快捷键指南弹窗 -->
+    <NModal
+      v-model:show="showShortcuts"
+      preset="card"
+      title="快捷键指南"
+      style="width: 560px; max-width: 92vw"
+    >
+      <template #header-extra>
+        <div class="shortcuts-platform-toggle">
+          <button
+            type="button"
+            class="platform-tab"
+            :class="{ active: platform === 'mac' }"
+            @click="platform = 'mac'"
+          >
+            macOS
+          </button>
+          <button
+            type="button"
+            class="platform-tab"
+            :class="{ active: platform === 'win' }"
+            @click="platform = 'win'"
+          >
+            Windows
+          </button>
+        </div>
+      </template>
+      <div class="shortcuts-body">
+        <section v-for="group in shortcutGroups" :key="group.title" class="shortcuts-group">
+          <h4 class="shortcuts-group-title">{{ group.title }}</h4>
+          <ul class="shortcuts-list">
+            <li v-for="(item, i) in group.items" :key="i" class="shortcuts-row">
+              <span class="shortcuts-keys">
+                <template v-for="(k, ki) in item.keys" :key="ki">
+                  <kbd class="kbd">{{ k }}</kbd>
+                  <span v-if="ki < item.keys.length - 1" class="kbd-plus">+</span>
+                </template>
+              </span>
+              <span class="shortcuts-desc">
+                {{ item.desc }}
+                <span v-if="item.hint" class="shortcuts-hint">（{{ item.hint }}）</span>
+              </span>
+            </li>
+          </ul>
+        </section>
+        <p class="shortcuts-foot">提示：在画布任意处按 <kbd class="kbd">?</kbd> 可随时唤起本指南。</p>
+      </div>
+    </NModal>
+
+    <!-- 另存为弹窗 -->
+    <NModal
+      v-model:show="showSaveAs"
+      preset="card"
+      title="另存为"
+      style="width: 420px; max-width: 92vw"
+    >
+      <div class="flex flex-col gap-2">
+        <NText depth="3" class="text-12px">将以新名称保存一份独立副本。</NText>
+        <NInput v-model:value="saveAsName" placeholder="请输入模板名称" @keyup.enter="confirmSaveAs" />
+      </div>
+      <template #footer>
+        <div class="flex justify-end gap-2">
+          <NButton size="small" @click="showSaveAs = false">取消</NButton>
+          <NButton size="small" type="primary" @click="confirmSaveAs">保存副本</NButton>
+        </div>
+      </template>
+    </NModal>
+
+    <!-- 新建模板弹窗 -->
+    <NModal
+      v-model:show="showNewTemplate"
+      preset="card"
+      title="新建模板"
+      style="width: 420px; max-width: 92vw"
+    >
+      <div class="flex flex-col gap-2">
+        <NText depth="3" class="text-12px">请输入模板名称，创建空白画布。</NText>
+        <NInput
+          v-model:value="newTemplateName"
+          placeholder="请输入模板名称"
+          @keyup.enter="confirmNewTemplate"
+        />
+      </div>
+      <template #footer>
+        <div class="flex justify-end gap-2">
+          <NButton size="small" @click="showNewTemplate = false">取消</NButton>
+          <NButton size="small" type="primary" @click="confirmNewTemplate">创建</NButton>
+        </div>
+      </template>
+    </NModal>
+  </header>
+</template>
+
+<style scoped>
+/* ================= 工具栏 —— 亮/暗都走 CSS 变量，跟随主题 ================= */
+.toolbar-root {
+  background: var(--brand-nav-bg);
+  color: var(--brand-nav-text);
+  border-bottom: 1px solid var(--brand-border);
+}
+
+/* 品牌 logo —— 保持图片原格式（透明就透明），不加背景色 */
+.logo-circle {
+  height: 28px;
+  width: 28px;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  flex-shrink: 0;
+}
+.logo-img {
+  width: 100%;
+  height: 100%;
+  object-fit: contain;
+  display: block;
+}
+
+.product-name {
+  font-size: 14px;
+  font-weight: 500;
+  color: var(--brand-nav-text-active);
+}
+
+.version-tag {
+  font-size: 11px;
+  color: var(--brand-nav-text-muted);
+}
+
+/* 文件菜单触发器 */
+.file-menu-trigger {
+  margin-left: 16px;
+  cursor: pointer;
+  display: inline-flex;
+  align-items: center;
+  padding: 4px 8px;
+  border-radius: 6px;
+  font-size: 13px;
+  color: var(--brand-nav-icon);
+  transition:
+    color 0.15s,
+    background 0.15s;
+}
+.file-menu-trigger:hover {
+  color: var(--brand-nav-icon-hover);
+  background: var(--brand-nav-bg-hover);
+}
+
+/* 后端模式徽标 */
+.backend-tag {
+  display: inline-flex;
+  align-items: center;
+  gap: 4px;
+  padding: 2px 8px;
+  border-radius: 6px;
+  font-size: 11px;
+}
+.backend-tag.is-cloud {
+  background: rgba(16, 185, 129, 0.15);
+  color: #34d399;
+}
+.backend-tag.is-local {
+  background: var(--brand-nav-bg-hover);
+  color: var(--brand-nav-text-muted);
+}
+
+/* 中间模板名（内联可编辑，去边框呈标题样式） */
+.tpl-name-input {
+  --n-color: var(--brand-nav-text-active);
+  --n-text-color: var(--brand-nav-text-active);
+  --n-caret-color: var(--brand-nav-text-active);
+  --n-font-size: 14px;
+  --n-font-weight: 500;
+  --n-padding: 0;
+  --n-text-align: center;
+  max-width: 200px;
+}
+.tpl-name-input :deep(.n-input__input-el) {
+  text-align: center;
+  font-weight: 500;
+}
+
+/* 图标按钮（quaternary → 用 nav 配色保证在深色导航上可读） */
+.toolbar-icon-btn {
+  color: var(--brand-nav-icon) !important;
+}
+.toolbar-icon-btn:hover:not(:disabled) {
+  color: var(--brand-nav-icon-hover) !important;
+  background: var(--brand-nav-bg-hover) !important;
+}
+.toolbar-icon-btn:disabled {
+  opacity: 0.4;
+}
+
+  /* 幽灵按钮（在深导航上：浅色下 white 边框/文字，暗色下边框同 muted） */
+.toolbar-ghost-btn {
+  --n-text-color: var(--brand-nav-icon);
+  --n-text-color-hover: var(--brand-nav-icon-hover);
+  --n-border: 1px solid var(--brand-nav-text-muted);
+  --n-border-hover: 1px solid var(--brand-nav-icon-hover);
+  --n-color-hover: var(--brand-nav-bg-hover);
+}
+
+/* 分隔线 */
+.toolbar-sep {
+  width: 1px;
+  height: 20px;
+  margin: 0 4px;
+  background: var(--brand-border);
+}
+
+/* ================= 快捷键指南弹窗 ================= */
+/* 平台分段切换（macOS / Windows 互看） */
+.shortcuts-platform-toggle {
+  display: inline-flex;
+  padding: 2px;
+  border-radius: 7px;
+  background: var(--brand-bg-hover, rgba(128, 128, 128, 0.12));
+  border: 1px solid var(--brand-border, #e5e5e5);
+}
+.platform-tab {
+  appearance: none;
+  border: none;
+  cursor: pointer;
+  font-size: 12px;
+  line-height: 1;
+  padding: 4px 10px;
+  border-radius: 5px;
+  color: var(--brand-text-muted, #888);
+  background: transparent;
+  transition:
+    color 0.15s,
+    background 0.15s;
+}
+.platform-tab:hover {
+  color: var(--brand-text, #333);
+}
+.platform-tab.active {
+  color: #fff;
+  background: var(--brand-primary, #3b82f6);
+  font-weight: 600;
+}
+
+.shortcuts-body {
+  display: flex;
+  flex-direction: column;
+  gap: 18px;
+}
+
+.shortcuts-group-title {
+  margin: 0 0 8px;
+  font-size: 13px;
+  font-weight: 600;
+  color: var(--brand-text, inherit);
+}
+
+.shortcuts-list {
+  margin: 0;
+  padding: 0;
+  list-style: none;
+  display: flex;
+  flex-direction: column;
+  gap: 6px;
+}
+
+.shortcuts-row {
+  display: flex;
+  align-items: center;
+  gap: 12px;
+  min-height: 28px;
+}
+
+.shortcuts-keys {
+  flex-shrink: 0;
+  display: inline-flex;
+  align-items: center;
+  gap: 4px;
+  width: 168px;
+}
+
+.kbd {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  min-width: 22px;
+  height: 22px;
+  padding: 0 7px;
+  font-size: 12px;
+  font-family: inherit;
+  line-height: 1;
+  color: var(--brand-text, #333);
+  background: var(--brand-bg-hover, #f5f5f5);
+  border: 1px solid var(--brand-border, #e0e0e0);
+  border-bottom-width: 2px;
+  border-radius: 5px;
+  box-shadow: 0 1px 0 rgba(0, 0, 0, 0.04);
+}
+
+.kbd-plus {
+  font-size: 11px;
+  color: var(--brand-text-muted, #aaa);
+}
+
+.shortcuts-desc {
+  font-size: 13px;
+  color: var(--brand-text, inherit);
+}
+
+.shortcuts-hint {
+  font-size: 12px;
+  color: var(--brand-text-muted, #999);
+}
+
+.shortcuts-foot {
+  margin: 4px 0 0;
+  font-size: 12px;
+  color: var(--brand-text-muted, #999);
+  border-top: 1px dashed var(--brand-border, #eee);
+  padding-top: 12px;
+}
+
+/* ================= 打印按钮连接状态灯 ================= */
+.printer-btn {
+  position: relative;
+}
+
+.printer-dot {
+  position: absolute;
+  top: 3px;
+  right: 3px;
+  width: 7px;
+  height: 7px;
+  border-radius: 50%;
+  border: 1px solid var(--brand-nav-bg, #fff);
+  background: #9ca3af;
+  transition: background 0.2s;
+}
+
+.printer-dot.is-connected {
+  background: #22c55e;
+  box-shadow: 0 0 4px rgba(34, 197, 94, 0.7);
+}
+
+.printer-dot.is-disconnected {
+  background: #ef4444;
+  box-shadow: 0 0 4px rgba(239, 68, 68, 0.7);
+}
+
+.printer-dot.is-checking {
+  background: #f59e0b;
+  animation: printer-dot-pulse 1s ease-in-out infinite;
+}
+
+.printer-dot.is-idle {
+  background: #9ca3af;
+}
+
+@keyframes printer-dot-pulse {
+  0%,
+  100% {
+    opacity: 1;
+  }
+  50% {
+    opacity: 0.3;
+  }
+}
+</style>
diff --git a/openprint/src/design/utils/csv.spec.ts b/openprint/src/design/utils/csv.spec.ts
new file mode 100644
index 0000000..5dbef0f
--- /dev/null
+++ b/openprint/src/design/utils/csv.spec.ts
@@ -0,0 +1,64 @@
+import { describe, it, expect } from 'vitest'
+import { parseCsv, csvToRecords } from './csv'
+
+describe('parseCsv', () => {
+  it('基础两行两列', () => {
+    expect(parseCsv('a,b\n1,2')).toEqual([['a', 'b'], ['1', '2']])
+  })
+
+  it('引号内逗号保留', () => {
+    expect(parseCsv('name,note\n"Li, Lei","hello, world"')).toEqual([
+      ['name', 'note'],
+      ['Li, Lei', 'hello, world'],
+    ])
+  })
+
+  it('引号转义（"" → "）', () => {
+    expect(parseCsv('a\n"He said ""hi"""')).toEqual([['a'], ['He said "hi"']])
+  })
+
+  it('引号内换行保留为单字段', () => {
+    const r = parseCsv('a\n"line1\nline2"')
+    expect(r).toEqual([['a'], ['line1\nline2']])
+  })
+
+  it('CRLF / LF / 老式 CR 均按行分隔', () => {
+    expect(parseCsv('a,b\r\n1,2\n3,4\r5,6')).toEqual([
+      ['a', 'b'],
+      ['1', '2'],
+      ['3', '4'],
+      ['5', '6'],
+    ])
+  })
+
+  it('剥离 UTF-8 BOM', () => {
+    expect(parseCsv('a,b\n1,2')).toEqual([['a', 'b'], ['1', '2']])
+  })
+
+  it('忽略尾部空行', () => {
+    expect(parseCsv('a\n1\n\n')).toEqual([['a'], ['1']])
+  })
+})
+
+describe('csvToRecords', () => {
+  it('首行作表头，生成对象数组', () => {
+    expect(csvToRecords('name,price\nLi,12.5\nWang,9')).toEqual([
+      { name: 'Li', price: '12.5' },
+      { name: 'Wang', price: '9' },
+    ])
+  })
+
+  it('单元格一律为字符串（不擅自转数字，保留前导零等）', () => {
+    const rec = csvToRecords('code\n00123')[0]!
+    expect(rec.code).toBe('00123')
+  })
+
+  it('空列名补齐为 col{序号}', () => {
+    const rec = csvToRecords('a,,\nc,,\n')[0]!
+    expect(Object.keys(rec)).toEqual(['a', 'col2', 'col3'])
+  })
+
+  it('空 CSV 返回空数组', () => {
+    expect(csvToRecords('')).toEqual([])
+  })
+})
diff --git a/openprint/src/design/utils/csv.ts b/openprint/src/design/utils/csv.ts
new file mode 100644
index 0000000..6803d84
--- /dev/null
+++ b/openprint/src/design/utils/csv.ts
@@ -0,0 +1,108 @@
+/**
+ * CSV 解析 —— 纯前端、零依赖（可变数据打印的本地数据源导入用）
+ *
+ * 支持：
+ * - 带引号字段（"a,b" 内的逗号保留）
+ * - 引号转义（"" 表示一个 "）
+ * - 引号内换行（整行跨多行，常见于地址字段）
+ * - CRLF / LF / 老式 CR 换行
+ * - UTF-8 BOM 自动剥离
+ *
+ * 设计取舍：CSV 单元格一律作为字符串返回，不擅自做数字/日期强转。
+ * 原因：手机号、邮编、订单号等带前导零的字段一旦被转成数字会丢信息；
+ * 需要数值格式时，渲染期的 binding.format（int/decimal/currency）会自行把字符串转成数字。
+ */
+export function parseCsv(text: string): string[][] {
+  const src = text.charCodeAt(0) === 0xfeff ? text.slice(1) : text
+  const rows: string[][] = []
+  let row: string[] = []
+  let field = ''
+  let inQuotes = false
+  const n = src.length
+  let i = 0
+
+  while (i < n) {
+    const c = src[i]!
+
+    // 提交当前行（跳过完全空白行：仅有单个空字段）
+    const pushRow = (): void => {
+      row.push(field)
+      if (!(row.length === 1 && row[0] === '')) rows.push(row)
+      row = []
+      field = ''
+    }
+
+    if (inQuotes) {
+      if (c === '"') {
+        if (src[i + 1] === '"') {
+          field += '"'
+          i += 2
+          continue
+        }
+        inQuotes = false
+        i++
+        continue
+      }
+      field += c
+      i++
+      continue
+    }
+
+    if (c === '"') {
+      inQuotes = true
+      i++
+      continue
+    }
+    if (c === ',') {
+      row.push(field)
+      field = ''
+      i++
+      continue
+    }
+    if (c === '\r') {
+      pushRow()
+      if (src[i + 1] === '\n') i += 2
+      else i++
+      continue
+    }
+    if (c === '\n') {
+      pushRow()
+      i++
+      continue
+    }
+    field += c
+    i++
+  }
+
+  // 收尾：还有未提交的字段/行
+  if (field.length > 0 || row.length > 0) {
+    row.push(field)
+    if (!(row.length === 1 && row[0] === '')) rows.push(row)
+  }
+  return rows
+}
+
+/**
+ * CSV 文本 → 记录数组（首行作表头，其余每行一个对象）。
+ * 空行（仅一个空单元格）自动跳过。表头空列名补齐为 col{序号}。
+ */
+export function csvToRecords(text: string): Record<string, unknown>[] {
+  const rows = parseCsv(text)
+  if (rows.length === 0) return []
+
+  const header = rows[0]!.map((h, idx) => h.trim() || `col${idx + 1}`)
+  const records: Record<string, unknown>[] = []
+
+  for (let r = 1; r < rows.length; r++) {
+    const cells = rows[r]!
+    // 整行只有一个空单元格 → 视为空行跳过
+    if (cells.length === 1 && cells[0]!.trim() === '') continue
+
+    const obj: Record<string, unknown> = {}
+    for (let c = 0; c < header.length; c++) {
+      obj[header[c]!] = cells[c] ?? ''
+    }
+    records.push(obj)
+  }
+  return records
+}
diff --git a/openprint/src/design/utils/data-import.ts b/openprint/src/design/utils/data-import.ts
new file mode 100644
index 0000000..2cea9e3
--- /dev/null
+++ b/openprint/src/design/utils/data-import.ts
@@ -0,0 +1,77 @@
+/**
+ * 数据导入解析 —— 支持 CSV / JSON / Excel(xlsx, xls)
+ *
+ * 纯前端、零后端。CSV 走 csv.ts 零依赖解析；Excel 用 xlsx 动态 import（自动拆成按需 chunk）。
+ *
+ * 约定（与导入弹窗一致）：
+ * - 导入文件的第一行作为列标题（表名取自文件名）；其余每行作为一条记录。
+ * - 解析结果交给 DataImportModal 做「预览 / 列改名 / 删列 / 删行」，确认后才落为
+ *   画布上的「内嵌数据表格」（TableControl.data），从而与 dataSource 字段绑定彻底解耦。
+ */
+import { csvToRecords } from './csv'
+
+export interface ImportColumn {
+  /** 数据键（来自原表头；重命名标题不影响数据映射） */
+  key: string
+  /** 显示标题（默认等于 key，可在弹窗中编辑） */
+  title: string
+}
+
+export interface ParsedData {
+  sourceName: string
+  columns: ImportColumn[]
+  rows: Array<Record<string, unknown>>
+}
+
+/** 把任意 JSON 解析结果规整为记录数组（兼容对象数组 / {records|data|items} 信封） */
+function normalizeJsonRecords(input: unknown): Record<string, unknown>[] {
+  if (Array.isArray(input)) {
+    return input.filter((x) => x && typeof x === 'object') as Record<string, unknown>[]
+  }
+  if (input && typeof input === 'object') {
+    const obj = input as Record<string, unknown>
+    const arr = obj.records ?? obj.data ?? obj.items
+    if (Array.isArray(arr)) {
+      return arr.filter((x) => x && typeof x === 'object') as Record<string, unknown>[]
+    }
+  }
+  return []
+}
+
+/** 从记录数组推导列（取所有行的 key 并集，保留首次出现顺序；空键名补 col{序号}） */
+function deriveColumns(rows: Array<Record<string, unknown>>): ImportColumn[] {
+  const seen = new Map<string, string>()
+  for (const row of rows) {
+    for (const rawKey of Object.keys(row)) {
+      const key = rawKey.trim() || `col${seen.size + 1}`
+      if (!seen.has(key)) seen.set(key, key)
+    }
+  }
+  return [...seen.values()].map((key) => ({ key, title: key }))
+}
+
+export async function parseDataFile(file: File): Promise<ParsedData> {
+  const name = file.name
+  const ext = name.toLowerCase().split('.').pop() ?? ''
+  const buf = await file.arrayBuffer()
+  let rows: Array<Record<string, unknown>>
+
+  if (ext === 'csv') {
+    rows = csvToRecords(new TextDecoder('utf-8').decode(buf))
+  } else if (ext === 'json') {
+    rows = normalizeJsonRecords(JSON.parse(new TextDecoder('utf-8').decode(buf)))
+  } else if (ext === 'xlsx' || ext === 'xls') {
+    const XLSX = await import('xlsx')
+    const wb = XLSX.read(new Uint8Array(buf), { type: 'array' })
+    const sheetName = wb.SheetNames[0]
+    const sheet = sheetName ? wb.Sheets[sheetName] : undefined
+    if (!sheet) throw new Error('Excel 文件中没有可读取的工作表')
+    rows = XLSX.utils.sheet_to_json(sheet, { defval: '', raw: false }) as Record<string, unknown>[]
+  } else {
+    throw new Error(`不支持的文件类型：.${ext}（仅支持 .csv / .json / .xlsx / .xls）`)
+  }
+
+  if (rows.length === 0) throw new Error('文件中没有可解析的数据行')
+
+  return { sourceName: name, columns: deriveColumns(rows), rows }
+}
diff --git a/openprint/src/design/utils/template-file.ts b/openprint/src/design/utils/template-file.ts
new file mode 100644
index 0000000..0b074c2
--- /dev/null
+++ b/openprint/src/design/utils/template-file.ts
@@ -0,0 +1,64 @@
+/**
+ * 模板文件导入 / 导出（B 功能，纯前端、零后端）。
+ * - 导出：把模板 JSON 序列化成 .json 文件下载到本地。
+ * - 导入：弹出文件选择框，读取并解析 .json 为 TemplateData（校验由调用方做）。
+ */
+import type { AnyControl } from '@/types/control'
+import type { TemplateData } from '@/types/template'
+
+/** 导出模板为 .json 文件并触发浏览器下载 */
+export function exportTemplateFile(data: TemplateData<AnyControl>, name: string): void {
+  const safe = (name || 'template').replace(/[\\/:*?"<>|]/g, '_').trim() || 'template'
+  const json = JSON.stringify(data, null, 2)
+  const blob = new Blob([json], { type: 'application/json' })
+  const url = URL.createObjectURL(blob)
+  const a = document.createElement('a')
+  a.href = url
+  a.download = `${safe}.json`
+  document.body.appendChild(a)
+  a.click()
+  document.body.removeChild(a)
+  // 释放对象 URL（延迟一帧，确保下载已开始）
+  setTimeout(() => URL.revokeObjectURL(url), 1000)
+}
+
+/** 打开文件选择框，读取用户选择的 .json 模板，解析为 TemplateData。取消 / 解析失败返回 null。 */
+export function importTemplateFile(): Promise<TemplateData<AnyControl> | null> {
+  return new Promise((resolve) => {
+    const input = document.createElement('input')
+    input.type = 'file'
+    input.accept = 'application/json,.json'
+    input.style.display = 'none'
+    const cleanup = () => {
+      input.removeEventListener('change', onChange)
+      window.removeEventListener('blur', onBlur)
+      if (input.parentNode) input.parentNode.removeChild(input)
+    }
+    const onChange = async () => {
+      const file = input.files?.[0]
+      cleanup()
+      if (!file) return resolve(null)
+      try {
+        const text = await file.text()
+        const data = JSON.parse(text) as TemplateData<AnyControl>
+        resolve(data)
+      } catch {
+        resolve(null)
+      }
+    }
+    // 用户取消选择（blur 且未触发 change）时兜底 reject，避免悬挂
+    const onBlur = () => {
+      // 延迟一点，确保 change 先触发
+      setTimeout(() => {
+        if (!input.files?.length) {
+          cleanup()
+          resolve(null)
+        }
+      }, 150)
+    }
+    input.addEventListener('change', onChange)
+    window.addEventListener('blur', onBlur, { once: true })
+    document.body.appendChild(input)
+    input.click()
+  })
+}
diff --git a/openprint/src/main.ts b/openprint/src/main.ts
new file mode 100644
index 0000000..d778fa7
--- /dev/null
+++ b/openprint/src/main.ts
@@ -0,0 +1,29 @@
+import 'virtual:uno.css'
+import './assets/main.css'
+import './theme/brand.css'
+
+import { createApp } from 'vue'
+import { createPinia } from 'pinia'
+
+import App from './App.vue'
+import { getBackendConfig } from './config/backend'
+import { createHttpRepository } from './repository/http-repo'
+import { createDataSourceHttp } from './repository/http-datasource'
+import { useDesignerStore } from './design/stores/designer'
+import { useDataSourceStore } from './design/stores/dataSource'
+
+const app = createApp(App)
+const pinia = createPinia()
+app.use(pinia)
+
+// 后端对接：仅当配置了 VITE_OPENPRINT_API_BASE 才切云端仓库；
+// 未配置时 designer 用 localStorage、dataSource 用内置 Mock（主任铁律：无后端全链路可用）。
+const backend = getBackendConfig()
+if (backend) {
+  const designerStore = useDesignerStore(pinia)
+  const dataSourceStore = useDataSourceStore(pinia)
+  designerStore.setRepository(createHttpRepository(backend.options), 'cloud')
+  dataSourceStore.setRepository(createDataSourceHttp(backend.options))
+}
+
+app.mount('#app')
diff --git a/openprint/src/repository/http-client.ts b/openprint/src/repository/http-client.ts
new file mode 100644
index 0000000..6e8cbd6
--- /dev/null
+++ b/openprint/src/repository/http-client.ts
@@ -0,0 +1,101 @@
+/**
+ * HttpClient —— 后端对接的底层 fetch 封装（《后端对接规范》§2.2 信封约定）
+ *
+ * - 统一列表信封 `{ items, total }` → 用 `list()` 直接取 items
+ * - 错误信封 `{ code, message, detail, requestId }` → 抛 HttpError（带 code/status/detail）
+ * - 204 No Content → 返回 null（删除接口适用）
+ * - JSON 请求/响应，自动注入 Bearer 鉴权头（配置了 token 时）
+ */
+export interface HttpOptions {
+  /** 基地址，如 https://print.example.com（结尾斜杠自动归一） */
+  baseUrl: string
+  /** 可选 Bearer token */
+  token?: string
+  /** 额外请求头（不与 Content-Type/Accept/Authorization 冲突） */
+  headers?: Record<string, string>
+}
+
+export interface ApiEnvelope<T> {
+  items: T[]
+  total: number
+}
+
+export interface ApiErrorBody {
+  code?: string
+  message?: string
+  detail?: unknown
+  requestId?: string
+}
+
+export class HttpError extends Error {
+  code?: string
+  status?: number
+  detail?: unknown
+  requestId?: string
+
+  constructor(message: string, init?: Partial<Omit<HttpError, 'message'>>) {
+    super(message)
+    this.name = 'HttpError'
+    if (init) Object.assign(this, init)
+  }
+}
+
+export class HttpClient {
+  private readonly baseUrl: string
+  private readonly token?: string
+  private readonly extraHeaders: Record<string, string>
+
+  constructor(opts: HttpOptions) {
+    this.baseUrl = opts.baseUrl.replace(/\/+$/, '')
+    this.token = opts.token
+    this.extraHeaders = opts.headers ?? {}
+  }
+
+  private buildHeaders(): Record<string, string> {
+    const headers: Record<string, string> = {
+      'Content-Type': 'application/json',
+      Accept: 'application/json',
+      ...this.extraHeaders,
+    }
+    if (this.token) headers['Authorization'] = `Bearer ${this.token}`
+    return headers
+  }
+
+  private async request<T>(path: string, init: RequestInit = {}): Promise<T | null> {
+    const url = `${this.baseUrl}${path}`
+    let res: Response
+    try {
+      res = await fetch(url, { ...init, headers: this.buildHeaders() })
+    } catch (e) {
+      throw new HttpError(`网络请求失败：${(e as Error).message}`, { status: 0 })
+    }
+
+    // 204 无 body（删除接口）
+    if (res.status === 204) return null
+
+    const text = await res.text()
+    const body = text.length > 0 ? (JSON.parse(text) as unknown) : null
+
+    if (!res.ok) {
+      const errBody = (body ?? {}) as ApiErrorBody
+      throw new HttpError(errBody.message || `请求失败（HTTP ${res.status}）`, {
+        code: errBody.code,
+        status: res.status,
+        detail: errBody.detail,
+        requestId: errBody.requestId,
+      })
+    }
+    return body as T
+  }
+
+  /** 详情 / 创建 / 更新：返回资源对象（或无内容时 null） */
+  async json<T>(path: string, init?: RequestInit): Promise<T | null> {
+    return this.request<T>(path, init)
+  }
+
+  /** 列表接口：解包 `{ items, total }` 信封，返回 items 数组 */
+  async list<T>(path: string, init?: RequestInit): Promise<T[]> {
+    const env = await this.request<ApiEnvelope<T>>(path, init)
+    return env?.items ?? []
+  }
+}
diff --git a/openprint/src/repository/http-datasource.ts b/openprint/src/repository/http-datasource.ts
new file mode 100644
index 0000000..102d176
--- /dev/null
+++ b/openprint/src/repository/http-datasource.ts
@@ -0,0 +1,27 @@
+/**
+ * createDataSourceHttp —— 云端数据源仓库（《后端对接规范》§4.2）
+ *
+ * 对接（只读元数据，无需写协议）：
+ *   GET /api/print/data-sources            → 数据源列表（含子表层级 tables）
+ *   GET /api/print/data-sources/{id}/fields → 字段定义列表（含每字段可选 sample）
+ *
+ * 与 createMockDataSource 同一 DataSourceRepository 接口，整体替换无分支。
+ */
+import { HttpClient, type HttpOptions } from './http-client'
+import type { DataSourceMeta, DataSourceRepository, FieldDef } from '@/types/datasource'
+
+const BASE = '/api/print/data-sources'
+
+export function createDataSourceHttp(opts: HttpOptions): DataSourceRepository {
+  const client = new HttpClient(opts)
+
+  return {
+    async listSources() {
+      return client.list<DataSourceMeta>(BASE)
+    },
+
+    async getFields(sourceId) {
+      return client.list<FieldDef>(`${BASE}/${encodeURIComponent(sourceId)}/fields`)
+    },
+  }
+}
diff --git a/openprint/src/repository/http-repo.ts b/openprint/src/repository/http-repo.ts
new file mode 100644
index 0000000..c64a038
--- /dev/null
+++ b/openprint/src/repository/http-repo.ts
@@ -0,0 +1,121 @@
+/**
+ * createHttpRepository —— 云端模板仓库（《后端对接规范》§4.1）
+ *
+ * 对接 `/api/print/templates`：
+ *   GET    /api/print/templates            → 列表（{items,total}，不含 content）
+ *   GET    /api/print/templates/{id}       → 详情（含 content，即 TemplateJSON 字符串）
+ *   POST   /api/print/templates            → 创建（201 + 真实 id）
+ *   PUT    /api/print/templates/{id}       → 全量更新（覆盖保存，200）
+ *   DELETE /api/print/templates/{id}       → 物理删除（204 无 body）
+ *
+ * 与 createLocalRepository 同一 TemplateRepository 接口，可无缝替换。
+ * content ⇄ TemplateData 互转：前端始终以 JSON 对象流转，落库为字符串（MEDIUMTEXT）原样往返。
+ */
+import { HttpClient, HttpError, type HttpOptions } from './http-client'
+import type { TemplateRecord, TemplateRepository, TemplateSummary } from './types'
+import type { AnyControl } from '@/types/control'
+import type { TemplateData } from '@/types/template'
+
+/** 后端返回的资源元信息（含运行时计算的 permissions，见 §2.6） */
+interface RawPermission {
+  editable?: boolean
+  deletable?: boolean
+  copyable?: boolean
+}
+
+interface RawSummary {
+  id: string
+  name: string
+  code?: string
+  category?: string
+  visibility?: 'public' | 'private'
+  createdBy?: string
+  createdAt?: string
+  updatedBy?: string
+  updatedAt?: string
+  permissions?: RawPermission
+}
+
+interface RawRecord extends RawSummary {
+  /** 模板内容（MEDIUMTEXT 字符串）；个别后端可能用 spec 字段名，两者兼容 */
+  content?: string
+  spec?: string
+  /** 若后端直接返回对象（未序列化为字符串）时的兜底 */
+  data?: TemplateData<AnyControl>
+}
+
+const BASE = '/api/print/templates'
+
+function parseData(raw: RawRecord): TemplateData<AnyControl> {
+  const content = raw.content ?? raw.spec
+  if (content) return JSON.parse(content) as TemplateData<AnyControl>
+  if (raw.data) return raw.data
+  throw new Error(`模板 ${raw.id} 缺少 content 字段`)
+}
+
+function mapSummary(r: RawSummary): TemplateSummary {
+  return {
+    id: r.id,
+    name: r.name,
+    editable: r.permissions?.editable ?? true,
+    deletable: r.permissions?.deletable ?? true,
+    updatedAt: r.updatedAt,
+  }
+}
+
+function mapRecord(r: RawRecord): TemplateRecord {
+  return {
+    id: r.id,
+    name: r.name,
+    editable: r.permissions?.editable ?? true,
+    deletable: r.permissions?.deletable ?? true,
+    updatedAt: r.updatedAt,
+    data: parseData(r),
+  }
+}
+
+export function createHttpRepository(opts: HttpOptions): TemplateRepository {
+  const client = new HttpClient(opts)
+
+  return {
+    async list() {
+      const items = await client.list<RawSummary>(BASE)
+      return items.map(mapSummary)
+    },
+
+    async get(id) {
+      const r = await client.json<RawRecord>(`${BASE}/${encodeURIComponent(id)}`)
+      if (!r) return null
+      return mapRecord(r)
+    },
+
+    async create(record) {
+      const r = await client.json<RawRecord>(BASE, {
+        method: 'POST',
+        body: JSON.stringify({
+          name: record.name,
+          // 仅存模板内容；visibility 等后端可按默认策略处理
+          content: JSON.stringify(record.data),
+        }),
+      })
+      if (!r) throw new HttpError('创建模板失败：后端未返回数据', { status: 201 })
+      return mapRecord(r)
+    },
+
+    async update(id, record) {
+      const body: Record<string, unknown> = {}
+      if (record.name !== undefined) body.name = record.name
+      if (record.data !== undefined) body.content = JSON.stringify(record.data)
+      const r = await client.json<RawRecord>(`${BASE}/${encodeURIComponent(id)}`, {
+        method: 'PUT',
+        body: JSON.stringify(body),
+      })
+      if (!r) throw new HttpError('更新模板失败：后端未返回数据', { status: 200 })
+      return mapRecord(r)
+    },
+
+    async remove(id) {
+      await client.json(`${BASE}/${encodeURIComponent(id)}`, { method: 'DELETE' })
+    },
+  }
+}
diff --git a/openprint/src/repository/local-repo.ts b/openprint/src/repository/local-repo.ts
new file mode 100644
index 0000000..7083de2
--- /dev/null
+++ b/openprint/src/repository/local-repo.ts
@@ -0,0 +1,87 @@
+/**
+ * createLocalRepository —— localStorage 模板仓库
+ *
+ * 未配置后端接口时的默认持久化实现（2026-08-08 主任定：无后端全链路可用）。
+ * 与未来 http-repo 同一 TemplateRepository 接口，可无缝替换。
+ *
+ * 存储结构：
+ * - `openprint:templates`        → TemplateSummary[]（列表索引）
+ * - `openprint:template:{id}`    → TemplateRecord（完整数据）
+ */
+import type { TemplateRecord, TemplateRepository, TemplateSummary } from './types'
+import { genId } from '@/utils/id'
+
+const INDEX_KEY = 'openprint:templates'
+const RECORD_PREFIX = 'openprint:template:'
+
+function readIndex(): TemplateSummary[] {
+  try {
+    return JSON.parse(localStorage.getItem(INDEX_KEY) ?? '[]') as TemplateSummary[]
+  } catch {
+    return []
+  }
+}
+
+function writeIndex(list: TemplateSummary[]): void {
+  localStorage.setItem(INDEX_KEY, JSON.stringify(list))
+}
+
+export function createLocalRepository(): TemplateRepository {
+  return {
+    async list() {
+      return readIndex()
+    },
+
+    async get(id) {
+      try {
+        const raw = localStorage.getItem(RECORD_PREFIX + id)
+        return raw ? (JSON.parse(raw) as TemplateRecord) : null
+      } catch {
+        return null
+      }
+    },
+
+    async create(record) {
+      const full: TemplateRecord = {
+        ...record,
+        id: genId('tpl'),
+        editable: true,
+        deletable: true,
+        updatedAt: new Date().toISOString(),
+      }
+      localStorage.setItem(RECORD_PREFIX + full.id, JSON.stringify(full))
+      const index = readIndex()
+      index.push({
+        id: full.id,
+        name: full.name,
+        editable: true,
+        deletable: true,
+        updatedAt: full.updatedAt,
+      })
+      writeIndex(index)
+      return full
+    },
+
+    async update(id, record) {
+      const existing = await this.get(id)
+      if (!existing) throw new Error(`模板不存在：${id}`)
+      const merged: TemplateRecord = {
+        ...existing,
+        ...record,
+        id,
+        updatedAt: new Date().toISOString(),
+      }
+      localStorage.setItem(RECORD_PREFIX + id, JSON.stringify(merged))
+      const index = readIndex().map((t) =>
+        t.id === id ? { ...t, name: merged.name, updatedAt: merged.updatedAt } : t,
+      )
+      writeIndex(index)
+      return merged
+    },
+
+    async remove(id) {
+      localStorage.removeItem(RECORD_PREFIX + id)
+      writeIndex(readIndex().filter((t) => t.id !== id))
+    },
+  }
+}
diff --git a/openprint/src/repository/mock/data/customer.ts b/openprint/src/repository/mock/data/customer.ts
new file mode 100644
index 0000000..b0c116d
--- /dev/null
+++ b/openprint/src/repository/mock/data/customer.ts
@@ -0,0 +1,26 @@
+import type { FieldDef, DataSourceMeta, TableMeta } from '@/types/datasource'
+
+export const CUSTOMER_TABLES: TableMeta[] = [
+  {
+    id: 'customer',
+    name: '客户档案',
+    relation: 'main',
+    pathPrefix: 'customer',
+  },
+]
+
+export const CUSTOMER_FIELDS: FieldDef[] = [
+  { path: 'customer.id',      label: '客户编号', type: 'string', tableId: 'customer', group: '基本信息', sort: 1,  sample: 'C001' },
+  { path: 'customer.name',    label: '客户名称', type: 'string', tableId: 'customer', group: '基本信息', sort: 2,  sample: '深圳某科技有限公司' },
+  { path: 'customer.phone',   label: '客户电话', type: 'string', tableId: 'customer', group: '联系方式', sort: 3,  sample: '0755-88888888' },
+  { path: 'customer.address', label: '客户地址', type: 'string', tableId: 'customer', group: '联系方式', sort: 4,  sample: '深圳市南山区' },
+  { path: 'customer.contact', label: '联系人',   type: 'string', tableId: 'customer', group: '联系方式', sort: 5,  sample: '李明' },
+  { path: 'customer.balance', label: '账户余额', type: 'number', tableId: 'customer', group: '金额信息', sort: 10, sample: 150000.00 },
+]
+
+export const CUSTOMER_META: DataSourceMeta = {
+  id: 'customer',
+  name: '客户档案',
+  description: '内置演示数据源',
+  tables: CUSTOMER_TABLES,
+}
diff --git a/openprint/src/repository/mock/data/demo-template.spec.ts b/openprint/src/repository/mock/data/demo-template.spec.ts
new file mode 100644
index 0000000..7c4744f
--- /dev/null
+++ b/openprint/src/repository/mock/data/demo-template.spec.ts
@@ -0,0 +1,44 @@
+import { describe, expect, it } from 'vitest'
+
+import {
+  createDemoTemplate,
+  DEMO_CONTENT_WIDTH,
+} from '@/repository/mock/data/demo-template'
+
+describe('createDemoTemplate —— 示例模板结构校验', () => {
+  const t = createDemoTemplate()
+
+  it('A4 纵向页面（210×297mm）', () => {
+    expect(t.document.page.width).toBe(210)
+    expect(t.document.page.height).toBe(297)
+    expect(t.document.page.unit).toBe('mm')
+  })
+
+  it('正文含明细表，绑定数据源 items', () => {
+    const body = t.document.sections.find((s) => s.type === 'body')
+    expect(body).toBeDefined()
+    const table = (body!.components as unknown as Array<Record<string, unknown>>).find((c) => c.type === 'table')
+    expect(table).toBeDefined()
+    expect(table!.dataSource).toBe('items')
+  })
+
+  it('明细表含合计行', () => {
+    const body = t.document.sections.find((s) => s.type === 'body')
+    const table = (body!.components as unknown as Array<Record<string, unknown>>).find((c) => c.type === 'table')
+    expect((table!.options as { summaryRow?: unknown })?.summaryRow).toBeTruthy()
+  })
+
+  it('明细表列宽之和 = 内容区宽度', () => {
+    const body = t.document.sections.find((s) => s.type === 'body')
+    const table = (body!.components as unknown as Array<Record<string, unknown>>).find((c) => c.type === 'table')
+    const cols = table!.columns as Array<{ width?: number }>
+    const sum = cols.reduce((s, c) => s + (c.width ?? 0), 0)
+    expect(sum).toBe(DEMO_CONTENT_WIDTH)
+  })
+
+  it('页眉页脚分区存在', () => {
+    const types = t.document.sections.map((s) => s.type)
+    expect(types).toContain('header')
+    expect(types).toContain('footer')
+  })
+})
diff --git a/openprint/src/repository/mock/data/demo-template.ts b/openprint/src/repository/mock/data/demo-template.ts
new file mode 100644
index 0000000..f7a104d
--- /dev/null
+++ b/openprint/src/repository/mock/data/demo-template.ts
@@ -0,0 +1,187 @@
+/**
+ * 内置示例模板 —— 销售出库单
+ *
+ * 用途有二：
+ * 1. 新用户打开设计器就有一张能用的真单据，而不是空白画布 + "该从哪下手"
+ * 2. Phase 7 分页引擎的活体验收：明细行调到 30+ 行必然跨页，
+ *    可直接检查「表头每页重复 / 页眉页脚每页出现 / 合计只在末页 / 页码正确」
+ *
+ * 坐标全部 mm，相对所属 section 左上角（协议约定）。
+ * A4 纵向 210×297，左右边距 12 → 内容区宽 186，所有横向元素按 186 对齐。
+ */
+import type { AnyControl } from '@/types/control'
+import type { TemplateData } from '@/types/template'
+
+const CONTENT_W = 186
+
+/** 内容区宽度，表格列宽之和必须等于它，否则会被等比归一化 */
+export const DEMO_CONTENT_WIDTH = CONTENT_W
+
+export const DEMO_TEMPLATE_NAME = '销售出库单（示例）'
+
+export function createDemoTemplate(): TemplateData<AnyControl> {
+  const header: AnyControl[] = [
+    {
+      id: 'hd-company',
+      type: 'text',
+      left: 0,
+      top: 0,
+      width: 100,
+      height: 6,
+      value: '深圳某某科技有限公司',
+      style: { fontSize: 10, fontWeight: 'bold', fill: '#333333' },
+      printable: true,
+    },
+    {
+      id: 'hd-title',
+      type: 'text',
+      left: 0,
+      top: 7,
+      width: CONTENT_W,
+      height: 11,
+      value: '销售出库单',
+      style: { fontSize: 18, fontWeight: 'bold', textAlign: 'center' },
+      printable: true,
+    },
+    {
+      id: 'hd-barcode',
+      type: 'barcode',
+      left: 140,
+      top: 0,
+      width: 46,
+      height: 12,
+      binding: 'order.orderNo',
+      format: 'code128',
+      showText: false,
+      printable: true,
+    },
+    {
+      id: 'hd-rule',
+      type: 'line',
+      left: 0,
+      top: 21,
+      width: CONTENT_W,
+      height: 0,
+      stroke: '#333333',
+      strokeWidth: 1,
+      printable: true,
+    },
+  ]
+
+  const body: AnyControl[] = [
+    /* ── 单据头：仅第 1 页 ── */
+    txt('bd-no', 0, 0, 62, 6, '单号：{{order.orderNo}}'),
+    txt('bd-date', 62, 0, 62, 6, '日期：{{order.orderDate}}'),
+    txt('bd-salesman', 124, 0, 62, 6, '业务员：{{order.salesman}}'),
+    txt('bd-cust', 0, 7, 92, 6, '客户：{{customer.name}}'),
+    txt('bd-contact', 92, 7, 94, 6, '联系人：{{customer.contact}}　电话：{{customer.phone}}'),
+    txt('bd-addr', 0, 14, CONTENT_W, 6, '收货地址：{{customer.address}}'),
+
+    /* ── 明细表：驱动分页 ── */
+    {
+      id: 'bd-table',
+      type: 'table',
+      left: 0,
+      top: 23,
+      width: CONTENT_W,
+      height: 60,
+      dataSource: 'items',
+      printable: true,
+      columns: [
+        { title: '序号', expression: '{{rowIndex + 1}}', width: 14, align: 'center', headerAlign: 'center' },
+        { title: '商品编码', field: 'productCode', width: 26, align: 'left', headerAlign: 'center' },
+        { title: '商品名称', field: 'productName', width: 58, align: 'left', headerAlign: 'center' },
+        { title: '规格型号', field: 'spec', width: 34, align: 'left', headerAlign: 'center' },
+        { title: '单位', field: 'unit', width: 12, align: 'center', headerAlign: 'center' },
+        { title: '数量', field: 'qty', width: 12, align: 'right', headerAlign: 'center' },
+        { title: '单价', field: 'price', width: 14, align: 'right', headerAlign: 'center' },
+        { title: '金额', field: 'amount', width: 16, align: 'right', headerAlign: 'center' },
+      ],
+      options: {
+        repeatHeader: true,
+        // 合计只在最后一页出现（ERP 惯例），同时验证 repeatFooter=false 分支
+        repeatFooter: false,
+        pageRows: 'auto',
+        rowHeightMode: 'auto',
+        borders: 'all',
+        striped: true,
+        verticalAlign: 'middle',
+        summaryRow: { type: 'sum', fields: ['qty', 'amount'], label: '合计' },
+      },
+    },
+
+    /* ── 单据尾：随表格实际底边下移，只在末页 ── */
+    txt('bd-total', 0, 85, CONTENT_W, 7, '合计金额（大写）：{{order.total | currency:"CNY"}}', {
+      fontSize: 11,
+      fontWeight: 'bold',
+    }),
+    txt('bd-memo', 0, 93, 120, 6, '备注：{{order.memo}}', { fontSize: 9, fill: '#555555' }),
+    txt('bd-sign', 0, 103, CONTENT_W, 6, '制单人：{{order.salesman}}　　审核：＿＿＿＿　　仓管：＿＿＿＿　　客户签收：＿＿＿＿', {
+      fontSize: 9,
+    }),
+  ]
+
+  const footer: AnyControl[] = [
+    {
+      id: 'ft-rule',
+      type: 'line',
+      left: 0,
+      top: 1,
+      width: CONTENT_W,
+      height: 0,
+      stroke: '#999999',
+      strokeWidth: 0.5,
+      printable: true,
+    },
+    txt('ft-brand', 0, 3, 90, 6, '本单据由 OpenPrint 生成', { fontSize: 8, fill: '#888888' }),
+    txt('ft-page', 96, 3, 90, 6, '第 {{page}} 页 / 共 {{pages}} 页', {
+      fontSize: 9,
+      textAlign: 'right',
+      fill: '#555555',
+    }),
+  ]
+
+  return {
+    version: '1.0',
+    document: {
+      type: 'report',
+      page: {
+        width: 210,
+        height: 297,
+        unit: 'mm',
+        orientation: 'portrait',
+        margin: { top: 12, right: 12, bottom: 10, left: 12 },
+      },
+      sections: [
+        { type: 'header', height: 24, repeat: true, components: header },
+        { type: 'body', components: body },
+        { type: 'footer', height: 12, repeat: true, components: footer },
+      ],
+    },
+  }
+}
+
+/* -------------------------------- 小工具 -------------------------------- */
+
+function txt(
+  id: string,
+  left: number,
+  top: number,
+  width: number,
+  height: number,
+  value: string,
+  style: NonNullable<Extract<AnyControl, { type: 'text' }>['style']> = {},
+): AnyControl {
+  return {
+    id,
+    type: 'text',
+    left,
+    top,
+    width,
+    height,
+    value,
+    printable: true,
+    // 示例模板默认思源黑体（与内置字体包一致），调用方可覆盖
+    style: { fontSize: 10, fontFamily: '思源黑体', ...style },
+  }
+}
diff --git a/openprint/src/repository/mock/data/market-templates.spec.ts b/openprint/src/repository/mock/data/market-templates.spec.ts
new file mode 100644
index 0000000..d6f3698
--- /dev/null
+++ b/openprint/src/repository/mock/data/market-templates.spec.ts
@@ -0,0 +1,66 @@
+import { describe, it, expect } from 'vitest'
+import { MARKET_TEMPLATES } from './market-templates'
+import { render } from '@/core/sdk'
+import type { AnyControl, TableControl, ChartControl } from '@/types/control'
+
+function findTemplate(id: string) {
+  const t = MARKET_TEMPLATES.find((t) => t.id === id)
+  if (!t) throw new Error(`template ${id} not found`)
+  return t
+}
+
+function bodyControls(id: string): AnyControl[] {
+  const tpl = findTemplate(id).build()
+  const body = tpl.document.sections.find((s) => s.type === 'body')
+  if (!body) throw new Error('no body section')
+  return body.components
+}
+
+describe('market-financial-report 模板', () => {
+  it('在模板市场中存在且为 A4', () => {
+    const t = findTemplate('market-financial-report')
+    expect(t.category).toBe('report')
+    expect(t.pageW).toBe(210)
+    expect(t.pageH).toBe(297)
+  })
+
+  it('包含 4 张 KPI 指标卡 + 3 张图表 + 1 张明细表', () => {
+    const c = bodyControls('market-financial-report')
+    const rects = c.filter((x) => x.type === 'rect')
+    const charts = c.filter((x) => x.type === 'chart') as ChartControl[]
+    const tables = c.filter((x) => x.type === 'table') as TableControl[]
+    // 4 张 KPI 卡各 2 个色块（底 + 顶条）= 8，外加说明框 = 9
+    expect(rects.length).toBeGreaterThanOrEqual(9)
+    // bar / pie / line
+    expect(charts.map((ch) => ch.kind).sort()).toEqual(['bar', 'line', 'pie'])
+    expect(tables.length).toBe(1)
+  })
+
+  it('明细表内嵌数据 + 自定义合计（含衍生利润率）', () => {
+    const c = bodyControls('market-financial-report')
+    const table = c.find((x) => x.type === 'table') as TableControl
+    expect(table.data).toBeDefined()
+    expect(table.data!.length).toBe(5)
+    expect(table.options?.summaryRow?.type).toBe('custom')
+    // 营收合计应为 5 个分部之和
+    const rows = table.data ?? []
+    const sumRevenue = rows.reduce((s, r) => s + (r.revenue as number), 0)
+    expect(sumRevenue).toBe(12860)
+    // 净利润 KPI 与图表数据自洽：bar 营收序列合计 = 12860
+    const bar = c.find((x) => x.type === 'chart' && x.kind === 'bar') as ChartControl
+    expect(bar.series[0]!.data.reduce((a, b) => a + b, 0)).toBe(12860)
+  })
+
+  it('端到端渲染为单页，且含合计行与图表 SVG', async () => {
+    const tpl = findTemplate('market-financial-report').build()
+    const { html, pages, warnings } = await render({ template: tpl })
+    // 单页报表 → 打印管线走 SVG 单页推送
+    expect(pages).toBe(1)
+    expect(html).toContain('合计')
+    // 三张图表均输出 SVG
+    expect((html.match(/<svg/g) ?? []).length).toBeGreaterThanOrEqual(3)
+    // 不应有"数据源非数组"类告警（明细表用内嵌 data，不依赖 dataSource）
+    const fatal = warnings.filter((w) => w.code === 'DATASOURCE_NOT_ARRAY')
+    expect(fatal).toEqual([])
+  })
+})
diff --git a/openprint/src/repository/mock/data/market-templates.ts b/openprint/src/repository/mock/data/market-templates.ts
new file mode 100644
index 0000000..0fda680
--- /dev/null
+++ b/openprint/src/repository/mock/data/market-templates.ts
@@ -0,0 +1,889 @@
+/**
+ * 模板市场预设数据 —— 常用 A4 单据 / 小票 / 热敏面单 / 标签（含二维码）
+ *
+ * 设计约定：
+ * - 内容以**静态文本**为主（不绑定数据源），保证用户点击即可用、所见即所得；
+ *   需要真实数据时再自行替换为绑定/表达式。
+ * - 二维码控件为静态 value（qrcode 库直接编码，画布/渲染开箱即用）。
+ * - 坐标全部 mm，相对所属 section 左上角（协议约定）。
+ */
+import type {
+  AnyControl,
+  BarcodeControl,
+  ChartControl,
+  QrcodeControl,
+  RectControl,
+  TableColumn,
+  TableControl,
+  TableOptions,
+  TextControl,
+} from '@/types/control'
+import type { PageMargin, PageSetup, Section, TemplateData } from '@/types/template'
+import { createDemoTemplate } from './demo-template'
+
+/* ------------------------------- 类型 ------------------------------- */
+
+export type MarketCategory = 'invoice' | 'report' | 'receipt' | 'thermal' | 'label'
+
+export interface MarketTemplate {
+  id: string
+  name: string
+  category: MarketCategory
+  desc: string
+  /** 纸张尺寸标签（市场卡片展示） */
+  sizeLabel: string
+  /** 纸张宽高（mm，卡片缩略图用，避免渲染时反复 build） */
+  pageW: number
+  pageH: number
+  build: () => TemplateData<AnyControl>
+}
+
+export const MARKET_CATEGORY_LABEL: Record<MarketCategory, string> = {
+  invoice: '单据',
+  report: '报表',
+  receipt: '小票',
+  thermal: '热敏',
+  label: '标签',
+}
+
+/* ------------------------------- helpers ------------------------------- */
+
+function paper(
+  width: number,
+  height: number,
+  margin: Partial<PageMargin> = {},
+  orientation: 'portrait' | 'landscape' = 'portrait',
+): PageSetup {
+  return {
+    width,
+    height,
+    unit: 'mm',
+    orientation,
+    margin: { top: 10, right: 10, bottom: 10, left: 10, ...margin },
+  }
+}
+
+function build(page: PageSetup, sections: Section<AnyControl>[]): TemplateData<AnyControl> {
+  return { version: '1.0', document: { type: 'report', page, sections } }
+}
+
+/** 只有正文区（小票/标签类） */
+function bodyOnly(page: PageSetup, components: AnyControl[]): TemplateData<AnyControl> {
+  return build(page, [{ type: 'body', components }])
+}
+
+/** 页眉 + 正文 + 页脚（单据类） */
+function fullPage(
+  page: PageSetup,
+  header: AnyControl[],
+  body: AnyControl[],
+  footer: AnyControl[] = [],
+): TemplateData<AnyControl> {
+  const sections: Section<AnyControl>[] = [
+    { type: 'header', height: 24, repeat: true, components: header },
+    { type: 'body', components: body },
+  ]
+  if (footer.length) sections.push({ type: 'footer', height: 12, repeat: true, components: footer })
+  return build(page, sections)
+}
+
+function txt(
+  id: string,
+  left: number,
+  top: number,
+  width: number,
+  height: number,
+  value: string,
+  style: NonNullable<TextControl['style']> = {},
+): AnyControl {
+  return {
+    id,
+    type: 'text',
+    left,
+    top,
+    width,
+    height,
+    value,
+    printable: true,
+    // 市场模板默认思源黑体（正式单据感），调用方可覆盖
+    style: { fontSize: 10, fontFamily: '思源黑体', ...style },
+  }
+}
+
+function rule(id: string, left: number, top: number, width: number, stroke = '#333333', strokeWidth = 1): AnyControl {
+  return { id, type: 'line', left, top, width, height: 0, stroke, strokeWidth, printable: true }
+}
+
+function barcode(id: string, left: number, top: number, width: number, height: number, value: string): BarcodeControl {
+  return { id, type: 'barcode', left, top, width, height, value, format: 'CODE128', showText: true, printable: true }
+}
+
+function qrcode(id: string, left: number, top: number, width: number, height: number, value: string): QrcodeControl {
+  return { id, type: 'qrcode', left, top, width, height, value, errorLevel: 'M', printable: true }
+}
+
+/** 圆角色块（KPI 卡片底 / 色条 / 分区标题条） */
+function box(
+  id: string,
+  left: number,
+  top: number,
+  width: number,
+  height: number,
+  fill: string,
+  stroke?: string,
+  cornerRadius = 4,
+): AnyControl {
+  const rect: RectControl = {
+    id,
+    type: 'rect',
+    left,
+    top,
+    width,
+    height,
+    fill,
+    cornerRadius,
+    shape: 'rect',
+    printable: true,
+  }
+  if (stroke) {
+    rect.stroke = stroke
+    rect.strokeWidth = 0.6
+  }
+  return rect
+}
+
+/** 图表控件（chartkit 原生 SVG，导出 PDF 走矢量） */
+function chart(
+  id: string,
+  left: number,
+  top: number,
+  width: number,
+  height: number,
+  kind: ChartControl['kind'],
+  categories: string[],
+  series: ChartControl['series'],
+  options: ChartControl['options'] = {},
+): AnyControl {
+  return {
+    id,
+    type: 'chart',
+    left,
+    top,
+    width,
+    height,
+    kind,
+    categories,
+    series,
+    printable: true,
+    options: {
+      showLegend: true,
+      showAxis: true,
+      showGrid: true,
+      labelAlign: 'center',
+      ...options,
+    },
+  }
+}
+
+function table(
+  id: string,
+  left: number,
+  top: number,
+  width: number,
+  height: number,
+  columns: TableColumn[],
+  options: TableOptions = {},
+): AnyControl {
+  return {
+    id,
+    type: 'table',
+    left,
+    top,
+    width,
+    height,
+    columns,
+    printable: true,
+    options: {
+      repeatHeader: true,
+      pageRows: 'auto',
+      rowHeightMode: 'auto',
+      borders: 'all',
+      verticalAlign: 'middle',
+      ...options,
+    },
+  }
+}
+
+/**
+ * 精美财务分析报表（A4）。
+ * 结构：页眉（公司 + 大标题 + 报告期）→ 4 张 KPI 指标卡 → 三张矢量图表
+ * （月度营收柱状 / 营收构成环形 / 月度净利润折线）→ 分部经营明细表（内嵌数据自带合计）
+ * → 页脚。所有数据均为静态示例，开箱即用无需绑定数据源。
+ */
+function buildFinancialReport(): TemplateData<AnyControl> {
+  const w = 186
+
+  /* —— 页眉 —— */
+  const header: AnyControl[] = [
+    txt('fr-co', 0, 0, 130, 6, '深圳某某集团股份有限公司', { fontSize: 10, fontWeight: 'bold', fill: '#1677ff' }),
+    txt('fr-title', 0, 7, w, 11, '2026 年上半年财务分析报表', { fontSize: 18, fontWeight: 'bold', textAlign: 'center' }),
+    txt('fr-period', 0, 19, w, 5, '报告期：2026-01-01 ~ 2026-06-30　　币种：人民币 / 万元', {
+      fontSize: 9,
+      textAlign: 'center',
+      fill: '#555555',
+    }),
+    rule('fr-rule', 0, 22, w, '#1677ff', 1),
+  ]
+
+  /* —— 4 张 KPI 指标卡 —— */
+  const cardW = 43
+  const cardGap = 4
+  const cardTop = 0
+  const cardH = 26
+  const cardX = [1, 1 + (cardW + cardGap), 1 + 2 * (cardW + cardGap), 1 + 3 * (cardW + cardGap)]
+  const cardAccent = ['#1677ff', '#52c41a', '#13c2c2', '#fa8c16']
+  const cardLabel = ['营业收入', '营业利润', '经营现金流', '营收同比增长']
+  const cardValue = ['12,860', '4,300', '3,420', '+18.6%']
+  const cardUnit = ['万元', '万元', '万元', '同比']
+  const cards: AnyControl[] = []
+  for (let i = 0; i < 4; i++) {
+    const x = cardX[i]!
+    const accent = cardAccent[i]!
+    const label = cardLabel[i]!
+    const value = cardValue[i]!
+    const unit = cardUnit[i]!
+    cards.push(box(`fr-kpi-${i}-bg`, x, cardTop, cardW, cardH, '#ffffff', '#e8e8e8', 4))
+    cards.push(box(`fr-kpi-${i}-bar`, x, cardTop, cardW, 5, accent, undefined, 4))
+    cards.push(txt(`fr-kpi-${i}-lbl`, x + 3, cardTop + 8, cardW - 6, 5, label, {
+      fontSize: 8,
+      fill: '#666666',
+    }))
+    cards.push(txt(`fr-kpi-${i}-val`, x + 3, cardTop + 12, cardW - 6, 9, value, {
+      fontSize: 16,
+      fontWeight: 'bold',
+      fill: accent,
+    }))
+    cards.push(txt(`fr-kpi-${i}-unit`, x + 3, cardTop + 21, cardW - 6, 4, unit, {
+      fontSize: 8,
+      fill: '#999999',
+    }))
+  }
+
+  /* —— 图表标题 —— */
+  const chartTop = 32
+  cards.push(txt('fr-chart-title', 0, chartTop - 2, w, 5, '二、经营分析', { fontSize: 11, fontWeight: 'bold', fill: '#333333' }))
+
+  /* —— 三张矢量图表 —— */
+  const chartH = 70
+  const barW = 88
+  const sideW = 47
+  const donutX = barW + 4
+  const lineX = barW + 4 + sideW + 4
+  const charts: AnyControl[] = [
+    chart('fr-bar', 0, chartTop, barW, chartH, 'bar', ['1月', '2月', '3月', '4月', '5月', '6月'], [
+      { name: '营收', data: [1980, 2100, 2240, 2050, 2180, 2310], color: '#1677ff' },
+    ], { title: '月度营收（万元）', showLegend: false, showAxis: true, showGrid: true, valueLabel: true, palette: ['#1677ff'] }),
+    chart('fr-donut', donutX, chartTop, sideW, chartH, 'pie', ['华东', '华南', '华北', '西南', '海外'], [
+      { name: '营收构成', data: [4860, 3260, 2510, 1430, 800] },
+    ], {
+      title: '营收构成',
+      donut: true,
+      showLegend: true,
+      showAxis: false,
+      showGrid: false,
+      valueLabel: false,
+      palette: ['#1677ff', '#52c41a', '#13c2c2', '#fa8c16', '#9254de'],
+    }),
+    chart('fr-line', lineX, chartTop, sideW, chartH, 'line', ['1月', '2月', '3月', '4月', '5月', '6月'], [
+      { name: '净利润', data: [300, 330, 360, 340, 360, 490], color: '#fa8c16' },
+    ], {
+      title: '月度净利润',
+      showLegend: false,
+      smooth: true,
+      area: true,
+      showAxis: true,
+      showGrid: true,
+      valueLabel: true,
+      palette: ['#fa8c16'],
+    }),
+  ]
+
+  /* —— 分部经营明细表（内嵌数据 + 合计） —— */
+  const tableTop = chartTop + chartH + 8
+  const detailRows: Array<Record<string, unknown>> = [
+    { name: '华东大区', revenue: 4860, cost: 3120, profit: 1740, margin: 0.358 },
+    { name: '华南大区', revenue: 3260, cost: 2180, profit: 1080, margin: 0.331 },
+    { name: '华北大区', revenue: 2510, cost: 1760, profit: 750, margin: 0.299 },
+    { name: '西南大区', revenue: 1430, cost: 980, profit: 450, margin: 0.315 },
+    { name: '海外事业部', revenue: 800, cost: 520, profit: 280, margin: 0.35 },
+  ]
+  const detailTable: TableControl = {
+    id: 'fr-detail',
+    type: 'table',
+    left: 0,
+    top: tableTop,
+    width: w,
+    height: 56,
+    printable: true,
+    data: detailRows,
+    columns: [
+      { title: '分部', field: 'name', width: 40, align: 'left', headerAlign: 'center' },
+      { title: '营收（万元）', field: 'revenue', width: 36, align: 'right', headerAlign: 'center', format: { kind: 'int' } },
+      { title: '成本（万元）', field: 'cost', width: 36, align: 'right', headerAlign: 'center', format: { kind: 'int' } },
+      { title: '利润（万元）', field: 'profit', width: 34, align: 'right', headerAlign: 'center', format: { kind: 'int' } },
+      { title: '利润率', field: 'margin', width: 40, align: 'right', headerAlign: 'center', format: { kind: 'percent', digits: 1 } },
+    ],
+    options: {
+      repeatHeader: true,
+      pageRows: 'auto',
+      rowHeightMode: 'auto',
+      borders: 'three-line',
+      tableStyle: 'report',
+      verticalAlign: 'middle',
+      summaryRow: {
+        type: 'custom',
+        fields: ['revenue', 'cost', 'profit', 'margin'],
+        label: '合计',
+        expressions: {
+          revenue: 'sum.revenue',
+          cost: 'sum.cost',
+          profit: 'sum.profit',
+          margin: 'sum.profit / sum.revenue',
+        },
+      },
+    },
+  }
+
+  /* —— 说明 —— */
+  const noteTop = tableTop + 56 + 6
+  const notes: AnyControl[] = [
+    box('fr-note-bg', 0, noteTop, w, 22, '#fafafa', '#e8e8e8', 4),
+    txt('fr-note-title', 4, noteTop + 3, w - 8, 5, '指标说明', { fontSize: 9, fontWeight: 'bold', fill: '#333333' }),
+    txt(
+      'fr-note-1',
+      4,
+      noteTop + 9,
+      w - 8,
+      4,
+      '1）金额单位均为万元；2）营业利润 = 营收 − 成本（分部合计 4,300 万元）；',
+      { fontSize: 8, fill: '#555555' },
+    ),
+    txt(
+      'fr-note-2',
+      4,
+      noteTop + 14,
+      w - 8,
+      4,
+      '3）净利润 2,180 万元（归母净利润，已扣所得税及少数股东损益）；4）增长率对比 2025 年同期。',
+      { fontSize: 8, fill: '#555555' },
+    ),
+  ]
+
+  const body: AnyControl[] = [...cards, ...charts, detailTable, ...notes]
+
+  /* —— 页脚 —— */
+  const footer: AnyControl[] = [
+    txt('fr-brand', 0, 3, 90, 6, '本报表由 OpenPrint 生成', { fontSize: 8, fill: '#888888' }),
+    txt('fr-page', 96, 3, 90, 6, '第 {{page}} 页 / 共 {{pages}} 页', { fontSize: 9, textAlign: 'right', fill: '#555555' }),
+  ]
+
+  return fullPage(paper(210, 297), header, body, footer)
+}
+
+/* ------------------------------ 模板定义 ------------------------------ */
+
+export const MARKET_TEMPLATES: MarketTemplate[] = [
+  /* ============ 单据（A4 / A5） ============ */
+  {
+    id: 'market-sale-order',
+    name: '销售出库单',
+    category: 'invoice',
+    desc: 'A4 标准销售出库单：单据头 + 商品明细表 + 合计 + 签收栏，表头每页重复',
+    sizeLabel: 'A4 · 210×297',
+    pageW: 210,
+    pageH: 297,
+    build: createDemoTemplate,
+  },
+  {
+    id: 'market-purchase-order',
+    name: '采购入库单',
+    category: 'invoice',
+    desc: 'A4 采购入库单：供应商信息 + 到货明细表 + 验收签收栏',
+    sizeLabel: 'A4 · 210×297',
+    pageW: 210,
+    pageH: 297,
+    build: () => {
+      const w = 186
+      const header: AnyControl[] = [
+        txt('pch-co', 0, 0, 120, 6, '深圳市某某制造有限公司', { fontSize: 10, fontWeight: 'bold', fill: '#333333' }),
+        txt('pch-title', 0, 7, w, 11, '采 购 入 库 单', { fontSize: 18, fontWeight: 'bold', textAlign: 'center' }),
+        rule('pch-rule', 0, 21, w),
+      ]
+      const body: AnyControl[] = [
+        txt('pch-no', 0, 0, 62, 6, '单据号：CG-2026-0001'),
+        txt('pch-date', 62, 0, 62, 6, '入库日期：2026-08-08'),
+        txt('pch-wh', 124, 0, 62, 6, '仓库：一号仓'),
+        txt('pch-supplier', 0, 7, 92, 6, '供应商：深圳市某某电子有限公司'),
+        txt('pch-contact', 92, 7, 94, 6, '联系人：张先生　电话：0755-8888 6666'),
+        txt('pch-addr', 0, 14, w, 6, '送货地址：宝安区某某工业园 A 栋'),
+        table('pch-tbl', 0, 23, w, 60, [
+          { title: '序号', expression: '{{rowIndex + 1}}', width: 14, align: 'center', headerAlign: 'center' },
+          { title: '物料编码', field: 'productCode', width: 26, align: 'left', headerAlign: 'center' },
+          { title: '物料名称', field: 'productName', width: 58, align: 'left', headerAlign: 'center' },
+          { title: '规格型号', field: 'spec', width: 34, align: 'left', headerAlign: 'center' },
+          { title: '单位', field: 'unit', width: 12, align: 'center', headerAlign: 'center' },
+          { title: '数量', field: 'qty', width: 14, align: 'right', headerAlign: 'center' },
+          { title: '单价', field: 'price', width: 14, align: 'right', headerAlign: 'center' },
+          { title: '金额', field: 'amount', width: 14, align: 'right', headerAlign: 'center' },
+        ]),
+        txt('pch-total', 0, 85, w, 7, '合计金额（大写）：叁万捌仟陆佰元整', { fontSize: 11, fontWeight: 'bold' }),
+        txt('pch-memo', 0, 93, w, 6, '备注：本单须经仓库验收确认后方可入库', { fontSize: 9, fill: '#555555' }),
+        txt('pch-sign', 0, 103, w, 6, '验收：＿＿＿＿　　仓管：＿＿＿＿　　采购：＿＿＿＿　　制单：＿＿＿＿', { fontSize: 9 }),
+      ]
+      const footer: AnyControl[] = [
+        txt('pch-brand', 0, 3, 90, 6, '本单据由 OpenPrint 生成', { fontSize: 8, fill: '#888888' }),
+        txt('pch-page', 96, 3, 90, 6, '第 {{page}} 页 / 共 {{pages}} 页', { fontSize: 9, textAlign: 'right', fill: '#555555' }),
+      ]
+      return fullPage(paper(210, 297), header, body, footer)
+    },
+  },
+  {
+    id: 'market-quotation',
+    name: '报价单',
+    category: 'invoice',
+    desc: 'A4 报价单：客户抬头 + 报价明细 + 有效期与条款说明',
+    sizeLabel: 'A4 · 210×297',
+    pageW: 210,
+    pageH: 297,
+    build: () => {
+      const w = 186
+      const header: AnyControl[] = [
+        txt('qt-co', 0, 0, 100, 6, '深圳市某某科技有限公司', { fontSize: 11, fontWeight: 'bold', fill: '#1677ff' }),
+        barcode('qt-bc', 140, 0, 46, 12, 'QUO-2026-0801'),
+        txt('qt-title', 0, 14, w, 10, '报 价 单', { fontSize: 16, fontWeight: 'bold', textAlign: 'center' }),
+        rule('qt-rule', 0, 22, w, '#1677ff', 1),
+      ]
+      const body: AnyControl[] = [
+        txt('qt-cust', 0, 0, w, 6, '致：某某采购中心　　联系人：李经理　　电话：0755-1234 5678'),
+        txt('qt-no', 0, 7, w, 6, '报价单号：QUO-2026-0801　　报价日期：2026-08-08　　有效期：30 天'),
+        table('qt-tbl', 0, 16, w, 70, [
+          { title: '序号', expression: '{{rowIndex + 1}}', width: 12, align: 'center', headerAlign: 'center' },
+          { title: '产品名称', field: 'productName', width: 56, align: 'left', headerAlign: 'center' },
+          { title: '规格型号', field: 'spec', width: 30, align: 'left', headerAlign: 'center' },
+          { title: '单位', field: 'unit', width: 12, align: 'center', headerAlign: 'center' },
+          { title: '数量', field: 'qty', width: 14, align: 'right', headerAlign: 'center' },
+          { title: '单价（元）', field: 'price', width: 22, align: 'right', headerAlign: 'center' },
+          { title: '小计（元）', field: 'amount', width: 24, align: 'right', headerAlign: 'center' },
+          { title: '备注', field: 'memo', width: 16, align: 'left', headerAlign: 'center' },
+        ]),
+        txt('qt-total', 0, 88, w, 7, '合计金额（不含税）：￥38,600.00', { fontSize: 11, fontWeight: 'bold', textAlign: 'right' }),
+        txt('qt-terms', 0, 97, w, 6, '付款方式：月结 30 天；交货周期：收到订单后 7 个工作日内', { fontSize: 9, fill: '#555555' }),
+        txt('qt-note', 0, 104, w, 6, '以上报价含税 13%，如需开票请在下单时说明开票信息。', { fontSize: 9, fill: '#555555' }),
+      ]
+      const footer: AnyControl[] = [
+        txt('qt-page', 96, 3, 90, 6, '第 {{page}} 页 / 共 {{pages}} 页', { fontSize: 9, textAlign: 'right', fill: '#555555' }),
+      ]
+      return fullPage(paper(210, 297), header, body, footer)
+    },
+  },
+  {
+    id: 'market-delivery-order',
+    name: '送货单',
+    category: 'invoice',
+    desc: 'A5 送货单：随货联，收货方签收后留档',
+    sizeLabel: 'A5 · 148×210',
+    pageW: 148,
+    pageH: 210,
+    build: () => {
+      const w = 128
+      const header: AnyControl[] = [
+        txt('dl-title', 0, 0, w, 10, '送 货 单', { fontSize: 15, fontWeight: 'bold', textAlign: 'center' }),
+        txt('dl-no', 0, 11, w, 5, '送货单号：SH-2026-0801', { fontSize: 9 }),
+        rule('dl-rule', 0, 18, w),
+      ]
+      const body: AnyControl[] = [
+        txt('dl-to', 0, 0, w, 5, '收货单位：某某商贸有限公司', { fontSize: 9 }),
+        txt('dl-from', 0, 6, w, 5, '发货单位：某某科技有限公司', { fontSize: 9 }),
+        txt('dl-date', 0, 12, w, 5, '送货日期：2026-08-08　　车牌：粤B·88888', { fontSize: 9 }),
+        table('dl-tbl', 0, 20, w, 60, [
+          { title: '序号', expression: '{{rowIndex + 1}}', width: 12, align: 'center', headerAlign: 'center' },
+          { title: '商品名称', field: 'productName', width: 46, align: 'left', headerAlign: 'center' },
+          { title: '单位', field: 'unit', width: 12, align: 'center', headerAlign: 'center' },
+          { title: '数量', field: 'qty', width: 16, align: 'right', headerAlign: 'center' },
+          { title: '备注', field: 'memo', width: 42, align: 'left', headerAlign: 'center' },
+        ]),
+        txt('dl-sign', 0, 84, w, 6, '收货人签收：＿＿＿＿＿＿　　日期：＿＿＿＿＿＿', { fontSize: 9 }),
+      ]
+      return fullPage(paper(148, 210, { top: 8, bottom: 8 }), header, body)
+    },
+  },
+
+  /* ============ 报表（A4 · 图表 + 内嵌数据） ============ */
+  {
+    id: 'market-financial-report',
+    name: '精美财务分析报表',
+    category: 'report',
+    desc: 'A4 财务分析报表：4 张 KPI 指标卡 + 柱状/环形/折线三张矢量图表 + 分部经营明细表（内嵌数据，自带合计），开箱即用无需绑定数据源',
+    sizeLabel: 'A4 · 210×297',
+    pageW: 210,
+    pageH: 297,
+    build: buildFinancialReport,
+  },
+
+  /* ============ 小票（58 / 80 热敏） ============ */
+  {
+    id: 'market-pos-58',
+    name: '收银小票（58mm）',
+    category: 'receipt',
+    desc: '58mm 热敏收银小票：店名 + 商品行 + 合计，下方留白可自行扩展内容',
+    sizeLabel: '58×120',
+    pageW: 58,
+    pageH: 120,
+    build: () => {
+      const w = 50
+      const items: Array<[string, string, string]> = [
+        ['可口可乐 330ml', '2', '6.00'],
+        ['农夫山泉 550ml', '3', '4.50'],
+        ['乐事薯片 原味', '1', '7.50'],
+        ['康师傅方便面', '2', '9.00'],
+        ['蒙牛纯牛奶 250ml', '2', '7.60'],
+      ]
+      const lines: AnyControl[] = [
+        txt('pos-name', 0, 0, w, 6, '某某便利超市', { fontSize: 12, fontWeight: 'bold', textAlign: 'center' }),
+        txt('pos-addr', 0, 6.5, w, 4, '地址：宝安区某某路 88 号', { fontSize: 8, textAlign: 'center', fill: '#555555' }),
+        txt('pos-tel', 0, 11, w, 4, '电话：0755-6666 8888', { fontSize: 8, textAlign: 'center', fill: '#555555' }),
+        rule('pos-rule1', 0, 16, w, '#999999', 0.5),
+        txt('pos-no', 0, 17.5, w, 4, '单号：20260808-0012', { fontSize: 8 }),
+        txt('pos-time', 0, 22, w, 4, '时间：2026-08-08 18:30:00', { fontSize: 8 }),
+        rule('pos-rule2', 0, 27, w, '#999999', 0.5),
+      ]
+      let top = 28.5
+      items.forEach(([name, qty, price], i) => {
+        lines.push(txt(`pos-item${i}`, 0, top, w, 4.5, `${name}`, { fontSize: 9 }))
+        lines.push(txt(`pos-item${i}-q`, 26, top, 12, 4.5, `x${qty}`, { fontSize: 9, textAlign: 'right' }))
+        lines.push(txt(`pos-item${i}-p`, 38, top, 12, 4.5, price, { fontSize: 9, textAlign: 'right' }))
+        top += 5
+      })
+      top += 1
+      lines.push(rule('pos-rule3', 0, top, w, '#999999', 0.5))
+      lines.push(txt('pos-total', 0, top + 2, w, 6, '合计：￥34.60', { fontSize: 12, fontWeight: 'bold', textAlign: 'right' }))
+      lines.push(txt('pos-qr', 0, top + 9, w, 4, '扫码关注公众号', { fontSize: 7.5, textAlign: 'center', fill: '#555555' }))
+      return bodyOnly(paper(58, 120, { top: 4, right: 4, bottom: 4, left: 4 }), lines)
+    },
+  },
+  {
+    id: 'market-waimai-80',
+    name: '外卖小票（80mm）',
+    category: 'receipt',
+    desc: '80mm 外卖小票：店铺信息 + 订单明细 + 合计 + 备注',
+    sizeLabel: '80×150',
+    pageW: 80,
+    pageH: 150,
+    build: () => {
+      const w = 72
+      const header: AnyControl[] = [
+        txt('wm-name', 0, 0, w, 6, '某某餐饮店', { fontSize: 13, fontWeight: 'bold', textAlign: 'center' }),
+        txt('wm-slogan', 0, 6.5, w, 4, '好吃不贵，快速送达', { fontSize: 8, textAlign: 'center', fill: '#888888' }),
+        rule('wm-rule1', 0, 12, w, '#999999', 0.5),
+        txt('wm-no', 0, 13.5, w, 4, '订单号：WM2026080800123', { fontSize: 8.5 }),
+        txt('wm-type', 50, 13.5, 22, 4, '堂食 / 外卖', { fontSize: 8.5, textAlign: 'right' }),
+        txt('wm-time', 0, 18, w, 4, '下单时间：2026-08-08 12:05:30', { fontSize: 8.5 }),
+        rule('wm-rule2', 0, 23, w, '#999999', 0.5),
+      ]
+      const body: AnyControl[] = [
+        table('wm-tbl', 0, 0, w, 55, [
+          { title: '商品', field: 'productName', width: 40, align: 'left', headerAlign: 'center' },
+          { title: '数量', field: 'qty', width: 12, align: 'center', headerAlign: 'center' },
+          { title: '小计', field: 'amount', width: 20, align: 'right', headerAlign: 'center' },
+        ], { borders: 'none', repeatHeader: false }),
+        txt('wm-total', 0, 58, w, 6, '合计：￥58.00', { fontSize: 12, fontWeight: 'bold', textAlign: 'right' }),
+        txt('wm-fee', 0, 65, w, 4, '配送费：￥3.00　　包装费：￥1.00', { fontSize: 8.5, fill: '#555555' }),
+        rule('wm-rule3', 0, 71, w, '#999999', 0.5),
+        txt('wm-addr', 0, 73, w, 6, '送达地址：南山区科技园某某大厦 3 楼', { fontSize: 8.5 }),
+        txt('wm-memo', 0, 80, w, 6, '备注：不要辣，多加一双筷子', { fontSize: 8.5 }),
+        txt('wm-thanks', 0, 92, w, 5, '感谢惠顾，欢迎再次光临！', { fontSize: 9, textAlign: 'center', fontWeight: 'bold' }),
+      ]
+      return fullPage(paper(80, 150, { top: 6, right: 4, bottom: 6, left: 4 }), header, body)
+    },
+  },
+
+  /* ============ 热敏面单 ============ */
+  {
+    id: 'market-express',
+    name: '快递面单（热敏）',
+    category: 'thermal',
+    desc: '100×180 热敏快递面单：收/寄件信息分区 + 订单条码 + 运单号',
+    sizeLabel: '100×180',
+    pageW: 100,
+    pageH: 180,
+    build: () => {
+      const w = 92
+      const lines: AnyControl[] = [
+        txt('ex-title', 0, 0, w, 6, '快 递 面 单', { fontSize: 13, fontWeight: 'bold', textAlign: 'center' }),
+        rule('ex-rule', 0, 8, w, '#999999', 0.5),
+        txt('ex-send-t', 0, 10, w, 4, '【寄件人】', { fontSize: 9, fontWeight: 'bold' }),
+        txt('ex-send-name', 0, 15, w, 4, '张三　13800138000', { fontSize: 9.5 }),
+        txt('ex-send-addr', 0, 20, w, 6, '广东省深圳市南山区科技园南路 100 号', { fontSize: 9.5 }),
+        rule('ex-rule2', 0, 28, w, '#999999', 0.5),
+        txt('ex-recv-t', 0, 30, w, 4, '【收件人】', { fontSize: 9, fontWeight: 'bold' }),
+        txt('ex-recv-name', 0, 35, w, 4, '李四　13900139000', { fontSize: 9.5 }),
+        txt('ex-recv-addr', 0, 40, w, 6, '北京市朝阳区建国路 88 号院 2 号楼', { fontSize: 9.5 }),
+        rule('ex-rule3', 0, 48, w, '#999999', 0.5),
+        barcode('ex-bc', 20, 52, 52, 14, 'SF1234567890'),
+        txt('ex-no', 0, 69, w, 4, '运单号：SF1234567890', { fontSize: 9, textAlign: 'center' }),
+        txt('ex-remark', 0, 75, w, 5, '备注：易碎品，请轻拿轻放', { fontSize: 8.5, fill: '#555555' }),
+      ]
+      return bodyOnly(paper(100, 180, { top: 6, right: 4, bottom: 6, left: 4 }), lines)
+    },
+  },
+
+  /* ============ 标签 ============ */
+  {
+    id: 'market-price-label',
+    name: '价格标签',
+    category: 'label',
+    desc: '40×30 商品价格标签：大号价格 + 商品名 + 条码，可复制多个排布',
+    sizeLabel: '40×30',
+    pageW: 40,
+    pageH: 30,
+    build: () => {
+      const w = 36
+      const lines: AnyControl[] = [
+        txt('lb-name', 0, 0, w, 5, '可乐 500ml', { fontSize: 8, textAlign: 'center' }),
+        txt('lb-price', 0, 6, w, 10, '￥3.50', { fontSize: 20, fontWeight: 'bold', textAlign: 'center', fill: '#e60000' }),
+        barcode('lb-bc', 6, 18, 24, 8, '6901234567890'),
+      ]
+      return bodyOnly(paper(40, 30, { top: 3, right: 2, bottom: 3, left: 2 }), lines)
+    },
+  },
+
+  /* ============ 新增：退货 / 报销 / 领料 / 对账（A4） ============ */
+  {
+    id: 'market-return-order',
+    name: '销售退货单',
+    category: 'invoice',
+    desc: 'A4 销售退货单：原单信息 + 退货明细（含原因）+ 退款结算栏',
+    sizeLabel: 'A4 · 210×297',
+    pageW: 210,
+    pageH: 297,
+    build: () => {
+      const w = 186
+      const header: AnyControl[] = [
+        txt('rt-co', 0, 0, 100, 6, '深圳某某科技有限公司', { fontSize: 10, fontWeight: 'bold', fill: '#333333' }),
+        txt('rt-title', 0, 7, w, 11, '销 售 退 货 单', { fontSize: 18, fontWeight: 'bold', textAlign: 'center', fill: '#c0392b' }),
+        rule('rt-rule', 0, 21, w),
+      ]
+      const body: AnyControl[] = [
+        txt('rt-no', 0, 0, 62, 6, '退货单号：TH-2026-0008'),
+        txt('rt-date', 62, 0, 62, 6, '退货日期：2026-08-08'),
+        txt('rt-origin', 124, 0, 62, 6, '原出库单：CK-2026-0156'),
+        txt('rt-cust', 0, 7, 92, 6, '客户：某某商贸有限公司'),
+        txt('rt-contact', 92, 7, 94, 6, '联系人：王先生　电话：0755-5555 1234'),
+        txt('rt-addr', 0, 14, w, 6, '退货地址：宝安区某某工业园 B 栋 2 层'),
+        table('rt-tbl', 0, 23, w, 60, [
+          { title: '序号', expression: '{{rowIndex + 1}}', width: 14, align: 'center', headerAlign: 'center' },
+          { title: '商品编码', field: 'productCode', width: 26, align: 'left', headerAlign: 'center' },
+          { title: '商品名称', field: 'productName', width: 48, align: 'left', headerAlign: 'center' },
+          { title: '规格', field: 'spec', width: 26, align: 'left', headerAlign: 'center' },
+          { title: '数量', field: 'qty', width: 14, align: 'right', headerAlign: 'center' },
+          { title: '退货原因', field: 'reason', width: 58, align: 'left', headerAlign: 'center' },
+        ]),
+        txt('rt-total', 0, 85, w, 7, '退货合计（大写）：人民币陆佰元整', { fontSize: 11, fontWeight: 'bold' }),
+        txt('rt-memo', 0, 93, w, 6, '备注：退货须附原出库单与验收记录', { fontSize: 9, fill: '#555555' }),
+        txt('rt-sign', 0, 103, w, 6, '客户确认：＿＿＿＿　　仓库验收：＿＿＿＿　　财务退款：＿＿＿＿', { fontSize: 9 }),
+      ]
+      const footer: AnyControl[] = [
+        txt('rt-brand', 0, 3, 90, 6, '本单据由 OpenPrint 生成', { fontSize: 8, fill: '#888888' }),
+        txt('rt-page', 96, 3, 90, 6, '第 {{page}} 页 / 共 {{pages}} 页', { fontSize: 9, textAlign: 'right', fill: '#555555' }),
+      ]
+      return fullPage(paper(210, 297), header, body, footer)
+    },
+  },
+  {
+    id: 'market-expense-claim',
+    name: '费用报销单',
+    category: 'invoice',
+    desc: 'A4 费用报销单：费用明细表 + 合计 + 多级审批签名栏',
+    sizeLabel: 'A4 · 210×297',
+    pageW: 210,
+    pageH: 297,
+    build: () => {
+      const w = 186
+      const header: AnyControl[] = [
+        txt('exp-co', 0, 0, 100, 6, '某某科技有限公司', { fontSize: 10, fontWeight: 'bold', fill: '#333333' }),
+        txt('exp-title', 0, 7, w, 11, '费 用 报 销 单', { fontSize: 18, fontWeight: 'bold', textAlign: 'center' }),
+        rule('exp-rule', 0, 21, w),
+      ]
+      const body: AnyControl[] = [
+        txt('exp-no', 0, 0, 62, 6, '报销单号：BX-2026-0234'),
+        txt('exp-date', 62, 0, 62, 6, '报销日期：2026-08-08'),
+        txt('exp-dept', 124, 0, 62, 6, '部门：市场部'),
+        txt('exp-user', 0, 7, 62, 6, '报销人：陈小明'),
+        txt('exp-purpose', 62, 7, 124, 6, '事由：客户拜访差旅费'),
+        table('exp-tbl', 0, 16, w, 50, [
+          { title: '序号', expression: '{{rowIndex + 1}}', width: 14, align: 'center', headerAlign: 'center' },
+          { title: '费用类型', field: 'feeType', width: 42, align: 'left', headerAlign: 'center' },
+          { title: '发生日期', field: 'feeDate', width: 30, align: 'center', headerAlign: 'center' },
+          { title: '摘要', field: 'summary', width: 50, align: 'left', headerAlign: 'center' },
+          { title: '票据张数', field: 'billCount', width: 18, align: 'right', headerAlign: 'center' },
+          { title: '金额', field: 'amount', width: 32, align: 'right', headerAlign: 'center' },
+        ]),
+        txt('exp-total', 0, 68, w, 7, '报销合计：￥1,860.00', { fontSize: 11, fontWeight: 'bold', textAlign: 'right' }),
+        txt('exp-note', 0, 76, w, 6, '备注：附发票及行程单，发票张数 12 张', { fontSize: 9, fill: '#555555' }),
+        txt('exp-sign', 0, 88, w, 6, '报销人：＿＿＿＿　　部门负责人：＿＿＿＿　　财务审核：＿＿＿＿', { fontSize: 9 }),
+        txt('exp-sign2', 0, 95, w, 6, '财务总监：＿＿＿＿　　总经理审批：＿＿＿＿', { fontSize: 9 }),
+      ]
+      const footer: AnyControl[] = [
+        txt('exp-page', 96, 3, 90, 6, '第 {{page}} 页 / 共 {{pages}} 页', { fontSize: 9, textAlign: 'right', fill: '#555555' }),
+      ]
+      return fullPage(paper(210, 297), header, body, footer)
+    },
+  },
+  {
+    id: 'market-material-request',
+    name: '领料单',
+    category: 'invoice',
+    desc: 'A4 领料单：领用明细表（物料/数量/用途）+ 发料领料签收栏',
+    sizeLabel: 'A4 · 210×297',
+    pageW: 210,
+    pageH: 297,
+    build: () => {
+      const w = 186
+      const header: AnyControl[] = [
+        txt('pl-co', 0, 0, 100, 6, '某某制造有限公司', { fontSize: 10, fontWeight: 'bold', fill: '#333333' }),
+        txt('pl-title', 0, 7, w, 11, '领 料 单', { fontSize: 18, fontWeight: 'bold', textAlign: 'center' }),
+        rule('pl-rule', 0, 21, w),
+      ]
+      const body: AnyControl[] = [
+        txt('pl-no', 0, 0, 62, 6, '领料单号：LL-2026-0066'),
+        txt('pl-date', 62, 0, 62, 6, '日期：2026-08-08'),
+        txt('pl-dept', 124, 0, 62, 6, '领料部门：生产一部'),
+        txt('pl-user', 0, 7, 62, 6, '领料人：刘师傅'),
+        txt('pl-wh', 62, 7, 124, 6, '仓库：原材料仓　用途：A 线本月排产'),
+        table('pl-tbl', 0, 16, w, 55, [
+          { title: '序号', expression: '{{rowIndex + 1}}', width: 14, align: 'center', headerAlign: 'center' },
+          { title: '物料编码', field: 'productCode', width: 26, align: 'left', headerAlign: 'center' },
+          { title: '物料名称', field: 'productName', width: 48, align: 'left', headerAlign: 'center' },
+          { title: '规格型号', field: 'spec', width: 30, align: 'left', headerAlign: 'center' },
+          { title: '单位', field: 'unit', width: 14, align: 'center', headerAlign: 'center' },
+          { title: '数量', field: 'qty', width: 18, align: 'right', headerAlign: 'center' },
+          { title: '备注', field: 'memo', width: 36, align: 'left', headerAlign: 'center' },
+        ]),
+        txt('pl-total', 0, 73, w, 6, '合计领用：5 项 / 共 360 件', { fontSize: 10, fontWeight: 'bold' }),
+        txt('pl-sign', 0, 84, w, 6, '领料人：＿＿＿＿　　发料人：＿＿＿＿　　车间主管：＿＿＿＿', { fontSize: 9 }),
+      ]
+      const footer: AnyControl[] = [
+        txt('pl-page', 96, 3, 90, 6, '第 {{page}} 页 / 共 {{pages}} 页', { fontSize: 9, textAlign: 'right', fill: '#555555' }),
+      ]
+      return fullPage(paper(210, 297), header, body, footer)
+    },
+  },
+  {
+    id: 'market-statement',
+    name: '对账单',
+    category: 'invoice',
+    desc: 'A4 客户对账单：账期往来明细（应收/已收/余额）+ 确认盖章栏',
+    sizeLabel: 'A4 · 210×297',
+    pageW: 210,
+    pageH: 297,
+    build: () => {
+      const w = 186
+      const header: AnyControl[] = [
+        txt('st-co', 0, 0, 100, 6, '某某科技有限公司', { fontSize: 10, fontWeight: 'bold', fill: '#1677ff' }),
+        txt('st-title', 0, 7, w, 11, '对 账 单', { fontSize: 18, fontWeight: 'bold', textAlign: 'center' }),
+        rule('st-rule', 0, 21, w, '#1677ff', 1),
+      ]
+      const body: AnyControl[] = [
+        txt('st-cust', 0, 0, w, 6, '致：某某商贸有限公司　　账期：2026-06-01 ~ 2026-07-31'),
+        txt('st-no', 0, 7, w, 6, '对账编号：DZ-2026-0801　　打印日期：2026-08-08'),
+        table('st-tbl', 0, 16, w, 60, [
+          { title: '序号', expression: '{{rowIndex + 1}}', width: 14, align: 'center', headerAlign: 'center' },
+          { title: '日期', field: 'billDate', width: 26, align: 'center', headerAlign: 'center' },
+          { title: '单据号', field: 'billNo', width: 34, align: 'left', headerAlign: 'center' },
+          { title: '摘要', field: 'summary', width: 44, align: 'left', headerAlign: 'center' },
+          { title: '应收（元）', field: 'debit', width: 24, align: 'right', headerAlign: 'center' },
+          { title: '已收（元）', field: 'credit', width: 22, align: 'right', headerAlign: 'center' },
+          { title: '余额（元）', field: 'balance', width: 22, align: 'right', headerAlign: 'center' },
+        ]),
+        txt('st-begin', 0, 78, w, 6, '期初余额：￥0.00', { fontSize: 10 }),
+        txt('st-end', 0, 85, w, 7, '期末应收余额：￥38,600.00', { fontSize: 11, fontWeight: 'bold' }),
+        txt('st-note', 0, 93, w, 6, '请核对以上往来明细，如无异议请签章确认后回传。', { fontSize: 9, fill: '#555555' }),
+        txt('st-sign', 0, 104, w, 6, '客户确认（盖章）：＿＿＿＿＿＿　　日期：＿＿＿＿＿＿', { fontSize: 9 }),
+      ]
+      const footer: AnyControl[] = [
+        txt('st-page', 96, 3, 90, 6, '第 {{page}} 页 / 共 {{pages}} 页', { fontSize: 9, textAlign: 'right', fill: '#555555' }),
+      ]
+      return fullPage(paper(210, 297), header, body, footer)
+    },
+  },
+
+  /* ============ 新增：带二维码的模板 ============ */
+  {
+    id: 'market-qr-receipt',
+    name: '收款码小票（带二维码）',
+    category: 'receipt',
+    desc: '58mm 收款小票：商品行 + 合计 + 收款二维码（静态示例链接，可改为收款码图片/绑定）',
+    sizeLabel: '58×130',
+    pageW: 58,
+    pageH: 130,
+    build: () => {
+      const w = 50
+      const lines: AnyControl[] = [
+        txt('qr-name', 0, 0, w, 6, '某某小面馆', { fontSize: 12, fontWeight: 'bold', textAlign: 'center' }),
+        txt('qr-addr', 0, 6.5, w, 4, '宝安区某某路 66 号', { fontSize: 8, textAlign: 'center', fill: '#555555' }),
+        rule('qr-rule1', 0, 11.5, w, '#999999', 0.5),
+        txt('qr-no', 0, 13, w, 4, '单号：20260808-0033', { fontSize: 8 }),
+        txt('qr-time', 0, 17.5, w, 4, '时间：2026-08-08 19:00:00', { fontSize: 8 }),
+        rule('qr-rule2', 0, 22.5, w, '#999999', 0.5),
+        txt('qr-i1', 0, 24, w, 4.5, '招牌牛肉面　　18.00', { fontSize: 9 }),
+        txt('qr-i2', 0, 29, w, 4.5, '卤蛋 x2　　　 4.00', { fontSize: 9 }),
+        txt('qr-i3', 0, 34, w, 4.5, '冰红茶　　　　 3.00', { fontSize: 9 }),
+        rule('qr-rule3', 0, 40, w, '#999999', 0.5),
+        txt('qr-total', 0, 42, w, 6, '合计：￥25.00', { fontSize: 12, fontWeight: 'bold', textAlign: 'right' }),
+        txt('qr-hint', 0, 51, w, 4, '扫一扫付款', { fontSize: 8, textAlign: 'center', fill: '#555555' }),
+        qrcode('qr-code', 17, 56, 16, 16, 'https://pay.example.com/merchant/1001'),
+      ]
+      return bodyOnly(paper(58, 130, { top: 4, right: 4, bottom: 4, left: 4 }), lines)
+    },
+  },
+  {
+    id: 'market-asset-label',
+    name: '资产二维码标签',
+    category: 'label',
+    desc: '50×30 固定资产标签：资产名称/编号 + 二维码（扫码查看资产档案）',
+    sizeLabel: '50×30',
+    pageW: 50,
+    pageH: 30,
+    build: () => {
+      const w = 46
+      const lines: AnyControl[] = [
+        txt('as-name', 0, 0, 30, 5, '笔记本电脑', { fontSize: 9, fontWeight: 'bold' }),
+        txt('as-no', 0, 6, 30, 4, '编号：ZC-2026-0158', { fontSize: 7.5, fill: '#555555' }),
+        txt('as-user', 0, 11, 30, 4, '使用人：张三', { fontSize: 7.5, fill: '#555555' }),
+        qrcode('as-qr', 32, 0, 14, 14, 'https://asset.example.com/zc-2026-0158'),
+        txt('as-date', 0, 20, 46, 4, '购置日期：2026-05-20', { fontSize: 7.5, fill: '#888888' }),
+      ]
+      return bodyOnly(paper(50, 30, { top: 3, right: 2, bottom: 3, left: 2 }), lines)
+    },
+  },
+  {
+    id: 'market-trace-label',
+    name: '商品溯源标签',
+    category: 'label',
+    desc: '60×40 溯源标签：商品信息 + 二维码（扫码查看溯源/质检信息）',
+    sizeLabel: '60×40',
+    pageW: 60,
+    pageH: 40,
+    build: () => {
+      const w = 56
+      const lines: AnyControl[] = [
+        txt('tr-name', 0, 0, w, 5, '有机大米 5kg', { fontSize: 10, fontWeight: 'bold' }),
+        txt('tr-spec', 0, 6, w, 4, '产地：黑龙江五常　　批次：2026-A07', { fontSize: 7.5, fill: '#555555' }),
+        txt('tr-price', 0, 11, 36, 8, '￥89.00', { fontSize: 16, fontWeight: 'bold', fill: '#e60000' }),
+        qrcode('tr-qr', 38, 11, 18, 18, 'https://trace.example.com/lot/2026-A07'),
+        txt('tr-note', 0, 32, w, 4, '扫码溯源 · 品质可查', { fontSize: 7.5, textAlign: 'center', fill: '#888888' }),
+      ]
+      return bodyOnly(paper(60, 40, { top: 3, right: 2, bottom: 3, left: 2 }), lines)
+    },
+  },
+]
diff --git a/openprint/src/repository/mock/data/sales-order.ts b/openprint/src/repository/mock/data/sales-order.ts
new file mode 100644
index 0000000..55b2edf
--- /dev/null
+++ b/openprint/src/repository/mock/data/sales-order.ts
@@ -0,0 +1,95 @@
+/**
+ * 销售订单 —— 内置示例数据源（《设计方案》§19.4.3a 第十节）
+ *
+ * 结构：主表(order) + 明细(items[]) + 关联表(customer)
+ * 所有字段带 sample 示例值，绑定后可立刻预览效果。
+ */
+import type { FieldDef, DataSourceMeta, TableMeta } from '@/types/datasource'
+
+export const SALES_ORDER_TABLES: TableMeta[] = [
+  {
+    id: 'order',
+    name: '订单主表',
+    relation: 'main',
+    pathPrefix: 'order',
+  },
+  {
+    id: 'customer',
+    name: '客户信息',
+    relation: 'join',
+    pathPrefix: 'customer',
+  },
+  {
+    id: 'items',
+    name: '订单明细',
+    relation: 'detail',
+    pathPrefix: 'items[]',
+    isArray: true,
+  },
+]
+
+export const SALES_ORDER_FIELDS: FieldDef[] = [
+  // ── 订单主表 ──
+  { path: 'order.orderNo',   label: '单据编号',       type: 'string',  tableId: 'order', group: '基本信息', sort: 1,  sample: 'XSCK202508050001' },
+  { path: 'order.orderDate', label: '单据日期',       type: 'date',    tableId: 'order', group: '基本信息', sort: 2,  sample: '2025-08-05' },
+  { path: 'order.total',     label: '合计金额',       type: 'number',  tableId: 'order', group: '金额信息', sort: 10, sample: 12800.50 },
+  { path: 'order.warehouse', label: '仓库',           type: 'string',  tableId: 'order', group: '基本信息', sort: 3,  sample: '深圳中心仓' },
+  { path: 'order.salesman',  label: '业务员',         type: 'string',  tableId: 'order', group: '基本信息', sort: 4,  sample: '张三' },
+  { path: 'order.status',    label: '单据状态',       type: 'string',  tableId: 'order', group: '基本信息', sort: 5,
+    options: [
+      { value: 'draft', label: '草稿' },
+      { value: 'confirmed', label: '已确认' },
+      { value: 'shipped', label: '已出库' },
+    ],
+    sample: 'confirmed',
+  },
+  { path: 'order.memo',      label: '备注',           type: 'string',  tableId: 'order', group: '其他',     sort: 99, sample: '急单，请优先处理' },
+
+  // ── 客户信息 ──
+  { path: 'customer.name',    label: '客户名称',      type: 'string',  tableId: 'customer', group: '基本信息', sort: 1,  sample: '深圳某科技有限公司' },
+  { path: 'customer.phone',   label: '客户电话',      type: 'string',  tableId: 'customer', group: '联系方式', sort: 2,  sample: '0755-88888888' },
+  { path: 'customer.address', label: '客户地址',      type: 'string',  tableId: 'customer', group: '联系方式', sort: 3,  sample: '深圳市南山区科技园南路 88 号' },
+  { path: 'customer.contact', label: '联系人',        type: 'string',  tableId: 'customer', group: '联系方式', sort: 4,  sample: '李明' },
+
+  // ── 订单明细 ──
+  { path: 'items[].seq',       label: '序号',         type: 'number',  tableId: 'items', group: '基本信息', sort: 1,  sample: 1 },
+  { path: 'items[].productCode', label: '商品编码',   type: 'string',  tableId: 'items', group: '基本信息', sort: 2,  sample: 'P20240001' },
+  { path: 'items[].productName', label: '商品名称',   type: 'string',  tableId: 'items', group: '基本信息', sort: 3,  sample: '惠普激光打印机 HP M404dn' },
+  { path: 'items[].spec',      label: '规格型号',     type: 'string',  tableId: 'items', group: '基本信息', sort: 4,  sample: 'A4 黑白 38ppm' },
+  { path: 'items[].unit',      label: '单位',         type: 'string',  tableId: 'items', group: '基本信息', sort: 5,  sample: '台' },
+  { path: 'items[].qty',       label: '数量',         type: 'number',  tableId: 'items', group: '数量金额', sort: 6,  sample: 5 },
+  { path: 'items[].price',     label: '单价',         type: 'number',  tableId: 'items', group: '数量金额', sort: 7,  sample: 1999.00 },
+  { path: 'items[].amount',    label: '金额',         type: 'number',  tableId: 'items', group: '数量金额', sort: 8,  sample: 9995.00 },
+  { path: 'items[].remark',    label: '备注',         type: 'string',  tableId: 'items', group: '其他',     sort: 99, sample: '' },
+]
+
+export const SALES_ORDER_META: DataSourceMeta = {
+  id: 'sale_order',
+  name: '销售订单',
+  description: '内置演示数据源（含主表/明细/客户三层）',
+  tables: SALES_ORDER_TABLES,
+}
+
+/** 示例业务数据（Phase 7 渲染引擎预览用） */
+export const SALES_ORDER_SAMPLE = {
+  order: {
+    orderNo: 'XSCK202508050001',
+    orderDate: '2025-08-05',
+    total: 12800.50,
+    warehouse: '深圳中心仓',
+    salesman: '张三',
+    status: 'confirmed',
+    memo: '急单，请优先处理',
+  },
+  customer: {
+    name: '深圳某科技有限公司',
+    phone: '0755-88888888',
+    address: '深圳市南山区科技园南路 88 号',
+    contact: '李明',
+  },
+  items: [
+    { seq: 1, productCode: 'P20240001', productName: '惠普激光打印机 HP M404dn', spec: 'A4 黑白 38ppm', unit: '台', qty: 5, price: 1999.00, amount: 9995.00, remark: '' },
+    { seq: 2, productCode: 'P20240015', productName: '兄弟黑白激光一体机 DCP-1618W', spec: 'A4 打印/复印/扫描', unit: '台', qty: 2, price: 1399.00, amount: 2798.00, remark: '' },
+    { seq: 3, productCode: 'P20230088', productName: '佳能彩色喷墨打印机 G3810', spec: 'A4 无线 加墨', unit: '台', qty: 1, price: 999.00, amount: 999.00, remark: '促销款' },
+  ],
+}
diff --git a/openprint/src/repository/mock/mock-datasource.ts b/openprint/src/repository/mock/mock-datasource.ts
new file mode 100644
index 0000000..76bcadf
--- /dev/null
+++ b/openprint/src/repository/mock/mock-datasource.ts
@@ -0,0 +1,32 @@
+/**
+ * createMockDataSource —— 内置示例数据源（§19.4.3a 第十节）
+ *
+ * 零后端即可体验完整"字段绑定→预览"闭环。
+ * 与 createDataSourceHttp 同接口，传入真实 source 时整体替换，无分支。
+ */
+import type { DataSourceRepository, DataSourceMeta, FieldDef } from '@/types/datasource'
+import {
+  SALES_ORDER_META,
+  SALES_ORDER_FIELDS,
+} from './data/sales-order'
+import {
+  CUSTOMER_META,
+  CUSTOMER_FIELDS,
+} from './data/customer'
+
+const SOURCES: DataSourceMeta[] = [SALES_ORDER_META, CUSTOMER_META]
+const FIELDS_MAP: Record<string, FieldDef[]> = {
+  sale_order: SALES_ORDER_FIELDS,
+  customer: CUSTOMER_FIELDS,
+}
+
+export function createMockDataSource(): DataSourceRepository {
+  return {
+    async listSources() {
+      return SOURCES
+    },
+    async getFields(sourceId: string) {
+      return FIELDS_MAP[sourceId] ?? []
+    },
+  }
+}
diff --git a/openprint/src/repository/types.ts b/openprint/src/repository/types.ts
new file mode 100644
index 0000000..1371b29
--- /dev/null
+++ b/openprint/src/repository/types.ts
@@ -0,0 +1,41 @@
+/**
+ * 模板仓库契约 —— 《实施指南》§2 repository 层 / 《后端对接规范》§4.1
+ *
+ * 铁律（2026-08-08 主任定）：
+ * - 设计器内一切操作**纯本地**，不触发任何后端写入
+ * - 只有用户手动点击「保存模板」才调用 save()
+ * - 未配置后端接口时，使用 createLocalRepository（localStorage），功能不受影响
+ */
+import type { AnyControl } from '@/types/control'
+import type { TemplateData } from '@/types/template'
+
+/** 模板记录 = 协议数据 + 管理元信息 */
+export interface TemplateRecord {
+  id: string
+  name: string
+  /** 权限（云端返回；本地实现恒为可编辑可删除） */
+  editable?: boolean
+  deletable?: boolean
+  updatedAt?: string
+  data: TemplateData<AnyControl>
+}
+
+export interface TemplateSummary {
+  id: string
+  name: string
+  editable?: boolean
+  deletable?: boolean
+  updatedAt?: string
+}
+
+/** 纯 CRUD 五项（对齐后端 /api/print/templates） */
+export interface TemplateRepository {
+  list(): Promise<TemplateSummary[]>
+  get(id: string): Promise<TemplateRecord | null>
+  create(record: Omit<TemplateRecord, 'id' | 'updatedAt'>): Promise<TemplateRecord>
+  update(id: string, record: Partial<Omit<TemplateRecord, 'id'>>): Promise<TemplateRecord>
+  remove(id: string): Promise<void>
+}
+
+/** 数据源仓库契约（Phase 5 实现） */
+export type { DataSourceRepository } from '@/types/datasource'
diff --git a/openprint/src/theme/brand.css b/openprint/src/theme/brand.css
new file mode 100644
index 0000000..43ce6aa
--- /dev/null
+++ b/openprint/src/theme/brand.css
@@ -0,0 +1,81 @@
+/**
+ * brand.css —— 语义化品牌 CSS 变量
+ *
+ * 与 naive-theme.ts / uno.config.ts 同源：
+ *   :root        → 亮色
+ *   html.dark    → 暗色（由 ui store 切换时在 document.documentElement 打 .dark 类）
+ *
+ * 注意：
+ * - body 的背景/前景色交给 NGlobalStyle（它会同步 common.bodyColor / textColor），
+ *   这里只做「组件内自定义样式」使用的语义化变量。
+ * - 旧 --brand-dark 保留作为「深色顶栏背景」语义的别名，
+ *   但推荐直接用 --brand-nav-bg（含义更明确）。
+ */
+
+:root {
+  /* 主色 */
+  --brand-primary: var(--op-primary, #1677FF);
+  --brand-primary-hover: var(--op-primary-hover, #4096FF);
+  --brand-primary-pressed: var(--op-primary-pressed, #0958D9);
+
+  /* 表面 */
+  --brand-bg: var(--op-bg, #F5F7FA);
+  --brand-surface: var(--op-surface, #FFFFFF);
+  --brand-border: var(--op-border, #E5E7EB);
+
+  /* 文字 */
+  --brand-text-1: var(--op-text-1, #1F2329);
+  --brand-text-2: var(--op-text-2, #4B5563);
+  --brand-text-3: var(--op-text-3, #86909C);
+  --brand-text-muted: var(--op-text-muted, #86909C);
+
+  /* 顶栏跟随主题：亮色下用白色表面 + 深色文字 */
+  --brand-nav-bg: var(--op-nav-bg, #FFFFFF);
+  --brand-nav-bg-hover: var(--op-nav-bg-hover, rgba(0,0,0,0.04));
+  --brand-nav-text: var(--op-nav-text, #1F2329);
+  --brand-nav-text-muted: var(--op-nav-text-muted, #86909C);
+  --brand-nav-text-active: var(--op-nav-text-active, #1F2329);
+  --brand-nav-icon: var(--op-nav-icon, #4B5563);
+  --brand-nav-icon-hover: var(--op-nav-icon-hover, #1F2329);
+
+  /* 兼容性别名（旧代码里用 --brand-dark 表示深色顶栏） */
+  --brand-dark: var(--brand-nav-bg);
+
+  /* 画布外围 */
+  --op-canvas-bg: var(--op-bg, #F5F7FA);
+  --op-canvas-checker-a: #FFFFFF;
+  --op-canvas-checker-b: #F3F4F6;
+}
+
+html.dark {
+  /* 主色 · 暗下调亮保证对比 */
+  --brand-primary: var(--op-primary, #3C8DFF);
+  --brand-primary-hover: var(--op-primary-hover, #5FA1FF);
+  --brand-primary-pressed: var(--op-primary-pressed, #1B65D4);
+
+  /* 表面 */
+  --brand-bg: var(--op-bg, #0B0D12);
+  --brand-surface: var(--op-surface, #171A21);
+  --brand-border: var(--op-border, #2A2F3A);
+
+  /* 文字 · 主文字用纯白保证对比 */
+  --brand-text-1: var(--op-text-1, #FFFFFF);
+  --brand-text-2: var(--op-text-2, #AFB4BD);
+  --brand-text-3: var(--op-text-3, #7A808C);
+  --brand-text-muted: var(--op-text-muted, #7A808C);
+
+  /* 顶栏 · 暗色下用深色背景 + 白色文字/图标 */
+  --brand-nav-bg: var(--op-nav-bg, #0F1116);
+  --brand-nav-bg-hover: var(--op-nav-bg-hover, rgba(255,255,255,0.08));
+  --brand-nav-text: var(--op-nav-text, #FFFFFF);
+  --brand-nav-text-muted: var(--op-nav-text-muted, #9CA3AF);
+  --brand-nav-text-active: var(--op-nav-text-active, #FFFFFF);
+  --brand-nav-icon: var(--op-nav-icon, #FFFFFF);
+  --brand-nav-icon-hover: var(--op-nav-icon-hover, #FFFFFF);
+
+  --brand-dark: var(--brand-nav-bg);
+
+  --op-canvas-bg: var(--op-bg, #0B0D12);
+  --op-canvas-checker-a: #171A21;
+  --op-canvas-checker-b: #1F242D;
+}
diff --git a/openprint/src/theme/naive-theme.ts b/openprint/src/theme/naive-theme.ts
new file mode 100644
index 0000000..7f9804b
--- /dev/null
+++ b/openprint/src/theme/naive-theme.ts
@@ -0,0 +1,405 @@
+/**
+ * Naive UI 主题覆盖 —— 亮/暗双模式统一品牌色
+ *
+ * 设计原则：
+ * 1. 品牌蓝 #1677FF → 衍生 5/3/1 个色阶（primary/primaryHover/primaryPressed…）
+ * 2. 信息色在暗色下提高明度 & 不透明度，保证对比度
+ * 3. 顶栏（56px Toolbar）在亮色下也用"深导航"配色，保证与 App 视觉一致；
+ *    同时 Naive UI 内部组件（Dropdown/Modal/Select/Popover）随 NConfigProvider 主题生效
+ * 4. common 字段 7 色阶 + 字体大小/圆角统一，其他组件按需要微调
+ */
+import type { GlobalThemeOverrides } from 'naive-ui'
+
+/* ============================= 品牌色常量 ============================= */
+
+const PRIMARY = '#1677FF'
+const PRIMARY_HOVER = '#4096FF'
+const PRIMARY_PRESSED = '#0958D9'
+const PRIMARY_SUPPL = '#69B1FF'
+const PRIMARY_FADE = '#E6F4FF'
+const PRIMARY_FADE_HOVER = '#BAE0FF'
+
+/* ------------------------- 浅色背景 · 文字 --------------------------- */
+
+const LIGHT_BG = '#F5F7FA'        // 画布外围背景
+const LIGHT_SURFACE = '#FFFFFF'   // 面板表面
+const LIGHT_BORDER = '#E5E7EB'    // 分隔线
+const LIGHT_TEXT_1 = '#1F2329'
+const LIGHT_TEXT_2 = '#4B5563'
+const LIGHT_TEXT_3 = '#86909C'
+const LIGHT_PLACEHOLDER = '#A0A7B1'
+const LIGHT_DISABLED = '#C9CDD4'
+const LIGHT_INFO = '#374151'      // 灰-600，用于 quaternary 按钮在深色顶栏上
+
+/* ------------------------- 深色背景 · 文字 --------------------------- */
+
+const DARK_BG = '#0B0D12'
+const DARK_SURFACE = '#171A21'
+const DARK_BORDER = '#2A2F3A'
+const DARK_TEXT_1 = '#FFFFFF'
+const DARK_TEXT_2 = '#AFB4BD'
+const DARK_TEXT_3 = '#7A808C'
+const DARK_PLACEHOLDER = '#5F6673'
+const DARK_DISABLED = '#3A3F4A'
+
+/* 暗色下品牌色：稍微调亮，避免低对比 */
+const DARK_PRIMARY = '#3C8DFF'
+const DARK_PRIMARY_HOVER = '#5FA1FF'
+const DARK_PRIMARY_PRESSED = '#1B65D4'
+const DARK_PRIMARY_SUPPL = '#8DBFFF'
+const DARK_PRIMARY_FADE = '#0D2B58'
+const DARK_PRIMARY_FADE_HOVER = '#163A74'
+
+/* ============================== 主题导出 ============================== */
+
+/** 通用色阶：保证 common 所有 token 都有值，避免 [seemly/rgba] undefined 报错 */
+function buildCommon(dark: false): GlobalThemeOverrides['common'] {
+  return {
+    // 背景
+    bodyColor: LIGHT_BG,
+    modalColor: LIGHT_SURFACE,
+    popoverColor: LIGHT_SURFACE,
+    cardColor: LIGHT_SURFACE,
+    tableColor: LIGHT_SURFACE,
+    codeColor: '#F3F4F6',
+    // 边框/分割
+    borderColor: LIGHT_BORDER,
+    borderColorStrong: '#D1D5DB',
+    dividerColor: LIGHT_BORDER,
+    // 文字
+    textColorBase: LIGHT_TEXT_1,
+    textColor1: LIGHT_TEXT_1,
+    textColor2: LIGHT_TEXT_2,
+    textColor3: LIGHT_TEXT_3,
+    placeholderColor: LIGHT_PLACEHOLDER,
+    placeholderColorDisabled: LIGHT_DISABLED,
+    // 主色
+    primaryColor: PRIMARY,
+    primaryColorHover: PRIMARY_HOVER,
+    primaryColorPressed: PRIMARY_PRESSED,
+    primaryColorSuppl: PRIMARY_SUPPL,
+    // 主色淡色
+    primaryColorFaded: PRIMARY_FADE,
+    primaryColorFadedHover: PRIMARY_FADE_HOVER,
+    // 功能色
+    infoColor: '#0B78CE',
+    infoColorHover: '#1D91E8',
+    infoColorPressed: '#075BA0',
+    infoColorSuppl: '#36A3F7',
+    infoColorFaded: '#E2F2FF',
+    successColor: '#18A058',
+    successColorHover: '#36AD6A',
+    successColorPressed: '#0C7A43',
+    successColorSuppl: '#58CA86',
+    successColorFaded: '#D8F5E3',
+    warningColor: '#F0A020',
+    warningColorHover: '#F5B340',
+    warningColorPressed: '#C87F10',
+    warningColorSuppl: '#FFBE58',
+    warningColorFaded: '#FFF4D9',
+    errorColor: '#D03050',
+    errorColorHover: '#DE576D',
+    errorColorPressed: '#A81C38',
+    errorColorSuppl: '#FF6C88',
+    errorColorFaded: '#FBE3E8',
+    // 控件态
+    invertedColor: '#20242B',
+    closeIconColor: LIGHT_TEXT_2,
+    closeIconColorHover: LIGHT_TEXT_1,
+    closeIconColorPressed: LIGHT_TEXT_3,
+    closeColorHover: '#F3F4F6',
+    closeColorPressed: '#E5E7EB',
+    clearColor: LIGHT_TEXT_3,
+    clearColorHover: LIGHT_TEXT_2,
+    tabColor: LIGHT_SURFACE,
+    headerColor: '#FAFBFC',
+    scrollbarColor: 'rgba(0, 0, 0, 0.25)',
+    scrollbarColorHover: 'rgba(0, 0, 0, 0.4)',
+    progressRailColor: '#F0F2F5',
+    railColor: '#F0F2F5',
+    // 字体
+    fontFamily: `Inter, 'Source Han Sans CN', 'PingFang SC', 'Microsoft YaHei', system-ui, -apple-system, sans-serif`,
+    fontFamilyMono: `"JetBrains Mono", "Fira Code", ui-monospace, SFMono-Regular, Menlo, Consolas, monospace`,
+    fontSizeSmall: '12px',
+    fontSizeMedium: '13px',
+    fontSizeLarge: '14px',
+    fontSizeHuge: '16px',
+    // 圆角 / 线宽
+    borderRadiusSmall: '4px',
+    borderRadius: '6px',
+    borderRadiusMedium: '8px',
+    borderRadiusLarge: '12px',
+    lineWidth: '1px',
+    lineHeight: '1.57',
+    cubicBezierEaseInOut: 'cubic-bezier(.4, 0, .2, 1)',
+    cubicBezierEaseOut: 'cubic-bezier(0, 0, .2, 1)',
+    cubicBezierEaseIn: 'cubic-bezier(.4, 0, 1, 1)',
+    // 信息框/标签等额外 common token（显式覆盖，避免 undefined）
+    tagColorCheckableDefault: '#F3F4F6',
+    tagTextColorCheckableDefault: LIGHT_TEXT_2,
+  } as NonNullable<GlobalThemeOverrides['common']>
+}
+
+function buildCommonDark(): GlobalThemeOverrides['common'] {
+  return {
+    // 背景
+    bodyColor: DARK_BG,
+    modalColor: DARK_SURFACE,
+    popoverColor: DARK_SURFACE,
+    cardColor: DARK_SURFACE,
+    tableColor: DARK_SURFACE,
+    codeColor: '#22262F',
+    // 边框/分割
+    borderColor: DARK_BORDER,
+    borderColorStrong: '#3A3F4A',
+    dividerColor: DARK_BORDER,
+    // 文字
+    textColorBase: DARK_TEXT_1,
+    textColor1: DARK_TEXT_1,
+    textColor2: DARK_TEXT_2,
+    textColor3: DARK_TEXT_3,
+    placeholderColor: DARK_PLACEHOLDER,
+    placeholderColorDisabled: DARK_DISABLED,
+    // 主色（暗下调亮）
+    primaryColor: DARK_PRIMARY,
+    primaryColorHover: DARK_PRIMARY_HOVER,
+    primaryColorPressed: DARK_PRIMARY_PRESSED,
+    primaryColorSuppl: DARK_PRIMARY_SUPPL,
+    primaryColorFaded: DARK_PRIMARY_FADE,
+    primaryColorFadedHover: DARK_PRIMARY_FADE_HOVER,
+    // 功能色
+    infoColor: '#2D8CFF',
+    infoColorHover: '#55A3FF',
+    infoColorPressed: '#1F6FD4',
+    infoColorSuppl: '#7FB8FF',
+    infoColorFaded: '#112A4E',
+    successColor: '#25C26A',
+    successColorHover: '#47CF81',
+    successColorPressed: '#169B54',
+    successColorSuppl: '#77DC9F',
+    successColorFaded: '#0F3A27',
+    warningColor: '#F5A524',
+    warningColorHover: '#F8B850',
+    warningColorPressed: '#C87F0E',
+    warningColorSuppl: '#FFCF6E',
+    warningColorFaded: '#3F2B0A',
+    errorColor: '#DE4B67',
+    errorColorHover: '#E77085',
+    errorColorPressed: '#B62F47',
+    errorColorSuppl: '#FF8EA0',
+    errorColorFaded: '#3F1320',
+    // 控件态
+    invertedColor: '#000000',
+    closeIconColor: DARK_TEXT_2,
+    closeIconColorHover: DARK_TEXT_1,
+    closeIconColorPressed: DARK_TEXT_3,
+    closeColorHover: 'rgba(255,255,255,0.08)',
+    closeColorPressed: 'rgba(255,255,255,0.05)',
+    clearColor: DARK_TEXT_3,
+    clearColorHover: DARK_TEXT_2,
+    tabColor: DARK_SURFACE,
+    headerColor: '#1F242D',
+    scrollbarColor: 'rgba(255, 255, 255, 0.25)',
+    scrollbarColorHover: 'rgba(255, 255, 255, 0.4)',
+    progressRailColor: '#2A2F3A',
+    railColor: '#2A2F3A',
+    // 字体（与亮色一致）
+    fontFamily: `Inter, 'Source Han Sans CN', 'PingFang SC', 'Microsoft YaHei', system-ui, -apple-system, sans-serif`,
+    fontFamilyMono: `"JetBrains Mono", "Fira Code", ui-monospace, SFMono-Regular, Menlo, Consolas, monospace`,
+    fontSizeSmall: '12px',
+    fontSizeMedium: '13px',
+    fontSizeLarge: '14px',
+    fontSizeHuge: '16px',
+    // 圆角 / 线宽
+    borderRadiusSmall: '4px',
+    borderRadius: '6px',
+    borderRadiusMedium: '8px',
+    borderRadiusLarge: '12px',
+    lineWidth: '1px',
+    lineHeight: '1.57',
+    cubicBezierEaseInOut: 'cubic-bezier(.4, 0, .2, 1)',
+    cubicBezierEaseOut: 'cubic-bezier(0, 0, .2, 1)',
+    cubicBezierEaseIn: 'cubic-bezier(.4, 0, 1, 1)',
+    tagColorCheckableDefault: '#242831',
+    tagTextColorCheckableDefault: DARK_TEXT_2,
+  } as NonNullable<GlobalThemeOverrides['common']>
+}
+
+/* ============================ 组件级覆盖 ============================ */
+
+/** 亮色下重点组件的一致性微调 */
+const lightComponents: Pick<
+  GlobalThemeOverrides,
+  | 'Button'
+  | 'Input'
+  | 'Dropdown'
+  | 'Modal'
+  | 'Tooltip'
+  | 'Select'
+  | 'Popconfirm'
+  | 'Drawer'
+  | 'DataTable'
+  | 'Form'
+> = {
+  Button: {
+    heightSmall: '28px',
+    heightMedium: '32px',
+    heightLarge: '36px',
+    // ghost 在深色顶栏上不会被 naive-ui 的 darkTheme 生效（顶栏自己是深色，但 body 是亮色）
+    // 但我们把 ghost/quaternary 的文字色交回组件自行覆盖（见 TopToolbar）
+  },
+  Dropdown: {
+    borderRadius: '6px',
+    optionHeightMedium: '32px',
+  },
+  Modal: {
+    borderRadius: '10px',
+  },
+  Tooltip: {
+    borderRadius: '6px',
+  },
+  Select: {
+    peers: {
+      InternalSelection: { heightMedium: '32px', borderRadius: '6px' },
+      InternalSelectMenu: { borderRadius: '6px' },
+    },
+  },
+  Popconfirm: {
+    borderRadius: '8px',
+  },
+  Drawer: {
+    borderRadius: '10px',
+  },
+  DataTable: {
+    borderRadius: '6px',
+    peers: {
+      Empty: { textColor: LIGHT_TEXT_3 },
+      Pagination: { itemTextColor: LIGHT_TEXT_2 },
+    },
+  },
+  Form: {
+    labelTextColor: LIGHT_TEXT_2,
+    asteriskColor: '#D03050',
+  },
+}
+
+/** 暗色下重点组件的一致性微调 */
+const darkComponents: Pick<
+  GlobalThemeOverrides,
+  | 'Button'
+  | 'Input'
+  | 'Dropdown'
+  | 'Modal'
+  | 'Tooltip'
+  | 'Select'
+  | 'Popconfirm'
+  | 'Drawer'
+  | 'DataTable'
+  | 'Form'
+> = {
+  Button: {
+    heightSmall: '28px',
+    heightMedium: '32px',
+    heightLarge: '36px',
+    // 暗色下 ghost/quaternary 背景透明，文字用 textColor1（#FFFFFF）保证可读
+    colorGhost: 'transparent',
+    textColorGhost: DARK_TEXT_1,
+    colorGhostHover: 'rgba(255,255,255,0.06)',
+    colorGhostPressed: 'rgba(255,255,255,0.04)',
+    colorQuaternary: 'transparent',
+    textColorQuaternary: DARK_TEXT_1,
+    colorQuaternaryHover: 'rgba(255,255,255,0.06)',
+    colorQuaternaryPressed: 'rgba(255,255,255,0.04)',
+  },
+  Input: {
+    borderHover: '#3F4555',
+    borderFocus: DARK_PRIMARY_HOVER,
+  },
+  Dropdown: {
+    borderRadius: '6px',
+    optionHeightMedium: '32px',
+    colorOptionHover: 'rgba(255,255,255,0.06)',
+  },
+  Modal: {
+    borderRadius: '10px',
+    boxShadow: '0 20px 60px -10px rgba(0,0,0,0.7)',
+  },
+  Tooltip: {
+    borderRadius: '6px',
+  },
+  Select: {
+    peers: {
+      InternalSelection: { heightMedium: '32px', borderRadius: '6px' },
+      InternalSelectMenu: { borderRadius: '6px' },
+    },
+  },
+  Popconfirm: {
+    borderRadius: '8px',
+  },
+  Drawer: {
+    borderRadius: '10px',
+  },
+  DataTable: {
+    borderRadius: '6px',
+    tdColorStriped: 'rgba(255,255,255,0.02)',
+    thColor: '#1F242D',
+    peers: {
+      Empty: { textColor: DARK_TEXT_3 },
+      Pagination: { itemTextColor: DARK_TEXT_2 },
+    },
+  },
+  Form: {
+    labelTextColor: DARK_TEXT_2,
+    asteriskColor: '#DE4B67',
+  },
+}
+
+/* ================================ 公共导出 ================================ */
+
+export const lightThemeOverrides: GlobalThemeOverrides = {
+  common: buildCommon(false),
+  ...lightComponents,
+}
+
+export const darkThemeOverrides: GlobalThemeOverrides = {
+  common: buildCommonDark(),
+  ...darkComponents,
+}
+
+/** 语义化 CSS 变量（同步到 :root / html.dark，供 uno.config 与 scoped CSS 使用） */
+export const themeCssVars = {
+  light: {
+    '--brand-primary': PRIMARY,
+    '--brand-bg': LIGHT_BG,
+    '--brand-surface': LIGHT_SURFACE,
+    '--brand-border': LIGHT_BORDER,
+    '--brand-text-1': LIGHT_TEXT_1,
+    '--brand-text-2': LIGHT_TEXT_2,
+    '--brand-text-3': LIGHT_TEXT_3,
+    /** 顶栏跟随主题：亮色下用白色表面 + 深色文字 */
+    '--brand-nav-bg': LIGHT_SURFACE,
+    '--brand-nav-bg-hover': 'rgba(0,0,0,0.04)',
+    '--brand-nav-text': LIGHT_TEXT_1,
+    '--brand-nav-text-muted': LIGHT_TEXT_3,
+    '--brand-nav-text-active': LIGHT_TEXT_1,
+    '--brand-nav-icon': LIGHT_TEXT_2,
+    '--brand-nav-icon-hover': LIGHT_TEXT_1,
+  },
+  dark: {
+    '--brand-primary': DARK_PRIMARY,
+    '--brand-bg': DARK_BG,
+    '--brand-surface': DARK_SURFACE,
+    '--brand-border': DARK_BORDER,
+    '--brand-text-1': DARK_TEXT_1,
+    '--brand-text-2': DARK_TEXT_2,
+    '--brand-text-3': DARK_TEXT_3,
+    /** 顶栏 · 暗色下用深色背景 + 白色文字/图标 */
+    '--brand-nav-bg': '#0F1116',
+    '--brand-nav-bg-hover': 'rgba(255,255,255,0.08)',
+    '--brand-nav-text': '#FFFFFF',
+    '--brand-nav-text-muted': '#9CA3AF',
+    '--brand-nav-text-active': '#FFFFFF',
+    '--brand-nav-icon': '#FFFFFF',
+    '--brand-nav-icon-hover': '#FFFFFF',
+  },
+} as const
diff --git a/openprint/src/types/binding.ts b/openprint/src/types/binding.ts
new file mode 100644
index 0000000..32bbd0c
--- /dev/null
+++ b/openprint/src/types/binding.ts
@@ -0,0 +1,18 @@
+/**
+ * 数据绑定契约 —— 《OpenPrint-设计方案.md》§5.3 / §6
+ *
+ * binding：简单的字段路径绑定（点选 path，非手敲）
+ * expression：mustache 表达式，可带过滤器（{{ order.total | currency:'CNY' }}）
+ */
+
+/** 字段路径绑定，如 "customer.name"、"order.orderNo" */
+export type BindingPath = string
+
+export interface Binding {
+  /** 数据路径（相对数据源根） */
+  path: BindingPath
+  /** 可选格式化器名（currency / date / number 等，见 core/expression.ts） */
+  formatter?: string
+  /** 格式化器参数 */
+  formatterArgs?: unknown[]
+}
diff --git a/openprint/src/types/control.ts b/openprint/src/types/control.ts
new file mode 100644
index 0000000..926d3a0
--- /dev/null
+++ b/openprint/src/types/control.ts
@@ -0,0 +1,404 @@
+/**
+ * 控件协议类型 —— 《OpenPrint-设计方案.md》§5.2 ~ §5.8 / §5.14
+ *
+ * 所有几何字段（left/top/width/height）单位与 page.unit 一致（默认 mm），
+ * 坐标原点为所属 Section 左上角；设计器画布层负责 mm ⇄ px 换算（core/units.ts）。
+ */
+
+import type { ChartKind, ChartSeries, ChartOptions } from '../core/chartkit/types'
+
+export type ControlType =
+  | 'text'
+  | 'image'
+  | 'table'
+  | 'barcode'
+  | 'qrcode'
+  | 'richtext'
+  | 'rect'
+  | 'line'
+  | 'chart'
+  | 'zone'
+
+/** 全部控件的公共基座（§5.4a：printable 为通用属性） */
+export interface ControlBase {
+  /** 控件唯一 ID（utils/id.ts 生成） */
+  id: string
+  type: ControlType
+  /** 相对所属 Section 左上角 */
+  left: number
+  top: number
+  width: number
+  height: number
+  /** 旋转角度（度） */
+  angle?: number
+  /** 不打印开关：false 时渲染期跳过，设计画布仍显示（默认 true） */
+  printable?: boolean
+  /** 条件渲染表达式，如 "data.vip === true"（§5.6） */
+  visibleIf?: string
+  /** 锁定：设计期禁止移动/缩放 */
+  locked?: boolean
+  /** 图层名（图层面板显示用，默认取类型+序号） */
+  name?: string
+  /** 常驻辅助线：开启后该元素 4 条边界辅助线始终显示（不限于拖拽时） */
+  showGuides?: boolean
+}
+
+/* ---------------------------------- 文本 ---------------------------------- */
+
+export interface TextStyle {
+  /** 字号（pt） */
+  fontSize?: number
+  /** 字体颜色 hex / rgba */
+  fill?: string
+  fontFamily?: string
+  fontWeight?: 'normal' | 'bold'
+  /** 斜体：'italic' 开启，'normal' 或不写为常规 */
+  fontStyle?: 'normal' | 'italic'
+  /** 下划线：'underline' 开启，'none' 或不写为无 */
+  textDecoration?: 'none' | 'underline'
+  /** 控件内文字水平对齐（协议不放 verticalAlign，见 §5.2 警告） */
+  textAlign?: 'left' | 'center' | 'right'
+  /** 行高倍率 */
+  lineHeight?: number
+  /** 字间距（pt） */
+  letterSpacing?: number
+}
+
+export interface TextControl extends ControlBase {
+  type: 'text'
+  /** 静态文本（与 binding/expression 三选一） */
+  value?: string
+  /** 字段绑定路径，如 "customer.name" */
+  binding?: string
+  /** mustache 表达式，如 "{{order.total | currency:'CNY'}}" */
+  expression?: string
+  /** 绑定字段的取值格式（仅 binding 模式生效；expression 模式请用 {{field | date:'...'}} 过滤器） */
+  format?: CellFormat
+  style?: TextStyle
+}
+
+/* ---------------------------------- 图片 ---------------------------------- */
+
+export type ImageValueMode = 'inline' | 'url' | 'asset' | 'binding'
+
+export interface ImageControl extends ControlBase {
+  type: 'image'
+  value?: {
+    /** inline=Base64 内联 / url=外部 URL / asset=本地托管资源 / binding=绑定字段 */
+    mode: ImageValueMode
+    /** mode=binding 时为字段路径；否则为内容本体 */
+    content: string
+  }
+  /** 填充方式 */
+  fit?: 'contain' | 'cover' | 'fill' | 'none'
+  /** 圆角（px，Fabric rx/ry） */
+  cornerRadius?: number
+}
+
+/* ---------------------------------- 表格 ---------------------------------- */
+
+export type HAlign = 'left' | 'center' | 'right'
+
+/**
+ * 单元格样式 —— 表头 / 数据 / 静态单元格通用。
+ * 优先级：单元格样式 > 列样式(TableColumn.style) > 表格默认样式(options.defaultCellStyle)。
+ */
+export interface TableCellStyle {
+  /** 字号（pt） */
+  fontSize?: number
+  fontFamily?: string
+  bold?: boolean
+  italic?: boolean
+  underline?: boolean
+  /** 文字颜色 hex / rgba */
+  color?: string
+  /** 水平对齐 */
+  align?: HAlign
+  /** 垂直对齐 */
+  valign?: 'top' | 'middle' | 'bottom'
+  /** 单元格填充色 */
+  backgroundColor?: string
+  /** 单元格斜线（课表角标等场景）：none=无 / down=左上→右下 / up=左下→右上 */
+  diagonal?: 'none' | 'down' | 'up'
+}
+
+/**
+ * 单元格数据格式 —— 绑定字段/表达式的显示格式（非技术用户无需手写 `{{field | date:'...'}}`）。
+ * 复用引擎内置格式化器（date/number/currency/percent），UI 在属性面板与单元格工具栏提供可视化选择。
+ * 优先级：单元格 format > 列 format > 无（默认 stringify）。
+ */
+export type CellFormatKind =
+  | 'none' // 不格式化（默认）
+  | 'text' // 纯文本（等同 none，语义化占位）
+  | 'date' // 日期，按 pattern 模板（YYYY-MM-DD / YYYY年MM月DD日 / MM/DD/YYYY ...）
+  | 'int' // 整数（默认带千分位）
+  | 'decimal' // 定点小数，digits 位（默认 2，带千分位）
+  | 'currency' // 货币，code 币种 + digits 位（默认 CNY / 2 位 / 千分位）
+  | 'percent' // 百分比，digits 位（默认 2）
+
+export interface CellFormat {
+  kind: CellFormatKind
+  /** date：日期模板，如 'YYYY-MM-DD' / 'YYYY年MM月DD日' / 'MM/DD/YYYY' */
+  pattern?: string
+  /** int/decimal/currency/percent：小数位数（0~6） */
+  digits?: number
+  /** currency：币种代码（CNY/USD/EUR/GBP/HKD/JPY...） */
+  code?: string
+  /** int/decimal/currency：是否加千分位（默认 true）；false 走不分组定点 */
+  thousands?: boolean
+}
+
+export interface TableColumn {
+  title: string
+  /** 数据字段名（与 expression 二选一） */
+  field?: string
+  /** 行表达式，如 "{{rowIndex + 1}}" / "{{row.price * row.qty}}" */
+  expression?: string
+  /** 列宽（page.unit） */
+  width: number
+  /** 单元格内容水平对齐 */
+  align?: HAlign
+  /** 表头文字对齐（默认跟随 align） */
+  headerAlign?: HAlign
+  cellBackgroundColor?: string
+  headerBackgroundColor?: string
+  /** 单元格内边距（mm，默认 4） */
+  cellPadding?: number
+  /** 该列数据单元格的默认样式（被单元格样式覆盖） */
+  style?: TableCellStyle
+  /** 该列数据单元格的默认显示格式（被单元格 format 覆盖） */
+  format?: CellFormat
+  /**
+   * 是否参与尾行合计（本页合计 / 总计）。
+   * - 未设置：由字段类型 / 数据采样推断（数值列参与）。
+   * - true / 'sum' / 'avg' / 'count'：强制参与。
+   * - false：强制不参与（如名称、备注等字符串列）。
+   */
+  aggregate?: boolean | 'sum' | 'avg' | 'count'
+}
+
+/**
+ * 单元格模型 —— 设计期可双击编辑的最小单元。
+ * 数据表：前 headerRows 行为表头（静态），第 headerRows 行为数据样例行（模板，应用到整列），
+ * 其后 staticRows 行为静态尾行（合计 / 备注等）。
+ * 布局网格（无 dataSource）：全部 designRows 行均为静态内容。
+ */
+export interface TableCell {
+  /** 静态文字（无数据时显示 / 设计期占位） */
+  text?: string
+  /** 字段绑定路径（数据源数组元素的字段），优先级高于 text */
+  field?: string
+  /** 行表达式，如 "{{row.price * row.qty}}" */
+  expression?: string
+  /** 单元格样式（覆盖列 / 表格默认样式） */
+  style?: TableCellStyle
+  /** 单元格显示格式（覆盖列 format） */
+  format?: CellFormat
+  /** 跨列数（含本列，≥2 时合并右侧单元格） */
+  colSpan?: number
+  /**
+   * 跨行数（含本行，≥2 时合并下方单元格）。
+   * 仅表头 / 静态 / 布局网格行生效；数据行的"数据样例行（模板）"不跨行——数据行由运行期逐条
+   * 生成，跨行会跨越不同数据记录，语义不成立，故引擎对该行强制 rowSpan=1。
+   */
+  rowSpan?: number
+}
+
+/** 表格样式预设（Excel 式快速切换；渲染端把同名 class 挂在 <table> 上，CSS 见 css-generator.ts） */
+export type TableStylePreset =
+  | 'none'
+  | 'header'
+  | 'header-dark'
+  | 'header-green'
+  | 'zebra'
+  | 'zebra-blue'
+  | 'zebra-gray'
+  | 'three-segment'
+  | 'banded-cols'
+  | 'grid'
+  | 'minimal'
+  | 'report'
+  | 'timetable'
+
+export interface TableOptions {
+  /** 每页打印标题行（默认 true） */
+  repeatHeader?: boolean
+  /** 每页打印合计行/表尾（默认 true；false 则只在最后一页） */
+  repeatFooter?: boolean
+  /** 每页行数：数字强制固定 / "auto" 由引擎按可用高度计算（默认 auto） */
+  pageRows?: number | 'auto'
+  rowHeightMode?: 'auto' | 'fixed'
+  /** 固定行高（mm），仅 rowHeightMode=fixed 生效 */
+  rowHeight?: number
+  /** 整行跨页时换至下一页（默认 false） */
+  keepTogether?: boolean
+  /** 数据行全空时跳过不打印（默认 false） */
+  skipEmptyRows?: boolean
+  /** 多单合并打印（默认 false，§9.2.1a） */
+  mergeSheets?: boolean
+  /** 斑马纹（默认 false） */
+  striped?: boolean
+  /** 单元格内容垂直对齐（渲染引擎实现，默认 middle） */
+  verticalAlign?: 'top' | 'middle' | 'bottom'
+  /** 边框：all / none / horizontal / outline / three-line（三线表：顶线 + 表头底线 + 底线，无内部/竖线） */
+  borders?: 'all' | 'none' | 'horizontal' | 'outline' | 'three-line'
+  /** 表格样式预设（默认 none = 仅边框 + 表头加粗，无任何背景色，含标题行） */
+  tableStyle?: TableStylePreset
+  /** 整表默认单元格样式（被列 / 单元格样式覆盖） */
+  defaultCellStyle?: TableCellStyle
+  summaryRow?: {
+    type: 'sum' | 'count' | 'custom'
+    /** 聚合列（列 field 清单） */
+    fields?: string[]
+    /** 合计行标签（默认「合计」）；type=custom 且无 fields 时此标签前的单元格放置计算结果 */
+    label?: string
+    /**
+     * 自定义合计（type=custom）单表达式兜底：求值作用域含预计算的
+     * `sum`/`avg`（按列 field 聚合后的数值）、`rows`（当前分组行）、`allRows`（整表行）。
+     * 例如 `"sum.amount - sum.discount"`。
+     */
+    expression?: string
+    /** 自定义合计：字段 → 专属表达式，优先级高于 `expression` */
+    expressions?: Record<string, string>
+    /** 分组小计标签模板，用 `${key}` 占位分组值（默认 "${key} 小计"） */
+    subtotalLabel?: string
+    /** 分组小计行样式（覆盖默认加粗 + 浅灰底；被单元格样式再覆盖） */
+    subtotalStyle?: TableCellStyle
+  }
+}
+
+export interface TableControl extends ControlBase {
+  type: 'table'
+  /** 数据源数组路径；为空则为布局网格（空白表格） */
+  dataSource?: string
+  /**
+   * 表格自带内嵌数据行（导入数据场景）。当 dataSource 为空但有 data 时，
+   * 引擎直接以 data 作为数据行并自动分页，从而与「数据源字段绑定」彻底解耦。
+   */
+  data?: Array<Record<string, unknown>>
+  columns: TableColumn[]
+  options?: TableOptions
+  /** 分组字段（§5.5） */
+  groupBy?: string
+  summary?: Array<{ type: 'sum' | 'count'; field: string; label?: string }>
+  /**
+   * 设计期单元格网格（行优先 [row][col]）。**运行期打印同样以它为内容与样式真理源**。
+   * - 数据表：长度 = headerRows + 1(数据样例行) + staticRows，行与可视行 1:1 对应。
+   * - 布局网格（无 dataSource）：长度 = headerRows + designRows。
+   * 未设置时由列配置瞬时推导（buildDesignGrid），因此老模板行为完全不变。
+   */
+  cells?: TableCell[][]
+  /** 表头行数（默认：有列标题 → 1，否则 0） */
+  headerRows?: number
+  /** 静态尾行数（合计 / 备注，置于数据行之后；默认 0） */
+  staticRows?: number
+  /** 布局网格正文行数（**不含表头**；默认由控件高度推算） */
+  designRows?: number
+}
+
+/* ------------------------------- 条码 / 二维码 ------------------------------ */
+
+export interface BarcodeControl extends ControlBase {
+  type: 'barcode'
+  binding?: string
+  value?: string
+  /** bwip-js bcid，如 CODE128 / EAN13 */
+  format?: string
+  /** 是否显示文字 */
+  showText?: boolean
+}
+
+export interface QrcodeControl extends ControlBase {
+  type: 'qrcode'
+  binding?: string
+  value?: string
+  /** 纠错级别 L/M/Q/H */
+  errorLevel?: 'L' | 'M' | 'Q' | 'H'
+}
+
+/* --------------------------------- 形状 ---------------------------------- */
+
+export interface RectControl extends ControlBase {
+  type: 'rect'
+  fill?: string
+  stroke?: string
+  strokeWidth?: number
+  /** 统一圆角（px）；若四角独立值中有任意一项被显式设置，则统一值让位于该独立值 */
+  cornerRadius?: number
+  /** 四角独立圆角（px），分别覆盖 cornerRadius 的对应角；未设置时回落到 cornerRadius */
+  cornerRadiusTL?: number
+  cornerRadiusTR?: number
+  cornerRadiusBR?: number
+  cornerRadiusBL?: number
+  /** 形状：矩形 / 圆形（圆形由画布 Ellipse + 渲染 border-radius:50% 实现） */
+  shape?: 'rect' | 'circle'
+  /** 虚线模式（如 [6,4] 表示 6px 实线 4px 间隔） */
+  strokeDashArray?: number[]
+}
+
+export interface LineControl extends ControlBase {
+  type: 'line'
+  stroke?: string
+  strokeWidth?: number
+  /** 虚线模式 */
+  strokeDashArray?: number[]
+}
+
+/* -------------------------------- 富文本 --------------------------------- */
+
+export interface RichTextControl extends ControlBase {
+  type: 'richtext'
+  /** HTML 内容（注入前必须 DOMPurify 消毒） */
+  value?: string
+}
+
+/* --------------------------------- 图表 ---------------------------------- */
+
+/**
+ * ChartControl（原生 SVG 图表控件）：零依赖手写 SVG（src/core/chartkit）。
+ * 整张图是矢量，导出 PDF/SVG 与表格/文本同走"设计即打印"链路。
+ * 数据全部可序列化进设计文件（kind / categories / series / options）。
+ */
+export interface ChartControl extends ControlBase {
+  type: 'chart'
+  /** 图表类型：条形 bar / 折线 line / 饼图 pie */
+  kind: ChartKind
+  /** 类目轴标签（条形/折线为 x 轴；饼图为扇区名） */
+  categories: string[]
+  /** 数据序列；饼图通常只取 series[0] 的每个数据点作为一个扇区 */
+  series: ChartSeries[]
+  /** 外观选项（标题、图例、坐标轴、配色、平滑/面积/环形等） */
+  options?: ChartOptions
+}
+
+/* ------------------------------ 页眉页脚区域 ------------------------------- */
+
+/**
+ * ZoneControl（§5.14）：画布上的"可编辑色带"，序列化目标是
+ * document.page.sections 里的 header/footer 区块，**不得**混入 body.components。
+ * 单例：每页最多一个 header + 一个 footer。
+ */
+export interface ZoneControl extends ControlBase {
+  type: 'zone'
+  zone: 'header' | 'footer'
+  /** 高度（page.unit），回写 section.height */
+  zoneHeight: number
+  /** 每页重复（默认 true） */
+  repeat?: boolean
+  /** 子组件（坐标相对色带左上角） */
+  children: AnyControl[]
+}
+
+/* --------------------------------- 联合 ---------------------------------- */
+
+export type AnyControl =
+  | TextControl
+  | ImageControl
+  | TableControl
+  | BarcodeControl
+  | QrcodeControl
+  | RectControl
+  | LineControl
+  | RichTextControl
+  | ChartControl
+  | ZoneControl
diff --git a/openprint/src/types/datasource.ts b/openprint/src/types/datasource.ts
new file mode 100644
index 0000000..f7c4f40
--- /dev/null
+++ b/openprint/src/types/datasource.ts
@@ -0,0 +1,79 @@
+/**
+ * 数据源契约 —— 《OpenPrint-设计方案.md》§19.4.3a
+ *
+ * 「内省优先 + 标注增强」：字段定义源头 = 数据库 schema（自动合并），
+ * 标注表仅覆盖 label/hidden/group。后端未就绪时 createMockDataSource 开箱即用。
+ *
+ * 关键接口变更（v5）：DataSourceMeta 支持多表层级，FieldDef 增加分组/隐藏/排序字段。
+ */
+export interface FieldDef {
+  /** 字段完整路径，如 "order.no"、"customer.name"、"items[].productName" */
+  path: string
+  /** 中文显示名（标注覆盖 > schema 注释 > 自动生成） */
+  label: string
+  /** 数据类型 */
+  type: 'string' | 'number' | 'boolean' | 'date' | 'image' | 'array' | 'object'
+  /** 枚举选项 */
+  options?: { value: string; label: string }[]
+  /** 示例值（设计器预览/占位符用） */
+  sample?: unknown
+
+  // === 增强字段（标注表提供，schema 内省时可为空） ===
+
+  /** 所属表 ID（设计器按此分组展现金蝶式树形） */
+  tableId?: string
+  /** 分组名（如 "基础信息"/"金额信息"/"自定义"） */
+  group?: string
+  /** 排序权重（升序，默认 0） */
+  sort?: number
+  /** 是否在字段面板隐藏（true=隐藏，但已绑定的旧模板仍可用该 path） */
+  hidden?: boolean
+  /** 是否 ERP 自定义字段 */
+  custom?: boolean
+  /** 只读标记（UI 提示，不影响打印） */
+  readonly?: boolean
+  /** 图片格式列表（仅 type=image 时有意义） */
+  format?: string[]
+}
+
+export interface TableMeta {
+  /** 表标识，如 "order"、"order_item"、"customer" */
+  id: string
+  /** 表显示名，如 "订单主表"、"订单明细"、"客户信息" */
+  name: string
+  /** 关系类型 */
+  relation: 'main' | 'detail' | 'join'
+  /** 路径前缀（用于拼字段完整 path，如 "order."、"customer."、"items[]"） */
+  pathPrefix: string
+  /** 是否数组（relation=detail 通常为 true，绑定后渲染期按数组迭代） */
+  isArray?: boolean
+  /** 关联键（仅文档说明，设计器不强校验） */
+  joinKey?: string
+  extra?: Record<string, unknown>
+}
+
+export interface DataSourceMeta {
+  /** 数据源 ID，如 "sale_order" */
+  id: string
+  /** 名称，如 "销售订单" */
+  name: string
+  description?: string
+  /** 子表层级（金蝶式可展开） */
+  tables?: TableMeta[]
+}
+
+/**
+ * DataSourceRepository —— 数据源仓库契约（增强版，§19.4.3a）
+ *
+ * 三种实现模式可互换（接口完全相同）：
+ * - A：内省模式（后端 information_schema 自动发现）
+ * - B：声明模式（后端返回固定 JSON）
+ * - C：自定义实现（GraphQL / RPC / 任意数据源）
+ * - Mock：createMockDataSource()（内置静态示例，零后端开箱即用）
+ */
+export interface DataSourceRepository {
+  /** 列出可用数据源（含子表层级） */
+  listSources(): Promise<DataSourceMeta[]>
+  /** 获取某数据源的字段定义（扁平列表，设计器按 tableId 分组为树形） */
+  getFields(sourceId: string): Promise<FieldDef[]>
+}
diff --git a/openprint/src/types/opentype.d.ts b/openprint/src/types/opentype.d.ts
new file mode 100644
index 0000000..5441e4b
--- /dev/null
+++ b/openprint/src/types/opentype.d.ts
@@ -0,0 +1,3 @@
+// opentype.js 自带类型声明缺失，统一声明为 any（仅导出路径在浏览器内按需动态 import，
+// 用于把图表 SVG 的 <text> 展开为矢量字形轮廓，无需类型约束）。
+declare module 'opentype.js'
diff --git a/openprint/src/types/template.ts b/openprint/src/types/template.ts
new file mode 100644
index 0000000..b60efb3
--- /dev/null
+++ b/openprint/src/types/template.ts
@@ -0,0 +1,94 @@
+/**
+ * OpenPrint 模板协议 —— 顶层结构类型
+ * 真理源：《OpenPrint-设计方案.md》§5.1 / §13.1
+ *
+ * 结构：Document → Page → Section → Component
+ * page 一律存精确数字尺寸（width + height + unit），不存预设别名。
+ */
+
+/** 协议层只接受 mm / in / pt 三种单位（Renderer 内部全部换算成 mm） */
+export type PageUnit = 'mm' | 'in' | 'pt'
+
+export interface PageMargin {
+  top: number
+  bottom: number
+  left: number
+  right: number
+}
+
+export interface PageSetup {
+  /** 宽（unit 单位下的精确数字，物理尺寸：横向时宽>高） */
+  width: number
+  /** 高 */
+  height: number
+  unit: PageUnit
+  /** 方向标志（设计器面板切换方向时已交换 width/height，此处为派生值） */
+  orientation: 'portrait' | 'landscape'
+  margin: PageMargin
+  /** 画布页面背景色（rgba / hex；缺省 = 白底） */
+  backgroundColor?: string
+  /** 水印配置（缺省 = 无） */
+  watermark?: WatermarkConfig
+  /** 手动分页下限：物理页数至少为 N（0/缺省 = 完全由内容推导） */
+  minPages?: number
+}
+
+/**
+ * 水印配置（页面级装饰，随模板持久化）
+ * - mode 由 `tile` 表示：false = 居中单个水印；true = 全页平铺
+ * - fontSize / rotation 单位分别为 mm / 度
+ */
+export interface WatermarkConfig {
+  /** 是否启用 */
+  enabled: boolean
+  /** 水印文本 */
+  text: string
+  /** 文本颜色（rgba / hex） */
+  color: string
+  /** 字号（mm） */
+  fontSize: number
+  /** 旋转角度（度，默认 45） */
+  rotation: number
+  /** true = 全页平铺；false = 居中单个 */
+  tile: boolean
+}
+
+/** 页面装饰（背景 + 水印），渲染/导出管线统一消费 */
+export interface PageDecoration {
+  backgroundColor?: string
+  watermark?: WatermarkConfig
+}
+
+/** 页眉 / 页脚区块；body 为正文（唯一且必须存在） */
+export type SectionType = 'header' | 'body' | 'footer'
+
+export interface Section<C = unknown> {
+  type: SectionType
+  /** header/footer 必填，单位与 page.unit 一致 */
+  height?: number
+  /** 是否每页重复（仅 header/footer 有意义，默认 true） */
+  repeat?: boolean
+  components: C[]
+}
+
+export interface Document<C = unknown> {
+  /** 文档类型，当前仅 report */
+  type: 'report'
+  page: PageSetup
+  sections: Section<C>[]
+}
+
+export interface TemplateData<C = unknown> {
+  version: string
+  document: Document<C>
+}
+
+/** 画布网格配置（运行时视图状态，辅助设计，不持久化） */
+export interface GridConfig {
+  /** 是否显示网格线 */
+  visible: boolean
+  /** 网格间距（mm） */
+  sizeMm: number
+  /** 网格线颜色（rgba / hex） */
+  color: string
+}
diff --git a/openprint/src/utils/constants.ts b/openprint/src/utils/constants.ts
new file mode 100644
index 0000000..c23d31d
--- /dev/null
+++ b/openprint/src/utils/constants.ts
@@ -0,0 +1,51 @@
+/**
+ * 设计器常量 —— 《标尺与辅助系统》§13
+ * 注意：core/units.ts 的 PX_PER_MM 与此 MM_TO_PX 同值，两处同源不可改一个不改另一个。
+ */
+
+/** 1mm = 3.7795275591 px (96 DPI)；纯显示换算，不含 DPR（DPR 由 Fabric/浏览器处理） */
+export const MM_TO_PX = 3.7795275591
+
+/** 标尺配色（浅色主题；深色主题由 ui store 切换） */
+export const RULER_PALETTE_LIGHT = {
+  bgColor: '#ffffff',
+  tickColor: '#c0c4cc',
+  labelColor: '#909399',
+  guideColor: '#00A8FF', // PS 蓝
+  guideLockedColor: '#999',
+  guideDashArray: '4,3',
+  smartGuideColor: '#FF3366', // Figma 红粉
+  gridColor: 'rgba(128,128,128,0.15)',
+  shadowColor: 'rgba(0,168,255,0.1)',
+  /** 选中/拖拽元素在标尺上的高亮带（琥珀，与蓝色辅助线对比突出） */
+  bandColor: 'rgba(245, 158, 11, 0.30)',
+  bandBorder: 'rgba(217, 119, 6, 0.85)',
+  bandText: '#7c2d12',
+} as const
+
+export const RULER_PALETTE_DARK = {
+  bgColor: '#1e1e1e',
+  tickColor: '#555',
+  labelColor: '#999',
+  guideColor: '#00A8FF',
+  guideLockedColor: '#666',
+  guideDashArray: '4,3',
+  smartGuideColor: '#FF3366',
+  gridColor: 'rgba(128,128,128,0.15)',
+  shadowColor: 'rgba(0,168,255,0.1)',
+  /** 选中/拖拽元素在标尺上的高亮带 */
+  bandColor: 'rgba(245, 158, 11, 0.38)',
+  bandBorder: 'rgba(251, 191, 36, 0.9)',
+  bandText: '#fff7ed',
+} as const
+
+/** 默认吸附阈值（mm） */
+export const DEFAULT_SNAP_THRESHOLD = 0.5
+
+/** 标尺厚度（px） */
+export const RULER_THICK = 20
+
+/** 缩放范围与步进 */
+export const ZOOM_MIN = 0.25
+export const ZOOM_MAX = 4
+export const ZOOM_STEP = 0.25
diff --git a/openprint/src/utils/id.ts b/openprint/src/utils/id.ts
new file mode 100644
index 0000000..eb55b06
--- /dev/null
+++ b/openprint/src/utils/id.ts
@@ -0,0 +1,15 @@
+/** 控件 / 模板 ID 生成 */
+
+let counter = 0
+
+/**
+ * 生成短唯一 ID：`{prefix}_{时间戳36进制}{自增36进制}{随机4位}`
+ * 例：ctl_lx3k9a1f2x8q
+ */
+export function genId(prefix = 'ctl'): string {
+  counter = (counter + 1) % 1296 // 36^2
+  const time = Date.now().toString(36)
+  const seq = counter.toString(36).padStart(2, '0')
+  const rand = Math.random().toString(36).slice(2, 6)
+  return `${prefix}_${time}${seq}${rand}`
+}
diff --git a/openprint/tsconfig.app.json b/openprint/tsconfig.app.json
new file mode 100644
index 0000000..c0f2d86
--- /dev/null
+++ b/openprint/tsconfig.app.json
@@ -0,0 +1,18 @@
+{
+  "extends": "@vue/tsconfig/tsconfig.dom.json",
+  "include": ["env.d.ts", "src/**/*", "src/**/*.vue"],
+  "exclude": ["src/**/__tests__/*"],
+  "compilerOptions": {
+    // Extra safety for array and object lookups, but may have false positives.
+    "noUncheckedIndexedAccess": true,
+
+    // Path mapping for cleaner imports.
+    "paths": {
+      "@/*": ["./src/*"]
+    },
+
+    // `vue-tsc --build` produces a .tsbuildinfo file for incremental type-checking.
+    // Specified here to keep it out of the root directory.
+    "tsBuildInfoFile": "./node_modules/.tmp/tsconfig.app.tsbuildinfo"
+  }
+}
diff --git a/openprint/tsconfig.json b/openprint/tsconfig.json
new file mode 100644
index 0000000..66b5e57
--- /dev/null
+++ b/openprint/tsconfig.json
@@ -0,0 +1,11 @@
+{
+  "files": [],
+  "references": [
+    {
+      "path": "./tsconfig.node.json"
+    },
+    {
+      "path": "./tsconfig.app.json"
+    }
+  ]
+}
diff --git a/openprint/tsconfig.node.json b/openprint/tsconfig.node.json
new file mode 100644
index 0000000..c9b2bad
--- /dev/null
+++ b/openprint/tsconfig.node.json
@@ -0,0 +1,27 @@
+// TSConfig for modules that run in Node.js environment via either transpilation or type-stripping.
+{
+  "extends": "@tsconfig/node24/tsconfig.json",
+  "include": [
+    "vite.config.*",
+    "vitest.config.*",
+    "cypress.config.*",
+    "playwright.config.*",
+    "eslint.config.*"
+  ],
+  "compilerOptions": {
+    // Most tools use transpilation instead of Node.js's native type-stripping.
+    // Bundler mode provides a smoother developer experience.
+    "module": "preserve",
+    "moduleResolution": "bundler",
+
+    // Include Node.js types and avoid accidentally including other `@types/*` packages.
+    "types": ["node"],
+
+    // Disable emitting output during `vue-tsc --build`, which is used for type-checking only.
+    "noEmit": true,
+
+    // `vue-tsc --build` produces a .tsbuildinfo file for incremental type-checking.
+    // Specified here to keep it out of the root directory.
+    "tsBuildInfoFile": "./node_modules/.tmp/tsconfig.node.tsbuildinfo"
+  }
+}
diff --git a/openprint/uno.config.ts b/openprint/uno.config.ts
new file mode 100644
index 0000000..a3bb7b5
--- /dev/null
+++ b/openprint/uno.config.ts
@@ -0,0 +1,62 @@
+import { defineConfig, presetWind4, presetIcons } from 'unocss'
+
+/**
+ * unocss 品牌色 —— 取 main.css 中的 CSS 变量（随亮暗主题自动切换）
+ * 这样：<div class="bg-brand-primary text-brand-text-1 border-brand-border"> 即与主题联动
+ *
+ * 注意：uno.config 在 build 时解析；theme.colors 必须是具体字符串，
+ * 因此我们把颜色指向 CSS 变量的 `var(...)` 形式——浏览器渲染时会取到对应主题的值。
+ */
+export default defineConfig({
+  presets: [
+    presetWind4({
+      darkMode: 'class', // html.dark → 与 naive-ui darkTheme 同 class
+    }),
+    presetIcons({ scale: 1.2, warn: true }),
+  ],
+  /**
+   * 图标安全清单：CellToolbar 等处的对齐/垂直对齐图标用 `` `i-carbon-xxx-${v}` `` 模板字面量
+   * 在运行期拼接，UnoCSS 的静态扫描看不到完整类名，故必须显式列入 safelist 才会生成图标 CSS，
+   * 否则对应按钮图标空白（看不见）。这里集中登记所有「动态拼接」的 carbon 图标。
+   */
+  safelist: [
+    'i-carbon-text-align-left',
+    'i-carbon-text-align-center',
+    'i-carbon-text-align-right',
+    'i-carbon-align-vertical-top',
+    'i-carbon-align-vertical-center',
+    'i-carbon-align-vertical-bottom',
+    'i-carbon-text-color',
+    'i-carbon-paint-brush',
+    'i-carbon-color-palette',
+    'i-carbon-clean',
+    'i-carbon-close',
+  ],
+  theme: {
+    colors: {
+      brand: {
+        primary: 'var(--brand-primary)',
+        'primary-hover': 'var(--brand-primary-hover)',
+        'primary-pressed': 'var(--brand-primary-pressed)',
+        dark: 'var(--brand-nav-bg)',
+        bg: 'var(--brand-bg)',
+        surface: 'var(--brand-surface)',
+        border: 'var(--brand-border)',
+        'text-1': 'var(--brand-text-1)',
+        'text-2': 'var(--brand-text-2)',
+        'text-3': 'var(--brand-text-3)',
+        muted: 'var(--brand-text-muted)',
+        nav: {
+          DEFAULT: 'var(--brand-nav-bg)',
+          hover: 'var(--brand-nav-bg-hover)',
+          text: 'var(--brand-nav-text)',
+          'text-muted': 'var(--brand-nav-text-muted)',
+          'text-active': 'var(--brand-nav-text-active)',
+          icon: 'var(--brand-nav-icon)',
+          'icon-hover': 'var(--brand-nav-icon-hover)',
+        },
+      },
+    },
+  },
+  variants: [],
+})
diff --git a/openprint/vite.config.ts b/openprint/vite.config.ts
new file mode 100644
index 0000000..0c99612
--- /dev/null
+++ b/openprint/vite.config.ts
@@ -0,0 +1,58 @@
+import { fileURLToPath, URL } from 'node:url'
+
+import { defineConfig } from 'vite'
+import vue from '@vitejs/plugin-vue'
+import vueDevTools from 'vite-plugin-vue-devtools'
+import unocss from 'unocss/vite'
+
+// https://vite.dev/config/
+export default defineConfig({
+  plugins: [vue(), vueDevTools(), unocss()],
+    server: {
+    host: '0.0.0.0',
+    port: 5227,
+    open: true,
+  },
+  preview: {
+    port: 5227,
+     host: '0.0.0.0'
+  },
+  resolve: {
+    alias: {
+      '@': fileURLToPath(new URL('./src', import.meta.url)),
+    },
+    // CodeMirror 6 子包必须单例，否则 instanceof 检查失败（"multiple instances of @codemirror/state"）
+    dedupe: ['@codemirror/state', '@codemirror/view', '@codemirror/language', '@codemirror/commands', '@lezer/common', '@lezer/highlight', '@lezer/lr', '@lezer/json'],
+  },
+  optimizeDeps: {
+    // 预打包，避免运行时动态 import 触发二次优化导致 dev server 重启
+    // （tiptap 相关：富文本编辑器 defineAsyncComponent 懒加载，若不在 include 里，
+    //  首次选中富文本时会触发 re-optimize 删除 deps_temp，被 safe-delete 守卫拦崩 dev server）
+    include: [
+      'ajv',
+      'fabric',
+      'qrcode',
+      '@bwip-js/generic',
+      '@tiptap/vue-3',
+      '@tiptap/starter-kit',
+      '@tiptap/extension-text-style',
+      '@tiptap/extension-font-family',
+      'codemirror',
+      'vue-codemirror6',
+      '@codemirror/lang-json',
+    ],
+  },
+  build: {
+    // jspdf + svg2pdf.js 走动态 import，避免进主包
+    rollupOptions: {
+      output: {
+        manualChunks(id: string) {
+          if (id.includes('node_modules')) {
+            if (id.includes('jspdf') || id.includes('svg2pdf')) return 'pdf'
+            if (id.includes('fabric')) return 'fabric'
+          }
+        },
+      },
+    },
+  },
+})
diff --git a/openprint/vitest.config.ts b/openprint/vitest.config.ts
new file mode 100644
index 0000000..171d191
--- /dev/null
+++ b/openprint/vitest.config.ts
@@ -0,0 +1,37 @@
+import { fileURLToPath, URL } from 'node:url'
+
+import { defineConfig } from 'vitest/config'
+import vue from '@vitejs/plugin-vue'
+
+// 测试配置：复用项目的 @ alias；环境用 happy-dom（无真实排版，纯函数测试足够）。
+// 不引入 unocss 插件——核心单测不依赖 unocss 虚拟模块，避免测试期副作用。
+export default defineConfig({
+  // vue() 插件类型与 vitest 内置 vite（rolldown/rollup 双实现）存在类型冲突，
+  // 此处为测试配置，强制 any 以通过 vue-tsc 类型检查（不影响运行）。
+  plugins: [vue() as unknown as never],
+  server: {
+    host: '0.0.0.0',
+    port: 5227,
+    open: true,
+  },
+  preview: {
+    port: 5227,
+     host: '0.0.0.0'
+  },
+  resolve: {
+    alias: {
+      '@': fileURLToPath(new URL('./src', import.meta.url)),
+    },
+  },
+  test: {
+    environment: 'happy-dom',
+    globals: false,
+    include: ['src/**/*.spec.ts'],
+    coverage: {
+      provider: 'v8',
+      reporter: ['text', 'html'],
+      include: ['src/core/**/*.ts', 'src/design/preview/**/*.ts', 'src/repository/mock/**/*.ts'],
+      exclude: ['src/core/**/*.d.ts', 'src/core/**/index.ts'],
+    },
+  },
+})
diff --git a/openprint/临时/ai-assistant.png b/openprint/临时/ai-assistant.png
new file mode 100644
index 0000000..e09b742
Binary files /dev/null and b/openprint/临时/ai-assistant.png differ
diff --git a/openprint/临时/cloud-print.jpg b/openprint/临时/cloud-print.jpg
new file mode 100644
index 0000000..56d4929
Binary files /dev/null and b/openprint/临时/cloud-print.jpg differ
diff --git a/openprint/临时/designer-overview.png b/openprint/临时/designer-overview.png
new file mode 100644
index 0000000..4065136
Binary files /dev/null and b/openprint/临时/designer-overview.png differ
diff --git a/openprint/临时/export-test-清晰版.pdf b/openprint/临时/export-test-清晰版.pdf
new file mode 100644
index 0000000..b34117d
Binary files /dev/null and b/openprint/临时/export-test-清晰版.pdf differ
diff --git a/openprint/临时/pdf-300dpi渲染.png b/openprint/临时/pdf-300dpi渲染.png
new file mode 100644
index 0000000..3c0b2b2
Binary files /dev/null and b/openprint/临时/pdf-300dpi渲染.png differ
diff --git a/openprint/临时/receipt-300dpi-png-scale3.png b/openprint/临时/receipt-300dpi-png-scale3.png
new file mode 100644
index 0000000..aa621df
Binary files /dev/null and b/openprint/临时/receipt-300dpi-png-scale3.png differ
diff --git a/openprint/临时/report-design.png b/openprint/临时/report-design.png
new file mode 100644
index 0000000..6b03865
Binary files /dev/null and b/openprint/临时/report-design.png differ
diff --git a/package-lock.json b/package-lock.json
new file mode 100644
index 0000000..17bb9e1
--- /dev/null
+++ b/package-lock.json
@@ -0,0 +1,6 @@
+{
+  "name": "F9智慧缫丝系统",
+  "lockfileVersion": 3,
+  "requires": true,
+  "packages": {}
+}
diff --git a/server/F9MES.slnx b/server/F9MES.slnx
new file mode 100644
index 0000000..82a228a
--- /dev/null
+++ b/server/F9MES.slnx
@@ -0,0 +1,8 @@
+<Solution>
+  <Folder Name="/src/">
+    <Project Path="src/F9MES.Api/F9MES.Api.csproj" />
+    <Project Path="src/F9MES.Application/F9MES.Application.csproj" />
+    <Project Path="src/F9MES.Common/F9MES.Common.csproj" />
+    <Project Path="src/F9MES.Domain/F9MES.Domain.csproj" />
+  </Folder>
+</Solution>
diff --git a/server/src/F9MES.Api/Common/EntityCatalog.cs b/server/src/F9MES.Api/Common/EntityCatalog.cs
new file mode 100644
index 0000000..c154865
--- /dev/null
+++ b/server/src/F9MES.Api/Common/EntityCatalog.cs
@@ -0,0 +1,30 @@
+using System.Reflection;
+using FreeSql.DataAnnotations;
+using F9MES.Common.Entities;
+
+namespace F9MES.Api.Common;
+
+/// <summary>
+/// 实体目录：扫描 F9MES.Domain 程序集，建立 表名→实体类型 映射（DataController / MetaController 共用）
+/// </summary>
+public static class EntityCatalog
+{
+    private static readonly Dictionary<string, Type> _map = Build();
+
+    private static Dictionary<string, Type> Build()
+    {
+        var map = new Dictionary<string, Type>(StringComparer.OrdinalIgnoreCase);
+        var asm = Assembly.Load("F9MES.Domain");
+        foreach (var t in asm.GetTypes())
+        {
+            if (!typeof(BaseEntity).IsAssignableFrom(t) || t.IsAbstract) continue;
+            var name = t.GetCustomAttribute<TableAttribute>()?.Name ?? t.Name;
+            map[name] = t;
+        }
+        return map;
+    }
+
+    public static bool TryGet(string table, out Type type) => _map.TryGetValue(table, out type!);
+
+    public static IReadOnlyCollection<string> Names => _map.Keys;
+}
diff --git a/server/src/F9MES.Api/Controllers/AuthController.cs b/server/src/F9MES.Api/Controllers/AuthController.cs
new file mode 100644
index 0000000..1dfa229
--- /dev/null
+++ b/server/src/F9MES.Api/Controllers/AuthController.cs
@@ -0,0 +1,66 @@
+using F9MES.Application.Auth;
+using F9MES.Common.Auth;
+using F9MES.Common.Result;
+using Microsoft.AspNetCore.Authorization;
+using Microsoft.AspNetCore.Mvc;
+
+namespace F9MES.Api.Controllers;
+
+/// <summary>
+/// 认证控制器：登录、当前用户信息、修改密码
+/// </summary>
+[ApiController]
+[Route("api/auth")]
+public class AuthController : ControllerBase
+{
+    private readonly AuthService _auth;
+    private readonly CurrentUserService _currentUser;
+    private readonly MenuService _menuService;
+
+    public AuthController(AuthService auth, CurrentUserService currentUser, MenuService menuService)
+    {
+        _auth = auth;
+        _currentUser = currentUser;
+        _menuService = menuService;
+    }
+
+    /// <summary>登录（手机号+密码）</summary>
+    [HttpPost("login")]
+    [AllowAnonymous]
+    public async Task<ApiResult> Login([FromBody] LoginDto dto)
+    {
+        return await _auth.LoginAsync(dto.Phone ?? "", dto.Password ?? "");
+    }
+
+    /// <summary>当前用户信息 + 菜单树</summary>
+    [HttpGet("me")]
+    public async Task<ApiResult> Me()
+    {
+        var user = _currentUser.User;
+        if (user == null) return ApiResult.Error("未登录", 401);
+
+        var menus = await _menuService.GetMenuTreeAsync(user);
+        return ApiResult.Ok(new { user, menus });
+    }
+
+    /// <summary>修改密码</summary>
+    [HttpPost("changePassword")]
+    public async Task<ApiResult> ChangePassword([FromBody] ChangePasswordDto dto)
+    {
+        return await _auth.ChangePasswordAsync(_currentUser.UserId, dto.OldPassword ?? "", dto.NewPassword ?? "");
+    }
+}
+
+/// <summary>登录参数</summary>
+public class LoginDto
+{
+    public string? Phone { get; set; }
+    public string? Password { get; set; }
+}
+
+/// <summary>修改密码参数</summary>
+public class ChangePasswordDto
+{
+    public string? OldPassword { get; set; }
+    public string? NewPassword { get; set; }
+}
diff --git a/server/src/F9MES.Api/Controllers/BaseSysController.cs b/server/src/F9MES.Api/Controllers/BaseSysController.cs
new file mode 100644
index 0000000..fe33fe1
--- /dev/null
+++ b/server/src/F9MES.Api/Controllers/BaseSysController.cs
@@ -0,0 +1,145 @@
+using FreeSql;
+using F9MES.Application.Auth;
+using F9MES.Common.Result;
+using F9MES.Domain.BaseCommon;
+using F9MES.Domain.BaseSys;
+using Microsoft.AspNetCore.Authorization;
+using Microsoft.AspNetCore.Mvc;
+
+namespace F9MES.Api.Controllers;
+
+/// <summary>
+/// 系统管理控制器：组织树/字典/用户管理
+/// </summary>
+[ApiController]
+[Route("api/basesys")]
+[Authorize]
+public class BaseSysController : ControllerBase
+{
+    private readonly IFreeSql _db;
+    private readonly AuthService _auth;
+
+    public BaseSysController(IFreeSql db, AuthService auth)
+    {
+        _db = db;
+        _auth = auth;
+    }
+
+    /// <summary>组织架构树</summary>
+    [HttpGet("org/tree")]
+    public async Task<ApiResult> OrgTree()
+    {
+        var orgs = await _db.Queryable<BaseSys_Org>()
+            .Where(a => a.Flag > 0 && a.IsEnable == 1)
+            .OrderBy(a => a.Sort).ToListAsync();
+        return ApiResult.Ok(BuildOrgTree(orgs, 0));
+    }
+
+    private static object BuildOrgTree(List<BaseSys_Org> all, long parentId)
+    {
+        return all.Where(o => o.ParentId == parentId).Select(o => new
+        {
+            o.Id, o.Name, o.Code, o.OrgType, o.Manager, o.Phone,
+            children = BuildOrgTree(all, o.Id)
+        }).ToList();
+    }
+
+    /// <summary>查询字典项（按字典类型编码）</summary>
+    [HttpGet("dict/{typeCode}")]
+    public async Task<ApiResult> GetDict(string typeCode)
+    {
+        var list = await _db.Queryable<BaseCommon_Dict>()
+            .Where(a => a.Flag > 0 && a.TypeCode == typeCode && a.IsEnable == 1)
+            .OrderBy(a => a.Sort)
+            .ToListAsync();
+        return ApiResult.Ok(list.Select(d => new { d.Id, d.DictKey, d.DictValue, d.ExtData }));
+    }
+
+    /// <summary>查询全部字典（按类型分组）</summary>
+    [HttpGet("dict/all")]
+    public async Task<ApiResult> GetAllDicts()
+    {
+        var types = await _db.Queryable<BaseCommon_DictType>()
+            .Where(a => a.Flag > 0).ToListAsync();
+        var dicts = await _db.Queryable<BaseCommon_Dict>()
+            .Where(a => a.Flag > 0 && a.IsEnable == 1)
+            .OrderBy(a => a.Sort).ToListAsync();
+
+        return ApiResult.Ok(types.Select(t => new
+        {
+            t.Id, t.Code, t.Name,
+            items = dicts.Where(d => d.TypeCode == t.Code).Select(d => new { d.Id, d.DictKey, d.DictValue, d.ExtData })
+        }));
+    }
+
+    /// <summary>创建用户（自动生成默认密码哈希）</summary>
+    [HttpPost("user/create")]
+    public async Task<ApiResult> CreateUser([FromBody] CreateUserDto dto)
+    {
+        if (string.IsNullOrWhiteSpace(dto.Phone) || dto.Phone.Length < 6)
+            return ApiResult.Error("手机号不合法");
+
+        var exists = await _db.Queryable<BaseSys_User>()
+            .Where(a => a.Phone == dto.Phone && a.Flag > 0).AnyAsync();
+        if (exists) return ApiResult.Error("该手机号已注册");
+
+        var password = string.IsNullOrWhiteSpace(dto.Password) ? "123456" : dto.Password!;
+        var user = new BaseSys_User
+        {
+            Phone = dto.Phone,
+            Password = AuthService.HashPassword(password),
+            Name = dto.Name ?? dto.Phone,
+            Gender = dto.Gender,
+            IsSuperAdmin = 0,
+            Status = dto.Status ?? 1,
+            AddTime = DateTime.Now,
+            UpdateTime = DateTime.Now
+        };
+        await _db.Insert(user).ExecuteAffrowsAsync();
+        return ApiResult.Ok(new { user.Id }, "创建成功，初始密码 " + password);
+    }
+
+    /// <summary>用户绑定角色</summary>
+    [HttpPost("user/{userId:long}/bindRoles")]
+    public async Task<ApiResult> BindRoles(long userId, [FromBody] List<long> roleIds)
+    {
+        await _db.Delete<BaseSys_UserRole>().Where(a => a.UserId == userId).ExecuteAffrowsAsync();
+        var binds = roleIds.Select(rid => new BaseSys_UserRole { UserId = userId, RoleId = rid }).ToList();
+        if (binds.Count > 0) await _db.Insert(binds).ExecuteAffrowsAsync();
+        return ApiResult.Ok(null, "绑定成功");
+    }
+
+    /// <summary>角色绑定菜单权限</summary>
+    [HttpPost("role/{roleId:long}/bindMenus")]
+    public async Task<ApiResult> BindMenus(long roleId, [FromBody] List<long> menuIds)
+    {
+        await _db.Delete<BaseSys_RoleMenu>().Where(a => a.RoleId == roleId).ExecuteAffrowsAsync();
+        var binds = menuIds.Select(mid => new BaseSys_RoleMenu { RoleId = roleId, MenuId = mid }).ToList();
+        if (binds.Count > 0) await _db.Insert(binds).ExecuteAffrowsAsync();
+        return ApiResult.Ok(null, "授权成功");
+    }
+
+    /// <summary>重置用户密码</summary>
+    [HttpPost("user/resetPassword")]
+    public async Task<ApiResult> ResetPassword([FromBody] ResetPasswordDto dto)
+    {
+        return await _auth.ResetPasswordAsync(dto.UserId, dto.NewPassword ?? "123456");
+    }
+}
+
+/// <summary>创建用户参数</summary>
+public class CreateUserDto
+{
+    public string? Phone { get; set; }
+    public string? Password { get; set; }
+    public string? Name { get; set; }
+    public int Gender { get; set; }
+    public int? Status { get; set; }
+}
+
+/// <summary>重置密码参数</summary>
+public class ResetPasswordDto
+{
+    public long UserId { get; set; }
+    public string? NewPassword { get; set; }
+}
diff --git a/server/src/F9MES.Api/Controllers/DataController.cs b/server/src/F9MES.Api/Controllers/DataController.cs
new file mode 100644
index 0000000..d71c6cd
--- /dev/null
+++ b/server/src/F9MES.Api/Controllers/DataController.cs
@@ -0,0 +1,310 @@
+using System.Reflection;
+using F9MES.Api.Common;
+using F9MES.Application.Base;
+using F9MES.Application.Biz;
+using F9MES.Application.Dtos;
+using F9MES.Common.Entities;
+using F9MES.Common.Result;
+using Microsoft.AspNetCore.Authorization;
+using Microsoft.AspNetCore.Mvc;
+
+namespace F9MES.Api.Controllers;
+
+/// <summary>
+/// 动态数据控制器：通过表名访问任意已注册实体的通用 CRUD
+/// 路由：POST api/data/{table}/page | get | add | update | delete | all
+/// 表名示例：RawMaterial_Zhuangkou / Process_Sheet / Fims_Batch ...
+/// 出入库单据变更后自动联动库存（见 SyncStockAsync）
+/// </summary>
+[ApiController]
+[Route("api/data")]
+[Authorize]
+public class DataController : ControllerBase
+{
+    /// <summary>需要库存联动的单据表：表名 → 联动类型（Raw=原料 / Fims=成品）</summary>
+    private static readonly Dictionary<string, string> StockLink = new(StringComparer.OrdinalIgnoreCase)
+    {
+        ["RawMaterial_InStock"] = "Raw",
+        ["RawMaterial_OutStock"] = "Raw",
+        ["Fims_InStock"] = "Fims",
+        ["Fims_OutStock"] = "Fims"
+    };
+
+    /// <summary>
+    /// 需要生产执行进度联动的单据表：表名 → 联动方式
+    /// RawZk=按原料庄口反查工艺庄口 / Pz=按工艺庄口 / SpoolCheck=丝片检查 / GradeResult=厂检定级
+    /// </summary>
+    private static readonly Dictionary<string, string> ProductionLink = new(StringComparer.OrdinalIgnoreCase)
+    {
+        ["ProXuan_Daily"] = "RawZk",
+        ["ProQian_CocoonBoiling"] = "Pz",
+        ["ProQian_ThreadRecord"] = "Pz",
+        ["ProHou_Daily"] = "Pz",
+        ["ProHou_SpoolLedger"] = "Pz",
+        ["ProHou_WeighBig"] = "Pz",
+        ["ProHou_SpoolCheck"] = "SpoolCheck",
+        ["ProPlan_WorkOrder"] = "Pz",
+        ["Lims_GradeResult"] = "GradeResult"
+    };
+
+    private readonly IServiceProvider _sp;
+
+    public DataController(IServiceProvider sp)
+    {
+        _sp = sp;
+    }
+
+    /// <summary>获取所有已注册表名（供前端下拉/调试）</summary>
+    [HttpGet("tables")]
+    public ApiResult Tables()
+    {
+        return ApiResult.Ok(EntityCatalog.Names.OrderBy(k => k).ToList());
+    }
+
+    /// <summary>分页查询</summary>
+    [HttpPost("{table}/page")]
+    public async Task<ApiResult> Page(string table, [FromBody] QueryDto dto)
+    {
+        return await InvokeAsync(table, "GetPageAsync", new object?[] { dto });
+    }
+
+    /// <summary>按 ID 查询</summary>
+    [HttpGet("{table}/{id:long}")]
+    public async Task<ApiResult> Get(string table, long id)
+    {
+        return await InvokeAsync(table, "GetByIdAsync", new object?[] { id });
+    }
+
+    /// <summary>新增</summary>
+    [HttpPost("{table}/add")]
+    public async Task<ApiResult> Add(string table, [FromBody] object body)
+    {
+        var entity = ConvertBody(table, body);
+        if (entity == null) return ApiResult.Error("表不存在或数据格式错误");
+        var result = await InvokeEntityAsync(entity, "AddAsync");
+        await SyncStockAsync(table, entity);
+        await SyncProductionAsync(table, entity);
+        return ApiResult.Ok(result, "新增成功");
+    }
+
+    /// <summary>修改（部分字段更新：仅更新请求体中出现的字段，未提交字段保持原值）</summary>
+    [HttpPost("{table}/update")]
+    public async Task<ApiResult> Update(string table, [FromBody] object body)
+    {
+        var entity = ConvertBody(table, body);
+        if (entity == null) return ApiResult.Error("表不存在或数据格式错误");
+        var fields = GetBodyFieldNames(body);
+        var result = await InvokeAsync(table, "UpdateAsync", new object?[] { entity, fields });
+        await SyncStockAsync(table, entity);
+        await SyncProductionAsync(table, entity);
+        return result is ApiResult ar ? ar : ApiResult.Ok();
+    }
+
+    /// <summary>删除（软删除）</summary>
+    [HttpPost("{table}/delete/{id:long}")]
+    public async Task<ApiResult> Delete(string table, long id)
+    {
+        var getRes = await InvokeAsync(table, "GetByIdAsync", new object?[] { id });
+        var entity = getRes.Code == 0 ? getRes.Data : null;
+        var result = await InvokeAsync(table, "DeleteAsync", new object?[] { id });
+        if (result.Code == 0)
+        {
+            await SyncStockAsync(table, entity);
+            await SyncProductionAsync(table, entity);
+        }
+        return result;
+    }
+
+    /// <summary>批量删除</summary>
+    [HttpPost("{table}/deleteRange")]
+    public async Task<ApiResult> DeleteRange(string table, [FromBody] List<long> ids)
+    {
+        var entities = new List<object?>();
+        foreach (var id in ids)
+        {
+            var r = await InvokeAsync(table, "GetByIdAsync", new object?[] { id });
+            if (r.Code == 0) entities.Add(r.Data);
+        }
+        var result = await InvokeAsync(table, "DeleteRangeAsync", new object?[] { ids });
+        if (result.Code == 0)
+        {
+            foreach (var e in entities) await SyncStockAsync(table, e);
+            foreach (var e in entities) await SyncProductionAsync(table, e);
+        }
+        return result;
+    }
+
+    /// <summary>出入库单据变更后联动重算库存（先按 Id 取库中完整实体，避免前端只提交部分字段导致联动失效）</summary>
+    private async Task SyncStockAsync(string table, object? entity)
+    {
+        if (entity == null || !StockLink.TryGetValue(table, out var kind)) return;
+        entity = await LoadFullEntityAsync(table, entity);
+        if (entity == null) return;
+        var stock = _sp.GetRequiredService<StockService>();
+        if (kind == "Raw")
+        {
+            var zkId = ReadLong(entity, "ZhuangkouId");
+            if (zkId > 0) await stock.RecalcRawAsync(zkId);
+        }
+        else // Fims
+        {
+            var pzId = ReadLong(entity, "ProcessZhuangkouId");
+            if (pzId > 0)
+            {
+                // 入库单变更：先自动生成/对齐批次与包件，再重算库存
+                var fims = _sp.GetRequiredService<FimsService>();
+                await fims.SyncByInStockAsync(ReadLong(entity, "Id"));
+                await stock.RecalcFimsAsync(pzId);
+            }
+            else
+            {
+                // 出库单主表无庄口字段：从明细反查
+                var oid = ReadLong(entity, "Id");
+                foreach (var z in (await stock.GetFimsZhuangkouIdsByOutStockAsync(oid)).Distinct())
+                    await stock.RecalcFimsAsync(z);
+            }
+        }
+    }
+
+    /// <summary>生产执行单据变更后联动重算工单/庄口进度（先按 Id 取库中完整实体）</summary>
+    private async Task SyncProductionAsync(string table, object? entity)
+    {
+        if (entity == null || !ProductionLink.TryGetValue(table, out var kind)) return;
+        entity = await LoadFullEntityAsync(table, entity);
+        if (entity == null) return;
+        var prod = _sp.GetRequiredService<ProductionService>();
+        switch (kind)
+        {
+            case "RawZk":
+            {
+                var zkId = ReadLong(entity, "ZhuangkouId");
+                if (zkId > 0) await prod.RecalcByRawZhuangkouAsync(zkId);
+                break;
+            }
+            case "SpoolCheck":
+            {
+                var id = ReadLong(entity, "Id");
+                await prod.SyncSpoolCheckAsync(id);
+                break;
+            }
+            case "GradeResult":
+            {
+                // 厂检定级生效 → 自动生成成品入库单草稿（联动批次/包件在入库确认时触发）
+                var id = ReadLong(entity, "Id");
+                var fims = _sp.GetRequiredService<FimsService>();
+                await fims.SyncByGradeResultAsync(id);
+                break;
+            }
+            default: // Pz
+            {
+                var pzId = ReadLong(entity, "ProcessZhuangkouId");
+                if (pzId > 0) await prod.RecalcByProcessZhuangkouAsync(pzId);
+                break;
+            }
+        }
+    }
+
+    /// <summary>联动前按 Id 从库中加载完整实体（前端部分更新时补齐缺失字段）</summary>
+    private async Task<object?> LoadFullEntityAsync(string table, object? entity)
+    {
+        var id = ReadLong(entity, "Id");
+        if (id <= 0) return entity;
+        var r = await InvokeAsync(table, "GetByIdAsync", new object?[] { id });
+        return r.Code == 0 ? r.Data : entity;
+    }
+
+    /// <summary>反射读取实体长整型属性值（属性名大小写不敏感）</summary>
+    private static long ReadLong(object entity, string propName)
+    {
+        var p = entity.GetType().GetProperty(propName,
+            BindingFlags.Public | BindingFlags.Instance | BindingFlags.IgnoreCase);
+        var v = p?.GetValue(entity);
+        return v == null ? 0 : Convert.ToInt64(v);
+    }
+
+    /// <summary>全部数据（下拉用）</summary>
+    [HttpGet("{table}/all")]
+    public async Task<ApiResult> All(string table)
+    {
+        var result = await InvokeAsync(table, "GetAllAsync", Array.Empty<object?>());
+        return ApiResult.Ok(result);
+    }
+
+    /// <summary>反射调用 CrudService&lt;T&gt; 的无参数/实体参数方法</summary>
+    private async Task<ApiResult> InvokeAsync(string table, string methodName, object?[] args)
+    {
+        if (!EntityCatalog.TryGet(table, out var entityType))
+            return ApiResult.Error($"表 {table} 不存在");
+
+        var crudType = typeof(CrudService<>).MakeGenericType(entityType);
+        var service = ActivatorUtilities.CreateInstance(_sp, crudType);
+
+        var method = FindMethod(crudType, methodName, args);
+        if (method == null) return ApiResult.Error($"方法 {methodName} 不存在");
+
+        var task = (Task)method.Invoke(service, args)!;
+        await task.ConfigureAwait(false);
+        var result = task.GetType().GetProperty("Result")?.GetValue(task);
+        if (result is ApiResult ar) return ar;
+        // 非 ApiResult 返回值（实体/分页/列表）统一包装为成功响应
+        return result == null ? ApiResult.Error("数据不存在") : ApiResult.Ok(result);
+    }
+
+    /// <summary>反射调用 CrudService&lt;T&gt; 的实体参数方法（返回实体本身）</summary>
+    private async Task<object?> InvokeEntityAsync(object entity, string methodName)
+    {
+        var entityType = entity.GetType();
+        var crudType = typeof(CrudService<>).MakeGenericType(entityType);
+        var service = ActivatorUtilities.CreateInstance(_sp, crudType);
+
+        var method = FindMethod(crudType, methodName, new[] { entity });
+        if (method == null) return null;
+
+        var task = (Task)method.Invoke(service, new[] { entity })!;
+        await task.ConfigureAwait(false);
+        return task.GetType().GetProperty("Result")?.GetValue(task);
+    }
+
+    /// <summary>
+    /// 按名称 + 参数类型精确查找方法（避免方法重载时 GetMethod(name) 抛出 AmbiguousMatchException）
+    /// </summary>
+    private static MethodInfo? FindMethod(Type type, string name, object?[]? args)
+    {
+        if (args is { Length: > 0 } && args.All(a => a != null))
+        {
+            var paramTypes = args.Select(a => a!.GetType()).ToArray();
+            var m = type.GetMethod(name, paramTypes);
+            if (m != null) return m;
+        }
+        var matches = type.GetMethods()
+            .Where(m => m.Name == name && m.GetParameters().Length == (args?.Length ?? 0))
+            .ToList();
+        return matches.Count == 1 ? matches[0] : null;
+    }
+
+    /// <summary>将请求体 JSON 转换为目标实体对象</summary>
+    private object? ConvertBody(string table, object body)
+    {
+        if (!EntityCatalog.TryGet(table, out var entityType)) return null;
+        var json = System.Text.Json.JsonSerializer.Serialize(body,
+            new System.Text.Json.JsonSerializerOptions { PropertyNameCaseInsensitive = true });
+        return System.Text.Json.JsonSerializer.Deserialize(json, entityType,
+            new System.Text.Json.JsonSerializerOptions { PropertyNameCaseInsensitive = true });
+    }
+
+    /// <summary>提取请求体中出现的字段名（用于部分更新，属性名大小写不敏感）</summary>
+    private static List<string> GetBodyFieldNames(object body)
+    {
+        var json = System.Text.Json.JsonSerializer.Serialize(body);
+        try
+        {
+            using var doc = System.Text.Json.JsonDocument.Parse(json);
+            if (doc.RootElement.ValueKind != System.Text.Json.JsonValueKind.Object) return new List<string>();
+            return doc.RootElement.EnumerateObject().Select(p => p.Name).ToList();
+        }
+        catch
+        {
+            return new List<string>();
+        }
+    }
+}
diff --git a/server/src/F9MES.Api/Controllers/MetaController.cs b/server/src/F9MES.Api/Controllers/MetaController.cs
new file mode 100644
index 0000000..2a33db3
--- /dev/null
+++ b/server/src/F9MES.Api/Controllers/MetaController.cs
@@ -0,0 +1,258 @@
+using System.ComponentModel;
+using System.Reflection;
+using FreeSql.DataAnnotations;
+using F9MES.Api.Common;
+using F9MES.Common.Result;
+using F9MES.Common.Utils;
+using Microsoft.AspNetCore.Authorization;
+using Microsoft.AspNetCore.Mvc;
+
+namespace F9MES.Api.Controllers;
+
+/// <summary>
+/// 元数据控制器：提供表结构信息，前端据此自动生成表格列与表单控件
+/// 路由：
+///   GET  api/meta/table/{table}         表字段元数据（含枚举选项/关联/编号标记）
+///   GET  api/meta/refs/{table}          关联表下拉数据（[{value,label}]）
+///   POST api/meta/gencode/{table}/{field} 业务编号自动生成
+/// </summary>
+[ApiController]
+[Route("api/meta")]
+[Authorize]
+public class MetaController : ControllerBase
+{
+    /// <summary>系统自动维护字段（表单不展示、不可编辑）</summary>
+    private static readonly HashSet<string> SystemFields = new(StringComparer.OrdinalIgnoreCase)
+    {
+        "Flag", "AddTime", "Adder", "UpdateTime", "Updater",
+        // 批次来源入库单ID：由入库联动自动维护，前端不展示
+        "InStockId"
+    };
+
+    /// <summary>
+    /// 关联字段映射：字段名 → (关联表, 主显示字段, 过滤字段, 过滤值)
+    /// 过滤字段用于同表多类型下拉（如 BaseCommon_Partner 按 PartnerType 区分客户/供应商）
+    /// 前端根据 *Id 字段自动加载关联下拉
+    /// </summary>
+    private static readonly Dictionary<string, (string Table, string Label, string? FilterField, object? FilterValue)> RefMap = new(StringComparer.OrdinalIgnoreCase)
+    {
+        ["ZhuangkouId"] = ("RawMaterial_Zhuangkou", "Code", null, null),
+        ["ProcessZhuangkouId"] = ("Process_ProcessZhuangkou", "Code", null, null),
+        ["SupplierId"] = ("BaseCommon_Partner", "Name", "PartnerType", 1),
+        ["CustomerId"] = ("BaseCommon_Partner", "Name", "PartnerType", 0),
+        ["SpecId"] = ("BaseCommon_SilkSpec", "Name", null, null),
+        ["MaterialId"] = ("BaseCommon_Material", "Name", null, null),
+        ["TeamId"] = ("ProXuan_Team", "Name", null, null),
+        ["WorkshopId"] = ("ProQian_Workshop", "Name", null, null),
+        ["MachineId"] = ("ProQian_Machine", "MachineNo", null, null),
+        ["EmployeeId"] = ("HRS_Employee", "Name", null, null),
+        ["BatchId"] = ("Fims_Batch", "BatchNo", null, null),
+        ["GradeResultId"] = ("Lims_GradeResult", "GradeNo", null, null),
+        ["ContractId"] = ("Sams_Contract", "Code", null, null),
+        ["SheetId"] = ("Process_Sheet", "SheetNo", null, null),
+        ["SourceSheetId"] = ("Process_Sheet", "SheetNo", null, null),
+        ["OutOrgId"] = ("BaseSys_Org", "Name", null, null),
+        ["AbnormalId"] = ("Lims_Abnormal", "AbnormalNo", null, null),
+        ["CheckId"] = ("Lims_Check", "CheckNo", null, null),
+        ["PackageId"] = ("Fims_Package", "PackageNo", null, null),
+        ["GradeId"] = ("BaseCommon_GradeStandard", "Name", null, null),
+        ["RepackId"] = ("RawMaterial_Repack", "PlanNo", null, null),
+        ["PurchaseId"] = ("RawMaterial_Purchase", "BillNo", null, null)
+    };
+
+    /// <summary>
+    /// 业务编号生成规则：表名 → (编号字段, 前缀, 日期格式, 流水位数, 前缀-日期分隔符, 日期-流水分隔符)
+    /// </summary>
+    private static readonly Dictionary<string, (string Field, string Prefix, string DatePart, int SeqLen, string SepDate, string SepSeq)> CodeRules =
+        new(StringComparer.OrdinalIgnoreCase)
+    {
+        ["RawMaterial_Zhuangkou"] = ("Code", "YLZ", "yyyyMMdd", 3, "", "-"),
+        ["RawMaterial_InStock"] = ("BillNo", "YLR", "yyyyMMdd", 4, "", "-"),
+        ["RawMaterial_Repack"] = ("PlanNo", "RZ", "yyyyMMdd", 3, "", "-"),
+        ["RawMaterial_OutStock"] = ("BillNo", "YLC", "yyyyMMdd", 4, "", "-"),
+        ["RawMaterial_Purchase"] = ("BillNo", "CG", "yyyyMMdd", 4, "", "-"),
+        ["Process_Trial"] = ("BillNo", "SY", "yyyyMMdd", 3, "", "-"),
+        ["Process_ProcessZhuangkou"] = ("Code", "GYZ", "yyyy", 3, "-", "-"),
+        ["Process_Sheet"] = ("SheetNo", "GYD", "yyyyMMdd", 3, "", "-"),
+        ["Lims_SpoolCheck"] = ("CheckNo", "JH", "yyyyMMdd", 3, "", "-"),
+        ["Lims_BlackBoard"] = ("CheckNo", "HB", "yyyyMMdd", 3, "", "-"),
+        ["Lims_Denier"] = ("CheckNo", "XD", "yyyyMMdd", 3, "", "-"),
+        ["Lims_Moisture"] = ("CheckNo", "GL", "yyyyMMdd", 3, "", "-"),
+        ["Lims_GradeResult"] = ("GradeNo", "FJ", "yyyyMMdd", 3, "", "-"),
+        ["Lims_Abnormal"] = ("AbnormalNo", "YC", "yyyyMMdd", 3, "", "-"),
+        ["Fims_Batch"] = ("BatchNo", "CP", "yyyyMMdd", 3, "", "-"),
+        ["Fims_Package"] = ("PackageNo", "BZ", "yyyyMMdd", 3, "", "-"),
+        ["Fims_InStock"] = ("BillNo", "CPR", "yyyyMMdd", 4, "", "-"),
+        ["Fims_OutStock"] = ("BillNo", "CPC", "yyyyMMdd", 4, "", "-")
+    };
+
+    private readonly IFreeSql _db;
+    private readonly OrderNoGenerator _gen;
+
+    public MetaController(IFreeSql db, OrderNoGenerator gen)
+    {
+        _db = db;
+        _gen = gen;
+    }
+
+    /// <summary>获取指定表的字段元数据</summary>
+    [HttpGet("table/{table}")]
+    public ApiResult Table(string table)
+    {
+        if (!EntityCatalog.TryGet(table, out var type))
+            return ApiResult.Error($"表 {table} 不存在");
+
+        CodeRules.TryGetValue(table, out var codeRule);
+
+        var fields = type.GetProperties(BindingFlags.Public | BindingFlags.Instance)
+            .Where(p => p.GetIndexParameters().Length == 0)
+            .OrderBy(p => p.MetadataToken)
+            .Select(p =>
+            {
+                var col = p.GetCustomAttribute<ColumnAttribute>();
+                var desc = p.GetCustomAttribute<DescriptionAttribute>()?.Description
+                           ?? p.GetCustomAttribute<DisplayNameAttribute>()?.DisplayName
+                           ?? p.Name;
+                var isPrimary = col?.IsPrimary == true;
+                RefMap.TryGetValue(p.Name, out var refInfo);
+                return new
+                {
+                    name = p.Name,
+                    label = desc,
+                    dbType = col?.DbType ?? DbTypeName(p.PropertyType),
+                    isIdentity = col?.IsIdentity == true,
+                    isPrimary,
+                    isSystem = SystemFields.Contains(p.Name),
+                    propType = Nullable.GetUnderlyingType(p.PropertyType)?.Name ?? p.PropertyType.Name,
+                    // 智能配置
+                    options = ParseOptions(desc),                       // 枚举选项 [{value,label}]
+                    refTable = refInfo.Table,                           // 关联表名
+                    refLabel = refInfo.Label,                           // 关联显示字段
+                    refFilterField = refInfo.FilterField,               // 关联过滤字段（同表多类型下拉）
+                    refFilterValue = refInfo.FilterValue,               // 关联过滤值
+                    isCode = codeRule.Field != null && codeRule.Field.Equals(p.Name, StringComparison.OrdinalIgnoreCase) // 业务编号（新增时自动生成）
+                };
+            }).ToList();
+
+        return ApiResult.Ok(new { table, title = type.GetCustomAttribute<DescriptionAttribute>()?.Description ?? table, fields });
+    }
+
+    /// <summary>关联表下拉数据：[{value,label}]，label 取显示字段（无则用 Code/Name）
+    /// 支持 filterField/filterValue：同表多类型下拉过滤（如供应商=PartnerType=1、客户=PartnerType=0）</summary>
+    [HttpGet("refs/{table}")]
+    public async Task<ApiResult> Refs(string table, string? keyword = null, int size = 500,
+        string? filterField = null, string? filterValue = null)
+    {
+        if (!EntityCatalog.TryGet(table, out var type))
+            return ApiResult.Error($"表 {table} 不存在");
+
+        var props = type.GetProperties(BindingFlags.Public | BindingFlags.Instance)
+            .Where(p => p.GetIndexParameters().Length == 0).ToList();
+        // 优先使用 RefMap 中配置的显示字段（如 MachineNo/BatchNo），其次 Name/Code/首个字符串字段
+        var refEntry = RefMap.Values.FirstOrDefault(r => r.Table.Equals(table, StringComparison.OrdinalIgnoreCase));
+        var labelProp = props.FirstOrDefault(p => refEntry.Label != null
+                                                  && p.Name.Equals(refEntry.Label, StringComparison.OrdinalIgnoreCase))
+                        ?? props.FirstOrDefault(p => p.Name.Equals("Name", StringComparison.OrdinalIgnoreCase))
+                        ?? props.FirstOrDefault(p => p.Name.Equals("Code", StringComparison.OrdinalIgnoreCase))
+                        ?? props.FirstOrDefault(p => p.PropertyType == typeof(string));
+        var codeProp = props.FirstOrDefault(p => p.Name.Equals("Code", StringComparison.OrdinalIgnoreCase));
+        var nameProp = props.FirstOrDefault(p => p.Name.Equals("Name", StringComparison.OrdinalIgnoreCase));
+        if (labelProp == null)
+            return ApiResult.Error($"表 {table} 无可展示字段");
+
+        var cols = new HashSet<string> { "Id", labelProp.Name };
+        if (codeProp != null) cols.Add(codeProp.Name);
+        if (nameProp != null) cols.Add(nameProp.Name);
+        var sql = $"SELECT `{string.Join("`, `", cols)}` FROM `{table}` WHERE Flag > 0";
+        // 同表多类型过滤（字段名白名单校验，防注入）
+        if (!string.IsNullOrWhiteSpace(filterField)
+            && props.Any(p => p.Name.Equals(filterField, StringComparison.OrdinalIgnoreCase)))
+        {
+            var fv = (filterValue ?? "").Replace("'", "''");
+            sql += long.TryParse(fv, out var fnum)
+                ? $" AND `{filterField}` = {fnum}"
+                : $" AND `{filterField}` = '{fv}'";
+        }
+        if (!string.IsNullOrWhiteSpace(keyword))
+        {
+            var kw = keyword.Replace("'", "''");
+            sql += codeProp != null && codeProp.Name != labelProp.Name
+                ? $" AND (`{labelProp.Name}` LIKE '%{kw}%' OR `{codeProp.Name}` LIKE '%{kw}%')"
+                : $" AND `{labelProp.Name}` LIKE '%{kw}%'";
+        }
+        sql += $" ORDER BY Id DESC LIMIT {Math.Clamp(size, 1, 2000)}";
+
+        var rows = await _db.Ado.QueryAsync<Dictionary<string, object>>(sql);
+        var items = rows.Select(r =>
+        {
+            var getVal = (string col) =>
+                r.TryGetValue(col, out var v) ? v?.ToString() ?? "" : "";
+
+            // 首选显示字段值（RefMap 指定 / Name / Code / 首个字符串字段）
+            var label = getVal(labelProp.Name);
+            // label 为空时用 Code 兜底
+            if (label == "" && codeProp != null && codeProp.Name != labelProp.Name)
+                label = getVal(codeProp.Name);
+            // 追加名称字段（如 编号 + 名称），提升可辨识度
+            if (nameProp != null && nameProp.Name != labelProp.Name)
+            {
+                var nm = getVal(nameProp.Name);
+                if (nm != "" && nm != label) label = $"{label} {nm}".Trim();
+            }
+            return new { value = Convert.ToInt64(r["Id"]), label };
+        }).ToList();
+
+        return ApiResult.Ok(items);
+    }
+
+    /// <summary>业务编号自动生成（如 YLZ20260815-001）</summary>
+    [HttpPost("gencode/{table}/{field}")]
+    public ApiResult Gencode(string table, string field)
+    {
+        if (!CodeRules.TryGetValue(table, out var rule))
+            return ApiResult.Error($"表 {table} 未配置自动编号规则");
+        if (!rule.Field.Equals(field, StringComparison.OrdinalIgnoreCase))
+            return ApiResult.Error($"字段 {field} 不是 {table} 的编号字段（{rule.Field}）");
+
+        var no = _gen.Generate2(rule.Prefix, rule.DatePart, rule.SeqLen, rule.SepDate, rule.SepSeq);
+        return ApiResult.Ok(new { value = no });
+    }
+
+    /// <summary>从字段描述解析枚举选项：如 "状态：0=收茧中 1=已入库 2=翻包中"</summary>
+    private static List<Dictionary<string, object>>? ParseOptions(string desc)
+    {
+        if (string.IsNullOrWhiteSpace(desc)) return null;
+        var idx = desc.IndexOfAny(new[] { '：', ':' });
+        if (idx < 0 || idx == desc.Length - 1) return null;
+        var body = desc[(idx + 1)..].Trim();
+        if (body.Length == 0) return null;
+
+        var parts = body.Split(new[] { ' ', '；', ';', '\n', '\t', '\r' }, StringSplitOptions.RemoveEmptyEntries);
+        if (parts.Length < 2) return null;
+
+        var list = new List<Dictionary<string, object>>();
+        foreach (var part in parts)
+        {
+            var eq = part.IndexOf('=');
+            if (eq <= 0 || eq == part.Length - 1) return null;
+            if (!int.TryParse(part[..eq].Trim(), out var v)) return null;
+            list.Add(new Dictionary<string, object> { ["value"] = v, ["label"] = part[(eq + 1)..].Trim() });
+        }
+        return list.Count >= 2 ? list : null;
+    }
+
+    /// <summary>C# 类型 → 数据库类型名（仅用于前端展示，非建表依据）</summary>
+    private static string DbTypeName(Type t)
+    {
+        var ut = Nullable.GetUnderlyingType(t) ?? t;
+        if (ut == typeof(string)) return "varchar(255)";
+        if (ut == typeof(int) || ut == typeof(short) || ut == typeof(byte)) return "int";
+        if (ut == typeof(long)) return "bigint";
+        if (ut == typeof(decimal)) return "decimal(18,2)";
+        if (ut == typeof(double) || ut == typeof(float)) return "decimal(18,4)";
+        if (ut == typeof(DateTime)) return "datetime";
+        if (ut == typeof(bool)) return "tinyint(1)";
+        if (ut.IsEnum) return "int";
+        return "varchar(255)";
+    }
+}
diff --git a/server/src/F9MES.Api/Controllers/PrintApiController.cs b/server/src/F9MES.Api/Controllers/PrintApiController.cs
new file mode 100644
index 0000000..130e842
--- /dev/null
+++ b/server/src/F9MES.Api/Controllers/PrintApiController.cs
@@ -0,0 +1,107 @@
+using F9MES.Application.Print;
+using Microsoft.AspNetCore.Authorization;
+using Microsoft.AspNetCore.Mvc;
+
+namespace F9MES.Api.Controllers;
+
+/// <summary>
+/// 打印对接接口（OpenPrint 后端契约，见 openprint/src/repository/*）
+/// 注意：与 F9 其它接口不同，此处返回【裸 JSON】而非 ApiResult 信封：
+///   - 列表：{ items, total }
+///   - 详情/创建/更新：资源对象
+///   - 删除：204 无 body
+///   - 错误：{ code, message, detail, requestId }
+/// 鉴权复用 F9 的 JWT（openprint 侧自动注入 Authorization: Bearer {token}）。
+/// </summary>
+[ApiController]
+[Authorize]
+[Route("api/print")]
+public class PrintApiController : ControllerBase
+{
+    private readonly PrintService _print;
+
+    public PrintApiController(PrintService print)
+    {
+        _print = print;
+    }
+
+    // ==================== 模板 ====================
+
+    /// <summary>模板列表（不含 content）</summary>
+    [HttpGet("templates")]
+    public async Task<IActionResult> GetTemplates()
+    {
+        var (items, total) = await _print.ListTemplatesAsync();
+        return Ok(new { items, total });
+    }
+
+    /// <summary>模板详情（含 content，TemplateJSON 字符串）</summary>
+    [HttpGet("templates/{id}")]
+    public async Task<IActionResult> GetTemplate(string id)
+    {
+        var row = await _print.GetTemplateAsync(id);
+        if (row == null) return Err(StatusCodes.Status404NotFound, "模板不存在", $"id={id}");
+        return Ok(row);
+    }
+
+    /// <summary>创建模板（201 + 含真实 id 的资源）</summary>
+    [HttpPost("templates")]
+    public async Task<IActionResult> CreateTemplate([FromBody] PrintTemplateInput input)
+    {
+        if (input == null || string.IsNullOrWhiteSpace(input.Name))
+            return Err(StatusCodes.Status400BadRequest, "模板名称不能为空");
+        var row = await _print.CreateTemplateAsync(input);
+        return StatusCode(StatusCodes.Status201Created, row);
+    }
+
+    /// <summary>更新模板（部分字段；openprint 发 name 和/或 content）</summary>
+    [HttpPut("templates/{id}")]
+    public async Task<IActionResult> UpdateTemplate(string id, [FromBody] PrintTemplateInput input)
+    {
+        if (input == null)
+            return Err(StatusCodes.Status400BadRequest, "请求体不能为空");
+        var row = await _print.UpdateTemplateAsync(id, input);
+        if (row == null) return Err(StatusCodes.Status404NotFound, "模板不存在", $"id={id}");
+        return Ok(row);
+    }
+
+    /// <summary>物理删除模板（204 无 body）</summary>
+    [HttpDelete("templates/{id}")]
+    public async Task<IActionResult> DeleteTemplate(string id)
+    {
+        var ok = await _print.DeleteTemplateAsync(id);
+        if (!ok) return Err(StatusCodes.Status404NotFound, "模板不存在", $"id={id}");
+        return NoContent();
+    }
+
+    // ==================== 数据源 ====================
+
+    /// <summary>数据源列表（含子表层级 tables）</summary>
+    [HttpGet("data-sources")]
+    public IActionResult GetDataSources()
+    {
+        var items = _print.ListDataSources();
+        return Ok(new { items, total = items.Count });
+    }
+
+    /// <summary>数据源字段定义</summary>
+    [HttpGet("data-sources/{id}/fields")]
+    public IActionResult GetFields(string id)
+    {
+        var items = _print.ListFields(id);
+        return Ok(new { items, total = items.Count });
+    }
+
+    /// <summary>统一错误信封：{ code, message, detail, requestId }</summary>
+    private IActionResult Err(int status, string message, string? detail = null)
+    {
+        return new JsonResult(new
+        {
+            code = status,
+            message,
+            detail,
+            requestId = HttpContext.TraceIdentifier,
+        })
+        { StatusCode = status };
+    }
+}
diff --git a/server/src/F9MES.Api/Controllers/WeatherController.cs b/server/src/F9MES.Api/Controllers/WeatherController.cs
new file mode 100644
index 0000000..52c8157
--- /dev/null
+++ b/server/src/F9MES.Api/Controllers/WeatherController.cs
@@ -0,0 +1,57 @@
+using System.Text.Json;
+using F9MES.Common.Result;
+using Microsoft.AspNetCore.Authorization;
+using Microsoft.AspNetCore.Mvc;
+
+namespace F9MES.Api.Controllers;
+
+/// <summary>
+/// 天气服务控制器：集成 Open-Meteo 免费天气 API（无需 Key）
+/// 用于生产车间温湿度环境参考
+/// </summary>
+[ApiController]
+[Route("api/weather")]
+[Authorize]
+public class WeatherController : ControllerBase
+{
+    private readonly IHttpClientFactory _http;
+
+    public WeatherController(IHttpClientFactory http)
+    {
+        _http = http;
+    }
+
+    /// <summary>
+    /// 查询实时天气
+    /// </summary>
+    /// <param name="lat">纬度，默认嘉兴</param>
+    /// <param name="lon">经度，默认嘉兴</param>
+    [HttpGet("now")]
+    [AllowAnonymous]
+    public async Task<ApiResult> Now(double lat = 30.75, double lon = 120.75)
+    {
+        try
+        {
+            var client = _http.CreateClient("weather");
+            var url = $"https://api.open-meteo.com/v1/forecast?latitude={lat}&longitude={lon}&current=temperature_2m,relative_humidity_2m,apparent_temperature,precipitation,weather_code,wind_speed_10m&timezone=Asia%2FShanghai";
+            var json = await client.GetStringAsync(url);
+            var doc = JsonDocument.Parse(json);
+            var cur = doc.RootElement.GetProperty("current");
+
+            return ApiResult.Ok(new
+            {
+                temperature = cur.GetProperty("temperature_2m").GetDecimal(),
+                humidity = cur.GetProperty("relative_humidity_2m").GetDecimal(),
+                apparentTemp = cur.GetProperty("apparent_temperature").GetDecimal(),
+                precipitation = cur.GetProperty("precipitation").GetDecimal(),
+                weatherCode = cur.GetProperty("weather_code").GetInt32(),
+                windSpeed = cur.GetProperty("wind_speed_10m").GetDecimal(),
+                time = cur.GetProperty("time").GetString()
+            });
+        }
+        catch (Exception ex)
+        {
+            return ApiResult.Error("天气服务获取失败：" + ex.Message);
+        }
+    }
+}
diff --git a/server/src/F9MES.Api/Controllers/WorkBenchController.cs b/server/src/F9MES.Api/Controllers/WorkBenchController.cs
new file mode 100644
index 0000000..a03dc18
--- /dev/null
+++ b/server/src/F9MES.Api/Controllers/WorkBenchController.cs
@@ -0,0 +1,172 @@
+using F9MES.Common.Auth;
+using F9MES.Common.Result;
+using F9MES.Domain.Common;
+using F9MES.Domain.Fims;
+using F9MES.Domain.ProHou;
+using F9MES.Domain.ProPlan;
+using F9MES.Domain.ProQian;
+using F9MES.Domain.Process;
+using FreeSql;
+using Microsoft.AspNetCore.Authorization;
+using Microsoft.AspNetCore.Mvc;
+
+namespace F9MES.Api.Controllers;
+
+/// <summary>
+/// 工作台聚合数据（真实业务统计）
+/// 路由：GET api/workbench/summary
+/// </summary>
+[ApiController]
+[Route("api/workbench")]
+[Authorize]
+public class WorkBenchController : ControllerBase
+{
+    private readonly IFreeSql _db;
+    private readonly CurrentUserService _currentUser;
+
+    public WorkBenchController(IFreeSql db, CurrentUserService currentUser)
+    {
+        _db = db;
+        _currentUser = currentUser;
+    }
+
+    /// <summary>工作台首页聚合数据（统计卡 + 趋势 + 占比 + 待办 + 预警）</summary>
+    [HttpGet("summary")]
+    public async Task<ApiResult> Summary()
+    {
+        var today = DateTime.Today;
+        var start = today.AddDays(-29);
+
+        // ===== 统计卡 =====
+        // 今日产丝（返丝日报 OutputWeight 合计）
+        var todayOutput = await _db.Select<ProHou_Daily>()
+            .Where(d => d.Flag == 1 && d.DailyDate >= today && d.DailyDate < today.AddDays(1))
+            .SumAsync(d => d.OutputWeight);
+
+        // 在线机组（启用且运行中）
+        var machineTotal = await _db.Select<ProQian_Machine>()
+            .Where(m => m.Flag == 1 && m.IsEnable == 1).CountAsync();
+        var machineRunning = await _db.Select<ProQian_Machine>()
+            .Where(m => m.Flag == 1 && m.IsEnable == 1 && m.Status == 1).CountAsync();
+
+        // 待办工单（待下发/已下发/执行中/已暂停）
+        var workOrderPending = await _db.Select<ProPlan_WorkOrder>()
+            .Where(w => w.Flag == 1 && (w.Status == 0 || w.Status == 1 || w.Status == 2 || w.Status == 4))
+            .CountAsync();
+
+        // 工作流待办（当前用户）
+        var myFlowTodo = await _db.Select<Common_WorkflowTask>()
+            .Where(t => t.Flag == 1 && t.Status == 0 && t.UserId == _currentUser.UserId)
+            .CountAsync();
+
+        // 库存预警（低于下限）
+        var warnList = await _db.Select<Fims_Stock>()
+            .Where(s => s.Flag == 1 && s.WarnMin > 0 && s.StockWeight < s.WarnMin)
+            .ToListAsync();
+
+        // ===== 近30日产丝趋势 =====
+        var trendRaw = await _db.Select<ProHou_Daily>()
+            .Where(d => d.Flag == 1 && d.DailyDate >= start && d.DailyDate < today.AddDays(1))
+            .ToListAsync(d => new { d.DailyDate, d.OutputWeight, d.ProcessZhuangkouId });
+
+        var trend = new List<object>();
+        for (var i = 0; i < 30; i++)
+        {
+            var day = start.AddDays(i);
+            var sum = trendRaw.Where(x => x.DailyDate.Date == day.Date).Sum(x => x.OutputWeight);
+            trend.Add(new { date = day.ToString("MM-dd"), weight = sum });
+        }
+
+        // ===== 庄口产量占比（近30天，Top 8）=====
+        var zkIds = trendRaw.Select(x => x.ProcessZhuangkouId).Distinct().ToList();
+        var zkNames = new List<Process_ProcessZhuangkou>();
+        if (zkIds.Count > 0)
+        {
+            zkNames = await _db.Select<Process_ProcessZhuangkou>()
+                .Where(z => z.Flag == 1 && zkIds.Contains(z.Id))
+                .ToListAsync();
+        }
+
+        var nameMap = zkNames.ToDictionary(x => x.Id, x => string.IsNullOrEmpty(x.Name) ? $"庄口{x.Id}" : x.Name);
+        var zhuangkou = trendRaw
+            .GroupBy(x => x.ProcessZhuangkouId)
+            .Select(g => new { name = nameMap.GetValueOrDefault(g.Key) ?? $"庄口{g.Key}", value = g.Sum(x => x.OutputWeight) })
+            .OrderByDescending(x => x.value)
+            .Take(8)
+            .Select(x => (object)x)
+            .ToList();
+
+        // ===== 待办列表（工单 + 工作流审批）=====
+        var pendingOrders = await _db.Select<ProPlan_WorkOrder>()
+            .Where(w => w.Flag == 1 && (w.Status == 0 || w.Status == 1 || w.Status == 2 || w.Status == 4))
+            .OrderByDescending(w => w.AddTime)
+            .Limit(8)
+            .ToListAsync(w => new { w.Id, w.OrderNo, w.ProcessZhuangkouId, w.Status, w.PlanStartDate });
+
+        var todos = new List<object>();
+        foreach (var o in pendingOrders)
+        {
+            var zkName = nameMap.GetValueOrDefault(o.ProcessZhuangkouId) ?? "";
+            todos.Add(new
+            {
+                id = o.Id,
+                title = $"{o.OrderNo}（{zkName}）",
+                type = "工单",
+                statusText = WorkOrderStatusText(o.Status),
+                time = o.PlanStartDate.ToString("MM-dd"),
+                url = "/proplan/workorder"
+            });
+        }
+        if (myFlowTodo > 0)
+        {
+            todos.Add(new
+            {
+                id = 0,
+                title = $"您有 {myFlowTodo} 条审批待办待处理",
+                type = "审批",
+                statusText = "待审批",
+                time = "",
+                url = "/common/workflowtask"
+            });
+        }
+
+        // ===== 预警列表 =====
+        var warnings = new List<object>();
+        foreach (var s in warnList.Take(8))
+        {
+            var zkName = nameMap.GetValueOrDefault(s.ProcessZhuangkouId) ?? "";
+            warnings.Add(new
+            {
+                id = s.Id,
+                title = $"库存告急：{zkName} {s.Grade}",
+                content = $"现存 {s.StockWeight}kg，低于预警下限 {s.WarnMin}kg" + (string.IsNullOrEmpty(s.Location) ? "" : $"（{s.Location}）"),
+                level = "danger",
+                time = s.UpdateTime.ToString("MM-dd HH:mm"),
+                url = "/fims/stock"
+            });
+        }
+
+        var cards = new
+        {
+            todayOutput,
+            machineTotal,
+            machineRunning,
+            workOrderPending,
+            flowTodo = myFlowTodo,
+            warningCount = warnList.Count
+        };
+
+        return ApiResult.Ok(new { cards, trend, zhuangkou, todos, warnings });
+    }
+
+    private static string WorkOrderStatusText(int status) => status switch
+    {
+        0 => "待下发",
+        1 => "已下发",
+        2 => "执行中",
+        3 => "已完成",
+        4 => "已暂停",
+        5 => "已取消",
+        _ => "未知"
+    };
+}
diff --git a/server/src/F9MES.Api/F9MES.Api.csproj b/server/src/F9MES.Api/F9MES.Api.csproj
new file mode 100644
index 0000000..ad6955e
--- /dev/null
+++ b/server/src/F9MES.Api/F9MES.Api.csproj
@@ -0,0 +1,21 @@
+<Project Sdk="Microsoft.NET.Sdk.Web">
+
+  <PropertyGroup>
+    <TargetFramework>net10.0</TargetFramework>
+    <Nullable>enable</Nullable>
+    <ImplicitUsings>enable</ImplicitUsings>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <PackageReference Include="Microsoft.AspNetCore.Authentication.JwtBearer" Version="10.0.0" />
+    <PackageReference Include="Swashbuckle.AspNetCore" Version="7.2.0" />
+    <PackageReference Include="System.IdentityModel.Tokens.Jwt" Version="8.6.0" />
+  </ItemGroup>
+
+  <ItemGroup>
+    <ProjectReference Include="..\F9MES.Application\F9MES.Application.csproj" />
+    <ProjectReference Include="..\F9MES.Domain\F9MES.Domain.csproj" />
+    <ProjectReference Include="..\F9MES.Common\F9MES.Common.csproj" />
+  </ItemGroup>
+
+</Project>
diff --git a/server/src/F9MES.Api/F9MES.Api.http b/server/src/F9MES.Api/F9MES.Api.http
new file mode 100644
index 0000000..ccfa3eb
--- /dev/null
+++ b/server/src/F9MES.Api/F9MES.Api.http
@@ -0,0 +1,6 @@
+@F9MES.Api_HostAddress = http://localhost:5136
+
+GET {{F9MES.Api_HostAddress}}/weatherforecast/
+Accept: application/json
+
+###
diff --git a/server/src/F9MES.Api/Program.cs b/server/src/F9MES.Api/Program.cs
new file mode 100644
index 0000000..d45f64a
--- /dev/null
+++ b/server/src/F9MES.Api/Program.cs
@@ -0,0 +1,158 @@
+using System.Text;
+using F9MES.Application.Auth;
+using F9MES.Application.Biz;
+using F9MES.Application.Init;
+using F9MES.Application.Base;
+using F9MES.Application.Print;
+using F9MES.Common.Auth;
+using F9MES.Common.Cache;
+using F9MES.Common.FreeSql;
+using F9MES.Common.Utils;
+using Microsoft.AspNetCore.Authentication.JwtBearer;
+using Microsoft.IdentityModel.Tokens;
+using Microsoft.OpenApi.Models;
+
+var builder = WebApplication.CreateBuilder(args);
+
+// ===== 配置 FreeSql（MySQL 主库 + SQLite 缓存库）=====
+var fsqlProvider = new FreeSqlProvider(builder.Configuration);
+// 注意：IFreeSql 只注册主库，避免多个 IFreeSql 实例导致 DI 解析歧义（缓存库通过 FreeSqlProvider 访问）
+builder.Services.AddSingleton(fsqlProvider.Db);
+builder.Services.AddSingleton(fsqlProvider);
+
+// ===== 缓存 =====
+builder.Services.AddMemoryCache();
+builder.Services.AddSingleton<CacheService>();
+
+// ===== JWT 认证 =====
+var jwtSection = builder.Configuration.GetSection("Jwt");
+var jwtHelper = new JwtHelper(
+    jwtSection["Issuer"] ?? "F9MES",
+    jwtSection["Audience"] ?? "F9MES",
+    jwtSection["Secret"] ?? "f9mes-secret-key-change-me",
+    int.Parse(jwtSection["ExpireMinutes"] ?? "7200"));
+builder.Services.AddSingleton(jwtHelper);
+
+builder.Services.AddAuthentication(JwtBearerDefaults.AuthenticationScheme)
+    .AddJwtBearer(options =>
+    {
+        options.TokenValidationParameters = new TokenValidationParameters
+        {
+            ValidateIssuer = true,
+            ValidateAudience = true,
+            ValidateLifetime = true,
+            ValidateIssuerSigningKey = true,
+            ValidIssuer = jwtSection["Issuer"] ?? "F9MES",
+            ValidAudience = jwtSection["Audience"] ?? "F9MES",
+            IssuerSigningKey = new SymmetricSecurityKey(
+                Encoding.UTF8.GetBytes(jwtSection["Secret"] ?? "f9mes-secret-key-change-me"))
+        };
+    });
+
+// ===== 业务服务 =====
+builder.Services.AddHttpContextAccessor();
+builder.Services.AddSingleton<CurrentUserService>();
+builder.Services.AddScoped(typeof(CrudService<>));
+builder.Services.AddScoped<AuthService>();
+builder.Services.AddScoped<MenuService>();
+builder.Services.AddScoped<InitDataService>();
+builder.Services.AddScoped<StockService>();
+builder.Services.AddScoped<ProductionService>();
+builder.Services.AddScoped<FimsService>();
+// OpenPrint 打印对接（模板 CRUD + 数据源内省）
+builder.Services.AddScoped<PrintService>();
+// 业务单号生成器（编号流水表存于主库）
+builder.Services.AddSingleton<OrderNoGenerator>();
+
+// ===== HTTP 客户端（天气等外部API）=====
+builder.Services.AddHttpClient("weather", c =>
+{
+    c.Timeout = TimeSpan.FromSeconds(15);
+});
+
+// ===== CORS =====
+var allowOrigins = builder.Configuration.GetSection("Cors:Origins").Get<string[]>()
+    ?? new[] { "http://localhost:5173", "http://localhost:5174", "http://localhost:8080" };
+builder.Services.AddCors(options =>
+{
+    options.AddPolicy("default", policy =>
+    {
+        policy.WithOrigins(allowOrigins)
+              .AllowAnyHeader()
+              .AllowAnyMethod()
+              .AllowCredentials();
+    });
+});
+
+// ===== 控制器 + Swagger =====
+builder.Services.AddControllers()
+    .AddJsonOptions(o =>
+    {
+        // 序列化：忽略 null、驼峰、枚举转字符串友好显示
+        o.JsonSerializerOptions.PropertyNamingPolicy = System.Text.Json.JsonNamingPolicy.CamelCase;
+        o.JsonSerializerOptions.DefaultIgnoreCondition = System.Text.Json.Serialization.JsonIgnoreCondition.WhenWritingNull;
+    });
+builder.Services.AddEndpointsApiExplorer();
+builder.Services.AddSwaggerGen(c =>
+{
+    c.SwaggerDoc("v1", new OpenApiInfo
+    {
+        Title = "F9 智慧缫丝 MES 系统 API",
+        Version = "v1",
+        Description = "缫丝厂全流程制造执行系统接口文档"
+    });
+    c.AddSecurityDefinition("Bearer", new OpenApiSecurityScheme
+    {
+        Description = "JWT 认证，格式：Bearer {token}",
+        Name = "Authorization",
+        In = ParameterLocation.Header,
+        Type = SecuritySchemeType.Http,
+        Scheme = "bearer",
+        BearerFormat = "JWT"
+    });
+    c.AddSecurityRequirement(new OpenApiSecurityRequirement
+    {
+        {
+            new OpenApiSecurityScheme
+            {
+                Reference = new OpenApiReference { Type = ReferenceType.SecurityScheme, Id = "Bearer" }
+            },
+            Array.Empty<string>()
+        }
+    });
+});
+
+var app = builder.Build();
+
+// ===== 启动时初始化数据（建表 + 超级管理员 + 菜单 + 字典）=====
+using (var scope = app.Services.CreateScope())
+{
+    // 全量同步所有实体表结构（含编号流水表）：
+    // UseAutoSyncStructure 为懒同步（仅同步被访问过的实体），这里显式全量同步，确保 114 张表全部就绪
+    // 注意：业务实体在 F9MES.Domain 程序集，不能用 typeof(BaseEntity).Assembly（那是 Common 程序集）
+    var entityTypes = System.Reflection.Assembly.Load("F9MES.Domain").GetTypes()
+        .Where(t => typeof(F9MES.Common.Entities.BaseEntity).IsAssignableFrom(t) && !t.IsAbstract)
+        .Append(typeof(SeqCounter))
+        .ToArray();
+    fsqlProvider.Db.CodeFirst.SyncStructure(entityTypes);
+
+    var init = scope.ServiceProvider.GetRequiredService<InitDataService>();
+    await init.InitAsync();
+}
+
+// ===== 中间件管道 =====
+if (app.Environment.IsDevelopment())
+{
+    app.UseDeveloperExceptionPage();
+    app.UseSwagger();
+    app.UseSwaggerUI();
+}
+
+app.UseCors("default");
+
+app.UseAuthentication();
+app.UseAuthorization();
+
+app.MapControllers();
+
+app.Run();
diff --git a/server/src/F9MES.Api/Properties/launchSettings.json b/server/src/F9MES.Api/Properties/launchSettings.json
new file mode 100644
index 0000000..f5771dc
--- /dev/null
+++ b/server/src/F9MES.Api/Properties/launchSettings.json
@@ -0,0 +1,23 @@
+{
+  "$schema": "https://json.schemastore.org/launchsettings.json",
+  "profiles": {
+    "http": {
+      "commandName": "Project",
+      "dotnetRunMessages": true,
+      "launchBrowser": false,
+      "applicationUrl": "http://localhost:5136",
+      "environmentVariables": {
+        "ASPNETCORE_ENVIRONMENT": "Development"
+      }
+    },
+    "https": {
+      "commandName": "Project",
+      "dotnetRunMessages": true,
+      "launchBrowser": false,
+      "applicationUrl": "https://localhost:7217;http://localhost:5136",
+      "environmentVariables": {
+        "ASPNETCORE_ENVIRONMENT": "Development"
+      }
+    }
+  }
+}
diff --git a/server/src/F9MES.Api/appsettings.Development.json b/server/src/F9MES.Api/appsettings.Development.json
new file mode 100644
index 0000000..0c208ae
--- /dev/null
+++ b/server/src/F9MES.Api/appsettings.Development.json
@@ -0,0 +1,8 @@
+{
+  "Logging": {
+    "LogLevel": {
+      "Default": "Information",
+      "Microsoft.AspNetCore": "Warning"
+    }
+  }
+}
diff --git a/server/src/F9MES.Api/appsettings.json b/server/src/F9MES.Api/appsettings.json
new file mode 100644
index 0000000..c62ed9b
--- /dev/null
+++ b/server/src/F9MES.Api/appsettings.json
@@ -0,0 +1,31 @@
+{
+  "ConnectionStrings": {
+    "MySQL": "server=116.198.221.105;port=3306;database=f9web;uid=f9web;pwd=t~QMq5u6j5;charset=utf8mb4;SslMode=none;AllowPublicKeyRetrieval=true"
+  },
+  "Sqlite": {
+    "Path": "f9mes_cache.db"
+  },
+  "Jwt": {
+    "Issuer": "F9MES",
+    "Audience": "F9MES",
+    "Secret": "F9MES-2026-jwt-secret-key-please-change-in-production",
+    "ExpireMinutes": 7200
+  },
+  "Oss": {
+    "Endpoint": "oss-cn-hangzhou.aliyuncs.com",
+    "AccessKeyId": "",
+    "AccessKeySecret": "",
+    "BucketName": "",
+    "Domain": ""
+  },
+  "Cors": {
+    "Origins": [ "http://localhost:5173", "http://localhost:5174", "http://localhost:8080" ]
+  },
+  "Logging": {
+    "LogLevel": {
+      "Default": "Information",
+      "Microsoft.AspNetCore": "Warning"
+    }
+  },
+  "AllowedHosts": "*"
+}
diff --git a/server/src/F9MES.Application/Auth/AuthService.cs b/server/src/F9MES.Application/Auth/AuthService.cs
new file mode 100644
index 0000000..1f9684b
--- /dev/null
+++ b/server/src/F9MES.Application/Auth/AuthService.cs
@@ -0,0 +1,119 @@
+using System.Security.Cryptography;
+using FreeSql;
+using F9MES.Common.Auth;
+using F9MES.Common.Result;
+using F9MES.Domain.BaseSys;
+
+namespace F9MES.Application.Auth;
+
+/// <summary>
+/// 认证服务：登录/修改密码
+/// 登录统一使用手机号 + 密码，密码采用 PBKDF2(SHA256) 加盐哈希存储
+/// </summary>
+public class AuthService
+{
+    private readonly IFreeSql _db;
+    private readonly JwtHelper _jwt;
+
+    public AuthService(IFreeSql db, JwtHelper jwt)
+    {
+        _db = db;
+        _jwt = jwt;
+    }
+
+    /// <summary>手机号+密码登录</summary>
+    public async Task<ApiResult> LoginAsync(string phone, string password)
+    {
+        if (string.IsNullOrWhiteSpace(phone) || string.IsNullOrWhiteSpace(password))
+            return ApiResult.Error("手机号和密码不能为空");
+
+        var user = await _db.Queryable<BaseSys_User>()
+            .Where(a => a.Phone == phone && a.Flag > 0)
+            .FirstAsync();
+
+        if (user == null)
+            return ApiResult.Error("账号不存在");
+
+        if (user.Status != 1)
+            return ApiResult.Error("账号已停用，请联系管理员");
+
+        if (!VerifyPassword(password, user.Password))
+            return ApiResult.Error("手机号或密码错误");
+
+        var token = _jwt.CreateToken(user.Id, user.Phone, user.Name, user.IsSuperAdmin == 1);
+
+        return ApiResult.Ok(new
+        {
+            token,
+            user = new
+            {
+                user.Id,
+                user.Name,
+                user.Phone,
+                user.Avatar,
+                user.IsSuperAdmin
+            }
+        }, "登录成功");
+    }
+
+    /// <summary>修改密码</summary>
+    public async Task<ApiResult> ChangePasswordAsync(long userId, string oldPassword, string newPassword)
+    {
+        var user = await _db.Queryable<BaseSys_User>().Where(a => a.Id == userId && a.Flag > 0).FirstAsync();
+        if (user == null) return ApiResult.Error("用户不存在");
+
+        if (!VerifyPassword(oldPassword, user.Password))
+            return ApiResult.Error("原密码错误");
+
+        if (string.IsNullOrWhiteSpace(newPassword) || newPassword.Length < 6)
+            return ApiResult.Error("新密码长度不能少于6位");
+
+        user.Password = HashPassword(newPassword);
+        user.UpdateTime = DateTime.Now;
+        await _db.Update<BaseSys_User>().SetSource(user).ExecuteAffrowsAsync();
+        return ApiResult.Ok(null, "密码修改成功");
+    }
+
+    /// <summary>重置密码（管理员）</summary>
+    public async Task<ApiResult> ResetPasswordAsync(long userId, string newPassword)
+    {
+        var user = await _db.Queryable<BaseSys_User>().Where(a => a.Id == userId && a.Flag > 0).FirstAsync();
+        if (user == null) return ApiResult.Error("用户不存在");
+        if (string.IsNullOrWhiteSpace(newPassword) || newPassword.Length < 6)
+            return ApiResult.Error("新密码长度不能少于6位");
+
+        user.Password = HashPassword(newPassword);
+        user.UpdateTime = DateTime.Now;
+        await _db.Update<BaseSys_User>().SetSource(user).ExecuteAffrowsAsync();
+        return ApiResult.Ok(null, "密码重置成功");
+    }
+
+    /// <summary>PBKDF2(SHA256) 加盐哈希密码</summary>
+    public static string HashPassword(string password)
+    {
+        // 格式：iterations.salt.hash（base64）
+        int iterations = 10000;
+        byte[] salt = RandomNumberGenerator.GetBytes(16);
+        var hash = Rfc2898DeriveBytes.Pbkdf2(password, salt, iterations, HashAlgorithmName.SHA256, 32);
+        return $"{iterations}.{Convert.ToBase64String(salt)}.{Convert.ToBase64String(hash)}";
+    }
+
+    /// <summary>校验密码</summary>
+    public static bool VerifyPassword(string password, string stored)
+    {
+        try
+        {
+            var parts = stored.Split('.');
+            if (parts.Length != 3) return false;
+            int iterations = int.Parse(parts[0]);
+            byte[] salt = Convert.FromBase64String(parts[1]);
+            byte[] expected = Convert.FromBase64String(parts[2]);
+            var actual = Rfc2898DeriveBytes.Pbkdf2(password, salt, iterations, HashAlgorithmName.SHA256, expected.Length);
+            return CryptographicOperations.FixedTimeEquals(actual, expected);
+        }
+        catch
+        {
+            return false;
+        }
+    }
+}
diff --git a/server/src/F9MES.Application/Auth/MenuService.cs b/server/src/F9MES.Application/Auth/MenuService.cs
new file mode 100644
index 0000000..f9e59a2
--- /dev/null
+++ b/server/src/F9MES.Application/Auth/MenuService.cs
@@ -0,0 +1,92 @@
+using FreeSql;
+using F9MES.Common.Auth;
+using F9MES.Domain.BaseSys;
+
+namespace F9MES.Application.Auth;
+
+/// <summary>
+/// 菜单服务：查询用户可见菜单树（超级管理员看全部，普通用户按角色权限过滤）
+/// </summary>
+public class MenuService
+{
+    private readonly IFreeSql _db;
+
+    public MenuService(IFreeSql db)
+    {
+        _db = db;
+    }
+
+    /// <summary>获取用户菜单树</summary>
+    public async Task<List<MenuNode>> GetMenuTreeAsync(CurrentUser user)
+    {
+        var menus = await GetUserMenusAsync(user);
+        return BuildTree(menus.Where(m => m.MenuType != 2).ToList(), 0);
+    }
+
+    /// <summary>获取用户权限标识列表（按钮级）</summary>
+    public async Task<List<string>> GetUserPermissionsAsync(CurrentUser user)
+    {
+        var menus = await GetUserMenusAsync(user);
+        return menus.Where(m => !string.IsNullOrEmpty(m.Permission)).Select(m => m.Permission!).ToList();
+    }
+
+    /// <summary>查询用户可见菜单（含按钮）</summary>
+    private async Task<List<BaseSys_Menu>> GetUserMenusAsync(CurrentUser user)
+    {
+        if (user.IsSuperAdmin)
+        {
+            return await _db.Queryable<BaseSys_Menu>()
+                .Where(a => a.Flag > 0 && a.IsVisible == 1 && a.IsEnable == 1)
+                .OrderBy(a => a.Sort).ToListAsync();
+        }
+
+        // 普通用户：通过角色获取授权菜单
+        var menuIds = (await _db.Queryable<BaseSys_RoleMenu>()
+            .Where(rm => rm.Flag > 0 && user.RoleIds.Contains(rm.RoleId))
+            .ToListAsync()).Select(rm => rm.MenuId).ToList();
+
+        if (menuIds.Count == 0) return new List<BaseSys_Menu>();
+
+        return await _db.Queryable<BaseSys_Menu>()
+            .Where(a => a.Flag > 0 && a.IsVisible == 1 && a.IsEnable == 1 && menuIds.Contains(a.Id))
+            .OrderBy(a => a.Sort).ToListAsync();
+    }
+
+    /// <summary>构建树</summary>
+    private static List<MenuNode> BuildTree(List<BaseSys_Menu> all, long parentId)
+    {
+        var nodes = all.Where(m => m.ParentId == parentId).OrderBy(m => m.Sort).ToList();
+        var result = new List<MenuNode>();
+        foreach (var m in nodes)
+        {
+            result.Add(new MenuNode
+            {
+                Id = m.Id,
+                Name = m.Name,
+                Title = m.Name,
+                MenuType = m.MenuType,
+                Path = m.RoutePath,
+                Component = m.Component,
+                Icon = m.Icon,
+                Permission = m.Permission,
+                Children = BuildTree(all, m.Id)
+            });
+        }
+        return result;
+    }
+}
+
+/// <summary>菜单树节点</summary>
+public class MenuNode
+{
+    public long Id { get; set; }
+    public string Name { get; set; } = "";
+    /// <summary>菜单显示名（前端 el-menu 通用字段，与 Name 相同）</summary>
+    public string Title { get; set; } = "";
+    public int MenuType { get; set; }
+    public string? Path { get; set; }
+    public string? Component { get; set; }
+    public string? Icon { get; set; }
+    public string? Permission { get; set; }
+    public List<MenuNode> Children { get; set; } = new();
+}
diff --git a/server/src/F9MES.Application/Base/CrudService.cs b/server/src/F9MES.Application/Base/CrudService.cs
new file mode 100644
index 0000000..0667fbd
--- /dev/null
+++ b/server/src/F9MES.Application/Base/CrudService.cs
@@ -0,0 +1,212 @@
+using System.Linq.Expressions;
+using System.Reflection;
+using FreeSql;
+using F9MES.Application.Dtos;
+using F9MES.Common.Auth;
+using F9MES.Common.Entities;
+using F9MES.Common.Result;
+
+namespace F9MES.Application.Base;
+
+/// <summary>
+/// 通用 CRUD 服务：所有业务实体的增删改查基础能力
+/// 统一处理：Flag 软删除过滤、操作人/时间自动填充、分页关键字检索
+/// 基于 IFreeSql 原生 API（FreeSql 3.5.311 已移除仓储接口）
+/// </summary>
+public class CrudService<T> where T : BaseEntity, new()
+{
+    protected readonly IFreeSql Db;
+    protected readonly CurrentUserService CurrentUser;
+
+    public CrudService(IFreeSql db, CurrentUserService currentUser)
+    {
+        Db = db;
+        CurrentUser = currentUser;
+    }
+
+    /// <summary>动态条件分页查询（支持等值条件字典 + 关键字模糊搜索）</summary>
+    public virtual async Task<PageResult<T>> GetPageAsync(QueryDto dto)
+    {
+        if (dto.Page < 1) dto.Page = 1;
+        if (dto.Size < 1 || dto.Size > 500) dto.Size = 20;
+
+        var query = Db.Select<T>().Where(a => a.Flag > 0);
+
+        // 等值条件（属性名大小写不敏感，兼容前端 camelCase 传参）
+        if (dto.Where is { Count: > 0 })
+        {
+            foreach (var kv in dto.Where)
+            {
+                var prop = typeof(T).GetProperty(kv.Key,
+                    BindingFlags.Public | BindingFlags.Instance | BindingFlags.IgnoreCase);
+                if (prop == null) continue;
+                var val = ConvertValue(kv.Value, prop.PropertyType);
+                if (val != null)
+                    query = query.Where(BuildEquals(prop.Name, val));
+            }
+        }
+
+        // 关键字模糊匹配 Name/Code
+        if (!string.IsNullOrWhiteSpace(dto.Keyword))
+        {
+            var kw = dto.Keyword.Trim();
+            var propName = typeof(T).GetProperty("Name")?.PropertyType == typeof(string) ? "Name"
+                         : typeof(T).GetProperty("Code")?.PropertyType == typeof(string) ? "Code"
+                         : null;
+            if (propName != null)
+                query = query.Where(BuildContains(propName, kw));
+        }
+
+        var total = await query.CountAsync();
+        var items = await query
+            .OrderByDescending(a => a.Id)
+            .Skip((dto.Page - 1) * dto.Size)
+            .Take(dto.Size)
+            .ToListAsync();
+        return PageResult<T>.From(dto.Page, dto.Size, total, items);
+    }
+
+    /// <summary>按条件分页查询</summary>
+    public virtual async Task<PageResult<T>> GetPageAsync(Expression<Func<T, bool>> where, int page = 1, int size = 20)
+    {
+        if (page < 1) page = 1;
+        if (size < 1 || size > 500) size = 20;
+
+        var query = Db.Select<T>().Where(a => a.Flag > 0).Where(where);
+        var total = await query.CountAsync();
+        var items = await query
+            .OrderByDescending(a => a.Id)
+            .Skip((page - 1) * size)
+            .Take(size)
+            .ToListAsync();
+        return PageResult<T>.From(page, size, total, items);
+    }
+
+    /// <summary>按 ID 查询</summary>
+    public virtual async Task<T?> GetByIdAsync(long id)
+    {
+        return await Db.Select<T>().Where(a => a.Id == id && a.Flag > 0).FirstAsync();
+    }
+
+    /// <summary>新增（自动填充操作人/时间，FreeSql 自动回填自增ID）</summary>
+    public virtual async Task<T> AddAsync(T entity)
+    {
+        var uid = CurrentUser.UserId;
+        entity.AddTime = DateTime.Now;
+        entity.UpdateTime = DateTime.Now;
+        entity.Adder = uid;
+        entity.Updater = uid;
+        if (entity.Flag == 0) entity.Flag = 1;
+        // ExecuteIdentityAsync：返回自增主键（3.5.311 中 ExecuteAffrows 不回填，此处手动赋值）
+        entity.Id = await Db.Insert(entity).ExecuteIdentityAsync();
+        return entity;
+    }
+
+    /// <summary>修改（自动更新操作人/时间）</summary>
+    public virtual async Task<ApiResult> UpdateAsync(T entity)
+    {
+        var old = await Db.Select<T>().Where(a => a.Id == entity.Id && a.Flag > 0).FirstAsync();
+        if (old == null) return ApiResult.Error("数据不存在或已删除");
+
+        entity.UpdateTime = DateTime.Now;
+        entity.Updater = CurrentUser.UserId;
+        // 保护字段不允许被修改
+        entity.AddTime = old.AddTime;
+        entity.Adder = old.Adder;
+        await Db.Update<T>().SetSource(entity).ExecuteAffrowsAsync();
+        return ApiResult.Ok();
+    }
+
+    /// <summary>部分修改：仅更新请求体中出现的字段（避免未提交字段被清零）</summary>
+    public virtual async Task<ApiResult> UpdateAsync(T entity, IEnumerable<string> fields)
+    {
+        var old = await Db.Select<T>().Where(a => a.Id == entity.Id && a.Flag > 0).FirstAsync();
+        if (old == null) return ApiResult.Error("数据不存在或已删除");
+
+        var set = new HashSet<string>(fields, StringComparer.OrdinalIgnoreCase);
+        foreach (var prop in typeof(T).GetProperties(BindingFlags.Public | BindingFlags.Instance))
+        {
+            if (!prop.CanWrite || !set.Contains(prop.Name)) continue;
+            if (prop.Name is "Id" or "Flag" or "AddTime" or "Adder") continue;
+            prop.SetValue(old, prop.GetValue(entity));
+        }
+        old.UpdateTime = DateTime.Now;
+        old.Updater = CurrentUser.UserId;
+        await Db.Update<T>().SetSource(old).ExecuteAffrowsAsync();
+        return ApiResult.Ok();
+    }
+
+    /// <summary>删除（软删除：Flag=0）</summary>
+    public virtual async Task<ApiResult> DeleteAsync(long id)
+    {
+        var old = await Db.Select<T>().Where(a => a.Id == id && a.Flag > 0).FirstAsync();
+        if (old == null) return ApiResult.Error("数据不存在或已删除");
+        old.Flag = 0;
+        old.UpdateTime = DateTime.Now;
+        old.Updater = CurrentUser.UserId;
+        await Db.Update<T>().SetSource(old).ExecuteAffrowsAsync();
+        return ApiResult.Ok();
+    }
+
+    /// <summary>批量删除</summary>
+    public virtual async Task<ApiResult> DeleteRangeAsync(IEnumerable<long> ids)
+    {
+        var list = await Db.Select<T>().Where(a => ids.Contains(a.Id) && a.Flag > 0).ToListAsync();
+        foreach (var item in list)
+        {
+            item.Flag = 0;
+            item.UpdateTime = DateTime.Now;
+            item.Updater = CurrentUser.UserId;
+        }
+        if (list.Count > 0) await Db.Update<T>().SetSource(list).ExecuteAffrowsAsync();
+        return ApiResult.Ok(message: $"已删除 {list.Count} 条");
+    }
+
+    /// <summary>全部有效数据（下拉选择用）</summary>
+    public virtual async Task<List<T>> GetAllAsync()
+    {
+        return await Db.Select<T>().Where(a => a.Flag > 0).OrderBy(a => a.Id).ToListAsync();
+    }
+
+    /// <summary>构建字符串字段包含关键字的表达式（FreeSql 可翻译）</summary>
+    protected static Expression<Func<T, bool>> BuildContains(string propName, string keyword)
+    {
+        var param = Expression.Parameter(typeof(T), "a");
+        var prop = Expression.Property(param, propName);
+        var contains = typeof(string).GetMethod("Contains", new[] { typeof(string) })!;
+        var call = Expression.Call(prop, contains, Expression.Constant(keyword));
+        return Expression.Lambda<Func<T, bool>>(call, param);
+    }
+
+    /// <summary>构建等值比较表达式</summary>
+    protected static Expression<Func<T, bool>> BuildEquals(string propName, object value)
+    {
+        var param = Expression.Parameter(typeof(T), "a");
+        var prop = Expression.Property(param, propName);
+        var converted = Expression.Convert(Expression.Constant(value), prop.Type);
+        var body = Expression.Equal(prop, converted);
+        return Expression.Lambda<Func<T, bool>>(body, param);
+    }
+
+    /// <summary>将 JSON 值转换为属性目标类型</summary>
+    protected static object? ConvertValue(object value, Type targetType)
+    {
+        try
+        {
+            if (value == null) return null;
+            var type = Nullable.GetUnderlyingType(targetType) ?? targetType;
+            if (type == typeof(string)) return value.ToString();
+            if (type == typeof(long)) return Convert.ToInt64(value);
+            if (type == typeof(int)) return Convert.ToInt32(value);
+            if (type == typeof(decimal)) return Convert.ToDecimal(value);
+            if (type == typeof(double)) return Convert.ToDouble(value);
+            if (type == typeof(DateTime)) return Convert.ToDateTime(value);
+            if (type == typeof(bool)) return Convert.ToBoolean(value);
+            return value;
+        }
+        catch
+        {
+            return null;
+        }
+    }
+}
diff --git a/server/src/F9MES.Application/Biz/FimsService.cs b/server/src/F9MES.Application/Biz/FimsService.cs
new file mode 100644
index 0000000..5e38897
--- /dev/null
+++ b/server/src/F9MES.Application/Biz/FimsService.cs
@@ -0,0 +1,222 @@
+using F9MES.Common.Utils;
+using F9MES.Domain.Fims;
+using F9MES.Domain.Lims;
+using F9MES.Domain.ProHou;
+
+namespace F9MES.Application.Biz;
+
+/// <summary>
+/// 成品联动服务：检验（厂检定级）→ 成品入库单 → 批次/包件 → 成品库存 全链路自动生成
+/// 采用"全量重算"模式：
+///  - 厂检定级生效后自动生成入库单草稿（净重建议=待入库量，包件建议=30kg/包）
+///  - 入库单状态=1 已入库时按单自动生成/对齐批次与包件（批次号=入库单号）
+///  - 入库单作废/删除/回草稿时自动回退删除批次与包件（已出库引用的包件保留）
+/// </summary>
+public class FimsService
+{
+    private readonly IFreeSql _db;
+    private readonly OrderNoGenerator _gen;
+
+    public FimsService(IFreeSql db, OrderNoGenerator gen)
+    {
+        _db = db;
+        _gen = gen;
+    }
+
+    /// <summary>厂检定级变更联动：生效后自动生成入库单草稿；删除后清理关联入库单（含批次回退）</summary>
+    public async Task SyncByGradeResultAsync(long gradeResultId)
+    {
+        if (gradeResultId <= 0) return;
+        var gr = await _db.Select<Lims_GradeResult>()
+            .Where(a => a.Id == gradeResultId)
+            .FirstAsync();
+        if (gr == null) return;
+
+        // 定级单被删除：清理其自动生成的入库单（含批次/包件回退）
+        if (gr.Flag <= 0)
+        {
+            var linked = await _db.Select<Fims_InStock>()
+                .Where(a => a.Flag > 0 && a.GradeResultId == gradeResultId)
+                .ToListAsync();
+            foreach (var s in linked)
+            {
+                s.Flag = 0;
+                s.UpdateTime = DateTime.Now;
+                await _db.Update<Fims_InStock>().SetSource(s).ExecuteAffrowsAsync();
+                await SyncByInStockAsync(s.Id);
+            }
+            return;
+        }
+        if (gr.Status != 1) return;
+
+        // 同一判定单不重复生成入库单（已作废的允许重建）
+        var exists = await _db.Select<Fims_InStock>()
+            .Where(a => a.Flag > 0 && a.GradeResultId == gradeResultId && a.Status != 2)
+            .AnyAsync();
+        if (exists) return;
+
+        // 建议净重 = 该庄口已秤大丝总量 - 该庄口已入库净重（待入库量）
+        var pzId = gr.ProcessZhuangkouId;
+        var weighed = await _db.Select<ProHou_WeighBig>()
+            .Where(a => a.Flag > 0 && a.ProcessZhuangkouId == pzId)
+            .SumAsync(a => a.TotalWeight);
+        var stocked = await _db.Select<Fims_InStock>()
+            .Where(a => a.Flag > 0 && a.ProcessZhuangkouId == pzId && a.Status == 1)
+            .SumAsync(a => a.NetWeight);
+        var suggestWeight = Math.Max(0m, weighed - stocked);
+
+        var billNo = _gen.Generate2("CPR", "yyyyMMdd", 4, "", "-");
+        var ins = new Fims_InStock
+        {
+            BillNo = billNo,
+            ProcessZhuangkouId = pzId,
+            SpecId = gr.SpecId,
+            Grade = gr.Grade,
+            NetWeight = suggestWeight,
+            PackageCount = suggestWeight > 0 ? Math.Max(1, (int)Math.Ceiling(suggestWeight / 30m)) : 1,
+            InDate = gr.GradeDate == default ? DateTime.Now : gr.GradeDate,
+            GradeResultId = gradeResultId,
+            Status = 0
+        };
+        await _db.Insert(ins).ExecuteIdentityAsync();
+    }
+
+    /// <summary>入库单变更联动：状态=1 已入库 → 生成/对齐批次与包件；否则 → 回退删除</summary>
+    public async Task SyncByInStockAsync(long inStockId)
+    {
+        if (inStockId <= 0) return;
+        // 不限定 Flag：删除（软删）后仍能定位并回退批次/包件
+        var ins = await _db.Select<Fims_InStock>()
+            .Where(a => a.Id == inStockId)
+            .FirstAsync();
+        if (ins == null) return;
+
+        // 入库单已删除：批次/包件一并清理
+        if (ins.Flag <= 0)
+        {
+            var dead = await _db.Select<Fims_Batch>()
+                .Where(a => a.InStockId == inStockId)
+                .FirstAsync();
+            if (dead != null) await RemoveBatchAsync(dead.Id);
+            return;
+        }
+
+        var batch = await _db.Select<Fims_Batch>()
+            .Where(a => a.Flag > 0 && a.InStockId == inStockId)
+            .FirstAsync();
+
+        if (ins.Status != 1)
+        {
+            // 草稿/作废：回退删除批次与包件（无出库引用时）
+            if (batch != null) await RemoveBatchAsync(batch.Id);
+            return;
+        }
+
+        // 已入库：生成/对齐批次（批次号=入库单号，保证唯一可追溯）
+        if (batch == null)
+        {
+            batch = new Fims_Batch
+            {
+                BatchNo = ins.BillNo,
+                ProcessZhuangkouId = ins.ProcessZhuangkouId,
+                SpecId = ins.SpecId,
+                Grade = ins.Grade,
+                TotalWeight = ins.NetWeight,
+                PackageCount = ins.PackageCount,
+                InStockId = inStockId,
+                CreateDate = ins.InDate,
+                Status = 0
+            };
+            batch.Id = await _db.Insert(batch).ExecuteIdentityAsync();
+        }
+        else
+        {
+            await _db.Update<Fims_Batch>()
+                .Set(a => a.SpecId, ins.SpecId)
+                .Set(a => a.Grade, ins.Grade)
+                .Set(a => a.TotalWeight, ins.NetWeight)
+                .Set(a => a.PackageCount, ins.PackageCount)
+                .Set(a => a.CreateDate, ins.InDate)
+                .Where(a => a.Id == batch.Id)
+                .ExecuteAffrowsAsync();
+        }
+
+        // 包件全量对齐：已出库引用的包件保留，其余重建，补齐数量
+        await RebuildPackagesAsync(batch, ins);
+    }
+
+    /// <summary>包件全量重建：保留被出库引用的包件，删除其余后按入库数量补齐</summary>
+    private async Task RebuildPackagesAsync(Fims_Batch batch, Fims_InStock ins)
+    {
+        var oldPkgs = await _db.Select<Fims_Package>()
+            .Where(a => a.Flag > 0 && a.BatchId == batch.Id)
+            .ToListAsync();
+        var oldIds = oldPkgs.Select(p => p.Id).ToArray();
+
+        // 被出库明细引用的包件必须保留
+        var locked = new HashSet<long>();
+        if (oldIds.Length > 0)
+        {
+            locked = new HashSet<long>((await _db.Select<Fims_OutStockItem>()
+                .Where(a => a.Flag > 0 && oldIds.Contains(a.PackageId))
+                .ToListAsync(a => a.PackageId)));
+        }
+
+        var delIds = oldPkgs.Where(p => !locked.Contains(p.Id)).Select(p => p.Id).ToArray();
+        if (delIds.Length > 0)
+            await _db.Delete<Fims_Package>().Where(a => delIds.Contains(a.Id)).ExecuteAffrowsAsync();
+
+        var keep = locked.Count;
+        var need = Math.Max(0, ins.PackageCount);
+        var create = Math.Max(0, need - keep);
+        if (create == 0) return;
+
+        // 新包件编号：无保留包件时从 001 重新编号；有保留时接续既有最大值
+        var maxNo = 0;
+        if (keep > 0)
+        {
+            foreach (var p in oldPkgs)
+            {
+                var idx = p.PackageNo.LastIndexOf('-');
+                if (idx >= 0 && int.TryParse(p.PackageNo[(idx + 1)..], out var n)) maxNo = Math.Max(maxNo, n);
+            }
+        }
+        var per = Math.Round(ins.NetWeight / create, 2);
+        for (var i = 1; i <= create; i++)
+        {
+            var w = i == create ? ins.NetWeight - per * (create - 1) : per;
+            await _db.Insert(new Fims_Package
+            {
+                PackageNo = $"{ins.BillNo}-{maxNo + i:000}",
+                BatchId = batch.Id,
+                ProcessZhuangkouId = ins.ProcessZhuangkouId,
+                SpecId = ins.SpecId,
+                Grade = ins.Grade,
+                GrossWeight = w,
+                TareWeight = 0,
+                NetWeight = w,
+                Status = 0,
+                InDate = ins.InDate
+            }).ExecuteIdentityAsync();
+        }
+    }
+
+    /// <summary>删除批次及未出库的包件（有出库引用的包件保留并中止删除）</summary>
+    private async Task RemoveBatchAsync(long batchId)
+    {
+        var pkgIds = await _db.Select<Fims_Package>()
+            .Where(a => a.Flag > 0 && a.BatchId == batchId)
+            .ToListAsync(a => a.Id);
+        var locked = new HashSet<long>();
+        if (pkgIds.Count > 0)
+        {
+            locked = new HashSet<long>((await _db.Select<Fims_OutStockItem>()
+                .Where(a => a.Flag > 0 && pkgIds.Contains(a.PackageId))
+                .ToListAsync(a => a.PackageId)));
+            foreach (var pid in pkgIds.Where(id => !locked.Contains(id)))
+                await _db.Delete<Fims_Package>().Where(a => a.Id == pid).ExecuteAffrowsAsync();
+        }
+        if (locked.Count == 0)
+            await _db.Delete<Fims_Batch>().Where(a => a.Id == batchId).ExecuteAffrowsAsync();
+    }
+}
diff --git a/server/src/F9MES.Application/Biz/ProductionService.cs b/server/src/F9MES.Application/Biz/ProductionService.cs
new file mode 100644
index 0000000..22475b4
--- /dev/null
+++ b/server/src/F9MES.Application/Biz/ProductionService.cs
@@ -0,0 +1,181 @@
+using F9MES.Domain.Process;
+using F9MES.Domain.ProHou;
+using F9MES.Domain.ProPlan;
+using F9MES.Domain.ProQian;
+using F9MES.Domain.ProXuan;
+
+namespace F9MES.Application.Biz;
+
+/// <summary>
+/// 生产执行进度联动服务：核心生产链路（选茧→煮茧→落丝→返丝→丝片检查→秤大丝）
+/// 变更后自动汇总到工单（实际投料/产出）与工艺庄口（进度/状态），
+/// 采用"全量重算"模式，历史数据异常时也能自愈。
+/// </summary>
+public class ProductionService
+{
+    private readonly IFreeSql _db;
+
+    public ProductionService(IFreeSql db)
+    {
+        _db = db;
+    }
+
+    /// <summary>
+    /// 按工艺庄口重算：汇总该庄口所有工单实际投料/产出 + 庄口进度/状态流转
+    /// </summary>
+    public async Task RecalcByProcessZhuangkouAsync(long processZhuangkouId)
+    {
+        if (processZhuangkouId <= 0) return;
+        var orders = await _db.Select<ProPlan_WorkOrder>()
+            .Where(a => a.Flag > 0 && a.ProcessZhuangkouId == processZhuangkouId)
+            .ToListAsync();
+        foreach (var o in orders) await RecalcWorkOrderAsync(o);
+
+        var pz = await _db.Select<Process_ProcessZhuangkou>()
+            .Where(a => a.Flag > 0 && a.Id == processZhuangkouId)
+            .FirstAsync();
+        if (pz == null) return;
+
+        var active = orders.Where(o => o.Status is not 4 and not 5).ToList();
+        if (active.Count == 0)
+        {
+            pz.Progress = 0;
+            if (pz.Status == 0) pz.Status = 0;
+            pz.UpdateTime = DateTime.Now;
+            await _db.Update<Process_ProcessZhuangkou>().SetSource(pz).ExecuteAffrowsAsync();
+            return;
+        }
+
+        // 进度 = 各工单产出完成率（计划>0）的平均，无法计算时按投料完成率
+        var ratios = new List<decimal>();
+        foreach (var o in active)
+        {
+            if (o.PlanOutput > 0)
+                ratios.Add(Math.Min(1m, o.ActualOutput / o.PlanOutput));
+            else if (o.PlanInput > 0)
+                ratios.Add(Math.Min(1m, o.ActualInput / o.PlanInput));
+        }
+        pz.Progress = ratios.Count == 0 ? 0m : Math.Round(ratios.Average() * 100m, 2);
+
+        // 状态流转：全部完成→已完成；有产出→生产中；否则回退未投产（自愈）
+        var allDone = active.All(o => o.Status == 3);
+        var anyProgress = active.Any(o => o.ActualInput > 0 || o.ActualOutput > 0);
+        if (allDone)
+        {
+            pz.Status = 3;
+            pz.EndDate ??= DateTime.Now;
+        }
+        else if (anyProgress)
+        {
+            pz.Status = 1;
+            pz.StartDate ??= DateTime.Now;
+        }
+        else
+        {
+            pz.Status = 0;
+            pz.StartDate = null;
+            pz.EndDate = null;
+        }
+        pz.UpdateTime = DateTime.Now;
+        await _db.Update<Process_ProcessZhuangkou>().SetSource(pz).ExecuteAffrowsAsync();
+    }
+
+    /// <summary>
+    /// 按原料庄口反查工艺庄口并重算（选茧日报按原料庄口录入）
+    /// </summary>
+    public async Task RecalcByRawZhuangkouAsync(long zhuangkouId)
+    {
+        if (zhuangkouId <= 0) return;
+        var pzs = await _db.Select<Process_ProcessZhuangkou>()
+            .Where(a => a.Flag > 0 && a.ZhuangkouId == zhuangkouId)
+            .ToListAsync();
+        foreach (var pz in pzs) await RecalcByProcessZhuangkouAsync(pz.Id);
+    }
+
+    /// <summary>
+    /// 重算单个工单的实际投料/产出并流转工单状态
+    /// </summary>
+    private async Task RecalcWorkOrderAsync(ProPlan_WorkOrder wo)
+    {
+        if (wo.Flag <= 0 || wo.Status == 5) return;
+        decimal input = 0, output = 0;
+
+        if (wo.TargetProcess == 0) // 选茧工单：按原料庄口汇总选茧日报
+        {
+            var pz = await _db.Select<Process_ProcessZhuangkou>()
+                .Where(a => a.Flag > 0 && a.Id == wo.ProcessZhuangkouId)
+                .FirstAsync();
+            var zkId = pz?.ZhuangkouId ?? 0;
+            if (zkId > 0)
+            {
+                input = await _db.Select<ProXuan_Daily>()
+                    .Where(a => a.Flag > 0 && a.ZhuangkouId == zkId)
+                    .SumAsync(a => a.InputWeight);
+                output = await _db.Select<ProXuan_Daily>()
+                    .Where(a => a.Flag > 0 && a.ZhuangkouId == zkId)
+                    .SumAsync(a => a.GoodWeight);
+            }
+        }
+        else // 前缫工单：煮茧送茧量=实际投料，落丝下丝量=实际产出
+        {
+            input = await _db.Select<ProQian_CocoonBoiling>()
+                .Where(a => a.Flag > 0 && a.ProcessZhuangkouId == wo.ProcessZhuangkouId)
+                .SumAsync(a => a.InputWeight);
+            output = await _db.Select<ProQian_ThreadRecord>()
+                .Where(a => a.Flag > 0 && a.ProcessZhuangkouId == wo.ProcessZhuangkouId)
+                .SumAsync(a => a.Weight);
+        }
+
+        wo.ActualInput = Math.Round(input, 2);
+        wo.ActualOutput = Math.Round(output, 2);
+
+        // 状态流转：产出达计划→已完成；有产量→执行中；无产量→回退已下发（支持删除/修改后自愈）
+        if (wo.Status is not 4 and not 5)
+        {
+            if (wo.PlanOutput > 0 && wo.ActualOutput >= wo.PlanOutput)
+                wo.Status = 3;
+            else if (wo.ActualInput > 0 || wo.ActualOutput > 0)
+                wo.Status = 2;
+            else
+                wo.Status = 1; // 已下发（含从已完成/执行中回退）
+        }
+        wo.UpdateTime = DateTime.Now;
+        await _db.Update<ProPlan_WorkOrder>().SetSource(wo).ExecuteAffrowsAsync();
+    }
+
+    /// <summary>
+    /// 丝片检查联动：按检查结果更新丝片台账状态并重算庄口
+    /// 合格→已检验；返修→已检验（待返修处理）；报废→报损
+    /// </summary>
+    public async Task SyncSpoolByCheckAsync(long spoolId)
+    {
+        if (spoolId <= 0) return;
+        var check = await _db.Select<ProHou_SpoolCheck>()
+            .Where(a => a.Flag > 0 && a.SpoolId == spoolId)
+            .OrderByDescending(a => a.Id)
+            .FirstAsync();
+        var spool = await _db.Select<ProHou_SpoolLedger>()
+            .Where(a => a.Flag > 0 && a.Id == spoolId)
+            .FirstAsync();
+        if (spool == null) return;
+
+        if (check != null)
+        {
+            if (check.CheckResult == 2) spool.Status = 4;       // 报废
+            else if (spool.Status == 0) spool.Status = 1;       // 合格/返修 → 已检验
+        }
+        spool.UpdateTime = DateTime.Now;
+        await _db.Update<ProHou_SpoolLedger>().SetSource(spool).ExecuteAffrowsAsync();
+        await RecalcByProcessZhuangkouAsync(spool.ProcessZhuangkouId);
+    }
+
+    /// <summary>从丝片检查记录反查丝片并联动（由 ProHou_SpoolCheck 单据变更触发）</summary>
+    public async Task SyncSpoolCheckAsync(long checkId)
+    {
+        if (checkId <= 0) return;
+        var check = await _db.Select<ProHou_SpoolCheck>()
+            .Where(a => a.Flag > 0 && a.Id == checkId)
+            .FirstAsync();
+        if (check != null) await SyncSpoolByCheckAsync(check.SpoolId);
+    }
+}
diff --git a/server/src/F9MES.Application/Biz/StockService.cs b/server/src/F9MES.Application/Biz/StockService.cs
new file mode 100644
index 0000000..8565cc2
--- /dev/null
+++ b/server/src/F9MES.Application/Biz/StockService.cs
@@ -0,0 +1,171 @@
+using F9MES.Domain.Fims;
+using F9MES.Domain.RawMaterial;
+
+namespace F9MES.Application.Biz;
+
+/// <summary>
+/// 库存联动服务：出入库单据变更后自动重算库存
+/// 原料：按庄口汇总（入库净重 - 出库重量）
+/// 成品：按工艺庄口+规格+等级汇总（入库净重 - 出库明细净重）
+/// 采用"全量重算"而非"增量累加"，保证历史数据异常时也能自愈
+/// </summary>
+public class StockService
+{
+    private readonly IFreeSql _db;
+
+    public StockService(IFreeSql db)
+    {
+        _db = db;
+    }
+
+    /// <summary>原料库存重算（按庄口）</summary>
+    public async Task RecalcRawAsync(long zhuangkouId)
+    {
+        if (zhuangkouId <= 0) return;
+        // 仅统计已生效单据（Status=1）
+        var inSum = await _db.Select<RawMaterial_InStock>()
+            .Where(a => a.Flag > 0 && a.Status == 1 && a.ZhuangkouId == zhuangkouId)
+            .SumAsync(a => a.NetWeight);
+        var outSum = await _db.Select<RawMaterial_OutStock>()
+            .Where(a => a.Flag > 0 && a.Status == 1 && a.ZhuangkouId == zhuangkouId)
+            .SumAsync(a => a.OutWeight);
+        var weight = Math.Max(0m, Math.Round(inSum - outSum, 2));
+
+        var stock = await _db.Select<RawMaterial_Stock>()
+            .Where(a => a.Flag > 0 && a.ZhuangkouId == zhuangkouId)
+            .FirstAsync();
+        if (stock == null)
+        {
+            await _db.Insert(new RawMaterial_Stock
+            {
+                ZhuangkouId = zhuangkouId,
+                StockWeight = weight,
+                PackageCount = 0,
+                Flag = 1,
+                AddTime = DateTime.Now
+            }).ExecuteAffrowsAsync();
+        }
+        else
+        {
+            stock.StockWeight = weight;
+            stock.UpdateTime = DateTime.Now;
+            await _db.Update<RawMaterial_Stock>().SetSource(stock).ExecuteAffrowsAsync();
+        }
+    }
+
+    /// <summary>成品库存重算（按工艺庄口：入库净重 - 出库净重）</summary>
+    public async Task RecalcFimsAsync(long processZhuangkouId)
+    {
+        if (processZhuangkouId <= 0) return;
+        var pzId = processZhuangkouId;
+
+        // 入库数据（仅生效单）
+        var ins = await _db.Select<Fims_InStock>()
+            .Where(a => a.Flag > 0 && a.Status == 1 && a.ProcessZhuangkouId == pzId)
+            .ToListAsync(a => new FimsAgg
+            {
+                SpecId = a.SpecId,
+                Grade = a.Grade ?? "",
+                InW = a.NetWeight,
+                Pkg = a.PackageCount
+            });
+
+        // 出库数据（按批次关联庄口/规格/等级）
+        var outs = await _db.Select<Fims_OutStockItem, Fims_OutStock, Fims_Batch>()
+            .InnerJoin((i, o, b) => i.OutStockId == o.Id)
+            .InnerJoin((i, o, b) => i.BatchId == b.Id)
+            .Where((i, o, b) => i.Flag > 0 && o.Flag > 0 && o.Status == 1 && b.ProcessZhuangkouId == pzId)
+            .ToListAsync((i, o, b) => new FimsAgg
+            {
+                SpecId = b.SpecId,
+                Grade = b.Grade ?? "",
+                OutW = i.NetWeight
+            });
+
+        // 内存聚合（按 规格+等级）
+        var inRows = ins.GroupBy(r => $"{r.SpecId}|{r.Grade}")
+            .Select(g => new FimsAgg
+            {
+                SpecId = g.First().SpecId,
+                Grade = g.Key[(g.Key.IndexOf('|') + 1)..],
+                InW = g.Sum(r => r.InW),
+                OutW = 0m,
+                Pkg = g.Sum(r => r.Pkg)
+            }).ToList();
+        var outRows = outs.GroupBy(r => $"{r.SpecId}|{r.Grade}")
+            .Select(g => new FimsAgg
+            {
+                SpecId = g.First().SpecId,
+                Grade = g.Key[(g.Key.IndexOf('|') + 1)..],
+                InW = 0m,
+                OutW = g.Sum(r => r.OutW),
+                Pkg = 0
+            }).ToList();
+
+        // 合并行（按 规格+等级）
+        var rows = new List<FimsAgg>();
+        foreach (var r in inRows.Concat(outRows))
+        {
+            var hit = rows.FirstOrDefault(x => x.SpecId == r.SpecId && x.Grade == r.Grade);
+            if (hit == null) rows.Add(r);
+            else
+            {
+                hit.InW += r.InW;
+                hit.OutW += r.OutW;
+                hit.Pkg += r.Pkg;
+            }
+        }
+
+        var existing = await _db.Select<Fims_Stock>()
+            .Where(a => a.Flag > 0 && a.ProcessZhuangkouId == pzId)
+            .ToListAsync();
+        var existingKeys = existing.Select(s => $"{s.SpecId}|{s.Grade}").ToHashSet();
+
+        foreach (var s in existing)
+        {
+            var row = rows.FirstOrDefault(r => r.SpecId == s.SpecId && r.Grade == s.Grade);
+            s.StockWeight = row == null ? 0m : Math.Max(0m, Math.Round(row.InW - row.OutW, 2));
+            s.PackageCount = row == null ? 0 : row.Pkg;
+            s.UpdateTime = DateTime.Now;
+            await _db.Update<Fims_Stock>().SetSource(s).ExecuteAffrowsAsync();
+        }
+
+        foreach (var r in rows.Where(r => !existingKeys.Contains($"{r.SpecId}|{r.Grade}")))
+        {
+            var weight = Math.Max(0m, Math.Round(r.InW - r.OutW, 2));
+            if (weight <= 0 && r.Pkg <= 0) continue;
+            await _db.Insert(new Fims_Stock
+            {
+                ProcessZhuangkouId = pzId,
+                SpecId = r.SpecId,
+                Grade = r.Grade ?? "",
+                StockWeight = weight,
+                PackageCount = r.Pkg,
+                Flag = 1,
+                AddTime = DateTime.Now
+            }).ExecuteAffrowsAsync();
+        }
+    }
+
+    /// <summary>从成品出库单反查涉及的所有工艺庄口（用于出库单变更后联动）</summary>
+    public async Task<List<long>> GetFimsZhuangkouIdsByOutStockAsync(long outStockId)
+    {
+        if (outStockId <= 0) return new List<long>();
+        return await _db.Select<Fims_OutStockItem, Fims_Batch>()
+            .InnerJoin((i, b) => i.BatchId == b.Id)
+            .Where((i, b) => i.Flag > 0 && i.OutStockId == outStockId)
+            .Distinct()
+            .ToListAsync((i, b) => b.ProcessZhuangkouId);
+    }
+
+    /// <summary>成品库存聚合行</summary>
+    private class FimsAgg
+    {
+        public long ProcessZhuangkouId { get; set; }
+        public long SpecId { get; set; }
+        public string? Grade { get; set; }
+        public decimal InW { get; set; }
+        public decimal OutW { get; set; }
+        public int Pkg { get; set; }
+    }
+}
diff --git a/server/src/F9MES.Application/Dtos/QueryDto.cs b/server/src/F9MES.Application/Dtos/QueryDto.cs
new file mode 100644
index 0000000..f558477
--- /dev/null
+++ b/server/src/F9MES.Application/Dtos/QueryDto.cs
@@ -0,0 +1,20 @@
+namespace F9MES.Application.Dtos;
+
+/// <summary>
+/// 通用查询参数
+/// where：字段等值条件（字典），如 { "ProcessZhuangkouId": 1, "Status": 0 }
+/// </summary>
+public class QueryDto
+{
+    /// <summary>当前页（从1开始）</summary>
+    public int Page { get; set; } = 1;
+
+    /// <summary>每页条数</summary>
+    public int Size { get; set; } = 20;
+
+    /// <summary>关键字（模糊匹配 Name/Code）</summary>
+    public string? Keyword { get; set; }
+
+    /// <summary>等值条件字典</summary>
+    public Dictionary<string, object>? Where { get; set; }
+}
diff --git a/server/src/F9MES.Application/F9MES.Application.csproj b/server/src/F9MES.Application/F9MES.Application.csproj
new file mode 100644
index 0000000..b68a9cf
--- /dev/null
+++ b/server/src/F9MES.Application/F9MES.Application.csproj
@@ -0,0 +1,14 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <ItemGroup>
+    <ProjectReference Include="..\F9MES.Domain\F9MES.Domain.csproj" />
+    <ProjectReference Include="..\F9MES.Common\F9MES.Common.csproj" />
+  </ItemGroup>
+
+  <PropertyGroup>
+    <TargetFramework>net10.0</TargetFramework>
+    <ImplicitUsings>enable</ImplicitUsings>
+    <Nullable>enable</Nullable>
+  </PropertyGroup>
+
+</Project>
diff --git a/server/src/F9MES.Application/Init/InitDataService.cs b/server/src/F9MES.Application/Init/InitDataService.cs
new file mode 100644
index 0000000..3e971f5
--- /dev/null
+++ b/server/src/F9MES.Application/Init/InitDataService.cs
@@ -0,0 +1,317 @@
+using FreeSql;
+using F9MES.Application.Auth;
+using F9MES.Domain.BaseCommon;
+using F9MES.Domain.BaseSys;
+
+namespace F9MES.Application.Init;
+
+/// <summary>
+/// 系统初始化服务：首次启动时创建超级管理员、全模块菜单、基础字典
+/// </summary>
+public class InitDataService
+{
+    private readonly IFreeSql _db;
+
+    public InitDataService(IFreeSql db)
+    {
+        _db = db;
+    }
+
+    /// <summary>执行初始化（幂等：已存在则跳过）</summary>
+    public async Task InitAsync()
+    {
+        await InitSuperAdminAsync();
+        await InitMenusAsync();
+        await InitDictsAsync();
+    }
+
+    /// <summary>初始化超级管理员（默认账号 13800000000 / 123456）</summary>
+    private async Task InitSuperAdminAsync()
+    {
+        var exists = await _db.Queryable<BaseSys_User>().AnyAsync(a => a.Phone == "13800000000");
+        if (exists) return;
+
+        var admin = new BaseSys_User
+        {
+            Phone = "13800000000",
+            Password = AuthService.HashPassword("123456"),
+            Name = "超级管理员",
+            IsSuperAdmin = 1,
+            Status = 1,
+            AddTime = DateTime.Now,
+            UpdateTime = DateTime.Now
+        };
+        await _db.Insert(admin).ExecuteAffrowsAsync();
+
+        // 初始化默认角色：超级管理员
+        var role = await _db.Queryable<BaseSys_Role>().Where(a => a.Code == "SUPER_ADMIN").FirstAsync();
+        if (role == null)
+        {
+            role = new BaseSys_Role { Name = "超级管理员", Code = "SUPER_ADMIN", IsSystem = 1, IsEnable = 1 };
+            await _db.Insert(role).ExecuteAffrowsAsync();
+        }
+        await _db.Insert(new BaseSys_UserRole { UserId = admin.Id, RoleId = role.Id }).ExecuteAffrowsAsync();
+    }
+
+    /// <summary>初始化全模块菜单树（22 个业务模块）
+    /// 采用两阶段插入：先插入目录节点回填自增 Id，再插入页面节点引用真实 ParentId
+    /// </summary>
+    private async Task InitMenusAsync()
+    {
+        var count = await _db.Queryable<BaseSys_Menu>().Where(a => a.Flag > 0).CountAsync();
+
+        // 开发期修复：若存在 ParentId=0 的页面节点（历史版本批量插入未回填 Id 的 Bug 产物），
+        // 物理清除全部初始化菜单后重建，保证树结构正确
+        var orphans = await _db.Queryable<BaseSys_Menu>()
+            .Where(a => a.Flag > 0 && a.MenuType == 1 && a.ParentId == 0).CountAsync();
+        if (orphans > 0)
+        {
+            await _db.Delete<BaseSys_Menu>().Where(a => a.Flag > 0).ExecuteAffrowsAsync();
+        }
+        else if (count > 0)
+        {
+            return; // 已有完整菜单则跳过
+        }
+
+        long sort = 0;
+
+        // ===== 阶段一：目录节点（RoutePath 作为临时 key，插入后回填 Id）=====
+        var dirs = new List<BaseSys_Menu>();
+        BaseSys_Menu Dir(string key, string name, string icon)
+        {
+            var m = new BaseSys_Menu
+            {
+                Name = name, Icon = icon, MenuType = 0, IsVisible = 1,
+                RoutePath = key, Sort = (int)sort++, Level = 1, Path = "",
+                AddTime = DateTime.Now, UpdateTime = DateTime.Now
+            };
+            dirs.Add(m);
+            return m;
+        }
+
+        Dir("/1", "工作台", "Odometer");
+        Dir("/2", "基础数据", "Files");
+        Dir("/3", "原料管理", "Box");
+        Dir("/4", "生技工艺", "MagicStick");
+        Dir("/5", "生产计划", "Calendar");
+        Dir("/6", "选茧工段", "FirstAidKit");
+        Dir("/7", "前缫工段", "Cpu");
+        Dir("/8", "后缫工段", "Finished");
+        Dir("/9", "检验管理", "View");
+        Dir("/10", "成品管理", "Goods");
+        Dir("/11", "销售管理", "Sell");
+        Dir("/12", "人力资源", "User");
+        Dir("/13", "薪资智算", "Money");
+        Dir("/14", "能耗管理", "Lightning");
+        Dir("/15", "质量管理", "Checked");
+        Dir("/16", "五金仓储", "Grid");
+        Dir("/17", "副产品管理", "Dish");
+        Dir("/18", "经营管家", "TrendCharts");
+        Dir("/19", "报表中心", "PieChart");
+        Dir("/20", "看板中心", "Monitor");
+        Dir("/21", "接口中心", "Connection");
+        Dir("/22", "系统管理", "Setting");
+
+        await _db.Insert(dirs).ExecuteAffrowsAsync();
+
+        // 重新查询目录节点获取真实自增 Id（FreeSql 批量插入不保证回填 Id）
+        var insertedDirs = await _db.Queryable<BaseSys_Menu>()
+            .Where(a => a.Flag > 0 && a.MenuType == 0 && a.ParentId == 0)
+            .OrderBy(a => a.Sort)
+            .ToListAsync();
+        var dirMap = insertedDirs.ToDictionary(d => d.RoutePath ?? "", d => d.Id);
+
+        // ===== 阶段二：页面节点（引用目录真实 Id）=====
+        var menus = new List<BaseSys_Menu>();
+        void MenuItem(string parentKey, string name, string path, string component)
+        {
+            menus.Add(new BaseSys_Menu
+            {
+                Name = name, MenuType = 1, IsVisible = 1,
+                RoutePath = path, Component = component,
+                ParentId = dirMap[parentKey], Sort = (int)sort++, Level = 2,
+                Path = parentKey, AddTime = DateTime.Now, UpdateTime = DateTime.Now
+            });
+        }
+
+        // 工作台
+        MenuItem("/1", "工作台", "/workbench", "WorkBench/index");
+
+        // 基础数据
+        MenuItem("/2", "物资目录", "/basecommon/material", "BaseCommon/material");
+        MenuItem("/2", "生丝规格", "/basecommon/spec", "BaseCommon/spec");
+        MenuItem("/2", "定级标准", "/basecommon/grade", "BaseCommon/grade");
+        MenuItem("/2", "往来单位", "/basecommon/partner", "BaseCommon/partner");
+        MenuItem("/2", "业务账期", "/basecommon/period", "BaseCommon/period");
+        MenuItem("/2", "工种划分", "/basecommon/worktype", "BaseCommon/worktype");
+        MenuItem("/2", "数据字典", "/basecommon/dict", "BaseCommon/dict");
+
+        // 原料管理
+        MenuItem("/3", "原料庄口", "/rawmaterial/zhuangkou", "RawMaterial/zhuangkou");
+        MenuItem("/3", "原料入库", "/rawmaterial/instock", "RawMaterial/instock");
+        MenuItem("/3", "翻包管理", "/rawmaterial/repack", "RawMaterial/repack");
+        MenuItem("/3", "原料出库", "/rawmaterial/outstock", "RawMaterial/outstock");
+        MenuItem("/3", "原料库存", "/rawmaterial/stock", "RawMaterial/stock");
+        MenuItem("/3", "采购管理", "/rawmaterial/purchase", "RawMaterial/purchase");
+
+        // 生技工艺
+        MenuItem("/4", "工艺庄口", "/process/zhuangkou", "Process/zhuangkou");
+        MenuItem("/4", "样茧试缫", "/process/trial", "Process/trial");
+        MenuItem("/4", "工艺指标", "/process/index", "Process/index");
+        MenuItem("/4", "工艺单", "/process/sheet", "Process/sheet");
+
+        // 生产计划
+        MenuItem("/5", "任务工单", "/proplan/workorder", "ProPlan/workorder");
+        MenuItem("/5", "计划变更", "/proplan/change", "ProPlan/change");
+
+        // 选茧工段
+        MenuItem("/6", "选茧班组", "/proxuan/team", "ProXuan/team");
+        MenuItem("/6", "选茧日报", "/proxuan/daily", "ProXuan/daily");
+        MenuItem("/6", "选茧质量", "/proxuan/quality", "ProXuan/quality");
+        MenuItem("/6", "光茧临时仓", "/proxuan/tempstock", "ProXuan/tempstock");
+
+        // 前缫工段
+        MenuItem("/7", "车间配置", "/proqian/workshop", "ProQian/workshop");
+        MenuItem("/7", "机组车位", "/proqian/machine", "ProQian/machine");
+        MenuItem("/7", "看台排班", "/proqian/schedule", "ProQian/schedule");
+        MenuItem("/7", "看台时长", "/proqian/shifttime", "ProQian/shifttime");
+        MenuItem("/7", "煮茧日报", "/proqian/cocoon", "ProQian/cocoon");
+        MenuItem("/7", "落丝记录", "/proqian/thread", "ProQian/thread");
+
+        // 后缫工段
+        MenuItem("/8", "返丝日报", "/prohou/daily", "ProHou/daily");
+        MenuItem("/8", "丝片台账", "/prohou/spool", "ProHou/spool");
+        MenuItem("/8", "丝片检查", "/prohou/check", "ProHou/check");
+        MenuItem("/8", "秤大丝", "/prohou/weigh", "ProHou/weigh");
+
+        // 检验管理
+        MenuItem("/9", "丝片检查", "/lims/spoolcheck", "Lims/spoolcheck");
+        MenuItem("/9", "黑板检验", "/lims/blackboard", "Lims/blackboard");
+        MenuItem("/9", "纤度检验", "/lims/denier", "Lims/denier");
+        MenuItem("/9", "公量检验", "/lims/moisture", "Lims/moisture");
+        MenuItem("/9", "检验异常", "/lims/abnormal", "Lims/abnormal");
+        MenuItem("/9", "厂检定级", "/lims/grade", "Lims/grade");
+
+        // 成品管理
+        MenuItem("/10", "成品批次", "/fims/batch", "Fims/batch");
+        MenuItem("/10", "成品包件", "/fims/package", "Fims/package");
+        MenuItem("/10", "成品入库", "/fims/instock", "Fims/instock");
+        MenuItem("/10", "成品出库", "/fims/outstock", "Fims/outstock");
+        MenuItem("/10", "成品库存", "/fims/stock", "Fims/stock");
+
+        // 销售管理
+        MenuItem("/11", "客户档案", "/sams/customer", "Sams/customer");
+        MenuItem("/11", "销售合同", "/sams/contract", "Sams/contract");
+        MenuItem("/11", "发货计划", "/sams/dispatch", "Sams/dispatch");
+        MenuItem("/11", "回款记录", "/sams/payment", "Sams/payment");
+        MenuItem("/11", "发票管理", "/sams/invoice", "Sams/invoice");
+
+        // 人力资源
+        MenuItem("/12", "职工档案", "/hrs/employee", "HRS/employee");
+        MenuItem("/12", "异动管理", "/hrs/change", "HRS/change");
+        MenuItem("/12", "出勤管理", "/hrs/attendance", "HRS/attendance");
+        MenuItem("/12", "宿舍管理", "/hrs/dorm", "HRS/dorm");
+        MenuItem("/12", "食堂消费", "/hrs/canteen", "HRS/canteen");
+
+        // 薪资智算
+        MenuItem("/13", "薪资配置", "/flexpay/config", "FlexPay/config");
+        MenuItem("/13", "薪资方案", "/flexpay/scheme", "FlexPay/scheme");
+        MenuItem("/13", "奖扣管理", "/flexpay/reward", "FlexPay/reward");
+        MenuItem("/13", "计件成绩", "/flexpay/piece", "FlexPay/piece");
+        MenuItem("/13", "薪资核算", "/flexpay/salary", "FlexPay/salary");
+        MenuItem("/13", "薪资发放", "/flexpay/payroll", "FlexPay/payroll");
+
+        // 能耗管理
+        MenuItem("/14", "计量表", "/enms/meter", "Enms/meter");
+        MenuItem("/14", "抄表记录", "/enms/reading", "Enms/reading");
+        MenuItem("/14", "分摊规则", "/enms/rule", "Enms/rule");
+        MenuItem("/14", "分摊结果", "/enms/result", "Enms/result");
+
+        // 质量管理
+        MenuItem("/15", "粒数测定", "/qums/grain", "Qums/grain");
+        MenuItem("/15", "检查任务", "/qums/task", "Qums/task");
+
+        // 五金仓储
+        MenuItem("/16", "五金库存", "/wmswu/stock", "WmsWu/stock");
+        MenuItem("/16", "入库管理", "/wmswu/instock", "WmsWu/instock");
+        MenuItem("/16", "出库管理", "/wmswu/outstock", "WmsWu/outstock");
+        MenuItem("/16", "采购计划", "/wmswu/plan", "WmsWu/plan");
+        MenuItem("/16", "领料申请", "/wmswu/apply", "WmsWu/apply");
+        MenuItem("/16", "库存台账", "/wmswu/ledger", "WmsWu/ledger");
+
+        // 副产品管理
+        MenuItem("/17", "副产品库存", "/wmsfu/stock", "WmsFu/stock");
+        MenuItem("/17", "副产品入库", "/wmsfu/instock", "WmsFu/instock");
+        MenuItem("/17", "副产品出库", "/wmsfu/outstock", "WmsFu/outstock");
+
+        // 经营管家
+        MenuItem("/18", "成本分摊", "/bizboss/cost", "BizBoss/cost");
+        MenuItem("/18", "分庄口盈亏", "/bizboss/profit", "BizBoss/profit");
+
+        // 报表中心
+        MenuItem("/19", "报表清单", "/repcenter/report", "RepCenter/report");
+        MenuItem("/19", "打印模板", "/repcenter/design", "RepCenter/design");
+
+        // 看板中心
+        MenuItem("/20", "看板管理", "/boardcenter/board", "BoardCenter/board");
+
+        // 接口中心
+        MenuItem("/21", "内部接口", "/apicenter/internal", "ApiCenter/internal");
+        MenuItem("/21", "外部接口", "/apicenter/external", "ApiCenter/external");
+        MenuItem("/21", "同步日志", "/apicenter/sync", "ApiCenter/sync");
+
+        // 系统管理
+        MenuItem("/22", "菜单管理", "/basesys/menu", "BaseSys/menu");
+        MenuItem("/22", "组织架构", "/basesys/org", "BaseSys/org");
+        MenuItem("/22", "角色管理", "/basesys/role", "BaseSys/role");
+        MenuItem("/22", "用户管理", "/basesys/user", "BaseSys/user");
+
+        await _db.Insert(menus).ExecuteAffrowsAsync();
+    }
+
+    /// <summary>初始化基础字典</summary>
+    private async Task InitDictsAsync()
+    {
+        // 幂等判断：字典类型与字典项均存在则跳过
+        var typeExists = await _db.Queryable<BaseCommon_DictType>().AnyAsync();
+        var itemExists = await _db.Queryable<BaseCommon_Dict>().Where(a => a.Flag > 0).AnyAsync();
+        if (typeExists && itemExists) return;
+
+        // 结构不完整（含历史软删残留）：物理清空后重建种子数据
+        await _db.Delete<BaseCommon_DictType>().Where(a => true).ExecuteAffrowsAsync();
+        await _db.Delete<BaseCommon_Dict>().Where(a => true).ExecuteAffrowsAsync();
+
+        var types = new List<BaseCommon_DictType>
+        {
+            new() { Code = "gender", Name = "性别", IsSystem = 1 },
+            new() { Code = "material_type", Name = "物资类型", IsSystem = 1 },
+            new() { Code = "grade", Name = "生丝等级", IsSystem = 1 },
+            new() { Code = "season", Name = "茧季", IsSystem = 1 },
+        };
+        await _db.Insert(types).ExecuteAffrowsAsync();
+
+        var dicts = new List<BaseCommon_Dict>
+        {
+            new() { TypeCode = "gender", DictKey = "0", DictValue = "未知", Sort = 0 },
+            new() { TypeCode = "gender", DictKey = "1", DictValue = "男", Sort = 1 },
+            new() { TypeCode = "gender", DictKey = "2", DictValue = "女", Sort = 2 },
+            new() { TypeCode = "material_type", DictKey = "0", DictValue = "原料", Sort = 0 },
+            new() { TypeCode = "material_type", DictKey = "1", DictValue = "生丝", Sort = 1 },
+            new() { TypeCode = "material_type", DictKey = "2", DictValue = "副产品", Sort = 2 },
+            new() { TypeCode = "material_type", DictKey = "3", DictValue = "五金配件", Sort = 3 },
+            new() { TypeCode = "material_type", DictKey = "4", DictValue = "辅料", Sort = 4 },
+            new() { TypeCode = "material_type", DictKey = "5", DictValue = "能源", Sort = 5 },
+            new() { TypeCode = "grade", DictKey = "6A", DictValue = "6A", Sort = 0 },
+            new() { TypeCode = "grade", DictKey = "5A", DictValue = "5A", Sort = 1 },
+            new() { TypeCode = "grade", DictKey = "4A", DictValue = "4A", Sort = 2 },
+            new() { TypeCode = "grade", DictKey = "3A", DictValue = "3A", Sort = 3 },
+            new() { TypeCode = "grade", DictKey = "2A", DictValue = "2A", Sort = 4 },
+            new() { TypeCode = "grade", DictKey = "A", DictValue = "A", Sort = 5 },
+            new() { TypeCode = "season", DictKey = "春茧", DictValue = "春茧", Sort = 0 },
+            new() { TypeCode = "season", DictKey = "夏茧", DictValue = "夏茧", Sort = 1 },
+            new() { TypeCode = "season", DictKey = "秋茧", DictValue = "秋茧", Sort = 2 },
+            new() { TypeCode = "season", DictKey = "晚秋茧", DictValue = "晚秋茧", Sort = 3 },
+        };
+        await _db.Insert(dicts).ExecuteAffrowsAsync();
+    }
+}
diff --git a/server/src/F9MES.Application/Print/PrintService.cs b/server/src/F9MES.Application/Print/PrintService.cs
new file mode 100644
index 0000000..0eadff4
--- /dev/null
+++ b/server/src/F9MES.Application/Print/PrintService.cs
@@ -0,0 +1,466 @@
+using System.ComponentModel;
+using System.Reflection;
+using FreeSql;
+using FreeSql.DataAnnotations;
+using F9MES.Common.Auth;
+using F9MES.Common.Entities;
+using F9MES.Domain.BaseSys;
+using F9MES.Domain.Center;
+
+namespace F9MES.Application.Print;
+
+// ============================================================
+// OpenPrint 打印对接服务（《后端对接规范》§4）
+// 模板协议：openprint/src/repository/http-repo.ts
+// 数据源协议：openprint/src/repository/http-datasource.ts
+// 序列化约定：驼峰 + 忽略 null（见 Program.cs AddJsonOptions），
+// 与 openprint HttpClient 的 RawSummary / FieldDef 字段名一致。
+// ============================================================
+
+/// <summary>打印模板摘要（列表项，不含 content）</summary>
+public class PrintTemplateSummary
+{
+    public string Id { get; set; } = "";
+    public string Name { get; set; } = "";
+    public string? Category { get; set; }
+    public string Visibility { get; set; } = "private";
+    public string? CreatedBy { get; set; }
+    public DateTime? CreatedAt { get; set; }
+    public string? UpdatedBy { get; set; }
+    public DateTime? UpdatedAt { get; set; }
+    public PrintPermission? Permissions { get; set; }
+
+    /// <summary>F9 扩展：是否默认模板</summary>
+    public bool IsDefault { get; set; }
+
+    /// <summary>F9 扩展：纸张规格</summary>
+    public string? PaperSize { get; set; }
+}
+
+/// <summary>模板操作权限（openprint 面板按钮按此控制）</summary>
+public class PrintPermission
+{
+    public bool Editable { get; set; } = true;
+    public bool Deletable { get; set; } = true;
+    public bool Copyable { get; set; } = true;
+}
+
+/// <summary>打印模板详情（含 content = TemplateJSON 字符串）</summary>
+public class PrintTemplateRecord : PrintTemplateSummary
+{
+    public string? Content { get; set; }
+}
+
+/// <summary>创建 / 更新模板入参（openprint 仅发 name + content）</summary>
+public class PrintTemplateInput
+{
+    public string Name { get; set; } = "";
+    public string? Content { get; set; }
+    public string? PaperSize { get; set; }
+    public long ReportId { get; set; }
+    public int TemplateType { get; set; }
+}
+
+/// <summary>数据源内表元信息（金蝶式层级：一个模块 = 一个数据源，其下为实体表）</summary>
+public class PrintTableMeta
+{
+    public string Id { get; set; } = "";
+    public string Name { get; set; } = "";
+    public string Relation { get; set; } = "main";
+    public string PathPrefix { get; set; } = "";
+    public bool IsArray { get; set; }
+}
+
+/// <summary>数据源（F9 侧：按业务模块前缀分组实体表）</summary>
+public class PrintDataSourceMeta
+{
+    public string Id { get; set; } = "";
+    public string Name { get; set; } = "";
+    public string? Description { get; set; }
+    public List<PrintTableMeta> Tables { get; set; } = new();
+}
+
+/// <summary>字段定义（供设计器绑定）</summary>
+public class PrintFieldDef
+{
+    public string Path { get; set; } = "";
+    public string Label { get; set; } = "";
+    public string Type { get; set; } = "string";
+    public string TableId { get; set; } = "";
+    public string? Group { get; set; }
+    public int Sort { get; set; }
+    public object? Sample { get; set; }
+    public bool Hidden { get; set; }
+    public List<PrintFieldOption>? Options { get; set; }
+}
+
+/// <summary>字段枚举选项（C# 枚举属性）</summary>
+public class PrintFieldOption
+{
+    public string Value { get; set; } = "";
+    public string Label { get; set; } = "";
+}
+
+/// <summary>打印对接服务：模板 CRUD + 数据源内省</summary>
+public class PrintService
+{
+    /// <summary>业务模块前缀 → 模块名（顺序即展示顺序）</summary>
+    private static readonly Dictionary<string, string> ModuleNames = new()
+    {
+        ["BaseCommon_"] = "基础资料",
+        ["Sams_"] = "销售管理",
+        ["RawMaterial_"] = "原料管理",
+        ["Process_"] = "工艺管理",
+        ["ProXuan_"] = "选茧管理",
+        ["ProQian_"] = "前处理管理",
+        ["ProHou_"] = "后处理管理",
+        ["ProPlan_"] = "生产计划",
+        ["Fims_"] = "成品管理",
+        ["Qums_"] = "质检管理",
+        ["Lims_"] = "实验室检测",
+        ["WmsWu_"] = "物料仓库",
+        ["WmsFu_"] = "辅料仓库",
+        ["HRS_"] = "人事管理",
+        ["FlexPay_"] = "薪酬管理",
+        ["Enms_"] = "能源管理",
+        ["BizBoss_"] = "经营管理",
+        ["RepCenter_"] = "报表中心",
+        ["BoardCenter_"] = "看板中心",
+        ["WorkBench_"] = "工作台",
+    };
+
+    /// <summary>不暴露给打印设计器的表前缀（系统/接口配置）</summary>
+    private static readonly string[] ExcludedPrefixes = { "Sys_", "ApiCenter_" };
+
+    /// <summary>实体基类审计字段名</summary>
+    private static readonly string[] AuditFieldNames =
+        { "Flag", "AddTime", "Adder", "UpdateTime", "Updater", "Memo" };
+
+    private readonly IFreeSql _db;
+    private readonly CurrentUserService _currentUser;
+
+    /// <summary>实体表缓存（按表名索引）</summary>
+    private static List<EntityTableInfo>? _tables;
+
+    public PrintService(IFreeSql db, CurrentUserService currentUser)
+    {
+        _db = db;
+        _currentUser = currentUser;
+    }
+
+    // ==================== 模板 CRUD ====================
+
+    public async Task<(List<PrintTemplateSummary> Items, long Total)> ListTemplatesAsync()
+    {
+        var rows = await _db.Select<RepCenter_ReportDesign>()
+            .Where(a => a.Flag > 0)
+            .OrderByDescending(a => a.UpdateTime)
+            .ToListAsync();
+        var names = await ResolveUserNamesAsync(rows
+            .Select(a => a.Adder).Concat(rows.Select(a => a.Updater)).Distinct().ToArray());
+        var items = rows.Select(r => ToSummary(r, names)).ToList();
+        return (items, items.Count);
+    }
+
+    public async Task<PrintTemplateRecord?> GetTemplateAsync(string id)
+    {
+        if (!long.TryParse(id, out var lid)) return null;
+        var row = await _db.Select<RepCenter_ReportDesign>()
+            .Where(a => a.Id == lid && a.Flag > 0).FirstAsync();
+        if (row == null) return null;
+        var names = await ResolveUserNamesAsync(new[] { row.Adder, row.Updater });
+        return ToRecord(row, names);
+    }
+
+    public async Task<PrintTemplateRecord> CreateTemplateAsync(PrintTemplateInput input)
+    {
+        var row = new RepCenter_ReportDesign
+        {
+            Name = input.Name.Trim(),
+            ReportId = input.ReportId,
+            TemplateType = input.TemplateType,
+            PaperSize = input.PaperSize,
+            ContentJson = input.Content,
+            Flag = 1,
+            Adder = _currentUser.UserId,
+            Updater = _currentUser.UserId,
+        };
+        await _db.Insert(row).ExecuteAffrowsAsync();
+        var names = await ResolveUserNamesAsync(new[] { row.Adder, row.Updater });
+        return ToRecord(row, names);
+    }
+
+    public async Task<PrintTemplateRecord?> UpdateTemplateAsync(string id, PrintTemplateInput input)
+    {
+        if (!long.TryParse(id, out var lid)) return null;
+        var row = await _db.Select<RepCenter_ReportDesign>()
+            .Where(a => a.Id == lid && a.Flag > 0).FirstAsync();
+        if (row == null) return null;
+
+        if (!string.IsNullOrWhiteSpace(input.Name)) row.Name = input.Name.Trim();
+        if (input.Content != null) row.ContentJson = input.Content;
+        if (input.PaperSize != null) row.PaperSize = input.PaperSize;
+        if (input.ReportId > 0) row.ReportId = input.ReportId;
+        if (row.TemplateType != input.TemplateType && input.TemplateType >= 0) row.TemplateType = input.TemplateType;
+        row.Updater = _currentUser.UserId;
+
+        await _db.Update<RepCenter_ReportDesign>().SetSource(row).ExecuteAffrowsAsync();
+        var names = await ResolveUserNamesAsync(new[] { row.Adder, row.Updater });
+        return ToRecord(row, names);
+    }
+
+    public async Task<bool> DeleteTemplateAsync(string id)
+    {
+        if (!long.TryParse(id, out var lid)) return false;
+        var exists = await _db.Select<RepCenter_ReportDesign>()
+            .Where(a => a.Id == lid && a.Flag > 0).AnyAsync();
+        if (!exists) return false;
+        // 契约要求物理删除（204 无 body）
+        await _db.Delete<RepCenter_ReportDesign>().Where(a => a.Id == lid).ExecuteAffrowsAsync();
+        return true;
+    }
+
+    // ==================== 数据源内省 ====================
+
+    /// <summary>列出数据源：F9 业务模块分组（模块 → 实体表）</summary>
+    public List<PrintDataSourceMeta> ListDataSources()
+    {
+        var tables = GetEntityTables();
+        return tables
+            .GroupBy(t => t.Prefix)
+            .OrderBy(g => ModuleOrder(g.Key))
+            .ThenBy(g => g.Key)
+            .Select(g =>
+            {
+                var moduleName = ModuleNames.TryGetValue(g.Key, out var m) ? m : "其他业务";
+                return new PrintDataSourceMeta
+                {
+                    Id = ModuleIdOf(g.Key),
+                    Name = moduleName,
+                    Description = $"F9「{moduleName}」业务实体（{g.Count()} 张表）",
+                    Tables = g.OrderBy(t => t.Name).Select(t => new PrintTableMeta
+                    {
+                        Id = t.Name,
+                        Name = t.Description,
+                        Relation = "main",
+                        PathPrefix = t.Name + ".",
+                    }).ToList(),
+                };
+            })
+            .ToList();
+    }
+
+    /// <summary>获取指定数据源（模块）下所有表的字段定义</summary>
+    public List<PrintFieldDef> ListFields(string sourceId)
+    {
+        var target = ListDataSources().FirstOrDefault(s =>
+            string.Equals(s.Id, sourceId, StringComparison.OrdinalIgnoreCase));
+        if (target == null) return new List<PrintFieldDef>();
+
+        var tables = GetEntityTables();
+        var fields = new List<PrintFieldDef>();
+        foreach (var table in target.Tables)
+        {
+            var info = tables.FirstOrDefault(t => t.Name == table.Id);
+            if (info == null) continue;
+            fields.AddRange(BuildFields(info.Type, table.Id));
+        }
+        return fields;
+    }
+
+    // ==================== 私有实现 ====================
+
+    private sealed class EntityTableInfo
+    {
+        public string Name { get; set; } = "";
+        public string Description { get; set; } = "";
+        public string Prefix { get; set; } = "";
+        public Type Type { get; set; } = null!;
+    }
+
+    private static List<EntityTableInfo> GetEntityTables()
+    {
+        if (_tables != null) return _tables;
+
+        var result = new List<EntityTableInfo>();
+        var types = Assembly.Load("F9MES.Domain").GetTypes()
+            .Where(t => !t.IsAbstract && typeof(BaseEntity).IsAssignableFrom(t));
+        foreach (var type in types)
+        {
+            var tableAttr = type.GetCustomAttribute<TableAttribute>();
+            if (tableAttr == null) continue;
+            var name = tableAttr.Name;
+            if (string.IsNullOrEmpty(name)) continue;
+            if (ExcludedPrefixes.Any(p => name.StartsWith(p, StringComparison.OrdinalIgnoreCase))) continue;
+
+            var desc = type.GetCustomAttribute<DescriptionAttribute>()?.Description ?? name;
+            var idx = name.IndexOf('_');
+            var prefix = idx > 0 ? name[..(idx + 1)] : name + "_";
+            result.Add(new EntityTableInfo
+            {
+                Name = name,
+                Description = desc,
+                Prefix = prefix,
+                Type = type,
+            });
+        }
+        _tables = result;
+        return result;
+    }
+
+    /// <summary>模块前缀 → 数据源 ID（module_xxx，前缀去下划线并转小写）</summary>
+    private static string ModuleIdOf(string prefix) =>
+        "module_" + prefix.TrimEnd('_').ToLowerInvariant();
+
+    private static int ModuleOrder(string prefix)
+    {
+        var i = 0;
+        foreach (var kv in ModuleNames)
+        {
+            if (kv.Key == prefix) return i;
+            i++;
+        }
+        return int.MaxValue;
+    }
+
+    /// <summary>反射实体属性 → 字段定义</summary>
+    private static List<PrintFieldDef> BuildFields(Type type, string tableId)
+    {
+        var fields = new List<PrintFieldDef>();
+        var sort = 0;
+        var props = type.GetProperties(BindingFlags.Public | BindingFlags.Instance)
+            .Where(p => p.GetIndexParameters().Length == 0)
+            .OrderBy(p => p.MetadataToken);
+
+        foreach (var p in props)
+        {
+            var column = p.GetCustomAttribute<ColumnAttribute>(true);
+            if (column?.IsIgnore == true) continue;
+
+            var propType = Nullable.GetUnderlyingType(p.PropertyType) ?? p.PropertyType;
+            var kind = KindOf(propType);
+            if (kind == "skip") continue;
+
+            var label = p.GetCustomAttribute<DescriptionAttribute>()?.Description ?? p.Name;
+            var isAudit = AuditFieldNames.Contains(p.Name);
+            fields.Add(new PrintFieldDef
+            {
+                Path = $"{tableId}.{p.Name}",
+                Label = label,
+                Type = kind,
+                TableId = tableId,
+                Group = isAudit ? "系统信息" : null,
+                Sort = sort++,
+                Sample = SampleOf(kind),
+                Hidden = p.Name is "Flag" or "Adder" or "Updater",
+                Options = propType.IsEnum ? EnumOptions(propType) : null,
+            });
+        }
+        return fields;
+    }
+
+    /// <summary>C# 类型 → 字段类型（string/number/date/bool/image，其余跳过）</summary>
+    private static string KindOf(Type t)
+    {
+        if (t == typeof(string) || t == typeof(char) || t == typeof(Guid)) return "string";
+        if (t == typeof(bool)) return "bool";
+        if (t == typeof(DateTime)) return "date";
+        if (t == typeof(byte[])) return "image";
+        if (t.IsEnum) return "string";
+        if (IsNumeric(t)) return "number";
+        return "skip";
+    }
+
+    private static bool IsNumeric(Type t) =>
+        Type.GetTypeCode(t) is TypeCode.Byte or TypeCode.SByte or TypeCode.Int16 or TypeCode.UInt16
+            or TypeCode.Int32 or TypeCode.UInt32 or TypeCode.Int64 or TypeCode.UInt64
+            or TypeCode.Single or TypeCode.Double or TypeCode.Decimal;
+
+    private static object? SampleOf(string kind) => kind switch
+    {
+        "number" => 0,
+        "date" => DateTime.Today.ToString("yyyy-MM-dd"),
+        "bool" => false,
+        _ => "",
+    };
+
+    private static List<PrintFieldOption>? EnumOptions(Type enumType)
+    {
+        var names = Enum.GetNames(enumType);
+        if (names.Length == 0) return null;
+        return names.Select(n => new PrintFieldOption { Value = n, Label = n }).ToList();
+    }
+
+    /// <summary>用户 UID → 姓名（用户表未初始化时降级为 UID 字符串）</summary>
+    private async Task<Dictionary<long, string>> ResolveUserNamesAsync(long[] uids)
+    {
+        var dict = new Dictionary<long, string>();
+        var distinct = uids.Distinct().Where(id => id > 0).ToArray();
+        if (distinct.Length == 0) return dict;
+
+        try
+        {
+            var users = await _db.Select<BaseSys_User>()
+                .Where(a => distinct.Contains(a.Id))
+                .ToListAsync();
+            foreach (var u in users) dict[u.Id] = u.Name;
+        }
+        catch
+        {
+            // 系统初始化前用户表不存在，忽略
+        }
+        foreach (var id in distinct)
+        {
+            if (!dict.ContainsKey(id)) dict[id] = id.ToString();
+        }
+        return dict;
+    }
+
+    private static PrintTemplateSummary ToSummary(RepCenter_ReportDesign r,
+        IReadOnlyDictionary<long, string> names) => new()
+    {
+        Id = r.Id.ToString(),
+        Name = r.Name,
+        Category = r.TemplateType switch { 1 => "单据", 2 => "标签", _ => "报表" },
+        Visibility = "private",
+        CreatedBy = names.TryGetValue(r.Adder, out var a) ? a : null,
+        CreatedAt = r.AddTime,
+        UpdatedBy = names.TryGetValue(r.Updater, out var u) ? u : null,
+        UpdatedAt = r.UpdateTime,
+        Permissions = new PrintPermission
+        {
+            Editable = r.IsEnable > 0,
+            Deletable = true,
+            Copyable = true,
+        },
+        IsDefault = r.IsDefault > 0,
+        PaperSize = r.PaperSize,
+    };
+
+    private static PrintTemplateRecord ToRecord(RepCenter_ReportDesign r,
+        IReadOnlyDictionary<long, string> names)
+    {
+        var record = new PrintTemplateRecord
+        {
+            Content = r.ContentJson,
+        };
+        // 摘要字段赋值（此处保留顺序避免遗漏）
+        record.Id = r.Id.ToString();
+        record.Name = r.Name;
+        record.Category = r.TemplateType switch { 1 => "单据", 2 => "标签", _ => "报表" };
+        record.Visibility = "private";
+        record.CreatedBy = names.TryGetValue(r.Adder, out var a) ? a : null;
+        record.CreatedAt = r.AddTime;
+        record.UpdatedBy = names.TryGetValue(r.Updater, out var u) ? u : null;
+        record.UpdatedAt = r.UpdateTime;
+        record.Permissions = new PrintPermission
+        {
+            Editable = r.IsEnable > 0,
+            Deletable = true,
+            Copyable = true,
+        };
+        record.IsDefault = r.IsDefault > 0;
+        record.PaperSize = r.PaperSize;
+        return record;
+    }
+}
diff --git a/server/src/F9MES.Common/Auth/CurrentUser.cs b/server/src/F9MES.Common/Auth/CurrentUser.cs
new file mode 100644
index 0000000..4aae3ee
--- /dev/null
+++ b/server/src/F9MES.Common/Auth/CurrentUser.cs
@@ -0,0 +1,25 @@
+namespace F9MES.Common.Auth;
+
+/// <summary>
+/// 当前登录用户信息
+/// </summary>
+public class CurrentUser
+{
+    /// <summary>用户ID</summary>
+    public long UserId { get; set; }
+
+    /// <summary>用户姓名</summary>
+    public string Name { get; set; } = "";
+
+    /// <summary>登录手机号</summary>
+    public string Phone { get; set; } = "";
+
+    /// <summary>是否超级管理员</summary>
+    public bool IsSuperAdmin { get; set; }
+
+    /// <summary>所属组织ID（数据权限）</summary>
+    public long OrgId { get; set; }
+
+    /// <summary>角色ID集合</summary>
+    public List<long> RoleIds { get; set; } = new();
+}
diff --git a/server/src/F9MES.Common/Auth/CurrentUserService.cs b/server/src/F9MES.Common/Auth/CurrentUserService.cs
new file mode 100644
index 0000000..386e44c
--- /dev/null
+++ b/server/src/F9MES.Common/Auth/CurrentUserService.cs
@@ -0,0 +1,28 @@
+using Microsoft.AspNetCore.Http;
+
+namespace F9MES.Common.Auth;
+
+/// <summary>
+/// 当前用户上下文访问服务：从 HTTP 请求中解析登录用户
+/// </summary>
+public class CurrentUserService
+{
+    private readonly IHttpContextAccessor _accessor;
+
+    public CurrentUserService(IHttpContextAccessor accessor)
+    {
+        _accessor = accessor;
+    }
+
+    /// <summary>当前登录用户（未登录返回 null）</summary>
+    public CurrentUser? User => JwtHelper.ParseUser(_accessor.HttpContext?.User);
+
+    /// <summary>当前用户ID（未登录返回 0）</summary>
+    public long UserId => User?.UserId ?? 0;
+
+    /// <summary>是否已登录</summary>
+    public bool IsAuthenticated => User != null;
+
+    /// <summary>是否超级管理员</summary>
+    public bool IsSuperAdmin => User?.IsSuperAdmin ?? false;
+}
diff --git a/server/src/F9MES.Common/Auth/JwtHelper.cs b/server/src/F9MES.Common/Auth/JwtHelper.cs
new file mode 100644
index 0000000..0068426
--- /dev/null
+++ b/server/src/F9MES.Common/Auth/JwtHelper.cs
@@ -0,0 +1,72 @@
+using System.IdentityModel.Tokens.Jwt;
+using System.Security.Claims;
+using System.Text;
+using Microsoft.IdentityModel.Tokens;
+
+namespace F9MES.Common.Auth;
+
+/// <summary>
+/// JWT 令牌工具：生成/解析登录令牌
+/// </summary>
+public class JwtHelper
+{
+    private readonly string _issuer;
+    private readonly string _audience;
+    private readonly string _secret;
+    private readonly int _expireMinutes;
+
+    public JwtHelper(string issuer, string audience, string secret, int expireMinutes = 7200)
+    {
+        _issuer = issuer;
+        _audience = audience;
+        _secret = secret;
+        _expireMinutes = expireMinutes;
+    }
+
+    /// <summary>
+    /// 生成 JWT 令牌
+    /// </summary>
+    /// <param name="userId">用户ID</param>
+    /// <param name="phone">登录手机号</param>
+    /// <param name="userName">用户姓名</param>
+    /// <param name="isSuperAdmin">是否超级管理员</param>
+    public string CreateToken(long userId, string phone, string userName, bool isSuperAdmin = false)
+    {
+        var claims = new List<Claim>
+        {
+            new(ClaimTypes.NameIdentifier, userId.ToString()),
+            new(ClaimTypes.Name, userName ?? phone),
+            new("phone", phone),
+            new("isSuperAdmin", isSuperAdmin ? "1" : "0"),
+        };
+
+        var key = new SymmetricSecurityKey(Encoding.UTF8.GetBytes(_secret));
+        var credentials = new SigningCredentials(key, SecurityAlgorithms.HmacSha256);
+
+        var token = new JwtSecurityToken(
+            issuer: _issuer,
+            audience: _audience,
+            claims: claims,
+            expires: DateTime.Now.AddMinutes(_expireMinutes),
+            signingCredentials: credentials);
+
+        return new JwtSecurityTokenHandler().WriteToken(token);
+    }
+
+    /// <summary>
+    /// 从 ClaimsPrincipal 解析当前登录用户
+    /// </summary>
+    public static CurrentUser? ParseUser(ClaimsPrincipal principal)
+    {
+        if (principal?.Identity?.IsAuthenticated != true) return null;
+        var userId = principal.FindFirst(ClaimTypes.NameIdentifier)?.Value;
+        if (string.IsNullOrEmpty(userId)) return null;
+        return new CurrentUser
+        {
+            UserId = long.Parse(userId),
+            Name = principal.FindFirst(ClaimTypes.Name)?.Value ?? "",
+            Phone = principal.FindFirst("phone")?.Value ?? "",
+            IsSuperAdmin = principal.FindFirst("isSuperAdmin")?.Value == "1"
+        };
+    }
+}
diff --git a/server/src/F9MES.Common/Cache/CacheService.cs b/server/src/F9MES.Common/Cache/CacheService.cs
new file mode 100644
index 0000000..1cabf60
--- /dev/null
+++ b/server/src/F9MES.Common/Cache/CacheService.cs
@@ -0,0 +1,74 @@
+using Microsoft.Extensions.Caching.Memory;
+using Microsoft.Extensions.Configuration;
+
+namespace F9MES.Common.Cache;
+
+/// <summary>
+/// 内存缓存服务：基于 IMemoryCache，用于菜单/权限/字典等高频数据的缓存
+/// </summary>
+public class CacheService
+{
+    private readonly IMemoryCache _cache;
+
+    public CacheService(IMemoryCache cache)
+    {
+        _cache = cache;
+    }
+
+    /// <summary>
+    /// 读取缓存，不存在时通过 factory 生成并写入
+    /// </summary>
+    public T GetOrCreate<T>(string key, Func<T> factory, int expireSeconds = 300)
+    {
+        return _cache.GetOrCreate(key, entry =>
+        {
+            entry.SlidingExpiration = TimeSpan.FromSeconds(expireSeconds);
+            return factory();
+        })!;
+    }
+
+    /// <summary>
+    /// 写入缓存
+    /// </summary>
+    public void Set<T>(string key, T value, int expireSeconds = 300)
+    {
+        _cache.Set(key, value, TimeSpan.FromSeconds(expireSeconds));
+    }
+
+    /// <summary>
+    /// 读取缓存
+    /// </summary>
+    public T? Get<T>(string key)
+    {
+        return _cache.TryGetValue(key, out var value) ? (T?)value : default;
+    }
+
+    /// <summary>
+    /// 移除缓存
+    /// </summary>
+    public void Remove(string key)
+    {
+        _cache.Remove(key);
+    }
+
+    /// <summary>
+    /// 按前缀移除缓存（如 "menu:" 开头的全部失效）
+    /// </summary>
+    public void RemoveByPrefix(string prefix)
+    {
+        var keys = GetKeys().Where(k => k.StartsWith(prefix, StringComparison.OrdinalIgnoreCase)).ToList();
+        foreach (var k in keys) _cache.Remove(k);
+    }
+
+    private IEnumerable<string> GetKeys()
+    {
+        // IMemoryCache 没有直接枚举方法，这里通过反射获取 key（兼容实现）
+        var field = typeof(MemoryCache).GetField("_entries", System.Reflection.BindingFlags.NonPublic | System.Reflection.BindingFlags.Instance);
+        if (field?.GetValue(_cache) is not System.Collections.IDictionary dict) yield break;
+        foreach (var key in dict.Keys)
+        {
+            if (key is ICacheEntry entry) yield return entry.Key.ToString() ?? "";
+            else yield return key?.ToString() ?? "";
+        }
+    }
+}
diff --git a/server/src/F9MES.Common/Entities/BaseEntity.cs b/server/src/F9MES.Common/Entities/BaseEntity.cs
new file mode 100644
index 0000000..3346a33
--- /dev/null
+++ b/server/src/F9MES.Common/Entities/BaseEntity.cs
@@ -0,0 +1,43 @@
+using System.ComponentModel;
+using FreeSql.DataAnnotations;
+
+namespace F9MES.Common.Entities;
+
+/// <summary>
+/// 实体基类：所有业务表均继承此类，保证公共字段统一
+/// 约定：id(主键)、flag(有效状态)、addtime(添加时间)、adder(添加人)、
+///       updatetime(修改时间)、updater(修改人)、memo(备注)
+/// 列注释通过 [Description] 特性提供（FreeSql 自动读取为数据库字段注释）
+/// </summary>
+public class BaseEntity
+{
+    /// <summary>主键ID（自增）</summary>
+    [Column(IsPrimary = true, IsIdentity = true)]
+    [Description("主键ID")]
+    public long Id { get; set; }
+
+    /// <summary>数据有效状态：0=删除，>0=有效，<0=无效（-1=作废）</summary>
+    [Description("数据有效状态：0=删除，>0=有效，<0=无效（-1=作废）")]
+    public int Flag { get; set; } = 1;
+
+    /// <summary>添加时间</summary>
+    [Description("添加时间")]
+    public DateTime AddTime { get; set; } = DateTime.Now;
+
+    /// <summary>添加人（用户UID）</summary>
+    [Description("添加人（用户UID）")]
+    public long Adder { get; set; }
+
+    /// <summary>修改时间</summary>
+    [Description("修改时间")]
+    public DateTime UpdateTime { get; set; } = DateTime.Now;
+
+    /// <summary>修改人（用户UID）</summary>
+    [Description("修改人（用户UID）")]
+    public long Updater { get; set; }
+
+    /// <summary>备注</summary>
+    [Column(DbType = "varchar(500)")]
+    [Description("备注")]
+    public string? Memo { get; set; }
+}
diff --git a/server/src/F9MES.Common/Entities/BaseTreeEntity.cs b/server/src/F9MES.Common/Entities/BaseTreeEntity.cs
new file mode 100644
index 0000000..39ac7c9
--- /dev/null
+++ b/server/src/F9MES.Common/Entities/BaseTreeEntity.cs
@@ -0,0 +1,31 @@
+using System.ComponentModel;
+using FreeSql.DataAnnotations;
+
+namespace F9MES.Common.Entities;
+
+/// <summary>
+/// 树形实体基类：菜单、组织架构、物资分类等树形结构通用
+/// </summary>
+public class BaseTreeEntity : BaseEntity
+{
+    /// <summary>父级ID（0 表示根节点）</summary>
+    [Description("父级ID（0 表示根节点）")]
+    public long ParentId { get; set; }
+
+    /// <summary>排序号（同级内升序排列）</summary>
+    [Description("排序号")]
+    public int Sort { get; set; } = 0;
+
+    /// <summary>层级（0=根级，1=一级...）</summary>
+    [Description("层级（0=根级）")]
+    public int Level { get; set; } = 0;
+
+    /// <summary>节点路径（如 /1/5/8，用于快速查询子树）</summary>
+    [Column(DbType = "varchar(255)")]
+    [Description("节点路径（如 /1/5/8）")]
+    public string Path { get; set; } = "";
+
+    /// <summary>是否启用（1=启用，0=停用）</summary>
+    [Description("是否启用（1=启用，0=停用）")]
+    public int IsEnable { get; set; } = 1;
+}
diff --git a/server/src/F9MES.Common/F9MES.Common.csproj b/server/src/F9MES.Common/F9MES.Common.csproj
new file mode 100644
index 0000000..3a9aab2
--- /dev/null
+++ b/server/src/F9MES.Common/F9MES.Common.csproj
@@ -0,0 +1,23 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <TargetFramework>net10.0</TargetFramework>
+    <ImplicitUsings>enable</ImplicitUsings>
+    <Nullable>enable</Nullable>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <PackageReference Include="FreeSql" Version="3.5.311" />
+    <PackageReference Include="FreeSql.Provider.MySql" Version="3.5.311" />
+    <PackageReference Include="FreeSql.Provider.Sqlite" Version="3.5.311" />
+    <PackageReference Include="Microsoft.Extensions.Caching.Memory" Version="10.0.0" />
+    <PackageReference Include="Microsoft.Extensions.Configuration.Abstractions" Version="10.0.0" />
+    <PackageReference Include="Microsoft.Extensions.DependencyInjection.Abstractions" Version="10.0.0" />
+    <PackageReference Include="System.IdentityModel.Tokens.Jwt" Version="8.6.0" />
+  </ItemGroup>
+
+  <ItemGroup>
+    <FrameworkReference Include="Microsoft.AspNetCore.App" />
+  </ItemGroup>
+
+</Project>
diff --git a/server/src/F9MES.Common/FreeSql/FreeSqlProvider.cs b/server/src/F9MES.Common/FreeSql/FreeSqlProvider.cs
new file mode 100644
index 0000000..3095bb5
--- /dev/null
+++ b/server/src/F9MES.Common/FreeSql/FreeSqlProvider.cs
@@ -0,0 +1,41 @@
+using FreeSql;
+using Microsoft.Extensions.Configuration;
+
+namespace F9MES.Common.FreeSql;
+
+/// <summary>
+/// FreeSql 实例工厂
+/// 主库：云 MySQL（业务数据，CodeFirst 自动建表）
+/// 缓存库：本地 SQLite（缓存/临时数据）
+/// </summary>
+public class FreeSqlProvider
+{
+    private readonly IConfiguration _config;
+
+    /// <summary>主库实例（MySQL）</summary>
+    public IFreeSql Db { get; }
+
+    /// <summary>缓存库实例（SQLite）</summary>
+    public IFreeSql CacheDb { get; }
+
+    public FreeSqlProvider(IConfiguration config)
+    {
+        _config = config;
+
+        // ===== 主库：云 MySQL =====
+        var mysqlConn = config.GetConnectionString("MySQL")
+            ?? throw new Exception("未配置连接字符串 MySQL");
+        Db = new FreeSqlBuilder()
+            .UseConnectionString(DataType.MySql, mysqlConn)
+            .UseNameConvert(global::FreeSql.Internal.NameConvertType.None) // 表/列名保持 C# 原样命名（模块前缀由实体 Table 特性指定）
+            .UseAutoSyncStructure(true)           // CodeFirst：启动自动同步表结构（只增不删不改）
+            .Build();
+
+        // ===== 缓存库：本地 SQLite =====
+        var sqlitePath = config["Sqlite:Path"] ?? "f9mes_cache.db";
+        CacheDb = new FreeSqlBuilder()
+            .UseConnectionString(DataType.Sqlite, $"Data Source={sqlitePath}")
+            .UseAutoSyncStructure(true)
+            .Build();
+    }
+}
diff --git a/server/src/F9MES.Common/Result/ApiResult.cs b/server/src/F9MES.Common/Result/ApiResult.cs
new file mode 100644
index 0000000..c07e488
--- /dev/null
+++ b/server/src/F9MES.Common/Result/ApiResult.cs
@@ -0,0 +1,47 @@
+namespace F9MES.Common.Result;
+
+/// <summary>
+/// 统一 API 返回结果
+/// code: 0=成功，非0=失败
+/// </summary>
+public class ApiResult
+{
+    /// <summary>状态码：0=成功</summary>
+    public int Code { get; set; } = 0;
+
+    /// <summary>提示消息</summary>
+    public string Message { get; set; } = "操作成功";
+
+    /// <summary>业务数据</summary>
+    public object? Data { get; set; }
+
+    /// <summary>是否成功</summary>
+    public bool Success => Code == 0;
+
+    public static ApiResult Ok(object? data = null, string message = "操作成功")
+        => new ApiResult { Code = 0, Message = message, Data = data };
+
+    public static ApiResult Error(string message, int code = 1, object? data = null)
+        => new ApiResult { Code = code, Message = message, Data = data };
+}
+
+/// <summary>
+/// 统一分页返回
+/// </summary>
+public class PageResult<T>
+{
+    /// <summary>当前页</summary>
+    public int Page { get; set; }
+
+    /// <summary>每页条数</summary>
+    public int Size { get; set; }
+
+    /// <summary>总条数</summary>
+    public long Total { get; set; }
+
+    /// <summary>当前页数据</summary>
+    public List<T> Items { get; set; } = new();
+
+    public static PageResult<T> From(int page, int size, long total, List<T> items)
+        => new PageResult<T> { Page = page, Size = size, Total = total, Items = items };
+}
diff --git a/server/src/F9MES.Common/Utils/OrderNoGenerator.cs b/server/src/F9MES.Common/Utils/OrderNoGenerator.cs
new file mode 100644
index 0000000..c16d0c3
--- /dev/null
+++ b/server/src/F9MES.Common/Utils/OrderNoGenerator.cs
@@ -0,0 +1,73 @@
+using FreeSql;
+using FreeSql.DataAnnotations;
+
+namespace F9MES.Common.Utils;
+
+/// <summary>
+/// 业务单号生成器
+/// 规则示例：
+///   原料庄口：YLZ + yyyyMMdd + 3位流水（YLZ20260815-001）
+///   工艺庄口：GYZ + 年度 + 流水（GYZ-2026-001）
+///   采购单  ：CG + yyyyMMdd + 4位流水
+/// 并发安全：基于编号流水表（主库）+ 原子自增实现
+/// </summary>
+public class OrderNoGenerator
+{
+    private readonly IFreeSql _db;
+
+    public OrderNoGenerator(IFreeSql db)
+    {
+        _db = db;
+    }
+
+    /// <summary>
+    /// 生成编号（前缀与日期、日期与流水共用同一分隔符）
+    /// </summary>
+    /// <param name="prefix">前缀，如 YLZ</param>
+    /// <param name="datePart">日期部分格式，如 yyyyMMdd；不需要日期可传空串</param>
+    /// <param name="seqLen">流水号位数，默认3位</param>
+    /// <param name="separator">前缀与日期/流水之间的分隔符，默认空</param>
+    public string Generate(string prefix, string datePart = "yyyyMMdd", int seqLen = 3, string separator = "")
+        => Generate2(prefix, datePart, seqLen, separator, separator);
+
+    /// <summary>
+    /// 生成编号（前缀与日期、日期与流水使用不同分隔符）
+    /// 示例：Generate2("GYZ", "yyyy", 3, "-", "-") → GYZ-2026-001
+    ///       Generate2("YLZ", "yyyyMMdd", 3, "", "-") → YLZ20260815-001
+    /// </summary>
+    /// <param name="prefix">前缀，如 YLZ</param>
+    /// <param name="datePart">日期部分格式，如 yyyyMMdd；不需要日期可传空串</param>
+    /// <param name="seqLen">流水号位数，默认3位</param>
+    /// <param name="sepDate">前缀与日期之间的分隔符</param>
+    /// <param name="sepSeq">日期与流水之间的分隔符</param>
+    public string Generate2(string prefix, string datePart = "yyyyMMdd", int seqLen = 3, string sepDate = "", string sepSeq = "-")
+    {
+        string date = datePart == "" ? "" : DateTime.Now.ToString(datePart);
+        string key = $"{prefix}_{date}";
+
+        // 原子自增：INSERT IGNORE 初始化 + UPDATE 自增，保证并发下流水号唯一
+        // 注意：UseNameConvert(None) 下 FreeSql 建表列名为 C# 原样（SeqKey/SeqValue），不能加下划线
+        _db.Ado.ExecuteNonQuery(
+            $"INSERT IGNORE INTO seq_counter(SeqKey, SeqValue) VALUES ('{key}', 0)");
+        _db.Ado.ExecuteNonQuery(
+            $"UPDATE seq_counter SET SeqValue = SeqValue + 1 WHERE SeqKey = '{key}'");
+        long seq = _db.Ado.QuerySingle<long>(
+            $"SELECT SeqValue FROM seq_counter WHERE SeqKey = '{key}'");
+
+        string seqStr = seq.ToString().PadLeft(seqLen, '0');
+        if (date == "") return $"{prefix}{sepDate}{seqStr}";
+        return $"{prefix}{sepDate}{date}{sepSeq}{seqStr}";
+    }
+}
+
+/// <summary>编号流水计数器（存于主库 seq_counter 表）</summary>
+[Table(Name = "seq_counter")]
+public class SeqCounter
+{
+    /// <summary>流水键：前缀_日期，如 YLZ_20260815</summary>
+    [Column(IsPrimary = true)]
+    public string? SeqKey { get; set; }
+
+    /// <summary>当前流水值</summary>
+    public long SeqValue { get; set; }
+}
diff --git a/server/src/F9MES.Domain/BaseCommon/BaseCommon_Entities.cs b/server/src/F9MES.Domain/BaseCommon/BaseCommon_Entities.cs
new file mode 100644
index 0000000..2e83f1e
--- /dev/null
+++ b/server/src/F9MES.Domain/BaseCommon/BaseCommon_Entities.cs
@@ -0,0 +1,316 @@
+using System.ComponentModel;
+using FreeSql.DataAnnotations;
+using F9MES.Common.Entities;
+
+namespace F9MES.Domain.BaseCommon;
+
+/// <summary>
+/// 基础数据模块实体（BaseCommon），表名前缀：BaseCommon_
+/// </summary>
+
+/// <summary>物资分类（树形：配件/生丝/干茧/副产品等）</summary>
+[Table(Name = "BaseCommon_MaterialType")]
+[Description("基础数据-物资分类")]
+public class BaseCommon_MaterialType : BaseTreeEntity
+{
+    /// <summary>分类名称</summary>
+    [Column(DbType = "varchar(100)")]
+    [Description("分类名称")]
+    public string Name { get; set; } = "";
+
+    /// <summary>分类编码</summary>
+    [Column(DbType = "varchar(50)")]
+    [Description("分类编码")]
+    public string? Code { get; set; }
+}
+
+/// <summary>物资目录（统一物资主数据）</summary>
+[Table(Name = "BaseCommon_Material")]
+[Index("idx_material_code_unique", "Code", true)]
+[Index("idx_material_type", "TypeId")]
+[Description("基础数据-物资目录")]
+public class BaseCommon_Material : BaseEntity
+{
+    /// <summary>物资编码（唯一）</summary>
+    [Column(DbType = "varchar(50)")]
+    [Description("物资编码（唯一）")]
+    public string Code { get; set; } = "";
+
+    /// <summary>物资名称</summary>
+    [Column(DbType = "varchar(100)")]
+    [Description("物资名称")]
+    public string Name { get; set; } = "";
+
+    /// <summary>分类ID（BaseCommon_MaterialType）</summary>
+    [Description("分类ID")]
+    public long TypeId { get; set; }
+
+    /// <summary>物资类型：0=原料 1=生丝 2=副产品 3=五金配件 4=辅料 5=能源</summary>
+    [Description("物资类型：0=原料 1=生丝 2=副产品 3=五金 4=辅料 5=能源")]
+    public int MaterialType { get; set; } = 0;
+
+    /// <summary>规格型号</summary>
+    [Column(DbType = "varchar(100)")]
+    [Description("规格型号")]
+    public string? Spec { get; set; }
+
+    /// <summary>计量单位</summary>
+    [Column(DbType = "varchar(20)")]
+    [Description("计量单位")]
+    public string? Unit { get; set; }
+
+    /// <summary>是否启用</summary>
+    [Description("是否启用")]
+    public int IsEnable { get; set; } = 1;
+}
+
+/// <summary>生丝规格（纤度范围、野纤范围等）</summary>
+[Table(Name = "BaseCommon_SilkSpec")]
+[Description("基础数据-生丝规格")]
+public class BaseCommon_SilkSpec : BaseEntity
+{
+    /// <summary>规格名称（如 20/22D）</summary>
+    [Column(DbType = "varchar(50)")]
+    [Description("规格名称")]
+    public string Name { get; set; } = "";
+
+    /// <summary>规格编码</summary>
+    [Column(DbType = "varchar(50)")]
+    [Description("规格编码")]
+    public string? Code { get; set; }
+
+    /// <summary>中心纤度（D）</summary>
+    [Column(DbType = "decimal(10,2)")]
+    [Description("中心纤度（D）")]
+    public decimal CenterDenier { get; set; }
+
+    /// <summary>纤度下限（D）</summary>
+    [Column(DbType = "decimal(10,2)")]
+    [Description("纤度下限（D）")]
+    public decimal DenierMin { get; set; }
+
+    /// <summary>纤度上限（D）</summary>
+    [Column(DbType = "decimal(10,2)")]
+    [Description("纤度上限（D）")]
+    public decimal DenierMax { get; set; }
+
+    /// <summary>纤度偏差允许范围（%）</summary>
+    [Column(DbType = "decimal(10,2)")]
+    [Description("纤度偏差允许范围（%）")]
+    public decimal DeviationRange { get; set; }
+
+    /// <summary>野纤允许范围</summary>
+    [Column(DbType = "decimal(10,2)")]
+    [Description("野纤允许范围")]
+    public decimal WildRange { get; set; }
+
+    /// <summary>是否启用</summary>
+    [Description("是否启用")]
+    public int IsEnable { get; set; } = 1;
+}
+
+/// <summary>生丝定级标准（厂检定级标准，版本化管理）</summary>
+[Table(Name = "BaseCommon_GradeStandard")]
+[Description("基础数据-生丝定级标准")]
+public class BaseCommon_GradeStandard : BaseEntity
+{
+    /// <summary>标准名称</summary>
+    [Column(DbType = "varchar(100)")]
+    [Description("标准名称")]
+    public string Name { get; set; } = "";
+
+    /// <summary>版本号</summary>
+    [Column(DbType = "varchar(30)")]
+    [Description("版本号")]
+    public string Version { get; set; } = "1.0";
+
+    /// <summary>生效日期</summary>
+    [Description("生效日期")]
+    public DateTime EffectiveDate { get; set; }
+
+    /// <summary>定级规则JSON（等级判定规则配置）</summary>
+    [Column(DbType = "text")]
+    [Description("定级规则JSON")]
+    public string? RuleJson { get; set; }
+
+    /// <summary>是否当前生效版本</summary>
+    [Description("是否当前生效版本")]
+    public int IsCurrent { get; set; } = 0;
+
+    /// <summary>是否启用</summary>
+    [Description("是否启用")]
+    public int IsEnable { get; set; } = 1;
+}
+
+/// <summary>业务账期（薪资、结算等期间划分依据）</summary>
+[Table(Name = "BaseCommon_AccountPeriod")]
+[Description("基础数据-业务账期")]
+public class BaseCommon_AccountPeriod : BaseEntity
+{
+    /// <summary>账期名称（如 2026年8月）</summary>
+    [Column(DbType = "varchar(100)")]
+    [Description("账期名称")]
+    public string Name { get; set; } = "";
+
+    /// <summary>账期编码（如 202608）</summary>
+    [Column(DbType = "varchar(30)")]
+    [Description("账期编码")]
+    public string? Code { get; set; }
+
+    /// <summary>开始日期</summary>
+    [Description("开始日期")]
+    public DateTime StartDate { get; set; }
+
+    /// <summary>结束日期</summary>
+    [Description("结束日期")]
+    public DateTime EndDate { get; set; }
+
+    /// <summary>状态：0=草稿 1=已开账 2=已关账</summary>
+    [Description("状态：0=草稿 1=已开账 2=已关账")]
+    public int Status { get; set; } = 1;
+}
+
+/// <summary>工种划分（岗位/工种分类）</summary>
+[Table(Name = "BaseCommon_WorkType")]
+[Description("基础数据-工种划分")]
+public class BaseCommon_WorkType : BaseEntity
+{
+    /// <summary>工种名称</summary>
+    [Column(DbType = "varchar(50)")]
+    [Description("工种名称")]
+    public string Name { get; set; } = "";
+
+    /// <summary>工种编码</summary>
+    [Column(DbType = "varchar(50)")]
+    [Description("工种编码")]
+    public string? Code { get; set; }
+
+    /// <summary>工种类别：0=缫丝工 1=车头工 2=选茧工 3=复摇工 4=检验工 5=其他</summary>
+    [Description("工种类别")]
+    public int WorkCategory { get; set; } = 0;
+
+    /// <summary>是否计件工种</summary>
+    [Description("是否计件工种")]
+    public int IsPiecework { get; set; } = 0;
+
+    /// <summary>是否启用</summary>
+    [Description("是否启用")]
+    public int IsEnable { get; set; } = 1;
+}
+
+/// <summary>往来单位（客户/供应商统一档案）</summary>
+[Table(Name = "BaseCommon_Partner")]
+[Index("idx_partner_code_unique", "Code", true)]
+[Index("idx_partner_type", "PartnerType")]
+[Description("基础数据-往来单位")]
+public class BaseCommon_Partner : BaseEntity
+{
+    /// <summary>单位编码（唯一）</summary>
+    [Column(DbType = "varchar(50)")]
+    [Description("单位编码（唯一）")]
+    public string Code { get; set; } = "";
+
+    /// <summary>单位名称</summary>
+    [Column(DbType = "varchar(200)")]
+    [Description("单位名称")]
+    public string Name { get; set; } = "";
+
+    /// <summary>单位类型：0=客户 1=供应商</summary>
+    [Description("单位类型：0=客户 1=供应商")]
+    public int PartnerType { get; set; } = 0;
+
+    /// <summary>简称</summary>
+    [Column(DbType = "varchar(100)")]
+    [Description("简称")]
+    public string? ShortName { get; set; }
+
+    /// <summary>联系人</summary>
+    [Column(DbType = "varchar(50)")]
+    [Description("联系人")]
+    public string? Contact { get; set; }
+
+    /// <summary>联系电话</summary>
+    [Column(DbType = "varchar(30)")]
+    [Description("联系电话")]
+    public string? Phone { get; set; }
+
+    /// <summary>地址</summary>
+    [Column(DbType = "varchar(255)")]
+    [Description("地址")]
+    public string? Address { get; set; }
+
+    /// <summary>税号</summary>
+    [Column(DbType = "varchar(50)")]
+    [Description("税号")]
+    public string? TaxNo { get; set; }
+
+    /// <summary>开户行</summary>
+    [Column(DbType = "varchar(100)")]
+    [Description("开户行")]
+    public string? BankName { get; set; }
+
+    /// <summary>银行账号</summary>
+    [Column(DbType = "varchar(50)")]
+    [Description("银行账号")]
+    public string? BankAccount { get; set; }
+
+    /// <summary>是否启用</summary>
+    [Description("是否启用")]
+    public int IsEnable { get; set; } = 1;
+}
+
+/// <summary>数据字典类型</summary>
+[Table(Name = "BaseCommon_DictType")]
+[Index("idx_dicttype_code_unique", "Code", true)]
+[Description("基础数据-数据字典类型")]
+public class BaseCommon_DictType : BaseEntity
+{
+    /// <summary>字典类型编码（如 sex、material_type）</summary>
+    [Column(DbType = "varchar(50)")]
+    [Description("字典类型编码")]
+    public string Code { get; set; } = "";
+
+    /// <summary>字典类型名称</summary>
+    [Column(DbType = "varchar(100)")]
+    [Description("字典类型名称")]
+    public string Name { get; set; } = "";
+
+    /// <summary>是否系统内置</summary>
+    [Description("是否系统内置")]
+    public int IsSystem { get; set; } = 0;
+}
+
+/// <summary>数据字典项（注册表，键值结构）</summary>
+[Table(Name = "BaseCommon_Dict")]
+[Index("idx_dict_type", "TypeCode")]
+[Description("基础数据-数据字典项")]
+public class BaseCommon_Dict : BaseEntity
+{
+    /// <summary>字典类型编码</summary>
+    [Column(DbType = "varchar(50)")]
+    [Description("字典类型编码")]
+    public string TypeCode { get; set; } = "";
+
+    /// <summary>字典键（Value）</summary>
+    [Column(DbType = "varchar(100)")]
+    [Description("字典键")]
+    public string DictKey { get; set; } = "";
+
+    /// <summary>字典值（Label）</summary>
+    [Column(DbType = "varchar(200)")]
+    [Description("字典值")]
+    public string DictValue { get; set; } = "";
+
+    /// <summary>扩展数据（JSON，可存颜色/图标等）</summary>
+    [Column(DbType = "varchar(500)")]
+    [Description("扩展数据JSON")]
+    public string? ExtData { get; set; }
+
+    /// <summary>排序号</summary>
+    [Description("排序号")]
+    public int Sort { get; set; } = 0;
+
+    /// <summary>是否启用</summary>
+    [Description("是否启用")]
+    public int IsEnable { get; set; } = 1;
+}
diff --git a/server/src/F9MES.Domain/BaseSys/BaseSys_Entities.cs b/server/src/F9MES.Domain/BaseSys/BaseSys_Entities.cs
new file mode 100644
index 0000000..c46821d
--- /dev/null
+++ b/server/src/F9MES.Domain/BaseSys/BaseSys_Entities.cs
@@ -0,0 +1,206 @@
+using System.ComponentModel;
+using FreeSql.DataAnnotations;
+using F9MES.Common.Entities;
+
+namespace F9MES.Domain.BaseSys;
+
+/// <summary>
+/// 系统管理模块实体（BaseSys），表名前缀：BaseSys_
+/// </summary>
+
+/// <summary>菜单（树形结构，绑定路由与权限标识）</summary>
+[Table(Name = "BaseSys_Menu")]
+[Description("系统管理-菜单")]
+public class BaseSys_Menu : BaseTreeEntity
+{
+    /// <summary>菜单名称</summary>
+    [Column(DbType = "varchar(100)")]
+    [Description("菜单名称")]
+    public string Name { get; set; } = "";
+
+    /// <summary>菜单类型：0=目录 1=菜单 2=按钮</summary>
+    [Description("菜单类型：0=目录 1=菜单 2=按钮")]
+    public int MenuType { get; set; } = 1;
+
+    /// <summary>路由地址</summary>
+    [Column(DbType = "varchar(255)")]
+    [Description("路由地址")]
+    public string? RoutePath { get; set; }
+
+    /// <summary>组件路径</summary>
+    [Column(DbType = "varchar(255)")]
+    [Description("组件路径")]
+    public string? Component { get; set; }
+
+    /// <summary>图标</summary>
+    [Column(DbType = "varchar(100)")]
+    [Description("图标")]
+    public string? Icon { get; set; }
+
+    /// <summary>权限标识（如 BaseSys:User:Add）</summary>
+    [Column(DbType = "varchar(200)")]
+    [Description("权限标识")]
+    public string? Permission { get; set; }
+
+    /// <summary>是否可见（1=显示 0=隐藏）</summary>
+    [Description("是否可见（1=显示 0=隐藏）")]
+    public int IsVisible { get; set; } = 1;
+}
+
+/// <summary>组织架构（树形：公司/部门/车间/班组）</summary>
+[Table(Name = "BaseSys_Org")]
+[Index("idx_org_code", "Code")]
+[Description("系统管理-组织架构")]
+public class BaseSys_Org : BaseTreeEntity
+{
+    /// <summary>组织名称</summary>
+    [Column(DbType = "varchar(100)")]
+    [Description("组织名称")]
+    public string Name { get; set; } = "";
+
+    /// <summary>组织类型：0=公司 1=部门 2=车间 3=班组</summary>
+    [Description("组织类型：0=公司 1=部门 2=车间 3=班组")]
+    public int OrgType { get; set; } = 1;
+
+    /// <summary>组织编码</summary>
+    [Column(DbType = "varchar(50)")]
+    [Description("组织编码")]
+    public string? Code { get; set; }
+
+    /// <summary>负责人</summary>
+    [Column(DbType = "varchar(50)")]
+    [Description("负责人")]
+    public string? Manager { get; set; }
+
+    /// <summary>联系电话</summary>
+    [Column(DbType = "varchar(30)")]
+    [Description("联系电话")]
+    public string? Phone { get; set; }
+
+    /// <summary>地址</summary>
+    [Column(DbType = "varchar(255)")]
+    [Description("地址")]
+    public string? Address { get; set; }
+}
+
+/// <summary>角色</summary>
+[Table(Name = "BaseSys_Role")]
+[Index("idx_role_code", "Code")]
+[Description("系统管理-角色")]
+public class BaseSys_Role : BaseEntity
+{
+    /// <summary>角色名称</summary>
+    [Column(DbType = "varchar(100)")]
+    [Description("角色名称")]
+    public string Name { get; set; } = "";
+
+    /// <summary>角色编码</summary>
+    [Column(DbType = "varchar(50)")]
+    [Description("角色编码")]
+    public string? Code { get; set; }
+
+    /// <summary>是否系统内置（内置角色不可删除）</summary>
+    [Description("是否系统内置")]
+    public int IsSystem { get; set; } = 0;
+
+    /// <summary>是否启用</summary>
+    [Description("是否启用")]
+    public int IsEnable { get; set; } = 1;
+}
+
+/// <summary>用户（登录唯一标识为手机号，支持多端关联）</summary>
+[Table(Name = "BaseSys_User")]
+[Index("idx_user_phone_unique", "Phone", true)]
+[Index("idx_user_employee", "EmployeeId")]
+[Description("系统管理-用户")]
+public class BaseSys_User : BaseEntity
+{
+    /// <summary>登录手机号（唯一）</summary>
+    [Column(DbType = "varchar(20)")]
+    [Description("登录手机号（唯一）")]
+    public string Phone { get; set; } = "";
+
+    /// <summary>登录密码（哈希存储）</summary>
+    [Column(DbType = "varchar(255)")]
+    [Description("登录密码（哈希）")]
+    public string Password { get; set; } = "";
+
+    /// <summary>用户姓名</summary>
+    [Column(DbType = "varchar(50)")]
+    [Description("用户姓名")]
+    public string Name { get; set; } = "";
+
+    /// <summary>头像URL</summary>
+    [Column(DbType = "varchar(500)")]
+    [Description("头像URL")]
+    public string? Avatar { get; set; }
+
+    /// <summary>性别：0=未知 1=男 2=女</summary>
+    [Description("性别：0=未知 1=男 2=女")]
+    public int Gender { get; set; } = 0;
+
+    /// <summary>用户状态：1=启用 0=停用</summary>
+    [Description("用户状态：1=启用 0=停用")]
+    public int Status { get; set; } = 1;
+
+    /// <summary>是否超级管理员</summary>
+    [Description("是否超级管理员")]
+    public int IsSuperAdmin { get; set; } = 0;
+
+    /// <summary>小程序 OpenId（多端关联）</summary>
+    [Column(DbType = "varchar(100)")]
+    [Description("小程序OpenId")]
+    public string? MiniOpenId { get; set; }
+
+    /// <summary>关联职工档案ID（HRS模块）</summary>
+    [Description("关联职工档案ID")]
+    public long EmployeeId { get; set; }
+}
+
+/// <summary>角色-菜单权限绑定</summary>
+[Table(Name = "BaseSys_RoleMenu")]
+[Index("idx_rolememu_role", "RoleId")]
+[Index("idx_rolememu_menu", "MenuId")]
+[Description("系统管理-角色菜单绑定")]
+public class BaseSys_RoleMenu : BaseEntity
+{
+    /// <summary>角色ID</summary>
+    [Description("角色ID")]
+    public long RoleId { get; set; }
+
+    /// <summary>菜单ID</summary>
+    [Description("菜单ID")]
+    public long MenuId { get; set; }
+}
+
+/// <summary>用户-角色绑定</summary>
+[Table(Name = "BaseSys_UserRole")]
+[Index("idx_userrole_user", "UserId")]
+[Index("idx_userrole_role", "RoleId")]
+[Description("系统管理-用户角色绑定")]
+public class BaseSys_UserRole : BaseEntity
+{
+    /// <summary>用户ID</summary>
+    [Description("用户ID")]
+    public long UserId { get; set; }
+
+    /// <summary>角色ID</summary>
+    [Description("角色ID")]
+    public long RoleId { get; set; }
+}
+
+/// <summary>用户-组织绑定（数据权限归属）</summary>
+[Table(Name = "BaseSys_UserOrg")]
+[Index("idx_userorg_user", "UserId")]
+[Index("idx_userorg_org", "OrgId")]
+[Description("系统管理-用户组织绑定")]
+public class BaseSys_UserOrg : BaseEntity
+{
+    /// <summary>用户ID</summary>
+    [Description("用户ID")]
+    public long UserId { get; set; }
+
+    /// <summary>组织ID</summary>
+    [Description("组织ID")]
+    public long OrgId { get; set; }
+}
diff --git a/server/src/F9MES.Domain/BizBoss/BizBoss_Entities.cs b/server/src/F9MES.Domain/BizBoss/BizBoss_Entities.cs
new file mode 100644
index 0000000..0863201
--- /dev/null
+++ b/server/src/F9MES.Domain/BizBoss/BizBoss_Entities.cs
@@ -0,0 +1,94 @@
+using FreeSql.DataAnnotations;
+using F9MES.Common.Entities;
+using System.ComponentModel;
+
+namespace F9MES.Domain.BizBoss;
+
+/// <summary>
+/// 经营管家模块实体（BizBoss），表名前缀：BizBoss_
+/// </summary>
+
+/// <summary>生产成本分摊（按庄口/工段归集人工、能耗、原料成本）</summary>
+[Table(Name = "BizBoss_CostAllocate")]
+public class BizBoss_CostAllocate : BaseEntity
+{
+    /// <summary>账期ID（BaseCommon_AccountPeriod）</summary>
+    [Description("账期ID")]
+    [Column]
+    public long PeriodId { get; set; }
+
+    /// <summary>工艺庄口ID</summary>
+    [Description("工艺庄口ID")]
+    [Column]
+    public long ProcessZhuangkouId { get; set; }
+
+    /// <summary>成本类型：0=原料成本 1=人工成本 2=能耗成本 3=制造费用 4=其他</summary>
+    [Description("成本类型：0=原料 1=人工 2=能耗 3=制造费用 4=其他")]
+    [Column]
+    public int CostType { get; set; } = 0;
+
+    /// <summary>分摊金额</summary>
+    [Description("分摊金额")]
+    [Column(DbType = "decimal(14,2)")]
+    public decimal Amount { get; set; }
+
+    /// <summary>分摊依据说明</summary>
+    [Description("分摊依据说明")]
+    [Column(DbType = "varchar(500)")]
+    public string? BasisDesc { get; set; }
+}
+
+/// <summary>分庄口盈亏（经营盈亏统计结果）</summary>
+[Table(Name = "BizBoss_Profit")]
+public class BizBoss_Profit : BaseEntity
+{
+    /// <summary>账期ID</summary>
+    [Description("账期ID")]
+    [Column]
+    public long PeriodId { get; set; }
+
+    /// <summary>工艺庄口ID</summary>
+    [Description("工艺庄口ID")]
+    [Column]
+    public long ProcessZhuangkouId { get; set; }
+
+    /// <summary>原料投入成本</summary>
+    [Description("原料投入成本")]
+    [Column(DbType = "decimal(14,2)")]
+    public decimal MaterialCost { get; set; }
+
+    /// <summary>人工成本</summary>
+    [Description("人工成本")]
+    [Column(DbType = "decimal(14,2)")]
+    public decimal LaborCost { get; set; }
+
+    /// <summary>能耗成本</summary>
+    [Description("能耗成本")]
+    [Column(DbType = "decimal(14,2)")]
+    public decimal EnergyCost { get; set; }
+
+    /// <summary>制造费用</summary>
+    [Description("制造费用")]
+    [Column(DbType = "decimal(14,2)")]
+    public decimal OverheadCost { get; set; }
+
+    /// <summary>总成本</summary>
+    [Description("总成本")]
+    [Column(DbType = "decimal(14,2)")]
+    public decimal TotalCost { get; set; }
+
+    /// <summary>销售收入</summary>
+    [Description("销售收入")]
+    [Column(DbType = "decimal(14,2)")]
+    public decimal SalesRevenue { get; set; }
+
+    /// <summary>副产品收入</summary>
+    [Description("副产品收入")]
+    [Column(DbType = "decimal(14,2)")]
+    public decimal ByproductRevenue { get; set; }
+
+    /// <summary>总盈亏（正=盈 负=亏）</summary>
+    [Description("总盈亏")]
+    [Column(DbType = "decimal(14,2)")]
+    public decimal Profit { get; set; }
+}
diff --git a/server/src/F9MES.Domain/Center/Center_Entities.cs b/server/src/F9MES.Domain/Center/Center_Entities.cs
new file mode 100644
index 0000000..3cc12ce
--- /dev/null
+++ b/server/src/F9MES.Domain/Center/Center_Entities.cs
@@ -0,0 +1,214 @@
+using FreeSql.DataAnnotations;
+using F9MES.Common.Entities;
+using System.ComponentModel;
+
+namespace F9MES.Domain.Center;
+
+/// <summary>
+/// 报表中心/看板中心/接口中心公共实体，表名前缀：RepCenter_/BoardCenter_/ApiCenter_
+/// </summary>
+
+/// <summary>报表清单（报表中心）</summary>
+[Table(Name = "RepCenter_Report")]
+public class RepCenter_Report : BaseEntity
+{
+    /// <summary>报表名称</summary>
+    [Description("报表名称")]
+    [Column(DbType = "varchar(100)")]
+    public string Name { get; set; } = "";
+
+    /// <summary>报表编码</summary>
+    [Description("报表编码")]
+    [Column(DbType = "varchar(50)")]
+    public string? Code { get; set; }
+
+    /// <summary>报表分类（生产/成本/销售/原料/成品）</summary>
+    [Description("报表分类")]
+    [Column(DbType = "varchar(50)")]
+    public string? Category { get; set; }
+
+    /// <summary>报表SQL/查询配置JSON</summary>
+    [Description("报表查询配置JSON")]
+    [Column(DbType = "text")]
+    public string? QueryJson { get; set; }
+
+    /// <summary>报表类型：0=列表 1=汇总 2=图形</summary>
+    [Description("报表类型：0=列表 1=汇总 2=图形")]
+    [Column]
+    public int ReportType { get; set; } = 0;
+
+    /// <summary>是否启用</summary>
+    [Description("是否启用")]
+    [Column]
+    public int IsEnable { get; set; } = 1;
+}
+
+/// <summary>报表模板（打印设计器模板，openprint 集成）</summary>
+[Table(Name = "RepCenter_ReportDesign")]
+public class RepCenter_ReportDesign : BaseEntity
+{
+    /// <summary>模板名称</summary>
+    [Description("模板名称")]
+    [Column(DbType = "varchar(100)")]
+    public string Name { get; set; } = "";
+
+    /// <summary>报表ID（0=通用模板）</summary>
+    [Description("报表ID")]
+    [Column]
+    public long ReportId { get; set; }
+
+    /// <summary>模板类型：0=报表 1=单据 2=标签</summary>
+    [Description("模板类型：0=报表 1=单据 2=标签")]
+    [Column]
+    public int TemplateType { get; set; } = 0;
+
+    /// <summary>纸张规格</summary>
+    [Description("纸张规格")]
+    [Column(DbType = "varchar(50)")]
+    public string? PaperSize { get; set; }
+
+    /// <summary>模板内容JSON（openprint 设计器数据）</summary>
+    [Description("模板内容JSON")]
+    [Column(DbType = "longtext")]
+    public string? ContentJson { get; set; }
+
+    /// <summary>是否默认模板</summary>
+    [Description("是否默认模板")]
+    [Column]
+    public int IsDefault { get; set; } = 0;
+
+    /// <summary>是否启用</summary>
+    [Description("是否启用")]
+    [Column]
+    public int IsEnable { get; set; } = 1;
+}
+
+/// <summary>看板清单（看板中心）</summary>
+[Table(Name = "BoardCenter_Board")]
+public class BoardCenter_Board : BaseEntity
+{
+    /// <summary>看板名称</summary>
+    [Description("看板名称")]
+    [Column(DbType = "varchar(100)")]
+    public string Name { get; set; } = "";
+
+    /// <summary>看板编码</summary>
+    [Description("看板编码")]
+    [Column(DbType = "varchar(50)")]
+    public string? Code { get; set; }
+
+    /// <summary>看板类型：0=车间大屏 1=领导驾驶舱 2=经营看板</summary>
+    [Description("看板类型：0=车间大屏 1=领导驾驶舱 2=经营看板")]
+    [Column]
+    public int BoardType { get; set; } = 0;
+
+    /// <summary>布局配置JSON（组件/位置/数据源）</summary>
+    [Description("布局配置JSON")]
+    [Column(DbType = "longtext")]
+    public string? LayoutJson { get; set; }
+
+    /// <summary>是否启用</summary>
+    [Description("是否启用")]
+    [Column]
+    public int IsEnable { get; set; } = 1;
+}
+
+/// <summary>内部API管理（接口中心）</summary>
+[Table(Name = "ApiCenter_InternalApi")]
+public class ApiCenter_InternalApi : BaseEntity
+{
+    /// <summary>接口名称</summary>
+    [Description("接口名称")]
+    [Column(DbType = "varchar(100)")]
+    public string Name { get; set; } = "";
+
+    /// <summary>接口路径</summary>
+    [Description("接口路径")]
+    [Column(DbType = "varchar(255)")]
+    public string? Path { get; set; }
+
+    /// <summary>所属模块</summary>
+    [Description("所属模块")]
+    [Column(DbType = "varchar(50)")]
+    public string? Module { get; set; }
+
+    /// <summary>请求方式：GET/POST/PUT/DELETE</summary>
+    [Description("请求方式")]
+    [Column(DbType = "varchar(10)")]
+    public string Method { get; set; } = "GET";
+
+    /// <summary>接口说明</summary>
+    [Description("接口说明")]
+    [Column(DbType = "varchar(500)")]
+    public string? Description { get; set; }
+}
+
+/// <summary>外部API管理（第三方集成：天气/银行等）</summary>
+[Table(Name = "ApiCenter_ExternalApi")]
+public class ApiCenter_ExternalApi : BaseEntity
+{
+    /// <summary>API名称</summary>
+    [Description("API名称")]
+    [Column(DbType = "varchar(100)")]
+    public string Name { get; set; } = "";
+
+    /// <summary>服务商（如 Open-Meteo/银企直连）</summary>
+    [Description("服务商")]
+    [Column(DbType = "varchar(100)")]
+    public string? Provider { get; set; }
+
+    /// <summary>API地址</summary>
+    [Description("API地址")]
+    [Column(DbType = "varchar(500)")]
+    public string? BaseUrl { get; set; }
+
+    /// <summary>认证配置JSON（Key/Token等）</summary>
+    [Description("认证配置JSON")]
+    [Column(DbType = "varchar(1000)")]
+    public string? AuthJson { get; set; }
+
+    /// <summary>调用次数</summary>
+    [Description("调用次数")]
+    [Column]
+    public long CallCount { get; set; }
+
+    /// <summary>状态：0=停用 1=启用</summary>
+    [Description("状态：0=停用 1=启用")]
+    [Column]
+    public int Status { get; set; } = 1;
+}
+
+/// <summary>数据同步日志</summary>
+[Table(Name = "ApiCenter_SyncLog")]
+public class ApiCenter_SyncLog : BaseEntity
+{
+    /// <summary>同步任务名称</summary>
+    [Description("同步任务名称")]
+    [Column(DbType = "varchar(100)")]
+    public string TaskName { get; set; } = "";
+
+    /// <summary>同步类型：0=拉取 1=推送</summary>
+    [Description("同步类型：0=拉取 1=推送")]
+    [Column]
+    public int SyncType { get; set; } = 0;
+
+    /// <summary>同步结果：0=成功 1=失败</summary>
+    [Description("同步结果：0=成功 1=失败")]
+    [Column]
+    public int Result { get; set; } = 0;
+
+    /// <summary>同步条数</summary>
+    [Description("同步条数")]
+    [Column]
+    public int RowCount { get; set; }
+
+    /// <summary>错误信息</summary>
+    [Description("错误信息")]
+    [Column(DbType = "varchar(1000)")]
+    public string? Error { get; set; }
+
+    /// <summary>同步时间</summary>
+    [Description("同步时间")]
+    [Column]
+    public DateTime SyncTime { get; set; }
+}
diff --git a/server/src/F9MES.Domain/Common/Common_Entities.cs b/server/src/F9MES.Domain/Common/Common_Entities.cs
new file mode 100644
index 0000000..c9b12b3
--- /dev/null
+++ b/server/src/F9MES.Domain/Common/Common_Entities.cs
@@ -0,0 +1,320 @@
+using FreeSql.DataAnnotations;
+using F9MES.Common.Entities;
+using System.ComponentModel;
+
+namespace F9MES.Domain.Common;
+
+/// <summary>
+/// 全局公共表实体（Common），表名前缀：Common_
+/// 通用打印模板/简易工作流/附件/操作日志/消息通知
+/// </summary>
+
+/// <summary>通用打印模板（openprint 设计器数据，适用于所有单据）</summary>
+[Table(Name = "Common_PrintTemplate")]
+public class Common_PrintTemplate : BaseEntity
+{
+    /// <summary>模板名称</summary>
+    [Description("模板名称")]
+    [Column(DbType = "varchar(100)")]
+    public string Name { get; set; } = "";
+
+    /// <summary>模板编码</summary>
+    [Description("模板编码")]
+    [Column(DbType = "varchar(50)")]
+    public string? Code { get; set; }
+
+    /// <summary>适用业务类型（如 rawmaterial.instock 原料入库单）</summary>
+    [Description("适用业务类型")]
+    [Column(DbType = "varchar(100)")]
+    public string BizType { get; set; } = "";
+
+    /// <summary>打印类型：0=针式票据 1=A4单据 2=标签</summary>
+    [Description("打印类型：0=针式票据 1=A4单据 2=标签")]
+    [Column]
+    public int PrintType { get; set; } = 0;
+
+    /// <summary>纸张规格</summary>
+    [Description("纸张规格")]
+    [Column(DbType = "varchar(50)")]
+    public string? PaperSize { get; set; }
+
+    /// <summary>模板内容JSON（openprint 设计器保存的数据）</summary>
+    [Description("模板内容JSON")]
+    [Column(DbType = "longtext")]
+    public string? ContentJson { get; set; }
+
+    /// <summary>是否默认模板</summary>
+    [Description("是否默认模板")]
+    [Column]
+    public int IsDefault { get; set; } = 0;
+
+    /// <summary>是否启用</summary>
+    [Description("是否启用")]
+    [Column]
+    public int IsEnable { get; set; } = 1;
+}
+
+/// <summary>工作流定义</summary>
+[Table(Name = "Common_Workflow")]
+public class Common_Workflow : BaseEntity
+{
+    /// <summary>流程名称</summary>
+    [Description("流程名称")]
+    [Column(DbType = "varchar(100)")]
+    public string Name { get; set; } = "";
+
+    /// <summary>流程编码</summary>
+    [Description("流程编码")]
+    [Column(DbType = "varchar(50)")]
+    public string? Code { get; set; }
+
+    /// <summary>适用业务类型</summary>
+    [Description("适用业务类型")]
+    [Column(DbType = "varchar(100)")]
+    public string BizType { get; set; } = "";
+
+    /// <summary>状态：0=草稿 1=已发布 2=已停用</summary>
+    [Description("状态：0=草稿 1=已发布 2=已停用")]
+    [Column]
+    public int Status { get; set; } = 0;
+}
+
+/// <summary>工作流节点</summary>
+[Table(Name = "Common_WorkflowNode")]
+public class Common_WorkflowNode : BaseEntity
+{
+    /// <summary>流程ID</summary>
+    [Description("流程ID")]
+    [Column]
+    public long WorkflowId { get; set; }
+
+    /// <summary>节点名称</summary>
+    [Description("节点名称")]
+    [Column(DbType = "varchar(100)")]
+    public string Name { get; set; } = "";
+
+    /// <summary>节点类型：0=开始 1=审批 2=抄送 3=条件 4=结束</summary>
+    [Description("节点类型：0=开始 1=审批 2=抄送 3=条件 4=结束")]
+    [Column]
+    public int NodeType { get; set; } = 0;
+
+    /// <summary>审批人配置JSON（指定人/角色/主管）</summary>
+    [Description("审批人配置JSON")]
+    [Column(DbType = "varchar(1000)")]
+    public string? ApproverJson { get; set; }
+
+    /// <summary>下一节点ID（-1=结束）</summary>
+    [Description("下一节点ID")]
+    [Column]
+    public long NextNodeId { get; set; } = -1;
+
+    /// <summary>排序号</summary>
+    [Description("排序号")]
+    [Column]
+    public int Sort { get; set; } = 0;
+}
+
+/// <summary>工作流实例</summary>
+[Table(Name = "Common_WorkflowInstance")]
+public class Common_WorkflowInstance : BaseEntity
+{
+    /// <summary>流程ID</summary>
+    [Description("流程ID")]
+    [Column]
+    public long WorkflowId { get; set; }
+
+    /// <summary>关联业务单号</summary>
+    [Description("关联业务单号")]
+    [Column(DbType = "varchar(50)")]
+    public string? BillNo { get; set; }
+
+    /// <summary>关联业务类型</summary>
+    [Description("关联业务类型")]
+    [Column(DbType = "varchar(100)")]
+    public string BizType { get; set; } = "";
+
+    /// <summary>当前节点ID</summary>
+    [Description("当前节点ID")]
+    [Column]
+    public long CurrentNodeId { get; set; }
+
+    /// <summary>发起人ID</summary>
+    [Description("发起人ID")]
+    [Column]
+    public long StartUserId { get; set; }
+
+    /// <summary>实例状态：0=进行中 1=已通过 2=已驳回 3=已撤销</summary>
+    [Description("实例状态：0=进行中 1=已通过 2=已驳回 3=已撤销")]
+    [Column]
+    public int Status { get; set; } = 0;
+
+    /// <summary>发起时间</summary>
+    [Description("发起时间")]
+    [Column]
+    public DateTime StartTime { get; set; }
+
+    /// <summary>结束时间</summary>
+    [Description("结束时间")]
+    [Column]
+    public DateTime? EndTime { get; set; }
+}
+
+/// <summary>工作流任务</summary>
+[Table(Name = "Common_WorkflowTask")]
+public class Common_WorkflowTask : BaseEntity
+{
+    /// <summary>实例ID</summary>
+    [Description("实例ID")]
+    [Column]
+    public long InstanceId { get; set; }
+
+    /// <summary>节点ID</summary>
+    [Description("节点ID")]
+    [Column]
+    public long NodeId { get; set; }
+
+    /// <summary>处理人ID</summary>
+    [Description("处理人ID")]
+    [Column]
+    public long UserId { get; set; }
+
+    /// <summary>处理意见</summary>
+    [Description("处理意见")]
+    [Column(DbType = "varchar(500)")]
+    public string? Comment { get; set; }
+
+    /// <summary>任务状态：0=待处理 1=已同意 2=已驳回</summary>
+    [Description("任务状态：0=待处理 1=已同意 2=已驳回")]
+    [Column]
+    public int Status { get; set; } = 0;
+
+    /// <summary>处理时间</summary>
+    [Description("处理时间")]
+    [Column]
+    public DateTime? HandleTime { get; set; }
+}
+
+/// <summary>附件（OSS 存储）</summary>
+[Table(Name = "Common_Attachment")]
+public class Common_Attachment : BaseEntity
+{
+    /// <summary>附件名称</summary>
+    [Description("附件名称")]
+    [Column(DbType = "varchar(200)")]
+    public string Name { get; set; } = "";
+
+    /// <summary>存储路径（OSS key）</summary>
+    [Description("存储路径（OSS key）")]
+    [Column(DbType = "varchar(500)")]
+    public string StoragePath { get; set; } = "";
+
+    /// <summary>访问URL</summary>
+    [Description("访问URL")]
+    [Column(DbType = "varchar(500)")]
+    public string? Url { get; set; }
+
+    /// <summary>文件大小（字节）</summary>
+    [Description("文件大小（字节）")]
+    [Column]
+    public long Size { get; set; }
+
+    /// <summary>文件类型（MIME）</summary>
+    [Description("文件类型")]
+    [Column(DbType = "varchar(50)")]
+    public string? ContentType { get; set; }
+
+    /// <summary>关联业务类型</summary>
+    [Description("关联业务类型")]
+    [Column(DbType = "varchar(100)")]
+    public string? BizType { get; set; }
+
+    /// <summary>关联业务ID</summary>
+    [Description("关联业务ID")]
+    [Column]
+    public long BizId { get; set; }
+
+    /// <summary>上传人ID</summary>
+    [Description("上传人ID")]
+    [Column]
+    public long UploaderId { get; set; }
+}
+
+/// <summary>操作日志</summary>
+[Table(Name = "Common_Log")]
+public class Common_Log : BaseEntity
+{
+    /// <summary>操作人ID</summary>
+    [Description("操作人ID")]
+    [Column]
+    public long UserId { get; set; }
+
+    /// <summary>操作人姓名</summary>
+    [Description("操作人姓名")]
+    [Column(DbType = "varchar(50)")]
+    public string? UserName { get; set; }
+
+    /// <summary>操作模块</summary>
+    [Description("操作模块")]
+    [Column(DbType = "varchar(50)")]
+    public string? Module { get; set; }
+
+    /// <summary>操作动作（增删改查/登录等）</summary>
+    [Description("操作动作")]
+    [Column(DbType = "varchar(50)")]
+    public string? Action { get; set; }
+
+    /// <summary>请求路径</summary>
+    [Description("请求路径")]
+    [Column(DbType = "varchar(500)")]
+    public string? Path { get; set; }
+
+    /// <summary>请求参数</summary>
+    [Description("请求参数")]
+    [Column(DbType = "text")]
+    public string? Params { get; set; }
+
+    /// <summary>IP地址</summary>
+    [Description("IP地址")]
+    [Column(DbType = "varchar(50)")]
+    public string? Ip { get; set; }
+
+    /// <summary>操作时间</summary>
+    [Description("操作时间")]
+    [Column]
+    public DateTime OpTime { get; set; } = DateTime.Now;
+}
+
+/// <summary>消息通知</summary>
+[Table(Name = "Common_Message")]
+public class Common_Message : BaseEntity
+{
+    /// <summary>接收人ID</summary>
+    [Description("接收人ID")]
+    [Column]
+    public long UserId { get; set; }
+
+    /// <summary>消息标题</summary>
+    [Description("消息标题")]
+    [Column(DbType = "varchar(200)")]
+    public string Title { get; set; } = "";
+
+    /// <summary>消息内容</summary>
+    [Description("消息内容")]
+    [Column(DbType = "text")]
+    public string? Content { get; set; }
+
+    /// <summary>消息类型：0=系统通知 1=业务提醒 2=审批通知 3=预警</summary>
+    [Description("消息类型：0=系统 1=业务 2=审批 3=预警")]
+    [Column]
+    public int MsgType { get; set; } = 0;
+
+    /// <summary>是否已读</summary>
+    [Description("是否已读")]
+    [Column]
+    public int IsRead { get; set; } = 0;
+
+    /// <summary>发送时间</summary>
+    [Description("发送时间")]
+    [Column]
+    public DateTime SendTime { get; set; } = DateTime.Now;
+}
diff --git a/server/src/F9MES.Domain/Enms/Enms_Entities.cs b/server/src/F9MES.Domain/Enms/Enms_Entities.cs
new file mode 100644
index 0000000..0dd345c
--- /dev/null
+++ b/server/src/F9MES.Domain/Enms/Enms_Entities.cs
@@ -0,0 +1,165 @@
+using FreeSql.DataAnnotations;
+using F9MES.Common.Entities;
+using System.ComponentModel;
+
+namespace F9MES.Domain.Enms;
+
+/// <summary>
+/// 能耗管理模块实体（Enms），表名前缀：Enms_
+/// 水电气计量：总管→车间→班组→庄口/工序逐级分摊
+/// </summary>
+
+/// <summary>计量表档案</summary>
+[Table(Name = "Enms_Meter")]
+public class Enms_Meter : BaseTreeEntity
+{
+    /// <summary>表编号</summary>
+    [Description("表编号")]
+    [Column(DbType = "varchar(50)")]
+    public string MeterNo { get; set; } = "";
+
+    /// <summary>表名称</summary>
+    [Description("表名称")]
+    [Column(DbType = "varchar(100)")]
+    public string Name { get; set; } = "";
+
+    /// <summary>能源类型：0=电 1=水 2=蒸汽 3=天然气</summary>
+    [Description("能源类型：0=电 1=水 2=蒸汽 3=天然气")]
+    [Column]
+    public int EnergyType { get; set; } = 0;
+
+    /// <summary>归属组织ID（车间/班组）</summary>
+    [Description("归属组织ID")]
+    [Column]
+    public long OrgId { get; set; }
+
+    /// <summary>当前读数</summary>
+    [Description("当前读数")]
+    [Column(DbType = "decimal(14,2)")]
+    public decimal CurrentReading { get; set; }
+
+    /// <summary>是否停用</summary>
+    [Description("是否停用")]
+    [Column]
+    public int IsDisable { get; set; } = 0;
+}
+
+/// <summary>抄表读数</summary>
+[Table(Name = "Enms_Reading")]
+public class Enms_Reading : BaseEntity
+{
+    /// <summary>计量表ID</summary>
+    [Description("计量表ID")]
+    [Column]
+    public long MeterId { get; set; }
+
+    /// <summary>抄表日期</summary>
+    [Description("抄表日期")]
+    [Column]
+    public DateTime ReadDate { get; set; }
+
+    /// <summary>本次读数</summary>
+    [Description("本次读数")]
+    [Column(DbType = "decimal(14,2)")]
+    public decimal Reading { get; set; }
+
+    /// <summary>上次读数</summary>
+    [Description("上次读数")]
+    [Column(DbType = "decimal(14,2)")]
+    public decimal LastReading { get; set; }
+
+    /// <summary>用量</summary>
+    [Description("用量")]
+    [Column(DbType = "decimal(14,2)")]
+    public decimal Usage { get; set; }
+
+    /// <summary>抄表人</summary>
+    [Description("抄表人")]
+    [Column(DbType = "varchar(50)")]
+    public string? Reader { get; set; }
+
+    /// <summary>抄表方式：0=手工 1=自动采集</summary>
+    [Description("抄表方式：0=手工 1=自动采集")]
+    [Column]
+    public int ReadType { get; set; } = 0;
+}
+
+/// <summary>分摊规则</summary>
+[Table(Name = "Enms_AllocateRule")]
+public class Enms_AllocateRule : BaseEntity
+{
+    /// <summary>规则名称</summary>
+    [Description("规则名称")]
+    [Column(DbType = "varchar(100)")]
+    public string Name { get; set; } = "";
+
+    /// <summary>能源类型：0=电 1=水 2=蒸汽 3=天然气</summary>
+    [Description("能源类型：0=电 1=水 2=蒸汽 3=天然气")]
+    [Column]
+    public int EnergyType { get; set; } = 0;
+
+    /// <summary>来源表ID（主管/车间级）</summary>
+    [Description("来源表ID")]
+    [Column]
+    public long SourceMeterId { get; set; }
+
+    /// <summary>分摊依据：0=按产量 1=按人数 2=按工时 3=固定比例 4=按表读数</summary>
+    [Description("分摊依据：0=产量 1=人数 2=工时 3=固定比例 4=表读数")]
+    [Column]
+    public int AllocateBasis { get; set; } = 0;
+
+    /// <summary>目标组织/庄口配置JSON</summary>
+    [Description("目标配置JSON")]
+    [Column(DbType = "text")]
+    public string? TargetJson { get; set; }
+
+    /// <summary>是否启用</summary>
+    [Description("是否启用")]
+    [Column]
+    public int IsEnable { get; set; } = 1;
+}
+
+/// <summary>分摊结果</summary>
+[Table(Name = "Enms_AllocateResult")]
+public class Enms_AllocateResult : BaseEntity
+{
+    /// <summary>账期ID</summary>
+    [Description("账期ID")]
+    [Column]
+    public long PeriodId { get; set; }
+
+    /// <summary>能源类型：0=电 1=水 2=蒸汽 3=天然气</summary>
+    [Description("能源类型：0=电 1=水 2=蒸汽 3=天然气")]
+    [Column]
+    public int EnergyType { get; set; } = 0;
+
+    /// <summary>分摊对象类型：0=组织 1=庄口 2=工序</summary>
+    [Description("分摊对象类型：0=组织 1=庄口 2=工序")]
+    [Column]
+    public int TargetType { get; set; } = 0;
+
+    /// <summary>分摊对象ID</summary>
+    [Description("分摊对象ID")]
+    [Column]
+    public long TargetId { get; set; }
+
+    /// <summary>用量</summary>
+    [Description("用量")]
+    [Column(DbType = "decimal(14,2)")]
+    public decimal Usage { get; set; }
+
+    /// <summary>单价</summary>
+    [Description("单价")]
+    [Column(DbType = "decimal(10,4)")]
+    public decimal UnitPrice { get; set; }
+
+    /// <summary>金额</summary>
+    [Description("金额")]
+    [Column(DbType = "decimal(14,2)")]
+    public decimal Amount { get; set; }
+
+    /// <summary>分摊规则ID</summary>
+    [Description("分摊规则ID")]
+    [Column]
+    public long RuleId { get; set; }
+}
diff --git a/server/src/F9MES.Domain/F9MES.Domain.csproj b/server/src/F9MES.Domain/F9MES.Domain.csproj
new file mode 100644
index 0000000..dcf3c30
--- /dev/null
+++ b/server/src/F9MES.Domain/F9MES.Domain.csproj
@@ -0,0 +1,13 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <ItemGroup>
+    <ProjectReference Include="..\F9MES.Common\F9MES.Common.csproj" />
+  </ItemGroup>
+
+  <PropertyGroup>
+    <TargetFramework>net10.0</TargetFramework>
+    <ImplicitUsings>enable</ImplicitUsings>
+    <Nullable>enable</Nullable>
+  </PropertyGroup>
+
+</Project>
diff --git a/server/src/F9MES.Domain/Fims/Fims_Entities.cs b/server/src/F9MES.Domain/Fims/Fims_Entities.cs
new file mode 100644
index 0000000..d4e1c34
--- /dev/null
+++ b/server/src/F9MES.Domain/Fims/Fims_Entities.cs
@@ -0,0 +1,344 @@
+using FreeSql.DataAnnotations;
+using F9MES.Common.Entities;
+using System.ComponentModel;
+
+namespace F9MES.Domain.Fims;
+
+/// <summary>
+/// 成品管理模块实体（Fims），表名前缀：Fims_
+/// </summary>
+
+/// <summary>成品批次档案（同一庄口/规格/等级成批归档）</summary>
+[Table(Name = "Fims_Batch")]
+public class Fims_Batch : BaseEntity
+{
+    /// <summary>批次编号（唯一）</summary>
+    [Description("批次编号（唯一）")]
+    [Column(DbType = "varchar(50)")]
+    public string BatchNo { get; set; } = "";
+
+    /// <summary>工艺庄口ID</summary>
+    [Description("工艺庄口ID")]
+    [Column]
+    public long ProcessZhuangkouId { get; set; }
+
+    /// <summary>规格ID（BaseCommon_SilkSpec）</summary>
+    [Description("规格ID")]
+    [Column]
+    public long SpecId { get; set; }
+
+    /// <summary>等级</summary>
+    [Description("等级")]
+    [Column(DbType = "varchar(20)")]
+    public string Grade { get; set; } = "";
+
+    /// <summary>总重量（kg）</summary>
+    [Description("总重量（kg）")]
+    [Column(DbType = "decimal(14,2)")]
+    public decimal TotalWeight { get; set; }
+
+    /// <summary>包件数量</summary>
+    [Description("包件数量")]
+    [Column]
+    public int PackageCount { get; set; }
+
+    /// <summary>来源入库单ID（Fims_InStock），0=手工建档</summary>
+    [Description("来源入库单ID")]
+    [Column]
+    public long InStockId { get; set; }
+
+    /// <summary>建批日期</summary>
+    [Description("建批日期")]
+    [Column]
+    public DateTime CreateDate { get; set; }
+
+    /// <summary>状态：0=在库 1=部分售出 2=已售完 3=已报损</summary>
+    [Description("状态：0=在库 1=部分售出 2=已售完 3=已报损")]
+    [Column]
+    public int Status { get; set; } = 0;
+}
+
+/// <summary>成品包件（最小库存单位）</summary>
+[Table(Name = "Fims_Package")]
+public class Fims_Package : BaseEntity
+{
+    /// <summary>包件编号（唯一）</summary>
+    [Description("包件编号（唯一）")]
+    [Column(DbType = "varchar(50)")]
+    public string PackageNo { get; set; } = "";
+
+    /// <summary>批次ID</summary>
+    [Description("批次ID")]
+    [Column]
+    public long BatchId { get; set; }
+
+    /// <summary>工艺庄口ID</summary>
+    [Description("工艺庄口ID")]
+    [Column]
+    public long ProcessZhuangkouId { get; set; }
+
+    /// <summary>规格ID</summary>
+    [Description("规格ID")]
+    [Column]
+    public long SpecId { get; set; }
+
+    /// <summary>等级</summary>
+    [Description("等级")]
+    [Column(DbType = "varchar(20)")]
+    public string Grade { get; set; } = "";
+
+    /// <summary>毛重（kg）</summary>
+    [Description("毛重（kg）")]
+    [Column(DbType = "decimal(10,2)")]
+    public decimal GrossWeight { get; set; }
+
+    /// <summary>皮重（kg）</summary>
+    [Description("皮重（kg）")]
+    [Column(DbType = "decimal(10,2)")]
+    public decimal TareWeight { get; set; }
+
+    /// <summary>净重（kg）</summary>
+    [Description("净重（kg）")]
+    [Column(DbType = "decimal(10,2)")]
+    public decimal NetWeight { get; set; }
+
+    /// <summary>包件状态：0=在库 1=已出库 2=报损</summary>
+    [Description("包件状态：0=在库 1=已出库 2=报损")]
+    [Column]
+    public int Status { get; set; } = 0;
+
+    /// <summary>入库日期</summary>
+    [Description("入库日期")]
+    [Column]
+    public DateTime InDate { get; set; }
+
+    /// <summary>出库日期</summary>
+    [Description("出库日期")]
+    [Column]
+    public DateTime? OutDate { get; set; }
+}
+
+/// <summary>成品入库单（定级后入库）</summary>
+[Table(Name = "Fims_InStock")]
+public class Fims_InStock : BaseEntity
+{
+    /// <summary>入库单号</summary>
+    [Description("入库单号")]
+    [Column(DbType = "varchar(50)")]
+    public string BillNo { get; set; } = "";
+
+    /// <summary>工艺庄口ID</summary>
+    [Description("工艺庄口ID")]
+    [Column]
+    public long ProcessZhuangkouId { get; set; }
+
+    /// <summary>规格ID</summary>
+    [Description("规格ID")]
+    [Column]
+    public long SpecId { get; set; }
+
+    /// <summary>等级</summary>
+    [Description("等级")]
+    [Column(DbType = "varchar(20)")]
+    public string Grade { get; set; } = "";
+
+    /// <summary>入库净重（kg）</summary>
+    [Description("入库净重（kg）")]
+    [Column(DbType = "decimal(14,2)")]
+    public decimal NetWeight { get; set; }
+
+    /// <summary>包件数量</summary>
+    [Description("包件数量")]
+    [Column]
+    public int PackageCount { get; set; }
+
+    /// <summary>入库日期</summary>
+    [Description("入库日期")]
+    [Column]
+    public DateTime InDate { get; set; }
+
+    /// <summary>关联厂检定级ID（Lims_GradeResult）</summary>
+    [Description("关联厂检定级ID")]
+    [Column]
+    public long GradeResultId { get; set; }
+
+    /// <summary>仓库位置</summary>
+    [Description("仓库位置")]
+    [Column(DbType = "varchar(100)")]
+    public string? Location { get; set; }
+
+    /// <summary>单据状态：0=草稿 1=已入库 2=作废</summary>
+    [Description("单据状态：0=草稿 1=已入库 2=作废")]
+    [Column]
+    public int Status { get; set; } = 0;
+}
+
+/// <summary>成品出库单（销售/调拨/赠样）</summary>
+[Table(Name = "Fims_OutStock")]
+public class Fims_OutStock : BaseEntity
+{
+    /// <summary>出库单号</summary>
+    [Description("出库单号")]
+    [Column(DbType = "varchar(50)")]
+    public string BillNo { get; set; } = "";
+
+    /// <summary>客户ID（BaseCommon_Partner）</summary>
+    [Description("客户ID")]
+    [Column]
+    public long CustomerId { get; set; }
+
+    /// <summary>关联销售合同ID（Sams_Contract）</summary>
+    [Description("关联销售合同ID")]
+    [Column]
+    public long ContractId { get; set; }
+
+    /// <summary>出库类型：0=销售 1=调拨 2=赠样 3=报损</summary>
+    [Description("出库类型：0=销售 1=调拨 2=赠样 3=报损")]
+    [Column]
+    public int OutType { get; set; } = 0;
+
+    /// <summary>出库净重（kg）</summary>
+    [Description("出库净重（kg）")]
+    [Column(DbType = "decimal(14,2)")]
+    public decimal NetWeight { get; set; }
+
+    /// <summary>包件数量</summary>
+    [Description("包件数量")]
+    [Column]
+    public int PackageCount { get; set; }
+
+    /// <summary>出库日期</summary>
+    [Description("出库日期")]
+    [Column]
+    public DateTime OutDate { get; set; }
+
+    /// <summary>承运信息</summary>
+    [Description("承运信息")]
+    [Column(DbType = "varchar(200)")]
+    public string? Carrier { get; set; }
+
+    /// <summary>单据状态：0=草稿 1=已出库 2=作废</summary>
+    [Description("单据状态：0=草稿 1=已出库 2=作废")]
+    [Column]
+    public int Status { get; set; } = 0;
+}
+
+/// <summary>成品出库明细（按批次/包件）</summary>
+[Table(Name = "Fims_OutStockItem")]
+public class Fims_OutStockItem : BaseEntity
+{
+    /// <summary>出库单ID</summary>
+    [Description("出库单ID")]
+    [Column]
+    public long OutStockId { get; set; }
+
+    /// <summary>批次ID</summary>
+    [Description("批次ID")]
+    [Column]
+    public long BatchId { get; set; }
+
+    /// <summary>包件ID</summary>
+    [Description("包件ID")]
+    [Column]
+    public long PackageId { get; set; }
+
+    /// <summary>净重（kg）</summary>
+    [Description("净重（kg）")]
+    [Column(DbType = "decimal(10,2)")]
+    public decimal NetWeight { get; set; }
+
+    /// <summary>单价（元/kg）</summary>
+    [Description("单价（元/kg）")]
+    [Column(DbType = "decimal(12,4)")]
+    public decimal UnitPrice { get; set; }
+
+    /// <summary>金额</summary>
+    [Description("金额")]
+    [Column(DbType = "decimal(14,2)")]
+    public decimal Amount { get; set; }
+}
+
+/// <summary>成品库存（按庄口/规格/等级/仓库）</summary>
+[Table(Name = "Fims_Stock")]
+public class Fims_Stock : BaseEntity
+{
+    /// <summary>工艺庄口ID</summary>
+    [Description("工艺庄口ID")]
+    [Column]
+    public long ProcessZhuangkouId { get; set; }
+
+    /// <summary>规格ID</summary>
+    [Description("规格ID")]
+    [Column]
+    public long SpecId { get; set; }
+
+    /// <summary>等级</summary>
+    [Description("等级")]
+    [Column(DbType = "varchar(20)")]
+    public string Grade { get; set; } = "";
+
+    /// <summary>仓库位置</summary>
+    [Description("仓库位置")]
+    [Column(DbType = "varchar(100)")]
+    public string? Location { get; set; }
+
+    /// <summary>库存净重（kg）</summary>
+    [Description("库存净重（kg）")]
+    [Column(DbType = "decimal(14,2)")]
+    public decimal StockWeight { get; set; }
+
+    /// <summary>包件数量</summary>
+    [Description("包件数量")]
+    [Column]
+    public int PackageCount { get; set; }
+
+    /// <summary>预警下限（kg）</summary>
+    [Description("预警下限（kg）")]
+    [Column(DbType = "decimal(14,2)")]
+    public decimal WarnMin { get; set; }
+}
+
+/// <summary>成品状态变更留痕（库存变动/包件流转）</summary>
+[Table(Name = "Fims_StatusChange")]
+public class Fims_StatusChange : BaseEntity
+{
+    /// <summary>对象类型：0=批次 1=包件 2=库存</summary>
+    [Description("对象类型：0=批次 1=包件 2=库存")]
+    [Column]
+    public int ObjectType { get; set; } = 0;
+
+    /// <summary>对象ID</summary>
+    [Description("对象ID")]
+    [Column]
+    public long ObjectId { get; set; }
+
+    /// <summary>原状态</summary>
+    [Description("原状态")]
+    [Column]
+    public int FromStatus { get; set; }
+
+    /// <summary>新状态</summary>
+    [Description("新状态")]
+    [Column]
+    public int ToStatus { get; set; }
+
+    /// <summary>变更类型：0=入库 1=出库 2=报损 3=调整</summary>
+    [Description("变更类型：0=入库 1=出库 2=报损 3=调整")]
+    [Column]
+    public int ChangeType { get; set; } = 0;
+
+    /// <summary>关联单据号</summary>
+    [Description("关联单据号")]
+    [Column(DbType = "varchar(50)")]
+    public string? BillNo { get; set; }
+
+    /// <summary>变更说明</summary>
+    [Description("变更说明")]
+    [Column(DbType = "varchar(500)")]
+    public string? Description { get; set; }
+
+    /// <summary>变更时间</summary>
+    [Description("变更时间")]
+    [Column]
+    public DateTime ChangeTime { get; set; }
+}
diff --git a/server/src/F9MES.Domain/FlexPay/FlexPay_Entities.cs b/server/src/F9MES.Domain/FlexPay/FlexPay_Entities.cs
new file mode 100644
index 0000000..1edda2c
--- /dev/null
+++ b/server/src/F9MES.Domain/FlexPay/FlexPay_Entities.cs
@@ -0,0 +1,254 @@
+using FreeSql.DataAnnotations;
+using F9MES.Common.Entities;
+using System.ComponentModel;
+
+namespace F9MES.Domain.FlexPay;
+
+/// <summary>
+/// 薪资智算模块实体（FlexPay），表名前缀：FlexPay_
+/// </summary>
+
+/// <summary>薪资配置（庄口/部门/工种/规格/账期/职工维度指标配置）</summary>
+[Table(Name = "FlexPay_Config")]
+public class FlexPay_Config : BaseEntity
+{
+    /// <summary>配置名称</summary>
+    [Description("配置名称")]
+    [Column(DbType = "varchar(100)")]
+    public string Name { get; set; } = "";
+
+    /// <summary>配置维度：0=庄口 1=部门 2=工种 3=规格 4=账期 5=职工</summary>
+    [Description("配置维度：0=庄口 1=部门 2=工种 3=规格 4=账期 5=职工")]
+    [Column]
+    public int Dimension { get; set; } = 0;
+
+    /// <summary>维度值ID</summary>
+    [Description("维度值ID")]
+    [Column]
+    public long DimensionId { get; set; }
+
+    /// <summary>指标编码（如 piece_price 计件单价）</summary>
+    [Description("指标编码")]
+    [Column(DbType = "varchar(50)")]
+    public string? IndexCode { get; set; }
+
+    /// <summary>指标值</summary>
+    [Description("指标值")]
+    [Column(DbType = "decimal(12,4)")]
+    public decimal IndexValue { get; set; }
+
+    /// <summary>是否启用</summary>
+    [Description("是否启用")]
+    [Column]
+    public int IsEnable { get; set; } = 1;
+}
+
+/// <summary>薪资方案</summary>
+[Table(Name = "FlexPay_Scheme")]
+public class FlexPay_Scheme : BaseEntity
+{
+    /// <summary>方案名称</summary>
+    [Description("方案名称")]
+    [Column(DbType = "varchar(100)")]
+    public string Name { get; set; } = "";
+
+    /// <summary>方案编码</summary>
+    [Description("方案编码")]
+    [Column(DbType = "varchar(50)")]
+    public string? Code { get; set; }
+
+    /// <summary>版本号</summary>
+    [Description("版本号")]
+    [Column(DbType = "varchar(30)")]
+    public string Version { get; set; } = "1.0";
+
+    /// <summary>套用范围（组织ID，0=全部）</summary>
+    [Description("套用范围（组织ID，0=全部）")]
+    [Column]
+    public long ScopeOrgId { get; set; }
+
+    /// <summary>状态：0=草稿 1=启用 2=停用</summary>
+    [Description("状态：0=草稿 1=启用 2=停用")]
+    [Column]
+    public int Status { get; set; } = 0;
+
+    /// <summary>方案内容JSON（薪资结构/考核项/公式）</summary>
+    [Description("方案内容JSON")]
+    [Column(DbType = "text")]
+    public string? ContentJson { get; set; }
+}
+
+/// <summary>奖扣管理（临时性人工增减项）</summary>
+[Table(Name = "FlexPay_Reward")]
+public class FlexPay_Reward : BaseEntity
+{
+    /// <summary>职工ID</summary>
+    [Description("职工ID")]
+    [Column]
+    public long EmployeeId { get; set; }
+
+    /// <summary>奖扣类型：0=奖励 1=扣款</summary>
+    [Description("奖扣类型：0=奖励 1=扣款")]
+    [Column]
+    public int RewardType { get; set; } = 0;
+
+    /// <summary>奖扣项目</summary>
+    [Description("奖扣项目")]
+    [Column(DbType = "varchar(100)")]
+    public string ItemName { get; set; } = "";
+
+    /// <summary>金额</summary>
+    [Description("金额")]
+    [Column(DbType = "decimal(12,2)")]
+    public decimal Amount { get; set; }
+
+    /// <summary>奖扣原因</summary>
+    [Description("奖扣原因")]
+    [Column(DbType = "varchar(500)")]
+    public string? Reason { get; set; }
+
+    /// <summary>责任人</summary>
+    [Description("责任人")]
+    [Column(DbType = "varchar(50)")]
+    public string? Responsible { get; set; }
+
+    /// <summary>关联账期ID</summary>
+    [Description("关联账期ID")]
+    [Column]
+    public long PeriodId { get; set; }
+}
+
+/// <summary>计件成绩（按工种/庄口/规格/出勤计算依据）</summary>
+[Table(Name = "FlexPay_PieceResult")]
+public class FlexPay_PieceResult : BaseEntity
+{
+    /// <summary>职工ID</summary>
+    [Description("职工ID")]
+    [Column]
+    public long EmployeeId { get; set; }
+
+    /// <summary>关联工艺庄口ID</summary>
+    [Description("关联工艺庄口ID")]
+    [Column]
+    public long ProcessZhuangkouId { get; set; }
+
+    /// <summary>关联规格ID（BaseCommon_SilkSpec）</summary>
+    [Description("关联规格ID")]
+    [Column]
+    public long SpecId { get; set; }
+
+    /// <summary>出勤天数</summary>
+    [Description("出勤天数")]
+    [Column(DbType = "decimal(6,1)")]
+    public decimal WorkDays { get; set; }
+
+    /// <summary>计件数量</summary>
+    [Description("计件数量")]
+    [Column(DbType = "decimal(12,2)")]
+    public decimal PieceCount { get; set; }
+
+    /// <summary>计件成绩（金额）</summary>
+    [Description("计件成绩（金额）")]
+    [Column(DbType = "decimal(12,2)")]
+    public decimal PieceAmount { get; set; }
+
+    /// <summary>关联账期ID</summary>
+    [Description("关联账期ID")]
+    [Column]
+    public long PeriodId { get; set; }
+}
+
+/// <summary>薪资计算结果（应发/实发）</summary>
+[Table(Name = "FlexPay_Salary")]
+public class FlexPay_Salary : BaseEntity
+{
+    /// <summary>职工ID</summary>
+    [Description("职工ID")]
+    [Column]
+    public long EmployeeId { get; set; }
+
+    /// <summary>关联账期ID</summary>
+    [Description("关联账期ID")]
+    [Column]
+    public long PeriodId { get; set; }
+
+    /// <summary>薪资方案ID</summary>
+    [Description("薪资方案ID")]
+    [Column]
+    public long SchemeId { get; set; }
+
+    /// <summary>基本工资</summary>
+    [Description("基本工资")]
+    [Column(DbType = "decimal(12,2)")]
+    public decimal BaseSalary { get; set; }
+
+    /// <summary>计件工资</summary>
+    [Description("计件工资")]
+    [Column(DbType = "decimal(12,2)")]
+    public decimal PieceSalary { get; set; }
+
+    /// <summary>奖金</summary>
+    [Description("奖金")]
+    [Column(DbType = "decimal(12,2)")]
+    public decimal Bonus { get; set; }
+
+    /// <summary>扣款</summary>
+    [Description("扣款")]
+    [Column(DbType = "decimal(12,2)")]
+    public decimal Deduction { get; set; }
+
+    /// <summary>应发工资</summary>
+    [Description("应发工资")]
+    [Column(DbType = "decimal(12,2)")]
+    public decimal GrossSalary { get; set; }
+
+    /// <summary>实发工资</summary>
+    [Description("实发工资")]
+    [Column(DbType = "decimal(12,2)")]
+    public decimal NetSalary { get; set; }
+
+    /// <summary>计算状态：0=草稿 1=已计算 2=已确认 3=已发放</summary>
+    [Description("计算状态：0=草稿 1=已计算 2=已确认 3=已发放")]
+    [Column]
+    public int Status { get; set; } = 0;
+}
+
+/// <summary>薪资发放记录（银企直连）</summary>
+[Table(Name = "FlexPay_Payroll")]
+public class FlexPay_Payroll : BaseEntity
+{
+    /// <summary>发放批次号</summary>
+    [Description("发放批次号")]
+    [Column(DbType = "varchar(50)")]
+    public string BatchNo { get; set; } = "";
+
+    /// <summary>关联账期ID</summary>
+    [Description("关联账期ID")]
+    [Column]
+    public long PeriodId { get; set; }
+
+    /// <summary>发放总金额</summary>
+    [Description("发放总金额")]
+    [Column(DbType = "decimal(14,2)")]
+    public decimal TotalAmount { get; set; }
+
+    /// <summary>发放人数</summary>
+    [Description("发放人数")]
+    [Column]
+    public int EmpCount { get; set; }
+
+    /// <summary>银行文件路径</summary>
+    [Description("银行文件路径")]
+    [Column(DbType = "varchar(500)")]
+    public string? BankFilePath { get; set; }
+
+    /// <summary>发放状态：0=待发放 1=发放中 2=成功 3=失败</summary>
+    [Description("发放状态：0=待发放 1=发放中 2=成功 3=失败")]
+    [Column]
+    public int Status { get; set; } = 0;
+
+    /// <summary>发放时间</summary>
+    [Description("发放时间")]
+    [Column]
+    public DateTime? PayTime { get; set; }
+}
diff --git a/server/src/F9MES.Domain/HRS/HRS_Entities.cs b/server/src/F9MES.Domain/HRS/HRS_Entities.cs
new file mode 100644
index 0000000..aeaea41
--- /dev/null
+++ b/server/src/F9MES.Domain/HRS/HRS_Entities.cs
@@ -0,0 +1,279 @@
+using FreeSql.DataAnnotations;
+using F9MES.Common.Entities;
+using System.ComponentModel;
+
+namespace F9MES.Domain.HRS;
+
+/// <summary>
+/// 人力资源模块实体（HRS），表名前缀：HRS_
+/// </summary>
+
+/// <summary>职工档案</summary>
+[Table(Name = "HRS_Employee")]
+public class HRS_Employee : BaseEntity
+{
+    /// <summary>职工编码（唯一）</summary>
+    [Description("职工编码（唯一）")]
+    [Column(DbType = "varchar(50)")]
+    public string Code { get; set; } = "";
+
+    /// <summary>职工姓名</summary>
+    [Description("职工姓名")]
+    [Column(DbType = "varchar(50)")]
+    public string Name { get; set; } = "";
+
+    /// <summary>身份证号</summary>
+    [Description("身份证号")]
+    [Column(DbType = "varchar(30)")]
+    public string? IdCard { get; set; }
+
+    /// <summary>手机号</summary>
+    [Description("手机号")]
+    [Column(DbType = "varchar(20)")]
+    public string? Phone { get; set; }
+
+    /// <summary>性别：0=未知 1=男 2=女</summary>
+    [Description("性别：0=未知 1=男 2=女")]
+    [Column]
+    public int Gender { get; set; } = 0;
+
+    /// <summary>所属组织ID（BaseSys_Org）</summary>
+    [Description("所属组织ID")]
+    [Column]
+    public long OrgId { get; set; }
+
+    /// <summary>工种ID（BaseCommon_WorkType）</summary>
+    [Description("工种ID")]
+    [Column]
+    public long WorkTypeId { get; set; }
+
+    /// <summary>岗位</summary>
+    [Description("岗位")]
+    [Column(DbType = "varchar(50)")]
+    public string? Position { get; set; }
+
+    /// <summary>入职日期</summary>
+    [Description("入职日期")]
+    [Column]
+    public DateTime? HireDate { get; set; }
+
+    /// <summary>离职日期</summary>
+    [Description("离职日期")]
+    [Column]
+    public DateTime? LeaveDate { get; set; }
+
+    /// <summary>职工状态：0=在职 1=离职 2=休假 3=调岗</summary>
+    [Description("职工状态：0=在职 1=离职 2=休假 3=调岗")]
+    [Column]
+    public int Status { get; set; } = 0;
+
+    /// <summary>银行卡号（薪资发放用）</summary>
+    [Description("银行卡号")]
+    [Column(DbType = "varchar(50)")]
+    public string? BankCardNo { get; set; }
+
+    /// <summary>开户行</summary>
+    [Description("开户行")]
+    [Column(DbType = "varchar(100)")]
+    public string? BankName { get; set; }
+}
+
+/// <summary>职工异动记录（入职/离职/调岗）</summary>
+[Table(Name = "HRS_EmployeeChange")]
+public class HRS_EmployeeChange : BaseEntity
+{
+    /// <summary>职工ID</summary>
+    [Description("职工ID")]
+    [Column]
+    public long EmployeeId { get; set; }
+
+    /// <summary>异动类型：0=入职 1=离职 2=调岗 3=休假</summary>
+    [Description("异动类型：0=入职 1=离职 2=调岗 3=休假")]
+    [Column]
+    public int ChangeType { get; set; } = 0;
+
+    /// <summary>异动日期</summary>
+    [Description("异动日期")]
+    [Column]
+    public DateTime ChangeDate { get; set; }
+
+    /// <summary>原组织ID</summary>
+    [Description("原组织ID")]
+    [Column]
+    public long FromOrgId { get; set; }
+
+    /// <summary>新组织ID</summary>
+    [Description("新组织ID")]
+    [Column]
+    public long ToOrgId { get; set; }
+
+    /// <summary>异动原因</summary>
+    [Description("异动原因")]
+    [Column(DbType = "varchar(500)")]
+    public string? Reason { get; set; }
+}
+
+/// <summary>出勤管理（按账期/月份汇总）</summary>
+[Table(Name = "HRS_Attendance")]
+public class HRS_Attendance : BaseEntity
+{
+    /// <summary>职工ID</summary>
+    [Description("职工ID")]
+    [Column]
+    public long EmployeeId { get; set; }
+
+    /// <summary>出勤日期</summary>
+    [Description("出勤日期")]
+    [Column]
+    public DateTime AttDate { get; set; }
+
+    /// <summary>出勤类型：0=正常出勤 1=加班 2=请假 3=缺勤 4=出差</summary>
+    [Description("出勤类型：0=正常 1=加班 2=请假 3=缺勤 4=出差")]
+    [Column]
+    public int AttType { get; set; } = 0;
+
+    /// <summary>出勤时长（小时）</summary>
+    [Description("出勤时长（小时）")]
+    [Column(DbType = "decimal(10,2)")]
+    public decimal Hours { get; set; }
+
+    /// <summary>录入方式：0=手工录入 1=班组长录入 2=小程序打卡</summary>
+    [Description("录入方式：0=手工 1=班组长 2=小程序打卡")]
+    [Column]
+    public int InputType { get; set; } = 0;
+
+    /// <summary>关联账期ID（BaseCommon_AccountPeriod）</summary>
+    [Description("关联账期ID")]
+    [Column]
+    public long PeriodId { get; set; }
+}
+
+/// <summary>宿舍档案</summary>
+[Table(Name = "HRS_Dorm")]
+public class HRS_Dorm : BaseEntity
+{
+    /// <summary>宿舍楼栋</summary>
+    [Description("宿舍楼栋")]
+    [Column(DbType = "varchar(50)")]
+    public string? Building { get; set; }
+
+    /// <summary>宿舍编号</summary>
+    [Description("宿舍编号")]
+    [Column(DbType = "varchar(50)")]
+    public string Name { get; set; } = "";
+
+    /// <summary>楼层</summary>
+    [Description("楼层")]
+    [Column(DbType = "varchar(20)")]
+    public string? Floor { get; set; }
+
+    /// <summary>可住人数</summary>
+    [Description("可住人数")]
+    [Column]
+    public int Capacity { get; set; } = 4;
+}
+
+/// <summary>宿舍床位</summary>
+[Table(Name = "HRS_DormBed")]
+public class HRS_DormBed : BaseEntity
+{
+    /// <summary>宿舍ID</summary>
+    [Description("宿舍ID")]
+    [Column]
+    public long DormId { get; set; }
+
+    /// <summary>床位号</summary>
+    [Description("床位号")]
+    [Column(DbType = "varchar(20)")]
+    public string BedNo { get; set; } = "";
+
+    /// <summary>状态：0=空闲 1=入住</summary>
+    [Description("状态：0=空闲 1=入住")]
+    [Column]
+    public int Status { get; set; } = 0;
+
+    /// <summary>当前入住职工ID</summary>
+    [Description("当前入住职工ID")]
+    [Column]
+    public long EmployeeId { get; set; }
+}
+
+/// <summary>宿舍水电费登记（抄表采集）</summary>
+[Table(Name = "HRS_DormFee")]
+public class HRS_DormFee : BaseEntity
+{
+    /// <summary>宿舍ID</summary>
+    [Description("宿舍ID")]
+    [Column]
+    public long DormId { get; set; }
+
+    /// <summary>费用类型：0=电费 1=水费</summary>
+    [Description("费用类型：0=电费 1=水费")]
+    [Column]
+    public int FeeType { get; set; } = 0;
+
+    /// <summary>抄表日期</summary>
+    [Description("抄表日期")]
+    [Column]
+    public DateTime ReadDate { get; set; }
+
+    /// <summary>本次读数</summary>
+    [Description("本次读数")]
+    [Column(DbType = "decimal(12,2)")]
+    public decimal Reading { get; set; }
+
+    /// <summary>上次读数</summary>
+    [Description("上次读数")]
+    [Column(DbType = "decimal(12,2)")]
+    public decimal LastReading { get; set; }
+
+    /// <summary>用量</summary>
+    [Description("用量")]
+    [Column(DbType = "decimal(12,2)")]
+    public decimal Usage { get; set; }
+
+    /// <summary>单价</summary>
+    [Description("单价")]
+    [Column(DbType = "decimal(10,4)")]
+    public decimal UnitPrice { get; set; }
+
+    /// <summary>金额</summary>
+    [Description("金额")]
+    [Column(DbType = "decimal(12,2)")]
+    public decimal Amount { get; set; }
+}
+
+/// <summary>食堂消费记录</summary>
+[Table(Name = "HRS_CanteenRecord")]
+public class HRS_CanteenRecord : BaseEntity
+{
+    /// <summary>职工ID</summary>
+    [Description("职工ID")]
+    [Column]
+    public long EmployeeId { get; set; }
+
+    /// <summary>就餐日期</summary>
+    [Description("就餐日期")]
+    [Column]
+    public DateTime EatDate { get; set; }
+
+    /// <summary>餐次：0=早餐 1=午餐 2=晚餐 3=夜宵</summary>
+    [Description("餐次：0=早餐 1=午餐 2=晚餐 3=夜宵")]
+    [Column]
+    public int MealType { get; set; } = 0;
+
+    /// <summary>消费金额</summary>
+    [Description("消费金额")]
+    [Column(DbType = "decimal(10,2)")]
+    public decimal Amount { get; set; }
+
+    /// <summary>补贴金额</summary>
+    [Description("补贴金额")]
+    [Column(DbType = "decimal(10,2)")]
+    public decimal Subsidy { get; set; }
+
+    /// <summary>所属组织ID（统计用）</summary>
+    [Description("所属组织ID")]
+    [Column]
+    public long OrgId { get; set; }
+}
diff --git a/server/src/F9MES.Domain/Lims/Lims_Entities.cs b/server/src/F9MES.Domain/Lims/Lims_Entities.cs
new file mode 100644
index 0000000..5c40e3c
--- /dev/null
+++ b/server/src/F9MES.Domain/Lims/Lims_Entities.cs
@@ -0,0 +1,350 @@
+using FreeSql.DataAnnotations;
+using F9MES.Common.Entities;
+using System.ComponentModel;
+
+namespace F9MES.Domain.Lims;
+
+/// <summary>
+/// 检验管理模块实体（Lims），表名前缀：Lims_
+/// 检验类型：丝片检查/黑板检验/纤度检验/公量检验/厂检定级
+/// </summary>
+
+/// <summary>丝片检查（每日按庄口/班/车检查数量与重量）</summary>
+[Table(Name = "Lims_SpoolCheck")]
+public class Lims_SpoolCheck : BaseEntity
+{
+    /// <summary>检查单号</summary>
+    [Description("检查单号")]
+    [Column(DbType = "varchar(50)")]
+    public string CheckNo { get; set; } = "";
+
+    /// <summary>检查日期</summary>
+    [Description("检查日期")]
+    [Column]
+    public DateTime CheckDate { get; set; }
+
+    /// <summary>工艺庄口ID</summary>
+    [Description("工艺庄口ID")]
+    [Column]
+    public long ProcessZhuangkouId { get; set; }
+
+    /// <summary>班组ID</summary>
+    [Description("班组ID")]
+    [Column]
+    public long TeamId { get; set; }
+
+    /// <summary>班次：0=白班 1=夜班</summary>
+    [Description("班次：0=白班 1=夜班")]
+    [Column]
+    public int Shift { get; set; } = 0;
+
+    /// <summary>检查片数</summary>
+    [Description("检查片数")]
+    [Column]
+    public int CheckCount { get; set; }
+
+    /// <summary>检查重量（kg）</summary>
+    [Description("检查重量（kg）")]
+    [Column(DbType = "decimal(14,2)")]
+    public decimal CheckWeight { get; set; }
+
+    /// <summary>合格片数</summary>
+    [Description("合格片数")]
+    [Column]
+    public int PassCount { get; set; }
+
+    /// <summary>合格率（%）</summary>
+    [Description("合格率（%）")]
+    [Column(DbType = "decimal(6,2)")]
+    public decimal PassRate { get; set; }
+
+    /// <summary>检查员</summary>
+    [Description("检查员")]
+    [Column(DbType = "varchar(50)")]
+    public string? Checker { get; set; }
+
+    /// <summary>状态：0=草稿 1=已确认</summary>
+    [Description("状态：0=草稿 1=已确认")]
+    [Column]
+    public int Status { get; set; } = 0;
+}
+
+/// <summary>黑板检验（按庄口/规格/日期）</summary>
+[Table(Name = "Lims_BlackBoard")]
+public class Lims_BlackBoard : BaseEntity
+{
+    /// <summary>检验单号</summary>
+    [Description("检验单号")]
+    [Column(DbType = "varchar(50)")]
+    public string CheckNo { get; set; } = "";
+
+    /// <summary>检验日期</summary>
+    [Description("检验日期")]
+    [Column]
+    public DateTime CheckDate { get; set; }
+
+    /// <summary>工艺庄口ID</summary>
+    [Description("工艺庄口ID")]
+    [Column]
+    public long ProcessZhuangkouId { get; set; }
+
+    /// <summary>规格ID（BaseCommon_SilkSpec）</summary>
+    [Description("规格ID")]
+    [Column]
+    public long SpecId { get; set; }
+
+    /// <summary>均匀度（分）</summary>
+    [Description("均匀度（分）")]
+    [Column(DbType = "decimal(6,2)")]
+    public decimal Uniformity { get; set; }
+
+    /// <summary>洁净度（分）</summary>
+    [Description("洁净度（分）")]
+    [Column(DbType = "decimal(6,2)")]
+    public decimal Cleanliness { get; set; }
+
+    /// <summary>清洁度（分）</summary>
+    [Description("清洁度（分）")]
+    [Column(DbType = "decimal(6,2)")]
+    public decimal Neatness { get; set; }
+
+    /// <summary>综合等级</summary>
+    [Description("综合等级")]
+    [Column(DbType = "varchar(20)")]
+    public string? Grade { get; set; }
+
+    /// <summary>检验员</summary>
+    [Description("检验员")]
+    [Column(DbType = "varchar(50)")]
+    public string? Checker { get; set; }
+
+    /// <summary>检验数据JSON（原始记录，支持模板扩展）</summary>
+    [Description("检验数据JSON")]
+    [Column(DbType = "text")]
+    public string? DataJson { get; set; }
+}
+
+/// <summary>纤度检验（D数/偏差/断裂伸长等）</summary>
+[Table(Name = "Lims_Denier")]
+public class Lims_Denier : BaseEntity
+{
+    /// <summary>检验单号</summary>
+    [Description("检验单号")]
+    [Column(DbType = "varchar(50)")]
+    public string CheckNo { get; set; } = "";
+
+    /// <summary>检验日期</summary>
+    [Description("检验日期")]
+    [Column]
+    public DateTime CheckDate { get; set; }
+
+    /// <summary>工艺庄口ID</summary>
+    [Description("工艺庄口ID")]
+    [Column]
+    public long ProcessZhuangkouId { get; set; }
+
+    /// <summary>规格ID</summary>
+    [Description("规格ID")]
+    [Column]
+    public long SpecId { get; set; }
+
+    /// <summary>中心纤度（D）</summary>
+    [Description("中心纤度（D）")]
+    [Column(DbType = "decimal(10,2)")]
+    public decimal CenterDenier { get; set; }
+
+    /// <summary>平均纤度（D）</summary>
+    [Description("平均纤度（D）")]
+    [Column(DbType = "decimal(10,2)")]
+    public decimal AvgDenier { get; set; }
+
+    /// <summary>纤度偏差（D）</summary>
+    [Description("纤度偏差（D）")]
+    [Column(DbType = "decimal(10,2)")]
+    public decimal Deviation { get; set; }
+
+    /// <summary>纤度偏差率（%）</summary>
+    [Description("纤度偏差率（%）")]
+    [Column(DbType = "decimal(6,2)")]
+    public decimal DeviationRate { get; set; }
+
+    /// <summary>野纤个数</summary>
+    [Description("野纤个数")]
+    [Column]
+    public int WildCount { get; set; }
+
+    /// <summary>断裂强度（cN/dtex）</summary>
+    [Description("断裂强度（cN/dtex）")]
+    [Column(DbType = "decimal(6,2)")]
+    public decimal BreakingStrength { get; set; }
+
+    /// <summary>断裂伸长率（%）</summary>
+    [Description("断裂伸长率（%）")]
+    [Column(DbType = "decimal(6,2)")]
+    public decimal BreakingElongation { get; set; }
+
+    /// <summary>检验员</summary>
+    [Description("检验员")]
+    [Column(DbType = "varchar(50)")]
+    public string? Checker { get; set; }
+}
+
+/// <summary>公量检验（含水率/公量重量）</summary>
+[Table(Name = "Lims_Moisture")]
+public class Lims_Moisture : BaseEntity
+{
+    /// <summary>检验单号</summary>
+    [Description("检验单号")]
+    [Column(DbType = "varchar(50)")]
+    public string CheckNo { get; set; } = "";
+
+    /// <summary>检验日期</summary>
+    [Description("检验日期")]
+    [Column]
+    public DateTime CheckDate { get; set; }
+
+    /// <summary>工艺庄口ID</summary>
+    [Description("工艺庄口ID")]
+    [Column]
+    public long ProcessZhuangkouId { get; set; }
+
+    /// <summary>规格ID</summary>
+    [Description("规格ID")]
+    [Column]
+    public long SpecId { get; set; }
+
+    /// <summary>回潮率（%）</summary>
+    [Description("回潮率（%）")]
+    [Column(DbType = "decimal(6,2)")]
+    public decimal MoistureRegain { get; set; }
+
+    /// <summary>公定回潮率（%）</summary>
+    [Description("公定回潮率（%）")]
+    [Column(DbType = "decimal(6,2)")]
+    public decimal StandardRegain { get; set; }
+
+    /// <summary>毛重（kg）</summary>
+    [Description("毛重（kg）")]
+    [Column(DbType = "decimal(14,2)")]
+    public decimal GrossWeight { get; set; }
+
+    /// <summary>净重（kg）</summary>
+    [Description("净重（kg）")]
+    [Column(DbType = "decimal(14,2)")]
+    public decimal NetWeight { get; set; }
+
+    /// <summary>公量重量（kg）</summary>
+    [Description("公量重量（kg）")]
+    [Column(DbType = "decimal(14,2)")]
+    public decimal ConditionWeight { get; set; }
+
+    /// <summary>检验员</summary>
+    [Description("检验员")]
+    [Column(DbType = "varchar(50)")]
+    public string? Checker { get; set; }
+}
+
+/// <summary>检验异常记录</summary>
+[Table(Name = "Lims_Abnormal")]
+public class Lims_Abnormal : BaseEntity
+{
+    /// <summary>异常编号</summary>
+    [Description("异常编号")]
+    [Column(DbType = "varchar(50)")]
+    public string AbnormalNo { get; set; } = "";
+
+    /// <summary>检验类型：0=丝片检查 1=黑板检验 2=纤度检验 3=公量检验 4=厂检定级</summary>
+    [Description("检验类型：0=丝片检查 1=黑板 2=纤度 3=公量 4=厂检定级")]
+    [Column]
+    public int CheckType { get; set; } = 0;
+
+    /// <summary>工艺庄口ID</summary>
+    [Description("工艺庄口ID")]
+    [Column]
+    public long ProcessZhuangkouId { get; set; }
+
+    /// <summary>异常类型：0=纤度异常 1=清洁异常 2=重量异常 3=其他</summary>
+    [Description("异常类型：0=纤度异常 1=清洁异常 2=重量异常 3=其他")]
+    [Column]
+    public int AbnormalType { get; set; } = 0;
+
+    /// <summary>异常描述</summary>
+    [Description("异常描述")]
+    [Column(DbType = "varchar(500)")]
+    public string Description { get; set; } = "";
+
+    /// <summary>处理状态：0=待处理 1=处理中 2=已处理 3=已关闭</summary>
+    [Description("处理状态：0=待处理 1=处理中 2=已处理 3=已关闭")]
+    [Column]
+    public int Status { get; set; } = 0;
+
+    /// <summary>处理人</summary>
+    [Description("处理人")]
+    [Column(DbType = "varchar(50)")]
+    public string? Handler { get; set; }
+
+    /// <summary>处理结果</summary>
+    [Description("处理结果")]
+    [Column(DbType = "varchar(500)")]
+    public string? HandleResult { get; set; }
+
+    /// <summary>发现日期</summary>
+    [Description("发现日期")]
+    [Column]
+    public DateTime FoundDate { get; set; }
+}
+
+/// <summary>厂检定级判定（生丝入库定级）</summary>
+[Table(Name = "Lims_GradeResult")]
+public class Lims_GradeResult : BaseEntity
+{
+    /// <summary>判定单号</summary>
+    [Description("判定单号")]
+    [Column(DbType = "varchar(50)")]
+    public string GradeNo { get; set; } = "";
+
+    /// <summary>工艺庄口ID</summary>
+    [Description("工艺庄口ID")]
+    [Column]
+    public long ProcessZhuangkouId { get; set; }
+
+    /// <summary>规格ID</summary>
+    [Description("规格ID")]
+    [Column]
+    public long SpecId { get; set; }
+
+    /// <summary>定级标准ID（BaseCommon_GradeStandard）</summary>
+    [Description("定级标准ID")]
+    [Column]
+    public long StandardId { get; set; }
+
+    /// <summary>判定等级</summary>
+    [Description("判定等级")]
+    [Column(DbType = "varchar(20)")]
+    public string Grade { get; set; } = "";
+
+    /// <summary>各项指标JSON（均匀/洁净/清洁/纤度偏差等）</summary>
+    [Description("各项指标JSON")]
+    [Column(DbType = "text")]
+    public string? DataJson { get; set; }
+
+    /// <summary>判定依据说明</summary>
+    [Description("判定依据说明")]
+    [Column(DbType = "varchar(500)")]
+    public string? BasisDesc { get; set; }
+
+    /// <summary>判定人</summary>
+    [Description("判定人")]
+    [Column(DbType = "varchar(50)")]
+    public string? Grader { get; set; }
+
+    /// <summary>判定日期</summary>
+    [Description("判定日期")]
+    [Column]
+    public DateTime GradeDate { get; set; }
+
+    /// <summary>状态：0=草稿 1=已生效</summary>
+    [Description("状态：0=草稿 1=已生效")]
+    [Column]
+    public int Status { get; set; } = 0;
+}
diff --git a/server/src/F9MES.Domain/ProHou/ProHou_Entities.cs b/server/src/F9MES.Domain/ProHou/ProHou_Entities.cs
new file mode 100644
index 0000000..7730e00
--- /dev/null
+++ b/server/src/F9MES.Domain/ProHou/ProHou_Entities.cs
@@ -0,0 +1,184 @@
+using FreeSql.DataAnnotations;
+using F9MES.Common.Entities;
+using System.ComponentModel;
+
+namespace F9MES.Domain.ProHou;
+
+/// <summary>
+/// 后缫工段模块实体（ProHou），表名前缀：ProHou_
+/// </summary>
+
+/// <summary>返丝日报（复摇工序逐日产量）</summary>
+[Table(Name = "ProHou_Daily")]
+public class ProHou_Daily : BaseEntity
+{
+    /// <summary>日期</summary>
+    [Description("日期")]
+    [Column]
+    public DateTime DailyDate { get; set; }
+
+    /// <summary>工艺庄口ID</summary>
+    [Description("工艺庄口ID")]
+    [Column]
+    public long ProcessZhuangkouId { get; set; }
+
+    /// <summary>班组ID</summary>
+    [Description("班组ID")]
+    [Column]
+    public long TeamId { get; set; }
+
+    /// <summary>上机丝量（kg）</summary>
+    [Description("上机丝量（kg）")]
+    [Column(DbType = "decimal(14,2)")]
+    public decimal InputWeight { get; set; }
+
+    /// <summary>返丝产量（kg）</summary>
+    [Description("返丝产量（kg）")]
+    [Column(DbType = "decimal(14,2)")]
+    public decimal OutputWeight { get; set; }
+
+    /// <summary>返丝片数</summary>
+    [Description("返丝片数")]
+    [Column]
+    public int OutputCount { get; set; }
+
+    /// <summary>出勤人数</summary>
+    [Description("出勤人数")]
+    [Column]
+    public int WorkerCount { get; set; }
+
+    /// <summary>备注</summary>
+    [Description("备注")]
+    [Column(DbType = "varchar(500)")]
+    public string? Remark { get; set; }
+}
+
+/// <summary>丝片台账（片码/丝片号，逐片登记）</summary>
+[Table(Name = "ProHou_SpoolLedger")]
+public class ProHou_SpoolLedger : BaseEntity
+{
+    /// <summary>丝片编码（唯一）</summary>
+    [Description("丝片编码（唯一）")]
+    [Column(DbType = "varchar(50)")]
+    public string Code { get; set; } = "";
+
+    /// <summary>工艺庄口ID</summary>
+    [Description("工艺庄口ID")]
+    [Column]
+    public long ProcessZhuangkouId { get; set; }
+
+    /// <summary>规格ID（BaseCommon_SilkSpec）</summary>
+    [Description("规格ID")]
+    [Column]
+    public long SpecId { get; set; }
+
+    /// <summary>重量（kg）</summary>
+    [Description("重量（kg）")]
+    [Column(DbType = "decimal(10,2)")]
+    public decimal Weight { get; set; }
+
+    /// <summary>等级</summary>
+    [Description("等级")]
+    [Column(DbType = "varchar(20)")]
+    public string? Grade { get; set; }
+
+    /// <summary>片号</summary>
+    [Description("片号")]
+    [Column(DbType = "varchar(20)")]
+    public string? PieceNo { get; set; }
+
+    /// <summary>生产日期</summary>
+    [Description("生产日期")]
+    [Column]
+    public DateTime ProduceDate { get; set; }
+
+    /// <summary>班组ID</summary>
+    [Description("班组ID")]
+    [Column]
+    public long TeamId { get; set; }
+
+    /// <summary>丝片状态：0=在库 1=已检验 2=已入成品 3=已售出 4=报损</summary>
+    [Description("丝片状态：0=在库 1=已检验 2=已入成品 3=已售出 4=报损")]
+    [Column]
+    public int Status { get; set; } = 0;
+}
+
+/// <summary>丝片检查（复摇工序丝片自检）</summary>
+[Table(Name = "ProHou_SpoolCheck")]
+public class ProHou_SpoolCheck : BaseEntity
+{
+    /// <summary>丝片台账ID</summary>
+    [Description("丝片台账ID")]
+    [Column]
+    public long SpoolId { get; set; }
+
+    /// <summary>检查日期</summary>
+    [Description("检查日期")]
+    [Column]
+    public DateTime CheckDate { get; set; }
+
+    /// <summary>检查结果：0=合格 1=返修 2=报废</summary>
+    [Description("检查结果：0=合格 1=返修 2=报废")]
+    [Column]
+    public int CheckResult { get; set; } = 0;
+
+    /// <summary>检查项目JSON（对照检查项）</summary>
+    [Description("检查项目JSON")]
+    [Column(DbType = "text")]
+    public string? CheckItemsJson { get; set; }
+
+    /// <summary>检查员</summary>
+    [Description("检查员")]
+    [Column(DbType = "varchar(50)")]
+    public string? Checker { get; set; }
+
+    /// <summary>备注</summary>
+    [Description("备注")]
+    [Column(DbType = "varchar(500)")]
+    public string? Remark { get; set; }
+}
+
+/// <summary>秤大丝（称重打包计量）</summary>
+[Table(Name = "ProHou_WeighBig")]
+public class ProHou_WeighBig : BaseEntity
+{
+    /// <summary>称重单号</summary>
+    [Description("称重单号")]
+    [Column(DbType = "varchar(50)")]
+    public string BillNo { get; set; } = "";
+
+    /// <summary>工艺庄口ID</summary>
+    [Description("工艺庄口ID")]
+    [Column]
+    public long ProcessZhuangkouId { get; set; }
+
+    /// <summary>称重日期</summary>
+    [Description("称重日期")]
+    [Column]
+    public DateTime WeighDate { get; set; }
+
+    /// <summary>总重量（kg）</summary>
+    [Description("总重量（kg）")]
+    [Column(DbType = "decimal(14,2)")]
+    public decimal TotalWeight { get; set; }
+
+    /// <summary>包数</summary>
+    [Description("包数")]
+    [Column]
+    public int PackageCount { get; set; }
+
+    /// <summary>规格ID</summary>
+    [Description("规格ID")]
+    [Column]
+    public long SpecId { get; set; }
+
+    /// <summary>等级</summary>
+    [Description("等级")]
+    [Column(DbType = "varchar(20)")]
+    public string? Grade { get; set; }
+
+    /// <summary>称重人</summary>
+    [Description("称重人")]
+    [Column(DbType = "varchar(50)")]
+    public string? Operator { get; set; }
+}
diff --git a/server/src/F9MES.Domain/ProPlan/ProPlan_Entities.cs b/server/src/F9MES.Domain/ProPlan/ProPlan_Entities.cs
new file mode 100644
index 0000000..865b4eb
--- /dev/null
+++ b/server/src/F9MES.Domain/ProPlan/ProPlan_Entities.cs
@@ -0,0 +1,119 @@
+using FreeSql.DataAnnotations;
+using F9MES.Common.Entities;
+using System.ComponentModel;
+
+namespace F9MES.Domain.ProPlan;
+
+/// <summary>
+/// 生产计划模块实体（ProPlan），表名前缀：ProPlan_
+/// </summary>
+
+/// <summary>任务工单（由投产计划驱动生成，下发前缫/选茧工序）</summary>
+[Table(Name = "ProPlan_WorkOrder")]
+public class ProPlan_WorkOrder : BaseEntity
+{
+    /// <summary>工单编号</summary>
+    [Description("工单编号")]
+    [Column(DbType = "varchar(50)")]
+    public string OrderNo { get; set; } = "";
+
+    /// <summary>工艺庄口ID</summary>
+    [Description("工艺庄口ID")]
+    [Column]
+    public long ProcessZhuangkouId { get; set; }
+
+    /// <summary>关联工艺单ID（Process_Sheet）</summary>
+    [Description("关联工艺单ID")]
+    [Column]
+    public long SheetId { get; set; }
+
+    /// <summary>目标工序：0=选茧 1=前缫（煮茧/缫丝）</summary>
+    [Description("目标工序：0=选茧 1=前缫")]
+    [Column]
+    public int TargetProcess { get; set; } = 0;
+
+    /// <summary>计划投料量（kg）</summary>
+    [Description("计划投料量（kg）")]
+    [Column(DbType = "decimal(14,2)")]
+    public decimal PlanInput { get; set; }
+
+    /// <summary>实际投料量（kg）</summary>
+    [Description("实际投料量（kg）")]
+    [Column(DbType = "decimal(14,2)")]
+    public decimal ActualInput { get; set; }
+
+    /// <summary>计划产出量（kg）</summary>
+    [Description("计划产出量（kg）")]
+    [Column(DbType = "decimal(14,2)")]
+    public decimal PlanOutput { get; set; }
+
+    /// <summary>实际产出量（kg）</summary>
+    [Description("实际产出量（kg）")]
+    [Column(DbType = "decimal(14,2)")]
+    public decimal ActualOutput { get; set; }
+
+    /// <summary>计划开始日期</summary>
+    [Description("计划开始日期")]
+    [Column]
+    public DateTime PlanStartDate { get; set; }
+
+    /// <summary>计划结束日期</summary>
+    [Description("计划结束日期")]
+    [Column]
+    public DateTime PlanEndDate { get; set; }
+
+    /// <summary>工单状态：0=待下发 1=已下发 2=执行中 3=已完成 4=已暂停 5=已取消</summary>
+    [Description("工单状态：0=待下发 1=已下发 2=执行中 3=已完成 4=已暂停 5=已取消")]
+    [Column]
+    public int Status { get; set; } = 0;
+
+    /// <summary>优先级：0=普通 1=紧急</summary>
+    [Description("优先级：0=普通 1=紧急")]
+    [Column]
+    public int Priority { get; set; } = 0;
+}
+
+/// <summary>计划变更记录（庄口暂停/换庄/调整投产顺序）</summary>
+[Table(Name = "ProPlan_Change")]
+public class ProPlan_Change : BaseEntity
+{
+    /// <summary>变更单号</summary>
+    [Description("变更单号")]
+    [Column(DbType = "varchar(50)")]
+    public string ChangeNo { get; set; } = "";
+
+    /// <summary>工艺庄口ID</summary>
+    [Description("工艺庄口ID")]
+    [Column]
+    public long ProcessZhuangkouId { get; set; }
+
+    /// <summary>变更类型：0=暂停 1=换庄 2=调整顺序 3=恢复生产</summary>
+    [Description("变更类型：0=暂停 1=换庄 2=调整顺序 3=恢复生产")]
+    [Column]
+    public int ChangeType { get; set; } = 0;
+
+    /// <summary>变更原因</summary>
+    [Description("变更原因")]
+    [Column(DbType = "varchar(500)")]
+    public string Reason { get; set; } = "";
+
+    /// <summary>原投产顺序</summary>
+    [Description("原投产顺序")]
+    [Column]
+    public int FromOrder { get; set; }
+
+    /// <summary>新投产顺序</summary>
+    [Description("新投产顺序")]
+    [Column]
+    public int ToOrder { get; set; }
+
+    /// <summary>操作人ID</summary>
+    [Description("操作人ID")]
+    [Column]
+    public long OperatorId { get; set; }
+
+    /// <summary>变更时间</summary>
+    [Description("变更时间")]
+    [Column]
+    public DateTime ChangeTime { get; set; }
+}
diff --git a/server/src/F9MES.Domain/ProQian/ProQian_Entities.cs b/server/src/F9MES.Domain/ProQian/ProQian_Entities.cs
new file mode 100644
index 0000000..6db3557
--- /dev/null
+++ b/server/src/F9MES.Domain/ProQian/ProQian_Entities.cs
@@ -0,0 +1,234 @@
+using FreeSql.DataAnnotations;
+using F9MES.Common.Entities;
+using System.ComponentModel;
+
+namespace F9MES.Domain.ProQian;
+
+/// <summary>
+/// 前缫工段模块实体（ProQian），表名前缀：ProQian_
+/// </summary>
+
+/// <summary>车间配置（车间信息、班次、车台数，树状配置）</summary>
+[Table(Name = "ProQian_Workshop")]
+public class ProQian_Workshop : BaseTreeEntity
+{
+    /// <summary>车间名称</summary>
+    [Description("车间名称")]
+    [Column(DbType = "varchar(100)")]
+    public string Name { get; set; } = "";
+
+    /// <summary>车间编码</summary>
+    [Description("车间编码")]
+    [Column(DbType = "varchar(50)")]
+    public string? Code { get; set; }
+
+    /// <summary>班次配置：0=单班 1=两班 2=三班</summary>
+    [Description("班次配置：0=单班 1=两班 2=三班")]
+    [Column]
+    public int ShiftConfig { get; set; } = 1;
+
+    /// <summary>车台总数</summary>
+    [Description("车台总数")]
+    [Column]
+    public int MachineCount { get; set; }
+
+    /// <summary>负责人</summary>
+    [Description("负责人")]
+    [Column(DbType = "varchar(50)")]
+    public string? Manager { get; set; }
+}
+
+/// <summary>机组车位（机组-车位层级配置）</summary>
+[Table(Name = "ProQian_Machine")]
+public class ProQian_Machine : BaseEntity
+{
+    /// <summary>车间ID</summary>
+    [Description("车间ID")]
+    [Column]
+    public long WorkshopId { get; set; }
+
+    /// <summary>机组名称（如 1号机组）</summary>
+    [Description("机组名称")]
+    [Column(DbType = "varchar(50)")]
+    public string GroupName { get; set; } = "";
+
+    /// <summary>车号</summary>
+    [Description("车号")]
+    [Column(DbType = "varchar(20)")]
+    public string MachineNo { get; set; } = "";
+
+    /// <summary>车位编号</summary>
+    [Description("车位编号")]
+    [Column(DbType = "varchar(20)")]
+    public string PositionNo { get; set; } = "";
+
+    /// <summary>设备状态：0=空闲 1=运行 2=停机 3=维修</summary>
+    [Description("设备状态：0=空闲 1=运行 2=停机 3=维修")]
+    [Column]
+    public int Status { get; set; } = 0;
+
+    /// <summary>是否启用</summary>
+    [Description("是否启用")]
+    [Column]
+    public int IsEnable { get; set; } = 1;
+}
+
+/// <summary>看台排班（缫丝工/车头工看台位置和绪数）</summary>
+[Table(Name = "ProQian_Schedule")]
+public class ProQian_Schedule : BaseEntity
+{
+    /// <summary>日期</summary>
+    [Description("日期")]
+    [Column]
+    public DateTime ScheduleDate { get; set; }
+
+    /// <summary>班次：0=白班 1=夜班</summary>
+    [Description("班次：0=白班 1=夜班")]
+    [Column]
+    public int Shift { get; set; } = 0;
+
+    /// <summary>车间ID</summary>
+    [Description("车间ID")]
+    [Column]
+    public long WorkshopId { get; set; }
+
+    /// <summary>车位ID（ProQian_Machine）</summary>
+    [Description("车位ID")]
+    [Column]
+    public long MachineId { get; set; }
+
+    /// <summary>职工ID（缫丝工/车头工）</summary>
+    [Description("职工ID")]
+    [Column]
+    public long EmployeeId { get; set; }
+
+    /// <summary>岗位：0=缫丝工 1=车头工</summary>
+    [Description("岗位：0=缫丝工 1=车头工")]
+    [Column]
+    public int PostType { get; set; } = 0;
+
+    /// <summary>看台绪数</summary>
+    [Description("看台绪数")]
+    [Column]
+    public int XuCount { get; set; }
+}
+
+/// <summary>看台时长（支持录入/调整/合并/分拆/临时安排）</summary>
+[Table(Name = "ProQian_ShiftTime")]
+public class ProQian_ShiftTime : BaseEntity
+{
+    /// <summary>职工ID</summary>
+    [Description("职工ID")]
+    [Column]
+    public long EmployeeId { get; set; }
+
+    /// <summary>工艺庄口ID</summary>
+    [Description("工艺庄口ID")]
+    [Column]
+    public long ProcessZhuangkouId { get; set; }
+
+    /// <summary>日期</summary>
+    [Description("日期")]
+    [Column]
+    public DateTime WorkDate { get; set; }
+
+    /// <summary>班次：0=白班 1=夜班</summary>
+    [Description("班次：0=白班 1=夜班")]
+    [Column]
+    public int Shift { get; set; } = 0;
+
+    /// <summary>车位ID</summary>
+    [Description("车位ID")]
+    [Column]
+    public long MachineId { get; set; }
+
+    /// <summary>看台时长（小时）</summary>
+    [Description("看台时长（小时）")]
+    [Column(DbType = "decimal(6,2)")]
+    public decimal Hours { get; set; }
+
+    /// <summary>操作类型：0=录入 1=调整 2=合并 3=分拆 4=临时安排</summary>
+    [Description("操作类型：0=录入 1=调整 2=合并 3=分拆 4=临时安排")]
+    [Column]
+    public int OpType { get; set; } = 0;
+
+    /// <summary>来源记录ID（合并/分拆关联）</summary>
+    [Description("来源记录ID")]
+    [Column]
+    public long SourceId { get; set; }
+}
+
+/// <summary>煮茧日报（逐日分庄分规格送茧量）</summary>
+[Table(Name = "ProQian_CocoonBoiling")]
+public class ProQian_CocoonBoiling : BaseEntity
+{
+    /// <summary>日期</summary>
+    [Description("日期")]
+    [Column]
+    public DateTime BoilDate { get; set; }
+
+    /// <summary>工艺庄口ID</summary>
+    [Description("工艺庄口ID")]
+    [Column]
+    public long ProcessZhuangkouId { get; set; }
+
+    /// <summary>规格ID（BaseCommon_SilkSpec）</summary>
+    [Description("规格ID")]
+    [Column]
+    public long SpecId { get; set; }
+
+    /// <summary>送茧量（kg）</summary>
+    [Description("送茧量（kg）")]
+    [Column(DbType = "decimal(14,2)")]
+    public decimal InputWeight { get; set; }
+
+    /// <summary>煮茧机台</summary>
+    [Description("煮茧机台")]
+    [Column(DbType = "varchar(50)")]
+    public string? BoilerNo { get; set; }
+}
+
+/// <summary>落丝记录（逐日按机组下丝量）</summary>
+[Table(Name = "ProQian_ThreadRecord")]
+public class ProQian_ThreadRecord : BaseEntity
+{
+    /// <summary>日期</summary>
+    [Description("日期")]
+    [Column]
+    public DateTime RecordDate { get; set; }
+
+    /// <summary>工艺庄口ID</summary>
+    [Description("工艺庄口ID")]
+    [Column]
+    public long ProcessZhuangkouId { get; set; }
+
+    /// <summary>机组ID</summary>
+    [Description("机组ID")]
+    [Column]
+    public long MachineId { get; set; }
+
+    /// <summary>班次：0=白班 1=夜班</summary>
+    [Description("班次：0=白班 1=夜班")]
+    [Column]
+    public int Shift { get; set; } = 0;
+
+    /// <summary>下丝片数（小䈅丝片）</summary>
+    [Description("下丝片数")]
+    [Column]
+    public int ThreadCount { get; set; }
+
+    /// <summary>下丝重量（kg）</summary>
+    [Description("下丝重量（kg）")]
+    [Column(DbType = "decimal(14,2)")]
+    public decimal Weight { get; set; }
+
+    /// <summary>规格ID</summary>
+    [Description("规格ID")]
+    [Column]
+    public long SpecId { get; set; }
+
+    /// <summary>缫丝工ID</summary>
+    [Description("缫丝工ID")]
+    [Column]
+    public long EmployeeId { get; set; }
+}
diff --git a/server/src/F9MES.Domain/ProXuan/ProXuan_Entities.cs b/server/src/F9MES.Domain/ProXuan/ProXuan_Entities.cs
new file mode 100644
index 0000000..56cf143
--- /dev/null
+++ b/server/src/F9MES.Domain/ProXuan/ProXuan_Entities.cs
@@ -0,0 +1,159 @@
+using FreeSql.DataAnnotations;
+using F9MES.Common.Entities;
+using System.ComponentModel;
+
+namespace F9MES.Domain.ProXuan;
+
+/// <summary>
+/// 选茧工段模块实体（ProXuan），表名前缀：ProXuan_
+/// </summary>
+
+/// <summary>选茧班组</summary>
+[Table(Name = "ProXuan_Team")]
+public class ProXuan_Team : BaseEntity
+{
+    /// <summary>班组名称</summary>
+    [Description("班组名称")]
+    [Column(DbType = "varchar(100)")]
+    public string Name { get; set; } = "";
+
+    /// <summary>班组长</summary>
+    [Description("班组长")]
+    [Column(DbType = "varchar(50)")]
+    public string? Leader { get; set; }
+
+    /// <summary>班组人数</summary>
+    [Description("班组人数")]
+    [Column]
+    public int MemberCount { get; set; }
+
+    /// <summary>班次：0=白班 1=夜班</summary>
+    [Description("班次：0=白班 1=夜班")]
+    [Column]
+    public int Shift { get; set; } = 0;
+
+    /// <summary>是否启用</summary>
+    [Description("是否启用")]
+    [Column]
+    public int IsEnable { get; set; } = 1;
+}
+
+/// <summary>选茧日报（逐日产量/质量/人员）</summary>
+[Table(Name = "ProXuan_Daily")]
+public class ProXuan_Daily : BaseEntity
+{
+    /// <summary>日期</summary>
+    [Description("日期")]
+    [Column]
+    public DateTime DailyDate { get; set; }
+
+    /// <summary>班组ID</summary>
+    [Description("班组ID")]
+    [Column]
+    public long TeamId { get; set; }
+
+    /// <summary>原料庄口ID</summary>
+    [Description("原料庄口ID")]
+    [Column]
+    public long ZhuangkouId { get; set; }
+
+    /// <summary>领料量（kg）</summary>
+    [Description("领料量（kg）")]
+    [Column(DbType = "decimal(14,2)")]
+    public decimal InputWeight { get; set; }
+
+    /// <summary>选出上车茧量（kg）</summary>
+    [Description("选出上车茧量（kg）")]
+    [Column(DbType = "decimal(14,2)")]
+    public decimal GoodWeight { get; set; }
+
+    /// <summary>下脚茧量（kg）</summary>
+    [Description("下脚茧量（kg）")]
+    [Column(DbType = "decimal(14,2)")]
+    public decimal WasteWeight { get; set; }
+
+    /// <summary>出勤人数</summary>
+    [Description("出勤人数")]
+    [Column]
+    public int WorkerCount { get; set; }
+
+    /// <summary>作业时长（小时）</summary>
+    [Description("作业时长（小时）")]
+    [Column(DbType = "decimal(6,2)")]
+    public decimal WorkHours { get; set; }
+
+    /// <summary>备注</summary>
+    [Description("备注")]
+    [Column(DbType = "varchar(500)")]
+    public string? Remark { get; set; }
+}
+
+/// <summary>选茧质量（按日/庄口质量指标）</summary>
+[Table(Name = "ProXuan_Quality")]
+public class ProXuan_Quality : BaseEntity
+{
+    /// <summary>日期</summary>
+    [Description("日期")]
+    [Column]
+    public DateTime QualityDate { get; set; }
+
+    /// <summary>原料庄口ID</summary>
+    [Description("原料庄口ID")]
+    [Column]
+    public long ZhuangkouId { get; set; }
+
+    /// <summary>上车率（%）</summary>
+    [Description("上车率（%）")]
+    [Column(DbType = "decimal(6,2)")]
+    public decimal GoodRate { get; set; }
+
+    /// <summary>下脚率（%）</summary>
+    [Description("下脚率（%）")]
+    [Column(DbType = "decimal(6,2)")]
+    public decimal WasteRate { get; set; }
+
+    /// <summary>质量等级：0=正常 1=偏差 2=异常</summary>
+    [Description("质量等级：0=正常 1=偏差 2=异常")]
+    [Column]
+    public int QualityLevel { get; set; } = 0;
+
+    /// <summary>质量问题说明</summary>
+    [Description("质量问题说明")]
+    [Column(DbType = "varchar(500)")]
+    public string? IssueDesc { get; set; }
+}
+
+/// <summary>光茧临时仓库（选茧后中间存储）</summary>
+[Table(Name = "ProXuan_TempStock")]
+public class ProXuan_TempStock : BaseEntity
+{
+    /// <summary>原料庄口ID</summary>
+    [Description("原料庄口ID")]
+    [Column]
+    public long ZhuangkouId { get; set; }
+
+    /// <summary>仓库位置</summary>
+    [Description("仓库位置")]
+    [Column(DbType = "varchar(100)")]
+    public string? Location { get; set; }
+
+    /// <summary>入库重量（kg）</summary>
+    [Description("入库重量（kg）")]
+    [Column(DbType = "decimal(14,2)")]
+    public decimal InWeight { get; set; }
+
+    /// <summary>出库重量（kg，送前缫）</summary>
+    [Description("出库重量（kg）")]
+    [Column(DbType = "decimal(14,2)")]
+    public decimal OutWeight { get; set; }
+
+    /// <summary>结存重量（kg）</summary>
+    [Description("结存重量（kg）")]
+    [Column(DbType = "decimal(14,2)")]
+    public decimal StockWeight { get; set; }
+
+    /// <summary>最近变动时间</summary>
+    [Description("最近变动时间")]
+    [Column]
+    public DateTime? LastChangeTime { get; set; }
+}
diff --git a/server/src/F9MES.Domain/Process/Process_Entities.cs b/server/src/F9MES.Domain/Process/Process_Entities.cs
new file mode 100644
index 0000000..59c10be
--- /dev/null
+++ b/server/src/F9MES.Domain/Process/Process_Entities.cs
@@ -0,0 +1,255 @@
+using FreeSql.DataAnnotations;
+using F9MES.Common.Entities;
+using System.ComponentModel;
+
+namespace F9MES.Domain.Process;
+
+/// <summary>
+/// 生技工艺模块实体（Process），表名前缀：Process_
+/// 工艺庄口：根据生产工艺组合的生产用庄口，全局贯穿系统线索
+/// </summary>
+
+/// <summary>样茧试缫（采购试缫/入库前端试缫/工艺庄口试缫，多表单模板）</summary>
+[Table(Name = "Process_Trial")]
+public class Process_Trial : BaseEntity
+{
+    /// <summary>试缫单号</summary>
+    [Description("试缫单号")]
+    [Column(DbType = "varchar(50)")]
+    public string BillNo { get; set; } = "";
+
+    /// <summary>试缫类型：0=采购样茧试缫 1=入库前端试缫 2=工艺庄口试缫</summary>
+    [Description("试缫类型：0=采购试缫 1=入库前端试缫 2=工艺庄口试缫")]
+    [Column]
+    public int TrialType { get; set; } = 0;
+
+    /// <summary>原料庄口ID</summary>
+    [Description("原料庄口ID")]
+    [Column]
+    public long ZhuangkouId { get; set; }
+
+    /// <summary>工艺庄口ID（可选）</summary>
+    [Description("工艺庄口ID")]
+    [Column]
+    public long ProcessZhuangkouId { get; set; }
+
+    /// <summary>表单模板ID（可配置模板）</summary>
+    [Description("表单模板ID")]
+    [Column]
+    public long TemplateId { get; set; }
+
+    /// <summary>试缫日期</summary>
+    [Description("试缫日期")]
+    [Column]
+    public DateTime TrialDate { get; set; }
+
+    /// <summary>试缫人</summary>
+    [Description("试缫人")]
+    [Column(DbType = "varchar(50)")]
+    public string? TrialMan { get; set; }
+
+    /// <summary>试缫数据JSON（共享指标+差异化字段）</summary>
+    [Description("试缫数据JSON")]
+    [Column(DbType = "text")]
+    public string? DataJson { get; set; }
+}
+
+/// <summary>工艺庄口（编号规则：GYZ-年度-流水号，默认 GYZ-2026-001）</summary>
+[Table(Name = "Process_ProcessZhuangkou")]
+public class Process_ProcessZhuangkou : BaseEntity
+{
+    /// <summary>庄口编号（GYZ-2026-001）</summary>
+    [Description("庄口编号（GYZ-年度-流水）")]
+    [Column(DbType = "varchar(50)")]
+    public string Code { get; set; } = "";
+
+    /// <summary>庄口名称</summary>
+    [Description("庄口名称")]
+    [Column(DbType = "varchar(100)")]
+    public string Name { get; set; } = "";
+
+    /// <summary>庄口简称</summary>
+    [Description("庄口简称")]
+    [Column(DbType = "varchar(50)")]
+    public string? ShortName { get; set; }
+
+    /// <summary>生产显示名称</summary>
+    [Description("生产显示名称")]
+    [Column(DbType = "varchar(100)")]
+    public string? DisplayName { get; set; }
+
+    /// <summary>归属：0=本地 1=外地</summary>
+    [Description("归属：0=本地 1=外地")]
+    [Column]
+    public int IsLocal { get; set; } = 0;
+
+    /// <summary>标签</summary>
+    [Description("标签")]
+    [Column(DbType = "varchar(100)")]
+    public string? Tags { get; set; }
+
+    /// <summary>进度（0-100）</summary>
+    [Description("进度（0-100）")]
+    [Column(DbType = "decimal(6,2)")]
+    public decimal Progress { get; set; }
+
+    /// <summary>关联原料庄口ID（可选）</summary>
+    [Description("关联原料庄口ID")]
+    [Column]
+    public long ZhuangkouId { get; set; }
+
+    /// <summary>生产状态：0=未投产 1=生产中 2=已暂停 3=已完成 4=已关闭</summary>
+    [Description("生产状态：0=未投产 1=生产中 2=已暂停 3=已完成 4=已关闭")]
+    [Column]
+    public int Status { get; set; } = 0;
+
+    /// <summary>投产日期</summary>
+    [Description("投产日期")]
+    [Column]
+    public DateTime? StartDate { get; set; }
+
+    /// <summary>预计结束日期</summary>
+    [Description("预计结束日期")]
+    [Column]
+    public DateTime? PlanEndDate { get; set; }
+
+    /// <summary>实际结束日期</summary>
+    [Description("实际结束日期")]
+    [Column]
+    public DateTime? EndDate { get; set; }
+}
+
+/// <summary>工艺指标（指标字典）</summary>
+[Table(Name = "Process_Index")]
+public class Process_Index : BaseEntity
+{
+    /// <summary>指标编码</summary>
+    [Description("指标编码")]
+    [Column(DbType = "varchar(50)")]
+    public string Code { get; set; } = "";
+
+    /// <summary>指标名称</summary>
+    [Description("指标名称")]
+    [Column(DbType = "varchar(100)")]
+    public string Name { get; set; } = "";
+
+    /// <summary>指标分组（如 煮茧/缫丝/复摇）</summary>
+    [Description("指标分组")]
+    [Column(DbType = "varchar(50)")]
+    public string? GroupName { get; set; }
+
+    /// <summary>指标类型：0=数值 1=文本 2=下拉 3=布尔</summary>
+    [Description("指标类型：0=数值 1=文本 2=下拉 3=布尔")]
+    [Column]
+    public int IndexType { get; set; } = 0;
+
+    /// <summary>单位</summary>
+    [Description("单位")]
+    [Column(DbType = "varchar(20)")]
+    public string? Unit { get; set; }
+
+    /// <summary>默认值</summary>
+    [Description("默认值")]
+    [Column(DbType = "varchar(100)")]
+    public string? DefaultValue { get; set; }
+
+    /// <summary>可选值JSON（下拉选项）</summary>
+    [Description("可选值JSON")]
+    [Column(DbType = "varchar(500)")]
+    public string? OptionsJson { get; set; }
+
+    /// <summary>排序号</summary>
+    [Description("排序号")]
+    [Column]
+    public int Sort { get; set; } = 0;
+
+    /// <summary>是否启用</summary>
+    [Description("是否启用")]
+    [Column]
+    public int IsEnable { get; set; } = 1;
+}
+
+/// <summary>工艺单（庄口所有生产工艺指标，KV模式存储）</summary>
+[Table(Name = "Process_Sheet")]
+public class Process_Sheet : BaseEntity
+{
+    /// <summary>工艺单编号</summary>
+    [Description("工艺单编号")]
+    [Column(DbType = "varchar(50)")]
+    public string SheetNo { get; set; } = "";
+
+    /// <summary>工艺单名称</summary>
+    [Description("工艺单名称")]
+    [Column(DbType = "varchar(100)")]
+    public string Name { get; set; } = "";
+
+    /// <summary>工艺庄口ID</summary>
+    [Description("工艺庄口ID")]
+    [Column]
+    public long ProcessZhuangkouId { get; set; }
+
+    /// <summary>版本号</summary>
+    [Description("版本号")]
+    [Column(DbType = "varchar(30)")]
+    public string Version { get; set; } = "1.0";
+
+    /// <summary>来源工艺单ID（复制时记录）</summary>
+    [Description("来源工艺单ID")]
+    [Column]
+    public long SourceSheetId { get; set; }
+
+    /// <summary>状态：0=草稿 1=已发布 2=已停用</summary>
+    [Description("状态：0=草稿 1=已发布 2=已停用")]
+    [Column]
+    public int Status { get; set; } = 0;
+
+    /// <summary>发布人</summary>
+    [Description("发布人")]
+    [Column(DbType = "varchar(50)")]
+    public string? Publisher { get; set; }
+
+    /// <summary>发布时间</summary>
+    [Description("发布时间")]
+    [Column]
+    public DateTime? PublishTime { get; set; }
+}
+
+/// <summary>工艺单明细（KV键值对）</summary>
+[Table(Name = "Process_SheetItem")]
+public class Process_SheetItem : BaseEntity
+{
+    /// <summary>工艺单ID</summary>
+    [Description("工艺单ID")]
+    [Column]
+    public long SheetId { get; set; }
+
+    /// <summary>指标ID（Process_Index）</summary>
+    [Description("指标ID")]
+    [Column]
+    public long IndexId { get; set; }
+
+    /// <summary>指标编码</summary>
+    [Description("指标编码")]
+    [Column(DbType = "varchar(50)")]
+    public string IndexCode { get; set; } = "";
+
+    /// <summary>指标名称</summary>
+    [Description("指标名称")]
+    [Column(DbType = "varchar(100)")]
+    public string IndexName { get; set; } = "";
+
+    /// <summary>指标值</summary>
+    [Description("指标值")]
+    [Column(DbType = "varchar(200)")]
+    public string IndexValue { get; set; } = "";
+
+    /// <summary>指标单位</summary>
+    [Description("指标单位")]
+    [Column(DbType = "varchar(20)")]
+    public string? Unit { get; set; }
+
+    /// <summary>排序号</summary>
+    [Description("排序号")]
+    [Column]
+    public int Sort { get; set; } = 0;
+}
diff --git a/server/src/F9MES.Domain/Qums/Qums_Entities.cs b/server/src/F9MES.Domain/Qums/Qums_Entities.cs
new file mode 100644
index 0000000..f5d52a8
--- /dev/null
+++ b/server/src/F9MES.Domain/Qums/Qums_Entities.cs
@@ -0,0 +1,134 @@
+using FreeSql.DataAnnotations;
+using F9MES.Common.Entities;
+using System.ComponentModel;
+
+namespace F9MES.Domain.Qums;
+
+/// <summary>
+/// 质量管理模块实体（Qums），表名前缀：Qums_
+/// </summary>
+
+/// <summary>粒数测定（单位重量茧粒数）</summary>
+[Table(Name = "Qums_GrainCount")]
+public class Qums_GrainCount : BaseEntity
+{
+    /// <summary>测定单号</summary>
+    [Description("测定单号")]
+    [Column(DbType = "varchar(50)")]
+    public string BillNo { get; set; } = "";
+
+    /// <summary>原料庄口ID</summary>
+    [Description("原料庄口ID")]
+    [Column]
+    public long ZhuangkouId { get; set; }
+
+    /// <summary>测定日期</summary>
+    [Description("测定日期")]
+    [Column]
+    public DateTime TestDate { get; set; }
+
+    /// <summary>样品重量（g）</summary>
+    [Description("样品重量（g）")]
+    [Column(DbType = "decimal(10,2)")]
+    public decimal SampleWeight { get; set; }
+
+    /// <summary>粒数</summary>
+    [Description("粒数")]
+    [Column]
+    public int GrainCount { get; set; }
+
+    /// <summary>每公斤粒数</summary>
+    [Description("每公斤粒数")]
+    [Column]
+    public int CountPerKg { get; set; }
+
+    /// <summary>测定员</summary>
+    [Description("测定员")]
+    [Column(DbType = "varchar(50)")]
+    public string? Tester { get; set; }
+}
+
+/// <summary>检查任务（日常/专项质量检查）</summary>
+[Table(Name = "Qums_CheckTask")]
+public class Qums_CheckTask : BaseEntity
+{
+    /// <summary>任务编号</summary>
+    [Description("任务编号")]
+    [Column(DbType = "varchar(50)")]
+    public string TaskNo { get; set; } = "";
+
+    /// <summary>任务名称</summary>
+    [Description("任务名称")]
+    [Column(DbType = "varchar(100)")]
+    public string Name { get; set; } = "";
+
+    /// <summary>检查类型：0=日常检查 1=专项检查 2=自检 3=互检</summary>
+    [Description("检查类型：0=日常 1=专项 2=自检 3=互检")]
+    [Column]
+    public int CheckType { get; set; } = 0;
+
+    /// <summary>检查范围（组织/工序）</summary>
+    [Description("检查范围")]
+    [Column(DbType = "varchar(200)")]
+    public string? Scope { get; set; }
+
+    /// <summary>计划检查日期</summary>
+    [Description("计划检查日期")]
+    [Column]
+    public DateTime? PlanDate { get; set; }
+
+    /// <summary>负责人</summary>
+    [Description("负责人")]
+    [Column(DbType = "varchar(50)")]
+    public string? Manager { get; set; }
+
+    /// <summary>状态：0=待检查 1=检查中 2=已完成 3=已关闭</summary>
+    [Description("状态：0=待检查 1=检查中 2=已完成 3=已关闭")]
+    [Column]
+    public int Status { get; set; } = 0;
+}
+
+/// <summary>检查表单（任务下的检查记录）</summary>
+[Table(Name = "Qums_CheckForm")]
+public class Qums_CheckForm : BaseEntity
+{
+    /// <summary>检查任务ID</summary>
+    [Description("检查任务ID")]
+    [Column]
+    public long TaskId { get; set; }
+
+    /// <summary>检查人</summary>
+    [Description("检查人")]
+    [Column(DbType = "varchar(50)")]
+    public string? Checker { get; set; }
+
+    /// <summary>检查日期</summary>
+    [Description("检查日期")]
+    [Column]
+    public DateTime CheckDate { get; set; }
+
+    /// <summary>检查结果：0=合格 1=整改 2=不合格</summary>
+    [Description("检查结果：0=合格 1=整改 2=不合格")]
+    [Column]
+    public int Result { get; set; } = 0;
+
+    /// <summary>检查内容JSON（项目+结果）</summary>
+    [Description("检查内容JSON")]
+    [Column(DbType = "text")]
+    public string? DataJson { get; set; }
+
+    /// <summary>问题描述</summary>
+    [Description("问题描述")]
+    [Column(DbType = "varchar(500)")]
+    public string? IssueDesc { get; set; }
+
+    /// <summary>整改要求</summary>
+    [Description("整改要求")]
+    [Column(DbType = "varchar(500)")]
+    public string? RectifyRequire { get; set; }
+
+    /// <summary>整改期限</summary>
+    [Description("整改期限")]
+    [Column]
+    public DateTime? RectifyDeadline { get; set; }
+}
diff --git a/server/src/F9MES.Domain/RawMaterial/RawMaterial_Entities.cs b/server/src/F9MES.Domain/RawMaterial/RawMaterial_Entities.cs
new file mode 100644
index 0000000..2a755fa
--- /dev/null
+++ b/server/src/F9MES.Domain/RawMaterial/RawMaterial_Entities.cs
@@ -0,0 +1,380 @@
+using FreeSql.DataAnnotations;
+using F9MES.Common.Entities;
+using System.ComponentModel;
+
+namespace F9MES.Domain.RawMaterial;
+
+/// <summary>
+/// 原料管理模块实体（RawMaterial），表名前缀：RawMaterial_
+/// 庄口：指原料蚕茧的批次化管理（A地某年某季原料）
+/// </summary>
+
+/// <summary>原料庄口（编号规则：YLZ+yyyyMMdd+3位流水，如 YLZ20260815-001）</summary>
+[Table(Name = "RawMaterial_Zhuangkou")]
+public class RawMaterial_Zhuangkou : BaseEntity
+{
+    /// <summary>庄口编号（自动生成 YLZ20260815-001）</summary>
+    [Description("庄口编号（YLZ+日期+流水）")]
+    [Column(DbType = "varchar(50)")]
+    public string Code { get; set; } = "";
+
+    /// <summary>庄口名称</summary>
+    [Description("庄口名称")]
+    [Column(DbType = "varchar(100)")]
+    public string Name { get; set; } = "";
+
+    /// <summary>庄口简称</summary>
+    [Description("庄口简称")]
+    [Column(DbType = "varchar(50)")]
+    public string? ShortName { get; set; }
+
+    /// <summary>产地</summary>
+    [Description("产地")]
+    [Column(DbType = "varchar(100)")]
+    public string? Origin { get; set; }
+
+    /// <summary>站点</summary>
+    [Description("站点")]
+    [Column(DbType = "varchar(100)")]
+    public string? Station { get; set; }
+
+    /// <summary>季别（如春茧/夏茧/秋茧）</summary>
+    [Description("季别")]
+    [Column(DbType = "varchar(30)")]
+    public string? Season { get; set; }
+
+    /// <summary>品种</summary>
+    [Description("品种")]
+    [Column(DbType = "varchar(50)")]
+    public string? Variety { get; set; }
+
+    /// <summary>原料类型：0=干茧 1=鲜茧</summary>
+    [Description("原料类型：0=干茧 1=鲜茧")]
+    [Column]
+    public int CocoonType { get; set; } = 0;
+
+    /// <summary>入库总净重（kg，由入库流水累加）</summary>
+    [Description("入库总净重（kg）")]
+    [Column(DbType = "decimal(14,2)")]
+    public decimal TotalInWeight { get; set; }
+
+    /// <summary>出库总净重（kg，由出库流水累加）</summary>
+    [Description("出库总净重（kg）")]
+    [Column(DbType = "decimal(14,2)")]
+    public decimal TotalOutWeight { get; set; }
+
+    /// <summary>当前库存（kg）</summary>
+    [Description("当前库存（kg）")]
+    [Column(DbType = "decimal(14,2)")]
+    public decimal StockWeight { get; set; }
+
+    /// <summary>状态：0=收茧中 1=已入库 2=翻包中 3=已领完</summary>
+    [Description("状态：0=收茧中 1=已入库 2=翻包中 3=已领完")]
+    [Column]
+    public int Status { get; set; } = 0;
+}
+
+/// <summary>原料入库单（磅码单过磅）</summary>
+[Table(Name = "RawMaterial_InStock")]
+public class RawMaterial_InStock : BaseEntity
+{
+    /// <summary>磅码单号</summary>
+    [Description("磅码单号")]
+    [Column(DbType = "varchar(50)")]
+    public string BillNo { get; set; } = "";
+
+    /// <summary>原料庄口ID</summary>
+    [Description("原料庄口ID")]
+    [Column]
+    public long ZhuangkouId { get; set; }
+
+    /// <summary>供应商ID（BaseCommon_Partner）</summary>
+    [Description("供应商ID")]
+    [Column]
+    public long SupplierId { get; set; }
+
+    /// <summary>毛重（kg）</summary>
+    [Description("毛重（kg）")]
+    [Column(DbType = "decimal(14,2)")]
+    public decimal GrossWeight { get; set; }
+
+    /// <summary>皮重（kg）</summary>
+    [Description("皮重（kg）")]
+    [Column(DbType = "decimal(14,2)")]
+    public decimal TareWeight { get; set; }
+
+    /// <summary>净重（kg）</summary>
+    [Description("净重（kg）")]
+    [Column(DbType = "decimal(14,2)")]
+    public decimal NetWeight { get; set; }
+
+    /// <summary>过磅日期</summary>
+    [Description("过磅日期")]
+    [Column]
+    public DateTime WeighDate { get; set; }
+
+    /// <summary>单价（元/kg）</summary>
+    [Description("单价（元/kg）")]
+    [Column(DbType = "decimal(12,4)")]
+    public decimal UnitPrice { get; set; }
+
+    /// <summary>金额</summary>
+    [Description("金额")]
+    [Column(DbType = "decimal(14,2)")]
+    public decimal Amount { get; set; }
+
+    /// <summary>过磅员</summary>
+    [Description("过磅员")]
+    [Column(DbType = "varchar(50)")]
+    public string? WeighMan { get; set; }
+
+    /// <summary>单据状态：0=草稿 1=已过磅 2=已入库 3=作废</summary>
+    [Description("单据状态：0=草稿 1=已过磅 2=已入库 3=作废")]
+    [Column]
+    public int Status { get; set; } = 0;
+}
+
+/// <summary>翻包计划</summary>
+[Table(Name = "RawMaterial_Repack")]
+public class RawMaterial_Repack : BaseEntity
+{
+    /// <summary>计划单号</summary>
+    [Description("计划单号")]
+    [Column(DbType = "varchar(50)")]
+    public string PlanNo { get; set; } = "";
+
+    /// <summary>原料庄口ID</summary>
+    [Description("原料庄口ID")]
+    [Column]
+    public long ZhuangkouId { get; set; }
+
+    /// <summary>计划翻包数量（包）</summary>
+    [Description("计划翻包数量（包）")]
+    [Column]
+    public int PlanCount { get; set; }
+
+    /// <summary>已完成数量（包）</summary>
+    [Description("已完成数量（包）")]
+    [Column]
+    public int DoneCount { get; set; }
+
+    /// <summary>计划开始日期</summary>
+    [Description("计划开始日期")]
+    [Column]
+    public DateTime? PlanStartDate { get; set; }
+
+    /// <summary>计划结束日期</summary>
+    [Description("计划结束日期")]
+    [Column]
+    public DateTime? PlanEndDate { get; set; }
+
+    /// <summary>执行状态：0=未开始 1=执行中 2=已完成 3=已取消</summary>
+    [Description("执行状态：0=未开始 1=执行中 2=已完成 3=已取消")]
+    [Column]
+    public int Status { get; set; } = 0;
+
+    /// <summary>负责人</summary>
+    [Description("负责人")]
+    [Column(DbType = "varchar(50)")]
+    public string? Manager { get; set; }
+}
+
+/// <summary>翻包执行记录</summary>
+[Table(Name = "RawMaterial_RepackResult")]
+public class RawMaterial_RepackResult : BaseEntity
+{
+    /// <summary>翻包计划ID</summary>
+    [Description("翻包计划ID")]
+    [Column]
+    public long RepackId { get; set; }
+
+    /// <summary>执行日期</summary>
+    [Description("执行日期")]
+    [Column]
+    public DateTime DoneDate { get; set; }
+
+    /// <summary>翻包数量（包）</summary>
+    [Description("翻包数量（包）")]
+    [Column]
+    public int Count { get; set; }
+
+    /// <summary>翻包前重量（kg）</summary>
+    [Description("翻包前重量（kg）")]
+    [Column(DbType = "decimal(14,2)")]
+    public decimal BeforeWeight { get; set; }
+
+    /// <summary>翻包后重量（kg）</summary>
+    [Description("翻包后重量（kg）")]
+    [Column(DbType = "decimal(14,2)")]
+    public decimal AfterWeight { get; set; }
+
+    /// <summary>损耗（kg）</summary>
+    [Description("损耗（kg）")]
+    [Column(DbType = "decimal(14,2)")]
+    public decimal Loss { get; set; }
+
+    /// <summary>执行班组/人员</summary>
+    [Description("执行班组")]
+    [Column(DbType = "varchar(50)")]
+    public string? Team { get; set; }
+}
+
+/// <summary>原料出库单（选剥茧车间领料出库）</summary>
+[Table(Name = "RawMaterial_OutStock")]
+public class RawMaterial_OutStock : BaseEntity
+{
+    /// <summary>出库单号</summary>
+    [Description("出库单号")]
+    [Column(DbType = "varchar(50)")]
+    public string BillNo { get; set; } = "";
+
+    /// <summary>原料庄口ID</summary>
+    [Description("原料庄口ID")]
+    [Column]
+    public long ZhuangkouId { get; set; }
+
+    /// <summary>领料车间/组织ID</summary>
+    [Description("领料车间/组织ID")]
+    [Column]
+    public long OutOrgId { get; set; }
+
+    /// <summary>出库重量（kg）</summary>
+    [Description("出库重量（kg）")]
+    [Column(DbType = "decimal(14,2)")]
+    public decimal OutWeight { get; set; }
+
+    /// <summary>领用人</summary>
+    [Description("领用人")]
+    [Column(DbType = "varchar(50)")]
+    public string? Receiver { get; set; }
+
+    /// <summary>出库日期</summary>
+    [Description("出库日期")]
+    [Column]
+    public DateTime OutDate { get; set; }
+
+    /// <summary>出库类型：0=领料 1=退货 2=报损</summary>
+    [Description("出库类型：0=领料 1=退货 2=报损")]
+    [Column]
+    public int OutType { get; set; } = 0;
+
+    /// <summary>单据状态：0=草稿 1=已出库 2=作废</summary>
+    [Description("单据状态：0=草稿 1=已出库 2=作废")]
+    [Column]
+    public int Status { get; set; } = 0;
+}
+
+/// <summary>原料库存（按庄口/仓库）</summary>
+[Table(Name = "RawMaterial_Stock")]
+public class RawMaterial_Stock : BaseEntity
+{
+    /// <summary>原料庄口ID</summary>
+    [Description("原料庄口ID")]
+    [Column]
+    public long ZhuangkouId { get; set; }
+
+    /// <summary>仓库ID（0=主仓库）</summary>
+    [Description("仓库ID（0=主仓库）")]
+    [Column]
+    public long WarehouseId { get; set; }
+
+    /// <summary>库存重量（kg）</summary>
+    [Description("库存重量（kg）")]
+    [Column(DbType = "decimal(14,2)")]
+    public decimal StockWeight { get; set; }
+
+    /// <summary>包数</summary>
+    [Description("包数")]
+    [Column]
+    public int PackageCount { get; set; }
+
+    /// <summary>预警下限（kg，低于则预警断料）</summary>
+    [Description("预警下限（kg）")]
+    [Column(DbType = "decimal(14,2)")]
+    public decimal WarnMin { get; set; }
+
+    /// <summary>最后入库时间</summary>
+    [Description("最后入库时间")]
+    [Column]
+    public DateTime? LastInTime { get; set; }
+
+    /// <summary>最后出库时间</summary>
+    [Description("最后出库时间")]
+    [Column]
+    public DateTime? LastOutTime { get; set; }
+}
+
+/// <summary>采购单</summary>
+[Table(Name = "RawMaterial_Purchase")]
+public class RawMaterial_Purchase : BaseEntity
+{
+    /// <summary>采购单号</summary>
+    [Description("采购单号")]
+    [Column(DbType = "varchar(50)")]
+    public string BillNo { get; set; } = "";
+
+    /// <summary>供应商ID（BaseCommon_Partner）</summary>
+    [Description("供应商ID")]
+    [Column]
+    public long SupplierId { get; set; }
+
+    /// <summary>采购日期</summary>
+    [Description("采购日期")]
+    [Column]
+    public DateTime PurchaseDate { get; set; }
+
+    /// <summary>采购类型：0=原料 1=五金</summary>
+    [Description("采购类型：0=原料 1=五金")]
+    [Column]
+    public int PurchaseType { get; set; } = 0;
+
+    /// <summary>合同编号</summary>
+    [Description("合同编号")]
+    [Column(DbType = "varchar(50)")]
+    public string? ContractNo { get; set; }
+
+    /// <summary>采购总额</summary>
+    [Description("采购总额")]
+    [Column(DbType = "decimal(14,2)")]
+    public decimal TotalAmount { get; set; }
+
+    /// <summary>单据状态：0=草稿 1=已审批 2=已入库 3=作废</summary>
+    [Description("单据状态：0=草稿 1=已审批 2=已入库 3=作废")]
+    [Column]
+    public int Status { get; set; } = 0;
+}
+
+/// <summary>采购明细</summary>
+[Table(Name = "RawMaterial_PurchaseItem")]
+public class RawMaterial_PurchaseItem : BaseEntity
+{
+    /// <summary>采购单ID</summary>
+    [Description("采购单ID")]
+    [Column]
+    public long PurchaseId { get; set; }
+
+    /// <summary>物资ID（BaseCommon_Material）</summary>
+    [Description("物资ID")]
+    [Column]
+    public long MaterialId { get; set; }
+
+    /// <summary>采购数量</summary>
+    [Description("采购数量")]
+    [Column(DbType = "decimal(14,2)")]
+    public decimal Quantity { get; set; }
+
+    /// <summary>单价</summary>
+    [Description("单价")]
+    [Column(DbType = "decimal(12,4)")]
+    public decimal UnitPrice { get; set; }
+
+    /// <summary>金额</summary>
+    [Description("金额")]
+    [Column(DbType = "decimal(14,2)")]
+    public decimal Amount { get; set; }
+
+    /// <summary>已入库数量</summary>
+    [Description("已入库数量")]
+    [Column(DbType = "decimal(14,2)")]
+    public decimal InQuantity { get; set; }
+}
diff --git a/server/src/F9MES.Domain/Sams/Sams_Entities.cs b/server/src/F9MES.Domain/Sams/Sams_Entities.cs
new file mode 100644
index 0000000..67c566e
--- /dev/null
+++ b/server/src/F9MES.Domain/Sams/Sams_Entities.cs
@@ -0,0 +1,289 @@
+using FreeSql.DataAnnotations;
+using F9MES.Common.Entities;
+using System.ComponentModel;
+
+namespace F9MES.Domain.Sams;
+
+/// <summary>
+/// 销售管理模块实体（Sams），表名前缀：Sams_
+/// </summary>
+
+/// <summary>客户档案</summary>
+[Table(Name = "Sams_Customer")]
+public class Sams_Customer : BaseEntity
+{
+    /// <summary>客户编码（唯一）</summary>
+    [Description("客户编码（唯一）")]
+    [Column(DbType = "varchar(50)")]
+    public string Code { get; set; } = "";
+
+    /// <summary>客户名称</summary>
+    [Description("客户名称")]
+    [Column(DbType = "varchar(200)")]
+    public string Name { get; set; } = "";
+
+    /// <summary>客户简称</summary>
+    [Description("客户简称")]
+    [Column(DbType = "varchar(100)")]
+    public string? ShortName { get; set; }
+
+    /// <summary>联系人</summary>
+    [Description("联系人")]
+    [Column(DbType = "varchar(50)")]
+    public string? Contact { get; set; }
+
+    /// <summary>联系电话</summary>
+    [Description("联系电话")]
+    [Column(DbType = "varchar(30)")]
+    public string? Phone { get; set; }
+
+    /// <summary>地址</summary>
+    [Description("地址")]
+    [Column(DbType = "varchar(255)")]
+    public string? Address { get; set; }
+
+    /// <summary>信用等级：0=普通 1=良好 2=优秀 3=黑名单</summary>
+    [Description("信用等级：0=普通 1=良好 2=优秀 3=黑名单")]
+    [Column]
+    public int CreditLevel { get; set; } = 0;
+
+    /// <summary>开户行</summary>
+    [Description("开户行")]
+    [Column(DbType = "varchar(100)")]
+    public string? BankName { get; set; }
+
+    /// <summary>银行账号</summary>
+    [Description("银行账号")]
+    [Column(DbType = "varchar(50)")]
+    public string? BankAccount { get; set; }
+
+    /// <summary>税号</summary>
+    [Description("税号")]
+    [Column(DbType = "varchar(50)")]
+    public string? TaxNo { get; set; }
+
+    /// <summary>是否启用</summary>
+    [Description("是否启用")]
+    [Column]
+    public int IsEnable { get; set; } = 1;
+}
+
+/// <summary>销售合同</summary>
+[Table(Name = "Sams_Contract")]
+public class Sams_Contract : BaseEntity
+{
+    /// <summary>合同编号（唯一）</summary>
+    [Description("合同编号（唯一）")]
+    [Column(DbType = "varchar(50)")]
+    public string ContractNo { get; set; } = "";
+
+    /// <summary>客户ID</summary>
+    [Description("客户ID")]
+    [Column]
+    public long CustomerId { get; set; }
+
+    /// <summary>合同名称</summary>
+    [Description("合同名称")]
+    [Column(DbType = "varchar(200)")]
+    public string Name { get; set; } = "";
+
+    /// <summary>签订日期</summary>
+    [Description("签订日期")]
+    [Column]
+    public DateTime SignDate { get; set; }
+
+    /// <summary>合同总额</summary>
+    [Description("合同总额")]
+    [Column(DbType = "decimal(14,2)")]
+    public decimal TotalAmount { get; set; }
+
+    /// <summary>已执行金额</summary>
+    [Description("已执行金额")]
+    [Column(DbType = "decimal(14,2)")]
+    public decimal ExecutedAmount { get; set; }
+
+    /// <summary>已回款金额</summary>
+    [Description("已回款金额")]
+    [Column(DbType = "decimal(14,2)")]
+    public decimal PaidAmount { get; set; }
+
+    /// <summary>合同状态：0=草稿 1=生效 2=执行中 3=已完成 4=已终止</summary>
+    [Description("合同状态：0=草稿 1=生效 2=执行中 3=已完成 4=已终止")]
+    [Column]
+    public int Status { get; set; } = 0;
+
+    /// <summary>备注</summary>
+    [Description("备注")]
+    [Column(DbType = "varchar(500)")]
+    public string? Memo { get; set; }
+}
+
+/// <summary>销售合同明细</summary>
+[Table(Name = "Sams_ContractItem")]
+public class Sams_ContractItem : BaseEntity
+{
+    /// <summary>合同ID</summary>
+    [Description("合同ID")]
+    [Column]
+    public long ContractId { get; set; }
+
+    /// <summary>规格ID（BaseCommon_SilkSpec）</summary>
+    [Description("规格ID")]
+    [Column]
+    public long SpecId { get; set; }
+
+    /// <summary>等级</summary>
+    [Description("等级")]
+    [Column(DbType = "varchar(20)")]
+    public string Grade { get; set; } = "";
+
+    /// <summary>合同数量（kg）</summary>
+    [Description("合同数量（kg）")]
+    [Column(DbType = "decimal(14,2)")]
+    public decimal Quantity { get; set; }
+
+    /// <summary>单价（元/kg）</summary>
+    [Description("单价（元/kg）")]
+    [Column(DbType = "decimal(12,4)")]
+    public decimal UnitPrice { get; set; }
+
+    /// <summary>金额</summary>
+    [Description("金额")]
+    [Column(DbType = "decimal(14,2)")]
+    public decimal Amount { get; set; }
+
+    /// <summary>已发货数量（kg）</summary>
+    [Description("已发货数量（kg）")]
+    [Column(DbType = "decimal(14,2)")]
+    public decimal ShippedQuantity { get; set; }
+}
+
+/// <summary>调拨/发货计划</summary>
+[Table(Name = "Sams_DispatchPlan")]
+public class Sams_DispatchPlan : BaseEntity
+{
+    /// <summary>计划单号</summary>
+    [Description("计划单号")]
+    [Column(DbType = "varchar(50)")]
+    public string PlanNo { get; set; } = "";
+
+    /// <summary>合同明细ID</summary>
+    [Description("合同明细ID")]
+    [Column]
+    public long ContractItemId { get; set; }
+
+    /// <summary>计划发货日期</summary>
+    [Description("计划发货日期")]
+    [Column]
+    public DateTime PlanDate { get; set; }
+
+    /// <summary>计划数量（kg）</summary>
+    [Description("计划数量（kg）")]
+    [Column(DbType = "decimal(14,2)")]
+    public decimal PlanQuantity { get; set; }
+
+    /// <summary>已发货数量（kg）</summary>
+    [Description("已发货数量（kg）")]
+    [Column(DbType = "decimal(14,2)")]
+    public decimal ShippedQuantity { get; set; }
+
+    /// <summary>状态：0=待发货 1=已发货 2=已完成 3=已取消</summary>
+    [Description("状态：0=待发货 1=已发货 2=已完成 3=已取消")]
+    [Column]
+    public int Status { get; set; } = 0;
+
+    /// <summary>承运商</summary>
+    [Description("承运商")]
+    [Column(DbType = "varchar(100)")]
+    public string? Carrier { get; set; }
+}
+
+/// <summary>回款记录</summary>
+[Table(Name = "Sams_Payment")]
+public class Sams_Payment : BaseEntity
+{
+    /// <summary>回款单号</summary>
+    [Description("回款单号")]
+    [Column(DbType = "varchar(50)")]
+    public string PaymentNo { get; set; } = "";
+
+    /// <summary>合同ID</summary>
+    [Description("合同ID")]
+    [Column]
+    public long ContractId { get; set; }
+
+    /// <summary>客户ID</summary>
+    [Description("客户ID")]
+    [Column]
+    public long CustomerId { get; set; }
+
+    /// <summary>回款日期</summary>
+    [Description("回款日期")]
+    [Column]
+    public DateTime PayDate { get; set; }
+
+    /// <summary>回款金额</summary>
+    [Description("回款金额")]
+    [Column(DbType = "decimal(14,2)")]
+    public decimal Amount { get; set; }
+
+    /// <summary>回款方式：0=银行转账 1=承兑汇票 2=现金 3=其他</summary>
+    [Description("回款方式：0=转账 1=承兑 2=现金 3=其他")]
+    [Column]
+    public int PayType { get; set; } = 0;
+
+    /// <summary>关联出库单号（可空）</summary>
+    [Description("关联出库单号")]
+    [Column(DbType = "varchar(50)")]
+    public string? OutBillNo { get; set; }
+
+    /// <summary>经办人</summary>
+    [Description("经办人")]
+    [Column(DbType = "varchar(50)")]
+    public string? Operator { get; set; }
+}
+
+/// <summary>发票管理</summary>
+[Table(Name = "Sams_Invoice")]
+public class Sams_Invoice : BaseEntity
+{
+    /// <summary>发票号码</summary>
+    [Description("发票号码")]
+    [Column(DbType = "varchar(50)")]
+    public string InvoiceNo { get; set; } = "";
+
+    /// <summary>合同ID</summary>
+    [Description("合同ID")]
+    [Column]
+    public long ContractId { get; set; }
+
+    /// <summary>客户ID</summary>
+    [Description("客户ID")]
+    [Column]
+    public long CustomerId { get; set; }
+
+    /// <summary>开票日期</summary>
+    [Description("开票日期")]
+    [Column]
+    public DateTime InvoiceDate { get; set; }
+
+    /// <summary>开票金额</summary>
+    [Description("开票金额")]
+    [Column(DbType = "decimal(14,2)")]
+    public decimal Amount { get; set; }
+
+    /// <summary>税率（%）</summary>
+    [Description("税率（%）")]
+    [Column(DbType = "decimal(6,2)")]
+    public decimal TaxRate { get; set; }
+
+    /// <summary>发票类型：0=增值税专票 1=普票 2=电子票</summary>
+    [Description("发票类型：0=专票 1=普票 2=电子票")]
+    [Column]
+    public int InvoiceType { get; set; } = 0;
+
+    /// <summary>状态：0=待开票 1=已开票 2=已作废</summary>
+    [Description("状态：0=待开票 1=已开票 2=已作废")]
+    [Column]
+    public int Status { get; set; } = 0;
+}
diff --git a/server/src/F9MES.Domain/WmsFu/WmsFu_Entities.cs b/server/src/F9MES.Domain/WmsFu/WmsFu_Entities.cs
new file mode 100644
index 0000000..9554b07
--- /dev/null
+++ b/server/src/F9MES.Domain/WmsFu/WmsFu_Entities.cs
@@ -0,0 +1,120 @@
+using FreeSql.DataAnnotations;
+using F9MES.Common.Entities;
+using System.ComponentModel;
+
+namespace F9MES.Domain.WmsFu;
+
+/// <summary>
+/// 副产品管理模块实体（WmsFu），表名前缀：WmsFu_
+/// 副产品：下脚茧/蛹衬/丝绵/废水废渣等
+/// </summary>
+
+/// <summary>副产品库存</summary>
+[Table(Name = "WmsFu_Stock")]
+public class WmsFu_Stock : BaseEntity
+{
+    /// <summary>副产品类型ID（BaseCommon_Material）</summary>
+    [Description("副产品类型ID（物资目录）")]
+    [Column]
+    public long MaterialId { get; set; }
+
+    /// <summary>来源庄口ID（工艺庄口，可为0汇总）</summary>
+    [Description("来源庄口ID")]
+    [Column]
+    public long ProcessZhuangkouId { get; set; }
+
+    /// <summary>库存重量（kg）</summary>
+    [Description("库存重量（kg）")]
+    [Column(DbType = "decimal(14,2)")]
+    public decimal StockWeight { get; set; }
+
+    /// <summary>预警下限（kg）</summary>
+    [Description("预警下限（kg）")]
+    [Column(DbType = "decimal(14,2)")]
+    public decimal WarnMin { get; set; }
+
+    /// <summary>最后变动时间</summary>
+    [Description("最后变动时间")]
+    [Column]
+    public DateTime? LastChangeTime { get; set; }
+}
+
+/// <summary>副产品入库单（选茧/缫丝工序产生）</summary>
+[Table(Name = "WmsFu_InStock")]
+public class WmsFu_InStock : BaseEntity
+{
+    /// <summary>入库单号</summary>
+    [Description("入库单号")]
+    [Column(DbType = "varchar(50)")]
+    public string BillNo { get; set; } = "";
+
+    /// <summary>副产品类型ID</summary>
+    [Description("副产品类型ID")]
+    [Column]
+    public long MaterialId { get; set; }
+
+    /// <summary>工艺庄口ID（来源）</summary>
+    [Description("工艺庄口ID（来源）")]
+    [Column]
+    public long ProcessZhuangkouId { get; set; }
+
+    /// <summary>入库日期</summary>
+    [Description("入库日期")]
+    [Column]
+    public DateTime InDate { get; set; }
+
+    /// <summary>入库重量（kg）</summary>
+    [Description("入库重量（kg）")]
+    [Column(DbType = "decimal(14,2)")]
+    public decimal NetWeight { get; set; }
+
+    /// <summary>来源工序：0=选茧 1=缫丝 2=复摇 3=其他</summary>
+    [Description("来源工序：0=选茧 1=缫丝 2=复摇 3=其他")]
+    [Column]
+    public int SourceProcess { get; set; } = 0;
+
+    /// <summary>状态：0=草稿 1=已入库 2=作废</summary>
+    [Description("状态：0=草稿 1=已入库 2=作废")]
+    [Column]
+    public int Status { get; set; } = 0;
+}
+
+/// <summary>副产品出库单（销售/再利用）</summary>
+[Table(Name = "WmsFu_OutStock")]
+public class WmsFu_OutStock : BaseEntity
+{
+    /// <summary>出库单号</summary>
+    [Description("出库单号")]
+    [Column(DbType = "varchar(50)")]
+    public string BillNo { get; set; } = "";
+
+    /// <summary>副产品类型ID</summary>
+    [Description("副产品类型ID")]
+    [Column]
+    public long MaterialId { get; set; }
+
+    /// <summary>客户ID（BaseCommon_Partner，销售时）</summary>
+    [Description("客户ID")]
+    [Column]
+    public long CustomerId { get; set; }
+
+    /// <summary>出库日期</summary>
+    [Description("出库日期")]
+    [Column]
+    public DateTime OutDate { get; set; }
+
+    /// <summary>出库重量（kg）</summary>
+    [Description("出库重量（kg）")]
+    [Column(DbType = "decimal(14,2)")]
+    public decimal NetWeight { get; set; }
+
+    /// <summary>出库类型：0=销售 1=再利用 2=报损</summary>
+    [Description("出库类型：0=销售 1=再利用 2=报损")]
+    [Column]
+    public int OutType { get; set; } = 0;
+
+    /// <summary>状态：0=草稿 1=已出库 2=作废</summary>
+    [Description("状态：0=草稿 1=已出库 2=作废")]
+    [Column]
+    public int Status { get; set; } = 0;
+}
diff --git a/server/src/F9MES.Domain/WmsWu/WmsWu_Entities.cs b/server/src/F9MES.Domain/WmsWu/WmsWu_Entities.cs
new file mode 100644
index 0000000..ef419da
--- /dev/null
+++ b/server/src/F9MES.Domain/WmsWu/WmsWu_Entities.cs
@@ -0,0 +1,284 @@
+using FreeSql.DataAnnotations;
+using F9MES.Common.Entities;
+using System.ComponentModel;
+
+namespace F9MES.Domain.WmsWu;
+
+/// <summary>
+/// 五金仓储模块实体（WmsWu），表名前缀：WmsWu_
+/// </summary>
+
+/// <summary>五金库存</summary>
+[Table(Name = "WmsWu_Stock")]
+public class WmsWu_Stock : BaseEntity
+{
+    /// <summary>物资ID（BaseCommon_Material）</summary>
+    [Description("物资ID")]
+    [Column]
+    public long MaterialId { get; set; }
+
+    /// <summary>仓库位置</summary>
+    [Description("仓库位置")]
+    [Column(DbType = "varchar(100)")]
+    public string? Location { get; set; }
+
+    /// <summary>库存数量</summary>
+    [Description("库存数量")]
+    [Column(DbType = "decimal(14,2)")]
+    public decimal StockQuantity { get; set; }
+
+    /// <summary>预警下限</summary>
+    [Description("预警下限")]
+    [Column(DbType = "decimal(14,2)")]
+    public decimal WarnMin { get; set; }
+
+    /// <summary>最后变动时间</summary>
+    [Description("最后变动时间")]
+    [Column]
+    public DateTime? LastChangeTime { get; set; }
+}
+
+/// <summary>五金入库单</summary>
+[Table(Name = "WmsWu_InStock")]
+public class WmsWu_InStock : BaseEntity
+{
+    /// <summary>入库单号</summary>
+    [Description("入库单号")]
+    [Column(DbType = "varchar(50)")]
+    public string BillNo { get; set; } = "";
+
+    /// <summary>供应商ID（BaseCommon_Partner）</summary>
+    [Description("供应商ID")]
+    [Column]
+    public long SupplierId { get; set; }
+
+    /// <summary>采购单ID（RawMaterial_Purchase）</summary>
+    [Description("采购单ID")]
+    [Column]
+    public long PurchaseId { get; set; }
+
+    /// <summary>入库日期</summary>
+    [Description("入库日期")]
+    [Column]
+    public DateTime InDate { get; set; }
+
+    /// <summary>入库金额</summary>
+    [Description("入库金额")]
+    [Column(DbType = "decimal(14,2)")]
+    public decimal TotalAmount { get; set; }
+
+    /// <summary>状态：0=草稿 1=已入库 2=作废</summary>
+    [Description("状态：0=草稿 1=已入库 2=作废")]
+    [Column]
+    public int Status { get; set; } = 0;
+}
+
+/// <summary>五金入库明细</summary>
+[Table(Name = "WmsWu_InStockItem")]
+public class WmsWu_InStockItem : BaseEntity
+{
+    /// <summary>入库单ID</summary>
+    [Description("入库单ID")]
+    [Column]
+    public long InStockId { get; set; }
+
+    /// <summary>物资ID</summary>
+    [Description("物资ID")]
+    [Column]
+    public long MaterialId { get; set; }
+
+    /// <summary>数量</summary>
+    [Description("数量")]
+    [Column(DbType = "decimal(14,2)")]
+    public decimal Quantity { get; set; }
+
+    /// <summary>单价</summary>
+    [Description("单价")]
+    [Column(DbType = "decimal(12,4)")]
+    public decimal UnitPrice { get; set; }
+
+    /// <summary>金额</summary>
+    [Description("金额")]
+    [Column(DbType = "decimal(14,2)")]
+    public decimal Amount { get; set; }
+}
+
+/// <summary>五金出库单（领料出库）</summary>
+[Table(Name = "WmsWu_OutStock")]
+public class WmsWu_OutStock : BaseEntity
+{
+    /// <summary>出库单号</summary>
+    [Description("出库单号")]
+    [Column(DbType = "varchar(50)")]
+    public string BillNo { get; set; } = "";
+
+    /// <summary>领料部门/组织ID</summary>
+    [Description("领料部门/组织ID")]
+    [Column]
+    public long OutOrgId { get; set; }
+
+    /// <summary>出库日期</summary>
+    [Description("出库日期")]
+    [Column]
+    public DateTime OutDate { get; set; }
+
+    /// <summary>领用人</summary>
+    [Description("领用人")]
+    [Column(DbType = "varchar(50)")]
+    public string? Receiver { get; set; }
+
+    /// <summary>状态：0=草稿 1=已出库 2=作废</summary>
+    [Description("状态：0=草稿 1=已出库 2=作废")]
+    [Column]
+    public int Status { get; set; } = 0;
+}
+
+/// <summary>五金出库明细</summary>
+[Table(Name = "WmsWu_OutStockItem")]
+public class WmsWu_OutStockItem : BaseEntity
+{
+    /// <summary>出库单ID</summary>
+    [Description("出库单ID")]
+    [Column]
+    public long OutStockId { get; set; }
+
+    /// <summary>物资ID</summary>
+    [Description("物资ID")]
+    [Column]
+    public long MaterialId { get; set; }
+
+    /// <summary>数量</summary>
+    [Description("数量")]
+    [Column(DbType = "decimal(14,2)")]
+    public decimal Quantity { get; set; }
+}
+
+/// <summary>五金采购计划</summary>
+[Table(Name = "WmsWu_PurchasePlan")]
+public class WmsWu_PurchasePlan : BaseEntity
+{
+    /// <summary>计划单号</summary>
+    [Description("计划单号")]
+    [Column(DbType = "varchar(50)")]
+    public string PlanNo { get; set; } = "";
+
+    /// <summary>计划名称</summary>
+    [Description("计划名称")]
+    [Column(DbType = "varchar(200)")]
+    public string Name { get; set; } = "";
+
+    /// <summary>计划采购金额</summary>
+    [Description("计划采购金额")]
+    [Column(DbType = "decimal(14,2)")]
+    public decimal PlanAmount { get; set; }
+
+    /// <summary>计划状态：0=草稿 1=审批中 2=已批准 3=已驳回 4=已完成</summary>
+    [Description("计划状态：0=草稿 1=审批中 2=已批准 3=已驳回 4=已完成")]
+    [Column]
+    public int Status { get; set; } = 0;
+}
+
+/// <summary>领料申请</summary>
+[Table(Name = "WmsWu_Apply")]
+public class WmsWu_Apply : BaseEntity
+{
+    /// <summary>申请单号</summary>
+    [Description("申请单号")]
+    [Column(DbType = "varchar(50)")]
+    public string ApplyNo { get; set; } = "";
+
+    /// <summary>申请部门/组织ID</summary>
+    [Description("申请部门/组织ID")]
+    [Column]
+    public long ApplyOrgId { get; set; }
+
+    /// <summary>申请人</summary>
+    [Description("申请人")]
+    [Column(DbType = "varchar(50)")]
+    public string? Applicant { get; set; }
+
+    /// <summary>申请日期</summary>
+    [Description("申请日期")]
+    [Column]
+    public DateTime ApplyDate { get; set; }
+
+    /// <summary>状态：0=草稿 1=审批中 2=已批准 3=已驳回 4=已领料</summary>
+    [Description("状态：0=草稿 1=审批中 2=已批准 3=已驳回 4=已领料")]
+    [Column]
+    public int Status { get; set; } = 0;
+}
+
+/// <summary>采购报销（发票登记报销）</summary>
+[Table(Name = "WmsWu_Reimburse")]
+public class WmsWu_Reimburse : BaseEntity
+{
+    /// <summary>报销单号</summary>
+    [Description("报销单号")]
+    [Column(DbType = "varchar(50)")]
+    public string BillNo { get; set; } = "";
+
+    /// <summary>采购单ID</summary>
+    [Description("采购单ID")]
+    [Column]
+    public long PurchaseId { get; set; }
+
+    /// <summary>报销金额</summary>
+    [Description("报销金额")]
+    [Column(DbType = "decimal(14,2)")]
+    public decimal Amount { get; set; }
+
+    /// <summary>发票号码</summary>
+    [Description("发票号码")]
+    [Column(DbType = "varchar(50)")]
+    public string? InvoiceNo { get; set; }
+
+    /// <summary>报销日期</summary>
+    [Description("报销日期")]
+    [Column]
+    public DateTime ReimburseDate { get; set; }
+
+    /// <summary>状态：0=待报销 1=已报销 2=已驳回</summary>
+    [Description("状态：0=待报销 1=已报销 2=已驳回")]
+    [Column]
+    public int Status { get; set; } = 0;
+}
+
+/// <summary>库存台账（进出明细流水）</summary>
+[Table(Name = "WmsWu_Ledger")]
+public class WmsWu_Ledger : BaseEntity
+{
+    /// <summary>物资ID</summary>
+    [Description("物资ID")]
+    [Column]
+    public long MaterialId { get; set; }
+
+    /// <summary>变动类型：0=入库 1=出库 2=盘盈 3=盘亏 4=调拨</summary>
+    [Description("变动类型：0=入库 1=出库 2=盘盈 3=盘亏 4=调拨")]
+    [Column]
+    public int ChangeType { get; set; } = 0;
+
+    /// <summary>变动数量（正负）</summary>
+    [Description("变动数量（正负）")]
+    [Column(DbType = "decimal(14,2)")]
+    public decimal ChangeQuantity { get; set; }
+
+    /// <summary>结存数量</summary>
+    [Description("结存数量")]
+    [Column(DbType = "decimal(14,2)")]
+    public decimal BalanceQuantity { get; set; }
+
+    /// <summary>关联单据号</summary>
+    [Description("关联单据号")]
+    [Column(DbType = "varchar(50)")]
+    public string? BillNo { get; set; }
+
+    /// <summary>变动时间</summary>
+    [Description("变动时间")]
+    [Column]
+    public DateTime ChangeTime { get; set; }
+
+    /// <summary>操作人</summary>
+    [Description("操作人")]
+    [Column(DbType = "varchar(50)")]
+    public string? Operator { get; set; }
+}
diff --git a/server/src/F9MES.Domain/WorkBench/WorkBench_Entities.cs b/server/src/F9MES.Domain/WorkBench/WorkBench_Entities.cs
new file mode 100644
index 0000000..4a6d93b
--- /dev/null
+++ b/server/src/F9MES.Domain/WorkBench/WorkBench_Entities.cs
@@ -0,0 +1,99 @@
+using FreeSql.DataAnnotations;
+using F9MES.Common.Entities;
+using System.ComponentModel;
+
+namespace F9MES.Domain.WorkBench;
+
+/// <summary>
+/// 工作台模块实体（WorkBench），表名前缀：WorkBench_
+/// </summary>
+
+/// <summary>工作台配置（待办/预警/生产看板/快捷操作聚合配置）</summary>
+[Table(Name = "WorkBench_Config")]
+public class WorkBench_Config : BaseEntity
+{
+    /// <summary>配置名称</summary>
+    [Description("配置名称")]
+    [Column(DbType = "varchar(100)")]
+    public string Name { get; set; } = "";
+
+    /// <summary>配置用户ID（0=全局默认）</summary>
+    [Description("配置用户ID（0=全局默认）")]
+    [Column]
+    public long UserId { get; set; }
+
+    /// <summary>待办事项配置JSON（业务单据待办提醒项）</summary>
+    [Description("待办事项配置JSON")]
+    [Column(DbType = "text")]
+    public string? TodoJson { get; set; }
+
+    /// <summary>预警配置JSON（库存/断料/设备预警）</summary>
+    [Description("预警配置JSON")]
+    [Column(DbType = "text")]
+    public string? WarnJson { get; set; }
+
+    /// <summary>看板配置JSON（生产数据展示项）</summary>
+    [Description("看板配置JSON")]
+    [Column(DbType = "text")]
+    public string? BoardJson { get; set; }
+
+    /// <summary>快捷操作配置JSON</summary>
+    [Description("快捷操作配置JSON")]
+    [Column(DbType = "text")]
+    public string? QuickActionJson { get; set; }
+
+    /// <summary>布局配置JSON（拖拽布局）</summary>
+    [Description("布局配置JSON")]
+    [Column(DbType = "text")]
+    public string? LayoutJson { get; set; }
+}
+
+/// <summary>待办事项</summary>
+[Table(Name = "WorkBench_Todo")]
+public class WorkBench_Todo : BaseEntity
+{
+    /// <summary>待办标题</summary>
+    [Description("待办标题")]
+    [Column(DbType = "varchar(200)")]
+    public string Title { get; set; } = "";
+
+    /// <summary>待办类型：0=审批 1=任务 2=预警 3=消息</summary>
+    [Description("待办类型：0=审批 1=任务 2=预警 3=消息")]
+    [Column]
+    public int TodoType { get; set; } = 0;
+
+    /// <summary>处理人ID</summary>
+    [Description("处理人ID")]
+    [Column]
+    public long UserId { get; set; }
+
+    /// <summary>关联业务单据号</summary>
+    [Description("关联业务单据号")]
+    [Column(DbType = "varchar(50)")]
+    public string? BillNo { get; set; }
+
+    /// <summary>关联业务模块</summary>
+    [Description("关联业务模块")]
+    [Column(DbType = "varchar(50)")]
+    public string? Module { get; set; }
+
+    /// <summary>状态：0=待处理 1=已处理 2=已忽略</summary>
+    [Description("状态：0=待处理 1=已处理 2=已忽略")]
+    [Column]
+    public int Status { get; set; } = 0;
+
+    /// <summary>优先级：0=普通 1=重要 2=紧急</summary>
+    [Description("优先级：0=普通 1=重要 2=紧急")]
+    [Column]
+    public int Priority { get; set; } = 0;
+
+    /// <summary>创建时间</summary>
+    [Description("创建时间")]
+    [Column]
+    public DateTime CreateTime { get; set; }
+
+    /// <summary>处理时间</summary>
+    [Description("处理时间")]
+    [Column]
+    public DateTime? HandleTime { get; set; }
+}
diff --git a/web/_check_core.ps1 b/web/_check_core.ps1
new file mode 100644
index 0000000..4051f59
--- /dev/null
+++ b/web/_check_core.ps1
@@ -0,0 +1,14 @@
+$login = Invoke-RestMethod -Uri "http://localhost:5210/api/auth/login" -Method Post -Body (@{ phone = "13800000000"; password = "123456" } | ConvertTo-Json) -ContentType "application/json"
+$h = @{ Authorization = "Bearer $($login.data.token)" }
+$tables = @("RawMaterial_Zhuangkou","RawMaterial_InStock","RawMaterial_Repack","RawMaterial_OutStock","RawMaterial_Stock","RawMaterial_Purchase","Process_Trial","Process_ProcessZhuangkou","Process_Sheet","ProXuan_Team","ProXuan_Daily","ProQian_Workshop","ProQian_Machine","ProQian_Schedule","ProHou_Daily","ProHou_SpoolLedger","Lims_Check","Lims_Denier","Lims_Moisture","Lims_GradeResult","Lims_Abnormal","Fims_Batch","Fims_Package","Fims_InStock","Fims_OutStock","Fims_Stock")
+foreach ($t in $tables) {
+  try {
+    $m = Invoke-RestMethod -Uri "http://localhost:5210/api/meta/table/$t" -Headers $h -TimeoutSec 20
+    $code = ($m.data.fields | Where-Object { $_.isCode } | ForEach-Object { $_.name }) -join ','
+    $refs = ($m.data.fields | Where-Object { $_.refTable } | ForEach-Object { $_.name + '>' + $_.refTable }) -join ','
+    $enumCount = @($m.data.fields | Where-Object { $_.options }).Count
+    Write-Output "$t | code=[$code] refs=[$refs] enums=$enumCount"
+  } catch {
+    Write-Output "$t | ERROR"
+  }
+}
diff --git a/web/_test_meta.ps1 b/web/_test_meta.ps1
new file mode 100644
index 0000000..eb02679
--- /dev/null
+++ b/web/_test_meta.ps1
@@ -0,0 +1,18 @@
+$ErrorActionPreference = 'Stop'
+$login = Invoke-RestMethod -Uri "http://localhost:5210/api/auth/login" -Method Post -Body (@{ phone = "13800000000"; password = "123456" } | ConvertTo-Json) -ContentType "application/json"
+$h = @{ Authorization = "Bearer $($login.data.token)" }
+Write-Output "=== GENCODE ==="
+foreach ($t in @(@("RawMaterial_Zhuangkou","Code"), @("Process_ProcessZhuangkou","Code"), @("Fims_Batch","BatchNo"), @("Lims_Check","CheckNo"))) {
+  $r = Invoke-RestMethod -Uri "http://localhost:5210/api/meta/gencode/$($t[0])/$($t[1])" -Method Post -Headers $h
+  Write-Output "  $($t[0]).$($t[1]) => $($r.data.value)"
+}
+Write-Output "=== REFS ==="
+foreach ($tb in @("ProXuan_Team","ProQian_Machine","Fims_Batch","RawMaterial_Zhuangkou","BaseCommon_Partner","HRS_Employee")) {
+  try {
+    $ref = Invoke-RestMethod -Uri "http://localhost:5210/api/meta/refs/$tb" -Headers $h -TimeoutSec 15
+    Write-Output "  $tb => $($ref.data.Count) items"
+  } catch {
+    Write-Output "  $tb => ERROR"
+  }
+}
+Write-Output "DONE"
diff --git a/web/index.html b/web/index.html
new file mode 100644
index 0000000..7cba1a1
--- /dev/null
+++ b/web/index.html
@@ -0,0 +1,13 @@
+<!DOCTYPE html>
+<html lang="zh-CN">
+  <head>
+    <meta charset="UTF-8" />
+    <link rel="icon" href="data:image/svg+xml,<svg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 100 100'><text y='.9em' font-size='90'>🧵</text></svg>" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>F9 智慧缫丝系统 MES</title>
+  </head>
+  <body>
+    <div id="app"></div>
+    <script type="module" src="/src/main.js"></script>
+  </body>
+</html>
diff --git a/web/package-lock.json b/web/package-lock.json
new file mode 100644
index 0000000..fc916fe
--- /dev/null
+++ b/web/package-lock.json
@@ -0,0 +1,2006 @@
+{
+  "name": "f9mes-web",
+  "version": "1.0.0",
+  "lockfileVersion": 3,
+  "requires": true,
+  "packages": {
+    "": {
+      "name": "f9mes-web",
+      "version": "1.0.0",
+      "dependencies": {
+        "@element-plus/icons-vue": "^2.3.1",
+        "axios": "^1.7.9",
+        "dayjs": "^1.11.13",
+        "echarts": "^5.6.0",
+        "element-plus": "^2.9.3",
+        "pinia": "^2.3.0",
+        "vue": "^3.5.13",
+        "vue-router": "^4.5.0"
+      },
+      "devDependencies": {
+        "@vitejs/plugin-vue": "^5.2.1",
+        "vite": "^6.0.7"
+      }
+    },
+    "node_modules/@babel/helper-string-parser": {
+      "version": "7.29.7",
+      "resolved": "https://registry.npmjs.org/@babel/helper-string-parser/-/helper-string-parser-7.29.7.tgz",
+      "integrity": "sha512-Pb5ijPrZ89GDH8223L4UP8i6QApWxs04RbPQJTeWDV0/keR2E36MeKnyr6LYmUUvqRRI+Iv87SuF1W6ErINzYw==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=6.9.0"
+      }
+    },
+    "node_modules/@babel/helper-validator-identifier": {
+      "version": "7.29.7",
+      "resolved": "https://registry.npmjs.org/@babel/helper-validator-identifier/-/helper-validator-identifier-7.29.7.tgz",
+      "integrity": "sha512-qehxGkRj55h/ff8EMaJ+cYhyaKlHIxqYDn682wQD7RNp9UujOQsHog2uS0r2vzr4pW+sXf90NeeayjcNaX3fFg==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=6.9.0"
+      }
+    },
+    "node_modules/@babel/parser": {
+      "version": "7.29.8",
+      "resolved": "https://registry.npmjs.org/@babel/parser/-/parser-7.29.8.tgz",
+      "integrity": "sha512-E8lTAYNB1KW+FH+VGJuZM1ioAx2E6oVlvQFRrf5P8ZZmsiJXYAD9vTFV7yyEURNzgh1dFqMZuO6tUwcARbqFCA==",
+      "license": "MIT",
+      "dependencies": {
+        "@babel/types": "^7.29.8"
+      },
+      "bin": {
+        "parser": "bin/babel-parser.js"
+      },
+      "engines": {
+        "node": ">=6.0.0"
+      }
+    },
+    "node_modules/@babel/types": {
+      "version": "7.29.8",
+      "resolved": "https://registry.npmjs.org/@babel/types/-/types-7.29.8.tgz",
+      "integrity": "sha512-Vj1jF3cPfxg7OAfoI7QnVKLoILlm2JF9pnVHrX8qx7AHMiYWT+NDAA7jChlNgRS4WTLc/fD1lXLmPixluj+3Gg==",
+      "license": "MIT",
+      "dependencies": {
+        "@babel/helper-string-parser": "^7.29.7",
+        "@babel/helper-validator-identifier": "^7.29.7"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      }
+    },
+    "node_modules/@ctrl/tinycolor": {
+      "version": "4.2.0",
+      "resolved": "https://registry.npmjs.org/@ctrl/tinycolor/-/tinycolor-4.2.0.tgz",
+      "integrity": "sha512-kzyuwOAQnXJNLS9PSyrk0CWk35nWJW/zl/6KvnTBMFK65gm7U1/Z5BqjxeapjZCIhQcM/DsrEmcbRwDyXyXK4A==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=14"
+      }
+    },
+    "node_modules/@element-plus/icons-vue": {
+      "version": "2.3.2",
+      "resolved": "https://registry.npmjs.org/@element-plus/icons-vue/-/icons-vue-2.3.2.tgz",
+      "integrity": "sha512-OzIuTaIfC8QXEPmJvB4Y4kw34rSXdCJzxcD1kFStBvr8bK6X1zQAYDo0CNMjojnfTqRQCJ0I7prlErcoRiET2A==",
+      "license": "MIT",
+      "peerDependencies": {
+        "vue": "^3.2.0"
+      }
+    },
+    "node_modules/@esbuild/aix-ppc64": {
+      "version": "0.25.12",
+      "resolved": "https://registry.npmjs.org/@esbuild/aix-ppc64/-/aix-ppc64-0.25.12.tgz",
+      "integrity": "sha512-Hhmwd6CInZ3dwpuGTF8fJG6yoWmsToE+vYgD4nytZVxcu1ulHpUQRAB1UJ8+N1Am3Mz4+xOByoQoSZf4D+CpkA==",
+      "cpu": [
+        "ppc64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "aix"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/android-arm": {
+      "version": "0.25.12",
+      "resolved": "https://registry.npmjs.org/@esbuild/android-arm/-/android-arm-0.25.12.tgz",
+      "integrity": "sha512-VJ+sKvNA/GE7Ccacc9Cha7bpS8nyzVv0jdVgwNDaR4gDMC/2TTRc33Ip8qrNYUcpkOHUT5OZ0bUcNNVZQ9RLlg==",
+      "cpu": [
+        "arm"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "android"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/android-arm64": {
+      "version": "0.25.12",
+      "resolved": "https://registry.npmjs.org/@esbuild/android-arm64/-/android-arm64-0.25.12.tgz",
+      "integrity": "sha512-6AAmLG7zwD1Z159jCKPvAxZd4y/VTO0VkprYy+3N2FtJ8+BQWFXU+OxARIwA46c5tdD9SsKGZ/1ocqBS/gAKHg==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "android"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/android-x64": {
+      "version": "0.25.12",
+      "resolved": "https://registry.npmjs.org/@esbuild/android-x64/-/android-x64-0.25.12.tgz",
+      "integrity": "sha512-5jbb+2hhDHx5phYR2By8GTWEzn6I9UqR11Kwf22iKbNpYrsmRB18aX/9ivc5cabcUiAT/wM+YIZ6SG9QO6a8kg==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "android"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/darwin-arm64": {
+      "version": "0.25.12",
+      "resolved": "https://registry.npmjs.org/@esbuild/darwin-arm64/-/darwin-arm64-0.25.12.tgz",
+      "integrity": "sha512-N3zl+lxHCifgIlcMUP5016ESkeQjLj/959RxxNYIthIg+CQHInujFuXeWbWMgnTo4cp5XVHqFPmpyu9J65C1Yg==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "darwin"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/darwin-x64": {
+      "version": "0.25.12",
+      "resolved": "https://registry.npmjs.org/@esbuild/darwin-x64/-/darwin-x64-0.25.12.tgz",
+      "integrity": "sha512-HQ9ka4Kx21qHXwtlTUVbKJOAnmG1ipXhdWTmNXiPzPfWKpXqASVcWdnf2bnL73wgjNrFXAa3yYvBSd9pzfEIpA==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "darwin"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/freebsd-arm64": {
+      "version": "0.25.12",
+      "resolved": "https://registry.npmjs.org/@esbuild/freebsd-arm64/-/freebsd-arm64-0.25.12.tgz",
+      "integrity": "sha512-gA0Bx759+7Jve03K1S0vkOu5Lg/85dou3EseOGUes8flVOGxbhDDh/iZaoek11Y8mtyKPGF3vP8XhnkDEAmzeg==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "freebsd"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/freebsd-x64": {
+      "version": "0.25.12",
+      "resolved": "https://registry.npmjs.org/@esbuild/freebsd-x64/-/freebsd-x64-0.25.12.tgz",
+      "integrity": "sha512-TGbO26Yw2xsHzxtbVFGEXBFH0FRAP7gtcPE7P5yP7wGy7cXK2oO7RyOhL5NLiqTlBh47XhmIUXuGciXEqYFfBQ==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "freebsd"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/linux-arm": {
+      "version": "0.25.12",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-arm/-/linux-arm-0.25.12.tgz",
+      "integrity": "sha512-lPDGyC1JPDou8kGcywY0YILzWlhhnRjdof3UlcoqYmS9El818LLfJJc3PXXgZHrHCAKs/Z2SeZtDJr5MrkxtOw==",
+      "cpu": [
+        "arm"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/linux-arm64": {
+      "version": "0.25.12",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-arm64/-/linux-arm64-0.25.12.tgz",
+      "integrity": "sha512-8bwX7a8FghIgrupcxb4aUmYDLp8pX06rGh5HqDT7bB+8Rdells6mHvrFHHW2JAOPZUbnjUpKTLg6ECyzvas2AQ==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/linux-ia32": {
+      "version": "0.25.12",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-ia32/-/linux-ia32-0.25.12.tgz",
+      "integrity": "sha512-0y9KrdVnbMM2/vG8KfU0byhUN+EFCny9+8g202gYqSSVMonbsCfLjUO+rCci7pM0WBEtz+oK/PIwHkzxkyharA==",
+      "cpu": [
+        "ia32"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/linux-loong64": {
+      "version": "0.25.12",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-loong64/-/linux-loong64-0.25.12.tgz",
+      "integrity": "sha512-h///Lr5a9rib/v1GGqXVGzjL4TMvVTv+s1DPoxQdz7l/AYv6LDSxdIwzxkrPW438oUXiDtwM10o9PmwS/6Z0Ng==",
+      "cpu": [
+        "loong64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/linux-mips64el": {
+      "version": "0.25.12",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-mips64el/-/linux-mips64el-0.25.12.tgz",
+      "integrity": "sha512-iyRrM1Pzy9GFMDLsXn1iHUm18nhKnNMWscjmp4+hpafcZjrr2WbT//d20xaGljXDBYHqRcl8HnxbX6uaA/eGVw==",
+      "cpu": [
+        "mips64el"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/linux-ppc64": {
+      "version": "0.25.12",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-ppc64/-/linux-ppc64-0.25.12.tgz",
+      "integrity": "sha512-9meM/lRXxMi5PSUqEXRCtVjEZBGwB7P/D4yT8UG/mwIdze2aV4Vo6U5gD3+RsoHXKkHCfSxZKzmDssVlRj1QQA==",
+      "cpu": [
+        "ppc64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/linux-riscv64": {
+      "version": "0.25.12",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-riscv64/-/linux-riscv64-0.25.12.tgz",
+      "integrity": "sha512-Zr7KR4hgKUpWAwb1f3o5ygT04MzqVrGEGXGLnj15YQDJErYu/BGg+wmFlIDOdJp0PmB0lLvxFIOXZgFRrdjR0w==",
+      "cpu": [
+        "riscv64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/linux-s390x": {
+      "version": "0.25.12",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-s390x/-/linux-s390x-0.25.12.tgz",
+      "integrity": "sha512-MsKncOcgTNvdtiISc/jZs/Zf8d0cl/t3gYWX8J9ubBnVOwlk65UIEEvgBORTiljloIWnBzLs4qhzPkJcitIzIg==",
+      "cpu": [
+        "s390x"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/linux-x64": {
+      "version": "0.25.12",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-x64/-/linux-x64-0.25.12.tgz",
+      "integrity": "sha512-uqZMTLr/zR/ed4jIGnwSLkaHmPjOjJvnm6TVVitAa08SLS9Z0VM8wIRx7gWbJB5/J54YuIMInDquWyYvQLZkgw==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/netbsd-arm64": {
+      "version": "0.25.12",
+      "resolved": "https://registry.npmjs.org/@esbuild/netbsd-arm64/-/netbsd-arm64-0.25.12.tgz",
+      "integrity": "sha512-xXwcTq4GhRM7J9A8Gv5boanHhRa/Q9KLVmcyXHCTaM4wKfIpWkdXiMog/KsnxzJ0A1+nD+zoecuzqPmCRyBGjg==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "netbsd"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/netbsd-x64": {
+      "version": "0.25.12",
+      "resolved": "https://registry.npmjs.org/@esbuild/netbsd-x64/-/netbsd-x64-0.25.12.tgz",
+      "integrity": "sha512-Ld5pTlzPy3YwGec4OuHh1aCVCRvOXdH8DgRjfDy/oumVovmuSzWfnSJg+VtakB9Cm0gxNO9BzWkj6mtO1FMXkQ==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "netbsd"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/openbsd-arm64": {
+      "version": "0.25.12",
+      "resolved": "https://registry.npmjs.org/@esbuild/openbsd-arm64/-/openbsd-arm64-0.25.12.tgz",
+      "integrity": "sha512-fF96T6KsBo/pkQI950FARU9apGNTSlZGsv1jZBAlcLL1MLjLNIWPBkj5NlSz8aAzYKg+eNqknrUJ24QBybeR5A==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "openbsd"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/openbsd-x64": {
+      "version": "0.25.12",
+      "resolved": "https://registry.npmjs.org/@esbuild/openbsd-x64/-/openbsd-x64-0.25.12.tgz",
+      "integrity": "sha512-MZyXUkZHjQxUvzK7rN8DJ3SRmrVrke8ZyRusHlP+kuwqTcfWLyqMOE3sScPPyeIXN/mDJIfGXvcMqCgYKekoQw==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "openbsd"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/openharmony-arm64": {
+      "version": "0.25.12",
+      "resolved": "https://registry.npmjs.org/@esbuild/openharmony-arm64/-/openharmony-arm64-0.25.12.tgz",
+      "integrity": "sha512-rm0YWsqUSRrjncSXGA7Zv78Nbnw4XL6/dzr20cyrQf7ZmRcsovpcRBdhD43Nuk3y7XIoW2OxMVvwuRvk9XdASg==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "openharmony"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/sunos-x64": {
+      "version": "0.25.12",
+      "resolved": "https://registry.npmjs.org/@esbuild/sunos-x64/-/sunos-x64-0.25.12.tgz",
+      "integrity": "sha512-3wGSCDyuTHQUzt0nV7bocDy72r2lI33QL3gkDNGkod22EsYl04sMf0qLb8luNKTOmgF/eDEDP5BFNwoBKH441w==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "sunos"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/win32-arm64": {
+      "version": "0.25.12",
+      "resolved": "https://registry.npmjs.org/@esbuild/win32-arm64/-/win32-arm64-0.25.12.tgz",
+      "integrity": "sha512-rMmLrur64A7+DKlnSuwqUdRKyd3UE7oPJZmnljqEptesKM8wx9J8gx5u0+9Pq0fQQW8vqeKebwNXdfOyP+8Bsg==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/win32-ia32": {
+      "version": "0.25.12",
+      "resolved": "https://registry.npmjs.org/@esbuild/win32-ia32/-/win32-ia32-0.25.12.tgz",
+      "integrity": "sha512-HkqnmmBoCbCwxUKKNPBixiWDGCpQGVsrQfJoVGYLPT41XWF8lHuE5N6WhVia2n4o5QK5M4tYr21827fNhi4byQ==",
+      "cpu": [
+        "ia32"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/win32-x64": {
+      "version": "0.25.12",
+      "resolved": "https://registry.npmjs.org/@esbuild/win32-x64/-/win32-x64-0.25.12.tgz",
+      "integrity": "sha512-alJC0uCZpTFrSL0CCDjcgleBXPnCrEAhTBILpeAp7M/OFgoqtAetfBzX0xM00MUsVVPpVjlPuMbREqnZCXaTnA==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@floating-ui/core": {
+      "version": "1.8.0",
+      "resolved": "https://registry.npmjs.org/@floating-ui/core/-/core-1.8.0.tgz",
+      "integrity": "sha512-0CIZ5itps/8x7BG8dEIhs53BvCUH2PCoogtakwRTut+Arm58sJooJ0AuZhLw2HJYIR5cMLNPBSS728sPho2khQ==",
+      "license": "MIT",
+      "dependencies": {
+        "@floating-ui/utils": "^0.2.12"
+      }
+    },
+    "node_modules/@floating-ui/dom": {
+      "version": "1.8.0",
+      "resolved": "https://registry.npmjs.org/@floating-ui/dom/-/dom-1.8.0.tgz",
+      "integrity": "sha512-yXSrzeHZBTZadLOlfyhCkJHNeLJnHRnRInwdZ40L7ZiaAtrBwoYlsDrX3v5zB1Utk7CLfzcOVnVVWoXEky7Ceg==",
+      "license": "MIT",
+      "dependencies": {
+        "@floating-ui/core": "^1.8.0",
+        "@floating-ui/utils": "^0.2.12"
+      }
+    },
+    "node_modules/@floating-ui/utils": {
+      "version": "0.2.12",
+      "resolved": "https://registry.npmjs.org/@floating-ui/utils/-/utils-0.2.12.tgz",
+      "integrity": "sha512-HpCo8tmWzLVad5s2d19EhAz5zqrrQ6s69qd6moPMQvkOuSwDT1YgRfWSVuc4ennqrgv3OHppiOGMQ7oC13yIww==",
+      "license": "MIT"
+    },
+    "node_modules/@jridgewell/sourcemap-codec": {
+      "version": "1.5.5",
+      "resolved": "https://registry.npmjs.org/@jridgewell/sourcemap-codec/-/sourcemap-codec-1.5.5.tgz",
+      "integrity": "sha512-cYQ9310grqxueWbl+WuIUIaiUaDcj7WOq5fVhEljNVgRfOUhY9fy2zTvfoqWsnebh8Sl70VScFbICvJnLKB0Og==",
+      "license": "MIT"
+    },
+    "node_modules/@napi-rs/lzma-linux-x64-gnu": {
+      "version": "1.5.1",
+      "resolved": "https://registry.npmjs.org/@napi-rs/lzma-linux-x64-gnu/-/lzma-linux-x64-gnu-1.5.1.tgz",
+      "integrity": "sha512-oTXEIha4SsuXdTA4Iyskj0kpdx2yVXdhd75c2v3xGrHFfVMsbhTPZU/nMPL4sWKo4pBHm3aucLaqGlF696dTyQ==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "libc": [
+        "glibc"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": "^22.20 || ^24.12 || >=25"
+      }
+    },
+    "node_modules/@popperjs/core": {
+      "name": "@sxzz/popperjs-es",
+      "version": "2.11.8",
+      "resolved": "https://registry.npmjs.org/@sxzz/popperjs-es/-/popperjs-es-2.11.8.tgz",
+      "integrity": "sha512-wOwESXvvED3S8xBmcPWHs2dUuzrE4XiZeFu7e1hROIJkm02a49N120pmOXxY33sBb6hArItm5W5tcg1cBtV+HQ==",
+      "license": "MIT",
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/popperjs"
+      }
+    },
+    "node_modules/@rollup/rollup-android-arm-eabi": {
+      "version": "4.62.4",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-android-arm-eabi/-/rollup-android-arm-eabi-4.62.4.tgz",
+      "integrity": "sha512-RrPokAb7dmbxFoeO3TloqHyOjgye8RkBhSqmp4aJMIex4c9r46ZstPnleDQOq1t46VOVjwIuwNogIqbodV1Vvg==",
+      "cpu": [
+        "arm"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "android"
+      ]
+    },
+    "node_modules/@rollup/rollup-android-arm64": {
+      "version": "4.62.4",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-android-arm64/-/rollup-android-arm64-4.62.4.tgz",
+      "integrity": "sha512-JKuJc+pnpks2pjy7L/N3v/cAkZxYlnmuZoD840ldbMI5KDbC4iO9NKwPKYdjYFCMAIIlBzYSFHxIJVYzRo2/8A==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "android"
+      ]
+    },
+    "node_modules/@rollup/rollup-darwin-arm64": {
+      "version": "4.62.4",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-darwin-arm64/-/rollup-darwin-arm64-4.62.4.tgz",
+      "integrity": "sha512-krw5uS2STmvJ02x0uTXHbqQNuz+9eZ1iw+qXk9dmW2gvV4jV7O2hEoOnuhFrpOPiel1mBFtqbxYZZtC46hXLOw==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "darwin"
+      ]
+    },
+    "node_modules/@rollup/rollup-darwin-x64": {
+      "version": "4.62.4",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-darwin-x64/-/rollup-darwin-x64-4.62.4.tgz",
+      "integrity": "sha512-wsTxtgApb4PrOsNJIm0FZ1h3WvCC+k9uxLJ4ad75hgoS4NiRes2SoJFlDAyMwiUY8IssDqGcHbXuN0sx1tfF1A==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "darwin"
+      ]
+    },
+    "node_modules/@rollup/rollup-freebsd-arm64": {
+      "version": "4.62.4",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-freebsd-arm64/-/rollup-freebsd-arm64-4.62.4.tgz",
+      "integrity": "sha512-GUOnQlyZe3yAXhWOtOMsn5Qkrv5E5mZXa0thbARWi5Ei2szlVXJFQhddZ4HbAzh8q92w5twp+CQvs/eFanz9YQ==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "freebsd"
+      ]
+    },
+    "node_modules/@rollup/rollup-freebsd-x64": {
+      "version": "4.62.4",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-freebsd-x64/-/rollup-freebsd-x64-4.62.4.tgz",
+      "integrity": "sha512-/Y7f3QuxjzPKsjA/rfEDa3+0vXqyjmJ50Ln8dPpCmWkKTrUoWHG1cWhTqaAMLob2m2nESWuC7yGrREz019Ztqg==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "freebsd"
+      ]
+    },
+    "node_modules/@rollup/rollup-linux-arm-gnueabihf": {
+      "version": "4.62.4",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm-gnueabihf/-/rollup-linux-arm-gnueabihf-4.62.4.tgz",
+      "integrity": "sha512-81wiiX3v7aqy+T+bT61TJ78yJjRquqFFTTbAPt08imfQQzkPIW8t6aJbkTagtCCrXMNc9D66+geqlK7ydLPNqA==",
+      "cpu": [
+        "arm"
+      ],
+      "dev": true,
+      "libc": [
+        "glibc"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@rollup/rollup-linux-arm-musleabihf": {
+      "version": "4.62.4",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm-musleabihf/-/rollup-linux-arm-musleabihf-4.62.4.tgz",
+      "integrity": "sha512-9kmDIvNZqdoHOBZgNtpTBeLWYO/LVipM3H/j62P8848/l/VPEQL6N3uxU9pvP1oZAsXyC2MEnFP3ovRjo7WYNQ==",
+      "cpu": [
+        "arm"
+      ],
+      "dev": true,
+      "libc": [
+        "musl"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@rollup/rollup-linux-arm64-gnu": {
+      "version": "4.62.4",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm64-gnu/-/rollup-linux-arm64-gnu-4.62.4.tgz",
+      "integrity": "sha512-CcnXHWnXg69g+DX5VWL3FHts3qMRN2uVEHX+BZvGLdd07/gXkn3ePjYtO1LDJvxkGKVHMclKBRa1QUTH+6toYQ==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "libc": [
+        "glibc"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@rollup/rollup-linux-arm64-musl": {
+      "version": "4.62.4",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm64-musl/-/rollup-linux-arm64-musl-4.62.4.tgz",
+      "integrity": "sha512-iFOibiHnTRuhrWLlRsOQFdZJJIa7S8OwkneJr4ocALP16u5yk6lWLINFwhHaEqBFMsKDUZofLkGos7+CPzGB3g==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "libc": [
+        "musl"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@rollup/rollup-linux-loong64-gnu": {
+      "version": "4.62.4",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-loong64-gnu/-/rollup-linux-loong64-gnu-4.62.4.tgz",
+      "integrity": "sha512-XnWYMI7euHlb5a871xPja+Gm7DRCFU+FGRrtS2sMq9N8FvqtpagUy6gD4YOemC5MRk9xbh8+jYMEJbigFQwsgA==",
+      "cpu": [
+        "loong64"
+      ],
+      "dev": true,
+      "libc": [
+        "glibc"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@rollup/rollup-linux-loong64-musl": {
+      "version": "4.62.4",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-loong64-musl/-/rollup-linux-loong64-musl-4.62.4.tgz",
+      "integrity": "sha512-qGDAlO0U8xedCcsdRm9oaoQY8DAx/QT7uIxJWhCdx0ceIWX783UC9QSYkdpzAe29wNiVfp24+bZdQmn49o45SQ==",
+      "cpu": [
+        "loong64"
+      ],
+      "dev": true,
+      "libc": [
+        "musl"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@rollup/rollup-linux-ppc64-gnu": {
+      "version": "4.62.4",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-ppc64-gnu/-/rollup-linux-ppc64-gnu-4.62.4.tgz",
+      "integrity": "sha512-ru4H6ezD7ysA5EiEK6qkkaEb4modH8CTej6kUy/gQi20u3kB3G7Zn8snXXkeJSCOFKG/rbPPtM/+9Wgas1961w==",
+      "cpu": [
+        "ppc64"
+      ],
+      "dev": true,
+      "libc": [
+        "glibc"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@rollup/rollup-linux-ppc64-musl": {
+      "version": "4.62.4",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-ppc64-musl/-/rollup-linux-ppc64-musl-4.62.4.tgz",
+      "integrity": "sha512-2W4MO5WQVJnbJaZdvDb9rhBDuFU1nKIepPFpJUBsTh2k1YY2g+ODViaWuyOAjQ5cOP7NvrvLzt3wvHOoiAvc7w==",
+      "cpu": [
+        "ppc64"
+      ],
+      "dev": true,
+      "libc": [
+        "musl"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@rollup/rollup-linux-riscv64-gnu": {
+      "version": "4.62.4",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-riscv64-gnu/-/rollup-linux-riscv64-gnu-4.62.4.tgz",
+      "integrity": "sha512-+fxjfuoAmVMCYV5QyjoIpu0cp5DOiOTeqYFk1AVaxGr+/ravWLX89XfQmptsoWcaVy/TGf2hexzbUOrCQIL1CQ==",
+      "cpu": [
+        "riscv64"
+      ],
+      "dev": true,
+      "libc": [
+        "glibc"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@rollup/rollup-linux-riscv64-musl": {
+      "version": "4.62.4",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-riscv64-musl/-/rollup-linux-riscv64-musl-4.62.4.tgz",
+      "integrity": "sha512-jTn8JfHGL4djjFxPuM06LmNUJDsst2jeVlsd9OmIH6zc5sC9K6rIuO4YajXatLUpBmBKl6b35ro1QZocLi+tcA==",
+      "cpu": [
+        "riscv64"
+      ],
+      "dev": true,
+      "libc": [
+        "musl"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@rollup/rollup-linux-s390x-gnu": {
+      "version": "4.62.4",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-s390x-gnu/-/rollup-linux-s390x-gnu-4.62.4.tgz",
+      "integrity": "sha512-oCJCJL4pXsoDcP2QZ+JVlPTIRc6266zsIaeJJsWImmF7HO0W8nb6HuSgZlMWxJwaPf8ehbSw8yo0EUw925hKsA==",
+      "cpu": [
+        "s390x"
+      ],
+      "dev": true,
+      "libc": [
+        "glibc"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@rollup/rollup-linux-x64-gnu": {
+      "version": "4.62.4",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-x64-gnu/-/rollup-linux-x64-gnu-4.62.4.tgz",
+      "integrity": "sha512-W69hukhZ3KKNRCaMIEzKvcFye42hh0FE1+YoYaf5+Ikacuftoco6yO/xouz0hc5d5W/s3yBro5jRiuEE/Q5vUw==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "libc": [
+        "glibc"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@rollup/rollup-linux-x64-musl": {
+      "version": "4.62.4",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-x64-musl/-/rollup-linux-x64-musl-4.62.4.tgz",
+      "integrity": "sha512-qiXbGG2jkjXhzXpsFZSR2Xpb8DN/UaxYsbb/STbuR/6fpaDgRmmaq1B/LmtF2wQFOFOSsK2jdE0RZ3a0zHn4QA==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "libc": [
+        "musl"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@rollup/rollup-openbsd-x64": {
+      "version": "4.62.4",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-openbsd-x64/-/rollup-openbsd-x64-4.62.4.tgz",
+      "integrity": "sha512-nWeM//hxv8mIo6jD7Hu4o48DVmV9pbV6gsKaWU+4NFyqHoPKwrkRiZGLKUhOBk8qNmDmpwFtPKg80Bo/Tn4xiQ==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "openbsd"
+      ]
+    },
+    "node_modules/@rollup/rollup-openharmony-arm64": {
+      "version": "4.62.4",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-openharmony-arm64/-/rollup-openharmony-arm64-4.62.4.tgz",
+      "integrity": "sha512-s62SQ/vgsRSvMwDkOEfTqfgASF0f26ZNaQuTA6Aok5lrikf89yI2W0gFHvZb2Jpgc6N8JnOKZgCK2iciO3CsxQ==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "openharmony"
+      ]
+    },
+    "node_modules/@rollup/rollup-win32-arm64-msvc": {
+      "version": "4.62.4",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-arm64-msvc/-/rollup-win32-arm64-msvc-4.62.4.tgz",
+      "integrity": "sha512-J6wGf8TVGbXJq+HH+ttTvrcfNKPbuZecV6KT1B8I18BC5IURUh5kl4Yl5OEP5eFIUoI5BWxCsyYMhFsDx8kekw==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ]
+    },
+    "node_modules/@rollup/rollup-win32-ia32-msvc": {
+      "version": "4.62.4",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-ia32-msvc/-/rollup-win32-ia32-msvc-4.62.4.tgz",
+      "integrity": "sha512-zmfrQd/0wu6oJs8Vq8KwY/YtsKSsLtKe/HwAP4Wqy8LhWjeT55fHRAkOhYQ12wI3ayS4Tt12d5CDRD7N96SAYQ==",
+      "cpu": [
+        "ia32"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ]
+    },
+    "node_modules/@rollup/rollup-win32-x64-gnu": {
+      "version": "4.62.4",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-x64-gnu/-/rollup-win32-x64-gnu-4.62.4.tgz",
+      "integrity": "sha512-qPzHqdj9rfUD+w79dtE07zi/kFwKyCJqplp5K5ygeLTp7jLpAoc16OAH39HSmRC9UpozaecsleI8uAdEj6v2yw==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ]
+    },
+    "node_modules/@rollup/rollup-win32-x64-msvc": {
+      "version": "4.62.4",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-x64-msvc/-/rollup-win32-x64-msvc-4.62.4.tgz",
+      "integrity": "sha512-zD6NdeWEByGE9QF9vCrlJ5YQB4oq9q91kPZS37Jwj5hOkvR1lTBSpsKhKDw4IJtbQ35LsTS1HD9DZYGKIshU1Q==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ]
+    },
+    "node_modules/@types/estree": {
+      "version": "1.0.9",
+      "resolved": "https://registry.npmjs.org/@types/estree/-/estree-1.0.9.tgz",
+      "integrity": "sha512-GhdPgy1el4/ImP05X05Uw4cw2/M93BCUmnEvWZNStlCzEKME4Fkk+YpoA5OiHNQmoS7Cafb8Xa3Pya8m1Qrzeg==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/@types/lodash": {
+      "version": "4.17.25",
+      "resolved": "https://registry.npmjs.org/@types/lodash/-/lodash-4.17.25.tgz",
+      "integrity": "sha512-+K1NIO8I+F9/wNulfVvu23QYd0Pe9/OCqRrim4NoYIf1VoEDL90Ve4ClzpyqBLc7NpGGWRvYNCKZ1BE/Jpf8dQ==",
+      "license": "MIT"
+    },
+    "node_modules/@types/lodash-es": {
+      "version": "4.17.12",
+      "resolved": "https://registry.npmjs.org/@types/lodash-es/-/lodash-es-4.17.12.tgz",
+      "integrity": "sha512-0NgftHUcV4v34VhXm8QBSftKVXtbkBG3ViCjs6+eJ5a6y6Mi/jiFGPc1sC7QK+9BFhWrURE3EOggmWaSxL9OzQ==",
+      "license": "MIT",
+      "dependencies": {
+        "@types/lodash": "*"
+      }
+    },
+    "node_modules/@types/web-bluetooth": {
+      "version": "0.0.21",
+      "resolved": "https://registry.npmjs.org/@types/web-bluetooth/-/web-bluetooth-0.0.21.tgz",
+      "integrity": "sha512-oIQLCGWtcFZy2JW77j9k8nHzAOpqMHLQejDA48XXMWH6tjCQHz5RCFz1bzsmROyL6PUm+LLnUiI4BCn221inxA==",
+      "license": "MIT"
+    },
+    "node_modules/@vitejs/plugin-vue": {
+      "version": "5.2.4",
+      "resolved": "https://registry.npmjs.org/@vitejs/plugin-vue/-/plugin-vue-5.2.4.tgz",
+      "integrity": "sha512-7Yx/SXSOcQq5HiiV3orevHUFn+pmMB4cgbEkDYgnkUWb0WfeQ/wa2yFv6D5ICiCQOVpjA7vYDXrC7AGO8yjDHA==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": "^18.0.0 || >=20.0.0"
+      },
+      "peerDependencies": {
+        "vite": "^5.0.0 || ^6.0.0",
+        "vue": "^3.2.25"
+      }
+    },
+    "node_modules/@vue/compiler-core": {
+      "version": "3.5.41",
+      "resolved": "https://registry.npmjs.org/@vue/compiler-core/-/compiler-core-3.5.41.tgz",
+      "integrity": "sha512-q0Xtv/F9w2YO/7htQhtiL+Ev2WCJbe5N2hc+XfgyKkEKqWpSxknmT8QOuGdEKNdjPq0c3F7rNpFkTo3Kfrm7pg==",
+      "license": "MIT",
+      "dependencies": {
+        "@babel/parser": "^7.29.8",
+        "@vue/shared": "3.5.41",
+        "entities": "^7.0.1",
+        "estree-walker": "^2.0.2",
+        "source-map-js": "^1.2.1"
+      }
+    },
+    "node_modules/@vue/compiler-dom": {
+      "version": "3.5.41",
+      "resolved": "https://registry.npmjs.org/@vue/compiler-dom/-/compiler-dom-3.5.41.tgz",
+      "integrity": "sha512-oKacVfNglLvGjnS6BXOlGL7EyG2h8X03pqXCjzotRZUaXGjbrTJUnVAQjrCqUnS+lyu31nwQjZY/d817GmCnfw==",
+      "license": "MIT",
+      "dependencies": {
+        "@vue/compiler-core": "3.5.41",
+        "@vue/shared": "3.5.41"
+      }
+    },
+    "node_modules/@vue/compiler-sfc": {
+      "version": "3.5.41",
+      "resolved": "https://registry.npmjs.org/@vue/compiler-sfc/-/compiler-sfc-3.5.41.tgz",
+      "integrity": "sha512-XJhip7R2wy6vX3knCxdZN4KracFaZUef58s1KYewqluedHIJaPIVfXoYT7MF1F8nCvv6k8bWWxDC8opMkg1VTQ==",
+      "license": "MIT",
+      "dependencies": {
+        "@babel/parser": "^7.29.8",
+        "@vue/compiler-core": "3.5.41",
+        "@vue/compiler-dom": "3.5.41",
+        "@vue/compiler-ssr": "3.5.41",
+        "@vue/shared": "3.5.41",
+        "estree-walker": "^2.0.2",
+        "magic-string": "^0.30.21",
+        "postcss": "^8.5.19",
+        "source-map-js": "^1.2.1"
+      }
+    },
+    "node_modules/@vue/compiler-ssr": {
+      "version": "3.5.41",
+      "resolved": "https://registry.npmjs.org/@vue/compiler-ssr/-/compiler-ssr-3.5.41.tgz",
+      "integrity": "sha512-U3v5OejKEGqOI0Wy0+Sz7hGuIFZHA4LSXzrNM3IMIeDyJEBBfTpX26n3SDgToRpP2bLc9FfI2j/kSgcJ8Emq5A==",
+      "license": "MIT",
+      "dependencies": {
+        "@vue/compiler-dom": "3.5.41",
+        "@vue/shared": "3.5.41"
+      }
+    },
+    "node_modules/@vue/devtools-api": {
+      "version": "6.6.4",
+      "resolved": "https://registry.npmjs.org/@vue/devtools-api/-/devtools-api-6.6.4.tgz",
+      "integrity": "sha512-sGhTPMuXqZ1rVOk32RylztWkfXTRhuS7vgAKv0zjqk8gbsHkJ7xfFf+jbySxt7tWObEJwyKaHMikV/WGDiQm8g==",
+      "license": "MIT"
+    },
+    "node_modules/@vue/reactivity": {
+      "version": "3.5.41",
+      "resolved": "https://registry.npmjs.org/@vue/reactivity/-/reactivity-3.5.41.tgz",
+      "integrity": "sha512-rznsqKM0np0x18EjzF8x88MpEhdNsffbvFbckLL5+oUKz1BxAImEmO7J1ArRYSyo6aQaVoBDp7jEkT91OOxydA==",
+      "license": "MIT",
+      "dependencies": {
+        "@vue/shared": "3.5.41"
+      }
+    },
+    "node_modules/@vue/runtime-core": {
+      "version": "3.5.41",
+      "resolved": "https://registry.npmjs.org/@vue/runtime-core/-/runtime-core-3.5.41.tgz",
+      "integrity": "sha512-Vcry58hiAKwGen9Z1jUZE0feFsNArPCMOImYI8el48A9Idf6DuQYD0U05zZIF2Iad1hGhPSvcbBbAOhNr55fhg==",
+      "license": "MIT",
+      "dependencies": {
+        "@vue/reactivity": "3.5.41",
+        "@vue/shared": "3.5.41"
+      }
+    },
+    "node_modules/@vue/runtime-dom": {
+      "version": "3.5.41",
+      "resolved": "https://registry.npmjs.org/@vue/runtime-dom/-/runtime-dom-3.5.41.tgz",
+      "integrity": "sha512-3vVBahVBS9+U6cmXBLyb8nE6/yYo4J/CGI9eVFs3KiMc0YHuudwKyShTD65jtJy/L9PUUxNAFu4cj4LiJ0UFbw==",
+      "license": "MIT",
+      "dependencies": {
+        "@vue/reactivity": "3.5.41",
+        "@vue/runtime-core": "3.5.41",
+        "@vue/shared": "3.5.41",
+        "csstype": "^3.2.3"
+      }
+    },
+    "node_modules/@vue/server-renderer": {
+      "version": "3.5.41",
+      "resolved": "https://registry.npmjs.org/@vue/server-renderer/-/server-renderer-3.5.41.tgz",
+      "integrity": "sha512-n6hx/pNFfbD6SuyeuMVkvqox8bwf/ET9JlA/kAz/imw8sw++wkqKe2mHX5KutjPpbKE4Z56yTHszoOjGMI9igQ==",
+      "license": "MIT",
+      "dependencies": {
+        "@vue/compiler-ssr": "3.5.41",
+        "@vue/runtime-dom": "3.5.41",
+        "@vue/shared": "3.5.41"
+      }
+    },
+    "node_modules/@vue/shared": {
+      "version": "3.5.41",
+      "resolved": "https://registry.npmjs.org/@vue/shared/-/shared-3.5.41.tgz",
+      "integrity": "sha512-IOnwSCma8j+9xJT6b8H0dEYidC80NsYmNMlZxRsukYcSoGaDBohog5hDxzeUXdFeGWFA++vWvxqOmrr96VlqMA==",
+      "license": "MIT"
+    },
+    "node_modules/@vueuse/core": {
+      "version": "14.3.0",
+      "resolved": "https://registry.npmjs.org/@vueuse/core/-/core-14.3.0.tgz",
+      "integrity": "sha512-aHfz47g0ZhMtTVHmIzMVpJy8ePhhOy68GY5bv110+5DVtZ+W7BsOx+m61UNQqfrWyPztIHIanWa3E2tib3NFIw==",
+      "license": "MIT",
+      "dependencies": {
+        "@types/web-bluetooth": "^0.0.21",
+        "@vueuse/metadata": "14.3.0",
+        "@vueuse/shared": "14.3.0"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/antfu"
+      },
+      "peerDependencies": {
+        "vue": "^3.5.0"
+      }
+    },
+    "node_modules/@vueuse/metadata": {
+      "version": "14.3.0",
+      "resolved": "https://registry.npmjs.org/@vueuse/metadata/-/metadata-14.3.0.tgz",
+      "integrity": "sha512-BwxmbAzwAVF50+MW57GXOUEV61nFBGnlBvrTqj49PqWJu3uw7hdu72ztXeZ33RdZtDY6kO+bfCAE1PCn88Tktw==",
+      "license": "MIT",
+      "funding": {
+        "url": "https://github.com/sponsors/antfu"
+      }
+    },
+    "node_modules/@vueuse/shared": {
+      "version": "14.3.0",
+      "resolved": "https://registry.npmjs.org/@vueuse/shared/-/shared-14.3.0.tgz",
+      "integrity": "sha512-bZpge9eSXwa4ToSiqJ7j6KRwhAsneMFoSz3LMWKQDkqimm3D/tbFlrklrs/IOqC8tEcYmXQZJ6N0UrjhBirVCg==",
+      "license": "MIT",
+      "funding": {
+        "url": "https://github.com/sponsors/antfu"
+      },
+      "peerDependencies": {
+        "vue": "^3.5.0"
+      }
+    },
+    "node_modules/agent-base": {
+      "version": "6.0.2",
+      "resolved": "https://registry.npmjs.org/agent-base/-/agent-base-6.0.2.tgz",
+      "integrity": "sha512-RZNwNclF7+MS/8bDg70amg32dyeZGZxiDuQmZxKLAlQjr3jGyLx+4Kkk58UO7D2QdgFIQCovuSuZESne6RG6XQ==",
+      "license": "MIT",
+      "dependencies": {
+        "debug": "4"
+      },
+      "engines": {
+        "node": ">= 6.0.0"
+      }
+    },
+    "node_modules/async-validator": {
+      "version": "4.2.5",
+      "resolved": "https://registry.npmjs.org/async-validator/-/async-validator-4.2.5.tgz",
+      "integrity": "sha512-7HhHjtERjqlNbZtqNqy2rckN/SpOOlmDliet+lP7k+eKZEjPk3DgyeU9lIXLdeLz0uBbbVp+9Qdow9wJWgwwfg==",
+      "license": "MIT"
+    },
+    "node_modules/asynckit": {
+      "version": "0.4.0",
+      "resolved": "https://registry.npmjs.org/asynckit/-/asynckit-0.4.0.tgz",
+      "integrity": "sha512-Oei9OH4tRh0YqU3GxhX79dM/mwVgvbZJaSNaRk+bshkj0S5cfHcgYakreBjrHwatXKbz+IoIdYLxrKim2MjW0Q==",
+      "license": "MIT"
+    },
+    "node_modules/axios": {
+      "version": "1.19.0",
+      "resolved": "https://registry.npmjs.org/axios/-/axios-1.19.0.tgz",
+      "integrity": "sha512-ht/iuYZXEjFxLH/Hkezgd7m6JKlHHXEUSneaDz8uZe1Gj5QZtCnpyDsckvAiEnT89OEbCLmnte4R4sn7P0EKFw==",
+      "license": "MIT",
+      "dependencies": {
+        "follow-redirects": "^1.16.0",
+        "form-data": "^4.0.6",
+        "https-proxy-agent": "^5.0.1",
+        "proxy-from-env": "^2.1.0"
+      }
+    },
+    "node_modules/call-bind-apply-helpers": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/call-bind-apply-helpers/-/call-bind-apply-helpers-1.0.2.tgz",
+      "integrity": "sha512-Sp1ablJ0ivDkSzjcaJdxEunN5/XvksFJ2sMBFfq6x0ryhQV/2b/KwFe21cMpmHtPOSij8K99/wSfoEuTObmuMQ==",
+      "license": "MIT",
+      "dependencies": {
+        "es-errors": "^1.3.0",
+        "function-bind": "^1.1.2"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/combined-stream": {
+      "version": "1.0.8",
+      "resolved": "https://registry.npmjs.org/combined-stream/-/combined-stream-1.0.8.tgz",
+      "integrity": "sha512-FQN4MRfuJeHf7cBbBMJFXhKSDq+2kAArBlmRBvcvFE5BB1HZKXtSFASDhdlz9zOYwxh8lDdnvmMOe/+5cdoEdg==",
+      "license": "MIT",
+      "dependencies": {
+        "delayed-stream": "~1.0.0"
+      },
+      "engines": {
+        "node": ">= 0.8"
+      }
+    },
+    "node_modules/csstype": {
+      "version": "3.2.3",
+      "resolved": "https://registry.npmjs.org/csstype/-/csstype-3.2.3.tgz",
+      "integrity": "sha512-z1HGKcYy2xA8AGQfwrn0PAy+PB7X/GSj3UVJW9qKyn43xWa+gl5nXmU4qqLMRzWVLFC8KusUX8T/0kCiOYpAIQ==",
+      "license": "MIT"
+    },
+    "node_modules/dayjs": {
+      "version": "1.11.21",
+      "resolved": "https://registry.npmjs.org/dayjs/-/dayjs-1.11.21.tgz",
+      "integrity": "sha512-98IT+HOahAisibz/yjKbzuOBwYcjJ7BCLPzARyHiyEBmRz4fatF+KPJszEHXsGYjUG234aH/cOjW1wwTbKUZlA==",
+      "license": "MIT"
+    },
+    "node_modules/debug": {
+      "version": "4.4.3",
+      "resolved": "https://registry.npmjs.org/debug/-/debug-4.4.3.tgz",
+      "integrity": "sha512-RGwwWnwQvkVfavKVt22FGLw+xYSdzARwm0ru6DhTVA3umU5hZc28V3kO4stgYryrTlLpuvgI9GiijltAjNbcqA==",
+      "license": "MIT",
+      "dependencies": {
+        "ms": "^2.1.3"
+      },
+      "engines": {
+        "node": ">=6.0"
+      },
+      "peerDependenciesMeta": {
+        "supports-color": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/delayed-stream": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/delayed-stream/-/delayed-stream-1.0.0.tgz",
+      "integrity": "sha512-ZySD7Nf91aLB0RxL4KGrKHBXl7Eds1DAmEdcoVawXnLD7SDhpNgtuII2aAkg7a7QS41jxPSZ17p4VdGnMHk3MQ==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=0.4.0"
+      }
+    },
+    "node_modules/dunder-proto": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/dunder-proto/-/dunder-proto-1.0.1.tgz",
+      "integrity": "sha512-KIN/nDJBQRcXw0MLVhZE9iQHmG68qAVIBg9CqmUYjmQIhgij9U5MFvrqkUL5FbtyyzZuOeOt0zdeRe4UY7ct+A==",
+      "license": "MIT",
+      "dependencies": {
+        "call-bind-apply-helpers": "^1.0.1",
+        "es-errors": "^1.3.0",
+        "gopd": "^1.2.0"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/echarts": {
+      "version": "5.6.0",
+      "resolved": "https://registry.npmjs.org/echarts/-/echarts-5.6.0.tgz",
+      "integrity": "sha512-oTbVTsXfKuEhxftHqL5xprgLoc0k7uScAwtryCgWF6hPYFLRwOUHiFmHGCBKP5NPFNkDVopOieyUqYGH8Fa3kA==",
+      "license": "Apache-2.0",
+      "dependencies": {
+        "tslib": "2.3.0",
+        "zrender": "5.6.1"
+      }
+    },
+    "node_modules/element-plus": {
+      "version": "2.14.4",
+      "resolved": "https://registry.npmjs.org/element-plus/-/element-plus-2.14.4.tgz",
+      "integrity": "sha512-vMKR9tFcLeNrJgFXA3zhUn6YuRKUQW9d0btakBR8U1Iq8MfzkjMOGcgs5de2VgiLldHt69brmuBHpxc3bK4ZgQ==",
+      "license": "MIT",
+      "dependencies": {
+        "@ctrl/tinycolor": "^4.2.0",
+        "@element-plus/icons-vue": "^2.3.2",
+        "@floating-ui/dom": "^1.8.0",
+        "@popperjs/core": "npm:@sxzz/popperjs-es@^2.11.8",
+        "@types/lodash": "^4.17.24",
+        "@types/lodash-es": "^4.17.12",
+        "@vueuse/core": "14.3.0",
+        "async-validator": "^4.2.5",
+        "dayjs": "^1.11.20",
+        "lodash": "^4.18.1",
+        "lodash-es": "^4.18.1",
+        "lodash-unified": "^1.0.3",
+        "memoize-one": "^6.0.0",
+        "normalize-wheel-es": "^1.2.0",
+        "vue-component-type-helpers": "^3.3.9"
+      },
+      "peerDependencies": {
+        "vue": "^3.3.7"
+      }
+    },
+    "node_modules/entities": {
+      "version": "7.0.1",
+      "resolved": "https://registry.npmjs.org/entities/-/entities-7.0.1.tgz",
+      "integrity": "sha512-TWrgLOFUQTH994YUyl1yT4uyavY5nNB5muff+RtWaqNVCAK408b5ZnnbNAUEWLTCpum9w6arT70i1XdQ4UeOPA==",
+      "license": "BSD-2-Clause",
+      "engines": {
+        "node": ">=0.12"
+      },
+      "funding": {
+        "url": "https://github.com/fb55/entities?sponsor=1"
+      }
+    },
+    "node_modules/es-define-property": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/es-define-property/-/es-define-property-1.0.1.tgz",
+      "integrity": "sha512-e3nRfgfUZ4rNGL232gUgX06QNyyez04KdjFrF+LTRoOXmrOgFKDg4BCdsjW8EnT69eqdYGmRpJwiPVYNrCaW3g==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/es-errors": {
+      "version": "1.3.0",
+      "resolved": "https://registry.npmjs.org/es-errors/-/es-errors-1.3.0.tgz",
+      "integrity": "sha512-Zf5H2Kxt2xjTvbJvP2ZWLEICxA6j+hAmMzIlypy4xcBg1vKVnx89Wy0GbS+kf5cwCVFFzdCFh2XSCFNULS6csw==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/es-object-atoms": {
+      "version": "1.1.2",
+      "resolved": "https://registry.npmjs.org/es-object-atoms/-/es-object-atoms-1.1.2.tgz",
+      "integrity": "sha512-HWcBoN6NileqtSydK2FqHbS/LoDd2pqrnQHLyJzBj4kOp/ky2MWMN694xOfkK8/SnUsW2DH7EfyVlydKCsm1Zw==",
+      "license": "MIT",
+      "dependencies": {
+        "es-errors": "^1.3.0"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/es-set-tostringtag": {
+      "version": "2.1.0",
+      "resolved": "https://registry.npmjs.org/es-set-tostringtag/-/es-set-tostringtag-2.1.0.tgz",
+      "integrity": "sha512-j6vWzfrGVfyXxge+O0x5sh6cvxAog0a/4Rdd2K36zCMV5eJ+/+tOAngRO8cODMNWbVRdVlmGZQL2YS3yR8bIUA==",
+      "license": "MIT",
+      "dependencies": {
+        "es-errors": "^1.3.0",
+        "get-intrinsic": "^1.2.6",
+        "has-tostringtag": "^1.0.2",
+        "hasown": "^2.0.2"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/esbuild": {
+      "version": "0.25.12",
+      "resolved": "https://registry.npmjs.org/esbuild/-/esbuild-0.25.12.tgz",
+      "integrity": "sha512-bbPBYYrtZbkt6Os6FiTLCTFxvq4tt3JKall1vRwshA3fdVztsLAatFaZobhkBC8/BrPetoa0oksYoKXoG4ryJg==",
+      "dev": true,
+      "hasInstallScript": true,
+      "license": "MIT",
+      "bin": {
+        "esbuild": "bin/esbuild"
+      },
+      "engines": {
+        "node": ">=18"
+      },
+      "optionalDependencies": {
+        "@esbuild/aix-ppc64": "0.25.12",
+        "@esbuild/android-arm": "0.25.12",
+        "@esbuild/android-arm64": "0.25.12",
+        "@esbuild/android-x64": "0.25.12",
+        "@esbuild/darwin-arm64": "0.25.12",
+        "@esbuild/darwin-x64": "0.25.12",
+        "@esbuild/freebsd-arm64": "0.25.12",
+        "@esbuild/freebsd-x64": "0.25.12",
+        "@esbuild/linux-arm": "0.25.12",
+        "@esbuild/linux-arm64": "0.25.12",
+        "@esbuild/linux-ia32": "0.25.12",
+        "@esbuild/linux-loong64": "0.25.12",
+        "@esbuild/linux-mips64el": "0.25.12",
+        "@esbuild/linux-ppc64": "0.25.12",
+        "@esbuild/linux-riscv64": "0.25.12",
+        "@esbuild/linux-s390x": "0.25.12",
+        "@esbuild/linux-x64": "0.25.12",
+        "@esbuild/netbsd-arm64": "0.25.12",
+        "@esbuild/netbsd-x64": "0.25.12",
+        "@esbuild/openbsd-arm64": "0.25.12",
+        "@esbuild/openbsd-x64": "0.25.12",
+        "@esbuild/openharmony-arm64": "0.25.12",
+        "@esbuild/sunos-x64": "0.25.12",
+        "@esbuild/win32-arm64": "0.25.12",
+        "@esbuild/win32-ia32": "0.25.12",
+        "@esbuild/win32-x64": "0.25.12"
+      }
+    },
+    "node_modules/estree-walker": {
+      "version": "2.0.2",
+      "resolved": "https://registry.npmjs.org/estree-walker/-/estree-walker-2.0.2.tgz",
+      "integrity": "sha512-Rfkk/Mp/DL7JVje3u18FxFujQlTNR2q6QfMSMB7AvCBx91NGj/ba3kCfza0f6dVDbw7YlRf/nDrn7pQrCCyQ/w==",
+      "license": "MIT"
+    },
+    "node_modules/fdir": {
+      "version": "6.5.0",
+      "resolved": "https://registry.npmjs.org/fdir/-/fdir-6.5.0.tgz",
+      "integrity": "sha512-tIbYtZbucOs0BRGqPJkshJUYdL+SDH7dVM8gjy+ERp3WAUjLEFJE+02kanyHtwjWOnwrKYBiwAmM0p4kLJAnXg==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=12.0.0"
+      },
+      "peerDependencies": {
+        "picomatch": "^3 || ^4"
+      },
+      "peerDependenciesMeta": {
+        "picomatch": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/follow-redirects": {
+      "version": "1.16.0",
+      "resolved": "https://registry.npmjs.org/follow-redirects/-/follow-redirects-1.16.0.tgz",
+      "integrity": "sha512-y5rN/uOsadFT/JfYwhxRS5R7Qce+g3zG97+JrtFZlC9klX/W5hD7iiLzScI4nZqUS7DNUdhPgw4xI8W2LuXlUw==",
+      "funding": [
+        {
+          "type": "individual",
+          "url": "https://github.com/sponsors/RubenVerborgh"
+        }
+      ],
+      "license": "MIT",
+      "engines": {
+        "node": ">=4.0"
+      },
+      "peerDependenciesMeta": {
+        "debug": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/form-data": {
+      "version": "4.0.6",
+      "resolved": "https://registry.npmjs.org/form-data/-/form-data-4.0.6.tgz",
+      "integrity": "sha512-vKatAh4SlVfgbv+YtmhiRjhEMJsYpsG1Y2rMQtR+SVSbytsSD1YGzDIcrAJmdFec88u/+VoGmxnl+80gL1tRCQ==",
+      "license": "MIT",
+      "dependencies": {
+        "asynckit": "^0.4.0",
+        "combined-stream": "^1.0.8",
+        "es-set-tostringtag": "^2.1.0",
+        "hasown": "^2.0.4",
+        "mime-types": "^2.1.35"
+      },
+      "engines": {
+        "node": ">= 6"
+      }
+    },
+    "node_modules/fsevents": {
+      "version": "2.3.3",
+      "resolved": "https://registry.npmjs.org/fsevents/-/fsevents-2.3.3.tgz",
+      "integrity": "sha512-5xoDfX+fL7faATnagmWPpbFtwh/R77WmMMqqHGS65C3vvB0YHrgF+B1YmZ3441tMj5n63k0212XNoJwzlhffQw==",
+      "dev": true,
+      "hasInstallScript": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "darwin"
+      ],
+      "engines": {
+        "node": "^8.16.0 || ^10.6.0 || >=11.0.0"
+      }
+    },
+    "node_modules/function-bind": {
+      "version": "1.1.2",
+      "resolved": "https://registry.npmjs.org/function-bind/-/function-bind-1.1.2.tgz",
+      "integrity": "sha512-7XHNxH7qX9xG5mIwxkhumTox/MIRNcOgDrxWsMt2pAr23WHp6MrRlN7FBSFpCpr+oVO0F744iUgR82nJMfG2SA==",
+      "license": "MIT",
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/get-intrinsic": {
+      "version": "1.3.0",
+      "resolved": "https://registry.npmjs.org/get-intrinsic/-/get-intrinsic-1.3.0.tgz",
+      "integrity": "sha512-9fSjSaos/fRIVIp+xSJlE6lfwhES7LNtKaCBIamHsjr2na1BiABJPo0mOjjz8GJDURarmCPGqaiVg5mfjb98CQ==",
+      "license": "MIT",
+      "dependencies": {
+        "call-bind-apply-helpers": "^1.0.2",
+        "es-define-property": "^1.0.1",
+        "es-errors": "^1.3.0",
+        "es-object-atoms": "^1.1.1",
+        "function-bind": "^1.1.2",
+        "get-proto": "^1.0.1",
+        "gopd": "^1.2.0",
+        "has-symbols": "^1.1.0",
+        "hasown": "^2.0.2",
+        "math-intrinsics": "^1.1.0"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/get-proto": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/get-proto/-/get-proto-1.0.1.tgz",
+      "integrity": "sha512-sTSfBjoXBp89JvIKIefqw7U2CCebsc74kiY6awiGogKtoSGbgjYE/G/+l9sF3MWFPNc9IcoOC4ODfKHfxFmp0g==",
+      "license": "MIT",
+      "dependencies": {
+        "dunder-proto": "^1.0.1",
+        "es-object-atoms": "^1.0.0"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/gopd": {
+      "version": "1.2.0",
+      "resolved": "https://registry.npmjs.org/gopd/-/gopd-1.2.0.tgz",
+      "integrity": "sha512-ZUKRh6/kUFoAiTAtTYPZJ3hw9wNxx+BIBOijnlG9PnrJsCcSjs1wyyD6vJpaYtgnzDrKYRSqf3OO6Rfa93xsRg==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/has-symbols": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/has-symbols/-/has-symbols-1.1.0.tgz",
+      "integrity": "sha512-1cDNdwJ2Jaohmb3sg4OmKaMBwuC48sYni5HUw2DvsC8LjGTLK9h+eb1X6RyuOHe4hT0ULCW68iomhjUoKUqlPQ==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/has-tostringtag": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/has-tostringtag/-/has-tostringtag-1.0.2.tgz",
+      "integrity": "sha512-NqADB8VjPFLM2V0VvHUewwwsw0ZWBaIdgo+ieHtK3hasLz4qeCRjYcqfB6AQrBggRKppKF8L52/VqdVsO47Dlw==",
+      "license": "MIT",
+      "dependencies": {
+        "has-symbols": "^1.0.3"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/hasown": {
+      "version": "2.0.4",
+      "resolved": "https://registry.npmjs.org/hasown/-/hasown-2.0.4.tgz",
+      "integrity": "sha512-T2UbfbBEF32wiepXIsMlTW9+dDYC6wMh/t/vYA4tuOMKqWz/n3vr1NFSxQiyP+zk2mXsoMA/i/7qV6LKut1t1A==",
+      "license": "MIT",
+      "dependencies": {
+        "function-bind": "^1.1.2"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/https-proxy-agent": {
+      "version": "5.0.1",
+      "resolved": "https://registry.npmjs.org/https-proxy-agent/-/https-proxy-agent-5.0.1.tgz",
+      "integrity": "sha512-dFcAjpTQFgoLMzC2VwU+C/CbS7uRL0lWmxDITmqm7C+7F0Odmj6s9l6alZc6AELXhrnggM2CeWSXHGOdX2YtwA==",
+      "license": "MIT",
+      "dependencies": {
+        "agent-base": "6",
+        "debug": "4"
+      },
+      "engines": {
+        "node": ">= 6"
+      }
+    },
+    "node_modules/lodash": {
+      "version": "4.18.1",
+      "resolved": "https://registry.npmjs.org/lodash/-/lodash-4.18.1.tgz",
+      "integrity": "sha512-dMInicTPVE8d1e5otfwmmjlxkZoUpiVLwyeTdUsi/Caj/gfzzblBcCE5sRHV/AsjuCmxWrte2TNGSYuCeCq+0Q==",
+      "license": "MIT"
+    },
+    "node_modules/lodash-es": {
+      "version": "4.18.1",
+      "resolved": "https://registry.npmjs.org/lodash-es/-/lodash-es-4.18.1.tgz",
+      "integrity": "sha512-J8xewKD/Gk22OZbhpOVSwcs60zhd95ESDwezOFuA3/099925PdHJ7OFHNTGtajL3AlZkykD32HykiMo+BIBI8A==",
+      "license": "MIT"
+    },
+    "node_modules/lodash-unified": {
+      "version": "1.0.3",
+      "resolved": "https://registry.npmjs.org/lodash-unified/-/lodash-unified-1.0.3.tgz",
+      "integrity": "sha512-WK9qSozxXOD7ZJQlpSqOT+om2ZfcT4yO+03FuzAHD0wF6S0l0090LRPDx3vhTTLZ8cFKpBn+IOcVXK6qOcIlfQ==",
+      "license": "MIT",
+      "peerDependencies": {
+        "@types/lodash-es": "*",
+        "lodash": "*",
+        "lodash-es": "*"
+      }
+    },
+    "node_modules/magic-string": {
+      "version": "0.30.21",
+      "resolved": "https://registry.npmjs.org/magic-string/-/magic-string-0.30.21.tgz",
+      "integrity": "sha512-vd2F4YUyEXKGcLHoq+TEyCjxueSeHnFxyyjNp80yg0XV4vUhnDer/lvvlqM/arB5bXQN5K2/3oinyCRyx8T2CQ==",
+      "license": "MIT",
+      "dependencies": {
+        "@jridgewell/sourcemap-codec": "^1.5.5"
+      }
+    },
+    "node_modules/math-intrinsics": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/math-intrinsics/-/math-intrinsics-1.1.0.tgz",
+      "integrity": "sha512-/IXtbwEk5HTPyEwyKX6hGkYXxM9nbj64B+ilVJnC/R6B0pH5G4V3b0pVbL7DBj4tkhBAppbQUlf6F6Xl9LHu1g==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/memoize-one": {
+      "version": "6.0.0",
+      "resolved": "https://registry.npmjs.org/memoize-one/-/memoize-one-6.0.0.tgz",
+      "integrity": "sha512-rkpe71W0N0c0Xz6QD0eJETuWAJGnJ9afsl1srmwPrI+yBCkge5EycXXbYRyvL29zZVUWQCY7InPRCv3GDXuZNw==",
+      "license": "MIT"
+    },
+    "node_modules/mime-db": {
+      "version": "1.52.0",
+      "resolved": "https://registry.npmjs.org/mime-db/-/mime-db-1.52.0.tgz",
+      "integrity": "sha512-sPU4uV7dYlvtWJxwwxHD0PuihVNiE7TyAbQ5SWxDCB9mUYvOgroQOwYQQOKPJ8CIbE+1ETVlOoK1UC2nU3gYvg==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.6"
+      }
+    },
+    "node_modules/mime-types": {
+      "version": "2.1.35",
+      "resolved": "https://registry.npmjs.org/mime-types/-/mime-types-2.1.35.tgz",
+      "integrity": "sha512-ZDY+bPm5zTTF+YpCrAU9nK0UgICYPT0QtT1NZWFv4s++TNkcgVaT0g6+4R2uI4MjQjzysHB1zxuWL50hzaeXiw==",
+      "license": "MIT",
+      "dependencies": {
+        "mime-db": "1.52.0"
+      },
+      "engines": {
+        "node": ">= 0.6"
+      }
+    },
+    "node_modules/ms": {
+      "version": "2.1.3",
+      "resolved": "https://registry.npmjs.org/ms/-/ms-2.1.3.tgz",
+      "integrity": "sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA==",
+      "license": "MIT"
+    },
+    "node_modules/nanoid": {
+      "version": "3.3.18",
+      "resolved": "https://registry.npmjs.org/nanoid/-/nanoid-3.3.18.tgz",
+      "integrity": "sha512-DTg4MJbGMWkfi6VZFdNt2/caMbQy4Ou+Op/hJQvGEWcnVfoA1QA+xzRKAzw9jD6+GVOOeYr/mIcuDSdug6F6+w==",
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/ai"
+        }
+      ],
+      "license": "MIT",
+      "bin": {
+        "nanoid": "bin/nanoid.cjs"
+      },
+      "engines": {
+        "node": "^10 || ^12 || ^13.7 || ^14 || >=15.0.1"
+      }
+    },
+    "node_modules/normalize-wheel-es": {
+      "version": "1.2.0",
+      "resolved": "https://registry.npmjs.org/normalize-wheel-es/-/normalize-wheel-es-1.2.0.tgz",
+      "integrity": "sha512-Wj7+EJQ8mSuXr2iWfnujrimU35R2W4FAErEyTmJoJ7ucwTn2hOUSsRehMb5RSYkxXGTM7Y9QpvPmp++w5ftoJw==",
+      "license": "BSD-3-Clause"
+    },
+    "node_modules/picocolors": {
+      "version": "1.1.1",
+      "resolved": "https://registry.npmjs.org/picocolors/-/picocolors-1.1.1.tgz",
+      "integrity": "sha512-xceH2snhtb5M9liqDsmEw56le376mTZkEX/jEb/RxNFyegNul7eNslCXP9FDj/Lcu0X8KEyMceP2ntpaHrDEVA==",
+      "license": "ISC"
+    },
+    "node_modules/picomatch": {
+      "version": "4.0.5",
+      "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-4.0.5.tgz",
+      "integrity": "sha512-RvwwcruNjI1ncT5xRakeyS9Lf8lcItv34KD+aif+VH9kduAyfYBipGh12274xtenIPZ119/R9BdTBa8gAwSh0A==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=12"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/jonschlinkert"
+      }
+    },
+    "node_modules/pinia": {
+      "version": "2.3.1",
+      "resolved": "https://registry.npmjs.org/pinia/-/pinia-2.3.1.tgz",
+      "integrity": "sha512-khUlZSwt9xXCaTbbxFYBKDc/bWAGWJjOgvxETwkTN7KRm66EeT1ZdZj6i2ceh9sP2Pzqsbc704r2yngBrxBVug==",
+      "license": "MIT",
+      "dependencies": {
+        "@vue/devtools-api": "^6.6.3",
+        "vue-demi": "^0.14.10"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/posva"
+      },
+      "peerDependencies": {
+        "typescript": ">=4.4.4",
+        "vue": "^2.7.0 || ^3.5.11"
+      },
+      "peerDependenciesMeta": {
+        "typescript": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/postcss": {
+      "version": "8.5.26",
+      "resolved": "https://registry.npmjs.org/postcss/-/postcss-8.5.26.tgz",
+      "integrity": "sha512-u82N74LFzG8ca+dD8puPnplTXoGH4fTPpVGuIbt36G3qvNlkvfD0lEAZSxaly3KX8TS/L1A1gsCEmvKmBcVbkQ==",
+      "funding": [
+        {
+          "type": "opencollective",
+          "url": "https://opencollective.com/postcss/"
+        },
+        {
+          "type": "tidelift",
+          "url": "https://tidelift.com/funding/github/npm/postcss"
+        },
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/ai"
+        }
+      ],
+      "license": "MIT",
+      "dependencies": {
+        "nanoid": "^3.3.17",
+        "picocolors": "^1.1.1",
+        "source-map-js": "^1.2.1"
+      },
+      "engines": {
+        "node": "^10 || ^12 || >=14"
+      }
+    },
+    "node_modules/proxy-from-env": {
+      "version": "2.1.0",
+      "resolved": "https://registry.npmjs.org/proxy-from-env/-/proxy-from-env-2.1.0.tgz",
+      "integrity": "sha512-cJ+oHTW1VAEa8cJslgmUZrc+sjRKgAKl3Zyse6+PV38hZe/V6Z14TbCuXcan9F9ghlz4QrFr2c92TNF82UkYHA==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=10"
+      }
+    },
+    "node_modules/rollup": {
+      "version": "4.62.4",
+      "resolved": "https://registry.npmjs.org/rollup/-/rollup-4.62.4.tgz",
+      "integrity": "sha512-RXOqwaPsBGjMNMa4sQjDjHieHEZDFoj/Rdr46l2MU5DfEs16wHJPC2RPTPHWhNl+M3aI472LLqFkFKut4SblOg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@types/estree": "1.0.9"
+      },
+      "bin": {
+        "rollup": "dist/bin/rollup"
+      },
+      "engines": {
+        "node": ">=18.0.0",
+        "npm": ">=8.0.0"
+      },
+      "optionalDependencies": {
+        "@napi-rs/lzma-linux-x64-gnu": "1.5.1",
+        "@rollup/rollup-android-arm-eabi": "4.62.4",
+        "@rollup/rollup-android-arm64": "4.62.4",
+        "@rollup/rollup-darwin-arm64": "4.62.4",
+        "@rollup/rollup-darwin-x64": "4.62.4",
+        "@rollup/rollup-freebsd-arm64": "4.62.4",
+        "@rollup/rollup-freebsd-x64": "4.62.4",
+        "@rollup/rollup-linux-arm-gnueabihf": "4.62.4",
+        "@rollup/rollup-linux-arm-musleabihf": "4.62.4",
+        "@rollup/rollup-linux-arm64-gnu": "4.62.4",
+        "@rollup/rollup-linux-arm64-musl": "4.62.4",
+        "@rollup/rollup-linux-loong64-gnu": "4.62.4",
+        "@rollup/rollup-linux-loong64-musl": "4.62.4",
+        "@rollup/rollup-linux-ppc64-gnu": "4.62.4",
+        "@rollup/rollup-linux-ppc64-musl": "4.62.4",
+        "@rollup/rollup-linux-riscv64-gnu": "4.62.4",
+        "@rollup/rollup-linux-riscv64-musl": "4.62.4",
+        "@rollup/rollup-linux-s390x-gnu": "4.62.4",
+        "@rollup/rollup-linux-x64-gnu": "4.62.4",
+        "@rollup/rollup-linux-x64-musl": "4.62.4",
+        "@rollup/rollup-openbsd-x64": "4.62.4",
+        "@rollup/rollup-openharmony-arm64": "4.62.4",
+        "@rollup/rollup-win32-arm64-msvc": "4.62.4",
+        "@rollup/rollup-win32-ia32-msvc": "4.62.4",
+        "@rollup/rollup-win32-x64-gnu": "4.62.4",
+        "@rollup/rollup-win32-x64-msvc": "4.62.4",
+        "fsevents": "~2.3.2"
+      }
+    },
+    "node_modules/source-map-js": {
+      "version": "1.2.1",
+      "resolved": "https://registry.npmjs.org/source-map-js/-/source-map-js-1.2.1.tgz",
+      "integrity": "sha512-UXWMKhLOwVKb728IUtQPXxfYU+usdybtUrK/8uGE8CQMvrhOpwvzDBwj0QhSL7MQc7vIsISBG8VQ8+IDQxpfQA==",
+      "license": "BSD-3-Clause",
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/tinyglobby": {
+      "version": "0.2.17",
+      "resolved": "https://registry.npmjs.org/tinyglobby/-/tinyglobby-0.2.17.tgz",
+      "integrity": "sha512-wXR/dYpcqKmfWpEdZjiKJOwCNFndD0DMnrW/cYjVGttEkBfVgcLFHoNrlj47mjOVic9yyNu65alsgF4NQyTa2g==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "fdir": "^6.5.0",
+        "picomatch": "^4.0.4"
+      },
+      "engines": {
+        "node": ">=12.0.0"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/SuperchupuDev"
+      }
+    },
+    "node_modules/tslib": {
+      "version": "2.3.0",
+      "resolved": "https://registry.npmjs.org/tslib/-/tslib-2.3.0.tgz",
+      "integrity": "sha512-N82ooyxVNm6h1riLCoyS9e3fuJ3AMG2zIZs2Gd1ATcSFjSA23Q0fzjjZeh0jbJvWVDZ0cJT8yaNNaaXHzueNjg==",
+      "license": "0BSD"
+    },
+    "node_modules/vite": {
+      "version": "6.4.3",
+      "resolved": "https://registry.npmjs.org/vite/-/vite-6.4.3.tgz",
+      "integrity": "sha512-NTKlcQjlAK7MlQoyb6LgaqHc8sso/pVyUJYWMws3jg21uTJw/LddqIFPcPqP6PzpgbIcZyKI85sFE4HBrQDA8A==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "esbuild": "^0.25.0",
+        "fdir": "^6.4.4",
+        "picomatch": "^4.0.2",
+        "postcss": "^8.5.3",
+        "rollup": "^4.34.9",
+        "tinyglobby": "^0.2.13"
+      },
+      "bin": {
+        "vite": "bin/vite.js"
+      },
+      "engines": {
+        "node": "^18.0.0 || ^20.0.0 || >=22.0.0"
+      },
+      "funding": {
+        "url": "https://github.com/vitejs/vite?sponsor=1"
+      },
+      "optionalDependencies": {
+        "fsevents": "~2.3.3"
+      },
+      "peerDependencies": {
+        "@types/node": "^18.0.0 || ^20.0.0 || >=22.0.0",
+        "jiti": ">=1.21.0",
+        "less": "*",
+        "lightningcss": "^1.21.0",
+        "sass": "*",
+        "sass-embedded": "*",
+        "stylus": "*",
+        "sugarss": "*",
+        "terser": "^5.16.0",
+        "tsx": "^4.8.1",
+        "yaml": "^2.4.2"
+      },
+      "peerDependenciesMeta": {
+        "@types/node": {
+          "optional": true
+        },
+        "jiti": {
+          "optional": true
+        },
+        "less": {
+          "optional": true
+        },
+        "lightningcss": {
+          "optional": true
+        },
+        "sass": {
+          "optional": true
+        },
+        "sass-embedded": {
+          "optional": true
+        },
+        "stylus": {
+          "optional": true
+        },
+        "sugarss": {
+          "optional": true
+        },
+        "terser": {
+          "optional": true
+        },
+        "tsx": {
+          "optional": true
+        },
+        "yaml": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/vue": {
+      "version": "3.5.41",
+      "resolved": "https://registry.npmjs.org/vue/-/vue-3.5.41.tgz",
+      "integrity": "sha512-2laE0p+aK+/AOPG/XL/WepOs/GlK755LJ1XECi9kDUrz1FKNw8rb2Xzlw9JS1rqEV55nb0ttsKxVlTCcd+R5cg==",
+      "license": "MIT",
+      "dependencies": {
+        "@vue/compiler-dom": "3.5.41",
+        "@vue/compiler-sfc": "3.5.41",
+        "@vue/runtime-dom": "3.5.41",
+        "@vue/server-renderer": "3.5.41",
+        "@vue/shared": "3.5.41"
+      },
+      "peerDependencies": {
+        "typescript": "*"
+      },
+      "peerDependenciesMeta": {
+        "typescript": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/vue-component-type-helpers": {
+      "version": "3.3.9",
+      "resolved": "https://registry.npmjs.org/vue-component-type-helpers/-/vue-component-type-helpers-3.3.9.tgz",
+      "integrity": "sha512-3c/UfMe0SqyEfcGTyH7mfshHagJ9QTCbppCb0/uGpHZpFug7+If3GeGZN7I0YheKEExemx3xldQPoO7PQSOLQg==",
+      "license": "MIT"
+    },
+    "node_modules/vue-demi": {
+      "version": "0.14.10",
+      "resolved": "https://registry.npmjs.org/vue-demi/-/vue-demi-0.14.10.tgz",
+      "integrity": "sha512-nMZBOwuzabUO0nLgIcc6rycZEebF6eeUfaiQx9+WSk8e29IbLvPU9feI6tqW4kTo3hvoYAJkMh8n8D0fuISphg==",
+      "hasInstallScript": true,
+      "license": "MIT",
+      "bin": {
+        "vue-demi-fix": "bin/vue-demi-fix.js",
+        "vue-demi-switch": "bin/vue-demi-switch.js"
+      },
+      "engines": {
+        "node": ">=12"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/antfu"
+      },
+      "peerDependencies": {
+        "@vue/composition-api": "^1.0.0-rc.1",
+        "vue": "^3.0.0-0 || ^2.6.0"
+      },
+      "peerDependenciesMeta": {
+        "@vue/composition-api": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/vue-router": {
+      "version": "4.6.4",
+      "resolved": "https://registry.npmjs.org/vue-router/-/vue-router-4.6.4.tgz",
+      "integrity": "sha512-Hz9q5sa33Yhduglwz6g9skT8OBPii+4bFn88w6J+J4MfEo4KRRpmiNG/hHHkdbRFlLBOqxN8y8gf2Fb0MTUgVg==",
+      "license": "MIT",
+      "dependencies": {
+        "@vue/devtools-api": "^6.6.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/posva"
+      },
+      "peerDependencies": {
+        "vue": "^3.5.0"
+      }
+    },
+    "node_modules/zrender": {
+      "version": "5.6.1",
+      "resolved": "https://registry.npmjs.org/zrender/-/zrender-5.6.1.tgz",
+      "integrity": "sha512-OFXkDJKcrlx5su2XbzJvj/34Q3m6PvyCZkVPHGYpcCJ52ek4U/ymZyfuV1nKE23AyBJ51E/6Yr0mhZ7xGTO4ag==",
+      "license": "BSD-3-Clause",
+      "dependencies": {
+        "tslib": "2.3.0"
+      }
+    }
+  }
+}
diff --git a/web/package.json b/web/package.json
new file mode 100644
index 0000000..b205fb2
--- /dev/null
+++ b/web/package.json
@@ -0,0 +1,26 @@
+{
+  "name": "f9mes-web",
+  "private": true,
+  "version": "1.0.0",
+  "type": "module",
+  "description": "F9 智慧缫丝系统 MES - PC 管理端",
+  "scripts": {
+    "dev": "vite",
+    "build": "vite build",
+    "preview": "vite preview"
+  },
+  "dependencies": {
+    "@element-plus/icons-vue": "^2.3.1",
+    "axios": "^1.7.9",
+    "dayjs": "^1.11.13",
+    "echarts": "^5.6.0",
+    "element-plus": "^2.9.3",
+    "pinia": "^2.3.0",
+    "vue": "^3.5.13",
+    "vue-router": "^4.5.0"
+  },
+  "devDependencies": {
+    "@vitejs/plugin-vue": "^5.2.1",
+    "vite": "^6.0.7"
+  }
+}
diff --git a/web/playwright-cli.json b/web/playwright-cli.json
new file mode 100644
index 0000000..ba40ff9
--- /dev/null
+++ b/web/playwright-cli.json
@@ -0,0 +1 @@
+{ "outputMode": "stdout" }
diff --git a/web/src/App.vue b/web/src/App.vue
new file mode 100644
index 0000000..d372e96
--- /dev/null
+++ b/web/src/App.vue
@@ -0,0 +1,6 @@
+<template>
+  <router-view />
+</template>
+
+<script setup>
+</script>
diff --git a/web/src/api/index.js b/web/src/api/index.js
new file mode 100644
index 0000000..cca15d5
--- /dev/null
+++ b/web/src/api/index.js
@@ -0,0 +1,54 @@
+import request from './request'
+
+// ========== 认证 ==========
+export const login = (data) => request.post('/auth/login', data)
+export const getMe = () => request.get('/auth/me')
+export const changePassword = (data) => request.post('/auth/change-password', data)
+
+// ========== 天气 ==========
+export const getWeather = (params) => request.get('/weather/now', { params })
+
+// 天气码 → 中文描述（Open-Meteo WMO Weather interpretation codes）
+const WEATHER_CODES = {
+  0: '晴', 1: '晴', 2: '多云', 3: '阴', 45: '雾', 48: '雾凇',
+  51: '毛毛雨', 53: '小雨', 55: '中雨', 56: '冻雨', 57: '强冻雨',
+  61: '小雨', 63: '中雨', 65: '大雨', 66: '冻雨', 67: '强冻雨',
+  71: '小雪', 73: '中雪', 75: '大雪', 77: '雪粒',
+  80: '阵雨', 81: '强阵雨', 82: '暴雨', 85: '阵雪', 86: '强阵雪',
+  95: '雷暴', 96: '雷暴伴冰雹', 99: '强雷暴伴冰雹'
+}
+
+/** 天气接口原始数据 → 前端展示字段 */
+export function mapWeather(data) {
+  if (!data) return null
+  return {
+    temp: Math.round(data.temperature ?? 0),
+    desc: WEATHER_CODES[data.weatherCode] || '未知',
+    wind: `风速 ${data.windSpeed ?? 0}m/s`,
+    humidity: data.humidity,
+    location: '缫丝厂区'
+  }
+}
+
+// ========== 表元数据 ==========
+export const getTableMeta = (table) => request.get(`/meta/table/${table}`)
+// 关联表下拉数据 [{value,label}]
+export const getRefs = (table, params) => request.get(`/meta/refs/${table}`, { params })
+// 业务编号自动生成（如 YLZ20260815-001）
+export const genCode = (table, field) => request.post(`/meta/gencode/${table}/${field}`)
+
+// ========== 动态 CRUD ==========
+export const crudPage = (table, data) => request.post(`/data/${table}/page`, data)
+export const crudGet = (table, id) => request.get(`/data/${table}/${id}`)
+export const crudAdd = (table, data) => request.post(`/data/${table}/add`, data)
+export const crudUpdate = (table, data) => request.post(`/data/${table}/update`, data)
+export const crudDelete = (table, id) => request.post(`/data/${table}/delete/${id}`)
+export const crudDeleteRange = (table, ids) => request.post(`/data/${table}/deleteRange`, ids)
+export const crudAll = (table) => request.get(`/data/${table}/all`)
+
+// ========== 菜单/基础数据 ==========
+export const getMenus = () => request.get('/basesys/menus')
+
+// ========== 工作台 ==========
+// 工作台聚合数据：统计卡 + 趋势 + 占比 + 待办 + 预警
+export const getWorkBenchSummary = () => request.get('/workbench/summary')
diff --git a/web/src/api/request.js b/web/src/api/request.js
new file mode 100644
index 0000000..6c2669a
--- /dev/null
+++ b/web/src/api/request.js
@@ -0,0 +1,59 @@
+import axios from 'axios'
+import { ElMessage } from 'element-plus'
+import { useUserStore } from '@/stores/user'
+import router from '@/router'
+
+// 创建 axios 实例
+const service = axios.create({
+  baseURL: '/api',
+  timeout: 30000
+})
+
+// 请求拦截器：附加 token
+service.interceptors.request.use(
+  (config) => {
+    const userStore = useUserStore()
+    if (userStore.token) {
+      config.headers.Authorization = `Bearer ${userStore.token}`
+    }
+    return config
+  },
+  (error) => Promise.reject(error)
+)
+
+// 响应拦截器：统一处理业务码与错误
+service.interceptors.response.use(
+  (response) => {
+    const res = response.data
+    // 非 ApiResult 结构（如文件流）直接返回
+    if (res === null || typeof res !== 'object' || !('code' in res)) {
+      return res
+    }
+    if (res.code !== 0) {
+      if (res.code === 401) {
+        const userStore = useUserStore()
+        userStore.logout()
+        router.push('/login')
+        ElMessage.error('登录已过期，请重新登录')
+      } else {
+        ElMessage.error(res.message || '请求失败')
+      }
+      return Promise.reject(new Error(res.message || '请求失败'))
+    }
+    return res
+  },
+  (error) => {
+    const status = error.response?.status
+    if (status === 401) {
+      const userStore = useUserStore()
+      userStore.logout()
+      router.push('/login')
+      ElMessage.error('登录已过期，请重新登录')
+    } else {
+      ElMessage.error(error.response?.data?.message || error.message || '网络错误')
+    }
+    return Promise.reject(error)
+  }
+)
+
+export default service
diff --git a/web/src/components/CrudPage.vue b/web/src/components/CrudPage.vue
new file mode 100644
index 0000000..71f523b
--- /dev/null
+++ b/web/src/components/CrudPage.vue
@@ -0,0 +1,547 @@
+<template>
+  <div class="crud-page">
+    <!-- 搜索栏 -->
+    <el-card shadow="never" class="search-card">
+      <div class="flex-between">
+        <div class="flex" style="gap: 12px; flex-wrap: wrap">
+          <el-input
+            v-model="query.keyword"
+            placeholder="输入关键字搜索"
+            clearable
+            style="width: 220px"
+            @keyup.enter="handleSearch"
+            @clear="handleSearch"
+          >
+            <template #prefix>
+              <el-icon><Search /></el-icon>
+            </template>
+          </el-input>
+          <el-select
+            v-for="f in searchSelects"
+            :key="'s' + f.name"
+            v-model="query.filters[f.name]"
+            :placeholder="f.label"
+            clearable
+            filterable
+            style="width: 180px"
+            @change="handleSearch"
+          >
+            <el-option
+              v-if="f.options && f.options.length"
+              v-for="opt in f.options"
+              :key="opt.value"
+              :label="opt.label"
+              :value="opt.value"
+            />
+            <el-option
+              v-else
+              v-for="opt in refCache[f.refTable]?.items || []"
+              :key="opt.value"
+              :label="opt.label"
+              :value="opt.value"
+            />
+          </el-select>
+          <el-button type="primary" @click="handleSearch">
+            <el-icon style="margin-right: 4px"><Search /></el-icon>查询
+          </el-button>
+          <el-button @click="handleReset">重置</el-button>
+        </div>
+        <div class="flex" style="gap: 10px">
+          <el-button type="success" @click="openDialog()">
+            <el-icon style="margin-right: 4px"><Plus /></el-icon>新增
+          </el-button>
+          <el-button type="danger" :disabled="!selection.length" @click="handleBatchDelete">
+            <el-icon style="margin-right: 4px"><Delete /></el-icon>批量删除
+          </el-button>
+          <el-button @click="loadData">
+            <el-icon style="margin-right: 4px"><Refresh /></el-icon>刷新
+          </el-button>
+        </div>
+      </div>
+    </el-card>
+
+    <!-- 数据表格 -->
+    <el-card shadow="never" class="table-card">
+      <el-table
+        v-loading="loading"
+        :data="rows"
+        border
+        stripe
+        style="width: 100%"
+        @selection-change="(val) => (selection = val)"
+      >
+        <el-table-column type="selection" width="46" align="center" />
+        <el-table-column type="index" label="#" width="52" align="center" />
+        <el-table-column
+          v-for="col in tableCols"
+          :key="col.name"
+          :prop="col.name"
+          :label="col.label"
+          :min-width="colWidth(col)"
+          :show-overflow-tooltip="true"
+          align="left"
+        >
+          <template #default="{ row }">
+            <!-- 枚举：标签展示 -->
+            <el-tag v-if="col.options?.length" :type="tagType(row[col.name])" size="small">
+              {{ enumLabel(col, row[col.name]) }}
+            </el-tag>
+            <!-- 关联：显示名称 -->
+            <template v-else-if="col.refTable">
+              {{ refLabel(col, row[col.name]) }}
+            </template>
+            <!-- 进度：进度条展示 -->
+            <el-progress
+              v-else-if="isProgressCol(col)"
+              :percentage="Math.round(Number(row[col.name]) || 0)"
+              :status="Number(row[col.name]) >= 100 ? 'success' : undefined"
+              :stroke-width="10"
+              style="width: 130px"
+            />
+            <!-- 布尔 -->
+            <template v-else-if="col.propType === 'Boolean'">
+              <el-tag :type="row[col.name] ? 'success' : 'info'" size="small">
+                {{ row[col.name] ? '是' : '否' }}
+              </el-tag>
+            </template>
+            <template v-else-if="isDateType(col)">
+              {{ formatDate(row[col.name]) }}
+            </template>
+            <template v-else-if="isNumberType(col)">
+              {{ formatNumber(row[col.name], col) }}
+            </template>
+            <template v-else>
+              {{ row[col.name] }}
+            </template>
+          </template>
+        </el-table-column>
+        <el-table-column label="操作" :width="detailRoute ? 200 : 160" align="center" fixed="right">
+          <template #default="{ row }">
+            <el-button
+              v-if="detailRoute"
+              link
+              type="primary"
+              size="small"
+              @click="handleDetail(row)"
+            >详情</el-button>
+            <el-button link type="primary" size="small" @click="openDialog(row)">编辑</el-button>
+            <el-button link type="danger" size="small" @click="handleDelete(row)">删除</el-button>
+          </template>
+        </el-table-column>
+      </el-table>
+
+      <!-- 分页 -->
+      <div class="pagination-wrap">
+        <el-pagination
+          v-model:current-page="query.page"
+          v-model:page-size="query.size"
+          :total="total"
+          :page-sizes="[10, 20, 50, 100]"
+          layout="total, sizes, prev, pager, next, jumper"
+          background
+          @size-change="loadData"
+          @current-change="loadData"
+        />
+      </div>
+    </el-card>
+
+    <!-- 新增/编辑对话框 -->
+    <el-dialog
+      v-model="dialogVisible"
+      :title="dialogTitle"
+      width="640px"
+      destroy-on-close
+      :close-on-click-modal="false"
+    >
+      <el-form ref="formRef" :model="form" :rules="rules" label-width="130px">
+        <el-row :gutter="16">
+          <el-col v-for="f in formFields" :key="f.name" :span="f.span || 12">
+            <el-form-item :label="f.label" :prop="f.name">
+              <!-- 业务编号：只读展示（新增时自动生成） -->
+              <el-input v-if="f.isCode" v-model="form[f.name]" disabled placeholder="自动生成" />
+              <!-- 主键编辑时只读展示 -->
+              <el-input v-else-if="f.isIdentity && isEdit" v-model="form[f.name]" disabled />
+              <!-- 枚举：下拉选择 -->
+              <el-select
+                v-else-if="f.options?.length"
+                v-model="form[f.name]"
+                :placeholder="'请选择' + f.label"
+                style="width: 100%"
+                clearable
+                filterable
+              >
+                <el-option
+                  v-for="opt in f.options"
+                  :key="opt.value"
+                  :label="opt.label"
+                  :value="opt.value"
+                />
+              </el-select>
+              <!-- 关联：远程下拉 -->
+              <el-select
+                v-else-if="f.refTable"
+                v-model="form[f.name]"
+                :placeholder="'请选择' + f.label"
+                style="width: 100%"
+                clearable
+                filterable
+                :loading="refLoading(f)"
+              >
+                <el-option
+                  v-for="opt in refCache[refKey(f)]?.items || []"
+                  :key="opt.value"
+                  :label="opt.label"
+                  :value="opt.value"
+                />
+              </el-select>
+              <!-- 文本/长文本 -->
+              <el-input
+                v-else-if="isTextType(f)"
+                v-model="form[f.name]"
+                :placeholder="'请输入' + f.label"
+                :rows="controlType(f) === 'textarea' ? 3 : undefined"
+                :type="controlType(f) === 'textarea' ? 'textarea' : 'text'"
+                clearable
+              />
+              <!-- 数字 -->
+              <el-input-number
+                v-else-if="isNumberType(f)"
+                v-model="form[f.name]"
+                :controls-position="'right'"
+                :precision="isDecimalType(f) ? 2 : 0"
+                :min="null"
+                style="width: 100%"
+                placeholder="请输入"
+              />
+              <!-- 日期 -->
+              <el-date-picker
+                v-else-if="isDateType(f)"
+                v-model="form[f.name]"
+                type="datetime"
+                value-format="YYYY-MM-DD HH:mm:ss"
+                placeholder="请选择时间"
+                style="width: 100%"
+              />
+              <!-- 布尔 -->
+              <el-switch v-else-if="f.propType === 'Boolean'" v-model="form[f.name]" />
+              <!-- 其他 -->
+              <el-input v-else v-model="form[f.name]" placeholder="请输入" clearable />
+            </el-form-item>
+          </el-col>
+        </el-row>
+      </el-form>
+      <template #footer>
+        <el-button @click="dialogVisible = false">取消</el-button>
+        <el-button type="primary" :loading="saving" @click="handleSave">保存</el-button>
+      </template>
+    </el-dialog>
+  </div>
+</template>
+
+<script setup>
+import { ref, reactive, computed, onMounted, nextTick } from 'vue'
+import { useRoute, useRouter } from 'vue-router'
+import { ElMessage, ElMessageBox } from 'element-plus'
+import {
+  getTableMeta, crudPage, crudAdd, crudUpdate, crudDelete, crudDeleteRange,
+  getRefs, genCode
+} from '@/api'
+
+const props = defineProps({
+  /** 数据表名（未传时从路由 meta.tableName 读取） */
+  table: { type: String, default: '' },
+  /** 页面标题（未传时从路由 meta.title 读取） */
+  title: { type: String, default: '' }
+})
+
+const route = useRoute()
+const router = useRouter()
+const tableName = computed(() => props.table || route.meta.tableName || '')
+const pageTitle = computed(() => props.title || route.meta.title || '')
+/** 详情页路由（:id 占位，由菜单映射配置） */
+const detailRoute = computed(() => route.meta.detailRoute || '')
+
+// ================= 状态 =================
+const loading = ref(false)
+const saving = ref(false)
+const rows = ref([])
+const total = ref(0)
+const selection = ref([])
+const fields = ref([])
+const query = reactive({ page: 1, size: 20, keyword: '', filters: {} })
+
+const dialogVisible = ref(false)
+const form = ref({})
+const formRef = ref()
+const isEdit = ref(false)
+const rules = ref({})
+
+/** 关联表缓存：refTable -> { items: [{value,label}], loading } */
+const refCache = reactive({})
+
+// ================= 计算属性 =================
+const SYSTEM_FIELDS = ['Flag', 'AddTime', 'Adder', 'UpdateTime', 'Updater']
+
+/** 表格列：排除系统字段与主键 */
+const tableCols = computed(() =>
+  fields.value.filter((f) => !f.isSystem && !(f.isIdentity && f.name.toLowerCase() === 'id'))
+)
+
+/** 表单字段：排除系统字段与自增主键（主键由数据库维护） */
+const formFields = computed(() =>
+  fields.value.filter((f) => !f.isSystem && !f.isIdentity)
+)
+
+/** 搜索区下拉：枚举/关联字段 */
+const searchSelects = computed(() =>
+  tableCols.value.filter((f) => f.options?.length || f.refTable)
+)
+
+const dialogTitle = computed(() =>
+  isEdit.value ? `编辑${pageTitle.value}` : `新增${pageTitle.value}`
+)
+
+// ================= 控件类型 =================
+const isTextType = (f) => f.propType === 'String'
+const isNumberType = (f) =>
+  ['Int16', 'Int32', 'Int64', 'Decimal', 'Double', 'Single', 'Byte', 'Long'].includes(f.propType)
+/** 进度字段（名称为 Progress/进度）用进度条展示 */
+const isProgressCol = (f) =>
+  ['Progress', 'progress'].includes(f.name) && !f.isSystem
+const isDecimalType = (f) => ['Decimal', 'Double', 'Single'].includes(f.propType)
+const isDateType = (f) => f.propType === 'DateTime' || f.dbType?.includes('date')
+
+/** 表单控件类型：code(编号) / select(枚举) / ref(关联) / switch / date / number / textarea / text */
+const controlType = (f) => {
+  if (f.isCode) return 'code'
+  if (f.options?.length) return 'select'
+  if (f.refTable) return 'ref'
+  if (f.propType === 'Boolean') return 'switch'
+  if (isDateType(f)) return 'date'
+  if (isNumberType(f)) return 'number'
+  if (f.dbType && f.dbType.includes('text')) return 'textarea'
+  if (f.propType === 'String' && /(备注|说明|描述|内容|意见|原因|地址)/.test(f.label)) return 'textarea'
+  return 'text'
+}
+
+const colWidth = (f) => {
+  if (f.propType === 'DateTime') return 170
+  if (isNumberType(f)) return 110
+  if (f.dbType && f.dbType.includes('text')) return 200
+  if (f.options?.length || f.refTable) return 120
+  return 130
+}
+
+// ================= 格式化 =================
+const formatDate = (v) => (v ? String(v).replace('T', ' ').slice(0, 19) : '')
+const formatNumber = (v, col) => {
+  if (v === null || v === undefined) return ''
+  return isDecimalType(col) ? Number(v).toFixed(2) : v
+}
+
+const ENUM_TAG_TYPES = { 0: 'info', 1: 'success', 2: 'warning', 3: 'danger' }
+const tagType = (v) => ENUM_TAG_TYPES[v] || 'info'
+const enumLabel = (col, v) => col.options.find((o) => o.value === v)?.label ?? (v ?? '')
+
+/** 关联字段显示名称 */
+const refLabel = (col, v) => {
+  if (v === null || v === undefined || v === '') return ''
+  const cache = refCache[refKey(col)]
+  return cache?.map?.[v] ?? v
+}
+
+const refLoading = (f) => !!refCache[refKey(f)]?.loading
+
+/** 关联下拉缓存 key：表名 + 过滤条件（同表多类型下拉区分缓存） */
+const refKey = (f) => {
+  if (!f?.refTable) return ''
+  return f.refFilterField ? `${f.refTable}|${f.refFilterField}=${f.refFilterValue}` : f.refTable
+}
+
+// ================= 数据加载 =================
+async function loadMeta() {
+  const res = await getTableMeta(tableName.value)
+  // 字段名统一转 camelCase，与数据接口返回的行 key 保持一致
+  fields.value = (res.data.fields || []).map((f) => ({
+    ...f,
+    name: f.name.charAt(0).toLowerCase() + f.name.slice(1)
+  }))
+  // 预加载所有关联表下拉数据（按 表+过滤条件 去重）
+  const keys = [...new Set(fields.value.filter((f) => f.refTable).map(refKey))]
+  await Promise.all(keys.map(loadRefs))
+  document.title = `${pageTitle.value || res.data.title} - F9智慧缫丝系统`
+}
+
+/** 加载关联表下拉（带缓存；支持同表多类型过滤） */
+async function loadRefs(key) {
+  if (!key || refCache[key]) return
+  const [table, filter] = key.split('|')
+  let filterField, filterValue
+  if (filter) {
+    const eq = filter.indexOf('=')
+    filterField = filter.slice(0, eq)
+    filterValue = filter.slice(eq + 1)
+  }
+  refCache[key] = { items: [], map: {}, loading: true }
+  try {
+    const res = await getRefs(table, { size: 500, filterField, filterValue })
+    if (res.code === 0 && Array.isArray(res.data)) {
+      const map = {}
+      res.data.forEach((i) => { map[i.value] = i.label })
+      refCache[key] = { items: res.data, map, loading: false }
+    } else {
+      refCache[key] = { items: [], map: {}, loading: false }
+    }
+  } catch (e) {
+    refCache[key] = { items: [], map: {}, loading: false }
+  }
+}
+
+async function loadData() {
+  loading.value = true
+  try {
+    const params = {
+      page: query.page,
+      size: query.size,
+      keyword: query.keyword || ''
+    }
+    const filters = Object.entries(query.filters).filter(([, v]) => v !== '' && v !== null && v !== undefined)
+    if (filters.length) params.where = Object.fromEntries(filters)
+
+    const res = await crudPage(tableName.value, params)
+    rows.value = res.data?.items || []
+    total.value = res.data?.total || 0
+  } finally {
+    loading.value = false
+  }
+}
+
+function handleSearch() {
+  query.page = 1
+  loadData()
+}
+
+function handleReset() {
+  query.keyword = ''
+  query.filters = {}
+  query.page = 1
+  loadData()
+}
+
+// ================= 新增/编辑 =================
+async function openDialog(row) {
+  isEdit.value = !!row
+  form.value = {}
+  rules.value = {}
+  if (row) {
+    nextTick(() => {
+      Object.keys(row).forEach((k) => {
+        form.value[k] = row[k]
+      })
+    })
+  } else {
+    // 新增：自动生成业务编号
+    const codeField = formFields.value.find((f) => f.isCode)
+    if (codeField) {
+      try {
+        const res = await genCode(tableName.value, codeField.name)
+        if (res.code === 0) form.value[codeField.name] = res.data.value
+      } catch (e) {
+        /* 编号生成失败静默，用户可手动填写 */
+      }
+    }
+  }
+  dialogVisible.value = true
+}
+
+async function handleSave() {
+  saving.value = true
+  try {
+    const payload = { ...form.value }
+    // 清理系统字段，避免误传
+    SYSTEM_FIELDS.forEach((k) => delete payload[k])
+    if (!isEdit.value) delete payload.Id
+    // 清空未填写的空串，避免脏数据
+    formFields.value.forEach((f) => {
+      const v = payload[f.name]
+      if (v === '' || v === null || v === undefined) delete payload[f.name]
+    })
+
+    if (isEdit.value) {
+      await crudUpdate(tableName.value, payload)
+      ElMessage.success('修改成功')
+    } else {
+      await crudAdd(tableName.value, payload)
+      ElMessage.success('新增成功')
+    }
+    dialogVisible.value = false
+    loadData()
+  } catch (e) {
+    // 错误已由拦截器统一提示
+  } finally {
+    saving.value = false
+  }
+}
+
+// ================= 详情 =================
+function handleDetail(row) {
+  if (!detailRoute.value) return
+  router.push(detailRoute.value.replace(':id', row.Id))
+}
+
+// ================= 删除 =================
+async function handleDelete(row) {
+  await ElMessageBox.confirm(`确定删除「${pageTitle.value}」这条记录吗？`, '删除确认', {
+    type: 'warning',
+    confirmButtonText: '删除',
+    cancelButtonText: '取消'
+  })
+  await crudDelete(tableName.value, row.Id)
+  ElMessage.success('删除成功')
+  loadData()
+}
+
+async function handleBatchDelete() {
+  if (!selection.value.length) return
+  await ElMessageBox.confirm(
+    `确定删除选中的 ${selection.value.length} 条记录吗？`,
+    '批量删除确认',
+    { type: 'warning', confirmButtonText: '删除', cancelButtonText: '取消' }
+  )
+  const ids = selection.value.map((r) => r.Id)
+  await crudDeleteRange(tableName.value, ids)
+  ElMessage.success('批量删除成功')
+  loadData()
+}
+
+// ================= 初始化 =================
+onMounted(async () => {
+  await loadMeta()
+  await loadData()
+})
+</script>
+
+<style scoped>
+.crud-page {
+  display: flex;
+  flex-direction: column;
+  gap: 12px;
+}
+.search-card {
+  border: none;
+}
+.search-card :deep(.el-card__body) {
+  padding: 14px 16px;
+}
+.table-card {
+  border: none;
+}
+.table-card :deep(.el-card__body) {
+  padding: 8px 12px 12px;
+}
+.pagination-wrap {
+  display: flex;
+  justify-content: flex-end;
+  margin-top: 14px;
+}
+</style>
diff --git a/web/src/components/TagsView.vue b/web/src/components/TagsView.vue
new file mode 100644
index 0000000..9c923a8
--- /dev/null
+++ b/web/src/components/TagsView.vue
@@ -0,0 +1,193 @@
+<template>
+  <div class="tags-view">
+    <div class="tags-wrap">
+      <div
+        v-for="tab in visitedTabs"
+        :key="tab.path"
+        class="tag-item"
+        :class="{ active: tab.path === route.path }"
+        @click="goTab(tab)"
+        @contextmenu.prevent="openMenu($event, tab)"
+      >
+        <span class="dot" v-if="!tab.closable" />
+        <span class="tag-title">{{ tab.title }}</span>
+        <el-icon v-if="tab.closable" :size="12" class="tag-close" @click.stop="closeTab(tab)">
+          <Close />
+        </el-icon>
+      </div>
+    </div>
+
+    <!-- 右键菜单 -->
+    <div
+      v-show="menu.visible"
+      class="ctx-menu"
+      :style="{ left: menu.left + 'px', top: menu.top + 'px' }"
+    >
+      <div class="ctx-item" :class="{ disabled: !menu.tab || menu.tab.affix }" @click="closeCurrent">
+        关闭当前
+      </div>
+      <div class="ctx-item" @click="closeOthers">关闭其他</div>
+      <div class="ctx-item" @click="closeAll">关闭全部</div>
+    </div>
+  </div>
+</template>
+
+<script setup>
+import { ref, computed, onMounted, onBeforeUnmount } from 'vue'
+import { useRoute, useRouter } from 'vue-router'
+import { Close } from '@element-plus/icons-vue'
+import { useTabsStore } from '@/stores/tabs'
+
+const route = useRoute()
+const router = useRouter()
+const tabsStore = useTabsStore()
+
+const visitedTabs = computed(() => tabsStore.tabs)
+const menu = ref({ visible: false, left: 0, top: 0, tab: null })
+
+/** 点击页签切换 */
+const goTab = (tab) => {
+  if (tab.path === route.path) return
+  router.push(tab.fullPath || tab.path)
+}
+
+/** 关闭单个页签：若关闭的是当前激活页签，跳转到右侧/左侧相邻页签 */
+const closeTab = (tab) => {
+  const index = tabsStore.tabs.findIndex((t) => t.path === tab.path)
+  if (index === -1 || tab.affix) return
+  tabsStore.removeTab(tab.path)
+  if (tab.path === route.path) {
+    const tabs = tabsStore.tabs
+    const next = tabs[index] || tabs[index - 1] || tabs[tabs.length - 1]
+    router.push(next ? next.fullPath : '/workbench')
+  }
+}
+
+const openMenu = (e, tab) => {
+  menu.value = { visible: true, left: e.clientX, top: e.clientY, tab }
+}
+
+const closeCurrent = () => {
+  const tab = menu.value.tab
+  menu.value.visible = false
+  if (tab) closeTab(tab)
+}
+
+const closeOthers = () => {
+  const tab = menu.value.tab
+  if (!tab) return
+  menu.value.visible = false
+  tabsStore.closeOthers(tab.path)
+  if (tab.path !== route.path) router.push(tab.fullPath || tab.path)
+}
+
+const closeAll = () => {
+  menu.value.visible = false
+  tabsStore.closeAll()
+  if (!tabsStore.tabs.some((t) => t.path === route.path)) {
+    const affix = tabsStore.tabs[0]
+    router.push(affix ? affix.fullPath : '/workbench')
+  }
+}
+
+// 点击页签栏以外区域关闭右键菜单
+const closeMenu = () => {
+  menu.value.visible = false
+}
+
+onMounted(() => document.addEventListener('click', closeMenu))
+onBeforeUnmount(() => document.removeEventListener('click', closeMenu))
+</script>
+
+<style scoped>
+.tags-view {
+  height: 38px;
+  background: #fff;
+  border-bottom: 1px solid #e4e7ed;
+  padding: 5px 10px 0;
+  box-sizing: border-box;
+  user-select: none;
+}
+.tags-wrap {
+  display: flex;
+  align-items: center;
+  gap: 6px;
+  height: 32px;
+  white-space: nowrap;
+  overflow-x: auto;
+  overflow-y: hidden;
+  scrollbar-width: none;
+}
+.tags-wrap::-webkit-scrollbar {
+  display: none;
+}
+.tag-item {
+  display: inline-flex;
+  align-items: center;
+  gap: 4px;
+  height: 26px;
+  padding: 0 10px;
+  font-size: 12px;
+  color: #495060;
+  background: #fff;
+  border: 1px solid #d8dce5;
+  border-radius: 3px;
+  cursor: pointer;
+  flex-shrink: 0;
+  transition: all 0.2s;
+}
+.tag-item:hover {
+  color: var(--el-color-primary);
+  border-color: var(--el-color-primary);
+}
+.tag-item.active {
+  color: #fff;
+  background: var(--el-color-primary);
+  border-color: var(--el-color-primary);
+}
+.tag-item.active .dot {
+  background: #fff;
+}
+.dot {
+  width: 8px;
+  height: 8px;
+  border-radius: 50%;
+  background: var(--el-color-primary);
+  flex-shrink: 0;
+}
+.tag-title {
+  line-height: 1;
+}
+.tag-close {
+  border-radius: 50%;
+  padding: 1px;
+  transition: background 0.2s;
+}
+.tag-close:hover {
+  background: rgba(0, 0, 0, 0.2);
+  color: #fff;
+}
+.ctx-menu {
+  position: fixed;
+  z-index: 3000;
+  min-width: 110px;
+  background: #fff;
+  border-radius: 4px;
+  box-shadow: 0 2px 12px rgba(0, 0, 0, 0.15);
+  padding: 4px 0;
+}
+.ctx-item {
+  padding: 7px 16px;
+  font-size: 13px;
+  color: #303133;
+  cursor: pointer;
+}
+.ctx-item:hover {
+  background: #f0f2f5;
+  color: var(--el-color-primary);
+}
+.ctx-item.disabled {
+  color: #c0c4cc;
+  cursor: not-allowed;
+}
+</style>
diff --git a/web/src/config/table-map.js b/web/src/config/table-map.js
new file mode 100644
index 0000000..dc5a47b
--- /dev/null
+++ b/web/src/config/table-map.js
@@ -0,0 +1,141 @@
+/**
+ * 菜单 component → 后端数据表名 映射表
+ * key 为后端菜单 Component（模块/页面），value 为 API 数据表名
+ * 未列入的 component 将按默认规则 "Module_PascalPage" 推断
+ */
+const TABLE_MAP = {
+  'BaseCommon/material': 'BaseCommon_Material',
+  'BaseCommon/spec': 'BaseCommon_SilkSpec',
+  'BaseCommon/grade': 'BaseCommon_GradeStandard',
+  'BaseCommon/partner': 'BaseCommon_Partner',
+  'BaseCommon/period': 'BaseCommon_AccountPeriod',
+  'BaseCommon/worktype': 'BaseCommon_WorkType',
+  'BaseCommon/dict': 'BaseCommon_Dict',
+
+  'RawMaterial/zhuangkou': 'RawMaterial_Zhuangkou',
+  'RawMaterial/instock': 'RawMaterial_InStock',
+  'RawMaterial/repack': 'RawMaterial_Repack',
+  'RawMaterial/outstock': 'RawMaterial_OutStock',
+  'RawMaterial/stock': 'RawMaterial_Stock',
+  'RawMaterial/purchase': 'RawMaterial_Purchase',
+
+  'Process/zhuangkou': 'Process_ProcessZhuangkou',
+  'Process/trial': 'Process_Trial',
+  'Process/index': 'Process_Index',
+  'Process/sheet': 'Process_Sheet',
+
+  'ProPlan/workorder': 'ProPlan_WorkOrder',
+  'ProPlan/change': 'ProPlan_Change',
+
+  'ProXuan/team': 'ProXuan_Team',
+  'ProXuan/daily': 'ProXuan_Daily',
+  'ProXuan/quality': 'ProXuan_Quality',
+  'ProXuan/tempstock': 'ProXuan_TempStock',
+
+  'ProQian/workshop': 'ProQian_Workshop',
+  'ProQian/machine': 'ProQian_Machine',
+  'ProQian/schedule': 'ProQian_Schedule',
+  'ProQian/shifttime': 'ProQian_ShiftTime',
+  'ProQian/cocoon': 'ProQian_CocoonBoiling',
+  'ProQian/thread': 'ProQian_ThreadRecord',
+
+  'ProHou/daily': 'ProHou_Daily',
+  'ProHou/spool': 'ProHou_SpoolLedger',
+  'ProHou/check': 'ProHou_SpoolCheck',
+  'ProHou/weigh': 'ProHou_WeighBig',
+
+  'Lims/spoolcheck': 'Lims_SpoolCheck',
+  'Lims/blackboard': 'Lims_BlackBoard',
+  'Lims/denier': 'Lims_Denier',
+  'Lims/moisture': 'Lims_Moisture',
+  'Lims/abnormal': 'Lims_Abnormal',
+  'Lims/grade': 'Lims_GradeResult',
+
+  'Fims/batch': 'Fims_Batch',
+  'Fims/package': 'Fims_Package',
+  'Fims/instock': 'Fims_InStock',
+  'Fims/outstock': 'Fims_OutStock',
+  'Fims/stock': 'Fims_Stock',
+
+  'Sams/customer': 'Sams_Customer',
+  'Sams/contract': 'Sams_Contract',
+  'Sams/dispatch': 'Sams_DispatchPlan',
+  'Sams/payment': 'Sams_Payment',
+  'Sams/invoice': 'Sams_Invoice',
+
+  'HRS/employee': 'HRS_Employee',
+  'HRS/change': 'HRS_EmployeeChange',
+  'HRS/attendance': 'HRS_Attendance',
+  'HRS/dorm': 'HRS_Dorm',
+  'HRS/canteen': 'HRS_CanteenRecord',
+
+  'FlexPay/config': 'FlexPay_Config',
+  'FlexPay/scheme': 'FlexPay_Scheme',
+  'FlexPay/reward': 'FlexPay_Reward',
+  'FlexPay/piece': 'FlexPay_PieceResult',
+  'FlexPay/salary': 'FlexPay_Salary',
+  'FlexPay/payroll': 'FlexPay_Payroll',
+
+  'Enms/meter': 'Enms_Meter',
+  'Enms/reading': 'Enms_Reading',
+  'Enms/rule': 'Enms_AllocateRule',
+  'Enms/result': 'Enms_AllocateResult',
+
+  'Qums/grain': 'Qums_GrainCount',
+  'Qums/task': 'Qums_CheckTask',
+
+  'WmsWu/stock': 'WmsWu_Stock',
+  'WmsWu/instock': 'WmsWu_InStock',
+  'WmsWu/outstock': 'WmsWu_OutStock',
+  'WmsWu/plan': 'WmsWu_PurchasePlan',
+  'WmsWu/apply': 'WmsWu_Apply',
+  'WmsWu/ledger': 'WmsWu_Ledger',
+
+  'WmsFu/stock': 'WmsFu_Stock',
+  'WmsFu/instock': 'WmsFu_InStock',
+  'WmsFu/outstock': 'WmsFu_OutStock',
+
+  'BizBoss/cost': 'BizBoss_CostAllocate',
+  'BizBoss/profit': 'BizBoss_Profit',
+
+  'RepCenter/report': 'RepCenter_Report',
+  'RepCenter/design': 'RepCenter_ReportDesign',
+
+  'BoardCenter/board': 'BoardCenter_Board',
+
+  'ApiCenter/internal': 'ApiCenter_InternalApi',
+  'ApiCenter/external': 'ApiCenter_ExternalApi',
+  'ApiCenter/sync': 'ApiCenter_SyncLog',
+
+  'BaseSys/menu': 'BaseSys_Menu',
+  'BaseSys/org': 'BaseSys_Org',
+  'BaseSys/role': 'BaseSys_Role',
+  'BaseSys/user': 'BaseSys_User'
+}
+
+/** 根据 component 推断表名 */
+export function resolveTable(component) {
+  if (!component) return null
+  if (TABLE_MAP[component]) return TABLE_MAP[component]
+  // 默认规则：Module/page → Module_PascalPage
+  const [mod, page] = component.split('/')
+  if (!page) return null
+  const pascal = page.charAt(0).toUpperCase() + page.slice(1)
+  return `${mod}_${pascal}`
+}
+
+/** 特殊页面：不经过通用 CRUD（如工作台、看板） */
+export const SPECIAL_PAGES = new Set(['WorkBench/index'])
+
+/**
+ * 详情页映射：component → 详情页路由（:id 占位替换）
+ * 配置后，通用 CRUD 列表操作列会显示"详情"按钮
+ */
+export const DETAIL_MAP = {
+  'Process/zhuangkou': '/process/zhuangkou-detail'
+}
+
+/** 根据 component 解析详情页路由（无则返回 null） */
+export function resolveDetail(component) {
+  return component ? DETAIL_MAP[component] || null : null
+}
diff --git a/web/src/layout/index.vue b/web/src/layout/index.vue
new file mode 100644
index 0000000..252d5a2
--- /dev/null
+++ b/web/src/layout/index.vue
@@ -0,0 +1,304 @@
+<template>
+  <el-container class="layout">
+    <!-- 侧边栏 -->
+    <el-aside :width="collapse ? '64px' : '220px'" class="aside">
+      <div class="logo" @click="$router.push('/workbench')">
+        <span class="logo-icon">🧵</span>
+        <span v-show="!collapse" class="logo-text">F9 智慧缫丝 MES</span>
+      </div>
+      <el-scrollbar class="menu-scroll">
+        <el-menu
+          :default-active="activeMenu"
+          :collapse="collapse"
+          :collapse-transition="false"
+          router
+          background-color="#001529"
+          text-color="rgba(255,255,255,0.68)"
+          active-text-color="#ffffff"
+          unique-opened
+        >
+          <template v-for="menu in menus" :key="menu.id">
+            <!-- 有子菜单 -->
+            <el-sub-menu v-if="menu.children && menu.children.length" :index="String(menu.id)">
+              <template #title>
+                <el-icon v-if="menu.icon"><component :is="menu.icon" /></el-icon>
+                <span>{{ menu.title }}</span>
+              </template>
+              <el-menu-item
+                v-for="child in menu.children"
+                :key="child.id"
+                :index="child.path"
+              >
+                <el-icon v-if="child.icon"><component :is="child.icon" /></el-icon>
+                <template #title>{{ child.title }}</template>
+              </el-menu-item>
+            </el-sub-menu>
+            <!-- 无子菜单直接显示 -->
+            <el-menu-item v-else :index="menu.path">
+              <el-icon v-if="menu.icon"><component :is="menu.icon" /></el-icon>
+              <template #title>{{ menu.title }}</template>
+            </el-menu-item>
+          </template>
+        </el-menu>
+      </el-scrollbar>
+    </el-aside>
+
+    <el-container class="main-wrap">
+      <!-- 顶栏 -->
+      <el-header class="navbar" height="52px">
+        <div class="flex-center" style="gap: 4px; cursor: pointer" @click="toggleCollapse">
+          <el-icon :size="20">
+            <Expand v-if="collapse" />
+            <Fold v-else />
+          </el-icon>
+        </div>
+        <el-breadcrumb separator="/" class="breadcrumb">
+          <el-breadcrumb-item v-for="item in breadcrumbs" :key="item.path">
+            {{ item.title }}
+          </el-breadcrumb-item>
+        </el-breadcrumb>
+        <div class="flex-1"></div>
+        <!-- 天气 -->
+        <div class="weather flex-center" v-if="weather">
+          <el-icon><Sunny /></el-icon>
+          <span>{{ weather.temp }}°C</span>
+          <span class="weather-desc">{{ weather.desc }}</span>
+        </div>
+        <el-dropdown trigger="click" @command="handleCommand">
+          <div class="user-info flex-center">
+            <el-avatar :size="30" class="avatar">{{ avatarText }}</el-avatar>
+            <span class="user-name">{{ userStore.userName }}</span>
+            <el-icon><ArrowDown /></el-icon>
+          </div>
+          <template #dropdown>
+            <el-dropdown-menu>
+              <el-dropdown-item command="password">修改密码</el-dropdown-item>
+              <el-dropdown-item divided command="logout">退出登录</el-dropdown-item>
+            </el-dropdown-menu>
+          </template>
+        </el-dropdown>
+      </el-header>
+
+      <!-- 多页签栏 -->
+      <TagsView />
+
+      <!-- 主内容（key 绑定路由 path 区分不同菜单实例；keep-alive 缓存打开过的页签状态） -->
+      <el-main class="content">
+        <keep-alive :max="20">
+          <router-view :key="route.path" />
+        </keep-alive>
+      </el-main>
+    </el-container>
+  </el-container>
+
+  <!-- 修改密码 -->
+  <el-dialog v-model="pwdVisible" title="修改密码" width="420px" destroy-on-close>
+    <el-form ref="pwdFormRef" :model="pwdForm" :rules="pwdRules" label-width="90px">
+      <el-form-item label="原密码" prop="oldPassword">
+        <el-input v-model="pwdForm.oldPassword" type="password" show-password placeholder="请输入原密码" />
+      </el-form-item>
+      <el-form-item label="新密码" prop="newPassword">
+        <el-input v-model="pwdForm.newPassword" type="password" show-password placeholder="6-20位" />
+      </el-form-item>
+      <el-form-item label="确认密码" prop="confirm">
+        <el-input v-model="pwdForm.confirm" type="password" show-password placeholder="再次输入新密码" />
+      </el-form-item>
+    </el-form>
+    <template #footer>
+      <el-button @click="pwdVisible = false">取消</el-button>
+      <el-button type="primary" @click="submitPwd">确定</el-button>
+    </template>
+  </el-dialog>
+</template>
+
+<script setup>
+import { ref, computed, onMounted } from 'vue'
+import { useRoute, useRouter } from 'vue-router'
+import { ElMessage, ElMessageBox } from 'element-plus'
+import { useUserStore } from '@/stores/user'
+import { changePassword, getWeather, mapWeather } from '@/api'
+import TagsView from '@/components/TagsView.vue'
+
+const route = useRoute()
+const router = useRouter()
+const userStore = useUserStore()
+
+const collapse = ref(false)
+const pwdVisible = ref(false)
+const pwdForm = ref({ oldPassword: '', newPassword: '', confirm: '' })
+const pwdFormRef = ref()
+const weather = ref(null)
+
+const menus = computed(() => userStore.menus)
+const activeMenu = computed(() => route.path)
+
+const avatarText = computed(() => (userStore.userName || '管').slice(0, 1))
+
+// 面包屑
+const breadcrumbs = computed(() => {
+  const items = []
+  const path = route.path
+  for (const m of userStore.menus) {
+    if (m.path === path) {
+      items.push({ title: m.title, path: m.path })
+      break
+    }
+    if (m.children) {
+      const child = m.children.find((c) => c.path === path)
+      if (child) {
+        items.push({ title: m.title, path: m.path })
+        items.push({ title: child.title, path: child.path })
+        break
+      }
+    }
+  }
+  return items.length ? items : [{ title: route.meta.title || '', path }]
+})
+
+const toggleCollapse = () => (collapse.value = !collapse.value)
+
+const handleCommand = (cmd) => {
+  if (cmd === 'logout') {
+    ElMessageBox.confirm('确定退出登录吗？', '提示', { type: 'warning' })
+      .then(() => {
+        userStore.logout()
+        router.push('/login')
+      })
+      .catch(() => {})
+  } else if (cmd === 'password') {
+    pwdForm.value = { oldPassword: '', newPassword: '', confirm: '' }
+    pwdVisible.value = true
+  }
+}
+
+const pwdRules = {
+  oldPassword: [{ required: true, message: '请输入原密码', trigger: 'blur' }],
+  newPassword: [
+    { required: true, message: '请输入新密码', trigger: 'blur' },
+    { min: 6, max: 20, message: '密码长度 6-20 位', trigger: 'blur' }
+  ],
+  confirm: [
+    { required: true, message: '请再次输入新密码', trigger: 'blur' },
+    {
+      validator: (r, v, cb) =>
+        v !== pwdForm.value.newPassword ? cb(new Error('两次输入的密码不一致')) : cb(),
+      trigger: 'blur'
+    }
+  ]
+}
+
+async function submitPwd() {
+  await pwdFormRef.value.validate()
+  await changePassword({
+    oldPassword: pwdForm.value.oldPassword,
+    newPassword: pwdForm.value.newPassword
+  })
+  ElMessage.success('密码修改成功，请重新登录')
+  pwdVisible.value = false
+  userStore.logout()
+  router.push('/login')
+}
+
+// 天气
+async function loadWeather() {
+  try {
+    const res = await getWeather({})
+    if (res.code === 0 && res.data) {
+      weather.value = mapWeather(res.data)
+    }
+  } catch (e) {
+    /* 天气失败静默 */
+  }
+}
+
+onMounted(loadWeather)
+</script>
+
+<style scoped>
+.layout {
+  height: 100vh;
+}
+.aside {
+  background: #001529;
+  display: flex;
+  flex-direction: column;
+  transition: width 0.2s;
+  overflow: hidden;
+}
+.logo {
+  height: 52px;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  gap: 8px;
+  color: #fff;
+  font-weight: 600;
+  font-size: 15px;
+  cursor: pointer;
+  background: rgba(255, 255, 255, 0.04);
+  white-space: nowrap;
+  overflow: hidden;
+}
+.logo-icon {
+  font-size: 22px;
+}
+.logo-text {
+  letter-spacing: 1px;
+}
+.menu-scroll {
+  flex: 1;
+}
+.menu-scroll :deep(.el-menu) {
+  border-right: none;
+}
+.menu-scroll :deep(.el-menu-item.is-active) {
+  background: var(--el-color-primary);
+}
+.menu-scroll :deep(.el-menu-item:hover),
+.menu-scroll :deep(.el-sub-menu__title:hover) {
+  background: rgba(255, 255, 255, 0.08);
+}
+.main-wrap {
+  min-width: 0;
+}
+.navbar {
+  background: #fff;
+  border-bottom: 1px solid #e4e7ed;
+  display: flex;
+  align-items: center;
+  gap: 12px;
+}
+.breadcrumb {
+  margin-left: 4px;
+}
+.weather {
+  gap: 4px;
+  font-size: 13px;
+  color: #606266;
+  padding: 0 12px;
+  border-left: 1px solid #e4e7ed;
+}
+.weather-desc {
+  color: #909399;
+}
+.user-info {
+  gap: 6px;
+  cursor: pointer;
+  padding: 0 4px;
+  outline: none;
+}
+.avatar {
+  background: var(--el-color-primary);
+  color: #fff;
+  font-size: 14px;
+}
+.user-name {
+  font-size: 14px;
+  color: #303133;
+}
+.content {
+  padding: 14px;
+  background: #f0f2f5;
+  overflow-y: auto;
+}
+</style>
diff --git a/web/src/main.js b/web/src/main.js
new file mode 100644
index 0000000..8a0c39f
--- /dev/null
+++ b/web/src/main.js
@@ -0,0 +1,31 @@
+import { createApp } from 'vue'
+import { createPinia } from 'pinia'
+import ElementPlus from 'element-plus'
+import zhCn from 'element-plus/es/locale/lang/zh-cn'
+import * as ElementPlusIconsVue from '@element-plus/icons-vue'
+import 'element-plus/dist/index.css'
+import App from './App.vue'
+import router, { registerDynamicRoutes } from './router'
+import { useUserStore } from './stores/user'
+import './styles/index.css'
+
+const pinia = createPinia()
+
+// 刷新恢复：本地已有菜单缓存时先注册动态路由，避免首屏导航 404
+const userStore = useUserStore(pinia)
+if (userStore.isLogin && userStore.menus.length) {
+  registerDynamicRoutes(userStore.menus)
+}
+
+const app = createApp(App)
+
+// 全局注册 Element Plus 图标
+for (const [key, component] of Object.entries(ElementPlusIconsVue)) {
+  app.component(key, component)
+}
+
+app.use(pinia)
+app.use(router)
+app.use(ElementPlus, { locale: zhCn })
+
+app.mount('#app')
diff --git a/web/src/router/index.js b/web/src/router/index.js
new file mode 100644
index 0000000..67a120f
--- /dev/null
+++ b/web/src/router/index.js
@@ -0,0 +1,145 @@
+import { createRouter, createWebHistory } from 'vue-router'
+import { useUserStore } from '@/stores/user'
+import { useTabsStore } from '@/stores/tabs'
+import { resolveTable, resolveDetail, SPECIAL_PAGES } from '@/config/table-map'
+
+// 静态路由（与权限无关）
+export const constantRoutes = [
+  {
+    path: '/login',
+    name: 'Login',
+    component: () => import('@/views/login/index.vue'),
+    meta: { title: '登录' }
+  },
+  {
+    path: '/',
+    name: 'root',
+    component: () => import('@/layout/index.vue'),
+    redirect: '/workbench',
+    children: [
+      {
+        path: '/workbench',
+        name: 'WorkBench',
+        component: () => import('@/views/workbench/index.vue'),
+        meta: { title: '工作台', affix: true }
+      },
+      {
+        path: '/404',
+        name: 'NotFound',
+        component: () => import('@/views/error/404.vue'),
+        meta: { title: '页面不存在' }
+      },
+      {
+        path: '/process/zhuangkou-detail/:id',
+        name: 'ProcessZhuangkouDetail',
+        component: () => import('@/views/process/zhuangkou-detail.vue'),
+        meta: { title: '工艺庄口详情', hidden: true }
+      }
+    ]
+  },
+  {
+    path: '/:pathMatch(.*)*',
+    redirect: '/404',
+    meta: { hidden: true }
+  }
+]
+
+const router = createRouter({
+  history: createWebHistory(),
+  routes: constantRoutes,
+  scrollBehavior: () => ({ top: 0 })
+})
+
+// 拍平菜单树，收集页面节点
+export function flattenMenus(menus, arr = []) {
+  for (const m of menus || []) {
+    if (m.menuType === 1 && !SPECIAL_PAGES.has(m.component)) {
+      arr.push(m)
+    }
+    if (m.children?.length) flattenMenus(m.children, arr)
+  }
+  return arr
+}
+
+// 根据菜单动态注册业务路由
+export function registerDynamicRoutes(menus) {
+  const pages = flattenMenus(menus)
+  for (const p of pages) {
+    if (router.hasRoute(p.name)) continue
+    const table = resolveTable(p.component)
+    router.addRoute('root', {
+      path: p.path,
+      name: p.path || p.component,
+      component: () => import('@/components/CrudPage.vue'),
+      meta: {
+        title: p.title || p.name,
+        tableName: table,
+        component: p.component,
+        detailRoute: resolveDetail(p.component)
+      }
+    })
+  }
+}
+
+let guardInited = false
+
+router.beforeEach(async (to, from, next) => {
+  const userStore = useUserStore()
+
+  if (to.path === '/login') {
+    // 退出登录/未登录跳转登录页时清空页签
+    useTabsStore().reset()
+    next()
+    return
+  }
+
+  if (!userStore.isLogin) {
+    next(`/login?redirect=${encodeURIComponent(to.fullPath)}`)
+    return
+  }
+
+  // 已登录：首次进入加载菜单并注册动态路由
+  if (!userStore.loaded) {
+    try {
+      await userStore.loadMenus()
+      registerDynamicRoutes(userStore.menus)
+      initAffixTabs()
+      guardInited = true
+      next({ ...to, replace: true })
+    } catch (e) {
+      userStore.logout()
+      next(`/login?redirect=${encodeURIComponent(to.fullPath)}`)
+    }
+    return
+  }
+
+  // 刷新后路由已注册但 guard 标记未恢复（页面刷新时 addRoute 丢失）
+  if (!guardInited) {
+    registerDynamicRoutes(userStore.menus)
+    initAffixTabs()
+    guardInited = true
+    next({ ...to, replace: true })
+    return
+  }
+
+  next()
+})
+
+/** 初始化固定页签（工作台） */
+function initAffixTabs() {
+  useTabsStore().addTab({
+    path: '/workbench',
+    fullPath: '/workbench',
+    name: 'WorkBench',
+    meta: { title: '工作台', affix: true }
+  })
+}
+
+// 导航完成后：记录页签、同步浏览器标题（格式与 CrudPage 保持一致）
+router.afterEach((to) => {
+  useTabsStore().addTab(to)
+  const title = to.meta?.title
+  document.title = title ? `${title} - F9智慧缫丝系统` : 'F9智慧缫丝系统'
+})
+
+export default router
diff --git a/web/src/stores/tabs.js b/web/src/stores/tabs.js
new file mode 100644
index 0000000..81cb3ec
--- /dev/null
+++ b/web/src/stores/tabs.js
@@ -0,0 +1,61 @@
+import { defineStore } from 'pinia'
+
+/**
+ * 多页签状态
+ * tab: { path, fullPath, title, name, affix, closable }
+ */
+export const useTabsStore = defineStore('tabs', {
+  state: () => ({
+    tabs: []
+  }),
+
+  getters: {
+    visitedTabs: (state) => state.tabs
+  },
+
+  actions: {
+    /** 添加页签（已存在时仅同步 fullPath）；hidden 页面与无标题页面不进页签 */
+    addTab(route) {
+      if (route.meta?.hidden) return
+      const title = route.meta?.title
+      if (!title) return
+      const path = route.path
+      const existed = this.tabs.find((t) => t.path === path)
+      if (existed) {
+        if (route.fullPath && existed.fullPath !== route.fullPath) existed.fullPath = route.fullPath
+        return
+      }
+      this.tabs.push({
+        path,
+        fullPath: route.fullPath || path,
+        title,
+        name: route.name,
+        affix: !!route.meta?.affix,
+        closable: !route.meta?.affix
+      })
+    },
+
+    /** 移除页签，返回被移除的 tab（不存在或固定页签返回 null） */
+    removeTab(path) {
+      const index = this.tabs.findIndex((t) => t.path === path)
+      if (index === -1) return null
+      const [removed] = this.tabs.splice(index, 1)
+      return removed
+    },
+
+    /** 关闭其他页签（保留固定页签与当前页签） */
+    closeOthers(path) {
+      this.tabs = this.tabs.filter((t) => t.affix || t.path === path)
+    },
+
+    /** 关闭全部页签（仅保留固定页签） */
+    closeAll() {
+      this.tabs = this.tabs.filter((t) => t.affix)
+    },
+
+    /** 清空页签（退出登录时调用） */
+    reset() {
+      this.tabs = []
+    }
+  }
+})
diff --git a/web/src/stores/user.js b/web/src/stores/user.js
new file mode 100644
index 0000000..da2a1f2
--- /dev/null
+++ b/web/src/stores/user.js
@@ -0,0 +1,52 @@
+import { defineStore } from 'pinia'
+import { login as apiLogin, getMe } from '@/api'
+
+const TOKEN_KEY = 'f9mes_token'
+const USER_KEY = 'f9mes_user'
+const MENUS_KEY = 'f9mes_menus'
+
+export const useUserStore = defineStore('user', {
+  state: () => ({
+    token: localStorage.getItem(TOKEN_KEY) || '',
+    userInfo: JSON.parse(localStorage.getItem(USER_KEY) || 'null'),
+    menus: JSON.parse(localStorage.getItem(MENUS_KEY) || '[]'),
+    loaded: false
+  }),
+
+  getters: {
+    isLogin: (state) => !!state.token,
+    userName: (state) =>
+      state.userInfo?.name || state.userInfo?.realName || state.userInfo?.userName || '管理员'
+  },
+
+  actions: {
+    async login(payload) {
+      const res = await apiLogin(payload)
+      this.token = res.data.token
+      this.userInfo = res.data.user
+      localStorage.setItem(TOKEN_KEY, this.token)
+      localStorage.setItem(USER_KEY, JSON.stringify(this.userInfo))
+      await this.loadMenus()
+    },
+
+    async loadMenus() {
+      const res = await getMe()
+      const data = res.data || {}
+      this.menus = data.menus || []
+      if (data.user) this.userInfo = data.user
+      localStorage.setItem(MENUS_KEY, JSON.stringify(this.menus))
+      if (data.user) localStorage.setItem(USER_KEY, JSON.stringify(this.userInfo))
+      this.loaded = true
+    },
+
+    logout() {
+      this.token = ''
+      this.userInfo = null
+      this.menus = []
+      this.loaded = false
+      localStorage.removeItem(TOKEN_KEY)
+      localStorage.removeItem(USER_KEY)
+      localStorage.removeItem(MENUS_KEY)
+    }
+  }
+})
diff --git a/web/src/styles/index.css b/web/src/styles/index.css
new file mode 100644
index 0000000..d935b30
--- /dev/null
+++ b/web/src/styles/index.css
@@ -0,0 +1,76 @@
+* {
+  margin: 0;
+  padding: 0;
+  box-sizing: border-box;
+}
+
+html,
+body,
+#app {
+  height: 100%;
+  font-family: 'Helvetica Neue', Helvetica, 'PingFang SC', 'Hiragino Sans GB',
+    'Microsoft YaHei', Arial, sans-serif;
+  font-size: 14px;
+  color: #303133;
+  background-color: #f0f2f5;
+}
+
+/* 滚动条美化 */
+::-webkit-scrollbar {
+  width: 8px;
+  height: 8px;
+}
+::-webkit-scrollbar-thumb {
+  background: #c0c4cc;
+  border-radius: 4px;
+}
+::-webkit-scrollbar-thumb:hover {
+  background: #909399;
+}
+::-webkit-scrollbar-track {
+  background: transparent;
+}
+
+/* 通用工具类 */
+.flex {
+  display: flex;
+}
+.flex-center {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+}
+.flex-between {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+}
+.flex-1 {
+  flex: 1;
+  min-width: 0;
+}
+.text-right {
+  text-align: right;
+}
+.mt-10 {
+  margin-top: 10px;
+}
+.mb-10 {
+  margin-bottom: 10px;
+}
+
+/* 页面容器 */
+.page-card {
+  background: #fff;
+  border-radius: 6px;
+  padding: 16px;
+}
+
+/* 表格内图片/标签 */
+.avatar-cell img {
+  width: 36px;
+  height: 36px;
+  border-radius: 4px;
+  object-fit: cover;
+  vertical-align: middle;
+}
diff --git a/web/src/views/error/404.vue b/web/src/views/error/404.vue
new file mode 100644
index 0000000..e222116
--- /dev/null
+++ b/web/src/views/error/404.vue
@@ -0,0 +1,32 @@
+<template>
+  <div class="not-found flex-center">
+    <div>
+      <div class="code">404</div>
+      <p class="desc">抱歉，您访问的页面不存在或已被移除</p>
+      <el-button type="primary" @click="$router.push('/workbench')">返回工作台</el-button>
+    </div>
+  </div>
+</template>
+
+<script setup>
+</script>
+
+<style scoped>
+.not-found {
+  height: 100%;
+}
+.code {
+  font-size: 90px;
+  font-weight: 700;
+  color: #409eff;
+  text-align: center;
+  line-height: 1;
+  text-shadow: 0 8px 24px rgba(64, 158, 255, 0.25);
+}
+.desc {
+  margin: 16px 0 24px;
+  color: #909399;
+  font-size: 15px;
+  text-align: center;
+}
+</style>
diff --git a/web/src/views/login/index.vue b/web/src/views/login/index.vue
new file mode 100644
index 0000000..0daa73d
--- /dev/null
+++ b/web/src/views/login/index.vue
@@ -0,0 +1,120 @@
+<template>
+  <div class="login-page">
+    <div class="login-bg"></div>
+    <div class="login-card">
+      <div class="login-header">
+        <div class="login-logo">🧵</div>
+        <h1 class="login-title">F9 智慧缫丝系统</h1>
+        <p class="login-sub">MES 生产执行管理系统</p>
+      </div>
+      <el-form ref="formRef" :model="form" :rules="rules" size="large" @keyup.enter="handleLogin">
+        <el-form-item prop="phone">
+          <el-input v-model="form.phone" placeholder="手机号" clearable>
+            <template #prefix><el-icon><User /></el-icon></template>
+          </el-input>
+        </el-form-item>
+        <el-form-item prop="password">
+          <el-input v-model="form.password" type="password" placeholder="密码" show-password>
+            <template #prefix><el-icon><Lock /></el-icon></template>
+          </el-input>
+        </el-form-item>
+        <el-button type="primary" size="large" class="login-btn" :loading="loading" @click="handleLogin">
+          登 录
+        </el-button>
+      </el-form>
+      <p class="login-tip">默认账号：13800000000　密码：123456</p>
+    </div>
+  </div>
+</template>
+
+<script setup>
+import { ref } from 'vue'
+import { useRoute, useRouter } from 'vue-router'
+import { ElMessage } from 'element-plus'
+import { useUserStore } from '@/stores/user'
+import { registerDynamicRoutes } from '@/router'
+
+const route = useRoute()
+const router = useRouter()
+const userStore = useUserStore()
+
+const form = ref({ phone: '13800000000', password: '123456' })
+const formRef = ref()
+const loading = ref(false)
+
+const rules = {
+  phone: [{ required: true, message: '请输入手机号', trigger: 'blur' }],
+  password: [{ required: true, message: '请输入密码', trigger: 'blur' }]
+}
+
+async function handleLogin() {
+  await formRef.value.validate()
+  loading.value = true
+  try {
+    await userStore.login({ ...form.value })
+    registerDynamicRoutes(userStore.menus)
+    ElMessage.success('登录成功')
+    router.push(route.query.redirect || '/workbench')
+  } catch (e) {
+    /* 错误已统一提示 */
+  } finally {
+    loading.value = false
+  }
+}
+</script>
+
+<style scoped>
+.login-page {
+  height: 100vh;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  position: relative;
+  overflow: hidden;
+  background: linear-gradient(135deg, #0f2027 0%, #203a43 45%, #2c5364 100%);
+}
+.login-bg {
+  position: absolute;
+  inset: 0;
+  background:
+    radial-gradient(ellipse at 20% 20%, rgba(64, 158, 255, 0.18), transparent 50%),
+    radial-gradient(ellipse at 80% 80%, rgba(64, 158, 255, 0.12), transparent 50%);
+}
+.login-card {
+  position: relative;
+  width: 400px;
+  padding: 42px 40px 28px;
+  background: rgba(255, 255, 255, 0.97);
+  border-radius: 12px;
+  box-shadow: 0 20px 60px rgba(0, 0, 0, 0.35);
+}
+.login-header {
+  text-align: center;
+  margin-bottom: 30px;
+}
+.login-logo {
+  font-size: 44px;
+  line-height: 1;
+}
+.login-title {
+  margin: 10px 0 6px;
+  font-size: 22px;
+  color: #1f2d3d;
+  letter-spacing: 2px;
+}
+.login-sub {
+  font-size: 13px;
+  color: #909399;
+}
+.login-btn {
+  width: 100%;
+  letter-spacing: 6px;
+  margin-top: 6px;
+}
+.login-tip {
+  margin-top: 18px;
+  text-align: center;
+  font-size: 12px;
+  color: #c0c4cc;
+}
+</style>
diff --git a/web/src/views/process/zhuangkou-detail.vue b/web/src/views/process/zhuangkou-detail.vue
new file mode 100644
index 0000000..48bc257
--- /dev/null
+++ b/web/src/views/process/zhuangkou-detail.vue
@@ -0,0 +1,329 @@
+<template>
+  <div class="detail-page">
+    <el-page-header @back="goBack" content="工艺庄口详情" />
+
+    <!-- 庄口档案 -->
+    <el-card shadow="never" class="info-card">
+      <el-descriptions :column="4" border>
+        <el-descriptions-item label="庄口编号">
+          <el-tag type="primary" size="small">{{ info.code }}</el-tag>
+        </el-descriptions-item>
+        <el-descriptions-item label="庄口名称">{{ info.name }}</el-descriptions-item>
+        <el-descriptions-item label="原料庄口">{{ zkLabel }}</el-descriptions-item>
+        <el-descriptions-item label="状态">
+          <el-tag :type="statusTagType(info.status)" size="small">
+            {{ enumText('status', info.status) }}
+          </el-tag>
+        </el-descriptions-item>
+        <el-descriptions-item label="生产进度">
+          <el-progress
+            :percentage="Number(info.progress || 0)"
+            :status="Number(info.progress || 0) >= 100 ? 'success' : undefined"
+            :stroke-width="14"
+            style="width: 160px"
+          />
+        </el-descriptions-item>
+        <el-descriptions-item label="试产日期">{{ formatTime(info.trialDate) }}</el-descriptions-item>
+        <el-descriptions-item label="创建时间">{{ formatTime(info.addTime) }}</el-descriptions-item>
+        <el-descriptions-item label="备注" :span="2">{{ info.memo || '—' }}</el-descriptions-item>
+      </el-descriptions>
+    </el-card>
+
+    <!-- 生产链路 -->
+    <el-card shadow="never" class="link-card">
+      <el-tabs v-model="activeTab">
+        <el-tab-pane v-for="sec in sections" :key="sec.key" :name="sec.key">
+          <template #label>
+            <span>{{ sec.title }}</span>
+            <el-badge v-if="sec.total > 0" :value="sec.total" class="tab-badge" />
+          </template>
+          <el-table v-loading="sec.loading" :data="sec.rows" border stripe size="small">
+            <el-table-column type="index" label="#" width="50" align="center" />
+            <el-table-column
+              v-for="col in sec.cols"
+              :key="col.prop"
+              :prop="col.prop"
+              :label="col.label"
+              :width="col.width || 150"
+              :formatter="(row) => fmtCell(sec, col, row)"
+              show-overflow-tooltip
+            />
+            <template #empty>
+              <el-empty description="暂无记录" :image-size="60" />
+            </template>
+          </el-table>
+        </el-tab-pane>
+      </el-tabs>
+    </el-card>
+  </div>
+</template>
+
+<script setup>
+import { ref, reactive, computed, onMounted } from 'vue'
+import { useRoute, useRouter } from 'vue-router'
+import { crudPage, crudGet, getRefs, getTableMeta } from '@/api'
+
+const route = useRoute()
+const router = useRouter()
+const id = Number(route.params.id)
+const activeTab = ref('trial')
+
+const info = ref({})
+const metaCache = reactive({})
+const refCache = reactive({})
+
+// ================= 庄口档案 =================
+const zkLabel = computed(() => {
+  const cache = refCache['RawMaterial_Zhuangkou']
+  return (cache?.map?.[info.value.zhuangkouId] ?? info.value.zhuangkouId) || '—'
+})
+
+// ================= 枚举解析 =================
+function enumText(fieldName, v) {
+  if (v === null || v === undefined || v === '') return '—'
+  const field = metaCache['Process_ProcessZhuangkou']?.find((f) => f.name === fieldName)
+  if (field?.options?.length) {
+    return field.options.find((o) => o.value === v)?.label ?? v
+  }
+  return v
+}
+
+function statusTagType(v) {
+  const map = { 0: 'info', 1: 'success', 2: 'warning', 3: 'primary', 4: 'danger' }
+  return map[v] || 'info'
+}
+
+// ================= 分区配置 =================
+const sections = ref([])
+
+function buildSections() {
+  return [
+    {
+      key: 'trial', title: '试产记录', table: 'Process_Trial',
+      where: { processZhuangkouId: id },
+      cols: [
+        { prop: 'billNo', label: '试产单号', width: 180 },
+        { prop: 'trialType', label: '试产类型', enum: true },
+        { prop: 'zhuangkouId', label: '原料庄口', refTable: 'RawMaterial_Zhuangkou' },
+        { prop: 'trialMan', label: '试产人' },
+        { prop: 'trialDate', label: '试产日期', width: 130 }
+      ]
+    },
+    {
+      key: 'sheet', title: '工艺单', table: 'Process_Sheet',
+      where: { processZhuangkouId: id },
+      cols: [
+        { prop: 'sheetNo', label: '工艺单号', width: 180 },
+        { prop: 'name', label: '工艺名称' },
+        { prop: 'version', label: '版本' },
+        { prop: 'publishTime', label: '发布时间', width: 130 },
+        { prop: 'status', label: '状态', enum: true }
+      ]
+    },
+    {
+      key: 'plan', title: '生产计划', table: 'ProPlan_WorkOrder',
+      where: { processZhuangkouId: id },
+      cols: [
+        { prop: 'orderNo', label: '工单号', width: 180 },
+        { prop: 'targetProcess', label: '目标工序', enum: true },
+        { prop: 'planInput', label: '计划投料(kg)' },
+        { prop: 'actualInput', label: '实际投料(kg)' },
+        { prop: 'planOutput', label: '计划产出(kg)' },
+        { prop: 'actualOutput', label: '实际产出(kg)' },
+        { prop: 'status', label: '状态', enum: true }
+      ]
+    },
+    {
+      key: 'xuan', title: '选茧日报', table: 'ProXuan_Daily',
+      where: { zhuangkouId: info.value.zhuangkouId },
+      cols: [
+        { prop: 'dailyDate', label: '日期', width: 130 },
+        { prop: 'teamId', label: '班组', refTable: 'ProXuan_Team' },
+        { prop: 'inputWeight', label: '领料量(kg)' },
+        { prop: 'goodWeight', label: '上车茧(kg)' },
+        { prop: 'wasteWeight', label: '下脚茧(kg)' }
+      ]
+    },
+    {
+      key: 'qian', title: '前缫记录', table: 'ProQian_ThreadRecord',
+      where: { processZhuangkouId: id },
+      cols: [
+        { prop: 'recordDate', label: '日期', width: 130 },
+        { prop: 'machineId', label: '机台', refTable: 'ProQian_Machine' },
+        { prop: 'shift', label: '班次', enum: true },
+        { prop: 'threadCount', label: '下丝片数' },
+        { prop: 'weight', label: '下丝量(kg)' }
+      ]
+    },
+    {
+      key: 'hou', title: '后缫日报', table: 'ProHou_Daily',
+      where: { processZhuangkouId: id },
+      cols: [
+        { prop: 'dailyDate', label: '日期', width: 130 },
+        { prop: 'teamId', label: '班组', refTable: 'ProXuan_Team' },
+        { prop: 'inputWeight', label: '上机丝量(kg)' },
+        { prop: 'outputWeight', label: '返丝产量(kg)' },
+        { prop: 'workerCount', label: '人数' }
+      ]
+    },
+    {
+      key: 'check', title: '检验记录', table: 'Lims_BlackBoard',
+      where: { processZhuangkouId: id },
+      cols: [
+        { prop: 'checkNo', label: '检验单号', width: 180 },
+        { prop: 'checkDate', label: '检验日期', width: 130 },
+        { prop: 'uniformity', label: '均匀度' },
+        { prop: 'cleanliness', label: '洁净度' },
+        { prop: 'grade', label: '等级' }
+      ]
+    },
+    {
+      key: 'grade', title: '厂检定级', table: 'Lims_GradeResult',
+      where: { processZhuangkouId: id },
+      cols: [
+        { prop: 'gradeNo', label: '判定单号', width: 180 },
+        { prop: 'specId', label: '丝品位', refTable: 'BaseCommon_SilkSpec' },
+        { prop: 'grade', label: '判定等级', width: 100 },
+        { prop: 'grader', label: '判定人', width: 100 },
+        { prop: 'gradeDate', label: '判定日期', width: 130 },
+        { prop: 'status', label: '状态', enum: true }
+      ]
+    },
+    {
+      key: 'fims', title: '成品批次', table: 'Fims_Batch',
+      where: { processZhuangkouId: id },
+      cols: [
+        { prop: 'batchNo', label: '批次号', width: 180 },
+        { prop: 'specId', label: '丝品位', refTable: 'BaseCommon_SilkSpec' },
+        { prop: 'grade', label: '等级' },
+        { prop: 'totalWeight', label: '总重(kg)' },
+        { prop: 'packageCount', label: '件数' },
+        { prop: 'status', label: '状态', enum: true }
+      ]
+    },
+    {
+      key: 'stock', title: '成品库存', table: 'Fims_Stock',
+      where: { processZhuangkouId: id },
+      cols: [
+        { prop: 'specId', label: '丝品位', refTable: 'BaseCommon_SilkSpec' },
+        { prop: 'grade', label: '等级' },
+        { prop: 'stockWeight', label: '结存(kg)' },
+        { prop: 'packageCount', label: '件数' }
+      ]
+    }
+  ].filter((s) => !s.needZk || info.value.zhuangkouId)
+}
+
+// ================= 单元格格式化 =================
+function fmtCell(sec, col, row) {
+  const v = row[col.prop]
+  if (v === null || v === undefined || v === '') return '—'
+  if (col.enum) {
+    const field = metaCache[sec.table]?.find((f) => f.name === col.prop)
+    if (field?.options?.length) {
+      const opt = field.options.find((o) => o.value === v)
+      if (opt) return opt.label
+    }
+    return v
+  }
+  if (col.refTable) {
+    const cache = refCache[col.refTable]
+    return cache?.map?.[v] ?? v
+  }
+  if (/Date/i.test(col.prop)) return formatTime(v)
+  if (typeof v === 'number') return Number.isInteger(v) ? v : v.toFixed(2)
+  return v
+}
+
+// ================= 数据加载 =================
+const formatTime = (v) => (v ? String(v).replace('T', ' ').slice(0, 10) : '')
+
+async function loadMeta(table) {
+  if (metaCache[table]) return
+  try {
+    const res = await getTableMeta(table)
+    metaCache[table] = (res.data?.fields || []).map((f) => ({
+      ...f,
+      name: f.name.charAt(0).toLowerCase() + f.name.slice(1)
+    }))
+  } catch (e) {
+    metaCache[table] = []
+  }
+}
+
+async function loadRefs(refTable) {
+  if (!refTable || refCache[refTable]) return
+  refCache[refTable] = { items: [], map: {} }
+  try {
+    const res = await getRefs(refTable, { size: 200 })
+    const map = {}
+    ;(res.data || []).forEach((i) => { map[i.value] = i.label })
+    refCache[refTable] = { items: res.data || [], map }
+  } catch (e) {
+    refCache[refTable] = { items: [], map: {} }
+  }
+}
+
+async function loadSection(sec) {
+  sec.loading = true
+  try {
+    const res = await crudPage(sec.table, {
+      page: 1, size: 5,
+      where: sec.where || {}
+    })
+    sec.rows = res.data?.items || []
+    sec.total = res.data?.total || 0
+    // 预取元数据与关联下拉
+    await loadMeta(sec.table)
+    const refTables = [...new Set((sec.cols || []).map((c) => c.refTable).filter(Boolean))]
+    await Promise.all(refTables.map(loadRefs))
+  } catch (e) {
+    sec.rows = []
+    sec.total = 0
+  } finally {
+    sec.loading = false
+  }
+}
+
+const goBack = () => router.back()
+
+onMounted(async () => {
+  // 庄口档案
+  try {
+    const res = await getTableMeta('Process_ProcessZhuangkou')
+    metaCache['Process_ProcessZhuangkou'] = (res.data?.fields || []).map((f) => ({
+      ...f,
+      name: f.name.charAt(0).toLowerCase() + f.name.slice(1)
+    }))
+    await loadRefs('RawMaterial_Zhuangkou')
+    const r = await crudGet('Process_ProcessZhuangkou', id)
+    info.value = r.data || {}
+  } catch (e) {
+    /* 档案加载失败静默 */
+  }
+  sections.value = buildSections()
+  sections.value.forEach((s) => { s.rows = []; s.total = 0; s.loading = false })
+  await Promise.all(sections.value.map(loadSection))
+})
+</script>
+
+<style scoped>
+.detail-page {
+  display: flex;
+  flex-direction: column;
+  gap: 14px;
+}
+.info-card {
+  border: none;
+}
+.link-card {
+  border: none;
+}
+.link-card :deep(.el-card__body) {
+  padding: 8px 12px 14px;
+}
+.tab-badge {
+  margin-left: 6px;
+  margin-top: -2px;
+}
+</style>
diff --git a/web/src/views/workbench/index.vue b/web/src/views/workbench/index.vue
new file mode 100644
index 0000000..b41f802
--- /dev/null
+++ b/web/src/views/workbench/index.vue
@@ -0,0 +1,488 @@
+<template>
+  <div class="workbench">
+    <!-- 统计卡片 -->
+    <el-row :gutter="14" class="stat-row">
+      <el-col v-for="card in statCards" :key="card.title" :xs="12" :sm="12" :md="6">
+        <el-card shadow="hover" class="stat-card">
+          <div class="stat-item">
+            <div class="stat-icon" :style="{ background: card.bg, color: card.color }">
+              <el-icon :size="26"><component :is="card.icon" /></el-icon>
+            </div>
+            <div class="stat-info">
+              <div class="stat-value">{{ card.value }}</div>
+              <div class="stat-title">{{ card.title }}</div>
+            </div>
+          </div>
+        </el-card>
+      </el-col>
+    </el-row>
+
+    <!-- 图表区 -->
+    <el-row :gutter="14" class="chart-row">
+      <el-col :xs="24" :md="16">
+        <el-card shadow="never">
+          <template #header>
+            <div class="card-title">近 30 日产丝趋势（kg）</div>
+          </template>
+          <div ref="trendRef" class="chart trend-chart"></div>
+        </el-card>
+      </el-col>
+      <el-col :xs="24" :md="8">
+        <el-card shadow="never">
+          <template #header>
+            <div class="card-title">庄口产量占比（近30天）</div>
+          </template>
+          <div ref="pieRef" class="chart pie-chart"></div>
+        </el-card>
+      </el-col>
+    </el-row>
+
+    <!-- 待办 / 预警 -->
+    <el-row :gutter="14">
+      <el-col :xs="24" :md="12">
+        <el-card shadow="never">
+          <template #header>
+            <div class="card-title">
+              待办任务
+              <el-badge v-if="todoCount" :value="todoCount" type="primary" class="head-badge" />
+            </div>
+          </template>
+          <div v-if="todos.length" class="todo-list">
+            <div
+              v-for="(t, i) in todos"
+              :key="i"
+              class="todo-item"
+              :class="{ clickable: t.url }"
+              @click="t.url && $router.push(t.url)"
+            >
+              <span class="todo-type" :class="t.type === '审批' ? 'type-flow' : 'type-order'">{{ t.type }}</span>
+              <span class="todo-title">{{ t.title }}</span>
+              <span class="todo-status" v-if="t.statusText">{{ t.statusText }}</span>
+              <span class="todo-time">{{ t.time }}</span>
+            </div>
+          </div>
+          <el-empty v-else description="暂无待办任务" :image-size="60" />
+        </el-card>
+      </el-col>
+      <el-col :xs="24" :md="12">
+        <el-card shadow="never">
+          <template #header>
+            <div class="card-title">
+              风险预警
+              <el-badge v-if="warnings.length" :value="warnings.length" type="danger" class="head-badge" />
+            </div>
+          </template>
+          <div v-if="warnings.length" class="warn-list">
+            <div
+              v-for="w in warnings"
+              :key="w.id"
+              class="warn-item"
+              :class="{ clickable: w.url }"
+              @click="w.url && $router.push(w.url)"
+            >
+              <el-icon class="warn-icon" color="#f56c6c"><Warning /></el-icon>
+              <div class="warn-body">
+                <div class="warn-title">{{ w.title }}</div>
+                <div class="warn-content">{{ w.content }}<span class="warn-time">{{ w.time }}</span></div>
+              </div>
+            </div>
+          </div>
+          <el-empty v-else description="暂无预警" :image-size="60" />
+        </el-card>
+      </el-col>
+    </el-row>
+
+    <!-- 底部：天气 + 快捷入口 -->
+    <el-row :gutter="14">
+      <el-col :xs="24" :md="10">
+        <el-card shadow="never">
+          <template #header>
+            <div class="card-title">今日天气</div>
+          </template>
+          <div v-if="weather" class="weather-box flex-center">
+            <span class="weather-icon">{{ weatherIcon }}</span>
+            <div>
+              <div class="weather-temp">{{ weather.temp }}°C</div>
+              <div class="weather-desc">{{ weather.desc }}　{{ weather.wind }}</div>
+              <div class="weather-loc">{{ weather.location }}</div>
+            </div>
+          </div>
+          <el-empty v-else description="天气服务暂不可用" :image-size="60" />
+        </el-card>
+      </el-col>
+      <el-col :xs="24" :md="14">
+        <el-card shadow="never">
+          <template #header>
+            <div class="card-title">快捷入口</div>
+          </template>
+          <div class="quick-grid">
+            <div
+              v-for="item in quickMenus"
+              :key="item.path"
+              class="quick-item"
+              @click="$router.push(item.path)"
+            >
+              <el-icon :size="24" :color="item.color"><component :is="item.icon" /></el-icon>
+              <span>{{ item.title }}</span>
+            </div>
+          </div>
+        </el-card>
+      </el-col>
+    </el-row>
+  </div>
+</template>
+
+<script setup>
+import { ref, computed, onMounted, onBeforeUnmount, nextTick } from 'vue'
+import * as echarts from 'echarts'
+import { useUserStore } from '@/stores/user'
+import { getWeather, mapWeather, getWorkBenchSummary } from '@/api'
+
+const userStore = useUserStore()
+const trendRef = ref()
+const pieRef = ref()
+const weather = ref(null)
+const todos = ref([])
+const warnings = ref([])
+const summary = ref({ cards: {}, trend: [], zhuangkou: [] })
+let trendChart = null
+let pieChart = null
+
+const statCards = computed(() => {
+  const c = summary.value.cards || {}
+  const todoTotal = (c.workOrderPending || 0) + (c.flowTodo || 0)
+  const machineText = c.machineTotal ? `${c.machineRunning} / ${c.machineTotal}` : (c.machineRunning || 0)
+  return [
+    { title: '今日产丝(kg)', value: fmtNum(c.todayOutput), icon: 'Goods', color: '#409eff', bg: 'rgba(64,158,255,0.12)' },
+    { title: '在线机组(台)', value: machineText, icon: 'Cpu', color: '#67c23a', bg: 'rgba(103,194,58,0.12)' },
+    { title: '待办任务(项)', value: todoTotal, icon: 'List', color: '#e6a23c', bg: 'rgba(230,162,60,0.12)' },
+    { title: '库存预警(项)', value: c.warningCount || 0, icon: 'Warning', color: '#f56c6c', bg: 'rgba(245,108,108,0.12)' }
+  ]
+})
+
+const todoCount = computed(() => todos.value.length)
+
+// 快捷入口：从菜单取前 12 个页面
+const quickMenus = computed(() => {
+  const pages = []
+  for (const m of userStore.menus) {
+    for (const c of m.children || []) {
+      pages.push({
+        title: c.title,
+        path: c.path,
+        icon: c.icon || 'Document',
+        color: ['#409eff', '#67c23a', '#e6a23c', '#f56c6c', '#909399', '#9c27b0'][pages.length % 6]
+      })
+      if (pages.length >= 12) break
+    }
+    if (pages.length >= 12) break
+  }
+  return pages
+})
+
+const weatherIcon = computed(() => {
+  const d = weather.value?.desc || ''
+  if (d.includes('雨')) return '🌧️'
+  if (d.includes('雪')) return '❄️'
+  if (d.includes('云')) return '⛅'
+  if (d.includes('晴')) return '☀️'
+  return '🌤️'
+})
+
+function fmtNum(v) {
+  if (v === null || v === undefined) return '0'
+  return Number(v).toLocaleString('en-US', { maximumFractionDigits: 1 })
+}
+
+function initCharts() {
+  trendChart = echarts.init(trendRef.value)
+  pieChart = echarts.init(pieRef.value)
+  renderCharts()
+}
+
+function renderCharts() {
+  const trend = summary.value.trend || []
+  const zk = summary.value.zhuangkou || []
+  const allZero = trend.every((x) => !x.weight)
+
+  trendChart.setOption({
+    tooltip: { trigger: 'axis' },
+    grid: { left: 46, right: 16, top: 30, bottom: 26 },
+    xAxis: {
+      type: 'category',
+      data: trend.map((x) => x.date),
+      boundaryGap: false,
+      axisLine: { lineStyle: { color: '#dcdfe6' } }
+    },
+    yAxis: { type: 'value', name: 'kg', splitLine: { lineStyle: { color: '#f0f2f5' } } },
+    series: [
+      {
+        name: '产丝量',
+        type: 'line',
+        smooth: true,
+        symbol: 'none',
+        data: allZero ? [] : trend.map((x) => x.weight),
+        lineStyle: { width: 3, color: '#409eff' },
+        areaStyle: allZero
+          ? undefined
+          : {
+              color: {
+                type: 'linear', x: 0, y: 0, x2: 0, y2: 1,
+                colorStops: [
+                  { offset: 0, color: 'rgba(64,158,255,0.28)' },
+                  { offset: 1, color: 'rgba(64,158,255,0.02)' }
+                ]
+              }
+            }
+      }
+    ]
+  })
+
+  pieChart.setOption({
+    tooltip: { trigger: 'item', formatter: '{b}: {c}kg ({d}%)' },
+    legend: { bottom: 0, textStyle: { fontSize: 11 } },
+    series: [
+      {
+        type: 'pie',
+        radius: ['42%', '68%'],
+        center: ['50%', '44%'],
+        avoidLabelOverlap: true,
+        itemStyle: { borderRadius: 6, borderColor: '#fff', borderWidth: 2 },
+        label: { show: false },
+        emphasis: { label: { show: true, fontSize: 14, fontWeight: 'bold' } },
+        data: zk.length ? zk : [{ value: 1, name: '暂无数据' }]
+      }
+    ]
+  })
+}
+
+function resizeCharts() {
+  trendChart?.resize()
+  pieChart?.resize()
+}
+
+async function loadSummary() {
+  try {
+    const res = await getWorkBenchSummary()
+    if (res.code === 0 && res.data) {
+      summary.value = res.data
+      todos.value = res.data.todos || []
+      warnings.value = res.data.warnings || []
+      await nextTick()
+      renderCharts()
+    }
+  } catch (e) {
+    /* 统计接口异常时保留空数据展示 */
+  }
+}
+
+async function loadWeather() {
+  try {
+    const res = await getWeather({})
+    if (res.code === 0 && res.data) weather.value = mapWeather(res.data)
+  } catch (e) {
+    /* 静默 */
+  }
+}
+
+onMounted(() => {
+  initCharts()
+  loadWeather()
+  loadSummary()
+  window.addEventListener('resize', resizeCharts)
+})
+
+onBeforeUnmount(() => {
+  window.removeEventListener('resize', resizeCharts)
+  trendChart?.dispose()
+  pieChart?.dispose()
+})
+</script>
+
+<style scoped>
+.workbench {
+  display: flex;
+  flex-direction: column;
+  gap: 14px;
+}
+.stat-card {
+  border: none;
+}
+.stat-item {
+  display: flex;
+  align-items: center;
+  gap: 14px;
+}
+.stat-icon {
+  width: 52px;
+  height: 52px;
+  border-radius: 10px;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  flex-shrink: 0;
+}
+.stat-value {
+  font-size: 24px;
+  font-weight: 700;
+  color: #303133;
+  line-height: 1.2;
+}
+.stat-title {
+  font-size: 13px;
+  color: #909399;
+  margin-top: 2px;
+}
+.card-title {
+  font-weight: 600;
+  color: #303133;
+  display: flex;
+  align-items: center;
+  gap: 8px;
+}
+.head-badge {
+  display: inline-flex;
+}
+.chart {
+  width: 100%;
+}
+.trend-chart {
+  height: 300px;
+}
+.pie-chart {
+  height: 300px;
+}
+.todo-list,
+.warn-list {
+  display: flex;
+  flex-direction: column;
+}
+.todo-item {
+  display: flex;
+  align-items: center;
+  gap: 10px;
+  padding: 10px 4px;
+  border-bottom: 1px solid #f0f2f5;
+  font-size: 13px;
+}
+.todo-item:last-child {
+  border-bottom: none;
+}
+.todo-item.clickable,
+.warn-item.clickable {
+  cursor: pointer;
+}
+.todo-item.clickable:hover .todo-title,
+.warn-item.clickable:hover .warn-title {
+  color: #409eff;
+}
+.todo-type {
+  flex-shrink: 0;
+  font-size: 12px;
+  padding: 1px 8px;
+  border-radius: 4px;
+}
+.type-order {
+  color: #409eff;
+  background: rgba(64, 158, 255, 0.1);
+}
+.type-flow {
+  color: #9c27b0;
+  background: rgba(156, 39, 176, 0.1);
+}
+.todo-title {
+  flex: 1;
+  color: #303133;
+  white-space: nowrap;
+  overflow: hidden;
+  text-overflow: ellipsis;
+}
+.todo-status {
+  flex-shrink: 0;
+  font-size: 12px;
+  color: #e6a23c;
+}
+.todo-time {
+  flex-shrink: 0;
+  font-size: 12px;
+  color: #909399;
+}
+.warn-item {
+  display: flex;
+  align-items: flex-start;
+  gap: 10px;
+  padding: 10px 4px;
+  border-bottom: 1px solid #f0f2f5;
+}
+.warn-item:last-child {
+  border-bottom: none;
+}
+.warn-icon {
+  margin-top: 2px;
+  flex-shrink: 0;
+}
+.warn-body {
+  flex: 1;
+  min-width: 0;
+}
+.warn-title {
+  font-size: 13px;
+  color: #303133;
+  font-weight: 600;
+}
+.warn-content {
+  font-size: 12px;
+  color: #909399;
+  margin-top: 2px;
+  display: flex;
+  justify-content: space-between;
+  gap: 8px;
+}
+.warn-time {
+  flex-shrink: 0;
+}
+.weather-box {
+  gap: 18px;
+  padding: 8px 0;
+}
+.weather-icon {
+  font-size: 52px;
+}
+.weather-temp {
+  font-size: 30px;
+  font-weight: 700;
+  color: #303133;
+}
+.weather-desc {
+  font-size: 13px;
+  color: #606266;
+  margin-top: 2px;
+}
+.weather-loc {
+  font-size: 12px;
+  color: #909399;
+  margin-top: 2px;
+}
+.quick-grid {
+  display: grid;
+  grid-template-columns: repeat(6, 1fr);
+  gap: 12px;
+  padding: 4px 0;
+}
+.quick-item {
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  gap: 8px;
+  cursor: pointer;
+  padding: 10px 4px;
+  border-radius: 8px;
+  transition: background 0.2s;
+  font-size: 13px;
+  color: #606266;
+}
+.quick-item:hover {
+  background: #f5f7fa;
+  color: #409eff;
+}
+</style>
diff --git a/web/vite.config.js b/web/vite.config.js
new file mode 100644
index 0000000..f7b552c
--- /dev/null
+++ b/web/vite.config.js
@@ -0,0 +1,25 @@
+import { defineConfig } from 'vite'
+import vue from '@vitejs/plugin-vue'
+import { fileURLToPath, URL } from 'node:url'
+
+export default defineConfig({
+  plugins: [vue()],
+  resolve: {
+    alias: {
+      '@': fileURLToPath(new URL('./src', import.meta.url))
+    }
+  },
+  server: {
+    port: 5173,
+    host: '0.0.0.0',
+    proxy: {
+      '/api': {
+        target: 'http://localhost:5136',
+        changeOrigin: true
+      }
+    }
+  },
+  build: {
+    chunkSizeWarningLimit: 2000
+  }
+})
diff --git a/功能清单 b/功能清单
new file mode 100644
index 0000000..a19c270
--- /dev/null
+++ b/功能清单
@@ -0,0 +1,473 @@
+## 系统管理 (BaseSys)
+
+1. **菜单功能**
+功能说明：维护电脑端系统菜单树，配置系统具备哪些功能模块与页面；支持菜单新增、删除、编辑、排序、层级组织。
+设计要求：菜单数据采用树形结构存储；每项菜单绑定页面路由与权限标识；菜单可见性随用户角色权限动态控制；提供菜单增删改后的缓存刷新 / 同步机制。
+设计边界：仅负责菜单结构与路由配置，不实现页面内具体功能；菜单权限判定由角色权限模块统一处理，本模块只记录菜单与权限标识的绑定关系。
+2. **组织架构**
+功能说明：维护企业组织架构（公司 / 部门 / 车间 / 班组等）的层级树，作为数据权限划分与业务归属的基础。
+设计要求：组织为树形层级结构，支持节点增删改、调整、启用 / 停用；组织节点作为数据权限范围的基准，供各业务模块按职责域引用；支持人员挂靠组织。
+设计边界：不直接管理用户登录账号，仅维护组织层级与人员归属；数据权限校验逻辑由通用权限框架实现，本模块只提供组织维度数据。
+3. **角色权限**
+功能说明：定义角色并配置权限，粒度精确到页面及页面内按钮，实现功能级细粒度授权。
+设计要求：权限模型分为页面权限与按钮权限两层；支持角色‑用户关联、角色复制 / 继承、权限模板复用；权限判定需前后端双重校验；由管理员维护。
+设计边界：只负责权限规则的定义与存储，不承载具体业务逻辑；权限变更生效需遵循统一的缓存刷新 / 登录态刷新策略。
+4. **用户管理**
+功能说明：管理系统登录用户，支持关联小程序用户、关联 HRS 模块用户，支持密码重置，登录统一使用手机号码。
+设计要求：手机号作为登录唯一标识，唯一性校验；支持电脑端 / 小程序 / HRS 多端账号关联与打通；实现密码修改与重置流程；登录态、Token 与鉴权统一由认证模块处理。
+设计边界：只维护登录账号与多端关联，不处理职工档案等业务主数据；安全策略（验证码、限流、Token 有效期）不属于本模块职责。
+
+## 基础数据 (BaseCommon)
+
+1. **物资目录**
+功能说明：维护配件、生丝、干茧、副产品等物资项明细档案，形成统一物资主数据。
+设计要求：物资编码唯一、支持分类树管理；支持单位与扩展属性（规格、计量单位等）；物资档案供采购、库存、生产等模块按编码引用。
+设计边界：只维护物资静态基础档案，不处理库存数量与出入库流水；物资分类结构需支持扩展。
+2. **生丝规格**
+功能说明：配置生丝规格以及纤度范围、野纤范围等管理项。
+设计要求：规格字段支持配置（纤度范围、野纤范围等）；录入环节需引用规格数据进行合规校验。
+设计边界：仅维护规格定义与取值范围，实际换算与质量判定逻辑由质检、生丝等业务模块实现。
+3. **生丝定级标准**
+功能说明：配置生丝批次厂检定级标准。
+设计要求：定级规则支持灵活配置，建议版本化管理便于追溯；供生丝质检组批模块引用以自动判定等级。
+设计边界：只负责定级标准的配置存储，不实现检验数据采集与业务录入。
+4. **业务账期**
+功能说明：配置业务管理账期，作为薪资、结算等业务期间划分依据。
+设计要求：账期支持自定义名称、起止期间；供薪资计算等模块引用以确定归属期间。
+设计边界：仅维护账期定义，账期内的业务计算逻辑由各业务模块自行实现。
+5. **工种划分**
+功能说明：维护职工岗位、工种等基础分类。
+设计要求：岗位 / 工种分类用于薪资计算与出勤管理；支持增删改、启用 / 停用；供职工档案与薪资模块引用。
+设计边界：只维护岗位 / 工种分类字典数据，具体薪资规则与考勤逻辑由对应模块实现。
+6. **往来单位**
+功能说明：维护客户、供应商等往来单位基础档案。
+设计要求：统一往来单位编码，区分客户 / 供应商类型；档案字段可扩展；供采购、销售等业务模块引用。
+设计边界：只维护静态往来单位档案，采购 / 销售业务单据在各自模块中处理。
+7. **注册表（数据字典）**
+功能说明：通用数据字典 / 注册表，用于动态业务规格配置。
+设计要求：以键值结构存储，支持类型校验与分组；供各业务模块按字典项读取，实现业务规则的动态化配置。
+设计边界：仅提供字典数据读写，不承载具体业务逻辑与校验规则。
+
+## 工作台 (WorkBench)
+
+1. **工作台（首页）**
+功能说明：MES 工作台聚合不同岗位高价值业务，含待办任务（翻包执行、生产日报、检验录入、生丝组批、计量抄表、计件薪资审核等）、风险预警（原料超期断料、工况偏离、质量超标、库存账实差异）、核心概览看板（投料产出、在制庄口、库存、质量等级分布、庄口盈亏），并提供高频快捷操作与消息通知。
+设计要求：按操作工 / 车间主管 / 仓管 / 核算管理岗做视图权限隔离；待办、预警、看板、快捷操作均为可配置聚合模块；消息通知实时推送。
+设计边界：仅做聚合与跳转，不实现具体业务逻辑；数据依赖各业务模块。
+
+## 人力资源 (HRS)
+
+1. **职工档案**
+功能说明：通用职工基础档案管理，支持入职、离职、调岗等状态流转。
+设计要求：职工唯一编码；支持入职、离职、调岗等异动记录与历史追溯；与用户账号、薪资、考勤关联。
+设计边界：只维护职工基础档案与异动记录，薪资考勤逻辑由对应模块实现。
+2. **出勤管理**
+功能说明：适用于缫丝厂的考勤功能，分部门 / 分部分录入或采集各部门职工考勤，不依赖考勤机，支持班组长录入与小程序打卡。
+设计要求：支持部门分部录入、班组长批量录入、小程序打卡采集；出勤按账期 / 月份汇总供薪资引用。
+设计边界：不依赖考勤硬件；打卡采集归属移动端，本模块负责汇总与确认。
+3. **宿舍管理**
+功能说明：通用宿舍管理，含宿舍人员组成、电费 / 水费等费用采集登记。
+设计要求：宿舍‑床位档案维护；人员入住 / 退宿登记；水电费抄表采集与分摊登记。
+设计边界：水电费为采集登记，不自动与能耗表同步（可预留接口）。
+4. **食堂管理**
+功能说明：通用工厂食堂管理模块。
+设计要求：支持就餐人员、餐次、消费 / 补贴等登记，可按部门、账期统计。
+设计边界：标准通用模块，具体规则可配置。
+
+## 薪资智算 (FlexPay)
+
+1. **薪资配置**
+功能说明：配置庄口、部门、工种、规格、账期、职工等维度薪资计算所需指标与规则。
+设计要求：多维度配置薪资计算指标；指标项可配置、可扩展。
+设计边界：只做配置，不计算工资。
+2. **薪资方案**
+功能说明：薪资及考核方案设计。
+设计要求：定义薪资结构、考核项、公式组成的方案；支持版本、启用停用、套用范围。
+设计边界：方案定义与实际工资计算相分离。
+3. **奖扣管理**
+功能说明：记录特殊、临时性针对职工的奖扣。
+设计要求：记录奖扣项目、金额、原因、责任人；支持按账期汇总进入工资。
+设计边界：奖扣为临时性人工增减项，与固定薪资结构分离。
+4. **计件成绩**
+功能说明：按工种、庄口、规格、出勤、计件成绩、奖扣自动计算车间员工工资，支持工资预览与台账查询。
+设计要求：依据计件成绩 + 出勤 + 奖扣自动计算；支持预览与台账；计算规则可配置。
+设计边界：仅输出工资结果，实际发放由薪资发放模块处理。
+5. **薪资计算**
+功能说明：计算职工工资。
+设计要求：支持整月批量计算、重算、试算；汇总各薪酬项目形成应发 / 实发。
+设计边界：个税、社保等代扣项如需支持可配置，默认简化。
+6. **薪资发放**
+功能说明：对接银企直连实现工资支付。
+设计要求：生成银行发放文件并对接银企直连接口；支持发放结果回写与对账。
+设计边界：依赖第三方支付接口，需异常处理与对账。
+
+## 原料管理 (RawMaterial)
+
+1. **采购管理**
+功能说明：采购业务源头，记录与供应商的采购业务（采购合同、定价、数量、供应商信息），形成采购业务单据。
+设计要求：采购合同、定价、数量、供应商信息构成采购单；单据化流转供原料入库引用；支持审批。
+设计边界：仅到采购单据，入库 / 库存由原料模块处理。
+2. **供应商管理**
+功能说明：通用供应商管理功能模块。
+设计要求：供应商编码唯一、分类、联系方式、资质信息维护；供采购模块引用。
+设计边界：静态档案维护。
+3. **原料庄口**
+功能说明：维护原料庄口基础信息（名称、简称、产地、站点、季别、品种等），由仓库库管员维护；编号为 YLZ + 年月日 + 流水号，如 YLZ20260815‑001。
+设计要求：庄口编号自动生成（YLZ+yyyyMMdd+3 位流水）；字段可配置扩展；库管员权限维护。
+设计边界：原料庄口为原料批次分组主数据，供入库 / 翻包 / 出库引用。
+4. **原料入库**
+功能说明：通过磅码单过磅方式进行原料入库，归属原料庄口管理。
+设计要求：磅码单过磅录入毛 / 皮 / 净重；归档到原料庄口；支持打印。
+设计边界：入库量累加至原料庄口库存。
+5. **翻包管理**
+功能说明：生成原料庄翻包计划并跟踪翻包执行结果。
+设计要求：按庄口生成翻包计划任务；记录执行结果与进度。
+设计边界：只管理翻包计划与执行反馈。
+6. **原料出库**
+功能说明：领料出库（选剥茧车间领料出库），支持单据打印。
+设计要求：支持单据打印；记录领料车间、数量、领用人。
+设计边界：出库扣减原料庄口库存。
+7. **原料库存**
+功能说明：原料库存管理。
+设计要求：按庄口 / 仓库统计原料库存；支持查询与超期断料预警。
+设计边界：库存由出入库流水驱动。
+
+## 生技工艺（Process）
+
+1. **样茧试缫**
+功能说明：记录采购原料试缫、入库工艺前端试缫、工艺庄口试缫等多种试缫数据；三种试缫指标有重叠也有差异，需多表单模板，支持 A4 打印。
+设计要求：多种试缫表单模板可配置；支持 A4 打印；共享指标 + 差异化字段。
+设计边界：仅记录试缫数据，供质量 / 工艺判断参考。
+2. **工艺庄口**
+功能说明：维护工艺庄口基础信息（名称、简称、生产显示名称、编号、本地 / 外地、标签、进度、备注）；编号支持自定义格式，默认 GYZ‑年度‑流水号。
+设计要求：庄口编号格式可配置，默认 GYZ‑YYYY‑NNN；字段可扩展。
+设计边界：工艺庄口对接原料庄口与车间生产。
+3. **工艺指标**
+功能说明：维护系统管理所需的工艺指标。
+设计要求：指标可配置、可引用到工艺单。
+设计边界：仅维护指标字典。
+4. **工艺单**
+功能说明：管理庄口所有生产工艺指标，指标设置可配置（KV 模式取代固定字段），支持预览打印、模板、复制、版本管理。
+设计要求：KV 键值模式存储指标；支持模板、复制、版本管理、预览打印。
+设计边界：工艺单为生产执行依据。
+
+## 生产计划（ProPlan）
+
+1. **任务工单**
+功能说明：根据投产计划生成车间生产任务，下发前缫、选茧工序，关联对应工艺单。
+设计要求：由投产计划驱动生成工单；下发至前缫 / 选茧工序；关联工艺单。
+设计边界：工单执行与产量反馈在工段模块。
+2. **计划变更管理**
+功能说明：处理庄口暂停、换庄、调整投产顺序，记录变更原因。
+设计要求：变更类型（暂停 / 换庄 / 调序）；记录变更原因与操作人；影响工单联动。
+设计边界：变更记录需留痕可追溯。
+3. **生产过程监测**
+功能说明：跟踪庄口实际投料、已产出丝量、消耗，对比计划投入产出，查看完成进度与各环节状态；以数轴图展示进度，支持跳转工段或查看日报。
+设计要求：进度用数轴图展示；支持投料 / 产出 / 消耗对比；可跳转各工段或查看日报。
+设计边界：仅做监测视图，数据来自各工段。
+
+## 选茧工段（ProXuan）
+
+1. **选茧班组**
+功能说明：维护选茧工段班组信息。
+设计要求：支持班组档案、人员组成维护。
+设计边界：基础档案。
+2. **选茧日报**
+功能说明：逐日记录选茧工段生产日报。
+设计要求：逐日登记选茧产量、质量、人员数据。
+设计边界：作为成本与产量统计来源。
+3. **选茧质量**
+功能说明：记录选茧质量数据。
+设计要求：按日 / 庄口记录选茧质量指标。
+设计边界：质量数据供报表与分析。
+4. **光茧临时仓库**
+功能说明：管理光茧临时仓库（选茧后中间存储）。
+设计要求：光茧出入库登记、库存查询。
+设计边界：中间仓库存，关联选茧与前缫。
+
+## 前缫工段（ProQian）
+
+1. **前缫配置**
+功能说明：车间配置（车间信息、班次、车台数），车台车号配置，树状配置。
+设计要求：车间 / 车台树状配置；车号管理。
+设计边界：为前缫排班与落丝的基础。
+2. **看台排班**
+功能说明：配置缫丝工、车头工看台位置和绪数。
+设计要求：按车台配置看台人员与绪数。
+设计边界：排班数据供计件与落丝参考。
+3. **看台时长**
+功能说明：看台时长管理，支持录入、调整、合并、分拆、临时安排。
+设计要求：支持录入 / 调整 / 合并 / 分拆 / 临时安排等操作。
+设计边界：时长为计件 / 绩效输入。
+4. **煮茧日报**
+功能说明：逐日分庄分规格记录送茧量数据。
+设计要求：逐日按庄口 / 规格记录送茧量。
+设计边界：数据供投料统计。
+5. **落丝记录**
+功能说明：逐日记录机组下丝数据。
+设计要求：逐日按机组记录下丝量。
+设计边界：作为产量来源。
+6. **机组车位**
+功能说明：配置前缫车间机组和车位信息。
+设计要求：机组‑车位层级配置。
+设计边界：车台基础档案。
+
+## 后缫工段（ProHou）
+
+1. **返丝日报**
+功能说明：逐日记录浸丝、返丝、编丝、整理片数情况。
+设计要求：逐日登记各工序片数。
+设计边界：后缫产量来源。
+2. **丝片台账**
+功能说明：后缫丝片台账管理。
+设计要求：按车 / 日维护丝片台账。
+设计边界：追溯与检验基础。
+3. **丝片检查**
+功能说明：后缫丝片检查记录。
+设计要求：维护丝片检查数据。
+设计边界：供质检引用。
+4. **秤大丝**
+功能说明：逐日逐车记录丝片称重原始数据。
+设计要求：逐日逐车录入称重原始数据。
+设计边界：为成品与质量数据来源。
+
+## 成品管理（Fims）
+
+1. **成品批次档案**
+功能说明：生丝完成组批后生成成品档案，记录批次号、规格、等级、包件数量、净重，关联来源原料庄口、检验记录。
+设计要求：组批后自动 / 手动生成成品批次；关联原料庄口与检验记录。
+设计边界：成品主数据，供包件 / 出入库引用。
+2. **成品包件管理**
+功能说明：管理每个丝包：包件编号、重量、等级，单包可追溯，绑定库位。
+设计要求：每包唯一编号；绑定库位；可追溯。
+设计边界：包件为成品库存最小单位。
+3. **成品入库**
+功能说明：后缫完工检验完成后办理生丝成品入库，记入成品库存。
+设计要求：检验完成后办理入库；更新库存。
+设计边界：入库驱动成品库存。
+4. **成品状态管理**
+功能说明：区分待检、合格、待商检、不合格、已锁定发货、已出库等业务状态。
+设计要求：状态机管理（待检→合格 / 不合格→待商检→锁定→已出库）。
+设计边界：状态变更需留痕。
+5. **成品库存管理**
+功能说明：按批次、包件、库位管理成品库存，支持库存查询、盘点。
+设计要求：按批次 / 包件 / 库位多维查询；支持盘点。
+设计边界：库存由出入库驱动。
+6. **成品出库执行**
+功能说明：按调拨计划完成成品出库，记录出库包件，更新库存与状态。
+设计要求：依据调拨计划执行出库；记录包件；更新库存与状态。
+设计边界：出库后更新至已出库。
+7. **成品溯源查询**
+功能说明：输入成品批次或包号反向追溯：生丝检验数据→生产机台→投产工艺庄口→原始原料庄口档案。
+设计要求：多级追溯链展示。
+设计边界：只读查询。
+8. **成品统计报表**
+功能说明：按规格、等级、批次统计成品产量、库存、出库数量。
+设计要求：多维统计报表。
+设计边界：报表输出。
+
+## 检验管理（Lims）
+
+1. **丝片检查**
+功能说明：逐日记录疵点丝片检出数据（检验管理侧）。
+设计要求：逐日登记疵点丝片检出数据。
+设计边界：检验数据供定级与质量分析。
+2. **黑板、纤度检验**
+功能说明：逐日逐车记录原始黑板、纤度、公量检验数据。
+设计要求：逐日逐车录入原始检验数据。
+设计边界：检验原始数据来源。
+3. **黑板检验**
+功能说明：逐日记录黑板检验数据。
+设计要求：登记黑板检验原始数据。
+设计边界：供公量纤度与定级引用。
+4. **纤度检验**
+功能说明：逐日记录纤度检验数据。
+设计要求：登记纤度检验原始数据。
+设计边界：供定级引用。
+5. **公量纤度**
+功能说明：管理公量纤度数据。
+设计要求：登记公量纤度数据。
+设计边界：供定级引用。
+6. **检验异常记录**
+功能说明：检验不合格、超标丝片登记，记录异常类型、处置方式（隔离、返工）。
+设计要求：登记异常类型与处置方式（隔离 / 返工）。
+设计边界：异常数据供追溯与质量改进。
+7. **厂检定级判定**
+功能说明：依据整套检验数据调用定级标准自动生丝定级，支持人工复核修改等级。
+设计要求：调用定级标准自动判定；支持人工复核修改；留痕。
+设计边界：判定结果落到成品及批次。
+
+## 能耗管理（Enms）
+
+1. **计量表档案**
+功能说明：维护计量表基础信息，支持传统表、智能表模式，绑定车间、区域、机组，记录表号、初始读数、单价等。
+设计要求：支持传统 / 智能表模式；绑定车间 / 区域 / 机组；表号、初始读数、单价。
+设计边界：只维护计量表档案，读数由抄表功能采集。
+2. **抄表读数**
+功能说明：按周期抄表记录，抄表人，关联工艺庄口，计算用量。
+设计要求：按周期抄表；记录抄表人；关联工艺庄口；计算用量。
+设计边界：用量差异供能耗统计。
+3. **能耗分摊规则配置**
+功能说明：设置分摊逻辑，按投料量、产量、机台运行时长把公共能耗分摊到车间、机组、工艺庄口。
+设计要求：支持按投料量 / 产量 / 机台运行时长分摊公共能耗。
+设计边界：分摊到车间 / 机组 / 工序庄口。
+4. **能耗数据查询**
+功能说明：按日、月、车间、庄口查询水电气蒸汽耗用与能耗成本。
+设计要求：多维度查询水电气蒸汽耗用与成本。
+设计边界：只读查询。
+5. **能耗统计报表**
+功能说明：输出各车间、各庄口能耗消耗报表，数据推送至生产成本模块参与庄口盈亏核算。
+设计要求：生成车间 / 庄口能耗报表；推送生产成本模块。
+设计边界：联动盈亏核算。
+
+## 质量管理（Qums）
+
+1. **粒数测定**
+功能说明：车间班组长用粒数测定。
+设计要求：支持班组长录入粒数测定数据。
+设计边界：质量过程数据。
+2. **选茧现场检查**
+功能说明：支持检查任务制定、检查表单配置、打印单据（选茧）。
+设计要求：任务制定 + 检查表单配置 + 打印。
+设计边界：质量检查记录。
+3. **煮茧现场检查**
+功能说明：支持检查任务制定、检查表单配置、打印单据（煮茧）。
+设计要求：任务制定 + 检查表单配置 + 打印。
+设计边界：质量检查记录。
+4. **缫丝现场检查**
+功能说明：支持检查任务制定、检查表单配置、打印单据（缫丝）。
+设计要求：任务制定 + 检查表单配置 + 打印。
+设计边界：质量检查记录。
+5. **返丝现场检查**
+功能说明：支持检查任务制定、检查表单配置、打印单据（返丝）。
+设计要求：任务制定 + 检查表单配置 + 打印。
+设计边界：质量检查记录。
+
+## 销售管理（Sams）
+
+1. **客户档案**
+功能说明：维护客户基础信息，客户编码、名称、别名、联系人、企业基本信息，区分不同购货客户。
+设计要求：客户编码、名称、别名、联系人及企业信息；区分客户类型。
+设计边界：静态客户档案，供销售合同 / 发货引用。
+2. **销售合同档案**
+功能说明：录入销售合同，记录生丝规格、等级、约定价格、数量，绑定成品生丝批次要求。
+设计要求：合同含生丝规格 / 等级 / 约定价格 / 数量；绑定成品批次要求。
+设计边界：合同为发货计划来源。
+3. **调拨 / 发货计划**
+功能说明：依据销售合同生成发货调拨计划，指定出库生丝批次、包件数量，作为仓库出库执行依据。
+设计要求：由销售合同生成计划；指定出库批次与包件数量。
+设计边界：作为成品出库执行依据。
+4. **回款记录**
+功能说明：记录客户回款信息。
+设计要求：记录回款金额、方式、时间，关联合同。
+设计边界：回款数据供对账与统计。
+5. **销售统计查询**
+功能说明：按客户、时间、生丝规格等级统计销量，数据推送盈亏分析模块用于庄口利润核算。
+设计要求：按客户 / 时间 / 规格等级统计；推送盈亏分析。
+设计边界：联动盈亏核算。
+6. **发票管理**
+功能说明：支持对接票通接口，实现联动开具电子发票。
+设计要求：对接票通接口；联动开票。
+设计边界：依赖第三方发票接口。
+
+## 五金仓储（WmsWu）
+
+1. **五金入库**
+功能说明：五金物资入库登记。
+设计要求：登记入库数量、单价、供应商，生成入库单。
+设计边界：入库更新五金库存，可关联采购报销。
+2. **五金出库**
+功能说明：五金物资出库 / 领用登记。
+设计要求：登记出库数量、领用人、领用部门，生成出库单。
+设计边界：出库扣减五金库存。
+3. **五金库存**
+功能说明：五金物资库存管理。
+设计要求：按物料 / 仓库统计库存；支持查询与预警。
+设计边界：库存由出入库（含采购入库 / 领料）驱动。
+4. **采购计划**
+功能说明：制定五金等物料采购计划。
+设计要求：依据库存与需求生成采购计划。
+设计边界：计划供采购报销 / 入库关联。
+5. **领料申请**
+功能说明：五金领料申请单。
+设计要求：申请领料物料、数量、用途；支持审批。
+设计边界：审批后作为五金出库依据。
+6. **采购报销**
+功能说明：五金采购报销登记。
+设计要求：登记采购费用报销，关联采购 / 入库。
+设计边界：报销数据进入成本。
+7. **五金库存台账**
+功能说明：五金库存变动台账。
+设计要求：记录每笔出入库流水，可追溯。
+设计边界：流水台账只读。
+
+## 副产品管理（WmsFu）
+
+1. **副产品入库**
+功能说明：副产品入库登记。
+设计要求：登记入库副产品、数量，关联庄口。
+设计边界：更新副产品库存。
+2. **副产品出库**
+功能说明：副产品出库登记。
+设计要求：登记出库副产品、数量、去向。
+设计边界：更新副产品库存。
+3. **副产品库存**
+功能说明：副产品库存管理。
+设计要求：按副产品 / 仓库统计库存。
+设计边界：库存由出入库驱动。
+
+## 经营管家（BizBoss）
+
+1. **生产成本分摊**
+功能说明：汇总并分摊生产成本到各庄口。
+设计要求：汇总各类成本（原料 / 人工 / 能耗 / 制造费用等）并按规则分摊到工艺庄口。
+设计边界：分摊结果供盈亏统计。
+2. **分庄口盈亏统计**
+功能说明：统计各项成本、销售收入，生成盈亏分析结果。
+设计要求：汇总成本与销售收入，按庄口计算盈亏。
+设计边界：只读统计报表。
+3. **经营看板**
+功能说明：通过大屏方式查看与老板关心的经营指标。
+设计要求：大屏展示核心经营指标。
+设计边界：展示层，数据来自各模块。
+
+## 报表中心（RepCenter）
+
+1. **报表清单**
+功能说明：根据各生产环节、部门、岗位需求定制报表。
+设计要求：报表清单可配置，按环节 / 部门 / 岗位定制。
+设计边界：报表入口与清单管理。
+2. **报表设计器**
+功能说明：报表设计界面，一般对管理员开放。
+设计要求：可视化设计报表的数据集、字段、样式。
+设计边界：管理员权限；产出生效报表。
+3. **单据设计器**
+功能说明：系统中多处用到的单据在此汇总设计。
+设计要求：统一设计打印单据模板、字段、布局。
+设计边界：管理员权限；供全系统单据引用。
+
+## 看板中心（BoardCenter）
+
+1. **看板清单**
+功能说明：根据各车间大屏情况加载大屏清单。
+设计要求：大屏清单按车间 / 位置配置与加载。
+设计边界：看板清单管理与入口。
+2. **看板设计器**
+功能说明：设计大屏效果和数据。
+设计要求：可视化拖拽设计大屏组件与数据绑定。
+设计边界：管理员权限；产出生效大屏。
+
+## 接口中心（ApiCenter）
+
+1. **内部 Api 管理**
+功能说明：将服务端 Api 进行综合管理，包含但不限于频次、性能等。
+设计要求：API 资产登记、频次与性能监控。
+设计边界：平台级 API 运维管理。
+2. **外部 Api 管理**
+功能说明：将调用的外部 Api 统计在此管理。
+设计要求：外部 API 登记、密钥、调用统计。
+设计边界：外部集成管理。
+3. **金友浪数据同步**
+功能说明：针对金蝶、用友、浪潮等财务软件进行数据同步操作，以推送为主。
+设计要求：对接金蝶 / 用友 / 浪潮等财务软件，数据以推送为主。
+设计边界：依赖第三方财务软件接口。
\ No newline at end of file
diff --git a/项目说明 b/项目说明
new file mode 100644
index 0000000..3f1cc57
--- /dev/null
+++ b/项目说明
@@ -0,0 +1,18 @@
+F9智慧缫丝设计文档，这是一份系统开发设计文档：
+# 一、系统描述
+1.这是一款应用于缫丝厂生产管理的MES系统，包含PC网页端、电视大屏端、小程序端三个平台。
+2.技术要求：网页版：后端采用 .Net10，前端采用Vue最新版，数据库采用云MySQL数据库（地址：116.198.221.105 库名：f9web 用户名：f9web 密码：t~QMq5u6j5 ）ORM框架用Freesql（最新版v3.5.311），本地涉及缓存库的话，采用sqlite最新版；小程序版采用微信的原生开发架构；电视大屏端采用VUE。代码要人性化，必要的地方加上注释，要确保离开AI能够进行人工维护。
+3.数据库设计：表名前面要带模块，例如CRM_Customer等，表中默认要有id字段，flag（标记数据有效状态，0为删除，>0为有效数据，<0为无效数据，其中-1为作废），addtime（数据添加日期），adder（数据添加人，用户uid），updatetime（添加人），updater（修改人），memo（备注）建字段要加字段描述，该建的索引要建索引。
+4.第三方接口：文件图片存储放在阿里云（ "BucketName": "bbit-f9-web",  "EndPoint": "oss-cn-chengdu.aliyuncs.com",  "STSEndPoint": "sts.cn-chengdu.aliyuncs.com",      "AccessKeyId": "LTAI5tSnK8HCPruXm3ZCRZDQ",      "AccessKeySecret": "lHcL75fV809SJYZ3IJtMWlPM7qYUXK"），天气预报采用 Open-Meteo，其他需要时再提供。
+5.项目要求：项目文件架构要求，类文件命名要求前面加模块名称，例如CRM_CustomerList,每个模块的类放在各自文件夹，公共模块的类放在Common文件夹。
+6.其他要求：界面美观，简介，专业的Mes风格，高可配置性，数据字典要专业全面，支持的数据类型多一些。
+7.通用约定：表单均需要支持打印功能，要把表单打印作为通用模块，支持自定义设计打印格式，调用打印支持针式打印机和A4打印机，打印组件参考开源项目（https://github.bbitcn.net/fanhongcai/openprint），整体风格要具有风格统一性，操作按钮位置统一性。表单要具有工作流管理（简易工作流）。
+8.设计开放性：可以参考行业中先进的MES功能，命名等，多借鉴过来，遇到代码困难时，可预留后期突破。
+9.开发步骤：先完成PC端，再进行电视大屏端、小程序端，再进行联调内测
+# 二、缫丝厂的业务流程说明
+缫丝厂基本流程：干茧（也有可能是鲜茧）原料出库后，依次经过选茧工序筛选出上车茧，送入前缫车间开展煮茧作业，经煮茧膨润丝胶后进入自动缫丝机完成索绪、理绪、缫丝落丝，产出小䈅丝片；小䈅丝片流转至后缫工段，完成给湿、复摇返丝、编丝整理，同步开展黑板、纤度、公量等理化检验，按批次完成生丝组批定级，检验合格后入库形成成品生丝，各工序同步产出各类下脚副产品单独归集入库。
+庄口指原料蚕茧的批次化管理，原料庄口指的是A地某年某季的原料蚕茧，工艺庄口指根据生产工艺组合的生产用庄口，开始生产后，全局采用该工艺庄口ID作为贯穿系统的线索，即产生的成本、产量、排工等均已该线索为依据。
+缫丝生产主要的原料就是蚕茧，辅料有一些，能源主要有电力、燃气、煤、水等，产成品主要是生丝，生丝要称重，检验后打柄入库。
+产成品的副产品有条吐、下足茧、茧衣等，这些要进行入库，销售，并暂估或者卖出作为收入。
+缫丝不是按订单排产，核心围绕**工艺庄口**组织生产，不是通用离散制造的工单模式。
+本缫丝厂MES系统旨在解决缫丝环节中的各项信息化的问题。
\ No newline at end of file