@ekz/lexical-react 0.40.0

package/LexicalContentEditable.dev.js

@@ -0,0 +1,242 @@
+/**
+ * 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 LexicalComposerContext = require('@ekz/lexical-react/LexicalComposerContext');
+var react = require('react');
+var jsxRuntime = require('react/jsx-runtime');
+var lexicalText = require('@ekz/lexical-text');
+var lexicalUtils = require('@ekz/lexical-utils');
+
+/**
+ * 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 CAN_USE_DOM = typeof window !== 'undefined' && typeof window.document !== 'undefined' && typeof window.document.createElement !== 'undefined';
+
+/**
+ * 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.
+ *
+ */
+
+
+// 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.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ */
+
+function mergeRefs(...refs) {
+  return value => {
+    for (const ref of refs) {
+      if (typeof ref === 'function') {
+        ref(value);
+      } else if (ref != null) {
+        ref.current = value;
+      }
+    }
+  };
+}
+
+/**
+ * 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 ContentEditableElementImpl({
+  editor,
+  ariaActiveDescendant,
+  ariaAutoComplete,
+  ariaControls,
+  ariaDescribedBy,
+  ariaErrorMessage,
+  ariaExpanded,
+  ariaInvalid,
+  ariaLabel,
+  ariaLabelledBy,
+  ariaMultiline,
+  ariaOwns,
+  ariaRequired,
+  autoCapitalize,
+  className,
+  id,
+  role = 'textbox',
+  spellCheck = true,
+  style,
+  tabIndex,
+  'data-testid': testid,
+  ...rest
+}, ref) {
+  const [isEditable, setEditable] = react.useState(editor.isEditable());
+  const handleRef = react.useCallback(rootElement => {
+    // defaultView is required for a root element.
+    // In multi-window setups, the defaultView may not exist at certain points.
+    if (rootElement && rootElement.ownerDocument && rootElement.ownerDocument.defaultView) {
+      editor.setRootElement(rootElement);
+    } else {
+      editor.setRootElement(null);
+    }
+  }, [editor]);
+  const mergedRefs = react.useMemo(() => mergeRefs(ref, handleRef), [handleRef, ref]);
+  useLayoutEffectImpl(() => {
+    setEditable(editor.isEditable());
+    return editor.registerEditableListener(currentIsEditable => {
+      setEditable(currentIsEditable);
+    });
+  }, [editor]);
+  return /*#__PURE__*/jsxRuntime.jsx("div", {
+    "aria-activedescendant": isEditable ? ariaActiveDescendant : undefined,
+    "aria-autocomplete": isEditable ? ariaAutoComplete : 'none',
+    "aria-controls": isEditable ? ariaControls : undefined,
+    "aria-describedby": ariaDescribedBy
+    // for compat, only override aria-errormessage if ariaErrorMessage is defined
+    ,
+    ...(ariaErrorMessage != null ? {
+      'aria-errormessage': ariaErrorMessage
+    } : {}),
+    "aria-expanded": isEditable && role === 'combobox' ? !!ariaExpanded : undefined
+    // for compat, only override aria-invalid if ariaInvalid is defined
+    ,
+    ...(ariaInvalid != null ? {
+      'aria-invalid': ariaInvalid
+    } : {}),
+    "aria-label": ariaLabel,
+    "aria-labelledby": ariaLabelledBy,
+    "aria-multiline": ariaMultiline,
+    "aria-owns": isEditable ? ariaOwns : undefined,
+    "aria-readonly": isEditable ? undefined : true,
+    "aria-required": ariaRequired,
+    autoCapitalize: autoCapitalize,
+    className: className,
+    contentEditable: isEditable,
+    "data-testid": testid,
+    id: id,
+    ref: mergedRefs,
+    role: role,
+    spellCheck: spellCheck,
+    style: style,
+    tabIndex: tabIndex,
+    ...rest
+  });
+}
+const ContentEditableElement = /*#__PURE__*/react.forwardRef(ContentEditableElementImpl);
+
+/**
+ * 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(lexicalText.$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 lexicalUtils.mergeRegister(editor.registerUpdateListener(() => {
+      resetCanShowPlaceholder();
+    }), editor.registerEditableListener(() => {
+      resetCanShowPlaceholder();
+    }));
+  }, [editor]);
+  return canShowPlaceholder;
+}
+
+/**
+ * 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.
+ *
+ */
+
+
+/**
+ * @deprecated This type has been renamed to `ContentEditableProps` to provide a clearer and more descriptive name.
+ * For backward compatibility, this type is still exported as `Props`, but it is recommended to migrate to using `ContentEditableProps` instead.
+ *
+ * This alias is maintained for compatibility purposes but may be removed in future versions.
+ * Please update your codebase to use `ContentEditableProps` to ensure long-term maintainability.
+ */
+
+const ContentEditable = /*#__PURE__*/react.forwardRef(ContentEditableImpl);
+function ContentEditableImpl(props, ref) {
+  const {
+    placeholder,
+    ...rest
+  } = props;
+  const [editor] = LexicalComposerContext.useLexicalComposerContext();
+  return /*#__PURE__*/jsxRuntime.jsxs(jsxRuntime.Fragment, {
+    children: [/*#__PURE__*/jsxRuntime.jsx(ContentEditableElement, {
+      editor: editor,
+      ...rest,
+      ref: ref
+    }), placeholder != null && /*#__PURE__*/jsxRuntime.jsx(Placeholder, {
+      editor: editor,
+      content: placeholder
+    })]
+  });
+}
+function Placeholder({
+  content,
+  editor
+}) {
+  const showPlaceholder = useCanShowPlaceholder(editor);
+  const [isEditable, setEditable] = react.useState(editor.isEditable());
+  react.useLayoutEffect(() => {
+    setEditable(editor.isEditable());
+    return editor.registerEditableListener(currentIsEditable => {
+      setEditable(currentIsEditable);
+    });
+  }, [editor]);
+  if (!showPlaceholder) {
+    return null;
+  }
+  let placeholder = null;
+  if (typeof content === 'function') {
+    placeholder = content(isEditable);
+  } else if (content !== null) {
+    placeholder = content;
+  }
+  if (placeholder === null) {
+    return null;
+  }
+  return /*#__PURE__*/jsxRuntime.jsx("div", {
+    "aria-hidden": true,
+    children: placeholder
+  });
+}
+
+exports.ContentEditable = ContentEditable;
+exports.ContentEditableElement = ContentEditableElement;

