lexical 0.27.3-nightly.20250313.0 → 0.27.3-nightly.20250317.0

package/Lexical.dev.js

@@ -1538,7 +1538,7 @@ function $reconcileNode(key, parentDOM) {
     return dom;
   }
   // If the node key doesn't point to the same instance in both maps,
-  // it means it were cloned. If they're also dirty, we mark them as mutated.
+  // it was cloned. If it's also dirty, we mark it as mutated.
   if (prevNode !== nextNode && isDirty) {
     setMutatedNode(mutatedNodes, activeEditorNodes, activeMutationListeners, nextNode, 'updated');
   }
@@ -5336,6 +5336,22 @@ class NodeSelection {
     }
     return textContent;
   }
+
+  /**
+   * Remove all nodes in the NodeSelection. If there were any nodes,
+   * replace the selection with a new RangeSelection at the previous
+   * location of the first node.
+   */
+  deleteNodes() {
+    const nodes = this.getNodes();
+    if (($getSelection() || $getPreviousSelection()) === this && nodes[0]) {
+      const firstCaret = $getSiblingCaret(nodes[0], 'next');
+      $setSelectionFromCaretRange($getCaretRange(firstCaret, firstCaret));
+    }
+    for (const node of nodes) {
+      node.remove();
+    }
+  }
 }
 function $isRangeSelection(x) {
   return x instanceof RangeSelection;
@@ -7688,6 +7704,7 @@ function $applyAllTransforms(editorState, editor) {
     for (const currentUntransformedDirtyElement of untransformedDirtyElements) {
       const nodeKey = currentUntransformedDirtyElement[0];
       const intentionallyMarkedAsDirty = currentUntransformedDirtyElement[1];
+      dirtyElements.set(nodeKey, intentionallyMarkedAsDirty);
       if (nodeKey !== 'root' && !intentionallyMarkedAsDirty) {
         continue;
       }
@@ -7695,7 +7712,6 @@ function $applyAllTransforms(editorState, editor) {
       if (node !== undefined && $isNodeValidForTransform(node, compositionKey)) {
         $applyTransforms(editor, node, transformsCache);
       }
-      dirtyElements.set(nodeKey, intentionallyMarkedAsDirty);
     }
     untransformedDirtyLeaves = editor._dirtyLeaves;
     untransformedDirtyLeavesLength = untransformedDirtyLeaves.size;
@@ -7961,6 +7977,7 @@ function $commitPendingUpdates(editor, recoveryEditorState) {
     dirtyElements,
     dirtyLeaves,
     editorState: pendingEditorState,
+    mutatedNodes,
     normalizedNodes,
     prevEditorState: recoveryEditorState || currentEditorState,
     tags
@@ -7996,7 +8013,6 @@ function triggerListeners(type, editor, isCurrentlyEnqueuingUpdates, ...payload)
   try {
     const listeners = Array.from(editor._listeners[type]);
     for (let i = 0; i < listeners.length; i++) {
-      // @ts-ignore
       listeners[i].apply(null, payload);
     }
   } finally {
@@ -8258,6 +8274,9 @@ class ElementDOMSlot {
    * Return a new ElementDOMSlot with an updated root element
    */
   withElement(element) {
+    if (this.element === element) {
+      return this;
+    }
     return new ElementDOMSlot(element, this.before, this.after);
   }
   /**
@@ -9126,17 +9145,13 @@ class RootNode extends ElementNode {
   }
 
   // Mutate
-
-  append(...nodesToAppend) {
-    for (let i = 0; i < nodesToAppend.length; i++) {
-      const node = nodesToAppend[i];
-      if (!$isElementNode(node) && !$isDecoratorNode(node)) {
-        {
-          formatDevErrorMessage(`rootNode.append: Only element or decorator nodes can be appended to the root node`);
-        }
+  splice(start, deleteCount, nodesToInsert) {
+    for (const node of nodesToInsert) {
+      if (!($isElementNode(node) || $isDecoratorNode(node))) {
+        formatDevErrorMessage(`rootNode.splice: Only element or decorator nodes can be inserted to the root node`);
       }
     }
-    return super.append(...nodesToAppend);
+    return super.splice(start, deleteCount, nodesToInsert);
   }
   static importJSON(serializedNode) {
     // We don't create a root, and instead use the existing root.
@@ -9368,6 +9383,15 @@ function $isParagraphNode(node) {
 // eslint-disable-next-line @typescript-eslint/no-explicit-any
 
 const DEFAULT_SKIP_INITIALIZATION = false;
+
+/**
+ * The payload passed to an UpdateListener
+ */
+
+/**
+ * A listener that gets called after the editor is updated
+ */
+
 const COMMAND_PRIORITY_EDITOR = 0;
 const COMMAND_PRIORITY_LOW = 1;
 const COMMAND_PRIORITY_NORMAL = 2;
@@ -10223,7 +10247,7 @@ class LexicalEditor {
     };
   }
 }
-LexicalEditor.version = "0.27.3-nightly.20250313.0+dev.cjs";
+LexicalEditor.version = "0.27.3-nightly.20250317.0+dev.cjs";
 
 let keyCounter = 1;
 function resetRandomKey() {

package/Lexical.dev.mjs

@@ -1536,7 +1536,7 @@ function $reconcileNode(key, parentDOM) {
     return dom;
   }
   // If the node key doesn't point to the same instance in both maps,
-  // it means it were cloned. If they're also dirty, we mark them as mutated.
+  // it was cloned. If it's also dirty, we mark it as mutated.
   if (prevNode !== nextNode && isDirty) {
     setMutatedNode(mutatedNodes, activeEditorNodes, activeMutationListeners, nextNode, 'updated');
   }
@@ -5334,6 +5334,22 @@ class NodeSelection {
     }
     return textContent;
   }
+
+  /**
+   * Remove all nodes in the NodeSelection. If there were any nodes,
+   * replace the selection with a new RangeSelection at the previous
+   * location of the first node.
+   */
+  deleteNodes() {
+    const nodes = this.getNodes();
+    if (($getSelection() || $getPreviousSelection()) === this && nodes[0]) {
+      const firstCaret = $getSiblingCaret(nodes[0], 'next');
+      $setSelectionFromCaretRange($getCaretRange(firstCaret, firstCaret));
+    }
+    for (const node of nodes) {
+      node.remove();
+    }
+  }
 }
 function $isRangeSelection(x) {
   return x instanceof RangeSelection;
@@ -7686,6 +7702,7 @@ function $applyAllTransforms(editorState, editor) {
     for (const currentUntransformedDirtyElement of untransformedDirtyElements) {
       const nodeKey = currentUntransformedDirtyElement[0];
       const intentionallyMarkedAsDirty = currentUntransformedDirtyElement[1];
+      dirtyElements.set(nodeKey, intentionallyMarkedAsDirty);
       if (nodeKey !== 'root' && !intentionallyMarkedAsDirty) {
         continue;
       }
@@ -7693,7 +7710,6 @@ function $applyAllTransforms(editorState, editor) {
       if (node !== undefined && $isNodeValidForTransform(node, compositionKey)) {
         $applyTransforms(editor, node, transformsCache);
       }
-      dirtyElements.set(nodeKey, intentionallyMarkedAsDirty);
     }
     untransformedDirtyLeaves = editor._dirtyLeaves;
     untransformedDirtyLeavesLength = untransformedDirtyLeaves.size;
@@ -7959,6 +7975,7 @@ function $commitPendingUpdates(editor, recoveryEditorState) {
     dirtyElements,
     dirtyLeaves,
     editorState: pendingEditorState,
+    mutatedNodes,
     normalizedNodes,
     prevEditorState: recoveryEditorState || currentEditorState,
     tags
@@ -7994,7 +8011,6 @@ function triggerListeners(type, editor, isCurrentlyEnqueuingUpdates, ...payload)
   try {
     const listeners = Array.from(editor._listeners[type]);
     for (let i = 0; i < listeners.length; i++) {
-      // @ts-ignore
       listeners[i].apply(null, payload);
     }
   } finally {
@@ -8256,6 +8272,9 @@ class ElementDOMSlot {
    * Return a new ElementDOMSlot with an updated root element
    */
   withElement(element) {
+    if (this.element === element) {
+      return this;
+    }
     return new ElementDOMSlot(element, this.before, this.after);
   }
   /**
@@ -9124,17 +9143,13 @@ class RootNode extends ElementNode {
   }
 
   // Mutate
-
-  append(...nodesToAppend) {
-    for (let i = 0; i < nodesToAppend.length; i++) {
-      const node = nodesToAppend[i];
-      if (!$isElementNode(node) && !$isDecoratorNode(node)) {
-        {
-          formatDevErrorMessage(`rootNode.append: Only element or decorator nodes can be appended to the root node`);
-        }
+  splice(start, deleteCount, nodesToInsert) {
+    for (const node of nodesToInsert) {
+      if (!($isElementNode(node) || $isDecoratorNode(node))) {
+        formatDevErrorMessage(`rootNode.splice: Only element or decorator nodes can be inserted to the root node`);
       }
     }
-    return super.append(...nodesToAppend);
+    return super.splice(start, deleteCount, nodesToInsert);
   }
   static importJSON(serializedNode) {
     // We don't create a root, and instead use the existing root.
@@ -9366,6 +9381,15 @@ function $isParagraphNode(node) {
 // eslint-disable-next-line @typescript-eslint/no-explicit-any
 
 const DEFAULT_SKIP_INITIALIZATION = false;
+
+/**
+ * The payload passed to an UpdateListener
+ */
+
+/**
+ * A listener that gets called after the editor is updated
+ */
+
 const COMMAND_PRIORITY_EDITOR = 0;
 const COMMAND_PRIORITY_LOW = 1;
 const COMMAND_PRIORITY_NORMAL = 2;
@@ -10221,7 +10245,7 @@ class LexicalEditor {
     };
   }
 }
-LexicalEditor.version = "0.27.3-nightly.20250313.0+dev.esm";
+LexicalEditor.version = "0.27.3-nightly.20250317.0+dev.esm";
 
 let keyCounter = 1;
 function resetRandomKey() {

package/Lexical.js.flow

@@ -809,7 +809,7 @@ declare export class ElementNode extends LexicalNode {
     nodesToInsert: Array<LexicalNode>,
   ): this;
   exportJSON(): SerializedElementNode;
-  getDOMSlot(dom: HTMLElement): ElementDOMSlot;
+  getDOMSlot(dom: HTMLElement): ElementDOMSlot<HTMLElement>;
 }
 declare export function $isElementNode(
   node: ?LexicalNode,
@@ -818,14 +818,14 @@ declare export function $isElementNode(
 /**
  * ElementDOMSlot
  */
-declare export class ElementDOMSlot {
-  element: HTMLElement;
-  before: Node | null;
-  after: Node | null;
+declare export class ElementDOMSlot<+T: HTMLElement> {
+  +element: HTMLElement;
+  +before: Node | null;
+  +after: Node | null;
   constructor(element: HTMLElement, before?: Node | null | void, after?: Node | null | void): void;
-  withBefore(before: Node | null | void): ElementDOMSlot;
-  withAfter(after: Node | null | void): ElementDOMSlot;
-  withElement(element: HTMLElement): ElementDOMSlot;
+  withBefore(before: Node | null | void): ElementDOMSlot<T>;
+  withAfter(after: Node | null | void): ElementDOMSlot<T>;
+  withElement<ElementType: HTMLElement>(element: ElementType): ElementDOMSlot<ElementType>;
   insertChild(dom: Node): this;
   removeChild(dom: Node): this;
   replaceChild(dom: Node, prevDom: Node): this;