@lexical/yjs 0.44.1-nightly.20260519.0 → 0.45.1-dev.0

package/{RenderSnapshot.d.ts → dist/RenderSnapshot.d.ts}

@@ -1,10 +1,3 @@
-/**
- * Copyright (c) Meta Platforms, Inc. and affiliates.
- *
- * This source code is licensed under the MIT license found in the
- * LICENSE file in the root directory of this source tree.
- *
- */
 import { LexicalNode } from 'lexical';
 import { ID, Snapshot } from 'yjs';
 import { BindingV2 } from './Bindings';

package/dist/simpleDiffWithCursor.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ */
+export default function simpleDiffWithCursor(a: string, b: string, cursor: number): {
+    index: number;
+    insert: string;
+    remove: number;
+};

package/package.json

@@ -11,12 +11,13 @@
     "crdt"
   ],
   "license": "MIT",
-  "version": "0.44.1-nightly.20260519.0",
-  "main": "LexicalYjs.js",
-  "types": "index.d.ts",
+  "version": "0.45.1-dev.0",
+  "main": "./dist/LexicalYjs.js",
+  "types": "./dist/index.d.ts",
   "dependencies": {
-    "@lexical/selection": "0.44.1-nightly.20260519.0",
-    "lexical": "0.44.1-nightly.20260519.0"
+    "@lexical/selection": "0.45.1-dev.0",
+    "lexical": "0.45.1-dev.0",
+    "@lexical/internal": "0.45.1-dev.0"
   },
   "devDependencies": {
     "yjs": "^13.6.30"
@@ -29,23 +30,37 @@
     "url": "git+https://github.com/facebook/lexical.git",
     "directory": "packages/lexical-yjs"
   },
-  "module": "LexicalYjs.mjs",
+  "module": "./dist/LexicalYjs.mjs",
   "sideEffects": false,
   "exports": {
     ".": {
+      "source": "./src/index.ts",
       "import": {
-        "types": "./index.d.ts",
-        "development": "./LexicalYjs.dev.mjs",
-        "production": "./LexicalYjs.prod.mjs",
-        "node": "./LexicalYjs.node.mjs",
-        "default": "./LexicalYjs.mjs"
+        "types": "./dist/index.d.ts",
+        "development": "./dist/LexicalYjs.dev.mjs",
+        "production": "./dist/LexicalYjs.prod.mjs",
+        "node": "./dist/LexicalYjs.node.mjs",
+        "default": "./dist/LexicalYjs.mjs"
       },
       "require": {
-        "types": "./index.d.ts",
-        "development": "./LexicalYjs.dev.js",
-        "production": "./LexicalYjs.prod.js",
-        "default": "./LexicalYjs.js"
+        "types": "./dist/index.d.ts",
+        "development": "./dist/LexicalYjs.dev.js",
+        "production": "./dist/LexicalYjs.prod.js",
+        "default": "./dist/LexicalYjs.js"
       }
     }
-  }
+  },
+  "files": [
+    "dist",
+    "src",
+    "!src/__tests__",
+    "!src/__bench__",
+    "!src/__mocks__",
+    "!src/**/*.test.ts",
+    "!src/**/*.test.tsx",
+    "!src/**/*.bench.ts",
+    "!src/**/*.bench.tsx",
+    "README.md",
+    "LICENSE"
+  ]
 }

package/src/Bindings.ts