package/LexicalContentEditable.dev.mjs

@@ -0,0 +1,239 @@
+/**
+ * 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 { useLexicalComposerContext } from '@ekz/lexical-react/LexicalComposerContext';
+import { useLayoutEffect, useEffect, forwardRef, useState, useCallback, useMemo } from 'react';
+import { jsx, jsxs, Fragment } from 'react/jsx-runtime';
+import { $canShowPlaceholderCurry } from '@ekz/lexical-text';
+import { mergeRegister } from '@ekz/lexical-utils';
+
+/**
+ * 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 CAN_USE_DOM = typeof window !== 'undefined' && typeof window.document !== 'undefined' && typeof window.document.createElement !== 'undefined';
+
+/**
+ * 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.
+ *
+ */
+
+
+// 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 ? useLayoutEffect : useEffect;
+
+/**
+ * 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 mergeRefs(...refs) {
+  return value => {
+    for (const ref of refs) {
+      if (typeof ref === 'function') {
+        ref(value);
+      } else if (ref != null) {
+        ref.current = value;
+      }
+    }
+  };
+}
+
+/**
+ * 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 ContentEditableElementImpl({
+  editor,
+  ariaActiveDescendant,
+  ariaAutoComplete,
+  ariaControls,
+  ariaDescribedBy,
+  ariaErrorMessage,
+  ariaExpanded,
+  ariaInvalid,
+  ariaLabel,
+  ariaLabelledBy,
+  ariaMultiline,
+  ariaOwns,
+  ariaRequired,
+  autoCapitalize,
+  className,
+  id,
+  role = 'textbox',
+  spellCheck = true,
+  style,
+  tabIndex,
+  'data-testid': testid,
+  ...rest
+}, ref) {
+  const [isEditable, setEditable] = useState(editor.isEditable());
+  const handleRef = useCallback(rootElement => {
+    // defaultView is required for a root element.
+    // In multi-window setups, the defaultView may not exist at certain points.
+    if (rootElement && rootElement.ownerDocument && rootElement.ownerDocument.defaultView) {
+      editor.setRootElement(rootElement);
+    } else {
+      editor.setRootElement(null);
+    }
+  }, [editor]);
+  const mergedRefs = useMemo(() => mergeRefs(ref, handleRef), [handleRef, ref]);
+  useLayoutEffectImpl(() => {
+    setEditable(editor.isEditable());
+    return editor.registerEditableListener(currentIsEditable => {
+      setEditable(currentIsEditable);
+    });
+  }, [editor]);
+  return /*#__PURE__*/jsx("div", {
+    "aria-activedescendant": isEditable ? ariaActiveDescendant : undefined,
+    "aria-autocomplete": isEditable ? ariaAutoComplete : 'none',
+    "aria-controls": isEditable ? ariaControls : undefined,
+    "aria-describedby": ariaDescribedBy
+    // for compat, only override aria-errormessage if ariaErrorMessage is defined
+    ,
+    ...(ariaErrorMessage != null ? {
+      'aria-errormessage': ariaErrorMessage
+    } : {}),
+    "aria-expanded": isEditable && role === 'combobox' ? !!ariaExpanded : undefined
+    // for compat, only override aria-invalid if ariaInvalid is defined
+    ,
+    ...(ariaInvalid != null ? {
+      'aria-invalid': ariaInvalid
+    } : {}),
+    "aria-label": ariaLabel,
+    "aria-labelledby": ariaLabelledBy,
+    "aria-multiline": ariaMultiline,
+    "aria-owns": isEditable ? ariaOwns : undefined,
+    "aria-readonly": isEditable ? undefined : true,
+    "aria-required": ariaRequired,
+    autoCapitalize: autoCapitalize,
+    className: className,
+    contentEditable: isEditable,
+    "data-testid": testid,
+    id: id,
+    ref: mergedRefs,
+    role: role,
+    spellCheck: spellCheck,
+    style: style,
+    tabIndex: tabIndex,
+    ...rest
+  });
+}
+const ContentEditableElement = /*#__PURE__*/forwardRef(ContentEditableElementImpl);
+
+/**
+ * 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($canShowPlaceholderCurry(editor.isComposing()));
+  return currentCanShowPlaceholder;
+}
+function useCanShowPlaceholder(editor) {
+  const [canShowPlaceholder, setCanShowPlaceholder] = useState(() => canShowPlaceholderFromCurrentEditorState(editor));
+  useLayoutEffectImpl(() => {
+    function resetCanShowPlaceholder() {
+      const currentCanShowPlaceholder = canShowPlaceholderFromCurrentEditorState(editor);
+      setCanShowPlaceholder(currentCanShowPlaceholder);
+    }
+    resetCanShowPlaceholder();
+    return mergeRegister(editor.registerUpdateListener(() => {
+      resetCanShowPlaceholder();
+    }), editor.registerEditableListener(() => {
+      resetCanShowPlaceholder();
+    }));
+  }, [editor]);
+  return canShowPlaceholder;
+}
+
+/**
+ * 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.
+ *
+ */
+
+
+/**
+ * @deprecated This type has been renamed to `ContentEditableProps` to provide a clearer and more descriptive name.
+ * For backward compatibility, this type is still exported as `Props`, but it is recommended to migrate to using `ContentEditableProps` instead.
+ *
+ * This alias is maintained for compatibility purposes but may be removed in future versions.
+ * Please update your codebase to use `ContentEditableProps` to ensure long-term maintainability.
+ */
+
+const ContentEditable = /*#__PURE__*/forwardRef(ContentEditableImpl);
+function ContentEditableImpl(props, ref) {
+  const {
+    placeholder,
+    ...rest
+  } = props;
+  const [editor] = useLexicalComposerContext();
+  return /*#__PURE__*/jsxs(Fragment, {
+    children: [/*#__PURE__*/jsx(ContentEditableElement, {
+      editor: editor,
+      ...rest,
+      ref: ref
+    }), placeholder != null && /*#__PURE__*/jsx(Placeholder, {
+      editor: editor,
+      content: placeholder
+    })]
+  });
+}
+function Placeholder({
+  content,
+  editor
+}) {
+  const showPlaceholder = useCanShowPlaceholder(editor);
+  const [isEditable, setEditable] = useState(editor.isEditable());
+  useLayoutEffect(() => {
+    setEditable(editor.isEditable());
+    return editor.registerEditableListener(currentIsEditable => {
+      setEditable(currentIsEditable);
+    });
+  }, [editor]);
+  if (!showPlaceholder) {
+    return null;
+  }
+  let placeholder = null;
+  if (typeof content === 'function') {
+    placeholder = content(isEditable);
+  } else if (content !== null) {
+    placeholder = content;
+  }
+  if (placeholder === null) {
+    return null;
+  }
+  return /*#__PURE__*/jsx("div", {
+    "aria-hidden": true,
+    children: placeholder
+  });
+}
+
+export { ContentEditable, ContentEditableElement };

