@lexical/react 0.45.1-nightly.20260608.0 → 0.45.1-nightly.20260610.0

package/dist/LexicalComposer.d.ts

@@ -36,6 +36,15 @@ export type InitialConfigType = Readonly<{
     namespace: string;
     nodes?: ReadonlyArray<Klass<LexicalNode> | LexicalNodeReplacement>;
     onError: (error: Error, editor: LexicalEditor) => void;
+    /**
+     * Optional handler for recoverable, warn-level conditions (e.g. the
+     * update-recursion guard tripping) that the editor has already recovered
+     * from. Mirrors {@link InitialConfigType.onError} but at warn severity, so
+     * embedders can route the condition to telemetry without raising an error
+     * alarm. Defaults (in core `createEditor`) to a handler that throws in
+     * development and only `console.warn`s in production.
+     */
+    onWarn?: (error: Error, editor: LexicalEditor) => void;
     editable?: boolean;
     theme?: EditorThemeClasses;
     /**

package/dist/LexicalComposer.dev.js

@@ -73,6 +73,7 @@ function LexicalComposer({
       namespace,
       nodes,
       onError,
+      onWarn,
       editorState: initialEditorState,
       html
     } = initialConfig;
@@ -83,6 +84,9 @@ function LexicalComposer({
       namespace,
       nodes,
       onError: error => onError(error, editor),
+      ...(onWarn ? {
+        onWarn: error => onWarn(error, editor)
+      } : {}),
       theme
     });
     initializeEditor(editor, initialEditorState);

package/dist/LexicalComposer.dev.mjs

@@ -71,6 +71,7 @@ function LexicalComposer({
       namespace,
       nodes,
       onError,
+      onWarn,
       editorState: initialEditorState,
       html
     } = initialConfig;
@@ -81,6 +82,9 @@ function LexicalComposer({
       namespace,
       nodes,
       onError: error => onError(error, editor),
+      ...(onWarn ? {
+        onWarn: error => onWarn(error, editor)
+      } : {}),
       theme
     });
     initializeEditor(editor, initialEditorState);

package/dist/LexicalComposer.js.flow

@@ -29,6 +29,7 @@ export type InitialConfigType = Readonly<{
   theme?: EditorThemeClasses,
   editorState?: InitialEditorStateType,
   onError: (error: Error, editor: LexicalEditor) => void,
+  onWarn?: (error: Error, editor: LexicalEditor) => void,
   html?: HTMLConfig,
 }>;
 

package/dist/LexicalComposer.prod.js

@@ -6,4 +6,4 @@
  *
  */
 
-"use strict";var e=require("@lexical/react/LexicalComposerContext"),t=require("lexical"),o=require("react"),r=require("react/jsx-runtime");const i=t.CAN_USE_DOM?o.useLayoutEffect:o.useEffect,n={tag:t.HISTORY_MERGE_TAG};exports.LexicalComposer=function({initialConfig:a,children:c}){const s=o.useMemo(()=>{const{theme:o,namespace:r,nodes:i,onError:c,editorState:s,html:l}=a,u=e.createLexicalComposerContext(null,o),d=t.createEditor({editable:a.editable,html:l,namespace:r,nodes:i,onError:e=>c(e,d),theme:o});return function(e,o){if(null===o)return;if(void 0===o)e.update(()=>{const o=t.$getRoot();if(o.isEmpty()){const r=t.$createParagraphNode();o.append(r);const i=t.CAN_USE_DOM?document.activeElement:null;(null!==t.$getSelection()||null!==i&&i===e.getRootElement())&&r.select()}},n);else if(null!==o)switch(typeof o){case"string":{const t=e.parseEditorState(o);e.setEditorState(t,n);break}case"object":e.setEditorState(o,n);break;case"function":e.update(()=>{t.$getRoot().isEmpty()&&o(e)},n)}}(d,s),[d,u]},[]);return i(()=>{const e=a.editable,[t]=s;t.setEditable(void 0===e||e)},[]),r.jsx(e.LexicalComposerContext.Provider,{value:s,children:c})};
+"use strict";var e=require("@lexical/react/LexicalComposerContext"),t=require("lexical"),o=require("react"),r=require("react/jsx-runtime");const n=t.CAN_USE_DOM?o.useLayoutEffect:o.useEffect,a={tag:t.HISTORY_MERGE_TAG};exports.LexicalComposer=function({initialConfig:i,children:c}){const s=o.useMemo(()=>{const{theme:o,namespace:r,nodes:n,onError:c,onWarn:s,editorState:l,html:u}=i,d=e.createLexicalComposerContext(null,o),m=t.createEditor({editable:i.editable,html:u,namespace:r,nodes:n,onError:e=>c(e,m),...s?{onWarn:e=>s(e,m)}:{},theme:o});return function(e,o){if(null===o)return;if(void 0===o)e.update(()=>{const o=t.$getRoot();if(o.isEmpty()){const r=t.$createParagraphNode();o.append(r);const n=t.CAN_USE_DOM?document.activeElement:null;(null!==t.$getSelection()||null!==n&&n===e.getRootElement())&&r.select()}},a);else if(null!==o)switch(typeof o){case"string":{const t=e.parseEditorState(o);e.setEditorState(t,a);break}case"object":e.setEditorState(o,a);break;case"function":e.update(()=>{t.$getRoot().isEmpty()&&o(e)},a)}}(m,l),[m,d]},[]);return n(()=>{const e=i.editable,[t]=s;t.setEditable(void 0===e||e)},[]),r.jsx(e.LexicalComposerContext.Provider,{value:s,children:c})};

package/dist/LexicalComposer.prod.mjs

@@ -6,4 +6,4 @@
  *
  */
 
-import{createLexicalComposerContext as t,LexicalComposerContext as e}from"@lexical/react/LexicalComposerContext";import{CAN_USE_DOM as o,createEditor as n,$getRoot as r,$createParagraphNode as i,$getSelection as a,HISTORY_MERGE_TAG as l}from"lexical";import{useLayoutEffect as c,useEffect as s,useMemo as m}from"react";import{jsx as d}from"react/jsx-runtime";const u=o?c:s,p={tag:l};function f({initialConfig:l,children:c}){const s=m(()=>{const{theme:e,namespace:c,nodes:s,onError:m,editorState:d,html:u}=l,f=t(null,e),E=n({editable:l.editable,html:u,namespace:c,nodes:s,onError:t=>m(t,E),theme:e});return function(t,e){if(null===e)return;if(void 0===e)t.update(()=>{const e=r();if(e.isEmpty()){const n=i();e.append(n);const r=o?document.activeElement:null;(null!==a()||null!==r&&r===t.getRootElement())&&n.select()}},p);else if(null!==e)switch(typeof e){case"string":{const o=t.parseEditorState(e);t.setEditorState(o,p);break}case"object":t.setEditorState(e,p);break;case"function":t.update(()=>{r().isEmpty()&&e(t)},p)}}(E,d),[E,f]},[]);return u(()=>{const t=l.editable,[e]=s;e.setEditable(void 0===t||t)},[]),d(e.Provider,{value:s,children:c})}export{f as LexicalComposer};
+import{createLexicalComposerContext as t,LexicalComposerContext as e}from"@lexical/react/LexicalComposerContext";import{CAN_USE_DOM as n,createEditor as o,$getRoot as r,$createParagraphNode as i,$getSelection as a,HISTORY_MERGE_TAG as l}from"lexical";import{useLayoutEffect as c,useEffect as s,useMemo as m}from"react";import{jsx as d}from"react/jsx-runtime";const u=n?c:s,p={tag:l};function f({initialConfig:l,children:c}){const s=m(()=>{const{theme:e,namespace:c,nodes:s,onError:m,onWarn:d,editorState:u,html:f}=l,E=t(null,e),b=o({editable:l.editable,html:f,namespace:c,nodes:s,onError:t=>m(t,b),...d?{onWarn:t=>d(t,b)}:{},theme:e});return function(t,e){if(null===e)return;if(void 0===e)t.update(()=>{const e=r();if(e.isEmpty()){const o=i();e.append(o);const r=n?document.activeElement:null;(null!==a()||null!==r&&r===t.getRootElement())&&o.select()}},p);else if(null!==e)switch(typeof e){case"string":{const n=t.parseEditorState(e);t.setEditorState(n,p);break}case"object":t.setEditorState(e,p);break;case"function":t.update(()=>{r().isEmpty()&&e(t)},p)}}(b,u),[b,E]},[]);return u(()=>{const t=l.editable,[e]=s;e.setEditable(void 0===t||t)},[]),d(e.Provider,{value:s,children:c})}export{f as LexicalComposer};

package/dist/LexicalTableOfContentsPlugin.dev.js

@@ -154,7 +154,7 @@ function TableOfContentsPlugin({
         for (const [nodeKey, mutation] of mutatedNodes) {
           if (mutation === 'created') {
             const newHeading = lexical.$getNodeByKey(nodeKey);
-            if (newHeading !== null) {
+            if (richText.$isHeadingNode(newHeading)) {
               const prevHeading = $getPreviousHeading(newHeading);
               currentTableOfContents = $insertHeadingIntoTableOfContents(prevHeading, newHeading, currentTableOfContents);
             }
@@ -162,7 +162,7 @@ function TableOfContentsPlugin({
             currentTableOfContents = $deleteHeadingFromTableOfContents(nodeKey, currentTableOfContents);
           } else if (mutation === 'updated') {
             const newHeading = lexical.$getNodeByKey(nodeKey);
-            if (newHeading !== null) {
+            if (richText.$isHeadingNode(newHeading)) {
               const prevHeading = $getPreviousHeading(newHeading);
               currentTableOfContents = $updateHeadingPosition(prevHeading, newHeading, currentTableOfContents);
             }

package/dist/LexicalTableOfContentsPlugin.dev.mjs

@@ -152,7 +152,7 @@ function TableOfContentsPlugin({
         for (const [nodeKey, mutation] of mutatedNodes) {
           if (mutation === 'created') {
             const newHeading = $getNodeByKey(nodeKey);
-            if (newHeading !== null) {
+            if ($isHeadingNode(newHeading)) {
               const prevHeading = $getPreviousHeading(newHeading);
               currentTableOfContents = $insertHeadingIntoTableOfContents(prevHeading, newHeading, currentTableOfContents);
             }
@@ -160,7 +160,7 @@ function TableOfContentsPlugin({
             currentTableOfContents = $deleteHeadingFromTableOfContents(nodeKey, currentTableOfContents);
           } else if (mutation === 'updated') {
             const newHeading = $getNodeByKey(nodeKey);
-            if (newHeading !== null) {
+            if ($isHeadingNode(newHeading)) {
               const prevHeading = $getPreviousHeading(newHeading);
               currentTableOfContents = $updateHeadingPosition(prevHeading, newHeading, currentTableOfContents);
             }

package/dist/LexicalTableOfContentsPlugin.prod.js

@@ -6,4 +6,4 @@
  *
  */
 
-"use strict";var e=require("@lexical/react/LexicalComposerContext"),t=require("@lexical/rich-text"),n=require("@lexical/utils"),o=require("lexical"),r=require("react");function i(e){return[e.getKey(),e.getTextContent(),e.getTag()]}function s(e,t,n){if(null===t)return n;const o=i(t);let r=[];if(null===e){if(n.length>0&&n[0][0]===t.__key)return n;r=[o,...n]}else for(let i=0;i<n.length;i++){const s=n[i][0];if(r.push(n[i]),s===e.getKey()&&s!==t.getKey()){if(i+1<n.length&&n[i+1][0]===t.__key)return n;r.push(o)}}return r}function u(e,t){const n=[];for(const o of t)o[0]!==e&&n.push(o);return n}function l(e,t){const n=[];for(const o of t)o[0]===e.getKey()?n.push(i(e)):n.push(o);return n}function c(e,t,n){const o=[],r=i(t);e||o.push(r);for(const i of n)i[0]!==t.getKey()&&(o.push(i),e&&i[0]===e.getKey()&&o.push(r));return o}function d(e){let o=n.$getNextRightPreorderNode(e);for(;null!==o&&!t.$isHeadingNode(o);)o=n.$getNextRightPreorderNode(o);return o}exports.TableOfContentsPlugin=function({children:n}){const[i,g]=r.useState([]),[f]=e.useLexicalComposerContext();return r.useEffect(()=>{let e=[];f.getEditorState().read(()=>{const n=r=>{for(const i of r.getChildren())t.$isHeadingNode(i)?e.push([i.getKey(),i.getTextContent(),i.getTag()]):o.$isElementNode(i)&&n(i)};n(o.$getRoot()),g(e)});const n=f.registerUpdateListener(({editorState:n,dirtyElements:r})=>{n.read(()=>{const n=r=>{for(const i of r.getChildren())if(t.$isHeadingNode(i)){const t=d(i);e=c(t,i,e),g(e)}else o.$isElementNode(i)&&n(i)};o.$getRoot().getChildren().forEach(e=>{o.$isElementNode(e)&&r.get(e.__key)&&n(e)})})}),r=f.registerMutationListener(t.HeadingNode,t=>{f.getEditorState().read(()=>{for(const[n,r]of t)if("created"===r){const t=o.$getNodeByKey(n);if(null!==t){const n=d(t);e=s(n,t,e)}}else if("destroyed"===r)e=u(n,e);else if("updated"===r){const t=o.$getNodeByKey(n);if(null!==t){const n=d(t);e=c(n,t,e)}}g(e)})},{skipInitialization:!0}),i=f.registerMutationListener(o.TextNode,n=>{f.getEditorState().read(()=>{for(const[r,i]of n)if("updated"===i){const n=o.$getNodeByKey(r);if(null!==n){const o=n.getParentOrThrow();t.$isHeadingNode(o)&&(e=l(o,e),g(e))}}})},{skipInitialization:!0});return()=>{r(),i(),n()}},[f]),n(i,f)};
+"use strict";var e=require("@lexical/react/LexicalComposerContext"),t=require("@lexical/rich-text"),n=require("@lexical/utils"),o=require("lexical"),r=require("react");function i(e){return[e.getKey(),e.getTextContent(),e.getTag()]}function s(e,t,n){if(null===t)return n;const o=i(t);let r=[];if(null===e){if(n.length>0&&n[0][0]===t.__key)return n;r=[o,...n]}else for(let i=0;i<n.length;i++){const s=n[i][0];if(r.push(n[i]),s===e.getKey()&&s!==t.getKey()){if(i+1<n.length&&n[i+1][0]===t.__key)return n;r.push(o)}}return r}function d(e,t){const n=[];for(const o of t)o[0]!==e&&n.push(o);return n}function u(e,t){const n=[];for(const o of t)o[0]===e.getKey()?n.push(i(e)):n.push(o);return n}function c(e,t,n){const o=[],r=i(t);e||o.push(r);for(const i of n)i[0]!==t.getKey()&&(o.push(i),e&&i[0]===e.getKey()&&o.push(r));return o}function g(e){let o=n.$getNextRightPreorderNode(e);for(;null!==o&&!t.$isHeadingNode(o);)o=n.$getNextRightPreorderNode(o);return o}exports.TableOfContentsPlugin=function({children:n}){const[i,l]=r.useState([]),[a]=e.useLexicalComposerContext();return r.useEffect(()=>{let e=[];a.getEditorState().read(()=>{const n=r=>{for(const i of r.getChildren())t.$isHeadingNode(i)?e.push([i.getKey(),i.getTextContent(),i.getTag()]):o.$isElementNode(i)&&n(i)};n(o.$getRoot()),l(e)});const n=a.registerUpdateListener(({editorState:n,dirtyElements:r})=>{n.read(()=>{const n=r=>{for(const i of r.getChildren())if(t.$isHeadingNode(i)){const t=g(i);e=c(t,i,e),l(e)}else o.$isElementNode(i)&&n(i)};o.$getRoot().getChildren().forEach(e=>{o.$isElementNode(e)&&r.get(e.__key)&&n(e)})})}),r=a.registerMutationListener(t.HeadingNode,n=>{a.getEditorState().read(()=>{for(const[r,i]of n)if("created"===i){const n=o.$getNodeByKey(r);if(t.$isHeadingNode(n)){const t=g(n);e=s(t,n,e)}}else if("destroyed"===i)e=d(r,e);else if("updated"===i){const n=o.$getNodeByKey(r);if(t.$isHeadingNode(n)){const t=g(n);e=c(t,n,e)}}l(e)})},{skipInitialization:!0}),i=a.registerMutationListener(o.TextNode,n=>{a.getEditorState().read(()=>{for(const[r,i]of n)if("updated"===i){const n=o.$getNodeByKey(r);if(null!==n){const o=n.getParentOrThrow();t.$isHeadingNode(o)&&(e=u(o,e),l(e))}}})},{skipInitialization:!0});return()=>{r(),i(),n()}},[a]),n(i,a)};

package/dist/LexicalTableOfContentsPlugin.prod.mjs

@@ -6,4 +6,4 @@
  *
  */
 
-import{useLexicalComposerContext as t}from"@lexical/react/LexicalComposerContext";import{HeadingNode as e,$isHeadingNode as n}from"@lexical/rich-text";import{$getNextRightPreorderNode as r}from"@lexical/utils";import{$getRoot as o,$isElementNode as i,$getNodeByKey as s,TextNode as f}from"lexical";import{useState as c,useEffect as l}from"react";function u(t){return[t.getKey(),t.getTextContent(),t.getTag()]}function a(t,e,n){if(null===e)return n;const r=u(e);let o=[];if(null===t){if(n.length>0&&n[0][0]===e.__key)return n;o=[r,...n]}else for(let i=0;i<n.length;i++){const s=n[i][0];if(o.push(n[i]),s===t.getKey()&&s!==e.getKey()){if(i+1<n.length&&n[i+1][0]===e.__key)return n;o.push(r)}}return o}function g(t,e){const n=[];for(const r of e)r[0]!==t&&n.push(r);return n}function d(t,e){const n=[];for(const r of e)r[0]===t.getKey()?n.push(u(t)):n.push(r);return n}function p(t,e,n){const r=[],o=u(e);t||r.push(o);for(const i of n)i[0]!==e.getKey()&&(r.push(i),t&&i[0]===t.getKey()&&r.push(o));return r}function h(t){let e=r(t);for(;null!==e&&!n(e);)e=r(e);return e}function m({children:r}){const[u,m]=c([]),[y]=t();return l(()=>{let t=[];y.getEditorState().read(()=>{const e=r=>{for(const o of r.getChildren())n(o)?t.push([o.getKey(),o.getTextContent(),o.getTag()]):i(o)&&e(o)};e(o()),m(t)});const r=y.registerUpdateListener(({editorState:e,dirtyElements:r})=>{e.read(()=>{const e=r=>{for(const o of r.getChildren())if(n(o)){const e=h(o);t=p(e,o,t),m(t)}else i(o)&&e(o)};o().getChildren().forEach(t=>{i(t)&&r.get(t.__key)&&e(t)})})}),c=y.registerMutationListener(e,e=>{y.getEditorState().read(()=>{for(const[n,r]of e)if("created"===r){const e=s(n);if(null!==e){const n=h(e);t=a(n,e,t)}}else if("destroyed"===r)t=g(n,t);else if("updated"===r){const e=s(n);if(null!==e){const n=h(e);t=p(n,e,t)}}m(t)})},{skipInitialization:!0}),l=y.registerMutationListener(f,e=>{y.getEditorState().read(()=>{for(const[r,o]of e)if("updated"===o){const e=s(r);if(null!==e){const r=e.getParentOrThrow();n(r)&&(t=d(r,t),m(t))}}})},{skipInitialization:!0});return()=>{c(),l(),r()}},[y]),r(u,y)}export{m as TableOfContentsPlugin};
+import{useLexicalComposerContext as t}from"@lexical/react/LexicalComposerContext";import{HeadingNode as e,$isHeadingNode as n}from"@lexical/rich-text";import{$getNextRightPreorderNode as r}from"@lexical/utils";import{$getRoot as o,$isElementNode as i,$getNodeByKey as s,TextNode as f}from"lexical";import{useState as c,useEffect as l}from"react";function u(t){return[t.getKey(),t.getTextContent(),t.getTag()]}function a(t,e,n){if(null===e)return n;const r=u(e);let o=[];if(null===t){if(n.length>0&&n[0][0]===e.__key)return n;o=[r,...n]}else for(let i=0;i<n.length;i++){const s=n[i][0];if(o.push(n[i]),s===t.getKey()&&s!==e.getKey()){if(i+1<n.length&&n[i+1][0]===e.__key)return n;o.push(r)}}return o}function g(t,e){const n=[];for(const r of e)r[0]!==t&&n.push(r);return n}function d(t,e){const n=[];for(const r of e)r[0]===t.getKey()?n.push(u(t)):n.push(r);return n}function p(t,e,n){const r=[],o=u(e);t||r.push(o);for(const i of n)i[0]!==e.getKey()&&(r.push(i),t&&i[0]===t.getKey()&&r.push(o));return r}function h(t){let e=r(t);for(;null!==e&&!n(e);)e=r(e);return e}function m({children:r}){const[u,m]=c([]),[y]=t();return l(()=>{let t=[];y.getEditorState().read(()=>{const e=r=>{for(const o of r.getChildren())n(o)?t.push([o.getKey(),o.getTextContent(),o.getTag()]):i(o)&&e(o)};e(o()),m(t)});const r=y.registerUpdateListener(({editorState:e,dirtyElements:r})=>{e.read(()=>{const e=r=>{for(const o of r.getChildren())if(n(o)){const e=h(o);t=p(e,o,t),m(t)}else i(o)&&e(o)};o().getChildren().forEach(t=>{i(t)&&r.get(t.__key)&&e(t)})})}),c=y.registerMutationListener(e,e=>{y.getEditorState().read(()=>{for(const[r,o]of e)if("created"===o){const e=s(r);if(n(e)){const n=h(e);t=a(n,e,t)}}else if("destroyed"===o)t=g(r,t);else if("updated"===o){const e=s(r);if(n(e)){const n=h(e);t=p(n,e,t)}}m(t)})},{skipInitialization:!0}),l=y.registerMutationListener(f,e=>{y.getEditorState().read(()=>{for(const[r,o]of e)if("updated"===o){const e=s(r);if(null!==e){const r=e.getParentOrThrow();n(r)&&(t=d(r,t),m(t))}}})},{skipInitialization:!0});return()=>{c(),l(),r()}},[y]),r(u,y)}export{m as TableOfContentsPlugin};

package/package.json

@@ -8,28 +8,28 @@
     "rich-text"
   ],
   "license": "MIT",
-  "version": "0.45.1-nightly.20260608.0",
+  "version": "0.45.1-nightly.20260610.0",
   "dependencies": {
     "@floating-ui/react": "^0.27.19",
     "react-error-boundary": "^6.1.1",
-    "@lexical/devtools-core": "0.45.1-nightly.20260608.0",
-    "@lexical/hashtag": "0.45.1-nightly.20260608.0",
-    "@lexical/dragon": "0.45.1-nightly.20260608.0",
-    "@lexical/history": "0.45.1-nightly.20260608.0",
-    "@lexical/extension": "0.45.1-nightly.20260608.0",
-    "@lexical/link": "0.45.1-nightly.20260608.0",
-    "@lexical/internal": "0.45.1-nightly.20260608.0",
-    "@lexical/list": "0.45.1-nightly.20260608.0",
-    "@lexical/mark": "0.45.1-nightly.20260608.0",
-    "@lexical/markdown": "0.45.1-nightly.20260608.0",
-    "@lexical/overflow": "0.45.1-nightly.20260608.0",
-    "@lexical/plain-text": "0.45.1-nightly.20260608.0",
-    "@lexical/rich-text": "0.45.1-nightly.20260608.0",
-    "@lexical/table": "0.45.1-nightly.20260608.0",
-    "@lexical/text": "0.45.1-nightly.20260608.0",
-    "@lexical/utils": "0.45.1-nightly.20260608.0",
-    "lexical": "0.45.1-nightly.20260608.0",
-    "@lexical/yjs": "0.45.1-nightly.20260608.0"
+    "@lexical/dragon": "0.45.1-nightly.20260610.0",
+    "@lexical/devtools-core": "0.45.1-nightly.20260610.0",
+    "@lexical/extension": "0.45.1-nightly.20260610.0",
+    "@lexical/history": "0.45.1-nightly.20260610.0",
+    "@lexical/hashtag": "0.45.1-nightly.20260610.0",
+    "@lexical/internal": "0.45.1-nightly.20260610.0",
+    "@lexical/link": "0.45.1-nightly.20260610.0",
+    "@lexical/list": "0.45.1-nightly.20260610.0",
+    "@lexical/mark": "0.45.1-nightly.20260610.0",
+    "@lexical/markdown": "0.45.1-nightly.20260610.0",
+    "@lexical/overflow": "0.45.1-nightly.20260610.0",
+    "@lexical/rich-text": "0.45.1-nightly.20260610.0",
+    "@lexical/plain-text": "0.45.1-nightly.20260610.0",
+    "@lexical/table": "0.45.1-nightly.20260610.0",
+    "@lexical/text": "0.45.1-nightly.20260610.0",
+    "@lexical/yjs": "0.45.1-nightly.20260610.0",
+    "@lexical/utils": "0.45.1-nightly.20260610.0",
+    "lexical": "0.45.1-nightly.20260610.0"
   },
   "peerDependencies": {
     "react": ">=17.x",

package/src/LexicalComposer.tsx

@@ -68,6 +68,15 @@ export type InitialConfigType = Readonly<{
   namespace: string;
   nodes?: ReadonlyArray<Klass<LexicalNode> | LexicalNodeReplacement>;
   onError: (error: Error, editor: LexicalEditor) => void;
+  /**
+   * Optional handler for recoverable, warn-level conditions (e.g. the
+   * update-recursion guard tripping) that the editor has already recovered
+   * from. Mirrors {@link InitialConfigType.onError} but at warn severity, so
+   * embedders can route the condition to telemetry without raising an error
+   * alarm. Defaults (in core `createEditor`) to a handler that throws in
+   * development and only `console.warn`s in production.
+   */
+  onWarn?: (error: Error, editor: LexicalEditor) => void;
   editable?: boolean;
   theme?: EditorThemeClasses;
   /**
@@ -96,6 +105,7 @@ export function LexicalComposer({initialConfig, children}: Props): JSX.Element {
         namespace,
         nodes,
         onError,
+        onWarn,
         editorState: initialEditorState,
         html,
       } = initialConfig;
@@ -111,6 +121,7 @@ export function LexicalComposer({initialConfig, children}: Props): JSX.Element {
         namespace,
         nodes,
         onError: error => onError(error, editor),
+        ...(onWarn ? {onWarn: error => onWarn(error, editor)} : {}),
         theme,
       });
       initializeEditor(editor, initialEditorState);

package/src/LexicalTableOfContentsPlugin.tsx

@@ -207,8 +207,8 @@ export function TableOfContentsPlugin({children}: Props): JSX.Element {
         editor.getEditorState().read(() => {
           for (const [nodeKey, mutation] of mutatedNodes) {
             if (mutation === 'created') {
-              const newHeading = $getNodeByKey<HeadingNode>(nodeKey);
-              if (newHeading !== null) {
+              const newHeading = $getNodeByKey(nodeKey);
+              if ($isHeadingNode(newHeading)) {
                 const prevHeading = $getPreviousHeading(newHeading);
                 currentTableOfContents = $insertHeadingIntoTableOfContents(
                   prevHeading,
@@ -222,8 +222,8 @@ export function TableOfContentsPlugin({children}: Props): JSX.Element {
                 currentTableOfContents,
               );
             } else if (mutation === 'updated') {
-              const newHeading = $getNodeByKey<HeadingNode>(nodeKey);
-              if (newHeading !== null) {
+              const newHeading = $getNodeByKey(nodeKey);
+              if ($isHeadingNode(newHeading)) {
                 const prevHeading = $getPreviousHeading(newHeading);
                 currentTableOfContents = $updateHeadingPosition(
                   prevHeading,