@@ -0,0 +1,135 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ */
+
+import type {CollabDecoratorNode} from './CollabDecoratorNode';
+import type {CollabElementNode} from './CollabElementNode';
+import type {CollabLineBreakNode} from './CollabLineBreakNode';
+import type {CollabTextNode} from './CollabTextNode';
+import type {Cursor} from './SyncCursors';
+import type {LexicalEditor, NodeKey} from 'lexical';
+
+import invariant from '@lexical/internal/invariant';
+import {Klass, LexicalNode} from 'lexical';
+import {Doc, XmlElement, XmlText} from 'yjs';
+
+import {Provider} from '.';
+import {$createCollabElementNode} from './CollabElementNode';
+import {CollabV2Mapping} from './CollabV2Mapping';
+import {initializeNodeProperties} from './Utils';
+
+export type ClientID = number;
+export interface BaseBinding {
+  clientID: number;
+  cursors: Map<ClientID, Cursor>;
+  cursorsContainer: null | HTMLElement;
+  doc: Doc;
+  docMap: Map<string, Doc>;
+  editor: LexicalEditor;
+  id: string;
+  nodeProperties: Map<string, {[property: string]: unknown}>; // node type to property to default value
+  excludedProperties: ExcludedProperties;
+}
+
+export interface Binding extends BaseBinding {
+  collabNodeMap: Map<
+    NodeKey,
+    | CollabElementNode
+    | CollabTextNode
+    | CollabDecoratorNode
+    | CollabLineBreakNode
+  >;
+  root: CollabElementNode;
+}
+
+export interface BindingV2 extends BaseBinding {
+  mapping: CollabV2Mapping;
+  root: XmlElement;
+}
+
+export type AnyBinding = Binding | BindingV2;
+
+export type ExcludedProperties = Map<Klass<LexicalNode>, Set<string>>;
+
+function createBaseBinding(
+  editor: LexicalEditor,
+  id: string,
+  doc: Doc | null | undefined,
+  docMap: Map<string, Doc>,
+  excludedProperties?: ExcludedProperties,
+): BaseBinding {
+  invariant(
+    doc !== undefined && doc !== null,
+    'createBinding: doc is null or undefined',
+  );
+  const binding = {
+    clientID: doc.clientID,
+    cursors: new Map(),
+    cursorsContainer: null,
+    doc,
+    docMap,
+    editor,
+    excludedProperties: excludedProperties || new Map(),
+    id,
+    nodeProperties: new Map(),
+  };
+  initializeNodeProperties(binding);
+  return binding;
+}
+
+export function createBinding(
+  editor: LexicalEditor,
+  provider: Provider,
+  id: string,
+  doc: Doc | null | undefined,
+  docMap: Map<string, Doc>,
+  excludedProperties?: ExcludedProperties,
+): Binding {
+  invariant(
+    doc !== undefined && doc !== null,
+    'createBinding: doc is null or undefined',
+  );
+  const rootXmlText = doc.get('root', XmlText) as XmlText;
+  const root: CollabElementNode = $createCollabElementNode(
+    rootXmlText,
+    null,
+    'root',
+  );
+  root._key = 'root';
+  return {
+    ...createBaseBinding(editor, id, doc, docMap, excludedProperties),
+    collabNodeMap: new Map(),
+    root,
+  };
+}
+
+export function createBindingV2__EXPERIMENTAL(
+  editor: LexicalEditor,
+  id: string,
+  doc: Doc | null | undefined,
+  docMap: Map<string, Doc>,
+  options: {excludedProperties?: ExcludedProperties; rootName?: string} = {},
+): BindingV2 {
+  invariant(
+    doc !== undefined && doc !== null,
+    'createBinding: doc is null or undefined',
+  );
+  const {excludedProperties, rootName = 'root-v2'} = options;
+  return {
+    ...createBaseBinding(editor, id, doc, docMap, excludedProperties),
+    mapping: new CollabV2Mapping(),
+    root: doc.get(rootName, XmlElement) as XmlElement,
+  };
+}
+
+export function isBindingV1(binding: BaseBinding): binding is Binding {
+  return Object.prototype.hasOwnProperty.call(binding, 'collabNodeMap');
+}
+
+export function isBindingV2(binding: BaseBinding): binding is BindingV2 {
+  return Object.prototype.hasOwnProperty.call(binding, 'mapping');
+}

package/src/CollabDecoratorNode.ts

@@ -0,0 +1,112 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ */
+
+import type {Binding} from '.';
+import type {CollabElementNode} from './CollabElementNode';
+import type {DecoratorNode, NodeKey, NodeMap} from 'lexical';
+import type {XmlElement} from 'yjs';
+
+import invariant from '@lexical/internal/invariant';
+import {$getNodeByKey, $isDecoratorNode} from 'lexical';
+
+import {$syncPropertiesFromYjs, syncPropertiesFromLexical} from './Utils';
+
+export class CollabDecoratorNode {
+  _xmlElem: XmlElement;
+  _key: NodeKey;
+  _parent: CollabElementNode;
+  _type: string;
+
+  constructor(xmlElem: XmlElement, parent: CollabElementNode, type: string) {
+    this._key = '';
+    this._xmlElem = xmlElem;
+    this._parent = parent;
+    this._type = type;
+  }
+
+  getPrevNode(nodeMap: null | NodeMap): null | DecoratorNode<unknown> {
+    if (nodeMap === null) {
+      return null;
+    }
+
+    const node = nodeMap.get(this._key);
+    return $isDecoratorNode(node) ? node : null;
+  }
+
+  getNode(): null | DecoratorNode<unknown> {
+    const node = $getNodeByKey(this._key);
+    return $isDecoratorNode(node) ? node : null;
+  }
+
+  getSharedType(): XmlElement {
+    return this._xmlElem;
+  }
+
+  getType(): string {
+    return this._type;
+  }
+
+  getKey(): NodeKey {
+    return this._key;
+  }
+
+  getSize(): number {
+    return 1;
+  }
+
+  getOffset(): number {
+    const collabElementNode = this._parent;
+    return collabElementNode.getChildOffset(this);
+  }
+
+  syncPropertiesFromLexical(
+    binding: Binding,
+    nextLexicalNode: DecoratorNode<unknown>,
+    prevNodeMap: null | NodeMap,
+  ): void {
+    const prevLexicalNode = this.getPrevNode(prevNodeMap);
+    const xmlElem = this._xmlElem;
+
+    syncPropertiesFromLexical(
+      binding,
+      xmlElem,
+      prevLexicalNode,
+      nextLexicalNode,
+    );
+  }
+
+  syncPropertiesFromYjs(
+    binding: Binding,
+    keysChanged: null | Set<string>,
+  ): void {
+    const lexicalNode = this.getNode();
+    invariant(
+      lexicalNode !== null,
+      'syncPropertiesFromYjs: could not find decorator node',
+    );
+    const xmlElem = this._xmlElem;
+    $syncPropertiesFromYjs(binding, xmlElem, lexicalNode, keysChanged);
+  }
+
+  destroy(binding: Binding): void {
+    const collabNodeMap = binding.collabNodeMap;
+    if (collabNodeMap.get(this._key) === this) {
+      collabNodeMap.delete(this._key);
+    }
+  }
+}
+
+export function $createCollabDecoratorNode(
+  xmlElem: XmlElement,
+  parent: CollabElementNode,
+  type: string,
+): CollabDecoratorNode {
+  const collabNode = new CollabDecoratorNode(xmlElem, parent, type);
+  xmlElem._collabNode = collabNode;
+  return collabNode;
+}