package/LexicalContentEditable.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 LexicalContentEditable = process.env.NODE_ENV !== 'production' ? require('./LexicalContentEditable.dev.js') : require('./LexicalContentEditable.prod.js');
+module.exports = LexicalContentEditable;

package/LexicalContentEditable.js.flow

@@ -0,0 +1,80 @@
+/**
+ * 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
+ */
+
+import type { LexicalEditor } from '@ekz/lexical';
+// $FlowFixMe[cannot-resolve-module] - Not able to type this with a flow extension
+import type {TRefFor} from 'CoreTypes.flow';
+
+import * as React from 'react';
+
+type InlineStyle = {
+  [key: string]: mixed,
+};
+
+// Due to Flow limitations, we prefer fixed types over the built-in inexact HTMLElement
+type HTMLDivElementDOMProps = $ReadOnly<{
+  'aria-label'?: void | string,
+  'aria-labeledby'?: void | string,
+  'aria-activedescendant'?: void | string,
+  'aria-autocomplete'?: void | string,
+  'aria-describedby'?: void | string,
+  'aria-errormessage'?: void | string,
+  'aria-invalid'?: void | boolean,
+  'aria-owns'?: void | string,
+  'title'?: void | string,
+  onClick?: void | ((e: SyntheticEvent<HTMLDivElement>) => mixed),
+  autoCapitalize?: void | boolean,
+  autoComplete?: void | boolean,
+  autoCorrect?: void | boolean,
+  id?: void | string,
+  className?: void | string,
+  'data-testid'?: void | string,
+  role?: void | string,
+  spellCheck?: void | boolean,
+  suppressContentEditableWarning?: void | boolean,
+  tabIndex?: void | number,
+  style?: void | InlineStyle | CSSStyleDeclaration,
+  'data-testid'?: void | string,
+}>;
+
+export type PlaceholderProps =
+  | $ReadOnly<{
+      'aria-placeholder'?: void,
+      placeholder?: null,
+    }>
+  | $ReadOnly<{
+      'aria-placeholder': string,
+      placeholder:
+        | ((isEditable: boolean) => null | React.Node)
+        | null
+        | React.Node,
+    }>;
+
+export type Props = $ReadOnly<{
+  ...HTMLDivElementDOMProps,
+  ariaActiveDescendant?: string,
+  ariaAutoComplete?: string,
+  ariaControls?: string,
+  ariaDescribedBy?: string,
+  ariaErrorMessage?: string,
+  ariaExpanded?: boolean,
+  ariaInvalid?: boolean,
+  ariaLabel?: string,
+  ariaLabelledBy?: string,
+  ariaMultiline?: boolean,
+  ariaOwns?: string,
+  ariaRequired?: string,
+  autoCapitalize?: boolean,
+  ...PlaceholderProps,
+}>;
+
+declare export var ContentEditable: component(
+  ref?: React.RefSetter<HTMLDivElement>,
+  ...Props
+);

