@lexical/react 0.49.1-nightly.20260901.0 → 0.50.0

package/dist/LexicalAutoEmbedPlugin.d.ts

@@ -5,53 +5,11 @@
  * LICENSE file in the root directory of this source tree.
  *
  */
-import { MenuOption, type MenuRenderFn } from '@lexical/react/LexicalNodeMenuPlugin';
-import { type CommandListenerPriority, type LexicalCommand, type LexicalEditor, type LexicalNode } from 'lexical';
+import { type AutoEmbedOption, type EmbedConfig } from '@lexical/react/LexicalAutoEmbedPluginUtils';
+import { type MenuRenderFn } from '@lexical/react/LexicalNodeMenuPlugin';
+import { type CommandListenerPriority } from 'lexical';
 import { type JSX } from 'react';
-/**
- * The result of matching a URL for an embed: the matched `url`, an `id`
- * identifying the embedded resource, and optional provider-specific `data`.
- */
-export type EmbedMatchResult<TEmbedMatchResult = unknown> = {
-    url: string;
-    id: string;
-    data?: TEmbedMatchResult;
-};
-/**
- * Describes a kind of embed (for example YouTube, a tweet, or Google Maps) that
- * {@link LexicalAutoEmbedPlugin} can detect and insert. Each config has a `type`
- * identifier, a `parseUrl` function that decides whether a URL matches and
- * extracts its data, and an `insertNode` function that inserts the corresponding
- * Lexical node.
- */
-export interface EmbedConfig<TEmbedMatchResultData = unknown, TEmbedMatchResult = EmbedMatchResult<TEmbedMatchResultData>> {
-    type: string;
-    parseUrl: (text: string) => Promise<TEmbedMatchResult | null> | TEmbedMatchResult | null;
-    insertNode: (editor: LexicalEditor, result: TEmbedMatchResult) => void;
-}
-/**
- * A general-purpose regular expression for detecting URLs, provided as a
- * convenience for implementing an {@link EmbedConfig}'s `parseUrl`.
- */
-export declare const URL_MATCHER: RegExp;
-/**
- * Command dispatched to start inserting an embed. Its payload is the `type` of
- * the {@link EmbedConfig} to use; {@link LexicalAutoEmbedPlugin} listens for it
- * and runs that config's URL detection flow.
- */
-export declare const INSERT_EMBED_COMMAND: LexicalCommand<EmbedConfig['type']>;
-/**
- * A {@link MenuOption} for the auto-embed menu, pairing a display `title` with
- * an `onSelect` callback invoked when the user chooses to embed the detected
- * URL.
- */
-export declare class AutoEmbedOption extends MenuOption {
-    title: string;
-    onSelect: (targetNode: LexicalNode | null) => void;
-    constructor(title: string, options: {
-        onSelect: (targetNode: LexicalNode | null) => void;
-    });
-}
+export { AutoEmbedOption, type EmbedConfig, type EmbedMatchResult, INSERT_EMBED_COMMAND, URL_MATCHER, } from '@lexical/react/LexicalAutoEmbedPluginUtils';
 type LexicalAutoEmbedPluginProps<TEmbedConfig extends EmbedConfig> = {
     /**
      * An array of configurations used to insert Embed elements
@@ -117,4 +75,3 @@ type LexicalAutoEmbedPluginProps<TEmbedConfig extends EmbedConfig> = {
  * ```
  */
 export declare function LexicalAutoEmbedPlugin<TEmbedConfig extends EmbedConfig>({ embedConfigs, onOpenEmbedModalForConfig, getMenuOptions, menuRenderFn, menuCommandPriority, }: LexicalAutoEmbedPluginProps<TEmbedConfig>): JSX.Element | null;
-export {};

package/dist/LexicalAutoEmbedPlugin.dev.js

@@ -9,6 +9,7 @@
 'use strict';
 
 var link = require('@lexical/link');
+var LexicalAutoEmbedPluginUtils = require('@lexical/react/LexicalAutoEmbedPluginUtils');
 var LexicalComposerContext = require('@lexical/react/LexicalComposerContext');
 var LexicalNodeMenuPlugin = require('@lexical/react/LexicalNodeMenuPlugin');
 var utils = require('@lexical/utils');
@@ -24,33 +25,6 @@ var jsxRuntime = require('react/jsx-runtime');
  *
  */
 
-/**
- * A general-purpose regular expression for detecting URLs, provided as a
- * convenience for implementing an {@link EmbedConfig}'s `parseUrl`.
- */
-const URL_MATCHER = /((https?:\/\/(www\.)?)|(www\.))[-a-zA-Z0-9@:%._+~#=]{1,256}\.[a-zA-Z0-9()]{1,6}\b([-a-zA-Z0-9()@:%_+.~#?&//=]*)/;
-
-/**
- * Command dispatched to start inserting an embed. Its payload is the `type` of
- * the {@link EmbedConfig} to use; {@link LexicalAutoEmbedPlugin} listens for it
- * and runs that config's URL detection flow.
- */
-const INSERT_EMBED_COMMAND = /* @__PURE__ */lexical.createCommand('INSERT_EMBED_COMMAND');
-
-/**
- * A {@link MenuOption} for the auto-embed menu, pairing a display `title` with
- * an `onSelect` callback invoked when the user chooses to embed the detected
- * URL.
- */
-class AutoEmbedOption extends LexicalNodeMenuPlugin.MenuOption {
-  title;
-  onSelect;
-  constructor(title, options) {
-    super(title);
-    this.title = title;
-    this.onSelect = options.onSelect.bind(this);
-  }
-}
 /**
  * Watches for pasted AutoLink nodes that match any of the provided embed configurations (e.g., YouTube, Twitter URLs).
  * When a match is found, it shows a menu offering to replace the link with an embedded node.
@@ -138,7 +112,7 @@ function LexicalAutoEmbedPlugin({
   }, [checkIfLinkNodeIsEmbeddable, editor, nodeKey, reset]);
   react.useEffect(() => {
     if (!onOpenEmbedModalForConfig) return;
-    return editor.registerCommand(INSERT_EMBED_COMMAND, embedConfigType => {
+    return editor.registerCommand(LexicalAutoEmbedPluginUtils.INSERT_EMBED_COMMAND, embedConfigType => {
       const embedConfig = embedConfigs.find(({
         type
       }) => type === embedConfigType);
@@ -193,7 +167,7 @@ function LexicalAutoEmbedPlugin({
   }) : null;
 }
 
-exports.AutoEmbedOption = AutoEmbedOption;
-exports.INSERT_EMBED_COMMAND = INSERT_EMBED_COMMAND;
+exports.AutoEmbedOption = LexicalAutoEmbedPluginUtils.AutoEmbedOption;
+exports.INSERT_EMBED_COMMAND = LexicalAutoEmbedPluginUtils.INSERT_EMBED_COMMAND;
+exports.URL_MATCHER = LexicalAutoEmbedPluginUtils.URL_MATCHER;
 exports.LexicalAutoEmbedPlugin = LexicalAutoEmbedPlugin;
-exports.URL_MATCHER = URL_MATCHER;

package/dist/LexicalAutoEmbedPlugin.dev.mjs

@@ -7,10 +7,12 @@
  */
 
 import { $isLinkNode, LinkNode, AutoLinkNode } from '@lexical/link';
+import { INSERT_EMBED_COMMAND } from '@lexical/react/LexicalAutoEmbedPluginUtils';
+export { AutoEmbedOption, INSERT_EMBED_COMMAND, URL_MATCHER } from '@lexical/react/LexicalAutoEmbedPluginUtils';
 import { useLexicalComposerContext } from '@lexical/react/LexicalComposerContext';
-import { MenuOption, LexicalNodeMenuPlugin } from '@lexical/react/LexicalNodeMenuPlugin';
+import { LexicalNodeMenuPlugin } from '@lexical/react/LexicalNodeMenuPlugin';
 import { objectKlassEquals } from '@lexical/utils';
-import { createCommand, $getNodeByKey, mergeRegister, PASTE_COMMAND, $onUpdate, COMMAND_PRIORITY_BEFORE_EDITOR, COMMAND_PRIORITY_EDITOR, $getSelection, COMMAND_PRIORITY_LOW, PASTE_TAG } from 'lexical';
+import { $getNodeByKey, mergeRegister, PASTE_COMMAND, $onUpdate, COMMAND_PRIORITY_BEFORE_EDITOR, COMMAND_PRIORITY_EDITOR, $getSelection, COMMAND_PRIORITY_LOW, PASTE_TAG } from 'lexical';
 import { useState, useCallback, useEffect, useMemo } from 'react';
 import { jsx } from 'react/jsx-runtime';
 
@@ -22,33 +24,6 @@ import { jsx } from 'react/jsx-runtime';
  *
  */
 
-/**
- * A general-purpose regular expression for detecting URLs, provided as a
- * convenience for implementing an {@link EmbedConfig}'s `parseUrl`.
- */
-const URL_MATCHER = /((https?:\/\/(www\.)?)|(www\.))[-a-zA-Z0-9@:%._+~#=]{1,256}\.[a-zA-Z0-9()]{1,6}\b([-a-zA-Z0-9()@:%_+.~#?&//=]*)/;
-
-/**
- * Command dispatched to start inserting an embed. Its payload is the `type` of
- * the {@link EmbedConfig} to use; {@link LexicalAutoEmbedPlugin} listens for it
- * and runs that config's URL detection flow.
- */
-const INSERT_EMBED_COMMAND = /* @__PURE__ */createCommand('INSERT_EMBED_COMMAND');
-
-/**
- * A {@link MenuOption} for the auto-embed menu, pairing a display `title` with
- * an `onSelect` callback invoked when the user chooses to embed the detected
- * URL.
- */
-class AutoEmbedOption extends MenuOption {
-  title;
-  onSelect;
-  constructor(title, options) {
-    super(title);
-    this.title = title;
-    this.onSelect = options.onSelect.bind(this);
-  }
-}
 /**
  * Watches for pasted AutoLink nodes that match any of the provided embed configurations (e.g., YouTube, Twitter URLs).
  * When a match is found, it shows a menu offering to replace the link with an embedded node.
@@ -191,4 +166,4 @@ function LexicalAutoEmbedPlugin({
   }) : null;
 }
 
-export { AutoEmbedOption, INSERT_EMBED_COMMAND, LexicalAutoEmbedPlugin, URL_MATCHER };
+export { LexicalAutoEmbedPlugin };

package/dist/LexicalAutoEmbedPlugin.prod.js

@@ -6,4 +6,4 @@
  *
  */
 
-"use strict";var e=require("@lexical/link"),t=require("@lexical/react/LexicalComposerContext"),n=require("@lexical/react/LexicalNodeMenuPlugin"),o=require("@lexical/utils"),l=require("lexical"),i=require("react"),r=require("react/jsx-runtime");const s=/* @__PURE__ */l.createCommand("INSERT_EMBED_COMMAND");class a extends n.MenuOption{title;onSelect;constructor(e,t){super(e),this.title=e,this.onSelect=t.onSelect.bind(this)}}exports.AutoEmbedOption=a,exports.INSERT_EMBED_COMMAND=s,exports.LexicalAutoEmbedPlugin=function({embedConfigs:a,onOpenEmbedModalForConfig:u,getMenuOptions:c,menuRenderFn:d,menuCommandPriority:p=l.COMMAND_PRIORITY_LOW}){const[m]=t.useLexicalComposerContext(),[C,M]=i.useState(null),[E,x]=i.useState(null),f=i.useCallback(()=>{M(null),x(null)},[]),N=i.useCallback(async t=>{const n=m.read("latest",function(){const n=l.$getNodeByKey(t);if(e.$isLinkNode(n))return n.getURL()});if(void 0!==n)for(const e of a){null!=await Promise.resolve(e.parseUrl(n))&&(x(e),M(t))}},[m,a]);i.useEffect(()=>{let t=!1;const n=(e,{updateTags:n})=>{for(const[o,i]of e)"created"===i&&n.has(l.PASTE_TAG)&&t?N(o):o===C&&f()};return l.mergeRegister(m.registerCommand(l.PASTE_COMMAND,e=>(t=o.objectKlassEquals(e,ClipboardEvent)&&null!==e.clipboardData&&/^\S+$/.test(e.clipboardData.getData("text/plain")),t&&l.$onUpdate(()=>{t=!1}),!1),l.COMMAND_PRIORITY_BEFORE_EDITOR),...[e.LinkNode,e.AutoLinkNode].map(e=>m.registerMutationListener(e,n,{skipInitialization:!0})))},[N,m,C,f]),i.useEffect(()=>{if(u)return m.registerCommand(s,e=>{const t=a.find(({type:t})=>t===e);return!!t&&(u(t),!0)},l.COMMAND_PRIORITY_EDITOR)},[m,a,u]);const O=i.useCallback(async function(){if(null!=E&&null!=C){const t=m.read("latest",()=>{const t=l.$getNodeByKey(C);return e.$isLinkNode(t)?t:null});if(e.$isLinkNode(t)){const e=await Promise.resolve(E.parseUrl(t.__url));null!=e&&m.update(()=>{l.$getSelection()||t.selectEnd(),E.insertNode(m,e),t.isAttached()&&t.remove()})}}},[E,m,C]),_=i.useMemo(()=>null!=E&&null!=C?c(E,O,f):[],[E,O,c,C,f]),g=i.useCallback((e,t,n)=>{m.update(()=>{e.onSelect(t),n()})},[m]);return null!=C?/*#__PURE__*/r.jsx(n.LexicalNodeMenuPlugin,{nodeKey:C,onClose:f,onSelectOption:g,options:_,menuRenderFn:d,commandPriority:p}):null},exports.URL_MATCHER=/((https?:\/\/(www\.)?)|(www\.))[-a-zA-Z0-9@:%._+~#=]{1,256}\.[a-zA-Z0-9()]{1,6}\b([-a-zA-Z0-9()@:%_+.~#?&//=]*)/;
+"use strict";var e=require("@lexical/link"),t=require("@lexical/react/LexicalAutoEmbedPluginUtils"),n=require("@lexical/react/LexicalComposerContext"),l=require("@lexical/react/LexicalNodeMenuPlugin"),i=require("@lexical/utils"),o=require("lexical"),r=require("react"),a=require("react/jsx-runtime");exports.AutoEmbedOption=t.AutoEmbedOption,exports.INSERT_EMBED_COMMAND=t.INSERT_EMBED_COMMAND,exports.URL_MATCHER=t.URL_MATCHER,exports.LexicalAutoEmbedPlugin=function({embedConfigs:s,onOpenEmbedModalForConfig:u,getMenuOptions:c,menuRenderFn:d,menuCommandPriority:E=o.COMMAND_PRIORITY_LOW}){const[m]=n.useLexicalComposerContext(),[p,M]=r.useState(null),[C,x]=r.useState(null),N=r.useCallback(()=>{M(null),x(null)},[]),R=r.useCallback(async t=>{const n=m.read("latest",function(){const n=o.$getNodeByKey(t);if(e.$isLinkNode(n))return n.getURL()});if(void 0!==n)for(const e of s){null!=await Promise.resolve(e.parseUrl(n))&&(x(e),M(t))}},[m,s]);r.useEffect(()=>{let t=!1;const n=(e,{updateTags:n})=>{for(const[l,i]of e)"created"===i&&n.has(o.PASTE_TAG)&&t?R(l):l===p&&N()};return o.mergeRegister(m.registerCommand(o.PASTE_COMMAND,e=>(t=i.objectKlassEquals(e,ClipboardEvent)&&null!==e.clipboardData&&/^\S+$/.test(e.clipboardData.getData("text/plain")),t&&o.$onUpdate(()=>{t=!1}),!1),o.COMMAND_PRIORITY_BEFORE_EDITOR),...[e.LinkNode,e.AutoLinkNode].map(e=>m.registerMutationListener(e,n,{skipInitialization:!0})))},[R,m,p,N]),r.useEffect(()=>{if(u)return m.registerCommand(t.INSERT_EMBED_COMMAND,e=>{const t=s.find(({type:t})=>t===e);return!!t&&(u(t),!0)},o.COMMAND_PRIORITY_EDITOR)},[m,s,u]);const f=r.useCallback(async function(){if(null!=C&&null!=p){const t=m.read("latest",()=>{const t=o.$getNodeByKey(p);return e.$isLinkNode(t)?t:null});if(e.$isLinkNode(t)){const e=await Promise.resolve(C.parseUrl(t.__url));null!=e&&m.update(()=>{o.$getSelection()||t.selectEnd(),C.insertNode(m,e),t.isAttached()&&t.remove()})}}},[C,m,p]),O=r.useMemo(()=>null!=C&&null!=p?c(C,f,N):[],[C,f,c,p,N]),_=r.useCallback((e,t,n)=>{m.update(()=>{e.onSelect(t),n()})},[m]);return null!=p?/*#__PURE__*/a.jsx(l.LexicalNodeMenuPlugin,{nodeKey:p,onClose:N,onSelectOption:_,options:O,menuRenderFn:d,commandPriority:E}):null};

package/dist/LexicalAutoEmbedPlugin.prod.mjs

@@ -6,4 +6,4 @@
  *
  */
 
-import{$isLinkNode as t,LinkNode as e,AutoLinkNode as n}from"@lexical/link";import{useLexicalComposerContext as o}from"@lexical/react/LexicalComposerContext";import{MenuOption as r,LexicalNodeMenuPlugin as l}from"@lexical/react/LexicalNodeMenuPlugin";import{objectKlassEquals as i}from"@lexical/utils";import{createCommand as a,$getNodeByKey as s,mergeRegister as c,PASTE_COMMAND as u,$onUpdate as m,COMMAND_PRIORITY_BEFORE_EDITOR as d,COMMAND_PRIORITY_EDITOR as p,$getSelection as f,COMMAND_PRIORITY_LOW as x,PASTE_TAG as g}from"lexical";import{useState as C,useCallback as w,useEffect as b,useMemo as M}from"react";import{jsx as S}from"react/jsx-runtime";const h=/((https?:\/\/(www\.)?)|(www\.))[-a-zA-Z0-9@:%._+~#=]{1,256}\.[a-zA-Z0-9()]{1,6}\b([-a-zA-Z0-9()@:%_+.~#?&//=]*)/,y=/* @__PURE__ */a("INSERT_EMBED_COMMAND");class E extends r{title;onSelect;constructor(t,e){super(t),this.title=t,this.onSelect=e.onSelect.bind(this)}}function _({embedConfigs:r,onOpenEmbedModalForConfig:a,getMenuOptions:h,menuRenderFn:E,menuCommandPriority:_=x}){const[v]=o(),[A,D]=C(null),[P,z]=C(null),L=w(()=>{D(null),z(null)},[]),N=w(async e=>{const n=v.read("latest",function(){const n=s(e);if(t(n))return n.getURL()});if(void 0!==n)for(const t of r){null!=await Promise.resolve(t.parseUrl(n))&&(z(t),D(e))}},[v,r]);b(()=>{let t=!1;const o=(e,{updateTags:n})=>{for(const[o,r]of e)"created"===r&&n.has(g)&&t?N(o):o===A&&L()};return c(v.registerCommand(u,e=>(t=i(e,ClipboardEvent)&&null!==e.clipboardData&&/^\S+$/.test(e.clipboardData.getData("text/plain")),t&&m(()=>{t=!1}),!1),d),...[e,n].map(t=>v.registerMutationListener(t,o,{skipInitialization:!0})))},[N,v,A,L]),b(()=>{if(a)return v.registerCommand(y,t=>{const e=r.find(({type:e})=>e===t);return!!e&&(a(e),!0)},p)},[v,r,a]);const O=w(async function(){if(null!=P&&null!=A){const e=v.read("latest",()=>{const e=s(A);return t(e)?e:null});if(t(e)){const t=await Promise.resolve(P.parseUrl(e.__url));null!=t&&v.update(()=>{f()||e.selectEnd(),P.insertNode(v,t),e.isAttached()&&e.remove()})}}},[P,v,A]),R=M(()=>null!=P&&null!=A?h(P,O,L):[],[P,O,h,A,L]),F=w((t,e,n)=>{v.update(()=>{t.onSelect(e),n()})},[v]);return null!=A?/*#__PURE__*/S(l,{nodeKey:A,onClose:L,onSelectOption:F,options:R,menuRenderFn:E,commandPriority:_}):null}export{E as AutoEmbedOption,y as INSERT_EMBED_COMMAND,_ as LexicalAutoEmbedPlugin,h as URL_MATCHER};
+import{$isLinkNode as e,LinkNode as t,AutoLinkNode as n}from"@lexical/link";import{INSERT_EMBED_COMMAND as o}from"@lexical/react/LexicalAutoEmbedPluginUtils";export{AutoEmbedOption,INSERT_EMBED_COMMAND,URL_MATCHER}from"@lexical/react/LexicalAutoEmbedPluginUtils";import{useLexicalComposerContext as r}from"@lexical/react/LexicalComposerContext";import{LexicalNodeMenuPlugin as l}from"@lexical/react/LexicalNodeMenuPlugin";import{objectKlassEquals as i}from"@lexical/utils";import{$getNodeByKey as a,mergeRegister as c,PASTE_COMMAND as s,$onUpdate as u,COMMAND_PRIORITY_BEFORE_EDITOR as m,COMMAND_PRIORITY_EDITOR as d,$getSelection as p,COMMAND_PRIORITY_LOW as f,PASTE_TAG as x}from"lexical";import{useState as g,useCallback as C,useEffect as E,useMemo as b}from"react";import{jsx as M}from"react/jsx-runtime";function L({embedConfigs:L,onOpenEmbedModalForConfig:P,getMenuOptions:y,menuRenderFn:A,menuCommandPriority:R=f}){const[U]=r(),[v,D]=g(null),[O,_]=g(null),N=C(()=>{D(null),_(null)},[]),S=C(async t=>{const n=U.read("latest",function(){const n=a(t);if(e(n))return n.getURL()});if(void 0!==n)for(const e of L){null!=await Promise.resolve(e.parseUrl(n))&&(_(e),D(t))}},[U,L]);E(()=>{let e=!1;const o=(t,{updateTags:n})=>{for(const[o,r]of t)"created"===r&&n.has(x)&&e?S(o):o===v&&N()};return c(U.registerCommand(s,t=>(e=i(t,ClipboardEvent)&&null!==t.clipboardData&&/^\S+$/.test(t.clipboardData.getData("text/plain")),e&&u(()=>{e=!1}),!1),m),...[t,n].map(e=>U.registerMutationListener(e,o,{skipInitialization:!0})))},[S,U,v,N]),E(()=>{if(P)return U.registerCommand(o,e=>{const t=L.find(({type:t})=>t===e);return!!t&&(P(t),!0)},d)},[U,L,P]);const F=C(async function(){if(null!=O&&null!=v){const t=U.read("latest",()=>{const t=a(v);return e(t)?t:null});if(e(t)){const e=await Promise.resolve(O.parseUrl(t.__url));null!=e&&U.update(()=>{p()||t.selectEnd(),O.insertNode(U,e),t.isAttached()&&t.remove()})}}},[O,U,v]),T=b(()=>null!=O&&null!=v?y(O,F,N):[],[O,F,y,v,N]),h=C((e,t,n)=>{U.update(()=>{e.onSelect(t),n()})},[U]);return null!=v?/*#__PURE__*/M(l,{nodeKey:v,onClose:N,onSelectOption:h,options:T,menuRenderFn:A,commandPriority:R}):null}export{L as LexicalAutoEmbedPlugin};

package/dist/LexicalAutoEmbedPluginUtils.d.ts

@@ -0,0 +1,53 @@
+/**
+ * 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 { MenuOption } from '@lexical/react/LexicalMenuOption';
+import { type LexicalCommand, type LexicalEditor, type LexicalNode } from 'lexical';
+/**
+ * The result of matching a URL for an embed: the matched `url`, an `id`
+ * identifying the embedded resource, and optional provider-specific `data`.
+ */
+export type EmbedMatchResult<TEmbedMatchResult = unknown> = {
+    url: string;
+    id: string;
+    data?: TEmbedMatchResult;
+};
+/**
+ * Describes a kind of embed (for example YouTube, a tweet, or Google Maps) that
+ * {@link LexicalAutoEmbedPlugin} can detect and insert. Each config has a `type`
+ * identifier, a `parseUrl` function that decides whether a URL matches and
+ * extracts its data, and an `insertNode` function that inserts the corresponding
+ * Lexical node.
+ */
+export interface EmbedConfig<TEmbedMatchResultData = unknown, TEmbedMatchResult = EmbedMatchResult<TEmbedMatchResultData>> {
+    type: string;
+    parseUrl: (text: string) => Promise<TEmbedMatchResult | null> | TEmbedMatchResult | null;
+    insertNode: (editor: LexicalEditor, result: TEmbedMatchResult) => void;
+}
+/**
+ * A general-purpose regular expression for detecting URLs, provided as a
+ * convenience for implementing an {@link EmbedConfig}'s `parseUrl`.
+ */
+export declare const URL_MATCHER: RegExp;
+/**
+ * Command dispatched to start inserting an embed. Its payload is the `type` of
+ * the {@link EmbedConfig} to use; {@link LexicalAutoEmbedPlugin} listens for it
+ * and runs that config's URL detection flow.
+ */
+export declare const INSERT_EMBED_COMMAND: LexicalCommand<EmbedConfig['type']>;
+/**
+ * A {@link MenuOption} for the auto-embed menu, pairing a display `title` with
+ * an `onSelect` callback invoked when the user chooses to embed the detected
+ * URL.
+ */
+export declare class AutoEmbedOption extends MenuOption {
+    title: string;
+    onSelect: (targetNode: LexicalNode | null) => void;
+    constructor(title: string, options: {
+        onSelect: (targetNode: LexicalNode | null) => void;
+    });
+}

package/dist/LexicalAutoEmbedPluginUtils.dev.js

@@ -0,0 +1,66 @@
+/**
+ * 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 LexicalMenuOption = require('@lexical/react/LexicalMenuOption');
+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.
+ *
+ */
+
+
+/**
+ * The result of matching a URL for an embed: the matched `url`, an `id`
+ * identifying the embedded resource, and optional provider-specific `data`.
+ */
+
+/**
+ * Describes a kind of embed (for example YouTube, a tweet, or Google Maps) that
+ * {@link LexicalAutoEmbedPlugin} can detect and insert. Each config has a `type`
+ * identifier, a `parseUrl` function that decides whether a URL matches and
+ * extracts its data, and an `insertNode` function that inserts the corresponding
+ * Lexical node.
+ */
+
+/**
+ * A general-purpose regular expression for detecting URLs, provided as a
+ * convenience for implementing an {@link EmbedConfig}'s `parseUrl`.
+ */
+const URL_MATCHER = /((https?:\/\/(www\.)?)|(www\.))[-a-zA-Z0-9@:%._+~#=]{1,256}\.[a-zA-Z0-9()]{1,6}\b([-a-zA-Z0-9()@:%_+.~#?&//=]*)/;
+
+/**
+ * Command dispatched to start inserting an embed. Its payload is the `type` of
+ * the {@link EmbedConfig} to use; {@link LexicalAutoEmbedPlugin} listens for it
+ * and runs that config's URL detection flow.
+ */
+const INSERT_EMBED_COMMAND = /* @__PURE__ */lexical.createCommand('INSERT_EMBED_COMMAND');
+
+/**
+ * A {@link MenuOption} for the auto-embed menu, pairing a display `title` with
+ * an `onSelect` callback invoked when the user chooses to embed the detected
+ * URL.
+ */
+class AutoEmbedOption extends LexicalMenuOption.MenuOption {
+  title;
+  onSelect;
+  constructor(title, options) {
+    super(title);
+    this.title = title;
+    this.onSelect = options.onSelect.bind(this);
+  }
+}
+
+exports.AutoEmbedOption = AutoEmbedOption;
+exports.INSERT_EMBED_COMMAND = INSERT_EMBED_COMMAND;
+exports.URL_MATCHER = URL_MATCHER;

package/dist/LexicalAutoEmbedPluginUtils.dev.mjs

@@ -0,0 +1,62 @@
+/**
+ * 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 { MenuOption } from '@lexical/react/LexicalMenuOption';
+import { createCommand } 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.
+ *
+ */
+
+
+/**
+ * The result of matching a URL for an embed: the matched `url`, an `id`
+ * identifying the embedded resource, and optional provider-specific `data`.
+ */
+
+/**
+ * Describes a kind of embed (for example YouTube, a tweet, or Google Maps) that
+ * {@link LexicalAutoEmbedPlugin} can detect and insert. Each config has a `type`
+ * identifier, a `parseUrl` function that decides whether a URL matches and
+ * extracts its data, and an `insertNode` function that inserts the corresponding
+ * Lexical node.
+ */
+
+/**
+ * A general-purpose regular expression for detecting URLs, provided as a
+ * convenience for implementing an {@link EmbedConfig}'s `parseUrl`.
+ */
+const URL_MATCHER = /((https?:\/\/(www\.)?)|(www\.))[-a-zA-Z0-9@:%._+~#=]{1,256}\.[a-zA-Z0-9()]{1,6}\b([-a-zA-Z0-9()@:%_+.~#?&//=]*)/;
+
+/**
+ * Command dispatched to start inserting an embed. Its payload is the `type` of
+ * the {@link EmbedConfig} to use; {@link LexicalAutoEmbedPlugin} listens for it
+ * and runs that config's URL detection flow.
+ */
+const INSERT_EMBED_COMMAND = /* @__PURE__ */createCommand('INSERT_EMBED_COMMAND');
+
+/**
+ * A {@link MenuOption} for the auto-embed menu, pairing a display `title` with
+ * an `onSelect` callback invoked when the user chooses to embed the detected
+ * URL.
+ */
+class AutoEmbedOption extends MenuOption {
+  title;
+  onSelect;
+  constructor(title, options) {
+    super(title);
+    this.title = title;
+    this.onSelect = options.onSelect.bind(this);
+  }
+}
+
+export { AutoEmbedOption, INSERT_EMBED_COMMAND, URL_MATCHER };

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

package/dist/LexicalAutoEmbedPluginUtils.js.flow

@@ -0,0 +1,40 @@
+/**
+ * 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 {LexicalCommand, LexicalEditor, LexicalNode} from 'lexical';
+
+import {MenuOption} from '@lexical/react/LexicalMenuOption';
+
+export type EmbedMatchResult<TEmbedMatchResult = unknown> = {
+  url: string,
+  id: string,
+  data?: TEmbedMatchResult,
+};
+
+export interface EmbedConfig<
+  TEmbedMatchResultData = unknown,
+  TEmbedMatchResult = EmbedMatchResult<TEmbedMatchResultData>,
+> {
+  type: string;
+  parseUrl: (
+    text: string,
+  ) => Promise<TEmbedMatchResult | null> | TEmbedMatchResult | null;
+  insertNode: (editor: LexicalEditor, result: TEmbedMatchResult) => void;
+}
+
+declare export var URL_MATCHER: RegExp;
+declare export var INSERT_EMBED_COMMAND: LexicalCommand<EmbedConfig<>['type']>;
+
+declare export class AutoEmbedOption extends MenuOption {
+  onSelect: (targetNode: LexicalNode | null) => void;
+  constructor(
+    title: string,
+    options: {onSelect: (targetNode: LexicalNode | null) => void},
+  ): void;
+}

package/dist/LexicalAutoEmbedPluginUtils.mjs

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

package/dist/LexicalAutoEmbedPluginUtils.node.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.
+ *
+ */
+
+const mod = await (process.env.NODE_ENV !== 'production' ? import('./LexicalAutoEmbedPluginUtils.dev.mjs') : import('./LexicalAutoEmbedPluginUtils.prod.mjs'));
+export const AutoEmbedOption = mod.AutoEmbedOption;
+export const INSERT_EMBED_COMMAND = mod.INSERT_EMBED_COMMAND;
+export const URL_MATCHER = mod.URL_MATCHER;

package/dist/LexicalAutoEmbedPluginUtils.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/react/LexicalMenuOption");const t=/* @__PURE__ */require("lexical").createCommand("INSERT_EMBED_COMMAND");class i extends e.MenuOption{title;onSelect;constructor(e,t){super(e),this.title=e,this.onSelect=t.onSelect.bind(this)}}exports.AutoEmbedOption=i,exports.INSERT_EMBED_COMMAND=t,exports.URL_MATCHER=/((https?:\/\/(www\.)?)|(www\.))[-a-zA-Z0-9@:%._+~#=]{1,256}\.[a-zA-Z0-9()]{1,6}\b([-a-zA-Z0-9()@:%_+.~#?&//=]*)/;

package/dist/LexicalAutoEmbedPluginUtils.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{MenuOption as t}from"@lexical/react/LexicalMenuOption";import{createCommand as e}from"lexical";const i=/((https?:\/\/(www\.)?)|(www\.))[-a-zA-Z0-9@:%._+~#=]{1,256}\.[a-zA-Z0-9()]{1,6}\b([-a-zA-Z0-9()@:%_+.~#?&//=]*)/,o=/* @__PURE__ */e("INSERT_EMBED_COMMAND");class c extends t{title;onSelect;constructor(t,e){super(t),this.title=t,this.onSelect=e.onSelect.bind(this)}}export{c as AutoEmbedOption,o as INSERT_EMBED_COMMAND,i as URL_MATCHER};

package/dist/LexicalCollaborationContext.d.ts

@@ -5,24 +5,7 @@
  * LICENSE file in the root directory of this source tree.
  *
  */
-import type { Doc } from 'yjs';
-/**
- * The value stored in the {@link CollaborationContext}: the local user's
- * display `name` and cursor `color`, whether collaboration is currently active,
- * and the map of Yjs documents shared by the editors under this provider.
- */
-export type CollaborationContextType = {
-    color: string;
-    isCollabActive: boolean;
-    name: string;
-    yjsDocMap: Map<string, Doc>;
-};
-/**
- * The React context that holds the shared {@link CollaborationContextType} for
- * collaborative editors. Provide it with {@link LexicalCollaboration} and read
- * it with {@link useCollaborationContext}.
- */
-export declare const CollaborationContext: import("react").Context<CollaborationContextType | null>;
+export { CollaborationContext, type CollaborationContextType, useCollaborationContext, } from '@lexical/react/LexicalCollaborationContextUtils';
 /**
  * A provider component that creates a fresh {@link CollaborationContextType}
  * and makes it available to descendant editors via {@link CollaborationContext}.
@@ -34,11 +17,3 @@ export declare const CollaborationContext: import("react").Context<Collaboration
 export declare function LexicalCollaboration({ children }: {
     children: React.ReactNode;
 }): import("react/jsx-runtime").JSX.Element;
-/**
- * Reads the current {@link CollaborationContextType} from the nearest
- * {@link LexicalCollaboration} provider. Optionally pass `username` and `color`
- * to set the local user's display name and cursor color.
- *
- * @returns The active collaboration context.
- */
-export declare function useCollaborationContext(username?: string, color?: string): CollaborationContextType;

package/dist/LexicalCollaborationContext.dev.js

@@ -8,6 +8,7 @@
 
 'use strict';
 
+var LexicalCollaborationContextUtils = require('@lexical/react/LexicalCollaborationContextUtils');
 var react = require('react');
 var jsxRuntime = require('react/jsx-runtime');
 
@@ -19,33 +20,6 @@ var jsxRuntime = require('react/jsx-runtime');
  *
  */
 
-// Do not require this module directly! Use normal `invariant` calls.
-
-function formatDevErrorMessage(message) {
-  throw new Error(message);
-}
-
-const entries = [['Cat', 'rgb(125, 50, 0)'], ['Dog', 'rgb(100, 0, 0)'], ['Rabbit', 'rgb(150, 0, 0)'], ['Frog', 'rgb(200, 0, 0)'], ['Fox', 'rgb(200, 75, 0)'], ['Hedgehog', 'rgb(0, 75, 0)'], ['Pigeon', 'rgb(0, 125, 0)'], ['Squirrel', 'rgb(75, 100, 0)'], ['Bear', 'rgb(125, 100, 0)'], ['Tiger', 'rgb(0, 0, 150)'], ['Leopard', 'rgb(0, 0, 200)'], ['Zebra', 'rgb(0, 0, 250)'], ['Wolf', 'rgb(0, 100, 150)'], ['Owl', 'rgb(0, 100, 100)'], ['Gull', 'rgb(100, 0, 100)'], ['Squid', 'rgb(150, 0, 150)']];
-const randomEntry = entries[Math.floor(Math.random() * entries.length)];
-
-/**
- * The React context that holds the shared {@link CollaborationContextType} for
- * collaborative editors. Provide it with {@link LexicalCollaboration} and read
- * it with {@link useCollaborationContext}.
- */
-const CollaborationContext = /*#__PURE__*/react.createContext(null);
-function newContext() {
-  return {
-    color: randomEntry[1],
-    isCollabActive: false,
-    name: randomEntry[0],
-    yjsDocMap: new Map()
-  };
-}
-
-// This is here to help the transition post-#7818, however should be removed in a future release as
-// a shared context across editors is likely to lead to bugs.
-const UNSAFE_GLOBAL_CONTEXT = newContext();
 
 /**
  * A provider component that creates a fresh {@link CollaborationContextType}
@@ -58,37 +32,13 @@ const UNSAFE_GLOBAL_CONTEXT = newContext();
 function LexicalCollaboration({
   children
 }) {
-  const collabContext = react.useMemo(() => newContext(), []);
-  return /*#__PURE__*/jsxRuntime.jsx(CollaborationContext.Provider, {
+  const collabContext = react.useMemo(() => LexicalCollaborationContextUtils.newContext(), []);
+  return /*#__PURE__*/jsxRuntime.jsx(LexicalCollaborationContextUtils.CollaborationContext.Provider, {
     value: collabContext,
     children: children
   });
 }
 
-/**
- * Reads the current {@link CollaborationContextType} from the nearest
- * {@link LexicalCollaboration} provider. Optionally pass `username` and `color`
- * to set the local user's display name and cursor color.
- *
- * @returns The active collaboration context.
- */
-function useCollaborationContext(username, color) {
-  let collabContext = react.useContext(CollaborationContext);
-  if (!(collabContext != null)) {
-    formatDevErrorMessage(`useCollaborationContext: no context provider found`);
-  }
-  collabContext = collabContext ?? UNSAFE_GLOBAL_CONTEXT;
-  if (username != null) {
-    // eslint-disable-next-line react-hooks/immutability
-    collabContext.name = username;
-  }
-  if (color != null) {
-    // eslint-disable-next-line react-hooks/immutability
-    collabContext.color = color;
-  }
-  return collabContext;
-}
-
-exports.CollaborationContext = CollaborationContext;
+exports.CollaborationContext = LexicalCollaborationContextUtils.CollaborationContext;
+exports.useCollaborationContext = LexicalCollaborationContextUtils.useCollaborationContext;
 exports.LexicalCollaboration = LexicalCollaboration;
-exports.useCollaborationContext = useCollaborationContext;