lexical 0.33.2-nightly.20250724.0 → 0.33.2-nightly.20250725.0

package/Lexical.dev.js

@@ -369,7 +369,11 @@ function flushMutations(editor, mutations, observer) {
         if (type === 'characterData') {
           // Text mutations are deferred and passed to mutation listeners to be
           // processed outside of the Lexical engine.
-          if (shouldFlushTextMutations && $isTextNode(targetNode) && isDOMTextNode(targetDOM) && shouldUpdateTextNodeFromMutation(selection, targetDOM, targetNode)) {
+          if (
+          // TODO there is an edge case here if a mutation happens too quickly
+          //      after text input, it may never be handled since we do not
+          //      track the ignored mutations in any way
+          shouldFlushTextMutations && $isTextNode(targetNode) && isDOMTextNode(targetDOM) && shouldUpdateTextNodeFromMutation(selection, targetDOM, targetNode)) {
             $handleTextMutation(targetDOM, targetNode, editor);
           }
         } else if (type === 'childList') {
@@ -7196,7 +7200,7 @@ function $internalResolveSelectionPoint(dom, offset, lastPoint, editor) {
     }
     resolvedNode = $getNodeFromDOM(childDOM);
     if ($isTextNode(resolvedNode)) {
-      resolvedOffset = getTextNodeOffset(resolvedNode, moveSelectionToEnd);
+      resolvedOffset = $getTextNodeOffset(resolvedNode, moveSelectionToEnd ? 'next' : 'previous');
     } else {
       let resolvedElement = $getNodeFromDOM(dom);
       // Ensure resolvedElement is actually a element.
@@ -7231,7 +7235,7 @@ function $internalResolveSelectionPoint(dom, offset, lastPoint, editor) {
         if ($isTextNode(child)) {
           resolvedNode = child;
           resolvedElement = null;
-          resolvedOffset = getTextNodeOffset(child, moveSelectionToEnd);
+          resolvedOffset = $getTextNodeOffset(child, moveSelectionToEnd ? 'next' : 'previous');
         } else if (child !== resolvedElement && moveSelectionToEnd && !hasBlockCursor) {
           if (!$isElementNode(resolvedElement)) {
             formatDevErrorMessage(`invariant`);
@@ -7260,7 +7264,7 @@ function $internalResolveSelectionPoint(dom, offset, lastPoint, editor) {
   if (!$isTextNode(resolvedNode)) {
     return null;
   }
-  return $createPoint(resolvedNode.__key, resolvedOffset, 'text');
+  return $createPoint(resolvedNode.__key, $getTextNodeOffset(resolvedNode, resolvedOffset, 'clamp'), 'text');
 }
 function resolveSelectionPointOnBoundary(point, isBackward, isCollapsed) {
   const offset = point.offset;
@@ -7327,8 +7331,8 @@ function $internalResolveSelectionPoints(anchorDOM, anchorOffset, focusDOM, focu
     return null;
   }
   {
-    $validatePoint(editor, 'anchor', resolvedAnchorPoint);
-    $validatePoint(editor, 'focus', resolvedAnchorPoint);
+    $validatePoint('anchor', resolvedAnchorPoint);
+    $validatePoint('focus', resolvedFocusPoint);
   }
   if (resolvedAnchorPoint.type === 'element' && resolvedFocusPoint.type === 'element') {
     const anchorNode = $getNodeFromDOM(anchorDOM);
@@ -7427,7 +7431,7 @@ function $internalCreateRangeSelection(lastSelection, domSelection, editor, even
   const [resolvedAnchorPoint, resolvedFocusPoint] = resolvedSelectionPoints;
   return new RangeSelection(resolvedAnchorPoint, resolvedFocusPoint, !$isRangeSelection(lastSelection) ? 0 : lastSelection.format, !$isRangeSelection(lastSelection) ? '' : lastSelection.style);
 }
-function $validatePoint(editor, name, point) {
+function $validatePoint(name, point) {
   const node = $getNodeByKey(point.key);
   if (!(node !== undefined)) {
     formatDevErrorMessage(`$validatePoint: ${name} key ${point.key} not found in current editorState`);
@@ -8507,7 +8511,7 @@ function triggerDeferredUpdateCallbacks(editor, deferred) {
     }
   }
 }
-function processNestedUpdates(editor, initialSkipTransforms) {
+function $processNestedUpdates(editor, initialSkipTransforms) {
   const queuedUpdates = editor._updates;
   let skipTransforms = initialSkipTransforms || false;
 
@@ -8518,6 +8522,7 @@ function processNestedUpdates(editor, initialSkipTransforms) {
     const queuedUpdate = queuedUpdates.shift();
     if (queuedUpdate) {
       const [nextUpdateFn, options] = queuedUpdate;
+      const pendingEditorState = editor._pendingEditorState;
       let onUpdate;
       if (options !== undefined) {
         onUpdate = options.onUpdate;
@@ -8525,7 +8530,6 @@ function processNestedUpdates(editor, initialSkipTransforms) {
           skipTransforms = true;
         }
         if (options.discrete) {
-          const pendingEditorState = editor._pendingEditorState;
           if (!(pendingEditorState !== null)) {
             formatDevErrorMessage(`Unexpected empty pending editor state on discrete nested update`);
           }
@@ -8536,7 +8540,11 @@ function processNestedUpdates(editor, initialSkipTransforms) {
         }
         addTags(editor, options.tag);
       }
-      nextUpdateFn();
+      if (pendingEditorState == null) {
+        $beginUpdate(editor, nextUpdateFn, options);
+      } else {
+        nextUpdateFn();
+      }
     }
   }
   return skipTransforms;
@@ -8585,7 +8593,7 @@ function $beginUpdate(editor, updateFn, options) {
     }
     const startingCompositionKey = editor._compositionKey;
     updateFn();
-    skipTransforms = processNestedUpdates(editor, skipTransforms);
+    skipTransforms = $processNestedUpdates(editor, skipTransforms);
     applySelectionTransforms(pendingEditorState, editor);
     if (editor._dirtyType !== NO_DIRTY_NODES) {
       if (skipTransforms) {
@@ -8593,7 +8601,7 @@ function $beginUpdate(editor, updateFn, options) {
       } else {
         $applyAllTransforms(pendingEditorState, editor);
       }
-      processNestedUpdates(editor);
+      $processNestedUpdates(editor);
       $garbageCollectDetachedNodes(currentEditorState, pendingEditorState, editor._dirtyLeaves, editor._dirtyElements);
     }
     const endingCompositionKey = editor._compositionKey;
@@ -10763,7 +10771,7 @@ class LexicalEditor {
     };
   }
 }
-LexicalEditor.version = "0.33.2-nightly.20250724.0+dev.cjs";
+LexicalEditor.version = "0.33.2-nightly.20250725.0+dev.cjs";
 
 let pendingNodeToClone = null;
 function setPendingNodeToClone(pendingNode) {
@@ -11213,9 +11221,6 @@ function $getNodeFromDOM(dom) {
   }
   return $getNodeByKey(nodeKey);
 }
-function getTextNodeOffset(node, moveSelectionToEnd) {
-  return moveSelectionToEnd ? node.getTextContentSize() : 0;
-}
 function getNodeKeyFromDOMTree(
 // Note that node here refers to a DOM Node, not an Lexical Node
 dom, editor) {
@@ -11323,7 +11328,7 @@ function $updateTextNodeFromDOMContent(textNode, textContent, anchorOffset, focu
       }
       const selection = $getSelection();
       if (!$isRangeSelection(selection) || anchorOffset === null || focusOffset === null) {
-        node.setTextContent(normalizedTextContent);
+        $setTextContentWithSelection(node, normalizedTextContent, selection);
         return;
       }
       selection.setTextNodeRange(node, anchorOffset, node, focusOffset);
@@ -11333,7 +11338,19 @@ function $updateTextNodeFromDOMContent(textNode, textContent, anchorOffset, focu
         node.replace(replacement);
         node = replacement;
       }
-      node.setTextContent(normalizedTextContent);
+      $setTextContentWithSelection(node, normalizedTextContent, selection);
+    }
+  }
+}
+function $setTextContentWithSelection(node, textContent, selection) {
+  node.setTextContent(textContent);
+  if ($isRangeSelection(selection)) {
+    const key = node.getKey();
+    for (const k of ['anchor', 'focus']) {
+      const pt = selection[k];
+      if (pt.type === 'text' && pt.key === key) {
+        pt.offset = $getTextNodeOffset(node, pt.offset, 'clamp');
+      }
     }
   }
 }
@@ -12762,13 +12779,14 @@ function $getTextPointCaret(origin, direction, offset) {
  *
  * @param origin a TextNode
  * @param offset An absolute offset into the TextNode string, or a direction for which end to use as the offset
+ * @param mode If 'error' (the default) out of bounds offsets will be an error in dev. Otherwise it will clamp to a valid offset.
  * @returns An absolute offset into the TextNode string
  */
-function $getTextNodeOffset(origin, offset) {
+function $getTextNodeOffset(origin, offset, mode = 'error') {
   const size = origin.getTextContentSize();
   let numericOffset = offset === 'next' ? size : offset === 'previous' ? 0 : offset;
   if (numericOffset < 0 || numericOffset > size) {
-    {
+    if (!(mode === 'clamp')) {
       formatDevErrorMessage(`$getTextNodeOffset: invalid offset ${String(offset)} for size ${String(size)} at key ${origin.getKey()}`);
     } // Clamp invalid offsets in prod
     numericOffset = numericOffset < 0 ? 0 : size;

package/Lexical.dev.mjs

@@ -367,7 +367,11 @@ function flushMutations(editor, mutations, observer) {
         if (type === 'characterData') {
           // Text mutations are deferred and passed to mutation listeners to be
           // processed outside of the Lexical engine.
-          if (shouldFlushTextMutations && $isTextNode(targetNode) && isDOMTextNode(targetDOM) && shouldUpdateTextNodeFromMutation(selection, targetDOM, targetNode)) {
+          if (
+          // TODO there is an edge case here if a mutation happens too quickly
+          //      after text input, it may never be handled since we do not
+          //      track the ignored mutations in any way
+          shouldFlushTextMutations && $isTextNode(targetNode) && isDOMTextNode(targetDOM) && shouldUpdateTextNodeFromMutation(selection, targetDOM, targetNode)) {
             $handleTextMutation(targetDOM, targetNode, editor);
           }
         } else if (type === 'childList') {
@@ -7194,7 +7198,7 @@ function $internalResolveSelectionPoint(dom, offset, lastPoint, editor) {
     }
     resolvedNode = $getNodeFromDOM(childDOM);
     if ($isTextNode(resolvedNode)) {
-      resolvedOffset = getTextNodeOffset(resolvedNode, moveSelectionToEnd);
+      resolvedOffset = $getTextNodeOffset(resolvedNode, moveSelectionToEnd ? 'next' : 'previous');
     } else {
       let resolvedElement = $getNodeFromDOM(dom);
       // Ensure resolvedElement is actually a element.
@@ -7229,7 +7233,7 @@ function $internalResolveSelectionPoint(dom, offset, lastPoint, editor) {
         if ($isTextNode(child)) {
           resolvedNode = child;
           resolvedElement = null;
-          resolvedOffset = getTextNodeOffset(child, moveSelectionToEnd);
+          resolvedOffset = $getTextNodeOffset(child, moveSelectionToEnd ? 'next' : 'previous');
         } else if (child !== resolvedElement && moveSelectionToEnd && !hasBlockCursor) {
           if (!$isElementNode(resolvedElement)) {
             formatDevErrorMessage(`invariant`);
@@ -7258,7 +7262,7 @@ function $internalResolveSelectionPoint(dom, offset, lastPoint, editor) {
   if (!$isTextNode(resolvedNode)) {
     return null;
   }
-  return $createPoint(resolvedNode.__key, resolvedOffset, 'text');
+  return $createPoint(resolvedNode.__key, $getTextNodeOffset(resolvedNode, resolvedOffset, 'clamp'), 'text');
 }
 function resolveSelectionPointOnBoundary(point, isBackward, isCollapsed) {
   const offset = point.offset;
@@ -7325,8 +7329,8 @@ function $internalResolveSelectionPoints(anchorDOM, anchorOffset, focusDOM, focu
     return null;
   }
   {
-    $validatePoint(editor, 'anchor', resolvedAnchorPoint);
-    $validatePoint(editor, 'focus', resolvedAnchorPoint);
+    $validatePoint('anchor', resolvedAnchorPoint);
+    $validatePoint('focus', resolvedFocusPoint);
   }
   if (resolvedAnchorPoint.type === 'element' && resolvedFocusPoint.type === 'element') {
     const anchorNode = $getNodeFromDOM(anchorDOM);
@@ -7425,7 +7429,7 @@ function $internalCreateRangeSelection(lastSelection, domSelection, editor, even
   const [resolvedAnchorPoint, resolvedFocusPoint] = resolvedSelectionPoints;
   return new RangeSelection(resolvedAnchorPoint, resolvedFocusPoint, !$isRangeSelection(lastSelection) ? 0 : lastSelection.format, !$isRangeSelection(lastSelection) ? '' : lastSelection.style);
 }
-function $validatePoint(editor, name, point) {
+function $validatePoint(name, point) {
   const node = $getNodeByKey(point.key);
   if (!(node !== undefined)) {
     formatDevErrorMessage(`$validatePoint: ${name} key ${point.key} not found in current editorState`);
@@ -8505,7 +8509,7 @@ function triggerDeferredUpdateCallbacks(editor, deferred) {
     }
   }
 }
-function processNestedUpdates(editor, initialSkipTransforms) {
+function $processNestedUpdates(editor, initialSkipTransforms) {
   const queuedUpdates = editor._updates;
   let skipTransforms = initialSkipTransforms || false;
 
@@ -8516,6 +8520,7 @@ function processNestedUpdates(editor, initialSkipTransforms) {
     const queuedUpdate = queuedUpdates.shift();
     if (queuedUpdate) {
       const [nextUpdateFn, options] = queuedUpdate;
+      const pendingEditorState = editor._pendingEditorState;
       let onUpdate;
       if (options !== undefined) {
         onUpdate = options.onUpdate;
@@ -8523,7 +8528,6 @@ function processNestedUpdates(editor, initialSkipTransforms) {
           skipTransforms = true;
         }
         if (options.discrete) {
-          const pendingEditorState = editor._pendingEditorState;
           if (!(pendingEditorState !== null)) {
             formatDevErrorMessage(`Unexpected empty pending editor state on discrete nested update`);
           }
@@ -8534,7 +8538,11 @@ function processNestedUpdates(editor, initialSkipTransforms) {
         }
         addTags(editor, options.tag);
       }
-      nextUpdateFn();
+      if (pendingEditorState == null) {
+        $beginUpdate(editor, nextUpdateFn, options);
+      } else {
+        nextUpdateFn();
+      }
     }
   }
   return skipTransforms;
@@ -8583,7 +8591,7 @@ function $beginUpdate(editor, updateFn, options) {
     }
     const startingCompositionKey = editor._compositionKey;
     updateFn();
-    skipTransforms = processNestedUpdates(editor, skipTransforms);
+    skipTransforms = $processNestedUpdates(editor, skipTransforms);
     applySelectionTransforms(pendingEditorState, editor);
     if (editor._dirtyType !== NO_DIRTY_NODES) {
       if (skipTransforms) {
@@ -8591,7 +8599,7 @@ function $beginUpdate(editor, updateFn, options) {
       } else {
         $applyAllTransforms(pendingEditorState, editor);
       }
-      processNestedUpdates(editor);
+      $processNestedUpdates(editor);
       $garbageCollectDetachedNodes(currentEditorState, pendingEditorState, editor._dirtyLeaves, editor._dirtyElements);
     }
     const endingCompositionKey = editor._compositionKey;
@@ -10761,7 +10769,7 @@ class LexicalEditor {
     };
   }
 }
-LexicalEditor.version = "0.33.2-nightly.20250724.0+dev.esm";
+LexicalEditor.version = "0.33.2-nightly.20250725.0+dev.esm";
 
 let pendingNodeToClone = null;
 function setPendingNodeToClone(pendingNode) {
@@ -11211,9 +11219,6 @@ function $getNodeFromDOM(dom) {
   }
   return $getNodeByKey(nodeKey);
 }
-function getTextNodeOffset(node, moveSelectionToEnd) {
-  return moveSelectionToEnd ? node.getTextContentSize() : 0;
-}
 function getNodeKeyFromDOMTree(
 // Note that node here refers to a DOM Node, not an Lexical Node
 dom, editor) {
@@ -11321,7 +11326,7 @@ function $updateTextNodeFromDOMContent(textNode, textContent, anchorOffset, focu
       }
       const selection = $getSelection();
       if (!$isRangeSelection(selection) || anchorOffset === null || focusOffset === null) {
-        node.setTextContent(normalizedTextContent);
+        $setTextContentWithSelection(node, normalizedTextContent, selection);
         return;
       }
       selection.setTextNodeRange(node, anchorOffset, node, focusOffset);
@@ -11331,7 +11336,19 @@ function $updateTextNodeFromDOMContent(textNode, textContent, anchorOffset, focu
         node.replace(replacement);
         node = replacement;
       }
-      node.setTextContent(normalizedTextContent);
+      $setTextContentWithSelection(node, normalizedTextContent, selection);
+    }
+  }
+}
+function $setTextContentWithSelection(node, textContent, selection) {
+  node.setTextContent(textContent);
+  if ($isRangeSelection(selection)) {
+    const key = node.getKey();
+    for (const k of ['anchor', 'focus']) {
+      const pt = selection[k];
+      if (pt.type === 'text' && pt.key === key) {
+        pt.offset = $getTextNodeOffset(node, pt.offset, 'clamp');
+      }
     }
   }
 }
@@ -12760,13 +12777,14 @@ function $getTextPointCaret(origin, direction, offset) {
  *
  * @param origin a TextNode
  * @param offset An absolute offset into the TextNode string, or a direction for which end to use as the offset
+ * @param mode If 'error' (the default) out of bounds offsets will be an error in dev. Otherwise it will clamp to a valid offset.
  * @returns An absolute offset into the TextNode string
  */
-function $getTextNodeOffset(origin, offset) {
+function $getTextNodeOffset(origin, offset, mode = 'error') {
   const size = origin.getTextContentSize();
   let numericOffset = offset === 'next' ? size : offset === 'previous' ? 0 : offset;
   if (numericOffset < 0 || numericOffset > size) {
-    {
+    if (!(mode === 'clamp')) {
       formatDevErrorMessage(`$getTextNodeOffset: invalid offset ${String(offset)} for size ${String(size)} at key ${origin.getKey()}`);
     } // Clamp invalid offsets in prod
     numericOffset = numericOffset < 0 ? 0 : size;