@lexical/react 0.35.1-nightly.20250924.0 → 0.36.0

package/LexicalReactPluginHostExtension.dev.mjs

@@ -0,0 +1,181 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ */
+
+import { untracked, signal, getExtensionDependencyFromEditor, effect } from '@lexical/extension';
+import { ReactExtension } from '@lexical/react/ReactExtension';
+import { ReactProviderExtension } from '@lexical/react/ReactProviderExtension';
+import { mergeRegister } from '@lexical/utils';
+import { createCommand, defineExtension, configExtension, COMMAND_PRIORITY_CRITICAL, COMMAND_PRIORITY_EDITOR } from 'lexical';
+import { useState, useEffect, Suspense } from 'react';
+import { createPortal } from 'react-dom';
+import { createRoot } from 'react-dom/client';
+import { jsx, Fragment } from 'react/jsx-runtime';
+
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ */
+
+// Do not require this module directly! Use normal `invariant` calls.
+
+function formatDevErrorMessage(message) {
+  throw new Error(message);
+}
+
+function mountReactExtensionComponent(editor, opts) {
+  const {
+    props,
+    extension,
+    ...rest
+  } = opts;
+  const {
+    Component
+  } = getExtensionDependencyFromEditor(editor, extension).output;
+  const element = props ? /*#__PURE__*/jsx(Component, {
+    ...props
+  }) : null;
+  mountReactPluginElement(editor, {
+    ...rest,
+    element
+  });
+}
+function mountReactPluginComponent(editor, opts) {
+  const {
+    Component,
+    props,
+    ...rest
+  } = opts;
+  mountReactPluginElement(editor, {
+    ...rest,
+    element: props ? /*#__PURE__*/jsx(Component, {
+      ...props
+    }) : null
+  });
+}
+function mountReactPluginElement(editor, opts) {
+  getExtensionDependencyFromEditor(editor, ReactPluginHostExtension).output.mountReactPlugin(opts);
+}
+function mountReactPluginHost(editor, container) {
+  getExtensionDependencyFromEditor(editor, ReactPluginHostExtension).output.mountReactPluginHost(container);
+}
+const REACT_PLUGIN_HOST_MOUNT_ROOT_COMMAND = createCommand('REACT_PLUGIN_HOST_MOUNT_ROOT_COMMAND');
+const REACT_PLUGIN_HOST_MOUNT_PLUGIN_COMMAND = createCommand('REACT_PLUGIN_HOST_MOUNT_PLUGIN_COMMAND');
+function PluginHostDecorator({
+  context: [editor]
+}) {
+  const {
+    mountedPluginsStore
+  } = getExtensionDependencyFromEditor(editor, ReactPluginHostExtension).output;
+  const {
+    ErrorBoundary
+  } = getExtensionDependencyFromEditor(editor, ReactExtension).config;
+  const onError = editor._onError.bind(editor);
+  const [{
+    plugins
+  }, setMountedPlugins] = useState(() => mountedPluginsStore.peek());
+  useEffect(() => effect(() => setMountedPlugins(mountedPluginsStore.value)), [mountedPluginsStore]);
+  const children = [];
+  for (const {
+    key,
+    element,
+    domNode
+  } of plugins.values()) {
+    if (!element) {
+      continue;
+    }
+    const wrapped = /*#__PURE__*/jsx(ErrorBoundary, {
+      onError: onError,
+      children: /*#__PURE__*/jsx(Suspense, {
+        fallback: null,
+        children: element
+      })
+    }, key);
+    children.push(domNode ? /*#__PURE__*/createPortal(wrapped, domNode, key) : wrapped);
+  }
+  return children.length > 0 ? /*#__PURE__*/jsx(Fragment, {
+    children: children
+  }) : null;
+}
+
+/**
+ * This extension provides a React host for editors that are not built
+ * with LexicalExtensionComposer (e.g. you are using Vanilla JS or some
+ * other framework).
+ *
+ * You must use {@link mountReactPluginHost} for any React content to work.
+ * Afterwards, you may use {@link mountReactExtensionComponent} to
+ * render UI for a specific React Extension.
+ * {@link mountReactPluginComponent} and
+ * {@link mountReactPluginElement} can be used to render
+ * legacy React plug-ins (or any React content).
+ */
+const ReactPluginHostExtension = defineExtension({
+  build(editor, config, state) {
+    const mountedPluginsStore = signal({
+      plugins: new Map()
+    });
+    return {
+      mountReactPlugin: arg => {
+        editor.dispatchCommand(REACT_PLUGIN_HOST_MOUNT_PLUGIN_COMMAND, arg);
+      },
+      // Using outputs to wrap commands will give us better error messages
+      // if the mount functions are called on an editor without this extension
+      mountReactPluginHost: container => editor.dispatchCommand(REACT_PLUGIN_HOST_MOUNT_ROOT_COMMAND, {
+        root: createRoot(container)
+      }),
+      mountedPluginsStore
+    };
+  },
+  dependencies: [ReactProviderExtension, configExtension(ReactExtension, {
+    decorators: [PluginHostDecorator]
+  })],
+  name: '@lexical/react/ReactPluginHost',
+  register(editor, _config, state) {
+    let root;
+    const {
+      mountedPluginsStore
+    } = state.getOutput();
+    const {
+      Component
+    } = state.getDependency(ReactExtension).output;
+    return mergeRegister(() => {
+      if (root) {
+        root.unmount();
+      }
+      untracked(() => {
+        mountedPluginsStore.value.plugins.clear();
+      });
+    }, editor.registerCommand(REACT_PLUGIN_HOST_MOUNT_PLUGIN_COMMAND, arg => {
+      // This runs before the PluginHost version
+      untracked(() => {
+        const {
+          plugins
+        } = mountedPluginsStore.value;
+        plugins.set(arg.key, arg);
+        mountedPluginsStore.value = {
+          plugins
+        };
+      });
+      return false;
+    }, COMMAND_PRIORITY_CRITICAL), editor.registerCommand(REACT_PLUGIN_HOST_MOUNT_ROOT_COMMAND, arg => {
+      if (!(root === undefined)) {
+        formatDevErrorMessage(`ReactPluginHostExtension: Root is already mounted`);
+      }
+      root = arg.root;
+      root.render(/*#__PURE__*/jsx(Component, {
+        contentEditable: null
+      }));
+      return true;
+    }, COMMAND_PRIORITY_EDITOR));
+  }
+});
+
+export { REACT_PLUGIN_HOST_MOUNT_PLUGIN_COMMAND, REACT_PLUGIN_HOST_MOUNT_ROOT_COMMAND, ReactPluginHostExtension, mountReactExtensionComponent, mountReactPluginComponent, mountReactPluginElement, mountReactPluginHost };

