lexical 0.36.3-nightly.20251006.0 → 0.36.3-nightly.20251008.0

package/Lexical.dev.js

@@ -3171,6 +3171,25 @@ function $removeNode(nodeToRemove, restoreSelection, preserveEmptyParent) {
 function buildImportMap(importMap) {
   return importMap;
 }
+const EPHEMERAL = Symbol.for('ephemeral');
+
+/**
+ * @internal
+ * @param node any LexicalNode
+ * @returns true if the node was created with {@link $cloneWithPropertiesEphemeral}
+ */
+function $isEphemeral(node) {
+  return node[EPHEMERAL] || false;
+}
+/**
+ * @internal
+ * Mark this node as ephemeral, its instance always returns this
+ * for getLatest and getWritable. It must not be added to an EditorState.
+ */
+function $markEphemeral(node) {
+  node[EPHEMERAL] = true;
+  return node;
+}
 class LexicalNode {
   /** @internal Allow us to look up the type including static props */
 
@@ -3333,7 +3352,6 @@ class LexicalNode {
     $setNodeKey(this, key);
     {
       if (this.__type !== 'root') {
-        errorOnReadOnly();
         errorOnTypeKlassMismatch(this.__type, this.constructor);
       }
     }
@@ -3731,6 +3749,9 @@ class LexicalNode {
    *
    */
   getLatest() {
+    if ($isEphemeral(this)) {
+      return this;
+    }
     const latest = $getNodeByKey(this.__key);
     if (latest === null) {
       {
@@ -3747,6 +3768,9 @@ class LexicalNode {
    *
    */
   getWritable() {
+    if ($isEphemeral(this)) {
+      return this;
+    }
     errorOnReadOnly();
     const editorState = getActiveEditorState();
     const editor = getActiveEditor();
@@ -9296,7 +9320,9 @@ class ElementNode extends LexicalNode {
     return this;
   }
   splice(start, deleteCount, nodesToInsert) {
-    const nodesToInsertLength = nodesToInsert.length;
+    if (!!$isEphemeral(this)) {
+      formatDevErrorMessage(`ElementNode.splice: Ephemeral nodes can not mutate their children (key ${this.__key} type ${this.__type})`);
+    }
     const oldSize = this.getChildrenSize();
     const writableSelf = this.getWritable();
     if (!(start + deleteCount <= oldSize)) {
@@ -9307,7 +9333,7 @@ class ElementNode extends LexicalNode {
     const nodesToRemoveKeys = [];
     const nodeAfterRange = this.getChildAtIndex(start + deleteCount);
     let nodeBeforeRange = null;
-    let newSize = oldSize - deleteCount + nodesToInsertLength;
+    let newSize = oldSize - deleteCount + nodesToInsert.length;
     if (start !== 0) {
       if (start === oldSize) {
         nodeBeforeRange = this.getLastChild();
@@ -9335,8 +9361,7 @@ class ElementNode extends LexicalNode {
       }
     }
     let prevNode = nodeBeforeRange;
-    for (let i = 0; i < nodesToInsertLength; i++) {
-      const nodeToInsert = nodesToInsert[i];
+    for (const nodeToInsert of nodesToInsert) {
       if (prevNode !== null && nodeToInsert.is(prevNode)) {
         nodeBeforeRange = prevNode = prevNode.getPreviousSibling();
       }
@@ -10803,7 +10828,7 @@ class LexicalEditor {
     };
   }
 }
-LexicalEditor.version = "0.36.3-nightly.20251006.0+dev.cjs";
+LexicalEditor.version = "0.36.3-nightly.20251008.0+dev.cjs";
 
 let pendingNodeToClone = null;
 function setPendingNodeToClone(pendingNode) {
@@ -11078,6 +11103,9 @@ function removeFromParent(node) {
 // the cloning heuristic. Instead use node.getWritable().
 function internalMarkNodeAsDirty(node) {
   errorOnInfiniteTransforms();
+  if (!!$isEphemeral(node)) {
+    formatDevErrorMessage(`internalMarkNodeAsDirty: Ephemeral nodes must not be marked as dirty (key ${node.__key} type ${node.__type})`);
+  }
   const latest = node.getLatest();
   const parent = latest.__parent;
   const editorState = getActiveEditorState();
@@ -12209,6 +12237,22 @@ function $cloneWithProperties(latestNode) {
   }
   return mutableNode;
 }
+
+/**
+ * Returns a clone with {@link $cloneWithProperties} and then "detaches"
+ * it from the state by overriding its getLatest and getWritable to always
+ * return this. This node can not be added to an EditorState or become the
+ * parent, child, or sibling of another node. It is primarily only useful
+ * for making in-place temporary modifications to a TextNode when
+ * serializing a partial slice.
+ *
+ * Does not mutate the EditorState.
+ * @param latestNode - The node to be cloned.
+ * @returns The clone of the node.
+ */
+function $cloneWithPropertiesEphemeral(latestNode) {
+  return $markEphemeral($cloneWithProperties(latestNode));
+}
 function setNodeIndentFromDOM(elementDom, elementNode) {
   const indentSize = parseInt(elementDom.style.paddingInlineStart, 10) || 0;
   const indent = Math.round(indentSize / 40);
@@ -13902,6 +13946,7 @@ exports.$applyNodeReplacement = $applyNodeReplacement;
 exports.$caretFromPoint = $caretFromPoint;
 exports.$caretRangeFromSelection = $caretRangeFromSelection;
 exports.$cloneWithProperties = $cloneWithProperties;
+exports.$cloneWithPropertiesEphemeral = $cloneWithPropertiesEphemeral;
 exports.$comparePointCaretNext = $comparePointCaretNext;
 exports.$copyNode = $copyNode;
 exports.$create = $create;

package/Lexical.dev.mjs

@@ -3169,6 +3169,25 @@ function $removeNode(nodeToRemove, restoreSelection, preserveEmptyParent) {
 function buildImportMap(importMap) {
   return importMap;
 }
+const EPHEMERAL = Symbol.for('ephemeral');
+
+/**
+ * @internal
+ * @param node any LexicalNode
+ * @returns true if the node was created with {@link $cloneWithPropertiesEphemeral}
+ */
+function $isEphemeral(node) {
+  return node[EPHEMERAL] || false;
+}
+/**
+ * @internal
+ * Mark this node as ephemeral, its instance always returns this
+ * for getLatest and getWritable. It must not be added to an EditorState.
+ */
+function $markEphemeral(node) {
+  node[EPHEMERAL] = true;
+  return node;
+}
 class LexicalNode {
   /** @internal Allow us to look up the type including static props */
 
@@ -3331,7 +3350,6 @@ class LexicalNode {
     $setNodeKey(this, key);
     {
       if (this.__type !== 'root') {
-        errorOnReadOnly();
         errorOnTypeKlassMismatch(this.__type, this.constructor);
       }
     }
@@ -3729,6 +3747,9 @@ class LexicalNode {
    *
    */
   getLatest() {
+    if ($isEphemeral(this)) {
+      return this;
+    }
     const latest = $getNodeByKey(this.__key);
     if (latest === null) {
       {
@@ -3745,6 +3766,9 @@ class LexicalNode {
    *
    */
   getWritable() {
+    if ($isEphemeral(this)) {
+      return this;
+    }
     errorOnReadOnly();
     const editorState = getActiveEditorState();
     const editor = getActiveEditor();
@@ -9294,7 +9318,9 @@ class ElementNode extends LexicalNode {
     return this;
   }
   splice(start, deleteCount, nodesToInsert) {
-    const nodesToInsertLength = nodesToInsert.length;
+    if (!!$isEphemeral(this)) {
+      formatDevErrorMessage(`ElementNode.splice: Ephemeral nodes can not mutate their children (key ${this.__key} type ${this.__type})`);
+    }
     const oldSize = this.getChildrenSize();
     const writableSelf = this.getWritable();
     if (!(start + deleteCount <= oldSize)) {
@@ -9305,7 +9331,7 @@ class ElementNode extends LexicalNode {
     const nodesToRemoveKeys = [];
     const nodeAfterRange = this.getChildAtIndex(start + deleteCount);
     let nodeBeforeRange = null;
-    let newSize = oldSize - deleteCount + nodesToInsertLength;
+    let newSize = oldSize - deleteCount + nodesToInsert.length;
     if (start !== 0) {
       if (start === oldSize) {
         nodeBeforeRange = this.getLastChild();
@@ -9333,8 +9359,7 @@ class ElementNode extends LexicalNode {
       }
     }
     let prevNode = nodeBeforeRange;
-    for (let i = 0; i < nodesToInsertLength; i++) {
-      const nodeToInsert = nodesToInsert[i];
+    for (const nodeToInsert of nodesToInsert) {
       if (prevNode !== null && nodeToInsert.is(prevNode)) {
         nodeBeforeRange = prevNode = prevNode.getPreviousSibling();
       }
@@ -10801,7 +10826,7 @@ class LexicalEditor {
     };
   }
 }
-LexicalEditor.version = "0.36.3-nightly.20251006.0+dev.esm";
+LexicalEditor.version = "0.36.3-nightly.20251008.0+dev.esm";
 
 let pendingNodeToClone = null;
 function setPendingNodeToClone(pendingNode) {
@@ -11076,6 +11101,9 @@ function removeFromParent(node) {
 // the cloning heuristic. Instead use node.getWritable().
 function internalMarkNodeAsDirty(node) {
   errorOnInfiniteTransforms();
+  if (!!$isEphemeral(node)) {
+    formatDevErrorMessage(`internalMarkNodeAsDirty: Ephemeral nodes must not be marked as dirty (key ${node.__key} type ${node.__type})`);
+  }
   const latest = node.getLatest();
   const parent = latest.__parent;
   const editorState = getActiveEditorState();
@@ -12207,6 +12235,22 @@ function $cloneWithProperties(latestNode) {
   }
   return mutableNode;
 }
+
+/**
+ * Returns a clone with {@link $cloneWithProperties} and then "detaches"
+ * it from the state by overriding its getLatest and getWritable to always
+ * return this. This node can not be added to an EditorState or become the
+ * parent, child, or sibling of another node. It is primarily only useful
+ * for making in-place temporary modifications to a TextNode when
+ * serializing a partial slice.
+ *
+ * Does not mutate the EditorState.
+ * @param latestNode - The node to be cloned.
+ * @returns The clone of the node.
+ */
+function $cloneWithPropertiesEphemeral(latestNode) {
+  return $markEphemeral($cloneWithProperties(latestNode));
+}
 function setNodeIndentFromDOM(elementDom, elementNode) {
   const indentSize = parseInt(elementDom.style.paddingInlineStart, 10) || 0;
   const indent = Math.round(indentSize / 40);
@@ -13895,4 +13939,4 @@ function shallowMergeConfig(config, overrides) {
   return config;
 }
 
-export { $addUpdateTag, $applyNodeReplacement, $caretFromPoint, $caretRangeFromSelection, $cloneWithProperties, $comparePointCaretNext, $copyNode, $create, $createLineBreakNode, $createNodeSelection, $createParagraphNode, $createPoint, $createRangeSelection, $createRangeSelectionFromDom, $createTabNode, $createTextNode, $extendCaretToRange, $findMatchingParent, $getAdjacentChildCaret, $getAdjacentNode, $getAdjacentSiblingOrParentSiblingCaret, $getCaretInDirection, $getCaretRange, $getCaretRangeInDirection, $getCharacterOffsets, $getChildCaret, $getChildCaretAtIndex, $getChildCaretOrSelf, $getCollapsedCaretRange, $getCommonAncestor, $getCommonAncestorResultBranchOrder, $getEditor, $getNearestNodeFromDOMNode, $getNearestRootOrShadowRoot, $getNodeByKey, $getNodeByKeyOrThrow, $getNodeFromDOMNode, $getPreviousSelection, $getRoot, $getSelection, $getSiblingCaret, $getState, $getStateChange, $getTextContent, $getTextNodeOffset, $getTextPointCaret, $getTextPointCaretSlice, $getWritableNodeState, $hasAncestor, $hasUpdateTag, $insertNodes, $isBlockElementNode, $isChildCaret, $isDecoratorNode, $isEditorState, $isElementNode, $isExtendableTextPointCaret, $isInlineElementOrDecoratorNode, $isLeafNode, $isLineBreakNode, $isNodeCaret, $isNodeSelection, $isParagraphNode, $isRangeSelection, $isRootNode, $isRootOrShadowRoot, $isSiblingCaret, $isTabNode, $isTextNode, $isTextPointCaret, $isTextPointCaretSlice, $isTokenOrSegmented, $isTokenOrTab, $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, COLLABORATION_TAG, 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, HISTORIC_TAG, HISTORY_MERGE_TAG, HISTORY_PUSH_TAG, 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, PASTE_TAG, ParagraphNode, REDO_COMMAND, REMOVE_TEXT_COMMAND, RootNode, SELECTION_CHANGE_COMMAND, SELECTION_INSERT_CLIPBOARD_NODES_COMMAND, SELECT_ALL_COMMAND, SKIP_COLLAB_TAG, SKIP_DOM_SELECTION_TAG, SKIP_SCROLL_INTO_VIEW_TAG, SKIP_SELECTION_FOCUS_TAG, TEXT_TYPE_TO_FORMAT, TabNode, TextNode, UNDO_COMMAND, buildImportMap, configExtension, createCommand, createEditor, createSharedNodeState, createState, declarePeerDependency, defineExtension, flipDirection, getDOMOwnerDocument, getDOMSelection, getDOMSelectionFromTarget, getDOMTextNode, getEditorPropertyFromDOMNode, getNearestEditorFromDOMNode, getRegisteredNode, getRegisteredNodeOrThrow, getStaticNodeConfig, isBlockDomNode, isCurrentlyReadOnlyMode, isDOMDocumentNode, isDOMNode, isDOMTextNode, isDOMUnmanaged, isDocumentFragment, isExactShortcutMatch, isHTMLAnchorElement, isHTMLElement, isInlineDomNode, isLexicalEditor, isModifierMatch, isSelectionCapturedInDecoratorInput, isSelectionWithinEditor, makeStepwiseIterator, removeFromParent, resetRandomKey, safeCast, setDOMUnmanaged, setNodeIndentFromDOM, shallowMergeConfig };
+export { $addUpdateTag, $applyNodeReplacement, $caretFromPoint, $caretRangeFromSelection, $cloneWithProperties, $cloneWithPropertiesEphemeral, $comparePointCaretNext, $copyNode, $create, $createLineBreakNode, $createNodeSelection, $createParagraphNode, $createPoint, $createRangeSelection, $createRangeSelectionFromDom, $createTabNode, $createTextNode, $extendCaretToRange, $findMatchingParent, $getAdjacentChildCaret, $getAdjacentNode, $getAdjacentSiblingOrParentSiblingCaret, $getCaretInDirection, $getCaretRange, $getCaretRangeInDirection, $getCharacterOffsets, $getChildCaret, $getChildCaretAtIndex, $getChildCaretOrSelf, $getCollapsedCaretRange, $getCommonAncestor, $getCommonAncestorResultBranchOrder, $getEditor, $getNearestNodeFromDOMNode, $getNearestRootOrShadowRoot, $getNodeByKey, $getNodeByKeyOrThrow, $getNodeFromDOMNode, $getPreviousSelection, $getRoot, $getSelection, $getSiblingCaret, $getState, $getStateChange, $getTextContent, $getTextNodeOffset, $getTextPointCaret, $getTextPointCaretSlice, $getWritableNodeState, $hasAncestor, $hasUpdateTag, $insertNodes, $isBlockElementNode, $isChildCaret, $isDecoratorNode, $isEditorState, $isElementNode, $isExtendableTextPointCaret, $isInlineElementOrDecoratorNode, $isLeafNode, $isLineBreakNode, $isNodeCaret, $isNodeSelection, $isParagraphNode, $isRangeSelection, $isRootNode, $isRootOrShadowRoot, $isSiblingCaret, $isTabNode, $isTextNode, $isTextPointCaret, $isTextPointCaretSlice, $isTokenOrSegmented, $isTokenOrTab, $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, COLLABORATION_TAG, 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, HISTORIC_TAG, HISTORY_MERGE_TAG, HISTORY_PUSH_TAG, 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, PASTE_TAG, ParagraphNode, REDO_COMMAND, REMOVE_TEXT_COMMAND, RootNode, SELECTION_CHANGE_COMMAND, SELECTION_INSERT_CLIPBOARD_NODES_COMMAND, SELECT_ALL_COMMAND, SKIP_COLLAB_TAG, SKIP_DOM_SELECTION_TAG, SKIP_SCROLL_INTO_VIEW_TAG, SKIP_SELECTION_FOCUS_TAG, TEXT_TYPE_TO_FORMAT, TabNode, TextNode, UNDO_COMMAND, buildImportMap, configExtension, createCommand, createEditor, createSharedNodeState, createState, declarePeerDependency, defineExtension, flipDirection, getDOMOwnerDocument, getDOMSelection, getDOMSelectionFromTarget, getDOMTextNode, getEditorPropertyFromDOMNode, getNearestEditorFromDOMNode, getRegisteredNode, getRegisteredNodeOrThrow, getStaticNodeConfig, isBlockDomNode, isCurrentlyReadOnlyMode, isDOMDocumentNode, isDOMNode, isDOMTextNode, isDOMUnmanaged, isDocumentFragment, isExactShortcutMatch, isHTMLAnchorElement, isHTMLElement, isInlineDomNode, isLexicalEditor, isModifierMatch, isSelectionCapturedInDecoratorInput, isSelectionWithinEditor, makeStepwiseIterator, removeFromParent, resetRandomKey, safeCast, setDOMUnmanaged, setNodeIndentFromDOM, shallowMergeConfig };

package/Lexical.mjs

@@ -14,6 +14,7 @@ export const $applyNodeReplacement = mod.$applyNodeReplacement;
 export const $caretFromPoint = mod.$caretFromPoint;
 export const $caretRangeFromSelection = mod.$caretRangeFromSelection;
 export const $cloneWithProperties = mod.$cloneWithProperties;
+export const $cloneWithPropertiesEphemeral = mod.$cloneWithPropertiesEphemeral;
 export const $comparePointCaretNext = mod.$comparePointCaretNext;
 export const $copyNode = mod.$copyNode;
 export const $create = mod.$create;

package/Lexical.node.mjs

@@ -12,6 +12,7 @@ export const $applyNodeReplacement = mod.$applyNodeReplacement;
 export const $caretFromPoint = mod.$caretFromPoint;
 export const $caretRangeFromSelection = mod.$caretRangeFromSelection;
 export const $cloneWithProperties = mod.$cloneWithProperties;
+export const $cloneWithPropertiesEphemeral = mod.$cloneWithPropertiesEphemeral;
 export const $comparePointCaretNext = mod.$comparePointCaretNext;
 export const $copyNode = mod.$copyNode;
 export const $create = mod.$create;