drawui-core 0.5.2 → 0.5.3

package/dist/index.d.cts

@@ -673,11 +673,11 @@ declare const zhCN: {
     readonly 'toolbar.grid': "网格";
     readonly 'toolbar.undo': "撤销 (Ctrl+Z)";
     readonly 'toolbar.redo': "重做 (Ctrl+Shift+Z)";
-    readonly 'toolbar.arrow': "箭头";
-    readonly 'toolbar.text': "文本";
+    readonly 'toolbar.arrow': "箭头 (A)";
+    readonly 'toolbar.text': "文本 (T)";
     readonly 'toolbar.pen': "画笔";
     readonly 'toolbar.highlighter': "荧光笔";
-    readonly 'toolbar.eraser': "橡皮擦";
+    readonly 'toolbar.eraser': "橡皮擦 (E)";
     readonly 'toolbar.uml-class': "UML 类图";
     readonly 'toolbar.uml-interface': "UML 接口";
     readonly 'zoom.in': "放大";
@@ -788,7 +788,6 @@ declare const zhCN: {
     readonly 'table.insertColRight': "在右侧插入列";
     readonly 'table.pickHint': "拖选行列数";
     readonly 'ctx.copy': "复制";
-    readonly 'ctx.copyAsImage': "复制为图片";
     readonly 'ctx.paste': "粘贴";
     readonly 'ctx.duplicate': "创建副本";
     readonly 'ctx.layer': "层级";
@@ -807,7 +806,7 @@ declare const zhCN: {
     readonly 'ctx.lock': "锁定";
     readonly 'ctx.unlock': "解锁";
     readonly 'ctx.delete': "删除";
-    readonly 'toolbar.icon': "图标";
+    readonly 'toolbar.icon': "图标 (S)";
     readonly 'toolbar.image': "图片";
     readonly 'toolbar.more': "更多";
     readonly 'toolbar.pageTheme': "页面主题";
@@ -835,6 +834,7 @@ declare const zhCN: {
     readonly 'iconCat.arrow': "箭头方向";
     readonly 'iconCat.misc': "常用";
     readonly 'iconCat.emoji': "表情";
+    readonly 'iconCat.sticker': "贴纸";
     readonly 'iconCat.device': "电脑设备";
     readonly 'iconCat.weather': "天气";
     readonly 'iconCat.transport': "交通";
@@ -1067,6 +1067,13 @@ declare class Editor {
     private hoverAnchorShapeId;
     private hoverConnectorId;
     private eraserPoint;
+    /**
+     * 橡皮擦「渐隐」中的图形：id → 开始时间戳。
+     * 命中后不立刻从 shapes 里删掉，而是先让不透明度在 ERASE_FADE_MS 内降到 0，
+     * 到点再真正移除（这样擦除是「变浅 → 消失」而不是「啪一下不见」）。
+     */
+    private eraseFades;
+    private eraseFadeRaf;
     private mindMapEditingShapeId;
     private mindMapSelectedNode;
     private mindMapHoverNode;
@@ -1170,6 +1177,20 @@ declare class Editor {
     private updateBoundArrows;
     private getBindingPosition;
     private deleteShape;
+    /**
+     * 橡皮擦命中：图形先进入「渐隐」再被真正删除（见 eraseFades）。
+     * 历史快照在拖拽开始时已经打过，所以整段擦除仍然只占一个撤销点。
+     */
+    private eraseShape;
+    /** 渐隐时钟：每帧推进，到点的图形才真正删除；整批结束后停表 */
+    private tickEraseFade;
+    /** 当前帧各渐隐图形的不透明度（0~1）；没有渐隐时返回 undefined，避免每帧建 Map */
+    private eraseFadeMap;
+    /**
+     * 丢弃所有未完成的渐隐（撤销 / 重做 / 整体换数据时调用）。
+     * 否则「撤销把图形救回来 → 渐隐计时器到点又把它删掉」会凭空吃掉一次撤销。
+     */
+    private clearEraseFades;
     /**
      * 选中图形（additive=true 时切换选中态）；id 为空串清空选中。右键菜单/外部控制用。
      * ⚠️ 组感知：点任一成员都会选中它所属的整组（同组的绑行为一致），additive 时整组一起加减。
@@ -1930,7 +1951,9 @@ declare class Renderer {
     /** 悬停的图形 id：为其绘制四边连接锚点（飞书式悬浮提示），已选中图形由选择手柄负责 */
     hoverAnchorShapeId?: string | null, 
     /** 悬停的连线 id：整条线描一层浅蓝高亮（提示「这条线可点、点开能调线段」） */
-    hoverConnectorId?: string | null): void;
+    hoverConnectorId?: string | null, 
+    /** 橡皮擦渐隐：图形 id → 不透明度（0~1）。缺省时不改任何图形的透明度 */
+    eraseFade?: Map<string, number> | null): void;
     /** 橡皮擦：半透明主色圆 + 主色描边，半径与笔刷命中范围一致（屏幕像素恒定） */
     private drawEraserBrush;
     /** 连接进行中，高亮目标图形四边中点的可连锚点 */
@@ -2286,7 +2309,7 @@ declare const ICON_CATEGORIES: {
     id: IconCategoryId;
     labelKey: MessageKey;
 }[];
-type IconCategoryId = 'status' | 'number' | 'emoji' | 'device' | 'tech' | 'chart' | 'office' | 'media' | 'arrow' | 'misc' | 'weather' | 'transport' | 'nature' | 'building' | 'medical' | 'shopping' | 'science' | 'animal' | 'time' | 'edit' | 'food' | 'communication';
+type IconCategoryId = 'status' | 'number' | 'emoji' | 'sticker' | 'device' | 'tech' | 'chart' | 'office' | 'media' | 'arrow' | 'misc' | 'weather' | 'transport' | 'nature' | 'building' | 'medical' | 'shopping' | 'science' | 'animal' | 'time' | 'edit' | 'food' | 'communication';
 interface IconLayer {
     /** 24×24 网格内的路径（语法同 SVG path，统一大写指令） */
     d: string;
@@ -2423,6 +2446,8 @@ interface ToolContext {
     addShape(shape: Shape): void;
     updateShape(id: string, updates: Partial<Shape>): void;
     deleteShape(id: string): void;
+    /** 橡皮擦专用：先渐隐再删除（普通删除请用 deleteShape） */
+    eraseShape(id: string): void;
     selectShape(id: string, additive: boolean): void;
     selectShapes(ids: string[]): void;
     getShapes(): Shape[];

package/dist/index.d.ts

@@ -673,11 +673,11 @@ declare const zhCN: {
     readonly 'toolbar.grid': "网格";
     readonly 'toolbar.undo': "撤销 (Ctrl+Z)";
     readonly 'toolbar.redo': "重做 (Ctrl+Shift+Z)";
-    readonly 'toolbar.arrow': "箭头";
-    readonly 'toolbar.text': "文本";
+    readonly 'toolbar.arrow': "箭头 (A)";
+    readonly 'toolbar.text': "文本 (T)";
     readonly 'toolbar.pen': "画笔";
     readonly 'toolbar.highlighter': "荧光笔";
-    readonly 'toolbar.eraser': "橡皮擦";
+    readonly 'toolbar.eraser': "橡皮擦 (E)";
     readonly 'toolbar.uml-class': "UML 类图";
     readonly 'toolbar.uml-interface': "UML 接口";
     readonly 'zoom.in': "放大";
@@ -788,7 +788,6 @@ declare const zhCN: {
     readonly 'table.insertColRight': "在右侧插入列";
     readonly 'table.pickHint': "拖选行列数";
     readonly 'ctx.copy': "复制";
-    readonly 'ctx.copyAsImage': "复制为图片";
     readonly 'ctx.paste': "粘贴";
     readonly 'ctx.duplicate': "创建副本";
     readonly 'ctx.layer': "层级";
@@ -807,7 +806,7 @@ declare const zhCN: {
     readonly 'ctx.lock': "锁定";
     readonly 'ctx.unlock': "解锁";
     readonly 'ctx.delete': "删除";
-    readonly 'toolbar.icon': "图标";
+    readonly 'toolbar.icon': "图标 (S)";
     readonly 'toolbar.image': "图片";
     readonly 'toolbar.more': "更多";
     readonly 'toolbar.pageTheme': "页面主题";
@@ -835,6 +834,7 @@ declare const zhCN: {
     readonly 'iconCat.arrow': "箭头方向";
     readonly 'iconCat.misc': "常用";
     readonly 'iconCat.emoji': "表情";
+    readonly 'iconCat.sticker': "贴纸";
     readonly 'iconCat.device': "电脑设备";
     readonly 'iconCat.weather': "天气";
     readonly 'iconCat.transport': "交通";
@@ -1067,6 +1067,13 @@ declare class Editor {
     private hoverAnchorShapeId;
     private hoverConnectorId;
     private eraserPoint;
+    /**
+     * 橡皮擦「渐隐」中的图形：id → 开始时间戳。
+     * 命中后不立刻从 shapes 里删掉，而是先让不透明度在 ERASE_FADE_MS 内降到 0，
+     * 到点再真正移除（这样擦除是「变浅 → 消失」而不是「啪一下不见」）。
+     */
+    private eraseFades;
+    private eraseFadeRaf;
     private mindMapEditingShapeId;
     private mindMapSelectedNode;
     private mindMapHoverNode;
@@ -1170,6 +1177,20 @@ declare class Editor {
     private updateBoundArrows;
     private getBindingPosition;
     private deleteShape;
+    /**
+     * 橡皮擦命中：图形先进入「渐隐」再被真正删除（见 eraseFades）。
+     * 历史快照在拖拽开始时已经打过，所以整段擦除仍然只占一个撤销点。
+     */
+    private eraseShape;
+    /** 渐隐时钟：每帧推进，到点的图形才真正删除；整批结束后停表 */
+    private tickEraseFade;
+    /** 当前帧各渐隐图形的不透明度（0~1）；没有渐隐时返回 undefined，避免每帧建 Map */
+    private eraseFadeMap;
+    /**
+     * 丢弃所有未完成的渐隐（撤销 / 重做 / 整体换数据时调用）。
+     * 否则「撤销把图形救回来 → 渐隐计时器到点又把它删掉」会凭空吃掉一次撤销。
+     */
+    private clearEraseFades;
     /**
      * 选中图形（additive=true 时切换选中态）；id 为空串清空选中。右键菜单/外部控制用。
      * ⚠️ 组感知：点任一成员都会选中它所属的整组（同组的绑行为一致），additive 时整组一起加减。
@@ -1930,7 +1951,9 @@ declare class Renderer {
     /** 悬停的图形 id：为其绘制四边连接锚点（飞书式悬浮提示），已选中图形由选择手柄负责 */
     hoverAnchorShapeId?: string | null, 
     /** 悬停的连线 id：整条线描一层浅蓝高亮（提示「这条线可点、点开能调线段」） */
-    hoverConnectorId?: string | null): void;
+    hoverConnectorId?: string | null, 
+    /** 橡皮擦渐隐：图形 id → 不透明度（0~1）。缺省时不改任何图形的透明度 */
+    eraseFade?: Map<string, number> | null): void;
     /** 橡皮擦：半透明主色圆 + 主色描边，半径与笔刷命中范围一致（屏幕像素恒定） */
     private drawEraserBrush;
     /** 连接进行中，高亮目标图形四边中点的可连锚点 */
@@ -2286,7 +2309,7 @@ declare const ICON_CATEGORIES: {
     id: IconCategoryId;
     labelKey: MessageKey;
 }[];
-type IconCategoryId = 'status' | 'number' | 'emoji' | 'device' | 'tech' | 'chart' | 'office' | 'media' | 'arrow' | 'misc' | 'weather' | 'transport' | 'nature' | 'building' | 'medical' | 'shopping' | 'science' | 'animal' | 'time' | 'edit' | 'food' | 'communication';
+type IconCategoryId = 'status' | 'number' | 'emoji' | 'sticker' | 'device' | 'tech' | 'chart' | 'office' | 'media' | 'arrow' | 'misc' | 'weather' | 'transport' | 'nature' | 'building' | 'medical' | 'shopping' | 'science' | 'animal' | 'time' | 'edit' | 'food' | 'communication';
 interface IconLayer {
     /** 24×24 网格内的路径（语法同 SVG path，统一大写指令） */
     d: string;
@@ -2423,6 +2446,8 @@ interface ToolContext {
     addShape(shape: Shape): void;
     updateShape(id: string, updates: Partial<Shape>): void;
     deleteShape(id: string): void;
+    /** 橡皮擦专用：先渐隐再删除（普通删除请用 deleteShape） */
+    eraseShape(id: string): void;
     selectShape(id: string, additive: boolean): void;
     selectShapes(ids: string[]): void;
     getShapes(): Shape[];