package/LexicalReactPluginHostExtension.js

@@ -0,0 +1,11 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ */
+
+'use strict'
+const LexicalReactPluginHostExtension = process.env.NODE_ENV !== 'production' ? require('./LexicalReactPluginHostExtension.dev.js') : require('./LexicalReactPluginHostExtension.prod.js');
+module.exports = LexicalReactPluginHostExtension;

package/LexicalReactPluginHostExtension.js.flow

@@ -0,0 +1,84 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ * @flow strict
+ */
+
+/**
+ * LexicalReactPluginHostExtension
+ */
+import type {
+  LexicalExtension,
+  AnyLexicalExtension,
+  LexicalEditor,
+  LexicalExtensionOutput,
+  LexicalCommand,
+  ExtensionConfigBase,
+} from 'lexical';
+import type {Signal} from '@lexical/extension';
+import type {DecoratorComponentProps} from '@lexical/react/ReactExtension';
+export type {DecoratorComponentProps};
+
+type Container = DocumentFragment | Element;
+// TODO: Not sure how to import RootType from react-dom/client
+type Root = mixed;
+
+export interface HostMountCommandArg {
+  root: Root;
+}
+
+export interface MountPluginCommandArg {
+  key: string;
+  element: React.Node | null;
+  domNode?: Container | null;
+}
+
+declare export function mountReactExtensionComponent<
+  Extension: AnyLexicalExtension,
+>(
+  editor: LexicalEditor,
+  opts: {
+    extension: Extension;
+    props: [LexicalExtensionOutput<Extension>] extends [
+      {
+        // $FlowFixMe[unclear-type]: defined by user
+        Component: infer OutputComponentType extends React.ComponentType<any>;
+      },
+    ]
+      ? React.PropsOf<OutputComponentType> | null
+      : empty;
+  } & Omit<MountPluginCommandArg, 'element'>,
+): void;
+
+declare export function mountReactPluginComponent<
+  P: {...} = {...},
+>(
+  editor: LexicalEditor,
+  opts: {
+    Component: React.ComponentType<P>;
+    props: (P & {key?: null | void | React.Key}) | null;
+  } & Omit<MountPluginCommandArg, 'element'>,
+): void;
+
+declare export function mountReactPluginElement(
+  editor: LexicalEditor,
+  opts: MountPluginCommandArg,
+): void;
+
+declare export function mountReactPluginHost(
+  editor: LexicalEditor,
+  container: Container,
+): void;
+
+declare export var REACT_PLUGIN_HOST_MOUNT_ROOT_COMMAND: LexicalCommand<HostMountCommandArg>;
+declare export var REACT_PLUGIN_HOST_MOUNT_PLUGIN_COMMAND: LexicalCommand<MountPluginCommandArg>;
+declare export var ReactPluginHostExtension: LexicalExtension<ExtensionConfigBase, "@lexical/react/ReactPluginHost", {
+    mountReactPlugin: (arg: MountPluginCommandArg) => void;
+    mountReactPluginHost: (container: Container) => boolean;
+    mountedPluginsStore: Signal<{
+        plugins: Map<string, MountPluginCommandArg>;
+    }>;
+}, void>;

