mce 0.24.3 → 0.25.0

package/dist/locale/en.d.ts

@@ -8,7 +8,6 @@ declare const _default: {
     painting: string;
     selecting: string;
     cropping: string;
-    tableEditing: string;
     selectObject: string;
     commitChanges: string;
     extend: string;
@@ -30,10 +29,6 @@ declare const _default: {
     ellipse: string;
     polygon: string;
     star: string;
-    table: string;
-    chartBar: string;
-    chartLine: string;
-    chartPie: string;
     image: string;
     video: string;
     lottie: string;
@@ -71,7 +66,6 @@ declare const _default: {
     view: string;
     mode: string;
     'mode:canvas': string;
-    'mode:workflow': string;
     checkerboard: string;
     pixelGrid: string;
     ruler: string;
@@ -80,6 +74,7 @@ declare const _default: {
     'checkerboard:grid': string;
     'checkerboard:dot': string;
     panels: string;
+    components: string;
     timeline: string;
     play: string;
     pause: string;
@@ -89,11 +84,58 @@ declare const _default: {
     stepBackward: string;
     stepForward: string;
     collapse: string;
+    removeKeyframe: string;
+    custom: string;
+    saveEasingPreset: string;
+    playbackRate: string;
+    loopMode: string;
+    loopOnce: string;
+    loopAll: string;
+    loopPingpong: string;
+    addAnimation: string;
+    removeAnimation: string;
+    animationItem: string;
+    animGroupIn: string;
+    animGroupOut: string;
+    animGroupEmphasis: string;
+    fadeIn: string;
+    slideInLeft: string;
+    slideInRight: string;
+    slideInUp: string;
+    slideInDown: string;
+    popIn: string;
+    fadeOut: string;
+    slideOutDown: string;
+    pulse: string;
+    spin: string;
+    interactions: string;
+    preview: string;
+    exitPreview: string;
+    previewExitHint: string;
+    interactionsSelectHint: string;
+    addInteraction: string;
+    removeInteraction: string;
+    targetFrame: string;
+    trigger_click: string;
+    trigger_pointerEnter: string;
+    trigger_pointerLeave: string;
+    trigger_load: string;
+    trigger_scrollIntoView: string;
+    selectVariable: string;
+    variableValue: string;
+    conditionWhen: string;
+    conditionAlways: string;
+    scrollDriven: string;
+    action_setVariable: string;
+    action_restart: string;
+    action_play: string;
+    action_pause: string;
+    action_toggle: string;
+    action_navigate: string;
+    action_openUrl: string;
+    action_toggleVisible: string;
     statusbar: string;
     creator: string;
-    'workflow:text': string;
-    'workflow:image': string;
-    'workflow:video': string;
     memoryManager: string;
     toolbelt: string;
     msaa: string;

package/dist/locale/zh-Hans.d.ts

@@ -8,7 +8,6 @@ declare const _default: {
     painting: string;
     selecting: string;
     cropping: string;
-    tableEditing: string;
     selectObject: string;
     commitChanges: string;
     extend: string;
@@ -30,10 +29,6 @@ declare const _default: {
     ellipse: string;
     polygon: string;
     star: string;
-    table: string;
-    chartBar: string;
-    chartLine: string;
-    chartPie: string;
     image: string;
     video: string;
     lottie: string;
@@ -71,7 +66,6 @@ declare const _default: {
     view: string;
     mode: string;
     'mode:canvas': string;
-    'mode:workflow': string;
     checkerboard: string;
     pixelGrid: string;
     ruler: string;
@@ -80,6 +74,7 @@ declare const _default: {
     'checkerboard:grid': string;
     'checkerboard:dot': string;
     panels: string;
+    components: string;
     statusbar: string;
     timeline: string;
     play: string;
@@ -90,10 +85,57 @@ declare const _default: {
     stepBackward: string;
     stepForward: string;
     collapse: string;
+    removeKeyframe: string;
+    custom: string;
+    saveEasingPreset: string;
+    playbackRate: string;
+    loopMode: string;
+    loopOnce: string;
+    loopAll: string;
+    loopPingpong: string;
+    addAnimation: string;
+    removeAnimation: string;
+    animationItem: string;
+    animGroupIn: string;
+    animGroupOut: string;
+    animGroupEmphasis: string;
+    fadeIn: string;
+    slideInLeft: string;
+    slideInRight: string;
+    slideInUp: string;
+    slideInDown: string;
+    popIn: string;
+    fadeOut: string;
+    slideOutDown: string;
+    pulse: string;
+    spin: string;
+    interactions: string;
+    preview: string;
+    exitPreview: string;
+    previewExitHint: string;
+    interactionsSelectHint: string;
+    addInteraction: string;
+    removeInteraction: string;
+    targetFrame: string;
+    trigger_click: string;
+    trigger_pointerEnter: string;
+    trigger_pointerLeave: string;
+    trigger_load: string;
+    trigger_scrollIntoView: string;
+    selectVariable: string;
+    variableValue: string;
+    conditionWhen: string;
+    conditionAlways: string;
+    scrollDriven: string;
+    action_setVariable: string;
+    action_restart: string;
+    action_play: string;
+    action_pause: string;
+    action_toggle: string;
+    action_navigate: string;
+    action_openUrl: string;
+    action_toggleVisible: string;
     creator: string;
-    'workflow:text': string;
-    'workflow:image': string;
-    'workflow:video': string;
     memoryManager: string;
     toolbelt: string;
     msaa: string;

package/dist/mixins/0.context.d.ts

@@ -50,6 +50,8 @@ declare global {
             getGlobalPointer: () => Vector2Like;
             parseAnchor: (anchor: Anchor, isRtl?: boolean) => ParsedAnchor;
             isNode: (value: any) => value is Node;
+            /** 按 id 取节点：走 SceneTree 的 nodeMap（随 nodeEnter/nodeExit 增量维护），O(1) 且始终最新。 */
+            getNodeById: (id: string) => Node | undefined;
             isRootNode: (node: Node) => boolean;
             isFrameNode: (node: Node, isTop?: boolean) => boolean;
             inEditorIs: (node: Node, inEditorIs?: EditorNodeType) => boolean;

package/dist/mixins/extensions.d.ts

@@ -0,0 +1,105 @@
+import type { Element2D } from 'modern-canvas';
+import type { Component, Ref } from 'vue';
+declare global {
+    namespace Mce {
+        /**
+         * 把命中的节点重定向到真正应被选中的节点（如表格单元格 → 表格元素）。
+         * 返回 undefined 表示不改写。由插件注册，供选择 / 悬停策略统一应用。
+         */
+        type SelectionRedirect = (node: Element2D, editor: Editor) => Element2D | undefined;
+        /**
+         * 自定义某元素的缩放行为（如表格按行列网格重算尺寸而非整体缩放）。
+         * 返回 true 表示已处理、跳过默认缩放；返回 false 走默认。
+         */
+        interface ResizeOverrideContext {
+            scaleX: number;
+            scaleY: number;
+            newWidth: number;
+            newHeight: number;
+            options: Mce.ResizeElementOptions;
+        }
+        type ResizeOverride = (element: Element2D, context: ResizeOverrideContext) => boolean;
+        /**
+         * 进入元素编辑（Enter / 双击）。返回 true 表示已处理，停止后续 handler 与核心默认行为。
+         */
+        type EnterHandler = (element: Element2D, editor: Editor) => boolean;
+        /**
+         * 插件向工具腰带（底部主工具栏）追加的一级按钮（如 @mce/comments 的评论工具）。
+         * 底部主工具栏：工具即按钮，带激活高亮 / tooltip / 快捷键提示。
+         */
+        interface ToolbeltItem {
+            /** 图标 / i18n key：图标取 `$<key>`，tooltip 取 `t(key)`，快捷键提示按 key 推断。 */
+            key: string;
+            /** 自定义图标名（默认 `$<key>`）。 */
+            icon?: string;
+            /** 是否激活（高亮）。渲染时调用，读响应式状态即可自动更新。 */
+            isActive?: () => boolean;
+            /** 点击处理。 */
+            handle: () => void;
+            /** 放置在内置工具之前 / 之后（默认 after）。 */
+            placement?: 'before' | 'after';
+        }
+        interface Editor {
+            /** 选择重定向链。 */
+            selectionRedirects: SelectionRedirect[];
+            registerSelectionRedirect: (fn: SelectionRedirect) => void;
+            /** 依次应用所有重定向，得到最终应被选中的节点。 */
+            resolveSelectionRedirect: (node: Element2D | undefined) => Element2D | undefined;
+            /** 缩放行为覆盖链。 */
+            resizeOverrides: ResizeOverride[];
+            registerResizeOverride: (fn: ResizeOverride) => void;
+            /** 应用覆盖；返回 true 表示某插件已处理缩放。 */
+            applyResizeOverride: (element: Element2D, context: ResizeOverrideContext) => boolean;
+            /** 进入编辑处理链。 */
+            enterHandlers: EnterHandler[];
+            registerEnterHandler: (fn: EnterHandler) => void;
+            /**
+             * 内容编辑态集合：处于这些 state 时隐藏选择框 / 浮动条、抑制快捷键。
+             * 默认空；由插件注册自己的编辑态（如 table 注册 'tableEditing'）。
+             * 注意：核心的 'typing' 不在此集合，仍按原有逻辑各处单独处理。
+             */
+            editingStates: Set<string>;
+            registerEditingState: (state: string) => void;
+            /** 当前是否处于某个已注册的内容编辑态。 */
+            isContentEditing: () => boolean;
+            /**
+             * 插件向工具栏「形状」下拉追加的工具 key（如 @mce/table 的 'table'、@mce/chart 的图表）。
+             * key 同时是工具名（activateTool(key)）与图标 / 文案 key。
+             */
+            toolbeltShapeItems: Ref<string[]>;
+            registerToolbeltShapeItem: (key: string) => void;
+            /**
+             * 插件注册的图标：alias 名（不含 `$`）→ SVG path。会在 EditorLayout 创建图标集时
+             * 合并进 IconsSymbol 的 aliases，从而让 `$<name>` 可解析。供 @mce/table、@mce/chart
+             * 等把自己的图标随插件携带，核心图标集不再硬编码它们。
+             */
+            icons: Ref<Record<string, string>>;
+            registerIcon: (name: string, path: string) => void;
+            /**
+             * 插件注册的编辑模式（除核心 'canvas' 外，如 @mce/workflow 的 'workflow'）。
+             * 菜单的模式切换项据此生成；模式 UI 由插件以 overlay 组件按 mode 自行条件渲染。
+             */
+            modes: Ref<string[]>;
+            registerMode: (mode: string) => void;
+            /**
+             * 插件向状态栏右侧追加的组件（如 @mce/collaboration 的连接状态 / 在场头像）。
+             * Statusbar 据此渲染，核心状态栏不再直接 import 插件组件。
+             */
+            statusbarItems: Ref<Component[]>;
+            registerStatusbarItem: (component: Component) => void;
+            /**
+             * 插件向工具腰带追加的一级按钮（如 @mce/comments 的评论工具）。
+             * Toolbelt 据此渲染，核心不再硬编码插件工具。
+             */
+            toolbeltItems: Ref<ToolbeltItem[]>;
+            registerToolbeltItem: (item: ToolbeltItem) => void;
+        }
+    }
+}
+/**
+ * 通用扩展点：让插件（如 @mce/table、@mce/chart）把原本硬编码在核心里的特例行为
+ * （选择重定向、缩放覆盖、进入编辑、内容编辑态）注册进来，从而把元素类型相关逻辑
+ * 从核心解耦出去。
+ */
+declare const _default: import("..").Mixin;
+export default _default;

package/dist/mixins/panels.d.ts

@@ -0,0 +1,46 @@
+import type { Ref, WritableComputedRef } from 'vue';
+declare global {
+    namespace Mce {
+        interface PanelTransform {
+            left: number;
+            top: number;
+            width: number;
+            height: number;
+        }
+        interface PanelState {
+            visible?: boolean;
+            /** 浮动面板位置 / 尺寸。 */
+            transform?: PanelTransform;
+            /** 停靠面板尺寸（宽或高，按 position）。 */
+            size?: number;
+        }
+        interface UIConfig {
+            /** 各面板的持久化运行时状态（显隐 / 浮动位置尺寸），按面板 name 索引。 */
+            panels: Record<string, PanelState>;
+        }
+        interface PanelsApi {
+            /** 面板显隐的可写引用（桥接到 config，统一数据源）。 */
+            visibleRef: (name: string) => WritableComputedRef<boolean>;
+            /** 浮动面板位置 / 尺寸的可写引用（持久化）。 */
+            transformRef: (name: string) => WritableComputedRef<PanelTransform | undefined>;
+            /** 停靠面板尺寸的可写引用（持久化）。 */
+            sizeRef: (name: string) => WritableComputedRef<number | undefined>;
+            /** 浮动面板层叠顺序（内存态，决定 z-index）。 */
+            floatOrder: Ref<string[]>;
+            /** 把某浮动面板提到最前。 */
+            bringToFront: (name: string) => void;
+            /** 浮动面板关闭时移出层叠栈。 */
+            release: (name: string) => void;
+            /** 某浮动面板当前 z-index。 */
+            floatZIndex: (name: string) => number;
+            /** 写入浮动面板位置 / 尺寸（自动做画布边界约束）。 */
+            setTransform: (name: string, transform: PanelTransform) => void;
+        }
+        interface Editor {
+            /** 面板运行时状态的单一数据源（float 与 dock 共用）。 */
+            panels: PanelsApi;
+        }
+    }
+}
+declare const _default: import("..").Mixin;
+export default _default;

package/dist/plugin.d.ts

@@ -11,6 +11,11 @@ export interface PluginPanelComponent extends PluginBaseComponent {
     name: string;
     position: 'float' | 'top' | 'right' | 'bottom' | 'left';
     size?: number;
+    /** 停靠面板是否可拖拽调整尺寸（默认 true；细条如 statusbar 设 false）。 */
+    resizable?: boolean;
+    /** 停靠面板拖拽尺寸下限 / 上限。 */
+    minSize?: number;
+    maxSize?: number;
 }
 export interface PluginDialogComponent extends PluginBaseComponent {
     type: 'dialog';
@@ -19,6 +24,15 @@ export interface PluginOverlayComponent extends PluginBaseComponent {
     type: 'overlay';
 }
 export type PluginComponent = PluginOverlayComponent | PluginDialogComponent | PluginPanelComponent;
+export declare function isPanelComponent<T extends {
+    type?: string;
+}>(c: T): c is T & PluginPanelComponent;
+export declare function isOverlayComponent<T extends {
+    type?: string;
+}>(c: T): c is T & PluginOverlayComponent;
+export declare function isDialogComponent<T extends {
+    type?: string;
+}>(c: T): c is T & PluginDialogComponent;
 export interface PluginObject {
     name: string;
     ignore?: () => boolean;

package/dist/plugins/animate.d.ts

@@ -0,0 +1,40 @@
+import type { Element2D } from 'modern-canvas';
+import type { Keyframe } from '../utils';
+declare global {
+    namespace Mce {
+        interface ExportLottieOptions {
+            width?: number;
+            height?: number;
+            fps?: number;
+        }
+        interface AnimationTiming {
+            duration?: number;
+            delay?: number;
+        }
+        interface Commands {
+            getElementKeyframes: (node?: Element2D) => Keyframe[];
+            /** 在指定时间点（offset 0..1）插入 / 更新关键帧（合并 props）。 */
+            addAnimationKeyframe: (offset: number, props: Record<string, any>, node?: Element2D) => void;
+            removeAnimationKeyframe: (offset: number, node?: Element2D) => void;
+            setAnimationKeyframeEasing: (offset: number, easing: string, node?: Element2D) => void;
+            setAnimationTiming: (timing: AnimationTiming, node?: Element2D) => void;
+            /** 应用预设动画（进入 / 退出 / 强调），按元素当前样式生成关键帧；同类预设会被替换。 */
+            applyAnimationPreset: (id: string, node?: Element2D) => void;
+            /** 独立播放某元素自身的动画（脱离全局时间轴，各元素各自计时）。restart 从头播，否则续播。 */
+            playElementAnimation: (node?: Element2D, restart?: boolean) => void;
+            /** 暂停某元素的独立播放，冻结在当前帧。 */
+            pauseElementAnimation: (node?: Element2D) => void;
+            /** 切换某元素独立播放 / 暂停。 */
+            toggleElementAnimation: (node?: Element2D) => void;
+            /** 停止独立播放并恢复跟随全局时间轴。 */
+            stopElementAnimation: (node?: Element2D) => void;
+            /** 注册可复用的自定义缓动（名字 → cubic-bezier 字符串），存于文档。 */
+            registerEasing: (name: string, value: string) => void;
+            getEasings: () => Record<string, string>;
+            /** 把场景里所有带关键帧动画的元素导出为 Lottie JSON（transform / opacity 通道）。 */
+            exportLottie: (options?: ExportLottieOptions) => object;
+        }
+    }
+}
+declare const _default: import("..").Plugin;
+export default _default;

package/dist/plugins/components.d.ts

@@ -0,0 +1,32 @@
+import type { Element2D, Node } from 'modern-canvas';
+import type { ComponentDef } from '../utils';
+declare global {
+    namespace Mce {
+        interface CreateInstanceOptions {
+            position?: AddElementPosition;
+            parent?: Node;
+            active?: boolean;
+        }
+        interface Commands {
+            /** 把选中（或指定）元素登记为组件 master，返回组件 id。 */
+            createComponent: (node?: Element2D) => string | undefined;
+            /** 从组件实例化一个 instance，返回实例元素 id。 */
+            createInstance: (componentId: string, options?: CreateInstanceOptions) => string | undefined;
+            /** 设置实例的路径级覆盖并重建该实例。 */
+            setInstanceOverride: (path: string, value: any, node?: Element2D) => void;
+            /** 解除实例与组件的关联，变回普通元素。 */
+            detachInstance: (node?: Element2D) => void;
+            /** 用某节点的当前内容更新组件 master，并传播到所有实例。 */
+            updateComponent: (componentId: string, node?: Element2D) => void;
+            /** 把某组件的所有实例按 master + 各自 override 重建。 */
+            syncInstancesOf: (componentId: string) => void;
+            getComponents: () => ComponentDef[];
+            /** 批量灌入预置组件（按 id 去重 / 覆盖），用于预设组件库 / 模板。 */
+            loadComponentPresets: (defs: ComponentDef[]) => void;
+            /** 从组件库移除一个组件定义（已落地的实例不受影响）。 */
+            removeComponent: (componentId: string) => void;
+        }
+    }
+}
+declare const _default: import("..").Plugin;
+export default _default;

package/dist/plugins/flexLayout.d.ts

@@ -1,3 +1,18 @@
+import type { FlexDirection } from 'modern-idoc';
+declare global {
+    namespace Mce {
+        /** Container-level flex/auto-layout properties exposed to UI panels. */
+        type FlexStyleKey = 'flexDirection' | 'flexWrap' | 'justifyContent' | 'alignItems' | 'alignContent' | 'gap' | 'padding' | 'paddingTop' | 'paddingLeft' | 'paddingRight' | 'paddingBottom';
+        interface Commands {
+            enableFlexLayout: (direction?: FlexDirection) => void;
+            disableFlexLayout: () => void;
+            toggleFlexLayout: () => void;
+            isFlexLayout: () => boolean;
+            setFlexStyle: (key: FlexStyleKey, value: any) => void;
+            getFlexStyle: (key: FlexStyleKey) => any;
+        }
+    }
+}
 /**
  * Drag-to-reorder for children of a flex/auto-layout container.
  *

package/dist/plugins/history.d.ts

@@ -4,6 +4,8 @@ declare global {
         interface Editor {
             canUndo: Ref<boolean>;
             canRedo: Ref<boolean>;
+            /** 撤回 / 重做进行中（同步触发底层回退、本 tick 内为 true）。供需要区分「用户操作」与「历史回退」来源的逻辑使用。 */
+            isUndoRedoing: Ref<boolean>;
             undo: () => void;
             redo: () => void;
         }

package/dist/plugins/interactions.d.ts

@@ -0,0 +1,44 @@
+import type { Element2D, Node } from 'modern-canvas';
+import type { Ref } from 'vue';
+declare global {
+    namespace Mce {
+        type InteractionTrigger = 'click' | 'pointerEnter' | 'pointerLeave' | 'load' | 'scrollIntoView';
+        type InteractionAction = 'restart' | 'play' | 'pause' | 'toggle' | 'navigate' | 'openUrl' | 'toggleVisible' | 'setVariable';
+        type ConditionOp = '==' | '!=' | '>' | '<';
+        interface InteractionCondition {
+            variableId: string;
+            op: ConditionOp;
+            value: any;
+        }
+        interface Interaction {
+            id: string;
+            trigger: InteractionTrigger;
+            action: InteractionAction;
+            /** 目标元素 / 帧 id，缺省为触发元素自身。 */
+            target?: string;
+            url?: string;
+            frameId?: string;
+            variableId?: string;
+            value?: any;
+            /** 仅当条件成立才执行（轻量状态机：配合 setVariable）。 */
+            condition?: InteractionCondition;
+        }
+        interface Editor {
+            /** 预览（可交互）模式：开启后点击元素触发其交互，编辑操作被禁用。 */
+            previewMode: Ref<boolean>;
+            /** 交互数据变更计数（meta 写入非响应式，用它驱动 UI 刷新）。 */
+            interactionsRev: Ref<number>;
+            /** 滚动驱动：预览态下用滚轮进度驱动时间轴播放头（scrollytelling）。 */
+            scrollDriven: Ref<boolean>;
+        }
+        interface Commands {
+            getElementInteractions: (node?: Element2D) => Interaction[];
+            setElementInteractions: (interactions: Interaction[], node?: Element2D) => void;
+            togglePreview: () => void;
+            runInteraction: (interaction: Interaction, source: Node) => void;
+        }
+    }
+}
+export declare function createInteractionId(): string;
+declare const _default: import("../plugin").Plugin;
+export default _default;

package/dist/plugins/shape.d.ts

@@ -7,10 +7,6 @@ declare global {
             ellipse: [];
             polygon: [];
             star: [];
-            table: [];
-            chartBar: [];
-            chartLine: [];
-            chartPie: [];
         }
     }
 }

package/dist/plugins/slice.d.ts

@@ -1,2 +1,12 @@
+declare global {
+    namespace Mce {
+        interface Commands {
+            exportSlice: (options: ExportOptions) => Promise<HTMLCanvasElement | undefined>;
+        }
+        interface Tools {
+            slice: [];
+        }
+    }
+}
 declare const _default: import("..").Plugin;
 export default _default;

package/dist/plugins/smartGuides.d.ts

@@ -1,4 +1,4 @@
-export type { BoundingBox, Box, Line, LinePair, LinePairType, LineType } from '../utils/smartGuides-geometry';
-export { createLine, findDistancePairs, flipType, isLeftTopLine, toBoundingBox } from '../utils/smartGuides-geometry';
+export type { BoundingBox, Box, Line, LinePair, LinePairType, LineType } from '../utils/smartGuidesGeometry';
+export { createLine, findDistancePairs, flipType, isLeftTopLine, toBoundingBox } from '../utils/smartGuidesGeometry';
 declare const _default: import("..").Plugin;
 export default _default;

package/dist/plugins/timeline.d.ts

@@ -1,3 +1,4 @@
+import type { Animation } from 'modern-canvas';
 import type { Ref } from 'vue';
 declare global {
     namespace Mce {
@@ -7,10 +8,26 @@ declare global {
         interface TimelineConfig {
             visible: boolean;
         }
+        /** 正在轨道上编辑的关键帧（点击菱形时弹出浮层），null 表示未打开。 */
+        interface KeyframeEditing {
+            anim: Animation;
+            offset: number;
+            /** 锚点屏幕坐标（菱形中心顶端），供浮层定位。 */
+            target: {
+                x: number;
+                y: number;
+            };
+        }
+        /** 循环模式：单次（到尾暂停）/ 循环（回到开头）/ 往返（到尾反向）。 */
+        type LoopMode = 'none' | 'loop' | 'alternate';
         interface Editor {
             paused: Ref<boolean>;
             fps: Ref<number>;
+            /** 播放倍速，1 为正常速度。 */
+            playbackRate: Ref<number>;
+            loopMode: Ref<LoopMode>;
             recomputeTimelineEndTime: () => Promise<void>;
+            keyframeEditing: Ref<KeyframeEditing | null>;
         }
         interface Commands {
             play: () => void;

package/dist/plugins/toolbelt.d.ts

@@ -5,6 +5,10 @@ declare global {
         }
         interface ToolbeltConfig {
             visible: boolean;
+            /** 浮动停靠方向：上 / 下 / 左 / 右。左右为竖向排列。默认 bottom。 */
+            placement?: 'top' | 'bottom' | 'left' | 'right';
+            /** 沿停靠边的中心坐标（上 / 下 为 x、左 / 右 为 y，相对画板像素）。undefined 表示居中。 */
+            offset?: number;
         }
     }
 }

package/dist/plugins/variables.d.ts

@@ -0,0 +1,27 @@
+import type { Element2D } from 'modern-canvas';
+import type { VariablesState, VariableType, VariableValue } from '../utils';
+declare global {
+    namespace Mce {
+        /** 节点属性路径（如 'fill.color'、'style.opacity'）→ 变量 id 的绑定，存于节点 meta.variableBindings。 */
+        type VariableBindings = Record<string, string>;
+        interface Commands {
+            createVariableCollection: (name: string, modeName?: string) => string;
+            addVariableMode: (collectionId: string, name: string) => string;
+            addVariable: (collectionId: string, variable: {
+                name: string;
+                type: VariableType;
+                value: VariableValue;
+            }) => string;
+            setVariableValue: (variableId: string, modeId: string, value: VariableValue) => void;
+            /** 切换某 collection 的当前 mode（如亮 / 暗），并把绑定重新解析到画布。 */
+            setActiveVariableMode: (collectionId: string, modeId: string) => void;
+            bindVariable: (styleKey: string, variableId: string, node?: Element2D) => void;
+            unbindVariable: (styleKey: string, node?: Element2D) => void;
+            getVariablesState: () => VariablesState;
+            /** 把所有节点上的变量绑定按当前 mode 解析并写入样式。 */
+            resolveVariables: () => void;
+        }
+    }
+}
+declare const _default: import("..").Plugin;
+export default _default;

package/dist/plugins/zoom.d.ts

@@ -22,6 +22,8 @@ declare global {
             zoomTo100: () => void;
             zoomToFit: () => void;
             zoomToSelection: (options?: ZoomToOptions) => void;
+            zoomToNextFrame: (options?: ZoomToOptions) => void;
+            zoomToPreviousFrame: (options?: ZoomToOptions) => void;
         }
         interface Hotkeys {
             zoomIn: [event: KeyboardEvent];