mail-editor-pancake 0.2.7 → 0.3.0

package/README.md

@@ -128,6 +128,8 @@ http://localhost:5173/?locale=zh-CN
 http://localhost:5173/?locale=en-US
 ```
 
+也可点击页面右下角语言按钮即时切换：保留当前画布内容，销毁旧实例后按新语言重建，并同步 URL 参数。
+
 ---
 
 ## 安装与集成
@@ -452,6 +454,7 @@ function createBlocks(locale: SimpleMailLocale) {
 | `hideTopbarClearCanvas?` / `hideTopbarResetContent?` | 隐藏清空 / 重置 |
 | `hideTopbarDocClipboard?` | 隐藏「复制设计稿」「导入设计稿」 |
 | `hideTopbarInsertVariable?` | 隐藏顶栏「插入变量」（改由应用内其他入口插入时） |
+| `hideTopbarSectionSelect?` | 隐藏顶栏「选择节」入口（Section 批量复制 / 导出 / 删除） |
 | `topbarCompact?` | 顶栏默认仅图标（窄屏/嵌入） |
 | `topbarLabels?` | `auto`（默认）\| `never` \| `always`；与 `topbarCompact` 配合 |
 | `topbarCompactMinWidth?` | `topbarLabels: auto` 时展示文案的最小宽度 px，默认 1200 |
@@ -569,20 +572,50 @@ import {
 - 复制：信封 `{ kind: 'simple-mail/doc', formatVersion: 1, doc }` 写入系统剪贴板。
 - 导入：粘贴 JSON 或裸 `EmailDoc`（`version: '1'`），覆盖当前画布（可撤销）。
 
+### 局部设计稿（追加粘贴）
+
+Section / Block 悬浮工具条的 **复制设计稿** 按钮（双层文档图标）可只复制当前节/组件：
+
+- 信封 `{ kind: 'simple-mail/selection', formatVersion: 1, sections, blocks, variables }`。
+- 粘贴走同一个「导入设计稿」对话框：识别到局部信封时按钮自动变为「追加到画布」，不覆盖现有内容。
+- 追加语义：Section 插到当前选中节之后（无选中则追加末尾）；Block 插到选中块之后，否则包一层单列 Section 落到末尾。
+- 未注册的 `custom:*` 类型会被跳过并在 toast 中提示；内容引用到的 `{{key}}` 变量按 key 并入目标文档变量列表（已存在的不重复）。
+- 全程可撤销（⌘Z）。
+
 ```ts
-await editor.copyDocDesign();
-editor.openImportDocDesign();
-editor.importDocDesignFromJson(raw); // 与对话框「应用」相同
+await editor.copySelectionDesign();                       // 复制当前选中 Section/Block
+await editor.copySelectionDesign({ sectionId: 'sec_x' }); // 显式指定
+editor.importSelectionDesignFromJson(raw);                // 程序化追加（simple-mail/selection 信封）
 
 import {
   DOC_CLIPBOARD_KIND,
+  SELECTION_CLIPBOARD_KIND,
   parseDocClipboard,
+  parseSelectionClipboard,
   regenerateDocIds,
   serializeDocClipboard,
+  serializeSelectionClipboard,
+  collectSelectionVariableKeys,
 } from '@simple-mail/core';
 ```
 
-跨实例迁移时可用 `regenerateDocIds` 避免 id 冲突。
+### 节选择模式（批量复制 / 导出 / 删除）
+
+顶栏「选择节」按钮（勾选列表图标，可通过 `hideTopbarSectionSelect` 隐藏）进入 Section 批量操作模式：
+
+- 进入后点击 Section 勾选 / 取消（屏蔽单选、拖拽排序、内联编辑与悬浮工具条），底部出现浮动操作条：**已选 N 节 · 全选 · 复制设计稿 · 导出 JSON · 删除 · 完成**。
+- **复制设计稿**：多个 Section 一次性写入剪贴板（与局部设计稿同信封，可在其他画布「追加」粘贴）。
+- **导出 JSON**：下载 `simple-mail-sections-<日期>.json`，内容与剪贴板信封同构，可手动粘贴到导入对话框。
+- **删除**：弹出确认后一次 `store.update` 批量删除，单条撤销记录（⌘Z 整体恢复）。
+- Esc 或再次点击顶栏按钮退出模式；文档变化（撤销 / 清空等）时已失效的勾选自动清理。
+
+```ts
+await editor.copySectionsDesign(['sec_1', 'sec_2']); // 批量复制多节到剪贴板
+editor.exportSectionsDesign(['sec_1', 'sec_2']);     // 批量导出多节 JSON 文件
+editor.removeSections(['sec_1', 'sec_2']);           // 批量删除（返回实际删除数量）
+```
+
+跨实例迁移时可用 `regenerateDocIds` 避免 id 冲突；局部粘贴由编辑器自动重生成 id（`remapSectionIds` / `regenerateBlockId`）。
 
 ---
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mail-editor-pancake",
-  "version": "0.2.7",
+  "version": "0.3.0",
   "private": false,
   "description": "面向运营的轻量邮件可视化编辑器",
   "devDependencies": {