package/LexicalReactPluginHostExtension.mjs

@@ -0,0 +1,18 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ */
+
+import * as modDev from './LexicalReactPluginHostExtension.dev.mjs';
+import * as modProd from './LexicalReactPluginHostExtension.prod.mjs';
+const mod = process.env.NODE_ENV !== 'production' ? modDev : modProd;
+export const REACT_PLUGIN_HOST_MOUNT_PLUGIN_COMMAND = mod.REACT_PLUGIN_HOST_MOUNT_PLUGIN_COMMAND;
+export const REACT_PLUGIN_HOST_MOUNT_ROOT_COMMAND = mod.REACT_PLUGIN_HOST_MOUNT_ROOT_COMMAND;
+export const ReactPluginHostExtension = mod.ReactPluginHostExtension;
+export const mountReactExtensionComponent = mod.mountReactExtensionComponent;
+export const mountReactPluginComponent = mod.mountReactPluginComponent;
+export const mountReactPluginElement = mod.mountReactPluginElement;
+export const mountReactPluginHost = mod.mountReactPluginHost;

package/LexicalReactPluginHostExtension.node.mjs

@@ -0,0 +1,16 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ */
+
+const mod = await (process.env.NODE_ENV !== 'production' ? import('./LexicalReactPluginHostExtension.dev.mjs') : import('./LexicalReactPluginHostExtension.prod.mjs'));
+export const REACT_PLUGIN_HOST_MOUNT_PLUGIN_COMMAND = mod.REACT_PLUGIN_HOST_MOUNT_PLUGIN_COMMAND;
+export const REACT_PLUGIN_HOST_MOUNT_ROOT_COMMAND = mod.REACT_PLUGIN_HOST_MOUNT_ROOT_COMMAND;
+export const ReactPluginHostExtension = mod.ReactPluginHostExtension;
+export const mountReactExtensionComponent = mod.mountReactExtensionComponent;
+export const mountReactPluginComponent = mod.mountReactPluginComponent;
+export const mountReactPluginElement = mod.mountReactPluginElement;
+export const mountReactPluginHost = mod.mountReactPluginHost;

package/LexicalReactPluginHostExtension.prod.js

