mce 0.29.7 → 0.30.0

package/dist/locale/en.d.ts

@@ -37,7 +37,7 @@ declare const _default: {
     file: string;
     newDoc: string;
     openDoc: string;
-    import: string;
+    importFile: string;
     export: string;
     'saveAs:png': string;
     'saveAs:jpeg': string;
@@ -147,8 +147,8 @@ declare const _default: {
     flip: string;
     flipHorizontal: string;
     flipVertical: string;
-    showOrHideSelection: string;
-    lockOrUnlockSelection: string;
+    toggleSelectionVisible: string;
+    toggleSelectionLock: string;
     layerOrder: string;
     bringToFront: string;
     bringForward: string;

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

@@ -37,7 +37,7 @@ declare const _default: {
     file: string;
     newDoc: string;
     openDoc: string;
-    import: string;
+    importFile: string;
     export: string;
     'saveAs:png': string;
     'saveAs:jpeg': string;
@@ -147,8 +147,8 @@ declare const _default: {
     flip: string;
     flipHorizontal: string;
     flipVertical: string;
-    showOrHideSelection: string;
-    lockOrUnlockSelection: string;
+    toggleSelectionVisible: string;
+    toggleSelectionLock: string;
     layerOrder: string;
     bringToFront: string;
     bringForward: string;

package/dist/mixins/1.upload.d.ts

@@ -3,9 +3,12 @@ declare global {
         type Upload = (file: File | Blob) => Promise<string>;
         interface Editor {
             upload: Upload;
+            /** 运行时设置/替换上传实现（返回上传后的可访问 URL）。 */
+            setUploader: (uploader: Upload) => void;
         }
         interface Options {
-            customUpload?: Upload;
+            /** 上传实现：传入 blob，返回上传后的可访问 URL。也可运行时用 {@link Editor.setUploader} 设置。 */
+            uploader?: Upload;
         }
     }
 }

package/dist/mixins/extensions.d.ts

@@ -1,6 +1,7 @@
 import type { Element2D } from 'modern-canvas';
+import type { ImagePipeline as ImagePipelineRef, PipelineImage } from 'modern-idoc';
 import type { Component, Ref } from 'vue';
-import type { AnimationPreset } from '../utils';
+import type { AnimationPreset, ImagePipeline } from '../utils';
 declare global {
     namespace Mce {
         /**
@@ -102,6 +103,16 @@ declare global {
             animationPresets: Ref<AnimationPreset[]>;
             registerAnimationPreset: (preset: AnimationPreset) => void;
             getAnimationPreset: (id: string) => AnimationPreset | undefined;
+            /**
+             * 插件 / 宿主注册的图片处理管线（`image → image`，如描边/调色/抠图）。
+             * 数据只记录管线名与参数（`ImageFill.imagePipelines`），处理函数为运行时黑盒。
+             * 注册同 name 则覆盖。渲染端经引擎解析器烘焙，非渲染导出端经 `materializeImagePipelines` 物化。
+             */
+            imagePipelines: Ref<ImagePipeline[]>;
+            registerImagePipeline: (pipeline: ImagePipeline) => void;
+            getImagePipeline: (name: string) => ImagePipeline | undefined;
+            /** 把一串管线步骤依次作用到图片像素上（引擎解析器与导出物化共用）。 */
+            resolveImagePipelines: (steps: ImagePipelineRef[], image: PipelineImage) => Promise<PipelineImage>;
         }
     }
 }

package/dist/plugins/components.d.ts

@@ -17,7 +17,7 @@ declare global {
             /** 解除实例与组件的关联，变回普通元素。 */
             detachInstance: (node?: Element2D) => void;
             /** 用某节点的当前内容更新组件 master，并传播到所有实例。 */
-            updateComponent: (componentId: string, node?: Element2D) => void;
+            setComponent: (componentId: string, node?: Element2D) => void;
             /** 把某组件的所有实例按 master + 各自 override 重建。 */
             syncInstancesOf: (componentId: string) => void;
             getComponents: () => ComponentDef[];

package/dist/plugins/import.d.ts

@@ -4,10 +4,10 @@ declare global {
         interface ImportOptions extends AddElementOptions {
         }
         interface Commands {
-            import: (options?: ImportOptions) => Promise<Element2D[]>;
+            importFile: (options?: ImportOptions) => Promise<Element2D[]>;
         }
         interface Hotkeys {
-            import: [event: KeyboardEvent];
+            importFile: [event: KeyboardEvent];
         }
     }
 }

package/dist/plugins/save.d.ts

@@ -0,0 +1,36 @@
+declare global {
+    namespace Mce {
+        type SaveReason = 'auto' | 'hotkey' | 'manual';
+        interface SaveEvent {
+            /** 触发来源：自动保存 / 快捷键 / 外部主动调用 */
+            reason: SaveReason;
+            /** 惰性取当前文档数据（仅在外部需要时序列化） */
+            getData: () => JsonData;
+        }
+        interface AutoSaveConfig {
+            /** 是否在文档变更后自动触发 save 事件 */
+            enabled: boolean;
+            /** 变更后空闲多久（ms）才触发，debounce 合并连续编辑 */
+            debounceMs: number;
+        }
+        interface Config {
+            autoSave: AutoSaveConfig;
+        }
+        interface Editor {
+            /** 请求保存：仅对外抛出 'save' 事件，实际持久化由外部消费者处理 */
+            save: (reason?: SaveReason) => void;
+        }
+        interface Commands {
+            save: (reason?: SaveReason) => void;
+        }
+        interface Hotkeys {
+            save: [event: KeyboardEvent];
+        }
+        interface Events {
+            /** 保存请求；外部通过 editor.on('save', ({ reason, getData }) => ...) 处理持久化 */
+            save: [event: SaveEvent];
+        }
+    }
+}
+declare const _default: import("..").Plugin;
+export default _default;

package/dist/plugins/selection.d.ts

@@ -16,8 +16,8 @@ declare global {
             groupSelection: () => void;
             ungroupSelection: () => void;
             frameSelection: () => void;
-            showOrHideSelection: (target?: 'show' | 'hide') => void;
-            lockOrUnlockSelection: (target?: 'lock' | 'unlock') => void;
+            toggleSelectionVisible: (target?: 'show' | 'hide') => void;
+            toggleSelectionLock: (target?: 'lock' | 'unlock') => void;
         }
         interface Hotkeys {
             selectAll: [event: KeyboardEvent];
@@ -30,8 +30,8 @@ declare global {
             groupSelection: [event: KeyboardEvent];
             ungroupSelection: [event: KeyboardEvent];
             frameSelection: [event: KeyboardEvent];
-            showOrHideSelection: [event: KeyboardEvent];
-            lockOrUnlockSelection: [event: KeyboardEvent];
+            toggleSelectionVisible: [event: KeyboardEvent];
+            toggleSelectionLock: [event: KeyboardEvent];
         }
         interface Slots {
             'selection'?: () => void;

package/dist/plugins/transform.d.ts

@@ -36,7 +36,7 @@ declare global {
             direction?: string;
         }
         interface Commands {
-            enter: () => void;
+            editElement: () => void;
             getTransform: () => TransformValue;
             setTransform: (type: TransformType, value: Partial<TransformValue>, options?: TransformOptions) => void;
             move: (direction: MoveDirection, distance?: number) => void;
@@ -51,7 +51,7 @@ declare global {
             flipVertical: () => void;
         }
         interface Hotkeys {
-            enter: [event: KeyboardEvent];
+            editElement: [event: KeyboardEvent];
             moveLeft: [event: KeyboardEvent];
             moveTop: [event: KeyboardEvent];
             moveRight: [event: KeyboardEvent];

package/dist/plugins/typography.d.ts

@@ -23,7 +23,7 @@ declare global {
         interface Commands {
             startTyping: (event?: MouseEvent) => Promise<boolean>;
             addTextElement: (options?: addTextElementOptions) => Element2D;
-            handleTextSelection: (textSelection: IndexCharacter[], cb: (arg: Record<string, any>) => boolean) => void;
+            eachTextSelection: (textSelection: IndexCharacter[], cb: (arg: Record<string, any>) => boolean) => void;
             textFontSizeToFit: (element: Element2D, scale?: number) => void;
             textToFit: (element: Element2D, typography?: TypographyStrategy) => void;
             getTextStyle: (key: string) => any;

package/dist/plugins/variables.d.ts

@@ -6,8 +6,8 @@ declare global {
         type VariableBindings = Record<string, string>;
         interface Commands {
             createVariableCollection: (name: string, modeName?: string) => string;
-            addVariableMode: (collectionId: string, name: string) => string;
-            addVariable: (collectionId: string, variable: {
+            createVariableMode: (collectionId: string, name: string) => string;
+            createVariable: (collectionId: string, variable: {
                 name: string;
                 type: VariableType;
                 value: VariableValue;

package/dist/typed-plugins.d.ts

@@ -49,6 +49,7 @@ import './plugins/menu'
 import './plugins/node'
 import './plugins/pen'
 import './plugins/ruler'
+import './plugins/save'
 import './plugins/saveAs'
 import './plugins/scroll'
 import './plugins/selection'

package/dist/utils/helper.d.ts

@@ -1,6 +1,11 @@
 import type { ComponentInternalInstance, ComponentPublicInstance, InjectionKey, VNodeChild } from 'vue';
 import type { DeepMaybe } from '../types';
 export declare function noop(..._args: any): void;
+/**
+ * 节点是否为 flex/自动布局容器（其子节点由布局引擎定位，而非绝对 left/top）。
+ * 统一各插件（transform/selection/smartGuides/flexLayout）对 `display === 'flex'` 的判断。
+ */
+export declare function isFlexContainer(node?: any): boolean;
 export declare function isClickInsideElement(event: MouseEvent, targetDiv: HTMLElement): boolean;
 export interface TemplateRef {
     (target: Element | ComponentPublicInstance | null): void;

package/dist/utils/imagePipeline.d.ts

@@ -0,0 +1,26 @@
+import type { ImagePipeline as ImagePipelineRef, PipelineImage } from 'modern-idoc';
+/**
+ * 图片处理管线（外部可注册）：把图片像素处理成新的图片像素（`image → image`）。
+ *
+ * 数据只记录管线名与参数（`ImageFill.imagePipelines`，元素类型 `ImagePipelineRef`），
+ * 处理函数为运行时注册的黑盒，不入持久化数据。渲染端经引擎注入的解析器烘焙到运行时纹理；
+ * 非渲染的导出端（pdf/svg/pptx）经 `materializeImagePipelines` 物化成成品图。
+ */
+export interface ImagePipeline {
+    /** 唯一名，对应数据 `imagePipelines[].name`。 */
+    name: string;
+    /** 显示名 i18n key（可选），供 UI 列表使用。 */
+    label?: string;
+    /** 处理函数：接收图片像素 + 参数，返回处理后的像素，可异步。 */
+    process: (image: PipelineImage, params?: Record<string, any>) => PipelineImage | Promise<PipelineImage>;
+}
+type ImagePipelineResolver = (steps: ImagePipelineRef[], image: PipelineImage) => Promise<PipelineImage>;
+/**
+ * 导出前物化：深度遍历文档，把所有带 `imagePipelines` 的图片填充跑一遍管线，
+ * 结果写回 `image`（PNG dataURI）并删除 `imagePipelines` 字段。这样数据解析类导出器
+ * （pdf/svg/pptx）只看到普通图片填充，无需各自实现管线逻辑，跨端一致。
+ *
+ * 注意：原地修改传入的 `doc`（导出链路里 `doc` 已是 `toJSON` 出的独立快照）。
+ */
+export declare function materializeImagePipelines(doc: any, resolve: ImagePipelineResolver): Promise<void>;
+export {};

package/dist/utils/index.d.ts

@@ -11,6 +11,7 @@ export * from './dnd';
 export * from './easing';
 export * from './helper';
 export * from './image';
+export * from './imagePipeline';
 export * from './keyframes';
 export * from './line';
 export * from './lottie';

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "mce",
   "type": "module",
-  "version": "0.29.7",
+  "version": "0.30.0",
   "description": "A headless infinite canvas editor framework built on WebGL rendering, supports exporting to image, video, and PPT. Only the ESM.",
   "author": "wxm",
   "license": "MIT",
@@ -60,9 +60,9 @@
     "@vueuse/core": "^14.3.0",
     "diff": "^9.0.0",
     "lodash-es": "^4.18.1",
-    "modern-canvas": "^0.24.11",
+    "modern-canvas": "^0.25.0",
     "modern-font": "^0.6.1",
-    "modern-idoc": "^0.12.1",
+    "modern-idoc": "^0.12.3",
     "modern-text": "^2.0.9",
     "y-protocols": "^1.0.7",
     "yjs": "^13.6.31"