y-mxgraph 0.1.5 → 0.2.0

package/README.md

@@ -24,18 +24,24 @@ pnpm add y-mxgraph yjs y-protocols
 
 ```ts
 import * as Y from 'yjs';
-import { Binding, LOCAL_ORIGIN } from 'y-mxgraph';
+import { Binding } from 'y-mxgraph';
 
 const doc = new Y.Doc();
 
 App.main((app) => {
-  // Ensure consistent initial files across clients. draw.io generates random diagram ids by default,
-  // which can cause sync issues if clients start from different states. Use generateFileTemplate to create a unified template.
-  if (!app.currentFile.data) {
-    app.currentFile.data = Binding.generateFileTemplate('diagram-0');
-  }
-
-  const binding = new Binding(app.currentFile, { doc });
+  const file = app.currentFile;
+
+  // Binding automatically reconciles file and Y.Doc based on
+  // `initialContent` strategy (default: 'replace').
+  //   - 'replace'      : Y.Doc wins; file UI is replaced with doc XML
+  //   - 'merge-remote' : union by diagram id; doc wins on conflicts
+  //   - 'merge-client' : union by diagram id; file wins on conflicts
+  //
+  // By default only `file.ui.setFileData(xml)` is called (rebuilds UI).
+  // `file.setData(xml)` is intentionally NOT called so draw.io does not
+  // mark the file as modified and pop up the "Save diagrams to:" dialog.
+  // Override via `applyFileData` if you need to sync `file.data` too.
+  const binding = new Binding(file, { doc /*, initialContent: 'merge-remote' */ });
 
   window.addEventListener('beforeunload', () => binding.destroy());
 });

package/binding/index.d.ts

@@ -1,6 +1,13 @@
 import * as Y from "yjs";
 import { type Awareness } from "y-protocols/awareness";
 import type { DrawioFile } from "../types/drawio";
+/**
+ * 控制 Binding 构造时 file 与 Y.Doc 的初始内容对齐策略。
+ * - `replace`      : doc 非空则用 doc 覆盖 file；doc 为空则保留 file 现有数据（默认）。
+ * - `merge-remote` : 按 diagram id 取并集，同 id 冲突时以 doc 为准（远端权威）。
+ * - `merge-client` : 按 diagram id 取并集，同 id 冲突时以 file 为准（本地权威，覆盖到 doc）。
+ */
+export type InitialContentStrategy = "replace" | "merge-remote" | "merge-client";
 export interface BindDrawioFileOptions {
     doc: Y.Doc;
     awareness?: Awareness;
@@ -10,6 +17,20 @@ export interface BindDrawioFileOptions {
         userNameKey?: string;
         userColorKey?: string;
     };
+    /**
+     * 初始内容对齐策略，默认 `replace`。详见 {@link InitialContentStrategy}。
+     */
+    initialContent?: InitialContentStrategy;
+    /**
+     * 自定义把 XML 应用到 file 的方式。默认实现只调用
+     * `file.ui.setFileData(xml)`（刷新 UI / 重建 pages），
+     * **不会**调用 `file.setData(xml)`，以避免把 file 标记为「已修改」
+     * 触发 draw.io 的 "Save diagrams to:" 存储选择对话框。
+     *
+     * 若业务方确实需要同步 `file.data`（如自定义 CollabFile 或依赖
+     * `file.save()`），可提供自定义实现。
+     */
+    applyFileData?: (file: DrawioFile, xml: string) => void;
 }
 /**
  * Y-MXGraph 绑定类，管理 draw.io 文件与 Y.Doc 的双向同步

package/binding/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/binding/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AACzB,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAOvD,OAAO,KAAK,EAAE,UAAU,EAAgB,MAAM,iBAAiB,CAAC;AAEhE,MAAM,WAAW,qBAAqB;IACpC,GAAG,EAAE,CAAC,CAAC,GAAG,CAAC;IACX,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,WAAW,CAAC,EAAE,CAAC,CAAC,WAAW,CAAC;IAC5B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,MAAM,CAAC,EACH,OAAO,GACP;QACE,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,CAAC;CACP;AAED;;;;;;;GAOG;AACH,qBAAa,OAAO;IAClB,wBAAwB;IACxB,QAAQ,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,CAAC;IACpB,6BAA6B;IAC7B,OAAO,CAAC,YAAY,CAAe;IACnC,sBAAsB;IACtB,OAAO,CAAC,kBAAkB,CAAS;IACnC,4BAA4B;IAC5B,OAAO,CAAC,cAAc,CAAS;IAC/B,2BAA2B;IAC3B,OAAO,CAAC,UAAU,CAAa;IAC/B,oBAAoB;IACpB,OAAO,CAAC,WAAW,CAKT;IACV,gCAAgC;IAChC,OAAO,CAAC,mBAAmB,CAAC,CAAa;IACzC,yBAAyB;IACzB,OAAO,CAAC,kBAAkB,CAAC,CAAa;gBAE5B,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,qBAAqB;IA4G5D;;;OAGG;IACH,OAAO,CAAC,IAAI,UAAQ,GAAG,IAAI;IAS3B;;;;;;;;;;;;;;OAcG;IACH,MAAM,CAAC,oBAAoB,CAAC,SAAS,SAAc,GAAG,MAAM;IAa5D;;;OAGG;IACH,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,qBAAqB,GAAG,OAAO;CAGzE"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/binding/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AACzB,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAiBvD,OAAO,KAAK,EAAE,UAAU,EAAgB,MAAM,iBAAiB,CAAC;AAEhE;;;;;GAKG;AACH,MAAM,MAAM,sBAAsB,GAC9B,SAAS,GACT,cAAc,GACd,cAAc,CAAC;AAEnB,MAAM,WAAW,qBAAqB;IACpC,GAAG,EAAE,CAAC,CAAC,GAAG,CAAC;IACX,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,WAAW,CAAC,EAAE,CAAC,CAAC,WAAW,CAAC;IAC5B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,MAAM,CAAC,EACH,OAAO,GACP;QACE,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,CAAC;IACN;;OAEG;IACH,cAAc,CAAC,EAAE,sBAAsB,CAAC;IACxC;;;;;;;;OAQG;IACH,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CACzD;AA0KD;;;;;;;GAOG;AACH,qBAAa,OAAO;IAClB,wBAAwB;IACxB,QAAQ,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,CAAC;IACpB,6BAA6B;IAC7B,OAAO,CAAC,YAAY,CAAe;IACnC,sBAAsB;IACtB,OAAO,CAAC,kBAAkB,CAAS;IACnC,4BAA4B;IAC5B,OAAO,CAAC,cAAc,CAAS;IAC/B,2BAA2B;IAC3B,OAAO,CAAC,UAAU,CAAa;IAC/B,oBAAoB;IACpB,OAAO,CAAC,WAAW,CAKT;IACV,gCAAgC;IAChC,OAAO,CAAC,mBAAmB,CAAC,CAAa;IACzC,yBAAyB;IACzB,OAAO,CAAC,kBAAkB,CAAC,CAAa;gBAE5B,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,qBAAqB;IA+G5D;;;OAGG;IACH,OAAO,CAAC,IAAI,UAAQ,GAAG,IAAI;IAS3B;;;;;;;;;;;;;;OAcG;IACH,MAAM,CAAC,oBAAoB,CAAC,SAAS,SAAc,GAAG,MAAM;IAa5D;;;OAGG;IACH,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,qBAAqB,GAAG,OAAO;CAGzE"}

package/index.d.ts

@@ -1,5 +1,5 @@
 export { Binding } from "./binding";
-export type { BindDrawioFileOptions } from "./binding";
+export type { BindDrawioFileOptions, InitialContentStrategy } from "./binding";
 export { xml2doc, doc2xml } from "./transformer";
 export { LOCAL_ORIGIN } from "./helper/origin";
 export { DEFAULT_USER_NAME_KEY, DEFAULT_USER_COLOR_KEY, } from "./binding/collaborator";

package/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,YAAY,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AACvD,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EACL,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,wBAAwB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,YAAY,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC;AAC/E,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EACL,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,wBAAwB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "y-mxgraph",
-  "version": "0.1.5",
+  "version": "0.2.0",
   "description": "Yjs binding for draw.io (mxGraph) documents",
   "keywords": [
     "yjs",
@@ -28,6 +28,11 @@
       "types": "./index.d.ts"
     }
   },
+  "dependencies": {
+    "colord": "^2.9.3",
+    "lodash-es": "^4.17.21",
+    "xml-js": "^1.6.11"
+  },
   "peerDependencies": {
     "y-protocols": "^1.0.0",
     "yjs": "^13.6.0"

package/types/drawio.d.ts

@@ -56,6 +56,8 @@ export interface DrawioUi {
     pages: unknown[];
     diffPages(oldPages: unknown[], newPages: unknown[]): unknown;
     clonePages(pages: unknown[]): unknown[];
+    /** 解析 XML 并重建 pages / mxGraphModel，触发 UI 重绘 */
+    setFileData(data: string): void;
 }
 /** mxGraph 事件对象 */
 export interface MxEventObject {
@@ -71,6 +73,8 @@ export interface DrawioFile {
     getUi(): DrawioUi;
     setShadowPages(pages: unknown[]): void;
     patch(patches: unknown[]): void;
+    /** 仅赋值 this.data = xml，不触发 UI 重绘 */
+    setData(data: string): void;
 }
 /** draw.io App（demo 中通过 iframe 访问） */
 export interface DrawioApp {

package/types/drawio.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"drawio.d.ts","sourceRoot":"","sources":["../../src/types/drawio.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"drawio.d.ts","sourceRoot":"","sources":["../../src/types/drawio.ts"],"names":[],"mappings":"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"}

package/y-mxgraph.cjs.js

@@ -1455,32 +1455,147 @@ function bindCollaborator(file, options) {
     cleanupAwareness == null ? void 0 : cleanupAwareness();
   };
 }
+const defaultApplyFileData = (file, xml) => {
+  file.ui.setFileData(xml);
+};
+function mergeFileIntoDoc(doc, fileXml, strategy) {
+  let parsed;
+  try {
+    parsed = parse$4(fileXml);
+  } catch (err) {
+    console.warn(
+      "[y-mxgraph] 合并失败，file XML 解析异常，回退到 replace：",
+      err
+    );
+    return false;
+  }
+  const mxfileObj = parsed == null ? void 0 : parsed.mxfile;
+  if (!mxfileObj || !Array.isArray(mxfileObj.diagram)) {
+    console.warn(
+      "[y-mxgraph] 合并失败，file XML 不是合法 mxfile，回退到 replace"
+    );
+    return false;
+  }
+  const mxfileMap = doc.getMap(key);
+  const diagramMap = mxfileMap.get(key$1);
+  const diagramOrder = mxfileMap.get(diagramOrderKey);
+  if (!diagramMap || !diagramOrder) {
+    console.warn("[y-mxgraph] 合并失败，doc 结构不完整，回退到 replace");
+    return false;
+  }
+  doc.transact(() => {
+    var _a;
+    for (const diagram of mxfileObj.diagram) {
+      const id = ((_a = diagram._attributes) == null ? void 0 : _a.id) || "";
+      if (!id)
+        continue;
+      const docHas = diagramMap.has(id);
+      if (docHas && strategy === "merge-remote") {
+        continue;
+      }
+      const yDiagram = parse$1(
+        diagram
+      );
+      diagramMap.set(id, yDiagram);
+      if (!docHas) {
+        diagramOrder.push([id]);
+      }
+    }
+  });
+  return true;
+}
+function reconcileInitialContent(doc, file, strategy, applyFileData) {
+  const mxfileMap = doc.getMap(key);
+  const docHasData = mxfileMap.size > 0;
+  const fileHasAnyData = !!file.data;
+  const fileHasDiagrams = fileHasAnyData && file.data.includes("<diagram");
+  if (strategy === "replace") {
+    if (docHasData) {
+      const xml2 = doc2xml(doc);
+      if (xml2 && xml2.includes("<diagram")) {
+        applyFileData(file, xml2);
+      } else if (!fileHasAnyData) {
+        applyFileData(file, Binding.generateFileTemplate("diagram-0"));
+      }
+    } else if (!fileHasAnyData) {
+      applyFileData(file, Binding.generateFileTemplate("diagram-0"));
+    }
+    return mxfileMap.size > 0;
+  }
+  if (!docHasData && !fileHasDiagrams) {
+    if (!fileHasAnyData) {
+      applyFileData(file, Binding.generateFileTemplate("diagram-0"));
+    }
+    return false;
+  }
+  if (!docHasData && fileHasDiagrams) {
+    try {
+      doc.transact(() => {
+        xml2doc(file.data, doc);
+      });
+      return true;
+    } catch (err) {
+      console.warn(
+        "[y-mxgraph] merge 模式下 xml2doc 失败，回退 replace：",
+        err
+      );
+      applyFileData(file, Binding.generateFileTemplate("diagram-0"));
+      return false;
+    }
+  }
+  if (docHasData && !fileHasDiagrams) {
+    const xml2 = doc2xml(doc);
+    if (xml2 && xml2.includes("<diagram")) {
+      applyFileData(file, xml2);
+    } else if (!fileHasAnyData) {
+      applyFileData(file, Binding.generateFileTemplate("diagram-0"));
+    }
+    return mxfileMap.size > 0;
+  }
+  const ok = mergeFileIntoDoc(doc, file.data, strategy);
+  if (!ok) {
+    const xml2 = doc2xml(doc);
+    if (xml2 && xml2.includes("<diagram"))
+      applyFileData(file, xml2);
+    return mxfileMap.size > 0;
+  }
+  const xml = doc2xml(doc);
+  if (xml && xml.includes("<diagram"))
+    applyFileData(file, xml);
+  return true;
+}
 class Binding {
   constructor(file, options) {
     this.suppressLocalApply = false;
     this.docInitialized = false;
-    const { doc, awareness, undoManager, mouseMoveThrottle, cursor } = options;
+    const {
+      doc,
+      awareness,
+      undoManager,
+      mouseMoveThrottle,
+      cursor,
+      initialContent = "replace",
+      applyFileData = defaultApplyFileData
+    } = options;
     this.doc = doc;
     const ui = file.getUi();
     const graph = ui.editor.graph;
     this.mxGraphModel = graph.model;
-    const mxfileMap = doc.getMap(key);
-    const docHasData = mxfileMap.size > 0;
-    this.docInitialized = docHasData;
-    file.setShadowPages(file.ui.clonePages(file.ui.pages));
-    if (docHasData) {
-      initDocSnapshot(doc, false);
-      const fullPatch = generatePatch([], doc);
-      if (Object.keys(fullPatch).length > 0) {
-        this.suppressLocalApply = true;
-        try {
-          file.patch([fullPatch]);
-        } finally {
-          this.suppressLocalApply = false;
-        }
+    this.suppressLocalApply = true;
+    try {
+      this.docInitialized = reconcileInitialContent(
+        doc,
+        file,
+        initialContent,
+        applyFileData
+      );
+      if (this.docInitialized) {
+        initDocSnapshot(doc, false);
       }
-      file.setShadowPages(file.ui.clonePages(file.ui.pages));
+    } finally {
+      this.suppressLocalApply = false;
     }
+    file.setShadowPages(file.ui.clonePages(file.ui.pages));
     this.mxListener = () => {
       if (this.suppressLocalApply)
         return;
@@ -1521,7 +1636,7 @@ class Binding {
         this.suppressLocalApply = false;
       }
     };
-    mxfileMap.observeDeep(this.docObserver);
+    doc.getMap(key).observeDeep(this.docObserver);
     if (awareness) {
       this.cleanupCollaborator = bindCollaborator(file, {
         awareness,