@@ -0,0 +1,9 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * 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 e=require("@lexical/extension"),n=require("@lexical/react/ReactExtension"),t=require("@lexical/react/ReactProviderExtension"),o=require("@lexical/utils"),r=require("lexical"),i=require("react"),s=require("react-dom"),u=require("react-dom/client"),c=require("react/jsx-runtime");function a(n,t){e.getExtensionDependencyFromEditor(n,m).output.mountReactPlugin(t)}const l=r.createCommand("REACT_PLUGIN_HOST_MOUNT_ROOT_COMMAND"),d=r.createCommand("REACT_PLUGIN_HOST_MOUNT_PLUGIN_COMMAND");const m=r.defineExtension({build:(n,t,o)=>({mountReactPlugin:e=>{n.dispatchCommand(d,e)},mountReactPluginHost:e=>n.dispatchCommand(l,{root:u.createRoot(e)}),mountedPluginsStore:e.signal({plugins:new Map})}),dependencies:[t.ReactProviderExtension,r.configExtension(n.ReactExtension,{decorators:[function({context:[t]}){const{mountedPluginsStore:o}=e.getExtensionDependencyFromEditor(t,m).output,{ErrorBoundary:r}=e.getExtensionDependencyFromEditor(t,n.ReactExtension).config,u=t._onError.bind(t),[{plugins:a},l]=i.useState((()=>o.peek()));i.useEffect((()=>e.effect((()=>l(o.value)))),[o]);const d=[];for(const{key:e,element:n,domNode:t}of a.values()){if(!n)continue;const o=c.jsx(r,{onError:u,children:c.jsx(i.Suspense,{fallback:null,children:n})},e);d.push(t?s.createPortal(o,t,e):o)}return d.length>0?c.jsx(c.Fragment,{children:d}):null}]})],name:"@lexical/react/ReactPluginHost",register(t,i,s){let u;const{mountedPluginsStore:a}=s.getOutput(),{Component:m}=s.getDependency(n.ReactExtension).output;return o.mergeRegister((()=>{u&&u.unmount(),e.untracked((()=>{a.value.plugins.clear()}))}),t.registerCommand(d,(n=>(e.untracked((()=>{const{plugins:e}=a.value;e.set(n.key,n),a.value={plugins:e}})),!1)),r.COMMAND_PRIORITY_CRITICAL),t.registerCommand(l,(e=>(void 0!==u&&function(e,...n){const t=new URL("https://lexical.dev/docs/error"),o=new URLSearchParams;o.append("code",e);for(const e of n)o.append("v",e);throw t.search=o.toString(),Error(`Minified Lexical error #${e}; visit ${t.toString()} for the full message or use the non-minified dev environment for full errors and additional helpful warnings.`)}(322),u=e.root,u.render(c.jsx(m,{contentEditable:null})),!0)),r.COMMAND_PRIORITY_EDITOR))}});exports.REACT_PLUGIN_HOST_MOUNT_PLUGIN_COMMAND=d,exports.REACT_PLUGIN_HOST_MOUNT_ROOT_COMMAND=l,exports.ReactPluginHostExtension=m,exports.mountReactExtensionComponent=function(n,t){const{props:o,extension:r,...i}=t,{Component:s}=e.getExtensionDependencyFromEditor(n,r).output;a(n,{...i,element:o?c.jsx(s,{...o}):null})},exports.mountReactPluginComponent=function(e,n){const{Component:t,props:o,...r}=n;a(e,{...r,element:o?c.jsx(t,{...o}):null})},exports.mountReactPluginElement=a,exports.mountReactPluginHost=function(n,t){e.getExtensionDependencyFromEditor(n,m).output.mountReactPluginHost(t)};

package/LexicalReactPluginHostExtension.prod.mjs