package/LexicalContentEditable.mjs

@@ -0,0 +1,13 @@
+/**
+ * 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 './LexicalContentEditable.dev.mjs';
+import * as modProd from './LexicalContentEditable.prod.mjs';
+const mod = process.env.NODE_ENV !== 'production' ? modDev : modProd;
+export const ContentEditable = mod.ContentEditable;
+export const ContentEditableElement = mod.ContentEditableElement;

package/LexicalContentEditable.node.mjs

@@ -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.
+ *
+ */
+
+const mod = await (process.env.NODE_ENV !== 'production' ? import('./LexicalContentEditable.dev.mjs') : import('./LexicalContentEditable.prod.mjs'));
+export const ContentEditable = mod.ContentEditable;
+export const ContentEditableElement = mod.ContentEditableElement;

package/LexicalContentEditable.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("@ekz/lexical-react/LexicalComposerContext"),t=require("react"),a=require("react/jsx-runtime"),i=require("@ekz/lexical-text"),r=require("@ekz/lexical-utils");const n="undefined"!=typeof window&&void 0!==window.document&&void 0!==window.document.createElement?t.useLayoutEffect:t.useEffect;function o({editor:e,ariaActiveDescendant:i,ariaAutoComplete:r,ariaControls:o,ariaDescribedBy:l,ariaErrorMessage:s,ariaExpanded:d,ariaInvalid:u,ariaLabel:c,ariaLabelledBy:f,ariaMultiline:b,ariaOwns:x,ariaRequired:m,autoCapitalize:E,className:p,id:C,role:v="textbox",spellCheck:w=!0,style:y,tabIndex:g,"data-testid":L,...h},q){const[j,k]=t.useState(e.isEditable()),R=t.useCallback(t=>{t&&t.ownerDocument&&t.ownerDocument.defaultView?e.setRootElement(t):e.setRootElement(null)},[e]),z=t.useMemo(()=>function(...e){return t=>{for(const a of e)"function"==typeof a?a(t):null!=a&&(a.current=t)}}(q,R),[R,q]);return n(()=>(k(e.isEditable()),e.registerEditableListener(e=>{k(e)})),[e]),a.jsx("div",{"aria-activedescendant":j?i:void 0,"aria-autocomplete":j?r:"none","aria-controls":j?o:void 0,"aria-describedby":l,...null!=s?{"aria-errormessage":s}:{},"aria-expanded":j&&"combobox"===v?!!d:void 0,...null!=u?{"aria-invalid":u}:{},"aria-label":c,"aria-labelledby":f,"aria-multiline":b,"aria-owns":j?x:void 0,"aria-readonly":!j||void 0,"aria-required":m,autoCapitalize:E,className:p,contentEditable:j,"data-testid":L,id:C,ref:z,role:v,spellCheck:w,style:y,tabIndex:g,...h})}const l=t.forwardRef(o);function s(e){return e.getEditorState().read(i.$canShowPlaceholderCurry(e.isComposing()))}const d=t.forwardRef(u);function u(t,i){const{placeholder:r,...n}=t,[o]=e.useLexicalComposerContext();return a.jsxs(a.Fragment,{children:[a.jsx(l,{editor:o,...n,ref:i}),null!=r&&a.jsx(c,{editor:o,content:r})]})}function c({content:e,editor:i}){const o=function(e){const[a,i]=t.useState(()=>s(e));return n(()=>{function t(){const t=s(e);i(t)}return t(),r.mergeRegister(e.registerUpdateListener(()=>{t()}),e.registerEditableListener(()=>{t()}))},[e]),a}(i),[l,d]=t.useState(i.isEditable());if(t.useLayoutEffect(()=>(d(i.isEditable()),i.registerEditableListener(e=>{d(e)})),[i]),!o)return null;let u=null;return"function"==typeof e?u=e(l):null!==e&&(u=e),null===u?null:a.jsx("div",{"aria-hidden":!0,children:u})}exports.ContentEditable=d,exports.ContentEditableElement=l;

