y-mxgraph 0.1.1

package/README.md

@@ -0,0 +1,69 @@
+# y-mxgraph
+
+[中文文档](./README.zh-CN.md)
+
+Yjs binding for draw.io (mxGraph) documents, enabling real-time collaborative editing.
+
+## Features
+
+- **Bidirectional binding** between draw.io files and Y.Doc
+- **Real-time collaboration** via y-webrtc, y-websocket, or any Yjs provider
+- **Undo/Redo support** with Y.UndoManager
+- **Collaborative cursors** via y-protocols Awareness
+- **Full TypeScript** support
+
+## Installation
+
+```bash
+pnpm add y-mxgraph yjs y-protocols
+```
+
+`yjs` and `y-protocols` are peer dependencies.
+
+## Quick Start
+
+```ts
+import * as Y from 'yjs';
+import { Binding, LOCAL_ORIGIN } from 'y-mxgraph';
+
+const doc = new Y.Doc();
+
+App.main((app) => {
+  const binding = new Binding(app.currentFile, { doc });
+
+  window.addEventListener('beforeunload', () => binding.destroy());
+});
+```
+
+## Documentation
+
+- [Getting Started](https://mizuka-wu.github.io/y-mxgraph/en/guide/getting-started)
+- [API Reference](https://mizuka-wu.github.io/y-mxgraph/en/api/)
+- [Architecture](https://mizuka-wu.github.io/y-mxgraph/en/guide/architecture)
+
+## Development
+
+```bash
+# Clone
+git clone https://github.com/mizuka-wu/y-mxgraph.git
+cd y-mxgraph
+
+# Install
+pnpm install
+
+# Build
+pnpm --filter y-mxgraph build
+
+# Test
+pnpm --filter y-mxgraph test
+
+# Demo
+pnpm --filter @y-mxgraph/demo dev
+
+# Docs
+pnpm --filter @y-mxgraph/docs dev
+```
+
+## License
+
+MIT

package/README.zh-CN.md

@@ -0,0 +1,69 @@
+# y-mxgraph
+
+[English](./README.md)
+
+Yjs 与 draw.io (mxGraph) 文档的双向绑定库，让 draw.io 支持实时多人协同编辑。
+
+## 特性
+
+- **双向绑定** draw.io 文件与 Y.Doc
+- **实时协作** 支持 y-webrtc、y-websocket 及任意 Yjs Provider
+- **撤销/重做** 集成 Y.UndoManager
+- **协同光标** 基于 y-protocols Awareness 渲染远端光标与选区
+- **完整 TypeScript** 类型支持
+
+## 安装
+
+```bash
+pnpm add y-mxgraph yjs y-protocols
+```
+
+`yjs` 和 `y-protocols` 为 peer dependencies，需单独安装。
+
+## 快速开始
+
+```ts
+import * as Y from 'yjs';
+import { Binding, LOCAL_ORIGIN } from 'y-mxgraph';
+
+const doc = new Y.Doc();
+
+App.main((app) => {
+  const binding = new Binding(app.currentFile, { doc });
+
+  window.addEventListener('beforeunload', () => binding.destroy());
+});
+```
+
+## 文档
+
+- [快速开始](https://mizuka-wu.github.io/y-mxgraph/guide/getting-started)
+- [API 参考](https://mizuka-wu.github.io/y-mxgraph/api/)
+- [实现原理](https://mizuka-wu.github.io/y-mxgraph/guide/architecture)
+
+## 本地开发
+
+```bash
+# 克隆仓库
+git clone https://github.com/mizuka-wu/y-mxgraph.git
+cd y-mxgraph
+
+# 安装依赖
+pnpm install
+
+# 构建
+pnpm --filter y-mxgraph build
+
+# 测试
+pnpm --filter y-mxgraph test
+
+# 启动 Demo
+pnpm --filter @y-mxgraph/demo dev
+
+# 启动文档
+pnpm --filter @y-mxgraph/docs dev
+```
+
+## License
+
+MIT

package/binding/collaborator/cursor.d.ts

@@ -0,0 +1,19 @@
+import { type Awareness } from "y-protocols/awareness";
+import { type RemoteCursor } from "./index";
+import type { DrawioFile, MxGraph } from "../../types/drawio";
+export declare const CacheKey = "__remoteCursor__";
+export declare function bindCursor(file: DrawioFile, options: {
+    awareness: Awareness;
+    graph?: MxGraph;
+    mouseMoveThrottle?: number;
+}): () => void;
+export declare function renderRemoteCursors(ui: {
+    editor: {
+        graph: MxGraph;
+    };
+    currentPage?: {
+        getId(): string;
+    } | null;
+    diagramContainer: HTMLElement;
+}, remotes: Map<number, RemoteCursor>): void;
+//# sourceMappingURL=cursor.d.ts.map

package/binding/collaborator/cursor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor.d.ts","sourceRoot":"","sources":["../../../src/binding/collaborator/cursor.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAE9D,eAAO,MAAM,QAAQ,qBAAqB,CAAC;AAgC3C,wBAAgB,UAAU,CACxB,IAAI,EAAE,UAAU,EAChB,OAAO,EAAE;IACP,SAAS,EAAE,SAAS,CAAC;IACrB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B,cAwDF;AAED,wBAAgB,mBAAmB,CACjC,EAAE,EAAE;IAAE,MAAM,EAAE;QAAE,KAAK,EAAE,OAAO,CAAA;KAAE,CAAC;IAAC,WAAW,CAAC,EAAE;QAAE,KAAK,IAAI,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAAC,gBAAgB,EAAE,WAAW,CAAA;CAAE,EAC3G,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,QAgGnC"}

package/binding/collaborator/index.d.ts

@@ -0,0 +1,32 @@
+import { type Awareness } from "y-protocols/awareness";
+import type { DrawioFile, MxGraph } from "../../types/drawio";
+export declare const DEFAULT_USER_NAME_KEY = "user.name";
+export declare const DEFAULT_USER_COLOR_KEY = "user.color";
+type CursorState = {
+    x: number;
+    y: number;
+    pageId?: string | null;
+    hide?: boolean;
+};
+type SelectionState = {
+    ids: string[];
+    pageId?: string | null;
+};
+export type RemoteCursor = {
+    clientId: number;
+    cursorState: CursorState | null;
+    selectionState: SelectionState | null;
+    userColor: string;
+    userName: string;
+};
+export declare function bindCollaborator(file: DrawioFile, options: {
+    awareness: Awareness;
+    graph?: MxGraph;
+    cursor?: boolean | {
+        userNameKey?: string;
+        userColorKey?: string;
+    };
+    mouseMoveThrottle?: number;
+}): () => void;
+export {};
+//# sourceMappingURL=index.d.ts.map

package/binding/collaborator/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/binding/collaborator/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAQvD,OAAO,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAE9D,eAAO,MAAM,qBAAqB,cAAc,CAAC;AACjD,eAAO,MAAM,sBAAsB,eAAe,CAAC;AAEnD,KAAK,WAAW,GAAG;IACjB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB,CAAC;AAEF,KAAK,cAAc,GAAG;IACpB,GAAG,EAAE,MAAM,EAAE,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,WAAW,GAAG,IAAI,CAAC;IAChC,cAAc,EAAE,cAAc,GAAG,IAAI,CAAC;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,UAAU,EAChB,OAAO,EAAE;IACP,SAAS,EAAE,SAAS,CAAC;IACrB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,GAAG;QAAE,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACnE,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B,cA0FF"}

package/binding/collaborator/selection.d.ts

@@ -0,0 +1,18 @@
+import { type Awareness } from "y-protocols/awareness";
+import { type RemoteCursor } from "./index";
+import type { DrawioFile, MxGraph } from "../../types/drawio";
+export declare const SELECTION_OPACITY = 70;
+export declare const CacheKey = "__remoteSelection__";
+export declare function bindSelection(file: DrawioFile, options: {
+    awareness: Awareness;
+    graph?: MxGraph;
+}): () => void;
+export declare function renderRemoteSelections(ui: {
+    editor: {
+        graph: MxGraph;
+    };
+    currentPage?: {
+        getId(): string;
+    } | null;
+}, remotes: Map<number, RemoteCursor>): void;
+//# sourceMappingURL=selection.d.ts.map

package/binding/collaborator/selection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selection.d.ts","sourceRoot":"","sources":["../../../src/binding/collaborator/selection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAEvD,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAE9D,eAAO,MAAM,iBAAiB,KAAK,CAAC;AACpC,eAAO,MAAM,QAAQ,wBAAwB,CAAC;AAE9C,wBAAgB,aAAa,CAC3B,IAAI,EAAE,UAAU,EAChB,OAAO,EAAE;IAAE,SAAS,EAAE,SAAS,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,cAuBnD;AAED,wBAAgB,sBAAsB,CACpC,EAAE,EAAE;IAAE,MAAM,EAAE;QAAE,KAAK,EAAE,OAAO,CAAA;KAAE,CAAC;IAAC,WAAW,CAAC,EAAE;QAAE,KAAK,IAAI,MAAM,CAAA;KAAE,GAAG,IAAI,CAAA;CAAE,EAC5E,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,QAyFnC"}

package/binding/index.d.ts

@@ -0,0 +1,44 @@
+import * as Y from "yjs";
+import { type Awareness } from "y-protocols/awareness";
+import type { DrawioFile } from "../types/drawio";
+export interface BindDrawioFileOptions {
+    doc: Y.Doc;
+    awareness?: Awareness;
+    undoManager?: Y.UndoManager;
+    mouseMoveThrottle?: number;
+    cursor?: boolean | {
+        userNameKey?: string;
+        userColorKey?: string;
+    };
+}
+/**
+ * Y-MXGraph 绑定类，管理 draw.io 文件与 Y.Doc 的双向同步
+ */
+export declare class Binding {
+    /** Y.Doc 实例，用于协同数据存储 */
+    readonly doc: Y.Doc;
+    /** mxGraph 的数据模型，用于监听本地变更 */
+    private mxGraphModel;
+    /** 本地变更抑制标志，防止循环同步 */
+    private suppressLocalApply;
+    /** mxGraph change 事件监听器 */
+    private mxListener;
+    /** Yjs 文档深度变更监听器 */
+    private docObserver;
+    /** 协作功能清理函数（awareness 光标/选区） */
+    private cleanupCollaborator?;
+    /** UndoManager 绑定清理函数 */
+    private cleanupUndoManager?;
+    constructor(file: DrawioFile, options: BindDrawioFileOptions);
+    /**
+     * 销毁绑定，解除所有监听器
+     * @param deep - 是否深度清理（包括 awareness/undoManager），默认 false
+     */
+    destroy(deep?: boolean): void;
+    /**
+     * 静态工厂方法，创建 Binding 实例
+     * 与 `new Binding()` 等价
+     */
+    static create(file: DrawioFile, options: BindDrawioFileOptions): Binding;
+}
+//# sourceMappingURL=index.d.ts.map

package/binding/index.d.ts.map

@@ -0,0 +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;;GAEG;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,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;IAkF5D;;;OAGG;IACH,OAAO,CAAC,IAAI,UAAQ,GAAG,IAAI;IAS3B;;;OAGG;IACH,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,qBAAqB,GAAG,OAAO;CAGzE"}

package/binding/patch.d.ts

@@ -0,0 +1,35 @@
+import { type YDiagram } from "../models/diagram";
+import { type YMxFile } from "../models/mxfile";
+import * as Y from "yjs";
+declare const DIFF_INSERT = "i";
+declare const DIFF_REMOVE = "r";
+declare const DIFF_UPDATE = "u";
+export interface DiagramInsert {
+    data: string;
+    id: string;
+    previous: string;
+}
+export interface FilePatch {
+    [DIFF_REMOVE]?: string[];
+    [DIFF_INSERT]?: DiagramInsert[];
+    [DIFF_UPDATE]?: {
+        [key: string]: {
+            name?: string;
+            previous?: string;
+            cells?: {
+                [DIFF_REMOVE]?: string[];
+                [DIFF_INSERT]?: Record<string, string>[];
+                [DIFF_UPDATE]?: {
+                    [key: string]: Record<string, string>;
+                };
+            };
+        };
+    };
+}
+export declare function applyFilePatch(doc: Y.Doc, patch: FilePatch, options?: {
+    origin?: unknown;
+}): void;
+export declare function initDocSnapshot(doc: Y.Doc, resetSnapshot?: boolean): void;
+export declare function generatePatch(events: Y.YEvent<Y.XmlElement | Y.Array<string> | Y.Map<Y.XmlElement> | YMxFile | YDiagram>[], explicitDoc?: Y.Doc): FilePatch;
+export {};
+//# sourceMappingURL=patch.d.ts.map

package/binding/patch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"patch.d.ts","sourceRoot":"","sources":["../../src/binding/patch.ts"],"names":[],"mappings":"AACA,OAAO,EAIL,KAAK,QAAQ,EACd,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAEL,KAAK,OAAO,EAEb,MAAM,kBAAkB,CAAC;AAO1B,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAEzB,QAAA,MAAM,WAAW,MAAM,CAAC;AACxB,QAAA,MAAM,WAAW,MAAM,CAAC;AACxB,QAAA,MAAM,WAAW,MAAM,CAAC;AAgDxB,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,SAAS;IACxB,CAAC,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,CAAC,WAAW,CAAC,CAAC,EAAE,aAAa,EAAE,CAAC;IAChC,CAAC,WAAW,CAAC,CAAC,EAAE;QACd,CAAC,GAAG,EAAE,MAAM,GAAG;YACb,IAAI,CAAC,EAAE,MAAM,CAAC;YACd,QAAQ,CAAC,EAAE,MAAM,CAAC;YAClB,KAAK,CAAC,EAAE;gBACN,CAAC,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC;gBACzB,CAAC,WAAW,CAAC,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC;gBACzC,CAAC,WAAW,CAAC,CAAC,EAAE;oBACd,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;iBACvC,CAAC;aACH,CAAC;SACH,CAAC;KACH,CAAC;CACH;AAED,wBAAgB,cAAc,CAC5B,GAAG,EAAE,CAAC,CAAC,GAAG,EACV,KAAK,EAAE,SAAS,EAChB,OAAO,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,QAqR/B;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,aAAa,UAAQ,QAsDhE;AAED,wBAAgB,aAAa,CAC3B,MAAM,EAAE,CAAC,CAAC,MAAM,CACd,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,OAAO,GAAG,QAAQ,CAC1E,EAAE,EACH,WAAW,CAAC,EAAE,CAAC,CAAC,GAAG,GAClB,SAAS,CAgSX"}

package/binding/undoManager.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 绑定 Y.UndoManager 到 draw.io 的 editor.undoManager，提供 mxUndoManager 兼容层。
+ * 仅在外部传入 undoManager 时调用。
+ */
+import * as Y from "yjs";
+import type { DrawioFile } from "../types/drawio";
+export declare function bindUndoManager(doc: Y.Doc, file: DrawioFile, yUndo: Y.UndoManager): () => void;
+//# sourceMappingURL=undoManager.d.ts.map

package/binding/undoManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"undoManager.d.ts","sourceRoot":"","sources":["../../src/binding/undoManager.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAEzB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAalD,wBAAgB,eAAe,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC,WAAW,cAqLjF"}

package/helper/awarenessStateValue.d.ts

@@ -0,0 +1,4 @@
+import { type Awareness } from "y-protocols/awareness";
+export declare function getAwarenessStateValue<T>(awareness: Awareness, key: string, clientId?: string | number): T | null;
+export declare function setAwarenessStateValue(awareness: Awareness, key: string, value: unknown, clientId?: string | number): boolean;
+//# sourceMappingURL=awarenessStateValue.d.ts.map

package/helper/awarenessStateValue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"awarenessStateValue.d.ts","sourceRoot":"","sources":["../../src/helper/awarenessStateValue.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAEvD,wBAAgB,sBAAsB,CAAC,CAAC,EACtC,SAAS,EAAE,SAAS,EACpB,GAAG,EAAE,MAAM,EACX,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,GACzB,CAAC,GAAG,IAAI,CAOV;AAcD,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,SAAS,EACpB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,OAAO,EACd,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,GACzB,OAAO,CAWT"}

package/helper/cursor.d.ts

@@ -0,0 +1,2 @@
+export declare function createCursorImage(color: string): string;
+//# sourceMappingURL=cursor.d.ts.map

package/helper/cursor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor.d.ts","sourceRoot":"","sources":["../../src/helper/cursor.ts"],"names":[],"mappings":"AAAA,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,UA2B9C"}

package/helper/getId.d.ts

@@ -0,0 +1,4 @@
+export declare function getId(item: {
+    id?: string | number;
+}): string | number | null;
+//# sourceMappingURL=getId.d.ts.map

package/helper/getId.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getId.d.ts","sourceRoot":"","sources":["../../src/helper/getId.ts"],"names":[],"mappings":"AAAA,wBAAgB,KAAK,CAAC,IAAI,EAAE;IAAE,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,0BAGnD"}

package/helper/origin.d.ts

@@ -0,0 +1,7 @@
+/**
+ * 本地修改事务的 origin 标记，供 UndoManager.trackedOrigins 使用。
+ * 对外导出，外部创建 Y.UndoManager 时可将其加入 trackedOrigins，
+ * 以确保只追踪 binding 内部产生的本地变更。
+ */
+export declare const LOCAL_ORIGIN: object;
+//# sourceMappingURL=origin.d.ts.map

package/helper/origin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"origin.d.ts","sourceRoot":"","sources":["../../src/helper/origin.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,eAAO,MAAM,YAAY,EAAE,MAAW,CAAC"}

package/helper/random.d.ts

@@ -0,0 +1,4 @@
+export declare function generateColor(seed?: string | number): string;
+export declare function generateRandomName(): string;
+export declare function generateRandomId(): string;
+//# sourceMappingURL=random.d.ts.map

package/helper/random.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"random.d.ts","sourceRoot":"","sources":["../../src/helper/random.ts"],"names":[],"mappings":"AAAA,wBAAgB,aAAa,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,UAMnD;AAED,wBAAgB,kBAAkB,IAAI,MAAM,CAmB3C;AAED,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC"}

package/helper/xml.d.ts

@@ -0,0 +1,4 @@
+import { type ElementCompact } from "xml-js";
+export declare function parse(xml: string): Record<string, unknown>;
+export declare function serializer(obj: ElementCompact, spaces?: number): string;
+//# sourceMappingURL=xml.d.ts.map

package/helper/xml.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xml.d.ts","sourceRoot":"","sources":["../../src/helper/xml.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,cAAc,EAAE,MAAM,QAAQ,CAAC;AAuC7D,wBAAgB,KAAK,CAAC,GAAG,EAAE,MAAM,2BAIhC;AAED,wBAAgB,UAAU,CAAC,GAAG,EAAE,cAAc,EAAE,MAAM,SAAI,UAKzD"}

package/index.d.ts

@@ -0,0 +1,6 @@
+export { Binding } from "./binding";
+export type { BindDrawioFileOptions } 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";
+//# sourceMappingURL=index.d.ts.map

package/index.d.ts.map

@@ -0,0 +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"}

package/models/diagram.d.ts

@@ -0,0 +1,22 @@
+import * as Y from "yjs";
+import { type MxGraphModel } from "./mxGraphModel";
+import type { ElementCompact } from "xml-js";
+export declare const key = "diagram";
+export interface Diagram extends ElementCompact {
+    mxGraphModel: MxGraphModel;
+}
+export type YDiagram = Y.Map<unknown>;
+export declare function parse(object: Diagram): YDiagram;
+export declare function serialize(yDiagram: YDiagram): {
+    _attributes: {
+        name: string;
+        id: string;
+    };
+    mxGraphModel: {
+        _attributes: {};
+        root: {
+            mxCell: Record<string, unknown>[];
+        };
+    } | undefined;
+};
+//# sourceMappingURL=diagram.d.ts.map

package/models/diagram.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagram.d.ts","sourceRoot":"","sources":["../../src/models/diagram.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AACzB,OAAO,EAIL,KAAK,YAAY,EAElB,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAC;AAE7C,eAAO,MAAM,GAAG,YAAY,CAAC;AAE7B,MAAM,WAAW,OAAQ,SAAQ,cAAc;IAC7C,YAAY,EAAE,YAAY,CAAC;CAC5B;AAED,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;AAEtC,wBAAgB,KAAK,CAAC,MAAM,EAAE,OAAO,GAAG,QAAQ,CAS/C;AAED,wBAAgB,SAAS,CAAC,QAAQ,EAAE,QAAQ;;cAOG,MAAM;YACV,MAAM;;;;;;;;EAMhD"}

package/models/mxCell.d.ts

@@ -0,0 +1,11 @@
+import * as Y from "yjs";
+import type { ElementCompact } from "xml-js";
+export declare const key = "mxCell";
+declare const mxGeometryKey = "mxGeometry";
+export interface MxCellModel extends ElementCompact {
+    [mxGeometryKey]?: ElementCompact;
+}
+export declare function parse(object: MxCellModel): Y.XmlElement;
+export declare function serialize(xmlElement: Y.XmlElement): Record<string, unknown>;
+export {};
+//# sourceMappingURL=mxCell.d.ts.map

package/models/mxCell.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mxCell.d.ts","sourceRoot":"","sources":["../../src/models/mxCell.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAEzB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAC;AAE7C,eAAO,MAAM,GAAG,WAAW,CAAC;AAE5B,QAAA,MAAM,aAAa,eAAe,CAAC;AAGnC,MAAM,WAAW,WAAY,SAAQ,cAAc;IACjD,CAAC,aAAa,CAAC,CAAC,EAAE,cAAc,CAAC;CAClC;AAED,wBAAgB,KAAK,CAAC,MAAM,EAAE,WAAW,GAAG,CAAC,CAAC,UAAU,CAoBvD;AAED,wBAAgB,SAAS,CAAC,UAAU,EAAE,CAAC,CAAC,UAAU,2BA8BjD"}

package/models/mxGraphModel.d.ts

@@ -0,0 +1,19 @@
+import * as Y from "yjs";
+import { type MxCellModel } from "./mxCell";
+import type { ElementCompact } from "xml-js";
+export declare const key = "mxGraphModel";
+export declare const mxCellOrderKey: string;
+export interface MxGraphModel extends ElementCompact {
+    root: {
+        mxCell: MxCellModel[];
+    };
+}
+export type YMxGraphModel = Y.Map<unknown>;
+export declare function parse(object: MxGraphModel, doc?: Y.Doc): YMxGraphModel;
+export declare function serialize(map: YMxGraphModel): {
+    _attributes: {};
+    root: {
+        mxCell: Record<string, unknown>[];
+    };
+};
+//# sourceMappingURL=mxGraphModel.d.ts.map

package/models/mxGraphModel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mxGraphModel.d.ts","sourceRoot":"","sources":["../../src/models/mxGraphModel.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAEzB,OAAO,EAIL,KAAK,WAAW,EACjB,MAAM,UAAU,CAAC;AAClB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAC;AAE7C,eAAO,MAAM,GAAG,iBAAiB,CAAC;AAClC,eAAO,MAAM,cAAc,QAAsB,CAAC;AAElD,MAAM,WAAW,YAAa,SAAQ,cAAc;IAClD,IAAI,EAAE;QACJ,MAAM,EAAE,WAAW,EAAE,CAAC;KACvB,CAAC;CACH;AAED,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;AAE3C,wBAAgB,KAAK,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,GAsB5B,aAAa,CACvC;AAED,wBAAgB,SAAS,CAAC,GAAG,EAAE,aAAa;;;;;EAW3C"}

package/models/mxfile.d.ts

@@ -0,0 +1,12 @@
+import * as Y from "yjs";
+import type { Diagram } from "./diagram";
+import type { ElementCompact } from "xml-js";
+export declare const key = "mxfile";
+export declare const diagramOrderKey: string;
+export type YMxFile = Y.Map<unknown>;
+export interface MxFile extends ElementCompact {
+    diagram: Diagram[];
+}
+export declare function parse(object: MxFile, doc: Y.Doc): Y.Map<unknown>;
+export declare function serializer(yMxFile: YMxFile): ElementCompact;
+//# sourceMappingURL=mxfile.d.ts.map

package/models/mxfile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mxfile.d.ts","sourceRoot":"","sources":["../../src/models/mxfile.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAMzB,OAAO,KAAK,EAAE,OAAO,EAAY,MAAM,WAAW,CAAC;AACnD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAC;AAE7C,eAAO,MAAM,GAAG,WAAW,CAAC;AAC5B,eAAO,MAAM,eAAe,QAAuB,CAAC;AAEpD,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;AAErC,MAAM,WAAW,MAAO,SAAQ,cAAc;IAC5C,OAAO,EAAE,OAAO,EAAE,CAAC;CACpB;AAED,wBAAgB,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,kBAkB/C;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,cAAc,CAgB3D"}

package/package.json

@@ -0,0 +1,23 @@
+{
+  "name": "y-mxgraph",
+  "version": "0.1.1",
+  "description": "Yjs binding for draw.io (mxGraph) documents",
+  "type": "module",
+  "main": "./y-mxgraph.cjs.js",
+  "module": "./y-mxgraph.es.js",
+  "browser": "./y-mxgraph.umd.js",
+  "types": "./index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./y-mxgraph.es.js",
+      "require": "./y-mxgraph.cjs.js",
+      "browser": "./y-mxgraph.umd.js",
+      "types": "./index.d.ts"
+    }
+  },
+  "peerDependencies": {
+    "y-protocols": "^1.0.0",
+    "yjs": "^13.6.0"
+  },
+  "license": "MIT"
+}

package/transformer/index.d.ts

@@ -0,0 +1,4 @@
+import * as Y from "yjs";
+export declare function xml2doc(xml: string, doc: Y.Doc): Y.Doc;
+export declare function doc2xml(doc: Y.Doc, spaces?: number): string;
+//# sourceMappingURL=index.d.ts.map

package/transformer/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/transformer/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAezB,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,CAkBtD;AAED,wBAAgB,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,MAAM,SAAI,GAAG,MAAM,CAsBtD"}

package/types/drawio.d.ts

@@ -0,0 +1,80 @@
+/**
+ * draw.io / mxGraph 核心类型声明
+ * 基于代码中实际使用到的 API 进行最小化类型定义
+ */
+/** mxGraph 页面 */
+export interface DrawioPage {
+    getId(): string;
+}
+/** mxGraph 视图 */
+export interface GraphView {
+    translate: {
+        x: number;
+        y: number;
+    };
+    scale: number;
+}
+/** mxGraph 模型 */
+export interface MxGraphModel {
+    addListener(event: string, fn: (...args: unknown[]) => void): void;
+    removeListener(event: string, fn: (...args: unknown[]) => void): void;
+    getCell(id: string): unknown | null;
+}
+/** mxGraph 选区模型 */
+export interface SelectionModel {
+    cells: Record<string, unknown>;
+    addListener(event: string, fn: (...args: unknown[]) => void): void;
+    removeListener(event: string, fn: (...args: unknown[]) => void): void;
+}
+/** mxGraph 实例 */
+export interface MxGraph {
+    model: MxGraphModel;
+    container: HTMLElement;
+    view: GraphView;
+    addMouseListener(listener: unknown): void;
+    removeMouseListener(listener: unknown): void;
+    getSelectionModel(): SelectionModel;
+    highlightCell(cell: unknown, color: string, timeout: number, opacity: number, width: number): {
+        destroy(): void;
+    };
+}
+/** draw.io 编辑器 */
+export interface DrawioEditor {
+    graph: MxGraph;
+    undoManager?: {
+        eventListeners?: unknown[];
+        undoListener?: (...args: unknown[]) => void;
+        [key: string]: unknown;
+    };
+    undoListener?: (...args: unknown[]) => void;
+}
+/** draw.io UI */
+export interface DrawioUi {
+    editor: DrawioEditor;
+    currentPage?: DrawioPage | null;
+    diagramContainer: HTMLElement;
+    pages: unknown[];
+    diffPages(oldPages: unknown[], newPages: unknown[]): unknown;
+    clonePages(pages: unknown[]): unknown[];
+}
+/** mxGraph 事件对象 */
+export interface MxEventObject {
+    name: string;
+    getName(): string;
+    getProperty(key: string): unknown;
+}
+/** draw.io 文件对象 */
+export interface DrawioFile {
+    data: string;
+    shadowPages: unknown[];
+    ui: DrawioUi;
+    getUi(): DrawioUi;
+    setShadowPages(pages: unknown[]): void;
+    patch(patches: unknown[]): void;
+}
+/** draw.io App（demo 中通过 iframe 访问） */
+export interface DrawioApp {
+    currentFile: DrawioFile | null;
+    editor: DrawioEditor;
+}
+//# sourceMappingURL=drawio.d.ts.map

package/types/drawio.d.ts.map

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