@@ -0,0 +1,9 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ */
+
+import{untracked as e,signal as n,getExtensionDependencyFromEditor as t,effect as o}from"@lexical/extension";import{ReactExtension as r}from"@lexical/react/ReactExtension";import{ReactProviderExtension as i}from"@lexical/react/ReactProviderExtension";import{mergeRegister as l}from"@lexical/utils";import{createCommand as u,defineExtension as c,configExtension as a,COMMAND_PRIORITY_CRITICAL as s,COMMAND_PRIORITY_EDITOR as m}from"lexical";import{useState as p,useEffect as d,Suspense as f}from"react";import{createPortal as g}from"react-dom";import{createRoot as x}from"react-dom/client";import{jsx as h,Fragment as P}from"react/jsx-runtime";function v(e,n){const{props:o,extension:r,...i}=n,{Component:l}=t(e,r).output;C(e,{...i,element:o?h(l,{...o}):null})}function R(e,n){const{Component:t,props:o,...r}=n;C(e,{...r,element:o?h(t,{...o}):null})}function C(e,n){t(e,M).output.mountReactPlugin(n)}function _(e,n){t(e,M).output.mountReactPluginHost(n)}const E=u("REACT_PLUGIN_HOST_MOUNT_ROOT_COMMAND"),O=u("REACT_PLUGIN_HOST_MOUNT_PLUGIN_COMMAND");const M=c({build:(e,t,o)=>({mountReactPlugin:n=>{e.dispatchCommand(O,n)},mountReactPluginHost:n=>e.dispatchCommand(E,{root:x(n)}),mountedPluginsStore:n({plugins:new Map})}),dependencies:[i,a(r,{decorators:[function({context:[e]}){const{mountedPluginsStore:n}=t(e,M).output,{ErrorBoundary:i}=t(e,r).config,l=e._onError.bind(e),[{plugins:u},c]=p((()=>n.peek()));d((()=>o((()=>c(n.value)))),[n]);const a=[];for(const{key:e,element:n,domNode:t}of u.values()){if(!n)continue;const o=h(i,{onError:l,children:h(f,{fallback:null,children:n})},e);a.push(t?g(o,t,e):o)}return a.length>0?h(P,{children:a}):null}]})],name:"@lexical/react/ReactPluginHost",register(n,t,o){let i;const{mountedPluginsStore:u}=o.getOutput(),{Component:c}=o.getDependency(r).output;return l((()=>{i&&i.unmount(),e((()=>{u.value.plugins.clear()}))}),n.registerCommand(O,(n=>(e((()=>{const{plugins:e}=u.value;e.set(n.key,n),u.value={plugins:e}})),!1)),s),n.registerCommand(E,(e=>(void 0!==i&&function(e,...n){const t=new URL("https://lexical.dev/docs/error"),o=new URLSearchParams;o.append("code",e);for(const e of n)o.append("v",e);throw t.search=o.toString(),Error(`Minified Lexical error #${e}; visit ${t.toString()} for the full message or use the non-minified dev environment for full errors and additional helpful warnings.`)}(322),i=e.root,i.render(h(c,{contentEditable:null})),!0)),m))}});export{O as REACT_PLUGIN_HOST_MOUNT_PLUGIN_COMMAND,E as REACT_PLUGIN_HOST_MOUNT_ROOT_COMMAND,M as ReactPluginHostExtension,v as mountReactExtensionComponent,R as mountReactPluginComponent,C as mountReactPluginElement,_ as mountReactPluginHost};

package/LexicalReactProviderExtension.dev.js

@@ -0,0 +1,33 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * 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 lexical = require('lexical');
+
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ */
+
+/**
+ * An extension used to declare that there is a LexicalExtensionComposer or
+ * ReactPluginHostExtension available so that we can issue runtime warnings
+ * when plugins that depend on React are hosted in an environment
+ * where it is not ever going to be rendered.
+ *
+ * It is a separate extension so it can be used as a peer dependency.
+ */
+const ReactProviderExtension = lexical.defineExtension({
+  name: '@lexical/react/ReactProvider'
+});
+
+exports.ReactProviderExtension = ReactProviderExtension;

package/LexicalReactProviderExtension.dev.mjs

@@ -0,0 +1,31 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ */
+
+import { defineExtension } from 'lexical';
+
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ */
+
+/**
+ * An extension used to declare that there is a LexicalExtensionComposer or
+ * ReactPluginHostExtension available so that we can issue runtime warnings
+ * when plugins that depend on React are hosted in an environment
+ * where it is not ever going to be rendered.
+ *
+ * It is a separate extension so it can be used as a peer dependency.
+ */
+const ReactProviderExtension = defineExtension({
+  name: '@lexical/react/ReactProvider'
+});
+
+export { ReactProviderExtension };

package/LexicalReactProviderExtension.js

@@ -0,0 +1,11 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ */
+
+'use strict'
+const LexicalReactProviderExtension = process.env.NODE_ENV !== 'production' ? require('./LexicalReactProviderExtension.dev.js') : require('./LexicalReactProviderExtension.prod.js');
+module.exports = LexicalReactProviderExtension;

package/LexicalReactProviderExtension.js.flow

@@ -0,0 +1,12 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ * @flow strict
+ */
+
+/**
+ * LexicalReactProviderExtension
+ */

package/LexicalReactProviderExtension.mjs