package/LexicalContentEditable.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{useLexicalComposerContext as e}from"@ekz/lexical-react/LexicalComposerContext";import{useLayoutEffect as t,useEffect as i,forwardRef as a,useState as r,useCallback as n,useMemo as o}from"react";import{jsx as l,jsxs as d,Fragment as c}from"react/jsx-runtime";import{$canShowPlaceholderCurry as s}from"@ekz/lexical-text";import{mergeRegister as u}from"@ekz/lexical-utils";const m="undefined"!=typeof window&&void 0!==window.document&&void 0!==window.document.createElement?t:i;function f({editor:e,ariaActiveDescendant:t,ariaAutoComplete:i,ariaControls:a,ariaDescribedBy:d,ariaErrorMessage:c,ariaExpanded:s,ariaInvalid:u,ariaLabel:f,ariaLabelledBy:b,ariaMultiline:p,ariaOwns:x,ariaRequired:E,autoCapitalize:v,className:w,id:y,role:C="textbox",spellCheck:g=!0,style:L,tabIndex:h,"data-testid":k,...z},D){const[I,R]=r(e.isEditable()),q=n(t=>{t&&t.ownerDocument&&t.ownerDocument.defaultView?e.setRootElement(t):e.setRootElement(null)},[e]),A=o(()=>function(...e){return t=>{for(const i of e)"function"==typeof i?i(t):null!=i&&(i.current=t)}}(D,q),[q,D]);return m(()=>(R(e.isEditable()),e.registerEditableListener(e=>{R(e)})),[e]),l("div",{"aria-activedescendant":I?t:void 0,"aria-autocomplete":I?i:"none","aria-controls":I?a:void 0,"aria-describedby":d,...null!=c?{"aria-errormessage":c}:{},"aria-expanded":I&&"combobox"===C?!!s:void 0,...null!=u?{"aria-invalid":u}:{},"aria-label":f,"aria-labelledby":b,"aria-multiline":p,"aria-owns":I?x:void 0,"aria-readonly":!I||void 0,"aria-required":E,autoCapitalize:v,className:w,contentEditable:I,"data-testid":k,id:y,ref:A,role:C,spellCheck:g,style:L,tabIndex:h,...z})}const b=a(f);function p(e){return e.getEditorState().read(s(e.isComposing()))}const x=a(E);function E(t,i){const{placeholder:a,...r}=t,[n]=e();return d(c,{children:[l(b,{editor:n,...r,ref:i}),null!=a&&l(v,{editor:n,content:a})]})}function v({content:e,editor:i}){const a=function(e){const[t,i]=r(()=>p(e));return m(()=>{function t(){const t=p(e);i(t)}return t(),u(e.registerUpdateListener(()=>{t()}),e.registerEditableListener(()=>{t()}))},[e]),t}(i),[n,o]=r(i.isEditable());if(t(()=>(o(i.isEditable()),i.registerEditableListener(e=>{o(e)})),[i]),!a)return null;let d=null;return"function"==typeof e?d=e(n):null!==e&&(d=e),null===d?null:l("div",{"aria-hidden":!0,children:d})}export{x as ContentEditable,b as ContentEditableElement};

