mce 0.25.0 → 0.26.0

package/README.md

@@ -67,7 +67,7 @@
 ## 📤 Import & export
 
 - **Export**: `PNG` · `JPEG` · `WebP` · `SVG` · `PDF` · `GIF` · `MP4` · `Lottie` · `PPTX` / `XLSX` / `DOCX` · `JSON`
-- **Import**: `PPTX` / `XLSX` / `DOCX` · `PSD` · `HTML` · images · `JSON`
+- **Import**: `PPTX` / `XLSX` / `DOCX` · `PSD` · `SVG` · `HTML` · images · `JSON`
 
 These ship as optional plugins; their heavy encoders / parsers are lazy-loaded on first use:
 
@@ -76,7 +76,7 @@ These ship as optional plugins; their heavy encoders / parsers are lazy-loaded o
 | `@mce/gif` | GIF export |
 | `@mce/mp4` | MP4 export |
 | `@mce/pdf` | PDF export |
-| `@mce/svg` | SVG export |
+| `@mce/svg` | SVG import & export |
 | `@mce/openxml` | PPTX / XLSX / DOCX import & export |
 | `@mce/psd` | PSD import (Photoshop layers → elements) |
 | `@mce/html` | HTML import |
@@ -91,7 +91,7 @@ Specialized features also ship as optional packages, registered the same way (`p
 | --- | --- |
 | `@mce/table` | Table element + in-canvas table editor |
 | `@mce/chart` | Chart elements (bar / line / pie / …) |
-| `@mce/ai` | Typed AI canvas action schema (`applyAiActions`) |
+| `@mce/ai` | Typed AI canvas action schema (`applyAi`) |
 | `@mce/workflow` | Node-graph editing mode |
 | `@mce/collaboration` | Real-time collaboration: transport providers + presence (cursors / selection / avatars) |
 | `@mce/comments` | Comments: comment tool + pins anchored to elements + threads (stored on `element.comments`) |
@@ -261,12 +261,50 @@ editor.exec('addAnimationKeyframe', 1, { left: 300, opacity: 1 })
 const lottie = editor.exec('exportLottie')
 
 // AI canvas actions (validated, applied in one undo step) — needs @mce/ai
-editor.exec('applyAiActions', [
+editor.exec('applyAi', [
   { type: 'createText', text: 'Hello', x: 40, y: 40 },
   { type: 'align', direction: 'left' },
 ])
 ```
 
+## 🤖 AI
+
+`@mce/ai` ships a **typed action layer**, not a model. It gives you a schema to
+put in your prompt and a safe `applyAi` that validates / sanitizes a batch
+of actions and applies them in a single undo step — wiring the LLM call is up to you.
+
+**1. Register the plugin**
+
+```ts
+import ai from '@mce/ai'
+new Editor({ plugins: [ai()] })
+```
+
+**2. Build the prompt — `getAiPrompt` assembles schema + node ids + request for you**
+
+```ts
+const prompt = editor.exec('getAiPrompt', userInput)
+// Already includes the action schema and every existing node id (so the model can
+// reference current elements). Need the raw schema instead? editor.exec('getAiSchema').
+```
+
+**3. Call your own model, then apply the returned actions**
+
+```ts
+// ← your LLM / SDK; @mce/ai is model-agnostic
+const text = await callYourLLM(prompt)
+const actions = JSON.parse(text) // e.g. [{ type: 'createText', text: 'Hi', x: 40, y: 40 }]
+
+const { created, errors } = editor.exec('applyAi', actions)
+// created: ids of newly created elements
+// errors:  rejected actions + reasons (invalid fields / unknown node ids) — skipped, not applied
+```
+
+- **Model-agnostic** — any LLM / SDK works as long as it emits schema-conforming JSON.
+- **Safe** — invalid actions (bad fields, unknown ids) are rejected into `errors`, never written to the document.
+- **One undo step** — the whole batch is a single undo entry.
+- **Node ids included** — `getAiPrompt` embeds all current node ids, so actions referencing existing elements (`setStyle` / `move` / `delete` / `select` / `duplicate` / `align(ids)`) validate; building the prompt yourself means adding them manually.
+
 ## 🤝 Collaboration
 
 The CRDT document model (Yjs) lives in the **core** — undo / redo and offline
@@ -337,6 +375,31 @@ on the new document's `YDoc`; the transport is bound per-document.
 > Comments (`@mce/comments`) live on `element.comments` and are part of the
 > document model, so they sync over the same session automatically.
 
+## 📚 Packages
+
+Every package ships as ESM and registers the same way (`new Editor({ plugins: [pkg()] })`).
+The default export of each `@mce/*` package is its plugin function; commands it adds are
+called via `editor.exec(name, …)` rather than imported.
+
+| Package | Description | Key exports |
+| --- | --- | --- |
+| `mce` | Headless infinite-canvas editor core (WebGL; export to image / video / PPT). | `Editor`, `EditorLayout`, `EditorLayoutItem`, `EditorLayers`, `createShapeElement` / `createTextElement` / … factories, `useEditor` |
+| `@mce/ai` | LLM-driven, typed canvas actions (`createText` / `createShape` / `setStyle` / `move` / `select` / `delete` / `duplicate` / `align`) applied in one undo step with automatic validation. | `plugin` (default); `validateAiActions`, `AI_ACTION_SCHEMA` (commands: `applyAi`, `getAiSchema`, `getAiPrompt`) |
+| `@mce/bigesj` | Bigesj design-doc integration: font preloading, clipboard paste detection, and PPTX / XLSX / DOCX loading. | `plugin(options)` (default); `useFonts`, `bigeLoader`, `bidTidLoader`, `clipboardLoader` |
+| `@mce/chart` | Bar / line / pie chart elements with a built-in data editor and toolbelt entry. | `plugin` (default); `createChartElement(type, options)` |
+| `@mce/collaboration` | Real-time multi-user editing (Yjs CRDT) over a pluggable provider (built-in WebSocket, y-websocket compatible; swap for WebRTC / BroadcastChannel) plus presence (remote cursors / selection / avatars). | `plugin` (default, registers collaboration + presence); `collaborationPlugin`, `presencePlugin`, `AbstractProvider`, `WebsocketProvider` |
+| `@mce/comments` | Anchored comments: pins anchored to elements that follow on move / scale / rotate, with thread replies / resolve / reopen / delete. | `plugin` (default); `useComments`, `createCommentsStore` |
+| `@mce/gaoding` | Gaoding design-doc clipboard-paste support. | `plugin` (default); `clipboardLoader` |
+| `@mce/gif` | GIF export (frame-by-frame render from timeline keyframes; `modern-gif` lazy-loaded). | `plugin` (default) |
+| `@mce/html` | HTML file / MIME import — DOM converted into canvas elements. | `plugin` (default) |
+| `@mce/mp4` | MP4 export (adaptive bitrate, 720p–2160p, 30fps; `modern-mp4` lazy-loaded). | `plugin` (default) |
+| `@mce/openxml` | PPTX / XLSX / DOCX two-way import & export with smart layer & font mapping (`modern-openxml`). | `plugin` (default) |
+| `@mce/pdf` | PDF export with page metadata (size / margins; `modern-pdf` lazy-loaded). | `plugin` (default) |
+| `@mce/psd` | PSD import — Photoshop layers expanded into elements, layer canvases auto-uploaded as image assets. | `plugin` (default); `psdToFrame` |
+| `@mce/svg` | SVG import & export (Path2D path sets + viewBox, multi-MIME copy). | `plugin` (default) |
+| `@mce/table` | Table element + in-canvas editor (add / remove rows & columns, merge / split cells, style editing, zoom-aware grid, toolbelt entry). | `plugin` (default); `createTableElement(rows, cols, options)` |
+| `@mce/workflow` | Node-graph editing mode (connectable nodes, templated node types, preset text / image / video generation nodes). | `plugin` (default); `getWorkflowPorts`, `toConnectionPoints`, `INPUT_PORT`, `OUTPUT_PORT` (commands: `addWorkflowNode`, `addWorkflowConnection`) |
+
 ## 🏗️ Architecture
 
 ```
@@ -345,7 +408,7 @@ packages/
   gif/           # GIF export  (@mce/gif)
   mp4/           # MP4 export  (@mce/mp4)
   pdf/           # PDF export  (@mce/pdf)
-  svg/           # SVG export  (@mce/svg)
+  svg/           # SVG import & export  (@mce/svg)
   openxml/       # PPTX/XLSX/DOCX import & export  (@mce/openxml)
   psd/           # PSD import  (@mce/psd)
   html/          # HTML import  (@mce/html)
@@ -355,6 +418,8 @@ packages/
   workflow/      # node-graph mode  (@mce/workflow)
   collaboration/ # real-time collaboration  (@mce/collaboration)
   comments/      # comments  (@mce/comments)
+  bigesj/        # Bigesj design-doc integration  (@mce/bigesj)
+  gaoding/       # Gaoding clipboard paste  (@mce/gaoding)
 playground/      # demo & test app
 ```
 

package/dist/components/Selection.vue.d.ts

@@ -30,7 +30,7 @@ declare const __VLS_base: import("vue").DefineComponent<{}, {
             readonly lockAspectRatioStrategy?: "all" | "diagonal" | undefined;
             readonly handleStyle?: "8-points" | "4-points" | undefined;
             readonly handleShape?: "rect" | "circle" | undefined;
-            readonly handles?: ("move" | "resize-b" | "resize-r" | "resize-l" | "resize-t" | "resize-br" | "resize-tr" | "resize-tl" | "resize-bl" | "rotate-br" | "rotate-tr" | "rotate-tl" | "rotate-bl" | "round-br" | "round-tr" | "round-tl" | "round-bl")[] | undefined;
+            readonly handles?: ("move" | "resize-b" | "resize-t" | "resize-r" | "resize-l" | "resize-br" | "resize-tr" | "resize-tl" | "resize-bl" | "rotate-br" | "rotate-tr" | "rotate-tl" | "rotate-bl" | "round-br" | "round-tr" | "round-tl" | "round-bl")[] | undefined;
             readonly scale?: [number, number] | undefined;
             readonly offset?: [number, number] | undefined;
             readonly initialSize?: boolean | undefined;
@@ -69,7 +69,7 @@ declare const __VLS_base: import("vue").DefineComponent<{}, {
             lockAspectRatioStrategy?: "all" | "diagonal";
             handleStyle?: "8-points" | "4-points";
             handleShape?: "rect" | "circle";
-            handles?: ("move" | "resize-b" | "resize-r" | "resize-l" | "resize-t" | "resize-br" | "resize-tr" | "resize-tl" | "resize-bl" | "rotate-br" | "rotate-tr" | "rotate-tl" | "rotate-bl" | "round-br" | "round-tr" | "round-tl" | "round-bl")[];
+            handles?: ("move" | "resize-b" | "resize-t" | "resize-r" | "resize-l" | "resize-br" | "resize-tr" | "resize-tl" | "resize-bl" | "rotate-br" | "rotate-tr" | "rotate-tl" | "rotate-bl" | "round-br" | "round-tr" | "round-tl" | "round-bl")[];
             scale?: [number, number];
             offset?: [number, number];
             initialSize?: boolean;
@@ -85,7 +85,7 @@ declare const __VLS_base: import("vue").DefineComponent<{}, {
             "onUpdate:modelValue"?: ((value: Partial<Mce.TransformValue> | undefined) => any) | undefined;
         }>, {
             start: (event?: MouseEvent, index?: number) => boolean;
-            activeHandle: import("vue").Ref<("move" | "resize-b" | "resize-r" | "resize-l" | "resize-t" | "resize-br" | "resize-tr" | "resize-tl" | "resize-bl" | "rotate-br" | "rotate-tr" | "rotate-tl" | "rotate-bl" | "round-br" | "round-tr" | "round-tl" | "round-bl") | undefined, ("move" | "resize-b" | "resize-r" | "resize-l" | "resize-t" | "resize-br" | "resize-tr" | "resize-tl" | "resize-bl" | "rotate-br" | "rotate-tr" | "rotate-tl" | "rotate-bl" | "round-br" | "round-tr" | "round-tl" | "round-bl") | undefined>;
+            activeHandle: import("vue").Ref<("move" | "resize-b" | "resize-t" | "resize-r" | "resize-l" | "resize-br" | "resize-tr" | "resize-tl" | "resize-bl" | "rotate-br" | "rotate-tr" | "rotate-tl" | "rotate-bl" | "round-br" | "round-tr" | "round-tl" | "round-bl") | undefined, ("move" | "resize-b" | "resize-t" | "resize-r" | "resize-l" | "resize-br" | "resize-tr" | "resize-tl" | "resize-bl" | "rotate-br" | "rotate-tr" | "rotate-tl" | "rotate-bl" | "round-br" | "round-tr" | "round-tl" | "round-bl") | undefined>;
             transforming: import("vue").Ref<boolean, boolean>;
         }, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
             move: (context: Mce.TransformContext) => any;
@@ -97,14 +97,14 @@ declare const __VLS_base: import("vue").DefineComponent<{}, {
             scale: [number, number];
             threshold: number;
             ui: boolean;
+            resizeStrategy: "free" | "lockAspectRatio";
             movable: boolean;
             rotatable: boolean;
             resizable: boolean;
-            resizeStrategy: "free" | "lockAspectRatio";
             tag: string | any;
             lockAspectRatioStrategy: "all" | "diagonal";
             handleShape: "rect" | "circle";
-            handles: ("move" | "resize-b" | "resize-r" | "resize-l" | "resize-t" | "resize-br" | "resize-tr" | "resize-tl" | "resize-bl" | "rotate-br" | "rotate-tr" | "rotate-tl" | "rotate-bl" | "round-br" | "round-tr" | "round-tl" | "round-bl")[];
+            handles: ("move" | "resize-b" | "resize-t" | "resize-r" | "resize-l" | "resize-br" | "resize-tr" | "resize-tl" | "resize-bl" | "rotate-br" | "rotate-tr" | "rotate-tl" | "rotate-bl" | "round-br" | "round-tr" | "round-tl" | "round-bl")[];
         }, {}, string, {}, import("vue").GlobalComponents, import("vue").GlobalDirectives, string, import("vue").ComponentProvideOptions> & {
             beforeCreate?: (() => void) | (() => void)[];
             created?: (() => void) | (() => void)[];
@@ -130,14 +130,14 @@ declare const __VLS_base: import("vue").DefineComponent<{}, {
         scale: [number, number];
         threshold: number;
         ui: boolean;
+        resizeStrategy: "free" | "lockAspectRatio";
         movable: boolean;
         rotatable: boolean;
         resizable: boolean;
-        resizeStrategy: "free" | "lockAspectRatio";
         tag: string | any;
         lockAspectRatioStrategy: "all" | "diagonal";
         handleShape: "rect" | "circle";
-        handles: ("move" | "resize-b" | "resize-r" | "resize-l" | "resize-t" | "resize-br" | "resize-tr" | "resize-tl" | "resize-bl" | "rotate-br" | "rotate-tr" | "rotate-tl" | "rotate-bl" | "round-br" | "round-tr" | "round-tl" | "round-bl")[];
+        handles: ("move" | "resize-b" | "resize-t" | "resize-r" | "resize-l" | "resize-br" | "resize-tr" | "resize-tl" | "resize-bl" | "rotate-br" | "rotate-tr" | "rotate-tl" | "rotate-bl" | "round-br" | "round-tr" | "round-tl" | "round-bl")[];
     }> & Omit<Readonly<{
         ui?: boolean;
         tag?: string | any;
@@ -152,7 +152,7 @@ declare const __VLS_base: import("vue").DefineComponent<{}, {
         lockAspectRatioStrategy?: "all" | "diagonal";
         handleStyle?: "8-points" | "4-points";
         handleShape?: "rect" | "circle";
-        handles?: ("move" | "resize-b" | "resize-r" | "resize-l" | "resize-t" | "resize-br" | "resize-tr" | "resize-tl" | "resize-bl" | "rotate-br" | "rotate-tr" | "rotate-tl" | "rotate-bl" | "round-br" | "round-tr" | "round-tl" | "round-bl")[];
+        handles?: ("move" | "resize-b" | "resize-t" | "resize-r" | "resize-l" | "resize-br" | "resize-tr" | "resize-tl" | "resize-bl" | "rotate-br" | "rotate-tr" | "rotate-tl" | "rotate-bl" | "round-br" | "round-tr" | "round-tl" | "round-bl")[];
         scale?: [number, number];
         offset?: [number, number];
         initialSize?: boolean;
@@ -166,9 +166,9 @@ declare const __VLS_base: import("vue").DefineComponent<{}, {
         onStart?: ((context: Mce.TransformContext) => any) | undefined;
         onEnd?: ((context: Mce.TransformContext) => any) | undefined;
         "onUpdate:modelValue"?: ((value: Partial<Mce.TransformValue> | undefined) => any) | undefined;
-    }>, "transforming" | "start" | "activeHandle" | ("offset" | "scale" | "threshold" | "ui" | "movable" | "rotatable" | "resizable" | "resizeStrategy" | "tag" | "lockAspectRatioStrategy" | "handleShape" | "handles")> & {
+    }>, "transforming" | "start" | "activeHandle" | ("offset" | "scale" | "threshold" | "ui" | "resizeStrategy" | "movable" | "rotatable" | "resizable" | "tag" | "lockAspectRatioStrategy" | "handleShape" | "handles")> & {
         start: (event?: MouseEvent, index?: number) => boolean;
-        activeHandle: ("move" | "resize-b" | "resize-r" | "resize-l" | "resize-t" | "resize-br" | "resize-tr" | "resize-tl" | "resize-bl" | "rotate-br" | "rotate-tr" | "rotate-tl" | "rotate-bl" | "round-br" | "round-tr" | "round-tl" | "round-bl") | undefined;
+        activeHandle: ("move" | "resize-b" | "resize-t" | "resize-r" | "resize-l" | "resize-br" | "resize-tr" | "resize-tl" | "resize-bl" | "rotate-br" | "rotate-tr" | "rotate-tl" | "rotate-bl" | "round-br" | "round-tr" | "round-tl" | "round-bl") | undefined;
         transforming: boolean;
     } & {} & import("vue").ComponentCustomProperties & {} & {
         $slots: {
@@ -215,7 +215,7 @@ declare const __VLS_base: import("vue").DefineComponent<{}, {
             readonly lockAspectRatioStrategy?: "all" | "diagonal" | undefined;
             readonly handleStyle?: "8-points" | "4-points" | undefined;
             readonly handleShape?: "rect" | "circle" | undefined;
-            readonly handles?: ("move" | "resize-b" | "resize-r" | "resize-l" | "resize-t" | "resize-br" | "resize-tr" | "resize-tl" | "resize-bl" | "rotate-br" | "rotate-tr" | "rotate-tl" | "rotate-bl" | "round-br" | "round-tr" | "round-tl" | "round-bl")[] | undefined;
+            readonly handles?: ("move" | "resize-b" | "resize-t" | "resize-r" | "resize-l" | "resize-br" | "resize-tr" | "resize-tl" | "resize-bl" | "rotate-br" | "rotate-tr" | "rotate-tl" | "rotate-bl" | "round-br" | "round-tr" | "round-tl" | "round-bl")[] | undefined;
             readonly scale?: [number, number] | undefined;
             readonly offset?: [number, number] | undefined;
             readonly initialSize?: boolean | undefined;
@@ -254,7 +254,7 @@ declare const __VLS_base: import("vue").DefineComponent<{}, {
             lockAspectRatioStrategy?: "all" | "diagonal";
             handleStyle?: "8-points" | "4-points";
             handleShape?: "rect" | "circle";
-            handles?: ("move" | "resize-b" | "resize-r" | "resize-l" | "resize-t" | "resize-br" | "resize-tr" | "resize-tl" | "resize-bl" | "rotate-br" | "rotate-tr" | "rotate-tl" | "rotate-bl" | "round-br" | "round-tr" | "round-tl" | "round-bl")[];
+            handles?: ("move" | "resize-b" | "resize-t" | "resize-r" | "resize-l" | "resize-br" | "resize-tr" | "resize-tl" | "resize-bl" | "rotate-br" | "rotate-tr" | "rotate-tl" | "rotate-bl" | "round-br" | "round-tr" | "round-tl" | "round-bl")[];
             scale?: [number, number];
             offset?: [number, number];
             initialSize?: boolean;
@@ -270,7 +270,7 @@ declare const __VLS_base: import("vue").DefineComponent<{}, {
             "onUpdate:modelValue"?: ((value: Partial<Mce.TransformValue> | undefined) => any) | undefined;
         }>, {
             start: (event?: MouseEvent, index?: number) => boolean;
-            activeHandle: import("vue").Ref<("move" | "resize-b" | "resize-r" | "resize-l" | "resize-t" | "resize-br" | "resize-tr" | "resize-tl" | "resize-bl" | "rotate-br" | "rotate-tr" | "rotate-tl" | "rotate-bl" | "round-br" | "round-tr" | "round-tl" | "round-bl") | undefined, ("move" | "resize-b" | "resize-r" | "resize-l" | "resize-t" | "resize-br" | "resize-tr" | "resize-tl" | "resize-bl" | "rotate-br" | "rotate-tr" | "rotate-tl" | "rotate-bl" | "round-br" | "round-tr" | "round-tl" | "round-bl") | undefined>;
+            activeHandle: import("vue").Ref<("move" | "resize-b" | "resize-t" | "resize-r" | "resize-l" | "resize-br" | "resize-tr" | "resize-tl" | "resize-bl" | "rotate-br" | "rotate-tr" | "rotate-tl" | "rotate-bl" | "round-br" | "round-tr" | "round-tl" | "round-bl") | undefined, ("move" | "resize-b" | "resize-t" | "resize-r" | "resize-l" | "resize-br" | "resize-tr" | "resize-tl" | "resize-bl" | "rotate-br" | "rotate-tr" | "rotate-tl" | "rotate-bl" | "round-br" | "round-tr" | "round-tl" | "round-bl") | undefined>;
             transforming: import("vue").Ref<boolean, boolean>;
         }, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
             move: (context: Mce.TransformContext) => any;
@@ -282,14 +282,14 @@ declare const __VLS_base: import("vue").DefineComponent<{}, {
             scale: [number, number];
             threshold: number;
             ui: boolean;
+            resizeStrategy: "free" | "lockAspectRatio";
             movable: boolean;
             rotatable: boolean;
             resizable: boolean;
-            resizeStrategy: "free" | "lockAspectRatio";
             tag: string | any;
             lockAspectRatioStrategy: "all" | "diagonal";
             handleShape: "rect" | "circle";
-            handles: ("move" | "resize-b" | "resize-r" | "resize-l" | "resize-t" | "resize-br" | "resize-tr" | "resize-tl" | "resize-bl" | "rotate-br" | "rotate-tr" | "rotate-tl" | "rotate-bl" | "round-br" | "round-tr" | "round-tl" | "round-bl")[];
+            handles: ("move" | "resize-b" | "resize-t" | "resize-r" | "resize-l" | "resize-br" | "resize-tr" | "resize-tl" | "resize-bl" | "rotate-br" | "rotate-tr" | "rotate-tl" | "rotate-bl" | "round-br" | "round-tr" | "round-tl" | "round-bl")[];
         }, {}, string, {}, import("vue").GlobalComponents, import("vue").GlobalDirectives, string, import("vue").ComponentProvideOptions> & {
             beforeCreate?: (() => void) | (() => void)[];
             created?: (() => void) | (() => void)[];
@@ -315,14 +315,14 @@ declare const __VLS_base: import("vue").DefineComponent<{}, {
         scale: [number, number];
         threshold: number;
         ui: boolean;
+        resizeStrategy: "free" | "lockAspectRatio";
         movable: boolean;
         rotatable: boolean;
         resizable: boolean;
-        resizeStrategy: "free" | "lockAspectRatio";
         tag: string | any;
         lockAspectRatioStrategy: "all" | "diagonal";
         handleShape: "rect" | "circle";
-        handles: ("move" | "resize-b" | "resize-r" | "resize-l" | "resize-t" | "resize-br" | "resize-tr" | "resize-tl" | "resize-bl" | "rotate-br" | "rotate-tr" | "rotate-tl" | "rotate-bl" | "round-br" | "round-tr" | "round-tl" | "round-bl")[];
+        handles: ("move" | "resize-b" | "resize-t" | "resize-r" | "resize-l" | "resize-br" | "resize-tr" | "resize-tl" | "resize-bl" | "rotate-br" | "rotate-tr" | "rotate-tl" | "rotate-bl" | "round-br" | "round-tr" | "round-tl" | "round-bl")[];
     }> & Omit<Readonly<{
         ui?: boolean;
         tag?: string | any;
@@ -337,7 +337,7 @@ declare const __VLS_base: import("vue").DefineComponent<{}, {
         lockAspectRatioStrategy?: "all" | "diagonal";
         handleStyle?: "8-points" | "4-points";
         handleShape?: "rect" | "circle";
-        handles?: ("move" | "resize-b" | "resize-r" | "resize-l" | "resize-t" | "resize-br" | "resize-tr" | "resize-tl" | "resize-bl" | "rotate-br" | "rotate-tr" | "rotate-tl" | "rotate-bl" | "round-br" | "round-tr" | "round-tl" | "round-bl")[];
+        handles?: ("move" | "resize-b" | "resize-t" | "resize-r" | "resize-l" | "resize-br" | "resize-tr" | "resize-tl" | "resize-bl" | "rotate-br" | "rotate-tr" | "rotate-tl" | "rotate-bl" | "round-br" | "round-tr" | "round-tl" | "round-bl")[];
         scale?: [number, number];
         offset?: [number, number];
         initialSize?: boolean;
@@ -351,9 +351,9 @@ declare const __VLS_base: import("vue").DefineComponent<{}, {
         onStart?: ((context: Mce.TransformContext) => any) | undefined;
         onEnd?: ((context: Mce.TransformContext) => any) | undefined;
         "onUpdate:modelValue"?: ((value: Partial<Mce.TransformValue> | undefined) => any) | undefined;
-    }>, "transforming" | "start" | "activeHandle" | ("offset" | "scale" | "threshold" | "ui" | "movable" | "rotatable" | "resizable" | "resizeStrategy" | "tag" | "lockAspectRatioStrategy" | "handleShape" | "handles")> & {
+    }>, "transforming" | "start" | "activeHandle" | ("offset" | "scale" | "threshold" | "ui" | "resizeStrategy" | "movable" | "rotatable" | "resizable" | "tag" | "lockAspectRatioStrategy" | "handleShape" | "handles")> & {
         start: (event?: MouseEvent, index?: number) => boolean;
-        activeHandle: ("move" | "resize-b" | "resize-r" | "resize-l" | "resize-t" | "resize-br" | "resize-tr" | "resize-tl" | "resize-bl" | "rotate-br" | "rotate-tr" | "rotate-tl" | "rotate-bl" | "round-br" | "round-tr" | "round-tl" | "round-bl") | undefined;
+        activeHandle: ("move" | "resize-b" | "resize-t" | "resize-r" | "resize-l" | "resize-br" | "resize-tr" | "resize-tl" | "resize-bl" | "rotate-br" | "rotate-tr" | "rotate-tl" | "rotate-bl" | "round-br" | "round-tr" | "round-tl" | "round-bl") | undefined;
         transforming: boolean;
     } & {} & import("vue").ComponentCustomProperties & {} & {
         $slots: {

package/dist/components/shared/Transform.vue.d.ts

@@ -73,10 +73,10 @@ declare const __VLS_base: import("vue").DefineComponent<__VLS_PublicProps, {
     scale: [number, number];
     threshold: number;
     ui: boolean;
+    resizeStrategy: "free" | "lockAspectRatio";
     movable: boolean;
     rotatable: boolean;
     resizable: boolean;
-    resizeStrategy: "free" | "lockAspectRatio";
     tag: string | any;
     lockAspectRatioStrategy: "all" | "diagonal";
     handleShape: "rect" | "circle";

package/dist/crdt/YDoc.d.ts

@@ -15,6 +15,18 @@ export declare const LOCAL_ORIGIN: unique symbol;
  * observe 回调据此跳过回写，避免本地↔yjs 回环。
  */
 export declare const INTERNAL_ORIGIN: unique symbol;
+/**
+ * Element2D 上需要逐键代理同步的 CoreObject 子对象。
+ *
+ * **必须是「全集」而非按内容推导**：即便某子对象当前为空（如未连线的 connection），也要建好
+ * 代理，否则对端后续往该子对象写入将无法同步。漏一项即是一类静默 bug（connection 曾因漏列导致
+ * 连线在对端丢失）。
+ *
+ * **单一事实来源 = 引擎 Element2D.toJSON() 序列化的子对象集**（modern-canvas）。两处独立硬编码
+ * 会漂移，故此处集中定义，并由 YDoc.test.ts 的「子对象覆盖完整」用例对账：引擎新增子对象时测试失败，
+ * 提示在此补列。注：`filter` 在 TS 接口里但不被 toJSON 序列化、也非独立 CoreObject，故不在此列。
+ */
+export declare const ELEMENT2D_SYNCED_SUBOBJECTS: readonly ["style", "background", "shape", "fill", "outline", "text", "foreground", "shadow", "table", "chart", "comments", "connection"];
 export type YNode = Y.Map<unknown> & {
     get: ((prop: 'id') => string) & ((prop: 'name') => string) & ((prop: 'parentId') => string) & ((prop: 'style') => Y.Map<unknown>) & ((prop: 'background') => Y.Map<unknown>) & ((prop: 'shape') => Y.Map<unknown>) & ((prop: 'fill') => Y.Map<unknown>) & ((prop: 'outline') => Y.Map<unknown>) & ((prop: 'text') => Y.Map<unknown>) & ((prop: 'foreground') => Y.Map<unknown>) & ((prop: 'shadow') => Y.Map<unknown>) & ((prop: 'comments') => Y.Map<unknown>) & ((prop: 'meta') => Y.Map<unknown>) & ((prop: 'childrenIds') => Y.Array<string>) & (<T = unknown>(prop: string) => T);
 };