lexical 0.27.3-nightly.20250314.0 → 0.27.3-nightly.20250318.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.20250314.0+dev.cjs";
+LexicalEditor.version = "0.27.3-nightly.20250318.0+dev.cjs";
 
 let keyCounter = 1;
 function resetRandomKey() {
@@ -12197,6 +12221,13 @@ function $extendCaretToRange(anchor) {
   return $getCaretRange(anchor, $getSiblingCaret($getRoot(), anchor.direction));
 }
 
+/**
+ * Construct a collapsed CaretRange that starts and ends at anchor.
+ */
+function $getCollapsedCaretRange(anchor) {
+  return $getCaretRange(anchor, anchor);
+}
+
 /**
  * Construct a CaretRange from anchor and focus carets pointing in the
  * same direction. In order to get the expected behavior,
@@ -12659,7 +12690,7 @@ function $removeTextFromCaretRange(initialRange, sliceMode = 'removeEmptySlices'
   const bestCandidate = [anchorCandidate, focusCandidate, ...anchorCandidates, ...focusCandidates].find($isCaretAttached);
   if (bestCandidate) {
     const anchor = $getCaretInDirection($normalizeCaret(bestCandidate), initialRange.direction);
-    return $getCaretRange(anchor, anchor);
+    return $getCollapsedCaretRange(anchor);
   }
   {
     formatDevErrorMessage(`$removeTextFromCaretRange: selection was lost, could not find a new anchor given candidates with keys: ${JSON.stringify(anchorCandidates.map(n => n.origin.__key))}`);
@@ -12847,6 +12878,81 @@ function $getAdjacentSiblingOrParentSiblingCaret(startCaret, rootMode = 'root')
   return nextCaret && [nextCaret, depthDiff];
 }
 
+/**
+ * Get the adjacent nodes to initialCaret in the given direction.
+ *
+ * @example
+ * ```ts
+ * expect($getAdjacentNodes($getChildCaret(parent, 'next'))).toEqual(parent.getChildren());
+ * expect($getAdjacentNodes($getChildCaret(parent, 'previous'))).toEqual(parent.getChildren().reverse());
+ * expect($getAdjacentNodes($getSiblingCaret(node, 'next'))).toEqual(node.getNextSiblings());
+ * expect($getAdjacentNodes($getSiblingCaret(node, 'previous'))).toEqual(node.getPreviousSiblings().reverse());
+ * ```
+ *
+ * @param initialCaret The caret to start at (the origin will not be included)
+ * @returns An array of siblings.
+ */
+function $getAdjacentNodes(initialCaret) {
+  const siblings = [];
+  for (let caret = initialCaret.getAdjacentCaret(); caret; caret = caret.getAdjacentCaret()) {
+    siblings.push(caret.origin);
+  }
+  return siblings;
+}
+function $splitTextPointCaret(textPointCaret) {
+  const {
+    origin,
+    offset,
+    direction
+  } = textPointCaret;
+  if (offset === $getTextNodeOffset(origin, direction)) {
+    return textPointCaret.getSiblingCaret();
+  } else if (offset === $getTextNodeOffset(origin, flipDirection(direction))) {
+    return $rewindSiblingCaret(textPointCaret.getSiblingCaret());
+  }
+  const [textNode] = origin.splitText(offset);
+  if (!$isTextNode(textNode)) {
+    formatDevErrorMessage(`$splitTextPointCaret: splitText must return at least one TextNode`);
+  }
+  return $getCaretInDirection($getSiblingCaret(textNode, 'next'), direction);
+}
+function $alwaysSplit(_node, _edge) {
+  return true;
+}
+
+/**
+ * Split a node at a PointCaret and return a NodeCaret at that point, or null if the
+ * node can't be split. This is non-recursive and will only perform at most one split.
+ *
+ * @returns The NodeCaret pointing to the location of the split (or null if a split is not possible)
+ */
+function $splitAtPointCaretNext(pointCaret, {
+  $copyElementNode = $copyNode,
+  $splitTextPointCaretNext = $splitTextPointCaret,
+  rootMode = 'shadowRoot',
+  $shouldSplit = $alwaysSplit
+} = {}) {
+  if ($isTextPointCaret(pointCaret)) {
+    return $splitTextPointCaretNext(pointCaret);
+  }
+  const parentCaret = pointCaret.getParentCaret(rootMode);
+  if (parentCaret) {
+    const {
+      origin
+    } = parentCaret;
+    if ($isChildCaret(pointCaret) && !(origin.canBeEmpty() && $shouldSplit(origin, 'first'))) {
+      // No split necessary, the left side would be empty
+      return $rewindSiblingCaret(parentCaret);
+    }
+    const siblings = $getAdjacentNodes(pointCaret);
+    if (siblings.length > 0 || origin.canBeEmpty() && $shouldSplit(origin, 'last')) {
+      // Split and insert the siblings into the new tree
+      parentCaret.insert($copyElementNode(origin).splice(0, 0, siblings));
+    }
+  }
+  return parentCaret;
+}
+
 exports.$addUpdateTag = $addUpdateTag;
 exports.$applyNodeReplacement = $applyNodeReplacement;
 exports.$caretFromPoint = $caretFromPoint;
@@ -12873,6 +12979,7 @@ exports.$getCharacterOffsets = $getCharacterOffsets;
 exports.$getChildCaret = $getChildCaret;
 exports.$getChildCaretAtIndex = $getChildCaretAtIndex;
 exports.$getChildCaretOrSelf = $getChildCaretOrSelf;
+exports.$getCollapsedCaretRange = $getCollapsedCaretRange;
 exports.$getCommonAncestor = $getCommonAncestor;
 exports.$getCommonAncestorResultBranchOrder = $getCommonAncestorResultBranchOrder;
 exports.$getEditor = $getEditor;
@@ -12927,6 +13034,7 @@ exports.$setPointFromCaret = $setPointFromCaret;
 exports.$setSelection = $setSelection;
 exports.$setSelectionFromCaretRange = $setSelectionFromCaretRange;
 exports.$setState = $setState;
+exports.$splitAtPointCaretNext = $splitAtPointCaretNext;
 exports.$splitNode = $splitNode;
 exports.$updateRangeSelectionFromCaretRange = $updateRangeSelectionFromCaretRange;
 exports.ArtificialNode__DO_NOT_USE = ArtificialNode__DO_NOT_USE;

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.20250314.0+dev.esm";
+LexicalEditor.version = "0.27.3-nightly.20250318.0+dev.esm";
 
 let keyCounter = 1;
 function resetRandomKey() {
@@ -12195,6 +12219,13 @@ function $extendCaretToRange(anchor) {
   return $getCaretRange(anchor, $getSiblingCaret($getRoot(), anchor.direction));
 }
 
+/**
+ * Construct a collapsed CaretRange that starts and ends at anchor.
+ */
+function $getCollapsedCaretRange(anchor) {
+  return $getCaretRange(anchor, anchor);
+}
+
 /**
  * Construct a CaretRange from anchor and focus carets pointing in the
  * same direction. In order to get the expected behavior,
@@ -12657,7 +12688,7 @@ function $removeTextFromCaretRange(initialRange, sliceMode = 'removeEmptySlices'
   const bestCandidate = [anchorCandidate, focusCandidate, ...anchorCandidates, ...focusCandidates].find($isCaretAttached);
   if (bestCandidate) {
     const anchor = $getCaretInDirection($normalizeCaret(bestCandidate), initialRange.direction);
-    return $getCaretRange(anchor, anchor);
+    return $getCollapsedCaretRange(anchor);
   }
   {
     formatDevErrorMessage(`$removeTextFromCaretRange: selection was lost, could not find a new anchor given candidates with keys: ${JSON.stringify(anchorCandidates.map(n => n.origin.__key))}`);
@@ -12845,4 +12876,79 @@ function $getAdjacentSiblingOrParentSiblingCaret(startCaret, rootMode = 'root')
   return nextCaret && [nextCaret, depthDiff];
 }
 
-export { $addUpdateTag, $applyNodeReplacement, $caretFromPoint, $caretRangeFromSelection, $cloneWithProperties, $comparePointCaretNext, $copyNode, $createLineBreakNode, $createNodeSelection, $createParagraphNode, $createPoint, $createRangeSelection, $createRangeSelectionFromDom, $createTabNode, $createTextNode, $extendCaretToRange, $getAdjacentChildCaret, $getAdjacentNode, $getAdjacentSiblingOrParentSiblingCaret, $getCaretInDirection, $getCaretRange, $getCaretRangeInDirection, $getCharacterOffsets, $getChildCaret, $getChildCaretAtIndex, $getChildCaretOrSelf, $getCommonAncestor, $getCommonAncestorResultBranchOrder, $getEditor, $getNearestNodeFromDOMNode, $getNearestRootOrShadowRoot, $getNodeByKey, $getNodeByKeyOrThrow, $getPreviousSelection, $getRoot, $getSelection, $getSiblingCaret, $getState, $getStateChange, $getTextContent, $getTextNodeOffset, $getTextPointCaret, $getTextPointCaretSlice, $getWritableNodeState, $hasAncestor, $hasUpdateTag, $insertNodes, $isBlockElementNode, $isChildCaret, $isDecoratorNode, $isElementNode, $isExtendableTextPointCaret, $isInlineElementOrDecoratorNode, $isLeafNode, $isLineBreakNode, $isNodeCaret, $isNodeSelection, $isParagraphNode, $isRangeSelection, $isRootNode, $isRootOrShadowRoot, $isSiblingCaret, $isTabNode, $isTextNode, $isTextPointCaret, $isTextPointCaretSlice, $isTokenOrSegmented, $nodesOfType, $normalizeCaret, $normalizeSelection as $normalizeSelection__EXPERIMENTAL, $onUpdate, $parseSerializedNode, $removeTextFromCaretRange, $rewindSiblingCaret, $selectAll, $setCompositionKey, $setPointFromCaret, $setSelection, $setSelectionFromCaretRange, $setState, $splitNode, $updateRangeSelectionFromCaretRange, ArtificialNode__DO_NOT_USE, BLUR_COMMAND, CAN_REDO_COMMAND, CAN_UNDO_COMMAND, CLEAR_EDITOR_COMMAND, CLEAR_HISTORY_COMMAND, CLICK_COMMAND, COMMAND_PRIORITY_CRITICAL, COMMAND_PRIORITY_EDITOR, COMMAND_PRIORITY_HIGH, COMMAND_PRIORITY_LOW, COMMAND_PRIORITY_NORMAL, CONTROLLED_TEXT_INSERTION_COMMAND, COPY_COMMAND, CUT_COMMAND, DELETE_CHARACTER_COMMAND, DELETE_LINE_COMMAND, DELETE_WORD_COMMAND, DRAGEND_COMMAND, DRAGOVER_COMMAND, DRAGSTART_COMMAND, DROP_COMMAND, DecoratorNode, ElementNode, FOCUS_COMMAND, FORMAT_ELEMENT_COMMAND, FORMAT_TEXT_COMMAND, INDENT_CONTENT_COMMAND, INSERT_LINE_BREAK_COMMAND, INSERT_PARAGRAPH_COMMAND, INSERT_TAB_COMMAND, INTERNAL_$isBlock, IS_ALL_FORMATTING, IS_BOLD, IS_CODE, IS_HIGHLIGHT, IS_ITALIC, IS_STRIKETHROUGH, IS_SUBSCRIPT, IS_SUPERSCRIPT, IS_UNDERLINE, KEY_ARROW_DOWN_COMMAND, KEY_ARROW_LEFT_COMMAND, KEY_ARROW_RIGHT_COMMAND, KEY_ARROW_UP_COMMAND, KEY_BACKSPACE_COMMAND, KEY_DELETE_COMMAND, KEY_DOWN_COMMAND, KEY_ENTER_COMMAND, KEY_ESCAPE_COMMAND, KEY_MODIFIER_COMMAND, KEY_SPACE_COMMAND, KEY_TAB_COMMAND, LineBreakNode, MOVE_TO_END, MOVE_TO_START, NODE_STATE_KEY, OUTDENT_CONTENT_COMMAND, PASTE_COMMAND, ParagraphNode, REDO_COMMAND, REMOVE_TEXT_COMMAND, RootNode, SELECTION_CHANGE_COMMAND, SELECTION_INSERT_CLIPBOARD_NODES_COMMAND, SELECT_ALL_COMMAND, TEXT_TYPE_TO_FORMAT, TabNode, TextNode, UNDO_COMMAND, createCommand, createEditor, createState, flipDirection, getDOMOwnerDocument, getDOMSelection, getDOMSelectionFromTarget, getDOMTextNode, getEditorPropertyFromDOMNode, getNearestEditorFromDOMNode, isBlockDomNode, isCurrentlyReadOnlyMode, isDOMDocumentNode, isDOMNode, isDOMTextNode, isDOMUnmanaged, isDocumentFragment, isHTMLAnchorElement, isHTMLElement, isInlineDomNode, isLexicalEditor, isSelectionCapturedInDecoratorInput, isSelectionWithinEditor, makeStepwiseIterator, resetRandomKey, setDOMUnmanaged, setNodeIndentFromDOM };
+/**
+ * Get the adjacent nodes to initialCaret in the given direction.
+ *
+ * @example
+ * ```ts
+ * expect($getAdjacentNodes($getChildCaret(parent, 'next'))).toEqual(parent.getChildren());
+ * expect($getAdjacentNodes($getChildCaret(parent, 'previous'))).toEqual(parent.getChildren().reverse());
+ * expect($getAdjacentNodes($getSiblingCaret(node, 'next'))).toEqual(node.getNextSiblings());
+ * expect($getAdjacentNodes($getSiblingCaret(node, 'previous'))).toEqual(node.getPreviousSiblings().reverse());
+ * ```
+ *
+ * @param initialCaret The caret to start at (the origin will not be included)
+ * @returns An array of siblings.
+ */
+function $getAdjacentNodes(initialCaret) {
+  const siblings = [];
+  for (let caret = initialCaret.getAdjacentCaret(); caret; caret = caret.getAdjacentCaret()) {
+    siblings.push(caret.origin);
+  }
+  return siblings;
+}
+function $splitTextPointCaret(textPointCaret) {
+  const {
+    origin,
+    offset,
+    direction
+  } = textPointCaret;
+  if (offset === $getTextNodeOffset(origin, direction)) {
+    return textPointCaret.getSiblingCaret();
+  } else if (offset === $getTextNodeOffset(origin, flipDirection(direction))) {
+    return $rewindSiblingCaret(textPointCaret.getSiblingCaret());
+  }
+  const [textNode] = origin.splitText(offset);
+  if (!$isTextNode(textNode)) {
+    formatDevErrorMessage(`$splitTextPointCaret: splitText must return at least one TextNode`);
+  }
+  return $getCaretInDirection($getSiblingCaret(textNode, 'next'), direction);
+}
+function $alwaysSplit(_node, _edge) {
+  return true;
+}
+
+/**
+ * Split a node at a PointCaret and return a NodeCaret at that point, or null if the
+ * node can't be split. This is non-recursive and will only perform at most one split.
+ *
+ * @returns The NodeCaret pointing to the location of the split (or null if a split is not possible)
+ */
+function $splitAtPointCaretNext(pointCaret, {
+  $copyElementNode = $copyNode,
+  $splitTextPointCaretNext = $splitTextPointCaret,
+  rootMode = 'shadowRoot',
+  $shouldSplit = $alwaysSplit
+} = {}) {
+  if ($isTextPointCaret(pointCaret)) {
+    return $splitTextPointCaretNext(pointCaret);
+  }
+  const parentCaret = pointCaret.getParentCaret(rootMode);
+  if (parentCaret) {
+    const {
+      origin
+    } = parentCaret;
+    if ($isChildCaret(pointCaret) && !(origin.canBeEmpty() && $shouldSplit(origin, 'first'))) {
+      // No split necessary, the left side would be empty
+      return $rewindSiblingCaret(parentCaret);
+    }
+    const siblings = $getAdjacentNodes(pointCaret);
+    if (siblings.length > 0 || origin.canBeEmpty() && $shouldSplit(origin, 'last')) {
+      // Split and insert the siblings into the new tree
+      parentCaret.insert($copyElementNode(origin).splice(0, 0, siblings));
+    }
+  }
+  return parentCaret;
+}
+
+export { $addUpdateTag, $applyNodeReplacement, $caretFromPoint, $caretRangeFromSelection, $cloneWithProperties, $comparePointCaretNext, $copyNode, $createLineBreakNode, $createNodeSelection, $createParagraphNode, $createPoint, $createRangeSelection, $createRangeSelectionFromDom, $createTabNode, $createTextNode, $extendCaretToRange, $getAdjacentChildCaret, $getAdjacentNode, $getAdjacentSiblingOrParentSiblingCaret, $getCaretInDirection, $getCaretRange, $getCaretRangeInDirection, $getCharacterOffsets, $getChildCaret, $getChildCaretAtIndex, $getChildCaretOrSelf, $getCollapsedCaretRange, $getCommonAncestor, $getCommonAncestorResultBranchOrder, $getEditor, $getNearestNodeFromDOMNode, $getNearestRootOrShadowRoot, $getNodeByKey, $getNodeByKeyOrThrow, $getPreviousSelection, $getRoot, $getSelection, $getSiblingCaret, $getState, $getStateChange, $getTextContent, $getTextNodeOffset, $getTextPointCaret, $getTextPointCaretSlice, $getWritableNodeState, $hasAncestor, $hasUpdateTag, $insertNodes, $isBlockElementNode, $isChildCaret, $isDecoratorNode, $isElementNode, $isExtendableTextPointCaret, $isInlineElementOrDecoratorNode, $isLeafNode, $isLineBreakNode, $isNodeCaret, $isNodeSelection, $isParagraphNode, $isRangeSelection, $isRootNode, $isRootOrShadowRoot, $isSiblingCaret, $isTabNode, $isTextNode, $isTextPointCaret, $isTextPointCaretSlice, $isTokenOrSegmented, $nodesOfType, $normalizeCaret, $normalizeSelection as $normalizeSelection__EXPERIMENTAL, $onUpdate, $parseSerializedNode, $removeTextFromCaretRange, $rewindSiblingCaret, $selectAll, $setCompositionKey, $setPointFromCaret, $setSelection, $setSelectionFromCaretRange, $setState, $splitAtPointCaretNext, $splitNode, $updateRangeSelectionFromCaretRange, ArtificialNode__DO_NOT_USE, BLUR_COMMAND, CAN_REDO_COMMAND, CAN_UNDO_COMMAND, CLEAR_EDITOR_COMMAND, CLEAR_HISTORY_COMMAND, CLICK_COMMAND, COMMAND_PRIORITY_CRITICAL, COMMAND_PRIORITY_EDITOR, COMMAND_PRIORITY_HIGH, COMMAND_PRIORITY_LOW, COMMAND_PRIORITY_NORMAL, CONTROLLED_TEXT_INSERTION_COMMAND, COPY_COMMAND, CUT_COMMAND, DELETE_CHARACTER_COMMAND, DELETE_LINE_COMMAND, DELETE_WORD_COMMAND, DRAGEND_COMMAND, DRAGOVER_COMMAND, DRAGSTART_COMMAND, DROP_COMMAND, DecoratorNode, ElementNode, FOCUS_COMMAND, FORMAT_ELEMENT_COMMAND, FORMAT_TEXT_COMMAND, INDENT_CONTENT_COMMAND, INSERT_LINE_BREAK_COMMAND, INSERT_PARAGRAPH_COMMAND, INSERT_TAB_COMMAND, INTERNAL_$isBlock, IS_ALL_FORMATTING, IS_BOLD, IS_CODE, IS_HIGHLIGHT, IS_ITALIC, IS_STRIKETHROUGH, IS_SUBSCRIPT, IS_SUPERSCRIPT, IS_UNDERLINE, KEY_ARROW_DOWN_COMMAND, KEY_ARROW_LEFT_COMMAND, KEY_ARROW_RIGHT_COMMAND, KEY_ARROW_UP_COMMAND, KEY_BACKSPACE_COMMAND, KEY_DELETE_COMMAND, KEY_DOWN_COMMAND, KEY_ENTER_COMMAND, KEY_ESCAPE_COMMAND, KEY_MODIFIER_COMMAND, KEY_SPACE_COMMAND, KEY_TAB_COMMAND, LineBreakNode, MOVE_TO_END, MOVE_TO_START, NODE_STATE_KEY, OUTDENT_CONTENT_COMMAND, PASTE_COMMAND, ParagraphNode, REDO_COMMAND, REMOVE_TEXT_COMMAND, RootNode, SELECTION_CHANGE_COMMAND, SELECTION_INSERT_CLIPBOARD_NODES_COMMAND, SELECT_ALL_COMMAND, TEXT_TYPE_TO_FORMAT, TabNode, TextNode, UNDO_COMMAND, createCommand, createEditor, createState, flipDirection, getDOMOwnerDocument, getDOMSelection, getDOMSelectionFromTarget, getDOMTextNode, getEditorPropertyFromDOMNode, getNearestEditorFromDOMNode, isBlockDomNode, isCurrentlyReadOnlyMode, isDOMDocumentNode, isDOMNode, isDOMTextNode, isDOMUnmanaged, isDocumentFragment, isHTMLAnchorElement, isHTMLElement, isInlineDomNode, isLexicalEditor, isSelectionCapturedInDecoratorInput, isSelectionWithinEditor, makeStepwiseIterator, resetRandomKey, setDOMUnmanaged, setNodeIndentFromDOM };

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;
@@ -1227,7 +1227,22 @@ declare export function $getCommonAncestor<
 declare export function $extendCaretToRange<D: CaretDirection>(
   anchor: PointCaret<D>,
 ): CaretRange<D>;
-
+declare export function $getCollapsedCaretRange<D: CaretDirection>(
+  anchor: PointCaret<D>,
+): CaretRange<D>;
 declare export function $isExtendableTextPointCaret<D: CaretDirection>(
   caret: PointCaret<D>
 ): implies caret is TextPointCaret<TextNode, D>;
+
+export interface SplitAtPointCaretNextOptions {
+  $copyElementNode?: (node: ElementNode) => ElementNode;
+  $splitTextPointCaretNext?: (
+    caret: TextPointCaret<TextNode, 'next'>,
+  ) => NodeCaret<'next'>;
+  rootMode?: RootMode;
+  $shouldSplit?: (node: ElementNode, edge: 'first' | 'last') => boolean;
+}
+declare export function $splitAtPointCaretNext(
+  pointCaret: PointCaret<'next'>,
+  options?: SplitAtPointCaretNextOptions,
+): null | NodeCaret<'next'>;

package/Lexical.mjs

@@ -35,6 +35,7 @@ export const $getCharacterOffsets = mod.$getCharacterOffsets;
 export const $getChildCaret = mod.$getChildCaret;
 export const $getChildCaretAtIndex = mod.$getChildCaretAtIndex;
 export const $getChildCaretOrSelf = mod.$getChildCaretOrSelf;
+export const $getCollapsedCaretRange = mod.$getCollapsedCaretRange;
 export const $getCommonAncestor = mod.$getCommonAncestor;
 export const $getCommonAncestorResultBranchOrder = mod.$getCommonAncestorResultBranchOrder;
 export const $getEditor = mod.$getEditor;
@@ -89,6 +90,7 @@ export const $setPointFromCaret = mod.$setPointFromCaret;
 export const $setSelection = mod.$setSelection;
 export const $setSelectionFromCaretRange = mod.$setSelectionFromCaretRange;
 export const $setState = mod.$setState;
+export const $splitAtPointCaretNext = mod.$splitAtPointCaretNext;
 export const $splitNode = mod.$splitNode;
 export const $updateRangeSelectionFromCaretRange = mod.$updateRangeSelectionFromCaretRange;
 export const ArtificialNode__DO_NOT_USE = mod.ArtificialNode__DO_NOT_USE;

package/Lexical.node.mjs

@@ -33,6 +33,7 @@ export const $getCharacterOffsets = mod.$getCharacterOffsets;
 export const $getChildCaret = mod.$getChildCaret;
 export const $getChildCaretAtIndex = mod.$getChildCaretAtIndex;
 export const $getChildCaretOrSelf = mod.$getChildCaretOrSelf;
+export const $getCollapsedCaretRange = mod.$getCollapsedCaretRange;
 export const $getCommonAncestor = mod.$getCommonAncestor;
 export const $getCommonAncestorResultBranchOrder = mod.$getCommonAncestorResultBranchOrder;
 export const $getEditor = mod.$getEditor;
@@ -87,6 +88,7 @@ export const $setPointFromCaret = mod.$setPointFromCaret;
 export const $setSelection = mod.$setSelection;
 export const $setSelectionFromCaretRange = mod.$setSelectionFromCaretRange;
 export const $setState = mod.$setState;
+export const $splitAtPointCaretNext = mod.$splitAtPointCaretNext;
 export const $splitNode = mod.$splitNode;
 export const $updateRangeSelectionFromCaretRange = mod.$updateRangeSelectionFromCaretRange;
 export const ArtificialNode__DO_NOT_USE = mod.ArtificialNode__DO_NOT_USE;