package/LexicalContextMenuPlugin.d.ts

@@ -0,0 +1,36 @@
+/**
+ * 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 type { MenuRenderFn, MenuResolution } from './shared/LexicalMenu';
+import type { JSX } from 'react';
+import { CommandListenerPriority, LexicalNode } from '@ekz/lexical';
+import { ReactPortal, RefObject } from 'react';
+import { MenuOption } from './shared/LexicalMenu';
+export type ContextMenuRenderFn<TOption extends MenuOption> = (anchorElementRef: RefObject<HTMLElement | null>, itemProps: {
+    selectedIndex: number | null;
+    selectOptionAndCleanUp: (option: TOption) => void;
+    setHighlightedIndex: (index: number) => void;
+    options: Array<TOption>;
+}, menuProps: {
+    setMenuRef: (element: HTMLElement | null) => void;
+}) => ReactPortal | JSX.Element | null;
+export type LexicalContextMenuPluginProps<TOption extends MenuOption> = {
+    onSelectOption: (option: TOption, textNodeContainingQuery: LexicalNode | null, closeMenu: () => void, matchingString: string) => void;
+    options: Array<TOption>;
+    onClose?: () => void;
+    onWillOpen?: (event: MouseEvent) => void;
+    onOpen?: (resolution: MenuResolution) => void;
+    menuRenderFn: ContextMenuRenderFn<TOption>;
+    anchorClassName?: string;
+    commandPriority?: CommandListenerPriority;
+    parent?: HTMLElement;
+};
+/**
+ * @deprecated Use LexicalNodeContextMenuPlugin instead.
+ */
+export declare function LexicalContextMenuPlugin<TOption extends MenuOption>({ options, onWillOpen, onClose, onOpen, onSelectOption, menuRenderFn: contextMenuRenderFn, anchorClassName, commandPriority, parent, }: LexicalContextMenuPluginProps<TOption>): JSX.Element | null;
+export { MenuOption, MenuRenderFn, MenuResolution };