@@ -0,0 +1,12 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ */
+
+import * as modDev from './LexicalReactProviderExtension.dev.mjs';
+import * as modProd from './LexicalReactProviderExtension.prod.mjs';
+const mod = process.env.NODE_ENV !== 'production' ? modDev : modProd;
+export const ReactProviderExtension = mod.ReactProviderExtension;

package/LexicalReactProviderExtension.node.mjs

@@ -0,0 +1,10 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ */
+
+const mod = await (process.env.NODE_ENV !== 'production' ? import('./LexicalReactProviderExtension.dev.mjs') : import('./LexicalReactProviderExtension.prod.mjs'));
+export const ReactProviderExtension = mod.ReactProviderExtension;

package/LexicalReactProviderExtension.prod.js

@@ -0,0 +1,9 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ */
+
+"use strict";const e=require("lexical").defineExtension({name:"@lexical/react/ReactProvider"});exports.ReactProviderExtension=e;

package/LexicalReactProviderExtension.prod.mjs

@@ -0,0 +1,9 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ */
+
+import{defineExtension as e}from"lexical";const r=e({name:"@lexical/react/ReactProvider"});export{r as ReactProviderExtension};

package/LexicalRichTextPlugin.d.ts

@@ -6,7 +6,7 @@
  *
  */
 import type { JSX } from 'react';
