@lexical/selection 0.8.1 → 0.9.1

package/LexicalSelection.dev.js

@@ -24,23 +24,41 @@ const CSS_TO_STYLES = new Map();
  * LICENSE file in the root directory of this source tree.
  *
  */
+
 function getDOMTextNode(element) {
   let node = element;
+
   while (node != null) {
     if (node.nodeType === Node.TEXT_NODE) {
       return node;
     }
+
     node = node.firstChild;
   }
+
   return null;
 }
+
 function getDOMIndexWithinParent(node) {
   const parent = node.parentNode;
+
   if (parent == null) {
     throw new Error('Should never happen');
   }
+
   return [parent, Array.from(parent.childNodes).indexOf(node)];
 }
+/**
+ * Creates a selection range for the DOM.
+ * @param editor - The lexical editor.
+ * @param anchorNode - The anchor node of a selection.
+ * @param _anchorOffset - The amount of space offset from the anchor to the focus.
+ * @param focusNode - The current focus.
+ * @param _focusOffset - The amount of space offset from the focus to the anchor.
+ * @returns The range of selection for the DOM that was created.
+ */
+
+
 function createDOMRange(editor, anchorNode, _anchorOffset, focusNode, _focusOffset) {
   const anchorKey = anchorNode.getKey();
   const focusKey = focusNode.getKey();
@@ -49,94 +67,141 @@ function createDOMRange(editor, anchorNode, _anchorOffset, focusNode, _focusOffs
   let focusDOM = editor.getElementByKey(focusKey);
   let anchorOffset = _anchorOffset;
   let focusOffset = _focusOffset;
+
   if (lexical.$isTextNode(anchorNode)) {
     anchorDOM = getDOMTextNode(anchorDOM);
   }
+
   if (lexical.$isTextNode(focusNode)) {
     focusDOM = getDOMTextNode(focusDOM);
   }
+
   if (anchorNode === undefined || focusNode === undefined || anchorDOM === null || focusDOM === null) {
     return null;
   }
+
   if (anchorDOM.nodeName === 'BR') {
     [anchorDOM, anchorOffset] = getDOMIndexWithinParent(anchorDOM);
   }
+
   if (focusDOM.nodeName === 'BR') {
     [focusDOM, focusOffset] = getDOMIndexWithinParent(focusDOM);
   }
+
   const firstChild = anchorDOM.firstChild;
+
   if (anchorDOM === focusDOM && firstChild != null && firstChild.nodeName === 'BR' && anchorOffset === 0 && focusOffset === 0) {
     focusOffset = 1;
   }
+
   try {
     range.setStart(anchorDOM, anchorOffset);
     range.setEnd(focusDOM, focusOffset);
   } catch (e) {
     return null;
   }
+
   if (range.collapsed && (anchorOffset !== focusOffset || anchorKey !== focusKey)) {
     // Range is backwards, we need to reverse it
     range.setStart(focusDOM, focusOffset);
     range.setEnd(anchorDOM, anchorOffset);
   }
+
   return range;
 }
+/**
+ * Creates DOMRects, generally used to help the editor find a specific location on the screen.
+ * @param editor - The lexical editor
+ * @param range - A fragment of a document that can contain nodes and parts of text nodes.
+ * @returns The selectionRects as an array.
+ */
+
 function createRectsFromDOMRange(editor, range) {
   const rootElement = editor.getRootElement();
+
   if (rootElement === null) {
     return [];
   }
+
   const rootRect = rootElement.getBoundingClientRect();
   const computedStyle = getComputedStyle(rootElement);
   const rootPadding = parseFloat(computedStyle.paddingLeft) + parseFloat(computedStyle.paddingRight);
   const selectionRects = Array.from(range.getClientRects());
   let selectionRectsLength = selectionRects.length;
   let prevRect;
+
   for (let i = 0; i < selectionRectsLength; i++) {
-    const selectionRect = selectionRects[i];
-    // Exclude a rect that is the exact same as the last rect. getClientRects() can return
+    const selectionRect = selectionRects[i]; // Exclude a rect that is the exact same as the last rect. getClientRects() can return
     // the same rect twice for some elements. A more sophisticated thing to do here is to
     // merge all the rects together into a set of rects that don't overlap, so we don't
     // generate backgrounds that are too dark.
-    const isDuplicateRect = prevRect && prevRect.top === selectionRect.top && prevRect.left === selectionRect.left && prevRect.width === selectionRect.width && prevRect.height === selectionRect.height;
 
-    // Exclude selections that span the entire element
+    const isDuplicateRect = prevRect && prevRect.top === selectionRect.top && prevRect.left === selectionRect.left && prevRect.width === selectionRect.width && prevRect.height === selectionRect.height; // Exclude selections that span the entire element
+
     const selectionSpansElement = selectionRect.width + rootPadding === rootRect.width;
+
     if (isDuplicateRect || selectionSpansElement) {
       selectionRects.splice(i--, 1);
       selectionRectsLength--;
       continue;
     }
+
     prevRect = selectionRect;
   }
+
   return selectionRects;
 }
+/**
+ * Creates an object containing all the styles and their values provided in the CSS string.
+ * @param css - The CSS string of styles and their values.
+ * @returns The styleObject containing all the styles and their values.
+ */
+
 function getStyleObjectFromRawCSS(css) {
   const styleObject = {};
   const styles = css.split(';');
+
   for (const style of styles) {
     if (style !== '') {
       const [key, value] = style.split(/:([^]+)/); // split on first colon
+
       styleObject[key.trim()] = value.trim();
     }
   }
+
   return styleObject;
 }
+/**
+ * Given a CSS string, returns an object from the style cache.
+ * @param css - The CSS property as a string.
+ * @returns The value of the given CSS property.
+ */
+
 function getStyleObjectFromCSS(css) {
   let value = CSS_TO_STYLES.get(css);
+
   if (value === undefined) {
     value = getStyleObjectFromRawCSS(css);
     CSS_TO_STYLES.set(css, value);
   }
+
   return value;
 }
+/**
+ * Gets the CSS styles from the style object.
+ * @param styles - The style object containing the styles to get.
+ * @returns A string containing the CSS styles and their values.
+ */
+
 function getCSSFromStyleObject(styles) {
   let css = '';
+
   for (const style in styles) {
     if (style) {
       css += `${style}: ${styles[style]};`;
     }
   }
+
   return css;
 }
 
@@ -147,6 +212,7 @@ function getCSSFromStyleObject(styles) {
  * LICENSE file in the root directory of this source tree.
  *
  */
+
 function $updateElementNodeProperties(target, source) {
   target.__first = source.__first;
   target.__last = source.__last;
@@ -156,6 +222,7 @@ function $updateElementNodeProperties(target, source) {
   target.__dir = source.__dir;
   return target;
 }
+
 function $updateTextNodeProperties(target, source) {
   target.__format = source.__format;
   target.__style = source.__style;
@@ -163,28 +230,47 @@ function $updateTextNodeProperties(target, source) {
   target.__detail = source.__detail;
   return target;
 }
+/**
+ * Returns a copy of a node, but generates a new key for the copy.
+ * @param node - The node to be cloned.
+ * @returns The clone of the node.
+ */
+
+
 function $cloneWithProperties(node) {
   const latest = node.getLatest();
-  const constructor = latest.constructor;
-  // @ts-expect-error
+  const constructor = latest.constructor; // @ts-expect-error
+
   const clone = constructor.clone(latest);
   clone.__parent = latest.__parent;
   clone.__next = latest.__next;
   clone.__prev = latest.__prev;
+
   if (lexical.$isElementNode(latest) && lexical.$isElementNode(clone)) {
     return $updateElementNodeProperties(clone, latest);
   }
+
   if (lexical.$isTextNode(latest) && lexical.$isTextNode(clone)) {
     return $updateTextNodeProperties(clone, latest);
   }
+
   return clone;
 }
+/**
+ * Generally used to append text content to HTML and JSON. Grabs the text content and "slices"
+ * it to be generated into the new TextNode.
+ * @param selection - The selection containing the node whose TextNode is to be edited.
+ * @param textNode - The TextNode to be edited.
+ * @returns The updated TextNode.
+ */
+
 function $sliceSelectedTextNodeContent(selection, textNode) {
   if (textNode.isSelected() && !textNode.isSegmented() && !textNode.isToken() && (lexical.$isRangeSelection(selection) || lexical.DEPRECATED_$isGridSelection(selection))) {
     const anchorNode = selection.anchor.getNode();
     const focusNode = selection.focus.getNode();
     const isAnchor = textNode.is(anchorNode);
     const isFocus = textNode.is(focusNode);
+
     if (isAnchor || isFocus) {
       const isBackward = selection.isBackward();
       const [anchorOffset, focusOffset] = selection.getCharacterOffsets();
@@ -193,6 +279,7 @@ function $sliceSelectedTextNodeContent(selection, textNode) {
       const isLast = textNode.is(isBackward ? anchorNode : focusNode);
       let startOffset = 0;
       let endOffset = undefined;
+
       if (isSame) {
         startOffset = anchorOffset > focusOffset ? focusOffset : anchorOffset;
         endOffset = anchorOffset > focusOffset ? anchorOffset : focusOffset;
@@ -205,44 +292,71 @@ function $sliceSelectedTextNodeContent(selection, textNode) {
         startOffset = 0;
         endOffset = offset;
       }
+
       textNode.__text = textNode.__text.slice(startOffset, endOffset);
       return textNode;
     }
   }
+
   return textNode;
 }
+/**
+ * Determines if the current selection is at the end of the node.
+ * @param point - The point of the selection to test.
+ * @returns true if the provided point offset is in the last possible position, false otherwise.
+ */
+
 function $isAtNodeEnd(point) {
   if (point.type === 'text') {
     return point.offset === point.getNode().getTextContentSize();
   }
+
   return point.offset === point.getNode().getChildrenSize();
 }
+/**
+ * Trims text from a node in order to shorten it, eg. to enforce a text's max length. If it deletes text
+ * that is an ancestor of the anchor then it will leave 2 indents, otherwise, if no text content exists, it deletes
+ * the TextNode. It will move the focus to either the end of any left over text or beginning of a new TextNode.
+ * @param editor - The lexical editor.
+ * @param anchor - The anchor of the current selection, where the selection should be pointing.
+ * @param delCount - The amount of characters to delete. Useful as a dynamic variable eg. textContentSize - maxLength;
+ */
+
 function trimTextContentFromAnchor(editor, anchor, delCount) {
   // Work from the current selection anchor point
   let currentNode = anchor.getNode();
   let remaining = delCount;
+
   if (lexical.$isElementNode(currentNode)) {
     const descendantNode = currentNode.getDescendantByIndex(anchor.offset);
+
     if (descendantNode !== null) {
       currentNode = descendantNode;
     }
   }
+
   while (remaining > 0 && currentNode !== null) {
     let nextNode = currentNode.getPreviousSibling();
     let additionalElementWhitespace = 0;
+
     if (nextNode === null) {
       let parent = currentNode.getParentOrThrow();
       let parentSibling = parent.getPreviousSibling();
+
       while (parentSibling === null) {
         parent = parent.getParent();
+
         if (parent === null) {
           nextNode = null;
           break;
         }
+
         parentSibling = parent.getPreviousSibling();
       }
+
       if (parent !== null) {
         additionalElementWhitespace = parent.isInline() ? 0 : 2;
+
         if (lexical.$isElementNode(parentSibling)) {
           nextNode = parentSibling.getLastDescendant();
         } else {
@@ -250,37 +364,46 @@ function trimTextContentFromAnchor(editor, anchor, delCount) {
         }
       }
     }
-    let text = currentNode.getTextContent();
-    // If the text is empty, we need to consider adding in two line breaks to match
+
+    let text = currentNode.getTextContent(); // If the text is empty, we need to consider adding in two line breaks to match
     // the content if we were to get it from its parent.
+
     if (text === '' && lexical.$isElementNode(currentNode) && !currentNode.isInline()) {
       // TODO: should this be handled in core?
       text = '\n\n';
     }
-    const textNodeSize = text.length;
-    const offset = textNodeSize - remaining;
-    const slicedText = text.slice(0, offset);
-    if (!lexical.$isTextNode(currentNode) || remaining >= textNodeSize) {
+
+    const currentNodeSize = currentNode.getTextContentSize();
+
+    if (!lexical.$isTextNode(currentNode) || remaining >= currentNodeSize) {
       const parent = currentNode.getParent();
       currentNode.remove();
-      if (parent != null && parent.getChildrenSize() === 0) {
+
+      if (parent != null && parent.getChildrenSize() === 0 && !lexical.$isRootNode(parent)) {
         parent.remove();
       }
-      remaining -= textNodeSize + additionalElementWhitespace;
+
+      remaining -= currentNodeSize + additionalElementWhitespace;
       currentNode = nextNode;
     } else {
-      const key = currentNode.getKey();
-      // See if we can just revert it to what was in the last editor state
+      const key = currentNode.getKey(); // See if we can just revert it to what was in the last editor state
+
       const prevTextContent = editor.getEditorState().read(() => {
         const prevNode = lexical.$getNodeByKey(key);
+
         if (lexical.$isTextNode(prevNode) && prevNode.isSimpleText()) {
           return prevNode.getTextContent();
         }
+
         return null;
       });
+      const offset = currentNodeSize - remaining;
+      const slicedText = text.slice(0, offset);
+
       if (prevTextContent !== null && prevTextContent !== text) {
         const prevSelection = lexical.$getPreviousSelection();
         let target = currentNode;
+
         if (!currentNode.isSimpleText()) {
           const textNode = lexical.$createTextNode(prevTextContent);
           currentNode.replace(textNode);
@@ -288,6 +411,7 @@ function trimTextContentFromAnchor(editor, anchor, delCount) {
         } else {
           currentNode.setTextContent(prevTextContent);
         }
+
         if (lexical.$isRangeSelection(prevSelection) && prevSelection.isCollapsed()) {
           const prevOffset = prevSelection.anchor.offset;
           target.select(prevOffset, prevOffset);
@@ -295,14 +419,16 @@ function trimTextContentFromAnchor(editor, anchor, delCount) {
       } else if (currentNode.isSimpleText()) {
         // Split text
         const isSelected = anchor.key === key;
-        let anchorOffset = anchor.offset;
-        // Move offset to end if it's less than the remaniing number, otherwise
+        let anchorOffset = anchor.offset; // Move offset to end if it's less than the remaining number, otherwise
         // we'll have a negative splitStart.
+
         if (anchorOffset < remaining) {
-          anchorOffset = textNodeSize;
+          anchorOffset = currentNodeSize;
         }
+
         const splitStart = isSelected ? anchorOffset - remaining : 0;
         const splitEnd = isSelected ? anchorOffset : offset;
+
         if (isSelected && splitStart === 0) {
           const [excessNode] = currentNode.splitText(splitStart, splitEnd);
           excessNode.remove();
@@ -314,15 +440,22 @@ function trimTextContentFromAnchor(editor, anchor, delCount) {
         const textNode = lexical.$createTextNode(slicedText);
         currentNode.replace(textNode);
       }
+
       remaining = 0;
     }
   }
 }
+/**
+ * Gets the TextNode's style object and adds the styles to the CSS.
+ * @param node - The TextNode to add styles to.
+ */
+
 function $addNodeStyle(node) {
   const CSSText = node.getStyle();
   const styles = getStyleObjectFromRawCSS(CSSText);
   CSS_TO_STYLES.set(CSSText, styles);
 }
+
 function $patchStyle(target, patch) {
   const prevStyles = getStyleObjectFromCSS('getStyle' in target ? target.getStyle() : target.style);
   const newStyles = Object.entries(patch).reduce((styles, [key, value]) => {
@@ -331,24 +464,35 @@ function $patchStyle(target, patch) {
     } else {
       styles[key] = value;
     }
+
     return styles;
-  }, {
-    ...prevStyles
+  }, { ...prevStyles
   } || {});
   const newCSSText = getCSSFromStyleObject(newStyles);
   target.setStyle(newCSSText);
   CSS_TO_STYLES.set(newCSSText, newStyles);
 }
+/**
+ * Applies the provided styles to the TextNodes in the provided Selection.
+ * Will update partially selected TextNodes by splitting the TextNode and applying
+ * the styles to the appropriate one.
+ * @param selection - The selected node(s) to update.
+ * @param patch - The patch to apply, which can include multiple styles. { CSSProperty: value }
+ */
+
+
 function $patchStyleText(selection, patch) {
   const selectedNodes = selection.getNodes();
   const selectedNodesLength = selectedNodes.length;
   const lastIndex = selectedNodesLength - 1;
   let firstNode = selectedNodes[0];
   let lastNode = selectedNodes[lastIndex];
+
   if (selection.isCollapsed()) {
     $patchStyle(selection, patch);
     return;
   }
+
   const anchor = selection.anchor;
   const focus = selection.focus;
   const firstNodeText = firstNode.getTextContent();
@@ -360,32 +504,31 @@ function $patchStyleText(selection, patch) {
   let endOffset = isBefore ? focusOffset : anchorOffset;
   const startType = isBefore ? anchor.type : focus.type;
   const endType = isBefore ? focus.type : anchor.type;
-  const endKey = isBefore ? focus.key : anchor.key;
-
-  // This is the case where the user only selected the very end of the
+  const endKey = isBefore ? focus.key : anchor.key; // This is the case where the user only selected the very end of the
   // first node so we don't want to include it in the formatting change.
+
   if (lexical.$isTextNode(firstNode) && startOffset === firstNodeTextLength) {
     const nextSibling = firstNode.getNextSibling();
+
     if (lexical.$isTextNode(nextSibling)) {
       // we basically make the second node the firstNode, changing offsets accordingly
       anchorOffset = 0;
       startOffset = 0;
       firstNode = nextSibling;
     }
-  }
+  } // This is the case where we only selected a single node
+
 
-  // This is the case where we only selected a single node
-  if (firstNode.is(lastNode)) {
+  if (selectedNodes.length === 1) {
     if (lexical.$isTextNode(firstNode)) {
       startOffset = startType === 'element' ? 0 : anchorOffset > focusOffset ? focusOffset : anchorOffset;
-      endOffset = endType === 'element' ? firstNodeTextLength : anchorOffset > focusOffset ? anchorOffset : focusOffset;
+      endOffset = endType === 'element' ? firstNodeTextLength : anchorOffset > focusOffset ? anchorOffset : focusOffset; // No actual text is selected, so do nothing.
 
-      // No actual text is selected, so do nothing.
       if (startOffset === endOffset) {
         return;
-      }
+      } // The entire node is selected, so just format it
+
 
-      // The entire node is selected, so just format it
       if (startOffset === 0 && endOffset === firstNodeTextLength) {
         $patchStyle(firstNode, patch);
         firstNode.select(startOffset, endOffset);
@@ -398,6 +541,7 @@ function $patchStyleText(selection, patch) {
         replacement.select(0, endOffset - startOffset);
       }
     } // multiple nodes selected.
+
   } else {
     if (lexical.$isTextNode(firstNode) && startOffset < firstNode.getTextContentSize()) {
       if (startOffset !== 0) {
@@ -405,33 +549,36 @@ function $patchStyleText(selection, patch) {
         firstNode = firstNode.splitText(startOffset)[1];
         startOffset = 0;
       }
+
       $patchStyle(firstNode, patch);
     }
+
     if (lexical.$isTextNode(lastNode)) {
       const lastNodeText = lastNode.getTextContent();
-      const lastNodeTextLength = lastNodeText.length;
-
-      // The last node might not actually be the end node
+      const lastNodeTextLength = lastNodeText.length; // The last node might not actually be the end node
       //
       // If not, assume the last node is fully-selected unless the end offset is
       // zero.
+
       if (lastNode.__key !== endKey && endOffset !== 0) {
         endOffset = lastNodeTextLength;
-      }
+      } // if the entire last node isn't selected, split it
+
 
-      // if the entire last node isn't selected, split it
       if (endOffset !== lastNodeTextLength) {
         [lastNode] = lastNode.splitText(endOffset);
       }
+
       if (endOffset !== 0) {
         $patchStyle(lastNode, patch);
       }
-    }
+    } // style all the text nodes in between
+
 
-    // style all the text nodes in between
     for (let i = 1; i < lastIndex; i++) {
       const selectedNode = selectedNodes[i];
       const selectedNodeKey = selectedNode.getKey();
+
       if (lexical.$isTextNode(selectedNode) && selectedNodeKey !== firstNode.getKey() && selectedNodeKey !== lastNode.getKey() && !selectedNode.isToken()) {
         $patchStyle(selectedNode, patch);
       }
@@ -446,58 +593,98 @@ function $patchStyleText(selection, patch) {
  * LICENSE file in the root directory of this source tree.
  *
  */
-
 /**
- * Converts all nodes in the selection that are of one block type to another specified by parameter
- *
- * @param selection
- * @param createElement
- * @returns
+ * Converts all nodes in the selection that are of one block type to another.
+ * @param selection - The selected blocks to be converted.
+ * @param createElement - The function that creates the node. eg. $createParagraphNode.
  */
-function $setBlocksType_experimental(selection, createElement) {
+
+function $setBlocksType(selection, createElement) {
   if (selection.anchor.key === 'root') {
     const element = createElement();
     const root = lexical.$getRoot();
     const firstChild = root.getFirstChild();
-    if (firstChild) firstChild.replace(element, true);else root.append(element);
+
+    if (firstChild) {
+      firstChild.replace(element, true);
+    } else {
+      root.append(element);
+    }
+
     return;
   }
+
   const nodes = selection.getNodes();
-  if (selection.anchor.type === 'text') {
-    let firstBlock = selection.anchor.getNode().getParent();
-    firstBlock = firstBlock.isInline() ? firstBlock.getParent() : firstBlock;
-    if (nodes.indexOf(firstBlock) === -1) nodes.push(firstBlock);
+  let maybeBlock = selection.anchor.getNode().getParentOrThrow();
+
+  if (nodes.indexOf(maybeBlock) === -1) {
+    nodes.push(maybeBlock);
   }
+
+  if (maybeBlock.isInline()) {
+    maybeBlock = maybeBlock.getParentOrThrow();
+
+    if (nodes.indexOf(maybeBlock) === -1) {
+      nodes.push(maybeBlock);
+    }
+  }
+
   for (let i = 0; i < nodes.length; i++) {
     const node = nodes[i];
-    if (!isBlock(node)) continue;
+
+    if (!isBlock(node)) {
+      continue;
+    }
+
     const targetElement = createElement();
     targetElement.setFormat(node.getFormatType());
     targetElement.setIndent(node.getIndent());
     node.replace(targetElement, true);
   }
 }
+
 function isBlock(node) {
-  return lexical.$isElementNode(node) && !lexical.$isRootOrShadowRoot(node) && !node.isInline();
+  if (!lexical.$isElementNode(node) || lexical.$isRootOrShadowRoot(node)) {
+    return false;
+  }
+
+  const firstChild = node.getFirstChild();
+  const isLeafElement = firstChild === null || lexical.$isTextNode(firstChild) || firstChild.isInline();
+  return !node.isInline() && node.canBeEmpty() !== false && isLeafElement;
 }
+
 function isPointAttached(point) {
   return point.getNode().isAttached();
 }
+
 function $removeParentEmptyElements(startingNode) {
   let node = startingNode;
+
   while (node !== null && !lexical.$isRootOrShadowRoot(node)) {
     const latest = node.getLatest();
     const parentNode = node.getParent();
+
     if (latest.getChildrenSize() === 0) {
       node.remove(true);
     }
+
     node = parentNode;
   }
 }
+/**
+ * @deprecated
+ * Wraps all nodes in the selection into another node of the type returned by createElement.
+ * @param selection - The selection of nodes to be wrapped.
+ * @param createElement - A function that creates the wrapping ElementNode. eg. $createParagraphNode.
+ * @param wrappingElement - An element to append the wrapped selection and its children to.
+ */
+
+
 function $wrapNodes(selection, createElement, wrappingElement = null) {
   const nodes = selection.getNodes();
   const nodesLength = nodes.length;
   const anchor = selection.anchor;
+
   if (nodesLength === 0 || nodesLength === 1 && anchor.type === 'element' && anchor.getNode().getChildrenSize() === 0) {
     const target = anchor.type === 'text' ? anchor.getNode().getParentOrThrow() : anchor.getNode();
     const children = target.getChildren();
@@ -505,20 +692,24 @@ function $wrapNodes(selection, createElement, wrappingElement = null) {
     element.setFormat(target.getFormatType());
     element.setIndent(target.getIndent());
     children.forEach(child => element.append(child));
+
     if (wrappingElement) {
       element = wrappingElement.append(element);
     }
+
     target.replace(element);
     return;
   }
+
   let topLevelNode = null;
   let descendants = [];
+
   for (let i = 0; i < nodesLength; i++) {
-    const node = nodes[i];
-    // Determine whether wrapping has to be broken down into multiple chunks. This can happen if the
+    const node = nodes[i]; // Determine whether wrapping has to be broken down into multiple chunks. This can happen if the
     // user selected multiple Root-like nodes that have to be treated separately as if they are
     // their own branch. I.e. you don't want to wrap a whole table, but rather the contents of each
     // of each of the cell nodes.
+
     if (lexical.$isRootOrShadowRoot(node)) {
       $wrapNodesImpl(selection, descendants, descendants.length, createElement, wrappingElement);
       descendants = [];
@@ -530,69 +721,92 @@ function $wrapNodes(selection, createElement, wrappingElement = null) {
       descendants = [node];
     }
   }
+
   $wrapNodesImpl(selection, descendants, descendants.length, createElement, wrappingElement);
 }
+/**
+ * Wraps each node into a new ElementNode.
+ * @param selection - The selection of nodes to wrap.
+ * @param nodes - An array of nodes, generally the descendants of the selection.
+ * @param nodesLength - The length of nodes.
+ * @param createElement - A function that creates the wrapping ElementNode. eg. $createParagraphNode.
+ * @param wrappingElement - An element to wrap all the nodes into.
+ * @returns
+ */
+
 function $wrapNodesImpl(selection, nodes, nodesLength, createElement, wrappingElement = null) {
   if (nodes.length === 0) {
     return;
   }
+
   const firstNode = nodes[0];
   const elementMapping = new Map();
-  const elements = [];
-  // The below logic is to find the right target for us to
+  const elements = []; // The below logic is to find the right target for us to
   // either insertAfter/insertBefore/append the corresponding
   // elements to. This is made more complicated due to nested
   // structures.
+
   let target = lexical.$isElementNode(firstNode) ? firstNode : firstNode.getParentOrThrow();
+
   if (target.isInline()) {
     target = target.getParentOrThrow();
   }
+
   let targetIsPrevSibling = false;
+
   while (target !== null) {
     const prevSibling = target.getPreviousSibling();
+
     if (prevSibling !== null) {
       target = prevSibling;
       targetIsPrevSibling = true;
       break;
     }
+
     target = target.getParentOrThrow();
+
     if (lexical.$isRootOrShadowRoot(target)) {
       break;
     }
   }
-  const emptyElements = new Set();
 
-  // Find any top level empty elements
+  const emptyElements = new Set(); // Find any top level empty elements
+
   for (let i = 0; i < nodesLength; i++) {
     const node = nodes[i];
+
     if (lexical.$isElementNode(node) && node.getChildrenSize() === 0) {
       emptyElements.add(node.getKey());
     }
   }
-  const movedNodes = new Set();
 
-  // Move out all leaf nodes into our elements array.
+  const movedNodes = new Set(); // Move out all leaf nodes into our elements array.
   // If we find a top level empty element, also move make
   // an element for that.
+
   for (let i = 0; i < nodesLength; i++) {
     const node = nodes[i];
     let parent = node.getParent();
+
     if (parent !== null && parent.isInline()) {
       parent = parent.getParent();
     }
+
     if (parent !== null && lexical.$isLeafNode(node) && !movedNodes.has(node.getKey())) {
       const parentKey = parent.getKey();
+
       if (elementMapping.get(parentKey) === undefined) {
         const targetElement = createElement();
         targetElement.setFormat(parent.getFormatType());
         targetElement.setIndent(parent.getIndent());
         elements.push(targetElement);
-        elementMapping.set(parentKey, targetElement);
-        // Move node and its siblings to the new
+        elementMapping.set(parentKey, targetElement); // Move node and its siblings to the new
         // element.
+
         parent.getChildren().forEach(child => {
           targetElement.append(child);
           movedNodes.add(child.getKey());
+
           if (lexical.$isElementNode(child)) {
             // Skip nested leaf nodes if the parent has already been moved
             child.getChildrenKeys().forEach(key => movedNodes.add(key));
@@ -608,16 +822,17 @@ function $wrapNodesImpl(selection, nodes, nodesLength, createElement, wrappingEl
       node.remove(true);
     }
   }
+
   if (wrappingElement !== null) {
     for (let i = 0; i < elements.length; i++) {
       const element = elements[i];
       wrappingElement.append(element);
     }
   }
-  let lastElement = null;
 
-  // If our target is Root-like, let's see if we can re-adjust
+  let lastElement = null; // If our target is Root-like, let's see if we can re-adjust
   // so that the target is the first child instead.
+
   if (lexical.$isRootOrShadowRoot(target)) {
     if (targetIsPrevSibling) {
       if (wrappingElement !== null) {
@@ -630,9 +845,11 @@ function $wrapNodesImpl(selection, nodes, nodesLength, createElement, wrappingEl
       }
     } else {
       const firstChild = target.getFirstChild();
+
       if (lexical.$isElementNode(firstChild)) {
         target = firstChild;
       }
+
       if (firstChild === null) {
         if (wrappingElement) {
           target.append(wrappingElement);
@@ -666,7 +883,9 @@ function $wrapNodesImpl(selection, nodes, nodesLength, createElement, wrappingEl
       }
     }
   }
+
   const prevSelection = lexical.$getPreviousSelection();
+
   if (lexical.$isRangeSelection(prevSelection) && isPointAttached(prevSelection.anchor) && isPointAttached(prevSelection.focus)) {
     lexical.$setSelection(prevSelection.clone());
   } else if (lastElement !== null) {
@@ -675,22 +894,55 @@ function $wrapNodesImpl(selection, nodes, nodesLength, createElement, wrappingEl
     selection.dirty = true;
   }
 }
+/**
+ * Determines if the default character selection should be overridden. Used with DecoratorNodes
+ * @param selection - The selection whose default character selection may need to be overridden.
+ * @param isBackward - Is the selection backwards (the focus comes before the anchor)?
+ * @returns true if it should be overridden, false if not.
+ */
+
 function $shouldOverrideDefaultCharacterSelection(selection, isBackward) {
   const possibleNode = lexical.$getAdjacentNode(selection.focus, isBackward);
   return lexical.$isDecoratorNode(possibleNode) && !possibleNode.isIsolated() || lexical.$isElementNode(possibleNode) && !possibleNode.isInline() && !possibleNode.canBeEmpty();
 }
+/**
+ * Moves the selection according to the arguments.
+ * @param selection - The selected text or nodes.
+ * @param isHoldingShift - Is the shift key being held down during the operation.
+ * @param isBackward - Is the selection selected backwards (the focus comes before the anchor)?
+ * @param granularity - The distance to adjust the current selection.
+ */
+
 function $moveCaretSelection(selection, isHoldingShift, isBackward, granularity) {
   selection.modify(isHoldingShift ? 'extend' : 'move', isBackward, granularity);
 }
+/**
+ * Tests a parent element for right to left direction.
+ * @param selection - The selection whose parent is to be tested.
+ * @returns true if the selections' parent element has a direction of 'rtl' (right to left), false otherwise.
+ */
+
 function $isParentElementRTL(selection) {
   const anchorNode = selection.anchor.getNode();
   const parent = lexical.$isRootNode(anchorNode) ? anchorNode : anchorNode.getParentOrThrow();
   return parent.getDirection() === 'rtl';
 }
+/**
+ * Moves selection by character according to arguments.
+ * @param selection - The selection of the characters to move.
+ * @param isHoldingShift - Is the shift key being held down during the operation.
+ * @param isBackward - Is the selection backward (the focus comes before the anchor)?
+ */
+
 function $moveCharacter(selection, isHoldingShift, isBackward) {
   const isRTL = $isParentElementRTL(selection);
   $moveCaretSelection(selection, isHoldingShift, isBackward ? !isRTL : isRTL, 'character');
 }
+/**
+ * Expands the current Selection to cover all of the content in the editor.
+ * @param selection - The current selection.
+ */
+
 function $selectAll(selection) {
   const anchor = selection.anchor;
   const focus = selection.focus;
@@ -702,30 +954,53 @@ function $selectAll(selection) {
   let firstType = 'element';
   let lastType = 'element';
   let lastOffset = 0;
+
   if (lexical.$isTextNode(firstNode)) {
     firstType = 'text';
   } else if (!lexical.$isElementNode(firstNode) && firstNode !== null) {
     firstNode = firstNode.getParentOrThrow();
   }
+
   if (lexical.$isTextNode(lastNode)) {
     lastType = 'text';
     lastOffset = lastNode.getTextContentSize();
   } else if (!lexical.$isElementNode(lastNode) && lastNode !== null) {
     lastNode = lastNode.getParentOrThrow();
   }
+
   if (firstNode && lastNode) {
     anchor.set(firstNode.getKey(), 0, firstType);
     focus.set(lastNode.getKey(), lastOffset, lastType);
   }
 }
+/**
+ * Returns the current value of a CSS property for Nodes, if set. If not set, it returns the defaultValue.
+ * @param node - The node whose style value to get.
+ * @param styleProperty - The CSS style property.
+ * @param defaultValue - The default value for the property.
+ * @returns The value of the property for node.
+ */
+
 function $getNodeStyleValueForProperty(node, styleProperty, defaultValue) {
   const css = node.getStyle();
   const styleObject = getStyleObjectFromCSS(css);
+
   if (styleObject !== null) {
     return styleObject[styleProperty] || defaultValue;
   }
+
   return defaultValue;
 }
+/**
+ * Returns the current value of a CSS property for TextNodes in the Selection, if set. If not set, it returns the defaultValue.
+ * If all TextNodes do not have the same value, it returns an empty string.
+ * @param selection - The selection of TextNodes whose value to find.
+ * @param styleProperty - The CSS style property.
+ * @param defaultValue - The default value for the property, defaults to an empty string.
+ * @returns The value of the property for the selected TextNodes.
+ */
+
+
 function $getSelectionStyleValueForProperty(selection, styleProperty, defaultValue = '') {
   let styleValue = null;
   const nodes = selection.getNodes();
@@ -734,24 +1009,28 @@ function $getSelectionStyleValueForProperty(selection, styleProperty, defaultVal
   const isBackward = selection.isBackward();
   const endOffset = isBackward ? focus.offset : anchor.offset;
   const endNode = isBackward ? focus.getNode() : anchor.getNode();
+
   if (selection.style !== '') {
     const css = selection.style;
     const styleObject = getStyleObjectFromCSS(css);
+
     if (styleObject !== null && styleProperty in styleObject) {
       return styleObject[styleProperty];
     }
   }
-  for (let i = 0; i < nodes.length; i++) {
-    const node = nodes[i];
 
-    // if no actual characters in the end node are selected, we don't
+  for (let i = 0; i < nodes.length; i++) {
+    const node = nodes[i]; // if no actual characters in the end node are selected, we don't
     // include it in the selection for purposes of determining style
     // value
+
     if (i !== 0 && endOffset === 0 && node.is(endNode)) {
       continue;
     }
+
     if (lexical.$isTextNode(node)) {
       const nodeStyleValue = $getNodeStyleValueForProperty(node, styleProperty, defaultValue);
+
       if (styleValue === null) {
         styleValue = nodeStyleValue;
       } else if (styleValue !== nodeStyleValue) {
@@ -762,6 +1041,7 @@ function $getSelectionStyleValueForProperty(selection, styleProperty, defaultVal
       }
     }
   }
+
   return styleValue === null ? defaultValue : styleValue;
 }
 
@@ -774,7 +1054,7 @@ exports.$moveCaretSelection = $moveCaretSelection;
 exports.$moveCharacter = $moveCharacter;
 exports.$patchStyleText = $patchStyleText;
 exports.$selectAll = $selectAll;
-exports.$setBlocksType_experimental = $setBlocksType_experimental;
+exports.$setBlocksType = $setBlocksType;
 exports.$shouldOverrideDefaultCharacterSelection = $shouldOverrideDefaultCharacterSelection;
 exports.$sliceSelectedTextNodeContent = $sliceSelectedTextNodeContent;
 exports.$wrapNodes = $wrapNodes;

package/LexicalSelection.js.flow

@@ -49,7 +49,7 @@ declare export function $wrapNodes(
   createElement: () => ElementNode,
   wrappingElement?: ElementNode,
 ): void;
-declare export function $setBlocksType_experimental(
+declare export function $setBlocksType(
   selection: RangeSelection,
   createElement: () => ElementNode,
 ): void;

package/LexicalSelection.prod.js

@@ -4,25 +4,25 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-'use strict';var l=require("lexical");let u=new Map;function v(a){for(;null!=a;){if(a.nodeType===Node.TEXT_NODE)return a;a=a.firstChild}return null}function w(a){let b=a.parentNode;if(null==b)throw Error("Should never happen");return[b,Array.from(b.childNodes).indexOf(a)]}function y(a){let b={};a=a.split(";");for(let c of a)if(""!==c){let [f,d]=c.split(/:([^]+)/);b[f.trim()]=d.trim()}return b}function z(a){let b=u.get(a);void 0===b&&(b=y(a),u.set(a,b));return b}
-function A(a){let b="";for(let c in a)c&&(b+=`${c}: ${a[c]};`);return b}function B(a,b){var c=z("getStyle"in a?a.getStyle():a.style);b=Object.entries(b).reduce((f,[d,e])=>{null===e?delete f[d]:f[d]=e;return f},{...c});c=A(b);a.setStyle(c);u.set(c,b)}function C(a){for(;null!==a&&!l.$isRootOrShadowRoot(a);){let b=a.getLatest(),c=a.getParent();0===b.getChildrenSize()&&a.remove(!0);a=c}}
-function D(a,b,c,f,d=null){if(0!==b.length){var e=b[0],h=new Map,g=[];e=l.$isElementNode(e)?e:e.getParentOrThrow();e.isInline()&&(e=e.getParentOrThrow());for(var k=!1;null!==e;){var m=e.getPreviousSibling();if(null!==m){e=m;k=!0;break}e=e.getParentOrThrow();if(l.$isRootOrShadowRoot(e))break}m=new Set;for(var q=0;q<c;q++){var n=b[q];l.$isElementNode(n)&&0===n.getChildrenSize()&&m.add(n.getKey())}var p=new Set;for(q=0;q<c;q++){n=b[q];var r=n.getParent();null!==r&&r.isInline()&&(r=r.getParent());if(null!==
-r&&l.$isLeafNode(n)&&!p.has(n.getKey())){if(n=r.getKey(),void 0===h.get(n)){let t=f();t.setFormat(r.getFormatType());t.setIndent(r.getIndent());g.push(t);h.set(n,t);r.getChildren().forEach(x=>{t.append(x);p.add(x.getKey());l.$isElementNode(x)&&x.getChildrenKeys().forEach(G=>p.add(G))});C(r)}}else m.has(n.getKey())&&(r=f(),r.setFormat(n.getFormatType()),r.setIndent(n.getIndent()),g.push(r),n.remove(!0))}if(null!==d)for(b=0;b<g.length;b++)d.append(g[b]);b=null;if(l.$isRootOrShadowRoot(e))if(k)if(null!==
-d)e.insertAfter(d);else for(d=g.length-1;0<=d;d--)e.insertAfter(g[d]);else if(k=e.getFirstChild(),l.$isElementNode(k)&&(e=k),null===k)if(d)e.append(d);else for(d=0;d<g.length;d++)k=g[d],e.append(k),b=k;else if(null!==d)k.insertBefore(d);else for(e=0;e<g.length;e++)d=g[e],k.insertBefore(d),b=d;else if(d)e.insertAfter(d);else for(d=g.length-1;0<=d;d--)k=g[d],e.insertAfter(k),b=k;g=l.$getPreviousSelection();l.$isRangeSelection(g)&&g.anchor.getNode().isAttached()&&g.focus.getNode().isAttached()?l.$setSelection(g.clone()):
-null!==b?b.selectEnd():a.dirty=!0}}function E(a,b,c,f){a.modify(b?"extend":"move",c,f)}function F(a){a=a.anchor.getNode();return"rtl"===(l.$isRootNode(a)?a:a.getParentOrThrow()).getDirection()}exports.$addNodeStyle=function(a){a=a.getStyle();let b=y(a);u.set(a,b)};
-exports.$cloneWithProperties=function(a){a=a.getLatest();let b=a.constructor.clone(a);b.__parent=a.__parent;b.__next=a.__next;b.__prev=a.__prev;if(l.$isElementNode(a)&&l.$isElementNode(b))return b.__first=a.__first,b.__last=a.__last,b.__size=a.__size,b.__format=a.__format,b.__indent=a.__indent,b.__dir=a.__dir,b;l.$isTextNode(a)&&l.$isTextNode(b)&&(b.__format=a.__format,b.__style=a.__style,b.__mode=a.__mode,b.__detail=a.__detail);return b};
-exports.$getSelectionStyleValueForProperty=function(a,b,c=""){let f=null,d=a.getNodes();var e=a.anchor,h=a.focus,g=a.isBackward();let k=g?h.offset:e.offset;e=g?h.getNode():e.getNode();if(""!==a.style&&(a=z(a.style),null!==a&&b in a))return a[b];for(a=0;a<d.length;a++){var m=d[a];if((0===a||0!==k||!m.is(e))&&l.$isTextNode(m))if(h=b,g=c,m=m.getStyle(),m=z(m),h=null!==m?m[h]||g:g,null===f)f=h;else if(f!==h){f="";break}}return null===f?c:f};
-exports.$isAtNodeEnd=function(a){return"text"===a.type?a.offset===a.getNode().getTextContentSize():a.offset===a.getNode().getChildrenSize()};exports.$isParentElementRTL=F;exports.$moveCaretSelection=E;exports.$moveCharacter=function(a,b,c){let f=F(a);E(a,b,c?!f:f,"character")};
-exports.$patchStyleText=function(a,b){var c=a.getNodes();let f=c.length-1,d=c[0],e=c[f];if(a.isCollapsed())B(a,b);else{var h=a.anchor,g=a.focus,k=d.getTextContent().length,m=g.offset,q=h.offset,n=h.isBefore(g),p=n?q:m;a=n?m:q;var r=n?h.type:g.type,t=n?g.type:h.type;h=n?g.key:h.key;l.$isTextNode(d)&&p===k&&(g=d.getNextSibling(),l.$isTextNode(g)&&(p=q=0,d=g));if(d.is(e))l.$isTextNode(d)&&(p="element"===r?0:q>m?m:q,a="element"===t?k:q>m?q:m,p!==a&&(0===p&&a===k?(B(d,b),d.select(p,a)):(c=d.splitText(p,
-a),c=0===p?c[0]:c[1],B(c,b),c.select(0,a-p))));else for(l.$isTextNode(d)&&p<d.getTextContentSize()&&(0!==p&&(d=d.splitText(p)[1]),B(d,b)),l.$isTextNode(e)&&(p=e.getTextContent().length,e.__key!==h&&0!==a&&(a=p),a!==p&&([e]=e.splitText(a)),0!==a&&B(e,b)),a=1;a<f;a++)p=c[a],k=p.getKey(),l.$isTextNode(p)&&k!==d.getKey()&&k!==e.getKey()&&!p.isToken()&&B(p,b)}};
-exports.$selectAll=function(a){let b=a.anchor;a=a.focus;var c=b.getNode().getTopLevelElementOrThrow().getParentOrThrow();let f=c.getFirstDescendant();c=c.getLastDescendant();let d="element",e="element",h=0;l.$isTextNode(f)?d="text":l.$isElementNode(f)||null===f||(f=f.getParentOrThrow());l.$isTextNode(c)?(e="text",h=c.getTextContentSize()):l.$isElementNode(c)||null===c||(c=c.getParentOrThrow());f&&c&&(b.set(f.getKey(),0,d),a.set(c.getKey(),h,e))};
-exports.$setBlocksType_experimental=function(a,b){if("root"===a.anchor.key){b=b();var c=l.$getRoot();(a=c.getFirstChild())?a.replace(b,!0):c.append(b)}else for(c=a.getNodes(),"text"===a.anchor.type&&(a=a.anchor.getNode().getParent(),a=a.isInline()?a.getParent():a,-1===c.indexOf(a)&&c.push(a)),a=0;a<c.length;a++){let d=c[a];var f=d;!l.$isElementNode(f)||l.$isRootOrShadowRoot(f)||f.isInline()||(f=b(),f.setFormat(d.getFormatType()),f.setIndent(d.getIndent()),d.replace(f,!0))}};
-exports.$shouldOverrideDefaultCharacterSelection=function(a,b){a=l.$getAdjacentNode(a.focus,b);return l.$isDecoratorNode(a)&&!a.isIsolated()||l.$isElementNode(a)&&!a.isInline()&&!a.canBeEmpty()};
-exports.$sliceSelectedTextNodeContent=function(a,b){if(b.isSelected()&&!b.isSegmented()&&!b.isToken()&&(l.$isRangeSelection(a)||l.DEPRECATED_$isGridSelection(a))){var c=a.anchor.getNode(),f=a.focus.getNode(),d=b.is(c),e=b.is(f);if(d||e){d=a.isBackward();let [h,g]=a.getCharacterOffsets();a=c.is(f);e=b.is(d?f:c);f=b.is(d?c:f);c=0;let k=void 0;a?(c=h>g?g:h,k=h>g?h:g):e?(c=d?g:h,k=void 0):f&&(d=d?h:g,c=0,k=d);b.__text=b.__text.slice(c,k)}}return b};
-exports.$wrapNodes=function(a,b,c=null){var f=a.getNodes();let d=f.length;var e=a.anchor;if(0===d||1===d&&"element"===e.type&&0===e.getNode().getChildrenSize()){a="text"===e.type?e.getNode().getParentOrThrow():e.getNode();f=a.getChildren();let g=b();g.setFormat(a.getFormatType());g.setIndent(a.getIndent());f.forEach(k=>g.append(k));c&&(g=c.append(g));a.replace(g)}else{e=null;var h=[];for(let g=0;g<d;g++){let k=f[g];l.$isRootOrShadowRoot(k)?(D(a,h,h.length,b,c),h=[],e=k):null===e||null!==e&&l.$hasAncestor(k,
-e)?h.push(k):(D(a,h,h.length,b,c),h=[k])}D(a,h,h.length,b,c)}};
-exports.createDOMRange=function(a,b,c,f,d){let e=b.getKey(),h=f.getKey(),g=document.createRange(),k=a.getElementByKey(e);a=a.getElementByKey(h);l.$isTextNode(b)&&(k=v(k));l.$isTextNode(f)&&(a=v(a));if(void 0===b||void 0===f||null===k||null===a)return null;"BR"===k.nodeName&&([k,c]=w(k));"BR"===a.nodeName&&([a,d]=w(a));b=k.firstChild;k===a&&null!=b&&"BR"===b.nodeName&&0===c&&0===d&&(d=1);try{g.setStart(k,c),g.setEnd(a,d)}catch(m){return null}!g.collapsed||c===d&&e===h||(g.setStart(a,d),g.setEnd(k,
-c));return g};exports.createRectsFromDOMRange=function(a,b){var c=a.getRootElement();if(null===c)return[];a=c.getBoundingClientRect();c=getComputedStyle(c);c=parseFloat(c.paddingLeft)+parseFloat(c.paddingRight);b=Array.from(b.getClientRects());let f=b.length,d;for(let e=0;e<f;e++){let h=b[e],g=h.width+c===a.width;d&&d.top===h.top&&d.left===h.left&&d.width===h.width&&d.height===h.height||g?(b.splice(e--,1),f--):d=h}return b};exports.getStyleObjectFromCSS=z;
-exports.trimTextContentFromAnchor=function(a,b,c){let f=b.getNode();if(l.$isElementNode(f)){var d=f.getDescendantByIndex(b.offset);null!==d&&(f=d)}for(;0<c&&null!==f;){var e=f.getPreviousSibling(),h=0;if(null===e){d=f.getParentOrThrow();for(var g=d.getPreviousSibling();null===g;){d=d.getParent();if(null===d){e=null;break}g=d.getPreviousSibling()}null!==d&&(h=d.isInline()?0:2,e=l.$isElementNode(g)?g.getLastDescendant():g)}let k=f.getTextContent();""===k&&l.$isElementNode(f)&&!f.isInline()&&(k="\n\n");
-d=k.length;g=d-c;let m=k.slice(0,g);if(!l.$isTextNode(f)||c>=d)g=f.getParent(),f.remove(),null!=g&&0===g.getChildrenSize()&&g.remove(),c-=d+h,f=e;else{let q=f.getKey();e=a.getEditorState().read(()=>{const n=l.$getNodeByKey(q);return l.$isTextNode(n)&&n.isSimpleText()?n.getTextContent():null});null!==e&&e!==k?(c=l.$getPreviousSelection(),d=f,f.isSimpleText()?f.setTextContent(e):(d=l.$createTextNode(e),f.replace(d)),l.$isRangeSelection(c)&&c.isCollapsed()&&(c=c.anchor.offset,d.select(c,c))):f.isSimpleText()?
-(e=b.key===q,h=b.offset,h<c&&(h=d),c=e?h-c:0,d=e?h:g,e&&0===c?([c]=f.splitText(c,d),c.remove()):([,c]=f.splitText(c,d),c.remove())):(c=l.$createTextNode(m),f.replace(c));c=0}}}
+'use strict';var k=require("lexical");let u=new Map;function v(a){for(;null!=a;){if(a.nodeType===Node.TEXT_NODE)return a;a=a.firstChild}return null}function w(a){let b=a.parentNode;if(null==b)throw Error("Should never happen");return[b,Array.from(b.childNodes).indexOf(a)]}function y(a){let b={};a=a.split(";");for(let c of a)if(""!==c){let [e,d]=c.split(/:([^]+)/);b[e.trim()]=d.trim()}return b}function z(a){let b=u.get(a);void 0===b&&(b=y(a),u.set(a,b));return b}
+function A(a){let b="";for(let c in a)c&&(b+=`${c}: ${a[c]};`);return b}function B(a,b){var c=z("getStyle"in a?a.getStyle():a.style);b=Object.entries(b).reduce((e,[d,f])=>{null===f?delete e[d]:e[d]=f;return e},{...c});c=A(b);a.setStyle(c);u.set(c,b)}function C(a){for(;null!==a&&!k.$isRootOrShadowRoot(a);){let b=a.getLatest(),c=a.getParent();0===b.getChildrenSize()&&a.remove(!0);a=c}}
+function D(a,b,c,e,d=null){if(0!==b.length){var f=b[0],h=new Map,g=[];f=k.$isElementNode(f)?f:f.getParentOrThrow();f.isInline()&&(f=f.getParentOrThrow());for(var l=!1;null!==f;){var m=f.getPreviousSibling();if(null!==m){f=m;l=!0;break}f=f.getParentOrThrow();if(k.$isRootOrShadowRoot(f))break}m=new Set;for(var q=0;q<c;q++){var p=b[q];k.$isElementNode(p)&&0===p.getChildrenSize()&&m.add(p.getKey())}var n=new Set;for(q=0;q<c;q++){p=b[q];var r=p.getParent();null!==r&&r.isInline()&&(r=r.getParent());if(null!==
+r&&k.$isLeafNode(p)&&!n.has(p.getKey())){if(p=r.getKey(),void 0===h.get(p)){let t=e();t.setFormat(r.getFormatType());t.setIndent(r.getIndent());g.push(t);h.set(p,t);r.getChildren().forEach(x=>{t.append(x);n.add(x.getKey());k.$isElementNode(x)&&x.getChildrenKeys().forEach(G=>n.add(G))});C(r)}}else m.has(p.getKey())&&(r=e(),r.setFormat(p.getFormatType()),r.setIndent(p.getIndent()),g.push(r),p.remove(!0))}if(null!==d)for(b=0;b<g.length;b++)d.append(g[b]);b=null;if(k.$isRootOrShadowRoot(f))if(l)if(null!==
+d)f.insertAfter(d);else for(d=g.length-1;0<=d;d--)f.insertAfter(g[d]);else if(l=f.getFirstChild(),k.$isElementNode(l)&&(f=l),null===l)if(d)f.append(d);else for(d=0;d<g.length;d++)l=g[d],f.append(l),b=l;else if(null!==d)l.insertBefore(d);else for(f=0;f<g.length;f++)d=g[f],l.insertBefore(d),b=d;else if(d)f.insertAfter(d);else for(d=g.length-1;0<=d;d--)l=g[d],f.insertAfter(l),b=l;g=k.$getPreviousSelection();k.$isRangeSelection(g)&&g.anchor.getNode().isAttached()&&g.focus.getNode().isAttached()?k.$setSelection(g.clone()):
+null!==b?b.selectEnd():a.dirty=!0}}function E(a,b,c,e){a.modify(b?"extend":"move",c,e)}function F(a){a=a.anchor.getNode();return"rtl"===(k.$isRootNode(a)?a:a.getParentOrThrow()).getDirection()}exports.$addNodeStyle=function(a){a=a.getStyle();let b=y(a);u.set(a,b)};
+exports.$cloneWithProperties=function(a){a=a.getLatest();let b=a.constructor.clone(a);b.__parent=a.__parent;b.__next=a.__next;b.__prev=a.__prev;if(k.$isElementNode(a)&&k.$isElementNode(b))return b.__first=a.__first,b.__last=a.__last,b.__size=a.__size,b.__format=a.__format,b.__indent=a.__indent,b.__dir=a.__dir,b;k.$isTextNode(a)&&k.$isTextNode(b)&&(b.__format=a.__format,b.__style=a.__style,b.__mode=a.__mode,b.__detail=a.__detail);return b};
+exports.$getSelectionStyleValueForProperty=function(a,b,c=""){let e=null,d=a.getNodes();var f=a.anchor,h=a.focus,g=a.isBackward();let l=g?h.offset:f.offset;f=g?h.getNode():f.getNode();if(""!==a.style&&(a=z(a.style),null!==a&&b in a))return a[b];for(a=0;a<d.length;a++){var m=d[a];if((0===a||0!==l||!m.is(f))&&k.$isTextNode(m))if(h=b,g=c,m=m.getStyle(),m=z(m),h=null!==m?m[h]||g:g,null===e)e=h;else if(e!==h){e="";break}}return null===e?c:e};
+exports.$isAtNodeEnd=function(a){return"text"===a.type?a.offset===a.getNode().getTextContentSize():a.offset===a.getNode().getChildrenSize()};exports.$isParentElementRTL=F;exports.$moveCaretSelection=E;exports.$moveCharacter=function(a,b,c){let e=F(a);E(a,b,c?!e:e,"character")};
+exports.$patchStyleText=function(a,b){var c=a.getNodes();let e=c.length-1,d=c[0],f=c[e];if(a.isCollapsed())B(a,b);else{var h=a.anchor,g=a.focus,l=d.getTextContent().length,m=g.offset,q=h.offset,p=h.isBefore(g),n=p?q:m;a=p?m:q;var r=p?h.type:g.type,t=p?g.type:h.type;h=p?g.key:h.key;k.$isTextNode(d)&&n===l&&(g=d.getNextSibling(),k.$isTextNode(g)&&(n=q=0,d=g));if(1===c.length)k.$isTextNode(d)&&(n="element"===r?0:q>m?m:q,a="element"===t?l:q>m?q:m,n!==a&&(0===n&&a===l?(B(d,b),d.select(n,a)):(c=d.splitText(n,
+a),c=0===n?c[0]:c[1],B(c,b),c.select(0,a-n))));else for(k.$isTextNode(d)&&n<d.getTextContentSize()&&(0!==n&&(d=d.splitText(n)[1]),B(d,b)),k.$isTextNode(f)&&(n=f.getTextContent().length,f.__key!==h&&0!==a&&(a=n),a!==n&&([f]=f.splitText(a)),0!==a&&B(f,b)),a=1;a<e;a++)n=c[a],l=n.getKey(),k.$isTextNode(n)&&l!==d.getKey()&&l!==f.getKey()&&!n.isToken()&&B(n,b)}};
+exports.$selectAll=function(a){let b=a.anchor;a=a.focus;var c=b.getNode().getTopLevelElementOrThrow().getParentOrThrow();let e=c.getFirstDescendant();c=c.getLastDescendant();let d="element",f="element",h=0;k.$isTextNode(e)?d="text":k.$isElementNode(e)||null===e||(e=e.getParentOrThrow());k.$isTextNode(c)?(f="text",h=c.getTextContentSize()):k.$isElementNode(c)||null===c||(c=c.getParentOrThrow());e&&c&&(b.set(e.getKey(),0,d),a.set(c.getKey(),h,f))};
+exports.$setBlocksType=function(a,b){if("root"===a.anchor.key){b=b();var c=k.$getRoot();(a=c.getFirstChild())?a.replace(b,!0):c.append(b)}else for(c=a.getNodes(),a=a.anchor.getNode().getParentOrThrow(),-1===c.indexOf(a)&&c.push(a),a.isInline()&&(a=a.getParentOrThrow(),-1===c.indexOf(a)&&c.push(a)),a=0;a<c.length;a++){let f=c[a];var e=f;if(!k.$isElementNode(e)||k.$isRootOrShadowRoot(e))e=!1;else{var d=e.getFirstChild();d=null===d||k.$isTextNode(d)||d.isInline();e=!e.isInline()&&!1!==e.canBeEmpty()&&
+d}e&&(e=b(),e.setFormat(f.getFormatType()),e.setIndent(f.getIndent()),f.replace(e,!0))}};exports.$shouldOverrideDefaultCharacterSelection=function(a,b){a=k.$getAdjacentNode(a.focus,b);return k.$isDecoratorNode(a)&&!a.isIsolated()||k.$isElementNode(a)&&!a.isInline()&&!a.canBeEmpty()};
+exports.$sliceSelectedTextNodeContent=function(a,b){if(b.isSelected()&&!b.isSegmented()&&!b.isToken()&&(k.$isRangeSelection(a)||k.DEPRECATED_$isGridSelection(a))){var c=a.anchor.getNode(),e=a.focus.getNode(),d=b.is(c),f=b.is(e);if(d||f){d=a.isBackward();let [h,g]=a.getCharacterOffsets();a=c.is(e);f=b.is(d?e:c);e=b.is(d?c:e);c=0;let l=void 0;a?(c=h>g?g:h,l=h>g?h:g):f?(c=d?g:h,l=void 0):e&&(d=d?h:g,c=0,l=d);b.__text=b.__text.slice(c,l)}}return b};
+exports.$wrapNodes=function(a,b,c=null){var e=a.getNodes();let d=e.length;var f=a.anchor;if(0===d||1===d&&"element"===f.type&&0===f.getNode().getChildrenSize()){a="text"===f.type?f.getNode().getParentOrThrow():f.getNode();e=a.getChildren();let g=b();g.setFormat(a.getFormatType());g.setIndent(a.getIndent());e.forEach(l=>g.append(l));c&&(g=c.append(g));a.replace(g)}else{f=null;var h=[];for(let g=0;g<d;g++){let l=e[g];k.$isRootOrShadowRoot(l)?(D(a,h,h.length,b,c),h=[],f=l):null===f||null!==f&&k.$hasAncestor(l,
+f)?h.push(l):(D(a,h,h.length,b,c),h=[l])}D(a,h,h.length,b,c)}};
+exports.createDOMRange=function(a,b,c,e,d){let f=b.getKey(),h=e.getKey(),g=document.createRange(),l=a.getElementByKey(f);a=a.getElementByKey(h);k.$isTextNode(b)&&(l=v(l));k.$isTextNode(e)&&(a=v(a));if(void 0===b||void 0===e||null===l||null===a)return null;"BR"===l.nodeName&&([l,c]=w(l));"BR"===a.nodeName&&([a,d]=w(a));b=l.firstChild;l===a&&null!=b&&"BR"===b.nodeName&&0===c&&0===d&&(d=1);try{g.setStart(l,c),g.setEnd(a,d)}catch(m){return null}!g.collapsed||c===d&&f===h||(g.setStart(a,d),g.setEnd(l,
+c));return g};exports.createRectsFromDOMRange=function(a,b){var c=a.getRootElement();if(null===c)return[];a=c.getBoundingClientRect();c=getComputedStyle(c);c=parseFloat(c.paddingLeft)+parseFloat(c.paddingRight);b=Array.from(b.getClientRects());let e=b.length,d;for(let f=0;f<e;f++){let h=b[f],g=h.width+c===a.width;d&&d.top===h.top&&d.left===h.left&&d.width===h.width&&d.height===h.height||g?(b.splice(f--,1),e--):d=h}return b};exports.getStyleObjectFromCSS=z;
+exports.trimTextContentFromAnchor=function(a,b,c){let e=b.getNode();if(k.$isElementNode(e)){var d=e.getDescendantByIndex(b.offset);null!==d&&(e=d)}for(;0<c&&null!==e;){var f=e.getPreviousSibling(),h=0;if(null===f){d=e.getParentOrThrow();for(var g=d.getPreviousSibling();null===g;){d=d.getParent();if(null===d){f=null;break}g=d.getPreviousSibling()}null!==d&&(h=d.isInline()?0:2,f=k.$isElementNode(g)?g.getLastDescendant():g)}g=e.getTextContent();""===g&&k.$isElementNode(e)&&!e.isInline()&&(g="\n\n");
+d=e.getTextContentSize();if(!k.$isTextNode(e)||c>=d)g=e.getParent(),e.remove(),null==g||0!==g.getChildrenSize()||k.$isRootNode(g)||g.remove(),c-=d+h,e=f;else{let l=e.getKey();h=a.getEditorState().read(()=>{const q=k.$getNodeByKey(l);return k.$isTextNode(q)&&q.isSimpleText()?q.getTextContent():null});f=d-c;let m=g.slice(0,f);null!==h&&h!==g?(c=k.$getPreviousSelection(),d=e,e.isSimpleText()?e.setTextContent(h):(d=k.$createTextNode(h),e.replace(d)),k.$isRangeSelection(c)&&c.isCollapsed()&&(c=c.anchor.offset,
+d.select(c,c))):e.isSimpleText()?(h=b.key===l,g=b.offset,g<c&&(g=d),c=h?g-c:0,d=h?g:f,h&&0===c?([c]=e.splitText(c,d),c.remove()):([,c]=e.splitText(c,d),c.remove())):(c=k.$createTextNode(m),e.replace(c));c=0}}}

package/README.md

@@ -81,12 +81,12 @@ Expands the current Selection to cover all of the content in the editor.
 export function $selectAll(selection: RangeSelection): void;
 ```
 
-#### `$setBlocksType_experimental`
+#### `$setBlocksType`
 
 Converts all nodes in the selection that are of one block type to another specified by parameter
 
 ```ts
-export function $setBlocksType_experimental(
+export function $setBlocksType(
   selection: RangeSelection,
   createElement: () => ElementNode,
 ): void;

package/index.d.ts

@@ -7,8 +7,8 @@
  *
  */
 import { $addNodeStyle, $cloneWithProperties, $isAtNodeEnd, $patchStyleText, $sliceSelectedTextNodeContent, trimTextContentFromAnchor } from './lexical-node';
-import { $getSelectionStyleValueForProperty, $isParentElementRTL, $moveCaretSelection, $moveCharacter, $selectAll, $setBlocksType_experimental, $shouldOverrideDefaultCharacterSelection, $wrapNodes } from './range-selection';
+import { $getSelectionStyleValueForProperty, $isParentElementRTL, $moveCaretSelection, $moveCharacter, $selectAll, $setBlocksType, $shouldOverrideDefaultCharacterSelection, $wrapNodes } from './range-selection';
 import { createDOMRange, createRectsFromDOMRange, getStyleObjectFromCSS } from './utils';
 export { $addNodeStyle, $cloneWithProperties, $isAtNodeEnd, $patchStyleText, $sliceSelectedTextNodeContent, trimTextContentFromAnchor, };
-export { $getSelectionStyleValueForProperty, $isParentElementRTL, $moveCaretSelection, $moveCharacter, $selectAll, $setBlocksType_experimental, $shouldOverrideDefaultCharacterSelection, $wrapNodes, };
+export { $getSelectionStyleValueForProperty, $isParentElementRTL, $moveCaretSelection, $moveCharacter, $selectAll, $setBlocksType, $shouldOverrideDefaultCharacterSelection, $wrapNodes, };
 export { createDOMRange, createRectsFromDOMRange, getStyleObjectFromCSS };

package/lexical-node.d.ts

@@ -6,9 +6,45 @@
  *
  */
 import type { GridSelection, LexicalEditor, LexicalNode, NodeSelection, Point, RangeSelection, TextNode } from 'lexical';
+/**
+ * Returns a copy of a node, but generates a new key for the copy.
+ * @param node - The node to be cloned.
+ * @returns The clone of the node.
+ */
 export declare function $cloneWithProperties<T extends LexicalNode>(node: T): T;
+/**
+ * Generally used to append text content to HTML and JSON. Grabs the text content and "slices"
+ * it to be generated into the new TextNode.
+ * @param selection - The selection containing the node whose TextNode is to be edited.
+ * @param textNode - The TextNode to be edited.
+ * @returns The updated TextNode.
+ */
 export declare function $sliceSelectedTextNodeContent(selection: RangeSelection | GridSelection | NodeSelection, textNode: TextNode): LexicalNode;
+/**
+ * Determines if the current selection is at the end of the node.
+ * @param point - The point of the selection to test.
+ * @returns true if the provided point offset is in the last possible position, false otherwise.
+ */
 export declare function $isAtNodeEnd(point: Point): boolean;
+/**
+ * Trims text from a node in order to shorten it, eg. to enforce a text's max length. If it deletes text
+ * that is an ancestor of the anchor then it will leave 2 indents, otherwise, if no text content exists, it deletes
+ * the TextNode. It will move the focus to either the end of any left over text or beginning of a new TextNode.
+ * @param editor - The lexical editor.
+ * @param anchor - The anchor of the current selection, where the selection should be pointing.
+ * @param delCount - The amount of characters to delete. Useful as a dynamic variable eg. textContentSize - maxLength;
+ */
 export declare function trimTextContentFromAnchor(editor: LexicalEditor, anchor: Point, delCount: number): void;
+/**
+ * Gets the TextNode's style object and adds the styles to the CSS.
+ * @param node - The TextNode to add styles to.
+ */
 export declare function $addNodeStyle(node: TextNode): void;
+/**
+ * Applies the provided styles to the TextNodes in the provided Selection.
+ * Will update partially selected TextNodes by splitting the TextNode and applying
+ * the styles to the appropriate one.
+ * @param selection - The selected node(s) to update.
+ * @param patch - The patch to apply, which can include multiple styles. { CSSProperty: value }
+ */
 export declare function $patchStyleText(selection: RangeSelection, patch: Record<string, string | null>): void;

package/package.json

@@ -9,10 +9,10 @@
     "selection"
   ],
   "license": "MIT",
-  "version": "0.8.1",
+  "version": "0.9.1",
   "main": "LexicalSelection.js",
   "peerDependencies": {
-    "lexical": "0.8.1"
+    "lexical": "0.9.1"
   },
   "repository": {
     "type": "git",

package/range-selection.d.ts

@@ -7,18 +7,68 @@
  */
 import type { ElementNode, GridSelection, LexicalNode, RangeSelection } from 'lexical';
 /**
- * Converts all nodes in the selection that are of one block type to another specified by parameter
- *
- * @param selection
- * @param createElement
- * @returns
+ * Converts all nodes in the selection that are of one block type to another.
+ * @param selection - The selected blocks to be converted.
+ * @param createElement - The function that creates the node. eg. $createParagraphNode.
+ */
+export declare function $setBlocksType(selection: RangeSelection | GridSelection, createElement: () => ElementNode): void;
+/**
+ * @deprecated
+ * Wraps all nodes in the selection into another node of the type returned by createElement.
+ * @param selection - The selection of nodes to be wrapped.
+ * @param createElement - A function that creates the wrapping ElementNode. eg. $createParagraphNode.
+ * @param wrappingElement - An element to append the wrapped selection and its children to.
  */
-export declare function $setBlocksType_experimental(selection: RangeSelection | GridSelection, createElement: () => ElementNode): void;
 export declare function $wrapNodes(selection: RangeSelection | GridSelection, createElement: () => ElementNode, wrappingElement?: null | ElementNode): void;
+/**
+ * Wraps each node into a new ElementNode.
+ * @param selection - The selection of nodes to wrap.
+ * @param nodes - An array of nodes, generally the descendants of the selection.
+ * @param nodesLength - The length of nodes.
+ * @param createElement - A function that creates the wrapping ElementNode. eg. $createParagraphNode.
+ * @param wrappingElement - An element to wrap all the nodes into.
+ * @returns
+ */
 export declare function $wrapNodesImpl(selection: RangeSelection | GridSelection, nodes: LexicalNode[], nodesLength: number, createElement: () => ElementNode, wrappingElement?: null | ElementNode): void;
+/**
+ * Determines if the default character selection should be overridden. Used with DecoratorNodes
+ * @param selection - The selection whose default character selection may need to be overridden.
+ * @param isBackward - Is the selection backwards (the focus comes before the anchor)?
+ * @returns true if it should be overridden, false if not.
+ */
 export declare function $shouldOverrideDefaultCharacterSelection(selection: RangeSelection, isBackward: boolean): boolean;
+/**
+ * Moves the selection according to the arguments.
+ * @param selection - The selected text or nodes.
+ * @param isHoldingShift - Is the shift key being held down during the operation.
+ * @param isBackward - Is the selection selected backwards (the focus comes before the anchor)?
+ * @param granularity - The distance to adjust the current selection.
+ */
 export declare function $moveCaretSelection(selection: RangeSelection, isHoldingShift: boolean, isBackward: boolean, granularity: 'character' | 'word' | 'lineboundary'): void;
+/**
+ * Tests a parent element for right to left direction.
+ * @param selection - The selection whose parent is to be tested.
+ * @returns true if the selections' parent element has a direction of 'rtl' (right to left), false otherwise.
+ */
 export declare function $isParentElementRTL(selection: RangeSelection): boolean;
+/**
+ * Moves selection by character according to arguments.
+ * @param selection - The selection of the characters to move.
+ * @param isHoldingShift - Is the shift key being held down during the operation.
+ * @param isBackward - Is the selection backward (the focus comes before the anchor)?
+ */
 export declare function $moveCharacter(selection: RangeSelection, isHoldingShift: boolean, isBackward: boolean): void;
+/**
+ * Expands the current Selection to cover all of the content in the editor.
+ * @param selection - The current selection.
+ */
 export declare function $selectAll(selection: RangeSelection): void;
+/**
+ * Returns the current value of a CSS property for TextNodes in the Selection, if set. If not set, it returns the defaultValue.
+ * If all TextNodes do not have the same value, it returns an empty string.
+ * @param selection - The selection of TextNodes whose value to find.
+ * @param styleProperty - The CSS style property.
+ * @param defaultValue - The default value for the property, defaults to an empty string.
+ * @returns The value of the property for the selected TextNodes.
+ */
 export declare function $getSelectionStyleValueForProperty(selection: RangeSelection, styleProperty: string, defaultValue?: string): string;

package/utils.d.ts

@@ -6,8 +6,38 @@
  *
  */
 import type { LexicalEditor, LexicalNode } from 'lexical';
+/**
+ * Creates a selection range for the DOM.
+ * @param editor - The lexical editor.
+ * @param anchorNode - The anchor node of a selection.
+ * @param _anchorOffset - The amount of space offset from the anchor to the focus.
+ * @param focusNode - The current focus.
+ * @param _focusOffset - The amount of space offset from the focus to the anchor.
+ * @returns The range of selection for the DOM that was created.
+ */
 export declare function createDOMRange(editor: LexicalEditor, anchorNode: LexicalNode, _anchorOffset: number, focusNode: LexicalNode, _focusOffset: number): Range | null;
+/**
+ * Creates DOMRects, generally used to help the editor find a specific location on the screen.
+ * @param editor - The lexical editor
+ * @param range - A fragment of a document that can contain nodes and parts of text nodes.
+ * @returns The selectionRects as an array.
+ */
 export declare function createRectsFromDOMRange(editor: LexicalEditor, range: Range): Array<ClientRect>;
+/**
+ * Creates an object containing all the styles and their values provided in the CSS string.
+ * @param css - The CSS string of styles and their values.
+ * @returns The styleObject containing all the styles and their values.
+ */
 export declare function getStyleObjectFromRawCSS(css: string): Record<string, string>;
+/**
+ * Given a CSS string, returns an object from the style cache.
+ * @param css - The CSS property as a string.
+ * @returns The value of the given CSS property.
+ */
 export declare function getStyleObjectFromCSS(css: string): Record<string, string>;
+/**
+ * Gets the CSS styles from the style object.
+ * @param styles - The style object containing the styles to get.
+ * @returns A string containing the CSS styles and their values.
+ */
 export declare function getCSSFromStyleObject(styles: Record<string, string>): string;