-import { ErrorBoundaryType } from './shared/useDecorators';
+import { type ErrorBoundaryType } from './shared/LegacyDecorators';
 export declare function RichTextPlugin({ contentEditable, placeholder, ErrorBoundary, }: {
     contentEditable: JSX.Element;
     placeholder?: ((isEditable: boolean) => null | JSX.Element) | null | JSX.Element;

package/LexicalRichTextPlugin.dev.js

@@ -10,11 +10,13 @@
 
 var LexicalComposerContext = require('@lexical/react/LexicalComposerContext');
 var useLexicalEditable = require('@lexical/react/useLexicalEditable');
-var text = require('@lexical/text');
-var utils = require('@lexical/utils');
+var extension = require('@lexical/extension');
+var ReactProviderExtension = require('@lexical/react/ReactProviderExtension');
 var react = require('react');
 var reactDom = require('react-dom');
 var jsxRuntime = require('react/jsx-runtime');
+var text = require('@lexical/text');
+var utils = require('@lexical/utils');
 var dragon = require('@lexical/dragon');
 var richText = require('@lexical/rich-text');
 
@@ -26,7 +28,11 @@ var richText = require('@lexical/rich-text');
  *
  */
 
-const CAN_USE_DOM = typeof window !== 'undefined' && typeof window.document !== 'undefined' && typeof window.document.createElement !== 'undefined';
+// Do not require this module directly! Use normal `invariant` calls.
+
+function formatDevErrorMessage(message) {
+  throw new Error(message);
+}
 
 /**
  * Copyright (c) Meta Platforms, Inc. and affiliates.
@@ -36,11 +42,7 @@ const CAN_USE_DOM = typeof window !== 'undefined' && typeof window.document !==
  *
  */
 
-
-// This workaround is no longer necessary in React 19,
-// but we currently support React >=17.x
-// https://github.com/facebook/react/pull/26395
-const useLayoutEffectImpl = CAN_USE_DOM ? react.useLayoutEffect : react.useEffect;
+const CAN_USE_DOM = typeof window !== 'undefined' && typeof window.document !== 'undefined' && typeof window.document.createElement !== 'undefined';
 
 /**
  * Copyright (c) Meta Platforms, Inc. and affiliates.
@@ -50,26 +52,11 @@ const useLayoutEffectImpl = CAN_USE_DOM ? react.useLayoutEffect : react.useEffec
  *
  */
 
-function canShowPlaceholderFromCurrentEditorState(editor) {
-  const currentCanShowPlaceholder = editor.getEditorState().read(text.$canShowPlaceholderCurry(editor.isComposing()));
-  return currentCanShowPlaceholder;
-}
-function useCanShowPlaceholder(editor) {
-  const [canShowPlaceholder, setCanShowPlaceholder] = react.useState(() => canShowPlaceholderFromCurrentEditorState(editor));
-  useLayoutEffectImpl(() => {
-    function resetCanShowPlaceholder() {
-      const currentCanShowPlaceholder = canShowPlaceholderFromCurrentEditorState(editor);
-      setCanShowPlaceholder(currentCanShowPlaceholder);
-    }
-    resetCanShowPlaceholder();
-    return utils.mergeRegister(editor.registerUpdateListener(() => {
-      resetCanShowPlaceholder();
-    }), editor.registerEditableListener(() => {
-      resetCanShowPlaceholder();
-    }));
-  }, [editor]);
-  return canShowPlaceholder;
-}
+
+// This workaround is no longer necessary in React 19,
+// but we currently support React >=17.x
+// https://github.com/facebook/react/pull/26395
+const useLayoutEffectImpl = CAN_USE_DOM ? react.useLayoutEffect : react.useEffect;
 
 /**
  * Copyright (c) Meta Platforms, Inc. and affiliates.
@@ -119,6 +106,72 @@ function useDecorators(editor, ErrorBoundary) {
   }, [ErrorBoundary, decorators, editor]);
 }
 
+function isUsingReactExtension(editor) {
+  const builder = extension.LexicalBuilder.maybeFromEditor(editor);
+  if (builder && builder.hasExtensionByName(ReactProviderExtension.ReactProviderExtension.name)) {
+    for (const name of ['@lexical/plain-text', '@lexical/rich-text']) {
+      if (!!builder.hasExtensionByName(name)) {
+        formatDevErrorMessage(`LexicalBuilder: @lexical/react legacy text plugins conflict with the ${name} extension. Remove the legacy <RichTextPlugin/> or <PlainTextPlugin/> component.`);
+      }
+    }
+    return true;
+  }
+  return false;
+}
+function Decorators({
+  editor,
+  ErrorBoundary
+}) {
+  return useDecorators(editor, ErrorBoundary);
+}
+
+/**
+ * @internal
+ *
+ * When using @lexical/extension, the ReactProvider is expected to handle
+ * rendering decorators. This component allows RichTextPlugin and
+ * PlainTextPlugin to be used in extension projects that have not yet
+ * migrated to use RichTextExtension or PlainTextExtension.
+ **/
+function LegacyDecorators({
+  editor,
+  ErrorBoundary
+}) {
+  return isUsingReactExtension(editor) ? null : /*#__PURE__*/jsxRuntime.jsx(Decorators, {
+    editor: editor,
+    ErrorBoundary: ErrorBoundary
+  });
+}
+
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ */
+
+function canShowPlaceholderFromCurrentEditorState(editor) {
+  const currentCanShowPlaceholder = editor.getEditorState().read(text.$canShowPlaceholderCurry(editor.isComposing()));
+  return currentCanShowPlaceholder;
+}
+function useCanShowPlaceholder(editor) {
+  const [canShowPlaceholder, setCanShowPlaceholder] = react.useState(() => canShowPlaceholderFromCurrentEditorState(editor));
+  useLayoutEffectImpl(() => {
+    function resetCanShowPlaceholder() {
+      const currentCanShowPlaceholder = canShowPlaceholderFromCurrentEditorState(editor);
+      setCanShowPlaceholder(currentCanShowPlaceholder);
+    }
+    resetCanShowPlaceholder();
+    return utils.mergeRegister(editor.registerUpdateListener(() => {
+      resetCanShowPlaceholder();
+    }), editor.registerEditableListener(() => {
+      resetCanShowPlaceholder();
+    }));
+  }, [editor]);
+  return canShowPlaceholder;
+}
+
 /**
  * Copyright (c) Meta Platforms, Inc. and affiliates.
  *
@@ -151,12 +204,14 @@ function RichTextPlugin({
   ErrorBoundary
 }) {
   const [editor] = LexicalComposerContext.useLexicalComposerContext();
-  const decorators = useDecorators(editor, ErrorBoundary);
   useRichTextSetup(editor);
   return /*#__PURE__*/jsxRuntime.jsxs(jsxRuntime.Fragment, {
     children: [contentEditable, /*#__PURE__*/jsxRuntime.jsx(Placeholder, {
       content: placeholder
-    }), decorators]
+    }), /*#__PURE__*/jsxRuntime.jsx(LegacyDecorators, {
+      editor: editor,
+      ErrorBoundary: ErrorBoundary
+    })]
   });
 }